@sogni-ai/sogni-client 5.60.0 → 5.60.2

package/src/Projects/index.ts

@@ -1104,6 +1104,9 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
         message: data.error_message
       };
     }
+    if (data.vendorFailureCategory) {
+      error.vendorFailureCategory = data.vendorFailureCategory;
+    }
     if (data.subscriptionLimit) {
       error.subscriptionLimit = true;
       if (data.requiredPlans) error.requiredPlans = data.requiredPlans;
@@ -2566,6 +2569,10 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
    * A project that belongs to another account, or does not exist, rejects with a
    * 404 `ApiError`; a 503 means the server could not determine the state yet and
    * the call can be retried.
+   *
+   * A one-off read, not a way to wait: a tracked project settles over the
+   * socket (`project.waitForCompletion()`), and polling this spends the
+   * account's per-IP rate limit. On a 429 wait `ApiError.retryAfter` seconds.
    * @param projectId
    */
   async getStatus(projectId: string): Promise<ProjectStatusSnapshot> {
@@ -2587,6 +2594,14 @@ class ProjectsApi extends ApiGroup<ProjectApiEvents> {
    * waiting for a worker. Needs an authenticated client; another account's or
    * an unknown project rejects with a 404 `ApiError`.
    *
+   * Not for waiting on a project: never call it in a loop until it finishes.
+   * A tracked project settles over the socket (`project.waitForCompletion()`
+   * and its events) with no requests; after a restart, connect with the same
+   * `appId` and `projects.sync()` hands its projects back (`resolveMissing()`
+   * covers ids it no longer holds). Each call is a REST request against the
+   * account's per-IP rate limit, plus one signed-URL request per completed
+   * job. A 429 `ApiError` carries `retryAfter` (seconds): wait that long.
+   *
    * @example
    * ```ts
    * const result = await sogni.projects.getResult(projectId);

package/src/types/ErrorData.ts

@@ -4,6 +4,14 @@ interface ErrorData {
   code: number;
   originalCode?: string;
   message: string;
+  /** Coarse server-reported cause of an external generation failure. */
+  vendorFailureCategory?:
+    | 'content_policy'
+    | 'input_validation'
+    | 'timeout'
+    | 'result_storage'
+    | 'cancelled'
+    | 'vendor_failed';
   /**
    * Discriminator set to `true` when this render-path error is a subscription
    * FEATURE-gate denial (socket error code 4081). The four fields below are

package/src/version.ts

@@ -1,3 +1,3 @@
 // AUTO-GENERATED by scripts/generate-version.mjs — do not edit.
 // Source of truth: package.json version.
-export const LIB_VERSION = '5.60.0';
+export const LIB_VERSION = '5.60.2';