@quatrain/core 1.2.9 → 1.2.11

package/dist/components/Entity.d.ts

@@ -1,6 +1,8 @@
 import { BaseObject } from './BaseObject';
+import { User } from './User';
 import { BaseObjectType } from './types/BaseObjectType';
 export interface EntityType extends BaseObjectType {
+    users?: User[];
 }
 export declare class Entity extends BaseObject {
     static COLLECTION: string;

package/dist/components/Entity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../src/components/Entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAMzC,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,MAAM,WAAW,UAAW,SAAQ,cAAc;CAEjD;AAMD,qBAAa,MAAO,SAAQ,UAAU;IAEnC,MAAM,CAAC,UAAU,SAAa;IAG9B,MAAM,CAAC,gBAAgB,QAiBtB;WAQY,OAAO,CAAC,GAAG,GAAE,GAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAG7D"}
+{"version":3,"file":"Entity.d.ts","sourceRoot":"","sources":["../../src/components/Entity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAI7B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAEvD,MAAM,WAAW,UAAW,SAAQ,cAAc;IAC/C,KAAK,CAAC,EAAE,IAAI,EAAE,CAAA;CAChB;AAMD,qBAAa,MAAO,SAAQ,UAAU;IAEnC,MAAM,CAAC,UAAU,SAAa;IAG9B,MAAM,CAAC,gBAAgB,QAiBtB;WAQY,OAAO,CAAC,GAAG,GAAE,GAAe,GAAG,OAAO,CAAC,MAAM,CAAC;CAG7D"}

package/dist/components/Entity.js

@@ -36,6 +36,8 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Entity = void 0;
 const BaseObject_1 = require("./BaseObject");
 const BaseObjectProperties_1 = require("./BaseObjectProperties");
+const User_1 = require("./User");
+const CollectionProperty_1 = require("../properties/CollectionProperty");
 const StringProperty_1 = require("../properties/StringProperty");
 const htmlType = __importStar(require("../properties/types/PropertyHTMLType"));
 class Entity extends BaseObject_1.BaseObject {
@@ -49,6 +51,13 @@ class Entity extends BaseObject_1.BaseObject {
             minLength: 1,
             htmlType: htmlType.ORG,
         },
+        {
+            name: 'users',
+            mandatory: false,
+            type: CollectionProperty_1.CollectionProperty.TYPE,
+            instanceOf: User_1.User,
+            parentKey: 'entity',
+        },
     ];
     static async factory(src = undefined) {
         return super.factory(src, Entity);

package/dist/components/Entity.js.map

@@ -1 +1 @@
-{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../src/components/Entity.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAyC;AACzC,iEAA6D;AAG7D,iEAA6D;AAC7D,+EAAgE;AAWhE,MAAa,MAAO,SAAQ,uBAAU;IAEnC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAG9B,MAAM,CAAC,gBAAgB,GAAG;QACvB,GAAG,2CAAoB;QACvB;YAEG,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,+BAAc,CAAC,IAAI;YACzB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,QAAQ,CAAC,GAAG;SACxB;KAQH,CAAA;IAQD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAW,SAAS;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;;AAhCJ,wBAiCC"}
+{"version":3,"file":"Entity.js","sourceRoot":"","sources":["../../src/components/Entity.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,6CAAyC;AACzC,iEAA6D;AAC7D,iCAA6B;AAC7B,yEAAqE;AACrE,iEAA6D;AAC7D,+EAAgE;AAWhE,MAAa,MAAO,SAAQ,uBAAU;IAEnC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAA;IAG9B,MAAM,CAAC,gBAAgB,GAAG;QACvB,GAAG,2CAAoB;QACvB;YAEG,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,+BAAc,CAAC,IAAI;YACzB,SAAS,EAAE,IAAI;YACf,SAAS,EAAE,CAAC;YACZ,QAAQ,EAAE,QAAQ,CAAC,GAAG;SACxB;QACD;YACG,IAAI,EAAE,OAAO;YACb,SAAS,EAAE,KAAK;YAChB,IAAI,EAAE,uCAAkB,CAAC,IAAI;YAC7B,UAAU,EAAE,WAAI;YAChB,SAAS,EAAE,QAAQ;SACrB;KACH,CAAA;IAQD,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,MAAW,SAAS;QACtC,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,CAAA;IACpC,CAAC;;AAhCJ,wBAiCC"}

package/dist/properties/CollectionProperty.d.ts

@@ -15,5 +15,14 @@ export declare class CollectionProperty extends BaseProperty {
     constructor(config: CollectionPropertyType);
     set(value: Array<any>, setChanged?: boolean): this;
     toJSON(): any[] | DataObjectClass<any>[] | ObjectUri[] | undefined;
+    sum(property: string, items?: any[]): number | Promise<number>;
+    average(property: string, items?: any[]): number | Promise<number>;
+    distinct(property: string, items?: any[]): any[] | Promise<any[]>;
+    min(property: string, items?: any[]): number | undefined | Promise<number | undefined>;
+    max(property: string, items?: any[]): number | undefined | Promise<number | undefined>;
+    groupBy(property: string, items?: any[]): Record<string, any[]> | Promise<Record<string, any[]>>;
+    pluck(property: string, items?: any[]): any[] | Promise<any[]>;
+    count(predicate?: (item: any) => boolean, items?: any[]): number | Promise<number>;
+    apply(fn: (item: any) => any | Promise<any>, items?: any[]): any[] | Promise<any[]>;
 }
 //# sourceMappingURL=CollectionProperty.d.ts.map

package/dist/properties/CollectionProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CollectionProperty.d.ts","sourceRoot":"","sources":["../../src/properties/CollectionProperty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAYrD,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC7D,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACpB;AAcD,qBAAa,kBAAmB,SAAQ,YAAY;IAEjD,MAAM,CAAC,IAAI,SAAe;IAC1B,SAAS,CAAC,MAAM,EACX,KAAK,CAAC,GAAG,CAAC,GACV,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAC3B,KAAK,CAAC,SAAS,CAAC,GAChB,SAAS,CAAY;IAC1B,SAAS,CAAC,WAAW,EAAE,OAAO,UAAU,CAAA;IACxC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEhB,MAAM,EAAE,sBAAsB;IAoB1C,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,UAAO;IASxC,MAAM;CAGR"}
+{"version":3,"file":"CollectionProperty.d.ts","sourceRoot":"","sources":["../../src/properties/CollectionProperty.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAA;AAEnD,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAA;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAA;AAYrD,MAAM,WAAW,sBAAuB,SAAQ,gBAAgB;IAC7D,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,OAAO,CAAC,EAAE,GAAG,CAAA;IACb,SAAS,CAAC,EAAE,MAAM,CAAA;CACpB;AAcD,qBAAa,kBAAmB,SAAQ,YAAY;IAEjD,MAAM,CAAC,IAAI,SAAe;IAC1B,SAAS,CAAC,MAAM,EACX,KAAK,CAAC,GAAG,CAAC,GACV,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,GAC3B,KAAK,CAAC,SAAS,CAAC,GAChB,SAAS,CAAY;IAC1B,SAAS,CAAC,WAAW,EAAE,OAAO,UAAU,CAAA;IACxC,SAAS,CAAC,UAAU,EAAE,MAAM,CAAA;gBAEhB,MAAM,EAAE,sBAAsB;IAoB1C,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,UAAU,UAAO;IASxC,MAAM;IAoBN,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAgBjF,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBrF,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAepF,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuBzG,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAuBzG,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAqBnH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;IAcjF,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,EAAE,KAAK,GAAE,GAAG,EAAsB,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcrG,KAAK,CACF,EAAE,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,EACrC,KAAK,GAAE,GAAG,EAAsB,GAChC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;CAO3B"}

package/dist/properties/CollectionProperty.js

@@ -26,6 +26,87 @@ class CollectionProperty extends BaseProperty_1.BaseProperty {
     toJSON() {
         return this._value;
     }
+    sum(property, items = this._value || []) {
+        return items.reduce((acc, item) => {
+            const val = typeof item.val === 'function' ? item.val(property) : item[property];
+            const num = Number(val);
+            return acc + (isNaN(num) ? 0 : num);
+        }, 0);
+    }
+    average(property, items = this._value || []) {
+        if (items.length === 0)
+            return 0;
+        const sumVal = this.sum(property, items);
+        if (sumVal && typeof sumVal.then === 'function') {
+            return sumVal.then((s) => s / items.length);
+        }
+        return sumVal / items.length;
+    }
+    distinct(property, items = this._value || []) {
+        const values = items.map((item) => {
+            return typeof item.val === 'function' ? item.val(property) : item[property];
+        });
+        return Array.from(new Set(values));
+    }
+    min(property, items = this._value || []) {
+        if (items.length === 0)
+            return undefined;
+        let minVal = undefined;
+        items.forEach((item) => {
+            const val = typeof item.val === 'function' ? item.val(property) : item[property];
+            const num = Number(val);
+            if (!isNaN(num)) {
+                if (minVal === undefined || num < minVal) {
+                    minVal = num;
+                }
+            }
+        });
+        return minVal;
+    }
+    max(property, items = this._value || []) {
+        if (items.length === 0)
+            return undefined;
+        let maxVal = undefined;
+        items.forEach((item) => {
+            const val = typeof item.val === 'function' ? item.val(property) : item[property];
+            const num = Number(val);
+            if (!isNaN(num)) {
+                if (maxVal === undefined || num > maxVal) {
+                    maxVal = num;
+                }
+            }
+        });
+        return maxVal;
+    }
+    groupBy(property, items = this._value || []) {
+        const groups = {};
+        items.forEach((item) => {
+            const val = typeof item.val === 'function' ? item.val(property) : item[property];
+            const key = String(val ?? 'undefined');
+            if (!groups[key]) {
+                groups[key] = [];
+            }
+            groups[key].push(item);
+        });
+        return groups;
+    }
+    pluck(property, items = this._value || []) {
+        return items.map((item) => {
+            return typeof item.val === 'function' ? item.val(property) : item[property];
+        });
+    }
+    count(predicate, items = this._value || []) {
+        if (!predicate)
+            return items.length;
+        return items.filter(predicate).length;
+    }
+    apply(fn, items = this._value || []) {
+        const results = items.map((item) => fn(item));
+        if (results.some((r) => r && typeof r.then === 'function')) {
+            return Promise.all(results);
+        }
+        return results;
+    }
 }
 exports.CollectionProperty = CollectionProperty;
 //# sourceMappingURL=CollectionProperty.js.map

package/dist/properties/CollectionProperty.js.map

@@ -1 +1 @@
-{"version":3,"file":"CollectionProperty.js","sourceRoot":"","sources":["../../src/properties/CollectionProperty.ts"],"names":[],"mappings":";;;AAAA,iDAA+D;AAE/D,kCAA8B;AAgC9B,MAAa,kBAAmB,SAAQ,2BAAY;IAEjD,MAAM,CAAC,IAAI,GAAG,YAAY,CAAA;IAChB,MAAM,GAIC,SAAS,CAAA;IAChB,WAAW,CAAmB;IAC9B,UAAU,CAAQ;IAE5B,YAAY,MAA8B;QACvC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAA;QACzD,CAAC;QACD,IAAI,CAAC,WAAW;YACb,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ;gBAClC,CAAC,CAAC,WAAI,CAAC,aAAa,CAAC,MAAM,CAAC,UAAU,CAAC;gBACvC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAA;QACzB,IAAI,CAAC,UAAU;YACZ,MAAM,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,UAAU,IAAI,SAAS,CAAA;IACpE,CAAC;IASD,GAAG,CAAC,KAAiB,EAAE,UAAU,GAAG,IAAI;QACrC,OAAO,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAA;IACtC,CAAC;IAOD,MAAM;QACH,OAAO,IAAI,CAAC,MAAM,CAAA;IACrB,CAAC;;AA1CJ,gDA2CC"}
+{"version":3,"file":"CollectionProperty.js","sourceRoot":"","sources":["../../src/properties/CollectionProperty.ts"],"names":[],"mappings":"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"}

package/dist/properties/HashProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"HashProperty.d.ts","sourceRoot":"","sources":["../../src/properties/HashProperty.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAGrE,MAAM,MAAM,iBAAiB,GACxB,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,cAAc,GAClC,OAAO,YAAY,CAAC,gBAAgB,GACpC,OAAO,YAAY,CAAC,gBAAgB,CAAA;AAYzC,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACzD,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACpB;AAoBD,qBAAa,YAAa,SAAQ,cAAc;IAE7C,MAAM,CAAC,IAAI,SAAS;IAEpB,MAAM,CAAC,aAAa,SAAQ;IAE5B,MAAM,CAAC,cAAc,SAAS;IAE9B,MAAM,CAAC,gBAAgB,SAAW;IAElC,MAAM,CAAC,gBAAgB,SAAW;IAElC,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACvC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAC5B,SAAS,CAAC,SAAS,UAAQ;gBAEf,MAAM,EAAE,gBAAgB;IAepC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA2C5B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,UAAO;IAWpC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGjC"}
+{"version":3,"file":"HashProperty.d.ts","sourceRoot":"","sources":["../../src/properties/HashProperty.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAA;AAGrE,MAAM,MAAM,iBAAiB,GACxB,OAAO,YAAY,CAAC,aAAa,GACjC,OAAO,YAAY,CAAC,cAAc,GAClC,OAAO,YAAY,CAAC,gBAAgB,GACpC,OAAO,YAAY,CAAC,gBAAgB,CAAA;AAYzC,MAAM,WAAW,gBAAiB,SAAQ,kBAAkB;IACzD,SAAS,CAAC,EAAE,iBAAiB,CAAA;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,OAAO,CAAA;CACpB;AAoBD,qBAAa,YAAa,SAAQ,cAAc;IAE7C,MAAM,CAAC,IAAI,SAAS;IAEpB,MAAM,CAAC,aAAa,SAAQ;IAE5B,MAAM,CAAC,cAAc,SAAS;IAE9B,MAAM,CAAC,gBAAgB,SAAW;IAElC,MAAM,CAAC,gBAAgB,SAAW;IAElC,SAAS,CAAC,UAAU,EAAE,iBAAiB,CAAA;IACvC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAK;IAC5B,SAAS,CAAC,SAAS,UAAQ;gBAEf,MAAM,EAAE,gBAAgB;IA8BpC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;IA2C5B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,UAAO;IAWpC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO;CAGjC"}

package/dist/properties/HashProperty.js

@@ -15,9 +15,18 @@ class HashProperty extends StringProperty_1.StringProperty {
     _prefixed = false;
     constructor(config) {
         super(config);
-        this._algorithm = config.algorithm || HashProperty.ALGORITHM_MD5;
+        this._algorithm = config.algorithm || HashProperty.ALGORITHM_SHA256;
         this._salt = config.salt || '';
         this._prefixed = config.prefixed || false;
+        if (this._algorithm === HashProperty.ALGORITHM_MD5 ||
+            this._algorithm === HashProperty.ALGORITHM_SHA1) {
+            const sensitiveTerms = ['password', 'pwd', 'secret', 'token', 'credential'];
+            const nameLower = this._name.toLowerCase();
+            const isSensitive = sensitiveTerms.some((term) => nameLower.includes(term));
+            if (isSensitive) {
+                throw new Error(`SecurityError: Insecure hashing algorithm "${this._algorithm}" cannot be used for sensitive property "${this._name}". Please use SHA256 or another secure algorithm.`);
+            }
+        }
     }
     _hash(value) {
         let algo;

package/dist/properties/HashProperty.js.map

@@ -1 +1 @@
-{"version":3,"file":"HashProperty.js","sourceRoot":"","sources":["../../src/properties/HashProperty.ts"],"names":[],"mappings":";;;AAAA,6CAAwC;AACxC,qDAAqE;AACrE,kCAA8B;AA0C9B,MAAa,YAAa,SAAQ,+BAAc;IAE7C,MAAM,CAAC,IAAI,GAAG,MAAM,CAAA;IAEpB,MAAM,CAAC,aAAa,GAAG,KAAK,CAAA;IAE5B,MAAM,CAAC,cAAc,GAAG,MAAM,CAAA;IAE9B,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAA;IAElC,MAAM,CAAC,gBAAgB,GAAG,QAAQ,CAAA;IAExB,UAAU,CAAmB;IAC7B,KAAK,GAAW,EAAE,CAAA;IAClB,SAAS,GAAG,KAAK,CAAA;IAE3B,YAAY,MAAwB;QACjC,KAAK,CAAC,MAAM,CAAC,CAAA;QACb,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,IAAI,YAAY,CAAC,aAAa,CAAA;QAChE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;QAC9B,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,QAAQ,IAAI,KAAK,CAAA;IAC5C,CAAC;IAUD,KAAK,CAAC,KAAa;QAChB,IAAI,IAAI,CAAA;QACR,QAAQ,IAAI,CAAC,UAAU,EAAE,CAAC;YACvB,KAAK,YAAY,CAAC,aAAa;gBAC5B,IAAI,GAAG,IAAA,wBAAU,EAAC,KAAK,CAAC,CAAA;gBACxB,WAAI,CAAC,IAAI,CACN,sDAAsD,CACxD,CAAA;gBACD,MAAK;YAER,KAAK,YAAY,CAAC,cAAc;gBAC7B,IAAI,GAAG,IAAA,wBAAU,EAAC,MAAM,CAAC,CAAA;gBACzB,WAAI,CAAC,IAAI,CACN,uDAAuD,CACzD,CAAA;gBACD,MAAK;YAER,KAAK,YAAY,CAAC,gBAAgB;gBAC/B,IAAI,GAAG,IAAA,wBAAU,EAAC,QAAQ,CAAC,CAAA;gBAC3B,MAAK;YAER;gBACG,MAAM,IAAI,KAAK,CACZ,0CAA0C,IAAI,CAAC,UAAU,EAAE,CAC7D,CAAA;QACP,CAAC;QAED,IAAI,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,EAAE,CAAA;QACtD,IAAI,IAAI,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,GAAG,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAE1D,IAAI,CAAC,SAAS,GAAG,KAAK,CAAA;QAEtB,OAAO,IAAI,CAAA;IACd,CAAC;IAUD,GAAG,CAAC,KAAa,EAAE,UAAU,GAAG,IAAI;QACjC,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,CAAA;IAClD,CAAC;IASD,OAAO,CAAC,KAAa;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,MAAM,CAAA;IAC3C,CAAC;;AAvFJ,oCAwFC"}
+{"version":3,"file":"HashProperty.js","sourceRoot":"","sources":["../../src/properties/HashProperty.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@quatrain/core",
-  "version": "1.2.9",
+  "version": "1.2.11",
   "description": "Core objects for business apps",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -33,7 +33,7 @@
     "typescript": "^5.2.2"
   },
   "dependencies": {
-    "@quatrain/log": "^1.2.2",
+    "@quatrain/log": "^1.2.3",
     "node-persist": "^4.0.4",
     "which": "^5.0.0"
   },

package/src/components/Entity.ts

@@ -1,13 +1,13 @@
 import { BaseObject } from './BaseObject'
 import { BaseObjectProperties } from './BaseObjectProperties'
-//import { User } from './User'
-//import { CollectionProperty } from '../properties/CollectionProperty'
+import { User } from './User'
+import { CollectionProperty } from '../properties/CollectionProperty'
 import { StringProperty } from '../properties/StringProperty'
 import * as htmlType from '../properties/types/PropertyHTMLType'
 import { BaseObjectType } from './types/BaseObjectType'
 
 export interface EntityType extends BaseObjectType {
-   //   users?: User[]
+   users?: User[]
 }
 
 /**
@@ -29,13 +29,13 @@ export class Entity extends BaseObject {
          minLength: 1,
          htmlType: htmlType.ORG,
       },
-      // {
-      //    name: 'users',
-      //    mandatory: true,
-      //    type: CollectionProperty.TYPE,
-      //    instanceOf: User,
-      //    parentKey: 'entity',
-      // },
+      {
+         name: 'users',
+         mandatory: false,
+         type: CollectionProperty.TYPE,
+         instanceOf: User,
+         parentKey: 'entity',
+      },
    ]
 
    /**

package/src/properties/CollectionProperty.test.ts

@@ -1,22 +1,118 @@
 import { Entity } from '../components/Entity'
 import { User } from '../components/User'
-import { DataGenerator } from '@quatrain/testing'
-import * as statuses from '../common/statuses'
+import { CollectionProperty } from './CollectionProperty'
+import { Core } from '../Core'
 
 describe('Collection Property', () => {
-   test('can retrieve user records matching relation', async () => {
-   //    const entity = await Entity.factory()
-   //    const user = await User.factory()
+   test('should throw an error if instantiated without instanceOf', () => {
+      expect(() => new CollectionProperty({ name: 'users' } as any)).toThrow("Parameter 'instanceOf' is mandatory")
+   })
+
+   test('should instantiate correctly with a class constructor', () => {
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: User,
+      })
+      expect(prop.name).toBe('users')
+   })
 
-   //    // Generate 3 users not associated to any entity
-   //    await DataGenerator(user, 3, { status: statuses.CREATED })
+   test('should instantiate correctly with a string class name from Core registry', () => {
+      Core.addClass('User', User)
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: 'User',
+      })
+      expect(prop.name).toBe('users')
+   })
 
-   //    // Generate 3 users associated with entity 1
-   //    await DataGenerator(user, 3, { status: statuses.CREATED, entity })
+   test('should set and get values using set() and val()', async () => {
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: User,
+      })
+      const user1 = await User.factory()
+      const user2 = await User.factory()
+      prop.set([user1, user2])
+      expect(prop.val()).toEqual([user1, user2])
+   })
+
+   test('should serialize correctly using toJSON()', async () => {
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: User,
+      })
+      const user1 = await User.factory()
+      prop.set([user1])
+      expect(prop.toJSON()).toEqual([user1])
+   })
 
-   //    const value = await entity.val('users')
-   //    expect(value).toBeInstanceOf(Array)
-   //    expect(value.length).toBe(3)
-   //
+   test('Entity should have users collection property', async () => {
+      const entity = await Entity.factory({ name: 'My Company' })
+      const usersProp = entity.dataObject.get('users')
+      expect(usersProp).toBeDefined()
+      expect(usersProp.constructor.name).toBe('CollectionProperty')
+   })
+
+   test('should correctly compute composite methods (sum, average, distinct, min, max, groupBy, pluck, count)', () => {
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: User,
+      })
+
+      // We use items that mimic BaseObject's val() method
+      const items = [
+         { val: (p: string) => (p === 'score' ? 10 : p === 'group' ? 'A' : undefined) },
+         { val: (p: string) => (p === 'score' ? 20 : p === 'group' ? 'B' : undefined) },
+         { val: (p: string) => (p === 'score' ? 30 : p === 'group' ? 'A' : undefined) },
+      ]
+
+      prop.set(items)
+
+      // sum
+      expect(prop.sum('score')).toBe(60)
+
+      // average
+      expect(prop.average('score')).toBe(20)
+
+      // distinct
+      expect(prop.distinct('group').sort()).toEqual(['A', 'B'])
+
+      // min / max
+      expect(prop.min('score')).toBe(10)
+      expect(prop.max('score')).toBe(30)
+
+      // groupBy
+      const grouped = prop.groupBy('group')
+      expect(grouped['A'].length).toBe(2)
+      expect(grouped['B'].length).toBe(1)
+
+      // pluck
+      expect(prop.pluck('score')).toEqual([10, 20, 30])
+
+      // count
+      expect(prop.count()).toBe(3)
+      expect(prop.count((x) => x.val('score') > 15)).toBe(2)
+   })
+
+   test('should apply synchronous and asynchronous callbacks using apply()', async () => {
+      const prop = new CollectionProperty({
+         name: 'users',
+         instanceOf: User,
+      })
+
+      const items = [{ id: 1 }, { id: 2 }]
+      prop.set(items)
+
+      // Sync apply
+      const syncResult = prop.apply((item) => item.id * 10)
+      expect(syncResult).toEqual([10, 20])
+
+      // Async apply
+      const asyncResult = await prop.apply(async (item) => {
+         return Promise.resolve(item.id * 100)
+      })
+      expect(asyncResult).toEqual([100, 200])
    })
 })
+
+

package/src/properties/CollectionProperty.ts

@@ -75,4 +75,174 @@ export class CollectionProperty extends BaseProperty {
    toJSON() {
       return this._value
    }
+
+   /**
+    * Sums the numeric values of a property across items in the collection.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property to sum.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The sum of all numeric values.
+    */
+   /**
+    * Sums the numeric values of a property across items in the collection.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property to sum.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The sum of all numeric values.
+    */
+   sum(property: string, items: any[] = this._value || []): number | Promise<number> {
+      return items.reduce((acc, item) => {
+         const val = typeof item.val === 'function' ? item.val(property) : item[property]
+         const num = Number(val)
+         return acc + (isNaN(num) ? 0 : num)
+      }, 0)
+   }
+
+   /**
+    * Calculates the average of the numeric values of a property across items in the collection.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property to average.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The average of all numeric values, or 0 if empty.
+    */
+   average(property: string, items: any[] = this._value || []): number | Promise<number> {
+      if (items.length === 0) return 0
+      const sumVal = this.sum(property, items)
+      if (sumVal && typeof (sumVal as any).then === 'function') {
+         return (sumVal as any).then((s: number) => s / items.length)
+      }
+      return (sumVal as number) / items.length
+   }
+
+   /**
+    * Retrieves all distinct values of a property across the collection items.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns An array of unique property values.
+    */
+   distinct(property: string, items: any[] = this._value || []): any[] | Promise<any[]> {
+      const values = items.map((item) => {
+         return typeof item.val === 'function' ? item.val(property) : item[property]
+      })
+      return Array.from(new Set(values))
+   }
+
+   /**
+    * Returns the minimum value of a numeric property across the collection items.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The minimum numeric value found, or undefined if no valid numbers are present.
+    */
+   min(property: string, items: any[] = this._value || []): number | undefined | Promise<number | undefined> {
+      if (items.length === 0) return undefined
+      let minVal: number | undefined = undefined
+      items.forEach((item) => {
+         const val = typeof item.val === 'function' ? item.val(property) : item[property]
+         const num = Number(val)
+         if (!isNaN(num)) {
+            if (minVal === undefined || num < minVal) {
+               minVal = num
+            }
+         }
+      })
+      return minVal
+   }
+
+   /**
+    * Returns the maximum value of a numeric property across the collection items.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The maximum numeric value found, or undefined if no valid numbers are present.
+    */
+   max(property: string, items: any[] = this._value || []): number | undefined | Promise<number | undefined> {
+      if (items.length === 0) return undefined
+      let maxVal: number | undefined = undefined
+      items.forEach((item) => {
+         const val = typeof item.val === 'function' ? item.val(property) : item[property]
+         const num = Number(val)
+         if (!isNaN(num)) {
+            if (maxVal === undefined || num > maxVal) {
+               maxVal = num
+            }
+         }
+      })
+      return maxVal
+   }
+
+   /**
+    * Groups the collection items by the values of a specific property.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property to group by.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns A dictionary object where keys are the property values and values are arrays of matching items.
+    */
+   groupBy(property: string, items: any[] = this._value || []): Record<string, any[]> | Promise<Record<string, any[]>> {
+      const groups: Record<string, any[]> = {}
+      items.forEach((item) => {
+         const val = typeof item.val === 'function' ? item.val(property) : item[property]
+         const key = String(val ?? 'undefined')
+         if (!groups[key]) {
+            groups[key] = []
+          }
+         groups[key].push(item)
+      })
+      return groups
+   }
+
+   /**
+    * Plucks a specific property from each item in the collection.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param property - The name of the property to extract.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns An array containing the extracted property values.
+    */
+   pluck(property: string, items: any[] = this._value || []): any[] | Promise<any[]> {
+      return items.map((item) => {
+         return typeof item.val === 'function' ? item.val(property) : item[property]
+      })
+   }
+
+   /**
+    * Returns the count of items in the collection, optionally filtered by a predicate callback.
+    * Can aggregate either the internal collection value or an external array.
+    * 
+    * @param predicate - An optional filter callback to run on each item.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The count of matching items.
+    */
+   count(predicate?: (item: any) => boolean, items: any[] = this._value || []): number | Promise<number> {
+      if (!predicate) return items.length
+      return items.filter(predicate).length
+   }
+
+   /**
+    * Applies an anonymous function to each item in the collection.
+    * Can execute either on the internal collection value or an external array.
+    * Supporting both synchronous and asynchronous callback functions.
+    * 
+    * @param fn - The anonymous callback function to apply to each item.
+    * @param items - Optional external items array. Defaults to the internal collection array.
+    * @returns The results of the function applications (or a Promise resolving to the results if async).
+    */
+   apply(
+      fn: (item: any) => any | Promise<any>,
+      items: any[] = this._value || []
+   ): any[] | Promise<any[]> {
+      const results = items.map((item) => fn(item))
+      if (results.some((r) => r && typeof r.then === 'function')) {
+         return Promise.all(results)
+      }
+      return results
+   }
 }

package/src/properties/HashProperty.test.ts

@@ -106,3 +106,49 @@ describe('Hash Property allows comparison of string and hash value', () => {
       expect(prop.set('azertyuiop').compare('qwertz')).toBe(false)
    })
 })
+
+describe('Hash Property Security Policies', () => {
+   test('defaults to SHA256 when no algorithm is provided', () => {
+      const prop = new HashProperty({
+         name: 'my_hash',
+      })
+      expect(prop.set('azertyuiop').get()).toBe(
+         'aa3d2fe4f6d301dbd6b8fb2d2fddfb7aeebf3bec53ffff4b39a0967afa88c609'
+      )
+   })
+
+   test('throws error if MD5 is used for sensitive property names', () => {
+      expect(() => {
+         new HashProperty({
+            name: 'userPassword',
+            algorithm: HashProperty.ALGORITHM_MD5,
+         })
+      }).toThrow('SecurityError: Insecure hashing algorithm')
+
+      expect(() => {
+         new HashProperty({
+            name: 'client_pwd',
+            algorithm: HashProperty.ALGORITHM_MD5,
+         })
+      }).toThrow('SecurityError: Insecure hashing algorithm')
+   })
+
+   test('throws error if SHA1 is used for sensitive property names', () => {
+      expect(() => {
+         new HashProperty({
+            name: 'secretToken',
+            algorithm: HashProperty.ALGORITHM_SHA1,
+         })
+      }).toThrow('SecurityError: Insecure hashing algorithm')
+   })
+
+   test('allows SHA256 for sensitive property names', () => {
+      const prop = new HashProperty({
+         name: 'password',
+         algorithm: HashProperty.ALGORITHM_SHA256,
+      })
+      expect(prop.set('azertyuiop').get()).toBe(
+         'aa3d2fe4f6d301dbd6b8fb2d2fddfb7aeebf3bec53ffff4b39a0967afa88c609'
+      )
+   })
+})

package/src/properties/HashProperty.ts

@@ -14,7 +14,7 @@ export type HashPropertyAlgos =
  *
  * | Parameter | Type | Description | Default |
  * | :--- | :--- | :--- | :--- |
- * | `algorithm` | HashPropertyAlgos | The cryptographic hashing algorithm to use. | `ALGORITHM_MD5` |
+ * | `algorithm` | HashPropertyAlgos | The cryptographic hashing algorithm to use. | `ALGORITHM_SHA256` |
  * | `salt` | string | An optional salt string appended to the value before hashing. | `""` |
  * | `prefixed` | boolean | If true, prepends the algorithm name to the output (e.g. `md5-abc...`). | `false` |
  */
@@ -60,9 +60,24 @@ export class HashProperty extends StringProperty {
 
    constructor(config: HashPropertyType) {
       super(config)
-      this._algorithm = config.algorithm || HashProperty.ALGORITHM_MD5
+      this._algorithm = config.algorithm || HashProperty.ALGORITHM_SHA256
       this._salt = config.salt || ''
       this._prefixed = config.prefixed || false
+
+      // Prevent legacy/insecure algorithms (MD5, SHA1) on sensitive properties
+      if (
+         this._algorithm === HashProperty.ALGORITHM_MD5 ||
+         this._algorithm === HashProperty.ALGORITHM_SHA1
+      ) {
+         const sensitiveTerms = ['password', 'pwd', 'secret', 'token', 'credential']
+         const nameLower = this._name.toLowerCase()
+         const isSensitive = sensitiveTerms.some((term) => nameLower.includes(term))
+         if (isSensitive) {
+            throw new Error(
+               `SecurityError: Insecure hashing algorithm "${this._algorithm}" cannot be used for sensitive property "${this._name}". Please use SHA256 or another secure algorithm.`
+            )
+         }
+      }
    }
 
    /**