@sdux-vault/core 0.0.9

package/fesm2022/sdux-vault-core.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sdux-vault-core.mjs","sources":["../../../libs/core/src/lib/behaviors/observable/interface/from-observable-behavior.interface.ts","../../../libs/core/src/lib/behaviors/promise/interface/from-promise-behavior.interface.ts","../../../libs/core/src/lib/behaviors/resolve/from-stream/interface/from-stream-behavior.interface.ts","../../../libs/core/src/extensions/index.ts","../../../libs/core/src/lib/version/version.register.ts","../../../libs/core/src/lib/behaviors/merge/object/with-object-shallow-merge.behavior.ts","../../../libs/core/src/lib/behaviors/error/with-core-error-callback/with-core-error-callback.behavior.ts","../../../libs/core/src/lib/behaviors/error/with-core-error/with-core-error.behavior.ts","../../../libs/core/src/lib/behaviors/filter/with-core-filter.behavior.ts","../../../libs/core/src/lib/behaviors/merge/array/with-array-merge.behavior.ts","../../../libs/core/src/lib/behaviors/observable/function/extend-from-observable.function.ts","../../../libs/core/src/lib/behaviors/observable/with-core-from-observable.behavior.ts","../../../libs/core/src/lib/behaviors/promise/function/extend-from-promise.function.ts","../../../libs/core/src/lib/behaviors/promise/with-core-from-promise.behavior.ts","../../../libs/core/src/lib/behaviors/reducer/with-core-reducer.behavior.ts","../../../libs/core/src/lib/behaviors/resolve/core-observable/with-core-observable.behavior.ts","../../../libs/core/src/lib/behaviors/resolve/core-promise/with-core-promise.behavior.ts","../../../libs/core/src/lib/behaviors/resolve/core-value/with-core-value.behavior.ts","../../../libs/core/src/lib/behaviors/resolve/from-stream/function/extend-from-stream.function.ts","../../../libs/core/src/lib/behaviors/resolve/from-stream/with-core-from-stream.behavior.ts","../../../libs/core/src/lib/behaviors/state/with-core-emit-state/with-core-emit-state.behavior.ts","../../../libs/core/src/lib/constants/vault-external.constant.ts","../../../libs/core/src/lib/behaviors/state/with-core-state/with-core-state.behavior.ts","../../../libs/core/src/lib/behaviors/tap/tap.abstract.ts","../../../libs/core/src/lib/behaviors/tap/with-core-after-tap.behavior.ts","../../../libs/core/src/lib/behaviors/tap/with-core-before-tap.behavior.ts","../../../libs/core/src/lib/factories/feature-cell/feature-cell.ts","../../../libs/core/src/lib/factories/vault/vault.ts","../../../libs/core/src/public-api.ts","../../../libs/core/src/sdux-vault-core.ts"],"sourcesContent":["// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > behaviors > observable > interface > from-observable-behavior.interface.ts\n// Updated: 2026-03-30 18:53\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 { VaultStateRef } from '@sdux-vault/engine';\nimport { BehaviorExtFunction } from '@sdux-vault/shared';\nimport { Observable } from 'rxjs';\n\n/**\n * Extension contract for observable-based FeatureCell integration.\n *\n * This interface defines the shape of the dynamically injected\n * `fromObservable` API that allows a FeatureCell to accept observable\n * sources and expose them as normalized vault state references.\n */\nexport interface FromObservableBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {\n  [key: string]: BehaviorExtFunction | undefined;\n\n  /**\n   * Behavior extension function that installs the `fromObservable` API.\n   */\n  fromObservable: BehaviorExtFunction;\n}\n\ndeclare module '@sdux-vault/shared' {\n  /**\n   * FeatureCell extension interface augmented with observable integration support.\n   */\n  interface FeatureCellExtension<TEntity> {\n    /**\n     * Wraps an observable source and exposes it as a stream of vault state references.\n     *\n     * @param source$ Observable emitting raw entity values.\n     * @returns Observable emitting vault state references.\n     */\n    fromObservable?(source$: Observable<TEntity>): Observable<VaultStateRef<TEntity>>;\n  }\n}\n\nexport const __fromObservable = true;\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > behaviors > promise > interface > from-promise-behavior.interface.ts\n// Updated: 2026-03-30 18: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\nimport { BehaviorExtFunction, DeferredFactory, StateInputShape } from '@sdux-vault/shared';\n\n/**\n * Runtime extension contract for promise-based state resolution APIs.\n *\n * This interface defines the behavior extension surface exposed when a\n * promise-capable resolve behavior is installed. It declares the dynamic\n * methods added to a FeatureCell to support deferred and promise-based\n * resolution through the pipeline.\n *\n * --RelatedStart--\n * DeferredFactory\n * --RelatedEnd--\n */\nexport interface FromPromiseBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {\n  [key: string]: BehaviorExtFunction | undefined;\n\n  /**\n   * Resolves state from a deferred factory using promise semantics.\n   */\n  fromPromise: BehaviorExtFunction;\n\n  /**\n   * Resolves state from a deferred factory using deferred semantics.\n   */\n  fromDeferred: BehaviorExtFunction;\n}\n\ndeclare module '@sdux-vault/shared' {\n  /**\n   * FeatureCell extension methods for promise-based state resolution.\n   */\n  interface FeatureCellExtension<TEntity> {\n    /**\n     * Resolves state from a deferred factory using deferred semantics.\n     *\n     * @param incoming Deferred factory that produces the state value.\n     * @returns A promise resolving to a normalized state envelope.\n     */\n    fromDeferred?(incoming: DeferredFactory<TEntity>): Promise<StateInputShape<TEntity>>;\n\n    /**\n     * Resolves state from a deferred factory using promise semantics.\n     *\n     * @param incoming Deferred factory that produces the state value.\n     * @returns A promise resolving to a normalized state envelope.\n     */\n    fromPromise?(incoming: DeferredFactory<TEntity>): Promise<StateInputShape<TEntity>>;\n  }\n}\n\nexport const __fromPromise_extension = true;\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > behaviors > resolve > from-stream > interface > from-stream-behavior.interface.ts\n// Updated: 2026-03-30 18: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\nimport { BehaviorExtFunction } from '@sdux-vault/shared';\nimport { Observable } from 'rxjs';\nimport { FromStreamOptions } from '../options/from-stream.options';\n\n/**\n * Runtime extension contract for behaviors that expose a `fromStream` API.\n *\n * This interface defines the shape of the dynamically injected extension\n * that enables streaming observable sources to participate in pipeline\n * execution through a FeatureCell instance.\n */\nexport interface FromStreamBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {\n  [key: string]: BehaviorExtFunction | undefined;\n\n  /**\n   * Function used to bridge an observable stream into the FeatureCell pipeline.\n   */\n  fromStream: BehaviorExtFunction;\n}\n\ndeclare module '@sdux-vault/shared' {\n  /**\n   * FeatureCell extension surface for stream-based resolution.\n   */\n  interface FeatureCellExtension<TEntity> {\n    /**\n     * Submits a streaming observable source for pipeline processing.\n     *\n     * @param source$ Observable stream emitting candidate values.\n     * @param options Optional configuration controlling stream behavior.\n     */\n    fromStream?(source$: Observable<TEntity>, options?: FromStreamOptions): void;\n  }\n}\nexport const __fromStream_extension = true;\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > extensions > index.ts\n// Updated: 2026-03-30 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// This file exists ONLY for side effects\n\n// Register ALL behavior extensions\nimport * as observableExt from '../lib/behaviors/observable/interface/from-observable-behavior.interface';\nimport * as promiseExt from '../lib/behaviors/promise/interface/from-promise-behavior.interface';\nimport * as streamExt from '../lib/behaviors/resolve/from-stream/interface/from-stream-behavior.interface';\n\nvoid observableExt;\nvoid promiseExt;\nvoid streamExt;\n\nexport * from '../lib/behaviors/observable/interface/from-observable-behavior.interface';\nexport * from '../lib/behaviors/promise/interface/from-promise-behavior.interface';\nexport * from '../lib/behaviors/resolve/from-stream/interface/from-stream-behavior.interface';\n\nexport const __core_extensions_loaded = true;\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > version > version.register.ts\n// Updated: 2026-03-03 08:07\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 '@sdux-vault/shared';\n\nconst SDUX_PACKAGE = '@sdux-vault/core';\nconst SDUX_VERSION = '0.0.9';\n\nregisterVersion(SDUX_PACKAGE, SDUX_VERSION);\n","import {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  MergeBehaviorContract,\n  PipelineUpstreamValue,\n  VAULT_CLEAR_STATE,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\nimport { MergeConfig } from '@sdux-vault/shared';\n\n/**\n * Shallow object merge behavior for the Vault merge stage.\n *\n * This behavior performs a one-level object merge where the incoming\n * object spreads over the existing state. Non-object values, arrays,\n * and `null` values bypass merging and are returned directly.\n *\n * The behavior also supports optional merge configuration, such as\n * `clearUndefined`, which determines whether an `undefined` incoming\n * value should clear the current state.\n *\n * This merge strategy is marked as a core, critical behavior and must\n * always be present when selected as the FeatureCell’s merge behavior.\n *\n * @typeParam T - The state value type processed during merge.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Merge,\n  key: defineBehaviorKey('Core', 'ObjectMerge'),\n  critical: true\n})\nexport class withObjectShallowMergeBehavior<T> implements MergeBehaviorContract<T> {\n  /** Static metadata used for orchestrator behavior classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique identifier for behavior diagnostics and devtools. */\n  static readonly key: string;\n\n  /** Indicates this merge behavior is pipeline-critical. */\n  static readonly critical = true;\n\n  /** Pipeline behavior type identifier. */\n  readonly type = BehaviorTypes.Merge;\n\n  /** Unique merge behavior instance identifier. */\n  readonly key: string;\n\n  /** Instance-level criticality flag. */\n  readonly critical = true;\n\n  /**\n   * Creates a new shallow object merge behavior instance.\n   *\n   * @param key - Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx - BehaviorCtx for future extensibility hooks.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Computes the shallow merge result between the current state and\n   * the incoming value. Non-object inputs bypass merging and are\n   * forwarded directly. When `clearUndefined=true`, an undefined\n   * incoming value clears the state.\n   *\n   * @param currentValue - The current FeatureCell state value.\n   * @param nextValue - The incoming value to merge into the current state.\n   * @param options - Optional merge configuration including `clearUndefined`.\n   * @returns The merged or forwarded next state value.\n   */\n  computeMerge(\n    currentValue: PipelineUpstreamValue<T> | undefined,\n    nextValue: PipelineUpstreamValue<T> | undefined,\n    options?: MergeConfig\n  ): PipelineUpstreamValue<T> | undefined {\n    const curr = currentValue;\n    const next = nextValue;\n\n    const clear = options?.clearUndefined ?? false;\n\n    vaultDebug(`${this.key} shallow merge (clearUndefined=${clear})`);\n\n    if (next === undefined && !clear) {\n      vaultDebug(`${this.key} next undefined, preserve current`);\n      return curr;\n    }\n\n    if (next === undefined && clear) {\n      vaultDebug(`${this.key} next undefined & clear=true → return undefined`);\n      return VAULT_CLEAR_STATE;\n    }\n\n    if (\n      curr == null ||\n      next == null ||\n      typeof curr !== 'object' ||\n      typeof next !== 'object' ||\n      Array.isArray(curr) ||\n      Array.isArray(next)\n    ) {\n      vaultDebug(`${this.key} non-object merge return next`);\n      return next;\n    }\n\n    vaultDebug(`${this.key} shallow merge curr & next`);\n    return { ...curr, ...next } as PipelineUpstreamValue<T>;\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   * This merge behavior maintains no internal resources.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the shallow merge behavior.\n   *\n   * Object shallow merge is a fully stateless, pure merge strategy.\n   * It holds no timers, caches, or internal merge state, meaning\n   * there is nothing to reset. This lifecycle hook exists solely\n   * to support the FeatureCell reset pipeline and to provide a\n   * diagnostic signal for DevTools and monitoring systems.\n   *\n   * After reset, the behavior continues to function identically.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  AbstractErrorCallbackBehavior,\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  StateSnapshotShape,\n  VaultBehavior,\n  VaultErrorCallback,\n  VaultErrorShape,\n  vaultWarn\n} from '@sdux-vault/shared';\n/**\n * Core error callback behavior for invoking legacy error handlers.\n *\n * This behavior executes an optional consumer-supplied error callback when a\n * pipeline error occurs, forwarding the normalized error and an immutable\n * snapshot of the FeatureCell state without altering error flow.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreErrorCallback,\n  key: defineBehaviorKey('Core', 'ErrorCallback'),\n  critical: true\n})\nexport class withCoreErrorCallbackBehavior<T> extends AbstractErrorCallbackBehavior<T> {\n  /**\n   * Static behavior type identifier used for orchestrator classification.\n   */\n  static readonly type: BehaviorType;\n\n  /**\n   * Static behavior key used for diagnostics and tooling.\n   */\n  static readonly key: string;\n\n  /**\n   * Indicates that this behavior is critical within the pipeline.\n   */\n  static readonly critical: boolean;\n\n  /**\n   * Indicates that this error callback behavior is always executed.\n   */\n  override readonly critical = withCoreErrorCallbackBehavior.critical;\n\n  /**\n   * Creates a new core error callback behavior instance.\n   *\n   * @param key Unique behavior identifier.\n   * @param behaviorCtx Behavior class context for dependency access.\n   */\n  constructor(key: string, behaviorCtx: BehaviorClassContext) {\n    super(key, behaviorCtx);\n  }\n\n  /**\n   * Invokes a legacy error callback with the normalized error and state snapshot.\n   *\n   * @param current The normalized error value.\n   * @param state Immutable snapshot of the FeatureCell state.\n   * @param oldschoolCallback Optional legacy callback function.\n   * @returns Resolves after callback execution completes.\n   */\n  async callbackError(\n    current: VaultErrorShape,\n    state: StateSnapshotShape<T>,\n    oldschoolCallback: VaultErrorCallback<T>\n  ): Promise<void> {\n    if (typeof oldschoolCallback !== 'function') {\n      vaultWarn(`${this.key} handleError skipped - \"${oldschoolCallback}\" is not a function.`);\n    } else {\n      try {\n        await oldschoolCallback(current, state);\n      } catch (err) {\n        vaultWarn(`${this.key} oldschoolCallback threw: ${err}`);\n      }\n    }\n\n    return;\n  }\n}\n","import { CoreErrorBehaviorContract } from '@sdux-vault/engine';\nimport {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  VaultBehavior,\n  VaultErrorShape,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core error behavior used internally by the Vault orchestrator.\n *\n * This behavior represents the **first step** in the error-handling pipeline.\n * It is intentionally minimal and exists solely to normalize any thrown value—\n * regardless of type—into a canonical ResourceStateError using\n * resourceError.\n *\n * ## Responsibilities\n * - Convert `unknown` errors into a well-structured `ResourceStateError`\n * - Provide a deterministic starting point for all addon error behaviors\n * - Guarantee error normalization before transformations occur\n *\n * All richer behaviors (mapping, retries, notifications, old-school callbacks)\n * are implemented as **addon error behaviors** layered after this one.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreError,\n  key: defineBehaviorKey('Core', 'Error'),\n  critical: true\n})\nexport class withCoreErrorBehavior<T> implements CoreErrorBehaviorContract<T> {\n  /** Behavior type metadata assigned by the decorator. */\n  static readonly type: BehaviorType;\n\n  /**\n   * Unique behavior key assigned by the decorator. */\n  static readonly key: string;\n\n  /** Indicates this behavior participates critically in the pipeline. */\n  static readonly critical: boolean;\n\n  /** Indicates that this error behavior is critical and always executed. */\n  readonly critical = true;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Behavior type for orchestrator registration. */\n  readonly type = BehaviorTypes.CoreError;\n\n  /**\n   * Creates a new Core Error Behavior instance.\n   *\n   * @param key - Runtime identifier assigned by the behavior factory.\n   * @param behaviorCtx - Behavior context providing injector access and\n   *                      future extensibility hooks.\n   *\n   * This constructor performs no allocation of runtime resources. It simply\n   * stores metadata required by the orchestrator and devtools.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Normalizes an unknown error into a {@link VaultErrorShape}.\n   *\n   * This is the *only* operation performed by the core error behavior.\n   * Additional behaviors further down the pipeline may inspect or transform\n   * the returned structure.\n   *\n   * @param error - The raw error thrown during pipeline execution.\n   * @param feaetureCellKey - The FeatureCell key where the error originated.\n   * @returns A canonical `ResourceStateError` created from the raw value.\n   */\n  handleError(error: unknown, featureCellKey: string): VaultErrorShape {\n    return createVaultError(error, featureCellKey);\n  }\n\n  /**\n   * Lifecycle hook invoked when the behavior instance is destroyed.\n   *\n   * Core behaviors maintain no internal resources and therefore perform no\n   * cleanup. This method logs a devtools-friendly \"noop\" warning to help\n   * with behavior lifecycle introspection.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the behavior instance.\n   *\n   * This behavior maintains no internal mutable state. The reset hook exists\n   * strictly for lifecycle symmetry across all behavior types and to support\n   * devtools state introspection.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  FilterBehaviorContract,\n  FilterFunction,\n  PipelineUpstreamValue,\n  safeStringify,\n  VAULT_NOOP,\n  VaultBehavior,\n  vaultDebug,\n  vaultError,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core filter behavior for Vault.\n *\n * This behavior participates in the filter stage of the pipeline.\n * A filter function receives the current state and may return:\n * - the same state\n * - a transformed state of the same structural type\n * - `undefined` to indicate that the state update should be aborted\n *\n * This behavior enforces type alignment between the incoming value\n * and the filtered result, ensuring that filters cannot mutate or\n * reshape the state into an incompatible type. When a mismatch is\n * detected, a controlled Vault error is thrown.\n *\n * Filters MUST be pure and must not mutate the incoming value.\n *\n * @typeParam T - The state type handled by this filter behavior.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Filter,\n  key: defineBehaviorKey('Core', 'Filter'),\n  critical: true\n})\nexport class withCoreFilterBehavior<T> implements FilterBehaviorContract<T> {\n  /** Static behavior type used for pipeline classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for introspection and diagnostics. */\n  static readonly key: string;\n\n  /** Indicates that filter behavior is required in the pipeline. */\n  static readonly critical: boolean;\n\n  /** Instance-level criticality flag. */\n  readonly type = BehaviorTypes.Filter;\n\n  /** Indicates that this behavior must always run as part of filtering. */\n  readonly critical = true;\n\n  /** Unique identifier for this filter behavior instance. */\n  readonly key: string;\n\n  /**\n   * Creates a new filter behavior instance.\n   *\n   * @param key - Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx - BehaviorCtx for future extensibility hooks.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Applies the provided filter function to the current state.\n   *\n   * If the filter returns `undefined`, the state update is aborted.\n   * Filter output must preserve the shape of:\n   * - arrays\n   * - plain objects\n   * - primitives\n   *\n   * Structural mismatches result in a thrown Vault error.\n   * Filters must not mutate the incoming value and should remain pure.\n   *\n   * @param current - The current value before filtering.\n   * @param filter - A pure filter function that may transform or reject the value.\n   * @returns The filtered value, or `undefined` to abort the update.\n   */\n  applyFilter(current: T, filter: FilterFunction<T>): PipelineUpstreamValue<T> {\n    vaultDebug(`${this.key} applyFilter called with \"${safeStringify(current)}\".`);\n\n    if (current === undefined) {\n      vaultDebug(\n        `${this.key} applyFilter skipped - not a valid plain state. The current type is ${typeof current}. Undefined returned.`\n      );\n      return undefined;\n    }\n    if (typeof filter !== 'function') {\n      vaultDebug(\n        `${this.key} applyFilter skipped. The filter type is ${typeof filter}. \"${safeStringify(current)}\" returned.`\n      );\n      return current;\n    }\n\n    let next: T;\n    try {\n      next = filter(current);\n      // eslint-disable-next-line\n    } catch (err: any) {\n      vaultError(`${this.key} filter execution failed`, err.message);\n      throw err;\n    }\n\n    if (next === undefined) {\n      vaultDebug(`${this.key} Filter returned undefined. state rejected.`);\n      return VAULT_NOOP;\n    }\n\n    if (this.#handleArrayLogic(current, next)) return next;\n\n    if (this.#handleObjectLogic(current, next)) return next;\n\n    this.#handlePrimitiveLogic(current, next);\n\n    vaultDebug(`${this.key} applyFilter returned with \"${safeStringify(next)}\".`);\n    return next;\n  }\n\n  /**\n   * Performs type validation when filtering array state values.\n   *\n   * Ensures the filtered output remains an array when the input was an array.\n   *\n   * @param current - The pre-filter state value.\n   * @param next - The filtered state value.\n   * @returns `true` if array handling was applied.\n   */\n  #handleArrayLogic(current: T, next: T): boolean {\n    if (Array.isArray(current)) {\n      if (!Array.isArray(next)) {\n        this.#typeAlignmentDebug(current, next);\n        throw new Error(`[vault] Filter returned non-array for array input.`);\n      }\n      return true;\n    }\n\n    return false;\n  }\n\n  /**\n   * Performs type validation when filtering object-based state values.\n   *\n   * Ensures the filter returns a valid non-null object of compatible structure.\n   *\n   * @param current - The pre-filter state value.\n   * @param next - The filtered state value.\n   * @returns `true` if object handling was applied.\n   */\n  #handleObjectLogic(current: T, next: T): boolean {\n    if (current !== null && typeof current === 'object') {\n      if (typeof next !== 'object' || next === null || Array.isArray(next)) {\n        this.#typeAlignmentDebug(current, next);\n        throw new Error(`[vault] Filter returned invalid object for object input.`);\n      }\n      return true;\n    }\n    return false;\n  }\n\n  /**\n   * Performs type validation for primitive state values.\n   *\n   * Ensures the filter output matches the primitive type of the input.\n   *\n   * @param current - The pre-filter primitive value.\n   * @param next - The filtered primitive value.\n   */\n  #handlePrimitiveLogic(current: T, next: T): void {\n    if (typeof next !== typeof current) {\n      this.#typeAlignmentDebug(current, next);\n      throw new Error(\n        `[vault] Filter returned a value of incorrect type. Expected \"${typeof current}\", got \"${typeof next}\".`\n      );\n    }\n  }\n\n  /**\n   * Emits detailed debug output when filter output does not align with the input type.\n   *\n   * @param current - The original state value.\n   * @param next - The returned filter value.\n   */\n  #typeAlignmentDebug(current: T, next: T): void {\n    vaultDebug(\n      `${this.key} The types not aligned. Current type: \"${typeof current}\". Next type: ${typeof next}. \"${safeStringify(next)}\" returned.`\n    );\n  }\n\n  /**\n   * Invoked during behavior teardown.\n   * This behavior maintains no internal resources and requires no cleanup.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the filter behavior.\n   *\n   * Since core filters do not maintain internal state, this reset operation\n   * performs no functional work. It exists to support the FeatureCell reset\n   * lifecycle and provides a diagnostic hook for DevTools and monitoring.\n   *\n   * After reset, the behavior continues operating identically to before.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  MergeBehaviorContract,\n  PipelineUpstreamValue,\n  VAULT_CLEAR_STATE,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\nimport { MergeConfig } from '@sdux-vault/shared';\n\n/**\n * Array merge behavior for Vault.\n *\n * This merge strategy replaces arrays rather than merging them, ensuring\n * predictable and immutable updates for list-like state. All non-array values\n * are returned directly without transformation.\n *\n * This behavior is marked as critical, ensuring it participates in every\n * merge pipeline unless explicitly replaced by a custom merge behavior.\n *\n * @typeParam T - The pipeline state value type handled by this behavior.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Merge,\n  key: defineBehaviorKey('Core', 'ArrayMerge'),\n  critical: true\n})\nexport class withArrayMergeBehavior<T> implements MergeBehaviorContract<T> {\n  /** Static behavior type used by the orchestrator. */\n  static readonly type: BehaviorType;\n\n  /** Static unique key assigned to this behavior. */\n  static readonly key: string;\n\n  /** Indicates this behavior is required for merge processing. */\n  static readonly critical = true;\n\n  /** Instance-level merge behavior type identifier. */\n  readonly type = withArrayMergeBehavior.type;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Flags this behavior instance as critical within the pipeline. */\n  readonly critical = withArrayMergeBehavior.critical;\n\n  /**\n   * Creates a new array merge behavior instance.\n   *\n   * @param key - Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx - BehaviorCtx for future extensibility hooks.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Computes the merged state value using array-replacement semantics.\n   *\n   * - If `nextValue` is undefined and `clearUndefined` is false,\n   *   the current value is preserved.\n   * - If `nextValue` is undefined and `clearUndefined` is true,\n   *   the merge resolves to `undefined`.\n   * - If both values are arrays, a shallow clone of `nextValue`\n   *   is returned to maintain immutability.\n   * - All other values pass through as-is.\n   *\n   * @param currentValue - The existing state value.\n   * @param nextValue - The incoming state value to merge.\n   * @param options - Optional merge configuration.\n   * @returns The merged pipeline value.\n   */\n  computeMerge(\n    currentValue: PipelineUpstreamValue<T> | undefined,\n    nextValue: PipelineUpstreamValue<T> | undefined,\n    options?: MergeConfig\n  ): PipelineUpstreamValue<T> {\n    const curr = currentValue;\n    const next = nextValue;\n\n    const clear = options?.clearUndefined ?? false;\n\n    vaultDebug(`${this.key} merge called (clear: ${clear})`);\n\n    if (next === undefined && !clear) {\n      vaultDebug(`${this.key} computeMerge skipped. The next value \"${next}\" and clear is \"${clear}`);\n      return curr;\n    }\n\n    if (next === undefined && clear) {\n      vaultDebug(`${this.key} computeMerge skipped. The next value \"${next}\" and clear is \"${clear}`);\n      return VAULT_CLEAR_STATE;\n    }\n\n    if (Array.isArray(curr) && Array.isArray(next)) {\n      vaultDebug(`${this.key} merging array. Return clone of next`);\n      return [...next] as PipelineUpstreamValue<T>;\n    }\n\n    vaultDebug(`${this.key} non-array branch. Return next`);\n    return next as PipelineUpstreamValue<T>;\n  }\n\n  /**\n   * Performs teardown when the behavior instance is destroyed.\n   * This merge behavior maintains no resources and requires no cleanup.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the merge behavior.\n   *\n   * Array merge is a fully stateless behavior and maintains no internal\n   * resources, configuration mutations, or cached values. As a result,\n   * this reset operation performs no functional work and simply emits a\n   * diagnostic event for DevTools and monitoring.\n   *\n   * After reset, this behavior continues to operate identically to before.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import { FeatureCellShape, VaultStateRef } from '@sdux-vault/engine';\nimport { Observable } from 'rxjs';\n\n/**\n * Extends a FeatureCell with a `fromObservable` helper for observable-based state sources.\n *\n * This function installs a placeholder implementation that accepts an observable\n * and exposes it as a stream of `VaultStateRef<T>` values, with the runtime behavior\n * replaced by the corresponding pipeline behavior when installed.\n *\n * @param cell The FeatureCell instance to extend.\n */\nexport function extendFromObservable<T>(cell: FeatureCellShape<T>) {\n  /**\n   * Wraps an observable source for integration with the FeatureCell pipeline.\n   *\n   * @param source$ Observable emitting raw state values.\n   * @returns Observable emitting vault state references.\n   */\n  cell.fromObservable = function (source$: Observable<T>): Observable<VaultStateRef<T>> {\n    return source$ as Observable<VaultStateRef<T>>;\n  };\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContract,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  FeatureCellExtensionContext,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  StateInputShape,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\nimport { EMPTY, Observable, take, takeUntil } from 'rxjs';\nimport { extendFromObservable } from './function/extend-from-observable.function';\nimport { FromObservableBehaviorExtension } from './interface/from-observable-behavior.interface';\n\n/**\n * Extension behavior that enables FeatureCells to resolve state from observable sources.\n *\n * This behavior augments the FeatureCell API with a `fromObservable` method that\n * converts a single observable emission into a normalized state envelope and\n * binds subscription lifetime to the cell lifecycle.\n *\n * @deprecated\n * This API exists as a migration bridge for observable-based workflows.\n * Prefer using `replaceState` or `mergeState` to resolve\n * observables directly within the pipeline.\n *\n * --RelatedStart--\n * FromObservableBehaviorExtension\n * withCoreObservableBehavior\n * replaceState\n * mergeState\n * --RelatedEnd--\n */\n@VaultBehavior({\n  type: BehaviorTypes.FromObservable,\n  key: defineBehaviorKey('Core', 'FromObservable'),\n  critical: false,\n  resolveType: ResolveTypes.Observable\n})\nexport class withCoreFromObservableBehavior<T> implements BehaviorContract<T, FromObservableBehaviorExtension> {\n  /** Extension function used to attach observable APIs to the FeatureCell. */\n  static readonly extension = extendFromObservable;\n\n  /** Static behavior type used for pipeline classification. */\n  static readonly type: BehaviorType;\n\n  /** Static behavior key used for diagnostics and introspection. */\n  static readonly key: string;\n\n  /** Resolve type associated with observable-based resolution. */\n  static readonly resolveType: ResolveType;\n\n  /** Indicates whether this behavior is required by the pipeline. */\n  static readonly critical: boolean;\n\n  /** Instance-level behavior type identifier. */\n  readonly type = withCoreFromObservableBehavior.type;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Indicates that this behavior is optional within the pipeline. */\n  readonly critical = withCoreFromObservableBehavior.critical;\n\n  /** Resolve type for this behavior instance. */\n  readonly resolveType = withCoreFromObservableBehavior.resolveType;\n\n  /**\n   * Creates a new observable extension behavior instance.\n   *\n   * @param key Unique identifier assigned by the behavior factory.\n   * @param behaviorCtx Behavior class context used for configuration access.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Extends the FeatureCell API with observable-based resolution support.\n   *\n   * @param ctx FeatureCell extension context providing lifecycle signals.\n   * @returns An extension object exposing the `fromObservable` API.\n   */\n  extendCellAPI(ctx: FeatureCellExtensionContext<T>): FromObservableBehaviorExtension {\n    return {\n      fromObservable: (source$: Observable<T>) =>\n        new Observable<StateInputShape<T>>((observer) => {\n          vaultDebug(`${this.key} fromObservable called.`);\n\n          const destroy$ = ctx.destroyed$ ?? EMPTY;\n          const reset$ = ctx.reset$ ?? EMPTY;\n\n          const subscription = source$.pipe(takeUntil(reset$), takeUntil(destroy$), take(1)).subscribe({\n            next: (value) => {\n              vaultDebug(`${this.key} fromObservable emitted value \"${safeStringify(value)}\".`);\n              observer.next({\n                loading: false,\n                value,\n                error: null\n              });\n            },\n\n            error: (err) => {\n              const error = createVaultError(err, ctx.featureCellKey);\n              observer.error(error);\n              vaultDebug(`${this.key} fromObservable emitted error \"${error.message}\".`);\n            },\n\n            complete: () => {\n              observer.complete();\n              vaultDebug(`${this.key} fromObservable completed.`);\n            }\n          });\n\n          return () => {\n            subscription.unsubscribe();\n            vaultDebug(`${this.key} fromObservable subscription unsubscribed.`);\n          };\n        })\n    };\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the observable extension behavior.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import { FeatureCellShape } from '@sdux-vault/engine';\nimport { DeferredFactory, StateInputShape } from '@sdux-vault/shared';\n\n/**\n * Extends a FeatureCell with promise-based resolution placeholders.\n *\n * This function attaches `fromDeferred` and `fromPromise` methods to the\n * FeatureCell shape as build-time stubs. These methods are replaced at\n * runtime by the corresponding resolve behavior when installed.\n *\n * --RelatedStart--\n * FeatureCellShape\n * DeferredFactory\n * --RelatedEnd--\n *\n * @param cell The FeatureCell instance being extended.\n */\nexport function extendFromPromise<T>(cell: FeatureCellShape<T>) {\n  /**\n   * Resolves state from a deferred factory using promise semantics.\n   *\n   * @param _incoming Deferred factory that produces the state value.\n   * @returns A promise resolving to a normalized state envelope.\n   */\n  cell.fromDeferred = function (_incoming: DeferredFactory<T>): Promise<StateInputShape<T>> {\n    // runtime behavior will replace this implementation\n    throw new Error('[vault] fromDeferred() behavior not installed');\n  };\n\n  /**\n   * Resolves state from a deferred factory using promise semantics.\n   *\n   * @param _incoming Deferred factory that produces the state value.\n   * @returns A promise resolving to a normalized state envelope.\n   */\n  cell.fromPromise = function (_incoming: DeferredFactory<T>): Promise<StateInputShape<T>> {\n    // runtime behavior will replace this implementation\n    throw new Error('[vault] fromPromise() behavior not installed');\n  };\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContract,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  DeferredFactory,\n  defineBehaviorKey,\n  FeatureCellExtensionContext,\n  isDeferredFactory,\n  isUndefined,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  StateInputType,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\nimport { extendFromPromise } from './function/extend-from-promise.function';\nimport { FromPromiseBehaviorExtension } from './interface/from-promise-behavior.interface';\n\n/**\n * Extension behavior that enables promise-based state resolution for FeatureCells.\n *\n * This behavior augments a FeatureCell with APIs that accept deferred factories\n * and resolve their produced values into normalized state inputs. It supports\n * both promise and deferred invocation semantics while preserving pipeline\n * loading and error metadata.\n *\n * @deprecated\n * This API exists as a migration bridge for deferred- and promise-based workflows.\n * Prefer using `replaceState` or `mergeState` to resolve promises\n * directly within the pipeline.\n *\n * --RelatedStart--\n * FromPromiseBehaviorExtension\n * DeferredFactory\n * withCorePromiseBehavior\n * replaceState\n * mergeState\n * --RelatedEnd--\n */\n@VaultBehavior({\n  type: BehaviorTypes.FromPromise,\n  key: defineBehaviorKey('Core', 'FromPromise'),\n  critical: false,\n  resolveType: ResolveTypes.Promise\n})\nexport class withCoreFromPromiseBehavior<T> implements BehaviorContract<T, FromPromiseBehaviorExtension> {\n  /** Static behavior function used to extend the FeatureCell API. */\n  static readonly extension = extendFromPromise;\n\n  /** Static behavior type used for orchestrator classification. */\n  static readonly type: BehaviorType;\n\n  /** Static behavior key used for diagnostics and tooling. */\n  static readonly key: string;\n\n  /** Indicates whether this behavior is required by the pipeline. */\n  static readonly critical: boolean;\n\n  /** Resolve type identifier for promise-based resolution. */\n  static readonly resolveType: ResolveType;\n\n  /** Instance-level behavior type identifier. */\n  readonly type = withCoreFromPromiseBehavior.type;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Indicates that this behavior is optional within the pipeline. */\n  readonly critical = withCoreFromPromiseBehavior.critical;\n\n  /** Resolve type identifier for this behavior instance. */\n  readonly resolveType = withCoreFromPromiseBehavior.resolveType;\n\n  /**\n   * Creates a new instance of the promise resolution behavior.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior context providing configuration and lifecycle hooks.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Extends the FeatureCell API with promise-based resolution functions.\n   *\n   * @param ctx FeatureCell extension context used for lifecycle coordination.\n   * @returns An extension object exposing promise-based resolution methods.\n   */\n  extendCellAPI(ctx: FeatureCellExtensionContext<T>): FromPromiseBehaviorExtension {\n    const handleDeferred = (incoming: DeferredFactory<T> | unknown): Promise<StateInputType<T>> =>\n      new Promise<StateInputType<T>>((resolve, reject) => {\n        vaultDebug(`${this.key} fromPromise called.`);\n\n        if (isUndefined(incoming)) {\n          resolve({\n            loading: false,\n            value: undefined,\n            error: null\n          });\n          return;\n        }\n\n        if (!isDeferredFactory(incoming)) {\n          const potentialIncoming = incoming as Partial<DeferredFactory<T>>;\n          resolve({\n            loading: potentialIncoming?.loading ?? false,\n            value: undefined,\n            error: potentialIncoming?.error ?? null\n          });\n          return;\n        }\n\n        let result: T | undefined | null | Promise<T | undefined | null>;\n\n        try {\n          result = incoming.value?.() as T | undefined | null | Promise<T | undefined | null>;\n        } catch (err) {\n          const error = createVaultError(err, ctx.featureCellKey);\n          reject(error);\n          return;\n        }\n\n        Promise.resolve(result)\n          .then((value) => {\n            vaultDebug(`${this.key} fromPromise resolved value: ${safeStringify(value)}`);\n            resolve({\n              loading: incoming.loading ?? false,\n              value,\n              error: incoming.error ?? null\n            });\n          })\n          .catch((err) => {\n            const error = createVaultError(err, ctx.featureCellKey);\n            reject(error);\n          });\n      });\n\n    return {\n      fromPromise: (incoming: DeferredFactory<T>) => handleDeferred(incoming),\n      fromDeferred: (incoming: DeferredFactory<T>) => handleDeferred(incoming)\n    };\n  }\n\n  /**\n   * Invoked during behavior teardown.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the behavior state.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  ReduceBehaviorContract,\n  ReducerFunction,\n  safeStringify,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core reducer behavior that applies pure reducer functions to state values.\n *\n * This behavior participates in the reduce stage of the pipeline and is\n * responsible for invoking reducer functions supplied by consumers to\n * transform the current state into a new value. It performs no validation\n * beyond ensuring the reducer is callable.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Reduce,\n  key: defineBehaviorKey('Core', 'Reducer'),\n  critical: true\n})\nexport class withCoreReducerBehavior<T> implements ReduceBehaviorContract<T> {\n  /** Static metadata used for orchestrator behavior classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior identifier for diagnostics and devtools. */\n  static readonly key: string;\n\n  /** Indicates that reducer behavior is essential to the pipeline. */\n  static readonly critical: boolean;\n\n  /** Instance-level criticality flag. */\n  readonly critical = true;\n\n  /** Pipeline behavior type identifier. */\n  readonly type = BehaviorTypes.Reduce;\n\n  /** Unique identifier for this reducer behavior instance. */\n  readonly key: string;\n\n  /**\n   * Creates a new reducer behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection and configuration.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Applies a reducer function to the current state value.\n   *\n   * @param current The current state value before reduction.\n   * @param reducer A reducer function that produces the next state value.\n   * @returns The reduced state value.\n   */\n  applyReducer(current: T, reducer: ReducerFunction<T>): T {\n    vaultDebug(`${this.key} applyReducer called with \"${safeStringify(current)}\".`);\n    if (typeof reducer !== 'function') {\n      vaultDebug(`${this.key} applyReducer skipped - reducer is not a function.`);\n      return current;\n    }\n    return reducer(current);\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the reducer behavior to its initial state.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContext,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  PipelineUpstreamValue,\n  ResolveBehaviorContract,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\nimport { EMPTY, firstValueFrom, isObservable, Observable, take, takeUntil } from 'rxjs';\n\n/**\n * Core resolve behavior that extracts a single value from an RxJS Observable.\n *\n * This behavior participates in the resolve stage and handles incoming\n * Observable values by subscribing once and resolving with the first emitted\n * value. Resolution is automatically terminated when the FeatureCell is reset\n * or destroyed.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Resolve,\n  key: defineBehaviorKey('Core', 'Observable'),\n  critical: false,\n  resolveType: ResolveTypes.Observable\n})\nexport class withCoreObservableBehavior<T> implements ResolveBehaviorContract<T> {\n  /** Static behavior type used for orchestrator classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for diagnostics and devtools. */\n  static readonly key: string;\n\n  /** Indicates whether this behavior is required by the pipeline. */\n  static readonly critical: boolean;\n\n  /** Resolve type classification for observable-based resolution. */\n  static readonly resolveType: ResolveType;\n\n  /** The pipeline behavior type identifier. */\n  readonly type = BehaviorTypes.Resolve;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Indicates that this behavior is optional within the pipeline. */\n  readonly critical = false;\n\n  /** Resolve type identifier for observable-based resolution. */\n  readonly resolveType = withCoreObservableBehavior.resolveType;\n\n  /**\n   * Creates a new observable resolve behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection and configuration.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Resolves a state value from an Observable input.\n   *\n   * @param ctx The resolve behavior context containing the incoming value.\n   * @returns The resolved state value or undefined if resolution is skipped.\n   */\n  async computeResolve(ctx: BehaviorContext<T>): Promise<PipelineUpstreamValue<T>> {\n    const incoming = ctx.incoming;\n\n    vaultDebug(`${this.key} computeResolve called with incoming: ${safeStringify(incoming)}`);\n\n    if (!isObservable(incoming)) {\n      vaultDebug(`${this.key} computeResolve skipped — incoming is not an Observable.`);\n      return;\n    }\n\n    vaultDebug(`${this.key} computeResolve detected Observable input.`);\n\n    const source$ = incoming as Observable<T>;\n    const reset$ = ctx.reset$ ?? EMPTY;\n    const destroyed$ = ctx.destroyed$ ?? EMPTY;\n\n    try {\n      const value = await firstValueFrom(source$.pipe(takeUntil(reset$), takeUntil(destroyed$), take(1)));\n\n      vaultDebug(`${this.key} computeResolve resolved value: ${safeStringify(value)}`);\n\n      return value;\n    } catch (err) {\n      const vaultError = createVaultError(err, ctx.featureCellKey);\n\n      vaultDebug(`${this.key} computeResolve caught error: ${vaultError.message}`);\n\n      throw vaultError;\n    }\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the resolve behavior to its initial state.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContext,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  isDeferredFactory,\n  isFunction,\n  isUndefined,\n  PipelineUpstreamValue,\n  ResolveBehaviorContract,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core resolve behavior that extracts a value from a deferred promise factory.\n *\n * This behavior participates in the resolve stage and handles incoming\n * deferred factories by invoking the factory exactly once and resolving\n * with the resulting value. Errors are normalized and propagated through\n * the pipeline error handling contract.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Resolve,\n  key: defineBehaviorKey('Core', 'Promise'),\n  critical: false,\n  resolveType: ResolveTypes.Promise\n})\nexport class withCorePromiseBehavior<T> implements ResolveBehaviorContract<T> {\n  /** Static behavior type used for orchestrator classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for diagnostics and devtools. */\n  static readonly key: string;\n\n  /** Indicates whether this behavior is required by the pipeline. */\n  static readonly critical: boolean;\n\n  /** Resolve type classification for promise-based resolution. */\n  static readonly resolveType: ResolveType;\n\n  /** The pipeline behavior type identifier. */\n  readonly type = withCorePromiseBehavior.type;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /** Indicates that this behavior is optional within the pipeline. */\n  readonly critical = withCorePromiseBehavior.critical;\n\n  /** Resolve type identifier for promise-based resolution. */\n  readonly resolveType = withCorePromiseBehavior.resolveType;\n\n  /**\n   * Creates a new promise resolve behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection and configuration.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Resolves a state value from a deferred promise factory.\n   *\n   * @param ctx The resolve behavior context containing the incoming value.\n   * @returns The resolved state value or undefined if resolution is skipped.\n   */\n  async computeResolve(ctx: BehaviorContext<T>): Promise<PipelineUpstreamValue<T>> {\n    const incoming = ctx.incoming;\n\n    vaultDebug(`${this.key} computeResolve promise called with incoming: ${safeStringify(incoming)}`);\n\n    if (!(isDeferredFactory(incoming) || isFunction(incoming)) || isUndefined(incoming)) {\n      vaultDebug(`${this.key} computeResolve skipped — incoming is not a deferred factory.`);\n      return;\n    }\n\n    vaultDebug(`${this.key} computeResolve detected Promise input.`);\n\n    try {\n      let value: T;\n      if (isFunction(incoming)) {\n        value = (await incoming?.()) as T;\n      } else {\n        value = (await incoming.value?.()) as T;\n      }\n\n      vaultDebug(`${this.key} computeResolve resolved value: ${safeStringify(value)}`);\n\n      return value;\n    } catch (err) {\n      const vaultError = createVaultError(err, ctx.featureCellKey);\n      vaultDebug(`${this.key} computeResolve caught error: ${vaultError.message}`);\n      throw vaultError;\n    }\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the resolve behavior to its initial state.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContext,\n  BehaviorType,\n  BehaviorTypes,\n  defineBehaviorKey,\n  isHttpResourceRef,\n  PipelineUpstreamValue,\n  ResolveBehaviorContract,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  VAULT_CLEAR_STATE,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core resolve behavior that extracts a plain value from an incoming state envelope.\n *\n * This behavior participates in the resolve stage and handles direct value-based\n * state inputs by safely normalizing the contained value. Objects and arrays are\n * shallow-cloned to preserve immutability guarantees, while null and undefined\n * values are handled explicitly according to pipeline semantics.\n */\n@VaultBehavior({\n  type: BehaviorTypes.Resolve,\n  key: defineBehaviorKey('Core', 'Value'),\n  critical: true,\n  resolveType: ResolveTypes.Value\n})\nexport class withCoreValueBehavior<T> implements ResolveBehaviorContract<T> {\n  /** Static behavior type for orchestrator classification. */\n  static readonly type: BehaviorType;\n\n  /** Static unique behavior identifier. */\n  static readonly key: string;\n\n  /** Static flag marking this behavior as pipeline-critical. */\n  static readonly critical: boolean;\n\n  /** Resolve type classification for value-based resolution. */\n  static readonly resolveType: ResolveType;\n\n  /** Instance-level pipeline type identifier. */\n  readonly type = withCoreValueBehavior.type;\n\n  /** Indicates this resolve behavior is required for pipeline operation. */\n  readonly critical = withCoreValueBehavior.critical;\n\n  /** Unique behavior key for the instance. */\n  readonly key: string;\n\n  /** Resolve mode indicating plain value resolution. */\n  readonly resolveType = withCoreValueBehavior.resolveType;\n\n  /**\n   * Creates a new value resolve behavior instance.\n   *\n   * @param key Unique behavior identifier assigned by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection and configuration.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Resolves a state value from a plain state envelope.\n   *\n   * @param ctx Resolve context containing the incoming state packet.\n   * @returns The normalized resolved value, a clear signal, or undefined.\n   */\n  async computeResolve(ctx: BehaviorContext<T>): Promise<PipelineUpstreamValue<T>> {\n    vaultDebug(`${this.key} computeResolve called with \"${safeStringify(ctx.incoming)}\".`);\n\n    const incoming = ctx.incoming;\n    if (!incoming || isHttpResourceRef<T>(incoming)) {\n      vaultDebug(`${this.key} computeResolve skipped - not a valid plain state.`);\n      return;\n    }\n\n    const { value } = incoming as { value?: PipelineUpstreamValue<T> };\n\n    if (value === undefined) {\n      vaultDebug(`${this.key} value is undefined and resolution skipped.`);\n      return;\n    }\n\n    if (value === null) {\n      vaultDebug(`${this.key} value is null and clear state returned.`);\n      return VAULT_CLEAR_STATE;\n    }\n\n    if (Array.isArray(value)) {\n      vaultDebug(`${this.key} array value detected and cloned.`);\n      return [...value] as T;\n    }\n\n    if (typeof value === 'object') {\n      vaultDebug(`${this.key} object value detected and cloned.`);\n      return { ...value } as T;\n    }\n\n    vaultDebug(`${this.key} primitive value detected and returned.`);\n    return value as T;\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the resolve behavior to its initial state.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import { FeatureCellShape } from '@sdux-vault/engine';\nimport { Observable } from 'rxjs';\nimport { FromStreamOptions } from '../options/from-stream.options';\n\n/**\n * Extends a FeatureCell instance with a placeholder `fromStream` API.\n *\n * This function installs a stub implementation that is replaced at runtime\n * by the corresponding behavior. It defines the method shape so that\n * consumers may invoke `fromStream` once the behavior is installed.\n *\n * @param cell The FeatureCell instance being extended.\n */\nexport function extendFromStream<T>(cell: FeatureCellShape<T>) {\n  /**\n   * Bridges a streaming observable source into the FeatureCell pipeline.\n   *\n   * @param _source$ Observable stream emitting values to be resolved.\n   * @param _options Optional stream configuration options.\n   */\n  cell.fromStream = function (_source$: Observable<T>, _options: FromStreamOptions): void {};\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > behaviors > resolve > from-stream > with-core-from-stream.behavior.ts\n// Updated: 2026-03-02 08:26\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// --- AI Model File Path (DO NOT DELETE) ---\n\nimport {\n  BehaviorClassContext,\n  BehaviorContract,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  FeatureCellExtensionContext,\n  ResolveType,\n  ResolveTypes,\n  safeStringify,\n  StateInputType,\n  VaultBehavior,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\nimport { Observable, takeUntil } from 'rxjs';\nimport { extendFromStream } from './function/extend-from-stream.function';\nimport { FromStreamBehaviorExtension } from './interface/from-stream-behavior.interface';\nimport { FromStreamOptions } from './options/from-stream.options';\n\n@VaultBehavior({\n  type: BehaviorTypes.FromStream,\n  key: defineBehaviorKey('Core', 'FromStream'),\n  critical: false,\n  resolveType: ResolveTypes.Observable\n})\nexport class withCoreFromStreamBehavior<T> implements BehaviorContract<T, FromStreamBehaviorExtension> {\n  /** Static behavior to extend the cell api dynamically */\n  static readonly extension = extendFromStream;\n\n  /** Static behavior type used for orchestrator classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for diagnostics and devtools. */\n  static readonly key: string;\n\n  /** Indicates whether this behavior is required by the pipeline. */\n  static readonly critical: boolean;\n\n  static readonly resolveType: ResolveType;\n\n  /** The extension behavior type identifier. */\n  readonly type = withCoreFromStreamBehavior.type;\n\n  /** Unique identifier for this behavior instance. */\n  public readonly key: string;\n\n  /** Indicates that this behavior is optional within the pipeline. */\n  public readonly critical = withCoreFromStreamBehavior.critical;\n\n  public readonly resolveType = withCoreFromStreamBehavior.resolveType;\n\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  extendCellAPI(ctx: FeatureCellExtensionContext<T>): FromStreamBehaviorExtension {\n    return {\n      fromStream: (source$: Observable<T>, options?: FromStreamOptions): void => {\n        const { autoResetError = true } = options ?? {};\n\n        vaultDebug(`${this.key} fromStream called.`);\n        vaultDebug(`${this.key} fromStream options resolved (autoResetError=${autoResetError}).`);\n\n        ctx.vaultMonitor.ingressSubscribed(ctx.featureCellKey, this.key, ctx, 'fromStream');\n\n        vaultDebug(`${this.key} fromStream subscription started.`);\n\n        source$.pipe(takeUntil(ctx.destroyed$)).subscribe({\n          next: (incomingItem) => {\n            vaultDebug(`${this.key} subscription.next called.`);\n            vaultDebug(`${this.key} incoming value received: \"${safeStringify(incomingItem)}\".`);\n\n            if (autoResetError) {\n              vaultDebug(`${this.key} autoResetError enabled → clearing error.`);\n            }\n\n            const nextState: StateInputType<T> = autoResetError\n              ? { value: incomingItem, error: null }\n              : { value: incomingItem };\n\n            ctx.mergeState(nextState);\n\n            vaultDebug(`${this.key} mergeState invoked from stream.next.`);\n          },\n\n          error: (err) => {\n            vaultDebug(`${this.key} subscription.error called.`);\n\n            const vaultError = createVaultError(err, this.key);\n\n            vaultDebug(`${this.key} stream error converted to VaultError: \"${vaultError.message}\".`);\n\n            ctx.mergeState({ error: vaultError });\n\n            vaultDebug(`${this.key} mergeState invoked from stream.error.`);\n          },\n\n          complete: () => {\n            vaultDebug(`${this.key} subscription.complete called.`);\n\n            ctx.vaultMonitor.ingressCompleted(ctx.featureCellKey, this.key, ctx, 'fromStream');\n\n            vaultDebug(`${this.key} fromStream completed.`);\n          }\n        });\n      }\n    };\n  }\n\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorType,\n  BehaviorTypes,\n  CoreEmitStateBehaviorContract,\n  CoreEmitStateCallback,\n  CoreEmitStateResult,\n  defineBehaviorKey,\n  safeStringify,\n  StateSnapshotShape,\n  VAULT_NOOP,\n  VaultBehavior,\n  vaultDebug,\n  vaultError,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Core behavior responsible for invoking `emitState` callbacks.\n *\n * This behavior executes a consumer-provided callback with the current\n * immutable state snapshot, allowing external observers to react to\n * state emission events without mutating pipeline state.\n *\n * It is critical to pipeline execution and always runs during emitState\n * processing when a callback is provided.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreEmitState,\n  key: defineBehaviorKey('Core', 'EmitState'),\n  critical: true\n})\nexport class withCoreEmitStateBehavior<T> implements CoreEmitStateBehaviorContract<T> {\n  /** Static behavior type used for pipeline classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for introspection and diagnostics. */\n  static readonly key: string;\n\n  /** Indicates that emitState behavior is required in the pipeline. */\n  static readonly critical: boolean;\n\n  /** Instance-level pipeline behavior type identifier. */\n  readonly type = BehaviorTypes.CoreEmitState;\n\n  /** Indicates that this behavior must always run during emitState execution. */\n  readonly critical = true;\n\n  /** Unique identifier for this emitState behavior instance. */\n  readonly key: string;\n\n  /**\n   * Creates a new core emitState behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection and extensibility.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Executes a provided emitState callback with the current state snapshot.\n   *\n   * If the callback is not a function or throws during execution, the behavior\n   * logs the failure and returns `VAULT_NOOP` without interrupting pipeline flow.\n   *\n   * @param snapshot Immutable snapshot of the current FeatureCell state.\n   * @param callback Consumer-provided emitState callback.\n   * @returns A core emitState result or `VAULT_NOOP` when no action is taken.\n   */\n  // eslint-disable-next-line\n  emitState<T>(snapshot: StateSnapshotShape<T>, callback: CoreEmitStateCallback<T, any>): CoreEmitStateResult {\n    vaultDebug(`${this.key} emitState called with \"${safeStringify(snapshot)}\".`);\n\n    if (typeof callback !== 'function') {\n      vaultDebug(\n        `${this.key} emitState skipped. The emitState type is ${typeof callback}. \"${safeStringify(snapshot)}\" returned.`\n      );\n      return VAULT_NOOP;\n    }\n\n    try {\n      callback(snapshot);\n    } catch (err) {\n      vaultError(`${this.key} emitState execution failed`, safeStringify(err));\n      return VAULT_NOOP;\n    }\n\n    return;\n  }\n\n  /**\n   * Performs cleanup when the behavior instance is destroyed.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the emitState behavior.\n   *\n   * This behavior does not retain internal state and therefore requires\n   * no reset logic beyond lifecycle participation.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","/**\n * Canonical identifier used to mark values or errors originating outside the Vault pipeline.\n */\nexport const VAULT_EXTERNAL = 'external';\n","import { CoreStateBehaviorContract, isPipelineTerminal } from '@sdux-vault/engine';\nimport {\n  BehaviorClassContext,\n  BehaviorContext,\n  BehaviorType,\n  BehaviorTypes,\n  createVaultError,\n  defineBehaviorKey,\n  FinalState,\n  isDefined,\n  isHttpResourceRef,\n  isNull,\n  isNullish,\n  isolateValue,\n  isStateInputShape,\n  isVaultClearState,\n  isVaultNoop,\n  safeStringify,\n  StateEmitSnapshotShape,\n  StateEmitType,\n  StateEmitTypes,\n  StateInputType,\n  StateSnapshotShape,\n  VAULT_NOOP,\n  VaultBehavior,\n  vaultDebug,\n  vaultError,\n  VaultErrorShape,\n  vaultWarn\n} from '@sdux-vault/shared';\nimport { VAULT_EXTERNAL } from '../../../constants/vault-external.constant';\n\n/**\n * Core behavior responsible for committing resolved pipeline outcomes into state.\n *\n * This behavior translates pipeline execution results into immutable state\n * snapshots and emits authoritative state lifecycle events. It coordinates\n * loading, value, and error transitions and ensures state emission remains\n * atomic and ordered.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreState,\n  key: defineBehaviorKey('Core', 'State'),\n  critical: true\n})\nexport class withCoreStateBehavior<T> implements CoreStateBehaviorContract<T> {\n  /** Static behavior type used for pipeline classification. */\n  static readonly type: BehaviorType;\n\n  /** Unique behavior key used for introspection and diagnostics. */\n  static readonly key: string;\n\n  /** Indicates that this behavior is required for pipeline execution. */\n  static readonly critical: boolean;\n\n  /** Instance-level pipeline behavior type identifier. */\n  readonly type = withCoreStateBehavior.type;\n\n  /** Indicates that this behavior must always execute. */\n  readonly critical = withCoreStateBehavior.critical;\n\n  /** Unique identifier for this behavior instance. */\n  readonly key: string;\n\n  /**\n   * Creates a new core state behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Commits partial state changes and emits a single state snapshot event.\n   *\n   * @param ctx Pipeline behavior context containing state references.\n   * @param changes Partial snapshot changes or null.\n   * @param type State emission classification.\n   */\n  #commitState(ctx: BehaviorContext<T>, changes: Partial<StateSnapshotShape<T>> | null, type: StateEmitType): void {\n    vaultDebug(`${this.key} commitState called with: ${safeStringify(changes)}`);\n\n    try {\n      if (changes) {\n        const safeChanges = isolateValue(changes);\n        Object.assign(ctx.lastSnapshot, safeChanges);\n        ctx.lastSnapshot.hasValue = ctx.lastSnapshot.value !== undefined && ctx.lastSnapshot.value !== null;\n      }\n\n      const snapshotEmit = {\n        snapshot: isolateValue(ctx.lastSnapshot),\n        type\n      } as StateEmitSnapshotShape<T>;\n\n      if (ctx.options) {\n        snapshotEmit.options = ctx.options;\n      }\n\n      ctx.state$.next(snapshotEmit);\n    } catch (error) {\n      vaultError(`${this.key} an error occurred updating the state`, error);\n    }\n  }\n\n  /**\n   * Prepares incoming pipeline input and emits an initial incoming state.\n   *\n   * @param ctx Pipeline behavior context.\n   * @returns The incoming value or `VAULT_NOOP`.\n   */\n  preparePipelineIncoming(ctx: BehaviorContext<T>): StateInputType<T> | typeof VAULT_NOOP {\n    const incoming = ctx.incoming;\n    const changes: Partial<StateSnapshotShape<T>> = {};\n\n    if (isNullish(incoming) || (isStateInputShape(incoming) && isNull(incoming.value))) {\n      changes.isLoading = false;\n      changes.value = undefined;\n      changes.error = null;\n\n      this.#commitState(ctx, changes, StateEmitTypes.IncomingPipeline);\n      return VAULT_NOOP;\n    }\n\n    if (isHttpResourceRef(incoming)) {\n      changes.isLoading = true;\n    } else if (isStateInputShape(incoming)) {\n      if (!isNullish(incoming?.loading)) {\n        changes.isLoading = incoming.loading;\n      }\n\n      if (isDefined(incoming?.error)) {\n        changes.error = isNull(incoming.error) ? null : createVaultError(incoming.error, VAULT_EXTERNAL);\n      }\n    }\n\n    if (Object.keys(changes).length > 0) {\n      this.#commitState(ctx, changes, StateEmitTypes.IncomingPipeline);\n    }\n\n    return incoming;\n  }\n\n  /**\n   * Finalizes state after pipeline resolution completes.\n   *\n   * @param value Final pipeline output.\n   * @param ctx Pipeline behavior context.\n   */\n  finalizePipelineState(value: FinalState<T>, ctx: BehaviorContext<T>): void {\n    vaultDebug(`${this.key} - finalizeVaultState`);\n\n    if (isHttpResourceRef(ctx.incoming)) {\n      this.#commitState(ctx, { isLoading: false }, StateEmitTypes.FinalizePipeline);\n    }\n\n    if (isVaultNoop(value)) {\n      this.#commitState(ctx, null, StateEmitTypes.FinalizePipeline);\n      return;\n    }\n\n    if (isNull(value) || isVaultClearState(value)) {\n      this.#commitState(ctx, { value: undefined }, StateEmitTypes.FinalizePipeline);\n      return;\n    }\n\n    if (!isNullish(value) && !isPipelineTerminal(value)) {\n      this.#commitState(ctx, { value: value as T }, StateEmitTypes.FinalizePipeline);\n    }\n  }\n\n  /**\n   * Finalizes state when pipeline execution is stopped.\n   *\n   * @param ctx Pipeline behavior context.\n   */\n  finalizePipelineVaultStop(ctx: BehaviorContext<T>): void {\n    vaultDebug(`${this.key} - finalizePipelineVaultStop`);\n    this.#commitState(ctx, null, StateEmitTypes.FinalizePipeline);\n  }\n\n  /**\n   * Finalizes state when a pipeline error occurs.\n   *\n   * @param err Normalized vault error or null.\n   * @param ctx Pipeline behavior context.\n   */\n  finalizePipelineError(err: VaultErrorShape | null, ctx: BehaviorContext<T>): void {\n    vaultDebug(`${this.key} - finalizePipelineError`);\n    this.#commitState(\n      ctx,\n      {\n        error: err,\n        value: ctx.lastSnapshot.value,\n\n        isLoading: false\n      },\n      StateEmitTypes.PipelineError\n    );\n  }\n\n  /**\n   * Finalizes state when a controller abort occurs.\n   *\n   * @param ctx Pipeline behavior context.\n   */\n  finalizeControllerAbort(ctx: BehaviorContext<T>): void {\n    vaultDebug(`${this.key} - finalizeAbort`);\n    this.#commitState(ctx, { isLoading: false }, StateEmitTypes.AbortController);\n  }\n\n  /**\n   * Finalizes state when a controller deny occurs.\n   *\n   * @param ctx Pipeline behavior context.\n   */\n  finalizeControllerDeny(ctx: BehaviorContext<T>): void {\n    vaultDebug(`${this.key} - finalizeDeny`);\n    this.#commitState(ctx, { isLoading: false }, StateEmitTypes.DenyController);\n  }\n\n  /**\n   * Emits a terminal destroy state snapshot.\n   *\n   * @param ctx Pipeline behavior context.\n   */\n  destroy(ctx: BehaviorContext<T>): void {\n    vaultWarn(`${this.key} - destroy`);\n    this.#commitState(ctx, { isLoading: false, value: undefined, error: null }, StateEmitTypes.PipelineDestroy);\n  }\n\n  /**\n   * Emits a terminal reset state snapshot.\n   *\n   * @param ctx Pipeline behavior context.\n   */\n  reset(ctx: BehaviorContext<T>): void {\n    vaultWarn(`${this.key} - reset`);\n    this.#commitState(ctx, { isLoading: false, value: undefined, error: null }, StateEmitTypes.PipelineReset);\n  }\n}\n","import {\n  BehaviorClassContext,\n  BehaviorContract,\n  BehaviorType,\n  PipelineUpstreamValue,\n  TapCallback,\n  safeStringify,\n  vaultDebug,\n  vaultWarn\n} from '@sdux-vault/shared';\n\n/**\n * Abstract base class for tap behaviors in the Vault pipeline.\n *\n * This class provides shared execution logic for tap behaviors, which are\n * permitted to observe pipeline values and perform side effects without\n * modifying pipeline state. It centralizes validation, logging, and lifecycle\n * handling common to both pre- and post-reducer tap behaviors.\n *\n * @typeParam T - The pipeline state value type observed by the tap.\n */\nexport abstract class TapAbstractBehavior<T> implements BehaviorContract<T> {\n  /** Static behavior type used for pipeline classification. */\n  static readonly type: BehaviorType;\n\n  /** Static key used to identify the tap behavior. */\n  static readonly key: string;\n\n  /** Indicates that tap behaviors participate critically in the pipeline. */\n  static readonly critical = true;\n\n  /** Instance-level criticality flag. */\n  readonly critical = true;\n\n  /** Unique identifier for this tap behavior instance. */\n  readonly key: string;\n\n  readonly type!: BehaviorType;\n\n  /**\n   * Creates a new tap behavior instance.\n   *\n   * @param key Unique behavior identifier supplied by the factory.\n   * @param behaviorCtx Behavior class context for dependency injection.\n   */\n  constructor(\n    key: string,\n    readonly behaviorCtx: BehaviorClassContext\n  ) {\n    this.key = key;\n  }\n\n  /**\n   * Executes a tap callback against the current pipeline value.\n   *\n   * The tap callback is invoked for observational or side-effect purposes only.\n   * If the provided callback is not a function, execution is skipped and logged.\n   *\n   * @param current The current pipeline value being observed.\n   * @param tap The tap callback function.\n   */\n  protected executeTap(current: PipelineUpstreamValue<T>, tap: TapCallback<T>): void {\n    vaultDebug(`${this.key} executeTap called with \"${safeStringify(current)}\".`);\n\n    if (typeof tap !== 'function') {\n      vaultDebug(`${this.key} executeTap skipped - tap is not a function. Type is \"${typeof tap}\".`);\n    }\n\n    tap(current as T);\n  }\n\n  /**\n   * Invoked when the behavior instance is destroyed.\n   *\n   * Tap behaviors do not allocate resources or maintain subscriptions, so\n   * destruction performs no cleanup beyond emitting a diagnostic event.\n   */\n  destroy(): void {\n    vaultWarn(`${this.key} - destroy \"noop\"`);\n  }\n\n  /**\n   * Resets the tap behavior.\n   *\n   * Tap behaviors are stateless and require no reset logic. This method exists\n   * solely to participate in the FeatureCell lifecycle and provide diagnostic\n   * visibility.\n   */\n  reset(): void {\n    vaultWarn(`${this.key} - reset \"noop\"`);\n  }\n}\n","import {\n  AfterTapBehaviorContract,\n  BehaviorTypes,\n  defineBehaviorKey,\n  PipelineUpstreamValue,\n  TapCallback,\n  VaultBehavior\n} from '@sdux-vault/shared';\n\nimport { TapAbstractBehavior } from './tap.abstract';\n\n/**\n * Core tap behavior executed after reducer completion.\n *\n * This behavior allows consumers to observe the finalized pipeline value\n * after all reducer logic has executed. It delegates tap execution to the\n * shared tap abstraction and does not modify pipeline state.\n *\n * @typeParam T - The pipeline state value type observed by the tap.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreAfterTap,\n  key: defineBehaviorKey('Core', 'AfterTap'),\n  critical: true\n})\nexport class withCoreAfterTapBehavior<T> extends TapAbstractBehavior<T> implements AfterTapBehaviorContract<T> {\n  /** Pipeline behavior type indicating execution occurs after reducers. */\n  override readonly type = BehaviorTypes.CoreAfterTap;\n\n  /**\n   * Executes the provided tap callback after reducer completion.\n   *\n   * The tap is invoked for observational or side-effect purposes only and\n   * does not influence pipeline control flow or state resolution.\n   *\n   * @param current - The finalized pipeline value.\n   * @param tap - The tap callback to invoke.\n   */\n  applyAfterTap(current: PipelineUpstreamValue<T>, tap: TapCallback<T>): void {\n    this.executeTap(current, tap);\n  }\n}\n","import {\n  BeforeTapBehaviorContract,\n  BehaviorTypes,\n  defineBehaviorKey,\n  PipelineUpstreamValue,\n  TapCallback,\n  VaultBehavior\n} from '@sdux-vault/shared';\n\nimport { TapAbstractBehavior } from './tap.abstract';\n\n/**\n * Core tap behavior executed before reducer evaluation.\n *\n * This behavior allows consumers to observe or react to the pipeline value\n * prior to reducer execution. It delegates tap execution to the shared tap\n * abstraction and does not modify pipeline state or control flow.\n *\n * @typeParam T - The pipeline state value type observed by the tap.\n */\n@VaultBehavior({\n  type: BehaviorTypes.CoreBeforeTap,\n  key: defineBehaviorKey('Core', 'BeforeTap'),\n  critical: true\n})\nexport class withCoreBeforeTapBehavior<T> extends TapAbstractBehavior<T> implements BeforeTapBehaviorContract<T> {\n  /** Pipeline behavior type indicating execution occurs prior to reducers. */\n  override readonly type = BehaviorTypes.CoreBeforeTap;\n\n  /**\n   * Executes the provided tap callback before reducer evaluation.\n   *\n   * The tap is invoked for observational or side-effect purposes only and\n   * does not influence reducer logic or state resolution.\n   *\n   * @param current - The current pipeline value prior to reduction.\n   * @param tap - The tap callback to invoke.\n   */\n  applyBeforeTap(current: PipelineUpstreamValue<T>, tap: TapCallback<T>): void {\n    this.executeTap(current, tap);\n  }\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > factories > feature-cell > feature-cell.ts\n// Updated: 2026-03-02 19:53\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  createFeatureCellToken,\n  FeatureCellClass,\n  FeatureCellConfig,\n  FeatureCellShape,\n  registerFeatureCell\n} from '@sdux-vault/engine';\nimport { BehaviorClassContract, ControllerClassContract } from '@sdux-vault/shared';\nimport { withCoreErrorCallbackBehavior } from '../../behaviors/error/with-core-error-callback/with-core-error-callback.behavior';\nimport { withCoreErrorBehavior } from '../../behaviors/error/with-core-error/with-core-error.behavior';\nimport { withCoreFilterBehavior } from '../../behaviors/filter/with-core-filter.behavior';\nimport { withArrayMergeBehavior } from '../../behaviors/merge/array/with-array-merge.behavior';\nimport { withCoreFromObservableBehavior } from '../../behaviors/observable/with-core-from-observable.behavior';\nimport { withCoreFromPromiseBehavior } from '../../behaviors/promise/with-core-from-promise.behavior';\nimport { withCoreReducerBehavior } from '../../behaviors/reducer/with-core-reducer.behavior';\nimport { withCoreObservableBehavior } from '../../behaviors/resolve/core-observable/with-core-observable.behavior';\nimport { withCorePromiseBehavior } from '../../behaviors/resolve/core-promise/with-core-promise.behavior';\nimport { withCoreValueBehavior } from '../../behaviors/resolve/core-value/with-core-value.behavior';\nimport { withCoreFromStreamBehavior } from '../../behaviors/resolve/from-stream/with-core-from-stream.behavior';\nimport { withCoreEmitStateBehavior } from '../../behaviors/state/with-core-emit-state/with-core-emit-state.behavior';\nimport { withCoreStateBehavior } from '../../behaviors/state/with-core-state/with-core-state.behavior';\nimport { withCoreAfterTapBehavior } from '../../behaviors/tap/with-core-after-tap.behavior';\nimport { withCoreBeforeTapBehavior } from '../../behaviors/tap/with-core-before-tap.behavior';\n\n/**\n * Creates and registers a Feature Cell using the provided configuration and optional behavior and controller contracts.\n * This function produces a Feature Cell instance keyed by the descriptor and registers it for later resolution and usage.\n *\n * --RelatedStart--\n * FeatureCellConfig\n * BehaviorClassContract\n * ControllerClassContract\n * FeatureCellShape\n * --RelatedEnd--\n *\n * @param descriptor Configuration descriptor that defines the Feature Cell identity and setup.\n * @param behaviors Behavior class contracts applied during Feature Cell construction.\n * @param controllers Controller class contracts applied during Feature Cell construction.\n * @returns The registered Feature Cell instance.\n */\nexport function FeatureCell<T>(\n  descriptor: FeatureCellConfig<T>,\n  behaviors: BehaviorClassContract<T>[] = [],\n  controllers: ControllerClassContract<T>[] = []\n): FeatureCellShape<T> {\n  createFeatureCellToken(descriptor.key);\n\n  registerFeatureCell({\n    key: descriptor.key\n  });\n\n  return new FeatureCellClass(descriptor, loadDefaultBehaviors(), behaviors, controllers).build();\n}\n\nfunction loadDefaultBehaviors<T>(): BehaviorClassContract<T>[] {\n  return [\n    withCoreAfterTapBehavior,\n    withCoreBeforeTapBehavior,\n    withCoreErrorBehavior,\n    withCoreFilterBehavior,\n    withCoreFromObservableBehavior,\n    withCoreFromPromiseBehavior,\n    withCoreFromStreamBehavior,\n    withCoreObservableBehavior,\n    withCorePromiseBehavior,\n    withCoreReducerBehavior,\n    withCoreValueBehavior,\n    withCoreStateBehavior,\n    withCoreErrorCallbackBehavior,\n    withArrayMergeBehavior,\n    withCoreEmitStateBehavior\n  ];\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > lib > factories > vault > vault.ts\n// Updated: 2026-03-02 19: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\nimport { VaultCore } from '@sdux-vault/engine';\nimport { VaultConfig } from '@sdux-vault/shared';\n\n/**\n * Initializes the Vault runtime using the provided configuration and prepares the global feature cell registry.\n * This function establishes the required Vault infrastructure and applies the supplied options for core initialization.\n *\n * --RelatedStart--\n * VaultConfig\n * --RelatedEnd--\n *\n * @param options Configuration options used to initialize the Vault runtime.\n */\nexport function Vault(options: VaultConfig = {}): void {\n  VaultCore(options);\n}\n","// --- AI Model File Path (DO NOT DELETE) ---\n// FilePath: libs > core > src > public-api.ts\n// Updated: 2026-03-03 07:37\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 './extensions';\nexport * from './extensions';\n\nimport './lib/version/version.register';\n\nexport { withObjectShallowMergeBehavior } from './lib/behaviors/merge/object/with-object-shallow-merge.behavior';\nexport type { FromStreamOptions } from './lib/behaviors/resolve/from-stream/options/from-stream.options';\nexport { FeatureCell } from './lib/factories/feature-cell/feature-cell';\nexport { Vault } from './lib/factories/vault/vault';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@sdux-vault/core",
+  "version": "0.0.9",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/sdux-vault/core.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "homepage": "https://www.sdux-vault.com",
+  "dependencies": {
+    "tslib": "^2.3.0"
+  },
+  "peerDependencies": {
+    "@sdux-vault/engine": "^0.0.9",
+    "@sdux-vault/shared": ">=0.0.6 <0.1.0",
+    "rxjs": "^7.0.0"
+  },
+  "files": [
+    "fesm2022/",
+    "types/",
+    "README.md",
+    "LICENSE",
+    "package.json"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "types": "./types/sdux-vault-core.d.ts",
+  "main": "./fesm2022/sdux-vault-core.mjs",
+  "sideEffects": [
+    "./fesm2022/*.mjs",
+    "src/lib/version/version.register.ts",
+    "src/lib/behaviors/observable/interface/from-observable-behavior.interface",
+    "src/lib/behaviors/promise/interface/from-promise-behavior.interface",
+    "src/lib/behaviors/resolve/from-stream/interface/from-stream-behavior.interface",
+    "src/extensions/index.ts"
+  ],
+  "module": "fesm2022/sdux-vault-core.mjs",
+  "typings": "types/sdux-vault-core.d.ts",
+  "exports": {
+    "./package.json": {
+      "default": "./package.json"
+    },
+    ".": {
+      "types": "./types/sdux-vault-core.d.ts",
+      "default": "./fesm2022/sdux-vault-core.mjs"
+    }
+  }
+}

