cdk-local-lambda 0.0.2

package/lib/cli/daemon.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Stub for daemon logic.
+ *
+ * The daemon will:
+ * 1. Connect to AppSync Events
+ * 2. Subscribe to invocation channels for discovered Lambda functions
+ * 3. Execute local handlers when invocations arrive
+ * 4. Publish responses back to the bridge
+ */
+import { Effect } from "effect";
+export interface DaemonConfig {
+    profile?: string;
+    region?: string;
+    stackName?: string;
+}
+/**
+ * Start the local daemon.
+ *
+ * @param config - Configuration for the daemon
+ * @returns Effect that fails with "not implemented" error
+ */
+export declare const startDaemon: (_config: DaemonConfig) => Effect.Effect<void, Error>;

package/lib/cli/daemon.js

@@ -0,0 +1,18 @@
+/**
+ * Stub for daemon logic.
+ *
+ * The daemon will:
+ * 1. Connect to AppSync Events
+ * 2. Subscribe to invocation channels for discovered Lambda functions
+ * 3. Execute local handlers when invocations arrive
+ * 4. Publish responses back to the bridge
+ */
+import { Effect } from "effect";
+/**
+ * Start the local daemon.
+ *
+ * @param config - Configuration for the daemon
+ * @returns Effect that fails with "not implemented" error
+ */
+export const startDaemon = (_config) => Effect.fail(new Error("Daemon not yet implemented"));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGFlbW9uLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NsaS9kYWVtb24udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7Ozs7O0dBUUc7QUFFSCxPQUFPLEVBQUUsTUFBTSxFQUFFLE1BQU0sUUFBUSxDQUFBO0FBUS9COzs7OztHQUtHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sV0FBVyxHQUFHLENBQ3pCLE9BQXFCLEVBQ08sRUFBRSxDQUM5QixNQUFNLENBQUMsSUFBSSxDQUFDLElBQUksS0FBSyxDQUFDLDRCQUE0QixDQUFDLENBQUMsQ0FBQSIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogU3R1YiBmb3IgZGFlbW9uIGxvZ2ljLlxuICpcbiAqIFRoZSBkYWVtb24gd2lsbDpcbiAqIDEuIENvbm5lY3QgdG8gQXBwU3luYyBFdmVudHNcbiAqIDIuIFN1YnNjcmliZSB0byBpbnZvY2F0aW9uIGNoYW5uZWxzIGZvciBkaXNjb3ZlcmVkIExhbWJkYSBmdW5jdGlvbnNcbiAqIDMuIEV4ZWN1dGUgbG9jYWwgaGFuZGxlcnMgd2hlbiBpbnZvY2F0aW9ucyBhcnJpdmVcbiAqIDQuIFB1Ymxpc2ggcmVzcG9uc2VzIGJhY2sgdG8gdGhlIGJyaWRnZVxuICovXG5cbmltcG9ydCB7IEVmZmVjdCB9IGZyb20gXCJlZmZlY3RcIlxuXG5leHBvcnQgaW50ZXJmYWNlIERhZW1vbkNvbmZpZyB7XG4gIHByb2ZpbGU/OiBzdHJpbmdcbiAgcmVnaW9uPzogc3RyaW5nXG4gIHN0YWNrTmFtZT86IHN0cmluZ1xufVxuXG4vKipcbiAqIFN0YXJ0IHRoZSBsb2NhbCBkYWVtb24uXG4gKlxuICogQHBhcmFtIGNvbmZpZyAtIENvbmZpZ3VyYXRpb24gZm9yIHRoZSBkYWVtb25cbiAqIEByZXR1cm5zIEVmZmVjdCB0aGF0IGZhaWxzIHdpdGggXCJub3QgaW1wbGVtZW50ZWRcIiBlcnJvclxuICovXG5leHBvcnQgY29uc3Qgc3RhcnREYWVtb24gPSAoXG4gIF9jb25maWc6IERhZW1vbkNvbmZpZyxcbik6IEVmZmVjdC5FZmZlY3Q8dm9pZCwgRXJyb3I+ID0+XG4gIEVmZmVjdC5mYWlsKG5ldyBFcnJvcihcIkRhZW1vbiBub3QgeWV0IGltcGxlbWVudGVkXCIpKVxuIl19

