@object-ui/data-objectstack 5.0.1 → 5.0.2

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @object-ui/data-objectstack
 
+## 5.0.2
+
+### Patch Changes
+
+- @object-ui/types@5.0.2
+- @object-ui/core@5.0.2
+
 ## 5.0.1
 
 ### Patch Changes

package/dist/index.cjs

@@ -2126,6 +2126,63 @@ var ObjectStackAdapter = class {
     }
     return response.json();
   }
+  /**
+   * Cancel (recall) the active pending approval request for a given record.
+   *
+   * Looks up the most recent `sys_approval_request` for the (object, record)
+   * pair whose status is `pending` or `in_approval`, then issues a POST to
+   * `/api/v1/approvals/requests/:id/recall`. The submitter is the only role
+   * permitted to recall on the server — non-submitters will receive a 403.
+   *
+   * On success, the backend mirrors `approval_status = 'recalled'` onto the
+   * source record so the lock badge disappears on next fetch.
+   */
+  async cancelPendingApproval(objectName, recordId) {
+    await this.connect();
+    const listUrl = `${this.baseUrl}/api/v1/approvals/requests?recordId=${encodeURIComponent(recordId)}&object=${encodeURIComponent(objectName)}`;
+    const listRes = await this.fetchImpl(listUrl, {
+      method: "GET",
+      headers: { "Content-Type": "application/json", ...this.getAuthHeaders() }
+    });
+    if (!listRes.ok) {
+      throw new ObjectStackError(
+        `Failed to look up approval requests (status ${listRes.status})`,
+        "APPROVAL_LOOKUP_FAILED",
+        listRes.status
+      );
+    }
+    const listBody = await listRes.json().catch(() => ({}));
+    const rows = Array.isArray(listBody) ? listBody : listBody?.data ?? [];
+    const pending = rows.find(
+      (r) => r?.status === "pending" || r?.status === "in_approval"
+    );
+    if (!pending?.id) {
+      throw new ObjectStackError(
+        "No pending approval request found for this record",
+        "NO_PENDING_REQUEST",
+        404
+      );
+    }
+    const url = `${this.baseUrl}/api/v1/approvals/requests/${encodeURIComponent(pending.id)}/recall`;
+    const response = await this.fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this.getAuthHeaders()
+      },
+      body: JSON.stringify({})
+    });
+    if (!response.ok) {
+      const err = await response.json().catch(() => ({}));
+      throw new ObjectStackError(
+        err?.error || err?.message || `Recall failed with status ${response.status}`,
+        err?.code || "APPROVAL_RECALL_FAILED",
+        response.status
+      );
+    }
+    const body = await response.json().catch(() => ({}));
+    return { requestId: pending.id, status: body?.data?.request?.status ?? "recalled" };
+  }
   /**
    * Get authorization headers from the adapter config.
    */

package/dist/index.d.cts

@@ -1104,6 +1104,21 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
         metadata?: Record<string, unknown>;
         onProgress?: (percent: number) => void;
     }): Promise<FileUploadResult[]>;
+    /**
+     * Cancel (recall) the active pending approval request for a given record.
+     *
+     * Looks up the most recent `sys_approval_request` for the (object, record)
+     * pair whose status is `pending` or `in_approval`, then issues a POST to
+     * `/api/v1/approvals/requests/:id/recall`. The submitter is the only role
+     * permitted to recall on the server — non-submitters will receive a 403.
+     *
+     * On success, the backend mirrors `approval_status = 'recalled'` onto the
+     * source record so the lock badge disappears on next fetch.
+     */
+    cancelPendingApproval(objectName: string, recordId: string): Promise<{
+        requestId: string;
+        status: string;
+    }>;
     /**
      * Get authorization headers from the adapter config.
      */

package/dist/index.d.ts

@@ -1104,6 +1104,21 @@ declare class ObjectStackAdapter<T = unknown> implements DataSource<T> {
         metadata?: Record<string, unknown>;
         onProgress?: (percent: number) => void;
     }): Promise<FileUploadResult[]>;
+    /**
+     * Cancel (recall) the active pending approval request for a given record.
+     *
+     * Looks up the most recent `sys_approval_request` for the (object, record)
+     * pair whose status is `pending` or `in_approval`, then issues a POST to
+     * `/api/v1/approvals/requests/:id/recall`. The submitter is the only role
+     * permitted to recall on the server — non-submitters will receive a 403.
+     *
+     * On success, the backend mirrors `approval_status = 'recalled'` onto the
+     * source record so the lock badge disappears on next fetch.
+     */
+    cancelPendingApproval(objectName: string, recordId: string): Promise<{
+        requestId: string;
+        status: string;
+    }>;
     /**
      * Get authorization headers from the adapter config.
      */

package/dist/index.js

@@ -2082,6 +2082,63 @@ var ObjectStackAdapter = class {
     }
     return response.json();
   }
