ugcinc 4.1.25 → 4.1.27

package/dist/automations/nodes/deduplicate.d.ts

@@ -1,6 +1,6 @@
-import type { DeduplicationLevel } from '../../render/types';
+import type { DeduplicationInput } from '../../render/types';
 declare const definition: import("./types").NodeDefinition<"generator", {
-    deduplication: DeduplicationLevel;
+    deduplication: DeduplicationInput;
     outputMode: "per-input";
     selectionMode: null;
 }, false>;

package/dist/automations/nodes/generate-image.d.ts

@@ -1,6 +1,19 @@
 type ImageGenerationTextModel = 'fal-ai/gemini-3-pro-image-preview' | 'fal-ai/nano-banana-pro' | 'fal-ai/nano-banana' | 'fal-ai/gpt-image-1/text-to-image';
 type ImageGenerationEditModel = 'fal-ai/gemini-3-pro-image-preview/edit' | 'fal-ai/nano-banana-pro/edit' | 'fal-ai/nano-banana/edit' | 'fal-ai/gpt-image-1/edit-image';
 type ImageGenerationModel = ImageGenerationTextModel | ImageGenerationEditModel;
+type ImageModelProvider = 'google' | 'nano-banana' | 'openai';
+interface ImageModelOption {
+    id: ImageGenerationModel;
+    name: string;
+    provider: ImageModelProvider;
+    isEditModel: boolean;
+}
+interface AspectRatioOption {
+    id: string;
+    name: string;
+}
+declare const ALL_IMAGE_MODELS: ImageModelOption[];
+declare const IMAGE_ASPECT_RATIOS: AspectRatioOption[];
 declare function isEditModel(model: ImageGenerationModel): model is ImageGenerationEditModel;
 declare const definition: import("./types").NodeDefinition<"generator", {
     model: ImageGenerationModel;
@@ -11,6 +24,6 @@ declare const definition: import("./types").NodeDefinition<"generator", {
     selectionMode: null;
 }, false>;
 export default definition;
-export { isEditModel };
-export type { ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel };
+export { isEditModel, ALL_IMAGE_MODELS, IMAGE_ASPECT_RATIOS };
+export type { ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, ImageModelProvider, ImageModelOption, AspectRatioOption };
 export type GenerateImageNodeConfig = typeof definition.defaults;

package/dist/automations/nodes/generate-image.js

@@ -1,7 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = void 0;
 exports.isEditModel = isEditModel;
 const types_1 = require("./types");
+const ALL_IMAGE_MODELS = [
+    // Google Gemini
+    { id: 'fal-ai/gemini-3-pro-image-preview', name: 'Gemini 3 Pro', provider: 'google', isEditModel: false },
+    { id: 'fal-ai/gemini-3-pro-image-preview/edit', name: 'Gemini 3 Pro Edit', provider: 'google', isEditModel: true },
+    // Nano Banana Pro
+    { id: 'fal-ai/nano-banana-pro', name: 'Nano Banana Pro', provider: 'nano-banana', isEditModel: false },
+    { id: 'fal-ai/nano-banana-pro/edit', name: 'Nano Banana Pro Edit', provider: 'nano-banana', isEditModel: true },
+    // Nano Banana
+    { id: 'fal-ai/nano-banana', name: 'Nano Banana', provider: 'nano-banana', isEditModel: false },
+    { id: 'fal-ai/nano-banana/edit', name: 'Nano Banana Edit', provider: 'nano-banana', isEditModel: true },
+    // OpenAI GPT Image
+    { id: 'fal-ai/gpt-image-1/text-to-image', name: 'GPT Image 1', provider: 'openai', isEditModel: false },
+    { id: 'fal-ai/gpt-image-1/edit-image', name: 'GPT Image 1 Edit', provider: 'openai', isEditModel: true },
+];
+exports.ALL_IMAGE_MODELS = ALL_IMAGE_MODELS;
+const IMAGE_ASPECT_RATIOS = [
+    { id: '1:1', name: '1:1 (Square)' },
+    { id: '16:9', name: '16:9 (Landscape)' },
+    { id: '9:16', name: '9:16 (Portrait)' },
+    { id: '4:3', name: '4:3' },
+    { id: '3:4', name: '3:4' },
+    { id: '21:9', name: '21:9 (Ultrawide)' },
+    { id: '3:2', name: '3:2' },
+    { id: '2:3', name: '2:3' },
+];
+exports.IMAGE_ASPECT_RATIOS = IMAGE_ASPECT_RATIOS;
 function isEditModel(model) {
     return model.includes('/edit') || model.includes('/edit-image');
 }

package/dist/automations/nodes/generate-video.d.ts

@@ -1,7 +1,29 @@
-type VideoGenerationTextToVideoModel = 'fal-ai/veo3.1' | 'fal-ai/veo3' | 'fal-ai/veo3/fast' | 'fal-ai/kling-video/v2.6/pro/text-to-video' | 'fal-ai/kling-video/v2.5/pro/text-to-video' | 'fal-ai/luma-dream-machine/ray-2' | 'fal-ai/luma-dream-machine/ray-2-flash' | 'fal-ai/minimax/hailuo-2.3/pro/text-to-video' | 'wan/v2.6/text-to-video' | 'fal-ai/sora-2/text-to-video';
-type VideoGenerationImageToVideoModel = 'fal-ai/veo3.1/image-to-video' | 'fal-ai/veo3/image-to-video' | 'fal-ai/kling-video/v2.6/pro/image-to-video' | 'fal-ai/kling-video/v2.5/pro/image-to-video' | 'fal-ai/luma-dream-machine/ray-2/image-to-video' | 'fal-ai/luma-dream-machine/ray-2-flash/image-to-video' | 'fal-ai/minimax/hailuo-2.3/pro/image-to-video' | 'wan/v2.6/image-to-video' | 'fal-ai/sora-2/image-to-video/pro';
+type VideoGenerationTextToVideoModel = 'fal-ai/veo3.1' | 'fal-ai/veo3' | 'fal-ai/veo3/fast' | 'fal-ai/kling-video/v2.6/pro/text-to-video' | 'fal-ai/kling-video/v2.5/pro/text-to-video' | 'fal-ai/minimax/hailuo-2.3/pro/text-to-video' | 'wan/v2.6/text-to-video' | 'fal-ai/sora-2/text-to-video';
+type VideoGenerationImageToVideoModel = 'fal-ai/veo3.1/image-to-video' | 'fal-ai/veo3/image-to-video' | 'fal-ai/kling-video/v2.6/pro/image-to-video' | 'fal-ai/kling-video/v2.5/pro/image-to-video' | 'fal-ai/minimax/hailuo-2.3/pro/image-to-video' | 'wan/v2.6/image-to-video' | 'fal-ai/sora-2/image-to-video/pro';
 type VideoGenerationModel = VideoGenerationTextToVideoModel | VideoGenerationImageToVideoModel;
+type VideoModelProvider = 'google' | 'kling' | 'minimax' | 'wan' | 'openai';
+type VideoModelTier = 'premium' | 'standard' | 'fast';
+interface VideoAspectRatioOption {
+    id: string;
+    name: string;
+}
+interface VideoDurationOption {
+    id: number;
+    name: string;
+}
+interface VideoModelOption {
+    id: VideoGenerationModel;
+    name: string;
+    provider: VideoModelProvider;
+    isImageToVideo: boolean;
+    tier: VideoModelTier;
+    aspectRatios: VideoAspectRatioOption[];
+    durations: VideoDurationOption[];
+}
+declare const ALL_VIDEO_MODELS: VideoModelOption[];
 declare function isImageToVideoModel(model: VideoGenerationModel): model is VideoGenerationImageToVideoModel;
+declare function getModelAspectRatios(modelId: string): VideoAspectRatioOption[];
+declare function getModelDurations(modelId: string): VideoDurationOption[];
 declare const definition: import("./types").NodeDefinition<"generator", {
     model: VideoGenerationModel;
     aspectRatio: string;
@@ -11,6 +33,6 @@ declare const definition: import("./types").NodeDefinition<"generator", {
     selectionMode: null;
 }, false>;
 export default definition;
-export { isImageToVideoModel };
-export type { VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel };
+export { isImageToVideoModel, ALL_VIDEO_MODELS, getModelAspectRatios, getModelDurations };
+export type { VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, VideoModelProvider, VideoModelTier, VideoAspectRatioOption, VideoDurationOption, VideoModelOption, };
 export type GenerateVideoNodeConfig = typeof definition.defaults;

package/dist/automations/nodes/generate-video.js

@@ -1,10 +1,67 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_VIDEO_MODELS = void 0;
 exports.isImageToVideoModel = isImageToVideoModel;
+exports.getModelAspectRatios = getModelAspectRatios;
+exports.getModelDurations = getModelDurations;
 const types_1 = require("./types");
+// Common aspect ratio options
+const LANDSCAPE_PORTRAIT_SQUARE = [
+    { id: '16:9', name: '16:9 (Landscape)' },
+    { id: '9:16', name: '9:16 (Portrait)' },
+    { id: '1:1', name: '1:1 (Square)' },
+];
+const LANDSCAPE_PORTRAIT = [
+    { id: '16:9', name: '16:9 (Landscape)' },
+    { id: '9:16', name: '9:16 (Portrait)' },
+];
+// Common duration options
+const DURATIONS_5_10 = [
+    { id: 5, name: '5 seconds' },
+    { id: 10, name: '10 seconds' },
+];
+const DURATIONS_5 = [
+    { id: 5, name: '5 seconds' },
+];
+const DURATIONS_8 = [
+    { id: 8, name: '8 seconds' },
+];
+const ALL_VIDEO_MODELS = [
+    // Google Veo 3.1
+    { id: 'fal-ai/veo3.1', name: 'Veo 3.1', provider: 'google', isImageToVideo: false, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_8 },
+    { id: 'fal-ai/veo3.1/image-to-video', name: 'Veo 3.1 Image', provider: 'google', isImageToVideo: true, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_8 },
+    // Google Veo 3
+    { id: 'fal-ai/veo3', name: 'Veo 3', provider: 'google', isImageToVideo: false, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_8 },
+    { id: 'fal-ai/veo3/fast', name: 'Veo 3 Fast', provider: 'google', isImageToVideo: false, tier: 'fast', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_8 },
+    { id: 'fal-ai/veo3/image-to-video', name: 'Veo 3 Image', provider: 'google', isImageToVideo: true, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_8 },
+    // Kling 2.6
+    { id: 'fal-ai/kling-video/v2.6/pro/text-to-video', name: 'Kling 2.6 Pro', provider: 'kling', isImageToVideo: false, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+    { id: 'fal-ai/kling-video/v2.6/pro/image-to-video', name: 'Kling 2.6 Pro Image', provider: 'kling', isImageToVideo: true, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+    // Kling 2.5
+    { id: 'fal-ai/kling-video/v2.5/pro/text-to-video', name: 'Kling 2.5 Pro', provider: 'kling', isImageToVideo: false, tier: 'standard', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+    { id: 'fal-ai/kling-video/v2.5/pro/image-to-video', name: 'Kling 2.5 Pro Image', provider: 'kling', isImageToVideo: true, tier: 'standard', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+    // MiniMax Hailuo
+    { id: 'fal-ai/minimax/hailuo-2.3/pro/text-to-video', name: 'Hailuo 2.3 Pro', provider: 'minimax', isImageToVideo: false, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT, durations: DURATIONS_5 },
+    { id: 'fal-ai/minimax/hailuo-2.3/pro/image-to-video', name: 'Hailuo 2.3 Pro Image', provider: 'minimax', isImageToVideo: true, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT, durations: DURATIONS_5 },
+    // Wan 2.6
+    { id: 'wan/v2.6/text-to-video', name: 'Wan 2.6', provider: 'wan', isImageToVideo: false, tier: 'standard', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5 },
+    { id: 'wan/v2.6/image-to-video', name: 'Wan 2.6 Image', provider: 'wan', isImageToVideo: true, tier: 'standard', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5 },
+    // Sora
+    { id: 'fal-ai/sora-2/text-to-video', name: 'Sora 2', provider: 'openai', isImageToVideo: false, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+    { id: 'fal-ai/sora-2/image-to-video/pro', name: 'Sora 2 Pro Image', provider: 'openai', isImageToVideo: true, tier: 'premium', aspectRatios: LANDSCAPE_PORTRAIT_SQUARE, durations: DURATIONS_5_10 },
+];
+exports.ALL_VIDEO_MODELS = ALL_VIDEO_MODELS;
 function isImageToVideoModel(model) {
     return model.includes('/image-to-video');
 }
+function getModelAspectRatios(modelId) {
+    const model = ALL_VIDEO_MODELS.find(m => m.id === modelId);
+    return model?.aspectRatios ?? LANDSCAPE_PORTRAIT_SQUARE;
+}
+function getModelDurations(modelId) {
+    const model = ALL_VIDEO_MODELS.find(m => m.id === modelId);
+    return model?.durations ?? DURATIONS_5_10;
+}
 const definition = (0, types_1.defineNode)({
     nodeId: 'generate-video',
     label: 'Generate Video',

package/dist/automations/nodes/index.d.ts

@@ -103,7 +103,7 @@ export declare const nodeDefinitions: {
         selectionMode: null;
     }, false>;
     readonly deduplicate: NodeDefinition<"generator", {
-        deduplication: import("../..").DeduplicationLevel;
+        deduplication: import("../..").DeduplicationInput;
         outputMode: "per-input";
         selectionMode: null;
     }, false>;

package/dist/index.d.ts

@@ -15,8 +15,8 @@ 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, } 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';
+export { isEditModel, ALL_IMAGE_MODELS, IMAGE_ASPECT_RATIOS } from './automations/nodes/generate-image';
+export { isImageToVideoModel, ALL_VIDEO_MODELS, getModelAspectRatios, getModelDurations } from './automations/nodes/generate-video';
 export { selectFromPool } from './automations/selection';
 export { portId, isValidPortId, portIdToTitle, normalizeToPortId, PortIdSchema } from './port-id';
 export type { PortId } from './port-id';
@@ -46,8 +46,8 @@ export type { DeduplicateNodeConfig } from './automations/nodes/deduplicate';
 export type { DestructureNodeConfig, DestructureSelection, IndexExpression, } from './automations/nodes/destructure';
 export { indexExpressionToIndexes } from './automations/nodes/destructure';
 export type { ForEachNodeConfig, ForEachOutputProperty, ForEachInputPort, } from './automations/nodes/for-each';
-export type { GenerateImageNodeConfig, ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, } from './automations/nodes/generate-image';
-export type { GenerateVideoNodeConfig, VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, } from './automations/nodes/generate-video';
+export type { GenerateImageNodeConfig, ImageGenerationTextModel, ImageGenerationEditModel, ImageGenerationModel, ImageModelProvider, ImageModelOption, AspectRatioOption, } from './automations/nodes/generate-image';
+export type { GenerateVideoNodeConfig, VideoGenerationTextToVideoModel, VideoGenerationImageToVideoModel, VideoGenerationModel, VideoModelProvider, VideoModelTier, VideoAspectRatioOption, VideoDurationOption, VideoModelOption, } from './automations/nodes/generate-video';
 export type { IfNodeConfig, IfLogicOperator, IfBooleanInput, IfPassthroughInput, } from './automations/nodes/if';
 export { IfLogicOperators } from './automations/nodes/if';
 export type { LLMNodeConfig, LLMProvider, LLMApiKeys, } from './automations/nodes/llm';

package/dist/index.js

@@ -5,7 +5,8 @@
  * 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.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.indexExpressionToIndexes = exports.prepareImageComposerInput = exports.extractTemplateVariables = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = exports.getModelDurations = exports.getModelAspectRatios = exports.ALL_VIDEO_MODELS = exports.isImageToVideoModel = exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = 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.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 = void 0;
 // =============================================================================
 // Client Exports
 // =============================================================================
@@ -72,8 +73,13 @@ Object.defineProperty(exports, "isAsyncExecutor", { enumerable: true, get: funct
 Object.defineProperty(exports, "formatPortType", { enumerable: true, get: function () { return types_1.formatPortType; } });
 var generate_image_1 = require("./automations/nodes/generate-image");
 Object.defineProperty(exports, "isEditModel", { enumerable: true, get: function () { return generate_image_1.isEditModel; } });
+Object.defineProperty(exports, "ALL_IMAGE_MODELS", { enumerable: true, get: function () { return generate_image_1.ALL_IMAGE_MODELS; } });
+Object.defineProperty(exports, "IMAGE_ASPECT_RATIOS", { enumerable: true, get: function () { return generate_image_1.IMAGE_ASPECT_RATIOS; } });
 var generate_video_1 = require("./automations/nodes/generate-video");
 Object.defineProperty(exports, "isImageToVideoModel", { enumerable: true, get: function () { return generate_video_1.isImageToVideoModel; } });
+Object.defineProperty(exports, "ALL_VIDEO_MODELS", { enumerable: true, get: function () { return generate_video_1.ALL_VIDEO_MODELS; } });
+Object.defineProperty(exports, "getModelAspectRatios", { enumerable: true, get: function () { return generate_video_1.getModelAspectRatios; } });
+Object.defineProperty(exports, "getModelDurations", { enumerable: true, get: function () { return generate_video_1.getModelDurations; } });
 var selection_1 = require("./automations/selection");
 Object.defineProperty(exports, "selectFromPool", { enumerable: true, get: function () { return selection_1.selectFromPool; } });
 var port_id_1 = require("./port-id");

package/package.json

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