alchemy 2.0.0-beta.65 → 2.0.0-beta.66

package/lib/Docker/ServiceImage.d.ts

@@ -0,0 +1,78 @@
+import * as Effect from "effect/Effect";
+import type * as rolldown from "rolldown";
+import { AlchemyContext } from "../AlchemyContext.ts";
+import * as Bundle from "../Bundle/Bundle.ts";
+import { Docker } from "./Docker.ts";
+/**
+ * INTERNAL — image machinery for the effectful `Docker.Service` platform.
+ *
+ * NOT exported from the Docker barrel. Bundles a `main` Effect program with
+ * rolldown, bakes it into a generated bun Dockerfile, and builds the image
+ * with the Docker CLI against the service's Docker context — so the image is
+ * present in the exact engine the Swarm service schedules from. There is no
+ * registry push: the built image is content-addressed (`<name>:<hash>`) and
+ * only rebuilt when the bundle, Dockerfile, or environment image changes.
+ *
+ * Multi-node swarms need the image on every node; for those, build with
+ * `Docker.Image` + a `registry` and pass the pushed ref as `image` instead.
+ */
+/** The props subset that describes a bundled `main` service image. */
+export interface BundledServiceSource {
+    main: string;
+    image?: string;
+    handler?: string;
+    port?: number;
+    build?: {
+        input?: Partial<rolldown.InputOptions>;
+        output?: Partial<rolldown.OutputOptions>;
+    };
+}
+/** The resolved (built) local image. */
+export interface ResolvedServiceImage {
+    /** Full image reference, `<name>:<codeHash>`. */
+    imageRef: string;
+    /** Content hash identifying the image (also the image tag). */
+    codeHash: string;
+}
+/**
+ * The standard bun bootstrap wrapped around a `Docker.Service` `main` entry:
+ * resolves the bundled program's registered runners (`host.run` loops and the
+ * served `fetch` handler) and runs them with a Bun HTTP server bound to
+ * `PORT`. Mirrors the ECS bootstrap minus the AWS credential/region layers —
+ * a Swarm task has no ambient cloud identity.
+ */
+export declare const makeServiceBunBootstrap: (handler: string) => (importPath: string) => string;
+/**
+ * Init-time constructor for the service-image resolver. Resolves the services
+ * that are only available at provider-layer construction (Docker, the
+ * `.alchemy` directory, the rolldown virtual-entry plugin) and returns
+ * `resolve` (build the image if its content hash isn't present in the target
+ * engine) and `hash` (content hash only, for `diff`).
+ */
+export declare const makeServiceImage: Effect.Effect<{
+    resolve: (options: {
+        /** Logical resource id — keys the stable build-context directory. */
+        id: string;
+        source: BundledServiceSource;
+        /** Image repository name (the service's physical name). */
+        name: string;
+        /** Docker context the swarm service is deployed to. */
+        context: string | undefined;
+        isExternal?: boolean;
+        /** Plan-status session used to emit build progress notes. */
+        session: {
+            note: (message: string) => Effect.Effect<void>;
+        };
+    }) => Effect.Effect<{
+        imageRef: string;
+        codeHash: string;
+    }, Bundle.BundleError | import("effect/PlatformError").PlatformError, import("effect/FileSystem").FileSystem | import("effect/Path").Path | import("../Stack.ts").Stack | import("../Stage.ts").Stage>;
+    hash: (options: {
+        source: BundledServiceSource;
+        isExternal?: boolean;
+    }) => Effect.Effect<string, Bundle.BundleError | import("effect/PlatformError").PlatformError, import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
+}, never, AlchemyContext | Docker | import("effect/Path").Path>;
+/** The resolver service returned by {@link makeServiceImage}. */
+export interface ServiceImage extends Effect.Success<typeof makeServiceImage> {
+}
+//# sourceMappingURL=ServiceImage.d.ts.map

