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

package/lib/internal/PoolHost.d.ts

@@ -0,0 +1,80 @@
+import type { Input } from "alchemy/Input";
+import * as Output from "alchemy/Output";
+import { Stack } from "alchemy/Stack";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Database, type DatabaseShape } from "../Database.ts";
+import { Pool } from "../Pool.ts";
+import type { Providers } from "../Providers.ts";
+import { PoolHost } from "./PoolHostService.ts";
+declare const DatabaseNetworkMismatch_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.DatabaseNetworkMismatch";
+} & Readonly<A>;
+/** The pool was given a database whose network it cannot join. */
+export declare class DatabaseNetworkMismatch extends DatabaseNetworkMismatch_base<{
+    readonly message: string;
+}> {
+}
+export interface PoolSettings {
+    /**
+     * The name the pool is known by. It is also the shard group the
+     * entities they host are placed in.
+     * @default ${stack}-${stage}-${id}
+     */
+    name?: string;
+    /**
+     * The shard groups an external program's entities use, which these
+     * runners serve. Entities declared with Alchemy always use the pool's
+     * own group.
+     * @default ["default"]
+     */
+    shardGroups?: string[];
+}
+/** What a host needs to declare the service that runs the pool. */
+export interface PoolNodes<Network, Gateway extends PoolGateway = PoolGateway> {
+    /** What the host declared for the gateway (e.g. a load balancer to register with). */
+    readonly gateway: Gateway;
+    readonly database: DatabaseShape;
+    readonly network: Network;
+    readonly pool: Pool;
+    /** The pool's name, a DNS label. */
+    readonly name: string;
+    /**
+     * The bundled program: a directory holding `runner.mjs` with a
+     * `Dockerfile`, and a hash of its
+     * contents, which changes whenever the program does.
+     */
+    readonly program: Output.Output<{
+        readonly dir: string;
+        readonly hash: string;
+    }>;
+    /** Environment every runner needs, as plain strings. */
+    readonly environment: Output.Output<Record<string, string>>;
+}
+/** What a host binds onto each entity so callers can reach the gateway. */
+export interface PoolGateway {
+    readonly url: Input<string>;
+}
+/** The Dockerfile every host builds the runner image from. */
+export declare const RUNNER_DOCKERFILE = "FROM node:26-slim\nWORKDIR /app\nCOPY *.mjs /app/\nENV NODE_ENV=production\nEXPOSE 34431 34500\nENTRYPOINT [\"node\", \"/app/runner.mjs\"]\n";
+/**
+ * A pool Layer: `network` narrows the database's network to the one this
+ * host can join; `gateway` names where callers reach the pool;
+ * `nodes` declares the service that runs them.
+ */
+export declare const makePoolLayer: <Network, Req, Gateway extends PoolGateway = PoolGateway>(options: {
+    readonly label: string;
+    readonly id: string;
+    readonly settings: PoolSettings;
+    readonly network: (database: DatabaseShape) => Network | undefined;
+    readonly expected: string;
+    /** The longest runner name the host accepts. @default 63 */
+    readonly nameLength?: number;
+    /** The runner image's Dockerfile, when the host needs more than {@link RUNNER_DOCKERFILE}. */
+    readonly dockerfile?: string;
+    /** Where callers reach the gateway, declaring what it needs; before the pool's service. */
+    readonly gateway: (name: string, network: Network) => Effect.Effect<Gateway, never, Req>;
+    readonly nodes: (nodes: PoolNodes<Network, Gateway>) => Effect.Effect<void, never, Req>;
+}) => Layer.Layer<PoolHost, never, Database | Stack | Providers | Req>;
+export {};
+//# sourceMappingURL=PoolHost.d.ts.map

package/lib/internal/PoolHost.d.ts.map

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

package/lib/internal/PoolHost.js

