alchemy 2.0.0-beta.4 → 2.0.0-beta.41

package/lib/Cloudflare/Workers/Request.js

@@ -0,0 +1,4 @@
+import * as Context from "effect/Context";
+export class Request extends Context.Service()("Request") {
+}
+//# sourceMappingURL=Request.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Request.js","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/Request.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAE1C,MAAM,OAAO,OAAQ,SAAQ,OAAO,CAAC,OAAO,EAA+B,CACzE,SAAS,CACV;CAAG"}

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

@@ -0,0 +1,90 @@
+import * as Cause from "effect/Cause";
+import * as Effect from "effect/Effect";
+import * as Stream from "effect/Stream";
+import * as Socket from "effect/unstable/socket/Socket";
+export declare const StreamTag = "~alchemy/rpc/stream";
+export declare const ErrorTag = "~alchemy/rpc/error";
+export declare const StreamErrorTag = "~alchemy/rpc/stream-error";
+type StreamEncoding = "bytes" | "jsonl";
+export type RpcStreamEnvelope = {
+    _tag: typeof StreamTag;
+    encoding: StreamEncoding;
+    body: ReadableStream<Uint8Array>;
+};
+declare const RpcDecodeError_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]; }>) => Cause.YieldableError & {
+    readonly _tag: "RpcDecodeError";
+} & Readonly<A>;
+export declare class RpcDecodeError extends RpcDecodeError_base<{
+    readonly cause: unknown;
+}> {
+    get message(): string;
+}
+declare const RpcCallError_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]; }>) => Cause.YieldableError & {
+    readonly _tag: "RpcCallError";
+} & Readonly<A>;
+export declare class RpcCallError extends RpcCallError_base<{
+    readonly method: string;
+    readonly cause: unknown;
+}> {
+    get message(): string;
+}
+declare const RpcRemoteStreamError_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]; }>) => Cause.YieldableError & {
+    readonly _tag: "RpcRemoteStreamError";
+} & Readonly<A>;
+export declare class RpcRemoteStreamError extends RpcRemoteStreamError_base<{
+    readonly error: unknown;
+}> {
+}
+export type RpcErrorEnvelope = {
+    _tag: typeof ErrorTag;
+    error: unknown;
+};
+export type RpcStreamErrorMarker = {
+    _tag: typeof StreamErrorTag;
+    error: unknown;
+};
+export declare const isRpcStreamErrorMarker: (value: unknown) => value is RpcStreamErrorMarker;
+export declare const isRpcErrorEnvelope: (value: unknown) => value is RpcErrorEnvelope;
+/**
+ * Normalize an error value into a plain, structured-clone-safe object.
+ * Tagged errors keep `_tag` and all own enumerable fields.
+ * Plain `Error` instances keep `name`, `message`, and `stack`.
+ */
+export declare const encodeRpcError: (error: unknown) => unknown;
+export declare const isRpcStreamEnvelope: (value: unknown) => value is RpcStreamEnvelope;
+export declare const fromRpcReadableStream: (body: ReadableStream<Uint8Array>, encoding: StreamEncoding) => Stream.Stream<any, Socket.SocketError | RpcDecodeError | RpcRemoteStreamError>;
+export declare const fromRpcStreamEnvelope: (envelope: RpcStreamEnvelope) => Stream.Stream<any, Socket.SocketError | RpcDecodeError | RpcRemoteStreamError>;
+export declare const decodeRpcValue: (value: unknown) => unknown;
+/**
+ * Decode an RPC return value, lifting error envelopes into the Effect
+ * error channel so that remote `Effect.fail(...)` values are recoverable.
+ */
+export declare const decodeRpcResult: (value: unknown) => Effect.Effect<unknown, unknown>;
+/**
+ * Wrap a Cloudflare service-binding stub (or an `Effect` that resolves
+ * to one — useful when the stub depends on a service like
+ * `WorkerEnvironment` that's only available at *exec* phase) into an
+ * Effect-typed RPC client.
+ *
+ * `Service.fetch`/`Service.connect` are passed through eagerly when the
+ * stub is already resolved; everything else is treated as an RPC method
+ * whose dispatch is deferred until call time, so the user effect runs in
+ * the right runtime layer (which is what `bindWorker` actually wants —
+ * its methods are called at exec, even though it's *defined* at init).
+ */
+export declare const makeRpcStub: <Shape>(stubSource: unknown | Effect.Effect<unknown, never, never>) => Shape;
+export declare const toRpcStream: (stream: Stream.Stream<any, any, any>) => Effect.Effect<{
+    _tag: "~alchemy/rpc/stream";
+    encoding: "bytes";
+    body: ReadableStream<any>;
+} | {
+    _tag: "~alchemy/rpc/stream";
+    encoding: "jsonl";
+    body: ReadableStream<Uint8Array<ArrayBufferLike>>;
+} | {
+    _tag: "~alchemy/rpc/stream";
+    encoding: "jsonl";
+    body: ReadableStream<Uint8Array<ArrayBufferLike>>;
+}, never, any>;
+export {};
+//# sourceMappingURL=Rpc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Rpc.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/Rpc.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAEtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AAIxD,eAAO,MAAM,SAAS,wBAAwB,CAAC;AAC/C,eAAO,MAAM,QAAQ,uBAAuB,CAAC;AAC7C,eAAO,MAAM,cAAc,8BAA8B,CAAC;AAE1D,KAAK,cAAc,GAAG,OAAO,GAAG,OAAO,CAAC;AAExC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,OAAO,SAAS,CAAC;IACvB,QAAQ,EAAE,cAAc,CAAC;IACzB,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAC;CAClC,CAAC;;;;AAEF,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;IACA,IAAa,OAAO,WAInB;CACF;;;;AAED,qBAAa,YAAa,SAAQ,kBAAiC;IACjE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;IACA,IAAa,OAAO,WAInB;CACF;;;;AAED,qBAAa,oBAAqB,SAAQ,0BAExC;IACA,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;CACzB,CAAC;CAAG;AAEL,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EAAE,OAAO,QAAQ,CAAC;IACtB,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,cAAc,CAAC;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC;AAEF,eAAO,MAAM,sBAAsB,GACjC,OAAO,OAAO,KACb,KAAK,IAAI,oBAKM,CAAC;AAEnB,eAAO,MAAM,kBAAkB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,gBAK3C,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,KAAG,OAqB/C,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAC9B,OAAO,OAAO,KACb,KAAK,IAAI,iBAQ0B,CAAC;AAEvC,eAAO,MAAM,qBAAqB,GAChC,MAAM,cAAc,CAAC,UAAU,CAAC,EAChC,UAAU,cAAc,KACvB,MAAM,CAAC,MAAM,CACd,GAAG,EACH,MAAM,CAAC,WAAW,GAAG,cAAc,GAAG,oBAAoB,CAgC3D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAChC,UAAU,iBAAiB,KAC1B,MAAM,CAAC,MAAM,CACd,GAAG,EACH,MAAM,CAAC,WAAW,GAAG,cAAc,GAAG,oBAAoB,CACA,CAAC;AAE7D,eAAO,MAAM,cAAc,GAAI,OAAO,OAAO,YAU5C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,eAAe,GAC1B,OAAO,OAAO,KACb,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAKhC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,WAAW,GAAI,KAAK,EAC/B,YAAY,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KACzD,KAyBF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;;;;;;;;;;;;cA6C7D,CAAC"}

