@stonecrop/stonecrop 0.4.37 → 0.5.0

package/dist/src/stores/hst.js

@@ -0,0 +1,483 @@
+import { getGlobalTriggerEngine } from '../field-triggers';
+import { useOperationLogStore } from './operation-log';
+/**
+ * Get the operation log store if available
+ */
+function getOperationLogStore() {
+    try {
+        return useOperationLogStore();
+    }
+    catch {
+        // Operation log is optional
+        return null;
+    }
+}
+/**
+ * Global HST Manager (Singleton)
+ * Manages hierarchical state trees and provides access to the global registry.
+ *
+ * @public
+ */
+class HST {
+    static instance;
+    /**
+     * Gets the singleton instance of HST
+     * @returns The HST singleton instance
+     */
+    static getInstance() {
+        if (!HST.instance) {
+            HST.instance = new HST();
+        }
+        return HST.instance;
+    }
+    /**
+     * Gets the global registry instance
+     * @returns The global registry object or undefined if not found
+     */
+    getRegistry() {
+        // In test environment, try different ways to access Registry
+        // First, try the global Registry if it exists
+        if (typeof globalThis !== 'undefined') {
+            const globalRegistry = globalThis.Registry?._root;
+            if (globalRegistry) {
+                return globalRegistry;
+            }
+        }
+        // Try to access through window (browser environment)
+        if (typeof window !== 'undefined') {
+            const windowRegistry = window.Registry?._root;
+            if (windowRegistry) {
+                return windowRegistry;
+            }
+        }
+        // Try to access through global (Node environment)
+        if (typeof global !== 'undefined' && global) {
+            const nodeRegistry = global.Registry?._root;
+            if (nodeRegistry) {
+                return nodeRegistry;
+            }
+        }
+        // If we can't find it globally, it might not be set up
+        // This is expected in test environments where Registry is created locally
+        return undefined;
+    }
+    /**
+     * Helper method to get doctype metadata from the registry
+     * @param doctype - The name of the doctype to retrieve metadata for
+     * @returns The doctype metadata object or undefined if not found
+     */
+    getDoctypeMeta(doctype) {
+        const registry = this.getRegistry();
+        if (registry && typeof registry === 'object' && 'registry' in registry) {
+            return registry.registry[doctype];
+        }
+        return undefined;
+    }
+}
+// Enhanced HST Proxy with tree navigation
+class HSTProxy {
+    target;
+    parentPath;
+    rootNode;
+    doctype;
+    parentDoctype;
+    hst;
+    constructor(target, doctype, parentPath = '', rootNode = null, parentDoctype) {
+        this.target = target;
+        this.parentPath = parentPath;
+        this.rootNode = rootNode || this;
+        this.doctype = doctype;
+        this.parentDoctype = parentDoctype;
+        this.hst = HST.getInstance();
+        return new Proxy(this, {
+            get(hst, prop) {
+                // Return HST methods directly
+                if (prop in hst)
+                    return hst[prop];
+                // Handle property access - return tree nodes for navigation
+                const path = String(prop);
+                return hst.getNode(path);
+            },
+            set(hst, prop, value) {
+                const path = String(prop);
+                hst.set(path, value);
+                return true;
+            },
+        });
+    }
+    get(path) {
+        return this.resolveValue(path);
+    }
+    // Method to get a tree-wrapped node for navigation
+    getNode(path) {
+        const fullPath = this.resolvePath(path);
+        const value = this.resolveValue(path);
+        // Determine the correct doctype for this node based on the path
+        const pathSegments = fullPath.split('.');
+        let nodeDoctype = this.doctype;
+        // If we're at the root level and this is a StonecropStore, use the first path segment as the doctype
+        if (this.doctype === 'StonecropStore' && pathSegments.length >= 1) {
+            nodeDoctype = pathSegments[0];
+        }
+        // Always wrap in HSTProxy for tree navigation
+        if (typeof value === 'object' && value !== null && !this.isPrimitive(value)) {
+            return new HSTProxy(value, nodeDoctype, fullPath, this.rootNode, this.parentDoctype);
+        }
+        // For primitives, return a minimal wrapper that throws on tree operations
+        return new HSTProxy(value, nodeDoctype, fullPath, this.rootNode, this.parentDoctype);
+    }
+    set(path, value, source = 'user') {
+        // Get current value for change context
+        const fullPath = this.resolvePath(path);
+        const beforeValue = this.has(path) ? this.get(path) : undefined;
+        // Log operation if not from undo/redo and store is available
+        if (source !== 'undo' && source !== 'redo') {
+            const logStore = getOperationLogStore();
+            if (logStore && typeof logStore.addOperation === 'function') {
+                const pathSegments = fullPath.split('.');
+                const doctype = this.doctype === 'StonecropStore' && pathSegments.length >= 1 ? pathSegments[0] : this.doctype;
+                const recordId = pathSegments.length >= 2 ? pathSegments[1] : undefined;
+                const fieldname = pathSegments.slice(2).join('.') || pathSegments[pathSegments.length - 1];
+                // Detect if this is a DELETE operation (setting to undefined when a value existed)
+                const isDelete = value === undefined && beforeValue !== undefined;
+                const operationType = isDelete ? 'delete' : 'set';
+                // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+                logStore.addOperation({
+                    type: operationType,
+                    path: fullPath,
+                    fieldname,
+                    beforeValue,
+                    afterValue: value,
+                    doctype,
+                    recordId,
+                    reversible: true, // Default to reversible, can be changed by field triggers
+                }, source);
+            }
+        }
+        // Update the value
+        this.updateValue(path, value);
+        // Trigger field actions asynchronously (don't block the set operation)
+        void this.triggerFieldActions(fullPath, beforeValue, value);
+    }
+    has(path) {
+        try {
+            // Handle empty path case
+            if (path === '') {
+                return true; // empty path refers to the root object
+            }
+            const segments = this.parsePath(path);
+            let current = this.target;
+            for (let i = 0; i < segments.length; i++) {
+                const segment = segments[i];
+                if (current === null || current === undefined) {
+                    return false;
+                }
+                // Check if this is the last segment
+                if (i === segments.length - 1) {
+                    // For the final property, check if it exists
+                    if (this.isImmutable(current)) {
+                        return current.has(segment);
+                    }
+                    else if (this.isPiniaStore(current)) {
+                        return (current.$state && segment in current.$state) || segment in current;
+                    }
+                    else {
+                        return segment in current;
+                    }
+                }
+                // Navigate to the next level
+                current = this.getProperty(current, segment);
+            }
+            return false;
+        }
+        catch {
+            return false;
+        }
+    }
+    // Tree navigation methods
+    getParent() {
+        if (!this.parentPath)
+            return null;
+        const parentSegments = this.parentPath.split('.').slice(0, -1);
+        const parentPath = parentSegments.join('.');
+        if (parentPath === '') {
+            return this.rootNode;
+        }
+        // Return a wrapped node, not raw data
+        return this.rootNode.getNode(parentPath);
+    }
+    getRoot() {
+        return this.rootNode;
+    }
+    getPath() {
+        return this.parentPath;
+    }
+    getDepth() {
+        return this.parentPath ? this.parentPath.split('.').length : 0;
+    }
+    getBreadcrumbs() {
+        return this.parentPath ? this.parentPath.split('.') : [];
+    }
+    /**
+     * Trigger an XState transition with optional context data
+     */
+    async triggerTransition(transition, context) {
+        const triggerEngine = getGlobalTriggerEngine();
+        // Determine doctype and recordId from the current path
+        const pathSegments = this.parentPath.split('.');
+        let doctype = this.doctype;
+        let recordId;
+        // If we're at the root level and this is a StonecropStore, use the first path segment as the doctype
+        if (this.doctype === 'StonecropStore' && pathSegments.length >= 1) {
+            doctype = pathSegments[0];
+        }
+        // Extract recordId from path if it follows the expected pattern
+        if (pathSegments.length >= 2) {
+            recordId = pathSegments[1];
+        }
+        // Build transition context
+        const transitionContext = {
+            path: this.parentPath,
+            fieldname: '', // No specific field for transitions
+            beforeValue: undefined,
+            afterValue: undefined,
+            operation: 'set',
+            doctype,
+            recordId,
+            timestamp: new Date(),
+            store: this.rootNode || undefined,
+            transition,
+            currentState: context?.currentState,
+            targetState: context?.targetState,
+            fsmContext: context?.fsmContext,
+        };
+        // Log FSM transition operation
+        const logStore = getOperationLogStore();
+        if (logStore && typeof logStore.addOperation === 'function') {
+            // eslint-disable-next-line @typescript-eslint/no-unsafe-call
+            logStore.addOperation({
+                type: 'transition',
+                path: this.parentPath,
+                fieldname: transition,
+                beforeValue: context?.currentState,
+                afterValue: context?.targetState,
+                doctype,
+                recordId,
+                reversible: false, // FSM transitions are generally not reversible
+                metadata: {
+                    transition,
+                    currentState: context?.currentState,
+                    targetState: context?.targetState,
+                    fsmContext: context?.fsmContext,
+                },
+            }, 'user');
+        }
+        // Execute transition actions
+        return await triggerEngine.executeTransitionActions(transitionContext);
+    }
+    // Private helper methods
+    resolvePath(path) {
+        if (path === '')
+            return this.parentPath;
+        return this.parentPath ? `${this.parentPath}.${path}` : path;
+    }
+    resolveValue(path) {
+        // Handle empty path - return the target object
+        if (path === '') {
+            return this.target;
+        }
+        const segments = this.parsePath(path);
+        let current = this.target;
+        for (const segment of segments) {
+            if (current === null || current === undefined) {
+                return undefined;
+            }
+            current = this.getProperty(current, segment);
+        }
+        return current;
+    }
+    updateValue(path, value) {
+        // Handle empty path case - should throw error
+        if (path === '') {
+            throw new Error('Cannot set value on empty path');
+        }
+        const segments = this.parsePath(path);
+        const lastSegment = segments.pop();
+        let current = this.target;
+        // Navigate to parent object
+        for (const segment of segments) {
+            current = this.getProperty(current, segment);
+            if (current === null || current === undefined) {
+                throw new Error(`Cannot set property on null/undefined path: ${path}`);
+            }
+        }
+        // Set the final property
+        this.setProperty(current, lastSegment, value);
+    }
+    getProperty(obj, key) {
+        // Immutable objects
+        if (this.isImmutable(obj)) {
+            return obj.get(key);
+        }
+        // Vue reactive object
+        if (this.isVueReactive(obj)) {
+            return obj[key];
+        }
+        // Pinia store
+        if (this.isPiniaStore(obj)) {
+            return obj.$state?.[key] ?? obj[key];
+        }
+        // Plain object
+        return obj[key];
+    }
+    setProperty(obj, key, value) {
+        // Immutable objects
+        if (this.isImmutable(obj)) {
+            throw new Error('Cannot directly mutate immutable objects. Use immutable update methods instead.');
+        }
+        // Pinia store
+        if (this.isPiniaStore(obj)) {
+            if (obj.$patch) {
+                obj.$patch({ [key]: value });
+            }
+            else {
+                ;
+                obj[key] = value;
+            }
+            return;
+        }
+        // Vue reactive or plain object
+        ;
+        obj[key] = value;
+    }
+    async triggerFieldActions(fullPath, beforeValue, afterValue) {
+        try {
+            // Guard against undefined or null fullPath
+            if (!fullPath || typeof fullPath !== 'string') {
+                return;
+            }
+            const pathSegments = fullPath.split('.');
+            // Only trigger field actions for actual field changes (at least 3 levels deep: doctype.recordId.fieldname)
+            // Skip triggering for doctype-level or record-level changes
+            if (pathSegments.length < 3) {
+                return;
+            }
+            const triggerEngine = getGlobalTriggerEngine();
+            const fieldname = pathSegments.slice(2).join('.') || pathSegments[pathSegments.length - 1];
+            // Determine the correct doctype for this path using the same logic as getNode()
+            // The path should be in format: "doctype.recordId.fieldname"
+            let doctype = this.doctype;
+            // If we're at the root level and this is a StonecropStore, use the first path segment as the doctype
+            if (this.doctype === 'StonecropStore' && pathSegments.length >= 1) {
+                doctype = pathSegments[0];
+            }
+            let recordId;
+            // Extract recordId from path if it follows the expected pattern
+            if (pathSegments.length >= 2) {
+                recordId = pathSegments[1];
+            }
+            const context = {
+                path: fullPath,
+                fieldname,
+                beforeValue,
+                afterValue,
+                operation: 'set',
+                doctype,
+                recordId,
+                timestamp: new Date(),
+                store: this.rootNode || undefined, // Pass the root store for snapshot/rollback capabilities
+            };
+            await triggerEngine.executeFieldTriggers(context);
+        }
+        catch (error) {
+            // Silently handle trigger errors to not break the main flow
+            // In production, you might want to log this error
+            if (error instanceof Error) {
+                // eslint-disable-next-line no-console
+                console.warn('Field trigger error:', error.message);
+                // Optional: emit an event or call error handler
+            }
+        }
+    }
+    isVueReactive(obj) {
+        return (obj &&
+            typeof obj === 'object' &&
+            '__v_isReactive' in obj &&
+            obj.__v_isReactive === true);
+    }
+    isPiniaStore(obj) {
+        return obj && typeof obj === 'object' && ('$state' in obj || '$patch' in obj || '$id' in obj);
+    }
+    isImmutable(obj) {
+        if (!obj || typeof obj !== 'object') {
+            return false;
+        }
+        const hasGetMethod = 'get' in obj && typeof obj.get === 'function';
+        const hasSetMethod = 'set' in obj && typeof obj.set === 'function';
+        const hasHasMethod = 'has' in obj && typeof obj.has === 'function';
+        const hasImmutableMarkers = '__ownerID' in obj ||
+            '_map' in obj ||
+            '_list' in obj ||
+            '_origin' in obj ||
+            '_capacity' in obj ||
+            '_defaultValues' in obj ||
+            '_tail' in obj ||
+            '_root' in obj ||
+            ('size' in obj && hasGetMethod && hasSetMethod);
+        let constructorName;
+        try {
+            const objWithConstructor = obj;
+            if ('constructor' in objWithConstructor &&
+                objWithConstructor.constructor &&
+                typeof objWithConstructor.constructor === 'object' &&
+                'name' in objWithConstructor.constructor) {
+                const nameValue = objWithConstructor.constructor.name;
+                constructorName = typeof nameValue === 'string' ? nameValue : undefined;
+            }
+        }
+        catch {
+            constructorName = undefined;
+        }
+        const isImmutableConstructor = constructorName &&
+            (constructorName.includes('Map') ||
+                constructorName.includes('List') ||
+                constructorName.includes('Set') ||
+                constructorName.includes('Stack') ||
+                constructorName.includes('Seq')) &&
+            (hasGetMethod || hasSetMethod);
+        return Boolean((hasGetMethod && hasSetMethod && hasHasMethod && hasImmutableMarkers) ||
+            (hasGetMethod && hasSetMethod && isImmutableConstructor));
+    }
+    isPrimitive(value) {
+        // Don't wrap primitive values, functions, or null/undefined
+        return (value === null ||
+            value === undefined ||
+            typeof value === 'string' ||
+            typeof value === 'number' ||
+            typeof value === 'boolean' ||
+            typeof value === 'function' ||
+            typeof value === 'symbol' ||
+            typeof value === 'bigint');
+    }
+    parsePath(path) {
+        if (!path)
+            return [];
+        return path.split('.').filter(segment => segment.length > 0);
+    }
+}
+/**
+ * Factory function for HST creation
+ * Creates a new HSTNode proxy for hierarchical state tree navigation.
+ *
+ * @param target - The target object to wrap with HST functionality
+ * @param doctype - The document type identifier
+ * @param parentDoctype - Optional parent document type identifier
+ * @returns A new HSTNode proxy instance
+ *
+ * @public
+ */
+function createHST(target, doctype, parentDoctype) {
+    return new HSTProxy(target, doctype, '', null, parentDoctype);
+}
+// Export everything
+export { HSTProxy, HST, createHST };