package/types/sdux-vault-core.d.ts

@@ -0,0 +1,219 @@
+import { VaultStateRef, FeatureCellConfig, FeatureCellShape } from '@sdux-vault/engine';
+import { BehaviorExtFunction, DeferredFactory, StateInputShape, MergeBehaviorContract, BehaviorClassContext, BehaviorType, PipelineUpstreamValue, MergeConfig, BehaviorClassContract, ControllerClassContract, VaultConfig } from '@sdux-vault/shared';
+import { Observable } from 'rxjs';
+
+/**
+ * Extension contract for observable-based FeatureCell integration.
+ *
+ * This interface defines the shape of the dynamically injected
+ * `fromObservable` API that allows a FeatureCell to accept observable
+ * sources and expose them as normalized vault state references.
+ */
+interface FromObservableBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {
+    [key: string]: BehaviorExtFunction | undefined;
+    /**
+     * Behavior extension function that installs the `fromObservable` API.
+     */
+    fromObservable: BehaviorExtFunction;
+}
+declare module '@sdux-vault/shared' {
+    /**
+     * FeatureCell extension interface augmented with observable integration support.
+     */
+    interface FeatureCellExtension<TEntity> {
+        /**
+         * Wraps an observable source and exposes it as a stream of vault state references.
+         *
+         * @param source$ Observable emitting raw entity values.
+         * @returns Observable emitting vault state references.
+         */
+        fromObservable?(source$: Observable<TEntity>): Observable<VaultStateRef<TEntity>>;
+    }
+}
+declare const __fromObservable = true;
+
+/**
+ * Runtime extension contract for promise-based state resolution APIs.
+ *
+ * This interface defines the behavior extension surface exposed when a
+ * promise-capable resolve behavior is installed. It declares the dynamic
+ * methods added to a FeatureCell to support deferred and promise-based
+ * resolution through the pipeline.
+ *
+ * --RelatedStart--
+ * DeferredFactory
+ * --RelatedEnd--
+ */
+interface FromPromiseBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {
+    [key: string]: BehaviorExtFunction | undefined;
+    /**
+     * Resolves state from a deferred factory using promise semantics.
+     */
+    fromPromise: BehaviorExtFunction;
+    /**
+     * Resolves state from a deferred factory using deferred semantics.
+     */
+    fromDeferred: BehaviorExtFunction;
+}
+declare module '@sdux-vault/shared' {
+    /**
+     * FeatureCell extension methods for promise-based state resolution.
+     */
+    interface FeatureCellExtension<TEntity> {
+        /**
+         * Resolves state from a deferred factory using deferred semantics.
+         *
+         * @param incoming Deferred factory that produces the state value.
+         * @returns A promise resolving to a normalized state envelope.
+         */
+        fromDeferred?(incoming: DeferredFactory<TEntity>): Promise<StateInputShape<TEntity>>;
+        /**
+         * Resolves state from a deferred factory using promise semantics.
+         *
+         * @param incoming Deferred factory that produces the state value.
+         * @returns A promise resolving to a normalized state envelope.
+         */
+        fromPromise?(incoming: DeferredFactory<TEntity>): Promise<StateInputShape<TEntity>>;
+    }
+}
+declare const __fromPromise_extension = true;
+
+interface FromStreamOptions {
+    /**
+     * When true (default), any successful `next` clears the error state.
+     */
+    autoResetError?: boolean;
+}
+
+/**
+ * Runtime extension contract for behaviors that expose a `fromStream` API.
+ *
+ * This interface defines the shape of the dynamically injected extension
+ * that enables streaming observable sources to participate in pipeline
+ * execution through a FeatureCell instance.
+ */
+interface FromStreamBehaviorExtension extends Partial<Record<string, BehaviorExtFunction>> {
+    [key: string]: BehaviorExtFunction | undefined;
+    /**
+     * Function used to bridge an observable stream into the FeatureCell pipeline.
+     */
+    fromStream: BehaviorExtFunction;
+}
+declare module '@sdux-vault/shared' {
+    /**
+     * FeatureCell extension surface for stream-based resolution.
+     */
+    interface FeatureCellExtension<TEntity> {
+        /**
+         * Submits a streaming observable source for pipeline processing.
+         *
+         * @param source$ Observable stream emitting candidate values.
+         * @param options Optional configuration controlling stream behavior.
+         */
+        fromStream?(source$: Observable<TEntity>, options?: FromStreamOptions): void;
+    }
+}
+declare const __fromStream_extension = true;
+
+declare const __core_extensions_loaded = true;
+
+/**
+ * Shallow object merge behavior for the Vault merge stage.
+ *
+ * This behavior performs a one-level object merge where the incoming
+ * object spreads over the existing state. Non-object values, arrays,
+ * and `null` values bypass merging and are returned directly.
+ *
+ * The behavior also supports optional merge configuration, such as
+ * `clearUndefined`, which determines whether an `undefined` incoming
+ * value should clear the current state.
+ *
+ * This merge strategy is marked as a core, critical behavior and must
+ * always be present when selected as the FeatureCell’s merge behavior.
+ *
+ * @typeParam T - The state value type processed during merge.
+ */
+declare class withObjectShallowMergeBehavior<T> implements MergeBehaviorContract<T> {
+    readonly behaviorCtx: BehaviorClassContext;
+    /** Static metadata used for orchestrator behavior classification. */
+    static readonly type: BehaviorType;
+    /** Unique identifier for behavior diagnostics and devtools. */
+    static readonly key: string;
+    /** Indicates this merge behavior is pipeline-critical. */
+    static readonly critical = true;
+    /** Pipeline behavior type identifier. */
+    readonly type: "merge";
+    /** Unique merge behavior instance identifier. */
+    readonly key: string;
+    /** Instance-level criticality flag. */
+    readonly critical = true;
+    /**
+     * Creates a new shallow object merge behavior instance.
+     *
+     * @param key - Unique behavior identifier supplied by the factory.
+     * @param behaviorCtx - BehaviorCtx for future extensibility hooks.
+     */
+    constructor(key: string, behaviorCtx: BehaviorClassContext);
+    /**
+     * Computes the shallow merge result between the current state and
+     * the incoming value. Non-object inputs bypass merging and are
+     * forwarded directly. When `clearUndefined=true`, an undefined
+     * incoming value clears the state.
+     *
+     * @param currentValue - The current FeatureCell state value.
+     * @param nextValue - The incoming value to merge into the current state.
+     * @param options - Optional merge configuration including `clearUndefined`.
+     * @returns The merged or forwarded next state value.
+     */
+    computeMerge(currentValue: PipelineUpstreamValue<T> | undefined, nextValue: PipelineUpstreamValue<T> | undefined, options?: MergeConfig): PipelineUpstreamValue<T> | undefined;
+    /**
+     * Invoked when the behavior instance is destroyed.
+     * This merge behavior maintains no internal resources.
+     */
+    destroy(): void;
+    /**
+     * Resets the shallow merge behavior.
+     *
+     * Object shallow merge is a fully stateless, pure merge strategy.
+     * It holds no timers, caches, or internal merge state, meaning
+     * there is nothing to reset. This lifecycle hook exists solely
+     * to support the FeatureCell reset pipeline and to provide a
+     * diagnostic signal for DevTools and monitoring systems.
+     *
+     * After reset, the behavior continues to function identically.
+     */
+    reset(): void;
+}
+
+/**
+ * Creates and registers a Feature Cell using the provided configuration and optional behavior and controller contracts.
+ * This function produces a Feature Cell instance keyed by the descriptor and registers it for later resolution and usage.
+ *
+ * --RelatedStart--
+ * FeatureCellConfig
+ * BehaviorClassContract
+ * ControllerClassContract
+ * FeatureCellShape
+ * --RelatedEnd--
+ *
+ * @param descriptor Configuration descriptor that defines the Feature Cell identity and setup.
+ * @param behaviors Behavior class contracts applied during Feature Cell construction.
+ * @param controllers Controller class contracts applied during Feature Cell construction.
+ * @returns The registered Feature Cell instance.
+ */
+declare function FeatureCell<T>(descriptor: FeatureCellConfig<T>, behaviors?: BehaviorClassContract<T>[], controllers?: ControllerClassContract<T>[]): FeatureCellShape<T>;
+
+/**
+ * Initializes the Vault runtime using the provided configuration and prepares the global feature cell registry.
+ * This function establishes the required Vault infrastructure and applies the supplied options for core initialization.
+ *
+ * --RelatedStart--
+ * VaultConfig
+ * --RelatedEnd--
+ *
+ * @param options Configuration options used to initialize the Vault runtime.
+ */
+declare function Vault(options?: VaultConfig): void;
+
+export { FeatureCell, Vault, __core_extensions_loaded, __fromObservable, __fromPromise_extension, __fromStream_extension, withObjectShallowMergeBehavior };
+export type { FromObservableBehaviorExtension, FromPromiseBehaviorExtension, FromStreamBehaviorExtension, FromStreamOptions };