@@ -0,0 +1,203 @@
+/**
+ * What every pool Layer shares, whatever runs its pool: register the
+ * entity whose Construction phase is running with the pool resource, bind
+ * what callers need onto the entity, and bundle every class the pool hosts
+ * into one Node program. A host only declares the service that runs it.
+ *
+ * @internal
+ */
+import { createHash } from "node:crypto";
+import { fileURLToPath } from "node:url";
+import { dotAlchemyDirectory } from "alchemy/AlchemyContext";
+import * as Bundle from "alchemy/Bundle/Bundle";
+import * as Output from "alchemy/Output";
+import { Random } from "alchemy/Random";
+import { Self } from "alchemy/Self";
+import { Stack } from "alchemy/Stack";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as FileSystem from "effect/FileSystem";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Path from "effect/Path";
+import * as Redacted from "effect/Redacted";
+import { Database } from "../Database.js";
+import { shardGroupKey } from "../Entity.js";
+import { Pool } from "../Pool.js";
+import { GATEWAY_PORT, RUNNER_PORT } from "./Gateway.js";
+import { HOSTED_TYPES, shortLabel, stackDnsLabel } from "./Naming.js";
+import { PoolHost } from "./PoolHostService.js";
+const VIRTUAL = "virtual:cluster-entities";
+/** Resolve {@link VIRTUAL} to a module that imports every class the pool hosts. */
+const entitiesPlugin = (entities) => {
+    const source = [
+        ...entities.map((entity, i) => `import { ${entity.handler} as e${i} } from ${JSON.stringify(entity.module.startsWith("file:") ? fileURLToPath(entity.module) : entity.module)};`),
+        `export default [${entities
+            .map((entity, i) => `{ name: ${JSON.stringify(entity.name)}, value: e${i} }`)
+            .join(", ")}];`,
+    ].join("\n");
+    return [
+        {
+            name: "cluster-entities",
+            resolveId: (id) => (id === VIRTUAL ? `\0${VIRTUAL}` : null),
+            load: (id) => (id === `\0${VIRTUAL}` ? source : null),
+        },
+    ];
+};
+/** The pool was given a database whose network it cannot join. */
+export class DatabaseNetworkMismatch extends Data.TaggedError("Cluster.DatabaseNetworkMismatch") {
+}
+const output = (value) => (Output.isOutput(value) ? value : Output.literal(value));
+/** The Dockerfile every host builds the runner image from. */
+export const RUNNER_DOCKERFILE = `FROM node:26-slim
+WORKDIR /app
+COPY *.mjs /app/
+ENV NODE_ENV=production
+EXPOSE ${RUNNER_PORT} ${GATEWAY_PORT}
+ENTRYPOINT ["node", "/app/runner.mjs"]
+`;
+/**
+ * A pool Layer: `network` narrows the database's network to the one this
+ * host can join; `gateway` names where callers reach the pool;
+ * `nodes` declares the service that runs them.
+ */
+export const makePoolLayer = (options) => Layer.effect(PoolHost, Effect.gen(function* () {
+    const database = yield* Database;
+    // What was provided to the pool, like an entity's RPC middleware,
+    // goes with every class they host.
+    const services = yield* Effect.context();
+    const self = Option.getOrUndefined(yield* Effect.serviceOption(Self));
+    const hostsSelf = self !== undefined && HOSTED_TYPES.has(self.Type);
+    if (globalThis.__ALCHEMY_RUNTIME__) {
+        if (hostsSelf)
+            yield* self.provideServices(services);
+        return {
+            host: (hosted) => hosted.provideServices(services),
+            deployExternal: () => Effect.void,
+        };
+    }
+    const network = options.network(database);
+    if (network === undefined) {
+        return yield* Effect.die(new DatabaseNetworkMismatch({
+            message: `${options.label} runs runners on ${options.expected}, and its database is not on one.`,
+        }));
+    }
+    // Named up front, so an entity knows its pool without depending on
+    // the pool resource, whose bindings carry every entity's env.
+    const name = options.settings.name ?? (yield* stackDnsLabel(options.id, options.nameLength));
+    // A shard group only has to be unique within its database, and must
+    // never be one an external program uses (usually `default`). Effect
+    // Cluster stores `group:shard` in a 50-character column, so keep it short.
+    const group = `alchemy:${yield* shortLabel(options.id, 32)}`;
+    const gateway = yield* options.gateway(name, network);
+    const context = yield* Effect.context();
+    /** Put `hosted` on the pool, bind the gateway onto `resource`, and declare the pool. */
+    const deploy = (hosted, env, resource) => Effect.gen(function* () {
+        const pool = yield* Pool(options.id, { name });
+        const token = yield* Random(`${options.id}GatewayToken`, {
+            bytes: 32,
+        });
+        // The hosting runners route the entity to its own shard group.
+        yield* pool.bind `${hosted.name}`({
+            entities: [hosted],
+            env: hosted.program === undefined ? { ...env, [shardGroupKey(hosted.name)]: group } : env,
+        });
+        // Alchemy entities live in the pool's own shard group; an
+        // external program keeps the groups its entities use.
+        const groups = hosted.program === undefined ? [group] : (options.settings.shardGroups ?? ["default"]);
+        yield* database.shardGroups.bind `${name}`({ groups });
+        // What callers need to reach the entity through the gateway.
+        yield* resource.bind `Pool`({
+            pool: group,
+            gateway: gateway.url,
+            token: token.text,
+        });
+        const stack = yield* Stack;
+        yield* options.nodes({
+            gateway,
+            database,
+            network,
+            pool,
+            name,
+            program: yield* bundleProgram(options.id, pool, options.dockerfile ?? RUNNER_DOCKERFILE),
+            environment: Output.all(pool.env, output(database.url), token.text, database.shardGroups.groups).pipe(Output.map(([values, url, tokenText, allGroups]) => ({
+                ...Object.fromEntries(Object.entries(values).map(([key, value]) => [key, String(value)])),
+                ALCHEMY_STACK_NAME: stack.name,
+                ALCHEMY_STAGE: stack.stage,
+                ALCHEMY_PHASE: "runtime",
+                CLUSTER_DATABASE_URL: Redacted.value(url),
+                CLUSTER_GATEWAY_TOKEN: Redacted.value(tokenText),
+                CLUSTER_POOL: name,
+                CLUSTER_SHARD_GROUPS: groups.join(","),
+                CLUSTER_AVAILABLE_SHARD_GROUPS: allGroups.join(","),
+            }))),
+        });
+    }).pipe(Effect.provide(context));
+    const host = (hosted) => Effect.andThen(hosted.provideServices(services), hosted.registerPool((env) => deploy({
+        name: hosted.LogicalId,
+        module: hosted.Props.main,
+        handler: hosted.Props.handler ?? "default",
+    }, env, hosted)));
+    // The generic `Self` is the class whose phase is running. When it is
+    // not hosted on runners, the pool was given an external entity,
+    // which may be declared inside any runtime's Construction phase.
+    if (hostsSelf)
+        yield* host(self);
+    return {
+        host,
+        deployExternal: ({ type, main, handler, program, resource }) => 
+        // oxlint-disable-next-line effecttsgo/unsafe-effect-type-assertion -- `bind` is typed `any`; what it needs is the providers in `context`
+        deploy({ name: type, module: main, handler, program }, {}, resource),
+    };
+}));
+const PROGRAM = "virtual:cluster-program";
+/** Resolve {@link PROGRAM} to the external program's bundled source, as a string. */
+const programPlugin = (source) => [
+    {
+        name: "cluster-program",
+        resolveId: (id) => (id === PROGRAM ? `\0${PROGRAM}` : null),
+        load: (id) => id === `\0${PROGRAM}` ? `export default ${JSON.stringify(source ?? "")};` : null,
+    },
+];
+/** A runner entry beside this module: `runner` (Alchemy entities) or `external-runner`. */
+const runnerEntry = (name) => fileURLToPath(new URL(import.meta.url.endsWith(".ts") ? `./${name}.ts` : `./${name}.js`, import.meta.url));
+/**
+ * Bundle the runner program and its Dockerfile into a directory of their
+ * own, once the pool knows its classes, and resolve to the directory.
+ */
+const bundleProgram = Effect.fn(function* (id, pool, dockerfile) {
+    const fs = yield* FileSystem.FileSystem;
+    const path = yield* Path.Path;
+    const dir = path.resolve(yield* dotAlchemyDirectory, "cluster", yield* stackDnsLabel(id));
+    return Output.mapEffect((entities) => Effect.gen(function* () {
+        yield* fs.remove(dir, { recursive: true, force: true });
+        yield* fs.makeDirectory(dir, { recursive: true });
+        // An external program is bundled on its own and embedded in the
+        // runner, which writes it out and runs it as its own process: it reads
+        // its settings from its environment when it loads, so it can't share
+        // the runner's modules. One file, on every host.
+        const program = entities.find((entity) => entity.program !== undefined)?.program;
+        let programSource;
+        if (program !== undefined) {
+            const programDir = path.join(dir, "program");
+            yield* Bundle.build({
+                input: path.resolve(program),
+                platform: "node",
+                resolve: { conditionNames: [...Bundle.NODE_CONDITION_NAMES] },
+            }, { dir: programDir, format: "esm", entryFileNames: "program.mjs", codeSplitting: false });
+            programSource = yield* fs.readFileString(path.join(programDir, "program.mjs"));
+            yield* fs.remove(programDir, { recursive: true });
+        }
+        const runner = yield* Bundle.build({
+            input: runnerEntry(program === undefined ? "runner" : "external-runner"),
+            platform: "node",
+            resolve: { conditionNames: [...Bundle.NODE_CONDITION_NAMES] },
+            plugins: [...entitiesPlugin(entities), ...programPlugin(programSource)],
+        }, { dir, format: "esm", entryFileNames: "runner.mjs", codeSplitting: false });
+        const hashes = [runner.hash, dockerfile];
+        yield* fs.writeFileString(path.join(dir, "Dockerfile"), dockerfile);
+        const hash = yield* Effect.sync(() => createHash("sha256").update(hashes.join("\n")).digest("hex").slice(0, 16));
+        return { dir, hash };
+    }).pipe(Effect.orDie))(pool.entities);
+});
+//# sourceMappingURL=PoolHost.js.map

