ugcinc 3.88.5 → 4.0.0

package/dist/automations.d.ts

@@ -3,11 +3,11 @@ import { BaseClient } from './base';
 /**
  * Check if two port types are compatible for connection
  * A connection is valid if:
- * 1. The types match exactly, OR
- * 2. The source is an array type and target is 'object', OR
- * 3. The source is a PortType[] and includes the target type, OR
- * 4. The target is a PortType[] and includes the source type, OR
- * 5. Both are PortType[] and have at least one common type
+ * 1. The types match exactly (same base type and same isArray), OR
+ * 2. The source is an array type and target is 'object' (non-array), OR
+ * 3. The source is a PortType[] and includes a compatible type, OR
+ * 4. The target is a PortType[] and includes a compatible type, OR
+ * 5. Both are PortType[] and have at least one common compatible type
  *
  * Note: Array inputs are strict - they only accept exact matches
  */

package/dist/automations.js

@@ -5,36 +5,40 @@ exports.areTypesCompatible = areTypesCompatible;
 exports.getAllNodes = getAllNodes;
 exports.getNodeByType = getNodeByType;
 exports.getOutputSchema = getOutputSchema;
+const types_1 = require("./types");
 const base_1 = require("./base");
 /**
- * Array types for collections
+ * Helper to check if a PortType or array of PortTypes is an array
+ * Used internally to normalize port types for comparison
  */
-const ARRAY_TYPES = ['image[]', 'video[]', 'audio[]', 'text[]', 'object[]', 'account[]', 'social_audio[]', 'boolean[]'];
+function isPortTypeArray(pt) {
+    return Array.isArray(pt) && pt.length > 0 && typeof pt[0] === 'object' && 'type' in pt[0];
+}
 /**
  * Check if two port types are compatible for connection
  * A connection is valid if:
- * 1. The types match exactly, OR
- * 2. The source is an array type and target is 'object', OR
- * 3. The source is a PortType[] and includes the target type, OR
- * 4. The target is a PortType[] and includes the source type, OR
- * 5. Both are PortType[] and have at least one common type
+ * 1. The types match exactly (same base type and same isArray), OR
+ * 2. The source is an array type and target is 'object' (non-array), OR
+ * 3. The source is a PortType[] and includes a compatible type, OR
+ * 4. The target is a PortType[] and includes a compatible type, OR
+ * 5. Both are PortType[] and have at least one common compatible type
  *
  * Note: Array inputs are strict - they only accept exact matches
  */
 function areTypesCompatible({ sourceType, targetType, }) {
-    const sourceTypes = Array.isArray(sourceType) ? sourceType : [sourceType];
-    const targetTypes = Array.isArray(targetType) ? targetType : [targetType];
+    const sourceTypes = isPortTypeArray(sourceType) ? sourceType : [sourceType];
+    const targetTypes = isPortTypeArray(targetType) ? targetType : [targetType];
     return sourceTypes.some(st => {
         return targetTypes.some(tt => {
-            // Exact match
-            if (st === tt)
+            // Exact match (same base type and same isArray)
+            if (st.type === tt.type && st.isArray === tt.isArray)
                 return true;
-            // Object inputs accept any array type (backwards compatibility with for-each, etc.)
-            if (tt === 'object' && ARRAY_TYPES.includes(st)) {
+            // Object inputs (non-array) accept any array type (backwards compatibility with for-each, etc.)
+            if (tt.type === 'object' && !tt.isArray && st.isArray) {
                 return true;
             }
             // Array inputs are strict - no other compatibility
-            if (ARRAY_TYPES.includes(tt)) {
+            if (tt.isArray) {
                 return false;
             }
             return false;
@@ -271,14 +275,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "url",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "video",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -293,7 +297,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "account",
-                    type: "account",
+                    type: (0, types_1.portType)('account'),
                     required: true,
                 },
             ],
@@ -308,7 +312,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "text",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
             ],
@@ -323,14 +327,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "background",
-                    type: "image",
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "output",
-                    type: "image",
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 },
             ],
@@ -345,7 +349,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -369,19 +373,19 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "media",
-                    type: ["video", "audio"],
+                    type: [(0, types_1.portType)('video'), (0, types_1.portType)('audio')],
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "text",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
                 {
                     id: "segments",
-                    type: "object",
+                    type: (0, types_1.portType)('object'),
                     required: true,
                     itemSchema: {
                         text: { type: 'string' },
@@ -400,14 +404,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "video",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "output",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -421,14 +425,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "image",
-                    type: "image",
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "output",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -447,7 +451,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    type: "image",
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 },
             ],
@@ -461,14 +465,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "video",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "output",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -494,7 +498,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "prompt",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
                 // Image input is dynamically added for image-to-video models
@@ -502,7 +506,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    type: "video",
+                    type: (0, types_1.portType)('video'),
                     required: true,
                 },
             ],
