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

package/lib/Cloudflare/Email/SendEmail.d.ts

@@ -0,0 +1,74 @@
+import * as Effect from "effect/Effect";
+import { SendEmailBinding } from "./SendEmailBinding.ts";
+type SendEmailTypeId = typeof SendEmailTypeId;
+declare const SendEmailTypeId: "Cloudflare.SendEmail";
+export type SendEmailProps = {
+    /**
+     * Restrict the Worker to send to a single verified destination address.
+     *
+     * Mutually exclusive with `allowedDestinationAddresses`. The destination
+     * must be a verified address on the account (see {@link EmailAddress}).
+     */
+    destinationAddress?: string;
+    /**
+     * Restrict the Worker to send to one of these verified destination addresses.
+     *
+     * Mutually exclusive with `destinationAddress`.
+     */
+    allowedDestinationAddresses?: string[];
+    /**
+     * Restrict the Worker to send from one of these sender addresses.
+     *
+     * The sender domain must have Email Routing configured (see
+     * {@link EmailRouting}) and the addresses must be verified.
+     */
+    allowedSenderAddresses?: string[];
+};
+/**
+ * A Cloudflare Workers `send_email` binding descriptor.
+ *
+ * `SendEmail` is a Worker-only binding — it does not create any cloud-side
+ * resource. The descriptor names the binding and records optional
+ * destination/sender restrictions; the actual `send_email` entry is attached
+ * to the Worker via {@link SendEmailBinding}.
+ *
+ * @resource
+ *
+ * @section Binding to a Worker
+ * @example Send to any verified destination
+ * ```typescript
+ * const Email = Cloudflare.SendEmail("Email");
+ *
+ * // in the Worker effect:
+ * const email = yield* Cloudflare.SendEmail.bind(Email);
+ * yield* email.send({
+ *   from: "noreply@example.com",
+ *   to: "user@example.com",
+ *   subject: "Hello",
+ *   text: "Hi from Alchemy",
+ * });
+ * ```
+ *
+ * @example Restrict the sender address
+ * ```typescript
+ * const Ops = Cloudflare.SendEmail("OpsEmail", {
+ *   allowedSenderAddresses: ["noreply@example.com"],
+ *   destinationAddress: "ops@example.com",
+ * });
+ * ```
+ */
+export type SendEmail = SendEmailProps & {
+    kind: SendEmailTypeId;
+    name: string;
+};
+export declare const isSendEmail: (value: unknown) => value is SendEmail;
+export declare const SendEmail: {
+    (id: string, props?: SendEmailProps): Effect.Effect<SendEmail>;
+    /**
+     * Bind this `send_email` descriptor to the surrounding Worker. Returns a
+     * typed runtime client for sending email.
+     */
+    bind: typeof SendEmailBinding.bind;
+};
+export {};
+//# sourceMappingURL=SendEmail.d.ts.map

package/lib/Cloudflare/Email/SendEmail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendEmail.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Email/SendEmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAEzD,KAAK,eAAe,GAAG,OAAO,eAAe,CAAC;AAC9C,QAAA,MAAM,eAAe,EAAG,sBAA+B,CAAC;AAExD,MAAM,MAAM,cAAc,GAAG;IAC3B;;;;;OAKG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,2BAA2B,CAAC,EAAE,MAAM,EAAE,CAAC;IACvC;;;;;OAKG;IACH,sBAAsB,CAAC,EAAE,MAAM,EAAE,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,GAAG;IACvC,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,SAIP,CAAC;AAEhD,eAAO,MAAM,SAAS,EAAE;IACtB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC/D;;;OAGG;IACH,IAAI,EAAE,OAAO,gBAAgB,CAAC,IAAI,CAAC;CAepC,CAAC"}

package/lib/Cloudflare/Email/SendEmail.js

