@cullet/erp-core 1.1.0 → 1.3.0

package/dist/index.js

@@ -1,194 +1,37 @@
-import { a as ErrorCodes, i as assertJsonSafeMetadata, n as UnexpectedError, o as serializationErrorCode, r as AppError } from "./validation-code.js";
+import { a as serializationErrorCode, i as ErrorCodes, n as AppError, r as assertJsonSafeMetadata, t as UnexpectedError } from "./unexpected-error.js";
 import { C as translateUniqueViolationToDuplicate, S as UniqueConstraintViolationError, T as AuthenticationError, _ as IdempotencyPayloadMismatchError, a as evaluateTemporalWindow, b as ConflictError, c as SerializationInError, d as safePreview, f as LegacyIncompatibleError, g as IdempotencyKeyMissingError, h as IdempotencyInProgressError, i as TemporalError, l as SerializationMessages, m as IdempotencyError, n as ExpiredError, o as SerializationCodes, p as IntegrationError, r as NotYetValidError, s as SerializationError, t as ValidationError, u as SerializationOutError, v as IdempotencyReplayNotSupportedError, w as AuthorizationError, x as DuplicateError, y as AlreadyExistsError } from "./validation-error.js";
 import { n as BusinessRuleViolationError, t as NotFoundError } from "./not-found-error.js";
 import { n as sha256Hex, r as stableStringify, t as payloadHash } from "./hashing.js";
+import { t as ValidationCode } from "./validation-code.js";
 import { t as ValidationField } from "./validation-field.js";
-import { a as Query, c as RequestedBy, d as version$1, i as makeImmutable, l as UseCase, n as assertTemporalContext, o as mapPolicyEvaluationError, r as createTemporalContext, s as Command, t as TemporalUseCase, u as __decorate } from "./temporal-use-case.js";
-import { i as InvariantViolationException, n as cloneDate, t as assertValidDate } from "./temporal-guards.js";
-import { c as Ok, d as CoreConfig, l as Result, o as PolicyContextPath, s as Err, u as coreConfig } from "./gate-v1-payload.schema.js";
+import { t as DomainException } from "./domain-exception.js";
+import { n as EntityNotFoundException, r as BusinessRuleViolationException, t as InvalidStateTransitionException } from "./invalid-state-transition-exception.js";
+import { t as InvariantViolationException } from "./invariant-violation-exception.js";
+import { n as MultipleValidationException, r as ValidationException, t as InvalidValueException } from "./validation-exception.js";
+import { i as version, r as CONTRACT_VERSION_PROPERTY } from "./immutable.js";
+import { t as UseCase } from "./use-case.js";
+import { a as mapPolicyEvaluationError, i as Query, n as assertTemporalContext, o as Command, r as createTemporalContext, s as RequestedBy, t as TemporalUseCase } from "./temporal-use-case.js";
+import { n as Entity, t as ValueObject } from "./value-object.js";
+import { t as PluginManager } from "./plugin.js";
+import { t as UuidIdentifier } from "./uuid-identifier.js";
+import { t as RulesetRegistry } from "./ruleset-registry.js";
+import { n as createDomainEventEnvelope, t as buildDomainEventContractVersions } from "./domain-event-contracts.js";
+import { c as CoreConfig, o as PolicyContextPath, s as coreConfig } from "./gate-v1-payload.schema.js";
+import { n as Ok, r as Result, t as Err } from "./result.js";
 import { t as Outcome } from "./outcome.js";
 import { _ as asPolicyDecisionId, a as ContextSeedValidator, b as asTenantId, c as ContextResolverRegistry, d as PolicyDefinition, f as InMemoryPolicyDefinitionRepository, g as PolicyCatalog, h as PolicyCatalogFactory, i as PolicyAsOfResolver, l as registerNamespacedContextResolversIn, m as PolicyKey, n as PolicyEvaluationErrors, o as contextResolverRegistry, p as PolicyScopeMatcher, r as PolicyResolver, s as registerNamespacedContextResolvers, t as PolicyService, u as PolicyContextBuilder, v as asPolicyDefinitionId, x as PolicyHashing, y as asSchoolId } from "./policy-service.js";
 import { a as ComputeEvaluatorRegistry, c as ComputePayloadParsers, i as ComputeRegistry, o as ComputeEngineRegistry, r as GatePayloadParsers, s as ComputePayloadParserRegistry, t as GateEngineRegistry } from "./gate-engine-registry.js";
 //#region src/version.ts
