@qanalyzer/forge-commons 1.1.1

package/dist/config/config-type.d.ts

@@ -0,0 +1,24 @@
+import type { ModeEnum } from '../options';
+export type IngestOptionsType = {
+    url?: string;
+    token?: string;
+    timeoutMs?: number;
+    maxPayloadBytes?: number;
+};
+export type FileOptionsType = {
+    path?: string;
+};
+export type ConfigType = {
+    mode?: `${ModeEnum}`;
+    fallback?: `${ModeEnum}`;
+    projectKey?: string;
+    launchName?: string;
+    planId?: string;
+    planKey?: string;
+    planName?: string;
+    fixVersion?: string;
+    sprintName?: string;
+    debug?: boolean;
+    ingest?: IngestOptionsType;
+    file?: FileOptionsType;
+};

package/dist/config/config-type.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/config/index.d.ts

@@ -0,0 +1,2 @@
+export type { ConfigType, IngestOptionsType, FileOptionsType } from './config-type';
+export { ConfigLoader, loadConfig } from './config-loader';

package/dist/config/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadConfig = exports.ConfigLoader = void 0;
+var config_loader_1 = require("./config-loader");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_loader_1.ConfigLoader; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_loader_1.loadConfig; } });

package/dist/env/ci-environment.d.ts

@@ -0,0 +1,10 @@
+export type CiMetadata = {
+    ciPlatform?: string;
+    buildUrl?: string;
+    gitCommitSha?: string;
+    gitBranch?: string;
+    gitAuthorName?: string;
+    gitAuthorEmail?: string;
+};
+/** Best-effort CI metadata from common provider env vars. */
+export declare function detectCiEnvironment(): CiMetadata;

package/dist/env/ci-environment.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCiEnvironment = detectCiEnvironment;
+function firstDefined(...values) {
+    return values.find((value) => value !== undefined && value !== '');
+}
+/** Best-effort CI metadata from common provider env vars. */
+function detectCiEnvironment() {
+    const github = process.env.GITHUB_ACTIONS === 'true';
+    const gitlab = Boolean(process.env.GITLAB_CI);
+    const azure = Boolean(process.env.TF_BUILD);
+    const bitbucket = Boolean(process.env.BITBUCKET_BUILD_NUMBER);
+    const teamcity = Boolean(process.env.TEAMCITY_VERSION);
+    const jenkins = Boolean(process.env.JENKINS_URL);
+    let ciPlatform;
+    let buildUrl;
+    if (github) {
+        ciPlatform = 'github';
+        const server = process.env.GITHUB_SERVER_URL ?? 'https://github.com';
+        const repo = process.env.GITHUB_REPOSITORY;
+        const runId = process.env.GITHUB_RUN_ID;
+        if (repo && runId) {
+            buildUrl = `${server}/${repo}/actions/runs/${runId}`;
+        }
+    }
+    else if (gitlab) {
+        ciPlatform = 'gitlab';
+        buildUrl = process.env.CI_PIPELINE_URL;
+    }
+    else if (azure) {
+        ciPlatform = 'azure-devops';
+        const collection = process.env.SYSTEM_TEAMFOUNDATIONCOLLECTIONURI;
+        const project = process.env.SYSTEM_TEAMPROJECT;
+        const buildId = process.env.BUILD_BUILDID;
+        if (collection && project && buildId) {
+            buildUrl = `${collection}${project}/_build/results?buildId=${buildId}`;
+        }
+    }
+    else if (bitbucket) {
+        ciPlatform = 'bitbucket';
+        buildUrl = process.env.BITBUCKET_GIT_HTTP_ORIGIN;
+    }
+    else if (teamcity) {
+        ciPlatform = 'teamcity';
+        buildUrl = process.env.BUILD_URL;
+    }
+    else if (jenkins) {
+        ciPlatform = 'jenkins';
+        buildUrl = process.env.BUILD_URL;
+    }
+    return {
+        ciPlatform,
+        buildUrl,
+        gitCommitSha: firstDefined(process.env.GITHUB_SHA, process.env.CI_COMMIT_SHA, process.env.BUILD_SOURCEVERSION, process.env.BITBUCKET_COMMIT),
+        gitBranch: firstDefined(process.env.GITHUB_REF_NAME, process.env.CI_COMMIT_REF_NAME, process.env.BUILD_SOURCEBRANCHNAME, process.env.BITBUCKET_BRANCH),
+        gitAuthorName: firstDefined(process.env.GITHUB_ACTOR, process.env.GITLAB_USER_NAME),
+        gitAuthorEmail: process.env.GITLAB_USER_EMAIL,
+    };
+}

