jira-datacenter-api-client 1.0.0

package/dist/index.js

@@ -0,0 +1,886 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  BoardResource: () => BoardResource,
+  IssueResource: () => IssueResource,
+  JiraApiError: () => JiraApiError,
+  JiraClient: () => JiraClient,
+  ProjectResource: () => ProjectResource,
+  Security: () => Security,
+  SprintResource: () => SprintResource
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/security/Security.ts
+function toBase64(value) {
+  if (typeof btoa !== "undefined") {
+    return btoa(value);
+  }
+  return Buffer.from(value).toString("base64");
+}
+var Security = class {
+  /**
+   * Creates a new Security instance with Basic Authentication credentials.
+   *
+   * @param apiUrl - The base URL of the Jira Data Center instance (e.g., `https://jira.example.com`).
+   *   Must be a valid URL; throws if it cannot be parsed.
+   * @param user - The username to authenticate with
+   * @param token - The personal access token or password to authenticate with
+   *
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor(apiUrl, user, token) {
+    if (!URL.canParse(apiUrl)) {
+      throw new TypeError(`Invalid apiUrl: "${apiUrl}" is not a valid URL`);
+    }
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.authorizationHeader = `Basic ${toBase64(`${user}:${token}`)}`;
+  }
+  /**
+   * Returns the base URL of the Jira Data Center instance, without a trailing slash.
+   *
+   * @returns The API base URL
+   */
+  getApiUrl() {
+    return this.apiUrl;
+  }
+  /**
+   * Returns the value of the `Authorization` header for Basic Authentication.
+   *
+   * @returns The Authorization header value in the format `Basic <base64-encoded-credentials>`
+   */
+  getAuthorizationHeader() {
+    return this.authorizationHeader;
+  }
+  /**
+   * Returns the full set of HTTP headers required for authenticated API requests.
+   *
+   * @returns An object containing `Authorization`, `Content-Type`, and `Accept` headers
+   */
+  getHeaders() {
+    return {
+      Authorization: this.authorizationHeader,
+      "Content-Type": "application/json",
+      Accept: "application/json"
+    };
+  }
+};
+
+// src/errors/JiraApiError.ts
+var JiraApiError = class extends Error {
+  constructor(status, statusText) {
+    super(`Jira API error: ${status} ${statusText}`);
+    this.name = "JiraApiError";
+    this.status = status;
+    this.statusText = statusText;
+  }
+};
+
+// src/resources/IssueResource.ts
+var IssueResource = class {
+  /** @internal */
+  constructor(request, issueIdOrKey) {
+    this.request = request;
+    this.basePath = `/issue/${issueIdOrKey}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the issue.
+   * Delegates to {@link IssueResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}`
+   *
+   * @param params - Optional: `fields`, `expand`, `properties`, `updateHistory`
+   * @returns The issue object
+   */
+  async get(params) {
+    return this.request(
+      this.basePath,
+      params
+    );
+  }
+  /**
+   * Fetches comments for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/comment`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `orderBy`, `expand`
+   * @returns A paged response of comments
+   */
+  async comments(params) {
+    return this.request(
+      `${this.basePath}/comment`,
+      params
+    );
+  }
+  /**
+   * Fetches a single comment by ID.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/comment/{id}`
+   *
+   * @param commentId - The numeric comment ID
+   * @returns The comment object
+   */
+  async comment(commentId) {
+    return this.request(`${this.basePath}/comment/${commentId}`);
+  }
+  /**
+   * Fetches worklogs for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/worklog`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `expand`
+   * @returns A paged response of worklogs
+   */
+  async worklogs(params) {
+    return this.request(
+      `${this.basePath}/worklog`,
+      params
+    );
+  }
+  /**
+   * Fetches a single worklog by ID.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/worklog/{id}`
+   *
+   * @param worklogId - The numeric worklog ID
+   * @returns The worklog object
+   */
+  async worklog(worklogId) {
+    return this.request(`${this.basePath}/worklog/${worklogId}`);
+  }
+  /**
+   * Fetches the changelog for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/changelog`
+   *
+   * @param params - Optional: `startAt`, `maxResults`
+   * @returns A paged response of changelog entries
+   */
+  async changelog(params) {
+    return this.request(
+      `${this.basePath}/changelog`,
+      params
+    );
+  }
+  /**
+   * Fetches the available workflow transitions for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/transitions`
+   *
+   * @param params - Optional: `transitionId`, `expand`, `skipRemoteOnlyCondition`
+   * @returns An object containing the list of transitions
+   */
+  async transitions(params) {
+    return this.request(
+      `${this.basePath}/transitions`,
+      params
+    );
+  }
+  /**
+   * Fetches the remote links (external URLs) for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/remotelink`
+   *
+   * @param globalId - Optional global ID to filter by a specific remote link
+   * @returns An array of remote links
+   */
+  async remotelinks(globalId) {
+    return this.request(
+      `${this.basePath}/remotelink`,
+      globalId !== void 0 ? { globalId } : void 0
+    );
+  }
+  /**
+   * Fetches the vote information for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/votes`
+   *
+   * @returns The votes object
+   */
+  async votes() {
+    return this.request(`${this.basePath}/votes`);
+  }
+  /**
+   * Fetches the watcher information for this issue.
+   *
+   * `GET /rest/api/latest/issue/{issueIdOrKey}/watchers`
+   *
+   * @returns The watchers object
+   */
+  async watchers() {
+    return this.request(`${this.basePath}/watchers`);
+  }
+};
+
+// src/resources/ProjectResource.ts
+var ProjectResource = class {
+  /** @internal */
+  constructor(request, projectIdOrKey) {
+    this.request = request;
+    this.basePath = `/project/${projectIdOrKey}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the project.
+   * Delegates to {@link ProjectResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the project details.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}`
+   *
+   * @param params - Optional: `expand`
+   * @returns The project object
+   */
+  async get(params) {
+    return this.request(
+      this.basePath,
+      params
+    );
+  }
+  /**
+   * Fetches the components defined in this project.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}/components`
+   *
+   * @returns An array of project components
+   */
+  async components() {
+    return this.request(`${this.basePath}/components`);
+  }
+  /**
+   * Fetches the versions defined in this project.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}/versions`
+   *
+   * @param expand - Optional: `'operations'`
+   * @returns An array of project versions
+   */
+  async versions(expand) {
+    return this.request(
+      `${this.basePath}/versions`,
+      expand !== void 0 ? { expand } : void 0
+    );
+  }
+  /**
+   * Fetches the statuses available in this project, grouped by issue type.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}/statuses`
+   *
+   * @returns An array of issue type → statuses mappings
+   */
+  async statuses() {
+    return this.request(`${this.basePath}/statuses`);
+  }
+  /**
+   * Fetches the roles defined in this project.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}/role`
+   *
+   * @returns A record mapping role names to their resource URLs
+   */
+  async roles() {
+    return this.request(`${this.basePath}/role`);
+  }
+  /**
+   * Fetches a single role by ID, including the list of actors.
+   *
+   * `GET /rest/api/latest/project/{projectIdOrKey}/role/{id}`
+   *
+   * @param roleId - The numeric role ID
+   * @returns The project role object with actors
+   */
+  async role(roleId) {
+    return this.request(`${this.basePath}/role/${roleId}`);
+  }
+};
+
+// src/resources/SprintResource.ts
+var SprintResource = class {
+  /** @internal */
+  constructor(request, agileApiPath, sprintId) {
+    this.request = request;
+    this.agileApiPath = agileApiPath;
+    this.basePath = `/sprint/${sprintId}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the sprint.
+   * Delegates to {@link SprintResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the sprint details.
+   *
+   * `GET /rest/agile/latest/sprint/{sprintId}`
+   *
+   * @returns The sprint object
+   */
+  async get() {
+    return this.request(this.basePath, void 0, { apiPath: this.agileApiPath });
+  }
+  /**
+   * Fetches issues in this sprint.
+   *
+   * `GET /rest/agile/latest/sprint/{sprintId}/issue`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `jql`, `fields`, `expand`
+   * @returns A search response containing the sprint's issues
+   */
+  async issues(params) {
+    return this.request(
+      `${this.basePath}/issue`,
+      params,
+      { apiPath: this.agileApiPath }
+    );
+  }
+};
+
+// src/resources/BoardResource.ts
+var BoardResource = class {
+  /** @internal */
+  constructor(request, agileApiPath, boardId) {
+    this.request = request;
+    this.agileApiPath = agileApiPath;
+    this.basePath = `/board/${boardId}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the board.
+   * Delegates to {@link BoardResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the board details.
+   *
+   * `GET /rest/agile/latest/board/{boardId}`
+   *
+   * @returns The board object
+   */
+  async get() {
+    return this.request(this.basePath, void 0, { apiPath: this.agileApiPath });
+  }
+  /**
+   * Fetches sprints for this board.
+   *
+   * `GET /rest/agile/latest/board/{boardId}/sprint`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `state`
+   * @returns A paged response of sprints
+   */
+  async sprints(params) {
+    return this.request(
+      `${this.basePath}/sprint`,
+      params,
+      { apiPath: this.agileApiPath }
+    );
+  }
+  /**
+   * Fetches all issues on this board (across all sprints and the backlog).
+   *
+   * `GET /rest/agile/latest/board/{boardId}/issue`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `jql`, `fields`, `expand`
+   * @returns A search response containing the board's issues
+   */
+  async issues(params) {
+    return this.request(
+      `${this.basePath}/issue`,
+      params,
+      { apiPath: this.agileApiPath }
+    );
+  }
+  /**
+   * Fetches the backlog issues for this board.
+   *
+   * `GET /rest/agile/latest/board/{boardId}/backlog`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `jql`, `fields`, `expand`
+   * @returns A search response containing the backlog issues
+   */
+  async backlog(params) {
+    return this.request(
+      `${this.basePath}/backlog`,
+      params,
+      { apiPath: this.agileApiPath }
+    );
+  }
+  /**
+   * Returns a {@link SprintResource} for a given sprint ID.
+   *
+   * The returned resource can be awaited directly to fetch sprint info,
+   * or chained to access sprint issues.
+   *
+   * @param sprintId - The numeric sprint ID
+   * @returns A chainable sprint resource
+   *
+   * @example
+   * ```typescript
+   * const sprint       = await jiraClient.board(42).sprint(10);
+   * const sprintIssues = await jiraClient.board(42).sprint(10).issues();
+   * ```
+   */
+  sprint(sprintId) {
+    return new SprintResource(this.request, this.agileApiPath, sprintId);
+  }
+};
+
+// src/JiraClient.ts
+var JiraClient = class {
+  /**
+   * @param options - Connection and authentication options
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor({ apiUrl, apiPath = "rest/api/latest", agileApiPath = "rest/agile/latest", user, token }) {
+    this.listeners = /* @__PURE__ */ new Map();
+    this.security = new Security(apiUrl, user, token);
+    this.apiPath = apiPath.replace(/^\/|\/$/g, "");
+    this.agileApiPath = agileApiPath.replace(/^\/|\/$/g, "");
+  }
+  /**
+   * Subscribes to a client event.
+   *
+   * @example
+   * ```typescript
+   * jira.on('request', (event) => {
+   *   console.log(`${event.method} ${event.url} — ${event.durationMs}ms`);
+   *   if (event.error) console.error('Request failed:', event.error);
+   * });
+   * ```
+   */
+  on(event, callback) {
+    const callbacks = this.listeners.get(event) ?? [];
+    callbacks.push(callback);
+    this.listeners.set(event, callbacks);
+    return this;
+  }
+  emit(event, payload) {
+    const callbacks = this.listeners.get(event) ?? [];
+    for (const cb of callbacks) {
+      cb(payload);
+    }
+  }
+  /**
+   * Performs an authenticated GET request to the Jira REST API.
+   * @internal
+   */
+  async request(path, params, options) {
+    const apiPath = options?.apiPath ?? this.apiPath;
+    const base = `${this.security.getApiUrl()}/${apiPath}${path}`;
+    const url = buildUrl(base, params);
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const response = await fetch(url, { headers: this.security.getHeaders() });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new JiraApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      this.emit("request", { url, method: "GET", startedAt, finishedAt: /* @__PURE__ */ new Date(), durationMs: Date.now() - startedAt.getTime(), statusCode });
+      return data;
+    } catch (err) {
+      const finishedAt = /* @__PURE__ */ new Date();
+      this.emit("request", { url, method: "GET", startedAt, finishedAt, durationMs: finishedAt.getTime() - startedAt.getTime(), statusCode, error: err instanceof Error ? err : new Error(String(err)) });
+      throw err;
+    }
+  }
+  async requestPost(path, body, options) {
+    const apiPath = options?.apiPath ?? this.apiPath;
+    const url = `${this.security.getApiUrl()}/${apiPath}${path}`;
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const response = await fetch(url, {
+        method: "POST",
+        headers: this.security.getHeaders(),
+        body: JSON.stringify(body)
+      });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new JiraApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      this.emit("request", { url, method: "POST", startedAt, finishedAt: /* @__PURE__ */ new Date(), durationMs: Date.now() - startedAt.getTime(), statusCode });
+      return data;
+    } catch (err) {
+      const finishedAt = /* @__PURE__ */ new Date();
+      this.emit("request", { url, method: "POST", startedAt, finishedAt, durationMs: finishedAt.getTime() - startedAt.getTime(), statusCode, error: err instanceof Error ? err : new Error(String(err)) });
+      throw err;
+    }
+  }
+  // ─── Issue ───────────────────────────────────────────────────────────────────
+  /**
+   * Returns an {@link IssueResource} for a given issue key or ID, providing access
+   * to issue data and sub-resources (comments, changelog, transitions, etc.).
+   *
+   * The returned resource can be awaited directly to fetch the issue,
+   * or chained to access nested resources.
+   *
+   * @param issueIdOrKey - The issue key (e.g., `'PROJ-42'`) or numeric ID
+   * @returns A chainable issue resource
+   *
+   * @example
+   * ```typescript
+   * const issue      = await jira.issue('PROJ-42');
+   * const comments   = await jira.issue('PROJ-42').comments();
+   * const changelog  = await jira.issue('PROJ-42').changelog();
+   * const transitions = await jira.issue('PROJ-42').transitions();
+   * ```
+   */
+  issue(issueIdOrKey) {
+    const requestFn = (path, params, options) => this.request(path, params, options);
+    return new IssueResource(requestFn, issueIdOrKey);
+  }
+  // ─── Search ──────────────────────────────────────────────────────────────────
+  /**
+   * Searches for issues using JQL.
+   *
+   * `GET /rest/api/latest/search`
+   *
+   * @param params - Optional: `jql`, `startAt`, `maxResults`, `fields`, `expand`, `validateQuery`
+   * @returns A search response containing matching issues
+   *
+   * @example
+   * ```typescript
+   * const results = await jira.search({
+   *   jql: 'project = PROJ AND status = Open ORDER BY created DESC',
+   *   maxResults: 50,
+   *   fields: 'summary,status,assignee,priority',
+   * });
+   * ```
+   */
+  async search(params) {
+    return this.request(
+      "/search",
+      params
+    );
+  }
+  // ─── Projects ────────────────────────────────────────────────────────────────
+  /**
+   * Fetches all projects accessible to the authenticated user.
+   *
+   * `GET /rest/api/latest/project`
+   *
+   * @param params - Optional: `expand`, `recent`
+   * @returns An array of projects
+   */
+  async projects(params) {
+    return this.request(
+      "/project",
+      params
+    );
+  }
+  /**
+   * Returns a {@link ProjectResource} for a given project key or ID.
+   *
+   * The returned resource can be awaited directly to fetch project info,
+   * or chained to access nested resources.
+   *
+   * @param projectIdOrKey - The project key (e.g., `'PROJ'`) or numeric ID
+   * @returns A chainable project resource
+   *
+   * @example
+   * ```typescript
+   * const project    = await jira.project('PROJ');
+   * const components = await jira.project('PROJ').components();
+   * const versions   = await jira.project('PROJ').versions();
+   * const statuses   = await jira.project('PROJ').statuses();
+   * ```
+   */
+  project(projectIdOrKey) {
+    const requestFn = (path, params, options) => this.request(path, params, options);
+    return new ProjectResource(requestFn, projectIdOrKey);
+  }
+  // ─── Users ───────────────────────────────────────────────────────────────────
+  /**
+   * Searches for users.
+   *
+   * `GET /rest/api/latest/user/search`
+   *
+   * @param params - Optional: `username`, `startAt`, `maxResults`
+   * @returns An array of users
+   */
+  async users(params) {
+    return this.request(
+      "/user/search",
+      params
+    );
+  }
+  /**
+   * Fetches a single user by username or key.
+   *
+   * `GET /rest/api/latest/user`
+   *
+   * @param username - The username (login name) to look up
+   * @returns The user object
+   *
+   * @example
+   * ```typescript
+   * const user = await jira.user('pilmee');
+   * ```
+   */
+  async user(username) {
+    return this.request("/user", { username });
+  }
+  /**
+   * Fetches the currently authenticated user.
+   *
+   * `GET /rest/api/latest/myself`
+   *
+   * @returns The authenticated user object
+   *
+   * @example
+   * ```typescript
+   * const me = await jira.currentUser();
+   * ```
+   */
+  async currentUser() {
+    return this.request("/myself");
+  }
+  // ─── Boards (Agile) ──────────────────────────────────────────────────────────
+  /**
+   * Fetches all boards accessible to the authenticated user.
+   *
+   * `GET /rest/agile/latest/board`
+   *
+   * @param params - Optional: `startAt`, `maxResults`, `type`, `name`, `projectKeyOrId`
+   * @returns A paged response of boards
+   */
+  async boards(params) {
+    return this.request(
+      "/board",
+      params,
+      { apiPath: this.agileApiPath }
+    );
+  }
+  /**
+   * Returns a {@link BoardResource} for a given board ID.
+   *
+   * The returned resource can be awaited directly to fetch board info,
+   * or chained to access nested resources (sprints, issues, backlog).
+   *
+   * @param boardId - The numeric board ID
+   * @returns A chainable board resource
+   *
+   * @example
+   * ```typescript
+   * const board       = await jira.board(42);
+   * const sprints     = await jira.board(42).sprints({ state: 'active' });
+   * const backlog     = await jira.board(42).backlog({ maxResults: 50 });
+   * const sprintIssues = await jira.board(42).sprint(10).issues();
+   * ```
+   */
+  board(boardId) {
+    const requestFn = (path, params, options) => this.request(path, params, options);
+    return new BoardResource(requestFn, this.agileApiPath, boardId);
+  }
+  // ─── Metadata ────────────────────────────────────────────────────────────────
+  /**
+   * Fetches all issue types available to the authenticated user.
+   *
+   * `GET /rest/api/latest/issuetype`
+   *
+   * @returns An array of issue types
+   */
+  async issuetypes() {
+    return this.request("/issuetype");
+  }
+  /**
+   * Fetches a single issue type by ID.
+   *
+   * `GET /rest/api/latest/issuetype/{id}`
+   *
+   * @param id - The issue type ID
+   * @returns The issue type object
+   */
+  async issuetype(id) {
+    return this.request(`/issuetype/${id}`);
+  }
+  /**
+   * Fetches all priorities.
+   *
+   * `GET /rest/api/latest/priority`
+   *
+   * @returns An array of priorities
+   */
+  async priorities() {
+    return this.request("/priority");
+  }
+  /**
+   * Fetches a single priority by ID.
+   *
+   * `GET /rest/api/latest/priority/{id}`
+   *
+   * @param id - The priority ID
+   * @returns The priority object
+   */
+  async priority(id) {
+    return this.request(`/priority/${id}`);
+  }
+  /**
+   * Fetches all statuses.
+   *
+   * `GET /rest/api/latest/status`
+   *
+   * @returns An array of statuses
+   */
+  async statuses() {
+    return this.request("/status");
+  }
+  /**
+   * Fetches a single status by ID or name.
+   *
+   * `GET /rest/api/latest/status/{idOrName}`
+   *
+   * @param idOrName - The status ID or name
+   * @returns The status object
+   */
+  async status(idOrName) {
+    return this.request(`/status/${encodeURIComponent(idOrName)}`);
+  }
+  /**
+   * Fetches all issue fields (system and custom).
+   *
+   * `GET /rest/api/latest/field`
+   *
+   * @returns An array of fields
+   */
+  async fields() {
+    return this.request("/field");
+  }
+  /**
+   * Fetches all issue link types.
+   *
+   * `GET /rest/api/latest/issueLinkType`
+   *
+   * @returns An object with the list of issue link types
+   */
+  async issueLinkTypes() {
+    return this.request("/issueLinkType");
+  }
+  /**
+   * Fetches the authenticated user's favourite filters.
+   *
+   * `GET /rest/api/latest/filter/favourite`
+   *
+   * @returns An array of filters
+   */
+  async favouriteFilters() {
+    return this.request("/filter/favourite");
+  }
+  /**
+   * Fetches a single filter by ID.
+   *
+   * `GET /rest/api/latest/filter/{id}`
+   *
+   * @param filterId - The numeric filter ID
+   * @returns The filter object
+   */
+  async filter(filterId) {
+    return this.request(`/filter/${filterId}`);
+  }
+  /**
+   * Fetches issues using a `POST` search, which supports larger JQL queries
+   * and additional options such as specifying the fields list as an array.
+   *
+   * `POST /rest/api/latest/search`
+   *
+   * @param body - Search request body
+   * @returns A search response containing matching issues
+   *
+   * @example
+   * ```typescript
+   * const results = await jira.searchPost({
+   *   jql: 'project = PROJ AND status = Open',
+   *   maxResults: 100,
+   *   fields: ['summary', 'status', 'assignee'],
+   * });
+   * ```
+   */
+  async searchPost(body) {
+    return this.requestPost("/search", body);
+  }
+  // ─── Components & Versions ───────────────────────────────────────────────────
+  /**
+   * Fetches a single component by ID.
+   *
+   * `GET /rest/api/latest/component/{id}`
+   *
+   * @param componentId - The component ID
+   * @returns The component object
+   */
+  async component(componentId) {
+    return this.request(`/component/${componentId}`);
+  }
+  /**
+   * Fetches a single version by ID.
+   *
+   * `GET /rest/api/latest/version/{id}`
+   *
+   * @param versionId - The version ID
+   * @returns The version object
+   */
+  async version(versionId) {
+    return this.request(`/version/${versionId}`);
+  }
+  /**
+   * Fetches the related issue counts for a version.
+   *
+   * `GET /rest/api/latest/version/{id}/relatedIssueCounts`
+   *
+   * @param versionId - The version ID
+   * @returns Issue counts by type
+   */
+  async versionIssueCounts(versionId) {
+    return this.request(`/version/${versionId}/relatedIssueCounts`);
+  }
+  /**
+   * Fetches the number of unresolved issues for a version.
+   *
+   * `GET /rest/api/latest/version/{id}/unresolvedIssueCount`
+   *
+   * @param versionId - The version ID
+   * @returns The unresolved issue count
+   */
+  async versionUnresolvedIssueCount(versionId) {
+    return this.request(`/version/${versionId}/unresolvedIssueCount`);
+  }
+};
+function buildUrl(base, params) {
+  if (!params) return base;
+  const entries = Object.entries(params).filter(([, v]) => v !== void 0);
+  if (entries.length === 0) return base;
+  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));
+  return `${base}?${search.toString()}`;
+}
+//# sourceMappingURL=index.js.map