@sdux-vault/shared 0.9.0 → 0.9.2

package/README.md

@@ -1,9 +1,10 @@
+Deterministic state management for every framework — one pipeline, zero ambiguity.
+
 <p align="center">
   <img src="https://raw.githubusercontent.com/sdux-vault/vault/main/apps/docs-app/assets/brand/sdux/brand-landscape.svg" height="80" alt="SDuX Vault" />
 </p>
 
 <h3 align="center">Plain TypeScript. Zero Magic.</h3>
-<p align="center">Deterministic state management for every framework — one pipeline, zero ambiguity.</p>
 
 # @sdux-vault/shared
 
@@ -87,13 +88,13 @@ npm install @sdux-vault/core
 
 ## Ecosystem
 
-| Package                                                                                      | Purpose                                      |
-| -------------------------------------------------------------------------------------------- | -------------------------------------------- |
-| [`@sdux-vault/engine`](https://www.npmjs.com/package/@sdux-vault/engine)                     | Orchestration, conductor, decision engine    |
-| [`@sdux-vault/core`](https://www.npmjs.com/package/@sdux-vault/core)                         | Behavior runtime and pipeline execution      |
-| [`@sdux-vault/addons`](https://www.npmjs.com/package/@sdux-vault/addons)                     | Optional runtime policies and controllers    |
-| [`@sdux-vault/core-extensions`](https://www.npmjs.com/package/@sdux-vault/core-extensions)   | Framework integrations (Angular, React, Vue) |
-| [`@sdux-vault/devtools-tooling`](https://www.npmjs.com/package/@sdux-vault/devtools-tooling) | Observability and debugging                  |
+| Package                                                                                    | Purpose                                      |
+| ------------------------------------------------------------------------------------------ | -------------------------------------------- |
+| [`@sdux-vault/engine`](https://www.npmjs.com/package/@sdux-vault/engine)                   | Orchestration, conductor, decision engine    |
+| [`@sdux-vault/core`](https://www.npmjs.com/package/@sdux-vault/core)                       | Behavior runtime and pipeline execution      |
+| [`@sdux-vault/addons`](https://www.npmjs.com/package/@sdux-vault/addons)                   | Optional runtime policies and controllers    |
+| [`@sdux-vault/core-extensions`](https://www.npmjs.com/package/@sdux-vault/core-extensions) | Framework integrations (Angular, React, Vue) |
+| [`@sdux-vault/devtools`](https://www.npmjs.com/package/@sdux-vault/devtools)               | Observability and debugging                  |
 
 ---
 

package/fesm2022/sdux-vault-shared.mjs

@@ -1,47 +1,17 @@
 import { BehaviorSubject, Subscription, tap } from 'rxjs';
 
-/** Singleton accessor that detects whether code is running in a test environment. */
-const isTestEnv = {
-    get active() {
-        return (
-        // eslint-disable-next-line
-        typeof globalThis.jasmine !== 'undefined' ||
-            // istanbul ignore next
-            // eslint-disable-next-line
-            typeof globalThis.jest !== 'undefined' ||
-            // istanbul ignore next
-            // eslint-disable-next-line
-            typeof globalThis.vitest !== 'undefined');
-    }
-};
-
-/** Tracks whether Vault development mode has been enabled. */
-let devMode = null;
-/** Singleton accessor for Vault development mode state. */
-const DevMode = {
-    get active() {
-        return devMode === true;
-    },
-    setDevMode(isDevMode) {
-        if (devMode !== null && !isTestEnv.active) {
-            throw new Error('[vault] DevMode has already been initialized.');
-        }
-        devMode = isDevMode;
-    }
-};
-
 /**
- * Registers a package version on the global SDuX debug widget when dev mode is active.
+ * Registers a package version on the global SDuX namespace.
  *
  * @param packageName - The npm package name to register.
  * @param version - The semver version string.
  */
 const registerVersion = (packageName, version) => {
-    if (!DevMode.active || typeof globalThis === 'undefined')
+    // istanbul ignore next line - globalThis is always defined in supported runtimes
+    if (typeof globalThis === 'undefined')
         return;
     const sdux = (globalThis.sdux ??= {});
-    const debug = (sdux.debugWidget ??= {});
-    const versions = (debug.versions ??= {});
+    const versions = (sdux.versions ??= {});
     if (versions[packageName] === version)
         return;
     versions[packageName] = version;
@@ -50,7 +20,7 @@ const registerVersion = (packageName, version) => {
 /** Package name used for version registration. */
 const SDUX_PACKAGE = '@sdux-vault/shared';
 /** Current package version string. */
-const SDUX_VERSION = '0.9.0';
+const SDUX_VERSION = '0.9.3';
 registerVersion(SDUX_PACKAGE, SDUX_VERSION);
 
 /**
@@ -66,7 +36,6 @@ registerVersion(SDUX_PACKAGE, SDUX_VERSION);
 const BehaviorTypes = {
     CoreAfterTap: 'coreAfterTap',
     CoreBeforeTap: 'coreBeforeTap',
-    ReplayGlobalError: 'replayGlobalError',
     CoreError: 'coreError',
     CoreErrorCallback: 'coreErrorCallback',
     CoreState: 'coreState',
@@ -864,6 +833,7 @@ const DecisionOutcomeTypes = {
 
 /** Enumeration of event boundary positions within a lifecycle span. */
 const EventBoundaryTypes = {
+    Candidate: 'candidate',
     End: 'end',
     Notification: 'notification',
     Start: 'start',
@@ -875,6 +845,7 @@ const EventTypes = {
     Conductor: 'conductor',
     Controller: 'controller',
     Lifecycle: 'lifecycle',
+    Pipeline: 'pipeline',
     Stage: 'stage',
     Unknown: 'unknown'
 };
@@ -886,6 +857,17 @@ const OperationTypes = {
     Initialize: 'initialize'
 };
 
+/** Enumeration of pipeline stages that produce state-transforming snapshots for DevTools diffing. */
+const PipelineStages = {
+    PipelineStart: 'pipeline-start',
+    Resolve: 'resolve',
+    ComputeMerge: 'compute-merge',
+    Operator: 'operator',
+    Filter: 'filter',
+    Reducer: 'reducer',
+    CoreState: 'core-state'
+};
+
 /**
  * Enumerates the available resolve strategy identifiers used by resolve
  * behaviors. These identifiers indicate how a FeatureCell obtains its initial
@@ -915,6 +897,22 @@ const StateEmitTypes = {
     TabSync: 'Tab Sync'
 };
 
+/** Enumeration of Vault license tier classifications. */
+const VaultLicensePayloadTypes = {
+    Development: 'development',
+    Pro: 'pro',
+    Enterprise: 'enterprise'
+};
+
+/** Enumeration of license validation statuses for FeatureCell registration. */
+const VaultRegistrationLicenseStatusTypes = {
+    NotRequired: 'not-required',
+    Pending: 'pending',
+    Revoked: 'revoked',
+    Timeout: 'timeout',
+    Valid: 'valid'
+};
+
 /* -----------------------------------------------------------
  * TYPES (USER-FACING)
  * --------------------------------------------------------- */
@@ -1006,6 +1004,36 @@ function isDeferredFactory(value) {
         typeof value.value === 'function');
 }
 
+/** Singleton accessor that detects whether code is running in a test environment. */
+const isTestEnv = {
+    get active() {
+        return (
+        // eslint-disable-next-line
+        typeof globalThis.jasmine !== 'undefined' ||
+            // istanbul ignore next
+            // eslint-disable-next-line
+            typeof globalThis.jest !== 'undefined' ||
+            // istanbul ignore next
+            // eslint-disable-next-line
+            typeof globalThis.vitest !== 'undefined');
+    }
+};
+
+/** Tracks whether Vault development mode has been enabled. */
+let devMode = null;
+/** Singleton accessor for Vault development mode state. */
+const DevMode = {
+    get active() {
+        return devMode === true;
+    },
+    setDevMode(isDevMode) {
+        if (devMode !== null && !isTestEnv.active) {
+            throw new Error('[vault] DevMode has already been initialized.');
+        }
+        devMode = isDevMode;
+    }
+};
+
 /**
  * Normalizes any thrown error into a canonical `VaultError` structure.
  *
@@ -1323,5 +1351,5 @@ function isHttpResourceRef(obj) {
  * Generated bundle index. Do not edit.
  */
 
-export { AbstractActiveController, AbstractErrorCallbackBehavior, AbstractErrorTransformBehavior, BEHAVIOR_META, BehaviorTypes, CONTROLLER_META, ControllerMessageTypes, ControllerTypes, ControllerVotes, DEVTOOLS_AGGREGATE_KEY_CONSTANT, DEVTOOLS_LOGGING_KEY_CONSTANT, DecisionOutcomeTypes, DevMode, EventBoundaryTypes, EventTypes, LogLevelTypes, OperationTypes, ResolveTypes, StateEmitTypes, VAULT_CLEAR_STATE, VAULT_CONTINUE, VAULT_NOOP, VAULT_STOP, VaultBehavior, VaultController, VaultEncryptionIntegrityError, VaultError, VaultErrorKindTypes, VaultErrorNameTypes, VaultErrorService, VaultErrorUsageKindTypes, VaultLicenseError, VaultPrivateErrorService, VaultUsageError, VaultUsagePromiseError, VaultUsagePromiseFactoryRequiredError, createVaultError, defineBehaviorKey, defineControllerKey, getVaultLogLevel, isDeferredFactory, isDefined, isFunction, isHttpResourceRef, isNull, isNullish, isObject, isPromise, isStateInputShape, isTestEnv, isUndefined, isVaultClearState, isVaultContinue, isVaultNoop, isolateValue, registerVersion, safeStringify, setVaultLogLevel, validateBehaviorKey, validateControllerKey, vaultDebug, vaultError, vaultLog, vaultWarn };
+export { AbstractActiveController, AbstractErrorCallbackBehavior, AbstractErrorTransformBehavior, BEHAVIOR_META, BehaviorTypes, CONTROLLER_META, ControllerMessageTypes, ControllerTypes, ControllerVotes, DEVTOOLS_AGGREGATE_KEY_CONSTANT, DEVTOOLS_LOGGING_KEY_CONSTANT, DecisionOutcomeTypes, DevMode, EventBoundaryTypes, EventTypes, LogLevelTypes, OperationTypes, PipelineStages, ResolveTypes, StateEmitTypes, VAULT_CLEAR_STATE, VAULT_CONTINUE, VAULT_NOOP, VAULT_STOP, VaultBehavior, VaultController, VaultEncryptionIntegrityError, VaultError, VaultErrorKindTypes, VaultErrorNameTypes, VaultErrorService, VaultErrorUsageKindTypes, VaultLicenseError, VaultLicensePayloadTypes, VaultPrivateErrorService, VaultRegistrationLicenseStatusTypes, VaultUsageError, VaultUsagePromiseError, VaultUsagePromiseFactoryRequiredError, createVaultError, defineBehaviorKey, defineControllerKey, getVaultLogLevel, isDeferredFactory, isDefined, isFunction, isHttpResourceRef, isNull, isNullish, isObject, isPromise, isStateInputShape, isTestEnv, isUndefined, isVaultClearState, isVaultContinue, isVaultNoop, isolateValue, registerVersion, safeStringify, setVaultLogLevel, validateBehaviorKey, validateControllerKey, vaultDebug, vaultError, vaultLog, vaultWarn };
 //# sourceMappingURL=sdux-vault-shared.mjs.map