@bemoje/cli 0.0.4 → 0.0.5

package/dist/cjs/opt/OptionArgumentValidatorSelector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionArgumentValidatorSelector.js","sourceRoot":"","sources":["../../../src/opt/OptionArgumentValidatorSelector.ts"],"names":[],"mappings":";;;AAEA,iEAA6D;AAE7D,MAAa,+BAAgC,SAAQ,qCAAgC;IACnF,YAAY,OAAsB;QAChC,KAAK,CAAC,OAAO,CAAC,CAAA;IAChB,CAAC;IACD,MAAM,CAAI,SAAwB;QAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;QAC3C,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAA;QAC/C,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,CAAA;QAC9B,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;QACzB,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;CACF;AAXD,0EAWC"}

package/dist/cjs/opt/OptionBuilder.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionBuilder = void 0;
+const extra_typings_1 = require("@commander-js/extra-typings");
+const OptionArgumentParserSelector_1 = require("./OptionArgumentParserSelector");
+const OptionArgumentValidatorSelector_1 = require("./OptionArgumentValidatorSelector");
+const OptionHelpers_1 = require("./OptionHelpers");
+const OptionReader_1 = require("./OptionReader");
+const realizeLazyProperty_1 = require("../util/object/realizeLazyProperty");
+/**
+ * Wrapper around the @see Option class, for more intuitive construction.
+ * @remarks Options are one of boolean, negated, required argument, or optional argument.
+ */
+class OptionBuilder {
+    cmd;
+    $;
+    constructor(cmd, flags) {
+        this.cmd = cmd;
+        this.$ = new extra_typings_1.Option(flags);
+        if (!OptionHelpers_1.OptionHelpers.hasArgument(this.$) && this.$.long?.startsWith('--no-')) {
+            this.$.default(true);
+        }
+    }
+    description(string) {
+        this.$.description = string;
+        return this;
+    }
+    mandatory(mandatory = true) {
+        this.$.makeOptionMandatory(mandatory);
+        return this;
+    }
+    hideHelp(hide = true) {
+        this.$.hideHelp(hide);
+        return this;
+    }
+    hidden(hidden = true) {
+        this.$.hidden = hidden;
+        return this;
+    }
+    preset(arg) {
+        this.$.preset(arg);
+        return this;
+    }
+    default(value, description) {
+        this.$.default(value, description);
+        return this;
+    }
+    choices(values) {
+        if (!OptionHelpers_1.OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set choices on option with no argument: ' + this.$.name());
+        }
+        this.$.choices(values);
+        return this;
+    }
+    conflicts(names) {
+        this.$.conflicts(names);
+        return this;
+    }
+    implies(optionValues) {
+        this.$.implies(optionValues);
+        return this;
+    }
+    env(name) {
+        this.$.env(name);
+        return this;
+    }
+    short(short) {
+        OptionHelpers_1.OptionHelpers.setShort(this.$, short);
+        return this;
+    }
+    get parser() {
+        if (!OptionHelpers_1.OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set parser on option with no argument: ' + this.$.attributeName());
+        }
+        return new OptionArgumentParserSelector_1.OptionArgumentParserSelector(this);
+    }
+    get validator() {
+        if (!OptionHelpers_1.OptionHelpers.hasArgument(this.$)) {
+            throw new Error('Cannot set validator on option with no argument: ' + this.$.attributeName());
+        }
+        return new OptionArgumentValidatorSelector_1.OptionArgumentValidatorSelector(this);
+    }
+    get get() {
+        return (0, realizeLazyProperty_1.realizeLazyProperty)(this, 'get', new OptionReader_1.OptionReader(this));
+    }
+}
+exports.OptionBuilder = OptionBuilder;
+//# sourceMappingURL=OptionBuilder.js.map

package/dist/cjs/opt/OptionBuilder.js.map

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