-const version = "1.1.0";
-//#endregion
-//#region src/core/shared/aggregate-version.ts
-function assertValidAggregateVersion(aggregateVersion) {
-	if (!Number.isInteger(aggregateVersion) || aggregateVersion < 0) throw new 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) {
-		assertValidDate("createdAt", state.createdAt);
-		assertValidDate("updatedAt", state.updatedAt);
-		assertValidAggregateVersion(state.aggregateVersion);
-		if (state.updatedAt.getTime() < state.createdAt.getTime()) throw new InvariantViolationException("updatedAt cannot be earlier than createdAt");
-		this._id = state.id;
-		this._createdAt = cloneDate(state.createdAt);
-		this._updatedAt = 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 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 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()) {
-		assertValidDate("updatedAt", updatedAt);
-		if (updatedAt.getTime() < this._createdAt.getTime()) throw new InvariantViolationException("updatedAt cannot be earlier than createdAt");
-		this._updatedAt = cloneDate(updatedAt);
-		this._aggregateVersion += 1;
-		return this._aggregateVersion;
-	}
-};
-Entity = _Entity = __decorate([version$1("1.0")], Entity);
-//#endregion
-//#region src/core/domain/value-object.ts
-var _ValueObject;
-/**
-* Base class for value objects — domain concepts defined entirely by their
-* contents, with no identity of their own. Two value objects are
-* interchangeable when they hold equal data, which is the opposite of an
-* {@link Entity} (compared by id). Money, a CPF, a date range: replacing one
-* instance with an equal one changes nothing about the model.
-*
-* Immutability is the defining guarantee here. The wrapped `value` is
-* deep-frozen on construction, so a value object can be shared freely without
-* any risk of a consumer mutating shared state. Subclasses seal the instance
-* itself with {@link finalize} once their own fields are set.
-*
-* @typeParam T - The shape of the wrapped data.
-* @typeParam P - The primitive form produced by {@link toPrimitive} / {@link toJSON}.
-*/
-let ValueObject = class ValueObject {
-	static {
-		_ValueObject = this;
-	}
-	/**
-	* Wraps `value`, deep-freezing it so the value object is immutable from the
-	* moment it exists. Declared `protected` because value objects are built
-	* through a validating subclass factory, never instantiated directly.
-	*/
-	constructor(value) {
-		this.value = makeImmutable(value);
-	}
-	/**
-	* The schema/contract version stamped on this value-object type by the
-	* `@version` decorator — used to detect state persisted under an older shape.
-	*/
-	get contractVersion() {
-		return _ValueObject.CONTRACT_VERSION;
-	}
-	/**
-	* Freezes the instance shell, blocking reassignment of any own field.
-	*
-	* `value` is already deep-frozen by the constructor, so the wrapped data is
-	* immutable regardless. The instance itself is NOT frozen automatically
-	* because a subclass may still need to assign its own fields after
-	* `super(value)` runs. Call `finalize()` at the very end of the subclass
-	* constructor (after all fields are set) to make the whole value object
-	* immutable.
-	*/
-	finalize() {
-		Object.freeze(this);
-	}
-	/**
-	* Hook for `JSON.stringify`. Delegates to {@link toPrimitive} so a value
-	* object serializes to its primitive form rather than exposing the internal
-	* `value` wrapper.
-	*/
-	toJSON() {
-		return this.toPrimitive();
-	}
-};
-ValueObject = _ValueObject = __decorate([version$1("1.0")], ValueObject);
+const version$1 = "1.3.0";
 //#endregion
 //#region src/index.ts
 const ERP_CORE_NAME = "erp-core";
-const ERP_CORE_VERSION = version;
+const ERP_CORE_VERSION = version$1;
 const erpCoreRelease = {
 	name: ERP_CORE_NAME,
 	version: ERP_CORE_VERSION
 };
 //#endregion
