ugcinc 4.1.46 → 4.1.49

package/dist/index.d.ts

@@ -31,7 +31,7 @@ export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, Daily
 export type { ApiKey, DeleteApiKeyParams, EditApiKeyParams } from './org';
 export type { UserMedia, MediaUse, SocialAudio, Media, GetMediaParams, GetSocialAudioParams, UploadMediaParams, UploadMediaResponse, MediaTagUpdate, UpdateMediaTagsParams, MediaTagUpdateResult, UpdateMediaTagsResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, ImportTextParams, ImportTextResponse, CreateMediaFromUrlParams, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, GetUploadTokenParams, UploadTokenResponse, } from './media';
 export type { CommentStatus, Comment, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './comments';
-export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, SubmitScreenshotAnimationRenderJobParams, SubmitInstagramDmRenderJobParams, SubmitIMessageDmRenderJobParams, IgDmMessage, ImDmMessage, RenderVideoEditorConfig, } from './render';
+export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, SubmitScreenshotAnimationRenderJobParams, SubmitAutoCaptionRenderJobParams, SubmitInstagramDmRenderJobParams, SubmitIMessageDmRenderJobParams, IgDmMessage, ImDmMessage, RenderVideoEditorConfig, } from './render';
 export type { VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, TimeValue, TimeMode, SegmentTimelinePosition, DeduplicationLevel, DeduplicationInput, ImageEditorElement, DimensionPresetKey, } from './render/types';
 export type { ImageEditorNodeConfig, ImageComposerNodeConfig, ImageComposerRenderInput } from './automations/nodes/image-composer';
 export { prepareImageComposerInput } from './automations/nodes/image-composer';

package/dist/render.d.ts

@@ -1,6 +1,8 @@
 import type { ApiResponse } from './types';
 import type { VideoEditorNodeConfig, DeduplicationInput } from './render/types';
+import type { CaptionWord, CaptionStyle } from './render/types/caption';
 import type { ImageEditorNodeConfig } from './automations/nodes/image-composer';
