pika-shared 1.0.2

package/dist/util/api-gateway-utils.d.ts

@@ -0,0 +1,133 @@
+import { APIGatewayProxyEventV2WithRequestContext, APIGatewayEventRequestContextV2, Context, APIGatewayProxyResultV2, APIGatewayProxyHandlerV2, APIGatewayProxyStructuredResultV2 } from 'aws-lambda';
+
+/**
+ * Utility functions and types for AWS API Gateway Lambda integration.
+ * This module provides type-safe wrappers and helpers for handling
+ * API Gateway events and responses in AWS Lambda functions.
+ */
+
+/**
+ * Extends the standard Error interface to include an optional HTTP status code.
+ * This allows for standardized error handling with appropriate HTTP responses.
+ */
+interface HttpError extends Error {
+    statusCode?: number;
+}
+/**
+ * A type that enhances the standard API Gateway event by replacing the body property
+ * with a strongly-typed version rather than the default string representation.
+ *
+ * @template TRequestBody - The type of the request body after parsing
+ * @template TRequestContext - The type of the request context
+ */
+interface APIGatewayProxyEventPikaWithRequestContext<TRequestBody, TRequestContext> extends Omit<APIGatewayProxyEventV2WithRequestContext<TRequestContext>, 'body'> {
+    body: TRequestBody;
+}
+/**
+ * A specialized API Gateway event type that includes:
+ * 1. A strongly-typed request body
+ * 2. The standard API Gateway request context
+ * 3. Additional path and httpMethod properties for routing
+ *
+ * @template TRequestBody - The type of the parsed request body (defaults to never if not provided)
+ */
+type APIGatewayProxyEventPika<TRequestBody = never> = APIGatewayProxyEventPikaWithRequestContext<TRequestBody, APIGatewayEventRequestContextV2> & {
+    path: string;
+    httpMethod: string;
+    resource: string;
+};
+/**
+ * A generic handler type for AWS Lambda functions.
+ *
+ * @template TEvent - The event type (input) for the handler
+ * @template TResult - The result type (output) returned by the handler
+ * @returns Either void or a Promise containing the result
+ */
+type HandlerPika<TEvent = unknown, TResult = unknown> = (event: TEvent, context: Context) => void | Promise<TResult>;
+/**
+ * A specialized handler type for API Gateway Lambda integrations with typed request and response.
+ *
+ * @template B - The request body type (defaults to never if not provided)
+ * @template T - The response type (defaults to never if not provided)
+ */
+type APIGatewayProxyHandlerPika<B = never, T = never> = HandlerPika<APIGatewayProxyEventPika<B>, APIGatewayProxyResultV2<T>>;
+/**
+ * A higher-order function that wraps a typed Lambda handler to provide:
+ * 1. Automatic JSON parsing of the request body
+ * 2. Error handling with appropriate status codes
+ * 3. Consistent response formatting
+ *
+ * @template TRequestBody - The expected type of the request body after parsing
+ * @template TResponse - The expected type of the response
+ * @param fn - The Lambda handler function to wrap
+ * @returns A standard API Gateway Lambda handler with error handling and type safety
+ */
+declare function apiGatewayFunctionDecorator<TRequestBody, TResponse>(fn: APIGatewayProxyHandlerPika<TRequestBody, TResponse>): APIGatewayProxyHandlerV2<TResponse>;
+/**
+ * Creates a standardized API Gateway response object.
+ * Handles both string and non-string body types by automatically stringifying as needed.
+ *
+ * @template T - The type of the response body
+ * @param body - The response body to send
+ * @param statusCode - The HTTP status code (defaults to 200 OK)
+ * @returns A properly formatted API Gateway response object
+ */
+declare function toResponse<T>(body: T, statusCode?: number): APIGatewayProxyStructuredResultV2;
+/**
+ * Type definition for Lambda Function URL events with additional IAM authorization details.
+ * Extends the standard API Gateway event with specific requestContext properties for
+ * Function URL integration patterns.
+ *
+ * @template T - The request body type
+ */
+type LambdaFunctionUrlProxyEventPika<T = never> = APIGatewayProxyEventPika<T> & {
+    requestContext: {
+        authorizer?: {
+            iam: {
+                cognitoIdentity?: string;
+                cognitoIdentityId?: string;
+                userId?: string;
+                user?: string;
+                callerId?: string;
+                caller?: string;
+                accessKey?: string;
+                principalOrgId?: string;
+                accountId?: string;
+                userArn?: string;
+                [key: string]: any;
+            };
+        };
+        identity?: {
+            cognitoIdentity?: string;
+            cognitoIdentityId?: string;
+            user?: string;
+            userId?: string;
+            caller?: string;
+            callerId?: string;
+            accessKey?: string;
+            principalOrgId?: string;
+            accountId?: string;
+            userArn?: string;
+            [key: string]: any;
+        };
+    };
+};
+/**
+ * Converts a Lambda Function URL event into a standardized API Gateway event.
+ * This function ensures that IAM authorization details are properly mapped
+ * from the authorizer to the identity property for consistent access patterns.
+ *
+ * Also, parses the body string into the generic type T if it exists and is a string
+ *
+ * This exists because the Lambda Function URL event has a different structure
+ * than the API Gateway event and we almost never use Lambdas that are Function URL based
+ * and so it's easier to just convert the event to a standard API Gateway event than
+ * to handle the different event types.
+ *
+ * @template T - The request body type
+ * @param event - The Lambda Function URL event to convert
+ * @returns A standardized API Gateway event
+ */
+declare function convertFunctionUrlEventToStandardApiGatewayEvent<T>(event: LambdaFunctionUrlProxyEventPika<T>): APIGatewayProxyEventPika<T>;
+
+export { type APIGatewayProxyEventPika, type APIGatewayProxyHandlerPika, type HandlerPika, type HttpError, type LambdaFunctionUrlProxyEventPika, apiGatewayFunctionDecorator, convertFunctionUrlEventToStandardApiGatewayEvent, toResponse };

package/dist/util/api-gateway-utils.js

