ugcinc 4.1.16 → 4.1.18

package/dist/graph-controller.d.ts

@@ -40,6 +40,31 @@ export declare function areTypesCompatible({ sourceType, sourceIsArray, targetTy
     targetType: BasePortType | BasePortType[];
     targetIsArray: boolean;
 }): boolean;
+/**
+ * Compute ports for a node synchronously.
+ *
+ * Most nodes have sync computePorts functions. For async nodes (like compose-workflow),
+ * this falls back to cached resolvedPorts from the config, or returns empty arrays.
+ *
+ * Use this in UI contexts where you can't await (e.g., React useMemo).
+ * For server-side or async contexts, use computePortsForNode instead.
+ *
+ * @param nodeType - The type of the node
+ * @param config - The node's configuration object (should include resolvedPorts for async nodes)
+ * @param getConnectedOutput - Optional function to get connected output port info (for dynamic ports)
+ */
+export declare function computePortsSync({ nodeType, config, getConnectedOutput, }: {
+    nodeType: UserCreatableNodeType;
+    config?: Record<string, unknown>;
+    getConnectedOutput?: (inputId: string) => {
+        type: BasePortType | BasePortType[];
+        isArray: boolean;
+        objectSchema?: ObjectSchemaField[];
+    } | null;
+}): {
+    inputs: NodePort[];
+    outputs: NodePort[];
+};
 /**
  * Compute ports for a node based on its type and config.
  * Uses the node definition's computePorts function.
@@ -87,6 +112,16 @@ export declare function getOutputSchema({ nodeType, nodeConfig, outputPortId, cl
     outputPortId: string;
     client?: AutomationsClient;
 }): Promise<ObjectSchemaField[] | null>;
+/**
+ * Create a new node with default config from the node definition.
+ */
+export declare function createNode({ type, id, name, x, y, }: {
+    type: UserCreatableNodeType;
+    id?: string;
+    name?: string;
+    x?: number;
+    y?: number;
+}): WorkflowNodeDefinition;
 /**
  * Derive Connection[] array from nodes for canvas rendering
  *

package/dist/graph-controller.js

@@ -13,10 +13,12 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.areTypesCompatible = areTypesCompatible;
+exports.computePortsSync = computePortsSync;
 exports.computePortsForNode = computePortsForNode;
 exports.getAllNodes = getAllNodes;
 exports.getNodeByType = getNodeByType;
 exports.getOutputSchema = getOutputSchema;
+exports.createNode = createNode;
 exports.deriveConnections = deriveConnections;
 exports.addConnection = addConnection;
 exports.removeConnection = removeConnection;
@@ -243,6 +245,41 @@ function areTypesCompatible({ sourceType, sourceIsArray, targetType, targetIsArr
 // ===========================================================================
 // Port Computation
 // ===========================================================================
+/**
+ * Compute ports for a node synchronously.
+ *
+ * Most nodes have sync computePorts functions. For async nodes (like compose-workflow),
+ * this falls back to cached resolvedPorts from the config, or returns empty arrays.
+ *
+ * Use this in UI contexts where you can't await (e.g., React useMemo).
+ * For server-side or async contexts, use computePortsForNode instead.
+ *
+ * @param nodeType - The type of the node
+ * @param config - The node's configuration object (should include resolvedPorts for async nodes)
+ * @param getConnectedOutput - Optional function to get connected output port info (for dynamic ports)
+ */
+function computePortsSync({ nodeType, config, getConnectedOutput, }) {
+    const definition = (0, nodes_1.getNodeDefinition)(nodeType);
+    if (!definition) {
+        return { inputs: [], outputs: [] };
+    }
+    const result = definition.computePorts({
+        config: config ?? definition.defaults,
+        getConnectedOutput,
+    });
+    // If the result is a Promise, fall back to cached resolvedPorts or empty arrays
+    if (result instanceof Promise) {
+        const resolvedPorts = config?.resolvedPorts;
+        if (resolvedPorts) {
+            return {
+                inputs: resolvedPorts.inputs,
+                outputs: resolvedPorts.outputs,
+            };
+        }
+        return { inputs: [], outputs: [] };
+    }
+    return result;
+}
 /**
  * Compute ports for a node based on its type and config.
  * Uses the node definition's computePorts function.
@@ -325,6 +362,24 @@ async function getOutputSchema({ nodeType, nodeConfig, outputPortId, client, })
     return null;
 }
 // ===========================================================================
+// Node Creation
+// ===========================================================================
+/**
+ * Create a new node with default config from the node definition.
+ */
+function createNode({ type, id, name, x, y, }) {
+    const definition = nodes_1.nodeDefinitions[type];
+    return {
+        id: id ?? `${type}-${Date.now()}`,
+        type,
+        name,
+        config: structuredClone(definition.defaults),
+        inputs: {},
+        x,
+        y,
+    };
+}
+// ===========================================================================
 // Connection Management
 // ===========================================================================
 /**

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, deriveConnections, addConnection, removeConnection, removeNodeConnections, cleanupStaleConnections, getForEachContext, checkCrossContextViolation, validateWorkflow, getErrorNodeIds, getPortErrorsForNode, hasMissingTriggerError, hasMissingTerminalError, getWorkflowOutputSchema, type WorkflowOutputSchemaEntry, resolveNodePreview, } from './graph-controller';
+export { areTypesCompatible, computePortsSync, computePortsForNode, getAllNodes, getNodeByType, getOutputSchema, createNode, deriveConnections, addConnection, removeConnection, removeNodeConnections, cleanupStaleConnections, getForEachContext, checkCrossContextViolation, validateWorkflow, getErrorNodeIds, getPortErrorsForNode, hasMissingTriggerError, hasMissingTerminalError, getWorkflowOutputSchema, type WorkflowOutputSchemaEntry, resolveNodePreview, } from './graph-controller';
 export { nodeDefinitions, internalNodeTypes, isAsyncExecutor, formatPortType } from './automations/types';
 export { isEditModel } from './automations/nodes/generate-image';
 export { isImageToVideoModel } from './automations/nodes/generate-video';

package/dist/index.js

@@ -5,7 +5,7 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-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.isImageToVideoModel = exports.isEditModel = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = 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.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 = exports.isImageToVideoModel = exports.isEditModel = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = 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.computePortsSync = exports.areTypesCompatible = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
 // =============================================================================
 // Client Exports
 // =============================================================================
@@ -36,11 +36,14 @@ var graph_controller_1 = require("./graph-controller");
 // Type compatibility
 Object.defineProperty(exports, "areTypesCompatible", { enumerable: true, get: function () { return graph_controller_1.areTypesCompatible; } });
 // Port computation
+Object.defineProperty(exports, "computePortsSync", { enumerable: true, get: function () { return graph_controller_1.computePortsSync; } });
 Object.defineProperty(exports, "computePortsForNode", { enumerable: true, get: function () { return graph_controller_1.computePortsForNode; } });
 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
 Object.defineProperty(exports, "getOutputSchema", { enumerable: true, get: function () { return graph_controller_1.getOutputSchema; } });
+// Node creation
+Object.defineProperty(exports, "createNode", { enumerable: true, get: function () { return graph_controller_1.createNode; } });
 // Connection management
 Object.defineProperty(exports, "deriveConnections", { enumerable: true, get: function () { return graph_controller_1.deriveConnections; } });
 Object.defineProperty(exports, "addConnection", { enumerable: true, get: function () { return graph_controller_1.addConnection; } });

package/package.json

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