@adobe/spacecat-shared-data-access 3.33.1 → 3.34.0

package/CHANGELOG.md

@@ -1,3 +1,9 @@
+## [@adobe/spacecat-shared-data-access-v3.34.0](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.33.1...@adobe/spacecat-shared-data-access-v3.34.0) (2026-03-31)
+
+### Features
+
+* adds revoke suggestion grants ([#1465](https://github.com/adobe/spacecat-shared/issues/1465)) ([8081661](https://github.com/adobe/spacecat-shared/commit/80816616d26a9b49b764b15d934881456f7ff656))
+
 ## [@adobe/spacecat-shared-data-access-v3.33.1](https://github.com/adobe/spacecat-shared/compare/@adobe/spacecat-shared-data-access-v3.33.0...@adobe/spacecat-shared-data-access-v3.33.1) (2026-03-31)
 
 ### Bug Fixes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe/spacecat-shared-data-access",
-  "version": "3.33.1",
+  "version": "3.34.0",
   "description": "Shared modules of the Spacecat Services - Data Access",
   "type": "module",
   "engines": {

package/src/models/suggestion-grant/suggestion-grant.collection.js

@@ -17,8 +17,9 @@ import DataAccessError from '../../errors/data-access.error.js';
 
 /**
  * SuggestionGrantCollection - Manages SuggestionGrant records (suggestion_grants table).
- * Table is insert-only; inserts happen via grant_suggestions RPC. This collection
- * provides read-only lookup by suggestion IDs.
+ * Inserts happen via the grant_suggestions RPC and deletes via the revoke_suggestion_grant
+ * RPC. This collection provides read-only lookup by suggestion IDs as well as grant and
+ * revoke operations.
  *
  * @class SuggestionGrantCollection
  * @extends BaseCollection
@@ -172,6 +173,55 @@ class SuggestionGrantCollection extends BaseCollection {
 
     return { success: true, grantedSuggestions: row.granted_suggestions };
   }
+
+  /**
+   * Invokes the revoke_suggestion_grant RPC. Deletes suggestion_grants rows for the given
+   * grant ID and decrements tokens.used by 1.
+   * RPC name and parameter shape live in this collection (suggestion_grants).
+   *
+   * @async
+   * @param {string} grantId - Grant ID to revoke.
+   * @returns {Promise<{ data: Array|null, error: object|null }>}
+   * @throws {DataAccessError} - On missing grantId.
+   */
+  async invokeRevokeSuggestionGrantRpc(grantId) {
+    if (!hasText(grantId)) {
+      throw new DataAccessError('invokeRevokeSuggestionGrantRpc: grantId is required', this);
+    }
+    return this.postgrestService.rpc('revoke_suggestion_grant', {
+      p_grant_id: grantId,
+    });
+  }
+
+  /**
+   * Revokes a suggestion grant by grant ID. Calls the revoke_suggestion_grant RPC to
+   * atomically delete suggestion_grants rows and refund the consumed token.
+   *
+   * @async
+   * @param {string} grantId - The grant ID to revoke.
+   * @returns {Promise<{ success: boolean, reason?: string, revokedCount?: number }>}
+   * @throws {DataAccessError} - On missing inputs or RPC failure.
+   */
+  async revokeSuggestionGrant(grantId) {
+    if (!hasText(grantId)) {
+      throw new DataAccessError('revokeSuggestionGrant: grantId is required', this);
+    }
+
+    const rpcResult = await this.invokeRevokeSuggestionGrantRpc(grantId);
+    const { data, error } = rpcResult;
+
+    if (error) {
+      this.log.error('revokeSuggestionGrant: RPC failed', error);
+      throw new DataAccessError('Failed to revoke suggestion grant (revoke_suggestion_grant)', this, error);
+    }
+
+    const row = Array.isArray(data) && data.length > 0 ? data[0] : null;
+    if (!row || !row.success) {
+      return { success: false, reason: row?.reason || 'rpc_no_result' };
+    }
+
+    return { success: true, revokedCount: row.revoked_count };
+  }
 }
 
 export default SuggestionGrantCollection;

package/src/models/suggestion-grant/suggestion-grant.schema.js

@@ -30,6 +30,7 @@ const schema = new SchemaBuilder(SuggestionGrant, SuggestionGrantCollection)
     type: 'string', required: false, postgrestIgnore: true,
   })
   .addIndex({ composite: ['suggestionId'] }, { composite: [] })
+  .addIndex({ composite: ['tokenId'] }, { composite: [] })
   .addAttribute('suggestionId', {
     type: 'string',
     required: true,