package/lib/cli/docker/container.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Docker container management utilities.
+ *
+ * Handles running Docker containers with the Lambda Runtime API
+ * environment configured. Uses @effect/platform Command for
+ * proper Effect-based process management.
+ */
+import { CommandExecutor } from "@effect/platform";
+import type { Process as EffectProcess } from "@effect/platform/CommandExecutor";
+import { Context, Effect, Layer, type Scope } from "effect";
+import type { DockerImageConfig, DockerRunConfig, DockerRunResult, DockerRuntimeInfo } from "./types.js";
+/**
+ * Detect the Docker runtime environment.
+ */
+export declare const detectDockerRuntime: () => Effect.Effect<DockerRuntimeInfo, Error>;
+/**
+ * Docker Service interface for Effect-based Docker operations.
+ * All scoped operations require both Scope and CommandExecutor.
+ */
+export interface DockerService {
+    /**
+     * Run a Docker container and wait for it to complete.
+     * Output is streamed to stdout/stderr.
+     */
+    readonly run: (config: DockerRunConfig) => Effect.Effect<DockerRunResult, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * Run a Docker container with scoped lifecycle management.
+     * Returns the running process which can be interrupted via scope.
+     */
+    readonly runScoped: (config: DockerRunConfig) => Effect.Effect<EffectProcess, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * Build a Docker image from a local context directory.
+     */
+    readonly build: (options: {
+        contextPath: string;
+        imageName: string;
+        platform?: string;
+    }) => Effect.Effect<void, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * Pull a Docker image if not already present.
+     */
+    readonly pull: (imageUri: string) => Effect.Effect<void, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * Stop Docker containers matching a name filter.
+     * Returns the number of containers stopped.
+     * @param containerNameFilter - Filter to match container names
+     * @param timeoutSeconds - Seconds to wait before SIGKILL (default: 10)
+     */
+    readonly stop: (containerNameFilter: string, timeoutSeconds?: number) => Effect.Effect<number, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * List Docker container IDs matching a name filter.
+     */
+    readonly list: (containerNameFilter: string) => Effect.Effect<string[], Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+    /**
+     * Get the detected Docker runtime info.
+     */
+    readonly getRuntimeInfo: () => Effect.Effect<DockerRuntimeInfo, Error>;
+    /**
+     * Inspect a Docker image to get its configuration.
+     * Returns the ENTRYPOINT and CMD from the image.
+     */
+    readonly inspect: (imageUri: string) => Effect.Effect<DockerImageConfig, Error, Scope.Scope | CommandExecutor.CommandExecutor>;
+}
+declare const Docker_base: Context.TagClass<Docker, "Docker", DockerService>;
+/**
+ * Docker Service tag for dependency injection.
+ */
+export declare class Docker extends Docker_base {
+}
+/**
+ * Live Docker service layer.
+ * Note: Does not require CommandExecutor in the layer - it's required
+ * when the service methods are called.
+ */
+export declare const DockerLive: Layer.Layer<Docker, Error>;
+/**
+ * Create a container config for running a Lambda container.
+ */
+export declare const makeLambdaContainerConfig: (options: {
+    imageUri: string;
+    runtimeApiHost: string;
+    runtimeApiPort: number;
+    functionName: string;
+    functionVersion: string;
+    memoryMB: number;
+    timeoutSeconds: number;
+    handler?: string;
+    awsRegion?: string;
+    platform?: string;
+    additionalEnv?: Record<string, string>;
+    invocationContexts?: Map<string, {
+        num: number;
+    }>;
+}) => DockerRunConfig;
+/**
+ * Stream output from a Docker container.
+ */
+export interface ContainerOutput {
+    type: "stdout" | "stderr";
+    data: string;
+}
+/**
+ * Build a wrapper command that starts Lambda extensions before the main app.
+ *
+ * This mimics AWS Lambda's behavior of automatically starting all executables
+ * in /opt/extensions/ as background processes before running the main command.
+ *
+ * @param originalEntrypoint - The image's original ENTRYPOINT
+ * @param originalCmd - The image's original CMD
+ * @returns Entrypoint and command arrays to pass to Docker
+ */
+export declare const buildExtensionWrapperCommand: (originalEntrypoint: string[] | null, originalCmd: string[] | null) => {
+    entrypoint: string[];
+    command: string[];
+};
+export {};