@commandable/integration-data 0.0.6 → 0.0.7

package/integrations/jira/__tests__/write_handlers.test.ts

@@ -0,0 +1,157 @@
+import { afterAll, beforeAll, describe, expect, it } from 'vitest'
+import { createCredentialStore, createIntegrationNode, createProxy, createToolbox, hasEnv, safeCleanup } from '../../__tests__/liveHarness.js'
+
+// LIVE Jira write tests using credentials
+//
+// Required for write tests:
+// - JIRA_TEST_PROJECT_KEY
+//
+// Variant: api_token
+// - JIRA_DOMAIN
+// - JIRA_EMAIL
+// - JIRA_API_TOKEN
+//
+// Optional:
+// - JIRA_TEST_TRANSITION_NAME (enables transition_issue)
+// - JIRA_TEST_BOARD_ID (enables sprint roundtrip: create_sprint -> update_sprint -> move_issues_to_sprint -> update_sprint)
+
+const env = process.env as Record<string, string | undefined>
+
+const suiteOrSkip = (hasEnv('JIRA_DOMAIN', 'JIRA_EMAIL', 'JIRA_API_TOKEN') && hasEnv('JIRA_TEST_PROJECT_KEY'))
+  ? describe
+  : describe.skip
+
+suiteOrSkip('jira write handlers (live)', () => {
+  describe('variant: api_token', () => {
+      const ctx: {
+        createdIssueKey?: string
+        createdSprintId?: number
+      } = {}
+
+      let jira: ReturnType<typeof createToolbox>
+
+      beforeAll(async () => {
+        const credentialStore = createCredentialStore(async () => ({
+          domain: env.JIRA_DOMAIN!,
+          email: env.JIRA_EMAIL!,
+          apiToken: env.JIRA_API_TOKEN!,
+        }))
+        const proxy = createProxy(credentialStore)
+        jira = createToolbox('jira', proxy, createIntegrationNode('jira', { label: 'Jira', credentialId: 'jira-creds', credentialVariant: 'api_token' }), 'api_token')
+      }, 60000)
+
+      afterAll(async () => {
+        await safeCleanup(async () => {
+          if (!ctx.createdSprintId)
+            return
+          const update_sprint = jira.write('update_sprint')
+          await update_sprint({ sprintId: ctx.createdSprintId, state: 'closed' })
+        })
+        await safeCleanup(async () => {
+          if (!ctx.createdIssueKey)
+            return
+          const delete_issue = jira.write('delete_issue')
+          await delete_issue({ issueIdOrKey: ctx.createdIssueKey })
+        })
+      }, 60000)
+
+      it('create_issue -> get_issue -> update_issue -> add_comment -> get_issue_comments (and optional assign/transition) roundtrip', async () => {
+        const get_myself = jira.read('get_myself')
+        const me = await get_myself({})
+        expect(me?.accountId).toBeTruthy()
+
+        const get_project = jira.read('get_project')
+        const project = await get_project({ projectIdOrKey: env.JIRA_TEST_PROJECT_KEY, expandIssueTypes: true })
+        const issueTypes = Array.isArray(project?.issueTypes) ? project.issueTypes : []
+        const picked = issueTypes.find((t: any) => t && t.subtask === false) || issueTypes[0]
+        if (!picked?.id && !picked?.name)
+          return expect(true).toBe(true)
+
+        const create_issue = jira.write('create_issue')
+        const created = await create_issue({
+          projectKey: env.JIRA_TEST_PROJECT_KEY,
+          issueTypeId: picked?.id || undefined,
+          issueTypeName: picked?.id ? undefined : (picked?.name || undefined),
+          summary: `CmdTest ${Date.now()}`,
+          descriptionText: 'Created by integration tests.',
+          assigneeAccountId: me.accountId,
+          labels: ['cmdtest'],
+        })
+        const issueKey = created?.key || created?.id
+        expect(issueKey).toBeTruthy()
+        ctx.createdIssueKey = created?.key || created?.id
+
+        const get_issue = jira.read('get_issue')
+        const got = await get_issue({ issueIdOrKey: issueKey })
+        expect(got?.key).toBeTruthy()
+
+        const update_issue = jira.write('update_issue')
+        const updated = await update_issue({
+          issueIdOrKey: issueKey,
+          summary: `CmdTest Updated ${Date.now()}`,
+          descriptionText: 'Updated by integration tests.',
+        })
+        expect(updated?.success === true || updated).toBeTruthy()
+
+        const add_comment = jira.write('add_comment')
+        const commentText = `Test comment ${Date.now()}`
+        const comment = await add_comment({ issueIdOrKey: issueKey, bodyText: commentText })
+        expect(comment?.id).toBeTruthy()
+
+        const get_issue_comments = jira.read('get_issue_comments')
+        const comments = await get_issue_comments({ issueIdOrKey: issueKey, maxResults: 20 })
+        const found = (comments?.comments || []).some((c: any) =>
+          (c?.bodyMarkdown && String(c.bodyMarkdown).includes('Test comment'))
+          || (c?.bodyText && String(c.bodyText).includes('Test comment')),
+        )
+        expect(found).toBe(true)
+
+        const assign_issue = jira.write('assign_issue')
+        const assigned = await assign_issue({ issueIdOrKey: issueKey, accountId: me.accountId })
+        expect(assigned?.success === true || assigned).toBeTruthy()
+        const unassigned = await assign_issue({ issueIdOrKey: issueKey, accountId: null })
+        expect(unassigned?.success === true || unassigned).toBeTruthy()
+
+        if (env.JIRA_TEST_TRANSITION_NAME) {
+          const transition_issue = jira.write('transition_issue')
+          const transitioned = await transition_issue({
+            issueIdOrKey: issueKey,
+            transitionName: env.JIRA_TEST_TRANSITION_NAME,
+            commentText: 'Transitioned by integration tests.',
+          })
+          expect(transitioned?.success === true || transitioned).toBeTruthy()
+        }
+      }, 120000)
+
+      it('sprint roundtrip: create_sprint -> update_sprint (start) -> move_issues_to_sprint -> update_sprint (close) (optional)', async () => {
+        if (!env.JIRA_TEST_BOARD_ID || !ctx.createdIssueKey)
+          return expect(true).toBe(true)
+        const boardId = Number(env.JIRA_TEST_BOARD_ID)
+        if (!Number.isFinite(boardId))
+          return expect(true).toBe(true)
+
+        const create_sprint = jira.write('create_sprint')
+        const name = `CmdTest Sprint ${Date.now()}`
+        const sprint = await create_sprint({ boardId, name })
+        const sprintId = sprint?.id
+        expect(typeof sprintId).toBe('number')
+        ctx.createdSprintId = sprintId
+
+        const update_sprint = jira.write('update_sprint')
+        const today = new Date().toISOString().slice(0, 10)
+        const twoWeeks = new Date(Date.now() + 14 * 24 * 60 * 60 * 1000).toISOString().slice(0, 10)
+        const started = await update_sprint({ sprintId, state: 'active', startDate: today, endDate: twoWeeks })
+        expect(started?.state === 'active' || started?.id === sprintId || started).toBeTruthy()
+
+        const move_issues_to_sprint = jira.write('move_issues_to_sprint')
+        const moved = await move_issues_to_sprint({ sprintId, issueKeys: [ctx.createdIssueKey] })
+        expect(moved?.success === true || moved).toBeTruthy()
+
+        const closed = await update_sprint({ sprintId, state: 'closed' })
+        expect(closed?.state === 'closed' || closed?.id === sprintId || closed).toBeTruthy()
+        ctx.createdSprintId = undefined
+      }, 120000)
+
+  })
+})
+

