@vytches/ddd-value-objects 0.29.3 → 0.31.0-alpha.0

package/dist/base-value-object.d.ts

@@ -3,10 +3,41 @@ export interface ValueObjectValidator<T> {
 }
 export declare abstract class BaseValueObject<T> implements ValueObjectValidator<T> {
     protected readonly value: T;
+    /**
+     * VF-023 (D-1, AC1, BREAKING): validates `value` via the polymorphic
+     * `validate()` hook and throws synchronously on failure. This replaces
+     * the previous convention where every subclass repeated
+     * `if (!this.validate(value)) throw ...` in its own constructor after
+     * `super(value)` — that boilerplate is now centralized here and enforced
+     * for ALL subclasses, including any that previously forgot it.
+     *
+     * MIGRATION NOTE (undefined-during-super() trap): `validate()` is called
+     * via prototype dispatch from *this* base constructor, i.e. before the
+     * subclass constructor body (and therefore any subclass field
+     * initializers declared after `super(value)`) has run. A `validate()`
+     * override that reads `this.someOtherField` set up elsewhere in the
+     * subclass constructor will see `undefined` for that field. Overrides
+     * must only depend on the `value` parameter passed in, not on
+     * subclass instance state. Existing subclasses that already call
+     * `this.validate(value)` redundantly after `super(value)` are
+     * unaffected — the base class throws first, before that redundant call
+     * is ever reached.
+     */
     constructor(value: T);
     /**
      * Compares this value object with another for equality.
      * Uses deep structural comparison for object values, === for primitives.
+     *
+     * VF-023 (D-3, AC2/AC3, BREAKING): deep comparison now uses
+     * `LibUtils.deepEqual` instead of `JSON.stringify` equality. This fixes
+     * false negatives/positives inherent to JSON-based comparison — key
+     * order sensitivity is gone (already true before, since JSON.stringify
+     * of plain objects is insertion-order, not truly key-order-independent
+     * in all engines), values like `undefined`, `Date`, `Map`, `Set`, and
+     * `NaN` inside nested structures now compare by actual value semantics
+     * instead of silently dropping (`undefined`) or losing type
+     * (`Date`/`Map`/`Set` stringify to structurally different, sometimes
+     * colliding, JSON shapes).
      * @param valueObject - The value object to compare with
      * @returns True if they are equal, false otherwise
      */
@@ -32,4 +63,19 @@ export declare abstract class BaseValueObject<T> implements ValueObjectValidator
      * @returns True if valid, false otherwise
      */
     abstract validate(value: unknown): boolean;
+    /**
+     * VF-023 (D-1 regression fix): produces the message used when the
+     * constructor's synchronous `validate()` call fails. Because the base
+     * constructor now throws BEFORE the subclass constructor body runs (see
+     * the class-level doc comment), a subclass can no longer rely on its own
+     * post-`super(value)` `throw new Error('...')` — that code is
+     * unreachable, since the base class has already thrown by the time
+     * control would return to the subclass. Override this hook instead to
+     * provide a validation-error message specific to the subclass. Only
+     * `value` (the parameter, not subclass instance state — see the
+     * undefined-during-super() trap note above) is safe to use here.
+     * @param value The value that failed validation
+     * @returns The message to use for the thrown `Error`
+     */
+    protected getInvalidValueMessage(value: T): string;
 }

package/dist/id.value-object.d.ts

