@archtx/utils 6.0.0 → 6.1.1

package/dist/src/object-diff-paths.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Get the "lodash" paths of deep difference values between two objects or arrays.
+ *
+ * @param o1 {object|array}
+ * @param o2 {object|array}
+ * @param curPath {string}
+ * @param diffs {array<string>} ie: ["a.b.c.z", "a.c.[1].name"]
+ */
+export declare function objectDiffPaths(o1: Record<any, any> | any, o2: Record<any, any> | any, curPath?: string, diffs?: string[]): string[];

package/dist/src/object-diff-paths.js

@@ -0,0 +1,39 @@
+/**
+ * Get the "lodash" paths of deep difference values between two objects or arrays.
+ *
+ * @param o1 {object|array}
+ * @param o2 {object|array}
+ * @param curPath {string}
+ * @param diffs {array<string>} ie: ["a.b.c.z", "a.c.[1].name"]
+ */
+export function objectDiffPaths(o1, o2, curPath = '', diffs = []) {
+    if (typeof o1 !== typeof o2)
+        return curPath ? diffs.concat(curPath) : [];
+    if (typeof o1 !== 'object') {
+        if (o1 !== o2) {
+            diffs = curPath ? diffs.concat(curPath) : [];
+        }
+        return diffs;
+    }
+    const keys = unionKeys(o1, o2);
+    for (const key of keys) {
+        const isArr = Array.isArray(o1);
+        const path = curPath
+            ? curPath + '.' + (isArr ? '[' : '') + key + (isArr ? ']' : '')
+            : key;
+        diffs = objectDiffPaths(o1[key], o2[key], path, diffs);
+    }
+    return diffs;
+}
+function unionKeys(o1, o2) {
+    const keys = getKeys(o1).concat(getKeys(o2));
+    const o = keys.reduce((acc, cur) => {
+        acc[cur] = true;
+        return acc;
+    }, {});
+    return Object.keys(o);
+}
+function getKeys(o) {
+    return typeof o === 'undefined' || o === null ? [] : Object.keys(o);
+}
+//# sourceMappingURL=object-diff-paths.js.map

package/dist/src/object-diff-paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-diff-paths.js","sourceRoot":"","sources":["../../src/object-diff-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC7B,EAA0B,EAC1B,EAA0B,EAC1B,OAAO,GAAG,EAAE,EACZ,QAAkB,EAAE;IAEpB,IAAI,OAAO,EAAE,KAAK,OAAO,EAAE;QAAE,OAAO,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;IAExE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QAC3B,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACd,KAAK,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAA;QAC9C,CAAC;QAED,OAAO,KAAK,CAAA;IACd,CAAC;IAED,MAAM,IAAI,GAAG,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,CAAA;IAE9B,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;QAC/B,MAAM,IAAI,GAAG,OAAO;YAClB,CAAC,CAAC,OAAO,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/D,CAAC,CAAC,GAAG,CAAA;QACP,KAAK,GAAG,eAAe,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,CAAA;IACxD,CAAC;IAED,OAAO,KAAK,CAAA;AACd,CAAC;AAED,SAAS,SAAS,CAAC,EAAoB,EAAE,EAAoB;IAC3D,MAAM,IAAI,GAAG,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5C,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,GAAQ,EAAE,GAAG,EAAE,EAAE;QACtC,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAA;QAEf,OAAO,GAAG,CAAA;IACZ,CAAC,EAAE,EAAE,CAAC,CAAA;IACN,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACvB,CAAC;AAED,SAAS,OAAO,CAAC,CAAmB;IAClC,OAAO,OAAO,CAAC,KAAK,WAAW,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACrE,CAAC"}

package/dist/src/object-diff-paths.test.d.ts

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

package/dist/src/object-diff-paths.test.js