package/dist/cjs/opt/OptionHelpers.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionHelpers = void 0;
+const arrLast_1 = require("../util/array/arrLast");
+const strEnsureStartsWith_1 = require("../util/string/strEnsureStartsWith");
+/**
+ * Extract the argument name from an option's 'flags' string.
+ */
+function getArgumentName(opt) {
+    const result = (0, arrLast_1.arrLast)(opt.flags.trim().split(' '));
+    if (/-/.test(result))
+        return undefined;
+    return result;
+}
+/**
+ * Check if an option has an argument.
+ */
+function hasArgument(opt) {
+    return /[<>[\]]/.test(opt.flags);
+}
+/**
+ * Update an Option's 'flags' property from its 'short' and 'long' properties.
+ * The flags property is not automatically updated when 'short' or 'long' are changed.
+ */
+function renderFlags(opt) {
+    const shortLong = [];
+    if (opt.short)
+        shortLong.push(opt.short);
+    if (opt.long)
+        shortLong.push(opt.long);
+    const argName = getArgumentName(opt);
+    return shortLong.join(', ') + (argName ? ' ' + argName : '');
+}
+/**
+ * Set an Option's 'long' name. The 'flags' property is updated accordingly.
+ * The '--' prefix is automatically added if not present.
+ */
+function setLong(opt, long) {
+    opt.long = (0, strEnsureStartsWith_1.strEnsureStartsWith)(long, '--').replace(/^-+/, '--');
+    opt.flags = renderFlags(opt);
+}
+/**
+ * Set an Option's 'short' name. The 'flags' property is updated accordingly.
+ * The '-' prefix is automatically added if not present.
+ */
+function setShort(opt, short) {
+    opt.short = (0, strEnsureStartsWith_1.strEnsureStartsWith)(short, '-').replace(/^-+/, '-');
+    opt.flags = renderFlags(opt);
+}
+exports.OptionHelpers = {
+    getArgumentName,
+    hasArgument,
+    renderFlags,
+    setLong,
+    setShort,
+};
+//# sourceMappingURL=OptionHelpers.js.map

package/dist/cjs/opt/OptionHelpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionHelpers.js","sourceRoot":"","sources":["../../../src/opt/OptionHelpers.ts"],"names":[],"mappings":";;;AAAA,mDAA+C;AAE/C,4EAAwE;AAExE;;GAEG;AACH,SAAS,eAAe,CAAC,GAAW;IAClC,MAAM,MAAM,GAAG,IAAA,iBAAO,EAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAA;IACnD,IAAI,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAA;IACtC,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,OAAO,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;AAClC,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,SAAS,GAAG,EAAE,CAAA;IACpB,IAAI,GAAG,CAAC,KAAK;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACxC,IAAI,GAAG,CAAC,IAAI;QAAE,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,CAAC,CAAA;IACpC,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC9D,CAAC;AAED;;;GAGG;AACH,SAAS,OAAO,CAAC,GAAW,EAAE,IAAY;IACxC,GAAG,CAAC,IAAI,GAAG,IAAA,yCAAmB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC/D,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAED;;;GAGG;AACH,SAAS,QAAQ,CAAC,GAAW,EAAE,KAAa;IAC1C,GAAG,CAAC,KAAK,GAAG,IAAA,yCAAmB,EAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;IAC/D,GAAG,CAAC,KAAK,GAAG,WAAW,CAAC,GAAG,CAAC,CAAA;AAC9B,CAAC;AAEY,QAAA,aAAa,GAAG;IAC3B,eAAe;IACf,WAAW;IACX,WAAW;IACX,OAAO;IACP,QAAQ;CACT,CAAA"}

package/dist/cjs/opt/OptionReader.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OptionReader = void 0;
+const OptionHelpers_1 = require("./OptionHelpers");
+class OptionReader {
+    parent;
+    constructor(parent) {
+        this.parent = parent;
+    }
+    get $() {
+        return this.parent.$;
+    }
+    get option() {
+        return this.parent.$;
+    }
+    get description() {
+        return this.$.description;
+    }
+    get optional() {
+        return this.$.optional;
+    }
+    get mandatory() {
+        return this.$.mandatory;
+    }
+    get hidden() {
+        return this.$.hidden;
+    }
+    get variadic() {
+        return this.$.variadic;
+    }
+    get short() {
+        return this.$.short;
+    }
+    get long() {
+        return this.$.long;
+    }
+    get preset() {
+        return this.$.presetArg;
+    }
+    get default() {
+        return this.$.defaultValue;
+    }
+    get choices() {
+        return this.$.argChoices;
+    }
+    get env() {
+        return this.$.envVar;
+    }
+    get flags() {
+        return this.$.flags;
+    }
+    get name() {
+        return this.$.name();
+    }
+    get attributeName() {
+        return this.$.attributeName();
+    }
+    get defaultValueDescription() {
+        return this.$.defaultValueDescription;
+    }
+    get hasArgument() {
+        return OptionHelpers_1.OptionHelpers.hasArgument(this.parent.$);
+    }
+}
+exports.OptionReader = OptionReader;
+//# sourceMappingURL=OptionReader.js.map

