@velajs/cloudflare 1.28.0 → 1.30.0

package/dist/queue.js

@@ -1,78 +0,0 @@
-import { observeMessage, parseQueueJob } from "@velajs/vela/queue";
-//#region src/queue/cloudflare-queue.ts
-function nativeBatch(payload) {
-	if (typeof payload !== "object" || payload === null || !("queue" in payload) || typeof payload.queue !== "string" || !("messages" in payload) || !Array.isArray(payload.messages)) throw new TypeError("Invalid native queue batch.");
-	const messages = [];
-	for (const message of payload.messages) {
-		if (typeof message !== "object" || message === null || !("body" in message) || !("ack" in message) || typeof message.ack !== "function" || !("retry" in message) || typeof message.retry !== "function" || !("id" in message) || typeof message.id !== "string" || !("timestamp" in message) || !(message.timestamp instanceof Date) || !("attempts" in message) || typeof message.attempts !== "number") throw new TypeError("Invalid native queue message.");
-		messages.push(message);
-	}
-	return {
-		queue: payload.queue,
-		messages
-	};
-}
-/** Native sends are awaited. No buffering, implicit retry, or deferred error handling. */
-function cloudflareQueueDriver(bindings, options = {}) {
-	const queues = new Map(Object.entries(bindings));
-	const consumers = new Map(Object.entries(options.consumers ?? {}));
-	for (const [physical, logical] of consumers) if (!physical.trim() || !logical.trim()) throw new TypeError("Queue mapping names must not be empty.");
-	const producerBindings = Object.entries(options.producerBindings ?? {});
-	for (const [logical, binding] of producerBindings) if (!queues.has(logical) || !binding.trim()) throw new TypeError("Invalid queue producer binding declaration.");
-	return {
-		kind: "cloudflare",
-		entrypoints: [...[...consumers].map(([queueName, queue]) => ({
-			kind: "cf:queue:module",
-			queue,
-			meta: {
-				queueName,
-				logicalQueue: queue
-			}
-		})), ...producerBindings.map(([queue, binding]) => ({
-			kind: "cf:queue:producer",
-			queue,
-			meta: {
-				logicalQueue: queue,
-				binding
-			}
-		}))],
-		async consume(payload, dispatch) {
-			const batch = nativeBatch(payload);
-			const queue = consumers.get(batch.queue);
-			if (!queue) throw new Error(`No consumer mapping for queue '${batch.queue}'.`);
-			await consumeQueueBatch(batch, (job) => dispatch(job), { queue });
-		},
-		async enqueue(job, options) {
-			const queue = queues.get(job.queue);
-			if (!queue) throw new Error(`No Cloudflare producer binding for queue '${job.queue}'.`);
-			const delayMs = options?.delayMs;
-			if (delayMs !== void 0 && (!Number.isFinite(delayMs) || delayMs < 0 || delayMs > 864e5)) throw new RangeError("Queue delayMs must be between 0 and 86400000.");
-			await queue.send(parseQueueJob(job), delayMs === void 0 ? void 0 : { delaySeconds: Math.ceil(delayMs / 1e3) });
-		}
-	};
-}
-/**
-* Bridge native messages to portable dispatch. Attempts come from the host.
-* Process every message; ack successful/unsettled deliveries, then rethrow any
-* failures so the host retries the unsettled remainder. Explicit settlement wins.
-* The callback must await all work that should determine delivery success.
-*/
-async function consumeQueueBatch(batch, dispatch, options = {}) {
-	const errors = [];
-	const queue = options.queue ?? batch.queue;
-	for (const message of batch.messages) try {
-		const job = parseQueueJob(message.body, message.attempts);
-		if (job.queue !== queue) throw new Error(`Queue envelope '${job.queue}' does not match '${queue}'.`);
-		const observed = observeMessage(message);
-		if ((await dispatch(job, observed.message))?.handled === 0) throw new Error(`Queue job '${job.name}' has no handler.`);
-		if (observed.disposition().outcome === "unsettled") observed.message.ack();
-	} catch (error) {
-		errors.push(error);
-	}
-	if (errors.length === 1) throw errors[0];
-	if (errors.length > 1) throw new AggregateError(errors, "Queue batch deliveries failed.");
-}
-//#endregion
-export { cloudflareQueueDriver, consumeQueueBatch };
-
-//# sourceMappingURL=queue.js.map

