@digital-alchemy/core 0.1.0

package/dist/boilerplate/helpers/fetch.helper.js

@@ -0,0 +1,173 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildFilterString = exports.fetchCast = exports.queryToControl = exports.buildFilter = exports.controlToQuery = exports.FILTER_OPERATIONS = exports.HTTP_METHODS = void 0;
+const __1 = require("../..");
+/**
+ * Enumerates HTTP methods used in fetch requests.
+ */
+var HTTP_METHODS;
+(function (HTTP_METHODS) {
+    HTTP_METHODS["get"] = "get";
+    HTTP_METHODS["delete"] = "delete";
+    HTTP_METHODS["put"] = "put";
+    HTTP_METHODS["patch"] = "patch";
+    HTTP_METHODS["post"] = "post";
+})(HTTP_METHODS || (exports.HTTP_METHODS = HTTP_METHODS = {}));
+/**
+ * Enumerates the types of operations available for data filtering.
+ */
+var FILTER_OPERATIONS;
+(function (FILTER_OPERATIONS) {
+    // "elemMatch" functionality in mongo
+    // eslint-disable-next-line unicorn/prevent-abbreviations
+    FILTER_OPERATIONS["elem"] = "elem";
+    FILTER_OPERATIONS["regex"] = "regex";
+    FILTER_OPERATIONS["in"] = "in";
+    FILTER_OPERATIONS["nin"] = "nin";
+    FILTER_OPERATIONS["lt"] = "lt";
+    FILTER_OPERATIONS["lte"] = "lte";
+    FILTER_OPERATIONS["gt"] = "gt";
+    FILTER_OPERATIONS["gte"] = "gte";
+    FILTER_OPERATIONS["exists"] = "exists";
+    FILTER_OPERATIONS["empty"] = "empty";
+    FILTER_OPERATIONS["ne"] = "ne";
+    FILTER_OPERATIONS["eq"] = "eq";
+})(FILTER_OPERATIONS || (exports.FILTER_OPERATIONS = FILTER_OPERATIONS = {}));
+// eslint-disable-next-line sonarjs/cognitive-complexity
+function controlToQuery(value) {
+    const out = new Map();
+    if (value?.limit) {
+        out.set("limit", value.limit.toString());
+    }
+    if (value?.skip) {
+        out.set("skip", value.skip.toString());
+    }
+    if (value?.sort) {
+        out.set("sort", value.sort.join(","));
+    }
+    if (value?.select) {
+        out.set("select", value.select.join(","));
+    }
+    value?.filters?.forEach(f => {
+        let field = f.field;
+        if (f.operation && f.operation !== FILTER_OPERATIONS.eq) {
+            field = `${field}__${f.operation}`;
+        }
+        let value = f.value;
+        if (__1.is.array(value)) {
+            value = value.join(",");
+        }
+        if (value instanceof Date) {
+            value = value.toISOString();
+        }
+        if (value === null) {
+            value = "null";
+        }
+        if (field) {
+            out.set(field, (value ?? "").toString());
+        }
+    });
+    return Object.fromEntries(out.entries());
+}
+exports.controlToQuery = controlToQuery;
+function buildFilter(key, value) {
+    const [name, operation] = key.split("__");
+    switch (operation) {
+        case "in":
+        case "nin":
+            if (!__1.is.array(value)) {
+                value = __1.is.string(value) ? value.split(",") : [value];
+            }
+            return {
+                field: name,
+                operation,
+                value: value,
+            };
+        case "elem":
+            return {
+                field: name,
+                operation,
+                value: __1.is.string(value) ? JSON.parse(value) : value,
+            };
+        default:
+            return {
+                field: name,
+                operation,
+                value,
+            };
+    }
+}
+exports.buildFilter = buildFilter;
+function queryToControl(value) {
+    const filters = new Set();
+    const out = { filters };
+    const parameters = new Map(Object.entries(value));
+    parameters.forEach((value, key) => {
+        const [name, operation] = key.split("__");
+        switch (key) {
+            case "select":
+                out.select = value.split(",");
+                return;
+            case "sort":
+                out.sort = value.split(",");
+                return;
+            case "limit":
+                out.limit = Number(value);
+                return;
+            case "skip":
+                out.skip = Number(value);
+                return;
+        }
+        switch (operation) {
+            case "in":
+            case "nin":
+                filters.add({
+                    field: name,
+                    operation,
+                    value: value.split(","),
+                });
+                return;
+            case "elem":
+                filters.add({
+                    field: name,
+                    operation,
+                    value: JSON.parse(value),
+                });
+                return;
+            default:
+                filters.add({
+                    field: name,
+                    operation,
+                    value,
+                });
+        }
+    });
+    return out;
+}
+exports.queryToControl = queryToControl;
+function fetchCast(item) {
+    if (__1.is.array(item)) {
+        return item.map(i => fetchCast(i)).join(",");
+    }
+    if (item instanceof Date) {
+        return item.toISOString();
+    }
+    if (__1.is.number(item)) {
+        return item.toString();
+    }
+    if (__1.is.boolean(item)) {
+        return item ? "true" : "false";
+    }
+    return item;
+}
+exports.fetchCast = fetchCast;
+function buildFilterString(fetchWith) {
+    return new URLSearchParams({
+        ...Object.fromEntries(Object.entries(fetchWith.params ?? {}).map(([label, value]) => [
+            label,
+            fetchCast(value),
+        ])),
+    }).toString();
+}
+exports.buildFilterString = buildFilterString;
+//# sourceMappingURL=fetch.helper.js.map

