@hasna/connectors 0.3.16 → 0.4.0

package/connectors/connect-jira/src/api/client.ts

@@ -0,0 +1,131 @@
+import type { JiraConfig, JiraError } from '../types';
+import { JiraApiError } from '../types';
+
+export interface RequestOptions {
+  method?: 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH';
+  params?: Record<string, string | number | boolean | undefined>;
+  body?: Record<string, unknown> | unknown[] | string;
+  headers?: Record<string, string>;
+}
+
+export class JiraClient {
+  private readonly email: string;
+  private readonly apiToken: string;
+  private readonly baseUrl: string;
+
+  constructor(config: JiraConfig) {
+    if (!config.email) {
+      throw new Error('Email is required');
+    }
+    if (!config.apiToken) {
+      throw new Error('API token is required');
+    }
+    if (!config.domain) {
+      throw new Error('Domain is required');
+    }
+    this.email = config.email;
+    this.apiToken = config.apiToken;
+    this.baseUrl = config.baseUrl || `https://${config.domain}/rest/api/3`;
+  }
+
+  private getAuthHeader(): string {
+    const credentials = `${this.email}:${this.apiToken}`;
+    const encoded = Buffer.from(credentials).toString('base64');
+    return `Basic ${encoded}`;
+  }
+
+  private buildUrl(path: string, params?: Record<string, string | number | boolean | undefined>): string {
+    const url = new URL(`${this.baseUrl}${path}`);
+
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null && value !== '') {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+
+    return url.toString();
+  }
+
+  async request<T>(path: string, options: RequestOptions = {}): Promise<T> {
+    const { method = 'GET', params, body, headers = {} } = options;
+
+    const url = this.buildUrl(path, params);
+
+    const requestHeaders: Record<string, string> = {
+      'Authorization': this.getAuthHeader(),
+      'Accept': 'application/json',
+      ...headers,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      requestHeaders['Content-Type'] = 'application/json';
+    }
+
+    const fetchOptions: RequestInit = {
+      method,
+      headers: requestHeaders,
+    };
+
+    if (body && ['POST', 'PUT', 'PATCH'].includes(method)) {
+      fetchOptions.body = typeof body === 'string' ? body : JSON.stringify(body);
+    }
+
+    const response = await fetch(url, fetchOptions);
+
+    if (response.status === 204) {
+      return {} as T;
+    }
+
+    let data: unknown;
+    const contentType = response.headers.get('content-type') || '';
+
+    if (contentType.includes('application/json')) {
+      const text = await response.text();
+      if (text) {
+        try {
+          data = JSON.parse(text);
+        } catch {
+          data = text;
+        }
+      }
+    } else {
+      data = await response.text();
+    }
+
+    if (!response.ok) {
+      const errorData = data as JiraError | null;
+      const errorMessage = errorData?.errorMessages?.[0] ||
+        (errorData?.errors ? Object.values(errorData.errors).join(', ') : '') ||
+        response.statusText;
+      throw new JiraApiError(errorMessage, response.status, errorData || undefined);
+    }
+
+    return data as T;
+  }
+
+  async get<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'GET', params });
+  }
+
+  async post<T>(path: string, body?: Record<string, unknown> | unknown[] | string | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'POST', body: body as Record<string, unknown>, params });
+  }
+
+  async put<T>(path: string, body?: Record<string, unknown> | object, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'PUT', body: body as Record<string, unknown>, params });
+  }
+
+  async delete<T>(path: string, params?: Record<string, string | number | boolean | undefined>): Promise<T> {
+    return this.request<T>(path, { method: 'DELETE', params });
+  }
+
+  getEmailPreview(): string {
+    const [local, domain] = this.email.split('@');
+    if (local && domain) {
+      return `${local.substring(0, 3)}...@${domain}`;
+    }
+    return '***@***';
+  }
+}

package/connectors/connect-jira/src/api/index.ts

