ugcinc 4.5.91 → 4.5.93

package/dist/automations/graph-controller.js

@@ -846,10 +846,52 @@ function validateWorkflow({ nodes, }) {
             }
         }
     }
-    // 7. Check for circular dependencies
+    // 7. Check for duplicate port names across input nodes
+    const inputPortSeen = new Map(); // portName -> first nodeId
+    for (const node of nodes) {
+        if (node.type !== 'input')
+            continue;
+        const outputs = node.config.outputs ?? [];
+        for (const output of outputs) {
+            const existing = inputPortSeen.get(output.id);
+            if (existing) {
+                errors.push({
+                    type: 'duplicate_port_name',
+                    nodeId: node.id,
+                    portId: output.id,
+                    message: `Duplicate input port name '${output.id}' — each input port must have a unique name across all input nodes`,
+                });
+            }
+            else {
+                inputPortSeen.set(output.id, node.id);
+            }
+        }
+    }
+    // 8. Check for duplicate port names across output (passthrough) nodes
+    const outputPortSeen = new Map(); // portName -> first nodeId
+    for (const node of nodes) {
+        if (node.type !== 'passthrough')
+            continue;
+        const inputs = node.config.inputs ?? [];
+        for (const input of inputs) {
+            const existing = outputPortSeen.get(input.id);
+            if (existing) {
+                errors.push({
+                    type: 'duplicate_port_name',
+                    nodeId: node.id,
+                    portId: input.id,
+                    message: `Duplicate output port name '${input.id}' — each output port must have a unique name across all output nodes`,
+                });
+            }
+            else {
+                outputPortSeen.set(input.id, node.id);
+            }
+        }
+    }
+    // 9. Check for circular dependencies
     const circularErrors = detectCircularDependencies(nodes);
     errors.push(...circularErrors);
-    // 8. Check for for-each context boundary violations
+    // 10. Check for for-each context boundary violations
     const boundaryErrors = validateForEachContextBoundaries(nodes);
     errors.push(...boundaryErrors);
     return errors;

package/dist/automations/nodes/api-request.d.ts

@@ -10,12 +10,22 @@ export interface HeaderEntry {
     key: string;
     value: string;
 }
+export type ApiRequestOutputPrimitiveType = 'string' | 'number' | 'boolean' | 'image';
+export type ApiRequestArrayItemType = ApiRequestOutputPrimitiveType | 'object';
+export type ApiRequestOutputType = ApiRequestOutputPrimitiveType | 'object' | 'array';
+export interface ApiRequestOutputField {
+    name: string;
+    type: ApiRequestOutputType;
+    items?: ApiRequestArrayItemType;
+    objectSchema?: ObjectSchemaField[];
+    required?: boolean;
+}
 declare const definition: import("./types").NodeDefinition<"api-request", "generator", {
     url: string;
     method: HttpMethod;
     headers: HeaderEntry[];
     body: string;
-    outputFields: ObjectSchemaField[];
+    outputFields: ApiRequestOutputField[];
     outputMode: OutputMode;
     selectionMode: SelectionMode | null;
 }, ApiRequestNodeInputs, ApiRequestNodeOutputs, false>;

package/dist/automations/nodes/api-request.js

@@ -8,6 +8,41 @@ const types_1 = require("./types");
 // =============================================================================
 const HttpMethods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
 exports.HttpMethods = HttpMethods;
+function getArrayItemPortType(items) {
+    switch (items) {
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'object':
+            return 'object';
+        case 'image':
+            return 'image';
+        default:
+            return 'text';
+    }
+}
+function getOutputPortShape(field) {
+    if (field.type === 'array') {
+        return {
+            type: getArrayItemPortType(field.items),
+            isArray: true,
+        };
+    }
+    if (field.type === 'object') {
+        return { type: 'object', isArray: false };
+    }
+    if (field.type === 'number') {
+        return { type: 'number', isArray: false };
+    }
+    if (field.type === 'boolean') {
+        return { type: 'boolean', isArray: false };
+    }
+    if (field.type === 'image') {
+        return { type: 'image', isArray: false };
+    }
+    return { type: 'text', isArray: false };
+}
 // =============================================================================
 // Node Definition
 // =============================================================================