package/dist/boilerplate/helpers/fetch.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.helper.js","sourceRoot":"","sources":["../../../src/boilerplate/helpers/fetch.helper.ts"],"names":[],"mappings":"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"}

package/dist/boilerplate/helpers/index.d.ts

@@ -0,0 +1,12 @@
+export * from "./cache-memory.helper";
+export * from "./cache-redis.helper";
+export * from "./config.helper";
+export * from "./config-environment-loader.helper";
+export * from "./config-file-loader.helper";
+export * from "./errors.helper";
+export * from "./events.helper";
+export * from "./fetch.helper";
+export * from "./lifecycle.helper";
+export * from "./metrics.helper";
+export * from "./testing.helper";
+export * from "./wiring.helper";

package/dist/boilerplate/helpers/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./cache-memory.helper"), exports);
+tslib_1.__exportStar(require("./cache-redis.helper"), exports);
+tslib_1.__exportStar(require("./config.helper"), exports);
+tslib_1.__exportStar(require("./config-environment-loader.helper"), exports);
+tslib_1.__exportStar(require("./config-file-loader.helper"), exports);
+tslib_1.__exportStar(require("./errors.helper"), exports);
+tslib_1.__exportStar(require("./events.helper"), exports);
+tslib_1.__exportStar(require("./fetch.helper"), exports);
+tslib_1.__exportStar(require("./lifecycle.helper"), exports);
+tslib_1.__exportStar(require("./metrics.helper"), exports);
+tslib_1.__exportStar(require("./testing.helper"), exports);
+tslib_1.__exportStar(require("./wiring.helper"), exports);
+//# sourceMappingURL=index.js.map

package/dist/boilerplate/helpers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/boilerplate/helpers/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC;AACtC,+DAAqC;AACrC,0DAAgC;AAChC,6EAAmD;AACnD,sEAA4C;AAC5C,0DAAgC;AAChC,0DAAgC;AAChC,yDAA+B;AAC/B,6DAAmC;AACnC,2DAAiC;AACjC,2DAAiC;AACjC,0DAAgC"}

package/dist/boilerplate/helpers/lifecycle.helper.d.ts

@@ -0,0 +1,43 @@
+import { TBlackHole } from "../..";
+export type LifecycleCallback = () => TBlackHole;
+export type LifecyclePrioritizedCallback = [
+    callback: LifecycleCallback,
+    priority: number
+];
+export type CallbackList = LifecyclePrioritizedCallback[];
+export type TLifeCycleRegister = (callback: LifecycleCallback, priority?: number) => void;
+export type TLifecycleBase = {
+    /**
+     * Registers a callback for the bootstrap phase, executed during the initial startup process.
+     */
+    onBootstrap: TLifeCycleRegister;
+    /**
+     * Registers a callback for immediately after the configuration phase, allowing post-configuration adjustments.
+     */
+    onPostConfig: TLifeCycleRegister;
+    /**
+     * Registers a callback for the pre-initialization phase, executed before the main initialization starts.
+     */
+    onPreInit: TLifeCycleRegister;
+    /**
+     * Registers a callback for when the system is fully initialized and ready.
+     */
+    onReady: TLifeCycleRegister;
+    /**
+     * Begins the shutdown process, typically invoked when the system is about to shut down.
+     */
+    onShutdownStart: TLifeCycleRegister;
+    /**
+     * Completes the shutdown process, executed after all shutdown procedures are complete.
+     */
+    onShutdownComplete: TLifeCycleRegister;
+};
+export type TParentLifecycle = TLifecycleBase & {
+    child: () => TLifecycleBase;
+};
+export type TChildLifecycle = TLifecycleBase;
+export type TLoadableChildLifecycle = TChildLifecycle & {
+    getCallbacks: (stage: LifecycleStages) => CallbackList;
+};
+export declare const LIFECYCLE_STAGES: readonly ["PreInit", "PostConfig", "Bootstrap", "Ready", "ShutdownStart", "ShutdownComplete"];
+export type LifecycleStages = (typeof LIFECYCLE_STAGES)[number];

