@panorama-industries/effect-vercel-queue 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Panorama Industries
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,14 @@
-# Temporary Holding Version
+# @panorama-industries/effect-vercel-queue
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Effect-native client for [Vercel Queues](https://vercel.com/docs/queues): typed topics, producers,
+push and poll consumers. Part of [effect-vercel](https://github.com/panorama-industries/effect-vercel).
+
+```bash
+pnpm add @panorama-industries/effect-vercel-queue effect
+```
+
+## Requirements
+
+- `effect` `^4.0.6` (peer dependency)
+- Vercel CLI `59.26.0` or above
+- ESM only

package/dist/contracts/message-handling.d.ts

@@ -0,0 +1,128 @@
+import type { Duration, Effect } from "effect";
+import { Data } from "effect";
+import type { ConcurrencyCoalescedPending, MessageMetadata, PayloadDecodeFailed } from "./queue-domain.ts";
+/** What to do with a message whose handler failed. */
+export type RetryDirective = Data.TaggedEnum<{
+    /** Acknowledge the message so it is never delivered again. */
+    Acknowledge: {};
+    /** Release the lease and redeliver the message after `delay`. */
+    RetryAfter: {
+        readonly delay: Duration.Duration;
+    };
+    /**
+     * **Experimental.** End the lease now and redeliver immediately. A handoff counts toward neither
+     * the queue's retry backoff nor its maximum attempts; past the queue's bound it is an ordinary
+     * retry.
+     */
+    ExperimentalHandoff: {};
+    /**
+     * Leave the message to the queue's own redelivery. Push consumers answer HTTP 500; pollers return
+     * the handler's error and let the lease expire.
+     */
+    Fail: {};
+}>;
+/** Constructors and matchers for {@link RetryDirective}. */
+export declare const RetryDirective: {
+    readonly $is: <Tag extends "Acknowledge" | "ExperimentalHandoff" | "Fail" | "RetryAfter">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Acknowledge";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "ExperimentalHandoff";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Fail";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "RetryAfter";
+        readonly delay: Duration.Duration;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Acknowledge" | "ExperimentalHandoff" | "Fail" | "RetryAfter"]: (args: Extract<{
+            readonly _tag: "Acknowledge";
+        } | {
+            readonly _tag: "ExperimentalHandoff";
+        } | {
+            readonly _tag: "Fail";
+        } | {
+            readonly _tag: "RetryAfter";
+            readonly delay: Duration.Duration;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "Acknowledge";
+        } | {
+            readonly _tag: "ExperimentalHandoff";
+        } | {
+            readonly _tag: "Fail";
+        } | {
+            readonly _tag: "RetryAfter";
+            readonly delay: Duration.Duration;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Acknowledge" | "ExperimentalHandoff" | "Fail" | "RetryAfter"]>>;
+        <Cases extends { readonly [Tag in "Acknowledge" | "ExperimentalHandoff" | "Fail" | "RetryAfter"]: (args: Extract<{
+            readonly _tag: "Acknowledge";
+        } | {
+            readonly _tag: "ExperimentalHandoff";
+        } | {
+            readonly _tag: "Fail";
+        } | {
+            readonly _tag: "RetryAfter";
+            readonly delay: Duration.Duration;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "Acknowledge";
+        } | {
+            readonly _tag: "ExperimentalHandoff";
+        } | {
+            readonly _tag: "Fail";
+        } | {
+            readonly _tag: "RetryAfter";
+            readonly delay: Duration.Duration;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Acknowledge" | "ExperimentalHandoff" | "Fail" | "RetryAfter"]>>;
+    };
+    readonly Acknowledge: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Acknowledge";
+    }, "_tag">;
+    readonly ExperimentalHandoff: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "ExperimentalHandoff";
+    }, "_tag">;
+    readonly Fail: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Fail";
+    }, "_tag">;
+    readonly RetryAfter: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "RetryAfter";
+        readonly delay: Duration.Duration;
+    }, "_tag">;
+};
+/**
+ * Processes one delivered payload. Succeeding acknowledges the message; failing hands the error to
+ * {@link ConsumeOptions.onError}.
+ */
+export type MessageHandler<A, E, R> = (payload: A, metadata: MessageMetadata) => Effect.Effect<void, E, R>;
+/** Failures a consumer's error policy can receive besides the handler's own errors. */
+export type ConsumeFailure = PayloadDecodeFailed | ConcurrencyCoalescedPending;
+/** How a consumer holds leases and reacts to failures. */
+export interface ConsumeOptions<E, R = never> {
+    /**
+     * How long a lease lasts before it must be renewed. The consumer renews it in the background
+     * while the handler runs. Default: 5 minutes.
+     */
+    readonly visibilityTimeout?: Duration.Input;
+    /**
+     * Choose a {@link RetryDirective} for a failed handler, an undecodable payload, or an
+     * acknowledgment refused after the coalesced reruns are used up. Default: `Fail`. Defects always
+     * mean `Fail`.
+     */
+    readonly onError?: (error: E | ConsumeFailure, metadata: MessageMetadata) => Effect.Effect<RetryDirective, never, R>;
+    /**
+     * **Experimental.** Rerun the handler, with the lease still held, up to this many times when its
+     * acknowledgment is refused because messages were coalesced into the delivery. Default: 0.
+     */
+    readonly experimentalMaxCoalescedReruns?: number;
+}
+//# sourceMappingURL=message-handling.d.ts.map

