ugcinc 4.5.92 → 4.6.0

package/dist/automations/nodes/api-request.d.ts

@@ -10,12 +10,22 @@ export interface HeaderEntry {
     key: string;
     value: string;
 }
+export type ApiRequestOutputPrimitiveType = 'string' | 'number' | 'boolean' | 'image';
+export type ApiRequestArrayItemType = ApiRequestOutputPrimitiveType | 'object';
+export type ApiRequestOutputType = ApiRequestOutputPrimitiveType | 'object' | 'array';
+export interface ApiRequestOutputField {
+    name: string;
+    type: ApiRequestOutputType;
+    items?: ApiRequestArrayItemType;
+    objectSchema?: ObjectSchemaField[];
+    required?: boolean;
+}
 declare const definition: import("./types").NodeDefinition<"api-request", "generator", {
     url: string;
     method: HttpMethod;
     headers: HeaderEntry[];
     body: string;
-    outputFields: ObjectSchemaField[];
+    outputFields: ApiRequestOutputField[];
     outputMode: OutputMode;
     selectionMode: SelectionMode | null;
 }, ApiRequestNodeInputs, ApiRequestNodeOutputs, false>;

package/dist/automations/nodes/api-request.js

@@ -8,6 +8,41 @@ const types_1 = require("./types");
 // =============================================================================
 const HttpMethods = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'];
 exports.HttpMethods = HttpMethods;
+function getArrayItemPortType(items) {
+    switch (items) {
+        case 'number':
+            return 'number';
+        case 'boolean':
+            return 'boolean';
+        case 'object':
+            return 'object';
+        case 'image':
+            return 'image';
+        default:
+            return 'text';
+    }
+}
+function getOutputPortShape(field) {
+    if (field.type === 'array') {
+        return {
+            type: getArrayItemPortType(field.items),
+            isArray: true,
+        };
+    }
+    if (field.type === 'object') {
+        return { type: 'object', isArray: false };
+    }
+    if (field.type === 'number') {
+        return { type: 'number', isArray: false };
+    }
+    if (field.type === 'boolean') {
+        return { type: 'boolean', isArray: false };
+    }
+    if (field.type === 'image') {
+        return { type: 'image', isArray: false };
+    }
+    return { type: 'text', isArray: false };
+}
 // =============================================================================
 // Node Definition
 // =============================================================================