package/integrations/jira/credentials.json

@@ -0,0 +1,39 @@
+{
+  "variants": {
+    "api_token": {
+      "label": "API Token (Email + Token)",
+      "schema": {
+        "type": "object",
+        "properties": {
+          "domain": {
+            "type": "string",
+            "title": "Jira site domain",
+            "description": "The subdomain of your Jira Cloud site. Example: for https://mycompany.atlassian.net, enter 'mycompany'."
+          },
+          "email": {
+            "type": "string",
+            "title": "Atlassian account email",
+            "description": "Email address of the Atlassian account that owns the API token."
+          },
+          "apiToken": {
+            "type": "string",
+            "title": "Atlassian API token",
+            "description": "Atlassian API token for Jira Cloud. The server will convert this into the required Basic auth header."
+          }
+        },
+        "required": ["domain", "email", "apiToken"],
+        "additionalProperties": false
+      },
+      "baseUrlTemplate": "https://{{domain}}.atlassian.net",
+      "injection": {
+        "headers": {
+          "Authorization": "Basic {{basicAuth}}",
+          "Accept": "application/json"
+        }
+      },
+      "preprocess": "jira_api_token"
+    }
+  },
+  "default": "api_token"
+}
+

package/integrations/jira/credentials_hint.md

@@ -0,0 +1,4 @@
+Recommended: use **API Token (Email + Token)** unless you specifically need OAuth.
+
+If you have multiple credential variants available, select one and follow its setup instructions.
+

