diffio 0.1.42 → 0.1.43

package/README.md

@@ -59,12 +59,16 @@ const project = await client.createProject({
 const generation = await client.createGeneration({
   apiProjectId: project.apiProjectId,
   model: "diffio-3.5",
-  sampling: { steps: 12, guidance: 1.5 }
+  sampling: { steps: 12, guidance: 1.5 },
+  idempotencyKey: "restore-sample-001"
 });
 
-console.log(generation.generationId);
+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.
+
 ## Audio isolation helper
 
 ```ts
@@ -74,12 +78,16 @@ const client = new DiffioClient({ apiKey: "diffio_live_..." });
 const result = await client.audioIsolation.isolate({
   filePath: "sample.wav",
   model: "diffio-3.5",
-  sampling: { steps: 12, guidance: 1.5 }
+  sampling: { steps: 12, guidance: 1.5 },
+  idempotencyKey: "restore-sample-001"
 });
 
 console.log(result.generation.generationId);
 ```
 
+The isolation helpers create a new project before creating its generation. Their `idempotencyKey`
+protects retries of that generation request; it does not deduplicate a separate helper call or upload.
+
 ## Restore audio in one call
 
 This helper runs the full flow and returns the downloaded bytes plus a metadata object.
@@ -93,6 +101,7 @@ const [audioBytes, info] = await client.restoreAudio({
   filePath: "sample.wav",
   model: "diffio-3.5",
   sampling: { steps: 12, guidance: 1.5 },
+  idempotencyKey: "restore-sample-001",
   onProgress: (progress) => console.log(progress.status)
 });
 

package/dist/Client.d.ts

@@ -1,5 +1,5 @@
 import type { BaseClientOptions, BaseRequestOptions, NormalizedClientOptions } from "./BaseClient";
-import type { AccountSettingsResponse, ApiKeyResponse, ApiKeysListResponse, AudioIsolationResult, CreateGenerationResponse, CreateProjectResponse, GenerationDownloadResponse, GenerationProgressResponse, ListProjectGenerationsResponse, ListProjectsResponse, RestoreMetadata, UsageSummaryResponse, WebhookConfigureResponse, WebhookTestEventResponse } from "./api/types";
+import type { AccountSettingsResponse, ApiKeyResponse, ApiKeysListResponse, AudioIsolationResult, CreateGenerationResponse, CreateProjectResponse, GenerationDownloadResponse, GenerationProgressResponse, ListProjectGenerationsResponse, ListProjectsResponse, ModelKey, RestoreMetadata, UsageSummaryResponse, WebhookConfigureResponse, WebhookTestEventResponse } from "./api/types";
 import { AccountClient, ApiKeysClient, AudioIsolationClient, GenerationsClient, ProjectsClient, UsageClient, WebhooksClient } from "./api/resources";
 export declare namespace DiffioClient {
     type Options = BaseClientOptions;
@@ -28,9 +28,10 @@ export declare class DiffioClient {
     private _uploadFile;
     createGeneration(options: {
         apiProjectId: string;
-        model?: string;
+        model?: ModelKey;
         sampling?: Record<string, unknown>;
         params?: Record<string, unknown>;
+        idempotencyKey?: string;
         requestOptions?: DiffioClient.RequestOptions;
     }): Promise<CreateGenerationResponse>;
     listProjects(options?: {
@@ -108,10 +109,11 @@ export declare class DiffioClient {
         contentType?: string;
         contentLength?: number;
         fileFormat?: string;
-        model?: string;
+        model?: ModelKey;
         sampling?: Record<string, unknown>;
         projectParams?: Record<string, unknown>;
         generationParams?: Record<string, unknown>;
+        idempotencyKey?: string;
         downloadType?: string;
         pollInterval?: number;
         timeout?: number;
@@ -129,10 +131,11 @@ export declare class DiffioClient {
         contentType?: string;
         contentLength?: number;
         fileFormat?: string;
-        model?: string;
+        model?: ModelKey;
         sampling?: Record<string, unknown>;
         projectParams?: Record<string, unknown>;
         generationParams?: Record<string, unknown>;
+        idempotencyKey?: string;
         requestOptions?: DiffioClient.RequestOptions;
     }): Promise<AudioIsolationResult>;
     private _downloadBinary;

package/dist/Client.js

@@ -48,7 +48,6 @@ const API_PREFIX = "v1";
 const MODEL_ENDPOINTS = {
     "diffio-2": "diffio-2.0-generation",
     "diffio-2-flash": "diffio-2.0-flash-generation",
-    "diffio-3": "diffio-3.0-generation",
     "diffio-3.4": "diffio-3.4-generation",
     "diffio-3.5": "diffio-3.5-generation"
 };
@@ -136,11 +135,11 @@ class DiffioClient {
         if (isStorageEmulatorUrl(uploadUrl)) {
             extraHeaders.Authorization = "Bearer owner";
         }
-        const body = filePath ? await createFileReadStream(filePath) : data;
-        await this._requestBinary(method, uploadUrl, body, requestOptions, extraHeaders, true);
+        const bodyFactory = filePath ? () => createFileReadStream(filePath) : () => data;
+        await this._requestBinary(method, uploadUrl, bodyFactory, requestOptions, extraHeaders, true);
     }
     async createGeneration(options) {
-        const { apiProjectId, model = "diffio-2", sampling, params, requestOptions } = options;
+        const { apiProjectId, model = "diffio-2", sampling, params, idempotencyKey, requestOptions } = options;
         const endpoint = MODEL_ENDPOINTS[model];
         if (!endpoint) {
             throw new errors_1.DiffioApiError(`Unsupported model: ${model}`);
@@ -152,6 +151,9 @@ class DiffioClient {
         if (params) {
             payload.params = params;
         }
+        if (idempotencyKey != null) {
+            payload.idempotencyKey = idempotencyKey;
+        }
         const response = await this._requestJson("POST", endpoint, payload, requestOptions);
         return (0, serialization_1.parseCreateGenerationResponse)(response);
     }
@@ -318,6 +320,7 @@ class DiffioClient {
                 sampling: options.sampling,
                 projectParams: options.projectParams,
                 generationParams: options.generationParams,
+                idempotencyKey: options.idempotencyKey,
                 requestOptions: options.requestOptions
             });
         }
@@ -434,6 +437,7 @@ class DiffioClient {
             model: options.model,
             sampling: options.sampling,
             params: options.generationParams,
+            idempotencyKey: options.idempotencyKey,
             requestOptions: options.requestOptions
         });
         return (0, serialization_1.createAudioIsolationResult)(project, generation);
@@ -443,7 +447,7 @@ class DiffioClient {
         if (isStorageEmulatorUrl(downloadUrl)) {
             extraHeaders.Authorization = "Bearer owner";
         }
-        const response = await this._requestBinary("GET", downloadUrl, undefined, requestOptions, extraHeaders, true);
+        const response = await this._requestBinary("GET", downloadUrl, () => undefined, requestOptions, extraHeaders, true);
         return response;
     }
     async _requestJson(method, path, payload, requestOptions) {
@@ -459,18 +463,26 @@ class DiffioClient {
         const response = await (0, retry_1.requestWithRetries)(makeRequest, { maxRetries, retryBackoff, retryStatusCodes });
         return parseJsonResponse(response);
     }
-    async _requestBinary(method, urlOrPath, body, requestOptions, extraHeaders, isAbsoluteUrl = false) {
+    async _requestBinary(method, urlOrPath, bodyFactory, requestOptions, extraHeaders, isAbsoluteUrl = false) {
         const { url, headers, timeoutMs, maxRetries, retryBackoff, retryStatusCodes, fetchFn, abortSignal } = await this._buildRequest(method, urlOrPath, requestOptions, extraHeaders, isAbsoluteUrl);
-        const requestInit = {
-            method,
-            headers,
-            body: body,
-            signal: abortSignal
+        const makeRequest = async () => {
+            const body = await bodyFactory();
+            const requestInit = {
+                method,
+                headers,
+                body: body,
+                signal: abortSignal
+            };
+            if (body && isNodeReadable(body)) {
+                requestInit.duplex = "half";
+            }
+            try {
+                return await fetchWithTimeout(fetchFn, url, requestInit, timeoutMs, abortSignal);
+            }
+            finally {
+                destroyNodeReadable(body);
+            }
         };
-        if (body && isNodeReadable(body)) {
-            requestInit.duplex = "half";
-        }
-        const makeRequest = () => fetchWithTimeout(fetchFn, url, requestInit, timeoutMs, abortSignal);
         const response = await (0, retry_1.requestWithRetries)(makeRequest, { maxRetries, retryBackoff, retryStatusCodes });
         if (method === "GET") {
             return parseBinaryResponse(response);
@@ -671,6 +683,14 @@ function isStorageEmulatorUrl(url) {
 function isNodeReadable(value) {
     return Boolean(value) && typeof value === "object" && typeof value.pipe === "function";
 }
+function destroyNodeReadable(value) {
+    const destroy = isNodeReadable(value)
+        ? value.destroy
+        : undefined;
+    if (destroy) {
+        destroy.call(value);
+    }
+}
 async function createFileReadStream(filePath) {
     const fs = await Promise.resolve().then(() => __importStar(require("node:fs")));
     const stream = fs.createReadStream(filePath);

package/dist/api/resources/audioIsolation/client/Client.d.ts

@@ -1,14 +1,15 @@
 import type { DiffioClient } from "../../../../Client";
-import type { AudioIsolationResult, RestoreMetadata } from "../../../types";
+import type { AudioIsolationResult, ModelKey, RestoreMetadata } from "../../../types";
 export interface AudioIsolationRestoreOptions {
     filePath: string;
     contentType?: string;
     contentLength?: number;
     fileFormat?: string;
-    model?: string;
+    model?: ModelKey;
     sampling?: Record<string, unknown>;
     projectParams?: Record<string, unknown>;
     generationParams?: Record<string, unknown>;
+    idempotencyKey?: string;
     downloadType?: string;
     pollInterval?: number;
     timeout?: number;
@@ -25,10 +26,11 @@ export interface AudioIsolationIsolateOptions {
     contentType?: string;
     contentLength?: number;
     fileFormat?: string;
-    model?: string;
+    model?: ModelKey;
     sampling?: Record<string, unknown>;
     projectParams?: Record<string, unknown>;
     generationParams?: Record<string, unknown>;
+    idempotencyKey?: string;
     requestOptions?: DiffioClient.RequestOptions;
 }
 export declare class AudioIsolationClient {

package/dist/api/resources/audioIsolation/client/Client.js

@@ -9,7 +9,7 @@ class AudioIsolationClient {
         return this.isolate(options);
     }
     async isolate(options) {
-        const { filePath, contentType, contentLength, fileFormat, model, sampling, projectParams, generationParams, requestOptions } = options;
+        const { filePath, contentType, contentLength, fileFormat, model, sampling, projectParams, generationParams, idempotencyKey, requestOptions } = options;
         return this._parent.audioIsolationIsolate({
             filePath,
             contentType,
@@ -19,6 +19,7 @@ class AudioIsolationClient {
             sampling,
             projectParams,
             generationParams,
+            idempotencyKey,
             requestOptions
         });
     }

package/dist/api/resources/generations/client/Client.d.ts

@@ -1,10 +1,11 @@
 import type { DiffioClient } from "../../../../Client";
-import type { CreateGenerationResponse, GenerationDownloadResponse, GenerationProgressResponse } from "../../../types";
+import type { CreateGenerationResponse, GenerationDownloadResponse, GenerationProgressResponse, ModelKey } from "../../../types";
 export interface GenerationCreateOptions {
     apiProjectId: string;
-    model?: string;
+    model?: ModelKey;
     sampling?: Record<string, unknown>;
     params?: Record<string, unknown>;
+    idempotencyKey?: string;
     requestOptions?: DiffioClient.RequestOptions;
 }
 export interface GenerationProgressOptions {

package/dist/api/serialization.js

@@ -48,7 +48,10 @@ function parseCreateGenerationResponse(data) {
         generationId: data.generationId,
         apiProjectId: data.apiProjectId,
         modelKey: data.modelKey,
-        status: data.status
+        status: data.status,
+        ...(data.idempotentReplay == null
+            ? {}
+            : { idempotentReplay: Boolean(data.idempotentReplay) })
     };
 }
 function parseProjectGenerationSummary(data) {

package/dist/api/types.d.ts

@@ -1,4 +1,4 @@
-export type ModelKey = "diffio-2" | "diffio-2-flash" | "diffio-3" | "diffio-3.4" | "diffio-3.5";
+export type ModelKey = "diffio-2" | "diffio-2-flash" | "diffio-3.4" | "diffio-3.5";
 export type DownloadType = "audio" | "video" | "transcript";
 export type WebhookMode = "test" | "live";
 export type WebhookEventType = "generation.queued" | "generation.processing" | "generation.failed" | "generation.completed";
@@ -29,6 +29,7 @@ export interface CreateGenerationResponse {
     apiProjectId: string;
     modelKey: ModelKey | string;
     status: string;
+    idempotentReplay?: boolean;
 }
 export interface ProjectGenerationSummary {
     generationId: string;

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const DIFFIO_SDK_VERSION = "0.1.42";
+export declare const DIFFIO_SDK_VERSION = "0.1.43";

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.42";
+exports.DIFFIO_SDK_VERSION = "0.1.43";

package/package.json

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