alchemy 0.35.0 → 0.36.0

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"}

package/lib/docker/container.js

@@ -0,0 +1,109 @@
+import { Resource } from "../resource.js";
+import { DockerApi } from "./api.js";
+/**
+ * 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 const Container = Resource("docker::Container", async function (id, props) {
+    // Initialize Docker API client
+    const api = new DockerApi();
+    // Get image reference
+    const imageRef = typeof props.image === "string" ? props.image : props.image.imageRef;
+    // Use provided name or generate one based on resource ID
+    const containerName = props.name || `alchemy-${id.replace(/[^a-zA-Z0-9_.-]/g, "-")}`;
+    // Handle delete phase
+    if (this.phase === "delete") {
+        if (this.output?.id) {
+            // Stop container if running
+            await api.stopContainer(this.output.id);
+            // Remove container
+            await api.removeContainer(this.output.id, true);
+        }
+        // Return destroyed state
+        return this.destroy();
+    }
+    else {
+        let containerState = "created";
+        if (this.phase === "update") {
+            // Check if container already exists (for update)
+            const containerExists = await api.containerExists(containerName);
+            if (containerExists) {
+                // Remove existing container for update
+                await api.removeContainer(containerName, true);
+            }
+        }
+        // Prepare port mappings
+        const portMappings = {};
+        if (props.ports) {
+            for (const port of props.ports) {
+                const protocol = port.protocol || "tcp";
+                portMappings[`${port.external}`] = `${port.internal}/${protocol}`;
+            }
+        }
+        // Prepare volume mappings
+        const volumeMappings = {};
+        if (props.volumes) {
+            for (const volume of props.volumes) {
+                const readOnlyFlag = volume.readOnly ? ":ro" : "";
+                volumeMappings[volume.hostPath] =
+                    `${volume.containerPath}${readOnlyFlag}`;
+            }
+        }
+        // Create new container
+        const containerId = await api.createContainer(imageRef, containerName, {
+            ports: portMappings,
+            env: props.environment,
+            volumes: volumeMappings,
+            cmd: props.command,
+        });
+        // Connect to networks if specified
+        if (props.networks) {
+            for (const network of props.networks) {
+                const networkId = typeof network === "string" ? network : network.name;
+                await api.connectNetwork(containerId, networkId, {
+                    aliases: network.aliases,
+                });
+            }
+        }
+        // Start container if requested
+        if (props.start) {
+            await api.startContainer(containerId);
+            containerState = "running";
+        }
+        // Return the resource using this() to construct output
+        return this({
+            ...props,
+            id: containerId,
+            state: containerState,
+            createdAt: Date.now(),
+        });
+    }
+});
+//# sourceMappingURL=container.js.map

package/lib/docker/container.js.map

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

package/lib/docker/image.d.ts

@@ -0,0 +1,92 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+/**
+ * Options for building a Docker image
+ */
+export interface DockerBuildOptions {
+    /**
+     * Path to the build context directory
+     */
+    context: string;
+    /**
+     * Path to the Dockerfile, relative to context
+     */
+    dockerfile?: string;
+    /**
+     * Target build platform (e.g., linux/amd64)
+     */
+    platform?: string;
+    /**
+     * Build arguments as key-value pairs
+     */
+    buildArgs?: Record<string, string>;
+    /**
+     * Target build stage in multi-stage builds
+     */
+    target?: string;
+    /**
+     * List of images to use for cache
+     */
+    cacheFrom?: string[];
+}
+/**
+ * Properties for creating a Docker image
+ */
+export interface ImageProps {
+    /**
+     * Repository name for the image (e.g., "username/image")
+     */
+    name: string;
+    /**
+     * Tag for the image (e.g., "latest")
+     */
+    tag?: string;
+    /**
+     * Build configuration
+     */
+    build: DockerBuildOptions;
+    /**
+     * Whether to skip pushing the image to registry
+     */
+    skipPush?: boolean;
+}
+/**
+ * Docker Image resource
+ */
+export interface Image extends Resource<"docker::Image">, ImageProps {
+    /**
+     * Full image reference (name:tag)
+     */
+    imageRef: string;
+    /**
+     * Image ID
+     */
+    imageId?: string;
+    /**
+     * Repository digest if pushed
+     */
+    repoDigest?: string;
+    /**
+     * Time when the image was built
+     */
+    builtAt: number;
+}
+/**
+ * Build and manage a Docker image from a Dockerfile
+ *
+ * @example
+ * // Build a Docker image from a Dockerfile
+ * const appImage = await Image("app-image", {
+ *   name: "myapp",
+ *   tag: "latest",
+ *   build: {
+ *     context: "./app",
+ *     dockerfile: "Dockerfile",
+ *     buildArgs: {
+ *       NODE_ENV: "production"
+ *     }
+ *   }
+ * });
+ */
+export declare const Image: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<Image>, _id: string, props: ImageProps) => Promise<Image>);
+//# sourceMappingURL=image.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/docker/image.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,KAAK,EAAE,kBAAkB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,KAAM,SAAQ,QAAQ,CAAC,eAAe,CAAC,EAAE,UAAU;IAClE;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,KAAK,yFAGR,OAAO,CAAC,KAAK,CAAC,OACf,MAAM,SACJ,UAAU,KAChB,OAAO,CAAC,KAAK,CAAC,CAqFlB,CAAC"}