package/dist/env/env-enum.d.ts

@@ -0,0 +1,21 @@
+export declare enum EnvEnum {
+    mode = "QANALYZER_MODE",
+    fallback = "QANALYZER_FALLBACK",
+    debug = "QANALYZER_DEBUG",
+    projectKey = "QANALYZER_PROJECT_KEY",
+    launchName = "QANALYZER_LAUNCH_NAME",
+    planId = "QANALYZER_PLAN_ID",
+    planKey = "QANALYZER_PLAN_KEY",
+    planName = "QANALYZER_PLAN_NAME",
+    fixVersion = "QANALYZER_FIX_VERSION",
+    sprintName = "QANALYZER_SPRINT"
+}
+export declare enum EnvIngestEnum {
+    url = "QANALYZER_INGEST_URL",
+    token = "QANALYZER_INGEST_TOKEN",
+    timeoutMs = "QANALYZER_INGEST_TIMEOUT_MS",
+    maxPayloadBytes = "QANALYZER_INGEST_MAX_PAYLOAD_BYTES"
+}
+export declare enum EnvFileEnum {
+    path = "QANALYZER_FILE_PATH"
+}

package/dist/env/env-enum.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EnvFileEnum = exports.EnvIngestEnum = exports.EnvEnum = void 0;
+var EnvEnum;
+(function (EnvEnum) {
+    EnvEnum["mode"] = "QANALYZER_MODE";
+    EnvEnum["fallback"] = "QANALYZER_FALLBACK";
+    EnvEnum["debug"] = "QANALYZER_DEBUG";
+    EnvEnum["projectKey"] = "QANALYZER_PROJECT_KEY";
+    EnvEnum["launchName"] = "QANALYZER_LAUNCH_NAME";
+    EnvEnum["planId"] = "QANALYZER_PLAN_ID";
+    EnvEnum["planKey"] = "QANALYZER_PLAN_KEY";
+    EnvEnum["planName"] = "QANALYZER_PLAN_NAME";
+    EnvEnum["fixVersion"] = "QANALYZER_FIX_VERSION";
+    EnvEnum["sprintName"] = "QANALYZER_SPRINT";
+})(EnvEnum || (exports.EnvEnum = EnvEnum = {}));
+var EnvIngestEnum;
+(function (EnvIngestEnum) {
+    EnvIngestEnum["url"] = "QANALYZER_INGEST_URL";
+    EnvIngestEnum["token"] = "QANALYZER_INGEST_TOKEN";
+    EnvIngestEnum["timeoutMs"] = "QANALYZER_INGEST_TIMEOUT_MS";
+    EnvIngestEnum["maxPayloadBytes"] = "QANALYZER_INGEST_MAX_PAYLOAD_BYTES";
+})(EnvIngestEnum || (exports.EnvIngestEnum = EnvIngestEnum = {}));
+var EnvFileEnum;
+(function (EnvFileEnum) {
+    EnvFileEnum["path"] = "QANALYZER_FILE_PATH";
+})(EnvFileEnum || (exports.EnvFileEnum = EnvFileEnum = {}));

package/dist/env/env-to-config.d.ts

@@ -0,0 +1,3 @@
+import type { ConfigType } from '../config';
+/** Map QANALYZER_* env vars to nested config (highest precedence in composeOptions). */
+export declare function envToConfig(): ConfigType;