package/lib/internal/PoolHost.js.map

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

package/lib/internal/PoolHostService.d.ts

@@ -0,0 +1,25 @@
+import * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+import type { Entity } from "../Entity.ts";
+import type { HostedClass } from "./HostedRuntime.ts";
+declare const PoolHost_base: Context.ServiceClass<PoolHost, "Cluster.PoolHost", {
+    /** Host a class (an entity, a workflow) on the pool: its Construction phase is running. */
+    readonly host: (self: HostedClass) => Effect.Effect<void>;
+    readonly deployExternal: (entity: {
+        readonly type: string;
+        readonly main: string;
+        readonly handler: string;
+        readonly program: string;
+        readonly resource: Entity;
+    }) => Effect.Effect<void>;
+}>;
+/**
+ * What a pool Layer gives the Effect it is provided to: a way for an
+ * external `Cluster.Entity` (an existing Effect Cluster program, referenced
+ * by file) to run on the pool.
+ * @internal
+ */
+export declare class PoolHost extends PoolHost_base {
+}
+export {};
+//# sourceMappingURL=PoolHostService.d.ts.map

package/lib/internal/PoolHostService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolHostService.d.ts","sources":["../../src/internal/PoolHostService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;;IAWlD,2FAA2F;mBAC5E,CAAC,IAAI,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;6BAChC,CAAC,MAAM,EAAE;QAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;KAC3B,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;AAjB7B;;;;;GAKG;AACH,qBAAa,QAAS,SAAQ,aAaP;CAAG"}

