@nu-art/ts-common 0.400.5 → 0.400.6

package/consts/consts.js

@@ -16,4 +16,3 @@
  * limitations under the License.
  */
 export const _U = undefined;
-//# sourceMappingURL=consts.js.map

package/core/application.js

@@ -30,4 +30,3 @@ export class Application extends ModuleManager {
             .catch((err) => this.logError("Error", err));
     }
 }
-//# sourceMappingURL=application.js.map

package/core/debug-flags.js

@@ -77,4 +77,3 @@ export class DebugFlags {
         this.instance.AllDebugFlags[newKey] = flag;
     }
 }
-//# sourceMappingURL=debug-flags.js.map

package/core/dispatcher.js

@@ -73,4 +73,3 @@ export class Dispatcher extends Processor {
         });
     }
 }
-//# sourceMappingURL=dispatcher.js.map

package/core/error-handling.js

@@ -33,4 +33,3 @@ export const ServerErrorSeverity_Ordinal = [
 ];
 export const dispatch_onApplicationNotification = new Dispatcher('__processApplicationNotification');
 export const dispatch_onApplicationException = new Dispatcher('__processApplicationException');
-//# sourceMappingURL=error-handling.js.map

package/core/exceptions/exceptions.js

@@ -227,4 +227,3 @@ export class ApiException extends CustomException {
         return typeof causeOrMessage != 'string' ? causeOrMessage : cause;
     }
 }
-//# sourceMappingURL=exceptions.js.map

package/core/exceptions/http-codes.js

@@ -94,4 +94,3 @@ export const HttpCodes = {
         MUST_NEVER_HAPPENED: 599,
     },
 };
-//# sourceMappingURL=http-codes.js.map

package/core/exceptions/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/core/logger/BeLogged.js

@@ -52,4 +52,3 @@ class BeLogged_Class {
     }
 }
 export const BeLogged = new BeLogged_Class();
-//# sourceMappingURL=BeLogged.js.map

package/core/logger/LogClient.js

@@ -60,4 +60,3 @@ export const DefaultLogPrefixComposer = (tag, level) => {
     const date = _logger_finalDate.toISOString().replace(/T/, '_').replace(/Z/, '').substring(0, 23);
     return `  ${date} ${_logger_getPrefix(level)} ${tag}:  `;
 };
-//# sourceMappingURL=LogClient.js.map

package/core/logger/LogClient_BaseRotate.js

@@ -57,4 +57,3 @@ export class LogClient_BaseRotate extends LogClient {
         this.prepare();
     }
 }
-//# sourceMappingURL=LogClient_BaseRotate.js.map

package/core/logger/LogClient_Browser.js

@@ -73,4 +73,3 @@ class LogClient_Browser_class extends LogClient {
     }
 }
 export const LogClient_Browser = new LogClient_Browser_class();
-//# sourceMappingURL=LogClient_Browser.js.map

package/core/logger/LogClient_BrowserGroups.js

@@ -84,4 +84,3 @@ class LogClient_BrowserGroups_Class extends LogClient {
     };
 }
 export const LogClient_BrowserGroups = new LogClient_BrowserGroups_Class();
-//# sourceMappingURL=LogClient_BrowserGroups.js.map

package/core/logger/LogClient_ConsoleProxy.js

@@ -86,4 +86,3 @@ export class LogClient_ConsoleProxy extends LogClient {
         }
     }
 }
-//# sourceMappingURL=LogClient_ConsoleProxy.js.map

package/core/logger/LogClient_File.js

@@ -53,4 +53,3 @@ export class LogClient_File extends LogClient_BaseRotate {
         this.buffer = fs.createWriteStream(this.getFileName(), { flags: 'a' });
     }
 }
-//# sourceMappingURL=LogClient_File.js.map

package/core/logger/LogClient_Function.js

@@ -50,4 +50,3 @@ class LogClient_Function_class extends LogClient {
     }
 }
 export const LogClient_Function = new LogClient_Function_class();
-//# sourceMappingURL=LogClient_Function.js.map

package/core/logger/LogClient_MemBuffer.js

@@ -79,4 +79,3 @@ export class LogClient_MemBuffer extends LogClient_BaseRotate {
         this.keepNaturalColors = keepNaturalColors;
     }
 }
