@objectstack/client 7.5.0 → 7.7.0

package/dist/index.mjs

@@ -2149,34 +2149,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 ?? [];
       }
     };
     /**
@@ -2968,6 +3013,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",