@open-mercato/core 0.7.1-develop.7193.1.910a5b0a1e → 0.7.1-develop.7195.1.b5efd1d51a

package/src/modules/workflows/data/types.ts

@@ -1,4 +1,6 @@
-import type { WorkflowDefinitionTrigger } from './entities'
+import type { WorkflowContextSchema, WorkflowDefinitionTrigger } from './entities'
+import type { WorkflowErrorHandlerConfig } from './validators'
+import type { WorkflowInterpolationMode } from '../lib/interpolation-pipeline'
 
 // Re-export from validators (includes ESCALATED)
 export type { UserTaskStatus } from './validators'
@@ -42,9 +44,80 @@ export type UserTaskResponse = {
   organizationId: string
   createdAt: string
   updatedAt: string
+  /**
+   * Work-item projection added by `api/tasks/serialize.ts`; optional here
+   * because third-party callers may still be reading a pre-Phase-4 payload.
+   */
+  kind?: string
+  proposalId?: string | null
+  priority?: string | number | null
+  entityBindings?: UserTaskEntityBinding[] | null
+  /** Definition step the task is parked on, when it could be resolved. */
+  stepId?: string | null
+  /**
+   * Decision buttons, re-resolved per request from the instance's pinned
+   * definition. Never stored on the task row — see `lib/task-decisions.ts`.
+   */
+  decisions?: UserTaskDecision[]
+  /**
+   * Authored external-form renderer key, re-resolved per request from the
+   * instance's pinned definition alongside `decisions`. Null means the built-in
+   * form; an unknown key degrades to the built-in form WITH a notice, never a
+   * blank screen (`lib/task-form-registry.ts`).
+   */
+  formKey?: string | null
+  /**
+   * The §6.4 act surfaces, decided server-side (`lib/task-visibility.ts`).
+   *
+   * Optional because they are ADDITIVE: a payload written before they existed
+   * carries none, and a consumer reading one must keep working. The detail route
+   * always sends them — a page that derives `canComplete` from the status is the
+   * second implementation of the rule these fields exist to remove.
+   */
+  canComplete?: boolean
+  canClaim?: boolean
+  canRelease?: boolean
+  canReassign?: boolean
+  actBlockedReason?: TaskActionBlockReason | null
 }
 
-// Grouped metadata state for MobileVisualEditor / MobileMetadataSheet
+/**
+ * Why completion is unavailable to a caller who can read the row. Mirrors
+ * `lib/task-visibility.ts`; `unavailable` is deliberately non-diagnostic,
+ * because it stands for the entity-gate refusal the act routes answer as a bare
+ * 404, and must stay that way.
+ */
+export type TaskActionBlockReason =
+  | 'not-workable'
+  | 'owned-by-another'
+  | 'not-in-your-queue'
+  | 'unowned'
+  | 'unavailable'
+
+export type UserTaskEntityBinding = {
+  entityType: string
+  entityId: string
+  label?: string | Record<string, string> | null
+}
+
+export type UserTaskDecision = {
+  id: string
+  label: string | Record<string, string>
+  transitionId: string
+  style?: 'primary' | 'secondary' | 'destructive'
+}
+
+/**
+ * Grouped definition-metadata state shared by every surface that edits it
+ * (the Studio's details drawer and the mobile editor).
+ *
+ * `contextSchema`, `interpolation` and `errorHandler` are OPTIONAL because
+ * they were added after the shape shipped; a caller that omits them keeps the
+ * pre-existing behaviour and the drawer simply hides the sections it cannot
+ * write to. They are not "unused metadata" — omitting them from a save payload
+ * silently drops the author's configuration, which is why the Studio always
+ * carries them.
+ */
 export interface WorkflowMetadataState {
   workflowId: string
   workflowName: string
@@ -57,6 +130,9 @@ export interface WorkflowMetadataState {
   effectiveFrom: string
   effectiveTo: string
   triggers: WorkflowDefinitionTrigger[]
+  contextSchema?: WorkflowContextSchema | undefined
+  interpolation?: WorkflowInterpolationMode | undefined
+  errorHandler?: WorkflowErrorHandlerConfig | undefined
 }
 
 export interface WorkflowMetadataHandlers {
@@ -71,4 +147,7 @@ export interface WorkflowMetadataHandlers {
   setEffectiveFrom: (v: string) => void
   setEffectiveTo: (v: string) => void
   setTriggers: (v: WorkflowDefinitionTrigger[]) => void
+  setContextSchema?: (v: WorkflowContextSchema | undefined) => void
+  setInterpolation?: (v: WorkflowInterpolationMode) => void
+  setErrorHandler?: (v: WorkflowErrorHandlerConfig | undefined) => void
 }