package/dist/cjs/opt/OptionReader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"OptionReader.js","sourceRoot":"","sources":["../../../src/opt/OptionReader.ts"],"names":[],"mappings":";;;AACA,mDAA+C;AAE/C,MAAa,YAAY;IACQ;IAA/B,YAA+B,MAAqB;QAArB,WAAM,GAAN,MAAM,CAAe;IAAG,CAAC;IAExD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IACtB,CAAC;IACD,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,CAAC,CAAC,WAAW,CAAA;IAC3B,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IACxB,CAAC;IACD,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACzB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACtB,CAAC;IACD,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAA;IACxB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IACrB,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IACpB,CAAC;IACD,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,CAAC,CAAC,SAAS,CAAA;IACzB,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,CAAC,CAAC,YAAY,CAAA;IAC5B,CAAC;IACD,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,CAAC,CAAC,UAAU,CAAA;IAC1B,CAAC;IACD,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,CAAC,CAAC,MAAM,CAAA;IACtB,CAAC;IACD,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,CAAA;IACrB,CAAC;IACD,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAA;IACtB,CAAC;IACD,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,CAAC,CAAC,aAAa,EAAE,CAAA;IAC/B,CAAC;IACD,IAAI,uBAAuB;QACzB,OAAO,IAAI,CAAC,CAAC,CAAC,uBAAuB,CAAA;IACvC,CAAC;IACD,IAAI,WAAW;QACb,OAAO,6BAAa,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAA;IACjD,CAAC;CACF;AAzDD,oCAyDC"}

package/dist/cjs/proto/overrideCommanderPrototype.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commanderBackRefs = void 0;
+const extra_typings_1 = require("@commander-js/extra-typings");
+const splitCombinedArgvShorts_1 = require("../core/splitCombinedArgvShorts");
+exports.commanderBackRefs = new WeakMap();
+const oldParse = extra_typings_1.Command.prototype.parse;
+extra_typings_1.Command.prototype.parse = function parse(argv, options) {
+    if (argv) {
+        argv = (0, splitCombinedArgvShorts_1.splitCombinedArgvShorts)(argv.slice());
+        this.builder.meta.rawArgs = argv.slice(options?.from === 'user' ? 0 : 2);
+    }
+    else {
+        this.builder.meta.rawArgs = process.argv.slice(2);
+    }
+    return oldParse.call(this, argv, options);
+};
+const oldParseAsync = extra_typings_1.Command.prototype.parseAsync;
+extra_typings_1.Command.prototype.parseAsync = async function (argv, options) {
+    if (argv) {
+        argv = (0, splitCombinedArgvShorts_1.splitCombinedArgvShorts)(argv.slice());
+        this.builder.meta.rawArgs = argv.slice(options?.from === 'user' ? 0 : 2);
+    }
+    else {
+        this.builder.meta.rawArgs = process.argv.slice(2);
+    }
+    return await oldParseAsync.call(this, argv, options);
+};
+Object.defineProperty(extra_typings_1.Command.prototype, 'builder', {
+    get() {
+        const ins = exports.commanderBackRefs.get(this);
+        if (!ins)
+            throw new Error(`CommandBuilder not found for command ${this.name()}`);
+        return ins;
+    },
+});
+//# sourceMappingURL=overrideCommanderPrototype.js.map

