@qanalyzer/forge-commons 1.1.2 → 1.2.0

package/dist/models/meta-qa.d.ts

@@ -25,6 +25,11 @@ export type QaMetaWire = {
     suite?: Array<{
         title: string;
     }>;
+    /**
+     * Explicit Jira issue keys for FR43 (preferred over embedding keys in titles).
+     * Roles (test_case / requirement / …) are classified server-side via TMS type map.
+     */
+    issueKeys?: string[];
     steps?: QaMetaStepWire[];
     attachments?: QaMetaAttachmentWire[];
     ignore?: boolean;
@@ -44,6 +49,7 @@ export type QaMetaAccumulator = {
     suite?: string;
     fields?: Record<string, string>;
     parameters?: Record<string, string>;
+    issueKeys: string[];
     steps: Array<{
         name: string;
         status: QaMetaStepWire['status'];

package/dist/models/meta-qa.js

@@ -10,7 +10,32 @@ exports.applyQaAnnotations = applyQaAnnotations;
 exports.toQaMetaWire = toQaMetaWire;
 exports.qaMetaFromEntries = qaMetaFromEntries;
 function createQaMetaAccumulator() {
-    return { steps: [], attachments: [] };
+    return { issueKeys: [], steps: [], attachments: [] };
+}
+const ISSUE_KEY_BODY_RE = /^[A-Z][A-Z0-9]+-\d+$/i;
+/** Normalize and append unique issue keys (preserve first-seen order). */
+function appendIssueKeys(acc, raw) {
+    const parts = [];
+    if (typeof raw === 'string') {
+        parts.push(...raw
+            .split(/[\s,]+/)
+            .map((s) => s.trim())
+            .filter(Boolean));
+    }
+    else if (Array.isArray(raw)) {
+        for (const item of raw) {
+            if (typeof item === 'string' && item.trim())
+                parts.push(item.trim());
+        }
+    }
+    for (const part of parts) {
+        const key = part.toUpperCase();
+        if (!ISSUE_KEY_BODY_RE.test(key))
+            continue;
+        if (acc.issueKeys.includes(key))
+            continue;
+        acc.issueKeys.push(key);
+    }
 }
 function isRecord(value) {
     return typeof value === 'object' && value !== null && !Array.isArray(value);
@@ -40,6 +65,10 @@ function resolveType(ann) {
         return 'qa-fields';
     if (message.startsWith('QA Parameters:'))
         return 'qa-parameters';
+    if (message.startsWith('QA IssueKeys:'))
+        return 'qa-issue-keys';
+    if (message.startsWith('QA IssueKey:'))
+        return 'qa-issue-key';
     if (message.startsWith('QA Step Failed:'))
         return 'qa-step-failed';
     if (message.startsWith('QA Step End:'))
@@ -113,6 +142,16 @@ function applyQaAnnotation(acc, ann) {
             }
             break;
         }
+        case 'qa-issue-key':
+        case 'qa-issue-keys': {
+            if (ann.body !== undefined && ann.body !== null) {
+                appendIssueKeys(acc, ann.body);
+                break;
+            }
+            const prefix = type === 'qa-issue-keys' ? 'QA IssueKeys:' : 'QA IssueKey:';
+            appendIssueKeys(acc, stripPrefix(message, prefix));
+            break;
+        }
         case 'qa-step': {
             const name = typeof ann.body === 'string'
                 ? ann.body
@@ -209,6 +248,7 @@ function toQaMetaWire(acc, options) {
         acc.suite !== undefined ||
         (acc.fields && Object.keys(acc.fields).length > 0) ||
         (acc.parameters && Object.keys(acc.parameters).length > 0) ||
+        acc.issueKeys.length > 0 ||
         acc.steps.length > 0 ||
         acc.attachments.length > 0 ||
         acc.ignore === true;
@@ -230,6 +270,8 @@ function toQaMetaWire(acc, options) {
     if (acc.parameters && Object.keys(acc.parameters).length > 0) {
         wire.parameters = acc.parameters;
     }
+    if (acc.issueKeys.length > 0)
+        wire.issueKeys = [...acc.issueKeys];
     if (acc.suite) {
         wire.suite = acc.suite.split('\t').filter(Boolean).map((title) => ({ title }));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qanalyzer/forge-commons",
-  "version": "1.1.2",
+  "version": "1.2.0",
   "description": "Shared config, models, and Forge ingest client for QAnalyzer JS reporters",
   "keywords": [
     "qanalyzer",