ugcinc 2.63.1 → 2.63.3

package/dist/index.d.ts

@@ -9,7 +9,9 @@ export { TasksClient } from './tasks';
 export { PostsClient } from './posts';
 export { StatsClient } from './stats';
 export { OrganizationClient } from './org';
+export { RenderClient } from './render';
 export { AutomationsClient, getAllNodes, getNodeByType } from './automations';
 export { MediaClient } from './media';
+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, PostStat, ApiKey, EditorConfig, VideoEditorConfig, 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, AutomationTemplate, AutomationRun, NodeRun, OutputSchemaProperty, SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, OutputInput, OutputNodeConfig, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, } 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.MediaClient = exports.getNodeByType = exports.getAllNodes = exports.AutomationsClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.MediaClient = 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");
@@ -18,7 +18,8 @@ var stats_1 = require("./stats");
 Object.defineProperty(exports, "StatsClient", { enumerable: true, get: function () { return stats_1.StatsClient; } });
 var org_1 = require("./org");
 Object.defineProperty(exports, "OrganizationClient", { enumerable: true, get: function () { return org_1.OrganizationClient; } });
-// RenderClient removed - replaced by Remotion rendering
+var render_1 = require("./render");
+Object.defineProperty(exports, "RenderClient", { enumerable: true, get: function () { return render_1.RenderClient; } });
 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; } });

package/dist/render.d.ts

@@ -1,78 +1,64 @@
-import { BaseClient } from './base';
-import type { ApiResponse, RenderJobSubmit, RenderVideoRequest, RenderImageRequest, RenderJobResponse, RenderJobStatus } from './types';
+import type { ApiResponse } from './types';
+import type { ImageEditorNodeConfig } from 'ugcinc-render';
+export interface RenderJobResponse {
+    job_id: string;
+    status: string;
+    output_type: string;
+    message: string;
+}
+export interface RenderJobStatus {
+    job_id: string;
+    status: 'pending' | 'processing' | 'completed' | 'failed' | 'error';
+    progress?: number;
+    message?: string;
+    download_url?: string;
+    error?: string;
+    render_time_ms?: number;
+    size_bytes?: number;
+}
+export interface SubmitImageRenderJobParams {
+    config: ImageEditorNodeConfig;
+    /** Map of inputId -> URL for images and background */
+    imageUrls: Record<string, string>;
+    /** Map of textInputId -> text content for text elements */
+    textValues: Record<string, string>;
+    output_type?: 'image';
+    image_format?: 'png' | 'jpeg';
+}
+export interface RenderVideoEditorConfig {
+    width: number;
+    height: number;
+    fps: number;
+    duration?: number;
+    channels: Array<{
+        id: string;
+        segments: Array<Record<string, unknown>>;
+    }>;
+    dynamicCrop?: Record<string, unknown>;
+}
+export interface SubmitVideoRenderJobParams {
+    config: RenderVideoEditorConfig;
+    sources?: Record<string, string>;
+    output_type?: 'video' | 'image';
+    image_format?: 'png' | 'jpeg';
+    video_codec?: 'h264' | 'h265';
+}
 /**
- * Client for video rendering operations
+ * Client for rendering operations
+ * Note: This calls Modal endpoints directly, not the UGC Inc API
  */