package/lib/Docker/ServiceImage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ServiceImage.d.ts","sourceRoot":"","sources":["../../src/Docker/ServiceImage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,QAAQ,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAQ9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC;;;;;;;;;;;;GAYG;AAEH,sEAAsE;AACtE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE;QACN,KAAK,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;KAC1C,CAAC;CACH;AAED,wCAAwC;AACxC,MAAM,WAAW,oBAAoB;IACnC,iDAAiD;IACjD,QAAQ,EAAE,MAAM,CAAC;IACjB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,YACxB,MAAM,kBACH,MAAM,KAAG,MAuEvB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB;;QA8HzB,qEAAqE;YACjE,MAAM;gBACF,oBAAoB;QAC5B,2DAA2D;cACrD,MAAM;QACZ,uDAAuD;iBAC9C,MAAM,GAAG,SAAS;qBACd,OAAO;QACpB,6DAA6D;iBACpD;YAAE,IAAI,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;SAAE;;;;;;gBAgDnD,oBAAoB;qBACf,OAAO;;+DAOtB,CAAC;AAEH,iEAAiE;AACjE,MAAM,WAAW,YAAa,SAAQ,MAAM,CAAC,OAAO,CAAC,OAAO,gBAAgB,CAAC;CAAG"}

package/lib/Docker/ServiceImage.js