-//# sourceMappingURL=LogClient_MemBuffer.js.map

package/core/logger/LogClient_Terminal.js

@@ -53,4 +53,3 @@ class LogClient_Terminal_class extends LogClient {
     }
 }
 export const LogClient_Terminal = new LogClient_Terminal_class();
-//# sourceMappingURL=LogClient_Terminal.js.map

package/core/logger/Logger.js

@@ -127,4 +127,3 @@ export class StaticLogger {
         return this._DEBUG_FLAG.canLog(level);
     }
 }
-//# sourceMappingURL=Logger.js.map

package/core/logger/types.js

@@ -30,4 +30,3 @@ export const LogLevelOrdinal = [
     LogLevel.Warning,
     LogLevel.Error,
 ];
-//# sourceMappingURL=types.js.map

package/core/logger/utils.js

@@ -69,4 +69,3 @@ export function _logger_logException(error, fullStack = '') {
 export function _logger_indentNewLineBy(linePrefix, input) {
     return linePrefix + input.replace(/\n/g, `\n${linePrefix}`);
 }
-//# sourceMappingURL=utils.js.map

package/core/module-manager.js

@@ -127,4 +127,3 @@ export class ModuleManager extends Logger {
         return '';
     }
 }
-//# sourceMappingURL=module-manager.js.map

package/core/module.js

@@ -103,4 +103,3 @@ export class Module extends Logger {
         // ignorance is bliss
     }
 }
-//# sourceMappingURL=module.js.map

package/csv.js

@@ -17,4 +17,3 @@
  */
 export * from './modules/CSVModule.js';
 export * from './modules/CSVModuleV3.js';
-//# sourceMappingURL=csv.js.map

package/db/consts.js

@@ -14,4 +14,3 @@ export const MetaData_DBPointer = {
         description: 'The unique id of the item',
     }
 };
-//# sourceMappingURL=consts.js.map

package/db/dependencies-test.js

@@ -3,4 +3,3 @@ const pah = {
     'a.yId': { dbName: 'y' }
 };
 export {};
-//# sourceMappingURL=dependencies-test.js.map

package/db/types.js

@@ -1,2 +1 @@
 export {};
-//# sourceMappingURL=types.js.map

package/esm.js

@@ -1,4 +1,3 @@
 import { fileURLToPath } from 'node:url';
 import path from 'node:path';
 export const ___dirname = (metaUrl) => path.dirname(fileURLToPath(metaUrl));
-//# sourceMappingURL=esm.js.map

package/index.d.ts

@@ -42,6 +42,7 @@ export * from './utils/ui-tools.js';
 export * from './utils/json-tools.js';
 export * from './utils/promise-tools.js';
 export * from './utils/url-tools.js';
+export * from './utils/debounce.js';
 export * from './validator/validator-core.js';
 export * from './validator/validators.js';
 export * from './validator/type-validators.js';

package/index.js

@@ -59,10 +59,10 @@ export * from './utils/ui-tools.js';
 export * from './utils/json-tools.js';
 export * from './utils/promise-tools.js';
 export * from './utils/url-tools.js';
+export * from './utils/debounce.js';
 export * from './validator/validator-core.js';
 export * from './validator/validators.js';
 export * from './validator/type-validators.js';
 export * from './consts/consts.js';
 export * from './modules/CliParamsModule.js';
 export * from './modules/csv-serializer.js';
-//# sourceMappingURL=index.js.map

package/mem-storage/MemStorage.js

@@ -99,4 +99,3 @@ export class MemKey {
         return asyncLocalStorage.getStore().set(this, merge(currentValue, value));
     };
 }
-//# sourceMappingURL=MemStorage.js.map

package/mem-storage/index.js

@@ -1,2 +1 @@
 export * from './MemStorage.js';
-//# sourceMappingURL=index.js.map

package/modules/CSVModule.js

@@ -137,4 +137,3 @@ class CSVModule_Class extends Module {
     }
 }
 export const CSVModule = new CSVModule_Class();
-//# sourceMappingURL=CSVModule.js.map

package/modules/CSVModuleV3.js

@@ -80,4 +80,3 @@ export class CSVModuleV3_Class extends Module {
     };
 }
 export const CSVModuleV3 = new CSVModuleV3_Class();