package/lib/docker/image.js

@@ -0,0 +1,92 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import { Resource } from "../resource.js";
+import { DockerApi } from "./api.js";
+/**
+ * Build and manage a Docker image from a Dockerfile
+ *
+ * @example
+ * // Build a Docker image from a Dockerfile
+ * const appImage = await Image("app-image", {
+ *   name: "myapp",
+ *   tag: "latest",
+ *   build: {
+ *     context: "./app",
+ *     dockerfile: "Dockerfile",
+ *     buildArgs: {
+ *       NODE_ENV: "production"
+ *     }
+ *   }
+ * });
+ */
+export const Image = Resource("docker::Image", async function (_id, props) {
+    // Initialize Docker API client
+    const api = new DockerApi();
+    if (this.phase === "delete") {
+        // No action needed for delete as Docker images aren't automatically removed
+        // This is intentional as other resources might depend on the same image
+        return this.destroy();
+    }
+    else {
+        // Normalize properties
+        const tag = props.tag || "latest";
+        const imageRef = `${props.name}:${tag}`;
+        // Validate build context
+        const { context } = props.build;
+        await fs.access(context);
+        // Determine Dockerfile path
+        const dockerfile = props.build.dockerfile || "Dockerfile";
+        const dockerfilePath = path.join(context, dockerfile);
+        await fs.access(dockerfilePath);
+        // Prepare build options
+        const buildOptions = props.build.buildArgs || {};
+        // Add platform if specified
+        let buildArgs = ["build", "-t", imageRef];
+        if (props.build.platform) {
+            buildArgs.push("--platform", props.build.platform);
+        }
+        // Add target if specified
+        if (props.build.target) {
+            buildArgs.push("--target", props.build.target);
+        }
+        // Add cache sources if specified
+        if (props.build.cacheFrom && props.build.cacheFrom.length > 0) {
+            for (const cacheSource of props.build.cacheFrom) {
+                buildArgs.push("--cache-from", cacheSource);
+            }
+        }
+        // Add build arguments
+        for (const [key, value] of Object.entries(buildOptions)) {
+            buildArgs.push("--build-arg", `${key}="${value}"`);
+        }
+        // Add dockerfile if not the default
+        if (props.build.dockerfile && props.build.dockerfile !== "Dockerfile") {
+            buildArgs.push("-f", props.build.dockerfile);
+        }
+        // Add context path
+        buildArgs.push(props.build.context);
+        // Execute build command
+        console.log(`Building Docker image: ${imageRef}`);
+        const { stdout } = await api.exec(buildArgs);
+        // Extract image ID from build output if available
+        const imageIdMatch = /Successfully built ([a-f0-9]+)/.exec(stdout);
+        const imageId = imageIdMatch ? imageIdMatch[1] : undefined;
+        console.log(`Successfully built Docker image: ${imageRef}`);
+        // Handle push if required
+        let repoDigest;
+        if (!props.skipPush) {
+            console.log(`Pushing Docker image: ${imageRef}`);
+            // TODO: Implement push once API supports it
+            console.warn("Image pushing is not yet implemented");
+        }
+        // Return the resource using this() to construct output
+        return this({
+            ...props,
+            imageRef,
+            imageId,
+            repoDigest,
+            builtAt: Date.now(),
+        });
+    }
+});
+//# sourceMappingURL=image.js.map

