@hasna/connectors 0.0.1

package/connectors/connect-github/src/api/pulls.ts

@@ -0,0 +1,284 @@
+import type { GitHubClient } from './client';
+import type {
+  PullRequest,
+  ListPullsOptions,
+  MergePullOptions,
+  MergeResult,
+  PullRequestReview,
+  Commit,
+  IssueComment,
+} from '../types';
+
+/**
+ * GitHub Pull Requests API
+ */
+export class PullsApi {
+  constructor(private readonly client: GitHubClient) {}
+
+  /**
+   * List pull requests in a repository
+   */
+  async list(owner: string, repo: string, options?: ListPullsOptions): Promise<PullRequest[]> {
+    return this.client.get<PullRequest[]>(`/repos/${owner}/${repo}/pulls`, options as Record<string, string | number | boolean | undefined>);
+  }
+
+  /**
+   * Get a single pull request
+   */
+  async get(owner: string, repo: string, prNumber: number): Promise<PullRequest> {
+    return this.client.get<PullRequest>(`/repos/${owner}/${repo}/pulls/${prNumber}`);
+  }
+
+  /**
+   * Create a pull request
+   */
+  async create(
+    owner: string,
+    repo: string,
+    title: string,
+    head: string,
+    base: string,
+    body?: string,
+    options?: {
+      draft?: boolean;
+      maintainer_can_modify?: boolean;
+    }
+  ): Promise<PullRequest> {
+    return this.client.post<PullRequest>(`/repos/${owner}/${repo}/pulls`, {
+      title,
+      head,
+      base,
+      body,
+      ...options,
+    });
+  }
+
+  /**
+   * Update a pull request
+   */
+  async update(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options: {
+      title?: string;
+      body?: string;
+      state?: 'open' | 'closed';
+      base?: string;
+      maintainer_can_modify?: boolean;
+    }
+  ): Promise<PullRequest> {
+    return this.client.patch<PullRequest>(`/repos/${owner}/${repo}/pulls/${prNumber}`, options);
+  }
+
+  /**
+   * Merge a pull request
+   */
+  async merge(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options?: MergePullOptions
+  ): Promise<MergeResult> {
+    return this.client.put<MergeResult>(`/repos/${owner}/${repo}/pulls/${prNumber}/merge`, options || {});
+  }
+
+  /**
+   * Check if a pull request has been merged
+   */
+  async isMerged(owner: string, repo: string, prNumber: number): Promise<boolean> {
+    try {
+      await this.client.get(`/repos/${owner}/${repo}/pulls/${prNumber}/merge`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * List commits on a pull request
+   */
+  async listCommits(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options?: { per_page?: number; page?: number }
+  ): Promise<Commit[]> {
+    return this.client.get<Commit[]>(`/repos/${owner}/${repo}/pulls/${prNumber}/commits`, options);
+  }
+
+  /**
+   * List files in a pull request
+   */
+  async listFiles(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options?: { per_page?: number; page?: number }
+  ): Promise<
+    Array<{
+      sha: string;
+      filename: string;
+      status: string;
+      additions: number;
+      deletions: number;
+      changes: number;
+      blob_url: string;
+      raw_url: string;
+      contents_url: string;
+      patch?: string;
+    }>
+  > {
+    return this.client.get(`/repos/${owner}/${repo}/pulls/${prNumber}/files`, options);
+  }
+
+  /**
+   * List reviews on a pull request
+   */
+  async listReviews(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options?: { per_page?: number; page?: number }
+  ): Promise<PullRequestReview[]> {
+    return this.client.get<PullRequestReview[]>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/reviews`,
+      options
+    );
+  }
+
+  /**
+   * Get a single review
+   */
+  async getReview(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    reviewId: number
+  ): Promise<PullRequestReview> {
+    return this.client.get<PullRequestReview>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/reviews/${reviewId}`
+    );
+  }
+
+  /**
+   * Create a review on a pull request
+   */
+  async createReview(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    body?: string,
+    event?: 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT',
+    options?: {
+      commit_id?: string;
+      comments?: Array<{
+        path: string;
+        position?: number;
+        body: string;
+        line?: number;
+        side?: 'LEFT' | 'RIGHT';
+        start_line?: number;
+        start_side?: 'LEFT' | 'RIGHT';
+      }>;
+    }
+  ): Promise<PullRequestReview> {
+    return this.client.post<PullRequestReview>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/reviews`,
+      {
+        body,
+        event,
+        ...options,
+      }
+    );
+  }
+
+  /**
+   * Submit a pending review
+   */
+  async submitReview(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    reviewId: number,
+    event: 'APPROVE' | 'REQUEST_CHANGES' | 'COMMENT',
+    body?: string
+  ): Promise<PullRequestReview> {
+    return this.client.post<PullRequestReview>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/reviews/${reviewId}/events`,
+      { event, body }
+    );
+  }
+
+  /**
+   * Dismiss a review
+   */
+  async dismissReview(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    reviewId: number,
+    message: string
+  ): Promise<PullRequestReview> {
+    return this.client.put<PullRequestReview>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/reviews/${reviewId}/dismissals`,
+      { message }
+    );
+  }
+
+  /**
+   * List review comments on a pull request
+   */
+  async listReviewComments(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    options?: {
+      sort?: 'created' | 'updated';
+      direction?: 'asc' | 'desc';
+      since?: string;
+      per_page?: number;
+      page?: number;
+    }
+  ): Promise<IssueComment[]> {
+    return this.client.get<IssueComment[]>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/comments`,
+      options
+    );
+  }
+
+  /**
+   * Request reviewers for a pull request
+   */
+  async requestReviewers(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    reviewers?: string[],
+    teamReviewers?: string[]
+  ): Promise<PullRequest> {
+    return this.client.post<PullRequest>(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/requested_reviewers`,
+      {
+        reviewers,
+        team_reviewers: teamReviewers,
+      }
+    );
+  }
+
+  /**
+   * Remove requested reviewers from a pull request
+   */
+  async removeRequestedReviewers(
+    owner: string,
+    repo: string,
+    prNumber: number,
+    reviewers?: string[],
+    teamReviewers?: string[]
+  ): Promise<void> {
+    await this.client.request(
+      `/repos/${owner}/${repo}/pulls/${prNumber}/requested_reviewers`,
+      { method: 'DELETE', body: { reviewers, team_reviewers: teamReviewers } }
+    );
+  }
+}

package/connectors/connect-github/src/api/repos.ts

@@ -0,0 +1,155 @@
+import type { GitHubClient } from './client';
+import type {
+  Repository,
+  CreateRepoOptions,
+  FileContent,
+  CreateOrUpdateFileOptions,
+  FileCommitResponse,
+} from '../types';
+
+/**
+ * GitHub Repositories API
+ */
+export class ReposApi {
+  constructor(private readonly client: GitHubClient) {}
+
+  /**
+   * Get a repository
+   */
+  async get(owner: string, repo: string): Promise<Repository> {
+    return this.client.get<Repository>(`/repos/${owner}/${repo}`);
+  }
+
+  /**
+   * List repositories for a user
+   */
+  async list(
+    username: string,
+    options?: {
+      type?: 'all' | 'owner' | 'member';
+      sort?: 'created' | 'updated' | 'pushed' | 'full_name';
+      direction?: 'asc' | 'desc';
+      per_page?: number;
+      page?: number;
+    }
+  ): Promise<Repository[]> {
+    return this.client.get<Repository[]>(`/users/${username}/repos`, options);
+  }
+
+  /**
+   * List repositories for an organization
+   */
+  async listOrg(
+    org: string,
+    options?: {
+      type?: 'all' | 'public' | 'private' | 'forks' | 'sources' | 'member';
+      sort?: 'created' | 'updated' | 'pushed' | 'full_name';
+      direction?: 'asc' | 'desc';
+      per_page?: number;
+      page?: number;
+    }
+  ): Promise<Repository[]> {
+    return this.client.get<Repository[]>(`/orgs/${org}/repos`, options);
+  }
+
+  /**
+   * List repositories for the authenticated user
+   */
+  async listForAuthenticatedUser(options?: {
+    visibility?: 'all' | 'public' | 'private';
+    affiliation?: string;
+    type?: 'all' | 'owner' | 'public' | 'private' | 'member';
+    sort?: 'created' | 'updated' | 'pushed' | 'full_name';
+    direction?: 'asc' | 'desc';
+    per_page?: number;
+    page?: number;
+  }): Promise<Repository[]> {
+    return this.client.get<Repository[]>('/user/repos', options);
+  }
+
+  /**
+   * Create a repository for the authenticated user
+   */
+  async create(name: string, options?: CreateRepoOptions): Promise<Repository> {
+    return this.client.post<Repository>('/user/repos', {
+      name,
+      ...options,
+    });
+  }
+
+  /**
+   * Create a repository in an organization
+   */
+  async createInOrg(org: string, name: string, options?: CreateRepoOptions): Promise<Repository> {
+    return this.client.post<Repository>(`/orgs/${org}/repos`, {
+      name,
+      ...options,
+    });
+  }
+
+  /**
+   * Delete a repository
+   */
+  async delete(owner: string, repo: string): Promise<void> {
+    await this.client.delete(`/repos/${owner}/${repo}`);
+  }
+
+  /**
+   * Get repository content (file or directory)
+   */
+  async getContent(
+    owner: string,
+    repo: string,
+    path: string,
+    options?: { ref?: string }
+  ): Promise<FileContent | FileContent[]> {
+    return this.client.get<FileContent | FileContent[]>(
+      `/repos/${owner}/${repo}/contents/${path}`,
+      options
+    );
+  }
+
+  /**
+   * Create or update a file
+   */
+  async createOrUpdateFile(
+    owner: string,
+    repo: string,
+    path: string,
+    options: CreateOrUpdateFileOptions
+  ): Promise<FileCommitResponse> {
+    return this.client.put<FileCommitResponse>(
+      `/repos/${owner}/${repo}/contents/${path}`,
+      options
+    );
+  }
+
+  /**
+   * Delete a file
+   */
+  async deleteFile(
+    owner: string,
+    repo: string,
+    path: string,
+    options: { message: string; sha: string; branch?: string }
+  ): Promise<FileCommitResponse> {
+    return this.client.delete<FileCommitResponse>(
+      `/repos/${owner}/${repo}/contents/${path}`,
+      options as Record<string, string | undefined>
+    );
+  }
+
+  /**
+   * List repository topics
+   */
+  async listTopics(owner: string, repo: string): Promise<{ names: string[] }> {
+    return this.client.get<{ names: string[] }>(`/repos/${owner}/${repo}/topics`);
+  }
+
+  /**
+   * Replace all repository topics
+   */
+  async replaceTopics(owner: string, repo: string, names: string[]): Promise<{ names: string[] }> {
+    return this.client.put<{ names: string[] }>(`/repos/${owner}/${repo}/topics`, { names });
+  }
+}

package/connectors/connect-github/src/api/users.ts

@@ -0,0 +1,139 @@
+import type { GitHubClient } from './client';
+import type { User } from '../types';
+
+/**
+ * GitHub Users API
+ */
+export class UsersApi {
+  constructor(private readonly client: GitHubClient) {}
+
+  /**
+   * Get the authenticated user
+   */
+  async getAuthenticated(): Promise<User> {
+    return this.client.get<User>('/user');
+  }
+
+  /**
+   * Get a user by username
+   */
+  async get(username: string): Promise<User> {
+    return this.client.get<User>(`/users/${username}`);
+  }
+
+  /**
+   * List followers of a user
+   */
+  async listFollowers(
+    username: string,
+    options?: { per_page?: number; page?: number }
+  ): Promise<User[]> {
+    return this.client.get<User[]>(`/users/${username}/followers`, options);
+  }
+
+  /**
+   * List users followed by a user
+   */
+  async listFollowing(
+    username: string,
+    options?: { per_page?: number; page?: number }
+  ): Promise<User[]> {
+    return this.client.get<User[]>(`/users/${username}/following`, options);
+  }
+
+  /**
+   * List followers of the authenticated user
+   */
+  async listMyFollowers(options?: { per_page?: number; page?: number }): Promise<User[]> {
+    return this.client.get<User[]>('/user/followers', options);
+  }
+
+  /**
+   * List users followed by the authenticated user
+   */
+  async listMyFollowing(options?: { per_page?: number; page?: number }): Promise<User[]> {
+    return this.client.get<User[]>('/user/following', options);
+  }
+
+  /**
+   * Check if the authenticated user follows a user
+   */
+  async isFollowing(username: string): Promise<boolean> {
+    try {
+      await this.client.get(`/user/following/${username}`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Check if a user follows another user
+   */
+  async checkFollowing(username: string, targetUser: string): Promise<boolean> {
+    try {
+      await this.client.get(`/users/${username}/following/${targetUser}`);
+      return true;
+    } catch {
+      return false;
+    }
+  }
+
+  /**
+   * Follow a user
+   */
+  async follow(username: string): Promise<void> {
+    await this.client.put(`/user/following/${username}`, {});
+  }
+
+  /**
+   * Unfollow a user
+   */
+  async unfollow(username: string): Promise<void> {
+    await this.client.delete(`/user/following/${username}`);
+  }
+
+  /**
+   * List emails for the authenticated user
+   */
+  async listEmails(options?: { per_page?: number; page?: number }): Promise<
+    Array<{
+      email: string;
+      primary: boolean;
+      verified: boolean;
+      visibility: string | null;
+    }>
+  > {
+    return this.client.get('/user/emails', options);
+  }
+
+  /**
+   * List public emails for the authenticated user
+   */
+  async listPublicEmails(options?: { per_page?: number; page?: number }): Promise<
+    Array<{
+      email: string;
+      primary: boolean;
+      verified: boolean;
+      visibility: string | null;
+    }>
+  > {
+    return this.client.get('/user/public_emails', options);
+  }
+
+  /**
+   * Update the authenticated user
+   */
+  async update(options: {
+    name?: string;
+    email?: string;
+    blog?: string;
+    twitter_username?: string;
+    company?: string;
+    location?: string;
+    hireable?: boolean;
+    bio?: string;
+  }): Promise<User> {
+    return this.client.patch<User>('/user', options);
+  }
+}