@alchemy.run/effect-cluster 0.0.0-stage → 2.0.0-beta.86

package/lib/Cloudflare/internal/Objects.js

@@ -0,0 +1,102 @@
+/**
+ * The Durable Object classes a `ClusterCloudflare.DurableObjectPool` Worker
+ * exports. Every entity type shares one class, `ClusterEntity`, whose objects
+ * are named by `(type, id)`; every workflow shares `ClusterWorkflow`, one
+ * object per execution; every singleton and cron shares `ClusterScheduled`,
+ * one object per name. What each object runs is host-neutral (see
+ * `internal/ObjectSharding.ts`); this module gives it workerd's storage.
+ *
+ * @internal
+ */
+import * as Cloudflare from "@alchemy.run/cloudflare/Workers";
+import { makeDurableObjectEngine } from "alchemy/Workers/DurableObjectEngine";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Predicate from "effect/Predicate";
+import { InstanceStorage } from "../../Host.js";
+import { makeEntityObject, makeScheduledObject, NotHosted, registry, workflowClassOf, workflowObjectName, } from "../../internal/ObjectSharding.js";
+/** Cloudflare, as a host of the cluster's objects. */
+export const host = {
+    group: "cloudflare",
+    // workerd marks a transient failure `retryable`, and an `overloaded`
+    // object wants less traffic, not more.
+    isRetryable: (error) => Predicate.hasProperty(error, "cause") &&
+        Predicate.hasProperty(error.cause, "retryable") &&
+        error.cause.retryable === true &&
+        !(Predicate.hasProperty(error.cause, "overloaded") && error.cause.overloaded === true),
+};
+/** The most bytes workerd's SQLite stores in one value. */
+const MAX_ENCODED_BYTES = 2 * 1024 * 1024;
+const objectName = (state) => state.id.name ?? "";
+/**
+ * The object's storage, called directly: a statement is one synchronous
+ * call, so the mailbox costs no event-loop turns.
+ */
+const storageOf = (state) => {
+    const storage = state.raw.storage;
+    return {
+        exec: (query, ...bindings) => Effect.sync(() => storage.sql.exec(query, ...bindings).toArray()),
+        // Every statement is synchronous, so the transaction is too.
+        transaction: (effect) => Effect.sync(() => storage.transactionSync(() => Effect.runSync(effect))),
+        getAlarm: Effect.promise(() => storage.getAlarm()),
+        setAlarm: (at) => Effect.promise(() => storage.setAlarm(at)),
+    };
+};
+/** Every entity instance: one object per `(type, id)`. */
+export const EntityObject = Cloudflare.DurableObject()("ClusterEntity", Effect.gen(function* () {
+    const state = yield* Cloudflare.DurableObjectState;
+    return Effect.gen(function* () {
+        const runtime = yield* Effect.context();
+        return yield* makeEntityObject({
+            name: objectName(state),
+            host,
+            storage: storageOf(state),
+            // The object's own key-value storage, for platforms built on
+            // entities (a Domain model's) to keep each instance's data in.
+            runtime: Context.add(runtime, InstanceStorage, state.storage),
+            maxEncodedBytes: MAX_ENCODED_BYTES,
+            waitUntil: (effect) => state.waitUntil(effect).pipe(Effect.provideContext(runtime)),
+        });
+    });
+}));
+/** Every singleton and cron: one object per name. */
+export const ScheduledObject = Cloudflare.DurableObject()("ClusterScheduled", Effect.gen(function* () {
+    const state = yield* Cloudflare.DurableObjectState;
+    return Effect.gen(function* () {
+        const runtime = yield* Effect.context();
+        return yield* makeScheduledObject({
+            name: objectName(state),
+            storage: storageOf(state),
+            runtime,
+        });
+    });
+}));
+/**
+ * Every workflow execution: one object per `(workflow, execution)`, running
+ * Alchemy's Durable Object workflow engine. The engine declares a class per
+ * workflow; here each of those is a view onto this one class, so the Worker
+ * exports the same classes whatever workflows it hosts.
+ */
+export const WorkflowObject = Cloudflare.DurableObject()("ClusterWorkflow", Effect.gen(function* () {
+    const state = yield* Cloudflare.DurableObjectState;
+    return Effect.gen(function* () {
+        const className = workflowClassOf(objectName(state));
+        const impl = registry.workflows.get(className);
+        if (impl === undefined) {
+            return yield* Effect.die(new NotHosted({ message: `This Worker hosts no Cluster.Workflow '${className}'.` }));
+        }
+        const object = yield* impl.pipe(Effect.provideService(Cloudflare.DurableObjectState, state));
+        return (yield* object.pipe(Effect.provideService(Cloudflare.DurableObjectState, state)));
+    });
+}));
+/** The workflow engine, its executions on {@link WorkflowObject}. */
+export const workflowEngine = (objects) => makeDurableObjectEngine({
+    declare: (className, impl) => Effect.sync(() => {
+        registry.workflows.set(className, impl);
+        return {
+            getByName: (executionId) => objects().getByName(workflowObjectName(className, executionId)),
+        };
+    }),
+    state: Cloudflare.DurableObjectState,
+});
+//# sourceMappingURL=Objects.js.map

