@datatruck/cli 0.32.3 → 0.33.0

package/lib/utils/datatruck/cron-server.js

@@ -1,28 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createCronServer = void 0;
-const CommandFactory_1 = require("../../Factory/CommandFactory");
+const ConfigAction_1 = require("../../actions/ConfigAction");
 const cli_1 = require("../cli");
+const cron_1 = require("../cron");
 const process_1 = require("../process");
+const string_1 = require("../string");
+const watcher_1 = require("../watcher");
+const command_1 = require("./command");
 const croner_1 = require("croner");
-function createJobs(actions, currentJobs = [], worker) {
+function createJobs(actions, worker) {
     const jobs = [];
     for (const action of actions) {
         const index = actions.indexOf(action);
-        const context = JSON.stringify({
-            index: actions.indexOf(action),
-            data: action,
-        });
-        const job = currentJobs.at(index);
-        if (!job || job.options.context !== context) {
-            job?.stop();
-            jobs.push((0, croner_1.Cron)(action.schedule, {
-                paused: true,
-                context: JSON.stringify(action),
-                catch: true,
-                protect: true,
-            }, () => worker(action, index)));
-        }
+        jobs.push((0, croner_1.Cron)(typeof action.schedule === "string"
+            ? action.schedule
+            : (0, cron_1.formatCronScheduleObject)(action.schedule), {
+            paused: true,
+            context: index,
+            catch: true,
+            protect: true,
+        }, () => worker(action, index)));
     }
     return jobs;
 }
@@ -31,9 +29,9 @@ function createCronServer(options, config) {
         if (config.log)
             console.info(`> [job] ${index} - ${action.name}`);
         try {
-            const Command = (0, CommandFactory_1.CommandConstructorFactory)(action.name);
+            const Command = command_1.datatruckCommandMap[action.name];
             const command = new Command({ config: { packages: [], repositories: [] } }, {});
-            const cliOptions = (0, cli_1.stringifyOptions)(command.onOptions(), action.options);
+            const cliOptions = (0, cli_1.stringifyOptions)(command.optionsConfig(), action.options);
             const [node, bin] = process.argv;
             await (0, process_1.exec)(node, [bin, "-c", config.configPath, action.name, ...cliOptions], {}, { log: config.verbose });
             if (config.log)
@@ -44,16 +42,36 @@ function createCronServer(options, config) {
                 console.error(`< [job] ${index} - ${action.name}`, error);
         }
     };
-    const jobs = createJobs(options.actions || [], [], worker);
-    return {
+    let jobs = createJobs(options.actions || [], worker);
+    const watcher = (0, watcher_1.createWatcher)({
+        onRead: () => ConfigAction_1.ConfigAction.findAndParseFile(config.configPath),
+        onCheck: (prev, current) => (0, string_1.compareJsons)(prev, current),
+        onError: (error) => {
+            if (config.log)
+                console.error(`< [jobs] update error`, error);
+        },
+        onChange: (data) => {
+            if (config.log)
+                console.info(`[jobs] updated`);
+            handler.stop();
+            const cron = data?.server?.cron;
+            const enabled = cron?.enabled ?? true;
+            jobs = enabled ? createJobs(cron?.actions || [], worker) : [];
+            handler.start();
+        },
+    });
+    const handler = {
         start: () => {
             for (const job of jobs)
                 job.resume();
+            watcher.start();
         },
         stop: () => {
+            watcher.stop();
             for (const job of jobs)
                 job.stop();
         },
     };
+    return handler;
 }
 exports.createCronServer = createCronServer;

package/lib/utils/datatruck/paths.d.ts

@@ -1,6 +1,6 @@
-import { PackageConfig } from "../../Config/PackageConfig";
-import { PreSnapshot } from "../../Repository/RepositoryAbstract";
+import { PreSnapshot } from "../../repositories/RepositoryAbstract";
 import { SpawnStep } from "../spawnSteps";
+import type { PackageConfig } from "./config-type";
 export type ParsePathsOptions = {
     cwd?: string;
     verbose?: boolean;

package/lib/utils/datatruck/report-list.d.ts

@@ -0,0 +1,12 @@
+import { Listr3, Listr3TaskResult, List3SummaryResult } from "../list";
+import { DatatruckReportConfig } from "./config-type";
+export type ReportListTaskContext = {
+    report: {
+        type: string;
+    };
+};
+export declare function createReportListTasks<T extends ReportListTaskContext>(list: Listr3<T>, options: {
+    reports: DatatruckReportConfig[];
+    onMessage: (result: (List3SummaryResult | Listr3TaskResult<T>)[], report: DatatruckReportConfig) => string;
+    verbose?: boolean;
+}): import("listr2").ListrTask<any, any, any>[];

package/lib/utils/datatruck/report-list.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createReportListTasks = void 0;
+const reportSteps_1 = require("../reportSteps");
+const spawnSteps_1 = require("../spawnSteps");
+function createReportListTasks(list, options) {
+    return options.reports.map((report, index) => {
+        const reportIndex = index + 1;
+        return list.$task({
+            title: {
+                initial: `Send report ${reportIndex}`,
+                started: `Sending report ${reportIndex}`,
+                completed: `Report sent: ${reportIndex}`,
+                failed: `Report send failed: ${reportIndex}`,
+            },
+            key: "report",
+            keyIndex: index,
+            data: { type: report.run.type },
+            exitOnError: false,
+            run: async (task) => {
+                const result = list.getResult().filter((r) => r.key !== "report");
+                const success = result.every((r) => !r.error);
+                const enabled = !report.when ||
+                    (report.when === "success" && success) ||
+                    (report.when === "error" && !success);
+                if (!enabled)
+                    return task.skip(`Report send skipped: ${reportIndex}`);
+                const message = options.onMessage(result, report);
+                if ((0, spawnSteps_1.isSpawnStep)(report.run)) {
+                    await (0, spawnSteps_1.runSpawnSteps)(report.run, {
+                        data: {
+                            dtt: {
+                                message,
+                                result,
+                                success,
+                            },
+                        },
+                        verbose: options.verbose,
+                    });
+                }
+                else if ((0, reportSteps_1.isReportStep)(report.run)) {
+                    await (0, reportSteps_1.runReportSteps)(report.run, {
+                        data: {
+                            title: "DTT Backup",
+                            message,
+                            success,
+                        },
+                    });
+                }
+                else {
+                    throw new Error(`Invalid step type: ${report.run.type}`);
+                }
+            },
+        });
+    });
+}
+exports.createReportListTasks = createReportListTasks;

package/lib/utils/datatruck/repository-server.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createDatatruckRepositoryServer = exports.headerKey = void 0;
-const ConfigAction_1 = require("../../Action/ConfigAction");
+const ConfigAction_1 = require("../../actions/ConfigAction");
 const http_1 = require("../http");
 const virtual_fs_1 = require("../virtual-fs");
 const fs_1 = require("fs");
@@ -67,7 +67,8 @@ function createDatatruckRepositoryServer(inOptions, config = {}) {
                 return res.end();
             }
             const fileOptions = config.configPath
-                ? (await ConfigAction_1.ConfigAction.parseFile(config.configPath)).server?.repository
+                ? (await ConfigAction_1.ConfigAction.findAndParseFile(config.configPath)).server
+                    ?.repository
                 : undefined;
             const options = fileOptions ?? inOptions;
             const backend = findRepositoryBackend(req, repository, options);

package/lib/utils/datatruck/repository.d.ts

@@ -0,0 +1,16 @@
+import { DatatruckRepository } from "../../repositories/DatatruckRepository";
+import { GitRepository } from "../../repositories/GitRepository";
+import type { RepositoryAbstract } from "../../repositories/RepositoryAbstract";
+import { ResticRepository } from "../../repositories/ResticRepository";
+import type { RepositoryConfig } from "./config-type";
+declare const repoMap: {
+    git: typeof GitRepository;
+    restic: typeof ResticRepository;
+    datatruck: typeof DatatruckRepository;
+};
+export declare function getRepoConstructor(type: keyof typeof repoMap): {
+    new (config: RepositoryConfig): RepositoryAbstract<any>;
+};
+export declare function createRepo(repository: RepositoryConfig): RepositoryAbstract<any>;
+export declare function createAndInitRepo(repository: RepositoryConfig, verbose?: boolean): Promise<RepositoryAbstract<any>>;
+export {};

package/lib/utils/datatruck/repository.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAndInitRepo = exports.createRepo = exports.getRepoConstructor = void 0;
+const DatatruckRepository_1 = require("../../repositories/DatatruckRepository");
+const GitRepository_1 = require("../../repositories/GitRepository");
+const ResticRepository_1 = require("../../repositories/ResticRepository");
+const error_1 = require("./error");
+const repoMap = {
+    [GitRepository_1.gitRepositoryName]: GitRepository_1.GitRepository,
+    [ResticRepository_1.resticRepositoryName]: ResticRepository_1.ResticRepository,
+    [DatatruckRepository_1.datatruckRepositoryName]: DatatruckRepository_1.DatatruckRepository,
+};
+function getRepoConstructor(type) {
+    const Constructor = repoMap[type];
+    if (!Constructor)
+        throw new error_1.AppError(`Invalid repository type: ${type}`);
+    return Constructor;
+}
+exports.getRepoConstructor = getRepoConstructor;
+function createRepo(repository) {
+    const Constructor = getRepoConstructor(repository.type);
+    return new Constructor(repository);
+}
+exports.createRepo = createRepo;
+async function createAndInitRepo(repository, verbose) {
+    const repo = createRepo(repository);
+    await repo.init({ options: { verbose } });
+    return repo;
+}
+exports.createAndInitRepo = createAndInitRepo;

package/lib/utils/datatruck/snapshot.d.ts

@@ -1,5 +1,5 @@
-import { SnapshotGroupByType } from "../../Action/SnapshotsAction";
-import { Snapshot } from "../../Repository/RepositoryAbstract";
+import { SnapshotGroupByType } from "../../actions/SnapshotsAction";
+import { Snapshot } from "../../repositories/RepositoryAbstract";
 import { FilterByLastOptions } from "../date";
 export declare function groupAndFilter<TSnapshot extends Snapshot>(snapshots: TSnapshot[], groupKeys?: SnapshotGroupByType[], inFilter?: FilterByLastOptions | ((group: TSnapshot[]) => FilterByLastOptions | string)): {
     item: TSnapshot;

package/lib/utils/datatruck/task.d.ts

@@ -0,0 +1,3 @@
+import type { TaskAbstract } from "../../tasks/TaskAbstract";
+import type { TaskConfig } from "./config-type";
+export declare function createTask(task: TaskConfig): TaskAbstract;

package/lib/{Factory/TaskFactory.js → utils/datatruck/task.js}

@@ -1,13 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createTask = void 0;
-const AppError_1 = require("../Error/AppError");
-const GitTask_1 = require("../Task/GitTask");
-const MariadbTask_1 = require("../Task/MariadbTask");
-const MssqlTask_1 = require("../Task/MssqlTask");
-const MysqlDumpTask_1 = require("../Task/MysqlDumpTask");
-const PostgresqlDumpTask_1 = require("../Task/PostgresqlDumpTask");
-const ScriptTask_1 = require("../Task/ScriptTask");
+const GitTask_1 = require("../../tasks/GitTask");
+const MariadbTask_1 = require("../../tasks/MariadbTask");
+const MssqlTask_1 = require("../../tasks/MssqlTask");
+const MysqlDumpTask_1 = require("../../tasks/MysqlDumpTask");
+const PostgresqlDumpTask_1 = require("../../tasks/PostgresqlDumpTask");
+const ScriptTask_1 = require("../../tasks/ScriptTask");
+const error_1 = require("./error");
 function createTask(task) {
     if (task.name === GitTask_1.gitTaskName) {
         return new GitTask_1.GitTask(task.config ?? {});
@@ -28,7 +28,7 @@ function createTask(task) {
         return new ScriptTask_1.ScriptTask(task.config ?? {});
     }
     else {
-        throw new AppError_1.AppError(`Invalid task name: ${task["name"]}`);
+        throw new error_1.AppError(`Invalid task name: ${task["name"]}`);
     }
 }
 exports.createTask = createTask;

package/lib/utils/date.js

@@ -27,7 +27,10 @@ function createFilterByLastOptions(keep) {
 exports.createFilterByLastOptions = createFilterByLastOptions;
 function filterByLast(items, options) {
     const filters = {
-        last: { handler: (_, i) => i.toString(), value: options.last },
+        last: {
+            handler: (_, i) => i.toString(),
+            value: options.last,
+        },
         lastMinutely: {
             handler: (d) => d.format("YYYYMMDDHHmm"),
             value: options.lastMinutely,
@@ -53,7 +56,8 @@ function filterByLast(items, options) {
     let someFilter = false;
     for (const key in filters) {
         const object = filters[key];
-        if (object?.value) {
+        if (object?.value ||
+            (key === "last" && typeof object?.value === "number")) {
             someFilter = true;
         }
     }

package/lib/utils/fs.d.ts

@@ -18,6 +18,7 @@ export declare function existsDir(path: string): Promise<boolean>;
 export declare function existsFile(path: string): Promise<boolean>;
 export declare function writeJSONFile<T = any>(path: string, json: T): Promise<void>;
 export declare const parseFileExtensions: string[];
+export declare function include(path: string): any;
 export declare function parseFile(path: string, jsKey?: string): Promise<any>;
 export declare function parsePackageFile(): {
     name: string;
@@ -41,6 +42,8 @@ export declare function waitForClose(stream: WriteStream | ReadStream): Promise<
 export declare function copyFileWithStreams(source: string, target: string): Promise<unknown>;
 export declare function updateFileStats(path: string, fileInfo: Stats): Promise<void>;
 export declare function isNotFoundError(error: unknown): boolean;
+export declare function readTextFile(path: string): Promise<string>;
+export declare function readTextFile(path: string, onlyIfExists: true): Promise<string | undefined>;
 export declare function cpy(options: {
     input: {
         type: "glob";

package/lib/utils/fs.js

@@ -3,7 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.asFile = exports.groupFiles = exports.ensureFreeDiskSpace = exports.checkFreeDiskSpace = exports.fetchDiskStats = exports.initEmptyDir = exports.tryRm = exports.safeRename = exports.fetchData = exports.countFileLines = exports.createWriteStreamPool = exports.createFileScanner = exports.createProgress = exports.cpy = exports.isNotFoundError = exports.updateFileStats = exports.copyFileWithStreams = exports.waitForClose = exports.writeGitIgnoreList = exports.fastglobToGitIgnore = exports.forEachFile = exports.readDir = exports.readPartialFile = exports.fastFolderSizeAsync = exports.findFile = exports.parsePackageFile = exports.parseFile = exports.parseFileExtensions = exports.writeJSONFile = exports.existsFile = exports.existsDir = exports.safeStat = exports.ensureExistsDir = exports.ensureSingleFile = exports.ensureEmptyDir = exports.mkdirIfNotExists = exports.isLocalDir = exports.isEmptyDir = exports.isWSLSystem = void 0;
+exports.asFile = exports.groupFiles = exports.ensureFreeDiskSpace = exports.checkFreeDiskSpace = exports.fetchDiskStats = exports.initEmptyDir = exports.tryRm = exports.safeRename = exports.fetchData = exports.countFileLines = exports.createWriteStreamPool = exports.createFileScanner = exports.createProgress = exports.cpy = exports.readTextFile = exports.isNotFoundError = exports.updateFileStats = exports.copyFileWithStreams = exports.waitForClose = exports.writeGitIgnoreList = exports.fastglobToGitIgnore = exports.forEachFile = exports.readDir = exports.readPartialFile = exports.fastFolderSizeAsync = exports.findFile = exports.parsePackageFile = exports.parseFile = exports.include = exports.parseFileExtensions = exports.writeJSONFile = exports.existsFile = exports.existsDir = exports.safeStat = exports.ensureExistsDir = exports.ensureSingleFile = exports.ensureEmptyDir = exports.mkdirIfNotExists = exports.isLocalDir = exports.isEmptyDir = exports.isWSLSystem = void 0;
 const pkg_1 = require("../pkg");
 const bytes_1 = require("./bytes");
 const math_1 = require("./math");
@@ -20,6 +20,7 @@ const path_1 = require("path");
 const path_2 = require("path");
 const readline_1 = require("readline");
 const util_1 = require("util");
+const yaml_1 = require("yaml");
 exports.isWSLSystem = (0, os_1.release)().includes("microsoft-standard-WSL");
 async function isEmptyDir(path) {
     const iterator = await (0, promises_1.opendir)(path);
@@ -87,6 +88,12 @@ async function writeJSONFile(path, json) {
 }
 exports.writeJSONFile = writeJSONFile;
 exports.parseFileExtensions = ["json", "js", "ts", "yaml", "yml"];
+function include(path) {
+    path = (0, path_1.resolve)(path);
+    delete require.cache[path];
+    return require(path);
+}
+exports.include = include;
 async function parseFile(path, jsKey) {
     if (!(0, path_2.isAbsolute)(path))
         path = (0, path_1.join)(process.cwd(), path);
@@ -95,13 +102,13 @@ async function parseFile(path, jsKey) {
         $require("ts-node").register();
     if (path.endsWith(".yaml") || path.endsWith("yml")) {
         const contents = await (0, promises_1.readFile)(path);
-        return require("yaml").parse(contents.toString());
+        return (0, yaml_1.parse)(contents.toString());
     }
     else if (path.endsWith(".json")) {
-        return require(path);
+        return include(path);
     }
     else {
-        const object = require(path);
+        const object = include(path);
         const value = jsKey ? object[jsKey] : object;
         return typeof value === "function" ? await value() : value;
     }
@@ -275,6 +282,19 @@ function isNotFoundError(error) {
     return error.code === "ENOENT";
 }
 exports.isNotFoundError = isNotFoundError;
+async function readTextFile(path, onlyIfExists) {
+    let buffer;
+    try {
+        buffer = await (0, promises_1.readFile)(path);
+    }
+    catch (error) {
+        if (onlyIfExists && isNotFoundError(error))
+            return;
+        throw error;
+    }
+    return buffer.toString();
+}
+exports.readTextFile = readTextFile;
 async function cpy(options) {
     const stats = { paths: 0, files: 0, dirs: 0 };
     const dirs = new Set();

package/lib/utils/list.d.ts

@@ -32,13 +32,13 @@ type List3TaskResultObject<K, D extends Record<string, any>> = {
     elapsed: number;
     error?: Error;
 };
-type SummaryResult = List3TaskResultObject<"summary", {
+export type List3SummaryResult = List3TaskResultObject<"summary", {
     errors: number;
 }>;
 export type Listr3TaskResult<T extends Listr3Context> = {
     [K in keyof T]: List3TaskResultObject<K, T[K]>;
 }[keyof T];
-export type Listr3TaskResultEnd<T extends Listr3Context> = Listr3TaskResult<T> | SummaryResult;
+export type Listr3TaskResultEnd<T extends Listr3Context> = Listr3TaskResult<T> | List3SummaryResult;
 export declare class Listr3<T extends Listr3Context> extends Listr<void, "default", "simple"> {
     readonly $options: {
         streams?: Streams;
@@ -58,9 +58,9 @@ export declare class Listr3<T extends Listr3Context> extends Listr<void, "defaul
     $task<K extends keyof T>(item: Listr3Task<T, K>): ListrTask;
     $tasks<K extends keyof T>(...items: (Listr3Task<T, K> | ListrTask | false)[]): ListrTask[];
     add(tasks: ListrTask<void, ListrGetRendererClassFromValue<"default">> | ListrTask<void, ListrGetRendererClassFromValue<"default">>[]): this;
-    getSummaryResult(): SummaryResult;
-    getResult(): (SummaryResult | Listr3TaskResult<T>)[];
+    getSummaryResult(): List3SummaryResult;
+    getResult(): (List3SummaryResult | Listr3TaskResult<T>)[];
     protected release(): void;
-    exec(): Promise<(Listr3TaskResult<T> | SummaryResult)[]>;
+    exec(): Promise<(Listr3TaskResult<T> | List3SummaryResult)[]>;
 }
 export {};

package/lib/utils/mysql.js

@@ -1,8 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createMysqlCli = exports.assertDumpFile = void 0;
-const AppError_1 = require("../Error/AppError");
 const cli_1 = require("./cli");
+const error_1 = require("./datatruck/error");
 const fs_1 = require("./fs");
 const process_1 = require("./process");
 const string_1 = require("./string");
@@ -32,12 +32,12 @@ async function assertDumpFile(path) {
             firstLine.startsWith("-- mariadb dump"));
     });
     if (!successHeader)
-        throw new AppError_1.AppError("No start line found");
+        throw new error_1.AppError("No start line found");
     const successFooter = footerContents
         .split(/\r?\n/)
         .some((line) => line.trim().toLowerCase().startsWith("-- dump completed"));
     if (!successFooter)
-        throw new AppError_1.AppError("No end line found (incomplete backup)");
+        throw new error_1.AppError("No end line found (incomplete backup)");
 }
 exports.assertDumpFile = assertDumpFile;
 async function createMysqlCli(options) {
@@ -223,7 +223,7 @@ async function createMysqlCli(options) {
     async function initSharedDir(sharedDir) {
         const secure_file_priv = await fetchVariable("secure_file_priv");
         if (secure_file_priv?.toUpperCase() === "NULL")
-            throw new AppError_1.AppError("'secure_file_priv' is null in MySQL Server");
+            throw new error_1.AppError("'secure_file_priv' is null in MySQL Server");
         const dir = sharedDir ??
             secure_file_priv ??
             (await fetchVariable("tmpdir")) ??
@@ -241,7 +241,7 @@ async function createMysqlCli(options) {
             await sql.execute(`SELECT 1 INTO OUTFILE ${outFileVar}`);
             const exists = await (0, fs_1.existsFile)(outFile);
             if (!exists)
-                throw new AppError_1.AppError(`MySQL shared dir is not reached: ${dir}`);
+                throw new error_1.AppError(`MySQL shared dir is not reached: ${dir}`);
         }
         finally {
             try {

package/lib/utils/object.d.ts

@@ -4,4 +4,17 @@ export declare function getErrorProperties(error: Error): Record<string, string>
 type GroupByKeyParamType<TItem> = ((item: TItem) => string[] | string) | (keyof TItem)[] | keyof TItem;
 export declare function groupBy<TItem>(items: TItem[], keyOrCb: GroupByKeyParamType<TItem>): Record<string, TItem[]>;
 export declare function groupBy<TItem>(items: TItem[], keyOrCb: GroupByKeyParamType<TItem>, single: true): Record<string, TItem>;
+export declare class StrictMap<K, V> {
+    readonly serializeKey: (params: K) => string;
+    constructor(serializeKey: (params: K) => string);
+    readonly map: Map<string, V | undefined>;
+    has(key: K): boolean;
+    get(key: K): NonNullable<V>;
+    set(key: K, value: V): void;
+    with(key: K): {
+        has: () => boolean;
+        get: () => NonNullable<V>;
+        set: (value: V) => void;
+    };
+}
 export {};

package/lib/utils/object.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.groupBy = exports.getErrorProperties = exports.omitProp = exports.merge = void 0;
+exports.StrictMap = exports.groupBy = exports.getErrorProperties = exports.omitProp = exports.merge = void 0;
 function merge(target, ...sources) {
     const isObject = (o) => typeof o === "object" && o !== null;
     for (const source of sources)
@@ -56,3 +56,34 @@ function groupBy(items, keyOrCb, single) {
     }
 }
 exports.groupBy = groupBy;
+class StrictMap {
+    serializeKey;
+    constructor(serializeKey) {
+        this.serializeKey = serializeKey;
+    }
+    map = new Map();
+    has(key) {
+        return this.map.has(this.serializeKey(key));
+    }
+    get(key) {
+        const stringKey = this.serializeKey(key);
+        const value = this.map.get(stringKey);
+        if (!value)
+            throw new Error(`Map key does not exist: ${stringKey}`);
+        return value;
+    }
+    set(key, value) {
+        const stringKey = this.serializeKey(key);
+        if (this.map.has(stringKey))
+            throw new Error(`Map key already exists: ${stringKey}`);
+        this.map.set(stringKey, value);
+    }
+    with(key) {
+        return {
+            has: () => this.has(key),
+            get: () => this.get(key),
+            set: (value) => this.set(key, value),
+        };
+    }
+}
+exports.StrictMap = StrictMap;

package/lib/utils/process.js

@@ -322,7 +322,10 @@ async function exec(command, argv = [], options = null, settings = {}) {
                 rl.on("line", onData);
                 rl.on("close", tryFinish);
             }
-            else if (log[type] || settings[type]?.save || settings[type]?.onData) {
+            else if (log[type] ||
+                settings[type]?.save ||
+                settings[type]?.onData ||
+                (type === "stderr" && settings[type]?.toExitCode)) {
                 p[type].on("data", onData);
             }
         }

package/lib/utils/string.d.ts

@@ -17,4 +17,5 @@ export declare function endsWith(input: string, patterns: string[]): boolean;
 export declare function createMatchFilter(include?: string[], exclude?: string[]): (input: string) => boolean;
 export declare function checkMatch(subject: string | undefined, patterns: string[]): boolean;
 export declare function undefIfEmpty(input: string): string | undefined;
+export declare function compareJsons(a: any, b: any): boolean;
 export {};

package/lib/utils/string.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.undefIfEmpty = exports.checkMatch = exports.createMatchFilter = exports.endsWith = exports.match = exports.makePathPatterns = exports.formatUri = exports.parseStringList = exports.render = exports.snakeCase = void 0;
-const AppError_1 = require("../Error/AppError");
+exports.compareJsons = exports.undefIfEmpty = exports.checkMatch = exports.createMatchFilter = exports.endsWith = exports.match = exports.makePathPatterns = exports.formatUri = exports.parseStringList = exports.render = exports.snakeCase = void 0;
+const error_1 = require("./datatruck/error");
 const micromatch_1 = require("micromatch");
 function snakeCase(value, char = "_") {
     return value.replace(/[A-Z]/g, (letter) => `${char}${letter.toLowerCase()}`);
@@ -47,7 +47,7 @@ function parseStringList(value, validValues, defaultsValues) {
     if (validValues)
         for (const v of result)
             if (!validValues.includes(v))
-                throw new AppError_1.AppError(`Invalid value: ${v}`);
+                throw new error_1.AppError(`Invalid value: ${v}`);
     return result;
 }
 exports.parseStringList = parseStringList;
@@ -105,3 +105,7 @@ function undefIfEmpty(input) {
     return input.length ? input : undefined;
 }
 exports.undefIfEmpty = undefIfEmpty;
+function compareJsons(a, b) {
+    return JSON.stringify(a) === JSON.stringify(b);
+}
+exports.compareJsons = compareJsons;

package/lib/utils/ts.d.ts

@@ -0,0 +1,16 @@
+export type DeepReadonly<T> = T extends (infer R)[] ? DeepReadonlyArray<R> : T extends Function ? T : T extends object ? DeepReadonlyObject<T> : T;
+export interface DeepReadonlyArray<T> extends ReadonlyArray<DeepReadonly<T>> {
+}
+export type DeepReadonlyObject<T> = {
+    readonly [P in keyof T]: DeepReadonly<T[P]>;
+};
+export type If<TResolved, T1, T2 = string> = TResolved extends true ? T1 : T2;
+export type IfRequireKeys<TResolved, T1> = TResolved extends true ? RequiredKeys<T1> : T1;
+export type Unwrap<T> = T extends Promise<infer U> ? U : T extends (...args: any) => Promise<infer U> ? U : T extends (...args: any) => infer U ? U : T;
+export type RequiredKeys<T> = {
+    [K in keyof Required<T>]: T[K];
+};
+export type SimilarObject<T1> = {
+    [K in keyof T1]: unknown;
+};
+export {};

package/lib/utils/watcher.d.ts

@@ -0,0 +1,10 @@
+export declare function createWatcher<T = string>(options: {
+    onRead: () => Promise<T>;
+    onCheck?: (prev: T | undefined, current: T | undefined) => boolean;
+    onChange?: (data: T | undefined) => void;
+    onError?: (error: Error) => void;
+    interval?: number;
+}): {
+    start: () => void;
+    stop: () => void;
+};

package/lib/utils/watcher.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWatcher = void 0;
+function createWatcher(options) {
+    let prev;
+    let interval;
+    const onCheck = options.onCheck || ((prev, current) => prev === current);
+    const rutine = async (initial = false) => {
+        try {
+            let current = await options.onRead();
+            if (!onCheck(prev, current)) {
+                prev = current;
+                if (!initial)
+                    options.onChange?.(current);
+            }
+        }
+        catch (error) {
+            options.onError?.(error);
+        }
+    };
+    return {
+        start: () => {
+            clearInterval(interval);
+            rutine(true).finally(() => {
+                interval = setInterval(rutine, options.interval ?? 5000);
+            });
+        },
+        stop: () => {
+            clearInterval(interval);
+            interval = undefined;
+        },
+    };
+}
+exports.createWatcher = createWatcher;