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

package/lib/Cloudflare/Queue/QueueEventSource.d.ts

@@ -0,0 +1,106 @@
+import type * as cf from "@cloudflare/workers-types";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import * as Binding from "../../Binding.ts";
+import { RuntimeContext } from "../../RuntimeContext.ts";
+import type { Queue } from "./Queue.ts";
+/**
+ * Subscriber settings — the same shape Cloudflare's `QueueConsumer`
+ * accepts. `messages(queue, props).subscribe(...)` passes these
+ * through to the auto-created `Cloudflare.QueueConsumer` so a single
+ * call captures both runtime and deploy-time intent.
+ */
+export interface MessagesProps {
+    /** Maximum messages per batch. */
+    batchSize?: number;
+    /** Maximum concurrent invocations. */
+    maxConcurrency?: number;
+    /** Maximum delivery attempts before dead-lettering. */
+    maxRetries?: number;
+    /** Wait time, in ms, before flushing a partial batch. */
+    maxWaitTimeMs?: number;
+    /** Backoff, in seconds, applied to a retry. */
+    retryDelay?: number;
+    /** Optional dead-letter queue name. */
+    deadLetterQueue?: string;
+}
+/**
+ * A single queue message handed to the subscribe handler. Mirrors
+ * Cloudflare's runtime `Message<Body>` shape so per-message
+ * `ack()` / `retry()` semantics match the platform docs.
+ */
+export type QueueMessage<Body = unknown> = cf.Message<Body>;
+/**
+ * Subscribe to a Cloudflare Queue with an Effect stream handler.
+ *
+ * Mirrors `AWS.SQS.messages(queue).subscribe(...)` on the
+ * Cloudflare side. Wires both halves of the consumer in one call:
+ *
+ * - **Runtime**: registers a `queue` event listener on the Worker.
+ *   Each batch is piped through `process` as a `Stream.Stream`.
+ * - **Deploy-time**: yields a `Cloudflare.QueueConsumer` resource
+ *   so Cloudflare actually dispatches messages from `queue` to
+ *   this Worker. No manual `QueueConsumer` wiring needed in
+ *   `alchemy.run.ts`.
+ *
+ * Acking semantics: if `process` succeeds, every message in the
+ * batch is `ack()`ed; if it fails, every message is `retry()`ed
+ * and Cloudflare applies `maxRetries` / `retryDelay` from the
+ * settings before dead-lettering. Per-message control is still
+ * available by calling `msg.ack()` / `msg.retry()` inside the
+ * handler.
+ *
+ * @example
+ * ```typescript
+ * import * as Cloudflare from "alchemy/Cloudflare";
+ * import * as Effect from "effect/Effect";
+ * import * as Stream from "effect/Stream";
+ *
+ * yield* Cloudflare.messages<MyEvent>(queueResource, {
+ *   batchSize: 25,
+ *   maxRetries: 3,
+ * }).subscribe((stream) =>
+ *   Stream.runForEach(stream, (msg) =>
+ *     Effect.log(`event ${msg.body.id}`),
+ *   ),
+ * );
+ * ```
+ */
+export declare const messages: <Body = unknown>(queue: Queue, props?: MessagesProps) => {
+    subscribe: <Req = never>(process: (stream: Stream.Stream<QueueMessage<Body>>) => Effect.Effect<void, unknown, Req>) => Effect.Effect<void, never, QueueEventSource>;
+};
+export type QueueEventSourceService = <Body = unknown, Req = never>(queue: Queue, props: MessagesProps, process: (stream: Stream.Stream<QueueMessage<Body>>) => Effect.Effect<void, unknown, Req>) => Effect.Effect<void, never, never>;
+declare const QueueEventSource_base: Context.ServiceClass<QueueEventSource, "Cloudflare.Queue.QueueEventSource", QueueEventSourceService>;
+/**
+ * Service tag for the Cloudflare Queue event source. Provided by
+ * {@link QueueEventSourceLive} on the Worker's runtime layer.
+ */
+export declare class QueueEventSource extends QueueEventSource_base {
+}
+declare const QueueEventSourcePolicy_base: Binding.Policy<QueueEventSourcePolicy, "Policy<Cloudflare.Queue.QueueEventSource>", (queue: Queue, props: MessagesProps) => Effect.Effect<void>>;
+/**
+ * Deploy-time policy that yields a `Cloudflare.QueueConsumer`
+ * resource pointing the host Worker at the queue. Provided in
+ * `Cloudflare.providers()` and used by {@link QueueEventSourceLive}
+ * via `yield* QueueEventSourcePolicy(...)`. At runtime the policy
+ * is absent, so the call is a no-op.
+ */
+export declare class QueueEventSourcePolicy extends QueueEventSourcePolicy_base {
+}
+export declare const QueueEventSourcePolicyLive: Layer.Layer<QueueEventSourcePolicy, never, never>;
+/**
+ * Runtime layer for {@link messages}. Wires each
+ * `messages(queue).subscribe(...)` call in the Worker init phase to
+ * a `queue` event listener on the runtime context, and asks the
+ * deploy-time policy ({@link QueueEventSourcePolicy}, provided in
+ * `Cloudflare.providers()`) to yield the matching
+ * `Cloudflare.QueueConsumer` resource.
+ *
+ * Provide alongside other Cloudflare runtime layers (e.g.
+ * `QueueBindingLive`) on the Worker effect.
+ */
+export declare const QueueEventSourceLive: Layer.Layer<QueueEventSource, never, RuntimeContext<import("../../RuntimeContext.ts").BaseRuntimeContext> | QueueEventSourcePolicy>;
+export {};
+//# sourceMappingURL=QueueEventSource.d.ts.map

