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

package/dist/azure-service-bus.d.ts

@@ -0,0 +1,99 @@
+import { ServiceBusClient } from '@azure/service-bus';
+import { Transport, Worker, Source } from './index.js';
+import 'zod';
+
+/** Connection to a namespace: a client, or a connection string. */
+type ServiceBusConnection = {
+    /** A client created by you (Microsoft Entra ID credentials…). */
+    client: ServiceBusClient;
+    connectionString?: never;
+} | {
+    /** Connection string of the namespace, or of the queue. */
+    connectionString: string;
+    client?: never;
+};
+/** Options of `createServiceBusTransport()`. */
+type ServiceBusTransportOptions = ServiceBusConnection & {
+    /** Name of the queue. */
+    queue: string;
+};
+/** Options of `createServiceBusSource()`. */
+type ServiceBusSourceOptions = ServiceBusConnection & {
+    /** Name of the queue. */
+    queue: string;
+    /** Messages handled at the same time. Defaults to 1. */
+    maxConcurrentCalls?: number | undefined;
+    /**
+     * How long the lock of a message in progress is renewed, in
+     * milliseconds. Defaults to 5 minutes (the default of the SDK).
+     */
+    maxAutoLockRenewalDurationInMs?: number | undefined;
+    /**
+     * On stop, how long to wait for the messages in progress, in
+     * milliseconds. Defaults to 30 seconds.
+     */
+    closeTimeout?: number | undefined;
+};
+/** Options of `createServiceBusFunctionHandler()`. */
+interface ServiceBusFunctionHandlerOptions {
+    /**
+     * Queue where messages that can never be handled are sent at once,
+     * instead of failing until `maxDeliveryCount`.
+     */
+    deadLetter?: ServiceBusTransportOptions | undefined;
+}
+/** Service Bus transport: close it to close the client it created. */
+interface ServiceBusTransport extends Transport {
+    /** Closes the sender, and the client if the transport created it. */
+    close(): Promise<void>;
+}
+/** Invocation context of Azure Functions (the fields used here). */
+interface ServiceBusInvocationContext {
+    triggerMetadata?: Record<string, unknown> | undefined;
+}
+/**
+ * Creates a transport that sends messages to an Azure Service Bus queue
+ * (`@azure/service-bus`, peer dependency; Node.js). The message id is the
+ * id of the envelope: with duplicate detection on the queue, emitting again
+ * is ignored.
+ *
+ * ```ts
+ * const transport = createServiceBusTransport({
+ *   connectionString: process.env.SERVICE_BUS_CONNECTION!,
+ *   queue: 'events',
+ * })
+ * ```
+ */
+declare const createServiceBusTransport: (options: ServiceBusTransportOptions) => ServiceBusTransport;
+/**
+ * Creates a source that receives the messages of a queue, for
+ * `startWorker()` and `dotpress-events work` (Node.js). Handled messages
+ * are completed, failed ones abandoned (delivered again until the
+ * `maxDeliveryCount` of the queue), and messages that can never be handled
+ * moved to the dead-letter queue at once.
+ *
+ * ```ts
+ * export default {
+ *   worker: createWorker({ listeners, maxAttempts: 10 }),
+ *   source: createServiceBusSource({ connectionString, queue: 'events' }),
+ * }
+ * ```
+ */
+declare const createServiceBusSource: (options: ServiceBusSourceOptions) => Source;
+/**
+ * Creates the handler of an Azure Functions Service Bus trigger (one
+ * message per invocation). A failure throws, so that the message is
+ * delivered again until the `maxDeliveryCount` of the queue.
+ *
+ * ```ts
+ * app.serviceBusQueue('events', {
+ *   connection: 'SERVICE_BUS_CONNECTION',
+ *   queueName: 'events',
+ *   handler: createServiceBusFunctionHandler(createWorker({ listeners, maxAttempts: 10 })),
+ * })
+ * ```
+ */
+declare const createServiceBusFunctionHandler: (worker: Worker, options?: ServiceBusFunctionHandlerOptions) => ((message: unknown, context?: ServiceBusInvocationContext) => Promise<void>);
+
+export { createServiceBusFunctionHandler, createServiceBusSource, createServiceBusTransport };
+export type { ServiceBusConnection, ServiceBusFunctionHandlerOptions, ServiceBusInvocationContext, ServiceBusSourceOptions, ServiceBusTransport, ServiceBusTransportOptions };

