ugcinc 4.17.0 → 4.19.0

package/README.md

@@ -43,7 +43,7 @@ if (res.ok) {
 
 - `client.accounts`: list, create, update, troubleshoot, quarantine/release, and manage account lifecycle
 - `client.posts`: create video/slideshow posts, update them, retry failures, and preview schedule conflicts
-- `client.media`: upload media, create media records, search profile-picture candidates, search images and videos by keyword (`media.imageSearch`, cursor-paged), manage tags/names, and work with social audio
+- `client.media`: upload media, create media records, manage tags/names, and work with social audio
 - `client.stats`: fetch account/post analytics, daily aggregates, top performers, and refresh stats
 - `client.org`: manage organizations, API keys, and integration keys
 - `client.billing`: inspect subscription state and handle account deactivation, replacements, and refunds
@@ -74,20 +74,6 @@ if (posts.ok) {
 }
 ```
 
-## Posting failure quick reference
-
-`posts.getStatus()` returns `failure`; both `getPosts()` and `getPostsPage()` include it on each post. It is `null` when there is no current posting issue. A successful lookup still returns HTTP 200 even if the post failed.
-
-```typescript
-const result = await client.posts.getStatus({ postId: "post_123" });
-if (result.ok && result.data.failure) {
-  const { code, message, recovery, next_action } = result.data.failure;
-  console.log(code, message, recovery, next_action);
-}
-```
-
-See the posting failure reference below for recovery states and messages.
-
 ## Pagination
 
 `accounts.getAccounts()` and `posts.getPosts()` support keyset pagination via `limit`/`cursor`.
@@ -107,28 +93,6 @@ do {
 } while (cursor);
 ```
 
-For interactive tables, `posts.getPostsPage()` keeps filtering and sorting on the server and
-returns page-scoped latest stats plus `totalCount`, organization-wide `postTags`,
-`anyHasTitle`, and `matchingAccountIds`. It supports caption/title/account search; platform,
-post type, status, account, account-tag, post-tag, social-audio, and phone-type filters; and
-sorting by account, status, title, caption, tag, audio presence, scheduled time, or engagement:
-
-```typescript
-const page = await client.posts.getPostsPage({
-  search: "launch",
-  statuses: ["complete"],
-  postTags: ["fall-campaign"],
-  sortBy: "views",
-  sortDirection: "desc",
-  limit: 200,
-});
-
-if (page.ok) {
-  console.log(page.data.posts, page.data.stats, page.data.totalCount);
-  const next = page.data.nextCursor;
-}
-```
-
 ## Caption Overlays
 
 Video posts can carry text overlays to display on the video. Pass `captionOverlays` to
@@ -180,28 +144,6 @@ await client.posts.createVideo({
 await client.posts.updatePost({ postId: "post_123", post_tag: "campaign-august" });
 ```
 
-When a post fails, its category is appended to the tag as `fail reason: <fail_category>` (for
-example `campaign-july fail reason: device_error`), so a post list shows why without a status call
-per post. The suffix is removed again when the post is retried.
-
-## Backup Audio
-
-A post can carry a second sound. If the platform refuses the primary sound at posting time, the
-backup becomes the post's `social_audio_id`, the post is re-attempted once, ` switched to backup
-audio` is appended to its `tag`, and `backup_audio_used_at` is set. With no backup left the post
-fails as `audio_unavailable` and is not retried. Set it with `backupSocialAudioId` on
-`posts.createVideo()`, `posts.createSlideshow()`, `posts.createDraft()`, and `posts.updatePost()`
-(`null` clears it on update).
-
-```typescript
-await client.posts.createSlideshow({
-  accountId: "acc_123",
-  imageUrls: ["https://example.com/img1.jpg"],
-  socialAudioId: "audio_primary",
-  backupSocialAudioId: "audio_fallback",
-});
-```
-
 ## Useful Exports
 
 - `UGCClient` for API access
@@ -220,29 +162,45 @@ For the full endpoint reference, all method signatures, data structures, and wor
 
 MIT
 
-## Posting failure reference
-
-The same `failure` object is returned by status and list responses. It contains a stable `code`, a fixed `message`, a `recovery` state, and `next_action`.
-
-| Recovery | Meaning |
-|---|---|
-| `retry_pending` | The existing post is waiting for another attempt; no execution time is guaranteed. |
-| `waiting` | The existing post is paused until a publishing issue is resolved. |
-| `verifying_publication` | Publication is being checked before another attempt is allowed. |
-| `stopped` | No automatic recovery is indicated. Follow `next_action`. |
-
-`next_action` is `wait`, `change_audio`, `change_audio_or_contact_support`, or `contact_support`. When it is `wait`, do not submit another copy. Account and publishing operations are handled by the service; these messages never ask customers to manage them.
-
-| Code | Message |
-|---|---|
-| `AUDIO_UNAVAILABLE` | The selected sound is unavailable. Choose another sound and retry. |
-| `BACKUP_AUDIO_RETRY_PENDING` | The selected sound was unavailable. Your post is waiting to be retried with its backup sound. |
-| `AUDIO_RETRY_PENDING` | The selected sound could not be loaded. Your post is waiting to be retried. |
-| `AUDIO_PREPARATION_FAILED` | The selected sound could not be prepared for this post. Choose another sound or contact support before retrying. |
-| `PUBLISHING_RETRY_PENDING` | Publishing was temporarily interrupted. Your post is waiting to be retried. No action is needed. |
-| `PUBLISHING_BLOCKED` | A publishing issue prevented this post from proceeding. Contact support for help with this post. |
-| `POST_PROCESSING_FAILED` | A processing error prevented this posting attempt from completing. Contact support before retrying. |
-| `PUBLICATION_CHECK_IN_PROGRESS` | We’re checking whether your post published. Please wait before submitting it again to avoid a duplicate. |
-| `PUBLICATION_UNCONFIRMED` | We couldn’t confirm whether your post published. Contact support before submitting it again to avoid a duplicate. |
-| `POST_RETRY_PENDING` | The previous posting attempt did not complete. Your post is waiting to be retried. No action is needed. |
-| `POST_FAILED` | The posting attempt failed, but we couldn’t determine the cause. Contact support before submitting it again. |
+### Render a supplied Remotion composition
+
+`remotion-composition` accepts a TSX module whose default export is a React
+component. UGC supplies registration, bundling and video rendering. Static imports
+may use `react`, `remotion`, `ugcinc/render`, `ugcinc/render/utils`, and
+`ugcinc/render/types`. Dependencies and UGC components come from the render runtime;
+local-file imports, dynamic imports, npm installation and build scripts are not accepted.
+
+```ts
+await client.automations.runNode({
+  nodeType: 'remotion-composition',
+  config: {
+    source: `import React from 'react';
+import {AbsoluteFill} from 'remotion';
+export default function Video({title}) {
+  return <AbsoluteFill style={{background: 'white', fontSize: 80}}>{title}</AbsoluteFill>;
+}`,
+    width: 1080, height: 1920, fps: 30, durationInFrames: 150,
+    inputProps: {title: 'A new video'},
+  },
+  waitForCompletion: true,
+});
+```
+
+In a workflow, add `inputs: [{id: 'title', type: 'text', isArray: false,
+required: true}]` to create a connected prop. Connected values override
+`inputProps` defaults. Media inputs retain their `{url}` shape. The `output` port
+is a video suitable for Save to Media or Pass Through. Rendering errors identify
+invalid source, unsupported imports or missing inputs. Use normal automation run
+status/logs to inspect failures and the returned video for preview.
+
+Server integrations can also call `submitRemotionCompositionRenderJob` and
+`getRenderJobStatus` with the configured render-worker origin.
+
+### Remotion composition PNG output
+
+The `remotion-composition` workflow node accepts `outputType: "image"` to render
+the first composition frame as a PNG. Its output port becomes `image`; video
+remains the default for existing workflows. Pass sound assets separately for
+photo posts because PNG files contain no audio. The public render helper
+`submitRemotionCompositionRenderJob({...composition, outputType: "image"})`
+supports the same option.

package/dist/accounts.d.ts

@@ -96,8 +96,6 @@ 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/index.d.ts

@@ -75,7 +75,7 @@ export declare class AutomationsClient extends BaseClient {
      * Run a single automation node by compiling it to a minimal inline workflow.
      */
     runNode(params: {
-        nodeType: 'scene-split' | 'generate-image' | 'generate-video';
+        nodeType: 'scene-split' | 'generate-image' | 'generate-video' | 'remotion-composition';
         inputs?: Record<string, PortValue>;
         config?: Record<string, unknown>;
         waitForCompletion?: boolean;

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

@@ -332,6 +332,34 @@ export declare const nodeDefinitions: {
         __TInputs: import("./screenshot-animation").ScreenshotAnimationNodeInputs;
         __TOutputs: import("./screenshot-animation").ScreenshotAnimationNodeOutputs;
     };
+    readonly 'remotion-composition': NodeDefinition<"remotion-composition", "generator", {
+        source: string;
+        outputMode: "per-input" | "single";
+        selectionMode: null;
+        outputType: "video" | "image";
+        inputs: {
+            type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+            id: string;
+            isArray: boolean;
+            required: boolean;
+        }[];
+        width: number;
+        height: number;
+        fps: number;
+        durationInFrames: number;
+        inputProps: Record<string, unknown>;
+    }, {
+        [x: string]: import("../types").PortValue | import("../types").PortValue[];
+    }, {
+        output: import("../types").VideoValue;
+    }, false> & {
+        __TInputs: {
+            [x: string]: import("../types").PortValue | import("../types").PortValue[];
+        };
+        __TOutputs: {
+            output: import("../types").VideoValue;
+        };
+    };
     readonly 'social-audio': NodeDefinition<"social-audio", "source", {
         audioPool: import("../types").SocialAudioValue[];
         selectedMediaIds: string[];

package/dist/automations/nodes/index.js

@@ -38,6 +38,7 @@ const random_route_1 = __importDefault(require("./random-route"));
 const save_to_media_1 = __importDefault(require("./save-to-media"));
 const scene_split_1 = __importDefault(require("./scene-split"));
 const screenshot_animation_1 = __importDefault(require("./screenshot-animation"));
+const remotion_composition_1 = __importDefault(require("./remotion-composition"));
 const social_audio_1 = __importDefault(require("./social-audio"));
 const text_1 = __importDefault(require("./text"));
 const transcript_1 = __importDefault(require("./transcript"));
@@ -79,6 +80,7 @@ exports.nodeDefinitions = {
     'save-to-media': save_to_media_1.default,
     'scene-split': scene_split_1.default,
     'screenshot-animation': screenshot_animation_1.default,
+    'remotion-composition': remotion_composition_1.default,
     'social-audio': social_audio_1.default,
     'text': text_1.default,
     'transcript': transcript_1.default,

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

@@ -0,0 +1,44 @@
+import type { PortValue, VideoValue } from '../types';
+type Inputs = Record<string, PortValue | PortValue[]>;
+type Outputs = {
+    output: VideoValue;
+};
+declare const defaults: {
+    source: string;
+    outputMode: "per-input" | "single";
+    selectionMode: null;
+    outputType: "video" | "image";
+    inputs: {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[];
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+};
+declare const _default: import("./types").NodeDefinition<"remotion-composition", "generator", {
+    source: string;
+    outputMode: "per-input" | "single";
+    selectionMode: null;
+    outputType: "video" | "image";
+    inputs: {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[];
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+}, Inputs, Outputs, false> & {
+    __TInputs: Inputs;
+    __TOutputs: Outputs;
+};
+export default _default;
+export type RemotionCompositionNodeConfig = typeof defaults;

package/dist/automations/nodes/remotion-composition.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const remotion_composition_1 = require("../../render/types/remotion-composition");
+const types_1 = require("./types");
+const defaults = remotion_composition_1.remotionCompositionNodeSchema.parse({
+    source: `import React from 'react';
+import {AbsoluteFill} from 'remotion';
+
+export default function Video({title}: {title: string}) {
+  return <AbsoluteFill style={{background: '#fff', justifyContent: 'center', alignItems: 'center', fontSize: 64}}>{title}</AbsoluteFill>;
+}`,
+    width: 1080, height: 1920, fps: 30, durationInFrames: 150,
+    inputProps: { title: 'Your video' }, inputs: [], outputMode: 'per-input', selectionMode: null,
+});
+const definition = (0, types_1.defineNode)({
+    nodeId: 'remotion-composition', label: 'Remotion Composition',
+    description: 'Render a React/TSX composition as a video or PNG',
+    guide: 'Supply a TSX module with a default-exported React component. UGC registers and bundles it. Import react, remotion or ugcinc/render (including its utils/types subpaths). Configure dimensions, fps, frame count and default inputProps. Add typed input ports whose IDs match component props; connected values override defaults. Media props retain their {url} shape. Source is browser code: no local files, npm installs, require or dynamic imports. Set outputType to video (default) or image (first-frame PNG); use Save to Media or Pass Through. Image output does not embed audio. Run preview uses the same renderer as the final output.',
+    type: 'generator', category: 'Generation', outputModes: ['per-input', 'single'], selectionModes: null,
+    defaults,
+    computePorts: ({ config }) => ({ inputs: config.inputs,
+        outputs: [{ id: 'output', type: config.outputType === 'image' ? 'image' : 'video', isArray: false, required: true }] }),
+    generatePreview: (_config, _ctx, cached) => (0, types_1.preview)({ output: cached?.output ?? null }),
+    validate: config => {
+        const result = remotion_composition_1.remotionCompositionNodeSchema.safeParse(config);
+        return result.success ? [] : result.error.issues.map(issue => `${issue.path.join('.')}: ${issue.message}`);
+    },
+});
+// Runtime markers preserve the registry's typed input/output inference without casts.
+const inputTypes = {};
+const outputTypes = { output: { url: '' } };
+exports.default = Object.assign(definition, { __TInputs: inputTypes, __TOutputs: outputTypes });

package/dist/index.d.ts

@@ -13,7 +13,10 @@ export { AutomationsClient } from './automations';
 export { MediaClient } from './media';
 export { CommentsClient } from './comments';
 export { BillingClient } from './billing';
-export { submitImageRenderJob, submitVideoRenderJob, getRenderJobStatus, submitDeduplicationJob, submitSceneSplitJob, submitScreenshotAnimationRenderJob, submitAutoCaptionRenderJob, submitInstagramDmRenderJob, submitIMessageDmRenderJob, } from './render';
+export { submitImageRenderJob, submitVideoRenderJob, getRenderJobStatus, submitDeduplicationJob, submitSceneSplitJob, submitScreenshotAnimationRenderJob, submitRemotionCompositionRenderJob, submitAutoCaptionRenderJob, submitInstagramDmRenderJob, submitIMessageDmRenderJob, } from './render';
+export { remotionCompositionSchema, remotionCompositionNodeSchema, remotionCompositionPortSchema, REMOTION_COMPOSITION_IMPORTS, parseRemotionPropsJson } from './render/types/remotion-composition';
+export type { RemotionCompositionInput } from './render/types/remotion-composition';
+export type { RemotionCompositionNodeConfig } from './automations/nodes/remotion-composition';
 export { areTypesCompatible, computePortsForNode, computePortsWithPreviews, computeAllNodePorts, computeAllNodePortsWithPreviews, getInputPreviewValue, getAllNodes, getNodeByType, getOutputSchema, createNode, deriveConnections, addConnection, removeConnection, removeNodeConnections, cleanupStaleConnections, getConnectedSource, getForEachContext, checkCrossContextViolation, getDownstreamNodes, getNodesDownstreamOfSet, getCapturedNodes, validateWorkflow, getErrorNodeIds, getPortErrorsForNode, hasMissingTriggerError, hasMissingTerminalError, getWorkflowOutputSchema, resolveNodePreview, computeAllNodePreviews, computePreviewMap, updatePreviewMapForConnection, removePreviewForConnection, getPreviewValue, shuffleNodePreview, type PreviewMap, type NodePreviewOutputs, type Connection, generateNodeName, extractWorkflowConfig, type WorkflowTemplateData, } from './automations/graph-controller';
 export { nodeDefinitions, internalNodeTypes, isAsyncExecutor, formatPortType, isPortType } from './automations/types';
 export { getNodeDefinition, getAllNodeDefinitions, getFlowControlNodeTypes, getCapturedSourceNodeTypes } from './automations/nodes';
@@ -27,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, GetPostsPageParams, PostsPage, PostSortField, PostSortDirection, CreateDraftParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
+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 { 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, PfpSearchParams, PfpSearchResponse, PfpCandidate, ImageSearchParams, ImageSearchResult, ImageSearchResponse, ImageSearchVideoFormat, } 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, } 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';
@@ -81,4 +84,3 @@ 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/index.js

@@ -5,9 +5,9 @@
  * Official TypeScript/JavaScript client for the UGC Inc API
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.updatePreviewMapForConnection = exports.computePreviewMap = exports.computeAllNodePreviews = exports.resolveNodePreview = exports.getWorkflowOutputSchema = exports.hasMissingTerminalError = exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.getCapturedNodes = exports.getNodesDownstreamOfSet = exports.getDownstreamNodes = exports.checkCrossContextViolation = exports.getForEachContext = exports.getConnectedSource = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.createNode = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.getInputPreviewValue = exports.computeAllNodePortsWithPreviews = exports.computeAllNodePorts = exports.computePortsWithPreviews = exports.computePortsForNode = exports.areTypesCompatible = exports.submitIMessageDmRenderJob = exports.submitInstagramDmRenderJob = exports.submitAutoCaptionRenderJob = exports.submitScreenshotAnimationRenderJob = exports.submitSceneSplitJob = exports.submitDeduplicationJob = exports.getRenderJobStatus = exports.submitVideoRenderJob = exports.submitImageRenderJob = exports.BillingClient = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
-exports.IfLogicOperators = exports.resolvePath = exports.indexExpressionToString = exports.indexExpressionToIndexes = exports.resolveUnknownPath = exports.getOutputTypeFromCategory = exports.parseOpenAPIOutputPath = exports.parseOpenAPIInputs = exports.mapOpenAPIType = exports.nodeConfigToCaptionStyle = exports.HttpMethods = exports.prepareImageComposerInput = exports.substituteVariables = exports.processTemplate = exports.extractTemplateVariables = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = exports.getModelDurations = exports.getModelAspectRatios = exports.ALL_VIDEO_MODELS = exports.getAvailableInputModes = exports.hasReferenceVariant = exports.getReferenceModelId = exports.hasFirstLastFrameVariant = exports.getFirstLastFrameModelId = exports.hasImageToVideoVariant = exports.getImageToVideoModelId = exports.isImageToVideoModel = exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = exports.getEditModelId = exports.isEditModel = exports.getCapturedSourceNodeTypes = exports.getFlowControlNodeTypes = exports.getAllNodeDefinitions = exports.getNodeDefinition = exports.isPortType = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.extractWorkflowConfig = exports.generateNodeName = exports.shuffleNodePreview = exports.getPreviewValue = exports.removePreviewForConnection = void 0;
-exports.prepareVideoComposerInput = exports.formatDateTag = exports.outputFieldsToZod = exports.outputFieldToZod = exports.LLMProviders = exports.applyLogicOperator = void 0;
+exports.hasMissingTriggerError = exports.getPortErrorsForNode = exports.getErrorNodeIds = exports.validateWorkflow = exports.getCapturedNodes = exports.getNodesDownstreamOfSet = exports.getDownstreamNodes = exports.checkCrossContextViolation = exports.getForEachContext = exports.getConnectedSource = exports.cleanupStaleConnections = exports.removeNodeConnections = exports.removeConnection = exports.addConnection = exports.deriveConnections = exports.createNode = exports.getOutputSchema = exports.getNodeByType = exports.getAllNodes = exports.getInputPreviewValue = exports.computeAllNodePortsWithPreviews = exports.computeAllNodePorts = exports.computePortsWithPreviews = exports.computePortsForNode = exports.areTypesCompatible = exports.parseRemotionPropsJson = exports.REMOTION_COMPOSITION_IMPORTS = exports.remotionCompositionPortSchema = exports.remotionCompositionNodeSchema = exports.remotionCompositionSchema = exports.submitIMessageDmRenderJob = exports.submitInstagramDmRenderJob = exports.submitAutoCaptionRenderJob = exports.submitRemotionCompositionRenderJob = exports.submitScreenshotAnimationRenderJob = exports.submitSceneSplitJob = exports.submitDeduplicationJob = exports.getRenderJobStatus = exports.submitVideoRenderJob = exports.submitImageRenderJob = exports.BillingClient = exports.CommentsClient = exports.MediaClient = exports.AutomationsClient = exports.OrganizationClient = exports.StatsClient = exports.PostsClient = exports.TasksClient = exports.AccountsClient = exports.UGCClient = void 0;
+exports.parseOpenAPIOutputPath = exports.parseOpenAPIInputs = exports.mapOpenAPIType = exports.nodeConfigToCaptionStyle = exports.HttpMethods = exports.prepareImageComposerInput = exports.substituteVariables = exports.processTemplate = exports.extractTemplateVariables = exports.PortIdSchema = exports.normalizeToPortId = exports.portIdToTitle = exports.isValidPortId = exports.portId = exports.selectFromPool = exports.getModelDurations = exports.getModelAspectRatios = exports.ALL_VIDEO_MODELS = exports.getAvailableInputModes = exports.hasReferenceVariant = exports.getReferenceModelId = exports.hasFirstLastFrameVariant = exports.getFirstLastFrameModelId = exports.hasImageToVideoVariant = exports.getImageToVideoModelId = exports.isImageToVideoModel = exports.IMAGE_ASPECT_RATIOS = exports.ALL_IMAGE_MODELS = exports.getEditModelId = exports.isEditModel = exports.getCapturedSourceNodeTypes = exports.getFlowControlNodeTypes = exports.getAllNodeDefinitions = exports.getNodeDefinition = exports.isPortType = exports.formatPortType = exports.isAsyncExecutor = exports.internalNodeTypes = exports.nodeDefinitions = exports.extractWorkflowConfig = exports.generateNodeName = exports.shuffleNodePreview = exports.getPreviewValue = exports.removePreviewForConnection = exports.updatePreviewMapForConnection = exports.computePreviewMap = exports.computeAllNodePreviews = exports.resolveNodePreview = exports.getWorkflowOutputSchema = exports.hasMissingTerminalError = void 0;
+exports.prepareVideoComposerInput = exports.formatDateTag = exports.outputFieldsToZod = exports.outputFieldToZod = exports.LLMProviders = exports.applyLogicOperator = exports.IfLogicOperators = exports.resolvePath = exports.indexExpressionToString = exports.indexExpressionToIndexes = exports.resolveUnknownPath = exports.getOutputTypeFromCategory = void 0;
 // =============================================================================
 // Client Exports
 // =============================================================================
@@ -39,9 +39,16 @@ Object.defineProperty(exports, "getRenderJobStatus", { enumerable: true, get: fu
 Object.defineProperty(exports, "submitDeduplicationJob", { enumerable: true, get: function () { return render_1.submitDeduplicationJob; } });
 Object.defineProperty(exports, "submitSceneSplitJob", { enumerable: true, get: function () { return render_1.submitSceneSplitJob; } });
 Object.defineProperty(exports, "submitScreenshotAnimationRenderJob", { enumerable: true, get: function () { return render_1.submitScreenshotAnimationRenderJob; } });
+Object.defineProperty(exports, "submitRemotionCompositionRenderJob", { enumerable: true, get: function () { return render_1.submitRemotionCompositionRenderJob; } });
 Object.defineProperty(exports, "submitAutoCaptionRenderJob", { enumerable: true, get: function () { return render_1.submitAutoCaptionRenderJob; } });
 Object.defineProperty(exports, "submitInstagramDmRenderJob", { enumerable: true, get: function () { return render_1.submitInstagramDmRenderJob; } });
 Object.defineProperty(exports, "submitIMessageDmRenderJob", { enumerable: true, get: function () { return render_1.submitIMessageDmRenderJob; } });
+var remotion_composition_1 = require("./render/types/remotion-composition");
+Object.defineProperty(exports, "remotionCompositionSchema", { enumerable: true, get: function () { return remotion_composition_1.remotionCompositionSchema; } });
+Object.defineProperty(exports, "remotionCompositionNodeSchema", { enumerable: true, get: function () { return remotion_composition_1.remotionCompositionNodeSchema; } });
+Object.defineProperty(exports, "remotionCompositionPortSchema", { enumerable: true, get: function () { return remotion_composition_1.remotionCompositionPortSchema; } });
+Object.defineProperty(exports, "REMOTION_COMPOSITION_IMPORTS", { enumerable: true, get: function () { return remotion_composition_1.REMOTION_COMPOSITION_IMPORTS; } });
+Object.defineProperty(exports, "parseRemotionPropsJson", { enumerable: true, get: function () { return remotion_composition_1.parseRemotionPropsJson; } });
 // =============================================================================
 // Graph Controller Exports
 // =============================================================================

package/dist/media.d.ts

@@ -131,57 +131,6 @@ 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;
@@ -264,32 +213,4 @@ 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,37 +96,5 @@ 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/posts.d.ts

@@ -1,6 +1,5 @@
 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.
  *
@@ -11,13 +10,9 @@ import type { PublicPostFailure } from './post-failure';
  * - `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' | 'audio_unavailable' | 'unknown';
+export type PostFailCategory = 'device_error' | 'network_error' | 'upload_interrupted' | 'account_issue' | 'capacity_deferred' | 'platform_change' | 'unconfirmed' | 'unknown';
 export type PostType = 'video' | 'slideshow';
 export type PostStatus = 'draft' | 'scheduled' | 'pending' | 'complete' | 'failed' | 'retrying' | 'deleting' | 'deleted' | 'hidden' | 'require-approval';
 /**
@@ -32,8 +27,6 @@ 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;
@@ -49,10 +42,6 @@ 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;
 }
@@ -75,45 +64,12 @@ 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;
@@ -139,8 +95,6 @@ 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;
@@ -173,8 +127,6 @@ 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[];
@@ -201,8 +153,6 @@ 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;
 }
@@ -229,11 +179,6 @@ 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
      *
@@ -254,7 +199,6 @@ 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,13 +15,6 @@ 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

@@ -385,29 +385,29 @@ export declare const iMessageDmPropsSchema: z.ZodObject<{
         groupWithPrevious: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         text: string;
-        sender: "user" | "recipient";
         id: string;
+        sender: "user" | "recipient";
         imageUrl?: string | undefined;
         groupWithPrevious?: boolean | undefined;
     }, {
         text: string;
-        sender: "user" | "recipient";
         id: string;
+        sender: "user" | "recipient";
         imageUrl?: string | undefined;
         groupWithPrevious?: boolean | undefined;
     }>, "many">>;
     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;
-        sender: "user" | "recipient";
         id: string;
+        sender: "user" | "recipient";
         imageUrl?: string | undefined;
         groupWithPrevious?: boolean | undefined;
     }[] | undefined;
@@ -582,15 +582,15 @@ 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;
-        sender: "user" | "recipient";
         id: string;
+        sender: "user" | "recipient";
         imageUrl?: string | undefined;
         groupWithPrevious?: boolean | undefined;
     }[] | undefined;

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

@@ -0,0 +1,123 @@
+import { z } from 'zod';
+/** A React component module. UGC supplies the root and bundled dependencies. */
+export declare const remotionCompositionSchema: z.ZodObject<{
+    source: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    inputProps: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+}, {
+    source: string;
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+}>;
+export type RemotionCompositionInput = z.infer<typeof remotionCompositionSchema>;
+export declare const remotionCompositionPortSchema: z.ZodObject<{
+    id: z.ZodEffects<z.ZodString, string, string>;
+    type: z.ZodEnum<["text", "number", "boolean", "image", "video", "audio", "object"]>;
+    isArray: z.ZodBoolean;
+    required: z.ZodBoolean;
+}, "strict", z.ZodTypeAny, {
+    type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+    id: string;
+    isArray: boolean;
+    required: boolean;
+}, {
+    type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+    id: string;
+    isArray: boolean;
+    required: boolean;
+}>;
+export declare const remotionCompositionNodeSchema: z.ZodObject<{
+    source: z.ZodString;
+    width: z.ZodNumber;
+    height: z.ZodNumber;
+    fps: z.ZodNumber;
+    durationInFrames: z.ZodNumber;
+    inputProps: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+} & {
+    outputType: z.ZodDefault<z.ZodEnum<["video", "image"]>>;
+    inputs: z.ZodEffects<z.ZodArray<z.ZodObject<{
+        id: z.ZodEffects<z.ZodString, string, string>;
+        type: z.ZodEnum<["text", "number", "boolean", "image", "video", "audio", "object"]>;
+        isArray: z.ZodBoolean;
+        required: z.ZodBoolean;
+    }, "strict", z.ZodTypeAny, {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }, {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }>, "many">, {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[], {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[]>;
+    outputMode: z.ZodEnum<["single", "per-input"]>;
+    selectionMode: z.ZodNull;
+}, "strict", z.ZodTypeAny, {
+    source: string;
+    outputMode: "per-input" | "single";
+    selectionMode: null;
+    outputType: "video" | "image";
+    inputs: {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[];
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+}, {
+    source: string;
+    outputMode: "per-input" | "single";
+    selectionMode: null;
+    inputs: {
+        type: "number" | "boolean" | "object" | "video" | "image" | "audio" | "text";
+        id: string;
+        isArray: boolean;
+        required: boolean;
+    }[];
+    width: number;
+    height: number;
+    fps: number;
+    durationInFrames: number;
+    inputProps: Record<string, unknown>;
+    outputType?: "video" | "image" | undefined;
+}>;
+export declare const REMOTION_COMPOSITION_IMPORTS: string[];
+export declare function parseRemotionPropsJson({ text }: {
+    text: string;
+}): {
+    ok: false;
+    message: string;
+    value?: undefined;
+} | {
+    ok: true;
+    value: Record<string, unknown>;
+    message?: undefined;
+};

package/dist/render/types/remotion-composition.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.REMOTION_COMPOSITION_IMPORTS = exports.remotionCompositionNodeSchema = exports.remotionCompositionPortSchema = exports.remotionCompositionSchema = void 0;
+exports.parseRemotionPropsJson = parseRemotionPropsJson;
+const zod_1 = require("zod");
+/** A React component module. UGC supplies the root and bundled dependencies. */
+exports.remotionCompositionSchema = zod_1.z.object({
+    source: zod_1.z.string().trim().min(1).max(200000),
+    width: zod_1.z.number().int().min(16).max(3840).multipleOf(2),
+    height: zod_1.z.number().int().min(16).max(3840).multipleOf(2),
+    fps: zod_1.z.number().int().min(1).max(60),
+    durationInFrames: zod_1.z.number().int().min(1).max(18000),
+    inputProps: zod_1.z.record(zod_1.z.unknown()),
+}).strict();
+exports.remotionCompositionPortSchema = zod_1.z.object({
+    id: zod_1.z.string().regex(/^[A-Za-z][A-Za-z0-9_]*$/, 'Use a simple prop name').refine(id => !['constructor', 'prototype', '__proto__'].includes(id), 'Reserved prop name'),
+    type: zod_1.z.enum(['text', 'number', 'boolean', 'image', 'video', 'audio', 'object']),
+    isArray: zod_1.z.boolean(),
+    required: zod_1.z.boolean(),
+}).strict();
+exports.remotionCompositionNodeSchema = exports.remotionCompositionSchema.extend({
+    outputType: zod_1.z.enum(['video', 'image']).default('video'),
+    inputs: zod_1.z.array(exports.remotionCompositionPortSchema).max(64).refine(ports => new Set(ports.map(port => port.id)).size === ports.length, 'Prop names must be unique'),
+    outputMode: zod_1.z.enum(['single', 'per-input']),
+    selectionMode: zod_1.z.null(),
+});
+exports.REMOTION_COMPOSITION_IMPORTS = [
+    'react', 'react/jsx-runtime', 'react/jsx-dev-runtime', 'remotion',
+    'ugcinc/render', 'ugcinc/render/utils', 'ugcinc/render/types',
+];
+function parseRemotionPropsJson({ text }) {
+    try {
+        const value = JSON.parse(text);
+        const parsed = zod_1.z.record(zod_1.z.unknown()).safeParse(value);
+        if (!parsed.success)
+            return { ok: false, message: 'Props must be a JSON object' };
+        return { ok: true, value: parsed.data };
+    }
+    catch {
+        return { ok: false, message: 'Enter valid JSON' };
+    }
+}

package/dist/render.d.ts

@@ -12,6 +12,11 @@ import type { VideoEditorNodeConfig, DeduplicationInput } from './render/types';
 import type { CaptionWord, CaptionStyle } from './render/types/caption';
 import type { ImageEditorNodeConfig } from './automations/nodes/image-composer';
 import type { CreateDmMessage } from './automations/nodes/create-dm';
+import { type RemotionCompositionInput } from './render/types/remotion-composition';
+/** Submit TSX source and props; UGC owns registration and bundling. */
+export declare function submitRemotionCompositionRenderJob(params: RemotionCompositionInput & {
+    outputType?: 'video' | 'image';
+}): Promise<ApiResponse<RenderJobResponse>>;
 export interface RenderJobResponse {
     job_id: string;
     status: string;

package/dist/render.js

@@ -9,6 +9,7 @@
  * variable set fails fast.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.submitRemotionCompositionRenderJob = submitRemotionCompositionRenderJob;
 exports.submitImageRenderJob = submitImageRenderJob;
 exports.submitVideoRenderJob = submitVideoRenderJob;
 exports.getRenderJobStatus = getRenderJobStatus;
@@ -18,6 +19,8 @@ exports.submitScreenshotAnimationRenderJob = submitScreenshotAnimationRenderJob;
 exports.submitAutoCaptionRenderJob = submitAutoCaptionRenderJob;
 exports.submitInstagramDmRenderJob = submitInstagramDmRenderJob;
 exports.submitIMessageDmRenderJob = submitIMessageDmRenderJob;
+const zod_1 = require("zod");
+const remotion_composition_1 = require("./render/types/remotion-composition");
 function renderBaseUrl() {
     const url = process.env.UGC_RENDER_URL?.trim();
     if (!url) {
@@ -26,6 +29,28 @@ function renderBaseUrl() {
     return url.replace(/\/+$/, '');
 }
 const MAX_RETRIES = 3;
+/** Submit TSX source and props; UGC owns registration and bundling. */
+async function submitRemotionCompositionRenderJob(params) {
+    const { outputType = 'video', ...composition } = params;
+    if (outputType !== 'video' && outputType !== 'image')
+        return { ok: false, code: 400, message: 'Output type must be video or image' };
+    const parsed = remotion_composition_1.remotionCompositionSchema.safeParse(composition);
+    if (!parsed.success)
+        return { ok: false, code: 400, message: parsed.error.message };
+    const response = await renderFetch('/submit-job', {
+        method: 'POST', headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({ config: { _compositionType: 'remotion-composition', ...parsed.data },
+            output_type: outputType, video_codec: 'h264', image_format: 'png' }),
+    });
+    const data = await response.json();
+    const result = zod_1.z.object({ job_id: zod_1.z.string(), status: zod_1.z.string(), output_type: zod_1.z.string(), message: zod_1.z.string() }).safeParse(data);
+    if (!response.ok || !result.success || result.data.status === 'error') {
+        const error = zod_1.z.object({ error: zod_1.z.string() }).safeParse(data);
+        return { ok: false, code: response.ok ? 400 : response.status,
+            message: error.success ? error.data.error : 'Failed to submit Remotion composition' };
+    }
+    return { ok: true, code: 200, message: 'Remotion composition submitted', data: result.data };
+}
 /**
  * Fetch wrapper for every render worker call: retries network errors, 429 and
  * 5xx with exponential backoff; returns 4xx responses to the caller unchanged.

package/dist/tools/accounts.js

@@ -8,7 +8,6 @@ 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,7 +26,6 @@ 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.'),
@@ -48,7 +47,6 @@ 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.'),
@@ -70,7 +68,6 @@ 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) => {
@@ -95,7 +92,6 @@ 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,4 +16,3 @@ 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.17.0",
+  "version": "4.19.0",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",

package/dist/post-failure.d.ts

@@ -1,10 +0,0 @@
-/** 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

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