-//# sourceMappingURL=CSVModuleV3.js.map

package/modules/CliParamsModule.js

@@ -64,4 +64,3 @@ class CliParamsModule_Class extends Module {
     };
 }
 export const CliParamsModule = new CliParamsModule_Class();
-//# sourceMappingURL=CliParamsModule.js.map

package/modules/JSONCSVModule.js

@@ -58,4 +58,3 @@ export class JSONCSVModule_Class extends CSVModuleV3_Class {
         });
     };
 }
-//# sourceMappingURL=JSONCSVModule.js.map

package/modules/csv-serializer.js

@@ -40,4 +40,3 @@ export function csvSerializer(items, _csvProps) {
     outputRows.push(...rowsData);
     return outputRows.reduce((content, row) => `${content}${row}${csvProps.lineSeparator}`, '').slice(0, -1);
 }
-//# sourceMappingURL=csv-serializer.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nu-art/ts-common",
-  "version": "0.400.5",
+  "version": "0.400.6",
   "description": "js and ts infra",
   "type": "module",
   "keywords": [
@@ -36,9 +36,7 @@
     "node-forge": "^1.2.1",
     "uuid": "^9.0.0",
     "csv-parser": "^2.3.3",
-    "xlsx": "^0.18.5",
-    "jose": "^5.0.0",
-    "pbkdf2": "3.1.2"
+    "jose": "^5.0.0"
   },
   "devDependencies": {
     "@types/mocha": "^10.0.6",

package/replacer-v2/ReplacerV2.js

@@ -14,4 +14,3 @@ export class ReplacerV2 {
         return filterInstances(matches.map((param) => param.match(ReplacerV2.Regexp_param)?.[1]));
     }
 }
-//# sourceMappingURL=ReplacerV2.js.map

package/test-index.js

@@ -1,3 +1,2 @@
 export * from './testing/types.js';
 export * from './testing/consts.js';
-//# sourceMappingURL=test-index.js.map

package/testing/consts.js

@@ -78,4 +78,3 @@ export const expectFailAsync = async (action) => {
     }
 };
 export const dispatcher_resetTests = new Dispatcher('__resetForTests');
-//# sourceMappingURL=consts.js.map

package/testing/test-template.test.js

@@ -39,4 +39,3 @@ describe('template', () => {
         });
     });
 });
-//# sourceMappingURL=test-template.test.js.map

package/testing/types.js

@@ -16,4 +16,3 @@
  * limitations under the License.
  */
 export {};
-//# sourceMappingURL=types.js.map

package/testing/workspace-creator.d.ts

@@ -1,10 +1,12 @@
 import { Logger } from '../core/logger/Logger.js';
+import { StringMap } from '../utils/index.js';
 export declare class TestWorkspaceCreator extends Logger {
     private readonly pathToFixtures;
     private readonly pathToWorkspace;
     constructor(pathToFixtures: string, pathToWorkspace: string);
-    setupWorkspace(fixtures: string[], relativePath?: string, clean?: boolean): void;
-    clearWorkspace(relativePathInWorkspace?: string): void;
-    extractFixture(pathToFixture: string, relativePathInWorkspace?: string): void;
+    setupWorkspace(fixtures: string[], relativePath?: string, clean?: boolean): Promise<void>;
+    setupWorkspace(fixtures: string[], params: StringMap, relativePath?: string, clean?: boolean): Promise<void>;
+    clearWorkspace(relativePathInWorkspace?: string): Promise<void>;
+    extractFixture(pathToFixture: string, relativePathInWorkspace?: string, params?: StringMap): Promise<void>;
 }
 export declare function setupWorkspace(pathToWorkspaceFile: string, outputRootDir: string, clean?: boolean): void;

package/testing/workspace-creator.js

@@ -1,6 +1,7 @@
-import { mkdirSync, readFileSync, writeFileSync, rmSync } from 'fs';
+import { mkdirSync, readFileSync, rmSync, writeFileSync } from 'fs';
 import { dirname, resolve } from 'path';
 import { Logger } from '../core/logger/Logger.js';
