npm - @lunora/queue - Versions diffs - 1.0.0-alpha.3 → 1.0.0-alpha.5 - Mend

@lunora/queue 1.0.0-alpha.3 → 1.0.0-alpha.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (8) hide show

package/LICENSE.md +6 -0
package/dist/index.d.mts +97 -30
package/dist/index.d.ts +97 -30
package/dist/index.mjs +2 -1
package/dist/packem_shared/createQueueCaptureSink-CRacRMqV.mjs +54 -0
package/dist/packem_shared/dispatchQueueBatch-BjWnrUuU.mjs +131 -0
package/package.json +2 -2
package/dist/packem_shared/dispatchQueueBatch-DR15pYS7.mjs +0 -19

package/LICENSE.md CHANGED Viewed

@@ -103,3 +103,9 @@ Unless required by applicable law or agreed to in writing, software distributed
 under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR
 CONDITIONS OF ANY KIND, either express or implied. See the License for the
 specific language governing permissions and limitations under the License.
+<!-- DEPENDENCIES -->
+<!-- /DEPENDENCIES -->
+<!-- TYPE_DEPENDENCIES -->
+<!-- /TYPE_DEPENDENCIES -->

package/dist/index.d.mts CHANGED Viewed

@@ -169,6 +169,102 @@ interface QueueBindingSpec {
   /** The stable wrangler queue name, e.g. `email-queue`. */
   name: string;
 }
+/** One declared queue, keyed for batch routing by its stable wrangler name. */
+interface QueueRegistryEntry {
+  /**
+  * The `defineQueue` result (carries the push handler). The body type is
+  * erased to `any` here because the registry is heterogeneous — different
+  * queues carry different message bodies, and the handler param is
+  * contravariant, so a precise `QueueDefinition&lt;Body>` would not be assignable
+  * to a shared `unknown`-bodied slot. Runtime dispatch passes the delivered
+  * batch straight through, so the erasure is type-only.
+  */
+  definition: QueueDefinition<any>;
+  /** The `lunora/queues.ts` export name, for log correlation. */
+  exportName: string;
+}
+/** Map of stable wrangler queue name → registry entry, built by codegen. */
+type QueueRegistry = Record<string, QueueRegistryEntry>;
+/** The disposition a consumer left one message in for a single delivery attempt. */
+type QueueMessageOutcome = "ack" | "error" | "retry";
+/**
+* One consumed message as captured by {@link dispatchQueueBatch} and handed to an
+* {@link QueueCaptureSink}. Structurally matches `@lunora/do`'s
+* `RecordQueueMessageInput` (the reserved `recordQueueMessage` admin RPC payload);
+* the two packages share only this contract, so keep them in sync by hand.
+*/
+interface CapturedQueueMessage {
+  /** Delivery attempt number for this message (`message.attempts`). */
+  attempts: number;
+  /** The message body (JSON-encoded + capped by the catcher). */
+  body: unknown;
+  /** `true` when this failed delivery was the message's last (its retries are exhausted — the broker dead-letters it). */
+  deadLettered: boolean;
+  /** Handler error message when `outcome` is `error`; absent otherwise. */
+  error?: string;
+  /** The `lunora/queues.ts` export name that consumed it. */
+  exportName: string;
+  /** The delivered message id (`message.id`). */
+  messageId: string;
+  /** How the handler disposed of the message this attempt. */
+  outcome: QueueMessageOutcome;
+  /** The stable wrangler queue name the batch was delivered from (`batch.queue`). */
+  queue: string;
+  /** Original message timestamp in epoch-ms (`message.timestamp`). */
+  timestamp: number;
+}
+/**
+* Persists a batch of consumed messages. The codegen worker wires this to POST the
+* batch to the root shard's `recordQueueMessage` admin RPC (the dev queue catcher).
+* Best-effort by contract: {@link dispatchQueueBatch} swallows a rejection so a
+* capture failure never changes delivery semantics.
+*/
+type QueueCaptureSink = (messages: CapturedQueueMessage[]) => Promise<void> | void;
+interface DispatchOptions {
+  /**
+  * Optional capture sink. When set, the batch is instrumented and every
+  * message's final disposition is recorded and handed to this sink after the
+  * handler runs. Omitted in production unless queue capture is enabled, so a
+  * consumer pays no instrumentation cost by default.
+  */
+  capture?: QueueCaptureSink;
+  /** Worker `env`, forwarded to the queue run context. */
+  env: Record<string, unknown>;
+  /** Injectable fetch for the `ctx.run` dispatcher (tests). */
+  fetchImpl?: typeof fetch;
+}
+/**
+* Look up the handler for `batch.queue` and invoke it with a fresh
+* `QueueRunContext`. Throws a directed error when no push handler is registered
+* for the delivered queue (a misconfiguration — the consumer was declared
+* `pull`, or the queue name drifted from the `defineQueue` export).
+*/
+declare const dispatchQueueBatch: (batch: MessageBatchLike, registry: QueueRegistry, options: DispatchOptions) => Promise<void>;
+/** A Worker `env` projected as a plain record (vars, secrets, and bindings are `unknown`-valued). */
+type QueueEnv = Record<string, unknown>;
+/** Options for {@link createQueueCaptureSink}. */
+interface QueueCaptureOptions {
+  /** Pin the consumed-message log to a Cloudflare data-residency jurisdiction (match the worker's `jurisdiction`). */
+  jurisdiction?: string;
+  /** Shard the consumed-message log lives on; override if the worker sets a custom `defaultShardKey`. */
+  rootShard?: string;
+}
+/**
+* Whether consumed queue messages should be captured into the studio's log.
+* Explicit `LUNORA_QUEUE_CAPTURE` (`"1"`/`"true"` vs `"0"`/`"false"`) always wins;
+* unset, capture is on only in a development environment. Mirrors
+* `@lunora/mail`'s `shouldCaptureMail` so mail and queue dev capture toggle the
+* same way.
+*/
+declare const shouldCaptureQueue: (env: QueueEnv) => boolean;
+/**
+* Build the {@link QueueCaptureSink} that records a processed batch into the
+* studio's root-shard consumed-message log via the reserved `recordQueueMessage`
+* admin RPC. Best-effort by contract: without the `SHARD` binding or
+* `LUNORA_ADMIN_TOKEN` it no-ops, and `dispatchQueueBatch` swallows a
+* rejection, so capture never changes delivery semantics.
+*/
+declare const createQueueCaptureSink: (env: QueueEnv, options?: QueueCaptureOptions) => QueueCaptureSink;
 /**
 * Build the `ctx.queues` map for a request: resolve every spec's `env[binding]`
 * into the `exportName → Queue binding` map and wrap it in {@link createQueues}.
@@ -232,35 +328,6 @@ declare const queueDefaultName: (exportName: string) => string;
 declare const defineQueue: <Body = unknown>(config: QueueConfig<Body>) => QueueDefinition<Body>;
 /** True when a value is a `defineQueue` result (the runtime brand check). */
 declare const isQueueDefinition: (value: unknown) => value is QueueDefinition;