package/lib/internal/PoolHostService.js

@@ -0,0 +1,10 @@
+import * as Context from "effect/Context";
+/**
+ * What a pool Layer gives the Effect it is provided to: a way for an
+ * external `Cluster.Entity` (an existing Effect Cluster program, referenced
+ * by file) to run on the pool.
+ * @internal
+ */
+export class PoolHost extends Context.Service()("Cluster.PoolHost") {
+}
+//# sourceMappingURL=PoolHostService.js.map

package/lib/internal/PoolHostService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PoolHostService.js","sources":["../../src/internal/PoolHostService.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAK1C;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAa1C,CAAC,kBAAkB,CAAC;CAAG"}

package/lib/internal/Wire.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What crosses between a caller and an entity's object: each call as JSON,
+ * its reply as JSON. A host's object RPC hides a thrown error's type, so
+ * failures of the object itself come back as data too.
+ *
+ * @internal
+ */
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { Rpc } from "effect/rpc";
+import * as Schema from "effect/Schema";
+/** One call to an entity, as it crosses to the entity's object. */
+export interface Call {
+    /** The caller's id for this call: what an interrupt names. */
+    readonly requestId: string;
+    readonly tag: string;
+    readonly payload: unknown;
+    readonly headers: Record<string, string>;
+}
+/** A failure of the object itself, returned as data. */
+export declare const DEFECT = "~cluster/defect";
+/** A cluster error the object answered with instead of running the call. */
+export interface Rejection {
+    readonly _tag: "MailboxFull" | "AlreadyProcessingMessage" | "PersistenceError";
+    readonly message: string;
+}
+/**
+ * The object's answer to a call: the encoded exit of an RPC, a rejection,
+ * or the object's own defect. A stream answers with one of these per frame,
+ * plus `{ chunk }` frames before its exit.
+ */
+export type Reply = {
+    readonly exit: unknown;
+} | {
+    readonly rejected: Rejection;
+} | {
+    readonly [DEFECT]: string;
+};
+export type Frame = Reply | {
+    readonly chunk: ReadonlyArray<unknown>;
+};
+export declare const json: <S extends Schema.Top>(schema: S) => Schema.Codec<unknown, unknown>;
+export declare const payloadCodec: (rpc: Rpc.AnyWithProps) => Schema.Codec<unknown, unknown, never, never>;
+export declare const exitCodec: (rpc: Rpc.AnyWithProps) => Schema.Codec<unknown, unknown, never, never>;
+export declare const chunkCodec: (rpc: Rpc.AnyWithProps) => Schema.Codec<unknown, unknown, never, never>;
+export declare const encode: (codec: Schema.Codec<unknown, unknown>, value: unknown) => Effect.Effect<unknown, never, never>;
+export declare const decode: (codec: Schema.Codec<unknown, unknown>, value: unknown) => Effect.Effect<unknown, never, never>;
+/**
+ * An RPC's exit, encoded. A stream's exit carries no value. An exit its
+ * schema can't encode (a defect that isn't JSON) is sent as a defect with
+ * its message.
+ */
+export declare const encodeExit: (rpc: Rpc.AnyWithProps, exit: Exit.Exit<unknown, unknown>) => Effect.Effect<unknown, never, never>;
+/** `(type, id)` as one object name, length-prefixed like Effect's: `7:Counter` + id. */
+export declare const entityObjectName: (type: string, id: string) => string;
+export declare const parseEntityObjectName: (name: string) => {
+    type: string;
+    id: string;
+};
+//# sourceMappingURL=Wire.d.ts.map

