@archtx/core 1.1.10 → 1.1.12

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

@@ -0,0 +1,238 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { Entity } from './Entity.js';
+describe('Entity', () => {
+    afterEach(() => {
+        process.env.NODE_ENV = 'development';
+    });
+    describe('Initialization', () => {
+        it('should initialize with props', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile(props);
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            expect(profile.props).toEqual({ id: '123', name: 'Test' });
+        });
+    });
+    describe('Props Immutability', () => {
+        it('should make props immutable in development mode', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            // Direct modification attempts should throw errors in strict mode
+            expect(() => {
+                // @ts-expect-error - Intentionally trying to modify readonly property
+                profile.props.name = 'Modified';
+            }).toThrow();
+            expect(() => {
+                // @ts-expect-error - Intentionally trying to modify readonly property
+                profile.props.tags.push('tag3');
+            }).toThrow();
+            expect(() => {
+                // @ts-expect-error - Intentionally trying to modify readonly property
+                profile.props.metadata.email = 'cory@therms.io';
+            }).toThrow();
+        });
+    });
+    describe('set() method', () => {
+        it('should not allow setting the ID property', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile(props);
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            expect(() => {
+                // @ts-expect-error - Intentionally trying to set ID
+                profile.set('id', '456');
+            }).toThrow('Cannot set ID');
+        });
+        it('should update a property value', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            profile.set('name', 'Updated');
+            expect(profile.props.name).toBe('Updated');
+        });
+        it('should allow null/undefined values', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile(props);
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            profile.set('maybe', null);
+            expect(profile.props.maybe).toBe(null);
+            profile.set('maybe', undefined);
+            expect(profile.props.maybe).toBe(undefined);
+            profile.set('maybe', 'value');
+            expect(profile.props.maybe).toBe('value');
+        });
+        it('should create a new reference when updating props', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            const originalProps = profile.props;
+            profile.set('name', 'Updated');
+            // Reference should be different
+            expect(profile.props).not.toBe(originalProps);
+        });
+        it('should deeply clone objects when updating', () => {
+            const date = new Date();
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            const newMetadata = {
+                createdAt: date,
+                updatedAt: new Date(),
+                nested: {
+                    value: 100,
+                },
+            };
+            profile.set('metadata', newMetadata);
+            // Modify the original object
+            expect(() => {
+                newMetadata.nested.value = 200;
+            }).toThrow();
+            // Entity props should have the original value
+            expect(profile.props.metadata?.nested?.value).toBe(100);
+        });
+        it('should deeply clone arrays when updating', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate() {
+                    if (this.props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const tags = ['tag1', 'tag2'];
+            const profile = Profile.create({ id: '123', name: 'Test', tags });
+            // Modify the original array
+            expect(() => { tags.push('tag3'); }).toThrow;
+            expect(() => { tags[0] = 'tag4'; }).toThrow;
+            // Entity props should have the original value
+            expect(profile.props.tags.length).toBe(2);
+            expect(profile.props.tags[0]).toBe('tag1');
+            profile.set('tags', [...profile.props.tags, 'tag5', 'tag6']);
+            // Entity props should have the new value
+            expect(profile.props.tags.length).toBe(4);
+        });
+    });
+    describe('Validation', () => {
+        it('should validate properties when setting values', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile({
+                        ...props,
+                        tags: props.tags || [],
+                    });
+                }
+                validate(props) {
+                    if (props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                    if (!props.tags) {
+                        throw new Error('Tags cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            // These should pass validation
+            expect(() => profile.set('name', 'Valid name')).not.toThrow();
+            expect(() => profile.set('tags', ['1', '2'])).not.toThrow();
+            // These should fail validation
+            expect(() => profile.set('name', '')).toThrow('Name cannot be empty');
+            // @ts-expect-error - Intentionally passing undefined
+            expect(() => profile.set('tags', undefined)).toThrow('Tags cannot be empty');
+        });
+        it('should not update props if validation fails', () => {
+            class Profile extends Entity {
+                static create(props) {
+                    return new Profile(props);
+                }
+                validate(props) {
+                    if (props.name.length === 0) {
+                        throw new Error('Name cannot be empty');
+                    }
+                }
+            }
+            const profile = Profile.create({ id: '123', name: 'Test' });
+            // Try to set an invalid value
+            try {
+                profile.set('name', '');
+            }
+            catch (error) {
+                // Ignore the error
+            }
+            // Props should not be updated
+            expect(profile.props.name).toBe('Test');
+        });
+    });
+});
+//# sourceMappingURL=Entity.test.js.map

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

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

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

@@ -0,0 +1,6 @@
+import { Entity } from './Entity.js';
+/**
+ * Asserts that an entity exists, throwing a NotFoundError if it does not.
+ * @param entity {Entity} - The entity to check.
+ */
+export declare function assertEntityExists<EntityInstance extends Entity<any>>(entity?: EntityInstance): asserts entity is EntityInstance;

