adspower-browser 2.1.2-beta.1 → 2.1.2-beta.3

package/README.MD

@@ -142,7 +142,7 @@ ads close-browser <profile_id>                   # Or JSON: profile_id? | profil
 ads create-browser '{"group_id":"0","user_proxy_config":{"proxy_soft":"no_proxy"},...}'  # group_id + account field required; proxy optional (defaults to no_proxy; proxyid takes priority over user_proxy_config when both given)
 ads update-browser '{"profile_id":"...",...}'    # profile_id required
 ads delete-browser '{"profile_id":["..."]}'     # profile_id required
-ads get-recycle-bin-list '{}'                   # page?, limit? (1-100, default 1). Last 30 days only
+ads get-recycle-bin-list '{}'                   # page?, limit? (1-100). Omit either to use the Local API backend default. Last 30 days only
 ads restore-recycle-bin '{"profile_id":"...","group_id":"123"}'  # profile_id or profile_no, group_id required
 ads get-browser-list '{}'                       # CLI defaults to page=1,limit=200. Or group_id?, limit?, page?, profile_id[]?, profile_no[]?, sort_type?, sort_order?, tag_ids?, tags_filter?, name?, name_filter?
 ads get-opened-browser                          # No params
@@ -170,6 +170,17 @@ ads update-group '{"group_id":"1","group_name":"New Name"}'    # group_id + grou
 ads get-group-list '{}'                         # group_name?, page_size?, page?
 ```
 
+### Member
+
+```bash
+ads create-member '{"user_group_id":"...","email":"alice@example.com","password":"password1","identity":4}'  # identity: 2 admin, 3 manager, 4 staff; manager optional; member only for identity 3
+ads update-member '{"user_id":"...","name":"Alice"}'   # omit to keep; empty name/manager/remark/member/authorized_group can clear; do not empty email or identity
+ads reset-member-password '{"user_id":"..."}'          # unbind_phone?: 0|1; new_password is in the response
+ads delete-member '{"user_id":"..."}'                  # permanent, not recoverable
+ads get-member-list '{}'                               # user_group_id?, user_id[]?, email[]?, page?, limit? (default 50, max 200)
+ads get-member-group-list '{}'                         # page?, limit? (default 50, max 200)
+```
+
 ### Application (categories)
 
 ```bash

package/cli/index.js

@@ -614,8 +614,8 @@ var LOCAL_API_CONTRACTS = {
     method: "POST",
     path: "/api/v2/browser-profile/recycle-bin/list",
     params: {
-      page: { apiName: "page", location: "body", default: 1 },
-      limit: { apiName: "limit", location: "body", default: 1 }
+      page: { apiName: "page", location: "body" },
+      limit: { apiName: "limit", location: "body" }
     }
   },
   "restore-recycle-bin": {
@@ -745,6 +745,73 @@ var LOCAL_API_CONTRACTS = {
       page_size: { apiName: "page_size", location: "query" }
     }
   },