package/lib/Cloudflare/internal/Objects.js.map

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

package/lib/Cron.d.ts

@@ -0,0 +1,143 @@
+import type { InputProps } from "alchemy/Input";
+import type { Named } from "alchemy/Named";
+import type { PlatformIdentity, PlatformServices } from "alchemy/Platform";
+import type { RuntimeContext } from "alchemy/RuntimeContext";
+import type { Self } from "alchemy/Self";
+import type { ClusterCron } from "effect/cluster";
+import type * as ConfigError from "effect/Config";
+import type * as Context from "effect/Context";
+import * as Cron_ from "effect/Cron";
+import type * as Duration from "effect/Duration";
+import * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import type { Scope } from "effect/Scope";
+import { type HostedProps, type HostedResource } from "./internal/HostedPlatform.ts";
+import type { Providers } from "./Providers.ts";
+export declare const CronTypeId = "Cluster.Cron";
+export type CronTypeId = typeof CronTypeId;
+/** When a cron runs: its Layer's props, like Effect's `ClusterCron.make` options. */
+export interface CronProps extends HostedProps {
+    /**
+     * The schedule, as a cron expression with an optional leading seconds
+     * field: `"0 3 * * *"`, `"*\/10 * * * * *"`.
+     */
+    cron: string;
+    /** The time zone the expression is read in. @default UTC */
+    timeZone?: string;
+    /**
+     * Compute each run from the previous run's scheduled time rather than
+     * from when it finished.
+     * @default false
+     */
+    calculateNextRunFromPrevious?: boolean;
+    /** Skip a run that is due longer ago than this, as after an outage. */
+    skipIfOlderThan?: Duration.Input;
+}
+export interface ClusterCronResource extends HostedResource<CronTypeId, CronProps> {
+}
+/**
+ * A cron as a runner runs it: its schedule, the job its Construction phase
+ * returned, and the services that phase ran with.
+ * @internal
+ */
+export interface HostedCron {
+    readonly kind: "cron";
+    readonly name: string;
+    readonly cron: Cron_.Cron;
+    readonly options: Pick<CronProps, "calculateNextRunFromPrevious" | "skipIfOlderThan">;
+    readonly run: Effect.Effect<void, unknown, Scope | ClusterCron.CurrentScheduledTime>;
+    readonly context: Context.Context<never>;
+}
+declare const InvalidCron_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "Cluster.InvalidCron";
+} & Readonly<A>;
+/** A cron expression that doesn't parse. */
+export declare class InvalidCron extends InvalidCron_base<{
+    readonly message: string;
+}> {
+}
+type CronServices = ClusterCronResource | Providers | RuntimeContext | Self | Self<ClusterCronResource>;
+/** The resource type behind every cron, which the providers register. @internal */
+export declare const CronResource: import("alchemy").Platform<HostedResource<"Cluster.Cron", CronProps>, any, unknown, import("./internal/HostedRuntime.ts").HostedRuntimeContext<HostedCron>, {}, CronProps>;
+export declare const CronProvider: () => Layer.Layer<import("alchemy").Provider<HostedResource<"Cluster.Cron", CronProps>>, never, never>;
+/** A declared cron, implemented by `.make(props, impl)`. */
+export type CronTag<Self, Name extends string> = Named<Name> & PlatformIdentity<Name> & {
+    /**
+     * The cron's implementation, as a Layer: its schedule, and an Effect
+     * that resolves bindings once per runner and returns the job to run.
+     * Provide a pool Layer to `impl` to deploy it; provide the returned
+     * Layer to the Stack.
+     */
+    make<InitReq = never>(props: InputProps<CronProps>, impl: Effect.Effect<Effect.Effect<void, unknown, Scope | ClusterCron.CurrentScheduledTime>, ConfigError.ConfigError, InitReq>): Layer.Layer<Self, never, Providers | Exclude<InitReq, CronServices | PlatformServices>>;
+    new (_: never): {};
+};
+/** A cron declared with its implementation: the class is what deploys it. */
+export type CronInline<Name extends string, Req> = Effect.Effect<ClusterCronResource, never, Req> & Named<Name> & PlatformIdentity<Name> & {
+    new (_: never): {};
+};
+/** The class surface of {@link Cron}. */
+export interface CronClass {
+    <Self>(): {
+        /**
+         * Declared with its implementation: an Effect that resolves bindings
+         * once per runner and returns the job. Provide a pool Layer to
+         * `impl` to deploy it; `yield*` the class in the Stack.
+         */
+        <const Name extends string, InitReq = never>(name: Name, props: InputProps<CronProps>, impl: Effect.Effect<Effect.Effect<void, unknown, Scope | ClusterCron.CurrentScheduledTime>, ConfigError.ConfigError, InitReq>): CronInline<Name, Providers | Exclude<InitReq, CronServices | PlatformServices>>;
+        /** A bare declaration, implemented by `.make(props, impl)`. */
+        <const Name extends string>(name: Name): CronTag<Self, Name>;
+    };
+}
+/**
+ * A **Cron** on an Effect Cluster: a job that runs on a schedule, once per
+ * scheduled time across the cluster, on whichever runner owns it. Each run
+ * is a persisted message, so a run due while its runner restarts still
+ * happens.
+ *
+ * Declare it by name, with its schedule, as Effect's `ClusterCron.make`
+ * takes it, and its implementation: an Effect that resolves bindings once
+ * per runner and returns the job. The job can read the time it was
+ * scheduled for with `ClusterCron.CurrentScheduledTime`. Providing a pool
+ * Layer to the implementation is what deploys it. Or declare it bare and
+ * implement it with `.make(props, impl)`, as a Layer.
+ *
+ * ### Declaring a cron
+ * **Example:** A nightly job
+ * ```typescript
+ * // src/Nightly.ts
+ * export default class Nightly extends Cluster.Cron<Nightly>()(
+ *   "Nightly",
+ *   { main: import.meta.url, cron: "0 3 * * *", skipIfOlderThan: "1 hour" },
+ *   Effect.gen(function* () {
+ *     const counters = yield* Counter;
+ *     return Effect.gen(function* () {
+ *       const counter = yield* counters.getByName("nightly");
+ *       yield* counter.Increment({ amount: 1 });
+ *     }).pipe(Effect.orDie);
+ *   }).pipe(Effect.provide(Default)),
+ * ) {}
+ * ```
+ *
+ * **Example:** Declared bare, and implemented as a Layer
+ * ```typescript
+ * // src/Nightly.ts
+ * export class Nightly extends Cluster.Cron<Nightly>()("Nightly") {}
+ *
+ * // src/NightlyLive.ts
+ * export default Nightly.make(
+ *   { main: import.meta.url, cron: "0 3 * * *", skipIfOlderThan: "1 hour" },
+ *   Effect.gen(function* () {
+ *     const counters = yield* Counter;
+ *     return Effect.gen(function* () {
+ *       const counter = yield* counters.getByName("nightly");
+ *       yield* counter.Increment({ amount: 1 });
+ *     }).pipe(Effect.orDie);
+ *   }).pipe(Effect.provide(Default)),
+ * );
+ * ```
+ *
+ * @resource
+ */
+export declare const Cron: CronClass;
+export {};
+//# sourceMappingURL=Cron.d.ts.map