package/lib/Cloudflare/Workers/Rpc.js

@@ -0,0 +1,184 @@
+import * as Cause from "effect/Cause";
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Sink from "effect/Sink";
+import * as Stream from "effect/Stream";
+import * as Socket from "effect/unstable/socket/Socket";
+import { isYieldableEffect } from "../../Util/effect.js";
+import { fromCloudflareFetcher } from "../Fetcher.js";
+export const StreamTag = "~alchemy/rpc/stream";
+export const ErrorTag = "~alchemy/rpc/error";
+export const StreamErrorTag = "~alchemy/rpc/stream-error";
+export class RpcDecodeError extends Data.TaggedError("RpcDecodeError") {
+    get message() {
+        return this.cause instanceof Error
+            ? this.cause.message
+            : String(this.cause);
+    }
+}
+export class RpcCallError extends Data.TaggedError("RpcCallError") {
+    get message() {
+        return `RPC call to "${this.method}" failed: ${this.cause instanceof Error ? this.cause.message : String(this.cause)}`;
+    }
+}
+export class RpcRemoteStreamError extends Data.TaggedError("RpcRemoteStreamError") {
+}
+export const isRpcStreamErrorMarker = (value) => typeof value === "object" &&
+    value !== null &&
+    "_tag" in value &&
+    value._tag === StreamErrorTag &&
+    "error" in value;
+export const isRpcErrorEnvelope = (value) => typeof value === "object" &&
+    value !== null &&
+    "_tag" in value &&
+    value._tag === ErrorTag &&
+    "error" in value;
+/**
+ * Normalize an error value into a plain, structured-clone-safe object.
+ * Tagged errors keep `_tag` and all own enumerable fields.
+ * Plain `Error` instances keep `name`, `message`, and `stack`.
+ */
+export const encodeRpcError = (error) => {
+    if (error === null || error === undefined)
+        return error;
+    if (typeof error !== "object")
+        return error;
+    const obj = error;
+    if ("_tag" in obj && typeof obj._tag === "string") {
+        const out = {};
+        for (const key of Object.keys(obj)) {
+            out[key] = obj[key];
+        }
+        if (error instanceof Error && !("message" in out)) {
+            out.message = error.message;
+        }
+        return out;
+    }
+    if (error instanceof Error) {
+        return { name: error.name, message: error.message, stack: error.stack };
+    }
+    return error;
+};
+export const isRpcStreamEnvelope = (value) => typeof value === "object" &&
+    value !== null &&
+    "_tag" in value &&
+    value._tag === StreamTag &&
+    "encoding" in value &&
+    (value.encoding === "bytes" || value.encoding === "jsonl") &&
+    "body" in value &&
+    value.body instanceof ReadableStream;
+export const fromRpcReadableStream = (body, encoding) => {
+    const stream = Stream.fromReadableStream({
+        evaluate: () => body,
+        onError: (cause) => Socket.isSocketError(cause)
+            ? cause
+            : new Socket.SocketError({
+                reason: new Socket.SocketReadError({ cause }),
+            }),
+    });
+    if (encoding === "bytes") {
+        return stream;
+    }
+    return stream.pipe(Stream.decodeText, Stream.splitLines, Stream.filter((line) => line.length > 0), Stream.mapEffect((line) => Effect.try({
+        try: () => JSON.parse(line),
+        catch: (cause) => new RpcDecodeError({ cause }),
+    })), Stream.flatMap((value) => isRpcStreamErrorMarker(value)
+        ? Stream.fail(new RpcRemoteStreamError({ error: value.error }))
+        : Stream.succeed(value)));
+};
+export const fromRpcStreamEnvelope = (envelope) => fromRpcReadableStream(envelope.body, envelope.encoding);
+export const decodeRpcValue = (value) => {
+    if (isRpcStreamEnvelope(value)) {
+        return fromRpcReadableStream(value.body, value.encoding);
+    }
+    if (value instanceof ReadableStream) {
+        return fromRpcReadableStream(value, "bytes");
+    }
+    return value;
+};
+/**
+ * Decode an RPC return value, lifting error envelopes into the Effect
+ * error channel so that remote `Effect.fail(...)` values are recoverable.
+ */
+export const decodeRpcResult = (value) => {
+    if (isRpcErrorEnvelope(value)) {
+        return Effect.fail(value.error);
+    }
+    return Effect.succeed(decodeRpcValue(value));
+};
+/**
+ * Wrap a Cloudflare service-binding stub (or an `Effect` that resolves
+ * to one — useful when the stub depends on a service like
+ * `WorkerEnvironment` that's only available at *exec* phase) into an
+ * Effect-typed RPC client.
+ *
+ * `Service.fetch`/`Service.connect` are passed through eagerly when the
+ * stub is already resolved; everything else is treated as an RPC method
+ * whose dispatch is deferred until call time, so the user effect runs in
+ * the right runtime layer (which is what `bindWorker` actually wants —
+ * its methods are called at exec, even though it's *defined* at init).
+ */
+export const makeRpcStub = (stubSource) => {
+    const isLazy = isYieldableEffect(stubSource);
+    const eagerFetcher = isLazy
+        ? undefined
+        : fromCloudflareFetcher(stubSource);
+    const proxyTarget = eagerFetcher ?? {};
+    return new Proxy(proxyTarget, {
+        get: (target, prop) => {
+            if (!isLazy && prop in target)
+                return target[prop];
+            if (typeof prop !== "string" && typeof prop !== "symbol") {
+                return target[prop];
+            }
+            return (...args) => Effect.gen(function* () {
+                const stub = isLazy
+                    ? yield* stubSource
+                    : stubSource;
+                return yield* Effect.tryPromise({
+                    try: () => stub[prop](...args),
+                    catch: (cause) => new RpcCallError({ method: String(prop), cause }),
+                }).pipe(Effect.flatMap(decodeRpcResult));
+            });
+        },
+    });
+};
+export const toRpcStream = (stream) => Effect.scoped(Effect.gen(function* () {
+    const [head, rest] = yield* Stream.peel(stream, Sink.head());
+    if (Option.isSome(head) && head.value instanceof Uint8Array) {
+        return {
+            _tag: StreamTag,
+            encoding: "bytes",
+            body: Stream.toReadableStream(rest.pipe(Stream.prepend([head.value]))),
+        };
+    }
+    const body = Option.isSome(head)
+        ? rest.pipe(Stream.prepend([head.value]))
+        : rest;
+    return {
+        _tag: StreamTag,
+        encoding: "jsonl",
+        body: Stream.toReadableStream(appendStreamErrors(body.pipe(Stream.map((value) => JSON.stringify(value) + "\n"))).pipe(Stream.encodeText)),
+    };
+})).pipe(Effect.catchCause((cause) => {
+    const failReason = cause.reasons.find(Cause.isFailReason);
+    if (failReason) {
+        return Effect.succeed({
+            _tag: StreamTag,
+            encoding: "jsonl",
+            body: Stream.toReadableStream(Stream.succeed(encodeStreamErrorMarker(cause)).pipe(Stream.encodeText)),
+        });
+    }
+    return Effect.die(Cause.squash(cause));
+}));
+const encodeStreamErrorMarker = (cause) => {
+    const failReason = cause.reasons.find(Cause.isFailReason);
+    const error = failReason ? encodeRpcError(failReason.error) : undefined;
+    return (JSON.stringify({
+        _tag: StreamErrorTag,
+        error,
+    }) + "\n");
+};
+const appendStreamErrors = (s) => s.pipe(Stream.catchCause((cause) => Stream.succeed(encodeStreamErrorMarker(cause))));
+//# sourceMappingURL=Rpc.js.map

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

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

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

