@woltz/rich-domain 0.2.1

package/dist/types/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/types/utils.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+import { Id } from "./id";
+export type EntityId = string | number;
+export interface BaseProps {
+    id: Id;
+}
+export interface ChangeEvent<T> {
+    previous: T | undefined;
+    current: T;
+    path: string;
+}
+export interface ArrayChangeEvent<T> {
+    toCreate: T[];
+    toUpdate: T[];
+    toDelete: T[];
+    path: string;
+}
+export type PropertySubscriber<T> = (event: ChangeEvent<T>) => void;
+export type ArraySubscriber<T> = (event: ArrayChangeEvent<T>) => void;
+export interface PropertySubscription<T> {
+    onChange: PropertySubscriber<T>;
+}
+export interface ArraySubscription<T> {
+    onChange: ArraySubscriber<T>;
+}
+type UnwrapArray<T> = T extends Array<infer U> ? U : never;
+type IsArray<T> = T extends Array<any> ? true : false;
+type NonUndefined<T> = T extends undefined ? never : T;
+export type SubscriptionConfig<T extends BaseProps> = {
+    [K in keyof T]?: IsArray<NonUndefined<T[K]>> extends true ? ArraySubscription<UnwrapArray<NonUndefined<T[K]>>> : PropertySubscription<NonUndefined<T[K]>>;
+};
+export interface ValidationConfig {
+    onCreate?: boolean;
+    onUpdate?: boolean;
+    throwOnError?: boolean;
+}
+export declare const DEFAULT_VALIDATION_CONFIG: Required<ValidationConfig>;
+export interface StandardSchemaIssue {
+    message: string;
+    path?: ReadonlyArray<unknown>;
+}
+export interface StandardSchemaResult<T> {
+    value?: T;
+    issues?: ReadonlyArray<StandardSchemaIssue>;
+}
+export interface StandardSchemaProps<T> {
+    validate: (value: unknown) => StandardSchemaResult<T> | Promise<StandardSchemaResult<T>>;
+}
+export interface StandardSchema<T = unknown> {
+    "~standard": StandardSchemaProps<T>;
+}
+interface DomainValidation<T> {
+    schema: StandardSchema<T>;
+    config?: ValidationConfig;
+}
+export type EntityValidation<T> = DomainValidation<T>;
+export type VOValidation<T> = DomainValidation<T>;
+export interface VOHooks<T, E> {
+    onBeforeUpdate?: (entity: E, snapshot: T) => boolean;
+    onCreate?: (entity: E) => void;
+    rules?: (entity: E) => void;
+    defaultValues?: Partial<T>;
+}
+export interface EntityHooks<T extends BaseProps, E> {
+    onBeforeUpdate?: (entity: E, snapshot: T) => boolean;
+    onCreate?: (entity: E) => void;
+    rules?: (entity: E) => void;
+    defaultValues?: Partial<Omit<T, "id">>;
+}
+export interface HistoryEntry {
+    path: string;
+    previousValue: any;
+    currentValue: any;
+    timestamp: number;
+}
+export type DeepJsonResult<T> = {
+    [K in keyof T]: T[K] extends Id ? string : T[K] extends {
+        toJson(): infer U;
+    } ? U : T[K] extends Array<infer U> ? U extends {
+        toJson(): infer V;
+    } ? V[] : U extends Id ? string[] : U[] : T[K];
+};
+export interface EntityConstructor<T extends BaseProps, E> {
+    new (props: T): E;
+    validation?: DomainValidation<T>;
+    hooks?: EntityHooks<T, E>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,12 @@
+"use strict";
+// ============================================================================
+// Types & Interfaces for Validation
+// ============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_VALIDATION_CONFIG = void 0;
+exports.DEFAULT_VALIDATION_CONFIG = {
+    onCreate: true,
+    onUpdate: true,
+    throwOnError: true,
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":";AAAA,+EAA+E;AAC/E,oCAAoC;AACpC,+EAA+E;;;AAkElE,QAAA,yBAAyB,GAA+B;IACnE,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,YAAY,EAAE,IAAI;CACnB,CAAC"}

package/dist/validation-error.d.ts

@@ -0,0 +1,42 @@
+export interface ValidationIssue {
+    path: string[];
+    message: string;
+}
+export declare class ValidationError extends Error {
+    readonly issues: ValidationIssue[];
+    readonly __isValidationError = true;
+    constructor(issues: ValidationIssue[], message?: string);
+    /**
+     * Check if an error is a ValidationError (works across module boundaries)
+     */
+    static isValidationError(error: unknown): error is ValidationError;
+    /**
+     * Get all error messages as a simple array
+     */
+    getMessages(): string[];
+    /**
+     * Get errors for a specific field path
+     */
+    getErrorsForPath(path: string): ValidationIssue[];
+    /**
+     * Check if a specific path has errors
+     */
+    hasErrorsForPath(path: string): boolean;
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON(): {
+        name: string;
+        message: string;
+        issues: ValidationIssue[];
+    };
+}
+/**
+ * Helper to create a single validation issue
+ */
+export declare function createValidationIssue(path: string | string[], message: string): ValidationIssue;
+/**
+ * Helper to throw a validation error with a single issue
+ */
+export declare function throwValidationError(path: string | string[], message: string): never;
+//# sourceMappingURL=validation-error.d.ts.map

package/dist/validation-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.d.ts","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACxC,SAAgB,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1C,SAAgB,mBAAmB,QAAQ;gBAE/B,MAAM,EAAE,eAAe,EAAE,EAAE,OAAO,CAAC,EAAE,MAAM;IAavD;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,eAAe;IAalE;;OAEG;IACH,WAAW,IAAI,MAAM,EAAE;IAIvB;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,EAAE;IAIjD;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO;IAIvC;;OAEG;IACH,MAAM,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,eAAe,EAAE,CAAA;KAAE;CAOvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,eAAe,CAKjB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,KAAK,CAEP"}

package/dist/validation-error.js

@@ -0,0 +1,73 @@
+// ============================================================================
+// Validation Error - Domain Validation Errors
+// ============================================================================
+export class ValidationError extends Error {
+    constructor(issues, message) {
+        const errorMessage = message || `Validation failed: ${issues.map(i => i.message).join(', ')}`;
+        super(errorMessage);
+        this.__isValidationError = true; // Brand for identification
+        this.name = 'ValidationError';
+        this.issues = issues;
+        // Maintain proper stack trace
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ValidationError);
+        }
+    }
+    /**
+     * Check if an error is a ValidationError (works across module boundaries)
+     */
+    static isValidationError(error) {
+        if (error instanceof ValidationError) {
+            return true;
+        }
+        // Check by duck typing for cross-module compatibility
+        return (error instanceof Error &&
+            error.name === 'ValidationError' &&
+            'issues' in error &&
+            Array.isArray(error.issues));
+    }
+    /**
+     * Get all error messages as a simple array
+     */
+    getMessages() {
+        return this.issues.map(i => i.message);
+    }
+    /**
+     * Get errors for a specific field path
+     */
+    getErrorsForPath(path) {
+        return this.issues.filter(i => i.path.join('.') === path);
+    }
+    /**
+     * Check if a specific path has errors
+     */
+    hasErrorsForPath(path) {
+        return this.getErrorsForPath(path).length > 0;
+    }
+    /**
+     * Convert to a plain object for serialization
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            issues: this.issues,
+        };
+    }
+}
+/**
+ * Helper to create a single validation issue
+ */
+export function createValidationIssue(path, message) {
+    return {
+        path: Array.isArray(path) ? path : path.split('.'),
+        message,
+    };
+}
+/**
+ * Helper to throw a validation error with a single issue
+ */
+export function throwValidationError(path, message) {
+    throw new ValidationError([createValidationIssue(path, message)]);
+}
+//# sourceMappingURL=validation-error.js.map

package/dist/validation-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-error.js","sourceRoot":"","sources":["../src/validation-error.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAC/E,8CAA8C;AAC9C,+EAA+E;AAO/E,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAIxC,YAAY,MAAyB,EAAE,OAAgB;QACrD,MAAM,YAAY,GAChB,OAAO,IAAI,sBAAsB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,KAAK,CAAC,YAAY,CAAC,CAAC;QALN,wBAAmB,GAAG,IAAI,CAAC,CAAC,2BAA2B;QAMrE,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,8BAA8B;QAC9B,IAAI,KAAK,CAAC,iBAAiB,EAAE,CAAC;YAC5B,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,eAAe,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,KAAc;QACrC,IAAI,KAAK,YAAY,eAAe,EAAE,CAAC;YACrC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,sDAAsD;QACtD,OAAO,CACL,KAAK,YAAY,KAAK;YACtB,KAAK,CAAC,IAAI,KAAK,iBAAiB;YAChC,QAAQ,IAAI,KAAK;YACjB,KAAK,CAAC,OAAO,CAAE,KAAa,CAAC,MAAM,CAAC,CACrC,CAAC;IACJ,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;IAC5D,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,IAAY;QAC3B,OAAO,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;IAChD,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC;IACJ,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,IAAuB,EACvB,OAAe;IAEf,OAAO;QACL,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC;QAClD,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAuB,EACvB,OAAe;IAEf,MAAM,IAAI,eAAe,CAAC,CAAC,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;AACpE,CAAC"}

package/dist/value-object.d.ts

@@ -0,0 +1,47 @@
+import { ValidationError } from "./validation-error";
+import { IDomainEvent } from "./domain-event";
+import { VOHooks, EntityValidation } from "./types";
+export declare abstract class ValueObject<T> {
+    protected readonly props: T;
+    private validationConfig;
+    private domainHooks?;
+    private domainSchema?;
+    private domainEvents;
+    protected static validation?: EntityValidation<any>;
+    protected static hooks?: VOHooks<any, any>;
+    constructor(props: T);
+    private validateProps;
+    private extractPathKey;
+    /**
+     * Check if value object has validation errors (when throwOnError is false)
+     */
+    get hasValidationErrors(): boolean;
+    /**
+     * Get validation errors (when throwOnError is false)
+     */
+    get validationErrors(): ValidationError | undefined;
+    equals(other: ValueObject<T>): boolean;
+    /**
+     * Add a domain event to this value object
+     */
+    protected addDomainEvent(event: IDomainEvent): void;
+    /**
+     * Get all uncommitted domain events
+     */
+    getUncommittedEvents(): IDomainEvent[];
+    /**
+     * Clear all domain events (call after publishing)
+     */
+    clearEvents(): void;
+    /**
+     * Check if value object has uncommitted events
+     */
+    hasUncommittedEvents(): boolean;
+    toJson(): T;
+    /**
+     * Create a new ValueObject with updated properties
+     * Since ValueObjects are immutable, this returns a new instance
+     */
+    protected clone(updates: Partial<T>): this;
+}
+//# sourceMappingURL=value-object.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"value-object.d.ts","sourceRoot":"","sources":["../src/value-object.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EACL,OAAO,EAGP,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAWjB,8BAAsB,WAAW,CAAC,CAAC;IACjC,SAAS,CAAC,QAAQ,CAAC,KAAK,EAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,WAAW,CAAC,CAAkB;IACtC,OAAO,CAAC,YAAY,CAAC,CAAoB;IACzC,OAAO,CAAC,YAAY,CAAsB;IAG1C,SAAS,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;gBAE/B,KAAK,EAAE,CAAC;IA+CpB,OAAO,CAAC,aAAa;IA4BrB,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,IAAI,mBAAmB,IAAI,OAAO,CAEjC;IAED;;OAEG;IACH,IAAI,gBAAgB,IAAI,eAAe,GAAG,SAAS,CAElD;IAED,MAAM,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO;IAKtC;;OAEG;IACH,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAInD;;OAEG;IACH,oBAAoB,IAAI,YAAY,EAAE;IAItC;;OAEG;IACH,WAAW,IAAI,IAAI;IAInB;;OAEG;IACH,oBAAoB,IAAI,OAAO;IAI/B,MAAM,IAAI,CAAC;IAIX;;;OAGG;IACH,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;CAI3C"}

package/dist/value-object.js

@@ -0,0 +1,136 @@
+// ============================================================================
+// Value Object - Immutable Domain Objects
+// ============================================================================
+import { ValidationError } from "./validation-error";
+import { DEFAULT_VALIDATION_CONFIG } from "./constants";
+// Helper to get static properties from constructor
+function getStaticProperty(instance, propertyName) {
+    return instance.constructor[propertyName];
+}
+export class ValueObject {
+    constructor(props) {
+        this.domainEvents = [];
+        // Get static configuration from subclass
+        const validation = getStaticProperty(this, "validation");
+        const hooks = getStaticProperty(this, "hooks");
+        this.domainHooks = hooks;
+        if (validation?.schema) {
+            this.domainSchema = validation.schema;
+        }
+        this.validationConfig = {
+            ...DEFAULT_VALIDATION_CONFIG,
+            ...validation?.config,
+        };
+        // Apply defaultValues
+        let finalProps = { ...props };
+        if (hooks?.defaultValues) {
+            finalProps = { ...hooks.defaultValues, ...props };
+        }
+        // Validate schema on creation
+        if (this.domainSchema && this.validationConfig.onCreate) {
+            this.validateProps(finalProps);
+        }
+        // Set props (not frozen yet) so rules can access them
+        this.props = finalProps;
+        // Execute rules (custom validations) - after props is set but before freezing
+        if (hooks?.rules) {
+            hooks.rules(this);
+        }
+        // Now freeze the props for immutability
+        Object.freeze(this.props);
+        // Hook onCreate
+        if (hooks?.onCreate) {
+            hooks.onCreate(this);
+        }
+    }
+    validateProps(props) {
+        if (!this.domainSchema)
+            return;
+        const result = this.domainSchema["~standard"].validate(props);
+        if (result instanceof Promise) {
+            throw new Error("Async validation not supported in constructor. Use sync validation schema.");
+        }
+        if (result.issues && result.issues.length > 0) {
+            const validationError = new ValidationError(result.issues.map((issue) => ({
+                path: issue.path?.map((p) => this.extractPathKey(p)) || [],
+                message: issue.message,
+            })));
+            if (this.validationConfig.throwOnError) {
+                throw validationError;
+            }
+            // If not throwing, store error for later retrieval
+            this._validationError = validationError;
+        }
+    }
+    extractPathKey(pathSegment) {
+        if (pathSegment === null || pathSegment === undefined) {
+            return "";
+        }
+        // Handle PropertyKey (string | number | symbol)
+        if (typeof pathSegment === "string" || typeof pathSegment === "number") {
+            return String(pathSegment);
+        }
+        if (typeof pathSegment === "symbol") {
+            return pathSegment.toString();
+        }
+        // Handle object with 'key' property (Zod's PathSegment)
+        if (typeof pathSegment === "object" && "key" in pathSegment) {
+            return String(pathSegment.key);
+        }
+        // Fallback
+        return String(pathSegment);
+    }
+    /**
+     * Check if value object has validation errors (when throwOnError is false)
+     */
+    get hasValidationErrors() {
+        return !!this._validationError;
+    }
+    /**
+     * Get validation errors (when throwOnError is false)
+     */
+    get validationErrors() {
+        return this._validationError;
+    }
+    equals(other) {
+        if (!other || !(other instanceof ValueObject))
+            return false;
+        return JSON.stringify(this.props) === JSON.stringify(other.props);
+    }
+    /**
+     * Add a domain event to this value object
+     */
+    addDomainEvent(event) {
+        this.domainEvents.push(event);
+    }
+    /**
+     * Get all uncommitted domain events
+     */
+    getUncommittedEvents() {
+        return [...this.domainEvents];
+    }
+    /**
+     * Clear all domain events (call after publishing)
+     */
+    clearEvents() {
+        this.domainEvents = [];
+    }
+    /**
+     * Check if value object has uncommitted events
+     */
+    hasUncommittedEvents() {
+        return this.domainEvents.length > 0;
+    }
+    toJson() {
+        return { ...this.props };
+    }
+    /**
+     * Create a new ValueObject with updated properties
+     * Since ValueObjects are immutable, this returns a new instance
+     */
+    clone(updates) {
+        const Constructor = this.constructor;
+        return new Constructor({ ...this.props, ...updates });
+    }
+}
+//# sourceMappingURL=value-object.js.map

package/dist/value-object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"value-object.js","sourceRoot":"","sources":["../src/value-object.ts"],"names":[],"mappings":"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"}