@@ -0,0 +1,232 @@
+import * as Effect from "effect/Effect";
+import { AlchemyContext } from "../AlchemyContext.js";
+import * as Bundle from "../Bundle/Bundle.js";
+import { findCwdForBundle, getStableContextDir, resolveMainPath, } from "../Bundle/TempRoot.js";
+import { Self } from "../Self.js";
+import { sha256Object } from "../Util/sha256.js";
+import { Docker } from "./Docker.js";
+/**
+ * The standard bun bootstrap wrapped around a `Docker.Service` `main` entry:
+ * resolves the bundled program's registered runners (`host.run` loops and the
+ * served `fetch` handler) and runs them with a Bun HTTP server bound to
+ * `PORT`. Mirrors the ECS bootstrap minus the AWS credential/region layers —
+ * a Swarm task has no ambient cloud identity.
+ */
+export const makeServiceBunBootstrap = (handler) => (importPath) => `
+import { BunServices } from "@effect/platform-bun";
+import { BunHttpServer } from "alchemy/Http";
+import { Stack } from "alchemy/Stack";
+import { makeEntrypointLayer, reifyBoundConfigProvider } from "alchemy/Runtime";
+import * as Config from "effect/Config";
+import * as ConfigProvider from "effect/ConfigProvider";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/unstable/http/FetchHttpClient";
+import * as Layer from "effect/Layer";
+import * as Logger from "effect/Logger";
+
+import { ${handler} as entrypoint } from ${JSON.stringify(importPath)};
+
+// Normalize the entrypoint export: an inline-effect class default export is
+// an Effect resolving the platform instance, while the tagged form
+// (X.make(props, impl)) exports a Layer providing the Self tag. Both fold
+// into a Layer via makeEntrypointLayer (same pattern as the ECS bridge).
+const tag = Context.Service("${Self.key}");
+const layer = makeEntrypointLayer(tag, entrypoint);
+
+const platform = Layer.mergeAll(
+  BunServices.layer,
+  FetchHttpClient.layer,
+  Logger.layer([Logger.consolePretty()]),
+);
+
+const stack = Layer.effect(
+  Stack,
+  Effect.all([
+    Config.string("ALCHEMY_STACK_NAME"),
+    Config.string("ALCHEMY_STAGE")
+  ]).pipe(
+    Effect.map(([name, stage]) => ({
+      name,
+      stage,
+      bindings: {},
+      resources: {}
+    }))
+  )
+);
+
+// Resolve the bundled program (the runners registered via host.run / serve)
+// and run it with a Bun HTTP server bound to PORT, so the returned { fetch }
+// handler is actually served and host.run loops stay alive.
+const program = tag.pipe(
+  Effect.flatMap((service) => service.RuntimeContext.exports),
+  Effect.flatMap((exports) => exports.program),
+  Effect.provide(
+    layer.pipe(
+      Layer.provideMerge(stack),
+      Layer.provideMerge(BunHttpServer()),
+      Layer.provideMerge(platform),
+      Layer.provideMerge(
+        Layer.succeed(
+          ConfigProvider.ConfigProvider,
+          reifyBoundConfigProvider(ConfigProvider.fromEnv(), process.env)
+        )
+      ),
+    )
+  ),
+  Effect.scoped
+);
+
+console.log("Docker service bootstrap starting...");
+await Effect.runPromise(program).catch((err) => {
+  console.error("Docker service bootstrap failed:", err);
+  process.exit(1);
+});
+`;
+/**
+ * Init-time constructor for the service-image resolver. Resolves the services
+ * that are only available at provider-layer construction (Docker, the
+ * `.alchemy` directory, the rolldown virtual-entry plugin) and returns
+ * `resolve` (build the image if its content hash isn't present in the target
+ * engine) and `hash` (content hash only, for `diff`).
+ */
+export const makeServiceImage = Effect.gen(function* () {
+    const docker = yield* Docker;
+    const { dotAlchemy } = yield* AlchemyContext;
+    const virtualEntryPlugin = yield* Bundle.virtualEntryPlugin;
+    /** Bundle the Effect program behind a `main` source. */
+    const bundleProgram = Effect.fn(function* (options) {
+        const { source } = options;
+        const realMain = yield* resolveMainPath(source.main);
+        const cwd = yield* findCwdForBundle(realMain);
+        const bootstrap = makeServiceBunBootstrap(source.handler ?? "default");
+        const buildBundle = Effect.fn(function* (entry, plugins) {
+            return yield* Bundle.build({
+                ...source.build?.input,
+                input: entry,
+                cwd,
+                platform: "node",
+                // The container runs on `bun`; keep `bun`/`bun:*` external (the
+                // runtime provides them) and resolve the `bun` export condition
+                // so `@effect/platform-bun` picks its Bun implementations.
+                external: [
+                    "bun",
+                    "bun:*",
+                    ...(source.build?.input?.external ?? []),
+                ],
+                resolve: {
+                    conditionNames: ["bun", "import", "module", "default"],
+                    ...source.build?.input?.resolve,
+                },
+                plugins: [source.build?.input?.plugins, plugins],
+            }, {
+                ...source.build?.output,
+                format: "esm",
+                sourcemap: source.build?.output?.sourcemap ?? false,
+                minify: source.build?.output?.minify ?? false,
+                entryFileNames: "index.mjs",
+            });
+        });
+        const bundleOutput = options.isExternal
+            ? yield* buildBundle(realMain)
+            : yield* buildBundle(realMain, virtualEntryPlugin(bootstrap));
+        // Return every emitted file (entry + shared chunks). Dynamic imports in
+        // the Bun HTTP server split into chunks; dropping any of them crashes the
+        // container with `Cannot find module './chunk-XXX.js'`.
+        const files = bundleOutput.files.map((file) => ({
+            path: file.path,
+            content: typeof file.content === "string"
+                ? new TextEncoder().encode(file.content)
+                : file.content,
+        }));
+        return { files, hash: bundleOutput.hash };
+    });
+    /**
+     * Generated Dockerfile for a bundled `main` program. The environment
+     * preamble is the `image` ref or the default bun base (`oven/bun` is
+     * Docker-Hub only).
+     */
+    const generateDockerfile = (source) => {
+        const lines = [
+            `FROM ${source.image ?? "oven/bun:1"}`,
+            `WORKDIR /app`,
+            `COPY index.mjs /app/index.mjs`,
+            // Copy any additional rolldown chunks (`chunk-XXX.js`, …). Non-trivial
+            // bundles always emit at least one; minimal bundles emit none and the
+            // COPY no-ops.
+            `COPY *.js /app/`,
+        ];
+        if (source.port !== undefined) {
+            lines.push(`ENV PORT=${String(source.port)}`, `EXPOSE ${String(source.port)}`);
+        }
+        lines.push(`ENTRYPOINT ["bun", "/app/index.mjs"]`);
+        return `${lines.join("\n")}\n`;
+    };
+    /**
+     * Bundle a `main` source and compute its content-addressed code hash. The
+     * hash covers the full image identity — the bundle output (bootstrap entry
+     * included, so bootstrap-template changes invalidate it) and the generated
+     * Dockerfile — so `diff` and `resolve` always agree.
+     */
+    const computeCodeHash = Effect.fn(function* (options) {
+        const bundled = yield* bundleProgram(options);
+        const dockerfile = generateDockerfile(options.source);
+        const codeHash = (yield* sha256Object({
+            bundleHash: bundled.hash,
+            dockerfile,
+        })).slice(0, 16);
+        return { bundled, dockerfile, codeHash };
+    });
+    /** Observe a locally-present tag in the target engine. Missing → undefined. */
+    const imageExists = (imageRef, context) => docker.image.inspect(imageRef, context).pipe(Effect.map(() => true), Effect.catchReason("PlatformError", "NotFound", () => Effect.succeed(false)));
+    /**
+     * Resolve the image for a bundled service: compute the content-addressed
+     * tag, then build only when that exact tag is not already present in the
+     * target Docker context (crash-safe convergence).
+     */
+    const resolve = Effect.fn(function* (options) {
+        const { id, source, session } = options;
+        yield* session.note(`Bundling ${id} program...`);
+        const { bundled, dockerfile, codeHash } = yield* computeCodeHash({
+            source,
+            isExternal: options.isExternal,
+        });
+        const imageRef = `${options.name}:${codeHash}`;
+        if (yield* imageExists(imageRef, options.context)) {
+            return { imageRef, codeHash };
+        }
+        const realMain = yield* resolveMainPath(source.main);
+        const contextDir = yield* getStableContextDir(realMain, dotAlchemy, `${id}-image`);
+        yield* docker.materialize({
+            context: contextDir,
+            dockerfile,
+            // Entry chunk becomes `index.mjs`; all other chunks keep their emitted
+            // `*.js` names so the entry's relative imports resolve.
+            files: bundled.files.map((file, index) => ({
+                path: index === 0 ? "index.mjs" : file.path,
+                content: file.content,
+            })),
+        });
+        yield* session.note(`Building container image ${imageRef}...`);
+        yield* docker.image.build({
+            context: contextDir,
+            tag: imageRef,
+            engineContext: options.context,
+        });
+        yield* session.note(`Built ${imageRef}`);
+        return { imageRef, codeHash };
+    });
+    /**
+     * Content hash without building the image. Runs the bundler (bootstrap
+     * entry included) so the hash reflects the exact image `resolve` would
+     * build — bootstrap-template changes and user-code edits both surface as
+     * drift. The provider calls this from `diff` and compares against
+     * `output.code.hash`.
+     */
+    const hash = Effect.fn(function* (options) {
+        const { codeHash } = yield* computeCodeHash(options);
+        return codeHash;
+    });
+    return { resolve, hash };
+});
+//# sourceMappingURL=ServiceImage.js.map