@@ -0,0 +1,8 @@
+import type * as Effect from "effect/Effect";
+import type * as Stream from "effect/Stream";
+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]>;
+};
+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

@@ -0,0 +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"}

package/lib/Cloudflare/Workers/RpcAsync.js

@@ -0,0 +1,45 @@
+import { isRpcErrorEnvelope, isRpcStreamEnvelope } from "../Bridge.js";
+export const toRpcAsync = (stub) => new Proxy(stub, {
+    get: (target, prop) => {
+        // `Service` methods (fetch/connect) and any non-string keys (Symbol.dispose, etc.)
+        // pass through to the underlying Cloudflare binding unchanged.
+        if (typeof prop !== "string" || prop === "fetch" || prop === "connect") {
+            const value = target[prop];
+            return typeof value === "function" ? value.bind(target) : value;
+        }
+        return async (...args) => {
+            const result = await target[prop](...args);
+            if (isRpcErrorEnvelope(result)) {
+                throw decodeRpcThrowable(result.error);
+            }
+            if (isRpcStreamEnvelope(result)) {
+                return result.body;
+            }
+            return result;
+        };
+    },
+});
+/**
+ * Reconstruct a throwable from {@link encodeRpcError}'s wire form. Plain
+ * `Error` payloads are rebuilt as `Error` instances so `.message`/`.name`/
+ * `.stack` survive. Tagged errors (anything with a `_tag`) and primitives
+ * are thrown as-is so `try { ... } catch (e) { if (e._tag === ...) }` keeps
+ * working.
+ */
+const decodeRpcThrowable = (error) => {
+    if (error === null || typeof error !== "object")
+        return error;
+    const obj = error;
+    if ("_tag" in obj)
+        return obj;
+    if (typeof obj.message === "string" || typeof obj.name === "string") {
+        const e = new Error(typeof obj.message === "string" ? obj.message : "");
+        if (typeof obj.name === "string")
+            e.name = obj.name;
+        if (typeof obj.stack === "string")
+            e.stack = obj.stack;
+        return e;
+    }
+    return error;
+};
+//# sourceMappingURL=RpcAsync.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"RpcAsync.js","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/RpcAsync.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAkBvE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAI,IAAS,EAAoC,EAAE,CAC3E,IAAI,KAAK,CAAC,IAAI,EAAE;IACd,GAAG,EAAE,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE;QACpB,mFAAmF;QACnF,+DAA+D;QAC/D,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,OAAO,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACvE,MAAM,KAAK,GAAI,MAAc,CAAC,IAAI,CAAC,CAAC;YACpC,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAClE,CAAC;QAED,OAAO,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;YAClC,MAAM,MAAM,GAAG,MAAO,MAAc,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACpD,IAAI,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzC,CAAC;YACD,IAAI,mBAAmB,CAAC,MAAM,CAAC,EAAE,CAAC;gBAChC,OAAO,MAAM,CAAC,IAAI,CAAC;YACrB,CAAC;YACD,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;IACJ,CAAC;CACF,CAAQ,CAAC;AAEZ;;;;;;GAMG;AACH,MAAM,kBAAkB,GAAG,CAAC,KAAc,EAAW,EAAE;IACrD,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,MAAM,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAC9B,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpE,MAAM,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACxE,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;YAAE,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;QACpD,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;YAAE,CAAC,CAAC,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC,CAAC"}

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

