@vytches/ddd-aggregates 0.26.0 → 0.27.0

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const T=require("/home/runner/work/ddd/ddd/packages/logging/dist/index.js"),c=require("/home/runner/work/ddd/ddd/packages/domain-primitives/dist/index.js");function D(){return globalThis.crypto.randomUUID()}function I(a,t,e){return{eventName:a,payload:t,metadata:{eventId:D(),timestamp:new Date,...e}}}class p{isType(t){return this.type===t}static get capabilityType(){throw new Error("Capability subclass must override static capabilityType getter")}}class ${constructor(){this.capabilities=new Map}register(t){return this.capabilities.set(t.type,t),this}get(t){const e=t.capabilityType;return this.capabilities.get(e)}getByType(t){return this.capabilities.get(t)}has(t){const e=t.capabilityType;return this.capabilities.has(e)}hasByType(t){return this.capabilities.has(t)}remove(t){const e=t.capabilityType;return this.capabilities.delete(e)}removeByType(t){return this.capabilities.delete(t)}getAll(){return Array.from(this.capabilities.values())}getTypes(){return Array.from(this.capabilities.keys())}clear(){this.capabilities.clear()}get size(){return this.capabilities.size}}class g{constructor(t,e="text"){this.value=t,this.type=e}getValue(){return this.value}getType(){return this.type}validate(t){return t!=null&&t!==void 0}equals(t){return t.getValue()===this.value&&t.getType()===this.type}isType(t){return this.type===t}toString(){return String(this.value)}toJSON(){return JSON.stringify({value:this.value,type:this.type})}static create(){const t="xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g,e=>{const i=Math.random()*16|0;return(e==="x"?i:i&3|8).toString(16)});return new g(t,"uuid")}static createText(t){return new g(t,"text")}static createUuid(t){return new g(t,"uuid")}static createInteger(t){return new g(t.toString(),"integer")}static createBigInt(t){const e=typeof t=="bigint"?t.toString():t;return new g(e,"bigint")}static createWithRandomUUID(){return g.create()}static fromUUID(t){if(!t||typeof t!="string")throw new Error("entity identifier must be provided");if(!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t))throw new Error("entity identifier must be valid UUID");return new g(t,"uuid")}static fromInteger(t){if(typeof t!="number"||t<0||!Number.isInteger(t))throw new Error("entity identifier must be a non-negative integer");return new g(t.toString(),"integer")}static fromBigInt(t){const e=typeof t=="bigint"?t.toString():t;if(!e||typeof e!="string")throw new Error("entity identifier must be a valid bigint");return new g(e,"bigint")}static fromText(t){if(!t||typeof t!="string")throw new Error("entity identifier must be provided");if(!/^[a-zA-Z0-9_-]+$/.test(t))throw new Error("entity identifier contains invalid characters");return new g(t,"text")}}class o{constructor(t,e,i){this._isSuccess=t,this._value=e,this._error=i}get isSuccess(){return this._isSuccess}get isFailure(){return!this._isSuccess}get value(){if(!this._isSuccess)throw new Error("Cannot get value of a failure result");return this._value}get error(){if(this._isSuccess)throw new Error("Cannot get error of a success result");return this._error}static ok(t){return new o(!0,t)}static empty(){return new o(!0,void 0)}static fail(t){return new o(!1,void 0,t)}static try(t){try{return o.ok(t())}catch(e){return o.fail(e instanceof Error?e:new Error(String(e)))}}map(t){return this.isFailure?o.fail(this.error):o.ok(t(this.value))}flatMap(t){return this.isFailure?o.fail(this.error):t(this.value)}match(t,e){return this.isSuccess?t(this.value):e(this.error)}tap(t){return this.isSuccess&&t(this.value),this}tapError(t){return this.isFailure&&t(this.error),this}mapError(t){return this.isSuccess?o.ok(this.value):o.fail(t(this.error))}static async tryAsync(t){try{const e=await t();return o.ok(e)}catch(e){return o.fail(e instanceof Error?e:new Error(String(e)))}}async mapAsync(t){if(this.isFailure)return o.fail(this.error);try{const e=await t(this.value);return o.ok(e)}catch(e){const i=e instanceof Error?e:new Error(String(e));return o.fail(i)}}async flatMapAsync(t){return this.isFailure?o.fail(this.error):await t(this.value)}}class d extends p{constructor(){super(...arguments),this.type="versioning",this.upcasters=new Map}static get capabilityType(){return"versioning"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this.upcasters.clear()}registerUpcaster(t,e,i){this.upcasters.has(t)||this.upcasters.set(t,new Map),this.upcasters.get(t).set(e,i)}handleVersionedEvent(t,e){const i=t.metadata?.version||1,r=t.metadata?.targetVersion||i;let s=t;if(i<r&&this.upcasters.has(t.eventName)){const h=this.upcasters.get(t.eventName),m=T.Logger.forContext("VersioningCapability");for(let l=i;l<r;l++){const S=h.get(l);if(!S){m.warn("Missing upcaster for event version — event will be processed without upcast",{eventName:t.eventName,fromVersion:l,toVersion:l+1});continue}const _=S.upcast(s.payload,s.metadata);s={...s,payload:_,metadata:{...s.metadata,version:l+1}}}}const u=e.get(s.eventName);u&&u(s.payload,s.metadata)}getRegisteredEventTypes(){return Array.from(this.upcasters.keys())}hasUpcaster(t,e){return this.upcasters.get(t)?.has(e)||!1}getUpcastersForType(t){return this.upcasters.get(t)}clearUpcastersForType(t){this.upcasters.delete(t)}getTotalUpcasterCount(){let t=0;for(const e of this.upcasters.values())t+=e.size;return t}}class f{constructor(t){this._version=0,this._initialVersion=0,this._domainEvents=[],this._eventHandlers=new Map,this._capabilities=new $,this._id=t.id,this._version=t.version||0,this._initialVersion=t.version||0,this._maxEvents=t.maxEvents}getId(){return this._id}getVersion(){return this._version}getInitialVersion(){return this._initialVersion}hasChanges(){return this._domainEvents.length>0}getDomainEvents(){return[...this._domainEvents]}commit(){this._domainEvents=[],this._initialVersion=this._version}registerEventHandler(t,e){return this._eventHandlers.set(t,e),this}apply(t,e,i){this._version++;let r,s;typeof t=="string"?(r=I(t,e,i),s=r.metadata):(r=t,s=i?{...r.metadata,...i}:r.metadata);const u=f.sanitizeMetadata({...s,aggregateId:this._id.toString(),aggregateType:this.constructor.name,aggregateVersion:this._version,timestamp:s?.timestamp??new Date}),h=Object.assign(Object.create(Object.getPrototypeOf(r)),r,{metadata:u});if(this._maxEvents!==void 0&&this._domainEvents.length>=this._maxEvents)throw new Error(`Aggregate ${this.constructor.name} (id=${this._id.toString()}) exceeded maxEvents limit of ${this._maxEvents}. This usually indicates a runaway loop or replay of a corrupted event stream. Increase maxEvents in the aggregate constructor params if the limit is too restrictive for your domain.`);this._domainEvents.push(h),this.handleEvent(h)}handleEvent(t){const e=this.getCapability(d);if(e)e.handleVersionedEvent(t,this._eventHandlers);else{const i=this._eventHandlers.get(t.eventName);i&&i(t.payload,t.metadata)}}loadFromHistory(t){this._version=this._initialVersion,this._domainEvents=[];for(const e of t)this.handleEvent(e),this._version++;this._initialVersion=this._version}addCapability(t){return"attach"in t&&typeof t.attach=="function"&&t.attach(this),this._capabilities.register(t),this}getCapability(t){return this._capabilities.get(t)}hasCapability(t){return this._capabilities.has(t)}removeCapability(t){const e=this._capabilities.get(t);return e&&"detach"in e&&typeof e.detach=="function"&&e.detach(),this._capabilities.remove(t),this}getAllCapabilities(){return this._capabilities.getAll()}getCapabilityTypes(){return this._capabilities.getTypes()}static sanitizeMetadata(t){if(!Object.prototype.hasOwnProperty.call(t,"__proto__")&&!Object.prototype.hasOwnProperty.call(t,"constructor")&&!Object.prototype.hasOwnProperty.call(t,"prototype"))return t;const e={};for(const i of Object.keys(t))i==="__proto__"||i==="constructor"||i==="prototype"||(e[i]=t[i]);return e}_internal_setState(t){this._version=t.version,this._initialVersion=t.initialVersion,this._domainEvents=[...t.domainEvents]}}class y extends p{constructor(){super(...arguments),this.type="audit",this.auditLog=[]}static get capabilityType(){return"audit"}attach(t){this.aggregate=t;const e=this.aggregate;typeof e.apply=="function"&&(this.originalApply=e.apply,this.originalApply&&(this.aggregate.apply=(...i)=>{const r=this.originalApply.call(this.aggregate,...i);return this.recordAuditEvent(),r}))}detach(){this.aggregate&&this.originalApply&&(this.aggregate.apply=this.originalApply),this.aggregate=void 0,this.auditLog=[],this.originalApply=void 0}getAuditLog(){return[...this.auditLog]}clearAuditLog(){this.auditLog=[]}getAuditStatistics(){const t={};let e=0;this.auditLog.forEach((r,s)=>{if(t[r.eventName]=(t[r.eventName]||0)+1,s>0){const u=this.auditLog[s-1];if(u){const h=new Date(u.timestamp).getTime(),m=new Date(r.timestamp).getTime();e+=m-h}}});const i=this.auditLog.length>1?e/(this.auditLog.length-1):0;return{totalEvents:this.auditLog.length,eventsByType:t,averageTimeBetweenEvents:i}}recordAuditEvent(){const t=this.aggregate.getDomainEvents(),e=t[t.length-1];e&&this.recordEvent(e)}recordEvent(t){const e={eventId:t.metadata?.eventId||`audit-${Date.now()}-${Math.random()}`,eventName:t.eventName,aggregateId:this.aggregate.getId().toString(),aggregateType:this.aggregate.constructor.name,aggregateVersion:this.aggregate.getVersion(),timestamp:new Date,payload:t.payload,metadata:{...t.metadata,auditCapability:!0},actor:t.metadata?.userId};this.auditLog.push(e)}getEventsByName(t){return this.auditLog.filter(e=>e.eventName===t)}getEventsByTimeRange(t,e){return this.auditLog.filter(i=>{const r=new Date(i.timestamp).getTime();return r>=t.getTime()&&r<=e.getTime()})}getFirstEvent(){return this.auditLog[0]||null}getLastEvent(){return this.auditLog[this.auditLog.length-1]||null}}class n extends c.IDomainError{static invalidArguments(t,e){const i={code:c.DomainErrorCode.InvalidParameter,data:e};return new n(t,i)}static versionConflict(t,e,i,r){const s=`Version conflict: Aggregate ${t} with ID ${e} has version ${i}, but expected ${r}`,u={code:c.DomainErrorCode.ValidationFailed,data:{aggregateType:t,aggregateId:e,currentVersion:i,expectedVersion:r}};return new n(s,u)}static featureNotEnabled(t){const e=`Feature '${t}' is not enabled on aggregate`,i={code:c.DomainErrorCode.ValidationFailed,data:{feature:t}};return new n(e,i)}static methodNotImplemented(t,e){const i=`Method '${t}' must be implemented by ${e} to use this feature`,r={code:c.DomainErrorCode.MissingValue,data:{methodName:t,aggregateType:e}};return new n(i,r)}static invalidSnapshot(t,e){const i=`Invalid snapshot for aggregate ${t}${e?`: ${e}`:""}`,r={code:c.DomainErrorCode.InvalidFormat,data:{aggregateType:t,reason:e}};return new n(i,r)}static idMismatch(t,e){const i=`ID mismatch: Snapshot is for ID ${t}, but aggregate has ID ${e}`,r={code:c.DomainErrorCode.ValidationFailed,data:{snapshotId:t,aggregateId:e}};return new n(i,r)}static typeMismatch(t,e){const i=`Aggregate type mismatch: Snapshot is for type ${t}, but trying to load into ${e}`,r={code:c.DomainErrorCode.ValidationFailed,data:{snapshotType:t,aggregateType:e}};return new n(i,r)}static duplicateUpcaster(t,e){const i=`Upcaster for event ${t} version ${e} already exists`,r={code:c.DomainErrorCode.DuplicateEntry,data:{eventType:t,sourceVersion:e}};return new n(i,r)}static missingUpcaster(t,e,i){const r=`Missing upcaster for event ${t} from version ${e} to ${i}`,s={code:c.DomainErrorCode.MissingValue,data:{eventType:t,fromVersion:e,toVersion:i}};return new n(r,s)}static configurationError(t,e){const i=`Configuration error in ${t}: ${e}`,r={code:c.DomainErrorCode.ValidationFailed,data:{aggregateType:t,configurationError:e}};return new n(i,r)}static cannotInterceptApplyMethod(t,e){const i=`Cannot intercept apply method - method not found on aggregate ${t}`,r={code:c.DomainErrorCode.InternalError,data:{aggergateId:t,...e}};return new n(i,r)}static eventStoreNotConfigured(t){const e="Event store not configured",i={code:c.DomainErrorCode.MissingValue,data:t};return new n(e,i)}static aggregateDoesNotSupportReplay(t,e){const i=`Aggregate ${t} does not support event replay`,r={code:c.DomainErrorCode.MethodNotSupported,data:{aggregateType:t,...e}};return new n(i,r)}}class b extends p{constructor(){super(...arguments),this.type="eventSourcing",this.eventStore=null}static get capabilityType(){return"eventSourcing"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this.eventStore=null}setEventStore(t){this.eventStore=t}getEventStore(){return this.eventStore}async loadFromEventStore(t){if(!this.eventStore)throw n.configurationError(this.aggregate.constructor.name,"Event store not configured");const e=await this.eventStore.getEvents(t);if(e.length===0)return;const i=this.aggregate;i.loadFromHistory&&i.loadFromHistory(e)}async saveToEventStore(){if(!this.eventStore)throw n.configurationError(this.aggregate.constructor.name,"Event store not configured");const t=this.aggregate.getDomainEvents();t.length!==0&&await this.eventStore.saveEvents(this.aggregate.getId().toString(),[...t],this.aggregate.getInitialVersion())}hasEventStore(){return this.eventStore!==null}getStreamName(){return`${this.aggregate.constructor.name}-${this.aggregate.getId().toString()}`}async loadFromVersion(t,e){if(!this.eventStore)throw n.configurationError(this.aggregate.constructor.name,"Event store not configured");const i=await this.eventStore.getEventsAfterVersion(t,e),r=this.aggregate;r.loadFromHistory&&i.length>0&&r.loadFromHistory(i)}}class w extends p{constructor(){super(...arguments),this.type="snapshot",this._snapshot=null}static get capabilityType(){return"snapshot"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this._snapshot=null}createSnapshot(t,e){const i=this.aggregate.getDomainEvents(),s=(i.length>0?i[i.length-1]:null)?.metadata?.eventId,h={aggregateId:this.aggregate.getId().toString(),version:this.aggregate.getVersion(),aggregateType:this.aggregate.constructor.name,state:t(),timestamp:new Date,...s!==void 0&&{lastEventId:s}};return e&&(h.metadata=e()),h}restoreFromSnapshot(t,e,i){if(!t||!t.state)throw n.invalidSnapshot(this.aggregate.constructor.name,"Invalid snapshot");const r=this.aggregate.getId().toString();if(t.aggregateId!==r)throw n.idMismatch(t.aggregateId,r);if(t.aggregateType!==this.aggregate.constructor.name)throw n.typeMismatch(t.aggregateType,this.aggregate.constructor.name);e(t.state),t.metadata&&i&&i(t.metadata);const s=this.aggregate;s._internal_setState&&s._internal_setState({version:t.version,initialVersion:t.version,domainEvents:[]})}saveTemporaryState(t){this._snapshot=this.createSnapshot(()=>t)}getLastSnapshotTimestamp(){return this._snapshot?.timestamp||null}saveSnapshot(t,e){this._snapshot=this.createSnapshot(t,e)}getPreviousState(){const t=this._snapshot;return this._snapshot=null,t}}class v{constructor(t){this.capabilities=[],this.params=t}static create(t){const e={id:t.id instanceof g?t.id:new g(t.id,"text"),version:t.version||0};return new v(e)}withSnapshots(){return this.capabilities.push({capability:new w}),this}withVersioning(){return this.capabilities.push({capability:new d}),this}withAudit(){return this.capabilities.push({capability:new y}),this}withEventSourcing(t){const e=new b;return this.capabilities.push({capability:e,configure:i=>{const r=i;t?r.setEventStore(t):this.eventStore&&r.setEventStore(this.eventStore)}}),this}withCapability(t,e){return this.capabilities.push({capability:t,configure:e?i=>e(i):void 0}),this}setEventStore(t){return this.eventStore=t,this}build(t){const e=t||f,i=new e(this.params);for(const{capability:r,configure:s}of this.capabilities)i.addCapability(r),s&&s(r);return i}buildWithAllCapabilities(t){return this.withSnapshots().withVersioning().withAudit().withEventSourcing().build(t)}}function N(a){return v.create(a)}class E{constructor(t){this._id=t}getId(){return this._id}equals(t){return t==null?!1:t===this?!0:t instanceof E?this._id.equals(t._id):!1}}function A(a){return a.hasCapability(w)}function C(a){return a.hasCapability(d)}function x(a){return a.hasCapability(y)}function V(a){return a.hasCapability(b)}function M(a){if(!A(a))throw n.featureNotEnabled("snapshot");return a}function F(a){return A(a)?o.ok(a):o.fail(n.featureNotEnabled("snapshot"))}function L(a){if(!C(a))throw n.featureNotEnabled("versioning");return a}function U(a){return C(a)?o.ok(a):o.fail(n.featureNotEnabled("versioning"))}function k(a){if(!x(a))throw n.featureNotEnabled("audit");return a}function B(a){return x(a)?o.ok(a):o.fail(n.featureNotEnabled("audit"))}function O(a){if(!V(a))throw n.featureNotEnabled("eventSourcing");return a}function j(a){return V(a)?o.ok(a):o.fail(n.featureNotEnabled("eventSourcing"))}function H(a){return a.getCapabilityTypes()}function P(a,t){return t.every(e=>a.hasCapability(e))}exports.AggregateBuilder=v;exports.AggregateError=n;exports.AggregateRoot=f;exports.AuditCapability=y;exports.Entity=E;exports.EventSourcingCapability=b;exports.SnapshotCapability=w;exports.VersioningCapability=d;exports.aggregateBuilder=N;exports.asAuditAggregate=k;exports.asEventSourcingAggregate=O;exports.asSnapshotAggregate=M;exports.asVersioningAggregate=L;exports.getAggregateCapabilities=H;exports.hasAllCapabilities=P;exports.tryAsAuditAggregate=B;exports.tryAsEventSourcingAggregate=j;exports.tryAsSnapshotAggregate=F;exports.tryAsVersioningAggregate=U;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const h=require("@vytches/ddd-contracts"),D=require("@vytches/ddd-logging"),o=require("@vytches/ddd-domain-primitives"),u=require("@vytches/ddd-utils");class d extends h.Capability{constructor(){super(...arguments),this.type="versioning",this.upcasters=new Map}static get capabilityType(){return"versioning"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this.upcasters.clear()}registerUpcaster(t,e,i){this.upcasters.has(t)||this.upcasters.set(t,new Map),this.upcasters.get(t).set(e,i)}handleVersionedEvent(t,e){const i=t.metadata?.version||1,a=t.metadata?.targetVersion||i;let n=t;if(i<a&&this.upcasters.has(t.eventName)){const c=this.upcasters.get(t.eventName),m=D.Logger.forContext("VersioningCapability");for(let l=i;l<a;l++){const S=c.get(l);if(!S){m.warn("Missing upcaster for event version — event will be processed without upcast",{eventName:t.eventName,fromVersion:l,toVersion:l+1});continue}const V=S.upcast(n.payload,n.metadata);n={...n,payload:V,metadata:{...n.metadata,version:l+1}}}}const g=e.get(n.eventName);g&&g(n.payload,n.metadata)}getRegisteredEventTypes(){return Array.from(this.upcasters.keys())}hasUpcaster(t,e){return this.upcasters.get(t)?.has(e)||!1}getUpcastersForType(t){return this.upcasters.get(t)}clearUpcastersForType(t){this.upcasters.delete(t)}getTotalUpcasterCount(){let t=0;for(const e of this.upcasters.values())t+=e.size;return t}}class p{constructor(t){this._version=0,this._initialVersion=0,this._domainEvents=[],this._eventHandlers=new Map,this._capabilities=new h.CapabilityRegistry,this._id=t.id,this._version=t.version||0,this._initialVersion=t.version||0,this._maxEvents=t.maxEvents}getId(){return this._id}getVersion(){return this._version}getInitialVersion(){return this._initialVersion}hasChanges(){return this._domainEvents.length>0}getDomainEvents(){return[...this._domainEvents]}commit(){this._domainEvents=[],this._initialVersion=this._version}registerEventHandler(t,e){return this._eventHandlers.set(t,e),this}apply(t,e,i){this._version++;let a,n;typeof t=="string"?(a=h.createDomainEvent(t,e,i),n=a.metadata):(a=t,n=i?{...a.metadata,...i}:a.metadata);const g=p.sanitizeMetadata({...n,aggregateId:this._id.toString(),aggregateType:this.constructor.name,aggregateVersion:this._version,timestamp:n?.timestamp??new Date}),c=Object.assign(Object.create(Object.getPrototypeOf(a)),a,{metadata:g});if(this._maxEvents!==void 0&&this._domainEvents.length>=this._maxEvents)throw new Error(`Aggregate ${this.constructor.name} (id=${this._id.toString()}) exceeded maxEvents limit of ${this._maxEvents}. This usually indicates a runaway loop or replay of a corrupted event stream. Increase maxEvents in the aggregate constructor params if the limit is too restrictive for your domain.`);this._domainEvents.push(c),this.handleEvent(c)}handleEvent(t){const e=this.getCapability(d);if(e)e.handleVersionedEvent(t,this._eventHandlers);else{const i=this._eventHandlers.get(t.eventName);i&&i(t.payload,t.metadata)}}loadFromHistory(t){this._version=this._initialVersion,this._domainEvents=[];for(const e of t)this.handleEvent(e),this._version++;this._initialVersion=this._version}addCapability(t){return"attach"in t&&typeof t.attach=="function"&&t.attach(this),this._capabilities.register(t),this}getCapability(t){return this._capabilities.get(t)}hasCapability(t){return this._capabilities.has(t)}removeCapability(t){const e=this._capabilities.get(t);return e&&"detach"in e&&typeof e.detach=="function"&&e.detach(),this._capabilities.remove(t),this}getAllCapabilities(){return this._capabilities.getAll()}getCapabilityTypes(){return this._capabilities.getTypes()}static sanitizeMetadata(t){if(!Object.prototype.hasOwnProperty.call(t,"__proto__")&&!Object.prototype.hasOwnProperty.call(t,"constructor")&&!Object.prototype.hasOwnProperty.call(t,"prototype"))return t;const e={};for(const i of Object.keys(t))i==="__proto__"||i==="constructor"||i==="prototype"||(e[i]=t[i]);return e}_internal_setState(t){this._version=t.version,this._initialVersion=t.initialVersion,this._domainEvents=[...t.domainEvents]}}class f extends h.Capability{constructor(){super(...arguments),this.type="audit",this.auditLog=[]}static get capabilityType(){return"audit"}attach(t){this.aggregate=t;const e=this.aggregate;typeof e.apply=="function"&&(this.originalApply=e.apply,this.originalApply&&(this.aggregate.apply=(...i)=>{const a=this.originalApply.call(this.aggregate,...i);return this.recordAuditEvent(),a}))}detach(){this.aggregate&&this.originalApply&&(this.aggregate.apply=this.originalApply),this.aggregate=void 0,this.auditLog=[],this.originalApply=void 0}getAuditLog(){return[...this.auditLog]}clearAuditLog(){this.auditLog=[]}getAuditStatistics(){const t={};let e=0;this.auditLog.forEach((a,n)=>{if(t[a.eventName]=(t[a.eventName]||0)+1,n>0){const g=this.auditLog[n-1];if(g){const c=new Date(g.timestamp).getTime(),m=new Date(a.timestamp).getTime();e+=m-c}}});const i=this.auditLog.length>1?e/(this.auditLog.length-1):0;return{totalEvents:this.auditLog.length,eventsByType:t,averageTimeBetweenEvents:i}}recordAuditEvent(){const t=this.aggregate.getDomainEvents(),e=t[t.length-1];e&&this.recordEvent(e)}recordEvent(t){const e={eventId:t.metadata?.eventId||`audit-${Date.now()}-${Math.random()}`,eventName:t.eventName,aggregateId:this.aggregate.getId().toString(),aggregateType:this.aggregate.constructor.name,aggregateVersion:this.aggregate.getVersion(),timestamp:new Date,payload:t.payload,metadata:{...t.metadata,auditCapability:!0},actor:t.metadata?.userId};this.auditLog.push(e)}getEventsByName(t){return this.auditLog.filter(e=>e.eventName===t)}getEventsByTimeRange(t,e){return this.auditLog.filter(i=>{const a=new Date(i.timestamp).getTime();return a>=t.getTime()&&a<=e.getTime()})}getFirstEvent(){return this.auditLog[0]||null}getLastEvent(){return this.auditLog[this.auditLog.length-1]||null}}class r extends o.IDomainError{static invalidArguments(t,e){const i={code:o.DomainErrorCode.InvalidParameter,data:e};return new r(t,i)}static versionConflict(t,e,i,a){const n=`Version conflict: Aggregate ${t} with ID ${e} has version ${i}, but expected ${a}`,g={code:o.DomainErrorCode.ValidationFailed,data:{aggregateType:t,aggregateId:e,currentVersion:i,expectedVersion:a}};return new r(n,g)}static featureNotEnabled(t){const e=`Feature '${t}' is not enabled on aggregate`,i={code:o.DomainErrorCode.ValidationFailed,data:{feature:t}};return new r(e,i)}static methodNotImplemented(t,e){const i=`Method '${t}' must be implemented by ${e} to use this feature`,a={code:o.DomainErrorCode.MissingValue,data:{methodName:t,aggregateType:e}};return new r(i,a)}static invalidSnapshot(t,e){const i=`Invalid snapshot for aggregate ${t}${e?`: ${e}`:""}`,a={code:o.DomainErrorCode.InvalidFormat,data:{aggregateType:t,reason:e}};return new r(i,a)}static idMismatch(t,e){const i=`ID mismatch: Snapshot is for ID ${t}, but aggregate has ID ${e}`,a={code:o.DomainErrorCode.ValidationFailed,data:{snapshotId:t,aggregateId:e}};return new r(i,a)}static typeMismatch(t,e){const i=`Aggregate type mismatch: Snapshot is for type ${t}, but trying to load into ${e}`,a={code:o.DomainErrorCode.ValidationFailed,data:{snapshotType:t,aggregateType:e}};return new r(i,a)}static duplicateUpcaster(t,e){const i=`Upcaster for event ${t} version ${e} already exists`,a={code:o.DomainErrorCode.DuplicateEntry,data:{eventType:t,sourceVersion:e}};return new r(i,a)}static missingUpcaster(t,e,i){const a=`Missing upcaster for event ${t} from version ${e} to ${i}`,n={code:o.DomainErrorCode.MissingValue,data:{eventType:t,fromVersion:e,toVersion:i}};return new r(a,n)}static configurationError(t,e){const i=`Configuration error in ${t}: ${e}`,a={code:o.DomainErrorCode.ValidationFailed,data:{aggregateType:t,configurationError:e}};return new r(i,a)}static cannotInterceptApplyMethod(t,e){const i=`Cannot intercept apply method - method not found on aggregate ${t}`,a={code:o.DomainErrorCode.InternalError,data:{aggergateId:t,...e}};return new r(i,a)}static eventStoreNotConfigured(t){const e="Event store not configured",i={code:o.DomainErrorCode.MissingValue,data:t};return new r(e,i)}static aggregateDoesNotSupportReplay(t,e){const i=`Aggregate ${t} does not support event replay`,a={code:o.DomainErrorCode.MethodNotSupported,data:{aggregateType:t,...e}};return new r(i,a)}}class y extends h.Capability{constructor(){super(...arguments),this.type="eventSourcing",this.eventStore=null}static get capabilityType(){return"eventSourcing"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this.eventStore=null}setEventStore(t){this.eventStore=t}getEventStore(){return this.eventStore}async loadFromEventStore(t){if(!this.eventStore)throw r.configurationError(this.aggregate.constructor.name,"Event store not configured");const e=await this.eventStore.getEvents(t);if(e.length===0)return;const i=this.aggregate;i.loadFromHistory&&i.loadFromHistory(e)}async saveToEventStore(){if(!this.eventStore)throw r.configurationError(this.aggregate.constructor.name,"Event store not configured");const t=this.aggregate.getDomainEvents();t.length!==0&&await this.eventStore.saveEvents(this.aggregate.getId().toString(),[...t],this.aggregate.getInitialVersion())}hasEventStore(){return this.eventStore!==null}getStreamName(){return`${this.aggregate.constructor.name}-${this.aggregate.getId().toString()}`}async loadFromVersion(t,e){if(!this.eventStore)throw r.configurationError(this.aggregate.constructor.name,"Event store not configured");const i=await this.eventStore.getEventsAfterVersion(t,e),a=this.aggregate;a.loadFromHistory&&i.length>0&&a.loadFromHistory(i)}}class E extends h.Capability{constructor(){super(...arguments),this.type="snapshot",this._snapshot=null}static get capabilityType(){return"snapshot"}attach(t){this.aggregate=t}detach(){this.aggregate=void 0,this._snapshot=null}createSnapshot(t,e){const i=this.aggregate.getDomainEvents(),n=(i.length>0?i[i.length-1]:null)?.metadata?.eventId,c={aggregateId:this.aggregate.getId().toString(),version:this.aggregate.getVersion(),aggregateType:this.aggregate.constructor.name,state:t(),timestamp:new Date,...n!==void 0&&{lastEventId:n}};return e&&(c.metadata=e()),c}restoreFromSnapshot(t,e,i){if(!t||!t.state)throw r.invalidSnapshot(this.aggregate.constructor.name,"Invalid snapshot");const a=this.aggregate.getId().toString();if(t.aggregateId!==a)throw r.idMismatch(t.aggregateId,a);if(t.aggregateType!==this.aggregate.constructor.name)throw r.typeMismatch(t.aggregateType,this.aggregate.constructor.name);e(t.state),t.metadata&&i&&i(t.metadata);const n=this.aggregate;n._internal_setState&&n._internal_setState({version:t.version,initialVersion:t.version,domainEvents:[]})}saveTemporaryState(t){this._snapshot=this.createSnapshot(()=>t)}getLastSnapshotTimestamp(){return this._snapshot?.timestamp||null}saveSnapshot(t,e){this._snapshot=this.createSnapshot(t,e)}getPreviousState(){const t=this._snapshot;return this._snapshot=null,t}}class v{constructor(t){this.capabilities=[],this.params=t}static create(t){const e={id:t.id instanceof h.EntityId?t.id:new h.EntityId(t.id,"text"),version:t.version||0};return new v(e)}withSnapshots(){return this.capabilities.push({capability:new E}),this}withVersioning(){return this.capabilities.push({capability:new d}),this}withAudit(){return this.capabilities.push({capability:new f}),this}withEventSourcing(t){const e=new y;return this.capabilities.push({capability:e,configure:i=>{const a=i;t?a.setEventStore(t):this.eventStore&&a.setEventStore(this.eventStore)}}),this}withCapability(t,e){return this.capabilities.push({capability:t,configure:e?i=>e(i):void 0}),this}setEventStore(t){return this.eventStore=t,this}build(t){const e=t||p,i=new e(this.params);for(const{capability:a,configure:n}of this.capabilities)i.addCapability(a),n&&n(a);return i}buildWithAllCapabilities(t){return this.withSnapshots().withVersioning().withAudit().withEventSourcing().build(t)}}function I(s){return v.create(s)}class b{constructor(t){this._id=t}getId(){return this._id}equals(t){return t==null?!1:t===this?!0:t instanceof b?this._id.equals(t._id):!1}}function w(s){return s.hasCapability(E)}function C(s){return s.hasCapability(d)}function _(s){return s.hasCapability(f)}function A(s){return s.hasCapability(y)}function $(s){if(!w(s))throw r.featureNotEnabled("snapshot");return s}function N(s){return w(s)?u.Result.ok(s):u.Result.fail(r.featureNotEnabled("snapshot"))}function L(s){if(!C(s))throw r.featureNotEnabled("versioning");return s}function M(s){return C(s)?u.Result.ok(s):u.Result.fail(r.featureNotEnabled("versioning"))}function T(s){if(!_(s))throw r.featureNotEnabled("audit");return s}function F(s){return _(s)?u.Result.ok(s):u.Result.fail(r.featureNotEnabled("audit"))}function x(s){if(!A(s))throw r.featureNotEnabled("eventSourcing");return s}function R(s){return A(s)?u.Result.ok(s):u.Result.fail(r.featureNotEnabled("eventSourcing"))}function U(s){return s.getCapabilityTypes()}function H(s,t){return t.every(e=>s.hasCapability(e))}exports.AggregateBuilder=v;exports.AggregateError=r;exports.AggregateRoot=p;exports.AuditCapability=f;exports.Entity=b;exports.EventSourcingCapability=y;exports.SnapshotCapability=E;exports.VersioningCapability=d;exports.aggregateBuilder=I;exports.asAuditAggregate=T;exports.asEventSourcingAggregate=x;exports.asSnapshotAggregate=$;exports.asVersioningAggregate=L;exports.getAggregateCapabilities=U;exports.hasAllCapabilities=H;exports.tryAsAuditAggregate=F;exports.tryAsEventSourcingAggregate=R;exports.tryAsSnapshotAggregate=N;exports.tryAsVersioningAggregate=M;

package/dist/index.js

@@ -1,403 +1,8 @@
-import { Logger as _ } from "/home/runner/work/ddd/ddd/packages/logging/dist/index.js";
-import { IDomainError as I, DomainErrorCode as c } from "/home/runner/work/ddd/ddd/packages/domain-primitives/dist/index.js";
-function $() {
-  return globalThis.crypto.randomUUID();
-}
-function N(s, t, e) {
-  return {
-    eventName: s,
-    payload: t,
-    metadata: {
-      eventId: $(),
-      timestamp: /* @__PURE__ */ new Date(),
-      ...e
-    }
-  };
-}
-class p {
-  /**
-   * Checks if this capability is of a specific type
-   */
-  isType(t) {
-    return this.type === t;
-  }
-  /**
-   * Static type getter for compile-time type extraction
-   * Each capability must override this
-   */
-  static get capabilityType() {
-    throw new Error("Capability subclass must override static capabilityType getter");
-  }
-}
-class D {
-  constructor() {
-    this.capabilities = /* @__PURE__ */ new Map();
-  }
-  /**
-   * Register a capability
-   */
-  register(t) {
-    return this.capabilities.set(t.type, t), this;
-  }
-  /**
-   * Get a capability by its constructor
-   */
-  get(t) {
-    const e = t.capabilityType;
-    return this.capabilities.get(e);
-  }
-  /**
-   * Get a capability by its type string
-   */
-  getByType(t) {
-    return this.capabilities.get(t);
-  }
-  /**
-   * Check if a capability exists
-   */
-  has(t) {
-    const e = t.capabilityType;
-    return this.capabilities.has(e);
-  }
-  /**
-   * Check if a capability exists by type
-   */
-  hasByType(t) {
-    return this.capabilities.has(t);
-  }
-  /**
-   * Remove a capability
-   */
-  remove(t) {
-    const e = t.capabilityType;
-    return this.capabilities.delete(e);
-  }
-  /**
-   * Remove a capability by type
-   */
-  removeByType(t) {
-    return this.capabilities.delete(t);
-  }
-  /**
-   * Get all registered capabilities
-   */
-  getAll() {
-    return Array.from(this.capabilities.values());
-  }
-  /**
-   * Get all capability types
-   */
-  getTypes() {
-    return Array.from(this.capabilities.keys());
-  }
-  /**
-   * Clear all capabilities
-   */
-  clear() {
-    this.capabilities.clear();
-  }
-  /**
-   * Get the number of registered capabilities
-   */
-  get size() {
-    return this.capabilities.size;
-  }
-}
-class u {
-  constructor(t, e = "text") {
-    this.value = t, this.type = e;
-  }
-  /**
-   * Returns the stored identifier value
-   * @returns The identifier value
-   * @example
-   * ```typescript
-   * const id = EntityId.fromText('user-123');
-   * const value = id.getValue(); // Returns: 'user-123'
-   * ```
-   */
-  getValue() {
-    return this.value;
-  }
-  /**
-   * Returns the identifier type (text, uuid, integer, bigint)
-   * @returns The identifier type
-   * @example
-   * ```typescript
-   * const id = EntityId.fromUUID('550e8400-e29b-41d4-a716-446655440000');
-   * const type = id.getType(); // Returns: 'uuid'
-   * ```
-   */
-  getType() {
-    return this.type;
-  }
-  validate(t) {
-    return t != null && t !== void 0;
-  }
-  /**
-   * Compares this EntityId with another for equality
-   * @returns True if entities have same value and type
-   * @example
-   * ```typescript
-   * const id1 = EntityId.fromText('user-123');
-   * const id2 = EntityId.fromText('user-123');
-   * const isEqual = id1.equals(id2); // Returns: true
-   * ```
-   */
-  equals(t) {
-    return t.getValue() === this.value && t.getType() === this.type;
-  }
-  isType(t) {
-    return this.type === t;
-  }
-  toString() {
-    return String(this.value);
-  }
-  toJSON() {
-    return JSON.stringify({
-      value: this.value,
-      type: this.type
-    });
-  }
-  /**
-   * Primary factory method - creates a new EntityId with a randomly generated UUID
-   * @returns New EntityId with random UUID
-   * @example
-   * ```typescript
-   * const id = EntityId.create();
-   * console.log(id.getValue()); // Returns: '550e8400-e29b-41d4-a716-446655440000'
-   * ```
-   */
-  static create() {
-    const t = "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (e) => {
-      const i = Math.random() * 16 | 0;
-      return (e === "x" ? i : i & 3 | 8).toString(16);
-    });
-    return new u(t, "uuid");
-  }
-  /**
-   * @deprecated Use `fromText()` instead. Will be removed in next major version.
-   */
-  static createText(t) {
-    return new u(t, "text");
-  }
-  /**
-   * @deprecated Use `fromUUID()` instead. Will be removed in next major version.
-   */
-  static createUuid(t) {
-    return new u(t, "uuid");
-  }
-  /**
-   * @deprecated Use `fromInteger()` instead. Will be removed in next major version.
-   */
-  static createInteger(t) {
-    return new u(t.toString(), "integer");
-  }
-  /**
-   * @deprecated Use `fromBigInt()` instead. Will be removed in next major version.
-   */
-  static createBigInt(t) {
-    const e = typeof t == "bigint" ? t.toString() : t;
-    return new u(e, "bigint");
-  }
-  /**
-   * @deprecated Use `create()` instead. Will be removed in next major version.
-   * Creates a new EntityId with a randomly generated UUID
-   * @returns New EntityId with random UUID
-   */
-  static createWithRandomUUID() {
-    return u.create();
-  }
-  /**
-   * Creates an EntityId from a UUID string with validation
-   * @returns EntityId from UUID string
-   * @example
-   * ```typescript
-   * const id = EntityId.fromUUID('550e8400-e29b-41d4-a716-446655440000');
-   * console.log(id.getType()); // Returns: 'uuid'
-   * ```
-   */
-  static fromUUID(t) {
-    if (!t || typeof t != "string")
-      throw new Error("entity identifier must be provided");
-    if (!/^[0-9a-f]{8}-[0-9a-f]{4}-[1-5][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(t))
-      throw new Error("entity identifier must be valid UUID");
-    return new u(t, "uuid");
-  }
-  static fromInteger(t) {
-    if (typeof t != "number" || t < 0 || !Number.isInteger(t))
-      throw new Error("entity identifier must be a non-negative integer");
-    return new u(t.toString(), "integer");
-  }
-  static fromBigInt(t) {
-    const e = typeof t == "bigint" ? t.toString() : t;
-    if (!e || typeof e != "string")
-      throw new Error("entity identifier must be a valid bigint");
-    return new u(e, "bigint");
-  }
-  /**
-   * Creates an EntityId from a text string with validation
-   * @returns EntityId from text string
-   * @example
-   * ```typescript
-   * const id = EntityId.fromText('user-123');
-   * console.log(id.getValue()); // Returns: 'user-123'
-   * ```
-   */
-  static fromText(t) {
-    if (!t || typeof t != "string")
-      throw new Error("entity identifier must be provided");
-    if (!/^[a-zA-Z0-9_-]+$/.test(t))
-      throw new Error("entity identifier contains invalid characters");
-    return new u(t, "text");
-  }
-}
-class o {
-  constructor(t, e, i) {
-    this._isSuccess = t, this._value = e, this._error = i;
-  }
-  /**
-   * Check if the result is successful
-   */
-  get isSuccess() {
-    return this._isSuccess;
-  }
-  /**
-   * Check if the result is a failure
-   */
-  get isFailure() {
-    return !this._isSuccess;
-  }
-  /**
-   * Get the success value
-   * @throws Error if the result is a failure
-   */
-  get value() {
-    if (!this._isSuccess)
-      throw new Error("Cannot get value of a failure result");
-    return this._value;
-  }
-  /**
-   * Get the error value
-   * @throws Error if the result is successful
-   */
-  get error() {
-    if (this._isSuccess)
-      throw new Error("Cannot get error of a success result");
-    return this._error;
-  }
-  /**
-   * Create a successful result
-   * @param value - The success value (required — use Result.empty() for void operations)
-   */
-  static ok(t) {
-    return new o(!0, t);
-  }
-  /**
-   * Create a successful void result (no value).
-   */
-  static empty() {
-    return new o(!0, void 0);
-  }
-  /**
-   * Create a failure result
-   * @param error - The error value
-   */
-  static fail(t) {
-    return new o(!1, void 0, t);
-  }
-  /**
-   * Try to execute a function and wrap the result
-   * @param fn - The function to try
-   * @returns A Result containing the function result or error
-   */
-  static try(t) {
-    try {
-      return o.ok(t());
-    } catch (e) {
-      return o.fail(e instanceof Error ? e : new Error(String(e)));
-    }
-  }
-  /**
-   * Transform the success value
-   * @param fn - The transformation function
-   */
-  map(t) {
-    return this.isFailure ? o.fail(this.error) : o.ok(t(this.value));
-  }
-  /**
-   * Transform the success value with a function that returns a Result
-   * @param fn - The transformation function
-   */
-  flatMap(t) {
-    return this.isFailure ? o.fail(this.error) : t(this.value);
-  }
-  /**
-   * Apply a function based on success or failure
-   * @param onSuccess - Function to call on success
-   * @param onFailure - Function to call on failure
-   */
-  match(t, e) {
-    return this.isSuccess ? t(this.value) : e(this.error);
-  }
-  /**
-   * Apply a side effect if the result is successful
-   * @param fn - The side effect function
-   */
-  tap(t) {
-    return this.isSuccess && t(this.value), this;
-  }
-  /**
-   * Apply a side effect if the result is a failure
-   * @param fn - The side effect function
-   */
-  tapError(t) {
-    return this.isFailure && t(this.error), this;
-  }
-  /**
-   * Transform the error value if the result is a failure
-   * @param fn - The error transformation function
-   */
-  mapError(t) {
-    return this.isSuccess ? o.ok(this.value) : o.fail(t(this.error));
-  }
-  /**
-   * Try to execute an async function and wrap the result
-   * @param fn - The async function to try
-   * @returns A Promise of a Result containing the function result or error
-   */
-  static async tryAsync(t) {
-    try {
-      const e = await t();
-      return o.ok(e);
-    } catch (e) {
-      return o.fail(e instanceof Error ? e : new Error(String(e)));
-    }
-  }
-  /**
-   * Transform the success value with an async function
-   * @param fn - The async transformation function
-   */
-  async mapAsync(t) {
-    if (this.isFailure)
-      return o.fail(this.error);
-    try {
-      const e = await t(this.value);
-      return o.ok(e);
-    } catch (e) {
-      const i = e instanceof Error ? e : new Error(String(e));
-      return o.fail(i);
-    }
-  }
-  /**
-   * Transform the success value with an async function that returns a Result
-   * @param fn - The async transformation function
-   */
-  async flatMapAsync(t) {
-    return this.isFailure ? o.fail(this.error) : await t(this.value);
-  }
-}
-class f extends p {
+import { Capability as l, CapabilityRegistry as $, createDomainEvent as N, EntityId as y } from "@vytches/ddd-contracts";
+import { Logger as L } from "@vytches/ddd-logging";
+import { IDomainError as M, DomainErrorCode as o } from "@vytches/ddd-domain-primitives";
+import { Result as h } from "@vytches/ddd-utils";
+class p extends l {
   constructor() {
     super(...arguments), this.type = "versioning", this.upcasters = /* @__PURE__ */ new Map();
   }
@@ -426,36 +31,36 @@ class f extends p {
    * @param {Map<string, IAggregateEventHandler>} handlers - Map of event handlers
    */
   handleVersionedEvent(t, e) {
-    const i = t.metadata?.version || 1, r = t.metadata?.targetVersion || i;
-    let a = t;
-    if (i < r && this.upcasters.has(t.eventName)) {
-      const g = this.upcasters.get(t.eventName), d = _.forContext("VersioningCapability");
-      for (let l = i; l < r; l++) {
-        const y = g.get(l);
-        if (!y) {
+    const i = t.metadata?.version || 1, a = t.metadata?.targetVersion || i;
+    let n = t;
+    if (i < a && this.upcasters.has(t.eventName)) {
+      const g = this.upcasters.get(t.eventName), d = L.forContext("VersioningCapability");
+      for (let u = i; u < a; u++) {
+        const f = g.get(u);
+        if (!f) {
           d.warn(
             "Missing upcaster for event version — event will be processed without upcast",
             {
               eventName: t.eventName,
-              fromVersion: l,
-              toVersion: l + 1
+              fromVersion: u,
+              toVersion: u + 1
             }
           );
           continue;
         }
-        const T = y.upcast(a.payload, a.metadata);
-        a = {
-          ...a,
-          payload: T,
+        const I = f.upcast(n.payload, n.metadata);
+        n = {
+          ...n,
+          payload: I,
           metadata: {
-            ...a.metadata,
-            version: l + 1
+            ...n.metadata,
+            version: u + 1
           }
         };
       }
     }
-    const h = e.get(a.eventName);
-    h && h(a.payload, a.metadata);
+    const c = e.get(n.eventName);
+    c && c(n.payload, n.metadata);
   }
   /**
    * @returns {string[]} Array of event types that have registered upcasters
@@ -496,7 +101,7 @@ class f extends p {
 }
 class v {
   constructor(t) {
-    this._version = 0, this._initialVersion = 0, this._domainEvents = [], this._eventHandlers = /* @__PURE__ */ new Map(), this._capabilities = new D(), this._id = t.id, this._version = t.version || 0, this._initialVersion = t.version || 0, this._maxEvents = t.maxEvents;
+    this._version = 0, this._initialVersion = 0, this._domainEvents = [], this._eventHandlers = /* @__PURE__ */ new Map(), this._capabilities = new $(), this._id = t.id, this._version = t.version || 0, this._initialVersion = t.version || 0, this._maxEvents = t.maxEvents;
   }
   // ==========================================
   // CORE AGGREGATE FUNCTIONALITY
@@ -560,18 +165,18 @@ class v {
    */
   apply(t, e, i) {
     this._version++;
-    let r, a;
-    typeof t == "string" ? (r = N(t, e, i), a = r.metadata) : (r = t, a = i ? { ...r.metadata, ...i } : r.metadata);
-    const h = v.sanitizeMetadata({
-      ...a,
+    let a, n;
+    typeof t == "string" ? (a = N(t, e, i), n = a.metadata) : (a = t, n = i ? { ...a.metadata, ...i } : a.metadata);
+    const c = v.sanitizeMetadata({
+      ...n,
       aggregateId: this._id.toString(),
       aggregateType: this.constructor.name,
       aggregateVersion: this._version,
-      timestamp: a?.timestamp ?? /* @__PURE__ */ new Date()
+      timestamp: n?.timestamp ?? /* @__PURE__ */ new Date()
     }), g = Object.assign(
-      Object.create(Object.getPrototypeOf(r)),
-      r,
-      { metadata: h }
+      Object.create(Object.getPrototypeOf(a)),
+      a,
+      { metadata: c }
     );
     if (this._maxEvents !== void 0 && this._domainEvents.length >= this._maxEvents)
       throw new Error(
@@ -580,7 +185,7 @@ class v {
     this._domainEvents.push(g), this.handleEvent(g);
   }
   handleEvent(t) {
-    const e = this.getCapability(f);
+    const e = this.getCapability(p);
     if (e)
       e.handleVersionedEvent(t, this._eventHandlers);
     else {
@@ -665,7 +270,7 @@ class v {
     this._version = t.version, this._initialVersion = t.initialVersion, this._domainEvents = [...t.domainEvents];
   }
 }
-class b extends p {
+class b extends l {
   constructor() {
     super(...arguments), this.type = "audit", this.auditLog = [];
   }
@@ -679,8 +284,8 @@ class b extends p {
     this.aggregate = t;
     const e = this.aggregate;
     typeof e.apply == "function" && (this.originalApply = e.apply, this.originalApply && (this.aggregate.apply = (...i) => {
-      const r = this.originalApply.call(this.aggregate, ...i);
-      return this.recordAuditEvent(), r;
+      const a = this.originalApply.call(this.aggregate, ...i);
+      return this.recordAuditEvent(), a;
     }));
   }
   detach() {
@@ -701,11 +306,11 @@ class b extends p {
   getAuditStatistics() {
     const t = {};
     let e = 0;
-    this.auditLog.forEach((r, a) => {
-      if (t[r.eventName] = (t[r.eventName] || 0) + 1, a > 0) {
-        const h = this.auditLog[a - 1];
-        if (h) {
-          const g = new Date(h.timestamp).getTime(), d = new Date(r.timestamp).getTime();
+    this.auditLog.forEach((a, n) => {
+      if (t[a.eventName] = (t[a.eventName] || 0) + 1, n > 0) {
+        const c = this.auditLog[n - 1];
+        if (c) {
+          const g = new Date(c.timestamp).getTime(), d = new Date(a.timestamp).getTime();
           e += d - g;
         }
       }
@@ -758,8 +363,8 @@ class b extends p {
    */
   getEventsByTimeRange(t, e) {
     return this.auditLog.filter((i) => {
-      const r = new Date(i.timestamp).getTime();
-      return r >= t.getTime() && r <= e.getTime();
+      const a = new Date(i.timestamp).getTime();
+      return a >= t.getTime() && a <= e.getTime();
     });
   }
   /**
@@ -775,174 +380,174 @@ class b extends p {
     return this.auditLog[this.auditLog.length - 1] || null;
   }
 }
-class n extends I {
+class r extends M {
   /**
    * Error for invalid arguments provided to the aggregate
    */
   static invalidArguments(t, e) {
     const i = {
-      code: c.InvalidParameter,
+      code: o.InvalidParameter,
       data: e
     };
-    return new n(t, i);
+    return new r(t, i);
   }
   /**
    * Error for version conflicts in the aggregate
    */
-  static versionConflict(t, e, i, r) {
-    const a = `Version conflict: Aggregate ${t} with ID ${e} has version ${i}, but expected ${r}`, h = {
-      code: c.ValidationFailed,
+  static versionConflict(t, e, i, a) {
+    const n = `Version conflict: Aggregate ${t} with ID ${e} has version ${i}, but expected ${a}`, c = {
+      code: o.ValidationFailed,
       data: {
         aggregateType: t,
         aggregateId: e,
         currentVersion: i,
-        expectedVersion: r
+        expectedVersion: a
       }
     };
-    return new n(a, h);
+    return new r(n, c);
   }
   /**
    * Error for when a required feature is not enabled
    */
   static featureNotEnabled(t) {
     const e = `Feature '${t}' is not enabled on aggregate`, i = {
-      code: c.ValidationFailed,
+      code: o.ValidationFailed,
       data: {
         feature: t
       }
     };
-    return new n(e, i);
+    return new r(e, i);
   }
   /**
    * Error for when a required method is not implemented
    */
   static methodNotImplemented(t, e) {
-    const i = `Method '${t}' must be implemented by ${e} to use this feature`, r = {
-      code: c.MissingValue,
+    const i = `Method '${t}' must be implemented by ${e} to use this feature`, a = {
+      code: o.MissingValue,
       data: {
         methodName: t,
         aggregateType: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for invalid snapshot
    */
   static invalidSnapshot(t, e) {
-    const i = `Invalid snapshot for aggregate ${t}${e ? `: ${e}` : ""}`, r = {
-      code: c.InvalidFormat,
+    const i = `Invalid snapshot for aggregate ${t}${e ? `: ${e}` : ""}`, a = {
+      code: o.InvalidFormat,
       data: {
         aggregateType: t,
         reason: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for ID mismatch during snapshot restoration
    */
   static idMismatch(t, e) {
-    const i = `ID mismatch: Snapshot is for ID ${t}, but aggregate has ID ${e}`, r = {
-      code: c.ValidationFailed,
+    const i = `ID mismatch: Snapshot is for ID ${t}, but aggregate has ID ${e}`, a = {
+      code: o.ValidationFailed,
       data: {
         snapshotId: t,
         aggregateId: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for type mismatch during snapshot restoration
    */
   static typeMismatch(t, e) {
-    const i = `Aggregate type mismatch: Snapshot is for type ${t}, but trying to load into ${e}`, r = {
-      code: c.ValidationFailed,
+    const i = `Aggregate type mismatch: Snapshot is for type ${t}, but trying to load into ${e}`, a = {
+      code: o.ValidationFailed,
       data: {
         snapshotType: t,
         aggregateType: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for duplicate upcaster registration
    */
   static duplicateUpcaster(t, e) {
-    const i = `Upcaster for event ${t} version ${e} already exists`, r = {
-      code: c.DuplicateEntry,
+    const i = `Upcaster for event ${t} version ${e} already exists`, a = {
+      code: o.DuplicateEntry,
       data: {
         eventType: t,
         sourceVersion: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for missing upcaster
    */
   static missingUpcaster(t, e, i) {
-    const r = `Missing upcaster for event ${t} from version ${e} to ${i}`, a = {
-      code: c.MissingValue,
+    const a = `Missing upcaster for event ${t} from version ${e} to ${i}`, n = {
+      code: o.MissingValue,
       data: {
         eventType: t,
         fromVersion: e,
         toVersion: i
       }
     };
-    return new n(r, a);
+    return new r(a, n);
   }
   /**
    * Error for configuration problems
    */
   static configurationError(t, e) {
-    const i = `Configuration error in ${t}: ${e}`, r = {
-      code: c.ValidationFailed,
+    const i = `Configuration error in ${t}: ${e}`, a = {
+      code: o.ValidationFailed,
       data: {
         aggregateType: t,
         configurationError: e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for when apply method interception fails (e.g. method not found)
    */
   static cannotInterceptApplyMethod(t, e) {
-    const i = `Cannot intercept apply method - method not found on aggregate ${t}`, r = {
-      code: c.InternalError,
+    const i = `Cannot intercept apply method - method not found on aggregate ${t}`, a = {
+      code: o.InternalError,
       data: {
         aggergateId: t,
         ...e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
   /**
    * Error for when event store is not configured
    */
   static eventStoreNotConfigured(t) {
     const e = "Event store not configured", i = {
-      code: c.MissingValue,
+      code: o.MissingValue,
       data: t
     };
-    return new n(e, i);
+    return new r(e, i);
   }
   /**
    * Error for when aggregate does not support event replay
    */
   static aggregateDoesNotSupportReplay(t, e) {
-    const i = `Aggregate ${t} does not support event replay`, r = {
-      code: c.MethodNotSupported,
+    const i = `Aggregate ${t} does not support event replay`, a = {
+      code: o.MethodNotSupported,
       data: {
         aggregateType: t,
         ...e
       }
     };
-    return new n(i, r);
+    return new r(i, a);
   }
 }
-class w extends p {
+class E extends l {
   constructor() {
     super(...arguments), this.type = "eventSourcing", this.eventStore = null;
   }
@@ -976,7 +581,7 @@ class w extends p {
    */
   async loadFromEventStore(t) {
     if (!this.eventStore)
-      throw n.configurationError(
+      throw r.configurationError(
         this.aggregate.constructor.name,
         "Event store not configured"
       );
@@ -991,7 +596,7 @@ class w extends p {
    */
   async saveToEventStore() {
     if (!this.eventStore)
-      throw n.configurationError(
+      throw r.configurationError(
         this.aggregate.constructor.name,
         "Event store not configured"
       );
@@ -1021,15 +626,15 @@ class w extends p {
    */
   async loadFromVersion(t, e) {
     if (!this.eventStore)
-      throw n.configurationError(
+      throw r.configurationError(
         this.aggregate.constructor.name,
         "Event store not configured"
       );
-    const i = await this.eventStore.getEventsAfterVersion(t, e), r = this.aggregate;
-    r.loadFromHistory && i.length > 0 && r.loadFromHistory(i);
+    const i = await this.eventStore.getEventsAfterVersion(t, e), a = this.aggregate;
+    a.loadFromHistory && i.length > 0 && a.loadFromHistory(i);
   }
 }
-class S extends p {
+class S extends l {
   constructor() {
     super(...arguments), this.type = "snapshot", this._snapshot = null;
   }
@@ -1051,13 +656,13 @@ class S extends p {
    * @returns {IAggregateSnapshot<TState, TMeta>} Created snapshot with state and metadata
    */
   createSnapshot(t, e) {
-    const i = this.aggregate.getDomainEvents(), a = (i.length > 0 ? i[i.length - 1] : null)?.metadata?.eventId, g = {
+    const i = this.aggregate.getDomainEvents(), n = (i.length > 0 ? i[i.length - 1] : null)?.metadata?.eventId, g = {
       aggregateId: this.aggregate.getId().toString(),
       version: this.aggregate.getVersion(),
       aggregateType: this.aggregate.constructor.name,
       state: t(),
       timestamp: /* @__PURE__ */ new Date(),
-      ...a !== void 0 && { lastEventId: a }
+      ...n !== void 0 && { lastEventId: n }
     };
     return e && (g.metadata = e()), g;
   }
@@ -1069,15 +674,15 @@ class S extends p {
    */
   restoreFromSnapshot(t, e, i) {
     if (!t || !t.state)
-      throw n.invalidSnapshot(this.aggregate.constructor.name, "Invalid snapshot");
-    const r = this.aggregate.getId().toString();
-    if (t.aggregateId !== r)
-      throw n.idMismatch(t.aggregateId, r);
+      throw r.invalidSnapshot(this.aggregate.constructor.name, "Invalid snapshot");
+    const a = this.aggregate.getId().toString();
+    if (t.aggregateId !== a)
+      throw r.idMismatch(t.aggregateId, a);
     if (t.aggregateType !== this.aggregate.constructor.name)
-      throw n.typeMismatch(t.aggregateType, this.aggregate.constructor.name);
+      throw r.typeMismatch(t.aggregateType, this.aggregate.constructor.name);
     e(t.state), t.metadata && i && i(t.metadata);
-    const a = this.aggregate;
-    a._internal_setState && a._internal_setState({
+    const n = this.aggregate;
+    n._internal_setState && n._internal_setState({
       version: t.version,
       initialVersion: t.version,
       domainEvents: []
@@ -1119,7 +724,7 @@ class m {
    */
   static create(t) {
     const e = {
-      id: t.id instanceof u ? t.id : new u(t.id, "text"),
+      id: t.id instanceof y ? t.id : new y(t.id, "text"),
       version: t.version || 0
     };
     return new m(e);
@@ -1131,7 +736,7 @@ class m {
    * @returns {this} Builder instance for method chaining
    */
   withVersioning() {
-    return this.capabilities.push({ capability: new f() }), this;
+    return this.capabilities.push({ capability: new p() }), this;
   }
   /**
    * @returns {this} Builder instance for method chaining
@@ -1144,12 +749,12 @@ class m {
    * @returns {this} Builder instance for method chaining
    */
   withEventSourcing(t) {
-    const e = new w();
+    const e = new E();
     return this.capabilities.push({
       capability: e,
       configure: (i) => {
-        const r = i;
-        t ? r.setEventStore(t) : this.eventStore && r.setEventStore(this.eventStore);
+        const a = i;
+        t ? a.setEventStore(t) : this.eventStore && a.setEventStore(this.eventStore);
       }
     }), this;
   }
@@ -1173,8 +778,8 @@ class m {
   }
   build(t) {
     const e = t || v, i = new e(this.params);
-    for (const { capability: r, configure: a } of this.capabilities)
-      i.addCapability(r), a && a(r);
+    for (const { capability: a, configure: n } of this.capabilities)
+      i.addCapability(a), n && n(a);
     return i;
   }
   /**
@@ -1185,10 +790,10 @@ class m {
     return this.withSnapshots().withVersioning().withAudit().withEventSourcing().build(t);
   }
 }
-function L(s) {
+function H(s) {
   return m.create(s);
 }
-class E {
+class w {
   constructor(t) {
     this._id = t;
   }
@@ -1207,54 +812,54 @@ class E {
    * @returns `true` if both entities have the same id; `false` otherwise.
    */
   equals(t) {
-    return t == null ? !1 : t === this ? !0 : t instanceof E ? this._id.equals(t._id) : !1;
+    return t == null ? !1 : t === this ? !0 : t instanceof w ? this._id.equals(t._id) : !1;
   }
 }
-function x(s) {
+function _(s) {
   return s.hasCapability(S);
 }
 function C(s) {
-  return s.hasCapability(f);
+  return s.hasCapability(p);
 }
 function V(s) {
   return s.hasCapability(b);
 }
 function A(s) {
-  return s.hasCapability(w);
+  return s.hasCapability(E);
 }
 function U(s) {
-  if (!x(s))
-    throw n.featureNotEnabled("snapshot");
+  if (!_(s))
+    throw r.featureNotEnabled("snapshot");
   return s;
 }
-function k(s) {
-  return x(s) ? o.ok(s) : o.fail(n.featureNotEnabled("snapshot"));
-}
 function O(s) {
+  return _(s) ? h.ok(s) : h.fail(r.featureNotEnabled("snapshot"));
+}
+function P(s) {
   if (!C(s))
-    throw n.featureNotEnabled("versioning");
+    throw r.featureNotEnabled("versioning");
   return s;
 }
-function B(s) {
-  return C(s) ? o.ok(s) : o.fail(n.featureNotEnabled("versioning"));
+function j(s) {
+  return C(s) ? h.ok(s) : h.fail(r.featureNotEnabled("versioning"));
 }
-function H(s) {
+function k(s) {
   if (!V(s))
-    throw n.featureNotEnabled("audit");
+    throw r.featureNotEnabled("audit");
   return s;
 }
-function P(s) {
-  return V(s) ? o.ok(s) : o.fail(n.featureNotEnabled("audit"));
+function B(s) {
+  return V(s) ? h.ok(s) : h.fail(r.featureNotEnabled("audit"));
 }
-function j(s) {
+function W(s) {
   if (!A(s))
-    throw n.featureNotEnabled("eventSourcing");
+    throw r.featureNotEnabled("eventSourcing");
   return s;
 }
-function z(s) {
-  return A(s) ? o.ok(s) : o.fail(n.featureNotEnabled("eventSourcing"));
+function R(s) {
+  return A(s) ? h.ok(s) : h.fail(r.featureNotEnabled("eventSourcing"));
 }
-function W(s) {
+function z(s) {
   return s.getCapabilityTypes();
 }
 function q(s, t) {
@@ -1262,22 +867,22 @@ function q(s, t) {
 }
 export {
   m as AggregateBuilder,
-  n as AggregateError,
+  r as AggregateError,
   v as AggregateRoot,
   b as AuditCapability,
-  E as Entity,
-  w as EventSourcingCapability,
+  w as Entity,
+  E as EventSourcingCapability,
   S as SnapshotCapability,
-  f as VersioningCapability,
-  L as aggregateBuilder,
-  H as asAuditAggregate,
-  j as asEventSourcingAggregate,
+  p as VersioningCapability,
+  H as aggregateBuilder,
+  k as asAuditAggregate,
+  W as asEventSourcingAggregate,
   U as asSnapshotAggregate,
-  O as asVersioningAggregate,
-  W as getAggregateCapabilities,
+  P as asVersioningAggregate,
+  z as getAggregateCapabilities,
   q as hasAllCapabilities,
-  P as tryAsAuditAggregate,
-  z as tryAsEventSourcingAggregate,
-  k as tryAsSnapshotAggregate,
-  B as tryAsVersioningAggregate
+  B as tryAsAuditAggregate,
+  R as tryAsEventSourcingAggregate,
+  O as tryAsSnapshotAggregate,
+  j as tryAsVersioningAggregate
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vytches/ddd-aggregates",
-  "version": "0.26.0",
+  "version": "0.27.0",
   "description": "Aggregate root implementations with capabilities",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -33,17 +33,17 @@
     "directory": "packages/aggregates"
   },
   "dependencies": {
-    "@vytches/ddd-contracts": "0.26.0",
-    "@vytches/ddd-domain-primitives": "0.26.0",
-    "@vytches/ddd-logging": "0.26.0",
-    "@vytches/ddd-value-objects": "0.26.0"
+    "@vytches/ddd-contracts": "0.27.0",
+    "@vytches/ddd-domain-primitives": "0.27.0",
+    "@vytches/ddd-logging": "0.27.0",
+    "@vytches/ddd-value-objects": "0.27.0"
   },
   "devDependencies": {
     "typescript": "^5.0.0",
     "vite": "^7.3.2",
     "vite-plugin-dts": "^4.0.0",
     "vitest": "^2.0.0",
-    "@vytches/ddd-testing": "0.26.0"
+    "@vytches/ddd-testing": "0.27.0"
   },
   "nx": {
     "tags": [