package/dist/azure-service-bus.js

@@ -0,0 +1,320 @@
+import {
+  PartialSendError
+} from "./chunk-NCQ4ZTNB.js";
+
+// src/transports/azure-service-bus.ts
+var MAX_DESCRIPTION = 1024;
+var MAX_BATCH_BYTES = 1048576;
+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 describe = (error) => error instanceof Error ? error.message : String(error);
+var connectionOf = (label, values) => {
+  const { client, connectionString, queue } = values;
+  if (client === void 0 === (connectionString === void 0)) {
+    throw new TypeError(`${label}: set client or connectionString.`);
+  }
+  if (client !== void 0 && typeof client?.createSender !== "function") {
+    throw new TypeError(`${label}: client must be a ServiceBusClient.`);
+  }
+  if (connectionString !== void 0 && (typeof connectionString !== "string" || connectionString === "")) {
+    throw new TypeError(
+      `${label}: connectionString must be a non-empty string.`
+    );
+  }
+  if (typeof queue !== "string" || queue === "") {
+    throw new TypeError(`${label}: queue must be a non-empty string.`);
+  }
+  let created;
+  return {
+    queue,
+    owned: client === void 0,
+    client: () => client !== void 0 ? Promise.resolve(client) : created ??= import("@azure/service-bus").then(
+      ({ ServiceBusClient: Client }) => new Client(connectionString),
+      (error) => {
+        created = void 0;
+        throw new Error(
+          "Install @azure/service-bus to use Azure Service Bus.",
+          { cause: error }
+        );
+      }
+    ),
+    /** Closes the client, if created here. */
+    close: async () => {
+      await (await created)?.close();
+    }
+  };
+};
+var senderOf = (label, values) => {
+  const connection = connectionOf(label, values);
+  let sender;
+  const senderOnce = () => sender ??= connection.client().then((client) => client.createSender(connection.queue)).catch((error) => {
+    sender = void 0;
+    throw error;
+  });
+  const send = async (messages) => {
+    const failed = [];
+    const attempt = async (ids2, sending) => {
+      try {
+        await sending();
+      } catch (error) {
+        for (const id of ids2) failed.push({ id, error });
+      }
+    };
+    const output = await senderOnce();
+    let batch = await output.createMessageBatch();
+    const maxMessageSize = batch.maxSizeInBytes;
+    const options = maxMessageSize > MAX_BATCH_BYTES ? { maxSizeInBytes: MAX_BATCH_BYTES } : void 0;
+    if (options) batch = await output.createMessageBatch(options);
+    let ids = [];
+    for (const { id, message } of messages) {
+      if (batch.tryAddMessage(message)) {
+        ids.push(id);
+        continue;
+      }
+      if (ids.length > 0) {
+        const full = batch;
+        await attempt(ids, () => output.sendMessages(full));
+        batch = await output.createMessageBatch(options);
+        ids = [];
+        if (batch.tryAddMessage(message)) {
+          ids.push(id);
+          continue;
+        }
+      }
+      if (maxMessageSize > batch.maxSizeInBytes) {
+        await attempt([id], () => output.sendMessages(message));
+      } else {
+        failed.push({
+          id,
+          error: new RangeError(
+            `Service Bus accepts messages of at most ${maxMessageSize} bytes on this queue (256 KB in the Standard tier).`
+          )
+        });
+      }
+    }
+    if (ids.length > 0) {
+      const last = batch;
+      await attempt(ids, () => output.sendMessages(last));
+    }
+    return failed;
+  };
+  return {
+    send,
+    close: async () => {
+      await (await sender)?.close();
+      await connection.close();
+    }
+  };
+};
+var messageOf = (envelope, delay) => ({
+  body: envelope,
+  contentType: "application/json",
+  messageId: envelope.id,
+  subject: envelope.event,
+  applicationProperties: { event: envelope.event, listener: envelope.listener },
+  ...delay ? { scheduledEnqueueTimeUtc: new Date(Date.now() + delay * 1e3) } : {}
+});
+var createServiceBusTransport = (options) => {
+  const label = "createServiceBusTransport()";
+  const values = checkOptions(label, options, [
+    "client",
+    "connectionString",
+    "queue"
+  ]);
+  const sender = senderOf(label, values);
+  return {
+    kind: "azure-service-bus",
+    send: async (envelopes, { delay }) => {
+      const failed = await sender.send(
+        envelopes.map((envelope) => ({
+          id: envelope.id,
+          message: messageOf(envelope, delay)
+        }))
+      );
+      if (failed.length > 0) throw new PartialSendError(failed);
+    },
+    close: sender.close
+  };
+};
+var deadLetterProperties = (result) => ({
+  deadLetterReason: result.reason,
+  deadLetterErrorDescription: describe(result.error).slice(0, MAX_DESCRIPTION)
+});
+var createServiceBusSource = (options) => {
+  const label = "createServiceBusSource()";
+  const values = checkOptions(label, options, [
+    "client",
+    "connectionString",
+    "queue",
+    "maxConcurrentCalls",
+    "maxAutoLockRenewalDurationInMs",
+    "closeTimeout"
+  ]);
+  const connection = connectionOf(label, values);
+  const {
+    maxConcurrentCalls = 1,
+    maxAutoLockRenewalDurationInMs,
+    closeTimeout = 3e4
+  } = values;
+  if (!Number.isInteger(maxConcurrentCalls) || maxConcurrentCalls < 1) {
+    throw new TypeError(
+      `${label}: maxConcurrentCalls must be a positive integer.`
+    );
+  }
+  if (maxAutoLockRenewalDurationInMs !== void 0 && (!Number.isInteger(maxAutoLockRenewalDurationInMs) || maxAutoLockRenewalDurationInMs < 0)) {
+    throw new TypeError(
+      `${label}: maxAutoLockRenewalDurationInMs must be a non-negative integer (milliseconds).`
+    );
+  }
+  if (!Number.isInteger(closeTimeout) || closeTimeout < 0) {
+    throw new TypeError(
+      `${label}: closeTimeout must be a non-negative integer (milliseconds).`
+    );
+  }
+  return {
+    kind: "azure-service-bus",
+    consume: async (worker, { signal, logger }) => {
+      const client = await connection.client();
+      const receiver = client.createReceiver(connection.queue, {
+        receiveMode: "peekLock",
+        ...maxAutoLockRenewalDurationInMs === void 0 ? {} : {
+          maxAutoLockRenewalDurationInMs
+        }
+      });
+      const inProgress = /* @__PURE__ */ new Set();
+      const settle = async (message) => {
+        const result = await worker.handle(message.body, {
+          // The SDK counts the deliveries before this one.
+          attempt: (message.deliveryCount ?? 0) + 1
+        });
+        if (result.status === "success") {
+          await receiver.completeMessage(message);
+        } else if (result.status === "dead") {
+          await receiver.deadLetterMessage(
+            message,
+            deadLetterProperties(result)
+          );
+        } else {
+          await receiver.abandonMessage(message);
+        }
+      };
+      const subscription = receiver.subscribe(
+        {
+          processMessage: async (message) => {
+            const handling = settle(message);
+            inProgress.add(handling);
+            try {
+              await handling;
+            } finally {
+              inProgress.delete(handling);
+            }
+          },
+          processError: async ({ error, errorSource }) => {
+            logger.error(
+              {
+                queue: connection.queue,
+                source: errorSource,
+                error: error.message
+              },
+              "Service Bus receiver error"
+            );
+          }
+        },
+        {
+          autoCompleteMessages: false,
+          maxConcurrentCalls
+        }
+      );
+      await new Promise((resolve) => {
+        if (signal.aborted) resolve();
+        signal.addEventListener("abort", () => resolve(), { once: true });
+      });
+      let timer;
+      const stopped = await Promise.race([
+        (async () => {
+          await subscription.close();
+          await Promise.allSettled([...inProgress]);
+          return true;
+        })(),
+        new Promise((resolve) => {
+          timer = setTimeout(() => resolve(false), closeTimeout);
+        })
+      ]);
+      clearTimeout(timer);
+      if (!stopped) {
+        logger.warn(
+          { queue: connection.queue, closeTimeout },
+          "Service Bus receiver not closed in time: stopped without waiting"
+        );
+      }
+      await receiver.close().catch(() => void 0);
+      await connection.close().catch(() => void 0);
+    }
+  };
+};
+var createServiceBusFunctionHandler = (worker, options = {}) => {
+  const label = "createServiceBusFunctionHandler()";
+  if (typeof worker?.handle !== "function") {
+    throw new TypeError(
+      `${label}: expected a worker created by createWorker().`
+    );
+  }
+  const { deadLetter } = checkOptions(label, options, ["deadLetter"]);
+  const deadSender = deadLetter === void 0 ? void 0 : senderOf(
+    `${label}: deadLetter`,
+    checkOptions(`${label}: deadLetter`, deadLetter, [
+      "client",
+      "connectionString",
+      "queue"
+    ])
+  );
+  return async (message, context) => {
+    if (Array.isArray(message)) {
+      throw new TypeError(
+        `${label}: expected one message per invocation (cardinality "one").`
+      );
+    }
+    const deliveryCount = context?.triggerMetadata?.deliveryCount;
+    const result = await worker.handle(message, {
+      attempt: typeof deliveryCount === "number" ? deliveryCount : 1
+    });
+    if (result.status === "success") return;
+    if (result.status === "dead" && deadSender) {
+      const { deadLetterReason, deadLetterErrorDescription } = deadLetterProperties(result);
+      const failed = await deadSender.send([
+        {
+          id: "",
+          message: {
+            body: message,
+            contentType: "application/json",
+            applicationProperties: {
+              reason: deadLetterReason,
+              error: deadLetterErrorDescription
+            }
+          }
+        }
+      ]);
+      if (failed.length === 0) return;
+      throw new Error("Cannot send the message to the dead-letter queue.", {
+        cause: failed[0]?.error
+      });
+    }
+    throw result.error instanceof Error ? result.error : new Error(describe(result.error));
+  };
+};
+export {
+  createServiceBusFunctionHandler,
+  createServiceBusSource,
+  createServiceBusTransport
+};
+//# sourceMappingURL=azure-service-bus.js.map

