@woltz/rich-domain 0.2.2 → 1.0.0

package/src/id.ts

@@ -1,4 +1,4 @@
-import { randomUUID } from 'crypto';
+import { randomUUID } from "crypto";
 // ============================================================================
 // Id Class - Smart Identity Management
 // ============================================================================
@@ -14,11 +14,11 @@ export class Id {
    * @example
    * // New entity (generates UUID)
    * const newId = new Id();
-   * newId.isNew // true
+   * newuser.isNew() // true
    *
    * // Existing entity (uses provided ID)
    * const existingId = new Id("550e8400-e29b-41d4-a716-446655440000");
-   * existingId.isNew // false
+   * existinguser.isNew() // false
    */
   constructor(value?: string) {
     if (value !== undefined) {
@@ -42,7 +42,7 @@ export class Id {
   /**
    * Check if this ID represents a new entity
    */
-  get isNew(): boolean {
+  public isNew(): boolean {
     return this._isNew;
   }
 

package/src/index.ts

@@ -16,14 +16,12 @@ export * from "./domain-event";
 
 export * from "./domain-event-bus";
 
-// Criteria & Repository
+// Criteria
 export * from "./criteria";
 export * from "./paginated-result";
 
 // Repository
 export * from "./repository";
-// Backward compatibility - re-export InMemoryRepository at top level
-export { InMemoryRepository } from "./repository";
 
 // Types
 export * from "./types";

package/src/repository/index.ts

@@ -6,7 +6,7 @@
 export { Mapper } from "../mapper";
 
 // Base implementations
-export { Repository as BaseRepository } from "./base-repository";
+export * from "./base-repository";
 export { InMemoryRepository } from "./in-memory-repository";
 
 // Unit of Work
@@ -15,40 +15,3 @@ export {
   BaseTransactionContext,
   InMemoryUnitOfWork,
 } from "./unit-of-work";
-
-/**
- * QUICK START:
- *
- * 1. For Testing:
- * ```ts
- * import { InMemoryRepository } from 'rich-domain';
- *
- * const userRepo = new InMemoryRepository<User>();
- * await userRepo.save(user);
- * const found = await userRepo.findById(user.id);
- * ```
- *
- * 2. For Production (Prisma, TypeORM, etc):
- * - Extend BaseRepository
- * - Implement abstract methods
- * - Create a Mapper
- * - See examples/ folder for reference
- *
- * 3. With Criteria:
- * ```ts
- * const result = await userRepo.find(
- *   Criteria.create<User>()
- *     .whereEquals('status', 'active')
- *     .orderByDesc('createdAt')
- *     .paginate(1, 10)
- * );
- * ```
- *
- * 4. With Unit of Work:
- * ```ts
- * await uow.transaction(async (ctx) => {
- *   const userRepo = uow.getRepository(UserRepository);
- *   await userRepo.save(user);
- * });
- * ```
- */

package/src/types/criteria.ts

@@ -1,6 +1,6 @@
 import { Primitive } from "./utils";
 
-export const FilterOperator = [
+export const FILTER_OPERATORS = [
   "equals",
   "notEquals",
   "greaterThan",
@@ -36,7 +36,7 @@ export type PathValue<
   ? T[P]
   : never;
 
-export type FilterOperator = (typeof FilterOperator)[number];
+export type FilterOperator = (typeof FILTER_OPERATORS)[number];
 
 export interface Filter<TField = string, TValue = unknown> {
   field: TField;

package/tests/entity-validation.test.ts

@@ -134,7 +134,7 @@ describe("Rich Domain with Standard Schema Validation", () => {
       expect(user.name).toBe("John Doe");
       expect(user.email).toBe("john@example.com");
       expect(user.age).toBe(25);
-      expect(user.isNew).toBe(true);
+      expect(user.isNew()).toBe(true);
     });
 
     it("should throw on invalid email", () => {

package/tests/history-tracker.spec.ts

@@ -4,28 +4,68 @@ import { Post, User, Address, Comment } from "./utils";
 describe("History Tracker Tests", () => {
   describe("Simple Property Changes", () => {
     it("should track simple property changes", (done) => {
-      const post = new Post({
+      const user = new User({
         id: new Id("1"),
-        title: "First Post",
-        content: "Hello World",
-        likes: 0,
+        name: "John Doe",
+        email: "john@example.com",
+        posts: [
+          new Post({
+            id: new Id("1"),
+            title: "First Post",
+            content: "Hello World",
+            likes: 0,
+          }),
+        ],
+        address: new Address({
+          street: "Main St",
+          city: "NYC",
+          zipCode: "10001",
+        }),
+        comments: [],
       });
 
-      let changeCount = 0;
+      user.changeEmail("new@example.com");
+      user.name = "New Name";
+      user.addPost(
+        new Post({
+          id: new Id("2"),
+          title: "Second Post",
+          content: "Hello World 2",
+          likes: 0,
+        })
+      );
 
-      post.subscribe({
-        title: {
-          onChange: ({ previous, current, path }) => {
-            changeCount++;
-            expect(previous).toBe("First Post");
-            expect(current).toBe("Updated Title");
-            expect(path).toBe("title");
-            done();
+      function dispatch(entity: User) {
+        entity.subscribe({
+          email: {
+            onChange: ({ previous, current, path }) => {
+              expect(previous).toBe("john@example.com");
+              expect(current).toBe("new@example.com");
+              expect(path).toBe("email");
+            },
           },
-        },
-      });
-
-      post.title = "Updated Title";
+          posts: {
+            onChange: ({ toCreate, toUpdate, toDelete }) => {
+              expect(toCreate).toHaveLength(1);
+              expect(toUpdate).toHaveLength(1);
+              expect(toDelete).toHaveLength(0);
+            },
+          },
+          name: {
+            onChange: ({ previous, current, path }) => {
+              expect(previous).toBe("John Doe");
+              expect(current).toBe("New Name");
+              expect(path).toBe("name");
+            },
+          },
+        });
+      }
+      user.posts[0].title = "Updated Title";
+      dispatch(user);
+
+      setTimeout(() => {
+        done();
+      }, 100);
     });
 
     it("should track multiple property changes", () => {