ugcinc 4.1.31 → 4.1.33

package/dist/automations/types.d.ts

@@ -144,6 +144,27 @@ export interface NodePort {
     /** Options for enum port types */
     enumOptions?: EnumOption[];
 }
+/**
+ * NodePort with preview value attached.
+ * Used by computePortsWithPreviews to include resolved preview data
+ * directly on input ports, eliminating separate previewMap lookups.
+ */
+export interface NodePortWithPreview extends NodePort {
+    /**
+     * The preview value flowing into this input port.
+     * Type depends on the port type:
+     * - image: ImageValue
+     * - video: VideoValue
+     * - audio: AudioValue
+     * - text: string
+     * - account: AccountData
+     * - etc.
+     *
+     * null if no connection or source has no preview.
+     * undefined if not computed (shouldn't happen with computePortsWithPreviews).
+     */
+    previewValue?: PortValue | PortValue[] | null;
+}
 /**
  * Port definition for resolved/dynamic ports.
  * Stored in node config when the automation is saved.

package/dist/graph-controller.d.ts

@@ -10,7 +10,7 @@
  *
  * All functions work with WorkflowNodeDefinition[] (embedded connection format).
  */
-import type { WorkflowNodeDefinition, ComputedNode, NodePort, BasePortType, ValidationError, UserCreatableNodeType, PortValue, AccountData } from './automations/types';
+import type { WorkflowNodeDefinition, ComputedNode, NodePort, NodePortWithPreview, BasePortType, ValidationError, UserCreatableNodeType, PortValue, AccountData } from './automations/types';
 import type { ObjectSchemaField, ResolvedPreview } from './automations/nodes/types';
 import type { Media } from './media';
 /**
@@ -71,6 +71,29 @@ export declare function computePortsForNode({ node, getConnectedOutput, }: {
     inputs: NodePort[];
     outputs: NodePort[];
 };
+/**
+ * Compute ports for a node with preview values attached to input ports.
+ * Combines port computation with preview lookup for a single source of truth.
+ *
+ * Each input port will have a `previewValue` property containing the resolved
+ * preview value from its connected source node (or null if no connection).
+ *
+ * @param node - The workflow node definition
+ * @param previewMap - The computed preview map (from computePreviewMap)
+ * @param getConnectedOutput - Optional function to get connected output port info
+ */
+export declare function computePortsWithPreviews({ node, previewMap, getConnectedOutput, }: {
+    node: WorkflowNodeDefinition;
+    previewMap: PreviewMap;
+    getConnectedOutput?: (inputId: string) => {
+        type: BasePortType | BasePortType[];
+        isArray: boolean;
+        objectSchema?: ObjectSchemaField[];
+    } | null;
+}): {
+    inputs: NodePortWithPreview[];
+    outputs: NodePort[];
+};
 /**
  * Get all available automation nodes.
  * Converts node definitions from the registry into ComputedNode format.
@@ -354,18 +377,22 @@ export declare function updatePreviewMapForConnection({ nodes, media, accounts,
     accounts: AccountData[];
 }): PreviewMap;
 /**
- * Re-generate preview outputs for a specific node with a different selection index.
+ * Re-generate preview values for a source node and update all connections from it.
  * Used for "shuffle" functionality in the editor.
  *
- * @param node - The workflow node to shuffle (typically a source node with a pool)
+ * @param nodes - All workflow nodes
+ * @param sourceNodeId - The node to shuffle (typically a source node with a pool)
  * @param shuffleCount - The shuffle index (0 = first pick, 1 = second pick, etc.)
  * @param media - Media library for source nodes
  * @param accounts - Account list for account nodes
- * @returns Preview values for this node's outputs, or null if node type not found
+ * @param currentPreviewMap - The current preview map to update
+ * @returns Updated preview map with new values for all connections from the source node
  */