@@ -0,0 +1,49 @@
+import * as Effect from "effect/Effect";
+import { DurableObjectState } from "./DurableObjectState.ts";
+export interface ScheduledEvent {
+    id: string;
+    runAt: Date;
+    repeatMs?: number;
+    payload: unknown;
+}
+/**
+ * Schedule (or reschedule) a named event on the current Durable Object.
+ *
+ * The event is persisted in a SQLite table and the DO alarm is set to
+ * the earliest pending `runAt`. If an event with the same `id` already
+ * exists it is replaced (upsert).
+ *
+ * @param id      Stable identifier for the event (used for upsert / cancel).
+ * @param runAt   When the event should fire.
+ * @param payload Arbitrary JSON-serialisable data delivered to the alarm handler.
+ * @param repeatMs If set, the event re-schedules itself this many ms after each fire.
+ */
+export declare const scheduleEvent: (id: string, runAt: Date, payload: unknown, repeatMs?: number | undefined) => Effect.Effect<void, never, DurableObjectState>;
+/**
+ * Cancel a previously scheduled event by id. No-op if the event does not exist.
+ */
+export declare const cancelEvent: (id: string) => Effect.Effect<void, never, DurableObjectState>;
+/**
+ * List all currently scheduled events, ordered by `runAt` ascending.
+ */
+export declare const listEvents: Effect.Effect<ScheduledEvent[], never, DurableObjectState>;
+/**
+ * Process all events whose `runAt` <= now. Returns the fired events.
+ *
+ * - One-shot events are deleted after firing.
+ * - Repeating events have their `runAt` bumped by `repeatMs`.
+ * - The DO alarm is re-set to the next pending event (if any).
+ *
+ * Call this from your Durable Object's `alarm` handler:
+ *
+ * ```ts
+ * alarm: () => Effect.gen(function* () {
+ *   const fired = yield* Cloudflare.processScheduledEvents;
+ *   for (const event of fired) {
+ *     // handle each event
+ *   }
+ * })
+ * ```
+ */
+export declare const processScheduledEvents: Effect.Effect<ScheduledEvent[], never, DurableObjectState>;
+//# sourceMappingURL=ScheduledEvents.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduledEvents.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/ScheduledEvents.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAuB7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,IAAI,CAAC;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;CAClB;AAgBD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,aAAa,8HAmBxB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW,gEAUtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,CACpC,cAAc,EAAE,EAChB,KAAK,EACL,kBAAkB,CAUlB,CAAC;AAEH;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,CAChD,cAAc,EAAE,EAChB,KAAK,EACL,kBAAkB,CA8BlB,CAAC"}

