@sogni-ai/sogni-client 5.84.1 → 5.84.2

package/dist/Projects/utils/imageUploadBody.js

@@ -0,0 +1,88 @@
+"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 });
+exports.assertImageUploadBody = assertImageUploadBody;
+const index_js_1 = require("../../ApiClient/index.js");
+/**
+ * Refuse an image-slot upload whose contents are text instead of image bytes.
+ *
+ * An image slot that receives text instead of an image (a file path string,
+ * a fetched HTML page, or base64 text) cannot be decoded, so the job fails
+ * after it has been submitted. Checking the leading bytes here turns that
+ * into an error that names the slot, before any upload URL, upload or job
+ * request.
+ *
+ * Only contents that cannot be an image are refused: a `data:` URL, an HTML
+ * page, base64 text, or a string that is not markup. Image bytes, SVG markup
+ * and anything this check does not recognise upload as before.
+ */
+function assertImageUploadBody(file, slot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const found = yield describeTextBody(file);
+        if (!found)
+            return;
+        throw new index_js_1.ApiError(400, {
+            status: 'error',
+            errorCode: 0,
+            message: `${slot} is not image data: ${found}. Upload the image file itself.`
+        });
+    });
+}
+/** Enough leading bytes for an HTML doctype after a byte-order mark and some whitespace. */
+const SNIFF_BYTES = 64;
+/** Sixteen base64 characters: no binary image header is made only of them. */
+const BASE64_HEAD = /^[A-Za-z0-9+/]{16}/;
+const DATA_URL_HEAD = /^data:/i;
+/** UTF-8 byte-order mark, read either as one character or as its three bytes. */
+const HTML_HEAD = /^(?:|\xef\xbb\xbf)?\s*<(?:!doctype\s+html|html[\s>])/i;
+const MARKUP_HEAD = /^(?:|\xef\xbb\xbf)?\s*</;
+function describeTextBody(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        if (typeof file === 'string') {
+            const head = file.slice(0, SNIFF_BYTES);
+            // SVG markup is text and still uploads; any other string is not an image.
+            return (_a = describeHead(head)) !== null && _a !== void 0 ? _a : (MARKUP_HEAD.test(head) ? null : 'it is a string, not the file');
+        }
+        const bytes = yield leadingBytes(file);
+        return bytes ? describeHead(String.fromCharCode(...bytes)) : null;
+    });
+}
+function leadingBytes(file) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            if (typeof Blob !== 'undefined' && file instanceof Blob) {
+                return new Uint8Array(yield file.slice(0, SNIFF_BYTES).arrayBuffer());
+            }
+            if (ArrayBuffer.isView(file)) {
+                return new Uint8Array(file.buffer, file.byteOffset, Math.min(file.byteLength, SNIFF_BYTES));
+            }
+            if (file instanceof ArrayBuffer) {
+                return new Uint8Array(file, 0, Math.min(file.byteLength, SNIFF_BYTES));
+            }
+        }
+        catch (_a) {
+            // A file that can no longer be read fails at the upload, as it always has.
+        }
+        return null;
+    });
+}
+function describeHead(head) {
+    if (DATA_URL_HEAD.test(head))
+        return 'its contents are a data: URL';
+    if (HTML_HEAD.test(head))
+        return 'its contents are an HTML page';
+    // GIF's signature is letters and digits, and its size bytes can be too.
+    if (!head.startsWith('GIF8') && BASE64_HEAD.test(head))
+        return 'its contents are base64 text';
+    return null;
+}
+//# sourceMappingURL=imageUploadBody.js.map