package/lib/internal/Wire.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Wire.d.ts","sources":["../../src/internal/Wire.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,GAAG,EAAa,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,mEAAmE;AACnE,MAAM,WAAW,IAAI;IACnB,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC1C;AAED,wDAAwD;AACxD,eAAO,MAAM,MAAM,oBAAoB,CAAC;AAExC,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,0BAA0B,GAAG,kBAAkB,CAAC;IAC/E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,KAAK,GACb;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,MAAM,MAAM,KAAK,GAAG,KAAK,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC,OAAO,CAAC,CAAA;CAAE,CAAC;AAEvE,eAAO,MAAM,IAAI,GAAI,CAAC,SAAS,MAAM,CAAC,GAAG,UAAU,CAAC,KACT,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AAE1E,eAAO,MAAM,YAAY,QAAS,GAAG,CAAC,YAAY,iDAA4B,CAAC;AAC/E,eAAO,MAAM,SAAS,QAAS,GAAG,CAAC,YAAY,iDAAyC,CAAC;AACzF,eAAO,MAAM,UAAU,QAAS,GAAG,CAAC,YAAY,iDACgD,CAAC;AAEjG,eAAO,MAAM,MAAM,UAAW,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,OAAO,yCACf,CAAC;AAC9D,eAAO,MAAM,MAAM,UAAW,MAAM,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,SAAS,OAAO,yCACf,CAAC;AAE9D;;;;GAIG;AACH,eAAO,MAAM,UAAU,QAAS,GAAG,CAAC,YAAY,QAAQ,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,yCAUhF,CAAC;AAEJ,wFAAwF;AACxF,eAAO,MAAM,gBAAgB,SAAU,MAAM,MAAM,MAAM,WAAkC,CAAC;AAE5F,eAAO,MAAM,qBAAqB,SAAU,MAAM;IAI9C,IAAI;IACJ,EAAE;CAEL,CAAC"}

package/lib/internal/Wire.js