package/dist/azure-service-bus.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transports/azure-service-bus.ts"],"sourcesContent":["import type {\n  ServiceBusClient,\n  ServiceBusMessage,\n  ServiceBusReceivedMessage,\n  ServiceBusSender,\n} from '@azure/service-bus'\nimport 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/** Connection to a namespace: a client, or a connection string. */\nexport type ServiceBusConnection =\n  | {\n      /** A client created by you (Microsoft Entra ID credentials…). */\n      client: ServiceBusClient\n      connectionString?: never\n    }\n  | {\n      /** Connection string of the namespace, or of the queue. */\n      connectionString: string\n      client?: never\n    }\n\n/** Options of `createServiceBusTransport()`. */\nexport type ServiceBusTransportOptions = ServiceBusConnection & {\n  /** Name of the queue. */\n  queue: string\n}\n\n/** Options of `createServiceBusSource()`. */\nexport type ServiceBusSourceOptions = ServiceBusConnection & {\n  /** Name of the queue. */\n  queue: string\n  /** Messages handled at the same time. Defaults to 1. */\n  maxConcurrentCalls?: number | undefined\n  /**\n   * How long the lock of a message in progress is renewed, in\n   * milliseconds. Defaults to 5 minutes (the default of the SDK).\n   */\n  maxAutoLockRenewalDurationInMs?: number | undefined\n  /**\n   * On stop, how long to wait for the messages in progress, in\n   * milliseconds. Defaults to 30 seconds.\n   */\n  closeTimeout?: number | undefined\n}\n\n/** Options of `createServiceBusFunctionHandler()`. */\nexport interface ServiceBusFunctionHandlerOptions {\n  /**\n   * Queue where messages that can never be handled are sent at once,\n   * instead of failing until `maxDeliveryCount`.\n   */\n  deadLetter?: ServiceBusTransportOptions | undefined\n}\n\n/** Service Bus transport: close it to close the client it created. */\nexport interface ServiceBusTransport extends Transport {\n  /** Closes the sender, and the client if the transport created it. */\n  close(): Promise<void>\n}\n\n/** Invocation context of Azure Functions (the fields used here). */\nexport interface ServiceBusInvocationContext {\n  triggerMetadata?: Record<string, unknown> | undefined\n}\n\n// Dead-letter descriptions are kept short: they are message properties.\nconst MAX_DESCRIPTION = 1024\n// Batches: 256 KB in the Standard tier, 1 MB in the Premium tier.\nconst MAX_BATCH_BYTES = 1_048_576\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 describe = (error: unknown) =>\n  error instanceof Error ? error.message : String(error)\n\n/** The client of the options, created on first use when not given. */\nconst connectionOf = (label: string, values: Record<string, unknown>) => {\n  const { client, connectionString, queue } = values\n  if ((client === undefined) === (connectionString === undefined)) {\n    throw new TypeError(`${label}: set client or connectionString.`)\n  }\n  if (\n    client !== undefined &&\n    typeof (client as ServiceBusClient | null)?.createSender !== 'function'\n  ) {\n    throw new TypeError(`${label}: client must be a ServiceBusClient.`)\n  }\n  if (\n    connectionString !== undefined &&\n    (typeof connectionString !== 'string' || connectionString === '')\n  ) {\n    throw new TypeError(\n      `${label}: connectionString must be a non-empty string.`\n    )\n  }\n  if (typeof queue !== 'string' || queue === '') {\n    throw new TypeError(`${label}: queue must be a non-empty string.`)\n  }\n\n  let created: Promise<ServiceBusClient> | undefined\n  return {\n    queue,\n    owned: client === undefined,\n    client: (): Promise<ServiceBusClient> =>\n      client !== undefined\n        ? Promise.resolve(client as ServiceBusClient)\n        : (created ??= import('@azure/service-bus').then(\n            ({ ServiceBusClient: Client }) =>\n              new Client(connectionString as string),\n            (error: unknown) => {\n              created = undefined\n              throw new Error(\n                'Install @azure/service-bus to use Azure Service Bus.',\n                { cause: error }\n              )\n            }\n          )),\n    /** Closes the client, if created here. */\n    close: async () => {\n      await (await created)?.close()\n    },\n  }\n}\n\n/** Sends envelopes in batches: a sender of the queue, created once. */\nconst senderOf = (label: string, values: Record<string, unknown>) => {\n  const connection = connectionOf(label, values)\n  let sender: Promise<ServiceBusSender> | undefined\n  const senderOnce = () =>\n    (sender ??= connection\n      .client()\n      .then((client) => client.createSender(connection.queue))\n      .catch((error: unknown) => {\n        sender = undefined\n        throw error\n      }))\n\n  const send = async (\n    messages: { id: string; message: ServiceBusMessage }[]\n  ) => {\n    const failed: { id: string; error: unknown }[] = []\n    const attempt = async (ids: string[], sending: () => Promise<void>) => {\n      try {\n        await sending()\n      } catch (error) {\n        for (const id of ids) failed.push({ id, error })\n      }\n    }\n    const output = await senderOnce()\n    let batch = await output.createMessageBatch()\n    // Largest message of the queue: Premium queues accept more than a batch.\n    const maxMessageSize = batch.maxSizeInBytes\n    const options =\n      maxMessageSize > MAX_BATCH_BYTES\n        ? { maxSizeInBytes: MAX_BATCH_BYTES }\n        : undefined\n    if (options) batch = await output.createMessageBatch(options)\n    let ids: string[] = []\n\n    for (const { id, message } of messages) {\n      if (batch.tryAddMessage(message)) {\n        ids.push(id)\n        continue\n      }\n      if (ids.length > 0) {\n        const full = batch\n        await attempt(ids, () => output.sendMessages(full))\n        batch = await output.createMessageBatch(options)\n        ids = []\n        if (batch.tryAddMessage(message)) {\n          ids.push(id)\n          continue\n        }\n      }\n      if (maxMessageSize > batch.maxSizeInBytes) {\n        // Larger than a batch: sent alone.\n        await attempt([id], () => output.sendMessages(message))\n      } else {\n        failed.push({\n          id,\n          error: new RangeError(\n            `Service Bus accepts messages of at most ${maxMessageSize} bytes on this queue (256 KB in the Standard tier).`\n          ),\n        })\n      }\n    }\n    if (ids.length > 0) {\n      const last = batch\n      await attempt(ids, () => output.sendMessages(last))\n    }\n    return failed\n  }\n\n  return {\n    send,\n    close: async () => {\n      await (await sender)?.close()\n      await connection.close()\n    },\n  }\n}\n\nconst messageOf = (\n  envelope: Envelope,\n  delay: number | undefined\n): ServiceBusMessage => ({\n  body: envelope,\n  contentType: 'application/json',\n  messageId: envelope.id,\n  subject: envelope.event,\n  applicationProperties: { event: envelope.event, listener: envelope.listener },\n  ...(delay\n    ? { scheduledEnqueueTimeUtc: new Date(Date.now() + delay * 1000) }\n    : {}),\n})\n\n/**\n * Creates a transport that sends messages to an Azure Service Bus queue\n * (`@azure/service-bus`, peer dependency; Node.js). The message id is the\n * id of the envelope: with duplicate detection on the queue, emitting again\n * is ignored.\n *\n * ```ts\n * const transport = createServiceBusTransport({\n *   connectionString: process.env.SERVICE_BUS_CONNECTION!,\n *   queue: 'events',\n * })\n * ```\n */\nexport const createServiceBusTransport = (\n  options: ServiceBusTransportOptions\n): ServiceBusTransport => {\n  const label = 'createServiceBusTransport()'\n  const values = checkOptions(label, options, [\n    'client',\n    'connectionString',\n    'queue',\n  ])\n  const sender = senderOf(label, values)\n\n  return {\n    kind: 'azure-service-bus',\n    send: async (envelopes, { delay }) => {\n      const failed = await sender.send(\n        envelopes.map((envelope) => ({\n          id: envelope.id,\n          message: messageOf(envelope, delay),\n        }))\n      )\n      if (failed.length > 0) throw new PartialSendError(failed)\n    },\n    close: sender.close,\n  }\n}\n\nconst deadLetterProperties = (result: HandleResult & { status: 'dead' }) => ({\n  deadLetterReason: result.reason,\n  deadLetterErrorDescription: describe(result.error).slice(0, MAX_DESCRIPTION),\n})\n\n/**\n * Creates a source that receives the messages of a queue, for\n * `startWorker()` and `dotpress-events work` (Node.js). Handled messages\n * are completed, failed ones abandoned (delivered again until the\n * `maxDeliveryCount` of the queue), and messages that can never be handled\n * moved to the dead-letter queue at once.\n *\n * ```ts\n * export default {\n *   worker: createWorker({ listeners, maxAttempts: 10 }),\n *   source: createServiceBusSource({ connectionString, queue: 'events' }),\n * }\n * ```\n */\nexport const createServiceBusSource = (\n  options: ServiceBusSourceOptions\n): Source => {\n  const label = 'createServiceBusSource()'\n  const values = checkOptions(label, options, [\n    'client',\n    'connectionString',\n    'queue',\n    'maxConcurrentCalls',\n    'maxAutoLockRenewalDurationInMs',\n    'closeTimeout',\n  ])\n  const connection = connectionOf(label, values)\n  const {\n    maxConcurrentCalls = 1,\n    maxAutoLockRenewalDurationInMs,\n    closeTimeout = 30_000,\n  } = values\n  if (\n    !Number.isInteger(maxConcurrentCalls) ||\n    (maxConcurrentCalls as number) < 1\n  ) {\n    throw new TypeError(\n      `${label}: maxConcurrentCalls must be a positive integer.`\n    )\n  }\n  if (\n    maxAutoLockRenewalDurationInMs !== undefined &&\n    (!Number.isInteger(maxAutoLockRenewalDurationInMs) ||\n      (maxAutoLockRenewalDurationInMs as number) < 0)\n  ) {\n    throw new TypeError(\n      `${label}: maxAutoLockRenewalDurationInMs must be a non-negative integer (milliseconds).`\n    )\n  }\n  if (!Number.isInteger(closeTimeout) || (closeTimeout as number) < 0) {\n    throw new TypeError(\n      `${label}: closeTimeout must be a non-negative integer (milliseconds).`\n    )\n  }\n\n  return {\n    kind: 'azure-service-bus',\n    consume: async (worker, { signal, logger }) => {\n      const client = await connection.client()\n      const receiver = client.createReceiver(connection.queue, {\n        receiveMode: 'peekLock',\n        ...(maxAutoLockRenewalDurationInMs === undefined\n          ? {}\n          : {\n              maxAutoLockRenewalDurationInMs:\n                maxAutoLockRenewalDurationInMs as number,\n            }),\n      })\n      const inProgress = new Set<Promise<void>>()\n\n      const settle = async (message: ServiceBusReceivedMessage) => {\n        const result = await worker.handle(message.body, {\n          // The SDK counts the deliveries before this one.\n          attempt: (message.deliveryCount ?? 0) + 1,\n        })\n        if (result.status === 'success') {\n          await receiver.completeMessage(message)\n        } else if (result.status === 'dead') {\n          await receiver.deadLetterMessage(\n            message,\n            deadLetterProperties(result)\n          )\n        } else {\n          await receiver.abandonMessage(message)\n        }\n      }\n\n      const subscription = receiver.subscribe(\n        {\n          processMessage: async (message) => {\n            const handling = settle(message)\n            inProgress.add(handling)\n            try {\n              await handling\n            } finally {\n              inProgress.delete(handling)\n            }\n          },\n          processError: async ({ error, errorSource }) => {\n            logger.error(\n              {\n                queue: connection.queue,\n                source: errorSource,\n                error: error.message,\n              },\n              'Service Bus receiver error'\n            )\n          },\n        },\n        {\n          autoCompleteMessages: false,\n          maxConcurrentCalls: maxConcurrentCalls as number,\n        }\n      )\n\n      await new Promise<void>((resolve) => {\n        if (signal.aborted) resolve()\n        signal.addEventListener('abort', () => resolve(), { once: true })\n      })\n      // Stop receiving, then let the messages in progress settle.\n      let timer: ReturnType<typeof setTimeout> | undefined\n      const stopped = await Promise.race([\n        (async () => {\n          await subscription.close()\n          await Promise.allSettled([...inProgress])\n          return true\n        })(),\n        new Promise<false>((resolve) => {\n          timer = setTimeout(() => resolve(false), closeTimeout as number)\n        }),\n      ])\n      clearTimeout(timer)\n      if (!stopped) {\n        logger.warn(\n          { queue: connection.queue, closeTimeout },\n          'Service Bus receiver not closed in time: stopped without waiting'\n        )\n      }\n      await receiver.close().catch(() => undefined)\n      await connection.close().catch(() => undefined)\n    },\n  }\n}\n\n/**\n * Creates the handler of an Azure Functions Service Bus trigger (one\n * message per invocation). A failure throws, so that the message is\n * delivered again until the `maxDeliveryCount` of the queue.\n *\n * ```ts\n * app.serviceBusQueue('events', {\n *   connection: 'SERVICE_BUS_CONNECTION',\n *   queueName: 'events',\n *   handler: createServiceBusFunctionHandler(createWorker({ listeners, maxAttempts: 10 })),\n * })\n * ```\n */\nexport const createServiceBusFunctionHandler = (\n  worker: Worker,\n  options: ServiceBusFunctionHandlerOptions = {}\n): ((\n  message: unknown,\n  context?: ServiceBusInvocationContext\n) => Promise<void>) => {\n  const label = 'createServiceBusFunctionHandler()'\n  if (typeof worker?.handle !== 'function') {\n    throw new TypeError(\n      `${label}: expected a worker created by createWorker().`\n    )\n  }\n  const { deadLetter } = checkOptions(label, options, ['deadLetter'])\n  const deadSender =\n    deadLetter === undefined\n      ? undefined\n      : senderOf(\n          `${label}: deadLetter`,\n          checkOptions(`${label}: deadLetter`, deadLetter, [\n            'client',\n            'connectionString',\n            'queue',\n          ])\n        )\n\n  return async (message, context) => {\n    if (Array.isArray(message)) {\n      throw new TypeError(\n        `${label}: expected one message per invocation (cardinality \"one\").`\n      )\n    }\n    const deliveryCount = context?.triggerMetadata?.deliveryCount\n    const result = await worker.handle(message, {\n      attempt: typeof deliveryCount === 'number' ? deliveryCount : 1,\n    })\n    if (result.status === 'success') return\n    if (result.status === 'dead' && deadSender) {\n      const { deadLetterReason, deadLetterErrorDescription } =\n        deadLetterProperties(result)\n      const failed = await deadSender.send([\n        {\n          id: '',\n          message: {\n            body: message,\n            contentType: 'application/json',\n            applicationProperties: {\n              reason: deadLetterReason,\n              error: deadLetterErrorDescription,\n            },\n          },\n        },\n      ])\n      if (failed.length === 0) return\n      throw new Error('Cannot send the message to the dead-letter queue.', {\n        cause: failed[0]?.error,\n      })\n    }\n    throw result.error instanceof Error\n      ? result.error\n      : new Error(describe(result.error))\n  }\n}\n"],"mappings":"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","names":["ids"]}