@@ -0,0 +1,19 @@
+import * as Effect from "effect/Effect";
+import { SendEmailBinding } from "./SendEmailBinding.js";
+const SendEmailTypeId = "Cloudflare.SendEmail";
+export const isSendEmail = (value) => typeof value === "object" &&
+    value !== null &&
+    "kind" in value &&
+    value.kind === SendEmailTypeId;
+export const SendEmail = Object.assign(Effect.fnUntraced(function* (id, props) {
+    return {
+        kind: SendEmailTypeId,
+        name: id,
+        destinationAddress: props?.destinationAddress,
+        allowedDestinationAddresses: props?.allowedDestinationAddresses,
+        allowedSenderAddresses: props?.allowedSenderAddresses,
+    };
+}), {
+    bind: (...args) => SendEmailBinding.bind(...args),
+});
+//# sourceMappingURL=SendEmail.js.map

package/lib/Cloudflare/Email/SendEmail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendEmail.js","sourceRoot":"","sources":["../../../src/Cloudflare/Email/SendEmail.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAGzD,MAAM,eAAe,GAAG,sBAA+B,CAAC;AA+DxD,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAc,EAAsB,EAAE,CAChE,OAAO,KAAK,KAAK,QAAQ;IACzB,KAAK,KAAK,IAAI;IACd,MAAM,IAAI,KAAK;IACd,KAAmB,CAAC,IAAI,KAAK,eAAe,CAAC;AAEhD,MAAM,CAAC,MAAM,SAAS,GAOlB,MAAM,CAAC,MAAM,CACf,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,EAAU,EAAE,KAAsB;IAC7D,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,IAAI,EAAE,EAAE;QACR,kBAAkB,EAAE,KAAK,EAAE,kBAAkB;QAC7C,2BAA2B,EAAE,KAAK,EAAE,2BAA2B;QAC/D,sBAAsB,EAAE,KAAK,EAAE,sBAAsB;KAClC,CAAC;AACxB,CAAC,CAAC,EACF;IACE,IAAI,EAAE,CAAC,GAAG,IAA8C,EAAE,EAAE,CAC1D,gBAAgB,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjC,CACF,CAAC"}

package/lib/Cloudflare/Email/SendEmailBinding.d.ts

@@ -0,0 +1,64 @@
+import type * as runtime from "@cloudflare/workers-types";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Binding from "../../Binding.ts";
+import { WorkerEnvironment } from "../Workers/Worker.ts";
+import type { SendEmail } from "./SendEmail.ts";
+/**
+ * Email body shape for the builder-form `send` call. Either `text`, `html`,
+ * or both must be provided.
+ */
+export interface SendEmailMessage {
+    from: string | runtime.EmailAddress;
+    to: string | string[];
+    subject: string;
+    replyTo?: string | runtime.EmailAddress;
+    cc?: string | string[];
+    bcc?: string | string[];
+    headers?: Record<string, string>;
+    text?: string;
+    html?: string;
+    attachments?: runtime.EmailAttachment[];
+}
+declare const SendEmailError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").VoidIfEmpty<{ readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }>) => import("effect/Cause").YieldableError & {
+    readonly _tag: "SendEmailError";
+} & Readonly<A>;
+export declare class SendEmailError extends SendEmailError_base<{
+    message: string;
+    cause?: unknown;
+}> {
+}
+export interface SendEmailClient {
+    /**
+     * The raw runtime `SendEmail` binding. Use this when you need direct
+     * access to the Cloudflare object (e.g. to send a pre-built
+     * `EmailMessage` from `cloudflare:email`).
+     */
+    raw: Effect.Effect<runtime.SendEmail, never, WorkerEnvironment>;
+    /**
+     * Send an email using the builder form. Equivalent to calling
+     * `env.<name>.send({ from, to, subject, text, html, ... })`.
+     */
+    send(message: SendEmailMessage): Effect.Effect<runtime.EmailSendResult, SendEmailError, WorkerEnvironment>;
+    /**
+     * Send a raw `EmailMessage` (constructed via `cloudflare:email`).
+     */
+    sendRaw(message: runtime.EmailMessage): Effect.Effect<runtime.EmailSendResult, SendEmailError, WorkerEnvironment>;
+}
+declare const SendEmailBinding_base: Binding.Service<SendEmailBinding, "Cloudflare.SendEmail.Binding", (sender: SendEmail) => Effect.Effect<SendEmailClient>> & {
+    bind: (sender: SendEmail) => Effect.Effect<any, any, any>;
+};
+/**
+ * A typed runtime accessor for a Cloudflare `send_email` Worker binding.
+ *
+ * @binding
+ */
+export declare class SendEmailBinding extends SendEmailBinding_base {
+}
+export declare const SendEmailBindingLive: Layer.Layer<SendEmailBinding, never, import("../../RuntimeContext.ts").RuntimeContext<import("../../RuntimeContext.ts").BaseRuntimeContext> | SendEmailBindingPolicy>;
+declare const SendEmailBindingPolicy_base: Binding.Policy<SendEmailBindingPolicy, "Policy<Cloudflare.SendEmail.Binding>", (sender: SendEmail) => Effect.Effect<void>>;
+export declare class SendEmailBindingPolicy extends SendEmailBindingPolicy_base {
+}
+export declare const SendEmailBindingPolicyLive: Layer.Layer<SendEmailBindingPolicy, never, never>;
+export {};
+//# sourceMappingURL=SendEmailBinding.d.ts.map

