ugcinc 2.67.0 → 2.69.0

package/dist/automations.js

@@ -190,23 +190,11 @@ function getAllNodes() {
             type: "llm",
             label: "LLM",
             description: "Process input with a Large Language Model",
-            category: "Input",
-            inputs: [
-                {
-                    id: "prompt",
-                    title: "prompt",
-                    type: "text",
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "response",
-                    title: "response",
-                    type: "text",
-                    required: true,
-                },
-            ],
+            category: "AI",
+            // Dynamic inputs: extracted from systemPrompt {{variables}} + media refs
+            inputs: [],
+            // Dynamic outputs: based on outputFields config
+            outputs: [],
         },
         {
             type: "output",

package/dist/index.d.ts

@@ -15,4 +15,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, 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, AutomationTemplate, AutomationRun, NodeRun, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, OutputInput, OutputNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, Comment, CreateCommentParams, CreateCommentResponse, GetCommentStatusParams, CommentStatusResponse, GetCommentsParams, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, 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, AutomationTemplate, AutomationRun, NodeRun, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, OutputInput, OutputNodeConfig, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, Comment, CreateCommentParams, CreateCommentResponse, GetCommentStatusParams, CommentStatusResponse, GetCommentsParams, } from './types';

package/dist/media.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Media, UserMedia, SocialAudio, GetMediaParams, GetSocialAudioParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, GetUploadTokenParams, UploadTokenResponse, ApiResponse } from './types';
+import type { Media, UserMedia, SocialAudio, GetMediaParams, GetSocialAudioParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, GetUploadTokenParams, UploadTokenResponse, ImportTextParams, ImportTextResponse, ApiResponse } from './types';
 /**
  * Client for managing media files
  */
@@ -41,4 +41,9 @@ export declare class MediaClient extends BaseClient {
      * 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
+     */
+    importText(params: ImportTextParams): Promise<ApiResponse<ImportTextResponse>>;
 }

package/dist/media.js

@@ -57,5 +57,12 @@ class MediaClient extends base_1.BaseClient {
     async createSocialAudio(params) {
         return this.post('/media/social-audio/upload', params);
     }
+    /**
+     * Import text content as media
+     * Creates text media entries from raw text content
+     */
+    async importText(params) {
+        return this.post('/media/create/text', params);
+    }
 }
 exports.MediaClient = MediaClient;

package/dist/stats.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { AccountStat, PostStat, GetAccountStatsParams, GetPostStatsParams, RefreshStatsParams, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, ApiResponse } from './types';
+import type { AccountStat, PostStat, GetAccountStatsParams, GetPostStatsParams, RefreshStatsParams, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, ApiResponse } from './types';
 /**
  * Client for managing statistics
  */
@@ -74,6 +74,16 @@ export declare class StatsClient extends BaseClient {
      * ```
      */
     getDailyAggregated(params: GetDailyAggregatedStatsParams): Promise<ApiResponse<DailyAggregatedStat[]>>;
+    /**
+     * Get daily account statistics for all accounts in an org
+     *
+     * Returns per-account daily changes (deltas) for followers, following, views, likes.
+     * Perfect for granular local filtering in dashboard charts.
+     *
+     * @param params - Date range and filter parameters (startDate and endDate required)
+     * @returns Array of daily account statistics
+     */
+    getDailyAccountStats(params: GetDailyAccountStatsParams): Promise<ApiResponse<DailyAccountStat[]>>;
     /**
      * Get daily post statistics for chart tooltips
      *

package/dist/stats.js

@@ -82,6 +82,18 @@ class StatsClient extends base_1.BaseClient {
     async getDailyAggregated(params) {
         return this.post('/stats/aggregated/daily', params);
     }
+    /**
+     * Get daily account statistics for all accounts in an org
+     *
+     * Returns per-account daily changes (deltas) for followers, following, views, likes.
+     * Perfect for granular local filtering in dashboard charts.
+     *
+     * @param params - Date range and filter parameters (startDate and endDate required)
+     * @returns Array of daily account statistics
+     */
+    async getDailyAccountStats(params) {
+        return this.post('/stats/granular/daily-accounts', params);
+    }
     /**
      * Get daily post statistics for chart tooltips
      *

package/dist/types.d.ts

@@ -253,6 +253,22 @@ export interface GetDailyAggregatedStatsParams {
     org_group?: string;
     user_group?: string;
 }
+export interface DailyAccountStat {
+    date: Date | string;
+    account_id: string;
+    followers: number;
+    following: number;
+    views: number;
+    likes: number;
+}
+export interface GetDailyAccountStatsParams {
+    startDate: string;
+    endDate: string;
+    accountIds?: string[];
+    tag?: string;
+    org_group?: string;
+    user_group?: string;
+}
 export interface DailyPostStat {
     date: Date | string;
     post_id: string;
@@ -702,6 +718,33 @@ export interface OutputSchemaProperty {
     items?: 'string' | 'number' | 'boolean';
     properties?: Record<string, OutputSchemaProperty>;
 }
+/**
+ * LLM output field definition for structured outputs
+ */
+export interface LLMOutputField {
+    /** Required - becomes the output port ID */
+    name: string;
+    /** Optional - guides LLM on expected content */
+    description?: string;
+    /** Output type */
+    type: 'string' | 'number' | 'boolean' | 'array';
+    /** For array types - the item type */
+    items?: 'string' | 'number' | 'boolean';
+}
+/**
+ * LLM Node Configuration
+ */
+export interface LLMNodeConfig {
+    provider: 'groq' | 'openai' | 'claude' | 'gemini';
+    model: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemPrompt: string;
+    outputFields: LLMOutputField[];
+    useStructuredOutput?: boolean;
+    imageInputRefs?: string[];
+    videoInputRefs?: string[];
+}
 export interface WorkflowNodeDefinition {
     id: string;
     type: NodeTypeEnum;
@@ -720,6 +763,7 @@ export interface WorkflowNodeDefinition {
         textOptions?: string[];
         videoEditor?: VideoEditorNodeConfig;
         imageEditor?: ImageEditorNodeConfig;
+        llm?: LLMNodeConfig;
         outputSchema?: Record<string, OutputSchemaProperty>;
         provider?: 'groq' | 'openai' | 'claude' | 'gemini';
         model?: string;
@@ -794,6 +838,8 @@ export interface NodeRun {
     output_data: Record<string, unknown> | null;
     created_at: string;
     completed_at: string | null;
+    /** Sub-workflow node runs (only present for workflow nodes) */
+    subNodes?: NodeRun[];
 }
 /**
  * Media types
@@ -803,9 +849,10 @@ export interface UserMedia {
     org_id: string;
     name: string | null;
     tag: string | null;
-    type: 'video' | 'image' | 'audio' | null;
-    url: string;
+    type: 'video' | 'image' | 'audio' | 'text' | null;
+    url: string | null;
     preview_url: string | null;
+    content: string | null;
     created_at: string;
     media_type: 'user_media';
 }
@@ -863,6 +910,17 @@ export interface CreateSocialAudioParams {
     url: string;
     tag?: string;
 }
+export interface ImportTextParams {
+    texts: Array<{
+        content: string;
+        name?: string;
+        tag?: string;
+    }>;
+}
+export interface ImportTextResponse {
+    data: UserMedia[];
+    message: string;
+}
 export interface CreateMediaFromUrlParams {
     urls: string[];
     names?: string[];

package/package.json

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