samsar-js 0.48.15 → 0.48.18

package/README.md

@@ -34,24 +34,99 @@ const samsar = new SamsarClient({ apiKey: process.env.SAMSAR_API_KEY! });
 const video = await samsar.createVideoFromText(
   {
     prompt: 'A drone shot of a beach at sunrise',
-    image_model: 'GPTIMAGE1',
+    image_model: 'GPTIMAGE2',
     video_model: 'RUNWAYML',
     duration: 30,
     font_key: 'Poppins',
-    enable_subtitles: false,
+    enable_subtitles: true,
   },
   { webhookUrl: 'https://example.com/webhook' },
 );
 
+// Create a text video with a generated QR outro and bottom CTA footer
+await samsar.createVideoFromText({
+  prompt: 'A boutique hotel launch reel with cinematic room details',
+  image_model: 'GPTIMAGE2',
+  video_model: 'RUNWAYML',
+  duration: 20,
+  aspect_ratio: '9:16',
+  generate_outro_image: true,
+  cta_url: 'https://example.com/book',
+  cta_text_top: 'Scan to book',
+  cta_text_bottom: 'Opening offers',
+  add_footer_animation: true,
+  footer_metadata: [{ url: 'https://example.com/book', title: 'Book your stay' }],
+});
+
 // Create a video from an image list
 const videoFromImages = await samsar.createVideoFromImageList(
   {
     image_urls: ['https://example.com/a.jpg', 'https://example.com/b.jpg'],
     prompt: 'Cinematic sequence with smooth transitions',
     metadata: { project: 'demo' },
+    video_model: 'RUNWAYML',
+    aspect_ratio: '16:9',
     language: 'en',
     font_key: 'Poppins',
-    enable_subtitles: false,
+    enable_subtitles: true,
+  },
+  { webhookUrl: 'https://example.com/webhook' },
+);
+
+// Create a video with a provided outro image
+await samsar.createVideoFromImageList({
+  image_urls: ['https://example.com/a.jpg', 'https://example.com/b.jpg'],
+  prompt: 'Product launch teaser with a clean final CTA',
+  video_model: 'KLING3.0',
+  aspect_ratio: '16:9',
+  outro_image_url: 'https://cdn.example.com/outro.png',
+  add_outro_animation: true,
+  add_outro_focus_area: true,
+  outro_focust_area: { x: 680, y: 296, width: 432, height: 432 },
+});
+
+// Create a video and generate the QR outro server-side from the input images
+await samsar.createVideoFromImageList({
+  image_urls: [
+    { image_url: 'https://example.com/a.jpg', title: 'Blue Lagoon Tour' },
+    { image_url: 'https://example.com/b.jpg', title: 'Sunset Dinner' },
+  ],
+  prompt: 'Travel offer reel with a scannable booking outro',
+  video_model: 'RUNWAYML',
+  aspect_ratio: '9:16',
+  generate_outro_image: true,
+  cta_url: 'https://example.com/book',
+  cta_text_top: 'Scan to book',
+  cta_text_bottom: 'Limited availability',
+  cta_logo: 'https://cdn.example.com/logo-white.png',
+  add_footer_animation: true,
+  footer_metadata: [
+    { url: 'https://example.com/blue-lagoon', title: 'Blue Lagoon Tour' },
+    { url: 'https://example.com/sunset-dinner', title: 'Sunset Dinner' },
+  ],
+});
+
+// Update an existing outro with a new provided outro image URL
+await samsar.updateVideoOutroImage(
+  {
+    videoSessionId: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+    outro_image_url: 'https://cdn.example.com/outro-v2.png',
+    add_outro_animation: true,
+    add_outro_focus_area: true,
+    outro_focust_area: { x: 680, y: 296, width: 432, height: 432 },
+  },
+  { webhookUrl: 'https://example.com/webhook' },
+);
+
+// Update an existing outro by generating a new QR CTA outro server-side
+await samsar.updateVideoOutroImage(
+  {
+    videoSessionId: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+    generate_outro_image: true,
+    cta_url: 'https://example.com/book',
+    cta_text_top: 'Scan to book',
+    cta_text_bottom: 'Limited availability',
+    add_outro_animation: true,
   },
   { webhookUrl: 'https://example.com/webhook' },
 );
