@l-etabli/events 0.5.0 → 0.6.0

package/dist/createNewEvent.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/createNewEvent.ts"],"sourcesContent":["import type { DefaultContext, EventId, GenericEvent, UserId } from './types.mjs';\n\ntype MakeCreateNewEventOptions = {\n  getNow?: () => Date;\n  generateId?: () => EventId;\n};\n\ntype ContextParam<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Topic extends Event[\"topic\"],\n> = Extract<Event, { topic: Topic }>[\"context\"] extends undefined\n  ? { context?: undefined }\n  : { context: Extract<Event, { topic: Topic }>[\"context\"] };\n\ntype CreateNewEventParams<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Topic extends Event[\"topic\"],\n> = {\n  topic: Topic;\n  payload: Extract<Event, { topic: Topic }>[\"payload\"];\n  triggeredByUserId: UserId;\n  id?: EventId;\n  occurredAt?: Date;\n  priority?: number;\n} & ContextParam<Event, Topic>;\n\n/**\n * Creates a typed event creator factory for your event union.\n * Provides type-safe event creation where topic constrains payload type.\n *\n * @param options.getNow - Function to get current time (default: `() => new Date()`)\n * @param options.generateId - Function to generate event IDs (default: `() => crypto.randomUUID()`)\n *\n * @example\n * ```typescript\n * type MyEvents =\n *   | GenericEvent<\"UserCreated\", { email: string }>\n *   | GenericEvent<\"OrderPlaced\", { orderId: string }>;\n *\n * // Standalone usage:\n * const createEvent = makeCreateNewEvent<MyEvents>();\n *\n * // Or get it from createInMemoryEventBus (recommended):\n * const { eventBus, createEvent } = createInMemoryEventBus<MyEvents>(withUow);\n *\n * // Type-safe: payload must match topic\n * createEvent({ topic: \"UserCreated\", payload: { email: \"a@b.com\" }, triggeredByUserId: \"u1\" }); // OK\n * createEvent({ topic: \"UserCreated\", payload: { orderId: \"123\" }, triggeredByUserId: \"u1\" }); // Error!\n *\n * // For testing, inject deterministic functions:\n * const createEvent = makeCreateNewEvent<MyEvents>({\n *   getNow: () => new Date(\"2024-01-01\"),\n *   generateId: () => \"test-id\",\n * });\n * ```\n */\n\nexport type CreateNewEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n> = <Topic extends Event[\"topic\"]>(\n  params: CreateNewEventParams<Event, Topic>,\n) => Extract<Event, { topic: Topic }>;\n\nexport const makeCreateNewEvent = <\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n>(\n  options: MakeCreateNewEventOptions = {},\n): CreateNewEvent<Event> => {\n  const getNow = options.getNow ?? (() => new Date());\n  const generateId =\n    options.generateId ?? (() => crypto.randomUUID() as EventId);\n\n  return <Topic extends Event[\"topic\"]>(\n    params: CreateNewEventParams<Event, Topic>,\n  ): Extract<Event, { topic: Topic }> =>\n    ({\n      id: params.id ?? generateId(),\n      topic: params.topic,\n      payload: params.payload,\n      triggeredByUserId: params.triggeredByUserId,\n      occurredAt: params.occurredAt ?? getNow(),\n      status: \"never-published\",\n      publications: [],\n      priority: params.priority,\n      context: params.context,\n    }) as unknown as Extract<Event, { topic: Topic }>;\n};\n"],"mappings":"AA+DO,MAAM,qBAAqB,CAGhC,UAAqC,CAAC,MACZ;AAC1B,QAAM,SAAS,QAAQ,WAAW,MAAM,oBAAI,KAAK;AACjD,QAAM,aACJ,QAAQ,eAAe,MAAM,OAAO,WAAW;AAEjD,SAAO,CACL,YAEC;AAAA,IACC,IAAI,OAAO,MAAM,WAAW;AAAA,IAC5B,OAAO,OAAO;AAAA,IACd,SAAS,OAAO;AAAA,IAChB,mBAAmB,OAAO;AAAA,IAC1B,YAAY,OAAO,cAAc,OAAO;AAAA,IACxC,QAAQ;AAAA,IACR,cAAc,CAAC;AAAA,IACf,UAAU,OAAO;AAAA,IACjB,SAAS,OAAO;AAAA,EAClB;AACJ;","names":[]}
+{"version":3,"sources":["../src/createNewEvent.ts"],"sourcesContent":["import type {\n  EventDefinitions,\n  InferEventsFromDefinitions,\n} from './eventDefinitions.mjs';\nimport type { Actor, DefaultContext, EventId, GenericEvent } from './types.mjs';\n\ntype MakeCreateNewEventOptions = {\n  getNow?: () => Date;\n  generateId?: () => EventId;\n};\n\ntype MakeCreateNewEventFromDefinitionsOptions<\n  Definitions extends EventDefinitions,\n> = MakeCreateNewEventOptions & {\n  eventDefinitions: Definitions;\n};\n\ntype DeclaredContextForEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Topic extends Event[\"topic\"],\n> = Exclude<Extract<Event, { topic: Topic }>[\"context\"], undefined>;\n\ntype ContextParamForEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Topic extends Event[\"topic\"],\n> = [DeclaredContextForEvent<Event, Topic>] extends [never]\n  ? { context?: undefined }\n  : { context: DeclaredContextForEvent<Event, Topic> };\n\ntype BaseCreateNewEventParams = {\n  triggeredByActor: Actor;\n  id?: EventId;\n  occurredAt?: Date;\n  flowId?: string;\n  causedByEventId?: EventId;\n};\n\ntype CreateNewEventParams<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Topic extends Event[\"topic\"],\n> = BaseCreateNewEventParams & {\n  topic: Topic;\n  payload: Extract<Event, { topic: Topic }>[\"payload\"];\n  priority?: number;\n} & ContextParamForEvent<Event, Topic>;\n\ntype PayloadFromDefinitions<\n  Definitions extends EventDefinitions,\n  Topic extends keyof Definitions & string,\n> = Definitions[Topic] extends {\n  _payload?: infer Payload;\n}\n  ? Payload\n  : never;\n\ntype DeclaredContextFromDefinitions<\n  Definitions extends EventDefinitions,\n  Topic extends keyof Definitions & string,\n> = Exclude<\n  Definitions[Topic] extends { _context?: infer Context } ? Context : never,\n  undefined\n>;\n\ntype ContextParamFromDefinitions<\n  Definitions extends EventDefinitions,\n  Topic extends keyof Definitions & string,\n> = [DeclaredContextFromDefinitions<Definitions, Topic>] extends [never]\n  ? { context?: undefined }\n  : { context: DeclaredContextFromDefinitions<Definitions, Topic> };\n\ntype CreateNewEventParamsFromDefinitions<\n  Definitions extends EventDefinitions,\n  Topic extends keyof Definitions & string,\n> = BaseCreateNewEventParams & {\n  topic: Topic;\n  payload: PayloadFromDefinitions<Definitions, Topic>;\n} & ContextParamFromDefinitions<Definitions, Topic>;\n\n/**\n * Creates a typed event creator factory for your event union.\n * Provides type-safe event creation where topic constrains payload type.\n */\nexport type CreateNewEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n> = <Topic extends Event[\"topic\"]>(\n  params: CreateNewEventParams<Event, Topic>,\n) => Extract<Event, { topic: Topic }>;\n\n/**\n * Creates a typed event creator factory directly from event definitions.\n * Priority is injected from the canonical topic definition.\n */\nexport type CreateNewEventFromDefinitions<\n  Definitions extends EventDefinitions,\n> = <Topic extends keyof Definitions & string>(\n  params: CreateNewEventParamsFromDefinitions<Definitions, Topic>,\n) => Extract<InferEventsFromDefinitions<Definitions>, { topic: Topic }>;\n\nexport function makeCreateNewEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n>(options?: MakeCreateNewEventOptions): CreateNewEvent<Event>;\nexport function makeCreateNewEvent<Definitions extends EventDefinitions>(\n  options: MakeCreateNewEventFromDefinitionsOptions<Definitions>,\n): CreateNewEventFromDefinitions<Definitions>;\nexport function makeCreateNewEvent<\n  Event extends GenericEvent<string, unknown, DefaultContext>,\n  Definitions extends EventDefinitions,\n>(\n  options:\n    | MakeCreateNewEventOptions\n    | MakeCreateNewEventFromDefinitionsOptions<Definitions> = {},\n): CreateNewEvent<Event> | CreateNewEventFromDefinitions<Definitions> {\n  const getNow = options.getNow ?? (() => new Date());\n  const generateId =\n    options.generateId ?? (() => crypto.randomUUID() as EventId);\n  const eventDefinitions =\n    \"eventDefinitions\" in options ? options.eventDefinitions : undefined;\n\n  return ((params: {\n    topic: string;\n    payload: unknown;\n    triggeredByActor: Actor;\n    id?: EventId;\n    occurredAt?: Date;\n    flowId?: string;\n    causedByEventId?: EventId;\n    context?: DefaultContext;\n    priority?: number;\n  }) => {\n    const definitionPriority = eventDefinitions?.[params.topic]?.priority;\n    const priority =\n      definitionPriority ??\n      (\"priority\" in params\n        ? (params.priority as number | undefined)\n        : undefined);\n\n    return {\n      id: params.id ?? generateId(),\n      topic: params.topic,\n      payload: params.payload,\n      triggeredByActor: params.triggeredByActor,\n      occurredAt: params.occurredAt ?? getNow(),\n      status: \"never-published\",\n      publications: [],\n      ...(priority !== undefined ? { priority } : {}),\n      ...(params.context !== undefined ? { context: params.context } : {}),\n      ...(params.flowId !== undefined ? { flowId: params.flowId } : {}),\n      ...(params.causedByEventId !== undefined\n        ? { causedByEventId: params.causedByEventId }\n        : {}),\n    };\n  }) as unknown as\n    | CreateNewEvent<Event>\n    | CreateNewEventFromDefinitions<Definitions>;\n}\n"],"mappings":"AAwGO,SAAS,mBAId,UAE4D,CAAC,GACO;AACpE,QAAM,SAAS,QAAQ,WAAW,MAAM,oBAAI,KAAK;AACjD,QAAM,aACJ,QAAQ,eAAe,MAAM,OAAO,WAAW;AACjD,QAAM,mBACJ,sBAAsB,UAAU,QAAQ,mBAAmB;AAE7D,UAAQ,CAAC,WAUH;AACJ,UAAM,qBAAqB,mBAAmB,OAAO,KAAK,GAAG;AAC7D,UAAM,WACJ,uBACC,cAAc,SACV,OAAO,WACR;AAEN,WAAO;AAAA,MACL,IAAI,OAAO,MAAM,WAAW;AAAA,MAC5B,OAAO,OAAO;AAAA,MACd,SAAS,OAAO;AAAA,MAChB,kBAAkB,OAAO;AAAA,MACzB,YAAY,OAAO,cAAc,OAAO;AAAA,MACxC,QAAQ;AAAA,MACR,cAAc,CAAC;AAAA,MACf,GAAI,aAAa,SAAY,EAAE,SAAS,IAAI,CAAC;AAAA,MAC7C,GAAI,OAAO,YAAY,SAAY,EAAE,SAAS,OAAO,QAAQ,IAAI,CAAC;AAAA,MAClE,GAAI,OAAO,WAAW,SAAY,EAAE,QAAQ,OAAO,OAAO,IAAI,CAAC;AAAA,MAC/D,GAAI,OAAO,oBAAoB,SAC3B,EAAE,iBAAiB,OAAO,gBAAgB,IAC1C,CAAC;AAAA,IACP;AAAA,EACF;AAGF;","names":[]}

