@sogni-ai/sogni-client 5.52.1 → 5.53.1

package/CHANGELOG.md

@@ -1,3 +1,17 @@
+## [5.53.1](https://github.com/Sogni-AI/sogni-client/compare/v5.53.0...v5.53.1) (2026-09-19)
+
+
+### Bug Fixes
+
+* **projects:** resend requests lost to a socket drop instead of failing them ([0d9fbee](https://github.com/Sogni-AI/sogni-client/commit/0d9fbee8b48aa3a73e18420d52691ac109806c4f))
+
+# [5.53.0](https://github.com/Sogni-AI/sogni-client/compare/v5.52.1...v5.53.0) (2026-09-19)
+
+
+### Features
+
+* **projects:** return the daily fair-use share on cost estimates ([62594b1](https://github.com/Sogni-AI/sogni-client/commit/62594b1c67021015a69711081a2e668dee9514e7))
+
 ## [5.52.1](https://github.com/Sogni-AI/sogni-client/compare/v5.52.0...v5.52.1) (2026-09-18)
 
 

package/README.md

@@ -1008,7 +1008,7 @@ When creating video projects, you can specify:
 - `seedanceTaskType` - Seedance 2.5 loose-reference operation: `reference`, `edit`, or `extend`. Edit and extend require a reference video.
 - `hasVideoInput` - Estimate-only flag for `estimateVideoCost`; set this when estimating a canonical Seedance video-input job without passing `referenceVideo`/`referenceVideoUrls`
 - `referenceImageCount` - Optional estimate-only count of image references the video job will submit; models whose pricing does not use it ignore it
-- `referenceVideoCount` / `referenceVideoDurationSeconds` - Estimate-only MiniMax H3 r2v input metadata; reference-video seconds use the full resolution-tier input rate ($0.05/s at 480p or $0.08/s at 544/768p), even with Turbo output
+- `referenceVideoCount` / `referenceVideoDurationSeconds` - Estimate-only MiniMax H3 r2v input metadata; reference-video seconds use the full resolution-tier input rate ($0.05/s at 480p or $0.08/s at 544/768p), even with Turbo output. On the two-stage Reference ids, reference video with 2K output is $0.13/s
 - MiniMax H3 two-stage quotes (FastH3 and Ref2VA alike): call `estimateVideoCost` with the `_2stage` model id and the canvas the job renders (`672`×`384` for 720p, `960`×`544` for 1080p, `1344`×`768` for 2K). Two-stage output is a model id, not a request option; passing the retired `outputScale` throws before any request
 
 Seedance 2.0 can combine image, video, and audio reference assets in one external API request. Reference limits are up to 9 image assets, 3 video assets, 3 audio assets, and 12 asset files total. Text+audio without at least one image or video reference is not supported by Seedance. URL-array references must be HTTPS URLs that the vendor can fetch; local multi-reference files should be uploaded first, as shown in `examples/workflow_partner_seedance_video.mjs`. In prompts and creative briefs, refer to attachments by Seedance-style tags: `@Image1`, `@Video1`, and `@Audio1`, counted independently by modality in attachment order. Assign each useful reference a role, such as product identity, motion timing, camera path, edit rhythm, background music, or speech reference. Prefer positive preservation language like "maintain the same product silhouette and logo placement from @Image1"; exact readable text, logos, lip-sync, voice cloning, and real-human-reference behavior still need review. Seedance dispatch omits negative prompts; Wan 2.2 and LTX 2.3 video models can still use `negativePrompt`. Seedance jobs are Spark-only and should not use SOGNI token fallback.

package/dist/Projects/index.d.ts

@@ -87,6 +87,14 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     private _awaitingResubmit;
     /** When each resubmitted project was last sent, for the recently-created grace. */
     private _resubmittedAt;
+    /** Bumped on every transport loss; tells a frame sent before a drop from one sent after. */
+    private _transportGeneration;
+    /**
+     * The transport generation each request was written on, for requests whose
+     * send completed. A request written on a connection that has since dropped
+     * and that the server never saw died with that connection.
+     */
+    private _sentOnGeneration;
     /**
      * Renders the server announced it moved to another worker (`jobRetry`), still
      * waiting for that worker's first frame. Only consulted when a frame arrives
@@ -278,6 +286,16 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
         attempts?: number;
         delayMs?: number;
     }): Promise<Record<string, ProjectResolution>>;
+    /**
+     * Send a request again, once, when it was written on a connection that then
+     * dropped and no server frame, snapshot or lookup has ever mentioned it. A
+     * frame written into a dead socket can never arrive later, so this cannot run
+     * the generation twice. Requests whose delivery is merely uncertain (a
+     * missing cross-tab ACK) never qualify: the primary tab may still send them.
+     */
+    private _resendUndelivered;
+    /** Resubmitted within the recently-created grace: the server may not list it yet. */
+    private _recentlyResubmitted;
     /**
      * Second opinion for a project neither the terminal REST record nor the live
      * socket list knows. Returns `undefined` when the lookup cannot vouch for it.
@@ -408,7 +426,7 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
     /**
      * Estimate image project cost
      */
-    estimateCost({ network, tokenType, model, imageCount, stepCount, previewCount, cnEnabled, startingImageStrength, width, height, sizePreset, guidance, sampler, contextImages, gptImageQuality, outputFormat }: EstimateRequest): Promise<CostEstimation>;
+    estimateCost({ network, tokenType, model, imageCount, stepCount, previewCount, cnEnabled, startingImageStrength, width, height, sizePreset, guidance, sampler, contextImages, gptImageQuality, outputFormat, billingMode }: EstimateRequest): Promise<CostEstimation>;
     /**
      * Estimate image enhancement cost
      * @param strength
@@ -443,6 +461,7 @@ declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
         sogni: string;
         estimatedRenderSeconds: number | undefined;
         estimatedTotalSeconds: number | undefined;
+        dailyFairUsePct: number | undefined;
     }>;
     /**
      * Estimate the cost of an audio generation job.

package/dist/Projects/index.js

@@ -375,6 +375,14 @@ class ProjectsApi extends ApiGroup_js_1.default {
         this._awaitingResubmit = new Set();
         /** When each resubmitted project was last sent, for the recently-created grace. */
         this._resubmittedAt = new Map();
+        /** Bumped on every transport loss; tells a frame sent before a drop from one sent after. */
+        this._transportGeneration = 0;
+        /**
+         * The transport generation each request was written on, for requests whose
+         * send completed. A request written on a connection that has since dropped
+         * and that the server never saw died with that connection.
+         */
+        this._sentOnGeneration = new Map();
         /**
          * Renders the server announced it moved to another worker (`jobRetry`), still
          * waiting for that worker's first frame. Only consulted when a frame arrives
@@ -784,6 +792,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
         if (project.finished) {
             this._unadmittedRequests.delete(project.id);
             this._resubmittedAt.delete(project.id);
+            this._sentOnGeneration.delete(project.id);
             // Sync project data with the server and remove it from the list after some time
             project._syncToServer().catch((e) => {
                 // 404 errors are expected when project is still initializing
@@ -937,6 +946,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
     }
     handleTransportLost() {
         this.transportDisconnected = true;
+        this._transportGeneration++;
         this._clearAuthenticatedTimer();
         // A transport gap is not a project failure. The server keeps rendering and
         // hands the project back on reconnect (same app-id), so keep the tracked
@@ -1126,7 +1136,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
      */
     resolveMissing(projectIds_1) {
         return __awaiter(this, arguments, void 0, function* (projectIds, options = {}) {
-            var _a, _b, _c;
+            var _a, _b;
             const attempts = Math.max(1, (_a = options.attempts) !== null && _a !== void 0 ? _a : this._recoveryTuning.missingProjectAttempts);
             const delayMs = (_b = options.delayMs) !== null && _b !== void 0 ? _b : this._recoveryTuning.missingProjectRetryMs;
             const result = {};
@@ -1165,14 +1175,72 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 const unlisted = pending.filter((id) => !(live === null || live === void 0 ? void 0 : live.includes(id)));
                 const checks = new Map(yield Promise.all(unlisted.map((id) => __awaiter(this, void 0, void 0, function* () { return [id, yield this._lookupUnlistedProject(id)]; }))));
                 for (const id of pending) {
-                    result[id] = (live === null || live === void 0 ? void 0 : live.includes(id))
-                        ? { state: 'active' }
-                        : ((_c = checks.get(id)) !== null && _c !== void 0 ? _c : { state: 'lost' });
+                    if (live === null || live === void 0 ? void 0 : live.includes(id)) {
+                        result[id] = { state: 'active' };
+                        continue;
+                    }
+                    const check = checks.get(id);
+                    if (check) {
+                        result[id] = check;
+                        continue;
+                    }
+                    // Nothing on the server knows it. A request that died with a dropped
+                    // connection is sent again; one just (re)sent is still being admitted.
+                    result[id] =
+                        (yield this._resendUndelivered(id)) || this._recentlyResubmitted(id)
+                            ? { state: 'active' }
+                            : { state: 'lost' };
                 }
             }
             return result;
         });
     }
+    /**
+     * Send a request again, once, when it was written on a connection that then
+     * dropped and no server frame, snapshot or lookup has ever mentioned it. A
+     * frame written into a dead socket can never arrive later, so this cannot run
+     * the generation twice. Requests whose delivery is merely uncertain (a
+     * missing cross-tab ACK) never qualify: the primary tab may still send them.
+     */
+    _resendUndelivered(projectId) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const request = this._unadmittedRequests.get(projectId);
+            const sentOn = this._sentOnGeneration.get(projectId);
+            const project = this.projects.find((p) => p.id === projectId);
+            if (!request ||
+                sentOn === undefined ||
+                sentOn >= this._transportGeneration ||
+                this.transportDisconnected ||
+                this._resubmittedAt.has(projectId) ||
+                this._awaitingResubmit.has(projectId) ||
+                (project && project.finished)) {
+                return false;
+            }
+            // Claimed before the await so a concurrent lookup cannot send it twice.
+            this._resubmittedAt.set(projectId, Date.now());
+            this._sentOnGeneration.delete(projectId);
+            this.client.logger.info(`Project ${projectId} was sent on a connection that dropped before the server received it; resubmitting`);
+            try {
+                yield this.client.socket.send('jobRequest', request);
+            }
+            catch (error) {
+                if (!(error instanceof requestDelivery_js_1.MessageDeliveryUncertainError)) {
+                    this.client.logger.warn(`Resubmitting project ${projectId} failed`, error);
+                    return false;
+                }
+            }
+            this._resubmittedAt.set(projectId, Date.now());
+            this._sentOnGeneration.set(projectId, this._transportGeneration);
+            project === null || project === void 0 ? void 0 : project._keepAlive();
+            this._scheduleRecheck(this._recoveryTuning.recentlyCreatedGraceMs);
+            return true;
+        });
+    }
+    /** Resubmitted within the recently-created grace: the server may not list it yet. */
+    _recentlyResubmitted(projectId) {
+        const at = this._resubmittedAt.get(projectId);
+        return at !== undefined && Date.now() - at < this._recoveryTuning.recentlyCreatedGraceMs;
+    }
     /**
      * Second opinion for a project neither the terminal REST record nor the live
      * socket list knows. Returns `undefined` when the lookup cannot vouch for it.
@@ -1551,6 +1619,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 // Recorded before sending: a refusal can arrive as soon as the frame lands.
                 this._unadmittedRequests.set(project.id, request);
                 yield this.client.socket.send('jobRequest', request);
+                this._sentOnGeneration.set(project.id, this._transportGeneration);
                 return this._trackSubmitted(project);
             }
             catch (error) {
@@ -1581,6 +1650,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
             return project;
         }
         this._unadmittedRequests.delete(project.id);
+        this._sentOnGeneration.delete(project.id);
         project._dispose();
         return tracked;
     }
@@ -2153,8 +2223,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
      * Estimate image project cost
      */
     estimateCost(_a) {
-        return __awaiter(this, arguments, void 0, function* ({ network = 'fast', tokenType, model, imageCount, stepCount, previewCount, cnEnabled, startingImageStrength, width, height, sizePreset, guidance, sampler, contextImages, gptImageQuality, outputFormat }) {
-            var _b, _c;
+        return __awaiter(this, arguments, void 0, function* ({ network = 'fast', tokenType, model, imageCount, stepCount, previewCount, cnEnabled, startingImageStrength, width, height, sizePreset, guidance, sampler, contextImages, gptImageQuality, outputFormat, billingMode }) {
+            var _b, _c, _d;
             let apiVersion = 2;
             const modelOptions = yield this.getModelOptions(model);
             const pathParams = [
@@ -2192,6 +2262,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 queryParams.set('gptImageQuality', gptImageQuality);
             if (outputFormat)
                 queryParams.set('outputFormat', outputFormat);
+            if (billingMode)
+                queryParams.set('billingMode', billingMode);
             const query = queryParams.toString();
             const r = yield this.client.socket.get(`/api/v${apiVersion}/job/estimate/${pathParams.join('/')}${query ? `?${query}` : ''}`);
             return {
@@ -2200,7 +2272,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 spark: r.quote.project.costInSpark,
                 sogni: r.quote.project.costInSogni,
                 estimatedRenderSeconds: (_b = r.benchmark) === null || _b === void 0 ? void 0 : _b.estimatedRenderTimeSec,
-                estimatedTotalSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedTotalTimeSec
+                estimatedTotalSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedTotalTimeSec,
+                dailyFairUsePct: (_d = r.dailyFairUse) === null || _d === void 0 ? void 0 : _d.pct
             };
         });
     }
@@ -2246,7 +2319,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
      */
     estimateVideoCost(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b, _c;
+            var _a, _b, _c, _d, _e;
             (0, createJobRequestMessage_js_1.rejectRetiredOutputScale)(params);
             const frames = params.frames
                 ? params.frames
@@ -2292,6 +2365,12 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 params.referenceVideoDurationSeconds >= 0) {
                 query.set('referenceVideoDurationSeconds', String(params.referenceVideoDurationSeconds));
             }
+            // Unpinned, the job renders on the connection's network, so quote that one.
+            const network = (_b = params.network) !== null && _b !== void 0 ? _b : this._currentNetworkType;
+            if (network)
+                query.set('network', network);
+            if (params.billingMode)
+                query.set('billingMode', params.billingMode);
             const queryString = query.toString();
             const r = yield this.client.socket.get(`/api/v1/job-video/estimate/${path}${queryString ? `?${queryString}` : ''}`);
             return {
@@ -2299,8 +2378,9 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 usd: r.quote.project.costInUSD,
                 spark: r.quote.project.costInSpark,
                 sogni: r.quote.project.costInSogni,
-                estimatedRenderSeconds: (_b = r.benchmark) === null || _b === void 0 ? void 0 : _b.estimatedRenderTimeSec,
-                estimatedTotalSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedTotalTimeSec
+                estimatedRenderSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedRenderTimeSec,
+                estimatedTotalSeconds: (_d = r.benchmark) === null || _d === void 0 ? void 0 : _d.estimatedTotalTimeSec,
+                dailyFairUsePct: (_e = r.dailyFairUse) === null || _e === void 0 ? void 0 : _e.pct
             };
         });
     }
