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

package/lib/Hetzner/ServerPool.js

@@ -0,0 +1,98 @@
+import * as Hetzner from "@alchemy.run/hetzner";
+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";
+/** The label the gateway's Load Balancer finds the pool's Servers by. */
+const POOL_LABEL = "cluster-pool";
+/**
+ * Run a pool of Effect Cluster runners on Hetzner Cloud: Servers on the
+ * database's private Network, each running every class given these
+ * runners as a `Hetzner.Service`, behind a Load Balancer that serves their
+ * gateway to callers anywhere. Runners talk to each other and the database
+ * over the Network; their firewall only lets SSH in, which deploys them.
+ * Requires a database on a Hetzner Network — `ClusterHetzner.Database`.
+ *
+ * ### Running on Hetzner
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterHetzner.Database("Cluster");
+ * export const Default = ClusterHetzner.ServerPool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export const ServerPool = (id, options = {}) => makePoolLayer({
+    label: "ClusterHetzner.ServerPool",
+    id,
+    settings: options,
+    expected: "a Hetzner Network (ClusterHetzner.Database)",
+    network: (database) => (database.network?.kind === "hetzner" ? database.network : undefined),
+    // The Load Balancer finds the Servers by label, so it needs none of them.
+    gateway: (name, network) => Effect.gen(function* () {
+        const balancer = yield* Hetzner.LoadBalancer(`${id}Gateway`, {
+            loadBalancerType: "lb11",
+            location: network.location,
+            // A stub of the database's Network, by id.
+            networks: [{ networkId: network.networkId }],
+            services: [
+                {
+                    protocol: "tcp",
+                    listenPort: 80,
+                    destinationPort: GATEWAY_PORT,
+                    healthCheck: {
+                        protocol: "http",
+                        port: GATEWAY_PORT,
+                        interval: 10,
+                        timeout: 5,
+                        retries: 3,
+                        http: { path: "/health" },
+                    },
+                },
+            ],
+            targets: [
+                { type: "label_selector", selector: `${POOL_LABEL}=${name}`, usePrivateIp: true },
+            ],
+        });
+        return { url: Output.interpolate `http://${balancer.ipv4}` };
+    }),
+    nodes: ({ network, name, program, environment }) => Effect.gen(function* () {
+        const firewall = yield* Hetzner.Firewall(`${id}Firewall`, {
+            rules: [
+                {
+                    description: "SSH, which deploys the pool",
+                    direction: "in",
+                    protocol: "tcp",
+                    port: "22",
+                    sourceIps: ["0.0.0.0/0", "::/0"],
+                },
+            ],
+        });
+        for (let i = 0; i < (options.replicas ?? 2); i++) {
+            const server = yield* Hetzner.Server(`${id}Runner${i}`, {
+                serverType: options.serverType ?? "cx23",
+                image: "ubuntu-24.04",
+                location: network.location,
+                // IPv4 installs Node and deploys over SSH; IPv6 would only spend an address.
+                enableIpv6: false,
+                networks: [{ networkId: network.networkId }],
+                firewalls: [firewall],
+                labels: { [POOL_LABEL]: name },
+            });
+            yield* Hetzner.Service(`${id}Runner${i}Service`, {
+                server,
+                main: program.pipe(Output.map((p) => `${p.dir}/runner.mjs`)),
+                port: GATEWAY_PORT,
+                env: environment.pipe(
+                // Each runner finds its own address in the Network's range.
+                Output.map((env) => ({
+                    ...env,
+                    CLUSTER_RUNNER_NETWORK: network.ipRange,
+                }))),
+            });
+        }
+    }),
+});
+//# sourceMappingURL=ServerPool.js.map

package/lib/Hetzner/ServerPool.js.map

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

package/lib/Hetzner/index.d.ts

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

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

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

package/lib/Hetzner/index.js

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

package/lib/Hetzner/index.js.map

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

package/lib/Host.d.ts

@@ -0,0 +1,60 @@
+/**
+ * What a platform built on Effect Cluster entities, such as
+ * `@alchemy.run/domain/EffectCluster`, needs from the runner it is built on
+ * and from the gateway its callers reach entities through.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+import type * as Effect from "effect/Effect";
+import type * as Layer from "effect/Layer";
+import type { HostedEntity } from "./Entity.ts";
+export { type GatewayTarget, makeNamespace } from "./internal/Gateway.ts";
+export { HasNoPool } from "./internal/HostedRuntime.ts";
+declare const RunnerHost_base: Context.ServiceClass<RunnerHost, "Cluster.RunnerHost", {
+    /** Host an entity on this runner, launching `layer` in the cluster beside it. */
+    readonly host: (entity: HostedEntity, layer: Layer.Layer<never, never, any>) => Effect.Effect<void>;
+}>;
+/**
+ * The runner a Layer is being built on. A runner's bootstrap provides it
+ * while it builds its entrypoints, so a Layer that hosts an entity itself
+ * (a Domain platform's, built by the model's Layer rather than exported as
+ * a class) hands the runner that entity, and the Layer to launch with it
+ * inside the cluster (with Sharding and the workflow engine). Anywhere
+ * else, the service is absent.
+ */
+export declare class RunnerHost extends RunnerHost_base {
+}
+/** Options for {@link InstanceStorage}'s `list`. Keys come back in order. */
+export interface InstanceStorageListOptions {
+    /** Only keys that start with this prefix. */
+    readonly prefix?: string;
+    /** Only keys at or after this key. */
+    readonly start?: string;
+    /** Only keys after this key. */
+    readonly startAfter?: string;
+    /** Only keys before this key. */
+    readonly end?: string;
+    /** At most this many entries. */
+    readonly limit?: number;
+}
+declare const InstanceStorage_base: Context.ServiceClass<InstanceStorage, "Cluster.InstanceStorage", {
+    get<T>(key: string): Effect.Effect<T | undefined>;
+    put<T>(key: string, value: T): Effect.Effect<void>;
+    put<T>(entries: Record<string, T>): Effect.Effect<void>;
+    delete(key: string): Effect.Effect<boolean>;
+    delete(keys: ReadonlyArray<string>): Effect.Effect<number>;
+    list<T>(options?: InstanceStorageListOptions): Effect.Effect<Map<string, T>>;
+    transaction<A, E, R>(effect: Effect.Effect<A, E, R>): Effect.Effect<A, E, R>;
+}>;
+/**
+ * The key-value storage of the object an entity instance runs on, on pools
+ * that give every instance an object of its own
+ * (`ClusterCloudflare.DurableObjectPool`: the instance's Durable Object).
+ * Values are structured-cloneable; writes inside `transaction` commit
+ * together, or not at all. The pool provides it to every instance it runs;
+ * on pools that share one database, the service is absent.
+ */
+export declare class InstanceStorage extends InstanceStorage_base {
+}
+//# sourceMappingURL=Host.d.ts.map