package/dist/eventDefinitions.cjs

@@ -0,0 +1,32 @@
+"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 eventDefinitions_exports = {};
+__export(eventDefinitions_exports, {
+  defineEvent: () => defineEvent,
+  defineEvents: () => defineEvents
+});
+module.exports = __toCommonJS(eventDefinitions_exports);
+const defineEvent = (options = {}) => options;
+const defineEvents = (definitions) => definitions;
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  defineEvent,
+  defineEvents
+});
+//# sourceMappingURL=eventDefinitions.cjs.map

package/dist/eventDefinitions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/eventDefinitions.ts"],"sourcesContent":["import type { DefaultContext, GenericEvent } from \"./types.ts\";\n\nexport type EventDefinition<\n  Payload,\n  Context extends DefaultContext = undefined,\n> = {\n  priority?: number;\n  _payload?: Payload;\n  _context?: Context;\n};\n\nexport type EventDefinitions = Record<\n  string,\n  EventDefinition<unknown, DefaultContext>\n>;\n\ntype PayloadFromDefinition<Definition> = Definition extends EventDefinition<\n  infer Payload,\n  DefaultContext\n>\n  ? Payload\n  : never;\n\ntype ContextFromDefinition<Definition> = Definition extends EventDefinition<\n  unknown,\n  infer Context\n>\n  ? Context\n  : never;\n\nexport type InferEventsFromDefinitions<Definitions extends EventDefinitions> = {\n  [Topic in keyof Definitions & string]: GenericEvent<\n    Topic,\n    PayloadFromDefinition<Definitions[Topic]>,\n    ContextFromDefinition<Definitions[Topic]>\n  >;\n}[keyof Definitions & string];\n\ntype DefineEventOptions = {\n  priority?: number;\n};\n\nexport const defineEvent = <\n  Payload,\n  Context extends DefaultContext = undefined,\n>(\n  options: DefineEventOptions = {},\n): EventDefinition<Payload, Context> =>\n  options as EventDefinition<Payload, Context>;\n\nexport const defineEvents = <Definitions extends EventDefinitions>(\n  definitions: Definitions,\n): Definitions => definitions;\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA0CO,MAAM,cAAc,CAIzB,UAA8B,CAAC,MAE/B;AAEK,MAAM,eAAe,CAC1B,gBACgB;","names":[]}

