@lambda-kata/cdk 0.1.3-rc.67 → 0.1.3-rc.69

package/out/tsc/src/index.d.ts

@@ -23,6 +23,8 @@ export { MockLicensingService, createMockLicensingService, } from './mock-licens
 export { resolveAccountId, resolveAccountIdWithSource, isValidAccountIdFormat, AccountResolutionError, AccountResolutionResult, AccountResolverOptions, } from './account-resolver';
 export { resolveAccountIdSync, resolveAccountIdSyncWithSource, resolveRegionSync, SyncAccountResolutionError, SyncAccountResolutionResult, SyncAccountResolverOptions, } from './sync-account-resolver';
 export { kata, kataWithAccountId, applyTransformation, handleUnlicensed, isKataTransformed, getKataPromise, extractBundlePathFromHandler, KataWrapperOptions, KataResult, } from './kata-wrapper';
+export { SnapStartActivator, SnapStartActivatorProps, } from './snapstart-construct';
+export { activateSnapStart, SnapStartActivationResult, SnapStartActivatorConfig, } from './snapstart-activator';
 export { createKataConfigLayer, generateConfigContent, KataConfigLayerProps, CONFIG_DIR_NAME, CONFIG_FILE_NAME, HANDLER_CONFIG_KEY, } from './config-layer';
 export { EnsureNodeRuntimeLayerOptions, EnsureNodeRuntimeLayerResult, NodeVersionInfo, LayerInfo, LayerSearchOptions, LayerRequirements, LayerCreationOptions, Logger, RuntimeDetector, LayerManager, ErrorCodes, NodeRuntimeLayerError, VersionCacheEntry, LayerMetadata, NodejsLayerDeploymentOptions, NodejsLayerDeploymentResult, MultiArchitectureDeploymentResult, } from './nodejs-layer-manager';
 export { DockerRuntimeDetector, DockerRuntimeDetectorOptions, } from './docker-runtime-detector';

package/out/tsc/src/snapstart-activator.d.ts

@@ -0,0 +1,101 @@
+/**
+ * SnapStart Activator - Custom Resource Handler
+ *
+ * This module provides the Lambda handler for a CloudFormation Custom Resource
+ * that enables SnapStart on Lambda functions after deployment. SnapStart requires
+ * asynchronous waiting for snapshot creation, which cannot be done during CDK synthesis.
+ *
+ * The activation process:
+ * 1. Wait for function to be Active
+ * 2. Enable SnapStart configuration
+ * 3. Wait for configuration update
+ * 4. Publish new version (triggers snapshot creation)
+ * 5. Wait for snapshot to be ready (up to 3 minutes)
+ * 6. Create/update 'kata' alias pointing to the new version
+ *
+ * @module snapstart-activator
+ */
+import { LambdaClient } from '@aws-sdk/client-lambda';
+/**
+ * Custom Resource event from CloudFormation.
+ */
+export interface CustomResourceEvent {
+    RequestType: 'Create' | 'Update' | 'Delete';
+    ServiceToken: string;
+    ResponseURL: string;
+    StackId: string;
+    RequestId: string;
+    ResourceType: string;
+    LogicalResourceId: string;
+    PhysicalResourceId?: string;
+    ResourceProperties: {
+        ServiceToken: string;
+        FunctionName: string;
+        AliasName?: string;
+    };
+    OldResourceProperties?: {
+        FunctionName: string;
+        AliasName?: string;
+    };
+}
+/**
+ * Custom Resource response to CloudFormation.
+ */
+export interface CustomResourceResponse {
+    Status: 'SUCCESS' | 'FAILED';
+    Reason?: string;
+    PhysicalResourceId: string;
+    StackId: string;
+    RequestId: string;
+    LogicalResourceId: string;
+    Data?: {
+        Version?: string;
+        AliasName?: string;
+        AliasArn?: string;
+        OptimizationStatus?: string;
+    };
+}
+/**
+ * Result of SnapStart activation.
+ */
+export interface SnapStartActivationResult {
+    version: string;
+    aliasName: string;
+    aliasArn: string;
+    optimizationStatus: string;
+}
+/**
+ * Configuration for SnapStart activation.
+ */
+export interface SnapStartActivatorConfig {
+    /** Maximum time to wait for snapshot creation in seconds. Default: 180 (3 minutes) */
+    snapshotTimeoutSeconds?: number;
+    /** Polling interval in seconds. Default: 2 */
+    pollingIntervalSeconds?: number;
+    /** Alias name to create/update. Default: 'kata' */
+    aliasName?: string;
+}
+/**
+ * Activates SnapStart on a Lambda function.
+ *
+ * This function performs the full SnapStart activation cycle:
+ * 1. Ensures function is Active
+ * 2. Enables SnapStart configuration
+ * 3. Waits for configuration update
+ * 4. Publishes new version
+ * 5. Waits for snapshot creation
+ * 6. Creates/updates alias
+ *
+ * @param lambdaClient - AWS Lambda client
+ * @param functionName - Name or ARN of the Lambda function
+ * @param config - Optional configuration
+ * @returns Activation result with version and alias information
+ */
+export declare function activateSnapStart(lambdaClient: LambdaClient, functionName: string, config?: SnapStartActivatorConfig): Promise<SnapStartActivationResult>;
+/**
+ * Lambda handler for CloudFormation Custom Resource.
+ *
+ * This handler is invoked by CloudFormation when the custom resource
+ * is created, updated, or deleted.
+ */
+export declare function handler(event: CustomResourceEvent): Promise<CustomResourceResponse>;

