@acmekit/utils 2.13.1

package/dist/common/create-container-like.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createContainerLike = createContainerLike;
+function createContainerLike(obj) {
+    return {
+        resolve(key, { allowUnregistered = false, } = {}) {
+            if (allowUnregistered) {
+                try {
+                    return obj[key];
+                }
+                catch (error) {
+                    return undefined;
+                }
+            }
+            return obj[key];
+        },
+    };
+}
+//# sourceMappingURL=create-container-like.js.map

package/dist/common/create-container-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-container-like.js","sourceRoot":"","sources":["../../src/common/create-container-like.ts"],"names":[],"mappings":";;AAEA,kDAqBC;AArBD,SAAgB,mBAAmB,CAAC,GAAG;IACrC,OAAO;QACL,OAAO,CACL,GAAW,EACX,EACE,iBAAiB,GAAG,KAAK,MAGvB,EAAE;YAEN,IAAI,iBAAiB,EAAE,CAAC;gBACtB,IAAI,CAAC;oBACH,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;gBACjB,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,OAAO,SAAS,CAAA;gBAClB,CAAC;YACH,CAAC;YAED,OAAO,GAAG,CAAC,GAAG,CAAC,CAAA;QACjB,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/common/create-psql-index-helper.d.ts

@@ -0,0 +1,45 @@
+import { Index } from "@acmekit/deps/mikro-orm/core";
+/**
+ * Create a PSQL index statement
+ * @param name The name of the index, if not provided it will be generated in the format IDX_tableName_columnName
+ * @param tableName The name of the table
+ * @param columns The columns to index
+ * @param type The type of index (e.g GIN, GIST, BTREE, etc)
+ * @param where The where clause
+ * @param unique If the index should be a unique index
+ *
+ * @example
+ * createPsqlIndexStatementHelper({
+ *   name: "idx_user_email",
+ *   tableName: "user",
+ *   columns: "email",
+ *   type: "btree",
+ *   where: "email IS NOT NULL"
+ * });
+ *
+ * // expression:  CREATE INDEX IF NOT EXISTS idx_user_email ON user USING btree (email) WHERE email IS NOT NULL;
+ *
+ * createPsqlIndexStatementHelper({
+ *   name: "idx_user_email",
+ *   tableName: "user",
+ *   columns: "email"
+ * });
+ *
+ * // expression: CREATE INDEX IF NOT EXISTS idx_user_email ON user (email);
+ *
+ */
+export declare function createPsqlIndexStatementHelper({ name, tableName: qualifiedName, columns, type, where, unique, }: {
+    name?: string;
+    tableName: string;
+    columns: string | string[];
+    type?: string;
+    where?: string;
+    unique?: boolean;
+}): {
+    toString: () => string;
+    valueOf: () => string;
+    name: string;
+    expression: string;
+    MikroORMIndex: (options?: Parameters<typeof Index>[0]) => (target: object, propertyName?: undefined) => any;
+};
+//# sourceMappingURL=create-psql-index-helper.d.ts.map

package/dist/common/create-psql-index-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-psql-index-helper.d.ts","sourceRoot":"","sources":["../../src/common/create-psql-index-helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,8BAA8B,CAAA;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,8BAA8B,CAAC,EAC7C,IAAI,EACJ,SAAS,EAAE,aAAa,EACxB,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,GACP,EAAE;IACD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;;;;;8BAoC6B,UAAU,CAAC,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC;EAQxD"}

