@rio-cloud/cdk-v2-constructs 8.4.0 → 8.6.0

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/Logger.d.ts

@@ -0,0 +1,238 @@
+import type { HandlerMethodDecorator } from '@aws-lambda-powertools/commons/types';
+import type { Context } from 'aws-lambda';
+import type { LogLevel as LogLevelList } from '../constants.js';
+import type { LogFormatter } from '../formatter/LogFormatter.js';
+import type { ConfigServiceInterface } from './ConfigServiceInterface.js';
+import type { LogRecordOrderKeys } from './formatters.js';
+import type { Environment, LogAttributes, LogAttributesWithMessage, LogKeys } from './logKeys.js';
+export type { Environment, LogAttributes } from './logKeys.js';
+/**
+ * Type definition for the log level.
+ *
+ * It includes the lowercase and uppercase versions of each log level.
+ */
+type LogLevel = (typeof LogLevelList)[keyof typeof LogLevelList] | Lowercase<(typeof LogLevelList)[keyof typeof LogLevelList]>;
+/**
+ * Type definition for a function that logs messages at different levels to the console.
+ */
+type LogFunction = {
+    [key in Exclude<Lowercase<LogLevel>, 'silent'>]: (input: LogItemMessage, ...extraInput: LogItemExtraInput) => void;
+};
+/**
+ * Options for the {@link LoggerInterface.injectLambdaContext()} method.
+ */
+type InjectLambdaContextOptions = {
+    /**
+     * When `true` the logger will log the event.
+     *
+     * To avoid logging sensitive information, we recommend using this option only for debugging purposes in local environments.
+     */
+    logEvent?: boolean;
+    /**
+     * @deprecated Use {@link InjectLambdaContextOptions.resetKeys()}` instead.
+     */
+    clearState?: boolean;
+    /**
+     * If `true`, the logger will reset the keys added via {@link LoggerInterface.appendKeys()}
+     */
+    resetKeys?: boolean;
+    /**
+     * Whether to flush the log buffer when an uncaught error is logged.
+     *
+     * @default `false`
+     */
+    flushBufferOnUncaughtError?: boolean;
+    /**
+     * The path to the correlation ID in the event object, used to extract the correlation ID from the event object and add it to the log attributes.
+     */
+    correlationIdPath?: string;
+};
+/**
+ * A custom JSON replacer function that can be passed to the Logger constructor to extend the default serialization behavior.
+ *
+ * By default, we already extend the default serialization behavior to handle `BigInt` and `Error` objects, as well as remove circular references.
+ * When a custom JSON replacer function is passed to the Logger constructor, it will be called **before** our custom rules for each key-value pair in the object being stringified.
+ *
+ * This allows you to customize the serialization while still benefiting from the default behavior.
+ *
+ * @param key - The key of the value being stringified.
+ * @param value - The value being stringified.
+ */
+type CustomJsonReplacerFn = (key: string, value: unknown) => unknown;
+/**
+ * Base constructor options for the Logger class.
+ */
+type BaseConstructorOptions = {
+    /**
+     * The level threshold for the logger to log at.
+     */
+    logLevel?: LogLevel;
+    /**
+     * Service name to be included in log items for easier correlation.
+     */
+    serviceName?: string;
+    /**
+     * The percentage rate at which the log level is `DEBUG`.
+     *
+     * See {@link https://docs.aws.amazon.com/powertools/typescript/latest/core/logger/#sampling-debug-logs | Sampling debug logs} for more information.
+     */
+    sampleRateValue?: number;
+    /**
+     * A custom config service that can be passed to the Logger constructor to extend the default behavior.
+     *
+     * See {@link ConfigServiceInterface} for more information.
+     */
+    customConfigService?: ConfigServiceInterface;
+    /**
+     * The environment in which the Lambda function is running.
+     */
+    environment?: Environment;
+    /**
+     * A custom JSON replacer function that can be passed to the Logger constructor to extend the default serialization behavior.
+     *
+     * By default, we already extend the default serialization behavior to handle `BigInt` and `Error` objects, as well as remove circular references.
+     * When a custom JSON replacer function is passed to the Logger constructor, it will be called **before** our custom rules for each key-value pair in the object being stringified.
+     *
+     * This allows you to customize the serialization while still benefiting from the default behavior.
+     */
+    jsonReplacerFn?: CustomJsonReplacerFn;
+};
+/**
+ * Options for the `persistentKeys` constructor option.
+ */
+type PersistentKeysOption = {
+    /**
+     * Keys that will be added to all log items.
+     */
+    persistentKeys?: LogAttributes & {
+        message?: never;
+        level?: never;
+        sampling_rate?: never;
+        service?: never;
+        timestamp?: never;
+        error?: never;
+    };
+    /**
+     * @deprecated Use `persistentKeys` instead.
+     */
+    persistentLogAttributes?: never;
+};
+/**
+ * Deprecated options for the `persistentLogAttributes` constructor option.
+ *
+ * Used to maintain backwards compatibility with the `persistentLogAttributes` option.
+ */
+type DeprecatedPersistentKeysOption = {
+    /**
+     * @deprecated Use `persistentKeys` instead.
+     */
+    persistentLogAttributes?: LogAttributes;
+    /**
+     * Keys that will be added to all log items.
+     */
+    persistentKeys?: never;
+};
+/**
+ * Options for the `logFormatter` constructor option.
+ *
+ * Used to make the `logFormatter` option mutually exclusive with the `logRecordOrder` option.
+ */
+type LogFormatterOption = {
+    /**
+     * The custom log formatter to process log attributes.
+     *
+     * See {@link https://docs.aws.amazon.com/powertools/typescript/latest/core/logger/#custom-log-formatter-bring-your-own-formatter | Custom Log Formatters} for more information.
+     */
+    logFormatter?: LogFormatter;
+    /**
+     * Optional list of keys to specify order of the keys in logs.
+     */
+    logRecordOrder?: never;
+};
+/**
+ * Options for the `logRecordOrder` constructor option.
+ *
+ * Used to make the `logRecordOrder` option mutually exclusive with the `logFormatter` option.
+ */
+type LogRecordOrderOption = {
+    /**
+     * Optional list of keys to specify order of the keys in logs.
+     */
+    logRecordOrder?: LogRecordOrderKeys;
+    /**
+     * The custom log formatter.
+     */
+    logFormatter?: never;
+};
+/**
+ * Options for the `logBuffer` constructor option.
+ *
+ * Used to configure the log buffer functionality.
+ */
+type LogBufferOption = {
+    logBufferOptions?: {
+        /**
+         * Whether logs should be buffered
+         */
+        enabled?: boolean;
+        /**
+         * Maximum size of the buffer in bytes
+         * @default `20480`
+         */
+        maxBytes?: number;
+        /**
+         * Flush the buffer when an error is logged
+         * @default `true`
+         */
+        flushOnErrorLog?: boolean;
+        /**
+         * The threshold to buffer logs. Logs with a level more severe than this will be logged immediately.
+         * Only 'DEBUG', 'INFO', 'WARN' or their lowercase variants are allowed.
+         * @default `DEBUG`
+         */
+        bufferAtVerbosity?: Extract<(typeof LogLevelList)[keyof typeof LogLevelList], 'DEBUG' | 'INFO' | 'WARN'> | Extract<Lowercase<(typeof LogLevelList)[keyof typeof LogLevelList]>, 'debug' | 'info' | 'warn'>;
+    };
+};
+type CorrelationIdOption = {
+    /**
+     * The search function for the correlation ID.
+     */
+    correlationIdSearchFn?: (expression: string, data: unknown) => unknown;
+};
+/**
+ * Options to configure the Logger.
+ */
+type ConstructorOptions = BaseConstructorOptions & (PersistentKeysOption | DeprecatedPersistentKeysOption) & (LogFormatterOption | LogRecordOrderOption) & LogBufferOption & CorrelationIdOption;
+type LogItemMessage = string | LogAttributesWithMessage;
+type LogItemExtraInput = [Error | string] | LogAttributes[];
+/**
+ * Interface for the Logger class.
+ */
+type LoggerInterface = {
+    addContext(context: Context): void;
+    appendPersistentKeys(attributes?: LogKeys): void;
+    appendKeys(attributes?: LogKeys): void;
+    createChild(options?: ConstructorOptions): LoggerInterface;
+    critical(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+    debug(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+    error(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+    flushBuffer(): void;
+    getLevelName(): Uppercase<LogLevel>;
+    getLogEvent(): boolean;
+    getPersistentLogAttributes(): LogAttributes;
+    info(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+    injectLambdaContext(options?: InjectLambdaContextOptions): HandlerMethodDecorator;
+    logEventIfEnabled(event: unknown, overwriteValue?: boolean): void;
+    refreshSampleRateCalculation(): void;
+    removeKeys(keys?: string[]): void;
+    removePersistentLogAttributes(keys?: string[]): void;
+    resetKeys(): void;
+    setCorrelationId(value: unknown, correlationIdPath?: string): void;
+    setLogLevel(logLevel: LogLevel): void;
+    setPersistentLogAttributes(attributes?: LogAttributes): void;
+    shouldLogEvent(overwriteValue?: boolean): boolean;
+    trace(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+    warn(input: LogItemMessage, ...extraInput: LogItemExtraInput): void;
+};
+export type { ConstructorOptions, CustomJsonReplacerFn, InjectLambdaContextOptions, LogFunction, LoggerInterface, LogItemExtraInput, LogItemMessage, LogLevel, };
+//# sourceMappingURL=Logger.d.ts.map

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/Logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Logger.d.ts","sourceRoot":"","sources":["../../../src/types/Logger.ts"],"names":[],"mappings":"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"}

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/Logger.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/formatters.d.ts

@@ -0,0 +1,18 @@
+import type { LogKey } from './logKeys.js';
+/**
+ * List of keys to order log attributes by.
+ *
+ * This can be a set of keys or an array of keys.
+ */
+type LogRecordOrderKeys = Set<LogKey> | LogKey[];
+/**
+ * Options for the {@link PowertoolsLogFormatter} class.
+ */
+type PowertoolsLogFormatterOptions = {
+    /**
+     * An array of keys that defines the order of the log record.
+     */
+    logRecordOrder?: LogRecordOrderKeys;
+};
+export type { LogRecordOrderKeys, PowertoolsLogFormatterOptions };
+//# sourceMappingURL=formatters.d.ts.map

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/formatters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatters.d.ts","sourceRoot":"","sources":["../../../src/types/formatters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3C;;;;GAIG;AACH,KAAK,kBAAkB,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM,EAAE,CAAC;AAEjD;;GAEG;AACH,KAAK,6BAA6B,GAAG;IACnC;;OAEG;IACH,cAAc,CAAC,EAAE,kBAAkB,CAAC;CACrC,CAAC;AAEF,YAAY,EAAE,kBAAkB,EAAE,6BAA6B,EAAE,CAAC"}

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/formatters.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/index.d.ts

@@ -0,0 +1,3 @@
+export type { ConstructorOptions, CustomJsonReplacerFn, Environment, InjectLambdaContextOptions, LogAttributes, LoggerInterface, LogItemExtraInput, LogItemMessage, LogLevel, } from './Logger.js';
+export type { UnformattedAttributes } from './logKeys.js';
+//# sourceMappingURL=index.d.ts.map

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,kBAAkB,EAClB,oBAAoB,EACpB,WAAW,EACX,0BAA0B,EAC1B,aAAa,EACb,eAAe,EACf,iBAAiB,EACjB,cAAc,EACd,QAAQ,GACT,MAAM,aAAa,CAAC;AACrB,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC"}

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/index.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/logKeys.d.ts

@@ -0,0 +1,248 @@
+import type { Context } from 'aws-lambda';
+import type { LogLevel } from './Logger.js';
+/**
+ * Type that extends an autocompletable string by allowing any string value.
+ *
+ * For example, if we have a type `type MyString = 'foo' | 'bar';`, when using
+ * `MyString` in a function, the autocomplete will only show `foo` and `bar`.
+ *
+ * For many cases, this is fine, but sometimes we also want to allow any _other_
+ * string value, so we can use `AutocompletableString` instead and extend it like
+ * this: `type MyString = 'foo' | 'bar' | AutocompletableString;`.
+ */
+type AutocompletableString = string & {};
+/**
+ * Generic log attribute object used as a base.
+ */
+type LogAttributes = {
+    [key: string]: unknown;
+};
+/**
+ * Log attribute object with a message key.
+ *
+ * This is the most common log attribute object and it's used as first argument in the logger methods.
+ */
+type LogAttributesWithMessage = LogAttributes & {
+    /**
+     * Your log message.
+     */
+    message: string;
+    /**
+     * This key is generated by the logger and cannot be set manually.
+     */
+    level?: never;
+    /**
+     * This key is generated by the logger and cannot be set manually.
+     */
+    sampling_rate?: never;
+    /**
+     * This key is generated by the logger and cannot be set manually.
+     */
+    service?: never;
+    /**
+     * This key is generated by the logger and cannot be set manually.
+     */
+    timestamp?: never;
+};
+/**
+ * The environment in which the Lambda function is invoked.
+ */
+type Environment = 'dev' | 'local' | 'staging' | 'prod' | AutocompletableString;
+/**
+ * Standard keys that are included in every log item when using the default log formatter.
+ *
+ * See {@link https://docs.aws.amazon.com/powertools/python/latest/core/logger/#standard-structured-keys | Standard structured keys} for more information.
+ */
+type PowertoolsStandardKeys = {
+    /**
+     * Log level threshold of the log item
+     *
+     * @example "INFO"
+     */
+    level: LogLevel;
+    /**
+     * A descriptive, human-readable representation of the log item
+     *
+     * @example "Query performed to DynamoDB"
+     */
+    message: string;
+    /**
+     * The percentage rate at which the log level is `DEBUG`.
+     *
+     * See {@link https://docs.aws.amazon.com/powertools/typescript/latest/core/logger/#sampling-debug-logs | Sampling debug logs} for more information.
+     *
+     * @example 0.1
+     */
+    sampling_rate: number;
+    /**
+     * A unique name identifier of the service this AWS Lambda function belongs to.
+     *
+     * @default "service_undefined"
+     *
+     * @example "serverlessAirline"
+     */
+    service: string;
+    /**
+     * Timestamp string in simplified extended ISO format (ISO 8601)
+     *
+     * @example "2011-10-05T14:48:00.000Z"
+     */
+    timestamp: string;
+    /**
+     * X-Ray Trace ID set by the Lambda runtime.
+     *
+     * @example "1-5759e988-bd862e3fe1be46a994272793"
+     */
+    xray_trace_id: string;
+    /**
+     * An optional object containing information about the error passed to the logger
+     */
+    error?: Error;
+};
+/**
+ * Additional keys that are added to the log item when using the default log formatter and
+ * having added AWS Lambda context.
+ *
+ * See {@link https://docs.aws.amazon.com/powertools/typescript/latest/core/logger/#capturing-lambda-context-info | Capturing Lambda context info} for more information.
+ */
+type PowertoolsLambdaContextKeys = {
+    /**
+     * Indicates whether the current execution experienced a cold start.
+     *
+     * @example false
+     */
+    cold_start: boolean;
+    /**
+     * The name of the Lambda function.
+     *
+     * @example "example-powertools-HelloWorldFunction-1P1Z6B39FLU73"
+     */
+    function_name: string;
+    /**
+     * The memory size of the Lambda function.
+     *
+     * @example "128"
+     */
+    function_memory_size: string;
+    /**
+     * The ARN of the Lambda function.
+     *
+     * @example "arn:aws:lambda:eu-west-1:012345678910:function:example-powertools-HelloWorldFunction-1P1Z6B39FLU73"
+     */
+    function_arn: string;
+    /**
+     * The request ID of the current invocation.
+     *
+     * @example "899856cb-83d1-40d7-8611-9e78f15f32f4"
+     */
+    function_request_id: string;
+    /**
+     * The tenant ID from AWS Lambda Tenant Isolation feature.
+     *
+     * @example "cff02b3a-0e12-4be2-b3e0-758b49c4cd9b"
+     */
+    tenant_id?: string;
+};
+/**
+ * Keys available to the logger when customers have captured AWS Lambda context information.
+ *
+ * This object is a subset of the `Context` object from the `aws-lambda` package and is used
+ * only internally by the logger and passed to the log formatter.
+ *
+ * For the public API used in the default log formatter, see {@link PowertoolsLambdaContextKeys}.
+ *
+ * @internal
+ */
+type LambdaFunctionContext = Pick<Context, 'functionName' | 'memoryLimitInMB' | 'functionVersion' | 'invokedFunctionArn' | 'awsRequestId' | 'tenantId'> & {
+    coldStart: boolean;
+};
+/**
+ * Keys managed by the Powertools for AWS Lambda Logger.
+ *
+ * This type is used internally by the logger and passed to the log formatter.
+ *
+ * For the public API used in the log formatter, see {@link PowertoolsStandardKeys} and {@link PowertoolsLambdaContextKeys}.
+ */
+type PowertoolsLogData = {
+    /**
+     * The environment in which the Lambda function is invoked.
+     */
+    environment?: Environment;
+    /**
+     * The name of the service this AWS Lambda function belongs to.
+     */
+    serviceName: string;
+    /**
+     * The percentage rate at which the log level is `DEBUG`.
+     */
+    sampleRateValue: number;
+    /**
+     * Lambda context information.
+     *
+     * See {@link LambdaFunctionContext} for more information.
+     */
+    lambdaContext?: LambdaFunctionContext;
+    /**
+     * The X-Ray Trace ID set by the Lambda runtime.
+     */
+    xRayTraceId?: string;
+    /**
+     * The AWS region in which the Lambda function is invoked.
+     */
+    awsRegion: string;
+};
+/**
+ * Base log attributes that are included in every log item.
+ */
+type BaseLogAttributes = {
+    /**
+     * An optional object containing information about the error passed to the logger.
+     */
+    error?: Error;
+    /**
+     * Log level threshold of the log item.
+     */
+    logLevel: LogLevel;
+    /**
+     * Timestamp string in simplified extended ISO format (ISO 8601).
+     */
+    timestamp: Date;
+    /**
+     * A descriptive, human-readable representation of the log item.
+     */
+    message: string;
+};
+/**
+ * Unformatted attributes that are passed to the log formatter.
+ */
+type UnformattedAttributes = LogAttributes & PowertoolsLogData & BaseLogAttributes;
+/**
+ * Keys that can be used to order log attributes by.
+ */
+type LogKey = keyof PowertoolsStandardKeys | keyof PowertoolsLambdaContextKeys | AutocompletableString;
+type LogKeys = {
+    [key: string]: unknown;
+} & {
+    /**
+     * This key is passed when emitting a log message and cannot be set manually.
+     */
+    message?: never;
+    /**
+     * This key is generated by the logger and cannot be added to the logger.
+     */
+    level?: never;
+    /**
+     * This key is generated by the logger and cannot be added to the logger.
+     */
+    sampling_rate?: never;
+    /**
+     * This key is generated by the logger and cannot be added to the logger.
+     */
+    service?: never;
+    /**
+     * This key is generated by the logger and cannot be added to the logger.
+     */
+    timestamp?: never;
+};
+export type { Environment, LambdaFunctionContext, LogAttributes, LogAttributesWithMessage, LogKey, LogKeys, PowertoolsLambdaContextKeys, PowertoolsLogData, PowertoolsStandardKeys, UnformattedAttributes, };
+//# sourceMappingURL=logKeys.d.ts.map

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/logKeys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logKeys.d.ts","sourceRoot":"","sources":["../../../src/types/logKeys.ts"],"names":[],"mappings":"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"}

package/node_modules/@aws-lambda-powertools/logger/lib/cjs/types/logKeys.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/node_modules/@aws-lambda-powertools/logger/lib/esm/LogAttributesStore.d.ts

@@ -0,0 +1,25 @@
+import '@aws/lambda-invoke-store';
+import type { LambdaFunctionContext, LogAttributes } from './types/logKeys.js';
+/**
+ * Manages storage of log attributes with automatic context detection.
+ *
+ * This class abstracts the storage mechanism for log attributes, automatically
+ * choosing between AsyncLocalStorage (when in async context) and a fallback
+ * object (when outside async context). The decision is made at runtime on
+ * every method call to support Lambda's transition to async contexts.
+ */
+declare class LogAttributesStore {
+    #private;
+    appendTemporaryKeys(attributes: LogAttributes): void;
+    removeTemporaryKeys(keys: string[]): void;
+    getTemporaryAttributes(): LogAttributes;
+    clearTemporaryAttributes(): void;
+    setLambdaContext(context: LambdaFunctionContext): void;
+    getLambdaContext(): LambdaFunctionContext | undefined;
+    setPersistentAttributes(attributes: LogAttributes): void;
+    getPersistentAttributes(): LogAttributes;
+    getAllAttributes(): LogAttributes;
+    removePersistentKeys(keys: string[]): void;
+}
+export { LogAttributesStore };
+//# sourceMappingURL=LogAttributesStore.d.ts.map

package/node_modules/@aws-lambda-powertools/logger/lib/esm/LogAttributesStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LogAttributesStore.d.ts","sourceRoot":"","sources":["../../src/LogAttributesStore.ts"],"names":[],"mappings":"AAAA,OAAO,0BAA0B,CAAC;AAGlC,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAE/E;;;;;;;GAOG;AACH,cAAM,kBAAkB;;IAoDf,mBAAmB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IAUpD,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAezC,sBAAsB,IAAI,aAAa;IAIvC,wBAAwB,IAAI,IAAI;IAoBhC,gBAAgB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI;IAatD,gBAAgB,IAAI,qBAAqB,GAAG,SAAS;IAQrD,uBAAuB,CAAC,UAAU,EAAE,aAAa,GAAG,IAAI;IASxD,uBAAuB,IAAI,aAAa;IAIxC,gBAAgB,IAAI,aAAa;IAsBjC,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;CAclD;AAED,OAAO,EAAE,kBAAkB,EAAE,CAAC"}