package/lib/Cron.d.ts.map

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

package/lib/Cron.js

@@ -0,0 +1,83 @@
+import * as Cron_ from "effect/Cron";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Result from "effect/Result";
+import { makeHostedPlatform, } from "./internal/HostedPlatform.js";
+export const CronTypeId = "Cluster.Cron";
+/** A cron expression that doesn't parse. */
+export class InvalidCron extends Data.TaggedError("Cluster.InvalidCron") {
+}
+const { platform, provider, declare } = makeHostedPlatform(CronTypeId, (id, run, context, props) => ({
+    kind: "cron",
+    name: id,
+    // Checked while deploying, so it parses.
+    cron: Cron_.parse(props.cron, props.timeZone).success,
+    options: {
+        calculateNextRunFromPrevious: props.calculateNextRunFromPrevious,
+        skipIfOlderThan: props.skipIfOlderThan,
+    },
+    run: run,
+    context,
+}), 
+// A schedule that doesn't parse fails the deploy, not the runner.
+(id, _context, props) => {
+    const cron = Cron_.parse(props.cron, props.timeZone);
+    return Result.isSuccess(cron)
+        ? Effect.void
+        : Effect.die(new InvalidCron({ message: `Cluster.Cron '${id}': ${cron.failure.message}` }));
+});
+/** The resource type behind every cron, which the providers register. @internal */
+export const CronResource = platform;
+export const CronProvider = provider;
+/**
+ * A **Cron** on an Effect Cluster: a job that runs on a schedule, once per
+ * scheduled time across the cluster, on whichever runner owns it. Each run
+ * is a persisted message, so a run due while its runner restarts still
+ * happens.
+ *
+ * Declare it by name, with its schedule, as Effect's `ClusterCron.make`
+ * takes it, and its implementation: an Effect that resolves bindings once
+ * per runner and returns the job. The job can read the time it was
+ * scheduled for with `ClusterCron.CurrentScheduledTime`. Providing a pool
+ * Layer to the implementation is what deploys it. Or declare it bare and
+ * implement it with `.make(props, impl)`, as a Layer.
+ *
+ * ### Declaring a cron
+ * **Example:** A nightly job
+ * ```typescript
+ * // src/Nightly.ts
+ * export default class Nightly extends Cluster.Cron<Nightly>()(
+ *   "Nightly",
+ *   { main: import.meta.url, cron: "0 3 * * *", skipIfOlderThan: "1 hour" },
+ *   Effect.gen(function* () {
+ *     const counters = yield* Counter;
+ *     return Effect.gen(function* () {
+ *       const counter = yield* counters.getByName("nightly");
+ *       yield* counter.Increment({ amount: 1 });
+ *     }).pipe(Effect.orDie);
+ *   }).pipe(Effect.provide(Default)),
+ * ) {}
+ * ```
+ *
+ * **Example:** Declared bare, and implemented as a Layer
+ * ```typescript
+ * // src/Nightly.ts
+ * export class Nightly extends Cluster.Cron<Nightly>()("Nightly") {}
+ *
+ * // src/NightlyLive.ts
+ * export default Nightly.make(
+ *   { main: import.meta.url, cron: "0 3 * * *", skipIfOlderThan: "1 hour" },
+ *   Effect.gen(function* () {
+ *     const counters = yield* Counter;
+ *     return Effect.gen(function* () {
+ *       const counter = yield* counters.getByName("nightly");
+ *       yield* counter.Increment({ amount: 1 });
+ *     }).pipe(Effect.orDie);
+ *   }).pipe(Effect.provide(Default)),
+ * );
+ * ```
+ *
+ * @resource
+ */
+export const Cron = (() => (name, props, impl) => declare(name, {}, props, impl));
+//# sourceMappingURL=Cron.js.map