package/lib/Cloudflare/Email/SendEmailBinding.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SendEmailBinding.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Email/SendEmailBinding.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,OAAO,MAAM,2BAA2B,CAAC;AAE1D,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAY,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACnE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACxC,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACvB,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;CACzC;;;;AAED,qBAAa,cAAe,SAAQ,oBAAmC;IACrE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;CAAG;AAEL,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAChE;;;OAGG;IACH,IAAI,CACF,OAAO,EAAE,gBAAgB,GACxB,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;IAC7E;;OAEG;IACH,OAAO,CACL,OAAO,EAAE,OAAO,CAAC,YAAY,GAC5B,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,eAAe,EAAE,cAAc,EAAE,iBAAiB,CAAC,CAAC;CAC9E;gHASU,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC;;;AAPvD;;;;GAIG;AACH,qBAAa,gBAAiB,SAAQ,qBAGH;CAAG;AAEtC,eAAO,MAAM,oBAAoB,uKAiChC,CAAC;mIAIS,SAAS,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;AAF5C,qBAAa,sBAAuB,SAAQ,2BAGT;CAAG;AAEtC,eAAO,MAAM,0BAA0B,mDAoBtC,CAAC"}

package/lib/Cloudflare/Email/SendEmailBinding.js

@@ -0,0 +1,54 @@
+import * as Data from "effect/Data";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Binding from "../../Binding.js";
+import { isWorker, WorkerEnvironment } from "../Workers/Worker.js";
+export class SendEmailError extends Data.TaggedError("SendEmailError") {
+}
+/**
+ * A typed runtime accessor for a Cloudflare `send_email` Worker binding.
+ *
+ * @binding
+ */
+export class SendEmailBinding extends Binding.Service()("Cloudflare.SendEmail.Binding") {
+}
+export const SendEmailBindingLive = Layer.effect(SendEmailBinding, Effect.gen(function* () {
+    const bind = yield* SendEmailBindingPolicy;
+    return Effect.fnUntraced(function* (sender) {
+        yield* bind(sender);
+        const raw = WorkerEnvironment.useSync((env) => env[sender.name]);
+        const tryPromise = (fn) => Effect.tryPromise({
+            try: fn,
+            catch: (error) => new SendEmailError({
+                message: error?.message ?? "Unknown send_email error",
+                cause: error,
+            }),
+        });
+        return {
+            raw,
+            send: (message) => raw.pipe(Effect.flatMap((s) => tryPromise(() => s.send(message)))),
+            sendRaw: (message) => raw.pipe(Effect.flatMap((s) => tryPromise(() => s.send(message)))),
+        };
+    });
+}));
+export class SendEmailBindingPolicy extends Binding.Policy()("Cloudflare.SendEmail.Binding") {
+}
+export const SendEmailBindingPolicyLive = SendEmailBindingPolicy.layer.succeed(Effect.fnUntraced(function* (host, sender) {
+    if (isWorker(host)) {
+        yield* host.bind(sender.name, {
+            bindings: [
+                {
+                    type: "send_email",
+                    name: sender.name,
+                    destinationAddress: sender.destinationAddress,
+                    allowedDestinationAddresses: sender.allowedDestinationAddresses,
+                    allowedSenderAddresses: sender.allowedSenderAddresses,
+                },
+            ],
+        });
+    }
+    else {
+        return yield* Effect.die(new Error(`SendEmailBinding does not support runtime '${host.Type}'`));
+    }
+}));
+//# sourceMappingURL=SendEmailBinding.js.map

