ugcinc 4.5.13 → 4.5.15

package/dist/automations/nodes/image-composer.d.ts

@@ -1,5 +1,5 @@
 import type { PortValue, ImageValue } from '../types';
-import type { ImageEditorElement, DimensionPresetKey, FitMode, DynamicCropConfig } from '../../render/types';
+import type { ImageEditorElement, DimensionPresetKey, FitMode, DynamicCropConfig, StaticMediaItem } from '../../render/types';
 import { type OutputMode, type SelectionMode } from './types';
 /** Image composer inputs are dynamic (element inputRefs). Input port IDs are user-defined. */
 export type ImageComposerNodeInputs = Record<string, PortValue | PortValue[]>;
@@ -28,10 +28,8 @@ export interface ImageEditorNodeConfig {
     backgroundType?: 'image' | 'color';
     /** Whether background image comes from a variable input port (default: true for backwards compat) */
     backgroundIsVariable?: boolean;
-    /** Media library ID for static background image */
-    backgroundMediaId?: string | null;
-    /** URL for static background image */
-    backgroundMediaUrl?: string | null;
+    /** Selected media items for static background image */
+    backgroundMedia?: StaticMediaItem[];
     /** Background color (hex) when backgroundType is 'color' */
     backgroundColor?: string;
     /** How the background image fits the canvas */

package/dist/automations/nodes/image-composer.js

@@ -104,8 +104,9 @@ const definition = (0, types_1.defineNode)({
         const textContent = {};
         // Add background URL: use static URL when not variable, otherwise use preview URL
         if (editorConfig.backgroundIsVariable === false) {
-            if (editorConfig.backgroundMediaUrl) {
-                sources['background'] = editorConfig.backgroundMediaUrl;
+            const url = editorConfig.backgroundMedia?.[0]?.url;
+            if (url) {
+                sources['background'] = url;
             }
         }
         else {
@@ -118,8 +119,9 @@ const definition = (0, types_1.defineNode)({
         for (const elem of editorConfig.elements) {
             if (elem.type === 'image' && elem.inputId) {
                 if (elem.imageIsVariable === false) {
-                    if (elem.imageMediaUrl) {
-                        sources[elem.id] = elem.imageMediaUrl;
+                    const url = elem.imageMedia?.[0]?.url;
+                    if (url) {
+                        sources[elem.id] = url;
                     }
                 }
                 else {
@@ -178,8 +180,11 @@ function prepareImageComposerInput(editorConfig, inputs) {
     const textValues = {};
     // Add background URL: use static URL when not variable, otherwise from inputs
     if (editorConfig.backgroundIsVariable === false) {
-        if (editorConfig.backgroundMediaUrl) {
-            imageUrls.background = editorConfig.backgroundMediaUrl;
+        const items = editorConfig.backgroundMedia;
+        if (items?.length) {
+            const pick = items[Math.floor(Math.random() * items.length)];
+            if (pick?.url)
+                imageUrls.background = pick.url;
         }
     }
     else {
@@ -192,8 +197,11 @@ function prepareImageComposerInput(editorConfig, inputs) {
     for (const elem of editorConfig.elements) {
         if (elem.type === 'image' && elem.inputId) {
             if (elem.imageIsVariable === false) {
-                if (elem.imageMediaUrl) {
-                    imageUrls[elem.inputId] = elem.imageMediaUrl;
+                const items = elem.imageMedia;
+                if (items?.length) {
+                    const pick = items[Math.floor(Math.random() * items.length)];
+                    if (pick?.url)
+                        imageUrls[elem.inputId] = pick.url;
                 }
             }
             else {

package/dist/automations/nodes/index.d.ts

@@ -298,6 +298,9 @@ export declare const nodeDefinitions: {
     };
     readonly 'screenshot-animation': NodeDefinition<"screenshot-animation", "generator", {
         holdDurationMs: number;
+        imageIsVariable: boolean;
+        imageMediaId: string | null;
+        imageMediaUrl: string | null;
         outputMode: import("./types").OutputMode;
         selectionMode: import("./types").SelectionMode | null;
     }, import("./screenshot-animation").ScreenshotAnimationNodeInputs, import("./screenshot-animation").ScreenshotAnimationNodeOutputs, false> & {

package/dist/automations/nodes/screenshot-animation.d.ts

@@ -8,6 +8,12 @@ export interface ScreenshotAnimationNodeOutputs {
 }
 declare const definition: import("./types").NodeDefinition<"screenshot-animation", "generator", {
     holdDurationMs: number;
+    /** Whether image comes from a variable input port (default: true for backwards compat) */
+    imageIsVariable: boolean;
+    /** Media library ID for static image selection */
+    imageMediaId: string | null;
+    /** URL for static image selection */
+    imageMediaUrl: string | null;
     outputMode: OutputMode;
     selectionMode: SelectionMode | null;
 }, ScreenshotAnimationNodeInputs, ScreenshotAnimationNodeOutputs, false>;

package/dist/automations/nodes/screenshot-animation.js

@@ -14,27 +14,39 @@ const definition = (0, types_1.defineNode)({
     selectionModes: null,
     defaults: {
         holdDurationMs: 500,
+        /** Whether image comes from a variable input port (default: true for backwards compat) */
+        imageIsVariable: false,
+        /** Media library ID for static image selection */
+        imageMediaId: null,
+        /** URL for static image selection */
+        imageMediaUrl: null,
         outputMode: 'per-input',
         selectionMode: null,
     },
-    computePorts: () => ({
-        inputs: [
-            {
+    computePorts: ({ config }) => {
+        const imageIsVariable = config?.imageIsVariable ?? true;
+        const inputs = [];
+        // Only add image port when variable
+        if (imageIsVariable) {
+            inputs.push({
                 id: 'image',
                 type: 'image',
                 isArray: false,
                 required: true,
-            },
-        ],
-        outputs: [
-            {
-                id: 'output',
-                type: 'video',
-                isArray: false,
-                required: true,
-            },
-        ],
-    }),
+            });
+        }
+        return {
+            inputs,
+            outputs: [
+                {
+                    id: 'output',
+                    type: 'video',
+                    isArray: false,
+                    required: true,
+                },
+            ],
+        };
+    },
     generatePreview: (_config, _ctx, cachedOutputs) => {
         return (0, types_1.preview)({
             output: cachedOutputs?.output ?? null,

package/dist/render/types/element.d.ts

@@ -7,6 +7,16 @@
  */
 import type { FitMode, BorderRadiusConfig, FontType, FontWeight, TextAlignment, VerticalAlignment } from './base';
 import type { RelativePositionConfigX, RelativePositionConfigY } from './position';
+/**
+ * Lightweight media reference stored in editor configs.
+ * Structurally compatible with the full Media type from ugcinc.
+ */
+export interface StaticMediaItem {
+    id: string;
+    name: string | null;
+    url: string | null;
+    type: string | null;
+}
 /**
  * Dimension preset keys for image editor
  */
@@ -99,10 +109,8 @@ export interface ImageEditorElement {
     inputId?: string;
     /** Whether this image comes from a variable input port (default: true for backwards compat) */
     imageIsVariable?: boolean;
-    /** Media library ID for static image selection */
-    imageMediaId?: string | null;
-    /** URL for static image selection */
-    imageMediaUrl?: string | null;
+    /** Selected media items for static image selection */
+    imageMedia?: StaticMediaItem[];
     /** How the image fits its container */
     fit?: FitMode;
     /** Opacity percentage 0-100 */

package/dist/render/types/index.d.ts

@@ -6,7 +6,7 @@
  */
 export type { TimeValue, BorderRadiusConfig, FitMode, SegmentType, FontType, FontWeight, TextAlignment, VerticalAlignment, TextDirection, TextWrap, WordBreak, Hyphenation, TextOverflow, TextStyleProperties, } from './base';
 export type { VerticalAnchor, HorizontalAnchor, HorizontalSelfAnchor, VerticalSelfAnchor, RelativePositionConfigX, RelativePositionConfigY, } from './position';
-export type { ImageEditorElement, DimensionPresetKey, DimensionPreset, } from './element';
+export type { ImageEditorElement, StaticMediaItem, DimensionPresetKey, DimensionPreset, } from './element';
 export { DIMENSION_PRESETS } from './element';
 export type { TimeMode, VideoEditorBaseSegment, VideoEditorVisualSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, VideoEditorSegment, VideoEditorChannel, VideoEditorNodeConfig, SegmentTimelinePosition, } from './video';
 export type { BaseSegment, VisualSegment, PictureSegment, VideoSegment, ImageSegment, TextSegment, AudioSegment, ImageSequenceSegment, VideoSequenceSegment, Segment, VisualSegmentUnion, StaticSegment, } from './segment';

package/package.json

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