alchemy 2.0.0-beta.43 → 2.0.0-beta.45

package/lib/KeyPair.js

@@ -0,0 +1,102 @@
+import * as NodeCrypto from "node:crypto";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import * as Provider from "./Provider.js";
+import { Resource } from "./Resource.js";
+/**
+ * A deterministic-in-state public/private keypair generator.
+ *
+ * The keypair is generated once on first reconcile and then persisted in
+ * state so subsequent deploys keep the same keys unless the resource is
+ * replaced. `privateKey` is PEM-encoded `pkcs8` and `publicKey` is
+ * PEM-encoded `spki`.
+ *
+ * @resource
+ *
+ * @section Generating a Keypair
+ * @example Default ed25519 keypair
+ * ```typescript
+ * const keys = yield* KeyPair("signing-key");
+ * // keys.privateKey: Redacted<string>  (PEM pkcs8)
+ * // keys.publicKey:  string            (PEM spki)
+ * // keys.algorithm:  "ed25519"
+ * ```
+ *
+ * @example RSA keypair
+ * ```typescript
+ * const keys = yield* KeyPair("rsa-key", {
+ *   algorithm: "rsa",
+ *   modulusLength: 2048,
+ * });
+ * ```
+ *
+ * @example EC keypair on a named curve
+ * ```typescript
+ * const keys = yield* KeyPair("ec-key", {
+ *   algorithm: "ec",
+ *   namedCurve: "P-256",
+ * });
+ * ```
+ *
+ * @section Consuming the Keys
+ * @example Pass the private key to a Worker as a secret
+ * ```typescript
+ * const keys = yield* KeyPair("signing-key");
+ * export const Worker = Cloudflare.Worker("Worker", {
+ *   main: "./src/worker.ts",
+ *   bindings: {
+ *     SIGNING_KEY: keys.privateKey,
+ *     PUBLIC_KEY: keys.publicKey,
+ *   },
+ * });
+ * ```
+ */
+export const KeyPair = Resource("Alchemy.KeyPair");
+const pemEncoding = {
+    privateKeyEncoding: { type: "pkcs8", format: "pem" },
+    publicKeyEncoding: { type: "spki", format: "pem" },
+};
+const generate = (props) => {
+    const algorithm = props.algorithm ?? "ed25519";
+    if (algorithm === "rsa") {
+        const { privateKey, publicKey } = NodeCrypto.generateKeyPairSync("rsa", {
+            modulusLength: props.modulusLength ?? 2048,
+            ...pemEncoding,
+        });
+        return { algorithm, privateKey, publicKey };
+    }
+    if (algorithm === "ec") {
+        const { privateKey, publicKey } = NodeCrypto.generateKeyPairSync("ec", {
+            namedCurve: props.namedCurve ?? "P-256",
+            ...pemEncoding,
+        });
+        return { algorithm, privateKey, publicKey };
+    }
+    const { privateKey, publicKey } = NodeCrypto.generateKeyPairSync("ed25519", pemEncoding);
+    return { algorithm, privateKey, publicKey };
+};
+export const KeyPairProvider = () => Provider.succeed(KeyPair, {
+    reconcile: Effect.fn(function* ({ news = {}, output }) {
+        // Observe — there is no remote state. The cached `output` is the
+        // authoritative current value; once minted the keypair is preserved
+        // across reconciles to keep it stable.
+        if (output?.privateKey && output?.publicKey) {
+            return output;
+        }
+        // Ensure — no observed value: mint a fresh keypair. The next
+        // reconcile will see this in `output` and short-circuit above.
+        const generated = yield* Effect.sync(() => generate(news));
+        return {
+            algorithm: generated.algorithm,
+            privateKey: Redacted.make(generated.privateKey),
+            publicKey: generated.publicKey,
+        };
+    }),
+    delete: Effect.fn(function* () {
+        return undefined;
+    }),
+    read: Effect.fn(function* ({ output }) {
+        return output;
+    }),
+});
+//# sourceMappingURL=KeyPair.js.map