package/dist/cjs/proto/overrideCommanderPrototype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrideCommanderPrototype.js","sourceRoot":"","sources":["../../../src/proto/overrideCommanderPrototype.ts"],"names":[],"mappings":";;;AACA,+DAAqD;AAGrD,6EAAyE;AAE5D,QAAA,iBAAiB,GAAG,IAAI,OAAO,EAA+C,CAAA;AAE3F,MAAM,QAAQ,GAAG,uBAAO,CAAC,SAAS,CAAC,KAAK,CAAA;AACxC,uBAAO,CAAC,SAAS,CAAC,KAAK,GAAG,SAAS,KAAK,CAAgB,IAAwB,EAAE,OAAsB;IACtG,IAAI,IAAI,EAAE;QACR,IAAI,GAAG,IAAA,iDAAuB,EAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KACzE;SAAM;QACL,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;KAClD;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AAC3C,CAAC,CAAA;AAED,MAAM,aAAa,GAAG,uBAAO,CAAC,SAAS,CAAC,UAAU,CAAA;AAClD,uBAAO,CAAC,SAAS,CAAC,UAAU,GAAG,KAAK,WAA0B,IAAwB,EAAE,OAAsB;IAC5G,IAAI,IAAI,EAAE;QACR,IAAI,GAAG,IAAA,iDAAuB,EAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;QAC5C,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;KACzE;SAAM;QACL,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;KAClD;IACD,OAAO,MAAM,aAAa,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAA;AACtD,CAAC,CAAA;AACD,MAAM,CAAC,cAAc,CAAC,uBAAO,CAAC,SAAS,EAAE,SAAS,EAAE;IAClD,GAAG;QACD,MAAM,GAAG,GAAG,yBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,wCAAwC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAA;QAChF,OAAO,GAAG,CAAA;IACZ,CAAC;CACF,CAAC,CAAA"}

package/dist/cjs/types/IConfig.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IConfig.js.map

package/dist/cjs/types/IConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IConfig.js","sourceRoot":"","sources":["../../../src/types/IConfig.ts"],"names":[],"mappings":""}

package/dist/cjs/types/IPreset.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=IPreset.js.map

package/dist/cjs/types/IPreset.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IPreset.js","sourceRoot":"","sources":["../../../src/types/IPreset.ts"],"names":[],"mappings":""}

package/dist/cjs/util/array/arrLast.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrLast = void 0;
+/**
+ * Returns the last element of an array.
+ * Throws an error if the array is empty.
+ * @template T The type of elements in the array.
+ * @param array The array to get the last element from.
+ * @returns The last element of the array.
+ * @throws If the array is empty.
+ * @example const numbers = [1, 2, 3, 4, 5];
+ * const lastNumber = arrLast(numbers);
+ * //=> 5
+ */
+function arrLast(array) {
+    if (!array.length)
+        throw new Error('Cannot get last element of empty array.');
+    return array[array.length - 1];
+}
+exports.arrLast = arrLast;
+//# sourceMappingURL=arrLast.js.map

package/dist/cjs/util/array/arrLast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrLast.js","sourceRoot":"","sources":["../../../../src/util/array/arrLast.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;;;GAUG;AACH,SAAgB,OAAO,CAAI,KAAU;IACnC,IAAI,CAAC,KAAK,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAA;IAC7E,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAA;AAChC,CAAC;AAHD,0BAGC"}

package/dist/cjs/util/array/arrSome.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.arrSome = void 0;
+/**
+ * Checks if at least one element in the array satisfies the provided predicate.
+ * @param predicate The predicate function to apply to each element.
+ * @template T The type of elements in the input array.
+ * @returns Returns `true` if at least one element in the array passes the test implemented by the provided function, otherwise `false`.
+ * @param input The array to check.
+ * @example ```ts
+ * const numbers = [1, 2, 3, 4, 5];
+ * const isEven = (num) => num % 2 === 0;
+ * arrSome(numbers, isEven);
+ * //=> true
+ * ```
+ */
+function arrSome(input, predicate) {
+    for (let i = 0, len = input.length; i < len; i++) {
+        if (predicate(input[i], i, input) === true) {
+            return true;
+        }
+    }
+    return false;
+}
+exports.arrSome = arrSome;
+//# sourceMappingURL=arrSome.js.map

package/dist/cjs/util/array/arrSome.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrSome.js","sourceRoot":"","sources":["../../../../src/util/array/arrSome.ts"],"names":[],"mappings":";;;AAEA;;;;;;;;;;;;GAYG;AACH,SAAgB,OAAO,CAAI,KAAe,EAAE,SAA4B;IACtE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE;QAChD,IAAI,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;YAC1C,OAAO,IAAI,CAAA;SACZ;KACF;IACD,OAAO,KAAK,CAAA;AACd,CAAC;AAPD,0BAOC"}

package/dist/cjs/util/array/types/ArrayPredicate.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=ArrayPredicate.js.map

package/dist/cjs/util/array/types/ArrayPredicate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ArrayPredicate.js","sourceRoot":"","sources":["../../../../../src/util/array/types/ArrayPredicate.ts"],"names":[],"mappings":""}