@@ -0,0 +1,141 @@
+import assert from 'assert';
+import { get } from 'lodash-es';
+import { objectDiffPaths } from './object-diff-paths.js';
+describe('object diff', () => {
+    it('different types', () => {
+        const o1 = 1;
+        const o2 = true;
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, []);
+    });
+    it('empty objects', () => {
+        const o1 = {};
+        const o2 = {};
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, []);
+    });
+    it('empty objects', () => {
+        const o1 = {};
+        const o2 = {};
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, []);
+    });
+    it('a single object entry is different', () => {
+        const o1 = {
+            a: {
+                b: {
+                    c: { s: 't' },
+                },
+            },
+        };
+        const o2 = { ...o1, a: { ...o1.a, b: { ...o1.a.b, d: 'e' } } };
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, ['a.b.d']);
+    });
+    it('null vs undefined', () => {
+        const o1 = {
+            foo: null,
+        };
+        const o2 = {
+            foo: undefined,
+        };
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, ['foo']);
+    });
+    it('entries are missing/different from each objects', () => {
+        const o1 = {
+            a: {
+                b: {
+                    fn: () => 4,
+                    arr: [1, 2, 3],
+                    c: {
+                        s: 't',
+                        y: 'g',
+                    },
+                },
+            },
+        };
+        const o2 = {
+            ...o1,
+            a: {
+                ...o1.a,
+                b: {
+                    ...o1.a.b,
+                    fn: () => 4,
+                    arr: [1, 2, 3, 4, 5],
+                    c: { s: 'e', t: 'e' },
+                },
+            },
+        };
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, [
+            'a.b.fn',
+            'a.b.arr.[3]',
+            'a.b.arr.[4]',
+            'a.b.c.s',
+            'a.b.c.y',
+            'a.b.c.t',
+        ]);
+    });
+    it('nested arrays', () => {
+        const o1 = {
+            a: {
+                arr: [
+                    1,
+                    [{ one: 1, two: 1 }],
+                    {
+                        foo: 'bar',
+                    },
+                    4,
+                ],
+            },
+        };
+        const o2 = {
+            ...o1,
+            a: {
+                ...o1.a,
+                arr: [
+                    1,
+                    [{ one: 2, two: 2 }],
+                    {
+                        foo: 'bar',
+                    },
+                    4,
+                ],
+            },
+        };
+        const diff = objectDiffPaths(o1, o2);
+        assert.deepEqual(diff, ['a.arr.[1].[0].one', 'a.arr.[1].[0].two']);
+    });
+    it('lodash compatibility', () => {
+        const o1 = {
+            a: {
+                arr: [
+                    1,
+                    [{ one: 1, two: 1 }],
+                    {
+                        foo: 'bar',
+                    },
+                    4,
+                ],
+            },
+        };
+        const o2 = {
+            ...o1,
+            a: {
+                ...o1.a,
+                arr: [
+                    1,
+                    [{ one: 42, two: 2 }],
+                    {
+                        foo: 'bar',
+                    },
+                    4,
+                ],
+            },
+        };
+        const diff = objectDiffPaths(o1, o2);
+        assert.equal(get(o2, diff[0]), 42);
+    });
+});
+//# sourceMappingURL=object-diff-paths.test.js.map

package/dist/src/object-diff-paths.test.js.map

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

package/dist/src/object-values-to-dot-notation.d.ts

@@ -0,0 +1 @@
+export declare const objectValuesToDotNotation: (obj: Record<string, unknown>) => [string, unknown][];

package/dist/src/object-values-to-dot-notation.js

@@ -0,0 +1,23 @@
+// credit: https://github.com/segment-boneyard/tableize
+function tableize(obj) {
+    const ret = {};
+    type(ret, obj, '');
+    return ret;
+}
+function type(schema, obj, prefix) {
+    Object.keys(obj).forEach((key) => {
+        const val = obj[key];
+        key = prefix + key;
+        if (typeof val === 'object') {
+            type(schema, val, key + '.');
+        }
+        else {
+            schema[key] = val;
+        }
+    });
+}
+export const objectValuesToDotNotation = (obj) => {
+    const results = tableize(obj);
+    return Object.entries(results);
+};
+//# sourceMappingURL=object-values-to-dot-notation.js.map

