ugcinc 2.99.7 → 3.0.0

package/dist/automations.js

@@ -129,7 +129,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "text",
-                    title: "text",
                     type: "text",
                     required: true,
                 },
@@ -144,8 +143,7 @@ function getAllNodes() {
             inputs: [],
             outputs: [
                 {
-                    id: "social_audio",
-                    title: "social_audio",
+                    id: "social-audio",
                     type: "social_audio",
                     required: true,
                 },
@@ -161,7 +159,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "account",
-                    title: "Account",
                     type: "account",
                     required: true,
                 },
@@ -177,7 +174,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "video",
-                    title: "video",
                     type: "video",
                     required: true,
                 },
@@ -194,7 +190,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "image",
-                    title: "image",
                     type: "image",
                     required: true,
                 },
@@ -210,7 +205,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "video",
-                    title: "video",
                     type: "video",
                     required: true,
                 },
@@ -226,7 +220,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "audio",
-                    title: "audio",
                     type: "audio",
                     required: true,
                 },
@@ -234,7 +227,7 @@ function getAllNodes() {
         },
         // === Generator nodes ===
         {
-            type: "image-editor",
+            type: "image-template",
             label: "Image Template",
             description: "Create templated images",
             category: "Generation",
@@ -242,7 +235,6 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "background",
-                    title: "background",
                     type: "image",
                     required: true,
                 },
@@ -250,14 +242,13 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    title: "output",
                     type: "image",
                     required: true,
                 },
             ],
         },
         {
-            type: "video-editor",
+            type: "video-template",
             label: "Video Template",
             description: "Create templated videos",
             category: "Generation",
@@ -266,14 +257,13 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    title: "output",
                     type: "video",
                     required: true,
                 },
             ],
         },
         {
-            type: "workflow",
+            type: "sub-agent",
             label: "Sub-Agent",
             description: "Embed other agents",
             category: "Generation",
@@ -292,7 +282,6 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "prompt",
-                    title: "Prompt",
                     type: "text",
                     required: true,
                 },
@@ -301,7 +290,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    title: "Generated Image",
                     type: "image",
                     required: true,
                 },
@@ -316,7 +304,6 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "prompt",
-                    title: "Prompt",
                     type: "text",
                     required: true,
                 },
@@ -325,7 +312,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    title: "Generated Video",
                     type: "video",
                     required: true,
                 },
@@ -343,7 +329,7 @@ function getAllNodes() {
             outputs: [],
         },
         {
-            type: "llm",
+            type: "text-generation",
             label: "Text Generation",
             description: "Generate LLM output",
             category: "AI Generation",
@@ -385,31 +371,26 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "video",
-                    title: "video",
                     type: "video",
                     required: true,
                 },
                 {
                     id: "account",
-                    title: "account",
                     type: "account",
                     required: true,
                 },
                 {
                     id: "caption",
-                    title: "caption",
                     type: "text",
                     required: false,
                 },
                 {
-                    id: "socialAudio",
-                    title: "social-audio",
+                    id: "social-audio",
                     type: "social_audio",
                     required: false,
                 },
                 {
-                    id: "postDate",
-                    title: "post-date",
+                    id: "post-date",
                     type: "date",
                     required: false,
                 },
@@ -426,25 +407,21 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "account",
-                    title: "account",
                     type: "account",
                     required: true,
                 },
                 {
                     id: "caption",
-                    title: "caption",
                     type: "text",
                     required: false,
                 },
                 {
-                    id: "socialAudio",
-                    title: "social-audio",
+                    id: "social-audio",
                     type: "social_audio",
                     required: false,
                 },
                 {
-                    id: "postDate",
-                    title: "post-date",
+                    id: "post-date",
                     type: "date",
                     required: false,
                 },
@@ -470,7 +447,6 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "result",
-                    title: "Result",
                     type: ["image", "video", "audio", "text"],
                     required: true,
                 },