package/lib/KeyPair.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyPair.js","sourceRoot":"","sources":["../src/KeyPair.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,UAAU,MAAM,aAAa,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,QAAQ,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAgCzC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAU,iBAAiB,CAAC,CAAC;AAE5D,MAAM,WAAW,GAAG;IAClB,kBAAkB,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE;IACpD,iBAAiB,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE;CAC1C,CAAC;AAEX,MAAM,QAAQ,GAAG,CACf,KAAmB,EAKnB,EAAE;IACF,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC;IAC/C,IAAI,SAAS,KAAK,KAAK,EAAE,CAAC;QACxB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,KAAK,EAAE;YACtE,aAAa,EAAE,KAAK,CAAC,aAAa,IAAI,IAAI;YAC1C,GAAG,WAAW;SACf,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAAC,IAAI,EAAE;YACrE,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,OAAO;YACvC,GAAG,WAAW;SACf,CAAC,CAAC;QACH,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;IAC9C,CAAC;IACD,MAAM,EAAE,UAAU,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC,mBAAmB,CAC9D,SAAS,EACT,WAAW,CACZ,CAAC;IACF,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAClC,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE;IACxB,SAAS,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,IAAI,GAAG,EAAE,EAAE,MAAM,EAAE;QACnD,iEAAiE;QACjE,oEAAoE;QACpE,uCAAuC;QACvC,IAAI,MAAM,EAAE,UAAU,IAAI,MAAM,EAAE,SAAS,EAAE,CAAC;YAC5C,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,6DAA6D;QAC7D,+DAA+D;QAC/D,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;QAC3D,OAAO;YACL,SAAS,EAAE,SAAS,CAAC,SAAS;YAC9B,UAAU,EAAE,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;YAC/C,SAAS,EAAE,SAAS,CAAC,SAAS;SAC/B,CAAC;IACJ,CAAC,CAAC;IACF,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC;QACzB,OAAO,SAAS,CAAC;IACnB,CAAC,CAAC;IACF,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE;QACnC,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;CACH,CAAC,CAAC"}

package/lib/Local/RpcProvider.d.ts

