gh-api-client 1.0.0

package/dist/index.mjs

@@ -0,0 +1,948 @@
+// src/security/Security.ts
+var Security = class {
+  /**
+   * Creates a new Security instance with a GitHub personal access token.
+   *
+   * @param token - A GitHub personal access token (e.g., `ghp_...`) or OAuth token
+   * @param apiUrl - The base URL of the GitHub API. Defaults to `'https://api.github.com'`.
+   *   Must be a valid URL; throws if it cannot be parsed.
+   *
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor(token, apiUrl = "https://api.github.com") {
+    if (!URL.canParse(apiUrl)) {
+      throw new TypeError(`Invalid apiUrl: "${apiUrl}" is not a valid URL`);
+    }
+    this.apiUrl = apiUrl.replace(/\/$/, "");
+    this.token = token;
+  }
+  /**
+   * Returns the base URL of the GitHub API, without a trailing slash.
+   *
+   * @returns The API base URL
+   */
+  getApiUrl() {
+    return this.apiUrl;
+  }
+  /**
+   * Returns the value of the `Authorization` header for Bearer authentication.
+   *
+   * @returns The Authorization header value in the format `Bearer <token>`
+   */
+  getAuthorizationHeader() {
+    return `Bearer ${this.token}`;
+  }
+  /**
+   * Returns the full set of HTTP headers required for authenticated GitHub API requests.
+   *
+   * @returns An object containing `Authorization`, `Accept`, `Content-Type`, and `X-GitHub-Api-Version` headers
+   */
+  getHeaders() {
+    return {
+      Authorization: `Bearer ${this.token}`,
+      Accept: "application/vnd.github+json",
+      "Content-Type": "application/json",
+      "X-GitHub-Api-Version": "2022-11-28"
+    };
+  }
+  /**
+   * Returns headers for raw file content requests.
+   *
+   * @returns Headers with `Accept: application/vnd.github.raw+json`
+   */
+  getRawHeaders() {
+    return {
+      ...this.getHeaders(),
+      Accept: "application/vnd.github.raw+json"
+    };
+  }
+};
+
+// src/errors/GitHubApiError.ts
+var GitHubApiError = class extends Error {
+  constructor(status, statusText) {
+    super(`GitHub API error: ${status} ${statusText}`);
+    this.name = "GitHubApiError";
+    this.status = status;
+    this.statusText = statusText;
+  }
+};
+
+// src/resources/PullRequestResource.ts
+var PullRequestResource = class {
+  /** @internal */
+  constructor(request, requestList, owner, repo, pullNumber) {
+    this.request = request;
+    this.requestList = requestList;
+    this.basePath = `/repos/${owner}/${repo}/pulls/${pullNumber}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the pull request info.
+   * Delegates to {@link PullRequestResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the pull request details.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}`
+   *
+   * @returns The pull request object
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches the commits included in this pull request.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}/commits`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of commits
+   */
+  async commits(params) {
+    return this.requestList(
+      `${this.basePath}/commits`,
+      params
+    );
+  }
+  /**
+   * Fetches the files changed by this pull request.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}/files`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of changed files
+   */
+  async files(params) {
+    return this.requestList(
+      `${this.basePath}/files`,
+      params
+    );
+  }
+  /**
+   * Fetches the reviews submitted on this pull request.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}/reviews`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of reviews
+   */
+  async reviews(params) {
+    return this.requestList(
+      `${this.basePath}/reviews`,
+      params
+    );
+  }
+  /**
+   * Fetches the inline review comments on this pull request's diff.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}/comments`
+   *
+   * @param params - Optional filters: `sort`, `direction`, `since`, `per_page`, `page`
+   * @returns A paged response of review comments
+   */
+  async reviewComments(params) {
+    return this.requestList(
+      `${this.basePath}/comments`,
+      params
+    );
+  }
+  /**
+   * Checks whether the pull request has been merged.
+   *
+   * `GET /repos/{owner}/{repo}/pulls/{pull_number}/merge`
+   *
+   * @returns `true` if merged (HTTP 204), `false` if not merged (HTTP 404)
+   */
+  async isMerged() {
+    try {
+      await this.request(`${this.basePath}/merge`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+};
+
+// src/resources/CommitResource.ts
+var CommitResource = class {
+  /** @internal */
+  constructor(request, requestList, owner, repo, ref) {
+    this.request = request;
+    this.requestList = requestList;
+    this.basePath = `/repos/${owner}/${repo}/commits/${ref}`;
+    this.ref = ref;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the commit info.
+   * Delegates to {@link CommitResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the commit details, including stats and changed files.
+   *
+   * `GET /repos/{owner}/{repo}/commits/{ref}`
+   *
+   * @returns The commit object with stats and files
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches the individual commit statuses (from CI/CD systems via the Statuses API).
+   *
+   * `GET /repos/{owner}/{repo}/statuses/{sha}`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of commit statuses
+   */
+  async statuses(params) {
+    const repoPath = this.basePath.replace(`/commits/${this.ref}`, "");
+    return this.requestList(
+      `${repoPath}/statuses/${this.ref}`,
+      params
+    );
+  }
+  /**
+   * Fetches the combined commit status — an aggregation of all statuses for this ref.
+   *
+   * `GET /repos/{owner}/{repo}/commits/{ref}/status`
+   *
+   * @returns The combined status object
+   */
+  async combinedStatus() {
+    return this.request(`${this.basePath}/status`);
+  }
+  /**
+   * Fetches GitHub Actions check runs for this commit.
+   *
+   * `GET /repos/{owner}/{repo}/commits/{ref}/check-runs`
+   *
+   * @param params - Optional filters: `check_name`, `status`, `app_id`, `per_page`, `page`
+   * @returns A paged response of check runs
+   */
+  async checkRuns(params) {
+    const raw = await this.request(
+      `${this.basePath}/check-runs`,
+      params
+    );
+    return {
+      values: raw.check_runs,
+      hasNextPage: false
+    };
+  }
+};
+
+// src/resources/RepositoryResource.ts
+var RepositoryResource = class {
+  /** @internal */
+  constructor(request, requestList, requestText, owner, repo) {
+    this.request = request;
+    this.requestList = requestList;
+    this.requestText = requestText;
+    this.owner = owner;
+    this.repo = repo;
+    this.basePath = `/repos/${owner}/${repo}`;
+  }
+  /**
+   * 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 /repos/{owner}/{repo}`
+   *
+   * @returns The repository object
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches pull requests for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/pulls`
+   *
+   * @param params - Optional filters: `state`, `head`, `base`, `sort`, `direction`, `per_page`, `page`
+   * @returns A paged response of pull requests
+   */
+  async pullRequests(params) {
+    return this.requestList(
+      `${this.basePath}/pulls`,
+      params
+    );
+  }
+  /**
+   * Returns a {@link PullRequestResource} for a given pull request number.
+   *
+   * The returned resource can be awaited directly to fetch pull request info,
+   * or chained to access nested resources.
+   *
+   * @param pullNumber - The pull request number (not the ID)
+   * @returns A chainable pull request resource
+   *
+   * @example
+   * ```typescript
+   * const pr      = await gh.org('github').repo('linguist').pullRequest(42);
+   * const files   = await gh.org('github').repo('linguist').pullRequest(42).files();
+   * const reviews = await gh.org('github').repo('linguist').pullRequest(42).reviews();
+   * ```
+   */
+  pullRequest(pullNumber) {
+    return new PullRequestResource(
+      this.request,
+      this.requestList,
+      this.owner,
+      this.repo,
+      pullNumber
+    );
+  }
+  /**
+   * Fetches commits for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/commits`
+   *
+   * @param params - Optional filters: `sha`, `path`, `author`, `since`, `until`, `per_page`, `page`
+   * @returns A paged response of commits
+   */
+  async commits(params) {
+    return this.requestList(
+      `${this.basePath}/commits`,
+      params
+    );
+  }
+  /**
+   * Returns a {@link CommitResource} for a given commit ref (SHA, branch, or tag).
+   *
+   * The returned resource can be awaited directly to fetch commit info,
+   * or chained to access nested resources.
+   *
+   * @param ref - Commit SHA, branch name, or tag name
+   * @returns A chainable commit resource
+   *
+   * @example
+   * ```typescript
+   * const commit   = await gh.org('github').repo('linguist').commit('abc123');
+   * const statuses = await gh.org('github').repo('linguist').commit('abc123').statuses();
+   * ```
+   */
+  commit(ref) {
+    return new CommitResource(
+      this.request,
+      this.requestList,
+      this.owner,
+      this.repo,
+      ref
+    );
+  }
+  /**
+   * Fetches branches for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/branches`
+   *
+   * @param params - Optional filters: `protected`, `per_page`, `page`
+   * @returns A paged response of branches
+   */
+  async branches(params) {
+    return this.requestList(
+      `${this.basePath}/branches`,
+      params
+    );
+  }
+  /**
+   * Fetches a specific branch by name.
+   *
+   * `GET /repos/{owner}/{repo}/branches/{branch}`
+   *
+   * @param name - The branch name (e.g., `'main'`)
+   * @returns The branch object
+   */
+  async branch(name) {
+    return this.request(`${this.basePath}/branches/${encodeURIComponent(name)}`);
+  }
+  /**
+   * Fetches tags for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/tags`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of tags
+   */
+  async tags(params) {
+    return this.requestList(
+      `${this.basePath}/tags`,
+      params
+    );
+  }
+  /**
+   * Fetches releases for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/releases`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of releases
+   */
+  async releases(params) {
+    return this.requestList(
+      `${this.basePath}/releases`,
+      params
+    );
+  }
+  /**
+   * Fetches the latest published release for this repository.
+   *
+   * `GET /repos/{owner}/{repo}/releases/latest`
+   *
+   * @returns The latest release object
+   */
+  async latestRelease() {
+    return this.request(`${this.basePath}/releases/latest`);
+  }
+  /**
+   * Fetches the forks of this repository.
+   *
+   * `GET /repos/{owner}/{repo}/forks`
+   *
+   * @param params - Optional filters: `sort`, `per_page`, `page`
+   * @returns A paged response of forked repositories
+   */
+  async forks(params) {
+    return this.requestList(
+      `${this.basePath}/forks`,
+      params
+    );
+  }
+  /**
+   * Fetches webhooks configured on this repository.
+   *
+   * `GET /repos/{owner}/{repo}/hooks`
+   *
+   * @param params - Optional pagination: `per_page`, `page`
+   * @returns A paged response of webhooks
+   */
+  async webhooks(params) {
+    return this.requestList(
+      `${this.basePath}/hooks`,
+      params
+    );
+  }
+  /**
+   * Fetches the contents of a file or directory in this repository.
+   *
+   * `GET /repos/{owner}/{repo}/contents/{path}`
+   *
+   * Returns a single {@link GitHubContent} for files, or an array for directories.
+   *
+   * @param path - Path to the file or directory (e.g., `'src/index.ts'` or `'src'`). Omit for root.
+   * @param params - Optional: `ref` (branch, tag, or commit SHA)
+   * @returns File content object or array of directory entries
+   */
+  async contents(path, params) {
+    const contentPath = path ? `${this.basePath}/contents/${path}` : `${this.basePath}/contents`;
+    return this.request(
+      contentPath,
+      params
+    );
+  }
+  /**
+   * Fetches the raw text content of a file in this repository.
+   *
+   * Uses `Accept: application/vnd.github.raw+json` to retrieve the file directly
+   * without base64 encoding.
+   *
+   * `GET /repos/{owner}/{repo}/contents/{filePath}`
+   *
+   * @param filePath - Path to the file (e.g., `'src/index.ts'`)
+   * @param params - Optional: `ref` (branch, tag, or commit SHA)
+   * @returns The raw file content as a string
+   */
+  async raw(filePath, params) {
+    return this.requestText(
+      `${this.basePath}/contents/${filePath}`,
+      params
+    );
+  }
+  /**
+   * Fetches the repository topics.
+   *
+   * `GET /repos/{owner}/{repo}/topics`
+   *
+   * @returns An array of topic strings
+   */
+  async topics() {
+    const data = await this.request(`${this.basePath}/topics`);
+    return data.names;
+  }
+  /**
+   * Fetches contributors to this repository.
+   *
+   * `GET /repos/{owner}/{repo}/contributors`
+   *
+   * @param params - Optional filters: `anon` (include anonymous contributors), `per_page`, `page`
+   * @returns A paged response of contributors
+   */
+  async contributors(params) {
+    return this.requestList(
+      `${this.basePath}/contributors`,
+      params
+    );
+  }
+};
+
+// src/resources/OrganizationResource.ts
+var OrganizationResource = class {
+  /** @internal */
+  constructor(request, requestList, requestText, org) {
+    this.request = request;
+    this.requestList = requestList;
+    this.requestText = requestText;
+    this.org = org;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the organization info.
+   * Delegates to {@link OrganizationResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the organization details.
+   *
+   * `GET /orgs/{org}`
+   *
+   * @returns The organization object
+   */
+  async get() {
+    return this.request(`/orgs/${this.org}`);
+  }
+  /**
+   * Fetches repositories belonging to this organization.
+   *
+   * `GET /orgs/{org}/repos`
+   *
+   * @param params - Optional filters: `type`, `sort`, `direction`, `per_page`, `page`
+   * @returns A paged response of repositories
+   */
+  async repos(params) {
+    return this.requestList(
+      `/orgs/${this.org}/repos`,
+      params
+    );
+  }
+  /**
+   * Returns a {@link RepositoryResource} for a given repository name within this organization.
+   *
+   * The returned resource can be awaited directly to fetch repository info,
+   * or chained to access nested resources.
+   *
+   * @param name - The repository name (e.g., `'linguist'`)
+   * @returns A chainable repository resource
+   *
+   * @example
+   * ```typescript
+   * const repo    = await gh.org('github').repo('linguist');
+   * const prs     = await gh.org('github').repo('linguist').pullRequests({ state: 'open' });
+   * const commits = await gh.org('github').repo('linguist').commits({ per_page: 10 });
+   * ```
+   */
+  repo(name) {
+    return new RepositoryResource(
+      this.request,
+      this.requestList,
+      this.requestText,
+      this.org,
+      name
+    );
+  }
+  /**
+   * Fetches members of this organization.
+   *
+   * `GET /orgs/{org}/members`
+   *
+   * @param params - Optional filters: `role`, `filter`, `per_page`, `page`
+   * @returns A paged response of users
+   */
+  async members(params) {
+    return this.requestList(
+      `/orgs/${this.org}/members`,
+      params
+    );
+  }
+};
+
+// src/resources/UserResource.ts
+var UserResource = class {
+  /** @internal */
+  constructor(request, requestList, requestText, login) {
+    this.request = request;
+    this.requestList = requestList;
+    this.requestText = requestText;
+    this.login = login;
+    this.basePath = `/users/${login}`;
+  }
+  /**
+   * Allows the resource to be awaited directly, resolving with the user info.
+   * Delegates to {@link UserResource.get}.
+   */
+  then(onfulfilled, onrejected) {
+    return this.get().then(onfulfilled, onrejected);
+  }
+  /**
+   * Fetches the user details.
+   *
+   * `GET /users/{username}`
+   *
+   * @returns The user object
+   */
+  async get() {
+    return this.request(this.basePath);
+  }
+  /**
+   * Fetches public repositories for this user.
+   *
+   * `GET /users/{username}/repos`
+   *
+   * @param params - Optional filters: `type`, `sort`, `direction`, `per_page`, `page`
+   * @returns A paged response of repositories
+   */
+  async repos(params) {
+    return this.requestList(
+      `${this.basePath}/repos`,
+      params
+    );
+  }
+  /**
+   * Returns a {@link RepositoryResource} for a given repository under this user,
+   * providing access to all repository sub-resources.
+   *
+   * @param name - The repository name
+   * @returns A chainable repository resource
+   *
+   * @example
+   * ```typescript
+   * const repo    = await gh.user('octocat').repo('Hello-World');
+   * const content = await gh.user('octocat').repo('Hello-World').raw('README.md');
+   * ```
+   */
+  repo(name) {
+    return new RepositoryResource(
+      this.request,
+      this.requestList,
+      this.requestText,
+      this.login,
+      name
+    );
+  }
+  /**
+   * Fetches the users this user is following.
+   *
+   * `GET /users/{username}/following`
+   *
+   * @returns A paged response of users
+   */
+  async following(params) {
+    return this.requestList(
+      `${this.basePath}/following`,
+      params
+    );
+  }
+  /**
+   * Fetches the users following this user.
+   *
+   * `GET /users/{username}/followers`
+   *
+   * @returns A paged response of users
+   */
+  async followers(params) {
+    return this.requestList(
+      `${this.basePath}/followers`,
+      params
+    );
+  }
+};
+
+// src/GitHubClient.ts
+var GitHubClient = class {
+  /**
+   * @param options - Authentication and connection options
+   * @throws {TypeError} If `apiUrl` is not a valid URL
+   */
+  constructor({ token, apiUrl }) {
+    this.listeners = /* @__PURE__ */ new Map();
+    this.security = new Security(token, apiUrl);
+  }
+  /**
+   * Subscribes to a client event.
+   *
+   * @example
+   * ```typescript
+   * gh.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 returning a single JSON object.
+   * @internal
+   */
+  async request(path, params, options) {
+    const base = `${this.security.getApiUrl()}${path}`;
+    const url = buildUrl(base, params);
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const headers = options?.headers ?? this.security.getHeaders();
+      const response = await fetch(url, { headers });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new GitHubApiError(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;
+    }
+  }
+  /**
+   * Performs an authenticated GET request returning a paginated list.
+   * Parses the `Link` response header to determine if more pages exist.
+   * @internal
+   */
+  async requestList(path, params) {
+    const base = `${this.security.getApiUrl()}${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 GitHubApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      const linkHeader = response.headers.get("Link");
+      const nextPage = parseNextPage(linkHeader);
+      this.emit("request", { url, method: "GET", startedAt, finishedAt: /* @__PURE__ */ new Date(), durationMs: Date.now() - startedAt.getTime(), statusCode });
+      return {
+        values: data,
+        hasNextPage: nextPage !== void 0,
+        nextPage
+      };
+    } 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;
+    }
+  }
+  /**
+   * Performs a GET request returning raw text content.
+   * Uses `Accept: application/vnd.github.raw+json` to retrieve file content directly.
+   * @internal
+   */
+  async requestText(path, params) {
+    const base = `${this.security.getApiUrl()}${path}`;
+    const url = buildUrl(base, params);
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const response = await fetch(url, { headers: this.security.getRawHeaders() });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new GitHubApiError(response.status, response.statusText);
+      }
+      const text = await response.text();
+      this.emit("request", { url, method: "GET", startedAt, finishedAt: /* @__PURE__ */ new Date(), durationMs: Date.now() - startedAt.getTime(), statusCode });
+      return text;
+    } 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;
+    }
+  }
+  makeRequestFn() {
+    return (path, params) => this.request(path, params);
+  }
+  makeRequestListFn() {
+    return (path, params) => this.requestList(path, params);
+  }
+  makeRequestTextFn() {
+    return (path, params) => this.requestText(path, params);
+  }
+  /**
+   * Fetches the authenticated user's profile.
+   *
+   * `GET /user`
+   *
+   * @returns The authenticated user object
+   *
+   * @example
+   * ```typescript
+   * const me = await gh.currentUser();
+   * console.log(me.login); // 'octocat'
+   * ```
+   */
+  async currentUser() {
+    return this.request("/user");
+  }
+  /**
+   * Returns a {@link UserResource} for a given GitHub login, providing access
+   * to user data and their repositories.
+   *
+   * The returned resource can be awaited directly to fetch user info,
+   * or chained to access nested resources.
+   *
+   * @param login - The user's login name (e.g., `'octocat'`)
+   * @returns A chainable user resource
+   *
+   * @example
+   * ```typescript
+   * const user  = await gh.user('octocat');
+   * const repos = await gh.user('octocat').repos({ sort: 'updated' });
+   * const pr    = await gh.user('octocat').repo('Hello-World').pullRequest(1).files();
+   * ```
+   */
+  user(login) {
+    return new UserResource(
+      this.makeRequestFn(),
+      this.makeRequestListFn(),
+      this.makeRequestTextFn(),
+      login
+    );
+  }
+  /**
+   * Returns an {@link OrganizationResource} for a given GitHub organization, providing
+   * access to organization data and its repositories.
+   *
+   * The returned resource can be awaited directly to fetch organization info,
+   * or chained to access nested resources.
+   *
+   * @param name - The organization's login name (e.g., `'github'`)
+   * @returns A chainable organization resource
+   *
+   * @example
+   * ```typescript
+   * const org   = await gh.org('github');
+   * const repos = await gh.org('github').repos({ type: 'public' });
+   * const prs   = await gh.org('github').repo('linguist').pullRequests({ state: 'open' });
+   * ```
+   */
+  org(name) {
+    return new OrganizationResource(
+      this.makeRequestFn(),
+      this.makeRequestListFn(),
+      this.makeRequestTextFn(),
+      name
+    );
+  }
+  /**
+   * Returns a {@link RepositoryResource} for a given owner and repository name.
+   *
+   * Shortcut that works for both user repositories and organization repositories.
+   *
+   * @param owner - The owner login (user or organization)
+   * @param name - The repository name
+   * @returns A chainable repository resource
+   *
+   * @example
+   * ```typescript
+   * const repo  = await gh.repo('octocat', 'Hello-World');
+   * const prs   = await gh.repo('octocat', 'Hello-World').pullRequests();
+   * ```
+   */
+  repo(owner, name) {
+    return new RepositoryResource(
+      this.makeRequestFn(),
+      this.makeRequestListFn(),
+      this.makeRequestTextFn(),
+      owner,
+      name
+    );
+  }
+  /**
+   * Searches for repositories using GitHub's search syntax.
+   *
+   * `GET /search/repositories`
+   *
+   * @param params - Search query and optional filters. `q` is required.
+   * @returns A paged response of repositories with `totalCount`
+   *
+   * @example
+   * ```typescript
+   * const results = await gh.searchRepos({ q: 'language:typescript stars:>1000', sort: 'stars' });
+   * console.log(`Found ${results.totalCount} repositories`);
+   * ```
+   */
+  async searchRepos(params) {
+    const base = `${this.security.getApiUrl()}/search/repositories`;
+    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 GitHubApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      const linkHeader = response.headers.get("Link");
+      const nextPage = parseNextPage(linkHeader);
+      this.emit("request", { url, method: "GET", startedAt, finishedAt: /* @__PURE__ */ new Date(), durationMs: Date.now() - startedAt.getTime(), statusCode });
+      return {
+        values: data.items,
+        hasNextPage: nextPage !== void 0,
+        nextPage,
+        totalCount: data.total_count
+      };
+    } 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;
+    }
+  }
+};
+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()}`;
+}
+function parseNextPage(linkHeader) {
+  if (!linkHeader) return void 0;
+  const match = linkHeader.match(/<[^>]*[?&]page=(\d+)[^>]*>;\s*rel="next"/);
+  return match ? parseInt(match[1], 10) : void 0;
+}
+export {
+  CommitResource,
+  GitHubApiError,
+  GitHubClient,
+  OrganizationResource,
+  PullRequestResource,
+  RepositoryResource,
+  Security,
+  UserResource
+};
+//# sourceMappingURL=index.mjs.map