package/lib/Cloudflare/Workers/ScheduledEvents.js

@@ -0,0 +1,107 @@
+import * as Effect from "effect/Effect";
+import * as Option from "effect/Option";
+import * as Stream from "effect/Stream";
+import { DurableObjectState } from "./DurableObjectState.js";
+// ---------------------------------------------------------------------------
+// Scheduled Events — SQLite-backed cron/timer for Durable Objects
+// ---------------------------------------------------------------------------
+const INIT_TABLE_SQL = `
+CREATE TABLE IF NOT EXISTS alchemy_scheduled_events (
+  id TEXT PRIMARY KEY,
+  run_at INTEGER NOT NULL,
+  repeat_ms INTEGER,
+  payload TEXT NOT NULL
+);
+CREATE INDEX IF NOT EXISTS idx_alchemy_scheduled_events_run_at
+  ON alchemy_scheduled_events (run_at);
+`;
+const ensureTable = Effect.gen(function* () {
+    const ctx = yield* DurableObjectState;
+    yield* ctx.storage.sql.exec(INIT_TABLE_SQL);
+});
+const toScheduledEvent = (row) => ({
+    id: row.id,
+    runAt: new Date(row.run_at),
+    repeatMs: row.repeat_ms ?? undefined,
+    payload: JSON.parse(row.payload),
+});
+/**
+ * Schedule (or reschedule) a named event on the current Durable Object.
+ *
+ * The event is persisted in a SQLite table and the DO alarm is set to
+ * the earliest pending `runAt`. If an event with the same `id` already
+ * exists it is replaced (upsert).
+ *
+ * @param id      Stable identifier for the event (used for upsert / cancel).
+ * @param runAt   When the event should fire.
+ * @param payload Arbitrary JSON-serialisable data delivered to the alarm handler.
+ * @param repeatMs If set, the event re-schedules itself this many ms after each fire.
+ */
+export const scheduleEvent = Effect.fnUntraced(function* (id, runAt, payload, repeatMs) {
+    yield* ensureTable;
+    const ctx = yield* DurableObjectState;
+    yield* ctx.storage.sql.exec(`INSERT OR REPLACE INTO alchemy_scheduled_events (id, run_at, repeat_ms, payload)
+     VALUES (?, ?, ?, ?)`, id, runAt.getTime(), repeatMs ?? null, JSON.stringify(payload));
+    yield* reconcileAlarm;
+});
+/**
+ * Cancel a previously scheduled event by id. No-op if the event does not exist.
+ */
+export const cancelEvent = Effect.fnUntraced(function* (id) {
+    yield* ensureTable;
+    const ctx = yield* DurableObjectState;
+    yield* ctx.storage.sql.exec(`DELETE FROM alchemy_scheduled_events WHERE id = ?`, id);
+    yield* reconcileAlarm;
+});
+/**
+ * List all currently scheduled events, ordered by `runAt` ascending.
+ */
+export const listEvents = Effect.gen(function* () {
+    yield* ensureTable;
+    const ctx = yield* DurableObjectState;
+    const cursor = yield* ctx.storage.sql.exec(`SELECT id, run_at, repeat_ms, payload FROM alchemy_scheduled_events ORDER BY run_at ASC`);
+    return yield* cursor.pipe(Stream.map(toScheduledEvent), Stream.runCollect);
+});
+/**
+ * Process all events whose `runAt` <= now. Returns the fired events.
+ *
+ * - One-shot events are deleted after firing.
+ * - Repeating events have their `runAt` bumped by `repeatMs`.
+ * - The DO alarm is re-set to the next pending event (if any).
+ *
+ * Call this from your Durable Object's `alarm` handler:
+ *
+ * ```ts
+ * alarm: () => Effect.gen(function* () {
+ *   const fired = yield* Cloudflare.processScheduledEvents;
+ *   for (const event of fired) {
+ *     // handle each event
+ *   }
+ * })
+ * ```
+ */
+export const processScheduledEvents = Effect.gen(function* () {
+    yield* ensureTable;
+    const ctx = yield* DurableObjectState;
+    const now = Date.now();
+    const cursor = yield* ctx.storage.sql.exec(`SELECT id, run_at, repeat_ms, payload FROM alchemy_scheduled_events WHERE run_at <= ? ORDER BY run_at ASC`, now);
+    const fired = yield* cursor.pipe(Stream.mapEffect((row) => (row.repeat_ms != null
+        ? ctx.storage.sql.exec(`UPDATE alchemy_scheduled_events SET run_at = ? WHERE id = ?`, now + row.repeat_ms, row.id)
+        : ctx.storage.sql.exec(`DELETE FROM alchemy_scheduled_events WHERE id = ?`, row.id)).pipe(Effect.as(toScheduledEvent(row)))), Stream.runCollect);
+    yield* reconcileAlarm;
+    return fired;
+});
+/**
+ * Set the DO alarm to the earliest pending event, or clear it if none remain.
+ */
+const reconcileAlarm = Effect.gen(function* () {
+    const ctx = yield* DurableObjectState;
+    const next = yield* (yield* ctx.storage.sql.exec(`SELECT run_at FROM alchemy_scheduled_events ORDER BY run_at ASC LIMIT 1`)).pipe(Stream.take(1), Stream.runHead);
+    if (Option.isSome(next)) {
+        yield* ctx.storage.setAlarm(next.value.run_at);
+    }
+    else {
+        yield* ctx.storage.deleteAlarm();
+    }
+});
+//# sourceMappingURL=ScheduledEvents.js.map

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

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

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