@@ -0,0 +1,56 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type { Scope } from "effect/Scope";
+import { InstanceId } from "../InstanceId.ts";
+import type { Platform } from "../Platform.ts";
+import * as Provider from "../Provider.ts";
+import type { ResourceClass, ResourceLike } from "../Resource.ts";
+import { Stack } from "../Stack.ts";
+/**
+ * Constructs an RpcProvider for a given resource.
+ *
+ * An RpcProvider is a resource provider that can run in a separate process.
+ * This is used for local development so that the resource provider and its state can outlive the user's code when it is hot-reloaded.
+ * If the {@link RpcProviderProxy} is provided, the provider is run in a separate process, which we communicate with here using a websocket.
+ * Otherwise, the given effect is used to construct the provider directly.
+ *
+ * @note If the provider is running in a separate process, you may not need to construct all of its layers in this process.
+ *       You can use {@link providerServices} or {@link providerServicesEffect} to construct such layers only when they are needed.
+ *
+ * @example
+ * ```ts
+ * export const MyProvider = RpcProvider.effect(
+ *   MyResource,
+ *   import.meta.resolve("./my-rpc-provider-server.ts"),
+ *   Effect.gen(function* () {
+ *     return {
+ *       diff: ...,
+ *       reconcile: ...,
+ *       delete: ...,
+ *     }
+ *   })
+ * )
+ * ```
+ *
+ * @param cls - The tag of the resource class to construct a provider for.
+ * @param serverEntryUrl - The main file for the server entry point, if the provider is to be run in a separate process. This is typically obtained using `import.meta.url` or `import.meta.resolve`.
+ * @param eff - The Effect to use to construct the provider.
+ * @returns A layer containing the RpcProvider.
+ */
+export declare const effect: <R extends ResourceLike, Req = never, ReadReq = never, DiffReq = never, PrecreateReq = never, ReconcileReq = never, DeleteReq = never, TailReq = never, LogsReq = never>(cls: ResourceClass<R> | Platform<R, any, any, any, any>, serverEntryUrl: string, eff: Effect.Effect<Provider.ProviderService<R, ReadReq, DiffReq, PrecreateReq, ReconcileReq, DeleteReq, TailReq, LogsReq>, never, Req>) => Layer.Layer<Provider.Provider<R>, never, import("../AlchemyContext.ts").AlchemyContext | Stack | Exclude<Req, import("../Artifacts.ts").Artifacts | InstanceId> | Exclude<ReadReq, import("../Artifacts.ts").Artifacts | InstanceId> | Exclude<DiffReq, import("../Artifacts.ts").Artifacts | InstanceId> | Exclude<PrecreateReq, import("../Artifacts.ts").Artifacts | InstanceId> | Exclude<ReconcileReq, import("../Artifacts.ts").Artifacts | InstanceId> | Exclude<DeleteReq, import("../Artifacts.ts").Artifacts | InstanceId>>;
+/**
+ * Conditionally constructs a layer for use by an RpcProvider.
+ * If the {@link RpcProviderProxy} is present in context, the layer is empty because it will not be used in this process.
+ * Otherwise, the given layer is returned.
+ * @param self - The layer that is used by the RpcProvider.
+ * @returns A layer that is empty if the {@link RpcProviderProxy} is present in context, otherwise the given layer.
+ */
+export declare const providerServices: <ROut, E, RIn>(self: Layer.Layer<ROut, E, RIn>) => Layer.Layer<ROut, E, RIn>;
+/**
+ * Conditionally constructs a layer for use by an RpcProvider.
+ * If the {@link RpcProviderProxy} is present in context, the layer is empty because it will not be used in this process.
+ * Otherwise, the given layer is returned.
+ * @param self - An effect which returns a layer that is used by the RpcProvider.
+ */
+export declare const providerServicesEffect: <A, E1, R1, E, R>(self: Effect.Effect<Layer.Layer<A, E1, R1>, E, R>) => Layer.Layer<A, E | E1, R1 | Exclude<R, Scope>>;
+//# sourceMappingURL=RpcProvider.d.ts.map

package/lib/Local/RpcProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProvider.d.ts","sourceRoot":"","sources":["../../src/Local/RpcProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAIpC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,eAAO,MAAM,MAAM,GACjB,CAAC,SAAS,YAAY,EACtB,GAAG,GAAG,KAAK,EACX,OAAO,GAAG,KAAK,EACf,OAAO,GAAG,KAAK,EACf,YAAY,GAAG,KAAK,EACpB,YAAY,GAAG,KAAK,EACpB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,KAAK,EACf,OAAO,GAAG,KAAK,EAEf,KAAK,aAAa,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,EACvD,gBAAgB,MAAM,EACtB,KAAK,MAAM,CAAC,MAAM,CAChB,QAAQ,CAAC,eAAe,CACtB,CAAC,EACD,OAAO,EACP,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,SAAS,EACT,OAAO,EACP,OAAO,CACR,EACD,KAAK,EACL,GAAG,CACJ,0gBAmCA,CAAC;AAaJ;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,IAAI,EAAE,CAAC,EAAE,GAAG,EAC3C,MAAM,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,KAC9B,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,CAAiD,CAAC;AAE7E;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,GAAI,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EACpD,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,KAChD,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,KAAK,CAAC,CAM7C,CAAC"}

package/lib/Local/RpcProvider.js