-export { AlreadyExistsError, AppError, AuthenticationError, AuthorizationError, BusinessRuleViolationError, Command, ComputeEngineRegistry, ComputeEvaluatorRegistry, ComputePayloadParserRegistry, ComputePayloadParsers, ComputeRegistry, ConflictError, ContextResolverRegistry, ContextSeedValidator, CoreConfig, SerializationInError as DeserializationError, SerializationInError, DuplicateError, ERP_CORE_NAME, ERP_CORE_VERSION, Entity, Err, ErrorCodes, ExpiredError, GateEngineRegistry, GatePayloadParsers, IdempotencyError, IdempotencyInProgressError, IdempotencyKeyMissingError, IdempotencyPayloadMismatchError, IdempotencyReplayNotSupportedError, InMemoryPolicyDefinitionRepository, IntegrationError, LegacyIncompatibleError, NotFoundError, NotYetValidError, Ok, Outcome, PolicyAsOfResolver, PolicyCatalog, PolicyCatalogFactory, PolicyContextBuilder, PolicyContextPath, PolicyDefinition, PolicyEvaluationErrors, PolicyHashing, PolicyKey, PolicyResolver, PolicyScopeMatcher, PolicyService, Query, RequestedBy, Result, SerializationCodes, SerializationError, SerializationMessages, SerializationOutError, TemporalError, TemporalUseCase, UnexpectedError, UniqueConstraintViolationError, UseCase, ValidationError, ValidationField, ValueObject, asPolicyDecisionId, asPolicyDefinitionId, asSchoolId, asTenantId, assertJsonSafeMetadata, assertTemporalContext, contextResolverRegistry, coreConfig, createTemporalContext, erpCoreRelease, evaluateTemporalWindow, mapPolicyEvaluationError, payloadHash, registerNamespacedContextResolvers, registerNamespacedContextResolversIn, safePreview, serializationErrorCode, sha256Hex, stableStringify, translateUniqueViolationToDuplicate };
+export { AlreadyExistsError, AppError, AuthenticationError, AuthorizationError, BusinessRuleViolationError, BusinessRuleViolationException, CONTRACT_VERSION_PROPERTY, Command, ComputeEngineRegistry, ComputeEvaluatorRegistry, ComputePayloadParserRegistry, ComputePayloadParsers, ComputeRegistry, ConflictError, ContextResolverRegistry, ContextSeedValidator, CoreConfig, SerializationInError as DeserializationError, SerializationInError, DomainException, DuplicateError, ERP_CORE_NAME, ERP_CORE_VERSION, Entity, EntityNotFoundException, Err, ErrorCodes, ExpiredError, GateEngineRegistry, GatePayloadParsers, IdempotencyError, IdempotencyInProgressError, IdempotencyKeyMissingError, IdempotencyPayloadMismatchError, IdempotencyReplayNotSupportedError, InMemoryPolicyDefinitionRepository, IntegrationError, InvalidStateTransitionException, InvalidValueException, InvariantViolationException, LegacyIncompatibleError, MultipleValidationException, NotFoundError, NotYetValidError, Ok, Outcome, PluginManager, PolicyAsOfResolver, PolicyCatalog, PolicyCatalogFactory, PolicyContextBuilder, PolicyContextPath, PolicyDefinition, PolicyEvaluationErrors, PolicyHashing, PolicyKey, PolicyResolver, PolicyScopeMatcher, PolicyService, Query, RequestedBy, Result, RulesetRegistry, SerializationCodes, SerializationError, SerializationMessages, SerializationOutError, TemporalError, TemporalUseCase, UnexpectedError, UniqueConstraintViolationError, UseCase, UuidIdentifier, ValidationCode, ValidationError, ValidationException, ValidationField, ValueObject, asPolicyDecisionId, asPolicyDefinitionId, asSchoolId, asTenantId, assertJsonSafeMetadata, assertTemporalContext, buildDomainEventContractVersions, contextResolverRegistry, coreConfig, createDomainEventEnvelope, createTemporalContext, erpCoreRelease, evaluateTemporalWindow, mapPolicyEvaluationError, payloadHash, registerNamespacedContextResolvers, registerNamespacedContextResolversIn, safePreview, serializationErrorCode, sha256Hex, stableStringify, translateUniqueViolationToDuplicate, version };
 
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":["version","version"],"sources":["../src/version.ts","../src/core/shared/aggregate-version.ts","../src/core/domain/entity.ts","../src/core/domain/value-object.ts","../src/index.ts"],"sourcesContent":["// Versao do kit, sincronizada com package.json por scripts/sync-kit-version.mjs.\n// Nao edite a mao: rode `npm run sync-kit-version` (ou e regenerado no release).\n//\n// Mantemos a versao aqui, dentro de src/, para que a copia full-control seja\n// auto-contida: ao copiar so o conteudo de src/, o entry nao depende de um\n// `../package.json` que deixaria de existir no projeto consumidor.\nexport const version = \"1.1.0\";\n","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","import { type DeepReadonly, makeImmutable } from \"../shared/immutable.js\";\nimport { type ContractVersion, version } from \"../versioning/version.js\";\n\n/**\n * Base class for value objects — domain concepts defined entirely by their\n * contents, with no identity of their own. Two value objects are\n * interchangeable when they hold equal data, which is the opposite of an\n * {@link Entity} (compared by id). Money, a CPF, a date range: replacing one\n * instance with an equal one changes nothing about the model.\n *\n * Immutability is the defining guarantee here. The wrapped `value` is\n * deep-frozen on construction, so a value object can be shared freely without\n * any risk of a consumer mutating shared state. Subclasses seal the instance\n * itself with {@link finalize} once their own fields are set.\n *\n * @typeParam T - The shape of the wrapped data.\n * @typeParam P - The primitive form produced by {@link toPrimitive} / {@link toJSON}.\n */\n@version(\"1.0\")\nabstract class ValueObject<T, P> {\n    declare public static readonly CONTRACT_VERSION: ContractVersion;\n\n    /** The wrapped data, deep-frozen so it can never be mutated after construction. */\n    public readonly value: DeepReadonly<T>;\n\n    /**\n     * Wraps `value`, deep-freezing it so the value object is immutable from the\n     * moment it exists. Declared `protected` because value objects are built\n     * through a validating subclass factory, never instantiated directly.\n     */\n    protected constructor(value: T) {\n        this.value = makeImmutable(value);\n    }\n\n    /**\n     * The schema/contract version stamped on this value-object type by the\n     * `@version` decorator — used to detect state persisted under an older shape.\n     */\n    public get contractVersion(): ContractVersion {\n        return ValueObject.CONTRACT_VERSION;\n    }\n\n    /**\n     * Freezes the instance shell, blocking reassignment of any own field.\n     *\n     * `value` is already deep-frozen by the constructor, so the wrapped data is\n     * immutable regardless. The instance itself is NOT frozen automatically\n     * because a subclass may still need to assign its own fields after\n     * `super(value)` runs. Call `finalize()` at the very end of the subclass\n     * constructor (after all fields are set) to make the whole value object\n     * immutable.\n     */\n    protected finalize(): void {\n        Object.freeze(this);\n    }\n\n    /**\n     * Hook for `JSON.stringify`. Delegates to {@link toPrimitive} so a value\n     * object serializes to its primitive form rather than exposing the internal\n     * `value` wrapper.\n     */\n    public toJSON(): P {\n        return this.toPrimitive();\n    }\n\n    /**\n     * Compares this value object with another by content. Because value objects\n     * carry no identity, subclasses implement equality over the wrapped data\n     * (typically the primitive form), so two independently constructed instances\n     * holding the same data are considered equal.\n     */\n    public abstract equals(other: this): boolean;\n\n    /**\n     * Projects the value object down to a plain, serializable primitive form —\n     * the representation suitable for persistence, transport, or comparison.\n     */\n    public abstract toPrimitive(): P;\n}\n\nexport { type DeepReadonly, ValueObject };\n","import { version } from \"./version.js\";\n\nexport * from \"./core/index.js\";\n\nexport const ERP_CORE_NAME = \"erp-core\";\nexport const ERP_CORE_VERSION = version;\n\nexport const erpCoreRelease = {\n    name: ERP_CORE_NAME,\n    version: ERP_CORE_VERSION,\n} as const;\n"],"mappings":";;;;;;;;;;;;AAMA,MAAa,UAAU;;;ACJvB,SAAS,4BAA4B,kBAAgC;CACjE,IAAI,CAAC,OAAO,UAAU,gBAAgB,KAAK,mBAAmB,GAC1D,MAAM,IAAI,4BACN,8DAA8D,kBAClE;AAER;;;;;;;;;;;;;;;;;;AC0BA,IAAA,SAAA,MACe,OAAoB;;;;;;;;;;;;;;;;;;CAsB/B,YAAsB,OAAiC;EACnD,gBAAgB,aAAa,MAAM,SAAS;EAC5C,gBAAgB,aAAa,MAAM,SAAS;EAC5C,4BAA4B,MAAM,gBAAgB;EAElD,IAAI,MAAM,UAAU,QAAQ,IAAI,MAAM,UAAU,QAAQ,GACpD,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,MAAM,MAAM;EACjB,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,aAAa,UAAU,MAAM,SAAS;EAC3C,KAAK,oBAAoB,MAAM;CACnC;;CAGA,IAAW,KAAkB;EACzB,OAAO,KAAK;CAChB;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,UAAU,KAAK,UAAU;CACpC;;;;;;;CAQA,IAAW,YAAkB;EACzB,OAAO,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,gBAAgB,aAAa,SAAS;EAEtC,IAAI,UAAU,QAAQ,IAAI,KAAK,WAAW,QAAQ,GAC9C,MAAM,IAAI,4BACN,4CACJ;EAGJ,KAAK,aAAa,UAAU,SAAS;EACrC,KAAK,qBAAqB;EAE1B,OAAO,KAAK;CAChB;AACJ;+BA7GCA,UAAQ,KAAK,CAAA,GAAA,MAAA;;;;;;;;;;;;;;;;;;;AChBd,IAAA,cAAA,MACe,YAAkB;;;;;;;;;CAW7B,YAAsB,OAAU;EAC5B,KAAK,QAAQ,cAAc,KAAK;CACpC;;;;;CAMA,IAAW,kBAAmC;EAC1C,OAAA,aAAmB;CACvB;;;;;;;;;;;CAYA,WAA2B;EACvB,OAAO,OAAO,IAAI;CACtB;;;;;;CAOA,SAAmB;EACf,OAAO,KAAK,YAAY;CAC5B;AAeJ;yCA5DCC,UAAQ,KAAK,CAAA,GAAA,WAAA;;;ACdd,MAAa,gBAAgB;AAC7B,MAAa,mBAAmB;AAEhC,MAAa,iBAAiB;CAC1B,MAAM;CACN,SAAS;AACb"}
+{"version":3,"file":"index.js","names":["version","version"],"sources":["../src/version.ts","../src/index.ts"],"sourcesContent":["// Versao do kit, sincronizada com package.json por scripts/sync-kit-version.mjs.\n// Nao edite a mao: rode `npm run sync-kit-version` (ou e regenerado no release).\n//\n// Mantemos a versao aqui, dentro de src/, para que a copia full-control seja\n// auto-contida: ao copiar so o conteudo de src/, o entry nao depende de um\n// `../package.json` que deixaria de existir no projeto consumidor.\nexport const version = \"1.3.0\";\n","import { version } from \"./version.js\";\n\nexport * from \"./core/index.js\";\n\nexport const ERP_CORE_NAME = \"erp-core\";\nexport const ERP_CORE_VERSION = version;\n\nexport const erpCoreRelease = {\n    name: ERP_CORE_NAME,\n    version: ERP_CORE_VERSION,\n} as const;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;AAMA,MAAaA,YAAU;;;ACFvB,MAAa,gBAAgB;AAC7B,MAAa,mBAAmBC;AAEhC,MAAa,iBAAiB;CAC1B,MAAM;CACN,SAAS;AACb"}

package/dist/invalid-state-transition-exception.cjs

@@ -0,0 +1,47 @@
+const require_domain_exception = require("./domain-exception.cjs");
+//#region src/core/exceptions/business-rule-violation-exception.ts
+var BusinessRuleViolationException = class extends require_domain_exception.DomainException {
+	constructor(rule, message) {
+		super(message);
+		this.rule = rule;
+	}
+};
+//#endregion
+//#region src/core/exceptions/entity-not-found-exception.ts
+var EntityNotFoundException = class extends require_domain_exception.DomainException {
+	constructor(entityName, identifier) {
+		super(`${entityName} with identifier ${identifier} was not found.`);
+		this.entityName = entityName;
+		this.identifier = identifier;
+	}
+};
+//#endregion
+//#region src/core/exceptions/invalid-state-transition-exception.ts
+var InvalidStateTransitionException = class extends require_domain_exception.DomainException {
+	constructor(from, to, message) {
+		super(message);
+		this.from = from;
+		this.to = to;
+	}
+};
+//#endregion
+Object.defineProperty(exports, "BusinessRuleViolationException", {
+	enumerable: true,
+	get: function() {
+		return BusinessRuleViolationException;
+	}
+});
+Object.defineProperty(exports, "EntityNotFoundException", {
+	enumerable: true,
+	get: function() {
+		return EntityNotFoundException;
+	}
+});
+Object.defineProperty(exports, "InvalidStateTransitionException", {
+	enumerable: true,
+	get: function() {
+		return InvalidStateTransitionException;
+	}
+});
+
+//# sourceMappingURL=invalid-state-transition-exception.cjs.map

package/dist/invalid-state-transition-exception.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-state-transition-exception.cjs","names":["DomainException","DomainException","DomainException"],"sources":["../src/core/exceptions/business-rule-violation-exception.ts","../src/core/exceptions/entity-not-found-exception.ts","../src/core/exceptions/invalid-state-transition-exception.ts"],"sourcesContent":["import { DomainException } from \"./domain-exception.js\";\n\nclass BusinessRuleViolationException extends DomainException {\n    constructor(\n        public readonly rule: string,\n        message: string,\n    ) {\n        super(message);\n    }\n}\n\nexport { BusinessRuleViolationException };\n","import { DomainException } from \"./domain-exception.js\";\n\nclass EntityNotFoundException extends DomainException {\n    constructor(\n        public readonly entityName: string,\n        public readonly identifier: string,\n    ) {\n        super(`${entityName} with identifier ${identifier} was not found.`);\n    }\n}\n\nexport { EntityNotFoundException };\n","import { DomainException } from \"./domain-exception.js\";\n\nclass InvalidStateTransitionException<\n    TState extends string = string,\n> extends DomainException {\n    constructor(\n        public readonly from: TState,\n        public readonly to: TState,\n        message: string,\n    ) {\n        super(message);\n    }\n}\n\nexport { InvalidStateTransitionException };\n"],"mappings":";;AAEA,IAAM,iCAAN,cAA6CA,yBAAAA,gBAAgB;CACzD,YACI,MACA,SACF;EACE,MAAM,OAAO;EAHG,KAAA,OAAA;CAIpB;AACJ;;;ACPA,IAAM,0BAAN,cAAsCC,yBAAAA,gBAAgB;CAClD,YACI,YACA,YACF;EACE,MAAM,GAAG,WAAW,mBAAmB,WAAW,gBAAgB;EAHlD,KAAA,aAAA;EACA,KAAA,aAAA;CAGpB;AACJ;;;ACPA,IAAM,kCAAN,cAEUC,yBAAAA,gBAAgB;CACtB,YACI,MACA,IACA,SACF;EACE,MAAM,OAAO;EAJG,KAAA,OAAA;EACA,KAAA,KAAA;CAIpB;AACJ"}