package/dist/src/Entity/utils.js

@@ -0,0 +1,12 @@
+import { NotFoundError } from '../errors/NotFoundError.js';
+import { Entity } from './Entity.js';
+/**
+ * Asserts that an entity exists, throwing a NotFoundError if it does not.
+ * @param entity {Entity} - The entity to check.
+ */
+export function assertEntityExists(entity) {
+    if (!(entity instanceof Entity)) {
+        throw new NotFoundError(null, 'Entity not found');
+    }
+}
+//# sourceMappingURL=utils.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../src/Entity/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAC1D,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEpC;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAAuB;IAEvB,IAAI,CAAC,CAAC,MAAM,YAAY,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,aAAa,CAAC,IAAI,EAAE,kBAAkB,CAAC,CAAA;IACnD,CAAC;AACH,CAAC"}

package/dist/src/errors/AuthError.d.ts

@@ -1,7 +1,7 @@
 import { RootError } from './RootError.js';
-type ERROR_DESC = 'UNABLE_TO_CHECK_AUTH' | 'NOT_AUTHENTICATED' | 'INVALID_PERMISSIONS';
+type ERROR_DESC = 'UNABLE_TO_CHECK_AUTH' | 'NOT_AUTHENTICATED' | 'INVALID_PERMISSIONS' | 'INVALID_ROLE';
 export declare class AuthError extends RootError {
     errorType?: ERROR_DESC;
-    constructor(internalDesc: string | string[] | null, externalDesc: string | undefined, errorType: ERROR_DESC);
+    constructor(internalDesc: string | string[] | null, externalDesc: string | undefined | null, errorType: ERROR_DESC);
 }
 export {};

package/dist/src/errors/AuthError.js.map

@@ -1 +1 @@
-{"version":3,"file":"AuthError.js","sourceRoot":"","sources":["../../../src/errors/AuthError.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAO1C,MAAM,OAAO,SAAU,SAAQ,SAAS;IAC/B,SAAS,CAAa;IAE7B,YACE,YAAsC,EACtC,YAAgC,EAChC,SAAqB;QAErB,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QAEjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,mGAAmG;QACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAClD,CAAC;CACF"}
+{"version":3,"file":"AuthError.js","sourceRoot":"","sources":["../../../src/errors/AuthError.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAQ1C,MAAM,OAAO,SAAU,SAAQ,SAAS;IAC/B,SAAS,CAAa;IAE7B,YACE,YAAsC,EACtC,YAAuC,EACvC,SAAqB;QAErB,KAAK,CAAC,YAAY,EAAE,YAAY,CAAC,CAAA;QAEjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAA;QAE1B,mGAAmG;QACnG,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAClD,CAAC;CACF"}

package/dist/src/errors/RootError.d.ts

@@ -1,10 +1,10 @@
 export declare class RootError extends Error {
-    externalDesc?: string;
+    externalDesc?: string | null;
     /**
      * Create a RootError
      * @param [internalDesc] Internal message, console, logs, etc.
      * @param [externalDesc] External message is safe to be sent in a response to
      * the client. NOTE: This does not mean it's "human readable".
      */
-    constructor(internalDesc: string | string[] | null | undefined, externalDesc?: string);
+    constructor(internalDesc: string | string[] | null | undefined, externalDesc?: string | null);
 }

package/dist/src/errors/RootError.js.map

@@ -1 +1 @@
-{"version":3,"file":"RootError.js","sourceRoot":"","sources":["../../../src/errors/RootError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,YAAY,CAAS;IAE5B;;;;;OAKG;IACH,YACE,YAAkD,EAClD,YAAqB;QAErB,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,IAAI,YAAY,IAAI,+BAA+B,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC9B,CAAC,CAAC,YAAY,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,YAAY,IAAI,EAAE,CAAA;QACnC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,mMAAmM;QACnM,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAClD,CAAC;CACF"}
+{"version":3,"file":"RootError.js","sourceRoot":"","sources":["../../../src/errors/RootError.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,SAAU,SAAQ,KAAK;IAC3B,YAAY,CAAgB;IAEnC;;;;;OAKG;IACH,YACE,YAAkD,EAClD,YAA4B;QAE5B,IAAI,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAChC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAA;QAChC,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,YAAY,IAAI,YAAY,IAAI,+BAA+B,CAAC,CAAA;QACxE,CAAC;QAED,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC;gBACxC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC;gBAC9B,CAAC,CAAC,YAAY,CAAA;QAClB,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,OAAO,GAAG,YAAY,IAAI,EAAE,CAAA;QACnC,CAAC;QAED,IAAI,CAAC,YAAY,GAAG,YAAY,CAAA;QAEhC,mMAAmM;QACnM,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,SAAS,CAAC,SAAS,CAAC,CAAA;IAClD,CAAC;CACF"}