package/lib/Cloudflare/Email/SendEmailBinding.js.map

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

package/lib/Cloudflare/Email/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./EmailAddress.ts";
+export * from "./EmailRouting.ts";
+export * from "./EmailRule.ts";
+export * from "./SendEmail.ts";
+export * from "./SendEmailBinding.ts";
+//# sourceMappingURL=index.d.ts.map

package/lib/Cloudflare/Email/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Email/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/lib/Cloudflare/Email/index.js

@@ -0,0 +1,6 @@
+export * from "./EmailAddress.js";
+export * from "./EmailRouting.js";
+export * from "./EmailRule.js";
+export * from "./SendEmail.js";
+export * from "./SendEmailBinding.js";
+//# sourceMappingURL=index.js.map

package/lib/Cloudflare/Email/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Cloudflare/Email/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC"}

package/lib/Cloudflare/Fetcher.d.ts

@@ -0,0 +1,32 @@
+import type * as cf from "@cloudflare/workers-types";
+import * as Effect from "effect/Effect";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { HttpClientError } from "effect/unstable/http/HttpClientError";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as HttpClientResponse from "effect/unstable/http/HttpClientResponse";
+import type { HttpServerError } from "effect/unstable/http/HttpServerError";
+import * as HttpServerRequest from "effect/unstable/http/HttpServerRequest";
+import * as HttpServerResponse from "effect/unstable/http/HttpServerResponse";
+import * as Socket from "effect/unstable/socket/Socket";
+export type SocketAddress = cf.SocketAddress;
+export type SocketOptions = cf.SocketOptions;
+export interface Fetcher {
+    fetch(request: HttpClientRequest.HttpClientRequest): Effect.Effect<HttpClientResponse.HttpClientResponse, HttpClientError>;
+    fetch(request: HttpServerRequest.HttpServerRequest): Effect.Effect<HttpServerResponse.HttpServerResponse, HttpServerError>;
+    connect(address: SocketAddress | string, options?: SocketOptions): Socket.Socket;
+}
+export declare const toCloudflareFetcher: (fetcher: Fetcher) => Effect.Effect<{
+    fetch: (input: cf.RequestInfo<unknown, cf.CfProperties<unknown>> | cf.URL, init: cf.RequestInit<cf.CfProperties<unknown>> | undefined) => Promise<cf.Response>;
+    connect(): never;
+}, never, never>;
+export declare const fromCloudflareFetcher: (fetcher: cf.Fetcher) => Fetcher;
+/**
+ * Adapt anything that exposes a server-shaped `fetch` (e.g. a Durable Object
+ * stub, a Worker service binding) into an Effect `HttpClient`. Lets HttpApi
+ * clients address bindings without a base URL via `transformClient`.
+ */
+export declare const toHttpClient: (fetcher: {
+    fetch: (request: HttpServerRequest.HttpServerRequest) => Effect.Effect<HttpServerResponse.HttpServerResponse, HttpServerError>;
+}) => HttpClient.HttpClient;
+export declare const fromCloudflareSocket: (cfSocket: cf.Socket) => Socket.Socket;
+//# sourceMappingURL=Fetcher.d.ts.map

