abxbus 2.4.1

package/dist/cjs/event_result.js

@@ -0,0 +1,446 @@
+"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 event_result_exports = {};
+__export(event_result_exports, {
+  EventResult: () => EventResult,
+  EventResultJSONSchema: () => EventResultJSONSchema
+});
+module.exports = __toCommonJS(event_result_exports);
+var import_uuid = require("uuid");
+var import_zod = require("zod");
+var import_base_event = require("./base_event.js");
+var import_event_handler = require("./event_handler.js");
+var import_lock_manager = require("./lock_manager.js");
+var import_types = require("./types.js");
+var import_async_context = require("./async_context.js");
+var import_retry = require("./retry.js");
+var import_timing = require("./timing.js");
+var import_helpers = require("./helpers.js");
+const EventResultJSONSchema = import_zod.z.object({
+  id: import_zod.z.string(),
+  status: import_zod.z.enum(["pending", "started", "completed", "error"]),
+  event_id: import_zod.z.string(),
+  handler_id: import_zod.z.string(),
+  handler_name: import_zod.z.string(),
+  handler_file_path: import_zod.z.string().nullable().optional(),
+  handler_timeout: import_zod.z.number().nullable().optional(),
+  handler_slow_timeout: import_zod.z.number().nullable().optional(),
+  handler_registered_at: import_zod.z.string().datetime().optional(),
+  handler_event_pattern: import_zod.z.union([import_zod.z.string(), import_zod.z.literal("*")]).optional(),
+  eventbus_name: import_zod.z.string(),
+  eventbus_id: import_zod.z.string().uuid(),
+  started_at: import_zod.z.string().datetime().nullable().optional(),
+  completed_at: import_zod.z.string().datetime().nullable().optional(),
+  result: import_zod.z.unknown().optional(),
+  error: import_zod.z.unknown().optional(),
+  event_children: import_zod.z.array(import_zod.z.string())
+}).strict();
+class EventResult {
+  id;
+  // unique uuidv7 identifier for the event result
+  status;
+  // 'pending', 'started', 'completed', or 'error'
+  event;
+  // the Event that the handler is processing
+  handler;
+  // the EventHandler object that going to process the event
+  started_at;
+  completed_at;
+  result;
+  // parsed return value from the event handler
+  error;
+  // error object thrown by the event handler, or null if the handler completed successfully
+  event_children;
+  // list of emitted child events
+  // Abort signal: created when handler starts, rejected by _signalAbort() to
+  // interrupt runHandler's await via Promise.race.
+  _abort;
+  // Handler lock: tracks ownership of the handler concurrency lock
+  // during handler execution. Set by runHandler(), used by
+  // _processEventImmediately for yield-and-reacquire during queue-jumps.
+  _lock;
+  // Runloop pause releases keyed by bus for queue-jump; released when handler exits.
+  _queue_jump_pause_releases;
+  constructor(params) {
+    this.id = (0, import_uuid.v7)();
+    this.status = "pending";
+    this.event = params.event;
+    this.handler = params.handler;
+    this.started_at = null;
+    this.completed_at = null;
+    this.result = void 0;
+    this.error = void 0;
+    this.event_children = [];
+    this._abort = null;
+    this._lock = null;
+    this._queue_jump_pause_releases = null;
+  }
+  toString() {
+    return `${this.result ?? "null"} (${this.status})`;
+  }
+  get event_id() {
+    return this.event.event_id;
+  }
+  get bus() {
+    return this.event.bus;
+  }
+  get handler_id() {
+    return this.handler.id;
+  }
+  get handler_name() {
+    return this.handler.handler_name;
+  }
+  get handler_file_path() {
+    return this.handler.handler_file_path;
+  }
+  get eventbus_name() {
+    return this.handler.eventbus_name;
+  }
+  get eventbus_id() {
+    return this.handler.eventbus_id;
+  }
+  get eventbus_label() {
+    return `${this.handler.eventbus_name}#${this.handler.eventbus_id.slice(-4)}`;
+  }
+  getHookBus() {
+    const root_bus = this.event.bus;
+    if (!root_bus) {
+      return void 0;
+    }
+    return root_bus.all_instances.findBusById(this.eventbus_id) ?? root_bus;
+  }
+  async _notifyStatusHook(status) {
+    const hook_bus = this.getHookBus();
+    if (!hook_bus) {
+      return;
+    }
+    const event_for_hook = hook_bus._getEventProxyScopedToThisBus(this.event._event_original ?? this.event, this);
+    await hook_bus.onEventResultChange(event_for_hook, this, status);
+  }
+  // shortcut for the result value so users can do event_result.value instead of event_result.result
+  get value() {
+    return this.result;
+  }
+  // Per-result schema reference derives from the parent event schema.
+  // It is intentionally not serialized with each EventResult to avoid duplication.
+  get result_type() {
+    const original_event = this.event._event_original ?? this.event;
+    return original_event.event_result_type;
+  }
+  // Link a child event emitted by this handler run to the parent event/result.
+  _linkEmittedChildEvent(child_event) {
+    const original_child = child_event._event_original ?? child_event;
+    const parent_event = this.event._event_original ?? this.event;
+    if (original_child.event_id === parent_event.event_id) {
+      return;
+    }
+    if (!original_child.event_parent_id) {
+      original_child.event_parent_id = parent_event.event_id;
+    }
+    if (!original_child.event_emitted_by_handler_id) {
+      original_child.event_emitted_by_handler_id = this.handler_id;
+    }
+    if (!this.event_children.some((child) => child.event_id === original_child.event_id)) {
+      this.event_children.push(original_child);
+    }
+  }
+  // Get the raw return value from the handler, even if it threw an error / failed validation
+  get raw_value() {
+    if (this.error && this.error.raw_value !== void 0) {
+      return this.error.raw_value;
+    }
+    return this.result;
+  }
+  // Resolve handler timeout in seconds using precedence: handler -> event -> bus defaults.
+  get handler_timeout() {
+    const original = this.event._event_original ?? this.event;
+    const resolved_event_timeout = original.event_timeout ?? this.bus.event_timeout;
+    let resolved_handler_timeout;
+    if (this.handler.handler_timeout !== void 0) {
+      resolved_handler_timeout = this.handler.handler_timeout;
+    } else if (original.event_handler_timeout !== void 0) {
+      resolved_handler_timeout = original.event_handler_timeout;
+    } else {
+      resolved_handler_timeout = this.bus.event_timeout;
+    }
+    if (resolved_handler_timeout === null && resolved_event_timeout === null) {
+      return null;
+    }
+    if (resolved_handler_timeout === null) {
+      return resolved_event_timeout;
+    }
+    if (resolved_event_timeout === null) {
+      return resolved_handler_timeout;
+    }
+    return Math.min(resolved_handler_timeout, resolved_event_timeout);
+  }
+  // Resolve slow handler warning threshold in seconds using precedence: handler -> event -> bus defaults.
+  get handler_slow_timeout() {
+    const original = this.event._event_original ?? this.event;
+    if (this.handler.handler_slow_timeout !== void 0) {
+      return this.handler.handler_slow_timeout;
+    }
+    if (original.event_handler_slow_timeout !== void 0) {
+      return original.event_handler_slow_timeout;
+    }
+    const event_slow_timeout = original.event_slow_timeout;
+    if (event_slow_timeout !== void 0) {
+      return event_slow_timeout;
+    }
+    if (this.bus?.event_handler_slow_timeout !== void 0) {
+      return this.bus.event_handler_slow_timeout;
+    }
+    return this.bus?.event_slow_timeout ?? null;
+  }
+  // Create a slow-handler warning timer that logs if the handler runs too long.
+  _createSlowHandlerWarningTimer(effective_timeout) {
+    const handler_warn_timeout = this.handler_slow_timeout;
+    const warn_ms = handler_warn_timeout === null ? null : handler_warn_timeout * 1e3;
+    const should_warn = warn_ms !== null && (effective_timeout === null || effective_timeout * 1e3 > warn_ms);
+    if (!should_warn || warn_ms === null) {
+      return null;
+    }
+    const event = this.event._event_original ?? this.event;
+    const bus_name = this.handler.eventbus_name;
+    const started_at_ms = performance.now();
+    return setTimeout(() => {
+      if (this.status !== "started") {
+        return;
+      }
+      const elapsed_ms = performance.now() - started_at_ms;
+      const elapsed_seconds = (elapsed_ms / 1e3).toFixed(1);
+      console.warn(
+        `[abxbus] Slow event handler: ${bus_name}.on(${event.toString()}, ${this.handler.toString()}) still running after ${elapsed_seconds}s`
+      );
+    }, warn_ms);
+  }
+  _ensureQueueJumpPause(bus) {
+    if (!this._queue_jump_pause_releases) {
+      this._queue_jump_pause_releases = /* @__PURE__ */ new Map();
+    }
+    if (this._queue_jump_pause_releases.has(bus)) {
+      return;
+    }
+    this._queue_jump_pause_releases.set(bus, bus.locks._requestRunloopPause());
+  }
+  _releaseQueueJumpPauses() {
+    if (!this._queue_jump_pause_releases) {
+      return;
+    }
+    for (const release of this._queue_jump_pause_releases.values()) {
+      release();
+    }
+    this._queue_jump_pause_releases.clear();
+  }
+  update(params) {
+    const has_status = "status" in params;
+    const has_result = "result" in params;
+    const has_error = "error" in params;
+    if (has_result) {
+      const raw_result = params.result;
+      this.status = "completed";
+      if (this.event.event_result_type && raw_result !== void 0 && !(raw_result instanceof import_base_event.BaseEvent) && (0, import_types.isZodSchema)(this.event.event_result_type)) {
+        const parsed = this.event.event_result_type.safeParse(raw_result);
+        if (parsed.success) {
+          this.result = parsed.data;
+        } else {
+          const error = new import_event_handler.EventHandlerResultSchemaError(
+            `Event handler return value ${JSON.stringify(raw_result).slice(0, 20)}... did not match event_result_type: ${parsed.error.message}`,
+            { event_result: this, cause: parsed.error, raw_value: raw_result }
+          );
+          this.error = error;
+          this.result = void 0;
+          this.status = "error";
+        }
+      } else {
+        this.result = raw_result;
+      }
+    }
+    if (has_error) {
+      this.error = params.error;
+      this.status = "error";
+    }
+    if (has_status && params.status !== void 0) {
+      this.status = params.status;
+    }
+    if (this.status !== "pending" && this.started_at === null) {
+      this.started_at = (0, import_helpers.monotonicDatetime)();
+    }
+    if ((this.status === "completed" || this.status === "error") && this.completed_at === null) {
+      this.completed_at = (0, import_helpers.monotonicDatetime)();
+    }
+    return this;
+  }
+  _createHandlerTimeoutError(event) {
+    return new import_event_handler.EventHandlerTimeoutError(
+      `${this.bus.toString()}.on(${event.toString()}, ${this.handler.toString()}) timed out after ${this.handler_timeout}s`,
+      {
+        event_result: this,
+        timeout_seconds: this.handler_timeout
+      }
+    );
+  }
+  _handleHandlerError(event, error) {
+    const normalized_error = error instanceof import_retry.RetryTimeoutError ? new import_event_handler.EventHandlerTimeoutError(error.message, { event_result: this, timeout_seconds: error.timeout_seconds, cause: error }) : error;
+    if (normalized_error instanceof import_event_handler.EventHandlerTimeoutError) {
+      this._markError(normalized_error, false);
+      event._cancelPendingChildProcessing(normalized_error);
+    } else {
+      this._markError(normalized_error, false);
+    }
+  }
+  _onHandlerExit(slow_handler_warning_timer) {
+    this._abort = null;
+    this._lock = null;
+    this._releaseQueueJumpPauses();
+    if (slow_handler_warning_timer) {
+      clearTimeout(slow_handler_warning_timer);
+    }
+  }
+  // Run one handler invocation with timeout/slow-monitor/error handling.
+  // Handler lock acquisition is owned by BaseEvent._runHandlers(...).
+  async runHandler(handler_lock) {
+    if (this.status === "error" && this.error instanceof import_event_handler.EventHandlerCancelledError) {
+      return;
+    }
+    const event = this.event._event_original ?? this.event;
+    const handler_event = this.bus._getEventProxyScopedToThisBus(event, this);
+    if (this._lock) {
+      this._lock.exitHandlerRun();
+    }
+    let slow_handler_warning_timer = null;
+    if (this.status === "error" || this.status === "completed") {
+      return;
+    }
+    this._lock = handler_lock;
+    await this.bus.locks._runWithHandlerDispatchContext(this, async () => {
+      await (0, import_async_context._runWithAsyncContext)(event._getDispatchContext() ?? null, async () => {
+        try {
+          const should_notify_started = this.status === "pending";
+          const abort_signal = this._markStarted(false);
+          if (should_notify_started) {
+            await this._notifyStatusHook("started");
+          }
+          slow_handler_warning_timer = this._createSlowHandlerWarningTimer(this.handler_timeout);
+          const handler_result = await (0, import_timing._runWithTimeout)(
+            this.handler_timeout,
+            () => this._createHandlerTimeoutError(event),
+            () => (0, import_timing._runWithSlowMonitor)(
+              slow_handler_warning_timer,
+              () => (0, import_timing._runWithAbortMonitor)(() => this.handler._handler_async(handler_event), abort_signal)
+            )
+          );
+          this._markCompleted(handler_result, false);
+        } catch (error) {
+          this._handleHandlerError(event, error);
+        } finally {
+          if (this.status === "completed" || this.status === "error") {
+            await this._notifyStatusHook("completed");
+          }
+          this._onHandlerExit(slow_handler_warning_timer);
+        }
+      });
+    });
+  }
+  // Reject the abort promise, causing runHandler's Promise.race to
+  // throw immediately — even if the handler has no timeout.
+  _signalAbort(error) {
+    if (this._abort) {
+      this._abort.reject(error);
+      this._abort = null;
+    }
+  }
+  // Mark started and return the abort promise for Promise.race.
+  _markStarted(notify_hook = true) {
+    if (!this._abort) {
+      this._abort = (0, import_lock_manager.withResolvers)();
+    }
+    if (this.status === "pending") {
+      this.update({ status: "started" });
+      if (notify_hook) {
+        void this._notifyStatusHook("started");
+      }
+    }
+    return this._abort.promise;
+  }
+  _markCompleted(result, notify_hook = true) {
+    if (this.status === "completed" || this.status === "error") return;
+    this.update({ result });
+    if (notify_hook) {
+      void this._notifyStatusHook("completed");
+    }
+  }
+  _markError(error, notify_hook = true) {
+    if (this.status === "completed" || this.status === "error") return;
+    this.update({ error });
+    if (notify_hook) {
+      void this._notifyStatusHook("completed");
+    }
+  }
+  toJSON() {
+    return {
+      id: this.id,
+      status: this.status,
+      event_id: this.event.event_id,
+      handler_id: this.handler_id,
+      handler_name: this.handler_name,
+      handler_file_path: this.handler_file_path,
+      handler_timeout: this.handler.handler_timeout,
+      handler_slow_timeout: this.handler.handler_slow_timeout,
+      handler_registered_at: this.handler.handler_registered_at,
+      handler_event_pattern: this.handler.event_pattern,
+      eventbus_name: this.eventbus_name,
+      eventbus_id: this.eventbus_id,
+      started_at: this.started_at,
+      completed_at: this.completed_at,
+      result: this.result,
+      error: this.error,
+      event_children: this.event_children.map((child) => child.event_id)
+    };
+  }
+  static fromJSON(event, data) {
+    const record = EventResultJSONSchema.parse(data);
+    const handler_record = {
+      id: record.handler_id,
+      eventbus_name: record.eventbus_name,
+      eventbus_id: record.eventbus_id,
+      event_pattern: record.handler_event_pattern ?? event.event_type,
+      handler_name: record.handler_name,
+      handler_file_path: record.handler_file_path ?? null,
+      handler_timeout: record.handler_timeout,
+      handler_slow_timeout: record.handler_slow_timeout,
+      handler_registered_at: record.handler_registered_at ?? event.event_created_at
+    };
+    const handler_stub = import_event_handler.EventHandler.fromJSON(handler_record, (() => void 0));
+    const result = new EventResult({ event, handler: handler_stub });
+    result.id = record.id;
+    result.status = record.status;
+    result.started_at = record.started_at === null || record.started_at === void 0 ? null : (0, import_helpers.monotonicDatetime)(record.started_at);
+    result.completed_at = record.completed_at === null || record.completed_at === void 0 ? null : (0, import_helpers.monotonicDatetime)(record.completed_at);
+    if ("result" in record) {
+      result.result = record.result;
+    }
+    if ("error" in record) {
+      result.error = record.error;
+    }
+    result.event_children = [];
+    return result;
+  }
+}
+//# sourceMappingURL=event_result.js.map

