@centrali-io/centrali-sdk 2.2.0 → 2.2.2

package/README.md

@@ -97,9 +97,20 @@ await centrali.updateRecord('StructureName', 'record-id', {
   field1: 'new value'
 });
 
-// Delete a record
+// Delete a record (soft delete - can be restored)
 await centrali.deleteRecord('StructureName', 'record-id');
 
+// Hard delete a record (permanent - cannot be restored)
+await centrali.deleteRecord('StructureName', 'record-id', { hard: true });
+
+// Restore a soft-deleted record
+await centrali.restoreRecord('StructureName', 'record-id');
+
+// Query archived (soft-deleted) records
+const archived = await centrali.queryRecords('StructureName', {
+  includeArchived: true
+});
+
 // Query records
 const products = await centrali.queryRecords('Product', {
   filter: 'inStock = true AND price < 100',

package/dist/index.js

@@ -607,10 +607,16 @@ class CentraliSDK {
         const path = getRecordApiPath(this.options.workspaceId, recordSlug, id);
         return this.request('PUT', path, Object.assign({}, updates));
     }
-    /** Delete a record by ID. */
-    deleteRecord(recordSlug, id) {
+    /** Delete a record by ID (soft delete by default, can be restored). */
+    deleteRecord(recordSlug, id, options) {
         const path = getRecordApiPath(this.options.workspaceId, recordSlug, id);
-        return this.request('DELETE', path);
+        const queryParams = (options === null || options === void 0 ? void 0 : options.hard) ? { hard: 'true' } : undefined;
+        return this.request('DELETE', path, null, queryParams);
+    }
+    /** Restore a soft-deleted record by ID. */
+    restoreRecord(recordSlug, id) {
+        const path = getRecordApiPath(this.options.workspaceId, recordSlug, id) + '/restore';
+        return this.request('POST', path);
     }
     // ------------------ Storage API Methods ------------------
     /** Upload a file to the storage service. */

package/index.ts

@@ -186,6 +186,14 @@ export interface InvokeTriggerOptions {
     payload?: Record<string, any>;
 }
 
+/**
+ * Options for deleting a record.
+ */
+export interface DeleteRecordOptions {
+    /** Perform a hard delete (permanent). Default: false (soft delete) */
+    hard?: boolean;
+}
+
 /**
  * Response from invoking a trigger.
  * Currently the API returns the queued job ID as a string.
@@ -894,13 +902,24 @@ export class CentraliSDK {
         return this.request('PUT', path, {  ...updates });
     }
 
-    /** Delete a record by ID. */
+    /** Delete a record by ID (soft delete by default, can be restored). */
     public deleteRecord(
         recordSlug: string,
-        id: string
+        id: string,
+        options?: DeleteRecordOptions
     ): Promise<ApiResponse<null>> {
         const path = getRecordApiPath(this.options.workspaceId, recordSlug, id);
-        return this.request('DELETE', path);
+        const queryParams = options?.hard ? { hard: 'true' } : undefined;
+        return this.request('DELETE', path, null, queryParams);
+    }
+
+    /** Restore a soft-deleted record by ID. */
+    public restoreRecord(
+        recordSlug: string,
+        id: string
+    ): Promise<ApiResponse<null>> {
+        const path = getRecordApiPath(this.options.workspaceId, recordSlug, id) + '/restore';
+        return this.request('POST', path);
     }
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@centrali-io/centrali-sdk",
-  "version": "2.2.0",
+  "version": "2.2.2",
   "description": "Centrali Node SDK",
   "main": "dist/index.js",
   "type": "commonjs",