@haskou/value-objects 2.4.0 → 2.5.0

package/README.md

@@ -101,6 +101,7 @@ your application.
 
 ### 📝 Other
 - **`Enum`** - Base class for typed enumerations
+- **`UniqueObjectArray`** - Iterable collection that keeps comparable items unique
 
 ## 💡 Basic Examples
 
@@ -157,6 +158,15 @@ const media = new Media('hello world');
 console.log(media.getSize()); // 11
 console.log(media.getBase64()); // 'aGVsbG8gd29ybGQ='
 console.log(media.getBuffer()); // <Buffer 68 65 6c 6c 6f ...>
+
+// Unique collections
+const weekdays = UniqueObjectArray.fromArray([
+  new DayOfWeek(EDaysOfWeek.MONDAY),
+  new DayOfWeek(EDaysOfWeek.TUESDAY),
+  new DayOfWeek(EDaysOfWeek.MONDAY),
+]);
+console.log(weekdays.length()); // 2
+console.log(weekdays.toArray().map((day) => day.toString())); // ['monday', 'tuesday']
 ```
 
 ## 📚 Technical Documentation

package/dist/value-objects/UniqueObjectArray.d.ts

@@ -0,0 +1,15 @@
+interface ComparableItem {
+    isEqual(item: unknown): boolean;
+}
+export declare class UniqueObjectArray<T extends ComparableItem> implements Iterable<T> {
+    private items;
+    static fromArray<T extends ComparableItem>(array: T[]): UniqueObjectArray<T>;
+    includes(item: T): boolean;
+    push(item: T): boolean;
+    remove(item: T): boolean;
+    [Symbol.iterator](): Iterator<T>;
+    length(): number;
+    toArray(): T[];
+}
+export {};
+//# sourceMappingURL=UniqueObjectArray.d.ts.map

package/dist/value-objects/UniqueObjectArray.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueObjectArray.d.ts","sourceRoot":"","sources":["../../src/value-objects/UniqueObjectArray.ts"],"names":[],"mappings":"AAAA,UAAU,cAAc;IACtB,OAAO,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC;CACjC;AACD,qBAAa,iBAAiB,CAAC,CAAC,SAAS,cAAc,CACrD,YAAW,QAAQ,CAAC,CAAC,CAAC;IAEtB,OAAO,CAAC,KAAK,CAAW;WAEV,SAAS,CAAC,CAAC,SAAS,cAAc,EAC9C,KAAK,EAAE,CAAC,EAAE,GACT,iBAAiB,CAAC,CAAC,CAAC;IAShB,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAI1B,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAUtB,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,OAAO;IAYxB,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC;IAIhC,MAAM,IAAI,MAAM;IAIhB,OAAO,IAAI,CAAC,EAAE;CAGtB"}

package/dist/value-objects/UniqueObjectArray.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UniqueObjectArray = void 0;
+class UniqueObjectArray {
+    items = [];
+    static fromArray(array) {
+        const uniqueArray = new UniqueObjectArray();
+        for (const item of array) {
+            uniqueArray.push(item);
+        }
+        return uniqueArray;
+    }
+    includes(item) {
+        return this.items.some((one) => one.isEqual(item));
+    }
+    push(item) {
+        if (!this.includes(item)) {
+            this.items.push(item);
+            return true;
+        }
+        return false;
+    }
+    remove(item) {
+        const index = this.items.findIndex((one) => one.isEqual(item));
+        if (index !== -1) {
+            this.items.splice(index, 1);
+            return true;
+        }
+        return false;
+    }
+    [Symbol.iterator]() {
+        return this.items[Symbol.iterator]();
+    }
+    length() {
+        return this.items.length;
+    }
+    toArray() {
+        return Array.from(this.items);
+    }
+}
+exports.UniqueObjectArray = UniqueObjectArray;
+//# sourceMappingURL=UniqueObjectArray.js.map

package/dist/value-objects/UniqueObjectArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueObjectArray.js","sourceRoot":"","sources":["../../src/value-objects/UniqueObjectArray.ts"],"names":[],"mappings":";;;AAGA,MAAa,iBAAiB;IAGpB,KAAK,GAAQ,EAAE,CAAC;IAEjB,MAAM,CAAC,SAAS,CACrB,KAAU;QAEV,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAK,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,WAAW,CAAC;IACrB,CAAC;IAEM,QAAQ,CAAC,IAAO;QACrB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACrD,CAAC;IAEM,IAAI,CAAC,IAAO;QACjB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAEtB,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,MAAM,CAAC,IAAO;QACnB,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;QAE/D,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;YACjB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAE5B,OAAO,IAAI,CAAC;QACd,CAAC;QAED,OAAO,KAAK,CAAC;IACf,CAAC;IAEM,CAAC,MAAM,CAAC,QAAQ,CAAC;QACtB,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,CAAC;IAEM,MAAM;QACX,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC3B,CAAC;IAEM,OAAO;QACZ,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChC,CAAC;CACF;AArDD,8CAqDC"}

package/dist/value-objects/index.d.ts

@@ -12,5 +12,6 @@ export * from './NumberValueObject';
 export * from './PositiveNumber';
 export * from './StringValueObject';
 export * from './NullObject';
+export * from './UniqueObjectArray';
 export * from './ValueObject';
 //# sourceMappingURL=index.d.ts.map

package/dist/value-objects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC;AACzB,cAAc,OAAO,CAAC;AACtB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,WAAW,CAAC;AAC1B,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC"}

package/dist/value-objects/index.js

@@ -15,5 +15,6 @@ tslib_1.__exportStar(require("./NumberValueObject"), exports);
 tslib_1.__exportStar(require("./PositiveNumber"), exports);
 tslib_1.__exportStar(require("./StringValueObject"), exports);
 tslib_1.__exportStar(require("./NullObject"), exports);
+tslib_1.__exportStar(require("./UniqueObjectArray"), exports);
 tslib_1.__exportStar(require("./ValueObject"), exports);
 //# sourceMappingURL=index.js.map

package/dist/value-objects/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,mDAAyB;AACzB,mDAAyB;AACzB,gDAAsB;AACtB,kDAAwB;AACxB,iDAAuB;AACvB,kDAAwB;AACxB,kDAAwB;AACxB,iDAAuB;AACvB,oDAA0B;AAC1B,8DAAoC;AACpC,2DAAiC;AACjC,8DAAoC;AACpC,uDAA6B;AAC7B,wDAA8B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/value-objects/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,mDAAyB;AACzB,mDAAyB;AACzB,gDAAsB;AACtB,kDAAwB;AACxB,iDAAuB;AACvB,kDAAwB;AACxB,kDAAwB;AACxB,iDAAuB;AACvB,oDAA0B;AAC1B,8DAAoC;AACpC,2DAAiC;AACjC,8DAAoC;AACpC,uDAA6B;AAC7B,8DAAoC;AACpC,wDAA8B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@haskou/value-objects",
-  "version": "2.4.0",
+  "version": "2.5.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "files": [