ugcinc 1.8.0 → 2.1.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/types.d.ts

@@ -142,12 +142,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,12 +161,15 @@ 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[];

package/package.json

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