cdk-local-lambda 0.0.2

package/lib/cli/docker/watcher.js

@@ -0,0 +1,115 @@
+/**
+ * Docker context file watching for automatic container rebuilds.
+ *
+ * Watches Docker context directories and emits events when files change,
+ * triggering container rebuilds for Docker-based Lambda functions.
+ */
+import * as path from "node:path";
+import chokidar from "chokidar";
+import { Effect, Stream } from "effect";
+/**
+ * Default patterns to ignore when watching Docker contexts.
+ * These are common directories/files that shouldn't trigger rebuilds.
+ */
+const DEFAULT_IGNORED_PATTERNS = [
+    /(^|[/\\])\.git([/\\]|$)/, // .git directory
+    /(^|[/\\])node_modules([/\\]|$)/, // node_modules
+    /(^|[/\\])\.[^/\\]+$/, // dotfiles (but not directories like .docker)
+    /\.pyc$/, // Python bytecode
+    /__pycache__/, // Python cache
+    /\.class$/, // Java bytecode
+    /\.o$/, // Object files
+    /\.log$/, // Log files
+];
+/**
+ * Watch multiple Docker context directories for file changes.
+ *
+ * Creates a single chokidar watcher that monitors all registered Docker
+ * contexts and emits events when files change. The events are debounced
+ * to prevent rapid successive rebuilds during batch operations.
+ *
+ * @param functions - Array of Docker functions to watch
+ * @param debounceMs - Debounce delay in milliseconds (default: 500)
+ * @returns Stream of change events with function ownership resolved
+ */
+export const watchDockerContexts = (functions, debounceMs = 500) => {
+    if (functions.length === 0) {
+        return Stream.empty;
+    }
+    // Build a map of normalized context paths to function IDs for quick lookup
+    const contextToFunction = new Map();
+    const pathsToWatch = [];
+    for (const fn of functions) {
+        const normalizedPath = path.normalize(fn.dockerContextPath);
+        contextToFunction.set(normalizedPath, fn.functionId);
+        pathsToWatch.push(fn.dockerContextPath);
+    }
+    return Stream.asyncScoped((emit) => Effect.gen(function* () {
+        const watcher = chokidar.watch(pathsToWatch, {
+            ignored: DEFAULT_IGNORED_PATTERNS,
+            persistent: true,
+            ignoreInitial: true,
+            // Use polling on some systems for better reliability
+            usePolling: process.platform === "linux",
+            interval: 300,
+        });
+        /**
+         * Find which function owns a given file path.
+         */
+        const findOwningFunction = (filePath) => {
+            const normalizedFilePath = path.normalize(filePath);
+            for (const [contextPath, functionId] of contextToFunction) {
+                if (normalizedFilePath.startsWith(contextPath + path.sep)) {
+                    return functionId;
+                }
+                // Also match if the file IS the context directory (shouldn't happen but handle it)
+                if (normalizedFilePath === contextPath) {
+                    return functionId;
+                }
+            }
+            return undefined;
+        };
+        /**
+         * Handle a file change event.
+         */
+        const handleChange = (type, filePath) => {
+            const functionId = findOwningFunction(filePath);
+            if (functionId) {
+                emit.single({
+                    functionId,
+                    filePath,
+                    type,
+                });
+            }
+        };
+        watcher.on("add", (filePath) => handleChange("add", filePath));
+        watcher.on("change", (filePath) => handleChange("change", filePath));
+        watcher.on("unlink", (filePath) => handleChange("unlink", filePath));
+        watcher.on("error", (err) => {
+            const error = err;
+            Effect.runSync(Effect.logWarning(`DockerWatcher error: ${error.message}`));
+            // Don't fail the stream on transient errors, just log
+        });
+        watcher.on("ready", () => {
+            Effect.runSync(Effect.logDebug(`Watching ${functions.length} Docker context(s) for changes`));
+            for (const fn of functions) {
+                Effect.runSync(Effect.logDebug(`  - ${fn.functionId}: ${fn.dockerContextPath}`));
+            }
+        });
+        // Cleanup when scope closes
+        yield* Effect.addFinalizer(() => Effect.gen(function* () {
+            yield* Effect.promise(async () => {
+                await watcher.close();
+            });
+            yield* Effect.logDebug("DockerWatcher file watcher closed");
+        }));
+    })).pipe(
+    // Debounce to handle batch file changes (e.g., git checkout, IDE save-all)
+    Stream.debounce(`${debounceMs} millis`));
+};
+/**
+ * Create a watcher for a single Docker function.
+ * Convenience wrapper around watchDockerContexts for single-function use.
+ */
+export const watchSingleDockerContext = (functionId, dockerContextPath, debounceMs = 500) => watchDockerContexts([{ functionId, dockerContextPath }], debounceMs);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2F0Y2hlci5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9jbGkvZG9ja2VyL3dhdGNoZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFFSCxPQUFPLEtBQUssSUFBSSxNQUFNLFdBQVcsQ0FBQTtBQUNqQyxPQUFPLFFBQVEsTUFBTSxVQUFVLENBQUE7QUFDL0IsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsTUFBTSxRQUFRLENBQUE7QUF3QnZDOzs7R0FHRztBQUNILE1BQU0sd0JBQXdCLEdBQUc7SUFDL0IseUJBQXlCLEVBQUUsaUJBQWlCO0lBQzVDLGdDQUFnQyxFQUFFLGVBQWU7SUFDakQscUJBQXFCLEVBQUUsOENBQThDO0lBQ3JFLFFBQVEsRUFBRSxrQkFBa0I7SUFDNUIsYUFBYSxFQUFFLGVBQWU7SUFDOUIsVUFBVSxFQUFFLGdCQUFnQjtJQUM1QixNQUFNLEVBQUUsZUFBZTtJQUN2QixRQUFRLEVBQUUsWUFBWTtDQUN2QixDQUFBO0FBRUQ7Ozs7Ozs7Ozs7R0FVRztBQUNILE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUFHLENBQ2pDLFNBQWtDLEVBQ2xDLFVBQVUsR0FBRyxHQUFHLEVBQ2dDLEVBQUU7SUFDbEQsSUFBSSxTQUFTLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRSxDQUFDO1FBQzNCLE9BQU8sTUFBTSxDQUFDLEtBQUssQ0FBQTtJQUNyQixDQUFDO0lBRUQsMkVBQTJFO0lBQzNFLE1BQU0saUJBQWlCLEdBQUcsSUFBSSxHQUFHLEVBQWtCLENBQUE7SUFDbkQsTUFBTSxZQUFZLEdBQWEsRUFBRSxDQUFBO0lBRWpDLEtBQUssTUFBTSxFQUFFLElBQUksU0FBUyxFQUFFLENBQUM7UUFDM0IsTUFBTSxjQUFjLEdBQUcsSUFBSSxDQUFDLFNBQVMsQ0FBQyxFQUFFLENBQUMsaUJBQWlCLENBQUMsQ0FBQTtRQUMzRCxpQkFBaUIsQ0FBQyxHQUFHLENBQUMsY0FBYyxFQUFFLEVB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QyxpQkFBaUIsRUFBRSxDQUFDLENBQ2pFLENBQUE7WUFDSCxDQUFDO1FBQ0gsQ0FBQyxDQUFDLENBQUE7UUFFRiw0QkFBNEI7UUFDNUIsS0FBSyxDQUFDLENBQUMsTUFBTSxDQUFDLFlBQVksQ0FBQyxHQUFHLEVBQUUsQ0FDOUIsTUFBTSxDQUFDLEdBQUcsQ0FBQyxRQUFRLENBQUM7WUFDbEIsS0FBSyxDQUFDLENBQUMsTUFBTSxDQUFDLE9BQU8sQ0FBQyxLQUFLLElBQUksRUFBRTtnQkFDL0IsTUFBTSxPQUFPLENBQUMsS0FBSyxFQUFFLENBQUE7WUFDdkIsQ0FBQyxDQUFDLENBQUE7WUFDRixLQUFLLENBQUMsQ0FBQyxNQUFNLENBQUMsUUFBUSxDQUFDLG1DQUFtQyxDQUFDLENBQUE7UUFDN0QsQ0FBQyxDQUFDLENBQ0gsQ0FBQTtJQUNILENBQUMsQ0FBQyxDQUNILENBQUMsSUFBSTtJQUNKLDJFQUEyRTtJQUMzRSxNQUFNLENBQUMsUUFBUSxDQUFDLEdBQUcsVUFBVSxTQUFTLENBQUMsQ0FDeEMsQ0FBQTtBQUNILENBQUMsQ0FBQTtBQUVEOzs7R0FHRztBQUNILE1BQU0sQ0FBQyxNQUFNLHdCQUF3QixHQUFHLENBQ3RDLFVBQWtCLEVBQ2xCLGlCQUF5QixFQUN6QixVQUFVLEdBQUcsR0FBRyxFQUNnQyxFQUFFLENBQ2xELG1CQUFtQixDQUFDLENBQUMsRUFBRSxVQUFVLEVBQUUsaUJBQWlCLEVBQUUsQ0FBQyxFQUFFLFVBQVUsQ0FBQyxDQUFBIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBEb2NrZXIgY29udGV4dCBmaWxlIHdhdGNoaW5nIGZvciBhdXRvbWF0aWMgY29udGFpbmVyIHJlYnVpbGRzLlxuICpcbiAqIFdhdGNoZXMgRG9ja2VyIGNvbnRleHQgZGlyZWN0b3JpZXMgYW5kIGVtaXRzIGV2ZW50cyB3aGVuIGZpbGVzIGNoYW5nZSxcbiAqIHRyaWdnZXJpbmcgY29udGFpbmVyIHJlYnVpbGRzIGZvciBEb2NrZXItYmFzZWQgTGFtYmRhIGZ1bmN0aW9ucy5cbiAqL1xuXG5pbXBvcnQgKiBhcyBwYXRoIGZyb20gXCJub2RlOnBhdGhcIlxuaW1wb3J0IGNob2tpZGFyIGZyb20gXCJjaG9raWRhclwiXG5pbXBvcnQgeyBFZmZlY3QsIFN0cmVhbSB9IGZyb20gXCJlZmZlY3RcIlxuXG4vKipcbiAqIEV2ZW50IGVtaXR0ZWQgd2hlbiBhIGZpbGUgY2hhbmdlcyBpbiBhIERvY2tlciBjb250ZXh0LlxuICovXG5leHBvcnQgaW50ZXJmYWNlIERvY2tlckNvbnRleHRDaGFuZ2VFdmVudCB7XG4gIC8qKiBUaGUgZnVuY3Rpb24gSUQgdGhhdCBvd25zIHRoaXMgRG9ja2VyIGNvbnRleHQgKi9cbiAgZnVuY3Rpb25JZDogc3RyaW5nXG4gIC8qKiBUaGUgYWJzb2x1dGUgcGF0aCB0byB0aGUgZmlsZSB0aGF0IGNoYW5nZWQgKi9cbiAgZmlsZVBhdGg6IHN0cmluZ1xuICAvKiogVHlwZSBvZiBjaGFuZ2UgKi9cbiAgdHlwZTogXCJhZGRcIiB8IFwiY2hhbmdlXCIgfCBcInVubGlua1wiXG59XG5cbi8qKlxuICogQ29uZmlndXJhdGlvbiBmb3IgYSBEb2NrZXIgZnVuY3Rpb24gdG8gd2F0Y2guXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgV2F0Y2hlZERvY2tlckZ1bmN0aW9uIHtcbiAgLyoqIFVuaXF1ZSBmdW5jdGlvbiBpZGVudGlmaWVyIChMYW1iZGEgZnVuY3Rpb24gbmFtZSkgKi9cbiAgZnVuY3Rpb25JZDogc3RyaW5nXG4gIC8qKiBBYnNvbHV0ZSBwYXRoIHRvIHRoZSBEb2NrZXIgY29udGV4dCBkaXJlY3RvcnkgKi9cbiAgZG9ja2VyQ29udGV4dFBhdGg6IHN0cmluZ1xufVxuXG4vKipcbiAqIERlZmF1bHQgcGF0dGVybnMgdG8gaWdub3JlIHdoZW4gd2F0Y2hpbmcgRG9ja2VyIGNvbnRleHRzLlxuICogVGhlc2UgYXJlIGNvbW1vbiBkaXJlY3Rvcmllcy9maWxlcyB0aGF0IHNob3VsZG4ndCB0cmlnZ2VyIHJlYnVpbGRzLlxuICovXG5jb25zdCBERUZBVUxUX0lHTk9SRURfUEFUVEVSTlMgPSBbXG4gIC8oXnxbL1xcXFxdKVxcLmdpdChbL1xcXFxdfCQpLywgLy8gLmdpdCBkaXJlY3RvcnlcbiAgLyhefFsvXFxcXF0pbm9kZV9tb2R1bGVzKFsvXFxcXF18JCkvLCAvLyBub2RlX21vZHVsZXNcbiAgLyhefFsvXFxcXF0pXFwuW14vXFxcXF0rJC8sIC8vIGRvdGZpbGVzIChidXQgbm90IGRpcmVjdG9yaWVzIGxpa2UgLmRvY2tlcilcbiAgL1xcLnB5YyQvLCAvLyBQeXRob24gYnl0ZWNvZGVcbiAgL19fcHljYWNoZV9fLywgLy8gUHl0aG9uIGNhY2hlXG4gIC9cXC5jbGFzcyQvLCAvLyBKYXZhIGJ5dGVjb2RlXG4gIC9cXC5vJC8sIC8vIE9iamVjdCBmaWxlc1xuICAvXFwubG9nJC8sIC8vIExvZyBmaWxlc1xuXVxuXG4vKipcbiAqIFdhdGNoIG11bHRpcGxlIERvY2tlciBjb250ZXh0IGRpcmVjdG9yaWVzIGZvciBmaWxlIGNoYW5nZXMuXG4gKlxuICogQ3JlYXRlcyBhIHNpbmdsZSBjaG9raWRhciB3YXRjaGVyIHRoYXQgbW9uaXRvcnMgYWxsIHJlZ2lzdGVyZWQgRG9ja2VyXG4gKiBjb250ZXh0cyBhbmQgZW1pdHMgZXZlbnRzIHdoZW4gZmlsZXMgY2hhbmdlLiBUaGUgZXZlbnRzIGFyZSBkZWJvdW5jZWRcbiAqIHRvIHByZXZlbnQgcmFwaWQgc3VjY2Vzc2l2ZSByZWJ1aWxkcyBkdXJpbmcgYmF0Y2ggb3BlcmF0aW9ucy5cbiAqXG4gKiBAcGFyYW0gZnVuY3Rpb25zIC0gQXJyYXkgb2YgRG9ja2VyIGZ1bmN0aW9ucyB0byB3YXRjaFxuICogQHBhcmFtIGRlYm91bmNlTXMgLSBEZWJvdW5jZSBkZWxheSBpbiBtaWxsaXNlY29uZHMgKGRlZmF1bHQ6IDUwMClcbiAqIEByZXR1cm5zIFN0cmVhbSBvZiBjaGFuZ2UgZXZlbnRzIHdpdGggZnVuY3Rpb24gb3duZXJzaGlwIHJlc29sdmVkXG4gKi9cbmV4cG9ydCBjb25zdCB3YXRjaERvY2tlckNvbnRleHRzID0gKFxuICBmdW5jdGlvbnM6IFdhdGNoZWREb2NrZXJGdW5jdGlvbltdLFxuICBkZWJvdW5jZU1zID0gNTAwLFxuKTogU3RyZWFtLlN0cmVhbTxEb2NrZXJDb250ZXh0Q2hhbmdlRXZlbnQsIEVycm9yPiA9PiB7XG4gIGlmIChmdW5jdGlvbnMubGVuZ3RoID09PSAwKSB7XG4gICAgcmV0dXJuIFN0cmVhbS5lbXB0eVxuICB9XG5cbiAgLy8gQnVpbGQgYSBtYXAgb2Ygbm9ybWFsaXplZCBjb250ZXh0IHBhdGhzIHRvIGZ1bmN0aW9uIElEcyBmb3IgcXVpY2sgbG9va3VwXG4gIGNvbnN0IGNvbnRleHRUb0Z1bmN0aW9uID0gbmV3IE1hcDxzdHJpbmcsIHN0cmluZz4oKVxuICBjb25zdCBwYXRoc1RvV2F0Y2g6IHN0cmluZ1tdID0gW11cblxuICBmb3IgKGNvbnN0IGZuIG9mIGZ1bmN0aW9ucykge1xuICAgIGNvbnN0IG5vcm1hbGl6ZWRQYXRoID0gcGF0aC5ub3JtYWxpemUoZm4uZG9ja2VyQ29udGV4dFBhdGgpXG4gICAgY29udGV4dFRvRnVuY3Rpb24uc2V0KG5vcm1hbGl6ZWRQYXRoLCBmbi5mdW5jdGlvbklkKVxuICAgIHBhdGhzVG9XYXRjaC5wdXNoKGZuLmRvY2tlckNvbnRleHRQYXRoKVxuICB9XG5cbiAgcmV0dXJuIFN0cmVhbS5hc3luY1Njb3BlZDxEb2NrZXJDb250ZXh0Q2hhbmdlRXZlbnQsIEVycm9yPigoZW1pdCkgPT5cbiAgICBFZmZlY3QuZ2VuKGZ1bmN0aW9uKiAoKSB7XG4gICAgICBjb25zdCB3YXRjaGVyID0gY2hva2lkYXIud2F0Y2gocGF0aHNUb1dhdGNoLCB7XG4gICAgICAgIGlnbm9yZWQ6IERFRkFVTFRfSUdOT1JFRF9QQVRURVJOUyxcbiAgICAgICAgcGVyc2lzdGVudDogdHJ1ZSxcbiAgICAgICAgaWdub3JlSW5pdGlhbDogdHJ1ZSxcbiAgICAgICAgLy8gVXNlIHBvbGxpbmcgb24gc29tZSBzeXN0ZW1zIGZvciBiZXR0ZXIgcmVsaWFiaWxpdHlcbiAgICAgICAgdXNlUG9sbGluZzogcHJvY2Vzcy5wbGF0Zm9ybSA9PT0gXCJsaW51eFwiLFxuICAgICAgICBpbnRlcnZhbDogMzAwLFxuICAgICAgfSlcblxuICAgICAgLyoqXG4gICAgICAgKiBGaW5kIHdoaWNoIGZ1bmN0aW9uIG93bnMgYSBnaXZlbiBmaWxlIHBhdGguXG4gICAgICAgKi9cbiAgICAgIGNvbnN0IGZpbmRPd25pbmdGdW5jdGlvbiA9IChmaWxlUGF0aDogc3RyaW5nKTogc3RyaW5nIHwgdW5kZWZpbmVkID0+IHtcbiAgICAgICAgY29uc3Qgbm9ybWFsaXplZEZpbGVQYXRoID0gcGF0aC5ub3JtYWxpemUoZmlsZVBhdGgpXG5cbiAgICAgICAgZm9yIChjb25zdCBbY29udGV4dFBhdGgsIGZ1bmN0aW9uSWRdIG9mIGNvbnRleHRUb0Z1bmN0aW9uKSB7XG4gICAgICAgICAgaWYgKG5vcm1hbGl6ZWRGaWxlUGF0aC5zdGFydHNXaXRoKGNvbnRleHRQYXRoICsgcGF0aC5zZXApKSB7XG4gICAgICAgICAgICByZXR1cm4gZnVuY3Rpb25JZFxuICAgICAgICAgIH1cbiAgICAgICAgICAvLyBBbHNvIG1hdGNoIGlmIHRoZSBmaWxlIElTIHRoZSBjb250ZXh0IGRpcmVjdG9yeSAoc2hvdWxkbid0IGhhcHBlbiBidXQgaGFuZGxlIGl0KVxuICAgICAgICAgIGlmIChub3JtYWxpemVkRmlsZVBhdGggPT09IGNvbnRleHRQYXRoKSB7XG4gICAgICAgICAgICByZXR1cm4gZnVuY3Rpb25JZFxuICAgICAgICAgIH1cbiAgICAgICAgfVxuICAgICAgICByZXR1cm4gdW5kZWZpbmVkXG4gICAgICB9XG5cbiAgICAgIC8qKlxuICAgICAgICogSGFuZGxlIGEgZmlsZSBjaGFuZ2UgZXZlbnQuXG4gICAgICAgKi9cbiAgICAgIGNvbnN0IGhhbmRsZUNoYW5nZSA9IChcbiAgICAgICAgdHlwZTogXCJhZGRcIiB8IFwiY2hhbmdlXCIgfCBcInVubGlua1wiLFxuICAgICAgICBmaWxlUGF0aDogc3RyaW5nLFxuICAgICAgKSA9PiB7XG4gICAgICAgIGNvbnN0IGZ1bmN0aW9uSWQgPSBmaW5kT3duaW5nRnVuY3Rpb24oZmlsZVBhdGgpXG4gICAgICAgIGlmIChmdW5jdGlvbklkKSB7XG4gICAgICAgICAgZW1pdC5zaW5nbGUoe1xuICAgICAgICAgICAgZnVuY3Rpb25JZCxcbiAgICAgICAgICAgIGZpbGVQYXRoLFxuICAgICAgICAgICAgdHlwZSxcbiAgICAgICAgICB9KVxuICAgICAgICB9XG4gICAgICB9XG5cbiAgICAgIHdhdGNoZXIub24oXCJhZGRcIiwgKGZpbGVQYXRoKSA9PiBoYW5kbGVDaGFuZ2UoXCJhZGRcIiwgZmlsZVBhdGgpKVxuICAgICAgd2F0Y2hlci5vbihcImNoYW5nZVwiLCAoZmlsZVBhdGgpID0+IGhhbmRsZUNoYW5nZShcImNoYW5nZVwiLCBmaWxlUGF0aCkpXG4gICAgICB3YXRjaGVyLm9uKFwidW5saW5rXCIsIChmaWxlUGF0aCkgPT4gaGFuZGxlQ2hhbmdlKFwidW5saW5rXCIsIGZpbGVQYXRoKSlcblxuICAgICAgd2F0Y2hlci5vbihcImVycm9yXCIsIChlcnIpID0+IHtcbiAgICAgICAgY29uc3QgZXJyb3IgPSBlcnIgYXMgRXJyb3JcbiAgICAgICAgRWZmZWN0LnJ1blN5bmMoXG4gICAgICAgICAgRWZmZWN0LmxvZ1dhcm5pbmcoYERvY2tlcldhdGNoZXIgZXJyb3I6ICR7ZXJyb3IubWVzc2FnZX1gKSxcbiAgICAgICAgKVxuICAgICAgICAvLyBEb24ndCBmYWlsIHRoZSBzdHJlYW0gb24gdHJhbnNpZW50IGVycm9ycywganVzdCBsb2dcbiAgICAgIH0pXG5cbiAgICAgIHdhdGNoZXIub24oXCJyZWFkeVwiLCAoKSA9PiB7XG4gICAgICAgIEVmZmVjdC5ydW5TeW5jKFxuICAgICAgICAgIEVmZmVjdC5sb2dEZWJ1ZyhcbiAgICAgICAgICAgIGBXYXRjaGluZyAke2Z1bmN0aW9ucy5sZW5ndGh9IERvY2tlciBjb250ZXh0KHMpIGZvciBjaGFuZ2VzYCxcbiAgICAgICAgICApLFxuICAgICAgICApXG4gICAgICAgIGZvciAoY29uc3QgZm4gb2YgZnVuY3Rpb25zKSB7XG4gICAgICAgICAgRWZmZWN0LnJ1blN5bmMoXG4gICAgICAgICAgICBFZmZlY3QubG9nRGVidWcoYCAgLSAke2ZuLmZ1bmN0aW9uSWR9OiAke2ZuLmRvY2tlckNvbnRleHRQYXRofWApLFxuICAgICAgICAgIClcbiAgICAgICAgfVxuICAgICAgfSlcblxuICAgICAgLy8gQ2xlYW51cCB3aGVuIHNjb3BlIGNsb3Nlc1xuICAgICAgeWllbGQqIEVmZmVjdC5hZGRGaW5hbGl6ZXIoKCkgPT5cbiAgICAgICAgRWZmZWN0LmdlbihmdW5jdGlvbiogKCkge1xuICAgICAgICAgIHlpZWxkKiBFZmZlY3QucHJvbWlzZShhc3luYyAoKSA9PiB7XG4gICAgICAgICAgICBhd2FpdCB3YXRjaGVyLmNsb3NlKClcbiAgICAgICAgICB9KVxuICAgICAgICAgIHlpZWxkKiBFZmZlY3QubG9nRGVidWcoXCJEb2NrZXJXYXRjaGVyIGZpbGUgd2F0Y2hlciBjbG9zZWRcIilcbiAgICAgICAgfSksXG4gICAgICApXG4gICAgfSksXG4gICkucGlwZShcbiAgICAvLyBEZWJvdW5jZSB0byBoYW5kbGUgYmF0Y2ggZmlsZSBjaGFuZ2VzIChlLmcuLCBnaXQgY2hlY2tvdXQsIElERSBzYXZlLWFsbClcbiAgICBTdHJlYW0uZGVib3VuY2UoYCR7ZGVib3VuY2VNc30gbWlsbGlzYCksXG4gIClcbn1cblxuLyoqXG4gKiBDcmVhdGUgYSB3YXRjaGVyIGZvciBhIHNpbmdsZSBEb2NrZXIgZnVuY3Rpb24uXG4gKiBDb252ZW5pZW5jZSB3cmFwcGVyIGFyb3VuZCB3YXRjaERvY2tlckNvbnRleHRzIGZvciBzaW5nbGUtZnVuY3Rpb24gdXNlLlxuICovXG5leHBvcnQgY29uc3Qgd2F0Y2hTaW5nbGVEb2NrZXJDb250ZXh0ID0gKFxuICBmdW5jdGlvbklkOiBzdHJpbmcsXG4gIGRvY2tlckNvbnRleHRQYXRoOiBzdHJpbmcsXG4gIGRlYm91bmNlTXMgPSA1MDAsXG4pOiBTdHJlYW0uU3RyZWFtPERvY2tlckNvbnRleHRDaGFuZ2VFdmVudCwgRXJyb3I+ID0+XG4gIHdhdGNoRG9ja2VyQ29udGV4dHMoW3sgZnVuY3Rpb25JZCwgZG9ja2VyQ29udGV4dFBhdGggfV0sIGRlYm91bmNlTXMpXG4iXX0=

