ugcinc 4.1.9 → 4.1.10

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

@@ -24,3 +24,7 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 export default definition;
 export type { DestructureSelection, IndexExpression };
 export type DestructureNodeConfig = typeof definition.defaults;
+/**
+ * Convert a structured IndexExpression to an array of indexes.
+ */
+export declare function indexExpressionToIndexes(expr: IndexExpression): number[];

package/dist/automations/nodes/destructure.js

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.indexExpressionToIndexes = indexExpressionToIndexes;
 const types_1 = require("./types");
 const definition = (0, types_1.defineNode)({
     nodeId: 'destructure',
@@ -63,3 +64,26 @@ const definition = (0, types_1.defineNode)({
     },
 });
 exports.default = definition;
+// =============================================================================
+// Utility Functions for Destructure Execution
+// =============================================================================
+/**
+ * Convert a structured IndexExpression to an array of indexes.
+ */
+function indexExpressionToIndexes(expr) {
+    switch (expr.type) {
+        case 'single':
+            return [expr.index];
+        case 'range': {
+            const result = [];
+            for (let i = expr.start; i <= expr.end; i++) {
+                result.push(i);
+            }
+            return result;
+        }
+        case 'list':
+            return expr.indexes;
+        default:
+            return [];
+    }
+}

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

@@ -45,3 +45,23 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 }, false>;
 export default definition;
 export type ImageComposerNodeConfig = typeof definition.defaults;