package/lib/Docker/ServiceImage.js.map

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

package/lib/Docker/Swarm.d.ts

@@ -0,0 +1,117 @@
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import { Docker } from "./Docker.ts";
+import type { Providers } from "./Providers.ts";
+export interface SwarmProps {
+    /** Docker context name or context resource of the engine to initialize. */
+    context?: Docker.ContextRef;
+    /**
+     * Address advertised to other swarm members, e.g. `"10.0.0.1"` or
+     * `"eth0"`. Required by Docker when the host has several network
+     * interfaces. Applied only when the swarm is first initialized.
+     */
+    advertiseAddr?: string;
+    /**
+     * Listen address for swarm traffic, e.g. `"0.0.0.0:2377"`. Applied only
+     * when the swarm is first initialized.
+     */
+    listenAddr?: string;
+    /**
+     * Address pools for global-scope (overlay) networks, e.g.
+     * `["10.20.0.0/16"]`. Applied only when the swarm is first initialized.
+     */
+    defaultAddrPool?: string[];
+    /**
+     * CIDR mask length for each subnet carved from `defaultAddrPool`.
+     * Applied only when the swarm is first initialized.
+     *
+     * @default 24
+     */
+    subnetSize?: number;
+}
+export interface Swarm extends Resource<"Docker.Swarm", SwarmProps, {
+    /** Swarm cluster id. */
+    id: string;
+    /** This node's id in the swarm (a manager). */
+    nodeId: string;
+    /** Docker context the swarm was initialized on. */
+    context?: string;
+    /** Number of manager nodes. */
+    managers: number;
+    /** Number of nodes in the swarm. */
+    nodes: number;
+}, never, Providers> {
+}
+/**
+ * Swarm mode on a Docker engine — an idempotent `docker swarm init`.
+ *
+ * Turns the engine behind the given `context` (or the local engine) into a
+ * single-node swarm: the node becomes a manager that can run `Docker.Service`
+ * workloads. Regular (non-swarm) docker usage of the engine is unaffected.
+ *
+ * Pass the swarm as the `context` of a `Docker.Service` or overlay
+ * `Docker.Network`: the workload then deploys after the swarm exists and
+ * inherits its Docker context.
+ *
+ * An engine that is already in swarm mode is treated as foreign — adopt it
+ * with `adopt(true)` (or `--adopt`) to manage it. Destroying the resource
+ * dissolves the node's swarm membership (`docker swarm leave --force`),
+ * which stops every service running on it — services managed by the same
+ * stack are destroyed first via their dependency edges.
+ *
+ * Growing the cluster beyond one node is host-level setup: run
+ * `docker swarm join --token <token> <manager-ip>:2377` on each additional
+ * machine (`docker swarm join-token worker` on the manager prints the
+ * command). Alchemy manages the swarm's workloads through the manager.
+ * @resource
+ * @section Creating a Swarm
+ * @example Local single-node swarm
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * ```
+ *
+ * @example Remote engine over SSH
+ * ```typescript
+ * const vps = yield* Docker.Context("vps", {
+ *   docker: "host=ssh://deploy@example.com",
+ * });
+ * const swarm = yield* Docker.Swarm("swarm", {
+ *   context: vps,
+ *   advertiseAddr: "10.0.0.1",
+ * });
+ * ```
+ *
+ * @section Using an Existing Swarm
+ * @example Reference without owning
+ * ```typescript
+ * // Services don't require a Swarm resource — point them at an engine that
+ * // is already a manager and the swarm's lifecycle stays external: destroy
+ * // removes the services, never the swarm.
+ * const web = yield* Docker.Service("web", {
+ *   context: vps,
+ *   image: "nginx:alpine",
+ * });
+ * ```
+ *
+ * @example Adopt an already-initialized engine
+ * ```typescript
+ * // Adoption makes the swarm part of the stack — destroy then dissolves
+ * // the node's membership.
+ * const swarm = yield* Docker.Swarm("swarm").pipe(adopt(true));
+ * ```
+ *
+ * @section Deploying into the Swarm
+ * @example Service ordered after the swarm
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * const web = yield* Docker.Service("web", {
+ *   context: swarm,
+ *   image: "nginx:alpine",
+ *   replicas: 2,
+ *   ports: [{ external: 8080, internal: 80 }],
+ * });
+ * ```
+ */
+export declare const Swarm: import("../Resource.ts").ResourceClass<Swarm>;
+export declare const SwarmProvider: () => import("effect/Layer").Layer<Provider.Provider<Swarm>, never, Docker>;
+//# sourceMappingURL=Swarm.d.ts.map