package/lib/cli/index.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env bun
+/**
+ * Effect CLI entry point for cdk-local-lambda.
+ *
+ * Commands:
+ * - bootstrap: Deploy the CdkLocalLambdaBootstrapStack
+ * - local: Run Lambda functions locally using Docker
+ */
+export {};

package/lib/cli/index.js

@@ -0,0 +1,26 @@
+#!/usr/bin/env bun
+/**
+ * Effect CLI entry point for cdk-local-lambda.
+ *
+ * Commands:
+ * - bootstrap: Deploy the CdkLocalLambdaBootstrapStack
+ * - local: Run Lambda functions locally using Docker
+ */
+import { Command } from "@effect/cli";
+import { BunContext, BunRuntime } from "@effect/platform-bun";
+import { Effect } from "effect";
+import { bootstrapCommand } from "./commands/bootstrap.js";
+import { localCommand } from "./commands/local.js";
+/**
+ * Root command
+ */
+const rootCommand = Command.make("local-lambda", {}).pipe(Command.withSubcommands([bootstrapCommand, localCommand]), Command.withDescription("CLI for developing AWS Lambda functions locally"));
+/**
+ * Run the CLI
+ */
+const cli = Command.run(rootCommand, {
+    name: "local-lambda",
+    version: "0.1.0",
+});
+cli(process.argv).pipe(Effect.provide(BunContext.layer), BunRuntime.runMain);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFFQTs7Ozs7O0dBTUc7QUFFSCxPQUFPLEVBQUUsT0FBTyxFQUFFLE1BQU0sYUFBYSxDQUFBO0FBQ3JDLE9BQU8sRUFBRSxVQUFVLEVBQUUsVUFBVSxFQUFFLE1BQU0sc0JBQXNCLENBQUE7QUFDN0QsT0FBTyxFQUFFLE1BQU0sRUFBRSxNQUFNLFFBQVEsQ0FBQTtBQUMvQixPQUFPLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx5QkFBeUIsQ0FBQTtBQUMxRCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0scUJBQXFCLENBQUE7QUFFbEQ7O0dBRUc7QUFDSCxNQUFNLFdBQVcsR0FBRyxPQUFPLENBQUMsSUFBSSxDQUFDLGNBQWMsRUFBRSxFQUFFLENBQUMsQ0FBQyxJQUFJLENBQ3ZELE9BQU8sQ0FBQyxlQUFlLENBQUMsQ0FBQyxnQkFBZ0IsRUFBRSxZQUFZLENBQUMsQ0FBQyxFQUN6RCxPQUFPLENBQUMsZUFBZSxDQUFDLGlEQUFpRCxDQUFDLENBQzNFLENBQUE7QUFFRDs7R0FFRztBQUNILE1BQU0sR0FBRyxHQUFHLE9BQU8sQ0FBQyxHQUFHLENBQUMsV0FBVyxFQUFFO0lBQ25DLElBQUksRUFBRSxjQUFjO0lBQ3BCLE9BQU8sRUFBRSxPQUFPO0NBQ2pCLENBQUMsQ0FBQTtBQUVGLEdBQUcsQ0FBQyxPQUFPLENBQUMsSUFBSSxDQUFDLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxPQUFPLENBQUMsVUFBVSxDQUFDLEtBQUssQ0FBQyxFQUFFLFVBQVUsQ0FBQyxPQUFPLENBQUMsQ0FBQSIsInNvdXJjZXNDb250ZW50IjpbIiMhL3Vzci9iaW4vZW52IGJ1blxuXG4vKipcbiAqIEVmZmVjdCBDTEkgZW50cnkgcG9pbnQgZm9yIGNkay1sb2NhbC1sYW1iZGEuXG4gKlxuICogQ29tbWFuZHM6XG4gKiAtIGJvb3RzdHJhcDogRGVwbG95IHRoZSBDZGtMb2NhbExhbWJkYUJvb3RzdHJhcFN0YWNrXG4gKiAtIGxvY2FsOiBSdW4gTGFtYmRhIGZ1bmN0aW9ucyBsb2NhbGx5IHVzaW5nIERvY2tlclxuICovXG5cbmltcG9ydCB7IENvbW1hbmQgfSBmcm9tIFwiQGVmZmVjdC9jbGlcIlxuaW1wb3J0IHsgQnVuQ29udGV4dCwgQnVuUnVudGltZSB9IGZyb20gXCJAZWZmZWN0L3BsYXRmb3JtLWJ1blwiXG5pbXBvcnQgeyBFZmZlY3QgfSBmcm9tIFwiZWZmZWN0XCJcbmltcG9ydCB7IGJvb3RzdHJhcENvbW1hbmQgfSBmcm9tIFwiLi9jb21tYW5kcy9ib290c3RyYXAuanNcIlxuaW1wb3J0IHsgbG9jYWxDb21tYW5kIH0gZnJvbSBcIi4vY29tbWFuZHMvbG9jYWwuanNcIlxuXG4vKipcbiAqIFJvb3QgY29tbWFuZFxuICovXG5jb25zdCByb290Q29tbWFuZCA9IENvbW1hbmQubWFrZShcImxvY2FsLWxhbWJkYVwiLCB7fSkucGlwZShcbiAgQ29tbWFuZC53aXRoU3ViY29tbWFuZHMoW2Jvb3RzdHJhcENvbW1hbmQsIGxvY2FsQ29tbWFuZF0pLFxuICBDb21tYW5kLndpdGhEZXNjcmlwdGlvbihcIkNMSSBmb3IgZGV2ZWxvcGluZyBBV1MgTGFtYmRhIGZ1bmN0aW9ucyBsb2NhbGx5XCIpLFxuKVxuXG4vKipcbiAqIFJ1biB0aGUgQ0xJXG4gKi9cbmNvbnN0IGNsaSA9IENvbW1hbmQucnVuKHJvb3RDb21tYW5kLCB7XG4gIG5hbWU6IFwibG9jYWwtbGFtYmRhXCIsXG4gIHZlcnNpb246IFwiMC4xLjBcIixcbn0pXG5cbmNsaShwcm9jZXNzLmFyZ3YpLnBpcGUoRWZmZWN0LnByb3ZpZGUoQnVuQ29udGV4dC5sYXllciksIEJ1blJ1bnRpbWUucnVuTWFpbilcbiJdfQ==