package/dist/invalid-state-transition-exception.js

@@ -0,0 +1,30 @@
+import { t as DomainException } from "./domain-exception.js";
+//#region src/core/exceptions/business-rule-violation-exception.ts
+var BusinessRuleViolationException = class extends DomainException {
+	constructor(rule, message) {
+		super(message);
+		this.rule = rule;
+	}
+};
+//#endregion
+//#region src/core/exceptions/entity-not-found-exception.ts
+var EntityNotFoundException = class extends DomainException {
+	constructor(entityName, identifier) {
+		super(`${entityName} with identifier ${identifier} was not found.`);
+		this.entityName = entityName;
+		this.identifier = identifier;
+	}
+};
+//#endregion
+//#region src/core/exceptions/invalid-state-transition-exception.ts
+var InvalidStateTransitionException = class extends DomainException {
+	constructor(from, to, message) {
+		super(message);
+		this.from = from;
+		this.to = to;
+	}
+};
+//#endregion
+export { EntityNotFoundException as n, BusinessRuleViolationException as r, InvalidStateTransitionException as t };
+
+//# sourceMappingURL=invalid-state-transition-exception.js.map

package/dist/invalid-state-transition-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invalid-state-transition-exception.js","names":[],"sources":["../src/core/exceptions/business-rule-violation-exception.ts","../src/core/exceptions/entity-not-found-exception.ts","../src/core/exceptions/invalid-state-transition-exception.ts"],"sourcesContent":["import { DomainException } from \"./domain-exception.js\";\n\nclass BusinessRuleViolationException extends DomainException {\n    constructor(\n        public readonly rule: string,\n        message: string,\n    ) {\n        super(message);\n    }\n}\n\nexport { BusinessRuleViolationException };\n","import { DomainException } from \"./domain-exception.js\";\n\nclass EntityNotFoundException extends DomainException {\n    constructor(\n        public readonly entityName: string,\n        public readonly identifier: string,\n    ) {\n        super(`${entityName} with identifier ${identifier} was not found.`);\n    }\n}\n\nexport { EntityNotFoundException };\n","import { DomainException } from \"./domain-exception.js\";\n\nclass InvalidStateTransitionException<\n    TState extends string = string,\n> extends DomainException {\n    constructor(\n        public readonly from: TState,\n        public readonly to: TState,\n        message: string,\n    ) {\n        super(message);\n    }\n}\n\nexport { InvalidStateTransitionException };\n"],"mappings":";;AAEA,IAAM,iCAAN,cAA6C,gBAAgB;CACzD,YACI,MACA,SACF;EACE,MAAM,OAAO;EAHG,KAAA,OAAA;CAIpB;AACJ;;;ACPA,IAAM,0BAAN,cAAsC,gBAAgB;CAClD,YACI,YACA,YACF;EACE,MAAM,GAAG,WAAW,mBAAmB,WAAW,gBAAgB;EAHlD,KAAA,aAAA;EACA,KAAA,aAAA;CAGpB;AACJ;;;ACPA,IAAM,kCAAN,cAEU,gBAAgB;CACtB,YACI,MACA,IACA,SACF;EACE,MAAM,OAAO;EAJG,KAAA,OAAA;EACA,KAAA,KAAA;CAIpB;AACJ"}

