@nodaro/sdk 2.21.1 → 2.22.0

package/dist/index.cjs

@@ -2724,10 +2724,44 @@ var CollectionsResource = class {
   async delete(id) {
     await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}`);
   }
-  /** `GET /v1/collections/:id/records` → the records, newest first. Narrow with `q` (words) and `since` (ISO); page with `cursor` / `limit` (1-100, default 50). */
+  /**
+   * `GET /v1/collections/:id/records` → the records, newest first (`order: "oldest"`
+   * flips it). Narrow with `q` (words), `since` / `until` (ISO) and `usage`
+   * (`all`, `unused` — not used yet — or `used`); page with `cursor` / `limit`
+   * (1-100, default 50). Each record carries `usedAt` / `usedBy`, and its
+   * `source` the saving workflow's name and project when it is yours.
+   */
   records(id, params = {}) {
     return this.client.request("GET", `/v1/collections/${encodeURIComponent(id)}/records`, {
-      query: { q: params.q, since: params.since, cursor: params.cursor, limit: params.limit }
+      query: {
+        q: params.q,
+        since: params.since,
+        until: params.until,
+        usage: params.usage,
+        status: params.status,
+        order: params.order,
+        cursor: params.cursor,
+        offset: params.offset,
+        limit: params.limit
+      }
+    });
+  }
+  /** `POST /v1/collections/:id/records/:recordId/restore` → bring a record back from the Trash; the record. */
+  restoreRecord(id, recordId) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/restore`);
+  }
+  /** `POST /v1/collections/:id/records/bulk` → move up to 100 records to the Trash, bring them back, or delete records already in the Trash for good, in one call. */
+  bulkRecords(id, input) {
+    return this.client.request("POST", `/v1/collections/${encodeURIComponent(id)}/records/bulk`, { body: input });
+  }
+  /**
+   * `PATCH /v1/collections/:id/records/:recordId` → mark a record used (or not
+   * used again). `source` says who is marking it (defaults to the API). A
+   * server before the usage release answers `503 not_available`.
+   */
+  setUsed(id, recordId, used, source) {
+    return this.client.request("PATCH", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`, {
+      body: { used, ...source ? { source } : {} }
     });
   }
   /**
@@ -2743,17 +2777,22 @@ var CollectionsResource = class {
       ...opts.idempotencyKey ? { headers: { "Idempotency-Key": opts.idempotencyKey } } : {}
     });
   }
-  /** `DELETE /v1/collections/:id/records/:recordId` → remove one record. */
+  /**
+   * `DELETE /v1/collections/:id/records/:recordId` → the record moves to the
+   * collection's Trash (`restoreRecord` brings it back; `deleteRecordForever`
+   * removes it for good).
+   */
   async deleteRecord(id, recordId) {
-    await this.client.request(
-      "DELETE",
-      `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`
-    );
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}`);
+  }
+  /** `DELETE /v1/collections/:id/records/:recordId/permanent` → a record already in the Trash is deleted for good (`409 not_in_trash` for a live one). */
+  async deleteRecordForever(id, recordId) {
+    await this.client.request("DELETE", `/v1/collections/${encodeURIComponent(id)}/records/${encodeURIComponent(recordId)}/permanent`);
   }
-  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since` and `q` narrow it. */
+  /** `GET /v1/collections/:id/export` → the whole collection as CSV (default) or JSON text, newest first; `since`, `until`, `usage` and `q` narrow it. */
   export(id, params = {}) {
     return this.client.requestText("GET", `/v1/collections/${encodeURIComponent(id)}/export`, {
-      query: { format: params.format, since: params.since, q: params.q }
+      query: { format: params.format, since: params.since, until: params.until, usage: params.usage, q: params.q }
     });
   }
 };
@@ -3975,7 +4014,7 @@ var EditResource = class {
     return shared.remapTranscriptThroughEdl(edl, transcript);
   }
 };
-var SDK_VERSION = "2.21.1" ;
+var SDK_VERSION = "2.22.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {