@objectstack/client 7.5.0 → 7.6.0

package/dist/index.d.mts

@@ -1,8 +1,9 @@
 import { FilterCondition, QueryAST, SortNode, AggregationNode } from '@objectstack/spec/data';
-import { MetadataEvent, DataEvent, ApiRoutes, GetDiscoveryResponse, WellKnownCapabilities, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions, LoginRequest, SessionResponse, RegisterRequest, FileUploadResponse, GetPresignedUrlRequest, PresignedUrlResponse, InitiateChunkedUploadRequest, InitiateChunkedUploadResponse, UploadChunkResponse, CompleteChunkedUploadRequest, CompleteChunkedUploadResponse, CheckPermissionRequest, CheckPermissionResponse, GetObjectPermissionsResponse, GetEffectivePermissionsResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, SetPresenceRequest, GetPresenceResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, WorkflowTransitionRequest, WorkflowTransitionResponse, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, ListViewsResponse, GetViewResponse, CreateViewRequest, CreateViewResponse, UpdateViewRequest, UpdateViewResponse, DeleteViewResponse, RegisterDeviceRequest, RegisterDeviceResponse, UnregisterDeviceResponse, GetNotificationPreferencesResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ListNotificationsResponse, MarkNotificationsReadResponse, MarkAllNotificationsReadResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AiInsightsRequest, AiInsightsResponse, GetLocalesResponse, GetTranslationsResponse, GetFieldLabelsResponse, GetFeedResponse, CreateFeedItemResponse, UpdateFeedItemResponse, DeleteFeedItemResponse, AddReactionResponse, RemoveReactionResponse, PinFeedItemResponse, UnpinFeedItemResponse, StarFeedItemResponse, UnstarFeedItemResponse, SearchFeedResponse, GetChangelogResponse, SubscribeResponse, UnsubscribeResponse, StandardErrorCode, ErrorCategory } from '@objectstack/spec/api';
-export { AddReactionResponse, AiInsightsRequest, AiInsightsResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AuthFeaturesConfig, AuthProviderInfo, BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CheckPermissionRequest, CheckPermissionResponse, CreateFeedItemResponse, CreateViewResponse, DeleteFeedItemResponse, DeleteManyRequest, DeleteViewResponse, EmailPasswordConfigPublic, ErrorCategory, GetAuthConfigResponse, GetChangelogResponse, GetDiscoveryResponse, GetEffectivePermissionsResponse, GetFeedResponse, GetFieldLabelsResponse, GetLocalesResponse, GetMetaItemsResponse, GetMetaTypesResponse, GetObjectPermissionsResponse, GetPresenceResponse, GetTranslationsResponse, GetViewResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, ListNotificationsResponse, ListViewsResponse, MetadataCacheRequest, MetadataCacheResponse, PinFeedItemResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RefreshTokenRequest, RegisterDeviceRequest, RegisterDeviceResponse, RegisterRequest, RemoveReactionResponse, SearchFeedResponse, StandardErrorCode, StarFeedItemResponse, SubscribeResponse, UnpinFeedItemResponse, UnstarFeedItemResponse, UnsubscribeResponse, UpdateFeedItemResponse, UpdateManyRequest, UpdateViewResponse, WellKnownCapabilities, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, WorkflowTransitionRequest, WorkflowTransitionResponse } from '@objectstack/spec/api';
+import { MetadataEvent, DataEvent, ApiRoutes, GetDiscoveryResponse, WellKnownCapabilities, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions, LoginRequest, SessionResponse, RegisterRequest, FileUploadResponse, GetPresignedUrlRequest, PresignedUrlResponse, InitiateChunkedUploadRequest, InitiateChunkedUploadResponse, UploadChunkResponse, CompleteChunkedUploadRequest, CompleteChunkedUploadResponse, CheckPermissionRequest, CheckPermissionResponse, GetObjectPermissionsResponse, GetEffectivePermissionsResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, SetPresenceRequest, GetPresenceResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, WorkflowTransitionRequest, WorkflowTransitionResponse, ListViewsResponse, GetViewResponse, CreateViewRequest, CreateViewResponse, UpdateViewRequest, UpdateViewResponse, DeleteViewResponse, RegisterDeviceRequest, RegisterDeviceResponse, UnregisterDeviceResponse, GetNotificationPreferencesResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ListNotificationsResponse, MarkNotificationsReadResponse, MarkAllNotificationsReadResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AiInsightsRequest, AiInsightsResponse, GetLocalesResponse, GetTranslationsResponse, GetFieldLabelsResponse, GetFeedResponse, CreateFeedItemResponse, UpdateFeedItemResponse, DeleteFeedItemResponse, AddReactionResponse, RemoveReactionResponse, PinFeedItemResponse, UnpinFeedItemResponse, StarFeedItemResponse, UnstarFeedItemResponse, SearchFeedResponse, GetChangelogResponse, SubscribeResponse, UnsubscribeResponse, StandardErrorCode, ErrorCategory } from '@objectstack/spec/api';
+export { AddReactionResponse, AiInsightsRequest, AiInsightsResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AuthFeaturesConfig, AuthProviderInfo, BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CheckPermissionRequest, CheckPermissionResponse, CreateFeedItemResponse, CreateViewResponse, DeleteFeedItemResponse, DeleteManyRequest, DeleteViewResponse, EmailPasswordConfigPublic, ErrorCategory, GetAuthConfigResponse, GetChangelogResponse, GetDiscoveryResponse, GetEffectivePermissionsResponse, GetFeedResponse, GetFieldLabelsResponse, GetLocalesResponse, GetMetaItemsResponse, GetMetaTypesResponse, GetObjectPermissionsResponse, GetPresenceResponse, GetTranslationsResponse, GetViewResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, ListNotificationsResponse, ListViewsResponse, MetadataCacheRequest, MetadataCacheResponse, PinFeedItemResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RefreshTokenRequest, RegisterDeviceRequest, RegisterDeviceResponse, RegisterRequest, RemoveReactionResponse, SearchFeedResponse, StandardErrorCode, StarFeedItemResponse, SubscribeResponse, UnpinFeedItemResponse, UnstarFeedItemResponse, UnsubscribeResponse, UpdateFeedItemResponse, UpdateManyRequest, UpdateViewResponse, WellKnownCapabilities, WorkflowTransitionRequest, WorkflowTransitionResponse } from '@objectstack/spec/api';
+import { RealtimeEventPayload, ApprovalStatus, ApprovalRequestRow, ApprovalDecisionResult, ApprovalActionRow } from '@objectstack/spec/contracts';
+export { ApprovalActionRow, ApprovalDecisionInput, ApprovalDecisionResult, ApprovalRequestRow, ApprovalStatus } from '@objectstack/spec/contracts';
 import { Logger } from '@objectstack/core/logger';