package/dist/src/stores/index.d.ts

@@ -1,3 +1,7 @@
+import { HST } from './hst';
+declare const hst: HST;
 declare const pinia: import("pinia").Pinia;
-export { pinia };
+export { hst, pinia };
+export { useOperationLogStore } from './operation-log';
+export type { HSTNode } from './hst';
 //# sourceMappingURL=index.d.ts.map

package/dist/src/stores/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,KAAK,uBAAgB,CAAA;AAU3B,OAAO,EAAE,KAAK,EAAE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/stores/index.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,GAAG,EAAE,MAAM,OAAO,CAAA;AAE3B,QAAA,MAAM,GAAG,KAAoB,CAAA;AAC7B,QAAA,MAAM,KAAK,uBAAgB,CAAA;AAU3B,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,CAAA;AACrB,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAA;AACtD,YAAY,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA"}

package/dist/{stores → src/stores}/index.js

@@ -1,9 +1,12 @@
 import { createPinia } from 'pinia';
 import { PiniaSharedState } from 'pinia-shared-state';
+import { HST } from './hst';
+const hst = HST.getInstance();
 const pinia = createPinia();
 // Pass the plugin to your application's pinia plugin
 pinia.use(PiniaSharedState({
     enable: true,
     initialize: true,
 }));
-export { pinia };
+export { hst, pinia };
+export { useOperationLogStore } from './operation-log';