ugcinc 1.0.5 → 1.0.7

package/README.md

@@ -86,14 +86,18 @@ if (response.ok) {
 
 #### Get Account Status
 
-Get the status of tasks for a specific account.
+Get the status of tasks for one or more accounts.
 
 ```typescript
+// Get status for specific accounts
 const response = await client.accounts.getStatus({
-  accountId: 'account-id',
+  accountIds: ['account-id-1', 'account-id-2'],
   includeCompleted: false
 });
 
+// Get status for all accounts
+const allResponse = await client.accounts.getStatus();
+
 if (response.ok) {
   console.log(response.data); // AccountTask[]
 }
@@ -101,19 +105,44 @@ if (response.ok) {
 
 #### Update Account Info
 
-Update account profile information.
+Update account metadata (tag, org_group, user_group).
 
 ```typescript
 const response = await client.accounts.updateInfo({
+  accountId: 'account-id',
+  tag: 'influencer',
+  org_group: 'group1',
+  user_group: 'users1'
+});
+
+if (response.ok) {
+  console.log(response.data.message);
+  console.log(response.data.account); // Updated account
+}
+```
+
+#### Update Account Social Profile
+
+Update account social profile information (avatar, nickname, bio).
+
+**Important Restrictions:**
+- **Nickname:** Can only be updated once every **7 days**
+- **Avatar:** Can only be updated once every **24 hours**
+- **Bio:** Can only be updated once every **24 hours**
+
+```typescript
+const response = await client.accounts.updateSocial({
   accountId: 'account-id',
   nickName: 'New Name',
   bio: 'New bio text',
-  avatarUrl: 'https://example.com/avatar.jpg',
-  site: 'https://example.com'
+  avatarUrl: 'https://example.com/avatar.jpg'
 });
 
 if (response.ok) {
   console.log(response.data.message);
+} else {
+  // Error response includes when the field can be updated again
+  console.error(response.message);
 }
 ```
 
@@ -502,9 +531,9 @@ if (response.ok) {
 
 ---
 
-#### `client.accounts.getStatus(params)`
+#### `client.accounts.getStatus(params?)`
 
-Get account status and pending tasks.
+Get account status and pending tasks for one or more accounts.
 
 **Endpoint:** `POST /accounts/status`
 
@@ -512,12 +541,12 @@ Get account status and pending tasks.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `accountId` | `string` | **Yes** | Account ID to check status for |
+| `accountIds` | `string[]` | No | Array of account IDs to check status for (omit to get all accounts) |
 | `includeCompleted` | `boolean` | No | Include completed tasks (default: false) |
 
 **Returns:** `ApiResponse<AccountTask[]>`
 
-Returns an array of AccountTask objects showing pending and (optionally) completed tasks for the specified account. Tasks include profile edits and other account-level operations.
+Returns an array of AccountTask objects showing pending and (optionally) completed tasks for the specified accounts. If no `accountIds` are provided, returns tasks for all accounts in your organization. Tasks include profile edits and other account-level operations.
 
 **AccountTask Object:**
 
@@ -546,17 +575,27 @@ Returns an array of AccountTask objects showing pending and (optionally) complet
 **Example:**
 
 ```typescript
+// Get status for specific accounts
 const response = await client.accounts.getStatus({
-  accountId: 'account-id',
+  accountIds: ['account-1', 'account-2'],
   includeCompleted: true
 });
+
+// Get status for all accounts
+const allResponse = await client.accounts.getStatus();
+
+if (response.ok) {
+  response.data.forEach(task => {
+    console.log(`Task ${task.id} for account ${task.account_id}: ${task.status}`);
+  });
+}
 ```
 
 ---
 
 #### `client.accounts.updateInfo(params)`
 
-Update account profile information.
+Update account metadata (tag, org_group, user_group).
 
 **Endpoint:** `POST /accounts/update-info`
 
@@ -565,15 +604,69 @@ Update account profile information.
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
 | `accountId` | `string` | **Yes** | Account ID to update |
-| `scheduledTime` | `string` | No | When to schedule the update (ISO 8601 format) |
+| `tag` | `string` | No | New tag value for categorization |
+| `org_group` | `string` | No | New organization group identifier |
+| `user_group` | `string` | No | New user group identifier |
+
+**Note:** At least one of `tag`, `org_group`, or `user_group` must be provided.
+
+**Returns:** `ApiResponse<{ message: string; account: Account }>`
+
+Returns a success message and the updated account object. The update is applied immediately to the database.
+
+**Response Object:**
+
+```typescript
+{
+  message: string;  // Success message (e.g., "Account info updated successfully")
+  account: Account; // Updated account object with new values
+}
+```
+
+**Example:**
+
+```typescript
+const response = await client.accounts.updateInfo({
+  accountId: 'account-id',
+  tag: 'influencer',
+  org_group: 'group1',
+  user_group: 'users1'
+});
+
+if (response.ok) {
+  console.log(response.data.account.tag); // 'influencer'
+}
+```
+
+---
+
+#### `client.accounts.updateSocial(params)`
+
+Update account social profile (avatar, nickname, bio).
+
+**Endpoint:** `POST /accounts/update-social`
+
+**Parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `accountId` | `string` | **Yes** | Account ID to update |
 | `avatarUrl` | `string` | No | New avatar/profile picture URL |
 | `nickName` | `string` | No | New display name |
 | `bio` | `string` | No | New bio text |
-| `site` | `string` | No | New website URL |
+
+**Important Update Restrictions:**
+
+Each profile field has a cooldown period before it can be updated again:
+- **Nickname:** Can only be updated **once every 7 days**
+- **Avatar:** Can only be updated **once every 24 hours**
+- **Bio:** Can only be updated **once every 24 hours**
+
+If you attempt to update a field before its cooldown period has elapsed, the API will return an error with details about when the next update is allowed.
 
 **Returns:** `ApiResponse<{ message: string }>`
 
-Returns a success message when the profile update task has been successfully created and queued. The actual profile update will be processed asynchronously.
+Returns a success message when the profile update task has been successfully created and queued. The actual profile update will be processed asynchronously through the GeeLark API.
 
 **Response Object:**
 
@@ -583,15 +676,49 @@ Returns a success message when the profile update task has been successfully cre
 }
 ```
 
+**Error Response (Rate Limit):**
+
+If you attempt to update a field too soon, you'll receive an error like:
+
+```typescript
+// Nickname restriction (7 days)
+{
+  ok: false,
+  code: 400,
+  message: "Nickname can only be updated once every 7 days. Last update was X days ago. You can update again in Y day(s) on YYYY-MM-DD"
+}
+
+// Avatar restriction (24 hours)
+{
+  ok: false,
+  code: 400,
+  message: "Avatar can only be updated once every 24 hours. Last update was X hours ago. You can update again in Y hour(s) on YYYY-MM-DD"
+}
+
+// Bio restriction (24 hours)
+{
+  ok: false,
+  code: 400,
+  message: "Bio can only be updated once every 24 hours. Last update was X hours ago. You can update again in Y hour(s) on YYYY-MM-DD"
+}
+```
+
 **Example:**
 
 ```typescript
-const response = await client.accounts.updateInfo({
+const response = await client.accounts.updateSocial({
   accountId: 'account-id',
   nickName: 'Cool Creator',
   bio: 'Content creator 🎥',
   avatarUrl: 'https://storage.example.com/avatar.jpg'
 });
+
+if (response.ok) {
+  console.log(response.data.message);
+} else {
+  // Handle rate limit error
+  console.error(response.message);
+}
 ```
 
 ---

package/dist/accounts.d.ts

@@ -1,5 +1,5 @@
 import { BaseClient } from './base';
-import type { Account, AccountStat, AccountTask, GetAccountsParams, GetAccountStatsParams, RefreshAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, ApiResponse } from './types';
+import type { Account, AccountStat, AccountTask, GetAccountsParams, GetAccountStatsParams, RefreshAccountStatsParams, GetAccountStatusParams, UpdateAccountInfoParams, UpdateAccountSocialParams, ApiResponse } from './types';
 /**
  * Client for managing accounts
  */
@@ -17,13 +17,21 @@ export declare class AccountsClient extends BaseClient {
      */
     refreshStats(params?: RefreshAccountStatsParams): Promise<ApiResponse<AccountStat[]>>;
     /**
-     * Get account status (tasks)
+     * Get account status (tasks) for one or more accounts
      */
-    getStatus(params: GetAccountStatusParams): Promise<ApiResponse<AccountTask[]>>;
+    getStatus(params?: GetAccountStatusParams): Promise<ApiResponse<AccountTask[]>>;
     /**
-     * Update account profile information
+     * Update account metadata (tag, org_group, user_group)
      */
     updateInfo(params: UpdateAccountInfoParams): Promise<ApiResponse<{
         message: string;
+        account: Account;
+    }>>;
+    /**
+     * Update account social profile (avatar, nickname, bio)
+     * Note: Nickname can only be updated once every 7 days
+     */
+    updateSocial(params: UpdateAccountSocialParams): Promise<ApiResponse<{
+        message: string;
     }>>;
 }

package/dist/accounts.js

@@ -25,16 +25,23 @@ class AccountsClient extends base_1.BaseClient {
         return this.post('/accounts/stats/refresh', params ?? {});
     }
     /**
-     * Get account status (tasks)
+     * Get account status (tasks) for one or more accounts
      */
     async getStatus(params) {
-        return this.post('/accounts/status', params);
+        return this.post('/accounts/status', params ?? {});
     }
     /**
-     * Update account profile information
+     * Update account metadata (tag, org_group, user_group)
      */
     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
+     */
+    async updateSocial(params) {
+        return this.post('/accounts/update-social', params);
+    }
 }
 exports.AccountsClient = AccountsClient;

