ugcinc 3.29.0 → 3.30.0

package/dist/automations.js

@@ -175,6 +175,21 @@ function getAllNodes() {
                 },
             ],
         },
+        {
+            type: "social-audio",
+            label: "Social Media Audio",
+            description: "Link audios from social media",
+            category: "Sources",
+            nodeCategory: "source",
+            inputs: [],
+            outputs: [
+                {
+                    id: "social-audio",
+                    type: "social_audio",
+                    required: true,
+                },
+            ],
+        },
         {
             type: "account",
             label: "Account",
@@ -370,14 +385,42 @@ function getAllNodes() {
         },
         // === Terminal nodes ===
         {
-            type: "auto-post",
-            label: "Auto Post",
-            description: "Publish a video or slideshow",
+            type: "post-video",
+            label: "Post Video",
+            description: "Publish a video post",
+            category: "Output",
+            nodeCategory: "terminal",
+            inputs: [
+                {
+                    id: "video",
+                    type: "video",
+                    required: true,
+                },
+                {
+                    id: "account",
+                    type: "account",
+                    required: true,
+                },
+                {
+                    id: "caption",
+                    type: "text",
+                    required: false,
+                },
+                {
+                    id: "social-audio",
+                    type: "social_audio",
+                    required: false,
+                },
+            ],
+            outputs: [],
+        },
+        {
+            type: "post-slideshow",
+            label: "Post Slideshow",
+            description: "Publish a slideshow post",
             category: "Output",
             nodeCategory: "terminal",
-            // Dynamic inputs based on autoPostConfig.mode:
-            // - video mode: video (required), account, caption
-            // - slideshow mode: dynamic image inputs from config, account, caption
+            // Dynamic inputs based on postSlideshowConfig.inputs
             inputs: [
                 {
                     id: "account",
@@ -389,6 +432,11 @@ function getAllNodes() {
                     type: "text",
                     required: false,
                 },
+                {
+                    id: "social-audio",
+                    type: "social_audio",
+                    required: false,
+                },
             ],
             outputs: [],
         },
@@ -404,8 +452,8 @@ function getAllNodes() {
         },
         {
             type: "output",
-            label: "Pass-Through",
-            description: "Pass data to parent workflow",
+            label: "Output",
+            description: "Pass through outputs",
             category: "Output",
             nodeCategory: "terminal",
             inputs: [

package/dist/index.d.ts

@@ -18,4 +18,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, CollectionSelectionMode, TriggerCollectionConfig, DayOfWeek, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeConfig, PostSchedulingMode, PostSchedulingConfig, AutoPostMode, AutoPostInputType, AutoPostInput, AutoPostNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, ForEachOutputProperty, ForEachInputPort, ForEachNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, AutoCaptionNodeConfig, VideoGenerationNodeConfig, PortType, LLMOutputField, LLMNodeConfig, UserMedia, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, 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, RecurrenceMediaOutput, RecurrenceMediaConfig, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, RecurrenceMediaEnabledType, MediaNodeConfig, PostSchedulingMode, 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/media.d.ts

@@ -1,14 +1,20 @@
 import { BaseClient } from './base';
-import type { Media, GetMediaParams, UploadMediaResponse, UpdateMediaTagParams, UpdateMediaTagsParams, UpdateMediaTagsResponse, DeleteMediaParams, DeleteMediaResponse, CreateMediaFromUrlParams, GetUploadTokenParams, UploadTokenResponse, ImportTextParams, ImportTextResponse, ApiResponse } from './types';
+import type { Media, SocialAudio, GetMediaParams, GetSocialAudioParams, UploadMediaResponse, UpdateMediaTagParams, UpdateMediaTagsParams, UpdateMediaTagsResponse, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, GetUploadTokenParams, UploadTokenResponse, ImportTextParams, ImportTextResponse, ApiResponse } from './types';
 /**
  * Client for managing media files
  */
 export declare class MediaClient extends BaseClient {
     /**
      * Get media for the organization
+     * Returns both user_media and social_audio combined
      * Can filter by ids or tag
      */
     getMedia(params?: GetMediaParams): Promise<ApiResponse<Media[]>>;
+    /**
+     * Get social audio for the organization
+     * Can filter by ids or tag
+     */
+    getSocialAudio(params?: GetSocialAudioParams): Promise<ApiResponse<SocialAudio[]>>;
     /**
      * Create media from URL(s)
      * Creates media records from files already uploaded to blob storage
@@ -22,12 +28,14 @@ export declare class MediaClient extends BaseClient {
     getUploadToken(params: GetUploadTokenParams): Promise<ApiResponse<UploadTokenResponse>>;
     /**
      * Update tags on multiple media items in a single request
+     * Works for both user_media and social_audio
      * @param params.updates - Array of {id, tag} pairs to update
      */
     updateTags(params: UpdateMediaTagsParams): Promise<ApiResponse<UpdateMediaTagsResponse>>;
     /**
      * @deprecated Use updateTags() instead for bulk operations
      * Update the tag on a single media item
+     * Works for both user_media and social_audio
      */
     updateTag(params: UpdateMediaTagParams): Promise<ApiResponse<UpdateMediaTagsResponse>>;
     /**
@@ -35,6 +43,11 @@ export declare class MediaClient extends BaseClient {
      * Also deletes the files from blob storage
      */
     delete(params: DeleteMediaParams): Promise<ApiResponse<DeleteMediaResponse>>;
+    /**
+     * Create a social audio from a TikTok URL
+     * Extracts audio and cover image from TikTok video or music URL
+     */
+    createSocialAudio(params: CreateSocialAudioParams): Promise<ApiResponse<SocialAudio>>;
     /**
      * Import text content as media
      * Creates text media entries from raw text content

package/dist/media.js

@@ -8,11 +8,19 @@ const base_1 = require("./base");
 class MediaClient extends base_1.BaseClient {
     /**
      * Get media for the organization
+     * Returns both user_media and social_audio combined
      * Can filter by ids or tag
      */
     async getMedia(params) {
         return this.post('/media', params ?? {});
     }
+    /**
+     * Get social audio for the organization
+     * Can filter by ids or tag
+     */
+    async getSocialAudio(params) {
+        return this.post('/media/social-audio', params ?? {});
+    }
     /**
      * Create media from URL(s)
      * Creates media records from files already uploaded to blob storage
@@ -30,6 +38,7 @@ class MediaClient extends base_1.BaseClient {
     }
     /**
      * Update tags on multiple media items in a single request
+     * Works for both user_media and social_audio
      * @param params.updates - Array of {id, tag} pairs to update
      */
     async updateTags(params) {
@@ -38,6 +47,7 @@ class MediaClient extends base_1.BaseClient {
     /**
      * @deprecated Use updateTags() instead for bulk operations
      * Update the tag on a single media item
+     * Works for both user_media and social_audio
      */
     async updateTag(params) {
         return this.post('/media/update-tag', { updates: [params] });
@@ -49,6 +59,13 @@ class MediaClient extends base_1.BaseClient {
     async delete(params) {
         return this.post('/media/delete', params);
     }
+    /**
+     * Create a social audio from a TikTok URL
+     * Extracts audio and cover image from TikTok video or music URL
+     */
+    async createSocialAudio(params) {
+        return this.post('/media/social-audio/upload', params);
+    }
     /**
      * Import text content as media
      * Creates text media entries from raw text content

package/dist/types.d.ts

@@ -249,6 +249,7 @@ export interface CreateSlideshowParams {
     accountId: string | null;
     caption?: string;
     title?: string;
+    socialAudioId?: string;
     postTime?: string;
     imageUrls: string[];
     strict?: boolean;
@@ -267,6 +268,7 @@ export interface GetPostStatusParams {
 export interface CreateVideoParams {
     accountId: string | null;
     caption?: string;
+    socialAudioId?: string;
     postTime?: string;
     videoUrl: string;
     strict?: boolean;
@@ -749,7 +751,7 @@ export type StaticSegment = ImageSegment | TextSegment;
 /**
  * Automation types
  */
-export type MediaType = 'video' | 'image' | 'audio' | 'text' | 'account' | 'date';
+export type MediaType = 'video' | 'image' | 'audio' | 'social_audio' | 'text' | 'account' | 'date';
 /**
  * Extended port types (includes non-media types for special nodes)
  */
@@ -803,9 +805,9 @@ export interface NodePort {
 /**
  * Functional category for automation nodes
  * - trigger: Nodes that start an automation (manual-trigger, recurrence)
- * - source: Nodes that provide input data (image, video, audio, text, account)
+ * - source: Nodes that provide input data (image, video, audio, social-audio, text, account)
  * - generator: Nodes that transform or generate content (image-template, video-template, image-generation, text-generation, sub-agent)
- * - terminal: Nodes that end an automation (output, auto-post, save-to-media)
+ * - terminal: Nodes that end an automation (output, post-video, post-slideshow, save-to-media)
  */
 export type NodeCategory = 'trigger' | 'source' | 'generator' | 'terminal';
 export interface NodeControlConfig {
@@ -831,7 +833,7 @@ export interface NodeControlConfig {
      */
     isInitializer?: boolean;
 }
-export type NodeTypeEnum = 'text' | 'media' | 'video-import' | 'image-template' | 'video-template' | 'image-generation' | 'video-generation' | 'custom-model' | 'text-generation' | 'output' | 'manual-trigger' | 'recurrence' | 'sub-agent' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'transcript' | 'auto-caption';
+export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-template' | 'video-template' | 'image-generation' | 'video-generation' | 'custom-model' | 'text-generation' | 'output' | 'manual-trigger' | 'recurrence' | 'sub-agent' | 'account' | 'post-video' | 'post-slideshow' | 'save-to-media' | 'deduplicate' | 'for-each' | 'transcript' | 'auto-caption';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';
@@ -937,7 +939,8 @@ export interface WorkflowNodeDefinition {
         outputConfig?: OutputNodeConfig;
         accountConfig?: AccountNodeConfig;
         mediaConfig?: MediaNodeConfig;
-        autoPostConfig?: AutoPostNodeConfig;
+        postVideoConfig?: PostVideoNodeConfig;
+        postSlideshowConfig?: PostSlideshowNodeConfig;
         saveToMediaConfig?: SaveToMediaNodeConfig;
         deduplicateConfig?: DeduplicateNodeConfig;
         videoImportConfig?: VideoImportNodeConfig;
@@ -950,7 +953,7 @@ export interface WorkflowNodeDefinition {
 export interface OutputInput {
     id: string;
     title: string;
-    type: 'image' | 'video' | 'audio' | 'text';
+    type: 'image' | 'video' | 'audio' | 'social_audio' | 'text';
 }
 export interface OutputNodeConfig {
     inputs: OutputInput[];
@@ -960,7 +963,11 @@ export interface OutputNodeConfig {
  */
 export interface ManualTriggerOutput {
     id: string;
-    type: 'image' | 'video' | 'audio' | 'text' | 'account';
+    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account';
+    /** Whether this variable is optional (default: false = required) */
+    optional?: boolean;
+    /** Default value when optional and not provided at runtime */
+    defaultValue?: string;
 }
 /**
  * Iteration mode for trigger nodes with account iteration
@@ -999,6 +1006,8 @@ export interface TriggerCollectionConfig {
  */
 export interface ManualTriggerNodeConfig {
     outputs: ManualTriggerOutput[];
+    /** Optional collection input for iterating over multiple elements */
+    collectionInput?: TriggerCollectionConfig;
 }
 /**
  * Days of the week for recurrence scheduling
@@ -1012,7 +1021,7 @@ export interface RecurrenceMediaOutput {
     /** Unique ID for this output port (e.g., "background-image", "overlay") */
     id: string;
     /** Media type for this port */
-    type: 'image' | 'video' | 'audio' | 'text';
+    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio';
     /** Selection mode for this output's media source */
     selectionMode: 'specific' | 'by-tag';
     /** Media IDs for this output (used when selectionMode is 'specific') */
@@ -1043,6 +1052,10 @@ export interface RecurrenceNodeConfig {
     randomWindowStart: string;
     randomWindowEnd: string;
     timezone: string;
+    /** Maximum number of runs before stopping (null = unlimited) */
+    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 accounts */
     collectionInput?: TriggerCollectionConfig;
     /** Optional media input for providing media to downstream nodes */
@@ -1068,7 +1081,7 @@ export type MediaNodeEnabledType = 'image' | 'video' | 'audio';
  * Recurrence media enabled type
  * Includes all media types that can be output from recurrence nodes
  */
-export type RecurrenceMediaEnabledType = 'image' | 'video' | 'audio' | 'text';
+export type RecurrenceMediaEnabledType = 'image' | 'video' | 'audio' | 'text' | 'social_audio';
 /**
  * Media node configuration - consolidated source node for image, video, and audio
  */
@@ -1116,31 +1129,25 @@ export interface PostSchedulingConfig {
     requireApproval?: boolean;
 }
 /**
- * Auto Post mode - video or slideshow
- */
-export type AutoPostMode = 'video' | 'slideshow';
-/**
- * Auto Post input type for slideshow mode
- * - 'static': Individual image input ports (image1, image2, etc.)
- * - 'variable': Single 'images' port accepting an array
+ * Post Video node configuration - posts a video to social media
  */
-export type AutoPostInputType = 'static' | 'variable';
+export interface PostVideoNodeConfig {
+    /** Scheduling configuration */
+    scheduling?: PostSchedulingConfig;
+}
 /**
- * Auto Post input definition (for slideshow static mode)
+ * Post Slideshow input definition
  */
-export interface AutoPostInput {
+export interface PostSlideshowInput {
     id: string;
+    title: string;
 }
 /**
- * Auto Post node configuration - posts a video or slideshow to social media
+ * Post Slideshow node configuration - posts a slideshow to social media
  */
-export interface AutoPostNodeConfig {
-    /** Post mode - video or slideshow */
-    mode: AutoPostMode;
-    /** Input type for slideshow mode (defaults to 'static') */
-    inputType?: AutoPostInputType;
-    /** Dynamic image inputs (only used in slideshow mode with inputType='static') */
-    inputs?: AutoPostInput[];
+export interface PostSlideshowNodeConfig {
+    /** Dynamic image inputs */
+    inputs: PostSlideshowInput[];
     /** Scheduling configuration */
     scheduling?: PostSchedulingConfig;
 }
@@ -1452,11 +1459,29 @@ export interface UserMedia {
     created_at: string;
     media_type: 'user_media';
 }
-export type Media = UserMedia;
+export interface SocialAudio {
+    id: string;
+    org_id: string;
+    name: string | null;
+    tag: string | null;
+    social_post_link: string | null;
+    social_audio_link: string | null;
+    platform_type: 'tiktok' | null;
+    preview_url: string | null;
+    audio_url: string | null;
+    created_at: string;
+    media_type: 'social_audio';
+    type: 'social_audio';
+}
+export type Media = UserMedia | SocialAudio;
 export interface GetMediaParams {
     ids?: string[];
     tag?: string;
 }
+export interface GetSocialAudioParams {
+    ids?: string[];
+    tag?: string;
+}
 export interface UploadMediaParams {
     files: File[];
     tag?: string;
@@ -1503,6 +1528,10 @@ export interface DeleteMediaResponse {
     }>;
     message: string;
 }
+export interface CreateSocialAudioParams {
+    url: string;
+    tag?: string;
+}
 export interface ImportTextParams {
     texts: Array<{
         content: string;

package/package.json

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