@lambda-kata/cdk 0.1.3-rc.15 → 0.1.3-rc.17

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

@@ -15,7 +15,8 @@
  * @module aws-layer-manager
  */
 import { LambdaClientConfig } from '@aws-sdk/client-lambda';
-import { LayerCreationOptions, LayerInfo, LayerManager, LayerRequirements, LayerSearchOptions, Logger } from './nodejs-layer-manager';
+import { S3ClientConfig } from '@aws-sdk/client-s3';
+import { LayerCreationOptions, LayerInfo, LayerManager, LayerRequirements, LayerSearchOptions, Logger, NodejsLayerDeploymentOptions, NodejsLayerDeploymentResult, MultiArchitectureDeploymentResult } from './nodejs-layer-manager';
 /**
  * Configuration options for AWSLayerManager.
  */
@@ -25,6 +26,11 @@ 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().
@@ -64,6 +70,12 @@ 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.
@@ -94,6 +106,7 @@ export interface AWSLayerManagerOptions {
  */
 export declare class AWSLayerManager implements LayerManager {
     private readonly lambdaClient;
+    private readonly s3Client;
     private readonly logger;
     private readonly maxLayerAge;
     private readonly maxRetries;
@@ -170,6 +183,103 @@ 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.
      *
@@ -320,17 +430,42 @@ export declare class AWSLayerManager implements LayerManager {
     /**
      * Optimizes Node.js binary to reduce size while preserving functionality.
      *
-     * Applies size optimization techniques:
-     * 1. Strip debug symbols using 'strip' command (reduces size by 30-50%)
-     * 2. Verify binary functionality after optimization
-     * 3. Fallback to original binary if optimization fails
+     * 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 80MB 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 fallback is not viable
+     * @throws Error if optimization fails and original exceeds 80MB 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.
      *

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, } from './nodejs-layer-manager';
+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';
 export { AWSLayerManager, AWSLayerManagerOptions, } from './aws-layer-manager';
 export { NoOpLogger, ConsoleLogger, createDefaultLogger, OperationTimer, } from './logger';

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

@@ -275,6 +275,27 @@ 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.
      *
@@ -417,3 +438,110 @@ 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.15",
+  "version": "0.1.3-rc.17",
   "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": "npm publish --access public"
+    "npm:publish": "yarn run build && npm publish --access public"
   },
   "files": [
     "out/dist/**/*",
@@ -54,6 +54,7 @@
   },
   "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"