@@ -2317,7 +2397,7 @@ class ProjectsApi extends ApiGroup_js_1.default {
      */
     estimateAudioCost(params) {
         return __awaiter(this, void 0, void 0, function* () {
-            var _a, _b;
+            var _a, _b, _c, _d;
             const pathParams = [
                 params.tokenType,
                 params.model,
@@ -2326,14 +2406,23 @@ class ProjectsApi extends ApiGroup_js_1.default {
                 params.numberOfMedia
             ];
             const path = pathParams.map((p) => encodeURIComponent(p)).join('/');
-            const r = yield this.client.socket.get(`/api/v1/job-audio/estimate/${path}`);
+            const query = new URLSearchParams();
+            // Unpinned, the job renders on the connection's network, so quote that one.
+            const network = (_a = params.network) !== null && _a !== void 0 ? _a : this._currentNetworkType;
+            if (network)
+                query.set('network', network);
+            if (params.billingMode)
+                query.set('billingMode', params.billingMode);
+            const queryString = query.toString();
+            const r = yield this.client.socket.get(`/api/v1/job-audio/estimate/${path}${queryString ? `?${queryString}` : ''}`);
             return {
                 token: r.quote.project.costInToken,
                 usd: r.quote.project.costInUSD,
                 spark: r.quote.project.costInSpark,
                 sogni: r.quote.project.costInSogni,
-                estimatedRenderSeconds: (_a = r.benchmark) === null || _a === void 0 ? void 0 : _a.estimatedRenderTimeSec,
-                estimatedTotalSeconds: (_b = r.benchmark) === null || _b === void 0 ? void 0 : _b.estimatedTotalTimeSec
+                estimatedRenderSeconds: (_b = r.benchmark) === null || _b === void 0 ? void 0 : _b.estimatedRenderTimeSec,
+                estimatedTotalSeconds: (_c = r.benchmark) === null || _c === void 0 ? void 0 : _c.estimatedTotalTimeSec,
+                dailyFairUsePct: (_d = r.dailyFairUse) === null || _d === void 0 ? void 0 : _d.pct
             };
         });
     }