@lambda-kata/cdk 0.1.3-rc.28 → 0.1.3-rc.4

package/out/tsc/src/aws-layer-manager.d.ts

@@ -15,8 +15,7 @@
  * @module aws-layer-manager
  */
 import { LambdaClientConfig } from '@aws-sdk/client-lambda';
-import { S3ClientConfig } from '@aws-sdk/client-s3';
-import { LayerCreationOptions, LayerInfo, LayerManager, LayerRequirements, LayerSearchOptions, Logger, MultiArchitectureDeploymentResult, NodejsLayerDeploymentOptions, NodejsLayerDeploymentResult } from './nodejs-layer-manager';
+import { LayerManager, LayerInfo, LayerSearchOptions, LayerRequirements, LayerCreationOptions, Logger } from './nodejs-layer-manager';
 /**
  * Configuration options for AWSLayerManager.
  */
@@ -26,11 +25,6 @@ export interface AWSLayerManagerOptions {
      * If not provided, uses default AWS SDK configuration.
      */
     awsSdkConfig?: LambdaClientConfig;
-    /**
-     * AWS SDK configuration for S3 client.
-     * If not provided, uses the same configuration as Lambda client.
-     */
-    s3SdkConfig?: S3ClientConfig;
     /**
      * Logger for debugging and monitoring.
      * If not provided, uses createDefaultLogger().
@@ -70,12 +64,6 @@ export interface AWSLayerManagerOptions {
      * Default: 2
      */
     circuitBreakerSuccessThreshold?: number;
-    /**
-     * Enable S3 support for large layer uploads.
-     * If true, creates S3Client for handling layers >50MB.
-     * Default: true
-     */
-    enableS3Support?: boolean;
 }
 /**
  * AWS Lambda Layer Manager implementation using AWS SDK v3.
@@ -103,10 +91,9 @@ export interface AWSLayerManagerOptions {
  *   }
  * });
  * ```
- */
+                */
 export declare class AWSLayerManager implements LayerManager {
     private readonly lambdaClient;
-    private readonly s3Client;
     private readonly logger;
     private readonly maxLayerAge;
     private readonly maxRetries;
@@ -183,103 +170,6 @@ export declare class AWSLayerManager implements LayerManager {
      * @throws NodeRuntimeLayerError if creation fails
      */
     private performLayerCreation;
-    /**
-     * Deploys a pre-built Node.js Lambda Layer from ZIP file.
-     *
-     * This method bypasses Docker binary extraction and deploys existing
-     * layer ZIP files directly to AWS Lambda. Handles large layers via S3
-     * temporary bucket upload with automatic cleanup.
-     *
-     * Process:
-     * 1. Validate input parameters and architecture
-     * 2. Search for existing layer ZIP files with fallback naming patterns
-     * 3. Read and validate layer ZIP file size
-     * 4. Deploy via direct upload (<50MB) or S3 upload (≥50MB)
-     * 5. Clean up temporary S3 resources if used
-     * 6. Return deployment result with layer ARN and metadata
-     *
-     * @param options - Deployment configuration
-     * @returns Promise resolving to deployment result
-     * @throws NodeRuntimeLayerError if deployment fails
-     */
-    deployNodejsLayer(options: NodejsLayerDeploymentOptions): Promise<NodejsLayerDeploymentResult>;
-    /**
-     * Deploys Node.js layers for all supported architectures.
-     *
-     * Attempts to deploy layers for both arm64 and x86_64 architectures,
-     * continuing on individual failures to maximize successful deployments.
-     * This matches the behavior of the Python deployment script.
-     *
-     * @param options - Base deployment configuration (architecture will be overridden)
-     * @returns Promise resolving to multi-architecture deployment results
-     */
-    deployAllArchitectures(options: Omit<NodejsLayerDeploymentOptions, 'architecture'>): Promise<MultiArchitectureDeploymentResult>;
-    /**
-     * Generates a standard layer name for the given architecture.
-     *
-     * @param architecture - Target architecture
-     * @returns Standard layer name following the pattern: nodejs-18-{architecture}
-     */
-    private generateLayerName;
-    /**
-     * Searches for layer ZIP files with fallback naming patterns.
-     *
-     * Implements the same search logic as the Python script with multiple
-     * naming conventions for maximum compatibility.
-     *
-     * @param architecture - Target architecture
-     * @param baseDirectory - Directory to search in
-     * @returns Promise resolving to ZIP file path or null if not found
-     */
-    private findLayerZipFile;
-    /**
-     * Deploys a large layer (>50MB) via S3 temporary bucket.
-     *
-     * Creates a temporary S3 bucket, uploads the layer, publishes from S3,
-     * and cleans up the bucket. Implements the same logic as the Python script.
-     *
-     * @param layerName - Name of the layer
-     * @param layerContent - ZIP file content
-     * @param architecture - Target architecture
-     * @param region - AWS region
-     * @param description - Optional layer description
-     * @param zipFilePath - Original ZIP file path for metadata
-     * @returns Promise resolving to deployment result
-     */
-    private deployLargeLayerViaS3;
-    /**
-     * Deploys a layer directly to Lambda (for layers <50MB).
-     *
-     * @param layerName - Name of the layer
-     * @param layerContent - ZIP file content
-     * @param architecture - Target architecture
-     * @param description - Optional layer description
-     * @param zipFilePath - Original ZIP file path for metadata
-     * @returns Promise resolving to deployment result
-     */
-    private deployLayerDirect;
-    /**
-     * Creates an S3 bucket for temporary layer storage.
-     *
-     * @param bucketName - Name of the bucket to create
-     * @param region - AWS region
-     */
-    private createS3Bucket;
-    /**
-     * Uploads layer content to S3.
-     *
-     * @param bucketName - S3 bucket name
-     * @param keyName - S3 object key
-     * @param layerContent - Layer ZIP content
-     */
-    private uploadLayerToS3;
-    /**
-     * Cleans up S3 resources (bucket and objects).
-     *
-     * @param bucketName - S3 bucket name
-     * @param keyName - S3 object key
-     */
-    private cleanupS3Resources;
     /**
      * Validates whether a layer meets the specified requirements.
      *
@@ -409,15 +299,11 @@ export declare class AWSLayerManager implements LayerManager {
      */
     private createTempDirectory;
     /**
-     * Extracts Node.js binary from AWS Lambda Docker image with resource tracking.
-     *
-     * Uses ONLY AWS Lambda Docker images to extract the Node.js binary from the
-     * official Lambda runtime environment. This ensures compatibility with the
-     * Lambda execution environment while extracting only the minimal binary needed.
+     * Extracts Node.js binary from AWS Lambda Docker container with resource tracking.
      *
-     * CRITICAL: Uses ONLY AWS Lambda Docker images as required by user specifications.
-     * Docker image format: public.ecr.aws/lambda/nodejs:{version}-{arch}
-     * Extracts ONLY: /var/lang/bin/node
+     * Enhanced version that tracks Docker containers for cleanup on failure.
+     * Uses Docker to run the AWS Lambda runtime image and copy the Node.js
+     * binary to the local filesystem for packaging in the layer.
      *
      * @param nodeVersion - The Node.js version (e.g., "20.10.0")
      * @param architecture - The target architecture
@@ -427,75 +313,14 @@ export declare class AWSLayerManager implements LayerManager {
      * @throws NodeRuntimeLayerError if extraction fails
      */
     private extractNodeBinaryFromDockerWithTracking;
-    /**
-     * Optimizes Node.js binary to reduce size while preserving functionality.
-     *
-     * Multi-stage optimization approach:
-     * 1. Strip debug symbols using 'strip' command (30-50% reduction)
-     * 2. UPX compression if still >50MB (50-70% additional reduction)
-     * 3. System Node.js replacement if still >60MB
-     * 4. Verify binary functionality after each stage
-     * 5. Fallback to original if within 250MB limit
-     *
-     * @param originalBinaryPath - Path to the original Node.js binary
-     * @param tempDir - Temporary directory for optimization work
-     * @returns Promise resolving to path of optimized binary
-     * @throws Error if optimization fails and original exceeds 250MB limit
-     */
-    private optimizeNodeBinary;
-    /**
-     * Attempts strip-based optimization with progressive aggressiveness.
-     *
-     * @param originalBinaryPath - Path to original binary
-     * @param tempDir - Working directory
-     * @returns Path to stripped binary or original if stripping fails
-     */
-    private tryStripOptimization;
-    /**
-     * Attempts UPX compression optimization.
-     *
-     * @param binaryPath - Path to binary to compress
-     * @param tempDir - Working directory
-     * @returns Path to compressed binary or null if UPX unavailable/fails
-     */
-    private tryUPXOptimization;
-    /**
-     * Attempts to use system Node.js binary as replacement.
-     *
-     * @param tempDir - Working directory
-     * @returns Path to system Node.js copy or null if unavailable/unsuitable
-     */
-    private trySystemNodeReplacement;
-    /**
-     * Verifies that a Node.js binary is functional after optimization.
-     *
-     * Runs basic Node.js commands to ensure the binary works correctly.
-     * This prevents shipping broken binaries after optimization.
-     *
-     * @param binaryPath - Path to the Node.js binary to verify
-     * @throws Error if verification fails
-     */
-    private verifyNodeBinary;
-    /**
-     * Verifies Node.js binary with graceful fallback for spawn errors.
-     *
-     * This method attempts full verification but falls back to basic checks
-     * if spawn fails (e.g., error -8). This prevents blocking deployment for
-     * binaries that are valid but fail verification due to system issues.
-     *
-     * @param binaryPath - Path to the Node.js binary to verify
-     * @returns Promise resolving to verification result with success flag and optional error
-     */
-    private verifyNodeBinaryWithFallback;
     /**
      * Creates the proper Lambda Layer directory structure.
      *
-     * Lambda Layers for Node.js binary should use minimal structure:
-     * - bin/node (uncompressed binary)
-     * - bin/node.gz (compressed binary with decompression script)
+     * Lambda Layers must follow a specific directory structure:
+     * - /opt/nodejs/bin/ for Node.js binaries
      *
      * @param tempDir - Base temporary directory
-     * @param nodeBinaryPath - Path to the Node.js binary (may be compressed)
+     * @param nodeBinaryPath - Path to the Node.js binary
      * @returns Promise resolving to the layer directory path
      * @throws Error if directory creation fails
      */
@@ -521,10 +346,7 @@ export declare class AWSLayerManager implements LayerManager {
      */
     private calculateDirectorySize;
     /**
-     * Fallback ZIP creation using system zip command with streaming.
-     *
-     * This method uses the system 'zip' command which handles large files
-     * efficiently without loading them into memory.
+     * Fallback ZIP creation using system zip command.
      *
      * @param layerDir - Directory containing the layer contents
      * @param zipFilePath - Target ZIP file path
@@ -597,9 +419,6 @@ export declare class AWSLayerManager implements LayerManager {
     /**
      * Executes a system command with timeout and error handling.
      *
-     * Enhanced with EPIPE error handling to prevent broken pipe errors
-     * when child process terminates unexpectedly.
-     *
      * @param command - Command to execute
      * @param args - Command arguments
      * @param options - Execution options including working directory

package/out/tsc/src/docker-runtime-detector.d.ts

@@ -1,4 +1,4 @@
-import { Logger, NodeVersionInfo, RuntimeDetector } from './nodejs-layer-manager';
+import { RuntimeDetector, NodeVersionInfo, Logger } from './nodejs-layer-manager';
 /**
  * Configuration options for DockerRuntimeDetector.
  */

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

@@ -23,7 +23,7 @@ export { MockLicensingService, createMockLicensingService, } from './mock-licens
 export { resolveAccountId, resolveAccountIdWithSource, isValidAccountIdFormat, AccountResolutionError, AccountResolutionResult, AccountResolverOptions, } from './account-resolver';
 export { kata, kataWithAccountId, applyTransformation, handleUnlicensed, isKataTransformed, getKataPromise, KataWrapperOptions, KataResult, } from './kata-wrapper';
 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 { EnsureNodeRuntimeLayerOptions, EnsureNodeRuntimeLayerResult, NodeVersionInfo, LayerInfo, LayerSearchOptions, LayerRequirements, LayerCreationOptions, Logger, RuntimeDetector, LayerManager, ErrorCodes, NodeRuntimeLayerError, VersionCacheEntry, LayerMetadata, } from './nodejs-layer-manager';
 export { DockerRuntimeDetector, DockerRuntimeDetectorOptions, } from './docker-runtime-detector';
 export { AWSLayerManager, AWSLayerManagerOptions, } from './aws-layer-manager';
 export { NoOpLogger, ConsoleLogger, createDefaultLogger, OperationTimer, } from './logger';

package/out/tsc/src/kata-wrapper.d.ts

@@ -110,13 +110,12 @@ export declare function kata<T extends NodejsFunction | LambdaFunction>(lambda:
  *
  * @param lambda - The Node.js Lambda function to transform
  * @param accountId - The AWS account ID to use for licensing check
- * @param region - The AWS region for deployment (from Stack.of(lambda).region)
  * @param props - Optional configuration for the transformation
  * @returns Promise resolving to the transformation result
  *
  * @internal
  */
-export declare function kataWithAccountId<T extends NodejsFunction | LambdaFunction>(lambda: T, accountId: string, region: string, props?: KataWrapperOptions): Promise<KataResult>;
+export declare function kataWithAccountId<T extends NodejsFunction | LambdaFunction>(lambda: T, accountId: string, props?: KataWrapperOptions): Promise<KataResult>;
 /**
  * Gets the original runtime from a Lambda function before transformation.
  *

package/out/tsc/src/nodejs-layer-manager.d.ts

@@ -275,27 +275,6 @@ export interface LayerManager {
      * @throws NodeRuntimeLayerError if creation fails
      */
     createNodeLayer(options: LayerCreationOptions): Promise<LayerInfo>;
-    /**
-     * Deploys a pre-built Node.js Lambda Layer from ZIP file.
-     *
-     * This method bypasses Docker binary extraction and deploys existing
-     * layer ZIP files directly to AWS Lambda. Handles large layers via S3.
-     *
-     * @param options - Deployment configuration
-     * @returns Promise resolving to deployment result
-     * @throws NodeRuntimeLayerError if deployment fails
-     */
-    deployNodejsLayer(options: NodejsLayerDeploymentOptions): Promise<NodejsLayerDeploymentResult>;
-    /**
-     * Deploys Node.js layers for all supported architectures.
-     *
-     * Attempts to deploy layers for both arm64 and x86_64 architectures,
-     * continuing on individual failures to maximize successful deployments.
-     *
-     * @param options - Base deployment configuration (architecture will be overridden)
-     * @returns Promise resolving to multi-architecture deployment results
-     */
-    deployAllArchitectures(options: Omit<NodejsLayerDeploymentOptions, 'architecture'>): Promise<MultiArchitectureDeploymentResult>;
     /**
      * Validates whether a layer meets the specified requirements.
      *
@@ -438,110 +417,3 @@ export interface LayerMetadata {
      */
     licenseInfo?: string;
 }
-/**
- * Configuration options for deploying pre-built Node.js Lambda Layers.
- *
- * Used to deploy existing layer ZIP files instead of creating layers from Docker images.
- * This bypasses the binary extraction process that can fail with large Node.js binaries.
- */
-export interface NodejsLayerDeploymentOptions {
-    /**
-     * The AWS region where the layer should be deployed.
-     */
-    region: string;
-    /**
-     * Optional AWS profile name for authentication.
-     * If not provided, uses default AWS credentials.
-     */
-    profile?: string;
-    /**
-     * The target architecture for deployment.
-     * If not specified, defaults to 'arm64'.
-     */
-    architecture?: 'arm64' | 'x86_64';
-    /**
-     * Base directory to search for layer ZIP files.
-     * Defaults to current working directory.
-     */
-    baseDirectory?: string;
-    /**
-     * Custom layer name override.
-     * If not provided, uses standard naming: nodejs-18-{architecture}
-     */
-    layerName?: string;
-    /**
-     * Custom layer description.
-     * If not provided, generates standard description.
-     */
-    description?: string;
-}
-/**
- * Result of Node.js layer deployment operation.
- *
- * Contains information about the deployed layer and deployment metadata.
- */
-export interface NodejsLayerDeploymentResult {
-    /**
-     * The full ARN of the deployed layer version.
-     */
-    layerVersionArn: string;
-    /**
-     * The base ARN of the layer (without version).
-     */
-    layerArn: string;
-    /**
-     * The name of the deployed layer.
-     */
-    layerName: string;
-    /**
-     * The version number of the deployed layer.
-     */
-    version: number;
-    /**
-     * The architecture of the deployed layer.
-     */
-    architecture: 'arm64' | 'x86_64';
-    /**
-     * The size of the deployed layer ZIP file in bytes.
-     */
-    layerSize: number;
-    /**
-     * The path to the ZIP file that was deployed.
-     */
-    zipFilePath: string;
-    /**
-     * Whether the layer was uploaded via S3 (true) or direct upload (false).
-     */
-    uploadedViaS3: boolean;
-}
-/**
- * Result of deploying layers for all architectures.
- *
- * Contains deployment results for each architecture attempted.
- */
-export interface MultiArchitectureDeploymentResult {
-    /**
-     * Deployment results by architecture.
-     * Key is architecture name, value is result or null if deployment failed.
-     */
-    results: Record<'arm64' | 'x86_64', NodejsLayerDeploymentResult | null>;
-    /**
-     * Overall success status.
-     * True if at least one architecture deployed successfully.
-     */
-    success: boolean;
-    /**
-     * Summary of successful deployments.
-     */
-    successful: Array<{
-        architecture: 'arm64' | 'x86_64';
-        layerVersionArn: string;
-    }>;
-    /**
-     * Summary of failed deployments.
-     */
-    failed: Array<{
-        architecture: 'arm64' | 'x86_64';
-        error: string;
-    }>;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lambda-kata/cdk",
-  "version": "0.1.3-rc.28",
+  "version": "0.1.3-rc.4",
   "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",
@@ -18,7 +18,7 @@
     "docs": "yarn run docs:md && yarn run docs:html",
     "docs:md": "typedoc --options ./docs/docs.config/typedoc.md.json",
     "docs:html": "typedoc --options ./docs/docs.config/typedoc.html.json",
-    "npm:publish": "yarn run build && npm publish --access public"
+    "npm:publish": "npm publish --access public"
   },
   "files": [
     "out/dist/**/*",
@@ -54,7 +54,6 @@
   },
   "dependencies": {
     "@aws-sdk/client-lambda": "^3.500.0",
-    "@aws-sdk/client-s3": "^3.500.0",
     "@aws-sdk/client-sts": "^3.500.0",
     "dotenv": "^17.2.3",
     "reflect-metadata": "^0.2.2"
@@ -75,4 +74,4 @@
     "tsc-alias": "^1.8.16",
     "typescript": "^5.3.3"
   }
-}
+}