package/dist/eventDefinitions.d.cts

@@ -0,0 +1,20 @@
+import { DefaultContext, GenericEvent } from './types.cjs';
+
+type EventDefinition<Payload, Context extends DefaultContext = undefined> = {
+    priority?: number;
+    _payload?: Payload;
+    _context?: Context;
+};
+type EventDefinitions = Record<string, EventDefinition<unknown, DefaultContext>>;
+type PayloadFromDefinition<Definition> = Definition extends EventDefinition<infer Payload, DefaultContext> ? Payload : never;
+type ContextFromDefinition<Definition> = Definition extends EventDefinition<unknown, infer Context> ? Context : never;
+type InferEventsFromDefinitions<Definitions extends EventDefinitions> = {
+    [Topic in keyof Definitions & string]: GenericEvent<Topic, PayloadFromDefinition<Definitions[Topic]>, ContextFromDefinition<Definitions[Topic]>>;
+}[keyof Definitions & string];
+type DefineEventOptions = {
+    priority?: number;
+};
+declare const defineEvent: <Payload, Context extends DefaultContext = undefined>(options?: DefineEventOptions) => EventDefinition<Payload, Context>;
+declare const defineEvents: <Definitions extends EventDefinitions>(definitions: Definitions) => Definitions;
+
+export { type EventDefinition, type EventDefinitions, type InferEventsFromDefinitions, defineEvent, defineEvents };

package/dist/eventDefinitions.d.ts

@@ -0,0 +1,20 @@
+import { DefaultContext, GenericEvent } from './types.js';
+
+type EventDefinition<Payload, Context extends DefaultContext = undefined> = {
+    priority?: number;
+    _payload?: Payload;
+    _context?: Context;
+};
+type EventDefinitions = Record<string, EventDefinition<unknown, DefaultContext>>;
+type PayloadFromDefinition<Definition> = Definition extends EventDefinition<infer Payload, DefaultContext> ? Payload : never;
+type ContextFromDefinition<Definition> = Definition extends EventDefinition<unknown, infer Context> ? Context : never;
+type InferEventsFromDefinitions<Definitions extends EventDefinitions> = {
+    [Topic in keyof Definitions & string]: GenericEvent<Topic, PayloadFromDefinition<Definitions[Topic]>, ContextFromDefinition<Definitions[Topic]>>;
+}[keyof Definitions & string];
+type DefineEventOptions = {
+    priority?: number;
+};
+declare const defineEvent: <Payload, Context extends DefaultContext = undefined>(options?: DefineEventOptions) => EventDefinition<Payload, Context>;
+declare const defineEvents: <Definitions extends EventDefinitions>(definitions: Definitions) => Definitions;
+
+export { type EventDefinition, type EventDefinitions, type InferEventsFromDefinitions, defineEvent, defineEvents };

package/dist/eventDefinitions.mjs

@@ -0,0 +1,7 @@
+const defineEvent = (options = {}) => options;
+const defineEvents = (definitions) => definitions;
+export {
+  defineEvent,
+  defineEvents
+};
+//# sourceMappingURL=eventDefinitions.mjs.map

package/dist/eventDefinitions.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/eventDefinitions.ts"],"sourcesContent":["import type { DefaultContext, GenericEvent } from './types.mjs';\n\nexport type EventDefinition<\n  Payload,\n  Context extends DefaultContext = undefined,\n> = {\n  priority?: number;\n  _payload?: Payload;\n  _context?: Context;\n};\n\nexport type EventDefinitions = Record<\n  string,\n  EventDefinition<unknown, DefaultContext>\n>;\n\ntype PayloadFromDefinition<Definition> = Definition extends EventDefinition<\n  infer Payload,\n  DefaultContext\n>\n  ? Payload\n  : never;\n\ntype ContextFromDefinition<Definition> = Definition extends EventDefinition<\n  unknown,\n  infer Context\n>\n  ? Context\n  : never;\n\nexport type InferEventsFromDefinitions<Definitions extends EventDefinitions> = {\n  [Topic in keyof Definitions & string]: GenericEvent<\n    Topic,\n    PayloadFromDefinition<Definitions[Topic]>,\n    ContextFromDefinition<Definitions[Topic]>\n  >;\n}[keyof Definitions & string];\n\ntype DefineEventOptions = {\n  priority?: number;\n};\n\nexport const defineEvent = <\n  Payload,\n  Context extends DefaultContext = undefined,\n>(\n  options: DefineEventOptions = {},\n): EventDefinition<Payload, Context> =>\n  options as EventDefinition<Payload, Context>;\n\nexport const defineEvents = <Definitions extends EventDefinitions>(\n  definitions: Definitions,\n): Definitions => definitions;\n"],"mappings":"AA0CO,MAAM,cAAc,CAIzB,UAA8B,CAAC,MAE/B;AAEK,MAAM,eAAe,CAC1B,gBACgB;","names":[]}

package/dist/index.cjs

@@ -18,12 +18,16 @@ module.exports = __toCommonJS(index_exports);
 __reExport(index_exports, require("./adapters/in-memory/index.ts"), module.exports);
 __reExport(index_exports, require("./createEventCrawler.ts"), module.exports);
 __reExport(index_exports, require("./createNewEvent.ts"), module.exports);
+__reExport(index_exports, require("./eventDefinitions.ts"), module.exports);
 __reExport(index_exports, require("./subscriptions.ts"), module.exports);
+__reExport(index_exports, require("./types.ts"), module.exports);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ...require("./adapters/in-memory/index.ts"),
   ...require("./createEventCrawler.ts"),
   ...require("./createNewEvent.ts"),
-  ...require("./subscriptions.ts")
+  ...require("./eventDefinitions.ts"),
+  ...require("./subscriptions.ts"),
+  ...require("./types.ts")
 });
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./adapters/in-memory/index.ts\";\nexport * from \"./createEventCrawler.ts\";\nexport * from \"./createNewEvent.ts\";\nexport type * from \"./ports/EventBus.ts\";\nexport type * from \"./ports/EventQueries.ts\";\nexport type * from \"./ports/EventRepository.ts\";\nexport * from \"./subscriptions.ts\";\nexport type * from \"./types.ts\";\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0CAAd;AACA,0BAAc,oCADd;AAEA,0BAAc,gCAFd;AAMA,0BAAc,+BANd;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from \"./adapters/in-memory/index.ts\";\nexport * from \"./createEventCrawler.ts\";\nexport * from \"./createNewEvent.ts\";\nexport * from \"./eventDefinitions.ts\";\nexport type * from \"./ports/EventBus.ts\";\nexport type * from \"./ports/EventQueries.ts\";\nexport type * from \"./ports/EventRepository.ts\";\nexport * from \"./subscriptions.ts\";\nexport * from \"./types.ts\";\n"],"mappings":";;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,0CAAd;AACA,0BAAc,oCADd;AAEA,0BAAc,gCAFd;AAGA,0BAAc,kCAHd;AAOA,0BAAc,+BAPd;AAQA,0BAAc,uBARd;","names":[]}