@@ -516,7 +520,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "prompt",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
                 // Image input is dynamically added for edit models
@@ -524,7 +528,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    type: "image",
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 },
             ],
@@ -550,7 +554,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "array",
-                    type: ["image[]", "video[]", "audio[]", "text[]", "object[]"],
+                    type: [(0, types_1.portType)('image', true), (0, types_1.portType)('video', true), (0, types_1.portType)('audio', true), (0, types_1.portType)('text', true), (0, types_1.portType)('object', true)],
                     required: true,
                 },
             ],
@@ -596,14 +600,14 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "input",
-                    type: "boolean",
+                    type: (0, types_1.portType)('boolean'),
                     required: true,
                 },
             ],
             outputs: [
                 {
                     id: "output",
-                    type: "boolean",
+                    type: (0, types_1.portType)('boolean'),
                     required: false,
                 },
             ],
@@ -631,7 +635,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "key",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 },
             ],
@@ -649,7 +653,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "value",
-                    type: ["image", "video", "audio", "text", "object", "boolean", "number"],
+                    type: [(0, types_1.portType)('image'), (0, types_1.portType)('video'), (0, types_1.portType)('audio'), (0, types_1.portType)('text'), (0, types_1.portType)('object'), (0, types_1.portType)('boolean'), (0, types_1.portType)('number')],
                     required: true,
                 },
             ],
@@ -657,7 +661,7 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "array",
-                    type: ["image[]", "video[]", "audio[]", "text[]", "object[]"],
+                    type: [(0, types_1.portType)('image', true), (0, types_1.portType)('video', true), (0, types_1.portType)('audio', true), (0, types_1.portType)('text', true), (0, types_1.portType)('object', true)],
                     required: true,
                 },
             ],
@@ -672,7 +676,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "array",
-                    type: ["image[]", "video[]", "audio[]", "text[]", "object[]"],
+                    type: [(0, types_1.portType)('image', true), (0, types_1.portType)('video', true), (0, types_1.portType)('audio', true), (0, types_1.portType)('text', true), (0, types_1.portType)('object', true)],
                     required: true,
                 },
             ],
@@ -692,17 +696,17 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "account",
-                    type: "account",
+                    type: (0, types_1.portType)('account'),
                     required: true,
                 },
                 {
                     id: "caption",
-                    type: "text",
+                    type: (0, types_1.portType)('text'),
                     required: false,
                 },
                 {
                     id: "social-audio",
-                    type: "social_audio",
+                    type: (0, types_1.portType)('social_audio'),
                     required: false,
                 },
             ],
@@ -727,7 +731,7 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "result",
-                    type: ["image", "video", "audio", "text", "social_audio", "account", "boolean", "object"],
+                    type: [(0, types_1.portType)('image'), (0, types_1.portType)('video'), (0, types_1.portType)('audio'), (0, types_1.portType)('text'), (0, types_1.portType)('social_audio'), (0, types_1.portType)('account'), (0, types_1.portType)('boolean'), (0, types_1.portType)('object')],
                     required: true,
                 },
             ],

