ugcinc 4.3.2 → 4.4.0

package/dist/base.d.ts

@@ -16,5 +16,6 @@ export declare class BaseClient {
     protected request<T>(endpoint: string, options?: RequestInit): Promise<ApiResponse<T>>;
     protected post<T>(endpoint: string, body?: unknown): Promise<ApiResponse<T>>;
     protected get<T>(endpoint: string): Promise<ApiResponse<T>>;
+    protected rawPost(endpoint: string, body?: unknown, extraHeaders?: Record<string, string>): Promise<Response>;
     protected postFormData<T>(endpoint: string, formData: FormData): Promise<ApiResponse<T>>;
 }

package/dist/base.js

@@ -73,6 +73,25 @@ class BaseClient {
             method: 'GET',
         });
     }
+    async rawPost(endpoint, body, extraHeaders) {
+        let url = `${this.baseUrl}${endpoint}`;
+        if (this.orgId) {
+            const separator = endpoint.includes('?') ? '&' : '?';
+            url = `${url}${separator}orgId=${encodeURIComponent(this.orgId)}`;
+        }
+        const headers = {
+            'Content-Type': 'application/json',
+            ...(this.admin
+                ? { 'x-api-key': this.apiKey }
+                : { 'Authorization': `Bearer ${this.apiKey}` }),
+            ...extraHeaders,
+        };
+        return fetch(url, {
+            method: 'POST',
+            headers,
+            body: body ? JSON.stringify(body) : undefined,
+        });
+    }
     async postFormData(endpoint, formData) {
         let url = `${this.baseUrl}${endpoint}`;
         // If orgId is provided, add it as query param to scope to that org

package/dist/index.d.ts

@@ -28,7 +28,7 @@ export type { ClientConfig } from './base';
 export type { Account, AccountStat, AccountTask, EditProfileInfo, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, AccountInfoUpdate, UpdateAccountInfoParams, AccountInfoUpdateResult, UpdateAccountInfoResponse, AccountSocialUpdate, UpdateAccountSocialParams, AccountSocialUpdateResult, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, NicheSwitchUpdate, NicheSwitchParams, NicheSwitchResult, NicheSwitchResponse, CreateAccountInput, CreateAccountsParams, CreateAccountResult, CreateAccountsResponse, TroubleshootFailReason, TroubleshootAccount, TroubleshootParams, } from './accounts';
 export type { TaskType, Task, GetTasksParams } from './tasks';
 export type { PostType, PostStatus, Post, PostStat, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, } from './posts';
-export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, DashboardDailyStat, GetDashboardDailyStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, } from './stats';
+export type { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, RefreshStartEvent, RefreshProgressEvent, RefreshDoneEvent, RefreshStreamEvent, DailyAggregatedStat, GetDailyAggregatedStatsParams, DailyAccountStat, GetDailyAccountStatsParams, DailyPostStat, GetDailyPostStatsParams, DashboardDailyStat, GetDashboardDailyStatsParams, TopAccount, GetTopAccountsParams, TopPost, GetTopPostsParams, } from './stats';
 export type { Org, ApiKey, DeleteApiKeyParams, EditApiKeyParams, IntegrationKey, IntegrationProvider, UpsertIntegrationKeyParams, DeleteIntegrationKeyParams } from './org';
 export type { UserMedia, MediaUse, SocialAudio, Media, GetMediaParams, GetSocialAudioParams, UploadMediaParams, UploadMediaResponse, MediaTagUpdate, UpdateMediaTagsParams, MediaTagUpdateResult, UpdateMediaTagsResponse, UpdateMediaTagParams, UpdateMediaNameParams, DeleteMediaParams, DeleteMediaResponse, CreateSocialAudioParams, ImportTextParams, ImportTextResponse, CreateMediaFromUrlParams, GetMediaUseParams, GetMediaUseResponse, FilterMediaParams, FilterMediaResponse, GetUploadTokenParams, UploadTokenResponse, } from './media';
 export type { CommentStatus, Comment, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './comments';

package/dist/stats.d.ts

@@ -147,6 +147,28 @@ export interface GetTopPostsParams {
     limit?: number;
     postIds?: string[];
 }
+export interface RefreshStartEvent {
+    type: 'start';
+    totalAccounts: number;
+    totalPosts: number;
+}
+export interface RefreshProgressEvent {
+    type: 'progress';
+    completedAccounts: number;
+    completedPosts: number;
+    totalAccounts: number;
+    totalPosts: number;
+}
+export interface RefreshDoneEvent {
+    type: 'done';
+    accounts_refreshed?: number;
+    accounts_failed?: number;
+    total_accounts?: number;
+    post_stats_count?: number;
+    errors?: RefreshStatsError[];
+    error?: string;
+}
+export type RefreshStreamEvent = RefreshStartEvent | RefreshProgressEvent | RefreshDoneEvent;
 /**
  * Client for managing statistics
  */
@@ -336,4 +358,14 @@ export declare class StatsClient extends BaseClient {
      * Note: Can only be called once per hour per organization (or per org_group if specified)
      */
     refresh(params?: RefreshStatsParams): Promise<ApiResponse<RefreshStatsResponse>>;
+    /**
+     * Refresh stats with NDJSON streaming progress.
+     * Returns the raw Response so the caller can read the stream.
+     *
+     * Events streamed (one JSON object per line):
+     * - `{ type: 'start', totalAccounts, totalPosts }`
+     * - `{ type: 'progress', completedAccounts, completedPosts, totalAccounts, totalPosts }`
+     * - `{ type: 'done', accounts_refreshed, ... }`
+     */
+    refreshStream(params?: RefreshStatsParams): Promise<Response>;
 }

package/dist/stats.js

@@ -209,5 +209,17 @@ class StatsClient extends base_1.BaseClient {
     async refresh(params) {
         return this.post('/stats/refresh', params ?? {});
     }
+    /**
+     * Refresh stats with NDJSON streaming progress.
+     * Returns the raw Response so the caller can read the stream.
+     *
+     * Events streamed (one JSON object per line):
+     * - `{ type: 'start', totalAccounts, totalPosts }`
+     * - `{ type: 'progress', completedAccounts, completedPosts, totalAccounts, totalPosts }`
+     * - `{ type: 'done', accounts_refreshed, ... }`
+     */
+    async refreshStream(params) {
+        return this.rawPost('/stats/refresh', params ?? {}, { 'X-Stream-Progress': 'true' });
+    }
 }
 exports.StatsClient = StatsClient;

package/package.json

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