package/integrations/jira/credentials_hint_api_token.md

@@ -0,0 +1,6 @@
+1. Open your Jira Cloud site in the browser (it looks like `https://YOUR_DOMAIN.atlassian.net`).
+2. Copy `YOUR_DOMAIN` (the subdomain) and use it as `domain`.
+3. Create an Atlassian API token at `https://id.atlassian.com/manage-profile/security/api-tokens`.
+4. Use the same Atlassian account email as `email` and paste the token as `apiToken`.
+5. Ensure the Atlassian account has access to the Jira projects you want to work with.
+

package/integrations/jira/credentials_hint_oauth_token.md

@@ -0,0 +1,6 @@
+1. Create an OAuth 2.0 (3LO) app in the Atlassian developer console.
+2. Add Jira scopes (typical minimum): `read:jira-work`, `write:jira-work`, `read:jira-user` (and `offline_access` if you want refresh tokens).
+3. Complete the OAuth flow to obtain an access token.
+4. Discover your `cloudId` by calling `GET https://api.atlassian.com/oauth/token/accessible-resources` with `Authorization: Bearer <access_token>` and using the returned `id`.
+5. Paste `cloudId` and the current OAuth `token` here.
+

package/integrations/jira/handlers/add_comment.js

@@ -0,0 +1,9 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/comment`, {
+    method: 'POST',
+    body: { body: utils.adf?.fromMarkdown(input.bodyText) },
+  })
+
+  return await res.json()
+}
+

package/integrations/jira/handlers/assign_issue.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/assignee`, {
+    method: 'PUT',
+    body: { accountId: input.accountId },
+  })
+
+  if (res.status === 204)
+    return { success: true }
+  return await res.json()
+}
+

package/integrations/jira/handlers/create_issue.js

@@ -0,0 +1,37 @@
+async (input) => {
+  const fields = {
+    project: { key: input.projectKey },
+    summary: input.summary,
+  }
+
+  if (input.descriptionText)
+    fields.description = utils.adf?.fromMarkdown(input.descriptionText)
+
+  if (input.issueTypeId) {
+    fields.issuetype = { id: String(input.issueTypeId) }
+  }
+  else if (input.issueTypeName) {
+    fields.issuetype = { name: String(input.issueTypeName) }
+  }
+  else {
+    throw new Error(`Missing issue type. Provide issueTypeId or issueTypeName (call get_project to discover available issue types).`)
+  }
+
+  if (input.priorityId)
+    fields.priority = { id: input.priorityId }
+  else if (input.priorityName)
+    fields.priority = { name: input.priorityName }
+
+  if (Array.isArray(input.labels))
+    fields.labels = input.labels
+
+  if (input.assigneeAccountId)
+    fields.assignee = { accountId: input.assigneeAccountId }
+
+  const res = await integration.fetch('/rest/api/3/issue', {
+    method: 'POST',
+    body: { fields },
+  })
+
+  return await res.json()
+}

package/integrations/jira/handlers/create_sprint.js

@@ -0,0 +1,19 @@
+async (input) => {
+  const body = {
+    originBoardId: input.boardId,
+    name: input.name,
+  }
+  if (input.startDate)
+    body.startDate = input.startDate
+  if (input.endDate)
+    body.endDate = input.endDate
+  if (input.goal)
+    body.goal = input.goal
+
+  const res = await integration.fetch('/rest/agile/1.0/sprint', {
+    method: 'POST',
+    body,
+  })
+  return await res.json()
+}
+