package/dist/index.d.ts

@@ -21,4 +21,4 @@ export { MediaClient } from './media';
 export { CommentsClient } from './comments';
 export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, SubmitScreenshotAnimationRenderJobParams, SubmitInstagramDmRenderJobParams, SubmitIMessageDmRenderJobParams, IgDmMessage, ImDmMessage, RenderVideoEditorConfig, } from './render';
 export type { ClientConfig, } from './base';
-export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, VideoEditorNodeInput, DimensionPresetKey, EditorChannel, TimeValue, DeduplicationInput, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, ResolvedPort, ResolvedPorts, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ObjectSchemaFieldLevel3, ObjectSchemaFieldLevel2, ObjectSchemaField, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeOutput, MediaNodeConfig, PostSchedulingMode, PostSchedulingConfig, AutoPostMode, AutoPostInputType, AutoPostInput, AutoPostNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, RandomValueType, RandomInputPort, RandomNodeMode, RandomNodeConfig, IfLogicOperator, IfBooleanInput, IfPassthroughInput, IfNodeConfig, RandomRouteBranch, RandomRoutePassthroughInput, RandomRouteObjectField, RandomRouteNodeConfig, BranchDefinition, BranchValueConfig, BranchPassthroughInput, BranchNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, ScreenshotAnimationNodeConfig, CreateDmMessage, CreateDmNodeConfig, DestructureSelection, DestructureNodeConfig, ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, ImageGenerationNodeConfig, CustomModelParamType, CustomModelInputParam, CustomModelNodeConfig, VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, VideoGenerationNodeConfig, ArrayType, PortType, LLMOutputField, LLMApiKeys, LLMNodeConfig, UserMedia, SocialAudio, Media, MediaUse, GetMediaParams, CreateSocialAudioParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, AccountData, FlowControlOutput, NodeType, ExecutorContext, NodeExecutor, ExecutorAsyncJobStatus, AsyncNodeExecutor, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, VideoEditorNodeInput, DimensionPresetKey, EditorChannel, TimeValue, DeduplicationInput, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, ResolvedPort, ResolvedPorts, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ObjectSchemaFieldLevel3, ObjectSchemaFieldLevel2, ObjectSchemaField, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeOutput, MediaNodeConfig, PostSchedulingMode, PostSchedulingConfig, AutoPostMode, AutoPostInputType, AutoPostInput, AutoPostNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, RandomValueType, RandomInputPort, RandomNodeMode, RandomNodeConfig, IfLogicOperator, IfBooleanInput, IfPassthroughInput, IfNodeConfig, RandomRouteBranch, RandomRoutePassthroughInput, RandomRouteObjectField, RandomRouteNodeConfig, BranchDefinition, BranchValueConfig, BranchPassthroughInput, BranchNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, ScreenshotAnimationNodeConfig, CreateDmMessage, CreateDmNodeConfig, DestructureSelection, DestructureNodeConfig, ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, ImageGenerationNodeConfig, CustomModelParamType, CustomModelInputParam, CustomModelNodeConfig, VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, VideoGenerationNodeConfig, BasePortType, PortType, portType, formatPortType, LegacyPortType, isLegacyPortType, fromLegacyPortType, toLegacyPortType, normalizePortType, normalizePortTypes, LLMOutputField, LLMApiKeys, LLMNodeConfig, UserMedia, SocialAudio, Media, MediaUse, GetMediaParams, CreateSocialAudioParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, AccountData, FlowControlOutput, NodeType, ExecutorContext, NodeExecutor, ExecutorAsyncJobStatus, AsyncNodeExecutor, } from './types';

package/dist/ports.js

