ugcinc 2.74.1 → 2.75.0

package/README.md

@@ -121,20 +121,63 @@ if (response.ok) {
 
 **Update account info (tags, groups, keywords, profiles, description, warmup version):**
 ```typescript
-// Update account metadata
+// Update multiple accounts at once
 const response = await client.accounts.updateInfo({
-  accountId: 'account-uuid',
-  tag: 'production',
-  org_group: 'team-a',
-  user_group: 'creators',
-  keywords: 'fitness,health,workout',
-  profiles: '@fitinfluencer1,@healthguru2',
-  description: 'health and wellness content',
-  warmupVersion: 'v1_smart'  // 'original' or 'v1_smart'
+  updates: [
+    {
+      accountId: 'account-uuid-1',
+      tag: 'production',
+      org_group: 'team-a',
+      user_group: 'creators',
+      keywords: 'fitness,health,workout',
+      profiles: '@fitinfluencer1,@healthguru2',
+      description: 'health and wellness content',
+      warmupVersion: 'v1_smart'  // 'original' or 'v1_smart'
+    },
+    {
+      accountId: 'account-uuid-2',
+      tag: 'staging',
+      warmupVersion: 'original'
+    }
+  ]
+});
+
+if (response.ok) {
+  console.log(`Updated ${response.data.successful} accounts`);
+  if (response.data.failed > 0) {
+    console.log('Failed updates:', response.data.results.filter(r => !r.success));
+  }
+}
+```
+
+**Update social profile (avatar, nickname, bio):**
+```typescript
+// Update social profiles for multiple accounts at once
+// Note: Rate limits apply per account:
+// - Nickname: once every 7 days
+// - Avatar: once every 24 hours
+// - Bio: once every 24 hours
+const response = await client.accounts.updateSocial({
+  updates: [
+    {
+      accountId: 'account-uuid-1',
+      nickName: 'Cool Creator ✨',
+      bio: 'Content creator 🎥 | Follow for daily tips'
+    },
+    {
+      accountId: 'account-uuid-2',
+      avatarUrl: 'https://example.com/new-avatar.jpg'
+    }
+  ]
 });
 
 if (response.ok) {
-  console.log('Account info updated:', response.data.account);
+  console.log(`Profile updates scheduled for ${response.data.successful} accounts`);
+  if (response.data.failed > 0) {
+    response.data.results.filter(r => !r.success).forEach(r => {
+      console.log(`Account ${r.accountId} failed: ${r.error}`);
+    });
+  }
 }
 ```
 

package/dist/accounts.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Account, AccountTask, GetAccountsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, ApiResponse } from './types';
+import type { Account, AccountTask, GetAccountsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountInfoResponse, UpdateAccountSocialParams, UpdateAccountSocialResponse, DeleteAccountPostsParams, DeleteAccountPostsResponse, ResetWarmupParams, ResetWarmupResponse, ApiResponse } from './types';
 /**
  * Client for managing accounts
  */