package/lib/Host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Host.d.ts","sources":["../src/Host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,OAAO,EAAE,KAAK,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;;IAapD,iFAAiF;mBAClE,CACb,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,GAAG,CAAC,KAClC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;;AAf5B;;;;;;;GAOG;AACH,qBAAa,UAAW,SAAQ,eASP;CAAG;AAE5B,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iCAAiC;IACjC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,iCAAiC;IACjC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;;QAaO,CAAC,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;QAC7C,CAAC,OAAO,MAAM,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;QAC9C,CAAC,WAAW,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC3C,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;iBAC9B,aAAa,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;SACrD,CAAC,YAAY,0BAA0B,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;gBAChE,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;;AAjBhF;;;;;;;GAOG;AACH,qBAAa,eAAgB,SAAQ,oBAWP;CAAG"}

package/lib/Host.js

@@ -0,0 +1,31 @@
+/**
+ * What a platform built on Effect Cluster entities, such as
+ * `@alchemy.run/domain/EffectCluster`, needs from the runner it is built on
+ * and from the gateway its callers reach entities through.
+ *
+ * @module
+ */
+import * as Context from "effect/Context";
+export { makeNamespace } from "./internal/Gateway.js";
+export { HasNoPool } from "./internal/HostedRuntime.js";
+/**
+ * The runner a Layer is being built on. A runner's bootstrap provides it
+ * while it builds its entrypoints, so a Layer that hosts an entity itself
+ * (a Domain platform's, built by the model's Layer rather than exported as
+ * a class) hands the runner that entity, and the Layer to launch with it
+ * inside the cluster (with Sharding and the workflow engine). Anywhere
+ * else, the service is absent.
+ */
+export class RunnerHost extends Context.Service()("Cluster.RunnerHost") {
+}
+/**
+ * The key-value storage of the object an entity instance runs on, on pools
+ * that give every instance an object of its own
+ * (`ClusterCloudflare.DurableObjectPool`: the instance's Durable Object).
+ * Values are structured-cloneable; writes inside `transaction` commit
+ * together, or not at all. The pool provides it to every instance it runs;
+ * on pools that share one database, the service is absent.
+ */
+export class InstanceStorage extends Context.Service()("Cluster.InstanceStorage") {
+}
+//# sourceMappingURL=Host.js.map