package/dist/bullmq.d.ts

@@ -0,0 +1,92 @@
+import { JobsOptions, ConnectionOptions, Job } from 'bullmq';
+import { Transport, Source, Worker, Envelope } from './index.js';
+import 'zod';
+
+/** A BullMQ queue, or any object with the same methods. */
+interface BullmqQueue {
+    addBulk(jobs: {
+        name: string;
+        data: unknown;
+        opts?: JobsOptions;
+    }[]): Promise<unknown>;
+    close(): Promise<void>;
+}
+/** Options of `createBullmqTransport()`. */
+type BullmqTransportOptions = {
+    /**
+     * Options of the jobs, merged with the defaults: 3 attempts, exponential
+     * backoff from 1 second, completed jobs removed, failed jobs kept.
+     */
+    jobOptions?: Omit<JobsOptions, 'jobId' | 'delay'> | undefined;
+} & ({
+    /** Name of the queue. */
+    name: string;
+    /** Redis connection: ioredis options or instance. */
+    connection: ConnectionOptions;
+    /** Prefix of the Redis keys (instead of the ioredis `keyPrefix`). */
+    prefix?: string | undefined;
+    queue?: never;
+} | {
+    /** Existing queue (another backend, shared connection…). */
+    queue: BullmqQueue;
+    name?: never;
+    connection?: never;
+    prefix?: never;
+});
+/** BullMQ transport: close it to release its Redis connection. */
+interface BullmqTransport extends Transport {
+    close(): Promise<void>;
+}
+/** Options of `createBullmqSource()`. */
+interface BullmqSourceOptions {
+    /** Name of the queue. */
+    name: string;
+    /** Redis connection: ioredis options or instance. */
+    connection: ConnectionOptions;
+    /** Prefix of the Redis keys, as in the transport. */
+    prefix?: string | undefined;
+    /** Messages handled at the same time. Defaults to 1. */
+    concurrency?: number | undefined;
+    /**
+     * On stop, how long to wait for the jobs in progress, in milliseconds,
+     * before stopping anyway (their jobs become stalled and are retried by
+     * another worker). Defaults to 30 seconds. Also bounds the stop when
+     * Redis is unreachable.
+     */
+    closeTimeout?: number | undefined;
+}
+declare const DEFAULT_JOB_OPTIONS: JobsOptions;
+/**
+ * Creates a transport that adds messages as jobs to a BullMQ queue
+ * (`bullmq`, peer dependency; Redis by default). The job name is the
+ * listener, its id the message id: emitting again adds no duplicate.
+ *
+ * ```ts
+ * const transport = createBullmqTransport({
+ *   name: 'events',
+ *   connection: { host: 'localhost', port: 6379 },
+ * })
+ * ```
+ */
+declare const createBullmqTransport: (options: BullmqTransportOptions) => BullmqTransport;
+/**
+ * Processor of BullMQ jobs: a failed listener throws (retried within the
+ * `attempts` of the job), a message that can never be handled throws an
+ * `UnrecoverableError` (failed at once).
+ */
+declare const processorOf: (worker: Worker) => (job: Pick<Job<Envelope>, "data" | "attemptsMade">) => Promise<void>;
+/**
+ * Creates a source that runs a BullMQ worker on the queue, for
+ * `startWorker()` and `dotpress-events work` (Node.js and Bun).
+ *
+ * ```ts
+ * export default {
+ *   worker: createWorker({ listeners, maxAttempts: 3 }),
+ *   source: createBullmqSource({ name: 'events', connection, concurrency: 5 }),
+ * }
+ * ```
+ */
+declare const createBullmqSource: (options: BullmqSourceOptions) => Source;
+
+export { DEFAULT_JOB_OPTIONS, createBullmqSource, createBullmqTransport, processorOf };
+export type { BullmqQueue, BullmqSourceOptions, BullmqTransport, BullmqTransportOptions };