@archtx/core 1.1.10 → 1.1.12

package/dist/exports.d.ts

@@ -1,3 +1,5 @@
+export * from './src/Entity/Entity.js';
+export * from './src/Entity/utils.js';
 export * from './src/errors/AuthError.js';
 export * from './src/errors/EntityError.js';
 export * from './src/errors/ExpiredError.js';
@@ -7,5 +9,4 @@ export * from './src/errors/RootError.js';
 export * from './src/errors/UseCaseError.js';
 export * from './src/errors/ValidationError.js';
 export * from './src/common-types.js';
-export * from './src/Entity.js';
 export * from './src/UseCase.js';

package/dist/exports.js

@@ -1,3 +1,5 @@
+export * from './src/Entity/Entity.js';
+export * from './src/Entity/utils.js';
 export * from './src/errors/AuthError.js';
 export * from './src/errors/EntityError.js';
 export * from './src/errors/ExpiredError.js';
@@ -7,6 +9,5 @@ export * from './src/errors/RootError.js';
 export * from './src/errors/UseCaseError.js';
 export * from './src/errors/ValidationError.js';
 export * from './src/common-types.js';
-export * from './src/Entity.js';
 export * from './src/UseCase.js';
 //# sourceMappingURL=exports.js.map

package/dist/exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.js","sourceRoot":"","sources":["../exports.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAE/C,cAAc,uBAAuB,CAAA;AAErC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../exports.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,uBAAuB,CAAA;AAErC,cAAc,2BAA2B,CAAA;AACzC,cAAc,6BAA6B,CAAA;AAC3C,cAAc,8BAA8B,CAAA;AAC5C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,2BAA2B,CAAA;AACzC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,iCAAiC,CAAA;AAE/C,cAAc,uBAAuB,CAAA;AAErC,cAAc,kBAAkB,CAAA"}

package/dist/src/Entity/Entity.benchmark.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/src/Entity/Entity.benchmark.test.js

