@nodaro/sdk 1.26.0 → 1.28.0

package/dist/index.cjs

@@ -70,6 +70,12 @@ var WorkflowConflictError = class extends NodaroError {
   currentVersion;
   currentRecord;
 };
+var JobBlockedError = class extends NodaroError {
+  constructor(message = "Blocked by this deployment's content policy") {
+    super(message, "job_blocked", 422);
+    this.name = "JobBlockedError";
+  }
+};
 var JobFailedError = class extends NodaroError {
   constructor(message, jobId, jobStatus = "failed") {
     super(message, "job_failed", 0);
@@ -98,6 +104,14 @@ var JobAbortedError = class extends NodaroError {
   }
   jobId;
 };
+var JobHeldError = class extends NodaroError {
+  constructor(message, jobId) {
+    super(message, "job_held", 0);
+    this.jobId = jobId;
+    this.name = "JobHeldError";
+  }
+  jobId;
+};
 function throwFromResponse(status, body) {
   const code = body.error?.code ?? "internal_error";
   const message = body.error?.message ?? "Request failed";
@@ -110,6 +124,7 @@ function throwFromResponse(status, body) {
       body.error?.currentRecord
     );
   }
+  if (status === 422 && code === "job_blocked") throw new JobBlockedError(message);
   if (status === 403 && code === "insufficient_scope") {
     throw new ForbiddenError(message, body.error?.missingScope);
   }
@@ -361,6 +376,18 @@ var JobsResource = class {
       `/v1/jobs/${encodeURIComponent(id)}/cancel`
     );
   }
+  /**
+   * Delete a job and the private media it produced. Server route is
+   * `DELETE /v1/jobs/:jobId`. Only the job's owner (or an admin) may delete it;
+   * a job that is still running is deleted as-is — cancel it first when its
+   * worker should stop ({@link cancel}).
+   */
+  delete(id) {
+    return this.client.request(
+      "DELETE",
+      `/v1/jobs/${encodeURIComponent(id)}`
+    );
+  }
 };
 
 // src/resources/video-pro.ts
@@ -479,8 +506,9 @@ var NodesResource = class {
    * the candidate-grid path (generate N stills/clips in parallel). Each runs
    * via {@link runAndWait}; resolves once ALL settle, to an array of
    * `{ jobId, output }` in input order. Rejects (and the rejection wins) if any
-   * single run rejects — same typed errors as {@link runAndWait}. A shared
-   * `signal` aborts the whole batch.
+   * single run rejects — same typed errors as {@link runAndWait}, including
+   * {@link JobHeldError} when one candidate is held for review while the
+   * others complete. A shared `signal` aborts the whole batch.
    *
    * @param type        Node type slug, applied to every entry.
    * @param paramsList  One request body per candidate.
@@ -498,7 +526,10 @@ var NodesResource = class {
       })
     );
   }
-  /** Poll an already-kicked job id until terminal; resolve output_data or throw. */
+  /** Poll an already-kicked job id until it stops moving; resolve output_data
+   *  or throw. Two non-terminal statuses end the loop: an abort, and
+   *  `pending_review` (a job policy held the output for a human — see
+   *  {@link JobHeldError}). */
   async pollJob(jobId, label, opts) {
     const pollMs = opts.pollMs ?? DEFAULT_POLL_MS;
     const maxMs = opts.maxMs ?? DEFAULT_MAX_MS;
@@ -517,6 +548,9 @@ var NodesResource = class {
           data.status
         );
       }
+      if (data.status === "pending_review") {
+        throw new JobHeldError(`${label} is awaiting review`, jobId);
+      }
       if (Date.now() > deadline) {
         throw new JobTimeoutError(`${label} timed out`, jobId, maxMs);
       }
@@ -2718,7 +2752,7 @@ var WorkspacesResource = class {
     return this.client.requestText("GET", `/v1/workspaces/${encodeURIComponent(id)}/usage`, { query: { ...opts, format: "csv" } });
   }
 };
-var SDK_VERSION = "1.26.0" ;
+var SDK_VERSION = "1.28.0" ;
 var CLIENT_HEADER = "X-Nodaro-Client";
 var isBrowser = () => typeof window !== "undefined" && typeof window.document !== "undefined";
 var NodaroClient = class _NodaroClient {
@@ -3064,7 +3098,9 @@ exports.ExecutionsResource = ExecutionsResource;
 exports.ForbiddenError = ForbiddenError;
 exports.InsufficientCreditsError = InsufficientCreditsError;
 exports.JobAbortedError = JobAbortedError;
+exports.JobBlockedError = JobBlockedError;
 exports.JobFailedError = JobFailedError;
+exports.JobHeldError = JobHeldError;
 exports.JobTimeoutError = JobTimeoutError;
 exports.JobsResource = JobsResource;
 exports.LibraryResource = LibraryResource;