package/dist/index.d.cts

@@ -1,11 +1,12 @@
 export { createInMemoryEventRepositoryAndQueries } from './adapters/in-memory/index.cjs';
 export { createEventCrawler } from './createEventCrawler.cjs';
-export { CreateNewEvent, makeCreateNewEvent } from './createNewEvent.cjs';
+export { CreateNewEvent, CreateNewEventFromDefinitions, makeCreateNewEvent } from './createNewEvent.cjs';
+export { EventDefinition, EventDefinitions, InferEventsFromDefinitions, defineEvent, defineEvents } from './eventDefinitions.cjs';
 export { EventBus } from './ports/EventBus.cjs';
 export { EventQueries } from './ports/EventQueries.cjs';
 export { EventRepository, EventsUnitOfWork, WithEventsUow, WithEventsUowOptions } from './ports/EventRepository.cjs';
 export { GlobalSubscriberConfig, NarrowEvent, TopicFilter, TopicSubscriber, TopicSubscriptions, subscribeByTopic, subscribeGlobalToTopics } from './subscriptions.cjs';
-export { DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, UserId } from './types.cjs';
+export { Actor, AnonymousActor, ApiKeyActor, DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, SystemActor, UserActor, UserId, WorkerActor, createAnonymousActor, createApiKeyActor, createSystemActor, createUserActor, createWorkerActor } from './types.cjs';
 export { createInMemoryEventBus } from './adapters/in-memory/InMemoryEventBus.cjs';
 export { createInMemoryEventQueries } from './adapters/in-memory/InMemoryEventQueries.cjs';
 export { InMemoryEventRepositoryHelpers, createInMemoryEventRepository, createInMemoryWithUow } from './adapters/in-memory/InMemoryEventRepository.cjs';

package/dist/index.d.ts

@@ -1,11 +1,12 @@
 export { createInMemoryEventRepositoryAndQueries } from './adapters/in-memory/index.js';
 export { createEventCrawler } from './createEventCrawler.js';
-export { CreateNewEvent, makeCreateNewEvent } from './createNewEvent.js';
+export { CreateNewEvent, CreateNewEventFromDefinitions, makeCreateNewEvent } from './createNewEvent.js';
+export { EventDefinition, EventDefinitions, InferEventsFromDefinitions, defineEvent, defineEvents } from './eventDefinitions.js';
 export { EventBus } from './ports/EventBus.js';
 export { EventQueries } from './ports/EventQueries.js';
 export { EventRepository, EventsUnitOfWork, WithEventsUow, WithEventsUowOptions } from './ports/EventRepository.js';
 export { GlobalSubscriberConfig, NarrowEvent, TopicFilter, TopicSubscriber, TopicSubscriptions, subscribeByTopic, subscribeGlobalToTopics } from './subscriptions.js';
-export { DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, UserId } from './types.js';
+export { Actor, AnonymousActor, ApiKeyActor, DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, SystemActor, UserActor, UserId, WorkerActor, createAnonymousActor, createApiKeyActor, createSystemActor, createUserActor, createWorkerActor } from './types.js';
 export { createInMemoryEventBus } from './adapters/in-memory/InMemoryEventBus.js';
 export { createInMemoryEventQueries } from './adapters/in-memory/InMemoryEventQueries.js';
 export { InMemoryEventRepositoryHelpers, createInMemoryEventRepository, createInMemoryWithUow } from './adapters/in-memory/InMemoryEventRepository.js';

package/dist/index.mjs

@@ -1,5 +1,7 @@
 export * from "./adapters/in-memory/index.mjs";
 export * from "./createEventCrawler.mjs";
 export * from "./createNewEvent.mjs";
+export * from "./eventDefinitions.mjs";
 export * from "./subscriptions.mjs";
+export * from "./types.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './adapters/in-memory/index.mjs';\nexport * from './createEventCrawler.mjs';\nexport * from './createNewEvent.mjs';\nexport type * from './ports/EventBus.mjs';\nexport type * from './ports/EventQueries.mjs';\nexport type * from './ports/EventRepository.mjs';\nexport * from './subscriptions.mjs';\nexport type * from './types.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;","names":[]}
+{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export * from './adapters/in-memory/index.mjs';\nexport * from './createEventCrawler.mjs';\nexport * from './createNewEvent.mjs';\nexport * from './eventDefinitions.mjs';\nexport type * from './ports/EventBus.mjs';\nexport type * from './ports/EventQueries.mjs';\nexport type * from './ports/EventRepository.mjs';\nexport * from './subscriptions.mjs';\nexport * from './types.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;AACd,cAAc;AACd,cAAc;AAId,cAAc;AACd,cAAc;","names":[]}

package/dist/types.cjs

@@ -3,6 +3,10 @@ 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))
@@ -13,5 +17,38 @@ var __copyProps = (to, from, except, desc) => {
 };
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 var types_exports = {};
+__export(types_exports, {
+  createAnonymousActor: () => createAnonymousActor,
+  createApiKeyActor: () => createApiKeyActor,
+  createSystemActor: () => createSystemActor,
+  createUserActor: () => createUserActor,
+  createWorkerActor: () => createWorkerActor
+});
 module.exports = __toCommonJS(types_exports);
+const createUserActor = (id) => ({
+  kind: "user",
+  id
+});
+const createSystemActor = () => ({
+  kind: "system"
+});
+const createWorkerActor = (id) => ({
+  kind: "worker",
+  ...id !== void 0 ? { id } : {}
+});
+const createApiKeyActor = (id) => ({
+  kind: "api-key",
+  id
+});
+const createAnonymousActor = () => ({
+  kind: "anonymous"
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createAnonymousActor,
+  createApiKeyActor,
+  createSystemActor,
+  createUserActor,
+  createWorkerActor
+});
 //# sourceMappingURL=types.cjs.map