package/dist/env/env-to-config.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.envToConfig = envToConfig;
+const env_enum_1 = require("./env-enum");
+function readEnv(name) {
+    const value = process.env[name];
+    return value === '' ? undefined : value;
+}
+function readBoolean(name) {
+    const value = readEnv(name);
+    if (value === undefined)
+        return undefined;
+    return value === '1' || value.toLowerCase() === 'true';
+}
+function readNumber(name) {
+    const value = readEnv(name);
+    if (value === undefined)
+        return undefined;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : undefined;
+}
+/** Map QANALYZER_* env vars to nested config (highest precedence in composeOptions). */
+function envToConfig() {
+    const config = {
+        mode: readEnv(env_enum_1.EnvEnum.mode),
+        fallback: readEnv(env_enum_1.EnvEnum.fallback),
+        debug: readBoolean(env_enum_1.EnvEnum.debug),
+        projectKey: readEnv(env_enum_1.EnvEnum.projectKey),
+        launchName: readEnv(env_enum_1.EnvEnum.launchName),
+        planId: readEnv(env_enum_1.EnvEnum.planId),
+        planKey: readEnv(env_enum_1.EnvEnum.planKey),
+        planName: readEnv(env_enum_1.EnvEnum.planName),
+        fixVersion: readEnv(env_enum_1.EnvEnum.fixVersion),
+        sprintName: readEnv(env_enum_1.EnvEnum.sprintName),
+        ingest: {
+            url: readEnv(env_enum_1.EnvIngestEnum.url),
+            token: readEnv(env_enum_1.EnvIngestEnum.token),
+            timeoutMs: readNumber(env_enum_1.EnvIngestEnum.timeoutMs),
+            maxPayloadBytes: readNumber(env_enum_1.EnvIngestEnum.maxPayloadBytes),
+        },
+        file: {
+            path: readEnv(env_enum_1.EnvFileEnum.path),
+        },
+    };
+    if (config.ingest &&
+        Object.values(config.ingest).every((value) => value === undefined)) {
+        delete config.ingest;
+    }
+    if (config.file && Object.values(config.file).every((value) => value === undefined)) {
+        delete config.file;
+    }
+    return config;
+}

package/dist/env/index.d.ts

@@ -0,0 +1,4 @@
+export { EnvEnum, EnvIngestEnum, EnvFileEnum } from './env-enum';
+export { envToConfig } from './env-to-config';
+export { detectCiEnvironment } from './ci-environment';
+export type { CiMetadata } from './ci-environment';

package/dist/env/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.detectCiEnvironment = exports.envToConfig = exports.EnvFileEnum = exports.EnvIngestEnum = exports.EnvEnum = void 0;
+var env_enum_1 = require("./env-enum");
+Object.defineProperty(exports, "EnvEnum", { enumerable: true, get: function () { return env_enum_1.EnvEnum; } });
+Object.defineProperty(exports, "EnvIngestEnum", { enumerable: true, get: function () { return env_enum_1.EnvIngestEnum; } });
+Object.defineProperty(exports, "EnvFileEnum", { enumerable: true, get: function () { return env_enum_1.EnvFileEnum; } });
+var env_to_config_1 = require("./env-to-config");
+Object.defineProperty(exports, "envToConfig", { enumerable: true, get: function () { return env_to_config_1.envToConfig; } });
+var ci_environment_1 = require("./ci-environment");
+Object.defineProperty(exports, "detectCiEnvironment", { enumerable: true, get: function () { return ci_environment_1.detectCiEnvironment; } });

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export { QAnalyzerReporter, type PublishReportOptions } from './qanalyzer';
+export { ConfigLoader, loadConfig, type ConfigType } from './config';
+export { envToConfig, detectCiEnvironment, EnvEnum, EnvIngestEnum, EnvFileEnum } from './env';
+export type { CiMetadata } from './env';
+export { composeOptions, ModeEnum, type OptionsType } from './options';
+export { buildIngestPayload, estimatePayloadBytes, normalizeJestReport, applyQaAnnotation, applyQaAnnotations, createQaMetaAccumulator, qaMetaFromEntries, toQaMetaWire, TestResultType, TestStepType, TestExecution, TestStatusEnum, StepType, StepExecution, StepStatusEnum, type IngestPayload, type IngestFormat, type JestVitestJsonReport, type JestAssertionResult, type JestTestFileResult, type QaAnnotationLike, type QaMetaAccumulator, type QaMetaWire, type QaMetaStepWire, type QaMetaAttachmentWire, type QaMetaFramework, type Report, type Stats, type ShortResult, type HostData, type Attachment, type Relation, type Suite, type SuiteData, } from './models';
+export { IngestClient, AttachClient, DEFAULT_MAX_ATTACH_BYTES, type IngestResponse } from './client';
+export { FsWriter } from './writer';
+export { FallbackCoordinator, IngestReporter, FileReporter } from './reporters';
+export { Logger, sanitizeOptionsForLog, extractIssueKeys, firstIssueKey, projectKeyFromIssueKey, uploadAttachmentForQa, EnvAttachEnum, } from './utils';
+export { generateCiTemplate, buildCiTemplateContext, listCiTemplateVariants, UnsupportedVariantError, vitestJsonRun, jestJsonRun, type CiTemplateContext, type CiTemplateResult, type CiTemplateVariant, type CiPlatform, type CiFramework, type CiIngestPath, type CiSecretHint, type CiVariableHint, } from './ci';
+export declare const PACKAGE_NAME = "@qanalyzer/forge-commons";