@@ -0,0 +1,83 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Predicate from "effect/Predicate";
+import * as Stream from "effect/Stream";
+import { InstanceId } from "../InstanceId.js";
+import * as Provider from "../Provider.js";
+import { Stack } from "../Stack.js";
+import { Stage } from "../Stage.js";
+import { RpcProviderProxy } from "./RpcProviderProxy.js";
+/**
+ * Constructs an RpcProvider for a given resource.
+ *
+ * An RpcProvider is a resource provider that can run in a separate process.
+ * This is used for local development so that the resource provider and its state can outlive the user's code when it is hot-reloaded.
+ * If the {@link RpcProviderProxy} is provided, the provider is run in a separate process, which we communicate with here using a websocket.
+ * Otherwise, the given effect is used to construct the provider directly.
+ *
+ * @note If the provider is running in a separate process, you may not need to construct all of its layers in this process.
+ *       You can use {@link providerServices} or {@link providerServicesEffect} to construct such layers only when they are needed.
+ *
+ * @example
+ * ```ts
+ * export const MyProvider = RpcProvider.effect(
+ *   MyResource,
+ *   import.meta.resolve("./my-rpc-provider-server.ts"),
+ *   Effect.gen(function* () {
+ *     return {
+ *       diff: ...,
+ *       reconcile: ...,
+ *       delete: ...,
+ *     }
+ *   })
+ * )
+ * ```
+ *
+ * @param cls - The tag of the resource class to construct a provider for.
+ * @param serverEntryUrl - The main file for the server entry point, if the provider is to be run in a separate process. This is typically obtained using `import.meta.url` or `import.meta.resolve`.
+ * @param eff - The Effect to use to construct the provider.
+ * @returns A layer containing the RpcProvider.
+ */
+export const effect = (cls, serverEntryUrl, eff) => Provider.effect(cls, Effect.gen(function* () {
+    const client = yield* Effect.serviceOption(RpcProviderProxy);
+    const stack = yield* Stack;
+    if (client._tag === "None") {
+        const provider = yield* eff;
+        return new Proxy(provider, {
+            get: (target, prop) => {
+                const value = target[prop];
+                if (!Predicate.isFunction(value))
+                    return value;
+                return (...args) => {
+                    const result = value(...args);
+                    const services = Layer.mergeAll(layerFallback(Stack, stack), layerFallback(Stage, stack.stage), Predicate.hasProperty(args[0], "instanceId") &&
+                        Predicate.isString(args[0].instanceId)
+                        ? layerFallback(InstanceId, args[0].instanceId)
+                        : Layer.empty);
+                    return result.pipe(Stream.isStream(result)
+                        ? Stream.provide(services)
+                        : Effect.provide(services));
+                };
+            },
+        });
+    }
+    return yield* client.value.get(serverEntryUrl, cls.Type);
+}));
+const layerFallback = (service, defaultValue) => Layer.effect(service, Effect.serviceOption(service).pipe(Effect.map(Option.getOrElse(() => defaultValue))));
+/**
+ * Conditionally constructs a layer for use by an RpcProvider.
+ * If the {@link RpcProviderProxy} is present in context, the layer is empty because it will not be used in this process.
+ * Otherwise, the given layer is returned.
+ * @param self - The layer that is used by the RpcProvider.
+ * @returns A layer that is empty if the {@link RpcProviderProxy} is present in context, otherwise the given layer.
+ */
+export const providerServices = (self) => providerServicesEffect(Effect.succeed(self));
+/**
+ * Conditionally constructs a layer for use by an RpcProvider.
+ * If the {@link RpcProviderProxy} is present in context, the layer is empty because it will not be used in this process.
+ * Otherwise, the given layer is returned.
+ * @param self - An effect which returns a layer that is used by the RpcProvider.
+ */
+export const providerServicesEffect = (self) => Effect.serviceOption(RpcProviderProxy).pipe(Effect.flatMap((client) => client._tag === "None" ? self : Effect.succeed(Layer.empty)), Layer.unwrap);
+//# sourceMappingURL=RpcProvider.js.map

package/lib/Local/RpcProvider.js.map

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

package/lib/Local/RpcProviderProxy.d.ts