@@ -0,0 +1,36 @@
+/**
+ * What crosses between a caller and an entity's object: each call as JSON,
+ * its reply as JSON. A host's object RPC hides a thrown error's type, so
+ * failures of the object itself come back as data too.
+ *
+ * @internal
+ */
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { Rpc, RpcSchema } from "effect/rpc";
+import * as Schema from "effect/Schema";
+/** A failure of the object itself, returned as data. */
+export const DEFECT = "~cluster/defect";
+export const json = (schema) => Schema.toCodecJson(schema);
+export const payloadCodec = (rpc) => json(rpc.payloadSchema);
+export const exitCodec = (rpc) => json(Rpc.exitSchema(rpc));
+export const chunkCodec = (rpc) => json(RpcSchema.isStreamSchema(rpc.successSchema) ? rpc.successSchema.success : Schema.Unknown);
+export const encode = (codec, value) => Schema.encodeUnknownEffect(codec)(value).pipe(Effect.orDie);
+export const decode = (codec, value) => Schema.decodeUnknownEffect(codec)(value).pipe(Effect.orDie);
+/**
+ * An RPC's exit, encoded. A stream's exit carries no value. An exit its
+ * schema can't encode (a defect that isn't JSON) is sent as a defect with
+ * its message.
+ */
+export const encodeExit = (rpc, exit) => Schema.encodeUnknownEffect(exitCodec(rpc))(RpcSchema.isStreamSchema(rpc.successSchema) ? Exit.asVoid(exit) : exit).pipe(Effect.catchCause(() => Schema.encodeUnknownEffect(exitCodec(rpc))(Exit.die(Exit.isFailure(exit) ? String(exit.cause) : "unencodable exit"))), Effect.orDie);
+/** `(type, id)` as one object name, length-prefixed like Effect's: `7:Counter` + id. */
+export const entityObjectName = (type, id) => `${type.length}:${type}${id}`;
+export const parseEntityObjectName = (name) => {
+    const colon = name.indexOf(":");
+    const length = Number(name.slice(0, colon));
+    return {
+        type: name.slice(colon + 1, colon + 1 + length),
+        id: name.slice(colon + 1 + length),
+    };
+};
+//# sourceMappingURL=Wire.js.map

package/lib/internal/Wire.js.map

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

package/lib/internal/WorkflowGateway.d.ts

@@ -0,0 +1,36 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Rpc, RpcGroup } from "effect/rpc";
+import * as Schema from "effect/Schema";
+import { Workflow, WorkflowEngine } from "effect/workflow";
+import { type GatewayTarget } from "./Gateway.ts";
+declare const WorkflowRpcs_base: RpcGroup.RpcGroup<Rpc.Rpc<"Workflow.Interrupt", Schema.Struct<{
+    workflow: Schema.String;
+    executionId: Schema.String;
+}>, Schema.Void, Schema.Never, never, never> | Rpc.Rpc<"Workflow.Poll", Schema.Struct<{
+    workflow: Schema.String;
+    executionId: Schema.String;
+}>, Schema.Struct<{
+    readonly state: Schema.Literals<readonly ["none", "suspended", "complete"]>;
+    readonly result: Schema.optional<Schema.String>;
+}>, Schema.Never, never, never> | Rpc.Rpc<"Workflow.Signal", Schema.Struct<{
+    workflow: Schema.String;
+    executionId: Schema.String;
+    name: Schema.String;
+    exit: Schema.String;
+}>, Schema.Void, Schema.Never, never, never> | Rpc.Rpc<"Workflow.Start", Schema.Struct<{
+    workflow: Schema.String;
+    executionId: Schema.String;
+    payload: Schema.Unknown;
+}>, Schema.Void, Schema.Never, never, never>>;
+export declare class WorkflowRpcs extends WorkflowRpcs_base {
+}
+/** The pool's side: each RPC on the pool's own engine, for the workflows they host. */
+export declare const workflowHandlers: (workflows: ReadonlyMap<string, Workflow.Any>) => Layer.Layer<Rpc.Handler<"Workflow.Interrupt"> | Rpc.Handler<"Workflow.Poll"> | Rpc.Handler<"Workflow.Signal"> | Rpc.Handler<"Workflow.Start">, never, any>;
+/**
+ * A caller's engine: starts and reads runs through the gateway of the
+ * pool that hosts each workflow. `route` returns that gateway.
+ */
+export declare const makeRemoteEngine: (route: (workflowName: string) => Effect.Effect<GatewayTarget>) => WorkflowEngine.WorkflowEngine["Service"];
+export {};
+//# sourceMappingURL=WorkflowGateway.d.ts.map