package/dist/common/create-psql-index-helper.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPsqlIndexStatementHelper = createPsqlIndexStatementHelper;
+const core_1 = require("@acmekit/deps/mikro-orm/core");
+/**
+ * Create a PSQL index statement
+ * @param name The name of the index, if not provided it will be generated in the format IDX_tableName_columnName
+ * @param tableName The name of the table
+ * @param columns The columns to index
+ * @param type The type of index (e.g GIN, GIST, BTREE, etc)
+ * @param where The where clause
+ * @param unique If the index should be a unique index
+ *
+ * @example
+ * createPsqlIndexStatementHelper({
+ *   name: "idx_user_email",
+ *   tableName: "user",
+ *   columns: "email",
+ *   type: "btree",
+ *   where: "email IS NOT NULL"
+ * });
+ *
+ * // expression:  CREATE INDEX IF NOT EXISTS idx_user_email ON user USING btree (email) WHERE email IS NOT NULL;
+ *
+ * createPsqlIndexStatementHelper({
+ *   name: "idx_user_email",
+ *   tableName: "user",
+ *   columns: "email"
+ * });
+ *
+ * // expression: CREATE INDEX IF NOT EXISTS idx_user_email ON user (email);
+ *
+ */
+function createPsqlIndexStatementHelper({ name, tableName: qualifiedName, columns, type, where, unique, }) {
+    const columnsName = Array.isArray(columns) ? columns.join("_") : columns;
+    const tokens = qualifiedName.replace(/"/g, "").split(".");
+    let pgSchemaName;
+    let tableName;
+    let tableReference;
+    if (tokens.length > 1) {
+        pgSchemaName = tokens.shift();
+        tableName = tokens.join(".");
+        tableReference = `"${pgSchemaName}"."${tableName}"`;
+    }
+    else {
+        tableName = qualifiedName;
+        tableReference = `"${tableName}"`;
+    }
+    columns = Array.isArray(columns)
+        ? columns.map((column) => `"${column}"`).join(", ")
+        : columns;
+    name = name || `IDX_${tableName}_${columnsName}${unique ? "_unique" : ""}`;
+    const typeStr = type ? ` USING ${type}` : "";
+    const optionsStr = where ? ` WHERE ${where}` : "";
+    const uniqueStr = unique ? "UNIQUE " : "";
+    const expression = `CREATE ${uniqueStr}INDEX IF NOT EXISTS "${name}" ON ${tableReference}${typeStr} (${columns})${optionsStr}`;
+    return {
+        toString: () => {
+            return expression;
+        },
+        valueOf: () => {
+            return expression;
+        },
+        name,
+        expression,
+        MikroORMIndex: (options) => {
+            return (0, core_1.Index)({
+                name,
+                expression,
+                ...options,
+            });
+        },
+    };
+}
+//# sourceMappingURL=create-psql-index-helper.js.map

package/dist/common/create-psql-index-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-psql-index-helper.js","sourceRoot":"","sources":["../../src/common/create-psql-index-helper.ts"],"names":[],"mappings":";;AA+BA,wEA0DC;AAzFD,uDAAoD;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,SAAgB,8BAA8B,CAAC,EAC7C,IAAI,EACJ,SAAS,EAAE,aAAa,EACxB,OAAO,EACP,IAAI,EACJ,KAAK,EACL,MAAM,GAQP;IACC,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAA;IACxE,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;IAEzD,IAAI,YAAgC,CAAA;IACpC,IAAI,SAAiB,CAAA;IACrB,IAAI,cAAsB,CAAA;IAE1B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,YAAY,GAAG,MAAM,CAAC,KAAK,EAAE,CAAA;QAC7B,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAC5B,cAAc,GAAG,IAAI,YAAY,MAAM,SAAS,GAAG,CAAA;IACrD,CAAC;SAAM,CAAC;QACN,SAAS,GAAG,aAAa,CAAA;QACzB,cAAc,GAAG,IAAI,SAAS,GAAG,CAAA;IACnC,CAAC;IAED,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAC9B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;QACnD,CAAC,CAAC,OAAO,CAAA;IACX,IAAI,GAAG,IAAI,IAAI,OAAO,SAAS,IAAI,WAAW,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IAE1E,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC5C,MAAM,UAAU,GAAG,KAAK,CAAC,CAAC,CAAC,UAAU,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjD,MAAM,SAAS,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAA;IAEzC,MAAM,UAAU,GAAG,UAAU,SAAS,wBAAwB,IAAI,QAAQ,cAAc,GAAG,OAAO,KAAK,OAAO,IAAI,UAAU,EAAE,CAAA;IAC9H,OAAO;QACL,QAAQ,EAAE,GAAG,EAAE;YACb,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,OAAO,EAAE,GAAG,EAAE;YACZ,OAAO,UAAU,CAAA;QACnB,CAAC;QACD,IAAI;QACJ,UAAU;QACV,aAAa,EAAE,CAAC,OAAqC,EAAE,EAAE;YACvD,OAAO,IAAA,YAAK,EAAC;gBACX,IAAI;gBACJ,UAAU;gBACV,GAAG,OAAO;aACX,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/common/deduplicate.d.ts

@@ -0,0 +1,2 @@
+export declare function deduplicate<T = any>(collection: T[]): T[];
+//# sourceMappingURL=deduplicate.d.ts.map

package/dist/common/deduplicate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicate.d.ts","sourceRoot":"","sources":["../../src/common/deduplicate.ts"],"names":[],"mappings":"AAAA,wBAAgB,WAAW,CAAC,CAAC,GAAG,GAAG,EAAE,UAAU,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,CAEzD"}

package/dist/common/deduplicate.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deduplicate = deduplicate;
+function deduplicate(collection) {
+    return [...new Set(collection)];
+}
+//# sourceMappingURL=deduplicate.js.map

package/dist/common/deduplicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deduplicate.js","sourceRoot":"","sources":["../../src/common/deduplicate.ts"],"names":[],"mappings":";;AAAA,kCAEC;AAFD,SAAgB,WAAW,CAAU,UAAe;IAClD,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAA;AACjC,CAAC"}

package/dist/common/deep-copy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * In most casees, JSON.parse(JSON.stringify(obj)) is enough to deep copy an object.
+ * But in some cases, it's not enough. For example, if the object contains a function or a proxy, it will be lost after JSON.parse(JSON.stringify(obj)).
+ *
+ * @param obj
+ * @param cache
+ */
+export declare function deepCopy<T extends Record<any, any> | Record<any, any>[] = Record<any, any>, TOutput = T extends [] ? T[] : T>(obj: T, cache?: WeakMap<object, any>): TOutput;
+//# sourceMappingURL=deep-copy.d.ts.map

package/dist/common/deep-copy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-copy.d.ts","sourceRoot":"","sources":["../../src/common/deep-copy.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CACtB,CAAC,SAAS,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAClE,OAAO,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,EAAE,GAAG,CAAC,EAChC,GAAG,EAAE,CAAC,EAAE,KAAK,uBAAgB,GAAG,OAAO,CA0CxC"}

package/dist/common/deep-copy.js

@@ -0,0 +1,81 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepCopy = deepCopy;
+const is_object_1 = require("./is-object");
+const util = __importStar(require("node:util"));
+/**
+ * In most casees, JSON.parse(JSON.stringify(obj)) is enough to deep copy an object.
+ * But in some cases, it's not enough. For example, if the object contains a function or a proxy, it will be lost after JSON.parse(JSON.stringify(obj)).
+ *
+ * @param obj
+ * @param cache
+ */
+function deepCopy(obj, cache = new WeakMap()) {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    // Handle circular references with cache
+    if (cache.has(obj)) {
+        return cache.get(obj);
+    }
+    let copy;
+    // Handle arrays
+    if (Array.isArray(obj)) {
+        copy = [];
+        cache.set(obj, copy) // Add to cache before recursing
+        ;
+        obj.forEach((item, index) => {
+            ;
+            copy[index] = deepCopy(item, cache);
+        });
+        return copy;
+    }
+    if (util.types.isProxy(obj)) {
+        return obj;
+    }
+    // Handle objects
+    if ((0, is_object_1.isObject)(obj)) {
+        copy = {};
+        cache.set(obj, copy); // Add to cache before recursing
+        Object.keys(obj).forEach((key) => {
+            ;
+            copy[key] = deepCopy(obj[key], cache);
+        });
+        return copy;
+    }
+    return obj;
+}
+//# sourceMappingURL=deep-copy.js.map

package/dist/common/deep-copy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-copy.js","sourceRoot":"","sources":["../../src/common/deep-copy.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAUA,4BA6CC;AAvDD,2CAAsC;AACtC,gDAAiC;AAEjC;;;;;;GAMG;AACH,SAAgB,QAAQ,CAGtB,GAAM,EAAE,KAAK,GAAG,IAAI,OAAO,EAAE;IAC7B,IAAI,GAAG,KAAK,IAAI,IAAI,OAAO,GAAG,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,GAAc,CAAA;IACvB,CAAC;IAED,wCAAwC;IACxC,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAY,CAAA;IAClC,CAAC;IAED,IAAI,IAAa,CAAA;IAEjB,gBAAgB;IAChB,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,IAAI,GAAG,EAAwB,CAAA;QAC/B,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,gCAAgC;SACpD;QAAC,GAAkB,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;YAC3C,CAAC;YAAC,IAAmB,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,CAAA;QACtD,CAAC,CAAC,CAAA;QACF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC5B,OAAO,GAAyB,CAAA;IAClC,CAAC;IAED,iBAAiB;IACjB,IAAI,IAAA,oBAAQ,EAAC,GAAG,CAAC,EAAE,CAAC;QAClB,IAAI,GAAG,EAAa,CAAA;QACpB,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAA,CAAC,gCAAgC;QAErD,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC/B,CAAC;YAAC,IAAyB,CAAC,GAAG,CAAC,GAAG,QAAQ,CACxC,GAAwB,CAAC,GAAG,CAAC,EAC9B,KAAK,CACN,CAAA;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,GAAc,CAAA;AACvB,CAAC"}

package/dist/common/deep-equal-obj.d.ts

@@ -0,0 +1,2 @@
+export declare function deepEqualObj(obj1: unknown, obj2: unknown): boolean;
+//# sourceMappingURL=deep-equal-obj.d.ts.map

package/dist/common/deep-equal-obj.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal-obj.d.ts","sourceRoot":"","sources":["../../src/common/deep-equal-obj.ts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CA2BlE"}

package/dist/common/deep-equal-obj.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepEqualObj = deepEqualObj;
+function deepEqualObj(obj1, obj2) {
+    if (typeof obj1 !== typeof obj2) {
+        return false;
+    }
+    if (typeof obj1 !== "object" || obj1 === null) {
+        return obj1 === obj2;
+    }
+    if (typeof obj2 !== "object" || obj2 === null) {
+        return obj2 === obj1;
+    }
+    const obj1Keys = Object.keys(obj1);
+    const obj2Keys = Object.keys(obj2);
+    if (obj1Keys.length !== obj2Keys.length) {
+        return false;
+    }
+    for (const key of obj1Keys) {
+        if (!obj2Keys.includes(key) || !deepEqualObj(obj1[key], obj2[key])) {
+            return false;
+        }
+    }
+    return true;
+}
+//# sourceMappingURL=deep-equal-obj.js.map

package/dist/common/deep-equal-obj.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-equal-obj.js","sourceRoot":"","sources":["../../src/common/deep-equal-obj.ts"],"names":[],"mappings":";;AAAA,oCA2BC;AA3BD,SAAgB,YAAY,CAAC,IAAa,EAAE,IAAa;IACvD,IAAI,OAAO,IAAI,KAAK,OAAO,IAAI,EAAE,CAAC;QAChC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,KAAK,IAAI,CAAA;IACtB,CAAC;IAED,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAC9C,OAAO,IAAI,KAAK,IAAI,CAAA;IACtB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IAElC,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxC,OAAO,KAAK,CAAA;IACd,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;YACnE,OAAO,KAAK,CAAA;QACd,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC"}

package/dist/common/deep-flat-map.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @description
+ * This function is used to flatten nested objects and arrays
+ *
+ * @example
+ *
+ * ```ts
+ * const data = {
+ *   root_level_property: "root level",
+ *   products: [
+ *     {
+ *       id: "1",
+ *       name: "product 1",
+ *       variants: [
+ *         { id: "1.1", name: "variant 1.1" },
+ *         { id: "1.2", name: "variant 1.2" },
+ *       ],
+ *     },
+ *     {
+ *       id: "2",
+ *       name: "product 2",
+ *       variants: [
+ *         { id: "2.1", name: "variant 2.1" },
+ *         { id: "2.2", name: "variant 2.2" },
+ *       ],
+ *     },
+ *   ],
+ * }
+ *
+ * const flat = deepFlatMap(
+ *   data,
+ *   "products.variants",
+ *   ({ root_, products, variants }) => {
+ *     return {
+ *       root_level_property: root_.root_level_property,
+ *       product_id: products.id,
+ *       product_name: products.name,
+ *       variant_id: variants.id,
+ *       variant_name: variants.name,
+ *     }
+ *   }
+ * )
+ * ```
+ */
+export declare function deepFlatMap(data: any, path: string, callback: (context: Record<string, any>) => any): any[];
+//# sourceMappingURL=deep-flat-map.d.ts.map

package/dist/common/deep-flat-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-flat-map.d.ts","sourceRoot":"","sources":["../../src/common/deep-flat-map.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,wBAAgB,WAAW,CACzB,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,SAwDhD"}

package/dist/common/deep-flat-map.js

@@ -0,0 +1,100 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepFlatMap = deepFlatMap;
+const is_defined_1 = require("./is-defined");
+const is_object_1 = require("./is-object");
+/**
+ * @description
+ * This function is used to flatten nested objects and arrays
+ *
+ * @example
+ *
+ * ```ts
+ * const data = {
+ *   root_level_property: "root level",
+ *   products: [
+ *     {
+ *       id: "1",
+ *       name: "product 1",
+ *       variants: [
+ *         { id: "1.1", name: "variant 1.1" },
+ *         { id: "1.2", name: "variant 1.2" },
+ *       ],
+ *     },
+ *     {
+ *       id: "2",
+ *       name: "product 2",
+ *       variants: [
+ *         { id: "2.1", name: "variant 2.1" },
+ *         { id: "2.2", name: "variant 2.2" },
+ *       ],
+ *     },
+ *   ],
+ * }
+ *
+ * const flat = deepFlatMap(
+ *   data,
+ *   "products.variants",
+ *   ({ root_, products, variants }) => {
+ *     return {
+ *       root_level_property: root_.root_level_property,
+ *       product_id: products.id,
+ *       product_name: products.name,
+ *       variant_id: variants.id,
+ *       variant_name: variants.name,
+ *     }
+ *   }
+ * )
+ * ```
+ */
+function deepFlatMap(data, path, callback) {
+    const ROOT_LEVEL = "root_";
+    const keys = path.split(".");
+    keys.unshift(ROOT_LEVEL);
+    const lastKey = keys[keys.length - 1];
+    const stack = [{ element: { [ROOT_LEVEL]: data }, path: keys, context: {} }];
+    const results = [];
+    while (stack.length > 0) {
+        const { element, path, context } = stack.shift();
+        const currentKey = path[0];
+        const remainingPath = path.slice(1);
+        if (!(0, is_defined_1.isDefined)(element?.[currentKey])) {
+            callback({ ...context });
+            continue;
+        }
+        if (remainingPath.length === 0) {
+            if (Array.isArray(element[currentKey])) {
+                element[currentKey].forEach((item) => {
+                    results.push(callback({ ...context, [lastKey]: item }));
+                });
+            }
+            else if ((0, is_object_1.isObject)(element[currentKey])) {
+                results.push(callback({ ...context, [lastKey]: element[currentKey] }));
+            }
+        }
+        else {
+            if (Array.isArray(element[currentKey])) {
+                if (element[currentKey].length === 0) {
+                    callback({ ...context });
+                    continue;
+                }
+                element[currentKey].forEach((item) => {
+                    stack.push({
+                        element: item,
+                        path: remainingPath,
+                        context: { ...context, [currentKey]: item },
+                    });
+                });
+            }
+            else if ((0, is_object_1.isObject)(element[currentKey])) {
+                stack.push({
+                    element: element[currentKey],
+                    path: remainingPath,
+                    context: { ...context, [currentKey]: element[currentKey] },
+                });
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=deep-flat-map.js.map

package/dist/common/deep-flat-map.js.map

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

package/dist/common/deep-merge.d.ts

@@ -0,0 +1,2 @@
+export declare function deepMerge(target: any, source: any): any;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/common/deep-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/common/deep-merge.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAuBjD"}

package/dist/common/deep-merge.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMerge = deepMerge;
+const is_object_1 = require("./is-object");
+function deepMerge(target, source) {
+    const recursive = (a, b) => {
+        if (!(0, is_object_1.isObject)(a)) {
+            return b;
+        }
+        if (!(0, is_object_1.isObject)(b)) {
+            return a;
+        }
+        Object.keys(b).forEach((key) => {
+            if ((0, is_object_1.isObject)(b[key])) {
+                a[key] ??= {};
+                a[key] = deepMerge(a[key], b[key]);
+            }
+            else {
+                a[key] = b[key];
+            }
+        });
+        return a;
+    };
+    const copy = { ...target };
+    return recursive(copy, source);
+}
+//# sourceMappingURL=deep-merge.js.map

package/dist/common/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../src/common/deep-merge.ts"],"names":[],"mappings":";;AAEA,8BAuBC;AAzBD,2CAAsC;AAEtC,SAAgB,SAAS,CAAC,MAAW,EAAE,MAAW;IAChD,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACzB,IAAI,CAAC,IAAA,oBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,CAAA;QACV,CAAC;QACD,IAAI,CAAC,IAAA,oBAAQ,EAAC,CAAC,CAAC,EAAE,CAAC;YACjB,OAAO,CAAC,CAAA;QACV,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE;YAC7B,IAAI,IAAA,oBAAQ,EAAC,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBACrB,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAA;gBACb,CAAC,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAA;YACpC,CAAC;iBAAM,CAAC;gBACN,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;YACjB,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,CAAC,CAAA;IACV,CAAC,CAAA;IAED,MAAM,IAAI,GAAG,EAAE,GAAG,MAAM,EAAE,CAAA;IAC1B,OAAO,SAAS,CAAC,IAAI,EAAE,MAAM,CAAC,CAAA;AAChC,CAAC"}

package/dist/common/define-config.d.ts

@@ -0,0 +1,21 @@
+import { ConfigModule, InputConfigModules, InputConfigWithArrayModules, InputConfigWithObjectModules } from "@acmekit/types";
+export declare const DEFAULT_STORE_RESTRICTED_FIELDS: string[];
+/**
+ * The "defineConfig" helper can be used to define the configuration
+ * of a acmekit application.
+ *
+ * The helper under the hood merges your config with a set of defaults to
+ * make an application work seamlessly, but still provide you the ability
+ * to override configuration as needed.
+ */
+export declare function defineConfig(config?: InputConfigWithArrayModules): ConfigModule;
+/**
+ * @deprecated Use array-based modules configuration instead
+ */
+export declare function defineConfig(config?: InputConfigWithObjectModules): ConfigModule;
+/**
+ * Transforms an array of modules into an object. The last module will
+ * take precedence in case of duplicate modules
+ */
+export declare function transformModules(modules: InputConfigModules): Exclude<ConfigModule["modules"], undefined>;
+//# sourceMappingURL=define-config.d.ts.map

package/dist/common/define-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-config.d.ts","sourceRoot":"","sources":["../../src/common/define-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,YAAY,EAEZ,kBAAkB,EAClB,2BAA2B,EAC3B,4BAA4B,EAG7B,MAAM,gBAAgB,CAAA;AAsBvB,eAAO,MAAM,+BAA+B,UAO3C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,YAAY,CAAA;AAChF;;GAEG;AACH,wBAAgB,YAAY,CAC1B,MAAM,CAAC,EAAE,4BAA4B,GACpC,YAAY,CAAA;AAsBf;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,CAyD7C"}