package/lib/Cron.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Cron.js","sources":["../src/Cron.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,KAAK,MAAM,aAAa,CAAC;AACrC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAEpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,EAGL,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AAGtC,MAAM,CAAC,MAAM,UAAU,GAAG,cAAc,CAAC;AAsCzC,4CAA4C;AAC5C,MAAM,OAAO,WAAY,SAAQ,IAAI,CAAC,WAAW,CAAC,qBAAqB,CAErE;CAAG;AASL,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,kBAAkB,CACxD,UAAU,EACV,CAAC,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC5B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,EAAE;IACR,yCAAyC;IACzC,IAAI,EAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAuC,CAAC,OAAO;IAC5F,OAAO,EAAE;QACP,4BAA4B,EAAE,KAAK,CAAC,4BAA4B;QAChE,eAAe,EAAE,KAAK,CAAC,eAAe;KACvC;IACD,GAAG,EAAE,GAAwB;IAC7B,OAAO;CACR,CAAC;AACF,kEAAkE;AAClE,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE;IACtB,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrD,OAAO,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC;QAC3B,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,WAAW,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAChG,CAAC,CACF,CAAC;AAEF,mFAAmF;AACnF,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AACrC,MAAM,CAAC,MAAM,YAAY,GAAG,QAAQ,CAAC;AAoDrC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,MAAM,CAAC,MAAM,IAAI,GAAc,CAAC,GAAG,EAAE,CACnC,CAAC,IAAY,EAAE,KAA6B,EAAE,IAAc,EAAE,EAAE,CAC9D,OAAO,CAAC,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,CAAyB,CAAC"}