package/lib/Host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Host.js","sources":["../src/Host.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAK1C,OAAO,EAAsB,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,OAAO,UAAW,SAAQ,OAAO,CAAC,OAAO,EAS5C,CAAC,oBAAoB,CAAC;CAAG;AAgB5B;;;;;;;GAOG;AACH,MAAM,OAAO,eAAgB,SAAQ,OAAO,CAAC,OAAO,EAWjD,CAAC,yBAAyB,CAAC;CAAG"}

package/lib/Kubernetes/Database.d.ts

@@ -0,0 +1,40 @@
+import * as Kubernetes from "@alchemy.run/kubernetes";
+import type { Input } from "alchemy/Input";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import { Database as ClusterDatabase } from "../Database.ts";
+export interface DatabaseProps {
+    /** The cluster the database and runners run on. */
+    cluster: Kubernetes.ClusterLike | Effect.Effect<Input<Kubernetes.ClusterLike>, never, any>;
+    /**
+     * Kubernetes namespace of the database and runners.
+     * @default "default"
+     */
+    namespace?: string;
+    /**
+     * Postgres image.
+     * @default "postgres:17-alpine"
+     */
+    image?: string;
+}
+/**
+ * The database an Effect Cluster coordinates through, on Kubernetes, as a
+ * `Cluster.Database` Layer: Postgres as a Deployment behind a ClusterIP
+ * Service, on the cluster the runners run on. Nothing outside the cluster
+ * reaches it.
+ *
+ * Its data lives in the pod, so it is meant for development and tests; for
+ * a managed Postgres (RDS, Cloud SQL, Neon), pass its URL to
+ * `Cluster.Database.fromUrl` and give the pool its cluster.
+ *
+ * ### Running the database on Kubernetes
+ * **Example:** Postgres on a local kind cluster
+ * ```typescript
+ * export const Kind = Kubernetes.LocalCluster("Kind", { name: "cluster" });
+ * export const Database = ClusterKubernetes.Database("Cluster", { cluster: Kind });
+ * ```
+ *
+ * @primitive
+ */
+export declare const Database: (id: string, props: DatabaseProps) => Layer.Layer<ClusterDatabase, never, any>;
+//# sourceMappingURL=Database.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Database.d.ts","sources":["../../src/Kubernetes/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAsB,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAIjF,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,OAAO,EAAE,UAAU,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;IAC3F;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,QAAQ,OAAQ,MAAM,SAAS,aAAa,6CA2CtD,CAAC"}

package/lib/Kubernetes/Database.js