@@ -11,6 +11,7 @@ exports.extractTemplateVariables = extractTemplateVariables;
 exports.computeInputPorts = computeInputPorts;
 exports.computeOutputPorts = computeOutputPorts;
 exports.isInputPortRequired = isInputPortRequired;
+const types_1 = require("./types");
 const automations_1 = require("./automations");
 /**
  * Extract template variables from text (e.g., "Hello {{name}}" -> ["name"])
@@ -42,7 +43,7 @@ function computeInputPorts({ node }) {
             return baseInputs;
         return variables.map(variable => ({
             id: variable,
-            type: 'text',
+            type: (0, types_1.portType)('text'),
             required: false,
         }));
     }
@@ -56,7 +57,7 @@ function computeInputPorts({ node }) {
         if (editorConfig.backgroundType !== 'color') {
             dynamicInputs.push({
                 id: 'background',
-                type: 'image',
+                type: (0, types_1.portType)('image'),
                 required: true,
             });
         }
@@ -65,14 +66,14 @@ function computeInputPorts({ node }) {
             if (elem.type === 'image' && elem.inputId) {
                 dynamicInputs.push({
                     id: elem.inputId,
-                    type: 'image',
+                    type: (0, types_1.portType)('image'),
                     required: true,
                 });
             }
             else if (elem.type === 'text' && elem.textInputId) {
                 dynamicInputs.push({
                     id: elem.textInputId,
-                    type: 'text',
+                    type: (0, types_1.portType)('text'),
                     required: true,
                 });
             }
@@ -90,7 +91,7 @@ function computeInputPorts({ node }) {
                 addedCropInputs.add(inputRef);
                 dynamicInputs.push({
                     id: inputRef,
-                    type: 'text',
+                    type: (0, types_1.portType)('text'),
                     required: false,
                 });
             }
@@ -108,9 +109,9 @@ function computeInputPorts({ node }) {
             channel.segments.forEach(segment => {
                 if ('inputRef' in segment && segment.inputRef && !addedIds.has(segment.inputRef)) {
                     addedIds.add(segment.inputRef);
-                    const inputType = segment.type === 'video' ? 'video'
-                        : segment.type === 'audio' ? 'audio'
-                            : 'image';
+                    const inputType = segment.type === 'video' ? (0, types_1.portType)('video')
+                        : segment.type === 'audio' ? (0, types_1.portType)('audio')
+                            : (0, types_1.portType)('image');
                     dynamicInputs.push({
                         id: segment.inputRef,
                         type: inputType,
@@ -121,7 +122,7 @@ function computeInputPorts({ node }) {
                     addedIds.add(segment.textInputRef);
                     dynamicInputs.push({
                         id: segment.textInputRef,
-                        type: 'text',
+                        type: (0, types_1.portType)('text'),
                         required: true,
                     });
                 }
@@ -140,11 +141,14 @@ function computeInputPorts({ node }) {
             const varName = v.name ?? v.id;
             return !passThrough[varName];
         })
-            .map(v => ({
-            id: v.id,
-            type: (v.variableType === 'dropdown' ? 'text' : (v.variableType ?? 'text')),
-            required: false,
-        }));
+            .map(v => {
+            const varType = v.variableType === 'dropdown' ? 'text' : (v.variableType ?? 'text');
+            return {
+                id: v.id,
+                type: (0, types_1.portType)(varType),
+                required: false,
+            };
+        });
     }
     // Output nodes: generate inputs from outputConfig.inputs
     if (node.type === 'output') {
@@ -154,7 +158,7 @@ function computeInputPorts({ node }) {
             return baseInputs;
         return configInputs.map((input) => ({
             id: input.id,
-            type: input.type,
+            type: (0, types_1.portType)(input.type, input.isArray ?? false),
             required: false,
         }));
     }
@@ -165,14 +169,14 @@ function computeInputPorts({ node }) {
         const dynamicInputs = [];
         if (mode === 'video') {
             // Video mode: video input required
-            dynamicInputs.push({ id: 'video', type: 'video', required: true });
+            dynamicInputs.push({ id: 'video', type: (0, types_1.portType)('video'), required: true });
         }
         else {
             // Slideshow mode
             const inputType = autoPostConfig?.inputType ?? 'static';
             if (inputType === 'variable') {
                 // Variable mode: single images array port
-                dynamicInputs.push({ id: 'images', type: 'object', required: true });
+                dynamicInputs.push({ id: 'images', type: (0, types_1.portType)('object'), required: true });
             }
             else {
                 // Static mode: individual image inputs
@@ -182,15 +186,15 @@ function computeInputPorts({ node }) {
                     { id: 'image3' },
                 ];
                 imageInputs.forEach((input) => {
-                    dynamicInputs.push({ id: input.id, type: 'image', required: true });
+                    dynamicInputs.push({ id: input.id, type: (0, types_1.portType)('image'), required: true });
                 });
             }
         }
         // Add static inputs (same for both modes)
-        dynamicInputs.push({ id: 'account', type: 'account', required: true }, { id: 'caption', type: 'text', required: false });
+        dynamicInputs.push({ id: 'account', type: (0, types_1.portType)('account'), required: true }, { id: 'caption', type: (0, types_1.portType)('text'), required: false });
         // Only add social-audio port if isVariable is true
         if (autoPostConfig?.socialAudio?.isVariable) {
-            dynamicInputs.push({ id: 'social-audio', type: 'audio', required: false });
+            dynamicInputs.push({ id: 'social-audio', type: (0, types_1.portType)('audio'), required: false });
         }
         return dynamicInputs;
     }
@@ -202,7 +206,7 @@ function computeInputPorts({ node }) {
             return baseInputs;
         return configInputs.map((input) => ({
             id: input.id,
-            type: input.type,
+            type: (0, types_1.portType)(input.type),
             required: true,
         }));
     }
@@ -216,13 +220,13 @@ function computeInputPorts({ node }) {
         const variables = extractTemplateVariables([systemPrompt]);
         variables.forEach(v => dynamicInputs.push({
             id: v,
-            type: ['text', 'object', 'boolean'],
+            type: [(0, types_1.portType)('text'), (0, types_1.portType)('object'), (0, types_1.portType)('boolean')],
             required: true,
         }));
         // Add image input refs
-        llmConfig?.imageInputRefs?.forEach((ref) => dynamicInputs.push({ id: ref, type: 'image', required: true }));
+        llmConfig?.imageInputRefs?.forEach((ref) => dynamicInputs.push({ id: ref, type: (0, types_1.portType)('image'), required: true }));
         // Add video input refs
-        llmConfig?.videoInputRefs?.forEach((ref) => dynamicInputs.push({ id: ref, type: 'video', required: true }));
+        llmConfig?.videoInputRefs?.forEach((ref) => dynamicInputs.push({ id: ref, type: (0, types_1.portType)('video'), required: true }));
         return dynamicInputs.length > 0 ? dynamicInputs : baseInputs;
     }
     // For-each nodes: array input + passthrough inputs
@@ -230,10 +234,10 @@ function computeInputPorts({ node }) {
         const forEachConfig = node.config?.forEachConfig;
         const inputPorts = forEachConfig?.inputPorts ?? [];
         return [
-            { id: 'array', type: 'object', required: true },
+            { id: 'array', type: (0, types_1.portType)('object'), required: true },
             ...inputPorts.map((port) => ({
                 id: port.id,
-                type: port.type,
+                type: (0, types_1.portType)(port.type, port.isArray ?? false),
                 required: false,
             })),
         ];
@@ -252,11 +256,11 @@ function computeInputPorts({ node }) {
     }
     // Transcript nodes: media input
     if (node.type === 'transcript') {
-        return [{ id: 'media', type: ['video', 'audio'], required: true }];
+        return [{ id: 'media', type: [(0, types_1.portType)('video'), (0, types_1.portType)('audio')], required: true }];
     }
     // Video import nodes: url input
     if (node.type === 'video-import') {
-        return [{ id: 'url', type: 'text', required: true }];
+        return [{ id: 'url', type: (0, types_1.portType)('text'), required: true }];
     }
     // Image Generation nodes: prompt + optional image for edit models
     if (node.type === 'generate-image') {
@@ -264,10 +268,10 @@ function computeInputPorts({ node }) {
         const model = imageGenConfig?.model ?? '';
         const isEditModel = model.includes('/edit');
         const dynamicInputs = [
-            { id: 'prompt', type: 'text', required: true },
+            { id: 'prompt', type: (0, types_1.portType)('text'), required: true },
         ];
         if (isEditModel) {
-            dynamicInputs.push({ id: 'image', type: 'image', required: true });
+            dynamicInputs.push({ id: 'image', type: (0, types_1.portType)('image'), required: true });
         }
         return dynamicInputs;
     }
@@ -278,11 +282,12 @@ function computeInputPorts({ node }) {
         const dynamicInputs = [];
         inputParams.forEach((param) => {
             if (param.name === 'prompt' || param.type === 'image' || param.type === 'video' || param.type === 'audio') {
+                const pType = (param.type === 'image' || param.type === 'video' || param.type === 'audio')
+                    ? param.type
+                    : 'text';
                 dynamicInputs.push({
                     id: param.name,
-                    type: (param.type === 'image' || param.type === 'video' || param.type === 'audio'
-                        ? param.type
-                        : 'text'),
+                    type: (0, types_1.portType)(pType),
                     required: param.required,
                 });
             }
@@ -291,7 +296,7 @@ function computeInputPorts({ node }) {
     }
     // Deduplicate nodes: video input
     if (node.type === 'deduplicate') {
-        return [{ id: 'video', type: 'video', required: true }];
+        return [{ id: 'video', type: (0, types_1.portType)('video'), required: true }];
     }
     return baseInputs;
 }

package/dist/types.d.ts

@@ -758,13 +758,55 @@ export type StaticSegment = ImageSegment | TextSegment;
  */
 export type MediaType = 'video' | 'image' | 'audio' | 'text';
 /**
- * Array types for collections
+ * Base port type - all possible value types without array modifier
  */
