docs: removed unnecessary exports previously added to api docs (aws-powertools#3000)

Author: am29d

examples/app/functions/commons/helpers/scan-items.ts

@@ -6,7 +6,7 @@ import type { DebugLogger } from '#types';
 /**
  * Scan the DynamoDB table and return all items.
  *
- * @note this function is purposefully not paginated to keep the example simple
+ * this function is purposefully not paginated to keep the example simple
  *
  * @param logger A logger instance
  */

packages/batch/src/BasePartialBatchProcessor.ts

@@ -22,8 +22,6 @@ import type {
  * This class extends the {@link BasePartialProcessor} class and adds additional
  * functionality to handle batch processing. Specifically, it provides methods
  * to collect failed records and build the partial failure response.
- *
- * @abstract
  */
 abstract class BasePartialBatchProcessor extends BasePartialProcessor {
   /**

packages/batch/src/BasePartialProcessor.ts

@@ -18,8 +18,6 @@ import type {
  * The class comes with a few helper methods and hooks that can be used to prepare
  * the processor before processing records, clean up after processing records, and
  * handle records that succeed or fail processing.
- *
- * @abstract
  */
 abstract class BasePartialProcessor {
   /**
@@ -67,8 +65,6 @@ abstract class BasePartialProcessor {
    * This method should be called after processing a full batch to reset the processor.
    *
    * You can use this as a hook to run any cleanup logic after processing the records.
-   *
-   * @abstract
    */
   public abstract clean(): void;
 
@@ -98,8 +94,6 @@ abstract class BasePartialProcessor {
    * This method should be called before processing the records
    *
    * You can use this as a hook to run any setup logic before processing the records.
-   *
-   * @abstract
    */
   public abstract prepare(): void;
 
@@ -151,8 +145,6 @@ abstract class BasePartialProcessor {
    * This is to ensure that the processor keeps track of the results and the records
    * that succeeded and failed processing.
    *
-   * @abstract
-   *
    * @param record Record to be processed
    */
   public abstract processRecord(
@@ -171,8 +163,6 @@ abstract class BasePartialProcessor {
    * This is to ensure that the processor keeps track of the results and the records
    * that succeeded and failed processing.
    *
-   * @abstract
-   *
    * @param record Record to be processed
    */
   public abstract processRecordSync(

packages/commons/src/LRUCache.ts

@@ -46,8 +46,8 @@ class Item<K, V> {
  * which is licensed under the MIT license and [recommends users to copy the code into their
  * own projects](https://github.com/rsms/js-lru/tree/master#usage).
  *
- * @typeparam K - The type of the key
- * @typeparam V - The type of the value
+ * @typeParam K - The type of the key
+ * @typeParam V - The type of the value
  */
 class LRUCache<K, V> {
   private leastRecentlyUsed?: Item<K, V>;

packages/commons/src/config/EnvironmentVariablesService.ts

@@ -17,7 +17,6 @@ import type { ConfigServiceInterface } from '../types/ConfigServiceInterface.js'
  * @see https://docs.powertools.aws.dev/lambda/typescript/latest/#environment-variables
  *
  * @class
- * @implements {ConfigServiceInterface}
  */
 class EnvironmentVariablesService implements ConfigServiceInterface {
   /**

packages/commons/src/middleware/cleanupMiddlewares.ts

@@ -59,7 +59,6 @@ const isFunction = (obj: unknown): obj is CleanupFunction => {
  * ```
  *
  * @param request The Middy request object
- * @param options An optional object that can be used to pass options to the function
  */
 const cleanupMiddlewares = async (request: MiddyLikeRequest): Promise<void> => {
   const cleanupFunctionNames = [

packages/commons/src/types/ConfigServiceInterface.ts

@@ -1,6 +1,4 @@
 /**
- * @abstract ConfigServiceInterface
- *
  * This class defines common methods and variables that can be set by the developer
  * in the runtime.
  */

packages/commons/src/types/middy.ts

@@ -3,7 +3,7 @@ import type { Context } from 'aws-lambda';
 /**
  * This type represents the shape of a Middy.js request object.
  *
- * @note We need to define these types and interfaces here because we can't import them from Middy.js.
+ * We need to define these types and interfaces here because we can't import them from Middy.js.
  *
  * Importing them from Middy.js would introduce a dependency on it, which we don't want
  * because we want to keep it as an optional dependency.
@@ -72,7 +72,8 @@ type MiddyLikeRequest = {
  * Each Powertools for AWS middleware that needs to perform cleanup operations will
  * store a cleanup function with this signature in the `request.internal` object.
  *
- * @see {@link cleanupMiddlewares}
+ * @see {@link middleware/cleanupMiddlewares.cleanupMiddlewares}
+ *
  */
 type CleanupFunction = (request: MiddyLikeRequest) => Promise<void>;
 

packages/commons/typedoc.json

@@ -5,6 +5,7 @@
   "entryPoints": [
     "./src/index.ts",
     "./src/types/index.ts",
+    "./src/middleware/cleanupMiddlewares.ts",
     "./src/typeUtils.ts",
     "./src/fromBase64.ts",
     "./src/LRUCache.ts"

packages/idempotency/src/config/EnvironmentVariablesService.ts

@@ -1,5 +1,5 @@
-import type { ConfigServiceInterface } from '../types/ConfigServiceInterface.js';
 import { EnvironmentVariablesService as CommonEnvironmentVariablesService } from '@aws-lambda-powertools/commons';
+import type { ConfigServiceInterface } from '../types/ConfigServiceInterface.js';
 
 /**
  * Class EnvironmentVariablesService
@@ -11,7 +11,6 @@ import { EnvironmentVariablesService as CommonEnvironmentVariablesService } from
  *
  * @class
  * @extends {CommonEnvironmentVariablesService}
- * @implements {ConfigServiceInterface}
  * @see https://docs.aws.amazon.com/lambda/latest/dg/configuration-envvars.html#configuration-envvars-runtime
  * @see https://docs.powertools.aws.dev/lambda/typescript/latest/#environment-variables
  */