samsar-js 0.48.30 → 0.48.32

package/README.md

@@ -330,14 +330,9 @@ await samsar.deleteEmbedding({
   source_id: '2',
 });
 
-// Remove branding/watermark
+// Remove visible text
 const cleaned = await samsar.removeBrandingFromImage({ image_url: 'https://example.com/photo.png' });
 
-// Replace branding/watermark (original image, replacement logo/image)
-const replaced = await samsar.replaceBrandingFromImage({
-  image_urls: ['https://example.com/photo.png', 'https://example.com/new-logo.png'],
-});
-
 // Extend image set
 const images = await samsar.extendImageList({
   image_urls: ['https://example.com/extra.jpg'],
@@ -346,6 +341,24 @@ const images = await samsar.extendImageList({
   aspect_ratio: '16:9',
 });
 
+// Assign a short SEO-friendly image title
+const imageTitle = await samsar.assignImageTitle({
+  image_url: 'https://example.com/product-photo.png',
+  metadata: {
+    product: 'linen travel shirt',
+    collection: 'spring essentials',
+  },
+});
+console.log(imageTitle.data.content); // "Linen Travel Shirt"
+
+// Binary uploads are also supported in browser/Node 18+ runtimes
+const fileTitle = await samsar.assignImageTitle({
+  image: fileOrBlob,
+  fileName: 'product-photo.png',
+  mimeType: 'image/png',
+  metadata: { product: 'linen travel shirt' },
+});
+
 // Create a reusable receipt template from one sample receipt image (free endpoint)
 const receiptTemplate = await samsar.createReceiptTemplate({
   image_url: 'https://example.com/receipt-template.png',
@@ -560,10 +573,10 @@ console.log(externalLibrary.data.requests.map((request) => request.request_id));
 ```
 
 Video model support notes:
-- `createVideoFromText` image model keys include: `GPTIMAGE2`, `IMAGEN4`, `SEEDREAM`, `NANOBANANA2`, `CUSTOM_TEXT_TO_IMAGE`.
+- `createVideoFromText` image model keys include: `GPTIMAGE2`, `IMAGEN4`, `SEEDREAM`, `NANOBANANA2`, `NANOBANANAPRO`, `CUSTOM_TEXT_TO_IMAGE`.
 - `createVideoFromText` supports these video models: `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SEEDANCEI2V` (Seedance 1.5), `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V`.
 - `createVideoFromText` accepts either a provided outro (`outro_image_url`) or server-generated QR outro (`generate_outro_image: true` with `cta_url`). It can also render bottom CTA footer QR cards with `add_footer_animation` and `footer_metadata`; one footer item applies to every generated scene, while multiple items map by scene index.
-- `createVideoFromImageList` supports `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SEEDANCEI2V`, `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V` via `video_model`; if omitted, it defaults to `RUNWAYML`. Use `aspect_ratio: '16:9'` or `'9:16'`; omitted or invalid values fall back to `16:9`.
+- `createVideoFromImageList` supports `RUNWAYML`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SEEDANCEI2V`, `KLINGIMGTOVID3PRO`, and `HAPPYHORSEI2V` via `video_model`; if omitted, it defaults to `RUNWAYML`. It also accepts the same `image_model` keys as text-to-video. Use `aspect_ratio: '16:9'` or `'9:16'`; omitted or invalid values fall back to `16:9`.
 - `createVideoFromImageList` accepts either a provided outro (`outro_image_url`) or server-generated QR outro (`generate_outro_image: true` with `cta_url`). Do not combine the two modes in a single request.
 - `createVideoFromImageList` can render per-scene footer QR cards by setting `add_footer_animation: true` and providing one `footer_metadata` item per image scene.
 - `createVideoFromImageList` can also generate QR outro CTA text and each scene footer CTA from a single link by setting `express_cta_generation: true` with `cta_url`. CamelCase `expressCtaGeneration` and compatibility aliases `auto_generate_cta_text` / `generate_cta_texts` are normalized to the same API field.
@@ -579,7 +592,7 @@ Video model support notes:
 
 Upcoming `/v2` omni route adapters:
 - `/v2` is additive; `/v1` is not deprecated.
-- `createV2VideoFromText`, `createV2VideoFromImageList`, `translateV2Video`, `cloneV2Video`, `regenerateV2VideoAvatar`, `updateV2VideoOutroImage`, `updateV2VideoFooterImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2StatusDetailed`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
+- `createV2VideoFromText`, `createV2VideoFromImageList`, `assignV2ImageTitle`, `translateV2Video`, `cloneV2Video`, `regenerateV2VideoAvatar`, `updateV2VideoOutroImage`, `updateV2VideoFooterImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2StatusDetailed`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
 - Step-controlled video helpers include `createV2StepVideoFromText`, `createV2StepTextToVideo`, `createV2StepVideoFromImage`, `createV2StepImageToVideo`, `getV2StepVideoStatus`, `getV2StepVideoStatusDetailed`, and `processNextV2StepVideo`. They default to 1-step express rendering by sending `auto_render_full_video: true` and `manual_step_stages: []`; pass `{ stepMode: 'two_step' }` or `manual_step_stages: ['ai_video_generation']` to require an explicit second-step approval before image-to-video generation.
 - Programmatic user helpers include `createV2ExternalUser`, `createV2UserRechargeCredits`, `refreshV2UserToken`, `createV2UserAppKey`, `refreshV2UserAppKey`, `getV2UserCredits`, `getV2UserUsageLogs`, and `getV2UserPaymentStatus`.
 - Omit `externalUser` for internal account billing, pass `externalUser` to scope an external user with the account API key, or authenticate the client directly with an external-user auth token/API key. V2 external users can be referenced by `unique_key`; if `unique_key` is omitted during creation, the server uses `external_user_id` as the key.
@@ -601,6 +614,12 @@ const v2ExternalVideo = await platform.createV2VideoFromImageList(
   { externalUser },
 );
 
+const v2ImageTitle = await platform.assignV2ImageTitle({
+  image_url: 'https://cdn.example.com/product-frame.png',
+  metadata: { product: 'travel shirt', channel: 'marketplace' },
+});
+console.log(v2ImageTitle.data.content);
+
 const v2Translated = await platform.translateV2Video({
   videoSessionId: v2Video.data.request_id!,
   language: 'es',

package/dist/index.d.ts

@@ -939,22 +939,6 @@ export interface RemoveBrandingFromImageResponse {
     remainingCredits?: number;
     [key: string]: unknown;
 }
-export interface ReplaceBrandingFromImageRequest {
-    image_urls: string[];
-}
-export interface ReplaceBrandingFromImageResponse {
-    status?: string;
-    message?: string;
-    request_id?: string;
-    session_id?: string;
-    global_status_id?: string;
-    case_type?: string;
-    image_urls: string[];
-    userId?: string;
-    creditsCharged?: number;
-    remainingCredits?: number;
-    [key: string]: unknown;
-}
 export interface EnhanceImageRequest {
     image_url: string;
     resolution?: '1k' | '2k' | '3k' | '4k';
@@ -975,6 +959,33 @@ export interface EnhanceImageResponse {
     remainingCredits?: number;
     [key: string]: unknown;
 }
+export type AssignImageTitleMimeType = 'image/png' | 'image/jpeg' | 'image/webp' | 'image/gif';
+export type AssignImageTitleBinaryInput = Blob | ArrayBuffer | Uint8Array;
+export interface AssignImageTitleRequest {
+    image?: string | AssignImageTitleBinaryInput;
+    file?: AssignImageTitleBinaryInput;
+    image_file?: AssignImageTitleBinaryInput;
+    imageFile?: AssignImageTitleBinaryInput;
+    image_url?: string;
+    imageUrl?: string;
+    url?: string;
+    image_data?: string;
+    imageData?: string;
+    image_data_url?: string;
+    imageDataUrl?: string;
+    metadata?: Record<string, unknown> | string;
+    metadata_json?: Record<string, unknown> | string;
+    metadataJson?: Record<string, unknown> | string;
+    fileName?: string;
+    filename?: string;
+    mimeType?: AssignImageTitleMimeType | string;
+    [key: string]: unknown;
+}
+export interface AssignImageTitleResponse {
+    content: string;
+    title?: string;
+    [key: string]: unknown;
+}
 export interface ExtendImageListRequest {
     image_urls: string[];
     num_images: number;
@@ -1839,6 +1850,18 @@ export interface CreditsRechargeResponse {
     currency: string;
     [key: string]: unknown;
 }
+export interface V2CreditsRechargeRequest {
+    credits?: number;
+    credits_to_recharge?: number;
+    creditsToRecharge?: number;
+    [key: string]: unknown;
+}
+export interface V2CreditsGrantRequest {
+    credits?: number;
+    credits_to_grant?: number;
+    creditsToGrant?: number;
+    [key: string]: unknown;
+}
 export interface EnableAutoRechargeRequest {
     thresholdCredits?: number;
     amountUsd?: number;
@@ -1943,6 +1966,8 @@ export declare class SamsarClient {
     getV2<T = Record<string, unknown>>(path: string, options?: V2RequestOptions): Promise<SamsarResult<T>>;
     createV2Session(options?: V2RequestOptions): Promise<SamsarResult<V2SessionResponse>>;
     getV2Credits(options?: V2RequestOptions): Promise<SamsarResult<CreditsBalanceResponse | ExternalCreditsBalanceResponse>>;
+    createV2CreditsRecharge(payload: number | V2CreditsRechargeRequest, options?: V2RequestOptions): Promise<SamsarResult<CreditsRechargeResponse | ExternalCreditsRechargeResponse>>;
+    grantV2Credits(payload: number | V2CreditsGrantRequest, options?: V2RequestOptions): Promise<SamsarResult<ExternalCreditsGrantResponse>>;
     getV2UserCredits(options?: V2RequestOptions): Promise<SamsarResult<CreditsBalanceResponse>>;
     getV2UserUsageLogs(options?: V2RequestOptions & {
         page?: number;
@@ -1959,6 +1984,7 @@ export declare class SamsarClient {
     refreshV2UserAppKey(payload?: V2UserAppKeyRefreshRequest, options?: V2RequestOptions): Promise<SamsarResult<V2UserAppKeyResponse>>;
     revokeV2UserAppKey(options?: V2RequestOptions): Promise<SamsarResult<V2UserAppKeyResponse>>;
     getV2UserPaymentStatus(payload: PaymentStatusRequest, options?: V2RequestOptions): Promise<SamsarResult<PaymentStatusResponse>>;
+    getV2PaymentStatus(payload: PaymentStatusRequest, options?: V2RequestOptions): Promise<SamsarResult<PaymentStatusResponse | ExternalPaymentStatusResponse>>;
     createV2LoginToken(options?: V2RequestOptions & {
         redirect?: string;
     }): Promise<SamsarResult<CreateLoginTokenResponse | ExternalCreateLoginTokenResponse>>;
@@ -1978,9 +2004,16 @@ export declare class SamsarClient {
     uploadV2ImageData(imageData: string[], options?: V2RequestOptions): Promise<SamsarResult<{
         image_urls: string[];
     }>>;
+    /**
+     * Assign a short SEO-friendly title to an image using the /v2 image route.
+     * Supports image_url/image_data JSON payloads or binary image/FormData uploads.
+     */
+    assignV2ImageTitle(payload: AssignImageTitleRequest | FormData, options?: V2RequestOptions): Promise<SamsarResult<AssignImageTitleResponse>>;
+    assignV2TitleToImage(payload: AssignImageTitleRequest | FormData, options?: V2RequestOptions): Promise<SamsarResult<AssignImageTitleResponse>>;
     updateV2VideoOutroImage(input: UpdateVideoOutroImageInput, options?: V2RequestOptions): Promise<SamsarResult<UpdateVideoOutroImageResponse | ExternalRequestResponse>>;
     updateV2VideoFooterImage(input: UpdateVideoFooterImageInput, options?: V2RequestOptions): Promise<SamsarResult<UpdateVideoFooterImageResponse | ExternalRequestResponse>>;
     addV2VideoOutroImage(input: AddVideoOutroImageInput, options?: V2RequestOptions): Promise<SamsarResult<AddVideoOutroImageResponse | ExternalRequestResponse>>;
+    joinV2Videos(input: JoinVideosInput, options?: V2RequestOptions): Promise<SamsarResult<JoinVideosResponse | ExternalRequestResponse>>;
     getV2Status(requestId: string, options?: V2RequestOptions & {
         queryParams?: QueryParams;
     }): Promise<SamsarResult<GlobalStatusResponse | ExternalStatusResponse>>;
@@ -1990,6 +2023,10 @@ export declare class SamsarClient {
     getV2DetailedStatus(requestId: string, options?: V2RequestOptions & {
         queryParams?: QueryParams;
     }): Promise<SamsarResult<GlobalStatusDetailedResponse | ExternalStatusDetailedResponse>>;
+    /**
+     * Cancel an in-progress v2 render for an existing video session.
+     */
+    cancelV2Render(input: CancelRenderInput, options?: V2RequestOptions): Promise<SamsarResult<CancelRenderResponse>>;
     /**
      * Create a new video generation job from text.
      */
@@ -2252,17 +2289,19 @@ export declare class SamsarClient {
      */
     getEmbeddingStatus(templateId: string, options?: SamsarRequestOptions): Promise<SamsarResult<EmbeddingStatusResponse>>;
     /**
-     * Remove branding/watermark from an image by URL.
+     * Remove visible text from an image by URL.
      */
     removeBrandingFromImage(payload: RemoveBrandingFromImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<RemoveBrandingFromImageResponse>>;
-    /**
-     * Replace branding/watermark on an image by providing the original and replacement image URLs.
-     */
-    replaceBrandingFromImage(payload: ReplaceBrandingFromImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<ReplaceBrandingFromImageResponse>>;
     /**
      * Enhance an image by upscaling it with the specified resolution.
      */
     enhanceImage(payload: EnhanceImageRequest, options?: SamsarRequestOptions): Promise<SamsarResult<EnhanceImageResponse>>;
+    /**
+     * Assign a short SEO-friendly title to an image.
+     * Supports image_url/image_data JSON payloads or binary image/FormData uploads.
+     */
+    assignImageTitle(payload: AssignImageTitleRequest | FormData, options?: SamsarRequestOptions): Promise<SamsarResult<AssignImageTitleResponse>>;
+    assignTitleToImage(payload: AssignImageTitleRequest | FormData, options?: SamsarRequestOptions): Promise<SamsarResult<AssignImageTitleResponse>>;
     /**
      * Add or extend a saved image list for the authenticated API key.
      */
@@ -2379,6 +2418,7 @@ export declare class SamsarClient {
     }): Promise<SamsarResult<GlobalStatusResponse>>;
     private get;
     private post;
+    private postForm;
     private request;
     private buildHeaders;
     private buildUrl;

package/dist/index.js

@@ -557,6 +557,32 @@ export class SamsarClient {
     async getV2Credits(options) {
         return this.getV2('credits', options);
     }
+    async createV2CreditsRecharge(payload, options) {
+        const input = typeof payload === 'number' ? { credits: payload } : (payload ?? {});
+        const credits = Number(input.credits ?? input.credits_to_recharge ?? input.creditsToRecharge);
+        if (!Number.isFinite(credits) || credits <= 0 || !Number.isInteger(credits)) {
+            throw new Error('credits must be a positive integer');
+        }
+        return this.postV2('credits/recharge', {
+            input: {
+                ...input,
+                credits,
+            },
+        }, options);
+    }
+    async grantV2Credits(payload, options) {
+        const input = typeof payload === 'number' ? { credits: payload } : (payload ?? {});
+        const credits = Number(input.credits ?? input.credits_to_grant ?? input.creditsToGrant);
+        if (!Number.isFinite(credits) || credits <= 0 || !Number.isInteger(credits)) {
+            throw new Error('credits must be a positive integer');
+        }
+        return this.postV2('credits/grant', {
+            input: {
+                ...input,
+                credits,
+            },
+        }, options);
+    }
     async getV2UserCredits(options) {
         return this.getV2('user/credits', options);
     }
@@ -689,6 +715,24 @@ export class SamsarClient {
             query,
         });
     }
+    async getV2PaymentStatus(payload, options) {
+        const query = {
+            ...(options?.query ?? {}),
+        };
+        if (payload?.checkoutSessionId) {
+            query.checkoutSessionId = payload.checkoutSessionId;
+        }
+        if (payload?.paymentIntentId) {
+            query.paymentIntentId = payload.paymentIntentId;
+        }
+        if (payload?.setupIntentId) {
+            query.setupIntentId = payload.setupIntentId;
+        }
+        return this.getV2('payment_status', {
+            ...(options ?? {}),
+            query,
+        });
+    }
     async createV2LoginToken(options) {
         const body = options?.redirect ? { redirect: options.redirect } : {};
         return this.postV2('create_login_token', body, options);
@@ -792,6 +836,22 @@ export class SamsarClient {
             },
         }, options);
     }
+    /**
+     * Assign a short SEO-friendly title to an image using the /v2 image route.
+     * Supports image_url/image_data JSON payloads or binary image/FormData uploads.
+     */
+    async assignV2ImageTitle(payload, options) {
+        const body = buildAssignImageTitleBody(payload);
+        if (isFormDataBody(body)) {
+            return this.postForm(this.buildV2Url('image/assign_title'), body, options);
+        }
+        return this.postV2('image/assign_title', {
+            input: body,
+        }, options);
+    }
+    async assignV2TitleToImage(payload, options) {
+        return this.assignV2ImageTitle(payload, options);
+    }
     async updateV2VideoOutroImage(input, options) {
         const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'updateV2VideoOutroImage');
         return this.postV2('update_outro_image', {
@@ -812,6 +872,22 @@ export class SamsarClient {
             webhookUrl: options?.webhookUrl,
         }, options);
     }
+    async joinV2Videos(input, options) {
+        const rawIds = input.session_ids ?? input.sessionIds ?? input.video_session_ids ?? input.videoSessionIds;
+        const sessionIds = Array.isArray(rawIds)
+            ? rawIds.map((value) => (typeof value === 'string' ? value.trim() : '')).filter(Boolean)
+            : [];
+        if (sessionIds.length < 2) {
+            throw new Error('at least two session IDs are required for joinV2Videos');
+        }
+        return this.postV2('join_videos', {
+            input: {
+                ...input,
+                session_ids: sessionIds,
+            },
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
     async getV2Status(requestId, options) {
         const queryParams = {
             ...(options?.externalUser
@@ -841,6 +917,48 @@ export class SamsarClient {
     async getV2DetailedStatus(requestId, options) {
         return this.getV2StatusDetailed(requestId, options);
     }
+    /**
+     * Cancel an in-progress v2 render for an existing video session.
+     */
+    async cancelV2Render(input, options) {
+        const raw = input;
+        const videoSessionId = raw.videoSessionId ??
+            raw.video_session_id ??
+            raw.videoSessionID ??
+            raw.session_id ??
+            raw.sessionId ??
+            raw.sessionID ??
+            raw.request_id ??
+            raw.requestId;
+        if (!videoSessionId) {
+            throw new Error('videoSessionId is required for cancelV2Render');
+        }
+        const response = await this.postV2('cancel_render', {
+            input: {
+                ...input,
+                videoSessionId: String(videoSessionId),
+            },
+        }, options);
+        const data = response.data;
+        if (data && typeof data === 'object') {
+            const sessionId = typeof data.sessionID === 'string'
+                ? data.sessionID
+                : typeof data.session_id === 'string'
+                    ? data.session_id
+                    : typeof data.request_id === 'string'
+                        ? data.request_id
+                        : undefined;
+            const normalizedSessionId = sessionId ? String(sessionId) : undefined;
+            const normalizedData = {
+                ...data,
+                sessionID: data.sessionID ?? normalizedSessionId ?? '',
+                session_id: data.session_id ?? normalizedSessionId,
+                request_id: data.request_id ?? normalizedSessionId,
+            };
+            return { ...response, data: normalizedData };
+        }
+        return response;
+    }
     /**
      * Create a new video generation job from text.
      */
@@ -1741,23 +1859,31 @@ export class SamsarClient {
         });
     }
     /**
-     * Remove branding/watermark from an image by URL.
+     * Remove visible text from an image by URL.
      */
     async removeBrandingFromImage(payload, options) {
         return this.post('image/remove_branding', payload, options);
     }
-    /**
-     * Replace branding/watermark on an image by providing the original and replacement image URLs.
-     */
-    async replaceBrandingFromImage(payload, options) {
-        return this.post('image/replace_branding', payload, options);
-    }
     /**
      * Enhance an image by upscaling it with the specified resolution.
      */
     async enhanceImage(payload, options) {
         return this.post('image/enhance', payload, options);
     }
+    /**
+     * Assign a short SEO-friendly title to an image.
+     * Supports image_url/image_data JSON payloads or binary image/FormData uploads.
+     */
+    async assignImageTitle(payload, options) {
+        const body = buildAssignImageTitleBody(payload);
+        if (isFormDataBody(body)) {
+            return this.postForm('image/assign_title', body, options);
+        }
+        return this.post('image/assign_title', body, options);
+    }
+    async assignTitleToImage(payload, options) {
+        return this.assignImageTitle(payload, options);
+    }
     /**
      * Add or extend a saved image list for the authenticated API key.
      */
@@ -2132,6 +2258,13 @@ export class SamsarClient {
             body: JSON.stringify(body),
         });
     }
+    async postForm(path, body, options) {
+        return this.request(path, {
+            ...(options ?? {}),
+            method: 'POST',
+            body,
+        });
+    }
     async request(path, options) {
         const url = this.buildUrl(path, options.query);
         const controller = new AbortController();
@@ -2221,7 +2354,7 @@ export class SamsarClient {
                 : this.apiKey
                     ? `Bearer ${this.apiKey}`
                     : undefined,
-            'Content-Type': options.body ? 'application/json' : undefined,
+            'Content-Type': options.body && !isFormDataBody(options.body) ? 'application/json' : undefined,
             'x-external-user-api-key': options.externalUserApiKey ?? this.externalUserApiKey,
             'x-app-secret': resolvedAppKey ? resolvedAppSecret : undefined,
             ...this.defaultHeaders,
@@ -2288,6 +2421,104 @@ export class SamsarClient {
 function trimTrailingSlash(url) {
     return url.replace(/\/+$/, '');
 }
+function buildAssignImageTitleBody(payload) {
+    if (isFormDataBody(payload)) {
+        return payload;
+    }
+    const input = (payload ?? {});
+    const image = input.image ??
+        input.file ??
+        input.image_file ??
+        input.imageFile;
+    if (isBinaryAssignImageTitleInput(image)) {
+        return buildAssignImageTitleFormData(input, image);
+    }
+    const stringImage = getTrimmedString(image);
+    const imageData = stringImage?.startsWith('data:image/')
+        ? stringImage
+        : getTrimmedString(input.image_data) ??
+            getTrimmedString(input.imageData) ??
+            getTrimmedString(input.image_data_url) ??
+            getTrimmedString(input.imageDataUrl);
+    const imageUrl = stringImage && !stringImage.startsWith('data:image/')
+        ? stringImage
+        : getTrimmedString(input.image_url) ??
+            getTrimmedString(input.imageUrl) ??
+            getTrimmedString(input.url);
+    const metadata = input.metadata ?? input.metadata_json ?? input.metadataJson;
+    if (!imageData && !imageUrl) {
+        throw new Error('image, image_data, or image_url is required for assignImageTitle');
+    }
+    return {
+        ...(imageData ? { image_data: imageData } : {}),
+        ...(imageUrl ? { image_url: imageUrl } : {}),
+        ...(metadata !== undefined ? { metadata } : {}),
+    };
+}
+function buildAssignImageTitleFormData(input, image) {
+    if (typeof FormData === 'undefined') {
+        throw new Error('FormData is required for binary assignImageTitle uploads');
+    }
+    const metadata = input.metadata ?? input.metadata_json ?? input.metadataJson;
+    const mimeType = getTrimmedString(input.mimeType) ?? getBlobType(image);
+    if (!mimeType || !isSupportedAssignImageTitleMimeType(mimeType)) {
+        throw new Error('mimeType must be image/png, image/jpeg, image/webp, or image/gif for binary assignImageTitle uploads');
+    }
+    const blob = toAssignImageTitleBlob(image, mimeType);
+    const fileName = getTrimmedString(input.fileName) ??
+        getTrimmedString(input.filename) ??
+        `image.${mimeTypeToExtension(mimeType)}`;
+    const formData = new FormData();
+    formData.append('image', blob, fileName);
+    if (metadata !== undefined) {
+        formData.append('metadata', typeof metadata === 'string' ? metadata : JSON.stringify(metadata));
+    }
+    return formData;
+}
+function isBinaryAssignImageTitleInput(value) {
+    return (isBlobValue(value) ||
+        value instanceof ArrayBuffer ||
+        value instanceof Uint8Array);
+}
+function toAssignImageTitleBlob(value, mimeType) {
+    if (isBlobValue(value)) {
+        if (value.type === mimeType) {
+            return value;
+        }
+        return new Blob([value], { type: mimeType });
+    }
+    if (value instanceof Uint8Array) {
+        const arrayBuffer = value.buffer.slice(value.byteOffset, value.byteOffset + value.byteLength);
+        return new Blob([arrayBuffer], { type: mimeType });
+    }
+    return new Blob([value], { type: mimeType });
+}
+function getBlobType(value) {
+    return isBlobValue(value) ? getTrimmedString(value.type) : undefined;
+}
+function isBlobValue(value) {
+    return typeof Blob !== 'undefined' && value instanceof Blob;
+}
+function isFormDataBody(body) {
+    return typeof FormData !== 'undefined' && body instanceof FormData;
+}
+function isSupportedAssignImageTitleMimeType(value) {
+    const normalized = value.trim().toLowerCase();
+    return ['image/png', 'image/jpeg', 'image/jpg', 'image/webp', 'image/gif'].includes(normalized);
+}
+function mimeTypeToExtension(value) {
+    const normalized = value.trim().toLowerCase();
+    if (normalized === 'image/jpeg' || normalized === 'image/jpg') {
+        return 'jpg';
+    }
+    if (normalized === 'image/webp') {
+        return 'webp';
+    }
+    if (normalized === 'image/gif') {
+        return 'gif';
+    }
+    return 'png';
+}
 function parseMaybeJson(value) {
     try {
         return JSON.parse(value);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "samsar-js",
-  "version": "0.48.30",
+  "version": "0.48.32",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",