@@ -0,0 +1,56 @@
+import * as Kubernetes from "@alchemy.run/kubernetes";
+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";
+import { stackDnsLabel } from "../internal/Naming.js";
+/**
+ * The database an Effect Cluster coordinates through, on Kubernetes, as a
+ * `Cluster.Database` Layer: Postgres as a Deployment behind a ClusterIP
+ * Service, on the cluster the runners run on. Nothing outside the cluster
+ * reaches it.
+ *
+ * Its data lives in the pod, so it is meant for development and tests; for
+ * a managed Postgres (RDS, Cloud SQL, Neon), pass its URL to
+ * `Cluster.Database.fromUrl` and give the pool its cluster.
+ *
+ * ### Running the database on Kubernetes
+ * **Example:** Postgres on a local kind cluster
+ * ```typescript
+ * export const Kind = Kubernetes.LocalCluster("Kind", { name: "cluster" });
+ * export const Database = ClusterKubernetes.Database("Cluster", { cluster: Kind });
+ * ```
+ *
+ * @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 namespace = props.namespace ?? "default";
+    const cluster = Effect.isEffect(props.cluster) ? yield* props.cluster : props.cluster;
+    const name = yield* stackDnsLabel(`${id}-db`, 50);
+    const password = yield* Random(`${id}Password`, { bytes: 24 });
+    const db = yield* Kubernetes.Deployment(`${id}Postgres`, {
+        cluster,
+        name,
+        namespace,
+        image: props.image ?? "postgres:17-alpine",
+        port: 5432,
+        serviceType: "ClusterIP",
+        env: password.text.pipe(Output.map((text) => ({
+            POSTGRES_PASSWORD: Redacted.value(text),
+            POSTGRES_DB: "cluster",
+        }))),
+    });
+    return {
+        // Ordered after the Deployment: runners connect once it exists.
+        url: Output.all(db.deploymentName, password.text).pipe(Output.map(([, text]) => Redacted.make(`postgres://postgres:${encodeURIComponent(text.pipe(Redacted.value))}@${name}.${namespace}.svc.cluster.local:5432/cluster`))),
+        network: { kind: "kubernetes", cluster, namespace },
+        shardGroups: yield* clusterShardGroups(id),
+    };
+}));
+//# sourceMappingURL=Database.js.map

package/lib/Kubernetes/Database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Database.js","sources":["../../src/Kubernetes/Database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AAEtD,OAAO,KAAK,MAAM,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,QAAQ,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAkBtD;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,EAAU,EAAE,KAAoB,EAAE,EAAE,CAC3D,KAAK,CAAC,MAAM,CACV,eAAe,EACf,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,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC;IAC/C,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC;IACtF,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAI5D,CAAC;IACF,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,UAAU,EAAE;QACvD,OAAO;QACP,IAAI;QACJ,SAAS;QACT,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,oBAAoB;QAC1C,IAAI,EAAE,IAAI;QACV,WAAW,EAAE,WAAW;QACxB,GAAG,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CACrB,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;YACpB,iBAAiB,EAAE,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YACvC,WAAW,EAAE,SAAS;SACvB,CAAC,CAAC,CACiC;KACvC,CAAC,CAAC;IACH,OAAO;QACL,gEAAgE;QAChE,GAAG,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CACpD,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,EAAE,CACtB,QAAQ,CAAC,IAAI,CACX,uBAAuB,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,IAAI,SAAS,iCAAiC,CAC3H,CACF,CACF;QACD,OAAO,EAAE,EAAE,IAAI,EAAE,YAAqB,EAAE,OAAO,EAAE,SAAS,EAAE;QAC5D,WAAW,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,EAAE,CAAC;KAC3C,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}

package/lib/Kubernetes/DeploymentPool.d.ts

@@ -0,0 +1,54 @@
+import * as Kubernetes from "@alchemy.run/kubernetes";
+import { type PoolSettings } from "../internal/PoolHost.ts";
+export interface DeploymentPoolOptions extends PoolSettings {
+    /**
+     * Number of runners.
+     * @default 2
+     */
+    replicas?: number;
+    /**
+     * How the gateway's Service is exposed. `ClusterIP` serves callers in the
+     * cluster; `LoadBalancer` serves callers anywhere, where the cluster
+     * provisions load balancers.
+     * @default "ClusterIP"
+     */
+    serviceType?: "ClusterIP" | "NodePort" | "LoadBalancer";
+    /** Container CPU/memory requests and limits. */
+    resources?: {
+        requests?: {
+            cpu?: string;
+            memory?: string;
+        };
+        limits?: {
+            cpu?: string;
+            memory?: string;
+        };
+    };
+    /**
+     * CPU architecture of the runner image, built on the deploying machine.
+     * @default the cluster's
+     */
+    architecture?: "amd64" | "arm64";
+}
+/**
+ * Run a pool of Effect Cluster runners on Kubernetes: a Deployment whose pods
+ * host every class given this pool, in the database's cluster and
+ * namespace. Pods reach each other at their own addresses; the gateway is
+ * a Service of the Deployment, at
+ * `http://{name}.{namespace}.svc.cluster.local:34500` for callers in the
+ * cluster. Requires a database on a Kubernetes cluster —
+ * `ClusterKubernetes.Database`.
+ *
+ * ### Running on Kubernetes
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterKubernetes.Database("Cluster", { cluster: Kind });
+ * export const Default = ClusterKubernetes.DeploymentPool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export declare const DeploymentPool: (id: string, options?: DeploymentPoolOptions) => import("effect/Layer").Layer<import("../internal/PoolHostService.ts").PoolHost, never, import("../Database.ts").Database | import("../Providers.ts").Providers | Kubernetes.Providers | import("alchemy").Stack>;
+//# sourceMappingURL=DeploymentPool.d.ts.map

package/lib/Kubernetes/DeploymentPool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeploymentPool.d.ts","sources":["../../src/Kubernetes/DeploymentPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AAItD,OAAO,EAAiB,KAAK,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAE3E,MAAM,WAAW,qBAAsB,SAAQ,YAAY;IACzD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;OAKG;IACH,WAAW,CAAC,EAAE,WAAW,GAAG,UAAU,GAAG,cAAc,CAAC;IACxD,gDAAgD;IAChD,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QAC7C,MAAM,CAAC,EAAE;YAAE,GAAG,CAAC,EAAE,MAAM,CAAC;YAAC,MAAM,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KAC5C,CAAC;IACF;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,cAAc,OAAQ,MAAM,YAAW,qBAAqB,qNAyBrE,CAAC"}

package/lib/Kubernetes/DeploymentPool.js

@@ -0,0 +1,49 @@
+import * as Kubernetes from "@alchemy.run/kubernetes";
+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 Kubernetes: a Deployment whose pods
+ * host every class given this pool, in the database's cluster and
+ * namespace. Pods reach each other at their own addresses; the gateway is
+ * a Service of the Deployment, at
+ * `http://{name}.{namespace}.svc.cluster.local:34500` for callers in the
+ * cluster. Requires a database on a Kubernetes cluster —
+ * `ClusterKubernetes.Database`.
+ *
+ * ### Running on Kubernetes
+ * **Example:** Two runners
+ * ```typescript
+ * export const Database = ClusterKubernetes.Database("Cluster", { cluster: Kind });
+ * export const Default = ClusterKubernetes.DeploymentPool("Default", { replicas: 2 }).pipe(
+ *   Layer.provide(Database),
+ * );
+ * ```
+ *
+ * @primitive
+ */
+export const DeploymentPool = (id, options = {}) => makePoolLayer({
+    label: "ClusterKubernetes.DeploymentPool",
+    id,
+    settings: options,
+    expected: "a Kubernetes cluster (ClusterKubernetes.Database)",
+    network: (database) => (database.network?.kind === "kubernetes" ? database.network : undefined),
+    // The Deployment's Service is named after the pool.
+    gateway: (name, network) => Effect.succeed({
+        url: `http://${name}.${network.namespace}.svc.cluster.local:${GATEWAY_PORT}`,
+    }),
+    nodes: ({ network, name, program, environment }) => Kubernetes.Deployment(`${id}Pool`, {
+        cluster: network.cluster,
+        name,
+        namespace: network.namespace,
+        context: program.pipe(Output.map((p) => p.dir)),
+        replicas: options.replicas ?? 2,
+        port: GATEWAY_PORT,
+        serviceType: options.serviceType ?? "ClusterIP",
+        ...(options.resources === undefined ? {} : { resources: options.resources }),
+        ...(options.architecture === undefined ? {} : { architecture: options.architecture }),
+        env: environment,
+    }).pipe(Effect.asVoid),
+});
+//# sourceMappingURL=DeploymentPool.js.map

