@robinmalfait/event-source 0.0.19 → 0.0.20

package/README.md

@@ -163,7 +163,10 @@ Projectors build read models from events. They process events sequentially and m
 This means projectors work well in serverless environments - projections are persisted to your database and don't need rebuilding on every cold start.
 
 ```typescript
-import { Projector, type ApplyEvents } from '@robinmalfait/event-source'
+import {
+  Projector,
+  type ApplyProjectorEvents,
+} from '@robinmalfait/event-source'
 
 class BalanceProjector extends Projector {
   name = 'balance-projector'
@@ -174,7 +177,7 @@ class BalanceProjector extends Projector {
     this.balances.clear()
   }
 
-  apply: ApplyEvents<typeof accountOpened | typeof moneyDeposited> = {
+  apply: ApplyProjectorEvents<typeof accountOpened | typeof moneyDeposited> = {
     ACCOUNT_OPENED: (event, es) => {
       this.balances.set(event.aggregateId, 0)
     },
@@ -198,7 +201,7 @@ Each `apply` handler receives the `EventSource` instance as the second argument.
 class TransactionHistoryProjector extends Projector {
   name = 'transaction-history-projector'
 
-  apply: ApplyEvents<typeof accountClosed> = {
+  apply: ApplyProjectorEvents<typeof accountClosed> = {
     ACCOUNT_CLOSED: async (event, es) => {
       // Reconstruct the aggregate to access its full state
       let account = await es.load(new Account(), event.aggregateId)
@@ -272,6 +275,39 @@ if (balance < amount) {
 
 ### Type Utilities
 
+#### ApplyEvents / ApplyProjectorEvents
+
+Type-safe handlers for applying events to aggregates and projectors:
+
+```typescript
+import type {
+  ApplyEvents,
+  ApplyProjectorEvents,
+} from '@robinmalfait/event-source'
+
+// For Aggregates - handlers receive only the event
+apply: ApplyEvents<typeof accountOpened | typeof moneyDeposited> = {
+  ACCOUNT_OPENED: (event) => {
+    /* ... */
+  },
+  MONEY_DEPOSITED: (event) => {
+    /* ... */
+  },
+}
+
+// For Projectors - handlers receive the event and EventSource
+apply: ApplyProjectorEvents<typeof accountOpened | typeof moneyDeposited> = {
+  ACCOUNT_OPENED: (event, es) => {
+    /* ... */
+  },
+  MONEY_DEPOSITED: (event, es) => {
+    /* ... */
+  },
+}
+```
+
+#### PayloadOf / TypeOf
+
 Extract types from events and commands:
 
 ```typescript

package/dist/index.d.cts

@@ -140,4 +140,4 @@ declare function createTestEventStore(commandHandlers: Record<string, CommandHan
     then(expectation: EventType[] | Error): Promise<void>;
 };
 
-export { Aggregate, type ApplyEvents, Command, type CommandHandler, type CommandType, Event, type EventHandler, EventSource, type EventStore, type EventType, type MetadataEnhancer, type PayloadOf, Projector, type TypeOf, abort, createEventMapper, createTestEventStore, objectToYaml };
+export { Aggregate, type ApplyEvents, type ApplyProjectorEvents, Command, type CommandHandler, type CommandType, Event, type EventHandler, EventSource, type EventStore, type EventType, type MetadataEnhancer, type PayloadOf, Projector, type TypeOf, abort, createEventMapper, createTestEventStore, objectToYaml };

package/dist/index.d.ts

@@ -140,4 +140,4 @@ declare function createTestEventStore(commandHandlers: Record<string, CommandHan
     then(expectation: EventType[] | Error): Promise<void>;
 };
 
-export { Aggregate, type ApplyEvents, Command, type CommandHandler, type CommandType, Event, type EventHandler, EventSource, type EventStore, type EventType, type MetadataEnhancer, type PayloadOf, Projector, type TypeOf, abort, createEventMapper, createTestEventStore, objectToYaml };
+export { Aggregate, type ApplyEvents, type ApplyProjectorEvents, Command, type CommandHandler, type CommandType, Event, type EventHandler, EventSource, type EventStore, type EventType, type MetadataEnhancer, type PayloadOf, Projector, type TypeOf, abort, createEventMapper, createTestEventStore, objectToYaml };

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.19",
+  "version": "0.0.20",
   "name": "@robinmalfait/event-source",
   "repository": {
     "type": "git",