abxbus 2.4.1

package/dist/cjs/logging.js

@@ -0,0 +1,216 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var logging_exports = {};
+__export(logging_exports, {
+  buildResultLine: () => buildResultLine,
+  buildTreeLine: () => buildTreeLine,
+  formatResultValue: () => formatResultValue,
+  formatTimestamp: () => formatTimestamp,
+  logTree: () => logTree
+});
+module.exports = __toCommonJS(logging_exports);
+var import_base_event = require("./base_event.js");
+var import_event_handler = require("./event_handler.js");
+const logTree = (bus) => {
+  const parent_to_children = /* @__PURE__ */ new Map();
+  const addChild = (parent_id, child) => {
+    const existing = parent_to_children.get(parent_id) ?? [];
+    existing.push(child);
+    parent_to_children.set(parent_id, existing);
+  };
+  const root_events = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const event of bus.event_history.values()) {
+    const parent_id = event.event_parent_id;
+    if (!parent_id || parent_id === event.event_id || !bus.event_history.has(parent_id)) {
+      if (!seen.has(event.event_id)) {
+        root_events.push(event);
+        seen.add(event.event_id);
+      }
+    }
+  }
+  if (root_events.length === 0) {
+    return "(No events in history)";
+  }
+  const nodes_by_id = /* @__PURE__ */ new Map();
+  for (const root of root_events) {
+    nodes_by_id.set(root.event_id, root);
+    for (const descendant of root.event_descendants) {
+      nodes_by_id.set(descendant.event_id, descendant);
+    }
+  }
+  for (const node of nodes_by_id.values()) {
+    const parent_id = node.event_parent_id;
+    if (!parent_id || parent_id === node.event_id) {
+      continue;
+    }
+    if (!nodes_by_id.has(parent_id)) {
+      continue;
+    }
+    addChild(parent_id, node);
+  }
+  for (const children of parent_to_children.values()) {
+    children.sort((a, b) => a.event_created_at < b.event_created_at ? -1 : a.event_created_at > b.event_created_at ? 1 : 0);
+  }
+  const lines = [];
+  const bus_label = typeof bus.toString === "function" ? bus.toString() : bus.name;
+  lines.push(`\u{1F4CA} Event History Tree for ${bus_label}`);
+  lines.push("=".repeat(80));
+  root_events.sort((a, b) => a.event_created_at < b.event_created_at ? -1 : a.event_created_at > b.event_created_at ? 1 : 0);
+  const visited = /* @__PURE__ */ new Set();
+  root_events.forEach((event, index) => {
+    lines.push(buildTreeLine(event, "", index === root_events.length - 1, parent_to_children, visited));
+  });
+  lines.push("=".repeat(80));
+  return lines.join("\n");
+};
+const buildTreeLine = (event, indent, is_last, parent_to_children, visited) => {
+  const connector = is_last ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+  const status_icon = event.event_status === "completed" ? "\u2705" : event.event_status === "started" ? "\u{1F3C3}" : "\u23F3";
+  const created_at = formatTimestamp(event.event_created_at);
+  let timing = `[${created_at}`;
+  if (event.event_completed_at) {
+    const created_ms = Date.parse(event.event_created_at);
+    const completed_ms = Date.parse(event.event_completed_at);
+    if (!Number.isNaN(created_ms) && !Number.isNaN(completed_ms)) {
+      const duration = (completed_ms - created_ms) / 1e3;
+      timing += ` (${duration.toFixed(3)}s)`;
+    }
+  }
+  timing += "]";
+  const line = `${indent}${connector}${status_icon} ${event.event_type}#${event.event_id.slice(-4)} ${timing}`;
+  if (visited.has(event.event_id)) {
+    return line;
+  }
+  visited.add(event.event_id);
+  const extension = is_last ? "    " : "\u2502   ";
+  const new_indent = indent + extension;
+  const result_items = [];
+  for (const result of event.event_results.values()) {
+    result_items.push({ type: "result", result });
+  }
+  const children = parent_to_children.get(event.event_id) ?? [];
+  const printed_child_ids = new Set(event.event_results.size > 0 ? event.event_results.keys() : []);
+  for (const child of children) {
+    if (!printed_child_ids.has(child.event_id) && !child.event_emitted_by_handler_id) {
+      result_items.push({ type: "child", child });
+      printed_child_ids.add(child.event_id);
+    }
+  }
+  if (result_items.length === 0) {
+    return line;
+  }
+  const child_lines = [];
+  result_items.forEach((item, index) => {
+    const is_last_item = index === result_items.length - 1;
+    if (item.type === "result") {
+      child_lines.push(buildResultLine(item.result, new_indent, is_last_item, parent_to_children, visited));
+    } else {
+      child_lines.push(buildTreeLine(item.child, new_indent, is_last_item, parent_to_children, visited));
+    }
+  });
+  return [line, ...child_lines].join("\n");
+};
+const buildResultLine = (result, indent, is_last, parent_to_children, visited) => {
+  const connector = is_last ? "\u2514\u2500\u2500 " : "\u251C\u2500\u2500 ";
+  const status_icon = result.status === "completed" ? "\u2705" : result.status === "error" ? "\u274C" : result.status === "started" ? "\u{1F3C3}" : "\u23F3";
+  const handler_label = result.handler_name && result.handler_name !== "anonymous" ? result.handler_name : result.handler_file_path ? result.handler_file_path : "anonymous";
+  const handler_display = `${result.eventbus_label}.${handler_label}#${result.handler_id.slice(-4)}`;
+  let line = `${indent}${connector}${status_icon} ${handler_display}`;
+  if (result.started_at) {
+    line += ` [${formatTimestamp(result.started_at)}`;
+    if (result.completed_at) {
+      const started_ms = Date.parse(result.started_at);
+      const completed_ms = Date.parse(result.completed_at);
+      if (!Number.isNaN(started_ms) && !Number.isNaN(completed_ms)) {
+        const duration = (completed_ms - started_ms) / 1e3;
+        line += ` (${duration.toFixed(3)}s)`;
+      }
+    }
+    line += "]";
+  }
+  if (result.status === "error" && result.error) {
+    if (result.error instanceof import_event_handler.EventHandlerTimeoutError) {
+      line += ` \u23F1\uFE0F Timeout: ${result.error.message}`;
+    } else if (result.error instanceof import_event_handler.EventHandlerCancelledError) {
+      line += ` \u{1F6AB} Cancelled: ${result.error.message}`;
+    } else {
+      const error_name = result.error instanceof Error ? result.error.name : "Error";
+      const error_message = result.error instanceof Error ? result.error.message : String(result.error);
+      line += ` \u2620\uFE0F ${error_name}: ${error_message}`;
+    }
+  } else if (result.status === "completed") {
+    line += ` \u2192 ${formatResultValue(result.result)}`;
+  }
+  const extension = is_last ? "    " : "\u2502   ";
+  const new_indent = indent + extension;
+  const direct_children = result.event_children;
+  if (direct_children.length === 0) {
+    return line;
+  }
+  const child_lines = [];
+  const parent_children = parent_to_children.get(result.event_id) ?? [];
+  const emitted_children = parent_children.filter((child) => child.event_emitted_by_handler_id === result.handler_id);
+  const children_by_id = /* @__PURE__ */ new Map();
+  direct_children.forEach((child) => {
+    children_by_id.set(child.event_id, child);
+  });
+  emitted_children.forEach((child) => {
+    if (!children_by_id.has(child.event_id)) {
+      children_by_id.set(child.event_id, child);
+    }
+  });
+  const children_to_print = Array.from(children_by_id.values()).filter((child) => !visited.has(child.event_id));
+  children_to_print.forEach((child, index) => {
+    child_lines.push(buildTreeLine(child, new_indent, index === children_to_print.length - 1, parent_to_children, visited));
+  });
+  return [line, ...child_lines].join("\n");
+};
+const formatTimestamp = (value) => {
+  if (!value) {
+    return "N/A";
+  }
+  const date = new Date(value);
+  if (Number.isNaN(date.getTime())) {
+    return "N/A";
+  }
+  return date.toISOString().slice(11, 23);
+};
+const formatResultValue = (value) => {
+  if (value === null || value === void 0) {
+    return "None";
+  }
+  if (value instanceof import_base_event.BaseEvent) {
+    return `Event(${value.event_type}#${value.event_id.slice(-4)})`;
+  }
+  if (typeof value === "string") {
+    return JSON.stringify(value);
+  }
+  if (typeof value === "number" || typeof value === "boolean") {
+    return String(value);
+  }
+  if (Array.isArray(value)) {
+    return `list(${value.length} items)`;
+  }
+  if (typeof value === "object") {
+    return `dict(${Object.keys(value).length} items)`;
+  }
+  return `${typeof value}(...)`;
+};
+//# sourceMappingURL=logging.js.map

