diffio 0.1.49 → 0.1.51

package/README.md

@@ -69,6 +69,16 @@ console.log(generation.generationId, generation.idempotentReplay ?? false);
 Reuse the same `idempotencyKey` when retrying generation creation for a project. The API then
 returns the existing generation with `idempotentReplay: true` instead of creating another generation.
 
+Generation creation automatically retries only when you supply a nonblank `idempotencyKey`, reusing
+the same key and request body for every attempt. Without a key, generation creation is attempted
+once, including on network errors, even if client or request options enable retries. Other requests
+retain their configured retry policy. Reuse your original key and request body when manually
+retrying after an uncertain response.
+
+`waitForGeneration` and `generations.waitForComplete` wait for the overall `status` to become
+`complete`. Individual stages reaching 100% or `complete` do not end polling while video publication
+or usage settlement is still pending.
+
 ## Audio isolation helper
 
 ```ts

package/dist/Client.d.ts

@@ -26,6 +26,7 @@ export declare class DiffioClient {
         requestOptions?: DiffioClient.RequestOptions;
     }): Promise<CreateProjectResponse>;
     private _uploadFile;
+    /** Retries generation admission only when the caller supplies a nonblank idempotency key. */
     createGeneration(options: {
         apiProjectId: string;
         model?: ModelKey;
@@ -46,6 +47,7 @@ export declare class DiffioClient {
         apiProjectId?: string;
         requestOptions?: DiffioClient.RequestOptions;
     }): Promise<GenerationProgressResponse>;
+    /** Waits for the authoritative overall status, including artifact publication and settlement. */
     waitForGeneration(options: {
         generationId: string;
         apiProjectId?: string;

package/dist/Client.js

@@ -138,6 +138,7 @@ class DiffioClient {
         const bodyFactory = filePath ? () => createFileReadStream(filePath) : () => data;
         await this._requestBinary(method, uploadUrl, bodyFactory, requestOptions, extraHeaders, true);
     }
+    /** Retries generation admission only when the caller supplies a nonblank idempotency key. */
     async createGeneration(options) {
         const { apiProjectId, model = "diffio-2", sampling, params, idempotencyKey, requestOptions } = options;
         const endpoint = MODEL_ENDPOINTS[model];
@@ -154,7 +155,10 @@ class DiffioClient {
         if (idempotencyKey != null) {
             payload.idempotencyKey = idempotencyKey;
         }
-        const response = await this._requestJson("POST", endpoint, payload, requestOptions);
+        const generationRequestOptions = idempotencyKey?.trim()
+            ? requestOptions
+            : { ...requestOptions, maxRetries: 0 };
+        const response = await this._requestJson("POST", endpoint, payload, generationRequestOptions);
         return (0, serialization_1.parseCreateGenerationResponse)(response);
     }
     async listProjects(options = {}) {
@@ -178,6 +182,7 @@ class DiffioClient {
         const response = await this._requestJson("POST", "get_generation_progress", payload, requestOptions);
         return (0, serialization_1.parseGenerationProgressResponse)(response);
     }
+    /** Waits for the authoritative overall status, including artifact publication and settlement. */
     async waitForGeneration(options) {
         const { generationId, apiProjectId, pollInterval = 2, timeout, timeoutInSeconds, onProgress, showProgress, requestOptions } = options;
         const timeoutSeconds = timeoutInSeconds ?? timeout ?? DEFAULT_TIMEOUT_SECONDS;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const DIFFIO_SDK_VERSION = "0.1.49";
+export declare const DIFFIO_SDK_VERSION = "0.1.51";

package/dist/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.DIFFIO_SDK_VERSION = void 0;
-exports.DIFFIO_SDK_VERSION = "0.1.49";
+exports.DIFFIO_SDK_VERSION = "0.1.51";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "diffio",
-  "version": "0.1.49",
+  "version": "0.1.51",
   "description": "Diffio API client for Node.js",
   "repository": {
     "type": "git",