-export declare function shuffleNodePreview({ node, shuffleCount, media, accounts, }: {
-    node: WorkflowNodeDefinition;
+export declare function shuffleNodePreview({ nodes, sourceNodeId, shuffleCount, media, accounts, currentPreviewMap, }: {
+    nodes: WorkflowNodeDefinition[];
+    sourceNodeId: string;
     shuffleCount: number;
     media: Media[];
     accounts: AccountData[];
-}): Record<string, PortValue | PortValue[] | null> | null;
+    currentPreviewMap: PreviewMap;
+}): PreviewMap;

package/dist/graph-controller.js

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.areTypesCompatible = areTypesCompatible;
 exports.computePortsForNode = computePortsForNode;
+exports.computePortsWithPreviews = computePortsWithPreviews;
 exports.getAllNodes = getAllNodes;
 exports.getNodeByType = getNodeByType;
 exports.getOutputSchema = getOutputSchema;
@@ -268,6 +269,26 @@ function computePortsForNode({ node, getConnectedOutput, }) {
     }
     return definition.computePortsFromNode(node, getConnectedOutput);
 }
+/**
+ * Compute ports for a node with preview values attached to input ports.
+ * Combines port computation with preview lookup for a single source of truth.
+ *
+ * Each input port will have a `previewValue` property containing the resolved
+ * preview value from its connected source node (or null if no connection).
+ *
+ * @param node - The workflow node definition
+ * @param previewMap - The computed preview map (from computePreviewMap)
+ * @param getConnectedOutput - Optional function to get connected output port info
+ */
+function computePortsWithPreviews({ node, previewMap, getConnectedOutput, }) {
+    const { inputs, outputs } = computePortsForNode({ node, getConnectedOutput });
+    // Augment each input port with its preview value
+    const inputsWithPreviews = inputs.map(port => ({
+        ...port,
+        previewValue: previewMap[`${node.id}:${port.id}`] ?? null,
+    }));
+    return { inputs: inputsWithPreviews, outputs };
+}
 /**
  * Get all available automation nodes.
  * Converts node definitions from the registry into ComputedNode format.
@@ -981,19 +1002,24 @@ function updatePreviewMapForConnection({ nodes, media, accounts, }) {
     return computePreviewMap({ nodes, media, accounts });
 }
 /**
- * Re-generate preview outputs for a specific node with a different selection index.
+ * Re-generate preview values for a source node and update all connections from it.
  * Used for "shuffle" functionality in the editor.
  *
- * @param node - The workflow node to shuffle (typically a source node with a pool)
+ * @param nodes - All workflow nodes
+ * @param sourceNodeId - The node to shuffle (typically a source node with a pool)
  * @param shuffleCount - The shuffle index (0 = first pick, 1 = second pick, etc.)
  * @param media - Media library for source nodes
  * @param accounts - Account list for account nodes
- * @returns Preview values for this node's outputs, or null if node type not found
+ * @param currentPreviewMap - The current preview map to update
+ * @returns Updated preview map with new values for all connections from the source node
  */