package/lib/cli/runtime-api/server.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Lambda Runtime API HTTP server using Effect HttpServer.
+ *
+ * This server emulates the AWS Lambda Runtime API that Docker containers
+ * use to receive invocations and send responses.
+ *
+ * Each Lambda function gets its own server on an ephemeral port. The server
+ * maintains a queue of pending invocations. When a container polls
+ * /invocation/next, it blocks until an invocation is available.
+ *
+ * @see https://docs.aws.amazon.com/lambda/latest/dg/runtimes-api.html
+ */
+import { Effect, HashMap, Queue, Ref, type Scope } from "effect";
+import type { ExtensionEvent, LambdaError, LambdaInitError, LambdaInvocation, LambdaResponse, RegisteredExtension } from "./types.js";
+/**
+ * State for a registered extension.
+ */
+interface ExtensionState {
+    /** Extension info */
+    extension: RegisteredExtension;
+    /** Queue of events for this extension */
+    eventQueue: Queue.Queue<ExtensionEvent>;
+}
+/**
+ * Function metadata for extension registration responses.
+ */
+export interface FunctionMetadata {
+    functionName: string;
+    functionVersion: string;
+    handler: string;
+}
+/**
+ * State for a Runtime API server session.
+ * Supports multiple invocations with a queue-based model.
+ */
+export interface RuntimeApiState {
+    /** Queue of pending invocations waiting to be fetched by the container */
+    invocationQueue: Queue.Queue<LambdaInvocation>;
+    /** Queue for responses/errors from the container */
+    responseQueue: Queue.Queue<LambdaResponse | LambdaError | LambdaInitError>;
+    /** Registered extensions by extension ID */
+    extensions: Ref.Ref<HashMap.HashMap<string, ExtensionState>>;
+    /** Function metadata for extension registration */
+    functionMetadata: FunctionMetadata;
+}
+/**
+ * Result from starting a Runtime API server.
+ */
+export interface RuntimeApiServer {
+    /** The actual port the server is listening on */
+    port: number;
+    /** The state containing the invocation and response queues */
+    state: RuntimeApiState;
+}
+/**
+ * Create a new Runtime API state (queues only, no port).
+ *
+ * @param functionMetadata - Function metadata for extension registration responses
+ */
+export declare const makeRuntimeApiState: (functionMetadata: FunctionMetadata) => Effect.Effect<{
+    invocationQueue: Queue.Queue<LambdaInvocation>;
+    responseQueue: Queue.Queue<LambdaResponse | LambdaError | LambdaInitError>;
+    extensions: Ref.Ref<HashMap.HashMap<string, ExtensionState>>;
+    functionMetadata: FunctionMetadata;
+}, never, never>;
+/**
+ * Options for starting a Runtime API server.
+ */
+export interface RuntimeApiServerOptions {
+    /** How long to wait for an invocation before returning 503 */
+    pollTimeoutMs?: number;
+    /** Function metadata for extension registration */
+    functionMetadata?: FunctionMetadata;
+}
+/**
+ * Start a Runtime API server on an ephemeral port.
+ * Returns the actual port and state for this server instance.
+ *
+ * The server is scoped - it will be stopped when the scope closes.
+ *
+ * @param options - Server configuration options
+ */
+export declare const startRuntimeApiServer: (options?: RuntimeApiServerOptions) => Effect.Effect<RuntimeApiServer, never, Scope.Scope>;
+/**
+ * Queue an invocation for the container to process.
+ */
+export declare const queueInvocation: (state: RuntimeApiState, invocation: LambdaInvocation) => Effect.Effect<void>;
+/**
+ * Wait for the response to a specific invocation.
+ */
+export declare const waitForResponse: (state: RuntimeApiState) => Effect.Effect<LambdaResponse | LambdaError | LambdaInitError>;
+/**
+ * Notify all registered extensions about an invocation.
+ * This sends an INVOKE event to all extensions that registered for it.
+ */
+export declare const notifyExtensionsInvoke: (state: RuntimeApiState, invocation: LambdaInvocation) => Effect.Effect<void>;
+/**
+ * Notify all registered extensions about shutdown.
+ * This sends a SHUTDOWN event to all extensions that registered for it.
+ */
+export declare const notifyExtensionsShutdown: (state: RuntimeApiState, reason?: "SPINDOWN" | "TIMEOUT" | "FAILURE") => Effect.Effect<void>;
+export {};