@need-code/nc-ddd 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 NeedCode
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,201 @@
+# nc-ddd
+
+A set of base classes for implementing Domain-Driven Design patterns in TypeScript.
+
+This library provides base classes for Value Objects, Entities, and Aggregate Roots, helping you to structure your domain logic in a clean and maintainable way. It uses `valibot` for validation and `@sweet-monads/either` for handling success and failure cases in a functional way.
+
+## Installation
+
+Install the package and its peer dependencies using your favorite package manager:
+
+```bash
+npm install nc-ddd @sweet-monads/either valibot
+```
+
+## Core Concepts
+
+### Value Object (VO)
+
+A Value Object is an object that represents a descriptive aspect of the domain with no conceptual identity. VOs are immutable and are compared by their values.
+
+The `VO` base class provides:
+- A private constructor to enforce creation through a factory method.
+- An `isEqual` method for structural comparison.
+- A `value` getter to access the primitive value.
+
+**Example: `CompanyNameVO`**
+
+```typescript
+// example/value-objects/company/company-name.vo.ts
+import * as v from "valibot";
+import { VO } from "@/core/vo";
+import { voFactory } from "@/helpers/vo-factory";
+
+export const CompanyNameVOSchema = v.pipe(
+  v.string("Name must be a string"),
+  v.trim(),
+  v.nonEmpty("Name can`t be empty"),
+);
+
+export type CompanyNameVOProps = v.InferOutput<typeof CompanyNameVOSchema>;
+
+export class CompanyNameVO extends VO<typeof CompanyNameVOSchema> {
+  private constructor(props: CompanyNameVOProps) {
+    super(props);
+  }
+  public static create = (val: v.InferInput<typeof CompanyNameVOSchema>) => {
+    return voFactory(val, CompanyNameVOSchema, (props) => new CompanyNameVO(props));
+  };
+}
+```
+
+### Entity
+
+An Entity is an object with a unique identity that persists over time. Entities are mutable and are compared by their identity.
+
+The `Entity` base class provides:
+- A protected constructor to enforce creation through factory methods.
+- An `id` getter for easy access to the entity's identifier.
+- An `isEqual` method that compares entities based on their ID.
+- A `primitive` getter to get the primitive values of the entity's props.
+
+**Example: `Employee` Entity**
+
+```typescript
+// example/entities/employee.entity.ts
+import { left, merge } from "@sweet-monads/either";
+import { flatten, safeParse } from "valibot";
+import { Entity } from "@/core/entity";
+import { CreateEmployeeDTOSchema } from "../dtos/create-employee.dto";
+import { EmployeeContactVO } from "../value-objects/employee/employee-contact.vo";
+import { EmployeeInfoVO } from "../value-objects/employee/employee-info.vo";
+import { EmployeeNameVO } from "../value-objects/employee/employee-name.vo";
+import { EmployeeRoleVO } from "../value-objects/employee/employee-role.vo";
+import { IdVO } from "../value-objects/id.vo";
+
+export interface EmployeeProps {
+  id: IdVO;
+  name: EmployeeNameVO;
+  role: EmployeeRoleVO;
+  info: EmployeeInfoVO;
+  contacts: EmployeeContactVO[];
+}
+
+export class Employee extends Entity<EmployeeProps> {
+  private constructor(props: EmployeeProps) {
+    super(props);
+  }
+
+  public static create(rawDTO: unknown) {
+    const dtoResult = safeParse(CreateEmployeeDTOSchema, rawDTO);
+
+    if (!dtoResult.success) {
+      return left(flatten(dtoResult.issues).nested);
+    }
+
+    const props = dtoResult.output;
+
+    const id = IdVO.create(props.id);
+    const name = EmployeeNameVO.create(props.name);
+    const role = EmployeeRoleVO.create(props.role);
+    const info = EmployeeInfoVO.create(props.info);
+    const contacts = merge(props.contacts.map((c) => EmployeeContactVO.create(c)));
+
+    return merge([id, name, role, info, contacts]).map(([id, name, role, info, contacts]) => {
+      return new Employee({ id, name, role, info, contacts });
+    });
+  }
+}
+```
+
+### Aggregate Root
+
+An Aggregate Root is a specific type of Entity that acts as a gateway to a cluster of associated objects.
+
+The `AgregateRoot` base class extends the `Entity` class and allows for more complex properties, including other Entities.
+
+**Example: `Company` Aggregate Root**
+```typescript
+// example/aggregates/company.aggregate.ts
+import { left, merge } from "@sweet-monads/either";
+import { flatten, safeParse } from "valibot";
+
+import { AgregateRoot } from "@/core/agregate-root";
+import { CreateCompanyDTOSchema } from "../dtos/create-company.dto";
+import { Employee } from "../entities/employee.entity";
+import { CompanyNameVO } from "../value-objects/company/company-name.vo";
+import { IdVO } from "../value-objects/id.vo";
+
+export interface CompanyProps {
+  id: IdVO;
+  companyName: CompanyNameVO;
+  employees: Employee[];
+}
+
+export class Company extends AgregateRoot<CompanyProps> {
+  private constructor(props: CompanyProps) {
+    super(props);
+  }
+
+  public static create(rawDTO: unknown) {
+    const dtoResult = safeParse(CreateCompanyDTOSchema, rawDTO);
+
+    if (!dtoResult.success) {
+      return left(flatten(dtoResult.issues).nested);
+    }
+
+    const props = dtoResult.output;
+
+    const id = IdVO.create(props.id);
+    const companyName = CompanyNameVO.create(props.companyName);
+    const employees = merge(props.employees.map((e) => Employee.create(e)));
+
+    return merge([id, companyName, employees]).map(([id, companyName, employees]) => {
+      return new Company({ id, companyName, employees });
+    });
+  }
+}
+```
+
+## Usage
+
+The `voFactory` helper and the static `create` methods on VOs, Entities, and Aggregate Roots return an `Either` monad from `@sweet-monads/either`. This allows you to handle successful creation and validation errors in a functional and type-safe way.
+
+```typescript
+import { Company } from "./example/aggregates/company.aggregate";
+
+const companyData = {
+  id: "d1a6b1b1-3b3b-4b3b-8b3b-1b1b1b1b1b1b",
+  companyName: "NeedCode",
+  employees: [
+    {
+      id: "a1a1a1a1-1a1a-1a1a-1a1a-1a1a1a1a1a1a",
+      name: "John Doe",
+      role: "admin",
+      info: "Lead developer",
+      contacts: [
+        { type: "email", value: "john.doe@example.com" },
+        { type: "phone", value: "71234567890" },
+      ],
+    },
+  ],
+};
+
+const companyResult = Company.create(companyData);
+
+companyResult.map((company) => {
+  console.log("Company created successfully:", company.primitive);
+});
+
+companyResult.mapLeft((errors) => {
+  console.error("Failed to create company:", errors);
+});
+```
+
+## Running Tests
+
+To run the tests, use the following command:
+
+```bash
+npm test
+```

package/dist/core/agregate-root.d.ts

@@ -0,0 +1,36 @@
+import type * as v from "valibot";
+import { Entity, type IEntityProps, type InferEntityProps } from "./entity";
+import { VO } from "./vo";
+type AllowedAgregateRootPropValue = VO<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>> | Array<VO<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>> | Entity<IEntityProps> | Array<Entity<IEntityProps>>;
+export type InferPropType<T> = T extends ReadonlyArray<infer U> ? InferPropType<U>[] : T extends VO<infer S> ? v.InferInput<S> : T extends Entity<infer P> ? InferEntityProps<P> : never;
+export type InferAgregateRootProps<T> = {
+    [K in keyof T]: InferPropType<T[K]>;
+};
+/**
+ * @class AgregateRoot
+ * @description Base class for aggregate roots in DDD. An aggregate root is a specific type of entity that acts as a gateway to a cluster of associated objects.
+ * @template Props - The properties of the aggregate root. Must include an 'id' property which is a Value Object.
+ */
+export declare abstract class AgregateRoot<Props extends IEntityProps & Record<keyof Props, AllowedAgregateRootPropValue>> {
+    readonly props: Props;
+    /**
+     * The constructor is protected to enforce creation through factory methods in subclasses.
+     * @param props The properties of the aggregate root.
+     */
+    protected constructor(props: Props);
+    /**
+     * Getter for the aggregate root's identifier (ID).
+     * @returns {Props["id"]} The unique identifier of the aggregate root.
+     */
+    get id(): Props["id"];
+    get primitive(): InferAgregateRootProps<Props>;
+    /**
+     * Compares this aggregate root with another for equality.
+     * Aggregate roots are considered equal if they have the same identifier.
+     * @param other The other aggregate root to compare with.
+     * @returns {boolean} `true` if they are equal, `false` otherwise.
+     */
+    isEqual(other?: AgregateRoot<Props>): boolean;
+}
+export {};
+//# sourceMappingURL=agregate-root.d.ts.map

package/dist/core/agregate-root.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agregate-root.d.ts","sourceRoot":"","sources":["../../src/core/agregate-root.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,KAAK,YAAY,EAAE,KAAK,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,KAAK,4BAA4B,GAC7B,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GACxD,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,GAC/D,MAAM,CAAC,YAAY,CAAC,GACpB,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC;AAEhC,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAC3D,aAAa,CAAC,CAAC,CAAC,EAAE,GAClB,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,GACnB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GACf,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GACvB,gBAAgB,CAAC,CAAC,CAAC,GACnB,KAAK,CAAC;AAEd,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI;KACrC,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,8BAAsB,YAAY,CAChC,KAAK,SAAS,YAAY,GAAG,MAAM,CAAC,MAAM,KAAK,EAAE,4BAA4B,CAAC;IAE9E,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B;;;OAGG;IACH,SAAS,aAAa,KAAK,EAAE,KAAK;IAIlC;;;OAGG;IACH,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,CAEpB;IAED,IAAI,SAAS,IAAI,sBAAsB,CAAC,KAAK,CAAC,CAmB7C;IAED;;;;;OAKG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC,KAAK,CAAC,GAAG,OAAO;CAerD"}

package/dist/core/agregate-root.js

@@ -0,0 +1,60 @@
+import { Entity } from "./entity";
+import { VO } from "./vo";
+/**
+ * @class AgregateRoot
+ * @description Base class for aggregate roots in DDD. An aggregate root is a specific type of entity that acts as a gateway to a cluster of associated objects.
+ * @template Props - The properties of the aggregate root. Must include an 'id' property which is a Value Object.
+ */
+export class AgregateRoot {
+    props;
+    /**
+     * The constructor is protected to enforce creation through factory methods in subclasses.
+     * @param props The properties of the aggregate root.
+     */
+    constructor(props) {
+        this.props = props;
+    }
+    /**
+     * Getter for the aggregate root's identifier (ID).
+     * @returns {Props["id"]} The unique identifier of the aggregate root.
+     */
+    get id() {
+        return this.props.id;
+    }
+    get primitive() {
+        const toPrim = (p) => {
+            if (p instanceof Entity) {
+                return p.primitive;
+            }
+            if (p instanceof VO) {
+                return p.value;
+            }
+            return p;
+        };
+        return Object.fromEntries(Object.entries(this.props).map(([key, prop]) => {
+            if (Array.isArray(prop)) {
+                return [key, prop.map(toPrim)];
+            }
+            return [key, toPrim(prop)];
+        }));
+    }
+    /**
+     * Compares this aggregate root with another for equality.
+     * Aggregate roots are considered equal if they have the same identifier.
+     * @param other The other aggregate root to compare with.
+     * @returns {boolean} `true` if they are equal, `false` otherwise.
+     */
+    isEqual(other) {
+        if (other === null || other === undefined) {
+            return false;
+        }
+        if (this === other) {
+            return true;
+        }
+        if (!(other instanceof AgregateRoot)) {
+            return false;
+        }
+        return this.id.isEqual(other.id);
+    }
+}
+//# sourceMappingURL=agregate-root.js.map

package/dist/core/agregate-root.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agregate-root.js","sourceRoot":"","sources":["../../src/core/agregate-root.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAA4C,MAAM,UAAU,CAAC;AAC5E,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAoB1B;;;;GAIG;AACH,MAAM,OAAgB,YAAY;IAGhB,KAAK,CAAQ;IAE7B;;;OAGG;IACH,YAAsB,KAAY;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAiB,CAAC;IACtC,CAAC;IAED,IAAI,SAAS;QACX,MAAM,MAAM,GAAG,CAAC,CAAU,EAAE,EAAE;YAC5B,IAAI,CAAC,YAAY,MAAM,EAAE,CAAC;gBACxB,OAAO,CAAC,CAAC,SAAS,CAAC;YACrB,CAAC;YACD,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC;gBACpB,OAAO,CAAC,CAAC,KAAK,CAAC;YACjB,CAAC;YACD,OAAO,CAAC,CAAC;QACX,CAAC,CAAC;QAEF,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,EAAE;YAC7C,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;YACjC,CAAC;YACD,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;QAC7B,CAAC,CAAC,CAC8B,CAAC;IACrC,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,KAA2B;QACxC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC,EAAE,CAAC;YACrC,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/core/entity.d.ts

@@ -0,0 +1,38 @@
+import type * as v from "valibot";
+import type { VO } from "./vo";
+type AllowedEntityPropValue = VO<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>> | Array<VO<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>>;
+export type IEntityProps = {
+    id: VO<v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>;
+};
+export type InferValibot<T> = T extends ReadonlyArray<infer U> ? InferValibot<U>[] : T extends VO<infer S> ? v.InferInput<S> : never;
+export type InferEntityProps<T> = {
+    [K in keyof T]: InferValibot<T[K]>;
+};
+/**
+ * @class Entity
+ * @description Base class for entities in DDD. An entity is an object with a unique identity that persists over time.
+ * @template Props - The properties of the entity. Must include an 'id' property which is a Value Object.
+ */
+export declare abstract class Entity<Props extends IEntityProps & Record<keyof Props, AllowedEntityPropValue>> {
+    readonly props: Props;
+    /**
+     * The constructor is protected to enforce creation through factory methods in subclasses.
+     * @param props The properties of the entity.
+     */
+    protected constructor(props: Props);
+    /**
+     * Getter for the entity's identifier (ID).
+     * @returns {Props["id"]} The unique identifier of the entity.
+     */
+    get id(): Props["id"];
+    get primitive(): InferEntityProps<Props>;
+    /**
+     * Compares this entity with another for equality.
+     * Entities are considered equal if they have the same identifier.
+     * @param other The other entity to compare with.
+     * @returns {boolean} `true` if the entities are equal, `false` otherwise.
+     */
+    isEqual(other?: Entity<Props>): boolean;
+}
+export {};
+//# sourceMappingURL=entity.d.ts.map

package/dist/core/entity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.d.ts","sourceRoot":"","sources":["../../src/core/entity.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAC;AAClC,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE/B,KAAK,sBAAsB,GACvB,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,GACxD,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpE,MAAM,MAAM,YAAY,GAAG;IACzB,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;CAC9D,CAAC;AAEF,MAAM,MAAM,YAAY,CAAC,CAAC,IACxB,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAC5B,YAAY,CAAC,CAAC,CAAC,EAAE,GACjB,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC,CAAC,GACnB,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,GACf,KAAK,CAAC;AAEd,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI;KAC/B,CAAC,IAAI,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,8BAAsB,MAAM,CAC1B,KAAK,SAAS,YAAY,GAAG,MAAM,CAAC,MAAM,KAAK,EAAE,sBAAsB,CAAC;IAExE,SAAgB,KAAK,EAAE,KAAK,CAAC;IAE7B;;;OAGG;IACH,SAAS,aAAa,KAAK,EAAE,KAAK;IAIlC;;;OAGG;IACH,IAAI,EAAE,IAAI,KAAK,CAAC,IAAI,CAAC,CAEpB;IAED,IAAI,SAAS,IAAI,gBAAgB,CAAC,KAAK,CAAC,CASvC;IAED;;;;;OAKG;IACI,OAAO,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO;CAe/C"}

package/dist/core/entity.js

@@ -0,0 +1,49 @@
+/**
+ * @class Entity
+ * @description Base class for entities in DDD. An entity is an object with a unique identity that persists over time.
+ * @template Props - The properties of the entity. Must include an 'id' property which is a Value Object.
+ */
+export class Entity {
+    props;
+    /**
+     * The constructor is protected to enforce creation through factory methods in subclasses.
+     * @param props The properties of the entity.
+     */
+    constructor(props) {
+        this.props = props;
+    }
+    /**
+     * Getter for the entity's identifier (ID).
+     * @returns {Props["id"]} The unique identifier of the entity.
+     */
+    get id() {
+        return this.props.id;
+    }
+    get primitive() {
+        return Object.fromEntries(Object.entries(this.props).map(([k, v]) => {
+            if (Array.isArray(v)) {
+                return [k, v.map((i) => i.value)];
+            }
+            return [k, v.value];
+        }));
+    }
+    /**
+     * Compares this entity with another for equality.
+     * Entities are considered equal if they have the same identifier.
+     * @param other The other entity to compare with.
+     * @returns {boolean} `true` if the entities are equal, `false` otherwise.
+     */
+    isEqual(other) {
+        if (other === null || other === undefined) {
+            return false;
+        }
+        if (this === other) {
+            return true;
+        }
+        if (!(other instanceof Entity)) {
+            return false;
+        }
+        return this.id.isEqual(other.id);
+    }
+}
+//# sourceMappingURL=entity.js.map

package/dist/core/entity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.js","sourceRoot":"","sources":["../../src/core/entity.ts"],"names":[],"mappings":"AAsBA;;;;GAIG;AACH,MAAM,OAAgB,MAAM;IAGV,KAAK,CAAQ;IAE7B;;;OAGG;IACH,YAAsB,KAAY;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,IAAI,EAAE;QACJ,OAAO,IAAI,CAAC,KAAK,CAAC,EAAiB,CAAC;IACtC,CAAC;IAED,IAAI,SAAS;QACX,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE;YACxC,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBACrB,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC,CACwB,CAAC;IAC/B,CAAC;IAED;;;;;OAKG;IACI,OAAO,CAAC,KAAqB;QAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC1C,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,IAAI,KAAK,KAAK,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,IAAI,CAAC,CAAC,KAAK,YAAY,MAAM,CAAC,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC;QACf,CAAC;QAED,OAAO,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACnC,CAAC;CACF"}

package/dist/core/vo.d.ts

@@ -0,0 +1,8 @@
+import type * as v from "valibot";
+export declare abstract class VO<Schema extends v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>> {
+    private _value;
+    protected constructor(props: v.InferOutput<Schema>);
+    isEqual(other: VO<Schema>): boolean;
+    get value(): v.InferOutput<Schema>;
+}
+//# sourceMappingURL=vo.d.ts.map

package/dist/core/vo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo.d.ts","sourceRoot":"","sources":["../../src/core/vo.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,KAAK,CAAC,MAAM,SAAS,CAAC;AAElC,8BAAsB,EAAE,CAAC,MAAM,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IAC1F,OAAO,CAAC,MAAM,CAAwB;IAEtC,SAAS,aAAa,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC;IAIlD,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC;IASzB,IAAI,KAAK,0BAER;CACF"}

package/dist/core/vo.js

@@ -0,0 +1,20 @@
+import assert from "node:assert/strict";
+export class VO {
+    _value;
+    constructor(props) {
+        this._value = props;
+    }
+    isEqual(other) {
+        try {
+            assert.deepStrictEqual(other.value, this.value);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    get value() {
+        return this._value;
+    }
+}
+//# sourceMappingURL=vo.js.map

package/dist/core/vo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo.js","sourceRoot":"","sources":["../../src/core/vo.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AAGxC,MAAM,OAAgB,EAAE;IACd,MAAM,CAAwB;IAEtC,YAAsB,KAA4B;QAChD,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;IAED,OAAO,CAAC,KAAiB;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,eAAe,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAChD,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF"}

package/dist/helpers/vo-factory.d.ts

@@ -0,0 +1,4 @@
+import * as v from "valibot";
+import type { VO } from "@/core/vo";
+export declare function voFactory<S extends v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>>>(value: unknown, schema: S, constructorFn: (props: v.InferOutput<S>) => VO<S>): import("@sweet-monads/either").Either<[string, ...string[]] | (Readonly<Partial<Record<S extends v.BaseSchema<unknown, unknown, v.BaseIssue<unknown>> | v.BaseSchemaAsync<unknown, unknown, v.BaseIssue<unknown>> ? v.IssueDotPath<S> : string, [string, ...string[]]>>> extends infer T ? { [TKey in keyof T]: T[TKey]; } : never) | undefined, never> | import("@sweet-monads/either").Either<never, VO<S>>;
+//# sourceMappingURL=vo-factory.d.ts.map

package/dist/helpers/vo-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo-factory.d.ts","sourceRoot":"","sources":["../../src/helpers/vo-factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAC7B,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,WAAW,CAAC;AAEpC,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,EACtF,KAAK,EAAE,OAAO,EACd,MAAM,EAAE,CAAC,EACT,aAAa,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,iZAQlD"}

package/dist/helpers/vo-factory.js

@@ -0,0 +1,11 @@
+import { left, right } from "@sweet-monads/either";
+import * as v from "valibot";
+export function voFactory(value, schema, constructorFn) {
+    const parseResult = v.safeParse(schema, value);
+    if (!parseResult.success) {
+        const flattedErrors = v.flatten(parseResult.issues);
+        return left(flattedErrors.root || flattedErrors.nested || flattedErrors.other);
+    }
+    return right(constructorFn(parseResult.output));
+}
+//# sourceMappingURL=vo-factory.js.map

package/dist/helpers/vo-factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vo-factory.js","sourceRoot":"","sources":["../../src/helpers/vo-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,CAAC,MAAM,SAAS,CAAC;AAG7B,MAAM,UAAU,SAAS,CACvB,KAAc,EACd,MAAS,EACT,aAAiD;IAEjD,MAAM,WAAW,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IAC/C,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,aAAa,GAAG,CAAC,CAAC,OAAO,CAAgB,WAAW,CAAC,MAAM,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,IAAI,aAAa,CAAC,MAAM,IAAI,aAAa,CAAC,KAAK,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,KAAK,CAAC,aAAa,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC;AAClD,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./core/vo";
+export * from "./core/entity";
+export * from "./core/agregate-root";
+export * from "./helpers/vo-factory";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export * from "./core/vo";
+export * from "./core/entity";
+export * from "./core/agregate-root";
+export * from "./helpers/vo-factory";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@need-code/nc-ddd",
+  "version": "0.0.1",
+  "description": "A set of base classes for implementing Domain-Driven Design patterns.",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "test": "jest",
+    "check": "biome check",
+    "build": "rm -rf dist && tsc -p tsconfig.build.json",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/NeedCodeLab/nc-ddd.git"
+  },
+  "author": "Mikhail Kokorin",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/NeedCodeLab/nc-ddd/issues"
+  },
+  "homepage": "https://github.com/NeedCodeLab/nc-ddd#readme",
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.10",
+    "@types/jest": "^30.0.0",
+    "jest": "^30.2.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.9.3"
+  },
+  "peerDependencies": {
+    "@sweet-monads/either": ">=3.0.0",
+    "valibot": ">=1.0.0"
+  }
+}