samsar-js 0.48.16 → 0.48.19

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);
 
@@ -365,6 +423,20 @@ const externalRender = await platform.createExternalVideoFromText(externalUser,
   enable_subtitles: true,
 });
 
+// Update an external user's existing outro by generating a new QR CTA outro
+const externalOutroUpdate = await platform.updateExternalVideoOutroImage(externalUser, {
+  request_id: externalRender.data.request_id,
+  generate_outro_image: true,
+  cta_url: 'https://example.com/shop',
+  cta_text_top: 'Scan to shop',
+  cta_text_bottom: 'Limited drop',
+  add_outro_animation: true,
+});
+console.log(externalOutroUpdate.data.request_id);
+
+// Repeated video routes accept the returned extreq_ id or the normalized external id.
+// The API resolves ownership through external request mappings and GlobalSession records.
+
 // Run an assistant completion against one of that external user's sessions.
 // Credits are deducted from the external user, while the owning Samsar account model config is used internally.
 const externalAssistant = await platform.createExternalAssistantCompletion(
@@ -428,11 +500,41 @@ 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.
+- Main video methods and external-user methods accept the same generated outro and footer parameters. The API can resolve either internal session ids or external `extreq_...` ids on repeated video routes, so client code can keep using `translateVideo`, `joinVideos`, `addVideoOutroImage`, and `updateVideoOutroImage`; the explicit external variants are available when you want to call `/external_users/*` directly. Do not strip the `extreq_` prefix.
+- `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.
 
+Upcoming `/v2` omni route adapters:
+- `/v2` is additive; `/v1` is not deprecated.
+- `createV2VideoFromText`, `createV2VideoFromImageList`, `updateV2VideoOutroImage`, `addV2VideoOutroImage`, `getV2Status`, `getV2Credits`, `listV2Requests`, and `createV2Session` call the new omni route surface.
+- 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.
+
+```ts
+const v2Video = await platform.createV2VideoFromImageList({
+  image_urls: ['https://cdn.example.com/a.png', 'https://cdn.example.com/b.png'],
+  video_model: 'RUNWAYML',
+  generate_outro_image: true,
+  cta_url: 'https://example.com/book',
+  cta_text_top: 'Scan to book',
+});
+
+const v2ExternalVideo = await platform.createV2VideoFromImageList(
+  {
+    image_urls: ['https://cdn.example.com/a.png', 'https://cdn.example.com/b.png'],
+    video_model: 'KLING3.0',
+  },
+  { externalUser },
+);
+
+const v2Status = await platform.getV2Status(v2Video.data.request_id!);
+console.log(v2Status.data.status);
+```
+
 Each method returns `{ data, status, headers, creditsCharged, creditsRemaining, raw }`. Non-2xx responses throw `SamsarRequestError` containing status, body, and credit headers (if present).
 
 ## Billing notes

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 {
@@ -200,10 +224,34 @@ export interface UpdateVideoOutroImageInput {
     sessionID?: string;
     request_id?: string;
     requestId?: string;
+    source_request_id?: string;
+    sourceRequestId?: string;
+    external_request_id?: string;
+    externalRequestId?: string;
+    external_session_id?: string;
+    externalSessionId?: string;
     outro_image_url?: string;
     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 {
@@ -223,6 +271,12 @@ export interface AddVideoOutroImageInput {
     sessionID?: string;
     request_id?: string;
     requestId?: string;
+    source_request_id?: string;
+    sourceRequestId?: string;
+    external_request_id?: string;
+    externalRequestId?: string;
+    external_session_id?: string;
+    externalSessionId?: string;
     outro_image_url?: string;
     outroImageUrl?: string;
     new_outro_image_url?: string;
@@ -316,6 +370,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[];
@@ -1162,6 +1306,34 @@ export interface ExternalRequestsListResponse {
     externalUser?: ExternalUserSummary | null;
     [key: string]: unknown;
 }
+export interface V2RequestOptions extends SamsarRequestOptions {
+    externalUser?: ExternalUserIdentity | null;
+    webhookUrl?: string;
+}
+export interface V2SessionResponse {
+    account_type?: 'internal' | 'external' | string;
+    auth_type?: string;
+    user?: {
+        id?: string;
+        email?: string | null;
+        displayName?: string | null;
+        username?: string | null;
+        pfpUrl?: string | null;
+        preferredLanguage?: string | null;
+        [key: string]: unknown;
+    };
+    external_api_key?: string | null;
+    external_user?: ExternalUserSummary | null;
+    externalUser?: ExternalUserSummary | null;
+    remainingCredits?: number | null;
+    [key: string]: unknown;
+}
+export interface V2RequestsListResponse {
+    requests: Array<ExternalRequestSummary | Record<string, unknown>>;
+    external_user?: ExternalUserSummary | null;
+    externalUser?: ExternalUserSummary | null;
+    [key: string]: unknown;
+}
 export interface ExternalArchiveResponse {
     request?: ExternalRequestSummary | null;
     external_user?: ExternalUserSummary | null;
@@ -1351,6 +1523,32 @@ export declare class SamsarClient {
     private readonly defaultHeaders;
     private readonly externalUserApiKey?;
     constructor(options: SamsarClientOptions);
+    /**
+     * Low-level POST adapter for the upcoming /v2 omni routes.
+     * Pass options.externalUser to include an external_user payload; omit it for internal-account calls
+     * or when authenticating directly with an external-user auth token/API key.
+     */
+    postV2<T = Record<string, unknown>>(path: string, payload?: Record<string, unknown>, options?: V2RequestOptions): Promise<SamsarResult<T>>;
+    /**
+     * Low-level GET adapter for the upcoming /v2 omni routes.
+     */
+    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>>;
+    listV2Requests(options?: V2RequestOptions): Promise<SamsarResult<V2RequestsListResponse>>;
+    createV2LoginToken(options?: V2RequestOptions & {
+        redirect?: string;
+    }): Promise<SamsarResult<CreateLoginTokenResponse | ExternalCreateLoginTokenResponse>>;
+    createV2VideoFromText(input: CreateVideoFromTextInput, options?: V2RequestOptions): Promise<SamsarResult<CreateVideoResponse | ExternalRequestResponse>>;
+    createV2VideoFromImageList(input: CreateVideoFromImageListInput, options?: V2RequestOptions): Promise<SamsarResult<CreateVideoFromImageListResponse | ExternalRequestResponse>>;
+    uploadV2ImageData(imageData: string[], options?: V2RequestOptions): Promise<SamsarResult<{
+        image_urls: string[];
+    }>>;
+    updateV2VideoOutroImage(input: UpdateVideoOutroImageInput, options?: V2RequestOptions): Promise<SamsarResult<UpdateVideoOutroImageResponse | ExternalRequestResponse>>;
+    addV2VideoOutroImage(input: AddVideoOutroImageInput, options?: V2RequestOptions): Promise<SamsarResult<AddVideoOutroImageResponse | ExternalRequestResponse>>;
+    getV2Status(requestId: string, options?: V2RequestOptions & {
+        queryParams?: QueryParams;
+    }): Promise<SamsarResult<GlobalStatusResponse | ExternalStatusResponse>>;
     /**
      * Create a new video generation job from text.
      */
@@ -1452,6 +1650,13 @@ export declare class SamsarClient {
     updateVideoOutroImage(input: UpdateVideoOutroImageInput, options?: {
         webhookUrl?: string;
     } & SamsarRequestOptions): Promise<SamsarResult<UpdateVideoOutroImageResponse>>;
+    /**
+     * Update the outro image for an external-user video request by resolving the external request id
+     * through /external_users/update_outro_image.
+     */
+    updateExternalVideoOutroImage(externalUser: ExternalUserIdentity, input: UpdateVideoOutroImageInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<ExternalRequestResponse>>;
     /**
      * Add or replace the outro image for an existing video session by cloning it into a new session and
      * re-running frame/video generation.
@@ -1459,6 +1664,12 @@ export declare class SamsarClient {
     addVideoOutroImage(input: AddVideoOutroImageInput, options?: {
         webhookUrl?: string;
     } & SamsarRequestOptions): Promise<SamsarResult<AddVideoOutroImageResponse>>;
+    /**
+     * Add or replace an outro image for an external-user video request by resolving the external request id.
+     */
+    addExternalVideoOutroImage(externalUser: ExternalUserIdentity, input: AddVideoOutroImageInput, options?: {
+        webhookUrl?: string;
+    } & SamsarRequestOptions): Promise<SamsarResult<ExternalRequestResponse>>;
     /**
      * Fetch the latest available render URL for a given video session id.
      * Maps to GET /video/fetch_latest_version?session_id={sessionId}.
@@ -1471,6 +1682,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.
@@ -1667,5 +1905,7 @@ export declare class SamsarClient {
     private buildHeaders;
     private buildUrl;
     private buildRootUrl;
+    private withV2ExternalUser;
+    private buildV2Url;
 }
 export default SamsarClient;

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,148 @@ function normalizeCreateVideoFromImageListInput(input) {
     }
     return normalized;
 }
+function normalizeUpdateVideoOutroImageInput(input, context = 'updateVideoOutroImage') {
+    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 ??
+        raw.source_request_id ??
+        raw.sourceRequestId ??
+        raw.external_request_id ??
+        raw.externalRequestId ??
+        raw.external_session_id ??
+        raw.externalSessionId;
+    const outroImageUrl = raw.outro_image_url ??
+        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 ${context}`);
+    }
+    if (rawGenerateOutroImage !== undefined && typeof rawGenerateOutroImage !== 'boolean') {
+        throw new Error(`generate_outro_image must be a boolean for ${context}`);
+    }
+    if (rawAddOutroAnimation !== undefined && typeof rawAddOutroAnimation !== 'boolean') {
+        throw new Error(`add_outro_animation must be a boolean for ${context}`);
+    }
+    if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
+        throw new Error(`add_outro_focus_area must be a boolean for ${context}`);
+    }
+    if (generateOutroImage && outroImageUrl) {
+        throw new Error(`Use either generate_outro_image with cta_url or outro_image_url for ${context}`);
+    }
+    if (!generateOutroImage && !outroImageUrl) {
+        throw new Error(`outro_image_url is required for ${context} 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 ${context}`);
+        }
+    }
+    else if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
+        throw new Error(`add_outro_focus_area requires add_outro_animation to be true for ${context}`);
+    }
+    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 ${context}`);
+        }
+        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 ${context}`);
+        }
+    }
+    return {
+        ...input,
+        videoSessionId: String(videoSessionId),
+        ...(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 } : {}),
+    };
+}
+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) {
@@ -96,12 +283,92 @@ export class SamsarClient {
             throw new Error('A fetch implementation is required. Provide one via the "fetch" option when running outside environments with global fetch.');
         }
     }