package/dist/src/object-values-to-dot-notation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-values-to-dot-notation.js","sourceRoot":"","sources":["../../src/object-values-to-dot-notation.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,SAAS,QAAQ,CAAC,GAA4B;IAC5C,MAAM,GAAG,GAAG,EAAE,CAAA;IACd,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAA;IAClB,OAAO,GAAG,CAAA;AACZ,CAAC;AAED,SAAS,IAAI,CACX,MAA+B,EAC/B,GAA4B,EAC5B,MAAc;IAEd,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;QAC/B,MAAM,GAAG,GAAQ,GAAG,CAAC,GAAG,CAAC,CAAA;QAEzB,GAAG,GAAG,MAAM,GAAG,GAAG,CAAA;QAElB,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,GAAG,CAAC,CAAA;QAC9B,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,GAAG,GAAG,CAAA;QACnB,CAAC;IACH,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,yBAAyB,GAAG,CACvC,GAA4B,EACP,EAAE;IACvB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAA;IAE7B,OAAO,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,CAAA;AAChC,CAAC,CAAA"}

package/dist/src/object-values-to-dot-notation.test.d.ts

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

package/dist/src/object-values-to-dot-notation.test.js

@@ -0,0 +1,21 @@
+import { objectValuesToDotNotation } from './object-values-to-dot-notation.js';
+describe('objectValuesToDotNotation', () => {
+    it('converts an object to dot notation', () => {
+        const anpObj = {
+            admin: {
+                permissions: {
+                    manageOrganization: true,
+                },
+            },
+            ops: {
+                access: {
+                    canViewOtherUsers: true
+                }
+            }
+        };
+        const result = objectValuesToDotNotation(anpObj);
+        expect(result[0]).toEqual(['admin.permissions.manageOrganization', true]);
+        expect(result[1]).toEqual(['ops.access.canViewOtherUsers', true]);
+    });
+});
+//# sourceMappingURL=object-values-to-dot-notation.test.js.map

package/dist/src/object-values-to-dot-notation.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-values-to-dot-notation.test.js","sourceRoot":"","sources":["../../src/object-values-to-dot-notation.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAA;AAE9E,QAAQ,CAAC,2BAA2B,EAAE,GAAG,EAAE;IACzC,EAAE,CAAC,oCAAoC,EAAE,GAAG,EAAE;QAC5C,MAAM,MAAM,GAAG;YACb,KAAK,EAAE;gBACL,WAAW,EAAE;oBACX,kBAAkB,EAAE,IAAI;iBACzB;aACF;YACD,GAAG,EAAE;gBACH,MAAM,EAAE;oBACN,iBAAiB,EAAE,IAAI;iBACxB;aACF;SACF,CAAA;QAED,MAAM,MAAM,GAAG,yBAAyB,CAAC,MAAM,CAAC,CAAA;QAEhD,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,sCAAsC,EAAE,IAAI,CAAC,CAAC,CAAA;QACzE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,8BAA8B,EAAE,IAAI,CAAC,CAAC,CAAA;IACnE,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/src/object.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Checks an object for a property and that it's not undefined.
+ * @param obj
+ * @param key
+ */
+export declare function hasPropertyDefined(obj: Record<string, any>, key: string): boolean;
+export declare function removeUndefined(obj: Record<any, any>): Partial<Record<any, any>>;

package/dist/src/object.js

@@ -0,0 +1,19 @@
+import clean from 'clean-deep';
+/**
+ * Checks an object for a property and that it's not undefined.
+ * @param obj
+ * @param key
+ */
+export function hasPropertyDefined(obj, key) {
+    return key in obj && obj[key] !== undefined;
+}
+export function removeUndefined(obj) {
+    return clean.default(obj, {
+        emptyArrays: false,
+        emptyObjects: false,
+        NaNValues: true,
+        nullValues: false,
+        undefinedValues: true,
+    });
+}
+//# sourceMappingURL=object.js.map