@@ -487,7 +463,6 @@ function getAllNodes() {
             inputs: [
                 {
                     id: "video",
-                    title: "video",
                     type: "video",
                     required: true,
                 },
@@ -495,7 +470,6 @@ function getAllNodes() {
             outputs: [
                 {
                     id: "output",
-                    title: "output",
                     type: "video",
                     required: true,
                 },

package/dist/index.d.ts

@@ -11,8 +11,10 @@ export { StatsClient } from './stats';
 export { OrganizationClient } from './org';
 export { RenderClient } from './render';
 export { AutomationsClient, getAllNodes, getNodeByType } from './automations';
+export { portId, isValidPortId, portIdToTitle, normalizeToPortId, PortIdSchema } from './port-id';
+export type { PortId } from './port-id';
 export { MediaClient } from './media';
 export { CommentsClient } from './comments';
 export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, RenderVideoEditorConfig, } from './render';
 export type { ClientConfig, } from './base';
-export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, DimensionPresetKey, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, TriggerCollectionConfig, DayOfWeek, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, MediaNodeConfig, PostVideoNodeConfig, PostSlideshowInput, PostSlideshowNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, VideoGenerationNodeConfig, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStatus, PostStat, ApiKey, EditorConfig, VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, TimeMode, SegmentTimelinePosition, ImageEditorNodeConfig, ImageEditorElement, ImageEditorNodeInput, ImageEditorNodeOutput, DimensionPresetKey, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, GetTasksParams, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, RefreshStatsParams, RefreshStatsResponse, RefreshStatsError, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, MediaType, NodePort, NodeControlConfig, NodeTypeEnum, WorkflowNodeDefinition, WorkflowDefinition, CanvasState, TemplateNode, AutomationTemplate, AutomationRun, NodeRun, ExecutorNode, ExecutionEdge, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeOutputValues, OutputInput, OutputNodeConfig, ManualTriggerOutput, ManualTriggerNodeConfig, TriggerIterationMode, IterationExhaustionBehavior, TriggerCollectionConfig, DayOfWeek, RecurrenceNodeConfig, AccountNodeConfig, MediaNodeEnabledType, MediaNodeConfig, PostVideoNodeConfig, PostSlideshowInput, PostSlideshowNodeConfig, SaveToMediaInput, SaveToMediaNodeConfig, DeduplicateNodeConfig, VideoImportPlatform, VideoImportQuality, VideoImportNodeConfig, VideoGenerationNodeConfig, PortType, LLMOutputField, LLMNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, ImportTextParams, ImportTextResponse, Comment, CommentStatus, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './types';

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.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.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,12 @@ 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; } });
+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; } });
+Object.defineProperty(exports, "portIdToTitle", { enumerable: true, get: function () { return port_id_1.portIdToTitle; } });
+Object.defineProperty(exports, "normalizeToPortId", { enumerable: true, get: function () { return port_id_1.normalizeToPortId; } });
+Object.defineProperty(exports, "PortIdSchema", { enumerable: true, get: function () { return port_id_1.PortIdSchema; } });
 var media_1 = require("./media");
 Object.defineProperty(exports, "MediaClient", { enumerable: true, get: function () { return media_1.MediaClient; } });
 var comments_1 = require("./comments");

package/dist/port-id.d.ts

@@ -0,0 +1,29 @@
+import { z } from 'zod';
+export declare const PortIdSchema: z.ZodString;
+export type PortId = z.infer<typeof PortIdSchema>;
+/**
+ * Create a validated PortId (throws at runtime if invalid)
+ */
+export declare function portId(id: string): PortId;
+/**
+ * Validate a string as a PortId without throwing
+ */
+export declare function isValidPortId(id: string): id is PortId;
+/**
+ * Convert port ID to display title (for UI)
+ *
+ * Examples:
+ * - "social_audio" → "Social Audio"
+ * - "post-date" → "Post Date"
+ * - "output" → "Output"
+ */
+export declare function portIdToTitle(id: string): string;
+/**
+ * Normalize user input to a valid port ID
+ *
+ * Examples:
+ * - "My Input Name" → "my_input_name"
+ * - "Image 1" → "image_1"
+ * - "  Hello World  " → "hello_world"
+ */
+export declare function normalizeToPortId(input: string): PortId;

package/dist/port-id.js

