@sogni-ai/sogni-client 5.41.0 → 5.42.0

package/AGENTS.md

@@ -27,6 +27,7 @@ Current public API anchors:
 - Socket-native LLM chat uses `sogni.chat.completions.create()`.
 - Durable creative workflows use `sogni.workflows`.
 - Project cost helpers are `sogni.projects.estimateCost()`, `estimateVideoCost()`, and `estimateAudioCost()`.
+- `sogni.projects.assets` manages private subscriber uploads (`upload`, `list`, `remove`, `bind`). Supported servers automatically reuse matching files passed to `projects.create()`; saved IDs do not replace file parameters.
 - `checkAuth()` is only for cookie-auth browser flows. API-key auth auto-authenticates during `createInstance()`, and token auth uses `login()` or `setTokens()`.
 - `ChatCompletionResult` is SDK-shaped (`content`, `role`, `finishReason`, `tool_calls`, `usage`, `cost`). Streaming chunks expose `chunk.content` and optional `chunk.tool_calls`.
 

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [5.42.0](https://github.com/Sogni-AI/sogni-client/compare/v5.41.0...v5.42.0) (2026-09-11)
+
+
+### Features
+
+* **projects:** reuse private subscriber uploads across projects ([938e8a4](https://github.com/Sogni-AI/sogni-client/commit/938e8a4d9716706530be4586ee324490f6374b01))
+
 # [5.41.0](https://github.com/Sogni-AI/sogni-client/compare/v5.40.0...v5.41.0) (2026-09-11)
 
 

package/README.md

@@ -749,6 +749,34 @@ const project = await sogni.projects.create({
 - Workers download a LoRA on first use, so the first render with an uncached one
   takes longer to start.
 
+### Reusable subscriber uploads
+
+On servers that support saved uploads, eligible subscribers can reuse the same
+image, video or audio file across projects. Pass files to `projects.create()` as
+usual: the SDK checks for a previously saved copy before transferring bytes.
+Uploads remain private to the signed-in account. Older servers and accounts
+without this feature continue using ordinary project uploads.
+
+```javascript
+const saved = await sogni.projects.assets.upload(file, file.type, 'Product reference');
+const { assets, limits } = await sogni.projects.assets.list();
+console.log(saved.id, assets, limits);
+// Reusing the same file in later projects needs no repeat upload.
+// Removal does not remove inputs already copied into an existing project.
+await sogni.projects.assets.remove(saved.id);
+```
+
+Use the returned limits and `expiresAt` to display remaining storage and expiry.
+An expired entry can be removed even after the subscription ends. Explicit
+`assets.upload()` calls report errors; automatic project uploads fall back only
+when saved storage cannot be prepared. Transfer or verification failures stop
+project submission. Saved-upload IDs are not accepted in place of files in
+`projects.create()`; `assets.bind(id, { projectId, type, id? })` is available for
+clients that manage project IDs and input slots directly.
+
+Project history may include `byolUsed`, `personalLoras` public-source snapshots,
+and `reusedAssetCount`. Missing fields on older projects mean unknown, not zero.
+
 ### ControlNets
 
 **EXPERIMENTAL FEATURE:** This feature is still in development and may not work as expected. Use at your own risk.

package/dist/Projects/ReusableUploads.d.ts

@@ -0,0 +1,47 @@
+import type RestClient from '../lib/RestClient.js';
+export interface SavedUpload {
+    id: string;
+    name: string;
+    bytes: number;
+    contentType: string;
+    state: 'uploading' | 'ready';
+    createdAt: number;
+    expiresAt: number;
+}
+export interface SavedUploadBinding {
+    projectId: string;
+    type: string;
+    id?: string;
+}
+/** Private subscriber uploads that can be reused across projects. */
+export default class ReusableUploads {
+    private readonly rest;
+    private pending;
+    private lanes;
+    private nextLane;
+    private session;
+    private availability?;
+    private preparationFailures;
+    constructor(rest: RestClient);
+    private assertSession;
+    private canAutomaticallySave;
+    list(): Promise<{
+        assets: SavedUpload[];
+        limits: {
+            entries: number;
+            bytes: number;
+            fileBytes: number;
+            idleDays: number;
+            copyBytesPerDay: number;
+            bindingsPerDay: number;
+        };
+    }>;
+    remove(id: string): Promise<void>;
+    bind(id: string, binding: SavedUploadBinding): Promise<void>;
+    private retryBusy;
+    /** Upload once; the API verifies the file before making it reusable. */
+    upload(file: Blob | Buffer, contentType: string, name?: string): Promise<SavedUpload>;
+    private performUpload;
+    /** Existing project uploads remain available when saved uploads cannot be used. */
+    tryBindFile(file: Blob | Buffer, contentType: string | undefined, binding: SavedUploadBinding): Promise<boolean>;
+}

package/dist/Projects/ReusableUploads.js

@@ -0,0 +1,210 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("../ApiClient/index.js");
+const SUPPORTED_TYPES = new Set([
+    'image/png',
+    'image/jpeg',
+    'image/webp',
+    'video/mp4',
+    'video/quicktime',
+    'video/webm',
+    'audio/mp4',
+    'audio/mpeg',
+    'audio/flac',
+    'audio/wav',
+    'audio/x-wav',
+    'audio/wave'
+]);
+/** Private subscriber uploads that can be reused across projects. */
+class ReusableUploads {
+    constructor(rest) {
+        var _a;
+        this.rest = rest;
+        this.pending = new Map();
+        // Bound hashing/upload memory even when a project has many reference files.
+        this.lanes = [Promise.resolve(), Promise.resolve()];
+        this.nextLane = 0;
+        this.session = 0;
+        this.preparationFailures = new WeakSet();
+        (_a = rest.auth) === null || _a === void 0 ? void 0 : _a.on('updated', () => {
+            this.session += 1;
+            this.pending.clear();
+            this.availability = undefined;
+        });
+    }
+    assertSession(session) {
+        if (session !== this.session)
+            throw new Error('The account changed. Select the upload again.');
+    }
+    canAutomaticallySave() {
+        if (this.availability && this.availability.expiresAt > Date.now())
+            return this.availability.result;
+        const result = this.rest
+            .get('/v1/assets/capabilities')
+            .then((response) => response.data.enabled === true)
+            .catch((error) => {
+            if (error instanceof index_js_1.ApiError && [403, 404, 503].includes(error.status))
+                return false;
+            this.availability = undefined;
+            throw error;
+        });
+        this.availability = { expiresAt: Date.now() + 60000, result };
+        return result;
+    }
+    list() {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.rest.get('/v1/assets');
+            return result.data;
+        });
+    }
+    remove(id) {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.rest.delete(`/v1/assets/${encodeURIComponent(id)}`);
+        });
+    }
+    bind(id, binding) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const session = this.session;
+            yield this.retryBusy(() => {
+                this.assertSession(session);
+                return this.rest.post(`/v1/assets/${encodeURIComponent(id)}/bind`, Object.assign({}, binding));
+            });
+            this.assertSession(session);
+        });
+    }
+    retryBusy(operation) {
+        return __awaiter(this, void 0, void 0, function* () {
+            for (let attempt = 0;; attempt += 1) {
+                try {
+                    return yield operation();
+                }
+                catch (error) {
+                    if (!(error instanceof index_js_1.ApiError) || error.status !== 423 || attempt >= 4)
+                        throw error;
+                    yield new Promise((resolve) => setTimeout(resolve, 250 * Math.pow(2, attempt)));
+                }
+            }
+        });
+    }
+    /** Upload once; the API verifies the file before making it reusable. */
+    upload(file, contentType, name = 'Saved upload') {
+        const session = this.session;
+        const size = file instanceof Blob ? file.size : file.byteLength;
+        if (!size || size > 100 * 1024 * 1024)
+            return Promise.reject(new index_js_1.ApiError(400, {
+                status: 'error',
+                errorCode: 0,
+                message: 'Choose a saved upload no larger than 100 MiB.'
+            }));
+        const lane = this.nextLane++ % this.lanes.length;
+        const run = this.lanes[lane].then(() => __awaiter(this, void 0, void 0, function* () {
+            this.assertSession(session);
+            const bytes = file instanceof Blob ? yield file.arrayBuffer() : file;
+            const digest = yield globalThis.crypto.subtle.digest('SHA-256', bytes);
+            this.assertSession(session);
+            const sha256 = Array.from(new Uint8Array(digest), (value) => 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);
+            try {
+                return yield task;
+            }
+            finally {
+                if (this.pending.get(key) === task)
+                    this.pending.delete(key);
+            }
+        }));
+        this.lanes[lane] = run.catch(() => undefined);
+        return run;
+    }
+    performUpload(file, bytes, sha256, contentType, name, session) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const result = yield this.retryBusy(() => {
+                this.assertSession(session);
+                return this.rest.post('/v1/assets/prepare', {
+                    sha256,
+                    bytes,
+                    contentType,
+                    name
+                });
+            }).catch((error) => {
+                if (error instanceof Error)
+                    this.preparationFailures.add(error);
+                throw error;
+            });
+            this.assertSession(session);
+            const prepared = result.data;
+            if (prepared.state === 'ready')
+                return prepared;
+            if (!prepared.uploadUrl || !prepared.uploadHeaders)
+                throw new Error('The saved upload could not be prepared.');
+            const body = file instanceof Blob ? file : new Blob([new Uint8Array(file)]);
+            const response = yield fetch(prepared.uploadUrl, {
+                method: 'PUT',
+                body,
+                headers: prepared.uploadHeaders,
+                redirect: 'error',
+                credentials: 'omit',
+                signal: AbortSignal.timeout(300000)
+            });
+            this.assertSession(session);
+            // A concurrent/retried write-once upload may already have finished. The
+            // server still verifies the stored bytes before acknowledging completion.
+            if (!response.ok && response.status !== 412)
+                throw new index_js_1.ApiError(response.status, {
+                    status: 'error',
+                    errorCode: 0,
+                    message: 'Could not upload the selected file.'
+                });
+            const finalized = yield this.retryBusy(() => {
+                this.assertSession(session);
+                return this.rest.post(`/v1/assets/${encodeURIComponent(prepared.id)}/finalize`);
+            });
+            this.assertSession(session);
+            return finalized.data;
+        });
+    }
+    /** Existing project uploads remain available when saved uploads cannot be used. */
+    tryBindFile(file, contentType, binding) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const size = file instanceof Blob ? file.size : file.byteLength;
+            if (!contentType || !SUPPORTED_TYPES.has(contentType) || !size || size > 100 * 1024 * 1024)
+                return false;
+            const session = this.session;
+            if (!(yield this.canAutomaticallySave()))
+                return false;
+            this.assertSession(session);
+            try {
+                const saved = yield this.upload(file, contentType, file instanceof Blob && 'name' in file && typeof file.name === 'string'
+                    ? file.name
+                    : 'Saved upload');
+                this.assertSession(session);
+                yield this.bind(saved.id, binding);
+                return true;
+            }
+            catch (error) {
+                // Fallback is permitted only before a transfer was prepared. Checksum,
+                // storage-access and binding failures must surface before job submission.
+                if (error instanceof index_js_1.ApiError &&
+                    this.preparationFailures.has(error) &&
+                    [400, 403, 404, 409, 410, 503].includes(error.status))
+                    return false;
+                throw error;
+            }
+        });
+    }
+}
+exports.default = ReusableUploads;
+//# sourceMappingURL=ReusableUploads.js.map

