@nu-art/ts-common 0.300.8 → 0.400.1

package/utils/array-tools.js

@@ -1,4 +1,3 @@
-"use strict";
 /*
  * ts-common is the basic building blocks of our typescript projects
  *
@@ -16,44 +15,10 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.filterInOut = filterInOut;
-exports.removeItemFromArray = removeItemFromArray;
-exports.removeFromArray = removeFromArray;
-exports.removeFromArrayByIndex = removeFromArrayByIndex;
-exports.swapInArrayByIndex = swapInArrayByIndex;
-exports.addItemToArray = addItemToArray;
-exports.addItemToArrayAtIndex = addItemToArrayAtIndex;
-exports.toggleElementInArray = toggleElementInArray;
-exports.filterAsync = filterAsync;
-exports.findDuplicates = findDuplicates;
-exports.filterDuplicates = filterDuplicates;
-exports.filterInstances = filterInstances;
-exports.filterFalsy = filterFalsy;
-exports.arrayToMap = arrayToMap;
-exports.reduceToMap = reduceToMap;
-exports.sortArray = sortArray;
-exports.batchAction = batchAction;
-exports.Promise_all_sequentially = Promise_all_sequentially;
-exports.batchActionParallel = batchActionParallel;
-exports.flatArray = flatArray;
-exports.filterFlatInstances = filterFlatInstances;
-exports.groupArrayBy = groupArrayBy;
-exports.toggleInArray = toggleInArray;
-exports.generateArray = generateArray;
-exports.asArray = asArray;
-exports.asOptionalArray = asOptionalArray;
-exports.lastElement = lastElement;
-exports.firstElement = firstElement;
-exports.arrayIncludesAny = arrayIncludesAny;
-exports.clearArrayInstance = clearArrayInstance;
-exports.arrayIncludesAll = arrayIncludesAll;
-exports.getMax = getMax;
-exports.getMin = getMin;
-const tools_1 = require("./tools");
-const object_tools_1 = require("./object-tools");
-const exceptions_1 = require("../core/exceptions/exceptions");
-function filterInOut(input, filter) {
+import { exists } from './tools.js';
+import { _keys } from './object-tools.js';
+import { BadImplementationException } from '../core/exceptions/exceptions.js';
+export function filterInOut(input, filter) {
     return {
         filteredIn: input.filter(filter),
         filteredOut: input.filter((object) => !filter(object))
@@ -63,7 +28,7 @@ function filterInOut(input, filter) {
  * Finds and removes first instance of item from array
  * tested V
  */