package/integrations/jira/handlers/delete_issue.js

@@ -0,0 +1,10 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}`, {
+    method: 'DELETE',
+  })
+
+  if (res.status === 204)
+    return { success: true }
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_backlog_issues.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.jql)
+    params.set('jql', input.jql)
+  if (Array.isArray(input.fields) && input.fields.length)
+    params.set('fields', input.fields.join(','))
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const res = await integration.fetch(`/rest/agile/1.0/board/${encodeURIComponent(String(input.boardId))}/backlog?${params.toString()}`)
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_board.js

@@ -0,0 +1,6 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/agile/1.0/board/${encodeURIComponent(String(input.boardId))}`)
+  const data = await res.json()
+  return data
+}
+

package/integrations/jira/handlers/get_issue.js

@@ -0,0 +1,63 @@
+async (input) => {
+  const defaultFields = [
+    'summary',
+    'status',
+    'assignee',
+    'priority',
+    'issuetype',
+    'project',
+    'description',
+    'created',
+    'updated',
+    'labels',
+  ]
+
+  const fields = Array.isArray(input.fields) && input.fields.length ? input.fields : defaultFields
+  const params = new URLSearchParams()
+  if (fields?.length)
+    params.set('fields', fields.join(','))
+  if (Array.isArray(input.expand) && input.expand.length)
+    params.set('expand', input.expand.join(','))
+
+  const path = `/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}${params.toString() ? `?${params.toString()}` : ''}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+
+  const descAdf = data?.fields?.description
+  const descMarkdown = utils.adf?.toMarkdown(descAdf) || ''
+  const descText = descMarkdown ? '' : (utils.adf?.toPlainText(descAdf) || '')
+
+  return {
+    id: data.id ?? null,
+    key: data.key ?? null,
+    self: data.self ?? null,
+    summary: data.fields?.summary ?? null,
+    status: data.fields?.status
+      ? {
+          id: data.fields.status.id ?? null,
+          name: data.fields.status.name ?? null,
+          category: data.fields.status.statusCategory
+            ? {
+                key: data.fields.status.statusCategory.key ?? null,
+                name: data.fields.status.statusCategory.name ?? null,
+              }
+            : null,
+        }
+      : null,
+    assignee: data.fields?.assignee
+      ? {
+          accountId: data.fields.assignee.accountId ?? null,
+          displayName: data.fields.assignee.displayName ?? null,
+        }
+      : null,
+    priority: data.fields?.priority ? { id: data.fields.priority.id ?? null, name: data.fields.priority.name ?? null } : null,
+    issueType: data.fields?.issuetype ? { id: data.fields.issuetype.id ?? null, name: data.fields.issuetype.name ?? null } : null,
+    project: data.fields?.project ? { id: data.fields.project.id ?? null, key: data.fields.project.key ?? null, name: data.fields.project.name ?? null } : null,
+    labels: Array.isArray(data.fields?.labels) ? data.fields.labels : [],
+    descriptionMarkdown: descMarkdown || null,
+    descriptionText: descMarkdown ? null : (descText || null),
+    created: data.fields?.created ?? null,
+    updated: data.fields?.updated ?? null,
+  }
+}
+

package/integrations/jira/handlers/get_issue_comments.js

@@ -0,0 +1,31 @@
+async (input) => {
+  const params = new URLSearchParams()
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const path = `/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/comment?${params.toString()}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+  const comments = Array.isArray(data.comments) ? data.comments : []
+
+  return {
+    startAt: data.startAt ?? (input.startAt ?? 0),
+    maxResults: data.maxResults ?? (input.maxResults ?? 50),
+    total: data.total ?? comments.length,
+    comments: comments.map((c) => {
+      const md = utils.adf?.toMarkdown(c.body) || ''
+      const text = md ? '' : (utils.adf?.toPlainText(c.body) || '')
+      return {
+        id: c.id ?? null,
+        created: c.created ?? null,
+        updated: c.updated ?? null,
+        author: c.author
+          ? { accountId: c.author.accountId ?? null, displayName: c.author.displayName ?? null }
+          : null,
+        bodyMarkdown: md || null,
+        bodyText: md ? null : (text || null),
+      }
+    }),
+  }
+}
+