package/lib/Database.d.ts

@@ -0,0 +1,95 @@
+import type { Input } from "alchemy/Input";
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import type { Providers } from "./Providers.ts";
+import { ShardGroups } from "./ShardGroups.ts";
+/**
+ * The private network runners must join to reach the database and each
+ * other. A pool Layer matches on `kind` and refuses a network it cannot
+ * join.
+ */
+export type ClusterNetwork = {
+    /** A Docker network; runner containers join it by name. */
+    readonly kind: "docker";
+    readonly name: Input<string>;
+} | {
+    /** An AWS VPC; runners run in its subnets, in the pool's security group. */
+    readonly kind: "aws";
+    readonly vpcId: Input<string>;
+    readonly subnetIds: Input<string>[];
+    /** The group every runner joins: it reaches the database and the other runners. */
+    readonly securityGroupId: Input<string>;
+} | {
+    /** A Fly private network; runners' Apps join it by name. */
+    readonly kind: "fly";
+    readonly network: Input<string>;
+} | {
+    /** A Hetzner private Network; runners' Servers attach to it. */
+    readonly kind: "hetzner";
+    readonly networkId: Input<number>;
+    /** Its IPv4 range, where each runner finds its own address. */
+    readonly ipRange: string;
+    readonly location: string;
+} | {
+    /** A GCP VPC; runners' instances join its subnetwork. */
+    readonly kind: "gcp";
+    readonly network: Input<string>;
+    readonly subnetwork: Input<string>;
+    readonly region: string;
+    /** The subnetwork's IPv4 range, where each runner finds its own address. */
+    readonly cidr: string;
+    /** The network tag every runner carries: it reaches the database and the other runners. */
+    readonly tag: string;
+} | {
+    /** A Kubernetes cluster; runners run as a Deployment in its namespace. */
+    readonly kind: "kubernetes";
+    /** The cluster, as `@alchemy.run/kubernetes` takes it. */
+    readonly cluster: unknown;
+    readonly namespace: string;
+};
+/** What every database Layer gives the pool it is provided to. */
+export interface DatabaseShape {
+    /**
+     * The Postgres connection URL runners use for runner registration,
+     * shard locks and persisted messages.
+     */
+    readonly url: Input<Redacted.Redacted<string>>;
+    /** The network runners join to reach it, when it is private. */
+    readonly network?: ClusterNetwork;
+    /** Every shard group in the cluster, which each pool registers with. */
+    readonly shardGroups: ShardGroups;
+}
+declare const Database_base: Context.ServiceClass<Database, "Cluster.Database", DatabaseShape>;
+/**
+ * The database an Effect Cluster coordinates through: runners register in
+ * it, lock their shards in it, and keep persisted messages in it. Each
+ * host's `Database` Layer provides it.
+ */
+export declare class Database extends Database_base {
+}
+export interface DatabaseProps {
+    /** A Postgres connection URL. */
+    url: Redacted.Redacted<string> | Config.Config<Redacted.Redacted<string>>;
+}
+/**
+ * A Postgres database you already run, as an Effect Cluster `Database`
+ * Layer: Neon, PlanetScale, RDS, or any Postgres the pool can reach.
+ *
+ * ### Using an existing database
+ * **Example:** A Postgres URL from config
+ * ```typescript
+ * export const Database = Cluster.Database.fromUrl({
+ *   url: Config.Redacted("CLUSTER_DATABASE_URL"),
+ * });
+ * ```
+ *
+ * @primitive
+ */
+export declare const fromUrl: (props: DatabaseProps) => Layer.Layer<Database, Config.ConfigError, Providers>;
+/** The shard groups resource every database Layer declares for its cluster. @internal */
+export declare const clusterShardGroups: (id: string) => Effect.Effect<ShardGroups, never, Providers>;
+export {};
+//# sourceMappingURL=Database.d.ts.map

package/lib/Database.d.ts.map

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

package/lib/Database.js