package/dist/src/object.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object.js","sourceRoot":"","sources":["../../src/object.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,YAAY,CAAA;AAE9B;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAwB,EAAE,GAAW;IACtE,OAAO,GAAG,IAAI,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,CAAA;AAC7C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,GAAqB;IACnD,OAAO,KAAK,CAAC,OAAO,CAAC,GAAG,EAAE;QACxB,WAAW,EAAE,KAAK;QAClB,YAAY,EAAE,KAAK;QACnB,SAAS,EAAE,IAAI;QACf,UAAU,EAAE,KAAK;QACjB,eAAe,EAAE,IAAI;KACtB,CAAC,CAAA;AACJ,CAAC"}

package/dist/src/random-color.d.ts

@@ -0,0 +1 @@
+export declare function randomHEXColor(): string;

package/dist/src/random-color.js

@@ -0,0 +1,4 @@
+export function randomHEXColor() {
+    return '#' + ((Math.random() * 0xffffff) << 0).toString(16).padStart(6, '0');
+}
+//# sourceMappingURL=random-color.js.map

package/dist/src/random-color.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-color.js","sourceRoot":"","sources":["../../src/random-color.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc;IAC5B,OAAO,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAA;AAC9E,CAAC"}

package/dist/src/sanitize-obj-props.d.ts

@@ -0,0 +1 @@
+export declare function sanitizeObjProps<Props>(allowedProperties: string[], props: Props): Props;

package/dist/src/sanitize-obj-props.js

@@ -0,0 +1,5 @@
+import { pick } from 'lodash-es';
+export function sanitizeObjProps(allowedProperties, props) {
+    return pick(props, allowedProperties);
+}
+//# sourceMappingURL=sanitize-obj-props.js.map

package/dist/src/sanitize-obj-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-obj-props.js","sourceRoot":"","sources":["../../src/sanitize-obj-props.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEhC,MAAM,UAAU,gBAAgB,CAC9B,iBAA2B,EAC3B,KAAY;IAEZ,OAAO,IAAI,CAAC,KAAK,EAAE,iBAAiB,CAAU,CAAA;AAChD,CAAC"}

package/dist/src/sleep.d.ts

@@ -0,0 +1 @@
+export declare const sleep: (ms?: number) => Promise<unknown>;

package/dist/src/sleep.js

@@ -0,0 +1,6 @@
+export const sleep = (ms = 0) => new Promise((resolve) => {
+    setTimeout(() => {
+        resolve(true);
+    }, ms);
+});
+//# sourceMappingURL=sleep.js.map

package/dist/src/sleep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sleep.js","sourceRoot":"","sources":["../../src/sleep.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,GAAE,CAAC,EAAE,EAAE,CAC7B,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;IACtB,UAAU,CAAC,GAAG,EAAE;QACd,OAAO,CAAC,IAAI,CAAC,CAAA;IACf,CAAC,EAAE,EAAE,CAAC,CAAA;AACR,CAAC,CAAC,CAAA"}

package/dist/src/strings/is-email.d.ts

@@ -0,0 +1 @@
+export declare function isEmail(email: string): boolean;

package/dist/src/strings/is-email.js

@@ -0,0 +1,5 @@
+export function isEmail(email) {
+    const re = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+    return re.test(String(email).trim().toLowerCase());
+}
+//# sourceMappingURL=is-email.js.map

package/dist/src/strings/is-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-email.js","sourceRoot":"","sources":["../../../src/strings/is-email.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,EAAE,GACN,uJAAuJ,CAAA;IACzJ,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/src/strings/is-url.d.ts

@@ -0,0 +1 @@
+export declare function isUrl(str: string): boolean;

package/dist/src/strings/is-url.js