@@ -0,0 +1,9 @@
+import { type CloudflareVitePluginOptions } from "@distilled.cloud/cloudflare-vite-plugin";
+import * as Effect from "effect/Effect";
+import type * as vite from "vite";
+export declare const viteDev: (rootDir: string | undefined, env: Record<string, unknown>, pluginOptions: CloudflareVitePluginOptions) => Effect.Effect<vite.ViteDevServer, never, import("effect/Scope").Scope>;
+export declare const viteBuild: (rootDir: string | undefined, env: Record<string, unknown>, pluginOptions: CloudflareVitePluginOptions) => Effect.Effect<{
+    serverBundle: vite.Rolldown.OutputBundle | undefined;
+    assetsDirectory: string | undefined;
+}, never, never>;
+//# sourceMappingURL=Vite.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Vite.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Workers/Vite.ts"],"names":[],"mappings":"AAAA,OAAmB,EACjB,KAAK,2BAA2B,EACjC,MAAM,yCAAyC,CAAC;AACjD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAKxC,OAAO,KAAK,KAAK,IAAI,MAAM,MAAM,CAAC;AAElC,eAAO,MAAM,OAAO,GAClB,SAAS,MAAM,YAAgB,EAC/B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,eAAe,2BAA2B,2EAiBzC,CAAC;AAEJ,eAAO,MAAM,SAAS,GACpB,SAAS,MAAM,YAAgB,EAC/B,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,eAAe,2BAA2B;;;gBA0CxC,CAAC"}