@@ -0,0 +1,77 @@
+'use strict';
+
+// src/util/api-gateway-utils.ts
+function isObjectResponse(data) {
+  return data !== null && data !== void 0 && typeof data === "object" && ("statusCode" in data || "body" in data);
+}
+function apiGatewayFunctionDecorator(fn) {
+  return async (event, context) => {
+    let error;
+    let response;
+    Object.keys(event.headers).forEach((k) => {
+      let lowerK = k.toLowerCase();
+      if (!event.headers[lowerK]) {
+        event.headers[lowerK] = event.headers[k];
+      }
+    });
+    try {
+      const eventWithType = {
+        ...event,
+        body: event.body ? JSON.parse(event.body) : void 0
+      };
+      response = await fn(eventWithType, context);
+    } catch (err) {
+      error = err;
+    }
+    if (error) {
+      console.error(error);
+      return toResponse(typeof error === "string" ? error : error.message, error.statusCode ?? 500);
+    }
+    if (response === void 0) {
+      return toResponse(
+        {
+          message: "Resource not found",
+          code: "RESOURCE_NOT_FOUND"
+        },
+        404
+      );
+    }
+    return isObjectResponse(response) ? response : toResponse(response, 200);
+  };
+}
+function toResponse(body, statusCode = 200) {
+  return {
+    body: typeof body === "string" ? body : JSON.stringify(body),
+    statusCode
+  };
+}
+function convertFunctionUrlEventToStandardApiGatewayEvent(event) {
+  if (event.requestContext.identity == null && event.requestContext.authorizer?.iam != null) {
+    event.requestContext.identity = event.requestContext.authorizer.iam;
+    event.requestContext.authorizer.iam.cognitoIdentityId = event.headers["cognito-identity-id"];
+    event.requestContext.authorizer.iam.user = event.requestContext.authorizer.iam.userId;
+    event.requestContext.authorizer.iam.caller = event.requestContext.authorizer.iam.callerId;
+  }
+  if (event.body && typeof event.body === "string") {
+    try {
+      const contentType = event.headers["content-type"] || event.headers["Content-Type"];
+      if (contentType && contentType.includes("application/json")) {
+        event.body = JSON.parse(event.body);
+      }
+    } catch (error) {
+      console.error("Error parsing request body as JSON:", {
+        body: event.body,
+        errorMessage: error instanceof Error ? error.message : String(error),
+        errorStack: error instanceof Error ? error.stack : void 0
+      });
+      throw error;
+    }
+  }
+  return event;
+}
+
+exports.apiGatewayFunctionDecorator = apiGatewayFunctionDecorator;
+exports.convertFunctionUrlEventToStandardApiGatewayEvent = convertFunctionUrlEventToStandardApiGatewayEvent;
+exports.toResponse = toResponse;
+//# sourceMappingURL=api-gateway-utils.js.map
+//# sourceMappingURL=api-gateway-utils.js.map