-export type ArrayType = 'image[]' | 'video[]' | 'audio[]' | 'text[]' | 'object[]' | 'account[]' | 'social_audio[]' | 'boolean[]';
+export type BasePortType = 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'object' | 'account' | 'date' | 'social_audio';
 /**
- * Extended port types (includes non-media types for special nodes)
+ * Structured port type descriptor
+ * Replaces string-based types like 'image[]' with explicit { type, isArray }
  */
-export type PortType = MediaType | 'number' | 'boolean' | 'object' | 'account' | 'date' | 'social_audio' | ArrayType;
+export interface PortType {
+    type: BasePortType;
+    isArray: boolean;
+}
+/**
+ * Helper to create a PortType descriptor
+ */
+export declare function portType(type: BasePortType, isArray?: boolean): PortType;
+/**
+ * Format a PortType for display (e.g., { type: 'image', isArray: true } -> 'image[]')
+ */
+export declare function formatPortType(port: PortType): string;
+/**
+ * @deprecated Legacy string-based port type. Use PortType interface instead.
+ * Kept for backwards compatibility with existing saved automations.
+ */
+export type LegacyPortType = 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'object' | 'account' | 'date' | 'social_audio' | 'image[]' | 'video[]' | 'audio[]' | 'text[]' | 'number[]' | 'boolean[]' | 'object[]' | 'account[]' | 'social_audio[]';
+/**
+ * @deprecated Check if a value is a legacy string port type.
+ * Use for runtime detection during migration.
+ */
+export declare function isLegacyPortType(value: unknown): value is LegacyPortType;
+/**
+ * @deprecated Convert legacy string port type to structured PortType.
+ * Use for migrating old code and data.
+ */
+export declare function fromLegacyPortType(legacy: LegacyPortType): PortType;
+/**
+ * @deprecated Convert structured PortType to legacy string format.
+ * Use only for backwards compatibility with systems expecting string types.
+ */
+export declare function toLegacyPortType(port: PortType): LegacyPortType;
+/**
+ * @deprecated Normalize port type - accepts either legacy string or structured format,
+ * always returns structured PortType. Use at read boundaries during migration.
+ */
+export declare function normalizePortType(value: LegacyPortType | PortType): PortType;
+/**
+ * @deprecated Normalize an array of port types or a single port type.
+ * Handles PortType | PortType[] | LegacyPortType | LegacyPortType[] formats.
+ */
+export declare function normalizePortTypes(value: LegacyPortType | PortType | LegacyPortType[] | PortType[]): PortType | PortType[];
 /**
  * Selection order configuration for media nodes
  */