package/dist/boilerplate/helpers/lifecycle.helper.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LIFECYCLE_STAGES = void 0;
+// ! This is a sorted array! Don't change the order
+exports.LIFECYCLE_STAGES = [
+    "PreInit",
+    "PostConfig",
+    "Bootstrap",
+    "Ready",
+    "ShutdownStart",
+    "ShutdownComplete",
+];
+//# sourceMappingURL=lifecycle.helper.js.map

package/dist/boilerplate/helpers/lifecycle.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.helper.js","sourceRoot":"","sources":["../../../src/boilerplate/helpers/lifecycle.helper.ts"],"names":[],"mappings":";;;AAuDA,mDAAmD;AACtC,QAAA,gBAAgB,GAAG;IAC9B,SAAS;IACT,YAAY;IACZ,WAAW;IACX,OAAO;IACP,eAAe;IACf,kBAAkB;CACV,CAAC"}

package/dist/boilerplate/helpers/metrics.helper.d.ts

@@ -0,0 +1,73 @@
+import { Counter, Gauge, Histogram, Summary } from "prom-client";
+/**
+ * Cache delete operations counter
+ */
+export declare const CACHE_DELETE_OPERATIONS_TOTAL: Counter<"prefix" | "key">;
+/**
+ * Cache get operations counter
+ */
+export declare const CACHE_GET_OPERATIONS_TOTAL: Counter<"prefix" | "key" | "hit_miss">;
+/**
+ * Tracks the number of times a scheduled task has been executed.
+ * Labels:
+ * - context: The broader category or module the schedule belongs to.
+ * - label: A user-defined label to identify the specific schedule.
+ */
+export declare const SCHEDULE_EXECUTION_COUNT: Counter<"context" | "label">;
+/**
+ * Counts the number of errors occurred during scheduled task executions.
+ * Labels:
+ * - context: The broader category or module the schedule belongs to.
+ * - label: A user-defined label to identify the specific schedule where the error occurred.
+ */
+export declare const SCHEDULE_ERRORS: Counter<"context" | "label">;
+/**
+ * Summary for Execution Time
+ */
+export declare const SCHEDULE_EXECUTION_TIME: Summary<"context" | "label">;
+/**
+ * Metric to count errors in cache driver
+ */
+export declare const CACHE_DRIVER_ERROR_COUNT: Counter<"methodName">;
+/**
+ * Cache set operations counter
+ */
+export declare const CACHE_SET_OPERATIONS_TOTAL: Counter<"prefix" | "key">;
+/**
+ * Counts the total number of initiated fetch requests.
+ */
+export declare const FETCH_REQUESTS_INITIATED: Counter<string>;
+/**
+ * Counts the total number of successfully completed fetch requests.
+ */
+export declare const FETCH_REQUESTS_SUCCESSFUL: Counter<"context" | "label">;
+/**
+ * Counts the total number of successfully completed fetch requests.
+ */
+export declare const FETCH_DOWNLOAD_REQUESTS_SUCCESSFUL: Counter<"context" | "label">;
+/**
+ * Counts the total number of failed fetch requests.
+ */
+export declare const FETCH_REQUESTS_FAILED: Counter<"context" | "label">;
+/**
+ * Measures the delay (in milliseconds) experienced by requests due to bottleneck rate limiting.
+ */
+export declare const FETCH_REQUEST_BOTTLENECK_DELAY: Summary<"context" | "label">;
+/**
+ * Gauge to count the number of errors encountered in Redis operations.
+ */
+export declare const REDIS_ERROR_COUNT: Gauge<string>;
+/**
+ * Histogram to track the latency of Redis operations in milliseconds.
+ * Buckets range from 0.1 ms to 1000 ms (1 second) for granular latency measurement.
+ */
+export declare const REDIS_OPERATION_LATENCY_MS: Histogram<string>;
+/**
+ * Counter to track the number of errors encountered in memory cache operations.
+ */
+export declare const MEMORY_CACHE_ERROR_COUNT: Counter<string>;
+/**
+ * A Prometheus gauge metric that tracks the number of unique context entries in the logger's context cache.
+ * This helps in monitoring and managing the memory usage associated with the caching of logger contexts.
+ */
+export declare const LOGGER_CONTEXT_ENTRIES_COUNT: Gauge<string>;

