@achs/env 4.12.3 → 5.0.0-alpha.0

package/utils/index.js

@@ -1,23 +1,8 @@
-"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-__exportStar(require("./command.util"), exports);
-__exportStar(require("./interpolate.util"), exports);
-__exportStar(require("./json.util"), exports);
-__exportStar(require("./logger"), exports);
-__exportStar(require("./normalize.util"), exports);
-__exportStar(require("./schema.util"), exports);
-//# sourceMappingURL=index.js.map
+import { normalizeRawArgv as e } from "./argv.util.js";
+import { flatAndValidateResults as t, flatResults as n, generateSchemaFrom as r, getSubcommand as i, loadConfigFile as a, loadProjectInfo as o, loadSchemaFile as s, loadVariablesFromProviders as c } from "./command.util.js";
+import { interpolate as l, interpolateJson as u, isRecord as d } from "./interpolate.util.js";
+import { readJson as f, resolvePath as p, writeEnvFromJson as m, writeJson as h } from "./json.util.js";
+import { LOG_LEVELS as g, configureLogger as _, createLogger as v, logger as y } from "./logger.js";
+import { flatten as b, normalize as x } from "./normalize.util.js";
+import { createValidator as S, createValidators as C, flatSchema as w, isJsonSchemaObject as T, schemaFrom as E, schemaToJson as D } from "./schema.util.js";
+export { g as LOG_LEVELS, _ as configureLogger, v as createLogger, S as createValidator, C as createValidators, t as flatAndValidateResults, n as flatResults, w as flatSchema, b as flatten, r as generateSchemaFrom, i as getSubcommand, l as interpolate, u as interpolateJson, T as isJsonSchemaObject, d as isRecord, a as loadConfigFile, o as loadProjectInfo, s as loadSchemaFile, c as loadVariablesFromProviders, y as logger, x as normalize, e as normalizeRawArgv, f as readJson, p as resolvePath, E as schemaFrom, D as schemaToJson, m as writeEnvFromJson, h as writeJson };

package/utils/interpolate.util.d.ts

@@ -1,4 +1,32 @@
+/**
+ * Validates value must be a record.
+ *
+ * @export
+ * @param {unknown} obj
+ * @returns {*}  {obj is Record<string, unknown>}
+ */
 export declare function isRecord(obj: unknown): obj is Record<string, unknown>;
-export declare function interpolate<T extends string | unknown>(value: T, args: Record<string, unknown>, delimiters?: [string, string]): T;
+/**
+ * Replaces string arguments with regex interpolation.
+ *
+ * @export
+ * @template T
+ * @param {T} value
+ * @param {Record<string, unknown>} args
+ * @param {[string, string]} [delimiters=['[[', ']]']]
+ *
+ * @returns {T} mutated value
+ */
+export declare function interpolate<T>(value: T, args: Record<string, unknown>, delimiters?: [string, string]): T;
+/**
+ * Replaces JSON string arguments with regex interpolation.
+ *
+ * @export
+ * @param {Record<string, unknown>} args
+ * @param {Record<string, unknown>} values
+ * @param {[string, string]} [delimiters=['[[', ']]']]
+ *
+ * @returns {Record<string, unknown>} mutated args
+ */
 export declare function interpolateJson(values: Record<string, unknown>, args: Record<string, unknown>, delimiters?: [string, string]): Record<string, unknown>;
 //# sourceMappingURL=interpolate.util.d.ts.map