@@ -0,0 +1,10 @@
+export function isUrl(str) {
+    const pattern = new RegExp('^(https?:\\/\\/)?' + // protocol
+        '((([a-z\\d]([a-z\\d-]*[a-z\\d])*)\\.)+[a-z]{2,}|' + // modules name
+        '((\\d{1,3}\\.){3}\\d{1,3}))' + // OR ip (v4) address
+        '(\\:\\d+)?(\\/[-a-z\\d%_.~+]*)*' + // port and path
+        '(\\?[;&a-z\\d%_.~+=-]*)?' + // query string
+        '(\\#[-a-z\\d_]*)?$', 'i');
+    return !!pattern.test(str);
+}
+//# sourceMappingURL=is-url.js.map

package/dist/src/strings/is-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-url.js","sourceRoot":"","sources":["../../../src/strings/is-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,mBAAmB,GAAG,WAAW;QAC/B,kDAAkD,GAAG,eAAe;QACpE,6BAA6B,GAAG,qBAAqB;QACrD,iCAAiC,GAAG,gBAAgB;QACpD,0BAA0B,GAAG,eAAe;QAC5C,oBAAoB,EACtB,GAAG,CACJ,CAAA;IAED,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}

package/dist/src/strings/make-uuid.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This func is used by Entities to create `id` fields, some Entities embed the OrganizationEntity's `id` in their
+ * own `id`, in these cases, the `organizationId` is passed as an arg. The position of the embedded organizationId
+ * should always be last.
+ *
+ * The default size we implement here is 14 char,
+ *
+ * Note: for size, check the collision probability calculator: https://zelark.github.io/nano-id-cc/
+ *
+ * @param prefix
+ * @param opts
+ */
+export declare const makeUuid: (prefix?: string | number, opts?: {
+    postfix?: string;
+    size?: number;
+}) => string;

package/dist/src/strings/make-uuid.js

@@ -0,0 +1,25 @@
+import { customAlphabet } from 'nanoid';
+const CUSTOM_ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz-';
+const generator = customAlphabet(CUSTOM_ALPHABET, 20);
+/**
+ * This func is used by Entities to create `id` fields, some Entities embed the OrganizationEntity's `id` in their
+ * own `id`, in these cases, the `organizationId` is passed as an arg. The position of the embedded organizationId
+ * should always be last.
+ *
+ * The default size we implement here is 14 char,
+ *
+ * Note: for size, check the collision probability calculator: https://zelark.github.io/nano-id-cc/
+ *
+ * @param prefix
+ * @param opts
+ */
+export const makeUuid = (prefix, opts) => {
+    const prfx = prefix || '';
+    const psfx = opts?.postfix ? `${opts?.postfix}` : '';
+    // no spaces or line-breaks allowed
+    // The only special chars allowed are "-" and "_"
+    return `${prfx}${generator(opts?.size)}${psfx}`
+        .trim()
+        .replace(/[^a-zA-Z0-9\-_]/g, '');
+};
+//# sourceMappingURL=make-uuid.js.map

package/dist/src/strings/make-uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-uuid.js","sourceRoot":"","sources":["../../../src/strings/make-uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAEvC,MAAM,eAAe,GACnB,kEAAkE,CAAA;AACpE,MAAM,SAAS,GAAG,cAAc,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAwB,EACxB,IAA0C,EAC1C,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEpD,mCAAmC;IACnC,iDAAiD;IACjD,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;SAC5C,IAAI,EAAE;SACN,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;AACpC,CAAC,CAAA"}

package/dist/src/strings/obfuscate-string.d.ts

@@ -0,0 +1,21 @@
+type ObfuscatedString = string;
+export declare function isObfuscatedString(str: string): boolean;
+/**
+ * This function is used to obfuscate a string so that it can be used in a URL
+ * and is not easily guessable.
+ *
+ * @note this function earmarks an obfuscated string with a prefix to identify
+ * it as an obfuscated string. This is useful for when you need to determine
+ * whether a string is obfuscated or not.
+ */
+export declare function obfuscateString(str: string): ObfuscatedString;
+/**
+ * This function is used to de-obfuscate a string that was obfuscated using
+ * the obfuscateString function.
+ *
+ * @note this function will throw an error if the string is not obfuscated
+ */
+export declare function deObfuscateString(obufscatedString: ObfuscatedString, opts?: {
+    throw?: boolean;
+}): string;
+export {};