package/dist/contracts/message-handling.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handling.d.ts","sourceRoot":"","sources":["../../src/contracts/message-handling.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAE9B,OAAO,KAAK,EACV,2BAA2B,EAC3B,eAAe,EACf,mBAAmB,EACpB,MAAM,mBAAmB,CAAC;AAE3B,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,CAAC;IAC3C,8DAA8D;IAC9D,WAAW,EAAE,EAAE,CAAC;IAChB,iEAAiE;IACjE,UAAU,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAA;KAAE,CAAC;IAClD;;;;OAIG;IACH,mBAAmB,EAAE,EAAE,CAAC;IACxB;;;OAGG;IACH,IAAI,EAAE,EAAE,CAAC;CACV,CAAC,CAAC;AAEH,4DAA4D;AAC5D,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;wBAfK,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;4BAAjB,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;4BAAjB,QAAQ,CAAC,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;wBAAjB,QAAQ,CAAC,QAAQ;;CAec,CAAC;AAEhE;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,IAAI,CACpC,OAAO,EAAE,CAAC,EACV,QAAQ,EAAE,eAAe,KACtB,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAE/B,uFAAuF;AACvF,MAAM,MAAM,cAAc,GAAG,mBAAmB,GAAG,2BAA2B,CAAC;AAE/E,0DAA0D;AAC1D,MAAM,WAAW,cAAc,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK;IAC1C;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC;IAE5C;;;;OAIG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,CACjB,KAAK,EAAE,CAAC,GAAG,cAAc,EACzB,QAAQ,EAAE,eAAe,KACtB,MAAM,CAAC,MAAM,CAAC,cAAc,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC;IAE7C;;;OAGG;IACH,QAAQ,CAAC,8BAA8B,CAAC,EAAE,MAAM,CAAC;CAClD"}

package/dist/contracts/message-handling.js

@@ -0,0 +1,4 @@
+import { Data } from "effect";
+/** Constructors and matchers for {@link RetryDirective}. */
+export const RetryDirective = Data.taggedEnum();
+//# sourceMappingURL=message-handling.js.map

package/dist/contracts/message-handling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-handling.js","sourceRoot":"","sources":["../../src/contracts/message-handling.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA2B9B,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAkB,CAAC"}

package/dist/contracts/queue-api.d.ts

