@masterteam/workflow 0.0.35 → 0.0.36

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@masterteam/workflow",
-  "version": "0.0.35",
+  "version": "0.0.36",
   "publishConfig": {
     "directory": "../../../dist/masterteam/workflow",
     "linkDirectory": false,
@@ -19,12 +19,12 @@
     "tailwindcss": "^4.2.2",
     "tailwindcss-primeui": "^0.6.1",
     "@ngxs/store": "^20.1.0",
+    "@masterteam/structure-builder": "^0.0.51",
+    "@masterteam/components": "^0.0.162",
+    "@masterteam/notification": "^0.0.20",
     "@masterteam/icons": "^0.0.14",
     "@masterteam/forms": "^0.0.72",
-    "@masterteam/form-builder": "^0.0.25",
-    "@masterteam/structure-builder": "^0.0.50",
-    "@masterteam/components": "^0.0.158",
-    "@masterteam/notification": "^0.0.20"
+    "@masterteam/form-builder": "^0.0.25"
   },
   "sideEffects": false,
   "exports": {

package/types/masterteam-workflow.d.ts

@@ -16,8 +16,12 @@ interface LoadingStateShape<L extends string = string> {
     errors: Partial<Record<L, string>>;
 }
 
-type WorkflowStepType = 'UserInput' | 'AppAction';
+type WorkflowStepType = 'UserInput' | 'AppAction' | 'ApprovalCommit';
 type WorkflowAppActionFailureBehavior = 'Stop' | 'Continue' | string;
+type WorkflowAppActionPhase = 'BeforeCommit' | 'Commit' | 'AfterCommit' | string;
+type WorkflowAppActionRuntimeInputSource = 'Context' | 'InternalResolver' | string;
+type WorkflowAppActionFieldUIControl = 'select' | 'text' | 'number' | 'toggle' | 'json' | string;
+type WorkflowAppActionSystemKind = 'ApprovalCommit' | string;
 type WorkflowAppActionConfigPropertyType = 'string' | 'number' | 'boolean' | 'array' | 'object';
 interface WorkflowAppAction {
     appCode: string;
@@ -30,6 +34,42 @@ interface WorkflowAppAction {
     configSchemaJson?: string | null;
     requiredContextKeys?: string[];
     supportedScopes?: string[];
+    configFields?: WorkflowAppActionConfigField[];
+    runtimeInputs?: WorkflowAppActionRuntimeInput[];
+    outputs?: WorkflowAppActionOutput[];
+    supportedPhases?: WorkflowAppActionPhase[];
+}
+interface WorkflowAppActionConfigField {
+    key: string;
+    displayName: string;
+    description?: string | null;
+    type: WorkflowAppActionConfigPropertyType;
+    required: boolean;
+    uiControl?: WorkflowAppActionFieldUIControl | null;
+    optionsProviderKey?: string | null;
+    designerVisible: boolean;
+    enumValues?: Array<string | number | boolean>;
+    defaultValue?: unknown;
+}
+interface WorkflowAppActionRuntimeInput {
+    key: string;
+    source: WorkflowAppActionRuntimeInputSource;
+    contextKey?: string | null;
+    resolverKey?: string | null;
+    required: boolean;
+    designerVisible: boolean;
+}
+interface WorkflowAppActionOutput {
+    key: string;
+    type: string;
+    persistToWorkflowContext: boolean;
+    description?: string | null;
+}
+interface WorkflowAppActionOption {
+    value: string | number | boolean;
+    label: string | Record<string, string>;
+    disabled?: boolean;
+    metadata?: Record<string, string | number | boolean | null>;
 }
 interface WorkflowAppActionDescriptor {
     appCode: string;
@@ -39,6 +79,10 @@ interface WorkflowAppActionDescriptor {
     configSchemaJson?: string | null;
     requiredContextKeys?: string[];
     supportedScopes?: string[];
+    configFields?: WorkflowAppActionConfigField[];
+    runtimeInputs?: WorkflowAppActionRuntimeInput[];
+    outputs?: WorkflowAppActionOutput[];
+    supportedPhases?: WorkflowAppActionPhase[];
 }
 interface WorkflowAppActionConfigPropertySchema {
     key: string;
@@ -64,6 +108,9 @@ interface WorkflowStepSchema {
     targetValue?: string;
     appAction?: WorkflowAppAction | null;
     loading?: boolean;
+    systemKind?: WorkflowAppActionSystemKind | null;
+    isSystem?: boolean;
+    isLocked?: boolean;
 }
 interface WorkflowConnection {
     id: number;
@@ -165,6 +212,9 @@ interface StepSchema {
     hasNotification: boolean;
     hasForm?: boolean;
     appAction?: WorkflowAppAction | null;
+    systemKind?: WorkflowAppActionSystemKind | null;
+    isSystem?: boolean;
+    isLocked?: boolean;
 }
 interface StepPropertyPayload {
     PropertyId: number;
@@ -196,6 +246,9 @@ interface StepResponse {
     targetValue?: string;
     properties: any[];
     appAction?: WorkflowAppAction | null;
+    systemKind?: WorkflowAppActionSystemKind | null;
+    isSystem?: boolean;
+    isLocked?: boolean;
 }
 interface ConnectionPayload {
     sourceStepId: number | string;
@@ -221,7 +274,19 @@ interface PublishResponse {
     isValid: boolean;
     isPublished: boolean;
 }
-type WorkflowLoadingName = 'getWorkflows' | 'getWorkflow' | 'getFormulaProperties' | 'getGroups' | 'getRolesForModule' | 'getAppActions' | 'getAppActionDetail' | 'getStep' | 'validateFlow' | 'createStep' | 'updateStep' | 'createConnection' | 'updateConnection' | 'publishWorkflow' | 'deleteStep' | 'deleteConnection';
+type WorkflowLoadingName = 'getWorkflows' | 'getWorkflow' | 'getFormulaProperties' | 'getGroups' | 'getRolesForModule' | 'getAppActions' | 'getAppActionDetail' | 'getAppActionOptions' | 'getStep' | 'validateFlow' | 'createStep' | 'updateStep' | 'createConnection' | 'updateConnection' | 'publishWorkflow' | 'deleteStep' | 'deleteConnection';
+/**
+ * Cached option list keyed by `${actionKey}::${fieldKey}::${paramHash}`.
+ * `paramHash` is a deterministic stringification of the query params used
+ * (requestSchemaId, levelId, moduleId, ...). Empty params hash is "_".
+ */
+type WorkflowAppActionOptionsCacheKey = string;
+interface WorkflowAppActionOptionsCacheEntry {
+    options: WorkflowAppActionOption[];
+    errorCode?: string | null;
+    errorMessage?: string | null;
+    loadedAt: number;
+}
 interface WorkflowStateModel extends LoadingStateShape<WorkflowLoadingName> {
     workflowId: string | number | null;
     parentModuleType?: string | null;
@@ -236,6 +301,7 @@ interface WorkflowStateModel extends LoadingStateShape<WorkflowLoadingName> {
     roles: Array<RoleDefinition | RoleGroupDefinition>;
     appActionDescriptors: WorkflowAppActionDescriptor[];
     selectedAppActionDescriptor: WorkflowAppActionDescriptor | null;
+    appActionOptionsCache: Record<WorkflowAppActionOptionsCacheKey, WorkflowAppActionOptionsCacheEntry>;
     selectedStep: StepSchema | null;
     isFlowValid: boolean | null;
 }
@@ -274,6 +340,13 @@ declare class GetAppActionDetail {
     static readonly type = "[Workflow] Get App Action Detail";
     constructor(actionKey: string);
 }
+declare class GetAppActionOptions {
+    readonly actionKey: string;
+    readonly fieldKey: string;
+    readonly params?: Record<string, string | number | boolean | null | undefined> | undefined;
+    static readonly type = "[Workflow] Get App Action Options";
+    constructor(actionKey: string, fieldKey: string, params?: Record<string, string | number | boolean | null | undefined> | undefined);
+}
 declare class GetStep {
     readonly stepId: string | number;
     static readonly type = "[Workflow] Get Step";
@@ -333,6 +406,7 @@ declare class WorkflowFacade {
     readonly roles: _angular_core.Signal<(RoleDefinition | RoleGroupDefinition)[]>;
     readonly appActionDescriptors: _angular_core.Signal<WorkflowAppActionDescriptor[]>;
     readonly selectedAppActionDescriptor: _angular_core.Signal<WorkflowAppActionDescriptor | null>;
+    readonly appActionOptionsCache: _angular_core.Signal<Record<string, WorkflowAppActionOptionsCacheEntry>>;
     readonly selectedStep: _angular_core.Signal<StepSchema | null>;
     readonly isFlowValid: _angular_core.Signal<boolean | null>;
     readonly steps: _angular_core.Signal<WorkflowStepSchema[]>;
@@ -348,6 +422,13 @@ declare class WorkflowFacade {
     loadRolesForModule(): Observable<unknown>;
     loadAppActions(): Observable<unknown>;
     loadAppActionDetail(actionKey: string): Observable<unknown>;
+    loadAppActionOptions(actionKey: string, fieldKey: string, params?: Record<string, string | number | boolean | null | undefined>): Observable<unknown>;
+    /**
+     * Synchronous lookup helper: returns the cached options entry for a given
+     * (actionKey, fieldKey, params) combination, or `undefined` if the request
+     * has not been issued yet. Pair with `loadAppActionOptions` to fetch.
+     */
+    getCachedAppActionOptions(actionKey: string, fieldKey: string, params?: Record<string, string | number | boolean | null | undefined>): WorkflowAppActionOptionsCacheEntry | undefined;
     loadStep(stepId: string | number): Observable<unknown>;
     validateFlow(): Observable<unknown>;
     createStep(payload: StepPayload): Observable<unknown>;
@@ -388,6 +469,7 @@ declare class WorkflowState {
     static roles(state: WorkflowStateModel): Array<RoleDefinition | RoleGroupDefinition>;
     static appActionDescriptors(state: WorkflowStateModel): WorkflowAppActionDescriptor[];
     static selectedAppActionDescriptor(state: WorkflowStateModel): WorkflowAppActionDescriptor | null;
+    static appActionOptionsCache(state: WorkflowStateModel): Record<string, WorkflowAppActionOptionsCacheEntry>;
     static selectedStep(state: WorkflowStateModel): StepSchema | null;
     static isFlowValid(state: WorkflowStateModel): boolean | null;
     static stepsSchema(state: WorkflowStateModel): WorkflowStepSchema[];
@@ -402,6 +484,7 @@ declare class WorkflowState {
     getRolesForModule(ctx: StateContext<WorkflowStateModel>, _action: GetRolesForModule): rxjs.Observable<never[] | Response<unknown[]>>;
     getAppActions(ctx: StateContext<WorkflowStateModel>, _action: GetAppActions): rxjs.Observable<WorkflowAppActionDescriptor[]> | rxjs.Observable<never[] | Response<unknown>>;
     getAppActionDetail(ctx: StateContext<WorkflowStateModel>, action: GetAppActionDetail): rxjs.Observable<WorkflowAppActionDescriptor> | rxjs.Observable<Response<unknown> | null>;
+    getAppActionOptions(ctx: StateContext<WorkflowStateModel>, action: GetAppActionOptions): rxjs.Observable<WorkflowAppActionOption[] | Response<unknown>>;
     getStep(ctx: StateContext<WorkflowStateModel>, action: GetStep): rxjs.Observable<Response<StepSchema> | null>;
     validateFlow(ctx: StateContext<WorkflowStateModel>, _action: ValidateFlow): rxjs.Observable<Response<boolean> | null>;
     createStep(ctx: StateContext<WorkflowStateModel>, action: CreateStep): rxjs.Observable<Response<StepResponse> | null>;
@@ -414,22 +497,34 @@ declare class WorkflowState {
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<WorkflowState, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<WorkflowState>;
 }
+/**
+ * Build a deterministic cache key for an options request:
+ * `{actionKey}::{fieldKey}::{paramHash}`. The param hash is a sorted
+ * `key=value&...` string of non-empty params, or `_` if none.
+ */
+declare function buildAppActionOptionsCacheKey(actionKey: string, fieldKey: string, params?: Record<string, string | number | boolean | null | undefined>): string;
 
-type WorkflowAppActionConfigFieldKind = 'text' | 'number' | 'toggle' | 'select' | 'json';
-interface WorkflowAppActionConfigField {
+type WorkflowAppActionConfigEditorFieldKind = 'text' | 'number' | 'toggle' | 'select' | 'json';
+interface WorkflowAppActionConfigEditorField {
     key: string;
     title: string;
     description?: string | null;
     type: WorkflowAppActionConfigPropertyType;
-    kind: WorkflowAppActionConfigFieldKind;
+    kind: WorkflowAppActionConfigEditorFieldKind;
     required: boolean;
     enumValues?: Array<string | number | boolean>;
     jsonValueType?: 'array' | 'object';
+    /**
+     * When set, the select dropdown is populated dynamically by calling
+     * `GET /api/workflow-app-actions/actions/{actionKey}/options/{fieldKey}`
+     * via `WorkflowFacade.loadAppActionOptions` rather than from `enumValues`.
+     */
+    optionsProviderKey?: string | null;
 }
 interface WorkflowAppActionConfigEditorDefinition {
     mode: 'schema' | 'raw';
     schema: WorkflowAppActionConfigSchema | null;
-    fields: WorkflowAppActionConfigField[];
+    fields: WorkflowAppActionConfigEditorField[];
     errors: string[];
 }
 
@@ -471,6 +566,7 @@ declare class WorkflowBuilder {
     readonly loadingAppActions: _angular_core.Signal<boolean>;
     readonly loadingAppActionDetail: _angular_core.Signal<boolean>;
     readonly appActionListError: _angular_core.Signal<string | null>;
+    readonly publishError: _angular_core.Signal<string | null>;
     readonly appActionDetailError: _angular_core.Signal<string | null>;
     readonly selectedWorkflowId: _angular_core.Signal<number | undefined>;
     readonly connectionFormulaSchemaId: _angular_core.Signal<number | undefined>;
@@ -550,8 +646,8 @@ declare class WorkflowBuilder {
         variant: string;
         size: string;
         tooltip: string;
+        condition: (node: WorkflowStepSchema) => boolean;
         severity?: undefined;
-        condition?: undefined;
     } | {
         key: string;
         icon: string;
@@ -583,6 +679,9 @@ declare class WorkflowBuilder {
         targetValue?: string;
         appAction?: _masterteam_workflow.WorkflowAppAction | null;
         loading?: boolean;
+        systemKind?: _masterteam_workflow.WorkflowAppActionSystemKind | null;
+        isSystem?: boolean;
+        isLocked?: boolean;
     }[]>;
     readonly connections: _angular_core.Signal<{
         from: number;
@@ -607,11 +706,51 @@ declare class WorkflowBuilder {
     getStepCardTitle(step: WorkflowStepSchema): string;
     getStepTypeLabel(type: WorkflowStepType): string;
     getAppActionConfigControl(key: string): FormControl;
-    getAppActionEnumOptions(field: WorkflowAppActionConfigField): {
+    getAppActionEnumOptions(field: WorkflowAppActionConfigEditorField): {
         label: string;
         value: string | number | boolean;
     }[];
+    /**
+     * Lookup the cached dynamic options for a given config field. Returns
+     * an empty array on backend error so the template can render an error
+     * state, or `undefined` when no fetch has been issued yet.
+     */
+    private getDynamicAppActionOptions;
+    hasAppActionOptionsError(fieldKey: string): string | null;
+    private buildAppActionOptionsParams;
+    /**
+     * Fire option-loading for every descriptor `select` field that uses
+     * an `optionsProviderKey`. Called whenever the editor is rebuilt or
+     * the active actionKey changes.
+     */
+    private loadDynamicAppActionOptions;
     getAppActionDescription(): string | null;
+    /** Runtime inputs are non-editable (resolved at runtime); the editor
+     * shows them as read-only "Resolved automatically" hints. */
+    getAppActionRuntimeInputs(): _masterteam_workflow.WorkflowAppActionRuntimeInput[];
+    /** Outputs are read-only informational hints. */
+    getAppActionOutputs(): _masterteam_workflow.WorkflowAppActionOutput[];
+    /** Phases the action supports (e.g. ['AfterCommit']). Drives the
+     * placement warning when the step is placed before the commit step. */
+    getAppActionSupportedPhases(): string[];
+    /**
+     * `true` when the current action is restricted to `AfterCommit` and
+     * therefore should be placed downstream of the `Commit Approved Form`
+     * step. Surfaces an inline guidance hint in the editor.
+     */
+    isAppActionAfterCommitOnly(): boolean;
+    /**
+     * `true` when an actionKey is set, descriptor lookup is not in flight,
+     * and we still have no resolvable descriptor — i.e. the backend returned
+     * `data: null` for the descriptor describe-one call. The saved config
+     * is preserved per the AppActions handoff §5.3.
+     */
+    isAppActionMissing(): boolean;
+    describeRuntimeInputSource(input: {
+        source: string;
+        contextKey?: string | null;
+        resolverKey?: string | null;
+    }): string;
     getAppActionDisplayName(): string;
     getAppActionKey(): string;
     getAppActionConfigMessages(): string[];
@@ -644,5 +783,5 @@ declare const REQUEST_CONTEXT: HttpContextToken<{
     useBaseUrl: boolean;
 }>;
 
-export { CreateConnection, CreateStep, DeleteConnection, DeleteStep, GetAppActionDetail, GetAppActions, GetFormulaProperties, GetGroups, GetRolesForModule, GetStep, GetWorkflow, GetWorkflows, PublishWorkflow, REQUEST_CONTEXT, SetModuleInfo, UpdateConnection, UpdateStep, ValidateFlow, WorkflowBuilder, WorkflowFacade, WorkflowState };
-export type { ConnectionPayload, ConnectionResponse, FormulaProperty, GroupDefinition, PublishPayload, PublishResponse, Response, RoleDefinition, RoleGroupDefinition, StepPayload, StepPropertyItem, StepPropertyPayload, StepResponse, StepSchema, WorkflowAppAction, WorkflowAppActionConfigPropertySchema, WorkflowAppActionConfigPropertyType, WorkflowAppActionConfigSchema, WorkflowAppActionDescriptor, WorkflowAppActionFailureBehavior, WorkflowConnection, WorkflowListItem, WorkflowLoadingName, WorkflowProperty, WorkflowPropertyConfig, WorkflowSchema, WorkflowStateModel, WorkflowStepSchema, WorkflowStepType };
+export { CreateConnection, CreateStep, DeleteConnection, DeleteStep, GetAppActionDetail, GetAppActionOptions, GetAppActions, GetFormulaProperties, GetGroups, GetRolesForModule, GetStep, GetWorkflow, GetWorkflows, PublishWorkflow, REQUEST_CONTEXT, SetModuleInfo, UpdateConnection, UpdateStep, ValidateFlow, WorkflowBuilder, WorkflowFacade, WorkflowState, buildAppActionOptionsCacheKey };
+export type { ConnectionPayload, ConnectionResponse, FormulaProperty, GroupDefinition, PublishPayload, PublishResponse, Response, RoleDefinition, RoleGroupDefinition, StepPayload, StepPropertyItem, StepPropertyPayload, StepResponse, StepSchema, WorkflowAppAction, WorkflowAppActionConfigField, WorkflowAppActionConfigPropertySchema, WorkflowAppActionConfigPropertyType, WorkflowAppActionConfigSchema, WorkflowAppActionDescriptor, WorkflowAppActionFailureBehavior, WorkflowAppActionFieldUIControl, WorkflowAppActionOption, WorkflowAppActionOptionsCacheEntry, WorkflowAppActionOptionsCacheKey, WorkflowAppActionOutput, WorkflowAppActionPhase, WorkflowAppActionRuntimeInput, WorkflowAppActionRuntimeInputSource, WorkflowAppActionSystemKind, WorkflowConnection, WorkflowListItem, WorkflowLoadingName, WorkflowProperty, WorkflowPropertyConfig, WorkflowSchema, WorkflowStateModel, WorkflowStepSchema, WorkflowStepType };