-import { RealtimeEventPayload } from '@objectstack/spec/contracts';
 
 /**
  * Realtime API Module for ObjectStackClient
@@ -411,6 +412,7 @@ declare class ObjectStackClient {
             graphql?: string | undefined;
             packages?: string | undefined;
             workflow?: string | undefined;
+            approvals?: string | undefined;
             realtime?: string | undefined;
             notifications?: string | undefined;
             ai?: string | undefined;
@@ -1679,14 +1681,52 @@ declare class ObjectStackClient {
          * Execute a workflow state transition
          */
         transition: (request: WorkflowTransitionRequest) => Promise<WorkflowTransitionResponse>;
+    };
+    /**
+     * Approval Services (ADR-0019)
+     *
+     * Approval is a first-class flow node, not a workflow step: a flow's
+     * Approval node opens a request and suspends the run; recording a decision
+     * here finalises the request and resumes the owning flow down the matching
+     * `approve` / `reject` edge. This namespace drives the "my approvals" inbox
+     * and the decision API exposed under `/api/v1/approvals`.
+     */
+    approvals: {
+        /**
+         * List approval requests ("my approvals" inbox). Filter by status, target
+         * object / record, the user expected to act next, or the submitter.
+         */
+        listRequests: (filter?: {
+            object?: string;
+            recordId?: string;
+            status?: ApprovalStatus | ApprovalStatus[];
+            approverId?: string;
+            submitterId?: string;
+        }) => Promise<ApprovalRequestRow[]>;
         /**
-         * Approve a workflow step
+         * Get a single approval request by id.
          */
-        approve: (request: WorkflowApproveRequest) => Promise<WorkflowApproveResponse>;
+        getRequest: (requestId: string) => Promise<ApprovalRequestRow>;
+        /**
+         * Record an approve decision on a request. Finalises the request when the
+         * node's behaviour is satisfied and resumes the owning flow run.
+         */
+        approve: (requestId: string, decision?: {
+            actorId?: string;
+            comment?: string;
+        }) => Promise<ApprovalDecisionResult>;
+        /**
+         * Record a reject decision on a request. Resumes the owning flow run down
+         * the `reject` edge.
+         */
+        reject: (requestId: string, decision?: {
+            actorId?: string;
+            comment?: string;
+        }) => Promise<ApprovalDecisionResult>;
         /**
-         * Reject a workflow step
+         * Audit trail (the immutable action log) for an approval request.
          */
-        reject: (request: WorkflowRejectRequest) => Promise<WorkflowRejectResponse>;
+        listActions: (requestId: string) => Promise<ApprovalActionRow[]>;
     };
     /**
      * Views CRUD Services

package/dist/index.d.ts

@@ -1,8 +1,9 @@
 import { FilterCondition, QueryAST, SortNode, AggregationNode } from '@objectstack/spec/data';
-import { MetadataEvent, DataEvent, ApiRoutes, GetDiscoveryResponse, WellKnownCapabilities, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions, LoginRequest, SessionResponse, RegisterRequest, FileUploadResponse, GetPresignedUrlRequest, PresignedUrlResponse, InitiateChunkedUploadRequest, InitiateChunkedUploadResponse, UploadChunkResponse, CompleteChunkedUploadRequest, CompleteChunkedUploadResponse, CheckPermissionRequest, CheckPermissionResponse, GetObjectPermissionsResponse, GetEffectivePermissionsResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, SetPresenceRequest, GetPresenceResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, WorkflowTransitionRequest, WorkflowTransitionResponse, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, ListViewsResponse, GetViewResponse, CreateViewRequest, CreateViewResponse, UpdateViewRequest, UpdateViewResponse, DeleteViewResponse, RegisterDeviceRequest, RegisterDeviceResponse, UnregisterDeviceResponse, GetNotificationPreferencesResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ListNotificationsResponse, MarkNotificationsReadResponse, MarkAllNotificationsReadResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AiInsightsRequest, AiInsightsResponse, GetLocalesResponse, GetTranslationsResponse, GetFieldLabelsResponse, GetFeedResponse, CreateFeedItemResponse, UpdateFeedItemResponse, DeleteFeedItemResponse, AddReactionResponse, RemoveReactionResponse, PinFeedItemResponse, UnpinFeedItemResponse, StarFeedItemResponse, UnstarFeedItemResponse, SearchFeedResponse, GetChangelogResponse, SubscribeResponse, UnsubscribeResponse, StandardErrorCode, ErrorCategory } from '@objectstack/spec/api';
-export { AddReactionResponse, AiInsightsRequest, AiInsightsResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AuthFeaturesConfig, AuthProviderInfo, BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CheckPermissionRequest, CheckPermissionResponse, CreateFeedItemResponse, CreateViewResponse, DeleteFeedItemResponse, DeleteManyRequest, DeleteViewResponse, EmailPasswordConfigPublic, ErrorCategory, GetAuthConfigResponse, GetChangelogResponse, GetDiscoveryResponse, GetEffectivePermissionsResponse, GetFeedResponse, GetFieldLabelsResponse, GetLocalesResponse, GetMetaItemsResponse, GetMetaTypesResponse, GetObjectPermissionsResponse, GetPresenceResponse, GetTranslationsResponse, GetViewResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, ListNotificationsResponse, ListViewsResponse, MetadataCacheRequest, MetadataCacheResponse, PinFeedItemResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RefreshTokenRequest, RegisterDeviceRequest, RegisterDeviceResponse, RegisterRequest, RemoveReactionResponse, SearchFeedResponse, StandardErrorCode, StarFeedItemResponse, SubscribeResponse, UnpinFeedItemResponse, UnstarFeedItemResponse, UnsubscribeResponse, UpdateFeedItemResponse, UpdateManyRequest, UpdateViewResponse, WellKnownCapabilities, WorkflowApproveRequest, WorkflowApproveResponse, WorkflowRejectRequest, WorkflowRejectResponse, WorkflowTransitionRequest, WorkflowTransitionResponse } from '@objectstack/spec/api';
+import { MetadataEvent, DataEvent, ApiRoutes, GetDiscoveryResponse, WellKnownCapabilities, GetMetaTypesResponse, GetMetaItemsResponse, MetadataCacheRequest, MetadataCacheResponse, BatchUpdateRequest, BatchUpdateResponse, BatchOptions, LoginRequest, SessionResponse, RegisterRequest, FileUploadResponse, GetPresignedUrlRequest, PresignedUrlResponse, InitiateChunkedUploadRequest, InitiateChunkedUploadResponse, UploadChunkResponse, CompleteChunkedUploadRequest, CompleteChunkedUploadResponse, CheckPermissionRequest, CheckPermissionResponse, GetObjectPermissionsResponse, GetEffectivePermissionsResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, SetPresenceRequest, GetPresenceResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, WorkflowTransitionRequest, WorkflowTransitionResponse, ListViewsResponse, GetViewResponse, CreateViewRequest, CreateViewResponse, UpdateViewRequest, UpdateViewResponse, DeleteViewResponse, RegisterDeviceRequest, RegisterDeviceResponse, UnregisterDeviceResponse, GetNotificationPreferencesResponse, UpdateNotificationPreferencesRequest, UpdateNotificationPreferencesResponse, ListNotificationsResponse, MarkNotificationsReadResponse, MarkAllNotificationsReadResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AiInsightsRequest, AiInsightsResponse, GetLocalesResponse, GetTranslationsResponse, GetFieldLabelsResponse, GetFeedResponse, CreateFeedItemResponse, UpdateFeedItemResponse, DeleteFeedItemResponse, AddReactionResponse, RemoveReactionResponse, PinFeedItemResponse, UnpinFeedItemResponse, StarFeedItemResponse, UnstarFeedItemResponse, SearchFeedResponse, GetChangelogResponse, SubscribeResponse, UnsubscribeResponse, StandardErrorCode, ErrorCategory } from '@objectstack/spec/api';
+export { AddReactionResponse, AiInsightsRequest, AiInsightsResponse, AiNlqRequest, AiNlqResponse, AiSuggestRequest, AiSuggestResponse, AuthFeaturesConfig, AuthProviderInfo, BatchOperationResult, BatchOptions, BatchRecord, BatchUpdateRequest, BatchUpdateResponse, CheckPermissionRequest, CheckPermissionResponse, CreateFeedItemResponse, CreateViewResponse, DeleteFeedItemResponse, DeleteManyRequest, DeleteViewResponse, EmailPasswordConfigPublic, ErrorCategory, GetAuthConfigResponse, GetChangelogResponse, GetDiscoveryResponse, GetEffectivePermissionsResponse, GetFeedResponse, GetFieldLabelsResponse, GetLocalesResponse, GetMetaItemsResponse, GetMetaTypesResponse, GetObjectPermissionsResponse, GetPresenceResponse, GetTranslationsResponse, GetViewResponse, GetWorkflowConfigResponse, GetWorkflowStateResponse, ListNotificationsResponse, ListViewsResponse, MetadataCacheRequest, MetadataCacheResponse, PinFeedItemResponse, RealtimeConnectRequest, RealtimeConnectResponse, RealtimeSubscribeRequest, RealtimeSubscribeResponse, RefreshTokenRequest, RegisterDeviceRequest, RegisterDeviceResponse, RegisterRequest, RemoveReactionResponse, SearchFeedResponse, StandardErrorCode, StarFeedItemResponse, SubscribeResponse, UnpinFeedItemResponse, UnstarFeedItemResponse, UnsubscribeResponse, UpdateFeedItemResponse, UpdateManyRequest, UpdateViewResponse, WellKnownCapabilities, WorkflowTransitionRequest, WorkflowTransitionResponse } from '@objectstack/spec/api';
+import { RealtimeEventPayload, ApprovalStatus, ApprovalRequestRow, ApprovalDecisionResult, ApprovalActionRow } from '@objectstack/spec/contracts';
+export { ApprovalActionRow, ApprovalDecisionInput, ApprovalDecisionResult, ApprovalRequestRow, ApprovalStatus } from '@objectstack/spec/contracts';
 import { Logger } from '@objectstack/core/logger';
-import { RealtimeEventPayload } from '@objectstack/spec/contracts';
 
 /**
  * Realtime API Module for ObjectStackClient
@@ -411,6 +412,7 @@ declare class ObjectStackClient {
             graphql?: string | undefined;
             packages?: string | undefined;
             workflow?: string | undefined;
+            approvals?: string | undefined;
             realtime?: string | undefined;
             notifications?: string | undefined;
             ai?: string | undefined;
@@ -1679,14 +1681,52 @@ declare class ObjectStackClient {
          * Execute a workflow state transition
          */
         transition: (request: WorkflowTransitionRequest) => Promise<WorkflowTransitionResponse>;