package/lib/docker/image.js.map

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

package/lib/docker/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./api.ts";
+export * from "./remote-image.ts";
+export * from "./container.ts";
+export * from "./network.ts";
+export * from "./volume.ts";
+export * from "./image.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/docker/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/lib/docker/index.js

@@ -0,0 +1,7 @@
+export * from "./api.js";
+export * from "./remote-image.js";
+export * from "./container.js";
+export * from "./network.js";
+export * from "./volume.js";
+export * from "./image.js";
+//# sourceMappingURL=index.js.map

package/lib/docker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/docker/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/lib/docker/network.d.ts

@@ -0,0 +1,62 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+/**
+ * Properties for creating a Docker network
+ */
+export interface NetworkProps {
+    /**
+     * Network name
+     */
+    name: string;
+    /**
+     * Network driver to use
+     * @default "bridge"
+     */
+    driver?: "bridge" | "host" | "none" | "overlay" | "macvlan" | (string & {});
+    /**
+     * Enable IPv6 on the network
+     * @default false
+     */
+    enableIPv6?: boolean;
+    /**
+     * Network-scoped alias for containers
+     */
+    labels?: Record<string, string>;
+}
+/**
+ * Docker Network resource
+ */
+export interface Network extends Resource<"docker::Network">, NetworkProps {
+    /**
+     * Network ID
+     */
+    id: string;
+    /**
+     * Time when the network was created
+     */
+    createdAt: number;
+}
+/**
+ * Create and manage a Docker Network
+ *
+ * @see https://docs.docker.com/engine/network/
+ *
+ * @example
+ * // Create a simple bridge network
+ * const appNetwork = await Network("app-network", {
+ *   name: "app-network"
+ * });
+ *
+ * @example
+ * // Create a custom network with driver
+ * const overlayNetwork = await Network("overlay-network", {
+ *   name: "overlay-network",
+ *   driver: "overlay",
+ *   enableIPv6: true,
+ *   labels: {
+ *     "com.example.description": "Network for application services"
+ *   }
+ * });
+ */
+export declare const Network: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<Network>, _id: string, props: NetworkProps) => Promise<Network>);
+//# sourceMappingURL=network.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"network.d.ts","sourceRoot":"","sources":["../../src/docker/network.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;IAE5E;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,QAAQ,CAAC,iBAAiB,CAAC,EAAE,YAAY;IACxE;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,OAAO,yFAGV,OAAO,CAAC,OAAO,CAAC,OACjB,MAAM,SACJ,YAAY,KAClB,OAAO,CAAC,OAAO,CAAC,CA0BpB,CAAC"}

package/lib/docker/network.js