package/lib/Cloudflare/Queue/QueueEventSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"QueueEventSource.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Queue/QueueEventSource.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,EAAE,MAAM,2BAA2B,CAAC;AAErD,OAAO,KAAK,OAAO,MAAM,gBAAgB,CAAC;AAC1C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,OAAO,MAAM,kBAAkB,CAAC;AAE5C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAGzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGxC;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yDAAyD;IACzD,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,CAAC,IAAI,GAAG,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,GAAG,OAAO,EACrC,OAAO,KAAK,EACZ,QAAO,aAAkB;gBAEb,GAAG,mBACJ,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KACtC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC;CAGxC,CAAC;AAQH,MAAM,MAAM,uBAAuB,GAAG,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,GAAG,KAAK,EAChE,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,CACP,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,KACtC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,KACnC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;;AAEvC;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,qBAGE;CAAG;uIAWjC,KAAK,SAAS,aAAa,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;AAT7D;;;;;;GAMG;AACH,qBAAa,sBAAuB,SAAQ,2BAGJ;CAAG;AAE3C,eAAO,MAAM,0BAA0B,mDAiCtC,CAAC;AAEF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,oBAAoB,qIA8DhC,CAAC"}

package/lib/Cloudflare/Queue/QueueEventSource.js

@@ -0,0 +1,145 @@
+import * as Cause from "effect/Cause";
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as Stream from "effect/Stream";
+import * as Binding from "../../Binding.js";
+import { RuntimeContext } from "../../RuntimeContext.js";
+import { isWorker, isWorkerEvent } from "../Workers/Worker.js";
+import { QueueConsumer } from "./QueueConsumer.js";
+/**
+ * Subscribe to a Cloudflare Queue with an Effect stream handler.
+ *
+ * Mirrors `AWS.SQS.messages(queue).subscribe(...)` on the
+ * Cloudflare side. Wires both halves of the consumer in one call:
+ *
+ * - **Runtime**: registers a `queue` event listener on the Worker.
+ *   Each batch is piped through `process` as a `Stream.Stream`.
+ * - **Deploy-time**: yields a `Cloudflare.QueueConsumer` resource
+ *   so Cloudflare actually dispatches messages from `queue` to
+ *   this Worker. No manual `QueueConsumer` wiring needed in
+ *   `alchemy.run.ts`.
+ *
+ * Acking semantics: if `process` succeeds, every message in the
+ * batch is `ack()`ed; if it fails, every message is `retry()`ed
+ * and Cloudflare applies `maxRetries` / `retryDelay` from the
+ * settings before dead-lettering. Per-message control is still
+ * available by calling `msg.ack()` / `msg.retry()` inside the
+ * handler.
+ *
+ * @example
+ * ```typescript
+ * import * as Cloudflare from "alchemy/Cloudflare";
+ * import * as Effect from "effect/Effect";
+ * import * as Stream from "effect/Stream";
+ *
+ * yield* Cloudflare.messages<MyEvent>(queueResource, {
+ *   batchSize: 25,
+ *   maxRetries: 3,
+ * }).subscribe((stream) =>
+ *   Stream.runForEach(stream, (msg) =>
+ *     Effect.log(`event ${msg.body.id}`),
+ *   ),
+ * );
+ * ```
+ */
+export const messages = (queue, props = {}) => ({
+    subscribe: (process) => QueueEventSource.use((source) => source(queue, props, process)),
+});
+/**
+ * Service tag for the Cloudflare Queue event source. Provided by
+ * {@link QueueEventSourceLive} on the Worker's runtime layer.
+ */
+export class QueueEventSource extends Context.Service()("Cloudflare.Queue.QueueEventSource") {
+}
+/**
+ * Deploy-time policy that yields a `Cloudflare.QueueConsumer`
+ * resource pointing the host Worker at the queue. Provided in
+ * `Cloudflare.providers()` and used by {@link QueueEventSourceLive}
+ * via `yield* QueueEventSourcePolicy(...)`. At runtime the policy
+ * is absent, so the call is a no-op.
+ */
+export class QueueEventSourcePolicy extends Binding.Policy()("Cloudflare.Queue.QueueEventSource") {
+}
+export const QueueEventSourcePolicyLive = QueueEventSourcePolicy.layer.succeed(
+// Cast: yielding `QueueConsumer(...)` requires the Cloudflare
+// `Providers` services, which the deploy-time stack provides
+// when this policy runs (the worker's init scope inherits the
+// stack's services). `Binding.Policy.layer.succeed` types the
+// body as `Effect<void, never, never>` to keep most policies
+// simple; we step around that constraint here because we
+// genuinely need to spawn a sibling resource at deploy time.
+((host, queue, props) => Effect.gen(function* () {
+    if (!isWorker(host)) {
+        return yield* Effect.die(`Cloudflare.messages(...).subscribe(...) is only supported on ` +
+            `Cloudflare.Worker hosts (got '${host.Type}').`);
+    }
+    // Yield the QueueConsumer resource as a sibling of the
+    // Worker. The engine creates / updates / destroys it
+    // alongside the Worker's lifecycle; the consumer's
+    // reconciler waits for the Worker upload to expose the
+    // `queue` handler before completing (see PR #257 for the
+    // 11001 retry).
+    yield* QueueConsumer(`${queue.LogicalId}Consumer`, {
+        queueId: queue.queueId,
+        scriptName: host.workerName,
+        settings: props,
+        deadLetterQueue: props.deadLetterQueue,
+    });
+})));
+/**
+ * Runtime layer for {@link messages}. Wires each
+ * `messages(queue).subscribe(...)` call in the Worker init phase to
+ * a `queue` event listener on the runtime context, and asks the
+ * deploy-time policy ({@link QueueEventSourcePolicy}, provided in
+ * `Cloudflare.providers()`) to yield the matching
+ * `Cloudflare.QueueConsumer` resource.
+ *
+ * Provide alongside other Cloudflare runtime layers (e.g.
+ * `QueueBindingLive`) on the Worker effect.
+ */
+export const QueueEventSourceLive = Layer.effect(QueueEventSource, Effect.gen(function* () {
+    const policy = yield* QueueEventSourcePolicy;
+    return Effect.fn(function* (queue, props, process) {
+        // Deploy-time: ensure the QueueConsumer resource exists. At
+        // runtime this Layer's `policy` resolves to the no-op variant
+        // (Binding.Policy provides that automatically via
+        // `Effect.serviceOption`), so this becomes a no-op.
+        yield* policy(queue, props);
+        // Resolve the runtime context per-call rather than at layer
+        // construction. Capturing it on the layer would leak the
+        // requirement past `PlatformServices` exclusion when the
+        // Worker typechecks its init effect.
+        const ctx = (yield* RuntimeContext);
+        // Capture the queue-name accessor once; the listener body
+        // re-resolves it per event via `yield* QueueName`. A worker
+        // can consume multiple queues — each subscribe registers its
+        // own listener and they all see every queue event, so the
+        // queue-name match is what scopes the handler.
+        const QueueName = yield* queue.queueName;
+        yield* ctx.listen((event) => {
+            if (!isWorkerEvent(event) || event.type !== "queue")
+                return;
+            const batch = event.input;
+            return Effect.gen(function* () {
+                const queueName = yield* QueueName;
+                if (batch.queue !== queueName)
+                    return;
+                yield* process(Stream.fromIterable(batch.messages)).pipe(Effect.tap(() => Effect.sync(() => {
+                    for (const msg of batch.messages)
+                        msg.ack();
+                })), Effect.onError((cause) => Effect.sync(() => {
+                    // Surface the failure so the operator sees what
+                    // tripped the retry path; without this the only
+                    // signal is the message reappearing on the next
+                    // attempt.
+                    console.error(`[QueueEventSource] handler failed on queue ` +
+                        `"${queueName}": ${Cause.pretty(cause)}`);
+                    for (const msg of batch.messages)
+                        msg.retry();
+                })), Effect.catchCause(() => Effect.void));
+            });
+        });
+    });
+}));
+//# sourceMappingURL=QueueEventSource.js.map