+    };
+    /**
+     * Approval Services (ADR-0019)
+     *
+     * Approval is a first-class flow node, not a workflow step: a flow's
+     * Approval node opens a request and suspends the run; recording a decision
+     * here finalises the request and resumes the owning flow down the matching
+     * `approve` / `reject` edge. This namespace drives the "my approvals" inbox
+     * and the decision API exposed under `/api/v1/approvals`.
+     */
+    approvals: {
+        /**
+         * List approval requests ("my approvals" inbox). Filter by status, target
+         * object / record, the user expected to act next, or the submitter.
+         */
+        listRequests: (filter?: {
+            object?: string;
+            recordId?: string;
+            status?: ApprovalStatus | ApprovalStatus[];
+            approverId?: string;
+            submitterId?: string;
+        }) => Promise<ApprovalRequestRow[]>;
         /**
-         * Approve a workflow step
+         * Get a single approval request by id.
          */
-        approve: (request: WorkflowApproveRequest) => Promise<WorkflowApproveResponse>;
+        getRequest: (requestId: string) => Promise<ApprovalRequestRow>;
+        /**
+         * Record an approve decision on a request. Finalises the request when the
+         * node's behaviour is satisfied and resumes the owning flow run.
+         */
+        approve: (requestId: string, decision?: {
+            actorId?: string;
+            comment?: string;
+        }) => Promise<ApprovalDecisionResult>;
+        /**
+         * Record a reject decision on a request. Resumes the owning flow run down
+         * the `reject` edge.
+         */
+        reject: (requestId: string, decision?: {
+            actorId?: string;
+            comment?: string;
+        }) => Promise<ApprovalDecisionResult>;
         /**
-         * Reject a workflow step
+         * Audit trail (the immutable action log) for an approval request.
          */
-        reject: (request: WorkflowRejectRequest) => Promise<WorkflowRejectResponse>;
+        listActions: (requestId: string) => Promise<ApprovalActionRow[]>;
     };
     /**
      * Views CRUD Services

package/dist/index.js

@@ -2179,34 +2179,79 @@ var ObjectStackClient = class {
           })
         });
         return this.unwrapResponse(res);
+      }
+      // ADR-0019: approve/reject are no longer workflow operations. Approval is a
+      // flow node — see the `approvals` namespace below for recording decisions.
+    };
+    /**
+     * Approval Services (ADR-0019)
+     *
+     * Approval is a first-class flow node, not a workflow step: a flow's
+     * Approval node opens a request and suspends the run; recording a decision
+     * here finalises the request and resumes the owning flow down the matching
+     * `approve` / `reject` edge. This namespace drives the "my approvals" inbox
+     * and the decision API exposed under `/api/v1/approvals`.
+     */
+    this.approvals = {
+      /**
+       * List approval requests ("my approvals" inbox). Filter by status, target
+       * object / record, the user expected to act next, or the submitter.
+       */
+      listRequests: async (filter) => {
+        const route = this.getRoute("approvals");
+        const params = new URLSearchParams();
+        if (filter?.object) params.set("object", filter.object);
+        if (filter?.recordId) params.set("recordId", filter.recordId);
+        if (filter?.status) {
+          params.set("status", Array.isArray(filter.status) ? filter.status.join(",") : filter.status);
+        }
+        if (filter?.approverId) params.set("approverId", filter.approverId);
+        if (filter?.submitterId) params.set("submitterId", filter.submitterId);
+        const qs = params.toString();
+        const res = await this.fetch(`${this.baseUrl}${route}/requests${qs ? `?${qs}` : ""}`);
+        const body = await this.unwrapResponse(res);
+        return Array.isArray(body) ? body : body?.data ?? [];
       },
       /**
-       * Approve a workflow step
+       * Get a single approval request by id.
        */
-      approve: async (request) => {
-        const route = this.getRoute("workflow");
-        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(request.object)}/${encodeURIComponent(request.recordId)}/approve`, {
+      getRequest: async (requestId) => {
+        const route = this.getRoute("approvals");
+        const res = await this.fetch(`${this.baseUrl}${route}/requests/${encodeURIComponent(requestId)}`);
+        return this.unwrapResponse(res);
+      },
+      /**
+       * Record an approve decision on a request. Finalises the request when the
+       * node's behaviour is satisfied and resumes the owning flow run.
+       */
+      approve: async (requestId, decision) => {
+        const route = this.getRoute("approvals");
+        const res = await this.fetch(`${this.baseUrl}${route}/requests/${encodeURIComponent(requestId)}/approve`, {
           method: "POST",
-          body: JSON.stringify({
-            comment: request.comment,
-            data: request.data
-          })
+          body: JSON.stringify({ actorId: decision?.actorId, comment: decision?.comment })
         });
         return this.unwrapResponse(res);
       },
       /**
-       * Reject a workflow step
+       * Record a reject decision on a request. Resumes the owning flow run down
+       * the `reject` edge.
        */
-      reject: async (request) => {
-        const route = this.getRoute("workflow");
-        const res = await this.fetch(`${this.baseUrl}${route}/${encodeURIComponent(request.object)}/${encodeURIComponent(request.recordId)}/reject`, {
+      reject: async (requestId, decision) => {
+        const route = this.getRoute("approvals");
+        const res = await this.fetch(`${this.baseUrl}${route}/requests/${encodeURIComponent(requestId)}/reject`, {
           method: "POST",
-          body: JSON.stringify({
-            reason: request.reason,
-            comment: request.comment
-          })
+          body: JSON.stringify({ actorId: decision?.actorId, comment: decision?.comment })
         });
         return this.unwrapResponse(res);
+      },
+      /**
+       * Audit trail (the immutable action log) for an approval request.
+       */
+      listActions: async (requestId) => {
+        const route = this.getRoute("approvals");
+        const res = await this.fetch(`${this.baseUrl}${route}/requests/${encodeURIComponent(requestId)}/actions`);
+        const body = await this.unwrapResponse(res);
+        return Array.isArray(body) ? body : body?.data ?? [];
       }
     };
     /**
@@ -2998,6 +3043,7 @@ var ObjectStackClient = class {
       permissions: "/api/v1/permissions",
       realtime: "/api/v1/realtime",
       workflow: "/api/v1/workflow",
+      approvals: "/api/v1/approvals",
       views: "/api/v1/ui/views",
       notifications: "/api/v1/notifications",
       ai: "/api/v1/ai",