ugcinc 3.11.0 → 3.13.0

package/dist/index.d.ts

@@ -17,4 +17,4 @@ export { MediaClient } from './media';
 export { CommentsClient } from './comments';
 export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, 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, DimensionPresetKey, EditorChannel, TimeValue, 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, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, TriggerCollectionConfig, DayOfWeek, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, MediaNodeConfig, PostSchedulingMode, PostScheduledSubMode, PostRateLimitFrequency, PostSchedulingConfig, PostVideoNodeConfig, PostSlideshowInput, PostSlideshowNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, VideoGenerationNodeConfig, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, } 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, DimensionPresetKey, EditorChannel, TimeValue, 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, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, MediaNodeConfig, PostSchedulingMode, PostScheduledSubMode, PostSchedulingConfig, PostVideoNodeConfig, PostSlideshowInput, PostSlideshowNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, VideoGenerationNodeConfig, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, } from './types';

package/dist/types.d.ts

@@ -972,6 +972,12 @@ export type TriggerIterationMode = 'fan-out' | 'sequential';
  * - 'stop': Stop the automation (disable schedule for recurrence)
  */
 export type IterationExhaustionBehavior = 'repeat' | 'stop';
+/**
+ * Selection mode for collection inputs
+ * - 'specific': Use hardcoded IDs configured at design time
+ * - 'by-tag': Query items by tag at runtime (allows dynamic collections)
+ */
+export type CollectionSelectionMode = 'specific' | 'by-tag';
 /**
  * Account iteration configuration for trigger nodes
  * When enabled, the trigger iterates over a collection of accounts
@@ -983,8 +989,12 @@ export interface TriggerCollectionConfig {
     iterationMode: TriggerIterationMode;
     /** What to do when sequential iteration exhausts all accounts */
     exhaustionBehavior?: IterationExhaustionBehavior;
-    /** Account IDs to iterate over */
+    /** Selection mode: 'specific' uses accountIds, 'by-tag' queries at runtime */
+    selectionMode?: CollectionSelectionMode;
+    /** Account IDs to iterate over (used when selectionMode is 'specific' or undefined) */
     accountIds?: string[];
+    /** Tag to query accounts by at runtime (used when selectionMode is 'by-tag') */
+    accountTag?: string;
 }
 /**
  * Manual Trigger node configuration - defines outputs that users provide when running
@@ -998,6 +1008,38 @@ export interface ManualTriggerNodeConfig {
  * Days of the week for recurrence scheduling
  */
 export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
+/**
+ * Media input configuration for recurrence nodes
+ * Allows selecting media by specific IDs or by tag (queried at runtime)
+ */
+export interface RecurrenceMediaConfig {
+    /** Whether media input is enabled */
+    enabled: boolean;
+    /** Which media types to output (determines output ports) */
+    enabledTypes: MediaNodeEnabledType[];
+    /** Selection mode: 'specific' uses selectedMediaIds, 'by-tag' queries at runtime */
+    selectionMode: CollectionSelectionMode;
+    /** Media IDs per type (used when selectionMode is 'specific') */
+    selectedMediaIds?: {
+        image?: string[];
+        video?: string[];
+        audio?: string[];
+    };
+    /** Tag to query media by at runtime (used when selectionMode is 'by-tag') */
+    mediaTag?: string;
+    /** How to pick from the pool for each type */
+    selectionConfig?: {
+        image?: {
+            mode: 'random' | 'sequential';
+        };
+        video?: {
+            mode: 'random' | 'sequential';
+        };
+        audio?: {
+            mode: 'random' | 'sequential';
+        };
+    };
+}
 /**
  * Recurrence node configuration - defines when the automation runs on a schedule
  */
@@ -1015,8 +1057,10 @@ export interface RecurrenceNodeConfig {
     maxRuns?: number | null;
     /** End date for the recurrence in ISO format (YYYY-MM-DD) - if set, runs until this date */
     endDate?: string;
-    /** Optional collection input for iterating over multiple elements */
+    /** Optional collection input for iterating over multiple accounts */
     collectionInput?: TriggerCollectionConfig;
+    /** Optional media input for providing media to downstream nodes */
+    mediaInput?: RecurrenceMediaConfig;
 }
 /**
  * Account node configuration - source node for selecting accounts to post from
@@ -1057,21 +1101,15 @@ export interface MediaNodeConfig {
 /**
  * Scheduling mode for post nodes
  * - 'scheduled': Post at a specific time (immediately or at a connected date)
- * - 'rate-limited': Automatically schedule based on frequency limits
+ * - 'queue': Automatically schedule based on queue constraints
  */
-export type PostSchedulingMode = 'scheduled' | 'rate-limited';
+export type PostSchedulingMode = 'scheduled' | 'queue';
 /**
  * Sub-mode for scheduled posting
  * - 'immediately': Posts when automation runs (no date input needed)
  * - 'specific-time': Requires a date input connection
  */
 export type PostScheduledSubMode = 'immediately' | 'specific-time';
-/**
- * Frequency type for rate-limited posting
- * - 'daily': Specifies number of posts per day
- * - 'periodic': Specifies days between posts (for less than 1 post per day)
- */
-export type PostRateLimitFrequency = 'daily' | 'periodic';
 /**
  * Post scheduling configuration for post nodes
  */
@@ -1080,12 +1118,10 @@ export interface PostSchedulingConfig {
     mode: PostSchedulingMode;
     /** Sub-mode when mode is 'scheduled' */
     scheduledSubMode?: PostScheduledSubMode;
-    /** Frequency type when mode is 'rate-limited' */
-    frequencyType?: PostRateLimitFrequency;
-    /** Posts per day (when frequencyType is 'daily', 1-10) */
-    postsPerDay?: number;
-    /** Days between posts (when frequencyType is 'periodic', e.g., 7=weekly) */
-    periodDays?: number;
+    /** Minimum hours between posts for this account (min 1) */
+    minDistanceHours?: number;
+    /** Maximum posts per day for this account (min 1) */
+    maxPostsPerDay?: number;
     /** Minimum time of day for posting (HH:mm format, e.g., '09:00') */
     randomWindowStart?: string;
     /** Maximum time of day for posting (HH:mm format, e.g., '21:00') */

package/package.json

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