@futdevpro/fsm-dynamo 1.16.37 → 1.16.39

package/build/_collections/utils/round-list.util.js

@@ -1,113 +1,113 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DyFM_RoundList = void 0;
-/**
- * This class is a collection of static methods for round list operations
- * A round list is a list that is circular
- * - after the last element, the first comes next
- */
-class DyFM_RoundList {
-    /**
-     * returns the outbound index of the list
-     * @param listLength
-     * @param outboundIndex
-     * @returns
-     *
-     * @example
-     * ```ts
-     * const listLength = 10;
-     * const outboundIndex = 15;
-     * const result = DyFM_RoundList.getOutboundedIndex(listLength, outboundIndex);
-     * console.log(result); // 5
-     * ```
-     */
-    static getOutboundedIndex(listLength, outboundIndex) {
-        if (!listLength) {
-            throw new Error('roundListPlusIndex failed. list is empty!');
-        }
-        if (outboundIndex < 0) {
-            outboundIndex = outboundIndex % listLength;
-            outboundIndex = listLength + outboundIndex;
-        }
-        if (listLength <= outboundIndex) {
-            outboundIndex = outboundIndex % listLength;
-        }
-        return outboundIndex;
-    }
-    /**
-     * returns the index of the opposite element of the list
-     * - as they are circular, the opposite is at the half of the list
-     * - as it is circular, for the second half, the opposite is at the first half
-     * @param length
-     * @param oppositeOf
-     * @returns
-     *
-     * @example
-     * ```ts
-     * const length = 10;
-     * const oppositeOf = 5;
-     * const result = DyFM_RoundList.getIndexOpposite(length, oppositeOf);
-     * console.log(result); // 0
-     * ```
-     */
-    static getIndexOpposite(length, oppositeOf) {
-        const plusIndex = oppositeOf + Math.round(length / 2);
-        const res = this.getOutboundedIndex(length, plusIndex);
-        return res;
-    }
-    /**
-     * returns the element at the outbound index of the list
-     * @param list
-     * @param outboundIndex
-     * @returns
-     *
-     * @example
-     * ```ts
-     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
-     * const outboundIndex = 15;
-     * const result = DyFM_RoundList.getListIndex(list, outboundIndex);
-     * console.log(result); // 5
-     * ```
-     */
-    static getListIndex(list, outboundIndex) {
-        return list[this.getOutboundedIndex(list.length, outboundIndex)];
-    }
-    /**
-     * returns the element at the opposite index of the list
-     * @param list
-     * @param oppositeOf
-     * @returns
-     *
-     * @example
-     * ```ts
-     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
-     * const oppositeOf = 5;
-     * const result = DyFM_RoundList.getListOpposite(list, oppositeOf);
-     * console.log(result); // 0
-     * ```
-     */
-    static getListOpposite(list, oppositeOf) {
-        return list[this.getIndexOpposite(list.length, list.indexOf(oppositeOf))];
-    }
-    /**
-     * returns the last element of the list
-     * returns null if the list is empty
-     *
-     * @example
-     * ```ts
-     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
-     * const result = DyFM_RoundList.getLast(list);
-     * console.log(result); // 10
-     * ```
-     */
-    static getLast(list) {
-        if (0 < list.length) {
-            return list[list.length - 1];
-        }
-        else {
-            return null;
-        }
-    }
-}
-exports.DyFM_RoundList = DyFM_RoundList;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DyFM_RoundList = void 0;
+/**
+ * This class is a collection of static methods for round list operations
+ * A round list is a list that is circular
+ * - after the last element, the first comes next
+ */
+class DyFM_RoundList {
+    /**
+     * returns the outbound index of the list
+     * @param listLength
+     * @param outboundIndex
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const listLength = 10;
+     * const outboundIndex = 15;
+     * const result = DyFM_RoundList.getOutboundedIndex(listLength, outboundIndex);
+     * console.log(result); // 5
+     * ```
+     */
+    static getOutboundedIndex(listLength, outboundIndex) {
+        if (!listLength) {
+            throw new Error('roundListPlusIndex failed. list is empty!');
+        }
+        if (outboundIndex < 0) {
+            outboundIndex = outboundIndex % listLength;
+            outboundIndex = listLength + outboundIndex;
+        }
+        if (listLength <= outboundIndex) {
+            outboundIndex = outboundIndex % listLength;
+        }
+        return outboundIndex;
+    }
+    /**
+     * returns the index of the opposite element of the list
+     * - as they are circular, the opposite is at the half of the list
+     * - as it is circular, for the second half, the opposite is at the first half
+     * @param length
+     * @param oppositeOf
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const length = 10;
+     * const oppositeOf = 5;
+     * const result = DyFM_RoundList.getIndexOpposite(length, oppositeOf);
+     * console.log(result); // 0
+     * ```
+     */
+    static getIndexOpposite(length, oppositeOf) {
+        const plusIndex = oppositeOf + Math.round(length / 2);
+        const res = this.getOutboundedIndex(length, plusIndex);
+        return res;
+    }
+    /**
+     * returns the element at the outbound index of the list
+     * @param list
+     * @param outboundIndex
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
+     * const outboundIndex = 15;
+     * const result = DyFM_RoundList.getListIndex(list, outboundIndex);
+     * console.log(result); // 5
+     * ```
+     */
+    static getListIndex(list, outboundIndex) {
+        return list[this.getOutboundedIndex(list.length, outboundIndex)];
+    }
+    /**
+     * returns the element at the opposite index of the list
+     * @param list
+     * @param oppositeOf
+     * @returns
+     *
+     * @example
+     * ```ts
+     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
+     * const oppositeOf = 5;
+     * const result = DyFM_RoundList.getListOpposite(list, oppositeOf);
+     * console.log(result); // 0
+     * ```
+     */
+    static getListOpposite(list, oppositeOf) {
+        return list[this.getIndexOpposite(list.length, list.indexOf(oppositeOf))];
+    }
+    /**
+     * returns the last element of the list
+     * returns null if the list is empty
+     *
+     * @example
+     * ```ts
+     * const list = [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10 ];
+     * const result = DyFM_RoundList.getLast(list);
+     * console.log(result); // 10
+     * ```
+     */
+    static getLast(list) {
+        if (0 < list.length) {
+            return list[list.length - 1];
+        }
+        else {
+            return null;
+        }
+    }
+}
+exports.DyFM_RoundList = DyFM_RoundList;
 //# sourceMappingURL=round-list.util.js.map