package/dist/types.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Branded type helper for nominal typing.\n * Adds a phantom type property to distinguish between structurally identical types.\n */\nexport type Flavor<T, FlavorT> = T & {\n  _type?: FlavorT;\n};\n\n/** Unique identifier for an event subscription. */\nexport type SubscriptionId = Flavor<string, \"SubscriptionId\">;\n\n/** Unique identifier for a user who triggered an event. */\nexport type UserId = Flavor<string, \"UserId\">;\n\n/** Unique identifier for an event. */\nexport type EventId = Flavor<string, \"EventId\">;\n\n/**\n * Records a subscription failure during event publication.\n * Contains the subscription that failed and error details for debugging.\n */\nexport type EventFailure = {\n  subscriptionId: SubscriptionId;\n  errorMessage: string;\n  /** Stack trace captured when the subscription callback threw. */\n  stack?: string;\n};\n\n/**\n * Records a single publication attempt for an event.\n * Tracks which subscribers were notified and any failures that occurred.\n */\nexport type EventPublication = {\n  publishedAt: Date;\n  /** All subscription IDs that were attempted in this publication. */\n  publishedSubscribers: SubscriptionId[];\n  /** Subscriptions that failed during this publication attempt. */\n  failures?: EventFailure[];\n};\n\n/**\n * Event lifecycle status.\n * - `never-published`: New event, not yet processed by crawler\n * - `in-process`: Currently being published by crawler\n * - `published`: Successfully delivered to all subscribers\n * - `failed-but-will-retry`: Some subscribers failed, will retry\n * - `quarantined`: Exceeded max retries, requires manual intervention\n * - `to-republish`: Force republish to all subscribers (manual trigger)\n */\nexport type EventStatus =\n  | \"never-published\"\n  | \"to-republish\"\n  | \"in-process\"\n  | \"published\"\n  | \"failed-but-will-retry\"\n  | \"quarantined\";\n\n/** Context type constraint - must be a string record or undefined. */\nexport type DefaultContext = Record<string, string> | undefined;\n\n/**\n * Generic event type for the outbox pattern.\n * Events are persisted in the same transaction as domain changes,\n * then asynchronously published to subscribers.\n *\n * @typeParam T - Event topic/type string literal\n * @typeParam P - Event payload type\n * @typeParam C - Optional context for filtering (e.g., tenant ID)\n *\n * @example\n * ```typescript\n * type MyEvents =\n *   | GenericEvent<\"UserCreated\", { userId: string; email: string }>\n *   | GenericEvent<\"OrderPlaced\", { orderId: string }, { tenantId: string }>;\n * ```\n */\nexport type GenericEvent<\n  T extends string,\n  P,\n  C extends DefaultContext = undefined,\n> = {\n  /** Unique event identifier. */\n  id: EventId;\n  /** When the event occurred in the domain. */\n  occurredAt: Date;\n  /** Event type/topic for routing to subscribers. */\n  topic: T;\n  /** Event-specific data. */\n  payload: P;\n  /** Current lifecycle status. */\n  status: EventStatus;\n  /** History of publication attempts. */\n  publications: EventPublication[];\n  /** User who triggered the action that created this event. */\n  triggeredByUserId: UserId;\n  /** Optional priority for processing order (not yet implemented in crawler). */\n  priority?: number;\n  /** Optional context for filtering events (e.g., by tenant). */\n  context?: C;\n};\n"],"mappings":";;;;;;;;;;;;;;AAAA;AAAA;","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Branded type helper for nominal typing.\n * Adds a phantom type property to distinguish between structurally identical types.\n */\nexport type Flavor<T, FlavorT> = T & {\n  _type?: FlavorT;\n};\n\n/** Unique identifier for an event subscription. */\nexport type SubscriptionId = Flavor<string, \"SubscriptionId\">;\n\n/** Unique identifier for a user who triggered an event. */\nexport type UserId = Flavor<string, \"UserId\">;\n\n/** Actor representing a user action. */\nexport type UserActor<Id extends string = string> = {\n  kind: \"user\";\n  id: Id;\n};\n\n/** Actor representing platform or infrastructure initiated work. */\nexport type SystemActor = {\n  kind: \"system\";\n};\n\n/** Actor representing a background worker or job. */\nexport type WorkerActor<Id extends string = string> = {\n  kind: \"worker\";\n  id?: Id;\n};\n\n/** Actor representing an API key. */\nexport type ApiKeyActor<Id extends string = string> = {\n  kind: \"api-key\";\n  id: Id;\n};\n\n/** Actor representing an anonymous caller. */\nexport type AnonymousActor = {\n  kind: \"anonymous\";\n};\n\n/** JSON-serializable actor metadata persisted alongside the event. */\nexport type Actor =\n  | UserActor\n  | SystemActor\n  | WorkerActor\n  | ApiKeyActor\n  | AnonymousActor;\n\n/** Creates a typed user actor. */\nexport const createUserActor = <Id extends string>(id: Id): UserActor<Id> => ({\n  kind: \"user\",\n  id,\n});\n\n/** Creates a typed system actor. */\nexport const createSystemActor = (): SystemActor => ({\n  kind: \"system\",\n});\n\n/** Creates a typed worker actor. */\nexport const createWorkerActor = <Id extends string>(\n  id?: Id,\n): WorkerActor<Id> => ({\n  kind: \"worker\",\n  ...(id !== undefined ? { id } : {}),\n});\n\n/** Creates a typed API key actor. */\nexport const createApiKeyActor = <Id extends string>(\n  id: Id,\n): ApiKeyActor<Id> => ({\n  kind: \"api-key\",\n  id,\n});\n\n/** Creates a typed anonymous actor. */\nexport const createAnonymousActor = (): AnonymousActor => ({\n  kind: \"anonymous\",\n});\n\n/** Unique identifier for an event. */\nexport type EventId = Flavor<string, \"EventId\">;\n\n/**\n * Records a subscription failure during event publication.\n * Contains the subscription that failed and error details for debugging.\n */\nexport type EventFailure = {\n  subscriptionId: SubscriptionId;\n  errorMessage: string;\n  /** Stack trace captured when the subscription callback threw. */\n  stack?: string;\n};\n\n/**\n * Records a single publication attempt for an event.\n * Tracks which subscribers were notified and any failures that occurred.\n */\nexport type EventPublication = {\n  publishedAt: Date;\n  /** All subscription IDs that were attempted in this publication. */\n  publishedSubscribers: SubscriptionId[];\n  /** Subscriptions that failed during this publication attempt. */\n  failures?: EventFailure[];\n};\n\n/**\n * Event lifecycle status.\n * - `never-published`: New event, not yet processed by crawler\n * - `in-process`: Currently being published by crawler\n * - `published`: Successfully delivered to all subscribers\n * - `failed-but-will-retry`: Some subscribers failed, will retry\n * - `quarantined`: Exceeded max retries, requires manual intervention\n * - `to-republish`: Force republish to all subscribers (manual trigger)\n */\nexport type EventStatus =\n  | \"never-published\"\n  | \"to-republish\"\n  | \"in-process\"\n  | \"published\"\n  | \"failed-but-will-retry\"\n  | \"quarantined\";\n\n/** Context type constraint - must be a string record or undefined. */\nexport type DefaultContext = Record<string, string> | undefined;\n\n/**\n * Generic event type for the outbox pattern.\n * Events are persisted in the same transaction as domain changes,\n * then asynchronously published to subscribers.\n *\n * @typeParam T - Event topic/type string literal\n * @typeParam P - Event payload type\n * @typeParam C - Optional context for filtering (e.g., tenant ID)\n *\n * @example\n * ```typescript\n * type MyEvents =\n *   | GenericEvent<\"UserCreated\", { userId: string; email: string }>\n *   | GenericEvent<\"OrderPlaced\", { orderId: string }, { tenantId: string }>;\n * ```\n */\nexport type GenericEvent<\n  T extends string,\n  P,\n  C extends DefaultContext = undefined,\n> = {\n  /** Unique event identifier. */\n  id: EventId;\n  /** When the event occurred in the domain. */\n  occurredAt: Date;\n  /** Event type/topic for routing to subscribers. */\n  topic: T;\n  /** Event-specific data. */\n  payload: P;\n  /** Current lifecycle status. */\n  status: EventStatus;\n  /** History of publication attempts. */\n  publications: EventPublication[];\n  /** Actor identifier that triggered the action that created this event. */\n  triggeredByActor: Actor;\n  /** Optional correlation identifier for a request or cross-event flow. */\n  flowId?: string;\n  /** Optional parent event identifier for cascading events. */\n  causedByEventId?: EventId;\n  /** Optional priority for processing order (not yet implemented in crawler). */\n  priority?: number;\n  /** Optional context for filtering events (e.g., by tenant). */\n  context?: C;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmDO,MAAM,kBAAkB,CAAoB,QAA2B;AAAA,EAC5E,MAAM;AAAA,EACN;AACF;AAGO,MAAM,oBAAoB,OAAoB;AAAA,EACnD,MAAM;AACR;AAGO,MAAM,oBAAoB,CAC/B,QACqB;AAAA,EACrB,MAAM;AAAA,EACN,GAAI,OAAO,SAAY,EAAE,GAAG,IAAI,CAAC;AACnC;AAGO,MAAM,oBAAoB,CAC/B,QACqB;AAAA,EACrB,MAAM;AAAA,EACN;AACF;AAGO,MAAM,uBAAuB,OAAuB;AAAA,EACzD,MAAM;AACR;","names":[]}