@@ -15,7 +50,7 @@ const definition = (0, types_1.defineNode)({
     nodeId: 'api-request',
     label: 'API Request',
     description: 'Make HTTP requests to external APIs',
-    guide: 'Makes HTTP requests to external APIs and returns parsed response data. Use when you need to fetch data from or send data to external services. Configure URL, method (GET/POST/PUT/PATCH/DELETE), headers, and body. Supports template variables ({{var}}) in URL, header values, and body for dynamic values from upstream nodes. Define output fields to extract specific data from JSON responses. Use cases: fetching external data, triggering webhooks, integrating third-party APIs, sending data to external services.',
+    guide: 'Makes HTTP requests to external APIs and returns parsed response data. Use when you need to fetch data from or send data to external services. Configure URL, method (GET/POST/PUT/PATCH/DELETE), headers, and body. Supports template variables ({{var}}) in URL, header values, and body for dynamic values from upstream nodes. Define output fields to extract specific data from JSON responses, including typed arrays and image URL fields that should flow into image ports. Use cases: fetching external data, triggering webhooks, integrating third-party APIs, sending data to external services.',
     type: 'generator',
     category: 'Generation',
     outputModes: ['per-input', 'single'],
@@ -49,32 +84,11 @@ const definition = (0, types_1.defineNode)({
         // Output ports from outputFields
         const outputFields = (config?.outputFields ?? [{ name: 'response', type: 'string' }]);
         const outputs = outputFields.map(f => {
-            let pType;
-            let pIsArray;
-            if (f.type === 'array') {
-                pType = f.items === 'object' ? 'object' : 'text';
-                pIsArray = true;
-            }
-            else if (f.type === 'object') {
-                pType = 'object';
-                pIsArray = false;
-            }
-            else if (f.type === 'number') {
-                pType = 'number';
-                pIsArray = false;
-            }
-            else if (f.type === 'boolean') {
-                pType = 'boolean';
-                pIsArray = false;
-            }
-            else {
-                pType = 'text';
-                pIsArray = false;
-            }
+            const { type, isArray } = getOutputPortShape(f);
             return {
                 id: f.name,
-                type: pType,
-                isArray: pIsArray,
+                type,
+                isArray,
                 required: f.required ?? true,
                 ...(f.objectSchema && { objectSchema: f.objectSchema }),
             };

package/dist/automations/nodes/index.d.ts

@@ -18,7 +18,7 @@ export declare const nodeDefinitions: {
         method: import("./api-request").HttpMethod;
         headers: import("./api-request").HeaderEntry[];
         body: string;
-        outputFields: import("./types").ObjectSchemaField[];
+        outputFields: import("./api-request").ApiRequestOutputField[];
         outputMode: import("./types").OutputMode;
         selectionMode: import("./types").SelectionMode | null;
     }, import("./api-request").ApiRequestNodeInputs, import("./api-request").ApiRequestNodeOutputs, false> & {

package/dist/automations/types.d.ts

@@ -538,7 +538,7 @@ export declare function isAsyncExecutor(executor: AnyNodeExecutor | AnyAsyncNode
 /**
  * Validation error types for automation workflows
  */
-export type ValidationErrorType = 'missing_trigger' | 'missing_terminal' | 'missing_required_input' | 'type_mismatch' | 'empty_media_pool' | 'empty_account_pool' | 'circular_dependency' | 'for_each_boundary_violation' | 'invalid_node_config';
+export type ValidationErrorType = 'missing_trigger' | 'missing_terminal' | 'missing_required_input' | 'type_mismatch' | 'empty_media_pool' | 'empty_account_pool' | 'circular_dependency' | 'for_each_boundary_violation' | 'invalid_node_config' | 'duplicate_port_name';
 /**
  * Structured validation error with location info for UI highlighting
  */

package/dist/index.d.ts

@@ -28,7 +28,7 @@ export type { ClientConfig } from './base';
 export type { Account, AccountStat, AccountTask, EditProfileInfo, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, AccountInfoUpdate, UpdateAccountInfoParams, AccountInfoUpdateResult, UpdateAccountInfoResponse, AccountSocialUpdate, UpdateAccountSocialParams, AccountSocialUpdateResult, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, NicheSwitchUpdate, NicheSwitchParams, NicheSwitchResult, NicheSwitchResponse, CreateAccountInput, CreateAccountsParams, CreateAccountResult, CreateAccountsResponse, TroubleshootFailReason, TroubleshootAccount, TroubleshootParams, } from './accounts';
 export type { TaskType, Task, GetTasksParams } from './tasks';
 export type { PostType, PostStatus, Post, PostStat, GetPostsParams, CreateDraftParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
-export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, RefreshStartEvent, RefreshProgressEvent, RefreshDoneEvent, RefreshStreamEvent, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, DashboardDailyStat, GetDashboardDailyStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, } from './stats';
+export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, RefreshStatsProgressResponse, RefreshStartEvent, RefreshProgressEvent, RefreshDoneEvent, RefreshStreamEvent, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, DashboardDailyStat, GetDashboardDailyStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, } from './stats';
 export type { Org, ApiKey, DeleteApiKeyParams, EditApiKeyParams, IntegrationKey, IntegrationProvider, UpsertIntegrationKeyParams, DeleteIntegrationKeyParams } from './org';
 export type { UserMedia, MediaUse, SocialAudio, Media, GetMediaParams, GetSocialAudioParams, UploadMediaParams, UploadMediaResponse, MediaTagUpdate, UpdateMediaTagsParams, MediaTagUpdateResult, UpdateMediaTagsResponse, UpdateMediaTagParams, UpdateMediaNameParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, ImportTextParams, ImportTextResponse, CreateMediaFromUrlParams, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, GetUploadTokenParams, UploadTokenResponse, } from './media';
 export type { CommentStatus, Comment, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './comments';
@@ -38,7 +38,7 @@ export type { VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, Vid
 export type { ImageEditorNodeConfig, ImageComposerNodeConfig, ImageComposerRenderInput } from './automations/nodes/image-composer';
 export { prepareImageComposerInput } from './automations/nodes/image-composer';
 export type { AccountNodeConfig } from './automations/nodes/account';
-export type { ApiRequestNodeConfig, HeaderEntry, HttpMethod } from './automations/nodes/api-request';
+export type { ApiRequestNodeConfig, ApiRequestOutputField, ApiRequestOutputType, ApiRequestArrayItemType, HeaderEntry, HttpMethod, } from './automations/nodes/api-request';
 export { HttpMethods } from './automations/nodes/api-request';
 export type { AutoCaptionNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, } from './automations/nodes/auto-caption';
 export { nodeConfigToCaptionStyle } from './automations/nodes/auto-caption';

package/dist/stats.d.ts

@@ -12,11 +12,23 @@ export interface RefreshStatsError {
     error: string;
 }
 export interface RefreshStatsResponse {
-    accounts_refreshed: number;
-    accounts_failed: number;
-    total_accounts: number;
-    post_stats_count: number;
-    errors?: RefreshStatsError[];
+    batchId: string;
+    batchCreatedAtMs: number;
+    queuedAccounts: number;
+    totalAccounts: number;
+    totalPosts: number;
+}
+export interface RefreshStatsProgressResponse {
+    batchId: string;
+    batchCreatedAtMs: number;
+    totalAccounts: number;
+    completedAccounts: number;
+    failedAccounts: number;
+    activeAccounts: number;
+    queuedAccounts: number;
+    done: boolean;
+    totalPosts: number;
+    completedPosts: number;
 }
 export interface DailyAggregatedStat {
     date: Date | string;
@@ -358,6 +370,10 @@ export declare class StatsClient extends BaseClient {
      * Note: Can only be called once per hour per organization (or per org_group if specified)
      */
     refresh(params?: RefreshStatsParams): Promise<ApiResponse<RefreshStatsResponse>>;
+    getRefreshProgress(params: {
+        batchId: string;
+        org_group?: string;
+    }): Promise<ApiResponse<RefreshStatsProgressResponse>>;
     /**
      * Refresh stats with NDJSON streaming progress.
      * Returns the raw Response so the caller can read the stream.

package/dist/stats.js

@@ -209,6 +209,13 @@ class StatsClient extends base_1.BaseClient {
     async refresh(params) {
         return this.post('/stats/refresh', params ?? {});
     }
+    async getRefreshProgress(params) {
+        const searchParams = new URLSearchParams({ batchId: params.batchId });
+        if (params.org_group) {
+            searchParams.set('org_group', params.org_group);
+        }
+        return this.get(`/stats/refresh/progress?${searchParams.toString()}`);
+    }
     /**
      * Refresh stats with NDJSON streaming progress.
      * Returns the raw Response so the caller can read the stream.

package/package.json

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