@@ -1,4 +1,4 @@
-import { EntityId as BaseEntityId, IEntityIdFactory, IdType } from '@vytches/ddd-contracts';
+import { EntityId as BaseEntityId, IdType } from '@vytches/ddd-contracts';
 import { Result } from '@vytches/ddd-utils';
 export declare class EntityId<T = string> extends BaseEntityId<T> {
     constructor(value: T, type: IdType);
@@ -55,52 +55,3 @@ export declare class EntityId<T = string> extends BaseEntityId<T> {
      */
     static tryFromText(value: string): Result<EntityId<string>, Error>;
 }
-/**
- * @deprecated Use EntityId static methods directly instead. This class will be removed in the next major version.
- * @example
- * ```typescript
- * // Before (deprecated):
- * const id = EntityIdFactory.createWithRandomUUID();
- *
- * // After (recommended):
- * const id = EntityId.create();
- * ```
- */
-export declare class EntityIdFactory implements IEntityIdFactory {
-    /**
-     * @deprecated Use EntityId.create() instead. Will be removed in v1.0.0.
-     */
-    static createWithRandomUUID(): EntityId<string>;
-    /**
-     * @deprecated Use EntityId.fromUUID() instead. Will be removed in v1.0.0.
-     * @throws {MissingValueError} if value is empty
-     * @throws {InvalidParameterError} if value is empty
-     */
-    static fromUUID(value: string): EntityId<string>;
-    /**
-     * @deprecated Use EntityId.fromInteger() instead. Will be removed in v1.0.0.
-     * @throws {InvalidParameterError} if value is empty
-     */
-    static fromInteger(value: number): EntityId<string>;
-    /**
-     * @deprecated Use EntityId.fromBigInt() instead. Will be removed in v1.0.0.
-     * @throws {InvalidParameterError} if value is empty
-     */
-    static fromBigInt(value: string | bigint): EntityId<string>;
-    /**
-     * @deprecated Use EntityId.fromText() instead. Will be removed in v1.0.0.
-     * @throws {MissingValueError} if value is empty
-     * @throws {InvalidParameterError} if value is empty
-     */
-    static fromText(value: string): EntityId<string>;
-    /** @deprecated Use EntityId.create() instead */
-    createWithRandomUUID(): EntityId<string>;
-    /** @deprecated Use EntityId.fromUUID() instead */
-    fromUUID(value: string): EntityId<string>;
-    /** @deprecated Use EntityId.fromInteger() instead */
-    fromInteger(value: number): EntityId<string>;
-    /** @deprecated Use EntityId.fromBigInt() instead */
-    fromBigInt(value: string | bigint): EntityId<string>;
-    /** @deprecated Use EntityId.fromText() instead */
-    fromText(value: string): EntityId<string>;
-}

package/dist/index.cjs

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("@vytches/ddd-contracts"),r=require("@vytches/ddd-domain-primitives"),e=require("@vytches/ddd-utils");class u{constructor(t){t!==null&&typeof t=="object"?this.value=Object.freeze(t):this.value=t}equals(t){return t?this.value===t.value?!0:typeof this.value=="object"&&this.value!==null?JSON.stringify(this.value)===JSON.stringify(t.value):!1:!1}toString(){return String(this.value)}toJSON(){return this.value}getValue(){return this.value}}const d=new Set;function o(n,t){d.has(n)||(d.add(n),console.warn(`[@vytches/ddd-value-objects] EntityIdFactory.${n}() is deprecated and will be removed in v1.0.0. Use ${t} instead. See https://github.com/vytches/ddd/blob/main/CHANGELOG.md for migration details.`))}class i extends l.EntityId{constructor(t,a){super(t,a)}validate(t){switch(this.getType()){case"uuid":return e.LibUtils.isValidUUID(t);case"integer":return e.LibUtils.isValidInteger(t);case"bigint":return e.LibUtils.isValidBigInt(t);case"text":return e.LibUtils.isValidTextId(t);default:throw new r.InvalidParameterError(`Unsupported IdType: ${this.getType()}`)}}static create(){return new i(e.LibUtils.getUUID(),"uuid")}static createWithRandomUUID(){return i.create()}static fromUUID(t){if(!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidUUID(t))throw r.InvalidParameterError.withParameter("entity identifier");return new i(t,"uuid")}static fromInteger(t){if(!e.LibUtils.isValidInteger(t))throw r.InvalidParameterError.withParameter("entity identifier must be a non-negative integer");return new i(t.toString(),"integer")}static fromBigInt(t){const a=e.LibUtils.normalizeIdToString(t);if(!e.LibUtils.isValidBigInt(a))throw r.InvalidParameterError.withParameter("entity identifier must be a valid bigint");return new i(a,"bigint")}static fromText(t){if(!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidTextId(t))throw r.InvalidParameterError.withParameter("entity identifier contains invalid characters");return new i(t,"text")}static tryFromUUID(t){return e.LibUtils.hasValue(t)?e.LibUtils.isValidUUID(t)?e.Result.ok(new i(t,"uuid")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier")):e.Result.fail(r.MissingValueError.withValue("entity identifier"))}static tryFromInteger(t){return e.LibUtils.isValidInteger(t)?e.Result.ok(new i(t.toString(),"integer")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier must be a non-negative integer"))}static tryFromBigInt(t){const a=e.LibUtils.normalizeIdToString(t);return e.LibUtils.isValidBigInt(a)?e.Result.ok(new i(a,"bigint")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier must be a valid bigint"))}static tryFromText(t){return e.LibUtils.hasValue(t)?e.LibUtils.isValidTextId(t)?e.Result.ok(new i(t,"text")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier contains invalid characters")):e.Result.fail(r.MissingValueError.withValue("entity identifier"))}}class s{static createWithRandomUUID(){return o("createWithRandomUUID","EntityId.create()"),i.create()}static fromUUID(t){if(o("fromUUID","EntityId.fromUUID()"),!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidUUID(t))throw r.InvalidParameterError.withParameter("entity identifier");return new i(t,"uuid")}static fromInteger(t){if(o("fromInteger","EntityId.fromInteger()"),!e.LibUtils.isValidInteger(t))throw r.InvalidParameterError.withParameter("entity identifier must be a non-negative integer");return new i(t.toString(),"integer")}static fromBigInt(t){o("fromBigInt","EntityId.fromBigInt()");const a=e.LibUtils.normalizeIdToString(t);if(!e.LibUtils.isValidBigInt(a))throw r.InvalidParameterError.withParameter("entity identifier must be a valid bigint");return new i(a,"bigint")}static fromText(t){if(o("fromText","EntityId.fromText()"),!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidTextId(t))throw r.InvalidParameterError.withParameter("entity identifier contains invalid characters");return new i(t,"text")}createWithRandomUUID(){return i.create()}fromUUID(t){return s.fromUUID(t)}fromInteger(t){return s.fromInteger(t)}fromBigInt(t){return s.fromBigInt(t)}fromText(t){return s.fromText(t)}}function f(n){return n}function m(){return i.create()}function c(n){return i.fromUUID(n)}function I(n){return i.fromText(n)}exports.BaseValueObject=u;exports.EntityId=i;exports.EntityIdFactory=s;exports.brandedIdFromText=I;exports.brandedIdFromUUID=c;exports.createBrandedId=f;exports.newBrandedId=m;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e=require("@vytches/ddd-utils"),s=require("@vytches/ddd-contracts"),r=require("@vytches/ddd-domain-primitives");class l{constructor(t){if(this.value=t!==null&&typeof t=="object"?e.LibUtils.deepFreeze(t):t,!this.validate(this.value))throw new Error(this.getInvalidValueMessage(this.value))}equals(t){return t?this.value===t.value?!0:typeof this.value=="object"&&this.value!==null?e.LibUtils.deepEqual(this.value,t.value):!1:!1}toString(){return String(this.value)}toJSON(){return this.value}getValue(){return this.value}getInvalidValueMessage(t){return`Invalid value for ${this.constructor.name}`}}class i extends s.EntityId{constructor(t,n){super(t,n)}validate(t){switch(this.getType()){case"uuid":return e.LibUtils.isValidUUID(t);case"integer":return e.LibUtils.isValidInteger(t);case"bigint":return e.LibUtils.isValidBigInt(t);case"text":return e.LibUtils.isValidTextId(t);default:throw new r.InvalidParameterError(`Unsupported IdType: ${this.getType()}`)}}static create(){return new i(e.LibUtils.getUUID(),"uuid")}static createWithRandomUUID(){return i.create()}static fromUUID(t){if(!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidUUID(t))throw r.InvalidParameterError.withParameter("entity identifier");return new i(t,"uuid")}static fromInteger(t){if(!e.LibUtils.isValidInteger(t))throw r.InvalidParameterError.withParameter("entity identifier must be a non-negative integer");return new i(t.toString(),"integer")}static fromBigInt(t){const n=e.LibUtils.normalizeIdToString(t);if(!e.LibUtils.isValidBigInt(n))throw r.InvalidParameterError.withParameter("entity identifier must be a valid bigint");return new i(n,"bigint")}static fromText(t){if(!e.LibUtils.hasValue(t))throw r.MissingValueError.withValue("entity identifier");if(!e.LibUtils.isValidTextId(t))throw r.InvalidParameterError.withParameter("entity identifier contains invalid characters");return new i(t,"text")}static tryFromUUID(t){return e.LibUtils.hasValue(t)?e.LibUtils.isValidUUID(t)?e.Result.ok(new i(t,"uuid")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier")):e.Result.fail(r.MissingValueError.withValue("entity identifier"))}static tryFromInteger(t){return e.LibUtils.isValidInteger(t)?e.Result.ok(new i(t.toString(),"integer")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier must be a non-negative integer"))}static tryFromBigInt(t){const n=e.LibUtils.normalizeIdToString(t);return e.LibUtils.isValidBigInt(n)?e.Result.ok(new i(n,"bigint")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier must be a valid bigint"))}static tryFromText(t){return e.LibUtils.hasValue(t)?e.LibUtils.isValidTextId(t)?e.Result.ok(new i(t,"text")):e.Result.fail(r.InvalidParameterError.withParameter("entity identifier contains invalid characters")):e.Result.fail(r.MissingValueError.withValue("entity identifier"))}}function u(a){return a}function d(){return i.create()}function o(a){return i.fromUUID(a)}function f(a){return i.fromText(a)}exports.BaseValueObject=l;exports.EntityId=i;exports.brandedIdFromText=f;exports.brandedIdFromUUID=o;exports.createBrandedId=u;exports.newBrandedId=d;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { BaseValueObject, type ValueObjectValidator } from './base-value-object';
-export { EntityId, EntityIdFactory } from './id.value-object';
+export { EntityId } from './id.value-object';
 export type { BrandedId } from './branded-id';
 export { createBrandedId, newBrandedId, brandedIdFromUUID, brandedIdFromText } from './branded-id';
 export type { IEntityId, IEntityIdFactory, IdType } from '@vytches/ddd-contracts';

package/dist/index.js

@@ -1,18 +1,50 @@
-import { EntityId as m } from "@vytches/ddd-contracts";
-import { InvalidParameterError as r, MissingValueError as o } from "@vytches/ddd-domain-primitives";
-import { LibUtils as e, Result as s } from "@vytches/ddd-utils";
-class l {
+import { LibUtils as e, Result as r } from "@vytches/ddd-utils";
+import { EntityId as o } from "@vytches/ddd-contracts";
+import { InvalidParameterError as n, MissingValueError as u } from "@vytches/ddd-domain-primitives";
+class h {
+  /**
+   * VF-023 (D-1, AC1, BREAKING): validates `value` via the polymorphic
+   * `validate()` hook and throws synchronously on failure. This replaces
+   * the previous convention where every subclass repeated
+   * `if (!this.validate(value)) throw ...` in its own constructor after
+   * `super(value)` — that boilerplate is now centralized here and enforced
+   * for ALL subclasses, including any that previously forgot it.
+   *
+   * MIGRATION NOTE (undefined-during-super() trap): `validate()` is called
+   * via prototype dispatch from *this* base constructor, i.e. before the
+   * subclass constructor body (and therefore any subclass field
+   * initializers declared after `super(value)`) has run. A `validate()`
+   * override that reads `this.someOtherField` set up elsewhere in the
+   * subclass constructor will see `undefined` for that field. Overrides
+   * must only depend on the `value` parameter passed in, not on
+   * subclass instance state. Existing subclasses that already call
+   * `this.validate(value)` redundantly after `super(value)` are
+   * unaffected — the base class throws first, before that redundant call
+   * is ever reached.
+   */
   constructor(t) {
-    t !== null && typeof t == "object" ? this.value = Object.freeze(t) : this.value = t;
+    if (this.value = t !== null && typeof t == "object" ? e.deepFreeze(t) : t, !this.validate(this.value))
+      throw new Error(this.getInvalidValueMessage(this.value));
   }
   /**
    * Compares this value object with another for equality.
    * Uses deep structural comparison for object values, === for primitives.
+   *
+   * VF-023 (D-3, AC2/AC3, BREAKING): deep comparison now uses
+   * `LibUtils.deepEqual` instead of `JSON.stringify` equality. This fixes
+   * false negatives/positives inherent to JSON-based comparison — key
+   * order sensitivity is gone (already true before, since JSON.stringify
+   * of plain objects is insertion-order, not truly key-order-independent
+   * in all engines), values like `undefined`, `Date`, `Map`, `Set`, and
+   * `NaN` inside nested structures now compare by actual value semantics
+   * instead of silently dropping (`undefined`) or losing type
+   * (`Date`/`Map`/`Set` stringify to structurally different, sometimes
+   * colliding, JSON shapes).
    * @param valueObject - The value object to compare with
    * @returns True if they are equal, false otherwise
    */
   equals(t) {
-    return t ? this.value === t.value ? !0 : typeof this.value == "object" && this.value !== null ? JSON.stringify(this.value) === JSON.stringify(t.value) : !1 : !1;
+    return t ? this.value === t.value ? !0 : typeof this.value == "object" && this.value !== null ? e.deepEqual(this.value, t.value) : !1 : !1;
   }
   /**
    * Returns a string representation of the value object
@@ -35,14 +67,25 @@ class l {
   getValue() {
     return this.value;
   }
+  /**
+   * VF-023 (D-1 regression fix): produces the message used when the
+   * constructor's synchronous `validate()` call fails. Because the base
+   * constructor now throws BEFORE the subclass constructor body runs (see
+   * the class-level doc comment), a subclass can no longer rely on its own
+   * post-`super(value)` `throw new Error('...')` — that code is
+   * unreachable, since the base class has already thrown by the time
+   * control would return to the subclass. Override this hook instead to
+   * provide a validation-error message specific to the subclass. Only
+   * `value` (the parameter, not subclass instance state — see the
+   * undefined-during-super() trap note above) is safe to use here.
+   * @param value The value that failed validation
+   * @returns The message to use for the thrown `Error`
+   */
+  getInvalidValueMessage(t) {
+    return `Invalid value for ${this.constructor.name}`;
+  }
 }
-const u = /* @__PURE__ */ new Set();
-function f(n, t) {
-  u.has(n) || (u.add(n), console.warn(
-    `[@vytches/ddd-value-objects] EntityIdFactory.${n}() is deprecated and will be removed in v1.0.0. Use ${t} instead. See https://github.com/vytches/ddd/blob/main/CHANGELOG.md for migration details.`
-  ));
-}
-class i extends m {
+class i extends o {
   constructor(t, a) {
     super(t, a);
   }
@@ -57,7 +100,7 @@ class i extends m {
       case "text":
         return e.isValidTextId(t);
       default:
-        throw new r(`Unsupported IdType: ${this.getType()}`);
+        throw new n(`Unsupported IdType: ${this.getType()}`);
     }
   }
   /**
@@ -85,27 +128,27 @@ class i extends m {
    */
   static fromUUID(t) {
     if (!e.hasValue(t))
-      throw o.withValue("entity identifier");
+      throw u.withValue("entity identifier");
     if (!e.isValidUUID(t))
-      throw r.withParameter("entity identifier");
+      throw n.withParameter("entity identifier");
     return new i(t, "uuid");
   }
   static fromInteger(t) {
     if (!e.isValidInteger(t))
-      throw r.withParameter("entity identifier must be a non-negative integer");
+      throw n.withParameter("entity identifier must be a non-negative integer");
     return new i(t.toString(), "integer");
   }
   static fromBigInt(t) {
     const a = e.normalizeIdToString(t);
     if (!e.isValidBigInt(a))
-      throw r.withParameter("entity identifier must be a valid bigint");
+      throw n.withParameter("entity identifier must be a valid bigint");
     return new i(a, "bigint");
   }
   static fromText(t) {
     if (!e.hasValue(t))
-      throw o.withValue("entity identifier");
+      throw u.withValue("entity identifier");
     if (!e.isValidTextId(t))
-      throw r.withParameter("entity identifier contains invalid characters");
+      throw n.withParameter("entity identifier contains invalid characters");
     return new i(t, "text");
   }
   // --- Result-returning factory methods (non-throwing) ---
@@ -116,7 +159,7 @@ class i extends m {
    * @since 0.24.0
    */
   static tryFromUUID(t) {
-    return e.hasValue(t) ? e.isValidUUID(t) ? s.ok(new i(t, "uuid")) : s.fail(r.withParameter("entity identifier")) : s.fail(o.withValue("entity identifier"));
+    return e.hasValue(t) ? e.isValidUUID(t) ? r.ok(new i(t, "uuid")) : r.fail(n.withParameter("entity identifier")) : r.fail(u.withValue("entity identifier"));
   }
   /**
    * Create EntityId from integer, returning Result instead of throwing.
@@ -125,8 +168,8 @@ class i extends m {
    * @since 0.24.0
    */
   static tryFromInteger(t) {
-    return e.isValidInteger(t) ? s.ok(new i(t.toString(), "integer")) : s.fail(
-      r.withParameter("entity identifier must be a non-negative integer")
+    return e.isValidInteger(t) ? r.ok(new i(t.toString(), "integer")) : r.fail(
+      n.withParameter("entity identifier must be a non-negative integer")
     );
   }
   /**
@@ -137,8 +180,8 @@ class i extends m {
    */
   static tryFromBigInt(t) {
     const a = e.normalizeIdToString(t);
-    return e.isValidBigInt(a) ? s.ok(new i(a, "bigint")) : s.fail(
-      r.withParameter("entity identifier must be a valid bigint")
+    return e.isValidBigInt(a) ? r.ok(new i(a, "bigint")) : r.fail(
+      n.withParameter("entity identifier must be a valid bigint")
     );
   }
   /**
@@ -148,101 +191,28 @@ class i extends m {
    * @since 0.24.0
    */
   static tryFromText(t) {
-    return e.hasValue(t) ? e.isValidTextId(t) ? s.ok(new i(t, "text")) : s.fail(
-      r.withParameter("entity identifier contains invalid characters")
-    ) : s.fail(o.withValue("entity identifier"));
-  }
-}
-class d {
-  /**
-   * @deprecated Use EntityId.create() instead. Will be removed in v1.0.0.
-   */
-  static createWithRandomUUID() {
-    return f("createWithRandomUUID", "EntityId.create()"), i.create();
-  }
-  /**
-   * @deprecated Use EntityId.fromUUID() instead. Will be removed in v1.0.0.
-   * @throws {MissingValueError} if value is empty
-   * @throws {InvalidParameterError} if value is empty
-   */
-  static fromUUID(t) {
-    if (f("fromUUID", "EntityId.fromUUID()"), !e.hasValue(t))
-      throw o.withValue("entity identifier");
-    if (!e.isValidUUID(t))
-      throw r.withParameter("entity identifier");
-    return new i(t, "uuid");
-  }
-  /**
-   * @deprecated Use EntityId.fromInteger() instead. Will be removed in v1.0.0.
-   * @throws {InvalidParameterError} if value is empty
-   */
-  static fromInteger(t) {
-    if (f("fromInteger", "EntityId.fromInteger()"), !e.isValidInteger(t))
-      throw r.withParameter("entity identifier must be a non-negative integer");
-    return new i(t.toString(), "integer");
-  }
-  /**
-   * @deprecated Use EntityId.fromBigInt() instead. Will be removed in v1.0.0.
-   * @throws {InvalidParameterError} if value is empty
-   */
-  static fromBigInt(t) {
-    f("fromBigInt", "EntityId.fromBigInt()");
-    const a = e.normalizeIdToString(t);
-    if (!e.isValidBigInt(a))
-      throw r.withParameter("entity identifier must be a valid bigint");
-    return new i(a, "bigint");
-  }
-  /**
-   * @deprecated Use EntityId.fromText() instead. Will be removed in v1.0.0.
-   * @throws {MissingValueError} if value is empty
-   * @throws {InvalidParameterError} if value is empty
-   */
-  static fromText(t) {
-    if (f("fromText", "EntityId.fromText()"), !e.hasValue(t))
-      throw o.withValue("entity identifier");
-    if (!e.isValidTextId(t))
-      throw r.withParameter("entity identifier contains invalid characters");
-    return new i(t, "text");
-  }
-  /** @deprecated Use EntityId.create() instead */
-  createWithRandomUUID() {
-    return i.create();
-  }
-  /** @deprecated Use EntityId.fromUUID() instead */
-  fromUUID(t) {
-    return d.fromUUID(t);
-  }
-  /** @deprecated Use EntityId.fromInteger() instead */
-  fromInteger(t) {
-    return d.fromInteger(t);
-  }
-  /** @deprecated Use EntityId.fromBigInt() instead */
-  fromBigInt(t) {
-    return d.fromBigInt(t);
-  }
-  /** @deprecated Use EntityId.fromText() instead */
-  fromText(t) {
-    return d.fromText(t);
+    return e.hasValue(t) ? e.isValidTextId(t) ? r.ok(new i(t, "text")) : r.fail(
+      n.withParameter("entity identifier contains invalid characters")
+    ) : r.fail(u.withValue("entity identifier"));
   }
 }
-function w(n) {
-  return n;
+function c(s) {
+  return s;
 }
-function I() {
+function g() {
   return i.create();
 }
-function U(n) {
-  return i.fromUUID(n);
+function m(s) {
+  return i.fromUUID(s);
 }
-function V(n) {
-  return i.fromText(n);
+function w(s) {
+  return i.fromText(s);
 }
 export {
-  l as BaseValueObject,
+  h as BaseValueObject,
   i as EntityId,
-  d as EntityIdFactory,
-  V as brandedIdFromText,
-  U as brandedIdFromUUID,
-  w as createBrandedId,
-  I as newBrandedId
+  w as brandedIdFromText,
+  m as brandedIdFromUUID,
+  c as createBrandedId,
+  g as newBrandedId
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vytches/ddd-value-objects",
-  "version": "0.29.3",
+  "version": "0.31.0-alpha.0",
   "description": "Enhanced value objects and EntityId implementations",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -17,7 +17,8 @@
   "files": [
     "dist",
     "README.md",
-    "LLMGUIDE.md"
+    "LLMGUIDE.md",
+    "LICENSE"
   ],
   "keywords": [
     "ddd",
@@ -33,15 +34,15 @@
     "directory": "packages/value-objects"
   },
   "dependencies": {
-    "@vytches/ddd-contracts": "0.29.3",
-    "@vytches/ddd-domain-primitives": "0.29.3",
-    "@vytches/ddd-utils": "0.29.3"
+    "@vytches/ddd-contracts": "0.31.0-alpha.0",
+    "@vytches/ddd-utils": "0.31.0-alpha.0",
+    "@vytches/ddd-domain-primitives": "0.31.0-alpha.0"
   },
   "devDependencies": {
     "typescript": "^5.0.0",
     "vite": "^7.3.2",
     "vite-plugin-dts": "^4.0.0",
-    "vitest": "^4.0.0"
+    "vitest": "^4.1.0"
   },
   "nx": {
     "tags": [