openxiangda-contracts 2.77.0 → 2.79.1

package/dist/types.d.ts

@@ -976,6 +976,8 @@ export interface DirectoryEntry {
         label: string;
     }>;
     selectable?: boolean;
+    /** Historical entries remain selectable in a read filter. */
+    inactive?: boolean;
 }
 export interface DirectoryResolveRequest {
     schemaVersion: typeof SCHEMA_VERSIONS.directoryResolveRequest;
@@ -999,7 +1001,7 @@ export interface DirectoryEntryPage {
 export interface NativeScopeValueResolveRequest {
     schemaVersion: typeof SCHEMA_VERSIONS.nativeScopeValueResolveRequest;
     dimensionCode: string;
-    operation: "create" | "update";
+    operation: "create" | "update" | "filter";
     values: string[];
 }
 export interface NativeSelectorEnvironment {
@@ -1017,11 +1019,12 @@ export interface NativeScopeValuePage {
     resourceCode: string;
     fieldCode: string;
     dimensionCode: string;
-    operation: "create" | "update";
+    operation: "create" | "update" | "filter";
     items: Array<{
         value: string;
         label: string;
         selectable: boolean;
+        inactive?: boolean;
     }>;
     nextCursor: string | null;
 }
@@ -1036,13 +1039,19 @@ export interface DataRecordEditInput {
     recordId: string;
     expectedRevision: number;
 }
+export interface DataFieldSourceRecord {
+    id: string;
+    expectedRevision: number;
+}
 export interface DataFieldSourceQuery {
     schemaVersion: typeof SCHEMA_VERSIONS.dataFieldSourceQuery;
-    operation: "create" | "update";
+    operation: "create" | "update" | "filter";
     keyword?: string;
     cursor?: string;
     /** Values for the source declaration's validated current-form bindings. */
     bindings?: Record<string, unknown>;
+    /** Saved row context for an ordinary update; never contains saved private values. */
+    record?: DataFieldSourceRecord;
     /** 正式流程发起意图；平台核验字段绑定和动作能力，目标仍按当前用户读取。 */
     launch?: DataFieldSourceLaunchBinding;
     action?: DataRecordEditInput;
@@ -1080,7 +1089,7 @@ export interface DataFieldSourcePage {
     resourceCode: string;
     fieldCode: string;
     sourceResourceCode: string;
-    operation: "create" | "update";
+    operation: "create" | "update" | "filter";
     items: ResourceReferenceValue[];
     nextCursor: string | null;
 }
@@ -1744,6 +1753,14 @@ export interface DataTransactionRequest {
     decimalReservation?: DataDecimalReservationTransition;
 }
 export interface DataTransactionResult {
+    /** Historical service identity; never a reusable authority token. */
+    serviceMutation?: {
+        kind: 'backend-event' | 'service-action';
+        grantsDigest: string;
+        operationCode?: string;
+        eventId?: string;
+        subscriptionCode?: string;
+    };
     schemaVersion: typeof SCHEMA_VERSIONS.dataTransactionResult;
     idempotencyKey: string;
     /** Post-lock database acceptance time used by every dynamic guard assertion. */
@@ -1780,7 +1797,8 @@ export interface CloudEvent<TData extends Record<string, unknown> = Record<strin
 }
 export declare const DATA_EVENT_TYPES_V2: readonly ["openxiangda.data.record.created.v2", "openxiangda.data.record.updated.v2", "openxiangda.data.record.deleted.v2"];
 export type DataEventTypeV2 = (typeof DATA_EVENT_TYPES_V2)[number];
-export declare const WORKFLOW_EVENT_TYPES_V2: readonly ["openxiangda.workflow.node.skipped.v2", "openxiangda.workflow.step.requested.v2", "openxiangda.workflow.step.result_received.v2", "openxiangda.workflow.step.completed.v2", "openxiangda.workflow.step.continuation_failed.v2", "openxiangda.workflow.instance.started.v2", "openxiangda.workflow.instance.completed.v2", "openxiangda.workflow.instance.rejected.v2", "openxiangda.workflow.instance.returned.v2", "openxiangda.workflow.instance.resumed.v2", "openxiangda.workflow.instance.withdrawn.v2", "openxiangda.workflow.instance.terminated.v2", "openxiangda.workflow.instance.cc_added.v2", "openxiangda.workflow.task.created.v2", "openxiangda.workflow.task.assigned.v2", "openxiangda.workflow.task.assignment_pending.v2", "openxiangda.workflow.task.assignment_resolution_failed.v2", "openxiangda.workflow.task.approved.v2", "openxiangda.workflow.task.completed.v2", "openxiangda.workflow.task.rejected.v2", "openxiangda.workflow.task.returned.v2", "openxiangda.workflow.task.resubmitted.v2", "openxiangda.workflow.task.transferred.v2", "openxiangda.workflow.task.reassigned.v2", "openxiangda.workflow.task.delegated.v2", "openxiangda.workflow.task.assignee_added.v2", "openxiangda.workflow.task.cancelled.v2", "openxiangda.workflow.participant.activated.v2", "openxiangda.workflow.participant.completed.v2", "openxiangda.workflow.participant.rejected.v2", "openxiangda.workflow.participant.returned.v2", "openxiangda.workflow.participant.transferred.v2", "openxiangda.workflow.participant.reassigned.v2", "openxiangda.workflow.participant.delegated.v2", "openxiangda.workflow.participant.added.v2", "openxiangda.workflow.participant.suspended.v2", "openxiangda.workflow.participant.resumed.v2", "openxiangda.workflow.participant.cancelled.v2"];
+import { WORKFLOW_EVENT_TYPES_V2 } from './native-compiler/workflow-events.js';
+export { WORKFLOW_EVENT_TYPES_V2 } from './native-compiler/workflow-events.js';
 export type WorkflowEventTypeV2 = (typeof WORKFLOW_EVENT_TYPES_V2)[number];
 export type EventProducerKind = "data" | "app" | "workflow" | "timer" | "date" | "system";
 export interface EventCatalogEntry {
@@ -2054,7 +2072,7 @@ export interface DateTrigger {
 }
 export type WorkflowApprovalMode = "single" | "any" | "all" | "sequence";
 export type WorkflowFieldPolicy = "hidden" | "readonly" | "edit" | "edit_required";
-export type WorkflowCommand = "save_form" | "approve" | "reject" | "return" | "transfer" | "delegate" | "add_assignee" | "resubmit" | "withdraw" | "terminate" | "cc" | "admin_reassign" | "admin_override" | "retry_resolution";
+export type WorkflowCommand = "complete" | "save_form" | "approve" | "reject" | "return" | "transfer" | "delegate" | "add_assignee" | "resubmit" | "withdraw" | "terminate" | "cc" | "admin_reassign" | "admin_override" | "retry_resolution";
 export type WorkflowExpression = {
     op: "literal";
     value: unknown;
@@ -2073,6 +2091,7 @@ export type WorkflowExpression = {
     value: WorkflowExpression;
 };
 export interface WorkflowApprovalNode {
+    reminders?: import('./native-compiler/workflow-reminders.js').WorkflowReminders;
     id: string;
     kind: "approval";
     title: string;
@@ -2088,10 +2107,13 @@ export interface WorkflowApprovalNode {
     onReject: string;
     allowedOperations?: WorkflowCommand[];
     returnTargets?: string[];
+    returnPolicy?: import('./native-compiler/workflow-return-policy.js').WorkflowReturnPolicy;
     /** Immutable reference to an application-owned task page input contract. */
     taskPageCode?: string;
     /** Code-owned defaults; labels never change the stable command semantics. */
     operationPolicy?: Partial<Record<WorkflowConfigurableOperation, WorkflowNodeOperationPolicy>>;
+    /** Released hard requirements; registering a command handler does not force its action on. */
+    requiredOperations?: WorkflowConfigurableOperation[];
     /** Explicit upper bound for administrator changes. Topology remains immutable. */
     administration?: WorkflowApprovalAdministration;
     fieldPolicy?: {
@@ -2099,10 +2121,15 @@ export interface WorkflowApprovalNode {
         fields?: Record<string, WorkflowFieldPolicy>;
     };
 }
-export type WorkflowConfigurableOperation = 'approve' | 'reject' | 'return' | 'transfer' | 'delegate' | 'add_assignee';
+export type WorkflowConfigurableOperation = 'complete' | 'approve' | 'reject' | 'save_form' | 'return' | 'transfer' | 'delegate' | 'add_assignee';
+export type WorkflowOperationOpinion = 'none' | 'optional' | 'required';
 export type WorkflowConfigurableAssigneeProvider = 'fixed_users' | 'app_role' | 'app_role_in_scope';
 export interface WorkflowNodeOperationPolicy {
     label?: string;
+    /** Presentation default; never changes command or field authorization. */
+    opinion?: WorkflowOperationOpinion;
+    /** Released minimum. Omitted preserves legacy required baselines. */
+    minimumOpinion?: WorkflowOperationOpinion;
     /** Approve defaults to false, reject to true; explicit false is code-owned. */
     commentRequired?: boolean;
     /** Transfer/delegate/add_assignee/return default to true; administrators cannot loosen the code baseline. */
@@ -2113,6 +2140,13 @@ export interface WorkflowApprovalAdministration {
     assigneeProviders?: WorkflowConfigurableAssigneeProvider[];
     operations?: WorkflowConfigurableOperation[];
 }
+/** Independent human handling: completion records no approval decision. */
+export interface WorkflowHandleNode extends Omit<WorkflowApprovalNode, 'kind' | 'onApprove' | 'onReject' | 'emptyPolicy' | 'initiatorApprovalPolicy' | 'completionDeadline'> {
+    kind: 'handle';
+    next: string;
+    emptyPolicy?: 'block';
+}
+export type WorkflowHumanNode = WorkflowApprovalNode | WorkflowHandleNode;
 export interface WorkflowConditionNode {
     id: string;
     kind: "condition";
@@ -2144,7 +2178,7 @@ export interface WorkflowCcNode {
     notify?: boolean;
     administration?: WorkflowCcAdministration;
 }
-export type WorkflowNode = WorkflowApprovalNode | WorkflowConditionNode | WorkflowEndNode | WorkflowCcNode | import('./native-compiler/workflow-correction.js').WorkflowCorrectionNode | WorkflowBusinessStepNode;
+export type WorkflowNode = import('./native-compiler/workflow-parallel.js').WorkflowParallelNode | import('./native-compiler/workflow-parallel.js').WorkflowJoinNode | WorkflowHandleNode | WorkflowApprovalNode | WorkflowConditionNode | WorkflowEndNode | WorkflowCcNode | import('./native-compiler/workflow-correction.js').WorkflowCorrectionNode | WorkflowBusinessStepNode;
 export interface WorkflowDefinition {
     schemaVersion: typeof SCHEMA_VERSIONS.workflowDefinition;
     code: string;
@@ -2195,8 +2229,8 @@ export interface WorkflowSubjectDefinition {
     /** Read-only business fields projected on the workflow task/instance Surface. */
     summaryFields?: string[];
 }
-export type WorkflowBindingProvider = "fixed_users" | "initiator" | "input_users" | "form_field_users" | "department_supervisor" | "app_role" | "app_role_in_scope" | "business_relation" | "previous_node_actor" | "initiator_select" | "application_provider";
-export interface WorkflowBindingEntry {
+export type WorkflowBindingProvider = "fixed_users" | "initiator" | "input_users" | "form_field_users" | "department_supervisor" | "supervisor_chain" | "app_role" | "app_role_in_scope" | "business_relation" | "previous_node_actor" | "initiator_select" | "application_provider";
+export interface WorkflowBindingEntry extends Partial<import('./native-compiler/workflow-supervisor-chain.js').WorkflowSupervisorChainParameters> {
     provider: WorkflowBindingProvider;
     /** Reference to the constrained subject field; role/scope remain declared once. */
     candidateField?: string;
@@ -2359,7 +2393,7 @@ export interface WorkflowNodeConfigurationPatch {
     title?: string;
     description?: string;
     mode?: WorkflowApprovalMode;
-    operations?: Partial<Record<WorkflowConfigurableOperation, WorkflowNodeOperationPolicy & {
+    operations?: Partial<Record<WorkflowConfigurableOperation, Omit<WorkflowNodeOperationPolicy, 'minimumOpinion'> & {
         enabled?: boolean;
     }>>;
     assignee?: {
@@ -2398,6 +2432,8 @@ export interface WorkflowNodeConfigurations {
             initiatorApprovalPolicy?: "manual" | "auto_approve";
             completionDeadline?: import('./native-compiler/workflow-completion-deadline.js').WorkflowCompletionDeadline;
             allowedOperations?: WorkflowCommand[];
+            requiredOperations?: WorkflowConfigurableOperation[];
+            taskPageCode?: string;
             operationPolicy?: Partial<Record<WorkflowConfigurableOperation, WorkflowNodeOperationPolicy>>;
             fieldPolicy?: WorkflowApprovalNode['fieldPolicy'];
         };
@@ -2816,6 +2852,7 @@ export interface WorkflowTask {
     nodeId: string;
     title: string;
     status: "assignment_pending" | "assigned" | "completed" | "rejected" | "returned" | "cancelled" | "expired";
+    nodeKind?: WorkflowNode['kind'];
     approvalMode: WorkflowApprovalMode;
     taskKind: "normal" | "return_review" | "resume";
     assignedRoleSubjectKey: string | null;
@@ -2866,7 +2903,7 @@ export interface WorkflowTaskParticipant {
     kind: "primary" | "add_sign" | "transfer" | "delegate";
     status: "pending" | "active" | "approved" | "rejected" | "cancelled";
     required: boolean;
-    outcome: "approved" | "rejected" | "returned" | "resubmitted" | "transferred" | "delegated" | null;
+    outcome: "completed" | "approved" | "rejected" | "returned" | "resubmitted" | "transferred" | "delegated" | null;
     sourceParticipantId: string | null;
     delegationId: string | null;
     delegationValidFrom: IsoDateTime | null;
@@ -2882,7 +2919,12 @@ export interface WorkflowOperationSurface {
     label: string;
     group: "decision" | "task_collaboration" | "initiator" | "administration" | "app_action";
     audience: "participant" | "initiator" | "administrator" | "application";
+    /** Legacy placement, retained for older consumers. */
     placement: "primary" | "secondary" | "overflow";
+    /** Server-owned order: lower is more prominent; null is always in More. */
+    prominence?: number | null;
+    /** Human-readable effect, separate from input validation and command authority. */
+    consequence?: string;
     emphasis: "primary" | "danger" | "warning" | "neutral";
     /** @deprecated Consume emphasis. Kept during the alpha package transition. */
     tone: string;