package/dist/cjs/logging.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/logging.ts"],
+  "sourcesContent": ["import { BaseEvent } from './base_event.js'\nimport { EventResult } from './event_result.js'\nimport { EventHandlerCancelledError, EventHandlerTimeoutError } from './event_handler.js'\n\ntype LogTreeBus = {\n  name: string\n  event_history: {\n    values(): IterableIterator<BaseEvent>\n    has(event_id: string): boolean\n  }\n  toString?: () => string\n}\n\nexport const logTree = (bus: LogTreeBus): string => {\n  const parent_to_children = new Map<string, BaseEvent[]>()\n\n  const addChild = (parent_id: string, child: BaseEvent): void => {\n    const existing = parent_to_children.get(parent_id) ?? []\n    existing.push(child)\n    parent_to_children.set(parent_id, existing)\n  }\n\n  const root_events: BaseEvent[] = []\n  const seen = new Set<string>()\n\n  for (const event of bus.event_history.values()) {\n    const parent_id = event.event_parent_id\n    if (!parent_id || parent_id === event.event_id || !bus.event_history.has(parent_id)) {\n      if (!seen.has(event.event_id)) {\n        root_events.push(event)\n        seen.add(event.event_id)\n      }\n    }\n  }\n\n  if (root_events.length === 0) {\n    return '(No events in history)'\n  }\n\n  const nodes_by_id = new Map<string, BaseEvent>()\n  for (const root of root_events) {\n    nodes_by_id.set(root.event_id, root)\n    for (const descendant of root.event_descendants) {\n      nodes_by_id.set(descendant.event_id, descendant)\n    }\n  }\n\n  for (const node of nodes_by_id.values()) {\n    const parent_id = node.event_parent_id\n    if (!parent_id || parent_id === node.event_id) {\n      continue\n    }\n    if (!nodes_by_id.has(parent_id)) {\n      continue\n    }\n    addChild(parent_id, node)\n  }\n\n  for (const children of parent_to_children.values()) {\n    children.sort((a, b) => (a.event_created_at < b.event_created_at ? -1 : a.event_created_at > b.event_created_at ? 1 : 0))\n  }\n\n  const lines: string[] = []\n  const bus_label = typeof bus.toString === 'function' ? bus.toString() : bus.name\n  lines.push(`\uD83D\uDCCA Event History Tree for ${bus_label}`)\n  lines.push('='.repeat(80))\n\n  root_events.sort((a, b) => (a.event_created_at < b.event_created_at ? -1 : a.event_created_at > b.event_created_at ? 1 : 0))\n  const visited = new Set<string>()\n  root_events.forEach((event, index) => {\n    lines.push(buildTreeLine(event, '', index === root_events.length - 1, parent_to_children, visited))\n  })\n\n  lines.push('='.repeat(80))\n\n  return lines.join('\\n')\n}\n\nexport const buildTreeLine = (\n  event: BaseEvent,\n  indent: string,\n  is_last: boolean,\n  parent_to_children: Map<string, BaseEvent[]>,\n  visited: Set<string>\n): string => {\n  const connector = is_last ? '\u2514\u2500\u2500 ' : '\u251C\u2500\u2500 '\n  const status_icon = event.event_status === 'completed' ? '\u2705' : event.event_status === 'started' ? '\uD83C\uDFC3' : '\u23F3'\n\n  const created_at = formatTimestamp(event.event_created_at)\n  let timing = `[${created_at}`\n  if (event.event_completed_at) {\n    const created_ms = Date.parse(event.event_created_at)\n    const completed_ms = Date.parse(event.event_completed_at)\n    if (!Number.isNaN(created_ms) && !Number.isNaN(completed_ms)) {\n      const duration = (completed_ms - created_ms) / 1000\n      timing += ` (${duration.toFixed(3)}s)`\n    }\n  }\n  timing += ']'\n\n  const line = `${indent}${connector}${status_icon} ${event.event_type}#${event.event_id.slice(-4)} ${timing}`\n\n  if (visited.has(event.event_id)) {\n    return line\n  }\n  visited.add(event.event_id)\n\n  const extension = is_last ? '    ' : '\u2502   '\n  const new_indent = indent + extension\n\n  const result_items: Array<{ type: 'result'; result: EventResult } | { type: 'child'; child: BaseEvent }> = []\n  for (const result of event.event_results.values()) {\n    result_items.push({ type: 'result', result })\n  }\n  const children = parent_to_children.get(event.event_id) ?? []\n  const printed_child_ids = new Set<string>(event.event_results.size > 0 ? event.event_results.keys() : [])\n  for (const child of children) {\n    if (!printed_child_ids.has(child.event_id) && !child.event_emitted_by_handler_id) {\n      result_items.push({ type: 'child', child })\n      printed_child_ids.add(child.event_id)\n    }\n  }\n\n  if (result_items.length === 0) {\n    return line\n  }\n\n  const child_lines: string[] = []\n  result_items.forEach((item, index) => {\n    const is_last_item = index === result_items.length - 1\n    if (item.type === 'result') {\n      child_lines.push(buildResultLine(item.result, new_indent, is_last_item, parent_to_children, visited))\n    } else {\n      child_lines.push(buildTreeLine(item.child, new_indent, is_last_item, parent_to_children, visited))\n    }\n  })\n\n  return [line, ...child_lines].join('\\n')\n}\n\nexport const buildResultLine = (\n  result: EventResult,\n  indent: string,\n  is_last: boolean,\n  parent_to_children: Map<string, BaseEvent[]>,\n  visited: Set<string>\n): string => {\n  const connector = is_last ? '\u2514\u2500\u2500 ' : '\u251C\u2500\u2500 '\n  const status_icon = result.status === 'completed' ? '\u2705' : result.status === 'error' ? '\u274C' : result.status === 'started' ? '\uD83C\uDFC3' : '\u23F3'\n\n  const handler_label =\n    result.handler_name && result.handler_name !== 'anonymous'\n      ? result.handler_name\n      : result.handler_file_path\n        ? result.handler_file_path\n        : 'anonymous'\n  const handler_display = `${result.eventbus_label}.${handler_label}#${result.handler_id.slice(-4)}`\n  let line = `${indent}${connector}${status_icon} ${handler_display}`\n\n  if (result.started_at) {\n    line += ` [${formatTimestamp(result.started_at)}`\n    if (result.completed_at) {\n      const started_ms = Date.parse(result.started_at)\n      const completed_ms = Date.parse(result.completed_at)\n      if (!Number.isNaN(started_ms) && !Number.isNaN(completed_ms)) {\n        const duration = (completed_ms - started_ms) / 1000\n        line += ` (${duration.toFixed(3)}s)`\n      }\n    }\n    line += ']'\n  }\n\n  if (result.status === 'error' && result.error) {\n    if (result.error instanceof EventHandlerTimeoutError) {\n      line += ` \u23F1\uFE0F Timeout: ${result.error.message}`\n    } else if (result.error instanceof EventHandlerCancelledError) {\n      line += ` \uD83D\uDEAB Cancelled: ${result.error.message}`\n    } else {\n      const error_name = result.error instanceof Error ? result.error.name : 'Error'\n      const error_message = result.error instanceof Error ? result.error.message : String(result.error)\n      line += ` \u2620\uFE0F ${error_name}: ${error_message}`\n    }\n  } else if (result.status === 'completed') {\n    line += ` \u2192 ${formatResultValue(result.result)}`\n  }\n\n  const extension = is_last ? '    ' : '\u2502   '\n  const new_indent = indent + extension\n\n  const direct_children = result.event_children\n  if (direct_children.length === 0) {\n    return line\n  }\n\n  const child_lines: string[] = []\n  const parent_children = parent_to_children.get(result.event_id) ?? []\n  const emitted_children = parent_children.filter((child) => child.event_emitted_by_handler_id === result.handler_id)\n  const children_by_id = new Map<string, BaseEvent>()\n  direct_children.forEach((child) => {\n    children_by_id.set(child.event_id, child)\n  })\n  emitted_children.forEach((child) => {\n    if (!children_by_id.has(child.event_id)) {\n      children_by_id.set(child.event_id, child)\n    }\n  })\n  const children_to_print = Array.from(children_by_id.values()).filter((child) => !visited.has(child.event_id))\n\n  children_to_print.forEach((child, index) => {\n    child_lines.push(buildTreeLine(child, new_indent, index === children_to_print.length - 1, parent_to_children, visited))\n  })\n\n  return [line, ...child_lines].join('\\n')\n}\n\nexport const formatTimestamp = (value?: string): string => {\n  if (!value) {\n    return 'N/A'\n  }\n  const date = new Date(value)\n  if (Number.isNaN(date.getTime())) {\n    return 'N/A'\n  }\n  return date.toISOString().slice(11, 23)\n}\n\nexport const formatResultValue = (value: unknown): string => {\n  if (value === null || value === undefined) {\n    return 'None'\n  }\n  if (value instanceof BaseEvent) {\n    return `Event(${value.event_type}#${value.event_id.slice(-4)})`\n  }\n  if (typeof value === 'string') {\n    return JSON.stringify(value)\n  }\n  if (typeof value === 'number' || typeof value === 'boolean') {\n    return String(value)\n  }\n  if (Array.isArray(value)) {\n    return `list(${value.length} items)`\n  }\n  if (typeof value === 'object') {\n    return `dict(${Object.keys(value as Record<string, unknown>).length} items)`\n  }\n  return `${typeof value}(...)`\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/cjs/middlewares.d.ts

@@ -0,0 +1,13 @@
+import type { BaseEvent } from './base_event.js';
+import type { EventBus } from './event_bus.js';
+import type { EventHandler } from './event_handler.js';
+import type { EventResult } from './event_result.js';
+import type { EventStatus } from './types.js';
+export type { EventStatus } from './types.js';
+export interface EventBusMiddleware {
+    onEventChange?(eventbus: EventBus, event: BaseEvent, status: EventStatus): void | Promise<void>;
+    onEventResultChange?(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void | Promise<void>;
+    onBusHandlersChange?(eventbus: EventBus, handler: EventHandler, registered: boolean): void | Promise<void>;
+}
+export type EventBusMiddlewareCtor = new () => EventBusMiddleware;
+export type EventBusMiddlewareInput = EventBusMiddleware | EventBusMiddlewareCtor;

package/dist/cjs/middlewares.js

@@ -0,0 +1,17 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var middlewares_exports = {};
+module.exports = __toCommonJS(middlewares_exports);
+//# sourceMappingURL=middlewares.js.map

package/dist/cjs/middlewares.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/middlewares.ts"],
+  "sourcesContent": ["import type { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport type { EventHandler } from './event_handler.js'\nimport type { EventResult } from './event_result.js'\nimport type { EventStatus } from './types.js'\n\nexport type { EventStatus } from './types.js'\n\nexport interface EventBusMiddleware {\n  onEventChange?(eventbus: EventBus, event: BaseEvent, status: EventStatus): void | Promise<void>\n  onEventResultChange?(eventbus: EventBus, event: BaseEvent, event_result: EventResult, status: EventStatus): void | Promise<void>\n  onBusHandlersChange?(eventbus: EventBus, handler: EventHandler, registered: boolean): void | Promise<void>\n}\n\nexport type EventBusMiddlewareCtor = new () => EventBusMiddleware\nexport type EventBusMiddlewareInput = EventBusMiddleware | EventBusMiddlewareCtor\n"],
+  "mappings": ";;;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/dist/cjs/optional_deps.d.ts

@@ -0,0 +1,3 @@
+export declare const isNodeRuntime: () => boolean;
+export declare const assertOptionalDependencyAvailable: (bridge_name: string, package_name: string) => void;
+export declare const importOptionalDependency: (bridge_name: string, package_name: string) => Promise<any>;

package/dist/cjs/optional_deps.js

@@ -0,0 +1,64 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var optional_deps_exports = {};
+__export(optional_deps_exports, {
+  assertOptionalDependencyAvailable: () => assertOptionalDependencyAvailable,
+  importOptionalDependency: () => importOptionalDependency,
+  isNodeRuntime: () => isNodeRuntime
+});
+module.exports = __toCommonJS(optional_deps_exports);
+const isNodeRuntime = () => {
+  const maybe_process = globalThis.process;
+  return typeof maybe_process?.versions?.node === "string";
+};
+const missingDependencyError = (bridge_name, package_name) => new Error(`${bridge_name} requires optional dependency "${package_name}". Install it with: npm install ${package_name}`);
+const assertOptionalDependencyAvailable = (bridge_name, package_name) => {
+  if (!isNodeRuntime()) return;
+  const maybe_process = globalThis.process;
+  const get_builtin_module = maybe_process?.getBuiltinModule;
+  let require_fn;
+  try {
+    require_fn = Function('return typeof require === "function" ? require : undefined')();
+  } catch {
+    require_fn = void 0;
+  }
+  if (!require_fn && typeof get_builtin_module === "function") {
+    const module_builtin = get_builtin_module("module");
+    const create_require = module_builtin?.createRequire;
+    if (typeof create_require === "function") {
+      const cwd = typeof maybe_process?.cwd === "function" ? maybe_process.cwd() : ".";
+      require_fn = create_require(`${cwd}/package.json`);
+    }
+  }
+  if (!require_fn) return;
+  try {
+    require_fn.resolve(package_name);
+  } catch {
+    throw missingDependencyError(bridge_name, package_name);
+  }
+};
+const importOptionalDependency = async (bridge_name, package_name) => {
+  const dynamic_import = Function("module_name", "return import(module_name)");
+  try {
+    return await dynamic_import(package_name);
+  } catch {
+    throw missingDependencyError(bridge_name, package_name);
+  }
+};
+//# sourceMappingURL=optional_deps.js.map

package/dist/cjs/optional_deps.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/optional_deps.ts"],
+  "sourcesContent": ["export const isNodeRuntime = (): boolean => {\n  const maybe_process = (globalThis as { process?: { versions?: { node?: string } } }).process\n  return typeof maybe_process?.versions?.node === 'string'\n}\n\nconst missingDependencyError = (bridge_name: string, package_name: string): Error =>\n  new Error(`${bridge_name} requires optional dependency \"${package_name}\". Install it with: npm install ${package_name}`)\n\nexport const assertOptionalDependencyAvailable = (bridge_name: string, package_name: string): void => {\n  if (!isNodeRuntime()) return\n\n  const maybe_process = (\n    globalThis as {\n      process?: { getBuiltinModule?: (name: string) => any; cwd?: () => string }\n    }\n  ).process\n  const get_builtin_module = maybe_process?.getBuiltinModule\n\n  let require_fn: { resolve: (specifier: string) => string } | undefined\n  try {\n    require_fn = Function('return typeof require === \"function\" ? require : undefined')() as\n      | { resolve: (specifier: string) => string }\n      | undefined\n  } catch {\n    require_fn = undefined\n  }\n\n  if (!require_fn && typeof get_builtin_module === 'function') {\n    const module_builtin = get_builtin_module('module')\n    const create_require = module_builtin?.createRequire\n    if (typeof create_require === 'function') {\n      const cwd = typeof maybe_process?.cwd === 'function' ? maybe_process.cwd() : '.'\n      require_fn = create_require(`${cwd}/package.json`) as { resolve: (specifier: string) => string }\n    }\n  }\n\n  if (!require_fn) return\n  try {\n    require_fn.resolve(package_name)\n  } catch {\n    throw missingDependencyError(bridge_name, package_name)\n  }\n}\n\nexport const importOptionalDependency = async (bridge_name: string, package_name: string): Promise<any> => {\n  const dynamic_import = Function('module_name', 'return import(module_name)') as (module_name: string) => Promise<unknown>\n  try {\n    return (await dynamic_import(package_name)) as any\n  } catch {\n    throw missingDependencyError(bridge_name, package_name)\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAO,MAAM,gBAAgB,MAAe;AAC1C,QAAM,gBAAiB,WAA8D;AACrF,SAAO,OAAO,eAAe,UAAU,SAAS;AAClD;AAEA,MAAM,yBAAyB,CAAC,aAAqB,iBACnD,IAAI,MAAM,GAAG,WAAW,kCAAkC,YAAY,mCAAmC,YAAY,EAAE;AAElH,MAAM,oCAAoC,CAAC,aAAqB,iBAA+B;AACpG,MAAI,CAAC,cAAc,EAAG;AAEtB,QAAM,gBACJ,WAGA;AACF,QAAM,qBAAqB,eAAe;AAE1C,MAAI;AACJ,MAAI;AACF,iBAAa,SAAS,4DAA4D,EAAE;AAAA,EAGtF,QAAQ;AACN,iBAAa;AAAA,EACf;AAEA,MAAI,CAAC,cAAc,OAAO,uBAAuB,YAAY;AAC3D,UAAM,iBAAiB,mBAAmB,QAAQ;AAClD,UAAM,iBAAiB,gBAAgB;AACvC,QAAI,OAAO,mBAAmB,YAAY;AACxC,YAAM,MAAM,OAAO,eAAe,QAAQ,aAAa,cAAc,IAAI,IAAI;AAC7E,mBAAa,eAAe,GAAG,GAAG,eAAe;AAAA,IACnD;AAAA,EACF;AAEA,MAAI,CAAC,WAAY;AACjB,MAAI;AACF,eAAW,QAAQ,YAAY;AAAA,EACjC,QAAQ;AACN,UAAM,uBAAuB,aAAa,YAAY;AAAA,EACxD;AACF;AAEO,MAAM,2BAA2B,OAAO,aAAqB,iBAAuC;AACzG,QAAM,iBAAiB,SAAS,eAAe,4BAA4B;AAC3E,MAAI;AACF,WAAQ,MAAM,eAAe,YAAY;AAAA,EAC3C,QAAQ;AACN,UAAM,uBAAuB,aAAa,YAAY;AAAA,EACxD;AACF;",
+  "names": []
+}

package/dist/cjs/package.json

@@ -0,0 +1,5 @@
+{
+  "type": "commonjs",
+  "main": "./index.js",
+  "types": "./index.d.ts"
+}

package/dist/cjs/retry.d.ts

@@ -0,0 +1,52 @@
+export interface RetryOptions {
+    /** Total number of attempts including the initial call (1 = no retry, 3 = up to 2 retries). Default: 1 */
+    max_attempts?: number;
+    /** Seconds to wait between retries. Default: 0 */
+    retry_after?: number;
+    /** Multiplier applied to retry_after after each attempt for exponential backoff. Default: 1.0 (constant delay) */
+    retry_backoff_factor?: number;
+    /** Only retry when the thrown error matches one of these matchers. Accepts error class constructors,
+     *  string error names (matched against error.name), or RegExp patterns (tested against String(error)).
+     *  Default: undefined (retry on any error) */
+    retry_on_errors?: Array<(new (...args: any[]) => Error) | string | RegExp>;
+    /** Per-attempt timeout in seconds. Default: undefined (no per-attempt timeout) */
+    timeout?: number | null;
+    /** Maximum concurrent executions sharing this semaphore. Default: undefined (no concurrency limit) */
+    semaphore_limit?: number | null;
+    /** Semaphore identifier. Functions with the same name share the same concurrency slot pool. Default: function name.
+     *  If a function is provided, it receives the same arguments as the wrapped function. */
+    semaphore_name?: string | ((...args: any[]) => string) | null;
+    /** If true, proceed without concurrency limit when semaphore acquisition times out. Default: true */
+    semaphore_lax?: boolean;
+    /** Semaphore scoping strategy. Default: 'global'
+     *  - 'global': all calls share one semaphore (keyed by semaphore_name)
+     *  - 'class': all instances of the same class share one semaphore (keyed by className.semaphore_name)
+     *  - 'instance': each object instance gets its own semaphore (keyed by instanceId.semaphore_name)
+     *  'class' and 'instance' require `this` to be an object; they fall back to 'global' for standalone calls. */
+    semaphore_scope?: 'global' | 'class' | 'instance';
+    /** Maximum seconds to wait for semaphore acquisition. Default: undefined → timeout * max(1, limit - 1) */
+    semaphore_timeout?: number | null;
+}
+/** Thrown when a single attempt exceeds the per-attempt timeout. */
+export declare class RetryTimeoutError extends Error {
+    timeout_seconds: number;
+    attempt: number;
+    constructor(message: string, params: {
+        timeout_seconds: number;
+        attempt: number;
+    });
+}
+/** Thrown (when semaphore_lax=false) if the semaphore cannot be acquired within the timeout. */
+export declare class SemaphoreTimeoutError extends Error {
+    semaphore_name: string;
+    semaphore_limit: number;
+    timeout_seconds: number;
+    constructor(message: string, params: {
+        semaphore_name: string;
+        semaphore_limit: number;
+        timeout_seconds: number;
+    });
+}
+/** Reset the global semaphore registry. Useful in tests. */
+export declare function clearSemaphoreRegistry(): void;
+export declare function retry(options?: RetryOptions): <T extends (...args: any[]) => any>(target: T, _context?: ClassMethodDecoratorContext) => T;