npm - @sdux-vault/shared - Versions diffs - 0.0.10 → 0.0.12 - Mend

@sdux-vault/shared 0.0.10 → 0.0.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/fesm2022/sdux-vault-shared.mjs +84 -47
package/fesm2022/sdux-vault-shared.mjs.map +1 -1
package/package.json +1 -1
package/types/sdux-vault-shared.d.ts +41 -41

package/fesm2022/sdux-vault-shared.mjs CHANGED Viewed

@@ -70,7 +70,7 @@ const registerVersion = (packageName, version) => {
 //	 cmd+alt+j (see .vscode/keybindings.json)
 // --- END AI MODEL FILE PATH ---
 const SDUX_PACKAGE = '@sdux-vault/shared';
-const SDUX_VERSION = '0.0.10';
+const SDUX_VERSION = '0.0.12';
 registerVersion(SDUX_PACKAGE, SDUX_VERSION);
 /**
@@ -180,7 +180,12 @@ function push(level, ...args) {
     const logLevel = getVaultLogLevel();
     if (logLevel === LogLevelTypes.Off)
         return;
-    const levels = [ConsoleTypes.Error, ConsoleTypes.Warn, ConsoleTypes.Log, ConsoleTypes.Debug];
+    const levels = [
+        ConsoleTypes.Error,
+        ConsoleTypes.Warn,
+        ConsoleTypes.Log,
+        ConsoleTypes.Debug
+    ];
     const allowed = levels.indexOf(level) <= levels.indexOf(logLevel);
     if (!allowed)
         return;
@@ -412,7 +417,9 @@ class VaultErrorServiceClass {
     constructor() {
         vaultDebug('[VaultErrorService] Initializing service and subscribing to private error stream.');
         // Mirror the private error service into this one
-        const sub = this.#privateVaultErrorService.getError().subscribe((err) => {
+        const sub = this.#privateVaultErrorService
+            .getError()
+            .subscribe((err) => {
             vaultDebug(`[VaultErrorService] Received error update from private service: ${err ? err.message : 'null'}`);
             this.#hasErrorState = !!err;
             this.#error$.next(err);
@@ -1005,8 +1012,10 @@ function validateControllerKey(key) {
 //	 cmd+alt+j (see .vscode/keybindings.json)
 // --- END AI MODEL FILE PATH ---
 function isDeferredFactory(value) {
-    // eslint-disable-next-line
-    return !!value && typeof value === 'object' && typeof value.value === 'function';
+    return (!!value &&
+        typeof value === 'object' &&
+        // eslint-disable-next-line
+        typeof value.value === 'function');
 }
 /**
@@ -1057,43 +1066,55 @@ function createVaultError(err, featureCellKey) {
     };
 }
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > isolate-value > isolate-value.util.ts
+// Updated: 2026-04-07 15:49
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
 /*
-| Category                 | Type / Example        | structuredClone behavior | deepFreeze fallback behavior             | Isolated?  | Notes                         |
-| ------------------------ | --------------------- | ------------------------ | ---------------------------------------- | ---------- | ----------------------------- |
-| **Primitives**           | number                | Returned as-is           | Returned as-is                           | ✅ Yes     | Immutable by definition       |
-|                          | string                | Returned as-is           | Returned as-is                           | ✅ Yes     | Immutable                     |
-|                          | boolean               | Returned as-is           | Returned as-is                           | ✅ Yes     | Immutable                     |
-|                          | bigint                | Returned as-is           | Returned as-is                           | ✅ Yes     | Immutable                     |
-|                          | symbol                | Returned as-is           | Returned as-is                           | ✅ Yes     | Identity preserved            |
-|                          | undefined             | Returned as-is           | Returned as-is                           | ✅ Yes     | No mutation possible          |
-|                          | null                  | Returned as-is           | Returned as-is                           | ✅ Yes     | No mutation possible          |
-| **Plain Objects**        | `{ a: 1 }`            | Deep cloned              | Same reference, deeply frozen            | ✅ Yes     | Fallback prevents mutation    |
-| **Arrays**               | `[1,2,3]`             | Deep cloned              | Same reference, frozen + elements frozen | ✅ Yes     | Structural mutation blocked   |
-| **Functions**            | `() => {}`            | ❌ Throws                | Returned as-is                           | ⚠️ Partial | Body & closures mutable       |
-| **Promises**             | `Promise.resolve()`   | ❌ Throws                | Returned as-is                           | ⚠️ Partial | Internal state mutable        |
-| **Dates**                | `new Date()`          | Cloned                   | Frozen original                          | ✅ Yes     | Time value preserved          |
-| **RegExp**               | `/abc/g`              | Cloned                   | Frozen original                          | ✅ Yes     | Pattern preserved             |
-| **Error**                | `new Error()`         | Cloned                   | Frozen original                          | ⚠️ Partial | Stack may differ              |
-| **Map**                  | `new Map()`           | Deep cloned              | Frozen object, entries mutable           | ⚠️ Partial | `.set()` still works          |
-| **Set**                  | `new Set()`           | Deep cloned              | Frozen object, entries mutable           | ⚠️ Partial | `.add()` still works          |
-| **WeakMap**              | `new WeakMap()`       | ❌ Throws                | Returned as-is                           | ❌ No      | Cannot be isolated            |
-| **WeakSet**              | `new WeakSet()`       | ❌ Throws                | Returned as-is                           | ❌ No      | Cannot be frozen              |
-| **TypedArray**           | `Uint8Array`          | Cloned                   | Frozen                                   | ✅ Yes     | Buffer copied or locked       |
-| **ArrayBuffer**          | `ArrayBuffer`         | Cloned                   | Frozen                                   | ✅ Yes     | Memory isolated               |
-| **DataView**             | `DataView`            | Cloned                   | Frozen                                   | ✅ Yes     | Backing buffer safe           |
-| **Observable (RxJS)**    | `new Observable()`    | ❌ Throws                | Frozen object                            | ⚠️ Partial | Internal emissions mutable    |
-| **Class Instance**       | `new Foo()`           | Prototype stripped       | Frozen instance                          | ⚠️ Partial | Methods lost on clone         |
-| **Object.create(null)**  | null-proto object     | Cloned                   | Frozen original                          | ✅ Yes     | Prototype preserved on clone  |
-| **Cyclic Objects**       | `{ self }`            | Cloned with cycles       | Frozen safely                            | ✅ Yes     | WeakSet prevents recursion    |
-| **Getters / Setters**    | `{ get x(){} }`       | Getter invoked           | Getter not invoked                       | ⚠️ Partial | Side effects possible         |
-| **Non-enumerable props** | `defineProperty`      | Dropped                  | Frozen but preserved                     | ⚠️ Partial | Visibility differs            |
-| **Symbol-keyed props**   | `{ [sym]: 1 }`        | Dropped                  | Frozen but ignored                       | ⚠️ Partial | Symbols skipped intentionally |
-| **DOM Nodes**            | `HTMLElement`         | ❌ Throws                | Frozen object                            | ❌ No      | Host object semantics         |
-| **Proxy (well-formed)**  | `new Proxy()`         | Cloned                   | Frozen target                            | ⚠️ Partial | Depends on handler            |
-| **Proxy (malicious)**    | fake ownKeys          | ❌ Throws                | ❌ Throws                                | ❌ No      | Engine invariant violation    |
-| **JSON-like data**       | POJO graphs           | Deep cloned              | Frozen                                   | ✅ Yes     | Ideal use case                |
-| **Modules**              | ES module namespace   | ❌ Throws                | Returned as-is                           | ❌ No      | Immutable by spec             |
-| **Intl objects**         | `Intl.DateTimeFormat` | Cloned                   | Frozen                                   | ⚠️ Partial | Internal slots opaque         |
+| Category                 | Type / Example        | structuredClone behavior  | deepFreeze fallback behavior          | Isolated?  | Notes                                          |
+| ------------------------ | --------------------- | ------------------------- | ------------------------------------- | ---------- | ---------------------------------------------- |
+| **Primitives**           | number                | Returned as-is            | Returned as-is                        | ✅ Yes     | Immutable by definition                        |
+|                          | string                | Returned as-is            | Returned as-is                        | ✅ Yes     | Immutable                                      |
+|                          | boolean               | Returned as-is            | Returned as-is                        | ✅ Yes     | Immutable                                      |
+|                          | bigint                | Returned as-is            | Returned as-is                        | ✅ Yes     | Immutable                                      |
+|                          | symbol                | Returned as-is            | Returned as-is                        | ✅ Yes     | Identity preserved                             |
+|                          | undefined             | Returned as-is            | Returned as-is                        | ✅ Yes     | No mutation possible                           |
+|                          | null                  | Returned as-is            | Returned as-is                        | ✅ Yes     | No mutation possible                           |
+| **Plain Objects**        | `{ a: 1 }`            | Deep cloned               | Deep cloned + frozen                  | ✅ Yes     | Always returns new reference                   |
+| **Arrays**               | `[1,2,3]`             | Deep cloned               | Deep cloned + frozen                  | ✅ Yes     | Structural mutation blocked                    |
+| **Functions**            | `() => {}`            | ❌ Throws                 | Returned as-is                        | ⚠️ Partial | Cannot be cloned or frozen meaningfully        |
+| **Promises**             | `Promise.resolve()`   | ❌ Throws                 | Returned as-is                        | ⚠️ Partial | Identity preserved intentionally               |
+| **Dates**                | `new Date()`          | Cloned                    | Frozen original OR cloned+frozen      | ✅ Yes     | Time value preserved                           |
+| **RegExp**               | `/abc/g`              | Cloned                    | Frozen original OR cloned+frozen      | ✅ Yes     | Pattern preserved                              |
+| **Error**                | `new Error()`         | Cloned (core fields only) | Frozen original OR cloned+frozen      | ⚠️ Partial | Custom props not guaranteed                    |
+| **Map**                  | `new Map()`           | Deep cloned               | Same reference, frozen wrapper        | ⚠️ Partial | `.set()` still works; internal slots preserved |
+| **Set**                  | `new Set()`           | Deep cloned               | Same reference, frozen wrapper        | ⚠️ Partial | `.add()` still works                           |
+| **WeakMap**              | `new WeakMap()`       | ❌ Throws                 | Returned as-is                        | ❌ No      | Cannot be cloned or frozen safely              |
+| **WeakSet**              | `new WeakSet()`       | ❌ Throws                 | Returned as-is                        | ❌ No      | Cannot be isolated                             |
+| **TypedArray**           | `Uint8Array`          | Cloned                    | Frozen                                | ✅ Yes     | Buffer copied or locked                        |
+| **ArrayBuffer**          | `ArrayBuffer`         | Cloned                    | Frozen                                | ✅ Yes     | Memory isolated                                |
+| **DataView**             | `DataView`            | Cloned                    | Frozen                                | ✅ Yes     | Backing buffer safe                            |
+| **Observable (RxJS)**    | `new Observable()`    | ❌ Throws                 | Same reference, frozen wrapper        | ⚠️ Partial | Internal emissions mutable                     |
+| **Class Instance**       | `new Foo()`           | Prototype stripped        | Frozen instance                       | ⚠️ Partial | Methods lost on clone                          |
+| **Object.create(null)**  | null-proto object     | Cloned                    | Deep cloned + frozen                  | ✅ Yes     | Prototype normalized                           |
+| **Cyclic Objects**       | `{ self }`            | Cloned with cycles        | Deep cloned + frozen (cycle-safe)     | ✅ Yes     | WeakSet prevents recursion                     |
+| **Getters / Setters**    | `{ get x(){} }`       | Getter invoked            | Getter not invoked                    | ⚠️ Partial | Side effects possible                          |
+| **Non-enumerable props** | defineProperty        | Dropped                   | Preserved if fallback clone path used | ⚠️ Partial | Visibility differs                             |
+| **Symbol-keyed props**   | `{ [sym]: 1 }`        | Dropped                   | Preserved if fallback clone path used | ⚠️ Partial | Symbols skipped by clone                       |
+| **DOM Nodes**            | `HTMLElement`         | ❌ Throws                 | Same reference, frozen wrapper        | ❌ No      | Host object semantics                          |
+| **Proxy (well-formed)**  | `new Proxy()`         | Cloned                    | Frozen target (if accessible)         | ⚠️ Partial | Depends on handler                             |
+| **Proxy (malicious)**    | fake ownKeys          | ❌ Throws                 | ❌ Throws                             | ❌ No      | Engine invariant violation                     |
+| **JSON-like data**       | POJO graphs           | Deep cloned               | Deep cloned + frozen                  | ✅ Yes     | Ideal use case                                 |
+| **Modules**              | ES module namespace   | ❌ Throws                 | Returned as-is                        | ❌ No      | Immutable by spec                              |
+| **Intl objects**         | `Intl.DateTimeFormat` | Cloned                    | Frozen                                | ⚠️ Partial | Internal slots opaque                          |
+| **Shared References**    | `{a:x, b:x}`          | Preserved in clone        | Preserved in clone                    | ✅ Yes     | Graph identity maintained                      |
+| **Sparse Arrays**        | `[ , , 3 ]`           | Preserved                 | Preserved                             | ✅ Yes     | Holes maintained                               |
+| **Symbol Values**        | `{ x: Symbol() }`     | Preserved                 | Preserved                             | ✅ Yes     | Value identity intact                          |
+| **Mixed Graphs**         | fn + object           | ❌ Partial                | Clone + preserve refs                 | ⚠️ Partial | Hybrid isolation                               |
+| **Frozen Objects**       | `Object.freeze(obj)`  | Cloned (unfrozen)         | Preserved frozen OR cloned+frozen     | ✅ Yes     | Freeze state not guaranteed                    |
+| **Boxed Primitives**     | `new Number(1)`       | Cloned                    | Frozen                                | ✅ Yes     | Unboxed behavior retained                      |
 */
 function deepFreeze(obj, seen = new WeakSet()) {
     if (obj === null || typeof obj !== 'object')
@@ -1120,12 +1141,28 @@ function deepFreeze(obj, seen = new WeakSet()) {
 const isolateValue = (value) => {
     if (value === null || typeof value !== 'object')
         return value;
+    if (Object.isFrozen(value))
+        return value;
     try {
-        // Works even if structuredClone is missing: ReferenceError is caught
+        if (value instanceof Map ||
+            value instanceof Set ||
+            value instanceof WeakMap ||
+            value instanceof WeakSet) {
+            try {
+                return structuredClone(value);
+            }
+            catch {
+                return deepFreeze(value); // ← IMPORTANT: same reference
+            }
+        }
         return structuredClone(value);
     }
     catch {
-        return deepFreeze(value);
+        const clone = Array.isArray(value)
+            ? // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                [...value]
+            : Object.assign(Object.create(Object.getPrototypeOf(value)), value);
+        return deepFreeze(clone);
     }
 };
@@ -1173,7 +1210,6 @@ const isDefined = (current) => !isUndefined(current);
  * @returns `true` for `null` or `undefined`, otherwise `false`.
  */
 const isNullish = (current) => current == null;
-// eslint-disable-next-line
 const isFunction = (value) => typeof value === 'function';
 const isObject = (value) => typeof value === 'object' && value !== null;
 const isStateInputShape = (value) => {
@@ -1185,9 +1221,10 @@ const isStateInputShape = (value) => {
 };
 function isPromise(value) {
-    return (
-    // eslint-disable-next-line
-    !!value && (typeof value === 'object' || typeof value === 'function') && typeof value.then === 'function');
+    return (!!value &&
+        (typeof value === 'object' || typeof value === 'function') &&
+        // eslint-disable-next-line
+        typeof value.then === 'function');
 }
 /**

package/fesm2022/sdux-vault-shared.mjs.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"sdux-vault-shared.mjs","sources":["../../../libs/shared/src/typings/global.ts","../../../libs/shared/src/lib/utils/dev-mode/testing-environment.util.ts","../../../libs/shared/src/lib/utils/dev-mode/dev-mode.util.ts","../../../libs/shared/src/lib/utils/version/version.register.ts","../../../libs/shared/src/lib/version/version.register.ts","../../../libs/shared/src/lib/types/behavior/behavior.type.ts","../../../libs/shared/src/lib/types/logging/console.type.ts","../../../libs/shared/src/lib/types/logging/log-level.type.ts","../../../libs/shared/src/lib/utils/logger/logger.util.ts","../../../libs/shared/src/lib/abstracts/behaviors/error/with-error-callback.abstract.ts","../../../libs/shared/src/lib/abstracts/behaviors/error/with-error-transform.abstract.ts","../../../libs/shared/src/lib/utils/safe-stringify/safe-stringify.util.ts","../../../libs/shared/src/lib/services/error/vault-private-error.service.ts","../../../libs/shared/src/lib/services/error/vault-error.service.ts","../../../libs/shared/src/lib/abstracts/controllers/active-controller.abstract.ts","../../../libs/shared/src/lib/abstracts/index.ts","../../../libs/shared/src/lib/config/index.ts","../../../libs/shared/src/lib/constants/behavior-meta.constant.ts","../../../libs/shared/src/lib/constants/controller-meta.constant.ts","../../../libs/shared/src/lib/constants/dev-tools/devtools-aggregate-key.constant.ts","../../../libs/shared/src/lib/constants/dev-tools/devtools-logging-key.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-clear-state.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-continue.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-noop.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-stop.constant.ts","../../../libs/shared/src/lib/constants/index.ts","../../../libs/shared/src/lib/contexts/index.ts","../../../libs/shared/src/lib/decorators/vault-behavior.decorator.ts","../../../libs/shared/src/lib/decorators/vault-controller.decorator.ts","../../../libs/shared/src/lib/decorators/index.ts","../../../libs/shared/src/lib/types/error/vault-error-kind.type.ts","../../../libs/shared/src/lib/types/error/vault-error-name.type.ts","../../../libs/shared/src/lib/errors/vault-error.ts","../../../libs/shared/src/lib/errors/vault-error.encryption-integrity.ts","../../../libs/shared/src/lib/types/error/vault-error-usage-kind.type.ts","../../../libs/shared/src/lib/errors/vault-error.license.ts","../../../libs/shared/src/lib/errors/vault-error.usage.ts","../../../libs/shared/src/lib/errors/vault-error.usage.promise.ts","../../../libs/shared/src/lib/errors/vault-error.usage.promise-factory-required.ts","../../../libs/shared/src/lib/errors/index.ts","../../../libs/shared/src/lib/interfaces/index.ts","../../../libs/shared/src/lib/services/index.ts","../../../libs/shared/src/lib/shapes/index.ts","../../../libs/shared/src/lib/types/controller/controller-message.type.ts","../../../libs/shared/src/lib/types/controller/controller-vote.type.ts","../../../libs/shared/src/lib/types/controller/controller.type.ts","../../../libs/shared/src/lib/types/controller/decision-outcome.type.ts","../../../libs/shared/src/lib/types/event/event-boundary.type.ts","../../../libs/shared/src/lib/types/event/event.type.ts","../../../libs/shared/src/lib/types/operation.type.ts","../../../libs/shared/src/lib/types/resolve.type.ts","../../../libs/shared/src/lib/types/state/state-emit.type.ts","../../../libs/shared/src/lib/types/index.ts","../../../libs/shared/src/lib/utils/behavior/define-behavior-key.util.ts","../../../libs/shared/src/lib/utils/controller/define-controller-key.util.ts","../../../libs/shared/src/lib/utils/deferred-factory/is-deferred-factory.util.ts","../../../libs/shared/src/lib/utils/error/create-vault-error.util.ts","../../../libs/shared/src/lib/utils/isolate-value/isolate-value.util.ts","../../../libs/shared/src/lib/utils/logic/logic.utils.ts","../../../libs/shared/src/lib/utils/promise/is-promise.util.ts","../../../libs/shared/src/lib/utils/resolve/is-http-resource.util.ts","../../../libs/shared/src/lib/utils/index.ts","../../../libs/shared/src/public-api.ts","../../../libs/shared/src/sdux-vault-shared.ts"],"sourcesContent":["// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > typings > global.d.ts\n// Updated: 2026-03-24 12:38\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { SDuXShape } from '../public-api';\n\n/*\n Extends the global Window object with optional SDuX monitoring and DevTools references.\n * This declaration defines the global attachment points used to expose runtime singletons.\n /\ndeclare global {\n interface Window {\n /\n Optional container for globally exposed SDuX runtime instances.\n /\n sdux?: SDuXShape;\n }\n\n /\n Optional global reference to SDuX runtime instances.\n /\n var sdux: SDuXShape \| undefined;\n}\n\nexport {};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > dev-mode > testing-environment.util.ts\n// Updated: 2026-03-09 14:47\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const isTestEnv = {\n get active(): boolean {\n return (\n // eslint-disable-next-line\n typeof (globalThis as any).jasmine !== 'undefined' \|\|\n // istanbul ignore next\n // eslint-disable-next-line\n typeof (globalThis as any).jest !== 'undefined' \|\|\n // istanbul ignore next\n // eslint-disable-next-line\n typeof (globalThis as any).vitest !== 'undefined'\n );\n }\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > dev-mode > dev-mode.util.ts\n// Updated: 2026-03-09 14:46\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { isTestEnv } from './testing-environment.util';\n\nlet devMode: boolean \| null = null;\n\nexport const DevMode = {\n get active(): boolean {\n return devMode === true;\n },\n\n setDevMode(isDevMode: boolean): void {\n if (devMode !== null && !isTestEnv.active) {\n throw new Error('[vault] DevMode has already been initialized.');\n }\n\n devMode = isDevMode;\n }\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > version > version.register.ts\n// Updated: 2026-03-03 07:47\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { SDuXShape } from '../../shapes/sdux/sdux.shape';\nimport { DevMode } from '../dev-mode/dev-mode.util';\n\nexport const registerVersion = (packageName: string, version: string): void => {\n if (!DevMode.active \|\| typeof globalThis === 'undefined') return;\n\n const sdux = (globalThis.sdux ??= {} as SDuXShape);\n const debug = (sdux.debugWidget ??= {});\n const versions = (debug.versions ??= {});\n\n if (versions[packageName] === version) return;\n\n versions[packageName] = version;\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > version > version.register.ts\n// Updated: 2026-03-03 08:12\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { registerVersion } from '../utils/version/version.register';\n\nconst SDUX_PACKAGE = '@sdux-vault/shared';\nconst SDUX_VERSION = '0.0.10';\n\nregisterVersion(SDUX_PACKAGE, SDUX_VERSION);\n","/\n Runtime-safe registry of all behavior types.\n \n This object acts as an enum substitute without introducing JavaScript enum\n * overhead.\n * Values are string literals preserved at runtime and suitable for\n * switch statements, comparisons, and pipeline classification.\n * Each key maps 1:1 to its string literal value.\n * The structure is fully tree-shakable and safely inferable by TypeScript.\n /\nexport const BehaviorTypes = {\n CoreAfterTap: 'coreAfterTap',\n CoreBeforeTap: 'coreBeforeTap',\n ReplayGlobalError: 'replayGlobalError',\n CoreError: 'coreError',\n CoreErrorCallback: 'coreErrorCallback',\n CoreState: 'coreState',\n DevPipelineObserver: 'devPipelineObserver',\n Encrypt: 'encrypt',\n CoreEmitState: 'coreEmitState',\n ErrorTransform: 'errorTransform',\n Extension: 'extension',\n Filter: 'filter',\n FromObservable: 'fromObservable',\n FromPromise: 'fromPromise',\n FromStream: 'fromStream',\n Interceptor: 'interceptor',\n Merge: 'merge',\n Operator: 'operator',\n Persist: 'persist',\n Reduce: 'reduce',\n Resolve: 'resolve',\n StepwiseFilter: 'stepwiseFilter',\n StepwiseReducer: 'stepwiseReducer',\n StepwiseResolve: 'stepwiseResolve'\n} as const;\n\n/\n Union of all valid behavior type strings.\n \n This type is derived from `BehaviorTypes` using literal inference, ensuring\n * strong typing while preserving full runtime compatibility.\n * This type should not be manually extended—add new values to `BehaviorTypes`\n * instead.\n \n --RelatedStart--\n * BehaviorTypes\n * --RelatedEnd--\n /\nexport type BehaviorType = (typeof BehaviorTypes)[keyof typeof BehaviorTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > logging > console.type.ts\n// Updated: 2026-03-21 21:00\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Defines the allowable verbosity levels for Vault logging.\n \n A `LogLevel` controls the amount of diagnostic output emitted by the\n * vault’s internal debug, warning, or error channels. Higher levels\n * produce more detailed logs, while lower levels suppress output.\n \n - `'off'` — no logs are emitted\n * - `'error'` — only errors are logged\n * - `'warn'` — warnings and errors are logged\n * - `'log'` — standard log events, warnings, and errors are logged\n * - `'debug'` — all debug-level information is emitted\n /\n\nexport const ConsoleTypes = {\n Error: 'error',\n Warn: 'warn',\n Log: 'log',\n Debug: 'debug'\n} as const;\n\nexport type ConsoleType = (typeof ConsoleTypes)[keyof typeof ConsoleTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > logging > log-level.type.ts\n// Updated: 2026-03-21 21:00\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Defines the allowable verbosity levels for Vault logging.\n \n A `LogLevel` controls the amount of diagnostic output emitted by the\n * vault’s internal debug, warning, or error channels. Higher levels\n * produce more detailed logs, while lower levels suppress output.\n \n - `'off'` — no logs are emitted\n * - `'error'` — only errors are logged\n * - `'warn'` — warnings and errors are logged\n * - `'log'` — standard log events, warnings, and errors are logged\n * - `'debug'` — all debug-level information is emitted\n /\n\nexport const LogLevelTypes = {\n Off: 'off',\n Error: 'error',\n Warn: 'warn',\n Log: 'log',\n Debug: 'debug'\n} as const;\n\nexport type LogLevelType = (typeof LogLevelTypes)[keyof typeof LogLevelTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > logger > logger.util.ts\n// Updated: 2026-03-23 16:50\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { ConsoleType, ConsoleTypes } from '../../types/logging/console.type';\nimport { LogLevelType, LogLevelTypes } from '../../types/logging/log-level.type';\n\nlet _logLevel: LogLevelType = LogLevelTypes.Off;\n\n/\n Prefix applied to all vault-related console output. Used to keep log\n * messages consistently identifiable across all log levels.\n /\nconst LOG_PREFIX = '[vault]';\n\n// eslint-disable-next-line\nfunction push(level: ConsoleType, ...args: any[]): void {\n const logLevel = getVaultLogLevel();\n\n if (logLevel === LogLevelTypes.Off) return;\n\n const levels: ConsoleType[] = [ConsoleTypes.Error, ConsoleTypes.Warn, ConsoleTypes.Log, ConsoleTypes.Debug];\n\n const allowed = levels.indexOf(level) <= levels.indexOf(logLevel!);\n\n if (!allowed) return;\n\n // eslint-disable-next-line\n console[level](LOG_PREFIX, ...args);\n}\n\n/\n Emits an `error`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultError = (...args: any[]) => push('error', ...args);\n\n/\n Emits a `warn`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultWarn = (...args: any[]) => push('warn', ...args);\n\n/\n Emits a `log`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultLog = (...args: any[]) => push('log', ...args);\n\n/\n Emits a `debug`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultDebug = (...args: any[]) => push('debug', ...args);\n\nexport function setVaultLogLevel(level: LogLevelType) {\n _logLevel = level ?? 'off';\n}\n\nexport function getVaultLogLevel(): LogLevelType {\n return _logLevel;\n}\n","import { BehaviorClassContext } from '../../../contexts/behavior-class.context';\nimport { ErrorCallbackBehaviorContract } from '../../../interfaces/behaviors/error-callback-behavior.interface';\nimport { StateSnapshotShape } from '../../../shapes/state/state-snapshot.shape';\nimport { VaultErrorShape } from '../../../shapes/vault-error.shape';\nimport { BehaviorTypes } from '../../../types/behavior/behavior.type';\nimport { VaultErrorCallback } from '../../../types/callback/vault-error-callback.type';\nimport { vaultWarn } from '../../../utils/logger/logger.util';\n\nexport abstract class AbstractErrorCallbackBehavior<T> implements ErrorCallbackBehaviorContract<T> {\n /* Indicates that this error behavior is critical and always executed. /\n readonly critical!: boolean;\n\n /* Unique identifier for this behavior instance. /\n readonly key: string;\n\n /* Behavior type for orchestrator registration. /\n readonly type = BehaviorTypes.CoreErrorCallback;\n\n /\n Creates a new abstract error behavior instance.\n \n @param key - Unique behavior identifier supplied by the behavior factory.\n * @param behaviorCtx - Behavior class context providing injector access and extensibility hooks.\n /\n constructor(\n key: string,\n readonly behaviorCtx: BehaviorClassContext\n ) {\n this.key = key;\n }\n\n abstract callbackError(\n current: VaultErrorShape,\n state: StateSnapshotShape<T>,\n oldschoolCallback: VaultErrorCallback<T>\n ): Promise<void>;\n\n /\n Lifecycle hook invoked when the behavior instance is destroyed.\n \n Error behaviors do not allocate runtime resources and therefore require\n * no cleanup. A diagnostic entry is logged for lifecycle visibility.\n /\n destroy(): void {\n vaultWarn(`${this.key} - destroy \"noop\"`);\n }\n\n /\n Lifecycle hook invoked when the behavior instance is reset.\n \n Error behaviors hold no internal state, making this a no-operation.\n * The hook ensures lifecycle uniformity across all behaviors.\n /\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","import { VAULT_NOOP } from '../../../constants/vault/vault-noop.constant';\nimport { BehaviorClassContext } from '../../../contexts/behavior-class.context';\nimport { ErrorTransformBehaviorContract } from '../../../interfaces/behaviors/error-transform-behavior.interface';\nimport { StateSnapshotShape } from '../../../shapes/state/state-snapshot.shape';\nimport { VaultErrorShape } from '../../../shapes/vault-error.shape';\nimport { BehaviorTypes } from '../../../types/behavior/behavior.type';\nimport { vaultWarn } from '../../../utils/logger/logger.util';\n\n/\n Abstract base behavior for transforming errors during pipeline execution.\n * This class defines the contract and lifecycle hooks required for error transformation behaviors.\n \n --RelatedStart--\n * ErrorTransformBehaviorContract\n * BehaviorClassContext\n * StateSnapshotShape\n * VaultErrorShape\n * --RelatedEnd--\n /\nexport abstract class AbstractErrorTransformBehavior<T> implements ErrorTransformBehaviorContract<T> {\n /\n Indicates that this error transform behavior is critical and always executed.\n /\n readonly critical!: boolean;\n\n /\n Unique identifier for this behavior instance.\n /\n readonly key: string;\n\n /\n Behavior type identifier used for orchestrator registration.\n /\n readonly type = BehaviorTypes.ErrorTransform;\n\n /\n Creates a new abstract error transform behavior instance.\n \n @param key Unique behavior identifier supplied by the factory.\n * @param behaviorCtx Behavior class context providing configuration and hooks.\n /\n constructor(\n key: string,\n readonly behaviorCtx: BehaviorClassContext\n ) {\n this.key = key;\n }\n\n /\n Transforms an error produced during pipeline execution.\n \n @param error Incoming error value to be transformed.\n * @param current Current normalized Vault error value.\n * @param previousStateSnapshot Snapshot of state prior to the error.\n * @returns Transformed error, original error, or VAULT_NOOP to suppress emission.\n /\n abstract transformError(\n error: unknown,\n current: VaultErrorShape,\n previousStateSnapshot: StateSnapshotShape<T>\n ): Promise<unknown \| typeof VAULT_NOOP>;\n\n /\n Lifecycle hook invoked when the behavior instance is destroyed.\n /\n destroy(): void {\n vaultWarn(`${this.key} - destroy \"noop\"`);\n }\n\n /\n Lifecycle hook invoked when the behavior instance is reset.\n /\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","/\n Safely converts an arbitrary value into a JSON string representation.\n \n This function wraps `JSON.stringify` with enhanced handling for non-serializable\n * values, including:\n * - functions\n * - `Error` objects\n * - `Map` and `Set` instances\n * - circular references\n \n If serialization fails for any reason, a fallback string `\"[unserializable]\"`\n * is returned. The replacer ensures stable and predictable stringification for\n * use in logging and debugging utilities.\n \n @param value - The value to stringify safely.\n * @returns A JSON-formatted string or a fallback indicator.\n /\nexport function safeStringify(value: unknown): string {\n try {\n return JSON.stringify(value, jsonSafeReplacer, 2);\n } catch {\n return '[unserializable]';\n }\n}\n\n/\n Replacer function used by `safeStringify` to handle values that are normally\n * not serializable via `JSON.stringify`.\n \n It converts functions, errors, `Map`, and `Set` values into safe structures\n * and detects circular references. If a value cannot be serialized, a fallback\n * marker string is returned.\n \n @param _key - The property key being processed (unused).\n * @param val - The value associated with the key.\n * @returns A serializable representation of the value.\n /\n\nfunction jsonSafeReplacer(_key: string, val: unknown) {\n if (typeof val === 'function') return '[Function]';\n if (val instanceof Error) return { message: val.message, stack: val.stack };\n if (val instanceof Map) return { map: Array.from(val.entries()) };\n if (val instanceof Set) return { set: Array.from(val.values()) };\n\n // Avoid circular references\n try {\n JSON.stringify(val);\n return val;\n } catch {\n return '[Circular]';\n }\n}\n","import { BehaviorSubject, Observable } from 'rxjs';\nimport { VaultPrivateErrorServiceContract } from '../../interfaces/vault/vault-private-error-service.interface';\nimport { VaultErrorShape } from '../../shapes/vault-error.shape';\nimport { vaultDebug } from '../../utils/logger/logger.util';\nimport { safeStringify } from '../../utils/safe-stringify/safe-stringify.util';\n\n/* ------------------------------------------\n * INTERNAL CLASS (NOT EXPORTED)\n * ------------------------------------------ /\nclass VaultPrivateErrorClass implements VaultPrivateErrorServiceContract {\n readonly #error$ = new BehaviorSubject<VaultErrorShape \| null>(null);\n\n constructor() {\n vaultDebug('[VaultPrivateErrorService] initialized (singleton instance created)');\n }\n\n setError(error: VaultErrorShape \| null): void {\n vaultDebug(`[VaultPrivateErrorService] setError() ${safeStringify(error)}`);\n this.#error$.next(error);\n }\n\n getError(): Observable<VaultErrorShape \| null> {\n vaultDebug('[VaultPrivateErrorService] getError() → observable subscribed');\n return this.#error$.asObservable();\n }\n\n clear(): void {\n vaultDebug('[VaultPrivateErrorService] clear() → error reset to null');\n this.#error$.next(null);\n }\n}\n\n/* ------------------------------------------\n * SINGLETON FACTORY (EXPORTED)\n * ------------------------------------------ /\nlet _instance: VaultPrivateErrorServiceContract \| null = null;\n\nexport function VaultPrivateErrorService(): VaultPrivateErrorServiceContract {\n if (!_instance) {\n vaultDebug('[VaultPrivateErrorService] creating new singleton instance');\n _instance = new VaultPrivateErrorClass();\n } else {\n vaultDebug('[VaultPrivateErrorService] returning existing singleton instance');\n }\n return _instance;\n}\n","import { BehaviorSubject, Subscription } from 'rxjs';\nimport { VaultErrorServiceContract } from '../../interfaces/vault/vault-error-service.interface';\nimport { VaultErrorShape } from '../../shapes/vault-error.shape';\nimport { vaultDebug } from '../../utils/logger/logger.util';\nimport { VaultPrivateErrorService } from './vault-private-error.service';\n\nclass VaultErrorServiceClass implements VaultErrorServiceContract {\n readonly #privateVaultErrorService = VaultPrivateErrorService();\n\n readonly #error$ = new BehaviorSubject<VaultErrorShape \| null>(null);\n\n #hasErrorState = false;\n\n /* Track internal subscription for cleanup /\n readonly #subscription = new Subscription();\n\n /* Public observable error stream /\n readonly error$ = this.#error$.asObservable();\n\n constructor() {\n vaultDebug('[VaultErrorService] Initializing service and subscribing to private error stream.');\n\n // Mirror the private error service into this one\n const sub = this.#privateVaultErrorService.getError().subscribe((err: VaultErrorShape \| null) => {\n vaultDebug(`[VaultErrorService] Received error update from private service: ${err ? err.message : 'null'}`);\n this.#hasErrorState = !!err;\n this.#error$.next(err);\n });\n\n this.#subscription.add(sub);\n }\n\n get hasError(): boolean {\n return this.#hasErrorState;\n }\n\n clear(): void {\n vaultDebug('[VaultErrorService] Clearing current error.');\n this.#privateVaultErrorService.clear();\n }\n}\n\n// --------------------------------\n// SINGLETON FACTORY (EXPORTED)\n// --------------------------------\n\nlet _instance: VaultErrorServiceClass \| null = null;\n\nexport function VaultErrorService(): VaultErrorServiceContract {\n if (!_instance) {\n vaultDebug('[VaultErrorService] Creating new singleton instance.');\n _instance = new VaultErrorServiceClass();\n }\n return _instance;\n}\n","import { Observable, Subscription, tap } from 'rxjs';\nimport { ControllerClassContext } from '../../contexts/controller-class.context';\nimport { ControllerContract } from '../../interfaces/controllers/controller.interface';\nimport { VaultErrorService } from '../../services/error/vault-error.service';\nimport { ControllerMessageShape } from '../../shapes/controller/controller-message.shape';\nimport { ControllerVote } from '../../types/controller/controller-vote.type';\nimport { ControllerType } from '../../types/controller/controller.type';\nimport { vaultDebug, vaultWarn } from '../../utils/logger/logger.util';\nimport { safeStringify } from '../../utils/safe-stringify/safe-stringify.util';\n\nexport abstract class AbstractActiveController<T> implements ControllerContract<T> {\n readonly key: string;\n abstract readonly type: ControllerType;\n readonly critical = false;\n\n protected hasError = false;\n protected traceId: string \| null = null;\n\n #subscription: Subscription;\n\n constructor(\n key: string,\n protected readonly ctx: ControllerClassContext\n ) {\n this.key = key;\n\n this.#subscription = VaultErrorService()\n .error$.pipe(\n tap((error) => {\n vaultDebug(`${this.key} VaultErrorService dispatched event. Raw event: ${safeStringify(error)}.`);\n const newValue = error != null;\n vaultDebug(`${this.key} New transformed error value: \"${newValue}\".`);\n\n const revoteDecision = newValue !== this.hasError && this.traceId !== undefined;\n vaultDebug(\n `${this.key} Revote Decision: ${revoteDecision}. Factors. NewValue: ${newValue} HasError: ${this.hasError} TraceId: ${this.traceId} Rubric: 'newValue !== this.hasError && this.traceId !== undefined'`\n );\n\n this.hasError = newValue;\n vaultDebug(`${this.key} this.hasError replace with newValue: \"${this.hasError}\".`);\n vaultDebug(`${this.key} onExternalTrigger dispatchd with: \"${newValue}\".`);\n this.onExternalTrigger(newValue);\n\n if (revoteDecision) {\n vaultDebug(`${this.key} Revote Requesed with traceId: \"${this.traceId}\".`);\n this.ctx.requestRevote(this.traceId!);\n }\n })\n )\n .subscribe();\n }\n\n /* Child classes override to react to external error toggles /\n //istanbul ignore next\n protected onExternalTrigger(_newErrorState: boolean): void {}\n\n /* All controllers must implement this /\n abstract handleMessage(msg: ControllerMessageShape<T>): Observable<ControllerVote \| void>;\n\n destroy(): void {\n this.#subscription.unsubscribe();\n vaultWarn(`${this.key} - destroy`);\n }\n\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > abstracts > index.ts\n// Updated: 2026-03-23 17:27\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * Abstracts\n * --------------------------------------------------------- /\nexport { AbstractErrorCallbackBehavior } from './behaviors/error/with-error-callback.abstract';\nexport { AbstractErrorTransformBehavior } from './behaviors/error/with-error-transform.abstract';\nexport { AbstractActiveController } from './controllers/active-controller.abstract';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > config > index.ts\n// Updated: 2026-03-23 16:54\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * CONFIGS\n * --------------------------------------------------------- /\nexport type { InsightConfig } from './insight.config';\nexport type { MergeConfig } from './merge.config';\nexport type { ObjectDeepMergeConfig } from './object-deep-merge.config';\nexport type { VaultConfig } from './vault.config';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > constants > behavior-meta.constant.ts\n// Updated: 2026-03-28 14:09\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const BEHAVIOR_META = Symbol.for('BEHAVIOR_META');\n","export const CONTROLLER_META = Symbol.for('CONTROLLER_META');\n","// --- AI Model File Path ---\n// libs > shared > src > lib > constants > dev-tools > devtools-aggregate-key.constant.ts\n\n/\n String token used to uniquely identify the DevTools Aggregate FeatureCell.\n \n This key is referenced by the DevTools service, monitor utilities,\n * and the router configuration to ensure all DevTools-related state\n * is consistently mapped to the same FeatureCell instance.\n \n The value is stable across versions to maintain compatibility with\n * external tools such as the Chrome DevTools extension.\n /\nexport const DEVTOOLS_AGGREGATE_KEY_CONSTANT = 'vault::devtools::aggregate:feature::cell';\n","// --- AI Model File Path ---\n// libs > shared > src > lib > constants > dev-tools > devtools-logging-key.constant.ts\n\n/\n String token used to uniquely identify the DevTools Logging FeatureCell.\n \n This key is referenced by the DevTools service, monitor utilities,\n * and the router configuration to ensure all DevTools-related state\n * is consistently mapped to the same FeatureCell instance.\n \n The value is stable across versions to maintain compatibility with\n * external tools such as the Chrome DevTools extension.\n /\nexport const DEVTOOLS_LOGGING_KEY_CONSTANT = 'vault::devtools::logging::feature::cell';\n","export const VAULT_CLEAR_STATE = Symbol.for('VAULT_CLEAR_STATE');\n","export const VAULT_CONTINUE = Symbol.for('VAULT_CONTINUE');\n","export const VAULT_NOOP = Symbol.for('VAULT_NOOP');\n","export const VAULT_STOP = Symbol.for('VAULT_STOP');\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > constants > public-api.ts\n// Updated: 2026-03-23 18:48\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * META + DECORATORS\n * --------------------------------------------------------- /\nexport { BEHAVIOR_META } from './behavior-meta.constant';\nexport { CONTROLLER_META } from './controller-meta.constant';\nexport { DEVTOOLS_AGGREGATE_KEY_CONSTANT } from './dev-tools/devtools-aggregate-key.constant';\nexport { DEVTOOLS_LOGGING_KEY_CONSTANT } from './dev-tools/devtools-logging-key.constant';\nexport { VAULT_CLEAR_STATE } from './vault/vault-clear-state.constant';\nexport { VAULT_CONTINUE } from './vault/vault-continue.constant';\nexport { VAULT_NOOP } from './vault/vault-noop.constant';\nexport { VAULT_STOP } from './vault/vault-stop.constant';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > contexts > index.ts\n// Updated: 2026-03-23 17:31\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * CONTEXTS\n * --------------------------------------------------------- /\nexport type { BehaviorClassContext } from './behavior-class.context';\nexport type { BehaviorContext } from './behavior.context';\nexport type { ControllerClassContext } from './controller-class.context';\nexport type { ControllerContext } from './controller.context';\nexport type { FeatureCellExtensionContext } from './feature-cell-extension.context';\n","// vault-behavior.decorator.ts\nimport { BEHAVIOR_META } from '../constants/behavior-meta.constant';\nimport { BehaviorMetaShape } from '../shapes/behavior-meta.shape';\n\n/\n Decorator that registers a class as an Vault behavior.\n \n The `VaultBehavior` decorator attaches the provided `BehaviorMeta`\n * definition to the target constructor, making the behavior discoverable by\n * the orchestrator during pipeline initialization. Metadata fields such as\n * `type`, `key`, and `critical` are also mirrored onto static properties of\n * the decorated class to support lightweight runtime introspection.\n \n This decorator does not modify method logic or structure; it only assigns\n * metadata required for orchestrator classification and behavior lifecycle\n * management.\n \n @param meta - Metadata describing the behavior’s category, unique key, and\n * criticality within the pipeline.\n * @returns A class decorator that applies behavior metadata to the target.\n /\nexport function VaultBehavior(meta: BehaviorMetaShape) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return function (target: any) {\n // Attach full metadata for the orchestrator\n target[BEHAVIOR_META] = meta;\n\n // Also mirror some fields onto static props for convenience\n if (meta.type !== undefined) {\n target.type = meta.type;\n }\n if (meta.key !== undefined) {\n target.key = meta.key;\n }\n if (meta.critical !== undefined) {\n target.critical = meta.critical;\n }\n\n if (meta.resolveType !== undefined) {\n target.resolveType = meta.resolveType;\n }\n\n if (meta.wantsConfig !== undefined) {\n target.wantsConfig = meta.wantsConfig;\n } else {\n target.wantsConfig = false;\n }\n\n if (meta.configKey !== undefined) {\n target.configKey = meta.configKey;\n }\n\n if (meta.needsLicense !== undefined) {\n target.needsLicense = meta.needsLicense;\n } else {\n target.needsLicense = false;\n }\n\n if (meta.licenseId !== undefined) {\n target.licenseId = meta.licenseId;\n }\n };\n}\n","// vault-behavior.decorator.ts\nimport { CONTROLLER_META } from '../constants/controller-meta.constant';\nimport { ControllerMetaShape } from '../shapes/controller/controller-meta.shape';\n\nexport function VaultController(meta: ControllerMetaShape) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return function (target: any) {\n // Attach full metadata for the orchestrator\n target[CONTROLLER_META] = meta;\n\n // Also mirror some fields onto static props for convenience\n if (meta.type !== undefined) {\n target.type = meta.type;\n }\n if (meta.key !== undefined) {\n target.key = meta.key;\n }\n if (meta.critical !== undefined) {\n target.critical = meta.critical;\n }\n if (meta.wantsConfig !== undefined) {\n target.wantsConfig = meta.wantsConfig;\n } else {\n target.wantsConfig = false;\n }\n\n if (meta.configKey !== undefined) {\n target.configKey = meta.configKey;\n }\n\n if (meta.needsLicense !== undefined) {\n target.needsLicense = meta.needsLicense;\n } else {\n target.needsLicense = false;\n }\n\n if (meta.licenseId !== undefined) {\n target.licenseId = meta.licenseId;\n }\n };\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > decorators > index.ts\n// Updated: 2026-03-23 18:29\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * META + DECORATORS\n * --------------------------------------------------------- /\nexport { VaultBehavior } from './vault-behavior.decorator';\nexport { VaultController } from './vault-controller.decorator';\n","import { VaultErrorUsageKindTypes } from './vault-error-usage-kind.type';\n\nexport const VaultErrorKindTypes = {\n Usage: 'VaultErrorUsage',\n VaultError: 'VaultError'\n} as const;\n\nexport type VaultErrorKindType =\n \| (typeof VaultErrorKindTypes)[keyof typeof VaultErrorKindTypes]\n \| (typeof VaultErrorUsageKindTypes)[keyof typeof VaultErrorUsageKindTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > error > vault-error-name.type.ts\n// Updated: 2026-03-12 11:57\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const VaultErrorNameTypes = {\n EncryptionIntegrity: 'VaultErrorEncryptionIntegrity',\n License: 'VaultErrorLicense',\n Usage: 'VaultErrorUsage',\n VaultError: 'VaultError'\n} as const;\n\nexport type VaultErrorNameType = (typeof VaultErrorNameTypes)[keyof typeof VaultErrorNameTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.ts\n// Updated: 2026-03-12 12:08\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorKindType, VaultErrorKindTypes } from '../types/error/vault-error-kind.type';\nimport { VaultErrorNameType, VaultErrorNameTypes } from '../types/error/vault-error-name.type';\n\nexport class VaultError extends Error {\n readonly kind: VaultErrorKindType;\n\n constructor(\n message: string,\n name: VaultErrorNameType = VaultErrorNameTypes.VaultError,\n kind: VaultErrorKindType = VaultErrorKindTypes.VaultError\n ) {\n super(message);\n\n this.name = name;\n this.kind = kind;\n\n // Required for proper instanceof checks in TS / ES5 targets\n Object.setPrototypeOf(this, new.target.prototype);\n\n // Optional but nice: clean stack trace\n // eslint-disable-next-line\n const anyError = Error as any;\n if (typeof anyError.captureStackTrace === 'function') {\n anyError.captureStackTrace(this, new.target);\n }\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.encryption.integrity.ts\n// Updated: 2026-03-12\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport { VaultError } from './vault-error';\n\n/\n Thrown when encrypted payload integrity verification fails.\n \n This occurs when AES-GCM authentication fails during decryption.\n * Causes may include:\n \n - Tampered ciphertext\n * - Modified IV\n * - Incorrect encryption key\n * - Corrupted storage payload\n \n AES-GCM provides authenticated encryption, so any modification to the\n * encrypted envelope will cause the WebCrypto decrypt operation to throw.\n /\nexport class VaultEncryptionIntegrityError extends VaultError {\n constructor() {\n const message = `Encrypted snapshot failed integrity verification.\n\nThe encrypted payload could not be authenticated during AES-GCM decryption.\n\nPossible causes:\n\n• The stored ciphertext has been tampered with\n• The stored initialization vector (IV) was modified\n• The encryption key does not match the original key\n• The stored payload is corrupted\n\nVault refuses to restore state from unauthenticated encrypted data.`;\n\n super(message, VaultErrorNameTypes.EncryptionIntegrity);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > error > vault-error-usage-kind.type.ts\n// Updated: 2026-03-12 11:57\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const VaultErrorUsageKindTypes = {\n Encryption: 'VaultErrorEncryption',\n License: 'VaultErrorLicense',\n Promise: 'VaultErrorUsagePromise',\n PromiseFactoryRequired: 'VaultErrorUsagePromiseFactoryRequired',\n Usage: 'VaultErrorUsage'\n} as const;\n\nexport type VaultErrorUsageKindType = (typeof VaultErrorUsageKindTypes)[keyof typeof VaultErrorUsageKindTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.license.ts\n// Updated: 2026-03-12 11:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport { VaultErrorUsageKindType, VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultError } from './vault-error';\n\nexport class VaultLicenseError extends VaultError {\n constructor(message: string, kind: VaultErrorUsageKindType = VaultErrorUsageKindTypes.License) {\n super(message, VaultErrorNameTypes.License, kind);\n }\n}\n","import { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport { VaultErrorUsageKindType, VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultError } from './vault-error';\n\nexport class VaultUsageError extends VaultError {\n constructor(message: string, kind: VaultErrorUsageKindType = VaultErrorUsageKindTypes.Usage) {\n super(message, VaultErrorNameTypes.Usage, kind);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.usage.promise.ts\n// Updated: 2026-03-12 12:01\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultUsageError } from './vault-error.usage';\n\nexport class VaultUsagePromiseError extends VaultUsageError {\n constructor() {\n const message = `Invalid incoming value: Promise detected.\n\nPromises are eager and may resolve or reject before entering the Vault pipeline.\n\nUse the following instead a DeferredFactory value\n\nThis guarantees the promise is created and executed inside the pipeline.`;\n\n super(message, VaultErrorUsageKindTypes.Promise);\n }\n}\n","import { VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultUsageError } from './vault-error.usage';\n\nexport class VaultUsagePromiseFactoryRequiredError extends VaultUsageError {\n constructor() {\n const message = `Invalid usage of Promise-based state API.\n\nYou called a Promise-specific method (replaceState / mergeState),\nbut did not provide a function that creates a Promise.\n\nExpected:\n• () => Promise<T>\n\nReceived:\n• A non-function value\n\nPromises are eager and may resolve or reject before entering the Vault pipeline.\n\nAlways wrap promises in a function so they are created and executed\ninside the pipeline.`;\n\n super(message, VaultErrorUsageKindTypes.PromiseFactoryRequired);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > index.ts\n// Updated: 2026-03-23 17:21\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * ERRORS\n * --------------------------------------------------------- /\nexport { VaultError } from './vault-error';\nexport { VaultEncryptionIntegrityError } from './vault-error.encryption-integrity';\nexport { VaultLicenseError } from './vault-error.license';\nexport { VaultUsageError } from './vault-error.usage';\nexport { VaultUsagePromiseError } from './vault-error.usage.promise';\nexport { VaultUsagePromiseFactoryRequiredError } from './vault-error.usage.promise-factory-required';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > interfaces > index.ts\n// Updated: 2026-03-23 18:45\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * BEHAVIOR INTERFACES\n * --------------------------------------------------------- /\nexport type { BehaviorClassContract } from './behaviors/behavior/behavior-class.interface';\nexport type { BehaviorContract, BehaviorExtension, BehaviorExtFunction } from './behaviors/behavior/behavior.interface';\nexport type { CoreEmitStateBehaviorContract } from './behaviors/core-emit-state-behavior.interface';\nexport type { DevPipelineObserverBehaviorContract } from './behaviors/dev/dev-pipeline-observer-behavior.interface';\nexport type { EncryptBehaviorContract } from './behaviors/encrypt-behavior.interface';\nexport type { ErrorCallbackBehaviorContract } from './behaviors/error-callback-behavior.interface';\nexport type { ErrorTransformBehaviorContract } from './behaviors/error-transform-behavior.interface';\nexport type { FeatureCellExtension } from './behaviors/feature-cell-extension.interface';\nexport type { FeatureCellFluentApi } from './behaviors/feature-cell-fluent-api.interface';\nexport type { FilterBehaviorContract } from './behaviors/filter-behavior.interface';\nexport type { InterceptorBehaviorClassContract } from './behaviors/interceptor/interceptor-behavior-class.interface';\nexport type { InterceptorBehaviorContract } from './behaviors/interceptor/interceptor-behavior.interface';\nexport type { MergeBehaviorContract } from './behaviors/merge-behavior.interface';\nexport type { OperatorsBehaviorClassContract } from './behaviors/operator/operator-behavior-class.interface';\nexport type { OperatorBehaviorContract } from './behaviors/operator/operator-behavior.interface';\nexport type { PersistBehaviorContract } from './behaviors/persist-behavior.interface';\nexport type { ReduceBehaviorContract } from './behaviors/reduce-behavior.interface';\nexport type { ResolveBehaviorContract } from './behaviors/resolve-behavior.interface';\nexport type { StepwiseBehaviorContract } from './behaviors/stepwise-behavior.interface';\nexport type { AfterTapBehaviorContract } from './behaviors/tap/after-tap-behavior.interface';\nexport type { BeforeTapBehaviorContract } from './behaviors/tap/before-tap-behavior.interface';\nexport type { CellBuilderContract } from './cell-builder.interface';\nexport type { ControllerClassContract } from './controllers/controller-class.interface';\nexport type { ControllerContract } from './controllers/controller.interface';\nexport type { EventBusContract } from './event/event-bus.interface';\nexport type { VaultErrorServiceContract } from './vault/vault-error-service.interface';\nexport type { VaultMonitorContract } from './vault/vault-monitor.interface';\nexport type { VaultPrivateErrorServiceContract } from './vault/vault-private-error-service.interface';\n","/ -----------------------------------------------------------\n * SERVICES\n * --------------------------------------------------------- /\nexport { VaultErrorService } from './error/vault-error.service';\nexport { VaultPrivateErrorService } from './error/vault-private-error.service';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > shapes > index.ts\n// Updated: 2026-03-23 18:42\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * Shapes\n * --------------------------------------------------------- /\nexport type { BehaviorMetaShape } from './behavior-meta.shape';\nexport type { ControllerAttemptMessageShape } from './controller/controller-attempt-message.shape';\nexport type { ControllerDecisionShape } from './controller/controller-decision.shape';\nexport type { ControllerFailMessageShape } from './controller/controller-fail-message.shape';\nexport type { ControllerFinalizeMessageShape } from './controller/controller-finalize-message.shape';\nexport type { ControllerMessageShape } from './controller/controller-message.shape';\nexport type { ControllerMetaShape } from './controller/controller-meta.shape';\nexport type { ControllerSuccessMessageShape } from './controller/controller-success-message.shape';\nexport type { EventShape } from './event/event.shape';\nexport type { FeatureCellBaseShape } from './feature-cell/feature-cell.base.shape';\nexport type { HttpResourceRefShape } from './http-resource-ref-shape.shape';\nexport type { SDuXShape } from './sdux/sdux.shape';\nexport type { StateEmitSnapshotShape } from './state/state-emit-snapshot.shape';\nexport type { StateInputShape } from './state/state-input.shape';\nexport type { StateSnapshotShape } from './state/state-snapshot.shape';\nexport type { VaultErrorShape } from './vault-error.shape';\nexport type { VaultLicensingShape } from './vault/vault-licensing.shape';\nexport type { VaultRegistrationEntityShape } from './vault/vault-registration.entity.shape';\nexport type { VaultRegistrationFluentApiShape } from './vault/vault-registration.fluent-api.shape';\nexport type { VaultRegistrationShape } from './vault/vault-registration.shape';\n","export const ControllerMessageTypes = {\n Attempt: 'attempt',\n Failure: 'failure',\n Finalize: 'Finalize Pipeline',\n Success: 'success',\n Vote: 'vote' // mostly internal\n} as const;\n\nexport type ControllerMessageType = (typeof ControllerMessageTypes)[keyof typeof ControllerMessageTypes];\n","export const ControllerVotes = {\n Abstain: 'abstain',\n Abort: 'abort',\n Deny: 'deny'\n} as const;\n\nexport type ControllerVote = (typeof ControllerVotes)[keyof typeof ControllerVotes];\n","export const ControllerTypes = {\n CoreAbstain: 'coreAbstain',\n Error: 'error',\n License: 'license',\n Policy: 'policy',\n ReplayGlobalError: 'replayGlobalError',\n Stepwise: 'stepwise'\n} as const;\n\nexport type ControllerType = (typeof ControllerTypes)[keyof typeof ControllerTypes];\n","export const DecisionOutcomeTypes = {\n Abort: 'abort',\n Abstain: 'abstain',\n Deny: 'deny'\n} as const;\n\nexport type DecisionOutcomeType = (typeof DecisionOutcomeTypes)[keyof typeof DecisionOutcomeTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > event > event-boundary.type.ts\n// Updated: 2026-03-10 09:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const EventBoundaryTypes = {\n End: 'end',\n Notification: 'notification',\n Start: 'start',\n Unknown: 'unknown'\n} as const;\n\nexport type EventBoundaryType = (typeof EventBoundaryTypes)[keyof typeof EventBoundaryTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > event > event.type.ts\n// Updated: 2026-03-10 09:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const EventTypes = {\n Conductor: 'conductor',\n Controller: 'controller',\n Lifecycle: 'lifecycle',\n Stage: 'stage',\n Unknown: 'unknown'\n} as const;\n\nexport type EventType = (typeof EventTypes)[keyof typeof EventTypes];\n","export const OperationTypes = {\n Merge: 'merge',\n Replace: 'replace',\n Initialize: 'initialize'\n} as const;\n\nexport type OperationType = (typeof OperationTypes)[keyof typeof OperationTypes];\n","/\n Enumerates the available resolve strategy identifiers used by resolve\n * behaviors. These identifiers indicate how a FeatureCell obtains its initial\n * and subsequent state values during the resolve stage of the pipeline.\n \n - `Value` — Resolve from a synchronous, in-memory value.\n * - `HttpResource` — Resolve using an HTTP-driven resource behavior.\n * - `Observable` — Resolve from an observable stream source.\n * - `Promise` — Resolve from a promise source.\n /\nexport const ResolveTypes = {\n HttpResource: 'http-resource',\n Observable: 'observable',\n Promise: 'promise',\n Value: 'value'\n} as const;\n\n/\n Union type representing all supported resolve strategy identifiers.\n /\nexport type ResolveType = (typeof ResolveTypes)[keyof typeof ResolveTypes];\n","export const StateEmitTypes = {\n IncomingPipeline: 'Incoming Pipeline',\n FinalizePipeline: 'Finalize Pipeline',\n PipelineError: 'Pipeline Error',\n PipelineDestroy: 'Pipeline Destroy',\n PipelineReset: 'Pipeline Reset',\n AbortController: 'Abort Controller',\n DenyController: 'Deny Controller'\n} as const;\n\nexport type StateEmitType = (typeof StateEmitTypes)[keyof typeof StateEmitTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > index.ts\n// Updated: 2026-03-23 18:51\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * TYPES (USER-FACING)\n * --------------------------------------------------------- /\nexport { BehaviorTypes } from './behavior/behavior.type';\nexport type { BehaviorType } from './behavior/behavior.type';\nexport type { DistinctComparison } from './behavior/distinct-comparison.type';\nexport type { CoreEmitStateCallback } from './callback/core-emit-state-callback.type';\nexport type { TapCallback } from './callback/tap-callback.type';\nexport type { VaultErrorCallback } from './callback/vault-error-callback.type';\nexport { ControllerMessageTypes } from './controller/controller-message.type';\nexport type { ControllerMessageType } from './controller/controller-message.type';\nexport { ControllerVotes } from './controller/controller-vote.type';\nexport type { ControllerVote } from './controller/controller-vote.type';\nexport { ControllerTypes } from './controller/controller.type';\nexport type { ControllerType } from './controller/controller.type';\nexport { DecisionOutcomeTypes } from './controller/decision-outcome.type';\nexport type { DecisionOutcomeType } from './controller/decision-outcome.type';\nexport { VaultErrorKindTypes } from './error/vault-error-kind.type';\nexport type { VaultErrorKindType } from './error/vault-error-kind.type';\nexport { VaultErrorNameTypes } from './error/vault-error-name.type';\nexport type { VaultErrorNameType } from './error/vault-error-name.type';\nexport { VaultErrorUsageKindTypes } from './error/vault-error-usage-kind.type';\nexport type { VaultErrorUsageKindType } from './error/vault-error-usage-kind.type';\nexport { EventBoundaryTypes } from './event/event-boundary.type';\nexport type { EventBoundaryType } from './event/event-boundary.type';\nexport { EventTypes } from './event/event.type';\nexport type { EventType } from './event/event.type';\nexport type { FilterFunction } from './function/filter-function.type';\nexport type { ReducerFunction } from './function/reducer-function.type';\nexport type { InterceptorStateType } from './interceptor-state.type';\nexport { LogLevelTypes } from './logging/log-level.type';\nexport type { LogLevelType } from './logging/log-level.type';\nexport { OperationTypes } from './operation.type';\nexport type { OperationType } from './operation.type';\nexport type { PipelinePersistValue } from './pipeline/pipeline-persist-value.type';\nexport type { PipelineUpstreamValue } from './pipeline/pipeline-upstream-value.type';\nexport type { PipelineValue } from './pipeline/pipeline-value.type';\nexport { ResolveTypes } from './resolve.type';\nexport type { ResolveType } from './resolve.type';\nexport type { CoreEmitStateResult } from './state/core-emit-state-result.type';\nexport type { DeferredFactory } from './state/deferred-factory.type';\nexport type { DeferredType } from './state/deferred.type';\nexport type { FinalState } from './state/final-state.type';\nexport { StateEmitTypes } from './state/state-emit.type';\nexport type { StateEmitType } from './state/state-emit.type';\nexport type { StateInputType } from './state/state-input.type';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > behavior > define-behavior-key.util.ts\n// Updated: 2026-03-28 10:46\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Creates a normalized behavior key identifier used for behavior registration.\n \n A behavior key uniquely identifies a behavior within the Vault pipeline,\n * following the canonical format:\n \n `SDUX::<Domain>::<Name>`\n \n Both `domain` and `name` are normalized by:\n * - capitalizing the first character\n * - removing all non-alphanumeric characters\n \n This ensures consistent and predictable behavior keys for orchestration,\n * diagnostics, and tooling.\n \n @param domain - The logical domain or category of the behavior.\n * @param name - The specific behavior name within the domain.\n * @returns A normalized behavior key string.\n /\nexport function defineBehaviorKey(domain: string, name: string): string {\n return defineVaultKey('Behavior', domain, name);\n}\n\nexport function defineVaultKey(kind: 'Behavior' \| 'Controller', domain: string, name: string): string {\n const normalize = (s: string) => s.charAt(0).toUpperCase() + s.slice(1).replace(/[^A-Za-z0-9]/g, '');\n\n return `SDUX::${kind}::${normalize(domain)}::${normalize(name)}`;\n}\n\n/\n Validates whether a string conforms to the Vault behavior key format.\n \n A valid behavior key must follow the structure:\n \n `SDUX::<Domain>::<Name>`\n \n Where `<Domain>` and `<Name>` begin with an uppercase character and contain\n * only alphanumeric characters.\n \n @param key - The behavior key string to validate.\n * @returns `true` if the key matches the required pattern; otherwise `false`.\n /\nexport function validateBehaviorKey(key: string): boolean {\n if (typeof key !== 'string') return false;\n\n const pattern = /^SDUX::(Behavior\|Controller)::[A-Z][A-Za-z0-9]::[A-Z][A-Za-z0-9]$/;\n return pattern.test(key);\n}\n","import { defineVaultKey, validateBehaviorKey } from '../behavior/define-behavior-key.util';\n\nexport function defineControllerKey(domain: string, name: string): string {\n return defineVaultKey('Controller', domain, name);\n}\n\nexport function validateControllerKey(key: string): boolean {\n return validateBehaviorKey(key);\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > deferred-factory > is-deferred-factory.util.ts\n// Updated: 2026-03-21 20:36\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { DeferredFactory } from '../../types/state/deferred-factory.type';\n\nexport function isDeferredFactory<T = unknown>(value: unknown): value is DeferredFactory<T> {\n // eslint-disable-next-line\n return !!value && typeof value === 'object' && typeof (value as any).value === 'function';\n}\n","import { VaultErrorShape } from '../../shapes/vault-error.shape';\n\n/\n Normalizes any thrown error into a canonical `VaultError` structure.\n \n This ensures that all errors—HTTP, runtime, string, or unknown—\n * are represented consistently throughout the Vault error pipeline.\n \n @param err - The raw thrown value.\n * @param featureCellKey - the origination of the error\n * @returns A fully normalized `VaultError`.\n /\nexport function createVaultError(err: unknown, featureCellKey: string): VaultErrorShape {\n const timestamp = Date.now();\n\n // -----------------------------------------\n // Standard JS Error\n // -----------------------------------------\n if (err instanceof Error) {\n return {\n message: err.message \|\| 'Unexpected error',\n details: err.stack,\n raw: err,\n timestamp,\n featureCellKey\n };\n }\n\n // -----------------------------------------\n // String error\n // -----------------------------------------\n if (typeof err === 'string') {\n return {\n message: err,\n details: err,\n raw: err,\n timestamp,\n featureCellKey\n };\n }\n\n // -----------------------------------------\n // Fallback: unknown error\n // -----------------------------------------\n return {\n message: 'Unexpected error',\n details: err,\n raw: err,\n timestamp,\n featureCellKey\n };\n}\n","/\n\| Category \| Type / Example \| structuredClone behavior \| deepFreeze fallback behavior \| Isolated? \| Notes \|\n\| ------------------------ \| --------------------- \| ------------------------ \| ---------------------------------------- \| ---------- \| ----------------------------- \|\n\| Primitives \| number \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable by definition \|\n\| \| string \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| boolean \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| bigint \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| symbol \| Returned as-is \| Returned as-is \| ✅ Yes \| Identity preserved \|\n\| \| undefined \| Returned as-is \| Returned as-is \| ✅ Yes \| No mutation possible \|\n\| \| null \| Returned as-is \| Returned as-is \| ✅ Yes \| No mutation possible \|\n\| Plain Objects \| `{ a: 1 }` \| Deep cloned \| Same reference, deeply frozen \| ✅ Yes \| Fallback prevents mutation \|\n\| Arrays \| `[1,2,3]` \| Deep cloned \| Same reference, frozen + elements frozen \| ✅ Yes \| Structural mutation blocked \|\n\| Functions \| `() => {}` \| ❌ Throws \| Returned as-is \| ⚠️ Partial \| Body & closures mutable \|\n\| Promises \| `Promise.resolve()` \| ❌ Throws \| Returned as-is \| ⚠️ Partial \| Internal state mutable \|\n\| Dates \| `new Date()` \| Cloned \| Frozen original \| ✅ Yes \| Time value preserved \|\n\| RegExp \| `/abc/g` \| Cloned \| Frozen original \| ✅ Yes \| Pattern preserved \|\n\| Error \| `new Error()` \| Cloned \| Frozen original \| ⚠️ Partial \| Stack may differ \|\n\| Map \| `new Map()` \| Deep cloned \| Frozen object, entries mutable \| ⚠️ Partial \| `.set()` still works \|\n\| Set \| `new Set()` \| Deep cloned \| Frozen object, entries mutable \| ⚠️ Partial \| `.add()` still works \|\n\| WeakMap \| `new WeakMap()` \| ❌ Throws \| Returned as-is \| ❌ No \| Cannot be isolated \|\n\| WeakSet \| `new WeakSet()` \| ❌ Throws \| Returned as-is \| ❌ No \| Cannot be frozen \|\n\| TypedArray \| `Uint8Array` \| Cloned \| Frozen \| ✅ Yes \| Buffer copied or locked \|\n\| ArrayBuffer \| `ArrayBuffer` \| Cloned \| Frozen \| ✅ Yes \| Memory isolated \|\n\| DataView \| `DataView` \| Cloned \| Frozen \| ✅ Yes \| Backing buffer safe \|\n\| Observable (RxJS) \| `new Observable()` \| ❌ Throws \| Frozen object \| ⚠️ Partial \| Internal emissions mutable \|\n\| Class Instance \| `new Foo()` \| Prototype stripped \| Frozen instance \| ⚠️ Partial \| Methods lost on clone \|\n\| Object.create(null) \| null-proto object \| Cloned \| Frozen original \| ✅ Yes \| Prototype preserved on clone \|\n\| Cyclic Objects \| `{ self }` \| Cloned with cycles \| Frozen safely \| ✅ Yes \| WeakSet prevents recursion \|\n\| Getters / Setters \| `{ get x(){} }` \| Getter invoked \| Getter not invoked \| ⚠️ Partial \| Side effects possible \|\n\| Non-enumerable props \| `defineProperty` \| Dropped \| Frozen but preserved \| ⚠️ Partial \| Visibility differs \|\n\| Symbol-keyed props \| `{ [sym]: 1 }` \| Dropped \| Frozen but ignored \| ⚠️ Partial \| Symbols skipped intentionally \|\n\| DOM Nodes \| `HTMLElement` \| ❌ Throws \| Frozen object \| ❌ No \| Host object semantics \|\n\| Proxy (well-formed) \| `new Proxy()` \| Cloned \| Frozen target \| ⚠️ Partial \| Depends on handler \|\n\| Proxy (malicious) \| fake ownKeys \| ❌ Throws \| ❌ Throws \| ❌ No \| Engine invariant violation \|\n\| JSON-like data \| POJO graphs \| Deep cloned \| Frozen \| ✅ Yes \| Ideal use case \|\n\| Modules \| ES module namespace \| ❌ Throws \| Returned as-is \| ❌ No \| Immutable by spec \|\n\| Intl objects \| `Intl.DateTimeFormat` \| Cloned \| Frozen \| ⚠️ Partial \| Internal slots opaque \|\n/\n\nfunction deepFreeze<T>(obj: T, seen = new WeakSet<object>()): T {\n if (obj === null \|\| typeof obj !== 'object') return obj;\n\n const o = obj as unknown as object;\n if (seen.has(o)) return obj;\n seen.add(o);\n\n if (!Object.isFrozen(o)) Object.freeze(o);\n\n for (const key of Reflect.ownKeys(o)) {\n const desc = Object.getOwnPropertyDescriptor(o, key);\n / istanbul ignore next -- impossible after Object.freeze due to Proxy invariants /\n if (!desc) continue;\n\n // Only recurse into data properties; do NOT invoke getters\n if ('value' in desc) {\n // eslint-disable-next-line\n deepFreeze((desc as PropertyDescriptor).value as any, seen);\n }\n }\n\n return obj;\n}\n\nexport const isolateValue = <T>(value: T): T => {\n if (value === null \|\| typeof value !== 'object') return value;\n\n try {\n // Works even if structuredClone is missing: ReferenceError is caught\n return structuredClone(value);\n } catch {\n return deepFreeze(value);\n }\n};\n","import { VAULT_CLEAR_STATE } from '../../constants/vault/vault-clear-state.constant';\nimport { VAULT_CONTINUE } from '../../constants/vault/vault-continue.constant';\nimport { VAULT_NOOP } from '../../constants/vault/vault-noop.constant';\nimport { StateInputShape } from '../../shapes/state/state-input.shape';\nimport { FinalState } from '../../types/state/final-state.type';\n\n/\n Indicates whether a final pipeline value represents a NOOP condition.\n \n @param current - The computed pipeline result.\n * @returns `true` if the value is the `VAULT_NOOP` sentinel.\n /\nexport const isVaultNoop = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_NOOP;\n};\n\nexport const isVaultClearState = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_CLEAR_STATE;\n};\n\nexport const isVaultContinue = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_CONTINUE;\n};\n\n/\n Checks whether a value is exactly `null`.\n \n @param current - The value to check.\n * @returns `true` if the value is `null`.\n /\nexport const isNull = (current: unknown): current is null => current === null;\n\n/\n Checks whether a value is exactly `undefined`.\n \n @param current - The value to check.\n * @returns `true` if the value is `undefined`.\n /\nexport const isUndefined = (current: unknown): current is undefined => current === undefined;\n\n/\n Determines whether a value is defined (not `undefined`).\n * Note: This intentionally does not exclude `null`.\n \n @param current - The value to check.\n * @returns `true` if the value is not `undefined`.\n /\nexport const isDefined = (current: unknown): boolean => !isUndefined(current);\n\n/\n Determines whether a value is nullish — meaning either `null` or `undefined`.\n \n @param current - The value to inspect.\n * @returns `true` for `null` or `undefined`, otherwise `false`.\n /\nexport const isNullish = (current: unknown): current is null \| undefined => current == null;\n\n// eslint-disable-next-line\nexport const isFunction = (value: unknown): value is (...args: any[]) => unknown => typeof value === 'function';\n\nexport const isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null;\n\nexport const isStateInputShape = <T>(value: unknown): value is StateInputShape<T> => {\n if (value === null \|\| typeof value !== 'object') return false;\n\n const v = value as Record<string, unknown>;\n\n const hasKnownKey = 'loading' in v \|\| 'value' in v \|\| 'error' in v;\n\n return hasKnownKey;\n};\n","export function isPromise<T = unknown>(value: unknown): value is Promise<T> {\n return (\n // eslint-disable-next-line\n !!value && (typeof value === 'object' \|\| typeof value === 'function') && typeof (value as any).then === 'function'\n );\n}\n","import { HttpResourceRefShape } from '../../shapes/http-resource-ref-shape.shape';\n\n/\n Type guard that determines whether a value is an `HttpResourceRef<T>`.\n \n An `HttpResourceRef` is a structured object produced by Angular’s\n * `HttpClient` resource APIs. It contains a standardized shape used by\n * Vault to detect and normalize resource-backed state transitions.\n \n This utility checks only for the presence of the canonical\n * `HttpResourceRef` fields (`value`, `isLoading`, `error`, `hasValue`)\n * and does not validate the internal content of those properties.\n \n @typeParam T - The resource value type.\n \n @param obj - The value to test.\n * @returns `true` if the value matches the structural shape of an\n * `HttpResourceRef<T>`, otherwise `false`.\n /\n// eslint-disable-next-line\nexport function isHttpResourceRef<T>(obj: any): obj is HttpResourceRefShape<T> {\n return !!(\n obj &&\n typeof obj === 'object' &&\n 'value' in obj &&\n 'isLoading' in obj &&\n 'error' in obj &&\n 'hasValue' in obj\n );\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > index.ts\n// Updated: 2026-03-24 09:59\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * UTILITY FUNCTIONS (SAFE TO WILDCARD)\n * --------------------------------------------------------- /\nexport { defineBehaviorKey, validateBehaviorKey } from './behavior/define-behavior-key.util';\nexport { defineControllerKey, validateControllerKey } from './controller/define-controller-key.util';\nexport { isDeferredFactory } from './deferred-factory/is-deferred-factory.util';\nexport { DevMode } from './dev-mode/dev-mode.util';\nexport { isTestEnv } from './dev-mode/testing-environment.util';\nexport { createVaultError } from './error/create-vault-error.util';\nexport { isolateValue } from './isolate-value/isolate-value.util';\nexport { getVaultLogLevel, setVaultLogLevel, vaultDebug, vaultError, vaultLog, vaultWarn } from './logger/logger.util';\nexport {\n isDefined,\n isFunction,\n isNull,\n isNullish,\n isObject,\n isStateInputShape,\n isUndefined,\n isVaultClearState,\n isVaultContinue,\n isVaultNoop\n} from './logic/logic.utils';\nexport { isPromise } from './promise/is-promise.util';\nexport { isHttpResourceRef } from './resolve/is-http-resource.util';\nexport { safeStringify } from './safe-stringify/safe-stringify.util';\nexport { registerVersion } from './version/version.register';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > public-api.ts\n// Updated: 2026-03-23 16:55\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n * Public API Surface of @sdux-vault/shared\n \n IMPORTANT:\n * - JSDoc is preserved only when using named exports.\n * - Avoid `export ` for public-facing interfaces, behaviors, and types.\n - Internal utilities may still use `export `.\n /\n\n/* -----------------------------------------------------------\n * INTENTIONAL SIDE EFFECTS\n * --------------------------------------------------------- /\n\n/\n This is to handle fluent api requirements for behaviors and controllers\n /\nimport './typings/global';\n\n/\n This is for version support in dev mode and tracking in the devtools\n /\nimport './lib/version/version.register';\n\n/ -----------------------------------------------------------\n * DOMAIN EXPORTS\n * --------------------------------------------------------- /\nexport from './lib/abstracts';\nexport * from './lib/config';\nexport * from './lib/constants';\nexport * from './lib/contexts';\nexport * from './lib/decorators';\nexport * from './lib/errors';\nexport * from './lib/interfaces';\nexport * from './lib/services';\nexport * from './lib/shapes';\nexport * from './lib/types';\nexport * from './lib/utils';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":["_instance"],"mappings":"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"}
1	+ {"version":3,"file":"sdux-vault-shared.mjs","sources":["../../../libs/shared/src/typings/global.ts","../../../libs/shared/src/lib/utils/dev-mode/testing-environment.util.ts","../../../libs/shared/src/lib/utils/dev-mode/dev-mode.util.ts","../../../libs/shared/src/lib/utils/version/version.register.ts","../../../libs/shared/src/lib/version/version.register.ts","../../../libs/shared/src/lib/types/behavior/behavior.type.ts","../../../libs/shared/src/lib/types/logging/console.type.ts","../../../libs/shared/src/lib/types/logging/log-level.type.ts","../../../libs/shared/src/lib/utils/logger/logger.util.ts","../../../libs/shared/src/lib/abstracts/behaviors/error/with-error-callback.abstract.ts","../../../libs/shared/src/lib/abstracts/behaviors/error/with-error-transform.abstract.ts","../../../libs/shared/src/lib/utils/safe-stringify/safe-stringify.util.ts","../../../libs/shared/src/lib/services/error/vault-private-error.service.ts","../../../libs/shared/src/lib/services/error/vault-error.service.ts","../../../libs/shared/src/lib/abstracts/controllers/active-controller.abstract.ts","../../../libs/shared/src/lib/abstracts/index.ts","../../../libs/shared/src/lib/config/index.ts","../../../libs/shared/src/lib/constants/behavior-meta.constant.ts","../../../libs/shared/src/lib/constants/controller-meta.constant.ts","../../../libs/shared/src/lib/constants/dev-tools/devtools-aggregate-key.constant.ts","../../../libs/shared/src/lib/constants/dev-tools/devtools-logging-key.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-clear-state.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-continue.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-noop.constant.ts","../../../libs/shared/src/lib/constants/vault/vault-stop.constant.ts","../../../libs/shared/src/lib/constants/index.ts","../../../libs/shared/src/lib/contexts/index.ts","../../../libs/shared/src/lib/decorators/vault-behavior.decorator.ts","../../../libs/shared/src/lib/decorators/vault-controller.decorator.ts","../../../libs/shared/src/lib/decorators/index.ts","../../../libs/shared/src/lib/types/error/vault-error-kind.type.ts","../../../libs/shared/src/lib/types/error/vault-error-name.type.ts","../../../libs/shared/src/lib/errors/vault-error.ts","../../../libs/shared/src/lib/errors/vault-error.encryption-integrity.ts","../../../libs/shared/src/lib/types/error/vault-error-usage-kind.type.ts","../../../libs/shared/src/lib/errors/vault-error.license.ts","../../../libs/shared/src/lib/errors/vault-error.usage.ts","../../../libs/shared/src/lib/errors/vault-error.usage.promise.ts","../../../libs/shared/src/lib/errors/vault-error.usage.promise-factory-required.ts","../../../libs/shared/src/lib/errors/index.ts","../../../libs/shared/src/lib/interfaces/index.ts","../../../libs/shared/src/lib/services/index.ts","../../../libs/shared/src/lib/shapes/index.ts","../../../libs/shared/src/lib/types/controller/controller-message.type.ts","../../../libs/shared/src/lib/types/controller/controller-vote.type.ts","../../../libs/shared/src/lib/types/controller/controller.type.ts","../../../libs/shared/src/lib/types/controller/decision-outcome.type.ts","../../../libs/shared/src/lib/types/event/event-boundary.type.ts","../../../libs/shared/src/lib/types/event/event.type.ts","../../../libs/shared/src/lib/types/operation.type.ts","../../../libs/shared/src/lib/types/resolve.type.ts","../../../libs/shared/src/lib/types/state/state-emit.type.ts","../../../libs/shared/src/lib/types/index.ts","../../../libs/shared/src/lib/utils/behavior/define-behavior-key.util.ts","../../../libs/shared/src/lib/utils/controller/define-controller-key.util.ts","../../../libs/shared/src/lib/utils/deferred-factory/is-deferred-factory.util.ts","../../../libs/shared/src/lib/utils/error/create-vault-error.util.ts","../../../libs/shared/src/lib/utils/isolate-value/isolate-value.util.ts","../../../libs/shared/src/lib/utils/logic/logic.utils.ts","../../../libs/shared/src/lib/utils/promise/is-promise.util.ts","../../../libs/shared/src/lib/utils/resolve/is-http-resource.util.ts","../../../libs/shared/src/lib/utils/index.ts","../../../libs/shared/src/public-api.ts","../../../libs/shared/src/sdux-vault-shared.ts"],"sourcesContent":["// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > typings > global.d.ts\n// Updated: 2026-03-24 12:38\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { SDuXShape } from '../public-api';\n\n/*\n Extends the global Window object with optional SDuX monitoring and DevTools references.\n * This declaration defines the global attachment points used to expose runtime singletons.\n /\ndeclare global {\n interface Window {\n /\n Optional container for globally exposed SDuX runtime instances.\n /\n sdux?: SDuXShape;\n }\n\n /\n Optional global reference to SDuX runtime instances.\n /\n var sdux: SDuXShape \| undefined;\n}\n\nexport {};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > dev-mode > testing-environment.util.ts\n// Updated: 2026-03-09 14:47\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const isTestEnv = {\n get active(): boolean {\n return (\n // eslint-disable-next-line\n typeof (globalThis as any).jasmine !== 'undefined' \|\|\n // istanbul ignore next\n // eslint-disable-next-line\n typeof (globalThis as any).jest !== 'undefined' \|\|\n // istanbul ignore next\n // eslint-disable-next-line\n typeof (globalThis as any).vitest !== 'undefined'\n );\n }\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > dev-mode > dev-mode.util.ts\n// Updated: 2026-03-09 14:46\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { isTestEnv } from './testing-environment.util';\n\nlet devMode: boolean \| null = null;\n\nexport const DevMode = {\n get active(): boolean {\n return devMode === true;\n },\n\n setDevMode(isDevMode: boolean): void {\n if (devMode !== null && !isTestEnv.active) {\n throw new Error('[vault] DevMode has already been initialized.');\n }\n\n devMode = isDevMode;\n }\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > version > version.register.ts\n// Updated: 2026-03-03 07:47\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { SDuXShape } from '../../shapes/sdux/sdux.shape';\nimport { DevMode } from '../dev-mode/dev-mode.util';\n\nexport const registerVersion = (packageName: string, version: string): void => {\n if (!DevMode.active \|\| typeof globalThis === 'undefined') return;\n\n const sdux = (globalThis.sdux ??= {} as SDuXShape);\n const debug = (sdux.debugWidget ??= {});\n const versions = (debug.versions ??= {});\n\n if (versions[packageName] === version) return;\n\n versions[packageName] = version;\n};\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > version > version.register.ts\n// Updated: 2026-03-03 08:12\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { registerVersion } from '../utils/version/version.register';\n\nconst SDUX_PACKAGE = '@sdux-vault/shared';\nconst SDUX_VERSION = '0.0.12';\n\nregisterVersion(SDUX_PACKAGE, SDUX_VERSION);\n","/\n Runtime-safe registry of all behavior types.\n \n This object acts as an enum substitute without introducing JavaScript enum\n * overhead.\n * Values are string literals preserved at runtime and suitable for\n * switch statements, comparisons, and pipeline classification.\n * Each key maps 1:1 to its string literal value.\n * The structure is fully tree-shakable and safely inferable by TypeScript.\n /\nexport const BehaviorTypes = {\n CoreAfterTap: 'coreAfterTap',\n CoreBeforeTap: 'coreBeforeTap',\n ReplayGlobalError: 'replayGlobalError',\n CoreError: 'coreError',\n CoreErrorCallback: 'coreErrorCallback',\n CoreState: 'coreState',\n DevPipelineObserver: 'devPipelineObserver',\n Encrypt: 'encrypt',\n CoreEmitState: 'coreEmitState',\n ErrorTransform: 'errorTransform',\n Extension: 'extension',\n Filter: 'filter',\n FromObservable: 'fromObservable',\n FromPromise: 'fromPromise',\n FromStream: 'fromStream',\n Interceptor: 'interceptor',\n Merge: 'merge',\n Operator: 'operator',\n Persist: 'persist',\n Reduce: 'reduce',\n Resolve: 'resolve',\n StepwiseFilter: 'stepwiseFilter',\n StepwiseReducer: 'stepwiseReducer',\n StepwiseResolve: 'stepwiseResolve'\n} as const;\n\n/\n Union of all valid behavior type strings.\n \n This type is derived from `BehaviorTypes` using literal inference, ensuring\n * strong typing while preserving full runtime compatibility.\n * This type should not be manually extended—add new values to `BehaviorTypes`\n * instead.\n \n --RelatedStart--\n * BehaviorTypes\n * --RelatedEnd--\n /\nexport type BehaviorType = (typeof BehaviorTypes)[keyof typeof BehaviorTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > logging > console.type.ts\n// Updated: 2026-03-21 21:00\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Defines the allowable verbosity levels for Vault logging.\n \n A `LogLevel` controls the amount of diagnostic output emitted by the\n * vault’s internal debug, warning, or error channels. Higher levels\n * produce more detailed logs, while lower levels suppress output.\n \n - `'off'` — no logs are emitted\n * - `'error'` — only errors are logged\n * - `'warn'` — warnings and errors are logged\n * - `'log'` — standard log events, warnings, and errors are logged\n * - `'debug'` — all debug-level information is emitted\n /\n\nexport const ConsoleTypes = {\n Error: 'error',\n Warn: 'warn',\n Log: 'log',\n Debug: 'debug'\n} as const;\n\nexport type ConsoleType = (typeof ConsoleTypes)[keyof typeof ConsoleTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > logging > log-level.type.ts\n// Updated: 2026-03-21 21:00\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Defines the allowable verbosity levels for Vault logging.\n \n A `LogLevel` controls the amount of diagnostic output emitted by the\n * vault’s internal debug, warning, or error channels. Higher levels\n * produce more detailed logs, while lower levels suppress output.\n \n - `'off'` — no logs are emitted\n * - `'error'` — only errors are logged\n * - `'warn'` — warnings and errors are logged\n * - `'log'` — standard log events, warnings, and errors are logged\n * - `'debug'` — all debug-level information is emitted\n /\n\nexport const LogLevelTypes = {\n Off: 'off',\n Error: 'error',\n Warn: 'warn',\n Log: 'log',\n Debug: 'debug'\n} as const;\n\nexport type LogLevelType = (typeof LogLevelTypes)[keyof typeof LogLevelTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > logger > logger.util.ts\n// Updated: 2026-03-23 16:50\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { ConsoleType, ConsoleTypes } from '../../types/logging/console.type';\nimport {\n LogLevelType,\n LogLevelTypes\n} from '../../types/logging/log-level.type';\n\nlet _logLevel: LogLevelType = LogLevelTypes.Off;\n\n/\n Prefix applied to all vault-related console output. Used to keep log\n * messages consistently identifiable across all log levels.\n /\nconst LOG_PREFIX = '[vault]';\n\n// eslint-disable-next-line\nfunction push(level: ConsoleType, ...args: any[]): void {\n const logLevel = getVaultLogLevel();\n\n if (logLevel === LogLevelTypes.Off) return;\n\n const levels: ConsoleType[] = [\n ConsoleTypes.Error,\n ConsoleTypes.Warn,\n ConsoleTypes.Log,\n ConsoleTypes.Debug\n ];\n\n const allowed = levels.indexOf(level) <= levels.indexOf(logLevel!);\n\n if (!allowed) return;\n\n // eslint-disable-next-line\n console[level](LOG_PREFIX, ...args);\n}\n\n/\n Emits an `error`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultError = (...args: any[]) => push('error', ...args);\n\n/\n Emits a `warn`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultWarn = (...args: any[]) => push('warn', ...args);\n\n/\n Emits a `log`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultLog = (...args: any[]) => push('log', ...args);\n\n/\n Emits a `debug`-level Vault log message.\n \n @param args - Console arguments to log.\n /\n// eslint-disable-next-line\nexport const vaultDebug = (...args: any[]) => push('debug', ...args);\n\nexport function setVaultLogLevel(level: LogLevelType) {\n _logLevel = level ?? 'off';\n}\n\nexport function getVaultLogLevel(): LogLevelType {\n return _logLevel;\n}\n","import { BehaviorClassContext } from '../../../contexts/behavior-class.context';\nimport { ErrorCallbackBehaviorContract } from '../../../interfaces/behaviors/error-callback-behavior.interface';\nimport { StateSnapshotShape } from '../../../shapes/state/state-snapshot.shape';\nimport { VaultErrorShape } from '../../../shapes/vault-error.shape';\nimport { BehaviorTypes } from '../../../types/behavior/behavior.type';\nimport { VaultErrorCallback } from '../../../types/callback/vault-error-callback.type';\nimport { vaultWarn } from '../../../utils/logger/logger.util';\n\nexport abstract class AbstractErrorCallbackBehavior<T>\n implements ErrorCallbackBehaviorContract<T>\n{\n /* Indicates that this error behavior is critical and always executed. /\n readonly critical!: boolean;\n\n /* Unique identifier for this behavior instance. /\n readonly key: string;\n\n /* Behavior type for orchestrator registration. /\n readonly type = BehaviorTypes.CoreErrorCallback;\n\n /\n Creates a new abstract error behavior instance.\n \n @param key - Unique behavior identifier supplied by the behavior factory.\n * @param behaviorCtx - Behavior class context providing injector access and extensibility hooks.\n /\n constructor(\n key: string,\n readonly behaviorCtx: BehaviorClassContext\n ) {\n this.key = key;\n }\n\n abstract callbackError(\n current: VaultErrorShape,\n state: StateSnapshotShape<T>,\n oldschoolCallback: VaultErrorCallback<T>\n ): Promise<void>;\n\n /\n Lifecycle hook invoked when the behavior instance is destroyed.\n \n Error behaviors do not allocate runtime resources and therefore require\n * no cleanup. A diagnostic entry is logged for lifecycle visibility.\n /\n destroy(): void {\n vaultWarn(`${this.key} - destroy \"noop\"`);\n }\n\n /\n Lifecycle hook invoked when the behavior instance is reset.\n \n Error behaviors hold no internal state, making this a no-operation.\n * The hook ensures lifecycle uniformity across all behaviors.\n /\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","import { VAULT_NOOP } from '../../../constants/vault/vault-noop.constant';\nimport { BehaviorClassContext } from '../../../contexts/behavior-class.context';\nimport { ErrorTransformBehaviorContract } from '../../../interfaces/behaviors/error-transform-behavior.interface';\nimport { StateSnapshotShape } from '../../../shapes/state/state-snapshot.shape';\nimport { VaultErrorShape } from '../../../shapes/vault-error.shape';\nimport { BehaviorTypes } from '../../../types/behavior/behavior.type';\nimport { vaultWarn } from '../../../utils/logger/logger.util';\n\n/\n Abstract base behavior for transforming errors during pipeline execution.\n * This class defines the contract and lifecycle hooks required for error transformation behaviors.\n \n --RelatedStart--\n * ErrorTransformBehaviorContract\n * BehaviorClassContext\n * StateSnapshotShape\n * VaultErrorShape\n * --RelatedEnd--\n /\nexport abstract class AbstractErrorTransformBehavior<T>\n implements ErrorTransformBehaviorContract<T>\n{\n /\n Indicates that this error transform behavior is critical and always executed.\n /\n readonly critical!: boolean;\n\n /\n Unique identifier for this behavior instance.\n /\n readonly key: string;\n\n /\n Behavior type identifier used for orchestrator registration.\n /\n readonly type = BehaviorTypes.ErrorTransform;\n\n /\n Creates a new abstract error transform behavior instance.\n \n @param key Unique behavior identifier supplied by the factory.\n * @param behaviorCtx Behavior class context providing configuration and hooks.\n /\n constructor(\n key: string,\n readonly behaviorCtx: BehaviorClassContext\n ) {\n this.key = key;\n }\n\n /\n Transforms an error produced during pipeline execution.\n \n @param error Incoming error value to be transformed.\n * @param current Current normalized Vault error value.\n * @param previousStateSnapshot Snapshot of state prior to the error.\n * @returns Transformed error, original error, or VAULT_NOOP to suppress emission.\n /\n abstract transformError(\n error: unknown,\n current: VaultErrorShape,\n previousStateSnapshot: StateSnapshotShape<T>\n ): Promise<unknown \| typeof VAULT_NOOP>;\n\n /\n Lifecycle hook invoked when the behavior instance is destroyed.\n /\n destroy(): void {\n vaultWarn(`${this.key} - destroy \"noop\"`);\n }\n\n /\n Lifecycle hook invoked when the behavior instance is reset.\n /\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","/\n Safely converts an arbitrary value into a JSON string representation.\n \n This function wraps `JSON.stringify` with enhanced handling for non-serializable\n * values, including:\n * - functions\n * - `Error` objects\n * - `Map` and `Set` instances\n * - circular references\n \n If serialization fails for any reason, a fallback string `\"[unserializable]\"`\n * is returned. The replacer ensures stable and predictable stringification for\n * use in logging and debugging utilities.\n \n @param value - The value to stringify safely.\n * @returns A JSON-formatted string or a fallback indicator.\n /\nexport function safeStringify(value: unknown): string {\n try {\n return JSON.stringify(value, jsonSafeReplacer, 2);\n } catch {\n return '[unserializable]';\n }\n}\n\n/\n Replacer function used by `safeStringify` to handle values that are normally\n * not serializable via `JSON.stringify`.\n \n It converts functions, errors, `Map`, and `Set` values into safe structures\n * and detects circular references. If a value cannot be serialized, a fallback\n * marker string is returned.\n \n @param _key - The property key being processed (unused).\n * @param val - The value associated with the key.\n * @returns A serializable representation of the value.\n /\n\nfunction jsonSafeReplacer(_key: string, val: unknown) {\n if (typeof val === 'function') return '[Function]';\n if (val instanceof Error) return { message: val.message, stack: val.stack };\n if (val instanceof Map) return { map: Array.from(val.entries()) };\n if (val instanceof Set) return { set: Array.from(val.values()) };\n\n // Avoid circular references\n try {\n JSON.stringify(val);\n return val;\n } catch {\n return '[Circular]';\n }\n}\n","import { BehaviorSubject, Observable } from 'rxjs';\nimport { VaultPrivateErrorServiceContract } from '../../interfaces/vault/vault-private-error-service.interface';\nimport { VaultErrorShape } from '../../shapes/vault-error.shape';\nimport { vaultDebug } from '../../utils/logger/logger.util';\nimport { safeStringify } from '../../utils/safe-stringify/safe-stringify.util';\n\n/* ------------------------------------------\n * INTERNAL CLASS (NOT EXPORTED)\n * ------------------------------------------ /\nclass VaultPrivateErrorClass implements VaultPrivateErrorServiceContract {\n readonly #error$ = new BehaviorSubject<VaultErrorShape \| null>(null);\n\n constructor() {\n vaultDebug(\n '[VaultPrivateErrorService] initialized (singleton instance created)'\n );\n }\n\n setError(error: VaultErrorShape \| null): void {\n vaultDebug(`[VaultPrivateErrorService] setError() ${safeStringify(error)}`);\n this.#error$.next(error);\n }\n\n getError(): Observable<VaultErrorShape \| null> {\n vaultDebug('[VaultPrivateErrorService] getError() → observable subscribed');\n return this.#error$.asObservable();\n }\n\n clear(): void {\n vaultDebug('[VaultPrivateErrorService] clear() → error reset to null');\n this.#error$.next(null);\n }\n}\n\n/* ------------------------------------------\n * SINGLETON FACTORY (EXPORTED)\n * ------------------------------------------ /\nlet _instance: VaultPrivateErrorServiceContract \| null = null;\n\nexport function VaultPrivateErrorService(): VaultPrivateErrorServiceContract {\n if (!_instance) {\n vaultDebug('[VaultPrivateErrorService] creating new singleton instance');\n _instance = new VaultPrivateErrorClass();\n } else {\n vaultDebug(\n '[VaultPrivateErrorService] returning existing singleton instance'\n );\n }\n return _instance;\n}\n","import { BehaviorSubject, Subscription } from 'rxjs';\nimport { VaultErrorServiceContract } from '../../interfaces/vault/vault-error-service.interface';\nimport { VaultErrorShape } from '../../shapes/vault-error.shape';\nimport { vaultDebug } from '../../utils/logger/logger.util';\nimport { VaultPrivateErrorService } from './vault-private-error.service';\n\nclass VaultErrorServiceClass implements VaultErrorServiceContract {\n readonly #privateVaultErrorService = VaultPrivateErrorService();\n\n readonly #error$ = new BehaviorSubject<VaultErrorShape \| null>(null);\n\n #hasErrorState = false;\n\n /* Track internal subscription for cleanup /\n readonly #subscription = new Subscription();\n\n /* Public observable error stream /\n readonly error$ = this.#error$.asObservable();\n\n constructor() {\n vaultDebug(\n '[VaultErrorService] Initializing service and subscribing to private error stream.'\n );\n\n // Mirror the private error service into this one\n const sub = this.#privateVaultErrorService\n .getError()\n .subscribe((err: VaultErrorShape \| null) => {\n vaultDebug(\n `[VaultErrorService] Received error update from private service: ${err ? err.message : 'null'}`\n );\n this.#hasErrorState = !!err;\n this.#error$.next(err);\n });\n\n this.#subscription.add(sub);\n }\n\n get hasError(): boolean {\n return this.#hasErrorState;\n }\n\n clear(): void {\n vaultDebug('[VaultErrorService] Clearing current error.');\n this.#privateVaultErrorService.clear();\n }\n}\n\n// --------------------------------\n// SINGLETON FACTORY (EXPORTED)\n// --------------------------------\n\nlet _instance: VaultErrorServiceClass \| null = null;\n\nexport function VaultErrorService(): VaultErrorServiceContract {\n if (!_instance) {\n vaultDebug('[VaultErrorService] Creating new singleton instance.');\n _instance = new VaultErrorServiceClass();\n }\n return _instance;\n}\n","import { Observable, Subscription, tap } from 'rxjs';\nimport { ControllerClassContext } from '../../contexts/controller-class.context';\nimport { ControllerContract } from '../../interfaces/controllers/controller.interface';\nimport { VaultErrorService } from '../../services/error/vault-error.service';\nimport { ControllerMessageShape } from '../../shapes/controller/controller-message.shape';\nimport { ControllerVote } from '../../types/controller/controller-vote.type';\nimport { ControllerType } from '../../types/controller/controller.type';\nimport { vaultDebug, vaultWarn } from '../../utils/logger/logger.util';\nimport { safeStringify } from '../../utils/safe-stringify/safe-stringify.util';\n\nexport abstract class AbstractActiveController<T>\n implements ControllerContract<T>\n{\n readonly key: string;\n abstract readonly type: ControllerType;\n readonly critical = false;\n\n protected hasError = false;\n protected traceId: string \| null = null;\n\n #subscription: Subscription;\n\n constructor(\n key: string,\n protected readonly ctx: ControllerClassContext\n ) {\n this.key = key;\n\n this.#subscription = VaultErrorService()\n .error$.pipe(\n tap((error) => {\n vaultDebug(\n `${this.key} VaultErrorService dispatched event. Raw event: ${safeStringify(error)}.`\n );\n const newValue = error != null;\n vaultDebug(`${this.key} New transformed error value: \"${newValue}\".`);\n\n const revoteDecision =\n newValue !== this.hasError && this.traceId !== undefined;\n vaultDebug(\n `${this.key} Revote Decision: ${revoteDecision}. Factors. NewValue: ${newValue} HasError: ${this.hasError} TraceId: ${this.traceId} Rubric: 'newValue !== this.hasError && this.traceId !== undefined'`\n );\n\n this.hasError = newValue;\n vaultDebug(\n `${this.key} this.hasError replace with newValue: \"${this.hasError}\".`\n );\n vaultDebug(\n `${this.key} onExternalTrigger dispatchd with: \"${newValue}\".`\n );\n this.onExternalTrigger(newValue);\n\n if (revoteDecision) {\n vaultDebug(\n `${this.key} Revote Requesed with traceId: \"${this.traceId}\".`\n );\n this.ctx.requestRevote(this.traceId!);\n }\n })\n )\n .subscribe();\n }\n\n /* Child classes override to react to external error toggles /\n //istanbul ignore next\n protected onExternalTrigger(_newErrorState: boolean): void {}\n\n /* All controllers must implement this /\n abstract handleMessage(\n msg: ControllerMessageShape<T>\n ): Observable<ControllerVote \| void>;\n\n destroy(): void {\n this.#subscription.unsubscribe();\n vaultWarn(`${this.key} - destroy`);\n }\n\n reset(): void {\n vaultWarn(`${this.key} - reset \"noop\"`);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > abstracts > index.ts\n// Updated: 2026-03-23 17:27\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * Abstracts\n * --------------------------------------------------------- /\nexport { AbstractErrorCallbackBehavior } from './behaviors/error/with-error-callback.abstract';\nexport { AbstractErrorTransformBehavior } from './behaviors/error/with-error-transform.abstract';\nexport { AbstractActiveController } from './controllers/active-controller.abstract';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > config > index.ts\n// Updated: 2026-03-23 16:54\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * CONFIGS\n * --------------------------------------------------------- /\nexport type { InsightConfig } from './insight.config';\nexport type { MergeConfig } from './merge.config';\nexport type { ObjectDeepMergeConfig } from './object-deep-merge.config';\nexport type { VaultConfig } from './vault.config';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > constants > behavior-meta.constant.ts\n// Updated: 2026-03-28 14:09\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const BEHAVIOR_META = Symbol.for('BEHAVIOR_META');\n","export const CONTROLLER_META = Symbol.for('CONTROLLER_META');\n","// --- AI Model File Path ---\n// libs > shared > src > lib > constants > dev-tools > devtools-aggregate-key.constant.ts\n\n/\n String token used to uniquely identify the DevTools Aggregate FeatureCell.\n \n This key is referenced by the DevTools service, monitor utilities,\n * and the router configuration to ensure all DevTools-related state\n * is consistently mapped to the same FeatureCell instance.\n \n The value is stable across versions to maintain compatibility with\n * external tools such as the Chrome DevTools extension.\n /\nexport const DEVTOOLS_AGGREGATE_KEY_CONSTANT =\n 'vault::devtools::aggregate:feature::cell';\n","// --- AI Model File Path ---\n// libs > shared > src > lib > constants > dev-tools > devtools-logging-key.constant.ts\n\n/\n String token used to uniquely identify the DevTools Logging FeatureCell.\n \n This key is referenced by the DevTools service, monitor utilities,\n * and the router configuration to ensure all DevTools-related state\n * is consistently mapped to the same FeatureCell instance.\n \n The value is stable across versions to maintain compatibility with\n * external tools such as the Chrome DevTools extension.\n /\nexport const DEVTOOLS_LOGGING_KEY_CONSTANT =\n 'vault::devtools::logging::feature::cell';\n","export const VAULT_CLEAR_STATE = Symbol.for('VAULT_CLEAR_STATE');\n","export const VAULT_CONTINUE = Symbol.for('VAULT_CONTINUE');\n","export const VAULT_NOOP = Symbol.for('VAULT_NOOP');\n","export const VAULT_STOP = Symbol.for('VAULT_STOP');\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > constants > public-api.ts\n// Updated: 2026-03-23 18:48\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * META + DECORATORS\n * --------------------------------------------------------- /\nexport { BEHAVIOR_META } from './behavior-meta.constant';\nexport { CONTROLLER_META } from './controller-meta.constant';\nexport { DEVTOOLS_AGGREGATE_KEY_CONSTANT } from './dev-tools/devtools-aggregate-key.constant';\nexport { DEVTOOLS_LOGGING_KEY_CONSTANT } from './dev-tools/devtools-logging-key.constant';\nexport { VAULT_CLEAR_STATE } from './vault/vault-clear-state.constant';\nexport { VAULT_CONTINUE } from './vault/vault-continue.constant';\nexport { VAULT_NOOP } from './vault/vault-noop.constant';\nexport { VAULT_STOP } from './vault/vault-stop.constant';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > contexts > index.ts\n// Updated: 2026-03-23 17:31\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * CONTEXTS\n * --------------------------------------------------------- /\nexport type { BehaviorClassContext } from './behavior-class.context';\nexport type { BehaviorContext } from './behavior.context';\nexport type { ControllerClassContext } from './controller-class.context';\nexport type { ControllerContext } from './controller.context';\nexport type { FeatureCellExtensionContext } from './feature-cell-extension.context';\n","// vault-behavior.decorator.ts\nimport { BEHAVIOR_META } from '../constants/behavior-meta.constant';\nimport { BehaviorMetaShape } from '../shapes/behavior-meta.shape';\n\n/\n Decorator that registers a class as an Vault behavior.\n \n The `VaultBehavior` decorator attaches the provided `BehaviorMeta`\n * definition to the target constructor, making the behavior discoverable by\n * the orchestrator during pipeline initialization. Metadata fields such as\n * `type`, `key`, and `critical` are also mirrored onto static properties of\n * the decorated class to support lightweight runtime introspection.\n \n This decorator does not modify method logic or structure; it only assigns\n * metadata required for orchestrator classification and behavior lifecycle\n * management.\n \n @param meta - Metadata describing the behavior’s category, unique key, and\n * criticality within the pipeline.\n * @returns A class decorator that applies behavior metadata to the target.\n /\nexport function VaultBehavior(meta: BehaviorMetaShape) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return function (target: any) {\n // Attach full metadata for the orchestrator\n target[BEHAVIOR_META] = meta;\n\n // Also mirror some fields onto static props for convenience\n if (meta.type !== undefined) {\n target.type = meta.type;\n }\n if (meta.key !== undefined) {\n target.key = meta.key;\n }\n if (meta.critical !== undefined) {\n target.critical = meta.critical;\n }\n\n if (meta.resolveType !== undefined) {\n target.resolveType = meta.resolveType;\n }\n\n if (meta.wantsConfig !== undefined) {\n target.wantsConfig = meta.wantsConfig;\n } else {\n target.wantsConfig = false;\n }\n\n if (meta.configKey !== undefined) {\n target.configKey = meta.configKey;\n }\n\n if (meta.needsLicense !== undefined) {\n target.needsLicense = meta.needsLicense;\n } else {\n target.needsLicense = false;\n }\n\n if (meta.licenseId !== undefined) {\n target.licenseId = meta.licenseId;\n }\n };\n}\n","// vault-behavior.decorator.ts\nimport { CONTROLLER_META } from '../constants/controller-meta.constant';\nimport { ControllerMetaShape } from '../shapes/controller/controller-meta.shape';\n\nexport function VaultController(meta: ControllerMetaShape) {\n // eslint-disable-next-line @typescript-eslint/no-explicit-any\n return function (target: any) {\n // Attach full metadata for the orchestrator\n target[CONTROLLER_META] = meta;\n\n // Also mirror some fields onto static props for convenience\n if (meta.type !== undefined) {\n target.type = meta.type;\n }\n if (meta.key !== undefined) {\n target.key = meta.key;\n }\n if (meta.critical !== undefined) {\n target.critical = meta.critical;\n }\n if (meta.wantsConfig !== undefined) {\n target.wantsConfig = meta.wantsConfig;\n } else {\n target.wantsConfig = false;\n }\n\n if (meta.configKey !== undefined) {\n target.configKey = meta.configKey;\n }\n\n if (meta.needsLicense !== undefined) {\n target.needsLicense = meta.needsLicense;\n } else {\n target.needsLicense = false;\n }\n\n if (meta.licenseId !== undefined) {\n target.licenseId = meta.licenseId;\n }\n };\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > decorators > index.ts\n// Updated: 2026-03-23 18:29\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * META + DECORATORS\n * --------------------------------------------------------- /\nexport { VaultBehavior } from './vault-behavior.decorator';\nexport { VaultController } from './vault-controller.decorator';\n","import { VaultErrorUsageKindTypes } from './vault-error-usage-kind.type';\n\nexport const VaultErrorKindTypes = {\n Usage: 'VaultErrorUsage',\n VaultError: 'VaultError'\n} as const;\n\nexport type VaultErrorKindType =\n \| (typeof VaultErrorKindTypes)[keyof typeof VaultErrorKindTypes]\n \| (typeof VaultErrorUsageKindTypes)[keyof typeof VaultErrorUsageKindTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > error > vault-error-name.type.ts\n// Updated: 2026-03-12 11:57\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const VaultErrorNameTypes = {\n EncryptionIntegrity: 'VaultErrorEncryptionIntegrity',\n License: 'VaultErrorLicense',\n Usage: 'VaultErrorUsage',\n VaultError: 'VaultError'\n} as const;\n\nexport type VaultErrorNameType =\n (typeof VaultErrorNameTypes)[keyof typeof VaultErrorNameTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.ts\n// Updated: 2026-03-12 12:08\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport {\n VaultErrorKindType,\n VaultErrorKindTypes\n} from '../types/error/vault-error-kind.type';\nimport {\n VaultErrorNameType,\n VaultErrorNameTypes\n} from '../types/error/vault-error-name.type';\n\nexport class VaultError extends Error {\n readonly kind: VaultErrorKindType;\n\n constructor(\n message: string,\n name: VaultErrorNameType = VaultErrorNameTypes.VaultError,\n kind: VaultErrorKindType = VaultErrorKindTypes.VaultError\n ) {\n super(message);\n\n this.name = name;\n this.kind = kind;\n\n // Required for proper instanceof checks in TS / ES5 targets\n Object.setPrototypeOf(this, new.target.prototype);\n\n // Optional but nice: clean stack trace\n // eslint-disable-next-line\n const anyError = Error as any;\n if (typeof anyError.captureStackTrace === 'function') {\n anyError.captureStackTrace(this, new.target);\n }\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.encryption.integrity.ts\n// Updated: 2026-03-12\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport { VaultError } from './vault-error';\n\n/\n Thrown when encrypted payload integrity verification fails.\n \n This occurs when AES-GCM authentication fails during decryption.\n * Causes may include:\n \n - Tampered ciphertext\n * - Modified IV\n * - Incorrect encryption key\n * - Corrupted storage payload\n \n AES-GCM provides authenticated encryption, so any modification to the\n * encrypted envelope will cause the WebCrypto decrypt operation to throw.\n /\nexport class VaultEncryptionIntegrityError extends VaultError {\n constructor() {\n const message = `Encrypted snapshot failed integrity verification.\n\nThe encrypted payload could not be authenticated during AES-GCM decryption.\n\nPossible causes:\n\n• The stored ciphertext has been tampered with\n• The stored initialization vector (IV) was modified\n• The encryption key does not match the original key\n• The stored payload is corrupted\n\nVault refuses to restore state from unauthenticated encrypted data.`;\n\n super(message, VaultErrorNameTypes.EncryptionIntegrity);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > error > vault-error-usage-kind.type.ts\n// Updated: 2026-03-12 11:57\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const VaultErrorUsageKindTypes = {\n Encryption: 'VaultErrorEncryption',\n License: 'VaultErrorLicense',\n Promise: 'VaultErrorUsagePromise',\n PromiseFactoryRequired: 'VaultErrorUsagePromiseFactoryRequired',\n Usage: 'VaultErrorUsage'\n} as const;\n\nexport type VaultErrorUsageKindType =\n (typeof VaultErrorUsageKindTypes)[keyof typeof VaultErrorUsageKindTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.license.ts\n// Updated: 2026-03-12 11:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport {\n VaultErrorUsageKindType,\n VaultErrorUsageKindTypes\n} from '../types/error/vault-error-usage-kind.type';\nimport { VaultError } from './vault-error';\n\nexport class VaultLicenseError extends VaultError {\n constructor(\n message: string,\n kind: VaultErrorUsageKindType = VaultErrorUsageKindTypes.License\n ) {\n super(message, VaultErrorNameTypes.License, kind);\n }\n}\n","import { VaultErrorNameTypes } from '../types/error/vault-error-name.type';\nimport {\n VaultErrorUsageKindType,\n VaultErrorUsageKindTypes\n} from '../types/error/vault-error-usage-kind.type';\nimport { VaultError } from './vault-error';\n\nexport class VaultUsageError extends VaultError {\n constructor(\n message: string,\n kind: VaultErrorUsageKindType = VaultErrorUsageKindTypes.Usage\n ) {\n super(message, VaultErrorNameTypes.Usage, kind);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > vault-error.usage.promise.ts\n// Updated: 2026-03-12 12:01\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultUsageError } from './vault-error.usage';\n\nexport class VaultUsagePromiseError extends VaultUsageError {\n constructor() {\n const message = `Invalid incoming value: Promise detected.\n\nPromises are eager and may resolve or reject before entering the Vault pipeline.\n\nUse the following instead a DeferredFactory value\n\nThis guarantees the promise is created and executed inside the pipeline.`;\n\n super(message, VaultErrorUsageKindTypes.Promise);\n }\n}\n","import { VaultErrorUsageKindTypes } from '../types/error/vault-error-usage-kind.type';\nimport { VaultUsageError } from './vault-error.usage';\n\nexport class VaultUsagePromiseFactoryRequiredError extends VaultUsageError {\n constructor() {\n const message = `Invalid usage of Promise-based state API.\n\nYou called a Promise-specific method (replaceState / mergeState),\nbut did not provide a function that creates a Promise.\n\nExpected:\n• () => Promise<T>\n\nReceived:\n• A non-function value\n\nPromises are eager and may resolve or reject before entering the Vault pipeline.\n\nAlways wrap promises in a function so they are created and executed\ninside the pipeline.`;\n\n super(message, VaultErrorUsageKindTypes.PromiseFactoryRequired);\n }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > errors > index.ts\n// Updated: 2026-03-23 17:21\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * ERRORS\n * --------------------------------------------------------- /\nexport { VaultError } from './vault-error';\nexport { VaultEncryptionIntegrityError } from './vault-error.encryption-integrity';\nexport { VaultLicenseError } from './vault-error.license';\nexport { VaultUsageError } from './vault-error.usage';\nexport { VaultUsagePromiseError } from './vault-error.usage.promise';\nexport { VaultUsagePromiseFactoryRequiredError } from './vault-error.usage.promise-factory-required';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > interfaces > index.ts\n// Updated: 2026-03-23 18:45\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * BEHAVIOR INTERFACES\n * --------------------------------------------------------- /\nexport type { BehaviorClassContract } from './behaviors/behavior/behavior-class.interface';\nexport type {\n BehaviorContract,\n BehaviorExtension,\n BehaviorExtFunction\n} from './behaviors/behavior/behavior.interface';\nexport type { CoreEmitStateBehaviorContract } from './behaviors/core-emit-state-behavior.interface';\nexport type { DevPipelineObserverBehaviorContract } from './behaviors/dev/dev-pipeline-observer-behavior.interface';\nexport type { EncryptBehaviorContract } from './behaviors/encrypt-behavior.interface';\nexport type { ErrorCallbackBehaviorContract } from './behaviors/error-callback-behavior.interface';\nexport type { ErrorTransformBehaviorContract } from './behaviors/error-transform-behavior.interface';\nexport type { FeatureCellExtension } from './behaviors/feature-cell-extension.interface';\nexport type { FeatureCellFluentApi } from './behaviors/feature-cell-fluent-api.interface';\nexport type { FilterBehaviorContract } from './behaviors/filter-behavior.interface';\nexport type { InterceptorBehaviorClassContract } from './behaviors/interceptor/interceptor-behavior-class.interface';\nexport type { InterceptorBehaviorContract } from './behaviors/interceptor/interceptor-behavior.interface';\nexport type { MergeBehaviorContract } from './behaviors/merge-behavior.interface';\nexport type { OperatorsBehaviorClassContract } from './behaviors/operator/operator-behavior-class.interface';\nexport type { OperatorBehaviorContract } from './behaviors/operator/operator-behavior.interface';\nexport type { PersistBehaviorContract } from './behaviors/persist-behavior.interface';\nexport type { ReduceBehaviorContract } from './behaviors/reduce-behavior.interface';\nexport type { ResolveBehaviorContract } from './behaviors/resolve-behavior.interface';\nexport type { StepwiseBehaviorContract } from './behaviors/stepwise-behavior.interface';\nexport type { AfterTapBehaviorContract } from './behaviors/tap/after-tap-behavior.interface';\nexport type { BeforeTapBehaviorContract } from './behaviors/tap/before-tap-behavior.interface';\nexport type { CellBuilderContract } from './cell-builder.interface';\nexport type { ControllerClassContract } from './controllers/controller-class.interface';\nexport type { ControllerContract } from './controllers/controller.interface';\nexport type { EventBusContract } from './event/event-bus.interface';\nexport type { VaultErrorServiceContract } from './vault/vault-error-service.interface';\nexport type { VaultMonitorContract } from './vault/vault-monitor.interface';\nexport type { VaultPrivateErrorServiceContract } from './vault/vault-private-error-service.interface';\n","/ -----------------------------------------------------------\n * SERVICES\n * --------------------------------------------------------- /\nexport { VaultErrorService } from './error/vault-error.service';\nexport { VaultPrivateErrorService } from './error/vault-private-error.service';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > shapes > index.ts\n// Updated: 2026-03-23 18:42\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * Shapes\n * --------------------------------------------------------- /\nexport type { BehaviorMetaShape } from './behavior-meta.shape';\nexport type { ControllerAttemptMessageShape } from './controller/controller-attempt-message.shape';\nexport type { ControllerDecisionShape } from './controller/controller-decision.shape';\nexport type { ControllerFailMessageShape } from './controller/controller-fail-message.shape';\nexport type { ControllerFinalizeMessageShape } from './controller/controller-finalize-message.shape';\nexport type { ControllerMessageShape } from './controller/controller-message.shape';\nexport type { ControllerMetaShape } from './controller/controller-meta.shape';\nexport type { ControllerSuccessMessageShape } from './controller/controller-success-message.shape';\nexport type { EventShape } from './event/event.shape';\nexport type { FeatureCellBaseShape } from './feature-cell/feature-cell.base.shape';\nexport type { HttpResourceRefShape } from './http-resource-ref-shape.shape';\nexport type { SDuXShape } from './sdux/sdux.shape';\nexport type { StateEmitSnapshotShape } from './state/state-emit-snapshot.shape';\nexport type { StateInputShape } from './state/state-input.shape';\nexport type { StateSnapshotShape } from './state/state-snapshot.shape';\nexport type { VaultErrorShape } from './vault-error.shape';\nexport type { VaultLicensingShape } from './vault/vault-licensing.shape';\nexport type { VaultRegistrationEntityShape } from './vault/vault-registration.entity.shape';\nexport type { VaultRegistrationFluentApiShape } from './vault/vault-registration.fluent-api.shape';\nexport type { VaultRegistrationShape } from './vault/vault-registration.shape';\n","export const ControllerMessageTypes = {\n Attempt: 'attempt',\n Failure: 'failure',\n Finalize: 'Finalize Pipeline',\n Success: 'success',\n Vote: 'vote' // mostly internal\n} as const;\n\nexport type ControllerMessageType =\n (typeof ControllerMessageTypes)[keyof typeof ControllerMessageTypes];\n","export const ControllerVotes = {\n Abstain: 'abstain',\n Abort: 'abort',\n Deny: 'deny'\n} as const;\n\nexport type ControllerVote =\n (typeof ControllerVotes)[keyof typeof ControllerVotes];\n","export const ControllerTypes = {\n CoreAbstain: 'coreAbstain',\n Error: 'error',\n License: 'license',\n Policy: 'policy',\n ReplayGlobalError: 'replayGlobalError',\n Stepwise: 'stepwise'\n} as const;\n\nexport type ControllerType =\n (typeof ControllerTypes)[keyof typeof ControllerTypes];\n","export const DecisionOutcomeTypes = {\n Abort: 'abort',\n Abstain: 'abstain',\n Deny: 'deny'\n} as const;\n\nexport type DecisionOutcomeType =\n (typeof DecisionOutcomeTypes)[keyof typeof DecisionOutcomeTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > event > event-boundary.type.ts\n// Updated: 2026-03-10 09:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const EventBoundaryTypes = {\n End: 'end',\n Notification: 'notification',\n Start: 'start',\n Unknown: 'unknown'\n} as const;\n\nexport type EventBoundaryType =\n (typeof EventBoundaryTypes)[keyof typeof EventBoundaryTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > event > event.type.ts\n// Updated: 2026-03-10 09:56\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nexport const EventTypes = {\n Conductor: 'conductor',\n Controller: 'controller',\n Lifecycle: 'lifecycle',\n Stage: 'stage',\n Unknown: 'unknown'\n} as const;\n\nexport type EventType = (typeof EventTypes)[keyof typeof EventTypes];\n","export const OperationTypes = {\n Merge: 'merge',\n Replace: 'replace',\n Initialize: 'initialize'\n} as const;\n\nexport type OperationType =\n (typeof OperationTypes)[keyof typeof OperationTypes];\n","/\n Enumerates the available resolve strategy identifiers used by resolve\n * behaviors. These identifiers indicate how a FeatureCell obtains its initial\n * and subsequent state values during the resolve stage of the pipeline.\n \n - `Value` — Resolve from a synchronous, in-memory value.\n * - `HttpResource` — Resolve using an HTTP-driven resource behavior.\n * - `Observable` — Resolve from an observable stream source.\n * - `Promise` — Resolve from a promise source.\n /\nexport const ResolveTypes = {\n HttpResource: 'http-resource',\n Observable: 'observable',\n Promise: 'promise',\n Value: 'value'\n} as const;\n\n/\n Union type representing all supported resolve strategy identifiers.\n /\nexport type ResolveType = (typeof ResolveTypes)[keyof typeof ResolveTypes];\n","export const StateEmitTypes = {\n IncomingPipeline: 'Incoming Pipeline',\n FinalizePipeline: 'Finalize Pipeline',\n PipelineError: 'Pipeline Error',\n PipelineDestroy: 'Pipeline Destroy',\n PipelineReset: 'Pipeline Reset',\n AbortController: 'Abort Controller',\n DenyController: 'Deny Controller'\n} as const;\n\nexport type StateEmitType =\n (typeof StateEmitTypes)[keyof typeof StateEmitTypes];\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > types > index.ts\n// Updated: 2026-03-23 18:51\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * TYPES (USER-FACING)\n * --------------------------------------------------------- /\nexport { BehaviorTypes } from './behavior/behavior.type';\nexport type { BehaviorType } from './behavior/behavior.type';\nexport type { DistinctComparison } from './behavior/distinct-comparison.type';\nexport type { CoreEmitStateCallback } from './callback/core-emit-state-callback.type';\nexport type { TapCallback } from './callback/tap-callback.type';\nexport type { VaultErrorCallback } from './callback/vault-error-callback.type';\nexport { ControllerMessageTypes } from './controller/controller-message.type';\nexport type { ControllerMessageType } from './controller/controller-message.type';\nexport { ControllerVotes } from './controller/controller-vote.type';\nexport type { ControllerVote } from './controller/controller-vote.type';\nexport { ControllerTypes } from './controller/controller.type';\nexport type { ControllerType } from './controller/controller.type';\nexport { DecisionOutcomeTypes } from './controller/decision-outcome.type';\nexport type { DecisionOutcomeType } from './controller/decision-outcome.type';\nexport { VaultErrorKindTypes } from './error/vault-error-kind.type';\nexport type { VaultErrorKindType } from './error/vault-error-kind.type';\nexport { VaultErrorNameTypes } from './error/vault-error-name.type';\nexport type { VaultErrorNameType } from './error/vault-error-name.type';\nexport { VaultErrorUsageKindTypes } from './error/vault-error-usage-kind.type';\nexport type { VaultErrorUsageKindType } from './error/vault-error-usage-kind.type';\nexport { EventBoundaryTypes } from './event/event-boundary.type';\nexport type { EventBoundaryType } from './event/event-boundary.type';\nexport { EventTypes } from './event/event.type';\nexport type { EventType } from './event/event.type';\nexport type { FilterFunction } from './function/filter-function.type';\nexport type { ReducerFunction } from './function/reducer-function.type';\nexport type { InterceptorStateType } from './interceptor-state.type';\nexport { LogLevelTypes } from './logging/log-level.type';\nexport type { LogLevelType } from './logging/log-level.type';\nexport { OperationTypes } from './operation.type';\nexport type { OperationType } from './operation.type';\nexport type { PipelinePersistValue } from './pipeline/pipeline-persist-value.type';\nexport type { PipelineUpstreamValue } from './pipeline/pipeline-upstream-value.type';\nexport type { PipelineValue } from './pipeline/pipeline-value.type';\nexport { ResolveTypes } from './resolve.type';\nexport type { ResolveType } from './resolve.type';\nexport type { CoreEmitStateResult } from './state/core-emit-state-result.type';\nexport type { DeferredFactory } from './state/deferred-factory.type';\nexport type { DeferredType } from './state/deferred.type';\nexport type { FinalState } from './state/final-state.type';\nexport { StateEmitTypes } from './state/state-emit.type';\nexport type { StateEmitType } from './state/state-emit.type';\nexport type { StateInputType } from './state/state-input.type';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > behavior > define-behavior-key.util.ts\n// Updated: 2026-03-28 10:46\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n Creates a normalized behavior key identifier used for behavior registration.\n \n A behavior key uniquely identifies a behavior within the Vault pipeline,\n * following the canonical format:\n \n `SDUX::<Domain>::<Name>`\n \n Both `domain` and `name` are normalized by:\n * - capitalizing the first character\n * - removing all non-alphanumeric characters\n \n This ensures consistent and predictable behavior keys for orchestration,\n * diagnostics, and tooling.\n \n @param domain - The logical domain or category of the behavior.\n * @param name - The specific behavior name within the domain.\n * @returns A normalized behavior key string.\n /\nexport function defineBehaviorKey(domain: string, name: string): string {\n return defineVaultKey('Behavior', domain, name);\n}\n\nexport function defineVaultKey(\n kind: 'Behavior' \| 'Controller',\n domain: string,\n name: string\n): string {\n const normalize = (s: string) =>\n s.charAt(0).toUpperCase() + s.slice(1).replace(/[^A-Za-z0-9]/g, '');\n\n return `SDUX::${kind}::${normalize(domain)}::${normalize(name)}`;\n}\n\n/\n Validates whether a string conforms to the Vault behavior key format.\n \n A valid behavior key must follow the structure:\n \n `SDUX::<Domain>::<Name>`\n \n Where `<Domain>` and `<Name>` begin with an uppercase character and contain\n * only alphanumeric characters.\n \n @param key - The behavior key string to validate.\n * @returns `true` if the key matches the required pattern; otherwise `false`.\n /\nexport function validateBehaviorKey(key: string): boolean {\n if (typeof key !== 'string') return false;\n\n const pattern =\n /^SDUX::(Behavior\|Controller)::[A-Z][A-Za-z0-9]::[A-Z][A-Za-z0-9]$/;\n return pattern.test(key);\n}\n","import {\n defineVaultKey,\n validateBehaviorKey\n} from '../behavior/define-behavior-key.util';\n\nexport function defineControllerKey(domain: string, name: string): string {\n return defineVaultKey('Controller', domain, name);\n}\n\nexport function validateControllerKey(key: string): boolean {\n return validateBehaviorKey(key);\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > deferred-factory > is-deferred-factory.util.ts\n// Updated: 2026-03-21 20:36\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\nimport { DeferredFactory } from '../../types/state/deferred-factory.type';\n\nexport function isDeferredFactory<T = unknown>(\n value: unknown\n): value is DeferredFactory<T> {\n return (\n !!value &&\n typeof value === 'object' &&\n // eslint-disable-next-line\n typeof (value as any).value === 'function'\n );\n}\n","import { VaultErrorShape } from '../../shapes/vault-error.shape';\n\n/\n Normalizes any thrown error into a canonical `VaultError` structure.\n \n This ensures that all errors—HTTP, runtime, string, or unknown—\n * are represented consistently throughout the Vault error pipeline.\n \n @param err - The raw thrown value.\n * @param featureCellKey - the origination of the error\n * @returns A fully normalized `VaultError`.\n /\nexport function createVaultError(\n err: unknown,\n featureCellKey: string\n): VaultErrorShape {\n const timestamp = Date.now();\n\n // -----------------------------------------\n // Standard JS Error\n // -----------------------------------------\n if (err instanceof Error) {\n return {\n message: err.message \|\| 'Unexpected error',\n details: err.stack,\n raw: err,\n timestamp,\n featureCellKey\n };\n }\n\n // -----------------------------------------\n // String error\n // -----------------------------------------\n if (typeof err === 'string') {\n return {\n message: err,\n details: err,\n raw: err,\n timestamp,\n featureCellKey\n };\n }\n\n // -----------------------------------------\n // Fallback: unknown error\n // -----------------------------------------\n return {\n message: 'Unexpected error',\n details: err,\n raw: err,\n timestamp,\n featureCellKey\n };\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > isolate-value > isolate-value.util.ts\n// Updated: 2026-04-07 15:49\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n\| Category \| Type / Example \| structuredClone behavior \| deepFreeze fallback behavior \| Isolated? \| Notes \|\n\| ------------------------ \| --------------------- \| ------------------------- \| ------------------------------------- \| ---------- \| ---------------------------------------------- \|\n\| Primitives \| number \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable by definition \|\n\| \| string \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| boolean \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| bigint \| Returned as-is \| Returned as-is \| ✅ Yes \| Immutable \|\n\| \| symbol \| Returned as-is \| Returned as-is \| ✅ Yes \| Identity preserved \|\n\| \| undefined \| Returned as-is \| Returned as-is \| ✅ Yes \| No mutation possible \|\n\| \| null \| Returned as-is \| Returned as-is \| ✅ Yes \| No mutation possible \|\n\| Plain Objects \| `{ a: 1 }` \| Deep cloned \| Deep cloned + frozen \| ✅ Yes \| Always returns new reference \|\n\| Arrays \| `[1,2,3]` \| Deep cloned \| Deep cloned + frozen \| ✅ Yes \| Structural mutation blocked \|\n\| Functions \| `() => {}` \| ❌ Throws \| Returned as-is \| ⚠️ Partial \| Cannot be cloned or frozen meaningfully \|\n\| Promises \| `Promise.resolve()` \| ❌ Throws \| Returned as-is \| ⚠️ Partial \| Identity preserved intentionally \|\n\| Dates \| `new Date()` \| Cloned \| Frozen original OR cloned+frozen \| ✅ Yes \| Time value preserved \|\n\| RegExp \| `/abc/g` \| Cloned \| Frozen original OR cloned+frozen \| ✅ Yes \| Pattern preserved \|\n\| Error \| `new Error()` \| Cloned (core fields only) \| Frozen original OR cloned+frozen \| ⚠️ Partial \| Custom props not guaranteed \|\n\| Map \| `new Map()` \| Deep cloned \| Same reference, frozen wrapper \| ⚠️ Partial \| `.set()` still works; internal slots preserved \|\n\| Set \| `new Set()` \| Deep cloned \| Same reference, frozen wrapper \| ⚠️ Partial \| `.add()` still works \|\n\| WeakMap \| `new WeakMap()` \| ❌ Throws \| Returned as-is \| ❌ No \| Cannot be cloned or frozen safely \|\n\| WeakSet \| `new WeakSet()` \| ❌ Throws \| Returned as-is \| ❌ No \| Cannot be isolated \|\n\| TypedArray \| `Uint8Array` \| Cloned \| Frozen \| ✅ Yes \| Buffer copied or locked \|\n\| ArrayBuffer \| `ArrayBuffer` \| Cloned \| Frozen \| ✅ Yes \| Memory isolated \|\n\| DataView \| `DataView` \| Cloned \| Frozen \| ✅ Yes \| Backing buffer safe \|\n\| Observable (RxJS) \| `new Observable()` \| ❌ Throws \| Same reference, frozen wrapper \| ⚠️ Partial \| Internal emissions mutable \|\n\| Class Instance \| `new Foo()` \| Prototype stripped \| Frozen instance \| ⚠️ Partial \| Methods lost on clone \|\n\| Object.create(null) \| null-proto object \| Cloned \| Deep cloned + frozen \| ✅ Yes \| Prototype normalized \|\n\| Cyclic Objects \| `{ self }` \| Cloned with cycles \| Deep cloned + frozen (cycle-safe) \| ✅ Yes \| WeakSet prevents recursion \|\n\| Getters / Setters \| `{ get x(){} }` \| Getter invoked \| Getter not invoked \| ⚠️ Partial \| Side effects possible \|\n\| Non-enumerable props \| defineProperty \| Dropped \| Preserved if fallback clone path used \| ⚠️ Partial \| Visibility differs \|\n\| Symbol-keyed props \| `{ [sym]: 1 }` \| Dropped \| Preserved if fallback clone path used \| ⚠️ Partial \| Symbols skipped by clone \|\n\| DOM Nodes \| `HTMLElement` \| ❌ Throws \| Same reference, frozen wrapper \| ❌ No \| Host object semantics \|\n\| Proxy (well-formed) \| `new Proxy()` \| Cloned \| Frozen target (if accessible) \| ⚠️ Partial \| Depends on handler \|\n\| Proxy (malicious) \| fake ownKeys \| ❌ Throws \| ❌ Throws \| ❌ No \| Engine invariant violation \|\n\| JSON-like data \| POJO graphs \| Deep cloned \| Deep cloned + frozen \| ✅ Yes \| Ideal use case \|\n\| Modules \| ES module namespace \| ❌ Throws \| Returned as-is \| ❌ No \| Immutable by spec \|\n\| Intl objects \| `Intl.DateTimeFormat` \| Cloned \| Frozen \| ⚠️ Partial \| Internal slots opaque \|\n\| Shared References \| `{a:x, b:x}` \| Preserved in clone \| Preserved in clone \| ✅ Yes \| Graph identity maintained \|\n\| Sparse Arrays \| `[ , , 3 ]` \| Preserved \| Preserved \| ✅ Yes \| Holes maintained \|\n\| Symbol Values \| `{ x: Symbol() }` \| Preserved \| Preserved \| ✅ Yes \| Value identity intact \|\n\| Mixed Graphs \| fn + object \| ❌ Partial \| Clone + preserve refs \| ⚠️ Partial \| Hybrid isolation \|\n\| Frozen Objects \| `Object.freeze(obj)` \| Cloned (unfrozen) \| Preserved frozen OR cloned+frozen \| ✅ Yes \| Freeze state not guaranteed \|\n\| Boxed Primitives \| `new Number(1)` \| Cloned \| Frozen \| ✅ Yes \| Unboxed behavior retained \|\n/\n\nfunction deepFreeze<T>(obj: T, seen = new WeakSet<object>()): T {\n if (obj === null \|\| typeof obj !== 'object') return obj;\n\n const o = obj as unknown as object;\n if (seen.has(o)) return obj;\n seen.add(o);\n\n if (!Object.isFrozen(o)) Object.freeze(o);\n\n for (const key of Reflect.ownKeys(o)) {\n const desc = Object.getOwnPropertyDescriptor(o, key);\n / istanbul ignore next -- impossible after Object.freeze due to Proxy invariants /\n if (!desc) continue;\n\n // Only recurse into data properties; do NOT invoke getters\n if ('value' in desc) {\n // eslint-disable-next-line\n deepFreeze((desc as PropertyDescriptor).value as any, seen);\n }\n }\n\n return obj;\n}\n\nexport const isolateValue = <T>(value: T): T => {\n if (value === null \|\| typeof value !== 'object') return value;\n\n if (Object.isFrozen(value)) return value;\n\n try {\n if (\n value instanceof Map \|\|\n value instanceof Set \|\|\n value instanceof WeakMap \|\|\n value instanceof WeakSet\n ) {\n try {\n return structuredClone(value);\n } catch {\n return deepFreeze(value); // ← IMPORTANT: same reference\n }\n }\n return structuredClone(value);\n } catch {\n const clone = Array.isArray(value)\n ? // eslint-disable-next-line @typescript-eslint/no-explicit-any\n [...(value as any)]\n : Object.assign(Object.create(Object.getPrototypeOf(value)), value);\n\n return deepFreeze(clone);\n }\n};\n","import { VAULT_CLEAR_STATE } from '../../constants/vault/vault-clear-state.constant';\nimport { VAULT_CONTINUE } from '../../constants/vault/vault-continue.constant';\nimport { VAULT_NOOP } from '../../constants/vault/vault-noop.constant';\nimport { StateInputShape } from '../../shapes/state/state-input.shape';\nimport { FinalState } from '../../types/state/final-state.type';\n\n/\n Indicates whether a final pipeline value represents a NOOP condition.\n \n @param current - The computed pipeline result.\n * @returns `true` if the value is the `VAULT_NOOP` sentinel.\n /\nexport const isVaultNoop = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_NOOP;\n};\n\nexport const isVaultClearState = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_CLEAR_STATE;\n};\n\nexport const isVaultContinue = <T>(current: FinalState<T>): boolean => {\n return current === VAULT_CONTINUE;\n};\n\n/\n Checks whether a value is exactly `null`.\n \n @param current - The value to check.\n * @returns `true` if the value is `null`.\n /\nexport const isNull = (current: unknown): current is null => current === null;\n\n/\n Checks whether a value is exactly `undefined`.\n \n @param current - The value to check.\n * @returns `true` if the value is `undefined`.\n /\nexport const isUndefined = (current: unknown): current is undefined =>\n current === undefined;\n\n/\n Determines whether a value is defined (not `undefined`).\n * Note: This intentionally does not exclude `null`.\n \n @param current - The value to check.\n * @returns `true` if the value is not `undefined`.\n /\nexport const isDefined = (current: unknown): boolean => !isUndefined(current);\n\n/\n Determines whether a value is nullish — meaning either `null` or `undefined`.\n \n @param current - The value to inspect.\n * @returns `true` for `null` or `undefined`, otherwise `false`.\n /\nexport const isNullish = (current: unknown): current is null \| undefined =>\n current == null;\n\nexport const isFunction = (\n value: unknown\n): // eslint-disable-next-line\nvalue is (...args: any[]) => unknown => typeof value === 'function';\n\nexport const isObject = (value: unknown): value is Record<string, unknown> =>\n typeof value === 'object' && value !== null;\n\nexport const isStateInputShape = <T>(\n value: unknown\n): value is StateInputShape<T> => {\n if (value === null \|\| typeof value !== 'object') return false;\n\n const v = value as Record<string, unknown>;\n\n const hasKnownKey = 'loading' in v \|\| 'value' in v \|\| 'error' in v;\n\n return hasKnownKey;\n};\n","export function isPromise<T = unknown>(value: unknown): value is Promise<T> {\n return (\n !!value &&\n (typeof value === 'object' \|\| typeof value === 'function') &&\n // eslint-disable-next-line\n typeof (value as any).then === 'function'\n );\n}\n","import { HttpResourceRefShape } from '../../shapes/http-resource-ref-shape.shape';\n\n/\n Type guard that determines whether a value is an `HttpResourceRef<T>`.\n \n An `HttpResourceRef` is a structured object produced by Angular’s\n * `HttpClient` resource APIs. It contains a standardized shape used by\n * Vault to detect and normalize resource-backed state transitions.\n \n This utility checks only for the presence of the canonical\n * `HttpResourceRef` fields (`value`, `isLoading`, `error`, `hasValue`)\n * and does not validate the internal content of those properties.\n \n @typeParam T - The resource value type.\n \n @param obj - The value to test.\n * @returns `true` if the value matches the structural shape of an\n * `HttpResourceRef<T>`, otherwise `false`.\n /\n// eslint-disable-next-line\nexport function isHttpResourceRef<T>(obj: any): obj is HttpResourceRefShape<T> {\n return !!(\n obj &&\n typeof obj === 'object' &&\n 'value' in obj &&\n 'isLoading' in obj &&\n 'error' in obj &&\n 'hasValue' in obj\n );\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > lib > utils > index.ts\n// Updated: 2026-03-24 09:59\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/ -----------------------------------------------------------\n * UTILITY FUNCTIONS (SAFE TO WILDCARD)\n * --------------------------------------------------------- /\nexport {\n defineBehaviorKey,\n validateBehaviorKey\n} from './behavior/define-behavior-key.util';\nexport {\n defineControllerKey,\n validateControllerKey\n} from './controller/define-controller-key.util';\nexport { isDeferredFactory } from './deferred-factory/is-deferred-factory.util';\nexport { DevMode } from './dev-mode/dev-mode.util';\nexport { isTestEnv } from './dev-mode/testing-environment.util';\nexport { createVaultError } from './error/create-vault-error.util';\nexport { isolateValue } from './isolate-value/isolate-value.util';\nexport {\n getVaultLogLevel,\n setVaultLogLevel,\n vaultDebug,\n vaultError,\n vaultLog,\n vaultWarn\n} from './logger/logger.util';\nexport {\n isDefined,\n isFunction,\n isNull,\n isNullish,\n isObject,\n isStateInputShape,\n isUndefined,\n isVaultClearState,\n isVaultContinue,\n isVaultNoop\n} from './logic/logic.utils';\nexport { isPromise } from './promise/is-promise.util';\nexport { isHttpResourceRef } from './resolve/is-http-resource.util';\nexport { safeStringify } from './safe-stringify/safe-stringify.util';\nexport { registerVersion } from './version/version.register';\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > shared > src > public-api.ts\n// Updated: 2026-03-23 16:55\n//\t Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or\n//\t cmd+alt+j (see .vscode/keybindings.json)\n// --- END AI MODEL FILE PATH ---\n\n/\n * Public API Surface of @sdux-vault/shared\n \n IMPORTANT:\n * - JSDoc is preserved only when using named exports.\n * - Avoid `export ` for public-facing interfaces, behaviors, and types.\n - Internal utilities may still use `export `.\n /\n\n/* -----------------------------------------------------------\n * INTENTIONAL SIDE EFFECTS\n * --------------------------------------------------------- /\n\n/\n This is to handle fluent api requirements for behaviors and controllers\n /\nimport './typings/global';\n\n/\n This is for version support in dev mode and tracking in the devtools\n /\nimport './lib/version/version.register';\n\n/ -----------------------------------------------------------\n * DOMAIN EXPORTS\n * --------------------------------------------------------- /\nexport from './lib/abstracts';\nexport * from './lib/config';\nexport * from './lib/constants';\nexport * from './lib/contexts';\nexport * from './lib/decorators';\nexport * from './lib/errors';\nexport * from './lib/interfaces';\nexport * from './lib/services';\nexport * from './lib/shapes';\nexport * from './lib/types';\nexport * from './lib/utils';\n","/*\n Generated bundle index. Do not edit.\n /\n\nexport from './public-api';\n"],"names":["_instance"],"mappings":"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"}

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@sdux-vault/shared",
-  "version": "0.0.10",
+  "version": "0.0.12",
   "license": "MIT",
   "repository": {
     "type": "git",

package/types/sdux-vault-shared.d.ts CHANGED Viewed

@@ -1395,6 +1395,46 @@ interface PersistBehaviorContract<T> extends BehaviorContract<T> {
     loadState(): PipelinePersistValue<T>;
 }
+/**
+ * Comparison function used by withDistinctUntilChanged to determine
+ * whether the new incoming value should be considered equal to the
+ * previously emitted value.
+ *
+ * @typeParam T - The value type being compared.
+ */
+type DistinctComparison<T> = (a: T, b: T) => boolean;
+declare const EventBoundaryTypes: {
+    readonly End: "end";
+    readonly Notification: "notification";
+    readonly Start: "start";
+    readonly Unknown: "unknown";
+};
+type EventBoundaryType = (typeof EventBoundaryTypes)[keyof typeof EventBoundaryTypes];
+declare const EventTypes: {
+    readonly Conductor: "conductor";
+    readonly Controller: "controller";
+    readonly Lifecycle: "lifecycle";
+    readonly Stage: "stage";
+    readonly Unknown: "unknown";
+};
+type EventType = (typeof EventTypes)[keyof typeof EventTypes];
+/**
+ * Represents the final UI-facing value flowing out of a FeatureCell.
+ *
+ * A `PipelineValue<T>` is the resolved form of state after all
+ * pipeline stages
+ *
+ * Unlike internal pipeline values, this UI-facing type never includes
+ *
+ * @typeParam T - The underlying state type maintained by the FeatureCell.
+ */
+type PipelineValue<T> = T | undefined;
+type FinalState<T> = PipelineUpstreamValue<T> | typeof VAULT_STOP;
 interface ReduceBehaviorContract<T> extends BehaviorContract<T> {
     /** Pipeline behavior type identifier for reducer-stage execution. */
     type: 'reduce';
@@ -1405,7 +1445,7 @@ interface ReduceBehaviorContract<T> extends BehaviorContract<T> {
      * @param reducer - A pure reducer function returning a new state value.
      * @returns The transformed state value.
      */
-    applyReducer(current: T, reducer: ReducerFunction<T>): T;
+    applyReducer(current: PipelineUpstreamValue<T>, reducer: ReducerFunction<T>): T;
 }
 interface ResolveBehaviorContract<T> extends BehaviorContract<T> {
@@ -1434,23 +1474,6 @@ interface ControllerClassContract<T = any> {
     installFluentApi?: <T>(cell: FeatureCellBaseShape<T>, behaviorConfigs: Map<string, unknown>) => void;
 }
-declare const EventBoundaryTypes: {
-    readonly End: "end";
-    readonly Notification: "notification";
-    readonly Start: "start";
-    readonly Unknown: "unknown";
-};
-type EventBoundaryType = (typeof EventBoundaryTypes)[keyof typeof EventBoundaryTypes];
-declare const EventTypes: {
-    readonly Conductor: "conductor";
-    readonly Controller: "controller";
-    readonly Lifecycle: "lifecycle";
-    readonly Stage: "stage";
-    readonly Unknown: "unknown";
-};
-type EventType = (typeof EventTypes)[keyof typeof EventTypes];
 /**
  * Describes the shape of a pipeline event emitted during FeatureCell execution.
  * This interface defines the core event contract used for diagnostics, Devtools inspection, and lifecycle tracking.
@@ -1600,29 +1623,6 @@ interface SDuXShape {
     };
 }
-/**
- * Comparison function used by withDistinctUntilChanged to determine
- * whether the new incoming value should be considered equal to the
- * previously emitted value.
- *
- * @typeParam T - The value type being compared.
- */
-type DistinctComparison<T> = (a: T, b: T) => boolean;
-/**
- * Represents the final UI-facing value flowing out of a FeatureCell.
- *
- * A `PipelineValue<T>` is the resolved form of state after all
- * pipeline stages
- *
- * Unlike internal pipeline values, this UI-facing type never includes
- *
- * @typeParam T - The underlying state type maintained by the FeatureCell.
- */
-type PipelineValue<T> = T | undefined;
-type FinalState<T> = PipelineUpstreamValue<T> | typeof VAULT_STOP;
 /**
  * Creates a normalized behavior key identifier used for behavior registration.
  *