-export declare class RenderClient extends BaseClient {
-    /**
-     * Render a video
-     * @param params - Video render parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * const videoJob = await client.render.renderVideo({
-     *   editor: myVideoEditorConfig,  // Can include video/audio/text/image segments
-     * });
-     * ```
-     */
-    renderVideo(params: Omit<RenderVideoRequest, 'output_type'>): Promise<ApiResponse<RenderJobResponse>>;
-    /**
-     * Render a static image (text and images only)
-     * @param params - Image render parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * const imageJob = await client.render.renderImage({
-     *   editor: myImageEditorConfig,  // Can only include text/image segments
-     *   image_format: 'png'
-     * });
-     * ```
-     */
-    renderImage(params: Omit<RenderImageRequest, 'output_type'>): Promise<ApiResponse<RenderJobResponse>>;
+export declare class RenderClient {
     /**
-     * Submit a render job (generic - use renderVideo or renderImage for type safety)
-     * @param params - Render job parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * // Less type-safe, prefer renderVideo() or renderImage()
-     * const job = await client.render.submit({
-     *   use_example: true,
-     *   output_type: 'video'
-     * });
-     *
-     * // Poll status separately
-     * const status = await client.render.getStatus(job.data.job_id);
-     * ```
+     * Submit an image render job to the Modal renderer
+     * Uses the new element-based format for single-source-of-truth rendering
      */
-    submit(params: RenderJobSubmit): Promise<ApiResponse<RenderJobResponse>>;
+    submitImageRenderJob(params: SubmitImageRenderJobParams): Promise<ApiResponse<RenderJobResponse>>;
     /**
-     * Get the status of a render job
-     * @param jobId - The job ID returned from submit()
-     * @returns Current job status with progress, stats, and download URL when completed
-     * @example
-     * ```typescript
-     * const status = await client.render.getStatus(jobId);
-     * if (status.data.status === 'completed') {
-     *   console.log('Output type:', status.data.output_type);  // 'video' or 'image'
-     *   console.log('Download URL:', status.data.download_url);
-     * }
-     * ```
+     * Submit a render job to the Modal renderer
      */
-    getStatus(jobId: string): Promise<ApiResponse<RenderJobStatus>>;
+    submitVideoRenderJob(params: SubmitVideoRenderJobParams): Promise<ApiResponse<RenderJobResponse>>;
     /**
-     * Download the rendered file (video or image)
-     * @param jobId - The job ID
-     * @returns The rendered file as a blob
-     * @example
-     * ```typescript
-     * const file = await client.render.download(jobId);
-     * if (file.ok) {
-     *   // Create download link
-     *   const url = URL.createObjectURL(file.data);
-     *   window.location.href = url;
-     * }
-     * ```
+     * Get render job status from the Modal renderer
      */
-    download(jobId: string): Promise<ApiResponse<Blob>>;
+    getRenderJobStatus(jobId: string): Promise<ApiResponse<RenderJobStatus>>;
 }

package/dist/render.js

@@ -1,114 +1,186 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RenderClient = void 0;
-const base_1 = require("./base");
+// Modal renderer endpoints
+const RENDER_SUBMIT_URL = "https://aidangollan--ugcinc-render-renderer-submit-job.modal.run";
+const RENDER_STATUS_URL = "https://aidangollan--ugcinc-render-renderer-get-status.modal.run";
 /**
- * Client for video rendering operations
+ * Client for rendering operations
+ * Note: This calls Modal endpoints directly, not the UGC Inc API
  */
-class RenderClient extends base_1.BaseClient {
+class RenderClient {
     /**
-     * Render a video
-     * @param params - Video render parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * const videoJob = await client.render.renderVideo({
-     *   editor: myVideoEditorConfig,  // Can include video/audio/text/image segments
-     * });
-     * ```
+     * Submit an image render job to the Modal renderer
+     * Uses the new element-based format for single-source-of-truth rendering
      */
-    async renderVideo(params) {
-        return this.post('/render/submit', { ...params, output_type: 'video' });
-    }
-    /**
-     * Render a static image (text and images only)
-     * @param params - Image render parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * const imageJob = await client.render.renderImage({
-     *   editor: myImageEditorConfig,  // Can only include text/image segments
-     *   image_format: 'png'
-     * });
-     * ```
-     */
-    async renderImage(params) {
-        return this.post('/render/submit', { ...params, output_type: 'image' });
-    }
-    /**
-     * Submit a render job (generic - use renderVideo or renderImage for type safety)
-     * @param params - Render job parameters
-     * @returns Job ID and initial status
-     * @example
-     * ```typescript
-     * // Less type-safe, prefer renderVideo() or renderImage()
-     * const job = await client.render.submit({
-     *   use_example: true,
-     *   output_type: 'video'
-     * });
-     *
-     * // Poll status separately
-     * const status = await client.render.getStatus(job.data.job_id);
-     * ```
-     */
-    async submit(params) {
-        return this.post('/render/submit', params);
+    async submitImageRenderJob(params) {
+        try {
+            const response = await fetch(RENDER_SUBMIT_URL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    config: {
+                        // New element-based format
+                        width: params.config.width,
+                        height: params.config.height,
+                        elements: params.config.elements,
+                        backgroundFit: params.config.backgroundFit ?? 'cover',
+                        dynamicCrop: params.config.dynamicCrop,
+                        // Inject imageUrls and textValues as sources for the renderer
+                        imageUrls: params.imageUrls,
+                        textValues: params.textValues,
+                    },
+                    output_type: params.output_type ?? 'image',
+                    image_format: params.image_format ?? 'png',
+                })
+            });
+            const text = await response.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (jsonError) {
+                console.error('[Render] JSON parse error:', text.substring(0, 200));
+                return {
+                    ok: false,
+                    code: response.status || 500,
+                    message: `Modal endpoint error: ${text.substring(0, 100)}`,
+                };
+            }
+            if (data.status === 'error' || !response.ok) {
+                return {
+                    ok: false,
+                    code: response.status,
+                    message: data.error ?? data.message ?? 'Failed to submit render job',
+                };
+            }
+            return {
+                ok: true,
+                code: 200,
+                message: "Render job submitted",
+                data,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[Render] Submit error:', error);
+            return {
+                ok: false,
+                code: 500,
+                message: `Failed to submit render job: ${errorMessage}`,
+            };
+        }
     }
     /**
-     * Get the status of a render job
-     * @param jobId - The job ID returned from submit()
-     * @returns Current job status with progress, stats, and download URL when completed
-     * @example
-     * ```typescript
-     * const status = await client.render.getStatus(jobId);
-     * if (status.data.status === 'completed') {
-     *   console.log('Output type:', status.data.output_type);  // 'video' or 'image'
-     *   console.log('Download URL:', status.data.download_url);
-     * }
-     * ```
+     * Submit a render job to the Modal renderer
      */
-    async getStatus(jobId) {
-        return this.post('/render/status', { job_id: jobId });
+    async submitVideoRenderJob(params) {
+        try {
+            const response = await fetch(RENDER_SUBMIT_URL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({
+                    config: params.config,
+                    sources: params.sources,
+                    output_type: params.output_type,
+                    image_format: params.image_format,
+                    video_codec: params.video_codec,
+                })
+            });
+            const text = await response.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (jsonError) {
+                console.error('[Render] JSON parse error:', text.substring(0, 200));
+                return {
+                    ok: false,
+                    code: response.status || 500,
+                    message: `Modal endpoint error: ${text.substring(0, 100)}`,
+                };
+            }
+            if (data.status === 'error' || !response.ok) {
+                return {
+                    ok: false,
+                    code: response.status,
+                    message: data.error ?? data.message ?? 'Failed to submit render job',
+                };
+            }
+            return {
+                ok: true,
+                code: 200,
+                message: "Render job submitted",
+                data,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[Render] Submit error:', error);
+            return {
+                ok: false,
+                code: 500,
+                message: `Failed to submit render job: ${errorMessage}`,
+            };
+        }
     }
     /**
-     * Download the rendered file (video or image)
-     * @param jobId - The job ID
-     * @returns The rendered file as a blob
-     * @example
-     * ```typescript
-     * const file = await client.render.download(jobId);
-     * if (file.ok) {
-     *   // Create download link
-     *   const url = URL.createObjectURL(file.data);
-     *   window.location.href = url;
-     * }
-     * ```
+     * Get render job status from the Modal renderer
      */
-    async download(jobId) {
-        const response = await fetch(`${this['baseUrl']}/render/download`, {
-            method: 'POST',
-            headers: {
-                'Authorization': this.orgId ? '' : `Bearer ${this.apiKey}`,
-                'x-api-key': this.orgId ? this.apiKey : '',
-                'Content-Type': 'application/json',
-            },
-            body: JSON.stringify({ job_id: jobId })
-        });
-        if (!response.ok) {
-            const errorData = await response.json().catch(() => ({ message: 'Download failed' }));
+    async getRenderJobStatus(jobId) {
+        try {
+            const response = await fetch(RENDER_STATUS_URL, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                },
+                body: JSON.stringify({ job_id: jobId }),
+            });
+            const text = await response.text();
+            let data;
+            try {
+                data = JSON.parse(text);
+            }
+            catch (jsonError) {
+                console.error('[Render] JSON parse error:', text.substring(0, 200));
+                return {
+                    ok: false,
+                    code: response.status || 500,
+                    message: `Modal endpoint error: ${text.substring(0, 100)}`,
+                };
+            }
+            if (data.status === 'error' || !response.ok) {
+                return {
+                    ok: false,
+                    code: response.status,
+                    message: data.error ?? data.message ?? 'Failed to get job status',
+                };
+            }
+            // Modal returns Vercel Blob URL as download_url (fast CDN access)
+            // Fallback to download endpoint if not provided
+            if (data.status === 'completed' && !data.download_url) {
+                data.download_url = `https://aidangollan--ugcinc-render-renderer-download.modal.run?job_id=${jobId}`;
+            }
+            return {
+                ok: true,
+                code: 200,
+                message: "Job status retrieved",
+                data,
+            };
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            console.error('[Render] Status error:', error);
             return {
                 ok: false,
-                code: response.status,
-                message: errorData.message || 'Failed to download file'
+                code: 500,
+                message: `Failed to get job status: ${errorMessage}`,
             };
         }
-        const blob = await response.blob();
-        return {
-            ok: true,
-            code: 200,
-            message: 'Success',
-            data: blob
-        };
     }
 }
 exports.RenderClient = RenderClient;

package/package.json

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