@venturialstd/jira 0.1.31 → 0.1.33

package/README.md

@@ -0,0 +1,481 @@
+# @venturialstd/jira
+
+A comprehensive **NestJS SDK for Jira Cloud Platform REST API v3**, developed by **Venturial**, that provides full integration with Atlassian Jira. This module enables seamless issue management, project operations, user management, and all Jira API capabilities.
+
+---
+
+## Features
+
+- **Issue Management**: Create, read, update, delete, and search issues with full support for all issue operations
+- **Project Operations**: Get project details, components, versions, statuses, roles, and properties
+- **User Management**: Search users, get user details, and manage user picker operations
+- **Comments**: Add, update, delete, and retrieve comments on issues
+- **Worklogs**: Create, update, delete, and retrieve worklogs for time tracking
+- **Attachments**: Upload, download, and manage file attachments
+- **Search & JQL**: Powerful JQL-based search capabilities for finding issues
+- **Transitions**: Get available transitions and transition issues through workflows
+- **Changelogs**: Retrieve issue changelogs and history
+- **Bulk Operations**: Bulk create, fetch, archive, and unarchive issues
+- **Webhooks**: Register, manage, and monitor dynamic webhooks for real-time event notifications
+- **Type Safety**: Full TypeScript support with comprehensive type definitions
+- **Configuration Flexibility**: Configure credentials globally via settings or pass them per-request
+
+---
+
+## Installation
+
+```bash
+npm install @venturialstd/jira
+# or
+yarn add @venturialstd/jira
+```
+
+### Peer Dependencies
+
+This package requires the following peer dependencies:
+
+```bash
+npm install @nestjs/common@^11.0.11 @nestjs/core@^11.0.5 @nestjs/axios@^4.0.0 @venturialstd/core@^1.0.16 rxjs@^7.8.1
+```
+
+---
+
+## Basic Usage
+
+### 1. Import the Module
+
+```typescript
+import { Module } from '@nestjs/common';
+import { JiraModule } from '@venturialstd/jira';
+
+@Module({
+  imports: [
+    JiraModule,
+  ],
+})
+export class AppModule {}
+```
+
+### 2. Inject and Use Services
+
+```typescript
+import { Injectable } from '@nestjs/common';
+import {
+  JiraIssueService,
+  JiraSearchService,
+  JiraCommentService,
+  JiraProjectService,
+  JiraConfig,
+} from '@venturialstd/jira';
+
+@Injectable()
+export class TaskService {
+  constructor(
+    private readonly issueService: JiraIssueService,
+    private readonly searchService: JiraSearchService,
+    private readonly commentService: JiraCommentService,
+    private readonly projectService: JiraProjectService,
+  ) {}
+
+  async createTask(summary: string, description: string) {
+    // Create an issue
+    const issue = await this.issueService.createIssue(null, {
+      fields: {
+        project: { key: 'PROJ' },
+        summary,
+        description: {
+          type: 'doc',
+          version: 1,
+          content: [
+            {
+              type: 'paragraph',
+              content: [{ type: 'text', text: description }],
+            },
+          ],
+        },
+        issuetype: { name: 'Task' },
+      },
+    });
+
+    return issue;
+  }
+
+  async searchTasks(jql: string) {
+    // Search issues using JQL
+    const results = await this.searchService.searchIssues(null, {
+      jql,
+      maxResults: 50,
+    });
+
+    return results.issues;
+  }
+
+  async addComment(issueKey: string, comment: string) {
+    // Add a comment to an issue
+    return await this.commentService.addComment(null, issueKey, {
+      body: {
+        type: 'doc',
+        version: 1,
+        content: [
+          {
+            type: 'paragraph',
+            content: [{ type: 'text', text: comment }],
+          },
+        ],
+      },
+    });
+  }
+}
+```
+
+### 3. Configuration
+
+The module uses `SettingsService` from `@venturialstd/core` to retrieve credentials. Configure the following settings:
+
+- `GLOBAL:JIRA:GENERAL:JIRA_API_TOKEN`: Your Jira API token
+- `GLOBAL:JIRA:GENERAL:JIRA_USER_EMAIL`: Your Jira user email
+- `GLOBAL:JIRA:GENERAL:JIRA_ISSUE_BASE_URL`: Base URL for your Jira instance (e.g., `https://your-domain.atlassian.net`)
+
+Alternatively, you can pass configuration directly to service methods:
+
+```typescript
+const config: JiraConfig = {
+  auth: {
+    token: 'your-api-token',
+    user: 'your-email@example.com',
+  },
+  baseUrl: 'https://your-domain.atlassian.net',
+};
+
+await this.issueService.getIssue(config, 'PROJ-123');
+```
+
+**Note**: All service methods have `config: JiraConfig | null = null` as the first parameter. Pass `null` to use settings-based configuration, or provide a `JiraConfig` object for per-request configuration.
+
+---
+
+## API
+
+### JiraIssueService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getIssue(config, issueIdOrKey, ...)` | `GET /rest/api/3/issue/{issueIdOrKey}` | Get issue details |
+| `createIssue(config, request, updateHistory?)` | `POST /rest/api/3/issue` | Create a new issue |
+| `editIssue(config, issueIdOrKey, request, ...)` | `PUT /rest/api/3/issue/{issueIdOrKey}` | Edit an issue |
+| `deleteIssue(config, issueIdOrKey, deleteSubtasks?)` | `DELETE /rest/api/3/issue/{issueIdOrKey}` | Delete an issue |
+| `assignIssue(config, issueIdOrKey, request)` | `PUT /rest/api/3/issue/{issueIdOrKey}/assignee` | Assign an issue |
+| `getChangelogs(config, issueIdOrKey, startAt?, maxResults?)` | `GET /rest/api/3/issue/{issueIdOrKey}/changelog` | Get issue changelogs |
+| `getChangelogsByIds(config, issueIdOrKey, request)` | `POST /rest/api/3/issue/{issueIdOrKey}/changelog/list` | Get changelogs by IDs |
+| `getEditMeta(config, issueIdOrKey, ...)` | `GET /rest/api/3/issue/{issueIdOrKey}/editmeta` | Get edit metadata |
+| `sendNotification(config, issueIdOrKey, request)` | `POST /rest/api/3/issue/{issueIdOrKey}/notify` | Send notification |
+| `getTransitions(config, issueIdOrKey, ...)` | `GET /rest/api/3/issue/{issueIdOrKey}/transitions` | Get available transitions |
+| `transitionIssue(config, issueIdOrKey, request)` | `POST /rest/api/3/issue/{issueIdOrKey}/transitions` | Transition an issue |
+| `bulkCreateIssues(config, request)` | `POST /rest/api/3/issue/bulk` | Bulk create issues (up to 50) |
+| `bulkFetchIssues(config, request)` | `POST /rest/api/3/issue/bulkfetch` | Bulk fetch issues (up to 100) |
+| `archiveIssues(config, request)` | `PUT /rest/api/3/issue/archive` | Archive issues by ID/key (up to 1000) |
+| `archiveIssuesByJql(config, request)` | `POST /rest/api/3/issue/archive` | Archive issues by JQL (up to 100,000) |
+| `unarchiveIssues(config, request)` | `PUT /rest/api/3/issue/unarchive` | Unarchive issues (up to 1000) |
+| `getIssueLimitReport(config, isReturningKeys?)` | `GET /rest/api/3/issue/limit/report` | Get issue limit report |
+| `exportArchivedIssues(config, request)` | `PUT /rest/api/3/issues/archive/export` | Export archived issues |
+| `getCreateMeta(config, ...)` | `GET /rest/api/3/issue/createmeta` | Get create issue metadata |
+| `getCreateMetaIssueTypes(config, projectIdOrKey, ...)` | `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes` | Get issue types for project |
+| `getCreateMetaFields(config, projectIdOrKey, issueTypeId, ...)` | `GET /rest/api/3/issue/createmeta/{projectIdOrKey}/issuetypes/{issueTypeId}` | Get fields for issue type |
+| `bulkFetchChangelogs(config, request)` | `POST /rest/api/3/changelog/bulkfetch` | Bulk fetch changelogs |
+
+### JiraSearchService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `searchIssues(config, request)` | `GET /rest/api/3/search` | Search issues using JQL |
+
+### JiraCommentService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getComments(config, issueIdOrKey, ...)` | `GET /rest/api/3/issue/{issueIdOrKey}/comment` | Get comments for an issue |
+| `getComment(config, issueIdOrKey, commentId, expand?)` | `GET /rest/api/3/issue/{issueIdOrKey}/comment/{commentId}` | Get a specific comment |
+| `addComment(config, issueIdOrKey, request, expand?)` | `POST /rest/api/3/issue/{issueIdOrKey}/comment` | Add a comment |
+| `updateComment(config, issueIdOrKey, commentId, request, expand?)` | `PUT /rest/api/3/issue/{issueIdOrKey}/comment/{commentId}` | Update a comment |
+| `deleteComment(config, issueIdOrKey, commentId)` | `DELETE /rest/api/3/issue/{issueIdOrKey}/comment/{commentId}` | Delete a comment |
+
+### JiraWorklogService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getWorklogs(config, issueIdOrKey, ...)` | `GET /rest/api/3/issue/{issueIdOrKey}/worklog` | Get worklogs for an issue |
+| `getWorklog(config, issueIdOrKey, worklogId, expand?)` | `GET /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}` | Get a specific worklog |
+| `addWorklog(config, issueIdOrKey, request, ...)` | `POST /rest/api/3/issue/{issueIdOrKey}/worklog` | Add a worklog |
+| `updateWorklog(config, issueIdOrKey, worklogId, request, ...)` | `PUT /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}` | Update a worklog |
+| `deleteWorklog(config, issueIdOrKey, worklogId, ...)` | `DELETE /rest/api/3/issue/{issueIdOrKey}/worklog/{worklogId}` | Delete a worklog |
+
+### JiraAttachmentService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getAttachments(config, issueIdOrKey)` | `GET /rest/api/3/issue/{issueIdOrKey}` | Get attachments for an issue |
+| `getAttachment(config, attachmentId)` | `GET /rest/api/3/attachment/{attachmentId}` | Get a specific attachment |
+| `addAttachment(config, issueIdOrKey, file, filename)` | `POST /rest/api/3/issue/{issueIdOrKey}/attachments` | Add an attachment |
+| `deleteAttachment(config, attachmentId)` | `DELETE /rest/api/3/attachment/{attachmentId}` | Delete an attachment |
+
+### JiraProjectService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getProjects(config, expand?, recent?, properties?)` | `GET /rest/api/3/project` | Get all projects |
+| `getProject(config, projectIdOrKey, expand?, properties?)` | `GET /rest/api/3/project/{projectIdOrKey}` | Get a project |
+| `getProjectAvatars(config, projectIdOrKey)` | `GET /rest/api/3/project/{projectIdOrKey}/avatars` | Get project avatars |
+| `getProjectComponents(config, projectIdOrKey)` | `GET /rest/api/3/project/{projectIdOrKey}/components` | Get project components |
+| `getProjectProperties(config, projectIdOrKey)` | `GET /rest/api/3/project/{projectIdOrKey}/properties` | Get project properties |
+| `getProjectProperty(config, projectIdOrKey, propertyKey)` | `GET /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey}` | Get a project property |
+| `setProjectProperty(config, projectIdOrKey, propertyKey, value)` | `PUT /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey}` | Set a project property |
+| `deleteProjectProperty(config, projectIdOrKey, propertyKey)` | `DELETE /rest/api/3/project/{projectIdOrKey}/properties/{propertyKey}` | Delete a project property |
+| `getProjectRoles(config, projectIdOrKey)` | `GET /rest/api/3/project/{projectIdOrKey}/role` | Get project roles |
+| `getProjectRole(config, projectIdOrKey, roleId)` | `GET /rest/api/3/project/{projectIdOrKey}/role/{roleId}` | Get a project role |
+| `getProjectStatuses(config, projectIdOrKey)` | `GET /rest/api/3/project/{projectIdOrKey}/statuses` | Get project statuses |
+| `getProjectVersions(config, projectIdOrKey, expand?)` | `GET /rest/api/3/project/{projectIdOrKey}/versions` | Get project versions |
+
+### JiraUserService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getUser(config, accountId, expand?)` | `GET /rest/api/3/user` | Get user by account ID |
+| `searchUsers(config, query, startAt?, maxResults?)` | `GET /rest/api/3/user/search` | Search for users |
+| `getUserPicker(config, query, ...)` | `GET /rest/api/3/user/picker` | Get user picker suggestions |
+| `getMyself(config, expand?)` | `GET /rest/api/3/myself` | Get current user |
+
+### JiraEventService
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `getEvents(config)` | `GET /rest/api/3/events` | Get all issue events (requires Administer Jira permission) |
+
+---
+
+## Type Definitions
+
+### JiraConfig
+
+```typescript
+interface JiraConfig {
+  auth: {
+    token: string;
+    user: string;
+  };
+  baseUrl?: string;
+}
+```
+
+### Common Types
+
+- `JiraIssue`: Complete issue object with fields, metadata, and properties
+- `JiraProject`: Project information
+- `JiraUser`: User information
+- `JiraComment`: Comment with ADF (Atlassian Document Format) support
+- `JiraWorklog`: Worklog entry for time tracking
+- `JiraAttachment`: File attachment information
+- `JiraSearchResult`: Search results with pagination
+- `JiraPageBean<T>`: Paginated response wrapper
+- `JiraWebhook`: Webhook information with events, filters, and expiration
+- `JiraFailedWebhook`: Failed webhook information for monitoring
+
+All types support the Atlassian Document Format (ADF) for rich text content in descriptions, comments, and other text fields.
+
+---
+
+## Error Handling
+
+The module includes comprehensive error handling that provides detailed information about:
+
+- **HTTP Status Codes**: Identifies error types (400, 401, 403, 404, 422, etc.)
+- **Error Messages**: Shows specific error messages from Jira API
+- **Validation Errors**: Lists fields that failed validation
+- **Contextual Information**: Includes endpoint, HTTP method, and request details
+- **Jira Error Collection**: Structured error responses from Jira
+
+### Example Error Handling
+
+```typescript
+try {
+  await this.issueService.createIssue(null, request);
+} catch (error: any) {
+  console.log(error.statusCode);      // HTTP status code
+  console.log(error.responseData);   // Full response data
+  console.log(error.message);        // Detailed error message
+}
+```
+
+---
+
+## Notes
+
+- **API Version**: This module uses Jira Cloud Platform REST API v3, which supports Atlassian Document Format (ADF) for rich text content
+- **Authentication**: Uses Basic Authentication with API token and user email
+- **Configuration**: All service methods accept `config: JiraConfig | null = null` as the first parameter. Pass `null` to use settings, or provide config for per-request authentication
+- **Type Safety**: All request and response types are fully typed for better IDE support and compile-time error checking
+- **Logging**: All API calls are automatically logged with timing information using `AppLogger` from `@venturialstd/core`
+- **Rate Limiting**: Be aware of Jira's rate limits when making multiple API calls
+- **Permissions**: Most operations require specific Jira permissions. Ensure your API token has the necessary permissions
+- **Bulk Operations**: Bulk operations have limits (e.g., 50 for create, 100 for fetch, 1000 for archive)
+- **ADF Format**: Descriptions, comments, and textarea custom fields use ADF format. Single-line text fields accept plain strings
+- **Pagination**: Many endpoints support pagination with `startAt` and `maxResults` parameters
+- **Expand Parameters**: Use `expand` parameters to include additional data in responses (e.g., `expand=names,renderedFields`)
+
+---
+
+## Examples
+
+### Create an Issue with ADF Description
+
+```typescript
+const issue = await this.issueService.createIssue(null, {
+  fields: {
+    project: { key: 'PROJ' },
+    summary: 'Fix critical bug',
+    description: {
+      type: 'doc',
+      version: 1,
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            { type: 'text', text: 'This is a ' },
+            { type: 'text', text: 'critical', marks: [{ type: 'strong' }] },
+            { type: 'text', text: ' bug that needs immediate attention.' },
+          ],
+        },
+      ],
+    },
+    issuetype: { name: 'Bug' },
+    priority: { name: 'Highest' },
+  },
+});
+```
+
+### Search Issues with JQL
+
+```typescript
+const results = await this.searchService.searchIssues(null, {
+  jql: 'project = PROJ AND status = "In Progress"',
+  maxResults: 50,
+  fields: ['summary', 'status', 'assignee'],
+});
+
+results.issues.forEach(issue => {
+  console.log(`${issue.key}: ${issue.fields.summary}`);
+});
+```
+
+### Add Worklog
+
+```typescript
+await this.worklogService.addWorklog(null, 'PROJ-123', {
+  timeSpent: '2h 30m',
+  started: '2024-01-15T10:00:00.000+0000',
+  comment: {
+    type: 'doc',
+    version: 1,
+    content: [
+      {
+        type: 'paragraph',
+        content: [{ type: 'text', text: 'Worked on fixing the bug' }],
+      },
+    ],
+  },
+});
+```
+
+### Transition an Issue
+
+```typescript
+await this.issueService.transitionIssue(null, 'PROJ-123', {
+  transition: { id: '21' },
+  fields: {
+    resolution: { name: 'Fixed' },
+  },
+  update: {
+    comment: [
+      {
+        add: {
+          body: {
+            type: 'doc',
+            version: 1,
+            content: [
+              {
+                type: 'paragraph',
+                content: [{ type: 'text', text: 'Issue has been resolved' }],
+              },
+            ],
+          },
+        },
+      },
+    ],
+  },
+});
+```
+
+### Register Webhooks
+
+```typescript
+const result = await this.webhookService.registerWebhooks(null, {
+  url: 'https://your-app.example.com/webhook-received',
+  webhooks: [
+    {
+      events: ['jira:issue_created', 'jira:issue_updated'],
+      jqlFilter: 'project = PROJ',
+      fieldIdsFilter: ['summary', 'customfield_10029'],
+    },
+    {
+      events: ['jira:issue_deleted'],
+      jqlFilter: 'project IN (PROJ, EXP) AND status = done',
+    },
+  ],
+});
+
+// Check registration results
+result.webhookRegistrationResult.forEach((result, index) => {
+  if (result.createdWebhookId) {
+    console.log(`Webhook ${index} registered with ID: ${result.createdWebhookId}`);
+  } else if (result.errors) {
+    console.error(`Webhook ${index} failed:`, result.errors);
+  }
+});
+```
+
+### Get and Manage Webhooks
+
+```typescript
+// Get all webhooks
+const webhooks = await this.webhookService.getWebhooks(null, {
+  startAt: 0,
+  maxResults: 50,
+});
+
+// Extend webhook life (webhooks expire after 30 days)
+await this.webhookService.extendWebhookLife(null, {
+  webhookIds: [10000, 10001],
+});
+
+// Get failed webhooks
+const failedWebhooks = await this.webhookService.getFailedWebhooks(null, {
+  maxResults: 100,
+  after: 1573118132000, // Optional: cursor for pagination
+});
+
+// Delete webhooks
+await this.webhookService.deleteWebhooks(null, {
+  webhookIds: [10000, 10001],
+});
+```
+
+---
+
+## License
+
+MIT
+
+---
+
+## Support
+
+For issues, questions, or contributions, please contact the Venturial development team.