package/lib/Kubernetes/DeploymentPool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DeploymentPool.js","sources":["../../src/Kubernetes/DeploymentPool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,yBAAyB,CAAC;AACtD,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;AA2B3E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,EAAU,EAAE,OAAO,GAA0B,EAAE,EAAE,EAAE,CAChF,aAAa,CAAC;IACZ,KAAK,EAAE,kCAAkC;IACzC,EAAE;IACF,QAAQ,EAAE,OAAO;IACjB,QAAQ,EAAE,mDAAmD;IAC7D,OAAO,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/F,oDAAoD;IACpD,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE,CACzB,MAAM,CAAC,OAAO,CAAC;QACb,GAAG,EAAE,UAAU,IAAI,IAAI,OAAO,CAAC,SAAS,sBAAsB,YAAY,EAAE;KAC7E,CAAC;IACJ,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,CACjD,UAAU,CAAC,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE;QACjC,OAAO,EAAE,OAAO,CAAC,OAAiC;QAClD,IAAI;QACJ,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAsB;QACpE,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;QAC/B,IAAI,EAAE,YAAY;QAClB,WAAW,EAAE,OAAO,CAAC,WAAW,IAAI,WAAW;QAC/C,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;QAC5E,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC;QACrF,GAAG,EAAE,WAAgD;KACtD,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;CACzB,CAAC,CAAC"}

