@acorex-platform/framework-server 0.0.10

package/workflow/src/lib/runtime/workflow-expression-scope.service.js

@@ -0,0 +1,214 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowExpressionScopeService = void 0;
+const tslib_1 = require("tslib");
+const common_1 = require("@nestjs/common");
+const lodash_es_1 = require("lodash-es");
+//#endregion
+/**
+ * Workflow Expression Scope Service
+ *
+ * Shared service for building expression evaluation scope from workflow data.
+ * Used by both Local Engine and Mock Runtime to manage workflow data (inputs, variables, outputs).
+ *
+ * Responsibilities:
+ * - Build expression evaluation scope from workflow state
+ * - Provide context.eval() function for accessing workflow data
+ * - Manage workflow data structure (inputs, variables, outputs)
+ *
+ * This service does NOT:
+ * - Execute activities
+ * - Evaluate expressions (delegates to AXPExpressionEvaluatorService)
+ * - Manage workflow state (handled by runtime)
+ *
+ * @example
+ * ```typescript
+ * const scopeService = inject(WorkflowExpressionScopeService);
+ *
+ * // Build scope from workflow state
+ * const scope = scopeService.buildScope({
+ *   inputs: state.input || {},
+ *   variables: state.variables || {},
+ *   outputs: activityOutputs
+ * });
+ *
+ * // Or build from state directly
+ * const scope = scopeService.buildScopeFromState(state, activityOutputs);
+ * ```
+ */
+let WorkflowExpressionScopeService = class WorkflowExpressionScopeService {
+    //#region ----   Private Helpers (dot-notation input normalization) ----
+    /**
+     * Collect dot-notation key-value pairs from nested objects so that e.g.
+     * { metadata: { "metadata.questionnaire.id": "x" } } becomes { "metadata.questionnaire.id": "x" } at root.
+     * Top-level non-dot keys are kept as-is.
+     */
+    flattenDotKeysFromTree(obj) {
+        if (obj === null || typeof obj !== 'object')
+            return obj;
+        const result = {};
+        for (const [key, value] of Object.entries(obj)) {
+            if (key.includes('.')) {
+                result[key] = value;
+            }
+            else if (value !== null && typeof value === 'object' && !Array.isArray(value)) {
+                for (const [k, v] of Object.entries(value)) {
+                    if (k.includes('.')) {
+                        result[k] = v;
+                    }
+                    else {
+                        result[key + '.' + k] = v;
+                    }
+                }
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * Expand flat keys with dots into nested objects.
+     * e.g. { "metadata.questionnaire.id": "x" } -> { metadata: { questionnaire: { id: "x" } } }.
+     */
+    expandDotKeys(obj) {
+        if (obj === null || typeof obj !== 'object')
+            return obj;
+        const result = {};
+        const dotKeys = [];
+        const simpleKeys = [];
+        for (const [key, value] of Object.entries(obj)) {
+            if (key.includes('.')) {
+                dotKeys.push([key, value]);
+            }
+            else {
+                simpleKeys.push([key, value]);
+            }
+        }
+        for (const [key, value] of dotKeys) {
+            const parts = key.split('.');
+            let current = result;
+            for (let i = 0; i < parts.length - 1; i++) {
+                const part = parts[i];
+                if (!(part in current) || typeof current[part] !== 'object' || current[part] === null) {
+                    current[part] = {};
+                }
+                current = current[part];
+            }
+            current[parts[parts.length - 1]] = value;
+        }
+        for (const [key, value] of simpleKeys) {
+            result[key] = value;
+        }
+        return result;
+    }
+    /**
+     * Normalize workflow input so that flat dot-notation keys (e.g. from form schema
+     * "metadata.questionnaire.id") become nested for expression access (inputs.metadata.questionnaire.id).
+     */
+    normalizeInputs(input) {
+        if (!input || typeof input !== 'object')
+            return {};
+        const flattened = this.flattenDotKeysFromTree(input);
+        return this.expandDotKeys(flattened);
+    }
+    //#endregion
+    //#region ----   Public Methods   ----
+    /**
+     * Build expression evaluation scope for workflow activities.
+     *
+     * Provides workflow-specific data (inputs, variables, outputs) and context.eval() function.
+     * Other data (session, current user, etc.) are provided by expression evaluator scope providers.
+     *
+     * Scope includes:
+     * - inputs: Workflow input values (accessible as inputs.propertyName)
+     * - variables: Workflow state variables (accessible as variables.propertyName or vars.propertyName)
+     * - outputs: Previous activity outputs (accessible as outputs.activityId)
+     * - context.eval(path): Function to access nested properties from workflow data
+     *
+     * Expressions can use:
+     * - {{inputs.userName}} - Direct access to workflow input
+     * - {{variables.someVar}} or {{vars.someVar}} - Direct access to workflow variable
+     * - {{outputs.activityId.property}} - Direct access to previous activity output
+     * - {{context.eval("inputs.userName")}} - Access via context.eval (supports nested paths)
+     * - {{context.eval("variables.someVar")}} - Access variables via context.eval
+     * - {{context.eval("outputs.activityId.property")}} - Access outputs via context.eval
+     * - {{session.currentUser().name}} - Access current user via expression evaluator scope providers
+     *
+     * The context.eval() function provides a unified way to access all workflow data,
+     * similar to how entity-detail-list uses context.eval() to access parent data.
+     *
+     * @param context - Workflow expression context containing inputs, variables, and outputs
+     * @returns Expression evaluator scope with workflow data and context.eval() function
+     */
+    buildScope(context) {
+        // Normalize inputs so flat dot-notation keys (e.g. metadata.questionnaire.id from forms) become nested for expressions
+        const inputs = this.normalizeInputs(context.inputs || {});
+        // Build merged workflow data object for context.eval()
+        // This allows expressions like: context.eval("inputs.userName") or context.eval("variables.count")
+        const workflowData = {
+            inputs,
+            variables: context.variables || {},
+            vars: context.variables || {}, // Alias for convenience
+            outputs: context.outputs || {},
+        };
+        // Build scope object with workflow-specific data and context.eval()
+        // Note: AXPExpressionEvaluatorScope type expects { [namespace]: { [name]: Function } }
+        // but evaluate() method actually accepts flat objects with values too
+        // We'll use 'any' to allow both values and functions
+        const scope = {
+            // Direct access to workflow data
+            inputs: workflowData.inputs,
+            variables: workflowData.variables,
+            vars: workflowData.vars,
+            outputs: workflowData.outputs,
+            // Context object with eval function (similar to entity-detail-list pattern)
+            context: {
+                eval: (path) => {
+                    // Use lodash get to access nested properties
+                    // Supports paths like: "inputs.userName", "variables.count", "outputs.activityId.property"
+                    return (0, lodash_es_1.get)(workflowData, path);
+                },
+            },
+        };
+        return scope;
+    }
+    /**
+     * Build expression evaluation scope from workflow instance state.
+     *
+     * Convenience method that extracts data from AXPWorkflowInstanceState.
+     *
+     * @param state - Workflow instance state
+     * @param activityOutputs - Map of activity outputs (activityId -> output)
+     * @returns Expression evaluator scope with workflow data and context.eval() function
+     */
+    buildScopeFromState(state, activityOutputs) {
+        // Convert activity outputs to record format
+        const outputs = {};
+        if (activityOutputs) {
+            if (activityOutputs instanceof Map) {
+                activityOutputs.forEach((output, activityId) => {
+                    outputs[activityId] = output;
+                });
+            }
+            else {
+                Object.assign(outputs, activityOutputs);
+            }
+        }
+        // Convenience alias for the last activity output (if available).
+        // This allows expressions like: {{outputs.last.someField}}
+        if (outputs['last'] === undefined && state.lastActivityOutput !== undefined) {
+            outputs['last'] = state.lastActivityOutput;
+        }
+        return this.buildScope({
+            inputs: this.normalizeInputs((state.input || {})),
+            variables: state.variables || {},
+            outputs: outputs,
+        });
+    }
+};
+exports.WorkflowExpressionScopeService = WorkflowExpressionScopeService;
+exports.WorkflowExpressionScopeService = WorkflowExpressionScopeService = tslib_1.__decorate([
+    (0, common_1.Injectable)()
+], WorkflowExpressionScopeService);
+//# sourceMappingURL=workflow-expression-scope.service.js.map

package/workflow/src/lib/runtime/workflow-expression-scope.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-expression-scope.service.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/workflow/src/lib/runtime/workflow-expression-scope.service.ts"],"names":[],"mappings":"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"}

package/workflow/src/lib/runtime/workflow-instance.types.d.ts

@@ -0,0 +1,374 @@
+/**
+ * Workflow status.
+ */
+export type AXPWorkflowStatus = 'Running' | 'Finished';
+/**
+ * Workflow sub-status.
+ */
+export type AXPWorkflowSubStatus = 'Pending' | 'Executing' | 'Suspended' | 'Finished' | 'Cancelled' | 'Faulted';
+/**
+ * Activity status.
+ */
+export type AXPActivityStatus = 'Running' | 'Completed' | 'Canceled' | 'Faulted';
+/**
+ * Exception state.
+ */
+export interface AXPExceptionState {
+    /**
+     * Exception type name.
+     */
+    type: string;
+    /**
+     * Exception message.
+     */
+    message: string;
+    /**
+     * Stack trace (nullable).
+     */
+    stackTrace?: string | null;
+    /**
+     * Inner exception (nullable).
+     */
+    innerException?: AXPExceptionState | null;
+}
+/**
+ * Activity incident.
+ */
+export interface AXPActivityIncident {
+    /**
+     * Activity ID that caused the incident.
+     */
+    activityId: string;
+    /**
+     * Activity node ID.
+     */
+    activityNodeId: string;
+    /**
+     * Activity type.
+     */
+    activityType: string;
+    /**
+     * Incident message.
+     */
+    message: string;
+    /**
+     * Exception (nullable).
+     */
+    exception?: AXPExceptionState | null;
+    /**
+     * Timestamp (ISO date-time).
+     */
+    timestamp: string;
+}
+/**
+ * Workflow fault state.
+ */
+export interface AXPWorkflowFaultState {
+    /**
+     * Exception (nullable).
+     */
+    exception?: AXPExceptionState | null;
+    /**
+     * Fault message.
+     */
+    message: string;
+    /**
+     * Faulted activity ID (nullable).
+     */
+    faultedActivityId?: string | null;
+}
+/**
+ * Bookmark.
+ */
+export interface AXPBookmark {
+    /**
+     * Bookmark ID.
+     */
+    id: string;
+    /**
+     * Bookmark name.
+     */
+    name: string;
+    /**
+     * Bookmark hash.
+     */
+    hash: string;
+    /**
+     * Bookmark payload (nullable).
+     */
+    payload?: any | null;
+    /**
+     * Activity node ID.
+     */
+    activityNodeId: string;
+    /**
+     * Activity instance ID.
+     */
+    activityInstanceId: string;
+    /**
+     * Auto burn flag.
+     */
+    autoBurn?: boolean;
+    /**
+     * Callback method name (nullable).
+     */
+    callbackMethodName?: string | null;
+    /**
+     * Metadata (nullable).
+     */
+    metadata?: Record<string, string> | null;
+}
+/**
+ * Completion callback state.
+ */
+export interface AXPCompletionCallbackState {
+    /**
+     * Owner activity instance ID.
+     */
+    ownerInstanceId: string;
+    /**
+     * Child activity node ID.
+     */
+    childNodeId: string;
+    /**
+     * Method name (nullable).
+     */
+    methodName?: string | null;
+}
+/**
+ * Variable (for activity context).
+ */
+export interface AXPActivityVariable {
+    /**
+     * Variable ID.
+     */
+    id: string;
+    /**
+     * Variable name.
+     */
+    name: string;
+    /**
+     * Type name.
+     */
+    typeName: string;
+    /**
+     * Is array flag.
+     */
+    isArray?: boolean;
+    /**
+     * Variable value (nullable).
+     */
+    value?: any | null;
+    /**
+     * Storage driver type name (nullable).
+     */
+    storageDriverTypeName?: string | null;
+}
+/**
+ * Activity execution context state.
+ */
+export interface AXPActivityExecutionContextState {
+    /**
+     * Context ID (activity instance ID).
+     */
+    id: string;
+    /**
+     * Parent context ID (nullable).
+     */
+    parentContextId?: string | null;
+    /**
+     * Scheduled activity node ID.
+     */
+    scheduledActivityNodeId: string;
+    /**
+     * Owner activity node ID (nullable).
+     */
+    ownerActivityNodeId?: string | null;
+    /**
+     * Properties bag.
+     */
+    properties: Record<string, any>;
+    /**
+     * Activity state (evaluated properties) (nullable).
+     */
+    activityState?: Record<string, any> | null;
+    /**
+     * Dynamic variables.
+     */
+    dynamicVariables: AXPActivityVariable[];
+    /**
+     * Activity status.
+     */
+    status: AXPActivityStatus;
+    /**
+     * Is executing flag.
+     */
+    isExecuting: boolean;
+    /**
+     * Fault count.
+     */
+    faultCount: number;
+    /**
+     * Started at timestamp (ISO date-time).
+     */
+    startedAt: string;
+    /**
+     * Completed at timestamp (ISO date-time, nullable).
+     */
+    completedAt?: string | null;
+    /**
+     * Tag (nullable).
+     */
+    tag?: any | null;
+}
+/**
+ * Workflow state (internal execution state).
+ */
+export interface AXPWorkflowState {
+    /**
+     * State ID.
+     */
+    id: string;
+    /**
+     * Workflow definition ID.
+     */
+    definitionId: string;
+    /**
+     * Workflow definition version.
+     */
+    definitionVersion: number;
+    /**
+     * Correlation ID (nullable).
+     */
+    correlationId?: string | null;
+    /**
+     * Workflow status.
+     */
+    status: AXPWorkflowStatus;
+    /**
+     * Workflow sub-status.
+     */
+    subStatus: AXPWorkflowSubStatus;
+    /**
+     * Bookmarks.
+     */
+    bookmarks: AXPBookmark[];
+    /**
+     * Incidents.
+     */
+    incidents: AXPActivityIncident[];
+    /**
+     * Fault (nullable).
+     */
+    fault?: AXPWorkflowFaultState | null;
+    /**
+     * Completion callbacks.
+     */
+    completionCallbacks: AXPCompletionCallbackState[];
+    /**
+     * Activity execution contexts.
+     */
+    activityExecutionContexts: AXPActivityExecutionContextState[];
+    /**
+     * Input data.
+     */
+    input: Record<string, any>;
+    /**
+     * Output data.
+     */
+    output: Record<string, any>;
+    /**
+     * Properties bag.
+     */
+    properties: Record<string, any>;
+    /**
+     * Created at timestamp (ISO date-time).
+     */
+    createdAt: string;
+    /**
+     * Updated at timestamp (ISO date-time).
+     */
+    updatedAt: string;
+    /**
+     * Finished at timestamp (ISO date-time, nullable).
+     */
+    finishedAt?: string | null;
+    /**
+     * Total number of activities/steps in the workflow (for progress display).
+     */
+    totalSteps?: number;
+}
+/**
+ * Workflow instance (stored in database).
+ * This matches the Elsa Workflow Instance schema for backend compatibility.
+ */
+export interface AXPWorkflowInstance {
+    /**
+     * Schema reference.
+     */
+    $schema?: string;
+    /**
+     * Unique instance ID.
+     */
+    id: string;
+    /**
+     * Workflow definition ID.
+     */
+    definitionId: string;
+    /**
+     * Workflow definition version ID.
+     */
+    definitionVersionId: string;
+    /**
+     * Workflow definition version number.
+     */
+    version: number;
+    /**
+     * Parent workflow instance ID (nullable, for child workflows).
+     */
+    parentWorkflowInstanceId?: string | null;
+    /**
+     * Workflow state (internal execution state).
+     */
+    workflowState: AXPWorkflowState;
+    /**
+     * Workflow status.
+     */
+    status: AXPWorkflowStatus;
+    /**
+     * Workflow sub-status.
+     */
+    subStatus: AXPWorkflowSubStatus;
+    /**
+     * Correlation ID (nullable).
+     */
+    correlationId?: string | null;
+    /**
+     * Instance name (nullable).
+     */
+    name?: string | null;
+    /**
+     * Incident count.
+     */
+    incidentCount: number;
+    /**
+     * Created at timestamp (ISO date-time).
+     */
+    createdAt: string;
+    /**
+     * Updated at timestamp (ISO date-time).
+     */
+    updatedAt: string;
+    /**
+     * Finished at timestamp (ISO date-time, nullable).
+     */
+    finishedAt?: string | null;
+    /**
+     * Entity reference ID (for linking workflow instances to business entities).
+     */
+    entityRefId?: string | null;
+    /**
+     * Entity reference type (e.g., 'HumanCapitalManagement.LeaveRequest').
+     */
+    entityRefType?: string | null;
+}

package/workflow/src/lib/runtime/workflow-instance.types.js

@@ -0,0 +1,8 @@
+"use strict";
+// ============================================
+// WORKFLOW INSTANCE v3.0.0 TYPES
+// Based on Elsa Workflow Instance schema: https://elsaworkflows.io/schemas/workflow-instance/v3.0.0/schema.json
+// Compatible with Elsa backend while using ACoreX naming conventions
+// ============================================
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=workflow-instance.types.js.map

package/workflow/src/lib/runtime/workflow-instance.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-instance.types.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/workflow/src/lib/runtime/workflow-instance.types.ts"],"names":[],"mappings":";AAAA,+CAA+C;AAC/C,iCAAiC;AACjC,gHAAgH;AAChH,qEAAqE;AACrE,+CAA+C"}

package/workflow/src/lib/runtime/workflow-management.const.d.ts

@@ -0,0 +1,6 @@
+export declare const WorkflowManagementRootConfig: {
+    readonly activities: {
+        readonly humanTask: "workflow-activity:human-task";
+        readonly cartable: "workflow-activity:cartable";
+    };
+};

package/workflow/src/lib/runtime/workflow-management.const.js

@@ -0,0 +1,12 @@
+"use strict";
+//#region ---- Workflow management constants ----
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WorkflowManagementRootConfig = void 0;
+exports.WorkflowManagementRootConfig = {
+    activities: {
+        humanTask: 'workflow-activity:human-task',
+        cartable: 'workflow-activity:cartable',
+    },
+};
+//#endregion
+//# sourceMappingURL=workflow-management.const.js.map

package/workflow/src/lib/runtime/workflow-management.const.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-management.const.js","sourceRoot":"","sources":["../../../../../../../../libs/framework/server/workflow/src/lib/runtime/workflow-management.const.ts"],"names":[],"mappings":";AAAA,iDAAiD;;;AAEpC,QAAA,4BAA4B,GAAG;IAC1C,UAAU,EAAE;QACV,SAAS,EAAE,8BAA8B;QACzC,QAAQ,EAAE,4BAA4B;KACvC;CACO,CAAC;AAEX,YAAY"}