package/dist/Projects/ReusableUploads.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ReusableUploads.js","sourceRoot":"","sources":["../../src/Projects/ReusableUploads.ts"],"names":[],"mappings":";;;;;;;;;;;AACA,oDAAmE;AAqBnE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,iBAAiB;IACjB,YAAY;IACZ,WAAW;IACX,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,aAAa;IACb,YAAY;CACb,CAAC,CAAC;AAEH,qEAAqE;AACrE,MAAqB,eAAe;IAQlC,YAA6B,IAAgB;;QAAhB,SAAI,GAAJ,IAAI,CAAY;QAPrC,YAAO,GAAG,IAAI,GAAG,EAAgC,CAAC;QAC1D,4EAA4E;QACpE,UAAK,GAAuB,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;QACnE,aAAQ,GAAG,CAAC,CAAC;QACb,YAAO,GAAG,CAAC,CAAC;QAEZ,wBAAmB,GAAG,IAAI,OAAO,EAAS,CAAC;QAEjD,MAAA,IAAI,CAAC,IAAI,0CAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;YAC5B,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAClB,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACrB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAChC,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,aAAa,CAAC,OAAe;QACnC,IAAI,OAAO,KAAK,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,+CAA+C,CAAC,CAAC;IACjG,CAAC;IAEO,oBAAoB;QAC1B,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE;YAC/D,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI;aACrB,GAAG,CAAoC,yBAAyB,CAAC;aACjE,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC;aAClD,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;YACf,IAAI,KAAK,YAAY,mBAAQ,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;gBAAE,OAAO,KAAK,CAAC;YACtF,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;YAC9B,MAAM,KAAK,CAAC;QACd,CAAC,CAAC,CAAC;QACL,IAAI,CAAC,YAAY,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,CAAC;QAC9D,OAAO,MAAM,CAAC;IAChB,CAAC;IAEK,IAAI;;YACR,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAYhC,YAAY,CAAC,CAAC;YAChB,OAAO,MAAM,CAAC,IAAI,CAAC;QACrB,CAAC;KAAA;IAEK,MAAM,CAAC,EAAU;;YACrB,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,cAAc,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACjE,CAAC;KAAA;IAEK,IAAI,CAAC,EAAU,EAAE,OAA2B;;YAChD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBACxB,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,kBAAkB,CAAC,EAAE,CAAC,OAAO,oBAAO,OAAO,EAAG,CAAC;YACrF,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;QAC9B,CAAC;KAAA;IAEa,SAAS,CAAI,SAA2B;;YACpD,KAAK,IAAI,OAAO,GAAG,CAAC,GAAI,OAAO,IAAI,CAAC,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,OAAO,MAAM,SAAS,EAAE,CAAC;gBAC3B,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,CAAC,KAAK,YAAY,mBAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,OAAO,IAAI,CAAC;wBAAE,MAAM,KAAK,CAAC;oBACtF,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,GAAG,GAAG,SAAA,CAAC,EAAI,OAAO,CAAA,CAAC,CAAC,CAAC;gBAC1E,CAAC;YACH,CAAC;QACH,CAAC;KAAA;IAED,wEAAwE;IACxE,MAAM,CAAC,IAAmB,EAAE,WAAmB,EAAE,IAAI,GAAG,cAAc;QACpE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;QAC7B,MAAM,IAAI,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;QAChE,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI;YACnC,OAAO,OAAO,CAAC,MAAM,CACnB,IAAI,mBAAQ,CAAC,GAAG,EAAE;gBAChB,MAAM,EAAE,OAAO;gBACf,SAAS,EAAE,CAAC;gBACZ,OAAO,EAAE,+CAA+C;aACzD,CAAC,CACH,CAAC;QACJ,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;QACjD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAS,EAAE;YAC3C,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,KAAK,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,KAAqB,CAAC,CAAC;YACvF,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,EAAE,CAC1D,KAAK,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CACpC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACX,MAAM,GAAG,GAAG,GAAG,MAAM,IAAI,WAAW,EAAE,CAAC;YACvC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACvC,IAAI,QAAQ;gBAAE,OAAO,QAAQ,CAAC;YAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;YAC5F,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC5B,IAAI,CAAC;gBACH,OAAO,MAAM,IAAI,CAAC;YACpB,CAAC;oBAAS,CAAC;gBACT,IAAI,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI;oBAAE,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC/D,CAAC;QACH,CAAC,CAAA,CAAC,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC9C,OAAO,GAAG,CAAC;IACb,CAAC;IAEa,aAAa,CACzB,IAAmB,EACnB,KAAa,EACb,MAAc,EACd,WAAmB,EACnB,IAAY,EACZ,OAAe;;YAEf,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBACvC,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAA8B,oBAAoB,EAAE;oBACvE,MAAM;oBACN,KAAK;oBACL,WAAW;oBACX,IAAI;iBACL,CAAC,CAAC;YACL,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;gBACjB,IAAI,KAAK,YAAY,KAAK;oBAAE,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;gBAChE,MAAM,KAAK,CAAC;YACd,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC;YAC7B,IAAI,QAAQ,CAAC,KAAK,KAAK,OAAO;gBAAE,OAAO,QAAQ,CAAC;YAChD,IAAI,CAAC,QAAQ,CAAC,SAAS,IAAI,CAAC,QAAQ,CAAC,aAAa;gBAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,CAAC,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAC5E,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,QAAQ,CAAC,SAAS,EAAE;gBAC/C,MAAM,EAAE,KAAK;gBACb,IAAI;gBACJ,OAAO,EAAE,QAAQ,CAAC,aAAa;gBAC/B,QAAQ,EAAE,OAAO;gBACjB,WAAW,EAAE,MAAM;gBACnB,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,MAAM,CAAC;aACpC,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,wEAAwE;YACxE,0EAA0E;YAC1E,IAAI,CAAC,QAAQ,CAAC,EAAE,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG;gBACzC,MAAM,IAAI,mBAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE;oBAClC,MAAM,EAAE,OAAO;oBACf,SAAS,EAAE,CAAC;oBACZ,OAAO,EAAE,qCAAqC;iBAC/C,CAAC,CAAC;YACL,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBAC1C,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CACnB,cAAc,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC,WAAW,CACzD,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,OAAO,SAAS,CAAC,IAAI,CAAC;QACxB,CAAC;KAAA;IAED,mFAAmF;IAC7E,WAAW,CACf,IAAmB,EACnB,WAA+B,EAC/B,OAA2B;;YAE3B,MAAM,IAAI,GAAG,IAAI,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC;YAChE,IAAI,CAAC,WAAW,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI;gBACxF,OAAO,KAAK,CAAC;YACf,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,oBAAoB,EAAE,CAAC;gBAAE,OAAO,KAAK,CAAC;YACvD,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;YAC5B,IAAI,CAAC;gBACH,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAC7B,IAAI,EACJ,WAAW,EACX,IAAI,YAAY,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;oBACrE,CAAC,CAAC,IAAI,CAAC,IAAI;oBACX,CAAC,CAAC,cAAc,CACnB,CAAC;gBACF,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBAC5B,MAAM,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;gBACnC,OAAO,IAAI,CAAC;YACd,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,uEAAuE;gBACvE,0EAA0E;gBAC1E,IACE,KAAK,YAAY,mBAAQ;oBACzB,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;oBACnC,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;oBAErD,OAAO,KAAK,CAAC;gBACf,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;KAAA;CACF;AAxMD,kCAwMC"}

