alchemy 0.35.1 → 0.37.0

package/lib/docker/api.d.ts

@@ -0,0 +1,185 @@
+/**
+ * Options for Docker API requests
+ */
+export interface DockerApiOptions {
+    /**
+     * Custom path to Docker binary
+     */
+    dockerPath?: string;
+}
+type VolumeInfo = {
+    CreatedAt: string;
+    Driver: string;
+    Labels: Record<string, string>;
+    Mountpoint: string;
+    Name: string;
+    Options: Record<string, string>;
+    Scope: string;
+};
+/**
+ * Docker API client that wraps Docker CLI commands
+ */
+export declare class DockerApi {
+    /** Path to Docker CLI */
+    readonly dockerPath: string;
+    /**
+     * Create a new Docker API client
+     *
+     * @param options Docker API options
+     */
+    constructor(options?: DockerApiOptions);
+    /**
+     * Run a Docker CLI command
+     *
+     * @param args Command arguments to pass to Docker CLI
+     * @returns Result of the command
+     */
+    exec(args: string[]): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Check if Docker daemon is running
+     *
+     * @returns True if Docker daemon is running
+     */
+    isRunning(): Promise<boolean>;
+    /**
+     * Pull Docker image
+     *
+     * @param image Image name and tag
+     * @returns Result of the pull command
+     */
+    pullImage(image: string): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * Build Docker image
+     *
+     * @param path Path to Dockerfile directory
+     * @param tag Tag for the image
+     * @param buildArgs Build arguments
+     * @returns Result of the build command
+     */
+    buildImage(path: string, tag: string, buildArgs?: Record<string, string>): Promise<{
+        stdout: string;
+        stderr: string;
+    }>;
+    /**
+     * List Docker images
+     *
+     * @returns JSON string containing image list
+     */
+    listImages(): Promise<string>;
+    /**
+     * Create Docker container
+     *
+     * @param image Image name
+     * @param name Container name
+     * @param options Container options
+     * @returns Container ID
+     */
+    createContainer(image: string, name: string, options?: {
+        ports?: Record<string, string>;
+        env?: Record<string, string>;
+        volumes?: Record<string, string>;
+        cmd?: string[];
+    }): Promise<string>;
+    /**
+     * Start Docker container
+     *
+     * @param containerId Container ID or name
+     */
+    startContainer(containerId: string): Promise<void>;
+    /**
+     * Stop Docker container
+     *
+     * @param containerId Container ID or name
+     */
+    stopContainer(containerId: string): Promise<void>;
+    /**
+     * Remove Docker container
+     *
+     * @param containerId Container ID or name
+     * @param force Force removal
+     */
+    removeContainer(containerId: string, force?: boolean): Promise<void>;
+    /**
+     * Get container logs
+     *
+     * @param containerId Container ID or name
+     * @returns Container logs
+     */
+    getContainerLogs(containerId: string): Promise<string>;
+    /**
+     * Check if a container exists
+     *
+     * @param containerId Container ID or name
+     * @returns True if container exists
+     */
+    containerExists(containerId: string): Promise<boolean>;
+    /**
+     * Create Docker network
+     *
+     * @param name Network name
+     * @param driver Network driver
+     * @returns Network ID
+     */
+    createNetwork(name: string, driver?: string): Promise<string>;
+    /**
+     * Remove Docker network
+     *
+     * @param networkId Network ID or name
+     */
+    removeNetwork(networkId: string): Promise<void>;
+    /**
+     * Connect container to network
+     *
+     * @param containerId Container ID or name
+     * @param networkId Network ID or name
+     */
+    connectNetwork(containerId: string, networkId: string, options?: {
+        aliases?: string[];
+    }): Promise<void>;
+    /**
+     * Disconnect container from network
+     *
+     * @param containerId Container ID or name
+     * @param networkId Network ID or name
+     */
+    disconnectNetwork(containerId: string, networkId: string): Promise<void>;
+    /**
+     * Create Docker volume
+     *
+     * @param name Volume name
+     * @param driver Volume driver
+     * @param driverOpts Driver options
+     * @param labels Volume labels
+     * @returns Volume name
+     */
+    createVolume(name: string, driver?: string, driverOpts?: Record<string, string>, labels?: Record<string, string>): Promise<string>;
+    /**
+     * Remove Docker volume
+     *
+     * @param volumeName Volume name
+     * @param force Force removal of the volume
+     */
+    removeVolume(volumeName: string, force?: boolean): Promise<void>;
+    /**
+     * Get Docker volume information
+     *
+     * @param volumeName Volume name
+     * @returns Volume details in JSON format
+     */
+    inspectVolume(volumeName: string): Promise<VolumeInfo[]>;
+    /**
+     * Check if a volume exists
+     *
+     * @param volumeName Volume name
+     * @returns True if volume exists
+     */
+    volumeExists(volumeName: string): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=api.d.ts.map

package/lib/docker/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/docker/api.ts"],"names":[],"mappings":"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"}

package/lib/docker/api.js

@@ -0,0 +1,288 @@
+import { exec } from "../os/exec.js";
+/**
+ * Docker API client that wraps Docker CLI commands
+ */
+export class DockerApi {
+    /** Path to Docker CLI */
+    dockerPath;
+    /**
+     * Create a new Docker API client
+     *
+     * @param options Docker API options
+     */
+    constructor(options = {}) {
+        this.dockerPath = options.dockerPath || "docker";
+    }
+    /**
+     * Run a Docker CLI command
+     *
+     * @param args Command arguments to pass to Docker CLI
+     * @returns Result of the command
+     */
+    async exec(args) {
+        const command = `${this.dockerPath} ${args.join(" ")}`;
+        const result = (await exec(command, {
+            captureOutput: true,
+            shell: true,
+            env: process.env,
+        }));
+        return result;
+    }
+    /**
+     * Check if Docker daemon is running
+     *
+     * @returns True if Docker daemon is running
+     */
+    async isRunning() {
+        try {
+            // Use a quick, lightweight command to test if Docker is running
+            await this.exec(["version", "--format", "{{.Server.Version}}"]);
+            return true;
+        }
+        catch (error) {
+            console.log(`Docker daemon not running: ${error instanceof Error ? error.message : String(error)}`);
+            return false;
+        }
+    }
+    /**
+     * Pull Docker image
+     *
+     * @param image Image name and tag
+     * @returns Result of the pull command
+     */
+    async pullImage(image) {
+        return this.exec(["pull", image]);
+    }
+    /**
+     * Build Docker image
+     *
+     * @param path Path to Dockerfile directory
+     * @param tag Tag for the image
+     * @param buildArgs Build arguments
+     * @returns Result of the build command
+     */
+    async buildImage(path, tag, buildArgs = {}) {
+        const args = ["build", "-t", tag, path];
+        for (const [key, value] of Object.entries(buildArgs)) {
+            args.push("--build-arg", `${key}=${value}`);
+        }
+        return this.exec(args);
+    }
+    /**
+     * List Docker images
+     *
+     * @returns JSON string containing image list
+     */
+    async listImages() {
+        const { stdout } = await this.exec(["images", "--format", "{{json .}}"]);
+        return stdout;
+    }
+    /**
+     * Create Docker container
+     *
+     * @param image Image name
+     * @param name Container name
+     * @param options Container options
+     * @returns Container ID
+     */
+    async createContainer(image, name, options = {}) {
+        const args = ["create", "--name", name];
+        // Add port mappings
+        if (options.ports) {
+            for (const [hostPort, containerPort] of Object.entries(options.ports)) {
+                args.push("-p", `${hostPort}:${containerPort}`);
+            }
+        }
+        // Add environment variables
+        if (options.env) {
+            for (const [key, value] of Object.entries(options.env)) {
+                args.push("-e", `${key}=${value}`);
+            }
+        }
+        // Add volume mappings
+        if (options.volumes) {
+            for (const [hostPath, containerPath] of Object.entries(options.volumes)) {
+                args.push("-v", `${hostPath}:${containerPath}`);
+            }
+        }
+        args.push(image);
+        // Add command if specified
+        if (options.cmd && options.cmd.length > 0) {
+            args.push(...options.cmd);
+        }
+        const { stdout } = await this.exec(args);
+        return stdout.trim();
+    }
+    /**
+     * Start Docker container
+     *
+     * @param containerId Container ID or name
+     */
+    async startContainer(containerId) {
+        await this.exec(["start", containerId]);
+    }
+    /**
+     * Stop Docker container
+     *
+     * @param containerId Container ID or name
+     */
+    async stopContainer(containerId) {
+        await this.exec(["stop", containerId]);
+    }
+    /**
+     * Remove Docker container
+     *
+     * @param containerId Container ID or name
+     * @param force Force removal
+     */
+    async removeContainer(containerId, force = false) {
+        const args = ["rm"];
+        if (force) {
+            args.push("-f");
+        }
+        args.push(containerId);
+        await this.exec(args);
+    }
+    /**
+     * Get container logs
+     *
+     * @param containerId Container ID or name
+     * @returns Container logs
+     */
+    async getContainerLogs(containerId) {
+        const { stdout } = await this.exec(["logs", containerId]);
+        return stdout;
+    }
+    /**
+     * Check if a container exists
+     *
+     * @param containerId Container ID or name
+     * @returns True if container exists
+     */
+    async containerExists(containerId) {
+        try {
+            await this.exec(["inspect", containerId]);
+            return true;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+    /**
+     * Create Docker network
+     *
+     * @param name Network name
+     * @param driver Network driver
+     * @returns Network ID
+     */
+    async createNetwork(name, driver = "bridge") {
+        const { stdout } = await this.exec([
+            "network",
+            "create",
+            "--driver",
+            driver,
+            name,
+        ]);
+        return stdout.trim();
+    }
+    /**
+     * Remove Docker network
+     *
+     * @param networkId Network ID or name
+     */
+    async removeNetwork(networkId) {
+        await this.exec(["network", "rm", networkId]);
+    }
+    /**
+     * Connect container to network
+     *
+     * @param containerId Container ID or name
+     * @param networkId Network ID or name
+     */
+    async connectNetwork(containerId, networkId, options = {}) {
+        const args = ["network", "connect"];
+        if (options.aliases) {
+            for (const alias of options.aliases) {
+                args.push("--alias", alias);
+            }
+        }
+        args.push(networkId, containerId);
+        await this.exec(args);
+    }
+    /**
+     * Disconnect container from network
+     *
+     * @param containerId Container ID or name
+     * @param networkId Network ID or name
+     */
+    async disconnectNetwork(containerId, networkId) {
+        await this.exec(["network", "disconnect", networkId, containerId]);
+    }
+    /**
+     * Create Docker volume
+     *
+     * @param name Volume name
+     * @param driver Volume driver
+     * @param driverOpts Driver options
+     * @param labels Volume labels
+     * @returns Volume name
+     */
+    async createVolume(name, driver = "local", driverOpts = {}, labels = {}) {
+        const args = ["volume", "create", "--name", name, "--driver", driver];
+        // Add driver options
+        for (const [key, value] of Object.entries(driverOpts)) {
+            args.push("--opt", `${key}=${value}`);
+        }
+        // Add labels
+        for (const [key, value] of Object.entries(labels)) {
+            args.push("--label", `${key}=${value}`);
+        }
+        const { stdout } = await this.exec(args);
+        return stdout.trim();
+    }
+    /**
+     * Remove Docker volume
+     *
+     * @param volumeName Volume name
+     * @param force Force removal of the volume
+     */
+    async removeVolume(volumeName, force = false) {
+        const args = ["volume", "rm"];
+        if (force) {
+            args.push("--force");
+        }
+        args.push(volumeName);
+        await this.exec(args);
+    }
+    /**
+     * Get Docker volume information
+     *
+     * @param volumeName Volume name
+     * @returns Volume details in JSON format
+     */
+    async inspectVolume(volumeName) {
+        const { stdout } = await this.exec(["volume", "inspect", volumeName]);
+        try {
+            return JSON.parse(stdout.trim());
+        }
+        catch (_error) {
+            return [];
+        }
+    }
+    /**
+     * Check if a volume exists
+     *
+     * @param volumeName Volume name
+     * @returns True if volume exists
+     */
+    async volumeExists(volumeName) {
+        try {
+            await this.inspectVolume(volumeName);
+            return true;
+        }
+        catch (_error) {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=api.js.map

package/lib/docker/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/docker/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAsBrC;;GAEG;AACH,MAAM,OAAO,SAAS;IACpB,yBAAyB;IAChB,UAAU,CAAS;IAE5B;;;;OAIG;IACH,YAAY,UAA4B,EAAE;QACxC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,IAAI,QAAQ,CAAC;IACnD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,IAAI,CAAC,IAAc;QACvB,MAAM,OAAO,GAAG,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,OAAO,EAAE;YAClC,aAAa,EAAE,IAAI;YACnB,KAAK,EAAE,IAAI;YACX,GAAG,EAAE,OAAO,CAAC,GAAG;SACjB,CAAC,CAAuC,CAAC;QAE1C,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,SAAS;QACb,IAAI,CAAC;YACH,gEAAgE;YAChE,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,UAAU,EAAE,qBAAqB,CAAC,CAAC,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CACT,8BAA8B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CACvF,CAAC;YACF,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,SAAS,CAAC,KAAa;QAC3B,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC;IACpC,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,UAAU,CACd,IAAY,EACZ,GAAW,EACX,YAAoC,EAAE;QAEtC,MAAM,IAAI,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAExC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC,CAAC;QACzE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,eAAe,CACnB,KAAa,EACb,IAAY,EACZ,UAKI,EAAE;QAEN,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAExC,oBAAoB;QACpB,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAClB,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACtE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,IAAI,aAAa,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,4BAA4B;QAC5B,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACvD,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,sBAAsB;QACtB,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,QAAQ,EAAE,aAAa,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;gBACxE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,QAAQ,IAAI,aAAa,EAAE,CAAC,CAAC;YAClD,CAAC;QACH,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAEjB,2BAA2B;QAC3B,IAAI,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,cAAc,CAAC,WAAmB;QACtC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB;QACrC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;IACzC,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,WAAmB,EAAE,KAAK,GAAG,KAAK;QACtD,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAClB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,gBAAgB,CAAC,WAAmB;QACxC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC;QAC1D,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,eAAe,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;YAC1C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,aAAa,CAAC,IAAY,EAAE,MAAM,GAAG,QAAQ;QACjD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC;YACjC,SAAS;YACT,QAAQ;YACR,UAAU;YACV,MAAM;YACN,IAAI;SACL,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,SAAiB;QACnC,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC;IAChD,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,cAAc,CAClB,WAAmB,EACnB,SAAiB,EACjB,UAEI,EAAE;QAEN,MAAM,IAAI,GAAG,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YACpB,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;QAClC,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,iBAAiB,CACrB,WAAmB,EACnB,SAAiB;QAEjB,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IAED;;;;;;;;OAQG;IACH,KAAK,CAAC,YAAY,CAChB,IAAY,EACZ,MAAM,GAAG,OAAO,EAChB,aAAqC,EAAE,EACvC,SAAiC,EAAE;QAEnC,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QAEtE,qBAAqB;QACrB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QACxC,CAAC;QAED,aAAa;QACb,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;YAClD,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzC,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC;IACvB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB,EAAE,KAAK,GAAG,KAAK;QAClD,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC9B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtB,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,aAAa,CAAC,UAAkB;QACpC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QACtE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,CAAiB,CAAC;QACnD,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,YAAY,CAAC,UAAkB;QACnC,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,OAAO,MAAM,EAAE,CAAC;YAChB,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

package/lib/docker/container.d.ts

@@ -0,0 +1,147 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+import type { Image } from "./image.ts";
+import type { RemoteImage } from "./remote-image.ts";
+/**
+ * Port mapping configuration
+ */
+export interface PortMapping {
+    /**
+     * External port on the host
+     */
+    external: number | string;
+    /**
+     * Internal port inside the container
+     */
+    internal: number | string;
+    /**
+     * Protocol (tcp or udp)
+     */
+    protocol?: "tcp" | "udp";
+}
+/**
+ * Volume mapping configuration
+ */
+export interface VolumeMapping {
+    /**
+     * Host path
+     */
+    hostPath: string;
+    /**
+     * Container path
+     */
+    containerPath: string;
+    /**
+     * Read-only flag
+     */
+    readOnly?: boolean;
+}
+/**
+ * Network mapping configuration
+ */
+export interface NetworkMapping {
+    /**
+     * Network name or ID
+     */
+    name: string;
+    /**
+     * Aliases for the container in the network
+     */
+    aliases?: string[];
+}
+/**
+ * Properties for creating a Docker container
+ */
+export interface ContainerProps {
+    /**
+     * Image to use for the container
+     * Can be an Alchemy Image or RemoteImage resource or a string image reference
+     */
+    image: Image | RemoteImage | string;
+    /**
+     * Container name
+     */
+    name?: string;
+    /**
+     * Command to run in the container
+     */
+    command?: string[];
+    /**
+     * Environment variables
+     */
+    environment?: Record<string, string>;
+    /**
+     * Port mappings
+     */
+    ports?: PortMapping[];
+    /**
+     * Volume mappings
+     */
+    volumes?: VolumeMapping[];
+    /**
+     * Restart policy
+     */
+    restart?: "no" | "always" | "on-failure" | "unless-stopped";
+    /**
+     * Networks to connect to
+     */
+    networks?: NetworkMapping[];
+    /**
+     * Whether to remove the container when it exits
+     */
+    removeOnExit?: boolean;
+    /**
+     * Start the container after creation
+     */
+    start?: boolean;
+}
+/**
+ * Docker Container resource
+ */
+export interface Container extends Resource<"docker::Container">, ContainerProps {
+    /**
+     * Container ID
+     */
+    id: string;
+    /**
+     * Container state
+     */
+    state?: "created" | "running" | "paused" | "stopped" | "exited";
+    /**
+     * Time when the container was created
+     */
+    createdAt: number;
+}
+/**
+ * Create and manage a Docker Container
+ *
+ * @example
+ * // Create a simple Nginx container
+ * const webContainer = await Container("web", {
+ *   image: "nginx:latest",
+ *   ports: [
+ *     { external: 8080, internal: 80 }
+ *   ],
+ *   start: true
+ * });
+ *
+ * @example
+ * // Create a container with environment variables and volume mounts
+ * const appContainer = await Container("app", {
+ *   image: customImage, // Using an Alchemy RemoteImage resource
+ *   environment: {
+ *     NODE_ENV: "production",
+ *     API_KEY: "secret-key"
+ *   },
+ *   volumes: [
+ *     { hostPath: "./data", containerPath: "/app/data" }
+ *   ],
+ *   ports: [
+ *     { external: 3000, internal: 3000 }
+ *   ],
+ *   restart: "always",
+ *   start: true
+ * });
+ */
+export declare const Container: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<Container>, id: string, props: ContainerProps) => Promise<Container>);
+//# sourceMappingURL=container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/docker/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;;OAGG;IACH,KAAK,EAAE,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;IAEpC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IAEnB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAErC;;OAEG;IACH,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC;IAEtB;;OAEG;IACH,OAAO,CAAC,EAAE,aAAa,EAAE,CAAC;IAE1B;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;IAE5D;;OAEG;IACH,QAAQ,CAAC,EAAE,cAAc,EAAE,CAAC;IAE5B;;OAEG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SACf,SAAQ,QAAQ,CAAC,mBAAmB,CAAC,EACnC,cAAc;IAChB;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,QAAQ,CAAC;IAEhE;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,SAAS,yFAGZ,OAAO,CAAC,SAAS,CAAC,MACpB,MAAM,SACH,cAAc,KACpB,OAAO,CAAC,SAAS,CAAC,CA0FtB,CAAC"}