@@ -0,0 +1,283 @@
+import { describe, it } from 'vitest';
+import { performance } from 'perf_hooks';
+import { Entity } from './Entity.js'; // Update with your actual import path
+// Create a concrete implementation of the abstract Entity class for testing
+class TestEntity extends Entity {
+    validate(props) {
+        // Simple validation
+        if (!props.id)
+            throw new Error('ID is required');
+        if (!props.name)
+            throw new Error('Name is required');
+        if (props.age < 0)
+            throw new Error('Age cannot be negative');
+    }
+    static create(props) {
+        return new TestEntity(props);
+    }
+    // Expose private methods for benchmarking
+    benchmarkCloneProps(obj) {
+        return this._cloneProps(obj);
+    }
+    benchmarkDeepFreeze(obj) {
+        return this._deepFreeze(obj);
+    }
+}
+// Utility to create sample entities of different sizes
+function createEntityProps(size) {
+    const base = {
+        id: `test-id-${Math.random()}`,
+        name: `Test User ${size}`,
+        age: 30,
+        email: `test-${size}@example.com`,
+        address: {
+            street: '123 Main St',
+            city: 'Test City',
+            country: 'Test Country',
+        },
+        tags: ['tag1', 'tag2', 'tag3'],
+    };
+    // Add additional complexity based on size
+    if (size === 'medium' || size === 'large') {
+        base.metadata = {
+            createdAt: new Date(),
+            updatedAt: new Date(),
+            visits: 100,
+            preferences: {
+                theme: 'dark',
+                notifications: true,
+                language: 'en',
+            },
+        };
+    }
+    if (size === 'large') {
+        base.metadata = {
+            ...base.metadata,
+            history: Array(50)
+                .fill(0)
+                .map((_, i) => ({
+                action: `action-${i}`,
+                timestamp: new Date(),
+                details: {
+                    ip: `192.168.1.${i}`,
+                    device: `device-${i}`,
+                    browser: `browser-${i}`,
+                    location: {
+                        lat: Math.random() * 180 - 90,
+                        lng: Math.random() * 360 - 180,
+                        country: 'Country',
+                        city: 'City',
+                    },
+                },
+            })),
+        };
+    }
+    return base;
+}
+// Benchmark function
+function runBenchmark(name, fn, iterations) {
+    // Warm-up phase to avoid JIT compilation overhead
+    for (let i = 0; i < Math.min(iterations / 10, 1000); i++) {
+        fn();
+    }
+    // Measurement phase
+    const start = performance.now();
+    for (let i = 0; i < iterations; i++) {
+        fn();
+    }
+    const end = performance.now();
+    const totalTimeMs = end - start;
+    const timePerOperationMs = totalTimeMs / iterations;
+    const operationsPerSecond = 1000 / timePerOperationMs;
+    console.log(`${name}:`);
+    console.log(`  Total time: ${totalTimeMs.toFixed(2)} ms`);
+    console.log(`  Iterations: ${iterations}`);
+    console.log(`  Time per operation: ${timePerOperationMs.toFixed(6)} ms`);
+    console.log(`  Operations per second: ${operationsPerSecond.toFixed(2)}`);
+    return {
+        name,
+        opsPerSecond: operationsPerSecond,
+        timePerOp: timePerOperationMs,
+    };
+}
+describe('Entity Performance Benchmarks', () => {
+    // Adjust iterations based on operation complexity
+    const iterations = {
+        small: 10000,
+        medium: 5000,
+        large: 1000,
+    };
+    it('should benchmark entity instantiation with different sizes', () => {
+        const results = [];
+        // Small entity
+        const smallProps = createEntityProps('small');
+        results.push(runBenchmark('Entity instantiation (small)', () => TestEntity.create({ ...smallProps, id: `small-${Math.random()}` }), iterations.small));
+        // Medium entity
+        const mediumProps = createEntityProps('medium');
+        results.push(runBenchmark('Entity instantiation (medium)', () => TestEntity.create({ ...mediumProps, id: `medium-${Math.random()}` }), iterations.medium));
+        // Large entity
+        const largeProps = createEntityProps('large');
+        results.push(runBenchmark('Entity instantiation (large)', () => TestEntity.create({ ...largeProps, id: `large-${Math.random()}` }), iterations.large));
+        console.log('\nEntity instantiation comparison:');
+        results.forEach((r) => {
+            console.log(`  ${r.name}: ${r.opsPerSecond.toFixed(2)} ops/sec (${r.timePerOp.toFixed(3)} ms per op)`);
+        });
+    });
+    it('should benchmark property setting with different property types', () => {
+        const results = [];
+        // Create entities of different sizes
+        const smallEntity = TestEntity.create(createEntityProps('small'));
+        const mediumEntity = TestEntity.create(createEntityProps('medium'));
+        const largeEntity = TestEntity.create(createEntityProps('large'));
+        // Simple property settings
+        results.push(runBenchmark('Set simple property (string)', () => smallEntity.set('name', `User-${Math.random()}`), iterations.small));
+        results.push(runBenchmark('Set simple property (number)', () => smallEntity.set('age', Math.floor(Math.random() * 100)), iterations.small));
+        // Nested property settings
+        results.push(runBenchmark('Set nested property (object)', () => smallEntity.set('address', {
+            street: `${Math.random()} Main St`,
+            city: 'Updated City',
+            country: 'Updated Country',
+        }), iterations.small));
+        results.push(runBenchmark('Set array property', () => smallEntity.set('tags', Array(3)
+            .fill(0)
+            .map((_, i) => `tag-${Math.random()}`)), iterations.small));
+        // Settings on larger entities
+        results.push(runBenchmark('Set property on medium entity', () => mediumEntity.set('name', `Medium-${Math.random()}`), iterations.medium));
+        if (mediumEntity.props.metadata) {
+            results.push(runBenchmark('Set nested property on medium entity', () => {
+                const metadata = { ...mediumEntity.props.metadata };
+                if (metadata.preferences) {
+                    metadata.preferences = {
+                        ...metadata.preferences,
+                        theme: Math.random() > 0.5 ? 'dark' : 'light',
+                    };
+                    mediumEntity.set('metadata', metadata);
+                }
+            }, iterations.medium));
+        }
+        results.push(runBenchmark('Set property on large entity', () => largeEntity.set('name', `Large-${Math.random()}`), iterations.large));
+        console.log('\nProperty setting comparison:');
+        results.forEach((r) => {
+            console.log(`  ${r.name}: ${r.opsPerSecond.toFixed(2)} ops/sec (${r.timePerOp.toFixed(3)} ms per op)`);
+        });
+    });
+    it('should benchmark _cloneProps with different object complexities', () => {
+        const results = [];
+        const entity = TestEntity.create(createEntityProps('small'));
+        // Simple object cloning
+        const simpleObj = { id: 'test', name: 'Simple', value: 42 };
+        results.push(runBenchmark('Clone simple object (3 properties)', () => entity.benchmarkCloneProps(simpleObj), iterations.small));
+        // Object with nested properties
+        const nestedObj = {
+            id: 'test',
+            name: 'Nested',
+            address: {
+                street: 'Main St',
+                city: 'Test City',
+                zip: '12345',
+                geo: { lat: 10, lng: 20 },
+            },
+        };
+        results.push(runBenchmark('Clone nested object (depth 3)', () => entity.benchmarkCloneProps(nestedObj), iterations.small));
+        // Object with arrays
+        const arrayObj = {
+            id: 'test',
+            name: 'Array Object',
+            items: Array(10)
+                .fill(0)
+                .map((_, i) => ({ id: `item-${i}`, value: i })),
+        };
+        results.push(runBenchmark('Clone object with array (10 items)', () => entity.benchmarkCloneProps(arrayObj), iterations.small));
+        // Object with Date instances
+        const dateObj = {
+            id: 'test',
+            name: 'Date Object',
+            created: new Date(),
+            updated: new Date(),
+            appointments: Array(5)
+                .fill(0)
+                .map((_, i) => new Date(Date.now() + i * 86400000)),
+        };
+        results.push(runBenchmark('Clone object with Date instances', () => entity.benchmarkCloneProps(dateObj), iterations.small));
+        // Complex object with arrays, nested objects, and dates
+        const complexObj = {
+            id: 'test',
+            name: 'Complex',
+            created: new Date(),
+            items: Array(20)
+                .fill(0)
+                .map((_, i) => ({
+                id: `item-${i}`,
+                value: i,
+                tags: Array(3)
+                    .fill(0)
+                    .map((_, j) => `tag-${j}`),
+                metadata: {
+                    created: new Date(),
+                    updated: new Date(),
+                    status: i % 2 === 0 ? 'active' : 'inactive',
+                },
+            })),
+        };
+        results.push(runBenchmark('Clone complex object', () => entity.benchmarkCloneProps(complexObj), iterations.medium));
+        // Very large object
+        const largeObj = createEntityProps('large');
+        results.push(runBenchmark('Clone very large object', () => entity.benchmarkCloneProps(largeObj), iterations.large));
+        console.log('\nObject cloning comparison:');
+        results.forEach((r) => {
+            console.log(`  ${r.name}: ${r.opsPerSecond.toFixed(2)} ops/sec (${r.timePerOp.toFixed(3)} ms per op)`);
+        });
+    });
+    it('should benchmark _deepFreeze with different object complexities', () => {
+        const results = [];
+        const entity = TestEntity.create(createEntityProps('small'));
+        // Simple object freezing
+        results.push(runBenchmark('Freeze simple object', () => entity.benchmarkDeepFreeze({ ...createEntityProps('small') }), iterations.small));
+        // Medium object freezing
+        results.push(runBenchmark('Freeze medium object', () => entity.benchmarkDeepFreeze({ ...createEntityProps('medium') }), iterations.medium));
+        // Large object freezing
+        results.push(runBenchmark('Freeze large object', () => entity.benchmarkDeepFreeze({ ...createEntityProps('large') }), iterations.large));
+        console.log('\nDeep freezing comparison:');
+        results.forEach((r) => {
+            console.log(`  ${r.name}: ${r.opsPerSecond.toFixed(2)} ops/sec (${r.timePerOp.toFixed(3)} ms per op)`);
+        });
+    });
+    it('should benchmark complete entity operations', () => {
+        const results = [];
+        // Create an entity and perform a series of operations
+        results.push(runBenchmark('Entity lifecycle (create + 5 property updates)', () => {
+            const entity = TestEntity.create(createEntityProps('small'));
+            entity.set('name', `User-${Math.random()}`);
+            entity.set('age', Math.floor(Math.random() * 100));
+            entity.set('email', `user-${Math.random()}@example.com`);
+            entity.set('address', {
+                street: `${Math.random()} Street`,
+                city: `City-${Math.random()}`,
+                country: 'Test Country',
+            });
+            entity.set('tags', Array(3)
+                .fill(0)
+                .map((_, i) => `tag-${Math.random()}`));
+            return entity.toJSON();
+        }, iterations.medium / 5));
+        // Create, update, and serialize
+        results.push(runBenchmark('Create, update single property, and serialize', () => {
+            const entity = TestEntity.create(createEntityProps('medium'));
+            entity.set('name', `User-${Math.random()}`);
+            return entity.toJSON();
+        }, iterations.medium / 2));
+        // Multiple sequential updates to the same property
+        results.push(runBenchmark('Multiple sequential updates to the same property', () => {
+            const entity = TestEntity.create(createEntityProps('small'));
+            for (let i = 0; i < 5; i++) {
+                entity.set('name', `User-${i}-${Math.random()}`);
+            }
+            return entity.toJSON();
+        }, iterations.medium / 5));
+        console.log('\nCommon operations comparison:');
+        results.forEach((r) => {
+            console.log(`  ${r.name}: ${r.opsPerSecond.toFixed(2)} ops/sec (${r.timePerOp.toFixed(3)} ms per op)`);
+        });
+    });
+});
+//# sourceMappingURL=Entity.benchmark.test.js.map

