ugcinc 4.1.56 → 4.1.58

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

@@ -1,4 +1,4 @@
-import type { NodePort, PortValue } from '../types';
+import type { NodePort, PortValue, FlowControlOutput } from '../types';
 import { type InputType, type OutputMode } from './types';
 /**
  * Branch node inputs: required key input + dynamic branch-specific inputs.
@@ -30,6 +30,7 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 declare const _default: typeof definition & {
     __TInputs: BranchNodeInputs;
     __TOutputs: BranchNodeOutputs;
+    __TExecutorOutput: FlowControlOutput;
 };
 export default _default;
 export type BranchNodeConfig = typeof definition.defaults;

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

@@ -20,7 +20,7 @@ export interface CollectNodeInputs {
     _collectedValues?: CollectedValues;
 }
 export interface CollectNodeOutputs {
-    array: CollectInputValue[];
+    array: (CollectInputValue | null)[];
 }
 declare const definition: import("./types").NodeDefinition<"generator", {
     expectedCount: number | undefined;

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

@@ -1,4 +1,4 @@
-import type { NodePort, PortValue } from '../types';
+import type { NodePort, PortValue, FlowControlOutput } from '../types';
 import { type OutputMode } from './types';
 /**
  * If node inputs: dynamic boolean condition inputs + passthrough inputs.
@@ -25,6 +25,7 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 declare const _default: typeof definition & {
     __TInputs: IfNodeInputs;
     __TOutputs: IfNodeOutputs;
+    __TExecutorOutput: FlowControlOutput;
 };
 export default _default;
 export { IfLogicOperators };

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

@@ -65,6 +65,7 @@ export declare const nodeDefinitions: {
     }, import("./branch").BranchNodeInputs, import("./branch").BranchNodeOutputs, false> & {
         __TInputs: import("./branch").BranchNodeInputs;
         __TOutputs: import("./branch").BranchNodeOutputs;
+        __TExecutorOutput: import("../types").FlowControlOutput;
     };
     readonly collect: NodeDefinition<"generator", {
         expectedCount: number | undefined;
@@ -187,6 +188,7 @@ export declare const nodeDefinitions: {
     }, import("./if").IfNodeInputs, import("./if").IfNodeOutputs, false> & {
         __TInputs: import("./if").IfNodeInputs;
         __TOutputs: import("./if").IfNodeOutputs;
+        __TExecutorOutput: import("../types").FlowControlOutput;
     };
     readonly 'image-composer': NodeDefinition<"generator", {
         imageEditor: {
@@ -271,6 +273,7 @@ export declare const nodeDefinitions: {
     }, import("./random-route").RandomRouteNodeInputs, import("./random-route").RandomRouteNodeOutputs, false> & {
         __TInputs: import("./random-route").RandomRouteNodeInputs;
         __TOutputs: import("./random-route").RandomRouteNodeOutputs;
+        __TExecutorOutput: import("../types").FlowControlOutput;
     };
     readonly recurrence: NodeDefinition<"trigger", {
         frequencyType: "per-day" | "periodic";
@@ -383,6 +386,10 @@ type InputsOf<T> = T extends {
 type OutputsOf<T> = T extends {
     __TOutputs: infer O;
 } ? O : never;
+/** Helper to extract executor output types from node definitions (falls back to __TOutputs) */
+type ExecutorOutputsOf<T> = T extends {
+    __TExecutorOutput: infer E;
+} ? E : OutputsOf<T>;
 /**
  * Input type lookup by node ID.
  * Auto-derived from phantom types on node definitions.
@@ -401,6 +408,16 @@ export type NodeInputs = {
 export type NodeOutputs = {
     [K in UserCreatableNodeType]: OutputsOf<(typeof nodeDefinitions)[K]>;
 };
+/**
+ * Executor output type lookup by node ID.
+ * Auto-derived from __TExecutorOutput phantom type, falls back to __TOutputs.
+ * Flow control nodes (branch, random-route, if) return FlowControlOutput.
+ * @example ExecutorOutputs['branch'] // FlowControlOutput
+ * @example ExecutorOutputs['llm'] // Record<string, PortValue | PortValue[]>
+ */
+export type ExecutorOutputs = {
+    [K in UserCreatableNodeType]: ExecutorOutputsOf<(typeof nodeDefinitions)[K]>;
+};
 export { internalNodeTypes, type InternalNodeType };
 export type { NodeDefinition } from './types';
 /** Union of all node definition types */