package/build/_collections/utils/round-list.util.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=round-list.util.spec.d.ts.map

package/build/_collections/utils/round-list.util.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"round-list.util.spec.d.ts","sourceRoot":"","sources":["../../../src/_collections/utils/round-list.util.spec.ts"],"names":[],"mappings":""}

package/build/_collections/utils/round-list.util.spec.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const round_list_util_1 = require("./round-list.util");
+describe('| DyFM_RoundList', () => {
+    describe('| getOutboundedIndex', () => {
+        it('| should throw an error if listLength is 0', () => {
+            expect(() => round_list_util_1.DyFM_RoundList.getOutboundedIndex(0, 5)).toThrowError('roundListPlusIndex failed. list is empty!');
+        });
+        it('| should return correct index for positive outboundIndex within bounds', () => {
+            expect(round_list_util_1.DyFM_RoundList.getOutboundedIndex(5, 3)).toBe(3);
+        });
+        it('| should return correct index for positive outboundIndex out of bounds', () => {
+            expect(round_list_util_1.DyFM_RoundList.getOutboundedIndex(5, 7)).toBe(2);
+        });
+        it('| should return correct index for negative outboundIndex', () => {
+            expect(round_list_util_1.DyFM_RoundList.getOutboundedIndex(5, -2)).toBe(3);
+        });
+    });
+    describe('| getIndexOpposite', () => {
+        it('| should return the opposite index in a circular manner', () => {
+            expect(round_list_util_1.DyFM_RoundList.getIndexOpposite(8, 7)).toBe(3);
+        });
+        it('| should handle even length arrays correctly', () => {
+            expect(round_list_util_1.DyFM_RoundList.getIndexOpposite(4, 1)).toBe(3);
+        });
+        it('| should handle odd length arrays correctly', () => {
+            expect(round_list_util_1.DyFM_RoundList.getIndexOpposite(5, 2)).toBe(0);
+        });
+    });
+    describe('| getListIndex', () => {
+        it('| should return the correct element for a given outboundIndex', () => {
+            const list = ['a', 'b', 'c', 'd'];
+            expect(round_list_util_1.DyFM_RoundList.getListIndex(list, 5)).toBe('b');
+        });
+        it('| should handle negative outboundIndex', () => {
+            const list = ['a', 'b', 'c', 'd'];
+            expect(round_list_util_1.DyFM_RoundList.getListIndex(list, -1)).toBe('d');
+        });
+    });
+    describe('| getListOpposite', () => {
+        it('| should return the opposite element in a circular manner', () => {
+            const list = ['a', 'b', 'c', 'd', 'e', 'f', 'g', 'h'];
+            expect(round_list_util_1.DyFM_RoundList.getListOpposite(list, 'h')).toBe('d');
+        });
+        it('| should handle even length lists correctly', () => {
+            const list = ['a', 'b', 'c', 'd'];
+            expect(round_list_util_1.DyFM_RoundList.getListOpposite(list, 'b')).toBe('d');
+        });
+        it('| should handle odd length lists correctly', () => {
+            const list = ['a', 'b', 'c', 'd', 'e'];
+            expect(round_list_util_1.DyFM_RoundList.getListOpposite(list, 'c')).toBe('a');
+        });
+    });
+    describe('| getLast', () => {
+        it('| should return the last element of the list', () => {
+            const list = ['a', 'b', 'c'];
+            expect(round_list_util_1.DyFM_RoundList.getLast(list)).toBe('c');
+        });
+        it('| should return null for an empty list', () => {
+            const list = [];
+            expect(round_list_util_1.DyFM_RoundList.getLast(list)).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=round-list.util.spec.js.map

package/build/_collections/utils/round-list.util.spec.js.map

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

package/build/_collections/utils/secret-mask.util.d.ts

@@ -1,90 +1,90 @@
-/**
- * FR-093 (2026-06-09) — Universal secret/key masking utility (bedrock level).
- *
- * Lehetove teszi az ALL-FDP-systems-szintu secret-szivargas-detection +
- * maszkolas-t egy bedrock-szinten. A korabban Overseer / runner-worker
- * helyi util-jai (FR-092) most ezt importaljak — egy SOR konfiguracio +
- * find-and-replace.
- *
- * User feedback ('az osszes rendszerunknek a lenyege az univerzalizalt,
- * mindenhol hasznalhato, egysegesített megoldások'): every secret-pattern
- * ennek a egyetlen DyFM_SecretMask_Util-nak a felelossege.
- *
- * Strategy — KETTOS:
- *   1. **PATTERN-based**: ismert secret-formatumokra automatikus felismeres.
- *   2. **VALUE-based**: a process.env-jenek secret-erteket overlay-eli minden szovegben.
- *
- * Identifiability config (`DyFM_SecretMask_Settings.partialReveal`):
- *   - DEFAULT: `{ prefix: 4, suffix: 4 }` — a kulcsok elso 4 + utolso 4 char-ja
- *     megorzodik, kozeppe `[redacted-<KIND>]` keruln, pl.:
- *       `ghp_abcdefghij1234567890abcdefghij12345678` → `ghp_abcd...5678 [redacted-github-pat]`
- *   - User-extensible: csokkentett vagy 0-os reveal a tobb-biztonsagos
- *     deploymentekhez (`{ prefix: 0, suffix: 0 }` → tisztan opaque).
- *
- * Per memory `[[feedback_rich_error_handling]]`: a maszkolt token jelzes ne
- * legyen `***` opaque; legyen `[redacted-<KIND>]` hogy ranezessel lassuk MILYEN
- * tipusu szivargast szuntunk meg.
- *
- * Pattern-mapping per memory `[[feedback_individual_plans]]` — single source of
- * truth: minden uj secret-format hozzaadando a `DyFM_SECRET_PATTERNS` array-hez;
- * a tobbi rendszerben (Overseer/runner/bedrock packages) automatikusan
- * megjelenik a fsm-bump utan.
- */
-export interface DyFM_SecretMask_PartialReveal_Interface {
-    /** Megorzendo elso karakter-szam (0 = teljesen elrejt). */
-    prefix: number;
-    /** Megorzendo utolso karakter-szam (0 = teljesen elrejt). */
-    suffix: number;
-}
-export interface DyFM_SecretMask_Settings_Interface {
-    /**
-     * Identifiability-controls. Default `{ prefix: 4, suffix: 4 }`. Beallitva
-     * pl. `{ prefix: 0, suffix: 0 }` opaque maszkolas-hoz.
-     */
-    partialReveal: DyFM_SecretMask_PartialReveal_Interface;
-    /**
-     * Min karakter-hossz amire az env-overlay alkalmaz. Rovid ertekek false
-     * positivot adnak (pl. `KEY=foo` ahol foo a project-name). Default: 8.
-     */
-    minEnvValueLength: number;
-    /**
-     * `process.env`-bol kulcsneveket szuro regex. Default match: minden olyan
-     * env-var ahol a NEV titkos-jellegu (TOKEN/SECRET/KEY/PASSWORD/PAT/HMAC stb.).
-     */
-    envNameSecretRx: RegExp;
-}
-export declare const DyFM_DEFAULT_SECRET_MASK_SETTINGS: DyFM_SecretMask_Settings_Interface;
-interface SecretPattern_Interface {
-    /** Diagnosztikai cimke a `[redacted-<KIND>]` markerben. */
-    kind: string;
-    /** Detekcios regex (global flag is REQUIRED — a global flow minden match-et kezel). */
-    regex: RegExp;
-    /**
-     * `redactWith` — meghivva minden match-re a "matched" stringgel + settings-szel.
-     * Visszaad a csere-string-et. Default: partial-reveal-szel `<prefix>...<suffix> [redacted-<KIND>]`.
-     */
-    redactWith?: (matched: string, settings: DyFM_SecretMask_Settings_Interface) => string;
-    /**
-     * `wrapPrefix` — ha a regex captures (`$1` group-ja stb.) a literal-prefixet jelzi
-     * (pl. `Bearer ` a Bearer-token-nel), akkor a redact-result `[$1][reveal][marker]`-rel
-     * kerul ossze; a regex group az `wrapPrefix` index-en mutatott group. Default 0 = no wrap.
-     */
-    wrapPrefix?: number;
-}
-export declare const DyFM_SECRET_PATTERNS: SecretPattern_Interface[];
-/**
- * `DyFM_maskSecrets` — universal pre-Discord-send + pre-log-persist masking.
- *
- * @param text bemenet (ha nem string, JSON-szerializalaskor maskoljuk)
- * @param settings  konfiguracio (default a DyFM_DEFAULT_SECRET_MASK_SETTINGS)
- * @returns maszkolt szoveg
- */
-export declare function DyFM_maskSecrets(text: unknown, settings?: DyFM_SecretMask_Settings_Interface): string;
-/**
- * Recursive object-masker — JSON-szeru struktura minden string-ertekeben alkalmazza
- * a DyFM_maskSecrets-t. Pl. errors-table additionalContent / logTail tomb / cdpReport
- * objektum elotti masking-hez.
- */
-export declare function DyFM_maskSecretsDeep<T = unknown>(input: T, settings?: DyFM_SecretMask_Settings_Interface): T;
-export {};
+/**
+ * FR-093 (2026-06-09) — Universal secret/key masking utility (bedrock level).
+ *
+ * Lehetove teszi az ALL-FDP-systems-szintu secret-szivargas-detection +
+ * maszkolas-t egy bedrock-szinten. A korabban Overseer / runner-worker
+ * helyi util-jai (FR-092) most ezt importaljak — egy SOR konfiguracio +
+ * find-and-replace.
+ *
+ * User feedback ('az osszes rendszerunknek a lenyege az univerzalizalt,
+ * mindenhol hasznalhato, egysegesített megoldások'): every secret-pattern
+ * ennek a egyetlen DyFM_SecretMask_Util-nak a felelossege.
+ *
+ * Strategy — KETTOS:
+ *   1. **PATTERN-based**: ismert secret-formatumokra automatikus felismeres.
+ *   2. **VALUE-based**: a process.env-jenek secret-erteket overlay-eli minden szovegben.
+ *
+ * Identifiability config (`DyFM_SecretMask_Settings.partialReveal`):
+ *   - DEFAULT: `{ prefix: 4, suffix: 4 }` — a kulcsok elso 4 + utolso 4 char-ja
+ *     megorzodik, kozeppe `[redacted-<KIND>]` keruln, pl.:
+ *       `ghp_abcdefghij1234567890abcdefghij12345678` → `ghp_abcd...5678 [redacted-github-pat]`
+ *   - User-extensible: csokkentett vagy 0-os reveal a tobb-biztonsagos
+ *     deploymentekhez (`{ prefix: 0, suffix: 0 }` → tisztan opaque).
+ *
+ * Per memory `[[feedback_rich_error_handling]]`: a maszkolt token jelzes ne
+ * legyen `***` opaque; legyen `[redacted-<KIND>]` hogy ranezessel lassuk MILYEN
+ * tipusu szivargast szuntunk meg.
+ *
+ * Pattern-mapping per memory `[[feedback_individual_plans]]` — single source of
+ * truth: minden uj secret-format hozzaadando a `DyFM_SECRET_PATTERNS` array-hez;
+ * a tobbi rendszerben (Overseer/runner/bedrock packages) automatikusan
+ * megjelenik a fsm-bump utan.
+ */
+export interface DyFM_SecretMask_PartialReveal_Interface {
+    /** Megorzendo elso karakter-szam (0 = teljesen elrejt). */
+    prefix: number;
+    /** Megorzendo utolso karakter-szam (0 = teljesen elrejt). */
+    suffix: number;
+}
+export interface DyFM_SecretMask_Settings_Interface {
+    /**
+     * Identifiability-controls. Default `{ prefix: 4, suffix: 4 }`. Beallitva
+     * pl. `{ prefix: 0, suffix: 0 }` opaque maszkolas-hoz.
+     */
+    partialReveal: DyFM_SecretMask_PartialReveal_Interface;
+    /**
+     * Min karakter-hossz amire az env-overlay alkalmaz. Rovid ertekek false
+     * positivot adnak (pl. `KEY=foo` ahol foo a project-name). Default: 8.
+     */
+    minEnvValueLength: number;
+    /**
+     * `process.env`-bol kulcsneveket szuro regex. Default match: minden olyan
+     * env-var ahol a NEV titkos-jellegu (TOKEN/SECRET/KEY/PASSWORD/PAT/HMAC stb.).
+     */
+    envNameSecretRx: RegExp;
+}
+export declare const DyFM_DEFAULT_SECRET_MASK_SETTINGS: DyFM_SecretMask_Settings_Interface;
+interface SecretPattern_Interface {
+    /** Diagnosztikai cimke a `[redacted-<KIND>]` markerben. */
+    kind: string;
+    /** Detekcios regex (global flag is REQUIRED — a global flow minden match-et kezel). */
+    regex: RegExp;
+    /**
+     * `redactWith` — meghivva minden match-re a "matched" stringgel + settings-szel.
+     * Visszaad a csere-string-et. Default: partial-reveal-szel `<prefix>...<suffix> [redacted-<KIND>]`.
+     */
+    redactWith?: (matched: string, settings: DyFM_SecretMask_Settings_Interface) => string;
+    /**
+     * `wrapPrefix` — ha a regex captures (`$1` group-ja stb.) a literal-prefixet jelzi
+     * (pl. `Bearer ` a Bearer-token-nel), akkor a redact-result `[$1][reveal][marker]`-rel
+     * kerul ossze; a regex group az `wrapPrefix` index-en mutatott group. Default 0 = no wrap.
+     */
+    wrapPrefix?: number;
+}
+export declare const DyFM_SECRET_PATTERNS: SecretPattern_Interface[];
+/**
+ * `DyFM_maskSecrets` — universal pre-Discord-send + pre-log-persist masking.
+ *
+ * @param text bemenet (ha nem string, JSON-szerializalaskor maskoljuk)
+ * @param settings  konfiguracio (default a DyFM_DEFAULT_SECRET_MASK_SETTINGS)
+ * @returns maszkolt szoveg
+ */
+export declare function DyFM_maskSecrets(text: unknown, settings?: DyFM_SecretMask_Settings_Interface): string;
+/**
+ * Recursive object-masker — JSON-szeru struktura minden string-ertekeben alkalmazza
+ * a DyFM_maskSecrets-t. Pl. errors-table additionalContent / logTail tomb / cdpReport
+ * objektum elotti masking-hez.
+ */
+export declare function DyFM_maskSecretsDeep<T = unknown>(input: T, settings?: DyFM_SecretMask_Settings_Interface): T;
+export {};
 //# sourceMappingURL=secret-mask.util.d.ts.map