@@ -0,0 +1,19 @@
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { AlchemyContext } from "../AlchemyContext.ts";
+import type { ProviderService } from "../Provider.ts";
+import type { ResourceLike } from "../Resource.ts";
+import { Stack } from "../Stack.ts";
+declare const RpcProviderProxy_base: Context.ServiceClass<RpcProviderProxy, "alchemy/Local/RpcProviderProxy", {
+    readonly get: <R extends ResourceLike>(serverEntryUrl: string, providerName: R["Type"]) => Effect.Effect<ProviderService<R>, never, AlchemyContext | Stack>;
+}>;
+export declare class RpcProviderProxy extends RpcProviderProxy_base {
+}
+export declare const SPAWNER_URL_ENV_KEY: "ALCHEMY_RPC_SPAWNER_URL";
+export declare const layer: (url: string) => Layer.Layer<RpcProviderProxy, never, HttpClient.HttpClient>;
+export declare const fromEnv: () => Layer.Layer<RpcProviderProxy, Config.ConfigError, HttpClient.HttpClient>;
+export {};
+//# sourceMappingURL=RpcProviderProxy.d.ts.map

package/lib/Local/RpcProviderProxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcProviderProxy.d.ts","sourceRoot":"","sources":["../../src/Local/RpcProviderProxy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;;kBAQlB,CAAC,CAAC,SAAS,YAAY,EACnC,cAAc,EAAE,MAAM,EACtB,YAAY,EAAE,CAAC,CAAC,MAAM,CAAC,KACpB,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,cAAc,GAAG,KAAK,CAAC;;AANzE,qBAAa,gBAAiB,SAAQ,qBAQD;CAAG;AAExC,eAAO,MAAM,mBAAmB,EAAG,yBAAkC,CAAC;AAqDtE,eAAO,MAAM,KAAK,GAAI,KAAK,MAAM,gEAA8C,CAAC;AAEhF,eAAO,MAAM,OAAO,gFAIjB,CAAC"}

package/lib/Local/RpcProviderProxy.js

@@ -0,0 +1,48 @@
+import { newWebSocketRpcSession } from "capnweb";
+import * as Cache from "effect/Cache";
+import * as Config from "effect/Config";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as HttpBody from "effect/unstable/http/HttpBody";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { AlchemyContext } from "../AlchemyContext.js";
+import { Stack } from "../Stack.js";
+import { unwrapRpcHandlers } from "./RpcSerialization.js";
+export class RpcProviderProxy extends Context.Service()("alchemy/Local/RpcProviderProxy") {
+}
+export const SPAWNER_URL_ENV_KEY = "ALCHEMY_RPC_SPAWNER_URL";
+const make = Effect.fnUntraced(function* (spawnerUrl) {
+    const client = yield* HttpClient.HttpClient;
+    const getSession = Effect.fnUntraced(function* (serverEntryUrl) {
+        const alchemyContext = yield* AlchemyContext;
+        const stack = yield* Stack;
+        const payload = {
+            serverEntryUrl,
+            alchemyContext,
+            stack: { name: stack.name, stage: stack.stage },
+        };
+        const response = yield* client.post(spawnerUrl, {
+            body: yield* HttpBody.json(payload),
+        });
+        const websocketUrl = yield* response.text;
+        return newWebSocketRpcSession(websocketUrl);
+    }, (effect, serverEntryUrl) => Effect.catch(effect, (error) => Effect.die(new Error(`Failed to create provider RPC session for "${serverEntryUrl}"`, {
+        cause: error,
+    }))));
+    const cache = yield* Cache.make({
+        lookup: getSession,
+        capacity: Infinity,
+        requireServicesAt: "lookup",
+    });
+    return RpcProviderProxy.of({
+        get: Effect.fnUntraced(function* (mainUrl, providerName) {
+            const session = yield* cache.lookup(mainUrl);
+            const provider = yield* Effect.promise(() => session.getProvider(providerName));
+            return unwrapRpcHandlers(provider, ["tail"]);
+        }),
+    });
+});
+export const layer = (url) => Layer.effect(RpcProviderProxy, make(url));
+export const fromEnv = () => Layer.effect(RpcProviderProxy, Config.string(SPAWNER_URL_ENV_KEY).pipe(Effect.flatMap(make)));
+//# sourceMappingURL=RpcProviderProxy.js.map

package/lib/Local/RpcProviderProxy.js.map

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

package/lib/Local/RpcSerialization.d.ts

