@cullet/erp-core 1.3.0 → 1.4.0

package/dist/{gate-types.d.ts → core-config.d.cts}

@@ -1,5 +1,80 @@
-import { a as Result, n as Outcome } from "./outcome.js";
+import { r as Result } from "./result.cjs";
+import { n as Outcome } from "./outcome.cjs";
 
+//#region src/core/policies/engines/v1/condition-types.d.ts
+type ConditionOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "isNull" | "isNotNull";
+interface ConditionLeafNode {
+  readonly field: string;
+  readonly op: ConditionOp;
+  readonly value: unknown;
+  readonly allowNull?: true;
+}
+interface ConditionAndNode {
+  readonly and: readonly ConditionNode[];
+}
+interface ConditionOrNode {
+  readonly or: readonly ConditionNode[];
+}
+interface ConditionNotNode {
+  readonly not: ConditionNode;
+}
+type ConditionNode = ConditionLeafNode | ConditionAndNode | ConditionOrNode | ConditionNotNode;
+//#endregion
+//#region src/core/policies/engines/v1/gate/gate-types-v1.d.ts
+type GatePayloadV1 = {
+  readonly condition: ConditionNode;
+} | {
+  readonly allowIf: ConditionNode;
+  readonly defaultOutcome: "ALLOW" | "DENY";
+};
+//#endregion
+//#region src/core/policies/engines/gate-payload.d.ts
+type GatePayload = GatePayloadV1;
+//#endregion
+//#region src/core/policies/engines/gate-types.d.ts
+type PolicyContext = Record<string, unknown>;
+interface GateTraceLeafSnapshot {
+  readonly kind: "LEAF";
+  readonly field: string;
+  readonly op: string;
+  readonly allowNull?: true;
+}
+type GateTraceNodeSnapshot = GateTraceLeafSnapshot | {
+  readonly kind: "AND" | "OR";
+  readonly childCount: number;
+} | {
+  readonly kind: "NOT";
+};
+interface GateViolationTrace {
+  readonly conditionPath: string;
+  readonly decisiveNode: GateTraceNodeSnapshot;
+  readonly lastEvaluatedLeaf: GateTraceLeafSnapshot;
+  readonly lastEvaluatedLeafPath: string;
+  readonly lastEvaluatedLeafResult: boolean;
+  readonly field: string;
+  readonly op: string;
+}
+interface PolicyViolation {
+  readonly code: string;
+  readonly message: string;
+  readonly trace?: GateViolationTrace;
+}
+type GateStatus = "ALLOW" | "DENY";
+interface GateOutcomeData {
+  readonly violations: readonly PolicyViolation[];
+}
+/** Semantic outcome of a GATE policy evaluation. */
+type GateOutcome = Outcome<GateStatus, GateOutcomeData>;
+/**
+ * Contract every versioned gate engine must satisfy.
+ * Receives an already-parsed `GatePayload`; parsing from raw `unknown` is
+ * the registry's responsibility via `parseGatePayload`.
+ */
+interface VersionedGateEngine {
+  readonly version: number;
+  evaluate(payload: GatePayload, context: PolicyContext): Result<GateOutcome, string>;
+}
+//#endregion
 //#region src/core/policies/engines/condition-evaluator-reporter.d.ts
 interface ConditionEvaluationCause {
   readonly name: string;
@@ -93,79 +168,5 @@ declare class CoreConfig {
   getConditionEvaluationOptions(engineVersion: number): ConditionEvaluationOptions;
 }
 //#endregion
-//#region src/core/policies/engines/v1/condition-types.d.ts
-type ConditionOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "isNull" | "isNotNull";
-interface ConditionLeafNode {
-  readonly field: string;
-  readonly op: ConditionOp;
-  readonly value: unknown;
-  readonly allowNull?: true;
-}
-interface ConditionAndNode {
-  readonly and: readonly ConditionNode[];
-}
-interface ConditionOrNode {
-  readonly or: readonly ConditionNode[];
-}
-interface ConditionNotNode {
-  readonly not: ConditionNode;
-}
-type ConditionNode = ConditionLeafNode | ConditionAndNode | ConditionOrNode | ConditionNotNode;
-//#endregion
-//#region src/core/policies/engines/v1/gate/gate-types-v1.d.ts
-type GatePayloadV1 = {
-  readonly condition: ConditionNode;
-} | {
-  readonly allowIf: ConditionNode;
-  readonly defaultOutcome: "ALLOW" | "DENY";
-};
-//#endregion
-//#region src/core/policies/engines/gate-payload.d.ts
-type GatePayload = GatePayloadV1;
-//#endregion
-//#region src/core/policies/engines/gate-types.d.ts
-type PolicyContext = Record<string, unknown>;
-interface GateTraceLeafSnapshot {
-  readonly kind: "LEAF";
-  readonly field: string;
-  readonly op: string;
-  readonly allowNull?: true;
-}
-type GateTraceNodeSnapshot = GateTraceLeafSnapshot | {
-  readonly kind: "AND" | "OR";
-  readonly childCount: number;
-} | {
-  readonly kind: "NOT";
-};
-interface GateViolationTrace {
-  readonly conditionPath: string;
-  readonly decisiveNode: GateTraceNodeSnapshot;
-  readonly lastEvaluatedLeaf: GateTraceLeafSnapshot;
-  readonly lastEvaluatedLeafPath: string;
-  readonly lastEvaluatedLeafResult: boolean;
-  readonly field: string;
-  readonly op: string;
-}
-interface PolicyViolation {
-  readonly code: string;
-  readonly message: string;
-  readonly trace?: GateViolationTrace;
-}
-type GateStatus = "ALLOW" | "DENY";
-interface GateOutcomeData {
-  readonly violations: readonly PolicyViolation[];
-}
-/** Semantic outcome of a GATE policy evaluation. */
-type GateOutcome = Outcome<GateStatus, GateOutcomeData>;
-/**
- * Contract every versioned gate engine must satisfy.
- * Receives an already-parsed `GatePayload`; parsing from raw `unknown` is
- * the registry's responsibility via `parseGatePayload`.
- */
-interface VersionedGateEngine {
-  readonly version: number;
-  evaluate(payload: GatePayload, context: PolicyContext): Result<GateOutcome, string>;
-}
-//#endregion
-export { ConditionEvaluationReportTag as A, asPolicyDefinitionId as C, ConditionEvaluationOptions as D, ConditionEvaluationCause as E, ConditionEvaluationReport as O, asPolicyDecisionId as S, asTenantId as T, PolicyReporter as _, GateTraceNodeSnapshot as a, SchoolId as b, PolicyViolation as c, GatePayloadV1 as d, ConditionLeafNode as f, CoreObservabilityConfig as g, CoreConfigOptions as h, GateTraceLeafSnapshot as i, ConditionEvaluatorReporter as j, ConditionEvaluationReportLevel as k, VersionedGateEngine as l, CoreConfig as m, GateOutcomeData as n, GateViolationTrace as o, ConditionNode as p, GateStatus as r, PolicyContext as s, GateOutcome as t, GatePayload as u, PolicyDecisionId as v, asSchoolId as w, TenantId as x, PolicyDefinitionId as y };
-//# sourceMappingURL=gate-types.d.ts.map
+export { ConditionLeafNode as A, GateTraceNodeSnapshot as C, VersionedGateEngine as D, PolicyViolation as E, GatePayload as O, GateTraceLeafSnapshot as S, PolicyContext as T, ConditionEvaluationReportTag as _, PolicyDecisionId as a, GateOutcomeData as b, TenantId as c, asSchoolId as d, asTenantId as f, ConditionEvaluationReportLevel as g, ConditionEvaluationReport as h, PolicyReporter as i, ConditionNode as j, GatePayloadV1 as k, asPolicyDecisionId as l, ConditionEvaluationOptions as m, CoreConfigOptions as n, PolicyDefinitionId as o, ConditionEvaluationCause as p, CoreObservabilityConfig as r, SchoolId as s, CoreConfig as t, asPolicyDefinitionId as u, ConditionEvaluatorReporter as v, GateViolationTrace as w, GateStatus as x, GateOutcome as y };
+//# sourceMappingURL=core-config.d.cts.map

package/dist/{gate-types.d.cts → core-config.d.ts}

@@ -1,5 +1,80 @@
-import { a as Result, n as Outcome } from "./outcome.cjs";
+import { r as Result } from "./result.js";
+import { n as Outcome } from "./outcome.js";
 
+//#region src/core/policies/engines/v1/condition-types.d.ts
+type ConditionOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "isNull" | "isNotNull";
+interface ConditionLeafNode {
+  readonly field: string;
+  readonly op: ConditionOp;
+  readonly value: unknown;
+  readonly allowNull?: true;
+}
+interface ConditionAndNode {
+  readonly and: readonly ConditionNode[];
+}
+interface ConditionOrNode {
+  readonly or: readonly ConditionNode[];
+}
+interface ConditionNotNode {
+  readonly not: ConditionNode;
+}
+type ConditionNode = ConditionLeafNode | ConditionAndNode | ConditionOrNode | ConditionNotNode;
+//#endregion
+//#region src/core/policies/engines/v1/gate/gate-types-v1.d.ts
+type GatePayloadV1 = {
+  readonly condition: ConditionNode;
+} | {
+  readonly allowIf: ConditionNode;
+  readonly defaultOutcome: "ALLOW" | "DENY";
+};
+//#endregion
+//#region src/core/policies/engines/gate-payload.d.ts
+type GatePayload = GatePayloadV1;
+//#endregion
+//#region src/core/policies/engines/gate-types.d.ts
+type PolicyContext = Record<string, unknown>;
+interface GateTraceLeafSnapshot {
+  readonly kind: "LEAF";
+  readonly field: string;
+  readonly op: string;
+  readonly allowNull?: true;
+}
+type GateTraceNodeSnapshot = GateTraceLeafSnapshot | {
+  readonly kind: "AND" | "OR";
+  readonly childCount: number;
+} | {
+  readonly kind: "NOT";
+};
+interface GateViolationTrace {
+  readonly conditionPath: string;
+  readonly decisiveNode: GateTraceNodeSnapshot;
+  readonly lastEvaluatedLeaf: GateTraceLeafSnapshot;
+  readonly lastEvaluatedLeafPath: string;
+  readonly lastEvaluatedLeafResult: boolean;
+  readonly field: string;
+  readonly op: string;
+}
+interface PolicyViolation {
+  readonly code: string;
+  readonly message: string;
+  readonly trace?: GateViolationTrace;
+}
+type GateStatus = "ALLOW" | "DENY";
+interface GateOutcomeData {
+  readonly violations: readonly PolicyViolation[];
+}
+/** Semantic outcome of a GATE policy evaluation. */
+type GateOutcome = Outcome<GateStatus, GateOutcomeData>;
+/**
+ * Contract every versioned gate engine must satisfy.
+ * Receives an already-parsed `GatePayload`; parsing from raw `unknown` is
+ * the registry's responsibility via `parseGatePayload`.
+ */
+interface VersionedGateEngine {
+  readonly version: number;
+  evaluate(payload: GatePayload, context: PolicyContext): Result<GateOutcome, string>;
+}
+//#endregion
 //#region src/core/policies/engines/condition-evaluator-reporter.d.ts
 interface ConditionEvaluationCause {
   readonly name: string;
@@ -93,79 +168,5 @@ declare class CoreConfig {
   getConditionEvaluationOptions(engineVersion: number): ConditionEvaluationOptions;
 }
 //#endregion
-//#region src/core/policies/engines/v1/condition-types.d.ts
-type ConditionOp = "eq" | "neq" | "gt" | "gte" | "lt" | "lte" | "in" | "notIn" | "isNull" | "isNotNull";
-interface ConditionLeafNode {
-  readonly field: string;
-  readonly op: ConditionOp;
-  readonly value: unknown;
-  readonly allowNull?: true;
-}
-interface ConditionAndNode {
-  readonly and: readonly ConditionNode[];
-}
-interface ConditionOrNode {
-  readonly or: readonly ConditionNode[];
-}
-interface ConditionNotNode {
-  readonly not: ConditionNode;
-}
-type ConditionNode = ConditionLeafNode | ConditionAndNode | ConditionOrNode | ConditionNotNode;
-//#endregion
-//#region src/core/policies/engines/v1/gate/gate-types-v1.d.ts
-type GatePayloadV1 = {
-  readonly condition: ConditionNode;
-} | {
-  readonly allowIf: ConditionNode;
-  readonly defaultOutcome: "ALLOW" | "DENY";
-};
-//#endregion
-//#region src/core/policies/engines/gate-payload.d.ts
-type GatePayload = GatePayloadV1;
-//#endregion
-//#region src/core/policies/engines/gate-types.d.ts
-type PolicyContext = Record<string, unknown>;
-interface GateTraceLeafSnapshot {
-  readonly kind: "LEAF";
-  readonly field: string;
-  readonly op: string;
-  readonly allowNull?: true;
-}
-type GateTraceNodeSnapshot = GateTraceLeafSnapshot | {
-  readonly kind: "AND" | "OR";
-  readonly childCount: number;
-} | {
-  readonly kind: "NOT";
-};
-interface GateViolationTrace {
-  readonly conditionPath: string;
-  readonly decisiveNode: GateTraceNodeSnapshot;
-  readonly lastEvaluatedLeaf: GateTraceLeafSnapshot;
-  readonly lastEvaluatedLeafPath: string;
-  readonly lastEvaluatedLeafResult: boolean;
-  readonly field: string;
-  readonly op: string;
-}
-interface PolicyViolation {
-  readonly code: string;
-  readonly message: string;
-  readonly trace?: GateViolationTrace;
-}
-type GateStatus = "ALLOW" | "DENY";
-interface GateOutcomeData {
-  readonly violations: readonly PolicyViolation[];
-}
-/** Semantic outcome of a GATE policy evaluation. */
-type GateOutcome = Outcome<GateStatus, GateOutcomeData>;
-/**
- * Contract every versioned gate engine must satisfy.
- * Receives an already-parsed `GatePayload`; parsing from raw `unknown` is
- * the registry's responsibility via `parseGatePayload`.
- */
-interface VersionedGateEngine {
-  readonly version: number;
-  evaluate(payload: GatePayload, context: PolicyContext): Result<GateOutcome, string>;
-}
-//#endregion
-export { ConditionEvaluationReportTag as A, asPolicyDefinitionId as C, ConditionEvaluationOptions as D, ConditionEvaluationCause as E, ConditionEvaluationReport as O, asPolicyDecisionId as S, asTenantId as T, PolicyReporter as _, GateTraceNodeSnapshot as a, SchoolId as b, PolicyViolation as c, GatePayloadV1 as d, ConditionLeafNode as f, CoreObservabilityConfig as g, CoreConfigOptions as h, GateTraceLeafSnapshot as i, ConditionEvaluatorReporter as j, ConditionEvaluationReportLevel as k, VersionedGateEngine as l, CoreConfig as m, GateOutcomeData as n, GateViolationTrace as o, ConditionNode as p, GateStatus as r, PolicyContext as s, GateOutcome as t, GatePayload as u, PolicyDecisionId as v, asSchoolId as w, TenantId as x, PolicyDefinitionId as y };
-//# sourceMappingURL=gate-types.d.cts.map
+export { ConditionLeafNode as A, GateTraceNodeSnapshot as C, VersionedGateEngine as D, PolicyViolation as E, GatePayload as O, GateTraceLeafSnapshot as S, PolicyContext as T, ConditionEvaluationReportTag as _, PolicyDecisionId as a, GateOutcomeData as b, TenantId as c, asSchoolId as d, asTenantId as f, ConditionEvaluationReportLevel as g, ConditionEvaluationReport as h, PolicyReporter as i, ConditionNode as j, GatePayloadV1 as k, asPolicyDecisionId as l, ConditionEvaluationOptions as m, CoreConfigOptions as n, PolicyDefinitionId as o, ConditionEvaluationCause as p, CoreObservabilityConfig as r, SchoolId as s, CoreConfig as t, asPolicyDefinitionId as u, ConditionEvaluatorReporter as v, GateViolationTrace as w, GateStatus as x, GateOutcome as y };
+//# sourceMappingURL=core-config.d.ts.map

package/dist/domain/index.cjs

@@ -1,10 +1,11 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_entity = require("../entity.cjs");
 const require_value_object = require("../value-object.cjs");
 const require_uuid_identifier = require("../uuid-identifier.cjs");
 Object.defineProperty(exports, "Entity", {
 	enumerable: true,
 	get: function() {
-		return require_value_object.Entity;
+		return require_entity.Entity;
 	}
 });
 exports.UuidIdentifier = require_uuid_identifier.UuidIdentifier;

package/dist/domain/index.d.cts

@@ -1,3 +1,4 @@
 import { t as DeepReadonly } from "../immutable.cjs";
-import { a as EntityState, i as Entity, n as ValueObject, r as ValueObjectPluginContract, t as UuidIdentifier } from "../uuid-identifier.cjs";
+import { n as ValueObjectPluginContract, t as ValueObject } from "../value-object.cjs";
+import { n as Entity, r as EntityState, t as UuidIdentifier } from "../uuid-identifier.cjs";
 export { type DeepReadonly, Entity, type EntityState, UuidIdentifier, ValueObject, type ValueObjectPluginContract };

package/dist/domain/index.d.ts

@@ -1,3 +1,4 @@
 import { t as DeepReadonly } from "../immutable.js";
-import { a as EntityState, i as Entity, n as ValueObject, r as ValueObjectPluginContract, t as UuidIdentifier } from "../uuid-identifier.js";
+import { n as ValueObjectPluginContract, t as ValueObject } from "../value-object.js";
+import { n as Entity, r as EntityState, t as UuidIdentifier } from "../uuid-identifier.js";
 export { type DeepReadonly, Entity, type EntityState, UuidIdentifier, ValueObject, type ValueObjectPluginContract };

package/dist/domain/index.js

@@ -1,3 +1,4 @@
-import { n as Entity, t as ValueObject } from "../value-object.js";
+import { t as Entity } from "../entity.js";
+import { t as ValueObject } from "../value-object.js";
 import { t as UuidIdentifier } from "../uuid-identifier.js";
 export { Entity, UuidIdentifier, ValueObject };

package/dist/domain-event-contracts.cjs

@@ -1,15 +1,16 @@
 const require_use_case = require("./use-case.cjs");
+const require_entity = require("./entity.cjs");
 const require_value_object = require("./value-object.cjs");
 //#region src/core/versioning/domain-event-contracts.ts
 function buildDomainEventContractVersions(selection) {
 	const contractVersions = {};
-	if (selection.entity) contractVersions.entity_contract = require_value_object.Entity.CONTRACT_VERSION;
+	if (selection.entity) contractVersions.entity_contract = require_entity.Entity.CONTRACT_VERSION;
 	if (selection.valueObject) contractVersions.value_object_contract = require_value_object.ValueObject.CONTRACT_VERSION;
 	if (selection.useCase) contractVersions.use_case_contract = require_use_case.UseCase.CONTRACT_VERSION;
 	return Object.freeze(contractVersions);
 }
 function createDomainEventEnvelope(input) {
-	require_value_object.assertValidAggregateVersion(input.aggregateVersion);
+	require_entity.assertValidAggregateVersion(input.aggregateVersion);
 	return Object.freeze({
 		aggregate_version: input.aggregateVersion,
 		payload: input.payload,

package/dist/domain-event-contracts.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event-contracts.cjs","names":["Entity","ValueObject","UseCase"],"sources":["../src/core/versioning/domain-event-contracts.ts"],"sourcesContent":["import { UseCase } from \"../application/use-case.js\";\nimport { Entity } from \"../domain/entity.js\";\nimport { ValueObject } from \"../domain/value-object.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { type ContractVersion } from \"./version.js\";\n\ninterface DomainEventContractSelection {\n    readonly entity?: boolean;\n    readonly valueObject?: boolean;\n    readonly useCase?: boolean;\n}\n\ninterface DomainEventContractVersions {\n    readonly entity_contract?: ContractVersion;\n    readonly value_object_contract?: ContractVersion;\n    readonly use_case_contract?: ContractVersion;\n}\n\ninterface CreateDomainEventEnvelopeInput<TPayload> {\n    readonly aggregateVersion: number;\n    readonly payload: TPayload;\n    readonly contracts: DomainEventContractSelection;\n}\n\ninterface DomainEventEnvelope<TPayload> extends DomainEventContractVersions {\n    readonly aggregate_version: number;\n    readonly payload: TPayload;\n}\n\nfunction buildDomainEventContractVersions(\n    selection: DomainEventContractSelection,\n): DomainEventContractVersions {\n    const contractVersions: {\n        entity_contract?: ContractVersion;\n        value_object_contract?: ContractVersion;\n        use_case_contract?: ContractVersion;\n    } = {};\n\n    if (selection.entity) {\n        contractVersions.entity_contract = Entity.CONTRACT_VERSION;\n    }\n\n    if (selection.valueObject) {\n        contractVersions.value_object_contract = ValueObject.CONTRACT_VERSION;\n    }\n\n    if (selection.useCase) {\n        contractVersions.use_case_contract = UseCase.CONTRACT_VERSION;\n    }\n\n    return Object.freeze(contractVersions);\n}\n\nfunction createDomainEventEnvelope<TPayload>(\n    input: CreateDomainEventEnvelopeInput<TPayload>,\n): DomainEventEnvelope<TPayload> {\n    assertValidAggregateVersion(input.aggregateVersion);\n\n    return Object.freeze({\n        aggregate_version: input.aggregateVersion,\n        payload: input.payload,\n        ...buildDomainEventContractVersions(input.contracts),\n    });\n}\n\nexport {\n    buildDomainEventContractVersions,\n    createDomainEventEnvelope,\n    type CreateDomainEventEnvelopeInput,\n    type DomainEventContractSelection,\n    type DomainEventContractVersions,\n    type DomainEventEnvelope,\n};\n"],"mappings":";;;AA6BA,SAAS,iCACL,WAC2B;CAC3B,MAAM,mBAIF,CAAC;CAEL,IAAI,UAAU,QACV,iBAAiB,kBAAkBA,qBAAAA,OAAO;CAG9C,IAAI,UAAU,aACV,iBAAiB,wBAAwBC,qBAAAA,YAAY;CAGzD,IAAI,UAAU,SACV,iBAAiB,oBAAoBC,iBAAAA,QAAQ;CAGjD,OAAO,OAAO,OAAO,gBAAgB;AACzC;AAEA,SAAS,0BACL,OAC6B;CAC7B,qBAAA,4BAA4B,MAAM,gBAAgB;CAElD,OAAO,OAAO,OAAO;EACjB,mBAAmB,MAAM;EACzB,SAAS,MAAM;EACf,GAAG,iCAAiC,MAAM,SAAS;CACvD,CAAC;AACL"}
+{"version":3,"file":"domain-event-contracts.cjs","names":["Entity","ValueObject","UseCase"],"sources":["../src/core/versioning/domain-event-contracts.ts"],"sourcesContent":["import { UseCase } from \"../application/use-case.js\";\nimport { Entity } from \"../domain/entity.js\";\nimport { ValueObject } from \"../domain/value-object.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { type ContractVersion } from \"./version.js\";\n\ninterface DomainEventContractSelection {\n    readonly entity?: boolean;\n    readonly valueObject?: boolean;\n    readonly useCase?: boolean;\n}\n\ninterface DomainEventContractVersions {\n    readonly entity_contract?: ContractVersion;\n    readonly value_object_contract?: ContractVersion;\n    readonly use_case_contract?: ContractVersion;\n}\n\ninterface CreateDomainEventEnvelopeInput<TPayload> {\n    readonly aggregateVersion: number;\n    readonly payload: TPayload;\n    readonly contracts: DomainEventContractSelection;\n}\n\ninterface DomainEventEnvelope<TPayload> extends DomainEventContractVersions {\n    readonly aggregate_version: number;\n    readonly payload: TPayload;\n}\n\nfunction buildDomainEventContractVersions(\n    selection: DomainEventContractSelection,\n): DomainEventContractVersions {\n    const contractVersions: {\n        entity_contract?: ContractVersion;\n        value_object_contract?: ContractVersion;\n        use_case_contract?: ContractVersion;\n    } = {};\n\n    if (selection.entity) {\n        contractVersions.entity_contract = Entity.CONTRACT_VERSION;\n    }\n\n    if (selection.valueObject) {\n        contractVersions.value_object_contract = ValueObject.CONTRACT_VERSION;\n    }\n\n    if (selection.useCase) {\n        contractVersions.use_case_contract = UseCase.CONTRACT_VERSION;\n    }\n\n    return Object.freeze(contractVersions);\n}\n\nfunction createDomainEventEnvelope<TPayload>(\n    input: CreateDomainEventEnvelopeInput<TPayload>,\n): DomainEventEnvelope<TPayload> {\n    assertValidAggregateVersion(input.aggregateVersion);\n\n    return Object.freeze({\n        aggregate_version: input.aggregateVersion,\n        payload: input.payload,\n        ...buildDomainEventContractVersions(input.contracts),\n    });\n}\n\nexport {\n    buildDomainEventContractVersions,\n    createDomainEventEnvelope,\n    type CreateDomainEventEnvelopeInput,\n    type DomainEventContractSelection,\n    type DomainEventContractVersions,\n    type DomainEventEnvelope,\n};\n"],"mappings":";;;;AA6BA,SAAS,iCACL,WAC2B;CAC3B,MAAM,mBAIF,CAAC;CAEL,IAAI,UAAU,QACV,iBAAiB,kBAAkBA,eAAAA,OAAO;CAG9C,IAAI,UAAU,aACV,iBAAiB,wBAAwBC,qBAAAA,YAAY;CAGzD,IAAI,UAAU,SACV,iBAAiB,oBAAoBC,iBAAAA,QAAQ;CAGjD,OAAO,OAAO,OAAO,gBAAgB;AACzC;AAEA,SAAS,0BACL,OAC6B;CAC7B,eAAA,4BAA4B,MAAM,gBAAgB;CAElD,OAAO,OAAO,OAAO;EACjB,mBAAmB,MAAM;EACzB,SAAS,MAAM;EACf,GAAG,iCAAiC,MAAM,SAAS;CACvD,CAAC;AACL"}

package/dist/domain-event-contracts.js

@@ -1,5 +1,6 @@
 import { t as UseCase } from "./use-case.js";
-import { n as Entity, r as assertValidAggregateVersion, t as ValueObject } from "./value-object.js";
+import { n as assertValidAggregateVersion, t as Entity } from "./entity.js";
+import { t as ValueObject } from "./value-object.js";
 //#region src/core/versioning/domain-event-contracts.ts
 function buildDomainEventContractVersions(selection) {
 	const contractVersions = {};

package/dist/domain-event-contracts.js.map

@@ -1 +1 @@
-{"version":3,"file":"domain-event-contracts.js","names":[],"sources":["../src/core/versioning/domain-event-contracts.ts"],"sourcesContent":["import { UseCase } from \"../application/use-case.js\";\nimport { Entity } from \"../domain/entity.js\";\nimport { ValueObject } from \"../domain/value-object.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { type ContractVersion } from \"./version.js\";\n\ninterface DomainEventContractSelection {\n    readonly entity?: boolean;\n    readonly valueObject?: boolean;\n    readonly useCase?: boolean;\n}\n\ninterface DomainEventContractVersions {\n    readonly entity_contract?: ContractVersion;\n    readonly value_object_contract?: ContractVersion;\n    readonly use_case_contract?: ContractVersion;\n}\n\ninterface CreateDomainEventEnvelopeInput<TPayload> {\n    readonly aggregateVersion: number;\n    readonly payload: TPayload;\n    readonly contracts: DomainEventContractSelection;\n}\n\ninterface DomainEventEnvelope<TPayload> extends DomainEventContractVersions {\n    readonly aggregate_version: number;\n    readonly payload: TPayload;\n}\n\nfunction buildDomainEventContractVersions(\n    selection: DomainEventContractSelection,\n): DomainEventContractVersions {\n    const contractVersions: {\n        entity_contract?: ContractVersion;\n        value_object_contract?: ContractVersion;\n        use_case_contract?: ContractVersion;\n    } = {};\n\n    if (selection.entity) {\n        contractVersions.entity_contract = Entity.CONTRACT_VERSION;\n    }\n\n    if (selection.valueObject) {\n        contractVersions.value_object_contract = ValueObject.CONTRACT_VERSION;\n    }\n\n    if (selection.useCase) {\n        contractVersions.use_case_contract = UseCase.CONTRACT_VERSION;\n    }\n\n    return Object.freeze(contractVersions);\n}\n\nfunction createDomainEventEnvelope<TPayload>(\n    input: CreateDomainEventEnvelopeInput<TPayload>,\n): DomainEventEnvelope<TPayload> {\n    assertValidAggregateVersion(input.aggregateVersion);\n\n    return Object.freeze({\n        aggregate_version: input.aggregateVersion,\n        payload: input.payload,\n        ...buildDomainEventContractVersions(input.contracts),\n    });\n}\n\nexport {\n    buildDomainEventContractVersions,\n    createDomainEventEnvelope,\n    type CreateDomainEventEnvelopeInput,\n    type DomainEventContractSelection,\n    type DomainEventContractVersions,\n    type DomainEventEnvelope,\n};\n"],"mappings":";;;AA6BA,SAAS,iCACL,WAC2B;CAC3B,MAAM,mBAIF,CAAC;CAEL,IAAI,UAAU,QACV,iBAAiB,kBAAkB,OAAO;CAG9C,IAAI,UAAU,aACV,iBAAiB,wBAAwB,YAAY;CAGzD,IAAI,UAAU,SACV,iBAAiB,oBAAoB,QAAQ;CAGjD,OAAO,OAAO,OAAO,gBAAgB;AACzC;AAEA,SAAS,0BACL,OAC6B;CAC7B,4BAA4B,MAAM,gBAAgB;CAElD,OAAO,OAAO,OAAO;EACjB,mBAAmB,MAAM;EACzB,SAAS,MAAM;EACf,GAAG,iCAAiC,MAAM,SAAS;CACvD,CAAC;AACL"}
+{"version":3,"file":"domain-event-contracts.js","names":[],"sources":["../src/core/versioning/domain-event-contracts.ts"],"sourcesContent":["import { UseCase } from \"../application/use-case.js\";\nimport { Entity } from \"../domain/entity.js\";\nimport { ValueObject } from \"../domain/value-object.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { type ContractVersion } from \"./version.js\";\n\ninterface DomainEventContractSelection {\n    readonly entity?: boolean;\n    readonly valueObject?: boolean;\n    readonly useCase?: boolean;\n}\n\ninterface DomainEventContractVersions {\n    readonly entity_contract?: ContractVersion;\n    readonly value_object_contract?: ContractVersion;\n    readonly use_case_contract?: ContractVersion;\n}\n\ninterface CreateDomainEventEnvelopeInput<TPayload> {\n    readonly aggregateVersion: number;\n    readonly payload: TPayload;\n    readonly contracts: DomainEventContractSelection;\n}\n\ninterface DomainEventEnvelope<TPayload> extends DomainEventContractVersions {\n    readonly aggregate_version: number;\n    readonly payload: TPayload;\n}\n\nfunction buildDomainEventContractVersions(\n    selection: DomainEventContractSelection,\n): DomainEventContractVersions {\n    const contractVersions: {\n        entity_contract?: ContractVersion;\n        value_object_contract?: ContractVersion;\n        use_case_contract?: ContractVersion;\n    } = {};\n\n    if (selection.entity) {\n        contractVersions.entity_contract = Entity.CONTRACT_VERSION;\n    }\n\n    if (selection.valueObject) {\n        contractVersions.value_object_contract = ValueObject.CONTRACT_VERSION;\n    }\n\n    if (selection.useCase) {\n        contractVersions.use_case_contract = UseCase.CONTRACT_VERSION;\n    }\n\n    return Object.freeze(contractVersions);\n}\n\nfunction createDomainEventEnvelope<TPayload>(\n    input: CreateDomainEventEnvelopeInput<TPayload>,\n): DomainEventEnvelope<TPayload> {\n    assertValidAggregateVersion(input.aggregateVersion);\n\n    return Object.freeze({\n        aggregate_version: input.aggregateVersion,\n        payload: input.payload,\n        ...buildDomainEventContractVersions(input.contracts),\n    });\n}\n\nexport {\n    buildDomainEventContractVersions,\n    createDomainEventEnvelope,\n    type CreateDomainEventEnvelopeInput,\n    type DomainEventContractSelection,\n    type DomainEventContractVersions,\n    type DomainEventEnvelope,\n};\n"],"mappings":";;;;AA6BA,SAAS,iCACL,WAC2B;CAC3B,MAAM,mBAIF,CAAC;CAEL,IAAI,UAAU,QACV,iBAAiB,kBAAkB,OAAO;CAG9C,IAAI,UAAU,aACV,iBAAiB,wBAAwB,YAAY;CAGzD,IAAI,UAAU,SACV,iBAAiB,oBAAoB,QAAQ;CAGjD,OAAO,OAAO,OAAO,gBAAgB;AACzC;AAEA,SAAS,0BACL,OAC6B;CAC7B,4BAA4B,MAAM,gBAAgB;CAElD,OAAO,OAAO,OAAO;EACjB,mBAAmB,MAAM;EACzB,SAAS,MAAM;EACf,GAAG,iCAAiC,MAAM,SAAS;CACvD,CAAC;AACL"}

package/dist/entity.cjs

@@ -0,0 +1,126 @@
+const require_invariant_violation_exception = require("./invariant-violation-exception.cjs");
+const require_immutable = require("./immutable.cjs");
+const require_temporal_guards = require("./temporal-guards.cjs");
+//#region src/core/shared/aggregate-version.ts
+function assertValidAggregateVersion(aggregateVersion) {
+	if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) throw new require_invariant_violation_exception.InvariantViolationException(`aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`);
+}
+//#endregion
+//#region src/core/domain/entity.ts
+var _Entity;
+/**
+* Base class for domain entities — objects defined by a stable identity rather
+* than by their attributes. Two entities are "the same" when their `id`
+* matches, even if every other field differs; this is the opposite of a
+* {@link ValueObject}, which is defined entirely by its contents.
+*
+* The class owns the bookkeeping common to every aggregate root: a creation
+* timestamp that never changes, a last-modified timestamp, and an
+* `aggregateVersion` counter used for optimistic concurrency control. All three
+* are validated on construction and the dates are defensively cloned, so an
+* entity can never be built into — or leak — an inconsistent temporal state.
+*
+* @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).
+*/
+let Entity = class Entity {
+	static {
+		_Entity = this;
+	}
+	/**
+	* Reconstitutes an entity from its persisted {@link EntityState}.
+	*
+	* Validates the temporal invariants up front so an invalid entity is
+	* impossible to construct: both dates must be valid, the aggregate version
+	* must be a non-negative integer, and `updatedAt` may not predate
+	* `createdAt`. Both dates are cloned on the way in so a later mutation of
+	* the caller's `Date` objects cannot reach into the entity's internal state.
+	*
+	* Declared `protected` because entities are reconstituted through a
+	* subclass factory, never instantiated directly by application code.
+	*
+	* @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.
+	*/
+	constructor(state) {
+		require_temporal_guards.assertValidDate("createdAt", state.createdAt);
+		require_temporal_guards.assertValidDate("updatedAt", state.updatedAt);
+		assertValidAggregateVersion(state.aggregateVersion);
+		if (state.updatedAt.getTime() < state.createdAt.getTime()) throw new require_invariant_violation_exception.InvariantViolationException("updatedAt cannot be earlier than createdAt");
+		this._id = state.id;
+		this._createdAt = require_temporal_guards.cloneDate(state.createdAt);
+		this._updatedAt = require_temporal_guards.cloneDate(state.updatedAt);
+		this._aggregateVersion = state.aggregateVersion;
+	}
+	/** The entity's stable identity — the basis for equality between entities. */
+	get id() {
+		return this._id;
+	}
+	/**
+	* When the entity was first created.
+	*
+	* Returns a clone so callers cannot mutate the entity's internal `Date`;
+	* the value is fixed at construction and never changes thereafter.
+	*/
+	get createdAt() {
+		return require_temporal_guards.cloneDate(this._createdAt);
+	}
+	/**
+	* When the entity was last modified.
+	*
+	* Returns a clone for the same encapsulation reason as {@link createdAt};
+	* the underlying value advances only through {@link markAsModified}.
+	*/
+	get updatedAt() {
+		return require_temporal_guards.cloneDate(this._updatedAt);
+	}
+	/**
+	* Monotonic counter incremented on every mutation, used for optimistic
+	* concurrency control: a writer reads this value, and the persistence layer
+	* rejects the write if the stored version has moved on in the meantime.
+	*/
+	get aggregateVersion() {
+		return this._aggregateVersion;
+	}
+	/**
+	* The schema/contract version stamped on this entity type by the
+	* `@version` decorator — used to detect and migrate state persisted under
+	* an older shape.
+	*/
+	get contractVersion() {
+		return _Entity.CONTRACT_VERSION;
+	}
+	/**
+	* The single seam through which an entity records a mutation: it advances
+	* `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must
+	* call this from every state-changing method so the version counter stays
+	* an accurate optimistic-lock token.
+	*
+	* @param updatedAt - The modification instant; defaults to now. Validated
+	*   and required not to predate `createdAt`, preserving the same invariant
+	*   the constructor enforces.
+	* @returns The new aggregate version after the increment.
+	* @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.
+	*/
+	markAsModified(updatedAt = /* @__PURE__ */ new Date()) {
+		require_temporal_guards.assertValidDate("updatedAt", updatedAt);
+		if (updatedAt.getTime() < this._createdAt.getTime()) throw new require_invariant_violation_exception.InvariantViolationException("updatedAt cannot be earlier than createdAt");
+		this._updatedAt = require_temporal_guards.cloneDate(updatedAt);
+		this._aggregateVersion += 1;
+		return this._aggregateVersion;
+	}
+};
+Entity = _Entity = require_immutable.__decorate([require_immutable.version("1.0")], Entity);
+//#endregion
+Object.defineProperty(exports, "Entity", {
+	enumerable: true,
+	get: function() {
+		return Entity;
+	}
+});
+Object.defineProperty(exports, "assertValidAggregateVersion", {
+	enumerable: true,
+	get: function() {
+		return assertValidAggregateVersion;
+	}
+});
+
+//# sourceMappingURL=entity.cjs.map

package/dist/entity.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.cjs","names":["InvariantViolationException","InvariantViolationException","cloneDate","version"],"sources":["../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts"],"sourcesContent":["import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\nfunction assertValidAggregateVersion(aggregateVersion: number): void {\n    if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) {\n        throw new InvariantViolationException(\n            `aggregateVersion must be a non-negative integer. Received: ${aggregateVersion}`,\n        );\n    }\n}\n\nexport { assertValidAggregateVersion };\n","import { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\nimport { assertValidAggregateVersion } from \"../shared/aggregate-version.js\";\nimport { assertValidDate, cloneDate } from \"../shared/temporal-guards.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * The minimal persisted shape needed to reconstitute an {@link Entity}.\n *\n * This is the contract between storage and the domain: a repository maps a row\n * (or document) onto these four fields and hands them to a subclass constructor.\n * `aggregateVersion` travels with the state so optimistic-concurrency checks\n * survive a round-trip through the database.\n */\ninterface EntityState<TIdentifier> {\n    readonly id: TIdentifier;\n    readonly createdAt: Date;\n    readonly updatedAt: Date;\n    readonly aggregateVersion: number;\n}\n\n/**\n * Base class for domain entities — objects defined by a stable identity rather\n * than by their attributes. Two entities are \"the same\" when their `id`\n * matches, even if every other field differs; this is the opposite of a\n * {@link ValueObject}, which is defined entirely by its contents.\n *\n * The class owns the bookkeeping common to every aggregate root: a creation\n * timestamp that never changes, a last-modified timestamp, and an\n * `aggregateVersion` counter used for optimistic concurrency control. All three\n * are validated on construction and the dates are defensively cloned, so an\n * entity can never be built into — or leak — an inconsistent temporal state.\n *\n * @typeParam TIdentifier - The identity type (e.g. a branded string id or a VO).\n */\n@version(\"1.0\")\nabstract class Entity<TIdentifier> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    private readonly _id: TIdentifier;\n    private readonly _createdAt: Date;\n    private _updatedAt: Date;\n    private _aggregateVersion: number;\n\n    /**\n     * Reconstitutes an entity from its persisted {@link EntityState}.\n     *\n     * Validates the temporal invariants up front so an invalid entity is\n     * impossible to construct: both dates must be valid, the aggregate version\n     * must be a non-negative integer, and `updatedAt` may not predate\n     * `createdAt`. Both dates are cloned on the way in so a later mutation of\n     * the caller's `Date` objects cannot reach into the entity's internal state.\n     *\n     * Declared `protected` because entities are reconstituted through a\n     * subclass factory, never instantiated directly by application code.\n     *\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected constructor(state: EntityState<TIdentifier>) {\n        assertValidDate(\"createdAt\", state.createdAt);\n        assertValidDate(\"updatedAt\", state.updatedAt);\n        assertValidAggregateVersion(state.aggregateVersion);\n\n        if (state.updatedAt.getTime() < state.createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._id = state.id;\n        this._createdAt = cloneDate(state.createdAt);\n        this._updatedAt = cloneDate(state.updatedAt);\n        this._aggregateVersion = state.aggregateVersion;\n    }\n\n    /** The entity's stable identity — the basis for equality between entities. */\n    public get id(): TIdentifier {\n        return this._id;\n    }\n\n    /**\n     * When the entity was first created.\n     *\n     * Returns a clone so callers cannot mutate the entity's internal `Date`;\n     * the value is fixed at construction and never changes thereafter.\n     */\n    public get createdAt(): Date {\n        return cloneDate(this._createdAt);\n    }\n\n    /**\n     * When the entity was last modified.\n     *\n     * Returns a clone for the same encapsulation reason as {@link createdAt};\n     * the underlying value advances only through {@link markAsModified}.\n     */\n    public get updatedAt(): Date {\n        return cloneDate(this._updatedAt);\n    }\n\n    /**\n     * Monotonic counter incremented on every mutation, used for optimistic\n     * concurrency control: a writer reads this value, and the persistence layer\n     * rejects the write if the stored version has moved on in the meantime.\n     */\n    public get aggregateVersion(): number {\n        return this._aggregateVersion;\n    }\n\n    /**\n     * The schema/contract version stamped on this entity type by the\n     * `@version` decorator — used to detect and migrate state persisted under\n     * an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return Entity.CONTRACT_VERSION;\n    }\n\n    /**\n     * The single seam through which an entity records a mutation: it advances\n     * `updatedAt` and bumps {@link aggregateVersion} by one. Subclasses must\n     * call this from every state-changing method so the version counter stays\n     * an accurate optimistic-lock token.\n     *\n     * @param updatedAt - The modification instant; defaults to now. Validated\n     *   and required not to predate `createdAt`, preserving the same invariant\n     *   the constructor enforces.\n     * @returns The new aggregate version after the increment.\n     * @throws {InvariantViolationException} When `updatedAt` is earlier than `createdAt`.\n     */\n    protected markAsModified(updatedAt: Date = new Date()): number {\n        assertValidDate(\"updatedAt\", updatedAt);\n\n        if (updatedAt.getTime() < this._createdAt.getTime()) {\n            throw new InvariantViolationException(\n                \"updatedAt cannot be earlier than createdAt\",\n            );\n        }\n\n        this._updatedAt = cloneDate(updatedAt);\n        this._aggregateVersion += 1;\n\n        return this._aggregateVersion;\n    }\n}\n\nexport { Entity, type EntityState };\n"],"mappings":";;;;AAEA,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAIA,sCAAAA,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,wBAAA,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAIC,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAaC,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAaA,wBAAAA,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAOA,wBAAAA,UAAU,KAAK,UAAU;CACpC;;;;;;CAOA,IAAW,mBAA2B;EAClC,OAAO,KAAK;CAChB;;;;;;CAOA,IAAW,kBAAmC;EAC1C,OAAA,QAAc;CAClB;;;;;;;;;;;;;CAcA,eAAyB,4BAAkB,IAAI,KAAK,GAAW;EAC3D,wBAAA,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAID,sCAAAA,4BACN,4CACJ;EAGJ,KAAK,aAAaC,wBAAAA,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;iDA7GCC,kBAAAA,QAAQ,KAAK,CAAA,GAAA,MAAA"}