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

package/lib/Entity.js

@@ -0,0 +1,308 @@
+import * as nodePath from "node:path";
+import * as Output from "alchemy/Output";
+import { Platform, } from "alchemy/Platform";
+import * as Provider from "alchemy/Provider";
+import { RuntimeContext, sanitizeKey } from "alchemy/RuntimeContext";
+import { ClusterSchema, Entity as EffectEntity } from "effect/cluster";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Effectable from "effect/Effectable";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Redacted from "effect/Redacted";
+import { bindRoute, makeNamespace } from "./internal/Gateway.js";
+import { makeHostedRuntimeContext } from "./internal/HostedRuntime.js";
+import { PoolHost } from "./internal/PoolHostService.js";
+export const EntityTypeId = "Cluster.Entity";
+/** A class yielded outside any runtime was called. */
+export class EntityCalledOutsideRuntime extends Data.TaggedError("Cluster.EntityCalledOutsideRuntime") {
+}
+/** The Effect entity behind each declared type, for the runtime context. */
+const entities = new Map();
+const createRuntimeContext = makeHostedRuntimeContext(EntityTypeId, (id, instance, context, props) => ({
+    kind: "entity",
+    entity: entities.get(id),
+    instance: instance,
+    context,
+    options: {
+        maxIdleTime: props?.maxIdleTime,
+        concurrency: props?.concurrency,
+        mailboxCapacity: props?.mailboxCapacity,
+        disableFatalDefects: props?.disableFatalDefects,
+    },
+}), 
+// Every RPC's middleware must reach the pool with the entity.
+(id, context) => {
+    const missing = [...entities.get(id).protocol.requests.values()].flatMap((rpc) => [...rpc.middlewares]
+        .filter((middleware) => !context.mapUnsafe.has(middleware.key))
+        .map((middleware) => `${rpc._tag} uses ${middleware.key}`));
+    return missing.length === 0
+        ? Effect.void
+        : Effect.die(new EntityMiddlewareMissing({
+            message: `Cluster.Entity '${id}' is missing RPC middleware (${missing.join(", ")}). ` +
+                `Provide its Layer with the pool: Effect.provide(Default.pipe(Layer.provide(AuthLive))).`,
+        }));
+});
+/** An entity's RPC uses middleware nothing provided to its pool. */
+export class EntityMiddlewareMissing extends Data.TaggedError("Cluster.EntityMiddlewareMissing") {
+}
+const platform = Platform(EntityTypeId, { createRuntimeContext });
+/** The resource type behind every class, which the providers register. @internal */
+export const EntityResource = platform;
+/** The Platform declaration behind a class, which a runner builds. @internal */
+export const PlatformDeclaration = Symbol.for("alchemy/Cluster/Entity/Platform");
+/** The Effect entity a class hosts, which a runner reads. @internal */
+export const EntityDefinition = Symbol.for("alchemy/Cluster/Entity/Definition");
+/**
+ * An **Entity** in an Effect Cluster: a stateful, addressable instance per
+ * entity id, whose messages are typed by its RPCs. Runners place each
+ * instance on one runner and deliver its messages one at a time.
+ *
+ * Declare it from an Effect Cluster entity with its implementation, and
+ * the class is both what callers `yield*` and what deploys it. Or declare
+ * it bare, like Effect Cluster's `Entity.make`, from a type and its RPCs,
+ * and implement it with `.make(props, impl)`, as a Layer: callers import
+ * the bare declaration without bundling the implementation or its pool.
+ *
+ * The implementation has two phases. The outer Effect runs once per runner
+ * and resolves bindings. The inner Effect runs once per instance, on its
+ * first message, and returns its handlers, typed by the entity's `.of`. Providing a
+ * pool Layer to the implementation, such as
+ * `ClusterDocker.SwarmPool("Default")`, is what deploys it.
+ *
+ * `yield* Counter` from any runtime returns the entity's namespace, like a
+ * Durable Object's: `getByName(entityId)` returns a client with the same
+ * shape as Effect Cluster's `Entity.client(entityId)`. Inside the cluster,
+ * calls go through Effect Cluster directly; elsewhere they go through the
+ * pool's gateway over HTTP, so callers need no database access and no
+ * route to the pool.
+ *
+ * ### Declaring an entity
+ * **Example:** A counter, with its implementation
+ * ```typescript
+ * // src/Counter.ts
+ * const Counters = Entity.make("Counter", [
+ *   Rpc.make("Increment", { payload: { amount: Schema.Int }, success: Schema.Int }),
+ * ]);
+ *
+ * export default class Counter extends Cluster.Entity<Counter>()(
+ *   Counters,
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     return Effect.gen(function* () {
+ *       const count = yield* Ref.make(0);
+ *       return Counters.of({
+ *         Increment: ({ payload }) => Ref.updateAndGet(count, (n) => n + payload.amount),
+ *       });
+ *     });
+ *   }).pipe(Effect.provide(Default)),
+ * ) {}
+ * ```
+ *
+ * ### Keeping its code out of its callers
+ * **Example:** A bare declaration, which callers import
+ * ```typescript
+ * // src/Counter.ts
+ * export const Increment = Rpc.make("Increment", {
+ *   payload: { amount: Schema.Int },
+ *   success: Schema.Int,
+ * });
+ *
+ * export class Counter extends Cluster.Entity<Counter>()("Counter", [Increment]) {}
+ * ```
+ *
+ * **Example:** An existing Effect Cluster entity
+ * ```typescript
+ * import { Counter as CounterEntity } from "./entities/counter.ts";
+ *
+ * export class Counter extends Cluster.Entity<Counter>()(CounterEntity) {}
+ * ```
+ *
+ * **Example:** Its implementation, as a Layer, deployed to a pool
+ * ```typescript
+ * // src/CounterLive.ts
+ * export default Counter.make(
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     return Effect.gen(function* () {
+ *       const count = yield* Ref.make(0);
+ *       return Counter.of({
+ *         Increment: ({ payload }) => Ref.updateAndGet(count, (n) => n + payload.amount),
+ *       });
+ *     });
+ *   }).pipe(Effect.provide(Default)),
+ * );
+ * ```
+ *
+ * **Example:** Middleware, provided with the pool
+ * ```typescript
+ * export const Increment = Rpc.make("Increment", {
+ *   payload: { amount: Schema.Int },
+ *   success: Schema.Int,
+ * }).middleware(Auth);
+ *
+ * export default Counter.make(
+ *   { main: import.meta.url },
+ *   Effect.gen(function* () {
+ *     return Effect.gen(function* () {
+ *       return Counter.of({
+ *         Increment: () => Effect.map(CurrentUser, (user) => user.id.length),
+ *       });
+ *     });
+ *   }).pipe(Effect.provide(Default.pipe(Layer.provide(AuthLive)))),
+ * );
+ * ```
+ *
+ * **Example:** An existing Effect Cluster program, run as it is
+ * ```typescript
+ * import { Tally as TallyEntity } from "./entities/tally.ts";
+ *
+ * export const Tally = Cluster.Entity(TallyEntity, {
+ *   main: "./entities/tally.ts",
+ *   program: "./runner.ts",
+ * }).pipe(Effect.provide(Legacy));
+ * ```
+ *
+ * ### Calling an entity
+ * **Example:** From any runtime
+ * ```typescript
+ * const counters = yield* Counter;
+ * const counter = yield* counters.getByName("visits");
+ * const count = yield* counter.Increment({ amount: 1 });
+ * ```
+ *
+ * **Example:** Without waiting for the reply
+ * ```typescript
+ * yield* counter.Increment({ amount: 1 }, { discard: true });
+ * ```
+ *
+ * **Example:** Through client middleware
+ * ```typescript
+ * const counter = yield* counters.getByName("visits");
+ * yield* counter.Increment({ amount: 1 }).pipe(Effect.provide(AuthClient));
+ * ```
+ *
+ * @resource
+ */
+export const Entity = ((...outer) => outer.length > 0
+    ? external(outer[0], outer[1])
+    : (typeOrEntity, ...rest) => {
+        const [rpcs, props, impl] = typeof typeOrEntity === "string" ? rest : [undefined, ...rest];
+        const entity = placedInShardGroup(typeof typeOrEntity === "string"
+            ? EffectEntity.make(typeOrEntity, rpcs)
+            : typeOrEntity);
+        entities.set(entity.type, entity);
+        const members = { of: (handlers) => handlers, protocol: entity.protocol };
+        // With an implementation, the class deploys it; without, `.make` does.
+        if (impl !== undefined) {
+            return declare(entity, platform()(entity.type, props, impl), members);
+        }
+        const tag = platform()(entity.type);
+        return declare(entity, tag, { ...members, make: tag.make });
+    });
+/** The environment key holding the shard group an entity's pool serves. @internal */
+export const shardGroupKey = (type) => sanitizeKey(`CLUSTER_${type}_SHARD_GROUP`);
+/**
+ * Place an entity in its pool's shard group, read when a message is
+ * routed: its pool, and every runtime that yields the class, have it in
+ * their environment. Effect Cluster's own client (`Counter.entity.client`)
+ * then routes to the right pool too.
+ */
+const placedInShardGroup = (entity) => {
+    const key = shardGroupKey(entity.type);
+    return entity.annotate(ClusterSchema.ShardGroup, 
+    // A synchronous lookup at routing time; workerd has no `process`.
+    () => globalThis.process?.env[key] ??
+        "default");
+};
+/**
+ * An external entity: declare its resource, then have the pool it was
+ * given run its program. The pool Layer is what provides `PoolHost`.
+ */
+const external = (entity, props) => {
+    entities.set(entity.type, entity);
+    const declaration = Effect.gen(function* () {
+        const resource = yield* platform(entity.type, {
+            main: props.main,
+        });
+        if (globalThis.__ALCHEMY_RUNTIME__)
+            return resource;
+        const host = yield* PoolHost;
+        yield* host.deployExternal({
+            type: entity.type,
+            main: yield* Effect.sync(() => nodePath.resolve(props.main)),
+            handler: entity.type,
+            program: props.program,
+            resource,
+        });
+        return resource;
+    });
+    return Object.assign(clientOf(entity, declaration), { entity });
+};
+/**
+ * A class whose `yield*` is its client. While deploying it registers the
+ * class and binds what a caller needs into the caller's environment; at
+ * runtime it only reads them back, so the Construction phase never runs in
+ * a caller.
+ */
+const declare = (entity, declaration, members) => Object.assign(class {
+}, members, {
+    LogicalId: entity.type,
+    entity,
+    [PlatformDeclaration]: declaration,
+    [EntityDefinition]: entity,
+}, Effectable.Prototype({
+    label: `${EntityTypeId}<${entity.type}>`,
+    evaluate: () => clientOf(entity, declaration),
+}));
+const clientOf = (entity, declaration) => Effect.gen(function* () {
+    // Built on a memo map of its own: a class built inside another's phase
+    // would otherwise reuse the caller's already-built pool Layer.
+    const resource = globalThis.__ALCHEMY_RUNTIME__
+        ? undefined
+        : yield* declaration.pipe(Effect.provideServiceEffect(Layer.CurrentMemoMap, Layer.makeMemoMap));
+    const ctx = Option.getOrUndefined(yield* Effect.serviceOption(RuntimeContext));
+    if (ctx === undefined)
+        return outsideRuntime(entity);
+    // Bound as environment values while deploying; read back at runtime.
+    const bind = (key, value) => ctx
+        .set(sanitizeKey(`CLUSTER_${entity.type}_${key}`), Output.isOutput(value) ? value : Output.literal(value))
+        .pipe(Effect.flatMap((bound) => ctx.get(bound)));
+    const url = (yield* bind("GATEWAY", resource?.gateway)) ?? "";
+    // The pool's shard group, for Effect Cluster's own client (`.entity.client`).
+    yield* bind("SHARD_GROUP", resource?.pool);
+    const token = yield* bind("TOKEN", resource?.token);
+    // A Worker calling a gateway Worker reaches it through a service binding.
+    const service = sanitizeKey(`CLUSTER_${entity.type}_SERVICE`);
+    if (!globalThis.__ALCHEMY_RUNTIME__)
+        yield* bindRoute(entity.type, service);
+    return makeNamespace(entity, {
+        url,
+        token: token === undefined ? "" : Redacted.isRedacted(token) ? Redacted.value(token) : token,
+        service,
+    });
+});
+const outsideRuntime = (entity) => ({
+    getByName: (entityId) => Effect.die(new EntityCalledOutsideRuntime({
+        message: `Cluster.Entity '${entity.type}/${entityId}' can only be called inside a runtime.`,
+    })),
+});
+export const EntityProvider = () => Provider.succeed(platform, {
+    stables: ["type"],
+    reconcile: ({ id, bindings }) => Effect.sync(() => {
+        const attrs = {
+            type: id,
+            pool: undefined,
+            gateway: undefined,
+            token: undefined,
+        };
+        for (const { data } of bindings) {
+            attrs.pool = data.pool ?? attrs.pool;
+            attrs.gateway = data.gateway ?? attrs.gateway;
+            attrs.token = data.token ?? attrs.token;
+        }
+        return attrs;
+    }),
+    delete: () => Effect.void,
+});
+//# sourceMappingURL=Entity.js.map