package/eslint.config.js

@@ -0,0 +1,51 @@
+const tsParser = require("@typescript-eslint/parser");
+const tsPlugin = require("@typescript-eslint/eslint-plugin");
+
+module.exports = [
+  {
+    ignores: [
+      "dist/**",
+      "node_modules/**",
+      "coverage/**",
+      "**/*.test.ts",
+      "**/*.spec.ts",
+    ],
+  },
+  {
+    files: ["src/**/*.ts"],
+    languageOptions: {
+      parser: tsParser,
+      parserOptions: {
+        ecmaVersion: 2020,
+        sourceType: "module",
+        project: "./tsconfig.json",
+      },
+      globals: {
+        console: "readonly",
+        process: "readonly",
+        Buffer: "readonly",
+        __dirname: "readonly",
+        __filename: "readonly",
+        module: "readonly",
+        require: "readonly",
+        exports: "readonly",
+      },
+    },
+    plugins: {
+      "@typescript-eslint": tsPlugin,
+    },
+    rules: {
+      ...tsPlugin.configs.recommended.rules,
+      "@typescript-eslint/no-explicit-any": "off",
+      "@typescript-eslint/no-unused-vars": [
+        "warn",
+        { argsIgnorePattern: "^_" },
+      ],
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/explicit-module-boundary-types": "off",
+      "@typescript-eslint/no-this-alias": "off",
+      "@typescript-eslint/no-unsafe-function-type": "off",
+      "no-console": "off",
+    },
+  },
+];