package/lib/internal/WorkflowGateway.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkflowGateway.d.ts","sources":["../../src/internal/WorkflowGateway.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAIxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,GAAG,EAAkC,QAAQ,EAAoB,MAAM,YAAY,CAAC;AAC7F,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAmB,QAAQ,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAC5E,OAAO,EAAgB,KAAK,aAAa,EAAgB,MAAM,cAAc,CAAC;;;;;;;;;;;;;;;;;;;;AAI9E,qBAAa,YAAa,SAAQ,iBAWjC;CAAG;AAMJ,uFAAuF;AACvF,eAAO,MAAM,gBAAgB,cAAe,WAAW,CAAC,MAAM,EAAE,QAAQ,CAAC,GAAG,CAAC,+JA+C1E,CAAC;AASJ;;;GAGG;AACH,eAAO,MAAM,gBAAgB,UACpB,CAAC,YAAY,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,KAC5D,cAAc,CAAC,cAAc,CAAC,SAAS,CA6EzC,CAAC"}

package/lib/internal/WorkflowGateway.js

@@ -0,0 +1,124 @@
+/**
+ * How callers outside the cluster reach the workflows a pool hosts: four
+ * RPCs on the pool's gateway, served by the pool's own
+ * `ClusterWorkflowEngine`, and a `WorkflowEngine` for callers that sends
+ * them. Payloads, results and signals cross as JSON, encoded with the
+ * workflow's own schemas.
+ *
+ * @internal
+ */
+import { decodeExit, decodeResult, encodeExit, encodeResult, payloadCodec, } from "alchemy/WorkflowEncoding";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as FetchHttpClient from "effect/http/FetchHttpClient";
+import * as HttpClient from "effect/http/HttpClient";
+import * as HttpClientRequest from "effect/http/HttpClientRequest";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import { Rpc, RpcClient, RpcGroup, RpcSerialization } from "effect/rpc";
+import * as Schema from "effect/Schema";
+import { DurableDeferred, Workflow, WorkflowEngine } from "effect/workflow";
+import { GATEWAY_PATH, gatewayFetch } from "./Gateway.js";
+const Run = { workflow: Schema.String, executionId: Schema.String };
+export class WorkflowRpcs extends RpcGroup.make(Rpc.make("Workflow.Start", { payload: { ...Run, payload: Schema.Unknown } }), Rpc.make("Workflow.Poll", {
+    payload: Run,
+    success: Schema.Struct({
+        state: Schema.Literals(["none", "suspended", "complete"]),
+        result: Schema.optional(Schema.String),
+    }),
+}), Rpc.make("Workflow.Interrupt", { payload: Run }), Rpc.make("Workflow.Signal", { payload: { ...Run, name: Schema.String, exit: Schema.String } })) {
+}
+class UnknownWorkflow extends Data.TaggedError("Cluster.UnknownWorkflow") {
+}
+/** The pool's side: each RPC on the pool's own engine, for the workflows they host. */
+export const workflowHandlers = (workflows) => WorkflowRpcs.toLayer(Effect.gen(function* () {
+    const engine = yield* WorkflowEngine.WorkflowEngine;
+    const find = (name) => {
+        const workflow = workflows.get(name);
+        return workflow === undefined
+            ? Effect.die(new UnknownWorkflow({ workflow: name }))
+            : Effect.succeed(workflow);
+    };
+    return WorkflowRpcs.of({
+        "Workflow.Start": ({ workflow: name, executionId, payload }) => Effect.gen(function* () {
+            const workflow = yield* find(name);
+            const decoded = yield* Schema.decodeUnknownEffect(payloadCodec(workflow))(payload).pipe(Effect.orDie);
+            yield* engine.execute(workflow, {
+                executionId,
+                payload: decoded,
+                discard: true,
+            });
+        }).pipe(Effect.orDie),
+        "Workflow.Poll": ({ workflow: name, executionId }) => Effect.gen(function* () {
+            const workflow = yield* find(name);
+            const result = yield* engine.poll(workflow, executionId);
+            if (Option.isNone(result))
+                return { state: "none" };
+            if (result.value._tag === "Suspended")
+                return { state: "suspended" };
+            return {
+                state: "complete",
+                result: yield* encodeResult(workflow, result.value.exit),
+            };
+        }),
+        "Workflow.Interrupt": ({ workflow: name, executionId }) => Effect.flatMap(find(name), (workflow) => engine.interrupt(workflow, executionId)),
+        // The exit arrives encoded with the deferred's own schemas, so it is
+        // passed on through a deferred whose schemas leave it as it is.
+        "Workflow.Signal": ({ workflow, executionId, name, exit }) => Effect.flatMap(decodeExit(exit), (decoded) => engine.deferredDone(DurableDeferred.make(name, { success: Schema.Unknown, error: Schema.Unknown }), { workflowName: workflow, executionId, deferredName: name, exit: decoded })),
+    });
+}));
+/** A step only runs inside a run, and runs only run on the pool. */
+class RunsOnPool extends Data.TaggedError("Cluster.RunsOnPool") {
+}
+const onPool = (operation) => Effect.die(new RunsOnPool({ operation }));
+/**
+ * A caller's engine: starts and reads runs through the gateway of the
+ * pool that hosts each workflow. `route` returns that gateway.
+ */
+export const makeRemoteEngine = (route) => {
+    const call = (workflowName, use) => Effect.gen(function* () {
+        const target = yield* route(workflowName);
+        const protocol = RpcClient.layerProtocolHttp({
+            url: `${target.url.replace(/\/+$/, "")}${GATEWAY_PATH}`,
+            transformClient: HttpClient.mapRequest(HttpClientRequest.bearerToken(target.token)),
+        }).pipe(Layer.provide([FetchHttpClient.layer, RpcSerialization.layerJson]));
+        return yield* Effect.flatMap(RpcClient.make(WorkflowRpcs), use).pipe(Effect.scoped, Effect.provide(protocol), Effect.provideService(FetchHttpClient.Fetch, yield* gatewayFetch(target.service)));
+    }).pipe(Effect.orDie);
+    const poll = (workflow, executionId) => Effect.gen(function* () {
+        const reply = yield* call(workflow._tag, (client) => client["Workflow.Poll"]({ workflow: workflow._tag, executionId }));
+        if (reply.state === "none")
+            return Option.none();
+        if (reply.state === "suspended")
+            return Option.some(Workflow.Suspended.make({}));
+        return Option.some(yield* decodeResult(workflow, reply.result ?? "null"));
+    });
+    return WorkflowEngine.makeUnsafe({
+        // Workflows run on their runners; nothing registers here.
+        register: () => Effect.void,
+        execute: (workflow, options) => Effect.gen(function* () {
+            const payload = yield* Schema.encodeEffect(payloadCodec(workflow))(options.payload).pipe(Effect.orDie);
+            yield* call(workflow._tag, (client) => client["Workflow.Start"]({
+                workflow: workflow._tag,
+                executionId: options.executionId,
+                payload,
+            }));
+            if (options.discard)
+                return undefined;
+            return Option.getOrElse(yield* poll(workflow, options.executionId), () => Workflow.Suspended.make({}));
+        }),
+        poll,
+        interrupt: (workflow, executionId) => call(workflow._tag, (client) => client["Workflow.Interrupt"]({ workflow: workflow._tag, executionId })),
+        interruptUnsafe: (workflow, executionId) => call(workflow._tag, (client) => client["Workflow.Interrupt"]({ workflow: workflow._tag, executionId })),
+        resume: () => Effect.void,
+        activityExecute: () => onPool("Activity execution"),
+        deferredResult: () => onPool("DurableDeferred reads"),
+        deferredDone: ({ workflowName, executionId, deferredName, exit }) => Effect.flatMap(encodeExit(exit), (text) => call(workflowName, (client) => client["Workflow.Signal"]({
+            workflow: workflowName,
+            executionId,
+            name: deferredName,
+            exit: text,
+        }))),
+        scheduleClock: () => onPool("DurableClock scheduling"),
+    });
+};
+//# sourceMappingURL=WorkflowGateway.js.map