ugcinc 4.1.32 → 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.

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.

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.32",
+  "version": "4.1.33",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",