package/dist/cjs/event_result.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/event_result.ts"],
+  "sourcesContent": ["import { v7 as uuidv7 } from 'uuid'\n\nimport { z } from 'zod'\n\nimport { BaseEvent } from './base_event.js'\nimport type { EventBus } from './event_bus.js'\nimport { EventHandler, EventHandlerCancelledError, EventHandlerResultSchemaError, EventHandlerTimeoutError } from './event_handler.js'\nimport { withResolvers, type HandlerLock } from './lock_manager.js'\nimport type { Deferred } from './lock_manager.js'\nimport type { EventHandlerCallable, EventResultType } from './types.js'\nimport { isZodSchema } from './types.js'\nimport { _runWithAsyncContext } from './async_context.js'\nimport { RetryTimeoutError } from './retry.js'\nimport { _runWithAbortMonitor, _runWithSlowMonitor, _runWithTimeout } from './timing.js'\nimport { monotonicDatetime } from './helpers.js'\n\n// More precise than event.event_status, includes separate 'error' state for handlers that throw errors during execution\nexport type EventResultStatus = 'pending' | 'started' | 'completed' | 'error'\n\nexport const EventResultJSONSchema = z\n  .object({\n    id: z.string(),\n    status: z.enum(['pending', 'started', 'completed', 'error']),\n    event_id: z.string(),\n    handler_id: z.string(),\n    handler_name: z.string(),\n    handler_file_path: z.string().nullable().optional(),\n    handler_timeout: z.number().nullable().optional(),\n    handler_slow_timeout: z.number().nullable().optional(),\n    handler_registered_at: z.string().datetime().optional(),\n    handler_event_pattern: z.union([z.string(), z.literal('*')]).optional(),\n    eventbus_name: z.string(),\n    eventbus_id: z.string().uuid(),\n    started_at: z.string().datetime().nullable().optional(),\n    completed_at: z.string().datetime().nullable().optional(),\n    result: z.unknown().optional(),\n    error: z.unknown().optional(),\n    event_children: z.array(z.string()),\n  })\n  .strict()\n\nexport type EventResultJSON = z.infer<typeof EventResultJSONSchema>\n\n// Object that tracks the pending or completed execution of a single event handler\nexport class EventResult<TEvent extends BaseEvent = BaseEvent> {\n  id: string // unique uuidv7 identifier for the event result\n  status: EventResultStatus // 'pending', 'started', 'completed', or 'error'\n  event: TEvent // the Event that the handler is processing\n  handler: EventHandler // the EventHandler object that going to process the event\n  started_at: string | null\n  completed_at: string | null\n  result?: EventResultType<TEvent> // parsed return value from the event handler\n  error?: unknown // error object thrown by the event handler, or null if the handler completed successfully\n  event_children: BaseEvent[] // list of emitted child events\n\n  // Abort signal: created when handler starts, rejected by _signalAbort() to\n  // interrupt runHandler's await via Promise.race.\n  _abort: Deferred<never> | null\n  // Handler lock: tracks ownership of the handler concurrency lock\n  // during handler execution. Set by runHandler(), used by\n  // _processEventImmediately for yield-and-reacquire during queue-jumps.\n  _lock: HandlerLock | null\n  // Runloop pause releases keyed by bus for queue-jump; released when handler exits.\n  _queue_jump_pause_releases: Map<EventBus, () => void> | null\n\n  constructor(params: { event: TEvent; handler: EventHandler }) {\n    this.id = uuidv7()\n    this.status = 'pending'\n    this.event = params.event\n    this.handler = params.handler\n    this.started_at = null\n    this.completed_at = null\n    this.result = undefined\n    this.error = undefined\n    this.event_children = []\n    this._abort = null\n    this._lock = null\n    this._queue_jump_pause_releases = null\n  }\n\n  toString(): string {\n    return `${this.result ?? 'null'} (${this.status})`\n  }\n\n  get event_id(): string {\n    return this.event.event_id\n  }\n\n  get bus(): EventBus {\n    return this.event.bus!\n  }\n\n  get handler_id(): string {\n    return this.handler.id\n  }\n\n  get handler_name(): string {\n    return this.handler.handler_name\n  }\n\n  get handler_file_path(): string | null {\n    return this.handler.handler_file_path\n  }\n\n  get eventbus_name(): string {\n    return this.handler.eventbus_name\n  }\n\n  get eventbus_id(): string {\n    return this.handler.eventbus_id\n  }\n\n  get eventbus_label(): string {\n    return `${this.handler.eventbus_name}#${this.handler.eventbus_id.slice(-4)}`\n  }\n\n  private getHookBus(): EventBus | undefined {\n    const root_bus = this.event.bus\n    if (!root_bus) {\n      return undefined\n    }\n    return root_bus.all_instances.findBusById(this.eventbus_id) ?? root_bus\n  }\n\n  private async _notifyStatusHook(status: 'started' | 'completed'): Promise<void> {\n    const hook_bus = this.getHookBus()\n    if (!hook_bus) {\n      return\n    }\n    const event_for_hook = hook_bus._getEventProxyScopedToThisBus(this.event._event_original ?? this.event, this)\n    await hook_bus.onEventResultChange(event_for_hook, this, status)\n  }\n\n  // shortcut for the result value so users can do event_result.value instead of event_result.result\n  get value(): EventResultType<TEvent> | undefined {\n    return this.result\n  }\n\n  // Per-result schema reference derives from the parent event schema.\n  // It is intentionally not serialized with each EventResult to avoid duplication.\n  get result_type(): TEvent['event_result_type'] {\n    const original_event = this.event._event_original ?? this.event\n    return original_event.event_result_type as TEvent['event_result_type']\n  }\n\n  // Link a child event emitted by this handler run to the parent event/result.\n  _linkEmittedChildEvent(child_event: BaseEvent): void {\n    const original_child = child_event._event_original ?? child_event\n    const parent_event = this.event._event_original ?? this.event\n    if (original_child.event_id === parent_event.event_id) {\n      return\n    }\n    if (!original_child.event_parent_id) {\n      original_child.event_parent_id = parent_event.event_id\n    }\n    if (!original_child.event_emitted_by_handler_id) {\n      original_child.event_emitted_by_handler_id = this.handler_id\n    }\n    if (!this.event_children.some((child) => child.event_id === original_child.event_id)) {\n      this.event_children.push(original_child)\n    }\n  }\n\n  // Get the raw return value from the handler, even if it threw an error / failed validation\n  get raw_value(): EventResultType<TEvent> | undefined {\n    if (this.error && (this.error as any).raw_value !== undefined) {\n      return (this.error as any).raw_value\n    }\n    return this.result\n  }\n\n  // Resolve handler timeout in seconds using precedence: handler -> event -> bus defaults.\n  get handler_timeout(): number | null {\n    const original = this.event._event_original ?? this.event\n    const resolved_event_timeout = original.event_timeout ?? this.bus.event_timeout\n\n    let resolved_handler_timeout: number | null\n    if (this.handler.handler_timeout !== undefined) {\n      resolved_handler_timeout = this.handler.handler_timeout\n    } else if (original.event_handler_timeout !== undefined) {\n      resolved_handler_timeout = original.event_handler_timeout\n    } else {\n      resolved_handler_timeout = this.bus.event_timeout\n    }\n\n    if (resolved_handler_timeout === null && resolved_event_timeout === null) {\n      return null\n    }\n    if (resolved_handler_timeout === null) {\n      return resolved_event_timeout\n    }\n    if (resolved_event_timeout === null) {\n      return resolved_handler_timeout\n    }\n    return Math.min(resolved_handler_timeout, resolved_event_timeout)\n  }\n\n  // Resolve slow handler warning threshold in seconds using precedence: handler -> event -> bus defaults.\n  get handler_slow_timeout(): number | null {\n    const original = this.event._event_original ?? this.event\n\n    if (this.handler.handler_slow_timeout !== undefined) {\n      return this.handler.handler_slow_timeout\n    }\n    if (original.event_handler_slow_timeout !== undefined) {\n      return original.event_handler_slow_timeout\n    }\n    const event_slow_timeout = (original as { event_slow_timeout?: number | null }).event_slow_timeout\n    if (event_slow_timeout !== undefined) {\n      return event_slow_timeout\n    }\n    if (this.bus?.event_handler_slow_timeout !== undefined) {\n      return this.bus.event_handler_slow_timeout\n    }\n    return this.bus?.event_slow_timeout ?? null\n  }\n\n  // Create a slow-handler warning timer that logs if the handler runs too long.\n  _createSlowHandlerWarningTimer(effective_timeout: number | null): ReturnType<typeof setTimeout> | null {\n    const handler_warn_timeout = this.handler_slow_timeout\n    const warn_ms = handler_warn_timeout === null ? null : handler_warn_timeout * 1000\n    const should_warn = warn_ms !== null && (effective_timeout === null || effective_timeout * 1000 > warn_ms)\n    if (!should_warn || warn_ms === null) {\n      return null\n    }\n    const event = this.event._event_original ?? this.event\n    const bus_name = this.handler.eventbus_name\n    const started_at_ms = performance.now()\n    return setTimeout(() => {\n      if (this.status !== 'started') {\n        return\n      }\n      const elapsed_ms = performance.now() - started_at_ms\n      const elapsed_seconds = (elapsed_ms / 1000).toFixed(1)\n      console.warn(\n        `[abxbus] Slow event handler: ${bus_name}.on(${event.toString()}, ${this.handler.toString()}) still running after ${elapsed_seconds}s`\n      )\n    }, warn_ms)\n  }\n\n  _ensureQueueJumpPause(bus: EventBus): void {\n    if (!this._queue_jump_pause_releases) {\n      this._queue_jump_pause_releases = new Map()\n    }\n    if (this._queue_jump_pause_releases.has(bus)) {\n      return\n    }\n    this._queue_jump_pause_releases.set(bus, bus.locks._requestRunloopPause())\n  }\n\n  _releaseQueueJumpPauses(): void {\n    if (!this._queue_jump_pause_releases) {\n      return\n    }\n    for (const release of this._queue_jump_pause_releases.values()) {\n      release()\n    }\n    this._queue_jump_pause_releases.clear()\n  }\n\n  update(params: { status?: EventResultStatus; result?: EventResultType<TEvent> | BaseEvent | undefined; error?: unknown }): this {\n    const has_status = 'status' in params\n    const has_result = 'result' in params\n    const has_error = 'error' in params\n\n    if (has_result) {\n      const raw_result = params.result\n      this.status = 'completed'\n      if (\n        this.event.event_result_type &&\n        raw_result !== undefined &&\n        !(raw_result instanceof BaseEvent) &&\n        isZodSchema(this.event.event_result_type)\n      ) {\n        const parsed = this.event.event_result_type.safeParse(raw_result)\n        if (parsed.success) {\n          this.result = parsed.data as EventResultType<TEvent>\n        } else {\n          const error = new EventHandlerResultSchemaError(\n            `Event handler return value ${JSON.stringify(raw_result).slice(0, 20)}... did not match event_result_type: ${parsed.error.message}`,\n            { event_result: this, cause: parsed.error, raw_value: raw_result }\n          )\n          this.error = error\n          this.result = undefined\n          this.status = 'error'\n        }\n      } else {\n        this.result = raw_result as EventResultType<TEvent> | undefined\n      }\n    }\n\n    if (has_error) {\n      this.error = params.error\n      this.status = 'error'\n    }\n\n    if (has_status && params.status !== undefined) {\n      this.status = params.status\n    }\n\n    if (this.status !== 'pending' && this.started_at === null) {\n      this.started_at = monotonicDatetime()\n    }\n    if ((this.status === 'completed' || this.status === 'error') && this.completed_at === null) {\n      this.completed_at = monotonicDatetime()\n    }\n\n    return this\n  }\n\n  private _createHandlerTimeoutError(event: BaseEvent): EventHandlerTimeoutError {\n    return new EventHandlerTimeoutError(\n      `${this.bus.toString()}.on(${event.toString()}, ${this.handler.toString()}) timed out after ${this.handler_timeout}s`,\n      {\n        event_result: this,\n        timeout_seconds: this.handler_timeout,\n      }\n    )\n  }\n\n  private _handleHandlerError(event: BaseEvent, error: unknown): void {\n    const normalized_error =\n      error instanceof RetryTimeoutError\n        ? new EventHandlerTimeoutError(error.message, { event_result: this, timeout_seconds: error.timeout_seconds, cause: error })\n        : error\n    if (normalized_error instanceof EventHandlerTimeoutError) {\n      this._markError(normalized_error, false)\n      event._cancelPendingChildProcessing(normalized_error)\n    } else {\n      this._markError(normalized_error, false)\n    }\n  }\n\n  private _onHandlerExit(slow_handler_warning_timer: ReturnType<typeof setTimeout> | null): void {\n    this._abort = null\n    this._lock = null\n    this._releaseQueueJumpPauses()\n    if (slow_handler_warning_timer) {\n      clearTimeout(slow_handler_warning_timer)\n    }\n  }\n\n  // Run one handler invocation with timeout/slow-monitor/error handling.\n  // Handler lock acquisition is owned by BaseEvent._runHandlers(...).\n  async runHandler(handler_lock: HandlerLock | null): Promise<void> {\n    if (this.status === 'error' && this.error instanceof EventHandlerCancelledError) {\n      return\n    }\n\n    const event = this.event._event_original ?? this.event\n    const handler_event = this.bus._getEventProxyScopedToThisBus(event, this)\n    if (this._lock) {\n      this._lock.exitHandlerRun()\n    }\n\n    let slow_handler_warning_timer: ReturnType<typeof setTimeout> | null = null\n    // if the result is already in an error or completed state, exit early\n    if (this.status === 'error' || this.status === 'completed') {\n      return\n    }\n\n    this._lock = handler_lock\n    await this.bus.locks._runWithHandlerDispatchContext(this, async () => {\n      await _runWithAsyncContext(event._getDispatchContext() ?? null, async () => {\n        try {\n          const should_notify_started = this.status === 'pending'\n          const abort_signal = this._markStarted(false)\n          if (should_notify_started) {\n            await this._notifyStatusHook('started')\n          }\n          slow_handler_warning_timer = this._createSlowHandlerWarningTimer(this.handler_timeout)\n          const handler_result = await _runWithTimeout(\n            this.handler_timeout,\n            () => this._createHandlerTimeoutError(event),\n            () =>\n              _runWithSlowMonitor(slow_handler_warning_timer, () =>\n                _runWithAbortMonitor(() => this.handler._handler_async(handler_event), abort_signal)\n              )\n          )\n          this._markCompleted(handler_result as EventResultType<TEvent> | BaseEvent | undefined, false)\n        } catch (error) {\n          this._handleHandlerError(event, error)\n        } finally {\n          if (this.status === 'completed' || this.status === 'error') {\n            await this._notifyStatusHook('completed')\n          }\n          this._onHandlerExit(slow_handler_warning_timer)\n        }\n      })\n    })\n  }\n\n  // Reject the abort promise, causing runHandler's Promise.race to\n  // throw immediately \u2014 even if the handler has no timeout.\n  _signalAbort(error: Error): void {\n    if (this._abort) {\n      this._abort.reject(error)\n      this._abort = null\n    }\n  }\n\n  // Mark started and return the abort promise for Promise.race.\n  _markStarted(notify_hook: boolean = true): Promise<never> {\n    if (!this._abort) {\n      this._abort = withResolvers<never>()\n    }\n    if (this.status === 'pending') {\n      this.update({ status: 'started' })\n      if (notify_hook) {\n        void this._notifyStatusHook('started')\n      }\n    }\n    return this._abort.promise\n  }\n\n  _markCompleted(result: EventResultType<TEvent> | BaseEvent | undefined, notify_hook: boolean = true): void {\n    if (this.status === 'completed' || this.status === 'error') return\n    this.update({ result })\n    if (notify_hook) {\n      void this._notifyStatusHook('completed')\n    }\n  }\n\n  _markError(error: unknown, notify_hook: boolean = true): void {\n    if (this.status === 'completed' || this.status === 'error') return\n    this.update({ error })\n    if (notify_hook) {\n      void this._notifyStatusHook('completed')\n    }\n  }\n\n  toJSON(): EventResultJSON {\n    return {\n      id: this.id,\n      status: this.status,\n      event_id: this.event.event_id,\n      handler_id: this.handler_id,\n      handler_name: this.handler_name,\n      handler_file_path: this.handler_file_path,\n      handler_timeout: this.handler.handler_timeout,\n      handler_slow_timeout: this.handler.handler_slow_timeout,\n      handler_registered_at: this.handler.handler_registered_at,\n      handler_event_pattern: this.handler.event_pattern,\n      eventbus_name: this.eventbus_name,\n      eventbus_id: this.eventbus_id,\n      started_at: this.started_at,\n      completed_at: this.completed_at,\n      result: this.result,\n      error: this.error,\n      event_children: this.event_children.map((child) => child.event_id),\n    }\n  }\n\n  static fromJSON<TEvent extends BaseEvent>(event: TEvent, data: unknown): EventResult<TEvent> {\n    const record = EventResultJSONSchema.parse(data)\n    const handler_record = {\n      id: record.handler_id,\n      eventbus_name: record.eventbus_name,\n      eventbus_id: record.eventbus_id,\n      event_pattern: record.handler_event_pattern ?? event.event_type,\n      handler_name: record.handler_name,\n      handler_file_path: record.handler_file_path ?? null,\n      handler_timeout: record.handler_timeout,\n      handler_slow_timeout: record.handler_slow_timeout,\n      handler_registered_at: record.handler_registered_at ?? event.event_created_at,\n    } as const\n    const handler_stub = EventHandler.fromJSON(handler_record, (() => undefined) as EventHandlerCallable)\n\n    const result = new EventResult<TEvent>({ event, handler: handler_stub })\n    result.id = record.id\n    result.status = record.status\n    result.started_at = record.started_at === null || record.started_at === undefined ? null : monotonicDatetime(record.started_at)\n    result.completed_at = record.completed_at === null || record.completed_at === undefined ? null : monotonicDatetime(record.completed_at)\n    if ('result' in record) {\n      result.result = record.result as EventResultType<TEvent>\n    }\n    if ('error' in record) {\n      result.error = record.error\n    }\n    result.event_children = []\n    return result\n  }\n}\n"],
+  "mappings": "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",
+  "names": ["uuidv7"]
+}

