ugcinc 4.5.76 → 4.5.77

package/dist/index.d.ts

@@ -27,7 +27,7 @@ export type { InputType } from './automations/nodes/types';
 export type { ClientConfig } from './base';
 export type { Account, AccountStat, AccountTask, EditProfileInfo, GetAccountsParams, GetAccountStatsParams, GetAccountStatusParams, AccountInfoUpdate, UpdateAccountInfoParams, AccountInfoUpdateResult, UpdateAccountInfoResponse, AccountSocialUpdate, UpdateAccountSocialParams, AccountSocialUpdateResult, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, NicheSwitchUpdate, NicheSwitchParams, NicheSwitchResult, NicheSwitchResponse, CreateAccountInput, CreateAccountsParams, CreateAccountResult, CreateAccountsResponse, TroubleshootFailReason, TroubleshootAccount, TroubleshootParams, } from './accounts';
 export type { TaskType, Task, GetTasksParams } from './tasks';
-export type { PostType, PostStatus, Post, PostStat, GetPostsParams, CreateSlideshowParams, GetPostStatsParams, GetPostStatusParams, CreateVideoParams, UpdatePostParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, SetPostStatusParams, SetPostStatusResponse, PreviewScheduleEntry, PreviewScheduleParams, PreviewScheduleResult, } from './posts';
+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 { 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';

package/dist/posts.d.ts

@@ -1,10 +1,10 @@
 import { BaseClient } from './base';
 import type { ApiResponse } from './types';
 export type PostType = 'video' | 'slideshow';
-export type PostStatus = 'scheduled' | 'pending' | 'complete' | 'failed' | 'retrying' | 'deleting' | 'deleted' | 'hidden' | 'require-approval';
+export type PostStatus = 'draft' | 'scheduled' | 'pending' | 'complete' | 'failed' | 'retrying' | 'deleting' | 'deleted' | 'hidden' | 'require-approval';
 export interface Post {
     id: string;
-    account_id: string;
+    account_id: string | null;
     type: PostType;
     status: PostStatus;
     social_id: string | null;
@@ -102,6 +102,13 @@ export interface PreviewScheduleEntry {
     postTime: string;
     postId?: string;
 }
+export interface CreateDraftParams {
+    type: 'video' | 'slideshow';
+    mediaUrls: string[];
+    caption?: string;
+    title?: string;
+    socialAudioId?: string;
+}
 export interface PreviewScheduleParams {
     entries: PreviewScheduleEntry[];
     excludePostIds?: string[];
@@ -122,6 +129,13 @@ export declare class PostsClient extends BaseClient {
      * Get posts with optional filters
      */
     getPosts(params?: GetPostsParams): Promise<ApiResponse<Post[]>>;
+    /**
+     * Create a draft post without assigning it to an account
+     *
+     * Draft posts have no account or schedule. Use updatePost() to assign
+     * an account and schedule time, which transitions the draft to "scheduled" status.
+     */
+    createDraft(params: CreateDraftParams): Promise<ApiResponse<Post>>;
     /**
      * Create a slideshow post
      */
@@ -152,8 +166,9 @@ export declare class PostsClient extends BaseClient {
     /**
      * Update a post in place
      *
-     * Only posts with status "scheduled" or "failed" can be updated.
+     * Only posts with status "draft", "scheduled", or "failed" can be updated.
      * If updating a failed post, it will be reset to "scheduled" status.
+     * If updating a draft post with both accountId and postTime, it transitions to "scheduled".
      * The post type (video/slideshow) cannot be changed.
      */
     updatePost(params: UpdatePostParams): Promise<ApiResponse<Post>>;

package/dist/posts.js

@@ -12,6 +12,15 @@ class PostsClient extends base_1.BaseClient {
     async getPosts(params) {
         return this.post('/post', params ?? {});
     }
+    /**
+     * Create a draft post without assigning it to an account
+     *
+     * Draft posts have no account or schedule. Use updatePost() to assign
+     * an account and schedule time, which transitions the draft to "scheduled" status.
+     */
+    async createDraft(params) {
+        return this.post('/post/draft', params);
+    }
     /**
      * Create a slideshow post
      */
@@ -46,8 +55,9 @@ class PostsClient extends base_1.BaseClient {
     /**
      * Update a post in place
      *
-     * Only posts with status "scheduled" or "failed" can be updated.
+     * Only posts with status "draft", "scheduled", or "failed" can be updated.
      * If updating a failed post, it will be reset to "scheduled" status.
+     * If updating a draft post with both accountId and postTime, it transitions to "scheduled".
      * The post type (video/slideshow) cannot be changed.
      */
     async updatePost(params) {

package/dist/tools/posts.js

@@ -53,6 +53,20 @@ exports.postTools = [
             return client.posts.createSlideshow(params);
         },
     },
+    {
+        name: 'create_draft_post',
+        description: 'Create a draft post without assigning it to an account. Use update_post to assign an account and schedule time later.',
+        schema: zod_1.z.object({
+            type: zod_1.z.enum(['video', 'slideshow']).describe('Post type'),
+            mediaUrls: zod_1.z.array(zod_1.z.string()).describe('Array of media URLs'),
+            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'),
+        }),
+        execute: async (client, params) => {
+            return client.posts.createDraft(params);
+        },
+    },
     {
         name: 'get_post_status',
         description: 'Get the status of a specific post. Returns the post URL when complete.',
@@ -65,7 +79,7 @@ exports.postTools = [
     },
     {
         name: 'update_post',
-        description: 'Update a scheduled or failed post. Only posts with status "scheduled" or "failed" can be updated. Failed posts are reset to "scheduled".',
+        description: 'Update a draft, scheduled, or failed post. Draft posts transition to "scheduled" when given both accountId and postTime. Failed posts are reset to "scheduled".',
         schema: zod_1.z.object({
             postId: zod_1.z.string().describe('Post ID to update'),
             caption: zod_1.z.string().optional().describe('New caption'),

package/package.json

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