package/jest.config.js

@@ -0,0 +1,21 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: "ts-jest",
+  testEnvironment: "node",
+  roots: ["<rootDir>/tests", "<rootDir>/src"],
+  testMatch: ["**/*.test.ts", "**/*.spec.ts"],
+  transform: {
+    "^.+\\.tsx?$": "ts-jest",
+  },
+  coveragePathIgnorePatterns: [
+    "/node_modules/",
+    "/dist/",
+    "/tests/",
+    "**/examples/**",
+  ],
+  moduleFileExtensions: ["ts", "tsx", "js", "jsx", "json", "node"],
+  collectCoverageFrom: ["src/**/*.ts", "!src/**/*.d.ts", "!src/index.ts"],
+  coverageDirectory: "coverage",
+  coverageReporters: ["text", "lcov", "clover"],
+  verbose: true,
+};

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@woltz/rich-domain",
+  "version": "0.2.1",
+  "description": "Rich Domain Library with Standard Schema validation support",
+  "publishConfig": {
+    "access": "public"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "check": "tsc --noEmit",
+    "coverage": "jest --coverage",
+    "lint": "eslint src",
+    "prepublishOnly": "npm run build",
+    "release": "standard-version",
+    "release:minor": "standard-version --release-as minor",
+    "release:major": "standard-version --release-as major",
+    "release:patch": "standard-version --release-as patch",
+    "release:first": "standard-version --first-release",
+    "prepare": "husky"
+  },
+  "keywords": [
+    "ddd",
+    "domain-driven-design",
+    "entity",
+    "aggregate",
+    "value-object",
+    "validation",
+    "standard-schema",
+    "typescript"
+  ],
+  "author": "Tarcisio Andrade",
+  "license": "MIT",
+  "devDependencies": {
+    "@commitlint/cli": "^20.1.0",
+    "@commitlint/config-conventional": "^20.0.0",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^20.11.30",
+    "@typescript-eslint/eslint-plugin": "^8.46.4",
+    "@typescript-eslint/parser": "^8.46.4",
+    "eslint": "^9.39.1",
+    "husky": "^9.1.7",
+    "jest": "^29.7.0",
+    "standard-version": "^9.5.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.4.3",
+    "zod": "^3.24.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=4.7.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}