package/dist/cjs/events_suck.d.ts

@@ -0,0 +1,40 @@
+import { EventBus } from './event_bus.js';
+import { BaseEvent } from './base_event.js';
+import type { EventClass, EventResultType } from './types.js';
+type EventMap = Record<string, EventClass<BaseEvent>>;
+type AnyFn = (...args: any[]) => any;
+type FunctionMap = Record<string, AnyFn>;
+type ExtraDict = Record<string, unknown>;
+type EventFieldsFromFn<TFunc extends AnyFn> = Parameters<TFunc> extends [infer TArg] ? (TArg extends Record<string, unknown> ? TArg : ExtraDict) : ExtraDict;
+type GeneratedEvent<TFunc extends AnyFn> = {
+    (data: EventFieldsFromFn<TFunc> & ExtraDict): BaseEvent & EventFieldsFromFn<TFunc> & {
+        __event_result_type__?: Awaited<ReturnType<TFunc>>;
+    };
+    new (data: EventFieldsFromFn<TFunc> & ExtraDict): BaseEvent & EventFieldsFromFn<TFunc> & {
+        __event_result_type__?: Awaited<ReturnType<TFunc>>;
+    };
+    event_type?: string;
+};
+export type GeneratedEvents<TEvents extends FunctionMap> = {
+    by_name: {
+        [K in keyof TEvents]: GeneratedEvent<TEvents[K]>;
+    };
+} & {
+    [K in keyof TEvents]: GeneratedEvent<TEvents[K]>;
+};
+type EventInit<TEventClass extends EventClass<BaseEvent>> = ConstructorParameters<TEventClass> extends [infer TInit, ...unknown[]] ? TInit : never;
+type EventMethodArgs<TEventClass extends EventClass<BaseEvent>> = {} extends EventInit<TEventClass> ? [init?: EventInit<TEventClass>, extra?: Record<string, unknown>] : [init: EventInit<TEventClass>, extra?: Record<string, unknown>];
+type EventMethodResult<TEventClass extends EventClass<BaseEvent>> = EventResultType<InstanceType<TEventClass>> | undefined;
+export type EventsSuckClient<TEvents extends EventMap> = {
+    bus: EventBus;
+} & {
+    [K in keyof TEvents]: (...args: EventMethodArgs<TEvents[K]>) => Promise<EventMethodResult<TEvents[K]>>;
+};
+export type EventsSuckClientClass<TEvents extends EventMap> = new (bus?: EventBus) => EventsSuckClient<TEvents>;
+export declare const make_events: <TEvents extends FunctionMap>(events: TEvents) => GeneratedEvents<TEvents>;
+export declare const wrap: <TEvents extends EventMap>(class_name: string, methods: TEvents) => EventsSuckClientClass<TEvents>;
+export declare const events_suck: {
+    readonly make_events: <TEvents extends FunctionMap>(events: TEvents) => GeneratedEvents<TEvents>;
+    readonly wrap: <TEvents extends EventMap>(class_name: string, methods: TEvents) => EventsSuckClientClass<TEvents>;
+};
+export {};

