feat(web): add GitLab API client wrapper and types

packages/web/src/api/gitlab.ts

@@ -0,0 +1,186 @@
+import type {
+  GitLabAPI,
+  GitLabAuthStatus,
+  GitLabBranchesResult,
+  GitLabIssueCommentsResult,
+  GitLabIssueGetResult,
+  GitLabIssuesListResult,
+  GitLabMergeRequestContextResult,
+  GitLabMergeRequestsListResult,
+  GitLabUserSummary,
+} from '@openchamber/ui/lib/api/types';
+import { runtimeFetch } from '@openchamber/ui/lib/runtime-fetch';
+import type { RuntimeUrlResolver } from '@openchamber/ui/lib/runtime-url';
+
+interface WebGitLabAPIOptions {
+  urls: RuntimeUrlResolver;
+}
+
+const jsonOrNull = async <T>(response: Response): Promise<T | null> => {
+  return (await response.json().catch(() => null)) as T | null;
+};
+
+export const createWebGitLabAPI = ({ urls }: WebGitLabAPIOptions): GitLabAPI => ({
+  async authStatus(): Promise<GitLabAuthStatus> {
+    const response = await runtimeFetch('/api/gitlab/auth/status', { method: 'GET', headers: { Accept: 'application/json' } });
+    const payload = await jsonOrNull<GitLabAuthStatus & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab status');
+    }
+    return payload;
+  },
+
+  async authConnect(input: { accessToken: string; baseUrl?: string }): Promise<GitLabAuthStatus> {
+    const response = await runtimeFetch('/api/gitlab/auth/connect', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+      body: JSON.stringify(input),
+    });
+    const payload = await jsonOrNull<GitLabAuthStatus & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to connect GitLab');
+    }
+    return payload;
+  },
+
+  async authActivate(accountId: string): Promise<GitLabAuthStatus> {
+    const response = await runtimeFetch('/api/gitlab/auth/activate', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+      body: JSON.stringify({ accountId }),
+    });
+    const payload = await jsonOrNull<GitLabAuthStatus & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to activate GitLab account');
+    }
+    return payload;
+  },
+
+  async authDisconnect(): Promise<{ removed: boolean }> {
+    const response = await runtimeFetch('/api/gitlab/auth', {
+      method: 'DELETE',
+      headers: { 'Content-Type': 'application/json', Accept: 'application/json' },
+    });
+    const payload = await jsonOrNull<{ removed?: boolean; error?: string }>(response);
+    if (!response.ok) {
+      throw new Error(payload?.error || response.statusText || 'Failed to disconnect GitLab');
+    }
+    return { removed: Boolean(payload?.removed) };
+  },
+
+  async me(): Promise<GitLabUserSummary> {
+    const response = await runtimeFetch('/api/gitlab/me', { method: 'GET', headers: { Accept: 'application/json' } });
+    const payload = await jsonOrNull<GitLabUserSummary & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to fetch GitLab user');
+    }
+    return payload;
+  },
+
+  async issuesList(directory: string, options?: { page?: number; query?: string }): Promise<GitLabIssuesListResult> {
+    const page = options?.page ?? 1;
+    const params = new URLSearchParams({
+      directory,
+      page: String(page),
+    });
+    if (options?.query) {
+      params.set('query', options.query);
+    }
+    const response = await runtimeFetch(
+      `/api/gitlab/issues/list?${params.toString()}`,
+      { method: 'GET', headers: { Accept: 'application/json' } }
+    );
+    const payload = await jsonOrNull<GitLabIssuesListResult & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab issues');
+    }
+    return payload;
+  },
+
+  async issueGet(directory: string, number: number, options?: { namespace?: string; project?: string }): Promise<GitLabIssueGetResult> {
+    const params = new URLSearchParams({ directory, number: String(number) });
+    if (options?.namespace) {
+      params.set('namespace', options.namespace);
+    }
+    if (options?.project) {
+      params.set('project', options.project);
+    }
+    const response = await runtimeFetch(urls.api('/api/gitlab/issues/get', params), { method: 'GET', headers: { Accept: 'application/json' } });
+    const payload = await jsonOrNull<GitLabIssueGetResult & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab issue');
+    }
+    return payload;
+  },
+
+  async issueComments(directory: string, number: number, options?: { namespace?: string; project?: string }): Promise<GitLabIssueCommentsResult> {
+    const params = new URLSearchParams({ directory, number: String(number) });
+    if (options?.namespace) {
+      params.set('namespace', options.namespace);
+    }
+    if (options?.project) {
+      params.set('project', options.project);
+    }
+    const response = await runtimeFetch(urls.api('/api/gitlab/issues/comments', params), { method: 'GET', headers: { Accept: 'application/json' } });
+    const payload = await jsonOrNull<GitLabIssueCommentsResult & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab issue comments');
+    }
+    return payload;
+  },
+
+  async mrsList(directory: string, options?: { page?: number; query?: string }): Promise<GitLabMergeRequestsListResult> {
+    const page = options?.page ?? 1;
+    const params = new URLSearchParams({
+      directory,
+      page: String(page),
+    });
+    if (options?.query) {
+      params.set('query', options.query);
+    }
+    const response = await runtimeFetch(
+      `/api/gitlab/mrs/list?${params.toString()}`,
+      { method: 'GET', headers: { Accept: 'application/json' } }
+    );
+    const payload = await jsonOrNull<GitLabMergeRequestsListResult & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab merge requests');
+    }
+    return payload;
+  },
+
+  async mrContext(
+    directory: string,
+    number: number,
+    options?: { includeDiff?: boolean; namespace?: string; project?: string }
+  ): Promise<GitLabMergeRequestContextResult> {
+    const params = new URLSearchParams({ directory, number: String(number) });
+    if (options?.includeDiff) {
+      params.set('diff', '1');
+    }
+    if (options?.namespace) {
+      params.set('namespace', options.namespace);
+    }
+    if (options?.project) {
+      params.set('project', options.project);
+    }
+    const response = await runtimeFetch(urls.api('/api/gitlab/mrs/context', params), { method: 'GET', headers: { Accept: 'application/json' } });
+    const payload = await jsonOrNull<GitLabMergeRequestContextResult & { error?: string }>(response);
+    if (!response.ok || !payload) {
+      throw new Error(payload?.error || response.statusText || 'Failed to load GitLab merge request context');
+    }
+    return payload;
+  },
+
+  async repoBranches(namespace: string, project: string): Promise<string[]> {
+    const response = await runtimeFetch(
+      `/api/gitlab/repo/branches?namespace=${encodeURIComponent(namespace)}&project=${encodeURIComponent(project)}`,
+      { method: 'GET', headers: { Accept: 'application/json' } }
+    );
+    const body = await jsonOrNull<GitLabBranchesResult & { error?: string }>(response);
+    if (!response.ok || !body) {
+      throw new Error(body?.error || response.statusText || 'Failed to fetch GitLab repo branches');
+    }
+    return body.branches ?? [];
+  },
+});