bitbucket-datacenter-api-client 0.1.0

package/dist/index.js

@@ -0,0 +1,272 @@
+"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, {
+  BitbucketClient: () => BitbucketClient,
+  ProjectResource: () => ProjectResource,
+  RepositoryResource: () => RepositoryResource,
+  Security: () => Security
+});
+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 Bitbucket Data Center instance (e.g., `https://bitbucket.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 Bitbucket 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/resources/RepositoryResource.ts
+var RepositoryResource = class {
+  /** @internal */
+  constructor(request, projectKey, repoSlug) {
+    this.request = request;
+    this.basePath = `/projects/${projectKey}/repos/${repoSlug}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the repository info.
+   * Delegates to {@link RepositoryResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the repository details.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}`
+   *
+   * @returns The repository object
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches pull requests for this repository.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}/pull-requests`
+   *
+   * @param params - Optional filters: `limit`, `start`, `state`, `direction`, `at`, `order`
+   * @returns An array of pull requests
+   */
+  async pullRequests(params) {
+    const data = await this.request(
+      `${this.basePath}/pull-requests`,
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Fetches commits for this repository.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}/commits`
+   *
+   * @param params - Optional filters: `limit`, `start`, `until`, `since`, `path`, `merges`, `followRenames`, `ignoreMissing`
+   * @returns An array of commits
+   */
+  async commits(params) {
+    const data = await this.request(
+      `${this.basePath}/commits`,
+      params
+    );
+    return data.values;
+  }
+};
+
+// src/resources/ProjectResource.ts
+var ProjectResource = class {
+  /** @internal */
+  constructor(request, key) {
+    this.request = request;
+    this.key = key;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the project info.
+   * Delegates to {@link ProjectResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the project details.
+   *
+   * `GET /rest/api/latest/projects/{key}`
+   *
+   * @returns The project object
+   */
+  async get() {
+    return this.request(`/projects/${this.key}`);
+  }
+  /**
+   * Fetches repositories belonging to this project.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos`
+   *
+   * @param params - Optional filters: `limit`, `start`, `slug`, `name`, `permission`
+   * @returns An array of repositories
+   */
+  async repos(params) {
+    const data = await this.request(
+      `/projects/${this.key}/repos`,
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Returns a {@link RepositoryResource} for a given repository slug, providing
+   * access to repository-level data and sub-resources (pull requests, commits, etc.).
+   *
+   * The returned resource can be awaited directly to fetch repository info,
+   * or chained to access nested resources.
+   *
+   * @param repoSlug - The repository slug (e.g., `'my-repo'`)
+   * @returns A chainable repository resource
+   *
+   * @example
+   * ```typescript
+   * const repo    = await bbClient.project('PROJ').repo('my-repo');
+   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });
+   * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });
+   * ```
+   */
+  repo(repoSlug) {
+    return new RepositoryResource(this.request, this.key, repoSlug);
+  }
+};
+
+// src/BitbucketClient.ts
+var BitbucketClient = class {
+  /**
+   * @param options - Connection and authentication options
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor({ apiUrl, user, token }) {
+    this.security = new Security(apiUrl, user, token);
+  }
+  /**
+   * Performs an authenticated GET request to the Bitbucket REST API.
+   *
+   * @param path - API path relative to `/rest/api/latest` (e.g., `'/projects'`)
+   * @param params - Optional query parameters to append to the URL
+   * @throws {Error} If the HTTP response is not OK
+   * @internal
+   */
+  async request(path, params) {
+    const base = `${this.security.getApiUrl()}/rest/api/latest${path}`;
+    const url = buildUrl(base, params);
+    const response = await fetch(url, { headers: this.security.getHeaders() });
+    if (!response.ok) {
+      throw new Error(`Bitbucket API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Fetches all projects accessible to the authenticated user.
+   *
+   * `GET /rest/api/latest/projects`
+   *
+   * @param params - Optional filters: `limit`, `start`, `name`, `permission`
+   * @returns An array of projects
+   */
+  async projects(params) {
+    const data = await this.request(
+      "/projects",
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Returns a {@link ProjectResource} for a given project key, providing access
+   * to project-level data and sub-resources.
+   *
+   * The returned resource can be awaited directly to fetch project info,
+   * or chained to access nested resources.
+   *
+   * @param projectKey - The project key (e.g., `'PROJ'`)
+   * @returns A chainable project resource
+   *
+   * @example
+   * ```typescript
+   * const project = await bbClient.project('PROJ');
+   * const repos   = await bbClient.project('PROJ').repos({ limit: 10 });
+   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests();
+   * ```
+   */
+  project(projectKey) {
+    const request = (path, params) => this.request(path, params);
+    return new ProjectResource(request, projectKey);
+  }
+};
+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

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/security/Security.ts","../src/resources/RepositoryResource.ts","../src/resources/ProjectResource.ts","../src/BitbucketClient.ts"],"sourcesContent":["export { BitbucketClient } from './BitbucketClient';\nexport type { BitbucketClientOptions } from './BitbucketClient';\nexport { Security } from './security/Security';\nexport { ProjectResource } from './resources/ProjectResource';\nexport { RepositoryResource } from './resources/RepositoryResource';\nexport type { BitbucketProject, ProjectsParams } from './domain/Project';\nexport type { BitbucketRepository, ReposParams } from './domain/Repository';\nexport type { BitbucketPullRequest, BitbucketParticipant, BitbucketRef, PullRequestsParams } from './domain/PullRequest';\nexport type { BitbucketCommit, BitbucketCommitAuthor, CommitsParams } from './domain/Commit';\nexport type { PaginationParams, PagedResponse } from './domain/Pagination';\n","/**\n * Encodes a string to Base64 in a way that works in both Node.js and browsers.\n * @internal\n */\nfunction toBase64(value: string): string {\n  if (typeof btoa !== 'undefined') {\n    return btoa(value);\n  }\n  return Buffer.from(value).toString('base64');\n}\n\n/**\n * Handles Basic Authentication for Bitbucket Data Center REST API requests.\n *\n * @example\n * ```typescript\n * const security = new Security(\n *   'https://bitbucket.example.com',\n *   'my-user',\n *   'my-token'\n * );\n *\n * const headers = security.getHeaders();\n * // { Authorization: 'Basic <base64>', 'Content-Type': 'application/json', Accept: 'application/json' }\n * ```\n */\nexport class Security {\n  private readonly apiUrl: string;\n  private readonly authorizationHeader: string;\n\n  /**\n   * Creates a new Security instance with Basic Authentication credentials.\n   *\n   * @param apiUrl - The base URL of the Bitbucket Data Center instance (e.g., `https://bitbucket.example.com`).\n   *   Must be a valid URL; throws if it cannot be parsed.\n   * @param user - The username to authenticate with\n   * @param token - The personal access token or password to authenticate with\n   *\n   * @throws {TypeError} If `apiUrl` is not a valid URL\n   */\n  constructor(apiUrl: string, user: string, token: string) {\n    if (!URL.canParse(apiUrl)) {\n      throw new TypeError(`Invalid apiUrl: \"${apiUrl}\" is not a valid URL`);\n    }\n    this.apiUrl = apiUrl.replace(/\\/$/, '');\n    this.authorizationHeader = `Basic ${toBase64(`${user}:${token}`)}`;\n  }\n\n  /**\n   * Returns the base URL of the Bitbucket Data Center instance, without a trailing slash.\n   *\n   * @returns The API base URL\n   */\n  getApiUrl(): string {\n    return this.apiUrl;\n  }\n\n  /**\n   * Returns the value of the `Authorization` header for Basic Authentication.\n   *\n   * @returns The Authorization header value in the format `Basic <base64-encoded-credentials>`\n   */\n  getAuthorizationHeader(): string {\n    return this.authorizationHeader;\n  }\n\n  /**\n   * Returns the full set of HTTP headers required for authenticated API requests.\n   *\n   * @returns An object containing `Authorization`, `Content-Type`, and `Accept` headers\n   */\n  getHeaders(): Record<string, string> {\n    return {\n      Authorization: this.authorizationHeader,\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n  }\n}\n","import type { BitbucketRepository } from '../domain/Repository';\nimport type { BitbucketPullRequest, PullRequestsParams } from '../domain/PullRequest';\nimport type { BitbucketCommit, CommitsParams } from '../domain/Commit';\nimport type { PagedResponse } from '../domain/Pagination';\nimport type { RequestFn } from './ProjectResource';\n\n/**\n * Represents a Bitbucket repository resource with chainable async methods.\n *\n * Implements `PromiseLike<BitbucketRepository>` so it can be awaited directly\n * to fetch repository info, while also exposing sub-resource methods.\n *\n * @example\n * ```typescript\n * // Await directly to get repository info\n * const repo = await bbClient.project('PROJ').repo('my-repo');\n *\n * // Get pull requests\n * const prs = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n *\n * // Get commits\n * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n * ```\n */\nexport class RepositoryResource implements PromiseLike<BitbucketRepository> {\n  private readonly basePath: string;\n\n  /** @internal */\n  constructor(\n    private readonly request: RequestFn,\n    projectKey: string,\n    repoSlug: string,\n  ) {\n    this.basePath = `/projects/${projectKey}/repos/${repoSlug}`;\n  }\n\n  /**\n   * Allows the resource to be awaited directly, resolving with the repository info.\n   * Delegates to {@link RepositoryResource.get}.\n   */\n  then<TResult1 = BitbucketRepository, TResult2 = never>(\n    onfulfilled?: ((value: BitbucketRepository) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.get().then(onfulfilled, onrejected);\n  }\n\n  /**\n   * Fetches the repository details.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}`\n   *\n   * @returns The repository object\n   */\n  async get(): Promise<BitbucketRepository> {\n    return this.request<BitbucketRepository>(this.basePath);\n  }\n\n  /**\n   * Fetches pull requests for this repository.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}/pull-requests`\n   *\n   * @param params - Optional filters: `limit`, `start`, `state`, `direction`, `at`, `order`\n   * @returns An array of pull requests\n   */\n  async pullRequests(params?: PullRequestsParams): Promise<BitbucketPullRequest[]> {\n    const data = await this.request<PagedResponse<BitbucketPullRequest>>(\n      `${this.basePath}/pull-requests`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Fetches commits for this repository.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}/commits`\n   *\n   * @param params - Optional filters: `limit`, `start`, `until`, `since`, `path`, `merges`, `followRenames`, `ignoreMissing`\n   * @returns An array of commits\n   */\n  async commits(params?: CommitsParams): Promise<BitbucketCommit[]> {\n    const data = await this.request<PagedResponse<BitbucketCommit>>(\n      `${this.basePath}/commits`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n}\n","import type { BitbucketProject } from '../domain/Project';\nimport type { BitbucketRepository, ReposParams } from '../domain/Repository';\nimport type { PagedResponse } from '../domain/Pagination';\nimport { RepositoryResource } from './RepositoryResource';\n\n/** @internal */\nexport type RequestFn = <T>(\n  path: string,\n  params?: Record<string, string | number | boolean>,\n) => Promise<T>;\n\n/**\n * Represents a Bitbucket project resource with chainable async methods.\n *\n * Implements `PromiseLike<BitbucketProject>` so it can be awaited directly\n * to fetch the project info, while also exposing sub-resource methods.\n *\n * @example\n * ```typescript\n * // Await directly to get project info\n * const project = await bbClient.project('PROJ');\n *\n * // Get repositories with filters\n * const repos = await bbClient.project('PROJ').repos({ limit: 50, name: 'api' });\n *\n * // Navigate into a specific repository\n * const prs = await bbClient.project('PROJ').repo('my-repo').pullRequests();\n * ```\n */\nexport class ProjectResource implements PromiseLike<BitbucketProject> {\n  /** @internal */\n  constructor(\n    private readonly request: RequestFn,\n    private readonly key: string,\n  ) {}\n\n  /**\n   * Allows the resource to be awaited directly, resolving with the project info.\n   * Delegates to {@link ProjectResource.get}.\n   */\n  then<TResult1 = BitbucketProject, TResult2 = never>(\n    onfulfilled?: ((value: BitbucketProject) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.get().then(onfulfilled, onrejected);\n  }\n\n  /**\n   * Fetches the project details.\n   *\n   * `GET /rest/api/latest/projects/{key}`\n   *\n   * @returns The project object\n   */\n  async get(): Promise<BitbucketProject> {\n    return this.request<BitbucketProject>(`/projects/${this.key}`);\n  }\n\n  /**\n   * Fetches repositories belonging to this project.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos`\n   *\n   * @param params - Optional filters: `limit`, `start`, `slug`, `name`, `permission`\n   * @returns An array of repositories\n   */\n  async repos(params?: ReposParams): Promise<BitbucketRepository[]> {\n    const data = await this.request<PagedResponse<BitbucketRepository>>(\n      `/projects/${this.key}/repos`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Returns a {@link RepositoryResource} for a given repository slug, providing\n   * access to repository-level data and sub-resources (pull requests, commits, etc.).\n   *\n   * The returned resource can be awaited directly to fetch repository info,\n   * or chained to access nested resources.\n   *\n   * @param repoSlug - The repository slug (e.g., `'my-repo'`)\n   * @returns A chainable repository resource\n   *\n   * @example\n   * ```typescript\n   * const repo    = await bbClient.project('PROJ').repo('my-repo');\n   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n   * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n   * ```\n   */\n  repo(repoSlug: string): RepositoryResource {\n    return new RepositoryResource(this.request, this.key, repoSlug);\n  }\n}\n","import { Security } from './security/Security';\nimport { ProjectResource, type RequestFn } from './resources/ProjectResource';\nimport type { BitbucketProject, ProjectsParams } from './domain/Project';\nimport type { PagedResponse } from './domain/Pagination';\n\n/**\n * Constructor options for {@link BitbucketClient}.\n */\nexport interface BitbucketClientOptions {\n  /** The base URL of the Bitbucket Data Center instance (e.g., `https://bitbucket.example.com`) */\n  apiUrl: string;\n  /** The username to authenticate with */\n  user: string;\n  /** The personal access token or password to authenticate with */\n  token: string;\n}\n\n/**\n * Main entry point for the Bitbucket Data Center REST API client.\n *\n * @example\n * ```typescript\n * const bbClient = new BitbucketClient({\n *   apiUrl: 'https://bitbucket.example.com',\n *   user: 'john.doe',\n *   token: 'my-token',\n * });\n *\n * const projects = await bbClient.projects({ limit: 50 });\n * const project  = await bbClient.project('PROJ');\n * const repos    = await bbClient.project('PROJ').repos({ name: 'api' });\n * const repo     = await bbClient.project('PROJ').repo('my-repo');\n * const prs      = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n * const commits  = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n * ```\n */\nexport class BitbucketClient {\n  private readonly security: Security;\n\n  /**\n   * @param options - Connection and authentication options\n   * @throws {TypeError} If `apiUrl` is not a valid URL\n   */\n  constructor({ apiUrl, user, token }: BitbucketClientOptions) {\n    this.security = new Security(apiUrl, user, token);\n  }\n\n  /**\n   * Performs an authenticated GET request to the Bitbucket REST API.\n   *\n   * @param path - API path relative to `/rest/api/latest` (e.g., `'/projects'`)\n   * @param params - Optional query parameters to append to the URL\n   * @throws {Error} If the HTTP response is not OK\n   * @internal\n   */\n  private async request<T>(\n    path: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<T> {\n    const base = `${this.security.getApiUrl()}/rest/api/latest${path}`;\n    const url = buildUrl(base, params);\n    const response = await fetch(url, { headers: this.security.getHeaders() });\n    if (!response.ok) {\n      throw new Error(`Bitbucket API error: ${response.status} ${response.statusText}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * Fetches all projects accessible to the authenticated user.\n   *\n   * `GET /rest/api/latest/projects`\n   *\n   * @param params - Optional filters: `limit`, `start`, `name`, `permission`\n   * @returns An array of projects\n   */\n  async projects(params?: ProjectsParams): Promise<BitbucketProject[]> {\n    const data = await this.request<PagedResponse<BitbucketProject>>(\n      '/projects',\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Returns a {@link ProjectResource} for a given project key, providing access\n   * to project-level data and sub-resources.\n   *\n   * The returned resource can be awaited directly to fetch project info,\n   * or chained to access nested resources.\n   *\n   * @param projectKey - The project key (e.g., `'PROJ'`)\n   * @returns A chainable project resource\n   *\n   * @example\n   * ```typescript\n   * const project = await bbClient.project('PROJ');\n   * const repos   = await bbClient.project('PROJ').repos({ limit: 10 });\n   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests();\n   * ```\n   */\n  project(projectKey: string): ProjectResource {\n    const request: RequestFn = <T>(\n      path: string,\n      params?: Record<string, string | number | boolean>,\n    ) => this.request<T>(path, params);\n    return new ProjectResource(request, projectKey);\n  }\n}\n\n/**\n * Appends query parameters to a URL string, skipping `undefined` values.\n * @internal\n */\nfunction buildUrl(base: string, params?: Record<string, string | number | boolean>): string {\n  if (!params) return base;\n  const entries = Object.entries(params).filter(([, v]) => v !== undefined);\n  if (entries.length === 0) return base;\n  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));\n  return `${base}?${search.toString()}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACIA,SAAS,SAAS,OAAuB;AACvC,MAAI,OAAO,SAAS,aAAa;AAC/B,WAAO,KAAK,KAAK;AAAA,EACnB;AACA,SAAO,OAAO,KAAK,KAAK,EAAE,SAAS,QAAQ;AAC7C;AAiBO,IAAM,WAAN,MAAe;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcpB,YAAY,QAAgB,MAAc,OAAe;AACvD,QAAI,CAAC,IAAI,SAAS,MAAM,GAAG;AACzB,YAAM,IAAI,UAAU,oBAAoB,MAAM,sBAAsB;AAAA,IACtE;AACA,SAAK,SAAS,OAAO,QAAQ,OAAO,EAAE;AACtC,SAAK,sBAAsB,SAAS,SAAS,GAAG,IAAI,IAAI,KAAK,EAAE,CAAC;AAAA,EAClE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,YAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,yBAAiC;AAC/B,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,aAAqC;AACnC,WAAO;AAAA,MACL,eAAe,KAAK;AAAA,MACpB,gBAAgB;AAAA,MAChB,QAAQ;AAAA,IACV;AAAA,EACF;AACF;;;ACtDO,IAAM,qBAAN,MAAqE;AAAA;AAAA,EAI1E,YACmB,SACjB,YACA,UACA;AAHiB;AAIjB,SAAK,WAAW,aAAa,UAAU,UAAU,QAAQ;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,KACE,aACA,YACkC;AAClC,WAAO,KAAK,IAAI,EAAE,KAAK,aAAa,UAAU;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MAAoC;AACxC,WAAO,KAAK,QAA6B,KAAK,QAAQ;AAAA,EACxD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,aAAa,QAA8D;AAC/E,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,QAAQ;AAAA,MAChB;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,QAAQ,QAAoD;AAChE,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,GAAG,KAAK,QAAQ;AAAA,MAChB;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AACF;;;AC5DO,IAAM,kBAAN,MAA+D;AAAA;AAAA,EAEpE,YACmB,SACA,KACjB;AAFiB;AACA;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMH,KACE,aACA,YACkC;AAClC,WAAO,KAAK,IAAI,EAAE,KAAK,aAAa,UAAU;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,MAAM,MAAiC;AACrC,WAAO,KAAK,QAA0B,aAAa,KAAK,GAAG,EAAE;AAAA,EAC/D;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,MAAM,QAAsD;AAChE,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB,aAAa,KAAK,GAAG;AAAA,MACrB;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,KAAK,UAAsC;AACzC,WAAO,IAAI,mBAAmB,KAAK,SAAS,KAAK,KAAK,QAAQ;AAAA,EAChE;AACF;;;AC1DO,IAAM,kBAAN,MAAsB;AAAA;AAAA;AAAA;AAAA;AAAA,EAO3B,YAAY,EAAE,QAAQ,MAAM,MAAM,GAA2B;AAC3D,SAAK,WAAW,IAAI,SAAS,QAAQ,MAAM,KAAK;AAAA,EAClD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAc,QACZ,MACA,QACY;AACZ,UAAM,OAAO,GAAG,KAAK,SAAS,UAAU,CAAC,mBAAmB,IAAI;AAChE,UAAM,MAAM,SAAS,MAAM,MAAM;AACjC,UAAM,WAAW,MAAM,MAAM,KAAK,EAAE,SAAS,KAAK,SAAS,WAAW,EAAE,CAAC;AACzE,QAAI,CAAC,SAAS,IAAI;AAChB,YAAM,IAAI,MAAM,wBAAwB,SAAS,MAAM,IAAI,SAAS,UAAU,EAAE;AAAA,IAClF;AACA,WAAO,SAAS,KAAK;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,SAAS,QAAsD;AACnE,UAAM,OAAO,MAAM,KAAK;AAAA,MACtB;AAAA,MACA;AAAA,IACF;AACA,WAAO,KAAK;AAAA,EACd;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAmBA,QAAQ,YAAqC;AAC3C,UAAM,UAAqB,CACzB,MACA,WACG,KAAK,QAAW,MAAM,MAAM;AACjC,WAAO,IAAI,gBAAgB,SAAS,UAAU;AAAA,EAChD;AACF;AAMA,SAAS,SAAS,MAAc,QAA4D;AAC1F,MAAI,CAAC,OAAQ,QAAO;AACpB,QAAM,UAAU,OAAO,QAAQ,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,CAAC,MAAM,MAAM,MAAS;AACxE,MAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,QAAM,SAAS,IAAI,gBAAgB,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;AAC1E,SAAO,GAAG,IAAI,IAAI,OAAO,SAAS,CAAC;AACrC;","names":[]}

package/dist/index.mjs

@@ -0,0 +1,249 @@
+// 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 Bitbucket Data Center instance (e.g., `https://bitbucket.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 Bitbucket 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/resources/RepositoryResource.ts
+var RepositoryResource = class {
+  /** @internal */
+  constructor(request, projectKey, repoSlug) {
+    this.request = request;
+    this.basePath = `/projects/${projectKey}/repos/${repoSlug}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the repository info.
+   * Delegates to {@link RepositoryResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the repository details.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}`
+   *
+   * @returns The repository object
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches pull requests for this repository.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}/pull-requests`
+   *
+   * @param params - Optional filters: `limit`, `start`, `state`, `direction`, `at`, `order`
+   * @returns An array of pull requests
+   */
+  async pullRequests(params) {
+    const data = await this.request(
+      `${this.basePath}/pull-requests`,
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Fetches commits for this repository.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos/{slug}/commits`
+   *
+   * @param params - Optional filters: `limit`, `start`, `until`, `since`, `path`, `merges`, `followRenames`, `ignoreMissing`
+   * @returns An array of commits
+   */
+  async commits(params) {
+    const data = await this.request(
+      `${this.basePath}/commits`,
+      params
+    );
+    return data.values;
+  }
+};
+
+// src/resources/ProjectResource.ts
+var ProjectResource = class {
+  /** @internal */
+  constructor(request, key) {
+    this.request = request;
+    this.key = key;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the project info.
+   * Delegates to {@link ProjectResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the project details.
+   *
+   * `GET /rest/api/latest/projects/{key}`
+   *
+   * @returns The project object
+   */
+  async get() {
+    return this.request(`/projects/${this.key}`);
+  }
+  /**
+   * Fetches repositories belonging to this project.
+   *
+   * `GET /rest/api/latest/projects/{key}/repos`
+   *
+   * @param params - Optional filters: `limit`, `start`, `slug`, `name`, `permission`
+   * @returns An array of repositories
+   */
+  async repos(params) {
+    const data = await this.request(
+      `/projects/${this.key}/repos`,
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Returns a {@link RepositoryResource} for a given repository slug, providing
+   * access to repository-level data and sub-resources (pull requests, commits, etc.).
+   *
+   * The returned resource can be awaited directly to fetch repository info,
+   * or chained to access nested resources.
+   *
+   * @param repoSlug - The repository slug (e.g., `'my-repo'`)
+   * @returns A chainable repository resource
+   *
+   * @example
+   * ```typescript
+   * const repo    = await bbClient.project('PROJ').repo('my-repo');
+   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });
+   * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });
+   * ```
+   */
+  repo(repoSlug) {
+    return new RepositoryResource(this.request, this.key, repoSlug);
+  }
+};
+
+// src/BitbucketClient.ts
+var BitbucketClient = class {
+  /**
+   * @param options - Connection and authentication options
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor({ apiUrl, user, token }) {
+    this.security = new Security(apiUrl, user, token);
+  }
+  /**
+   * Performs an authenticated GET request to the Bitbucket REST API.
+   *
+   * @param path - API path relative to `/rest/api/latest` (e.g., `'/projects'`)
+   * @param params - Optional query parameters to append to the URL
+   * @throws {Error} If the HTTP response is not OK
+   * @internal
+   */
+  async request(path, params) {
+    const base = `${this.security.getApiUrl()}/rest/api/latest${path}`;
+    const url = buildUrl(base, params);
+    const response = await fetch(url, { headers: this.security.getHeaders() });
+    if (!response.ok) {
+      throw new Error(`Bitbucket API error: ${response.status} ${response.statusText}`);
+    }
+    return response.json();
+  }
+  /**
+   * Fetches all projects accessible to the authenticated user.
+   *
+   * `GET /rest/api/latest/projects`
+   *
+   * @param params - Optional filters: `limit`, `start`, `name`, `permission`
+   * @returns An array of projects
+   */
+  async projects(params) {
+    const data = await this.request(
+      "/projects",
+      params
+    );
+    return data.values;
+  }
+  /**
+   * Returns a {@link ProjectResource} for a given project key, providing access
+   * to project-level data and sub-resources.
+   *
+   * The returned resource can be awaited directly to fetch project info,
+   * or chained to access nested resources.
+   *
+   * @param projectKey - The project key (e.g., `'PROJ'`)
+   * @returns A chainable project resource
+   *
+   * @example
+   * ```typescript
+   * const project = await bbClient.project('PROJ');
+   * const repos   = await bbClient.project('PROJ').repos({ limit: 10 });
+   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests();
+   * ```
+   */
+  project(projectKey) {
+    const request = (path, params) => this.request(path, params);
+    return new ProjectResource(request, projectKey);
+  }
+};
+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()}`;
+}
+export {
+  BitbucketClient,
+  ProjectResource,
+  RepositoryResource,
+  Security
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/security/Security.ts","../src/resources/RepositoryResource.ts","../src/resources/ProjectResource.ts","../src/BitbucketClient.ts"],"sourcesContent":["/**\n * Encodes a string to Base64 in a way that works in both Node.js and browsers.\n * @internal\n */\nfunction toBase64(value: string): string {\n  if (typeof btoa !== 'undefined') {\n    return btoa(value);\n  }\n  return Buffer.from(value).toString('base64');\n}\n\n/**\n * Handles Basic Authentication for Bitbucket Data Center REST API requests.\n *\n * @example\n * ```typescript\n * const security = new Security(\n *   'https://bitbucket.example.com',\n *   'my-user',\n *   'my-token'\n * );\n *\n * const headers = security.getHeaders();\n * // { Authorization: 'Basic <base64>', 'Content-Type': 'application/json', Accept: 'application/json' }\n * ```\n */\nexport class Security {\n  private readonly apiUrl: string;\n  private readonly authorizationHeader: string;\n\n  /**\n   * Creates a new Security instance with Basic Authentication credentials.\n   *\n   * @param apiUrl - The base URL of the Bitbucket Data Center instance (e.g., `https://bitbucket.example.com`).\n   *   Must be a valid URL; throws if it cannot be parsed.\n   * @param user - The username to authenticate with\n   * @param token - The personal access token or password to authenticate with\n   *\n   * @throws {TypeError} If `apiUrl` is not a valid URL\n   */\n  constructor(apiUrl: string, user: string, token: string) {\n    if (!URL.canParse(apiUrl)) {\n      throw new TypeError(`Invalid apiUrl: \"${apiUrl}\" is not a valid URL`);\n    }\n    this.apiUrl = apiUrl.replace(/\\/$/, '');\n    this.authorizationHeader = `Basic ${toBase64(`${user}:${token}`)}`;\n  }\n\n  /**\n   * Returns the base URL of the Bitbucket Data Center instance, without a trailing slash.\n   *\n   * @returns The API base URL\n   */\n  getApiUrl(): string {\n    return this.apiUrl;\n  }\n\n  /**\n   * Returns the value of the `Authorization` header for Basic Authentication.\n   *\n   * @returns The Authorization header value in the format `Basic <base64-encoded-credentials>`\n   */\n  getAuthorizationHeader(): string {\n    return this.authorizationHeader;\n  }\n\n  /**\n   * Returns the full set of HTTP headers required for authenticated API requests.\n   *\n   * @returns An object containing `Authorization`, `Content-Type`, and `Accept` headers\n   */\n  getHeaders(): Record<string, string> {\n    return {\n      Authorization: this.authorizationHeader,\n      'Content-Type': 'application/json',\n      Accept: 'application/json',\n    };\n  }\n}\n","import type { BitbucketRepository } from '../domain/Repository';\nimport type { BitbucketPullRequest, PullRequestsParams } from '../domain/PullRequest';\nimport type { BitbucketCommit, CommitsParams } from '../domain/Commit';\nimport type { PagedResponse } from '../domain/Pagination';\nimport type { RequestFn } from './ProjectResource';\n\n/**\n * Represents a Bitbucket repository resource with chainable async methods.\n *\n * Implements `PromiseLike<BitbucketRepository>` so it can be awaited directly\n * to fetch repository info, while also exposing sub-resource methods.\n *\n * @example\n * ```typescript\n * // Await directly to get repository info\n * const repo = await bbClient.project('PROJ').repo('my-repo');\n *\n * // Get pull requests\n * const prs = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n *\n * // Get commits\n * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n * ```\n */\nexport class RepositoryResource implements PromiseLike<BitbucketRepository> {\n  private readonly basePath: string;\n\n  /** @internal */\n  constructor(\n    private readonly request: RequestFn,\n    projectKey: string,\n    repoSlug: string,\n  ) {\n    this.basePath = `/projects/${projectKey}/repos/${repoSlug}`;\n  }\n\n  /**\n   * Allows the resource to be awaited directly, resolving with the repository info.\n   * Delegates to {@link RepositoryResource.get}.\n   */\n  then<TResult1 = BitbucketRepository, TResult2 = never>(\n    onfulfilled?: ((value: BitbucketRepository) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.get().then(onfulfilled, onrejected);\n  }\n\n  /**\n   * Fetches the repository details.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}`\n   *\n   * @returns The repository object\n   */\n  async get(): Promise<BitbucketRepository> {\n    return this.request<BitbucketRepository>(this.basePath);\n  }\n\n  /**\n   * Fetches pull requests for this repository.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}/pull-requests`\n   *\n   * @param params - Optional filters: `limit`, `start`, `state`, `direction`, `at`, `order`\n   * @returns An array of pull requests\n   */\n  async pullRequests(params?: PullRequestsParams): Promise<BitbucketPullRequest[]> {\n    const data = await this.request<PagedResponse<BitbucketPullRequest>>(\n      `${this.basePath}/pull-requests`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Fetches commits for this repository.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos/{slug}/commits`\n   *\n   * @param params - Optional filters: `limit`, `start`, `until`, `since`, `path`, `merges`, `followRenames`, `ignoreMissing`\n   * @returns An array of commits\n   */\n  async commits(params?: CommitsParams): Promise<BitbucketCommit[]> {\n    const data = await this.request<PagedResponse<BitbucketCommit>>(\n      `${this.basePath}/commits`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n}\n","import type { BitbucketProject } from '../domain/Project';\nimport type { BitbucketRepository, ReposParams } from '../domain/Repository';\nimport type { PagedResponse } from '../domain/Pagination';\nimport { RepositoryResource } from './RepositoryResource';\n\n/** @internal */\nexport type RequestFn = <T>(\n  path: string,\n  params?: Record<string, string | number | boolean>,\n) => Promise<T>;\n\n/**\n * Represents a Bitbucket project resource with chainable async methods.\n *\n * Implements `PromiseLike<BitbucketProject>` so it can be awaited directly\n * to fetch the project info, while also exposing sub-resource methods.\n *\n * @example\n * ```typescript\n * // Await directly to get project info\n * const project = await bbClient.project('PROJ');\n *\n * // Get repositories with filters\n * const repos = await bbClient.project('PROJ').repos({ limit: 50, name: 'api' });\n *\n * // Navigate into a specific repository\n * const prs = await bbClient.project('PROJ').repo('my-repo').pullRequests();\n * ```\n */\nexport class ProjectResource implements PromiseLike<BitbucketProject> {\n  /** @internal */\n  constructor(\n    private readonly request: RequestFn,\n    private readonly key: string,\n  ) {}\n\n  /**\n   * Allows the resource to be awaited directly, resolving with the project info.\n   * Delegates to {@link ProjectResource.get}.\n   */\n  then<TResult1 = BitbucketProject, TResult2 = never>(\n    onfulfilled?: ((value: BitbucketProject) => TResult1 | PromiseLike<TResult1>) | null,\n    onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null,\n  ): PromiseLike<TResult1 | TResult2> {\n    return this.get().then(onfulfilled, onrejected);\n  }\n\n  /**\n   * Fetches the project details.\n   *\n   * `GET /rest/api/latest/projects/{key}`\n   *\n   * @returns The project object\n   */\n  async get(): Promise<BitbucketProject> {\n    return this.request<BitbucketProject>(`/projects/${this.key}`);\n  }\n\n  /**\n   * Fetches repositories belonging to this project.\n   *\n   * `GET /rest/api/latest/projects/{key}/repos`\n   *\n   * @param params - Optional filters: `limit`, `start`, `slug`, `name`, `permission`\n   * @returns An array of repositories\n   */\n  async repos(params?: ReposParams): Promise<BitbucketRepository[]> {\n    const data = await this.request<PagedResponse<BitbucketRepository>>(\n      `/projects/${this.key}/repos`,\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Returns a {@link RepositoryResource} for a given repository slug, providing\n   * access to repository-level data and sub-resources (pull requests, commits, etc.).\n   *\n   * The returned resource can be awaited directly to fetch repository info,\n   * or chained to access nested resources.\n   *\n   * @param repoSlug - The repository slug (e.g., `'my-repo'`)\n   * @returns A chainable repository resource\n   *\n   * @example\n   * ```typescript\n   * const repo    = await bbClient.project('PROJ').repo('my-repo');\n   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n   * const commits = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n   * ```\n   */\n  repo(repoSlug: string): RepositoryResource {\n    return new RepositoryResource(this.request, this.key, repoSlug);\n  }\n}\n","import { Security } from './security/Security';\nimport { ProjectResource, type RequestFn } from './resources/ProjectResource';\nimport type { BitbucketProject, ProjectsParams } from './domain/Project';\nimport type { PagedResponse } from './domain/Pagination';\n\n/**\n * Constructor options for {@link BitbucketClient}.\n */\nexport interface BitbucketClientOptions {\n  /** The base URL of the Bitbucket Data Center instance (e.g., `https://bitbucket.example.com`) */\n  apiUrl: string;\n  /** The username to authenticate with */\n  user: string;\n  /** The personal access token or password to authenticate with */\n  token: string;\n}\n\n/**\n * Main entry point for the Bitbucket Data Center REST API client.\n *\n * @example\n * ```typescript\n * const bbClient = new BitbucketClient({\n *   apiUrl: 'https://bitbucket.example.com',\n *   user: 'john.doe',\n *   token: 'my-token',\n * });\n *\n * const projects = await bbClient.projects({ limit: 50 });\n * const project  = await bbClient.project('PROJ');\n * const repos    = await bbClient.project('PROJ').repos({ name: 'api' });\n * const repo     = await bbClient.project('PROJ').repo('my-repo');\n * const prs      = await bbClient.project('PROJ').repo('my-repo').pullRequests({ state: 'OPEN' });\n * const commits  = await bbClient.project('PROJ').repo('my-repo').commits({ limit: 10 });\n * ```\n */\nexport class BitbucketClient {\n  private readonly security: Security;\n\n  /**\n   * @param options - Connection and authentication options\n   * @throws {TypeError} If `apiUrl` is not a valid URL\n   */\n  constructor({ apiUrl, user, token }: BitbucketClientOptions) {\n    this.security = new Security(apiUrl, user, token);\n  }\n\n  /**\n   * Performs an authenticated GET request to the Bitbucket REST API.\n   *\n   * @param path - API path relative to `/rest/api/latest` (e.g., `'/projects'`)\n   * @param params - Optional query parameters to append to the URL\n   * @throws {Error} If the HTTP response is not OK\n   * @internal\n   */\n  private async request<T>(\n    path: string,\n    params?: Record<string, string | number | boolean>,\n  ): Promise<T> {\n    const base = `${this.security.getApiUrl()}/rest/api/latest${path}`;\n    const url = buildUrl(base, params);\n    const response = await fetch(url, { headers: this.security.getHeaders() });\n    if (!response.ok) {\n      throw new Error(`Bitbucket API error: ${response.status} ${response.statusText}`);\n    }\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * Fetches all projects accessible to the authenticated user.\n   *\n   * `GET /rest/api/latest/projects`\n   *\n   * @param params - Optional filters: `limit`, `start`, `name`, `permission`\n   * @returns An array of projects\n   */\n  async projects(params?: ProjectsParams): Promise<BitbucketProject[]> {\n    const data = await this.request<PagedResponse<BitbucketProject>>(\n      '/projects',\n      params as Record<string, string | number | boolean>,\n    );\n    return data.values;\n  }\n\n  /**\n   * Returns a {@link ProjectResource} for a given project key, providing access\n   * to project-level data and sub-resources.\n   *\n   * The returned resource can be awaited directly to fetch project info,\n   * or chained to access nested resources.\n   *\n   * @param projectKey - The project key (e.g., `'PROJ'`)\n   * @returns A chainable project resource\n   *\n   * @example\n   * ```typescript\n   * const project = await bbClient.project('PROJ');\n   * const repos   = await bbClient.project('PROJ').repos({ limit: 10 });\n   * const prs     = await bbClient.project('PROJ').repo('my-repo').pullRequests();\n   * ```\n   */\n  project(projectKey: string): ProjectResource {\n    const request: RequestFn = <T>(\n      path: string,\n      params?: Record<string, string | number | boolean>,\n    ) => this.request<T>(path, params);\n    return new ProjectResource(request, projectKey);\n  }\n}\n\n/**\n * Appends query parameters to a URL string, skipping `undefined` values.\n * @internal\n */\nfunction buildUrl(base: string, params?: Record<string, string | number | boolean>): string {\n  if (!params) return base;\n  const entries = Object.entries(params).filter(([, v]) => v !== undefined);\n  if (entries.length === 0) return base;\n  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));\n  return `${base}?${search.toString()}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "bitbucket-datacenter-api-client",
+  "version": "0.1.0",
+  "description": "TypeScript client for Bitbucket Data Center REST API",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "docs": "typedoc",
+    "test": "jest",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "bitbucket",
+    "bitbucket-server",
+    "bitbucket-data-center",
+    "api-client",
+    "rest"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pilmee/BitbucketDataCenterApiClient.git"
+  },
+  "devDependencies": {
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.14",
+    "jest": "^29.7.0",
+    "semantic-release": "^24.2.3",
+    "ts-jest": "^29.3.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.4.0",
+    "typedoc": "^0.27.9",
+    "typescript": "^5.8.3"
+  }
+}