@lambda-kata/cdk 0.1.3-rc.81 → 0.1.3-rc.85

package/out/dist/python/kata_bootstrap.py

@@ -0,0 +1,82 @@
+"""
+Lambda Kata Bootstrap Handler
+
+Resilient entry point that delegates to lambdakata.optimized_handler
+from the Lambda Kata Layer. Ensures SnapStart snapshot creation succeeds
+by catching init errors gracefully.
+
+Copyright (C) 2025-present Raman Marozau, Work Target Insight Function.
+SPDX-License-Identifier: Apache-2.0
+"""
+
+import json
+import os
+import sys
+import traceback
+
+
+# ---------------------------------------------------------------------------
+# INIT PHASE — executed once during cold start / SnapStart snapshot creation
+# ---------------------------------------------------------------------------
+
+_real_handler = None
+_init_error = None
+_init_diagnostics = {}
+
+try:
+    _init_diagnostics = {
+        "python_version": sys.version,
+        "opt_contents": sorted(os.listdir("/opt")) if os.path.isdir("/opt") else [],
+        "opt_python_exists": os.path.isdir("/opt/python"),
+        "lambdakata_in_opt": (
+            os.path.isdir("/opt/lambdakata")
+            or os.path.isdir("/opt/python/lambdakata")
+        ),
+    }
+
+    from lambdakata.optimized_handler import lambda_handler as _real_handler  # type: ignore[import-untyped]
+
+except ImportError as exc:
+    _init_error = exc
+    _init_diagnostics["import_error"] = str(exc)
+    _init_diagnostics["traceback"] = traceback.format_exc()
+    print(
+        f"[Lambda Kata] WARNING: Failed to import lambdakata.optimized_handler: {exc}",
+        file=sys.stderr,
+    )
+
+except Exception as exc:  # noqa: BLE001 — intentional broad catch for resilience
+    _init_error = exc
+    _init_diagnostics["init_error"] = str(exc)
+    _init_diagnostics["error_type"] = type(exc).__name__
+    _init_diagnostics["traceback"] = traceback.format_exc()
+    print(
+        f"[Lambda Kata] WARNING: Init error: {type(exc).__name__}: {exc}",
+        file=sys.stderr,
+    )
+
+
+# ---------------------------------------------------------------------------
+# HANDLER
+# ---------------------------------------------------------------------------
+
+def handler(event, context):
+    """Delegate to the real Lambda Kata handler, or return diagnostics."""
+    if _real_handler is not None:
+        return _real_handler(event, context)
+
+    body = {
+        "error": "Lambda Kata runtime initialization failed",
+        "message": str(_init_error) if _init_error else "Unknown",
+        "error_type": type(_init_error).__name__ if _init_error else "Unknown",
+        "diagnostics": {
+            "lambdakata_in_opt": _init_diagnostics.get("lambdakata_in_opt", False),
+            "opt_python_exists": _init_diagnostics.get("opt_python_exists", False),
+            "opt_contents": _init_diagnostics.get("opt_contents", []),
+        },
+    }
+    print(
+        f"[Lambda Kata] Runtime not initialized: {json.dumps(body)}",
+        file=sys.stderr,
+    )
+    return {"statusCode": 503, "body": json.dumps(body)}

package/out/tsc/src/config-layer.d.ts

@@ -119,6 +119,37 @@ export declare const HANDLER_CONFIG_KEY = "original_js_handler";
  * The name of the compiled middleware file within the .kata directory.
  */
 export declare const MIDDLEWARE_FILE_NAME = "middleware.js";
+/**
+ * Bootstrap handler module name.
+ * The compiled .pyc is at src/python/dist/kata_bootstrap.pyc and is placed
+ * in the config layer at /opt/python/kata_bootstrap.pyc so the Python 3.12
+ * runtime resolves it via PYTHONPATH.
+ *
+ * Using a pre-compiled bootstrap handler prevents SnapStart snapshot failures
+ * caused by import errors in the Lambda Kata Layer (C-bridge, Node.js binary, etc.).
+ * Source: src/python/kata_bootstrap.py — compiled via `yarn build:python`.
+ */
+export declare const BOOTSTRAP_HANDLER_MODULE = "kata_bootstrap";
+/**
+ * Full handler path for the bootstrap handler.
+ * Format: "<module>.<function>" as required by Lambda handler configuration.
+ */
+export declare const BOOTSTRAP_HANDLER_PATH = "kata_bootstrap.handler";
+/**
+ * Resolves the absolute path to the bootstrap handler .py source file.
+ *
+ * Two resolution paths:
+ * 1. Production (bundled JS / npm package): out/dist/python/kata_bootstrap.py
+ *    __dirname = out/dist/ → __dirname/python/kata_bootstrap.py
+ * 2. Development (ts-jest / source): src/python/kata_bootstrap.py
+ *    __dirname = src/ → __dirname/python/kata_bootstrap.py
+ *
+ * @returns Absolute path to kata_bootstrap.py
+ * @throws Error if the source file is not found
+ *
+ * @internal
+ */
+export declare function resolveBootstrapPyPath(): string;
 /**
  * Creates a Lambda Layer containing the kata configuration.
  *

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

@@ -25,7 +25,7 @@ export { resolveAccountIdSync, resolveAccountIdSyncWithSource, resolveRegionSync
 export { kata, kataWithAccountId, applyTransformation, handleUnlicensed, isKataTransformed, getKataPromise, extractBundlePathFromHandler, KataWrapperOptions, KataResult, } from './kata-wrapper';
 export { SnapStartActivator, SnapStartActivatorProps, } from './snapstart-construct';
 export { activateSnapStart, handler as snapStartHandler, SnapStartActivationResult, SnapStartActivatorConfig, CustomResourceEvent, CustomResourceResponse, } from './snapstart-activator';
-export { createKataConfigLayer, generateConfigContent, KataConfigLayerProps, CONFIG_DIR_NAME, CONFIG_FILE_NAME, HANDLER_CONFIG_KEY, } from './config-layer';
+export { createKataConfigLayer, generateConfigContent, resolveBootstrapPyPath, KataConfigLayerProps, CONFIG_DIR_NAME, CONFIG_FILE_NAME, HANDLER_CONFIG_KEY, BOOTSTRAP_HANDLER_MODULE, BOOTSTRAP_HANDLER_PATH, } 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';
 export { AWSLayerManager, AWSLayerManagerOptions, } from './aws-layer-manager';

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@lambda-kata/cdk",
-  "version": "0.1.3-rc.81",
+  "version": "0.1.3-rc.85",
   "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",
   "scripts": {
-    "build": "rm -rf ./dist && rm -rf ./out && rm -rf ./lib && yarn run build:cdk && yarn run types",
+    "build:python": "python3 src/python/compile.py && mkdir -p out/dist/python && cp src/python/kata_bootstrap.py out/dist/python/kata_bootstrap.py",
+    "build": "rm -rf ./dist && rm -rf ./out && rm -rf ./lib && yarn run build:cdk && yarn run types && yarn run build:python",
     "types": "tsc --emitDeclarationOnly && tsc-alias",
     "build:cdk": "yarn run build:config && node dist/utils/build.js --target=cdk",
     "build:minify": "yarn run build:config && node dist/utils/build.js",