alchemy 2.0.0-beta.42 → 2.0.0-beta.44

package/lib/Cloudflare/Workers/LocalWorkerProvider.d.ts

@@ -1,6 +1,25 @@
-import * as Provider from "../../Provider.ts";
+import { Runtime, type RuntimeServices } from "@distilled.cloud/cloudflare-runtime";
+import { Assets, Hyperdrive } from "@distilled.cloud/cloudflare-runtime/bindings";
+import * as LocalProxy from "@distilled.cloud/cloudflare-runtime/proxy/LocalProxy";
+import * as Cause from "effect/Cause";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import { AlchemyContext } from "../../AlchemyContext.ts";
 import { Stack } from "../../Stack.ts";
-import { Sidecar } from "../Local/Sidecar.ts";
+import { CloudflareEnvironment } from "../CloudflareEnvironment.ts";
 import { Worker } from "./Worker.ts";
-export declare const LocalWorkerProvider: () => import("effect/Layer").Layer<Provider.Provider<Worker<any>>, never, Stack | Sidecar>;
+declare const WorkerValidationError_base: Schema.Class<WorkerValidationError, Schema.TaggedStruct<"WorkerValidationError", {
+    readonly message: Schema.String;
+    readonly hint: Schema.optional<Schema.String>;
+    readonly value: Schema.Unknown;
+}>, Cause.YieldableError>;
+export declare class WorkerValidationError extends WorkerValidationError_base {
+}
+export declare const localRuntimeServices: (options?: {
+    port?: number;
+}) => Layer.Layer<import("@distilled.cloud/cloudflare-runtime/remote-bindings/RemoteBindings").RemoteBindings | Assets.Assets | import("@distilled.cloud/cloudflare-runtime/dev-registry/DevRegistryProxy").DevRegistryProxy | Hyperdrive.Hyperdrive | import("@distilled.cloud/cloudflare-runtime/globals/Loopback").Loopback | Runtime | LocalProxy.LocalProxy, import("effect/Config").ConfigError | import("effect/PlatformError").PlatformError | import("@distilled.cloud/cloudflare-runtime").ConfigError | import("@distilled.cloud/cloudflare-runtime").SystemError, import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | Path.Path | import("effect/unstable/http/HttpClient").HttpClient | AlchemyContext | import("@distilled.cloud/cloudflare").Credentials | CloudflareEnvironment>;
+export declare const LocalWorkerProvider: () => Layer.Layer<import("../../Provider.ts").Provider<Worker<any>>, never, Scope.Scope | import("effect/FileSystem").FileSystem | Path.Path | AlchemyContext | Stack | CloudflareEnvironment | LocalProxy.LocalProxy | RuntimeServices>;
+export {};
 //# sourceMappingURL=LocalWorkerProvider.d.ts.map

package/lib/Cloudflare/Workers/LocalWorkerProvider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalWorkerProvider.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/LocalWorkerProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,eAAO,MAAM,mBAAmB,4FA8B7B,CAAC"}
+{"version":3,"file":"LocalWorkerProvider.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/LocalWorkerProvider.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,OAAO,EAQP,KAAK,eAAe,EACrB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAGL,MAAM,EAKN,UAAU,EAUX,MAAM,8CAA8C,CAAC;AACtD,OAAO,KAAK,UAAU,MAAM,sDAAsD,CAAC;AACnF,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAKtC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,IAAI,MAAM,aAAa,CAAC;AAGpC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAKzD,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAIpE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;;;;;;AAMrC,qBAAa,qBAAsB,SAAQ,0BAO1C;CAAG;AAEJ,eAAO,MAAM,oBAAoB,GAAI,UAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAO,g0BAkBjE,CAAC;AAEJ,eAAO,MAAM,mBAAmB,0OAoV7B,CAAC"}

package/lib/Cloudflare/Workers/LocalWorkerProvider.js

@@ -1,31 +1,423 @@
+import { layerLocalProxy, layerRuntime, Runtime, RuntimeError, } from "@distilled.cloud/cloudflare-runtime";
+import { Ai, Artifacts, Assets, Browser, D1, Data, DurableObjectNamespace, Hyperdrive, Images, Json, KvNamespace, R2Bucket, Service, Text, VersionMetadata, WasmModule, WorkerLoader, } from "@distilled.cloud/cloudflare-runtime/bindings";
+import * as LocalProxy from "@distilled.cloud/cloudflare-runtime/proxy/LocalProxy";
+import * as Cause from "effect/Cause";
 import * as Effect from "effect/Effect";