package/dist/src/strings/obfuscate-string.js

@@ -0,0 +1,46 @@
+import { ParamError } from '@archtx/core';
+const OBFUSCATED_STRING_PREFIX = 'oBfSs';
+export function isObfuscatedString(str) {
+    return str.startsWith(OBFUSCATED_STRING_PREFIX);
+}
+/**
+ * This function is used to obfuscate a string so that it can be used in a URL
+ * and is not easily guessable.
+ *
+ * @note this function earmarks an obfuscated string with a prefix to identify
+ * it as an obfuscated string. This is useful for when you need to determine
+ * whether a string is obfuscated or not.
+ */
+export function obfuscateString(str) {
+    if (!str)
+        throw new ParamError('obfuscateString str is required');
+    if (isObfuscatedString(str))
+        throw new ParamError('obfuscateString str is already obfuscated');
+    const encoded = Buffer.from(str).toString('base64');
+    return (OBFUSCATED_STRING_PREFIX +
+        encoded.replace('+', '-').replace('/', '_').replace(/=+$/g, ''));
+}
+/**
+ * This function is used to de-obfuscate a string that was obfuscated using
+ * the obfuscateString function.
+ *
+ * @note this function will throw an error if the string is not obfuscated
+ */
+export function deObfuscateString(obufscatedString, opts = { throw: true }) {
+    if (!obufscatedString)
+        throw new ParamError('deObfuscateString string is required');
+    if (!isObfuscatedString(obufscatedString)) {
+        if (opts?.throw) {
+            throw new ParamError('obfuscateString str is already obfuscated');
+        }
+        else {
+            return obufscatedString;
+        }
+    }
+    // remove the earmark prefix
+    obufscatedString = obufscatedString.replace(OBFUSCATED_STRING_PREFIX, '');
+    obufscatedString += Array(5 - (obufscatedString.length % 4)).join('=');
+    obufscatedString = obufscatedString.replace('-', '+').replace('_', '/');
+    return Buffer.from(obufscatedString, 'base64').toString();
+}
+//# sourceMappingURL=obfuscate-string.js.map

package/dist/src/strings/obfuscate-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscate-string.js","sourceRoot":"","sources":["../../../src/strings/obfuscate-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,wBAAwB,GAAG,OAAO,CAAA;AAExC,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAA;IAEjE,IAAI,kBAAkB,CAAC,GAAG,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,2CAA2C,CAC5C,CAAA;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEnD,OAAO,CACL,wBAAwB;QACxB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAChE,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAkC,EAClC,OAA4B,EAAE,KAAK,EAAE,IAAI,EAAE;IAE3C,IAAI,CAAC,gBAAgB;QACnB,MAAM,IAAI,UAAU,CAAC,sCAAsC,CAAC,CAAA;IAE9D,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAClB,2CAA2C,CAC5C,CAAA;QACH,CAAC;aAAM,CAAC;YACN,OAAO,gBAAgB,CAAA;QACzB,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAA;IAEzE,gBAAgB,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEtE,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAEvE,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC3D,CAAC"}

package/dist/src/strings/pluralize.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @example pluralize('Location', 3) // "Locations"
+ * @example pluralize(['Entry', 'Entries'], 2) // "Entries"
+ */
+export declare function pluralize(txt: string | string[], count?: number): string;

package/dist/src/strings/pluralize.js

@@ -0,0 +1,17 @@
+/**
+ * @example pluralize('Location', 3) // "Locations"
+ * @example pluralize(['Entry', 'Entries'], 2) // "Entries"
+ */
+export function pluralize(txt, count = 0) {
+    if (count > 1) {
+        if (Array.isArray(txt)) {
+            return txt[1];
+        }
+        return txt + 's';
+    }
+    if (Array.isArray(txt)) {
+        return txt[0];
+    }
+    return txt;
+}
+//# sourceMappingURL=pluralize.js.map

