@sdux-vault/shared 0.0.10

package/fesm2022/sdux-vault-shared.mjs

@@ -0,0 +1,1256 @@
+import { BehaviorSubject, Subscription, tap } from 'rxjs';
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > typings > global.d.ts
+// Updated: 2026-03-24 12:38
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > dev-mode > testing-environment.util.ts
+// Updated: 2026-03-09 14:47
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const isTestEnv = {
+    get active() {
+        return (
+        // eslint-disable-next-line
+        typeof globalThis.jasmine !== 'undefined' ||
+            // istanbul ignore next
+            // eslint-disable-next-line
+            typeof globalThis.jest !== 'undefined' ||
+            // istanbul ignore next
+            // eslint-disable-next-line
+            typeof globalThis.vitest !== 'undefined');
+    }
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > dev-mode > dev-mode.util.ts
+// Updated: 2026-03-09 14:46
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+let devMode = null;
+const DevMode = {
+    get active() {
+        return devMode === true;
+    },
+    setDevMode(isDevMode) {
+        if (devMode !== null && !isTestEnv.active) {
+            throw new Error('[vault] DevMode has already been initialized.');
+        }
+        devMode = isDevMode;
+    }
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > version > version.register.ts
+// Updated: 2026-03-03 07:47
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const registerVersion = (packageName, version) => {
+    if (!DevMode.active || typeof globalThis === 'undefined')
+        return;
+    const sdux = (globalThis.sdux ??= {});
+    const debug = (sdux.debugWidget ??= {});
+    const versions = (debug.versions ??= {});
+    if (versions[packageName] === version)
+        return;
+    versions[packageName] = version;
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > version > version.register.ts
+// Updated: 2026-03-03 08:12
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const SDUX_PACKAGE = '@sdux-vault/shared';
+const SDUX_VERSION = '0.0.10';
+registerVersion(SDUX_PACKAGE, SDUX_VERSION);
+
+/**
+ * Runtime-safe registry of all behavior types.
+ *
+ * This object acts as an enum substitute without introducing JavaScript enum
+ * overhead.
+ * Values are string literals preserved at runtime and suitable for
+ * switch statements, comparisons, and pipeline classification.
+ * Each key maps 1:1 to its string literal value.
+ * The structure is fully tree-shakable and safely inferable by TypeScript.
+ */
+const BehaviorTypes = {
+    CoreAfterTap: 'coreAfterTap',
+    CoreBeforeTap: 'coreBeforeTap',
+    ReplayGlobalError: 'replayGlobalError',
+    CoreError: 'coreError',
+    CoreErrorCallback: 'coreErrorCallback',
+    CoreState: 'coreState',
+    DevPipelineObserver: 'devPipelineObserver',
+    Encrypt: 'encrypt',
+    CoreEmitState: 'coreEmitState',
+    ErrorTransform: 'errorTransform',
+    Extension: 'extension',
+    Filter: 'filter',
+    FromObservable: 'fromObservable',
+    FromPromise: 'fromPromise',
+    FromStream: 'fromStream',
+    Interceptor: 'interceptor',
+    Merge: 'merge',
+    Operator: 'operator',
+    Persist: 'persist',
+    Reduce: 'reduce',
+    Resolve: 'resolve',
+    StepwiseFilter: 'stepwiseFilter',
+    StepwiseReducer: 'stepwiseReducer',
+    StepwiseResolve: 'stepwiseResolve'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > logging > console.type.ts
+// Updated: 2026-03-21 21:00
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/**
+ * Defines the allowable verbosity levels for Vault logging.
+ *
+ * A `LogLevel` controls the amount of diagnostic output emitted by the
+ * vault’s internal debug, warning, or error channels. Higher levels
+ * produce more detailed logs, while lower levels suppress output.
+ *
+ * - `'off'`   — no logs are emitted
+ * - `'error'` — only errors are logged
+ * - `'warn'`  — warnings and errors are logged
+ * - `'log'`   — standard log events, warnings, and errors are logged
+ * - `'debug'` — all debug-level information is emitted
+ */
+const ConsoleTypes = {
+    Error: 'error',
+    Warn: 'warn',
+    Log: 'log',
+    Debug: 'debug'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > logging > log-level.type.ts
+// Updated: 2026-03-21 21:00
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/**
+ * Defines the allowable verbosity levels for Vault logging.
+ *
+ * A `LogLevel` controls the amount of diagnostic output emitted by the
+ * vault’s internal debug, warning, or error channels. Higher levels
+ * produce more detailed logs, while lower levels suppress output.
+ *
+ * - `'off'`   — no logs are emitted
+ * - `'error'` — only errors are logged
+ * - `'warn'`  — warnings and errors are logged
+ * - `'log'`   — standard log events, warnings, and errors are logged
+ * - `'debug'` — all debug-level information is emitted
+ */
+const LogLevelTypes = {
+    Off: 'off',
+    Error: 'error',
+    Warn: 'warn',
+    Log: 'log',
+    Debug: 'debug'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > logger > logger.util.ts
+// Updated: 2026-03-23 16:50
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+let _logLevel = LogLevelTypes.Off;
+/**
+ * Prefix applied to all vault-related console output. Used to keep log
+ * messages consistently identifiable across all log levels.
+ */
+const LOG_PREFIX = '[vault]';
+// eslint-disable-next-line
+function push(level, ...args) {
+    const logLevel = getVaultLogLevel();
+    if (logLevel === LogLevelTypes.Off)
+        return;
+    const levels = [ConsoleTypes.Error, ConsoleTypes.Warn, ConsoleTypes.Log, ConsoleTypes.Debug];
+    const allowed = levels.indexOf(level) <= levels.indexOf(logLevel);
+    if (!allowed)
+        return;
+    // eslint-disable-next-line
+    console[level](LOG_PREFIX, ...args);
+}
+/**
+ * Emits an `error`-level Vault log message.
+ *
+ * @param args - Console arguments to log.
+ */
+// eslint-disable-next-line
+const vaultError = (...args) => push('error', ...args);
+/**
+ * Emits a `warn`-level Vault log message.
+ *
+ * @param args - Console arguments to log.
+ */
+// eslint-disable-next-line
+const vaultWarn = (...args) => push('warn', ...args);
+/**
+ * Emits a `log`-level Vault log message.
+ *
+ * @param args - Console arguments to log.
+ */
+// eslint-disable-next-line
+const vaultLog = (...args) => push('log', ...args);
+/**
+ * Emits a `debug`-level Vault log message.
+ *
+ * @param args - Console arguments to log.
+ */
+// eslint-disable-next-line
+const vaultDebug = (...args) => push('debug', ...args);
+function setVaultLogLevel(level) {
+    _logLevel = level ?? 'off';
+}
+function getVaultLogLevel() {
+    return _logLevel;
+}
+
+class AbstractErrorCallbackBehavior {
+    behaviorCtx;
+    /** Indicates that this error behavior is critical and always executed. */
+    critical;
+    /** Unique identifier for this behavior instance. */
+    key;
+    /** Behavior type for orchestrator registration. */
+    type = BehaviorTypes.CoreErrorCallback;
+    /**
+     * Creates a new abstract error behavior instance.
+     *
+     * @param key - Unique behavior identifier supplied by the behavior factory.
+     * @param behaviorCtx - Behavior class context providing injector access and extensibility hooks.
+     */
+    constructor(key, behaviorCtx) {
+        this.behaviorCtx = behaviorCtx;
+        this.key = key;
+    }
+    /**
+     * Lifecycle hook invoked when the behavior instance is destroyed.
+     *
+     * Error behaviors do not allocate runtime resources and therefore require
+     * no cleanup. A diagnostic entry is logged for lifecycle visibility.
+     */
+    destroy() {
+        vaultWarn(`${this.key} - destroy "noop"`);
+    }
+    /**
+     * Lifecycle hook invoked when the behavior instance is reset.
+     *
+     * Error behaviors hold no internal state, making this a no-operation.
+     * The hook ensures lifecycle uniformity across all behaviors.
+     */
+    reset() {
+        vaultWarn(`${this.key} - reset "noop"`);
+    }
+}
+
+/**
+ * Abstract base behavior for transforming errors during pipeline execution.
+ * This class defines the contract and lifecycle hooks required for error transformation behaviors.
+ *
+ * --RelatedStart--
+ * ErrorTransformBehaviorContract
+ * BehaviorClassContext
+ * StateSnapshotShape
+ * VaultErrorShape
+ * --RelatedEnd--
+ */
+class AbstractErrorTransformBehavior {
+    behaviorCtx;
+    /**
+     * Indicates that this error transform behavior is critical and always executed.
+     */
+    critical;
+    /**
+     * Unique identifier for this behavior instance.
+     */
+    key;
+    /**
+     * Behavior type identifier used for orchestrator registration.
+     */
+    type = BehaviorTypes.ErrorTransform;
+    /**
+     * Creates a new abstract error transform behavior instance.
+     *
+     * @param key Unique behavior identifier supplied by the factory.
+     * @param behaviorCtx Behavior class context providing configuration and hooks.
+     */
+    constructor(key, behaviorCtx) {
+        this.behaviorCtx = behaviorCtx;
+        this.key = key;
+    }
+    /**
+     * Lifecycle hook invoked when the behavior instance is destroyed.
+     */
+    destroy() {
+        vaultWarn(`${this.key} - destroy "noop"`);
+    }
+    /**
+     * Lifecycle hook invoked when the behavior instance is reset.
+     */
+    reset() {
+        vaultWarn(`${this.key} - reset "noop"`);
+    }
+}
+
+/**
+ * Safely converts an arbitrary value into a JSON string representation.
+ *
+ * This function wraps `JSON.stringify` with enhanced handling for non-serializable
+ * values, including:
+ * - functions
+ * - `Error` objects
+ * - `Map` and `Set` instances
+ * - circular references
+ *
+ * If serialization fails for any reason, a fallback string `"[unserializable]"`
+ * is returned. The replacer ensures stable and predictable stringification for
+ * use in logging and debugging utilities.
+ *
+ * @param value - The value to stringify safely.
+ * @returns A JSON-formatted string or a fallback indicator.
+ */
+function safeStringify(value) {
+    try {
+        return JSON.stringify(value, jsonSafeReplacer, 2);
+    }
+    catch {
+        return '[unserializable]';
+    }
+}
+/**
+ * Replacer function used by `safeStringify` to handle values that are normally
+ * not serializable via `JSON.stringify`.
+ *
+ * It converts functions, errors, `Map`, and `Set` values into safe structures
+ * and detects circular references. If a value cannot be serialized, a fallback
+ * marker string is returned.
+ *
+ * @param _key - The property key being processed (unused).
+ * @param val - The value associated with the key.
+ * @returns A serializable representation of the value.
+ */
+function jsonSafeReplacer(_key, val) {
+    if (typeof val === 'function')
+        return '[Function]';
+    if (val instanceof Error)
+        return { message: val.message, stack: val.stack };
+    if (val instanceof Map)
+        return { map: Array.from(val.entries()) };
+    if (val instanceof Set)
+        return { set: Array.from(val.values()) };
+    // Avoid circular references
+    try {
+        JSON.stringify(val);
+        return val;
+    }
+    catch {
+        return '[Circular]';
+    }
+}
+
+/** ------------------------------------------
+ * INTERNAL CLASS (NOT EXPORTED)
+ * ------------------------------------------ */
+class VaultPrivateErrorClass {
+    #error$ = new BehaviorSubject(null);
+    constructor() {
+        vaultDebug('[VaultPrivateErrorService] initialized (singleton instance created)');
+    }
+    setError(error) {
+        vaultDebug(`[VaultPrivateErrorService] setError() ${safeStringify(error)}`);
+        this.#error$.next(error);
+    }
+    getError() {
+        vaultDebug('[VaultPrivateErrorService] getError() → observable subscribed');
+        return this.#error$.asObservable();
+    }
+    clear() {
+        vaultDebug('[VaultPrivateErrorService] clear() → error reset to null');
+        this.#error$.next(null);
+    }
+}
+/** ------------------------------------------
+ * SINGLETON FACTORY (EXPORTED)
+ * ------------------------------------------ */
+let _instance$1 = null;
+function VaultPrivateErrorService() {
+    if (!_instance$1) {
+        vaultDebug('[VaultPrivateErrorService] creating new singleton instance');
+        _instance$1 = new VaultPrivateErrorClass();
+    }
+    else {
+        vaultDebug('[VaultPrivateErrorService] returning existing singleton instance');
+    }
+    return _instance$1;
+}
+
+class VaultErrorServiceClass {
+    #privateVaultErrorService = VaultPrivateErrorService();
+    #error$ = new BehaviorSubject(null);
+    #hasErrorState = false;
+    /** Track internal subscription for cleanup */
+    #subscription = new Subscription();
+    /** Public observable error stream */
+    error$ = this.#error$.asObservable();
+    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) => {
+            vaultDebug(`[VaultErrorService] Received error update from private service: ${err ? err.message : 'null'}`);
+            this.#hasErrorState = !!err;
+            this.#error$.next(err);
+        });
+        this.#subscription.add(sub);
+    }
+    get hasError() {
+        return this.#hasErrorState;
+    }
+    clear() {
+        vaultDebug('[VaultErrorService] Clearing current error.');
+        this.#privateVaultErrorService.clear();
+    }
+}
+// --------------------------------
+// SINGLETON FACTORY (EXPORTED)
+// --------------------------------
+let _instance = null;
+function VaultErrorService() {
+    if (!_instance) {
+        vaultDebug('[VaultErrorService] Creating new singleton instance.');
+        _instance = new VaultErrorServiceClass();
+    }
+    return _instance;
+}
+
+class AbstractActiveController {
+    ctx;
+    key;
+    critical = false;
+    hasError = false;
+    traceId = null;
+    #subscription;
+    constructor(key, ctx) {
+        this.ctx = ctx;
+        this.key = key;
+        this.#subscription = VaultErrorService()
+            .error$.pipe(tap((error) => {
+            vaultDebug(`${this.key} VaultErrorService dispatched event. Raw event: ${safeStringify(error)}.`);
+            const newValue = error != null;
+            vaultDebug(`${this.key} New transformed error value: "${newValue}".`);
+            const revoteDecision = newValue !== this.hasError && this.traceId !== undefined;
+            vaultDebug(`${this.key} Revote Decision: ${revoteDecision}. Factors.  NewValue: ${newValue} HasError: ${this.hasError} TraceId: ${this.traceId} Rubric: 'newValue !== this.hasError && this.traceId !== undefined'`);
+            this.hasError = newValue;
+            vaultDebug(`${this.key} this.hasError replace with newValue: "${this.hasError}".`);
+            vaultDebug(`${this.key} onExternalTrigger dispatchd with: "${newValue}".`);
+            this.onExternalTrigger(newValue);
+            if (revoteDecision) {
+                vaultDebug(`${this.key} Revote Requesed with traceId: "${this.traceId}".`);
+                this.ctx.requestRevote(this.traceId);
+            }
+        }))
+            .subscribe();
+    }
+    /** Child classes override to react to external error toggles */
+    //istanbul ignore next
+    onExternalTrigger(_newErrorState) { }
+    destroy() {
+        this.#subscription.unsubscribe();
+        vaultWarn(`${this.key} - destroy`);
+    }
+    reset() {
+        vaultWarn(`${this.key} - reset "noop"`);
+    }
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > abstracts > index.ts
+// Updated: 2026-03-23 17:27
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * Abstracts
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > config > index.ts
+// Updated: 2026-03-23 16:54
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > constants > behavior-meta.constant.ts
+// Updated: 2026-03-28 14:09
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const BEHAVIOR_META = Symbol.for('BEHAVIOR_META');
+
+const CONTROLLER_META = Symbol.for('CONTROLLER_META');
+
+// --- AI Model File Path ---
+// libs > shared > src > lib > constants > dev-tools > devtools-aggregate-key.constant.ts
+/**
+ * String token used to uniquely identify the DevTools Aggregate FeatureCell.
+ *
+ * This key is referenced by the DevTools service, monitor utilities,
+ * and the router configuration to ensure all DevTools-related state
+ * is consistently mapped to the same FeatureCell instance.
+ *
+ * The value is stable across versions to maintain compatibility with
+ * external tools such as the Chrome DevTools extension.
+ */
+const DEVTOOLS_AGGREGATE_KEY_CONSTANT = 'vault::devtools::aggregate:feature::cell';
+
+// --- AI Model File Path ---
+// libs > shared > src > lib > constants > dev-tools > devtools-logging-key.constant.ts
+/**
+ * String token used to uniquely identify the DevTools Logging FeatureCell.
+ *
+ * This key is referenced by the DevTools service, monitor utilities,
+ * and the router configuration to ensure all DevTools-related state
+ * is consistently mapped to the same FeatureCell instance.
+ *
+ * The value is stable across versions to maintain compatibility with
+ * external tools such as the Chrome DevTools extension.
+ */
+const DEVTOOLS_LOGGING_KEY_CONSTANT = 'vault::devtools::logging::feature::cell';
+
+const VAULT_CLEAR_STATE = Symbol.for('VAULT_CLEAR_STATE');
+
+const VAULT_CONTINUE = Symbol.for('VAULT_CONTINUE');
+
+const VAULT_NOOP = Symbol.for('VAULT_NOOP');
+
+const VAULT_STOP = Symbol.for('VAULT_STOP');
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > constants > public-api.ts
+// Updated: 2026-03-23 18:48
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * META + DECORATORS
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > contexts > index.ts
+// Updated: 2026-03-23 17:31
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+
+// vault-behavior.decorator.ts
+/**
+ * Decorator that registers a class as an Vault behavior.
+ *
+ * The `VaultBehavior` decorator attaches the provided `BehaviorMeta`
+ * definition to the target constructor, making the behavior discoverable by
+ * the orchestrator during pipeline initialization. Metadata fields such as
+ * `type`, `key`, and `critical` are also mirrored onto static properties of
+ * the decorated class to support lightweight runtime introspection.
+ *
+ * This decorator does not modify method logic or structure; it only assigns
+ * metadata required for orchestrator classification and behavior lifecycle
+ * management.
+ *
+ * @param meta - Metadata describing the behavior’s category, unique key, and
+ *               criticality within the pipeline.
+ * @returns A class decorator that applies behavior metadata to the target.
+ */
+function VaultBehavior(meta) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function (target) {
+        // Attach full metadata for the orchestrator
+        target[BEHAVIOR_META] = meta;
+        // Also mirror some fields onto static props for convenience
+        if (meta.type !== undefined) {
+            target.type = meta.type;
+        }
+        if (meta.key !== undefined) {
+            target.key = meta.key;
+        }
+        if (meta.critical !== undefined) {
+            target.critical = meta.critical;
+        }
+        if (meta.resolveType !== undefined) {
+            target.resolveType = meta.resolveType;
+        }
+        if (meta.wantsConfig !== undefined) {
+            target.wantsConfig = meta.wantsConfig;
+        }
+        else {
+            target.wantsConfig = false;
+        }
+        if (meta.configKey !== undefined) {
+            target.configKey = meta.configKey;
+        }
+        if (meta.needsLicense !== undefined) {
+            target.needsLicense = meta.needsLicense;
+        }
+        else {
+            target.needsLicense = false;
+        }
+        if (meta.licenseId !== undefined) {
+            target.licenseId = meta.licenseId;
+        }
+    };
+}
+
+// vault-behavior.decorator.ts
+function VaultController(meta) {
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    return function (target) {
+        // Attach full metadata for the orchestrator
+        target[CONTROLLER_META] = meta;
+        // Also mirror some fields onto static props for convenience
+        if (meta.type !== undefined) {
+            target.type = meta.type;
+        }
+        if (meta.key !== undefined) {
+            target.key = meta.key;
+        }
+        if (meta.critical !== undefined) {
+            target.critical = meta.critical;
+        }
+        if (meta.wantsConfig !== undefined) {
+            target.wantsConfig = meta.wantsConfig;
+        }
+        else {
+            target.wantsConfig = false;
+        }
+        if (meta.configKey !== undefined) {
+            target.configKey = meta.configKey;
+        }
+        if (meta.needsLicense !== undefined) {
+            target.needsLicense = meta.needsLicense;
+        }
+        else {
+            target.needsLicense = false;
+        }
+        if (meta.licenseId !== undefined) {
+            target.licenseId = meta.licenseId;
+        }
+    };
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > decorators > index.ts
+// Updated: 2026-03-23 18:29
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * META + DECORATORS
+ * --------------------------------------------------------- */
+
+const VaultErrorKindTypes = {
+    Usage: 'VaultErrorUsage',
+    VaultError: 'VaultError'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > error > vault-error-name.type.ts
+// Updated: 2026-03-12 11:57
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const VaultErrorNameTypes = {
+    EncryptionIntegrity: 'VaultErrorEncryptionIntegrity',
+    License: 'VaultErrorLicense',
+    Usage: 'VaultErrorUsage',
+    VaultError: 'VaultError'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > errors > vault-error.ts
+// Updated: 2026-03-12 12:08
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+class VaultError extends Error {
+    kind;
+    constructor(message, name = VaultErrorNameTypes.VaultError, kind = VaultErrorKindTypes.VaultError) {
+        super(message);
+        this.name = name;
+        this.kind = kind;
+        // Required for proper instanceof checks in TS / ES5 targets
+        Object.setPrototypeOf(this, new.target.prototype);
+        // Optional but nice: clean stack trace
+        // eslint-disable-next-line
+        const anyError = Error;
+        if (typeof anyError.captureStackTrace === 'function') {
+            anyError.captureStackTrace(this, new.target);
+        }
+    }
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > errors > vault-error.encryption.integrity.ts
+// Updated: 2026-03-12
+// --- END AI MODEL FILE PATH ---
+/**
+ * Thrown when encrypted payload integrity verification fails.
+ *
+ * This occurs when AES-GCM authentication fails during decryption.
+ * Causes may include:
+ *
+ * - Tampered ciphertext
+ * - Modified IV
+ * - Incorrect encryption key
+ * - Corrupted storage payload
+ *
+ * AES-GCM provides authenticated encryption, so any modification to the
+ * encrypted envelope will cause the WebCrypto decrypt operation to throw.
+ */
+class VaultEncryptionIntegrityError extends VaultError {
+    constructor() {
+        const message = `Encrypted snapshot failed integrity verification.
+
+The encrypted payload could not be authenticated during AES-GCM decryption.
+
+Possible causes:
+
+• The stored ciphertext has been tampered with
+• The stored initialization vector (IV) was modified
+• The encryption key does not match the original key
+• The stored payload is corrupted
+
+Vault refuses to restore state from unauthenticated encrypted data.`;
+        super(message, VaultErrorNameTypes.EncryptionIntegrity);
+    }
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > error > vault-error-usage-kind.type.ts
+// Updated: 2026-03-12 11:57
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const VaultErrorUsageKindTypes = {
+    Encryption: 'VaultErrorEncryption',
+    License: 'VaultErrorLicense',
+    Promise: 'VaultErrorUsagePromise',
+    PromiseFactoryRequired: 'VaultErrorUsagePromiseFactoryRequired',
+    Usage: 'VaultErrorUsage'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > errors > vault-error.license.ts
+// Updated: 2026-03-12 11:56
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+class VaultLicenseError extends VaultError {
+    constructor(message, kind = VaultErrorUsageKindTypes.License) {
+        super(message, VaultErrorNameTypes.License, kind);
+    }
+}
+
+class VaultUsageError extends VaultError {
+    constructor(message, kind = VaultErrorUsageKindTypes.Usage) {
+        super(message, VaultErrorNameTypes.Usage, kind);
+    }
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > errors > vault-error.usage.promise.ts
+// Updated: 2026-03-12 12:01
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+class VaultUsagePromiseError extends VaultUsageError {
+    constructor() {
+        const message = `Invalid incoming value: Promise detected.
+
+Promises are eager and may resolve or reject before entering the Vault pipeline.
+
+Use the following instead  a DeferredFactory value
+
+This guarantees the promise is created and executed inside the pipeline.`;
+        super(message, VaultErrorUsageKindTypes.Promise);
+    }
+}
+
+class VaultUsagePromiseFactoryRequiredError extends VaultUsageError {
+    constructor() {
+        const message = `Invalid usage of Promise-based state API.
+
+You called a Promise-specific method (replaceState / mergeState),
+but did not provide a function that creates a Promise.
+
+Expected:
+• () => Promise<T>
+
+Received:
+• A non-function value
+
+Promises are eager and may resolve or reject before entering the Vault pipeline.
+
+Always wrap promises in a function so they are created and executed
+inside the pipeline.`;
+        super(message, VaultErrorUsageKindTypes.PromiseFactoryRequired);
+    }
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > errors > index.ts
+// Updated: 2026-03-23 17:21
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * ERRORS
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > interfaces > index.ts
+// Updated: 2026-03-23 18:45
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+
+/* -----------------------------------------------------------
+ * SERVICES
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > shapes > index.ts
+// Updated: 2026-03-23 18:42
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+
+const ControllerMessageTypes = {
+    Attempt: 'attempt',
+    Failure: 'failure',
+    Finalize: 'Finalize Pipeline',
+    Success: 'success',
+    Vote: 'vote' // mostly internal
+};
+
+const ControllerVotes = {
+    Abstain: 'abstain',
+    Abort: 'abort',
+    Deny: 'deny'
+};
+
+const ControllerTypes = {
+    CoreAbstain: 'coreAbstain',
+    Error: 'error',
+    License: 'license',
+    Policy: 'policy',
+    ReplayGlobalError: 'replayGlobalError',
+    Stepwise: 'stepwise'
+};
+
+const DecisionOutcomeTypes = {
+    Abort: 'abort',
+    Abstain: 'abstain',
+    Deny: 'deny'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > event > event-boundary.type.ts
+// Updated: 2026-03-10 09:56
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const EventBoundaryTypes = {
+    End: 'end',
+    Notification: 'notification',
+    Start: 'start',
+    Unknown: 'unknown'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > event > event.type.ts
+// Updated: 2026-03-10 09:56
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+const EventTypes = {
+    Conductor: 'conductor',
+    Controller: 'controller',
+    Lifecycle: 'lifecycle',
+    Stage: 'stage',
+    Unknown: 'unknown'
+};
+
+const OperationTypes = {
+    Merge: 'merge',
+    Replace: 'replace',
+    Initialize: 'initialize'
+};
+
+/**
+ * Enumerates the available resolve strategy identifiers used by resolve
+ * behaviors. These identifiers indicate how a FeatureCell obtains its initial
+ * and subsequent state values during the resolve stage of the pipeline.
+ *
+ * - `Value` — Resolve from a synchronous, in-memory value.
+ * - `HttpResource` — Resolve using an HTTP-driven resource behavior.
+ * - `Observable` — Resolve from an observable stream source.
+ * - `Promise` — Resolve from a promise source.
+ */
+const ResolveTypes = {
+    HttpResource: 'http-resource',
+    Observable: 'observable',
+    Promise: 'promise',
+    Value: 'value'
+};
+
+const StateEmitTypes = {
+    IncomingPipeline: 'Incoming Pipeline',
+    FinalizePipeline: 'Finalize Pipeline',
+    PipelineError: 'Pipeline Error',
+    PipelineDestroy: 'Pipeline Destroy',
+    PipelineReset: 'Pipeline Reset',
+    AbortController: 'Abort Controller',
+    DenyController: 'Deny Controller'
+};
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > types > index.ts
+// Updated: 2026-03-23 18:51
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * TYPES (USER-FACING)
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > behavior > define-behavior-key.util.ts
+// Updated: 2026-03-28 10:46
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/**
+ * Creates a normalized behavior key identifier used for behavior registration.
+ *
+ * A behavior key uniquely identifies a behavior within the Vault pipeline,
+ * following the canonical format:
+ *
+ * `SDUX::<Domain>::<Name>`
+ *
+ * Both `domain` and `name` are normalized by:
+ * - capitalizing the first character
+ * - removing all non-alphanumeric characters
+ *
+ * This ensures consistent and predictable behavior keys for orchestration,
+ * diagnostics, and tooling.
+ *
+ * @param domain - The logical domain or category of the behavior.
+ * @param name - The specific behavior name within the domain.
+ * @returns A normalized behavior key string.
+ */
+function defineBehaviorKey(domain, name) {
+    return defineVaultKey('Behavior', domain, name);
+}
+function defineVaultKey(kind, domain, name) {
+    const normalize = (s) => s.charAt(0).toUpperCase() + s.slice(1).replace(/[^A-Za-z0-9]/g, '');
+    return `SDUX::${kind}::${normalize(domain)}::${normalize(name)}`;
+}
+/**
+ * Validates whether a string conforms to the Vault behavior key format.
+ *
+ * A valid behavior key must follow the structure:
+ *
+ * `SDUX::<Domain>::<Name>`
+ *
+ * Where `<Domain>` and `<Name>` begin with an uppercase character and contain
+ * only alphanumeric characters.
+ *
+ * @param key - The behavior key string to validate.
+ * @returns `true` if the key matches the required pattern; otherwise `false`.
+ */
+function validateBehaviorKey(key) {
+    if (typeof key !== 'string')
+        return false;
+    const pattern = /^SDUX::(Behavior|Controller)::[A-Z][A-Za-z0-9]*::[A-Z][A-Za-z0-9]*$/;
+    return pattern.test(key);
+}
+
+function defineControllerKey(domain, name) {
+    return defineVaultKey('Controller', domain, name);
+}
+function validateControllerKey(key) {
+    return validateBehaviorKey(key);
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > deferred-factory > is-deferred-factory.util.ts
+// Updated: 2026-03-21 20:36
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 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';
+}
+
+/**
+ * Normalizes any thrown error into a canonical `VaultError` structure.
+ *
+ * This ensures that all errors—HTTP, runtime, string, or unknown—
+ * are represented consistently throughout the Vault error pipeline.
+ *
+ * @param err - The raw thrown value.
+ * @param featureCellKey - the origination of the error
+ * @returns A fully normalized `VaultError`.
+ */
+function createVaultError(err, featureCellKey) {
+    const timestamp = Date.now();
+    // -----------------------------------------
+    // Standard JS Error
+    // -----------------------------------------
+    if (err instanceof Error) {
+        return {
+            message: err.message || 'Unexpected error',
+            details: err.stack,
+            raw: err,
+            timestamp,
+            featureCellKey
+        };
+    }
+    // -----------------------------------------
+    // String error
+    // -----------------------------------------
+    if (typeof err === 'string') {
+        return {
+            message: err,
+            details: err,
+            raw: err,
+            timestamp,
+            featureCellKey
+        };
+    }
+    // -----------------------------------------
+    // Fallback: unknown error
+    // -----------------------------------------
+    return {
+        message: 'Unexpected error',
+        details: err,
+        raw: err,
+        timestamp,
+        featureCellKey
+    };
+}
+
+/*
+| 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         |
+*/
+function deepFreeze(obj, seen = new WeakSet()) {
+    if (obj === null || typeof obj !== 'object')
+        return obj;
+    const o = obj;
+    if (seen.has(o))
+        return obj;
+    seen.add(o);
+    if (!Object.isFrozen(o))
+        Object.freeze(o);
+    for (const key of Reflect.ownKeys(o)) {
+        const desc = Object.getOwnPropertyDescriptor(o, key);
+        /* istanbul ignore next -- impossible after Object.freeze due to Proxy invariants */
+        if (!desc)
+            continue;
+        // Only recurse into data properties; do NOT invoke getters
+        if ('value' in desc) {
+            // eslint-disable-next-line
+            deepFreeze(desc.value, seen);
+        }
+    }
+    return obj;
+}
+const isolateValue = (value) => {
+    if (value === null || typeof value !== 'object')
+        return value;
+    try {
+        // Works even if structuredClone is missing: ReferenceError is caught
+        return structuredClone(value);
+    }
+    catch {
+        return deepFreeze(value);
+    }
+};
+
+/**
+ * Indicates whether a final pipeline value represents a NOOP condition.
+ *
+ * @param current - The computed pipeline result.
+ * @returns `true` if the value is the `VAULT_NOOP` sentinel.
+ */
+const isVaultNoop = (current) => {
+    return current === VAULT_NOOP;
+};
+const isVaultClearState = (current) => {
+    return current === VAULT_CLEAR_STATE;
+};
+const isVaultContinue = (current) => {
+    return current === VAULT_CONTINUE;
+};
+/**
+ * Checks whether a value is exactly `null`.
+ *
+ * @param current - The value to check.
+ * @returns `true` if the value is `null`.
+ */
+const isNull = (current) => current === null;
+/**
+ * Checks whether a value is exactly `undefined`.
+ *
+ * @param current - The value to check.
+ * @returns `true` if the value is `undefined`.
+ */
+const isUndefined = (current) => current === undefined;
+/**
+ * Determines whether a value is defined (not `undefined`).
+ * Note: This intentionally does *not* exclude `null`.
+ *
+ * @param current - The value to check.
+ * @returns `true` if the value is not `undefined`.
+ */
+const isDefined = (current) => !isUndefined(current);
+/**
+ * Determines whether a value is nullish — meaning either `null` or `undefined`.
+ *
+ * @param current - The value to inspect.
+ * @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) => {
+    if (value === null || typeof value !== 'object')
+        return false;
+    const v = value;
+    const hasKnownKey = 'loading' in v || 'value' in v || 'error' in v;
+    return hasKnownKey;
+};
+
+function isPromise(value) {
+    return (
+    // eslint-disable-next-line
+    !!value && (typeof value === 'object' || typeof value === 'function') && typeof value.then === 'function');
+}
+
+/**
+ * Type guard that determines whether a value is an `HttpResourceRef<T>`.
+ *
+ * An `HttpResourceRef` is a structured object produced by Angular’s
+ * `HttpClient` resource APIs. It contains a standardized shape used by
+ * Vault to detect and normalize resource-backed state transitions.
+ *
+ * This utility checks only for the presence of the canonical
+ * `HttpResourceRef` fields (`value`, `isLoading`, `error`, `hasValue`)
+ * and does not validate the internal content of those properties.
+ *
+ * @typeParam T - The resource value type.
+ *
+ * @param obj - The value to test.
+ * @returns `true` if the value matches the structural shape of an
+ *          `HttpResourceRef<T>`, otherwise `false`.
+ */
+// eslint-disable-next-line
+function isHttpResourceRef(obj) {
+    return !!(obj &&
+        typeof obj === 'object' &&
+        'value' in obj &&
+        'isLoading' in obj &&
+        'error' in obj &&
+        'hasValue' in obj);
+}
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > lib > utils > index.ts
+// Updated: 2026-03-24 09:59
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/* -----------------------------------------------------------
+ * UTILITY FUNCTIONS (SAFE TO WILDCARD)
+ * --------------------------------------------------------- */
+
+// --- AI Model File Path (DO NOT DELETE) ---
+// FilePath: libs > shared > src > public-api.ts
+// Updated: 2026-03-23 16:55
+//	 Generated by pathcomment [tab] (see .vscode/typescript.code-snippets) or
+//	 cmd+alt+j (see .vscode/keybindings.json)
+// --- END AI MODEL FILE PATH ---
+/*
+ * Public API Surface of @sdux-vault/shared
+ *
+ * IMPORTANT:
+ *  - JSDoc is preserved only when using named exports.
+ *  - Avoid `export *` for public-facing interfaces, behaviors, and types.
+ *  - Internal utilities may still use `export *`.
+ */
+/* -----------------------------------------------------------
+ * INTENTIONAL SIDE EFFECTS
+ * --------------------------------------------------------- */
+/**
+ * This is to handle fluent api requirements for behaviors and controllers
+ */
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { AbstractActiveController, AbstractErrorCallbackBehavior, AbstractErrorTransformBehavior, BEHAVIOR_META, BehaviorTypes, CONTROLLER_META, ControllerMessageTypes, ControllerTypes, ControllerVotes, DEVTOOLS_AGGREGATE_KEY_CONSTANT, DEVTOOLS_LOGGING_KEY_CONSTANT, DecisionOutcomeTypes, DevMode, EventBoundaryTypes, EventTypes, LogLevelTypes, OperationTypes, ResolveTypes, StateEmitTypes, VAULT_CLEAR_STATE, VAULT_CONTINUE, VAULT_NOOP, VAULT_STOP, VaultBehavior, VaultController, VaultEncryptionIntegrityError, VaultError, VaultErrorKindTypes, VaultErrorNameTypes, VaultErrorService, VaultErrorUsageKindTypes, VaultLicenseError, VaultPrivateErrorService, VaultUsageError, VaultUsagePromiseError, VaultUsagePromiseFactoryRequiredError, createVaultError, defineBehaviorKey, defineControllerKey, getVaultLogLevel, isDeferredFactory, isDefined, isFunction, isHttpResourceRef, isNull, isNullish, isObject, isPromise, isStateInputShape, isTestEnv, isUndefined, isVaultClearState, isVaultContinue, isVaultNoop, isolateValue, registerVersion, safeStringify, setVaultLogLevel, validateBehaviorKey, validateControllerKey, vaultDebug, vaultError, vaultLog, vaultWarn };
+//# sourceMappingURL=sdux-vault-shared.mjs.map