docs(parameters): clarify caching behavior of getAppConfig (#3808)

Author: dreamorosi

docs/index.md

@@ -366,7 +366,7 @@ Core utilities such as Tracing, Logging, and Metrics will be available across al
 | -------------------------------------------- |------------------------------------------------------------------------------------------| --------------------------------------- |-------------------------------------------------|
 | **POWERTOOLS_SERVICE_NAME**                  | Set service name used for tracing namespace, metrics dimension and structured logging    | All                                     | `service_undefined`                             |
 | **POWERTOOLS_METRICS_NAMESPACE**             | Set namespace used for metrics                                                           | [Metrics](core/metrics.md)              | `default_namespace`                             |
-| **POWERTOOLS_METRICS_FUNCTION_NAME**         | Function name used as dimension for the `ColdStart` metric                               | [Metrics](core/metrics.md)              | [See docs](core/metrics/#setting-function-name) |
+| **POWERTOOLS_METRICS_FUNCTION_NAME**         | Function name used as dimension for the `ColdStart` metric                               | [Metrics](core/metrics.md)              | [See docs](core/metrics.md#setting-function-name) |
 | **POWERTOOLS_METRICS_ENABLED**               | Explicitly disables emitting metrics to stdout                                           | [Metrics](core/metrics.md)              | `true`                                          |
 | **POWERTOOLS_TRACE_ENABLED**                 | Explicitly disables tracing                                                              | [Tracer](core/tracer.md)                | `true`                                          |
 | **POWERTOOLS_TRACER_CAPTURE_RESPONSE**       | Capture Lambda or method return as metadata.                                             | [Tracer](core/tracer.md)                | `true`                                          |

docs/utilities/parameters.md

@@ -137,6 +137,8 @@ The following will retrieve the latest version and store it in the cache.
 --8<-- "examples/snippets/parameters/getAppConfig.ts"
 ```
 
+When using `getAppConfig`, the [underlying provider](#appconfigprovider) is cached. To fetch from different applications or environments, create separate `AppConfigProvider` instances for each application/environment combination.
+
 ## Advanced
 
 ### Adjusting cache TTL

packages/idempotency/src/types/IdempotencyRecord.ts

@@ -1,6 +1,6 @@
 import type { JSONValue } from '@aws-lambda-powertools/commons/types';
 import type { IdempotencyRecordStatus } from '../constants.js';
-
+import type { DynamoDBPersistenceLayer } from '../persistence/DynamoDBPersistenceLayer.js';
 /**
  * The status of an IdempotencyRecord
  */
@@ -22,7 +22,7 @@ type IdempotencyRecordOptions = {
   /**
    * The idempotency record status can be COMPLETED, IN_PROGRESS or EXPIRED.
    * We check the status during idempotency processing to make sure we don't process an expired record and handle concurrent requests.
-   * {@link constants.IdempotencyRecordStatusValue | IdempotencyRecordStatusValue}
+   * {@link IdempotencyRecordStatusValue | IdempotencyRecordStatusValue}
    */
   status: IdempotencyRecordStatusValue;
   /**