package/dist/queue.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"queue.js","names":[],"sources":["../src/queue/cloudflare-queue.ts"],"sourcesContent":["import { observeMessage, parseQueueJob } from '@velajs/vela/queue';\nimport type {\n  QueueDispatchResult,\n  QueueDriver,\n  QueueJob,\n  QueueMessageLike,\n} from '@velajs/vela/queue';\n\n/** Logical queue names mapped to native producer bindings from this application's environment. */\nexport interface CloudflareQueueProducer {\n  // Both older void-returning bindings and current metric-returning bindings work.\n  send(message: QueueJob, options?: QueueSendOptions): Promise<unknown>;\n}\nexport type CloudflareQueueBindings = Readonly<Record<string, CloudflareQueueProducer>>;\n\nexport interface CloudflareQueueDriverOptions {\n  /** Physical delivery queue name -> logical QueueModule name. */\n  consumers?: Readonly<Record<string, string>>;\n  /** Logical queue -> Wrangler producer binding name, for deployment inspection. */\n  producerBindings?: Readonly<Record<string, string>>;\n}\n\nfunction nativeBatch(payload: unknown): {\n  queue: string;\n  messages: QueueMessageLike[];\n} {\n  if (\n    typeof payload !== 'object' ||\n    payload === null ||\n    !('queue' in payload) ||\n    typeof payload.queue !== 'string' ||\n    !('messages' in payload) ||\n    !Array.isArray(payload.messages)\n  )\n    throw new TypeError('Invalid native queue batch.');\n  const messages: QueueMessageLike[] = [];\n  for (const message of payload.messages as unknown[]) {\n    if (\n      typeof message !== 'object' ||\n      message === null ||\n      !('body' in message) ||\n      !('ack' in message) ||\n      typeof message.ack !== 'function' ||\n      !('retry' in message) ||\n      typeof message.retry !== 'function' ||\n      !('id' in message) ||\n      typeof message.id !== 'string' ||\n      !('timestamp' in message) ||\n      !(message.timestamp instanceof Date) ||\n      !('attempts' in message) ||\n      typeof message.attempts !== 'number'\n    )\n      throw new TypeError('Invalid native queue message.');\n    messages.push(message as QueueMessageLike);\n  }\n  return { queue: payload.queue, messages };\n}\n\n/** Native sends are awaited. No buffering, implicit retry, or deferred error handling. */\nexport function cloudflareQueueDriver(\n  bindings: CloudflareQueueBindings,\n  options: CloudflareQueueDriverOptions = {},\n): QueueDriver {\n  const queues = new Map(Object.entries(bindings));\n  const consumers = new Map(Object.entries(options.consumers ?? {}));\n  for (const [physical, logical] of consumers) {\n    if (!physical.trim() || !logical.trim())\n      throw new TypeError('Queue mapping names must not be empty.');\n  }\n  const producerBindings = Object.entries(options.producerBindings ?? {});\n  for (const [logical, binding] of producerBindings) {\n    if (!queues.has(logical) || !binding.trim())\n      throw new TypeError('Invalid queue producer binding declaration.');\n  }\n  return {\n    kind: 'cloudflare',\n    entrypoints: [\n      ...[...consumers].map(([queueName, queue]) => ({\n        kind: 'cf:queue:module',\n        queue,\n        meta: { queueName, logicalQueue: queue },\n      })),\n      ...producerBindings.map(([queue, binding]) => ({\n        kind: 'cf:queue:producer',\n        queue,\n        meta: { logicalQueue: queue, binding },\n      })),\n    ],\n    async consume(payload, dispatch) {\n      const batch = nativeBatch(payload);\n      const queue = consumers.get(batch.queue);\n      if (!queue) throw new Error(`No consumer mapping for queue '${batch.queue}'.`);\n      await consumeQueueBatch(batch, (job) => dispatch(job), { queue });\n    },\n    async enqueue(job, options) {\n      const queue = queues.get(job.queue);\n      if (!queue) throw new Error(`No Cloudflare producer binding for queue '${job.queue}'.`);\n      const delayMs = options?.delayMs;\n      if (\n        delayMs !== undefined &&\n        (!Number.isFinite(delayMs) || delayMs < 0 || delayMs > 86_400_000)\n      ) {\n        throw new RangeError('Queue delayMs must be between 0 and 86400000.');\n      }\n      await queue.send(\n        parseQueueJob(job),\n        delayMs === undefined ? undefined : { delaySeconds: Math.ceil(delayMs / 1000) },\n      );\n    },\n  };\n}\n\nexport interface ConsumeQueueBatchOptions {\n  /** Logical queue name. Defaults to the native batch queue name. */\n  queue?: string;\n}\n\n/**\n * Bridge native messages to portable dispatch. Attempts come from the host.\n * Process every message; ack successful/unsettled deliveries, then rethrow any\n * failures so the host retries the unsettled remainder. Explicit settlement wins.\n * The callback must await all work that should determine delivery success.\n */\nexport async function consumeQueueBatch(\n  batch: { readonly queue: string; readonly messages: readonly QueueMessageLike[] },\n  dispatch: (job: QueueJob, message: QueueMessageLike) => Promise<QueueDispatchResult | void>,\n  options: ConsumeQueueBatchOptions = {},\n): Promise<void> {\n  const errors: unknown[] = [];\n  const queue = options.queue ?? batch.queue;\n  for (const message of batch.messages) {\n    try {\n      const job = parseQueueJob(message.body, message.attempts);\n      if (job.queue !== queue)\n        throw new Error(`Queue envelope '${job.queue}' does not match '${queue}'.`);\n      const observed = observeMessage(message);\n      const result = await dispatch(job, observed.message);\n      if (result?.handled === 0) throw new Error(`Queue job '${job.name}' has no handler.`);\n      if (observed.disposition().outcome === 'unsettled') observed.message.ack();\n    } catch (error) {\n      errors.push(error);\n    }\n  }\n  if (errors.length === 1) throw errors[0];\n  if (errors.length > 1) throw new AggregateError(errors, 'Queue batch deliveries failed.');\n}\n"],"mappings":"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"}