package/lib/Kubernetes/index.d.ts

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

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

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

package/lib/Kubernetes/index.js

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

package/lib/Kubernetes/index.js.map

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

package/lib/Pool.d.ts

@@ -0,0 +1,66 @@
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import type * as Layer from "effect/Layer";
+import type { PoolHost } from "./internal/PoolHostService.ts";
+import type { Providers } from "./Providers.ts";
+/**
+ * A pool Layer, as every host's pool returns it: provide it to an
+ * implementation to deploy it to that pool.
+ */
+export type PoolLayer<R = never> = Layer.Layer<PoolHost, never, R>;
+/** An entity class a pool is built with. */
+export interface PoolEntity {
+    /** The entity type: the class's logical id. */
+    name: string;
+    /** The module that exports the class. */
+    module: string;
+    /** The export of {@link module} that holds it. */
+    handler: string;
+    /**
+     * An existing Effect Cluster program that hosts the entity, run as it is:
+     * an external `Cluster.Entity`. It owns every runner in its set.
+     */
+    program?: string;
+}
+/** Data the entities a pool hosts bind onto it. */
+export interface PoolBindingContract {
+    entities?: PoolEntity[];
+    env?: Record<string, unknown>;
+}
+export interface PoolProps {
+    /** The pool's name, used in its service names. */
+    name: string;
+}
+export interface PoolAttributes {
+    /** The pool's name. */
+    name: string;
+    /** The entity classes the pool hosts, sorted by type. */
+    entities: PoolEntity[];
+    /** Environment values the hosted classes need, merged. */
+    env: Record<string, unknown>;
+}
+export interface Pool extends Resource<"Cluster.Pool", PoolProps, PoolAttributes, PoolBindingContract, Providers> {
+}
+/**
+ * The set of entity classes one pool hosts, collected from the
+ * entities that were given it. Pool Layers (`ClusterDocker.SwarmPool`,
+ * …) declare one and build their program from it; it owns nothing in the
+ * cloud.
+ *
+ * @internal
+ */
+export declare const Pool: import("alchemy").ResourceClass<Pool>;
+declare const PoolProgramConflict_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.PoolProgramConflict";
+} & Readonly<A>;
+/**
+ * A pool was given an external `Cluster.Entity` and something
+ * else hosted another way: an external program owns every runner it runs on.
+ */
+export declare class PoolProgramConflict extends PoolProgramConflict_base<{
+    readonly message: string;
+}> {
+}
+export declare const PoolProvider: () => Layer.Layer<Provider.Provider<Pool>, never, never>;
+export {};
+//# sourceMappingURL=Pool.d.ts.map

package/lib/Pool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pool.d.ts","sources":["../src/Pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAG5C,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAC3C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;AAEnE,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,yCAAyC;IACzC,MAAM,EAAE,MAAM,CAAC;IACf,kDAAkD;IAClD,OAAO,EAAE,MAAM,CAAC;IAChB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,mDAAmD;AACnD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,UAAU,EAAE,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,SAAS;IACxB,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,uBAAuB;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,yDAAyD;IACzD,QAAQ,EAAE,UAAU,EAAE,CAAC;IACvB,0DAA0D;IAC1D,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,IAAK,SAAQ,QAAQ,CACpC,cAAc,EACd,SAAS,EACT,cAAc,EACd,mBAAmB,EACnB,SAAS,CACV;CAAG;AAEJ;;;;;;;GAOG;AACH,eAAO,MAAM,IAAI,uCAAiC,CAAC;;;;AAEnD;;;GAGG;AACH,qBAAa,mBAAoB,SAAQ,yBAAgD;IACvF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;CAAG;AAEL,eAAO,MAAM,YAAY,0DA4BrB,CAAC"}

package/lib/Pool.js