package/dist/boilerplate/helpers/metrics.helper.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LOGGER_CONTEXT_ENTRIES_COUNT = exports.MEMORY_CACHE_ERROR_COUNT = exports.REDIS_OPERATION_LATENCY_MS = exports.REDIS_ERROR_COUNT = exports.FETCH_REQUEST_BOTTLENECK_DELAY = exports.FETCH_REQUESTS_FAILED = exports.FETCH_DOWNLOAD_REQUESTS_SUCCESSFUL = exports.FETCH_REQUESTS_SUCCESSFUL = exports.FETCH_REQUESTS_INITIATED = exports.CACHE_SET_OPERATIONS_TOTAL = exports.CACHE_DRIVER_ERROR_COUNT = exports.SCHEDULE_EXECUTION_TIME = exports.SCHEDULE_ERRORS = exports.SCHEDULE_EXECUTION_COUNT = exports.CACHE_GET_OPERATIONS_TOTAL = exports.CACHE_DELETE_OPERATIONS_TOTAL = void 0;
+/* eslint-disable @typescript-eslint/no-magic-numbers */
+const prom_client_1 = require("prom-client");
+/**
+ * Cache delete operations counter
+ */
+exports.CACHE_DELETE_OPERATIONS_TOTAL = new prom_client_1.Counter({
+    help: "Total number of cache delete operations",
+    labelNames: ["prefix", "key"],
+    name: "digital_alchemy_boilerplate_cache_delete_operations_total",
+});
+/**
+ * Cache get operations counter
+ */
+exports.CACHE_GET_OPERATIONS_TOTAL = new prom_client_1.Counter({
+    help: "Total number of cache get operations",
+    labelNames: ["prefix", "key", "hit_miss"],
+    name: "digital_alchemy_boilerplate_cache_get_operations_total",
+});
+/**
+ * Tracks the number of times a scheduled task has been executed.
+ * Labels:
+ * - context: The broader category or module the schedule belongs to.
+ * - label: A user-defined label to identify the specific schedule.
+ */
+exports.SCHEDULE_EXECUTION_COUNT = new prom_client_1.Counter({
+    help: "Counts the number of times a scheduled task has been executed",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_schedule_execution_count",
+});
+/**
+ * Counts the number of errors occurred during scheduled task executions.
+ * Labels:
+ * - context: The broader category or module the schedule belongs to.
+ * - label: A user-defined label to identify the specific schedule where the error occurred.
+ */
+exports.SCHEDULE_ERRORS = new prom_client_1.Counter({
+    help: "Counts the number of errors during scheduled task executions",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_schedule_errors",
+});
+/**
+ * Summary for Execution Time
+ */
+exports.SCHEDULE_EXECUTION_TIME = new prom_client_1.Summary({
+    help: "Measures the duration of each cron job or interval execution",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_schedule_execution_time",
+    // These percentiles are just examples; adjust them based on what's relevant for your analysis
+    percentiles: [0.5, 0.9, 0.99],
+});
+/**
+ * Metric to count errors in cache driver
+ */
+exports.CACHE_DRIVER_ERROR_COUNT = new prom_client_1.Counter({
+    help: "Counts the number of errors caught in the cache driver",
+    labelNames: ["methodName"],
+    name: "digital_alchemy_boilerplate_cache_driver_error_count",
+});
+/**
+ * Cache set operations counter
+ */
+exports.CACHE_SET_OPERATIONS_TOTAL = new prom_client_1.Counter({
+    help: "Total number of cache set operations",
+    labelNames: ["prefix", "key"],
+    name: "digital_alchemy_boilerplate_cache_set_operations_total",
+});
+/**
+ * Counts the total number of initiated fetch requests.
+ */
+exports.FETCH_REQUESTS_INITIATED = new prom_client_1.Counter({
+    help: "Total number of fetch requests that have been initiated",
+    name: "digital_alchemy_boilerplate_fetch_requests_initiated_total",
+});
+/**
+ * Counts the total number of successfully completed fetch requests.
+ */
+exports.FETCH_REQUESTS_SUCCESSFUL = new prom_client_1.Counter({
+    help: "Total number of fetch requests that have been successfully completed",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_fetch_requests_successful_total",
+});
+/**
+ * Counts the total number of successfully completed fetch requests.
+ */
+exports.FETCH_DOWNLOAD_REQUESTS_SUCCESSFUL = new prom_client_1.Counter({
+    help: "Total number of fetch download requests that have been successfully completed",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_fetch_download_requests_successful_total",
+});
+/**
+ * Counts the total number of failed fetch requests.
+ */
+exports.FETCH_REQUESTS_FAILED = new prom_client_1.Counter({
+    help: "Total number of fetch requests that have failed",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_fetch_requests_failed_total",
+});
+/**
+ * Measures the delay (in milliseconds) experienced by requests due to bottleneck rate limiting.
+ */
+exports.FETCH_REQUEST_BOTTLENECK_DELAY = new prom_client_1.Summary({
+    help: "Delay in milliseconds experienced by requests due to bottleneck rate limiting",
+    labelNames: ["context", "label"],
+    name: "digital_alchemy_boilerplate_fetch_request_bottleneck_delay_milliseconds",
+    percentiles: [0.5, 0.9, 0.99],
+});
+/**
+ * Gauge to count the number of errors encountered in Redis operations.
+ */
+exports.REDIS_ERROR_COUNT = new prom_client_1.Gauge({
+    help: "Counts the number of errors encountered in Redis operations",
+    name: "digital_alchemy_boilerplate_redis_error_count",
+});
+/**
+ * Histogram to track the latency of Redis operations in milliseconds.
+ * Buckets range from 0.1 ms to 1000 ms (1 second) for granular latency measurement.
+ */
+exports.REDIS_OPERATION_LATENCY_MS = new prom_client_1.Histogram({
+    buckets: [0.1, 0.5, 1, 5, 10, 20, 50, 100, 200, 500, 1000],
+    help: "Histogram for tracking the latency of Redis operations in milliseconds",
+    name: "digital_alchemy_boilerplate_redis_operation_latency_ms",
+});
+/**
+ * Counter to track the number of errors encountered in memory cache operations.
+ */
+exports.MEMORY_CACHE_ERROR_COUNT = new prom_client_1.Counter({
+    help: "Counts the number of errors encountered in memory cache operations",
+    name: "digital_alchemy_boilerplate_memory_cache_error_count",
+});
+/**
+ * A Prometheus gauge metric that tracks the number of unique context entries in the logger's context cache.
+ * This helps in monitoring and managing the memory usage associated with the caching of logger contexts.
+ */
+exports.LOGGER_CONTEXT_ENTRIES_COUNT = new prom_client_1.Gauge({
+    help: "Number of unique context entries in the logger context cache",
+    name: "digital_alchemy_boilerplate_logger_context_entries_count",
+});
+//# sourceMappingURL=metrics.helper.js.map