package/dist/clients/jira.client.d.ts

@@ -0,0 +1,16 @@
+import { HttpService } from '@nestjs/axios';
+import { AppLogger, SettingsService } from '@venturialstd/core';
+import { AxiosInstance } from 'axios';
+import { HttpMethod } from '../constants/http-method.constant';
+import { JiraClientCredentials, JiraConfig } from '../types/jira.config.type';
+import { JiraQueryParams, JiraRequestBody } from '../types/jira-common.types';
+export declare class JiraClient {
+    private readonly httpService;
+    private readonly logger;
+    private readonly settingsService;
+    constructor(httpService: HttpService, logger: AppLogger, settingsService: SettingsService);
+    getCredentials(config?: JiraConfig | null): Promise<JiraClientCredentials>;
+    createApiClient(config?: JiraConfig | null): Promise<AxiosInstance>;
+    request<T>(method: HttpMethod, url: string, config?: JiraConfig | null, data?: JiraRequestBody, params?: JiraQueryParams): Promise<T>;
+}
+//# sourceMappingURL=jira.client.d.ts.map

package/dist/clients/jira.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.client.d.ts","sourceRoot":"","sources":["../../src/clients/jira.client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,aAAa,EAAuB,MAAM,OAAO,CAAC;AAI3D,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC9E,OAAO,EAAa,eAAe,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAEzF,qBACa,UAAU;IAEnB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,eAAe;gBAFf,WAAW,EAAE,WAAW,EACxB,MAAM,EAAE,SAAS,EACjB,eAAe,EAAE,eAAe;IAK7C,cAAc,CAAC,MAAM,GAAE,UAAU,GAAG,IAAW,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAwChF,eAAe,CAAC,MAAM,GAAE,UAAU,GAAG,IAAW,GAAG,OAAO,CAAC,aAAa,CAAC;IAezE,OAAO,CAAC,CAAC,EACb,MAAM,EAAE,UAAU,EAClB,GAAG,EAAE,MAAM,EACX,MAAM,GAAE,UAAU,GAAG,IAAW,EAChC,IAAI,CAAC,EAAE,eAAe,EACtB,MAAM,CAAC,EAAE,eAAe,GACvB,OAAO,CAAC,CAAC,CAAC;CAwBd"}

