@sogni-ai/sogni-client 5.71.1 → 5.72.1

package/src/Account/index.ts

@@ -5,6 +5,7 @@ import {
   ClaimOptions,
   FullBalances,
   LoginData,
+  LoginOptions,
   MeData,
   Nonce,
   Reward,
@@ -459,18 +460,44 @@ class AccountApi extends ApiGroup {
    * console.log('Logged in');
    * ```
    *
+   * @example Offer to restore a deleted account at sign-in
+   * ```typescript
+   * import { ApiError, ACCOUNT_RESTORABLE_ERROR_CODE } from '@sogni-ai/sogni-client';
+   *
+   * try {
+   *   await sogni.account.login(username, password, rememberMe, appSource);
+   * } catch (error) {
+   *   if (!(error instanceof ApiError) || error.payload.errorCode !== ACCOUNT_RESTORABLE_ERROR_CODE) {
+   *     throw error;
+   *   }
+   *   const deletedAt = new Date(Number(error.details?.deletedAt) * 1000);
+   *   // Ask the person whether to restore the account deleted on `deletedAt`. If they agree,
+   *   // repeat the original arguments and add the option:
+   *   await sogni.account.login(username, password, rememberMe, appSource, {
+   *     restoreDeletedAccount: true
+   *   });
+   * }
+   * ```
+   *
    * @param username
    * @param password
    * @param rememberMe - Whether to establish a long-lived session. Default is false. Only
    * applicable for cookie-based authentication.
    * @param appSource - Optional client app/source label for login attribution. Defaults to the
    * SogniClient connection appSource when configured.
+   * @param options - Optional sign-in settings. Set `restoreDeletedAccount: true` to restore a
+   * deleted account and sign in, after the person confirms; repeat the original `rememberMe` and
+   * `appSource` on that call so the session lasts as long as first requested. A deleted account
+   * that can be restored makes `login()` throw an `ApiError` with
+   * `payload.errorCode === ACCOUNT_RESTORABLE_ERROR_CODE` (196) and `details.deletedAt` (Unix
+   * seconds).
    */
   async login(
     username: string,
     password: string,
     rememberMe = false,
-    appSource?: string
+    appSource?: string,
+    options?: LoginOptions
   ): Promise<LoginData> {
     const wallet = this.getWallet(username, password);
     const nonce = await this.getNonce(wallet.address);
@@ -483,7 +510,8 @@ class AccountApi extends ApiGroup {
       walletAddress: wallet.address,
       signature,
       ...(resolvedAppSource ? { appSource: resolvedAppSource } : {}),
-      rememberMe
+      rememberMe,
+      ...(options?.restoreDeletedAccount ? { restoreDeletedAccount: true } : {})
     });
     const auth = this.client.auth;
     if (auth instanceof TokenAuthManager) {

package/src/Account/types.ts

@@ -37,6 +37,17 @@ export interface LoginData {
   username: string;
 }
 
+/** Optional settings for `sogni.account.login()`. */
+export interface LoginOptions {
+  /**
+   * Restore the account, then sign in, when the account was deleted. Set it
+   * after the person confirms they want the account back, usually in answer to
+   * an `ACCOUNT_RESTORABLE_ERROR_CODE` error from an earlier `login()` call.
+   * It changes nothing for an account that has not been deleted.
+   */
+  restoreDeletedAccount?: boolean;
+}
+
 export interface MeData {
   currentEmail: string;
   discord2FA: boolean;

package/src/Chat/_hostedToolsManifest.generated.ts

@@ -326,6 +326,14 @@ export const SOGNI_HOSTED_TOOLS_MANIFEST: unknown = {
             "returnLastFrame": {
               "type": "boolean",
               "description": "Seedance 2.5 only. Set true to export a separate image of the final frame alongside the video. The result includes lastFrameUrl, which can be used as the first-frame image for a subsequent clip. Defaults to false; this does not extend the video automatically."
+            },
+            "referenceVideoCompression": {
+              "type": "string",
+              "enum": [
+                "none",
+                "vpack"
+              ],
+              "description": "Legacy compatibility preference for MiniMax H3 reference video. Current services select compression automatically; this field no longer selects compression. Leave it unset for new requests."
             }
           },
           "required": [

package/src/Projects/ReusableUploads.ts

@@ -40,7 +40,8 @@ class AutomaticSaveBlockedError extends Error {}
 
 /** Private subscriber uploads that can be reused across projects. */
 export default class ReusableUploads {
-  private pending = new Map<string, Promise<SavedUpload>>();
+  private pending = new Map<string, { upload: Promise<SavedUpload>; users: number }>();
+  private bindings = new Map<string, Promise<void>>();
   // Bound hashing/upload memory even when a project has many reference files.
   private lanes: Promise<unknown>[] = [Promise.resolve(), Promise.resolve()];
   private nextLane = 0;
@@ -60,6 +61,7 @@ export default class ReusableUploads {
     if (session !== this.lastSession) {
       this.lastSession = session;
       this.pending.clear();
+      this.bindings.clear();
       this.availability = undefined;
       this.automaticSaveBlockedUntil = 0;
     }
@@ -112,11 +114,24 @@ export default class ReusableUploads {
 
   async bind(id: string, binding: SavedUploadBinding): Promise<void> {
     const session = this.session;
-    await this.retryBusy(() => {
-      this.assertSession(session);
-      return this.rest.post(`/v1/assets/${encodeURIComponent(id)}/bind`, { ...binding });
-    });
-    this.assertSession(session);
+    // The server holds a per-file lock while copying. Queue only this file;
+    // unrelated files still use the two upload lanes concurrently.
+    const previous = this.bindings.get(id) ?? Promise.resolve();
+    const operation = previous
+      .catch(() => undefined)
+      .then(async () => {
+        await this.retryBusy(() => {
+          this.assertSession(session);
+          return this.rest.post(`/v1/assets/${encodeURIComponent(id)}/bind`, { ...binding });
+        });
+        this.assertSession(session);
+      });
+    this.bindings.set(id, operation);
+    try {
+      await operation;
+    } finally {
+      if (this.bindings.get(id) === operation) this.bindings.delete(id);
+    }
   }
 
   private async retryBusy<T>(operation: () => Promise<T>): Promise<T> {
@@ -139,7 +154,8 @@ export default class ReusableUploads {
     file: Blob | Buffer,
     contentType: string,
     name: string,
-    automatic: boolean
+    automatic: boolean,
+    binding?: SavedUploadBinding
   ): Promise<SavedUpload> {
     const session = this.session;
     const size = file instanceof Blob ? file.size : file.byteLength;
@@ -152,7 +168,7 @@ export default class ReusableUploads {
         })
       );
     const lane = this.nextLane++ % this.lanes.length;
-    const run = this.lanes[lane].then(async () => {
+    const prepared = this.lanes[lane].then(async () => {
       this.assertSession(session);
       // Concurrent project helpers can all pass the capability check before
       // the first quota response arrives. Recheck once this lane reaches the
@@ -166,18 +182,30 @@ export default class ReusableUploads {
         value.toString(16).padStart(2, '0')
       ).join('');
       const key = `${sha256}:${contentType}`;
-      const existing = this.pending.get(key);
-      if (existing) return existing;
-      const task = this.performUpload(file, bytes.byteLength, sha256, contentType, name, session);
-      this.pending.set(key, task);
+      let pending = this.pending.get(key);
+      if (!pending) {
+        pending = {
+          upload: this.performUpload(file, bytes.byteLength, sha256, contentType, name, session),
+          users: 0
+        };
+        this.pending.set(key, pending);
+      }
+      pending.users += 1;
+      return { pending, key };
+    });
+    // The lane bounds hashing and transfer, not the per-file server copy.
+    this.lanes[lane] = prepared.then(({ pending }) => pending.upload).catch(() => undefined);
+    return prepared.then(async ({ pending, key }) => {
       try {
-        return await task;
+        const saved = await pending.upload;
+        this.assertSession(session);
+        if (binding) await this.bind(saved.id, binding);
+        return saved;
       } finally {
-        if (this.pending.get(key) === task) this.pending.delete(key);
+        pending.users -= 1;
+        if (pending.users === 0 && this.pending.get(key) === pending) this.pending.delete(key);
       }
     });
-    this.lanes[lane] = run.catch(() => undefined);
-    return run;
   }
 
   private async performUpload(
@@ -247,16 +275,16 @@ export default class ReusableUploads {
     this.assertSession(session);
     if (!enabled) return false;
     try {
-      const saved = await this.uploadInternal(
+      await this.uploadInternal(
         file,
         contentType,
         file instanceof Blob && 'name' in file && typeof file.name === 'string'
           ? file.name
           : 'Saved upload',
-        true
+        true,
+        binding
       );
       this.assertSession(session);
-      await this.bind(saved.id, binding);
       return true;
     } catch (error) {
       this.assertSession(session);

package/src/Projects/types/index.ts

@@ -717,7 +717,10 @@ export interface VideoProjectParams extends BaseProjectParams {
    * pricing and job admission. Omit this field when duration is unavailable.
    */
   referenceVideoDurations?: number[];
-  /** Opt-in VPack compression for one-stage MiniMax H3 reference video. Omitted/none preserves the original reference tokens. */
+  /**
+   * Legacy MiniMax H3 reference-video preference, retained for compatibility.
+   * @deprecated Current services select compression automatically. Leave unset for new requests.
+   */
   referenceVideoCompression?: 'none' | 'vpack';
   /**
    * Inpaint mask IMAGE for distilled LTX 2.5 or LTX 2.3 v2v inpaint workflows.

package/src/index.ts

@@ -120,7 +120,13 @@ import {
   isProjectLostError,
   projectParamsFromRecoveredProject
 } from './Projects/recovery.js';
-import type { Balances, Reward, RewardCantClaimReason, TxHistoryEntry } from './Account/types.js';
+import type {
+  Balances,
+  LoginOptions,
+  Reward,
+  RewardCantClaimReason,
+  TxHistoryEntry
+} from './Account/types.js';
 import type {
   CreateSubscriptionCheckoutOptions,
   SubscriptionCheckoutResult,
@@ -255,6 +261,7 @@ import {
 } from './Replay/types.js';
 // Base Types
 import ErrorData, {
+  ACCOUNT_RESTORABLE_ERROR_CODE,
   MODEL_CONSENT_REQUIRED_ERROR_CODE,
   MODEL_NOT_YET_AVAILABLE_ERROR_CODE,
   SUBSCRIPTION_ERROR_CODES
@@ -418,6 +425,7 @@ export type {
   // Primitives promoted from deep paths so consumers can import from the
   // package root rather than reaching into `./dist/*`.
   Balances,
+  LoginOptions,
   Reward,
   RewardCantClaimReason,
   TxHistoryEntry,
@@ -532,6 +540,7 @@ export {
   PROJECT_LOST_ORIGINAL_CODE,
   SogniTools,
   SUBSCRIPTION_ERROR_CODES,
+  ACCOUNT_RESTORABLE_ERROR_CODE,
   MODEL_CONSENT_REQUIRED_ERROR_CODE,
   MODEL_NOT_YET_AVAILABLE_ERROR_CODE,
   isModelConsentRequiredError,

package/src/types/ErrorData.ts

@@ -98,6 +98,20 @@ export const MODEL_CONSENT_REQUIRED_ERROR_CODE = 4103;
  */
 export const MODEL_NOT_YET_AVAILABLE_ERROR_CODE = 4104;
 
+/**
+ * REST error code `sogni.account.login()` throws when the account was deleted
+ * and signing in can restore it. It arrives as an `ApiError` with HTTP status
+ * 400 and `error.payload.errorCode` set to this code. `error.details.deletedAt`
+ * is when the account was deleted, in Unix seconds.
+ *
+ * Ask the person whether to restore the account. If they agree, call `login()`
+ * again with the same arguments, including `rememberMe` and `appSource`, plus
+ * `{ restoreDeletedAccount: true }`: the account is restored and the call signs
+ * in as usual. The error's `message` is readable as is for apps that do not
+ * handle this code.
+ */
+export const ACCOUNT_RESTORABLE_ERROR_CODE = 196;
+
 /**
  * Socket error codes returned when a job explicitly submitted with
  * `billingMode: 'subscription'` cannot be covered by the subscription, plus

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.71.1';
+export const LIB_VERSION = '5.72.1';