@@ -0,0 +1,38 @@
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { ShardGroups } from "./ShardGroups.js";
+/**
+ * The database an Effect Cluster coordinates through: runners register in
+ * it, lock their shards in it, and keep persisted messages in it. Each
+ * host's `Database` Layer provides it.
+ */
+export class Database extends Context.Service()("Cluster.Database") {
+}
+/**
+ * A Postgres database you already run, as an Effect Cluster `Database`
+ * Layer: Neon, PlanetScale, RDS, or any Postgres the pool can reach.
+ *
+ * ### Using an existing database
+ * **Example:** A Postgres URL from config
+ * ```typescript
+ * export const Database = Cluster.Database.fromUrl({
+ *   url: Config.Redacted("CLUSTER_DATABASE_URL"),
+ * });
+ * ```
+ *
+ * @primitive
+ */
+export const fromUrl = (props) => Layer.effect(Database, Effect.gen(function* () {
+    if (globalThis.__ALCHEMY_RUNTIME__) {
+        // Runners read their database from their own environment at runtime.
+        return { url: Redacted.make(""), shardGroups: undefined };
+    }
+    const url = Config.isConfig(props.url) ? yield* props.url : props.url;
+    return { url, shardGroups: yield* clusterShardGroups("Database") };
+}));
+/** The shard groups resource every database Layer declares for its cluster. @internal */
+export const clusterShardGroups = (id) => ShardGroups(`${id}ShardGroups`, {});
+//# sourceMappingURL=Database.js.map

package/lib/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sources":["../src/Database.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAkE/C;;;;GAIG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAA2B,CAAC,kBAAkB,CAAC;CAAG;AAO/F;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,KAAoB,EACkC,EAAE,CACxD,KAAK,CAAC,MAAM,CACV,QAAQ,EACR,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,IAAI,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACnC,qEAAqE;QACrE,OAAO,EAAE,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,WAAW,EAAE,SAAkB,EAAE,CAAC;IACrE,CAAC;IACD,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC;IACtE,OAAO,EAAE,GAAG,EAAE,WAAW,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,UAAU,CAAC,EAAE,CAAC;AACrE,CAAC,CAAC,CACH,CAAC;AAEJ,yFAAyF;AACzF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,EAAU,EAAE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,EAAE,CAAC,CAAC"}

package/lib/Docker/Database.d.ts