+  /**
+   * Cancel (recall) the active pending approval request for a given record.
+   *
+   * Looks up the most recent `sys_approval_request` for the (object, record)
+   * pair whose status is `pending` or `in_approval`, then issues a POST to
+   * `/api/v1/approvals/requests/:id/recall`. The submitter is the only role
+   * permitted to recall on the server — non-submitters will receive a 403.
+   *
+   * On success, the backend mirrors `approval_status = 'recalled'` onto the
+   * source record so the lock badge disappears on next fetch.
+   */
+  async cancelPendingApproval(objectName, recordId) {
+    await this.connect();
+    const listUrl = `${this.baseUrl}/api/v1/approvals/requests?recordId=${encodeURIComponent(recordId)}&object=${encodeURIComponent(objectName)}`;
+    const listRes = await this.fetchImpl(listUrl, {
+      method: "GET",
+      headers: { "Content-Type": "application/json", ...this.getAuthHeaders() }
+    });
+    if (!listRes.ok) {
+      throw new ObjectStackError(
+        `Failed to look up approval requests (status ${listRes.status})`,
+        "APPROVAL_LOOKUP_FAILED",
+        listRes.status
+      );
+    }
+    const listBody = await listRes.json().catch(() => ({}));
+    const rows = Array.isArray(listBody) ? listBody : listBody?.data ?? [];
+    const pending = rows.find(
+      (r) => r?.status === "pending" || r?.status === "in_approval"
+    );
+    if (!pending?.id) {
+      throw new ObjectStackError(
+        "No pending approval request found for this record",
+        "NO_PENDING_REQUEST",
+        404
+      );
+    }
+    const url = `${this.baseUrl}/api/v1/approvals/requests/${encodeURIComponent(pending.id)}/recall`;
+    const response = await this.fetchImpl(url, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        ...this.getAuthHeaders()
+      },
+      body: JSON.stringify({})
+    });
+    if (!response.ok) {
+      const err = await response.json().catch(() => ({}));
+      throw new ObjectStackError(
+        err?.error || err?.message || `Recall failed with status ${response.status}`,
+        err?.code || "APPROVAL_RECALL_FAILED",
+        response.status
+      );
+    }
+    const body = await response.json().catch(() => ({}));
+    return { requestId: pending.id, status: body?.data?.request?.status ?? "recalled" };
+  }
   /**
    * Get authorization headers from the adapter config.
    */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@object-ui/data-objectstack",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "description": "ObjectStack Data Adapter for Object UI",
   "license": "MIT",
   "type": "module",
@@ -22,9 +22,9 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@objectstack/client": "^4.0.5",
-    "@object-ui/core": "5.0.1",
-    "@object-ui/types": "5.0.1"
+    "@objectstack/client": "^4.1.1",
+    "@object-ui/core": "5.0.2",
+    "@object-ui/types": "5.0.2"
   },
   "devDependencies": {
     "tsup": "^8.5.1",

package/src/index.ts

@@ -1728,6 +1728,75 @@ export class ObjectStackAdapter<T = unknown> implements DataSource<T> {
     return response.json();
   }
 
+  /**
+   * Cancel (recall) the active pending approval request for a given record.
+   *
+   * Looks up the most recent `sys_approval_request` for the (object, record)
+   * pair whose status is `pending` or `in_approval`, then issues a POST to
+   * `/api/v1/approvals/requests/:id/recall`. The submitter is the only role
+   * permitted to recall on the server — non-submitters will receive a 403.
+   *
+   * On success, the backend mirrors `approval_status = 'recalled'` onto the
+   * source record so the lock badge disappears on next fetch.
+   */
+  async cancelPendingApproval(
+    objectName: string,
+    recordId: string,
+  ): Promise<{ requestId: string; status: string }> {
+    await this.connect();
+
+    // Use the approvals service REST endpoint directly. The generic
+    // `/api/v1/data/sys_approval_request` route applies record-sharing
+    // ACLs that the approvals collection isn't always registered for,
+    // so prefer the cross-cutting `/approvals/requests` endpoint which
+    // is owned by the approvals service itself.
+    const listUrl = `${this.baseUrl}/api/v1/approvals/requests?recordId=${encodeURIComponent(recordId)}&object=${encodeURIComponent(objectName)}`;
+    const listRes = await this.fetchImpl(listUrl, {
+      method: 'GET',
+      headers: { 'Content-Type': 'application/json', ...this.getAuthHeaders() },
+    });
+    if (!listRes.ok) {
+      throw new ObjectStackError(
+        `Failed to look up approval requests (status ${listRes.status})`,
+        'APPROVAL_LOOKUP_FAILED',
+        listRes.status,
+      );
+    }
+    const listBody: any = await listRes.json().catch(() => ({}));
+    const rows: any[] = Array.isArray(listBody) ? listBody : (listBody?.data ?? []);
+    const pending = rows.find(
+      (r) => r?.status === 'pending' || r?.status === 'in_approval',
+    );
+    if (!pending?.id) {
+      throw new ObjectStackError(
+        'No pending approval request found for this record',
+        'NO_PENDING_REQUEST',
+        404,
+      );
+    }
+
+    const url = `${this.baseUrl}/api/v1/approvals/requests/${encodeURIComponent(pending.id)}/recall`;
+    const response = await this.fetchImpl(url, {
+      method: 'POST',
+      headers: {
+        'Content-Type': 'application/json',
+        ...this.getAuthHeaders(),
+      },
+      body: JSON.stringify({}),
+    });
+
+    if (!response.ok) {
+      const err: any = await response.json().catch(() => ({}));
+      throw new ObjectStackError(
+        err?.error || err?.message || `Recall failed with status ${response.status}`,
+        err?.code || 'APPROVAL_RECALL_FAILED',
+        response.status,
+      );
+    }
+    const body: any = await response.json().catch(() => ({}));
+    return { requestId: pending.id, status: body?.data?.request?.status ?? 'recalled' };
+  }
+
   /**
    * Get authorization headers from the adapter config.
    */