ugcinc 4.19.0 → 4.19.1

package/dist/accounts.d.ts

@@ -96,6 +96,8 @@ export interface EditProfileInfo {
 }
 export interface GetAccountsParams {
     tag?: string;
+    /** Platform filter: only accounts of this type are returned. */
+    type?: 'tiktok' | 'instagram';
     org_group?: string;
     user_group?: string;
     status?: AccountStatus;

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

@@ -338,7 +338,7 @@ export declare const nodeDefinitions: {
         selectionMode: null;
         outputType: "video" | "image";
         inputs: {
-            type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+            type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
             id: string;
             isArray: boolean;
             required: boolean;

package/dist/automations/nodes/remotion-composition.d.ts

@@ -9,7 +9,7 @@ declare const defaults: {
     selectionMode: null;
     outputType: "video" | "image";
     inputs: {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
@@ -26,7 +26,7 @@ declare const _default: import("./types").NodeDefinition<"remotion-composition",
     selectionMode: null;
     outputType: "video" | "image";
     inputs: {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;

package/dist/index.d.ts

@@ -30,10 +30,10 @@ export type { InputType } from './automations/nodes/types';
 export type { ClientConfig } from './base';
 export type { Account, AccountStatus, AccountStat, AccountTask, QuarantineAccountParams, ReleaseAccountParams, QuarantineAccountResponse, 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, CaptionOverlay, GetPostsParams, CreateDraftParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
+export type { PostType, PostStatus, Post, PostStat, CaptionOverlay, GetPostsParams, GetPostsPageParams, PostsPage, PostSortField, PostSortDirection, CreateDraftParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
 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, } from './media';
+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, PfpSearchParams, PfpSearchResponse, PfpCandidate, ImageSearchParams, ImageSearchResult, ImageSearchResponse, ImageSearchVideoFormat, } from './media';
 export type { CommentStatus, Comment, CreateCommentParams, CreateCommentResponse, GetCommentsParams, } from './comments';
 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';
@@ -84,3 +84,4 @@ export type { NodeDefinition, NodeType, UserCreatableNodeType, NodeConfig, Workf
 export type { SelectionMode, ExhaustionBehavior, SelectionConfig, SelectionState, OutputMode, NodeCategory, TriggerIterationMode, IterationExhaustionBehavior, CollectionSelectionMode, TriggerCollectionConfig, MediaItemType, MediaNodeSelectionType, ResolvedPreview, PreviewSelectionState, PreviewContext, NullableOutputs, } from './automations/nodes/types';
 export type { SuccessResponse, ErrorResponse, ApiResponse, } from './types';
 export type { CropBoundary, CropAxisConfig, DynamicCropConfig, BorderRadiusConfig, VerticalAnchor, HorizontalAnchor, HorizontalSelfAnchor, VerticalSelfAnchor, RelativePositionConfigX, RelativePositionConfigY, } from './render/types';
+export type { PublicPostFailureCode, PublicPostRecovery, PublicPostNextAction, PublicPostFailure } from './post-failure';

package/dist/media.d.ts

@@ -131,6 +131,57 @@ export interface FilterMediaResponse {
     used_count: number;
     available_count: number;
 }
+export interface PfpSearchParams {
+    /** What to search for, e.g. "black girl selfie" or "asian woman aesthetic". */
+    search_term: string;
+    /** How many pictures to return. Defaults to 12, capped at 40. */
+    count?: number;
+}
+export interface PfpCandidate {
+    /** Stable id for this picture at the source. */
+    source_id: string;
+    /** Full-resolution image — the one an account's avatar is set to. */
+    url: string;
+    /** Smaller variant, for rendering a grid of options. */
+    preview_url: string;
+}
+export interface PfpSearchResponse {
+    pictures: PfpCandidate[];
+    search_term: string;
+    count: number;
+}
+export interface ImageSearchParams {
+    /** What to search for. */
+    search_term: string;
+    /** How many results to return. Defaults to 24, min 1, capped at 50. */
+    count?: number;
+    /** `next_cursor` of a previous response for the same `search_term`. */
+    cursor?: string;
+}
+export type ImageSearchVideoFormat = 'mp4' | 'hls' | 'gif';
+export interface ImageSearchResult {
+    /** Stable id for this result at the source. */
+    source_id: string;
+    title: string;
+    /** Full-resolution image; the cover image for a video result. */
+    url: string;
+    /** Smaller variant, for rendering a grid of results. */
+    preview_url: string;
+    /** Present only on video results. */
+    video_url?: string;
+    /**
+     * Present exactly when `video_url` is. `hls` is a playlist (`.m3u8`), not a
+     * file — convert it before storing it.
+     */
+    video_format?: ImageSearchVideoFormat;
+}
+export interface ImageSearchResponse {
+    results: ImageSearchResult[];
+    /** Pass as `cursor` to get the next page; null when there are no more. */
+    next_cursor: string | null;
+    search_term: string;
+    count: number;
+}
 export interface OwnedUploadParams {
     filename: string;
     contentType: string;
@@ -213,4 +264,32 @@ export declare class MediaClient extends BaseClient {
      * @param params.name - Use case identifier (e.g., "profile_picture")
      */
     filter(params: FilterMediaParams): Promise<ApiResponse<FilterMediaResponse>>;
+    /**
+     * Search for profile-picture candidates for a search term.
+     *
+     * Pictures already in use as a profile picture are removed before the result
+     * comes back, so two accounts cannot end up wearing the same face. Sourcing
+     * and filtering are one call for that reason — a caller who forgot the second
+     * step would get duplicates across their accounts and find out much later.
+     *
+     * Requires the `media:search` scope on a restricted key.
+     *
+     * @param params.search_term - What to search for
+     * @param params.count - How many to return (default 12, max 40)
+     */
+    pfpSearch(params: PfpSearchParams): Promise<ApiResponse<PfpSearchResponse>>;
+    /**
+     * Search for images and videos by keyword, a page at a time.
+     *
+     * Pass the previous response's `next_cursor` as `cursor`, with the same
+     * `search_term`, to continue. Unlike `pfpSearch`, results already in use are
+     * not removed.
+     *
+     * Requires the `media:search` scope on a restricted key.
+     *
+     * @param params.search_term - What to search for
+     * @param params.count - How many to return (default 24, max 50)
+     * @param params.cursor - `next_cursor` from the previous page
+     */
+    imageSearch(params: ImageSearchParams): Promise<ApiResponse<ImageSearchResponse>>;
 }

package/dist/media.js

@@ -96,5 +96,37 @@ class MediaClient extends base_1.BaseClient {
     async filter(params) {
         return this.post('/media/filter', params);
     }
+    /**
+     * Search for profile-picture candidates for a search term.
+     *
+     * Pictures already in use as a profile picture are removed before the result
+     * comes back, so two accounts cannot end up wearing the same face. Sourcing
+     * and filtering are one call for that reason — a caller who forgot the second
+     * step would get duplicates across their accounts and find out much later.
+     *
+     * Requires the `media:search` scope on a restricted key.
+     *
+     * @param params.search_term - What to search for
+     * @param params.count - How many to return (default 12, max 40)
+     */
+    async pfpSearch(params) {
+        return this.post('/media/pfp-search', params);
+    }
+    /**
+     * Search for images and videos by keyword, a page at a time.
+     *
+     * Pass the previous response's `next_cursor` as `cursor`, with the same
+     * `search_term`, to continue. Unlike `pfpSearch`, results already in use are
+     * not removed.
+     *
+     * Requires the `media:search` scope on a restricted key.
+     *
+     * @param params.search_term - What to search for
+     * @param params.count - How many to return (default 24, max 50)
+     * @param params.cursor - `next_cursor` from the previous page
+     */
+    async imageSearch(params) {
+        return this.post('/media/image-search', params);
+    }
 }
 exports.MediaClient = MediaClient;

package/dist/post-failure.d.ts

@@ -0,0 +1,10 @@
+/** Customer-facing posting explanations. No operational diagnostics are exposed. */
+export type PublicPostFailureCode = 'AUDIO_UNAVAILABLE' | 'BACKUP_AUDIO_RETRY_PENDING' | 'AUDIO_RETRY_PENDING' | 'AUDIO_PREPARATION_FAILED' | 'PUBLISHING_RETRY_PENDING' | 'PUBLISHING_BLOCKED' | 'POST_PROCESSING_FAILED' | 'PUBLICATION_CHECK_IN_PROGRESS' | 'PUBLICATION_UNCONFIRMED' | 'POST_RETRY_PENDING' | 'POST_FAILED';
+export type PublicPostRecovery = 'retry_pending' | 'waiting' | 'verifying_publication' | 'stopped';
+export type PublicPostNextAction = 'wait' | 'change_audio' | 'change_audio_or_contact_support' | 'contact_support';
+export interface PublicPostFailure {
+    code: PublicPostFailureCode;
+    message: string;
+    recovery: PublicPostRecovery;
+    next_action: PublicPostNextAction;
+}

package/dist/post-failure.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/posts.d.ts

@@ -1,5 +1,6 @@
 import { BaseClient } from './base';
 import type { ApiResponse } from './types';
+import type { PublicPostFailure } from './post-failure';
 /**
  * Why a post failed, as a stable, client-safe category.
  *
@@ -10,9 +11,13 @@ import type { ApiResponse } from './types';
  * - `capacity_deferred` — no posting capacity was available; the post will be retried
  * - `platform_change` — the social app's interface changed and the post could not complete
  * - `unconfirmed` — posting finished but publication could not be confirmed
+ * - `audio_unavailable` — the chosen sound was not available on the platform and no backup audio was left
  * - `unknown` — the post failed for an unrecognized reason
+ *
+ * A failed post also carries its category on its `tag`, as a trailing
+ * `fail reason: <category>` (removed again when the post is retried).
  */
-export type PostFailCategory = 'device_error' | 'network_error' | 'upload_interrupted' | 'account_issue' | 'capacity_deferred' | 'platform_change' | 'unconfirmed' | 'unknown';
+export type PostFailCategory = 'device_error' | 'network_error' | 'upload_interrupted' | 'account_issue' | 'capacity_deferred' | 'platform_change' | 'unconfirmed' | 'audio_unavailable' | 'unknown';
 export type PostType = 'video' | 'slideshow';
 export type PostStatus = 'draft' | 'scheduled' | 'pending' | 'complete' | 'failed' | 'retrying' | 'deleting' | 'deleted' | 'hidden' | 'require-approval';
 /**
@@ -27,6 +32,8 @@ export interface CaptionOverlay {
     fontSize: number;
 }
 export interface Post {
+    /** Present in list responses; null when there is no current posting issue. */
+    failure?: PublicPostFailure | null;
     id: string;
     account_id: string | null;
     type: PostType;
@@ -42,6 +49,10 @@ export interface Post {
     thumbnail_url: string | null;
     music_post_id: string | null;
     social_audio_id: string | null;
+    /** Fallback sound. Moved into `social_audio_id` (and cleared) if the platform refuses the primary sound. */
+    backup_social_audio_id: string | null;
+    /** When the backup sound was swapped in (ISO 8601), or null if it never was. */
+    backup_audio_used_at: string | null;
     scheduled_at: string | null;
     postUrl?: string;
 }
@@ -64,12 +75,45 @@ export interface GetPostsParams {
     limit?: number;
     /** Opaque cursor from a previous response's `nextCursor`, to fetch the next page. */
     cursor?: string;
+    /** Case-insensitive substring search across caption, title, and account username. */
+    search?: string;
+    platform?: 'tiktok' | 'instagram';
+    postType?: PostType;
+    statuses?: PostStatus[];
+    /** Match any comma-separated tag on the post's account. */
+    accountTags?: string[];
+    /** Match any comma-separated tag stored on the post. */
+    postTags?: string[];
+    socialAudioIds?: string[];
+    phoneTypes?: Array<'physical_iphone' | 'manual_iphone' | 'physical_android' | 'emulated_android' | 'social_api' | 'custom_provider' | 'tracking' | 'clipper'>;
+    sortBy?: PostSortField;
+    sortDirection?: PostSortDirection;
+}
+export type PostSortField = 'created' | 'account' | 'status' | 'title' | 'caption' | 'tag' | 'audio' | 'time' | 'views' | 'likes' | 'comments' | 'shares';
+export type PostSortDirection = 'asc' | 'desc';
+export interface GetPostsPageParams extends GetPostsParams {
+    /** Page size. Defaults to 200 and is capped at 500. */
+    limit?: number;
+}
+export interface PostsPage {
+    posts: Post[];
+    /** Latest stats only for posts in this page. */
+    stats: PostStat[];
+    totalCount: number;
+    /** Distinct comma-split post tags across the organization. */
+    postTags: string[];
+    anyHasTitle: boolean;
+    /** Accounts with a match when `accountIds` is ignored and all other filters remain active. */
+    matchingAccountIds: string[];
+    nextCursor: string | null;
 }
 export interface CreateSlideshowParams {
     accountId: string | null;
     caption?: string;
     title?: string;
     socialAudioId?: string;
+    /** Fallback sound, used once if the platform refuses the primary sound at posting time */
+    backupSocialAudioId?: string;
     postTime?: string;
     imageUrls: string[];
     strict?: boolean;
@@ -95,6 +139,8 @@ export interface CreateVideoParams {
     caption?: string;
     captionOverlays?: CaptionOverlay[];
     socialAudioId?: string;
+    /** Fallback sound, used once if the platform refuses the primary sound at posting time */
+    backupSocialAudioId?: string;
     postTime?: string;
     videoUrl: string;
     strict?: boolean;
@@ -127,6 +173,8 @@ export interface UpdatePostParams {
     caption?: string;
     title?: string;
     socialAudioId?: string;
+    /** Fallback sound, used once if the platform refuses the primary sound at posting time; `null` clears it */
+    backupSocialAudioId?: string | null;
     postTime?: string;
     accountId?: string;
     mediaUrls?: string[];
@@ -153,6 +201,8 @@ export interface CreateDraftParams {
     caption?: string;
     title?: string;
     socialAudioId?: string;
+    /** Fallback sound, used once if the platform refuses the primary sound at posting time */
+    backupSocialAudioId?: string;
     /** Tag stored on the created POST itself (returned as `tag` on the Post object) */
     post_tag?: string;
 }
@@ -179,6 +229,11 @@ export declare class PostsClient extends BaseClient {
      * passed back as `cursor` to fetch the next page, ordered newest-first.
      */
     getPosts(params?: GetPostsParams): Promise<ApiResponse<Post[]>>;
+    /**
+     * Get one server-filtered/sorted page plus table metadata and page-scoped stats.
+     * Unlike getPosts(), this method never falls back to an unbounded response.
+     */
+    getPostsPage(params?: GetPostsPageParams): Promise<ApiResponse<PostsPage>>;
     /**
      * Create a draft post without assigning it to an account
      *
@@ -199,6 +254,7 @@ export declare class PostsClient extends BaseClient {
         postUrl?: string;
         /** Set when status is "failed"; null otherwise. */
         fail_category: PostFailCategory | null;
+        failure: PublicPostFailure | null;
     }>>;
     /**
      * Create a video post

package/dist/posts.js

@@ -15,6 +15,13 @@ class PostsClient extends base_1.BaseClient {
     async getPosts(params) {
         return this.post('/post', params ?? {});
     }
+    /**
+     * Get one server-filtered/sorted page plus table metadata and page-scoped stats.
+     * Unlike getPosts(), this method never falls back to an unbounded response.
+     */
+    async getPostsPage(params = {}) {
+        return this.post('/post', { ...params, includePageMeta: true });
+    }
     /**
      * Create a draft post without assigning it to an account
      *

package/dist/render/compositions/IMessageDmComposition/types.d.ts

@@ -399,10 +399,10 @@ export declare const iMessageDmPropsSchema: z.ZodObject<{
     dynamicCrop: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodAny>>;
     cropVerticalCenter: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
+    time?: string | undefined;
     backgroundColor?: string | undefined;
     lightMode?: boolean | undefined;
     username?: string | undefined;
-    time?: string | undefined;
     profilePicUrl?: string | undefined;
     messages?: {
         text: string;
@@ -582,10 +582,10 @@ export declare const iMessageDmPropsSchema: z.ZodObject<{
     readReceiptLeft?: number | undefined;
     readReceiptRight?: number | undefined;
 }, {
+    time?: string | undefined;
     backgroundColor?: string | undefined;
     lightMode?: boolean | undefined;
     username?: string | undefined;
-    time?: string | undefined;
     profilePicUrl?: string | undefined;
     messages?: {
         text: string;

package/dist/render/types/remotion-composition.d.ts

@@ -29,12 +29,12 @@ export declare const remotionCompositionPortSchema: z.ZodObject<{
     isArray: z.ZodBoolean;
     required: z.ZodBoolean;
 }, "strict", z.ZodTypeAny, {
-    type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+    type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
     id: string;
     isArray: boolean;
     required: boolean;
 }, {
-    type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+    type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
     id: string;
     isArray: boolean;
     required: boolean;
@@ -54,22 +54,22 @@ export declare const remotionCompositionNodeSchema: z.ZodObject<{
         isArray: z.ZodBoolean;
         required: z.ZodBoolean;
     }, "strict", z.ZodTypeAny, {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
     }, {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
     }>, "many">, {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
     }[], {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
@@ -82,7 +82,7 @@ export declare const remotionCompositionNodeSchema: z.ZodObject<{
     selectionMode: null;
     outputType: "video" | "image";
     inputs: {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;
@@ -97,7 +97,7 @@ export declare const remotionCompositionNodeSchema: z.ZodObject<{
     outputMode: "per-input" | "single";
     selectionMode: null;
     inputs: {
-        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        type: "number" | "boolean" | "object" | "video" | "audio" | "image" | "text";
         id: string;
         isArray: boolean;
         required: boolean;

package/dist/tools/accounts.js

@@ -8,6 +8,7 @@ exports.accountTools = [
         description: 'List accounts with optional filters. Returns all accounts if no filters provided.',
         schema: zod_1.z.object({
             tag: zod_1.z.string().optional().describe('Filter by tag'),
+            type: zod_1.z.enum(['tiktok', 'instagram']).optional().describe('Filter by platform'),
             org_group: zod_1.z.string().optional().describe('Filter by org group'),
             user_group: zod_1.z.string().optional().describe('Filter by user group'),
             status: zod_1.z.enum(['uninitialized', 'pending', 'initialized', 'setup', 'warming', 'warmed', 'needs_replacement', 'replacing', 'failed', 'deleted']).optional().describe('Filter by account status'),

package/dist/tools/posts.js

@@ -26,6 +26,7 @@ exports.postTools = [
             videoUrl: zod_1.z.string().describe('URL of the video file'),
             caption: zod_1.z.string().optional().describe('Post caption'),
             socialAudioId: zod_1.z.string().optional().describe('Social audio ID to use'),
+            backupSocialAudioId: zod_1.z.string().optional().describe('Fallback social audio ID, used once if the platform refuses the primary sound'),
             postTime: zod_1.z.string().optional().describe('Scheduled time (ISO 8601). Omit for next available slot.'),
             strict: zod_1.z.boolean().optional().describe('If true with auto-selection, must post at exact time or error'),
             mustPostBy: zod_1.z.string().optional().describe('Latest allowed scheduled time (ISO 8601). Errors if no slot is available before this deadline.'),
@@ -47,6 +48,7 @@ exports.postTools = [
             caption: zod_1.z.string().optional().describe('Post caption'),
             title: zod_1.z.string().optional().describe('Slideshow title'),
             socialAudioId: zod_1.z.string().optional().describe('Social audio ID to use'),
+            backupSocialAudioId: zod_1.z.string().optional().describe('Fallback social audio ID, used once if the platform refuses the primary sound'),
             postTime: zod_1.z.string().optional().describe('Scheduled time (ISO 8601)'),
             strict: zod_1.z.boolean().optional().describe('If true with auto-selection, must post at exact time or error'),
             mustPostBy: zod_1.z.string().optional().describe('Latest allowed scheduled time (ISO 8601). Errors if no slot is available before this deadline.'),
@@ -68,6 +70,7 @@ exports.postTools = [
             caption: zod_1.z.string().optional().describe('Post caption'),
             title: zod_1.z.string().optional().describe('Slideshow title'),
             socialAudioId: zod_1.z.string().optional().describe('Social audio ID'),
+            backupSocialAudioId: zod_1.z.string().optional().describe('Fallback social audio ID, used once if the platform refuses the primary sound'),
             post_tag: zod_1.z.string().optional().describe('Tag stored on the created post'),
         }),
         execute: async (client, params) => {
@@ -92,6 +95,7 @@ exports.postTools = [
             caption: zod_1.z.string().optional().describe('New caption'),
             title: zod_1.z.string().optional().describe('New title (slideshows only)'),
             socialAudioId: zod_1.z.string().optional().describe('New social audio ID'),
+            backupSocialAudioId: zod_1.z.string().nullable().optional().describe('Fallback social audio ID, used once if the platform refuses the primary sound; null clears it'),
             postTime: zod_1.z.string().optional().describe('New scheduled time (ISO 8601)'),
             accountId: zod_1.z.string().optional().describe('Move post to different account'),
             mediaUrls: zod_1.z.array(zod_1.z.string()).optional().describe('New media URLs'),

package/dist/types.d.ts

@@ -16,3 +16,4 @@ export interface ErrorResponse {
     data?: never;
 }
 export type ApiResponse<T> = SuccessResponse<T> | ErrorResponse;
+export type { PublicPostFailureCode, PublicPostRecovery, PublicPostNextAction, PublicPostFailure } from './post-failure';

package/package.json

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