ugcinc 4.0.2 → 4.1.1

package/dist/automations.js

@@ -1,50 +1,13 @@
 "use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AutomationsClient = void 0;
-exports.areTypesCompatible = areTypesCompatible;
-exports.getAllNodes = getAllNodes;
-exports.getNodeByType = getNodeByType;
-exports.getOutputSchema = getOutputSchema;
-const types_1 = require("./types");
-const base_1 = require("./base");
-/**
- * Helper to check if a PortType or array of PortTypes is an array
- * Used internally to normalize port types for comparison
- */
-function isPortTypeArray(pt) {
-    return Array.isArray(pt) && pt.length > 0 && typeof pt[0] === 'object' && 'type' in pt[0];
-}
 /**
- * Check if two port types are compatible for connection
- * A connection is valid if:
- * 1. The types match exactly (same base type and same isArray), OR
- * 2. The source is an array type and target is 'object' (non-array), OR
- * 3. The source is a PortType[] and includes a compatible type, OR
- * 4. The target is a PortType[] and includes a compatible type, OR
- * 5. Both are PortType[] and have at least one common compatible type
+ * Automations API Client
  *
- * Note: Array inputs are strict - they only accept exact matches
+ * Provides methods to interact with the UGC Inc Automations API.
+ * For graph logic (validation, port computation, connections), use graph-controller.ts
  */
