ugcinc 1.8.0 → 2.2.0

package/README.md

@@ -50,8 +50,12 @@ For complete API documentation, including all endpoints, parameters, and example
 - Update social profile (avatar, nickname, bio)
 
 ### Posts
-- Create video posts
-- Create slideshow posts
+- Create video posts (with specific account or auto-select)
+- Create slideshow posts (with specific account or auto-select)
+- **Auto-selection modes:**
+  - `strict: true` - Picks least recently posted account, must post at exact time
+  - `strict: false` - Picks account with closest available time slot
+- Auto-account selection supports filtering by tag, user_group, and org_group
 - Get post status (includes platform URL when complete - TikTok or Instagram)
 - Get posts with filters (by accountIds, postIds, date range)
 - Get post statistics
@@ -132,11 +136,73 @@ if (response.ok) {
 
 **Create a video post:**
 ```typescript
+// Create video post with specific account
 const response = await client.posts.createVideo({
   accountId: 'account-uuid',
   videoUrl: 'https://example.com/video.mp4',
   caption: 'Check out this video!',
 });
+
+// Auto-select with strict=true: picks least recently posted account, must post at exact time
+const response = await client.posts.createVideo({
+  accountId: null,
+  videoUrl: 'https://example.com/video.mp4',
+  caption: 'Auto-selected account!',
+  postTime: '2024-01-15T10:00:00Z',
+  strict: true  // Will error if that account can't post at exactly 10:00 AM
+});
+
+// Auto-select with strict=false: picks account with closest available time slot
+const response = await client.posts.createVideo({
+  accountId: null,
+  videoUrl: 'https://example.com/video.mp4',
+  caption: 'Posts as soon as possible!',
+  postTime: '2024-01-15T10:00:00Z',
+  strict: false  // Finds account that can post closest to 10:00 AM
+});
+
+// Auto-select with filters (tag, user_group, org_group)
+const response = await client.posts.createVideo({
+  accountId: null,
+  videoUrl: 'https://example.com/video.mp4',
+  caption: 'Filtered auto-selection!',
+  tag: 'production',
+  org_group: 'group1',
+  strict: false
+});
+```
+
+**Create a slideshow post:**
+```typescript
+// Create slideshow with specific account
+const response = await client.posts.createSlideshow({
+  accountId: 'account-uuid',
+  imageUrls: [
+    'https://example.com/image1.jpg',
+    'https://example.com/image2.jpg',
+    'https://example.com/image3.jpg'
+  ],
+  caption: 'Amazing slideshow!',
+});
+
+// Auto-select with strict=true: picks least recently posted account
+const response = await client.posts.createSlideshow({
+  accountId: null,
+  imageUrls: ['image1.jpg', 'image2.jpg'],
+  caption: 'Posts at exact time or errors',
+  postTime: '2024-01-15T14:00:00Z',
+  strict: true,
+  user_group: 'creators'
+});
+
+// Auto-select with strict=false: picks account with closest available time
+const response = await client.posts.createSlideshow({
+  accountId: null,
+  imageUrls: ['image1.jpg', 'image2.jpg'],
+  caption: 'Posts at nearest available time',
+  postTime: '2024-01-15T14:00:00Z',
+  strict: false
+});
 ```
 
 **Get posts with filters:**

package/dist/posts.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Post, GetPostsParams, CreateSlideshowParams, GetPostStatusParams, CreateVideoParams, DeletePostsParams, RetryPostsParams, ApiResponse } from './types';
+import type { Post, GetPostsParams, CreateSlideshowParams, GetPostStatusParams, CreateVideoParams, DeletePostsParams, DeletePostsResponse, RetryPostsParams, ApiResponse } from './types';
 /**
  * Client for managing posts
  */
@@ -26,12 +26,15 @@ export declare class PostsClient extends BaseClient {
     createVideo(params: CreateVideoParams): Promise<ApiResponse<Post>>;
     /**
      * Delete posts
-     * Note: Posts with status "complete" (already posted) cannot be deleted
+     *
+     * Handles both unpublished and published posts:
+     * - Unpublished posts (scheduled, pending, failed, retrying) are deleted immediately
+     * - Published posts (complete) trigger a deletion flow that removes the post from the social platform
+     *
+     * For published posts being deleted, the status changes to "deleting" and then "deleted" once complete.
+     * Monitor deletion progress using getStatus().
      */
-    deletePosts(params: DeletePostsParams): Promise<ApiResponse<{
-        deleted: number;
-        ids: string[];
-    }>>;
+    deletePosts(params: DeletePostsParams): Promise<ApiResponse<DeletePostsResponse>>;
     /**
      * Retry failed posts
      * Note: Only posts with status "failed" can be retried

package/dist/posts.js

@@ -32,7 +32,13 @@ class PostsClient extends base_1.BaseClient {
     }
     /**
      * Delete posts
-     * Note: Posts with status "complete" (already posted) cannot be deleted
+     *
+     * Handles both unpublished and published posts:
+     * - Unpublished posts (scheduled, pending, failed, retrying) are deleted immediately
+     * - Published posts (complete) trigger a deletion flow that removes the post from the social platform
+     *
+     * For published posts being deleted, the status changes to "deleting" and then "deleted" once complete.
+     * Monitor deletion progress using getStatus().
      */
     async deletePosts(params) {
         return this.post('/post/delete', params);

package/dist/types.d.ts

@@ -30,6 +30,9 @@ export interface Account {
     warmup_enabled: boolean | null;
     keywords: string | null;
     profiles: string | null;
+    niches: string | null;
+    age_range: string | null;
+    sex: string | null;
     status: 'pending' | 'initialized' | 'setup' | 'error';
 }
 export interface AccountStat {
@@ -142,12 +145,15 @@ export interface GetPostsParams {
     endDate?: string;
 }
 export interface CreateSlideshowParams {
-    accountId: string;
+    accountId: string | null;
     caption?: string;
     musicPostId?: string;
     postTime?: string;
     imageUrls: string[];
     strict?: boolean;
+    tag?: string;
+    user_group?: string;
+    org_group?: string;
 }
 export interface GetPostStatsParams {
     postIds?: string[];
@@ -158,16 +164,29 @@ export interface GetPostStatusParams {
     postId: string;
 }
 export interface CreateVideoParams {
-    accountId: string;
+    accountId: string | null;
     caption?: string;
     musicPostId?: string;
     postTime?: string;
     videoUrl: string;
     strict?: boolean;
+    tag?: string;
+    user_group?: string;
+    org_group?: string;
 }
 export interface DeletePostsParams {
     postIds: string[];
 }
+export interface DeletePostsResponse {
+    deleted: number;
+    deleting: number;
+    deletedIds: string[];
+    deletingIds: string[];
+    errors?: Array<{
+        postId: string;
+        error: string;
+    }>;
+}
 export interface RetryPostsParams {
     postIds: string[];
 }

package/package.json

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