ugcinc 3.56.0 → 3.58.0

package/dist/automations.js

@@ -583,6 +583,25 @@ function getAllNodes() {
             // - {branch-id}-{passthrough-id} (same type as input)
             outputs: [],
         },
+        {
+            type: "branch",
+            label: "Branch",
+            description: "Route inputs based on a key match",
+            category: "Control Flow",
+            nodeCategory: "generator",
+            // Static input: key (text) to match against branch keys
+            // Dynamic inputs based on branchConfig.passthroughInputs where isVariable is true
+            inputs: [
+                {
+                    id: "key",
+                    type: "text",
+                    required: true,
+                },
+            ],
+            // Dynamic outputs: for each passthrough input and branch, creates:
+            // - {branch-key}-{passthrough-id} (same type as input)
+            outputs: [],
+        },
         // === Terminal nodes ===
         {
             type: "auto-post",

package/dist/types.d.ts

@@ -846,7 +846,7 @@ export interface NodeControlConfig {
      */
     isInitializer?: boolean;
 }
-export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm';
+export type NodeTypeEnum = 'social-audio' | 'text' | 'media' | 'video-import' | 'image-composer' | 'video-composer' | 'generate-image' | 'generate-video' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'compose-workflow' | 'account' | 'auto-post' | 'save-to-media' | 'deduplicate' | 'for-each' | 'random' | 'random-route' | 'branch' | 'if' | 'not' | 'transcript' | 'auto-caption' | 'screenshot-animation' | 'create-dm';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';
@@ -872,6 +872,8 @@ export interface LLMOutputField {
     minLength?: number;
     /** Maximum array length constraint */
     maxLength?: number;
+    /** Whether this output is optional (can be omitted by the LLM) */
+    optional?: boolean;
 }
 /**
  * API Keys configuration for LLM providers (user can bring their own)
@@ -964,6 +966,7 @@ export interface WorkflowNodeDefinition {
         randomConfig?: RandomNodeConfig;
         ifConfig?: IfNodeConfig;
         randomRouteConfig?: RandomRouteNodeConfig;
+        branchConfig?: BranchNodeConfig;
         autoCaptionConfig?: AutoCaptionNodeConfig;
         screenshotAnimationConfig?: ScreenshotAnimationNodeConfig;
         createDmConfig?: CreateDmNodeConfig;
@@ -1360,6 +1363,41 @@ export interface RandomRouteNodeConfig {
     /** Passthrough inputs that get routed to one branch's outputs */
     passthroughInputs: RandomRoutePassthroughInput[];
 }
+/**
+ * Branch node branch definition
+ */
+export interface BranchDefinition {
+    /** The key to match against (e.g., "happy", "sad", "neutral") */
+    key: string;
+}
+/**
+ * Branch node passthrough input definition
+ */
+export interface BranchPassthroughInput {
+    /** The input port ID (lowercase, hyphens/underscores only) */
+    id: string;
+    /** The value type */
+    type: 'image' | 'video' | 'audio' | 'text' | 'number' | 'boolean' | 'account' | 'object';
+    /** Whether this is an array type */
+    isArray?: boolean;
+    /** Whether this input comes from a variable (input port) vs static branch values. Defaults to false. */
+    isVariable?: boolean;
+    /** Static values per branch when isVariable is false. Key is branch key, value is the static value. */
+    branchValues?: Record<string, unknown>;
+    /** Object schema for object type (when type is 'object') */
+    objectSchema?: RandomRouteObjectField[];
+}
+/**
+ * Branch node configuration - routes inputs to a branch based on key match
+ */
+export interface BranchNodeConfig {
+    /** Output branches with keys to match against */
+    branches: BranchDefinition[];
+    /** Passthrough inputs that get routed to the matched branch's outputs */
+    passthroughInputs: BranchPassthroughInput[];
+    /** Optional default branch key if no match is found */
+    defaultBranchKey?: string;
+}
 /**
  * Supported platforms for video import
  * Note: YouTube is not yet implemented

package/package.json

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