-import * as Provider from "../../Provider.js";
+import * as Exit from "effect/Exit";
+import * as Fiber from "effect/Fiber";
+import * as Hash from "effect/Hash";
+import * as Layer from "effect/Layer";
+import * as Path from "effect/Path";
+import * as Redacted from "effect/Redacted";
+import * as Result from "effect/Result";
+import * as Schema from "effect/Schema";
+import * as Scope from "effect/Scope";
+import * as Stream from "effect/Stream";
+import { AlchemyContext } from "../../AlchemyContext.js";
+import { InstanceId } from "../../InstanceId.js";
+import * as RpcProvider from "../../Local/RpcProvider.js";
 import { Stack } from "../../Stack.js";
-import { Sidecar } from "../Local/Sidecar.js";
+import { Stage } from "../../Stage.js";
+import { CloudflareEnvironment } from "../CloudflareEnvironment.js";
+import { getCompatibility } from "./Compatibility.js";
+import * as Vite from "./Vite.js";
 import { Worker } from "./Worker.js";
-export const LocalWorkerProvider = () => Provider.effect(Worker, Effect.gen(function* () {
+import { getCronBindings } from "./WorkerAsyncBindings.js";
+import { WorkerBundle } from "./WorkerBundle.js";
+import { createWorkerName } from "./WorkerName.js";
+export class WorkerValidationError extends Schema.TaggedErrorClass()("WorkerValidationError", {
+    message: Schema.String,
+    hint: Schema.optional(Schema.String),
+    value: Schema.Unknown,
+}) {
+}
+export const localRuntimeServices = (options = {}) => RpcProvider.providerServicesEffect(Effect.gen(function* () {
+    const { accountId } = yield* CloudflareEnvironment;
+    const { dotAlchemy } = yield* AlchemyContext;
+    const path = yield* Path.Path;
+    return Layer.merge(layerRuntime({
+        api: {
+            accountId,
+        },
+        storage: {
+            directory: path.join(dotAlchemy, "local"),
+        },
+    }), layerLocalProxy(options.port ?? 0));
+}));
+export const LocalWorkerProvider = () => RpcProvider.effect(Worker, import.meta.resolve(
+// `import.meta.resolve(<string>)` is a runtime API — TypeScript's
+// `rewriteRelativeImportExtensions` does NOT touch the string literal, so
+// we have to pick the right extension ourselves. `import.meta.url` reflects
+// the actual on-disk extension of *this* file (`.ts` when loaded from
+// `src/` under Bun or vitest, `.js` when loaded from the compiled `lib/`
+// under Node), which is exactly the signal we need.
+import.meta.url.endsWith(".ts") ? "../Local.ts" : "../Local.js", import.meta.url), Effect.gen(function* () {
+    const { accountId } = yield* CloudflareEnvironment;
+    const bundler = yield* WorkerBundle;
+    const runtime = yield* Runtime;
     const stack = yield* Stack;
-    const sidecar = yield* Sidecar;
-    return {
-        diff: ({ id, news, newBindings, instanceId }) => sidecar.diff({
+    const path = yield* Path.Path;
+    const localProxy = yield* LocalProxy.LocalProxy;
+    const toRuntimeModules = Effect.fn(function* (bundle) {
+        const modules = [];
+        for (const file of bundle.files) {
+            const ext = path.extname(file.path);
+            const type = moduleTypeFromExtension(ext);
+            if (type === "SourceMap")
+                continue;
+            if (type === "Data" || type === "Wasm") {
+                if (!(file.content instanceof Uint8Array)) {
+                    return yield* new WorkerValidationError({
+                        message: `Expected Uint8Array for ${file.path} (${type})`,
+                        value: file.content,
+                    });
+                }
+                modules.push({
+                    name: file.path,
+                    type,
+                    content: file.content,
+                });
+            }
+            else {
+                if (typeof file.content !== "string") {
+                    return yield* new WorkerValidationError({
+                        message: `Expected string for ${file.path} (${type})`,
+                        value: file.content,
+                    });
+                }
+                modules.push({
+                    name: file.path,
+                    type,
+                    content: file.content,
+                });
+            }
+        }
+        return modules;
+    });
+    const serveScoped = Effect.fnUntraced(function* (worker, bundle) {
+        const scope = yield* Effect.scope.pipe(Effect.flatMap(Scope.fork));
+        const address = yield* runtime
+            .start({
+            name: worker.name,
+            compatibilityDate: worker.compatibility.date,
+            compatibilityFlags: worker.compatibility.flags,
+            bindings: worker.workerBindings,
+            hyperdrives: worker.hyperdrives,
+            durableObjectNamespaces: toRuntimeDurableObjectNamespaces(worker.durableObjectNamespaces),
+            modules: yield* toRuntimeModules(bundle),
+            assets: toRuntimeAssets(worker.assets),
+        })
+            .pipe(Scope.provide(scope));
+        const previous = workerdScopes.get(worker.id);
+        if (previous) {
+            yield* Effect.forkDetach(Scope.close(previous, Exit.void));
+        }
+        workerdScopes.set(worker.id, scope);
+        yield* localProxy.setLocalAddress(worker.id, address);
+        return address;
+    });
+    const buildConfig = Effect.fn(function* ({ id, props, bindings, instanceId, }) {
+        const name = yield* createWorkerName(id, props.name).pipe(Effect.provideService(Stack, stack), Effect.provideService(Stage, stack.stage), Effect.provideService(InstanceId, instanceId));
+        const compatibility = getCompatibility(props);
+        const workerBindings = [];
+        const durableObjectNamespaces = {};
+        const hyperdrives = {};
+        for (const { data } of bindings) {
+            for (const binding of data.bindings ?? []) {
+                if (binding.type === "durable_object_namespace" &&
+                    // The `durableObjectNamespaces` property is only used to declare DOs in this worker.
+                    // Otherwise, it's a cross-worker durable object binding, which cloudflare-runtime handles automatically.
+                    (!binding.scriptName || binding.scriptName === name)) {
+                    // Reuse the existing namespace id if it was provided, otherwise generate a new one.
+                    // `workerd` uses this for the object's storage path, so it must be safe to use as a file name.
+                    durableObjectNamespaces[binding.className] =
+                        binding.namespaceId ??
+                            encodeURIComponent(`${id}-${binding.className}`);
+                }
+                workerBindings.push(yield* toRuntimeBinding(binding));
+            }
+            if (data.hyperdrives) {
+                for (const [id, origin] of Object.entries(data.hyperdrives)) {
+                    hyperdrives[id] = {
+                        scheme: origin.scheme,
+                        host: origin.host,
+                        port: origin.port,
+                        user: origin.user,
+                        database: origin.database,
+                        password: Redacted.isRedacted(origin.password)
+                            ? Redacted.value(origin.password)
+                            : origin.password,
+                        sslmode: origin.sslmode,
+                    };
+                }
+            }
+        }
+        for (const [key, value] of Object.entries(props.env ?? {})) {
+            if (value === undefined)
+                continue;
+            if (Redacted.isRedacted(value)) {
+                workerBindings.push(Text.binding(key, Redacted.value(value)));
+            }
+            else if (typeof value === "string") {
+                workerBindings.push(Text.binding(key, value));
+            }
+            else {
+                workerBindings.push(Json.binding(key, value));
+            }
+        }
+        return {
             id,
-            props: news,
-            bindings: newBindings,
-            stack,
-            instanceId,
+            name,
+            compatibility,
+            workerBindings,
+            durableObjectNamespaces,
+            hyperdrives,
+            bundleOptions: {
+                id,
+                main: props.main,
+                compatibility,
+                entry: props.isExternal
+                    ? { kind: "external" }
+                    : { kind: "effect", exports: (props.exports ?? {}) },
+                stack: { name: stack.name, stage: stack.stage },
+                extraOptions: props.build,
+            },
+            assets: props.assets,
+        };
+    });
+    const runServer = Effect.fnUntraced(function* (worker) {
+        let start = Date.now();
+        let status = "start";
+        yield* bundler.watch(worker.bundleOptions).pipe(Stream.tap((event) => {
+            if (event._tag === "Start") {
+                start = Date.now();
+                if (status === "update") {
+                    return Effect.log(`[${worker.id}] Rebuilding`);
+                }
+            }
+            else if (event._tag === "Error") {
+                return Effect.logError(`[${worker.id}] Bundle error`, event.error);
+            }
+            return Effect.void;
+        }), Stream.filterMap((event) => event._tag === "Success"
+            ? Result.succeed(event.output)
+            : Result.failVoid), Stream.mapEffect((bundle) => serveScoped(worker, bundle).pipe(Effect.exit, Effect.tap((exit) => {
+            if (exit._tag === "Success") {
+                const message = Effect.log(`[${worker.id}] ${status === "update" ? "Updated" : "Started"} in ${Math.round(Date.now() - start)}ms`);
+                status = "update";
+                return message;
+            }
+            else {
+                return Effect.logError(`[${worker.id}] Error`, Cause.squash(exit.cause));
+            }
+        }))), Stream.runDrain, Effect.forkScoped);
+    });
+    const rootScope = yield* Effect.scope;
+    const workerdScopes = new Map();
+    const context = yield* Effect.context();
+    const instances = new Map();
+    const runInstance = Effect.fn(function* (options) {
+        const { id, props, bindings } = options;
+        const config = yield* buildConfig(options);
+        const url = yield* localProxy.registerWorker(id);
+        if (props.vite) {
+            const devServer = yield* Vite.viteDev(props.vite.rootDir, props.env ?? {}, {
+                compatibilityDate: config.compatibility.date,
+                compatibilityFlags: config.compatibility.flags,
+                worker: {
+                    name: config.name,
+                    bindings: config.workerBindings,
+                    durableObjectNamespaces: toRuntimeDurableObjectNamespaces(config.durableObjectNamespaces),
+                    hyperdrives: config.hyperdrives,
+                    assets: toRuntimeAssets(config.assets),
+                },
+                context,
+            });
+            const localAddress = devServer.resolvedUrls.local[0].slice(0, -1);
+            yield* localProxy.setLocalAddress(id, localAddress);
+        }
+        else {
+            yield* runServer(config);
+        }
+        return {
+            workerId: config.name,
+            workerName: config.name,
+            logpush: undefined,
+            url,
+            tags: [],
+            durableObjectNamespaces: config.durableObjectNamespaces,
+            domains: [],
+            crons: Array.from(new Set([...getCronBindings(bindings), ...(props.crons ?? [])])),
+            accountId,
+        };
+    });
+    return {
+        diff: Effect.fn(function* ({ id, news, newBindings, instanceId }) {
+            const options = {
+                id,
+                props: news,
+                bindings: newBindings,
+                instanceId,
+            };
+            const hash = Hash.structure(options);
+            return {
+                action: instances.get(options.id)?.hash === hash ? "noop" : "update",
+            };
         }),
-        // The local sidecar `serve` operation is itself a true upsert:
-        // it tears down any existing process for the worker name and
-        // starts a fresh one with the latest bindings, so observe and
-        // sync collapse into a single sidecar call.
-        reconcile: ({ id, news, bindings, instanceId }) => sidecar.reconcile({
-            id,
-            props: news,
-            bindings,
-            stack,
-            instanceId,
+        reconcile: Effect.fn(function* ({ id, news, bindings, instanceId }) {
+            const options = { id, props: news, bindings, instanceId };
+            const hash = Hash.structure(options);
+            const existing = instances.get(options.id);
+            if (existing) {
+                if (existing.hash === hash) {
+                    yield* Effect.log(`[${options.id}] No changes, using existing instance`);
+                    return yield* Fiber.join(existing.fiber);
+                }
+                yield* Effect.log(`[${options.id}] Changes detected, interrupting existing instance`);
+                yield* Fiber.interrupt(existing.fiber);
+                yield* Scope.close(existing.scope, Exit.void);
+                instances.delete(options.id);
+            }
+            const scope = yield* Scope.fork(rootScope);
+            const fiber = yield* runInstance(options).pipe(Effect.forkDetach, Scope.provide(scope));
+            instances.set(options.id, { hash, fiber, scope });
+            return yield* Fiber.join(fiber).pipe(Effect.onExit((exit) => Effect.sync(() => {
+                if (exit._tag === "Failure") {
+                    instances.delete(options.id);
+                }
+            })));
+        }),
+        delete: Effect.fn(function* ({ id }) {
+            const existing = instances.get(id);
+            if (existing) {
+                yield* Fiber.interrupt(existing.fiber);
+                yield* Scope.close(existing.scope, Exit.void);
+                instances.delete(id);
+            }
         }),
-        delete: ({ id }) => sidecar.delete(id),
     };
 }));
+const toRuntimeBinding = Effect.fnUntraced(function* (b) {
+    const unsupported = () => new WorkerValidationError({
+        message: `${b.type} bindings are not supported in local mode`,
+        value: b,
+    });
+    switch (b.type) {
+        case "ai":
+            return Ai.remote(b.name);
+        case "analytics_engine":
+            return yield* unsupported();
+        case "artifacts":
+            return Artifacts.binding(b.name, b.namespace);
+        case "assets":
+            return Assets.binding(b.name);
+        case "browser":
+            return Browser.binding(b.name);
+        case "d1":
+            return D1.remote(b.name, b.id);
+        case "data_blob":
+            return Data.binding(b.name, Buffer.from(b.part));
+        case "dispatch_namespace":
+            return yield* unsupported();
+        case "durable_object_namespace":
+            return DurableObjectNamespace.local({
+                name: b.name,
+                className: b.className,
+                scriptName: b.scriptName,
+            });
+        case "hyperdrive":
+            return Hyperdrive.binding(b.name, b.id);
+        case "images":
+            return Images.remote(b.name);
+        case "inherit":
+            return yield* unsupported();
+        case "json":
+            return Json.binding(b.name, b.json);
+        case "kv_namespace":
+            return KvNamespace.remote(b.name, b.namespaceId);
+        case "mtls_certificate":
+            return yield* unsupported();
+        case "pipelines":
+            return yield* unsupported();
+        case "plain_text":
+            return Text.binding(b.name, b.text);
+        case "queue":
+            return yield* unsupported();
+        case "r2_bucket":
+            return R2Bucket.remote(b.name, b.bucketName, b.jurisdiction);
+        case "ratelimit":
+            return yield* unsupported();
+        case "secret_key":
+            return yield* unsupported();
+        case "secret_text":
+            return Text.binding(b.name, b.text);
+        case "secrets_store_secret":
+            return yield* unsupported();
+        case "send_email":
+            return yield* unsupported();
+        case "service":
+            return Service.local({ name: b.name, scriptName: b.service });
+        case "text_blob":
+            return Data.binding(b.name, Buffer.from(b.part));
+        case "vectorize":
+            return yield* unsupported();
+        case "version_metadata":
+            return VersionMetadata.binding(b.name);
+        case "wasm_module":
+            return WasmModule.binding(b.name, Buffer.from(b.part));
+        case "worker_loader":
+            return WorkerLoader.binding(b.name);
+        case "workflow":
+            return yield* unsupported();
+        default:
+            return yield* unsupported();
+    }
+});
+const toRuntimeAssets = (assets) => {
+    if (!assets)
+        return undefined;
+    if (typeof assets === "string") {
+        return {
+            directory: assets,
+        };
+    }
+    return {
+        directory: "directory" in assets ? assets.directory : assets.path,
+        headers: assets.config?.headers,
+        redirects: assets.config?.redirects,
+        htmlHandling: assets.config?.htmlHandling,
+        notFoundHandling: assets.config?.notFoundHandling,
+        runWorkerFirst: assets.config?.runWorkerFirst,
+        serveDirectly: assets.config?.serveDirectly,
+    };
+};
+const toRuntimeDurableObjectNamespaces = (namespaces) => {
+    return Object.entries(namespaces).map(([className, namespaceId]) => ({
+        className,
+        uniqueKey: namespaceId,
+        sql: true,
+    }));
+};
+const moduleTypeFromExtension = (ext) => {
+    switch (ext) {
+        case ".wasm":
+            return "Wasm";
+        case ".txt":
+        case ".html":
+        case ".sql":
+        case ".custom":
+            return "Text";
+        case ".bin":
+            return "Data";
+        case ".mjs":
+        case ".js":
+            return "ESModule";
+        case ".cjs":
+            return "CommonJsModule";
+        case ".map":
+            return "SourceMap";
+        default:
+            return "Text";
+    }
+};
 //# sourceMappingURL=LocalWorkerProvider.js.map

package/lib/Cloudflare/Workers/LocalWorkerProvider.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalWorkerProvider.js","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/LocalWorkerProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,QAAQ,MAAM,mBAAmB,CAAC;AAC9C,OAAO,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAErC,MAAM,CAAC,MAAM,mBAAmB,GAAG,GAAG,EAAE,CACtC,QAAQ,CAAC,MAAM,CACb,MAAM,EACN,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;IAClB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,KAAK,CAAC;IAC3B,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,OAAO,CAAC;IAC/B,OAAO;QACL,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,EAAE,CAC9C,OAAO,CAAC,IAAI,CAAC;YACX,EAAE;YACF,KAAK,EAAE,IAAW;YAClB,QAAQ,EAAE,WAAkB;YAC5B,KAAK;YACL,UAAU;SACX,CAAC;QACJ,+DAA+D;QAC/D,6DAA6D;QAC7D,8DAA8D;QAC9D,4CAA4C;QAC5C,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,EAAE,EAAE,CAChD,OAAO,CAAC,SAAS,CAAC;YAChB,EAAE;YACF,KAAK,EAAE,IAAI;YACX,QAAQ;YACR,KAAK;YACL,UAAU;SACX,CAAC;QACJ,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;KACvC,CAAC;AACJ,CAAC,CAAC,CACH,CAAC"}
+{"version":3,"file":"LocalWorkerProvider.js","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/LocalWorkerProvider.ts"],"names":[],"mappings":"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"}

package/lib/Cloudflare/Workers/RpcAsync.d.ts

@@ -4,5 +4,60 @@ import type { Rpc } from "../../Rpc.ts";
 export type RpcAsync<Shape> = {
     [K in keyof Shape as K extends "fetch" ? never : K]: Shape[K] extends (...args: infer A) => Effect.Effect<infer T, any, any> ? (...args: A) => Promise<T> : Shape[K] extends (...args: infer A) => Stream.Stream<any, any, any> ? (...args: A) => Promise<ReadableStream<Uint8Array>> : Shape[K] extends Effect.Effect<infer T, any, any> ? Promise<T> : Shape[K] extends Stream.Stream<any, any, any> ? Promise<ReadableStream<Uint8Array>> : Shape[K] extends (...args: infer A) => infer R ? (...args: A) => Promise<Awaited<R>> : Promise<Shape[K]>;
 };
+/**
+ * Wrap a Cloudflare Worker RPC stub in a `Promise<T>`-shaped proxy so callers
+ * outside the Effect runtime (TanStack Start route handlers, plain Workers,
+ * test code) can `await` RPC methods directly.
+ *
+ * The proxy:
+ * - leaves `fetch` / `connect` / `Symbol.dispose` and other non-string keys
+ *   passing through to the underlying binding unchanged,
+ * - turns each `Effect<T>` / `Stream<T>` method into a `Promise<T>` /
+ *   `Promise<ReadableStream<Uint8Array>>`,
+ * - unwraps the wire envelopes produced by the Effect-side RPC bridge:
+ *   `RpcErrorEnvelope` is rethrown via {@link decodeRpcThrowable} so
+ *   `try/catch` sees an `Error` (or a tagged error object), and
+ *   `RpcStreamEnvelope` is flattened to its `ReadableStream` body.
+ *
+ * @example Three ways to reach a value from a plain Worker — direct binding, fetch, RPC
+ * ```ts
+ * import { toRpcAsync } from "alchemy/Cloudflare/Bridge";
+ * import type Backend from "./backend.ts";
+ *
+ * interface Env {
+ *   BUCKET: R2Bucket;
+ *   BACKEND: Service<Backend>;
+ * }
+ *
+ * export default {
+ *   async fetch(request: Request, env: Env): Promise<Response> {
+ *     const url = new URL(request.url);
+ *     const key = url.searchParams.get("key");
+ *     const via = url.searchParams.get("via") ?? "binding";
+ *     if (!key) return new Response("Missing 'key'", { status: 400 });
+ *
+ *     // option 1 — use the async binding directly
+ *     if (via === "binding") {
+ *       const object = await env.BUCKET.get(key);
+ *       if (!object) return new Response("Not found", { status: 404 });
+ *       return new Response(object.body);
+ *     }
+ *
+ *     // option 2 — call the Effect worker's fetch handler
+ *     if (via === "fetch") {
+ *       return env.BACKEND.fetch(
+ *         `https://backend/?key=${encodeURIComponent(key)}`,
+ *       );
+ *     }
+ *
+ *     // option 3 — call an Effect worker RPC method as a Promise
+ *     const backend = toRpcAsync<Backend>(env.BACKEND);
+ *     const value = await backend.hello(key);
+ *     if (value === null) return new Response("Not found", { status: 404 });
+ *     return new Response(value);
+ *   },
+ * };
+ * ```
+ */
 export declare const toRpcAsync: <W>(stub: any) => RpcAsync<Rpc.Shape<W>> & Service;
 //# sourceMappingURL=RpcAsync.d.ts.map

package/lib/Cloudflare/Workers/RpcAsync.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RpcAsync.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/RpcAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI;KAC3B,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC,SAAS,OAAO,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CACpE,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1B,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACjE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GACnD,KAAK,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,GACV,KAAK,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GACnC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAC5C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,MAAM,GAAG,KAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAqBxD,CAAC"}
+{"version":3,"file":"RpcAsync.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/RpcAsync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,KAAK,MAAM,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,cAAc,CAAC;AAGxC,MAAM,MAAM,QAAQ,CAAC,KAAK,IAAI;KAC3B,CAAC,IAAI,MAAM,KAAK,IAAI,CAAC,SAAS,OAAO,GAAG,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CACpE,GAAG,IAAI,EAAE,MAAM,CAAC,KACb,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GACjC,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1B,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GACjE,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GACnD,KAAK,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,GAC/C,OAAO,CAAC,CAAC,CAAC,GACV,KAAK,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,GAC3C,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,GACnC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,CAAC,KAAK,MAAM,CAAC,GAC5C,CAAC,GAAG,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GACnC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,EAAE,MAAM,GAAG,KAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAqBxD,CAAC"}

package/lib/Cloudflare/Workers/RpcAsync.js

@@ -1,4 +1,59 @@
 import { isRpcErrorEnvelope, isRpcStreamEnvelope } from "../Bridge.js";
+/**
+ * Wrap a Cloudflare Worker RPC stub in a `Promise<T>`-shaped proxy so callers
+ * outside the Effect runtime (TanStack Start route handlers, plain Workers,
+ * test code) can `await` RPC methods directly.
+ *
+ * The proxy:
+ * - leaves `fetch` / `connect` / `Symbol.dispose` and other non-string keys
+ *   passing through to the underlying binding unchanged,
+ * - turns each `Effect<T>` / `Stream<T>` method into a `Promise<T>` /
+ *   `Promise<ReadableStream<Uint8Array>>`,
+ * - unwraps the wire envelopes produced by the Effect-side RPC bridge:
+ *   `RpcErrorEnvelope` is rethrown via {@link decodeRpcThrowable} so
+ *   `try/catch` sees an `Error` (or a tagged error object), and
+ *   `RpcStreamEnvelope` is flattened to its `ReadableStream` body.
+ *
+ * @example Three ways to reach a value from a plain Worker — direct binding, fetch, RPC
+ * ```ts
+ * import { toRpcAsync } from "alchemy/Cloudflare/Bridge";
+ * import type Backend from "./backend.ts";
+ *
+ * interface Env {
+ *   BUCKET: R2Bucket;
+ *   BACKEND: Service<Backend>;
+ * }
+ *
+ * export default {
+ *   async fetch(request: Request, env: Env): Promise<Response> {
+ *     const url = new URL(request.url);
+ *     const key = url.searchParams.get("key");
+ *     const via = url.searchParams.get("via") ?? "binding";
+ *     if (!key) return new Response("Missing 'key'", { status: 400 });
+ *
+ *     // option 1 — use the async binding directly
+ *     if (via === "binding") {
+ *       const object = await env.BUCKET.get(key);
+ *       if (!object) return new Response("Not found", { status: 404 });
+ *       return new Response(object.body);
+ *     }
+ *
+ *     // option 2 — call the Effect worker's fetch handler
+ *     if (via === "fetch") {
+ *       return env.BACKEND.fetch(
+ *         `https://backend/?key=${encodeURIComponent(key)}`,
+ *       );
+ *     }
+ *
+ *     // option 3 — call an Effect worker RPC method as a Promise
+ *     const backend = toRpcAsync<Backend>(env.BACKEND);
+ *     const value = await backend.hello(key);
+ *     if (value === null) return new Response("Not found", { status: 404 });
+ *     return new Response(value);
+ *   },
+ * };
+ * ```
+ */
 export const toRpcAsync = (stub) => new Proxy(stub, {
     get: (target, prop) => {
         // `Service` methods (fetch/connect) and any non-string keys (Symbol.dispose, etc.)