@@ -0,0 +1,34 @@
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+type RpcEffectHandler<Args extends Array<any>, Success, Error> = (...args: Args) => Effect.Effect<Success, Error>;
+type RpcWrappedEffectHandler<Args extends Array<any>, Success, Error> = (args: Args) => Promise<RpcSerializedExit<Success, Error>>;
+type RpcStreamHandler<Args extends Array<any>, Success, Error> = (...args: Args) => Stream.Stream<Success, Error>;
+type RpcWrappedStreamHandler<Args extends Array<any>, Success, Error> = (args: Args) => RpcSerializedStream<Success, Error>;
+type RpcSerializedStream<Success, _Error> = ReadableStream<Success>;
+type RpcSerializedExit<Success, Error> = {
+    _tag: "Success";
+    value: Success;
+} | {
+    _tag: "Failure";
+    cause: Array<RpcSerializedCause<Error>>;
+};
+type RpcSerializedCause<Error> = {
+    _tag: "Fail";
+    error: Error;
+} | {
+    _tag: "Die";
+    defect: unknown;
+} | {
+    _tag: "Interrupt";
+    fiberId: number | undefined;
+};
+export type RpcWrapped<T> = T extends RpcEffectHandler<infer Args, infer Success, infer Error> ? RpcWrappedEffectHandler<Args, Success, Error> : T extends RpcStreamHandler<infer Args, infer Success, infer Error> ? RpcWrappedStreamHandler<Args, Success, Error> : T extends Record<string, any> ? {
+    [K in keyof T]: RpcWrapped<T[K]>;
+} : T;
+export type RpcUnwrapped<T> = T extends RpcWrappedEffectHandler<infer Args, infer Success, infer Error> ? RpcEffectHandler<Args, Success, Error> : T extends RpcWrappedStreamHandler<infer Args, infer Success, infer Error> ? RpcStreamHandler<Args, Success, Error> : T extends Record<string, any> ? {
+    [K in keyof T]: RpcUnwrapped<T[K]>;
+} : T;
+export declare const wrapRpcHandlers: <T extends Record<string, any>>(handlers: T, streamKeys?: Array<keyof T>) => RpcWrapped<T>;
+export declare const unwrapRpcHandlers: <T extends Record<string, any>>(handlers: RpcWrapped<T>, streamKeys?: Array<keyof T>) => RpcUnwrapped<T>;
+export {};
+//# sourceMappingURL=RpcSerialization.d.ts.map

package/lib/Local/RpcSerialization.d.ts.map

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

package/lib/Local/RpcSerialization.js

