ugcinc 1.0.5 → 1.0.6

package/README.md

@@ -101,19 +101,41 @@ 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:** Nicknames can only be updated once every 7 days.
+
+```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 nickname can be updated again
+  console.error(response.message);
 }
 ```
 
@@ -556,7 +578,7 @@ const response = await client.accounts.getStatus({
 
 #### `client.accounts.updateInfo(params)`
 
-Update account profile information.
+Update account metadata (tag, org_group, user_group).
 
 **Endpoint:** `POST /accounts/update-info`
 
@@ -565,15 +587,62 @@ 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:** Nicknames can only be updated **once every 7 days**. If you attempt to update a nickname before the 7-day 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 +652,34 @@ Returns a success message when the profile update task has been successfully cre
 }
 ```
 
+**Error Response (Nickname Restriction):**
+
+If you attempt to update the nickname too soon:
+
+```typescript
+{
+  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"
+}
+```
+
 **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 nickname restriction 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
  */
@@ -21,9 +21,17 @@ export declare class AccountsClient extends BaseClient {
      */
     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

@@ -31,10 +31,17 @@ class AccountsClient extends base_1.BaseClient {
         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
@@ -118,11 +117,15 @@ export interface GetAccountStatusParams {
 }
 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.6",
   "description": "TypeScript/JavaScript client for the UGC Inc API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",