ugcinc 2.48.0 → 2.50.0

package/dist/automations.d.ts

@@ -75,6 +75,14 @@ export declare class AutomationsClient extends BaseClient {
         valid: boolean;
         errors: string[];
     }>>;
+    /**
+     * Submit a client-rendered image for a node awaiting client render
+     * This is called by the webapp when the browser finishes rendering an image editor node
+     */
+    submitClientRender(params: {
+        nodeRunId: string;
+        imageUrl: string;
+    }): Promise<ApiResponse<null>>;
 }
 /**
  * Get all available automation nodes

package/dist/automations.js

@@ -82,6 +82,16 @@ class AutomationsClient extends base_1.BaseClient {
             body: JSON.stringify(params),
         });
     }
+    /**
+     * Submit a client-rendered image for a node awaiting client render
+     * This is called by the webapp when the browser finishes rendering an image editor node
+     */
+    async submitClientRender(params) {
+        return this.request('/automations/submit-client-render', {
+            method: 'POST',
+            body: JSON.stringify(params),
+        });
+    }
 }
 exports.AutomationsClient = AutomationsClient;
 /**

package/dist/types.d.ts

@@ -373,6 +373,8 @@ export interface ImageEditorConfig extends BaseEditorConfig {
         segments: StaticSegment[];
     }>;
     dynamicCrop?: DynamicCropConfig;
+    /** When true, rendering is done client-side in the browser for exact WYSIWYG match */
+    clientSideRender?: boolean;
 }
 export interface EditorConfig extends BaseEditorConfig {
     channels: Array<{
@@ -779,8 +781,12 @@ export interface WorkflowNodeDefinition {
         selectionConfig?: SelectionConfig;
         selectionState?: SelectionState;
         outputMode?: OutputMode;
-        variableType?: 'image' | 'video' | 'audio' | 'text';
+        variableType?: 'image' | 'video' | 'audio' | 'text' | 'dropdown';
         defaultValue?: string;
+        dropdownOptions?: Array<{
+            label: string;
+            value: string;
+        }>;
         workflowTemplateId?: string;
         workflowVariableNameToIdMap?: Record<string, string>;
         workflowPassThrough?: Record<string, boolean>;
@@ -833,12 +839,60 @@ export interface NodeRun {
     automation_run_id: string;
     template_node_id: string;
     type: NodeTypeEnum;
-    status: 'pending' | 'running' | 'completed' | 'failed';
+    status: 'pending' | 'running' | 'completed' | 'failed' | 'awaiting_client_render';
     input_data: Record<string, unknown> | null;
     output_data: Record<string, unknown> | null;
     created_at: string;
     completed_at: string | null;
 }
+/**
+ * Client-side render element for image editor
+ * Contains all resolved properties needed for browser-based rendering
+ */
+export interface ClientRenderElement {
+    id: string;
+    type: 'text' | 'image';
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+    zIndex: number;
+    rotation?: number;
+    text?: string;
+    color?: string;
+    font?: 'tiktok' | 'apple' | 'arial';
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    lineHeight?: number;
+    letterSpacing?: number;
+    textAlign?: 'left' | 'center' | 'right';
+    verticalAlign?: 'top' | 'middle' | 'bottom';
+    outlineWidth?: number;
+    strokeColor?: string;
+    backgroundColor?: string;
+    backgroundOpacity?: number;
+    backgroundBorderRadius?: BorderRadiusConfig;
+    paddingTop?: number;
+    paddingRight?: number;
+    paddingBottom?: number;
+    paddingLeft?: number;
+    autoWidth?: boolean;
+    boxAlign?: 'left' | 'center' | 'right';
+    imageUrl?: string;
+    fit?: 'cover' | 'contain' | 'fill';
+    opacity?: number;
+    borderRadius?: number | BorderRadiusConfig;
+}
+/**
+ * Client-side render inputs - stored in node_run.output_data when awaiting_client_render
+ */
+export interface ClientRenderInputs {
+    width: number;
+    height: number;
+    backgroundUrl?: string;
+    backgroundFit?: 'cover' | 'contain' | 'fill';
+    elements: ClientRenderElement[];
+}
 /**
  * Media types
  */

package/package.json

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