@@ -0,0 +1,120 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Exit from "effect/Exit";
+import { flow } from "effect/Function";
+import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
+import * as Stream from "effect/Stream";
+import * as NodeUtil from "node:util";
+import * as Output from "../Output.js";
+export const wrapRpcHandlers = (handlers, streamKeys) => {
+    return Object.fromEntries(Object.entries(handlers).map(([key, value]) => [
+        key,
+        typeof value === "function"
+            ? streamKeys?.includes(key)
+                ? wrapRpcStreamHandler(value)
+                : wrapRpcEffectHandler(value)
+            : typeof value === "object" && value !== null
+                ? wrapRpcHandlers(value)
+                : value,
+    ]));
+};
+export const unwrapRpcHandlers = (handlers, streamKeys) => {
+    return Object.fromEntries(Object.entries(handlers).map(([key, value]) => [
+        key,
+        typeof value === "function"
+            ? streamKeys?.includes(key)
+                ? unwrapRpcStreamHandler(value)
+                : unwrapRpcEffectHandler(value)
+            : typeof value === "object" && value !== null
+                ? unwrapRpcHandlers(value)
+                : value,
+    ]));
+};
+const serializeError = Schema.encodeSync(Schema.Defect);
+const wrapRpcEffectHandler = (handler) => flow((args) => deserializeRpcArgs(args), (args) => handler(...args), Effect.exit, Effect.map((exit) => {
+    if (exit._tag === "Success") {
+        return { _tag: "Success", value: exit.value };
+    }
+    return {
+        _tag: "Failure",
+        cause: exit.cause.reasons.map((reason) => {
+            switch (reason._tag) {
+                case "Fail":
+                    return { _tag: "Fail", error: serializeError(reason.error) };
+                case "Die":
+                    return { _tag: "Die", defect: serializeError(reason.defect) };
+                case "Interrupt":
+                    return { _tag: "Interrupt", fiberId: reason.fiberId };
+            }
+        }),
+    };
+}), Effect.runPromise);
+const wrapRpcStreamHandler = (handler) => flow((args) => deserializeRpcArgs(args), (args) => handler(...args), (stream) => Stream.toReadableStream(stream));
+const unwrapRpcEffectHandler = (handler) => flow((...args) => serializeRpcArgs(args), (args) => Effect.promise(() => handler(args)), Effect.flatMap((exit) => {
+    if (exit._tag === "Success") {
+        return Exit.succeed(exit.value);
+    }
+    return Exit.failCause(Cause.fromReasons(exit.cause.map((reason) => {
+        switch (reason._tag) {
+            case "Fail":
+                return Cause.makeFailReason(reason.error);
+            case "Die":
+                return Cause.makeDieReason(reason.defect);
+            case "Interrupt":
+                return Cause.makeInterruptReason(reason.fiberId);
+        }
+    })));
+}));
+const unwrapRpcStreamHandler = (handler) => flow((...args) => serializeRpcArgs(args), (args) => handler(args), (stream) => Stream.fromReadableStream({
+    evaluate: () => stream,
+    onError: (error) => error,
+}));
+const serializeRpcArgs = (value) => {
+    if (Redacted.isRedacted(value)) {
+        return { _tag: "Redacted", value: Redacted.value(value) };
+    }
+    if (Output.isOutput(value)) {
+        return {
+            _tag: "Output",
+            description: NodeUtil.inspect(value),
+        };
+    }
+    if (typeof value === "function") {
+        return null;
+    }
+    if (Array.isArray(value)) {
+        return value.map(serializeRpcArgs);
+    }
+    if (value && typeof value === "object" && !("toJSON" in value)) {
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+            key,
+            serializeRpcArgs(child),
+        ]));
+    }
+    return value;
+};
+const deserializeRpcArgs = (value) => {
+    if (Array.isArray(value)) {
+        return value.map(deserializeRpcArgs);
+    }
+    else if (typeof value === "object" && value !== null) {
+        // These values are serialized as `{_tag: "Redacted", value: ...}` and `{_tag: "Output", description: ...}`,
+        // so we need to detect them manually - Redacted.isRedacted and Output.isOutput do not work.
+        if ("_tag" in value && value._tag === "Redacted" && "value" in value) {
+            return Redacted.make(value.value);
+        }
+        else if ("_tag" in value &&
+            value._tag === "Output" &&
+            "description" in value &&
+            typeof value.description === "string") {
+            return new Output.NamedExpr(new Output.EffectExpr(Output.VoidExpr, () => Effect.never), value.description);
+        }
+        return Object.fromEntries(Object.entries(value).map(([key, child]) => [
+            key,
+            deserializeRpcArgs(child),
+        ]));
+    }
+    return value;
+};
+//# sourceMappingURL=RpcSerialization.js.map

package/lib/Local/RpcSerialization.js.map

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

package/lib/Local/RpcServer.d.ts