package/lib/Cloudflare/Fetcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Fetcher.d.ts","sourceRoot":"","sources":["../../src/Cloudflare/Fetcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAMxC,OAAO,KAAK,UAAU,MAAM,iCAAiC,CAAC;AAC9D,OAAO,EACL,eAAe,EAEhB,MAAM,sCAAsC,CAAC;AAC9C,OAAO,KAAK,iBAAiB,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,kBAAkB,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AAC5E,OAAO,KAAK,iBAAiB,MAAM,wCAAwC,CAAC;AAC5E,OAAO,KAAK,kBAAkB,MAAM,yCAAyC,CAAC;AAC9E,OAAO,KAAK,MAAM,MAAM,+BAA+B,CAAC;AAExD,MAAM,MAAM,aAAa,GAAG,EAAE,CAAC,aAAa,CAAC;AAE7C,MAAM,MAAM,aAAa,GAAG,EAAE,CAAC,aAAa,CAAC;AAE7C,MAAM,WAAW,OAAO;IACtB,KAAK,CACH,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,GAC3C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IACzE,KAAK,CACH,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,GAC3C,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;IAEzE,OAAO,CACL,OAAO,EAAE,aAAa,GAAG,MAAM,EAC/B,OAAO,CAAC,EAAE,aAAa,GACtB,MAAM,CAAC,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,mBAAmB;;;gBA2B9B,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,SAAS,EAAE,CAAC,OAAO,KAAG,OAuD3D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS;IACpC,KAAK,EAAE,CACL,OAAO,EAAE,iBAAiB,CAAC,iBAAiB,KACzC,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,kBAAkB,EAAE,eAAe,CAAC,CAAC;CAC5E,0BAsBG,CAAC;AAEL,eAAO,MAAM,oBAAoB,GAAI,UAAU,EAAE,CAAC,MAAM,KAAG,MAAM,CAAC,MA6KjE,CAAC"}

package/lib/Cloudflare/Fetcher.js