-function areTypesCompatible({ sourceType, targetType, }) {
-    const sourceTypes = isPortTypeArray(sourceType) ? sourceType : [sourceType];
-    const targetTypes = isPortTypeArray(targetType) ? targetType : [targetType];
-    return sourceTypes.some(st => {
-        return targetTypes.some(tt => {
-            // Exact match (same base type and same isArray)
-            if (st.type === tt.type && st.isArray === tt.isArray)
-                return true;
-            // Object inputs (non-array) accept any array type (backwards compatibility with for-each, etc.)
-            if (tt.type === 'object' && !tt.isArray && st.isArray) {
-                return true;
-            }
-            // Array inputs are strict - no other compatibility
-            if (tt.isArray) {
-                return false;
-            }
-            return false;
-        });
-    });
-}
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutomationsClient = void 0;
+const base_1 = require("./base");
 class AutomationsClient extends base_1.BaseClient {
     /**
      * List all automation templates for an organization
@@ -229,607 +192,3 @@ class AutomationsClient extends base_1.BaseClient {
     }
 }
 exports.AutomationsClient = AutomationsClient;
-/**
- * Get all available automation nodes
- */
-function getAllNodes() {
-    return [
-        // === Trigger nodes ===
-        {
-            type: "recurrence",
-            label: "Recurring",
-            description: "Run continuously",
-            category: "Triggers",
-            nodeCategory: "trigger",
-            inputs: [],
-            outputs: [],
-            isInitializer: true,
-        },
-        {
-            type: "manual-trigger",
-            label: "Manual Trigger",
-            description: "Trigger manually",
-            category: "Triggers",
-            nodeCategory: "trigger",
-            inputs: [],
-            // Dynamic outputs based on manualTriggerConfig.outputs
-            outputs: [],
-            isInitializer: true,
-        },
-        // === Source nodes ===
-        {
-            type: "media",
-            label: "Media",
-            description: "Use saved media",
-            category: "Sources",
-            nodeCategory: "source",
-            inputs: [],
-            outputs: [], // Dynamic based on enabledTypes config
-        },
-        {
-            type: "video-import",
-            label: "Import Video",
-            description: "Import videos from YouTube, TikTok, Instagram & more",
-            category: "Sources",
-            nodeCategory: "source",
-            inputs: [
-                {
-                    id: "url",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "video",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "account",
-            label: "Account",
-            description: "Select accounts to post from",
-            category: "Sources",
-            nodeCategory: "source",
-            inputs: [],
-            outputs: [
-                {
-                    id: "account",
-                    type: (0, types_1.portType)({ type: 'account', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "text",
-            label: "Text",
-            description: "Use text collections",
-            category: "Sources",
-            nodeCategory: "source",
-            inputs: [], // Dynamic inputs based on template variables
-            outputs: [
-                {
-                    id: "text",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        // === Generator nodes ===
-        {
-            type: "image-composer",
-            label: "Image Composer",
-            description: "Create templated images",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "background",
-                    type: (0, types_1.portType)({ type: 'image', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'image', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "video-composer",
-            label: "Video Composer",
-            description: "Create templated videos",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [], // Dynamic inputs based on segments in editor config
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "compose-workflow",
-            label: "Compose Workflow",
-            description: "Embed other workflows",
-            category: "Generation",
-            nodeCategory: "generator",
-            // Inputs and outputs are dynamic based on the embedded workflow
-            inputs: [],
-            outputs: [],
-        },
-        {
-            type: "transcript",
-            label: "Transcribe",
-            description: "Transcribe video or audio with timestamps",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "media",
-                    type: [(0, types_1.portType)({ type: 'video', isArray: false }), (0, types_1.portType)({ type: 'audio', isArray: false })],
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "text",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-                {
-                    id: "segments",
-                    type: (0, types_1.portType)({ type: 'object', isArray: false }),
-                    required: true,
-                    itemSchema: {
-                        text: { type: 'string' },
-                        start: { type: 'number' },
-                        end: { type: 'number' },
-                    },
-                },
-            ],
-        },
-        {
-            type: "auto-caption",
-            label: "Auto Caption",
-            description: "Add TikTok-style captions to videos",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "video",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "screenshot-animation",
-            label: "Animate Screenshot",
-            description: "Create an iPhone screenshot animation from an image",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "image",
-                    type: (0, types_1.portType)({ type: 'image', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "create-dm",
-            label: "Create DM",
-            description: "Create fake DM screenshots for iMessage or Instagram",
-            category: "Generation",
-            nodeCategory: "generator",
-            // Dynamic inputs based on createDmConfig:
-            // - profilePic (image, if profilePicIsVariable)
-            // - messages (object, if messagesSource === 'input')
-            // - imageAttachment (image, if imageAttachmentIsVariable)
-            inputs: [],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'image', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "deduplicate",
-            label: "Mass Repost",
-            description: "Make videos unique for safe reposting",
-            category: "Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "video",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        // === AI nodes ===
-        {
-            type: "llm",
-            label: "LLM",
-            description: "Generate LLM output",
-            category: "AI Generation",
-            nodeCategory: "generator",
-            // Dynamic inputs: extracted from systemPrompt {{variables}} + media refs
-            inputs: [],
-            // Dynamic outputs: based on outputFields config
-            outputs: [],
-        },
-        {
-            type: "generate-video",
-            label: "Generate Video",
-            description: "Generate videos with AI",
-            category: "AI Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "prompt",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-                // Image input is dynamically added for image-to-video models
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'video', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "generate-image",
-            label: "Generate Image",
-            description: "Generate images with AI",
-            category: "AI Generation",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "prompt",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-                // Image input is dynamically added for edit models
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'image', isArray: false }),
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "custom-model",
-            label: "Custom Model",
-            description: "Call any fal.ai model",
-            category: "AI Generation",
-            nodeCategory: "generator",
-            // Dynamic inputs based on selected model's schema
-            inputs: [],
-            // Dynamic output based on model's output type
-            outputs: [],
-        },
-        // === Control Flow ===
-        {
-            type: "for-each",
-            label: "For Each",
-            description: "Iterate over an array, executing downstream nodes for each item",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "array",
-                    type: [(0, types_1.portType)({ type: 'image', isArray: true }), (0, types_1.portType)({ type: 'video', isArray: true }), (0, types_1.portType)({ type: 'audio', isArray: true }), (0, types_1.portType)({ type: 'text', isArray: true }), (0, types_1.portType)({ type: 'object', isArray: true })],
-                    required: true,
-                },
-            ],
-            // Dynamic outputs based on forEachConfig (exposeItem, exposeIndex, outputProperties, inputPorts)
-            outputs: [],
-        },
-        {
-            type: "random",
-            label: "Random Select",
-            description: "Randomly select from an array or weighted inputs",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Dynamic inputs based on randomConfig.mode:
-            // - array mode: single 'array' input
-            // - multi-input mode: dynamic inputs from randomConfig.inputPorts
-            inputs: [],
-            // Dynamic outputs based on randomConfig:
-            // - output (type determined by randomConfig.valueType)
-            // - index (if randomConfig.exposeIndex is true, array mode only)
-            outputs: [],
-        },
-        {
-            type: "if",
-            label: "If",
-            description: "Conditional branching based on boolean logic",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Dynamic inputs based on ifConfig:
-            // - Boolean inputs from ifConfig.booleanInputs (type: boolean)
-            // - Passthrough inputs from ifConfig.passthroughInputs (various types)
-            inputs: [],
-            // Dynamic outputs: for each passthrough input, creates:
-            // - true-{id} (same type as input, receives value when condition is true)
-            // - false-{id} (same type as input, receives value when condition is false)
-            outputs: [],
-        },
-        {
-            type: "not",
-            label: "Not",
-            description: "Invert a boolean value",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            inputs: [
-                {
-                    id: "input",
-                    type: (0, types_1.portType)({ type: 'boolean', isArray: false }),
-                    required: true,
-                },
-            ],
-            outputs: [
-                {
-                    id: "output",
-                    type: (0, types_1.portType)({ type: 'boolean', isArray: false }),
-                    required: false,
-                },
-            ],
-        },
-        {
-            type: "random-route",
-            label: "Random Branch",
-            description: "Route inputs to a randomly selected branch",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Dynamic inputs based on randomRouteConfig.passthroughInputs (various types)
-            inputs: [],
-            // Dynamic outputs: for each passthrough input and branch, creates:
-            // - {branch-id}-{passthrough-id} (same type as input)
-            outputs: [],
-        },
-        {
-            type: "branch",
-            label: "Branch",
-            description: "Route inputs based on a key match",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Static input: key (text) to match against branch keys
-            // Dynamic inputs based on branchConfig.passthroughInputs where isVariable is true
-            inputs: [
-                {
-                    id: "key",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: true,
-                },
-            ],
-            // Dynamic outputs: for each passthrough input and branch, creates:
-            // - {branch-key}-{passthrough-id} (same type as input)
-            outputs: [],
-        },
-        {
-            type: "collect",
-            label: "Collect",
-            description: "Collect outputs from a for-each loop into an array",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Input accepts any type from inside the loop
-            inputs: [
-                {
-                    id: "value",
-                    type: [(0, types_1.portType)({ type: 'image', isArray: false }), (0, types_1.portType)({ type: 'video', isArray: false }), (0, types_1.portType)({ type: 'audio', isArray: false }), (0, types_1.portType)({ type: 'text', isArray: false }), (0, types_1.portType)({ type: 'object', isArray: false }), (0, types_1.portType)({ type: 'boolean', isArray: false }), (0, types_1.portType)({ type: 'number', isArray: false })],
-                    required: true,
-                },
-            ],
-            // Output is an array of the input type
-            outputs: [
-                {
-                    id: "array",
-                    type: [(0, types_1.portType)({ type: 'image', isArray: true }), (0, types_1.portType)({ type: 'video', isArray: true }), (0, types_1.portType)({ type: 'audio', isArray: true }), (0, types_1.portType)({ type: 'text', isArray: true }), (0, types_1.portType)({ type: 'object', isArray: true })],
-                    required: true,
-                },
-            ],
-        },
-        {
-            type: "destructure",
-            label: "Destructure",
-            description: "Extract specific elements from an array by index or range",
-            category: "Control Flow",
-            nodeCategory: "generator",
-            // Input is any array type
-            inputs: [
-                {
-                    id: "array",
-                    type: [(0, types_1.portType)({ type: 'image', isArray: true }), (0, types_1.portType)({ type: 'video', isArray: true }), (0, types_1.portType)({ type: 'audio', isArray: true }), (0, types_1.portType)({ type: 'text', isArray: true }), (0, types_1.portType)({ type: 'object', isArray: true })],
-                    required: true,
-                },
-            ],
-            // Dynamic outputs based on config.selections
-            outputs: [],
-        },
-        // === Terminal nodes ===
-        {
-            type: "auto-post",
-            label: "Auto Post",
-            description: "Publish a video or slideshow",
-            category: "Output",
-            nodeCategory: "terminal",
-            // Dynamic inputs based on autoPostConfig.mode:
-            // - video mode: video (required), account, caption, social-audio
-            // - slideshow mode: dynamic image inputs from config, account, caption, social-audio
-            inputs: [
-                {
-                    id: "account",
-                    type: (0, types_1.portType)({ type: 'account', isArray: false }),
-                    required: true,
-                },
-                {
-                    id: "caption",
-                    type: (0, types_1.portType)({ type: 'text', isArray: false }),
-                    required: false,
-                },
-                {
-                    id: "social-audio",
-                    type: (0, types_1.portType)({ type: 'social_audio', isArray: false }),
-                    required: false,
-                },
-            ],
-            outputs: [],
-        },
-        {
-            type: "save-to-media",
-            label: "Save To Media",
-            description: "Save outputs to media library",
-            category: "Output",
-            nodeCategory: "terminal",
-            // Dynamic inputs based on config
-            inputs: [],
-            outputs: [],
-        },
-        {
-            type: "output",
-            label: "Pass-Through",
-            description: "Pass data to parent workflow",
-            category: "Output",
-            nodeCategory: "terminal",
-            inputs: [
-                {
-                    id: "result",
-                    type: [(0, types_1.portType)({ type: 'image', isArray: false }), (0, types_1.portType)({ type: 'video', isArray: false }), (0, types_1.portType)({ type: 'audio', isArray: false }), (0, types_1.portType)({ type: 'text', isArray: false }), (0, types_1.portType)({ type: 'social_audio', isArray: false }), (0, types_1.portType)({ type: 'account', isArray: false }), (0, types_1.portType)({ type: 'boolean', isArray: false }), (0, types_1.portType)({ type: 'object', isArray: false })],
-                    required: true,
-                },
-            ],
-            outputs: [],
-        },
-    ];
-}
-/**
- * Get a specific node by type
- */
-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 === 'object' && field.objectSchema) {
-            // Top-level object with nested schema
-            result[field.name] = {
-                type: 'object',
-                itemSchema: llmObjectSchemaToPropertySchema(field.objectSchema),
-            };
-        }
-        else 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', 'llm')
- * @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;
-    }
-    // Check resolvedPorts for nodes with dynamic outputs (compose-workflow, for-each, etc.)
-    if (nodeConfig?.resolvedPorts) {
-        const resolvedPorts = nodeConfig.resolvedPorts;
-        const resolvedOutput = resolvedPorts.outputs?.find(o => o.id === outputPortId);
-        if (resolvedOutput?.itemSchema) {
-            return resolvedOutput.itemSchema;
-        }
-    }
-    // For LLM nodes, derive from outputFields config
-    if (nodeType === 'llm' && nodeConfig) {
-        const llmConfig = nodeConfig.llm;
-        const outputFields = llmConfig?.outputFields;
-        if (outputFields) {
-            const field = outputFields.find(f => f.name === outputPortId);
-            // Handle top-level object type
-            if (field?.type === 'object' && field.objectSchema) {
-                return llmObjectSchemaToPropertySchema(field.objectSchema);
-            }
-            // Handle array of objects
-            if (field?.type === 'array' && field.items === 'object' && field.objectSchema) {
-                return llmObjectSchemaToPropertySchema(field.objectSchema);
-            }
-        }
-    }
-    return null;
-}

package/dist/comments.d.ts

@@ -1,5 +1,30 @@
 import { BaseClient } from './base';
-import type { CreateCommentParams, CreateCommentResponse, GetCommentsParams, Comment, ApiResponse } from './types';
+import type { ApiResponse } from './types';
+export type CommentStatus = 'scheduled' | 'pending' | 'verifying' | 'completed' | 'failed';
+export interface Comment {
+    id: string;
+    accountId: string;
+    postUrl: string;
+    commentText: string;
+    status: CommentStatus;
+    commentUrl?: string | null;
+    error?: string | null;
+    createdAt?: string;
+    completedAt?: string | null;
+}
+export interface CreateCommentParams {
+    accountId: string;
+    postUrl: string;
+    commentText: string;
+}
+export interface CreateCommentResponse {
+    commentId: string;
+}
+export interface GetCommentsParams {
+    commentIds?: string[];
+    accountIds?: string[];
+    tag?: string;
+}
 /**
  * Client for managing comments
  */