@resolution/jira-api-client 0.1.6 → 0.3.0

package/lib/openapi/platform/services/UserSearchService.js

@@ -0,0 +1,784 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserSearchService = void 0;
+// DO NOT EDIT!
+// This file is generated by "api-typescript-generator".
+// To update this file run "yarn build:openapi".
+const zod_1 = require("zod");
+const commonHttpClient = require("../core/CommonHttpClient");
+const CommonHttpService_1 = require("../core/CommonHttpService");
+const common_1 = require("../models/common");
+const userSearch_1 = require("../models/userSearch");
+const validationSchemaStorage_1 = require("../validationSchemaStorage");
+/**
+ * This resource represents various ways to search for and find users. Use it to
+ * obtain list of users including users assignable to projects and issues, users
+ * with permissions, user lists for pickup fields, and user lists generated using
+ * structured queries. Note that the operations in this resource only return users
+ * found within the first 1000 users.
+ */
+class UserSearchService extends CommonHttpService_1.CommonHttpService {
+    /**
+     * Returns a list of users that can be assigned to an issue. Use this operation to
+     * find the list of users who can be assigned to:
+     *
+     *  *  a new issue, by providing the `projectKeyOrId`.
+     *  *  an updated issue, by providing the `issueKey`.
+     *  *  to an issue during a transition (workflow action), by providing the
+     * `issueKey` and the transition id in `actionDescriptorId`. You can obtain the
+     * IDs of an issue's valid transitions using the `transitions` option in the
+     * `expand` parameter of [ Get issue](#api-rest-api-3-issue-issueIdOrKey-get).
+     *
+     * In all these cases, you can pass an account ID to determine if a user can be
+     * assigned to an issue. The user is returned in the response if they can be
+     * assigned to the issue or issue transition.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that can be assigned the issue. This means the operation usually
+     * returns fewer users than specified in `maxResults`. To get all the users who
+     * can be assigned the issue, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg) or *Assign issues*
+     * [project permission](https://confluence.atlassian.com/x/yodKLg)
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: {
+     *   "accountId": "5b10a2844c20165700ede21g",
+     *   "accountType": "atlassian",
+     *   "active": true,
+     *   "applicationRoles": {
+     *     "items": [],
+     *     "size": 1
+     *   },
+     *   "avatarUrls": {
+     *     "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *     "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+     *     "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+     *     "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+     *   },
+     *   "displayName": "Mia Krystof",
+     *   "emailAddress": "mia@example.com",
+     *   "groups": {
+     *     "items": [],
+     *     "size": 3
+     *   },
+     *   "key": "",
+     *   "name": "",
+     *   "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g",
+     *   "timeZone": "Australia/Sydney"
+     * }
+     * @path {GET} /rest/api/3/user/assignable/search
+     * @scopes-current read:jira-user
+     * @scopes-beta read:issue:jira, read:project:jira, read:user:jira, read:application-role:jira,
+     * read:avatar:jira, read:group:jira
+     */
+    findAssignableUsers({ query, sessionId, username, accountId, project, issueKey, startAt, maxResults, actionDescriptorId, recommend, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/assignable/search",
+            method: "GET",
+            query: {
+                query,
+                sessionId,
+                username,
+                accountId,
+                project,
+                issueKey,
+                startAt,
+                maxResults,
+                actionDescriptorId,
+                recommend,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findAssignableUsers.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Returns a list of users who can be assigned issues in one or more projects. The
+     * list may be restricted to users whose attributes match a string.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that can be assigned issues in the projects. This means the
+     * operation usually returns fewer users than specified in `maxResults`. To get
+     * all the users who can be assigned issues in the projects, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * This operation can be accessed anonymously.
+     *
+     * **[Permissions](#permissions) required:** None.
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: [
+     *   {
+     *     "accountId": "5b10a2844c20165700ede21g",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+     *     },
+     *     "displayName": "Mia Krystof",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+     *   },
+     *   {
+     *     "accountId": "5b10ac8d82e05b22cc7d4ef5",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=48&s=48"
+     *     },
+     *     "displayName": "Emma Richards",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10ac8d82e05b22cc7d4ef5"
+     *   }
+     * ]
+     * @path {GET} /rest/api/3/user/assignable/multiProjectSearch
+     * @scopes-current read:jira-user
+     * @scopes-beta read:project:jira, read:user:jira, read:application-role:jira,
+     * read:avatar:jira, read:group:jira
+     */
+    findBulkAssignableUsers({ query, username, accountId, projectKeys, startAt, maxResults, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/assignable/multiProjectSearch",
+            method: "GET",
+            query: {
+                query,
+                username,
+                accountId,
+                projectKeys,
+                startAt,
+                maxResults,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findBulkAssignableUsers.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Finds users with a structured query and returns a [paginated](#pagination) list
+     * of user keys.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that match the structured query. This means the operation usually
+     * returns fewer users than specified in `maxResults`. To get all the users who
+     * match the structured query, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     *
+     * The query statements are:
+     *
+     *  *  `is assignee of PROJ` Returns the users that are assignees of at least one
+     * issue in project *PROJ*.
+     *  *  `is assignee of (PROJ-1, PROJ-2)` Returns users that are assignees on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is reporter of (PROJ-1, PROJ-2)` Returns users that are reporters on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is watcher of (PROJ-1, PROJ-2)` Returns users that are watchers on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is voter of (PROJ-1, PROJ-2)` Returns users that are voters on the issues
+     * *PROJ-1* or *PROJ-2*.
+     *  *  `is commenter of (PROJ-1, PROJ-2)` Returns users that have posted a comment
+     * on the issues *PROJ-1* or *PROJ-2*.
+     *  *  `is transitioner of (PROJ-1, PROJ-2)` Returns users that have performed a
+     * transition on issues *PROJ-1* or *PROJ-2*.
+     *  *  `[propertyKey].entity.property.path is "property value"` Returns users with
+     * the entity property value.
+     *
+     * The list of issues can be extended as needed, as in *(PROJ-1, PROJ-2, ...
+     * PROJ-n)*. Statements can be combined using the `AND` and `OR` operators to form
+     * more complex queries. For example:
+     *
+     * `is assignee of PROJ AND [propertyKey].entity.property.path is "property value"`
+     *
+     * @returns Returned if the request is successful.
+     * @path {GET} /rest/api/3/user/search/query/key
+     * @scopes-current read:jira-user
+     * @scopes-beta read:comment:jira, read:issue:jira, read:issue.vote:jira,
+     * read:issue.watcher:jira, read:project:jira, read:user.property:jira,
+     * read:user:jira
+     */
+    findUserKeysByQuery({ query, startAt, maxResult, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/search/query/key",
+            method: "GET",
+            query: {
+                query,
+                startAt,
+                maxResult,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUserKeysByQuery.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Returns a list of active users that match the search string and property.
+     *
+     * This operation first applies a filter to match the search string and property,
+     * and then takes the filtered users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user. To get all the users who match the
+     * search string and property, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * This operation can be accessed anonymously.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls or
+     * calls by users without the required permission return empty search results.
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: [
+     *   {
+     *     "accountId": "5b10a2844c20165700ede21g",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+     *     },
+     *     "displayName": "Mia Krystof",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+     *   },
+     *   {
+     *     "accountId": "5b10ac8d82e05b22cc7d4ef5",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=48&s=48"
+     *     },
+     *     "displayName": "Emma Richards",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10ac8d82e05b22cc7d4ef5"
+     *   }
+     * ]
+     * @path {GET} /rest/api/3/user/search
+     * @scopes-current read:jira-user
+     * @scopes-beta read:user:jira, read:user.property:jira, read:application-role:jira,
+     * read:avatar:jira, read:group:jira
+     */
+    findUsers({ query, username, accountId, startAt, maxResults, property, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/search",
+            method: "GET",
+            query: {
+                query,
+                username,
+                accountId,
+                startAt,
+                maxResults,
+                property,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUsers.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Finds users with a structured query and returns a [paginated](#pagination) list
+     * of user details.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that match the structured query. This means the operation usually
+     * returns fewer users than specified in `maxResults`. To get all the users who
+     * match the structured query, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg).
+     *
+     * The query statements are:
+     *
+     *  *  `is assignee of PROJ` Returns the users that are assignees of at least one
+     * issue in project *PROJ*.
+     *  *  `is assignee of (PROJ-1, PROJ-2)` Returns users that are assignees on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is reporter of (PROJ-1, PROJ-2)` Returns users that are reporters on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is watcher of (PROJ-1, PROJ-2)` Returns users that are watchers on the
+     * issues *PROJ-1* or *PROJ-2*.
+     *  *  `is voter of (PROJ-1, PROJ-2)` Returns users that are voters on the issues
+     * *PROJ-1* or *PROJ-2*.
+     *  *  `is commenter of (PROJ-1, PROJ-2)` Returns users that have posted a comment
+     * on the issues *PROJ-1* or *PROJ-2*.
+     *  *  `is transitioner of (PROJ-1, PROJ-2)` Returns users that have performed a
+     * transition on issues *PROJ-1* or *PROJ-2*.
+     *  *  `[propertyKey].entity.property.path is "property value"` Returns users with
+     * the entity property value.
+     *
+     * The list of issues can be extended as needed, as in *(PROJ-1, PROJ-2, ...
+     * PROJ-n)*. Statements can be combined using the `AND` and `OR` operators to form
+     * more complex queries. For example:
+     *
+     * `is assignee of PROJ AND [propertyKey].entity.property.path is "property value"`
+     *
+     * @returns Returned if the request is successful.
+     * @path {GET} /rest/api/3/user/search/query
+     * @scopes-current read:jira-user
+     * @scopes-beta read:comment:jira, read:issue:jira, read:issue.vote:jira,
+     * read:issue.watcher:jira, read:project:jira, read:user:jira,
+     * read:user.property:jira, read:application-role:jira, read:avatar:jira,
+     * read:group:jira
+     */
+    findUsersByQuery({ query, startAt, maxResults, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/search/query",
+            method: "GET",
+            query: {
+                query,
+                startAt,
+                maxResults,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUsersByQuery.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Returns a list of users whose attributes match the query term. The returned
+     * object includes the `html` field where the matched query term is highlighted
+     * with the HTML strong tag. A list of account IDs can be provided to exclude
+     * users from the results.
+     *
+     * This operation takes the users in the range defined by `maxResults`, up to the
+     * thousandth user, and then returns only the users from that range that match the
+     * query term. This means the operation usually returns fewer users than specified
+     * in `maxResults`. To get all the users who match the query term, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * This operation can be accessed anonymously.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls and
+     * calls by users without the required permission return search results for an
+     * exact name match only.
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: {
+     *   "header": "Showing 20 of 25 matching groups",
+     *   "total": 25,
+     *   "users": [
+     *     {
+     *       "accountId": "5b10a2844c20165700ede21g",
+     *       "accountType": "atlassian",
+     *       "avatarUrl":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *       "displayName": "Mia Krystof",
+     *       "html": "<strong>Mi</strong>a Krystof - <strong>mi</strong>a@example.com
+     * (<strong>mi</strong>a)",
+     *       "key": "mia",
+     *       "name": "mia"
+     *     }
+     *   ]
+     * }
+     * @path {GET} /rest/api/3/user/picker
+     * @scopes-current read:jira-user
+     * @scopes-beta read:user:jira
+     */
+    findUsersForPicker({ query, maxResults, showAvatar, exclude, excludeAccountIds, avatarSize, excludeConnectUsers, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/picker",
+            method: "GET",
+            query: {
+                query,
+                maxResults,
+                showAvatar,
+                exclude,
+                excludeAccountIds,
+                avatarSize,
+                excludeConnectUsers,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUsersForPicker.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Returns a list of users who fulfill these criteria:
+     *
+     *  *  their user attributes match a search string.
+     *  *  they have a set of permissions for a project or issue.
+     *
+     * If no search string is provided, a list of all users with the permissions is
+     * returned.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that match the search string and have permission for the project or
+     * issue. This means the operation usually returns fewer users than specified in
+     * `maxResults`. To get all the users who match the search string and have
+     * permission for the project or issue, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * This operation can be accessed anonymously.
+     *
+     * **[Permissions](#permissions) required:**
+     *
+     *  *  *Administer Jira* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg), to get users for any
+     * project.
+     *  *  *Administer Projects* [project
+     * permission](https://confluence.atlassian.com/x/yodKLg) for a project, to get
+     * users for that project.
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: [
+     *   {
+     *     "accountId": "5b10a2844c20165700ede21g",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+     *     },
+     *     "displayName": "Mia Krystof",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+     *   },
+     *   {
+     *     "accountId": "5b10ac8d82e05b22cc7d4ef5",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=48&s=48"
+     *     },
+     *     "displayName": "Emma Richards",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10ac8d82e05b22cc7d4ef5"
+     *   }
+     * ]
+     * @path {GET} /rest/api/3/user/permission/search
+     * @scopes-current read:jira-user
+     * @scopes-beta read:issue:jira, read:project:jira, read:user:jira, read:application-role:jira,
+     * read:avatar:jira, read:group:jira
+     */
+    findUsersWithAllPermissions({ query, username, accountId, permissions, issueKey, projectKey, startAt, maxResults, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/permission/search",
+            method: "GET",
+            query: {
+                query,
+                username,
+                accountId,
+                permissions,
+                issueKey,
+                projectKey,
+                startAt,
+                maxResults,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUsersWithAllPermissions.response"))
+            .then(commonHttpClient.getBody);
+    }
+    /**
+     * Returns a list of users who fulfill these criteria:
+     *
+     *  *  their user attributes match a search string.
+     *  *  they have permission to browse issues.
+     *
+     * Use this resource to find users who can browse:
+     *
+     *  *  an issue, by providing the `issueKey`.
+     *  *  any issue in a project, by providing the `projectKey`.
+     *
+     * This operation takes the users in the range defined by `startAt` and
+     * `maxResults`, up to the thousandth user, and then returns only the users from
+     * that range that match the search string and have permission to browse issues.
+     * This means the operation usually returns fewer users than specified in
+     * `maxResults`. To get all the users who match the search string and have
+     * permission to browse issues, use [Get all
+     * users](#api-rest-api-3-users-search-get) and filter the records in your code.
+     *
+     * Privacy controls are applied to the response based on the users' preferences.
+     * This could mean, for example, that the user's email address is hidden. See the
+     * [Profile visibility
+     * overview](https://developer.atlassian.com/cloud/jira/platform/profile-visibility/)
+     * for more details.
+     *
+     * This operation can be accessed anonymously.
+     *
+     * **[Permissions](#permissions) required:** *Browse users and groups* [global
+     * permission](https://confluence.atlassian.com/x/x4dKLg). Anonymous calls and
+     * calls by users without the required permission return empty search results.
+     *
+     * @returns Returned if the request is successful.
+     *
+     * example: [
+     *   {
+     *     "accountId": "5b10a2844c20165700ede21g",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/MK-5.png?size=48&s=48"
+     *     },
+     *     "displayName": "Mia Krystof",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10a2844c20165700ede21g"
+     *   },
+     *   {
+     *     "accountId": "5b10ac8d82e05b22cc7d4ef5",
+     *     "accountType": "atlassian",
+     *     "active": false,
+     *     "avatarUrls": {
+     *       "16x16":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=16&s=16",
+     *       "24x24":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=24&s=24",
+     *       "32x32":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=32&s=32",
+     *       "48x48":
+     * "https://avatar-management--avatars.server-location.prod.public.atl-paas.net/initials/AA-3.png?size=48&s=48"
+     *     },
+     *     "displayName": "Emma Richards",
+     *     "key": "",
+     *     "name": "",
+     *     "self":
+     * "https://your-domain.atlassian.net/rest/api/3/user?accountId=5b10ac8d82e05b22cc7d4ef5"
+     *   }
+     * ]
+     * @path {GET} /rest/api/3/user/viewissue/search
+     * @scopes-current read:jira-user
+     * @scopes-beta read:issue:jira, read:project:jira, read:user:jira, read:application-role:jira,
+     * read:avatar:jira, read:group:jira
+     */
+    findUsersWithBrowsePermission({ query, username, accountId, issueKey, projectKey, startAt, maxResults, }) {
+        return this.getClientInstance()
+            .request({
+            path: "/rest/api/3/user/viewissue/search",
+            method: "GET",
+            query: {
+                query,
+                username,
+                accountId,
+                issueKey,
+                projectKey,
+                startAt,
+                maxResults,
+            },
+        })
+            .then(this.getClientInstance().responseHandler({
+            200: {
+                "application/json": "json",
+            },
+        }))
+            .then(commonHttpClient.castResponse())
+            .then(validationSchemaStorage_1.validationSchemaStorage.validator("UserSearchService.findUsersWithBrowsePermission.response"))
+            .then(commonHttpClient.getBody);
+    }
+    static initialize() {
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findBulkAssignableUsers.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: zod_1.z.array(validationSchemaStorage_1.validationSchemaStorage.lazy("User")),
+        })
+            .describe("UserSearchService.findBulkAssignableUsers.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findAssignableUsers.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: zod_1.z.array(validationSchemaStorage_1.validationSchemaStorage.lazy("User")),
+        })
+            .describe("UserSearchService.findAssignableUsers.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUsersWithAllPermissions.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: zod_1.z.array(validationSchemaStorage_1.validationSchemaStorage.lazy("User")),
+        })
+            .describe("UserSearchService.findUsersWithAllPermissions.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUsersForPicker.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: validationSchemaStorage_1.validationSchemaStorage.lazy("FoundUsers"),
+        })
+            .describe("UserSearchService.findUsersForPicker.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUsers.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: zod_1.z.array(validationSchemaStorage_1.validationSchemaStorage.lazy("User")),
+        })
+            .describe("UserSearchService.findUsers.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUsersByQuery.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: validationSchemaStorage_1.validationSchemaStorage.lazy("PageBeanUser"),
+        })
+            .describe("UserSearchService.findUsersByQuery.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUserKeysByQuery.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: validationSchemaStorage_1.validationSchemaStorage.lazy("PageBeanUserKey"),
+        })
+            .describe("UserSearchService.findUserKeysByQuery.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerExtensible("UserSearchService.findUsersWithBrowsePermission.response", zod_1.z
+            .object({
+            status: zod_1.z.literal(200),
+            mediaType: zod_1.z.literal("application/json"),
+            body: zod_1.z.array(validationSchemaStorage_1.validationSchemaStorage.lazy("User")),
+        })
+            .describe("UserSearchService.findUsersWithBrowsePermission.response"));
+        validationSchemaStorage_1.validationSchemaStorage.registerOnce([
+            common_1.registerCommonValidationSchemas,
+            userSearch_1.registerUserSearchValidationSchemas,
+        ]);
+    }
+}
+exports.UserSearchService = UserSearchService;
+//# sourceMappingURL=UserSearchService.js.map