package/integrations/jira/handlers/get_myself.js

@@ -0,0 +1,14 @@
+async (_input) => {
+  const res = await integration.fetch('/rest/api/3/myself')
+  const data = await res.json()
+
+  return {
+    accountId: data.accountId ?? null,
+    displayName: data.displayName ?? null,
+    active: data.active ?? null,
+    timeZone: data.timeZone ?? null,
+    locale: data.locale ?? null,
+    emailAddress: data.emailAddress ?? null,
+  }
+}
+

package/integrations/jira/handlers/get_project.js

@@ -0,0 +1,28 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.expandIssueTypes !== false)
+    params.set('expand', 'issueTypes')
+
+  const path = `/rest/api/3/project/${encodeURIComponent(input.projectIdOrKey)}${params.toString() ? `?${params.toString()}` : ''}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+
+  const issueTypes = Array.isArray(data.issueTypes) ? data.issueTypes : []
+
+  return {
+    id: data.id ?? null,
+    key: data.key ?? null,
+    name: data.name ?? null,
+    projectTypeKey: data.projectTypeKey ?? null,
+    simplified: data.simplified ?? null,
+    style: data.style ?? null,
+    isPrivate: data.isPrivate ?? null,
+    issueTypes: issueTypes.map(t => ({
+      id: t.id ?? null,
+      name: t.name ?? null,
+      description: t.description ?? null,
+      subtask: t.subtask ?? null,
+    })),
+  }
+}
+

package/integrations/jira/handlers/get_sprint.js

@@ -0,0 +1,5 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/agile/1.0/sprint/${encodeURIComponent(String(input.sprintId))}`)
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_sprint_issues.js

@@ -0,0 +1,13 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input.jql)
+    params.set('jql', input.jql)
+  if (Array.isArray(input.fields) && input.fields.length)
+    params.set('fields', input.fields.join(','))
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const res = await integration.fetch(`/rest/agile/1.0/sprint/${encodeURIComponent(String(input.sprintId))}/issue?${params.toString()}`)
+  return await res.json()
+}
+

package/integrations/jira/handlers/get_transitions.js

@@ -0,0 +1,23 @@
+async (input) => {
+  const path = `/rest/api/3/issue/${encodeURIComponent(input.issueIdOrKey)}/transitions`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+  const transitions = Array.isArray(data.transitions) ? data.transitions : []
+
+  return {
+    transitions: transitions.map(t => ({
+      id: t.id ?? null,
+      name: t.name ?? null,
+      to: t.to
+        ? {
+            id: t.to.id ?? null,
+            name: t.to.name ?? null,
+            statusCategory: t.to.statusCategory
+              ? { key: t.to.statusCategory.key ?? null, name: t.to.statusCategory.name ?? null }
+              : null,
+          }
+        : null,
+    })),
+  }
+}
+

package/integrations/jira/handlers/list_boards.js

@@ -0,0 +1,34 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input?.projectKeyOrId)
+    params.set('projectKeyOrId', input.projectKeyOrId)
+  if (input?.type)
+    params.set('type', input.type)
+  params.set('startAt', String(input?.startAt ?? 0))
+  params.set('maxResults', String(input?.maxResults ?? 50))
+
+  const res = await integration.fetch(`/rest/agile/1.0/board?${params.toString()}`)
+  const data = await res.json()
+  const values = Array.isArray(data.values) ? data.values : []
+
+  return {
+    startAt: data.startAt ?? (input?.startAt ?? 0),
+    maxResults: data.maxResults ?? (input?.maxResults ?? 50),
+    total: data.total ?? values.length,
+    isLast: Boolean(data.isLast),
+    boards: values.map(b => ({
+      id: b.id ?? null,
+      name: b.name ?? null,
+      type: b.type ?? null,
+      location: b.location
+        ? {
+            projectId: b.location.projectId ?? null,
+            projectKey: b.location.projectKey ?? null,
+            projectName: b.location.projectName ?? null,
+          }
+        : null,
+      self: b.self ?? null,
+    })),
+  }
+}
+

package/integrations/jira/handlers/list_projects.js