-function shuffleNodePreview({ node, shuffleCount, media, accounts, }) {
-    const definition = nodes_1.nodeDefinitions[node.type];
+function shuffleNodePreview({ nodes, sourceNodeId, shuffleCount, media, accounts, currentPreviewMap, }) {
+    const sourceNode = nodes.find(n => n.id === sourceNodeId);
+    if (!sourceNode)
+        return currentPreviewMap;
+    const definition = nodes_1.nodeDefinitions[sourceNode.type];
     if (!definition)
-        return null;
+        return currentPreviewMap;
     // Build context with shuffleCount as consumedCount
     const ctx = {
         inputPreviews: {},
@@ -1001,8 +1027,18 @@ function shuffleNodePreview({ node, shuffleCount, media, accounts, }) {
         accounts,
         selectionState: { consumedCount: shuffleCount },
     };
-    // Get cached outputs from node.preview_outputs
-    const cachedOutputs = node.preview_outputs ?? null;
-    // Call generatePreviewFromNode - handles type correlation via runtime check
-    return definition.generatePreviewFromNode(node, ctx, cachedOutputs);
+    // Generate new outputs for this node
+    const newOutputs = definition.generatePreviewFromNode(sourceNode, ctx, sourceNode.preview_outputs ?? null);
+    if (!newOutputs)
+        return currentPreviewMap;
+    // Find all connections from this source and update their preview values
+    const connections = deriveConnectionsInternal(nodes);
+    const newMap = { ...currentPreviewMap };
+    for (const conn of connections) {
+        if (conn.sourceNodeId === sourceNodeId) {
+            const key = `${conn.targetNodeId}:${conn.targetInputId}`;
+            newMap[key] = newOutputs[conn.sourceOutputId] ?? null;
+        }
+    }
+    return newMap;
 }

package/dist/index.d.ts

@@ -13,7 +13,7 @@ export { RenderClient } from './render';
 export { AutomationsClient } from './automations';
 export { MediaClient } from './media';
 export { CommentsClient } from './comments';
-export { areTypesCompatible, computePortsForNode, getAllNodes, getNodeByType, getOutputSchema, createNode, deriveConnections, addConnection, removeConnection, removeNodeConnections, cleanupStaleConnections, getForEachContext, checkCrossContextViolation, validateWorkflow, getErrorNodeIds, getPortErrorsForNode, hasMissingTriggerError, hasMissingTerminalError, getWorkflowOutputSchema, type WorkflowOutputSchemaEntry, resolveNodePreview, computeAllNodePreviews, computePreviewMap, updatePreviewMapForConnection, removePreviewForConnection, getPreviewValue, shuffleNodePreview, type PreviewMap, type NodePreviewOutputs, type Connection, generateNodeName, extractWorkflowConfig, type WorkflowTemplateData, } from './graph-controller';
+export { areTypesCompatible, computePortsForNode, computePortsWithPreviews, getAllNodes, getNodeByType, getOutputSchema, createNode, deriveConnections, addConnection, removeConnection, removeNodeConnections, cleanupStaleConnections, getForEachContext, checkCrossContextViolation, validateWorkflow, getErrorNodeIds, getPortErrorsForNode, hasMissingTriggerError, hasMissingTerminalError, getWorkflowOutputSchema, type WorkflowOutputSchemaEntry, resolveNodePreview, computeAllNodePreviews, computePreviewMap, updatePreviewMapForConnection, removePreviewForConnection, getPreviewValue, shuffleNodePreview, type PreviewMap, type NodePreviewOutputs, type Connection, generateNodeName, extractWorkflowConfig, type WorkflowTemplateData, } from './graph-controller';
 export { nodeDefinitions, internalNodeTypes, isAsyncExecutor, formatPortType } from './automations/types';
 export { getNodeDefinition } from './automations/nodes';
 export { isEditModel, ALL_IMAGE_MODELS, IMAGE_ASPECT_RATIOS } from './automations/nodes/generate-image';
@@ -68,7 +68,7 @@ export type { TranscriptNodeConfig } from './automations/nodes/transcript';
 export type { VideoComposerNodeConfig, VideoComposerRenderInput } from './automations/nodes/video-composer';
 export { prepareVideoComposerInput } from './automations/nodes/video-composer';
 export type { VideoImportNodeConfig, VideoImportPlatform, VideoImportQuality, } from './automations/nodes/video-import';
-export type { MediaType, BasePortType, EnumOption, ImageValue, VideoValue, AudioValue, TextValue, NumberValue, BooleanValue, DateValue, EnumValue, SocialAudioValue, ObjectValue, PortValueFor, PortValue, NodeOutputValues, NodePort, ResolvedPort, ResolvedPorts, ComputedNode, OutputSchemaProperty, WorkflowNodeDefinition, CanvasState, WorkflowDefinition, TemplateNode, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, AccountData, FlowControlOutput, ExecutorContext, NodeExecutor, AsyncNodeExecutor, AnyNodeExecutor, AnyAsyncNodeExecutor, ExecutorAsyncJobStatus, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, InternalWorkflowConfig, AllWorkflowConfig, } from './automations/types';
+export type { MediaType, BasePortType, EnumOption, ImageValue, VideoValue, AudioValue, TextValue, NumberValue, BooleanValue, DateValue, EnumValue, SocialAudioValue, ObjectValue, PortValueFor, PortValue, NodeOutputValues, NodePort, NodePortWithPreview, ResolvedPort, ResolvedPorts, ComputedNode, OutputSchemaProperty, WorkflowNodeDefinition, CanvasState, WorkflowDefinition, TemplateNode, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, AccountData, FlowControlOutput, ExecutorContext, NodeExecutor, AsyncNodeExecutor, AnyNodeExecutor, AnyAsyncNodeExecutor, ExecutorAsyncJobStatus, ValidationErrorType, ValidationError, ExportedNode, ExportedConnection, ExportedTemplate, AutomationExport, ExportedExecutor, ExportedEdge, ExportedRun, AutomationRunExport, InternalWorkflowConfig, AllWorkflowConfig, } from './automations/types';
 export type { NodeDefinition, NodeType, UserCreatableNodeType, NodeConfig, WorkflowConfig, InternalNodeType, } from './automations/nodes';
 export type { SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeCategory, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, ObjectSchemaField, MediaItemType, MediaNodeSelectionType, ResolvedPreview, PreviewSelectionState, PreviewContext, NullableOutputs, } from './automations/nodes/types';
 export type { SuccessResponse, ErrorResponse, ApiResponse, } from './types';

package/dist/index.js

@@ -5,8 +5,8 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getModelDurations = exports.getModelAspectRatios = exports.ALL_VIDEO_MODELS = exports.isImageToVideoModel = exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = exports.isEditModel = exports.getNodeDefinition = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.extractWorkflowConfig = exports.generateNodeName = exports.shuffleNodePreview = exports.getPreviewValue = exports.removePreviewForConnection = exports.updatePreviewMapForConnection = exports.computePreviewMap = exports.computeAllNodePreviews = exports.resolveNodePreview = exports.getWorkflowOutputSchema = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.checkCrossContextViolation = exports.getForEachContext = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.createNode = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.computePortsForNode = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
-exports.prepareVideoComposerInput = exports.LLMProviders = exports.IfLogicOperators = exports.indexExpressionToIndexes = exports.prepareImageComposerInput = exports.extractTemplateVariables = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = void 0;
+exports.getModelAspectRatios = exports.ALL_VIDEO_MODELS = exports.isImageToVideoModel = exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = exports.isEditModel = exports.getNodeDefinition = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.extractWorkflowConfig = exports.generateNodeName = exports.shuffleNodePreview = exports.getPreviewValue = exports.removePreviewForConnection = exports.updatePreviewMapForConnection = exports.computePreviewMap = exports.computeAllNodePreviews = exports.resolveNodePreview = exports.getWorkflowOutputSchema = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.checkCrossContextViolation = exports.getForEachContext = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.createNode = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.computePortsWithPreviews = exports.computePortsForNode = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.prepareVideoComposerInput = exports.LLMProviders = exports.IfLogicOperators = exports.indexExpressionToIndexes = exports.prepareImageComposerInput = exports.extractTemplateVariables = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = exports.getModelDurations = void 0;
 // =============================================================================
 // Client Exports
 // =============================================================================
@@ -38,6 +38,7 @@ var graph_controller_1 = require("./graph-controller");
 Object.defineProperty(exports, "areTypesCompatible", { enumerable: true, get: function () { return graph_controller_1.areTypesCompatible; } });
 // Port computation
 Object.defineProperty(exports, "computePortsForNode", { enumerable: true, get: function () { return graph_controller_1.computePortsForNode; } });
+Object.defineProperty(exports, "computePortsWithPreviews", { enumerable: true, get: function () { return graph_controller_1.computePortsWithPreviews; } });
 Object.defineProperty(exports, "getAllNodes", { enumerable: true, get: function () { return graph_controller_1.getAllNodes; } });
 Object.defineProperty(exports, "getNodeByType", { enumerable: true, get: function () { return graph_controller_1.getNodeByType; } });
 // Output schema

package/package.json

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