samsar-js 0.48.16 → 0.48.18

package/README.md

@@ -43,6 +43,21 @@ const video = await samsar.createVideoFromText(
   { 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(
   {
@@ -91,6 +106,31 @@ await samsar.createVideoFromImageList({
   ],
 });
 
+// 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' },
+);
+
 // Translate an existing video session into another language
 const translated = await samsar.translateVideo(
   {
@@ -302,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);
 
@@ -428,9 +486,12 @@ console.log(externalLibrary.data.requests.map((request) => request.request_id));
 Video model support notes:
 - `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 {
@@ -204,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 {
@@ -316,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[];
@@ -1471,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

@@ -34,11 +34,53 @@ function resolveAliasedInputValue(raw, aliases, canonicalName) {
     }
     return hasResolved ? resolved : undefined;
 }
-function assertOptionalBoolean(value, fieldName) {
+function assertOptionalBoolean(value, fieldName, context = 'createVideoFromImageList') {
     if (value !== undefined && typeof value !== 'boolean') {
-        throw new Error(`${fieldName} must be a boolean for createVideoFromImageList`);
+        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) {
@@ -57,6 +99,8 @@ function normalizeCreateVideoFromImageListInput(input) {
         ['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']],
     ];
@@ -70,6 +114,7 @@ function normalizeCreateVideoFromImageListInput(input) {
     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) {
@@ -81,6 +126,58 @@ function normalizeCreateVideoFromImageListInput(input) {
     }
     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) {
@@ -100,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);
@@ -140,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);
@@ -477,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,
         };
@@ -669,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.16",
+  "version": "0.48.18",
   "description": "TypeScript client for the Samsar Processor API routes.",
   "type": "module",
   "main": "dist/index.js",