+    /**
+     * Low-level POST adapter for the upcoming /v2 omni routes.
+     * Pass options.externalUser to include an external_user payload; omit it for internal-account calls
+     * or when authenticating directly with an external-user auth token/API key.
+     */
+    async postV2(path, payload = {}, options) {
+        return this.post(this.buildV2Url(path), this.withV2ExternalUser(payload, options), options);
+    }
+    /**
+     * Low-level GET adapter for the upcoming /v2 omni routes.
+     */
+    async getV2(path, options) {
+        const query = {
+            ...(options?.externalUser ? buildExternalUserQuery(options.externalUser) : {}),
+            ...(options?.query ?? {}),
+        };
+        return this.get(this.buildV2Url(path), { ...(options ?? {}), query });
+    }
+    async createV2Session(options) {
+        return this.postV2('session', {}, options);
+    }
+    async getV2Credits(options) {
+        return this.getV2('credits', options);
+    }
+    async listV2Requests(options) {
+        return this.getV2('requests', options);
+    }
+    async createV2LoginToken(options) {
+        const body = options?.redirect ? { redirect: options.redirect } : {};
+        return this.postV2('create_login_token', body, options);
+    }
+    async createV2VideoFromText(input, options) {
+        const normalizedInput = normalizeCreateVideoFromTextInput(input);
+        return this.postV2('text_to_video', {
+            input: normalizedInput,
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
+    async createV2VideoFromImageList(input, options) {
+        const normalizedInput = normalizeCreateVideoFromImageListInput(input);
+        return this.postV2('image_list_to_video', {
+            input: normalizedInput,
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
+    async uploadV2ImageData(imageData, options) {
+        if (!Array.isArray(imageData) || imageData.length === 0) {
+            throw new Error('imageData must be a non-empty array of data URLs');
+        }
+        return this.postV2('upload_image_data', {
+            input: {
+                image_data: imageData,
+            },
+        }, options);
+    }
+    async updateV2VideoOutroImage(input, options) {
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'updateV2VideoOutroImage');
+        return this.postV2('update_outro_image', {
+            input: normalizedInput,
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
+    async addV2VideoOutroImage(input, options) {
+        return this.postV2('add_outro_image', {
+            input,
+            webhookUrl: options?.webhookUrl,
+        }, options);
+    }
+    async getV2Status(requestId, options) {
+        const queryParams = {
+            ...(options?.externalUser ? buildExternalUserQuery(options.externalUser) : {}),
+            ...(options?.queryParams ?? {}),
+        };
+        return this.getStatus(requestId, {
+            ...options,
+            path: this.buildV2Url('status'),
+            queryParams,
+        });
+    }
     /**
      * 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 +407,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);
@@ -464,31 +732,9 @@ export class SamsarClient {
      * only the final video render step.
      */
     async updateVideoOutroImage(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;
-        const outroImageUrl = raw.outro_image_url ??
-            raw.outroImageUrl ??
-            raw.new_outro_image_url ??
-            raw.newOutroImageUrl;
-        if (!videoSessionId) {
-            throw new Error('videoSessionId is required for updateVideoOutroImage');
-        }
-        if (!outroImageUrl) {
-            throw new Error('outro_image_url is required for updateVideoOutroImage');
-        }
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'updateVideoOutroImage');
         const body = {
-            input: {
-                ...input,
-                videoSessionId: String(videoSessionId),
-                outro_image_url: String(outroImageUrl),
-            },
+            input: normalizedInput,
             webhookUrl: options?.webhookUrl,
         };
         const response = await this.post('video/update_outro_image', body, options);
@@ -512,6 +758,19 @@ export class SamsarClient {
         }
         return response;
     }
+    /**
+     * Update the outro image for an external-user video request by resolving the external request id
+     * through /external_users/update_outro_image.
+     */
+    async updateExternalVideoOutroImage(externalUser, input, options) {
+        const normalizedInput = normalizeUpdateVideoOutroImageInput(input, 'updateExternalVideoOutroImage');
+        const body = {
+            external_user: normalizeExternalUserIdentity(externalUser),
+            input: normalizedInput,
+            webhookUrl: options?.webhookUrl,
+        };
+        return this.post('external_users/update_outro_image', body, options);
+    }
     /**
      * Add or replace the outro image for an existing video session by cloning it into a new session and
      * re-running frame/video generation.
@@ -595,6 +854,76 @@ export class SamsarClient {
         }
         return response;
     }
+    /**
+     * Add or replace an outro image for an external-user video request by resolving the external request id.
+     */
+    async addExternalVideoOutroImage(externalUser, 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 ??
+            raw.source_request_id ??
+            raw.sourceRequestId ??
+            raw.external_request_id ??
+            raw.externalRequestId ??
+            raw.external_session_id ??
+            raw.externalSessionId;
+        const outroImageUrl = raw.outro_image_url ??
+            raw.outroImageUrl ??
+            raw.new_outro_image_url ??
+            raw.newOutroImageUrl;
+        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;
+        if (!videoSessionId) {
+            throw new Error('videoSessionId is required for addExternalVideoOutroImage');
+        }
+        if (!outroImageUrl) {
+            throw new Error('outro_image_url is required for addExternalVideoOutroImage');
+        }
+        if (rawAddOutroAnimation !== undefined && typeof rawAddOutroAnimation !== 'boolean') {
+            throw new Error('add_outro_animation must be a boolean for addExternalVideoOutroImage');
+        }
+        if (rawAddOutroFocusArea !== undefined && typeof rawAddOutroFocusArea !== 'boolean') {
+            throw new Error('add_outro_focus_area must be a boolean for addExternalVideoOutroImage');
+        }
+        if (rawAddOutroFocusArea === true && rawAddOutroAnimation !== true) {
+            throw new Error('add_outro_focus_area requires add_outro_animation to be true for addExternalVideoOutroImage');
+        }
+        if (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 addExternalVideoOutroImage');
+            }
+            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 addExternalVideoOutroImage');
+            }
+        }
+        const body = {
+            external_user: normalizeExternalUserIdentity(externalUser),
+            input: {
+                ...input,
+                videoSessionId: String(videoSessionId),
+                outro_image_url: String(outroImageUrl),
+                ...(rawAddOutroAnimation !== undefined ? { add_outro_animation: rawAddOutroAnimation === true } : {}),
+                ...(rawAddOutroFocusArea !== undefined ? { add_outro_focus_area: rawAddOutroFocusArea === true } : {}),
+                ...(rawOutroFocusArea !== undefined ? { outro_focust_area: rawOutroFocusArea } : {}),
+            },
+            webhookUrl: options?.webhookUrl,
+        };
+        return this.post('external_users/add_outro_image', body, options);
+    }
     /**
      * Fetch the latest available render URL for a given video session id.
      * Maps to GET /video/fetch_latest_version?session_id={sessionId}.
@@ -669,6 +998,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.
@@ -1279,6 +1650,19 @@ export class SamsarClient {
         const rootUrl = baseUrl.endsWith('/v1') ? baseUrl.slice(0, -3) : baseUrl;
         return `${rootUrl}/${cleanedPath}`;
     }
+    withV2ExternalUser(body, options) {
+        if (!options?.externalUser) {
+            return body;
+        }
+        return {
+            ...body,
+            external_user: normalizeExternalUserIdentity(options.externalUser),
+        };
+    }
+    buildV2Url(path) {
+        const cleanedPath = path.replace(/^\/+/, '');
+        return this.buildRootUrl(`v2/${cleanedPath}`);
+    }
 }
 function trimTrailingSlash(url) {
     return url.replace(/\/+$/, '');

package/package.json

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