ugcinc 3.8.1 → 3.10.0

package/dist/automations.d.ts

@@ -1,4 +1,4 @@
-import type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse } from './types';
+import type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse, AutomationExport, AutomationRunExport } from './types';
 import { BaseClient } from './base';
 export declare class AutomationsClient extends BaseClient {
     /**
@@ -104,6 +104,20 @@ export declare class AutomationsClient extends BaseClient {
     deleteRun(params: {
         runId: string;
     }): Promise<ApiResponse<null>>;
+    /**
+     * Export automation template for debugging
+     * Returns the complete template definition with nodes and connections
+     */
+    exportTemplate(params: {
+        templateId: string;
+    }): Promise<ApiResponse<AutomationExport>>;
+    /**
+     * Export automation run for debugging
+     * Returns the complete run data including execution state, executor outputs, and edge values
+     */
+    exportRun(params: {
+        runId: string;
+    }): Promise<ApiResponse<AutomationRunExport>>;
 }
 /**
  * Get all available automation nodes

package/dist/automations.js

@@ -110,6 +110,26 @@ class AutomationsClient extends base_1.BaseClient {
             body: JSON.stringify(params),
         });
     }
+    /**
+     * Export automation template for debugging
+     * Returns the complete template definition with nodes and connections
+     */
+    async exportTemplate(params) {
+        return this.request('/automations/export', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
+    /**
+     * Export automation run for debugging
+     * Returns the complete run data including execution state, executor outputs, and edge values
+     */
+    async exportRun(params) {
+        return this.request('/automations/export-run', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
 }
 exports.AutomationsClient = AutomationsClient;
 /**

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, 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, } 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, 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';

package/dist/types.d.ts

@@ -1158,12 +1158,27 @@ export interface ForEachOutputProperty {
     /** The output type for the port */
     type: 'text' | 'object';
 }
+/**
+ * For-each input port configuration
+ * Defines passthrough inputs that capture single values before expansion
+ * and pass them unchanged to all iterations (Mode 2: Single-Value Passthrough)
+ */
+export interface ForEachInputPort {
+    /** The port ID (lowercase, hyphens/underscores only) */
+    id: string;
+    /** Display title for the port */
+    title: string;
+    /** The port type */
+    type: 'image' | 'video' | 'audio' | 'text' | 'object' | 'account';
+}
 /**
  * For-each node configuration
  */
 export interface ForEachNodeConfig {
     /** Properties to extract from each item and expose as separate outputs */
     outputProperties?: ForEachOutputProperty[];
+    /** Input ports for single-value passthrough (Mode 2) */
+    inputPorts?: ForEachInputPort[];
 }
 /**
  * Supported platforms for video import
@@ -1370,6 +1385,7 @@ export interface ExecutorNode {
     type: NodeTypeEnum;
     status: 'pending' | 'running' | 'completed' | 'failed';
     output_value: unknown | null;
+    error_message: string | null;
     created_at: string;
     completed_at: string | null;
 }
@@ -1539,3 +1555,110 @@ export interface ValidationError {
     portId?: string;
     message: string;
 }
+/**
+ * Exported node representation for debugging
+ */
+export interface ExportedNode {
+    nodeId: string;
+    type: string;
+    name: string | null;
+    position: {
+        x: number;
+        y: number;
+    };
+    inputs: Record<string, {
+        sourceNodeId: string;
+        sourceOutputId: string;
+    }>;
+    config: Record<string, unknown>;
+}
+/**
+ * Exported connection representation
+ */
+export interface ExportedConnection {
+    from: {
+        nodeId: string;
+        port: string;
+    };
+    to: {
+        nodeId: string;
+        port: string;
+    };
+}
+/**
+ * Exported template data
+ */
+export interface ExportedTemplate {
+    id: string;
+    name: string;
+    description: string | null;
+    canvasState: {
+        zoom: number;
+        panX: number;
+        panY: number;
+    } | null;
+    outputSchema: Record<string, {
+        type: string;
+    }> | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Full automation export (template + nodes + connections)
+ */
+export interface AutomationExport {
+    template: ExportedTemplate;
+    nodes: ExportedNode[];
+    connections: ExportedConnection[];
+}
+/**
+ * Exported executor data
+ */
+export interface ExportedExecutor {
+    id: string;
+    nodeTemplateId: string;
+    executorIndex: number;
+    type: string;
+    status: string;
+    outputValue: unknown;
+    errorMessage: string | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+/**
+ * Exported edge data
+ */
+export interface ExportedEdge {
+    sourceExecutorId: string;
+    sourceNodeId: string;
+    sourcePort: string;
+    targetExecutorId: string;
+    targetNodeId: string;
+    targetPort: string;
+    value: unknown;
+}
+/**
+ * Exported run data
+ */
+export interface ExportedRun {
+    id: string;
+    templateId: string;
+    templateName: string;
+    status: string;
+    variableInputs: Record<string, string> | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+/**
+ * Full automation run export
+ */
+export interface AutomationRunExport {
+    run: ExportedRun;
+    template: ExportedTemplate;
+    nodes: ExportedNode[];
+    connections: ExportedConnection[];
+    execution: {
+        executors: ExportedExecutor[];
+        edges: ExportedEdge[];
+    };
+}

package/package.json

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