package/out/tsc/src/snapstart-construct.d.ts

@@ -0,0 +1,87 @@
+/**
+ * SnapStart Construct - CDK Custom Resource for SnapStart Activation
+ *
+ * This module provides a CDK construct that creates a Custom Resource
+ * to enable SnapStart on Lambda functions after deployment. The construct
+ * handles the asynchronous nature of SnapStart snapshot creation.
+ *
+ * @module snapstart-construct
+ */
+import { Construct } from 'constructs';
+import { CustomResource } from 'aws-cdk-lib';
+import { IFunction } from 'aws-cdk-lib/aws-lambda';
+/**
+ * Properties for SnapStartActivator construct.
+ */
+export interface SnapStartActivatorProps {
+    /**
+     * The Lambda function to enable SnapStart on.
+     */
+    targetFunction: IFunction;
+    /**
+     * The alias name to create/update.
+     * @default 'kata'
+     */
+    aliasName?: string;
+    /**
+     * Maximum time to wait for snapshot creation in seconds.
+     * @default 180 (3 minutes)
+     */
+    snapshotTimeoutSeconds?: number;
+}
+/**
+ * CDK Construct that enables SnapStart on a Lambda function after deployment.
+ *
+ * This construct creates a Custom Resource that:
+ * 1. Waits for the target function to be Active
+ * 2. Enables SnapStart configuration
+ * 3. Publishes a new version (triggers snapshot creation)
+ * 4. Waits for the snapshot to be ready
+ * 5. Creates/updates an alias pointing to the new version
+ *
+ * @example
+ * ```typescript
+ * const myFunction = new lambda.Function(this, 'MyFunction', { ... });
+ *
+ * new SnapStartActivator(this, 'SnapStart', {
+ *   targetFunction: myFunction,
+ *   aliasName: 'kata',
+ * });
+ * ```
+ */
+export declare class SnapStartActivator extends Construct {
+    /**
+     * The alias name that was created/updated.
+     */
+    readonly aliasName: string;
+    /**
+     * The Custom Resource that manages SnapStart activation.
+     */
+    readonly resource: CustomResource;
+    /**
+     * The version number created by SnapStart activation.
+     * Available after deployment via CloudFormation outputs.
+     */
+    readonly versionRef: string;
+    /**
+     * The alias ARN created by SnapStart activation.
+     * Available after deployment via CloudFormation outputs.
+     */
+    readonly aliasArnRef: string;
+    constructor(scope: Construct, id: string, props: SnapStartActivatorProps);
+    /**
+     * Creates the Lambda function that handles Custom Resource events.
+     */
+    private createProviderFunction;
+    /**
+     * Grants necessary permissions to the provider function.
+     */
+    private grantPermissions;
+    /**
+     * Generates the inline handler code for the Custom Resource.
+     *
+     * This is a self-contained version of the snapstart-activator logic
+     * that can be deployed as inline Lambda code.
+     */
+    private generateHandlerCode;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambda-kata/cdk",
-  "version": "0.1.3-rc.67",
+  "version": "0.1.3-rc.69",
   "description": "AWS CDK integration for Lambda Kata - Node.js Lambdas running via Lambda Kata runtime",
   "main": "out/dist/index.js",
   "types": "out/tsc/src/index.d.ts",