ugcinc 2.94.0 → 2.96.0

package/dist/automations.d.ts

@@ -1,4 +1,4 @@
-import type { NodeControlConfig, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse } from './types';
+import type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse } from './types';
 import { BaseClient } from './base';
 export declare class AutomationsClient extends BaseClient {
     /**
@@ -107,4 +107,4 @@ export declare function getAllNodes(): NodeControlConfig[];
  * Get a specific node by type
  */
 export declare function getNodeByType(type: string): NodeControlConfig | undefined;
-export type { NodeControlConfig, MediaType, NodePort, NodeTypeEnum };
+export type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum };

package/dist/automations.js

@@ -108,11 +108,13 @@ exports.AutomationsClient = AutomationsClient;
  */
 function getAllNodes() {
     return [
+        // === Source nodes ===
         {
             type: "image",
             label: "Image",
             description: "Import image files",
             category: "Input",
+            nodeCategory: "source",
             inputs: [],
             outputs: [
                 {
@@ -128,6 +130,7 @@ function getAllNodes() {
             label: "Video",
             description: "Import video files",
             category: "Input",
+            nodeCategory: "source",
             inputs: [],
             outputs: [
                 {
@@ -143,6 +146,7 @@ function getAllNodes() {
             label: "Audio",
             description: "Import audio files",
             category: "Input",
+            nodeCategory: "source",
             inputs: [],
             outputs: [
                 {
@@ -158,6 +162,7 @@ function getAllNodes() {
             label: "Social Audio",
             description: "Import social audio tracks",
             category: "Input",
+            nodeCategory: "source",
             inputs: [],
             outputs: [
                 {
@@ -173,6 +178,7 @@ function getAllNodes() {
             label: "Text",
             description: "Create text with templated variables",
             category: "Input",
+            nodeCategory: "source",
             inputs: [], // Dynamic inputs based on template variables
             outputs: [
                 {
@@ -183,11 +189,29 @@ function getAllNodes() {
                 },
             ],
         },
+        {
+            type: "account",
+            label: "Account",
+            description: "Select accounts to post from",
+            category: "Input",
+            nodeCategory: "source",
+            inputs: [],
+            outputs: [
+                {
+                    id: "account",
+                    title: "Account",
+                    type: "account",
+                    required: true,
+                },
+            ],
+        },
+        // === Generator nodes ===
         {
             type: "image-editor",
             label: "Image Editor",
             description: "Edit and transform images",
             category: "Templated Generation",
+            nodeCategory: "generator",
             inputs: [
                 {
                     id: "background",
@@ -210,6 +234,7 @@ function getAllNodes() {
             label: "Video Editor",
             description: "Edit and transform videos",
             category: "Templated Generation",
+            nodeCategory: "generator",
             inputs: [], // Dynamic inputs based on segments in editor config
             outputs: [
                 {
@@ -225,6 +250,7 @@ function getAllNodes() {
             label: "Image Generation",
             description: "Generate images using AI models",
             category: "AI",
+            nodeCategory: "generator",
             inputs: [
                 {
                     id: "prompt",
@@ -248,16 +274,29 @@ function getAllNodes() {
             label: "LLM",
             description: "Process input with a Large Language Model",
             category: "AI",
+            nodeCategory: "generator",
             // Dynamic inputs: extracted from systemPrompt {{variables}} + media refs
             inputs: [],
             // Dynamic outputs: based on outputFields config
             outputs: [],
         },
+        {
+            type: "workflow",
+            label: "Workflow",
+            description: "Embed another workflow as a sub-workflow",
+            category: "Flow",
+            nodeCategory: "generator",
+            // Inputs and outputs are dynamic based on the embedded workflow
+            inputs: [],
+            outputs: [],
+        },
+        // === Trigger nodes ===
         {
             type: "manual-trigger",
             label: "Manual Trigger",
             description: "Define inputs required when manually running this automation",
             category: "Triggers",
+            nodeCategory: "trigger",
             inputs: [],
             // Dynamic outputs based on manualTriggerConfig.outputs
             outputs: [],
@@ -268,40 +307,18 @@ function getAllNodes() {
             label: "Recurring",
             description: "Schedule recurring automation runs",
             category: "Triggers",
+            nodeCategory: "trigger",
             inputs: [],
             outputs: [],
             isInitializer: true,
         },
-        {
-            type: "workflow",
-            label: "Workflow",
-            description: "Embed another workflow as a sub-workflow",
-            category: "Flow",
-            // Inputs and outputs are dynamic based on the embedded workflow
-            inputs: [],
-            outputs: [],
-        },
-        {
-            type: "account",
-            label: "Account",
-            description: "Select accounts to post from",
-            category: "Input",
-            inputs: [],
-            outputs: [
-                {
-                    id: "account",
-                    title: "Account",
-                    type: "account",
-                    required: true,
-                },
-            ],
-        },
-        // === Output nodes (terminal nodes) ===
+        // === Terminal nodes ===
         {
             type: "output",
             label: "Output",
             description: "Final output of the automation",
             category: "Output",
+            nodeCategory: "terminal",
             inputs: [
                 {
                     id: "result",
@@ -317,6 +334,7 @@ function getAllNodes() {
             label: "Post Video",
             description: "Post a video to social media",
             category: "Output",
+            nodeCategory: "terminal",
             inputs: [
                 {
                     id: "video",
@@ -356,6 +374,7 @@ function getAllNodes() {
             label: "Post Slideshow",
             description: "Post a slideshow to social media",
             category: "Output",
+            nodeCategory: "terminal",
             // Dynamic inputs based on postSlideshowConfig.inputs
             inputs: [
                 {
@@ -390,6 +409,7 @@ function getAllNodes() {
             label: "Save To Media",
             description: "Save outputs to media library",
             category: "Output",
+            nodeCategory: "terminal",
             // Dynamic inputs based on config
             inputs: [],
             outputs: [],

package/dist/types.d.ts

@@ -794,11 +794,22 @@ export interface NodePort {
     type: MediaType | MediaType[];
     required: boolean;
 }
+/**
+ * Functional category for automation nodes
+ * - trigger: Nodes that start an automation (manual-trigger, recurrence)
+ * - source: Nodes that provide input data (image, video, audio, social-audio, text, account)
+ * - generator: Nodes that transform or generate content (image-editor, video-editor, image-generation, llm, workflow)
+ * - terminal: Nodes that end an automation (output, post-video, post-slideshow, save-to-media)
+ */
+export type NodeCategory = 'trigger' | 'source' | 'generator' | 'terminal';
 export interface NodeControlConfig {
     type: string;
     label: string;
     description: string;
+    /** UI display category for grouping in add node modal */
     category: string;
+    /** Functional category for node behavior classification */
+    nodeCategory: NodeCategory;
     inputs: NodePort[];
     outputs: NodePort[];
     /**
@@ -807,6 +818,7 @@ export interface NodeControlConfig {
      */
     supportsPerInputMode?: boolean;
     /**
+     * @deprecated Use nodeCategory === 'trigger' instead
      * If true, this is an initializer node (starts an automation).
      * Only one initializer node is allowed per automation.
      * Manual Trigger and Recurrence nodes are initializers.
@@ -930,6 +942,10 @@ export interface ManualTriggerOutput {
     id: string;
     title: string;
     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

package/package.json

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