package/dist/cjs/events_suck.js

@@ -0,0 +1,59 @@
+"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 events_suck_exports = {};
+__export(events_suck_exports, {
+  events_suck: () => events_suck,
+  make_events: () => make_events,
+  wrap: () => wrap
+});
+module.exports = __toCommonJS(events_suck_exports);
+var import_event_bus = require("./event_bus.js");
+var import_base_event = require("./base_event.js");
+const make_events = (events) => {
+  const by_name = {};
+  for (const [event_name] of Object.entries(events)) {
+    if (!/^[A-Za-z_$][\w$]*$/.test(String(event_name))) {
+      throw new Error(`Invalid event name: ${String(event_name)}`);
+    }
+    by_name[event_name] = import_base_event.BaseEvent.extend(String(event_name), {});
+  }
+  return Object.assign({ by_name }, by_name);
+};
+const wrap = (class_name, methods) => {
+  class WrappedClient {
+    bus;
+    constructor(bus) {
+      this.bus = bus ?? new import_event_bus.EventBus(`${class_name}Bus`);
+    }
+  }
+  Object.defineProperty(WrappedClient, "name", { value: class_name });
+  for (const [method_name, EventCtor] of Object.entries(methods)) {
+    Object.defineProperty(WrappedClient.prototype, method_name, {
+      value: async function(init, extra) {
+        const payload = { ...init ?? {}, ...extra ?? {} };
+        return await this.bus.emit(new EventCtor(payload)).first();
+      },
+      writable: true,
+      configurable: true
+    });
+  }
+  return WrappedClient;
+};
+const events_suck = { make_events, wrap };
+//# sourceMappingURL=events_suck.js.map

