@robinmalfait/event-source 0.0.10 → 0.0.12

package/dist/index.d.mts

@@ -43,18 +43,6 @@ declare function abort<T>(message: string, attributes?: T): void;
 
 declare function objectToYaml<T extends Object>(object: T): string;
 
-interface Job {
-    handle: () => void;
-    resolve: (value: unknown) => unknown;
-    reject: (value: unknown) => unknown;
-}
-declare class Queue {
-    constructor();
-    get length(): number;
-    start(): Promise<void>;
-    push(handle: Job['handle']): Promise<unknown>;
-}
-
 type MaybePromise<T> = T | Promise<T>;
 interface EventStore {
     persist(events: EventType[]): MaybePromise<void>;
@@ -74,10 +62,22 @@ type ApplyLazyProjectorEvents<Events extends Lazy<EventType>> = ApplyConcretePro
 type MaybeLazy<T> = T | Lazy<T>;
 type ApplyProjectorEvents<Events extends MaybeLazy<EventType> = any> = Events extends Lazy<EventType> ? ApplyLazyProjectorEvents<Events> : Events extends EventType ? ApplyConcreteProjectorEvents<Events> : never;
 declare abstract class Projector<T extends ApplyProjectorEvents<any> = any> {
+    #private;
+    /**
+     * Name of the projector
+     */
     abstract name: string;
-    abstract apply: T;
-    initializer(): void | Promise<void>;
-    q: Queue;
+    /**
+     * Map from event name to projection to apply an individual event.
+     */
+    apply?: T;
+    /**
+     * Initialize the projector.
+     *
+     * Executed before loading all existing events to get the projection up to
+     * date.
+     */
+    initializer?(): void | Promise<void>;
     init(es: EventSource): Promise<void>;
     applyEvent(event: EventType): Promise<void>;
     project(event: EventType): void | Promise<void>;

package/dist/index.d.ts

@@ -43,18 +43,6 @@ declare function abort<T>(message: string, attributes?: T): void;
 
 declare function objectToYaml<T extends Object>(object: T): string;
 
-interface Job {
-    handle: () => void;
-    resolve: (value: unknown) => unknown;
-    reject: (value: unknown) => unknown;
-}
-declare class Queue {
-    constructor();
-    get length(): number;
-    start(): Promise<void>;
-    push(handle: Job['handle']): Promise<unknown>;
-}
-
 type MaybePromise<T> = T | Promise<T>;
 interface EventStore {
     persist(events: EventType[]): MaybePromise<void>;
@@ -74,10 +62,22 @@ type ApplyLazyProjectorEvents<Events extends Lazy<EventType>> = ApplyConcretePro
 type MaybeLazy<T> = T | Lazy<T>;
 type ApplyProjectorEvents<Events extends MaybeLazy<EventType> = any> = Events extends Lazy<EventType> ? ApplyLazyProjectorEvents<Events> : Events extends EventType ? ApplyConcreteProjectorEvents<Events> : never;
 declare abstract class Projector<T extends ApplyProjectorEvents<any> = any> {
+    #private;
+    /**
+     * Name of the projector
+     */
     abstract name: string;
-    abstract apply: T;
-    initializer(): void | Promise<void>;
-    q: Queue;
+    /**
+     * Map from event name to projection to apply an individual event.
+     */
+    apply?: T;
+    /**
+     * Initialize the projector.
+     *
+     * Executed before loading all existing events to get the projection up to
+     * date.
+     */
+    initializer?(): void | Promise<void>;
     init(es: EventSource): Promise<void>;
     applyEvent(event: EventType): Promise<void>;
     project(event: EventType): void | Promise<void>;

package/dist/index.js

@@ -1,4 +1,4 @@
-"use strict";var O=Object.create;var T=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var q=Object.getOwnPropertyNames;var Q=Object.getPrototypeOf,R=Object.prototype.hasOwnProperty;var F=(r,e)=>{for(var t in e)T(r,t,{get:e[t],enumerable:!0})},z=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of q(e))!R.call(r,o)&&o!==t&&T(r,o,{get:()=>e[o],enumerable:!(n=_(e,o))||n.enumerable});return r};var V=(r,e,t)=>(t=r!=null?O(Q(r)):{},z(e||!r||!r.__esModule?T(t,"default",{value:r,enumerable:!0}):t,r)),Y=r=>z(T({},"__esModule",{value:!0}),r);var G={};F(G,{Aggregate:()=>A,Command:()=>U,Event:()=>W,EventSource:()=>v,Projector:()=>E,abort:()=>i,createEventMapper:()=>M,createTestEventStore:()=>B,objectToYaml:()=>h});module.exports=Y(G);function w(r,e){let t=Object.assign(new Error(r),e);return t.stack,Error.captureStackTrace&&Error.captureStackTrace(t,w),t}function i(r,e){let t=w(r,e);throw Error.captureStackTrace&&Error.captureStackTrace(t,i),t}function j(r){Object.freeze(r);for(let e of Object.getOwnPropertyNames(r))r.hasOwnProperty(e)&&r[e]!==null&&(typeof r[e]=="object"||typeof r[e]=="function")&&!Object.isFrozen(r[e])&&j(r[e]);return r}var J={NODE_ENV:process.env.NODE_ENV},A=class{#e=0;#t=[];replayEvents(e=[]){for(let t of e)this.applyAnEvent(t);return this}applyAnEvent(e){J.NODE_ENV==="test"&&j(e);let t=this.apply[e.eventName];t==null&&(e.eventName.match(/^[$A-Z_][0-9A-Z_$]*$/i)?i(`Aggregate "${this.constructor.name}" has no method:
+"use strict";var O=Object.create;var h=Object.defineProperty;var _=Object.getOwnPropertyDescriptor;var Q=Object.getOwnPropertyNames;var R=Object.getPrototypeOf,q=Object.prototype.hasOwnProperty;var F=(r,e)=>{for(var t in e)h(r,t,{get:e[t],enumerable:!0})},z=(r,e,t,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of Q(e))!q.call(r,o)&&o!==t&&h(r,o,{get:()=>e[o],enumerable:!(n=_(e,o))||n.enumerable});return r};var V=(r,e,t)=>(t=r!=null?O(R(r)):{},z(e||!r||!r.__esModule?h(t,"default",{value:r,enumerable:!0}):t,r)),Y=r=>z(h({},"__esModule",{value:!0}),r);var G={};F(G,{Aggregate:()=>A,Command:()=>U,Event:()=>W,EventSource:()=>v,Projector:()=>E,abort:()=>i,createEventMapper:()=>M,createTestEventStore:()=>B,objectToYaml:()=>T});module.exports=Y(G);function w(r,e){let t=Object.assign(new Error(r),e);return t.stack,Error.captureStackTrace&&Error.captureStackTrace(t,w),t}function i(r,e){let t=w(r,e);throw Error.captureStackTrace&&Error.captureStackTrace(t,i),t}function j(r){Object.freeze(r);for(let e of Object.getOwnPropertyNames(r))r.hasOwnProperty(e)&&r[e]!==null&&(typeof r[e]=="object"||typeof r[e]=="function")&&!Object.isFrozen(r[e])&&j(r[e]);return r}var J={NODE_ENV:process.env.NODE_ENV},A=class{#e=0;#t=[];replayEvents(e=[]){for(let t of e)this.applyAnEvent(t);return this}applyAnEvent(e){J.NODE_ENV==="test"&&j(e);let t=this.apply[e.eventName];t==null&&(e.eventName.match(/^[$A-Z_][0-9A-Z_$]*$/i)?i(`Aggregate "${this.constructor.name}" has no method:
 
 apply = {
   ${e.eventName}(event) {
@@ -15,14 +15,14 @@ apply = {
 }`));try{t(e)}catch(n){n instanceof Error&&console.error(`An error occurred inside your "%s" function:
 `,e.eventName,n.stack?.split(`
 `).map(o=>`  ${o}`).join(`
-`))}finally{this.#e++}return this}recordThat(e){let t={...e,version:this.#e};return this.applyAnEvent(t),this.#t.push(t),this}releaseEvents(){return this.#t.splice(0)}};function U(r,e=null){return{type:r,payload:e}}var L=require("crypto");function W(r,e,t=null){return{aggregateId:e,eventId:(0,L.randomUUID)(),eventName:r,payload:t,recordedAt:new Date,version:-1}}var I=V(require("yamlify-object")),Z={indent:"  ",colors:{date:c,error:c,symbol:c,string:c,number:c,boolean:c,null:c,undefined:c}};function c(r){return r}function h(r){return r instanceof Error?h({...r}):(0,I.default)(r,Z).split(`
+`))}finally{this.#e++}return this}recordThat(e){let t={...e,version:this.#e};return this.applyAnEvent(t),this.#t.push(t),this}releaseEvents(){return this.#t.splice(0)}};function U(r,e=null){return{type:r,payload:e}}var L=require("crypto");function W(r,e,t=null){return{aggregateId:e,eventId:(0,L.randomUUID)(),eventName:r,payload:t,recordedAt:new Date,version:-1}}var I=V(require("yamlify-object")),Z={indent:"  ",colors:{date:c,error:c,symbol:c,string:c,number:c,boolean:c,null:c,undefined:c}};function c(r){return r}function T(r){return r instanceof Error?T({...r}):(0,I.default)(r,Z).split(`
 `).slice(1).join(`
-`)}var f=new WeakMap;function g(r,e){if(f.has(r)){let t=f.get(r);for(let n in e)t[n]=e[n]}else f.set(r,e)}function x(r){return f.get(r)}var b=class{constructor(){g(this,{jobs:[],state:0})}get length(){return x(this).jobs.length}async start(){let{state:e,jobs:t}=x(this);if(!(e===1||t.length<=0)){for(g(this,{state:1});t.length>0;){let n=t.shift();await Promise.resolve().then(n.handle).then(n.resolve,n.reject)}g(this,{state:0})}}push(e){return new Promise((t,n)=>{let{jobs:o}=x(this);o.push({handle:e,resolve:t,reject:n}),setImmediate(()=>this.start())})}};var E=class{initializer(){}q=new b;async init(e){await this.q.push(()=>this.initializer());let t=await e.loadEvents();await Promise.all(t.map(n=>this.applyEvent(n)))}async applyEvent(e){await this.q.push(()=>this.apply?.[e.eventName]?.(e)),await this.q.push(()=>this.project(e))}project(e){}},v=class r{constructor(e,t,n,o){this.store=e;this.commandHandlers=t;this.projectors=n;this.eventHandlers=o}static builder(e){return new S(e)}static new(e,t,n,o){return new r(e,t,n,o)}async resetProjections(){await Promise.all(this.projectors.map(e=>e.init(this)))}async dispatch(e){return this.commandHandlers.has(e.type)||i(`There is no command handler for the "${e.type}" command`),await this.commandHandlers.get(e.type)(e,this),e}async loadEvents(){return this.store.loadEvents()}async load(e,t){let n=await this.store.load(t);return n.length<=0&&i(`Aggregate(${e.constructor.name}) with ID(${t}) does not exist.`,{aggregate:e.constructor.name,aggregateId:t}),e.replayEvents(n)}async persist(e){let t=e.releaseEvents();await this.store.persist(t);for(let n of t)await Promise.all(this.projectors.map(async o=>{try{await o.applyEvent(n)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your projections: ${o.name}, given an event`,s.stack?.split(`
+`)}var f=new WeakMap;function g(r,e){if(f.has(r)){let t=f.get(r);for(let n in e)t[n]=e[n]}else f.set(r,e)}function x(r){return f.get(r)}var b=class{constructor(){g(this,{jobs:[],state:0})}get length(){return x(this).jobs.length}async start(){let{state:e,jobs:t}=x(this);if(!(e===1||t.length<=0)){for(g(this,{state:1});t.length>0;){let n=t.shift();await Promise.resolve().then(n.handle).then(n.resolve,n.reject)}g(this,{state:0})}}push(e){return new Promise((t,n)=>{let{jobs:o}=x(this);o.push({handle:e,resolve:t,reject:n}),setImmediate(()=>this.start())})}};var E=class{apply;initializer(){}#e=new b;async init(e){this.initializer&&await this.#e.push(()=>this.initializer?.());let t=await e.loadEvents();await Promise.all(t.map(n=>this.applyEvent(n)))}async applyEvent(e){await this.#e.push(()=>this.apply?.[e.eventName]?.(e)),await this.#e.push(()=>this.project(e))}project(e){}},v=class r{constructor(e,t,n,o){this.store=e;this.commandHandlers=t;this.projectors=n;this.eventHandlers=o}static builder(e){return new S(e)}static new(e,t,n,o){return new r(e,t,n,o)}async resetProjections(){await Promise.all(this.projectors.map(e=>e.init(this)))}async dispatch(e){return this.commandHandlers.has(e.type)||i(`There is no command handler for the "${e.type}" command`),await this.commandHandlers.get(e.type)(e,this),e}async loadEvents(){return this.store.loadEvents()}async load(e,t){let n=await this.store.load(t);return n.length<=0&&i(`Aggregate(${e.constructor.name}) with ID(${t}) does not exist.`,{aggregate:e.constructor.name,aggregateId:t}),e.replayEvents(n)}async persist(e){let t=e.releaseEvents();await this.store.persist(t);for(let n of t)await Promise.all(this.projectors.map(async o=>{try{await o.applyEvent(n)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your projections: ${o.name}, given an event`,s.stack?.split(`
 `).map(d=>`  ${d}`).join(`
 `)),s}})),await Promise.all(this.eventHandlers.map(async o=>{try{await o(n,this)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your event handlers: ${o.name}, given an event`,s.stack?.split(`
 `).map(d=>`  ${d}`).join(`
 `)),s}}))}async loadPersist(e,t,n){return await this.load(e,t),await n(e),this.persist(e)}},S=class{constructor(e){this.store=e}commandHandlers=new Map;projectors=[];eventHandlers=[];build(){return v.new(this.store,this.commandHandlers,this.projectors,this.eventHandlers)}addCommandHandler(e,t){return this.commandHandlers.has(e)&&i(`A command handler for the "${e}" command already exists`),this.commandHandlers.set(e,t),this}addProjector(e){return this.projectors.push(e),this}addEventHandler(e){return this.eventHandlers.push(e),this}};function M(r){return(e,t)=>r[e.eventName]?.(e,t)}var H=Symbol("__placeholder__"),y={usedTestEventStoreInTest:!1,calledThenHandler:!1};process.env.NODE_ENV==="test"&&(beforeEach(()=>{y.usedTestEventStoreInTest=!1,y.calledThenHandler=!1}),afterEach(()=>{y.usedTestEventStoreInTest&&!y.calledThenHandler&&i("It seems like you used `createTestEventStore()`\nwithout using the `await then([expected, events, go, here, ...])`")}));function k(r,e){try{return r()}catch(t){throw Error.captureStackTrace&&t instanceof Error&&Error.captureStackTrace(t,e),t}}var N=class extends E{constructor(t=[],n=[]){super();this.db=t;this.producedEvents=n}apply={};name="test-recording-projector";initializer(){this.db.splice(0)}project(t){this.producedEvents.push(t)}};function B(r,e=[]){y.usedTestEventStoreInTest=!0;let t=new N,n=v.builder({load(a){return t.db.filter(p=>p.aggregateId===a)},loadEvents(){return t.db},persist(a){t.db.push(...a)}});for(let a of e)n.addProjector(a);n.addProjector(t);for(let[a,p]of Object.entries(r))n.addCommandHandler(a,p);let o=n.build(),s,d={___:H,async given(a=[]){t.db.push(...a)},async when(a){try{return await o.dispatch(typeof a=="function"?a():a)}catch(p){return p instanceof Error&&(s=p),p}},async then(a){if(y.calledThenHandler=!0,a instanceof Error){let P=a;k(()=>expect(s).toEqual(P),d.then);return}let p=a;if(s)throw Object.keys(s).length>0&&(s.message=["With properties:",`
-${h(s)}
+${T(s)}
 
 ---
 

package/dist/index.mjs

@@ -17,7 +17,7 @@ apply = {
 `).map(a=>`  ${a}`).join(`
 `))}finally{this.#e++}return this}recordThat(e){let t={...e,version:this.#e};return this.applyAnEvent(t),this.#t.push(t),this}releaseEvents(){return this.#t.splice(0)}};function Y(r,e=null){return{type:r,payload:e}}import{randomUUID as M}from"crypto";function W(r,e,t=null){return{aggregateId:e,eventId:M(),eventName:r,payload:t,recordedAt:new Date,version:-1}}import k from"yamlify-object";var $={indent:"  ",colors:{date:c,error:c,symbol:c,string:c,number:c,boolean:c,null:c,undefined:c}};function c(r){return r}function w(r){return r instanceof Error?w({...r}):k(r,$).split(`
 `).slice(1).join(`
-`)}var u=new WeakMap;function T(r,e){if(u.has(r)){let t=u.get(r);for(let n in e)t[n]=e[n]}else u.set(r,e)}function h(r){return u.get(r)}var f=class{constructor(){T(this,{jobs:[],state:0})}get length(){return h(this).jobs.length}async start(){let{state:e,jobs:t}=h(this);if(!(e===1||t.length<=0)){for(T(this,{state:1});t.length>0;){let n=t.shift();await Promise.resolve().then(n.handle).then(n.resolve,n.reject)}T(this,{state:0})}}push(e){return new Promise((t,n)=>{let{jobs:a}=h(this);a.push({handle:e,resolve:t,reject:n}),setImmediate(()=>this.start())})}};var g=class{initializer(){}q=new f;async init(e){await this.q.push(()=>this.initializer());let t=await e.loadEvents();await Promise.all(t.map(n=>this.applyEvent(n)))}async applyEvent(e){await this.q.push(()=>this.apply?.[e.eventName]?.(e)),await this.q.push(()=>this.project(e))}project(e){}},y=class r{constructor(e,t,n,a){this.store=e;this.commandHandlers=t;this.projectors=n;this.eventHandlers=a}static builder(e){return new j(e)}static new(e,t,n,a){return new r(e,t,n,a)}async resetProjections(){await Promise.all(this.projectors.map(e=>e.init(this)))}async dispatch(e){return this.commandHandlers.has(e.type)||p(`There is no command handler for the "${e.type}" command`),await this.commandHandlers.get(e.type)(e,this),e}async loadEvents(){return this.store.loadEvents()}async load(e,t){let n=await this.store.load(t);return n.length<=0&&p(`Aggregate(${e.constructor.name}) with ID(${t}) does not exist.`,{aggregate:e.constructor.name,aggregateId:t}),e.replayEvents(n)}async persist(e){let t=e.releaseEvents();await this.store.persist(t);for(let n of t)await Promise.all(this.projectors.map(async a=>{try{await a.applyEvent(n)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your projections: ${a.name}, given an event`,s.stack?.split(`
+`)}var u=new WeakMap;function h(r,e){if(u.has(r)){let t=u.get(r);for(let n in e)t[n]=e[n]}else u.set(r,e)}function T(r){return u.get(r)}var f=class{constructor(){h(this,{jobs:[],state:0})}get length(){return T(this).jobs.length}async start(){let{state:e,jobs:t}=T(this);if(!(e===1||t.length<=0)){for(h(this,{state:1});t.length>0;){let n=t.shift();await Promise.resolve().then(n.handle).then(n.resolve,n.reject)}h(this,{state:0})}}push(e){return new Promise((t,n)=>{let{jobs:a}=T(this);a.push({handle:e,resolve:t,reject:n}),setImmediate(()=>this.start())})}};var g=class{apply;initializer(){}#e=new f;async init(e){this.initializer&&await this.#e.push(()=>this.initializer?.());let t=await e.loadEvents();await Promise.all(t.map(n=>this.applyEvent(n)))}async applyEvent(e){await this.#e.push(()=>this.apply?.[e.eventName]?.(e)),await this.#e.push(()=>this.project(e))}project(e){}},y=class r{constructor(e,t,n,a){this.store=e;this.commandHandlers=t;this.projectors=n;this.eventHandlers=a}static builder(e){return new j(e)}static new(e,t,n,a){return new r(e,t,n,a)}async resetProjections(){await Promise.all(this.projectors.map(e=>e.init(this)))}async dispatch(e){return this.commandHandlers.has(e.type)||p(`There is no command handler for the "${e.type}" command`),await this.commandHandlers.get(e.type)(e,this),e}async loadEvents(){return this.store.loadEvents()}async load(e,t){let n=await this.store.load(t);return n.length<=0&&p(`Aggregate(${e.constructor.name}) with ID(${t}) does not exist.`,{aggregate:e.constructor.name,aggregateId:t}),e.replayEvents(n)}async persist(e){let t=e.releaseEvents();await this.store.persist(t);for(let n of t)await Promise.all(this.projectors.map(async a=>{try{await a.applyEvent(n)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your projections: ${a.name}, given an event`,s.stack?.split(`
 `).map(d=>`  ${d}`).join(`
 `)),s}})),await Promise.all(this.eventHandlers.map(async a=>{try{await a(n,this)}catch(s){throw s instanceof Error&&console.error(`An error occurred in one of your event handlers: ${a.name}, given an event`,s.stack?.split(`
 `).map(d=>`  ${d}`).join(`

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.0.10",
+  "version": "0.0.12",
   "name": "@robinmalfait/event-source",
   "publishConfig": {
     "access": "public"
@@ -15,14 +15,6 @@
     "dist"
   ],
   "license": "MIT",
-  "scripts": {
-    "start": "pnpm build --watch",
-    "build": "tsup ./src/index.ts --format esm,cjs --clean --minify --dts",
-    "test": "jest",
-    "tdd": "jest --watchAll",
-    "format": "prettier --write .",
-    "prepublishOnly": "pnpm build"
-  },
   "prettier": {
     "printWidth": 80,
     "semi": false,
@@ -51,5 +43,12 @@
   },
   "dependencies": {
     "yamlify-object": "^1.0.0"
+  },
+  "scripts": {
+    "start": "pnpm build --watch",
+    "build": "tsup ./src/index.ts --format esm,cjs --clean --minify --dts",
+    "test": "jest",
+    "tdd": "jest --watchAll",
+    "format": "prettier --write ."
   }
-}
+}