package/lib/Entity.js.map

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

package/lib/Fly/Database.d.ts

@@ -0,0 +1,50 @@
+import * as Fly from "@alchemy.run/fly";
+import * as Layer from "effect/Layer";
+import { Database as ClusterDatabase } from "../Database.ts";
+import type { Providers } from "../Providers.ts";
+export interface DatabaseProps {
+    /**
+     * Fly region of the database.
+     * @default "iad"
+     */
+    region?: string;
+    /**
+     * Postgres image.
+     * @default "postgres:17-alpine"
+     */
+    image?: string;
+    /**
+     * Size of the database's volume, in GB.
+     * @default 10
+     */
+    diskSize?: number;
+    /**
+     * Machine size of the database.
+     * @default { cpus: 1, memoryMb: 1024 }
+     */
+    guest?: Fly.MachineGuest;
+    /**
+     * The Fly private network the database and runners join.
+     * @default a network for the stack and stage
+     */
+    network?: string;
+}
+/**
+ * The database an Effect Cluster coordinates through, on Fly.io, as a
+ * `Cluster.Database` Layer: Postgres on a Fly Machine with a volume, in an
+ * App on a private network that the pool's runners join. Nothing outside the
+ * network reaches it.
+ *
+ * One Postgres on one volume is meant for development and small clusters;
+ * for Fly's Managed Postgres, pass its URL to `Cluster.Database.fromUrl`.
+ *
+ * ### Running the database on Fly
+ * **Example:** Postgres in Ashburn
+ * ```typescript
+ * export const Database = ClusterFly.Database("Cluster");
+ * ```
+ *
+ * @primitive
+ */
+export declare const Database: (id: string, props?: DatabaseProps) => Layer.Layer<ClusterDatabase, never, Providers | Fly.Providers | import("alchemy").Stack>;
+//# sourceMappingURL=Database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sources":["../../src/Fly/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAIxC,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,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAKD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,UAAS,aAAa,6FA4CtD,CAAC"}