+import { FileSystemUtils } from '../utils/FileSystemUtils.js';
 const FILE_HEADER_REGEX = /^\/\/ file: (.+)$/gm;
 const INNER_FILE_HEADER_REGEX = /^(\/\/)*?\/\/\/\/ file:/gm;
 export class TestWorkspaceCreator extends Logger {
@@ -11,20 +12,38 @@ export class TestWorkspaceCreator extends Logger {
         this.pathToFixtures = pathToFixtures;
         this.pathToWorkspace = pathToWorkspace;
     }
-    setupWorkspace(fixtures, relativePath = '', clean = true) {
-        if (clean)
-            this.clearWorkspace(relativePath);
+    async setupWorkspace(fixtures, params, relativePath, clean) {
+        let _clean = clean;
+        let _relativePath;
+        let _params;
+        if (typeof relativePath === 'boolean') {
+            _clean = relativePath;
+        }
+        else if (typeof relativePath === 'string') {
+            _relativePath = relativePath;
+        }
+        if (typeof params === 'string') {
+            _relativePath = params;
+            _params = {};
+        }
+        else {
+            _params = params;
+        }
+        _relativePath = _relativePath ?? '';
+        _clean = _clean ?? true;
+        if (_clean)
+            await this.clearWorkspace(_relativePath);
         for (const fixture of fixtures) {
-            this.extractFixture(resolve(this.pathToFixtures, fixture), relativePath);
+            await this.extractFixture(resolve(this.pathToFixtures, fixture), _relativePath, _params);
         }
     }
-    clearWorkspace(relativePathInWorkspace = '') {
+    async clearWorkspace(relativePathInWorkspace = '') {
         const path = resolve(this.pathToWorkspace, relativePathInWorkspace);
         this.logWarning(`Deleting folder: ${path}`);
-        rmSync(path, { recursive: true, force: true });
+        await FileSystemUtils.folder.delete(path);
     }
-    extractFixture(pathToFixture, relativePathInWorkspace = '') {
-        const content = readFileSync(pathToFixture, 'utf8');
+    async extractFixture(pathToFixture, relativePathInWorkspace = '', params = {}) {
+        const content = await FileSystemUtils.file.template.read(pathToFixture, params);
         const matches = [...content.matchAll(FILE_HEADER_REGEX)];
         if (matches.length === 0) {
             this.logError('No matching file headers found. Aborting.');
@@ -43,8 +62,7 @@ export class TestWorkspaceCreator extends Logger {
                 .slice(startIndex + currentMatch[0].length, endIndex)
                 .trimStart();
             fileContent = fileContent.replace(INNER_FILE_HEADER_REGEX, '\$1// file:');
-            mkdirSync(dirname(targetPath), { recursive: true });
-            writeFileSync(targetPath, fileContent);
+            await FileSystemUtils.file.write(targetPath, fileContent);
             this.logVerbose(`Wrote: ${targetPath}`);
         }
     }
@@ -76,4 +94,3 @@ export function setupWorkspace(pathToWorkspaceFile, outputRootDir, clean = true)
         console.log(`Wrote: ${targetPath}`);
     }
 }
-//# sourceMappingURL=workspace-creator.js.map

package/tools/Replacer.js

@@ -140,4 +140,3 @@ export class Replacer extends Logger {
         // this.logDebug(value);
     }
 }
-//# sourceMappingURL=Replacer.js.map

package/tools/get-log-style.js

@@ -32,4 +32,3 @@ export function getLogStyle(...styleObj) {
     });
     return style;
 }
-//# sourceMappingURL=get-log-style.js.map

package/utils/FileSystemUtils.js

@@ -171,4 +171,3 @@ export const FileSystemUtils = {
         }
     }
 };
-//# sourceMappingURL=FileSystemUtils.js.map

package/utils/array-tools.js

@@ -303,4 +303,3 @@ export function getMin(arr, mapper = (item) => item) {
     const sorted = sortArray(arr, mapper);
     return sorted[0];
 }
-//# sourceMappingURL=array-tools.js.map

package/utils/conflict-tools.js

@@ -1,3 +1,2 @@
 export const findConflicts = (origin, ours, theirs) => {
 };
-//# sourceMappingURL=conflict-tools.js.map

package/utils/crypto-tools.js

@@ -122,4 +122,3 @@ export const TEST_JwtTools = {
     beforeAll: TEST_JwtTools_BeforeAll,
     afterAll: TEST_JwtTools_AfterAll,
 };
