@holo-js/events 0.2.4 → 0.2.5

package/dist/index.d.ts

@@ -1,6 +1,8 @@
 import { QueueJobDefinition, QueueJsonValue } from '@holo-js/queue';
 
 type EventDelayValue = number | Date;
+type EventDefinitionDispatcher = <TPayload>(event: EventDefinition<TPayload, string | undefined>, payload: TPayload) => EventPendingDispatch<TPayload>;
+declare function setEventDefinitionDispatcher(dispatcher: EventDefinitionDispatcher): void;
 declare function normalizeOptionalString(value: unknown, label: string): string | undefined;
 declare function normalizeOptionalBoolean(value: boolean | undefined, label: string): boolean | undefined;
 declare function normalizeOptionalDelay(value: EventDelayValue | undefined): EventDelayValue | undefined;
@@ -14,6 +16,9 @@ interface EventDefinition<TPayload = unknown, TName extends string | undefined =
     readonly name?: TName;
     readonly __payloadType?: TPayload;
 }
+interface DefinedEventDefinition<TPayload = unknown, TName extends string | undefined = string | undefined> extends EventDefinition<TPayload, TName> {
+    dispatch(payload: TPayload): EventPendingDispatch<TPayload>;
+}
 interface RegisteredEvent<TPayload = unknown, TName extends string = string> {
     readonly name: TName;
     readonly sourcePath?: string;
@@ -108,7 +113,7 @@ interface EventFacade {
 }
 declare function isEventDefinition(value: unknown): value is EventDefinition;
 declare function normalizeEventDefinition<TEvent extends EventDefinition>(event: TEvent): TEvent;
-declare function defineEvent<TPayload, TName extends string | undefined = string | undefined>(event: EventDefinition<TPayload, TName>): EventDefinition<TPayload, TName>;
+declare function defineEvent<TPayload, TName extends string | undefined = string | undefined>(event: EventDefinition<TPayload, TName>): DefinedEventDefinition<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, TResult>(listener: ListenerDefinitionInput<TInput, TResult>): ListenerDefinition<TInput, TResult>;
@@ -123,6 +128,7 @@ declare const eventInternals: {
     normalizeOptionalBoolean: typeof normalizeOptionalBoolean;
     normalizeOptionalDelay: typeof normalizeOptionalDelay;
     normalizeOptionalString: typeof normalizeOptionalString;
+    setEventDefinitionDispatcher: typeof setEventDefinitionDispatcher;
     normalizeListensTo: typeof normalizeListensTo;
     normalizeListenerDefinition: typeof normalizeListenerDefinition;
     toPosixPath: typeof toPosixPath;
@@ -286,4 +292,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 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 };
+export { type DefinedEventDefinition, 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

@@ -1,6 +1,20 @@
 // src/contracts.ts
 var HOLO_EVENT_DEFINITION_MARKER = /* @__PURE__ */ Symbol.for("holo-js.events.definition");
 var HOLO_LISTENER_DEFINITION_MARKER = /* @__PURE__ */ Symbol.for("holo-js.events.listener");
+function getEventDefinitionDispatcher() {
+  return globalThis.__holoEventDefinitionDispatcher__;
+}
+function setEventDefinitionDispatcher(dispatcher) {
+  const runtime = globalThis;
+  runtime.__holoEventDefinitionDispatcher__ = dispatcher;
+}
+function dispatchDefinedEvent(event, payload) {
+  const dispatcher = getEventDefinitionDispatcher();
+  if (!dispatcher) {
+    throw new Error("[Holo Events] Event definitions cannot dispatch before the events runtime is loaded.");
+  }
+  return dispatcher(event, payload);
+}
 function normalizeOptionalString(value, label) {
   if (typeof value === "undefined") {
     return void 0;
@@ -85,6 +99,12 @@ function defineEvent(event) {
     value: true,
     enumerable: false
   });
+  Object.defineProperty(normalized, "dispatch", {
+    value(payload) {
+      return dispatchDefinedEvent(normalized, payload);
+    },
+    enumerable: false
+  });
   return Object.freeze(normalized);
 }
 function normalizeEventReference(value, index) {
@@ -157,6 +177,7 @@ var eventInternals = {
   normalizeOptionalBoolean,
   normalizeOptionalDelay,
   normalizeOptionalString,
+  setEventDefinitionDispatcher,
   normalizeListensTo,
   normalizeListenerDefinition,
   toPosixPath
@@ -788,6 +809,7 @@ function resetEventsRuntime() {
 function dispatchEvent(event, payload) {
   return new PendingEventDispatch(event, payload);
 }
+eventInternals.setEventDefinitionDispatcher(dispatchEvent);
 var Event = {
   dispatch: dispatchEvent
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@holo-js/events",
-  "version": "0.2.4",
+  "version": "0.2.5",
   "description": "Holo-JS Framework - event contracts and runtime surface",
   "type": "module",
   "license": "MIT",
@@ -23,10 +23,10 @@
     "test": "vitest --run"
   },
   "dependencies": {
-    "@holo-js/db": "^0.2.4"
+    "@holo-js/db": "^0.2.5"
   },
   "peerDependencies": {
-    "@holo-js/queue": "^0.2.4"
+    "@holo-js/queue": "^0.2.5"
   },
   "peerDependenciesMeta": {
     "@holo-js/queue": {
@@ -34,7 +34,7 @@
     }
   },
   "devDependencies": {
-    "@holo-js/queue": "^0.2.4",
+    "@holo-js/queue": "^0.2.5",
     "@types/node": "^22.10.2",
     "tsup": "^8.3.5",
     "typescript": "^5.7.2",