package/dist/Projects/index.d.ts

@@ -1,4 +1,5 @@
 import ApiGroup, { ApiConfig } from '../ApiGroup.js';
+import ReusableUploads from './ReusableUploads.js';
 import { AvailableModel, EnhancementStrength, EstimateRequest, ImageUrlParams, MediaUrlParams, CostEstimation, ProjectParams, SizePreset, SupportedModel, VideoEstimateRequest, AudioEstimateRequest } from './types/index.js';
 import { type RecoveredProject } from '../ApiClient/WebSocketClient/events.js';
 import Project from './Project.js';
@@ -52,6 +53,9 @@ export type ProjectStatusSnapshot = Partial<Omit<RawProject, 'status' | 'workerJ
     completedWorkerJobs: RawProject['completedWorkerJobs'];
 };
 declare class ProjectsApi extends ApiGroup<ProjectApiEvents> {
+    private _assets?;
+    /** Manage subscriber uploads once and reuse them across projects. */
+    get assets(): ReusableUploads;
     private _availableModels;
     private _currentNetworkType;
     private projects;

package/dist/Projects/index.js

@@ -13,6 +13,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const ApiGroup_js_1 = __importDefault(require("../ApiGroup.js"));
+const ReusableUploads_js_1 = __importDefault(require("./ReusableUploads.js"));
 const Project_js_1 = __importDefault(require("./Project.js"));
 const recovery_js_1 = require("./recovery.js");
 const createJobRequestMessage_js_1 = __importDefault(require("./createJobRequestMessage.js"));
@@ -250,6 +251,11 @@ const MISSING_PROJECT_RETRY_MS = 2500;
 const IN_FLIGHT_LOOKUP_STATUSES = new Set(['pending', 'queued', 'processing']);
 const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 class ProjectsApi extends ApiGroup_js_1.default {
+    /** Manage subscriber uploads once and reuse them across projects. */
+    get assets() {
+        var _a;
+        return ((_a = this._assets) !== null && _a !== void 0 ? _a : (this._assets = new ReusableUploads_js_1.default(this.client.rest)));
+    }
     get availableModels() {
         return this._availableModels;
     }
@@ -1530,6 +1536,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const imageId = (0, getUUID_js_1.default)();
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'startingImage' }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1558,6 +1566,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const imageId = (0, getUUID_js_1.default)();
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'cnImage' }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1587,6 +1597,11 @@ class ProjectsApi extends ApiGroup_js_1.default {
             const imageId = (0, getUUID_js_1.default)();
             const imageIndex = (index + 1);
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, {
+                projectId,
+                type: `contextImage${imageIndex}`
+            }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1623,6 +1638,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const imageId = (0, getUUID_js_1.default)();
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'referenceImage' }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1655,6 +1672,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const imageId = (0, getUUID_js_1.default)();
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'referenceMask' }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1687,6 +1706,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
         return __awaiter(this, void 0, void 0, function* () {
             const imageId = (0, getUUID_js_1.default)();
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'referenceImageEnd' }))
+                return imageId;
             const presignedUrl = yield this.uploadUrl({
                 imageId,
                 jobId: projectId,
@@ -1720,6 +1741,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
     uploadReferenceAudio(projectId, file, id) {
         return __awaiter(this, void 0, void 0, function* () {
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'referenceAudio', id }))
+                return;
             const presignedUrl = yield this.mediaUploadUrl({
                 jobId: projectId,
                 type: 'referenceAudio',
@@ -1752,6 +1775,8 @@ class ProjectsApi extends ApiGroup_js_1.default {
     uploadReferenceVideo(projectId, file, id) {
         return __awaiter(this, void 0, void 0, function* () {
             const contentType = getFileContentType(file);
+            if (yield this.assets.tryBindFile(file, contentType, { projectId, type: 'referenceVideo', id }))
+                return;
             const presignedUrl = yield this.mediaUploadUrl({
                 jobId: projectId,
                 type: 'referenceVideo',