@jira-deploy/core 1.0.15 → 1.0.17

package/constants/config.js

@@ -28,6 +28,7 @@ const DEFAULT_DEPLOY_CONFIG = {
       deptManagerSign: 'customfield_dept_manager_sign',
       authManagerSign: 'customfield_auth_manager_sign',
       releaseInfo: 'customfield_release_info',
+      buildResult: 'customfield_build_result',
     },
     cd: {
       systemSubmodule: 'customfield_system_submodule',
@@ -49,12 +50,12 @@ const DEFAULT_DEPLOY_CONFIG = {
       antiScanRequired: 'customfield_anti_scan_required',
       ciNotes: 'customfield_ci_notes',
       releaseVersion: 'customfield_release_version',
+      uploadResult: 'customfield_13452',
     },
     grayRelease: {
       grayReleaseVersion: 'customfield_grayrelease_version',
       clusterList: 'customfield_cluster_list',
       grayReleaseNotes: 'customfield_grayrelease_notes',
-      buildResult: 'customfield_build_result',
       deployResult: 'customfield_deploy_result',
     },
   },
@@ -112,11 +113,22 @@ const DEFAULT_DEPLOY_CONFIG = {
   },
   release: {
     managerSubCalendarId: '',
+    birthdayCalendarId: '',
+    leaveCalendarId: '',
     dryRunManager: { name: 'Demo User', accountId: 'demo-user' },
     grayReleaseUatApprovers: {
       commentReviewerAlias: 'uat-comment-reviewer',
       finalApproverAlias: 'uat-final-approver',
     },
+    managerSubstitutes: {},
+    cdApprovers: {
+      prd: {
+        leadReviewerAliases: [],
+        secondReviewerAlias: '',
+        thirdReviewerAlias: '',
+        finalApproverAlias: '',
+      },
+    },
   },
   jabber: {
     domain: 'example.internal',
@@ -124,6 +136,7 @@ const DEFAULT_DEPLOY_CONFIG = {
 };
 
 let cachedConfig;
+let runtimeConfigEnv = EMPTY_OBJECT;
 
 function parseJsonConfig(value, source) {
   try {
@@ -157,16 +170,32 @@ function expandHomePath(filePath) {
 }
 
 function loadExternalConfig() {
-  if (process.env.JIRA_DEPLOY_CONFIG_PATH) {
-    const configPath = expandHomePath(process.env.JIRA_DEPLOY_CONFIG_PATH);
+  const deployConfigPath = getRuntimeConfigValue('JIRA_DEPLOY_CONFIG_PATH');
+  if (deployConfigPath) {
+    const configPath = expandHomePath(deployConfigPath);
     return parseJsonConfig(
       readFileSync(configPath, 'utf8'),
-      `JIRA_DEPLOY_CONFIG_PATH (${process.env.JIRA_DEPLOY_CONFIG_PATH})`,
+      `JIRA_DEPLOY_CONFIG_PATH (${deployConfigPath})`,
     );
   }
   return EMPTY_OBJECT;
 }
 
+export function configureRuntimeConfig({env = EMPTY_OBJECT} = {}) {
+  runtimeConfigEnv = Object.freeze({...env});
+  cachedConfig = undefined;
+}
+
+export function getRuntimeConfigValue(key) {
+  return runtimeConfigEnv[key] ?? process.env[key];
+}
+
+export function getRuntimeConfigNumber(key, fallback) {
+  const value = getRuntimeConfigValue(key);
+  const parsed = Number.parseInt(value ?? '', 10);
+  return Number.isFinite(parsed) ? parsed : fallback;
+}
+
 export function getDeployConfig() {
   if (!cachedConfig) {
     cachedConfig = deepMerge(DEFAULT_DEPLOY_CONFIG, loadExternalConfig());
@@ -175,7 +204,7 @@ export function getDeployConfig() {
 }
 
 export function getReleaseProjectKey() {
-  return process.env.JIRA_RELEASE_PROJECT_KEY ?? getDeployConfig().jira.releaseProjectKey;
+  return getRuntimeConfigValue('JIRA_RELEASE_PROJECT_KEY') ?? getDeployConfig().jira.releaseProjectKey;
 }
 
 export function resetDeployConfigForTests() {

package/constants/issue-types.js

@@ -1,4 +1,4 @@
-import {getDeployConfig} from './config.js';
+import {getDeployConfig, getRuntimeConfigValue} from './config.js';
 
 const config = getDeployConfig();
 
@@ -8,4 +8,4 @@ export const ISSUE_TYPE_IDS = config.issueTypes.ids;
 
 export const JIRA_PROJECT_ID_NUMERIC = config.jira.projectIdNumeric;
 
-export const JIRA_PROJECT_ID = process.env.JIRA_PROJECT_KEY ?? config.jira.projectKey;
+export const JIRA_PROJECT_ID = getRuntimeConfigValue('JIRA_PROJECT_KEY') ?? config.jira.projectKey;

package/index.js

@@ -3,4 +3,4 @@ export {Notifier} from './notifier.js';
 export {Poller} from './poller.js';
 export {getPlatformConfig, PLATFORM_TO_SYSTEM_CODE, PLATFORMS} from './platform-config.js';
 export {getToolDefinitions, executeTool} from './tools/index.js';
-export {getClusterList, ok, error, today} from './tools/helpers.js';
+export {getServerList, ok, error, today} from './tools/helpers.js';

package/jira-client.js

@@ -1,13 +1,17 @@
 import axios from 'axios';
 import https from 'https';
+import {getRuntimeConfigValue} from './constants/config.js';
 
-const httpsAgent = new https.Agent({rejectUnauthorized: false});
+const httpsAgent = new https.Agent({ rejectUnauthorized: false });
 
-const DRY_RUN = process.env.DRY_RUN === 'true';
+function isDryRun() {
+  return getRuntimeConfigValue('DRY_RUN') === 'true';
+}
 
 export class JiraClient {
   constructor() {
-    const {JIRA_BASE_URL, JIRA_API_TOKEN} = process.env;
+    const JIRA_BASE_URL = getRuntimeConfigValue('JIRA_BASE_URL');
+    const JIRA_API_TOKEN = getRuntimeConfigValue('JIRA_API_TOKEN');
     if (!JIRA_BASE_URL || !JIRA_API_TOKEN) {
       throw new Error('Missing required Jira env vars: JIRA_BASE_URL, JIRA_API_TOKEN');
     }
@@ -20,7 +24,7 @@ export class JiraClient {
         Authorization: `Bearer ${JIRA_API_TOKEN}`,
       },
     });
-    this.dryRun = DRY_RUN;
+    this.dryRun = isDryRun();
     this.fieldIdByName = new Map();
   }
 
@@ -28,9 +32,9 @@ export class JiraClient {
   async createIssue(fields) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.createIssue', JSON.stringify(fields).slice(0, 1000));
-      return {id: 'DRY-RUN', key: 'DRY-RUN', self: ''};
+      return { id: 'DRY-RUN', key: 'DRY-RUN', self: '' };
     }
-    const res = await this.http.post('/issue', {fields}).catch((err) => {
+    const res = await this.http.post('/issue', { fields }).catch((err) => {
       const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
       throw new Error(`Create issue failed: ${detail}`);
     });
@@ -45,22 +49,22 @@ export class JiraClient {
         issueKey,
         JSON.stringify(fields).slice(0, 1000),
       );
-      return {issueKey, updated: Object.keys(fields)};
+      return { issueKey, updated: Object.keys(fields) };
     }
-    await this.http.put(`/issue/${issueKey}`, {fields});
-    return {issueKey, updated: Object.keys(fields)};
+    await this.http.put(`/issue/${issueKey}`, { fields });
+    return { issueKey, updated: Object.keys(fields) };
   }
 
   // 更新 Assignee（使用專用 endpoint，Jira Server 相容）
   async updateAssignee(issueKey, accountId) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.updateAssignee', issueKey, accountId);
-      return {issueKey, accountId};
+      return { issueKey, accountId };
     }
-    await this.http.put(`/issue/${issueKey}/assignee`, {name: accountId}).catch(async (err) => {
+    await this.http.put(`/issue/${issueKey}/assignee`, { name: accountId }).catch(async (err) => {
       // 若 name 格式失敗，改試 accountId 格式（Jira Cloud）
       if (err.response?.status === 400) {
-        await this.http.put(`/issue/${issueKey}/assignee`, {accountId}).catch((e) => {
+        await this.http.put(`/issue/${issueKey}/assignee`, { accountId }).catch((e) => {
           const detail = e.response?.data ? JSON.stringify(e.response.data) : e.message;
           throw new Error(`updateAssignee failed: ${detail}`);
         });
@@ -69,18 +73,18 @@ export class JiraClient {
         throw new Error(`updateAssignee failed: ${detail}`);
       }
     });
-    return {issueKey, accountId};
+    return { issueKey, accountId };
   }
 
   // 查詢 issue 目前狀態
   async getIssue(issueKey) {
     const res = await this.http.get(`/issue/${issueKey}`, {
-      params: {fields: 'status,summary,assignee,comment'},
+      params: { fields: 'status,summary,assignee,comment' },
     });
     return res.data;
   }
 
-  // 取得可執行的 transitions
+  // 取得當前狀態可執行的 transitions (可以執行的狀態切換列表)
   async getTransitions(issueKey) {
     const res = await this.http.get(`/issue/${issueKey}/transitions`);
     return res.data.transitions; // [{ id, name, to: { name } }]
@@ -89,7 +93,7 @@ export class JiraClient {
   // 查詢 issue 的指定欄位（例如取得 CI 單的 CID_release_version）
   async getIssueFields(issueKey, fields = []) {
     const res = await this.http.get(`/issue/${issueKey}`, {
-      params: {fields: fields.join(',')},
+      params: { fields: fields.join(',') },
     });
     return res.data.fields;
   }
@@ -110,24 +114,24 @@ export class JiraClient {
   async transitionById(issueKey, transitionId) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.transitionById', issueKey, transitionId);
-      return {issueKey, transitionId};
+      return { issueKey, transitionId };
     }
     await this.http
       .post(`/issue/${issueKey}/transitions`, {
-        transition: {id: transitionId},
+        transition: { id: transitionId },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
         throw new Error(`Transition id=${transitionId} failed: ${detail}`);
       });
-    return {issueKey, transitionId};
+    return { issueKey, transitionId };
   }
 
   // 依名稱切換狀態（不用記 id）
   async transitionByName(issueKey, transitionName) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.transitionByName', issueKey, transitionName);
-      return {issueKey, transitioned: transitionName, toStatus: 'DRY'};
+      return { issueKey, transitioned: transitionName, toStatus: 'DRY' };
     }
     const transitions = await this.getTransitions(issueKey);
     const match = transitions.find((t) => t.name.toLowerCase() === transitionName.toLowerCase());
@@ -137,34 +141,34 @@ export class JiraClient {
     }
     await this.http
       .post(`/issue/${issueKey}/transitions`, {
-        transition: {id: match.id},
+        transition: { id: match.id },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
         throw new Error(`Transition "${match.name}" failed: ${detail}`);
       });
-    return {issueKey, transitioned: match.name, toStatus: match.to.name};
+    return { issueKey, transitioned: match.name, toStatus: match.to.name };
   }
 
   // 新增 issue link（relates to / blocks / is blocked by 等）
   async linkIssue(inwardKey, outwardKey, linkTypeName = 'Relates') {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.linkIssue', inwardKey, outwardKey, linkTypeName);
-      return {inwardKey, outwardKey, linkType: linkTypeName};
+      return { inwardKey, outwardKey, linkType: linkTypeName };
     }
     await this.http.post('/issueLink', {
-      type: {name: linkTypeName},
-      inwardIssue: {key: inwardKey},
-      outwardIssue: {key: outwardKey},
+      type: { name: linkTypeName },
+      inwardIssue: { key: inwardKey },
+      outwardIssue: { key: outwardKey },
     });
-    return {inwardKey, outwardKey, linkType: linkTypeName};
+    return { inwardKey, outwardKey, linkType: linkTypeName };
   }
 
   // 新增 comment（/rest/api/2 用純文字 body）
   async addComment(issueKey, text) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.addComment', issueKey, text);
-      return {issueKey, body: text};
+      return { issueKey, body: text };
     }
     const res = await this.http.post(`/issue/${issueKey}/comment`, {
       body: text,
@@ -176,11 +180,11 @@ export class JiraClient {
   async addRemoteLink(issueKey, url, title) {
     if (this.dryRun) {
       console.log('[DRY RUN] JiraClient.addRemoteLink', issueKey, url, title);
-      return {issueKey, url, title};
+      return { issueKey, url, title };
     }
     const res = await this.http
       .post(`/issue/${issueKey}/remotelink`, {
-        object: {url, title},
+        object: { url, title },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -197,7 +201,7 @@ export class JiraClient {
   //
   // status: 'unreleased'
   // query:  相當於 UI 的 contains 參數（版本名稱包含此字串，不分大小寫）
-  async getProjectVersions(projectKey, {name = {}}) {
+  async getProjectVersions(projectKey, { name = {} }) {
     const res = await this.http.get(`/project/${projectKey}/versions`);
     let versions = res.data ?? [];
 
@@ -231,7 +235,7 @@ export class JiraClient {
   async getSubTasks(issueKey) {
     const res = await this.http
       .get(`/issue/${issueKey}`, {
-        params: {fields: 'subtasks,issuetype'},
+        params: { fields: 'subtasks,issuetype' },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -244,7 +248,7 @@ export class JiraClient {
   async searchIssues(jql, fields = [], maxResults = 10) {
     const res = await this.http
       .get('/search', {
-        params: {jql, fields: fields.join(','), maxResults},
+        params: { jql, fields: fields.join(','), maxResults },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -255,7 +259,7 @@ export class JiraClient {
 
   // 取得 Bitbucket repo 的原始檔案內容（Bitbucket REST API 1.0）
   async getBitbucketFileContent(project, repo, filePath, branch) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    const BB_BASE = getRuntimeConfigValue('BITBUCKET_URL') ?? getRuntimeConfigValue('BITBUCKET_BASE_URL');
     if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/raw/${filePath}`;
     const res = await axios
@@ -263,9 +267,9 @@ export class JiraClient {
         httpsAgent,
         headers: {
           Accept: 'text/plain',
-          Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
+          Authorization: `Bearer ${getRuntimeConfigValue('BITBUCKET_API_TOKEN')}`,
         },
-        params: {at: branch},
+        params: { at: branch },
         responseType: 'text',
       })
       .catch((err) => {
@@ -279,9 +283,9 @@ export class JiraClient {
   async getBitbucketTags(
     project,
     repo,
-    {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
+    { filterValue = '', orderBy = 'MODIFICATION', limit = 1 } = {},
   ) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    const BB_BASE = getRuntimeConfigValue('BITBUCKET_URL') ?? getRuntimeConfigValue('BITBUCKET_BASE_URL');
     if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/tags`;
     const res = await axios
@@ -290,9 +294,9 @@ export class JiraClient {
         headers: {
           'Content-Type': 'application/json',
           Accept: 'application/json',
-          Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
+          Authorization: `Bearer ${getRuntimeConfigValue('BITBUCKET_API_TOKEN')}`,
         },
-        params: {filterValue, orderBy, limit},
+        params: { filterValue, orderBy, limit },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -305,9 +309,9 @@ export class JiraClient {
   async getBitbucketBranches(
     project,
     repo,
-    {filterValue = '', orderBy = 'MODIFICATION', limit = 1} = {},
+    { filterValue = '', orderBy = 'MODIFICATION', limit = 1 } = {},
   ) {
-    const BB_BASE = process.env.BITBUCKET_URL ?? process.env.BITBUCKET_BASE_URL;
+    const BB_BASE = getRuntimeConfigValue('BITBUCKET_URL') ?? getRuntimeConfigValue('BITBUCKET_BASE_URL');
     if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
     const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/branches`;
     const res = await axios
@@ -316,9 +320,9 @@ export class JiraClient {
         headers: {
           'Content-Type': 'application/json',
           Accept: 'application/json',
-          Authorization: `Bearer ${process.env.BITBUCKET_API_TOKEN}`,
+          Authorization: `Bearer ${getRuntimeConfigValue('BITBUCKET_API_TOKEN')}`,
         },
-        params: {filterValue, orderBy, limit},
+        params: { filterValue, orderBy, limit },
       })
       .catch((err) => {
         const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
@@ -326,4 +330,35 @@ export class JiraClient {
       });
     return res.data?.values ?? [];
   }
+
+  // 取得 Bitbucket repo 的 pull requests（Bitbucket REST API 1.0）
+  async getBitbucketPullRequests(
+    project,
+    repo,
+    { branch = '', state = 'OPEN', limit = 100 } = {},
+  ) {
+    const BB_BASE = getRuntimeConfigValue('BITBUCKET_URL') ?? getRuntimeConfigValue('BITBUCKET_BASE_URL');
+    if (!BB_BASE) throw new Error('Missing required Bitbucket env var: BITBUCKET_URL');
+    const url = `${BB_BASE}/rest/api/1.0/projects/${project}/repos/${repo}/pull-requests`;
+    const res = await axios
+      .get(url, {
+        httpsAgent,
+        headers: {
+          'Content-Type': 'application/json',
+          Accept: 'application/json',
+          Authorization: `Bearer ${getRuntimeConfigValue('BITBUCKET_API_TOKEN')}`,
+        },
+        params: {
+          state,
+          limit,
+          direction: 'OUTGOING',
+          ...(branch ? { at: `refs/heads/${branch}` } : {}),
+        },
+      })
+      .catch((err) => {
+        const detail = err.response?.data ? JSON.stringify(err.response.data) : err.message;
+        throw new Error(`getBitbucketPullRequests failed: ${detail}`);
+      });
+    return res.data?.values ?? [];
+  }
 }

package/notifier.js

@@ -5,12 +5,13 @@
  * 擴充 Slack：填入 .env 的 SLACK_BOT_TOKEN + SLACK_CHANNEL_ID 後，
  *             把下方 notifySlack 的 TODO 實作即可，其他地方不用動。
  */
+import {getRuntimeConfigValue} from './constants/config.js';
 
 export class Notifier {
   constructor(jiraClient) {
     this.jira = jiraClient;
-    this.slackEnabled = !!process.env.SLACK_BOT_TOKEN && !!process.env.SLACK_CHANNEL_ID;
-    this.dryRun = process.env.DRY_RUN === 'true';
+    this.slackEnabled = !!getRuntimeConfigValue('SLACK_BOT_TOKEN') && !!getRuntimeConfigValue('SLACK_CHANNEL_ID');
+    this.dryRun = getRuntimeConfigValue('DRY_RUN') === 'true';
   }
 
   async notify(issueKey, message) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jira-deploy/core",
-  "version": "1.0.15",
+  "version": "1.0.17",
   "type": "module",
   "main": "./index.js",
   "repository": {
@@ -11,24 +11,31 @@
   "exports": {
     ".": "./index.js",
     "./constants": "./constants/index.js",
+    "./runtime-config": "./constants/config.js",
     "./jira-client": "./jira-client.js",
     "./notifier": "./notifier.js",
     "./poller": "./poller.js",
     "./platform-config": "./platform-config.js",
     "./tools": "./tools/index.js",
+    "./tools/build": "./tools/build.js",
     "./tools/helpers": "./tools/helpers.js",
     "./tools/library": "./tools/library.js"
   },
   "files": [
     "constants/**/*.js",
     "scripts/jabber_notify.py",
+    "tools/branch-prs.js",
+    "tools/build.js",
     "tools/cd.js",
     "tools/ci.js",
+    "tools/deployment.js",
+    "tools/deployment-helpers.js",
     "tools/grayrelease.js",
     "tools/helpers.js",
     "tools/index.js",
     "tools/jabber.js",
     "tools/library.js",
+    "tools/transition-helpers.js",
     "tools/release.js",
     "tools/workflows.js",
     "index.js",
@@ -42,6 +49,6 @@
     "dotenv": "^16.3.0"
   },
   "scripts": {
-    "test": "node --import ./test-env.js --test tools.test.js tools/jabber.test.js config.test.js"
+    "test": "node --import ./test-env.js --test tools.test.js tools/jabber.test.js tools/transition-helpers.test.js config.test.js"
   }
 }

package/platform-config.js

@@ -6,6 +6,7 @@
  */
 
 import {SYSTEM_CODES, GRAY_RELEASE_MODULE_IDS} from './constants/index.js';
+import {getRuntimeConfigValue} from './constants/config.js';
 import {getServerList} from './tools/helpers.js';
 
 /**
@@ -27,7 +28,7 @@ export function getPlatformConfig(platformName, environment = 'stg') {
   if (!systemCode) {
     console.warn(`Unknown platform: ${platformName}, using defaults`);
     return {
-      projectKey: process.env.JIRA_PROJECT_KEY ?? 'OPS',
+      projectKey: getRuntimeConfigValue('JIRA_PROJECT_KEY') ?? 'OPS',
       systemCode: undefined,
       clusters: [],
       environment,

package/poller.js

@@ -1,3 +1,5 @@
+import {getRuntimeConfigNumber} from './constants/config.js';
+
 /**
  * Poller — 輪詢等待 Jira issue 達到目標狀態
  *
@@ -19,8 +21,8 @@ export class Poller {
    * @returns {{ issueKey, status, elapsedMs, attempts }}
    */
   async waitForStatus(issueKey, targetStatus, options = {}) {
-    const intervalMs = options.intervalMs ?? parseInt(process.env.POLL_INTERVAL_MS ?? '30000');
-    const timeoutMs = options.timeoutMs ?? parseInt(process.env.POLL_TIMEOUT_MS ?? '3600000');
+    const intervalMs = options.intervalMs ?? getRuntimeConfigNumber('POLL_INTERVAL_MS', 30000);
+    const timeoutMs = options.timeoutMs ?? getRuntimeConfigNumber('POLL_TIMEOUT_MS', 3600000);
     const progress = typeof options.onProgress === 'function' ? options.onProgress : () => {};
 
     const startTime = Date.now();