+import type { CreateDmMessage } from './automations/nodes/create-dm';
 export interface RenderJobResponse {
     job_id: string;
     status: string;
@@ -60,12 +62,29 @@ export interface SubmitScreenshotAnimationRenderJobParams {
     /** Duration to hold at end after animation completes (ms) - default 500 */
     holdDurationMs?: number;
 }
-export interface IgDmMessage {
+export interface SubmitAutoCaptionRenderJobParams {
+    /** Video source URL */
+    videoUrl: string;
+    /** Output width in pixels */
+    width: number;
+    /** Output height in pixels */
+    height: number;
+    /** Video duration in milliseconds */
+    durationMs: number;
+    /** Frames per second */
+    fps: number;
+    /** Caption words with timing from transcription */
+    captions: CaptionWord[];
+    /** Caption styling configuration */
+    style: CaptionStyle;
+}
+interface IgDmMessageInternal {
     text: string;
     sender: 'user' | 'recipient';
     isStoryReply?: boolean;
     groupWithPrevious?: boolean;
 }
+export type IgDmMessage = IgDmMessageInternal;
 export interface SubmitInstagramDmRenderJobParams {
     /** Receiver's username (shown in header) */
     receiverUsername: string;
@@ -74,17 +93,18 @@ export interface SubmitInstagramDmRenderJobParams {
     /** Theme - light or dark mode */
     theme: 'light' | 'dark';
     /** Messages in the conversation */
-    messages: IgDmMessage[];
-    /** Story image URL for story reply messages */
-    storyImageUrl?: string;
+    messages: CreateDmMessage[];
+    /** Image attachment URL (used for story reply) */
+    imageAttachmentUrl?: string;
 }
-export interface ImDmMessage {
+interface ImDmMessageInternal {
     id: string;
     sender: 'user' | 'recipient';
     text: string;
     imageUrl?: string;
     groupWithPrevious?: boolean;
 }
+export type ImDmMessage = ImDmMessageInternal;
 export interface SubmitIMessageDmRenderJobParams {
     /** Username displayed in header */
     username: string;
@@ -95,7 +115,9 @@ export interface SubmitIMessageDmRenderJobParams {
     /** Status bar time */
     time: string;
     /** Messages in the conversation */
-    messages: ImDmMessage[];
+    messages: CreateDmMessage[];
+    /** Image attachment URL (used for sender images with hasImage flag) */
+    imageAttachmentUrl?: string;
     /** Sender bubble color (default blue) */
     senderBubbleColor?: string;
     /** Whether to show read receipt */
@@ -135,6 +157,11 @@ export declare class RenderClient {
      * Renders an iPhone screenshot animation video from a source image
      */
     submitScreenshotAnimationRenderJob(params: SubmitScreenshotAnimationRenderJobParams): Promise<ApiResponse<RenderJobResponse>>;
+    /**
+     * Submit an auto-caption render job to the Modal renderer
+     * Renders a video with captions overlaid
+     */
+    submitAutoCaptionRenderJob(params: SubmitAutoCaptionRenderJobParams): Promise<ApiResponse<RenderJobResponse>>;
     /**
      * Submit an Instagram DM render job to the Modal renderer
      * Renders a fake Instagram DM conversation image
@@ -146,3 +173,4 @@ export declare class RenderClient {
      */
     submitIMessageDmRenderJob(params: SubmitIMessageDmRenderJobParams): Promise<ApiResponse<RenderJobResponse>>;
 }
+export {};

package/dist/render.js

@@ -4,6 +4,56 @@ exports.RenderClient = void 0;
 // Modal renderer endpoints
 const RENDER_SUBMIT_URL = "https://aidangollan--ugcinc-render-renderer-submit-job.modal.run";
 const RENDER_STATUS_URL = "https://aidangollan--ugcinc-render-renderer-get-status.modal.run";
+// =============================================================================
+// DM Message Transformation Helpers
+// =============================================================================
+/**
+ * Auto-detect groupWithPrevious for messages based on consecutive same-sender
+ */
+function addGroupWithPrevious(messages) {
+    return messages.map((msg, index) => {
+        if (index === 0) {
+            return { ...msg, groupWithPrevious: false };
+        }
+        const prevMsg = messages[index - 1];
+        const shouldGroup = prevMsg !== undefined && msg.sender === prevMsg.sender;
+        return { ...msg, groupWithPrevious: shouldGroup };
+    });
+}
+/**
+ * Generate unique message IDs for iMessage messages
+ */
+function generateMessageId(index) {
+    return `msg-${index}-${Date.now()}`;
+}
+/**
+ * Transform CreateDmMessage[] to IgDmMessageInternal[] for Instagram DM
+ */
+function transformToInstagramMessages(messages, imageAttachmentUrl) {
+    const processedMessages = addGroupWithPrevious(messages);
+    return processedMessages.map((msg) => ({
+        text: msg.text,
+        sender: msg.sender,
+        isStoryReply: msg.hasImage && imageAttachmentUrl ? true : false,
+        groupWithPrevious: msg.groupWithPrevious,
+    }));
+}
+/**
+ * Transform CreateDmMessage[] to ImDmMessageInternal[] for iMessage DM
+ */
+function transformToIMessageMessages(messages, imageAttachmentUrl) {
+    const processedMessages = addGroupWithPrevious(messages);
+    return processedMessages.map((msg, index) => ({
+        id: generateMessageId(index),
+        sender: msg.sender,
+        text: msg.text,
+        imageUrl: msg.hasImage && msg.sender === 'user' ? imageAttachmentUrl : undefined,
+        groupWithPrevious: msg.groupWithPrevious,
+    }));
+}
+// =============================================================================
+// Render Client
+// =============================================================================
 /**
  * Client for rendering operations
  * Note: This calls Modal endpoints directly, not the UGC Inc API
@@ -305,12 +355,78 @@ class RenderClient {
             };
         }
     }
+    /**
+     * Submit an auto-caption render job to the Modal renderer
+     * Renders a video with captions overlaid
+     */
+    async submitAutoCaptionRenderJob(params) {
+        try {
+            const response = await fetch(RENDER_SUBMIT_URL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    config: {
+                        _compositionType: 'auto-caption',
+                        videoUrl: params.videoUrl,
+                        width: params.width,
+                        height: params.height,
+                        durationMs: params.durationMs,
+                        fps: params.fps,
+                        captions: params.captions,
+                        style: params.style,
+                    },
+                    output_type: 'video',
+                    video_codec: 'h264',
+                })
+            });
+            const text = await response.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (jsonError) {
+                console.error('[Render] JSON parse error:', text.substring(0, 200));
+                return {
+                    ok: false,
+                    code: response.status || 500,
+                    message: `Modal endpoint error: ${text.substring(0, 100)}`,
+                };
+            }
+            if (data.status === 'error' || !response.ok) {
+                return {
+                    ok: false,
+                    code: response.status,
+                    message: data.error ?? data.message ?? 'Failed to submit auto-caption job',
+                };
+            }
+            return {
+                ok: true,
+                code: 200,
+                message: "Auto-caption job submitted",
+                data,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[Render] Submit auto-caption error:', error);
+            return {
+                ok: false,
+                code: 500,
+                message: `Failed to submit auto-caption job: ${errorMessage}`,
+            };
+        }
+    }
     /**
      * Submit an Instagram DM render job to the Modal renderer
      * Renders a fake Instagram DM conversation image
      */
     async submitInstagramDmRenderJob(params) {
         try {
+            // Transform CreateDmMessage[] to internal format
+            const transformedMessages = transformToInstagramMessages(params.messages, params.imageAttachmentUrl);
+            const hasStoryReply = params.messages.some(msg => msg.hasImage);
             const response = await fetch(RENDER_SUBMIT_URL, {
                 method: 'POST',
                 headers: {
@@ -323,8 +439,8 @@ class RenderClient {
                             receiverUsername: params.receiverUsername,
                             receiverProfilePicUrl: params.receiverProfilePicUrl,
                             theme: params.theme,
-                            messages: params.messages,
-                            storyImageUrl: params.storyImageUrl,
+                            messages: transformedMessages,
+                            storyImageUrl: hasStoryReply ? params.imageAttachmentUrl : undefined,
                         },
                     },
                     output_type: 'image',
@@ -374,6 +490,8 @@ class RenderClient {
      */
     async submitIMessageDmRenderJob(params) {
         try {
+            // Transform CreateDmMessage[] to internal format
+            const transformedMessages = transformToIMessageMessages(params.messages, params.imageAttachmentUrl);
             const response = await fetch(RENDER_SUBMIT_URL, {
                 method: 'POST',
                 headers: {
@@ -387,7 +505,7 @@ class RenderClient {
                             profilePicUrl: params.profilePicUrl,
                             theme: params.theme,
                             time: params.time,
-                            messages: params.messages,
+                            messages: transformedMessages,
                             senderBubbleColor: params.senderBubbleColor,
                             showReadReceipt: params.showReadReceipt,
                             readReceiptText: params.readReceiptText,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.1.46",
+  "version": "4.1.49",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",