@felixgeelhaar/jira-sdk 0.2.0 → 1.0.0

package/dist/services/index.d.cts

@@ -1,8 +1,7 @@
 import { z } from 'zod';
-import * as _felixgeelhaar_sdk_core from '@felixgeelhaar/sdk-core';
-import { HttpClient, RequestOptions, HttpResponse } from '@felixgeelhaar/sdk-core';
-import { l as GetIssueOptions, e as Issue, h as CreateIssueInput, k as CreateIssueResponse, i as UpdateIssueInput, u as CommentsPage, p as Comment, q as AddCommentInput, s as UpdateCommentInput, x as TransitionsResponse, y as DoTransitionInput, O as Watchers, M as WorklogsPage, E as Worklog, H as AddWorklogInput, K as UpdateWorklogInput, S as Project, a1 as GetProjectsOptions, $ as ProjectSearchResult, X as CreateProjectInput, Z as UpdateProjectInput } from '../project-BtUx-eSv.cjs';
-import { User } from '@felixgeelhaar/sdk-core/schemas';
+import { H as HttpClient, Q as QueryParamValue, R as RequestOptions, f as HttpResponse } from '../http-client-BSzRYQZa.cjs';
+import { dh as GetBoardsOptions, ah as BoardPage, ac as Board, aK as CreateBoardInput, dg as GetBoardSprintsOptions, gq as SprintPage, gp as Sprint, by as CreateSprintInput, hg as UpdateSprintInput, eJ as MoveIssuesToSprintInput, df as GetBoardEpicsOptions, cd as EpicPage, ca as Epic, de as GetBacklogOptions, J as AgileIssuePage, G as AgileIssue, S as ApplicationProperty, gl as SetApplicationPropertyInput, a2 as AuditListOptions, a6 as AuditRecord, bg as CreateIssuesInput, bi as CreateIssuesResult, c0 as DeleteIssuesInput, aq as BulkOperationProgress, hE as WaitForCompletionOptions, ew as ListDashboardsOptions, bP as DashboardListResult, bK as Dashboard, aO as CreateDashboardInput, gM as UpdateDashboardInput, bL as DashboardGadget, j as AddGadgetInput, gU as UpdateGadgetInput, ci as EvaluationInput, cm as EvaluationResult, O as AnalysisInput, Q as AnalysisResult, cu as Field, aS as CreateFieldInput, gQ as UpdateFieldInput, cx as FieldContext, aQ as CreateFieldContextInput, gO as UpdateFieldContextInput, cD as FieldOption, aU as CreateFieldOptionInput, U as AssociateContextProjectsInput, fX as RemoveContextProjectsInput, di as GetContextProjectMappingsOptions, aG as ContextProjectMapping, dk as GetFilterOptions, cQ as Filter, a_ as CreateFilterInput, gS as UpdateFilterInput, ex as ListFiltersOptions, d4 as FilterSearchResult, du as GetMyFiltersOptions, d6 as FilterShareScope, cV as FilterPermission, v as AddSharePermissionInput, dc as FindGroupsOptions, dA as Group, dn as GetGroupOptions, b0 as CreateGroupInput, b_ as DeleteGroupOptions, dl as GetGroupMembersOptions, dI as GroupUser, l as AddGroupUserOptions, fZ as RemoveGroupUserOptions, am as BulkGetGroupsOptions, dq as GetIssueOptions, dU as Issue, b4 as CreateIssueInput, ba as CreateIssueResponse, gW as UpdateIssueInput, aA as CommentsPage, aw as Comment, h as AddCommentInput, gI as UpdateCommentInput, gG as TransitionsResponse, c2 as DoTransitionInput, hF as Watchers, is as WorklogsPage, ik as Worklog, x as AddWorklogInput, hq as UpdateWorklogInput, W as Attachment, X as AttachmentMetadata, dX as IssueLink, b6 as CreateIssueLinkInput, d$ as IssueLinkTypesResponse, dZ as IssueLinkType, b8 as CreateIssueLinkTypeInput, gY as UpdateIssueLinkTypeInput, e6 as IssueTypeDetails, bc as CreateIssueTypeInput, g_ as UpdateIssueTypeInput, ey as ListIssueTypeSchemesOptions, e8 as IssueTypeScheme, be as CreateIssueTypeSchemeInput, h0 as UpdateIssueTypeSchemeInput, n as AddIssueTypesToSchemeInput, ds as GetIssueTypeSchemeMappingsOptions, eb as IssueTypeSchemeMapping, eA as ListLabelsOptions, bI as CurrentUser, hz as UserPreferences, gn as SetUserPreferencesInput, eB as ListNotificationSchemesOptions, f0 as NotificationSchemePage, eZ as NotificationScheme, bk as CreateNotificationSchemeInput, h2 as UpdateNotificationSchemeInput, p as AddNotificationInput, gh as SendNotificationInput, f7 as Permission, eM as MyPermissionsOptions, eL as MyPermissions, eD as ListPermissionSchemesOptions, fh as PermissionScheme, dv as GetPermissionSchemeOptions, bm as CreatePermissionSchemeInput, h4 as UpdatePermissionSchemeInput, fM as ProjectRoles, fy as ProjectRole, d as AddActorInput, fD as ProjectRoleActorType, fp as Priority, bo as CreatePriorityInput, h6 as UpdatePriorityInput, fr as Project, dx as GetProjectsOptions, fP as ProjectSearchResult, bq as CreateProjectInput, h8 as UpdateProjectInput, aM as CreateComponentInput, fs as ProjectComponent, gK as UpdateComponentInput, bA as CreateVersionInput, fR as ProjectVersion, hk as UpdateVersionInput, f$ as Resolution, bs as CreateResolutionInput, ha as UpdateResolutionInput, eF as ListScreensOptions, g4 as ScreenListResult, g1 as Screen, bu as CreateScreenInput, hc as UpdateScreenInput, g2 as ScreenField, gb as ScreenTab, bw as CreateScreenTabInput, he as UpdateScreenTabInput, t as AddScreenFieldInput, a as AdfNode, gd as SecurityLevel, gf as SecurityScheme, gj as ServerInfo, em as JiraConfiguration, gA as TimeTrackingProvider, gw as TimeTrackingConfiguration, hi as UpdateTimeTrackingConfigurationInput, il as WorklogListOptions, gy as TimeTrackingCreateWorklogInput, gC as TimeTrackingUpdateWorklogInput, hs as User, hK as WebhookListOptions, hH as Webhook, bC as CreateWebhookInput, hS as WebhookRegistrationResult, hm as UpdateWebhookInput, c4 as DynamicModules, cq as FailedWebhook, dz as GetWorkflowTransitionsOptions, ig as WorkflowTransition, hW as WorkflowDoTransitionInput, eH as ListWorkflowsOptions, i9 as WorkflowSearchResult, hV as Workflow, ib as WorkflowStatus, ic as WorkflowStatusCategory, i1 as WorkflowScheme, eG as ListWorkflowSchemesOptions, i4 as WorkflowSchemeListResult, bE as CreateWorkflowSchemeInput, ho as UpdateWorkflowSchemeInput, i2 as WorkflowSchemeIssueTypeInput } from '../webhook-Bn8gme6Y.cjs';
+import '../types-E6djPHpW.cjs';
 
 /**
  * Base service class for all Jira services
@@ -21,11 +20,11 @@ declare abstract class BaseService {
     /**
      * Make a GET request and validate the response
      */
-    protected getMethod<T>(path: string, schema: z.ZodType<T>, params?: Record<string, string | number | boolean | string[] | undefined>, options?: RequestOptions): Promise<T>;
+    protected getMethod<T>(path: string, schema: z.ZodType<T>, params?: Record<string, QueryParamValue | undefined>, options?: RequestOptions): Promise<T>;
     /**
      * Make a GET request without response validation
      */
-    protected getMethodRaw<T = unknown>(path: string, params?: Record<string, string | number | boolean | string[] | undefined>, options?: RequestOptions): Promise<HttpResponse<T>>;
+    protected getMethodRaw<T = unknown>(path: string, params?: Record<string, QueryParamValue | undefined>, options?: RequestOptions): Promise<HttpResponse<T>>;
     /**
      * Make a POST request and validate the response
      */