@@ -0,0 +1,42 @@
+import * as Docker from "@alchemy.run/docker";
+import * as Layer from "effect/Layer";
+import { Database as ClusterDatabase } from "../Database.ts";
+import type { Providers } from "../Providers.ts";
+/** The Postgres release `ClusterDocker.Database` runs by default. */
+export declare const DEFAULT_POSTGRES_IMAGE = "postgres:17-alpine";
+export interface DatabaseProps {
+    /**
+     * Postgres image.
+     * @default "postgres:17-alpine"
+     */
+    image?: string;
+    /**
+     * Publish Postgres on this host port, to inspect it from your machine.
+     * @default not published
+     */
+    port?: number;
+    /**
+     * The Docker engine to run on: a context name, a `Docker.Context`, or a
+     * `Docker.Swarm`.
+     * @default the current Docker context
+     */
+    context?: Docker.Docker.EngineRef;
+}
+/**
+ * The database an Effect Cluster coordinates through, on a Docker swarm, as
+ * an `Cluster.Database` Layer: Postgres as a one-replica swarm service
+ * with its data on a named volume, on an overlay network the pool's runners join.
+ * The Docker engine must be in swarm mode (`docker swarm init`).
+ *
+ * One Postgres on one disk is meant for development and tests.
+ *
+ * ### Running a local database
+ * **Example:** Postgres for local entities
+ * ```typescript
+ * export const Database = ClusterDocker.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export declare const Database: (id: string, props?: DatabaseProps) => Layer.Layer<ClusterDatabase, never, Providers | Docker.Providers>;
+//# sourceMappingURL=Database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sources":["../../src/Docker/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,qBAAqB,CAAC;AAI9C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAsB,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,qEAAqE;AACrE,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAE3D,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC;CACnC;AAED;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,QAAQ,OACf,MAAM,UACH,aAAa,KACnB,KAAK,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC,SAAS,CA2ChE,CAAC"}

package/lib/Docker/Database.js

@@ -0,0 +1,53 @@
+import * as Docker from "@alchemy.run/docker";
+import * as Output from "alchemy/Output";
+import { Random } from "alchemy/Random";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Redacted from "effect/Redacted";
+import { clusterShardGroups, Database as ClusterDatabase } from "../Database.js";
+/** The Postgres release `ClusterDocker.Database` runs by default. */
+export const DEFAULT_POSTGRES_IMAGE = "postgres:17-alpine";
+/**
+ * The database an Effect Cluster coordinates through, on a Docker swarm, as
+ * an `Cluster.Database` Layer: Postgres as a one-replica swarm service
+ * with its data on a named volume, on an overlay network the pool's runners join.
+ * The Docker engine must be in swarm mode (`docker swarm init`).
+ *
+ * One Postgres on one disk is meant for development and tests.
+ *
+ * ### Running a local database
+ * **Example:** Postgres for local entities
+ * ```typescript
+ * export const Database = ClusterDocker.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export const Database = (id, props = {}) => Layer.effect(ClusterDatabase, Effect.gen(function* () {
+    if (globalThis.__ALCHEMY_RUNTIME__) {
+        // Runners read their database from their own environment at runtime.
+        return { url: Redacted.make(""), shardGroups: undefined };
+    }
+    const context = props.context === undefined ? {} : { context: props.context };
+    const password = yield* Random(`${id}Password`, { bytes: 24 });
+    const network = yield* Docker.Network(`${id}Network`, { driver: "overlay", ...context });
+    const volumeContext = Docker.dockerEngineContextName(props.context);
+    const data = yield* Docker.Volume(`${id}Data`, volumeContext === undefined ? {} : { context: volumeContext });
+    const alias = "cluster-db";
+    const db = yield* Docker.Service(`${id}Postgres`, {
+        image: props.image ?? DEFAULT_POSTGRES_IMAGE,
+        ...context,
+        environment: { POSTGRES_PASSWORD: password.text, POSTGRES_DB: "cluster" },
+        ports: props.port === undefined ? [] : [{ external: props.port, internal: 5432 }],
+        volumes: [{ hostPath: data.name, containerPath: "/var/lib/postgresql/data" }],
+        networks: [{ name: network.name, aliases: [alias] }],
+        replicas: 1,
+    });
+    return {
+        // Ordered after the service: runners connect once it exists.
+        url: Output.all(db.name, password.text).pipe(Output.map(([, text]) => Redacted.make(`postgres://postgres:${encodeURIComponent(text.pipe(Redacted.value))}@${alias}:5432/cluster`))),
+        network: { kind: "docker", name: network.name },
+        shardGroups: yield* clusterShardGroups(id),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/Docker/Database.js.map

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

package/lib/Docker/SwarmPool.d.ts

@@ -0,0 +1,44 @@
+import * as Docker from "@alchemy.run/docker";
+import type { Stack } from "alchemy/Stack";
+import type * as Layer from "effect/Layer";
+import type { Database } from "../Database.ts";
+import { type PoolSettings } from "../internal/PoolHost.ts";
+import type { PoolHost } from "../internal/PoolHostService.ts";
+import type { Providers } from "../Providers.ts";
+export interface SwarmPoolOptions extends PoolSettings {
+    /**
+     * Number of runners.
+     * @default 1
+     */
+    replicas?: number;
+    /**
+     * Publish the gateway on this host port, so code outside the swarm (a
+     * test, a script) can call the entities at `http://localhost:<port>`.
+     * @default not published
+     */
+    gatewayPort?: number;
+}
+/**
+ * Run a pool of Effect Cluster runners on a Docker swarm: a swarm service whose
+ * tasks host every `Cluster.Entity` given this pool, on the
+ * database's overlay network. Runners find each other through the
+ * database and talk on the network; the gateway is served on the same
+ * network. Requires an `Cluster.Database` on a Docker network —
+ * `ClusterDocker.Database`.
+ *
+ * Every entity given the same pool shares it: declare the pool once
+ * and provide them to each class.
+ *
+ * ### Running entities on Docker
+ * **Example:** Two runners on the local swarm
+ * ```typescript
+ * export const Database = ClusterDocker.Database("Cluster");
+ * export const Default = ClusterDocker.SwarmPool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export declare const SwarmPool: (id: string, options?: SwarmPoolOptions) => Layer.Layer<PoolHost, never, Database | Stack | Providers | Docker.Providers>;
+//# sourceMappingURL=SwarmPool.d.ts.map