ugcinc 2.30.0 → 2.31.0

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, 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, 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/stats.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { AccountStat, PostStat, GetAccountStatsParams, GetPostStatsParams, RefreshStatsParams, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, ApiResponse } from './types';
+import type { AccountStat, PostStat, GetAccountStatsParams, GetPostStatsParams, RefreshStatsParams, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyPostStat, GetDailyPostStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, ApiResponse } from './types';
 /**
  * Client for managing statistics
  */
@@ -74,6 +74,29 @@ export declare class StatsClient extends BaseClient {
      * ```
      */
     getDailyAggregated(params: GetDailyAggregatedStatsParams): Promise<ApiResponse<DailyAggregatedStat[]>>;
+    /**
+     * Get daily post statistics for chart tooltips
+     *
+     * Returns per-video daily stats with both cumulative values and daily changes.
+     * Perfect for showing per-video performance in chart tooltips.
+     *
+     * @param params - Date range and filter parameters (startDate and endDate required)
+     * @returns Array of daily post statistics with changes
+     *
+     * @example
+     * ```typescript
+     * const dailyPostStats = await client.stats.getDailyPostStats({
+     *   startDate: '2024-01-01',
+     *   endDate: '2024-01-31'
+     * });
+     *
+     * // Use for tooltips - group by date
+     * dailyPostStats.data.forEach(stat => {
+     *   console.log(`${stat.date}: ${stat.post_id} gained +${stat.views_change} views`);
+     * });
+     * ```
+     */
+    getDailyPostStats(params: GetDailyPostStatsParams): Promise<ApiResponse<DailyPostStat[]>>;
     /**
      * Get top N accounts by a specific metric
      *

package/dist/stats.js

@@ -82,6 +82,31 @@ class StatsClient extends base_1.BaseClient {
     async getDailyAggregated(params) {
         return this.post('/stats/aggregated/daily', params);
     }
+    /**
+     * Get daily post statistics for chart tooltips
+     *
+     * Returns per-video daily stats with both cumulative values and daily changes.
+     * Perfect for showing per-video performance in chart tooltips.
+     *
+     * @param params - Date range and filter parameters (startDate and endDate required)
+     * @returns Array of daily post statistics with changes
+     *
+     * @example
+     * ```typescript
+     * const dailyPostStats = await client.stats.getDailyPostStats({
+     *   startDate: '2024-01-01',
+     *   endDate: '2024-01-31'
+     * });
+     *
+     * // Use for tooltips - group by date
+     * dailyPostStats.data.forEach(stat => {
+     *   console.log(`${stat.date}: ${stat.post_id} gained +${stat.views_change} views`);
+     * });
+     * ```
+     */
+    async getDailyPostStats(params) {
+        return this.post('/stats/aggregated/daily-posts', params);
+    }
     /**
      * Get top N accounts by a specific metric
      *

package/dist/types.d.ts

@@ -252,6 +252,34 @@ export interface GetDailyAggregatedStatsParams {
     org_group?: string;
     user_group?: string;
 }
+export interface DailyPostStat {
+    date: Date | string;
+    post_id: string;
+    account_id: string;
+    caption: string | null;
+    media_urls: string[] | null;
+    social_id: string | null;
+    account_username: string | null;
+    account_type: string;
+    views: number;
+    likes: number;
+    comments: number;
+    shares: number;
+    saves: number;
+    views_change: number;
+    likes_change: number;
+    comments_change: number;
+    shares_change: number;
+    saves_change: number;
+}
+export interface GetDailyPostStatsParams {
+    startDate: string;
+    endDate: string;
+    accountIds?: string[];
+    tag?: string;
+    org_group?: string;
+    user_group?: string;
+}
 export interface TopAccount {
     account_id: string;
     username: string | null;
@@ -381,6 +409,12 @@ export interface BaseSegmentProps {
     relativeStart?: number;
     /** End time as fraction of parent duration (0-1, default: 1). Only used when parentId is set. */
     relativeEnd?: number;
+    /**
+     * Fade-in effect - applies a black overlay that smoothly fades out over the specified duration.
+     * The segment and all its overlays will appear to fade in from black.
+     */
+    /** Duration in milliseconds for the fade-in effect (0 or undefined = no fade) */
+    fadeIn?: number;
 }
 /**
  * Visual segment properties (video, image, text, editor)
@@ -415,10 +449,8 @@ export interface VideoSegment extends VisualSegmentProps {
     speed?: number;
     /** Audio volume percentage 0-100 (0 = muted, 100 = full) (default: 100) */
     volume?: number;
-    /** Enable fade-in from black (default: false) */
-    fadeIn?: boolean;
-    /** Fade-in duration in milliseconds (default: 500) */
-    fadeInDuration?: number;
+    /** Corner radius in pixels for rounded corners (default: 0, no rounding) */
+    borderRadius?: number;
 }
 /**
  * Audio segment - background audio or music
@@ -439,10 +471,8 @@ export interface ImageSegment extends VisualSegmentProps {
     fit?: 'cover' | 'contain' | 'fill';
     /** Loop animated GIFs (default: false) */
     loop?: boolean;
-    /** Enable fade-in from black (default: false) */
-    fadeIn?: boolean;
-    /** Fade-in duration in milliseconds (default: 500) */
-    fadeInDuration?: number;
+    /** Corner radius in pixels for rounded corners (default: 0, no rounding) */
+    borderRadius?: number;
 }
 /**
  * Text segment - rich text overlays with full typography control

package/package.json

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