package/dist/src/Entity/Entity.benchmark.test.js.map

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

package/dist/src/Entity/Entity.d.ts

@@ -0,0 +1,21 @@
+import { DeepReadonly, IWithID } from '../common-types.js';
+export declare abstract class EntityImmutable<Schema extends IWithID> {
+    protected _props: Schema;
+    get props(): DeepReadonly<Schema>;
+    constructor(props: Schema);
+    toJSON(): DeepReadonly<Schema>;
+}
+export declare abstract class Entity<Schema extends IWithID, PrivateSetters extends keyof Schema = never> {
+    abstract validate(props: Schema): void;
+    get previousProps(): DeepReadonly<Schema>;
+    get props(): DeepReadonly<Schema>;
+    set(updater: (draft: Schema) => void): void;
+    set<Key extends Exclude<keyof Schema, PrivateSetters | 'id'>>(key: Key, value: Schema[Key]): void;
+    set<Key extends Exclude<keyof Schema, PrivateSetters | 'id'>>(key: Key, updater: (draft: Schema[Key]) => void | Schema[Key]): void;
+    toJSON(): Schema;
+    protected _previousProps?: Schema;
+    protected _props: Schema;
+    protected constructor(props: Schema);
+    protected _cloneProps(obj: Schema): Schema;
+    protected _deepFreeze(obj: any): void;
+}

