@signaltree/enterprise 4.0.13 → 4.0.15

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@signaltree/enterprise",
-  "version": "4.0.13",
+  "version": "4.0.15",
   "description": "Enterprise-grade optimizations for SignalTree. Provides diff-based updates, bulk operation optimization, and advanced change tracking for large-scale applications.",
   "type": "module",
   "sideEffects": false,
@@ -43,6 +43,9 @@
   "dependencies": {
     "tslib": "^2.3.0"
   },
+  "devDependencies": {
+    "@signaltree/core": "workspace:*"
+  },
   "files": [
     "src",
     "README.md",

package/src/index.d.ts

@@ -0,0 +1,6 @@
+export * from './lib/diff-engine';
+export * from './lib/path-index';
+export * from './lib/update-engine';
+export * from './lib/enterprise-enhancer';
+export * from './lib/scheduler';
+export * from './lib/thread-pools';

package/src/index.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./lib/diff-engine"), exports);
+tslib_1.__exportStar(require("./lib/path-index"), exports);
+tslib_1.__exportStar(require("./lib/update-engine"), exports);
+tslib_1.__exportStar(require("./lib/enterprise-enhancer"), exports);
+tslib_1.__exportStar(require("./lib/scheduler"), exports);
+tslib_1.__exportStar(require("./lib/thread-pools"), exports);
+//# sourceMappingURL=index.js.map

package/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../packages/enterprise/src/index.ts"],"names":[],"mappings":";;;AAAA,4DAAkC;AAClC,2DAAiC;AACjC,8DAAoC;AACpC,oEAA0C;AAC1C,0DAAgC;AAChC,6DAAmC"}

package/src/lib/diff-engine.d.ts

@@ -0,0 +1,108 @@
+/**
+ * DiffEngine - Efficient change detection for tree updates
+ * @packageDocumentation
+ */
+import type { Path } from './path-index';
+/**
+ * Type of change detected
+ */
+export declare enum ChangeType {
+    ADD = "add",
+    UPDATE = "update",
+    DELETE = "delete",
+    REPLACE = "replace"
+}
+/**
+ * A detected change
+ */
+export interface Change {
+    /** Type of change */
+    type: ChangeType;
+    /** Path to the changed value */
+    path: Path;
+    /** New value */
+    value?: unknown;
+    /** Old value (for updates/deletes) */
+    oldValue?: unknown;
+}
+/**
+ * Diff result
+ */
+export interface Diff {
+    /** List of changes */
+    changes: Change[];
+    /** Whether any changes were detected */
+    hasChanges: boolean;
+}
+/**
+ * Configuration for diff operation
+ */
+export interface DiffOptions {
+    /** Maximum depth to traverse */
+    maxDepth?: number;
+    /** Whether to detect deletions */
+    detectDeletions?: boolean;
+    /** Whether to ignore array order */
+    ignoreArrayOrder?: boolean;
+    /** Custom equality function */
+    equalityFn?: (a: unknown, b: unknown) => boolean;
+    /** Optional key validator for security (e.g., to prevent prototype pollution) */
+    keyValidator?: (key: string) => boolean;
+}
+/**
+ * DiffEngine
+ *
+ * Efficiently detects changes between two objects to minimize unnecessary updates.
+ *
+ * Features:
+ * - Deep object comparison
+ * - Circular reference detection
+ * - Configurable equality checking
+ * - Array diffing (ordered and unordered)
+ * - Path tracking for precise updates
+ *
+ * @example
+ * ```ts
+ * const engine = new DiffEngine();
+ *
+ * const current = { user: { name: 'Alice', age: 30 } };
+ * const updates = { user: { name: 'Alice', age: 31 } };
+ *
+ * const diff = engine.diff(current, updates);
+ *
+ * console.log(diff.changes);
+ * // [{ type: 'update', path: ['user', 'age'], value: 31, oldValue: 30 }]
+ * ```
+ */
+export declare class DiffEngine {
+    private defaultOptions;
+    /**
+     * Diff two objects and return changes
+     *
+     * @param current - Current state
+     * @param updates - Updated state
+     * @param options - Diff options
+     * @returns Diff result with all changes
+     */
+    diff(current: unknown, updates: unknown, options?: DiffOptions): Diff;
+    /**
+     * Traverse and compare objects recursively
+     */
+    private traverse;
+    /**
+     * Diff arrays
+     */
+    private diffArrays;
+    /**
+     * Diff arrays in order (index-based)
+     */
+    private diffArraysOrdered;
+    /**
+     * Diff arrays ignoring order (value-based)
+     */
+    private diffArraysUnordered;
+    /**
+     * Stringify value for set comparison
+     */
+    private stringify;
+}

package/src/lib/diff-engine.js

@@ -0,0 +1,236 @@
+"use strict";
+/**
+ * DiffEngine - Efficient change detection for tree updates
+ * @packageDocumentation
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiffEngine = exports.ChangeType = void 0;
+/**
+ * Type of change detected
+ */
+var ChangeType;
+(function (ChangeType) {
+    ChangeType["ADD"] = "add";
+    ChangeType["UPDATE"] = "update";
+    ChangeType["DELETE"] = "delete";
+    ChangeType["REPLACE"] = "replace";
+})(ChangeType || (exports.ChangeType = ChangeType = {}));
+/**
+ * DiffEngine
+ *
+ * Efficiently detects changes between two objects to minimize unnecessary updates.
+ *
+ * Features:
+ * - Deep object comparison
+ * - Circular reference detection
+ * - Configurable equality checking
+ * - Array diffing (ordered and unordered)
+ * - Path tracking for precise updates
+ *
+ * @example
+ * ```ts
+ * const engine = new DiffEngine();
+ *
+ * const current = { user: { name: 'Alice', age: 30 } };
+ * const updates = { user: { name: 'Alice', age: 31 } };
+ *
+ * const diff = engine.diff(current, updates);
+ *
+ * console.log(diff.changes);
+ * // [{ type: 'update', path: ['user', 'age'], value: 31, oldValue: 30 }]
+ * ```
+ */
+class DiffEngine {
+    constructor() {
+        this.defaultOptions = {
+            maxDepth: 100,
+            detectDeletions: false,
+            ignoreArrayOrder: false,
+            equalityFn: (a, b) => a === b,
+            keyValidator: undefined,
+        };
+    }
+    /**
+     * Diff two objects and return changes
+     *
+     * @param current - Current state
+     * @param updates - Updated state
+     * @param options - Diff options
+     * @returns Diff result with all changes
+     */
+    diff(current, updates, options = {}) {
+        const opts = Object.assign(Object.assign({}, this.defaultOptions), options);
+        const changes = [];
+        const visited = new WeakSet();
+        this.traverse(current, updates, [], changes, visited, opts, 0);
+        return {
+            changes,
+            hasChanges: changes.length > 0,
+        };
+    }
+    /**
+     * Traverse and compare objects recursively
+     */
+    traverse(curr, upd, path, changes, visited, opts, depth) {
+        // Depth limit
+        if (depth > opts.maxDepth) {
+            return;
+        }
+        // Handle primitives
+        if (typeof upd !== 'object' || upd === null) {
+            if (!opts.equalityFn(curr, upd)) {
+                changes.push({
+                    type: curr === undefined ? ChangeType.ADD : ChangeType.UPDATE,
+                    path: [...path],
+                    value: upd,
+                    oldValue: curr,
+                });
+            }
+            return;
+        }
+        // Circular reference detection
+        if (visited.has(upd)) {
+            return;
+        }
+        visited.add(upd);
+        // Handle arrays
+        if (Array.isArray(upd)) {
+            this.diffArrays(curr, upd, path, changes, visited, opts, depth);
+            return;
+        }
+        // Handle objects
+        if (!curr || typeof curr !== 'object' || Array.isArray(curr)) {
+            // Type mismatch - replace entire subtree
+            changes.push({
+                type: ChangeType.REPLACE,
+                path: [...path],
+                value: upd,
+                oldValue: curr,
+            });
+            return;
+        }
+        // Diff object properties
+        const currObj = curr;
+        const updObj = upd;
+        for (const key in updObj) {
+            if (Object.prototype.hasOwnProperty.call(updObj, key)) {
+                // Validate key for security (e.g., prevent prototype pollution)
+                if (opts.keyValidator && !opts.keyValidator(key)) {
+                    // Skip dangerous keys silently
+                    continue;
+                }
+                this.traverse(currObj[key], updObj[key], [...path, key], changes, visited, opts, depth + 1);
+            }
+        }
+        // Check for deletions if enabled
+        if (opts.detectDeletions) {
+            for (const key in currObj) {
+                if (Object.prototype.hasOwnProperty.call(currObj, key) &&
+                    !(key in updObj)) {
+                    changes.push({
+                        type: ChangeType.DELETE,
+                        path: [...path, key],
+                        oldValue: currObj[key],
+                    });
+                }
+            }
+        }
+    }
+    /**
+     * Diff arrays
+     */
+    diffArrays(curr, upd, path, changes, visited, opts, depth) {
+        if (!Array.isArray(curr)) {
+            // Not an array - replace
+            changes.push({
+                type: ChangeType.REPLACE,
+                path: [...path],
+                value: upd,
+                oldValue: curr,
+            });
+            return;
+        }
+        if (opts.ignoreArrayOrder) {
+            this.diffArraysUnordered(curr, upd, path, changes, opts);
+        }
+        else {
+            this.diffArraysOrdered(curr, upd, path, changes, visited, opts, depth);
+        }
+    }
+    /**
+     * Diff arrays in order (index-based)
+     */
+    diffArraysOrdered(curr, upd, path, changes, visited, opts, depth) {
+        // Check each index
+        const maxLength = Math.max(curr.length, upd.length);
+        for (let i = 0; i < maxLength; i++) {
+            if (i >= upd.length) {
+                // Deletion (if enabled)
+                if (opts.detectDeletions) {
+                    changes.push({
+                        type: ChangeType.DELETE,
+                        path: [...path, i],
+                        oldValue: curr[i],
+                    });
+                }
+            }
+            else if (i >= curr.length) {
+                // Addition
+                changes.push({
+                    type: ChangeType.ADD,
+                    path: [...path, i],
+                    value: upd[i],
+                });
+            }
+            else {
+                // Potential update
+                this.traverse(curr[i], upd[i], [...path, i], changes, visited, opts, depth + 1);
+            }
+        }
+    }
+    /**
+     * Diff arrays ignoring order (value-based)
+     */
+    diffArraysUnordered(curr, upd, path, changes, opts) {
+        // Build value sets
+        const currSet = new Set(curr.map((v) => this.stringify(v)));
+        const updSet = new Set(upd.map((v) => this.stringify(v)));
+        // Find additions
+        upd.forEach((value, index) => {
+            const str = this.stringify(value);
+            if (!currSet.has(str)) {
+                changes.push({
+                    type: ChangeType.ADD,
+                    path: [...path, index],
+                    value,
+                });
+            }
+        });
+        // Find deletions (if enabled)
+        if (opts.detectDeletions) {
+            curr.forEach((value, index) => {
+                const str = this.stringify(value);
+                if (!updSet.has(str)) {
+                    changes.push({
+                        type: ChangeType.DELETE,
+                        path: [...path, index],
+                        oldValue: value,
+                    });
+                }
+            });
+        }
+    }
+    /**
+     * Stringify value for set comparison
+     */
+    stringify(value) {
+        try {
+            return JSON.stringify(value);
+        }
+        catch (_a) {
+            return String(value);
+        }
+    }
+}
+exports.DiffEngine = DiffEngine;
+//# sourceMappingURL=diff-engine.js.map

package/src/lib/diff-engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-engine.js","sourceRoot":"","sources":["../../../../../packages/enterprise/src/lib/diff-engine.ts"],"names":[],"mappings":"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"}

package/src/lib/enterprise-enhancer.d.ts

@@ -0,0 +1,81 @@
+import { PathIndex } from './path-index';
+import { UpdateResult } from './update-engine';
+import type { Signal } from '@angular/core';
+import type { Enhancer } from '@signaltree/core';
+/**
+ * Enterprise-grade optimizations for large-scale applications.
+ *
+ * **Includes:**
+ * - Diff-based updates (only update changed signals)
+ * - Bulk operation optimization (2-5x faster)
+ * - Advanced change tracking
+ * - Update statistics and monitoring
+ *
+ * **Use when:**
+ * - 500+ signals in state tree
+ * - Bulk updates at high frequency (60Hz+)
+ * - Real-time dashboards or data feeds
+ * - Enterprise-scale applications
+ *
+ * **Skip when:**
+ * - Small to medium apps (<100 signals)
+ * - Infrequent state updates
+ * - Startup/prototype projects
+ *
+ * **Bundle cost:** +2.4KB gzipped
+ * **Performance gain:** 2-5x faster bulk updates, detailed monitoring
+ *
+ * @example
+ * ```typescript
+ * import { signalTree } from '@signaltree/core';
+ * import { withEnterprise } from '@signaltree/enterprise';
+ *
+ * const tree = signalTree(largeState).with(withEnterprise());
+ *
+ * // Now available: optimized bulk updates
+ * const result = tree.updateOptimized(newData, {
+ *   ignoreArrayOrder: true,
+ *   maxDepth: 10
+ * });
+ *
+ * console.log(result.stats);
+ * // { totalChanges: 45, adds: 10, updates: 30, deletes: 5 }
+ * ```
+ *
+ * @public
+ */
+export declare function withEnterprise<T extends Record<string, unknown>>(): Enhancer<T, T & EnterpriseEnhancedTree<T>>;
+/**
+ * Type augmentation for trees enhanced with enterprise features.
+ * This is applied when using withEnterprise().
+ *
+ * @public
+ */
+export interface EnterpriseEnhancedTree<T> {
+    /**
+     * Optimized bulk update method using diff-based change detection.
+     * Only available when using withEnterprise().
+     *
+     * @param newValue - The new state value
+     * @param options - Update options
+     * @returns Update result with statistics
+     */
+    updateOptimized(newValue: T, options?: {
+        /** Maximum depth to traverse (default: 100) */
+        maxDepth?: number;
+        /** Ignore array element order (default: false) */
+        ignoreArrayOrder?: boolean;
+        /** Custom equality function */
+        equalityFn?: (a: unknown, b: unknown) => boolean;
+        /** Automatically batch updates (default: true) */
+        autoBatch?: boolean;
+        /** Number of patches per batch (default: 10) */
+        batchSize?: number;
+    }): UpdateResult;
+    /**
+     * Get the PathIndex for debugging/monitoring.
+     * Only available when using withEnterprise().
+     * Returns null if updateOptimized hasn't been called yet (lazy initialization).
+     */
+    getPathIndex(): PathIndex<Signal<unknown>> | null;
+}

package/src/lib/enterprise-enhancer.js

@@ -0,0 +1,78 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withEnterprise = withEnterprise;
+const path_index_1 = require("./path-index");
+const update_engine_1 = require("./update-engine");
+/**
+ * Enterprise-grade optimizations for large-scale applications.
+ *
+ * **Includes:**
+ * - Diff-based updates (only update changed signals)
+ * - Bulk operation optimization (2-5x faster)
+ * - Advanced change tracking
+ * - Update statistics and monitoring
+ *
+ * **Use when:**
+ * - 500+ signals in state tree
+ * - Bulk updates at high frequency (60Hz+)
+ * - Real-time dashboards or data feeds
+ * - Enterprise-scale applications
+ *
+ * **Skip when:**
+ * - Small to medium apps (<100 signals)
+ * - Infrequent state updates
+ * - Startup/prototype projects
+ *
+ * **Bundle cost:** +2.4KB gzipped
+ * **Performance gain:** 2-5x faster bulk updates, detailed monitoring
+ *
+ * @example
+ * ```typescript
+ * import { signalTree } from '@signaltree/core';
+ * import { withEnterprise } from '@signaltree/enterprise';
+ *
+ * const tree = signalTree(largeState).with(withEnterprise());
+ *
+ * // Now available: optimized bulk updates
+ * const result = tree.updateOptimized(newData, {
+ *   ignoreArrayOrder: true,
+ *   maxDepth: 10
+ * });
+ *
+ * console.log(result.stats);
+ * // { totalChanges: 45, adds: 10, updates: 30, deletes: 5 }
+ * ```
+ *
+ * @public
+ */
+function withEnterprise() {
+    return (tree) => {
+        // Lazy initialization - only create when first needed
+        let pathIndex = null;
+        let updateEngine = null;
+        // Type assertion to access SignalTree properties
+        const signalTree = tree;
+        // Cast tree to enhanced type for safe property assignment
+        const enhancedTree = tree;
+        // Add updateOptimized method to tree
+        enhancedTree.updateOptimized = (updates, options) => {
+            // Lazy initialize on first use
+            if (!updateEngine) {
+                pathIndex = new path_index_1.PathIndex();
+                pathIndex.buildFromTree(signalTree.state);
+                updateEngine = new update_engine_1.OptimizedUpdateEngine(signalTree.state);
+            }
+            const result = updateEngine.update(signalTree.state, updates, options);
+            // Rebuild index if changes were made
+            if (result.changed && result.stats && pathIndex) {
+                pathIndex.clear();
+                pathIndex.buildFromTree(signalTree.state);
+            }
+            return result;
+        };
+        // Add PathIndex access for debugging/monitoring
+        enhancedTree.getPathIndex = () => pathIndex;
+        return enhancedTree;
+    };
+}
+//# sourceMappingURL=enterprise-enhancer.js.map

package/src/lib/enterprise-enhancer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise-enhancer.js","sourceRoot":"","sources":["../../../../../packages/enterprise/src/lib/enterprise-enhancer.ts"],"names":[],"mappings":";;AA+CA,wCAiDC;AAhGD,6CAAyC;AACzC,mDAAsE;AAItE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,SAAgB,cAAc;IAI5B,OAAO,CAAC,IAAO,EAAiC,EAAE;QAChD,sDAAsD;QACtD,IAAI,SAAS,GAAsC,IAAI,CAAC;QACxD,IAAI,YAAY,GAAiC,IAAI,CAAC;QAEtD,iDAAiD;QACjD,MAAM,UAAU,GAAG,IAAqC,CAAC;QAEzD,0DAA0D;QAC1D,MAAM,YAAY,GAAG,IAAqC,CAAC;QAE3D,qCAAqC;QACrC,YAAY,CAAC,eAAe,GAAG,CAC7B,OAAmB,EACnB,OAMC,EACa,EAAE;YAChB,+BAA+B;YAC/B,IAAI,CAAC,YAAY,EAAE,CAAC;gBAClB,SAAS,GAAG,IAAI,sBAAS,EAAmB,CAAC;gBAC7C,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;gBAC1C,YAAY,GAAG,IAAI,qCAAqB,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC7D,CAAC;YAED,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAEvE,qCAAqC;YACrC,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,KAAK,IAAI,SAAS,EAAE,CAAC;gBAChD,SAAS,CAAC,KAAK,EAAE,CAAC;gBAClB,SAAS,CAAC,aAAa,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAC5C,CAAC;YAED,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC;QAEF,gDAAgD;QAChD,YAAY,CAAC,YAAY,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;QAE5C,OAAO,YAAY,CAAC;IACtB,CAAC,CAAC;AACJ,CAAC"}

package/src/lib/enterprise.d.ts

@@ -0,0 +1 @@
+export declare function enterprise(): string;

package/src/lib/enterprise.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.enterprise = enterprise;
+function enterprise() {
+    return 'enterprise';
+}
+//# sourceMappingURL=enterprise.js.map

package/src/lib/enterprise.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterprise.js","sourceRoot":"","sources":["../../../../../packages/enterprise/src/lib/enterprise.ts"],"names":[],"mappings":";;AAAA,gCAEC;AAFD,SAAgB,UAAU;IACxB,OAAO,YAAY,CAAC;AACtB,CAAC"}