-/** One declared queue, keyed for batch routing by its stable wrangler name. */
-interface QueueRegistryEntry {
-  /**
-  * The `defineQueue` result (carries the push handler). The body type is
-  * erased to `any` here because the registry is heterogeneous — different
-  * queues carry different message bodies, and the handler param is
-  * contravariant, so a precise `QueueDefinition&lt;Body>` would not be assignable
-  * to a shared `unknown`-bodied slot. Runtime dispatch passes the delivered
-  * batch straight through, so the erasure is type-only.
-  */
-  definition: QueueDefinition<any>;
-  /** The `lunora/queues.ts` export name, for log correlation. */
-  exportName: string;
-}
-/** Map of stable wrangler queue name → registry entry, built by codegen. */
-type QueueRegistry = Record<string, QueueRegistryEntry>;
-interface DispatchOptions {
-  /** Worker `env`, forwarded to the queue run context. */
-  env: Record<string, unknown>;
-  /** Injectable fetch for the `ctx.run` dispatcher (tests). */
-  fetchImpl?: typeof fetch;
-}
-/**
-* Look up the handler for `batch.queue` and invoke it with a fresh
-* `QueueRunContext`. Throws a directed error when no push handler is registered
-* for the delivered queue (a misconfiguration — the consumer was declared
-* `pull`, or the queue name drifted from the `defineQueue` export).
-*/
-declare const dispatchQueueBatch: (batch: MessageBatchLike, registry: QueueRegistry, options: DispatchOptions) => Promise<void>;
 interface RunContextOptions {
   env: Record<string, unknown>;
   exportName: string;
@@ -268,4 +335,4 @@ interface RunContextOptions {
 }
 /** Assemble the {@link QueueRunContext} passed to a `defineQueue` handler. */
 declare const createQueueRunContext: (options: RunContextOptions) => QueueRunContext;
-export { type ArgsOf, type FunctionReference, type LunoraQueuesOptions, type MessageBatchLike, type MessageLike, type MessageSendRequestLike, type QueueBindingLike, type QueueBindingSpec, type QueueConfig, type QueueConsumerMode, type QueueConsumerTuning, type QueueContentType, type QueueDefinition, type QueueHandler, type DispatchLogger as QueueLogger, type QueueProducer, type QueueRegistry, type QueueRegistryEntry, type QueueRetryOptions, type QueueRunContext, type DispatchRunFunction as QueueRunFunction, type QueueSendBatchOptions, type QueueSendOptions, type Queues, type RunFunctionOptions, createQueueContext, createQueueRunContext, createQueues, defineQueue, dispatchQueueBatch, isQueueDefinition, queueBindingName, queueDefaultName };
+export { type ArgsOf, type CapturedQueueMessage, type FunctionReference, type LunoraQueuesOptions, type MessageBatchLike, type MessageLike, type MessageSendRequestLike, type QueueBindingLike, type QueueBindingSpec, type QueueCaptureOptions, type QueueCaptureSink, type QueueConfig, type QueueConsumerMode, type QueueConsumerTuning, type QueueContentType, type QueueDefinition, type QueueEnv, type QueueHandler, type DispatchLogger as QueueLogger, type QueueProducer, type QueueRegistry, type QueueRegistryEntry, type QueueRetryOptions, type QueueRunContext, type DispatchRunFunction as QueueRunFunction, type QueueSendBatchOptions, type QueueSendOptions, type Queues, type RunFunctionOptions, createQueueCaptureSink, createQueueContext, createQueueRunContext, createQueues, defineQueue, dispatchQueueBatch, isQueueDefinition, queueBindingName, queueDefaultName, shouldCaptureQueue };

package/dist/index.d.ts CHANGED Viewed

@@ -169,6 +169,102 @@ interface QueueBindingSpec {
   /** The stable wrangler queue name, e.g. `email-queue`. */
   name: string;
 }
+/** One declared queue, keyed for batch routing by its stable wrangler name. */
+interface QueueRegistryEntry {
+  /**
+  * The `defineQueue` result (carries the push handler). The body type is
+  * erased to `any` here because the registry is heterogeneous — different
+  * queues carry different message bodies, and the handler param is
+  * contravariant, so a precise `QueueDefinition&lt;Body>` would not be assignable
+  * to a shared `unknown`-bodied slot. Runtime dispatch passes the delivered
+  * batch straight through, so the erasure is type-only.
+  */
+  definition: QueueDefinition<any>;
+  /** The `lunora/queues.ts` export name, for log correlation. */
+  exportName: string;
+}
+/** Map of stable wrangler queue name → registry entry, built by codegen. */
+type QueueRegistry = Record<string, QueueRegistryEntry>;
+/** The disposition a consumer left one message in for a single delivery attempt. */
+type QueueMessageOutcome = "ack" | "error" | "retry";
+/**
+* One consumed message as captured by {@link dispatchQueueBatch} and handed to an
+* {@link QueueCaptureSink}. Structurally matches `@lunora/do`'s
+* `RecordQueueMessageInput` (the reserved `recordQueueMessage` admin RPC payload);
+* the two packages share only this contract, so keep them in sync by hand.
+*/
+interface CapturedQueueMessage {
+  /** Delivery attempt number for this message (`message.attempts`). */
+  attempts: number;
+  /** The message body (JSON-encoded + capped by the catcher). */
+  body: unknown;
+  /** `true` when this failed delivery was the message's last (its retries are exhausted — the broker dead-letters it). */
+  deadLettered: boolean;
+  /** Handler error message when `outcome` is `error`; absent otherwise. */
+  error?: string;
+  /** The `lunora/queues.ts` export name that consumed it. */
+  exportName: string;
+  /** The delivered message id (`message.id`). */
+  messageId: string;
+  /** How the handler disposed of the message this attempt. */
+  outcome: QueueMessageOutcome;
+  /** The stable wrangler queue name the batch was delivered from (`batch.queue`). */
+  queue: string;
+  /** Original message timestamp in epoch-ms (`message.timestamp`). */
+  timestamp: number;
+}
+/**
+* Persists a batch of consumed messages. The codegen worker wires this to POST the
+* batch to the root shard's `recordQueueMessage` admin RPC (the dev queue catcher).
+* Best-effort by contract: {@link dispatchQueueBatch} swallows a rejection so a
+* capture failure never changes delivery semantics.
+*/
+type QueueCaptureSink = (messages: CapturedQueueMessage[]) => Promise<void> | void;
+interface DispatchOptions {
+  /**
+  * Optional capture sink. When set, the batch is instrumented and every
+  * message's final disposition is recorded and handed to this sink after the
+  * handler runs. Omitted in production unless queue capture is enabled, so a
+  * consumer pays no instrumentation cost by default.
+  */
+  capture?: QueueCaptureSink;
+  /** Worker `env`, forwarded to the queue run context. */
+  env: Record<string, unknown>;
+  /** Injectable fetch for the `ctx.run` dispatcher (tests). */
+  fetchImpl?: typeof fetch;
+}
+/**
+* Look up the handler for `batch.queue` and invoke it with a fresh
+* `QueueRunContext`. Throws a directed error when no push handler is registered
+* for the delivered queue (a misconfiguration — the consumer was declared
+* `pull`, or the queue name drifted from the `defineQueue` export).
+*/
+declare const dispatchQueueBatch: (batch: MessageBatchLike, registry: QueueRegistry, options: DispatchOptions) => Promise<void>;
+/** A Worker `env` projected as a plain record (vars, secrets, and bindings are `unknown`-valued). */
+type QueueEnv = Record<string, unknown>;
+/** Options for {@link createQueueCaptureSink}. */
+interface QueueCaptureOptions {
+  /** Pin the consumed-message log to a Cloudflare data-residency jurisdiction (match the worker's `jurisdiction`). */
+  jurisdiction?: string;
+  /** Shard the consumed-message log lives on; override if the worker sets a custom `defaultShardKey`. */
+  rootShard?: string;
+}
+/**
+* Whether consumed queue messages should be captured into the studio's log.
+* Explicit `LUNORA_QUEUE_CAPTURE` (`"1"`/`"true"` vs `"0"`/`"false"`) always wins;
+* unset, capture is on only in a development environment. Mirrors
+* `@lunora/mail`'s `shouldCaptureMail` so mail and queue dev capture toggle the
+* same way.
+*/
+declare const shouldCaptureQueue: (env: QueueEnv) => boolean;
+/**
+* Build the {@link QueueCaptureSink} that records a processed batch into the
+* studio's root-shard consumed-message log via the reserved `recordQueueMessage`
+* admin RPC. Best-effort by contract: without the `SHARD` binding or
+* `LUNORA_ADMIN_TOKEN` it no-ops, and `dispatchQueueBatch` swallows a
+* rejection, so capture never changes delivery semantics.
+*/
+declare const createQueueCaptureSink: (env: QueueEnv, options?: QueueCaptureOptions) => QueueCaptureSink;
 /**
 * Build the `ctx.queues` map for a request: resolve every spec's `env[binding]`
 * into the `exportName → Queue binding` map and wrap it in {@link createQueues}.
@@ -232,35 +328,6 @@ declare const queueDefaultName: (exportName: string) => string;
 declare const defineQueue: <Body = unknown>(config: QueueConfig<Body>) => QueueDefinition<Body>;
 /** True when a value is a `defineQueue` result (the runtime brand check). */
 declare const isQueueDefinition: (value: unknown) => value is QueueDefinition;
-/** One declared queue, keyed for batch routing by its stable wrangler name. */
-interface QueueRegistryEntry {
-  /**
-  * The `defineQueue` result (carries the push handler). The body type is
-  * erased to `any` here because the registry is heterogeneous — different
-  * queues carry different message bodies, and the handler param is
-  * contravariant, so a precise `QueueDefinition&lt;Body>` would not be assignable
-  * to a shared `unknown`-bodied slot. Runtime dispatch passes the delivered
-  * batch straight through, so the erasure is type-only.
-  */
-  definition: QueueDefinition<any>;
-  /** The `lunora/queues.ts` export name, for log correlation. */
-  exportName: string;
-}
-/** Map of stable wrangler queue name → registry entry, built by codegen. */
-type QueueRegistry = Record<string, QueueRegistryEntry>;
-interface DispatchOptions {
-  /** Worker `env`, forwarded to the queue run context. */
-  env: Record<string, unknown>;
-  /** Injectable fetch for the `ctx.run` dispatcher (tests). */
-  fetchImpl?: typeof fetch;
-}
-/**
-* Look up the handler for `batch.queue` and invoke it with a fresh
-* `QueueRunContext`. Throws a directed error when no push handler is registered
-* for the delivered queue (a misconfiguration — the consumer was declared
-* `pull`, or the queue name drifted from the `defineQueue` export).
-*/
-declare const dispatchQueueBatch: (batch: MessageBatchLike, registry: QueueRegistry, options: DispatchOptions) => Promise<void>;
 interface RunContextOptions {
   env: Record<string, unknown>;
   exportName: string;
@@ -268,4 +335,4 @@ interface RunContextOptions {
 }
 /** Assemble the {@link QueueRunContext} passed to a `defineQueue` handler. */
 declare const createQueueRunContext: (options: RunContextOptions) => QueueRunContext;
-export { type ArgsOf, type FunctionReference, type LunoraQueuesOptions, type MessageBatchLike, type MessageLike, type MessageSendRequestLike, type QueueBindingLike, type QueueBindingSpec, type QueueConfig, type QueueConsumerMode, type QueueConsumerTuning, type QueueContentType, type QueueDefinition, type QueueHandler, type DispatchLogger as QueueLogger, type QueueProducer, type QueueRegistry, type QueueRegistryEntry, type QueueRetryOptions, type QueueRunContext, type DispatchRunFunction as QueueRunFunction, type QueueSendBatchOptions, type QueueSendOptions, type Queues, type RunFunctionOptions, createQueueContext, createQueueRunContext, createQueues, defineQueue, dispatchQueueBatch, isQueueDefinition, queueBindingName, queueDefaultName };
+export { type ArgsOf, type CapturedQueueMessage, type FunctionReference, type LunoraQueuesOptions, type MessageBatchLike, type MessageLike, type MessageSendRequestLike, type QueueBindingLike, type QueueBindingSpec, type QueueCaptureOptions, type QueueCaptureSink, type QueueConfig, type QueueConsumerMode, type QueueConsumerTuning, type QueueContentType, type QueueDefinition, type QueueEnv, type QueueHandler, type DispatchLogger as QueueLogger, type QueueProducer, type QueueRegistry, type QueueRegistryEntry, type QueueRetryOptions, type QueueRunContext, type DispatchRunFunction as QueueRunFunction, type QueueSendBatchOptions, type QueueSendOptions, type Queues, type RunFunctionOptions, createQueueCaptureSink, createQueueContext, createQueueRunContext, createQueues, defineQueue, dispatchQueueBatch, isQueueDefinition, queueBindingName, queueDefaultName, shouldCaptureQueue };

package/dist/index.mjs CHANGED Viewed

@@ -1,5 +1,6 @@
+export { createQueueCaptureSink, shouldCaptureQueue } from './packem_shared/createQueueCaptureSink-CRacRMqV.mjs';
 export { createQueueContext } from './packem_shared/createQueueContext-D0XCdCsd.mjs';
 export { default as createQueues } from './packem_shared/createQueues-14-vSICK.mjs';
 export { defineQueue, isQueueDefinition, queueBindingName, queueDefaultName } from './packem_shared/defineQueue-D40gREfg.mjs';
-export { dispatchQueueBatch } from './packem_shared/dispatchQueueBatch-DR15pYS7.mjs';
+export { dispatchQueueBatch } from './packem_shared/dispatchQueueBatch-BjWnrUuU.mjs';
 export { createQueueRunContext } from './packem_shared/createQueueRunContext-_2hD-TK7.mjs';

package/dist/packem_shared/createQueueCaptureSink-CRacRMqV.mjs ADDED Viewed

@@ -0,0 +1,54 @@
+const RECORD_QUEUE_MESSAGE_OP = "__lunora_admin__:recordQueueMessage";
+const DEFAULT_ROOT_SHARD = "__root__";
+const DEV_ENVIRONMENT_PATTERN = /^(?:dev(?:elopment)?|local(?:host)?|test)$/iu;
+const ENVIRONMENT_VARS = ["CF_ENV", "ENVIRONMENT", "NODE_ENV", "WORKER_ENV"];
+const CAPTURE_FETCH_TIMEOUT_MS = 5e3;
+const shouldCaptureQueue = (env) => {
+  const flag = env["LUNORA_QUEUE_CAPTURE"];
+  if (typeof flag === "string") {
+    return flag === "1" || flag.toLowerCase() === "true";
+  }
+  return ENVIRONMENT_VARS.some((key) => {
+    const value = env[key];
+    return typeof value === "string" && DEV_ENVIRONMENT_PATTERN.test(value);
+  });
+};
+const createQueueCaptureSink = (env, options = {}) => {
+  const rootShard = options.rootShard ?? DEFAULT_ROOT_SHARD;
+  return async (messages) => {
+    if (messages.length === 0) {
+      return;
+    }
+    const binding = env["SHARD"];
+    const adminToken = typeof env["LUNORA_ADMIN_TOKEN"] === "string" ? env["LUNORA_ADMIN_TOKEN"] : void 0;
+    if (binding === void 0 || adminToken === void 0) {
+      return;
+    }
+    let namespace = binding;
+    if (options.jurisdiction !== void 0) {
+      if (typeof binding.jurisdiction !== "function") {
+        throw new TypeError(
+          `@lunora/queue: Durable Object namespace does not support jurisdiction("${options.jurisdiction}") — update @cloudflare/workers-types or remove the jurisdiction option`
+        );
+      }
+      namespace = binding.jurisdiction(options.jurisdiction);
+    }
+    const stub = namespace.get(namespace.idFromName(rootShard));
+    const controller = new AbortController();
+    const timeout = setTimeout(() => {
+      controller.abort();
+    }, CAPTURE_FETCH_TIMEOUT_MS);
+    try {
+      await stub.fetch("https://shard.internal/rpc", {
+        body: JSON.stringify({ args: { messages }, functionPath: RECORD_QUEUE_MESSAGE_OP }),
+        headers: { authorization: `Bearer ${adminToken}`, "content-type": "application/json" },
+        method: "POST",
+        signal: controller.signal
+      });
+    } finally {
+      clearTimeout(timeout);
+    }
+  };
+};
+export { createQueueCaptureSink, shouldCaptureQueue };

package/dist/packem_shared/dispatchQueueBatch-BjWnrUuU.mjs ADDED Viewed

@@ -0,0 +1,131 @@
+import { LunoraError } from '@lunora/errors';
+import { createQueueRunContext } from './createQueueRunContext-_2hD-TK7.mjs';
+const DEFAULT_MAX_RETRIES = 3;
+const timestampToMs = (value) => {
+  if (value instanceof Date) {
+    return value.getTime();
+  }
+  const asNumber = typeof value === "number" ? value : Number(value);
+  return Number.isFinite(asNumber) ? asNumber : 0;
+};
+const instrumentBatch = (batch) => {
+  const dispositions = /* @__PURE__ */ new Map();
+  const originals = batch.messages;
+  const wrappedMessages = originals.map((message) => {
+    return {
+      ack: () => {
+        dispositions.set(message, "ack");
+        message.ack();
+      },
+      get attempts() {
+        return message.attempts;
+      },
+      get body() {
+        return message.body;
+      },
+      get id() {
+        return message.id;
+      },
+      retry: (options) => {
+        dispositions.set(message, "retry");
+        message.retry(options);
+      },
+      get timestamp() {
+        return message.timestamp;
+      }
+    };
+  });
+  const fillUndecided = (outcome) => {
+    for (const message of originals) {
+      if (!dispositions.has(message)) {
+        dispositions.set(message, outcome);
+      }
+    }
+  };
+  const wrappedBatch = {
+    ackAll: () => {
+      fillUndecided("ack");
+      batch.ackAll();
+    },
+    messages: wrappedMessages,
+    queue: batch.queue,
+    retryAll: (options) => {
+      fillUndecided("retry");
+      batch.retryAll(options);
+    }
+  };
+  return { dispositions, originals, wrappedBatch };
+};
+const describeThrownError = (handlerError) => {
+  if (handlerError instanceof Error) {
+    return handlerError.message;
+  }
+  if (typeof handlerError === "string") {
+    return handlerError;
+  }
+  if (handlerError !== null && typeof handlerError === "object") {
+    try {
+      return JSON.stringify(handlerError);
+    } catch {
+      return "[unserializable thrown value]";
+    }
+  }
+  return String(handlerError);
+};
+const buildCaptureRecords = (harness, entry, queue, threw, handlerError) => {
+  const errorMessage = threw ? describeThrownError(handlerError) : void 0;
+  const maxRetries = typeof entry.definition.maxRetries === "number" ? entry.definition.maxRetries : DEFAULT_MAX_RETRIES;
+  return harness.originals.map((message) => {
+    const decided = harness.dispositions.get(message);
+    const outcome = decided ?? (threw ? "error" : "ack");
+    const attempts = typeof message.attempts === "number" ? message.attempts : 1;
+    return {
+      attempts,
+      body: message.body,
+      deadLettered: outcome !== "ack" && attempts > maxRetries,
+      error: outcome === "error" ? errorMessage : void 0,
+      exportName: entry.exportName,
+      messageId: message.id,
+      outcome,
+      queue,
+      timestamp: timestampToMs(message.timestamp)
+    };
+  });
+};
+const dispatchQueueBatch = async (batch, registry, options) => {
+  const entry = registry[batch.queue];
+  if (entry === void 0) {
+    const known = Object.keys(registry);
+    const suffix = known.length === 0 ? "no push queues are declared" : `known push queues: ${known.join(", ")}`;
+    throw new LunoraError("INTERNAL", `@lunora/queue: received a batch for queue "${batch.queue}" but no push handler is registered (${suffix})`);
+  }
+  const { handler } = entry.definition;
+  if (typeof handler !== "function") {
+    throw new TypeError(`@lunora/queue: queue "${batch.queue}" (${entry.exportName}) has no push handler — it is declared as a pull consumer`);
+  }
+  const context = createQueueRunContext({ env: options.env, exportName: entry.exportName, fetchImpl: options.fetchImpl });
+  if (options.capture === void 0) {
+    await handler(context, batch);
+    return;
+  }
+  const harness = instrumentBatch(batch);
+  let threw = false;
+  let handlerError;
+  try {
+    await handler(context, harness.wrappedBatch);
+  } catch (error) {
+    threw = true;
+    handlerError = error;
+  }
+  try {
+    const records = buildCaptureRecords(harness, entry, batch.queue, threw, handlerError);
+    await options.capture(records);
+  } catch {
+  }
+  if (threw) {
+    throw handlerError;
+  }
+};
+export { dispatchQueueBatch };

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@lunora/queue",
-  "version": "1.0.0-alpha.3",
+  "version": "1.0.0-alpha.5",
   "description": "Cloudflare Queues for Lunora: defineQueue producers + consumers, the ctx.queues surface, and the generated queue() worker handler",
   "keywords": [
     "background-jobs",
@@ -44,7 +44,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@lunora/errors": "1.0.0-alpha.1"
+    "@lunora/errors": "1.0.0-alpha.2"
   },
   "engines": {
     "node": "^22.15.0 || >=24.11.0"

package/dist/packem_shared/dispatchQueueBatch-DR15pYS7.mjs DELETED Viewed

@@ -1,19 +0,0 @@
-import { LunoraError } from '@lunora/errors';
-import { createQueueRunContext } from './createQueueRunContext-_2hD-TK7.mjs';
-const dispatchQueueBatch = async (batch, registry, options) => {
-  const entry = registry[batch.queue];
-  if (entry === void 0) {
-    const known = Object.keys(registry);
-    const suffix = known.length === 0 ? "no push queues are declared" : `known push queues: ${known.join(", ")}`;
-    throw new LunoraError("INTERNAL", `@lunora/queue: received a batch for queue "${batch.queue}" but no push handler is registered (${suffix})`);
-  }
-  const { handler } = entry.definition;
-  if (typeof handler !== "function") {
-    throw new TypeError(`@lunora/queue: queue "${batch.queue}" (${entry.exportName}) has no push handler — it is declared as a pull consumer`);
-  }
-  const context = createQueueRunContext({ env: options.env, exportName: entry.exportName, fetchImpl: options.fetchImpl });
-  await handler(context, batch);
-};
-export { dispatchQueueBatch };