package/lib/Docker/Swarm.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Swarm.d.ts","sourceRoot":"","sources":["../../src/Docker/Swarm.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,MAAM,EAAqB,MAAM,aAAa,CAAC;AACxD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAC5B;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,KAAM,SAAQ,QAAQ,CACrC,cAAc,EACd,UAAU,EACV;IACE,wBAAwB;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,+BAA+B;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,KAAK,EAAE,MAAM,CAAC;CACf,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqEG;AACH,eAAO,MAAM,KAAK,+CAAkC,CAAC;AAErD,eAAO,MAAM,aAAa,6EAuFvB,CAAC"}

package/lib/Docker/Swarm.js

@@ -0,0 +1,149 @@
+import * as Effect from "effect/Effect";
+import { Unowned } from "../AdoptPolicy.js";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { Docker, dockerContextName } from "./Docker.js";
+/**
+ * Swarm mode on a Docker engine — an idempotent `docker swarm init`.
+ *
+ * Turns the engine behind the given `context` (or the local engine) into a
+ * single-node swarm: the node becomes a manager that can run `Docker.Service`
+ * workloads. Regular (non-swarm) docker usage of the engine is unaffected.
+ *
+ * Pass the swarm as the `context` of a `Docker.Service` or overlay
+ * `Docker.Network`: the workload then deploys after the swarm exists and
+ * inherits its Docker context.
+ *
+ * An engine that is already in swarm mode is treated as foreign — adopt it
+ * with `adopt(true)` (or `--adopt`) to manage it. Destroying the resource
+ * dissolves the node's swarm membership (`docker swarm leave --force`),
+ * which stops every service running on it — services managed by the same
+ * stack are destroyed first via their dependency edges.
+ *
+ * Growing the cluster beyond one node is host-level setup: run
+ * `docker swarm join --token <token> <manager-ip>:2377` on each additional
+ * machine (`docker swarm join-token worker` on the manager prints the
+ * command). Alchemy manages the swarm's workloads through the manager.
+ * @resource
+ * @section Creating a Swarm
+ * @example Local single-node swarm
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * ```
+ *
+ * @example Remote engine over SSH
+ * ```typescript
+ * const vps = yield* Docker.Context("vps", {
+ *   docker: "host=ssh://deploy@example.com",
+ * });
+ * const swarm = yield* Docker.Swarm("swarm", {
+ *   context: vps,
+ *   advertiseAddr: "10.0.0.1",
+ * });
+ * ```
+ *
+ * @section Using an Existing Swarm
+ * @example Reference without owning
+ * ```typescript
+ * // Services don't require a Swarm resource — point them at an engine that
+ * // is already a manager and the swarm's lifecycle stays external: destroy
+ * // removes the services, never the swarm.
+ * const web = yield* Docker.Service("web", {
+ *   context: vps,
+ *   image: "nginx:alpine",
+ * });
+ * ```
+ *
+ * @example Adopt an already-initialized engine
+ * ```typescript
+ * // Adoption makes the swarm part of the stack — destroy then dissolves
+ * // the node's membership.
+ * const swarm = yield* Docker.Swarm("swarm").pipe(adopt(true));
+ * ```
+ *
+ * @section Deploying into the Swarm
+ * @example Service ordered after the swarm
+ * ```typescript
+ * const swarm = yield* Docker.Swarm("swarm");
+ * const web = yield* Docker.Service("web", {
+ *   context: swarm,
+ *   image: "nginx:alpine",
+ *   replicas: 2,
+ *   ports: [{ external: 8080, internal: 80 }],
+ * });
+ * ```
+ */
+export const Swarm = Resource("Docker.Swarm");
+export const SwarmProvider = () => Provider.effect(Swarm, Effect.gen(function* () {
+    const docker = yield* Docker;
+    /** Active-manager info, or undefined when the engine isn't one. */
+    const observe = Effect.fn(function* (context) {
+        const info = yield* docker.swarm.info(context);
+        if (info.LocalNodeState !== "active" ||
+            !info.ControlAvailable ||
+            !info.Cluster?.ID) {
+            return undefined;
+        }
+        return info;
+    });
+    return Swarm.Provider.of({
+        list: () => Effect.succeed([]),
+        read: Effect.fn(function* ({ olds, output }) {
+            const context = dockerContextName(olds?.context);
+            const info = yield* observe(context);
+            if (!info)
+                return undefined;
+            const attrs = toSwarmAttributes(info, context);
+            if (output)
+                return attrs;
+            // A swarm carries no labels to brand, so an already-initialized
+            // engine can never be proven ours — adoption is gated behind
+            // `--adopt` / `adopt(true)`.
+            return Unowned(attrs);
+        }),
+        diff: Effect.fn(function* ({ news, olds }) {
+            if (!isResolved(news))
+                return undefined;
+            if (dockerContextName(olds?.context) !==
+                dockerContextName(news?.context)) {
+                return { action: "replace", deleteFirst: true };
+            }
+            // The remaining props only apply at `swarm init`; changing them on
+            // a live swarm is a no-op rather than a destructive re-init.
+            return { action: "noop" };
+        }),
+        reconcile: Effect.fn(function* ({ news }) {
+            const context = dockerContextName(news?.context);
+            const existing = yield* observe(context);
+            if (existing)
+                return toSwarmAttributes(existing, context);
+            yield* docker.swarm
+                .init({
+                context,
+                "advertise-addr": news?.advertiseAddr,
+                "listen-addr": news?.listenAddr,
+                "default-addr-pool": news?.defaultAddrPool,
+                "default-addr-pool-mask-length": news?.subnetSize,
+            })
+                .pipe(
+            // A concurrent init (or an interrupted prior reconcile) already
+            // made this node a swarm member — converge on the observation.
+            Effect.catchIf((error) => /already part of a swarm/i.test(String(error)), () => Effect.void));
+            const info = yield* observe(context);
+            if (!info) {
+                return yield* Effect.die(new Error("docker swarm init succeeded but the engine did not become an active swarm manager"));
+            }
+            return toSwarmAttributes(info, context);
+        }),
+        delete: Effect.fn(({ output }) => docker.swarm.leave(true, output.context).pipe(Effect.catchIf((error) => /not part of a swarm/i.test(String(error)), () => Effect.void), Effect.asVoid)),
+    });
+}));
+const toSwarmAttributes = (info, context) => ({
+    id: info.Cluster.ID,
+    nodeId: info.NodeID,
+    context,
+    managers: info.Managers ?? 1,
+    nodes: info.Nodes ?? 1,
+});
+//# sourceMappingURL=Swarm.js.map