package/dist/posts.d.ts

@@ -17,7 +17,8 @@ export declare class PostsClient extends BaseClient {
      */
     getStats(params?: GetPostStatsParams): Promise<ApiResponse<PostStat[]>>;
     /**
-     * Refresh post statistics from TikTok/Instagram API
+  
+    * Refresh post statistics from TikTok/Instagram API
      */
     refreshStats(params?: RefreshPostStatsParams): Promise<ApiResponse<PostStat[]>>;
     /**

package/dist/posts.js

@@ -25,7 +25,8 @@ class PostsClient extends base_1.BaseClient {
         return this.post('/post/stats', params ?? {});
     }
     /**
-     * Refresh post statistics from TikTok/Instagram API
+  
+    * Refresh post statistics from TikTok/Instagram API
      */
     async refreshStats(params) {
         return this.post('/post/stats/refresh', params ?? {});

package/dist/types.d.ts

@@ -49,7 +49,6 @@ export interface EditProfileInfo {
     avatarUrl?: string;
     nickName?: string;
     bio?: string;
-    site?: string;
 }
 /**
  * Task types
@@ -113,16 +112,20 @@ export interface RefreshAccountStatsParams {
     user_group?: string;
 }
 export interface GetAccountStatusParams {
-    accountId: string;
+    accountIds?: string[];
     includeCompleted?: boolean;
 }
 export interface UpdateAccountInfoParams {
     accountId: string;
-    scheduledTime?: string;
+    tag?: string;
+    org_group?: string;
+    user_group?: string;
+}
+export interface UpdateAccountSocialParams {
+    accountId: string;
     avatarUrl?: string;
     nickName?: string;
     bio?: string;
-    site?: string;
 }
 export interface GetTasksParams {
     accountIds?: string[];

package/package.json

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