+/**
+ * Prepared input data for image composer render job
+ */
+export interface ImageComposerRenderInput {
+    /** Resolved editor config with crop boundaries resolved */
+    config: ImageEditorNodeConfig;
+    /** Map of inputId → image URL */
+    imageUrls: Record<string, string>;
+    /** Map of textInputId → text content */
+    textValues: Record<string, string>;
+}
+/**
+ * Prepare image composer data for rendering.
+ * Resolves inputRefs from runtime inputs and structures data for the render service.
+ *
+ * @param editorConfig - The image editor template config
+ * @param inputs - Runtime input values from upstream nodes
+ * @returns Prepared data ready for render submission
+ */
+export declare function prepareImageComposerInput(editorConfig: ImageEditorNodeConfig, inputs: Record<string, unknown>): ImageComposerRenderInput;

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareImageComposerInput = prepareImageComposerInput;
 const types_1 = require("./types");
 const definition = (0, types_1.defineNode)({
     nodeId: 'image-composer',
@@ -133,3 +134,86 @@ const definition = (0, types_1.defineNode)({
     },
 });
 exports.default = definition;
+/**
+ * Prepare image composer data for rendering.
+ * Resolves inputRefs from runtime inputs and structures data for the render service.
+ *
+ * @param editorConfig - The image editor template config
+ * @param inputs - Runtime input values from upstream nodes
+ * @returns Prepared data ready for render submission
+ */
+function prepareImageComposerInput(editorConfig, inputs) {
+    // Build imageUrls map from inputs
+    const imageUrls = {};
+    const textValues = {};
+    // Add background URL if provided
+    if (inputs.background && typeof inputs.background === 'string') {
+        imageUrls.background = inputs.background;
+    }
+    // Process each element to extract image URLs and text values
+    for (const elem of editorConfig.elements) {
+        if (elem.type === 'image' && elem.inputId) {
+            const value = inputs[elem.inputId];
+            if (typeof value === 'string') {
+                imageUrls[elem.inputId] = value;
+            }
+        }
+        else if (elem.type === 'text' && elem.textInputId) {
+            const value = inputs[elem.textInputId];
+            if (typeof value === 'string') {
+                textValues[elem.textInputId] = value;
+            }
+        }
+    }
+    // Resolve crop boundary inputRefs (clone config to avoid mutation)
+    const resolvedConfig = JSON.parse(JSON.stringify(editorConfig));
+    if (resolvedConfig.dynamicCrop) {
+        // Resolve vertical crop boundaries
+        if (resolvedConfig.dynamicCrop.vertical?.startBoundary?.inputRef) {
+            const inputRef = resolvedConfig.dynamicCrop.vertical.startBoundary.inputRef;
+            const elementId = inputs[inputRef];
+            if (typeof elementId === 'string' && elementId) {
+                resolvedConfig.dynamicCrop.vertical.startBoundary = { elementId };
+            }
+            else {
+                resolvedConfig.dynamicCrop.vertical.startBoundary = undefined;
+            }
+        }
+        if (resolvedConfig.dynamicCrop.vertical?.endBoundary?.inputRef) {
+            const inputRef = resolvedConfig.dynamicCrop.vertical.endBoundary.inputRef;
+            const elementId = inputs[inputRef];
+            if (typeof elementId === 'string' && elementId) {
+                resolvedConfig.dynamicCrop.vertical.endBoundary = { elementId };
+            }
+            else {
+                resolvedConfig.dynamicCrop.vertical.endBoundary = undefined;
+            }
+        }
+        // Resolve horizontal crop boundaries
+        if (resolvedConfig.dynamicCrop.horizontal?.startBoundary?.inputRef) {
+            const inputRef = resolvedConfig.dynamicCrop.horizontal.startBoundary.inputRef;
+            const elementId = inputs[inputRef];
+            if (typeof elementId === 'string' && elementId) {
+                resolvedConfig.dynamicCrop.horizontal.startBoundary = { elementId };
+            }
+            else {
+                resolvedConfig.dynamicCrop.horizontal.startBoundary = undefined;
+            }
+        }
+        if (resolvedConfig.dynamicCrop.horizontal?.endBoundary?.inputRef) {
+            const inputRef = resolvedConfig.dynamicCrop.horizontal.endBoundary.inputRef;
+            const elementId = inputs[inputRef];
+            if (typeof elementId === 'string' && elementId) {
+                resolvedConfig.dynamicCrop.horizontal.endBoundary = { elementId };
+            }
+            else {
+                resolvedConfig.dynamicCrop.horizontal.endBoundary = undefined;
+            }
+        }
+    }
+    return {
+        config: resolvedConfig,
+        imageUrls,
+        textValues,
+    };
+}

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

@@ -1,4 +1,4 @@
-import type { VideoEditorChannel, DimensionPresetKey } from '../../render/types';
+import type { VideoEditorNodeConfig, VideoEditorChannel, DimensionPresetKey } from '../../render/types';
 declare const definition: import("./types").NodeDefinition<"generator", {
     videoEditor: {
         width: number;
@@ -12,3 +12,19 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 }, false>;
 export default definition;
 export type VideoComposerNodeConfig = typeof definition.defaults;
+/**
+ * Prepared input data for video composer render job
+ */
+export interface VideoComposerRenderInput {
+    /** Resolved editor config with segments transformed */
+    config: VideoEditorNodeConfig;
+}
+/**
+ * Prepare video composer data for rendering.
+ * Resolves inputRefs from runtime inputs and structures data for the render service.
+ *
+ * @param editorConfig - The video editor template config
+ * @param inputs - Runtime input values from upstream nodes
+ * @returns Prepared data ready for render submission
+ */
+export declare function prepareVideoComposerInput(editorConfig: VideoEditorNodeConfig, inputs: Record<string, unknown>): VideoComposerRenderInput;

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

@@ -1,5 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.prepareVideoComposerInput = prepareVideoComposerInput;
 const types_1 = require("./types");
 const definition = (0, types_1.defineNode)({
     nodeId: 'video-composer',
@@ -115,3 +116,178 @@ const definition = (0, types_1.defineNode)({
     },
 });
 exports.default = definition;
+/**
+ * Omit specified keys from an object
+ */
+function omit(obj, keys) {
+    const result = { ...obj };
+    for (const key of keys) {
+        delete result[key];
+    }
+    return result;
+}
+/**
+ * Ensure all segments have explicit zIndex values for proper layering in the renderer.
+ */
+function normalizeZIndex(editor) {
+    return {
+        ...editor,
+        channels: editor.channels.map(channel => ({
+            ...channel,
+            segments: channel.segments.map(segment => {
+                // Audio segments don't have zIndex
+                if (segment.type === 'audio') {
+                    return segment;
+                }
+                // If zIndex is already set, keep it
+                if (typeof segment.zIndex === 'number') {
+                    return segment;
+                }
+                // Overlays get zIndex 1, base segments get 0
+                const isOverlay = segment.type === 'text' || segment.parentId !== undefined;
+                return { ...segment, zIndex: isOverlay ? 1 : 0 };
+            }),
+        })),
+    };
+}
+/**
+ * Transform a segment by resolving inputRefs to actual source URLs.
+ * Returns null if the segment references an optional input that was skipped.
+ */
+function transformSegment(segment, inputs) {
+    let result = { ...segment };
+    // Handle inputRef for media segments
+    if ('inputRef' in segment && segment.inputRef) {
+        const inputKey = segment.inputRef;
+        const value = inputs[inputKey];
+        if (value === undefined || value === null) {
+            if (segment.required === false) {
+                return null; // Optional segment with missing input
+            }
+            throw new Error(`Required segment input "${inputKey}" was not provided`);
+        }
+        // Image sequence segments expect array of URLs
+        if (segment.type === 'image-sequence') {
+            if (!Array.isArray(value)) {
+                throw new Error(`Image sequence expects string[] for "${inputKey}", got ${typeof value}`);
+            }
+            let items = value;
+            if (segment.itemCountMode === 'static' && segment.staticItemCount !== undefined) {
+                items = items.slice(0, segment.staticItemCount);
+            }
+            const keysToOmit = ['inputRef', 'timeMode', 'itemCountMode', 'staticItemCount'];
+            const transformed = {
+                ...omit(segment, [...keysToOmit]),
+                type: 'image-sequence',
+                source: '',
+                items,
+            };
+            result = transformed;
+        }
+        else if (segment.type === 'video-sequence') {
+            if (!Array.isArray(value)) {
+                throw new Error(`Video sequence expects string[] for "${inputKey}", got ${typeof value}`);
+            }
+            let items = value;
+            if (segment.itemCountMode === 'static' && segment.staticItemCount !== undefined) {
+                items = items.slice(0, segment.staticItemCount);
+            }
+            const keysToOmit = ['inputRef', 'timeMode', 'itemCountMode', 'staticItemCount'];
+            const transformed = {
+                ...omit(segment, [...keysToOmit]),
+                type: 'video-sequence',
+                source: '',
+                items,
+            };
+            result = transformed;
+        }
+        else {
+            if (typeof value !== 'string') {
+                throw new Error(`Segment expects string URL for "${inputKey}", got ${typeof value}`);
+            }
+            const keysToOmit = ['inputRef', 'timeMode'];
+            if (segment.type === 'video') {
+                result = { ...omit(segment, [...keysToOmit]), type: 'video', source: value };
+            }
+            else if (segment.type === 'audio') {
+                result = { ...omit(segment, [...keysToOmit]), type: 'audio', source: value };
+            }
+            else if (segment.type === 'image') {
+                result = { ...omit(segment, [...keysToOmit]), type: 'image', source: value };
+            }
+        }
+    }
+    // Handle textInputRef for text segments
+    if (segment.type === 'text' && segment.textInputRef) {
+        const inputKey = segment.textInputRef;
+        const value = inputs[inputKey];
+        if (value === undefined || value === null) {
+            if (segment.required === false) {
+                return null;
+            }
+            throw new Error(`Required text segment input "${inputKey}" was not provided`);
+        }
+        if (typeof value !== 'string') {
+            throw new Error(`Text segment expects string for "${inputKey}", got ${typeof value}`);
+        }
+        result = { ...omit(segment, ['textInputRef', 'timeMode']), type: 'text', source: '', text: value };
+    }
+    // Handle trim inputRefs
+    if (segment.startTrimInputRef) {
+        const value = inputs[segment.startTrimInputRef];
+        if (value !== undefined) {
+            const numValue = typeof value === 'number' ? value : Number(value);
+            if (!isNaN(numValue)) {
+                result = { ...result, startTrim: numValue };
+            }
+        }
+    }
+    if (segment.endTrimInputRef) {
+        const value = inputs[segment.endTrimInputRef];
+        if (value !== undefined) {
+            const numValue = typeof value === 'number' ? value : Number(value);
+            if (!isNaN(numValue)) {
+                result = { ...result, endTrim: numValue };
+                const startTrim = result.startTrim ?? 0;
+                if (numValue > startTrim) {
+                    result = { ...result, duration: { type: 'absolute', value: numValue - startTrim } };
+                }
+            }
+        }
+    }
+    // Remove UI-only fields
+    const uiOnlyKeys = ['timeMode', 'startTrimInputRef', 'endTrimInputRef'];
+    const resultWithUiFields = result;
+    for (const key of uiOnlyKeys) {
+        if (key in resultWithUiFields) {
+            delete resultWithUiFields[key];
+        }
+    }
+    return resultWithUiFields;
+}
+/**
+ * Prepare video composer data for rendering.
+ * Resolves inputRefs from runtime inputs and structures data for the render service.
+ *
+ * @param editorConfig - The video editor template config
+ * @param inputs - Runtime input values from upstream nodes
+ * @returns Prepared data ready for render submission
+ */
+function prepareVideoComposerInput(editorConfig, inputs) {
+    // Transform all segments by resolving inputRefs
+    const transformedChannels = editorConfig.channels.map(channel => ({
+        ...channel,
+        segments: channel.segments
+            .map(segment => transformSegment(segment, inputs))
+            .filter((segment) => segment !== null),
+    }));
+    const transformedConfig = {
+        ...editorConfig,
+        channels: transformedChannels,
+    };
+    // Normalize zIndex for proper layering
+    const normalizedConfig = normalizeZIndex(transformedConfig);
+    return {
+        config: normalizedConfig,
+    };
+}

package/dist/automations/selection.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Selection Utilities
+ *
+ * Deterministic selection functions for source nodes.
+ * Used by executors to pick items from pools at runtime.
+ */
+import type { SelectionMode } from './nodes/types';
+/**
+ * Select an item from a pool based on selection mode and executor index.
+ *
+ * For 'sequential' mode: picks items in order, cycling when exhausted.
+ * For 'random' mode: deterministically shuffles the pool using the seed,
+ * then picks by index. This ensures:
+ * - Same seed = same shuffle = reproducible results
+ * - Each executor gets a different item (until pool is exhausted)
+ * - When pool is exhausted, cycles through again
+ *
+ * @param pool - Array of items to select from
+ * @param mode - Selection mode ('random' or 'sequential')
+ * @param index - Executor index (0, 1, 2...)
+ * @param seed - Seed string for deterministic randomness (e.g., runId + nodeId)
+ * @returns The selected item, or undefined if pool is empty
+ */
+export declare function selectFromPool<T>(pool: T[], mode: SelectionMode, index: number, seed: string): T | undefined;

package/dist/automations/selection.js

@@ -0,0 +1,61 @@
+"use strict";
+/**
+ * Selection Utilities
+ *
+ * Deterministic selection functions for source nodes.
+ * Used by executors to pick items from pools at runtime.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.selectFromPool = selectFromPool;
+/**
+ * Simple hash function for deterministic pseudo-randomness
+ */
+function simpleHash(str) {
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash) + char;
+        hash = hash & hash; // Convert to 32bit integer
+    }
+    return hash;
+}
+/**
+ * Deterministically shuffle an array using a seed.
+ * Same seed always produces the same shuffle order.
+ */
+function seededShuffle(array, seed) {
+    const result = [...array];
+    let currentSeed = simpleHash(seed);
+    for (let i = result.length - 1; i > 0; i--) {
+        currentSeed = simpleHash(seed + currentSeed.toString());
+        const j = Math.abs(currentSeed) % (i + 1);
+        [result[i], result[j]] = [result[j], result[i]];
+    }
+    return result;
+}
+/**
+ * Select an item from a pool based on selection mode and executor index.
+ *
+ * For 'sequential' mode: picks items in order, cycling when exhausted.
+ * For 'random' mode: deterministically shuffles the pool using the seed,
+ * then picks by index. This ensures:
+ * - Same seed = same shuffle = reproducible results
+ * - Each executor gets a different item (until pool is exhausted)
+ * - When pool is exhausted, cycles through again
+ *
+ * @param pool - Array of items to select from
+ * @param mode - Selection mode ('random' or 'sequential')
+ * @param index - Executor index (0, 1, 2...)
+ * @param seed - Seed string for deterministic randomness (e.g., runId + nodeId)
+ * @returns The selected item, or undefined if pool is empty
+ */
+function selectFromPool(pool, mode, index, seed) {
+    if (pool.length === 0)
+        return undefined;
+    if (mode === 'sequential') {
+        return pool[index % pool.length];
+    }
+    // Random mode - shuffle deterministically then pick by index
+    const shuffled = seededShuffle(pool, seed);
+    return shuffled[index % shuffled.length];
+}

package/dist/automations/types.d.ts

@@ -5,6 +5,17 @@
  */
 import type { ObjectSchemaField, SelectionMode, OutputMode, NodeCategory } from './nodes/types';
 import type { NodeType, UserCreatableNodeType, WorkflowConfig, InternalNodeType } from './nodes';
+/**
+ * Config type for internal node types (created dynamically at runtime).
+ * Internal nodes use generic config since they don't have static definitions.
+ */
+export type InternalWorkflowConfig = {
+    [K in InternalNodeType]: Record<string, unknown>;
+};
+/**
+ * Combined config lookup for all node types (user-creatable + internal).
+ */
+export type AllWorkflowConfig = WorkflowConfig & InternalWorkflowConfig;
 /**
  * Media type for automation nodes
  */
@@ -252,7 +263,7 @@ export interface FlowControlOutput {
  * Context passed to executor-based node execution.
  * Generic on node type - config is automatically derived from the node type.
  */
-export interface ExecutorContext<TType extends UserCreatableNodeType = UserCreatableNodeType> {
+export interface ExecutorContext<TType extends NodeType = NodeType> {
     /** Database ID of this executor */
     executorId: string;
     /** Run ID this executor belongs to */
@@ -264,7 +275,7 @@ export interface ExecutorContext<TType extends UserCreatableNodeType = UserCreat
     /** Node type */
     type: TType;
     /** Node config - type is derived from the node type */
-    config: WorkflowConfig[TType];
+    config: AllWorkflowConfig[TType];
     /** Input values read from incoming edges (portId -> value) */
     inputs: Record<string, unknown>;
 }
@@ -272,7 +283,7 @@ export interface ExecutorContext<TType extends UserCreatableNodeType = UserCreat
  * Executor for synchronous nodes.
  * Generic on node type - config type is automatically derived.
  */
-export interface NodeExecutor<TType extends UserCreatableNodeType, TOutput = unknown> {
+export interface NodeExecutor<TType extends NodeType, TOutput = unknown> {
     type: TType;
     /**
      * Execute the node and return a single output value.
@@ -296,7 +307,7 @@ export type ExecutorAsyncJobStatus<TOutput = unknown> = {
  * Executor for asynchronous nodes (video-editor, generate-image, workflow).
  * Uses submit/poll pattern for durable workflows.
  */
-export interface AsyncNodeExecutor<TType extends UserCreatableNodeType, TOutput = unknown> extends Omit<NodeExecutor<TType, TOutput>, 'execute'> {
+export interface AsyncNodeExecutor<TType extends NodeType, TOutput = unknown> extends Omit<NodeExecutor<TType, TOutput>, 'execute'> {
     isAsync: true;
     /** Submit job - returns job ID for polling */
     submitJob: (ctx: ExecutorContext<TType>) => Promise<{
@@ -309,14 +320,14 @@ export interface AsyncNodeExecutor<TType extends UserCreatableNodeType, TOutput
  * Any node executor - used for registries that hold executors of different types
  */
 export type AnyNodeExecutor = {
-    [K in UserCreatableNodeType]: NodeExecutor<K, unknown>;
-}[UserCreatableNodeType];
+    [K in NodeType]: NodeExecutor<K, unknown>;
+}[NodeType];
 /**
  * Any async node executor - used for registries that hold executors of different types
  */
 export type AnyAsyncNodeExecutor = {
-    [K in UserCreatableNodeType]: AsyncNodeExecutor<K, unknown>;
-}[UserCreatableNodeType];
+    [K in NodeType]: AsyncNodeExecutor<K, unknown>;
+}[NodeType];
 /**
  * Type guard to check if an executor is async
  */

package/dist/index.d.ts

@@ -17,6 +17,7 @@ export { areTypesCompatible, computePortsForNode, getAllNodes, getNodeByType, ge
 export { nodeDefinitions, internalNodeTypes, isAsyncExecutor, formatPortType } from './automations/types';
 export { isEditModel } from './automations/nodes/generate-image';
 export { isImageToVideoModel } from './automations/nodes/generate-video';
+export { selectFromPool } from './automations/selection';
 export { portId, isValidPortId, portIdToTitle, normalizeToPortId, PortIdSchema } from './port-id';
 export type { PortId } from './port-id';
 export type { ClientConfig } from './base';
@@ -29,7 +30,8 @@ export type { UserMedia, MediaUse, SocialAudio, Media, GetMediaParams, GetSocial
 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 { VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, TimeValue, TimeMode, SegmentTimelinePosition, DeduplicationInput, ImageEditorElement, DimensionPresetKey, } from './render/types';
-export type { ImageEditorNodeConfig, ImageComposerNodeConfig } from './automations/nodes/image-composer';
+export type { ImageEditorNodeConfig, ImageComposerNodeConfig, ImageComposerRenderInput } from './automations/nodes/image-composer';
+export { prepareImageComposerInput } from './automations/nodes/image-composer';
 export type { AccountNodeConfig } from './automations/nodes/account';
 export type { AutoCaptionNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, } from './automations/nodes/auto-caption';
 export type { AutoPostNodeConfig, AutoPostMode, PostSchedulingMode, } from './automations/nodes/auto-post';
@@ -40,6 +42,7 @@ export type { CreateDmNodeConfig, CreateDmMessage, DmPlatform, } from './automat
 export type { CustomModelNodeConfig, CustomModelOutputType, CustomModelInputParam, } from './automations/nodes/custom-model';
 export type { DeduplicateNodeConfig } from './automations/nodes/deduplicate';
 export type { DestructureNodeConfig, DestructureSelection, IndexExpression, } from './automations/nodes/destructure';
+export { indexExpressionToIndexes } from './automations/nodes/destructure';
 export type { ForEachNodeConfig, ForEachOutputProperty, ForEachInputPort, } from './automations/nodes/for-each';
 export type { GenerateImageNodeConfig, ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, } from './automations/nodes/generate-image';
 export type { GenerateVideoNodeConfig, VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, } from './automations/nodes/generate-video';
@@ -59,9 +62,10 @@ export type { ScreenshotAnimationNodeConfig } from './automations/nodes/screensh
 export type { SocialAudioNodeConfig } from './automations/nodes/social-audio';
 export type { TextNodeConfig } from './automations/nodes/text';
 export type { TranscriptNodeConfig } from './automations/nodes/transcript';
-export type { VideoComposerNodeConfig } from './automations/nodes/video-composer';
+export type { VideoComposerNodeConfig, VideoComposerRenderInput } from './automations/nodes/video-composer';
+export { prepareVideoComposerInput } from './automations/nodes/video-composer';
 export type { VideoImportNodeConfig, VideoImportPlatform, VideoImportQuality, } from './automations/nodes/video-import';
-export type { MediaType, BasePortType, EnumOption, NodeOutputValues, NodePort, ResolvedPort, ResolvedPorts, ComputedNode, OutputSchemaProperty, WorkflowNodeDefinition, CanvasState, WorkflowDefinition, TemplateNode, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, AccountData, FlowControlOutput, ExecutorContext, NodeExecutor, AsyncNodeExecutor, AnyNodeExecutor, AnyAsyncNodeExecutor, ExecutorAsyncJobStatus, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, } from './automations/types';
+export type { MediaType, BasePortType, EnumOption, NodeOutputValues, NodePort, ResolvedPort, ResolvedPorts, ComputedNode, OutputSchemaProperty, WorkflowNodeDefinition, CanvasState, WorkflowDefinition, TemplateNode, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, AccountData, FlowControlOutput, ExecutorContext, NodeExecutor, AsyncNodeExecutor, AnyNodeExecutor, AnyAsyncNodeExecutor, ExecutorAsyncJobStatus, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, InternalWorkflowConfig, AllWorkflowConfig, } from './automations/types';
 export type { NodeDefinition, NodeType, UserCreatableNodeType, NodeConfig, WorkflowConfig, InternalNodeType, } from './automations/nodes';
 export type { SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeCategory, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, ObjectSchemaField, MediaItemType, MediaNodeSelectionType, ResolvedPreview, } from './automations/nodes/types';
 export type { SuccessResponse, ErrorResponse, ApiResponse, } from './types';

package/dist/index.js

@@ -5,7 +5,7 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LLMProviders = exports.IfLogicOperators = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.isImageToVideoModel = exports.isEditModel = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.resolveNodePreview = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.checkCrossContextViolation = exports.getForEachContext = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.computePortsForNode = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.prepareVideoComposerInput = exports.LLMProviders = exports.IfLogicOperators = exports.indexExpressionToIndexes = exports.prepareImageComposerInput = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = exports.isImageToVideoModel = exports.isEditModel = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.resolveNodePreview = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.checkCrossContextViolation = exports.getForEachContext = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.computePortsForNode = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
 // =============================================================================
 // Client Exports
 // =============================================================================
@@ -70,13 +70,21 @@ var generate_image_1 = require("./automations/nodes/generate-image");
 Object.defineProperty(exports, "isEditModel", { enumerable: true, get: function () { return generate_image_1.isEditModel; } });
 var generate_video_1 = require("./automations/nodes/generate-video");
 Object.defineProperty(exports, "isImageToVideoModel", { enumerable: true, get: function () { return generate_video_1.isImageToVideoModel; } });
+var selection_1 = require("./automations/selection");
+Object.defineProperty(exports, "selectFromPool", { enumerable: true, get: function () { return selection_1.selectFromPool; } });
 var port_id_1 = require("./port-id");
 Object.defineProperty(exports, "portId", { enumerable: true, get: function () { return port_id_1.portId; } });
 Object.defineProperty(exports, "isValidPortId", { enumerable: true, get: function () { return port_id_1.isValidPortId; } });
 Object.defineProperty(exports, "portIdToTitle", { enumerable: true, get: function () { return port_id_1.portIdToTitle; } });
 Object.defineProperty(exports, "normalizeToPortId", { enumerable: true, get: function () { return port_id_1.normalizeToPortId; } });
 Object.defineProperty(exports, "PortIdSchema", { enumerable: true, get: function () { return port_id_1.PortIdSchema; } });
+var image_composer_1 = require("./automations/nodes/image-composer");
+Object.defineProperty(exports, "prepareImageComposerInput", { enumerable: true, get: function () { return image_composer_1.prepareImageComposerInput; } });
+var destructure_1 = require("./automations/nodes/destructure");
+Object.defineProperty(exports, "indexExpressionToIndexes", { enumerable: true, get: function () { return destructure_1.indexExpressionToIndexes; } });
 var if_1 = require("./automations/nodes/if");
 Object.defineProperty(exports, "IfLogicOperators", { enumerable: true, get: function () { return if_1.IfLogicOperators; } });
 var llm_1 = require("./automations/nodes/llm");
 Object.defineProperty(exports, "LLMProviders", { enumerable: true, get: function () { return llm_1.LLMProviders; } });
+var video_composer_1 = require("./automations/nodes/video-composer");
+Object.defineProperty(exports, "prepareVideoComposerInput", { enumerable: true, get: function () { return video_composer_1.prepareVideoComposerInput; } });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "4.1.9",
+  "version": "4.1.10",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -41,7 +41,7 @@
   "license": "MIT",
   "dependencies": {
     "@remotion/player": "^4.0.0",
-    "ugcinc": "^4.1.6",
+    "ugcinc": "^4.1.9",
     "zod": "^3.23.0"
   },
   "peerDependencies": {