@@ -0,0 +1,266 @@
+// Jira Connector
+// Projects, issues, boards, and sprints management
+
+import { JiraClient } from './client';
+import type {
+  JiraConfig,
+  User,
+  Project,
+  Issue,
+  Comment,
+  Transition,
+  Board,
+  Sprint,
+  SearchResponse,
+  PaginatedResponse,
+  CreateIssueInput,
+  UpdateIssueInput,
+  TransitionIssueInput,
+  CreateCommentInput,
+} from '../types';
+
+export { JiraClient } from './client';
+
+export class Jira {
+  private client: JiraClient;
+  private agileBaseUrl: string;
+
+  constructor(config: JiraConfig) {
+    this.client = new JiraClient(config);
+    this.agileBaseUrl = config.baseUrl?.replace('/rest/api/3', '/rest/agile/1.0') ||
+      `https://${config.domain}/rest/agile/1.0`;
+  }
+
+  // ============================================
+  // User Operations
+  // ============================================
+
+  async getMyself(): Promise<User> {
+    return this.client.get<User>('/myself');
+  }
+
+  async searchUsers(options: {
+    query?: string;
+    accountId?: string;
+    startAt?: number;
+    maxResults?: number;
+  }): Promise<User[]> {
+    return this.client.get<User[]>('/user/search', options);
+  }
+
+  // ============================================
+  // Project Operations
+  // ============================================
+
+  async listProjects(options?: {
+    startAt?: number;
+    maxResults?: number;
+    orderBy?: string;
+    expand?: string;
+  }): Promise<PaginatedResponse<Project>> {
+    return this.client.get<PaginatedResponse<Project>>('/project/search', options);
+  }
+
+  async getProject(projectIdOrKey: string, options?: { expand?: string }): Promise<Project> {
+    return this.client.get<Project>(`/project/${projectIdOrKey}`, options);
+  }
+
+  // ============================================
+  // Issue Operations
+  // ============================================
+
+  async searchIssues(options: {
+    jql: string;
+    startAt?: number;
+    maxResults?: number;
+    fields?: string[];
+    expand?: string;
+  }): Promise<SearchResponse<Issue>> {
+    return this.client.post<SearchResponse<Issue>>('/search', {
+      jql: options.jql,
+      startAt: options.startAt,
+      maxResults: options.maxResults,
+      fields: options.fields,
+      expand: options.expand,
+    });
+  }
+
+  async getIssue(issueIdOrKey: string, options?: {
+    fields?: string[];
+    expand?: string;
+  }): Promise<Issue> {
+    return this.client.get<Issue>(`/issue/${issueIdOrKey}`, {
+      fields: options?.fields?.join(','),
+      expand: options?.expand,
+    });
+  }
+
+  async createIssue(input: CreateIssueInput): Promise<Issue> {
+    return this.client.post<Issue>('/issue', input);
+  }
+
+  async updateIssue(issueIdOrKey: string, input: UpdateIssueInput): Promise<void> {
+    await this.client.put(`/issue/${issueIdOrKey}`, input);
+  }
+
+  async deleteIssue(issueIdOrKey: string, options?: { deleteSubtasks?: boolean }): Promise<void> {
+    await this.client.delete(`/issue/${issueIdOrKey}`, {
+      deleteSubtasks: options?.deleteSubtasks,
+    });
+  }
+
+  async assignIssue(issueIdOrKey: string, accountId: string | null): Promise<void> {
+    await this.client.put(`/issue/${issueIdOrKey}/assignee`, { accountId });
+  }
+
+  // ============================================
+  // Transition Operations
+  // ============================================
+
+  async getTransitions(issueIdOrKey: string): Promise<{ transitions: Transition[] }> {
+    return this.client.get<{ transitions: Transition[] }>(`/issue/${issueIdOrKey}/transitions`);
+  }
+
+  async transitionIssue(issueIdOrKey: string, input: TransitionIssueInput): Promise<void> {
+    await this.client.post(`/issue/${issueIdOrKey}/transitions`, input);
+  }
+
+  // ============================================
+  // Comment Operations
+  // ============================================
+
+  async getComments(issueIdOrKey: string, options?: {
+    startAt?: number;
+    maxResults?: number;
+    orderBy?: string;
+    expand?: string;
+  }): Promise<{ comments: Comment[]; startAt: number; maxResults: number; total: number }> {
+    return this.client.get(`/issue/${issueIdOrKey}/comment`, options);
+  }
+
+  async addComment(issueIdOrKey: string, input: CreateCommentInput): Promise<Comment> {
+    return this.client.post<Comment>(`/issue/${issueIdOrKey}/comment`, input);
+  }
+
+  async updateComment(issueIdOrKey: string, commentId: string, input: CreateCommentInput): Promise<Comment> {
+    return this.client.put<Comment>(`/issue/${issueIdOrKey}/comment/${commentId}`, input);
+  }
+
+  async deleteComment(issueIdOrKey: string, commentId: string): Promise<void> {
+    await this.client.delete(`/issue/${issueIdOrKey}/comment/${commentId}`);
+  }
+
+  // ============================================
+  // Board Operations (Agile)
+  // ============================================
+
+  async listBoards(options?: {
+    startAt?: number;
+    maxResults?: number;
+    type?: 'scrum' | 'kanban' | 'simple';
+    name?: string;
+    projectKeyOrId?: string;
+  }): Promise<PaginatedResponse<Board>> {
+    const url = this.agileBaseUrl + '/board';
+    const response = await fetch(this.buildAgileUrl(url, options), {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  async getBoard(boardId: number): Promise<Board> {
+    const url = this.agileBaseUrl + `/board/${boardId}`;
+    const response = await fetch(url, {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  async getBoardIssues(boardId: number, options?: {
+    startAt?: number;
+    maxResults?: number;
+    jql?: string;
+  }): Promise<SearchResponse<Issue>> {
+    const url = this.agileBaseUrl + `/board/${boardId}/issue`;
+    const response = await fetch(this.buildAgileUrl(url, options), {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  // ============================================
+  // Sprint Operations
+  // ============================================
+
+  async listSprints(boardId: number, options?: {
+    startAt?: number;
+    maxResults?: number;
+    state?: 'future' | 'active' | 'closed';
+  }): Promise<PaginatedResponse<Sprint>> {
+    const url = this.agileBaseUrl + `/board/${boardId}/sprint`;
+    const response = await fetch(this.buildAgileUrl(url, options), {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  async getSprint(sprintId: number): Promise<Sprint> {
+    const url = this.agileBaseUrl + `/sprint/${sprintId}`;
+    const response = await fetch(url, {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  async getSprintIssues(sprintId: number, options?: {
+    startAt?: number;
+    maxResults?: number;
+    jql?: string;
+  }): Promise<SearchResponse<Issue>> {
+    const url = this.agileBaseUrl + `/sprint/${sprintId}/issue`;
+    const response = await fetch(this.buildAgileUrl(url, options), {
+      headers: this.getAgileHeaders(),
+    });
+    return response.json();
+  }
+
+  async moveIssuesToSprint(sprintId: number, issueKeys: string[]): Promise<void> {
+    const url = this.agileBaseUrl + `/sprint/${sprintId}/issue`;
+    await fetch(url, {
+      method: 'POST',
+      headers: {
+        ...this.getAgileHeaders(),
+        'Content-Type': 'application/json',
+      },
+      body: JSON.stringify({ issues: issueKeys }),
+    });
+  }
+
+  // ============================================
+  // Helper Methods
+  // ============================================
+
+  private getAgileHeaders(): Record<string, string> {
+    const credentials = Buffer.from(`${(this.client as any).email}:${(this.client as any).apiToken}`).toString('base64');
+    return {
+      'Authorization': `Basic ${credentials}`,
+      'Accept': 'application/json',
+    };
+  }
+
+  private buildAgileUrl(baseUrl: string, params?: Record<string, string | number | boolean | undefined>): string {
+    const url = new URL(baseUrl);
+    if (params) {
+      Object.entries(params).forEach(([key, value]) => {
+        if (value !== undefined && value !== null && value !== '') {
+          url.searchParams.append(key, String(value));
+        }
+      });
+    }
+    return url.toString();
+  }
+
+  getClient(): JiraClient {
+    return this.client;
+  }
+}