@esm-js/jira.js/src/version2/appMigration.ts

A comprehensive JavaScript/TypeScript library designed for both Node.JS and browsers, facilitating seamless interaction with the Atlassian Jira API.

import type * as Models from './models';
import type * as Parameters from './parameters';
import type { Client } from '../clients';
import type { Callback } from '../callback';
import type { RequestConfig } from '../requestConfig';

export class AppMigration {
  constructor(private client: Client) {}

  /**
   * Updates the value of a custom field added by Connect apps on one or more issues. The values of up to 200 custom
   * fields can be updated.
   *
   * **[Permissions](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#permissions) required:** Only
   * Connect apps can make this request
   */
  async updateIssueFields<T = unknown>(parameters: Parameters.UpdateIssueFields, callback: Callback<T>): Promise<void>;
  /**
   * Updates the value of a custom field added by Connect apps on one or more issues. The values of up to 200 custom
   * fields can be updated.
   *
   * **[Permissions](https://developer.atlassian.com/cloud/jira/platform/rest/v2/intro/#permissions) required:** Only
   * Connect apps can make this request
   */
  async updateIssueFields<T = unknown>(parameters: Parameters.UpdateIssueFields, callback?: never): Promise<T>;
  async updateIssueFields<T = unknown>(
    parameters: Parameters.UpdateIssueFields,
    callback?: Callback<T>,
  ): Promise<void | T> {
    const config: RequestConfig = {
      url: '/rest/atlassian-connect/1/migration/field',
      method: 'PUT',
      headers: {
        'Atlassian-Account-Id': parameters.accountId,
        'Atlassian-Transfer-Id': parameters.transferId,
      },
      data: {
        updateValueList: parameters.updateValueList,
      },
    };

    return this.client.sendRequest(config, callback);
  }

  /**
   * Updates the values of multiple entity properties for an object, up to 50 updates per request. This operation is for
   * use by Connect apps during app migration.
   */
  async updateEntityPropertiesValue<T = unknown>(
    parameters: Parameters.UpdateEntityPropertiesValue,
    callback: Callback<T>,
  ): Promise<void>;
  /**
   * Updates the values of multiple entity properties for an object, up to 50 updates per request. This operation is for
   * use by Connect apps during app migration.
   */
  async updateEntityPropertiesValue<T = unknown>(
    parameters: Parameters.UpdateEntityPropertiesValue,
    callback?: never,
  ): Promise<T>;
  async updateEntityPropertiesValue<T = unknown>(
    parameters: Parameters.UpdateEntityPropertiesValue,
    callback?: Callback<T>,
  ): Promise<void | T> {
    const config: RequestConfig = {
      url: `/rest/atlassian-connect/1/migration/properties/${parameters.entityType}`,
      method: 'PUT',
      headers: {
        'Atlassian-Account-Id': parameters.accountId,
        'Atlassian-Transfer-Id': parameters.transferId,
        'Content-Type': 'application/json',
      },
      data: parameters.entities,
    };

    return this.client.sendRequest(config, callback);
  }

  /**
   * Returns configurations for workflow transition rules migrated from server to cloud and owned by the calling Connect
   * app.
   */
  async workflowRuleSearch<T = Models.WorkflowRulesSearchDetails>(
    parameters: Parameters.WorkflowRuleSearch,
    callback: Callback<T>,
  ): Promise<void>;
  /**
   * Returns configurations for workflow transition rules migrated from server to cloud and owned by the calling Connect
   * app.
   */
  async workflowRuleSearch<T = Models.WorkflowRulesSearchDetails>(
    parameters: Parameters.WorkflowRuleSearch,
    callback?: never,
  ): Promise<T>;
  async workflowRuleSearch<T = Models.WorkflowRulesSearchDetails>(
    parameters: Parameters.WorkflowRuleSearch,
    callback?: Callback<T>,
  ): Promise<void | T> {
    const config: RequestConfig = {
      url: '/rest/atlassian-connect/1/migration/workflow/rule/search',
      method: 'POST',
      headers: {
        'Atlassian-Transfer-Id': parameters.transferId,
      },
      data: {
        expand: parameters.expand,
        ruleIds: parameters.ruleIds,
        workflowEntityId: parameters.workflowEntityId,
      },
    };

    return this.client.sendRequest(config, callback);
  }
}