@@ -0,0 +1,63 @@
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import type * as Scope from "effect/Scope";
+import type { HttpClient } from "effect/unstable/http/HttpClient";
+import type { ProviderService } from "../Provider.ts";
+import type { ResourceLike } from "../Resource.ts";
+import { PlatformServices } from "../Util/PlatformServices.ts";
+import * as RpcSerialization from "./RpcSerialization.ts";
+import * as RpcServerEnvironment from "./RpcServerEnvironment.ts";
+import { type ServerRpcSession, type ServerWebSocketLike } from "./RpcServerSession.ts";
+declare const RpcServer_base: Context.ServiceClass<RpcServer, "alchemy/Local/RpcServer", never>;
+/**
+ * A service that exposes one or more resource providers over RPC.
+ * This returns `never` because it is meant to be used with `Layer.launch` (see {@link launch}).
+ */
+export declare class RpcServer extends RpcServer_base {
+}
+/**
+ * The RPC API that is implemented by the server and consumed by {@link RpcProviderProxy}.
+ */
+export interface RpcProxyApi {
+    /**
+     * Retrieves a provider from the RPC server context.
+     * The consumer must unwrap the provider using {@link RpcSerialization.unwrapRpcHandlers} before using it.
+     */
+    readonly getProvider: <R extends ResourceLike>(type: R["Type"]) => Promise<RpcSerialization.RpcWrapped<ProviderService<R>>>;
+}
+/**
+ * Launches an RPC server that serves the given providers.
+ * Alchemy globals such as `AlchemyContext`, `Profile`, and `Stack` are inherited from the parent via {@link RpcServerEnvironment.fromEnv} and should not be provided manually.
+ * `PlatformServices` and `HttpClient` are also included.
+ *
+ * @example
+ * ```ts
+ * RpcServer.launch(
+ *   Layer.merge(
+ *     FunctionProvider,
+ *     QueueProvider,
+ *   ),
+ * );
+ * ```
+ *
+ * @param providers - A layer containing the providers to serve.
+ */
+export declare const launch: <ROut, E>(providers: Layer.Layer<ROut, E, Scope.Scope | RpcServerEnvironment.RpcEnvironmentServices | PlatformServices | HttpClient>) => void;
+/**
+ * Constructs an `RpcServer` layer using the given server implementation.
+ * @param serve - A function that spawns a websocket server and returns its URL.
+ * @returns An `RpcServer` layer.
+ */
+export declare const layerServer: (serve: (handlers: {
+    /** Creates a new RPC session over the given websocket. */
+    createRpcSession: (ws: ServerWebSocketLike) => ServerRpcSession<RpcProxyApi>;
+    /** Called when the parent connection, indicated by the `/parent` path, is established. */
+    parentConnected: () => void;
+    /** Called when the parent disconnects. The server will shut down when this is called. */
+    parentDisconnected: () => void;
+}) => Effect.Effect<{
+    readonly url: string;
+}, never, Scope.Scope>) => Layer.Layer<RpcServer, import("effect/Cause").TimeoutError, never>;
+export {};
+//# sourceMappingURL=RpcServer.d.ts.map

package/lib/Local/RpcServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RpcServer.d.ts","sourceRoot":"","sources":["../../src/Local/RpcServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,KAAK,KAAK,MAAM,cAAc,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAEL,gBAAgB,EAEjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,gBAAgB,MAAM,uBAAuB,CAAC;AAC1D,OAAO,KAAK,oBAAoB,MAAM,2BAA2B,CAAC;AAClE,OAAO,EAEL,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACzB,MAAM,uBAAuB,CAAC;;AAE/B;;;GAGG;AACH,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,SAAS,YAAY,EAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KACZ,OAAO,CAAC,gBAAgB,CAAC,UAAU,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC/D;AAaD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,MAAM,GAAI,IAAI,EAAE,CAAC,EAC5B,WAAW,KAAK,CAAC,KAAK,CACpB,IAAI,EACJ,CAAC,EACC,KAAK,CAAC,KAAK,GACX,oBAAoB,CAAC,sBAAsB,GAC3C,gBAAgB,GAChB,UAAU,CACb,SASA,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,CAAC,QAAQ,EAAE;IAChB,0DAA0D;IAC1D,gBAAgB,EAAE,CAChB,EAAE,EAAE,mBAAmB,KACpB,gBAAgB,CAAC,WAAW,CAAC,CAAC;IACnC,0FAA0F;IAC1F,eAAe,EAAE,MAAM,IAAI,CAAC;IAC5B,yFAAyF;IACzF,kBAAkB,EAAE,MAAM,IAAI,CAAC;CAChC,KAAK,MAAM,CAAC,MAAM,CAAC;IAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,uEA+BhE,CAAC"}