-//# sourceMappingURL=crypto-tools.js.map

package/utils/date-time-tools.js

@@ -250,4 +250,3 @@ export function timeCounter() {
         }
     };
 }
-//# sourceMappingURL=date-time-tools.js.map

package/utils/db-object-tools.js

@@ -32,4 +32,3 @@ export function keepPartialObject(instance, keys) {
         return objectToRet;
     }, {});
 }
-//# sourceMappingURL=db-object-tools.js.map

package/utils/debounce.d.ts

@@ -0,0 +1,32 @@
+import { Logger } from '../core/logger/Logger.js';
+export declare class Debounce<Args extends any[], Response> extends Logger {
+    private action;
+    private readonly waitMs;
+    private readonly maxWaitMs?;
+    private triggerIndex;
+    private waitTimer?;
+    private maxTimer?;
+    private latestArgs;
+    private actionInProgress;
+    private triggerPending;
+    constructor(action: (...args: Args) => Response, waitMs: number, maxWaitMs?: number);
+    private validate_WaitMs;
+    private validate_MaxWaitMs;
+    private clearTimers;
+    private executeAction;
+    /** Schedule the action to be performed (fire-and-forget). */
+    trigger(...args: Args): void;
+    /**
+     * Returns whether an action is currently scheduled
+     */
+    isScheduled(): boolean;
+    /**
+     * Run immediately if scheduled and return the action's value.
+     * - Returns Response when something was scheduled, else undefined.
+     * - If action throws sync here, it throws to the caller.
+     * - If action returns a rejected Promise, caller handles it.
+     */
+    flush(): Response | undefined;
+    /** Cancel any scheduled run. (Does not cancel in-flight.) */
+    clear(): void;
+}

package/utils/debounce.js

@@ -0,0 +1,115 @@
+import { BadImplementationException } from '../core/exceptions/exceptions.js';
+import { Logger } from '../core/logger/Logger.js';
+import { isPromise } from './promise-tools.js';
+import { exists } from './tools.js';
+export class Debounce extends Logger {
+    action;
+    waitMs;
+    maxWaitMs;
+    triggerIndex = 0;
+    waitTimer;
+    maxTimer;
+    latestArgs = [];
+    actionInProgress = false;
+    triggerPending = false;
+    constructor(action, waitMs, maxWaitMs) {
+        super('Debounce');
+        this.validate_WaitMs(waitMs);
+        this.validate_MaxWaitMs(waitMs, maxWaitMs);
+        this.action = action;
+        this.waitMs = waitMs;
+        this.maxWaitMs = maxWaitMs;
+    }
+    //######################### Validation #########################
+    validate_WaitMs(waitMs) {
+        if (waitMs < 0)
+            throw new BadImplementationException('waitMs value must be >= 0');
+    }
+    validate_MaxWaitMs(waitMs, maxWaitMs) {
+        if (!exists(maxWaitMs))
+            return;
+        if (maxWaitMs <= 0)
+            throw new BadImplementationException('maxWaitMs value must be > 0');
+        if (maxWaitMs < waitMs)
+            this.logWarning('maxWaitMs < waitMs; the \'max\' may never matter');
+    }
+    //######################### Internal Logic #########################
+    clearTimers() {
+        if (this.waitTimer) {
+            clearTimeout(this.waitTimer);
+            this.waitTimer = undefined;
+        }
+        if (this.maxTimer) {
+            clearTimeout(this.maxTimer);
+            this.maxTimer = undefined;
+        }
+    }
+    executeAction(triggerIndex, immediate) {
+        if (triggerIndex !== this.triggerIndex)
+            return;
+        this.triggerIndex++;
+        const args = this.latestArgs ?? [];
+        this.clearTimers();
+        const result = this.action(...args);
+        if (immediate)
+            return result;
+        //Set up chain triggering if the action is asynchronous.
+        if (isPromise(result)) {
+            this.actionInProgress = true;
+            Promise.resolve(result).finally(() => {
+                this.actionInProgress = false;
+                //Immediately execute the action again if debounce was triggered during the current run
+                if (this.triggerPending) {
+                    this.triggerPending = false;
+                    void this.executeAction(this.triggerIndex);
+                }
+            });
+        }
+    }
+    //######################### Public Logic #########################
+    /** Schedule the action to be performed (fire-and-forget). */
+    trigger(...args) {
+        this.latestArgs = args;
+        //If action is in progress, queue up immediate trigger
+        if (this.actionInProgress) {
+            this.triggerPending = true;
+            return;
+        }
+        // Normal debounce behavior while idle:
+        //Reset waitTimer
+        if (this.waitTimer)
+            clearTimeout(this.waitTimer);
+        const triggerIndex = this.triggerIndex;
+        this.waitTimer = setTimeout(() => {
+            void this.executeAction(triggerIndex);
+        }, this.waitMs);
+        //Set maxWaitTimer if configured and does not currently exist
+        if (exists(this.maxWaitMs) && !exists(this.maxTimer))
+            this.maxTimer = setTimeout(() => {
+                void this.executeAction(triggerIndex);
+            }, this.maxWaitMs);
+    }
+    /**
+     * Returns whether an action is currently scheduled
+     */
+    isScheduled() {
+        return exists(this.waitTimer ?? this.maxTimer);
+    }
+    /**
+     * Run immediately if scheduled and return the action's value.
+     * - Returns Response when something was scheduled, else undefined.
+     * - If action throws sync here, it throws to the caller.
+     * - If action returns a rejected Promise, caller handles it.
+     */
+    flush() {
+        if (!this.isScheduled())
+            return void this.logInfo('Not scheduled');
+        return this.executeAction(this.triggerIndex, true);
+    }
+    /** Cancel any scheduled run. (Does not cancel in-flight.) */
+    clear() {
+        this.clearTimers();
+        this.triggerIndex++;
+        this.triggerPending = false;
+    }
+}