package/dist/src/Entity/Entity.js

@@ -0,0 +1,229 @@
+export class EntityImmutable {
+    _props;
+    get props() {
+        return this._props;
+    }
+    constructor(props) {
+        this._props = props;
+    }
+    toJSON() {
+        return this._props;
+    }
+}
+export class Entity {
+    get previousProps() {
+        return (this._previousProps || this._props);
+    }
+    get props() {
+        return this._props;
+    }
+    /**
+     * Update the entity with a new value or function updater. The updater
+     * function receives the current value and should return the new value.
+     * The updater function can also modify the draft in place and return void.
+     * The draft will be used as the new value.
+     * @param keyOrUpdater The key to update or a function to update the entire entity
+     * @param valueOrUpdater The value to set or a function to update a specific property
+     */
+    set(keyOrUpdater, valueOrUpdater) {
+        // On the first change/set call, clone the props
+        this._previousProps ??= this._cloneProps(this._props);
+        // Clone current props
+        const newProps = this._cloneProps(this._props);
+        // Case 1: Update the entire entity with a function
+        if (typeof keyOrUpdater === 'function') {
+            const updater = keyOrUpdater;
+            // Apply the updater to the cloned props
+            updater(newProps);
+        }
+        // Case 2 & 3: Update a specific property
+        else {
+            const key = keyOrUpdater;
+            // Check if key is private
+            if (key === 'id')
+                throw new Error('Cannot set ID');
+            // Case 2: Direct value assignment
+            if (typeof valueOrUpdater !== 'function') {
+                newProps[key] = valueOrUpdater;
+            }
+            // Case 3: Function updater for a specific property
+            else {
+                const updater = valueOrUpdater;
+                const propertyClone = this._cloneProps(newProps[key]);
+                const result = updater(propertyClone);
+                // If the updater returns a value, use that value
+                if (result !== undefined) {
+                    newProps[key] = result;
+                }
+                else {
+                    // Otherwise use the modified draft
+                    newProps[key] = propertyClone;
+                }
+            }
+        }
+        // Validate (must be before setting _props)
+        this.validate(newProps);
+        this._props = newProps;
+        // Freeze props deeply in dev environment only
+        if (process.env.NODE_ENV !== 'production') {
+            this._deepFreeze(this._props);
+        }
+    }
+    toJSON() {
+        return this._cloneProps(this._props);
+    }
+    /* Only exists if the _props were changed */
+    _previousProps;
+    _props;
+    constructor(props) {
+        this._props = props;
+        this._deepFreeze(this._props);
+    }
+    _cloneProps(obj) {
+        // clone values only, do not clone object configuration
+        if (obj === null || typeof obj !== 'object') {
+            return obj;
+        }
+        // Handle Date objects specially
+        if (obj instanceof Date) {
+            return new Date(obj);
+        }
+        // Create a fresh object/array to avoid inheriting configurations
+        const clone = Array.isArray(obj)
+            ? []
+            : {};
+        // Copy each property value
+        for (const key in obj) {
+            if (Object.prototype.hasOwnProperty.call(obj, key)) {
+                const val = obj[key];
+                // Recursively clone nested objects and arrays
+                clone[key] =
+                    val && typeof val === 'object' ? this._cloneProps(val) : val;
+            }
+        }
+        return clone;
+    }
+    _deepFreeze(obj) {
+        if (obj && typeof obj === 'object') {
+            Object.freeze(obj);
+            Object.getOwnPropertyNames(obj).forEach((prop) => {
+                if (obj[prop] !== null &&
+                    (typeof obj[prop] === 'object' || typeof obj[prop] === 'function') &&
+                    !Object.isFrozen(obj[prop])) {
+                    this._deepFreeze(obj[prop]);
+                }
+            });
+        }
+    }
+}
+// import { DeepReadonly, IWithID } from './common-types'
+//
+// export abstract class EntityImmutable<Schema extends IWithID> {
+//   protected _props: Schema
+//
+//   get props(): DeepReadonly<Schema> {
+//     return this._props as DeepReadonly<Schema>
+//   }
+//
+//   constructor(props: Schema) {
+//     this._props = props
+//   }
+//
+//   public toJSON(): DeepReadonly<Schema> {
+//     return this._props as DeepReadonly<Schema>
+//   }
+// }
+//
+// export abstract class Entity<Schema extends IWithID, PrivateSetters extends keyof Schema = never> {
+//   abstract validate(props: Schema): void
+//
+//   get previousProps(): DeepReadonly<Schema> {
+//     return (this._previousProps || this._props) as DeepReadonly<Schema>
+//   }
+//
+//   get props(): DeepReadonly<Schema> {
+//     return this._props as DeepReadonly<Schema>
+//   }
+//
+//   public set<Key extends Exclude<keyof Schema, PrivateSetters | 'id'>>(key: Key, value: Schema[Key]): void {
+//     // Check if key is private
+//     if (key === 'id') throw new Error('Cannot set ID')
+//
+//     // On the first change/set call, clone the props
+//     this._previousProps ??= this._cloneProps(this._props)
+//
+//     // Clone current props
+//     const newProps = this._cloneProps(this._props)
+//
+//     // Set new value
+//     newProps[key] = value
+//
+//     // Validate (must be before setting _props)
+//     this.validate(newProps)
+//
+//     this._props = newProps
+//
+//     // Freeze props deeply in dev environment only
+//     if (process.env.NODE_ENV !== 'production') {
+//       this._deepFreeze(this._props)
+//     }
+//   }
+//
+//   public toJSON(): DeepReadonly<Schema> {
+//     return this._props as DeepReadonly<Schema>
+//   }
+//
+//   /* Only exists if the _props were changed */
+//   protected _previousProps?: Schema
+//   protected _props: Schema
+//
+//   protected constructor(props: Schema) {
+//     this._props = props
+//     this._deepFreeze(this._props)
+//   }
+//
+//   protected _cloneProps(obj: Schema): Schema {
+//     // clone values only, do not clone object configuration
+//     if (obj === null || typeof obj !== 'object') {
+//       return obj
+//     }
+//
+//     // Handle Date objects specially
+//     if (obj instanceof Date) {
+//       return new Date(obj) as any
+//     }
+//
+//     // Create a fresh object/array to avoid inheriting configurations
+//     const clone: any = Array.isArray(obj)
+//       ? ([] as any[])
+//       : ({} as Record<string, any>)
+//
+//     // Copy each property value
+//     for (const key in obj) {
+//       if (Object.prototype.hasOwnProperty.call(obj, key)) {
+//         const val = obj[key]
+//         // Recursively clone nested objects and arrays
+//         clone[key as any] =
+//           val && typeof val === 'object' ? this._cloneProps(val as any) : val
+//       }
+//     }
+//
+//     return clone as Schema
+//   }
+//
+//   protected _deepFreeze(obj: any): void {
+//     if (obj && typeof obj === 'object') {
+//       Object.freeze(obj)
+//       Object.getOwnPropertyNames(obj).forEach((prop) => {
+//         if (
+//           obj[prop] !== null &&
+//           (typeof obj[prop] === 'object' || typeof obj[prop] === 'function') &&
+//           !Object.isFrozen(obj[prop])
+//         ) {
+//           this._deepFreeze(obj[prop])
+//         }
+//       })
+//     }
+//   }
+// }
+//# sourceMappingURL=Entity.js.map

package/dist/src/Entity/Entity.js.map

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

package/dist/src/Entity/Entity.test.d.ts

@@ -0,0 +1 @@
+export {};