ugcinc 3.17.0 → 3.19.0

package/dist/automations.d.ts

@@ -1,4 +1,4 @@
-import type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse, AutomationExport, AutomationRunExport } from './types';
+import type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, WorkflowDefinition, AutomationTemplate, AutomationRun, ExecutorNode, ExecutionEdge, ApiResponse, AutomationExport, AutomationRunExport, PropertySchema } from './types';
 import { BaseClient } from './base';
 export declare class AutomationsClient extends BaseClient {
     /**
@@ -135,4 +135,14 @@ export declare function getAllNodes(): NodeControlConfig[];
  * Get a specific node by type
  */
 export declare function getNodeByType(type: string): NodeControlConfig | undefined;
-export type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum };
+/**
+ * Get the schema of array items for a node's output port.
+ * Returns null if schema is unknown or the output is not an array.
+ *
+ * @param nodeType - The type of the node (e.g., 'transcript', 'text-generation')
+ * @param nodeConfig - The node's configuration object
+ * @param outputPortId - The ID of the output port to get schema for
+ * @returns The schema of array items, or null if unknown
+ */
+export declare function getOutputSchema(nodeType: string, nodeConfig: Record<string, unknown> | undefined, outputPortId: string): Record<string, PropertySchema> | null;
+export type { NodeControlConfig, NodeCategory, MediaType, NodePort, NodeTypeEnum, PropertySchema };

package/dist/automations.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.AutomationsClient = void 0;
 exports.getAllNodes = getAllNodes;
 exports.getNodeByType = getNodeByType;