package/dist/invariant-violation-exception.cjs

@@ -0,0 +1,16 @@
+const require_domain_exception = require("./domain-exception.cjs");
+//#region src/core/exceptions/invariant-violation-exception.ts
+var InvariantViolationException = class extends require_domain_exception.DomainException {
+	constructor(message) {
+		super(message);
+	}
+};
+//#endregion
+Object.defineProperty(exports, "InvariantViolationException", {
+	enumerable: true,
+	get: function() {
+		return InvariantViolationException;
+	}
+});
+
+//# sourceMappingURL=invariant-violation-exception.cjs.map

package/dist/invariant-violation-exception.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant-violation-exception.cjs","names":["DomainException"],"sources":["../src/core/exceptions/invariant-violation-exception.ts"],"sourcesContent":["import { DomainException } from \"./domain-exception.js\";\n\nclass InvariantViolationException extends DomainException {\n    constructor(message: string) {\n        super(message);\n    }\n}\n\nexport { InvariantViolationException };\n"],"mappings":";;AAEA,IAAM,8BAAN,cAA0CA,yBAAAA,gBAAgB;CACtD,YAAY,SAAiB;EACzB,MAAM,OAAO;CACjB;AACJ"}

package/dist/invariant-violation-exception.js

@@ -0,0 +1,11 @@
+import { t as DomainException } from "./domain-exception.js";
+//#region src/core/exceptions/invariant-violation-exception.ts
+var InvariantViolationException = class extends DomainException {
+	constructor(message) {
+		super(message);
+	}
+};
+//#endregion
+export { InvariantViolationException as t };
+
+//# sourceMappingURL=invariant-violation-exception.js.map

package/dist/invariant-violation-exception.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invariant-violation-exception.js","names":[],"sources":["../src/core/exceptions/invariant-violation-exception.ts"],"sourcesContent":["import { DomainException } from \"./domain-exception.js\";\n\nclass InvariantViolationException extends DomainException {\n    constructor(message: string) {\n        super(message);\n    }\n}\n\nexport { InvariantViolationException };\n"],"mappings":";;AAEA,IAAM,8BAAN,cAA0C,gBAAgB;CACtD,YAAY,SAAiB;EACzB,MAAM,OAAO;CACjB;AACJ"}

package/dist/not-found-error.cjs