package/dist/types.d.cts

@@ -9,6 +9,41 @@ type Flavor<T, FlavorT> = T & {
 type SubscriptionId = Flavor<string, "SubscriptionId">;
 /** Unique identifier for a user who triggered an event. */
 type UserId = Flavor<string, "UserId">;
+/** Actor representing a user action. */
+type UserActor<Id extends string = string> = {
+    kind: "user";
+    id: Id;
+};
+/** Actor representing platform or infrastructure initiated work. */
+type SystemActor = {
+    kind: "system";
+};
+/** Actor representing a background worker or job. */
+type WorkerActor<Id extends string = string> = {
+    kind: "worker";
+    id?: Id;
+};
+/** Actor representing an API key. */
+type ApiKeyActor<Id extends string = string> = {
+    kind: "api-key";
+    id: Id;
+};
+/** Actor representing an anonymous caller. */
+type AnonymousActor = {
+    kind: "anonymous";
+};
+/** JSON-serializable actor metadata persisted alongside the event. */
+type Actor = UserActor | SystemActor | WorkerActor | ApiKeyActor | AnonymousActor;
+/** Creates a typed user actor. */
+declare const createUserActor: <Id extends string>(id: Id) => UserActor<Id>;
+/** Creates a typed system actor. */
+declare const createSystemActor: () => SystemActor;
+/** Creates a typed worker actor. */
+declare const createWorkerActor: <Id extends string>(id?: Id) => WorkerActor<Id>;
+/** Creates a typed API key actor. */
+declare const createApiKeyActor: <Id extends string>(id: Id) => ApiKeyActor<Id>;
+/** Creates a typed anonymous actor. */
+declare const createAnonymousActor: () => AnonymousActor;
 /** Unique identifier for an event. */
 type EventId = Flavor<string, "EventId">;
 /**
@@ -73,12 +108,16 @@ type GenericEvent<T extends string, P, C extends DefaultContext = undefined> = {
     status: EventStatus;
     /** History of publication attempts. */
     publications: EventPublication[];
-    /** User who triggered the action that created this event. */
-    triggeredByUserId: UserId;
+    /** Actor identifier that triggered the action that created this event. */
+    triggeredByActor: Actor;
+    /** Optional correlation identifier for a request or cross-event flow. */
+    flowId?: string;
+    /** Optional parent event identifier for cascading events. */
+    causedByEventId?: EventId;
     /** Optional priority for processing order (not yet implemented in crawler). */
     priority?: number;
     /** Optional context for filtering events (e.g., by tenant). */
     context?: C;
 };
 
-export type { DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, UserId };
+export { type Actor, type AnonymousActor, type ApiKeyActor, type DefaultContext, type EventFailure, type EventId, type EventPublication, type EventStatus, type Flavor, type GenericEvent, type SubscriptionId, type SystemActor, type UserActor, type UserId, type WorkerActor, createAnonymousActor, createApiKeyActor, createSystemActor, createUserActor, createWorkerActor };

package/dist/types.d.ts

@@ -9,6 +9,41 @@ type Flavor<T, FlavorT> = T & {
 type SubscriptionId = Flavor<string, "SubscriptionId">;
 /** Unique identifier for a user who triggered an event. */
 type UserId = Flavor<string, "UserId">;
+/** Actor representing a user action. */
+type UserActor<Id extends string = string> = {
+    kind: "user";
+    id: Id;
+};
+/** Actor representing platform or infrastructure initiated work. */
+type SystemActor = {
+    kind: "system";
+};
+/** Actor representing a background worker or job. */
+type WorkerActor<Id extends string = string> = {
+    kind: "worker";
+    id?: Id;
+};
+/** Actor representing an API key. */
+type ApiKeyActor<Id extends string = string> = {
+    kind: "api-key";
+    id: Id;
+};
+/** Actor representing an anonymous caller. */
+type AnonymousActor = {
+    kind: "anonymous";
+};
+/** JSON-serializable actor metadata persisted alongside the event. */
+type Actor = UserActor | SystemActor | WorkerActor | ApiKeyActor | AnonymousActor;
+/** Creates a typed user actor. */
+declare const createUserActor: <Id extends string>(id: Id) => UserActor<Id>;
+/** Creates a typed system actor. */
+declare const createSystemActor: () => SystemActor;
+/** Creates a typed worker actor. */
+declare const createWorkerActor: <Id extends string>(id?: Id) => WorkerActor<Id>;
+/** Creates a typed API key actor. */
+declare const createApiKeyActor: <Id extends string>(id: Id) => ApiKeyActor<Id>;
+/** Creates a typed anonymous actor. */
+declare const createAnonymousActor: () => AnonymousActor;
 /** Unique identifier for an event. */
 type EventId = Flavor<string, "EventId">;
 /**
@@ -73,12 +108,16 @@ type GenericEvent<T extends string, P, C extends DefaultContext = undefined> = {
     status: EventStatus;
     /** History of publication attempts. */
     publications: EventPublication[];
-    /** User who triggered the action that created this event. */
-    triggeredByUserId: UserId;
+    /** Actor identifier that triggered the action that created this event. */
+    triggeredByActor: Actor;
+    /** Optional correlation identifier for a request or cross-event flow. */
+    flowId?: string;
+    /** Optional parent event identifier for cascading events. */
+    causedByEventId?: EventId;
     /** Optional priority for processing order (not yet implemented in crawler). */
     priority?: number;
     /** Optional context for filtering events (e.g., by tenant). */
     context?: C;
 };
 