package/lib/Cloudflare/Queue/QueueEventSource.js.map

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

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

@@ -0,0 +1,5 @@
+export * from "./Queue.ts";
+export * from "./QueueBinding.ts";
+export * from "./QueueConsumer.ts";
+export * from "./QueueEventSource.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/Cloudflare/Queue/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/lib/Cloudflare/Queue/index.js

@@ -0,0 +1,5 @@
+export * from "./Queue.js";
+export * from "./QueueBinding.js";
+export * from "./QueueConsumer.js";
+export * from "./QueueEventSource.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/Cloudflare/Queue/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/lib/Cloudflare/R2/R2Bucket.d.ts

@@ -0,0 +1,317 @@
+import * as Effect from "effect/Effect";
+import * as Provider from "../../Provider.ts";
+import { Resource } from "../../Resource.ts";
+import { CloudflareEnvironment } from "../CloudflareEnvironment.ts";
+import type * as Cloudflare from "../Providers.ts";
+import * as Zone from "../Zone.ts";
+import { R2BucketBinding } from "./R2BucketBinding.ts";
+export type R2BucketName = string;
+export type R2BucketCustomDomainZone = Zone.ZoneReference;
+export type R2BucketCustomDomain = {
+    /**
+     * Custom domain name to attach to the bucket.
+     */
+    name: string;
+    /**
+     * Zone that contains the custom domain. If omitted, the zone is inferred
+     * from `domain`. Pass a zone ID string, a hostname in the zone, or any object
+     * with a `zoneId` attribute such as `Cloudflare.Zone`.
+     */
+    zone?: R2BucketCustomDomainZone;
+    /**
+     * Whether public bucket access is enabled at this custom domain.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Allowlist of TLS ciphers in BoringSSL format.
+     */
+    ciphers?: string[];
+    /**
+     * Minimum TLS version accepted by the custom domain.
+     * @default "1.0"
+     */
+    minTLS?: "1.0" | "1.1" | "1.2" | "1.3";
+};
+export type R2BucketLifecycleCondition = {
+    type: "Age";
+    /**
+     * Maximum age of an object, in seconds, before the rule's action applies.
+     */
+    maxAge: number;
+} | {
+    type: "Date";
+    /**
+     * Absolute date (ISO 8601) at which the rule's action applies.
+     */
+    date: string;
+};
+export type R2BucketLifecycleRule = {
+    /**
+     * Unique identifier for the rule within the bucket.
+     */
+    id: string;
+    /**
+     * Whether the rule is enabled.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Object key prefix the rule applies to. Use `""` (or omit) to match all
+     * objects in the bucket.
+     * @default ""
+     */
+    prefix?: string;
+    /**
+     * Abort incomplete multipart uploads after the configured age.
+     */
+    abortMultipartUploadsTransition?: {
+        condition?: {
+            type: "Age";
+            maxAge: number;
+        };
+    };
+    /**
+     * Delete matching objects after the configured age or on a specific date.
+     */
+    deleteObjectsTransition?: {
+        condition?: R2BucketLifecycleCondition;
+    };
+    /**
+     * Transition matching objects to a different storage class. Cloudflare R2
+     * only supports transitioning to `InfrequentAccess` today.
+     */
+    storageClassTransitions?: {
+        condition: R2BucketLifecycleCondition;
+        storageClass: "InfrequentAccess";
+    }[];
+};
+export type R2BucketProps = {
+    /**
+     * Name of the bucket. If omitted, a unique name will be generated.
+     * @default ${app}-${stage}-${id}
+     */
+    name?: string;
+    /**
+     * Storage class for newly uploaded objects.
+     * @default "Standard"
+     */
+    storageClass?: R2Bucket.StorageClass;
+    /**
+     * Jurisdiction where objects in this bucket are guaranteed to be stored.
+     * @default "default"
+     */
+    jurisdiction?: R2Bucket.Jurisdiction;
+    /**
+     * Location hint for the bucket.
+     */
+    locationHint?: R2Bucket.Location;
+    /**
+     * Custom domains to attach to the bucket. Pass an empty array (or omit)
+     * to remove all custom domains.
+     */
+    domains?: R2BucketCustomDomain[];
+    /**
+     * Object lifecycle rules applied to the bucket. Pass an empty array (or
+     * omit) to clear all lifecycle rules. See the Cloudflare R2 docs for
+     * supported transitions.
+     */
+    lifecycleRules?: R2BucketLifecycleRule[];
+};
+export type R2Bucket = Resource<"Cloudflare.R2Bucket", R2BucketProps, {
+    bucketName: R2BucketName;
+    storageClass: R2Bucket.StorageClass;
+    jurisdiction: R2Bucket.Jurisdiction;
+    location: R2Bucket.Location | undefined;
+    accountId: string;
+    domains: R2Bucket.CustomDomain[];
+    lifecycleRules: R2Bucket.LifecycleRule[];
+}, never, Cloudflare.Providers>;
+/**
+ * A Cloudflare R2 object storage bucket with S3-compatible API.
+ *
+ * R2 provides zero-egress-fee object storage. Create a bucket as a resource,
+ * then bind it to a Worker to read and write objects at runtime.
+ *
+ * @section Creating a Bucket
+ * @example Basic R2 bucket
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket");
+ * ```
+ *
+ * @example Bucket with location hint
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   locationHint: "wnam",
+ * });
+ * ```
+ *
+ * @section Binding to a Worker
+ * @example Reading and writing objects
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket.bind(MyBucket);
+ *
+ * // Write an object
+ * yield* bucket.put("hello.txt", "Hello, World!");
+ *
+ * // Read an object
+ * const object = yield* bucket.get("hello.txt");
+ * if (object) {
+ *   const text = yield* object.text();
+ * }
+ * ```
+ *
+ * @example Streaming upload with content length
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket.bind(MyBucket);
+ *
+ * yield* bucket.put("upload.bin", request.stream, {
+ *   contentLength: Number(request.headers["content-length"] ?? 0),
+ * });
+ * ```
+ *
+ * @section Custom Domains
+ *
+ * Attach one or more custom domains to serve bucket objects from a hostname
+ * you control. The domain's zone must already exist in your Cloudflare
+ * account; the zone is inferred from the hostname when omitted, or you can
+ * pass a `Cloudflare.Zone` resource, a zone ID, or any hostname inside the
+ * zone via the `zone` field.
+ *
+ * @example Single custom domain
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   domains: [{ name: "assets.example.com" }],
+ * });
+ * ```
+ *
+ * @example Multiple custom domains
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   domains: [
+ *     { name: "assets.example.com" },
+ *     { name: "static.example.com" },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Disable a custom domain without removing it
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   domains: [{ name: "assets.example.com", enabled: false }],
+ * });
+ * ```
+ *
+ * @example Custom domain with explicit zone and TLS settings
+ * ```typescript
+ * const zone = yield* Cloudflare.Zone("ExampleZone", {
+ *   name: "example.com",
+ * });
+ *
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   domains: [
+ *     {
+ *       name: "assets.example.com",
+ *       zone,
+ *       minTLS: "1.2",
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @section Object Lifecycle Rules
+ *
+ * Configure lifecycle rules to automatically delete objects, abort
+ * incomplete multipart uploads, or transition objects to InfrequentAccess
+ * storage. Pass an empty array (or omit) to clear all rules. See the
+ * [Cloudflare R2 docs](https://developers.cloudflare.com/r2/buckets/object-lifecycles/)
+ * for details and limits (max 1000 rules per bucket).
+ *
+ * @example Delete objects 30 days after upload
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   lifecycleRules: [
+ *     {
+ *       id: "expire-old-objects",
+ *       deleteObjectsTransition: {
+ *         condition: { type: "Age", maxAge: 60 * 60 * 24 * 30 },
+ *       },
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Transition to InfrequentAccess after 60 days, delete after 365
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   lifecycleRules: [
+ *     {
+ *       id: "archive-then-delete",
+ *       prefix: "logs/",
+ *       storageClassTransitions: [
+ *         {
+ *           condition: { type: "Age", maxAge: 60 * 60 * 24 * 60 },
+ *           storageClass: "InfrequentAccess",
+ *         },
+ *       ],
+ *       deleteObjectsTransition: {
+ *         condition: { type: "Age", maxAge: 60 * 60 * 24 * 365 },
+ *       },
+ *     },
+ *   ],
+ * });
+ * ```
+ *
+ * @example Abort incomplete multipart uploads after 7 days
+ * ```typescript
+ * const bucket = yield* Cloudflare.R2Bucket("MyBucket", {
+ *   lifecycleRules: [
+ *     {
+ *       id: "abort-stale-uploads",
+ *       abortMultipartUploadsTransition: {
+ *         condition: { type: "Age", maxAge: 60 * 60 * 24 * 7 },
+ *       },
+ *     },
+ *   ],
+ * });
+ * ```
+ */
+export declare const R2Bucket: import("../../Resource.ts").ResourceClassWithMethods<R2Bucket, {
+    readonly bind: (<Req = never>(args_0: R2Bucket | Effect.Effect<R2Bucket, never, Req>) => Effect.Effect<import("./R2BucketBinding.ts").R2BucketClient, never, R2BucketBinding | Req>) & ((bucket: R2Bucket) => Effect.Effect<any, any, any>);
+}>;
+export declare namespace R2Bucket {
+    type StorageClass = "Standard" | "InfrequentAccess";
+    type Jurisdiction = "default" | "eu" | "fedramp";
+    type Location = "apac" | "eeur" | "enam" | "weur" | "wnam" | "oc";
+    type LifecycleRule = {
+        id: string;
+        enabled: boolean;
+        prefix: string;
+        abortMultipartUploadsTransition: {
+            condition: {
+                type: "Age";
+                maxAge: number;
+            } | undefined;
+        } | undefined;
+        deleteObjectsTransition: {
+            condition: R2BucketLifecycleCondition | undefined;
+        } | undefined;
+        storageClassTransitions: {
+            condition: R2BucketLifecycleCondition;
+            storageClass: "InfrequentAccess";
+        }[] | undefined;
+    };
+    type CustomDomain = {
+        domain: string;
+        zoneId: string | undefined;
+        enabled: boolean;
+        ciphers: string[] | undefined;
+        minTLS: "1.0" | "1.1" | "1.2" | "1.3" | undefined;
+        status: {
+            ownership: "pending" | "active" | "deactivated" | "blocked" | "error" | "unknown";
+            ssl: "initializing" | "pending" | "active" | "deactivated" | "error" | "unknown";
+        } | undefined;
+    };
+}
+export declare const R2BucketProvider: () => import("effect/Layer").Layer<Provider.Provider<R2Bucket>, never, import("effect/unstable/http/HttpClient").HttpClient | import("../../Stage.ts").Stage | import("../../Stack.ts").Stack | Cloudflare.Credentials | CloudflareEnvironment>;
+//# sourceMappingURL=R2Bucket.d.ts.map

package/lib/Cloudflare/R2/R2Bucket.d.ts.map

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