package/dist/cjs/events_suck.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/events_suck.ts"],
+  "sourcesContent": ["import { EventBus } from './event_bus.js'\nimport { BaseEvent } from './base_event.js'\n\nimport type { EventClass, EventResultType } from './types.js'\n\ntype EventMap = Record<string, EventClass<BaseEvent>>\ntype AnyFn = (...args: any[]) => any\ntype FunctionMap = Record<string, AnyFn>\ntype ExtraDict = Record<string, unknown>\n\ntype EventFieldsFromFn<TFunc extends AnyFn> =\n  Parameters<TFunc> extends [infer TArg] ? (TArg extends Record<string, unknown> ? TArg : ExtraDict) : ExtraDict\n\ntype GeneratedEvent<TFunc extends AnyFn> = {\n  (\n    data: EventFieldsFromFn<TFunc> & ExtraDict\n  ): BaseEvent & EventFieldsFromFn<TFunc> & { __event_result_type__?: Awaited<ReturnType<TFunc>> }\n  new (\n    data: EventFieldsFromFn<TFunc> & ExtraDict\n  ): BaseEvent & EventFieldsFromFn<TFunc> & { __event_result_type__?: Awaited<ReturnType<TFunc>> }\n  event_type?: string\n}\n\nexport type GeneratedEvents<TEvents extends FunctionMap> = {\n  by_name: { [K in keyof TEvents]: GeneratedEvent<TEvents[K]> }\n} & {\n  [K in keyof TEvents]: GeneratedEvent<TEvents[K]>\n}\n\ntype EventInit<TEventClass extends EventClass<BaseEvent>> =\n  ConstructorParameters<TEventClass> extends [infer TInit, ...unknown[]] ? TInit : never\n\ntype EventMethodArgs<TEventClass extends EventClass<BaseEvent>> =\n  {} extends EventInit<TEventClass>\n    ? [init?: EventInit<TEventClass>, extra?: Record<string, unknown>]\n    : [init: EventInit<TEventClass>, extra?: Record<string, unknown>]\n\ntype EventMethodResult<TEventClass extends EventClass<BaseEvent>> = EventResultType<InstanceType<TEventClass>> | undefined\n\nexport type EventsSuckClient<TEvents extends EventMap> = {\n  bus: EventBus\n} & {\n  [K in keyof TEvents]: (...args: EventMethodArgs<TEvents[K]>) => Promise<EventMethodResult<TEvents[K]>>\n}\n\nexport type EventsSuckClientClass<TEvents extends EventMap> = new (bus?: EventBus) => EventsSuckClient<TEvents>\n\ntype DynamicWrappedClient = {\n  bus: EventBus\n} & Record<string, (...args: unknown[]) => Promise<unknown>>\n\nexport const make_events = <TEvents extends FunctionMap>(events: TEvents): GeneratedEvents<TEvents> => {\n  const by_name = {} as { [K in keyof TEvents]: GeneratedEvent<TEvents[K]> }\n  for (const [event_name] of Object.entries(events) as Array<[keyof TEvents, TEvents[keyof TEvents]]>) {\n    if (!/^[A-Za-z_$][\\w$]*$/.test(String(event_name))) {\n      throw new Error(`Invalid event name: ${String(event_name)}`)\n    }\n    by_name[event_name] = BaseEvent.extend(String(event_name), {}) as unknown as GeneratedEvent<TEvents[keyof TEvents]>\n  }\n  return Object.assign({ by_name }, by_name) as GeneratedEvents<TEvents>\n}\n\nexport const wrap = <TEvents extends EventMap>(class_name: string, methods: TEvents): EventsSuckClientClass<TEvents> => {\n  class WrappedClient {\n    bus: EventBus\n\n    constructor(bus?: EventBus) {\n      this.bus = bus ?? new EventBus(`${class_name}Bus`)\n    }\n  }\n\n  Object.defineProperty(WrappedClient, 'name', { value: class_name })\n\n  for (const [method_name, EventCtor] of Object.entries(methods)) {\n    Object.defineProperty(WrappedClient.prototype, method_name, {\n      value: async function (this: DynamicWrappedClient, init?: Record<string, unknown>, extra?: Record<string, unknown>) {\n        const payload = { ...(init ?? {}), ...(extra ?? {}) }\n        return await this.bus.emit(new EventCtor(payload)).first()\n      },\n      writable: true,\n      configurable: true,\n    })\n  }\n\n  return WrappedClient as unknown as EventsSuckClientClass<TEvents>\n}\n\n// Intentionally no make_event()/make_handler() helpers in TypeScript.\n// Prefer the explicit inline pattern:\n//   const FooCreateEvent = BaseEvent.extend('FooCreateEvent', {\n//     id: z.string().nullable().optional(),\n//     name: z.string(),\n//     age: z.number(),\n//   })\n//   bus.on(FooCreateEvent, ({ id, name, age, ...extra }) => impl.create(id, { name, age }))\nexport const events_suck = { make_events, wrap } as const\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,uBAAyB;AACzB,wBAA0B;AAkDnB,MAAM,cAAc,CAA8B,WAA8C;AACrG,QAAM,UAAU,CAAC;AACjB,aAAW,CAAC,UAAU,KAAK,OAAO,QAAQ,MAAM,GAAqD;AACnG,QAAI,CAAC,qBAAqB,KAAK,OAAO,UAAU,CAAC,GAAG;AAClD,YAAM,IAAI,MAAM,uBAAuB,OAAO,UAAU,CAAC,EAAE;AAAA,IAC7D;AACA,YAAQ,UAAU,IAAI,4BAAU,OAAO,OAAO,UAAU,GAAG,CAAC,CAAC;AAAA,EAC/D;AACA,SAAO,OAAO,OAAO,EAAE,QAAQ,GAAG,OAAO;AAC3C;AAEO,MAAM,OAAO,CAA2B,YAAoB,YAAqD;AAAA,EACtH,MAAM,cAAc;AAAA,IAClB;AAAA,IAEA,YAAY,KAAgB;AAC1B,WAAK,MAAM,OAAO,IAAI,0BAAS,GAAG,UAAU,KAAK;AAAA,IACnD;AAAA,EACF;AAEA,SAAO,eAAe,eAAe,QAAQ,EAAE,OAAO,WAAW,CAAC;AAElE,aAAW,CAAC,aAAa,SAAS,KAAK,OAAO,QAAQ,OAAO,GAAG;AAC9D,WAAO,eAAe,cAAc,WAAW,aAAa;AAAA,MAC1D,OAAO,eAA4C,MAAgC,OAAiC;AAClH,cAAM,UAAU,EAAE,GAAI,QAAQ,CAAC,GAAI,GAAI,SAAS,CAAC,EAAG;AACpD,eAAO,MAAM,KAAK,IAAI,KAAK,IAAI,UAAU,OAAO,CAAC,EAAE,MAAM;AAAA,MAC3D;AAAA,MACA,UAAU;AAAA,MACV,cAAc;AAAA,IAChB,CAAC;AAAA,EACH;AAEA,SAAO;AACT;AAUO,MAAM,cAAc,EAAE,aAAa,KAAK;",
+  "names": []
+}

package/dist/cjs/helpers.d.ts

@@ -0,0 +1 @@
+export declare function monotonicDatetime(isostring?: string): string;