package/dist/index.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PACKAGE_NAME = exports.jestJsonRun = exports.vitestJsonRun = exports.UnsupportedVariantError = exports.listCiTemplateVariants = exports.buildCiTemplateContext = exports.generateCiTemplate = exports.EnvAttachEnum = exports.uploadAttachmentForQa = exports.projectKeyFromIssueKey = exports.firstIssueKey = exports.extractIssueKeys = exports.sanitizeOptionsForLog = exports.Logger = exports.FileReporter = exports.IngestReporter = exports.FallbackCoordinator = exports.FsWriter = exports.DEFAULT_MAX_ATTACH_BYTES = exports.AttachClient = exports.IngestClient = exports.StepStatusEnum = exports.StepExecution = exports.StepType = exports.TestStatusEnum = exports.TestExecution = exports.TestStepType = exports.TestResultType = exports.toQaMetaWire = exports.qaMetaFromEntries = exports.createQaMetaAccumulator = exports.applyQaAnnotations = exports.applyQaAnnotation = exports.normalizeJestReport = exports.estimatePayloadBytes = exports.buildIngestPayload = exports.ModeEnum = exports.composeOptions = exports.EnvFileEnum = exports.EnvIngestEnum = exports.EnvEnum = exports.detectCiEnvironment = exports.envToConfig = exports.loadConfig = exports.ConfigLoader = exports.QAnalyzerReporter = void 0;
+var qanalyzer_1 = require("./qanalyzer");
+Object.defineProperty(exports, "QAnalyzerReporter", { enumerable: true, get: function () { return qanalyzer_1.QAnalyzerReporter; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "ConfigLoader", { enumerable: true, get: function () { return config_1.ConfigLoader; } });
+Object.defineProperty(exports, "loadConfig", { enumerable: true, get: function () { return config_1.loadConfig; } });
+var env_1 = require("./env");
+Object.defineProperty(exports, "envToConfig", { enumerable: true, get: function () { return env_1.envToConfig; } });
+Object.defineProperty(exports, "detectCiEnvironment", { enumerable: true, get: function () { return env_1.detectCiEnvironment; } });
+Object.defineProperty(exports, "EnvEnum", { enumerable: true, get: function () { return env_1.EnvEnum; } });
+Object.defineProperty(exports, "EnvIngestEnum", { enumerable: true, get: function () { return env_1.EnvIngestEnum; } });
+Object.defineProperty(exports, "EnvFileEnum", { enumerable: true, get: function () { return env_1.EnvFileEnum; } });
+var options_1 = require("./options");
+Object.defineProperty(exports, "composeOptions", { enumerable: true, get: function () { return options_1.composeOptions; } });
+Object.defineProperty(exports, "ModeEnum", { enumerable: true, get: function () { return options_1.ModeEnum; } });
+var models_1 = require("./models");
+Object.defineProperty(exports, "buildIngestPayload", { enumerable: true, get: function () { return models_1.buildIngestPayload; } });
+Object.defineProperty(exports, "estimatePayloadBytes", { enumerable: true, get: function () { return models_1.estimatePayloadBytes; } });
+Object.defineProperty(exports, "normalizeJestReport", { enumerable: true, get: function () { return models_1.normalizeJestReport; } });
+Object.defineProperty(exports, "applyQaAnnotation", { enumerable: true, get: function () { return models_1.applyQaAnnotation; } });
+Object.defineProperty(exports, "applyQaAnnotations", { enumerable: true, get: function () { return models_1.applyQaAnnotations; } });
+Object.defineProperty(exports, "createQaMetaAccumulator", { enumerable: true, get: function () { return models_1.createQaMetaAccumulator; } });
+Object.defineProperty(exports, "qaMetaFromEntries", { enumerable: true, get: function () { return models_1.qaMetaFromEntries; } });
+Object.defineProperty(exports, "toQaMetaWire", { enumerable: true, get: function () { return models_1.toQaMetaWire; } });
+Object.defineProperty(exports, "TestResultType", { enumerable: true, get: function () { return models_1.TestResultType; } });
+Object.defineProperty(exports, "TestStepType", { enumerable: true, get: function () { return models_1.TestStepType; } });
+Object.defineProperty(exports, "TestExecution", { enumerable: true, get: function () { return models_1.TestExecution; } });
+Object.defineProperty(exports, "TestStatusEnum", { enumerable: true, get: function () { return models_1.TestStatusEnum; } });
+Object.defineProperty(exports, "StepType", { enumerable: true, get: function () { return models_1.StepType; } });
+Object.defineProperty(exports, "StepExecution", { enumerable: true, get: function () { return models_1.StepExecution; } });
+Object.defineProperty(exports, "StepStatusEnum", { enumerable: true, get: function () { return models_1.StepStatusEnum; } });
+var client_1 = require("./client");
+Object.defineProperty(exports, "IngestClient", { enumerable: true, get: function () { return client_1.IngestClient; } });
+Object.defineProperty(exports, "AttachClient", { enumerable: true, get: function () { return client_1.AttachClient; } });
+Object.defineProperty(exports, "DEFAULT_MAX_ATTACH_BYTES", { enumerable: true, get: function () { return client_1.DEFAULT_MAX_ATTACH_BYTES; } });
+var writer_1 = require("./writer");
+Object.defineProperty(exports, "FsWriter", { enumerable: true, get: function () { return writer_1.FsWriter; } });
+var reporters_1 = require("./reporters");
+Object.defineProperty(exports, "FallbackCoordinator", { enumerable: true, get: function () { return reporters_1.FallbackCoordinator; } });
+Object.defineProperty(exports, "IngestReporter", { enumerable: true, get: function () { return reporters_1.IngestReporter; } });
+Object.defineProperty(exports, "FileReporter", { enumerable: true, get: function () { return reporters_1.FileReporter; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "Logger", { enumerable: true, get: function () { return utils_1.Logger; } });
+Object.defineProperty(exports, "sanitizeOptionsForLog", { enumerable: true, get: function () { return utils_1.sanitizeOptionsForLog; } });
+Object.defineProperty(exports, "extractIssueKeys", { enumerable: true, get: function () { return utils_1.extractIssueKeys; } });
+Object.defineProperty(exports, "firstIssueKey", { enumerable: true, get: function () { return utils_1.firstIssueKey; } });
+Object.defineProperty(exports, "projectKeyFromIssueKey", { enumerable: true, get: function () { return utils_1.projectKeyFromIssueKey; } });
+Object.defineProperty(exports, "uploadAttachmentForQa", { enumerable: true, get: function () { return utils_1.uploadAttachmentForQa; } });
+Object.defineProperty(exports, "EnvAttachEnum", { enumerable: true, get: function () { return utils_1.EnvAttachEnum; } });
+var ci_1 = require("./ci");
+Object.defineProperty(exports, "generateCiTemplate", { enumerable: true, get: function () { return ci_1.generateCiTemplate; } });
+Object.defineProperty(exports, "buildCiTemplateContext", { enumerable: true, get: function () { return ci_1.buildCiTemplateContext; } });
+Object.defineProperty(exports, "listCiTemplateVariants", { enumerable: true, get: function () { return ci_1.listCiTemplateVariants; } });
+Object.defineProperty(exports, "UnsupportedVariantError", { enumerable: true, get: function () { return ci_1.UnsupportedVariantError; } });
+Object.defineProperty(exports, "vitestJsonRun", { enumerable: true, get: function () { return ci_1.vitestJsonRun; } });
+Object.defineProperty(exports, "jestJsonRun", { enumerable: true, get: function () { return ci_1.jestJsonRun; } });
+exports.PACKAGE_NAME = '@qanalyzer/forge-commons';

package/dist/models/attachment.d.ts

@@ -0,0 +1,9 @@
+/** File or inline attachment on a result or step. */
+export interface Attachment {
+    file_name: string;
+    mime_type: string;
+    file_path: string | null;
+    content: string | Buffer;
+    size: number;
+    id: string;
+}

package/dist/models/attachment.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/execution-sum.d.ts

@@ -0,0 +1,7 @@
+/** Aggregate timing for a launch/report. */
+export interface ExecutionSum {
+    start_time: number;
+    end_time: number;
+    duration: number;
+    cumulative_duration: number;
+}

package/dist/models/execution-sum.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/host-data.d.ts

@@ -0,0 +1,13 @@
+/** Runtime host metadata captured with a launch. */
+export interface HostData {
+    system: string;
+    machineName: string;
+    release: string;
+    version: string;
+    arch: string;
+    language: string;
+    packageManager: string;
+    framework: string;
+    reporter: string;
+    commons: string;
+}

package/dist/models/host-data.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/models/index.d.ts

@@ -0,0 +1,14 @@
+export { TestResultType, type Relation, type Suite, type SuiteData } from './test-result';
+export { TestExecution, TestStatusEnum } from './test-execution';
+export { TestStepType, StepType } from './test-step';
+export type { StepRequestData, StepTextData, StepGherkinData } from './step-data';
+export { StepExecution, StepStatusEnum } from './step-execution';
+export type { Attachment } from './attachment';
+export type { Report } from './report';
+export type { Stats } from './stats';
+export type { ShortResult } from './short-result';
+export type { HostData } from './host-data';
+export type { ExecutionSum } from './execution-sum';
+export type { JestVitestJsonReport, JestTestFileResult, JestAssertionResult } from './jest-vitest-report';
+export { applyQaAnnotation, applyQaAnnotations, createQaMetaAccumulator, qaMetaFromEntries, toQaMetaWire, type QaAnnotationLike, type QaMetaAccumulator, type QaMetaAttachmentWire, type QaMetaStepWire, type QaMetaWire, type QaMetaFramework, type ToQaMetaWireOptions, } from './meta-qa';
+export { buildIngestPayload, estimatePayloadBytes, normalizeJestReport, type BuildIngestPayloadInput, type IngestFormat, type IngestPayload, } from './ingest-payload';

package/dist/models/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeJestReport = exports.estimatePayloadBytes = exports.buildIngestPayload = exports.toQaMetaWire = exports.qaMetaFromEntries = exports.createQaMetaAccumulator = exports.applyQaAnnotations = exports.applyQaAnnotation = exports.StepStatusEnum = exports.StepExecution = exports.StepType = exports.TestStepType = exports.TestStatusEnum = exports.TestExecution = exports.TestResultType = void 0;
+var test_result_1 = require("./test-result");
+Object.defineProperty(exports, "TestResultType", { enumerable: true, get: function () { return test_result_1.TestResultType; } });
+var test_execution_1 = require("./test-execution");
+Object.defineProperty(exports, "TestExecution", { enumerable: true, get: function () { return test_execution_1.TestExecution; } });
+Object.defineProperty(exports, "TestStatusEnum", { enumerable: true, get: function () { return test_execution_1.TestStatusEnum; } });
+var test_step_1 = require("./test-step");
+Object.defineProperty(exports, "TestStepType", { enumerable: true, get: function () { return test_step_1.TestStepType; } });
+Object.defineProperty(exports, "StepType", { enumerable: true, get: function () { return test_step_1.StepType; } });
+var step_execution_1 = require("./step-execution");
+Object.defineProperty(exports, "StepExecution", { enumerable: true, get: function () { return step_execution_1.StepExecution; } });
+Object.defineProperty(exports, "StepStatusEnum", { enumerable: true, get: function () { return step_execution_1.StepStatusEnum; } });
+var meta_qa_1 = require("./meta-qa");
+Object.defineProperty(exports, "applyQaAnnotation", { enumerable: true, get: function () { return meta_qa_1.applyQaAnnotation; } });
+Object.defineProperty(exports, "applyQaAnnotations", { enumerable: true, get: function () { return meta_qa_1.applyQaAnnotations; } });
+Object.defineProperty(exports, "createQaMetaAccumulator", { enumerable: true, get: function () { return meta_qa_1.createQaMetaAccumulator; } });
+Object.defineProperty(exports, "qaMetaFromEntries", { enumerable: true, get: function () { return meta_qa_1.qaMetaFromEntries; } });
+Object.defineProperty(exports, "toQaMetaWire", { enumerable: true, get: function () { return meta_qa_1.toQaMetaWire; } });
+var ingest_payload_1 = require("./ingest-payload");
+Object.defineProperty(exports, "buildIngestPayload", { enumerable: true, get: function () { return ingest_payload_1.buildIngestPayload; } });
+Object.defineProperty(exports, "estimatePayloadBytes", { enumerable: true, get: function () { return ingest_payload_1.estimatePayloadBytes; } });
+Object.defineProperty(exports, "normalizeJestReport", { enumerable: true, get: function () { return ingest_payload_1.normalizeJestReport; } });

package/dist/models/ingest-payload.d.ts

@@ -0,0 +1,56 @@
+import type { JestVitestJsonReport } from './jest-vitest-report';
+import type { CiMetadata } from '../env';
+export type IngestFormat = 'jest-json' | 'vitest-json' | 'normalized' | 'junit-xml';
+type IngestPayloadBase = {
+    projectKey: string;
+    launchName?: string;
+    planId?: string;
+    planKey?: string;
+    planName?: string;
+    fixVersion?: string;
+    sprintName?: string;
+    ciPlatform?: string;
+    buildUrl?: string;
+    gitCommitSha?: string;
+    gitBranch?: string;
+    gitAuthorName?: string;
+    gitAuthorEmail?: string;
+};
+/** FR41 JSON ingest (primary). */
+export type JestIngestPayload = IngestPayloadBase & {
+    format?: Exclude<IngestFormat, 'junit-xml'>;
+    report: JestVitestJsonReport & {
+        testResults: NonNullable<JestVitestJsonReport['testResults']>;
+    };
+};
+/** Optional JUnit XML ingest (FR45) — server normalizes to FR41. */
+export type JunitIngestPayload = IngestPayloadBase & {
+    format: 'junit-xml';
+    report: string;
+    junitXml?: string;
+};
+export type IngestPayload = JestIngestPayload | JunitIngestPayload;
+export type BuildIngestPayloadInput = {
+    projectKey: string;
+    report: JestVitestJsonReport | string;
+    launchName?: string;
+    format?: IngestFormat;
+    planId?: string;
+    planKey?: string;
+    planName?: string;
+    fixVersion?: string;
+    sprintName?: string;
+    ci?: CiMetadata;
+};
+export declare function normalizeJestReport(report: JestVitestJsonReport): JestVitestJsonReport;
+export declare function buildIngestPayload(input: BuildIngestPayloadInput & {
+    format: 'junit-xml';
+    report: string;
+}): JunitIngestPayload;
+export declare function buildIngestPayload(input: BuildIngestPayloadInput & {
+    format?: Exclude<IngestFormat, 'junit-xml'>;
+    report: JestVitestJsonReport;
+}): JestIngestPayload;
+export declare function buildIngestPayload(input: BuildIngestPayloadInput): IngestPayload;
+export declare function estimatePayloadBytes(payload: IngestPayload): number;
+export {};

package/dist/models/ingest-payload.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeJestReport = normalizeJestReport;
+exports.buildIngestPayload = buildIngestPayload;
+exports.estimatePayloadBytes = estimatePayloadBytes;
+function normalizeJestReport(report) {
+    return {
+        ...report,
+        testResults: Array.isArray(report.testResults) ? report.testResults : [],
+    };
+}
+function buildIngestPayload(input) {
+    if (!input.projectKey?.trim()) {
+        throw new Error('projectKey is required to build an ingest payload');
+    }
+    const base = {
+        projectKey: input.projectKey.trim(),
+        launchName: input.launchName,
+        planId: input.planId?.trim() || undefined,
+        planKey: input.planKey?.trim() || undefined,
+        planName: input.planName?.trim() || undefined,
+        fixVersion: input.fixVersion?.trim() || undefined,
+        sprintName: input.sprintName?.trim() || undefined,
+        ciPlatform: input.ci?.ciPlatform,
+        buildUrl: input.ci?.buildUrl,
+        gitCommitSha: input.ci?.gitCommitSha,
+        gitBranch: input.ci?.gitBranch,
+        gitAuthorName: input.ci?.gitAuthorName,
+        gitAuthorEmail: input.ci?.gitAuthorEmail,
+    };
+    if (input.format === 'junit-xml') {
+        if (typeof input.report !== 'string' || !input.report.trim()) {
+            throw new Error('junit-xml format requires report to be a non-empty XML string');
+        }
+        return {
+            ...base,
+            format: 'junit-xml',
+            report: input.report,
+        };
+    }
+    if (typeof input.report === 'string') {
+        throw new Error('Jest/Vitest ingest requires a JSON report object (use --format junit-xml for XML)');
+    }
+    const normalized = normalizeJestReport(input.report);
+    return {
+        ...base,
+        format: input.format ?? 'jest-json',
+        report: {
+            ...normalized,
+            testResults: normalized.testResults ?? [],
+        },
+    };
+}
+function estimatePayloadBytes(payload) {
+    return Buffer.byteLength(JSON.stringify(payload), 'utf8');
+}

package/dist/models/jest-vitest-report.d.ts

@@ -0,0 +1,37 @@
+/** Jest / Vitest JSON report (Jest-compatible shape). Mirrors Forge `domain/jest-report/types`. */
+export interface JestVitestJsonReport {
+    numTotalTestSuites?: number;
+    numPassedTestSuites?: number;
+    numFailedTestSuites?: number;
+    numPendingTestSuites?: number;
+    numTotalTests?: number;
+    numPassedTests?: number;
+    numFailedTests?: number;
+    numPendingTests?: number;
+    numTodoTests?: number;
+    startTime?: number;
+    success?: boolean;
+    testResults?: JestTestFileResult[];
+    coverageMap?: unknown;
+}
+export interface JestTestFileResult {
+    name?: string;
+    status?: string;
+    message?: string;
+    startTime?: number;
+    endTime?: number;
+    assertionResults?: JestAssertionResult[];
+}
+export interface JestAssertionResult {
+    ancestorTitles?: string[];
+    fullName?: string;
+    title?: string;
+    status?: string;
+    duration?: number;
+    failureMessages?: string[];
+    location?: {
+        line?: number;
+        column?: number;
+    };
+    meta?: Record<string, unknown>;
+}

package/dist/models/jest-vitest-report.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,71 @@
+/**
+ * FR41 wire shape for `assertionResults[].meta.qa`
+ * (architecture ingest contract — simplified TestResultType serialization).
+ */
+export type QaMetaStepWire = {
+    id: string;
+    stepType: 'text' | 'gherkin' | 'request';
+    name: string;
+    status: 'passed' | 'failed' | 'skipped' | 'blocked';
+};
+export type QaMetaAttachmentWire = {
+    file_name?: string;
+    mime_type?: string;
+    size?: number;
+    /** Jira attachment id after Phase 3 Forge→Jira upload. */
+    content_ref?: string;
+};
+export type QaMetaFramework = 'vitest' | 'jest' | 'mocha' | 'cucumberjs' | 'cypress' | 'playwright' | 'wdio';
+export type QaMetaWire = {
+    framework?: QaMetaFramework;
+    title?: string;
+    comment?: string;
+    fields?: Record<string, string>;
+    parameters?: Record<string, string>;
+    suite?: Array<{
+        title: string;
+    }>;
+    steps?: QaMetaStepWire[];
+    attachments?: QaMetaAttachmentWire[];
+    ignore?: boolean;
+    host?: {
+        framework?: string;
+        reporter?: string;
+    };
+};
+export type QaAnnotationLike = {
+    message?: string;
+    type?: string;
+    body?: unknown;
+};
+export type QaMetaAccumulator = {
+    title?: string;
+    comment?: string;
+    suite?: string;
+    fields?: Record<string, string>;
+    parameters?: Record<string, string>;
+    steps: Array<{
+        name: string;
+        status: QaMetaStepWire['status'];
+    }>;
+    attachments: QaMetaAttachmentWire[];
+    ignore?: boolean;
+};
+export declare function createQaMetaAccumulator(): QaMetaAccumulator;
+/**
+ * Apply a Vitest/Jest QA annotation (or typed helper entry) onto an accumulator.
+ * Non-QA annotations are ignored.
+ */
+export declare function applyQaAnnotation(acc: QaMetaAccumulator, ann: QaAnnotationLike): void;
+export declare function applyQaAnnotations(acc: QaMetaAccumulator, annotations: readonly QaAnnotationLike[]): void;
+export type ToQaMetaWireOptions = {
+    framework: QaMetaFramework;
+    reporter?: string;
+};
+/** Returns undefined when accumulator has no QA data (omit empty meta.qa). */
+export declare function toQaMetaWire(acc: QaMetaAccumulator, options: ToQaMetaWireOptions): QaMetaWire | undefined;
+/** Build meta.qa from typed helper buffer entries (`{ type, body }`). */
+export declare function qaMetaFromEntries(entries: ReadonlyArray<{
+    type: string;
+    body: unknown;
+}>, options: ToQaMetaWireOptions): QaMetaWire | undefined;