package/dist/src/strings/pluralize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize.js","sourceRoot":"","sources":["../../../src/strings/pluralize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAsB,EAAE,KAAK,GAAE,CAAC;IACxD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;QACf,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,CAAA;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;IACf,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/src/strings/reproducible-hash.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This function creates a reproducible hash from a given string input.
+ * @param input
+ */
+export declare function createReproducibleHash(input: string): string;

package/dist/src/strings/reproducible-hash.js

@@ -0,0 +1,23 @@
+/**
+ * This function creates a reproducible hash from a given string input.
+ * @param input
+ */
+export function createReproducibleHash(input) {
+    // Simple implementation using a common string hashing algorithm
+    let hash = 0;
+    const prime = 31;
+    // Handle empty string
+    if (input.length === 0) {
+        return '0';
+    }
+    // Apply hashing algorithm
+    for (let i = 0; i < input.length; i++) {
+        // Get char code
+        const char = input.charCodeAt(i);
+        // Apply prime multiplication and add char code
+        hash = (hash * prime + char) & 0xffffffff;
+    }
+    // Convert to hex string
+    return hash.toString(16);
+}
+//# sourceMappingURL=reproducible-hash.js.map

package/dist/src/strings/reproducible-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproducible-hash.js","sourceRoot":"","sources":["../../../src/strings/reproducible-hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,gEAAgE;IAChE,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,MAAM,KAAK,GAAG,EAAE,CAAA;IAEhB,sBAAsB;IACtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,0BAA0B;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,gBAAgB;QAChB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChC,+CAA+C;QAC/C,IAAI,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,UAAU,CAAA;IAC3C,CAAC;IAED,wBAAwB;IACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AAC1B,CAAC"}

package/dist/src/timeout.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Invokes a callback function after a specified timeout.
+ *
+ * @param {function} callback - The callback function to be invoked after the timeout.
+ * @param {number} timeoutMs - The timeout duration in milliseconds.
+ * @return {Promise<function>} A promise that resolves to a function that can be called to cancel the timeout.
+ */
+export declare function timeout(callback: () => void, timeoutMs: number): Promise<() => void>;

package/dist/src/timeout.js

@@ -0,0 +1,14 @@
+/**
+ * Invokes a callback function after a specified timeout.
+ *
+ * @param {function} callback - The callback function to be invoked after the timeout.
+ * @param {number} timeoutMs - The timeout duration in milliseconds.
+ * @return {Promise<function>} A promise that resolves to a function that can be called to cancel the timeout.
+ */
+export async function timeout(callback, timeoutMs) {
+    const clearTimer = setTimeout(callback, timeoutMs);
+    return () => {
+        clearTimeout(clearTimer);
+    };
+}
+//# sourceMappingURL=timeout.js.map

package/dist/src/timeout.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeout.js","sourceRoot":"","sources":["../../src/timeout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,QAAoB,EACpB,SAAiB;IAEjB,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAA;IAElD,OAAO,GAAG,EAAE;QACV,YAAY,CAAC,UAAU,CAAC,CAAA;IAC1B,CAAC,CAAA;AACH,CAAC"}

package/dist/src/undefined-default.d.ts

@@ -0,0 +1 @@
+export declare const undefinedDefault: (value: any, defaultValue: any) => any;

package/dist/src/undefined-default.js

@@ -0,0 +1,2 @@
+export const undefinedDefault = (value, defaultValue) => typeof value === 'undefined' ? defaultValue : value;
+//# sourceMappingURL=undefined-default.js.map

package/dist/src/undefined-default.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"undefined-default.js","sourceRoot":"","sources":["../../src/undefined-default.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,KAAU,EAAE,YAAiB,EAAE,EAAE,CAC9D,OAAO,KAAK,KAAK,WAAW,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,CAAA"}