ugcinc 1.0.6 → 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[]
 }
@@ -121,7 +125,10 @@ if (response.ok) {
 
 Update account social profile information (avatar, nickname, bio).
 
-**Important:** Nicknames can only be updated once every 7 days.
+**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({
@@ -134,7 +141,7 @@ const response = await client.accounts.updateSocial({
 if (response.ok) {
   console.log(response.data.message);
 } else {
-  // Error response includes when nickname can be updated again
+  // Error response includes when the field can be updated again
   console.error(response.message);
 }
 ```
@@ -524,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`
 
@@ -534,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:**
 
@@ -568,10 +575,20 @@ 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}`);
+  });
+}
 ```
 
 ---
@@ -638,7 +655,14 @@ Update account social profile (avatar, nickname, bio).
 | `nickName` | `string` | No | New display name |
 | `bio` | `string` | No | New bio text |
 
-**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.
+**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 }>`
 
@@ -652,16 +676,31 @@ Returns a success message when the profile update task has been successfully cre
 }
 ```
 
-**Error Response (Nickname Restriction):**
+**Error Response (Rate Limit):**
 
-If you attempt to update the nickname too soon:
+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:**
@@ -677,7 +716,7 @@ const response = await client.accounts.updateSocial({
 if (response.ok) {
   console.log(response.data.message);
 } else {
-  // Handle nickname restriction error
+  // Handle rate limit error
   console.error(response.message);
 }
 ```

package/dist/accounts.d.ts

@@ -17,9 +17,9 @@ 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 metadata (tag, org_group, user_group)
      */

package/dist/accounts.js

@@ -25,10 +25,10 @@ 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 metadata (tag, org_group, user_group)

package/dist/types.d.ts

@@ -112,7 +112,7 @@ export interface RefreshAccountStatsParams {
     user_group?: string;
 }
 export interface GetAccountStatusParams {
-    accountId: string;
+    accountIds?: string[];
     includeCompleted?: boolean;
 }
 export interface UpdateAccountInfoParams {

package/package.json

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