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

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

@@ -0,0 +1,171 @@
+import { Schema } from "effect";
+/** Name of a queue topic: letters, digits, `_` and `-`. */
+export declare const TopicName: Schema.brand<Schema.String, "TopicName">;
+/** Name of a queue topic: letters, digits, `_` and `-`. */
+export type TopicName = typeof TopicName.Type;
+/** Name of a consumer group; each group receives every message of a topic once. */
+export declare const ConsumerGroupName: Schema.brand<Schema.String, "ConsumerGroupName">;
+/** Name of a consumer group; each group receives every message of a topic once. */
+export type ConsumerGroupName = typeof ConsumerGroupName.Type;
+/** Identifier the queue assigns to a message when it accepts it. */
+export declare const MessageId: Schema.brand<Schema.NonEmptyString, "MessageId">;
+/** Identifier the queue assigns to a message when it accepts it. */
+export type MessageId = typeof MessageId.Type;
+/** Proof of one lease on a message; acknowledging or extending the lease requires it. */
+export declare const ReceiptHandle: Schema.brand<Schema.NonEmptyString, "ReceiptHandle">;
+/** Proof of one lease on a message. */
+export type ReceiptHandle = typeof ReceiptHandle.Type;
+/** Key the queue uses to drop duplicate publishes of the same logical message. */
+export declare const IdempotencyKey: Schema.brand<Schema.NonEmptyString, "IdempotencyKey">;
+/** Key the queue uses to drop duplicate publishes of the same logical message. */
+export type IdempotencyKey = typeof IdempotencyKey.Type;
+/**
+ * **Experimental.** Key that serializes processing: at most one message per key is leased at a
+ * time, and messages published while one is in flight may be coalesced into it.
+ */
+export declare const ConcurrencyKey: Schema.brand<Schema.NonEmptyString, "ConcurrencyKey">;
+/** **Experimental.** Key that serializes processing of messages that share it. */
+export type ConcurrencyKey = typeof ConcurrencyKey.Type;
+/** Where a consumer group with no stored position starts reading a topic. */
+export declare const CursorFallback: Schema.Literals<readonly ["earliest", "latest"]>;
+/** Where a consumer group with no stored position starts reading a topic. */
+export type CursorFallback = typeof CursorFallback.Type;
+declare const MessageHandle_base: Schema.Class<MessageHandle, Schema.Struct<{
+    readonly topic: Schema.brand<Schema.String, "TopicName">;
+    readonly consumerGroup: Schema.brand<Schema.String, "ConsumerGroupName">;
+    readonly messageId: Schema.brand<Schema.NonEmptyString, "MessageId">;
+    readonly receiptHandle: Schema.brand<Schema.NonEmptyString, "ReceiptHandle">;
+    /** Region that issued the lease; follow-up calls must go to the same region. */
+    readonly region: Schema.brand<Schema.String, "VercelRegion">;
+}>, {}>;
+/** Everything needed to acknowledge a leased message or change its visibility. */
+export declare class MessageHandle extends MessageHandle_base {
+}
+/** **Experimental.** Present when a handler run is a rerun caused by coalesced messages. */
+export declare const ExperimentalCoalesced: Schema.Struct<{
+    /** Which rerun of this delivery is executing, from 1. */
+    readonly rerun: Schema.Int;
+    /** How many messages had been coalesced into this delivery when its acknowledgment was refused. */
+    readonly coalescedCount: Schema.Int;
+}>;
+declare const MessageMetadata_base: Schema.Class<MessageMetadata, Schema.Struct<{
+    readonly messageId: Schema.brand<Schema.NonEmptyString, "MessageId">;
+    /** Number of times the message has been delivered, including this delivery (from 1). */
+    readonly deliveryCount: Schema.Int;
+    readonly createdAt: Schema.DateTimeUtc;
+    /** When the message expires and stops being delivered, set by its retention. */
+    readonly expiresAt: Schema.DateTimeUtc;
+    readonly topic: Schema.brand<Schema.String, "TopicName">;
+    readonly consumerGroup: Schema.brand<Schema.String, "ConsumerGroupName">;
+    readonly region: Schema.brand<Schema.String, "VercelRegion">;
+    /** **Experimental.** How many handoffs preceded this delivery. */
+    readonly experimentalHandoffCount: Schema.optionalKey<Schema.Int>;
+    readonly experimentalCoalesced: Schema.optionalKey<Schema.Struct<{
+        /** Which rerun of this delivery is executing, from 1. */
+        readonly rerun: Schema.Int;
+        /** How many messages had been coalesced into this delivery when its acknowledgment was refused. */
+        readonly coalescedCount: Schema.Int;
+    }>>;
+}>, {}>;
+/** Facts about one delivery of a message, passed to message handlers. */
+export declare class MessageMetadata extends MessageMetadata_base {
+}
+declare const ReceivedMessage_base: Schema.Class<ReceivedMessage, Schema.Struct<{
+    readonly handle: typeof MessageHandle;
+    readonly metadata: typeof MessageMetadata;
+    readonly contentType: Schema.String;
+    readonly body: Schema.Uint8Array;
+}>, {}>;
+/** A leased message as returned by the queue, before its payload is decoded. */
+export declare class ReceivedMessage extends ReceivedMessage_base {
+}
+declare const MessageNotFound_base: Schema.Class<MessageNotFound, Schema.TaggedStruct<"MessageNotFound", {
+    readonly messageId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The message does not exist, or has expired (HTTP 404). */
+export declare class MessageNotFound extends MessageNotFound_base {
+}
+declare const MessageLocked_base: Schema.Class<MessageLocked, Schema.TaggedStruct<"MessageLocked", {
+    /** Delay the queue suggested before retrying, when it sent one. */
+    readonly retryAfter: Schema.Option<Schema.Duration>;
+}>, import("effect/Cause").YieldableError>;
+/** Another consumer holds the lease; retry once it is released. */
+export declare class MessageLocked extends MessageLocked_base {
+}
+declare const ConcurrencyCoalescedPending_base: Schema.Class<ConcurrencyCoalescedPending, Schema.TaggedStruct<"ConcurrencyCoalescedPending", {
+    readonly coalescedCount: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * **Experimental.** The acknowledgment was refused because messages with the same concurrency key
+ * were coalesced into this delivery after it started.
+ */
+export declare class ConcurrencyCoalescedPending extends ConcurrencyCoalescedPending_base {
+}
+declare const MessageUnavailable_base: Schema.Class<MessageUnavailable, Schema.TaggedStruct<"MessageUnavailable", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The message exists but cannot be leased or settled right now, for no more specific reason. */
+export declare class MessageUnavailable extends MessageUnavailable_base {
+}
+declare const MessageNotAvailable_base: Schema.Class<MessageNotAvailable, Schema.TaggedStruct<"MessageNotAvailable", {
+    readonly messageId: Schema.String;
+    readonly reason: Schema.Union<readonly [typeof MessageLocked, typeof ConcurrencyCoalescedPending, typeof MessageUnavailable]>;
+}>, import("effect/Cause").YieldableError>;
+/** The message cannot be leased or settled by this consumer (HTTP 409). */
+export declare class MessageNotAvailable extends MessageNotAvailable_base {
+}
+declare const MessageAlreadyProcessed_base: Schema.Class<MessageAlreadyProcessed, Schema.TaggedStruct<"MessageAlreadyProcessed", {
+    readonly messageId: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The message was already acknowledged by this consumer group (HTTP 410). */
+export declare class MessageAlreadyProcessed extends MessageAlreadyProcessed_base {
+}
+declare const MessageCorrupted_base: Schema.Class<MessageCorrupted, Schema.TaggedStruct<"MessageCorrupted", {
+    readonly messageId: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** The queue returned a message whose headers or body could not be read. */
+export declare class MessageCorrupted extends MessageCorrupted_base {
+}
+declare const ConsumerDiscoveryFailed_base: Schema.Class<ConsumerDiscoveryFailed, Schema.TaggedStruct<"ConsumerDiscoveryFailed", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * The queue could not reach the deployment that consumes this topic (HTTP 502,
+ * `consumer_discovery_failed`), usually because the pinned deployment is gone.
+ */
+export declare class ConsumerDiscoveryFailed extends ConsumerDiscoveryFailed_base {
+}
+declare const ConsumerRegistryNotConfigured_base: Schema.Class<ConsumerRegistryNotConfigured, Schema.TaggedStruct<"ConsumerRegistryNotConfigured", {
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/**
+ * The project has no consumer registry, so messages cannot be routed to consumers (HTTP 503,
+ * `consumer_registry_not_configured`).
+ */
+export declare class ConsumerRegistryNotConfigured extends ConsumerRegistryNotConfigured_base {
+}
+declare const BatchSizeOutOfRange_base: Schema.Class<BatchSizeOutOfRange, Schema.TaggedStruct<"BatchSizeOutOfRange", {
+    readonly size: Schema.Int;
+    readonly maximum: Schema.Int;
+}>, import("effect/Cause").YieldableError>;
+/** A batch send had no entries or more than the queue's limit of 100. */
+export declare class BatchSizeOutOfRange extends BatchSizeOutOfRange_base {
+}
+declare const PayloadEncodeFailed_base: Schema.Class<PayloadEncodeFailed, Schema.TaggedStruct<"PayloadEncodeFailed", {
+    readonly topic: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A payload did not match its topic's schema when it was published. */
+export declare class PayloadEncodeFailed extends PayloadEncodeFailed_base {
+}
+declare const PayloadDecodeFailed_base: Schema.Class<PayloadDecodeFailed, Schema.TaggedStruct<"PayloadDecodeFailed", {
+    readonly topic: Schema.String;
+    readonly messageId: Schema.String;
+    readonly message: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+/** A delivered message body did not match its topic's schema. */
+export declare class PayloadDecodeFailed extends PayloadDecodeFailed_base {
+}
+export {};
+//# sourceMappingURL=queue-domain.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-domain.d.ts","sourceRoot":"","sources":["../../src/contracts/queue-domain.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,2DAA2D;AAC3D,eAAO,MAAM,SAAS,0CAErB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kDAE7B,CAAC;AAEF,mFAAmF;AACnF,MAAM,MAAM,iBAAiB,GAAG,OAAO,iBAAiB,CAAC,IAAI,CAAC;AAE9D,oEAAoE;AACpE,eAAO,MAAM,SAAS,kDAAwD,CAAC;AAE/E,oEAAoE;AACpE,MAAM,MAAM,SAAS,GAAG,OAAO,SAAS,CAAC,IAAI,CAAC;AAE9C,yFAAyF;AACzF,eAAO,MAAM,aAAa,sDAA4D,CAAC;AAEvF,uCAAuC;AACvC,MAAM,MAAM,aAAa,GAAG,OAAO,aAAa,CAAC,IAAI,CAAC;AAEtD,kFAAkF;AAClF,eAAO,MAAM,cAAc,uDAA6D,CAAC;AAEzF,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,cAAc,uDAA6D,CAAC;AAEzF,kFAAkF;AAClF,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,cAAc,kDAA0C,CAAC;AAEtE,6EAA6E;AAC7E,MAAM,MAAM,cAAc,GAAG,OAAO,cAAc,CAAC,IAAI,CAAC;;;;;;IAUtD,gFAAgF;;;AARlF,kFAAkF;AAClF,qBAAa,aAAc,SAAQ,kBASjC;CAAG;AAEL,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB;IAChC,yDAAyD;;IAEzD,mGAAmG;;EAEnG,CAAC;;;IAOD,wFAAwF;;;IAGxF,gFAAgF;;;;;IAKhF,kEAAkE;;;QAnBlE,yDAAyD;;QAEzD,mGAAmG;;;;AAIrG,yEAAyE;AACzE,qBAAa,eAAgB,SAAQ,oBAenC;CAAG;;;;;;;AAEL,gFAAgF;AAChF,qBAAa,eAAgB,SAAQ,oBAOnC;CAAG;;;;AAEL,6DAA6D;AAC7D,qBAAa,eAAgB,SAAQ,oBAEnC;CAAG;;IAIH,mEAAmE;;;AAFrE,mEAAmE;AACnE,qBAAa,aAAc,SAAQ,kBAGjC;CAAG;;;;AAEL;;;GAGG;AACH,qBAAa,2BAA4B,SAAQ,gCAKhD;CAAG;;;;AAEJ,iGAAiG;AACjG,qBAAa,kBAAmB,SAAQ,uBAKvC;CAAG;;;;;AAEJ,2EAA2E;AAC3E,qBAAa,mBAAoB,SAAQ,wBAMxC;CAAG;;;;AAEJ,8EAA8E;AAC9E,qBAAa,uBAAwB,SAAQ,4BAK5C;CAAG;;;;;AAEJ,4EAA4E;AAC5E,qBAAa,gBAAiB,SAAQ,qBAGpC;CAAG;;;;AAEL;;;GAGG;AACH,qBAAa,uBAAwB,SAAQ,4BAK5C;CAAG;;;;AAEJ;;;GAGG;AACH,qBAAa,6BAA8B,SAAQ,kCAKlD;CAAG;;;;;AAEJ,yEAAyE;AACzE,qBAAa,mBAAoB,SAAQ,wBAMxC;CAAG;;;;;AAEJ,wEAAwE;AACxE,qBAAa,mBAAoB,SAAQ,wBAMxC;CAAG;;;;;;AAEJ,iEAAiE;AACjE,qBAAa,mBAAoB,SAAQ,wBAOxC;CAAG"}

package/dist/contracts/queue-domain.js

@@ -0,0 +1,137 @@
+import { VercelRegion } from "@panorama-industries/effect-vercel-core";
+import { Schema } from "effect";
+/** Name of a queue topic: letters, digits, `_` and `-`. */
+export const TopicName = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_-]+$/)).pipe(Schema.brand("TopicName"));
+/** Name of a consumer group; each group receives every message of a topic once. */
+export const ConsumerGroupName = Schema.String.check(Schema.isPattern(/^[A-Za-z0-9_-]+$/)).pipe(Schema.brand("ConsumerGroupName"));
+/** Identifier the queue assigns to a message when it accepts it. */
+export const MessageId = Schema.NonEmptyString.pipe(Schema.brand("MessageId"));
+/** Proof of one lease on a message; acknowledging or extending the lease requires it. */
+export const ReceiptHandle = Schema.NonEmptyString.pipe(Schema.brand("ReceiptHandle"));
+/** Key the queue uses to drop duplicate publishes of the same logical message. */
+export const IdempotencyKey = Schema.NonEmptyString.pipe(Schema.brand("IdempotencyKey"));
+/**
+ * **Experimental.** Key that serializes processing: at most one message per key is leased at a
+ * time, and messages published while one is in flight may be coalesced into it.
+ */
+export const ConcurrencyKey = Schema.NonEmptyString.pipe(Schema.brand("ConcurrencyKey"));
+/** Where a consumer group with no stored position starts reading a topic. */
+export const CursorFallback = Schema.Literals(["earliest", "latest"]);
+/** Everything needed to acknowledge a leased message or change its visibility. */
+export class MessageHandle extends Schema.Class("@effect-vercel/queue/MessageHandle")({
+    topic: TopicName,
+    consumerGroup: ConsumerGroupName,
+    messageId: MessageId,
+    receiptHandle: ReceiptHandle,
+    /** Region that issued the lease; follow-up calls must go to the same region. */
+    region: VercelRegion,
+}) {
+}
+/** **Experimental.** Present when a handler run is a rerun caused by coalesced messages. */
+export const ExperimentalCoalesced = Schema.Struct({
+    /** Which rerun of this delivery is executing, from 1. */
+    rerun: Schema.Int,
+    /** How many messages had been coalesced into this delivery when its acknowledgment was refused. */
+    coalescedCount: Schema.Int,
+});
+/** Facts about one delivery of a message, passed to message handlers. */
+export class MessageMetadata extends Schema.Class("@effect-vercel/queue/MessageMetadata")({
+    messageId: MessageId,
+    /** Number of times the message has been delivered, including this delivery (from 1). */
+    deliveryCount: Schema.Int,
+    createdAt: Schema.DateTimeUtc,
+    /** When the message expires and stops being delivered, set by its retention. */
+    expiresAt: Schema.DateTimeUtc,
+    topic: TopicName,
+    consumerGroup: ConsumerGroupName,
+    region: VercelRegion,
+    /** **Experimental.** How many handoffs preceded this delivery. */
+    experimentalHandoffCount: Schema.optionalKey(Schema.Int),
+    experimentalCoalesced: Schema.optionalKey(ExperimentalCoalesced),
+}) {
+}
+/** A leased message as returned by the queue, before its payload is decoded. */
+export class ReceivedMessage extends Schema.Class("@effect-vercel/queue/ReceivedMessage")({
+    handle: MessageHandle,
+    metadata: MessageMetadata,
+    contentType: Schema.String,
+    body: Schema.Uint8Array,
+}) {
+}
+/** The message does not exist, or has expired (HTTP 404). */
+export class MessageNotFound extends Schema.TaggedError()("MessageNotFound", {
+    messageId: Schema.String,
+}) {
+}
+/** Another consumer holds the lease; retry once it is released. */
+export class MessageLocked extends Schema.TaggedError()("MessageLocked", {
+    /** Delay the queue suggested before retrying, when it sent one. */
+    retryAfter: Schema.Option(Schema.Duration),
+}) {
+}
+/**
+ * **Experimental.** The acknowledgment was refused because messages with the same concurrency key
+ * were coalesced into this delivery after it started.
+ */
+export class ConcurrencyCoalescedPending extends Schema.TaggedError()("ConcurrencyCoalescedPending", {
+    coalescedCount: Schema.Int,
+}) {
+}
+/** The message exists but cannot be leased or settled right now, for no more specific reason. */
+export class MessageUnavailable extends Schema.TaggedError()("MessageUnavailable", {
+    message: Schema.String,
+}) {
+}
+/** The message cannot be leased or settled by this consumer (HTTP 409). */
+export class MessageNotAvailable extends Schema.TaggedError()("MessageNotAvailable", {
+    messageId: Schema.String,
+    reason: Schema.Union([MessageLocked, ConcurrencyCoalescedPending, MessageUnavailable]),
+}) {
+}
+/** The message was already acknowledged by this consumer group (HTTP 410). */
+export class MessageAlreadyProcessed extends Schema.TaggedError()("MessageAlreadyProcessed", {
+    messageId: Schema.String,
+}) {
+}
+/** The queue returned a message whose headers or body could not be read. */
+export class MessageCorrupted extends Schema.TaggedError()("MessageCorrupted", {
+    messageId: Schema.String,
+    message: Schema.String,
+}) {
+}
+/**
+ * The queue could not reach the deployment that consumes this topic (HTTP 502,
+ * `consumer_discovery_failed`), usually because the pinned deployment is gone.
+ */
+export class ConsumerDiscoveryFailed extends Schema.TaggedError()("ConsumerDiscoveryFailed", {
+    message: Schema.String,
+}) {
+}
+/**
+ * The project has no consumer registry, so messages cannot be routed to consumers (HTTP 503,
+ * `consumer_registry_not_configured`).
+ */
+export class ConsumerRegistryNotConfigured extends Schema.TaggedError()("ConsumerRegistryNotConfigured", {
+    message: Schema.String,
+}) {
+}
+/** A batch send had no entries or more than the queue's limit of 100. */
+export class BatchSizeOutOfRange extends Schema.TaggedError()("BatchSizeOutOfRange", {
+    size: Schema.Int,
+    maximum: Schema.Int,
+}) {
+}
+/** A payload did not match its topic's schema when it was published. */
+export class PayloadEncodeFailed extends Schema.TaggedError()("PayloadEncodeFailed", {
+    topic: Schema.String,
+    message: Schema.String,
+}) {
+}
+/** A delivered message body did not match its topic's schema. */
+export class PayloadDecodeFailed extends Schema.TaggedError()("PayloadDecodeFailed", {
+    topic: Schema.String,
+    messageId: Schema.String,
+    message: Schema.String,
+}) {
+}
+//# sourceMappingURL=queue-domain.js.map

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

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

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

@@ -0,0 +1,169 @@
+import type { Effect } from "effect";
+import { Context, Data } from "effect";
+import type { ConsumeOptions, MessageHandler } from "./message-handling.ts";
+import type { QueueLeaseError, QueueRequestError, ReceiveByIdOptions, ReceiveOptions } from "./queue-api.ts";
+import type { ConsumerGroupName, MessageCorrupted, MessageId } from "./queue-domain.ts";
+import type { Topic } from "./topic.ts";
+/** What a poll did. */
+export type ReceiveOutcome = Data.TaggedEnum<{
+    /** This many messages were leased and handled. */
+    Processed: {
+        readonly count: number;
+    };
+    /** The consumer group had nothing to deliver. */
+    Empty: {};
+    /** The requested message does not exist or has expired. */
+    NotFound: {
+        readonly messageId: MessageId;
+    };
+    /** Another consumer holds the requested message. */
+    NotAvailable: {
+        readonly messageId: MessageId;
+    };
+    /** The requested message was already acknowledged by this consumer group. */
+    AlreadyProcessed: {
+        readonly messageId: MessageId;
+    };
+}>;
+/** Constructors and matchers for {@link ReceiveOutcome}. */
+export declare const ReceiveOutcome: {
+    readonly $is: <Tag extends "AlreadyProcessed" | "Empty" | "NotAvailable" | "NotFound" | "Processed">(tag: Tag) => (u: unknown) => u is Extract<{
+        readonly _tag: "AlreadyProcessed";
+        readonly messageId: MessageId;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Empty";
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "NotAvailable";
+        readonly messageId: MessageId;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "NotFound";
+        readonly messageId: MessageId;
+    }, {
+        readonly _tag: Tag;
+    }> | Extract<{
+        readonly _tag: "Processed";
+        readonly count: number;
+    }, {
+        readonly _tag: Tag;
+    }>;
+    readonly $match: {
+        <Cases extends { readonly [Tag in "AlreadyProcessed" | "Empty" | "NotAvailable" | "NotFound" | "Processed"]: (args: Extract<{
+            readonly _tag: "AlreadyProcessed";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Empty";
+        } | {
+            readonly _tag: "NotAvailable";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "NotFound";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Processed";
+            readonly count: number;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(cases: Cases): (value: {
+            readonly _tag: "AlreadyProcessed";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Empty";
+        } | {
+            readonly _tag: "NotAvailable";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "NotFound";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Processed";
+            readonly count: number;
+        }) => import("effect/Unify").Unify<ReturnType<Cases["AlreadyProcessed" | "Empty" | "NotAvailable" | "NotFound" | "Processed"]>>;
+        <Cases extends { readonly [Tag in "AlreadyProcessed" | "Empty" | "NotAvailable" | "NotFound" | "Processed"]: (args: Extract<{
+            readonly _tag: "AlreadyProcessed";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Empty";
+        } | {
+            readonly _tag: "NotAvailable";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "NotFound";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Processed";
+            readonly count: number;
+        }, {
+            readonly _tag: Tag;
+        }>) => any; }>(value: {
+            readonly _tag: "AlreadyProcessed";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Empty";
+        } | {
+            readonly _tag: "NotAvailable";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "NotFound";
+            readonly messageId: MessageId;
+        } | {
+            readonly _tag: "Processed";
+            readonly count: number;
+        }, cases: Cases): import("effect/Unify").Unify<ReturnType<Cases["AlreadyProcessed" | "Empty" | "NotAvailable" | "NotFound" | "Processed"]>>;
+    };
+    readonly AlreadyProcessed: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "AlreadyProcessed";
+        readonly messageId: MessageId;
+    }, "_tag">;
+    readonly Empty: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Empty";
+    }, "_tag">;
+    readonly NotAvailable: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "NotAvailable";
+        readonly messageId: MessageId;
+    }, "_tag">;
+    readonly NotFound: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "NotFound";
+        readonly messageId: MessageId;
+    }, "_tag">;
+    readonly Processed: Data.TaggedEnum.ConstructorFrom<{
+        readonly _tag: "Processed";
+        readonly count: number;
+    }, "_tag">;
+};
+/** Options for one poll: lease options plus how to handle the leased messages. */
+export type PollOptions<E, R> = ConsumeOptions<E, R> & Pick<ReceiveOptions, "limit" | "cursorFallback" | "region"> & {
+    /**
+     * How many leased messages are handled at once. Default: `"unbounded"`. Messages waiting their
+     * turn keep their leases renewed, so a lower value never lets a lease expire. In a function,
+     * keep `limit × handler time / concurrency` well under `maxDuration`.
+     */
+    readonly concurrency?: number | "unbounded";
+};
+/** Options for polling one message by identifier. */
+export type PollByIdOptions<E, R> = ConsumeOptions<E, R> & Pick<ReceiveByIdOptions, "region">;
+declare const QueuePoller_base: Context.ServiceClass<QueuePoller, "@effect-vercel/queue/QueuePoller", {
+    /**
+     * Lease up to `limit` messages and handle them, concurrently by default.
+     *
+     * @returns The outcome, or the handler's error when the error policy answered `Fail`. Also
+     *   fails with `MessageNotFound` or `MessageNotAvailable` when a lease was lost before the
+     *   message could be acknowledged.
+     */
+    readonly receive: <A, I, E, R, R2 = never>(topic: Topic<A, I>, consumerGroup: ConsumerGroupName, handle: MessageHandler<A, E, R>, options?: PollOptions<E, R2>) => Effect.Effect<ReceiveOutcome, E | QueueLeaseError | MessageCorrupted, R | R2>;
+    /** Lease one message by identifier and handle it. */
+    readonly receiveById: <A, I, E, R, R2 = never>(topic: Topic<A, I>, consumerGroup: ConsumerGroupName, messageId: MessageId, handle: MessageHandler<A, E, R>, options?: PollByIdOptions<E, R2>) => Effect.Effect<ReceiveOutcome, E | QueueRequestError | MessageCorrupted, R | R2>;
+}>;
+/**
+ * Pulls messages from a consumer group and handles them, for workloads that run outside push
+ * delivery such as workers and cron jobs.
+ */
+export declare class QueuePoller extends QueuePoller_base {
+}
+export {};
+//# sourceMappingURL=queue-poller.d.ts.map

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

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

package/dist/contracts/queue-poller.js

@@ -0,0 +1,10 @@
+import { Context, Data } from "effect";
+/** Constructors and matchers for {@link ReceiveOutcome}. */
+export const ReceiveOutcome = Data.taggedEnum();
+/**
+ * Pulls messages from a consumer group and handles them, for workloads that run outside push
+ * delivery such as workers and cron jobs.
+ */
+export class QueuePoller extends Context.Service()("@effect-vercel/queue/QueuePoller") {
+}
+//# sourceMappingURL=queue-poller.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-poller.js","sourceRoot":"","sources":["../../src/contracts/queue-poller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AA0BvC,4DAA4D;AAC5D,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAkB,CAAC;AAgBhE;;;GAGG;AACH,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EA0B7C,CAAC,kCAAkC,CAAC;CAAG"}

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

@@ -0,0 +1,23 @@
+import type { Array, Effect } from "effect";
+import { Context } from "effect";
+import type { BatchSendResult, PublishOptions, QueueSendBatchError, QueueSendError, SendResult } from "./queue-api.ts";
+import type { PayloadEncodeFailed } from "./queue-domain.ts";
+import type { Topic } from "./topic.ts";
+/** One payload of a batch send with its publish options. */
+export interface BatchEntry<A> extends PublishOptions {
+    readonly payload: A;
+}
+declare const QueueProducer_base: Context.ServiceClass<QueueProducer, "@effect-vercel/queue/QueueProducer", {
+    /** Encode a payload with its topic's schema and publish it, in a `vqs.send` producer span. */
+    readonly send: <A, I>(topic: Topic<A, I>, payload: A, options?: PublishOptions) => Effect.Effect<SendResult, QueueSendError | PayloadEncodeFailed>;
+    /**
+     * Encode and publish 1 to 100 payloads in one request. Inspect every result: a batch can mix
+     * sent, deferred and failed entries.
+     */
+    readonly sendBatch: <A, I>(topic: Topic<A, I>, entries: Array.NonEmptyReadonlyArray<BatchEntry<A>>) => Effect.Effect<ReadonlyArray<BatchSendResult>, QueueSendBatchError | PayloadEncodeFailed>;
+}>;
+/** Publishes typed payloads to topics. */
+export declare class QueueProducer extends QueueProducer_base {
+}
+export {};
+//# sourceMappingURL=queue-producer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-producer.d.ts","sourceRoot":"","sources":["../../src/contracts/queue-producer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE5C,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,OAAO,KAAK,EACV,eAAe,EACf,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAExC,4DAA4D;AAC5D,MAAM,WAAW,UAAU,CAAC,CAAC,CAAE,SAAQ,cAAc;IACnD,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;CACrB;;IAMG,8FAA8F;mBAC/E,CAAC,CAAC,EAAE,CAAC,EAClB,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,OAAO,EAAE,CAAC,EACV,OAAO,CAAC,EAAE,cAAc,KACrB,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,cAAc,GAAG,mBAAmB,CAAC;IAEpE;;;OAGG;wBACiB,CAAC,CAAC,EAAE,CAAC,EACvB,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAClB,OAAO,EAAE,KAAK,CAAC,qBAAqB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,KAChD,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,eAAe,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,CAAC;;AAlBjG,0CAA0C;AAC1C,qBAAa,aAAc,SAAQ,kBAmBM;CAAG"}

package/dist/contracts/queue-producer.js

@@ -0,0 +1,5 @@
+import { Context } from "effect";
+/** Publishes typed payloads to topics. */
+export class QueueProducer extends Context.Service()("@effect-vercel/queue/QueueProducer") {
+}
+//# sourceMappingURL=queue-producer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queue-producer.js","sourceRoot":"","sources":["../../src/contracts/queue-producer.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAiBjC,0CAA0C;AAC1C,MAAM,OAAO,aAAc,SAAQ,OAAO,CAAC,OAAO,EAmB/C,CAAC,oCAAoC,CAAC;CAAG"}

package/dist/contracts/topic.d.ts

@@ -0,0 +1,47 @@
+import { Schema } from "effect";
+import { TopicName } from "./queue-domain.ts";
+/**
+ * A queue topic and the schema of its payloads, shared by the code that publishes to it and the
+ * code that consumes it.
+ *
+ * @template A - Payload type handlers receive and producers send.
+ * @template I - Encoded form of the payload before it is serialized to bytes.
+ */
+export interface Topic<A, I = A> {
+    readonly name: TopicName;
+    /** Schema of the payload, as given by the topic's author. */
+    readonly schema: Schema.Codec<A, I>;
+    /** Content type sent with every message of this topic. */
+    readonly contentType: string;
+    /** Converts between the payload and the bytes stored in the queue. */
+    readonly wire: Schema.Codec<A, Uint8Array>;
+}
+/**
+ * Define a topic whose payloads travel as JSON (`application/json`).
+ *
+ * @param name - Topic name; an invalid name is a defect raised where the topic is defined.
+ * @param schema - Payload schema; its encoded form must be JSON-serializable.
+ */
+declare const json: <A, I>(name: string, schema: Schema.Codec<A, I>) => Topic<A, I>;
+/**
+ * Define a topic whose payloads are raw bytes (`application/octet-stream`).
+ *
+ * @param name - Topic name; an invalid name is a defect raised where the topic is defined.
+ */
+declare const bytes: (name: string) => Topic<Uint8Array>;
+/** Constructors for {@link Topic} definitions. */
+export declare const Topic: {
+    json: typeof json;
+    bytes: typeof bytes;
+};
+/** Type helpers for {@link Topic}. */
+export declare namespace Topic {
+    /** Any topic, regardless of payload type. */
+    type Any = Topic<any, any>;
+    /** Payload type of a topic, like `Schema.Type`. */
+    type Type<T extends Any> = T extends Topic<infer A, any> ? A : never;
+    /** Encoded payload type of a topic, like `Schema.Encoded`. */
+    type Encoded<T extends Any> = T extends Topic<any, infer I> ? I : never;
+}
+export {};
+//# sourceMappingURL=topic.d.ts.map

package/dist/contracts/topic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.d.ts","sourceRoot":"","sources":["../../src/contracts/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAwB,MAAM,QAAQ,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAEzB,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEpC,0DAA0D;IAC1D,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,sEAAsE;IACtE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;CAC5C;AAeD;;;;;GAKG;AACH,QAAA,MAAM,IAAI,GAAI,CAAC,EAAE,CAAC,QAAQ,MAAM,UAAU,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,KAAG,KAAK,CAAC,CAAC,EAAE,CAAC,CAKvE,CAAC;AAEH;;;;GAIG;AACH,QAAA,MAAM,KAAK,SAAU,MAAM,KAAG,KAAK,CAAC,UAAU,CAK5C,CAAC;AAEH,kDAAkD;AAClD,eAAO,MAAM,KAAK;;;CAAkB,CAAC;AAErC,sCAAsC;AACtC,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,6CAA6C;IAC7C,KAAY,GAAG,GAAG,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAElC,mDAAmD;IACnD,KAAY,IAAI,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAE5E,8DAA8D;IAC9D,KAAY,OAAO,CAAC,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,KAAK,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;CAChF"}

package/dist/contracts/topic.js

@@ -0,0 +1,34 @@
+import { Schema, SchemaTransformation } from "effect";
+import { TopicName } from "./queue-domain.js";
+const utf8Encoder = new TextEncoder();
+const utf8Decoder = new TextDecoder();
+const Utf8String = Schema.Uint8Array.pipe(Schema.decodeTo(Schema.String, SchemaTransformation.transform({
+    decode: (bytes) => utf8Decoder.decode(bytes),
+    encode: (text) => utf8Encoder.encode(text),
+})));
+/**
+ * Define a topic whose payloads travel as JSON (`application/json`).
+ *
+ * @param name - Topic name; an invalid name is a defect raised where the topic is defined.
+ * @param schema - Payload schema; its encoded form must be JSON-serializable.
+ */
+const json = (name, schema) => ({
+    name: TopicName.make(name),
+    schema,
+    contentType: "application/json",
+    wire: Utf8String.pipe(Schema.decodeTo(Schema.fromJsonString(schema))),
+});
+/**
+ * Define a topic whose payloads are raw bytes (`application/octet-stream`).
+ *
+ * @param name - Topic name; an invalid name is a defect raised where the topic is defined.
+ */
+const bytes = (name) => ({
+    name: TopicName.make(name),
+    schema: Schema.Uint8Array,
+    contentType: "application/octet-stream",
+    wire: Schema.Uint8Array,
+});
+/** Constructors for {@link Topic} definitions. */
+export const Topic = { json, bytes };
+//# sourceMappingURL=topic.js.map

package/dist/contracts/topic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"topic.js","sourceRoot":"","sources":["../../src/contracts/topic.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAsB9C,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AACtC,MAAM,WAAW,GAAG,IAAI,WAAW,EAAE,CAAC;AAEtC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CACvC,MAAM,CAAC,QAAQ,CACb,MAAM,CAAC,MAAM,EACb,oBAAoB,CAAC,SAAS,CAAqB;IACjD,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC;IAC5C,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;CAC3C,CAAC,CACH,CACF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,IAAI,GAAG,CAAO,IAAY,EAAE,MAA0B,EAAe,EAAE,CAAC,CAAC;IAC7E,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,MAAM;IACN,WAAW,EAAE,kBAAkB;IAC/B,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;CACtE,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,KAAK,GAAG,CAAC,IAAY,EAAqB,EAAE,CAAC,CAAC;IAClD,IAAI,EAAE,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC,UAAU;IACzB,WAAW,EAAE,0BAA0B;IACvC,IAAI,EAAE,MAAM,CAAC,UAAU;CACxB,CAAC,CAAC;AAEH,kDAAkD;AAClD,MAAM,CAAC,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC"}