-function removeItemFromArray(array, item) {
+export function removeItemFromArray(array, item) {
     const index = array.indexOf(item);
     return removeFromArrayByIndex(array, index);
 }
@@ -71,24 +36,26 @@ function removeItemFromArray(array, item) {
  * Removes the first item answering the condition given from array in place
  * tested V
  */
-function removeFromArray(array, item) {
-    const index = array.findIndex(item);
-    return removeFromArrayByIndex(array, index);
+export function removeFromArray(array, filter) {
+    const kept = array.filter(x => !filter(x));
+    array.length = 0;
+    array.push(...kept);
+    return array;
 }
 /**
  * Removes item from array in index
  * tested V
  */
-function removeFromArrayByIndex(array, index) {
+export function removeFromArrayByIndex(array, index) {
     if (index > -1)
         array.splice(index, 1);
     return array;
 }
-function swapInArrayByIndex(array, i1, i2) {
+export function swapInArrayByIndex(array, i1, i2) {
     if (i1 < 0 || i1 >= array.length)
-        throw new exceptions_1.BadImplementationException(`index i1 out of bounds: ${i1}`);
+        throw new BadImplementationException(`index i1 out of bounds: ${i1}`);
     if (i2 < 0 || i2 >= array.length)
-        throw new exceptions_1.BadImplementationException(`index i2 out of bounds: ${i2}`);
+        throw new BadImplementationException(`index i2 out of bounds: ${i2}`);
     if (i1 === i2)
         return array;
     const temp = array[i1];
@@ -99,15 +66,15 @@ function swapInArrayByIndex(array, i1, i2) {
 /**
  * Deprecated
  */
-function addItemToArray(array, item) {
+export function addItemToArray(array, item) {
     array.push(item);
     return array;
 }
-function addItemToArrayAtIndex(array, item, index) {
+export function addItemToArrayAtIndex(array, item, index) {
     array.splice(index, 0, item);
     return array;
 }
-function toggleElementInArray(array, item) {
+export function toggleElementInArray(array, item) {
     const index = array.indexOf(item);
     if (index > -1)
         array.splice(index, 1);
@@ -118,7 +85,7 @@ function toggleElementInArray(array, item) {
 /**
  * Removes all items answering the condition given from array in place
  */
-async function filterAsync(arr, filter) {
+export async function filterAsync(arr, filter) {
     //const boolArray = await arr.map(item => filter(item)); changed
     const boolArray = await Promise.all(arr.map(item => filter(item)));
     return arr.filter((item, index) => boolArray[index]);
@@ -127,42 +94,47 @@ async function filterAsync(arr, filter) {
  * builds array that holds all items that are in array1 and array2
  * problem with objects
  */
-function findDuplicates(array1, array2) {
+export function findDuplicates(array1, array2) {
     return array1.filter(val => array2.indexOf(val) !== -1);
 }
 const defaultMapper = (item) => item;
 /**
  remove all duplicates in array
  * */
-function filterDuplicates(source, mapper = defaultMapper) {
+export function filterDuplicates(source, mapper = defaultMapper) {
     if (defaultMapper === mapper)
         return Array.from(new Set(source));
-    const uniqueKeys = new Set(source.map(mapper));
-    return source.filter(item => uniqueKeys.delete(mapper(item)));
+    let _mapper;
+    if (typeof mapper === 'function')
+        _mapper = mapper;
+    else
+        _mapper = ((item) => item[mapper]);
+    const uniqueKeys = new Set(source.map(_mapper));
+    return source.filter(item => uniqueKeys.delete(_mapper(item)));
 }
 /**
  * filter array of all undefined and null
  * */
-function filterInstances(array) {
-    return ((array === null || array === void 0 ? void 0 : array.filter(item => (0, tools_1.exists)(item))) || []);
+export function filterInstances(array) {
+    return (array?.filter(item => exists(item)) || []);
 }
 /**
  * filter array of all falsy instances
  * */
-function filterFalsy(array) {
-    return ((array === null || array === void 0 ? void 0 : array.filter(item => !!item)) || []);
+export function filterFalsy(array) {
+    return (array?.filter(item => !!item) || []);
 }
 /**
  * receives array and builds hashmap whom keys are decided via function and values are from array
  * */
-function arrayToMap(array, getKey, map = {}) {
+export function arrayToMap(array, getKey, map = {}) {
     return reduceToMap(array, getKey, item => item, map);
 }
 /**
  * turns array into object that is similar to hashmap
  *
  */
-function reduceToMap(array, keyResolver, mapper, map = {}) {
+export function reduceToMap(array, keyResolver, mapper, map = {}) {
     return array.reduce((toRet, element, index) => {
         const keys = keyResolver(element, index, toRet);
         const output = mapper(element, index, toRet);
@@ -176,7 +148,7 @@ function reduceToMap(array, keyResolver, mapper, map = {}) {
 /**
  * sorts array
  * */
-function sortArray(array, map = i => i, invert = false) {
+export function sortArray(array, map = i => i, invert = false) {
     const functionMap = map;
     if (typeof functionMap === 'function') {
         const compareFn = (a, b) => {
@@ -198,7 +170,7 @@ function sortArray(array, map = i => i, invert = false) {
 /**
  * "splits" array into given size of chunks and then does "action" on chunk and return to array of actions on chunks +-
  * */
-async function batchAction(arr, chunk, action) {
+export async function batchAction(arr, chunk, action) {
     const result = [];
     for (let i = 0, j = arr.length; i < j; i += chunk) {
         const items = await action(arr.slice(i, i + chunk));
@@ -228,14 +200,14 @@ async function batchAction(arr, chunk, action) {
  * ```
  * @param promises
  */
-async function Promise_all_sequentially(promises) {
+export async function Promise_all_sequentially(promises) {
     const results = [];
     for (const promise of promises) {
         results.push(await promise());
     }
     return results;
 }
-async function batchActionParallel(arr, chunk, action) {
+export async function batchActionParallel(arr, chunk, action) {
     const promises = [];
     for (let i = 0, j = arr.length; i < j; i += chunk) {
         addItemToArray(promises, action(arr.slice(i, i + chunk)));
@@ -257,7 +229,7 @@ async function batchActionParallel(arr, chunk, action) {
  * @param arr An array that is potentially a matrix
  * @param result A flat array of single values
  */
-function flatArray(arr, result = []) {
+export function flatArray(arr, result = []) {
     for (let i = 0, length = arr.length; i < length; i++) {
         const value = arr[i];
         if (Array.isArray(value)) {
@@ -269,42 +241,42 @@ function flatArray(arr, result = []) {
     }
     return result;
 }
-function filterFlatInstances(arr, result = []) {
+export function filterFlatInstances(arr, result = []) {
     return filterInstances(flatArray(arr, result));
 }
-function groupArrayBy(arr, mapper) {
+export function groupArrayBy(arr, mapper) {
     const map = arr.reduce((agg, item, index) => {
         const key = mapper(item, index);
         (agg[key] || (agg[key] = [])).push(item);
         return agg;
     }, {});
-    return (0, object_tools_1._keys)(map).map(key => ({ key, values: map[key] }));
+    return _keys(map).map(key => ({ key, values: map[key] }));
 }
-function toggleInArray(arr, item, mapper = item => item) {
+export function toggleInArray(arr, item, mapper = item => item) {
     const index = arr.findIndex(_item => mapper(_item) === mapper(item));
     if (index !== -1)
         removeFromArrayByIndex(arr, index);
     else
         arr.push(item);
 }
-function generateArray(length, mapper = i => i) {
+export function generateArray(length, mapper = i => i) {
     return Array.from({ length }).map((e, i) => mapper(i));
 }
-function asArray(toBeArray) {
+export function asArray(toBeArray) {
     return Array.isArray(toBeArray) ? toBeArray : [toBeArray];
 }
-function asOptionalArray(toBeArray) {
-    if (!(0, tools_1.exists)(toBeArray))
+export function asOptionalArray(toBeArray) {
+    if (!exists(toBeArray))
         return undefined;
     return asArray(toBeArray);
 }
-function lastElement(array) {
-    return array === null || array === void 0 ? void 0 : array[(array === null || array === void 0 ? void 0 : array.length) - 1];
+export function lastElement(array) {
+    return array?.[array?.length - 1];
 }
-function firstElement(array) {
-    return array === null || array === void 0 ? void 0 : array[0];
+export function firstElement(array) {
+    return array?.[0];
 }
-function arrayIncludesAny(arr1, arr2) {
+export function arrayIncludesAny(arr1, arr2) {
     return arr1.some(item => arr2.includes(item));
 }
 /**
@@ -312,7 +284,7 @@ function arrayIncludesAny(arr1, arr2) {
  * This function will take any array and clear it's content completely while keeping the same instance to save memory
  * @param arr - Any array
  */
-function clearArrayInstance(arr) {
+export function clearArrayInstance(arr) {
     arr.length = 0;
 }
 /**
@@ -320,14 +292,15 @@ function clearArrayInstance(arr) {
  * @param arr1
  * @param arr2
  */
-function arrayIncludesAll(arr1, arr2) {
+export function arrayIncludesAll(arr1, arr2) {
     return arr2.every(item => arr1.includes(item));
 }
-function getMax(arr, mapper = (item) => item) {
+export function getMax(arr, mapper = (item) => item) {
     const sorted = sortArray(arr, mapper, true);
     return sorted[0];
 }
-function getMin(arr, mapper = (item) => item) {
+export function getMin(arr, mapper = (item) => item) {
     const sorted = sortArray(arr, mapper);
     return sorted[0];
 }
+//# sourceMappingURL=array-tools.js.map

package/utils/array-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"array-tools.js","sourceRoot":"/Users/tacb0ss/dev/nu-art/beamz/_thunderstorm/ts-common/src/main/","sources":["utils/array-tools.ts"],"names":[],"mappings":"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"}

package/utils/conflict-tools.d.ts

@@ -0,0 +1 @@
+export declare const findConflicts: <T>(origin: T, ours: T, theirs: T) => void;

package/utils/conflict-tools.js

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

package/utils/conflict-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflict-tools.js","sourceRoot":"/Users/tacb0ss/dev/nu-art/beamz/_thunderstorm/ts-common/src/main/","sources":["utils/conflict-tools.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAI,MAAS,EAAE,IAAO,EAAE,MAAS,EAAE,EAAE;AAElE,CAAC,CAAC"}

package/utils/crypto-tools.d.ts

@@ -1,3 +1,47 @@
+import { RecursiveObjectOfPrimitives } from './types.js';
 export declare function randomNumber(range: number): number;
 export declare function randomObject<T>(items: T[]): T;
 export declare function hashPasswordWithSalt(salt: string | Buffer, password: string | Buffer): string;
+export type JWT_BaseClaims = {
+    iat: number;
+    exp: number;
+};
+/** Options for encoding a JWT */
+export interface EncodeJWT_Options {
+    /** Expiration – e.g. '1h', '10m', or absolute epoch seconds */
+    expiresIn?: string | number;
+    /** Signing algorithm – defaults to 'HS256'. Examples: 'RS256', 'ES256', 'EdDSA' */
+    alg?: string;
+}
+export declare const JwtTools: {
+    /**
+     * Create a signed JWT.
+     * @param data     Payload to embed in the token.
+     * @param secret   Shared secret (HS*) **or** private key (other algs).
+     * @param options  Optional `expiresIn` and `alg` (defaults to 'HS256'). If
+     *                 `expiresIn` is omitted, a 1‑hour token is issued.
+     */
+    encode: <T extends RecursiveObjectOfPrimitives>(data: T, secret: string, options?: EncodeJWT_Options) => Promise<string>;
+    /**
+     * Decode a JWT.
+     * – If `secret` is provided, verify signature and registered claims.
+     * – If omitted, only parse Base64Url segments (⚠️ no integrity check).
+     */
+    decode: <T extends RecursiveObjectOfPrimitives>(token: string, secret?: string) => Promise<T & JWT_BaseClaims>;
+    verifySignature: <T extends RecursiveObjectOfPrimitives>(token: string, secret: string) => Promise<T & JWT_BaseClaims>;
+    /**
+     * Extract the `iat` (Issued‑At) claim from a token without verifying.
+     * @returns Epoch seconds or `undefined` if the claim is missing / malformed.
+     */
+    getCreationTime: (token: string) => Promise<number | undefined>;
+    /**
+     * Lightweight client‑side freshness check based on the `exp` claim.
+     * NOTE: This does **not** verify the signature.
+     */
+    isJwtActive: (token: string) => Promise<boolean>;
+    isJwtExpired: (token: string) => Promise<boolean>;
+};
+export declare const TEST_JwtTools: {
+    beforeAll: () => void;
+    afterAll: () => void;
+};

package/utils/crypto-tools.js

@@ -1,4 +1,3 @@
-"use strict";
 /*
  * ts-common is the basic building blocks of our typescript projects
  *
@@ -16,19 +15,111 @@
  * See the License for the specific language governing permissions and
  * limitations under the License.
  */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.randomNumber = randomNumber;
-exports.randomObject = randomObject;
-exports.hashPasswordWithSalt = hashPasswordWithSalt;
-const crypto_1 = require("crypto");
-function randomNumber(range) {
+import { createHmac } from 'crypto';
+import { decodeJwt, jwtVerify, SignJWT } from 'jose';
+import { exists } from './tools.js';
+import { currentTimeMillis } from './date-time-tools.js';
+// Text encoder instance reused for key derivation
+const te = new TextEncoder();
+export function randomNumber(range) {
     return Math.floor(Math.random() * (range));
 }
-function randomObject(items) {
+export function randomObject(items) {
     return items[randomNumber(items.length)];
 }
-function hashPasswordWithSalt(salt, password) {
-    return (0, crypto_1.createHmac)('sha512', salt)
+export function hashPasswordWithSalt(salt, password) {
+    return createHmac('sha512', salt)
         .update(password)
         .digest('hex');
 }
+/**
+ * Derive an HMAC‑SHA secret key from a raw string.
+ * jose APIs expect a Uint8Array key for HS* algorithms.
+ */
+const hmacKey = (secret) => te.encode(secret);
+export const JwtTools = {
+    /**
+     * Create a signed JWT.
+     * @param data     Payload to embed in the token.
+     * @param secret   Shared secret (HS*) **or** private key (other algs).
+     * @param options  Optional `expiresIn` and `alg` (defaults to 'HS256'). If
+     *                 `expiresIn` is omitted, a 1‑hour token is issued.
+     */
+    encode: async (data, secret, options) => {
+        return new SignJWT(data)
+            .setProtectedHeader({ alg: options?.alg ?? 'HS256', type: 'JWT' })
+            .setIssuedAt()
+            .setExpirationTime(options?.expiresIn ?? '1h')
+            .sign(hmacKey(secret));
+    },
+    /**
+     * Decode a JWT.
+     * – If `secret` is provided, verify signature and registered claims.
+     * – If omitted, only parse Base64Url segments (⚠️ no integrity check).
+     */
+    decode: async (token, secret) => {
+        if (secret)
+            return JwtTools.verifySignature(token, secret);
+        return decodeJwt(token);
+    },
+    verifySignature: async (token, secret) => {
+        return (await jwtVerify(token, hmacKey(secret))).payload;
+    },
+    /**
+     * Extract the `iat` (Issued‑At) claim from a token without verifying.
+     * @returns Epoch seconds or `undefined` if the claim is missing / malformed.
+     */
+    getCreationTime: async (token) => {
+        try {
+            const { iat } = decodeJwt(token);
+            return typeof iat === 'number' ? iat : undefined;
+        }
+        catch {
+            return undefined;
+        }
+    },
+    /**
+     * Lightweight client‑side freshness check based on the `exp` claim.
+     * NOTE: This does **not** verify the signature.
+     */
+    isJwtActive: async (token) => {
+        try {
+            const { exp } = decodeJwt(token);
+            if (!exists(exp))
+                return false;
+            const now = Math.floor(currentTimeMillis() / 1000);
+            return exp > now;
+        }
+        catch (err) {
+            // Preserve original behaviour: swallow errors and report invalid.
+            // this.logError?.('Error validating session token', err);
+            return false;
+        }
+    },
+    isJwtExpired: async (token) => {
+        return !(await JwtTools.isJwtActive(token));
+    }
+};
+const originalJwtTools_encode = JwtTools.encode;
+const originalJwtTools_verifySignature = JwtTools.verifySignature;
+const TEST_JwtTools_BeforeAll = () => {
+    JwtTools.encode = async (data, secret, options) => {
+        return new SignJWT(data)
+            .setProtectedHeader({ alg: options?.alg ?? 'HS256', type: 'JWT' })
+            .setIssuedAt(Math.floor(currentTimeMillis() / 1000))
+            .setExpirationTime(options?.expiresIn ?? '1h')
+            .sign(hmacKey(secret));
+    };
+    JwtTools.verifySignature = async (token, secret) => {
+        return (await jwtVerify(token, hmacKey(secret), { currentDate: new Date(currentTimeMillis()) })).payload;
+    };
+};
+const TEST_JwtTools_AfterAll = () => {
+    JwtTools.encode = originalJwtTools_encode;
+    JwtTools.verifySignature = originalJwtTools_verifySignature;
+};
+export const TEST_JwtTools = {
+    beforeAll: TEST_JwtTools_BeforeAll,
+    afterAll: TEST_JwtTools_AfterAll,
+};
+//# sourceMappingURL=crypto-tools.js.map

package/utils/crypto-tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"crypto-tools.js","sourceRoot":"/Users/tacb0ss/dev/nu-art/beamz/_thunderstorm/ts-common/src/main/","sources":["utils/crypto-tools.ts"],"names":[],"mappings":"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"}

package/utils/date-time-tools.d.ts

@@ -1,4 +1,4 @@
-import { AuditBy, Timestamp } from './types';
+import { AuditBy, Timestamp } from './types.js';
 export declare const Second = 1000;
 export declare const Minute: number;
 export declare const Hour: number;
@@ -10,14 +10,54 @@ export declare const Format_HHmmss_DDMMYYYY = "HH:mm:ss_DD-MM-YYYY";
 export declare const Format_YYYYMMDD_HHmmss = "YYYY-MM-DD_HH:mm:ss";
 export type Weekday = 'Sunday' | 'Monday' | 'Tuesday' | 'Wednesday' | 'Thursday' | 'Friday' | 'Saturday';
 export declare const Weekdays: Weekday[];
-export type TimerHandler = (...args: any[]) => void;
+export type TimerHandler<Args extends any[] = any[]> = (...args: Args) => void;
 export type TimeRange = [number, number] | [undefined, number] | [number, undefined];
+export type TimeCounter = {
+    dt: () => number;
+    format: (format: string) => string;
+};
 export declare function timeout(sleepMs: number): Promise<unknown>;
 export declare const sleep: typeof timeout;
-export declare function _setTimeout(handler: TimerHandler, sleepMs?: number, ...args: any[]): number;
+export declare function _setTimeout<Args extends any[]>(handler: TimerHandler<Args>, sleepMs?: number, ...args: Args): number;
 export declare function _clearTimeout(handlerId?: number): void;
-export declare function _setInterval(handler: TimerHandler, sleepMs?: number, ...args: any[]): number;
+export declare function _setInterval<Args extends any[]>(handler: TimerHandler<Args>, sleepMs?: number, ...args: Args): number;
 export declare function _clearInterval(handlerId?: number): void;
+/**
+ * Creates a timeout handler object that manages a single `setTimeout` instance.
+ * Includes lifecycle controls: set, clear, reset, isActive.
+ *
+ * @param handler The function to be called after the timeout.
+ * @param sleepMs Timeout duration in milliseconds. Defaults to 0.
+ * @param args Arguments passed to the handler function.
+ * @returns An object with `set`, `clear`, `reset`, and `isActive` methods.
+ */
+export declare const timeoutHandler: <Args extends any[]>(handler: TimerHandler<Args>, sleepMs?: number, ...args: Args) => {
+    set: () => void;
+    clear: () => void;
+    reset: () => void;
+    isActive: () => boolean;
+    _: {
+        onTimeAdjusted: () => void;
+    };
+};
+/**
+ * Creates an interval handler object that manages a single `setInterval` instance.
+ * Includes lifecycle controls: set, clear, reset, isActive.
+ *
+ * @param handler The function to be called repeatedly.
+ * @param sleepMs Interval duration in milliseconds. Defaults to 0.
+ * @param args Arguments passed to the handler function.
+ * @returns An object with `set`, `clear`, `reset`, and `isActive` methods.
+ */
+export declare const intervalHandler: <Args extends any[]>(handler: TimerHandler<Args>, sleepMs?: number, ...args: Args) => {
+    set: () => void;
+    clear: () => void;
+    reset: () => void;
+    isActive: () => boolean;
+    _: {
+        onTimeAdjusted: () => NodeJS.Timeout | undefined;
+    };
+};
 /**
  * @param comment @deprecated
  */
@@ -51,3 +91,7 @@ export declare const DateTimeFormat_DDMMYYYY: {
 };
 export declare function isSameDay(date1: Date, date2: Date): boolean;
 export declare function deltaDays(d1: Date | number, d2: Date | number): number;
+export declare function timeCounter(): {
+    dt: () => number;
+    format: (format: string) => string;
+};