package/dist/cjs/util/db/JsonDB.js

@@ -0,0 +1,145 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JsonDB = void 0;
+const ensureThat_1 = require("../validation/ensureThat");
+const isObject_1 = require("../validation/isObject");
+const readJsonFileSafeSync_1 = require("../fs/readJsonFile/readJsonFileSafeSync");
+const writeJsonFileSafe_1 = require("../fs/writeJsonFile/writeJsonFileSafe");
+/**
+ * Represents a simple JSON file database.
+ */
+class JsonDB {
+    filepath;
+    indents;
+    /**
+     * The data stored in the JSON database.
+     */
+    data;
+    /**
+     * Creates a new instance of the JsonDB class.
+     * @param filepath - The filepath where the data file is stored or to be stored.
+     */
+    constructor(filepath, indents = 0) {
+        this.filepath = filepath;
+        this.indents = indents;
+        this.data = (0, readJsonFileSafeSync_1.readJsonFileSafeSync)(this.filepath) ?? {};
+    }
+    /**
+     * Saves the data to the JSON file.
+     */
+    async save(indents = this.indents) {
+        return await (0, writeJsonFileSafe_1.writeJsonFileSafe)(this.filepath, this.data, { spaces: indents });
+    }
+    /**
+     * Sets the filepath of the JSON file.
+     * @param filepath - The new filepath.
+     */
+    setFilepath(filepath, save = true) {
+        if (this.filepath === filepath)
+            return;
+        this.filepath = filepath;
+        if (save)
+            this.save();
+    }
+    /**
+     * Sets a value in the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @param value - The value to set.
+     * @param save - Whether to save the data to the JSON file.
+     */
+    set(prefix, value = {}, save = true) {
+        if (!prefix) {
+            this.data = (0, ensureThat_1.ensureThat)(value, isObject_1.isObject);
+        }
+        else {
+            const keys = prefix.split('.');
+            const lastKey = keys.pop();
+            let node = this.data;
+            for (const key of keys) {
+                if (!Object.hasOwn(node, key)) {
+                    node[key] = {};
+                }
+                node = node[key];
+            }
+            node[lastKey] = this.cloneDeep(value);
+        }
+        if (save)
+            this.save();
+    }
+    /**
+     * Gets a value from the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns The value associated with the key.
+     * @throws An error if no entry is found at the specified key.
+     */
+    get(prefix) {
+        const value = this.getSafe(prefix);
+        if (value === undefined)
+            throw new Error(`No entry at '${prefix}'`);
+        return this.cloneDeep(value);
+    }
+    /**
+     * Gets a value from the JSON database safely.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns The value associated with the key, or undefined if no entry is found.
+     */
+    getSafe(prefix) {
+        if (!prefix)
+            return this.cloneDeep(this.data);
+        const keys = prefix.split('.');
+        let node = this.data;
+        for (const key of keys) {
+            if (!Object.hasOwn(node, key)) {
+                return undefined;
+            }
+            node = node[key];
+        }
+        return this.cloneDeep(node);
+    }
+    /**
+     * Checks if a key exists in the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @returns True if the key exists, false otherwise.
+     */
+    has(prefix) {
+        if (!prefix)
+            return true;
+        return this.getSafe(prefix) !== undefined;
+    }
+    /**
+     * Deletes a value from the JSON database.
+     * @param prefix - Object path prefix as dot-separated keys.
+     * @param save - Whether to save the data to the JSON file.
+     */
+    delete(prefix, save = true) {
+        if (!prefix) {
+            this.data = {};
+        }
+        else {
+            const keys = prefix.split('.');
+            const lastKey = keys.pop();
+            let node = this.data;
+            for (const key of keys) {
+                if (!Object.hasOwn(node, key)) {
+                    return;
+                }
+                node = node[key];
+            }
+            delete node[lastKey];
+        }
+        if (save)
+            this.save();
+    }
+    /**
+     * Creates a deep clone of an object.
+     * @param obj - The object to clone.
+     * @returns The cloned object.
+     */
+    cloneDeep(obj) {
+        if (typeof obj !== 'object')
+            return obj;
+        return JSON.parse(JSON.stringify(obj));
+    }
+}
+exports.JsonDB = JsonDB;
+//# sourceMappingURL=JsonDB.js.map

package/dist/cjs/util/db/JsonDB.js.map

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