-export type { DefaultContext, EventFailure, EventId, EventPublication, EventStatus, Flavor, GenericEvent, SubscriptionId, UserId };
+export { type Actor, type AnonymousActor, type ApiKeyActor, type DefaultContext, type EventFailure, type EventId, type EventPublication, type EventStatus, type Flavor, type GenericEvent, type SubscriptionId, type SystemActor, type UserActor, type UserId, type WorkerActor, createAnonymousActor, createApiKeyActor, createSystemActor, createUserActor, createWorkerActor };

package/dist/types.mjs

@@ -1 +1,26 @@
+const createUserActor = (id) => ({
+  kind: "user",
+  id
+});
+const createSystemActor = () => ({
+  kind: "system"
+});
+const createWorkerActor = (id) => ({
+  kind: "worker",
+  ...id !== void 0 ? { id } : {}
+});
+const createApiKeyActor = (id) => ({
+  kind: "api-key",
+  id
+});
+const createAnonymousActor = () => ({
+  kind: "anonymous"
+});
+export {
+  createAnonymousActor,
+  createApiKeyActor,
+  createSystemActor,
+  createUserActor,
+  createWorkerActor
+};
 //# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["/**\n * Branded type helper for nominal typing.\n * Adds a phantom type property to distinguish between structurally identical types.\n */\nexport type Flavor<T, FlavorT> = T & {\n  _type?: FlavorT;\n};\n\n/** Unique identifier for an event subscription. */\nexport type SubscriptionId = Flavor<string, \"SubscriptionId\">;\n\n/** Unique identifier for a user who triggered an event. */\nexport type UserId = Flavor<string, \"UserId\">;\n\n/** Actor representing a user action. */\nexport type UserActor<Id extends string = string> = {\n  kind: \"user\";\n  id: Id;\n};\n\n/** Actor representing platform or infrastructure initiated work. */\nexport type SystemActor = {\n  kind: \"system\";\n};\n\n/** Actor representing a background worker or job. */\nexport type WorkerActor<Id extends string = string> = {\n  kind: \"worker\";\n  id?: Id;\n};\n\n/** Actor representing an API key. */\nexport type ApiKeyActor<Id extends string = string> = {\n  kind: \"api-key\";\n  id: Id;\n};\n\n/** Actor representing an anonymous caller. */\nexport type AnonymousActor = {\n  kind: \"anonymous\";\n};\n\n/** JSON-serializable actor metadata persisted alongside the event. */\nexport type Actor =\n  | UserActor\n  | SystemActor\n  | WorkerActor\n  | ApiKeyActor\n  | AnonymousActor;\n\n/** Creates a typed user actor. */\nexport const createUserActor = <Id extends string>(id: Id): UserActor<Id> => ({\n  kind: \"user\",\n  id,\n});\n\n/** Creates a typed system actor. */\nexport const createSystemActor = (): SystemActor => ({\n  kind: \"system\",\n});\n\n/** Creates a typed worker actor. */\nexport const createWorkerActor = <Id extends string>(\n  id?: Id,\n): WorkerActor<Id> => ({\n  kind: \"worker\",\n  ...(id !== undefined ? { id } : {}),\n});\n\n/** Creates a typed API key actor. */\nexport const createApiKeyActor = <Id extends string>(\n  id: Id,\n): ApiKeyActor<Id> => ({\n  kind: \"api-key\",\n  id,\n});\n\n/** Creates a typed anonymous actor. */\nexport const createAnonymousActor = (): AnonymousActor => ({\n  kind: \"anonymous\",\n});\n\n/** Unique identifier for an event. */\nexport type EventId = Flavor<string, \"EventId\">;\n\n/**\n * Records a subscription failure during event publication.\n * Contains the subscription that failed and error details for debugging.\n */\nexport type EventFailure = {\n  subscriptionId: SubscriptionId;\n  errorMessage: string;\n  /** Stack trace captured when the subscription callback threw. */\n  stack?: string;\n};\n\n/**\n * Records a single publication attempt for an event.\n * Tracks which subscribers were notified and any failures that occurred.\n */\nexport type EventPublication = {\n  publishedAt: Date;\n  /** All subscription IDs that were attempted in this publication. */\n  publishedSubscribers: SubscriptionId[];\n  /** Subscriptions that failed during this publication attempt. */\n  failures?: EventFailure[];\n};\n\n/**\n * Event lifecycle status.\n * - `never-published`: New event, not yet processed by crawler\n * - `in-process`: Currently being published by crawler\n * - `published`: Successfully delivered to all subscribers\n * - `failed-but-will-retry`: Some subscribers failed, will retry\n * - `quarantined`: Exceeded max retries, requires manual intervention\n * - `to-republish`: Force republish to all subscribers (manual trigger)\n */\nexport type EventStatus =\n  | \"never-published\"\n  | \"to-republish\"\n  | \"in-process\"\n  | \"published\"\n  | \"failed-but-will-retry\"\n  | \"quarantined\";\n\n/** Context type constraint - must be a string record or undefined. */\nexport type DefaultContext = Record<string, string> | undefined;\n\n/**\n * Generic event type for the outbox pattern.\n * Events are persisted in the same transaction as domain changes,\n * then asynchronously published to subscribers.\n *\n * @typeParam T - Event topic/type string literal\n * @typeParam P - Event payload type\n * @typeParam C - Optional context for filtering (e.g., tenant ID)\n *\n * @example\n * ```typescript\n * type MyEvents =\n *   | GenericEvent<\"UserCreated\", { userId: string; email: string }>\n *   | GenericEvent<\"OrderPlaced\", { orderId: string }, { tenantId: string }>;\n * ```\n */\nexport type GenericEvent<\n  T extends string,\n  P,\n  C extends DefaultContext = undefined,\n> = {\n  /** Unique event identifier. */\n  id: EventId;\n  /** When the event occurred in the domain. */\n  occurredAt: Date;\n  /** Event type/topic for routing to subscribers. */\n  topic: T;\n  /** Event-specific data. */\n  payload: P;\n  /** Current lifecycle status. */\n  status: EventStatus;\n  /** History of publication attempts. */\n  publications: EventPublication[];\n  /** Actor identifier that triggered the action that created this event. */\n  triggeredByActor: Actor;\n  /** Optional correlation identifier for a request or cross-event flow. */\n  flowId?: string;\n  /** Optional parent event identifier for cascading events. */\n  causedByEventId?: EventId;\n  /** Optional priority for processing order (not yet implemented in crawler). */\n  priority?: number;\n  /** Optional context for filtering events (e.g., by tenant). */\n  context?: C;\n};\n"],"mappings":"AAmDO,MAAM,kBAAkB,CAAoB,QAA2B;AAAA,EAC5E,MAAM;AAAA,EACN;AACF;AAGO,MAAM,oBAAoB,OAAoB;AAAA,EACnD,MAAM;AACR;AAGO,MAAM,oBAAoB,CAC/B,QACqB;AAAA,EACrB,MAAM;AAAA,EACN,GAAI,OAAO,SAAY,EAAE,GAAG,IAAI,CAAC;AACnC;AAGO,MAAM,oBAAoB,CAC/B,QACqB;AAAA,EACrB,MAAM;AAAA,EACN;AACF;AAGO,MAAM,uBAAuB,OAAuB;AAAA,EACzD,MAAM;AACR;","names":[]}