package/dist/Projects/utils/imageUploadBody.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageUploadBody.js","sourceRoot":"","sources":["../../../src/Projects/utils/imageUploadBody.ts"],"names":[],"mappings":";;;;;;;;;;;AAeA,sDAQC;AAvBD,uDAAoD;AAEpD;;;;;;;;;;;;GAYG;AACH,SAAsB,qBAAqB,CAAC,IAAa,EAAE,IAAY;;QACrE,MAAM,KAAK,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC3C,IAAI,CAAC,KAAK;YAAE,OAAO;QACnB,MAAM,IAAI,mBAAQ,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,OAAO;YACf,SAAS,EAAE,CAAC;YACZ,OAAO,EAAE,GAAG,IAAI,uBAAuB,KAAK,iCAAiC;SAC9E,CAAC,CAAC;IACL,CAAC;CAAA;AAED,4FAA4F;AAC5F,MAAM,WAAW,GAAG,EAAE,CAAC;AACvB,8EAA8E;AAC9E,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,aAAa,GAAG,SAAS,CAAC;AAChC,iFAAiF;AACjF,MAAM,SAAS,GAAG,wDAAwD,CAAC;AAC3E,MAAM,WAAW,GAAG,0BAA0B,CAAC;AAE/C,SAAe,gBAAgB,CAAC,IAAa;;;QAC3C,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC7B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;YACxC,0EAA0E;YAC1E,OAAO,MAAA,YAAY,CAAC,IAAI,CAAC,mCAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;QAChG,CAAC;QACD,MAAM,KAAK,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,OAAO,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACpE,CAAC;CAAA;AAED,SAAe,YAAY,CAAC,IAAa;;QACvC,IAAI,CAAC;YACH,IAAI,OAAO,IAAI,KAAK,WAAW,IAAI,IAAI,YAAY,IAAI,EAAE,CAAC;gBACxD,OAAO,IAAI,UAAU,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC;YACxE,CAAC;YACD,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;gBAC7B,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YAC9F,CAAC;YACD,IAAI,IAAI,YAAY,WAAW,EAAE,CAAC;gBAChC,OAAO,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,CAAC;YACzE,CAAC;QACH,CAAC;QAAC,WAAM,CAAC;YACP,2EAA2E;QAC7E,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CAAA;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,8BAA8B,CAAC;IACpE,IAAI,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,+BAA+B,CAAC;IACjE,wEAAwE;IACxE,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,8BAA8B,CAAC;IAC9F,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const LIB_VERSION = "5.84.1";
+export declare const LIB_VERSION = "5.84.2";

package/dist/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.LIB_VERSION = void 0;
 // AUTO-GENERATED by scripts/generate-version.mjs — do not edit.
 // Source of truth: package.json version.
-exports.LIB_VERSION = '5.84.1';
+exports.LIB_VERSION = '5.84.2';
 //# sourceMappingURL=version.js.map

package/dist-esm/Projects/index.js

@@ -26,6 +26,7 @@ import Cache from '../lib/Cache.js';
 import { enhancementDefaults, seedanceDraftResultFields } from './Job.js';
 import { calculateVideoFrames, getEnhacementStrength, getVideoAssetRequirements, getVideoContextImageSlots, getPixal3dOrbitViewSlots, getMinimaxH3KeyframeSlots, getMinimaxH3ReferenceAudioSlots, getMinimaxH3ReferenceVideoSlots, getVideoWorkflowType, asResultMediaKind, isAudioModel, isModelArtifactModel, isMinimaxH3ReferenceModel, isSegmentationModel, isVideoModel, resultMediaEvidence, usesReferenceMask } from './utils/index.js';
 import { getFileContentType } from './utils/fileContentType.js';
+import { assertImageUploadBody } from './utils/imageUploadBody.js';
 import { imageLayersFromResult } from './utils/imageLayers.js';
 import { getMaxContextImages, validateSampler, isGptImageModel, resolveGptImageGifSize } from '../lib/validation.js';
 import { isAudioTier, isComfyImageTier, isImageTier, isVideoTier } from './types/ModelTiersRaw.js';
@@ -2755,6 +2756,7 @@ class ProjectsApi extends ApiGroup {
             const imageId = getUUID();
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, 'Guide image');
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type: 'startingImage' }))
                 return imageId;
@@ -2791,6 +2793,7 @@ class ProjectsApi extends ApiGroup {
             const imageId = getUUID();
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, 'ControlNet image');
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type: 'cnImage' }))
                 return imageId;
@@ -2828,6 +2831,7 @@ class ProjectsApi extends ApiGroup {
             const imageIndex = (index + 1);
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, `Context image ${imageIndex}`);
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, {
                 projectId,
@@ -2874,6 +2878,7 @@ class ProjectsApi extends ApiGroup {
             const type = `keyframeImage${slot}`;
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, `Keyframe image ${slot}`);
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type }))
                 return imageId;
@@ -2912,6 +2917,7 @@ class ProjectsApi extends ApiGroup {
             const imageId = getUUID();
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, 'Reference image');
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type: 'referenceImage' }))
                 return imageId;
@@ -2952,6 +2958,7 @@ class ProjectsApi extends ApiGroup {
             const imageId = getUUID();
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, 'Reference mask');
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type: 'referenceMask' }))
                 return imageId;
@@ -2992,6 +2999,7 @@ class ProjectsApi extends ApiGroup {
             const imageId = getUUID();
             const assertSession = (_a = this._preparingSessions.get(projectId)) !== null && _a !== void 0 ? _a : captureRequestSession(this.client.auth);
             assertSession();
+            yield assertImageUploadBody(file, 'End reference image');
             const contentType = getFileContentType(file);
             if (yield this._bindSavedUpload(file, contentType, { projectId, type: 'referenceImageEnd' }))
                 return imageId;