@@ -15,7 +50,7 @@ const definition = (0, types_1.defineNode)({
     nodeId: 'api-request',
     label: 'API Request',
     description: 'Make HTTP requests to external APIs',
-    guide: 'Makes HTTP requests to external APIs and returns parsed response data. Use when you need to fetch data from or send data to external services. Configure URL, method (GET/POST/PUT/PATCH/DELETE), headers, and body. Supports template variables ({{var}}) in URL, header values, and body for dynamic values from upstream nodes. Define output fields to extract specific data from JSON responses. Use cases: fetching external data, triggering webhooks, integrating third-party APIs, sending data to external services.',
+    guide: 'Makes HTTP requests to external APIs and returns parsed response data. Use when you need to fetch data from or send data to external services. Configure URL, method (GET/POST/PUT/PATCH/DELETE), headers, and body. Supports template variables ({{var}}) in URL, header values, and body for dynamic values from upstream nodes. Define output fields to extract specific data from JSON responses, including typed arrays and image URL fields that should flow into image ports. Use cases: fetching external data, triggering webhooks, integrating third-party APIs, sending data to external services.',
     type: 'generator',
     category: 'Generation',
     outputModes: ['per-input', 'single'],
@@ -49,32 +84,11 @@ const definition = (0, types_1.defineNode)({
         // Output ports from outputFields
         const outputFields = (config?.outputFields ?? [{ name: 'response', type: 'string' }]);
         const outputs = outputFields.map(f => {
-            let pType;
-            let pIsArray;
-            if (f.type === 'array') {
-                pType = f.items === 'object' ? 'object' : 'text';
-                pIsArray = true;
-            }
-            else if (f.type === 'object') {
-                pType = 'object';
-                pIsArray = false;
-            }
-            else if (f.type === 'number') {
-                pType = 'number';
-                pIsArray = false;
-            }
-            else if (f.type === 'boolean') {
-                pType = 'boolean';
-                pIsArray = false;
-            }
-            else {
-                pType = 'text';
-                pIsArray = false;
-            }
+            const { type, isArray } = getOutputPortShape(f);
             return {
                 id: f.name,
-                type: pType,
-                isArray: pIsArray,
+                type,
+                isArray,
                 required: f.required ?? true,
                 ...(f.objectSchema && { objectSchema: f.objectSchema }),
             };

package/dist/automations/nodes/index.d.ts

@@ -18,7 +18,7 @@ export declare const nodeDefinitions: {
         method: import("./api-request").HttpMethod;
         headers: import("./api-request").HeaderEntry[];
         body: string;
-        outputFields: import("./types").ObjectSchemaField[];
+        outputFields: import("./api-request").ApiRequestOutputField[];
         outputMode: import("./types").OutputMode;
         selectionMode: import("./types").SelectionMode | null;
     }, import("./api-request").ApiRequestNodeInputs, import("./api-request").ApiRequestNodeOutputs, false> & {

package/dist/billing.d.ts

@@ -17,19 +17,29 @@ export interface BillingInfo {
         name: string | null;
     }>;
 }
-export interface CancelSubscriptionResponse {
-    message: string;
-}
 export interface PortalUrlResponse {
     url: string;
 }
-export interface DeactivateAccountParams {
+export interface CancelAccountParams {
+    account_id: string;
+}
+export interface CancelAccountResponse {
+    message: string;
+    account_id: string;
+    cancel_at: string;
+}
+export interface ReactivateAccountParams {
     account_id: string;
 }
-export interface DeactivateAccountResponse {
+export interface ReactivateAccountResponse {
     message: string;
     account_id: string;
 }
+export interface CancelSubscriptionResponse {
+    message: string;
+    cancelled: number;
+    cancel_at: string | null;
+}
 export interface RequestReplacementParams {
     account_id: string;
     reason?: string;
@@ -37,7 +47,6 @@ export interface RequestReplacementParams {
 export interface RequestReplacementResponse {
     message: string;
     request: BillingRequestInfo | null;
-    new_account_id: string | null;
 }
 export interface RequestRefundParams {
     account_id: string;
@@ -68,22 +77,28 @@ export declare class BillingClient extends BaseClient {
      * Get billing information including subscription details and linked orgs
      */
     getBilling(): Promise<ApiResponse<BillingInfo>>;
-    /**
-     * Cancel subscription at the end of the current billing period
-     */
-    cancelSubscription(): Promise<ApiResponse<CancelSubscriptionResponse>>;
     /**
      * Get a Stripe billing portal URL for managing payment methods
      */
     getPortalUrl(params?: PortalParams): Promise<ApiResponse<PortalUrlResponse>>;
     /**
-     * Deactivate an account slot, removing it from your subscription
-     * The account is reclaimed and billing is adjusted (no proration)
+     * Cancel the subscription for a single account. The account keeps access until
+     * the end of the current billing period, then is reclaimed automatically.
+     * Can be reversed with reactivateAccount before that date.
      */
-    deactivateAccount(params: DeactivateAccountParams): Promise<ApiResponse<DeactivateAccountResponse>>;
+    cancelAccount(params: CancelAccountParams): Promise<ApiResponse<CancelAccountResponse>>;
+    /**
+     * Undo a pending cancellation on an account, restoring it to its prior status.
+     */
+    reactivateAccount(params: ReactivateAccountParams): Promise<ApiResponse<ReactivateAccountResponse>>;
+    /**
+     * Cancel all accounts under this billing. Each account keeps access until the
+     * end of the current billing period, then is reclaimed automatically.
+     */
+    cancelSubscription(): Promise<ApiResponse<CancelSubscriptionResponse>>;
     /**
-     * Request a replacement for an account
-     * First replacement is auto-approved; subsequent requests require manual review
+     * Request a replacement for an account. All replacement requests require
+     * admin review.
      */
     requestReplacement(params: RequestReplacementParams): Promise<ApiResponse<RequestReplacementResponse>>;
     /**

package/dist/billing.js

@@ -15,12 +15,6 @@ class BillingClient extends base_1.BaseClient {
     async getBilling() {
         return this.get('/billing');
     }
-    /**
-     * Cancel subscription at the end of the current billing period
-     */
-    async cancelSubscription() {
-        return this.post('/billing/cancel');
-    }
     /**
      * Get a Stripe billing portal URL for managing payment methods
      */
@@ -28,15 +22,29 @@ class BillingClient extends base_1.BaseClient {
         return this.post('/billing/portal', params ?? {});
     }
     /**
-     * Deactivate an account slot, removing it from your subscription
-     * The account is reclaimed and billing is adjusted (no proration)
+     * Cancel the subscription for a single account. The account keeps access until
+     * the end of the current billing period, then is reclaimed automatically.
+     * Can be reversed with reactivateAccount before that date.
      */
-    async deactivateAccount(params) {
-        return this.post('/billing/deactivate', params);
+    async cancelAccount(params) {
+        return this.post('/billing/cancel-account', params);
+    }
+    /**
+     * Undo a pending cancellation on an account, restoring it to its prior status.
+     */
+    async reactivateAccount(params) {
+        return this.post('/billing/reactivate-account', params);
+    }
+    /**
+     * Cancel all accounts under this billing. Each account keeps access until the
+     * end of the current billing period, then is reclaimed automatically.
+     */
+    async cancelSubscription() {
+        return this.post('/billing/cancel-subscription');
     }
     /**
-     * Request a replacement for an account
-     * First replacement is auto-approved; subsequent requests require manual review
+     * Request a replacement for an account. All replacement requests require
+     * admin review.
      */
     async requestReplacement(params) {
         return this.post('/billing/request-replacement', params);

package/dist/index.d.ts

@@ -28,17 +28,17 @@ 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, CreateDraftParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
-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 { RefreshStatsParams, RefreshStatsError, RefreshStatsResponse, RefreshStatsProgressResponse, 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';
-export type { BillingInfo, CancelSubscriptionResponse, PortalUrlResponse, DeactivateAccountParams, DeactivateAccountResponse, RequestReplacementParams, RequestReplacementResponse, RequestRefundParams, RequestRefundResponse, BillingRequestInfo, PortalParams, } from './billing';
+export type { BillingInfo, PortalUrlResponse, CancelAccountParams, CancelAccountResponse, ReactivateAccountParams, ReactivateAccountResponse, CancelSubscriptionResponse, RequestReplacementParams, RequestReplacementResponse, RequestRefundParams, RequestRefundResponse, BillingRequestInfo, PortalParams, } from './billing';
 export type { RenderJobResponse, RenderJobStatus, SubmitImageRenderJobParams, SubmitVideoRenderJobParams, SubmitScreenshotAnimationRenderJobParams, SubmitAutoCaptionRenderJobParams, SubmitSceneSplitJobParams, SceneSplitDetectorConfig, SubmitInstagramDmRenderJobParams, SubmitIMessageDmRenderJobParams, IgDmMessage, ImDmMessage, RenderVideoEditorConfig, } from './render';
 export type { VideoEditorNodeConfig, VideoEditorChannel, VideoEditorSegment, VideoEditorVideoSegment, VideoEditorAudioSegment, VideoEditorImageSegment, VideoEditorTextSegment, VideoEditorImageSequenceSegment, VideoEditorVideoSequenceSegment, TimeValue, TimeMode, SegmentTimelinePosition, DeduplicationLevel, DeduplicationInput, ImageEditorElement, DimensionPresetKey, } from './render/types';
 export type { ImageEditorNodeConfig, ImageComposerNodeConfig, ImageComposerRenderInput } from './automations/nodes/image-composer';
 export { prepareImageComposerInput } from './automations/nodes/image-composer';
 export type { AccountNodeConfig } from './automations/nodes/account';
-export type { ApiRequestNodeConfig, HeaderEntry, HttpMethod } from './automations/nodes/api-request';
+export type { ApiRequestNodeConfig, ApiRequestOutputField, ApiRequestOutputType, ApiRequestArrayItemType, HeaderEntry, HttpMethod, } from './automations/nodes/api-request';
 export { HttpMethods } from './automations/nodes/api-request';
 export type { AutoCaptionNodeConfig, AutoCaptionPreset, AutoCaptionFontWeight, AutoCaptionPosition, } from './automations/nodes/auto-caption';
 export { nodeConfigToCaptionStyle } from './automations/nodes/auto-caption';

package/dist/stats.d.ts

@@ -12,11 +12,23 @@ export interface RefreshStatsError {
     error: string;
 }
 export interface RefreshStatsResponse {
-    accounts_refreshed: number;
-    accounts_failed: number;
-    total_accounts: number;
-    post_stats_count: number;
-    errors?: RefreshStatsError[];
+    batchId: string;
+    batchCreatedAtMs: number;
+    queuedAccounts: number;
+    totalAccounts: number;
+    totalPosts: number;
+}
+export interface RefreshStatsProgressResponse {
+    batchId: string;
+    batchCreatedAtMs: number;
+    totalAccounts: number;
+    completedAccounts: number;
+    failedAccounts: number;
+    activeAccounts: number;
+    queuedAccounts: number;
+    done: boolean;
+    totalPosts: number;
+    completedPosts: number;
 }
 export interface DailyAggregatedStat {
     date: Date | string;
@@ -358,6 +370,10 @@ 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>>;
+    getRefreshProgress(params: {
+        batchId: string;
+        org_group?: string;
+    }): Promise<ApiResponse<RefreshStatsProgressResponse>>;
     /**
      * Refresh stats with NDJSON streaming progress.
      * Returns the raw Response so the caller can read the stream.

package/dist/stats.js

@@ -209,6 +209,13 @@ class StatsClient extends base_1.BaseClient {
     async refresh(params) {
         return this.post('/stats/refresh', params ?? {});
     }
+    async getRefreshProgress(params) {
+        const searchParams = new URLSearchParams({ batchId: params.batchId });
+        if (params.org_group) {
+            searchParams.set('org_group', params.org_group);
+        }
+        return this.get(`/stats/refresh/progress?${searchParams.toString()}`);
+    }
     /**
      * Refresh stats with NDJSON streaming progress.
      * Returns the raw Response so the caller can read the stream.

package/dist/tools/billing.js

@@ -11,14 +11,6 @@ exports.billingTools = [
             return client.billing.getBilling();
         },
     },
-    {
-        name: 'cancel_subscription',
-        description: 'Cancel subscription at the end of the current billing period. The subscription remains active until the period ends.',
-        schema: zod_1.z.object({}).optional(),
-        execute: async (client) => {
-            return client.billing.cancelSubscription();
-        },
-    },
     {
         name: 'get_billing_portal',
         description: 'Get a Stripe billing portal URL for managing payment methods and invoices.',
@@ -30,18 +22,36 @@ exports.billingTools = [
         },
     },
     {
-        name: 'deactivate_account',
-        description: 'Deactivate an account slot. Removes it from your subscription (no proration) and reclaims the account.',
+        name: 'cancel_account',
+        description: 'Cancel the subscription for a single account. The account keeps access until the end of the current billing period, then is reclaimed automatically.',
+        schema: zod_1.z.object({
+            account_id: zod_1.z.string().describe('ID of the account to cancel'),
+        }),
+        execute: async (client, params) => {
+            return client.billing.cancelAccount(params);
+        },
+    },
+    {
+        name: 'reactivate_account',
+        description: 'Undo a pending cancellation on an account, restoring it to its prior status. Must be called before the billing period ends.',
         schema: zod_1.z.object({
-            account_id: zod_1.z.string().describe('ID of the account to deactivate'),
+            account_id: zod_1.z.string().describe('ID of the account to reactivate'),
         }),
         execute: async (client, params) => {
-            return client.billing.deactivateAccount(params);
+            return client.billing.reactivateAccount(params);
+        },
+    },
+    {
+        name: 'cancel_subscription',
+        description: 'Cancel every account under this billing. Each account keeps access until the end of the current billing period, then is reclaimed automatically.',
+        schema: zod_1.z.object({}).optional(),
+        execute: async (client) => {
+            return client.billing.cancelSubscription();
         },
     },
     {
         name: 'request_replacement',
-        description: 'Request a replacement for an account. First replacement is auto-approved; subsequent requests require manual review.',
+        description: 'Request a replacement for an account. All replacement requests require manual review.',
         schema: zod_1.z.object({
             account_id: zod_1.z.string().describe('ID of the account to replace'),
             reason: zod_1.z.string().optional().describe('Reason for replacement'),

package/package.json

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