package/dist/clients/jira.client.js

@@ -0,0 +1,100 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var JiraClient_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JiraClient = void 0;
+const axios_1 = require("@nestjs/axios");
+const common_1 = require("@nestjs/common");
+const core_1 = require("@venturialstd/core");
+const rxjs_1 = require("rxjs");
+const jira_settings_constant_1 = require("../constants/jira.settings.constant");
+let JiraClient = JiraClient_1 = class JiraClient {
+    httpService;
+    logger;
+    settingsService;
+    constructor(httpService, logger, settingsService) {
+        this.httpService = httpService;
+        this.logger = logger;
+        this.settingsService = settingsService;
+        this.logger.setContext(JiraClient_1.name);
+    }
+    async getCredentials(config = null) {
+        if (config && config.auth) {
+            const baseUrl = config.baseUrl ||
+                (await this.settingsService.get(jira_settings_constant_1.JIRA_SETTING_KEYS.URL_JIRA_ISSUE_BASE));
+            if (!baseUrl) {
+                throw new Error('Jira base URL is required');
+            }
+            return {
+                token: config.auth.token,
+                user: config.auth.user,
+                baseUrl,
+            };
+        }
+        const jiraSettings = await this.settingsService.getManyWithDefaults([
+            jira_settings_constant_1.JIRA_SETTING_KEYS.CREDENTIALS_JIRA_TOKEN,
+            jira_settings_constant_1.JIRA_SETTING_KEYS.CREDENTIALS_JIRA_USER,
+            jira_settings_constant_1.JIRA_SETTING_KEYS.URL_JIRA_ISSUE_BASE,
+        ]);
+        const token = jiraSettings[jira_settings_constant_1.JIRA_SETTING_KEYS.CREDENTIALS_JIRA_TOKEN];
+        const user = jiraSettings[jira_settings_constant_1.JIRA_SETTING_KEYS.CREDENTIALS_JIRA_USER];
+        const baseUrl = jiraSettings[jira_settings_constant_1.JIRA_SETTING_KEYS.URL_JIRA_ISSUE_BASE];
+        if (!token || !user || !baseUrl) {
+            throw new Error('Jira credentials not configured. Please provide credentials in config or set JIRA_SETTING_KEYS in settings.');
+        }
+        return {
+            token,
+            user,
+            baseUrl,
+        };
+    }
+    async createApiClient(config = null) {
+        const credentials = await this.getCredentials(config);
+        const jiraAuth = Buffer.from(`${credentials.user}:${credentials.token}`).toString('base64');
+        return this.httpService.axiosRef.create({
+            baseURL: credentials.baseUrl,
+            headers: {
+                Authorization: `Basic ${jiraAuth}`,
+                'Content-Type': 'application/json',
+                Accept: 'application/json',
+            },
+        });
+    }
+    async request(method, url, config = null, data, params) {
+        const apiClient = await this.createApiClient(config);
+        try {
+            const response = await (0, rxjs_1.firstValueFrom)(this.httpService.request({
+                method,
+                url: `${apiClient.defaults.baseURL}${url}`,
+                headers: {
+                    ...apiClient.defaults.headers,
+                },
+                data,
+                params,
+            }));
+            this.logger?.log(`Response OK: ${method} ${url}`);
+            return response.data;
+        }
+        catch (error) {
+            const jiraError = error;
+            this.logger.error(`Error on request: ${method} ${url} - ${jiraError instanceof Error ? jiraError : new Error(jiraError?.message || 'Unknown error')}`);
+            throw error;
+        }
+    }
+};
+exports.JiraClient = JiraClient;
+exports.JiraClient = JiraClient = JiraClient_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __metadata("design:paramtypes", [axios_1.HttpService,
+        core_1.AppLogger,
+        core_1.SettingsService])
+], JiraClient);
+//# sourceMappingURL=jira.client.js.map