+  "create-member": {
+    method: "POST",
+    path: "/api/v2/user/create",
+    params: {
+      user_group_id: { apiName: "user_group_id", location: "body" },
+      name: { apiName: "name", location: "body" },
+      email: { apiName: "email", location: "body" },
+      password: { apiName: "password", location: "body" },
+      identity: { apiName: "identity", location: "body" },
+      manager: { apiName: "manager", location: "body" },
+      member: { apiName: "member", location: "body" },
+      authorized_group: { apiName: "authorized_group", location: "body" },
+      profile_limit: { apiName: "profile_limit", location: "body" },
+      remark: { apiName: "remark", location: "body" }
+    }
+  },
+  "update-member": {
+    method: "POST",
+    path: "/api/v2/user/update",
+    params: {
+      user_id: { apiName: "user_id", location: "body" },
+      user_group_id: { apiName: "user_group_id", location: "body" },
+      name: { apiName: "name", location: "body" },
+      email: { apiName: "email", location: "body" },
+      identity: { apiName: "identity", location: "body" },
+      manager: { apiName: "manager", location: "body" },
+      member: { apiName: "member", location: "body" },
+      authorized_group: { apiName: "authorized_group", location: "body" },
+      group_update_type: { apiName: "group_update_type", location: "body" },
+      profile_limit: { apiName: "profile_limit", location: "body" },
+      remark: { apiName: "remark", location: "body" }
+    }
+  },
+  "reset-member-password": {
+    method: "POST",
+    path: "/api/v2/user/reset_password",
+    params: {
+      user_id: { apiName: "user_id", location: "body" },
+      unbind_phone: { apiName: "unbind_phone", location: "body" }
+    }
+  },
+  "delete-member": {
+    method: "POST",
+    path: "/api/v2/user/delete",
+    params: {
+      user_id: { apiName: "user_id", location: "body" }
+    }
+  },
+  "get-member-list": {
+    method: "GET",
+    path: "/api/v2/user/list",
+    params: {
+      user_group_id: { apiName: "user_group_id", location: "query" },
+      user_id: { apiName: "user_id", location: "query" },
+      email: { apiName: "email", location: "query" },
+      page: { apiName: "page", location: "query" },
+      limit: { apiName: "limit", location: "query" }
+    }
+  },
+  "get-member-group-list": {
+    method: "GET",
+    path: "/api/v2/user-group/list",
+    params: {
+      page: { apiName: "page", location: "query" },
+      limit: { apiName: "limit", location: "query" }
+    }
+  },
   "create-proxy": {
     method: "POST",
     path: "/api/v2/proxy-list/create",
@@ -917,6 +984,12 @@ var API_ENDPOINTS = {
   GET_GROUP_LIST: LOCAL_API_CONTRACTS["get-group-list"].path,
   CREATE_GROUP: LOCAL_API_CONTRACTS["create-group"].path,
   UPDATE_GROUP: LOCAL_API_CONTRACTS["update-group"].path,
+  CREATE_MEMBER: LOCAL_API_CONTRACTS["create-member"].path,
+  UPDATE_MEMBER: LOCAL_API_CONTRACTS["update-member"].path,
+  RESET_MEMBER_PASSWORD: LOCAL_API_CONTRACTS["reset-member-password"].path,
+  DELETE_MEMBER: LOCAL_API_CONTRACTS["delete-member"].path,
+  GET_MEMBER_LIST: LOCAL_API_CONTRACTS["get-member-list"].path,
+  GET_MEMBER_GROUP_LIST: LOCAL_API_CONTRACTS["get-member-group-list"].path,
   GET_APPLICATION_LIST: LOCAL_API_CONTRACTS["get-application-list"].path,
   GET_TAG_LIST: LOCAL_API_CONTRACTS["get-tag-list"].path,
   CREATE_TAG: LOCAL_API_CONTRACTS["create-tag"].path,
@@ -1074,6 +1147,42 @@ var TOOL_INTENT_BY_NAME = {
     triggersEn: "list groups, search group name",
     triggersZh: "\u5206\u7EC4\u5217\u8868,\u67E5\u7EC4\u540D"
   },
+  "create-member": {
+    intentEn: "Create a team member (admin / manager / staff).",
+    intentZh: "\u65B0\u5EFA\u56E2\u961F\u6210\u5458\uFF08\u7BA1\u7406\u5458 / \u7ECF\u7406 / \u5458\u5DE5\uFF09\u3002",
+    triggersEn: "create member, add user, invite teammate, new staff",
+    triggersZh: "\u521B\u5EFA\u6210\u5458,\u6DFB\u52A0\u7528\u6237,\u9080\u8BF7\u540C\u4E8B,\u65B0\u5EFA\u5458\u5DE5"
+  },
+  "update-member": {
+    intentEn: "Update an existing team member (role, groups, profile limit).",
+    intentZh: "\u7F16\u8F91\u5DF2\u6709\u56E2\u961F\u6210\u5458\uFF08\u8EAB\u4EFD\u3001\u6388\u6743\u5206\u7EC4\u3001\u73AF\u5883\u989D\u5EA6\u7B49\uFF09\u3002",
+    triggersEn: "edit member, change role, update staff, authorized group",
+    triggersZh: "\u7F16\u8F91\u6210\u5458,\u6539\u8EAB\u4EFD,\u66F4\u65B0\u7528\u6237,\u6388\u6743\u5206\u7EC4"
+  },
+  "reset-member-password": {
+    intentEn: "Reset a team member password; new_password is returned in the response.",
+    intentZh: "\u91CD\u7F6E\u6210\u5458\u5BC6\u7801\uFF0C\u6210\u529F\u54CD\u5E94\u91CC\u8FD4\u56DE\u660E\u6587 new_password\u3002",
+    triggersEn: "reset password, new password, unbind phone",
+    triggersZh: "\u91CD\u7F6E\u5BC6\u7801,\u6539\u5BC6\u7801,\u89E3\u7ED1\u624B\u673A"
+  },
+  "delete-member": {
+    intentEn: "Permanently delete a team member by user_id. Hard delete, not recoverable.",
+    intentZh: "\u6309 user_id \u5F7B\u5E95\u5220\u9664\u56E2\u961F\u6210\u5458\uFF0C\u4E0D\u53EF\u6062\u590D\u3002",
+    triggersEn: "remove member, delete user, delete staff, hard delete",
+    triggersZh: "\u5220\u9664\u6210\u5458,\u79FB\u9664\u7528\u6237,\u5220\u5458\u5DE5,\u5F7B\u5E95\u5220\u9664"
+  },
+  "get-member-list": {
+    intentEn: "List or search team members (pagination, user_id, email).",
+    intentZh: "\u5206\u9875/\u6761\u4EF6\u67E5\u8BE2\u56E2\u961F\u6210\u5458\u5217\u8868\u3002",
+    triggersEn: "list members, search users, query staff, member list",
+    triggersZh: "\u6210\u5458\u5217\u8868,\u67E5\u8BE2\u7528\u6237,\u641C\u7D22\u5458\u5DE5,\u5217\u51FA\u6210\u5458"
+  },
+  "get-member-group-list": {
+    intentEn: "List member groups / roles with pagination.",
+    intentZh: "\u5206\u9875\u67E5\u8BE2\u6210\u5458\u5206\u7EC4\uFF08\u89D2\u8272\uFF09\u5217\u8868\u3002",
+    triggersEn: "member groups, user groups, role list",
+    triggersZh: "\u6210\u5458\u5206\u7EC4,\u7528\u6237\u7EC4,\u89D2\u8272\u5217\u8868"
+  },
   "check-status": {
     intentEn: "Check Local API availability on this machine.",
     intentZh: "\u68C0\u6D4B\u672C\u673A Local API \u662F\u5426\u53EF\u7528\u3002",
@@ -1595,6 +1704,73 @@ var groupHandlers = {
   }
 };
 
+// ../core/src/handlers/member.ts
+function serializeMemberListQuery(params) {
+  const queryParams = { ...params };
+  if (Array.isArray(params.user_id)) {
+    queryParams.user_id = JSON.stringify(params.user_id);
+  }
+  if (Array.isArray(params.email)) {
+    queryParams.email = JSON.stringify(params.email);
+  }
+  return queryParams;
+}
+var memberHandlers = {
+  async createMember(params) {
+    const requestBody = buildRequestBodyFor("create-member", params);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.CREATE_MEMBER}`, requestBody);
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async updateMember(params) {
+    const requestBody = buildRequestBodyFor("update-member", params);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.UPDATE_MEMBER}`, requestBody);
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async resetMemberPassword(params) {
+    const requestBody = buildRequestBodyFor("reset-member-password", params);
+    const response = await getApiClient().post(
+      `${getLocalApiBase()}${API_ENDPOINTS.RESET_MEMBER_PASSWORD}`,
+      requestBody
+    );
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async deleteMember(params) {
+    const requestBody = buildRequestBodyFor("delete-member", params);
+    const response = await getApiClient().post(`${getLocalApiBase()}${API_ENDPOINTS.DELETE_MEMBER}`, requestBody);
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async getMemberList(params) {
+    const query = buildQueryParamsFor("get-member-list", serializeMemberListQuery(params));
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_MEMBER_LIST}`, { params: query });
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  },
+  async getMemberGroupList(params) {
+    const query = buildQueryParamsFor("get-member-group-list", params);
+    const response = await getApiClient().get(`${getLocalApiBase()}${API_ENDPOINTS.GET_MEMBER_GROUP_LIST}`, {
+      params: query
+    });
+    if (response.data.code === 0) {
+      return JSON.stringify(response.data.data, null, 2);
+    }
+    throw new Error(response.data.msg);
+  }
+};
+
 // ../core/src/handlers/application.ts
 var applicationHandlers = {
   async checkStatus() {
@@ -2390,8 +2566,8 @@ var schemas = {
     profile_id: import_zod.z.array(import_zod.z.string()).describe("The profile ids of the browsers to delete, it is required when you want to delete the browser")
   }).strict(),
   getRecycleBinListSchema: import_zod.z.object({
-    page: import_zod.z.number().int().min(1).optional().describe("Page number. Defaults to 1. Only profiles deleted in the last 30 days and visible to the caller are returned."),
-    limit: import_zod.z.number().int().min(1).max(100).optional().describe("Profiles per page, range 1-100. Defaults to 1 when omitted.")
+    page: import_zod.z.number().int().min(1).optional().describe("Page number. Omit to use the Local API backend default. Only profiles deleted in the last 30 days and visible to the caller are returned."),
+    limit: import_zod.z.number().int().min(1).max(100).optional().describe("Profiles per page, range 1-100. Omit to use the Local API backend default.")
   }).strict(),
   restoreRecycleBinSchema: import_zod.z.object({
     profile_id: import_zod.z.string().optional().describe("Profile ID in the recycle bin. Either profile_id or profile_no is required. If both are provided, profile_id takes priority."),
@@ -2460,6 +2636,49 @@ var schemas = {
     page_size: import_zod.z.number().optional().describe("The size of the page, max is 100, default is 10"),
     page: import_zod.z.number().optional().describe("The page of the group, default is 1")
   }).strict(),
+  createMemberSchema: import_zod.z.object({
+    user_group_id: import_zod.z.string().max(50).describe("Member group / role id. Use get-member-group-list to obtain it"),
+    name: import_zod.z.string().max(50).optional().describe("Member display name, max 50 characters"),
+    email: import_zod.z.string().max(70).describe("Member email, max 70 characters"),
+    password: import_zod.z.string().min(8).max(50).describe("Login password in plaintext, 8 to 50 characters. The Local API hashes it before storing"),
+    identity: import_zod.z.union([import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)]).describe("Role type: 2 admin, 3 manager, 4 staff"),
+    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Optional even when identity is 4 (staff); omit for no manager. Only staff may send this field"),
+    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Only for identity 3 (manager). Do not send for admin (2); the Local API will reject it"),
+    authorized_group: import_zod.z.array(import_zod.z.string()).max(1500).optional().describe("Authorized browser group ids, max 1500. Empty array means no groups"),
+    profile_limit: import_zod.z.number().optional().describe("Profile quota for this member"),
+    remark: import_zod.z.string().max(100).optional().describe("Remark, max 100 characters")
+  }).strict(),
+  updateMemberSchema: import_zod.z.object({
+    user_id: import_zod.z.string().max(50).describe("Member user_id to update"),
+    user_group_id: import_zod.z.string().max(50).optional().describe("Member group / role id"),
+    name: import_zod.z.string().max(50).optional().describe("Member display name, max 50 characters. Empty string clears the name. Omit to keep unchanged"),
+    email: import_zod.z.string().max(70).optional().describe("Member email, max 70 characters. Omit to keep unchanged. Do not send empty string; it will fail validation"),
+    identity: import_zod.z.union([import_zod.z.literal(2), import_zod.z.literal(3), import_zod.z.literal(4)]).optional().describe("Role type: 2 admin, 3 manager, 4 staff. Omit to keep unchanged. Do not send empty; it will fail validation"),
+    manager: import_zod.z.string().max(15).optional().describe("Direct manager user_id. Empty string clears the manager. Omit to keep unchanged. Only staff may send this field"),
+    member: import_zod.z.array(import_zod.z.string()).max(300).optional().describe("Direct subordinate user_id list, max 300. Only for identity 3 (manager). Empty array clears subordinates. Do not send for admin (2)"),
+    authorized_group: import_zod.z.array(import_zod.z.string()).max(1500).optional().describe("Authorized browser group ids, max 1500. Omit to keep current groups. Empty array plus group_update_type 1 (default) replaces/clears; 2 appends/keeps"),
+    group_update_type: import_zod.z.union([import_zod.z.literal(1), import_zod.z.literal(2)]).optional().describe("How authorized_group is applied: 1 replace (default), 2 append"),
+    profile_limit: import_zod.z.number().optional().describe("Profile quota for this member"),
+    remark: import_zod.z.string().max(100).optional().describe("Remark, max 100 characters. Empty string clears the remark. Omit to keep unchanged")
+  }).strict(),
+  resetMemberPasswordSchema: import_zod.z.object({
+    user_id: import_zod.z.string().max(50).describe("Member user_id whose password will be reset"),
+    unbind_phone: import_zod.z.union([import_zod.z.literal(0), import_zod.z.literal(1)]).optional().describe("Whether to unbind the member phone: 1 unbind, 0 keep. Default 0")
+  }).strict(),
+  deleteMemberSchema: import_zod.z.object({
+    user_id: import_zod.z.string().max(50).describe("Member user_id to permanently delete. Hard delete, not recoverable, does not go to recycle bin")
+  }).strict(),
+  getMemberListSchema: import_zod.z.object({
+    user_group_id: import_zod.z.string().max(50).optional().describe("Filter by member group / role id"),
+    user_id: import_zod.z.array(import_zod.z.string()).max(50).optional().describe('Filter by member user_id list, max 50. Example: ["1001","1002"]'),
+    email: import_zod.z.array(import_zod.z.string()).max(50).optional().describe('Filter by member email list, max 50. Example: ["a@b.com"]'),
+    page: import_zod.z.number().int().min(1).max(2e4).optional().describe("Page number, default 1, max 20000"),
+    limit: import_zod.z.number().int().min(1).max(200).optional().describe("Page size, default 50, max 200. Omitting limit returns 50 rows")
+  }).strict(),
+  getMemberGroupListSchema: import_zod.z.object({
+    page: import_zod.z.number().int().min(1).max(2e4).optional().describe("Page number, default 1, max 20000"),
+    limit: import_zod.z.number().int().min(1).max(200).optional().describe("Page size, default 50, max 200. Omitting limit returns 50 rows")
+  }).strict(),
   getApplicationListSchema: import_zod.z.object({
     category_id: import_zod.z.string().optional().describe("Extension category_id"),
     page: import_zod.z.number().optional().describe("Page number, default 1"),
@@ -2770,6 +2989,36 @@ var STATELESS_HANDLERS = {
     description: buildCliCommandDescription("get-group-list", "Get the list of groups"),
     paramsDescription: schemaParamsDescription(schemas.getGroupListSchema, "get-group-list")
   },
+  "create-member": {
+    fn: memberHandlers.createMember,
+    description: buildCliCommandDescription("create-member", "Create a team member"),
+    paramsDescription: schemaParamsDescription(schemas.createMemberSchema, "create-member")
+  },
+  "update-member": {
+    fn: memberHandlers.updateMember,
+    description: buildCliCommandDescription("update-member", "Update a team member"),
+    paramsDescription: schemaParamsDescription(schemas.updateMemberSchema, "update-member")
+  },
+  "reset-member-password": {
+    fn: memberHandlers.resetMemberPassword,
+    description: buildCliCommandDescription("reset-member-password", "Reset a team member password"),
+    paramsDescription: schemaParamsDescription(schemas.resetMemberPasswordSchema, "reset-member-password")
+  },
+  "delete-member": {
+    fn: memberHandlers.deleteMember,
+    description: buildCliCommandDescription("delete-member", "Permanently delete a team member"),
+    paramsDescription: schemaParamsDescription(schemas.deleteMemberSchema, "delete-member")
+  },
+  "get-member-list": {
+    fn: memberHandlers.getMemberList,
+    description: buildCliCommandDescription("get-member-list", "Get the list of team members"),
+    paramsDescription: schemaParamsDescription(schemas.getMemberListSchema, "get-member-list")
+  },
+  "get-member-group-list": {
+    fn: memberHandlers.getMemberGroupList,
+    description: buildCliCommandDescription("get-member-group-list", "Get the list of member groups"),
+    paramsDescription: schemaParamsDescription(schemas.getMemberGroupListSchema, "get-member-group-list")
+  },
   "check-status": {
     fn: applicationHandlers.checkStatus,
     description: buildCliCommandDescription(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "adspower-browser",
-  "version": "2.1.2-beta.1",
+  "version": "2.1.2-beta.3",
   "main": "cli/index.js",
   "type": "commonjs",
   "bin": {