package/dist/util/api-gateway-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/api-gateway-utils.ts"],"names":[],"mappings":"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","file":"api-gateway-utils.js","sourcesContent":["/**\n * Utility functions and types for AWS API Gateway Lambda integration.\n * This module provides type-safe wrappers and helpers for handling\n * API Gateway events and responses in AWS Lambda functions.\n */\nimport type {\n    APIGatewayEventRequestContextV2,\n    APIGatewayProxyEventV2WithRequestContext,\n    APIGatewayProxyHandlerV2,\n    APIGatewayProxyResultV2,\n    APIGatewayProxyStructuredResultV2,\n    Context\n} from 'aws-lambda';\n\n/**\n * Extends the standard Error interface to include an optional HTTP status code.\n * This allows for standardized error handling with appropriate HTTP responses.\n */\nexport interface HttpError extends Error {\n    statusCode?: number;\n}\n\n/**\n * A type that enhances the standard API Gateway event by replacing the body property\n * with a strongly-typed version rather than the default string representation.\n *\n * @template TRequestBody - The type of the request body after parsing\n * @template TRequestContext - The type of the request context\n */\ninterface APIGatewayProxyEventPikaWithRequestContext<TRequestBody, TRequestContext> extends Omit<APIGatewayProxyEventV2WithRequestContext<TRequestContext>, 'body'> {\n    body: TRequestBody;\n}\n\n/**\n * A specialized API Gateway event type that includes:\n * 1. A strongly-typed request body\n * 2. The standard API Gateway request context\n * 3. Additional path and httpMethod properties for routing\n *\n * @template TRequestBody - The type of the parsed request body (defaults to never if not provided)\n */\nexport type APIGatewayProxyEventPika<TRequestBody = never> = APIGatewayProxyEventPikaWithRequestContext<TRequestBody, APIGatewayEventRequestContextV2> & {\n    path: string;\n    httpMethod: string;\n    resource: string;\n};\n\n/**\n * A generic handler type for AWS Lambda functions.\n *\n * @template TEvent - The event type (input) for the handler\n * @template TResult - The result type (output) returned by the handler\n * @returns Either void or a Promise containing the result\n */\nexport type HandlerPika<TEvent = unknown, TResult = unknown> = (event: TEvent, context: Context) => void | Promise<TResult>;\n\n/**\n * A specialized handler type for API Gateway Lambda integrations with typed request and response.\n *\n * @template B - The request body type (defaults to never if not provided)\n * @template T - The response type (defaults to never if not provided)\n */\nexport type APIGatewayProxyHandlerPika<B = never, T = never> = HandlerPika<APIGatewayProxyEventPika<B>, APIGatewayProxyResultV2<T>>;\n\n/**\n * Type guard function that determines if the provided data is a structured API Gateway response.\n * A structured response must be an object containing either 'statusCode' or 'body' properties.\n *\n * @template TResponse - The expected response type\n * @param data - The data to check\n * @returns A type predicate indicating if the data is a structured API Gateway response\n */\nfunction isObjectResponse<TResponse>(data: undefined | void | APIGatewayProxyResultV2<TResponse>): data is APIGatewayProxyStructuredResultV2 {\n    return data !== null && data !== undefined && typeof data === 'object' && ('statusCode' in data || 'body' in data);\n}\n\n/**\n * A higher-order function that wraps a typed Lambda handler to provide:\n * 1. Automatic JSON parsing of the request body\n * 2. Error handling with appropriate status codes\n * 3. Consistent response formatting\n *\n * @template TRequestBody - The expected type of the request body after parsing\n * @template TResponse - The expected type of the response\n * @param fn - The Lambda handler function to wrap\n * @returns A standard API Gateway Lambda handler with error handling and type safety\n */\nexport function apiGatewayFunctionDecorator<TRequestBody, TResponse>(fn: APIGatewayProxyHandlerPika<TRequestBody, TResponse>): APIGatewayProxyHandlerV2<TResponse> {\n    return async (event, context) => {\n        let error: HttpError | undefined;\n        let response: undefined | void | APIGatewayProxyResultV2<TResponse>;\n\n        // Just in case, add another version of the headers with all lowercase keys;\n        // helps when running locally.  Seems APIGateway automatically converts to lowercase\n        Object.keys(event.headers).forEach((k) => {\n            let lowerK = k.toLowerCase();\n            if (!event.headers[lowerK]) {\n                event.headers[lowerK] = event.headers[k];\n            }\n        });\n        try {\n            // Parse the request body if present and create a typed event object\n            const eventWithType: APIGatewayProxyEventPika<TRequestBody> = {\n                ...(event as any),\n                body: event.body ? JSON.parse(event.body) : undefined\n            };\n\n            // Call the handler with the typed event\n            response = await fn(eventWithType, context);\n        } catch (err) {\n            // Capture any errors that occur during processing\n            error = err as HttpError;\n        }\n\n        // Handle errors by returning an appropriate error response\n        if (error) {\n            console.error(error);\n            return toResponse(typeof error === 'string' ? error : error.message, error.statusCode ?? 500);\n        }\n\n        // Return resource not found if the response is undefined\n        if (response === undefined) {\n            return toResponse(\n                {\n                    message: 'Resource not found',\n                    code: 'RESOURCE_NOT_FOUND'\n                },\n                404\n            );\n        }\n\n        // Either return the structured response directly or wrap the result in a standard response\n        return isObjectResponse(response) ? response : toResponse(response, 200);\n    };\n}\n\n/**\n * Creates a standardized API Gateway response object.\n * Handles both string and non-string body types by automatically stringifying as needed.\n *\n * @template T - The type of the response body\n * @param body - The response body to send\n * @param statusCode - The HTTP status code (defaults to 200 OK)\n * @returns A properly formatted API Gateway response object\n */\nexport function toResponse<T>(body: T, statusCode = 200): APIGatewayProxyStructuredResultV2 {\n    return {\n        body: typeof body === 'string' ? body : JSON.stringify(body),\n        statusCode\n    };\n}\n\n/**\n * Type definition for Lambda Function URL events with additional IAM authorization details.\n * Extends the standard API Gateway event with specific requestContext properties for\n * Function URL integration patterns.\n *\n * @template T - The request body type\n */\nexport type LambdaFunctionUrlProxyEventPika<T = never> = APIGatewayProxyEventPika<T> & {\n    requestContext: {\n        authorizer?: {\n            iam: {\n                cognitoIdentity?: string;\n                cognitoIdentityId?: string;\n                userId?: string;\n                user?: string;\n                callerId?: string;\n                caller?: string;\n                accessKey?: string;\n                principalOrgId?: string;\n                accountId?: string;\n                userArn?: string;\n                [key: string]: any;\n            };\n        };\n        identity?: {\n            cognitoIdentity?: string;\n            cognitoIdentityId?: string;\n            user?: string;\n            userId?: string;\n            caller?: string;\n            callerId?: string;\n            accessKey?: string;\n            principalOrgId?: string;\n            accountId?: string;\n            userArn?: string;\n            [key: string]: any;\n        };\n    };\n};\n\n/**\n * Converts a Lambda Function URL event into a standardized API Gateway event.\n * This function ensures that IAM authorization details are properly mapped\n * from the authorizer to the identity property for consistent access patterns.\n *\n * Also, parses the body string into the generic type T if it exists and is a string\n *\n * This exists because the Lambda Function URL event has a different structure\n * than the API Gateway event and we almost never use Lambdas that are Function URL based\n * and so it's easier to just convert the event to a standard API Gateway event than\n * to handle the different event types.\n *\n * @template T - The request body type\n * @param event - The Lambda Function URL event to convert\n * @returns A standardized API Gateway event\n */\nexport function convertFunctionUrlEventToStandardApiGatewayEvent<T>(event: LambdaFunctionUrlProxyEventPika<T>): APIGatewayProxyEventPika<T> {\n    if (event.requestContext.identity == null && event.requestContext.authorizer?.iam != null) {\n        event.requestContext.identity = event.requestContext.authorizer.iam;\n        event.requestContext.authorizer.iam.cognitoIdentityId = event.headers['cognito-identity-id'];\n        event.requestContext.authorizer.iam.user = event.requestContext.authorizer.iam.userId;\n        event.requestContext.authorizer.iam.caller = event.requestContext.authorizer.iam.callerId;\n    }\n\n    // Parse the body string into the generic type T if it exists and is a string\n    if (event.body && typeof event.body === 'string') {\n        try {\n            // If content-type is not application/json, don't attempt to parse\n            const contentType = event.headers['content-type'] || event.headers['Content-Type'];\n            if (contentType && contentType.includes('application/json')) {\n                event.body = JSON.parse(event.body) as T;\n            }\n        } catch (error) {\n            console.error('Error parsing request body as JSON:', {\n                body: event.body,\n                errorMessage: error instanceof Error ? error.message : String(error),\n                errorStack: error instanceof Error ? error.stack : undefined\n            });\n            throw error;\n        }\n    }\n\n    return event;\n}\n"]}

package/dist/util/api-gateway-utils.mjs

@@ -0,0 +1,73 @@
+// src/util/api-gateway-utils.ts
+function isObjectResponse(data) {
+  return data !== null && data !== void 0 && typeof data === "object" && ("statusCode" in data || "body" in data);
+}
+function apiGatewayFunctionDecorator(fn) {
+  return async (event, context) => {
+    let error;
+    let response;
+    Object.keys(event.headers).forEach((k) => {
+      let lowerK = k.toLowerCase();
+      if (!event.headers[lowerK]) {
+        event.headers[lowerK] = event.headers[k];
+      }
+    });
+    try {
+      const eventWithType = {
+        ...event,
+        body: event.body ? JSON.parse(event.body) : void 0
+      };
+      response = await fn(eventWithType, context);
+    } catch (err) {
+      error = err;
+    }
+    if (error) {
+      console.error(error);
+      return toResponse(typeof error === "string" ? error : error.message, error.statusCode ?? 500);
+    }
+    if (response === void 0) {
+      return toResponse(
+        {
+          message: "Resource not found",
+          code: "RESOURCE_NOT_FOUND"
+        },
+        404
+      );
+    }
+    return isObjectResponse(response) ? response : toResponse(response, 200);
+  };
+}
+function toResponse(body, statusCode = 200) {
+  return {
+    body: typeof body === "string" ? body : JSON.stringify(body),
+    statusCode
+  };
+}
+function convertFunctionUrlEventToStandardApiGatewayEvent(event) {
+  if (event.requestContext.identity == null && event.requestContext.authorizer?.iam != null) {
+    event.requestContext.identity = event.requestContext.authorizer.iam;
+    event.requestContext.authorizer.iam.cognitoIdentityId = event.headers["cognito-identity-id"];
+    event.requestContext.authorizer.iam.user = event.requestContext.authorizer.iam.userId;
+    event.requestContext.authorizer.iam.caller = event.requestContext.authorizer.iam.callerId;
+  }
+  if (event.body && typeof event.body === "string") {
+    try {
+      const contentType = event.headers["content-type"] || event.headers["Content-Type"];
+      if (contentType && contentType.includes("application/json")) {
+        event.body = JSON.parse(event.body);
+      }
+    } catch (error) {
+      console.error("Error parsing request body as JSON:", {
+        body: event.body,
+        errorMessage: error instanceof Error ? error.message : String(error),
+        errorStack: error instanceof Error ? error.stack : void 0
+      });
+      throw error;
+    }
+  }
+  return event;
+}
+
+export { apiGatewayFunctionDecorator, convertFunctionUrlEventToStandardApiGatewayEvent, toResponse };
+//# sourceMappingURL=api-gateway-utils.mjs.map
+//# sourceMappingURL=api-gateway-utils.mjs.map

package/dist/util/api-gateway-utils.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/util/api-gateway-utils.ts"],"names":[],"mappings":"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","file":"api-gateway-utils.mjs","sourcesContent":["/**\n * Utility functions and types for AWS API Gateway Lambda integration.\n * This module provides type-safe wrappers and helpers for handling\n * API Gateway events and responses in AWS Lambda functions.\n */\nimport type {\n    APIGatewayEventRequestContextV2,\n    APIGatewayProxyEventV2WithRequestContext,\n    APIGatewayProxyHandlerV2,\n    APIGatewayProxyResultV2,\n    APIGatewayProxyStructuredResultV2,\n    Context\n} from 'aws-lambda';\n\n/**\n * Extends the standard Error interface to include an optional HTTP status code.\n * This allows for standardized error handling with appropriate HTTP responses.\n */\nexport interface HttpError extends Error {\n    statusCode?: number;\n}\n\n/**\n * A type that enhances the standard API Gateway event by replacing the body property\n * with a strongly-typed version rather than the default string representation.\n *\n * @template TRequestBody - The type of the request body after parsing\n * @template TRequestContext - The type of the request context\n */\ninterface APIGatewayProxyEventPikaWithRequestContext<TRequestBody, TRequestContext> extends Omit<APIGatewayProxyEventV2WithRequestContext<TRequestContext>, 'body'> {\n    body: TRequestBody;\n}\n\n/**\n * A specialized API Gateway event type that includes:\n * 1. A strongly-typed request body\n * 2. The standard API Gateway request context\n * 3. Additional path and httpMethod properties for routing\n *\n * @template TRequestBody - The type of the parsed request body (defaults to never if not provided)\n */\nexport type APIGatewayProxyEventPika<TRequestBody = never> = APIGatewayProxyEventPikaWithRequestContext<TRequestBody, APIGatewayEventRequestContextV2> & {\n    path: string;\n    httpMethod: string;\n    resource: string;\n};\n\n/**\n * A generic handler type for AWS Lambda functions.\n *\n * @template TEvent - The event type (input) for the handler\n * @template TResult - The result type (output) returned by the handler\n * @returns Either void or a Promise containing the result\n */\nexport type HandlerPika<TEvent = unknown, TResult = unknown> = (event: TEvent, context: Context) => void | Promise<TResult>;\n\n/**\n * A specialized handler type for API Gateway Lambda integrations with typed request and response.\n *\n * @template B - The request body type (defaults to never if not provided)\n * @template T - The response type (defaults to never if not provided)\n */\nexport type APIGatewayProxyHandlerPika<B = never, T = never> = HandlerPika<APIGatewayProxyEventPika<B>, APIGatewayProxyResultV2<T>>;\n\n/**\n * Type guard function that determines if the provided data is a structured API Gateway response.\n * A structured response must be an object containing either 'statusCode' or 'body' properties.\n *\n * @template TResponse - The expected response type\n * @param data - The data to check\n * @returns A type predicate indicating if the data is a structured API Gateway response\n */\nfunction isObjectResponse<TResponse>(data: undefined | void | APIGatewayProxyResultV2<TResponse>): data is APIGatewayProxyStructuredResultV2 {\n    return data !== null && data !== undefined && typeof data === 'object' && ('statusCode' in data || 'body' in data);\n}\n\n/**\n * A higher-order function that wraps a typed Lambda handler to provide:\n * 1. Automatic JSON parsing of the request body\n * 2. Error handling with appropriate status codes\n * 3. Consistent response formatting\n *\n * @template TRequestBody - The expected type of the request body after parsing\n * @template TResponse - The expected type of the response\n * @param fn - The Lambda handler function to wrap\n * @returns A standard API Gateway Lambda handler with error handling and type safety\n */\nexport function apiGatewayFunctionDecorator<TRequestBody, TResponse>(fn: APIGatewayProxyHandlerPika<TRequestBody, TResponse>): APIGatewayProxyHandlerV2<TResponse> {\n    return async (event, context) => {\n        let error: HttpError | undefined;\n        let response: undefined | void | APIGatewayProxyResultV2<TResponse>;\n\n        // Just in case, add another version of the headers with all lowercase keys;\n        // helps when running locally.  Seems APIGateway automatically converts to lowercase\n        Object.keys(event.headers).forEach((k) => {\n            let lowerK = k.toLowerCase();\n            if (!event.headers[lowerK]) {\n                event.headers[lowerK] = event.headers[k];\n            }\n        });\n        try {\n            // Parse the request body if present and create a typed event object\n            const eventWithType: APIGatewayProxyEventPika<TRequestBody> = {\n                ...(event as any),\n                body: event.body ? JSON.parse(event.body) : undefined\n            };\n\n            // Call the handler with the typed event\n            response = await fn(eventWithType, context);\n        } catch (err) {\n            // Capture any errors that occur during processing\n            error = err as HttpError;\n        }\n\n        // Handle errors by returning an appropriate error response\n        if (error) {\n            console.error(error);\n            return toResponse(typeof error === 'string' ? error : error.message, error.statusCode ?? 500);\n        }\n\n        // Return resource not found if the response is undefined\n        if (response === undefined) {\n            return toResponse(\n                {\n                    message: 'Resource not found',\n                    code: 'RESOURCE_NOT_FOUND'\n                },\n                404\n            );\n        }\n\n        // Either return the structured response directly or wrap the result in a standard response\n        return isObjectResponse(response) ? response : toResponse(response, 200);\n    };\n}\n\n/**\n * Creates a standardized API Gateway response object.\n * Handles both string and non-string body types by automatically stringifying as needed.\n *\n * @template T - The type of the response body\n * @param body - The response body to send\n * @param statusCode - The HTTP status code (defaults to 200 OK)\n * @returns A properly formatted API Gateway response object\n */\nexport function toResponse<T>(body: T, statusCode = 200): APIGatewayProxyStructuredResultV2 {\n    return {\n        body: typeof body === 'string' ? body : JSON.stringify(body),\n        statusCode\n    };\n}\n\n/**\n * Type definition for Lambda Function URL events with additional IAM authorization details.\n * Extends the standard API Gateway event with specific requestContext properties for\n * Function URL integration patterns.\n *\n * @template T - The request body type\n */\nexport type LambdaFunctionUrlProxyEventPika<T = never> = APIGatewayProxyEventPika<T> & {\n    requestContext: {\n        authorizer?: {\n            iam: {\n                cognitoIdentity?: string;\n                cognitoIdentityId?: string;\n                userId?: string;\n                user?: string;\n                callerId?: string;\n                caller?: string;\n                accessKey?: string;\n                principalOrgId?: string;\n                accountId?: string;\n                userArn?: string;\n                [key: string]: any;\n            };\n        };\n        identity?: {\n            cognitoIdentity?: string;\n            cognitoIdentityId?: string;\n            user?: string;\n            userId?: string;\n            caller?: string;\n            callerId?: string;\n            accessKey?: string;\n            principalOrgId?: string;\n            accountId?: string;\n            userArn?: string;\n            [key: string]: any;\n        };\n    };\n};\n\n/**\n * Converts a Lambda Function URL event into a standardized API Gateway event.\n * This function ensures that IAM authorization details are properly mapped\n * from the authorizer to the identity property for consistent access patterns.\n *\n * Also, parses the body string into the generic type T if it exists and is a string\n *\n * This exists because the Lambda Function URL event has a different structure\n * than the API Gateway event and we almost never use Lambdas that are Function URL based\n * and so it's easier to just convert the event to a standard API Gateway event than\n * to handle the different event types.\n *\n * @template T - The request body type\n * @param event - The Lambda Function URL event to convert\n * @returns A standardized API Gateway event\n */\nexport function convertFunctionUrlEventToStandardApiGatewayEvent<T>(event: LambdaFunctionUrlProxyEventPika<T>): APIGatewayProxyEventPika<T> {\n    if (event.requestContext.identity == null && event.requestContext.authorizer?.iam != null) {\n        event.requestContext.identity = event.requestContext.authorizer.iam;\n        event.requestContext.authorizer.iam.cognitoIdentityId = event.headers['cognito-identity-id'];\n        event.requestContext.authorizer.iam.user = event.requestContext.authorizer.iam.userId;\n        event.requestContext.authorizer.iam.caller = event.requestContext.authorizer.iam.callerId;\n    }\n\n    // Parse the body string into the generic type T if it exists and is a string\n    if (event.body && typeof event.body === 'string') {\n        try {\n            // If content-type is not application/json, don't attempt to parse\n            const contentType = event.headers['content-type'] || event.headers['Content-Type'];\n            if (contentType && contentType.includes('application/json')) {\n                event.body = JSON.parse(event.body) as T;\n            }\n        } catch (error) {\n            console.error('Error parsing request body as JSON:', {\n                body: event.body,\n                errorMessage: error instanceof Error ? error.message : String(error),\n                errorStack: error instanceof Error ? error.stack : undefined\n            });\n            throw error;\n        }\n    }\n\n    return event;\n}\n"]}

package/dist/util/bedrock.d.mts

@@ -0,0 +1,53 @@
+import { BedrockActionGroupLambdaEvent, BedrockActionGroupLambdaResponse, Parameter } from '../types/chatbot/bedrock.mjs';
+import { SessionDataWithChatUserCustomDataSpreadIn, RecordOrUndef } from '../types/chatbot/chatbot-types.mjs';
+import '@aws-sdk/client-bedrock-agent-runtime';
+
+/**
+ * Handles an error and returns a BedrockLambdaResponse object.
+ *
+ * If the error is an instance of BedrockLambdaError, it will be returned as is.
+ * Otherwise, it will be converted to a string and returned as a BedrockLambdaError.
+ *
+ * @param error The error to handle.
+ * @returns A BedrockLambdaResponse object.
+ */
+declare function handleBedrockError(error: unknown, event: BedrockActionGroupLambdaEvent, sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>): BedrockActionGroupLambdaResponse;
+/**
+ * Converter functions for Bedrock parameters.
+ */
+declare const converters: Record<string, (v: string) => any>;
+/**
+ * Converts Bedrock parameters to the correct type.
+ * @param params - The parameters to convert.
+ * @returns A record of parameter names and their converted values.
+ */
+declare function convertBedrockParamsToCorrectType(params?: Parameter[]): Record<string, any>;
+/**
+ * Normalizes the session attributes, converting the type to T.  An empty sessionAttributes object is the
+ * same as undefined.
+ *
+ * Type T is the type of the session attributes.
+ *
+ * @param sessionAttributes The session attributes.
+ * @returns The normalized session attributes.
+ */
+declare function normalizeSessionAttributes(sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>): SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef> | undefined;
+/**
+ * Creates a BedrockLambdaResponse object.
+ *
+ * Type T is the type of the session attributes.  By including the sessionAttributes
+ * parameter, we are telling Bedrock to persist the session attributes for the
+ * duration of the session and they will be passed in on all subsequent calls
+ * using the event.sessionAttributes parameter.
+ *
+ * @param body The body of the response.
+ * @param actionGroup The action group.
+ * @param messageVersion The message version.
+ * @param functionName The function name.
+ * @param sessionAttributes The session attributes.
+ * @param failed Whether the response is a failure.
+ * @returns A BedrockLambdaResponse object.
+ */
+declare function createBedrockLambdaResponse(body: string | Record<string, any>, actionGroup: string, messageVersion: string, functionName: string, sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>, failed?: boolean): BedrockActionGroupLambdaResponse;
+
+export { convertBedrockParamsToCorrectType, converters, createBedrockLambdaResponse, handleBedrockError, normalizeSessionAttributes };

package/dist/util/bedrock.d.ts

@@ -0,0 +1,53 @@
+import { BedrockActionGroupLambdaEvent, BedrockActionGroupLambdaResponse, Parameter } from '../types/chatbot/bedrock.js';
+import { SessionDataWithChatUserCustomDataSpreadIn, RecordOrUndef } from '../types/chatbot/chatbot-types.js';
+import '@aws-sdk/client-bedrock-agent-runtime';
+
+/**
+ * Handles an error and returns a BedrockLambdaResponse object.
+ *
+ * If the error is an instance of BedrockLambdaError, it will be returned as is.
+ * Otherwise, it will be converted to a string and returned as a BedrockLambdaError.
+ *
+ * @param error The error to handle.
+ * @returns A BedrockLambdaResponse object.
+ */
+declare function handleBedrockError(error: unknown, event: BedrockActionGroupLambdaEvent, sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>): BedrockActionGroupLambdaResponse;
+/**
+ * Converter functions for Bedrock parameters.
+ */
+declare const converters: Record<string, (v: string) => any>;
+/**
+ * Converts Bedrock parameters to the correct type.
+ * @param params - The parameters to convert.
+ * @returns A record of parameter names and their converted values.
+ */
+declare function convertBedrockParamsToCorrectType(params?: Parameter[]): Record<string, any>;
+/**
+ * Normalizes the session attributes, converting the type to T.  An empty sessionAttributes object is the
+ * same as undefined.
+ *
+ * Type T is the type of the session attributes.
+ *
+ * @param sessionAttributes The session attributes.
+ * @returns The normalized session attributes.
+ */
+declare function normalizeSessionAttributes(sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>): SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef> | undefined;
+/**
+ * Creates a BedrockLambdaResponse object.
+ *
+ * Type T is the type of the session attributes.  By including the sessionAttributes
+ * parameter, we are telling Bedrock to persist the session attributes for the
+ * duration of the session and they will be passed in on all subsequent calls
+ * using the event.sessionAttributes parameter.
+ *
+ * @param body The body of the response.
+ * @param actionGroup The action group.
+ * @param messageVersion The message version.
+ * @param functionName The function name.
+ * @param sessionAttributes The session attributes.
+ * @param failed Whether the response is a failure.
+ * @returns A BedrockLambdaResponse object.
+ */
+declare function createBedrockLambdaResponse(body: string | Record<string, any>, actionGroup: string, messageVersion: string, functionName: string, sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>, failed?: boolean): BedrockActionGroupLambdaResponse;
+
+export { convertBedrockParamsToCorrectType, converters, createBedrockLambdaResponse, handleBedrockError, normalizeSessionAttributes };

package/dist/util/bedrock.js

@@ -0,0 +1,80 @@
+'use strict';
+
+// src/types/chatbot/bedrock-lambda-error.ts
+var BedrockLambdaError = class extends Error {
+  constructor(message) {
+    super(message);
+  }
+};
+
+// src/util/bedrock.ts
+function handleBedrockError(error, event, sessionAttributes) {
+  if (error instanceof BedrockLambdaError) {
+    return createBedrockLambdaResponse(error.message, event.actionGroup, event.messageVersion, event.function ?? "NoFunctionNameSpecified", sessionAttributes);
+  } else {
+    console.error("Unexpected error:", error);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return createBedrockLambdaResponse(errorMessage, event.actionGroup, event.messageVersion, event.function ?? "NoFunctionNameSpecified", sessionAttributes, true);
+  }
+}
+var converters = {
+  defaultPassThrough: (v) => v,
+  number: (v) => parseFloat(v),
+  boolean: (v) => v === "true",
+  integer: (v) => parseInt(v),
+  array: (v) => {
+    try {
+      return JSON.parse(v);
+    } catch {
+      if (v.startsWith("[") && v.endsWith("]")) {
+        const content = v.slice(1, -1).trim();
+        if (content === "") {
+          return [];
+        }
+        return content.split(",").map((item) => item.trim());
+      }
+      return [v];
+    }
+  }
+};
+function convertBedrockParamsToCorrectType(params) {
+  return params?.reduce(
+    (acc, param) => {
+      acc[param.name] = converters[param.type] ? converters[param.type](param.value) : converters.defaultPassThrough(param.value);
+      return acc;
+    },
+    {}
+  ) ?? {};
+}
+function normalizeSessionAttributes(sessionAttributes) {
+  if (!sessionAttributes || Object.keys(sessionAttributes).length === 0) {
+    return void 0;
+  }
+  return sessionAttributes;
+}
+function createBedrockLambdaResponse(body, actionGroup, messageVersion, functionName, sessionAttributes, failed) {
+  return {
+    messageVersion,
+    response: {
+      actionGroup,
+      function: functionName,
+      functionResponse: {
+        ...failed ? { responseState: "FAILURE" } : {},
+        responseBody: {
+          TEXT: {
+            body: typeof body === "string" ? body : JSON.stringify(body)
+          }
+        }
+      }
+    },
+    sessionAttributes
+  };
+}
+
+exports.convertBedrockParamsToCorrectType = convertBedrockParamsToCorrectType;
+exports.converters = converters;
+exports.createBedrockLambdaResponse = createBedrockLambdaResponse;
+exports.handleBedrockError = handleBedrockError;
+exports.normalizeSessionAttributes = normalizeSessionAttributes;
+//# sourceMappingURL=bedrock.js.map
+//# sourceMappingURL=bedrock.js.map

package/dist/util/bedrock.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/chatbot/bedrock-lambda-error.ts","../../src/util/bedrock.ts"],"names":[],"mappings":"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","file":"bedrock.js","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n","import { BedrockActionGroupLambdaEvent, BedrockActionGroupLambdaResponse, Parameter } from '../types/chatbot/bedrock';\nimport { BedrockLambdaError } from '../types/chatbot/bedrock-lambda-error';\nimport { RecordOrUndef, SessionDataWithChatUserCustomDataSpreadIn } from '../types/chatbot/chatbot-types';\n\n/**\n * Handles an error and returns a BedrockLambdaResponse object.\n *\n * If the error is an instance of BedrockLambdaError, it will be returned as is.\n * Otherwise, it will be converted to a string and returned as a BedrockLambdaError.\n *\n * @param error The error to handle.\n * @returns A BedrockLambdaResponse object.\n */\nexport function handleBedrockError(\n    error: unknown,\n    event: BedrockActionGroupLambdaEvent,\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>\n): BedrockActionGroupLambdaResponse {\n    if (error instanceof BedrockLambdaError) {\n        return createBedrockLambdaResponse(error.message, event.actionGroup, event.messageVersion, event.function ?? 'NoFunctionNameSpecified', sessionAttributes);\n    } else {\n        console.error('Unexpected error:', error);\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return createBedrockLambdaResponse(errorMessage, event.actionGroup, event.messageVersion, event.function ?? 'NoFunctionNameSpecified', sessionAttributes, true);\n    }\n}\n\n/**\n * Converter functions for Bedrock parameters.\n */\nexport const converters: Record<string, (v: string) => any> = {\n    defaultPassThrough: (v: string) => v,\n    number: (v: string) => parseFloat(v),\n    boolean: (v: string) => v === 'true',\n    integer: (v: string) => parseInt(v),\n    array: (v: string) => {\n        try {\n            // First try to parse as valid JSON\n            return JSON.parse(v);\n        } catch {\n            /* \n                TODO: is this a good idea?  Why did Bedrock give me a param that was invalid JSON for the array?\n\n                {\n                    \"name\": \"s3Keys\",\n                    \"type\": \"array\",\n                    \"value\": \"[uploads/2fbbf97a-070d-48ca-9d5e-fc9bcc88e570/019735c5-b0f0-7419-94d5-093b4202977a_sample-data.csv]\"\n                }\n            */\n            // If JSON.parse fails, try to handle array with unquoted strings\n            // Remove brackets and split by comma, then trim whitespace\n            if (v.startsWith('[') && v.endsWith(']')) {\n                const content = v.slice(1, -1).trim();\n                if (content === '') {\n                    return [];\n                }\n                return content.split(',').map((item) => item.trim());\n            }\n            // If it doesn't look like an array format, return as single-item array\n            return [v];\n        }\n    }\n};\n\n/**\n * Converts Bedrock parameters to the correct type.\n * @param params - The parameters to convert.\n * @returns A record of parameter names and their converted values.\n */\nexport function convertBedrockParamsToCorrectType(params?: Parameter[]): Record<string, any> {\n    return (\n        params?.reduce(\n            (acc, param) => {\n                acc[param.name] = converters[param.type] ? converters[param.type](param.value) : converters.defaultPassThrough(param.value);\n                return acc;\n            },\n            {} as Record<string, any>\n        ) ?? {}\n    );\n}\n\n/**\n * Normalizes the session attributes, converting the type to T.  An empty sessionAttributes object is the\n * same as undefined.\n *\n * Type T is the type of the session attributes.\n *\n * @param sessionAttributes The session attributes.\n * @returns The normalized session attributes.\n */\nexport function normalizeSessionAttributes(\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>\n): SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef> | undefined {\n    if (!sessionAttributes || Object.keys(sessionAttributes).length === 0) {\n        return undefined;\n    }\n\n    return sessionAttributes;\n}\n\n/**\n * Creates a BedrockLambdaResponse object.\n *\n * Type T is the type of the session attributes.  By including the sessionAttributes\n * parameter, we are telling Bedrock to persist the session attributes for the\n * duration of the session and they will be passed in on all subsequent calls\n * using the event.sessionAttributes parameter.\n *\n * @param body The body of the response.\n * @param actionGroup The action group.\n * @param messageVersion The message version.\n * @param functionName The function name.\n * @param sessionAttributes The session attributes.\n * @param failed Whether the response is a failure.\n * @returns A BedrockLambdaResponse object.\n */\nexport function createBedrockLambdaResponse(\n    body: string | Record<string, any>,\n    actionGroup: string,\n    messageVersion: string,\n    functionName: string,\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>,\n    failed?: boolean\n): BedrockActionGroupLambdaResponse {\n    return {\n        messageVersion,\n        response: {\n            actionGroup,\n            function: functionName,\n            functionResponse: {\n                ...(failed ? { responseState: 'FAILURE' } : {}),\n                responseBody: {\n                    TEXT: {\n                        body: typeof body === 'string' ? body : JSON.stringify(body)\n                    }\n                }\n            }\n        },\n        sessionAttributes\n    };\n}\n"]}

package/dist/util/bedrock.mjs

@@ -0,0 +1,74 @@
+// src/types/chatbot/bedrock-lambda-error.ts
+var BedrockLambdaError = class extends Error {
+  constructor(message) {
+    super(message);
+  }
+};
+
+// src/util/bedrock.ts
+function handleBedrockError(error, event, sessionAttributes) {
+  if (error instanceof BedrockLambdaError) {
+    return createBedrockLambdaResponse(error.message, event.actionGroup, event.messageVersion, event.function ?? "NoFunctionNameSpecified", sessionAttributes);
+  } else {
+    console.error("Unexpected error:", error);
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return createBedrockLambdaResponse(errorMessage, event.actionGroup, event.messageVersion, event.function ?? "NoFunctionNameSpecified", sessionAttributes, true);
+  }
+}
+var converters = {
+  defaultPassThrough: (v) => v,
+  number: (v) => parseFloat(v),
+  boolean: (v) => v === "true",
+  integer: (v) => parseInt(v),
+  array: (v) => {
+    try {
+      return JSON.parse(v);
+    } catch {
+      if (v.startsWith("[") && v.endsWith("]")) {
+        const content = v.slice(1, -1).trim();
+        if (content === "") {
+          return [];
+        }
+        return content.split(",").map((item) => item.trim());
+      }
+      return [v];
+    }
+  }
+};
+function convertBedrockParamsToCorrectType(params) {
+  return params?.reduce(
+    (acc, param) => {
+      acc[param.name] = converters[param.type] ? converters[param.type](param.value) : converters.defaultPassThrough(param.value);
+      return acc;
+    },
+    {}
+  ) ?? {};
+}
+function normalizeSessionAttributes(sessionAttributes) {
+  if (!sessionAttributes || Object.keys(sessionAttributes).length === 0) {
+    return void 0;
+  }
+  return sessionAttributes;
+}
+function createBedrockLambdaResponse(body, actionGroup, messageVersion, functionName, sessionAttributes, failed) {
+  return {
+    messageVersion,
+    response: {
+      actionGroup,
+      function: functionName,
+      functionResponse: {
+        ...failed ? { responseState: "FAILURE" } : {},
+        responseBody: {
+          TEXT: {
+            body: typeof body === "string" ? body : JSON.stringify(body)
+          }
+        }
+      }
+    },
+    sessionAttributes
+  };
+}
+
+export { convertBedrockParamsToCorrectType, converters, createBedrockLambdaResponse, handleBedrockError, normalizeSessionAttributes };
+//# sourceMappingURL=bedrock.mjs.map
+//# sourceMappingURL=bedrock.mjs.map

package/dist/util/bedrock.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/chatbot/bedrock-lambda-error.ts","../../src/util/bedrock.ts"],"names":[],"mappings":"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","file":"bedrock.mjs","sourcesContent":["/**\n * This error is used to allow us to distinguish between errors that are\n * expected to be returned to the user and errors that are unexpected.\n *\n * These errors are caught in the Bedrock Lambda and converted into a\n * BedrockLambdaResponse object using the message as the body.\n */\nexport class BedrockLambdaError extends Error {\n    constructor(message: string) {\n        super(message);\n    }\n}\n","import { BedrockActionGroupLambdaEvent, BedrockActionGroupLambdaResponse, Parameter } from '../types/chatbot/bedrock';\nimport { BedrockLambdaError } from '../types/chatbot/bedrock-lambda-error';\nimport { RecordOrUndef, SessionDataWithChatUserCustomDataSpreadIn } from '../types/chatbot/chatbot-types';\n\n/**\n * Handles an error and returns a BedrockLambdaResponse object.\n *\n * If the error is an instance of BedrockLambdaError, it will be returned as is.\n * Otherwise, it will be converted to a string and returned as a BedrockLambdaError.\n *\n * @param error The error to handle.\n * @returns A BedrockLambdaResponse object.\n */\nexport function handleBedrockError(\n    error: unknown,\n    event: BedrockActionGroupLambdaEvent,\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>\n): BedrockActionGroupLambdaResponse {\n    if (error instanceof BedrockLambdaError) {\n        return createBedrockLambdaResponse(error.message, event.actionGroup, event.messageVersion, event.function ?? 'NoFunctionNameSpecified', sessionAttributes);\n    } else {\n        console.error('Unexpected error:', error);\n        const errorMessage = error instanceof Error ? error.message : String(error);\n        return createBedrockLambdaResponse(errorMessage, event.actionGroup, event.messageVersion, event.function ?? 'NoFunctionNameSpecified', sessionAttributes, true);\n    }\n}\n\n/**\n * Converter functions for Bedrock parameters.\n */\nexport const converters: Record<string, (v: string) => any> = {\n    defaultPassThrough: (v: string) => v,\n    number: (v: string) => parseFloat(v),\n    boolean: (v: string) => v === 'true',\n    integer: (v: string) => parseInt(v),\n    array: (v: string) => {\n        try {\n            // First try to parse as valid JSON\n            return JSON.parse(v);\n        } catch {\n            /* \n                TODO: is this a good idea?  Why did Bedrock give me a param that was invalid JSON for the array?\n\n                {\n                    \"name\": \"s3Keys\",\n                    \"type\": \"array\",\n                    \"value\": \"[uploads/2fbbf97a-070d-48ca-9d5e-fc9bcc88e570/019735c5-b0f0-7419-94d5-093b4202977a_sample-data.csv]\"\n                }\n            */\n            // If JSON.parse fails, try to handle array with unquoted strings\n            // Remove brackets and split by comma, then trim whitespace\n            if (v.startsWith('[') && v.endsWith(']')) {\n                const content = v.slice(1, -1).trim();\n                if (content === '') {\n                    return [];\n                }\n                return content.split(',').map((item) => item.trim());\n            }\n            // If it doesn't look like an array format, return as single-item array\n            return [v];\n        }\n    }\n};\n\n/**\n * Converts Bedrock parameters to the correct type.\n * @param params - The parameters to convert.\n * @returns A record of parameter names and their converted values.\n */\nexport function convertBedrockParamsToCorrectType(params?: Parameter[]): Record<string, any> {\n    return (\n        params?.reduce(\n            (acc, param) => {\n                acc[param.name] = converters[param.type] ? converters[param.type](param.value) : converters.defaultPassThrough(param.value);\n                return acc;\n            },\n            {} as Record<string, any>\n        ) ?? {}\n    );\n}\n\n/**\n * Normalizes the session attributes, converting the type to T.  An empty sessionAttributes object is the\n * same as undefined.\n *\n * Type T is the type of the session attributes.\n *\n * @param sessionAttributes The session attributes.\n * @returns The normalized session attributes.\n */\nexport function normalizeSessionAttributes(\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>\n): SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef> | undefined {\n    if (!sessionAttributes || Object.keys(sessionAttributes).length === 0) {\n        return undefined;\n    }\n\n    return sessionAttributes;\n}\n\n/**\n * Creates a BedrockLambdaResponse object.\n *\n * Type T is the type of the session attributes.  By including the sessionAttributes\n * parameter, we are telling Bedrock to persist the session attributes for the\n * duration of the session and they will be passed in on all subsequent calls\n * using the event.sessionAttributes parameter.\n *\n * @param body The body of the response.\n * @param actionGroup The action group.\n * @param messageVersion The message version.\n * @param functionName The function name.\n * @param sessionAttributes The session attributes.\n * @param failed Whether the response is a failure.\n * @returns A BedrockLambdaResponse object.\n */\nexport function createBedrockLambdaResponse(\n    body: string | Record<string, any>,\n    actionGroup: string,\n    messageVersion: string,\n    functionName: string,\n    sessionAttributes?: SessionDataWithChatUserCustomDataSpreadIn<RecordOrUndef>,\n    failed?: boolean\n): BedrockActionGroupLambdaResponse {\n    return {\n        messageVersion,\n        response: {\n            actionGroup,\n            function: functionName,\n            functionResponse: {\n                ...(failed ? { responseState: 'FAILURE' } : {}),\n                responseBody: {\n                    TEXT: {\n                        body: typeof body === 'string' ? body : JSON.stringify(body)\n                    }\n                }\n            }\n        },\n        sessionAttributes\n    };\n}\n"]}