ugcinc 3.29.0 → 3.31.0

package/dist/automations.js

@@ -376,8 +376,8 @@ function getAllNodes() {
             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
+            // - video mode: video (required), account, caption, social-audio
+            // - slideshow mode: dynamic image inputs from config, account, caption, social-audio
             inputs: [
                 {
                     id: "account",
@@ -389,6 +389,11 @@ function getAllNodes() {
                     type: "text",
                     required: false,
                 },
+                {
+                    id: "social-audio",
+                    type: "social_audio",
+                    required: false,
+                },
             ],
             outputs: [],
         },

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, CreateMediaFromUrlParams, CreateSocialAudioParams, 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' | 'text' | 'account' | 'date' | 'social_audio';
 /**
  * Extended port types (includes non-media types for special nodes)
  */
@@ -803,7 +805,7 @@ 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)
  */
@@ -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' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'transcript' | 'auto-caption';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';
@@ -950,7 +952,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 +962,7 @@ export interface OutputNodeConfig {
  */
 export interface ManualTriggerOutput {
     id: string;
-    type: 'image' | 'video' | 'audio' | 'text' | 'account';
+    type: 'image' | 'video' | 'audio' | 'text' | 'social_audio' | 'account';
 }
 /**
  * Iteration mode for trigger nodes with account iteration
@@ -1012,7 +1014,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') */
@@ -1068,7 +1070,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
  */
@@ -1143,6 +1145,13 @@ export interface AutoPostNodeConfig {
     inputs?: AutoPostInput[];
     /** Scheduling configuration */
     scheduling?: PostSchedulingConfig;
+    /** Social audio configuration */
+    socialAudio?: {
+        /** If true, read from input port; if false, use selectedIds */
+        isVariable: boolean;
+        /** Selected social audio IDs (when isVariable is false) - one is randomly chosen when posting */
+        selectedIds?: string[];
+    };
 }
 /**
  * Save To Media node input definition
@@ -1452,11 +1461,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 +1530,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.31.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",