@@ -13,19 +13,38 @@ export declare class AccountsClient extends BaseClient {
      */
     getStatus(params?: GetAccountStatusParams): Promise<ApiResponse<AccountTask[]>>;
     /**
-     * Update account metadata (tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion)
+     * Update account metadata for one or more accounts
+     * Supports: tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion
+     *
+     * @example
+     * // Update multiple accounts
+     * const response = await client.accounts.updateInfo({
+     *   updates: [
+     *     { accountId: 'acc_1', tag: 'premium', keywords: 'fitness,health' },
+     *     { accountId: 'acc_2', tag: 'standard', warmupVersion: 'v1_smart' }
+     *   ]
+     * });
      */
-    updateInfo(params: UpdateAccountInfoParams): Promise<ApiResponse<{
-        message: string;
-        account: Account;
-    }>>;
+    updateInfo(params: UpdateAccountInfoParams): Promise<ApiResponse<UpdateAccountInfoResponse>>;
     /**
-     * Update account social profile (avatar, nickname, bio)
-     * Note: Nickname can only be updated once every 7 days
+     * Update account social profile for one or more accounts
+     * Supports: avatarUrl, nickName, bio
+     *
+     * Note: Rate limits apply per account:
+     * - Nickname: once every 7 days
+     * - Avatar: once every 24 hours
+     * - Bio: once every 24 hours
+     *
+     * @example
+     * // Update multiple accounts
+     * const response = await client.accounts.updateSocial({
+     *   updates: [
+     *     { accountId: 'acc_1', nickName: 'New Name 1', bio: 'New bio 1' },
+     *     { accountId: 'acc_2', avatarUrl: 'https://example.com/avatar.jpg' }
+     *   ]
+     * });
      */
-    updateSocial(params: UpdateAccountSocialParams): Promise<ApiResponse<{
-        message: string;
-    }>>;
+    updateSocial(params: UpdateAccountSocialParams): Promise<ApiResponse<UpdateAccountSocialResponse>>;
     /**
      * Delete all posts from one or more accounts
      * Creates a clear_posts task that automatically deletes all posts from the account(s)

package/dist/accounts.js

@@ -19,14 +19,38 @@ class AccountsClient extends base_1.BaseClient {
         return this.post('/accounts/status', params ?? {});
     }
     /**
-     * Update account metadata (tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion)
+     * Update account metadata for one or more accounts
+     * Supports: tag, org_group, user_group, keywords, profiles, description, warmupVersion, postVersion
+     *
+     * @example
+     * // Update multiple accounts
+     * const response = await client.accounts.updateInfo({
+     *   updates: [
+     *     { accountId: 'acc_1', tag: 'premium', keywords: 'fitness,health' },
+     *     { accountId: 'acc_2', tag: 'standard', warmupVersion: 'v1_smart' }
+     *   ]
+     * });
      */
     async updateInfo(params) {
         return this.post('/accounts/update-info', params);
     }
     /**
-     * Update account social profile (avatar, nickname, bio)
-     * Note: Nickname can only be updated once every 7 days
+     * Update account social profile for one or more accounts
+     * Supports: avatarUrl, nickName, bio
+     *
+     * Note: Rate limits apply per account:
+     * - Nickname: once every 7 days
+     * - Avatar: once every 24 hours
+     * - Bio: once every 24 hours
+     *
+     * @example
+     * // Update multiple accounts
+     * const response = await client.accounts.updateSocial({
+     *   updates: [
+     *     { accountId: 'acc_1', nickName: 'New Name 1', bio: 'New bio 1' },
+     *     { accountId: 'acc_2', avatarUrl: 'https://example.com/avatar.jpg' }
+     *   ]
+     * });
      */
     async updateSocial(params) {
         return this.post('/accounts/update-social', params);

package/dist/types.d.ts

@@ -124,7 +124,10 @@ export interface GetAccountStatusParams {
     accountIds?: string[];
     includeCompleted?: boolean;
 }
-export interface UpdateAccountInfoParams {
+/**
+ * Individual account info update for bulk operations
+ */
+export interface AccountInfoUpdate {
     accountId: string;
     tag?: string;
     org_group?: string;
@@ -135,12 +138,62 @@ export interface UpdateAccountInfoParams {
     warmupVersion?: 'original' | 'v1_smart';
     postVersion?: 'original' | 'v1_custom';
 }
-export interface UpdateAccountSocialParams {
+/**
+ * Parameters for updating account info (bulk)
+ */
+export interface UpdateAccountInfoParams {
+    updates: AccountInfoUpdate[];
+}
+/**
+ * Result for individual account info update
+ */
+export interface AccountInfoUpdateResult {
+    accountId: string;
+    success: boolean;
+    account?: Account;
+    error?: string;
+}
+/**
+ * Response for bulk account info updates
+ */
+export interface UpdateAccountInfoResponse {
+    message: string;
+    successful: number;
+    failed: number;
+    results: AccountInfoUpdateResult[];
+}
+/**
+ * Individual account social update for bulk operations
+ */
+export interface AccountSocialUpdate {
     accountId: string;
     avatarUrl?: string;
     nickName?: string;
     bio?: string;
 }
+/**
+ * Parameters for updating account social profile (bulk)
+ */
+export interface UpdateAccountSocialParams {
+    updates: AccountSocialUpdate[];
+}
+/**
+ * Result for individual account social update
+ */
+export interface AccountSocialUpdateResult {
+    accountId: string;
+    success: boolean;
+    error?: string;
+}
+/**
+ * Response for bulk account social updates
+ */
+export interface UpdateAccountSocialResponse {
+    message: string;
+    successful: number;
+    failed: number;
+    results: AccountSocialUpdateResult[];
+}
 export interface DeleteAccountPostsParams {
     accountIds: string[];
 }

package/package.json

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