package/dist/automations/nodes/random-route.d.ts

@@ -1,4 +1,4 @@
-import type { NodePort, PortValue } from '../types';
+import type { NodePort, PortValue, FlowControlOutput } from '../types';
 import { type InputType, type OutputMode } from './types';
 /** Random route inputs are dynamic (passthrough inputs where inputType='variable'). */
 export type RandomRouteNodeInputs = Record<string, PortValue | PortValue[]>;
@@ -21,6 +21,7 @@ declare const definition: import("./types").NodeDefinition<"generator", {
 declare const _default: typeof definition & {
     __TInputs: RandomRouteNodeInputs;
     __TOutputs: RandomRouteNodeOutputs;
+    __TExecutorOutput: FlowControlOutput;
 };
 export default _default;
 export type RandomRouteNodeConfig = typeof definition.defaults;

package/dist/automations/types.d.ts

@@ -4,7 +4,7 @@
  * Core types for the automation system including ports, selection, and output modes.
  */
 import type { ObjectSchemaField, SelectionMode, OutputMode, NodeCategory } from './nodes/types';
-import type { NodeType, UserCreatableNodeType, WorkflowConfig, NodeInputs, NodeOutputs, InternalNodeType } from './nodes';
+import type { NodeType, UserCreatableNodeType, WorkflowConfig, NodeInputs, NodeOutputs, ExecutorOutputs, InternalNodeType } from './nodes';
 import type { ForEachNodeConfig, ForEachNodeInputs, ForEachNodeOutputs } from './nodes/for-each';
 /**
  * Config type for internal node types (created dynamically at runtime).
@@ -39,6 +39,18 @@ export type InternalNodeOutputs = {
  * Combined output type lookup for all node types (user-creatable + internal).
  */
 export type AllNodeOutputs = NodeOutputs & InternalNodeOutputs;
+/**
+ * Executor output type for internal node types.
+ * for-each-value uses the same executor outputs as for-each (its parent node).
+ */
+export type InternalExecutorOutputs = {
+    'for-each-value': ForEachNodeOutputs;
+};
+/**
+ * Combined executor output type lookup for all node types (user-creatable + internal).
+ * Used by NodeExecutor to determine the return type of execute().
+ */
+export type AllExecutorOutputs = ExecutorOutputs & InternalExecutorOutputs;
 /**
  * Media type for automation nodes
  */
@@ -397,7 +409,7 @@ export interface ExecutorContext<TType extends NodeType = NodeType> {
  * Executor for synchronous nodes.
  * Generic on node type - config type is automatically derived.
  */
-export interface NodeExecutor<TType extends NodeType, TOutput = AllNodeOutputs[TType]> {
+export interface NodeExecutor<TType extends NodeType, TOutput = AllExecutorOutputs[TType]> {
     type: TType;
     /**
      * Execute the node and return a single output value.
@@ -421,7 +433,7 @@ export type ExecutorAsyncJobStatus<TOutput = unknown> = {
  * Executor for asynchronous nodes (video-editor, generate-image, workflow).
  * Uses submit/poll pattern for durable workflows.
  */
-export interface AsyncNodeExecutor<TType extends NodeType, TOutput = AllNodeOutputs[TType]> extends Omit<NodeExecutor<TType, TOutput>, 'execute'> {
+export interface AsyncNodeExecutor<TType extends NodeType, TOutput = AllExecutorOutputs[TType]> extends Omit<NodeExecutor<TType, TOutput>, 'execute'> {
     isAsync: true;
     /** Submit job - returns job ID for polling */
     submitJob: (ctx: ExecutorContext<TType>) => Promise<{

package/package.json

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