@@ -0,0 +1,255 @@
+import type { VercelApiError, VercelRegion } from "@panorama-industries/effect-vercel-core";
+import type { Array, Duration, Effect, Option } from "effect";
+import { Context, Data, Schema } from "effect";
+import type { BatchSizeOutOfRange, ConcurrencyKey, ConsumerDiscoveryFailed, ConsumerGroupName, ConsumerRegistryNotConfigured, CursorFallback, IdempotencyKey, MessageAlreadyProcessed, MessageCorrupted, MessageHandle, MessageId, MessageNotAvailable, MessageNotFound, ReceivedMessage, TopicName } from "./queue-domain.ts";
+/** Maximum number of messages one receive call may lease: an integer from 1 to 10. */
+export declare const ReceiveLimit: Schema.brand<Schema.Int, "ReceiveLimit">;
+/** Maximum number of messages one receive call may lease: an integer from 1 to 10. */
+export type ReceiveLimit = typeof ReceiveLimit.Type;
+/** Options for publishing one message, shared by single and batch sends. */
+export interface PublishOptions {
+    /** Drops a later publish carrying the same key while the first is retained. */
+    readonly idempotencyKey?: IdempotencyKey;
+    /** How long the message is kept: 1 minute to 7 days, default 24 hours. */
+    readonly retention?: Duration.Input;
+    /** Delay before the message becomes visible: up to 7 days and never beyond its retention. */
+    readonly delay?: Duration.Input;
+    /** Custom headers stored with the message. */
+    readonly headers?: Readonly<Record<string, string>>;
+    /** **Experimental.** See {@link ConcurrencyKey}. */
+    readonly experimentalConcurrencyKey?: ConcurrencyKey;
+}
+/** A serialized message ready to publish. */
+export interface OutgoingMessage extends PublishOptions {
+    readonly body: Uint8Array;
+    readonly contentType: string;
+}
+/** Outcome of publishing one message. */
+export type SendResult = Data.TaggedEnum<{
+    /** The queue accepted the message and assigned it an identifier. */
+    Sent: {
+        readonly messageId: MessageId;
+    };
+    /** The queue accepted the message for deferred processing; it has no identifier yet. */
+    Deferred: {};
+}>;
+/** Constructors and matchers for {@link SendResult}. */
+export declare const SendResult: {
+    readonly $is: <Tag extends "Deferred" | "Sent">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Deferred";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Sent";
+        readonly messageId: MessageId;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Deferred" | "Sent"]: (args: Extract<{
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Deferred" | "Sent"]>>;
+        <Cases extends { readonly [Tag in "Deferred" | "Sent"]: (args: Extract<{
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Deferred" | "Sent"]>>;
+    };
+    readonly Deferred: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Deferred";
+    }, "_tag">;
+    readonly Sent: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Sent";
+        readonly messageId: MessageId;
+    }, "_tag">;
+};
+/**
+ * Outcome for one entry of a batch send, in input order.
+ *
+ * A request-level failure returns no per-entry results and may happen after the queue accepted
+ * some entries; set an idempotency key on every entry from the first attempt to make retries safe.
+ */
+export type BatchSendResult = Data.TaggedEnum<{
+    Sent: {
+        readonly messageId: MessageId;
+    };
+    Deferred: {};
+    /** The queue rejected this entry; the others may still have been accepted. */
+    Failed: {
+        readonly status: number;
+        readonly message: string;
+        /** Whether publishing this entry again may succeed. */
+        readonly retryable: boolean;
+    };
+}>;
+/** Constructors and matchers for {@link BatchSendResult}. */
+export declare const BatchSendResult: {
+    readonly $is: <Tag extends "Deferred" | "Failed" | "Sent">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Deferred";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Failed";
+        readonly status: number;
+        readonly message: string;
+        readonly retryable: boolean;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Sent";
+        readonly messageId: MessageId;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Deferred" | "Failed" | "Sent"]: (args: Extract<{
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Failed";
+            readonly status: number;
+            readonly message: string;
+            readonly retryable: boolean;
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Failed";
+            readonly status: number;
+            readonly message: string;
+            readonly retryable: boolean;
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Deferred" | "Failed" | "Sent"]>>;
+        <Cases extends { readonly [Tag in "Deferred" | "Failed" | "Sent"]: (args: Extract<{
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Failed";
+            readonly status: number;
+            readonly message: string;
+            readonly retryable: boolean;
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "Deferred";
+        } | {
+            readonly _tag: "Failed";
+            readonly status: number;
+            readonly message: string;
+            readonly retryable: boolean;
+        } | {
+            readonly _tag: "Sent";
+            readonly messageId: MessageId;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Deferred" | "Failed" | "Sent"]>>;
+    };
+    readonly Deferred: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Deferred";
+    }, "_tag">;
+    readonly Failed: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Failed";
+        readonly status: number;
+        readonly message: string;
+        readonly retryable: boolean;
+    }, "_tag">;
+    readonly Sent: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Sent";
+        readonly messageId: MessageId;
+    }, "_tag">;
+};
+/** Result of extending a lease with an experimental handoff request. */
+export declare const HandoffOutcome: Schema.Literals<readonly ["accepted", "not_immediate", "limit_reached"]>;
+/** Result of extending a lease with an experimental handoff request. */
+export type HandoffOutcome = typeof HandoffOutcome.Type;
+/** Options for leasing messages from a consumer group. */
+export interface ReceiveOptions {
+    /** Maximum messages to lease; the queue's default is 1. */
+    readonly limit?: ReceiveLimit;
+    /** How long leased messages stay invisible to other consumers. */
+    readonly visibilityTimeout?: Duration.Input;
+    /** Where a consumer group with no stored position starts reading. */
+    readonly cursorFallback?: CursorFallback;
+    /** Region to receive from; defaults to `QueueConfig.region`. */
+    readonly region?: VercelRegion;
+}
+/** Options for leasing one message by identifier. */
+export interface ReceiveByIdOptions {
+    readonly visibilityTimeout?: Duration.Input;
+    /** Region that holds the message; defaults to `QueueConfig.region`. */
+    readonly region?: VercelRegion;
+}
+/** Failures every queue call can report. */
+export type QueueRequestError = VercelApiError | ConsumerRegistryNotConfigured;
+/** Failures of publishing. */
+export type QueueSendError = QueueRequestError | ConsumerDiscoveryFailed;
+/** Failures of publishing a batch. */
+export type QueueSendBatchError = QueueSendError | BatchSizeOutOfRange;
+/** Failures of leasing a specific message. */
+export type QueueReceiveByIdError = QueueRequestError | MessageNotFound | MessageNotAvailable | MessageAlreadyProcessed | MessageCorrupted;
+/** Failures of settling a lease: acknowledging it or changing its visibility. */
+export type QueueLeaseError = QueueRequestError | MessageNotFound | MessageNotAvailable;
+declare const QueueApi_base: Context.ServiceClass<QueueApi, "@effect-vercel/queue/QueueApi", {
+    /** Publish one message (`POST /api/v3/topic/{topic}`). */
+    readonly send: (topic: TopicName, message: OutgoingMessage) => Effect.Effect<SendResult, QueueSendError>;
+    /** Publish 1 to 100 messages in one request (`POST /api/v3/topic/{topic}/batch`). */
+    readonly sendBatch: (topic: TopicName, messages: Array.NonEmptyReadonlyArray<OutgoingMessage>) => Effect.Effect<ReadonlyArray<BatchSendResult>, QueueSendBatchError>;
+    /**
+     * Lease the next available messages of a consumer group. An empty array means the queue had
+     * nothing to deliver.
+     */
+    readonly receive: (topic: TopicName, consumerGroup: ConsumerGroupName, options?: ReceiveOptions) => Effect.Effect<ReadonlyArray<ReceivedMessage>, QueueRequestError | MessageCorrupted>;
+    /** Lease one message by identifier, as push delivery does for messages sent without a body. */
+    readonly receiveById: (topic: TopicName, consumerGroup: ConsumerGroupName, messageId: MessageId, options?: ReceiveByIdOptions) => Effect.Effect<ReceivedMessage, QueueReceiveByIdError>;
+    /**
+     * Acknowledge a leased message so the consumer group never receives it again.
+     *
+     * `experimentalIfCoalesced` acknowledges only if no more than that many messages have been
+     * coalesced into the delivery; otherwise it fails with `ConcurrencyCoalescedPending`.
+     */
+    readonly acknowledge: (handle: MessageHandle, options?: {
+        readonly experimentalIfCoalesced?: number;
+    }) => Effect.Effect<void, QueueLeaseError>;
+    /**
+     * Set how long a leased message stays invisible, counted from now. A zero timeout releases the
+     * lease for immediate redelivery.
+     *
+     * @returns The handoff outcome when `experimentalHandoff` was requested, otherwise none.
+     */
+    readonly changeVisibility: (handle: MessageHandle, visibilityTimeout: Duration.Input, options?: {
+        readonly experimentalHandoff?: boolean;
+    }) => Effect.Effect<Option.Option<HandoffOutcome>, QueueLeaseError>;
+}>;
+/**
+ * The Vercel Queues HTTP API, one operation per endpoint, with bodies as bytes.
+ *
+ * Most code uses `QueueProducer`, `QueueConsumer` or `QueuePoller`, which add typed topics, leases
+ * and tracing on top of this service.
+ */
+export declare class QueueApi extends QueueApi_base {
+}
+export {};
+//# sourceMappingURL=queue-api.d.ts.map

