@stonecrop/stonecrop 0.4.36 → 0.5.0

package/dist/src/types/field-triggers.d.ts

@@ -0,0 +1,186 @@
+/**
+ * Field-level action trigger system types
+ * @public
+ */
+import { HSTNode } from '../stores/hst';
+/**
+ * Context provided to action functions when field changes occur
+ * @public
+ */
+export interface FieldChangeContext {
+    /** The HST path that was changed */
+    path: string;
+    /** The field name (last segment of path) */
+    fieldname: string;
+    /** Value before the change */
+    beforeValue: any;
+    /** Value after the change */
+    afterValue: any;
+    /** The operation type */
+    operation: 'set' | 'delete' | 'patch';
+    /** The doctype of the record being changed */
+    doctype: string;
+    /** The record ID if applicable */
+    recordId?: string;
+    /** Timestamp of the change */
+    timestamp: Date;
+    /** Reference to the HST store for state access (optional) */
+    store?: HSTNode;
+}
+/**
+ * Context provided to XState transition action functions
+ * Extends FieldChangeContext with FSM-specific data
+ * @public
+ */
+export interface TransitionChangeContext extends FieldChangeContext {
+    /** The XState transition name that triggered this action */
+    transition: string;
+    /** Current workflow state before transition */
+    currentState?: string;
+    /** Target workflow state after transition */
+    targetState?: string;
+    /** Additional FSM context data */
+    fsmContext?: Record<string, any>;
+}
+/**
+ * Action function that can be triggered by field changes
+ * @public
+ */
+export type FieldActionFunction = (context: FieldChangeContext) => void | Promise<void>;
+/**
+ * Action function for XState transition triggers
+ * Receives enhanced context with FSM state information
+ * @public
+ */
+export type TransitionActionFunction = (context: TransitionChangeContext) => void | Promise<void>;
+/**
+ * String reference to a globally registered action function or inline function
+ * @public
+ */
+export type FieldActionString = string;
+/**
+ * Supported action types for field triggers
+ * @public
+ */
+export type FieldAction = FieldActionFunction | FieldActionString;
+/**
+ * Supported action types for XState transitions
+ * Can be either a transition-specific function or a string reference
+ * @public
+ */
+export type TransitionAction = TransitionActionFunction | FieldActionString;
+/**
+ * Configuration for a single field trigger
+ * @public
+ */
+export interface FieldTriggerConfig {
+    /** Array of actions to execute when this field changes */
+    actions: FieldAction[];
+    /** Optional condition function to determine if actions should run */
+    condition?: (context: FieldChangeContext) => boolean | Promise<boolean>;
+    /** Whether to run actions before or after the value is set (default: 'after') */
+    timing?: 'before' | 'after';
+    /** Whether to stop execution on first error (default: true) */
+    stopOnError?: boolean;
+    /** Maximum execution time in milliseconds before timeout */
+    timeout?: number;
+    /** Whether to enable automatic rollback for this field trigger (overrides global setting) */
+    enableRollback?: boolean;
+}
+/**
+ * Map of field paths to trigger configurations
+ * Supports wildcard patterns like 'emailAddress.*.is_primary'
+ * @public
+ */
+export type FieldTriggerMap = Record<string, FieldTriggerConfig | FieldAction[]>;
+/**
+ * Registry for storing global action functions
+ * @public
+ */
+export interface ActionRegistry {
+    /** Register a global action function */
+    register(name: string, fn: FieldActionFunction): void;
+    /** Get a registered action function */
+    get(name: string): FieldActionFunction | undefined;
+    /** Check if an action is registered */
+    has(name: string): boolean;
+    /** Unregister an action function */
+    unregister(name: string): void;
+    /** Get all registered action names */
+    list(): string[];
+}
+/**
+ * Result of executing a field action
+ * @public
+ */
+export interface ActionExecutionResult {
+    /** Whether the action executed successfully */
+    success: boolean;
+    /** Error if execution failed */
+    error?: Error;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** The action that was executed */
+    action: FieldAction;
+}
+/**
+ * Result of executing an XState transition action
+ * @public
+ */
+export interface TransitionExecutionResult {
+    /** Whether the action executed successfully */
+    success: boolean;
+    /** Error if execution failed */
+    error?: Error;
+    /** Execution time in milliseconds */
+    executionTime: number;
+    /** The action that was executed */
+    action: TransitionAction;
+    /** The transition name that was executed */
+    transition: string;
+}
+/**
+ * Result of executing all actions for a field change
+ * @public
+ */
+export interface FieldTriggerExecutionResult {
+    /** The path that triggered the actions */
+    path: string;
+    /** Results for each action that was executed */
+    actionResults: ActionExecutionResult[];
+    /** Total execution time for all actions */
+    totalExecutionTime: number;
+    /** Whether all actions succeeded */
+    allSucceeded: boolean;
+    /** Whether execution was stopped due to an error */
+    stoppedOnError: boolean;
+    /** Whether a rollback was performed */
+    rolledBack: boolean;
+    /** The snapshot that was captured before execution */
+    snapshot?: any;
+}
+/**
+ * Options for the field trigger system
+ * @public
+ */
+export interface FieldTriggerOptions {
+    /** Default timeout for action execution in milliseconds */
+    defaultTimeout?: number;
+    /** Whether to log trigger executions for debugging */
+    debug?: boolean;
+    /** Custom error handler for action failures */
+    errorHandler?: (error: Error, context: FieldChangeContext, action: FieldAction) => void;
+    /** Whether to enable automatic rollback on failure (default: true) */
+    enableRollback?: boolean;
+}
+/**
+ * Pattern matching result for wildcard paths
+ * @internal
+ */
+export interface _PathMatchResult {
+    /** Whether the path matches the pattern */
+    matches: boolean;
+    /** Captured wildcard values */
+    captures: Record<string, string>;
+}
+//# sourceMappingURL=field-triggers.d.ts.map