@@ -0,0 +1,47 @@
+import * as Provider from "alchemy/Provider";
+import { Resource } from "alchemy/Resource";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+/**
+ * The set of entity classes one pool hosts, collected from the
+ * entities that were given it. Pool Layers (`ClusterDocker.SwarmPool`,
+ * …) declare one and build their program from it; it owns nothing in the
+ * cloud.
+ *
+ * @internal
+ */
+export const Pool = Resource("Cluster.Pool");
+/**
+ * A pool was given an external `Cluster.Entity` and something
+ * else hosted another way: an external program owns every runner it runs on.
+ */
+export class PoolProgramConflict extends Data.TaggedError("Cluster.PoolProgramConflict") {
+}
+export const PoolProvider = () => Provider.succeed(Pool, {
+    stables: ["name"],
+    reconcile: ({ id, news, bindings }) => Effect.gen(function* () {
+        const entities = new Map();
+        const env = {};
+        for (const { data } of bindings) {
+            for (const entity of data.entities ?? [])
+                entities.set(entity.name, entity);
+            Object.assign(env, data.env);
+        }
+        const all = [...entities.values()];
+        const programs = new Set(all.flatMap((entity) => (entity.program ? [entity.program] : [])));
+        if (programs.size > 1 || (programs.size === 1 && all.some((entity) => !entity.program))) {
+            return yield* new PoolProgramConflict({
+                message: `Runners '${id}' were given ${all.map((entity) => `'${entity.name}'`).join(", ")}, ` +
+                    `but an external program runs on every runner it is given: give each program ` +
+                    `a pool of its own, and host Alchemy entities in another pool.`,
+            });
+        }
+        return {
+            name: news.name,
+            entities: [...entities.values()].sort((a, b) => a.name.localeCompare(b.name)),
+            env,
+        };
+    }),
+    delete: () => Effect.void,
+});
+//# sourceMappingURL=Pool.js.map

package/lib/Pool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pool.js","sources":["../src/Pool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AACpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAsDxC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,QAAQ,CAAO,cAAc,CAAC,CAAC;AAEnD;;;GAGG;AACH,MAAM,OAAO,mBAAoB,SAAQ,IAAI,CAAC,WAAW,CAAC,6BAA6B,CAErF;CAAG;AAEL,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAC/B,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE;IACrB,OAAO,EAAE,CAAC,MAAM,CAAC;IACjB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CACpC,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QAClB,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAsB,CAAC;QAC/C,MAAM,GAAG,GAA4B,EAAE,CAAC;QACxC,KAAK,MAAM,EAAE,IAAI,EAAE,IAAI,QAAQ,EAAE,CAAC;YAChC,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,QAAQ,IAAI,EAAE;gBAAE,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YAC5E,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5F,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC;YACxF,OAAO,KAAK,CAAC,CAAC,IAAI,mBAAmB,CAAC;gBACpC,OAAO,EACL,YAAY,EAAE,gBAAgB,GAAG,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;oBACpF,8EAA8E;oBAC9E,+DAA+D;aAClE,CAAC,CAAC;QACL,CAAC;QACD,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,QAAQ,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YAC7E,GAAG;SACJ,CAAC;IACJ,CAAC,CAAC;IACJ,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI;CAC1B,CAAC,CAAC"}

package/lib/Providers.d.ts

@@ -0,0 +1,19 @@
+import * as Provider from "alchemy/Provider";
+import * as Layer from "effect/Layer";
+declare const Providers_base: Provider.ProviderCollection<Providers, "Cluster">;
+/** Service tag bundling every Effect Cluster provider. */
+export declare class Providers extends Providers_base {
+}
+export type ProviderRequirements = Layer.Services<ReturnType<typeof providers>>;
+/**
+ * The Effect Cluster providers Layer. Add it next to the providers of the
+ * cloud your database and runners run on.
+ *
+ * @example
+ * ```ts
+ * Alchemy.Stack("App", { providers: Layer.mergeAll(Docker.providers(), Cluster.providers()) }, ...)
+ * ```
+ */
+export declare const providers: () => Layer.Layer<Providers, never, never>;
+export {};
+//# sourceMappingURL=Providers.d.ts.map

package/lib/Providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Providers.d.ts","sources":["../src/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,QAAQ,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;;AAQtC,0DAA0D;AAC1D,qBAAa,SAAU,SAAQ,cAAmD;CAAG;AAErF,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF;;;;;;;;GAQG;AACH,eAAO,MAAM,SAAS,4CAwBnB,CAAC"}