package/utils/interpolate.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interpolate.util.d.ts","sourceRoot":"","sources":["../../src/utils/interpolate.util.ts"],"names":[],"mappings":"AASA,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIrE;AAaD,wBAAgB,WAAW,CAAC,CAAC,SAAS,MAAM,GAAG,OAAO,EACrD,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,GAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,GACzC,CAAC,CAeH;AAYD,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,GAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}
+{"version":3,"file":"interpolate.util.d.ts","sourceRoot":"","sources":["../../src/utils/interpolate.util.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAIrE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAC5B,KAAK,EAAE,CAAC,EACR,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,GAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,GACzC,CAAC,CAeH;AAED;;;;;;;;;GASG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,UAAU,GAAE,CAAC,MAAM,EAAE,MAAM,CAAgB,GACzC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}

package/utils/interpolate.util.js

@@ -1,34 +1,16 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isRecord = isRecord;
-exports.interpolate = interpolate;
-exports.interpolateJson = interpolateJson;
-const subslate_1 = __importDefault(require("subslate"));
-function isRecord(obj) {
-    if (!obj || typeof obj !== 'object')
-        return false;
-    return Object.keys(obj).length > 0;
+import e from "subslate";
+//#region src/utils/interpolate.util.ts
+function t(e) {
+	return !e || typeof e != "object" ? !1 : Object.keys(e).length > 0;
 }
-function interpolate(value, args, delimiters = ['[[', ']]']) {
-    if (typeof value === 'string') {
-        if (!value.includes(delimiters[0]))
-            return value;
-        return (0, subslate_1.default)(value, args, {
-            startStopPairs: delimiters
-        });
-    }
-    if (Array.isArray(value))
-        return value.map((a) => interpolate(a, args, delimiters));
-    if (isRecord(value))
-        return interpolateJson(value, args, delimiters);
-    return value;
+function n(i, a, o = ["[[", "]]"]) {
+	return typeof i == "string" ? i.includes(o[0]) ? e(i, a, { startStopPairs: o }) : i : Array.isArray(i) ? i.map((e) => n(e, a, o)) : t(i) ? r(i, a, o) : i;
 }
-function interpolateJson(values, args, delimiters = ['[[', ']]']) {
-    for (const key in values)
-        values[key] = interpolate(values[key], args, delimiters);
-    return values;
+function r(e, t, r = ["[[", "]]"]) {
+	for (let i in e) e[i] = n(e[i], t, r);
+	return e;
 }
+//#endregion
+export { n as interpolate, r as interpolateJson, t as isRecord };
+
 //# sourceMappingURL=interpolate.util.js.map

package/utils/interpolate.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"interpolate.util.js","sourceRoot":"","sources":["../../src/utils/interpolate.util.ts"],"names":[],"mappings":";;;;;AASA,4BAIC;AAaD,kCAmBC;AAYD,0CASC;AAlED,wDAAgC;AAShC,SAAgB,QAAQ,CAAC,GAAY;IACpC,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAElD,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC;AACpC,CAAC;AAaD,SAAgB,WAAW,CAC1B,KAAQ,EACR,IAA6B,EAC7B,aAA+B,CAAC,IAAI,EAAE,IAAI,CAAC;IAE3C,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YAAE,OAAO,KAAU,CAAC;QAEtD,OAAO,IAAA,kBAAQ,EAAC,KAAK,EAAE,IAAI,EAAE;YAC5B,cAAc,EAAE,UAAU;SAC1B,CAAM,CAAC;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACvB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAM,CAAC;IAEhE,IAAI,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,eAAe,CAAC,KAAK,EAAE,IAAI,EAAE,UAAU,CAAM,CAAC;IAE1E,OAAO,KAAK,CAAC;AACd,CAAC;AAYD,SAAgB,eAAe,CAC9B,MAA+B,EAC/B,IAA6B,EAC7B,aAA+B,CAAC,IAAI,EAAE,IAAI,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,MAAM;QACvB,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAE1D,OAAO,MAAM,CAAC;AACf,CAAC"}
+{"version":3,"file":"interpolate.util.js","names":[],"sources":["../../src/utils/interpolate.util.ts"],"sourcesContent":["import subslate from 'subslate';\r\n\r\n/**\r\n * Validates value must be a record.\r\n *\r\n * @export\r\n * @param {unknown} obj\r\n * @returns {*}  {obj is Record<string, unknown>}\r\n */\r\nexport function isRecord(obj: unknown): obj is Record<string, unknown> {\r\n\tif (!obj || typeof obj !== 'object') return false;\r\n\r\n\treturn Object.keys(obj).length > 0;\r\n}\r\n\r\n/**\r\n * Replaces string arguments with regex interpolation.\r\n *\r\n * @export\r\n * @template T\r\n * @param {T} value\r\n * @param {Record<string, unknown>} args\r\n * @param {[string, string]} [delimiters=['[[', ']]']]\r\n *\r\n * @returns {T} mutated value\r\n */\r\nexport function interpolate<T>(\r\n\tvalue: T,\r\n\targs: Record<string, unknown>,\r\n\tdelimiters: [string, string] = ['[[', ']]'],\r\n): T {\r\n\tif (typeof value === 'string') {\r\n\t\tif (!value.includes(delimiters[0])) return value as T;\r\n\r\n\t\treturn subslate(value, args, {\r\n\t\t\tstartStopPairs: delimiters,\r\n\t\t}) as T;\r\n\t}\r\n\r\n\tif (Array.isArray(value))\r\n\t\treturn value.map((a) => interpolate(a, args, delimiters)) as T;\r\n\r\n\tif (isRecord(value)) return interpolateJson(value, args, delimiters) as T;\r\n\r\n\treturn value;\r\n}\r\n\r\n/**\r\n * Replaces JSON string arguments with regex interpolation.\r\n *\r\n * @export\r\n * @param {Record<string, unknown>} args\r\n * @param {Record<string, unknown>} values\r\n * @param {[string, string]} [delimiters=['[[', ']]']]\r\n *\r\n * @returns {Record<string, unknown>} mutated args\r\n */\r\nexport function interpolateJson(\r\n\tvalues: Record<string, unknown>,\r\n\targs: Record<string, unknown>,\r\n\tdelimiters: [string, string] = ['[[', ']]'],\r\n): Record<string, unknown> {\r\n\tfor (const key in values)\r\n\t\tvalues[key] = interpolate(values[key], args, delimiters);\r\n\r\n\treturn values;\r\n}\r\n"],"mappings":";;AASA,SAAgB,EAAS,GAA8C;CAGtE,OAFI,CAAC,KAAO,OAAO,KAAQ,WAAiB,KAErC,OAAO,KAAK,CAAG,EAAE,SAAS;AAClC;AAaA,SAAgB,EACf,GACA,GACA,IAA+B,CAAC,MAAM,IAAI,GACtC;CAcJ,OAbI,OAAO,KAAU,WACf,EAAM,SAAS,EAAW,EAAE,IAE1B,EAAS,GAAO,GAAM,EAC5B,gBAAgB,EACjB,CAAC,IAJ0C,IAOxC,MAAM,QAAQ,CAAK,IACf,EAAM,KAAK,MAAM,EAAY,GAAG,GAAM,CAAU,CAAC,IAErD,EAAS,CAAK,IAAU,EAAgB,GAAO,GAAM,CAAU,IAE5D;AACR;AAYA,SAAgB,EACf,GACA,GACA,IAA+B,CAAC,MAAM,IAAI,GAChB;CAC1B,KAAK,IAAM,KAAO,GACjB,EAAO,KAAO,EAAY,EAAO,IAAM,GAAM,CAAU;CAExD,OAAO;AACR"}

package/utils/json.util.d.ts

@@ -1,5 +1,43 @@
+/**
+ * Resolve a relative path for os.
+ *
+ * @export
+ * @param {string} filePath relative path from project root
+ *
+ * @returns {string} path
+ */
 export declare function resolvePath(filePath: string): string;
-export declare function readJson<T = Record<string, any>>(path: string): Promise<[T | Record<string, any>, boolean] | never>;
-export declare function writeJson(path: string, content: Record<string, unknown>, overwrite?: boolean, undefinedAsNull?: boolean): Promise<boolean | never>;
-export declare function writeEnvFromJson(path: string, content: Record<string, unknown>, overwrite?: boolean, quotes?: boolean): Promise<boolean | never>;
+/**
+ * Reads and parses a JSON file.
+ *
+ * @export
+ * @template T
+ * @param {string} path
+ *
+ * @returns {Promise<[Record<string, any>, boolean]>}
+ */
+export declare function readJson<T = Record<string, any>>(path: string): Promise<[Record<string, any> | T, boolean]>;
+/**
+ * Saves a JSON into a file.
+ *
+ * @export
+ * @param {string} path
+ * @param {unknown} content
+ * @param {false} overwrite
+ * @param {false} undefinedAsNull replaces undefined by null
+ *
+ * @returns {Promise<boolean>}
+ */
+export declare function writeJson(path: string, content: Record<string, unknown>, overwrite?: boolean, undefinedAsNull?: boolean): Promise<boolean>;
+/**
+ * Saves a JSON into a file as dotenv.
+ *
+ * @export
+ * @param {string} path
+ * @param {unknown} content
+ * @param {false} overwrite
+ *
+ * @returns {Promise<boolean>}
+ */
+export declare function writeEnvFromJson(path: string, content: Record<string, unknown>, overwrite?: boolean, quotes?: boolean): Promise<boolean>;
 //# sourceMappingURL=json.util.d.ts.map

package/utils/json.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"json.util.d.ts","sourceRoot":"","sources":["../../src/utils/json.util.ts"],"names":[],"mappings":"AAwBA,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAOpD;AAWD,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC,CAIrD;AAaD,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,eAAe,UAAQ,GACrB,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,CAgB1B;AAYD,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,MAAM,UAAQ,GACZ,OAAO,CAAC,OAAO,GAAG,KAAK,CAAC,CAiB1B"}
+{"version":3,"file":"json.util.d.ts","sourceRoot":"","sources":["../../src/utils/json.util.ts"],"names":[],"mappings":"AAgBA;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;;;;;GAQG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrD,IAAI,EAAE,MAAM,GACV,OAAO,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAI7C;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,SAAS,CAC9B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,eAAe,UAAQ,GACrB,OAAO,CAAC,OAAO,CAAC,CAgBlB;AAED;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACrC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChC,SAAS,UAAQ,EACjB,MAAM,UAAQ,GACZ,OAAO,CAAC,OAAO,CAAC,CAiBlB"}

package/utils/json.util.js

@@ -1,47 +1,29 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.resolvePath = resolvePath;
-exports.readJson = readJson;
-exports.writeJson = writeJson;
-exports.writeEnvFromJson = writeEnvFromJson;
-const os_1 = __importDefault(require("os"));
-const path_1 = __importDefault(require("path"));
-const fs_1 = require("fs");
-const promises_1 = require("fs/promises");
-const replacer = (_, value) => value === undefined ? null : value;
-function resolvePath(filePath) {
-    const home = os_1.default.homedir();
-    if (home !== undefined)
-        filePath = filePath.replace(/^~($|\/|\\)/, `${home}$1`);
-    return path_1.default.resolve(process.cwd(), filePath);
+import { existsSync as e } from "node:fs";
+import t from "node:path";
+import { readFile as n, writeFile as r } from "node:fs/promises";
+import i from "node:os";
+//#region src/utils/json.util.ts
+var a = (e, t) => t === void 0 ? null : t;
+function o(e) {
+	let n = i.homedir();
+	return n && (e = e.replace(/^~($|\/|\\)/, `${n}$1`)), t.resolve(process.cwd(), e);
 }
-async function readJson(path) {
-    if (!(0, fs_1.existsSync)(path))
-        return [{}, false];
-    return [JSON.parse(await (0, promises_1.readFile)(path, 'utf8')), true];
+async function s(t) {
+	return e(t) ? [JSON.parse(await n(t, "utf8")), !0] : [{}, !1];
 }
-async function writeJson(path, content, overwrite = false, undefinedAsNull = false) {
-    const exists = (0, fs_1.existsSync)(path);
-    if (exists && !overwrite)
-        return false;
-    await (0, promises_1.writeFile)(path, `${JSON.stringify(content, undefinedAsNull ? replacer : undefined, 4)}\n`, 'utf8');
-    return true;
+async function c(t, n, i = !1, o = !1) {
+	return e(t) && !i ? !1 : (await r(t, `${JSON.stringify(n, o ? a : void 0, 4)}\n`, "utf8"), !0);
 }
-async function writeEnvFromJson(path, content, overwrite = false, quotes = false) {
-    const exists = (0, fs_1.existsSync)(path);
-    if (exists && !overwrite)
-        return false;
-    let data = '';
-    for (const key in content) {
-        let value = content[key];
-        if (quotes)
-            value = `"${value}"`;
-        data += `${key}=${value}\n`;
-    }
-    await (0, promises_1.writeFile)(path, data, 'utf8');
-    return true;
+async function l(t, n, i = !1, a = !1) {
+	if (e(t) && !i) return !1;
+	let o = "";
+	for (let e in n) {
+		let t = n[e];
+		a && (t = `"${t}"`), o += `${e}=${t}\n`;
+	}
+	return await r(t, o, "utf8"), !0;
 }
+//#endregion
+export { s as readJson, o as resolvePath, l as writeEnvFromJson, c as writeJson };
+
 //# sourceMappingURL=json.util.js.map

package/utils/json.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"json.util.js","sourceRoot":"","sources":["../../src/utils/json.util.ts"],"names":[],"mappings":";;;;;AAwBA,kCAOC;AAWD,4BAMC;AAaD,8BAqBC;AAYD,4CAsBC;AApHD,4CAAoB;AACpB,gDAAwB;AACxB,2BAAgC;AAChC,0CAAkD;AAUlD,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAE,KAAU,EAAuB,EAAE,CAC/D,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;AAUpC,SAAgB,WAAW,CAAC,QAAgB;IAC3C,MAAM,IAAI,GAAG,YAAE,CAAC,OAAO,EAAE,CAAC;IAE1B,IAAI,IAAI,KAAK,SAAS;QACrB,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC;IAEzD,OAAO,cAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC;AAWM,KAAK,UAAU,QAAQ,CAC7B,IAAY;IAEZ,IAAI,CAAC,IAAA,eAAU,EAAC,IAAI,CAAC;QAAE,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAE1C,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,IAAA,mBAAQ,EAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC;AACzD,CAAC;AAaM,KAAK,UAAU,SAAS,CAC9B,IAAY,EACZ,OAAgC,EAChC,SAAS,GAAG,KAAK,EACjB,eAAe,GAAG,KAAK;IAEvB,MAAM,MAAM,GAAG,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,MAAM,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAEvC,MAAM,IAAA,oBAAS,EACd,IAAI,EACJ,GAAG,IAAI,CAAC,SAAS,CAChB,OAAO,EACP,eAAe,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,EACtC,CAAC,CACD,IAAI,EACL,MAAM,CACN,CAAC;IAEF,OAAO,IAAI,CAAC;AACb,CAAC;AAYM,KAAK,UAAU,gBAAgB,CACrC,IAAY,EACZ,OAAgC,EAChC,SAAS,GAAG,KAAK,EACjB,MAAM,GAAG,KAAK;IAEd,MAAM,MAAM,GAAG,IAAA,eAAU,EAAC,IAAI,CAAC,CAAC;IAEhC,IAAI,MAAM,IAAI,CAAC,SAAS;QAAE,OAAO,KAAK,CAAC;IAEvC,IAAI,IAAI,GAAG,EAAE,CAAC;IAEd,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC3B,IAAI,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QACzB,IAAI,MAAM;YAAE,KAAK,GAAG,IAAI,KAAK,GAAG,CAAC;QAEjC,IAAI,IAAI,GAAG,GAAG,IAAI,KAAK,IAAI,CAAC;IAC7B,CAAC;IAED,MAAM,IAAA,oBAAS,EAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAEpC,OAAO,IAAI,CAAC;AACb,CAAC"}
+{"version":3,"file":"json.util.js","names":[],"sources":["../../src/utils/json.util.ts"],"sourcesContent":["import { existsSync } from 'node:fs';\r\nimport { readFile, writeFile } from 'node:fs/promises';\r\nimport os from 'node:os';\r\nimport path from 'node:path';\r\n\r\n/**\r\n * Replaces undefined by null in JSON.stringify()\r\n *\r\n * @param {string} _ property key\r\n * @param {any} value property value\r\n *\r\n * @returns {any} value\r\n */\r\nconst replacer = (_: string, value: any): any =>\r\n\tvalue === undefined ? null : value;\r\n\r\n/**\r\n * Resolve a relative path for os.\r\n *\r\n * @export\r\n * @param {string} filePath relative path from project root\r\n *\r\n * @returns {string} path\r\n */\r\nexport function resolvePath(filePath: string): string {\r\n\tconst home = os.homedir();\r\n\r\n\tif (home) filePath = filePath.replace(/^~($|\\/|\\\\)/, `${home}$1`);\r\n\r\n\treturn path.resolve(process.cwd(), filePath);\r\n}\r\n\r\n/**\r\n * Reads and parses a JSON file.\r\n *\r\n * @export\r\n * @template T\r\n * @param {string} path\r\n *\r\n * @returns {Promise<[Record<string, any>, boolean]>}\r\n */\r\nexport async function readJson<T = Record<string, any>>(\r\n\tpath: string,\r\n): Promise<[Record<string, any> | T, boolean]> {\r\n\tif (!existsSync(path)) return [{}, false];\r\n\r\n\treturn [JSON.parse(await readFile(path, 'utf8')), true];\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n * @param {false} undefinedAsNull replaces undefined by null\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tundefinedAsNull = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tawait writeFile(\r\n\t\tpath,\r\n\t\t`${JSON.stringify(\r\n\t\t\tcontent,\r\n\t\t\tundefinedAsNull ? replacer : undefined,\r\n\t\t\t4,\r\n\t\t)}\\n`,\r\n\t\t'utf8',\r\n\t);\r\n\r\n\treturn true;\r\n}\r\n\r\n/**\r\n * Saves a JSON into a file as dotenv.\r\n *\r\n * @export\r\n * @param {string} path\r\n * @param {unknown} content\r\n * @param {false} overwrite\r\n *\r\n * @returns {Promise<boolean>}\r\n */\r\nexport async function writeEnvFromJson(\r\n\tpath: string,\r\n\tcontent: Record<string, unknown>,\r\n\toverwrite = false,\r\n\tquotes = false,\r\n): Promise<boolean> {\r\n\tconst exists = existsSync(path);\r\n\r\n\tif (exists && !overwrite) return false;\r\n\r\n\tlet data = '';\r\n\r\n\tfor (const key in content) {\r\n\t\tlet value = content[key];\r\n\t\tif (quotes) value = `\"${value}\"`;\r\n\r\n\t\tdata += `${key}=${value}\\n`;\r\n\t}\r\n\r\n\tawait writeFile(path, data, 'utf8');\r\n\r\n\treturn true;\r\n}\r\n"],"mappings":";;;;;AAaA,IAAM,KAAY,GAAW,MAC5B,MAAU,KAAA,IAAY,OAAO;AAU9B,SAAgB,EAAY,GAA0B;CACrD,IAAM,IAAO,EAAG,QAAQ;CAIxB,OAFI,MAAM,IAAW,EAAS,QAAQ,eAAe,GAAG,EAAK,GAAG,IAEzD,EAAK,QAAQ,QAAQ,IAAI,GAAG,CAAQ;AAC5C;AAWA,eAAsB,EACrB,GAC8C;CAG9C,OAFK,EAAW,CAAI,IAEb,CAAC,KAAK,MAAM,MAAM,EAAS,GAAM,MAAM,CAAC,GAAG,EAAI,IAFxB,CAAC,CAAC,GAAG,EAAK;AAGzC;AAaA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAkB,IACC;CAenB,OAde,EAAW,CAEtB,KAAU,CAAC,IAAkB,MAEjC,MAAM,EACL,GACA,GAAG,KAAK,UACP,GACA,IAAkB,IAAW,KAAA,GAC7B,CACD,EAAE,KACF,MACD,GAEO;AACR;AAYA,eAAsB,EACrB,GACA,GACA,IAAY,IACZ,IAAS,IACU;CAGnB,IAFe,EAAW,CAEtB,KAAU,CAAC,GAAW,OAAO;CAEjC,IAAI,IAAO;CAEX,KAAK,IAAM,KAAO,GAAS;EAC1B,IAAI,IAAQ,EAAQ;EAGpB,AAFI,MAAQ,IAAQ,IAAI,EAAM,KAE9B,KAAQ,GAAG,EAAI,GAAG,EAAM;CACzB;CAIA,OAFA,MAAM,EAAU,GAAM,GAAM,MAAM,GAE3B;AACR"}

package/utils/logger.d.ts

@@ -1,3 +1,22 @@
-import { LoggerWithoutCallSite as Logger } from 'tslog';
-export declare const logger: Logger;
+import { Logger } from 'tslog';
+export type LogLevelName = 'debug' | 'error' | 'info' | 'silly' | 'trace' | 'warn';
+/** tslog v4 numeric minLevel by level name. */
+export declare const LOG_LEVELS: Record<LogLevelName, number>;
+export interface LoggerSettings {
+    maskAnyRegEx?: string[];
+    maskValuesOfKeys?: string[];
+    minLevel?: LogLevelName;
+}
+/**
+ * Builds a configured tslog logger. Extracted as a factory so settings logic
+ * is unit-testable and reused by sub-loggers.
+ */
+export declare function createLogger(settings?: LoggerSettings): Logger<unknown>;
+/**
+ * Applies runtime settings to an existing logger by mutating `logger.settings`
+ * (tslog v4 has no `setSettings`).
+ */
+export declare function configureLogger(logger: Logger<unknown>, settings: LoggerSettings): void;
+/** Global stdout logger. */
+export declare const logger: Logger<unknown>;
 //# sourceMappingURL=logger.d.ts.map

package/utils/logger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,IAAI,MAAM,EAAE,MAAM,OAAO,CAAC;AAKxD,eAAO,MAAM,MAAM,QAYjB,CAAC"}
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC;AAG/B,MAAM,MAAM,YAAY,GACrB,OAAO,GACP,OAAO,GACP,MAAM,GACN,OAAO,GACP,OAAO,GACP,MAAM,CAAC;AAEV,+CAA+C;AAC/C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAOnD,CAAC;AAEF,MAAM,WAAW,cAAc;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB;AAUD;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,GAAE,cAAmB,GAAG,MAAM,CAAC,OAAO,CAAC,CAS3E;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,EACvB,QAAQ,EAAE,cAAc,GACtB,IAAI,CAWN;AAED,4BAA4B;AAC5B,eAAO,MAAM,MAAM,iBAAiB,CAAC"}

package/utils/logger.js

@@ -1,18 +1,32 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.logger = void 0;
-const tslog_1 = require("tslog");
-exports.logger = new tslog_1.LoggerWithoutCallSite({
-    displayDateTime: true,
-    displayLoggerName: false,
-    displayInstanceName: false,
-    displayFunctionName: false,
-    prettyInspectHighlightStyles: {
-        regexp: 'green',
-        number: 'cyan'
-    },
-    displayFilePath: 'hidden',
-    dateTimePattern: 'hour:minute:second.millisecond',
-    maskPlaceholder: '***'
-});
+import { Logger as e } from "tslog";
+//#region src/utils/logger.ts
+var t = {
+	debug: 2,
+	error: 5,
+	info: 3,
+	silly: 0,
+	trace: 1,
+	warn: 4
+}, n = {
+	hideLogPositionForProduction: !0,
+	maskPlaceholder: "***",
+	prettyLogTemplate: "{{hh}}:{{MM}}:{{ss}}.{{ms}}	{{logLevelName}}	",
+	prettyLogTimeZone: "local",
+	type: "pretty"
+};
+function r(r = {}) {
+	return new e({
+		...n,
+		maskValuesOfKeys: r.maskValuesOfKeys ?? [],
+		minLevel: t[r.minLevel ?? "info"],
+		maskValuesRegEx: (r.maskAnyRegEx ?? []).map((e) => new RegExp(e))
+	});
+}
+function i(e, n) {
+	n.minLevel && (e.settings.minLevel = t[n.minLevel]), n.maskValuesOfKeys && (e.settings.maskValuesOfKeys = n.maskValuesOfKeys), n.maskAnyRegEx && (e.settings.maskValuesRegEx = n.maskAnyRegEx.map((e) => new RegExp(e)));
+}
+var a = r();
+//#endregion
+export { t as LOG_LEVELS, i as configureLogger, r as createLogger, a as logger };
+
 //# sourceMappingURL=logger.js.map

package/utils/logger.js.map

@@ -1 +1 @@
-{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAAA,iCAAwD;AAK3C,QAAA,MAAM,GAAG,IAAI,6BAAM,CAAC;IAChC,eAAe,EAAE,IAAI;IACrB,iBAAiB,EAAE,KAAK;IACxB,mBAAmB,EAAE,KAAK;IAC1B,mBAAmB,EAAE,KAAK;IAC1B,4BAA4B,EAAE;QAC7B,MAAM,EAAE,OAAO;QACf,MAAM,EAAE,MAAM;KACd;IACD,eAAe,EAAE,QAAQ;IACzB,eAAe,EAAE,gCAAgC;IACjD,eAAe,EAAE,KAAK;CACtB,CAAC,CAAC"}
+{"version":3,"file":"logger.js","names":[],"sources":["../../src/utils/logger.ts"],"sourcesContent":["import { Logger } from 'tslog';\r\nimport type { ISettingsParam } from 'tslog';\r\n\r\nexport type LogLevelName =\r\n\t| 'debug'\r\n\t| 'error'\r\n\t| 'info'\r\n\t| 'silly'\r\n\t| 'trace'\r\n\t| 'warn';\r\n\r\n/** tslog v4 numeric minLevel by level name. */\r\nexport const LOG_LEVELS: Record<LogLevelName, number> = {\r\n\tdebug: 2,\r\n\terror: 5,\r\n\tinfo: 3,\r\n\tsilly: 0,\r\n\ttrace: 1,\r\n\twarn: 4,\r\n};\r\n\r\nexport interface LoggerSettings {\r\n\tmaskAnyRegEx?: string[];\r\n\tmaskValuesOfKeys?: string[];\r\n\tminLevel?: LogLevelName;\r\n}\r\n\r\nconst BASE_SETTINGS: ISettingsParam<unknown> = {\r\n\thideLogPositionForProduction: true,\r\n\tmaskPlaceholder: '***',\r\n\tprettyLogTemplate: '{{hh}}:{{MM}}:{{ss}}.{{ms}}\\t{{logLevelName}}\\t',\r\n\tprettyLogTimeZone: 'local',\r\n\ttype: 'pretty',\r\n};\r\n\r\n/**\r\n * Builds a configured tslog logger. Extracted as a factory so settings logic\r\n * is unit-testable and reused by sub-loggers.\r\n */\r\nexport function createLogger(settings: LoggerSettings = {}): Logger<unknown> {\r\n\treturn new Logger({\r\n\t\t...BASE_SETTINGS,\r\n\t\tmaskValuesOfKeys: settings.maskValuesOfKeys ?? [],\r\n\t\tminLevel: LOG_LEVELS[settings.minLevel ?? 'info'],\r\n\t\tmaskValuesRegEx: (settings.maskAnyRegEx ?? []).map(\r\n\t\t\t(pattern) => new RegExp(pattern),\r\n\t\t),\r\n\t});\r\n}\r\n\r\n/**\r\n * Applies runtime settings to an existing logger by mutating `logger.settings`\r\n * (tslog v4 has no `setSettings`).\r\n */\r\nexport function configureLogger(\r\n\tlogger: Logger<unknown>,\r\n\tsettings: LoggerSettings,\r\n): void {\r\n\tif (settings.minLevel)\r\n\t\tlogger.settings.minLevel = LOG_LEVELS[settings.minLevel];\r\n\r\n\tif (settings.maskValuesOfKeys)\r\n\t\tlogger.settings.maskValuesOfKeys = settings.maskValuesOfKeys;\r\n\r\n\tif (settings.maskAnyRegEx)\r\n\t\tlogger.settings.maskValuesRegEx = settings.maskAnyRegEx.map(\r\n\t\t\t(pattern) => new RegExp(pattern),\r\n\t\t);\r\n}\r\n\r\n/** Global stdout logger. */\r\nexport const logger = createLogger();\r\n"],"mappings":";;AAYA,IAAa,IAA2C;CACvD,OAAO;CACP,OAAO;CACP,MAAM;CACN,OAAO;CACP,OAAO;CACP,MAAM;AACP,GAQM,IAAyC;CAC9C,8BAA8B;CAC9B,iBAAiB;CACjB,mBAAmB;CACnB,mBAAmB;CACnB,MAAM;AACP;AAMA,SAAgB,EAAa,IAA2B,CAAC,GAAoB;CAC5E,OAAO,IAAI,EAAO;EACjB,GAAG;EACH,kBAAkB,EAAS,oBAAoB,CAAC;EAChD,UAAU,EAAW,EAAS,YAAY;EAC1C,kBAAkB,EAAS,gBAAgB,CAAC,GAAG,KAC7C,MAAY,IAAI,OAAO,CAAO,CAChC;CACD,CAAC;AACF;AAMA,SAAgB,EACf,GACA,GACO;CAOP,AANI,EAAS,aACZ,EAAO,SAAS,WAAW,EAAW,EAAS,YAE5C,EAAS,qBACZ,EAAO,SAAS,mBAAmB,EAAS,mBAEzC,EAAS,iBACZ,EAAO,SAAS,kBAAkB,EAAS,aAAa,KACtD,MAAY,IAAI,OAAO,CAAO,CAChC;AACF;AAGA,IAAa,IAAS,EAAa"}

package/utils/normalize.util.d.ts

@@ -1,3 +1,25 @@
-export declare function flatten(obj: Record<string, any>, nestingDelimiter?: string, pkey?: string): Record<string, string>;
-export declare function normalize(obj: Record<string, any>, nestingDelimiter?: string, arrayDescomposition?: boolean, pkey?: string): Record<string, string>;
+/**
+ * Flatten a object keeping depth path
+ * in key using __ as level separator.
+ *
+ * @param {Record<string, any>} obj
+ * @param {string} nestingDelimiter char for delimit nesting levels
+ * @param {string} pkey first level key
+ *
+ * @returns {Record<string, unknown>} flattened object
+ */
+export declare function flatten(obj: Record<string, any>, nestingDelimiter?: string, pkey?: string): Record<string, unknown>;
+/**
+ * Normalizes env object, converts arrays in list strings,
+ * only primitives types array,
+ * and removes $ global character from keys.
+ *
+ * @param {Record<string, any>} obj
+ * @param {string} nestingDelimiter char for delimit nesting levels
+ * @param {boolean} arrayDescomposition serialize or break down arrays
+ * @param {string} pkey first level key
+ *
+ * @returns {Record<string, unknown>} normalized object
+ */
+export declare function normalize(obj: Record<string, any>, nestingDelimiter?: string, arrayDescomposition?: boolean, pkey?: string): Record<string, unknown>;
 //# sourceMappingURL=normalize.util.d.ts.map

package/utils/normalize.util.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.util.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.util.ts"],"names":[],"mappings":"AAYA,wBAAgB,OAAO,CACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,gBAAgB,SAAO,EACvB,IAAI,SAAK,GACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA0BxB;AAcD,wBAAgB,SAAS,CACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,gBAAgB,SAAO,EACvB,mBAAmB,UAAQ,EAC3B,IAAI,SAAK,GACP,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAyCxB"}
+{"version":3,"file":"normalize.util.d.ts","sourceRoot":"","sources":["../../src/utils/normalize.util.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,wBAAgB,OAAO,CACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,gBAAgB,SAAO,EACvB,IAAI,SAAK,GACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA0BzB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACxB,gBAAgB,SAAO,EACvB,mBAAmB,UAAQ,EAC3B,IAAI,SAAK,GACP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAyCzB"}

package/utils/normalize.util.js

@@ -1,60 +1,39 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.flatten = flatten;
-exports.normalize = normalize;
-function flatten(obj, nestingDelimiter = '__', pkey = '') {
-    const flattened = {};
-    for (let key in obj) {
-        const value = obj[key];
-        const type = typeof value;
-        if (value === undefined || type === 'function')
-            continue;
-        if (key[0] === '#')
-            continue;
-        key = pkey + key;
-        if (value === null || type !== 'object' || Array.isArray(value)) {
-            flattened[key] = value;
-            continue;
-        }
-        Object.assign(flattened, flatten(value, nestingDelimiter, `${key}${nestingDelimiter}`));
-    }
-    return flattened;
+//#region src/utils/normalize.util.ts
+function e(t, n = "__", r = "") {
+	let i = {};
+	for (let a in t) {
+		let o = t[a], s = typeof o;
+		if (!(o === void 0 || s === "function") && a[0] !== "#") {
+			if (a = r + a, o === null || s !== "object" || Array.isArray(o)) {
+				i[a] = o;
+				continue;
+			}
+			Object.assign(i, e(o, n, `${a}${n}`));
+		}
+	}
+	return i;
 }
-function normalize(obj, nestingDelimiter = '__', arrayDescomposition = false, pkey = '') {
-    const flattened = {};
-    for (let key in obj) {
-        const value = obj[key];
-        const type = typeof value;
-        if (value === null || value === undefined || type === 'function')
-            continue;
-        key = pkey + key.replace('$', '');
-        if (type !== 'object') {
-            flattened[key] = value;
-            continue;
-        }
-        if (Array.isArray(value)) {
-            normalizeArray(flattened, key, value, nestingDelimiter, arrayDescomposition);
-        }
-        else {
-            Object.assign(flattened, normalize(value, nestingDelimiter, arrayDescomposition, `${key}${nestingDelimiter}`));
-        }
-    }
-    return flattened;
+function t(e, r = "__", i = !1, a = "") {
+	let o = {};
+	for (let s in e) {
+		let c = e[s], l = typeof c;
+		if (!(c == null || l === "function")) {
+			if (s = a + (s[0] === "$" ? s.slice(1) : s), l !== "object") {
+				o[s] = c;
+				continue;
+			}
+			Array.isArray(c) ? n(o, s, c, r, i) : Object.assign(o, t(c, r, i, `${s}${r}`));
+		}
+	}
+	return o;
 }
-function normalizeArray(flattened, key, value, nestingDelimiter = '__', arrayDescomposition = false) {
-    if (arrayDescomposition) {
-        key = `${key}${nestingDelimiter}`;
-        for (let i = 0; i < value.length; i++) {
-            if (typeof value[i] === 'object') {
-                Object.assign(flattened, normalize(value[i], nestingDelimiter, arrayDescomposition, `${key}${i}${nestingDelimiter}`));
-            }
-            else {
-                flattened[`${key}${i}`] = value[i];
-            }
-        }
-    }
-    else {
-        flattened[key] = value.filter((v) => typeof v !== 'object').join(',');
-    }
+function n(e, n, r, i = "__", a = !1) {
+	if (a) {
+		n = `${n}${i}`;
+		for (let [o, s] of r.entries()) typeof s == "object" ? Object.assign(e, t(s, i, a, `${n}${o}${i}`)) : e[`${n}${o}`] = s;
+	} else e[n] = r.filter((e) => typeof e != "object").join(",");
 }
+//#endregion
+export { e as flatten, t as normalize };
+
 //# sourceMappingURL=normalize.util.js.map

package/utils/normalize.util.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalize.util.js","sourceRoot":"","sources":["../../src/utils/normalize.util.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"normalize.util.js","names":[],"sources":["../../src/utils/normalize.util.ts"],"sourcesContent":["/**\r\n * Flatten a object keeping depth path\r\n * in key using __ as level separator.\r\n *\r\n * @param {Record<string, any>} obj\r\n * @param {string} nestingDelimiter char for delimit nesting levels\r\n * @param {string} pkey first level key\r\n *\r\n * @returns {Record<string, unknown>} flattened object\r\n */\r\nexport function flatten(\r\n\tobj: Record<string, any>,\r\n\tnestingDelimiter = '__',\r\n\tpkey = '',\r\n): Record<string, unknown> {\r\n\tconst flattened: Record<string, unknown> = {};\r\n\r\n\tfor (let key in obj) {\r\n\t\tconst value = obj[key];\r\n\t\tconst type = typeof value;\r\n\r\n\t\tif (value === undefined || type === 'function') continue;\r\n\r\n\t\t// skipped property\r\n\t\tif (key[0] === '#') continue;\r\n\t\tkey = pkey + key;\r\n\r\n\t\tif (value === null || type !== 'object' || Array.isArray(value)) {\r\n\t\t\tflattened[key] = value;\r\n\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\tObject.assign(\r\n\t\t\tflattened,\r\n\t\t\tflatten(value, nestingDelimiter, `${key}${nestingDelimiter}`),\r\n\t\t);\r\n\t}\r\n\r\n\treturn flattened;\r\n}\r\n\r\n/**\r\n * Normalizes env object, converts arrays in list strings,\r\n * only primitives types array,\r\n * and removes $ global character from keys.\r\n *\r\n * @param {Record<string, any>} obj\r\n * @param {string} nestingDelimiter char for delimit nesting levels\r\n * @param {boolean} arrayDescomposition serialize or break down arrays\r\n * @param {string} pkey first level key\r\n *\r\n * @returns {Record<string, unknown>} normalized object\r\n */\r\nexport function normalize(\r\n\tobj: Record<string, any>,\r\n\tnestingDelimiter = '__',\r\n\tarrayDescomposition = false,\r\n\tpkey = '',\r\n): Record<string, unknown> {\r\n\tconst flattened: Record<string, unknown> = {};\r\n\r\n\tfor (let key in obj) {\r\n\t\tconst value = obj[key];\r\n\t\tconst type = typeof value;\r\n\r\n\t\tif (value === null || value === undefined || type === 'function')\r\n\t\t\tcontinue;\r\n\r\n\t\t// shared/global keys are prefixed with `$`; strip it for injection\r\n\t\tkey = pkey + (key[0] === '$' ? key.slice(1) : key);\r\n\r\n\t\tif (type !== 'object') {\r\n\t\t\tflattened[key] = value;\r\n\r\n\t\t\tcontinue;\r\n\t\t}\r\n\r\n\t\tif (Array.isArray(value)) {\r\n\t\t\tnormalizeArray(\r\n\t\t\t\tflattened,\r\n\t\t\t\tkey,\r\n\t\t\t\tvalue,\r\n\t\t\t\tnestingDelimiter,\r\n\t\t\t\tarrayDescomposition,\r\n\t\t\t);\r\n\t\t} else {\r\n\t\t\tObject.assign(\r\n\t\t\t\tflattened,\r\n\t\t\t\tnormalize(\r\n\t\t\t\t\tvalue,\r\n\t\t\t\t\tnestingDelimiter,\r\n\t\t\t\t\tarrayDescomposition,\r\n\t\t\t\t\t`${key}${nestingDelimiter}`,\r\n\t\t\t\t),\r\n\t\t\t);\r\n\t\t}\r\n\t}\r\n\r\n\treturn flattened;\r\n}\r\n\r\n/**\r\n * Flatten and normalizes an array.\r\n *\r\n * @param {Record<string, unknown>} flattened\r\n * @param {string} key\r\n * @param {any[]} value\r\n * @param {string} [nestingDelimiter='__']\r\n * @param {boolean} [arrayDescomposition=false]\r\n */\r\nfunction normalizeArray(\r\n\tflattened: Record<string, unknown>,\r\n\tkey: string,\r\n\tvalue: any[],\r\n\tnestingDelimiter = '__',\r\n\tarrayDescomposition = false,\r\n): void {\r\n\tif (arrayDescomposition) {\r\n\t\tkey = `${key}${nestingDelimiter}`;\r\n\r\n\t\tfor (const [i, item] of value.entries()) {\r\n\t\t\tif (typeof item === 'object') {\r\n\t\t\t\tObject.assign(\r\n\t\t\t\t\tflattened,\r\n\t\t\t\t\tnormalize(\r\n\t\t\t\t\t\titem,\r\n\t\t\t\t\t\tnestingDelimiter,\r\n\t\t\t\t\t\tarrayDescomposition,\r\n\t\t\t\t\t\t`${key}${i}${nestingDelimiter}`,\r\n\t\t\t\t\t),\r\n\t\t\t\t);\r\n\t\t\t} else {\r\n\t\t\t\tflattened[`${key}${i}`] = item;\r\n\t\t\t}\r\n\t\t}\r\n\t} else {\r\n\t\tflattened[key] = value.filter((v) => typeof v !== 'object').join(',');\r\n\t}\r\n}\r\n"],"mappings":";AAUA,SAAgB,EACf,GACA,IAAmB,MACnB,IAAO,IACmB;CAC1B,IAAM,IAAqC,CAAC;CAE5C,KAAK,IAAI,KAAO,GAAK;EACpB,IAAM,IAAQ,EAAI,IACZ,IAAO,OAAO;EAEhB,YAAU,KAAA,KAAa,MAAS,eAGhC,EAAI,OAAO,KAGf;OAFA,IAAM,IAAO,GAET,MAAU,QAAQ,MAAS,YAAY,MAAM,QAAQ,CAAK,GAAG;IAChE,EAAU,KAAO;IAEjB;GACD;GAEA,OAAO,OACN,GACA,EAAQ,GAAO,GAAkB,GAAG,IAAM,GAAkB,CAC7D;EALA;CAMD;CAEA,OAAO;AACR;AAcA,SAAgB,EACf,GACA,IAAmB,MACnB,IAAsB,IACtB,IAAO,IACmB;CAC1B,IAAM,IAAqC,CAAC;CAE5C,KAAK,IAAI,KAAO,GAAK;EACpB,IAAM,IAAQ,EAAI,IACZ,IAAO,OAAO;EAEhB,WAAU,QAA+B,MAAS,aAMtD;OAFA,IAAM,KAAQ,EAAI,OAAO,MAAM,EAAI,MAAM,CAAC,IAAI,IAE1C,MAAS,UAAU;IACtB,EAAU,KAAO;IAEjB;GACD;GAEA,AAAI,MAAM,QAAQ,CAAK,IACtB,EACC,GACA,GACA,GACA,GACA,CACD,IAEA,OAAO,OACN,GACA,EACC,GACA,GACA,GACA,GAAG,IAAM,GACV,CACD;EAnBD;CAqBD;CAEA,OAAO;AACR;AAWA,SAAS,EACR,GACA,GACA,GACA,IAAmB,MACnB,IAAsB,IACf;CACP,IAAI,GAAqB;EACxB,IAAM,GAAG,IAAM;EAEf,KAAK,IAAM,CAAC,GAAG,MAAS,EAAM,QAAQ,GACrC,AAAI,OAAO,KAAS,WACnB,OAAO,OACN,GACA,EACC,GACA,GACA,GACA,GAAG,IAAM,IAAI,GACd,CACD,IAEA,EAAU,GAAG,IAAM,OAAO;CAG7B,OACC,EAAU,KAAO,EAAM,QAAQ,MAAM,OAAO,KAAM,QAAQ,EAAE,KAAK,GAAG;AAEtE"}

package/utils/schema.util.d.ts

@@ -1,11 +1,70 @@
 import { JSONSchemaType, ValidateFunction } from 'ajv';
 import { Options } from 'to-json-schema';
+/**
+ * Generates JSON schema from JSON template/object.
+ *
+ * @export
+ * @param {Record<string, unknown>} json json object
+ * @param {Options} [options]
+ *
+ * @returns {*}  {Record<string, unknown>}
+ */
 export declare function schemaFrom(json: Record<string, unknown>, options?: Options & {
     nullable?: boolean;
 }): Record<string, unknown>;
+/**
+ * Validates if a object is a JSON schema.
+ *
+ * @export
+ * @param {Record<string, unknown>} schema
+ *
+ * @returns {boolean} if is a JSON schema
+ */
 export declare function isJsonSchemaObject(schema: Record<string, unknown>): schema is JSONSchemaType<object>;
+/**
+ * Converts a JSON schema to JSON template.
+ *
+ * @export
+ * @param {Record<string, unknown>} schema JSON schema
+ * @param {Record<string, any>} [container] template container
+ *
+ * @returns {unknown} object or default value
+ */
 export declare function schemaToJson(schema: Record<string, unknown>, container?: Record<string, any>): unknown;
+/**
+ * Flatten a JSON schema.
+ *
+ * @export
+ * @param {Record<string, unknown>} schema JSON schema
+ * @param {string} [parentKey] previous level key
+ * @param {string} [nestingDelimiter] char for delimit nesting levels
+ * @param {Record<string, any>} [container] result container
+ *
+ * @returns {Record<string, unknown>} flattened schema
+ */
 export declare function flatSchema(schema: Record<string, unknown>, parentKey?: string, nestingDelimiter?: string, container?: Record<string, any>): Record<string, unknown>;
+/**
+ * Creates a JSON schema validator using AJV.
+ *
+ * @see https://ajv.js.org/
+ *
+ * @export
+ * @param {Record<string, object>} schema json schema by provider
+ * @param {boolean} enableFormats whether formats are enabled
+ *
+ * @returns {ValidateFunction} validators
+ */
 export declare function createValidator(schema: Record<string, unknown>, enableFormats?: boolean): ValidateFunction;
+/**
+ * Creates a JSON schema validator lookup using AJV.
+ *
+ * @see https://ajv.js.org/
+ *
+ * @export
+ * @param {Record<string, object>} schemaLookup json schema by provider
+ * @param {boolean} enableFormats whether formats are enabled
+ *
+ * @returns {Record<string, ValidateFunction>} validators lookup
+ */
 export declare function createValidators(schemaLookup: Record<string, object>, enableFormats?: boolean): Record<string, ValidateFunction>;
 //# sourceMappingURL=schema.util.d.ts.map