@@ -267,6 +342,24 @@ completedSessions.data.forEach((session) => {
   console.log(session.session_id, session.langauge, session.result_url);
 });
 
+// Publish, edit, or revoke a completed session in the public publication feed (free endpoints)
+const publication = await samsar.publishPublication({
+  session_id: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+  title: 'Running shoe teaser',
+  description: 'Launch-day vertical cut',
+  tags: ['launch', 'footwear'],
+  creator_handle: 'acme',
+});
+console.log(publication.data.publication?.publication_id);
+
+await samsar.editPublication({
+  session_id: videoFromImages.data.session_id ?? videoFromImages.data.request_id!,
+  title: 'Running shoe teaser - updated',
+  tags: ['launch', 'footwear', 'campaign'],
+});
+
+await samsar.revokePublication(videoFromImages.data.session_id ?? videoFromImages.data.request_id!);
+
 // Image-specific status endpoint
 const rollupStatus = await samsar.getImageStatus(rollup.data.session_id);
 
@@ -324,7 +417,7 @@ await platform.setExternalAssistantSystemPrompt(
 // Create a render attributed to that external user
 const externalRender = await platform.createExternalVideoFromText(externalUser, {
   prompt: 'A sleek teaser for a futuristic running shoe',
-  image_model: 'GPTIMAGE1',
+  image_model: 'GPTIMAGE2',
   video_model: 'RUNWAYML',
   duration: 10,
   enable_subtitles: true,
@@ -391,9 +484,15 @@ console.log(externalLibrary.data.requests.map((request) => request.request_id));
 ```
 
 Video model support notes:
-- `createVideoFromText` image model keys include: `GPTIMAGE1`, `IMAGEN4`, `SEEDREAM`, `HUNYUAN`, `NANOBANANA2`.
-- `createVideoFromText` supports all express video models: `RUNWAYML`, `KLINGIMGTOVID3PRO`, `HAILUO`, `HAILUOPRO`, `SEEDANCEI2V`, `VEO3.1I2V`, `VEO3.1I2VFAST`, `SORA2`, `SORA2PRO`.
-- `createVideoFromImageList` uses a fixed Veo2.1 pipeline model (`VEO3.1I2V`) and does not accept a `video_model` override.
+- `createVideoFromText` image model keys include: `GPTIMAGE2`, `IMAGEN4`, `SEEDREAM`, `HUNYUAN`, `NANOBANANA2`.
+- `createVideoFromText` supports all express video models: `RUNWAYML`, `KLINGIMGTOVID3PRO`, `HAILUO`, `HAILUOPRO`, `SEEDANCEI2V` (Seedance 2.0), `VEO3.1I2V`, `VEO3.1I2VFAST`, `SORA2`, `SORA2PRO`.
+- `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 `VEO3.1I2V`, `SEEDANCEI2V`, `KLING3.0`, and `RUNWAYML` via `video_model`; if omitted, it defaults to `VEO3.1I2V`. `KLINGIMGTOVID3PRO` is also accepted as a compatibility alias for `KLING3.0`. 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.
+- `updateVideoOutroImage` accepts either a replacement outro image URL (`outro_image_url`, `outroImageUrl`, `new_outro_image_url`) or a generated QR CTA outro (`generate_outro_image: true` with `cta_url`, or just `cta_url` when no outro image URL is supplied). Generated outro updates reuse the existing session image layers for tiling and only queue frame/video regeneration.
+- `publishPublication`, `editPublication`, and `revokePublication` manage public feed publications for completed sessions through free `/publications/*` endpoints. They work with account API keys, customer sub-account API keys, and client auth tokens when the session belongs to the authenticated actor.
+- Image-list video pricing is per rendered second: `VEO3.1I2V` and `SEEDANCEI2V` are 75 credits/sec, `KLING3.0` is 50 credits/sec, and `RUNWAYML` is 25 credits/sec.
 
 Each method returns `{ data, status, headers, creditsCharged, creditsRemaining, raw }`. Non-2xx responses throw `SamsarRequestError` containing status, body, and credit headers (if present).
 

package/dist/index.d.ts

@@ -50,6 +50,30 @@ export interface CreateVideoFromTextInput {
     session_id?: string;
     sessionId?: string;
     sessionID?: string;
+    outro_image_url?: string;
+    outroImageUrl?: string;
+    add_outro_animation?: boolean;
+    addOutroAnimation?: boolean;
+    add_outro_focus_area?: boolean;
+    addOutroFocusArea?: boolean;
+    outro_focust_area?: OutroFocusArea | null;
+    outro_focus_area?: OutroFocusArea | null;
+    outroFocustArea?: OutroFocusArea | null;
+    outroFocusArea?: OutroFocusArea | null;
+    generate_outro_image?: boolean;
+    generateOutroImage?: boolean;
+    cta_url?: string;
+    ctaUrl?: string;
+    cta_text_top?: string;
+    ctaTextTop?: string;
+    cta_text_bottom?: string;
+    ctaTextBottom?: string;
+    cta_logo?: string;
+    ctaLogo?: string;
+    add_footer_animation?: boolean;
+    addFooterAnimation?: boolean;
+    footer_metadata?: FooterMetadataItem[];
+    footerMetadata?: FooterMetadataItem[];
     [key: string]: unknown;
 }
 export interface CreateVideoResponse {
@@ -64,6 +88,12 @@ export interface OutroFocusArea {
     width: number;
     height: number;
 }
+export interface FooterMetadataItem {
+    url: string;
+    title?: string;
+}
+export type ImageListToVideoAspectRatio = '16:9' | '9:16';
+export type ImageListToVideoModel = 'VEO3.1I2V' | 'SEEDANCEI2V' | 'KLING3.0' | 'KLINGIMGTOVID3PRO' | 'RUNWAYML';
 export interface ImageListToVideoItem {
     image_url?: string;
     imageUrl?: string;
@@ -79,12 +109,25 @@ export interface ImageListToVideoItem {
     fromEnhancedList?: boolean;
     skip_enhancement?: boolean;
     skipEnhancement?: boolean;
+    source?: string;
+    title?: string;
+    image_title?: string;
+    imageTitle?: string;
+    image_text?: string;
+    imageText?: string;
+    activity_title?: string;
+    activityTitle?: string;
+    name?: string;
+    label?: string;
     [key: string]: unknown;
 }
 export interface CreateVideoFromImageListInput {
     image_urls: Array<string | ImageListToVideoItem>;
     metadata?: Record<string, unknown>;
     prompt?: string;
+    video_model?: ImageListToVideoModel;
+    aspect_ratio?: ImageListToVideoAspectRatio;
+    aspectRatio?: ImageListToVideoAspectRatio;
     language?: string;
     languageString?: string | null;
     font_key?: string;
@@ -98,9 +141,29 @@ export interface CreateVideoFromImageListInput {
     sessionId?: string;
     sessionID?: string;
     outro_image_url?: string;
+    outroImageUrl?: string;
     add_outro_animation?: boolean;
+    addOutroAnimation?: boolean;
     add_outro_focus_area?: boolean;
+    addOutroFocusArea?: boolean;
     outro_focust_area?: OutroFocusArea | null;
+    outro_focus_area?: OutroFocusArea | null;
+    outroFocustArea?: OutroFocusArea | null;
+    outroFocusArea?: OutroFocusArea | null;
+    generate_outro_image?: boolean;
+    generateOutroImage?: boolean;
+    cta_url?: string;
+    ctaUrl?: string;
+    cta_text_top?: string;
+    ctaTextTop?: string;
+    cta_text_bottom?: string;
+    ctaTextBottom?: string;
+    cta_logo?: string;
+    ctaLogo?: string;
+    add_footer_animation?: boolean;
+    addFooterAnimation?: boolean;
+    footer_metadata?: FooterMetadataItem[];
+    footerMetadata?: FooterMetadataItem[];
     [key: string]: unknown;
 }
 export interface TranscriptBuilderPayload {
@@ -165,6 +228,24 @@ export interface UpdateVideoOutroImageInput {
     outroImageUrl?: string;
     new_outro_image_url?: string;
     newOutroImageUrl?: string;
+    add_outro_animation?: boolean;
+    addOutroAnimation?: boolean;
+    add_outro_focus_area?: boolean;
+    addOutroFocusArea?: boolean;
+    outro_focust_area?: OutroFocusArea | null;
+    outro_focus_area?: OutroFocusArea | null;
+    outroFocustArea?: OutroFocusArea | null;
+    outroFocusArea?: OutroFocusArea | null;
+    generate_outro_image?: boolean;
+    generateOutroImage?: boolean;
+    cta_url?: string;
+    ctaUrl?: string;
+    cta_text_top?: string;
+    ctaTextTop?: string;
+    cta_text_bottom?: string;
+    ctaTextBottom?: string;
+    cta_logo?: string;
+    ctaLogo?: string;
     [key: string]: unknown;
 }
 export interface UpdateVideoOutroImageResponse {
@@ -277,6 +358,96 @@ export interface CompletedVideoSession {
     [key: string]: unknown;
 }
 export type ListCompletedVideoSessionsResponse = CompletedVideoSession[];
+export interface SessionPublicationInput {
+    session_id?: string;
+    sessionId?: string;
+    sessionID?: string;
+    video_session_id?: string;
+    videoSessionId?: string;
+    videoSessionID?: string;
+    id?: string;
+    title?: string;
+    description?: string;
+    tags?: string[] | string;
+    aspect_ratio?: string;
+    aspectRatio?: string;
+    creator_handle?: string;
+    creatorHandle?: string;
+    slug?: string;
+    image_hash?: string;
+    imageHash?: string;
+    splash_image?: string;
+    splashImage?: string;
+    image_model?: string;
+    imageModel?: string;
+    video_model?: string;
+    videoModel?: string;
+    original_prompt?: string;
+    originalPrompt?: string;
+    prompt?: string;
+    session_language?: string;
+    sessionLanguage?: string;
+    language?: string;
+    language_code?: string;
+    languageString?: string;
+    language_string?: string;
+    [key: string]: unknown;
+}
+export interface SessionPublicationSummary {
+    id?: string | null;
+    publication_id?: string | null;
+    session_id?: string | null;
+    sessionId?: string | null;
+    video_url?: string | null;
+    videoUrl?: string | null;
+    title?: string | null;
+    description?: string;
+    tags?: string[];
+    creator_handle?: string;
+    creatorHandle?: string;
+    slug?: string | null;
+    image_hash?: string | null;
+    imageHash?: string | null;
+    splash_image?: string | null;
+    splashImage?: string | null;
+    image_model?: string | null;
+    imageModel?: string | null;
+    video_model?: string | null;
+    videoModel?: string | null;
+    original_prompt?: string;
+    originalPrompt?: string;
+    session_language?: string | null;
+    sessionLanguage?: string | null;
+    language_string?: string | null;
+    languageString?: string | null;
+    aspect_ratio?: string | null;
+    aspectRatio?: string | null;
+    created_at?: string | null;
+    createdAt?: string | null;
+    updated_at?: string | null;
+    updatedAt?: string | null;
+    [key: string]: unknown;
+}
+export interface SessionPublicationSessionSummary {
+    id?: string | null;
+    session_id?: string | null;
+    is_published?: boolean;
+    published_publication_id?: string | null;
+    published_video_url?: string | null;
+    published_at?: string | null;
+    [key: string]: unknown;
+}
+export interface SessionPublicationResponse {
+    created?: boolean;
+    revoked?: boolean;
+    publication_id?: string | null;
+    publication?: SessionPublicationSummary | null;
+    session?: SessionPublicationSessionSummary | null;
+    sessionId?: string;
+    session_id?: string;
+    ispublishedVideo?: boolean;
+    [key: string]: unknown;
+}
 export interface SupportedTextToVideoModelsResponse {
     IMAGE_MODELS: SupportedTextToVideoModelOption[];
     VIDEO_MODELS: SupportedTextToVideoModelOption[];
@@ -1432,6 +1603,33 @@ export declare class SamsarClient {
     listCompletedVideoSessions(options?: SamsarRequestOptions & {
         limit?: number;
     }): Promise<SamsarResult<ListCompletedVideoSessionsResponse>>;
+    /**
+     * Publish a completed Samsar video session to the public publication feed.
+     * This is a free endpoint. The session must belong to the authenticated API key/auth token.
+     */
+    publishPublication(input: string | SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
+    /**
+     * Alias for publishPublication, named around the underlying VideoSession resource.
+     */
+    publishSessionPublication(input: string | SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
+    /**
+     * Edit an existing publication for a Samsar video session.
+     * Omitted fields keep their current publication values.
+     */
+    editPublication(input: SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
+    /**
+     * Alias for editPublication, named around the underlying VideoSession resource.
+     */
+    editSessionPublication(input: SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
+    /**
+     * Revoke a publication for a Samsar video session.
+     * This deletes the publication record and clears published fields on the session.
+     */
+    revokePublication(input: string | SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
+    /**
+     * Alias for revokePublication, named around the underlying VideoSession resource.
+     */
+    revokeSessionPublication(input: string | SessionPublicationInput, options?: SamsarRequestOptions): Promise<SamsarResult<SessionPublicationResponse>>;
     /**
      * Fetch the supported image/video model keys for the text_to_video route.
      * Maps to GET /video/supported_models.

package/dist/index.js

@@ -15,6 +15,169 @@ export class SamsarRequestError extends Error {
         this.creditsRemaining = init.creditsRemaining;
     }
 }
+function resolveAliasedInputValue(raw, aliases, canonicalName) {
+    let resolved;
+    let hasResolved = false;
+    for (const alias of aliases) {
+        const value = raw[alias];
+        if (value === undefined) {
+            continue;
+        }
+        if (!hasResolved) {
+            resolved = value;
+            hasResolved = true;
+            continue;
+        }
+        if (value !== resolved) {
+            throw new Error(`${canonicalName} was provided with conflicting alias values.`);
+        }
+    }
+    return hasResolved ? resolved : undefined;
+}
+function assertOptionalBoolean(value, fieldName, context = 'createVideoFromImageList') {
+    if (value !== undefined && typeof value !== 'boolean') {
+        throw new Error(`${fieldName} must be a boolean for ${context}`);
+    }
+}
+function normalizeCreateVideoFromTextInput(input) {
+    const raw = input;
+    const normalized = { ...input };
+    const aliases = [
+        ['session_id', ['session_id', 'sessionId', 'sessionID']],
+        ['aspect_ratio', ['aspect_ratio', 'aspectRatio']],
+        ['outro_image_url', ['outro_image_url', 'outroImageUrl']],
+        ['add_outro_animation', ['add_outro_animation', 'addOutroAnimation']],
+        ['add_outro_focus_area', ['add_outro_focus_area', 'addOutroFocusArea']],
+        ['outro_focust_area', ['outro_focust_area', 'outro_focus_area', 'outroFocustArea', 'outroFocusArea']],
+        ['generate_outro_image', ['generate_outro_image', 'generateOutroImage']],
+        ['cta_url', ['cta_url', 'ctaUrl']],
+        ['cta_text_top', ['cta_text_top', 'ctaTextTop']],
+        ['cta_text_bottom', ['cta_text_bottom', 'ctaTextBottom']],
+        ['cta_logo', ['cta_logo', 'ctaLogo']],
+        ['add_footer_animation', ['add_footer_animation', 'addFooterAnimation']],
+        ['footer_metadata', ['footer_metadata', 'footerMetadata']],
+        ['enable_subtitles', ['enable_subtitles', 'enableSubtitles']],
+        ['font_key', ['font_key', 'fontKey']],
+    ];
+    for (const [canonicalName, aliasList] of aliases) {
+        const value = resolveAliasedInputValue(raw, aliasList, canonicalName);
+        if (value !== undefined) {
+            normalized[canonicalName] = value;
+        }
+    }
+    assertOptionalBoolean(normalized.enable_subtitles, 'enable_subtitles', 'createVideoFromText');
+    assertOptionalBoolean(normalized.add_outro_animation, 'add_outro_animation', 'createVideoFromText');
+    assertOptionalBoolean(normalized.add_outro_focus_area, 'add_outro_focus_area', 'createVideoFromText');
+    assertOptionalBoolean(normalized.generate_outro_image, 'generate_outro_image', 'createVideoFromText');
+    assertOptionalBoolean(normalized.add_footer_animation, 'add_footer_animation', 'createVideoFromText');
+    if (normalized.generate_outro_image === true) {
+        const ctaUrl = typeof normalized.cta_url === 'string' ? normalized.cta_url.trim() : '';
+        if (!ctaUrl) {
+            throw new Error('cta_url is required when generate_outro_image is true for createVideoFromText');
+        }
+    }
+    else if (normalized.add_outro_focus_area === true && normalized.add_outro_animation !== true) {
+        throw new Error('add_outro_focus_area requires add_outro_animation to be true for createVideoFromText');
+    }
+    return normalized;
+}
+function normalizeCreateVideoFromImageListInput(input) {
+    const raw = input;
+    if (!Array.isArray(input.image_urls) || input.image_urls.length === 0) {
+        throw new Error('image_urls must be a non-empty array for createVideoFromImageList');
+    }
+    const normalized = { ...input };
+    const aliases = [
+        ['session_id', ['session_id', 'sessionId', 'sessionID']],
+        ['aspect_ratio', ['aspect_ratio', 'aspectRatio']],
+        ['outro_image_url', ['outro_image_url', 'outroImageUrl']],
+        ['add_outro_animation', ['add_outro_animation', 'addOutroAnimation']],
+        ['add_outro_focus_area', ['add_outro_focus_area', 'addOutroFocusArea']],
+        ['outro_focust_area', ['outro_focust_area', 'outro_focus_area', 'outroFocustArea', 'outroFocusArea']],
+        ['generate_outro_image', ['generate_outro_image', 'generateOutroImage']],
+        ['cta_url', ['cta_url', 'ctaUrl']],
+        ['cta_text_top', ['cta_text_top', 'ctaTextTop']],
+        ['cta_text_bottom', ['cta_text_bottom', 'ctaTextBottom']],
+        ['cta_logo', ['cta_logo', 'ctaLogo']],
+        ['add_footer_animation', ['add_footer_animation', 'addFooterAnimation']],
+        ['footer_metadata', ['footer_metadata', 'footerMetadata']],
+        ['enable_subtitles', ['enable_subtitles', 'enableSubtitles']],
+        ['font_key', ['font_key', 'fontKey']],
+    ];
+    for (const [canonicalName, aliasList] of aliases) {
+        const value = resolveAliasedInputValue(raw, aliasList, canonicalName);
+        if (value !== undefined) {
+            normalized[canonicalName] = value;
+        }
+    }
+    assertOptionalBoolean(normalized.enable_subtitles, 'enable_subtitles');
+    assertOptionalBoolean(normalized.add_outro_animation, 'add_outro_animation');
+    assertOptionalBoolean(normalized.add_outro_focus_area, 'add_outro_focus_area');
+    assertOptionalBoolean(normalized.generate_outro_image, 'generate_outro_image');
+    assertOptionalBoolean(normalized.add_footer_animation, 'add_footer_animation');
+    if (normalized.generate_outro_image === true) {
+        const ctaUrl = typeof normalized.cta_url === 'string' ? normalized.cta_url.trim() : '';
+        if (!ctaUrl) {
+            throw new Error('cta_url is required when generate_outro_image is true for createVideoFromImageList');
+        }
+    }
+    else if (normalized.add_outro_focus_area === true && normalized.add_outro_animation !== true) {
+        throw new Error('add_outro_focus_area requires add_outro_animation to be true for createVideoFromImageList');
+    }
+    return normalized;
+}
+function normalizeSessionPublicationInput(input, context) {
+    if (typeof input !== 'string' && (!input || typeof input !== 'object' || Array.isArray(input))) {
+        throw new Error(`input must be a session id or object for ${context}`);
+    }
+    const raw = typeof input === 'string' ? { session_id: input } : { ...input };
+    const sessionId = resolveAliasedInputValue(raw, [
+        'session_id',
+        'sessionId',
+        'sessionID',
+        'video_session_id',
+        'videoSessionId',
+        'videoSessionID',
+        'id',
+    ], 'session_id');
+    const normalizedSessionId = typeof sessionId === 'string' ? sessionId.trim() : '';
+    if (!normalizedSessionId) {
+        throw new Error(`session_id is required for ${context}`);
+    }
+    const normalized = {
+        ...raw,
+        session_id: normalizedSessionId,
+    };
+    const aliases = [
+        ['aspect_ratio', ['aspect_ratio', 'aspectRatio']],
+        ['creator_handle', ['creator_handle', 'creatorHandle']],
+        ['image_hash', ['image_hash', 'imageHash']],
+        ['splash_image', ['splash_image', 'splashImage']],
+        ['image_model', ['image_model', 'imageModel']],
+        ['video_model', ['video_model', 'videoModel']],
+        ['original_prompt', ['original_prompt', 'originalPrompt', 'prompt']],
+        ['session_language', ['session_language', 'sessionLanguage', 'language', 'language_code']],
+        ['language_string', ['language_string', 'languageString']],
+    ];
+    for (const [canonicalName, aliasList] of aliases) {
+        const value = resolveAliasedInputValue(raw, aliasList, canonicalName);
+        if (value !== undefined) {
+            normalized[canonicalName] = value;
+        }
+    }
+    if (normalized.tags !== undefined &&
+        !Array.isArray(normalized.tags) &&
+        typeof normalized.tags !== 'string') {
+        throw new Error(`tags must be a string or string array for ${context}`);
+    }
+    if (Array.isArray(normalized.tags)) {
+        normalized.tags = normalized.tags
+            .filter((tag) => typeof tag === 'string')
+            .map((tag) => tag.trim())
+            .filter(Boolean);
+    }
+    return normalized;
+}
 export class SamsarClient {
     constructor(options) {
         if (!options?.apiKey) {
@@ -34,8 +197,9 @@ export class SamsarClient {
      * Create a new video generation job from text.
      */
     async createVideoFromText(input, options) {
+        const normalizedInput = normalizeCreateVideoFromTextInput(input);
         const body = {
-            input,
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         return this.post('video/create', body, options);
@@ -44,8 +208,9 @@ export class SamsarClient {
      * Create a video from a list of image URLs with optional prompt/metadata via the image_list_to_video route.
      */
     async createVideoFromImageList(input, options) {
+        const normalizedInput = normalizeCreateVideoFromImageListInput(input);
         const body = {
-            input,
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         const response = await this.post('video/image_list_to_video', body, options);
@@ -73,9 +238,10 @@ export class SamsarClient {
      * Create a text-to-video request attributed to an external user while billing against the shared API key.
      */
     async createExternalVideoFromText(externalUser, input, options) {
+        const normalizedInput = normalizeCreateVideoFromTextInput(input);
         const body = {
             external_user: normalizeExternalUserIdentity(externalUser),
-            input,
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         return this.post('external_users/text_to_video', body, options);
@@ -99,9 +265,10 @@ export class SamsarClient {
      * Create an image-list-to-video request attributed to an external user while billing against the shared API key.
      */
     async createExternalVideoFromImageList(externalUser, input, options) {
+        const normalizedInput = normalizeCreateVideoFromImageListInput(input);
         const body = {
             external_user: normalizeExternalUserIdentity(externalUser),
-            input,
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         return this.post('external_users/image_list_to_video', body, options);
@@ -409,17 +576,75 @@ export class SamsarClient {
             raw.outroImageUrl ??
             raw.new_outro_image_url ??
             raw.newOutroImageUrl;
+        const rawGenerateOutroImage = raw.generate_outro_image ??
+            raw.generateOutroImage;
+        const rawAddOutroAnimation = raw.add_outro_animation ??
+            raw.addOutroAnimation;
+        const rawAddOutroFocusArea = raw.add_outro_focus_area ??
+            raw.addOutroFocusArea;
+        const rawOutroFocusArea = raw.outro_focust_area ??
+            raw.outro_focus_area ??
+            raw.outroFocustArea ??
+            raw.outroFocusArea;
+        const ctaUrl = raw.cta_url ??
+            raw.ctaUrl;
+        const ctaTextTop = raw.cta_text_top ??
+            raw.ctaTextTop;
+        const ctaTextBottom = raw.cta_text_bottom ??
+            raw.ctaTextBottom;
+        const ctaLogo = raw.cta_logo ??
+            raw.ctaLogo;
+        const generateOutroImage = rawGenerateOutroImage === true ||
+            (rawGenerateOutroImage === undefined && !outroImageUrl && Boolean(ctaUrl));
         if (!videoSessionId) {
             throw new Error('videoSessionId is required for updateVideoOutroImage');
         }
-        if (!outroImageUrl) {
-            throw new Error('outro_image_url is required for updateVideoOutroImage');
+        if (rawGenerateOutroImage !== undefined && typeof rawGenerateOutroImage !== 'boolean') {
+            throw new Error('generate_outro_image must be a boolean for updateVideoOutroImage');
+        }
+        if (rawAddOutroAnimation !== undefined && typeof rawAddOutroAnimation !== 'boolean') {
+            throw new Error('add_outro_animation must be a boolean for updateVideoOutroImage');
+        }
+        if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
+            throw new Error('add_outro_focus_area must be a boolean for updateVideoOutroImage');
+        }
+        if (generateOutroImage && outroImageUrl) {
+            throw new Error('Use either generate_outro_image with cta_url or outro_image_url for updateVideoOutroImage');
+        }
+        if (!generateOutroImage && !outroImageUrl) {
+            throw new Error('outro_image_url is required for updateVideoOutroImage unless generate_outro_image is true');
+        }
+        if (generateOutroImage) {
+            if (!ctaUrl || !String(ctaUrl).trim()) {
+                throw new Error('cta_url is required when generate_outro_image is true for updateVideoOutroImage');
+            }
+        }
+        else if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
+            throw new Error('add_outro_focus_area requires add_outro_animation to be true for updateVideoOutroImage');
+        }
+        if (!generateOutroImage && rawAddOutroFocusArea === true) {
+            if (!rawOutroFocusArea || typeof rawOutroFocusArea !== 'object' || Array.isArray(rawOutroFocusArea)) {
+                throw new Error('outro_focust_area must be an object with x, y, width, height for updateVideoOutroImage');
+            }
+            const { x, y, width, height } = rawOutroFocusArea;
+            const isInvalid = [x, y, width, height].some((value) => typeof value !== 'number' || !Number.isFinite(value));
+            if (isInvalid) {
+                throw new Error('outro_focust_area x, y, width, height must be valid numbers for updateVideoOutroImage');
+            }
         }
         const body = {
             input: {
                 ...input,
                 videoSessionId: String(videoSessionId),
-                outro_image_url: String(outroImageUrl),
+                ...(outroImageUrl ? { outro_image_url: String(outroImageUrl) } : {}),
+                generate_outro_image: generateOutroImage,
+                ...(generateOutroImage ? { cta_url: String(ctaUrl).trim() } : {}),
+                ...(ctaTextTop ? { cta_text_top: String(ctaTextTop) } : {}),
+                ...(ctaTextBottom ? { cta_text_bottom: String(ctaTextBottom) } : {}),
+                ...(ctaLogo ? { cta_logo: String(ctaLogo) } : {}),
+                ...(rawAddOutroAnimation !== undefined ? { add_outro_animation: rawAddOutroAnimation === true } : {}),
+                ...(rawAddOutroFocusArea !== undefined ? { add_outro_focus_area: rawAddOutroFocusArea === true } : {}),
+                ...(rawOutroFocusArea !== undefined ? { outro_focust_area: rawOutroFocusArea } : {}),
             },
             webhookUrl: options?.webhookUrl,
         };
@@ -601,6 +826,48 @@ export class SamsarClient {
             data: normalizedData,
         };
     }
+    /**
+     * Publish a completed Samsar video session to the public publication feed.
+     * This is a free endpoint. The session must belong to the authenticated API key/auth token.
+     */
+    async publishPublication(input, options) {
+        const payload = normalizeSessionPublicationInput(input, 'publishPublication');
+        return this.post('publications/publish', payload, options);
+    }
+    /**
+     * Alias for publishPublication, named around the underlying VideoSession resource.
+     */
+    async publishSessionPublication(input, options) {
+        return this.publishPublication(input, options);
+    }
+    /**
+     * Edit an existing publication for a Samsar video session.
+     * Omitted fields keep their current publication values.
+     */
+    async editPublication(input, options) {
+        const payload = normalizeSessionPublicationInput(input, 'editPublication');
+        return this.post('publications/edit', payload, options);
+    }
+    /**
+     * Alias for editPublication, named around the underlying VideoSession resource.
+     */
+    async editSessionPublication(input, options) {
+        return this.editPublication(input, options);
+    }
+    /**
+     * Revoke a publication for a Samsar video session.
+     * This deletes the publication record and clears published fields on the session.
+     */
+    async revokePublication(input, options) {
+        const payload = normalizeSessionPublicationInput(input, 'revokePublication');
+        return this.post('publications/revoke', payload, options);
+    }
+    /**
+     * Alias for revokePublication, named around the underlying VideoSession resource.
+     */
+    async revokeSessionPublication(input, options) {
+        return this.revokePublication(input, options);
+    }
     /**
      * Fetch the supported image/video model keys for the text_to_video route.
      * Maps to GET /video/supported_models.

package/package.json

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