ugcinc 4.5.89 → 4.5.91

package/README.md

@@ -87,7 +87,6 @@ For the full endpoint reference, all method signatures, data structures, and wor
 
 - Docs: https://docs.ugc.inc
 - Website: https://ugc.inc
-- npm package: https://www.npmjs.com/package/ugcinc
 
 ## License
 

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

@@ -33,18 +33,23 @@ const definition = (0, types_1.defineNode)({
         const editorConfig = config?.videoEditor;
         const inputs = [];
         const addedIds = new Set();
+        const addInputPort = (port) => {
+            if (addedIds.has(port.id))
+                return;
+            addedIds.add(port.id);
+            inputs.push(port);
+        };
         if (editorConfig) {
             editorConfig.channels.forEach(channel => {
                 channel.segments.forEach(segment => {
                     // inputRef exists on all segments except 'text'
                     if (segment.type !== 'text') {
                         const isVar = !('isVariable' in segment) || segment.isVariable !== false;
-                        if (segment.inputRef && !addedIds.has(segment.inputRef) && isVar) {
-                            addedIds.add(segment.inputRef);
+                        if (segment.inputRef && isVar) {
                             const inputType = segment.type === 'video' || segment.type === 'video-sequence' ? 'video'
                                 : segment.type === 'audio' ? ['audio', 'social_audio']
                                     : 'image';
-                            inputs.push({
+                            addInputPort({
                                 id: segment.inputRef,
                                 type: inputType,
                                 isArray: segment.type === 'image-sequence' || segment.type === 'video-sequence',
@@ -54,9 +59,8 @@ const definition = (0, types_1.defineNode)({
                     }
                     // textInputRef only exists on 'text' segments
                     if (segment.type === 'text') {
-                        if (segment.textInputRef && !addedIds.has(segment.textInputRef) && segment.textIsVariable !== false) {
-                            addedIds.add(segment.textInputRef);
-                            inputs.push({
+                        if (segment.textInputRef && segment.textIsVariable !== false) {
+                            addInputPort({
                                 id: segment.textInputRef,
                                 type: 'text',
                                 isArray: false,
@@ -64,6 +68,22 @@ const definition = (0, types_1.defineNode)({
                             });
                         }
                     }
+                    if (segment.startTrimInputRef) {
+                        addInputPort({
+                            id: segment.startTrimInputRef,
+                            type: 'number',
+                            isArray: false,
+                            required: false,
+                        });
+                    }
+                    if (segment.endTrimInputRef) {
+                        addInputPort({
+                            id: segment.endTrimInputRef,
+                            type: 'number',
+                            isArray: false,
+                            required: false,
+                        });
+                    }
                 });
             });
         }
@@ -152,6 +172,28 @@ function omit(obj, keys) {
     }
     return result;
 }
+function getVideoSourceDurationMs({ inputValueDuration, staticMediaDuration, }) {
+    const duration = inputValueDuration ?? staticMediaDuration ?? undefined;
+    return typeof duration === 'number' && duration > 0 ? duration : undefined;
+}
+function getTrimmedVideoWindowMs({ sourceDurationMs, startTrim, endTrim, }) {
+    const safeStartTrim = Math.max(0, startTrim ?? 0);
+    const safeEndTrim = typeof endTrim === 'number' && endTrim > safeStartTrim
+        ? Math.min(endTrim, sourceDurationMs)
+        : sourceDurationMs;
+    return Math.max(1, safeEndTrim - safeStartTrim);
+}
+function getFitSegmentSpeed({ sourceDurationMs, targetDurationMs, startTrim, endTrim, }) {
+    if (!sourceDurationMs || !targetDurationMs || targetDurationMs <= 0) {
+        return undefined;
+    }
+    const sourceWindowMs = getTrimmedVideoWindowMs({
+        sourceDurationMs,
+        startTrim,
+        endTrim,
+    });
+    return Math.max(0.01, sourceWindowMs / targetDurationMs);
+}
 /**
  * Ensure all segments have explicit zIndex values for proper layering in the renderer.
  */
@@ -192,7 +234,25 @@ function transformSegment(segment, inputs) {
                 if (pick?.url) {
                     const keysToOmit = ['inputRef', 'timeMode', 'isVariable', 'staticMedia'];
                     if (segment.type === 'video') {
-                        result = { ...omit(segment, [...keysToOmit]), type: 'video', source: pick.url };
+                        const sourceDurationMs = getVideoSourceDurationMs({
+                            staticMediaDuration: pick.duration,
+                        });
+                        const fittedSpeed = segment.speedMode === 'fit-segment'
+                            ? getFitSegmentSpeed({
+                                sourceDurationMs,
+                                targetDurationMs: segment.duration?.type === 'absolute' ? segment.duration.value : undefined,
+                                startTrim: segment.startTrim,
+                                endTrim: segment.endTrim,
+                            })
+                            : undefined;
+                        result = {
+                            ...omit(segment, [...keysToOmit]),
+                            type: 'video',
+                            source: pick.url,
+                            sourceDurationMs,
+                            speed: fittedSpeed ?? segment.speed,
+                            loop: segment.speedMode === 'fit-segment' ? false : segment.loop,
+                        };
                     }
                     else if (segment.type === 'audio') {
                         result = { ...omit(segment, [...keysToOmit]), type: 'audio', source: pick.url };
@@ -256,7 +316,25 @@ function transformSegment(segment, inputs) {
                 const source = mediaValue.url;
                 const keysToOmit = ['inputRef', 'timeMode'];
                 if (segment.type === 'video') {
-                    result = { ...omit(segment, [...keysToOmit]), type: 'video', source };
+                    const sourceDurationMs = getVideoSourceDurationMs({
+                        inputValueDuration: 'duration' in mediaValue ? mediaValue.duration : undefined,
+                    });
+                    const fittedSpeed = segment.speedMode === 'fit-segment'
+                        ? getFitSegmentSpeed({
+                            sourceDurationMs,
+                            targetDurationMs: segment.duration?.type === 'absolute' ? segment.duration.value : undefined,
+                            startTrim: segment.startTrim,
+                            endTrim: segment.endTrim,
+                        })
+                        : undefined;
+                    result = {
+                        ...omit(segment, [...keysToOmit]),
+                        type: 'video',
+                        source,
+                        sourceDurationMs,
+                        speed: fittedSpeed ?? segment.speed,
+                        loop: segment.speedMode === 'fit-segment' ? false : segment.loop,
+                    };
                 }
                 else if (segment.type === 'audio') {
                     result = { ...omit(segment, [...keysToOmit]), type: 'audio', source };
@@ -312,7 +390,7 @@ function transformSegment(segment, inputs) {
         }
     }
     // Remove UI-only fields
-    const uiOnlyKeys = ['timeMode', 'startTrimInputRef', 'endTrimInputRef', 'isVariable', 'staticMedia', 'textIsVariable'];
+    const uiOnlyKeys = ['timeMode', 'startTrimInputRef', 'endTrimInputRef', 'isVariable', 'staticMedia', 'textIsVariable', 'speedMode'];
     const resultWithUiFields = result;
     for (const key of uiOnlyKeys) {
         if (key in resultWithUiFields) {

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

@@ -16,6 +16,7 @@ export interface StaticMediaItem {
     name: string | null;
     url: string | null;
     type: string | null;
+    duration?: number | null;
 }
 /**
  * Dimension preset keys for image editor

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

@@ -75,9 +75,14 @@ export interface VideoEditorVideoSegment extends VideoEditorVisualSegment {
     isVariable?: boolean;
     /** UI-only: static media items when isVariable is false */
     staticMedia?: StaticMediaItem[];
+    /** UI-only: how playback speed should be resolved */
+    speedMode?: 'manual' | 'fit-segment';
     fit?: FitMode;
     speed?: number;
+    /** Natural duration of the source video in milliseconds */
+    sourceDurationMs?: number;
     volume?: number;
+    loop?: boolean;
     borderRadius?: number | BorderRadiusConfig;
 }
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.5.89",
+  "version": "4.5.91",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -31,9 +31,14 @@
     "ugcinc",
     "api",
     "client",
+    "ugc",
     "tiktok",
+    "instagram",
+    "clawbot",
     "automation",
+    "social-automation",
     "social-media",
+    "social-publishing",
     "content-management",
     "video-rendering"
   ],