@jira-deploy/core 1.0.0

package/tools/release.test.js

@@ -0,0 +1,137 @@
+/**
+ * handleWaitForComment 單元測試
+ * 執行：node --test src/tools/release.test.js
+ */
+import { test } from 'node:test'
+import assert from 'node:assert/strict'
+import { handleWaitForComment } from './release.js'
+
+// ── helpers ───────────────────────────────────────────────────────
+// ok() → { content: [{ type:'text', text: JSON }] }
+// error() → same shape but text starts with ❌
+
+function parseOk(result) {
+  return JSON.parse(result.content[0].text)
+}
+
+function isError(result) {
+  return result.content[0].text.startsWith('❌')
+}
+
+function errorText(result) {
+  return result.content[0].text
+}
+
+/** 製作一個 jira mock，getComments 第 callsUntilMatch 次回傳含關鍵字的 comment */
+function makeJira({ callsUntilMatch = 1, keyword = 'Approved', author = 'BK00178' } = {}) {
+  let calls = 0
+  return {
+    getComments: async () => {
+      calls++
+      if (calls >= callsUntilMatch) {
+        return [
+          {
+            body: `${keyword} by manager`,
+            author: { name: author, displayName: 'James Yu' },
+          },
+        ]
+      }
+      return []
+    },
+  }
+}
+
+/** 製作永遠回空的 jira mock（用於 timeout 測試） */
+function makeJiraEmpty() {
+  return { getComments: async () => [] }
+}
+
+const BASE_ARGS = {
+  issueKey: 'CID-9999',
+  keyword: 'Approved',
+  intervalMs: 0, // 零延遲，測試瞬間完成
+}
+
+// ── Tests ─────────────────────────────────────────────────────────
+
+test('dryRun 模式 → 立即回傳 found:true，不呼叫 Jira', async () => {
+  let called = false
+  const jira = {
+    getComments: async () => {
+      called = true
+      return []
+    },
+  }
+  const result = await handleWaitForComment({ ...BASE_ARGS, dryRun: true }, { jira })
+  const data = parseOk(result)
+  assert.equal(data.found, true)
+  assert.equal(data.dryRun, true)
+  assert.equal(data.attempts, 1)
+  assert.equal(data.elapsedMs, 0)
+  assert.equal(called, false, 'dryRun 時不應呼叫 jira.getComments')
+})
+
+test('第一次 poll 就找到關鍵字 → found:true', async () => {
+  const result = await handleWaitForComment(BASE_ARGS, { jira: makeJira({ callsUntilMatch: 1 }) })
+  const data = parseOk(result)
+  assert.equal(data.found, true)
+  assert.equal(data.issueKey, 'CID-9999')
+  assert.equal(data.keyword, 'Approved')
+  assert.equal(data.attempts, 1)
+})
+
+test('第 3 次 poll 才找到關鍵字 → found:true，attempts === 3', async () => {
+  const result = await handleWaitForComment(BASE_ARGS, {
+    jira: makeJira({ callsUntilMatch: 3 }),
+  })
+  const data = parseOk(result)
+  assert.equal(data.found, true)
+  assert.equal(data.attempts, 3)
+})
+
+test('關鍵字大小寫不分 → 能匹配', async () => {
+  const jira = makeJira({ keyword: 'APPROVED' })
+  const result = await handleWaitForComment(
+    { ...BASE_ARGS, keyword: 'approved' },
+    { jira },
+  )
+  assert.equal(parseOk(result).found, true)
+})
+
+test('author filter 相符 → found:true', async () => {
+  const result = await handleWaitForComment(
+    { ...BASE_ARGS, authorAccountId: 'BK00178' },
+    { jira: makeJira({ author: 'BK00178' }) },
+  )
+  assert.equal(parseOk(result).found, true)
+})
+
+test('author filter 不相符 → timeout error（超短 timeout）', async () => {
+  // comment 存在但 author 不符，永遠匹配不到
+  const jira = makeJira({ author: 'SOMEONE_ELSE' })
+  const result = await handleWaitForComment(
+    { ...BASE_ARGS, authorAccountId: 'BK00178', timeoutMs: 20, intervalMs: 5 },
+    { jira },
+  )
+  assert.ok(isError(result), '應回傳 error')
+  assert.match(result.content[0].text, /Timeout/)
+})
+
+test('永遠找不到關鍵字 → timeout error', async () => {
+  const result = await handleWaitForComment(
+    { ...BASE_ARGS, timeoutMs: 20, intervalMs: 5 },
+    { jira: makeJiraEmpty() },
+  )
+  assert.ok(isError(result), '應回傳 error')
+  assert.match(result.content[0].text, /Timeout/)
+  assert.match(result.content[0].text, /Approved/)
+})
+
+test('timeout error 包含輪詢次數資訊', async () => {
+  const result = await handleWaitForComment(
+    { ...BASE_ARGS, timeoutMs: 20, intervalMs: 5 },
+    { jira: makeJiraEmpty() },
+  )
+  assert.ok(isError(result), '應回傳 error')
+  assert.match(errorText(result), /次輪詢/)
+})