@@ -0,0 +1,180 @@
+import * as Deferred from "effect/Deferred";
+import * as Effect from "effect/Effect";
+import * as FiberSet from "effect/FiberSet";
+import { pipe } from "effect/Function";
+import * as Latch from "effect/Latch";
+import * as Scope from "effect/Scope";
+import * as HttpBody from "effect/unstable/http/HttpBody";
+import * as HttpClient from "effect/unstable/http/HttpClient";
+import { HttpClientError, TransportError, } from "effect/unstable/http/HttpClientError";
+import * as HttpClientRequest from "effect/unstable/http/HttpClientRequest";
+import * as HttpClientResponse from "effect/unstable/http/HttpClientResponse";
+import * as HttpServerRequest from "effect/unstable/http/HttpServerRequest";
+import * as HttpServerResponse from "effect/unstable/http/HttpServerResponse";
+import * as Socket from "effect/unstable/socket/Socket";
+export const toCloudflareFetcher = Effect.fnUntraced(function* (fetcher) {
+    const context = yield* Effect.context();
+    return {
+        fetch: (input, init) => fetcher
+            .fetch(HttpServerRequest.fromWeb(new Request(input, init)))
+            .pipe(Effect.map((response) => HttpServerResponse.toWeb(response, {
+            context,
+        })), Effect.provideContext(context), Effect.runPromise),
+        connect() {
+            // TODO
+            throw new Error("toCloudflareFetcher does not support connect()");
+        },
+    };
+});
+export const fromCloudflareFetcher = (fetcher) => {
+    const fetch = (request) => Effect.promise((signal) => fetcher.fetch(request, {
+        signal: signal,
+    }));
+    return {
+        connect: (address, options) => fromCloudflareSocket(fetcher.connect(address, options)),
+        fetch: (request) => HttpClientRequest.isHttpClientRequest(request)
+            ? pipe(HttpServerRequest.toWeb(HttpServerRequest.fromClientRequest(request)), Effect.flatMap(fetch), Effect.map((response) => HttpClientResponse.fromWeb(request, response)), Effect.catch((error) => Effect.succeed(HttpClientResponse.fromWeb(request, new Response(error.message, {
+                status: error._tag === "InternalError"
+                    ? 500
+                    : error._tag === "RequestParseError"
+                        ? 400
+                        : 404,
+            })))))
+            : pipe(HttpServerRequest.toWeb(request), Effect.flatMap(fetch), Effect.map((response) => {
+                if (response.status === 101) {
+                    return HttpServerResponse.setBody(HttpServerResponse.empty({ status: 101 }), HttpBody.raw(response));
+                }
+                return HttpServerResponse.fromWeb(response);
+            })),
+    };
+};
+/**
+ * Adapt anything that exposes a server-shaped `fetch` (e.g. a Durable Object
+ * stub, a Worker service binding) into an Effect `HttpClient`. Lets HttpApi
+ * clients address bindings without a base URL via `transformClient`.
+ */
+export const toHttpClient = (fetcher) => HttpClient.make((request) => {
+    console.log("toHttpClient: request", request.url);
+    return fetcher.fetch(HttpServerRequest.fromClientRequest(request)).pipe(Effect.map((response) => {
+        console.log("toHttpClient: response", response);
+        return HttpClientResponse.fromWeb(request, HttpServerResponse.toWeb(response));
+    }), Effect.mapError((cause) => new HttpClientError({
+        reason: new TransportError({
+            request,
+            cause,
+            description: "Fetcher-backed HttpClient request failed",
+        }),
+    })));
+});
+export const fromCloudflareSocket = (cfSocket) => {
+    const latch = Latch.makeUnsafe(false);
+    let currentFiberSet;
+    let writerRef;
+    const encoder = new TextEncoder();
+    const closeError = (code, closeReason) => new Socket.SocketError({
+        reason: new Socket.SocketCloseError({ code, closeReason }),
+    });
+    const runRaw = (handler, opts) => Effect.scopedWith(Effect.fnUntraced(function* (scope) {
+        // Cloudflare exposes connection establishment as a promise rather than an
+        // event emitter, so we normalize that into the same SocketOpenError shape
+        // Effect uses for the official adapters.
+        yield* Effect.tryPromise({
+            try: () => cfSocket.opened,
+            catch: (cause) => new Socket.SocketError({
+                reason: new Socket.SocketOpenError({
+                    kind: "Unknown",
+                    cause,
+                }),
+            }),
+        });
+        const reader = cfSocket.readable.getReader();
+        // Mirror `fromTransformStream`: the reader is scoped to a single `runRaw`
+        // invocation and is always cancelled when that scope closes.
+        yield* Scope.addFinalizer(scope, Effect.promise(() => reader.cancel()));
+        const fiberSet = yield* FiberSet.make().pipe(Scope.provide(scope));
+        const runFork = yield* FiberSet.runtime(fiberSet)();
+        // Keep the remote-close watcher inside the FiberSet instead of attaching a
+        // raw `.then(...)` callback. That matches Effect's pattern of keeping all
+        // background work scoped and lets `FiberSet.join` observe close outcomes.
+        yield* Effect.tryPromise({
+            try: async () => {
+                await cfSocket.closed;
+                throw closeError(1000);
+            },
+            catch: (cause) => Socket.isSocketError(cause) ? cause : closeError(1006),
+        }).pipe(FiberSet.run(fiberSet));
+        // The read loop itself follows `fromTransformStream`: fork the loop into
+        // the FiberSet so handler effects can run concurrently while `join`
+        // remains the single completion point for the socket session.
+        yield* Effect.tryPromise({
+            try: async () => {
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done) {
+                        throw closeError(1000);
+                    }
+                    const result = handler(value);
+                    if (Effect.isEffect(result)) {
+                        runFork(result);
+                    }
+                }
+            },
+            catch: (cause) => Socket.isSocketError(cause)
+                ? cause
+                : new Socket.SocketError({
+                    reason: new Socket.SocketReadError({ cause }),
+                }),
+        }).pipe(FiberSet.run(fiberSet));
+        currentFiberSet = fiberSet;
+        // Writers are gated on the latch exactly like the official adapters so a
+        // caller cannot send data before the read side has been fully installed.
+        latch.openUnsafe();
+        if (opts?.onOpen)
+            yield* opts.onOpen;
+        return yield* Effect.catchFilter(FiberSet.join(fiberSet), Socket.SocketCloseError.filterClean((code) => code === 1000 || code === 1006), () => Effect.void);
+    })).pipe(Effect.ensuring(Effect.sync(() => {
+        latch.closeUnsafe();
+        currentFiberSet = undefined;
+    })));
+    const run = (handler, opts) => runRaw((data) => typeof data === "string"
+        ? handler(encoder.encode(data))
+        : handler(data), opts);
+    const decoder = new TextDecoder();
+    const runString = (handler, opts) => runRaw((data) => typeof data === "string"
+        ? handler(data)
+        : handler(decoder.decode(data)), opts);
+    const write = (chunk) => latch.whenOpen(Effect.suspend(() => {
+        if (Socket.isCloseEvent(chunk)) {
+            // `fromTransformStream` signals a local close by completing the
+            // FiberSet's deferred rather than trying to force stream semantics that
+            // don't exist. We do the same here so `runRaw` unwinds through `join`.
+            return Deferred.fail(currentFiberSet.deferred, closeError(chunk.code, chunk.reason));
+        }
+        if (!writerRef) {
+            writerRef = cfSocket.writable.getWriter();
+        }
+        const data = typeof chunk === "string" ? encoder.encode(chunk) : chunk;
+        return Effect.tryPromise({
+            try: () => writerRef.write(data),
+            catch: (cause) => new Socket.SocketError({
+                reason: new Socket.SocketWriteError({ cause }),
+            }),
+        });
+    }));
+    const writer = Effect.acquireRelease(Effect.succeed(write), () => 
+    // Treat writer shutdown as best-effort cleanup. Cloudflare may already have
+    // closed the writable side by the time the scope releases.
+    Effect.promise(async () => {
+        if (writerRef) {
+            await writerRef.close().catch(() => { });
+        }
+    }));
+    return Socket.Socket.of({
+        [Socket.TypeId]: Socket.TypeId,
+        run,
+        runRaw,
+        runString,
+        writer,
+    });
+};
+//# sourceMappingURL=Fetcher.js.map