+exports.getOutputSchema = getOutputSchema;
 const base_1 = require("./base");
 class AutomationsClient extends base_1.BaseClient {
     /**
@@ -526,6 +527,11 @@ function getAllNodes() {
                     id: "segments",
                     type: "object",
                     required: true,
+                    itemSchema: {
+                        text: { type: 'string' },
+                        start: { type: 'number' },
+                        end: { type: 'number' },
+                    },
                 },
             ],
         },
@@ -559,3 +565,71 @@ function getAllNodes() {
 function getNodeByType(type) {
     return getAllNodes().find(node => node.type === type);
 }
+/**
+ * Convert LLM output field type to PropertySchema type
+ */
+function llmTypeToSchemaType(type) {
+    if (type === 'string')
+        return 'string';
+    if (type === 'number')
+        return 'number';
+    if (type === 'boolean')
+        return 'boolean';
+    return 'object';
+}
+/**
+ * Convert LLM objectSchema to PropertySchema record
+ */
+function llmObjectSchemaToPropertySchema(fields) {
+    const result = {};
+    for (const field of fields) {
+        if (field.type === 'array' && field.items === 'object' && field.objectSchema) {
+            // Nested array of objects
+            result[field.name] = {
+                type: 'object',
+                itemSchema: llmObjectSchemaToPropertySchema(field.objectSchema),
+            };
+        }
+        else if (field.type === 'array' && field.items) {
+            // Array of primitives
+            result[field.name] = {
+                type: 'object', // Arrays are represented as 'object' type
+            };
+        }
+        else {
+            result[field.name] = {
+                type: llmTypeToSchemaType(field.type),
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Get the schema of array items for a node's output port.
+ * Returns null if schema is unknown or the output is not an array.
+ *
+ * @param nodeType - The type of the node (e.g., 'transcript', 'text-generation')
+ * @param nodeConfig - The node's configuration object
+ * @param outputPortId - The ID of the output port to get schema for
+ * @returns The schema of array items, or null if unknown
+ */
+function getOutputSchema(nodeType, nodeConfig, outputPortId) {
+    // First check static node definitions
+    const nodeDefinition = getNodeByType(nodeType);
+    const outputPort = nodeDefinition?.outputs.find(o => o.id === outputPortId);
+    if (outputPort?.itemSchema) {
+        return outputPort.itemSchema;
+    }
+    // For text-generation (LLM) nodes, derive from outputFields config
+    if (nodeType === 'text-generation' && nodeConfig) {
+        const llmConfig = nodeConfig.llm;
+        const outputFields = llmConfig?.outputFields;
+        if (outputFields) {
+            const field = outputFields.find(f => f.name === outputPortId);
+            if (field?.type === 'array' && field.items === 'object' && field.objectSchema) {
+                return llmObjectSchemaToPropertySchema(field.objectSchema);
+            }
+        }
+    }
+    return null;
+}

package/dist/index.d.ts

@@ -10,7 +10,8 @@ export { PostsClient } from './posts';
 export { StatsClient } from './stats';
 export { OrganizationClient } from './org';
 export { RenderClient } from './render';
-export { AutomationsClient, getAllNodes, getNodeByType } from './automations';
+export { AutomationsClient, getAllNodes, getNodeByType, getOutputSchema } from './automations';
+export type { PropertySchema } from './automations';
 export { portId, isValidPortId, portIdToTitle, normalizeToPortId, PortIdSchema } from './port-id';
 export type { PortId } from './port-id';
 export { MediaClient } from './media';

package/dist/index.js

@@ -5,7 +5,7 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentsClient = exports.MediaClient = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.getNodeByType = exports.getAllNodes = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.CommentsClient = exports.MediaClient = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.AutomationsClient = exports.RenderClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
 var client_1 = require("./client");
 Object.defineProperty(exports, "UGCClient", { enumerable: true, get: function () { return client_1.UGCClient; } });
 var accounts_1 = require("./accounts");
@@ -24,6 +24,7 @@ var automations_1 = require("./automations");
 Object.defineProperty(exports, "AutomationsClient", { enumerable: true, get: function () { return automations_1.AutomationsClient; } });
 Object.defineProperty(exports, "getAllNodes", { enumerable: true, get: function () { return automations_1.getAllNodes; } });
 Object.defineProperty(exports, "getNodeByType", { enumerable: true, get: function () { return automations_1.getNodeByType; } });
+Object.defineProperty(exports, "getOutputSchema", { enumerable: true, get: function () { return automations_1.getOutputSchema; } });
 var port_id_1 = require("./port-id");
 Object.defineProperty(exports, "portId", { enumerable: true, get: function () { return port_id_1.portId; } });
 Object.defineProperty(exports, "isValidPortId", { enumerable: true, get: function () { return port_id_1.isValidPortId; } });

package/dist/types.d.ts

@@ -788,10 +788,19 @@ export interface NodeOutputValues {
     _values: unknown[];
     _outputMode: OutputMode;
 }
+/**
+ * Schema definition for a property within an array item
+ */
+export interface PropertySchema {
+    type: 'string' | 'number' | 'boolean' | 'object';
+    itemSchema?: Record<string, PropertySchema>;
+}
 export interface NodePort {
     id: string;
     type: PortType | PortType[];
     required: boolean;
+    /** Schema of array items (when this port outputs an array) */
+    itemSchema?: Record<string, PropertySchema>;
 }
 /**
  * Functional category for automation nodes
@@ -1006,35 +1015,29 @@ export interface ManualTriggerNodeConfig {
 export type DayOfWeek = 'monday' | 'tuesday' | 'wednesday' | 'thursday' | 'friday' | 'saturday' | 'sunday';
 /**
  * Recurrence media output port definition
- * Each output is a named port with a specific media type
+ * Each output is a named port with a specific media type and its own selection config
  */
 export interface RecurrenceMediaOutput {
     /** Unique ID for this output port (e.g., "background-image", "overlay") */
     id: string;
     /** Media type for this port */
     type: 'image' | 'video' | 'audio' | 'text' | 'social_audio';
+    /** Selection mode for this output's media source */
+    selectionMode: 'specific' | 'by-tag';
+    /** Media IDs for this output (used when selectionMode is 'specific') */
+    selectedMediaIds?: string[];
+    /** Tag to query media by at runtime (used when selectionMode is 'by-tag') */
+    mediaTag?: string;
 }
 /**
  * Media input configuration for recurrence nodes
- * Allows selecting media by specific IDs or by tag (queried at runtime)
+ * Each output has its own selection configuration
  */
 export interface RecurrenceMediaConfig {
     /** Whether media input is enabled */
     enabled: boolean;
-    /** Named output ports - each gets a random item from the pool */
+    /** Named output ports - each has its own selection config */
     outputs: RecurrenceMediaOutput[];
-    /** Selection mode: 'specific' uses selectedMediaIds, 'by-tag' queries at runtime */
-    selectionMode: CollectionSelectionMode;
-    /** Media IDs per type (used when selectionMode is 'specific') */
-    selectedMediaIds?: {
-        image?: string[];
-        video?: string[];
-        audio?: string[];
-        text?: string[];
-        social_audio?: string[];
-    };
-    /** Tag to query media by at runtime (used when selectionMode is 'by-tag') */
-    mediaTag?: string;
 }
 /**
  * Recurrence node configuration - defines when the automation runs on a schedule

package/package.json

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