@@ -0,0 +1,49 @@
+import { Resource } from "../resource.js";
+import { DockerApi } from "./api.js";
+/**
+ * Create and manage a Docker Network
+ *
+ * @see https://docs.docker.com/engine/network/
+ *
+ * @example
+ * // Create a simple bridge network
+ * const appNetwork = await Network("app-network", {
+ *   name: "app-network"
+ * });
+ *
+ * @example
+ * // Create a custom network with driver
+ * const overlayNetwork = await Network("overlay-network", {
+ *   name: "overlay-network",
+ *   driver: "overlay",
+ *   enableIPv6: true,
+ *   labels: {
+ *     "com.example.description": "Network for application services"
+ *   }
+ * });
+ */
+export const Network = Resource("docker::Network", async function (_id, props) {
+    // Initialize Docker API client
+    const api = new DockerApi();
+    // Handle delete phase
+    if (this.phase === "delete") {
+        if (this.output?.id) {
+            // Remove network
+            await api.removeNetwork(this.output.id);
+        }
+        // Return destroyed state
+        return this.destroy();
+    }
+    else {
+        // Create the network
+        props.driver = props.driver || "bridge";
+        const networkId = await api.createNetwork(props.name, props.driver);
+        // Return the resource using this() to construct output
+        return this({
+            ...props,
+            id: networkId,
+            createdAt: Date.now(),
+        });
+    }
+});
+//# sourceMappingURL=network.js.map

package/lib/docker/network.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"network.js","sourceRoot":"","sources":["../../src/docker/network.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AA4CrC;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAC7B,iBAAiB,EACjB,KAAK,WAEH,GAAW,EACX,KAAmB;IAEnB,+BAA+B;IAC/B,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;IAE5B,sBAAsB;IACtB,IAAI,IAAI,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,EAAE,CAAC;YACpB,iBAAiB;YACjB,MAAM,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC1C,CAAC;QAED,yBAAyB;QACzB,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC;IACxB,CAAC;SAAM,CAAC;QACN,qBAAqB;QACrB,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,QAAQ,CAAC;QACxC,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAEpE,uDAAuD;QACvD,OAAO,IAAI,CAAC;YACV,GAAG,KAAK;YACR,EAAE,EAAE,SAAS;YACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CACF,CAAC"}

package/lib/docker/remote-image.d.ts

@@ -0,0 +1,45 @@
+import type { Context } from "../context.ts";
+import { Resource } from "../resource.ts";
+/**
+ * Properties for creating a Docker image
+ */
+export interface RemoteImageProps {
+    /**
+     * Docker image name (e.g., "nginx")
+     */
+    name: string;
+    /**
+     * Tag for the image (e.g., "latest" or "1.19-alpine")
+     */
+    tag?: string;
+    /**
+     * Always attempt to pull the image, even if it exists locally
+     */
+    alwaysPull?: boolean;
+}
+/**
+ * Docker Remote Image resource
+ */
+export interface RemoteImage extends Resource<"docker::RemoteImage">, RemoteImageProps {
+    /**
+     * Full image reference (name:tag)
+     */
+    imageRef: string;
+    /**
+     * Time when the image was created or pulled
+     */
+    createdAt: number;
+}
+/**
+ * Create or reference a Docker Remote Image
+ *
+ * @example
+ * // Pull the nginx image
+ * const nginxImage = await RemoteImage("nginx", {
+ *   name: "nginx",
+ *   tag: "latest"
+ * });
+ *
+ */
+export declare const RemoteImage: (((this: any, id: string, props?: {}) => never) & (new (_: never) => never)) | ((this: Context<RemoteImage>, _id: string, props: RemoteImageProps) => Promise<RemoteImage>);
+//# sourceMappingURL=remote-image.d.ts.map

package/lib/docker/remote-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-image.d.ts","sourceRoot":"","sources":["../../src/docker/remote-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,WACf,SAAQ,QAAQ,CAAC,qBAAqB,CAAC,EACrC,gBAAgB;IAClB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,WAAW,yFAGd,OAAO,CAAC,WAAW,CAAC,OACrB,MAAM,SACJ,gBAAgB,KACtB,OAAO,CAAC,WAAW,CAAC,CAwBxB,CAAC"}