@holo-js/events 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -46,6 +46,9 @@ interface ListenerDefinition<TInput extends EventReferenceInput = EventReference
     readonly afterCommit?: boolean;
     handle(event: ListenerHandledEvent<TInput>): TResult | Promise<TResult>;
 }
+type ListenerDefinitionInput<TInput extends EventReferenceInput = EventReferenceInput, TResult = unknown> = Omit<ListenerDefinition<TInput, TResult>, 'listensTo'> & {
+    readonly listensTo: TInput;
+};
 interface RegisteredListener<TInput extends EventReferenceInput = EventReferenceInput, TResult = unknown> {
     readonly id: string;
     readonly sourcePath?: string;
@@ -107,8 +110,8 @@ declare function normalizeEventDefinition<TEvent extends EventDefinition>(event:
 declare function defineEvent<TPayload, TName extends string | undefined = string | undefined>(event: EventDefinition<TPayload, TName>): EventDefinition<TPayload, TName>;
 declare function normalizeListensTo<TInput extends EventReferenceInput>(input: TInput): NormalizeEventReferenceInput<TInput>;
 declare function isListenerDefinition(value: unknown): value is ListenerDefinition;
-declare function normalizeListenerDefinition<TInput extends EventReferenceInput, TListener extends ListenerDefinition<TInput>>(listener: TListener): TListener;
-declare function defineListener<TInput extends EventReferenceInput, TListener extends ListenerDefinition<TInput>>(listener: TListener): TListener;
+declare function normalizeListenerDefinition<TInput extends EventReferenceInput, TResult>(listener: ListenerDefinitionInput<TInput, TResult>): ListenerDefinition<TInput, TResult>;
+declare function defineListener<TInput extends EventReferenceInput, TResult>(listener: ListenerDefinitionInput<TInput, TResult>): ListenerDefinition<TInput, TResult>;
 declare const eventInternals: {
     hasEventDefinitionMarker: typeof hasEventDefinitionMarker;
     hasListenerDefinitionMarker: typeof hasListenerDefinitionMarker;
@@ -138,7 +141,7 @@ declare function deriveListenerIdFromSourcePath(sourcePath: string): string;
 declare function resolveRegisteredEventName(definition: EventDefinition, options?: RegisterEventOptions): string;
 declare function resolveRegisteredListenerId(definition: ListenerDefinition, options?: RegisterListenerOptions): string;
 declare function resolveListenerEventNames(definition: ListenerDefinition, state: EventRegistryState): readonly string[];
-declare function registerEvent<TPayload, TName extends string = string>(definition: EventDefinition<TPayload, TName>, options?: RegisterEventOptions): RegisteredEvent<TPayload, TName>;
+declare function registerEvent<TPayload, TName extends string | undefined = string | undefined>(definition: EventDefinition<TPayload, TName>, options?: RegisterEventOptions): RegisteredEvent<TPayload, Extract<TName, string> extends never ? string : Extract<TName, string>>;
 declare function registerEvents(definitions: ReadonlyArray<{
     readonly definition: EventDefinition;
     readonly options?: RegisterEventOptions;
@@ -183,14 +186,31 @@ declare module '@holo-js/queue' {
         'holo.events.invoke-listener': QueueJobDefinition<EventsInvokeListenerPayload, void>;
     }
 }
+type QueueModule = {
+    defineJob(definition: QueueJobDefinition<EventsInvokeListenerPayload, void>): QueueJobDefinition<EventsInvokeListenerPayload, void>;
+    dispatch(jobName: string, payload: EventsInvokeListenerPayload): QueuePendingDispatchChain;
+    getRegisteredQueueJob(name: string): unknown;
+    registerQueueJob(definition: QueueJobDefinition<EventsInvokeListenerPayload, void>, options: {
+        name: string;
+    }): void;
+};
+type QueuePendingDispatchChain = {
+    onConnection(name: string): QueuePendingDispatchChain;
+    onQueue(name: string): QueuePendingDispatchChain;
+    delay(value: number | Date): QueuePendingDispatchChain;
+    dispatch(): Promise<unknown>;
+};
+declare function loadQueueModule(): Promise<QueueModule>;
 declare function createQueuedListenerEventEnvelope(payload: EventsInvokeListenerPayload): EventEnvelope<string, QueueJsonValue>;
 declare function requireQueuedListener(listenerId: string): RegisteredListener;
 declare function assertQueuedListenerMatchesEvent(listener: RegisteredListener, eventName: string): void;
 declare function runQueuedListenerInvocation(payload: EventsInvokeListenerPayload): Promise<void>;
 declare function ensureEventsQueueJobRegistered(): void;
+declare function ensureEventsQueueJobRegisteredAsync(): Promise<void>;
 declare const eventQueueInternals: {
     assertQueuedListenerMatchesEvent: typeof assertQueuedListenerMatchesEvent;
     createQueuedListenerEventEnvelope: typeof createQueuedListenerEventEnvelope;
+    loadQueueModule: typeof loadQueueModule;
     requireQueuedListener: typeof requireQueuedListener;
 };
 
@@ -264,4 +284,4 @@ declare const eventRuntimeInternals: {
     validateQueuedEventPayload: typeof validateQueuedEventPayload;
 };
 
-export { EVENTS_INVOKE_LISTENER_JOB, Event, type EventDeferredDispatchContext, type EventDefinition, type EventDelayValue, type EventDispatchResult, type EventEnvelope, type EventEnvelopeFor, type EventFacade, type EventPayloadFor, type EventPendingDispatch, type EventQueuedListenerDispatch, type EventReference, type EventReferenceInput, type EventRuntimeBinding, type EventRuntimeHooks, type EventsInvokeListenerPayload, type ExportedEventDefinition, type HoloEventRegistry, type HoloListenerRegistry, type ListenerDefinition, type ListenerHandledEvent, type RegisterEventOptions, type RegisterListenerOptions, type RegisteredEvent, type RegisteredListener, configureEventsRuntime, deferEventDispatchToDatabaseCommit, defineEvent, defineListener, dispatchEvent, ensureEventsQueueJobRegistered, eventInternals, eventQueueInternals, eventRegistryInternals, eventRuntimeInternals, getEventsRuntime, getRegisteredEvent, getRegisteredListener, isEventDefinition, isListenerDefinition, listRegisteredEvents, listRegisteredListeners, listRegisteredListenersForEvent, normalizeEventDefinition, normalizeListenerDefinition, registerEvent, registerEvents, registerListener, registerListeners, resetEventRegistry, resetEventsRegistry, resetEventsRuntime, resetListenerRegistry, runQueuedListenerInvocation, unregisterEvent, unregisterListener };
+export { EVENTS_INVOKE_LISTENER_JOB, Event, type EventDeferredDispatchContext, type EventDefinition, type EventDelayValue, type EventDispatchResult, type EventEnvelope, type EventEnvelopeFor, type EventFacade, type EventPayloadFor, type EventPendingDispatch, type EventQueuedListenerDispatch, type EventReference, type EventReferenceInput, type EventRuntimeBinding, type EventRuntimeHooks, type EventsInvokeListenerPayload, type ExportedEventDefinition, type HoloEventRegistry, type HoloListenerRegistry, type ListenerDefinition, type ListenerDefinitionInput, type ListenerHandledEvent, type RegisterEventOptions, type RegisterListenerOptions, type RegisteredEvent, type RegisteredListener, configureEventsRuntime, deferEventDispatchToDatabaseCommit, defineEvent, defineListener, dispatchEvent, ensureEventsQueueJobRegistered, ensureEventsQueueJobRegisteredAsync, eventInternals, eventQueueInternals, eventRegistryInternals, eventRuntimeInternals, getEventsRuntime, getRegisteredEvent, getRegisteredListener, isEventDefinition, isListenerDefinition, listRegisteredEvents, listRegisteredListeners, listRegisteredListenersForEvent, normalizeEventDefinition, normalizeListenerDefinition, registerEvent, registerEvents, registerListener, registerListeners, resetEventRegistry, resetEventsRegistry, resetEventsRuntime, resetListenerRegistry, runQueuedListenerInvocation, unregisterEvent, unregisterListener };

package/dist/index.mjs

@@ -376,13 +376,25 @@ function deferEventDispatchToDatabaseCommit(callback, _context) {
 }
 
 // src/queue.ts
-import {
-  defineJob,
-  dispatch as dispatchQueueJob,
-  getRegisteredQueueJob,
-  registerQueueJob
-} from "@holo-js/queue";
 var EVENTS_INVOKE_LISTENER_JOB = "holo.events.invoke-listener";
+function getQueueRegistryState() {
+  const runtime = globalThis;
+  runtime.__holoQueueRegistry__ ??= {
+    jobs: /* @__PURE__ */ new Map()
+  };
+  return runtime.__holoQueueRegistry__;
+}
+async function loadQueueModule() {
+  try {
+    const specifier = "@holo-js/queue";
+    return await import(specifier);
+  } catch (error) {
+    if (error && typeof error === "object" && "code" in error && error.code === "ERR_MODULE_NOT_FOUND") {
+      throw new Error("[@holo-js/events] Queued listeners require @holo-js/queue to be installed.");
+    }
+    throw error;
+  }
+}
 function createQueuedListenerEventEnvelope(payload) {
   return Object.freeze({
     name: payload.eventName,
@@ -410,20 +422,27 @@ async function runQueuedListenerInvocation(payload) {
   await listener.definition.handle(createQueuedListenerEventEnvelope(payload));
 }
 function ensureEventsQueueJobRegistered() {
-  if (getRegisteredQueueJob(EVENTS_INVOKE_LISTENER_JOB)) {
+  const registry = getQueueRegistryState().jobs;
+  if (registry.has(EVENTS_INVOKE_LISTENER_JOB)) {
     return;
   }
-  registerQueueJob(defineJob({
-    async handle(payload) {
-      await runQueuedListenerInvocation(payload);
-    }
-  }), {
-    name: EVENTS_INVOKE_LISTENER_JOB
-  });
+  registry.set(EVENTS_INVOKE_LISTENER_JOB, Object.freeze({
+    name: EVENTS_INVOKE_LISTENER_JOB,
+    definition: Object.freeze({
+      async handle(payload) {
+        await runQueuedListenerInvocation(payload);
+      }
+    })
+  }));
 }
-async function dispatchQueuedListenerViaQueue(dispatch) {
+async function ensureEventsQueueJobRegisteredAsync() {
+  await loadQueueModule();
   ensureEventsQueueJobRegistered();
-  let pending = dispatchQueueJob(EVENTS_INVOKE_LISTENER_JOB, {
+}
+async function dispatchQueuedListenerViaQueue(dispatch) {
+  const queueModule = await loadQueueModule();
+  await ensureEventsQueueJobRegisteredAsync();
+  let pending = queueModule.dispatch(EVENTS_INVOKE_LISTENER_JOB, {
     listenerId: dispatch.listenerId,
     eventName: dispatch.event.name,
     occurredAt: dispatch.event.occurredAt,
@@ -443,6 +462,7 @@ async function dispatchQueuedListenerViaQueue(dispatch) {
 var eventQueueInternals = {
   assertQueuedListenerMatchesEvent,
   createQueuedListenerEventEnvelope,
+  loadQueueModule,
   requireQueuedListener
 };
 
@@ -784,6 +804,7 @@ export {
   defineListener,
   dispatchEvent,
   ensureEventsQueueJobRegistered,
+  ensureEventsQueueJobRegisteredAsync,
   eventInternals,
   eventQueueInternals,
   eventRegistryInternals,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/events",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Holo-JS Framework - event contracts and runtime surface",
   "type": "module",
   "license": "MIT",
@@ -23,8 +23,15 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/db": "^0.1.2",
-    "@holo-js/queue": "^0.1.2"
+    "@holo-js/db": "^0.1.3"
+  },
+  "peerDependencies": {
+    "@holo-js/queue": "^0.1.3"
+  },
+  "peerDependenciesMeta": {
+    "@holo-js/queue": {
+      "optional": true
+    }
   },
   "devDependencies": {
     "@types/node": "^22.10.2",