package/lib/Cloudflare/Workers/Vite.js

@@ -0,0 +1,95 @@
+var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
+    if (typeof path === "string" && /^\.\.?\//.test(path)) {
+        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
+            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
+        });
+    }
+    return path;
+};
+import cloudflare, {} from "@distilled.cloud/cloudflare-vite-plugin";
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+export const viteDev = (rootDir = process.cwd(), env, pluginOptions) => Effect.acquireRelease(Effect.promise(async () => {
+    const vite = await loadVite(rootDir);
+    const devServer = await vite.createServer({
+        root: rootDir,
+        define: getDefine(env),
+        plugins: [cloudflare(pluginOptions)],
+    });
+    await devServer.listen();
+    return devServer;
+}), (devServer) => Effect.promise(async () => {
+    await devServer.close();
+}));
+export const viteBuild = (rootDir = process.cwd(), env, pluginOptions) => Effect.promise(async () => {
+    let serverBundle;
+    let assetsDirectory;
+    const vite = await loadVite(rootDir);
+    const builder = await vite.createBuilder({
+        root: rootDir,
+        define: getDefine(env),
+        plugins: [
+            cloudflare(pluginOptions),
+            {
+                name: "output:ssr",
+                applyToEnvironment(environment) {
+                    return environment.name === "ssr";
+                },
+                generateBundle(_outputOptions, bundle) {
+                    serverBundle = bundle;
+                },
+            },
+            {
+                name: "output:client",
+                applyToEnvironment(environment) {
+                    return environment.name === "client";
+                },
+                generateBundle(outputOptions) {
+                    assetsDirectory = outputOptions.dir;
+                },
+            },
+        ],
+    }, 
+    // This is the `useLegacyBuilder` option. The Vite CLI implementation uses `null` here.
+    // Originally we used `undefined` here, but this caused the static site build to fail.
+    // https://github.com/vitejs/vite/blob/a07a4bd052ac75f916391c999c408ad5f2867e61/packages/vite/src/node/cli.ts#L367
+    null);
+    await builder.buildApp();
+    return {
+        serverBundle,
+        assetsDirectory,
+    };
+});
+// Emulate `vite build` env semantics for `props.env`: only
+// keys with Vite's default `VITE_` prefix are inlined into
+// the bundle as `import.meta.env.*`. `Redacted` values are
+// unwrapped — by prefixing with `VITE_` the user is opting
+// them into the public bundle.
+const getDefine = (env) => Object.fromEntries(Object.entries(env).flatMap(([key, raw]) => {
+    if (!key.startsWith("VITE_"))
+        return [];
+    const value = Redacted.isRedacted(raw) ? Redacted.value(raw) : raw;
+    return [[`import.meta.env.${key}`, JSON.stringify(value)]];
+}));
+/**
+ * Dynamically load Vite from the project root. Falls back to the bundled
+ * copy if the project doesn't have its own Vite installation.
+ */
+async function loadVite(projectRoot = process.cwd()) {
+    try {
+        const require = createRequire(path.join(projectRoot, "package.json"));
+        const vitePath = require.resolve("vite");
+        // On Windows, absolute paths must be file:// URLs for ESM import().
+        const viteUrl = pathToFileURL(vitePath);
+        return await import(__rewriteRelativeImportExtension(/* @vite-ignore */ viteUrl.href));
+    }
+    catch {
+        // Fallback: try to import vite from the global node_modules (works for non-linked installs)
+        // The fallback is a bare specifier and works as-is.
+        return await import("vite");
+    }
+}
+//# sourceMappingURL=Vite.js.map