@@ -0,0 +1,29 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (input?.query)
+    params.set('query', input.query)
+  params.set('startAt', String(input?.startAt ?? 0))
+  params.set('maxResults', String(input?.maxResults ?? 50))
+
+  const path = `/rest/api/3/project/search?${params.toString()}`
+  const res = await integration.fetch(path)
+  const data = await res.json()
+  const values = Array.isArray(data.values) ? data.values : []
+
+  return {
+    startAt: data.startAt ?? (input?.startAt ?? 0),
+    maxResults: data.maxResults ?? (input?.maxResults ?? 50),
+    total: data.total ?? values.length,
+    isLast: Boolean(data.isLast),
+    projects: values.map(p => ({
+      id: p.id ?? null,
+      key: p.key ?? null,
+      name: p.name ?? null,
+      projectTypeKey: p.projectTypeKey ?? null,
+      simplified: p.simplified ?? null,
+      style: p.style ?? null,
+      isPrivate: p.isPrivate ?? null,
+    })),
+  }
+}
+

package/integrations/jira/handlers/list_sprints.js

@@ -0,0 +1,29 @@
+async (input) => {
+  const params = new URLSearchParams()
+  if (Array.isArray(input.state) && input.state.length)
+    params.set('state', input.state.join(','))
+  params.set('startAt', String(input.startAt ?? 0))
+  params.set('maxResults', String(input.maxResults ?? 50))
+
+  const res = await integration.fetch(`/rest/agile/1.0/board/${encodeURIComponent(String(input.boardId))}/sprint?${params.toString()}`)
+  const data = await res.json()
+  const values = Array.isArray(data.values) ? data.values : []
+
+  return {
+    startAt: data.startAt ?? (input.startAt ?? 0),
+    maxResults: data.maxResults ?? (input.maxResults ?? 50),
+    total: data.total ?? values.length,
+    isLast: Boolean(data.isLast),
+    sprints: values.map(s => ({
+      id: s.id ?? null,
+      name: s.name ?? null,
+      state: s.state ?? null,
+      goal: s.goal ?? null,
+      startDate: s.startDate ?? null,
+      endDate: s.endDate ?? null,
+      completeDate: s.completeDate ?? null,
+      self: s.self ?? null,
+    })),
+  }
+}
+

package/integrations/jira/handlers/move_issues_to_sprint.js

@@ -0,0 +1,11 @@
+async (input) => {
+  const res = await integration.fetch(`/rest/agile/1.0/sprint/${encodeURIComponent(String(input.sprintId))}/issue`, {
+    method: 'POST',
+    body: { issues: input.issueKeys },
+  })
+
+  if (res.status === 204)
+    return { success: true }
+  return await res.json()
+}
+

package/integrations/jira/handlers/search_issues.js

@@ -0,0 +1,43 @@
+async (input) => {
+  const body = {
+    jql: input.jql,
+    maxResults: input.maxResults ?? 50,
+  }
+
+  if (Array.isArray(input.fields) && input.fields.length)
+    body.fields = input.fields
+  if (input.nextPageToken)
+    body.nextPageToken = input.nextPageToken
+
+  const res = await integration.fetch('/rest/api/3/search/jql', {
+    method: 'POST',
+    body,
+  })
+
+  const data = await res.json()
+  const issues = Array.isArray(data.issues) ? data.issues : []
+
+  return {
+    isLast: Boolean(data.isLast),
+    nextPageToken: data.nextPageToken ?? null,
+    issues: issues.map((i) => ({
+      id: i.id,
+      key: i.key,
+      summary: i.fields?.summary ?? null,
+      status: i.fields?.status?.name ?? null,
+      assignee: i.fields?.assignee
+        ? {
+            accountId: i.fields.assignee.accountId ?? null,
+            displayName: i.fields.assignee.displayName ?? null,
+          }
+        : null,
+      priority: i.fields?.priority?.name ?? null,
+      issueType: i.fields?.issuetype?.name ?? null,
+      project: i.fields?.project
+        ? { key: i.fields.project.key ?? null, name: i.fields.project.name ?? null }
+        : null,
+      updated: i.fields?.updated ?? null,
+    })),
+  }
+}
+