ugcinc-render 1.8.140 → 1.8.141

package/dist/index.d.mts

@@ -544,6 +544,67 @@ declare function isDeduplicationLevel(input: DeduplicationInput): input is Dedup
  */
 declare function resolveDeduplicationConfig(input: DeduplicationInput): DeduplicationConfig;
 
+/**
+ * Simplified public types for Instagram DM composition
+ *
+ * These are the types exposed to users via the automation node.
+ * They provide a simpler interface than the full InstagramDmCompositionProps.
+ */
+/** Message sender side */
+type IgDmSender = 'user' | 'recipient';
+/** Theme for the DM composition */
+type IgDmTheme = 'light' | 'dark';
+/**
+ * A single message in the conversation (simplified)
+ *
+ * This is the user-facing message format that gets converted
+ * to the full IgMessage type internally.
+ */
+interface IgDmMessage {
+    /** Message text content */
+    text: string;
+    /**
+     * Who sent this message:
+     * - 'user' = sender (right side, gradient bubbles)
+     * - 'recipient' = receiver (left side, gray bubbles)
+     */
+    sender: IgDmSender;
+    /**
+     * Whether this is a reply to a story.
+     * Only valid when sender='user'. Will be ignored for recipient messages.
+     */
+    isStoryReply?: boolean;
+    /**
+     * Whether to group with the previous message.
+     * When true, uses smaller gap and connected bubble corners.
+     */
+    groupWithPrevious?: boolean;
+}
+/**
+ * Public-facing input params for Instagram DM composition
+ *
+ * These are what users configure in the automation node.
+ * The system converts these to full InstagramDmCompositionProps internally.
+ */
+interface InstagramDmPublicInput {
+    /** Receiver's username (shown in header) */
+    receiverUsername: string;
+    /**
+     * Receiver's profile picture URL.
+     * Used in both the header and next to recipient messages.
+     */
+    receiverProfilePicUrl: string;
+    /** Theme - light or dark mode */
+    theme: IgDmTheme;
+    /** Messages in the conversation (in chronological order) */
+    messages: IgDmMessage[];
+    /**
+     * Story image URL for story reply messages.
+     * Required if any message has isStoryReply=true.
+     */
+    storyImageUrl?: string;
+}
+
 interface ImageEditorCompositionProps {
     /** The editor configuration to render (legacy format with pre-resolved segments) */
     config?: ImageEditorConfig;
@@ -875,6 +936,36 @@ interface InstagramDmCompositionProps {
 declare const defaultInstagramDmProps: InstagramDmCompositionProps;
 declare function InstagramDmComposition(props: InstagramDmCompositionProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Convert simplified public input to full InstagramDmComposition props
+ *
+ * This module transforms the user-friendly InstagramDmPublicInput
+ * into the full InstagramDmCompositionProps used by the composition.
+ */
+
+/**
+ * Validation error returned when input is invalid
+ */
+interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate public input before conversion
+ *
+ * @param input - The public input to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+declare function validatePublicInput(input: InstagramDmPublicInput): ValidationError[];
+/**
+ * Convert simplified public input to full composition props
+ *
+ * @param input - The simplified public input
+ * @returns Full InstagramDmCompositionProps ready for rendering
+ * @throws Error if validation fails
+ */
+declare function convertPublicToProps(input: InstagramDmPublicInput): InstagramDmCompositionProps;
+
 /**
  * Platform-agnostic messaging types
  *
@@ -1352,4 +1443,4 @@ declare function useResolvedPositions(elements: ImageEditorElement[], textValues
 
 declare const RenderRoot: React.FC;
 
-export { type Acceleration, type AudioConfig, type AudioSegment, AutoCaptionComposition, AutoCaptionCompositionProps, AutoCaptionCompositionWithVideo, type BaseBubbleStyle, type BaseEditorConfig, type BaseMessage, type BaseMessageType, type BaseSegment, type BlendMode, BorderRadiusConfig, type BubbleRadii, CaptionOverlay, CaptionOverlayProps, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FitMode, FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientColor, type GradientOverlayConfig, type IgTheme, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, ImageEditorElement, ImageElement, type ImageElementProps, type ImageMessage, type ImageSegment, type ImageSequenceSegment, InstagramDmComposition, type InstagramDmCompositionProps, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, MediaBubble, type MediaBubbleProps, type Message, MessageBubble, type MessageBubbleProps, type MessageGroup, type MessageOrTyping, type MessagePosition, type MessageReaction, type MessageSender, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, PositionResolutionResult, type PositionedMessage, ProfilePic, type ProfilePicProps, Reaction, type ReactionProps, type ReadReceipt, type ReadReceiptState, RelativePositionConfigX, RelativePositionConfigY, RenderRoot, ScreenshotAnimation, ScreenshotAnimationProps, type Segment, SegmentType, type SpeedConfig, type StaticSegment, TYPING_ANIMATION, TextElement, type TextElementProps, type TextMessage, type TextSegment, TextStyleProperties, TimeValue, type TraceRemovalConfig, TypingIndicator, type TypingIndicatorProps, type TypingIndicatorStyle, type TypingMessage, type UserProfile, type VideoCodec, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VideoSequenceSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, bubbleRadiiToCss, calculateBubbleRadii, defaultInstagramDmProps, flattenGroups, groupMessages, isDeduplicationLevel, resolveDeduplicationConfig, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions };
+export { type Acceleration, type AudioConfig, type AudioSegment, AutoCaptionComposition, AutoCaptionCompositionProps, AutoCaptionCompositionWithVideo, type BaseBubbleStyle, type BaseEditorConfig, type BaseMessage, type BaseMessageType, type BaseSegment, type BlendMode, BorderRadiusConfig, type BubbleRadii, CaptionOverlay, CaptionOverlayProps, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FitMode, FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientColor, type GradientOverlayConfig, type IgDmMessage, type IgDmSender, type IgDmTheme, type IgTheme, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, ImageEditorElement, ImageElement, type ImageElementProps, type ImageMessage, type ImageSegment, type ImageSequenceSegment, InstagramDmComposition, type InstagramDmCompositionProps, type InstagramDmPublicInput, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, MediaBubble, type MediaBubbleProps, type Message, MessageBubble, type MessageBubbleProps, type MessageGroup, type MessageOrTyping, type MessagePosition, type MessageReaction, type MessageSender, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, PositionResolutionResult, type PositionedMessage, ProfilePic, type ProfilePicProps, Reaction, type ReactionProps, type ReadReceipt, type ReadReceiptState, RelativePositionConfigX, RelativePositionConfigY, RenderRoot, ScreenshotAnimation, ScreenshotAnimationProps, type Segment, SegmentType, type SpeedConfig, type StaticSegment, TYPING_ANIMATION, TextElement, type TextElementProps, type TextMessage, type TextSegment, TextStyleProperties, TimeValue, type TraceRemovalConfig, TypingIndicator, type TypingIndicatorProps, type TypingIndicatorStyle, type TypingMessage, type UserProfile, type ValidationError, type VideoCodec, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VideoSequenceSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, bubbleRadiiToCss, calculateBubbleRadii, convertPublicToProps, defaultInstagramDmProps, flattenGroups, groupMessages, isDeduplicationLevel, resolveDeduplicationConfig, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, validatePublicInput };

package/dist/index.d.ts

@@ -544,6 +544,67 @@ declare function isDeduplicationLevel(input: DeduplicationInput): input is Dedup
  */
 declare function resolveDeduplicationConfig(input: DeduplicationInput): DeduplicationConfig;
 
+/**
+ * Simplified public types for Instagram DM composition
+ *
+ * These are the types exposed to users via the automation node.
+ * They provide a simpler interface than the full InstagramDmCompositionProps.
+ */
+/** Message sender side */
+type IgDmSender = 'user' | 'recipient';
+/** Theme for the DM composition */
+type IgDmTheme = 'light' | 'dark';
+/**
+ * A single message in the conversation (simplified)
+ *
+ * This is the user-facing message format that gets converted
+ * to the full IgMessage type internally.
+ */
+interface IgDmMessage {
+    /** Message text content */
+    text: string;
+    /**
+     * Who sent this message:
+     * - 'user' = sender (right side, gradient bubbles)
+     * - 'recipient' = receiver (left side, gray bubbles)
+     */
+    sender: IgDmSender;
+    /**
+     * Whether this is a reply to a story.
+     * Only valid when sender='user'. Will be ignored for recipient messages.
+     */
+    isStoryReply?: boolean;
+    /**
+     * Whether to group with the previous message.
+     * When true, uses smaller gap and connected bubble corners.
+     */
+    groupWithPrevious?: boolean;
+}
+/**
+ * Public-facing input params for Instagram DM composition
+ *
+ * These are what users configure in the automation node.
+ * The system converts these to full InstagramDmCompositionProps internally.
+ */
+interface InstagramDmPublicInput {
+    /** Receiver's username (shown in header) */
+    receiverUsername: string;
+    /**
+     * Receiver's profile picture URL.
+     * Used in both the header and next to recipient messages.
+     */
+    receiverProfilePicUrl: string;
+    /** Theme - light or dark mode */
+    theme: IgDmTheme;
+    /** Messages in the conversation (in chronological order) */
+    messages: IgDmMessage[];
+    /**
+     * Story image URL for story reply messages.
+     * Required if any message has isStoryReply=true.
+     */
+    storyImageUrl?: string;
+}
+
 interface ImageEditorCompositionProps {
     /** The editor configuration to render (legacy format with pre-resolved segments) */
     config?: ImageEditorConfig;
@@ -875,6 +936,36 @@ interface InstagramDmCompositionProps {
 declare const defaultInstagramDmProps: InstagramDmCompositionProps;
 declare function InstagramDmComposition(props: InstagramDmCompositionProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Convert simplified public input to full InstagramDmComposition props
+ *
+ * This module transforms the user-friendly InstagramDmPublicInput
+ * into the full InstagramDmCompositionProps used by the composition.
+ */
+
+/**
+ * Validation error returned when input is invalid
+ */
+interface ValidationError {
+    field: string;
+    message: string;
+}
+/**
+ * Validate public input before conversion
+ *
+ * @param input - The public input to validate
+ * @returns Array of validation errors (empty if valid)
+ */
+declare function validatePublicInput(input: InstagramDmPublicInput): ValidationError[];
+/**
+ * Convert simplified public input to full composition props
+ *
+ * @param input - The simplified public input
+ * @returns Full InstagramDmCompositionProps ready for rendering
+ * @throws Error if validation fails
+ */
+declare function convertPublicToProps(input: InstagramDmPublicInput): InstagramDmCompositionProps;
+
 /**
  * Platform-agnostic messaging types
  *
@@ -1352,4 +1443,4 @@ declare function useResolvedPositions(elements: ImageEditorElement[], textValues
 
 declare const RenderRoot: React.FC;
 
-export { type Acceleration, type AudioConfig, type AudioSegment, AutoCaptionComposition, AutoCaptionCompositionProps, AutoCaptionCompositionWithVideo, type BaseBubbleStyle, type BaseEditorConfig, type BaseMessage, type BaseMessageType, type BaseSegment, type BlendMode, BorderRadiusConfig, type BubbleRadii, CaptionOverlay, CaptionOverlayProps, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FitMode, FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientColor, type GradientOverlayConfig, type IgTheme, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, ImageEditorElement, ImageElement, type ImageElementProps, type ImageMessage, type ImageSegment, type ImageSequenceSegment, InstagramDmComposition, type InstagramDmCompositionProps, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, MediaBubble, type MediaBubbleProps, type Message, MessageBubble, type MessageBubbleProps, type MessageGroup, type MessageOrTyping, type MessagePosition, type MessageReaction, type MessageSender, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, PositionResolutionResult, type PositionedMessage, ProfilePic, type ProfilePicProps, Reaction, type ReactionProps, type ReadReceipt, type ReadReceiptState, RelativePositionConfigX, RelativePositionConfigY, RenderRoot, ScreenshotAnimation, ScreenshotAnimationProps, type Segment, SegmentType, type SpeedConfig, type StaticSegment, TYPING_ANIMATION, TextElement, type TextElementProps, type TextMessage, type TextSegment, TextStyleProperties, TimeValue, type TraceRemovalConfig, TypingIndicator, type TypingIndicatorProps, type TypingIndicatorStyle, type TypingMessage, type UserProfile, type VideoCodec, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VideoSequenceSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, bubbleRadiiToCss, calculateBubbleRadii, defaultInstagramDmProps, flattenGroups, groupMessages, isDeduplicationLevel, resolveDeduplicationConfig, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions };
+export { type Acceleration, type AudioConfig, type AudioSegment, AutoCaptionComposition, AutoCaptionCompositionProps, AutoCaptionCompositionWithVideo, type BaseBubbleStyle, type BaseEditorConfig, type BaseMessage, type BaseMessageType, type BaseSegment, type BlendMode, BorderRadiusConfig, type BubbleRadii, CaptionOverlay, CaptionOverlayProps, type Channel, type ColorFilterConfig, type ColorShiftConfig, type CropConfig, type CuttingConfig, DEDUPLICATION_LEVELS, type DeduplicationConfig, type DeduplicationInput, type DeduplicationLevel, type DiagonalFilterConfig, type DiagonalFilterType, DynamicCropConfig, type EditorConfig, type EditorSegment, type EnhanceLevel, type EnhancementConfig, FitMode, FontWeight, type FrameManipulationConfig, type GifOverlayConfig, type GifSource, type GradientColor, type GradientOverlayConfig, type IgDmMessage, type IgDmSender, type IgDmTheme, type IgTheme, ImageEditorComposition, type ImageEditorCompositionProps, type ImageEditorConfig, ImageEditorElement, ImageElement, type ImageElementProps, type ImageMessage, type ImageSegment, type ImageSequenceSegment, InstagramDmComposition, type InstagramDmCompositionProps, type InstagramDmPublicInput, LEVEL_1_CONFIG, LEVEL_2_CONFIG, LEVEL_3_CONFIG, LEVEL_4_CONFIG, LEVEL_5_CONFIG, type LensCorrectionConfig, MediaBubble, type MediaBubbleProps, type Message, MessageBubble, type MessageBubbleProps, type MessageGroup, type MessageOrTyping, type MessagePosition, type MessageReaction, type MessageSender, type MobileEncodingConfig, type ParticleOverlayConfig, type PhoneConfig, type PhoneModel, type PhoneType, type PictureSegment, PositionResolutionResult, type PositionedMessage, ProfilePic, type ProfilePicProps, Reaction, type ReactionProps, type ReadReceipt, type ReadReceiptState, RelativePositionConfigX, RelativePositionConfigY, RenderRoot, ScreenshotAnimation, ScreenshotAnimationProps, type Segment, SegmentType, type SpeedConfig, type StaticSegment, TYPING_ANIMATION, TextElement, type TextElementProps, type TextMessage, type TextSegment, TextStyleProperties, TimeValue, type TraceRemovalConfig, TypingIndicator, type TypingIndicatorProps, type TypingIndicatorStyle, type TypingMessage, type UserProfile, type ValidationError, type VideoCodec, VideoEditorComposition, type VideoEditorCompositionProps, type VideoEditorConfig, VideoElement, type VideoElementProps, type VideoExtension, type VideoSegment, type VideoSequenceSegment, type VisualAdjustmentsConfig, type VisualSegment, type VisualSegmentUnion, bubbleRadiiToCss, calculateBubbleRadii, convertPublicToProps, defaultInstagramDmProps, flattenGroups, groupMessages, isDeduplicationLevel, resolveDeduplicationConfig, useFontsLoaded, useImageLoader, useImagePreloader, useResolvedPositions, validatePublicInput };

package/dist/index.js

@@ -79,6 +79,7 @@ __export(index_exports, {
   calculateScreenshotAnimationDuration: () => calculateScreenshotAnimationDuration,
   calculateTimelineContentEnd: () => calculateTimelineContentEnd,
   canSetAsReference: () => canSetAsReference,
+  convertPublicToProps: () => convertPublicToProps,
   debugFontStatus: () => debugFontStatus,
   defaultInstagramDmProps: () => defaultInstagramDmProps,
   defaultOffset: () => defaultOffset,
@@ -112,6 +113,7 @@ __export(index_exports, {
   useImageLoader: () => useImageLoader,
   useImagePreloader: () => useImagePreloader,
   useResolvedPositions: () => useResolvedPositions,
+  validatePublicInput: () => validatePublicInput,
   wrapText: () => wrapText
 });
 module.exports = __toCommonJS(index_exports);
@@ -4915,6 +4917,100 @@ function InstagramDmComposition(props) {
   );
 }
 
+// src/compositions/InstagramDmComposition/convertPublicToProps.ts
+function validatePublicInput(input) {
+  const errors = [];
+  if (!input.receiverUsername?.trim()) {
+    errors.push({
+      field: "receiverUsername",
+      message: "Receiver username is required"
+    });
+  }
+  if (!input.receiverProfilePicUrl?.trim()) {
+    errors.push({
+      field: "receiverProfilePicUrl",
+      message: "Receiver profile picture URL is required"
+    });
+  }
+  if (!input.theme || !["light", "dark"].includes(input.theme)) {
+    errors.push({
+      field: "theme",
+      message: "Theme must be 'light' or 'dark'"
+    });
+  }
+  if (!input.messages || input.messages.length === 0) {
+    errors.push({
+      field: "messages",
+      message: "At least one message is required"
+    });
+  } else {
+    input.messages.forEach((msg, index) => {
+      if (!msg.text?.trim()) {
+        errors.push({
+          field: `messages[${index}].text`,
+          message: `Message ${index + 1}: text is required`
+        });
+      }
+      if (!msg.sender || !["user", "recipient"].includes(msg.sender)) {
+        errors.push({
+          field: `messages[${index}].sender`,
+          message: `Message ${index + 1}: sender must be 'user' or 'recipient'`
+        });
+      }
+      if (msg.isStoryReply && msg.sender !== "user") {
+        errors.push({
+          field: `messages[${index}].isStoryReply`,
+          message: `Message ${index + 1}: story replies are only allowed for sender='user'`
+        });
+      }
+    });
+    const hasStoryReply = input.messages.some((m) => m.isStoryReply && m.sender === "user");
+    if (hasStoryReply && !input.storyImageUrl?.trim()) {
+      errors.push({
+        field: "storyImageUrl",
+        message: "Story image URL is required when any message has isStoryReply=true"
+      });
+    }
+  }
+  return errors;
+}
+function convertMessages(messages, storyImageUrl) {
+  return messages.map((msg, index) => {
+    const igMessage = {
+      id: `msg-${index}`,
+      sender: msg.sender,
+      text: msg.text
+    };
+    if (msg.groupWithPrevious) {
+      igMessage.groupWithPrevious = true;
+    }
+    if (msg.isStoryReply && msg.sender === "user" && storyImageUrl) {
+      igMessage.storyReplyImageUrl = storyImageUrl;
+    }
+    return igMessage;
+  });
+}
+function convertPublicToProps(input) {
+  const errors = validatePublicInput(input);
+  if (errors.length > 0) {
+    throw new Error(`Invalid input: ${errors.map((e) => e.message).join(", ")}`);
+  }
+  const props = {
+    ...defaultInstagramDmProps,
+    // Override with user input
+    theme: input.theme,
+    senderUsername: input.receiverUsername,
+    profilePicUrl: input.receiverProfilePicUrl,
+    userPfpUrl: input.receiverProfilePicUrl,
+    // Convert messages
+    messages: convertMessages(input.messages, input.storyImageUrl),
+    // Disable debug/reference overlays for production renders
+    showDebugOverlay: false,
+    showReferenceImage: false
+  };
+  return props;
+}
+
 // src/compositions/messaging/types.ts
 var TYPING_ANIMATION = {
   /** Frames for one complete bounce cycle at 30fps */
@@ -6232,6 +6328,7 @@ var RenderRoot = () => {
   calculateScreenshotAnimationDuration,
   calculateTimelineContentEnd,
   canSetAsReference,
+  convertPublicToProps,
   debugFontStatus,
   defaultInstagramDmProps,
   defaultOffset,
@@ -6265,5 +6362,6 @@ var RenderRoot = () => {
   useImageLoader,
   useImagePreloader,
   useResolvedPositions,
+  validatePublicInput,
   wrapText
 });

package/dist/index.mjs

@@ -3984,6 +3984,100 @@ function InstagramDmComposition(props) {
   );
 }
 
+// src/compositions/InstagramDmComposition/convertPublicToProps.ts
+function validatePublicInput(input) {
+  const errors = [];
+  if (!input.receiverUsername?.trim()) {
+    errors.push({
+      field: "receiverUsername",
+      message: "Receiver username is required"
+    });
+  }
+  if (!input.receiverProfilePicUrl?.trim()) {
+    errors.push({
+      field: "receiverProfilePicUrl",
+      message: "Receiver profile picture URL is required"
+    });
+  }
+  if (!input.theme || !["light", "dark"].includes(input.theme)) {
+    errors.push({
+      field: "theme",
+      message: "Theme must be 'light' or 'dark'"
+    });
+  }
+  if (!input.messages || input.messages.length === 0) {
+    errors.push({
+      field: "messages",
+      message: "At least one message is required"
+    });
+  } else {
+    input.messages.forEach((msg, index) => {
+      if (!msg.text?.trim()) {
+        errors.push({
+          field: `messages[${index}].text`,
+          message: `Message ${index + 1}: text is required`
+        });
+      }
+      if (!msg.sender || !["user", "recipient"].includes(msg.sender)) {
+        errors.push({
+          field: `messages[${index}].sender`,
+          message: `Message ${index + 1}: sender must be 'user' or 'recipient'`
+        });
+      }
+      if (msg.isStoryReply && msg.sender !== "user") {
+        errors.push({
+          field: `messages[${index}].isStoryReply`,
+          message: `Message ${index + 1}: story replies are only allowed for sender='user'`
+        });
+      }
+    });
+    const hasStoryReply = input.messages.some((m) => m.isStoryReply && m.sender === "user");
+    if (hasStoryReply && !input.storyImageUrl?.trim()) {
+      errors.push({
+        field: "storyImageUrl",
+        message: "Story image URL is required when any message has isStoryReply=true"
+      });
+    }
+  }
+  return errors;
+}
+function convertMessages(messages, storyImageUrl) {
+  return messages.map((msg, index) => {
+    const igMessage = {
+      id: `msg-${index}`,
+      sender: msg.sender,
+      text: msg.text
+    };
+    if (msg.groupWithPrevious) {
+      igMessage.groupWithPrevious = true;
+    }
+    if (msg.isStoryReply && msg.sender === "user" && storyImageUrl) {
+      igMessage.storyReplyImageUrl = storyImageUrl;
+    }
+    return igMessage;
+  });
+}
+function convertPublicToProps(input) {
+  const errors = validatePublicInput(input);
+  if (errors.length > 0) {
+    throw new Error(`Invalid input: ${errors.map((e) => e.message).join(", ")}`);
+  }
+  const props = {
+    ...defaultInstagramDmProps,
+    // Override with user input
+    theme: input.theme,
+    senderUsername: input.receiverUsername,
+    profilePicUrl: input.receiverProfilePicUrl,
+    userPfpUrl: input.receiverProfilePicUrl,
+    // Convert messages
+    messages: convertMessages(input.messages, input.storyImageUrl),
+    // Disable debug/reference overlays for production renders
+    showDebugOverlay: false,
+    showReferenceImage: false
+  };
+  return props;
+}
+
 // src/compositions/messaging/types.ts
 var TYPING_ANIMATION = {
   /** Frames for one complete bounce cycle at 30fps */
@@ -5017,6 +5111,7 @@ export {
   calculateScreenshotAnimationDuration,
   calculateTimelineContentEnd,
   canSetAsReference,
+  convertPublicToProps,
   debugFontStatus,
   defaultInstagramDmProps,
   defaultOffset,
@@ -5050,5 +5145,6 @@ export {
   useImageLoader,
   useImagePreloader,
   useResolvedPositions,
+  validatePublicInput,
   wrapText
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc-render",
-  "version": "1.8.140",
+  "version": "1.8.141",
   "description": "Unified rendering package for UGC Inc - shared types, components, and compositions for pixel-perfect client/server rendering",
   "main": "dist/index.js",
   "module": "dist/index.mjs",