package/dist/src/types/field-triggers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-triggers.d.ts","sourceRoot":"","sources":["../../../src/types/field-triggers.ts"],"names":[],"mappings":"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"}

package/dist/src/types/field-triggers.js

@@ -0,0 +1,4 @@
+/**
+ * Field-level action trigger system types
+ * @public
+ */

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

@@ -3,7 +3,10 @@ import { List, Map } from 'immutable';
 import type { Component } from 'vue';
 import type { Router } from 'vue-router';
 import type { AnyStateNodeConfig, UnknownMachineConfig } from 'xstate';
-import DoctypeMeta from '../doctype';
+import type DoctypeMeta from '../doctype';
+import Registry from '../registry';
+import { Stonecrop } from '../stonecrop';
+import type { RouteContext } from './registry';
 /**
  * Immutable Doctype type for Stonecrop instances
  * @public
@@ -18,6 +21,7 @@ export type ImmutableDoctype = {
  * @public
  */
 export type MutableDoctype = {
+    doctype?: string;
     schema?: SchemaTypes[];
     workflow?: UnknownMachineConfig | AnyStateNodeConfig;
     actions?: Record<string, string[]>;
@@ -37,6 +41,13 @@ export type Schema = {
 export type InstallOptions = {
     router?: Router;
     components?: Record<string, Component>;
-    getMeta?: (doctype?: string) => DoctypeMeta | Promise<DoctypeMeta>;
+    getMeta?: (routeContext: RouteContext) => DoctypeMeta | Promise<DoctypeMeta>;
+    /** Automatically run initialization callback after app mounting (default: false) */
+    autoInitializeRouter?: boolean;
+    /** Callback function called after plugin is ready and mounted */
+    onRouterInitialized?: (registry: Registry, stonecrop: Stonecrop) => void | Promise<void>;
 };
+export * from './field-triggers';
+export * from './registry';
+export * from './operation-log';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAEtE,OAAO,WAAW,MAAM,YAAY,CAAA;AAEpC;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAE9B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAE5B,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAClE,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AACnD,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,WAAW,CAAA;AACrC,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,KAAK,CAAA;AACpC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAA;AACxC,OAAO,KAAK,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,QAAQ,CAAA;AAEtE,OAAO,KAAK,WAAW,MAAM,YAAY,CAAA;AACzC,OAAO,QAAQ,MAAM,aAAa,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAE9C;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;IACnC,QAAQ,CAAC,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IAC7D,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CACxC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,MAAM,CAAC,EAAE,WAAW,EAAE,CAAA;IACtB,QAAQ,CAAC,EAAE,oBAAoB,GAAG,kBAAkB,CAAA;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;CAClC,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM,GAAG;IACpB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,IAAI,CAAC,WAAW,CAAC,CAAA;CACzB,CAAA;AAED;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAA;IACtC,OAAO,CAAC,EAAE,CAAC,YAAY,EAAE,YAAY,KAAK,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;IAC5E,oFAAoF;IACpF,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,iEAAiE;IACjE,mBAAmB,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CACxF,CAAA;AAGD,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA"}

package/dist/src/types/index.js

@@ -0,0 +1,4 @@
+// Re-export types
+export * from './field-triggers';
+export * from './registry';
+export * from './operation-log';

package/dist/src/types/operation-log.d.ts

@@ -0,0 +1,165 @@
+/**
+ * Type of HST operation
+ * @public
+ */
+export type HSTOperationType = 'set' | 'delete' | 'batch' | 'transition' | 'action';
+/**
+ * Operation source - where the change originated
+ * @public
+ */
+export type OperationSource = 'user' | 'system' | 'sync' | 'undo' | 'redo';
+/**
+ * Complete metadata for an HST mutation
+ * Enables time travel, synchronization, and audit trails
+ * @public
+ */
+export interface HSTOperation {
+    /** Unique operation identifier */
+    id: string;
+    /** Type of operation performed */
+    type: HSTOperationType;
+    /** Full HST path affected (e.g., "task.123.title") */
+    path: string;
+    /** Field name extracted from path */
+    fieldname: string;
+    /** Value before the operation */
+    beforeValue: any;
+    /** Value after the operation */
+    afterValue: any;
+    /** Doctype this operation affects */
+    doctype: string;
+    /** Record ID if applicable */
+    recordId?: string;
+    /** Timestamp of the operation */
+    timestamp: Date;
+    /** Source of the operation (defaults to 'user' if not specified) */
+    source?: OperationSource;
+    /** Whether this operation can be undone */
+    reversible: boolean;
+    /** Reason if operation is irreversible */
+    irreversibleReason?: string;
+    /** XState transition name if triggered by FSM */
+    transition?: string;
+    /** XState current state before transition */
+    currentState?: string;
+    /** XState target state after transition */
+    targetState?: string;
+    /** Action name if operation is an action execution (type: 'action') */
+    actionName?: string;
+    /** Record IDs that the action was executed on */
+    actionRecordIds?: string[];
+    /** Result or status of the action execution */
+    actionResult?: 'success' | 'failure' | 'pending';
+    /** Error message if action execution failed */
+    actionError?: string;
+    /** User or session identifier */
+    userId?: string;
+    /** Additional metadata for custom use cases */
+    metadata?: Record<string, any>;
+    /** Parent operation ID for batch operations */
+    parentOperationId?: string;
+    /** Child operation IDs for batch operations */
+    childOperationIds?: string[];
+}
+/**
+ * Input type for adding operations
+ * Excludes system-generated fields (id, timestamp)
+ * @public
+ */
+export type HSTOperationInput = Omit<HSTOperation, 'id' | 'timestamp' | 'source'> & {
+    source?: OperationSource;
+};
+/**
+ * Batch operation wrapper
+ * @public
+ */
+export interface BatchOperation {
+    /** Unique batch identifier */
+    id: string;
+    /** Operations included in this batch */
+    operations: HSTOperation[];
+    /** When the batch was created */
+    timestamp: Date;
+    /** Optional description of what this batch represents */
+    description?: string;
+    /** Whether the entire batch can be undone */
+    reversible: boolean;
+}
+/**
+ * Operation log configuration
+ * @public
+ */
+export interface OperationLogConfig {
+    /** Maximum operations to store (default: 100) */
+    maxOperations?: number;
+    /** Enable cross-tab synchronization (default: true) */
+    enableCrossTabSync?: boolean;
+    /** Auto-sync interval in milliseconds (default: 30000) */
+    autoSyncInterval?: number;
+    /** Enable operation persistence to localStorage (default: false) */
+    enablePersistence?: boolean;
+    /** Persistence key prefix */
+    persistenceKeyPrefix?: string;
+    /** User identifier for multi-user scenarios */
+    userId?: string;
+    /** Custom operation filter */
+    operationFilter?: (operation: HSTOperation) => boolean;
+}
+/**
+ * Undo/Redo state
+ * @public
+ */
+export interface UndoRedoState {
+    /** Can undo */
+    canUndo: boolean;
+    /** Can redo */
+    canRedo: boolean;
+    /** Number of operations available for undo */
+    undoCount: number;
+    /** Number of operations available for redo */
+    redoCount: number;
+    /** Current operation index */
+    currentIndex: number;
+}
+/**
+ * Operation log snapshot for debugging
+ * @public
+ */
+export interface OperationLogSnapshot {
+    /** All operations in the log */
+    operations: HSTOperation[];
+    /** Current operation index in the history */
+    currentIndex: number;
+    /** Total number of operations */
+    totalOperations: number;
+    /** Number of operations that can be undone */
+    reversibleOperations: number;
+    /** Number of operations that cannot be undone */
+    irreversibleOperations: number;
+    /** Timestamp of the oldest operation */
+    oldestOperation?: Date;
+    /** Timestamp of the newest operation */
+    newestOperation?: Date;
+}
+/**
+ * Cross-tab message types
+ * @public
+ */
+export type CrossTabMessageType = 'operation' | 'undo' | 'redo' | 'sync-request' | 'sync-response';
+/**
+ * Cross-tab message payload
+ * @public
+ */
+export interface CrossTabMessage {
+    /** Type of cross-tab message */
+    type: CrossTabMessageType;
+    /** Single operation for operation/undo/redo messages */
+    operation?: HSTOperation;
+    /** Multiple operations for sync messages */
+    operations?: HSTOperation[];
+    /** Identifier of the client/tab sending the message */
+    clientId: string;
+    /** When the message was sent */
+    timestamp: Date;
+}
+//# sourceMappingURL=operation-log.d.ts.map

package/dist/src/types/operation-log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operation-log.d.ts","sourceRoot":"","sources":["../../../src/types/operation-log.ts"],"names":[],"mappings":"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"}

package/dist/src/types/registry.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Route context passed to getMeta function
+ * @public
+ */
+export interface RouteContext {
+    /** The full route path (e.g., "/todo/1" or "/todo") */
+    path: string;
+    /** Path segments split by "/" (e.g., ["todo", "1"] or ["todo"]) */
+    segments: string[];
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/src/types/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/types/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAA;IACZ,mEAAmE;IACnE,QAAQ,EAAE,MAAM,EAAE,CAAA;CAClB"}