package/dist/contracts/queue-api.d.ts.map

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

package/dist/contracts/queue-api.js

@@ -0,0 +1,18 @@
+import { Context, Data, Schema } from "effect";
+/** Maximum number of messages one receive call may lease: an integer from 1 to 10. */
+export const ReceiveLimit = Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 10 })).pipe(Schema.brand("ReceiveLimit"));
+/** Constructors and matchers for {@link SendResult}. */
+export const SendResult = Data.taggedEnum();
+/** Constructors and matchers for {@link BatchSendResult}. */
+export const BatchSendResult = Data.taggedEnum();
+/** Result of extending a lease with an experimental handoff request. */
+export const HandoffOutcome = Schema.Literals(["accepted", "not_immediate", "limit_reached"]);
+/**
+ * The Vercel Queues HTTP API, one operation per endpoint, with bodies as bytes.
+ *
+ * Most code uses `QueueProducer`, `QueueConsumer` or `QueuePoller`, which add typed topics, leases
+ * and tracing on top of this service.
+ */
+export class QueueApi extends Context.Service()("@effect-vercel/queue/QueueApi") {
+}
+//# sourceMappingURL=queue-api.js.map

package/dist/contracts/queue-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-api.js","sourceRoot":"","sources":["../../src/contracts/queue-api.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAoB/C,sFAAsF;AACtF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAC9F,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAC7B,CAAC;AAqCF,wDAAwD;AACxD,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,EAAc,CAAC;AAoBxD,6DAA6D;AAC7D,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,EAAmB,CAAC;AAElE,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,UAAU,EAAE,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC;AAgD9F;;;;;GAKG;AACH,MAAM,OAAO,QAAS,SAAQ,OAAO,CAAC,OAAO,EAwD1C,CAAC,+BAA+B,CAAC;CAAG"}