package/lib/Cloudflare/Fetcher.js.map

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

package/lib/Cloudflare/Hyperdrive/Hyperdrive.d.ts

@@ -0,0 +1,141 @@
+import * as Effect from "effect/Effect";
+import * as Redacted from "effect/Redacted";
+import { AlchemyContext } from "../../AlchemyContext.ts";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import { CloudflareEnvironment } from "../CloudflareEnvironment.ts";
+import type { Providers } from "../Providers.ts";
+import { HyperdriveBinding } from "./HyperdriveBinding.ts";
+export type HyperdriveScheme = "postgres" | "postgresql" | "mysql";
+/**
+ * Origin configuration for a public PostgreSQL or MySQL database.
+ */
+export type HyperdrivePublicOrigin = {
+    scheme: HyperdriveScheme;
+    host: string;
+    port?: number;
+    database: string;
+    user: string;
+    /**
+     * Database password.
+     */
+    password: Redacted.Redacted<string>;
+};
+/**
+ * Origin configuration for a database fronted by Cloudflare Access.
+ */
+export type HyperdriveAccessOrigin = {
+    scheme: HyperdriveScheme;
+    host: string;
+    database: string;
+    user: string;
+    password: Redacted.Redacted<string>;
+    accessClientId: Redacted.Redacted<string>;
+    accessClientSecret: Redacted.Redacted<string>;
+};
+export type HyperdriveOrigin = HyperdrivePublicOrigin | HyperdriveAccessOrigin;
+export type HyperdriveCaching = {
+    /**
+     * Whether caching is disabled.
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Maximum duration items should persist in the cache, in seconds.
+     * @default 60
+     */
+    maxAge?: number;
+    /**
+     * Number of seconds the cache may serve a stale response while revalidating.
+     * @default 15
+     */
+    staleWhileRevalidate?: number;
+};
+export type HyperdriveMtls = {
+    caCertificateId?: string;
+    mtlsCertificateId?: string;
+    /**
+     * @default "require"
+     */
+    sslmode?: "require" | "verify-ca" | "verify-full";
+};
+export type HyperdriveDevOrigin = HyperdrivePublicOrigin & {
+    /**
+     * @default "prefer"
+     */
+    sslmode?: "disable" | "prefer" | "require" | "verify-ca" | "verify-full";
+};
+export type HyperdriveProps = {
+    /**
+     * Name of the Hyperdrive configuration. If omitted, a unique name will be
+     * generated.
+     * @default ${app}-${stage}-${id}
+     */
+    name?: string;
+    /**
+     * Database connection origin. Hyperdrive supports public Postgres/MySQL
+     * databases and databases fronted by Cloudflare Access.
+     */
+    origin: HyperdriveOrigin;
+    /**
+     * Caching configuration.
+     */
+    caching?: HyperdriveCaching;
+    /**
+     * mTLS configuration.
+     */
+    mtls?: HyperdriveMtls;
+    /**
+     * The (soft) maximum number of connections Hyperdrive is allowed to make to
+     * the origin database.
+     */
+    originConnectionLimit?: number;
+    /**
+     * Local development overrides. When the stack runs in dev mode
+     * connect to a locally running database
+     */
+    dev?: HyperdriveDevOrigin;
+};
+export type Hyperdrive = Resource<"Cloudflare.Hyperdrive", HyperdriveProps, {
+    hyperdriveId: string;
+    name: string;
+    accountId: string;
+    origin: HyperdriveOrigin;
+    mtls: HyperdriveMtls;
+    dev: HyperdriveDevOrigin | undefined;
+}, never, Providers>;
+/**
+ * A Cloudflare Hyperdrive configuration.
+ *
+ * Hyperdrive accelerates and pools connections to existing PostgreSQL or
+ * MySQL databases, exposing them to Workers via a binding. Create a config
+ * as a resource, then bind it to a Worker to obtain a connection string.
+ *
+ * @section Creating a Hyperdrive
+ * @example Public Postgres origin
+ * ```typescript
+ * const hd = yield* Cloudflare.Hyperdrive("my-pg", {
+ *   origin: {
+ *     scheme: "postgres",
+ *     host: "db.example.com",
+ *     port: 5432,
+ *     database: "app",
+ *     user: "app",
+ *     password: alchemy.secret.env.DB_PASSWORD,
+ *   },
+ * });
+ * ```
+ *
+ * @section Binding to a Worker
+ * @example Using Hyperdrive inside a Worker
+ * ```typescript
+ * const hd = yield* Cloudflare.Hyperdrive.bind(MyDB);
+ * const url = yield* hd.connectionString;
+ * ```
+ */
+export declare const Hyperdrive: import("../../Resource.ts").ResourceClassWithMethods<Hyperdrive, {
+    readonly bind: (<Req = never>(args_0: Hyperdrive | Effect.Effect<Hyperdrive, never, Req>) => Effect.Effect<import("./HyperdriveBinding.ts").HyperdriveBindingClient, never, HyperdriveBinding | Req>) & ((hyperdrive: Hyperdrive) => Effect.Effect<any, any, any>);
+}>;
+export declare const HyperdriveProvider: () => import("effect/Layer").Layer<Provider.Provider<Hyperdrive>, never, import("effect/unstable/http/HttpClient").HttpClient | AlchemyContext | import("../../Stage.ts").Stage | import("../../Stack.ts").Stack | import("@distilled.cloud/cloudflare").Credentials | CloudflareEnvironment>;
+export declare const defaultPort: (scheme: HyperdriveScheme) => number;
+//# sourceMappingURL=Hyperdrive.d.ts.map

package/lib/Cloudflare/Hyperdrive/Hyperdrive.d.ts.map

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