@@ -62,7 +61,7 @@ declare abstract class BaseService {
      * Build query parameters for GET requests
      * Filters out undefined values
      */
-    protected buildParams(params: Record<string, string | number | boolean | string[] | undefined>): Record<string, string | number | boolean | string[]>;
+    protected buildParams(params: Record<string, QueryParamValue | undefined>): Record<string, QueryParamValue>;
     /**
      * Convert array to comma-separated string for query params
      */
@@ -70,255 +69,3011 @@ declare abstract class BaseService {
 }
 
 /**
- * Issue service for CRUD operations on Jira issues
+ * Agile service for boards, sprints, epics and backlogs.
+ *
+ * Unlike the other services this one talks to the Jira Agile API
+ * (`/rest/agile/1.0`) rather than the platform API (`/rest/api/3`).
  *
  * @example
  * ```typescript
  * const client = new JiraClient({ ... });
  *
- * // Get an issue
- * const issue = await client.issues.get('PROJECT-123');
- *
- * // Create an issue
- * const newIssue = await client.issues.create({
- *   fields: {
- *     project: { key: 'PROJECT' },
- *     summary: 'New issue',
- *     issuetype: { name: 'Task' },
- *   },
- * });
- *
- * // Update an issue
- * await client.issues.update('PROJECT-123', {
- *   fields: { summary: 'Updated summary' },
- * });
+ * // List scrum boards
+ * const boards = await client.agile.getBoards({ type: 'scrum' });
  *
- * // Delete an issue
- * await client.issues.delete('PROJECT-123');
+ * // Iterate every sprint of a board
+ * for await (const sprint of client.agile.iterateBoardSprints(123)) {
+ *   console.log(sprint.name, sprint.state);
+ * }
  * ```
  */
-declare class IssueService extends BaseService {
+declare class AgileService extends BaseService {
+    constructor(http: HttpClient, basePath?: string);
     /**
-     * Get an issue by key or ID
+     * List boards, optionally filtered by type, name or project.
+     *
+     * `GET /rest/agile/1.0/board`
+     *
+     * @param options - Pagination and filter options
+     * @returns A page of boards
      */
-    get(issueIdOrKey: string, options?: GetIssueOptions): Promise<Issue>;
+    getBoards(options?: GetBoardsOptions): Promise<BoardPage>;
     /**
-     * Create a new issue
+     * Get a single board by ID.
+     *
+     * `GET /rest/agile/1.0/board/{boardId}`
+     *
+     * @param boardId - Numeric ID of the board
+     * @returns The board
      */
-    create(input: CreateIssueInput): Promise<CreateIssueResponse>;
+    getBoard(boardId: number): Promise<Board>;
     /**
-     * Update an issue
+     * Create a board backed by an existing saved filter.
+     *
+     * `POST /rest/agile/1.0/board`
+     *
+     * @param input - Board name, type and the ID of the filter to back it
+     * @returns The created board
      */
-    update(issueIdOrKey: string, input: UpdateIssueInput, options?: {
-        notifyUsers?: boolean;
-        overrideScreenSecurity?: boolean;
-        overrideEditableFlag?: boolean;
-    }): Promise<void>;
+    createBoard(input: CreateBoardInput): Promise<Board>;
     /**
-     * Delete an issue
+     * Delete a board.
+     *
+     * `DELETE /rest/agile/1.0/board/{boardId}`
+     *
+     * @param boardId - Numeric ID of the board
      */
-    deleteIssue(issueIdOrKey: string, options?: {
-        deleteSubtasks?: boolean;
-    }): Promise<void>;
+    deleteBoard(boardId: number): Promise<void>;
     /**
-     * Get comments for an issue
+     * List the sprints of a board.
+     *
+     * `GET /rest/agile/1.0/board/{boardId}/sprint`
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Pagination and state filter options
+     * @returns A page of sprints
      */
-    getComments(issueIdOrKey: string, options?: {
-        startAt?: number;
-        maxResults?: number;
-        orderBy?: string;
-        expand?: string[];
-    }): Promise<CommentsPage>;
+    getBoardSprints(boardId: number, options?: GetBoardSprintsOptions): Promise<SprintPage>;
     /**
-     * Get a specific comment
+     * Get a single sprint by ID.
+     *
+     * `GET /rest/agile/1.0/sprint/{sprintId}`
+     *
+     * @param sprintId - Numeric ID of the sprint
+     * @returns The sprint
      */
-    getComment(issueIdOrKey: string, commentId: string, options?: {
-        expand?: string[];
-    }): Promise<Comment>;
+    getSprint(sprintId: number): Promise<Sprint>;
     /**
-     * Add a comment to an issue
+     * Create a future sprint on a Scrum board.
+     *
+     * `POST /rest/agile/1.0/sprint`
+     *
+     * @param input - Sprint name, origin board and optional dates/goal
+     * @returns The created sprint
      */
-    addComment(issueIdOrKey: string, input: AddCommentInput, options?: {
-        expand?: string[];
-    }): Promise<Comment>;
+    createSprint(input: CreateSprintInput): Promise<Sprint>;
     /**
-     * Update a comment
+     * Partially update a sprint (name, state, dates, goal).
+     *
+     * `POST /rest/agile/1.0/sprint/{sprintId}`
+     *
+     * @param sprintId - Numeric ID of the sprint
+     * @param input - Fields to change; omitted fields are left untouched
+     * @returns The updated sprint
      */
-    updateComment(issueIdOrKey: string, commentId: string, input: UpdateCommentInput, options?: {
-        expand?: string[];
-    }): Promise<Comment>;
+    updateSprint(sprintId: number, input: UpdateSprintInput): Promise<Sprint>;
     /**
-     * Delete a comment
+     * Delete a sprint. Issues in the sprint are moved back to the backlog.
+     *
+     * `DELETE /rest/agile/1.0/sprint/{sprintId}`
+     *
+     * @param sprintId - Numeric ID of the sprint
      */
-    deleteComment(issueIdOrKey: string, commentId: string): Promise<void>;
+    deleteSprint(sprintId: number): Promise<void>;
     /**
-     * Get available transitions for an issue
+     * Move issues into a sprint. Jira accepts at most 50 issues per call.
+     *
+     * `POST /rest/agile/1.0/sprint/{sprintId}/issue`
+     *
+     * @param sprintId - Numeric ID of the target sprint
+     * @param input - Issue keys or IDs to move
      */
-    getTransitions(issueIdOrKey: string, options?: {
-        expand?: string[];
-        transitionId?: string;
-    }): Promise<TransitionsResponse>;
+    moveIssuesToSprint(sprintId: number, input: MoveIssuesToSprintInput): Promise<void>;
     /**
-     * Transition an issue to a new status
+     * List the epics of a board.
+     *
+     * `GET /rest/agile/1.0/board/{boardId}/epic`
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Pagination and completion-status filter options
+     * @returns A page of epics
      */
-    doTransition(issueIdOrKey: string, input: DoTransitionInput): Promise<void>;
+    getBoardEpics(boardId: number, options?: GetBoardEpicsOptions): Promise<EpicPage>;
     /**
-     * Get watchers for an issue
+     * Get a single epic by ID or key.
+     *
+     * `GET /rest/agile/1.0/epic/{epicIdOrKey}`
+     *
+     * @param epicIdOrKey - Numeric ID or issue key of the epic
+     * @returns The epic
      */
-    getWatchers(issueIdOrKey: string): Promise<Watchers>;
+    getEpic(epicIdOrKey: number | string): Promise<Epic>;
     /**
-     * Add a watcher to an issue
+     * List the issues on a board's backlog (issues not assigned to a sprint).
+     *
+     * `GET /rest/agile/1.0/board/{boardId}/backlog`
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Pagination options
+     * @returns A page of backlog issues
      */
-    addWatcher(issueIdOrKey: string, accountId: string): Promise<void>;
+    getBacklog(boardId: number, options?: GetBacklogOptions): Promise<AgileIssuePage>;
     /**
-     * Remove a watcher from an issue
+     * Iterate every board, transparently following `startAt`/`isLast` pagination.
+     *
+     * @param options - Filter options; `startAt` is managed by the iterator
+     * @returns An async generator yielding boards one at a time
+     *
+     * @example
+     * ```typescript
+     * for await (const board of client.agile.iterateBoards({ type: 'scrum' })) {
+     *   console.log(board.name);
+     * }
+     * ```
      */
-    removeWatcher(issueIdOrKey: string, accountId: string): Promise<void>;
+    iterateBoards(options?: Omit<GetBoardsOptions, 'startAt'>): AsyncGenerator<Board, void, undefined>;
     /**
-     * Get worklogs for an issue
+     * Collect every board into an array (loads all pages into memory).
+     *
+     * @param options - Filter options; `startAt` is managed internally
+     * @returns All matching boards
      */
-    getWorklogs(issueIdOrKey: string, options?: {
-        startAt?: number;
-        maxResults?: number;
-        startedAfter?: number;
-        startedBefore?: number;
-        expand?: string[];
-    }): Promise<WorklogsPage>;
+    allBoards(options?: Omit<GetBoardsOptions, 'startAt'>): Promise<Board[]>;
     /**
-     * Get a specific worklog
+     * Iterate every sprint of a board, following `startAt`/`isLast` pagination.
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Filter options; `startAt` is managed by the iterator
+     * @returns An async generator yielding sprints one at a time
      */
-    getWorklog(issueIdOrKey: string, worklogId: string, options?: {
-        expand?: string[];
-    }): Promise<Worklog>;
+    iterateBoardSprints(boardId: number, options?: Omit<GetBoardSprintsOptions, 'startAt'>): AsyncGenerator<Sprint, void, undefined>;
     /**
-     * Add a worklog to an issue
+     * Collect every sprint of a board into an array.
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Filter options; `startAt` is managed internally
+     * @returns All matching sprints
      */
-    addWorklog(issueIdOrKey: string, input: AddWorklogInput, options?: {
-        notifyUsers?: boolean;
-        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
-        newEstimate?: string;
-        reduceBy?: string;
-        expand?: string[];
-    }): Promise<Worklog>;
+    allBoardSprints(boardId: number, options?: Omit<GetBoardSprintsOptions, 'startAt'>): Promise<Sprint[]>;
     /**
-     * Update a worklog
+     * Iterate every epic of a board, following `startAt`/`isLast` pagination.
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Filter options; `startAt` is managed by the iterator
+     * @returns An async generator yielding epics one at a time
      */
-    updateWorklog(issueIdOrKey: string, worklogId: string, input: UpdateWorklogInput, options?: {
-        notifyUsers?: boolean;
-        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
-        newEstimate?: string;
-        expand?: string[];
-    }): Promise<Worklog>;
+    iterateBoardEpics(boardId: number, options?: Omit<GetBoardEpicsOptions, 'startAt'>): AsyncGenerator<Epic, void, undefined>;
     /**
-     * Delete a worklog
+     * Collect every epic of a board into an array.
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Filter options; `startAt` is managed internally
+     * @returns All matching epics
      */
-    deleteWorklog(issueIdOrKey: string, worklogId: string, options?: {
-        notifyUsers?: boolean;
-        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
-        newEstimate?: string;
-        increaseBy?: string;
-    }): Promise<void>;
+    allBoardEpics(boardId: number, options?: Omit<GetBoardEpicsOptions, 'startAt'>): Promise<Epic[]>;
     /**
-     * Add your vote to an issue
+     * Iterate every issue on a board's backlog, following `startAt`/`total`
+     * pagination (the backlog endpoint does not return `isLast`).
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Pagination options; `startAt` is managed by the iterator
+     * @returns An async generator yielding backlog issues one at a time
      */
-    addVote(issueIdOrKey: string): Promise<void>;
+    iterateBacklog(boardId: number, options?: Omit<GetBacklogOptions, 'startAt'>): AsyncGenerator<AgileIssue, void, undefined>;
     /**
-     * Remove your vote from an issue
+     * Collect every backlog issue of a board into an array.
+     *
+     * @param boardId - Numeric ID of the board
+     * @param options - Pagination options; `startAt` is managed internally
+     * @returns All backlog issues
      */
-    removeVote(issueIdOrKey: string): Promise<void>;
+    allBacklog(boardId: number, options?: Omit<GetBacklogOptions, 'startAt'>): Promise<AgileIssue[]>;
 }
 
 /**
- * Project service for CRUD operations on Jira projects
+ * Application properties service for Jira system configuration settings
  *
  * @example
  * ```typescript
  * const client = new JiraClient({ ... });
  *
- * // Get all projects
- * const projects = await client.projects.list();
+ * const settings = await client.appProperties.getAdvancedSettings();
+ * const prop = await client.appProperties.getApplicationProperty('jira.clone.prefix');
+ * await client.appProperties.setApplicationProperty({
+ *   id: 'jira.clone.prefix',
+ *   value: 'CLONE -',
+ * });
+ * ```
+ */
+declare class AppPropertiesService extends BaseService {
+    /**
+     * Get all advanced settings
+     *
+     * `GET /rest/api/3/application-properties/advanced-settings`
+     *
+     * @returns The list of advanced settings properties
+     */
+    getAdvancedSettings(): Promise<ApplicationProperty[]>;
+    /**
+     * Get a single application property by key
+     *
+     * `GET /rest/api/3/application-properties?key={key}`
+     *
+     * @param key - The application property key
+     * @returns The matching application property
+     * @throws If no property matches the given key
+     */
+    getApplicationProperty(key: string): Promise<ApplicationProperty>;
+    /**
+     * Set the value of an application property
+     *
+     * `PUT /rest/api/3/application-properties/{id}`
+     *
+     * @param input - The property ID and its new value
+     * @returns Nothing; resolves once the property is stored
+     */
+    setApplicationProperty(input: SetApplicationPropertyInput): Promise<void>;
+}
+
+/**
+ * Audit log service for reading Jira's administrative audit records.
  *
- * // Get a project
- * const project = await client.projects.get('PROJECT');
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
  *
- * // Create a project
- * const newProject = await client.projects.create({
- *   key: 'PROJ',
- *   name: 'My Project',
- *   projectTypeKey: 'software',
- * });
+ * // Get a page of audit records
+ * const records = await client.audit.list({ limit: 100, filter: 'user_management' });
+ *
+ * // Iterate every record in a time window
+ * for await (const record of client.audit.iterate({ from: '2024-01-01T00:00:00Z' })) {
+ *   console.log(record.summary);
+ * }
  * ```
  */
-declare class ProjectService extends BaseService {
+declare class AuditService extends BaseService {
     /**
-     * Get a project by key or ID
+     * List audit records with optional filtering.
+     *
+     * `GET /rest/api/3/auditing/record`
+     *
+     * @param options - Offset/limit, a free-text filter and a from/to time window
+     * @returns The audit records on the requested page
      */
-    get(projectIdOrKey: string, options?: {
-        expand?: string[];
-        properties?: string[];
-    }): Promise<Project>;
+    list(options?: AuditListOptions): Promise<AuditRecord[]>;
     /**
-     * Get all projects (paginated)
+     * Async iterator over every matching audit record, paging transparently.
+     *
+     * `GET /rest/api/3/auditing/record`
+     *
+     * @param options - Filter options (`offset` is managed by the iterator)
+     * @returns An async generator yielding audit records
      */
-    list(options?: GetProjectsOptions): Promise<ProjectSearchResult>;
+    iterate(options?: Omit<AuditListOptions, 'offset'>): AsyncGenerator<AuditRecord, void, undefined>;
     /**
-     * Create a new project
+     * Collect every matching audit record into an array.
+     *
+     * `GET /rest/api/3/auditing/record`
+     *
+     * @param options - Filter options
+     * @returns All matching audit records across all pages
      */
-    create(input: CreateProjectInput): Promise<Project>;
+    all(options?: Omit<AuditListOptions, 'offset'>): Promise<AuditRecord[]>;
     /**
-     * Update a project
+     * Fetch a single page of audit records, including its pagination metadata.
      */
-    update(projectIdOrKey: string, input: UpdateProjectInput): Promise<Project>;
+    private listPage;
+}
+
+/**
+ * Bulk operations service for batch processing of Jira issues.
+ *
+ * Jira enforces a hard limit of 1000 issues per bulk request; inputs larger
+ * than that are rejected by the request schema before any call is made.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Create many issues at once
+ * const result = await client.bulk.createIssues({
+ *   issueUpdates: [
+ *     { fields: { project: { key: 'PROJ' }, summary: 'One', issuetype: { name: 'Task' } } },
+ *     { fields: { project: { key: 'PROJ' }, summary: 'Two', issuetype: { name: 'Task' } } },
+ *   ],
+ * });
+ *
+ * // Wait for a long-running task to finish
+ * const progress = await client.bulk.waitForCompletion(taskId, { timeoutMs: 60_000 });
+ * ```
+ */
+declare class BulkService extends BaseService {
     /**
-     * Delete a project
+     * Create multiple issues in a single request.
+     *
+     * `POST /rest/api/3/issue/bulk`
+     *
+     * @param input - The issues to create (1-1000 entries).
+     * @returns The created issues plus any per-element errors.
      */
-    deleteProject(projectIdOrKey: string, options?: {
-        enableUndo?: boolean;
-    }): Promise<void>;
+    createIssues(input: CreateIssuesInput): Promise<CreateIssuesResult>;
     /**
-     * Archive a project
+     * Delete multiple issues in a single request.
+     *
+     * `DELETE /rest/api/3/issue/bulk`
+     *
+     * Warning: this operation cannot be undone.
+     *
+     * @param input - The issue IDs or keys to delete (1-1000 entries).
+     * @returns Nothing; the endpoint responds with 204 No Content.
      */
-    archive(projectIdOrKey: string): Promise<void>;
+    deleteIssues(input: DeleteIssuesInput): Promise<void>;
     /**
-     * Restore an archived project
+     * Get the current progress of a long-running bulk operation.
+     *
+     * `GET /rest/api/3/task/{taskId}`
+     *
+     * @param taskId - The task identifier returned by the bulk operation.
+     * @returns The current progress of the task.
      */
-    restore(projectIdOrKey: string): Promise<Project>;
+    getProgress(taskId: string): Promise<BulkOperationProgress>;
     /**
-     * Get recent projects
+     * Poll a long-running bulk operation until it reaches a terminal state.
+     *
+     * Terminal states are `COMPLETE`, `FAILED` and `CANCELLED`. Unlike the Go
+     * SDK, this implementation supports both an `AbortSignal` and an overall
+     * timeout.
+     *
+     * `GET /rest/api/3/task/{taskId}` (polled)
+     *
+     * @param taskId - The task identifier returned by the bulk operation.
+     * @param options - Poll interval, overall timeout and abort signal.
+     * @returns The final progress of the task.
+     * @throws {AbortError} When `options.signal` is aborted.
+     * @throws {TimeoutError} When `options.timeoutMs` elapses first.
      */
-    getRecent(options?: {
-        expand?: string[];
-        properties?: string[];
-    }): Promise<Project[]>;
+    waitForCompletion(taskId: string, options?: WaitForCompletionOptions): Promise<BulkOperationProgress>;
 }
 
 /**
- * Search result schema
+ * Dashboard service for managing Jira dashboards and their gadgets
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // List the current user's favourite dashboards
+ * const page = await client.dashboards.list({ filter: 'favourite' });
+ *
+ * // Add a gadget
+ * await client.dashboards.addGadget('10000', {
+ *   moduleKey: 'com.atlassian.jira.gadgets:filter-results',
+ *   position: { row: 0, column: 0 },
+ * });
+ * ```
  */
-declare const SearchResultSchema: z.ZodObject<{
-    expand: z.ZodOptional<z.ZodString>;
-    startAt: z.ZodNumber;
-    maxResults: z.ZodNumber;
-    total: z.ZodNumber;
-    issues: z.ZodArray<z.ZodObject<{
-        expand: z.ZodOptional<z.ZodString>;
-        id: z.ZodString;
-        self: z.ZodURL;
-        key: z.ZodString;
-        fields: z.ZodObject<{
-            summary: z.ZodString;
-            description: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+declare class DashboardService extends BaseService {
+    /**
+     * List dashboards visible to the current user
+     *
+     * `GET /rest/api/3/dashboard`
+     *
+     * @param options - Filter (`favourite` / `my`) and pagination options
+     * @returns A page of dashboards
+     */
+    list(options?: ListDashboardsOptions): Promise<DashboardListResult>;
+    /**
+     * Async iterator over every dashboard matching the given options
+     *
+     * @param options - List options (`startAt` is managed by the iterator)
+     * @returns An async generator yielding dashboards page by page
+     *
+     * @example
+     * ```typescript
+     * for await (const dashboard of client.dashboards.iterate()) {
+     *   console.log(dashboard.id, dashboard.name);
+     * }
+     * ```
+     */
+    iterate(options?: Omit<ListDashboardsOptions, 'startAt'>): AsyncGenerator<Dashboard, void, undefined>;
+    /**
+     * Collect every dashboard matching the given options into an array
+     *
+     * Loads all pages into memory — prefer `iterate()` for large result sets.
+     *
+     * @param options - List options (`startAt` is managed internally)
+     * @returns All matching dashboards
+     */
+    all(options?: Omit<ListDashboardsOptions, 'startAt'>): Promise<Dashboard[]>;
+    /**
+     * Get a dashboard by ID
+     *
+     * `GET /rest/api/3/dashboard/{dashboardId}`
+     *
+     * @param dashboardId - ID of the dashboard
+     * @returns The requested dashboard
+     */
+    get(dashboardId: string): Promise<Dashboard>;
+    /**
+     * Create a new dashboard
+     *
+     * `POST /rest/api/3/dashboard`
+     *
+     * @param input - Dashboard definition (name is required)
+     * @returns The created dashboard
+     */
+    create(input: CreateDashboardInput): Promise<Dashboard>;
+    /**
+     * Update a dashboard
+     *
+     * `PUT /rest/api/3/dashboard/{dashboardId}`
+     *
+     * @param dashboardId - ID of the dashboard to update
+     * @param input - Fields to change
+     * @returns The updated dashboard
+     */
+    update(dashboardId: string, input: UpdateDashboardInput): Promise<Dashboard>;
+    /**
+     * Delete a dashboard
+     *
+     * `DELETE /rest/api/3/dashboard/{dashboardId}`
+     *
+     * @param dashboardId - ID of the dashboard to delete
+     * @returns Nothing
+     */
+    deleteDashboard(dashboardId: string): Promise<void>;
+    /**
+     * Copy an existing dashboard
+     *
+     * `POST /rest/api/3/dashboard/{dashboardId}/copy`
+     *
+     * @param dashboardId - ID of the dashboard to copy
+     * @param input - Definition of the copy (name is required)
+     * @returns The newly created dashboard
+     */
+    copy(dashboardId: string, input: CreateDashboardInput): Promise<Dashboard>;
+    /**
+     * Get all gadgets on a dashboard
+     *
+     * `GET /rest/api/3/dashboard/{dashboardId}/gadget`
+     *
+     * @param dashboardId - ID of the dashboard
+     * @returns The dashboard's gadgets
+     */
+    getGadgets(dashboardId: string): Promise<DashboardGadget[]>;
+    /**
+     * Add a gadget to a dashboard
+     *
+     * `POST /rest/api/3/dashboard/{dashboardId}/gadget`
+     *
+     * @param dashboardId - ID of the dashboard
+     * @param input - Gadget definition (module key is required)
+     * @returns The created gadget
+     */
+    addGadget(dashboardId: string, input: AddGadgetInput): Promise<DashboardGadget>;
+    /**
+     * Update a gadget on a dashboard
+     *
+     * `PUT /rest/api/3/dashboard/{dashboardId}/gadget/{gadgetId}`
+     *
+     * Deviates from the Go SDK, which decodes a gadget from the response body.
+     * The endpoint is documented as returning `204 No Content`, so there is no
+     * body to decode and attempting to validate one fails against a live
+     * instance.
+     *
+     * @param dashboardId - ID of the dashboard
+     * @param gadgetId - ID of the gadget
+     * @param input - Fields to change (title, color, position)
+     * @returns Nothing; resolves once the gadget is updated
+     */
+    updateGadget(dashboardId: string, gadgetId: number, input: UpdateGadgetInput): Promise<void>;
+    /**
+     * Remove a gadget from a dashboard
+     *
+     * `DELETE /rest/api/3/dashboard/{dashboardId}/gadget/{gadgetId}`
+     *
+     * @param dashboardId - ID of the dashboard
+     * @param gadgetId - ID of the gadget to remove
+     * @returns Nothing
+     */
+    removeGadget(dashboardId: string, gadgetId: number): Promise<void>;
+}
+
+/**
+ * Jira Expressions service.
+ *
+ * Jira expressions power custom automation and dynamic content. This service
+ * exposes the legacy evaluation endpoint, the Enhanced Search evaluation
+ * endpoint, and static analysis.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const result = await client.expressions.evaluateExpression({
+ *   expression: 'issue.summary',
+ *   context: { issue: { key: 'PROJ-123' } },
+ * });
+ *
+ * const analysis = await client.expressions.analyze({
+ *   expressions: ['issue.summary', 'user.displayName'],
+ * });
+ * ```
+ */
+declare class ExpressionService extends BaseService {
+    /**
+     * Evaluate a Jira expression using the legacy endpoint.
+     *
+     * `POST /rest/api/3/expression/eval`
+     *
+     * @deprecated Use {@link ExpressionService.evaluateExpression} instead. Atlassian
+     * removed `/rest/api/3/expression/eval` on August 1, 2025; the replacement uses the
+     * Enhanced Search API (eventual consistency) for better performance and scalability.
+     *
+     * @param input - The expression and its evaluation context.
+     * @returns The evaluated value plus optional metadata and errors.
+     */
+    evaluate(input: EvaluationInput): Promise<EvaluationResult>;
+    /**
+     * Evaluate a Jira expression using the Enhanced Search API.
+     *
+     * `POST /rest/api/3/expression/evaluate`
+     *
+     * Compared with {@link ExpressionService.evaluate} this endpoint offers better
+     * performance and scalability, at the cost of eventual rather than strong
+     * consistency. Input and output shapes are identical.
+     *
+     * @param input - The expression and its evaluation context.
+     * @returns The evaluated value plus optional metadata and errors.
+     */
+    evaluateExpression(input: EvaluationInput): Promise<EvaluationResult>;
+    /**
+     * Analyse Jira expressions for syntax validity, type and complexity.
+     *
+     * `POST /rest/api/3/expression/analyse`
+     *
+     * @param input - One or more expressions plus an optional context.
+     * @returns One analysis entry per submitted expression.
+     */
+    analyze(input: AnalysisInput): Promise<AnalysisResult>;
+}
+
+/**
+ * Field service for managing Jira system and custom fields,
+ * their contexts, options and project associations.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // List all fields
+ * const fields = await client.fields.list();
+ *
+ * // Create a custom field, then associate its context with projects
+ * const field = await client.fields.create({
+ *   name: 'Story Points',
+ *   type: 'com.atlassian.jira.plugin.system.customfieldtypes:float',
+ *   searcherKey: 'com.atlassian.jira.plugin.system.customfieldtypes:exactnumber',
+ * });
+ * const [context] = await client.fields.listContexts(field.id);
+ * await client.fields.associateContextProjects(field.id, context.id, {
+ *   projectIds: ['10000'],
+ * });
+ * ```
+ */
+declare class FieldService extends BaseService {
+    /**
+     * Get all fields (system and custom)
+     *
+     * `GET /rest/api/3/field`
+     *
+     * @returns All fields visible to the caller
+     */
+    list(): Promise<Field[]>;
+    /**
+     * Get a single field by ID or key
+     *
+     * `GET /rest/api/3/field/{fieldId}`
+     *
+     * @param fieldId - Field ID or key (e.g. `customfield_10000`)
+     * @returns The requested field
+     */
+    get(fieldId: string): Promise<Field>;
+    /**
+     * Create a custom field
+     *
+     * `POST /rest/api/3/field`
+     *
+     * @param input - Name, type and searcher key of the new custom field
+     * @returns The created field
+     */
+    create(input: CreateFieldInput): Promise<Field>;
+    /**
+     * Update a custom field
+     *
+     * `PUT /rest/api/3/field/{fieldId}`
+     *
+     * @param fieldId - Field ID or key
+     * @param input - Fields to update
+     * @returns The updated field
+     */
+    update(fieldId: string, input: UpdateFieldInput): Promise<Field>;
+    /**
+     * Delete a custom field
+     *
+     * `DELETE /rest/api/3/field/{fieldId}`
+     *
+     * @param fieldId - Field ID or key
+     * @returns Nothing
+     */
+    deleteField(fieldId: string): Promise<void>;
+    /**
+     * Get the contexts of a custom field
+     *
+     * `GET /rest/api/3/field/{fieldId}/context`
+     *
+     * @param fieldId - Field ID or key
+     * @returns The contexts defined for the field
+     */
+    listContexts(fieldId: string): Promise<FieldContext[]>;
+    /**
+     * Create a context for a custom field
+     *
+     * `POST /rest/api/3/field/{fieldId}/context`
+     *
+     * @param fieldId - Field ID or key
+     * @param input - Context name plus optional project / issue type restrictions
+     * @returns The created context
+     */
+    createContext(fieldId: string, input: CreateFieldContextInput): Promise<FieldContext>;
+    /**
+     * Update a custom field context
+     *
+     * `PUT /rest/api/3/field/{fieldId}/context/{contextId}`
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @param input - Name and/or description to update
+     * @returns The updated context
+     */
+    updateContext(fieldId: string, contextId: string, input: UpdateFieldContextInput): Promise<FieldContext>;
+    /**
+     * Delete a custom field context
+     *
+     * `DELETE /rest/api/3/field/{fieldId}/context/{contextId}`
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @returns Nothing
+     */
+    deleteContext(fieldId: string, contextId: string): Promise<void>;
+    /**
+     * Get the options of a select / multi-select custom field context
+     *
+     * `GET /rest/api/3/field/{fieldId}/context/{contextId}/option`
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @returns The options defined for the context
+     */
+    listOptions(fieldId: string, contextId: string): Promise<FieldOption[]>;
+    /**
+     * Create one or more options on a select / multi-select custom field context
+     *
+     * `POST /rest/api/3/field/{fieldId}/context/{contextId}/option`
+     *
+     * The endpoint is bulk in both directions: it takes `{ options: [...] }` and
+     * returns `{ options: [...] }`. The Go SDK posts a bare option object and
+     * decodes a bare option, which this endpoint rejects.
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @param inputs - The options to create
+     * @returns The created options, in the order the API returned them
+     */
+    createOptions(fieldId: string, contextId: string, inputs: CreateFieldOptionInput[]): Promise<FieldOption[]>;
+    /**
+     * Create a single option on a select / multi-select custom field context
+     *
+     * Convenience wrapper over {@link createOptions} for the common one-option
+     * case.
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @param input - The option value
+     * @returns The created option
+     * @throws If the API reports success but returns no option
+     */
+    createOption(fieldId: string, contextId: string, input: CreateFieldOptionInput): Promise<FieldOption>;
+    /**
+     * Associate projects with a custom field context
+     *
+     * `PUT /rest/api/3/field/{fieldId}/context/{contextId}/project`
+     *
+     * Required since Jira Cloud CHANGE-3033 (February 2026): creating a custom
+     * field no longer auto-associates it with projects.
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @param input - The project IDs to associate (at least one)
+     * @returns Nothing
+     */
+    associateContextProjects(fieldId: string, contextId: string, input: AssociateContextProjectsInput): Promise<void>;
+    /**
+     * Remove projects from a custom field context
+     *
+     * `POST /rest/api/3/field/{fieldId}/context/{contextId}/project/remove`
+     *
+     * @param fieldId - Field ID or key
+     * @param contextId - Context ID
+     * @param input - The project IDs to remove (at least one)
+     * @returns Nothing
+     */
+    removeContextProjects(fieldId: string, contextId: string, input: RemoveContextProjectsInput): Promise<void>;
+    /**
+     * Get the context-to-project mappings of a custom field
+     *
+     * `GET /rest/api/3/field/{fieldId}/context/projectmapping`
+     *
+     * @param fieldId - Field ID or key
+     * @param options - Optional context ID filter and pagination
+     * @returns The context-to-project mappings
+     */
+    getContextProjectMappings(fieldId: string, options?: GetContextProjectMappingsOptions): Promise<ContextProjectMapping[]>;
+}
+
+/**
+ * Filter service for managing Jira filters (saved JQL searches)
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Create a filter
+ * const filter = await client.filters.create({
+ *   name: 'My Bugs',
+ *   jql: 'project = PROJ AND type = Bug AND resolution = Unresolved',
+ * });
+ *
+ * // Iterate every filter the user can see
+ * for await (const f of client.filters.iterate()) {
+ *   console.log(f.id, f.name);
+ * }
+ * ```
+ */
+declare class FilterService extends BaseService {
+    /**
+     * Get a filter by ID
+     *
+     * `GET /rest/api/3/filter/{filterId}`
+     *
+     * @param filterId - ID of the filter
+     * @param options - Optional expand and share-permission override
+     * @returns The requested filter
+     */
+    get(filterId: string, options?: GetFilterOptions): Promise<Filter>;
+    /**
+     * Create a new filter
+     *
+     * `POST /rest/api/3/filter`
+     *
+     * @param input - Filter definition (name and JQL are required)
+     * @returns The created filter
+     */
+    create(input: CreateFilterInput): Promise<Filter>;
+    /**
+     * Update an existing filter
+     *
+     * `PUT /rest/api/3/filter/{filterId}`
+     *
+     * @param filterId - ID of the filter to update
+     * @param input - Fields to change
+     * @returns The updated filter
+     */
+    update(filterId: string, input: UpdateFilterInput): Promise<Filter>;
+    /**
+     * Delete a filter
+     *
+     * `DELETE /rest/api/3/filter/{filterId}`
+     *
+     * @param filterId - ID of the filter to delete
+     * @returns Nothing
+     */
+    deleteFilter(filterId: string): Promise<void>;
+    /**
+     * Search filters with optional filtering and pagination
+     *
+     * `GET /rest/api/3/filter/search`
+     *
+     * @param options - Search, sort and pagination options
+     * @returns A page of filters
+     */
+    list(options?: ListFiltersOptions): Promise<FilterSearchResult>;
+    /**
+     * Async iterator over every filter matching the given options
+     *
+     * @param options - Search options (`startAt` is managed by the iterator)
+     * @returns An async generator yielding filters page by page
+     *
+     * @example
+     * ```typescript
+     * for await (const filter of client.filters.iterate({ filterName: 'bug' })) {
+     *   console.log(filter.name);
+     * }
+     * ```
+     */
+    iterate(options?: Omit<ListFiltersOptions, 'startAt'>): AsyncGenerator<Filter, void, undefined>;
+    /**
+     * Collect every filter matching the given options into an array
+     *
+     * Loads all pages into memory — prefer `iterate()` for large result sets.
+     *
+     * @param options - Search options (`startAt` is managed internally)
+     * @returns All matching filters
+     */
+    all(options?: Omit<ListFiltersOptions, 'startAt'>): Promise<Filter[]>;
+    /**
+     * Get the current user's favourite filters
+     *
+     * `GET /rest/api/3/filter/favourite`
+     *
+     * @param options - Optional expand
+     * @returns The current user's favourite filters
+     */
+    getFavorites(options?: {
+        expand?: string[];
+    }): Promise<Filter[]>;
+    /**
+     * Get filters owned by the current user
+     *
+     * `GET /rest/api/3/filter/my`
+     *
+     * @param options - Optional expand and whether to include favourites
+     * @returns Filters owned by the current user
+     */
+    getMyFilters(options?: GetMyFiltersOptions): Promise<Filter[]>;
+    /**
+     * Mark a filter as a favourite of the current user
+     *
+     * `PUT /rest/api/3/filter/{filterId}/favourite`
+     *
+     * @param filterId - ID of the filter
+     * @returns The updated filter
+     */
+    setFavorite(filterId: string): Promise<Filter>;
+    /**
+     * Remove a filter from the current user's favourites
+     *
+     * `DELETE /rest/api/3/filter/{filterId}/favourite`
+     *
+     * @param filterId - ID of the filter
+     * @returns The updated filter
+     */
+    removeFavorite(filterId: string): Promise<Filter>;
+    /**
+     * Get the default share scope for the current user
+     *
+     * `GET /rest/api/3/filter/defaultShareScope`
+     *
+     * @returns The default share scope (`GLOBAL`, `AUTHENTICATED` or `PRIVATE`)
+     */
+    getDefaultShareScope(): Promise<FilterShareScope>;
+    /**
+     * Set the default share scope for the current user
+     *
+     * `PUT /rest/api/3/filter/defaultShareScope`
+     *
+     * @param scope - The scope to set (`GLOBAL`, `AUTHENTICATED` or `PRIVATE`)
+     * @returns Nothing
+     */
+    setDefaultShareScope(scope: FilterShareScope): Promise<void>;
+    /**
+     * Get a single share permission of a filter
+     *
+     * `GET /rest/api/3/filter/{filterId}/permission/{permissionId}`
+     *
+     * @param filterId - ID of the filter
+     * @param permissionId - ID of the share permission
+     * @returns The share permission
+     */
+    getSharePermission(filterId: string, permissionId: number): Promise<FilterPermission>;
+    /**
+     * Add a share permission to a filter
+     *
+     * `POST /rest/api/3/filter/{filterId}/permission`
+     *
+     * @param filterId - ID of the filter
+     * @param input - Share permission to add (`type` is required)
+     * @returns The filter's share permissions after the addition
+     */
+    addSharePermission(filterId: string, input: AddSharePermissionInput): Promise<FilterPermission[]>;
+    /**
+     * Remove a share permission from a filter
+     *
+     * `DELETE /rest/api/3/filter/{filterId}/permission/{permissionId}`
+     *
+     * @param filterId - ID of the filter
+     * @param permissionId - ID of the share permission to remove
+     * @returns Nothing
+     */
+    deleteSharePermission(filterId: string, permissionId: number): Promise<void>;
+}
+
+/**
+ * Group service for managing Jira groups and their membership.
+ *
+ * Every method takes an options object rather than positional identifiers,
+ * mirroring the Go SDK — most group endpoints accept either a group name or
+ * a group ID.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Search for groups
+ * const groups = await client.groups.find({ query: 'jira', maxResults: 50 });
+ *
+ * // Read a group and its members
+ * const group = await client.groups.get({ groupname: 'jira-administrators', expand: ['users'] });
+ *
+ * // Iterate every member
+ * for await (const user of client.groups.iterateMembers({ groupname: 'jira-users' })) {
+ *   console.log(user.accountId);
+ * }
+ * ```
+ */
+declare class GroupService extends BaseService {
+    /**
+     * Search for groups whose name matches a query.
+     *
+     * `GET /rest/api/3/groups/picker`
+     *
+     * @param options - Query string, exclusions, page size and an optional user filter
+     * @returns The matching groups
+     */
+    find(options?: FindGroupsOptions): Promise<Group[]>;
+    /**
+     * Get a single group, optionally expanding its users.
+     *
+     * `GET /rest/api/3/group`
+     *
+     * @param options - One of `groupname` or `groupId`, plus optional `expand`
+     * @returns The group
+     */
+    get(options: GetGroupOptions): Promise<Group>;
+    /**
+     * Create a group.
+     *
+     * `POST /rest/api/3/group`
+     *
+     * @param input - The name of the group to create
+     * @returns The created group
+     */
+    create(input: CreateGroupInput): Promise<Group>;
+    /**
+     * Delete a group.
+     *
+     * `DELETE /rest/api/3/group`
+     *
+     * @param options - One of `groupname` or `groupId`
+     * @returns Nothing
+     */
+    deleteGroup(options: DeleteGroupOptions): Promise<void>;
+    /**
+     * Get the members of a group.
+     *
+     * `GET /rest/api/3/group/member`
+     *
+     * @param options - One of `groupname` or `groupId`, plus pagination options
+     * @returns The members on the requested page
+     */
+    getMembers(options: GetGroupMembersOptions): Promise<GroupUser[]>;
+    /**
+     * Async iterator over every member of a group, paging transparently.
+     *
+     * `GET /rest/api/3/group/member`
+     *
+     * @param options - Group identifier and page size (`startAt` is managed by the iterator)
+     * @returns An async generator yielding group members
+     */
+    iterateMembers(options: Omit<GetGroupMembersOptions, 'startAt'>): AsyncGenerator<GroupUser, void, undefined>;
+    /**
+     * Collect every member of a group into an array.
+     *
+     * `GET /rest/api/3/group/member`
+     *
+     * @param options - Group identifier and page size
+     * @returns All members across all pages
+     */
+    allMembers(options: Omit<GetGroupMembersOptions, 'startAt'>): Promise<GroupUser[]>;
+    /**
+     * Add a user to a group.
+     *
+     * `POST /rest/api/3/group/user`
+     *
+     * @param options - Group identifier plus the `accountId` of the user to add
+     * @returns The updated group
+     */
+    addUser(options: AddGroupUserOptions): Promise<Group>;
+    /**
+     * Remove a user from a group.
+     *
+     * `DELETE /rest/api/3/group/user`
+     *
+     * @param options - Group identifier plus one of `accountId` or `username`
+     * @returns Nothing
+     */
+    removeUser(options: RemoveGroupUserOptions): Promise<void>;
+    /**
+     * Get multiple groups by name or ID.
+     *
+     * `GET /rest/api/3/group/bulk`
+     *
+     * @param options - `groupName` and/or `groupId` lists, plus pagination options
+     * @returns The groups on the requested page
+     */
+    bulkGet(options: BulkGetGroupsOptions): Promise<Group[]>;
+    /**
+     * Async iterator over every group matched by a bulk lookup.
+     *
+     * `GET /rest/api/3/group/bulk`
+     *
+     * @param options - Group name/ID lists and page size (`startAt` is managed by the iterator)
+     * @returns An async generator yielding groups
+     */
+    iterateBulk(options: Omit<BulkGetGroupsOptions, 'startAt'>): AsyncGenerator<Group, void, undefined>;
+    /**
+     * Collect every group matched by a bulk lookup into an array.
+     *
+     * `GET /rest/api/3/group/bulk`
+     *
+     * @param options - Group name/ID lists and page size
+     * @returns All matching groups across all pages
+     */
+    allBulk(options: Omit<BulkGetGroupsOptions, 'startAt'>): Promise<Group[]>;
+    /**
+     * Fetch a single page of group members, including its pagination metadata.
+     */
+    private getMembersPage;
+    /**
+     * Fetch a single page of bulk group results, including its pagination metadata.
+     */
+    private bulkGetPage;
+    /**
+     * Guard shared by the endpoints that accept either a group name or a group ID.
+     */
+    private requireGroupIdentifier;
+    /**
+     * Decide whether a page is the final one.
+     */
+    private isLastPage;
+}
+
+/**
+ * Issue service for CRUD operations on Jira issues
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Get an issue
+ * const issue = await client.issues.get('PROJECT-123');
+ *
+ * // Create an issue
+ * const newIssue = await client.issues.create({
+ *   fields: {
+ *     project: { key: 'PROJECT' },
+ *     summary: 'New issue',
+ *     issuetype: { name: 'Task' },
+ *   },
+ * });
+ *
+ * // Update an issue
+ * await client.issues.update('PROJECT-123', {
+ *   fields: { summary: 'Updated summary' },
+ * });
+ *
+ * // Delete an issue
+ * await client.issues.delete('PROJECT-123');
+ * ```
+ */
+declare class IssueService extends BaseService {
+    /**
+     * Get an issue by key or ID
+     */
+    get(issueIdOrKey: string, options?: GetIssueOptions): Promise<Issue>;
+    /**
+     * Create a new issue
+     */
+    create(input: CreateIssueInput): Promise<CreateIssueResponse>;
+    /**
+     * Update an issue
+     */
+    update(issueIdOrKey: string, input: UpdateIssueInput, options?: {
+        notifyUsers?: boolean;
+        overrideScreenSecurity?: boolean;
+        overrideEditableFlag?: boolean;
+    }): Promise<void>;
+    /**
+     * Delete an issue
+     */
+    deleteIssue(issueIdOrKey: string, options?: {
+        deleteSubtasks?: boolean;
+    }): Promise<void>;
+    /**
+     * Get comments for an issue
+     */
+    getComments(issueIdOrKey: string, options?: {
+        startAt?: number;
+        maxResults?: number;
+        orderBy?: string;
+        expand?: string[];
+    }): Promise<CommentsPage>;
+    /**
+     * Get a specific comment
+     */
+    getComment(issueIdOrKey: string, commentId: string, options?: {
+        expand?: string[];
+    }): Promise<Comment>;
+    /**
+     * Add a comment to an issue
+     */
+    addComment(issueIdOrKey: string, input: AddCommentInput, options?: {
+        expand?: string[];
+    }): Promise<Comment>;
+    /**
+     * Update a comment
+     */
+    updateComment(issueIdOrKey: string, commentId: string, input: UpdateCommentInput, options?: {
+        expand?: string[];
+    }): Promise<Comment>;
+    /**
+     * Delete a comment
+     */
+    deleteComment(issueIdOrKey: string, commentId: string): Promise<void>;
+    /**
+     * Get available transitions for an issue
+     */
+    getTransitions(issueIdOrKey: string, options?: {
+        expand?: string[];
+        transitionId?: string;
+    }): Promise<TransitionsResponse>;
+    /**
+     * Transition an issue to a new status
+     */
+    doTransition(issueIdOrKey: string, input: DoTransitionInput): Promise<void>;
+    /**
+     * Get watchers for an issue
+     */
+    getWatchers(issueIdOrKey: string): Promise<Watchers>;
+    /**
+     * Add a watcher to an issue
+     */
+    addWatcher(issueIdOrKey: string, accountId: string): Promise<void>;
+    /**
+     * Remove a watcher from an issue
+     */
+    removeWatcher(issueIdOrKey: string, accountId: string): Promise<void>;
+    /**
+     * Get worklogs for an issue
+     */
+    getWorklogs(issueIdOrKey: string, options?: {
+        startAt?: number;
+        maxResults?: number;
+        startedAfter?: number;
+        startedBefore?: number;
+        expand?: string[];
+    }): Promise<WorklogsPage>;
+    /**
+     * Get a specific worklog
+     */
+    getWorklog(issueIdOrKey: string, worklogId: string, options?: {
+        expand?: string[];
+    }): Promise<Worklog>;
+    /**
+     * Add a worklog to an issue
+     */
+    addWorklog(issueIdOrKey: string, input: AddWorklogInput, options?: {
+        notifyUsers?: boolean;
+        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
+        newEstimate?: string;
+        reduceBy?: string;
+        expand?: string[];
+    }): Promise<Worklog>;
+    /**
+     * Update a worklog
+     */
+    updateWorklog(issueIdOrKey: string, worklogId: string, input: UpdateWorklogInput, options?: {
+        notifyUsers?: boolean;
+        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
+        newEstimate?: string;
+        expand?: string[];
+    }): Promise<Worklog>;
+    /**
+     * Delete a worklog
+     */
+    deleteWorklog(issueIdOrKey: string, worklogId: string, options?: {
+        notifyUsers?: boolean;
+        adjustEstimate?: 'new' | 'leave' | 'manual' | 'auto';
+        newEstimate?: string;
+        increaseBy?: string;
+    }): Promise<void>;
+    /**
+     * Add your vote to an issue
+     */
+    addVote(issueIdOrKey: string): Promise<void>;
+    /**
+     * Remove your vote from an issue
+     */
+    removeVote(issueIdOrKey: string): Promise<void>;
+    /**
+     * Add an attachment to an issue
+     *
+     * @param issueIdOrKey - Issue ID or key
+     * @param file - File or Blob to upload
+     * @param filename - Optional filename (defaults to File.name or 'attachment')
+     * @returns Array of created attachments
+     *
+     * @example
+     * ```typescript
+     * const file = new File(['content'], 'document.txt', { type: 'text/plain' });
+     * const attachments = await client.issues.addAttachment('PROJECT-123', file);
+     * ```
+     */
+    addAttachment(issueIdOrKey: string, file: File | Blob, filename?: string): Promise<Attachment[]>;
+    /**
+     * Get attachment metadata by ID
+     *
+     * @param attachmentId - Attachment ID
+     * @returns Attachment metadata
+     */
+    getAttachment(attachmentId: string): Promise<AttachmentMetadata>;
+    /**
+     * Download attachment content
+     *
+     * @param attachmentId - Attachment ID
+     * @returns Blob containing the attachment content
+     */
+    downloadAttachment(attachmentId: string): Promise<Blob>;
+    /**
+     * Delete an attachment
+     *
+     * @param attachmentId - Attachment ID
+     */
+    deleteAttachment(attachmentId: string): Promise<void>;
+    /**
+     * Get all links for an issue
+     *
+     * @param issueIdOrKey - Issue ID or key
+     * @returns Array of issue links
+     */
+    getIssueLinks(issueIdOrKey: string): Promise<IssueLink[]>;
+    /**
+     * Create a link between two issues
+     *
+     * @param input - Issue link creation input
+     *
+     * @example
+     * ```typescript
+     * await client.issues.createIssueLink({
+     *   type: { name: 'Blocks' },
+     *   inwardIssue: { key: 'PROJECT-123' },
+     *   outwardIssue: { key: 'PROJECT-456' },
+     * });
+     * ```
+     */
+    createIssueLink(input: CreateIssueLinkInput): Promise<void>;
+    /**
+     * Get an issue link by ID
+     *
+     * @param linkId - Issue link ID
+     * @returns Issue link
+     */
+    getIssueLink(linkId: string): Promise<IssueLink>;
+    /**
+     * Delete an issue link
+     *
+     * @param linkId - Issue link ID
+     */
+    deleteIssueLink(linkId: string): Promise<void>;
+    /**
+     * List all available issue link types
+     *
+     * @deprecated Prefer `client.issueLinkTypes.list()`. Issue link types are
+     * instance-level configuration rather than a property of an issue; the
+     * dedicated service also offers create/update/delete. Kept for
+     * compatibility.
+     *
+     * @returns Issue link types response
+     */
+    listIssueLinkTypes(): Promise<IssueLinkTypesResponse>;
+    /**
+     * Get a specific issue link type
+     *
+     * @deprecated Prefer `client.issueLinkTypes.get()`. Kept for compatibility.
+     *
+     * @param linkTypeId - Issue link type ID
+     * @returns Issue link type
+     */
+    getIssueLinkType(linkTypeId: string): Promise<IssueLinkType>;
+}
+
+/**
+ * Issue link type service for managing the relationship types
+ * available when linking issues.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const linkTypes = await client.issueLinkTypes.list();
+ *
+ * const created = await client.issueLinkTypes.create({
+ *   name: 'Dependency',
+ *   inward: 'depends on',
+ *   outward: 'is depended on by',
+ * });
+ * ```
+ */
+declare class IssueLinkTypeService extends BaseService {
+    /**
+     * Get all issue link types
+     *
+     * `GET /rest/api/3/issueLinkType`
+     *
+     * @returns All issue link types configured on the instance
+     */
+    list(): Promise<IssueLinkType[]>;
+    /**
+     * Get a single issue link type by ID
+     *
+     * `GET /rest/api/3/issueLinkType/{issueLinkTypeId}`
+     *
+     * @param issueLinkTypeId - Issue link type ID
+     * @returns The requested issue link type
+     */
+    get(issueLinkTypeId: string): Promise<IssueLinkType>;
+    /**
+     * Create an issue link type
+     *
+     * `POST /rest/api/3/issueLinkType`
+     *
+     * @param input - Name plus the inward and outward descriptions
+     * @returns The created issue link type
+     */
+    create(input: CreateIssueLinkTypeInput): Promise<IssueLinkType>;
+    /**
+     * Update an issue link type
+     *
+     * `PUT /rest/api/3/issueLinkType/{issueLinkTypeId}`
+     *
+     * @param issueLinkTypeId - Issue link type ID
+     * @param input - Fields to update
+     * @returns The updated issue link type
+     */
+    update(issueLinkTypeId: string, input: UpdateIssueLinkTypeInput): Promise<IssueLinkType>;
+    /**
+     * Delete an issue link type
+     *
+     * `DELETE /rest/api/3/issueLinkType/{issueLinkTypeId}`
+     *
+     * @param issueLinkTypeId - Issue link type ID
+     * @returns Nothing
+     */
+    deleteIssueLinkType(issueLinkTypeId: string): Promise<void>;
+}
+
+/**
+ * Issue type service for managing Jira issue types and issue type schemes.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Create an issue type and add it to a scheme
+ * const issueType = await client.issueTypes.create({ name: 'Incident', type: 'standard' });
+ * await client.issueTypes.addIssueTypesToScheme('10000', {
+ *   issueTypeIds: [issueType.id],
+ * });
+ * ```
+ */
+declare class IssueTypeService extends BaseService {
+    /**
+     * Get all issue types
+     *
+     * `GET /rest/api/3/issuetype`
+     *
+     * @returns All issue types visible to the caller
+     */
+    list(): Promise<IssueTypeDetails[]>;
+    /**
+     * Get a single issue type by ID
+     *
+     * `GET /rest/api/3/issuetype/{issueTypeId}`
+     *
+     * @param issueTypeId - Issue type ID
+     * @returns The requested issue type
+     */
+    get(issueTypeId: string): Promise<IssueTypeDetails>;
+    /**
+     * Create an issue type
+     *
+     * `POST /rest/api/3/issuetype`
+     *
+     * @param input - Name plus optional description and `standard`/`subtask` type
+     * @returns The created issue type
+     */
+    create(input: CreateIssueTypeInput): Promise<IssueTypeDetails>;
+    /**
+     * Update an issue type
+     *
+     * `PUT /rest/api/3/issuetype/{issueTypeId}`
+     *
+     * @param issueTypeId - Issue type ID
+     * @param input - Fields to update
+     * @returns The updated issue type
+     */
+    update(issueTypeId: string, input: UpdateIssueTypeInput): Promise<IssueTypeDetails>;
+    /**
+     * Delete an issue type
+     *
+     * `DELETE /rest/api/3/issuetype/{issueTypeId}`
+     *
+     * @param issueTypeId - Issue type ID
+     * @param options - Optional issue type to move existing issues to
+     * @returns Nothing
+     */
+    deleteIssueType(issueTypeId: string, options?: {
+        alternativeIssueTypeId?: string;
+    }): Promise<void>;
+    /**
+     * Get all issue type schemes
+     *
+     * `GET /rest/api/3/issuetypescheme`
+     *
+     * @param options - Optional pagination
+     * @returns The issue type schemes
+     */
+    listIssueTypeSchemes(options?: ListIssueTypeSchemesOptions): Promise<IssueTypeScheme[]>;
+    /**
+     * Create an issue type scheme
+     *
+     * `POST /rest/api/3/issuetypescheme`
+     *
+     * Needed since Jira Cloud CHANGE-2999/3000 (February 2026): creating an
+     * issue type no longer auto-adds it to the Default Work Type Scheme.
+     *
+     * @param input - Scheme name plus the issue type IDs it contains
+     * @returns The created scheme
+     */
+    createIssueTypeScheme(input: CreateIssueTypeSchemeInput): Promise<IssueTypeScheme>;
+    /**
+     * Update an issue type scheme
+     *
+     * `PUT /rest/api/3/issuetypescheme/{schemeId}`
+     *
+     * @param schemeId - Issue type scheme ID
+     * @param input - Fields to update
+     * @returns Nothing
+     */
+    updateIssueTypeScheme(schemeId: string, input: UpdateIssueTypeSchemeInput): Promise<void>;
+    /**
+     * Delete an issue type scheme
+     *
+     * `DELETE /rest/api/3/issuetypescheme/{schemeId}`
+     *
+     * @param schemeId - Issue type scheme ID
+     * @returns Nothing
+     */
+    deleteIssueTypeScheme(schemeId: string): Promise<void>;
+    /**
+     * Add issue types to an issue type scheme
+     *
+     * `PUT /rest/api/3/issuetypescheme/{schemeId}/issuetype`
+     *
+     * @param schemeId - Issue type scheme ID
+     * @param input - The issue type IDs to add (at least one)
+     * @returns Nothing
+     */
+    addIssueTypesToScheme(schemeId: string, input: AddIssueTypesToSchemeInput): Promise<void>;
+    /**
+     * Remove an issue type from an issue type scheme
+     *
+     * `DELETE /rest/api/3/issuetypescheme/{schemeId}/issuetype/{issueTypeId}`
+     *
+     * @param schemeId - Issue type scheme ID
+     * @param issueTypeId - Issue type ID to remove
+     * @returns Nothing
+     */
+    removeIssueTypeFromScheme(schemeId: string, issueTypeId: string): Promise<void>;
+    /**
+     * Get the issue type scheme to issue type mappings
+     *
+     * `GET /rest/api/3/issuetypescheme/mapping`
+     *
+     * @param options - Optional scheme ID filter and pagination
+     * @returns The scheme-to-issue-type mappings
+     */
+    getIssueTypeSchemeMappings(options?: GetIssueTypeSchemeMappingsOptions): Promise<IssueTypeSchemeMapping[]>;
+}
+
+/**
+ * Label service for retrieving Jira labels.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const labels = await client.labels.list({ maxResults: 50 });
+ *
+ * for await (const label of client.labels.iterate()) {
+ *   console.log(label);
+ * }
+ * ```
+ */
+declare class LabelService extends BaseService {
+    /**
+     * List labels.
+     *
+     * `GET /rest/api/3/label`
+     *
+     * @param options - Pagination options.
+     * @returns The label values for the requested page.
+     */
+    list(options?: ListLabelsOptions): Promise<string[]>;
+    /**
+     * Get label suggestions for a query string.
+     *
+     * `GET /rest/api/3/jql/autocompletedata/suggestions?fieldName=labels`
+     *
+     * Deviates from the Go SDK, which calls `GET /rest/api/3/label/suggest` and
+     * reads a `{suggestions: [...]}` envelope. That endpoint is not part of the
+     * v3 API — the Labels group only documents `GET /rest/api/3/label` — so the
+     * Go call 404s. Label autocompletion is served by the JQL autocomplete
+     * endpoint, which returns `{results: [{value, displayName}]}`.
+     *
+     * @param query - The partial label to get suggestions for.
+     * @returns The suggested label values.
+     */
+    suggest(query: string): Promise<string[]>;
+    /**
+     * Async iterator over every label, transparently paginating.
+     *
+     * `GET /rest/api/3/label` (paged)
+     *
+     * @param options - Query filter and page size (`maxResults`).
+     * @returns An async generator yielding label values one at a time.
+     */
+    iterate(options?: Omit<ListLabelsOptions, 'startAt'>): AsyncGenerator<string, void, undefined>;
+    /**
+     * Collect every label into an array (loads all pages into memory).
+     *
+     * @param options - Query filter and page size (`maxResults`).
+     * @returns All matching label values.
+     */
+    all(options?: Omit<ListLabelsOptions, 'startAt'>): Promise<string[]>;
+    /**
+     * Fetch a single page of labels including its pagination metadata.
+     */
+    private listPage;
+}
+
+/**
+ * Myself service for operations on the currently authenticated user
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Who am I?
+ * const me = await client.myself.get();
+ *
+ * // Read and update preferences
+ * const prefs = await client.myself.getPreferences();
+ * await client.myself.setPreferences({ locale: 'en_US' });
+ * ```
+ */
+declare class MyselfService extends BaseService {
+    /**
+     * Get the currently authenticated user
+     *
+     * `GET /rest/api/3/myself`
+     *
+     * @returns The current user
+     */
+    get(): Promise<CurrentUser>;
+    /**
+     * Get the current user's preferences
+     *
+     * `GET /rest/api/3/mypreferences`
+     *
+     * @returns The current user's preferences
+     */
+    getPreferences(): Promise<UserPreferences>;
+    /**
+     * Set the current user's preferences
+     *
+     * `PUT /rest/api/3/mypreferences`
+     *
+     * @param input - Preferences to set
+     * @returns Nothing; resolves once the preferences are stored
+     */
+    setPreferences(input: SetUserPreferencesInput): Promise<void>;
+    /**
+     * Get a single preference of the current user by key
+     *
+     * `GET /rest/api/3/mypreferences?key={key}`
+     *
+     * Deviates from the Go SDK, which decodes the response into a map and then
+     * indexes it by `key`. The endpoint returns the preference value itself, not
+     * an object keyed by the preference name, so the Go shape never matches.
+     * Non-string JSON scalars (a boolean or numeric preference) are coerced to
+     * their string form.
+     *
+     * @param key - The preference key
+     * @returns The preference value
+     */
+    getPreference(key: string): Promise<string>;
+    /**
+     * Set a single preference of the current user
+     *
+     * `PUT /rest/api/3/mypreferences?key={key}`
+     *
+     * Deviates from the Go SDK, which sends `{[key]: value}` as the body. The
+     * endpoint takes the key from the required `key` query parameter and the
+     * request body is the raw value itself (a plain string, max 255 characters).
+     *
+     * @param key - The preference key
+     * @param value - The preference value
+     * @returns Nothing; resolves once the preference is stored
+     */
+    setPreference(key: string, value: string): Promise<void>;
+    /**
+     * Delete a single preference of the current user
+     *
+     * `DELETE /rest/api/3/mypreferences?key={key}`
+     *
+     * @param key - The preference key
+     * @returns Nothing; resolves once the preference is removed
+     */
+    deletePreference(key: string): Promise<void>;
+}
+
+/**
+ * Notification service for notification schemes and issue notifications
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // List notification schemes
+ * const page = await client.notifications.list({ maxResults: 50 });
+ *
+ * // Notify everyone watching an issue
+ * await client.notifications.sendIssueNotification('PROJ-123', {
+ *   subject: 'Important update',
+ *   textBody: 'This issue has been updated',
+ *   to: { watchers: true, assignee: true },
+ * });
+ * ```
+ */
+declare class NotificationService extends BaseService {
+    /**
+     * List notification schemes (paginated)
+     *
+     * `GET /rest/api/3/notificationscheme`
+     *
+     * @param options - Pagination and expand options
+     * @returns A page of notification schemes
+     */
+    list(options?: ListNotificationSchemesOptions): Promise<NotificationSchemePage>;
+    /**
+     * Async iterator over every notification scheme, page by page
+     *
+     * @param options - Pagination and expand options (`startAt` is managed by the iterator)
+     * @returns An async generator yielding notification schemes
+     *
+     * @example
+     * ```typescript
+     * for await (const scheme of client.notifications.iterate()) {
+     *   console.log(scheme.name);
+     * }
+     * ```
+     */
+    iterate(options?: Omit<ListNotificationSchemesOptions, 'startAt'>): AsyncGenerator<NotificationScheme, void, undefined>;
+    /**
+     * Get every notification scheme (loads all pages into memory)
+     *
+     * @param options - Pagination and expand options (`startAt` is managed internally)
+     * @returns All notification schemes
+     */
+    all(options?: Omit<ListNotificationSchemesOptions, 'startAt'>): Promise<NotificationScheme[]>;
+    /**
+     * Get a notification scheme by ID
+     *
+     * `GET /rest/api/3/notificationscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the notification scheme
+     * @returns The notification scheme
+     */
+    get(schemeId: number): Promise<NotificationScheme>;
+    /**
+     * Create a notification scheme
+     *
+     * `POST /rest/api/3/notificationscheme`
+     *
+     * @param input - Name and optional description
+     * @returns The created notification scheme
+     */
+    create(input: CreateNotificationSchemeInput): Promise<NotificationScheme>;
+    /**
+     * Update a notification scheme
+     *
+     * `PUT /rest/api/3/notificationscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the notification scheme
+     * @param input - Fields to update
+     * @returns The updated notification scheme
+     */
+    update(schemeId: number, input: UpdateNotificationSchemeInput): Promise<NotificationScheme>;
+    /**
+     * Delete a notification scheme
+     *
+     * `DELETE /rest/api/3/notificationscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the notification scheme
+     * @returns Nothing
+     */
+    deleteNotificationScheme(schemeId: number): Promise<void>;
+    /**
+     * Add one or more notification recipients to a notification scheme event
+     *
+     * `PUT /rest/api/3/notificationscheme/{schemeId}/notification`
+     *
+     * Deviates from the Go SDK, which issues
+     * `POST .../notification?eventTypeId={eventId}` with a flat body. That
+     * operation does not exist — the path defines only `PUT`, taking a nested
+     * `notificationSchemeEvents` array and no query parameters — so the Go call
+     * returns 405.
+     *
+     * The endpoint returns 204, so there is no created notification to return.
+     *
+     * @param schemeId - ID of the notification scheme
+     * @param eventId - ID of the event type the notifications attach to
+     * @param input - A notification, or several, to add to that event
+     */
+    addNotification(schemeId: number, eventId: number, input: AddNotificationInput | AddNotificationInput[]): Promise<void>;
+    /**
+     * Remove a notification from a notification scheme
+     *
+     * `DELETE /rest/api/3/notificationscheme/{schemeId}/notification/{notificationId}`
+     *
+     * @param schemeId - ID of the notification scheme
+     * @param notificationId - ID of the notification to remove
+     * @returns Nothing
+     */
+    removeNotification(schemeId: number, notificationId: number): Promise<void>;
+    /**
+     * Send a notification about an issue
+     *
+     * `POST /rest/api/3/issue/{issueIdOrKey}/notify`
+     *
+     * @param issueIdOrKey - Issue key or ID
+     * @param input - Subject, body and recipients
+     * @returns Nothing
+     */
+    sendIssueNotification(issueIdOrKey: string, input: SendNotificationInput): Promise<void>;
+}
+
+/**
+ * Permission service for Jira permissions, permission schemes and project roles
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // All permissions known to Jira
+ * const permissions = await client.permissions.getAllPermissions();
+ *
+ * // The current user's permissions in a project
+ * const mine = await client.permissions.getMyPermissions({ projectKey: 'PROJ' });
+ * ```
+ */
+declare class PermissionService extends BaseService {
+    /**
+     * Get all permissions available in Jira
+     *
+     * `GET /rest/api/3/permissions`
+     *
+     * @returns All permission definitions
+     */
+    getAllPermissions(): Promise<Permission[]>;
+    /**
+     * Get the current user's permissions, optionally scoped to a project or issue
+     *
+     * `GET /rest/api/3/mypermissions`
+     *
+     * @param options - Project/issue scope and the permission keys to check
+     * @returns The permission grant status keyed by permission key
+     */
+    getMyPermissions(options?: MyPermissionsOptions): Promise<MyPermissions>;
+    /**
+     * List all permission schemes
+     *
+     * `GET /rest/api/3/permissionscheme`
+     *
+     * @param options - Optional expand values
+     * @returns All permission schemes
+     */
+    listPermissionSchemes(options?: ListPermissionSchemesOptions): Promise<PermissionScheme[]>;
+    /**
+     * Get a permission scheme by ID
+     *
+     * `GET /rest/api/3/permissionscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the permission scheme
+     * @param options - Optional expand values
+     * @returns The permission scheme
+     */
+    getPermissionScheme(schemeId: number, options?: GetPermissionSchemeOptions): Promise<PermissionScheme>;
+    /**
+     * Create a permission scheme
+     *
+     * `POST /rest/api/3/permissionscheme`
+     *
+     * @param input - Name, description and optional permission grants
+     * @returns The created permission scheme
+     */
+    createPermissionScheme(input: CreatePermissionSchemeInput): Promise<PermissionScheme>;
+    /**
+     * Update a permission scheme
+     *
+     * `PUT /rest/api/3/permissionscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the permission scheme
+     * @param input - Fields to update
+     * @returns The updated permission scheme
+     */
+    updatePermissionScheme(schemeId: number, input: UpdatePermissionSchemeInput): Promise<PermissionScheme>;
+    /**
+     * Delete a permission scheme
+     *
+     * `DELETE /rest/api/3/permissionscheme/{schemeId}`
+     *
+     * @param schemeId - ID of the permission scheme
+     * @returns Nothing
+     */
+    deletePermissionScheme(schemeId: number): Promise<void>;
+    /**
+     * Get all roles of a project as a map of role name to role URL
+     *
+     * `GET /rest/api/3/project/{projectIdOrKey}/role`
+     *
+     * @param projectIdOrKey - Project key or ID
+     * @returns Map of role name to the role's REST URL
+     */
+    getProjectRoles(projectIdOrKey: string): Promise<ProjectRoles>;
+    /**
+     * Get details of a single project role, including its actors
+     *
+     * `GET /rest/api/3/project/{projectIdOrKey}/role/{roleId}`
+     *
+     * @param projectIdOrKey - Project key or ID
+     * @param roleId - ID of the project role
+     * @returns The project role
+     */
+    getProjectRole(projectIdOrKey: string, roleId: number): Promise<ProjectRole>;
+    /**
+     * Add users and/or groups as actors of a project role
+     *
+     * `POST /rest/api/3/project/{projectIdOrKey}/role/{roleId}`
+     *
+     * @param projectIdOrKey - Project key or ID
+     * @param roleId - ID of the project role
+     * @param input - Account IDs and/or group names to add
+     * @returns The updated project role
+     */
+    addActorsToProjectRole(projectIdOrKey: string, roleId: number, input: AddActorInput): Promise<ProjectRole>;
+    /**
+     * Remove an actor from a project role
+     *
+     * `DELETE /rest/api/3/project/{projectIdOrKey}/role/{roleId}?{actorType}={actor}`
+     *
+     * @param projectIdOrKey - Project key or ID
+     * @param roleId - ID of the project role
+     * @param actorType - Whether the actor is a `user`, `group` or `groupId`
+     * @param actor - Account ID, group name or group ID of the actor
+     * @returns Nothing
+     */
+    removeActorFromProjectRole(projectIdOrKey: string, roleId: number, actorType: ProjectRoleActorType, actor: string): Promise<void>;
+}
+
+/**
+ * Priority service for CRUD operations on Jira issue priorities
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const priorities = await client.priorities.list();
+ * const priority = await client.priorities.get('1');
+ * await client.priorities.setDefault('3');
+ * ```
+ */
+declare class PriorityService extends BaseService {
+    /**
+     * List all priorities
+     *
+     * `GET /rest/api/3/priority`
+     *
+     * @returns All priorities defined on the instance
+     */
+    list(): Promise<Priority[]>;
+    /**
+     * Get a priority by ID
+     *
+     * `GET /rest/api/3/priority/{id}`
+     *
+     * @param priorityId - The priority ID
+     * @returns The requested priority
+     */
+    get(priorityId: string): Promise<Priority>;
+    /**
+     * Create a new priority
+     *
+     * `POST /rest/api/3/priority`
+     *
+     * @param input - The priority to create
+     * @returns The created priority
+     */
+    create(input: CreatePriorityInput): Promise<Priority>;
+    /**
+     * Update a priority
+     *
+     * `PUT /rest/api/3/priority/{id}`
+     *
+     * @param priorityId - The priority ID
+     * @param input - The fields to update
+     * @returns The updated priority
+     */
+    update(priorityId: string, input: UpdatePriorityInput): Promise<Priority>;
+    /**
+     * Delete a priority, reassigning affected issues to a replacement priority
+     *
+     * `DELETE /rest/api/3/priority/{id}?replaceWith={replacementId}`
+     *
+     * @param priorityId - The priority to delete
+     * @param replacementId - The priority to reassign issues to
+     * @returns Nothing; resolves once the priority is deleted
+     */
+    deletePriority(priorityId: string, replacementId: string): Promise<void>;
+    /**
+     * Set a priority as the instance default
+     *
+     * `PUT /rest/api/3/priority/default`
+     *
+     * @param priorityId - The priority to make default
+     * @returns Nothing; resolves once the default is set
+     */
+    setDefault(priorityId: string): Promise<void>;
+}
+
+/**
+ * Project service for CRUD operations on Jira projects
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Get all projects
+ * const projects = await client.projects.list();
+ *
+ * // Get a project
+ * const project = await client.projects.get('PROJECT');
+ *
+ * // Create a project
+ * const newProject = await client.projects.create({
+ *   key: 'PROJ',
+ *   name: 'My Project',
+ *   projectTypeKey: 'software',
+ * });
+ * ```
+ */
+declare class ProjectService extends BaseService {
+    /**
+     * Get a project by key or ID
+     */
+    get(projectIdOrKey: string, options?: {
+        expand?: string[];
+        properties?: string[];
+    }): Promise<Project>;
+    /**
+     * Get all projects (paginated)
+     */
+    list(options?: GetProjectsOptions): Promise<ProjectSearchResult>;
+    /**
+     * Create a new project
+     */
+    create(input: CreateProjectInput): Promise<Project>;
+    /**
+     * Update a project
+     */
+    update(projectIdOrKey: string, input: UpdateProjectInput): Promise<Project>;
+    /**
+     * Delete a project
+     */
+    deleteProject(projectIdOrKey: string, options?: {
+        enableUndo?: boolean;
+    }): Promise<void>;
+    /**
+     * Archive a project
+     */
+    archive(projectIdOrKey: string): Promise<void>;
+    /**
+     * Restore an archived project
+     */
+    restore(projectIdOrKey: string): Promise<Project>;
+    /**
+     * Get recent projects
+     */
+    getRecent(options?: {
+        expand?: string[];
+        properties?: string[];
+    }): Promise<Project[]>;
+    /**
+     * Create a project component
+     *
+     * `POST /rest/api/3/component`
+     *
+     * @param input - Component creation input (name and project are required)
+     * @returns The created component
+     */
+    createComponent(input: CreateComponentInput): Promise<ProjectComponent>;
+    /**
+     * Update a project component
+     *
+     * `PUT /rest/api/3/component/{componentId}`
+     *
+     * @param componentId - Component ID
+     * @param input - Fields to update
+     * @returns The updated component
+     */
+    updateComponent(componentId: string, input: UpdateComponentInput): Promise<ProjectComponent>;
+    /**
+     * Get a project component by ID
+     *
+     * `GET /rest/api/3/component/{componentId}`
+     *
+     * @param componentId - Component ID
+     * @returns The component
+     */
+    getComponent(componentId: string): Promise<ProjectComponent>;
+    /**
+     * Delete a project component
+     *
+     * `DELETE /rest/api/3/component/{componentId}`
+     *
+     * @param componentId - Component ID
+     * @param options - Optional component to move affected issues to
+     * @returns Nothing (204 No Content)
+     */
+    deleteComponent(componentId: string, options?: {
+        moveIssuesTo?: string;
+    }): Promise<void>;
+    /**
+     * List all components of a project
+     *
+     * `GET /rest/api/3/project/{projectIdOrKey}/components`
+     *
+     * @param projectIdOrKey - Project ID or key
+     * @returns All components of the project
+     */
+    listProjectComponents(projectIdOrKey: string): Promise<ProjectComponent[]>;
+    /**
+     * Create a project version
+     *
+     * `POST /rest/api/3/version`
+     *
+     * @param input - Version creation input (name and project are required)
+     * @returns The created version
+     */
+    createVersion(input: CreateVersionInput): Promise<ProjectVersion>;
+    /**
+     * Update a project version
+     *
+     * `PUT /rest/api/3/version/{versionId}`
+     *
+     * @param versionId - Version ID
+     * @param input - Fields to update
+     * @returns The updated version
+     */
+    updateVersion(versionId: string, input: UpdateVersionInput): Promise<ProjectVersion>;
+    /**
+     * Get a project version by ID
+     *
+     * `GET /rest/api/3/version/{versionId}`
+     *
+     * @param versionId - Version ID
+     * @param options - Optional expand values (e.g. `operations`, `issuesstatus`)
+     * @returns The version
+     */
+    getVersion(versionId: string, options?: {
+        expand?: string[];
+    }): Promise<ProjectVersion>;
+    /**
+     * Delete a project version
+     *
+     * `DELETE /rest/api/3/version/{versionId}`
+     *
+     * @param versionId - Version ID
+     * @param options - Optional versions to move fix/affects references to
+     * @returns Nothing (204 No Content)
+     */
+    deleteVersion(versionId: string, options?: {
+        moveFixIssuesTo?: string;
+        moveAffectedIssuesTo?: string;
+    }): Promise<void>;
+    /**
+     * List all versions of a project
+     *
+     * `GET /rest/api/3/project/{projectIdOrKey}/versions`
+     *
+     * @param projectIdOrKey - Project ID or key
+     * @returns All versions of the project
+     */
+    listProjectVersions(projectIdOrKey: string): Promise<ProjectVersion[]>;
+}
+
+/**
+ * Resolution service for CRUD operations on Jira issue resolutions
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const resolutions = await client.resolutions.list();
+ * const resolution = await client.resolutions.get('1');
+ * await client.resolutions.setDefault('1');
+ * ```
+ */
+declare class ResolutionService extends BaseService {
+    /**
+     * List all resolutions
+     *
+     * `GET /rest/api/3/resolution`
+     *
+     * @returns All resolutions defined on the instance
+     */
+    list(): Promise<Resolution[]>;
+    /**
+     * Get a resolution by ID
+     *
+     * `GET /rest/api/3/resolution/{id}`
+     *
+     * @param resolutionId - The resolution ID
+     * @returns The requested resolution
+     */
+    get(resolutionId: string): Promise<Resolution>;
+    /**
+     * Create a new resolution
+     *
+     * `POST /rest/api/3/resolution`
+     *
+     * @param input - The resolution to create
+     * @returns The created resolution
+     */
+    create(input: CreateResolutionInput): Promise<Resolution>;
+    /**
+     * Update a resolution
+     *
+     * `PUT /rest/api/3/resolution/{id}`
+     *
+     * @param resolutionId - The resolution ID
+     * @param input - The fields to update
+     * @returns The updated resolution
+     */
+    update(resolutionId: string, input: UpdateResolutionInput): Promise<Resolution>;
+    /**
+     * Delete a resolution, reassigning affected issues to a replacement resolution
+     *
+     * `DELETE /rest/api/3/resolution/{id}?replaceWith={replacementId}`
+     *
+     * @param resolutionId - The resolution to delete
+     * @param replacementId - The resolution to reassign issues to
+     * @returns Nothing; resolves once the resolution is deleted
+     */
+    deleteResolution(resolutionId: string, replacementId: string): Promise<void>;
+    /**
+     * Set a resolution as the instance default
+     *
+     * `PUT /rest/api/3/resolution/default`
+     *
+     * @param resolutionId - The resolution to make default
+     * @returns Nothing; resolves once the default is set
+     */
+    setDefault(resolutionId: string): Promise<void>;
+}
+
+/**
+ * Screen service for managing Jira screens, their tabs and the fields on them.
+ *
+ * Screens define which fields are displayed during issue operations
+ * (create, edit, view).
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const screens = await client.screens.list({ maxResults: 50 });
+ * const tabs = await client.screens.listTabs(10000);
+ * await client.screens.addField(10000, 10100, { fieldId: 'summary' });
+ * ```
+ */
+declare class ScreenService extends BaseService {
+    /**
+     * List screens (paginated)
+     *
+     * `GET /rest/api/3/screens`
+     *
+     * @param options - Optional pagination
+     * @returns A page of screens
+     */
+    list(options?: ListScreensOptions): Promise<ScreenListResult>;
+    /**
+     * Async iterator over every screen, transparently paging the API
+     *
+     * @param options - Optional pagination; `maxResults` sets the page size
+     * @returns An async generator yielding each screen
+     */
+    iterate(options?: Omit<ListScreensOptions, 'startAt'>): AsyncGenerator<Screen, void, undefined>;
+    /**
+     * Collect every screen into an array (loads all pages into memory)
+     *
+     * @param options - Optional pagination; `maxResults` sets the page size
+     * @returns All screens
+     */
+    all(options?: Omit<ListScreensOptions, 'startAt'>): Promise<Screen[]>;
+    /**
+     * Get a screen by ID
+     *
+     * `GET /rest/api/3/screens/{screenId}`
+     *
+     * @param screenId - Screen ID
+     * @returns The screen
+     */
+    get(screenId: number): Promise<Screen>;
+    /**
+     * Create a screen
+     *
+     * `POST /rest/api/3/screens`
+     *
+     * @param input - Screen name and optional description
+     * @returns The created screen
+     */
+    create(input: CreateScreenInput): Promise<Screen>;
+    /**
+     * Update a screen
+     *
+     * `PUT /rest/api/3/screens/{screenId}`
+     *
+     * @param screenId - Screen ID
+     * @param input - Fields to update
+     * @returns The updated screen
+     */
+    update(screenId: number, input: UpdateScreenInput): Promise<Screen>;
+    /**
+     * Delete a screen
+     *
+     * `DELETE /rest/api/3/screens/{screenId}`
+     *
+     * @param screenId - Screen ID
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    deleteScreen(screenId: number): Promise<void>;
+    /**
+     * Get the fields that can still be added to a screen
+     *
+     * `GET /rest/api/3/screens/{screenId}/availableFields`
+     *
+     * @param screenId - Screen ID
+     * @returns The fields available to add
+     */
+    getAvailableFields(screenId: number): Promise<ScreenField[]>;
+    /**
+     * List the tabs of a screen
+     *
+     * `GET /rest/api/3/screens/{screenId}/tabs`
+     *
+     * @param screenId - Screen ID
+     * @returns The screen's tabs
+     */
+    listTabs(screenId: number): Promise<ScreenTab[]>;
+    /**
+     * Create a tab on a screen
+     *
+     * `POST /rest/api/3/screens/{screenId}/tabs`
+     *
+     * @param screenId - Screen ID
+     * @param input - Tab name
+     * @returns The created tab
+     */
+    createTab(screenId: number, input: CreateScreenTabInput): Promise<ScreenTab>;
+    /**
+     * Update a screen tab
+     *
+     * `PUT /rest/api/3/screens/{screenId}/tabs/{tabId}`
+     *
+     * @param screenId - Screen ID
+     * @param tabId - Tab ID
+     * @param input - Fields to update
+     * @returns The updated tab
+     */
+    updateTab(screenId: number, tabId: number, input: UpdateScreenTabInput): Promise<ScreenTab>;
+    /**
+     * Delete a screen tab
+     *
+     * `DELETE /rest/api/3/screens/{screenId}/tabs/{tabId}`
+     *
+     * @param screenId - Screen ID
+     * @param tabId - Tab ID
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    deleteTab(screenId: number, tabId: number): Promise<void>;
+    /**
+     * Add a field to a screen tab
+     *
+     * `POST /rest/api/3/screens/{screenId}/tabs/{tabId}/fields`
+     *
+     * @param screenId - Screen ID
+     * @param tabId - Tab ID
+     * @param input - The ID of the field to add
+     * @returns The added field
+     */
+    addField(screenId: number, tabId: number, input: AddScreenFieldInput): Promise<ScreenField>;
+    /**
+     * Remove a field from a screen tab
+     *
+     * `DELETE /rest/api/3/screens/{screenId}/tabs/{tabId}/fields/{fieldId}`
+     *
+     * @param screenId - Screen ID
+     * @param tabId - Tab ID
+     * @param fieldId - Field ID (e.g. `summary`)
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    removeField(screenId: number, tabId: number, fieldId: string): Promise<void>;
+}
+
+/**
+ * Search result schema
+ */
+declare const SearchResultSchema: z.ZodObject<{
+    expand: z.ZodOptional<z.ZodString>;
+    startAt: z.ZodNumber;
+    maxResults: z.ZodNumber;
+    total: z.ZodNumber;
+    issues: z.ZodArray<z.ZodObject<{
+        expand: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        self: z.ZodOptional<z.ZodURL>;
+        key: z.ZodString;
+        fields: z.ZodObject<{
+            summary: z.ZodOptional<z.ZodString>;
+            description: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                type: z.ZodLiteral<"doc">;
+                content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+            }, z.core.$strip>, z.ZodString]>>>;
+            environment: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                version: z.ZodLiteral<1>;
+                type: z.ZodLiteral<"doc">;
+                content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+            }, z.core.$strip>, z.ZodString]>>>;
+            issuetype: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                iconUrl: z.ZodOptional<z.ZodURL>;
+                subtask: z.ZodBoolean;
+                avatarId: z.ZodOptional<z.ZodNumber>;
+                hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            project: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                key: z.ZodString;
+                name: z.ZodString;
+                projectTypeKey: z.ZodOptional<z.ZodEnum<{
+                    software: "software";
+                    service_desk: "service_desk";
+                    business: "business";
+                }>>;
+                simplified: z.ZodOptional<z.ZodBoolean>;
+                avatarUrls: z.ZodOptional<z.ZodObject<{
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            status: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                iconUrl: z.ZodOptional<z.ZodURL>;
+                statusCategory: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodNumber;
+                    key: z.ZodString;
+                    colorName: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+            resolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            priority: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                iconUrl: z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>>;
+            assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                accountId: z.ZodString;
+                displayName: z.ZodOptional<z.ZodString>;
+                active: z.ZodOptional<z.ZodBoolean>;
+                avatarUrls: z.ZodOptional<z.ZodObject<{
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            reporter: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                accountId: z.ZodString;
+                displayName: z.ZodOptional<z.ZodString>;
+                active: z.ZodOptional<z.ZodBoolean>;
+                avatarUrls: z.ZodOptional<z.ZodObject<{
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            creator: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                accountId: z.ZodString;
+                displayName: z.ZodOptional<z.ZodString>;
+                active: z.ZodOptional<z.ZodBoolean>;
+                avatarUrls: z.ZodOptional<z.ZodObject<{
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            parent: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                key: z.ZodString;
+                self: z.ZodOptional<z.ZodURL>;
+                fields: z.ZodOptional<z.ZodObject<{
+                    summary: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodString;
+                        name: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        iconUrl: z.ZodOptional<z.ZodURL>;
+                        statusCategory: z.ZodOptional<z.ZodObject<{
+                            self: z.ZodOptional<z.ZodURL>;
+                            id: z.ZodNumber;
+                            key: z.ZodString;
+                            colorName: z.ZodString;
+                            name: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                    issuetype: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodString;
+                        name: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        iconUrl: z.ZodOptional<z.ZodURL>;
+                        subtask: z.ZodBoolean;
+                        avatarId: z.ZodOptional<z.ZodNumber>;
+                        hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            subtasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                key: z.ZodString;
+                self: z.ZodOptional<z.ZodURL>;
+                fields: z.ZodOptional<z.ZodObject<{
+                    summary: z.ZodOptional<z.ZodString>;
+                    status: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodString;
+                        name: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        iconUrl: z.ZodOptional<z.ZodURL>;
+                        statusCategory: z.ZodOptional<z.ZodObject<{
+                            self: z.ZodOptional<z.ZodURL>;
+                            id: z.ZodNumber;
+                            key: z.ZodString;
+                            colorName: z.ZodString;
+                            name: z.ZodString;
+                        }, z.core.$strip>>;
+                    }, z.core.$strip>>;
+                    issuetype: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodString;
+                        name: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        iconUrl: z.ZodOptional<z.ZodURL>;
+                        subtask: z.ZodBoolean;
+                        avatarId: z.ZodOptional<z.ZodNumber>;
+                        hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>>;
+            fixVersions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                archived: z.ZodOptional<z.ZodBoolean>;
+                released: z.ZodOptional<z.ZodBoolean>;
+                releaseDate: z.ZodOptional<z.ZodString>;
+                startDate: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                archived: z.ZodOptional<z.ZodBoolean>;
+                released: z.ZodOptional<z.ZodBoolean>;
+                releaseDate: z.ZodOptional<z.ZodString>;
+                startDate: z.ZodOptional<z.ZodString>;
+                projectId: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>>;
+            components: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+            }, z.core.$strip>>>;
+            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            created: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            updated: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            resolutiondate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            duedate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            timeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            timeestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            timespent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            aggregatetimeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            aggregatetimeestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            aggregatetimespent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+            workratio: z.ZodOptional<z.ZodNumber>;
+            votes: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                votes: z.ZodNumber;
+                hasVoted: z.ZodBoolean;
+            }, z.core.$strip>>;
+            watches: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                watchCount: z.ZodNumber;
+                isWatching: z.ZodBoolean;
+            }, z.core.$strip>>;
+            progress: z.ZodOptional<z.ZodObject<{
+                progress: z.ZodNumber;
+                total: z.ZodNumber;
+                percent: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+            aggregateprogress: z.ZodOptional<z.ZodObject<{
+                progress: z.ZodNumber;
+                total: z.ZodNumber;
+                percent: z.ZodOptional<z.ZodNumber>;
+            }, z.core.$strip>>;
+        }, z.core.$loose>;
+        renderedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            to: z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                iconUrl: z.ZodOptional<z.ZodURL>;
+                statusCategory: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodNumber;
+                    key: z.ZodString;
+                    colorName: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            hasScreen: z.ZodOptional<z.ZodBoolean>;
+            isGlobal: z.ZodOptional<z.ZodBoolean>;
+            isInitial: z.ZodOptional<z.ZodBoolean>;
+            isConditional: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        operations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        editmeta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        changelog: z.ZodOptional<z.ZodObject<{
+            startAt: z.ZodNumber;
+            maxResults: z.ZodNumber;
+            total: z.ZodNumber;
+            histories: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        versionedRepresentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fieldsToInclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    warningMessages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+type SearchResult = z.infer<typeof SearchResultSchema>;
+/**
+ * Issue shape returned by the Enhanced JQL Search API.
+ *
+ * The enhanced endpoint is field-selective: unless you ask for `*all` /
+ * `*navigable`, Jira returns only the fields you named (by default just the
+ * issue ID). Every field is therefore optional here — validating against the
+ * full {@link IssueSchema} would reject perfectly valid, sparse responses.
+ */
+declare const SearchJqlIssueSchema: z.ZodObject<{
+    expand: z.ZodOptional<z.ZodString>;
+    id: z.ZodString;
+    self: z.ZodOptional<z.ZodURL>;
+    key: z.ZodString;
+    renderedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        to: z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+            statusCategory: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodNumber;
+                key: z.ZodString;
+                colorName: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>;
+        hasScreen: z.ZodOptional<z.ZodBoolean>;
+        isGlobal: z.ZodOptional<z.ZodBoolean>;
+        isInitial: z.ZodOptional<z.ZodBoolean>;
+        isConditional: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>>;
+    operations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    editmeta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    changelog: z.ZodOptional<z.ZodObject<{
+        startAt: z.ZodNumber;
+        maxResults: z.ZodNumber;
+        total: z.ZodNumber;
+        histories: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    versionedRepresentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fieldsToInclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fields: z.ZodOptional<z.ZodObject<{
+        summary: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+        description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            type: z.ZodLiteral<"doc">;
+            content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+        }, z.core.$strip>, z.ZodString]>>>>;
+        environment: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+            version: z.ZodLiteral<1>;
+            type: z.ZodLiteral<"doc">;
+            content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+        }, z.core.$strip>, z.ZodString]>>>>;
+        issuetype: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+            subtask: z.ZodBoolean;
+            avatarId: z.ZodOptional<z.ZodNumber>;
+            hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        project: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            key: z.ZodString;
+            name: z.ZodString;
+            projectTypeKey: z.ZodOptional<z.ZodEnum<{
+                software: "software";
+                service_desk: "service_desk";
+                business: "business";
+            }>>;
+            simplified: z.ZodOptional<z.ZodBoolean>;
+            avatarUrls: z.ZodOptional<z.ZodObject<{
+                '48x48': z.ZodOptional<z.ZodURL>;
+                '24x24': z.ZodOptional<z.ZodURL>;
+                '16x16': z.ZodOptional<z.ZodURL>;
+                '32x32': z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        status: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+            statusCategory: z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodNumber;
+                key: z.ZodString;
+                colorName: z.ZodString;
+                name: z.ZodString;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>;
+        resolution: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        priority: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            iconUrl: z.ZodOptional<z.ZodURL>;
+        }, z.core.$strip>>>>;
+        assignee: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            accountId: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            active: z.ZodOptional<z.ZodBoolean>;
+            avatarUrls: z.ZodOptional<z.ZodObject<{
+                '48x48': z.ZodOptional<z.ZodURL>;
+                '24x24': z.ZodOptional<z.ZodURL>;
+                '16x16': z.ZodOptional<z.ZodURL>;
+                '32x32': z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>>;
+        reporter: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            accountId: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            active: z.ZodOptional<z.ZodBoolean>;
+            avatarUrls: z.ZodOptional<z.ZodObject<{
+                '48x48': z.ZodOptional<z.ZodURL>;
+                '24x24': z.ZodOptional<z.ZodURL>;
+                '16x16': z.ZodOptional<z.ZodURL>;
+                '32x32': z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>>;
+        creator: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            accountId: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            active: z.ZodOptional<z.ZodBoolean>;
+            avatarUrls: z.ZodOptional<z.ZodObject<{
+                '48x48': z.ZodOptional<z.ZodURL>;
+                '24x24': z.ZodOptional<z.ZodURL>;
+                '16x16': z.ZodOptional<z.ZodURL>;
+                '32x32': z.ZodOptional<z.ZodURL>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>>;
+        parent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            self: z.ZodOptional<z.ZodURL>;
+            fields: z.ZodOptional<z.ZodObject<{
+                summary: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    iconUrl: z.ZodOptional<z.ZodURL>;
+                    statusCategory: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodNumber;
+                        key: z.ZodString;
+                        colorName: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                issuetype: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    iconUrl: z.ZodOptional<z.ZodURL>;
+                    subtask: z.ZodBoolean;
+                    avatarId: z.ZodOptional<z.ZodNumber>;
+                    hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>>;
+        subtasks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodOptional<z.ZodString>;
+            key: z.ZodString;
+            self: z.ZodOptional<z.ZodURL>;
+            fields: z.ZodOptional<z.ZodObject<{
+                summary: z.ZodOptional<z.ZodString>;
+                status: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    iconUrl: z.ZodOptional<z.ZodURL>;
+                    statusCategory: z.ZodOptional<z.ZodObject<{
+                        self: z.ZodOptional<z.ZodURL>;
+                        id: z.ZodNumber;
+                        key: z.ZodString;
+                        colorName: z.ZodString;
+                        name: z.ZodString;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                issuetype: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    description: z.ZodOptional<z.ZodString>;
+                    iconUrl: z.ZodOptional<z.ZodURL>;
+                    subtask: z.ZodBoolean;
+                    avatarId: z.ZodOptional<z.ZodNumber>;
+                    hierarchyLevel: z.ZodOptional<z.ZodNumber>;
+                }, z.core.$strip>>;
+            }, z.core.$strip>>;
+        }, z.core.$strip>>>>;
+        fixVersions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            archived: z.ZodOptional<z.ZodBoolean>;
+            released: z.ZodOptional<z.ZodBoolean>;
+            releaseDate: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        versions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+            archived: z.ZodOptional<z.ZodBoolean>;
+            released: z.ZodOptional<z.ZodBoolean>;
+            releaseDate: z.ZodOptional<z.ZodString>;
+            startDate: z.ZodOptional<z.ZodString>;
+            projectId: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>>;
+        components: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            id: z.ZodString;
+            name: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>>>;
+        labels: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        created: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        updated: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        resolutiondate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        duedate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+        timeoriginalestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        timeestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        timespent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        aggregatetimeoriginalestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        aggregatetimeestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        aggregatetimespent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+        workratio: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+        votes: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            votes: z.ZodNumber;
+            hasVoted: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        watches: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            self: z.ZodOptional<z.ZodURL>;
+            watchCount: z.ZodNumber;
+            isWatching: z.ZodBoolean;
+        }, z.core.$strip>>>;
+        progress: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            progress: z.ZodNumber;
+            total: z.ZodNumber;
+            percent: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+        aggregateprogress: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+            progress: z.ZodNumber;
+            total: z.ZodNumber;
+            percent: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strip>>>;
+    }, z.core.$loose>>;
+}, z.core.$strip>;
+type SearchJqlIssue = z.infer<typeof SearchJqlIssueSchema>;
+/**
+ * Enhanced JQL search result schema
+ *
+ * Note: there is no `total` — the enhanced endpoint deliberately omits it for
+ * performance. Pagination is driven by `nextPageToken`.
+ */
+declare const SearchJqlResultSchema: z.ZodObject<{
+    issues: z.ZodArray<z.ZodObject<{
+        expand: z.ZodOptional<z.ZodString>;
+        id: z.ZodString;
+        self: z.ZodOptional<z.ZodURL>;
+        key: z.ZodString;
+        renderedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            to: z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
+                id: z.ZodString;
+                name: z.ZodString;
+                description: z.ZodOptional<z.ZodString>;
+                iconUrl: z.ZodOptional<z.ZodURL>;
+                statusCategory: z.ZodOptional<z.ZodObject<{
+                    self: z.ZodOptional<z.ZodURL>;
+                    id: z.ZodNumber;
+                    key: z.ZodString;
+                    colorName: z.ZodString;
+                    name: z.ZodString;
+                }, z.core.$strip>>;
+            }, z.core.$strip>;
+            hasScreen: z.ZodOptional<z.ZodBoolean>;
+            isGlobal: z.ZodOptional<z.ZodBoolean>;
+            isInitial: z.ZodOptional<z.ZodBoolean>;
+            isConditional: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>>;
+        operations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        editmeta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        changelog: z.ZodOptional<z.ZodObject<{
+            startAt: z.ZodNumber;
+            maxResults: z.ZodNumber;
+            total: z.ZodNumber;
+            histories: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, z.core.$strip>>;
+        versionedRepresentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fieldsToInclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        fields: z.ZodOptional<z.ZodObject<{
+            summary: z.ZodOptional<z.ZodOptional<z.ZodString>>;
+            description: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
                 version: z.ZodLiteral<1>;
                 type: z.ZodLiteral<"doc">;
-                content: z.ZodArray<z.ZodType<_felixgeelhaar_sdk_core.AdfNode, unknown, z.core.$ZodTypeInternals<_felixgeelhaar_sdk_core.AdfNode, unknown>>>;
-            }, z.core.$strip>, z.ZodString]>>>;
-            environment: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
+                content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+            }, z.core.$strip>, z.ZodString]>>>>;
+            environment: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodObject<{
                 version: z.ZodLiteral<1>;
                 type: z.ZodLiteral<"doc">;
-                content: z.ZodArray<z.ZodType<_felixgeelhaar_sdk_core.AdfNode, unknown, z.core.$ZodTypeInternals<_felixgeelhaar_sdk_core.AdfNode, unknown>>>;
-            }, z.core.$strip>, z.ZodString]>>>;
-            issuetype: z.ZodObject<{
-                self: z.ZodURL;
+                content: z.ZodArray<z.ZodType<AdfNode, unknown, z.core.$ZodTypeInternals<AdfNode, unknown>>>;
+            }, z.core.$strip>, z.ZodString]>>>>;
+            issuetype: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
@@ -326,9 +3081,9 @@ declare const SearchResultSchema: z.ZodObject<{
                 subtask: z.ZodBoolean;
                 avatarId: z.ZodOptional<z.ZodNumber>;
                 hierarchyLevel: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>;
-            project: z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>;
+            project: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 key: z.ZodString;
                 name: z.ZodString;
@@ -344,84 +3099,84 @@ declare const SearchResultSchema: z.ZodObject<{
                     '16x16': z.ZodOptional<z.ZodURL>;
                     '32x32': z.ZodOptional<z.ZodURL>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>;
-            status: z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>;
+            status: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 iconUrl: z.ZodOptional<z.ZodURL>;
                 statusCategory: z.ZodOptional<z.ZodObject<{
-                    self: z.ZodURL;
+                    self: z.ZodOptional<z.ZodURL>;
                     id: z.ZodNumber;
                     key: z.ZodString;
                     colorName: z.ZodString;
                     name: z.ZodString;
                 }, z.core.$strip>>;
-            }, z.core.$strip>;
-            resolution: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>;
+            resolution: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            priority: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>>;
+            priority: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
                 iconUrl: z.ZodOptional<z.ZodURL>;
-            }, z.core.$strip>>>;
-            assignee: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            }, z.core.$strip>>>>;
+            assignee: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 self: z.ZodOptional<z.ZodURL>;
                 accountId: z.ZodString;
                 displayName: z.ZodOptional<z.ZodString>;
                 active: z.ZodOptional<z.ZodBoolean>;
                 avatarUrls: z.ZodOptional<z.ZodObject<{
-                    "48x48": z.ZodOptional<z.ZodURL>;
-                    "24x24": z.ZodOptional<z.ZodURL>;
-                    "16x16": z.ZodOptional<z.ZodURL>;
-                    "32x32": z.ZodOptional<z.ZodURL>;
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>>;
-            reporter: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            }, z.core.$strip>>>>;
+            reporter: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 self: z.ZodOptional<z.ZodURL>;
                 accountId: z.ZodString;
                 displayName: z.ZodOptional<z.ZodString>;
                 active: z.ZodOptional<z.ZodBoolean>;
                 avatarUrls: z.ZodOptional<z.ZodObject<{
-                    "48x48": z.ZodOptional<z.ZodURL>;
-                    "24x24": z.ZodOptional<z.ZodURL>;
-                    "16x16": z.ZodOptional<z.ZodURL>;
-                    "32x32": z.ZodOptional<z.ZodURL>;
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>>;
-            creator: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            }, z.core.$strip>>>>;
+            creator: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 self: z.ZodOptional<z.ZodURL>;
                 accountId: z.ZodString;
                 displayName: z.ZodOptional<z.ZodString>;
                 active: z.ZodOptional<z.ZodBoolean>;
                 avatarUrls: z.ZodOptional<z.ZodObject<{
-                    "48x48": z.ZodOptional<z.ZodURL>;
-                    "24x24": z.ZodOptional<z.ZodURL>;
-                    "16x16": z.ZodOptional<z.ZodURL>;
-                    "32x32": z.ZodOptional<z.ZodURL>;
+                    '48x48': z.ZodOptional<z.ZodURL>;
+                    '24x24': z.ZodOptional<z.ZodURL>;
+                    '16x16': z.ZodOptional<z.ZodURL>;
+                    '32x32': z.ZodOptional<z.ZodURL>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>>;
-            parent: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            }, z.core.$strip>>>>;
+            parent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 key: z.ZodString;
                 self: z.ZodOptional<z.ZodURL>;
                 fields: z.ZodOptional<z.ZodObject<{
                     summary: z.ZodOptional<z.ZodString>;
                     status: z.ZodOptional<z.ZodObject<{
-                        self: z.ZodURL;
+                        self: z.ZodOptional<z.ZodURL>;
                         id: z.ZodString;
                         name: z.ZodString;
                         description: z.ZodOptional<z.ZodString>;
                         iconUrl: z.ZodOptional<z.ZodURL>;
                         statusCategory: z.ZodOptional<z.ZodObject<{
-                            self: z.ZodURL;
+                            self: z.ZodOptional<z.ZodURL>;
                             id: z.ZodNumber;
                             key: z.ZodString;
                             colorName: z.ZodString;
@@ -429,7 +3184,7 @@ declare const SearchResultSchema: z.ZodObject<{
                         }, z.core.$strip>>;
                     }, z.core.$strip>>;
                     issuetype: z.ZodOptional<z.ZodObject<{
-                        self: z.ZodURL;
+                        self: z.ZodOptional<z.ZodURL>;
                         id: z.ZodString;
                         name: z.ZodString;
                         description: z.ZodOptional<z.ZodString>;
@@ -439,21 +3194,21 @@ declare const SearchResultSchema: z.ZodObject<{
                         hierarchyLevel: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>>;
-            subtasks: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            }, z.core.$strip>>>>;
+            subtasks: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
                 id: z.ZodOptional<z.ZodString>;
                 key: z.ZodString;
                 self: z.ZodOptional<z.ZodURL>;
                 fields: z.ZodOptional<z.ZodObject<{
                     summary: z.ZodOptional<z.ZodString>;
                     status: z.ZodOptional<z.ZodObject<{
-                        self: z.ZodURL;
+                        self: z.ZodOptional<z.ZodURL>;
                         id: z.ZodString;
                         name: z.ZodString;
                         description: z.ZodOptional<z.ZodString>;
                         iconUrl: z.ZodOptional<z.ZodURL>;
                         statusCategory: z.ZodOptional<z.ZodObject<{
-                            self: z.ZodURL;
+                            self: z.ZodOptional<z.ZodURL>;
                             id: z.ZodNumber;
                             key: z.ZodString;
                             colorName: z.ZodString;
@@ -461,7 +3216,7 @@ declare const SearchResultSchema: z.ZodObject<{
                         }, z.core.$strip>>;
                     }, z.core.$strip>>;
                     issuetype: z.ZodOptional<z.ZodObject<{
-                        self: z.ZodURL;
+                        self: z.ZodOptional<z.ZodURL>;
                         id: z.ZodString;
                         name: z.ZodString;
                         description: z.ZodOptional<z.ZodString>;
@@ -471,9 +3226,9 @@ declare const SearchResultSchema: z.ZodObject<{
                         hierarchyLevel: z.ZodOptional<z.ZodNumber>;
                     }, z.core.$strip>>;
                 }, z.core.$strip>>;
-            }, z.core.$strip>>>;
-            fixVersions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>>;
+            fixVersions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
@@ -482,9 +3237,9 @@ declare const SearchResultSchema: z.ZodObject<{
                 releaseDate: z.ZodOptional<z.ZodString>;
                 startDate: z.ZodOptional<z.ZodString>;
                 projectId: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>>;
-            versions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>>;
+            versions: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
@@ -493,87 +3248,97 @@ declare const SearchResultSchema: z.ZodObject<{
                 releaseDate: z.ZodOptional<z.ZodString>;
                 startDate: z.ZodOptional<z.ZodString>;
                 projectId: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>>;
-            components: z.ZodOptional<z.ZodArray<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>>;
+            components: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 id: z.ZodString;
                 name: z.ZodString;
                 description: z.ZodOptional<z.ZodString>;
-            }, z.core.$strip>>>;
-            labels: z.ZodOptional<z.ZodArray<z.ZodString>>;
-            created: z.ZodNullable<z.ZodString>;
-            updated: z.ZodNullable<z.ZodString>;
-            resolutiondate: z.ZodNullable<z.ZodString>;
-            duedate: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-            timeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            timeestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            timespent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            aggregatetimeoriginalestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            aggregatetimeestimate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            aggregatetimespent: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
-            workratio: z.ZodOptional<z.ZodNumber>;
-            votes: z.ZodOptional<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>>;
+            labels: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+            created: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            updated: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            resolutiondate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            duedate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+            timeoriginalestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            timeestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            timespent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            aggregatetimeoriginalestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            aggregatetimeestimate: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            aggregatetimespent: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodNumber>>>;
+            workratio: z.ZodOptional<z.ZodOptional<z.ZodNumber>>;
+            votes: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 votes: z.ZodNumber;
                 hasVoted: z.ZodBoolean;
-            }, z.core.$strip>>;
-            watches: z.ZodOptional<z.ZodObject<{
-                self: z.ZodURL;
+            }, z.core.$strip>>>;
+            watches: z.ZodOptional<z.ZodOptional<z.ZodObject<{
+                self: z.ZodOptional<z.ZodURL>;
                 watchCount: z.ZodNumber;
                 isWatching: z.ZodBoolean;
-            }, z.core.$strip>>;
-            progress: z.ZodOptional<z.ZodObject<{
+            }, z.core.$strip>>>;
+            progress: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 progress: z.ZodNumber;
                 total: z.ZodNumber;
                 percent: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-            aggregateprogress: z.ZodOptional<z.ZodObject<{
+            }, z.core.$strip>>>;
+            aggregateprogress: z.ZodOptional<z.ZodOptional<z.ZodObject<{
                 progress: z.ZodNumber;
                 total: z.ZodNumber;
                 percent: z.ZodOptional<z.ZodNumber>;
-            }, z.core.$strip>>;
-        }, z.core.$loose>;
-        renderedFields: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
-        schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        transitions: z.ZodOptional<z.ZodArray<z.ZodObject<{
-            id: z.ZodString;
-            name: z.ZodString;
-            to: z.ZodObject<{
-                self: z.ZodURL;
-                id: z.ZodString;
-                name: z.ZodString;
-                description: z.ZodOptional<z.ZodString>;
-                iconUrl: z.ZodOptional<z.ZodURL>;
-                statusCategory: z.ZodOptional<z.ZodObject<{
-                    self: z.ZodURL;
-                    id: z.ZodNumber;
-                    key: z.ZodString;
-                    colorName: z.ZodString;
-                    name: z.ZodString;
-                }, z.core.$strip>>;
-            }, z.core.$strip>;
-            hasScreen: z.ZodOptional<z.ZodBoolean>;
-            isGlobal: z.ZodOptional<z.ZodBoolean>;
-            isInitial: z.ZodOptional<z.ZodBoolean>;
-            isConditional: z.ZodOptional<z.ZodBoolean>;
-        }, z.core.$strip>>>;
-        operations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        editmeta: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        changelog: z.ZodOptional<z.ZodObject<{
-            startAt: z.ZodNumber;
-            maxResults: z.ZodNumber;
-            total: z.ZodNumber;
-            histories: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        }, z.core.$strip>>;
-        versionedRepresentations: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
-        fieldsToInclude: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>>>;
+        }, z.core.$loose>>;
     }, z.core.$strip>>;
-    warningMessages: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    nextPageToken: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodOptional<z.ZodNumber>;
     names: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
     schema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    warningMessages: z.ZodOptional<z.ZodArray<z.ZodString>>;
 }, z.core.$strip>;
-type SearchResult = z.infer<typeof SearchResultSchema>;
+type SearchJqlResult = z.infer<typeof SearchJqlResultSchema>;
+/**
+ * Options for the Enhanced JQL Search API (`POST /rest/api/3/search/jql`)
+ */
+interface SearchJqlOptions {
+    /**
+     * JQL query string (required)
+     */
+    jql: string;
+    /**
+     * Fields to include in the response.
+     *
+     * IMPORTANT: this endpoint does NOT default to navigable fields. If you omit
+     * `fields`, Jira returns the issue ID only — `issue.fields` will be
+     * `undefined`. Pass `['*all']` for every field, `['*navigable']` for the
+     * legacy default, or an explicit list such as `['summary', 'status']`.
+     */
+    fields?: string[];
+    /**
+     * Sections to expand
+     */
+    expand?: string[];
+    /**
+     * Maximum results per page. Up to 5000 when few fields are requested;
+     * the server default (typically 50) applies when omitted.
+     */
+    maxResults?: number;
+    /**
+     * Pagination token from the previous response. Omit for the first page.
+     */
+    nextPageToken?: string;
+    /**
+     * Request fields by key instead of ID
+     */
+    fieldsByKeys?: boolean;
+    /**
+     * Issue properties to include
+     */
+    properties?: string[];
+    /**
+     * Validate the JQL before executing
+     */
+    validateQuery?: 'strict' | 'warn' | 'none';
+}
 /**
  * Search options
  */
@@ -636,35 +3401,361 @@ interface SearchOptions {
  */
 declare class SearchService extends BaseService {
     /**
-     * Execute a JQL search
+     * Execute a JQL search against the legacy search endpoint
+     *
+     * `POST /rest/api/3/search`
+     *
+     * @param options - Search options (JQL plus offset pagination)
+     * @returns A page of results including a `total` count
+     *
+     * @deprecated Use {@link SearchService.searchJql} instead. Atlassian is
+     * retiring `/rest/api/3/search` in favour of the Enhanced JQL Search API.
+     */
+    search(options: SearchOptions): Promise<SearchResult>;
+    /**
+     * Convenience method for simple JQL search
+     *
+     * @param query - JQL query string
+     * @param options - Additional search options
+     * @returns A page of results
+     *
+     * @deprecated Use {@link SearchService.searchJql} instead.
+     */
+    jql(query: string, options?: Omit<SearchOptions, 'jql'>): Promise<SearchResult>;
+    /**
+     * Async iterator for paginating through all search results
+     *
+     * @example
+     * ```typescript
+     * for await (const issue of client.search.iterate('project = PROJECT')) {
+     *   console.log(issue.key, issue.fields.summary);
+     * }
+     * ```
+     *
+     * @deprecated Use {@link SearchService.iterateJql} instead.
+     */
+    iterate(jql: string, options?: Omit<SearchOptions, 'jql' | 'startAt'>): AsyncGenerator<Issue, void, undefined>;
+    /**
+     * Get all issues matching a JQL query (loads all pages into memory)
+     * Use with caution for large result sets - prefer iterate() instead
+     *
+     * @deprecated Use {@link SearchService.allJql} instead.
+     */
+    all(jql: string, options?: Omit<SearchOptions, 'jql' | 'startAt'>): Promise<Issue[]>;
+    /**
+     * Count issues matching a JQL query (more efficient than fetching all)
+     *
+     * @deprecated The Enhanced JQL Search API does not return a total count.
+     * This still uses the legacy `/rest/api/3/search` endpoint; use
+     * `POST /rest/api/3/search/approximate-count` semantics when Atlassian
+     * retires it.
+     */
+    count(jql: string): Promise<number>;
+    /**
+     * Execute a JQL search using the Enhanced JQL Search API
+     *
+     * `POST /rest/api/3/search/jql`
+     *
+     * Differences from the legacy {@link SearchService.search}:
+     * - token pagination (`nextPageToken`) instead of `startAt`
+     * - no `total` count in the response
+     * - `maxResults` up to 5000 (vs 100)
+     * - **`fields` defaults to the issue ID only**, not `*navigable`. Pass
+     *   `['*all']`, `['*navigable']` or an explicit list, otherwise the returned
+     *   issues will have no `fields` object at all.
+     *
+     * @param options - Enhanced search options
+     * @returns A page of issues plus the token for the next page (if any)
+     *
+     * @example
+     * ```typescript
+     * let page = await client.search.searchJql({
+     *   jql: 'project = PROJECT',
+     *   fields: ['summary', 'status'],
+     *   maxResults: 1000,
+     * });
+     *
+     * while (page.nextPageToken) {
+     *   page = await client.search.searchJql({
+     *     jql: 'project = PROJECT',
+     *     fields: ['summary', 'status'],
+     *     maxResults: 1000,
+     *     nextPageToken: page.nextPageToken,
+     *   });
+     * }
+     * ```
+     */
+    searchJql(options: SearchJqlOptions): Promise<SearchJqlResult>;
+    /**
+     * Async iterator over every issue matching a JQL query, using the Enhanced
+     * JQL Search API and its token-based pagination.
+     *
+     * Defaults to a page size of 100 (matching the Go SDK's iterator). Remember
+     * that `fields` defaults to the issue ID only — pass the fields you need.
+     *
+     * @param jql - JQL query string
+     * @param options - Enhanced search options minus `jql` and `nextPageToken`
+     * @returns An async generator of issues
+     *
+     * @example
+     * ```typescript
+     * for await (const issue of client.search.iterateJql('project = PROJECT', {
+     *   fields: ['summary'],
+     * })) {
+     *   console.log(issue.key, issue.fields?.summary);
+     * }
+     * ```
+     */
+    iterateJql(jql: string, options?: Omit<SearchJqlOptions, 'jql' | 'nextPageToken'>): AsyncGenerator<SearchJqlIssue, void, undefined>;
+    /**
+     * Collect every issue matching a JQL query into an array, using the Enhanced
+     * JQL Search API. Prefer {@link SearchService.iterateJql} for large results.
+     *
+     * @param jql - JQL query string
+     * @param options - Enhanced search options minus `jql` and `nextPageToken`
+     * @returns All matching issues
+     */
+    allJql(jql: string, options?: Omit<SearchJqlOptions, 'jql' | 'nextPageToken'>): Promise<SearchJqlIssue[]>;
+}
+
+/**
+ * Security level service for Jira issue security levels and schemes
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const level = await client.securityLevels.get('10000');
+ * const schemes = await client.securityLevels.getIssueSecuritySchemes();
+ * ```
+ */
+declare class SecurityLevelService extends BaseService {
+    /**
+     * Get an issue security level by ID
+     *
+     * `GET /rest/api/3/securitylevel/{levelId}`
+     *
+     * @param levelId - ID of the security level
+     * @returns The security level
+     */
+    get(levelId: string): Promise<SecurityLevel>;
+    /**
+     * Get all issue security schemes
+     *
+     * `GET /rest/api/3/issuesecurityschemes`
+     *
+     * @returns All issue security schemes
+     */
+    getIssueSecuritySchemes(): Promise<SecurityScheme[]>;
+    /**
+     * Get an issue security scheme by ID
+     *
+     * `GET /rest/api/3/issuesecurityschemes/{schemeId}`
+     *
+     * @param schemeId - ID of the issue security scheme
+     * @returns The issue security scheme
+     */
+    getIssueSecurityScheme(schemeId: string): Promise<SecurityScheme>;
+}
+
+/**
+ * Server info service for inspecting the Jira instance
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const info = await client.serverInfo.get();
+ * console.log(info.version, info.deploymentType);
+ *
+ * const config = await client.serverInfo.getConfiguration();
+ * console.log(config.timeTrackingEnabled);
+ * ```
+ */
+declare class ServerInfoService extends BaseService {
+    /**
+     * Get information about the Jira instance
+     *
+     * `GET /rest/api/3/serverInfo`
+     *
+     * @returns Version, build and deployment details of the instance
+     */
+    get(): Promise<ServerInfo>;
+    /**
+     * Get the global configuration of the Jira instance
+     *
+     * `GET /rest/api/3/configuration`
+     *
+     * @returns Which optional Jira features are enabled
+     */
+    getConfiguration(): Promise<JiraConfiguration>;
+}
+
+/**
+ * Time tracking service for provider selection, instance configuration and
+ * worklog management.
+ *
+ * Note: the worklog methods target the same endpoints as `IssueService`'s
+ * worklog methods and are provided here for parity with the Go SDK's
+ * `timetracking` package. They reuse the shared `Worklog` schema.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * const providers = await client.timeTracking.getAvailableProviders();
+ * await client.timeTracking.selectProvider('JIRA');
+ *
+ * const worklog = await client.timeTracking.createWorklog('PROJ-123', {
+ *   timeSpent: '3h 30m',
+ *   comment: 'Worked on bug fix',
+ * });
+ * ```
+ */
+declare class TimeTrackingService extends BaseService {
+    /**
+     * List the time tracking providers available on this instance.
+     *
+     * `GET /rest/api/3/configuration/timetracking/list`
+     *
+     * @returns Every registered time tracking provider.
+     */
+    getAvailableProviders(): Promise<TimeTrackingProvider[]>;
+    /**
+     * Get the currently selected time tracking provider.
+     *
+     * `GET /rest/api/3/configuration/timetracking`
+     *
+     * @returns The active time tracking provider.
      */
-    search(options: SearchOptions): Promise<SearchResult>;
+    getSelectedProvider(): Promise<TimeTrackingProvider>;
     /**
-     * Convenience method for simple JQL search
+     * Select the active time tracking provider.
+     *
+     * `PUT /rest/api/3/configuration/timetracking`
+     *
+     * @param key - The provider key, e.g. `'JIRA'`.
+     * @returns The newly selected provider.
      */
-    jql(query: string, options?: Omit<SearchOptions, 'jql'>): Promise<SearchResult>;
+    selectProvider(key: string): Promise<TimeTrackingProvider>;
     /**
-     * Async iterator for paginating through all search results
+     * Get the instance-wide time tracking settings.
      *
-     * @example
-     * ```typescript
-     * for await (const issue of client.search.iterate('project = PROJECT')) {
-     *   console.log(issue.key, issue.fields.summary);
-     * }
-     * ```
+     * `GET /rest/api/3/configuration/timetracking/options`
+     *
+     * @returns The current time tracking configuration.
      */
-    iterate(jql: string, options?: Omit<SearchOptions, 'jql' | 'startAt'>): AsyncGenerator<Issue, void, undefined>;
+    getConfiguration(): Promise<TimeTrackingConfiguration>;
     /**
-     * Get all issues matching a JQL query (loads all pages into memory)
-     * Use with caution for large result sets - prefer iterate() instead
+     * Update the instance-wide time tracking settings.
+     *
+     * `PUT /rest/api/3/configuration/timetracking/options`
+     *
+     * @param input - The settings to change; omitted fields are left untouched.
+     * @returns The updated time tracking configuration.
      */
-    all(jql: string, options?: Omit<SearchOptions, 'jql' | 'startAt'>): Promise<Issue[]>;
+    updateConfiguration(input: UpdateTimeTrackingConfigurationInput): Promise<TimeTrackingConfiguration>;
     /**
-     * Count issues matching a JQL query (more efficient than fetching all)
+     * Get the worklogs recorded against an issue.
+     *
+     * `GET /rest/api/3/issue/{issueIdOrKey}/worklog`
+     *
+     * @param issueIdOrKey - The issue ID or key.
+     * @param options - Pagination, `started` bounds and expansion.
+     * @returns The worklogs for the requested page.
      */
-    count(jql: string): Promise<number>;
+    getIssueWorklogs(issueIdOrKey: string, options?: WorklogListOptions): Promise<Worklog[]>;
+    /**
+     * Get a single worklog by ID.
+     *
+     * `GET /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}`
+     *
+     * @param issueIdOrKey - The issue ID or key.
+     * @param worklogId - The worklog ID.
+     * @returns The requested worklog.
+     */
+    getWorklog(issueIdOrKey: string, worklogId: string): Promise<Worklog>;
+    /**
+     * Add a worklog to an issue.
+     *
+     * `POST /rest/api/3/issue/{issueIdOrKey}/worklog`
+     *
+     * @param issueIdOrKey - The issue ID or key.
+     * @param input - The worklog to record; supply `timeSpent` or `timeSpentSeconds`.
+     * @returns The created worklog.
+     */
+    createWorklog(issueIdOrKey: string, input: TimeTrackingCreateWorklogInput): Promise<Worklog>;
+    /**
+     * Update an existing worklog.
+     *
+     * `PUT /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}`
+     *
+     * @param issueIdOrKey - The issue ID or key.
+     * @param worklogId - The worklog ID.
+     * @param input - The fields to change.
+     * @returns The updated worklog.
+     */
+    updateWorklog(issueIdOrKey: string, worklogId: string, input: TimeTrackingUpdateWorklogInput): Promise<Worklog>;
+    /**
+     * Delete a worklog.
+     *
+     * `DELETE /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}`
+     *
+     * @param issueIdOrKey - The issue ID or key.
+     * @param worklogId - The worklog ID.
+     * @returns Nothing; the endpoint responds with 204 No Content.
+     */
+    deleteWorklog(issueIdOrKey: string, worklogId: string): Promise<void>;
 }
 
+/**
+ * A group the user belongs to
+ */
+declare const GroupItemSchema: z.ZodObject<{
+    name: z.ZodOptional<z.ZodString>;
+    self: z.ZodOptional<z.ZodURL>;
+    groupId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type GroupItem = z.infer<typeof GroupItemSchema>;
+/**
+ * A user property
+ */
+declare const UserPropertySchema: z.ZodObject<{
+    key: z.ZodString;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+type UserProperty = z.infer<typeof UserPropertySchema>;
+/**
+ * Options for {@link UserService.bulkGet}
+ */
+interface BulkGetUsersOptions {
+    /** Account IDs to retrieve (required, repeated as `accountId` query params) */
+    accountIds: string[];
+    startAt?: number;
+    maxResults?: number;
+}
+/**
+ * Options for {@link UserService.findUsersWithAllPermissions}
+ */
+interface FindUsersWithAllPermissionsOptions {
+    /** Permissions the users must all have (required) */
+    permissions: string[];
+    issueKey?: string;
+    projectKey?: string;
+    query?: string;
+    startAt?: number;
+    maxResults?: number;
+}
+/**
+ * Options for {@link UserService.findUsersWithBrowsePermission}
+ */
+interface FindUsersWithBrowsePermissionOptions {
+    query?: string;
+    issueKey?: string;
+    projectKey?: string;
+    startAt?: number;
+    maxResults?: number;
+}
 /**
  * User service for user-related operations
  *
@@ -687,6 +3778,12 @@ declare class SearchService extends BaseService {
 declare class UserService extends BaseService {
     /**
      * Get the currently authenticated user
+     *
+     * @deprecated Prefer {@link MyselfService.get} via `client.myself.get()`.
+     * Both call `GET /rest/api/3/myself`, but MyselfService returns the richer
+     * `CurrentUser` shape (including `groups` and `expand`) and is the home of
+     * the related preference methods. This method is kept for compatibility and
+     * still works.
      */
     getCurrentUser(options?: {
         expand?: string[];
@@ -741,6 +3838,462 @@ declare class UserService extends BaseService {
         startAt?: number;
         maxResults?: number;
     }): Promise<User[]>;
+    /**
+     * Get multiple users by account ID
+     *
+     * `GET /rest/api/3/user/bulk`
+     *
+     * @param options - Account IDs plus optional pagination
+     * @returns The matching users
+     */
+    bulkGet(options: BulkGetUsersOptions): Promise<User[]>;
+    /**
+     * Get a user's default issue-table columns
+     *
+     * `GET /rest/api/3/user/columns`
+     *
+     * @param accountId - Account ID of the user
+     * @returns The column IDs, in display order
+     */
+    getDefaultColumns(accountId: string): Promise<string[]>;
+    /**
+     * Set the calling user's default issue-table columns
+     *
+     * `PUT /rest/api/3/user/columns`
+     *
+     * Deviates from the Go SDK, which sends a bare JSON array as the body. The
+     * documented request body is `UserColumnRequestBody`, an object with a
+     * `columns` array — "The ID of a column to set. To set multiple columns, send
+     * multiple `columns` parameters."
+     *
+     * @param columns - Column IDs, e.g. `['issuekey', 'summary', 'status']`
+     * @returns Nothing
+     */
+    setDefaultColumns(columns: string[]): Promise<void>;
+    /**
+     * Reset a user's default issue-table columns to the system defaults
+     *
+     * `DELETE /rest/api/3/user/columns`
+     *
+     * @param accountId - Account ID of the user
+     * @returns Nothing
+     */
+    resetDefaultColumns(accountId: string): Promise<void>;
+    /**
+     * Get a user property
+     *
+     * `GET /rest/api/3/user/properties/{propertyKey}`
+     *
+     * @param accountId - Account ID of the user
+     * @param propertyKey - Property key
+     * @returns The property key and value
+     */
+    getUserProperty(accountId: string, propertyKey: string): Promise<UserProperty>;
+    /**
+     * Set a user property
+     *
+     * `PUT /rest/api/3/user/properties/{propertyKey}`
+     *
+     * @param accountId - Account ID of the user
+     * @param propertyKey - Property key
+     * @param value - JSON-serialisable property value
+     * @returns Nothing
+     */
+    setUserProperty(accountId: string, propertyKey: string, value: unknown): Promise<void>;
+    /**
+     * Delete a user property
+     *
+     * `DELETE /rest/api/3/user/properties/{propertyKey}`
+     *
+     * @param accountId - Account ID of the user
+     * @param propertyKey - Property key
+     * @returns Nothing
+     */
+    deleteUserProperty(accountId: string, propertyKey: string): Promise<void>;
+    /**
+     * Get the groups a user belongs to
+     *
+     * `GET /rest/api/3/user/groups`
+     *
+     * @param accountId - Account ID of the user
+     * @returns The user's groups
+     */
+    getUserGroups(accountId: string): Promise<GroupItem[]>;
+    /**
+     * Find users who have all of the given permissions
+     *
+     * `GET /rest/api/3/user/permission/search`
+     *
+     * @param options - Permissions (required) plus optional filters
+     * @returns The matching users
+     */
+    findUsersWithAllPermissions(options: FindUsersWithAllPermissionsOptions): Promise<User[]>;
+    /**
+     * Find users who can browse the given issue or project
+     *
+     * `GET /rest/api/3/user/viewissue/search`
+     *
+     * @param options - Optional filters
+     * @returns The matching users
+     */
+    findUsersWithBrowsePermission(options?: FindUsersWithBrowsePermissionOptions): Promise<User[]>;
+    /**
+     * Find users by display name, email address or account ID
+     *
+     * Convenience wrapper around {@link UserService.search}.
+     *
+     * @param name - Search string (required)
+     * @param maxResults - Maximum results; defaults to 50 when omitted or <= 0
+     * @returns The matching users
+     */
+    findByName(name: string, maxResults?: number): Promise<User[]>;
+}
+
+/**
+ * Webhook service for managing Jira webhook registrations.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // List webhooks
+ * const webhooks = await client.webhooks.list({ maxResults: 50 });
+ *
+ * // Register webhooks. The callback URL is a single top-level argument —
+ * // Jira allows only one registered URL per app, and it must share the
+ * // Connect app's base URL.
+ * const results = await client.webhooks.create('https://example.com/webhooks/jira', [
+ *   {
+ *     events: ['jira:issue_created'],
+ *     jqlFilter: 'project = PROJ',
+ *   },
+ * ]);
+ *
+ * // Iterate every webhook
+ * for await (const webhook of client.webhooks.iterate()) {
+ *   console.log(webhook.id, webhook.url);
+ * }
+ * ```
+ */
+declare class WebhookService extends BaseService {
+    /**
+     * List registered webhooks.
+     *
+     * `GET /rest/api/3/webhook`
+     *
+     * @param options - Pagination options
+     * @returns The webhooks on the requested page
+     */
+    list(options?: WebhookListOptions): Promise<Webhook[]>;
+    /**
+     * Async iterator over every registered webhook, paging transparently.
+     *
+     * `GET /rest/api/3/webhook`
+     *
+     * @param options - Page size options (`startAt` is managed by the iterator)
+     * @returns An async generator yielding webhooks
+     */
+    iterate(options?: Omit<WebhookListOptions, 'startAt'>): AsyncGenerator<Webhook, void, undefined>;
+    /**
+     * Collect every registered webhook into an array.
+     *
+     * `GET /rest/api/3/webhook`
+     *
+     * @param options - Page size options
+     * @returns All webhooks across all pages
+     */
+    all(options?: Omit<WebhookListOptions, 'startAt'>): Promise<Webhook[]>;
+    /**
+     * Get a single webhook by ID.
+     *
+     * `GET /rest/api/3/webhook/{webhookId}`
+     *
+     * @param webhookId - The numeric webhook ID
+     * @returns The webhook
+     */
+    get(webhookId: number): Promise<Webhook>;
+    /**
+     * Register one or more webhooks.
+     *
+     * `POST /rest/api/3/webhook`
+     *
+     * Deviates from the Go SDK, which sends `{"webhooks": [{name, url, ...}]}`
+     * with a `url` (and `name`) per webhook. The documented request body is
+     * `WebhookRegistrationDetails`: a single top-level `url` — only one callback
+     * URL per app may be registered, and it must share the Connect app's base
+     * URL — plus a `webhooks` array of `WebhookDetails` objects that have no
+     * `name`/`url` and require `jqlFilter`.
+     *
+     * @param url - The callback URL that receives every registered webhook
+     * @param inputs - The webhooks to register (at least one)
+     * @returns One registration result per submitted webhook
+     */
+    create(url: string, inputs: CreateWebhookInput[]): Promise<WebhookRegistrationResult[]>;
+    /**
+     * Update an existing webhook.
+     *
+     * `PUT /rest/api/3/webhook/{webhookId}`
+     *
+     * @param webhookId - The numeric webhook ID
+     * @param input - The fields to update
+     * @returns The updated webhook
+     */
+    update(webhookId: number, input: UpdateWebhookInput): Promise<Webhook>;
+    /**
+     * Delete one or more webhooks.
+     *
+     * `DELETE /rest/api/3/webhook`
+     *
+     * Deviates from the Go SDK, which sends the IDs as repeated `webhookId`
+     * query parameters. The endpoint documents a required JSON request body
+     * (`ContainerForWebhookIDs`, `{"webhookIds": [...]}`) and declares no query
+     * parameters at all.
+     *
+     * @param webhookIds - The webhook IDs to delete (at least one)
+     * @returns Nothing
+     */
+    deleteWebhooks(webhookIds: number[]): Promise<void>;
+    /**
+     * Extend the expiration date of webhooks.
+     *
+     * `PUT /rest/api/3/webhook/refresh`
+     *
+     * @param webhookIds - The webhook IDs to refresh (at least one)
+     * @returns The new expiration timestamp (epoch milliseconds)
+     */
+    refresh(webhookIds: number[]): Promise<number>;
+    /**
+     * Get the dynamic modules registered by the app.
+     *
+     * `GET /rest/api/3/app/module/dynamic`
+     *
+     * @returns The dynamic module registration payload
+     */
+    getDynamicModules(): Promise<DynamicModules>;
+    /**
+     * Get webhooks whose delivery recently failed.
+     *
+     * `GET /rest/api/3/webhook/failed`
+     *
+     * @param options - Pagination options (only `maxResults` is sent)
+     * @returns The failed webhook deliveries
+     */
+    getFailedWebhooks(options?: WebhookListOptions): Promise<FailedWebhook[]>;
+    /**
+     * Fetch a single page of webhooks, including its pagination metadata.
+     */
+    private listPage;
+}
+
+/**
+ * Workflow service for workflows, statuses, status categories, transitions
+ * and workflow schemes.
+ *
+ * @example
+ * ```typescript
+ * const client = new JiraClient({ ... });
+ *
+ * // Available transitions for an issue
+ * const transitions = await client.workflows.getTransitions('PROJ-123');
+ *
+ * // Perform a transition
+ * await client.workflows.doTransition('PROJ-123', { transition: { id: '31' } });
+ *
+ * // Page through every workflow
+ * for await (const workflow of client.workflows.iterate()) {
+ *   console.log(workflow.name);
+ * }
+ * ```
+ */
+declare class WorkflowService extends BaseService {
+    /**
+     * Get the transitions currently available on an issue
+     *
+     * `GET /rest/api/3/issue/{issueIdOrKey}/transitions`
+     *
+     * Note: this overlaps with `IssueService.getTransitions`. It is provided here
+     * because the Go SDK exposes it on both services; this variant returns the
+     * transition array directly and additionally supports
+     * `skipRemoteOnlyCondition`.
+     *
+     * @param issueIdOrKey - Issue ID or key (e.g. `PROJ-123`)
+     * @param options - Optional expand / filtering options
+     * @returns The transitions available to the current user
+     */
+    getTransitions(issueIdOrKey: string, options?: GetWorkflowTransitionsOptions): Promise<WorkflowTransition[]>;
+    /**
+     * Perform a workflow transition on an issue
+     *
+     * `POST /rest/api/3/issue/{issueIdOrKey}/transitions`
+     *
+     * Note: this overlaps with `IssueService.doTransition`; the Go SDK exposes it
+     * on both services.
+     *
+     * @param issueIdOrKey - Issue ID or key (e.g. `PROJ-123`)
+     * @param input - The transition to perform plus optional field/update payloads
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    doTransition(issueIdOrKey: string, input: WorkflowDoTransitionInput): Promise<void>;
+    /**
+     * Search workflows (paginated)
+     *
+     * `GET /rest/api/3/workflow/search`
+     *
+     * @param options - Optional name filter and pagination
+     * @returns A page of workflows
+     */
+    list(options?: ListWorkflowsOptions): Promise<WorkflowSearchResult>;
+    /**
+     * Async iterator over every workflow, transparently paging the API
+     *
+     * @param options - Optional name filter; `maxResults` sets the page size
+     * @returns An async generator yielding each workflow
+     */
+    iterate(options?: Omit<ListWorkflowsOptions, 'startAt'>): AsyncGenerator<Workflow, void, undefined>;
+    /**
+     * Collect every workflow into an array (loads all pages into memory)
+     *
+     * @param options - Optional name filter; `maxResults` sets the page size
+     * @returns All workflows
+     */
+    all(options?: Omit<ListWorkflowsOptions, 'startAt'>): Promise<Workflow[]>;
+    /**
+     * Get a workflow by entity ID or by name
+     *
+     * `GET /rest/api/3/workflow/search` (paged)
+     *
+     * Deviates from the Go SDK, which issues
+     * `GET /rest/api/3/workflow/{workflowIdOrName}`. No such read endpoint exists
+     * in the v3 API — the only `/rest/api/3/workflow/{entityId}` operation is
+     * `DELETE` (delete inactive workflow), so the Go call returns 405/404. The
+     * documented read path is `GET /rest/api/3/workflow/search`.
+     *
+     * The ID-or-name behaviour is preserved: the search is narrowed with the
+     * `workflowName` filter, and the returned page is matched against both the
+     * workflow's `id.name` and its `id.entityId`. If the argument is an entity ID
+     * rather than a name the name filter yields nothing, so the search is retried
+     * unfiltered and matched on `entityId`.
+     *
+     * @param workflowIdOrName - Workflow entity ID or workflow name
+     * @returns The workflow
+     * @throws If no workflow matches
+     */
+    get(workflowIdOrName: string): Promise<Workflow>;
+    /**
+     * Get every status defined in the Jira instance
+     *
+     * `GET /rest/api/3/status`
+     *
+     * @returns All statuses
+     */
+    getAllStatuses(): Promise<WorkflowStatus[]>;
+    /**
+     * Get a status by ID or name
+     *
+     * `GET /rest/api/3/status/{idOrName}`
+     *
+     * @param statusIdOrName - Status ID or name
+     * @returns The status
+     */
+    getStatus(statusIdOrName: string): Promise<WorkflowStatus>;
+    /**
+     * Get every status category
+     *
+     * `GET /rest/api/3/statuscategory`
+     *
+     * @returns All status categories
+     */
+    getStatusCategories(): Promise<WorkflowStatusCategory[]>;
+    /**
+     * Get a status category by ID or key
+     *
+     * `GET /rest/api/3/statuscategory/{idOrKey}`
+     *
+     * @param idOrKey - Status category ID (e.g. `2`) or key (e.g. `done`)
+     * @returns The status category
+     */
+    getStatusCategory(idOrKey: string): Promise<WorkflowStatusCategory>;
+    /**
+     * Get a workflow scheme by ID
+     *
+     * `GET /rest/api/3/workflowscheme/{id}`
+     *
+     * @param schemeId - Workflow scheme ID
+     * @returns The workflow scheme
+     */
+    getWorkflowScheme(schemeId: number): Promise<WorkflowScheme>;
+    /**
+     * List workflow schemes (paginated)
+     *
+     * `GET /rest/api/3/workflowscheme`
+     *
+     * @param options - Optional pagination
+     * @returns A page of workflow schemes
+     */
+    listWorkflowSchemes(options?: ListWorkflowSchemesOptions): Promise<WorkflowSchemeListResult>;
+    /**
+     * Async iterator over every workflow scheme, transparently paging the API
+     *
+     * @param options - Optional pagination; `maxResults` sets the page size
+     * @returns An async generator yielding each workflow scheme
+     */
+    iterateWorkflowSchemes(options?: Omit<ListWorkflowSchemesOptions, 'startAt'>): AsyncGenerator<WorkflowScheme, void, undefined>;
+    /**
+     * Collect every workflow scheme into an array (loads all pages into memory)
+     *
+     * @param options - Optional pagination; `maxResults` sets the page size
+     * @returns All workflow schemes
+     */
+    allWorkflowSchemes(options?: Omit<ListWorkflowSchemesOptions, 'startAt'>): Promise<WorkflowScheme[]>;
+    /**
+     * Create a workflow scheme
+     *
+     * `POST /rest/api/3/workflowscheme`
+     *
+     * @param input - Scheme name plus optional description, default workflow and
+     * issue type mappings
+     * @returns The created workflow scheme
+     */
+    createWorkflowScheme(input: CreateWorkflowSchemeInput): Promise<WorkflowScheme>;
+    /**
+     * Update a workflow scheme
+     *
+     * `PUT /rest/api/3/workflowscheme/{id}`
+     *
+     * @param schemeId - Workflow scheme ID
+     * @param input - Fields to update
+     * @returns The updated workflow scheme
+     */
+    updateWorkflowScheme(schemeId: number, input: UpdateWorkflowSchemeInput): Promise<WorkflowScheme>;
+    /**
+     * Delete a workflow scheme
+     *
+     * `DELETE /rest/api/3/workflowscheme/{id}`
+     *
+     * @param schemeId - Workflow scheme ID
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    deleteWorkflowScheme(schemeId: number): Promise<void>;
+    /**
+     * Set the workflow used by an issue type within a workflow scheme
+     *
+     * `PUT /rest/api/3/workflowscheme/{id}/issuetype/{issueType}`
+     *
+     * @param schemeId - Workflow scheme ID
+     * @param input - The issue type, its workflow and whether to update the draft
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    setWorkflowSchemeIssueType(schemeId: number, input: WorkflowSchemeIssueTypeInput): Promise<void>;
+    /**
+     * Remove the workflow mapping for an issue type within a workflow scheme
+     *
+     * `DELETE /rest/api/3/workflowscheme/{id}/issuetype/{issueType}`
+     *
+     * @param schemeId - Workflow scheme ID
+     * @param issueType - Issue type ID
+     * @returns Nothing; the endpoint responds 204 No Content
+     */
+    deleteWorkflowSchemeIssueType(schemeId: number, issueType: string): Promise<void>;
 }
 
-export { BaseService, IssueService, ProjectService, type SearchOptions, type SearchResult, SearchService, UserService };
+export { AgileService, AppPropertiesService, AuditService, BaseService, BulkService, DashboardService, ExpressionService, FieldService, FilterService, GroupService, IssueLinkTypeService, IssueService, IssueTypeService, LabelService, MyselfService, NotificationService, PermissionService, PriorityService, ProjectService, ResolutionService, ScreenService, type SearchOptions, type SearchResult, SearchService, SecurityLevelService, ServerInfoService, TimeTrackingService, UserService, WebhookService, WorkflowService };