package/package.json

@@ -3,7 +3,7 @@
   "description": "The purpose of this repository is to make it easy to setup event driven architecture using outbox pattern",
   "module": "src/index.ts",
   "type": "module",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.ts",
   "files": [

package/src/adapters/in-memory/InMemoryEventBus.ts

@@ -1,4 +1,12 @@
-import { makeCreateNewEvent } from "../../createNewEvent.ts";
+import {
+  type CreateNewEvent,
+  type CreateNewEventFromDefinitions,
+  makeCreateNewEvent,
+} from "../../createNewEvent.ts";
+import type {
+  EventDefinitions,
+  InferEventsFromDefinitions,
+} from "../../eventDefinitions.ts";
 import type { EventBus } from "../../ports/EventBus.ts";
 import type { WithEventsUow } from "../../ports/EventRepository.ts";
 import {
@@ -26,17 +34,63 @@ type CreateInMemoryEventBusOptions = {
   generateId?: () => EventId;
 };
 
-export const createInMemoryEventBus = <
+type CreateInMemoryEventBusFromDefinitionsOptions<
+  Definitions extends EventDefinitions,
+> = CreateInMemoryEventBusOptions & {
+  eventDefinitions: Definitions;
+};
+
+type CreateInMemoryEventBusResult<
+  Event extends GenericEvent<string, unknown, DefaultContext>,
+> = {
+  eventBus: EventBus<Event>;
+  createNewEvent: CreateNewEvent<Event>;
+  defineSubscriptions: (
+    subscriptions: TopicSubscriptions<Event>,
+  ) => TopicSubscriptions<Event>;
+  subscribeAll: (subscriptions: TopicSubscriptions<Event>) => void;
+  subscribeGlobal: (
+    subscriptions: TopicSubscriptions<Event>,
+    config: GlobalSubscriberConfig<Event>,
+  ) => void;
+};
+
+export function createInMemoryEventBus<
+  Event extends GenericEvent<string, unknown, DefaultContext>,
+>(
+  withUow: WithEventsUow<Event>,
+  options?: CreateInMemoryEventBusOptions,
+): CreateInMemoryEventBusResult<Event>;
+export function createInMemoryEventBus<Definitions extends EventDefinitions>(
+  withUow: WithEventsUow<InferEventsFromDefinitions<Definitions>>,
+  options: CreateInMemoryEventBusFromDefinitionsOptions<Definitions>,
+): Omit<
+  CreateInMemoryEventBusResult<InferEventsFromDefinitions<Definitions>>,
+  "createNewEvent"
+> & {
+  createNewEvent: CreateNewEventFromDefinitions<Definitions>;
+};
+export function createInMemoryEventBus<
   Event extends GenericEvent<string, unknown, DefaultContext>,
 >(
   withUow: WithEventsUow<Event>,
-  options: CreateInMemoryEventBusOptions = {},
-) => {
+  options:
+    | CreateInMemoryEventBusOptions
+    | CreateInMemoryEventBusFromDefinitionsOptions<EventDefinitions> = {},
+) {
   const maxRetries = options.maxRetries ?? 3;
-  const createNewEvent = makeCreateNewEvent<Event>({
-    getNow: options.getNow,
-    generateId: options.generateId,
-  });
+  const eventDefinitions =
+    "eventDefinitions" in options ? options.eventDefinitions : undefined;
+  const createNewEvent = eventDefinitions
+    ? makeCreateNewEvent({
+        getNow: options.getNow,
+        generateId: options.generateId,
+        eventDefinitions,
+      })
+    : makeCreateNewEvent<Event>({
+        getNow: options.getNow,
+        generateId: options.generateId,
+      });
   const subscriptions: Partial<Record<string, SubscriptionsForTopic>> = {};
 
   const executeCallback = async (
@@ -221,4 +275,4 @@ export const createInMemoryEventBus = <
     subscribeAll,
     subscribeGlobal,
   };
-};
+}

package/src/adapters/kysely/KyselyEventQueries.ts

@@ -36,6 +36,8 @@ export const createKyselyEventQueries = <
         ({
           ...row,
           context: row.context ?? undefined,
+          flowId: row.flowId ?? undefined,
+          causedByEventId: row.causedByEventId ?? undefined,
           priority: row.priority ?? undefined,
         }) as Event,
     );

package/src/adapters/kysely/KyselyEventRepository.ts

@@ -17,6 +17,7 @@ export const createKyselyEventRepository = <
       .values({
         ...event,
         payload: jsonb(event.payload),
+        triggeredByActor: jsonb(event.triggeredByActor),
         context: jsonb(event.context),
         publications: jsonb(event.publications),
       })
@@ -24,9 +25,11 @@ export const createKyselyEventRepository = <
         oc.column("id").doUpdateSet({
           topic: event.topic,
           payload: jsonb(event.payload),
+          triggeredByActor: jsonb(event.triggeredByActor),
           context: jsonb(event.context),
           status: event.status,
-          triggeredByUserId: event.triggeredByUserId,
+          flowId: event.flowId,
+          causedByEventId: event.causedByEventId,
           occurredAt: event.occurredAt,
           publications: jsonb(event.publications),
           priority: event.priority,
@@ -43,6 +46,7 @@ export const createKyselyEventRepository = <
         events.map((event) => ({
           ...event,
           payload: jsonb(event.payload),
+          triggeredByActor: jsonb(event.triggeredByActor),
           context: jsonb(event.context),
           publications: jsonb(event.publications),
         })),

package/src/adapters/kysely/migration.ts

@@ -8,7 +8,9 @@ export async function up(db: Kysely<unknown>): Promise<void> {
     .addColumn("payload", "jsonb", (col) => col.notNull())
     .addColumn("context", "jsonb")
     .addColumn("status", "text", (col) => col.notNull())
-    .addColumn("triggeredByUserId", "text", (col) => col.notNull())
+    .addColumn("triggeredByActor", "jsonb", (col) => col.notNull())
+    .addColumn("flowId", "text")
+    .addColumn("causedByEventId", "text")
     .addColumn("occurredAt", "timestamptz", (col) => col.notNull())
     .addColumn("publications", "jsonb", (col) => col.notNull().defaultTo("[]"))
     .addColumn("priority", "integer")