@@ -0,0 +1,65 @@
+const require_unexpected_error = require("./unexpected-error.cjs");
+//#region src/core/errors/business-rule-violation-error.ts
+var BusinessRuleViolationError = class extends require_unexpected_error.AppError {
+	constructor(rule, message, detail, options) {
+		const baseMetadata = detail ? {
+			rule,
+			detail
+		} : { rule };
+		const mergedMetadata = options?.metadata ? {
+			...baseMetadata,
+			...options.metadata
+		} : baseMetadata;
+		super(message, require_unexpected_error.ErrorCodes.businessRuleViolation, {
+			...options,
+			metadata: mergedMetadata
+		});
+	}
+};
+//#endregion
+//#region src/core/errors/not-found-error.ts
+/**
+* Raised when a requested resource does not exist. Maps naturally onto an HTTP
+* 404 at the edge, but stays transport-agnostic here.
+*
+* The `resource` name builds the message (`"<resource> not found"`) and, with
+* the optional lookup `criteria`, lands in the metadata so logs show *what* was
+* searched for without the caller having to restate it in the message.
+*/
+var NotFoundError = class extends require_unexpected_error.AppError {
+	/**
+	* @param resource - Human-readable name of the missing resource (e.g. `"Order"`).
+	* @param criteria - Optional lookup keys used in the search; recorded in
+	*   metadata to aid debugging. Avoid putting sensitive values here.
+	* @param options - Optional cause, correlation ids, and extra metadata.
+	*/
+	constructor(resource, criteria, options) {
+		const baseMetadata = criteria ? {
+			resource,
+			criteria
+		} : { resource };
+		const mergedMetadata = options?.metadata ? {
+			...baseMetadata,
+			...options.metadata
+		} : baseMetadata;
+		super(`${resource} not found`, require_unexpected_error.ErrorCodes.notFound, {
+			...options,
+			metadata: mergedMetadata
+		});
+	}
+};
+//#endregion
+Object.defineProperty(exports, "BusinessRuleViolationError", {
+	enumerable: true,
+	get: function() {
+		return BusinessRuleViolationError;
+	}
+});
+Object.defineProperty(exports, "NotFoundError", {
+	enumerable: true,
+	get: function() {
+		return NotFoundError;
+	}
+});
+
+//# sourceMappingURL=not-found-error.cjs.map

package/dist/not-found-error.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"not-found-error.cjs","names":["AppError","ErrorCodes","AppError","ErrorCodes"],"sources":["../src/core/errors/business-rule-violation-error.ts","../src/core/errors/not-found-error.ts"],"sourcesContent":["import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// BusinessRuleViolationError\n// ─────────────────────────────────────────────────────────────────────────────\n\nclass BusinessRuleViolationError extends AppError {\n    constructor(\n        rule: string,\n        message: string,\n        detail?: Record<string, unknown>,\n        options?: AppErrorOptions,\n    ) {\n        const baseMetadata = detail ? { rule, detail } : { rule };\n        const mergedMetadata = options?.metadata\n            ? { ...baseMetadata, ...options.metadata }\n            : baseMetadata;\n\n        super(message, ErrorCodes.businessRuleViolation, {\n            ...options,\n            metadata: mergedMetadata,\n        });\n    }\n}\n\nexport { BusinessRuleViolationError };\n","import { AppError } from \"./app-error.js\";\nimport { ErrorCodes } from \"./error-codes.js\";\nimport type { AppErrorOptions } from \"./types.js\";\n\n// ─────────────────────────────────────────────────────────────────────────────\n// NotFoundError\n// ─────────────────────────────────────────────────────────────────────────────\n\n/**\n * Raised when a requested resource does not exist. Maps naturally onto an HTTP\n * 404 at the edge, but stays transport-agnostic here.\n *\n * The `resource` name builds the message (`\"<resource> not found\"`) and, with\n * the optional lookup `criteria`, lands in the metadata so logs show *what* was\n * searched for without the caller having to restate it in the message.\n */\nclass NotFoundError extends AppError {\n    /**\n     * @param resource - Human-readable name of the missing resource (e.g. `\"Order\"`).\n     * @param criteria - Optional lookup keys used in the search; recorded in\n     *   metadata to aid debugging. Avoid putting sensitive values here.\n     * @param options - Optional cause, correlation ids, and extra metadata.\n     */\n    constructor(\n        resource: string,\n        criteria?: Record<string, unknown>,\n        options?: AppErrorOptions,\n    ) {\n        const baseMetadata = criteria ? { resource, criteria } : { resource };\n        const mergedMetadata = options?.metadata\n            ? { ...baseMetadata, ...options.metadata }\n            : baseMetadata;\n\n        super(`${resource} not found`, ErrorCodes.notFound, {\n            ...options,\n            metadata: mergedMetadata,\n        });\n    }\n}\n\nexport { NotFoundError };\n"],"mappings":";;AAQA,IAAM,6BAAN,cAAyCA,yBAAAA,SAAS;CAC9C,YACI,MACA,SACA,QACA,SACF;EACE,MAAM,eAAe,SAAS;GAAE;GAAM;EAAO,IAAI,EAAE,KAAK;EACxD,MAAM,iBAAiB,SAAS,WAC1B;GAAE,GAAG;GAAc,GAAG,QAAQ;EAAS,IACvC;EAEN,MAAM,SAASC,yBAAAA,WAAW,uBAAuB;GAC7C,GAAG;GACH,UAAU;EACd,CAAC;CACL;AACJ;;;;;;;;;;;ACTA,IAAM,gBAAN,cAA4BC,yBAAAA,SAAS;;;;;;;CAOjC,YACI,UACA,UACA,SACF;EACE,MAAM,eAAe,WAAW;GAAE;GAAU;EAAS,IAAI,EAAE,SAAS;EACpE,MAAM,iBAAiB,SAAS,WAC1B;GAAE,GAAG;GAAc,GAAG,QAAQ;EAAS,IACvC;EAEN,MAAM,GAAG,SAAS,aAAaC,yBAAAA,WAAW,UAAU;GAChD,GAAG;GACH,UAAU;EACd,CAAC;CACL;AACJ"}

package/dist/not-found-error.js