package/lib/Fly/Database.js

@@ -0,0 +1,56 @@
+import * as Fly from "@alchemy.run/fly";
+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";
+/** Where Postgres keeps its data, below the volume's mount point. */
+const DATA = "/var/lib/postgresql/data";
+/**
+ * The database an Effect Cluster coordinates through, on Fly.io, as a
+ * `Cluster.Database` Layer: Postgres on a Fly Machine with a volume, in an
+ * App on a private network that the pool's runners join. Nothing outside the
+ * network reaches it.
+ *
+ * One Postgres on one volume is meant for development and small clusters;
+ * for Fly's Managed Postgres, pass its URL to `Cluster.Database.fromUrl`.
+ *
+ * ### Running the database on Fly
+ * **Example:** Postgres in Ashburn
+ * ```typescript
+ * export const Database = ClusterFly.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 network = props.network ?? (yield* Fly.stackNetwork);
+    const password = yield* Random(`${id}Password`, { bytes: 24 });
+    const app = yield* Fly.App(`${id}App`, { network });
+    const machine = yield* Fly.Machine(`${id}Postgres`, {
+        app,
+        region: props.region ?? "iad",
+        image: props.image ?? "postgres:17-alpine",
+        guest: props.guest ?? { cpus: 1, memoryMb: 1024 },
+        mounts: [{ path: DATA, sizeGb: props.diskSize ?? 10 }],
+        env: password.text.pipe(Output.map((text) => ({
+            POSTGRES_PASSWORD: Redacted.value(text),
+            POSTGRES_DB: "cluster",
+            // A fresh volume holds `lost+found`: keep the data below it.
+            PGDATA: `${DATA}/pgdata`,
+        }))),
+        restart: { policy: "always" },
+    });
+    return {
+        // Ordered after the Machine: runners connect once it exists.
+        url: Output.all(app.appName, machine.machineId, password.text).pipe(Output.map(([appName, , text]) => Redacted.make(`postgres://postgres:${encodeURIComponent(text.pipe(Redacted.value))}@${appName}.internal:5432/cluster`))),
+        network: { kind: "fly", network },
+        shardGroups: yield* clusterShardGroups(id),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/Fly/Database.js.map

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

package/lib/Fly/MachinePool.d.ts

@@ -0,0 +1,39 @@
+import * as Fly from "@alchemy.run/fly";
+import { type PoolSettings } from "../internal/PoolHost.ts";
+export interface MachinePoolOptions extends PoolSettings {
+    /**
+     * Number of runners.
+     * @default 2
+     */
+    replicas?: number;
+    /**
+     * Fly region of the pool.
+     * @default "iad"
+     */
+    region?: string;
+    /**
+     * Machine size of each runner.
+     * @default { cpus: 1, memoryMb: 1024 }
+     */
+    guest?: Fly.MachineGuest;
+}
+/**
+ * Run a pool of Effect Cluster runners on Fly.io: a Fly Service whose Machines
+ * host every class given this pool, on the database's private
+ * network. Runners talk to each other and the database over the network;
+ * the Service serves their gateway at `https://{name}.fly.dev` to callers
+ * anywhere. Requires a database on a Fly network — `ClusterFly.Database`.
+ *
+ * ### Running on Fly
+ * **Example:** Two runners in Ashburn
+ * ```typescript
+ * export const Database = ClusterFly.Database("Cluster");
+ * export const Default = ClusterFly.MachinePool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export declare const MachinePool: (id: string, options?: MachinePoolOptions) => import("effect/Layer").Layer<import("../internal/PoolHostService.ts").PoolHost, never, import("../Database.ts").Database | import("../Providers.ts").Providers | Fly.Providers | import("alchemy").Stack>;
+//# sourceMappingURL=MachinePool.d.ts.map

package/lib/Fly/MachinePool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MachinePool.d.ts","sources":["../../src/Fly/MachinePool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AAIxC,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,KAAK,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC;CAC1B;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,WAAW,OAAQ,MAAM,YAAW,kBAAkB,8MA6B/D,CAAC"}

package/lib/Fly/MachinePool.js

@@ -0,0 +1,51 @@
+import * as Fly from "@alchemy.run/fly";
+import * as Output from "alchemy/Output";
+import * as Effect from "effect/Effect";
+import { GATEWAY_PORT } from "../internal/Gateway.js";
+import { makePoolLayer } from "../internal/PoolHost.js";
+/**
+ * Run a pool of Effect Cluster runners on Fly.io: a Fly Service whose Machines
+ * host every class given this pool, on the database's private
+ * network. Runners talk to each other and the database over the network;
+ * the Service serves their gateway at `https://{name}.fly.dev` to callers
+ * anywhere. Requires a database on a Fly network — `ClusterFly.Database`.
+ *
+ * ### Running on Fly
+ * **Example:** Two runners in Ashburn
+ * ```typescript
+ * export const Database = ClusterFly.Database("Cluster");
+ * export const Default = ClusterFly.MachinePool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export const MachinePool = (id, options = {}) => makePoolLayer({
+    label: "ClusterFly.MachinePool",
+    id,
+    settings: options,
+    expected: "a Fly private network (ClusterFly.Database)",
+    // Fly App names are at most 30 characters.
+    nameLength: 30,
+    network: (database) => (database.network?.kind === "fly" ? database.network : undefined),
+    // The Service's App is named after the pool.
+    gateway: (name) => Effect.succeed({ url: `https://${name}.fly.dev` }),
+    nodes: ({ network, name, program, environment }) => Fly.Service(`${id}Pool`, {
+        name,
+        network: network.network,
+        main: program.pipe(Output.map((p) => `${p.dir}/runner.mjs`)),
+        region: options.region ?? "iad",
+        count: options.replicas ?? 2,
+        guest: options.guest ?? { cpus: 1, memoryMb: 1024 },
+        port: GATEWAY_PORT,
+        public: true,
+        env: environment.pipe(
+        // Runners listen on the private network, which is IPv6.
+        Output.map((env) => ({
+            ...env,
+            CLUSTER_LISTEN_HOST: "::",
+        }))),
+    }).pipe(Effect.asVoid),
+});
+//# sourceMappingURL=MachinePool.js.map

package/lib/Fly/MachinePool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"MachinePool.js","sources":["../../src/Fly/MachinePool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,GAAG,MAAM,kBAAkB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AACtD,OAAO,EAAE,aAAa,EAAqB,MAAM,yBAAyB,CAAC;AAoB3E;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,EAAU,EAAE,OAAO,GAAuB,EAAE,EAAE,EAAE,CAC1E,aAAa,CAAC;IACZ,KAAK,EAAE,wBAAwB;IAC/B,EAAE;IACF,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,6CAA6C;IACvD,2CAA2C;IAC3C,UAAU,EAAE,EAAE;IACd,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IACxF,6CAA6C;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,WAAW,IAAI,UAAU,EAAE,CAAC;IACrE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CACjD,GAAG,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE;QACvB,IAAI;QACJ,OAAO,EAAE,OAAO,CAAC,OAAiB;QAClC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,aAAa,CAAC,CAAsB;QACjF,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;QAC/B,KAAK,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;QACnD,IAAI,EAAE,YAAY;QAClB,MAAM,EAAE,IAAI;QACZ,GAAG,EAAE,WAAW,CAAC,IAAI;QACnB,wDAAwD;QACxD,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACnB,GAAG,GAAG;YACN,mBAAmB,EAAE,IAAI;SAC1B,CAAC,CAAC,CACiC;KACvC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;CACzB,CAAC,CAAC"}

package/lib/Fly/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @alchemy.run/effect-cluster/Fly — run an Effect Cluster's database and runners
+ * on Fly.io. Requires `@alchemy.run/fly`.
+ */
+export * from "./Database.ts";
+export * from "./MachinePool.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sources":["../../src/Fly/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/lib/Fly/index.js

@@ -0,0 +1,7 @@
+/**
+ * @alchemy.run/effect-cluster/Fly — run an Effect Cluster's database and runners
+ * on Fly.io. Requires `@alchemy.run/fly`.
+ */
+export * from "./Database.js";
+export * from "./MachinePool.js";
+//# sourceMappingURL=index.js.map

package/lib/Fly/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sources":["../../src/Fly/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC"}

package/lib/GCP/ComputeEnginePool.d.ts

@@ -0,0 +1,41 @@
+import { type PoolSettings } from "../internal/PoolHost.ts";
+export interface ComputeEnginePoolOptions extends PoolSettings {
+    /**
+     * Number of runners, one instance each, spread across zones.
+     * @default 2
+     */
+    replicas?: number;
+    /**
+     * Machine type of each runner.
+     * @default "e2-small"
+     */
+    machineType?: string;
+    /**
+     * Zones the pool is spread across, in the database's region.
+     * @default the region's `-a`, `-b` and `-c` zones
+     */
+    zones?: string[];
+}
+/**
+ * Run a pool of Effect Cluster runners on Compute Engine: instances in the
+ * database's VPC, spread across zones, each running every class given these
+ * runners from a Cloud Storage bucket, behind a regional load balancer on a
+ * static address that serves their gateway to callers anywhere. Runners
+ * reach each other and the database through the cluster's network tag.
+ * Requires a database on a GCP network — `ClusterGCP.Database`.
+ *
+ * Cloud Run can't host runners: runners take connections from each other.
+ *
+ * ### Running on Compute Engine
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterGCP.Database("Cluster");
+ * export const Default = ClusterGCP.ComputeEnginePool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export declare const ComputeEnginePool: (id: string, options?: ComputeEnginePoolOptions) => import("effect/Layer").Layer<import("../internal/PoolHostService.ts").PoolHost, never, import("../Database.ts").Database | import("../Providers.ts").Providers | import("@alchemy.run/gcp/Providers").Providers | import("alchemy").Stack>;
+//# sourceMappingURL=ComputeEnginePool.d.ts.map

package/lib/GCP/ComputeEnginePool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ComputeEnginePool.d.ts","sources":["../../src/GCP/ComputeEnginePool.ts"],"names":[],"mappings":"AAMA,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAQ3E,MAAM,WAAW,wBAAyB,SAAQ,YAAY;IAC5D;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CAClB;AAgDD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,iBAAiB,OAAQ,MAAM,YAAW,wBAAwB,+OAuG3E,CAAC"}