package/dist/contracts/queue-config.d.ts

@@ -0,0 +1,87 @@
+import type { DeploymentId, VercelRegion } from "@panorama-industries/effect-vercel-core";
+import type { Option, Redacted } from "effect";
+import { Context, Data } from "effect";
+/** How the client authenticates to the queue service. */
+export type QueueAuth = Data.TaggedEnum<{
+    /** Use the Vercel OIDC token of the current request (production and `vercel env pull`). */
+    Oidc: {};
+    /** Use a fixed bearer token, such as the local broker's `VERCEL_QUEUE_TOKEN`. */
+    Token: {
+        readonly token: Redacted.Redacted<string>;
+    };
+}>;
+/** Constructors and matchers for {@link QueueAuth}. */
+export declare const QueueAuth: {
+    readonly $is: <Tag extends "Oidc" | "Token">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "Oidc";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Token";
+        readonly token: Redacted.Redacted<string>;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "Oidc" | "Token"]: (args: Extract<{
+            readonly _tag: "Oidc";
+        } | {
+            readonly _tag: "Token";
+            readonly token: Redacted.Redacted<string>;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "Oidc";
+        } | {
+            readonly _tag: "Token";
+            readonly token: Redacted.Redacted<string>;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["Oidc" | "Token"]>>;
+        <Cases extends { readonly [Tag in "Oidc" | "Token"]: (args: Extract<{
+            readonly _tag: "Oidc";
+        } | {
+            readonly _tag: "Token";
+            readonly token: Redacted.Redacted<string>;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "Oidc";
+        } | {
+            readonly _tag: "Token";
+            readonly token: Redacted.Redacted<string>;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["Oidc" | "Token"]>>;
+    };
+    readonly Oidc: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Oidc";
+    }, "_tag">;
+    readonly Token: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Token";
+        readonly token: Redacted.Redacted<string>;
+    }, "_tag">;
+};
+declare const QueueConfig_base: Context.ServiceClass<QueueConfig, "@effect-vercel/queue/QueueConfig", {
+    /** Region for sends and receives that do not name one. */
+    readonly region: VercelRegion;
+    /**
+     * Base URL of the queue service in a region; the client appends `/api/v3/...`. The default is
+     * `https://{region}.vercel-queue.com`; the local broker ignores the region.
+     */
+    readonly baseUrl: (region: VercelRegion) => URL;
+    readonly auth: QueueAuth;
+    /**
+     * Deployment sent with consumer calls (receive, acknowledge, change visibility) so the queue
+     * routes them to this deployment's consumer registration. None for the local broker.
+     */
+    readonly deploymentId: Option.Option<DeploymentId>;
+    /**
+     * Whether sends are pinned to {@link deploymentId}, so only this deployment's consumers receive
+     * them. Pinning is the default on Vercel; turning it off lets newer deployments consume.
+     */
+    readonly pinSends: boolean;
+    /** Extra headers sent with every request. */
+    readonly headers: Readonly<Record<string, string>>;
+}>;
+/** Where and as whom the queue client talks to Vercel Queues. */
+export declare class QueueConfig extends QueueConfig_base {
+}
+export {};
+//# sourceMappingURL=queue-config.d.ts.map

package/dist/contracts/queue-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-config.d.ts","sourceRoot":"","sources":["../../src/contracts/queue-config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAEvC,yDAAyD;AACzD,MAAM,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IACtC,2FAA2F;IAC3F,IAAI,EAAE,EAAE,CAAC;IACT,iFAAiF;IACjF,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;KAAE,CAAC;CACtD,CAAC,CAAC;AAEH,uDAAuD;AACvD,eAAO,MAAM,SAAS;;;;;;;wBAJK,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;;;;;;;;;4BAAzB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;;;;;;;;;;;;;4BAAzB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;wBAAzB,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC;;CAIC,CAAC;;IAMlD,0DAA0D;qBACzC,YAAY;IAE7B;;;OAGG;sBACe,CAAC,MAAM,EAAE,YAAY,KAAK,GAAG;mBAEhC,SAAS;IAExB;;;OAGG;2BACoB,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC;IAElD;;;OAGG;uBACgB,OAAO;IAE1B,6CAA6C;sBAC3B,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;;AA5BtD,iEAAiE;AACjE,qBAAa,WAAY,SAAQ,gBA6BM;CAAG"}

package/dist/contracts/queue-config.js

@@ -0,0 +1,7 @@
+import { Context, Data } from "effect";
+/** Constructors and matchers for {@link QueueAuth}. */
+export const QueueAuth = Data.taggedEnum();
+/** Where and as whom the queue client talks to Vercel Queues. */
+export class QueueConfig extends Context.Service()("@effect-vercel/queue/QueueConfig") {
+}
+//# sourceMappingURL=queue-config.js.map

package/dist/contracts/queue-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-config.js","sourceRoot":"","sources":["../../src/contracts/queue-config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAUvC,uDAAuD;AACvD,MAAM,CAAC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAa,CAAC;AAEtD,iEAAiE;AACjE,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EA6B7C,CAAC,kCAAkC,CAAC;CAAG"}

package/dist/contracts/queue-consumer.d.ts

@@ -0,0 +1,30 @@
+import type { Effect } from "effect";
+import type { HttpServerRequest, HttpServerResponse } from "effect/http";
+import { Context } from "effect";
+import type { ConsumeOptions, MessageHandler } from "./message-handling.ts";
+import type { Topic } from "./topic.ts";
+declare const QueueConsumer_base: Context.ServiceClass<QueueConsumer, "@effect-vercel/queue/QueueConsumer", {
+    /**
+     * Build the HTTP handler for a push-delivered topic.
+     *
+     * Accepts structured (`com.vercel.queue.v1beta`) and binary (`com.vercel.queue.v2beta`)
+     * CloudEvents. Responds 200 when the message was processed or was already settled elsewhere,
+     * 400 for a malformed CloudEvent, and 500 to request redelivery.
+     */
+    readonly handler: <A, I, E, R, R2 = never>(topic: Topic<A, I>, handle: MessageHandler<A, E, R>, options?: ConsumeOptions<E, R2>) => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | R | R2>;
+}>;
+/**
+ * Handles push deliveries: Vercel Queues calls a function route with a CloudEvent, and the route
+ * leases, processes and settles the message.
+ *
+ * ```ts
+ * export const POST = HttpEffect.toWebHandlerLayer(
+ *   QueueConsumer.use((consumer) => consumer.handler(Orders, fulfil)),
+ *   AppLayer,
+ * ).handler;
+ * ```
+ */
+export declare class QueueConsumer extends QueueConsumer_base {
+}
+export {};
+//# sourceMappingURL=queue-consumer.d.ts.map

package/dist/contracts/queue-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-consumer.d.ts","sourceRoot":"","sources":["../../src/contracts/queue-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;;IAgBpC;;;;;;OAMG;sBACe,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,GAAG,KAAK,EACvC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAC/B,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,EAAE,EAAE,CAAC,KAC5B,MAAM,CAAC,MAAM,CAChB,kBAAkB,CAAC,kBAAkB,EACrC,KAAK,EACL,iBAAiB,CAAC,iBAAiB,GAAG,CAAC,GAAG,EAAE,CAC7C;;AA7BL;;;;;;;;;;GAUG;AACH,qBAAa,aAAc,SAAQ,kBAoBM;CAAG"}

package/dist/contracts/queue-consumer.js

@@ -0,0 +1,15 @@
+import { Context } from "effect";
+/**
+ * Handles push deliveries: Vercel Queues calls a function route with a CloudEvent, and the route
+ * leases, processes and settles the message.
+ *
+ * ```ts
+ * export const POST = HttpEffect.toWebHandlerLayer(
+ *   QueueConsumer.use((consumer) => consumer.handler(Orders, fulfil)),
+ *   AppLayer,
+ * ).handler;
+ * ```
+ */
+export class QueueConsumer extends Context.Service()("@effect-vercel/queue/QueueConsumer") {
+}
+//# sourceMappingURL=queue-consumer.js.map

package/dist/contracts/queue-consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"queue-consumer.js","sourceRoot":"","sources":["../../src/contracts/queue-consumer.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKjC;;;;;;;;;;GAUG;AACH,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,OAAO,EAoB/C,CAAC,oCAAoC,CAAC;CAAG"}