package/dist/clients/jira.client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jira.client.js","sourceRoot":"","sources":["../../src/clients/jira.client.ts"],"names":[],"mappings":"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"}

package/dist/constants/http-method.constant.d.ts

@@ -0,0 +1,8 @@
+export declare enum HttpMethod {
+    GET = "GET",
+    POST = "POST",
+    PUT = "PUT",
+    DELETE = "DELETE",
+    PATCH = "PATCH"
+}
+//# sourceMappingURL=http-method.constant.d.ts.map

package/dist/constants/http-method.constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-method.constant.d.ts","sourceRoot":"","sources":["../../src/constants/http-method.constant.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,GAAG,QAAQ;IACX,IAAI,SAAS;IACb,GAAG,QAAQ;IACX,MAAM,WAAW;IACjB,KAAK,UAAU;CAChB"}

package/dist/constants/http-method.constant.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpMethod = void 0;
+var HttpMethod;
+(function (HttpMethod) {
+    HttpMethod["GET"] = "GET";
+    HttpMethod["POST"] = "POST";
+    HttpMethod["PUT"] = "PUT";
+    HttpMethod["DELETE"] = "DELETE";
+    HttpMethod["PATCH"] = "PATCH";
+})(HttpMethod || (exports.HttpMethod = HttpMethod = {}));
+//# sourceMappingURL=http-method.constant.js.map

package/dist/constants/http-method.constant.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-method.constant.js","sourceRoot":"","sources":["../../src/constants/http-method.constant.ts"],"names":[],"mappings":";;;AAAA,IAAY,UAMX;AAND,WAAY,UAAU;IACpB,yBAAW,CAAA;IACX,2BAAa,CAAA;IACb,yBAAW,CAAA;IACX,+BAAiB,CAAA;IACjB,6BAAe,CAAA;AACjB,CAAC,EANW,UAAU,0BAAV,UAAU,QAMrB"}