package/lib/Docker/Swarm.js.map

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

package/lib/Docker/Volume.d.ts

@@ -21,6 +21,8 @@ export interface VolumeProps {
     driverOpts?: Record<string, string>;
     /** Custom metadata labels. */
     labels?: Record<string, string>;
+    /** Docker context name or context resource. */
+    context?: Docker.ContextRef;
 }
 export interface Volume extends Resource<"Docker.Volume", VolumeProps, {
     /** Docker volume name. */
@@ -74,6 +76,15 @@ export interface Volume extends Resource<"Docker.Volume", VolumeProps, {
  *   },
  * });
  * ```
+ *
+ * @section Docker Context
+ * @example Create a volume in a named Docker context
+ * ```typescript
+ * const data = yield* Docker.Volume("data", {
+ *   name: "app-data",
+ *   context: "remote-build",
+ * });
+ * ```
  */
 export declare const Volume: import("../Resource.ts").ResourceClass<Volume>;
 export declare const VolumeProvider: () => import("effect/Layer").Layer<Provider.Provider<Volume>, never, Docker | import("../Stack.ts").Stack | import("../Stage.ts").Stage>;

package/lib/Docker/Volume.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Volume.d.ts","sourceRoot":"","sources":["../../src/Docker/Volume.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EAAE,MAAM,EAAsB,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ,CACtC,eAAe,EACf,WAAW,EACX;IACE,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,MAAM,gDAAoC,CAAC;AAExD,eAAO,MAAM,cAAc,0IAyExB,CAAC;AAcJ,eAAO,MAAM,kBAAkB,SACvB,MAAM,CAAC,MAAM,KAClB,MAAM,CAAC,YAAY,CAQpB,CAAC"}
+{"version":3,"file":"Volume.d.ts","sourceRoot":"","sources":["../../src/Docker/Volume.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAM1C,OAAO,EAAE,MAAM,EAAyC,MAAM,aAAa,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,WAAW,WAAW;IAC1B,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,+CAA+C;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CAC7B;AAED,MAAM,WAAW,MAAO,SAAQ,QAAQ,CACtC,eAAe,EACf,WAAW,EACX;IACE,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,iCAAiC;IACjC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,4BAA4B;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sDAAsD;IACtD,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,KAAK,EACL,SAAS,CACV;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,eAAO,MAAM,MAAM,gDAAoC,CAAC;AAExD,eAAO,MAAM,cAAc,0IAiFxB,CAAC;AAcJ,eAAO,MAAM,kBAAkB,SACvB,MAAM,CAAC,MAAM,KAClB,MAAM,CAAC,YAAY,CAQpB,CAAC"}