@dotpress/events 0.0.0-stage → 2.0.0-alpha.0

package/dist/cloudflare-queues.d.ts

@@ -0,0 +1,120 @@
+import { Source, Worker, Transport } from './index.js';
+import 'zod';
+
+/** Producer binding of a queue (`env.EVENTS_QUEUE` in a Worker). */
+interface CloudflareQueueBinding {
+    sendBatch(messages: Iterable<{
+        body: unknown;
+        contentType?: 'json';
+        delaySeconds?: number;
+    }>): Promise<unknown>;
+}
+/** A message received by the `queue()` handler of a Worker. */
+interface CloudflareQueueMessage {
+    readonly id: string;
+    readonly body: unknown;
+    /** Attempt number, from 1. */
+    readonly attempts: number;
+    ack(): void;
+    retry(options?: {
+        delaySeconds?: number;
+    }): void;
+}
+/** The batch received by the `queue()` handler of a Worker. */
+interface CloudflareMessageBatch {
+    readonly queue: string;
+    readonly messages: readonly CloudflareQueueMessage[];
+}
+/** REST API access, to use a queue from outside Cloudflare Workers. */
+interface CloudflareApiOptions {
+    accountId: string;
+    /** Queue ID (not its name). */
+    queueId: string;
+    /** API token with Queues permissions (read and write to pull). */
+    apiToken: string;
+    /** Base URL of the API. Defaults to `https://api.cloudflare.com/client/v4`. */
+    baseUrl?: string | undefined;
+    /** `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: typeof fetch | undefined;
+}
+/** Options of `createCloudflareQueueTransport()`. */
+type CloudflareQueueTransportOptions = {
+    /**
+     * Producer binding of the queue, or a function returning it (when the
+     * bus is created before the `env` of the Worker is available).
+     */
+    queue: CloudflareQueueBinding | (() => CloudflareQueueBinding);
+} | CloudflareApiOptions;
+/** Options of `createCloudflareQueueHandler()`. */
+interface CloudflareQueueHandlerOptions {
+    /**
+     * Producer binding of the dead-letter queue: messages that can never be
+     * handled are sent there at once, instead of failing until `max_retries`.
+     */
+    deadLetterQueue?: CloudflareQueueBinding | (() => CloudflareQueueBinding) | undefined;
+    /** Delay before a retry, in seconds, given the attempt number. */
+    retryDelay?: ((attempt: number) => number) | undefined;
+}
+/** Options of `createCloudflarePullSource()`. */
+interface CloudflarePullSourceOptions extends CloudflareApiOptions {
+    /** Messages per pull (1 to 100). Defaults to 10. */
+    batchSize?: number | undefined;
+    /**
+     * Lease of the pulled messages, in milliseconds (up to 12 hours): longer
+     * than your slowest listener, since it cannot be extended. Defaults to
+     * 30 seconds.
+     */
+    visibilityTimeoutMs?: number | undefined;
+    /** Wait before pulling again an empty queue, in milliseconds. Defaults to 1 second. */
+    pollInterval?: number | undefined;
+    /** Delay before a retry, in seconds, given the attempt number. */
+    retryDelay?: ((attempt: number) => number) | undefined;
+    /**
+     * Queue ID of the dead-letter queue: messages that can never be handled
+     * are pushed there at once, instead of failing until `max_retries`.
+     */
+    deadLetterQueueId?: string | undefined;
+}
+/**
+ * Creates a transport that sends messages to a Cloudflare Queue: through
+ * its producer binding inside a Worker, or through the REST API from
+ * anywhere else (Node.js, Lambda…).
+ *
+ * ```ts
+ * // In a Worker
+ * import { env } from 'cloudflare:workers'
+ * const transport = createCloudflareQueueTransport({ queue: () => env.EVENTS_QUEUE })
+ *
+ * // Elsewhere
+ * const transport = createCloudflareQueueTransport({ accountId, queueId, apiToken })
+ * ```
+ */
+declare const createCloudflareQueueTransport: (options: CloudflareQueueTransportOptions) => Transport;
+/**
+ * Creates the `queue()` handler of a Worker consuming the queue. Each
+ * message is acknowledged or retried on its own: a failure does not retry
+ * the whole batch. Configure `max_retries` and `dead_letter_queue` in the
+ * consumer settings (Wrangler).
+ *
+ * ```ts
+ * export default {
+ *   queue: createCloudflareQueueHandler(createWorker({ listeners })),
+ * }
+ * ```
+ */
+declare const createCloudflareQueueHandler: (worker: Worker, options?: CloudflareQueueHandlerOptions) => (batch: CloudflareMessageBatch) => Promise<void>;
+/**
+ * Body of a pulled message: JSON messages may come base64-encoded (RFC
+ * 4648), as the documentation says, or as is, as its examples show.
+ */
+declare const decodePulledBody: (body: unknown) => unknown;
+/**
+ * Creates a source that pulls the queue over HTTP, for `startWorker()` and
+ * `dotpress-events work`: a worker outside Cloudflare, or your machine.
+ * Enable an HTTP pull consumer on the queue first
+ * (`wrangler queues consumer http add <queue>`).
+ */
+declare const createCloudflarePullSource: (options: CloudflarePullSourceOptions) => Source;
+
+export { createCloudflarePullSource, createCloudflareQueueHandler, createCloudflareQueueTransport, decodePulledBody };
+export type { CloudflareApiOptions, CloudflareMessageBatch, CloudflarePullSourceOptions, CloudflareQueueBinding, CloudflareQueueHandlerOptions, CloudflareQueueMessage, CloudflareQueueTransportOptions };

package/dist/cloudflare-queues.js

@@ -0,0 +1,333 @@
+import {
+  PartialSendError
+} from "./chunk-NCQ4ZTNB.js";
+
+// src/transports/cloudflare-queues.ts
+var MAX_MESSAGE_BYTES = 128e3 - 100;
+var MAX_BATCH_MESSAGES = 100;
+var MAX_BATCH_BYTES = 256e3;
+var MAX_DELAY_SECONDS = 86400;
+var MAX_PULL_BATCH = 100;
+var MAX_VISIBILITY_MS = 432e5;
+var DEFAULT_BASE_URL = "https://api.cloudflare.com/client/v4";
+var encoder = new TextEncoder();
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var checkOptions = (label, options, allowed) => {
+  if (!isRecord(options)) {
+    throw new TypeError(`${label}: expected an object of options.`);
+  }
+  for (const key of Object.keys(options)) {
+    if (!allowed.includes(key)) {
+      throw new TypeError(`${label}: unknown option "${key}".`);
+    }
+  }
+  return options;
+};
+var checkString = (label, key, value) => {
+  if (typeof value !== "string" || value === "") {
+    throw new TypeError(`${label}: ${key} must be a non-empty string.`);
+  }
+  return value;
+};
+var checkInteger = (label, key, value, min, max) => {
+  if (value !== void 0 && (!Number.isInteger(value) || value < min || value > max)) {
+    throw new TypeError(
+      `${label}: ${key} must be an integer from ${min} to ${max}.`
+    );
+  }
+  return value;
+};
+var checkFunction = (label, key, value) => {
+  if (value !== void 0 && typeof value !== "function") {
+    throw new TypeError(`${label}: ${key} must be a function.`);
+  }
+};
+var bindingOf = (label, key, value) => {
+  if (typeof value !== "function" && typeof value?.sendBatch !== "function") {
+    throw new TypeError(
+      `${label}: ${key} must be a queue binding, or a function returning it.`
+    );
+  }
+  return () => typeof value === "function" ? value() : value;
+};
+var describe = (error) => error instanceof Error ? error.message : String(error);
+var apiOf = (label, values) => {
+  const accountId = checkString(label, "accountId", values.accountId);
+  const queueId = checkString(label, "queueId", values.queueId);
+  const apiToken = checkString(label, "apiToken", values.apiToken);
+  const { baseUrl = DEFAULT_BASE_URL, fetch: fetchFn = globalThis.fetch } = values;
+  if (typeof baseUrl !== "string" || !/^https?:\/\/[^/]/.test(baseUrl)) {
+    throw new TypeError(`${label}: baseUrl must be an http(s) URL.`);
+  }
+  if (typeof fetchFn !== "function") {
+    throw new TypeError(`${label}: fetch must be a function.`);
+  }
+  const base = baseUrl.replace(/\/+$/, "");
+  return async (path, body, queue = queueId) => {
+    const response = await fetchFn(
+      `${base}/accounts/${encodeURIComponent(accountId)}/queues/${encodeURIComponent(queue)}/messages${path}`,
+      {
+        method: "POST",
+        headers: {
+          authorization: `Bearer ${apiToken}`,
+          "content-type": "application/json"
+        },
+        body: JSON.stringify(body)
+      }
+    );
+    let result = {};
+    try {
+      result = await response.json();
+    } catch {
+    }
+    if (!response.ok || result.success === false) {
+      const errors = (Array.isArray(result.errors) ? result.errors : []).map(({ code, message }) => `${code}: ${message}`).join("; ");
+      throw new Error(
+        `Cloudflare Queues API: ${response.status} ${errors || response.statusText}`.trim()
+      );
+    }
+    return result.result;
+  };
+};
+var batchesOf = (envelopes) => {
+  const failed = [];
+  const batches = [];
+  for (const envelope of envelopes) {
+    const size = encoder.encode(JSON.stringify(envelope)).byteLength;
+    if (size > MAX_MESSAGE_BYTES) {
+      failed.push({
+        id: envelope.id,
+        error: new RangeError(
+          `Cloudflare Queues accepts messages of at most ${MAX_MESSAGE_BYTES} bytes (128 KB with its metadata), got ${size}.`
+        )
+      });
+      continue;
+    }
+    const last = batches.at(-1);
+    if (last && last.envelopes.length < MAX_BATCH_MESSAGES && last.size + size <= MAX_BATCH_BYTES) {
+      last.envelopes.push(envelope);
+      last.size += size;
+    } else {
+      batches.push({ envelopes: [envelope], size });
+    }
+  }
+  return { batches, failed };
+};
+var createCloudflareQueueTransport = (options) => {
+  const label = "createCloudflareQueueTransport()";
+  const values = checkOptions(label, options, [
+    "queue",
+    "accountId",
+    "queueId",
+    "apiToken",
+    "baseUrl",
+    "fetch"
+  ]);
+  let sendBatch;
+  if (values.queue !== void 0) {
+    if (Object.keys(values).some((key) => key !== "queue")) {
+      throw new TypeError(
+        `${label}: set queue, or the REST API options, not both.`
+      );
+    }
+    const binding = bindingOf(label, "queue", values.queue);
+    sendBatch = (envelopes, delay) => binding().sendBatch(
+      envelopes.map((body) => ({
+        body,
+        contentType: "json",
+        ...delay === void 0 ? {} : { delaySeconds: delay }
+      }))
+    );
+  } else {
+    const api = apiOf(label, values);
+    sendBatch = (envelopes, delay) => api("/batch", {
+      messages: envelopes.map((body) => ({
+        body,
+        content_type: "json",
+        ...delay === void 0 ? {} : { delay_seconds: delay }
+      }))
+    });
+  }
+  return {
+    kind: "cloudflare-queues",
+    send: async (envelopes, { delay }) => {
+      if (delay !== void 0 && delay > MAX_DELAY_SECONDS) {
+        throw new RangeError(
+          `Cloudflare Queues accepts delays of at most ${MAX_DELAY_SECONDS} seconds, got ${delay}.`
+        );
+      }
+      const { batches, failed } = batchesOf(envelopes);
+      for (const batch of batches) {
+        try {
+          await sendBatch(batch.envelopes, delay);
+        } catch (error) {
+          for (const { id } of batch.envelopes) failed.push({ id, error });
+        }
+      }
+      if (failed.length > 0) throw new PartialSendError(failed);
+    }
+  };
+};
+var delayOf = (retryDelay, attempt) => retryDelay === void 0 ? void 0 : Math.min(MAX_DELAY_SECONDS, Math.max(0, Math.round(retryDelay(attempt))));
+var createCloudflareQueueHandler = (worker, options = {}) => {
+  const label = "createCloudflareQueueHandler()";
+  if (typeof worker?.handle !== "function") {
+    throw new TypeError(
+      `${label}: expected a worker created by createWorker().`
+    );
+  }
+  const values = checkOptions(label, options, ["deadLetterQueue", "retryDelay"]);
+  checkFunction(label, "retryDelay", values.retryDelay);
+  const retryDelay = values.retryDelay;
+  const deadLetterQueue = values.deadLetterQueue === void 0 ? void 0 : bindingOf(label, "deadLetterQueue", values.deadLetterQueue);
+  const settle = async (message, result) => {
+    if (result.status === "success") return message.ack();
+    if (result.status === "dead" && deadLetterQueue) {
+      try {
+        await deadLetterQueue().sendBatch([
+          { body: message.body, contentType: "json" }
+        ]);
+        return message.ack();
+      } catch {
+      }
+    }
+    const delaySeconds = delayOf(retryDelay, message.attempts);
+    message.retry(delaySeconds === void 0 ? void 0 : { delaySeconds });
+  };
+  return async (batch) => {
+    await Promise.all(
+      (batch?.messages ?? []).map(async (message) => {
+        const result = await worker.handle(message.body, {
+          attempt: message.attempts
+        });
+        await settle(message, result);
+      })
+    );
+  };
+};
+var decodePulledBody = (body) => {
+  if (typeof body !== "string") return body;
+  try {
+    const bytes = Uint8Array.from(atob(body), (char) => char.charCodeAt(0));
+    return new TextDecoder().decode(bytes);
+  } catch {
+    return body;
+  }
+};
+var sleep = (ms, signal) => new Promise((resolve) => {
+  const timer = setTimeout(done, ms);
+  function done() {
+    clearTimeout(timer);
+    signal.removeEventListener("abort", done);
+    resolve();
+  }
+  signal.addEventListener("abort", done, { once: true });
+});
+var createCloudflarePullSource = (options) => {
+  const label = "createCloudflarePullSource()";
+  const values = checkOptions(label, options, [
+    "accountId",
+    "queueId",
+    "apiToken",
+    "baseUrl",
+    "fetch",
+    "batchSize",
+    "visibilityTimeoutMs",
+    "pollInterval",
+    "retryDelay",
+    "deadLetterQueueId"
+  ]);
+  const api = apiOf(label, values);
+  const batchSize = checkInteger(label, "batchSize", values.batchSize, 1, MAX_PULL_BATCH) ?? 10;
+  const visibilityTimeoutMs = checkInteger(
+    label,
+    "visibilityTimeoutMs",
+    values.visibilityTimeoutMs,
+    1,
+    MAX_VISIBILITY_MS
+  ) ?? 3e4;
+  const pollInterval = checkInteger(label, "pollInterval", values.pollInterval, 0, 36e5) ?? 1e3;
+  checkFunction(label, "retryDelay", values.retryDelay);
+  const retryDelay = values.retryDelay;
+  const deadLetterQueueId = values.deadLetterQueueId === void 0 ? void 0 : checkString(label, "deadLetterQueueId", values.deadLetterQueueId);
+  return {
+    kind: "cloudflare-queues",
+    consume: async (worker, { signal, logger }) => {
+      let errorDelay = 0;
+      while (!signal.aborted) {
+        let messages;
+        try {
+          const result = await api("/pull", {
+            batch_size: batchSize,
+            visibility_timeout_ms: visibilityTimeoutMs
+          });
+          messages = result?.messages ?? [];
+          errorDelay = 0;
+        } catch (error) {
+          errorDelay = Math.min(3e4, Math.max(1e3, errorDelay * 2));
+          logger.error(
+            { error: describe(error), retryInMs: errorDelay },
+            "Cannot pull Cloudflare Queues messages"
+          );
+          await sleep(errorDelay, signal);
+          continue;
+        }
+        if (messages.length === 0) {
+          await sleep(pollInterval, signal);
+          continue;
+        }
+        const acks = [];
+        const retries = [];
+        await Promise.all(
+          messages.map(async (message) => {
+            const leaseId = String(message.lease_id);
+            const attempt = Number(message.attempts) || 1;
+            const body = decodePulledBody(message.body);
+            const result = await worker.handle(body, { attempt });
+            if (result.status === "success") {
+              acks.push({ lease_id: leaseId });
+              return;
+            }
+            if (result.status === "dead" && deadLetterQueueId) {
+              try {
+                const envelope = typeof body === "string" ? JSON.parse(body) : body;
+                await api(
+                  "/batch",
+                  { messages: [{ body: envelope, content_type: "json" }] },
+                  deadLetterQueueId
+                );
+                acks.push({ lease_id: leaseId });
+                return;
+              } catch (error) {
+                logger.error(
+                  { deadLetterQueueId, error: describe(error) },
+                  "Cannot copy the message to the dead-letter queue"
+                );
+              }
+            }
+            const delay = delayOf(retryDelay, attempt);
+            retries.push({
+              lease_id: leaseId,
+              ...delay === void 0 ? {} : { delay_seconds: delay }
+            });
+          })
+        );
+        try {
+          await api("/ack", { acks, retries });
+        } catch (error) {
+          logger.error(
+            { error: describe(error) },
+            "Cannot acknowledge Cloudflare Queues messages: they will be delivered again"
+          );
+        }
+      }
+    }
+  };
+};
+export {
+  createCloudflarePullSource,
+  createCloudflareQueueHandler,
+  createCloudflareQueueTransport,
+  decodePulledBody
+};
+//# sourceMappingURL=cloudflare-queues.js.map

package/dist/cloudflare-queues.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transports/cloudflare-queues.ts"],"sourcesContent":["import type { Envelope } from '../envelope.js'\nimport { PartialSendError } from '../errors.js'\nimport type { Source, Transport } from '../transport.js'\nimport type { HandleResult, Worker } from '../worker.js'\n\n/** Producer binding of a queue (`env.EVENTS_QUEUE` in a Worker). */\nexport interface CloudflareQueueBinding {\n  sendBatch(\n    messages: Iterable<{\n      body: unknown\n      contentType?: 'json'\n      delaySeconds?: number\n    }>\n  ): Promise<unknown>\n}\n\n/** A message received by the `queue()` handler of a Worker. */\nexport interface CloudflareQueueMessage {\n  readonly id: string\n  readonly body: unknown\n  /** Attempt number, from 1. */\n  readonly attempts: number\n  ack(): void\n  retry(options?: { delaySeconds?: number }): void\n}\n\n/** The batch received by the `queue()` handler of a Worker. */\nexport interface CloudflareMessageBatch {\n  readonly queue: string\n  readonly messages: readonly CloudflareQueueMessage[]\n}\n\n/** REST API access, to use a queue from outside Cloudflare Workers. */\nexport interface CloudflareApiOptions {\n  accountId: string\n  /** Queue ID (not its name). */\n  queueId: string\n  /** API token with Queues permissions (read and write to pull). */\n  apiToken: string\n  /** Base URL of the API. Defaults to `https://api.cloudflare.com/client/v4`. */\n  baseUrl?: string | undefined\n  /** `fetch` implementation. Defaults to the global `fetch`. */\n  fetch?: typeof fetch | undefined\n}\n\n/** Options of `createCloudflareQueueTransport()`. */\nexport type CloudflareQueueTransportOptions =\n  | {\n      /**\n       * Producer binding of the queue, or a function returning it (when the\n       * bus is created before the `env` of the Worker is available).\n       */\n      queue: CloudflareQueueBinding | (() => CloudflareQueueBinding)\n    }\n  | CloudflareApiOptions\n\n/** Options of `createCloudflareQueueHandler()`. */\nexport interface CloudflareQueueHandlerOptions {\n  /**\n   * Producer binding of the dead-letter queue: messages that can never be\n   * handled are sent there at once, instead of failing until `max_retries`.\n   */\n  deadLetterQueue?:\n    CloudflareQueueBinding | (() => CloudflareQueueBinding) | undefined\n  /** Delay before a retry, in seconds, given the attempt number. */\n  retryDelay?: ((attempt: number) => number) | undefined\n}\n\n/** Options of `createCloudflarePullSource()`. */\nexport interface CloudflarePullSourceOptions extends CloudflareApiOptions {\n  /** Messages per pull (1 to 100). Defaults to 10. */\n  batchSize?: number | undefined\n  /**\n   * Lease of the pulled messages, in milliseconds (up to 12 hours): longer\n   * than your slowest listener, since it cannot be extended. Defaults to\n   * 30 seconds.\n   */\n  visibilityTimeoutMs?: number | undefined\n  /** Wait before pulling again an empty queue, in milliseconds. Defaults to 1 second. */\n  pollInterval?: number | undefined\n  /** Delay before a retry, in seconds, given the attempt number. */\n  retryDelay?: ((attempt: number) => number) | undefined\n  /**\n   * Queue ID of the dead-letter queue: messages that can never be handled\n   * are pushed there at once, instead of failing until `max_retries`.\n   */\n  deadLetterQueueId?: string | undefined\n}\n\n// Limits of Cloudflare Queues (1 KB = 1000 bytes). Messages also carry\n// about 100 bytes of internal metadata.\nconst MAX_MESSAGE_BYTES = 128_000 - 100\nconst MAX_BATCH_MESSAGES = 100\nconst MAX_BATCH_BYTES = 256_000\nconst MAX_DELAY_SECONDS = 86_400\nconst MAX_PULL_BATCH = 100\nconst MAX_VISIBILITY_MS = 43_200_000\nconst DEFAULT_BASE_URL = 'https://api.cloudflare.com/client/v4'\n\nconst encoder = new TextEncoder()\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nconst checkOptions = (\n  label: string,\n  options: unknown,\n  allowed: readonly string[]\n): Record<string, unknown> => {\n  if (!isRecord(options)) {\n    throw new TypeError(`${label}: expected an object of options.`)\n  }\n  for (const key of Object.keys(options)) {\n    if (!allowed.includes(key)) {\n      throw new TypeError(`${label}: unknown option \"${key}\".`)\n    }\n  }\n  return options\n}\n\nconst checkString = (label: string, key: string, value: unknown) => {\n  if (typeof value !== 'string' || value === '') {\n    throw new TypeError(`${label}: ${key} must be a non-empty string.`)\n  }\n  return value\n}\n\nconst checkInteger = (\n  label: string,\n  key: string,\n  value: unknown,\n  min: number,\n  max: number\n) => {\n  if (\n    value !== undefined &&\n    (!Number.isInteger(value) ||\n      (value as number) < min ||\n      (value as number) > max)\n  ) {\n    throw new TypeError(\n      `${label}: ${key} must be an integer from ${min} to ${max}.`\n    )\n  }\n  return value as number | undefined\n}\n\nconst checkFunction = (label: string, key: string, value: unknown) => {\n  if (value !== undefined && typeof value !== 'function') {\n    throw new TypeError(`${label}: ${key} must be a function.`)\n  }\n}\n\n/** A binding, or the function returning it. */\nconst bindingOf = (label: string, key: string, value: unknown) => {\n  if (\n    typeof value !== 'function' &&\n    typeof (value as CloudflareQueueBinding | null)?.sendBatch !== 'function'\n  ) {\n    throw new TypeError(\n      `${label}: ${key} must be a queue binding, or a function returning it.`\n    )\n  }\n  return () =>\n    typeof value === 'function'\n      ? (value as () => CloudflareQueueBinding)()\n      : (value as CloudflareQueueBinding)\n}\n\nconst describe = (error: unknown) =>\n  error instanceof Error ? error.message : String(error)\n\n/** Client of the REST API of a queue. */\nconst apiOf = (label: string, values: Record<string, unknown>) => {\n  const accountId = checkString(label, 'accountId', values.accountId)\n  const queueId = checkString(label, 'queueId', values.queueId)\n  const apiToken = checkString(label, 'apiToken', values.apiToken)\n  const { baseUrl = DEFAULT_BASE_URL, fetch: fetchFn = globalThis.fetch } =\n    values\n  if (typeof baseUrl !== 'string' || !/^https?:\\/\\/[^/]/.test(baseUrl)) {\n    throw new TypeError(`${label}: baseUrl must be an http(s) URL.`)\n  }\n  if (typeof fetchFn !== 'function') {\n    throw new TypeError(`${label}: fetch must be a function.`)\n  }\n  const base = baseUrl.replace(/\\/+$/, '')\n\n  return async (path: string, body: unknown, queue = queueId) => {\n    const response = await (fetchFn as typeof fetch)(\n      `${base}/accounts/${encodeURIComponent(accountId)}/queues/${encodeURIComponent(queue)}/messages${path}`,\n      {\n        method: 'POST',\n        headers: {\n          authorization: `Bearer ${apiToken}`,\n          'content-type': 'application/json',\n        },\n        body: JSON.stringify(body),\n      }\n    )\n    let result: {\n      success?: unknown\n      errors?: { code?: unknown; message?: unknown }[]\n      result?: unknown\n    } = {}\n    try {\n      result = (await response.json()) as typeof result\n    } catch {\n      // Not JSON: reported with the status below.\n    }\n    if (!response.ok || result.success === false) {\n      const errors = (Array.isArray(result.errors) ? result.errors : [])\n        .map(({ code, message }) => `${code}: ${message}`)\n        .join('; ')\n      throw new Error(\n        `Cloudflare Queues API: ${response.status} ${errors || response.statusText}`.trim()\n      )\n    }\n    return result.result\n  }\n}\n\n/** Batches within the limits of Cloudflare Queues; oversized ones fail. */\nconst batchesOf = (envelopes: readonly Envelope[]) => {\n  const failed: { id: string; error: unknown }[] = []\n  const batches: { envelopes: Envelope[]; size: number }[] = []\n  for (const envelope of envelopes) {\n    const size = encoder.encode(JSON.stringify(envelope)).byteLength\n    if (size > MAX_MESSAGE_BYTES) {\n      failed.push({\n        id: envelope.id,\n        error: new RangeError(\n          `Cloudflare Queues accepts messages of at most ${MAX_MESSAGE_BYTES} bytes (128 KB with its metadata), got ${size}.`\n        ),\n      })\n      continue\n    }\n    const last = batches.at(-1)\n    if (\n      last &&\n      last.envelopes.length < MAX_BATCH_MESSAGES &&\n      last.size + size <= MAX_BATCH_BYTES\n    ) {\n      last.envelopes.push(envelope)\n      last.size += size\n    } else {\n      batches.push({ envelopes: [envelope], size })\n    }\n  }\n  return { batches, failed }\n}\n\n/**\n * Creates a transport that sends messages to a Cloudflare Queue: through\n * its producer binding inside a Worker, or through the REST API from\n * anywhere else (Node.js, Lambda…).\n *\n * ```ts\n * // In a Worker\n * import { env } from 'cloudflare:workers'\n * const transport = createCloudflareQueueTransport({ queue: () => env.EVENTS_QUEUE })\n *\n * // Elsewhere\n * const transport = createCloudflareQueueTransport({ accountId, queueId, apiToken })\n * ```\n */\nexport const createCloudflareQueueTransport = (\n  options: CloudflareQueueTransportOptions\n): Transport => {\n  const label = 'createCloudflareQueueTransport()'\n  const values = checkOptions(label, options, [\n    'queue',\n    'accountId',\n    'queueId',\n    'apiToken',\n    'baseUrl',\n    'fetch',\n  ])\n  let sendBatch: (\n    envelopes: Envelope[],\n    delay: number | undefined\n  ) => Promise<unknown>\n  if (values.queue !== undefined) {\n    if (Object.keys(values).some((key) => key !== 'queue')) {\n      throw new TypeError(\n        `${label}: set queue, or the REST API options, not both.`\n      )\n    }\n    const binding = bindingOf(label, 'queue', values.queue)\n    sendBatch = (envelopes, delay) =>\n      binding().sendBatch(\n        envelopes.map((body) => ({\n          body,\n          contentType: 'json' as const,\n          ...(delay === undefined ? {} : { delaySeconds: delay }),\n        }))\n      )\n  } else {\n    const api = apiOf(label, values)\n    sendBatch = (envelopes, delay) =>\n      api('/batch', {\n        messages: envelopes.map((body) => ({\n          body,\n          content_type: 'json',\n          ...(delay === undefined ? {} : { delay_seconds: delay }),\n        })),\n      })\n  }\n\n  return {\n    kind: 'cloudflare-queues',\n    send: async (envelopes, { delay }) => {\n      if (delay !== undefined && delay > MAX_DELAY_SECONDS) {\n        throw new RangeError(\n          `Cloudflare Queues accepts delays of at most ${MAX_DELAY_SECONDS} seconds, got ${delay}.`\n        )\n      }\n      const { batches, failed } = batchesOf(envelopes)\n      for (const batch of batches) {\n        try {\n          await sendBatch(batch.envelopes, delay)\n        } catch (error) {\n          for (const { id } of batch.envelopes) failed.push({ id, error })\n        }\n      }\n      if (failed.length > 0) throw new PartialSendError(failed)\n    },\n  }\n}\n\nconst delayOf = (\n  retryDelay: ((attempt: number) => number) | undefined,\n  attempt: number\n) =>\n  retryDelay === undefined\n    ? undefined\n    : Math.min(MAX_DELAY_SECONDS, Math.max(0, Math.round(retryDelay(attempt))))\n\n/**\n * Creates the `queue()` handler of a Worker consuming the queue. Each\n * message is acknowledged or retried on its own: a failure does not retry\n * the whole batch. Configure `max_retries` and `dead_letter_queue` in the\n * consumer settings (Wrangler).\n *\n * ```ts\n * export default {\n *   queue: createCloudflareQueueHandler(createWorker({ listeners })),\n * }\n * ```\n */\nexport const createCloudflareQueueHandler = (\n  worker: Worker,\n  options: CloudflareQueueHandlerOptions = {}\n) => {\n  const label = 'createCloudflareQueueHandler()'\n  if (typeof worker?.handle !== 'function') {\n    throw new TypeError(\n      `${label}: expected a worker created by createWorker().`\n    )\n  }\n  const values = checkOptions(label, options, ['deadLetterQueue', 'retryDelay'])\n  checkFunction(label, 'retryDelay', values.retryDelay)\n  const retryDelay =\n    values.retryDelay as CloudflareQueueHandlerOptions['retryDelay']\n  const deadLetterQueue =\n    values.deadLetterQueue === undefined\n      ? undefined\n      : bindingOf(label, 'deadLetterQueue', values.deadLetterQueue)\n\n  const settle = async (\n    message: CloudflareQueueMessage,\n    result: HandleResult\n  ) => {\n    if (result.status === 'success') return message.ack()\n    if (result.status === 'dead' && deadLetterQueue) {\n      try {\n        await deadLetterQueue().sendBatch([\n          { body: message.body, contentType: 'json' },\n        ])\n        return message.ack()\n      } catch {\n        // Retried: it reaches the dead-letter queue after max_retries.\n      }\n    }\n    const delaySeconds = delayOf(retryDelay, message.attempts)\n    message.retry(delaySeconds === undefined ? undefined : { delaySeconds })\n  }\n\n  return async (batch: CloudflareMessageBatch): Promise<void> => {\n    await Promise.all(\n      (batch?.messages ?? []).map(async (message) => {\n        const result = await worker.handle(message.body, {\n          attempt: message.attempts,\n        })\n        await settle(message, result)\n      })\n    )\n  }\n}\n\ninterface PulledMessage {\n  body?: unknown\n  attempts?: unknown\n  lease_id?: unknown\n  metadata?: unknown\n}\n\n/**\n * Body of a pulled message: JSON messages may come base64-encoded (RFC\n * 4648), as the documentation says, or as is, as its examples show.\n */\nexport const decodePulledBody = (body: unknown) => {\n  // Plain JSON is not base64 (\"{\" is not a base64 character): atob()\n  // fails, and the body is kept as is.\n  if (typeof body !== 'string') return body\n  try {\n    const bytes = Uint8Array.from(atob(body), (char) => char.charCodeAt(0))\n    return new TextDecoder().decode(bytes)\n  } catch {\n    return body\n  }\n}\n\nconst sleep = (ms: number, signal: AbortSignal) =>\n  new Promise<void>((resolve) => {\n    const timer = setTimeout(done, ms)\n    function done() {\n      clearTimeout(timer)\n      signal.removeEventListener('abort', done)\n      resolve()\n    }\n    signal.addEventListener('abort', done, { once: true })\n  })\n\n/**\n * Creates a source that pulls the queue over HTTP, for `startWorker()` and\n * `dotpress-events work`: a worker outside Cloudflare, or your machine.\n * Enable an HTTP pull consumer on the queue first\n * (`wrangler queues consumer http add <queue>`).\n */\nexport const createCloudflarePullSource = (\n  options: CloudflarePullSourceOptions\n): Source => {\n  const label = 'createCloudflarePullSource()'\n  const values = checkOptions(label, options, [\n    'accountId',\n    'queueId',\n    'apiToken',\n    'baseUrl',\n    'fetch',\n    'batchSize',\n    'visibilityTimeoutMs',\n    'pollInterval',\n    'retryDelay',\n    'deadLetterQueueId',\n  ])\n  const api = apiOf(label, values)\n  const batchSize =\n    checkInteger(label, 'batchSize', values.batchSize, 1, MAX_PULL_BATCH) ?? 10\n  const visibilityTimeoutMs =\n    checkInteger(\n      label,\n      'visibilityTimeoutMs',\n      values.visibilityTimeoutMs,\n      1,\n      MAX_VISIBILITY_MS\n    ) ?? 30_000\n  const pollInterval =\n    checkInteger(label, 'pollInterval', values.pollInterval, 0, 3_600_000) ??\n    1000\n  checkFunction(label, 'retryDelay', values.retryDelay)\n  const retryDelay =\n    values.retryDelay as CloudflarePullSourceOptions['retryDelay']\n  const deadLetterQueueId =\n    values.deadLetterQueueId === undefined\n      ? undefined\n      : checkString(label, 'deadLetterQueueId', values.deadLetterQueueId)\n\n  return {\n    kind: 'cloudflare-queues',\n    consume: async (worker, { signal, logger }) => {\n      let errorDelay = 0\n      while (!signal.aborted) {\n        let messages: PulledMessage[]\n        try {\n          const result = (await api('/pull', {\n            batch_size: batchSize,\n            visibility_timeout_ms: visibilityTimeoutMs,\n          })) as { messages?: PulledMessage[] } | undefined\n          messages = result?.messages ?? []\n          errorDelay = 0\n        } catch (error) {\n          errorDelay = Math.min(30_000, Math.max(1000, errorDelay * 2))\n          logger.error(\n            { error: describe(error), retryInMs: errorDelay },\n            'Cannot pull Cloudflare Queues messages'\n          )\n          await sleep(errorDelay, signal)\n          continue\n        }\n        if (messages.length === 0) {\n          await sleep(pollInterval, signal)\n          continue\n        }\n\n        const acks: { lease_id: string }[] = []\n        const retries: { lease_id: string; delay_seconds?: number }[] = []\n        await Promise.all(\n          messages.map(async (message) => {\n            const leaseId = String(message.lease_id)\n            const attempt = Number(message.attempts) || 1\n            const body = decodePulledBody(message.body)\n            const result = await worker.handle(body, { attempt })\n            if (result.status === 'success') {\n              acks.push({ lease_id: leaseId })\n              return\n            }\n            if (result.status === 'dead' && deadLetterQueueId) {\n              try {\n                const envelope =\n                  typeof body === 'string'\n                    ? (JSON.parse(body) as unknown)\n                    : body\n                await api(\n                  '/batch',\n                  { messages: [{ body: envelope, content_type: 'json' }] },\n                  deadLetterQueueId\n                )\n                acks.push({ lease_id: leaseId })\n                return\n              } catch (error) {\n                logger.error(\n                  { deadLetterQueueId, error: describe(error) },\n                  'Cannot copy the message to the dead-letter queue'\n                )\n              }\n            }\n            const delay = delayOf(retryDelay, attempt)\n            retries.push({\n              lease_id: leaseId,\n              ...(delay === undefined ? {} : { delay_seconds: delay }),\n            })\n          })\n        )\n        try {\n          await api('/ack', { acks, retries })\n        } catch (error) {\n          logger.error(\n            { error: describe(error) },\n            'Cannot acknowledge Cloudflare Queues messages: they will be delivered again'\n          )\n        }\n      }\n    },\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/google-pubsub.d.ts

@@ -0,0 +1,111 @@
+import { PubSub } from '@google-cloud/pubsub';
+import { EventsLogger, Source, Worker, Transport } from './index.js';
+import 'zod';
+
+/**
+ * OAuth access token of the publisher, or `false` without authentication
+ * (the Pub/Sub emulator). Defaults to Application Default Credentials,
+ * through `google-auth-library`.
+ */
+type AccessTokenOption = (() => Promise<string>) | false;
+/** Options to publish to a topic over the REST API. */
+interface PubSubPublishOptions {
+    /** Full topic name: `projects/{project}/topics/{topic}`. */
+    topic: string;
+    getAccessToken?: AccessTokenOption | undefined;
+    /** Base URL of the API. Defaults to `https://pubsub.googleapis.com`. */
+    baseUrl?: string | undefined;
+    /** `fetch` implementation. Defaults to the global `fetch`. */
+    fetch?: typeof fetch | undefined;
+}
+/** Options of `createPubSubPushHandler()`. */
+interface PubSubPushHandlerOptions {
+    /**
+     * Checks the OIDC token of push requests (`Authorization: Bearer`).
+     * Defaults to true; set `false` only behind a proxy that checks it.
+     */
+    verifyToken?: boolean | undefined;
+    /** Audience of the token, as configured on the push subscription. */
+    audience?: string | undefined;
+    /** Expected service account of the push subscription (`email` claim). */
+    serviceAccountEmail?: string | undefined;
+    /** Keys of the tokens. Defaults to the Google certificates. */
+    certsUrl?: string | undefined;
+    /**
+     * Topic where messages that can never be handled are published at once,
+     * instead of failing until `maxDeliveryAttempts`.
+     */
+    deadLetter?: Omit<PubSubPublishOptions, 'fetch'> | undefined;
+    /** `fetch` implementation, for the dead-letter topic. */
+    fetch?: typeof fetch | undefined;
+    logger?: EventsLogger | undefined;
+}
+/** Push endpoint of a subscription. */
+interface PubSubPushHandler {
+    /** Handles a push request (Web `Request`), and returns the response. */
+    fetch(request: Request): Promise<Response>;
+    /**
+     * Handles a push body (parsed JSON) with its `Authorization` header, for
+     * frameworks without Web requests. Returns the HTTP status to answer.
+     */
+    handle(body: unknown, authorization: string | undefined): Promise<number>;
+}
+/** Options of `createPubSubPullSource()`. */
+interface PubSubPullSourceOptions {
+    /** Full subscription name: `projects/{project}/subscriptions/{name}`. */
+    subscription: string;
+    /** Existing client. Defaults to a client created with `clientConfig`. */
+    client?: PubSub | undefined;
+    /** Options of the created client (`projectId`, `credentials`…). */
+    clientConfig?: ConstructorParameters<typeof PubSub>[0] | undefined;
+    /** Messages handled at the same time. Defaults to 10. */
+    maxMessages?: number | undefined;
+    /** Full name of the topic for messages that can never be handled. */
+    deadLetterTopic?: string | undefined;
+    /**
+     * On stop, how long to wait for the messages in progress, in
+     * milliseconds. Defaults to 30 seconds.
+     */
+    closeTimeout?: number | undefined;
+}
+/**
+ * Creates a transport that publishes messages to a Google Cloud Pub/Sub
+ * topic, over the REST API with `fetch`: it also runs outside Node.js.
+ * Pub/Sub has no delayed delivery: `delay` is refused.
+ *
+ * ```ts
+ * const transport = createPubSubTransport({ topic: 'projects/my-project/topics/events' })
+ * ```
+ */
+declare const createPubSubTransport: (options: PubSubPublishOptions) => Transport;
+/**
+ * Creates the endpoint of a push subscription: Pub/Sub POSTs each message
+ * to it, and an answer other than 2xx makes it deliver the message again.
+ * Mount `fetch` on any Web-standard runtime (Cloudflare Workers, Hono,
+ * Bun, Deno, Cloud Run), or call `handle` from another framework.
+ *
+ * ```ts
+ * const push = createPubSubPushHandler(worker, {
+ *   audience: 'https://api.example.com/pubsub',
+ *   serviceAccountEmail: 'pubsub-push@my-project.iam.gserviceaccount.com',
+ * })
+ * app.post('/pubsub', (c) => push.fetch(c.req.raw))
+ * ```
+ */
+declare const createPubSubPushHandler: (worker: Worker, options?: PubSubPushHandlerOptions) => PubSubPushHandler;
+/**
+ * Creates a source that pulls a subscription with the Pub/Sub client
+ * (`@google-cloud/pubsub`, peer dependency; Node.js), for `startWorker()`
+ * and `dotpress-events work`.
+ *
+ * ```ts
+ * export default {
+ *   worker: createWorker({ listeners }),
+ *   source: createPubSubPullSource({ subscription: 'projects/my-project/subscriptions/events' }),
+ * }
+ * ```
+ */
+declare const createPubSubPullSource: (options: PubSubPullSourceOptions) => Source;
+
+export { createPubSubPullSource, createPubSubPushHandler, createPubSubTransport };
+export type { AccessTokenOption, PubSubPublishOptions, PubSubPullSourceOptions, PubSubPushHandler, PubSubPushHandlerOptions };