ugcinc 2.39.0 → 2.41.0

package/dist/automations.d.ts

@@ -36,12 +36,14 @@ export declare class AutomationsClient extends BaseClient {
      * Run an automation template
      * @param variableInputs - Optional map of variable node IDs to their runtime values
      * @param saveAsPreview - If true, saves the output as a preview for sub-workflows
+     * @param tag - Optional tag for organizing runs
      */
     run(params: {
         templateId: string;
         orgId: string;
         variableInputs?: Record<string, string>;
         saveAsPreview?: boolean;
+        tag?: string;
     }): Promise<ApiResponse<{
         runId: string;
     }>>;

package/dist/automations.js

@@ -47,6 +47,7 @@ class AutomationsClient extends base_1.BaseClient {
      * Run an automation template
      * @param variableInputs - Optional map of variable node IDs to their runtime values
      * @param saveAsPreview - If true, saves the output as a preview for sub-workflows
+     * @param tag - Optional tag for organizing runs
      */
     async run(params) {
         return this.request('/automations/run', {

package/dist/index.d.ts

@@ -13,4 +13,4 @@ export { RenderClient } from './render';
 export { AutomationsClient, getAllNodes, getNodeByType } from './automations';
 export { MediaClient } from './media';
 export type { ClientConfig, } from './base';
-export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStat, ApiKey, EditorConfig, VideoEditorConfig, ImageEditorConfig, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, RenderJobSubmit, RenderVideoRequest, RenderImageRequest, RenderJobResponse, RenderJobStatus, 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, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, } from './types';
+export type { SuccessResponse, ErrorResponse, ApiResponse, Account, AccountStat, AccountTask, EditProfileInfo, Task, TaskType, Post, PostType, PostStat, ApiKey, EditorConfig, VideoEditorConfig, ImageEditorConfig, EditorChannel, TimeValue, BaseSegmentProps, VisualSegmentProps, EditorSegment, VideoSegment, AudioSegment, ImageSegment, TextSegment, StaticSegment, PositionAnchor, RelativePositionConfig, RenderJobSubmit, RenderVideoRequest, RenderImageRequest, RenderJobResponse, RenderJobStatus, 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, UserMedia, SocialAudio, Media, GetMediaParams, UploadMediaParams, UploadMediaResponse, UpdateMediaTagParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, CreateMediaFromUrlParams, } from './types';

package/dist/types.d.ts

@@ -430,6 +430,23 @@ export interface BorderRadiusConfig {
     /** Bottom-left corner radius in pixels */
     bottomLeft?: number;
 }
+/**
+ * Position anchor for relative positioning
+ * Specifies which edge of the reference element to anchor to
+ */
+export type PositionAnchor = 'top' | 'bottom' | 'left' | 'right';
+/**
+ * Relative position configuration
+ * When set on a segment, its position is calculated relative to another segment
+ */
+export interface RelativePositionConfig {
+    /** ID of the segment to position relative to */
+    elementId: string;
+    /** Which edge of the reference segment to anchor to */
+    anchor: PositionAnchor;
+    /** Offset in pixels from the anchor point (positive = away from reference) */
+    offset: number;
+}
 /**
  * Visual segment properties (video, image, text, editor)
  */
@@ -450,6 +467,16 @@ export interface VisualSegmentProps extends BaseSegmentProps {
     rotation?: number;
     /** Opacity percentage 0-100 (default: 100) */
     opacity?: number;
+    /**
+     * Relative positioning - when set, xOffset/yOffset are calculated from the reference segment
+     * This is useful for stacking elements like text messages where the reference element's
+     * height may vary based on text content.
+     *
+     * @example
+     * // Position this segment below another segment with a 10px gap
+     * relativePosition: { elementId: 'message-1', anchor: 'bottom', offset: 10 }
+     */
+    relativePosition?: RelativePositionConfig;
 }
 /**
  * Video segment - displays video content with optional audio
@@ -695,8 +722,10 @@ export interface AutomationRun {
     id: string;
     template_id: string;
     org_id: string;
+    tag: string | null;
     status: 'pending' | 'running' | 'completed' | 'failed';
     variable_inputs: Record<string, string> | null;
+    save_as_preview: boolean | null;
     created_at: string;
     completed_at: string | null;
 }

package/package.json

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