package/utils/exception-tools.js

@@ -13,4 +13,3 @@ const allExceptions = [
 export function isCustomException(e) {
     return allExceptions.some(exc => !!isErrorOfType(e, exc));
 }
-//# sourceMappingURL=exception-tools.js.map

package/utils/filter-tools.js

@@ -208,4 +208,3 @@ export class Filter {
         return this;
     }
 }
-//# sourceMappingURL=filter-tools.js.map

package/utils/hash-tools.js

@@ -44,4 +44,3 @@ export function encode(data, encoding = "base64") {
 export function decode(encoded, from = "base64", to = "utf8") {
     return Buffer.from(encoded, from).toString(to);
 }
-//# sourceMappingURL=hash-tools.js.map

package/utils/index.js

@@ -25,4 +25,3 @@ export * from "./types.js";
 export * from "./ui-tools.js";
 export * from "./url-tools.js";
 export * from "./version-tools.js";
-//# sourceMappingURL=index.js.map

package/utils/json-tools.js

@@ -11,4 +11,3 @@ export function isValidJson(_string) {
 export function prettifyJson(obj) {
     return __stringify(obj, true);
 }
-//# sourceMappingURL=json-tools.js.map

package/utils/merge-tools.js

@@ -69,4 +69,3 @@ export function merge(original, override, unsafe = false) {
         return mergeObject(original || {}, override, unsafe);
     return override;
 }
-//# sourceMappingURL=merge-tools.js.map

package/utils/mimetype-tools.js

@@ -42,4 +42,3 @@ export const MimeType_GROUP_rar = [
     MimeType_rar_compressed,
     MimeType_rar_octetStream,
 ];
-//# sourceMappingURL=mimetype-tools.js.map

package/utils/number-tools.d.ts

@@ -1,2 +1,3 @@
 export declare const roundNumber: (number: number, digits: number) => number;
 export declare const clamp: (min: number, num: number, max: number) => number;
+export declare const numberInRange: (number: number, range: [number, number]) => boolean;

package/utils/number-tools.js

@@ -20,4 +20,6 @@ export const roundNumber = (number, digits) => {
     return Math.round(number * multiple) / multiple;
 };
 export const clamp = (min, num, max) => Math.min(Math.max(num, min), max);
-//# sourceMappingURL=number-tools.js.map
+export const numberInRange = (number, range) => {
+    return range[0] <= number && number <= range[1];
+};

package/utils/object-tools.js

@@ -207,4 +207,3 @@ export function deepFreeze(object) {
     }
     return Object.freeze(object);
 }
-//# sourceMappingURL=object-tools.js.map