@@ -0,0 +1,69 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PortIdSchema = void 0;
+exports.portId = portId;
+exports.isValidPortId = isValidPortId;
+exports.portIdToTitle = portIdToTitle;
+exports.normalizeToPortId = normalizeToPortId;
+const zod_1 = require("zod");
+/**
+ * Port ID Schema
+ *
+ * Port IDs must be:
+ * - Lowercase letters, numbers, underscores, and hyphens only
+ * - Must start with a letter
+ * - At least 1 character
+ *
+ * Examples: "output", "social_audio", "post-date", "image1"
+ */
+const PORT_ID_REGEX = /^[a-z][a-z0-9_-]*$/;
+exports.PortIdSchema = zod_1.z.string()
+    .min(1, 'Port ID must not be empty')
+    .regex(PORT_ID_REGEX, 'Port ID must be lowercase, start with a letter, and contain only letters, numbers, hyphens, or underscores');
+/**
+ * Create a validated PortId (throws at runtime if invalid)
+ */
+function portId(id) {
+    return exports.PortIdSchema.parse(id);
+}
+/**
+ * Validate a string as a PortId without throwing
+ */
+function isValidPortId(id) {
+    return exports.PortIdSchema.safeParse(id).success;
+}
+/**
+ * Convert port ID to display title (for UI)
+ *
+ * Examples:
+ * - "social_audio" → "Social Audio"
+ * - "post-date" → "Post Date"
+ * - "output" → "Output"
+ */
+function portIdToTitle(id) {
+    return id
+        .split(/[-_]/)
+        .map(word => word.charAt(0).toUpperCase() + word.slice(1))
+        .join(' ');
+}
+/**
+ * Normalize user input to a valid port ID
+ *
+ * Examples:
+ * - "My Input Name" → "my_input_name"
+ * - "Image 1" → "image_1"
+ * - "  Hello World  " → "hello_world"
+ */
+function normalizeToPortId(input) {
+    let normalized = input
+        .toLowerCase()
+        .trim()
+        .replace(/\s+/g, '_') // spaces to underscores
+        .replace(/[^a-z0-9_-]/g, '') // remove invalid chars
+        .replace(/^[^a-z]+/, ''); // ensure starts with letter
+    // Fallback if everything was stripped
+    if (!normalized) {
+        normalized = 'port';
+    }
+    return exports.PortIdSchema.parse(normalized);
+}

package/dist/types.d.ts

@@ -790,7 +790,6 @@ export interface NodeOutputValues {
 }
 export interface NodePort {
     id: string;
-    title: string;
     type: MediaType | MediaType[];
     required: boolean;
 }
@@ -825,7 +824,7 @@ export interface NodeControlConfig {
      */
     isInitializer?: boolean;
 }
-export type NodeTypeEnum = 'image' | 'video' | 'audio' | 'social-audio' | 'text' | 'media' | 'video-import' | 'image-editor' | 'video-editor' | 'image-generation' | 'video-generation' | 'custom-model' | 'llm' | 'output' | 'manual-trigger' | 'recurrence' | 'workflow' | 'account' | 'post-video' | 'post-slideshow' | 'save-to-media' | 'deduplicate';
+export type NodeTypeEnum = 'image' | 'video' | 'audio' | 'social-audio' | 'text' | 'media' | 'video-import' | 'image-template' | 'video-template' | 'image-generation' | 'video-generation' | 'custom-model' | 'text-generation' | 'output' | 'manual-trigger' | 'recurrence' | 'sub-agent' | 'account' | 'post-video' | 'post-slideshow' | 'save-to-media' | 'deduplicate';
 export interface OutputSchemaProperty {
     type: 'string' | 'number' | 'boolean' | 'array' | 'object';
     items?: 'string' | 'number' | 'boolean';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ugcinc",
-  "version": "2.99.7",
+  "version": "3.0.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -20,6 +20,9 @@
   ],
   "author": "UGC Inc",
   "license": "MIT",
+  "dependencies": {
+    "zod": "^3.23.0"
+  },
   "peerDependencies": {
     "ugcinc-render": "^1.6.1"
   },