package/dist/boilerplate/helpers/metrics.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.helper.js","sourceRoot":"","sources":["../../../src/boilerplate/helpers/metrics.helper.ts"],"names":[],"mappings":"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"}

package/dist/boilerplate/helpers/testing.helper.d.ts

@@ -0,0 +1,13 @@
+export declare const TESTING_APP_NAME = "digital-alchemy-unit-tests";
+export type RandomFileTestingDataFormat = object;
+export declare function ConfigurationFiles(): {
+    dataMap: Map<string, object>;
+    link: (paths?: string[]) => void;
+    sort: (filePaths: string[]) => string[];
+    unlink: (path?: string) => void;
+};
+declare module "../../utilities" {
+    interface ZCCTestingDefinition {
+        configurationFiles: typeof ConfigurationFiles;
+    }
+}

package/dist/boilerplate/helpers/testing.helper.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ConfigurationFiles = exports.TESTING_APP_NAME = void 0;
+const fs_1 = require("fs");
+const ini_1 = require("ini");
+const js_yaml_1 = require("js-yaml");
+const os_1 = require("os");
+const path_1 = require("path");
+const process_1 = require("process");
+const __1 = require("../..");
+exports.TESTING_APP_NAME = "digital-alchemy-unit-tests";
+function ConfigurationFiles() {
+    const testDataMap = new Map();
+    function writeConfigFile(filePath, data, encodingType) {
+        let content;
+        encodingType = encodingType || (0, path_1.extname)(filePath).slice(__1.SINGLE) || "ini";
+        switch (encodingType) {
+            case "json":
+                content = JSON.stringify(data);
+                break;
+            case "yaml":
+                content = (0, js_yaml_1.dump)(data);
+                break;
+            default:
+                content = (0, ini_1.encode)(data); // Default to ini
+                break;
+        }
+        (0, fs_1.writeFileSync)(filePath, content);
+        testDataMap.set(filePath, data);
+    }
+    return {
+        dataMap: testDataMap,
+        link: (paths) => {
+            __1.is.unique(__1.is.empty(paths)
+                ? [(0, process_1.cwd)(), (0, path_1.join)((0, os_1.homedir)(), ".config")].flatMap(base => [
+                    (0, path_1.join)(base, exports.TESTING_APP_NAME),
+                    (0, path_1.join)(base, `${exports.TESTING_APP_NAME}.json`),
+                    (0, path_1.join)(base, `${exports.TESTING_APP_NAME}.ini`),
+                    (0, path_1.join)(base, `${exports.TESTING_APP_NAME}.yaml`),
+                ])
+                : paths).forEach(filename => {
+                console.log("FIXME: GENERATE RANDOM DATA", filename, writeConfigFile);
+                // const data = ZCC_Testing.generateRandomData();
+                // writeConfigFile(filename, data);
+            });
+        },
+        sort: (filePaths) => {
+            const dirOrder = [
+                (0, path_1.join)("/etc", exports.TESTING_APP_NAME, "config"),
+                (0, path_1.join)("/etc", exports.TESTING_APP_NAME, "config.json"),
+                (0, path_1.join)("/etc", exports.TESTING_APP_NAME, "config.ini"),
+                (0, path_1.join)("/etc", exports.TESTING_APP_NAME, "config.yaml"),
+                (0, path_1.join)("/etc", `${exports.TESTING_APP_NAME}rc`),
+                (0, path_1.join)("/etc", `${exports.TESTING_APP_NAME}rc.json`),
+                (0, path_1.join)("/etc", `${exports.TESTING_APP_NAME}rc.ini`),
+                (0, path_1.join)("/etc", `${exports.TESTING_APP_NAME}rc.yaml`),
+                (0, path_1.join)((0, process_1.cwd)(), `.${exports.TESTING_APP_NAME}rc`),
+                (0, path_1.join)((0, process_1.cwd)(), `.${exports.TESTING_APP_NAME}rc.json`),
+                (0, path_1.join)((0, process_1.cwd)(), `.${exports.TESTING_APP_NAME}rc.ini`),
+                (0, path_1.join)((0, process_1.cwd)(), `.${exports.TESTING_APP_NAME}rc.yaml`),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", exports.TESTING_APP_NAME),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", `${exports.TESTING_APP_NAME}.json`),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", `${exports.TESTING_APP_NAME}.ini`),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", `${exports.TESTING_APP_NAME}.yaml`),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", exports.TESTING_APP_NAME, "config"),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", exports.TESTING_APP_NAME, "config.json"),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", exports.TESTING_APP_NAME, "config.ini"),
+                (0, path_1.join)((0, os_1.homedir)(), ".config", exports.TESTING_APP_NAME, "config.yaml"),
+            ].reverse();
+            return filePaths
+                .filter(path => dirOrder.includes(path))
+                .sort((a, b) => dirOrder.indexOf(a) - dirOrder.indexOf(b));
+        },
+        unlink: (path) => {
+            if (path) {
+                if (testDataMap.has(path)) {
+                    (0, fs_1.existsSync)(path) && (0, fs_1.unlinkSync)(path);
+                    testDataMap.delete(path);
+                    return;
+                }
+                return;
+            }
+            testDataMap.forEach((_, filePath) => {
+                (0, fs_1.existsSync)(filePath) && (0, fs_1.unlinkSync)(filePath);
+            });
+        },
+    };
+}
+exports.ConfigurationFiles = ConfigurationFiles;
+__1.ZCC_Testing.configurationFiles = ConfigurationFiles;
+//# sourceMappingURL=testing.helper.js.map

package/dist/boilerplate/helpers/testing.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.helper.js","sourceRoot":"","sources":["../../../src/boilerplate/helpers/testing.helper.ts"],"names":[],"mappings":"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"}