@@ -1,4 +1,4 @@
-import { a as ErrorCodes, r as AppError } from "./validation-code.js";
+import { i as ErrorCodes, n as AppError } from "./unexpected-error.js";
 //#region src/core/errors/business-rule-violation-error.ts
 var BusinessRuleViolationError = class extends AppError {
 	constructor(rule, message, detail, options) {

package/dist/outcome.cjs

@@ -0,0 +1,97 @@
+const require_invariant_violation_exception = require("./invariant-violation-exception.cjs");
+//#region src/core/result/outcome.ts
+/**
+* Outcome — Business decision abstraction.
+*
+* Represents the semantic result of a domain decision, policy evaluation,
+* or business rule. NOT for technical success/failure — use Result for that.
+*
+* Mental model:
+*   "What was the business decision?"
+*   NOT "Did the operation succeed?"
+*
+* The status axis represents valid business outcomes (APPROVED, REJECTED,
+* ALLOW, DENY, NO_OP, etc.), never technical Ok/Err.
+*
+* @typeParam S - Union of valid status literals for this outcome
+* @typeParam D - Shape of the decision data carried by this outcome
+*/
+var Outcome = class Outcome {
+	constructor(status, data, reason, metadata) {
+		this.status = status;
+		this.data = data;
+		this.reason = reason;
+		this.metadata = metadata;
+		Object.freeze(this);
+	}
+	static of(status, data, reason, metadata) {
+		return new Outcome(status, data, reason, Object.freeze({ ...metadata }));
+	}
+	static approved(data, reason) {
+		return new Outcome("APPROVED", data, reason, Object.freeze({}));
+	}
+	static rejected(data, reason) {
+		return new Outcome("REJECTED", data, reason, Object.freeze({}));
+	}
+	static noOp(data, reason) {
+		return new Outcome("NO_OP", data, reason, Object.freeze({}));
+	}
+	static deferred(data, reason) {
+		return new Outcome("DEFERRED", data, reason, Object.freeze({}));
+	}
+	static requiresReview(data, reason) {
+		return new Outcome("REQUIRES_REVIEW", data, reason, Object.freeze({}));
+	}
+	/**
+	* Narrows this Outcome to a specific status.
+	*
+	* @example
+	* if (outcome.is('DENY')) {
+	*   outcome.data.violations // TS knows status is 'DENY'
+	* }
+	*/
+	is(status) {
+		return this.status === status;
+	}
+	/**
+	* Exhaustive pattern match over all possible statuses.
+	* TypeScript enforces that every status has a handler.
+	*
+	* @example
+	* outcome.match({
+	*   ALLOW: (o) => handleAllow(o.data),
+	*   DENY:  (o) => handleDeny(o.data.violations),
+	* })
+	*/
+	match(handlers) {
+		const handler = handlers[this.status];
+		if (typeof handler !== "function") {
+			const availableStatuses = Object.keys(handlers);
+			throw new require_invariant_violation_exception.InvariantViolationException(`Outcome.match is missing a handler for runtime status "${this.status}". Available handlers: ${availableStatuses.join(", ") || "(none)"}`);
+		}
+		return handler(this);
+	}
+	withMetadata(extra) {
+		return new Outcome(this.status, this.data, this.reason, Object.freeze({
+			...this.metadata,
+			...extra
+		}));
+	}
+	withReason(reason) {
+		return new Outcome(this.status, this.data, reason, this.metadata);
+	}
+	toString() {
+		const parts = [this.status];
+		if (this.reason) parts.push(`reason="${this.reason}"`);
+		return `Outcome(${parts.join(", ")})`;
+	}
+};
+//#endregion
+Object.defineProperty(exports, "Outcome", {
+	enumerable: true,
+	get: function() {
+		return Outcome;
+	}
+});
+
+//# sourceMappingURL=outcome.cjs.map

package/dist/outcome.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"outcome.cjs","names":["InvariantViolationException"],"sources":["../src/core/result/outcome.ts"],"sourcesContent":["// core/domain/outcome.ts\n\nimport { InvariantViolationException } from \"../exceptions/invariant-violation-exception.js\";\n\n/**\n * Outcome — Business decision abstraction.\n *\n * Represents the semantic result of a domain decision, policy evaluation,\n * or business rule. NOT for technical success/failure — use Result for that.\n *\n * Mental model:\n *   \"What was the business decision?\"\n *   NOT \"Did the operation succeed?\"\n *\n * The status axis represents valid business outcomes (APPROVED, REJECTED,\n * ALLOW, DENY, NO_OP, etc.), never technical Ok/Err.\n *\n * @typeParam S - Union of valid status literals for this outcome\n * @typeParam D - Shape of the decision data carried by this outcome\n */\nexport class Outcome<S extends string, D = undefined> {\n    readonly status: S;\n    readonly data: D;\n    readonly reason: string | undefined;\n    readonly metadata: Readonly<Record<string, unknown>>;\n\n    private constructor(\n        status: S,\n        data: D,\n        reason: string | undefined,\n        metadata: Readonly<Record<string, unknown>>,\n    ) {\n        this.status = status;\n        this.data = data;\n        this.reason = reason;\n        this.metadata = metadata;\n        Object.freeze(this);\n    }\n\n    // ─── Generic factory ────────────────────────────────────────────────\n\n    static of<S extends string, D = undefined>(\n        status: S,\n        data: D,\n        reason?: string,\n        metadata?: Record<string, unknown>,\n    ): Outcome<S, D> {\n        return new Outcome(\n            status,\n            data,\n            reason,\n            Object.freeze({ ...metadata }),\n        );\n    }\n\n    // ─── Convenience factories for common business statuses ─────────────\n\n    static approved<D = undefined>(\n        data: D,\n        reason?: string,\n    ): Outcome<\"APPROVED\", D> {\n        return new Outcome(\"APPROVED\", data, reason, Object.freeze({}));\n    }\n\n    static rejected<D = undefined>(\n        data: D,\n        reason: string,\n    ): Outcome<\"REJECTED\", D> {\n        return new Outcome(\"REJECTED\", data, reason, Object.freeze({}));\n    }\n\n    static noOp<D = undefined>(data: D, reason?: string): Outcome<\"NO_OP\", D> {\n        return new Outcome(\"NO_OP\", data, reason, Object.freeze({}));\n    }\n\n    static deferred<D = undefined>(\n        data: D,\n        reason: string,\n    ): Outcome<\"DEFERRED\", D> {\n        return new Outcome(\"DEFERRED\", data, reason, Object.freeze({}));\n    }\n\n    static requiresReview<D = undefined>(\n        data: D,\n        reason: string,\n    ): Outcome<\"REQUIRES_REVIEW\", D> {\n        return new Outcome(\"REQUIRES_REVIEW\", data, reason, Object.freeze({}));\n    }\n\n    // ─── Type narrowing ────────────────────────────────────────────────\n\n    /**\n     * Narrows this Outcome to a specific status.\n     *\n     * @example\n     * if (outcome.is('DENY')) {\n     *   outcome.data.violations // TS knows status is 'DENY'\n     * }\n     */\n    is<T extends S>(status: T): this is Outcome<T, D> {\n        return (this.status as string) === status;\n    }\n\n    // ─── Exhaustive match ──────────────────────────────────────────────\n\n    /**\n     * Exhaustive pattern match over all possible statuses.\n     * TypeScript enforces that every status has a handler.\n     *\n     * @example\n     * outcome.match({\n     *   ALLOW: (o) => handleAllow(o.data),\n     *   DENY:  (o) => handleDeny(o.data.violations),\n     * })\n     */\n    match<THandlers extends { [K in S]: (outcome: Outcome<K, D>) => unknown }>(\n        handlers: THandlers,\n    ): ReturnType<THandlers[S]> {\n        const handler = (\n            handlers as Partial<Record<string, (o: unknown) => unknown>>\n        )[this.status];\n\n        if (typeof handler !== \"function\") {\n            const availableStatuses = Object.keys(handlers);\n            throw new InvariantViolationException(\n                `Outcome.match is missing a handler for runtime status \"${this.status}\". Available handlers: ${availableStatuses.join(\", \") || \"(none)\"}`,\n            );\n        }\n\n        return handler(this) as ReturnType<THandlers[S]>;\n    }\n\n    // ─── Derived copies ────────────────────────────────────────────────\n\n    withMetadata(extra: Record<string, unknown>): Outcome<S, D> {\n        return new Outcome(\n            this.status,\n            this.data,\n            this.reason,\n            Object.freeze({ ...this.metadata, ...extra }),\n        );\n    }\n\n    withReason(reason: string): Outcome<S, D> {\n        return new Outcome(this.status, this.data, reason, this.metadata);\n    }\n\n    // ─── Debug ─────────────────────────────────────────────────────────\n\n    toString(): string {\n        const parts: string[] = [this.status];\n        if (this.reason) parts.push(`reason=\"${this.reason}\"`);\n        return `Outcome(${parts.join(\", \")})`;\n    }\n}\n\n/** Common business outcome statuses. Extend per domain as needed. */\nexport type CommonOutcomeStatus =\n    | \"APPROVED\"\n    | \"REJECTED\"\n    | \"NO_OP\"\n    | \"DEFERRED\"\n    | \"REQUIRES_REVIEW\";\n"],"mappings":";;;;;;;;;;;;;;;;;;AAoBA,IAAa,UAAb,MAAa,QAAyC;CAMlD,YACI,QACA,MACA,QACA,UACF;EACE,KAAK,SAAS;EACd,KAAK,OAAO;EACZ,KAAK,SAAS;EACd,KAAK,WAAW;EAChB,OAAO,OAAO,IAAI;CACtB;CAIA,OAAO,GACH,QACA,MACA,QACA,UACa;EACb,OAAO,IAAI,QACP,QACA,MACA,QACA,OAAO,OAAO,EAAE,GAAG,SAAS,CAAC,CACjC;CACJ;CAIA,OAAO,SACH,MACA,QACsB;EACtB,OAAO,IAAI,QAAQ,YAAY,MAAM,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC;CAClE;CAEA,OAAO,SACH,MACA,QACsB;EACtB,OAAO,IAAI,QAAQ,YAAY,MAAM,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC;CAClE;CAEA,OAAO,KAAoB,MAAS,QAAsC;EACtE,OAAO,IAAI,QAAQ,SAAS,MAAM,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC;CAC/D;CAEA,OAAO,SACH,MACA,QACsB;EACtB,OAAO,IAAI,QAAQ,YAAY,MAAM,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC;CAClE;CAEA,OAAO,eACH,MACA,QAC6B;EAC7B,OAAO,IAAI,QAAQ,mBAAmB,MAAM,QAAQ,OAAO,OAAO,CAAC,CAAC,CAAC;CACzE;;;;;;;;;CAYA,GAAgB,QAAkC;EAC9C,OAAQ,KAAK,WAAsB;CACvC;;;;;;;;;;;CAcA,MACI,UACwB;EACxB,MAAM,UACF,SACF,KAAK;EAEP,IAAI,OAAO,YAAY,YAAY;GAC/B,MAAM,oBAAoB,OAAO,KAAK,QAAQ;GAC9C,MAAM,IAAIA,sCAAAA,4BACN,0DAA0D,KAAK,OAAO,yBAAyB,kBAAkB,KAAK,IAAI,KAAK,UACnI;EACJ;EAEA,OAAO,QAAQ,IAAI;CACvB;CAIA,aAAa,OAA+C;EACxD,OAAO,IAAI,QACP,KAAK,QACL,KAAK,MACL,KAAK,QACL,OAAO,OAAO;GAAE,GAAG,KAAK;GAAU,GAAG;EAAM,CAAC,CAChD;CACJ;CAEA,WAAW,QAA+B;EACtC,OAAO,IAAI,QAAQ,KAAK,QAAQ,KAAK,MAAM,QAAQ,KAAK,QAAQ;CACpE;CAIA,WAAmB;EACf,MAAM,QAAkB,CAAC,KAAK,MAAM;EACpC,IAAI,KAAK,QAAQ,MAAM,KAAK,WAAW,KAAK,OAAO,EAAE;EACrD,OAAO,WAAW,MAAM,KAAK,IAAI,EAAE;CACvC;AACJ"}