@valiantys/atlassian-app 3.2.0-alpha-7 → 3.2.0-alpha-9

package/atlassian/jira/shared/data-access-issue/src/lib/jira-issue-service/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=class a{constructor(e){this.fetchSvc=e}async updateProperty(e,t,s){return this.fetchSvc.fetch({method:"PUT",url:this.fetchSvc.route`/rest/api/3/issue/${e}/properties/${t}`},s)}async updateField(e,t,s){await this.updateFields(e,{[t]:s})}async updateFields(e,t){await this.updateIssue(e,{fields:t})}async getIssueField(e,t){var s;return(s=await this.getIssueFields(e,[t]))==null?void 0:s[t]}async getIssueFields(e,t){return(await this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}?fields=${t.join(",")}`})).fields}async getIssue(e,t=["*all"],s=!1){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}?fields=${t.join(",")}&expand=${s?"renderedFields":""}`})}async issueSearch(e,t,s=50){let c;const r=[];do{const h=await this.issueSearchByPage(e,t,c,s);r.push(...h.issues),c=h.nextPageToken}while(c!==void 0);return r}async issueSearchByPage(e,t,s,c=50){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/search/jql`},{fields:t,jql:e,maxResults:c,nextPageToken:s})}async addWorklog(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/worklog`},t)}async queryForIssuesInProjects(e){const t=`project IN (${e.join(",")})`;return this.issueSearch(t,["key","project"],5e3)}async createIssue(e){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue`},e)}async updateIssue(e,t){return this.fetchSvc.fetch({method:"PUT",url:this.fetchSvc.route`/rest/api/3/issue/${e}`},t)}async getIssueComments(e,t=0){const s=t?`?startAt=${t}`:"";return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment${s}`})}async getIssueCommentById(e,t){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment/${t}`})}async addIssueComment(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment`},{body:t})}async transitionIssue(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/transitions`},t)}async createIssueLink(e){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issueLink`},e)}async getIssueTypes(){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetype`})}async getIssueTypeSchemes({maxResults:e,orderBy:t,startAt:s,expand:c,id:r,queryString:h}={}){const i=new URLSearchParams;return c&&i.append("expand",c),e&&i.append("maxResults",e.toString()),t&&i.append("orderBy",t),s&&i.append("startAt",s.toString()),r&&r.forEach(n=>i.append("id",n)),h&&i.append("queryString",h),this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetypescheme?${i}`})}async getIssueTypeSchemesForProject({maxResults:e,startAt:t,projectId:s}={}){const c=new URLSearchParams;return e&&c.append("maxResults",e.toString()),t&&c.append("startAt",t.toString()),s&&s.forEach(r=>c.append("projectId",r)),this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetypescheme/project?${c}`})}};a.issueUrl="/rest/api/3/issue";let u=a;exports.JiraIssueService=u;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=class a{constructor(e){this.fetchSvc=e}async updateProperty(e,t,s){return this.fetchSvc.fetch({method:"PUT",url:this.fetchSvc.route`/rest/api/3/issue/${e}/properties/${t}`},s)}async updateField(e,t,s){await this.updateFields(e,{[t]:s})}async updateFields(e,t){await this.updateIssue(e,{fields:t})}async getIssueField(e,t){var s;return(s=await this.getIssueFields(e,[t]))==null?void 0:s[t]}async getIssueFields(e,t){return(await this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}?fields=${t.join(",")}`})).fields}async getIssue(e,t=["*all"],s=!1){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}?fields=${t.join(",")}&expand=${s?"renderedFields":""}`})}async getBulkIssues(e,t=["*all"]){return(await this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/bulkfetch`},{issueIdsOrKeys:e,fields:t})).issues}async issueSearch(e,t,s=50){let c;const r=[];do{const h=await this.issueSearchByPage(e,t,c,s);r.push(...h.issues),c=h.nextPageToken}while(c!==void 0);return r}async issueSearchByPage(e,t,s,c=50){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/search/jql`},{fields:t,jql:e,maxResults:c,nextPageToken:s})}async addWorklog(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/worklog`},t)}async queryForIssuesInProjects(e){const t=`project IN (${e.join(",")})`;return this.issueSearch(t,["key","project"],5e3)}async createIssue(e){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue`},e)}async updateIssue(e,t){return this.fetchSvc.fetch({method:"PUT",url:this.fetchSvc.route`/rest/api/3/issue/${e}`},t)}async getIssueComments(e,t=0){const s=t?`?startAt=${t}`:"";return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment${s}`})}async getIssueCommentById(e,t){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment/${t}`})}async addIssueComment(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/comment`},{body:t})}async transitionIssue(e,t){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issue/${e}/transitions`},t)}async createIssueLink(e){return this.fetchSvc.fetch({method:"POST",url:this.fetchSvc.route`/rest/api/3/issueLink`},e)}async getIssueTypes(){return this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetype`})}async getIssueTypeSchemes({maxResults:e,orderBy:t,startAt:s,expand:c,id:r,queryString:h}={}){const i=new URLSearchParams;return c&&i.append("expand",c),e&&i.append("maxResults",e.toString()),t&&i.append("orderBy",t),s&&i.append("startAt",s.toString()),r&&r.forEach(n=>i.append("id",n)),h&&i.append("queryString",h),this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetypescheme?${i}`})}async getIssueTypeSchemesForProject({maxResults:e,startAt:t,projectId:s}={}){const c=new URLSearchParams;return e&&c.append("maxResults",e.toString()),t&&c.append("startAt",t.toString()),s&&s.forEach(r=>c.append("projectId",r)),this.fetchSvc.fetch({method:"GET",url:this.fetchSvc.route`/rest/api/3/issuetypescheme/project?${c}`})}};a.issueUrl="/rest/api/3/issue";let u=a;exports.JiraIssueService=u;

package/atlassian/jira/shared/data-access-issue/src/lib/jira-issue-service/index.es.js

@@ -33,6 +33,15 @@ const u = class u {
       url: this.fetchSvc.route`/rest/api/3/issue/${e}?fields=${t.join(",")}&expand=${s ? "renderedFields" : ""}`
     });
   }
+  async getBulkIssues(e, t = ["*all"]) {
+    return (await this.fetchSvc.fetch(
+      {
+        method: "POST",
+        url: this.fetchSvc.route`/rest/api/3/issue/bulkfetch`
+      },
+      { issueIdsOrKeys: e, fields: t }
+    )).issues;
+  }
   async issueSearch(e, t, s = 50) {
     let c;
     const r = [];

package/atlassian/jira/shared/util-jira-v3-api/src/lib/issue/index.cjs.js

@@ -1 +1 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a="fixVersions";function e(t){return t.type==="paragraph"}function o(t){return t.type==="text"}exports.FIX_VERSIONS_FIELD=a;exports.isAtlassianDocumentFormatParagraphNode=e;exports.isAtlassianDocumentFormatTextNode=o;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const e="fixVersions";exports.FIX_VERSIONS_FIELD=e;

package/atlassian/jira/shared/util-jira-v3-api/src/lib/issue/index.es.js

@@ -1,12 +1,4 @@
-const a = "fixVersions";
-function e(t) {
-  return t.type === "paragraph";
-}
-function n(t) {
-  return t.type === "text";
-}
+const o = "fixVersions";
 export {
-  a as FIX_VERSIONS_FIELD,
-  e as isAtlassianDocumentFormatParagraphNode,
-  n as isAtlassianDocumentFormatTextNode
+  o as FIX_VERSIONS_FIELD
 };

package/atlassian/shared/util-adf/src/lib/adf/index.cjs.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});function c(n,t){var r,e;for(const o of n)if(o.text!==void 0&&o.text.includes(t)||(e=(r=o.attrs)==null?void 0:r.text)!=null&&e.includes(t)||o.content&&c(o.content,t))return!0;return!1}function a(n,t){return c(n.content,t)}function u(n,t,r){return n.map(e=>{var o;return e.text!==void 0?{...e,text:e.text.replaceAll(t,r)}:((o=e.attrs)==null?void 0:o.text)!==void 0?{...e,attrs:{...e.attrs,text:e.attrs.text.replaceAll(t,r)}}:e.content?{...e,content:u(e.content,t,r)}:e})}function f(n,t,r){return{...n,content:u(n.content,t,r)}}function i(n,t){const r={type:"text",text:t};return{...n,content:[...n.content,{type:"paragraph",content:[r]}]}}function p(n){return{type:"doc",version:1,content:[{type:"paragraph",content:[{type:"text",text:n}]}]}}exports.appendParagraph=i;exports.replaceInAdf=f;exports.searchAdf=a;exports.toAdfDoc=p;

package/atlassian/shared/util-adf/src/lib/adf/index.es.js

@@ -0,0 +1,59 @@
+function c(e, t) {
+  var r, n;
+  for (const o of e)
+    if (o.text !== void 0 && o.text.includes(t) || (n = (r = o.attrs) == null ? void 0 : r.text) != null && n.includes(t) || o.content && c(o.content, t))
+      return !0;
+  return !1;
+}
+function f(e, t) {
+  return c(e.content, t);
+}
+function u(e, t, r) {
+  return e.map((n) => {
+    var o;
+    return n.text !== void 0 ? { ...n, text: n.text.replaceAll(t, r) } : ((o = n.attrs) == null ? void 0 : o.text) !== void 0 ? {
+      ...n,
+      attrs: {
+        ...n.attrs,
+        text: n.attrs.text.replaceAll(t, r)
+      }
+    } : n.content ? {
+      ...n,
+      content: u(n.content, t, r)
+    } : n;
+  });
+}
+function i(e, t, r) {
+  return {
+    ...e,
+    content: u(e.content, t, r)
+  };
+}
+function a(e, t) {
+  const r = { type: "text", text: t };
+  return {
+    ...e,
+    content: [...e.content, { type: "paragraph", content: [r] }]
+  };
+}
+function p(e) {
+  return {
+    type: "doc",
+    version: 1,
+    content: [
+      {
+        type: "paragraph",
+        content: [{
+          type: "text",
+          text: e
+        }]
+      }
+    ]
+  };
+}
+export {
+  a as appendParagraph,
+  i as replaceInAdf,
+  f as searchAdf,
+  p as toAdfDoc
+};

package/backend-trigger/index.d.ts

@@ -1,22 +1,46 @@
 import { WebTriggerRequest } from '@forge/api/out/webTrigger';
 import { WebTriggerResponse } from '@forge/api/out/webTrigger';
 
-declare interface AtlassianDocumentFormat {
+/** Root document node */
+declare interface AdfDoc {
     type: 'doc';
-    version: number;
-    content: AtlassianDocumentFormatNode[];
+    version: 1;
+    content: AdfNode[];
 }
 
-declare interface AtlassianDocumentFormatBlockNode {
+/**
+ * TypeScript types for Atlassian Document Format (ADF)
+ * Conforms to https://unpkg.com/@atlaskit/adf-schema@52.4.0/dist/json-schema/v1/full.json
+ */
+declare interface AdfMark {
     type: string;
-    content: AtlassianDocumentFormatNode[];
+    attrs?: Record<string, unknown>;
 }
 
-declare interface AtlassianDocumentFormatInlineNode {
+/**
+ * Base for all ADF nodes. `content` is optional because many block nodes
+ * (paragraph, heading, codeBlock, etc.) define it as optional in the schema.
+ * `text` is only populated on text nodes. `attrs` is present on most non-text
+ * nodes. `marks` is present on nodes that support formatting.
+ */
+declare interface AdfNode {
     type: string;
+    text?: string;
+    attrs?: AdfNodeAttrs;
+    content?: AdfNode[];
+    marks?: AdfMark[];
 }
 
-declare type AtlassianDocumentFormatNode = AtlassianDocumentFormatInlineNode | AtlassianDocumentFormatBlockNode;
+/**
+ * Attrs common across node types. Many inline node types (emoji, mention,
+ * status, placeholder, hardBreak, inlineExtension, extension, bodiedExtension)
+ * store their display text in `attrs.text`.
+ */
+declare interface AdfNodeAttrs {
+    text?: string;
+    localId?: string;
+    [key: string]: unknown;
+}
 
 declare interface AvatarUrls {
     '48x48': string;
@@ -43,7 +67,7 @@ declare interface FixVersion {
 
 declare type FixVersions = FixVersion[];
 
-declare interface Issue<T = AtlassianDocumentFormat> {
+declare interface Issue<T = AdfDoc> {
     id: string;
     expand?: string;
     key: string;
@@ -52,7 +76,7 @@ declare interface Issue<T = AtlassianDocumentFormat> {
     renderedFields?: IssueFields<string>;
 }
 
-declare type IssueFields<T = AtlassianDocumentFormat> = CustomFields & StaticIssueFields<T>;
+declare type IssueFields<T = AdfDoc> = CustomFields & StaticIssueFields<T>;
 
 declare interface IssueLink {
     id: string;
@@ -138,7 +162,7 @@ declare interface Project {
     lead?: User;
 }
 
-declare interface StaticIssueFields<T = AtlassianDocumentFormat> {
+declare interface StaticIssueFields<T = AdfDoc> {
     statuscategorychangedate?: string;
     fixVersions?: FixVersions;
     resolution?: unknown;

package/data-access-issue/atlassian-app-data-access-issue.api.json

@@ -244,8 +244,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "AtlassianDocumentFormat",
-                  "canonicalReference": "@valiantys/atlassian-app!~AtlassianDocumentFormat:interface"
+                  "text": "AdfDoc",
+                  "canonicalReference": "@valiantys/atlassian-app!~AdfDoc:interface"
                 },
                 {
                   "kind": "Content",
@@ -500,6 +500,84 @@
               "isAbstract": false,
               "name": "createIssueLink"
             },
+            {
+              "kind": "Method",
+              "canonicalReference": "@valiantys/atlassian-app!JiraIssueService#getBulkIssues:member(1)",
+              "docComment": "",
+              "excerptTokens": [
+                {
+                  "kind": "Content",
+                  "text": "getBulkIssues(issueIdsOrKeys: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": ", fields?: "
+                },
+                {
+                  "kind": "Content",
+                  "text": "string[]"
+                },
+                {
+                  "kind": "Content",
+                  "text": "): "
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Promise",
+                  "canonicalReference": "!Promise:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "<"
+                },
+                {
+                  "kind": "Reference",
+                  "text": "Issue",
+                  "canonicalReference": "@valiantys/atlassian-app!~Issue:interface"
+                },
+                {
+                  "kind": "Content",
+                  "text": "[]>"
+                },
+                {
+                  "kind": "Content",
+                  "text": ";"
+                }
+              ],
+              "isStatic": false,
+              "returnTypeTokenRange": {
+                "startIndex": 5,
+                "endIndex": 9
+              },
+              "releaseTag": "Public",
+              "isProtected": false,
+              "overloadIndex": 1,
+              "parameters": [
+                {
+                  "parameterName": "issueIdsOrKeys",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 1,
+                    "endIndex": 2
+                  },
+                  "isOptional": false
+                },
+                {
+                  "parameterName": "fields",
+                  "parameterTypeTokenRange": {
+                    "startIndex": 3,
+                    "endIndex": 4
+                  },
+                  "isOptional": true
+                }
+              ],
+              "isOptional": false,
+              "isAbstract": false,
+              "name": "getBulkIssues"
+            },
             {
               "kind": "Method",
               "canonicalReference": "@valiantys/atlassian-app!JiraIssueService#getIssue:member(1)",
@@ -1150,8 +1228,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "AtlassianDocumentFormat",
-                  "canonicalReference": "@valiantys/atlassian-app!~AtlassianDocumentFormat:interface"
+                  "text": "AdfDoc",
+                  "canonicalReference": "@valiantys/atlassian-app!~AdfDoc:interface"
                 },
                 {
                   "kind": "Content",
@@ -1381,8 +1459,8 @@
                 },
                 {
                   "kind": "Reference",
-                  "text": "AtlassianDocumentFormat",
-                  "canonicalReference": "@valiantys/atlassian-app!~AtlassianDocumentFormat:interface"
+                  "text": "AdfDoc",
+                  "canonicalReference": "@valiantys/atlassian-app!~AdfDoc:interface"
                 },
                 {
                   "kind": "Content",

package/data-access-issue/atlassian-app.api.md

@@ -9,7 +9,7 @@ export class JiraIssueService {
     // Warning: (ae-forgotten-export) The symbol "AtlassianProductFetchService" needs to be exported by the entry point data-access-issue.d.ts
     constructor(fetchSvc: AtlassianProductFetchService<'jira'>);
     // (undocumented)
-    addIssueComment(issueIdOrKey: string, body: AtlassianDocumentFormat): Promise<IssueComment>;
+    addIssueComment(issueIdOrKey: string, body: AdfDoc): Promise<IssueComment>;
     // Warning: (ae-forgotten-export) The symbol "WorklogCreateRequest" needs to be exported by the entry point data-access-issue.d.ts
     // Warning: (ae-forgotten-export) The symbol "Worklog" needs to be exported by the entry point data-access-issue.d.ts
     //
@@ -24,6 +24,8 @@ export class JiraIssueService {
     //
     // (undocumented)
     createIssueLink(issueLinkRequest: IssueLinkRequest): Promise<void>;
+    // (undocumented)
+    getBulkIssues(issueIdsOrKeys: string[], fields?: string[]): Promise<Issue[]>;
     // Warning: (ae-forgotten-export) The symbol "Issue" needs to be exported by the entry point data-access-issue.d.ts
     //
     // (undocumented)
@@ -66,10 +68,10 @@ export class JiraIssueService {
         startAt?: number;
         projectId?: string[];
     }): Promise<PagedResponseWithNextLink<IssueTypeSchemeForProjects>>;
-    // Warning: (ae-forgotten-export) The symbol "AtlassianDocumentFormat" needs to be exported by the entry point data-access-issue.d.ts
+    // Warning: (ae-forgotten-export) The symbol "AdfDoc" needs to be exported by the entry point data-access-issue.d.ts
     //
     // (undocumented)
-    issueSearch(jql: string, fields: string[], maxResults?: number): Promise<Issue<AtlassianDocumentFormat>[]>;
+    issueSearch(jql: string, fields: string[], maxResults?: number): Promise<Issue<AdfDoc>[]>;
     // (undocumented)
     issueSearchByPage(jql: string, fields: string[], nextPageToken?: string, maxResults?: number): Promise<{
         issues: Issue[];
@@ -78,7 +80,7 @@ export class JiraIssueService {
     // (undocumented)
     static readonly issueUrl = "/rest/api/3/issue";
     // (undocumented)
-    queryForIssuesInProjects(projectIdsOrKeys: string[]): Promise<Issue<AtlassianDocumentFormat>[]>;
+    queryForIssuesInProjects(projectIdsOrKeys: string[]): Promise<Issue<AdfDoc>[]>;
     // Warning: (ae-forgotten-export) The symbol "TransitionIssueRequest" needs to be exported by the entry point data-access-issue.d.ts
     //
     // (undocumented)

package/data-access-issue/index.d.ts

@@ -1,21 +1,45 @@
-declare type APIResponse = Pick<Response, 'json' | 'text' | 'ok' | 'status' | 'statusText' | 'headers'>;
-
-declare interface AtlassianDocumentFormat {
+/** Root document node */
+declare interface AdfDoc {
     type: 'doc';
-    version: number;
-    content: AtlassianDocumentFormatNode[];
+    version: 1;
+    content: AdfNode[];
 }
 
-declare interface AtlassianDocumentFormatBlockNode {
+/**
+ * TypeScript types for Atlassian Document Format (ADF)
+ * Conforms to https://unpkg.com/@atlaskit/adf-schema@52.4.0/dist/json-schema/v1/full.json
+ */
+declare interface AdfMark {
     type: string;
-    content: AtlassianDocumentFormatNode[];
+    attrs?: Record<string, unknown>;
 }
 
-declare interface AtlassianDocumentFormatInlineNode {
+/**
+ * Base for all ADF nodes. `content` is optional because many block nodes
+ * (paragraph, heading, codeBlock, etc.) define it as optional in the schema.
+ * `text` is only populated on text nodes. `attrs` is present on most non-text
+ * nodes. `marks` is present on nodes that support formatting.
+ */
+declare interface AdfNode {
     type: string;
+    text?: string;
+    attrs?: AdfNodeAttrs;
+    content?: AdfNode[];
+    marks?: AdfMark[];
+}
+
+/**
+ * Attrs common across node types. Many inline node types (emoji, mention,
+ * status, placeholder, hardBreak, inlineExtension, extension, bodiedExtension)
+ * store their display text in `attrs.text`.
+ */
+declare interface AdfNodeAttrs {
+    text?: string;
+    localId?: string;
+    [key: string]: unknown;
 }
 
-declare type AtlassianDocumentFormatNode = AtlassianDocumentFormatInlineNode | AtlassianDocumentFormatBlockNode;
+declare type APIResponse = Pick<Response, 'json' | 'text' | 'ok' | 'status' | 'statusText' | 'headers'>;
 
 declare interface AtlassianProductFetchService<P extends Product> {
     productType: P;
@@ -49,7 +73,7 @@ declare interface CreatedIssue {
 }
 
 declare interface CreateIssue {
-    fields: IssueFields<AtlassianDocumentFormat | string>;
+    fields: IssueFields<AdfDoc | string>;
     properties?: {
         key: string;
         value: unknown;
@@ -115,7 +139,7 @@ declare interface HistoryMetadataParticipant {
     url: string;
 }
 
-declare interface Issue<T = AtlassianDocumentFormat> {
+declare interface Issue<T = AdfDoc> {
     id: string;
     expand?: string;
     key: string;
@@ -126,7 +150,7 @@ declare interface Issue<T = AtlassianDocumentFormat> {
 
 declare type IssueComment = {
     author: User;
-    body: AtlassianDocumentFormat;
+    body: AdfDoc;
     created: string;
     id: string;
     self: string;
@@ -135,7 +159,7 @@ declare type IssueComment = {
     visibility: Visibility;
 };
 
-declare type IssueFields<T = AtlassianDocumentFormat> = CustomFields & StaticIssueFields<T>;
+declare type IssueFields<T = AdfDoc> = CustomFields & StaticIssueFields<T>;
 
 declare interface IssueLink {
     id: string;
@@ -161,7 +185,7 @@ declare interface IssueLinkRequest {
         key?: string;
     };
     comment?: {
-        body: AtlassianDocumentFormat;
+        body: AdfDoc;
     };
     type: {
         id?: string;
@@ -236,18 +260,19 @@ export declare class JiraIssueService {
     getIssueField<T>(issueIdOrKey: string, field: string): Promise<T | undefined>;
     getIssueFields(issueIdOrKey: string, fields: string[]): Promise<IssueFields | undefined>;
     getIssue(issueIdOrKey: string, fields?: string[], rendered?: boolean): Promise<Issue | undefined>;
-    issueSearch(jql: string, fields: string[], maxResults?: number): Promise<Issue<AtlassianDocumentFormat>[]>;
+    getBulkIssues(issueIdsOrKeys: string[], fields?: string[]): Promise<Issue[]>;
+    issueSearch(jql: string, fields: string[], maxResults?: number): Promise<Issue<AdfDoc>[]>;
     issueSearchByPage(jql: string, fields: string[], nextPageToken?: string, maxResults?: number): Promise<{
         issues: Issue[];
         nextPageToken?: string;
     }>;
     addWorklog(issueIdOrKey: string, worklog: WorklogCreateRequest): Promise<Worklog>;
-    queryForIssuesInProjects(projectIdsOrKeys: string[]): Promise<Issue<AtlassianDocumentFormat>[]>;
+    queryForIssuesInProjects(projectIdsOrKeys: string[]): Promise<Issue<AdfDoc>[]>;
     createIssue(body: CreateIssue): Promise<CreatedIssue>;
     updateIssue(issueIdOrKey: string, body: UpdateIssue): Promise<void>;
     getIssueComments(issueIdOrKey: string, startAt?: number): Promise<JiraCommentResponse>;
     getIssueCommentById(issueIdOrKey: string, commentId: string): Promise<IssueComment>;
-    addIssueComment(issueIdOrKey: string, body: AtlassianDocumentFormat): Promise<IssueComment>;
+    addIssueComment(issueIdOrKey: string, body: AdfDoc): Promise<IssueComment>;
     transitionIssue(issueIdOrKey: string, body: TransitionIssueRequest): Promise<void>;
     createIssueLink(issueLinkRequest: IssueLinkRequest): Promise<void>;
     getIssueTypes(): Promise<IssueTypeDetails[]>;
@@ -329,7 +354,7 @@ declare interface RemoteIssueLink {
 
 declare type RequestProductMethod = (url: FetchRoute, init: RequestInit) => Promise<APIResponse>;
 
-declare interface StaticIssueFields<T = AtlassianDocumentFormat> {
+declare interface StaticIssueFields<T = AdfDoc> {
     statuscategorychangedate?: string;
     fixVersions?: FixVersions;
     resolution?: unknown;
@@ -398,7 +423,7 @@ declare interface TransitionIssueRequest {
 }
 
 declare interface UpdateIssue {
-    fields?: IssueFields<AtlassianDocumentFormat | string>;
+    fields?: IssueFields<AdfDoc | string>;
     properties?: {
         key: string;
         value: unknown;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@valiantys/atlassian-app",
-  "version": "3.2.0-alpha-7",
+  "version": "3.2.0-alpha-9",
   "description": "This library provides Atlassian Forge components, wrappers, and utilities to support writing Forge apps that can run deployed or in standalone mode",
   "exports": {
     "./frontend-app": {
@@ -198,6 +198,11 @@
       "require": "./util-jira-v3-api/index.cjs.js",
       "types": "./util-jira-v3-api/index.d.ts"
     },
+    "./util-adf": {
+      "import": "./util-adf/index.es.js",
+      "require": "./util-adf/index.cjs.js",
+      "types": "./util-adf/index.d.ts"
+    },
     "./backend-async-queue": {
       "import": "./backend-async-queue/index.es.js",
       "require": "./backend-async-queue/index.cjs.js",