package/dist/types.js

@@ -1,9 +1,76 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.NodeTypes = void 0;
+exports.portType = portType;
+exports.formatPortType = formatPortType;
+exports.isLegacyPortType = isLegacyPortType;
+exports.fromLegacyPortType = fromLegacyPortType;
+exports.toLegacyPortType = toLegacyPortType;
+exports.normalizePortType = normalizePortType;
+exports.normalizePortTypes = normalizePortTypes;
 exports.isEditModel = isEditModel;
 exports.isImageToVideoModel = isImageToVideoModel;
 exports.isAsyncExecutor = isAsyncExecutor;
+/**
+ * Helper to create a PortType descriptor
+ */
+function portType(type, isArray = false) {
+    return { type, isArray };
+}
+/**
+ * Format a PortType for display (e.g., { type: 'image', isArray: true } -> 'image[]')
+ */
+function formatPortType(port) {
+    return port.isArray ? `${port.type}[]` : port.type;
+}
+/**
+ * @deprecated Check if a value is a legacy string port type.
+ * Use for runtime detection during migration.
+ */
+function isLegacyPortType(value) {
+    if (typeof value !== 'string')
+        return false;
+    const baseTypes = ['image', 'video', 'audio', 'text', 'number', 'boolean', 'object', 'account', 'date', 'social_audio'];
+    const arrayTypes = baseTypes.map(t => `${t}[]`);
+    return baseTypes.includes(value) || arrayTypes.includes(value);
+}
+/**
+ * @deprecated Convert legacy string port type to structured PortType.
+ * Use for migrating old code and data.
+ */
+function fromLegacyPortType(legacy) {
+    if (legacy.endsWith('[]')) {
+        return { type: legacy.slice(0, -2), isArray: true };
+    }
+    return { type: legacy, isArray: false };
+}
+/**
+ * @deprecated Convert structured PortType to legacy string format.
+ * Use only for backwards compatibility with systems expecting string types.
+ */
+function toLegacyPortType(port) {
+    return (port.isArray ? `${port.type}[]` : port.type);
+}
+/**
+ * @deprecated Normalize port type - accepts either legacy string or structured format,
+ * always returns structured PortType. Use at read boundaries during migration.
+ */
+function normalizePortType(value) {
+    if (typeof value === 'string') {
+        return fromLegacyPortType(value);
+    }
+    return value;
+}
+/**
+ * @deprecated Normalize an array of port types or a single port type.
+ * Handles PortType | PortType[] | LegacyPortType | LegacyPortType[] formats.
+ */
+function normalizePortTypes(value) {
+    if (Array.isArray(value)) {
+        return value.map(v => normalizePortType(v));
+    }
+    return normalizePortType(value);
+}
 /**
  * Type guard to check if model is an edit/inpaint model
  */

package/package.json

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