@allurereport/core-api 3.16.1 → 3.18.0

package/dist/aggregate.d.ts

@@ -13,4 +13,9 @@ export type Statistic = DiffStatistic & {
     total: number;
     retries?: number;
     flaky?: number;
+    resolutions?: {
+        issues?: number;
+        muted?: number;
+        accepted?: number;
+    };
 };

package/dist/config.d.ts

@@ -1,4 +1,5 @@
 export type DefaultLabelsConfig = Record<string, string | string[]>;
+export declare const parseIntegerConfigValue: (value: unknown, minValue?: number) => number | undefined;
 export type AllureServiceConfig = {
     accessToken?: string;
     private?: boolean;
@@ -6,4 +7,4 @@ export type AllureServiceConfig = {
     uploadMaxAttempts?: number;
     uploadMaxSimultaneousFailures?: number;
 };
-export type ResolvedAllureServiceConfig = AllureServiceConfig & Required<Pick<AllureServiceConfig, "uploadConcurrency" | "uploadMaxAttempts" | "uploadMaxSimultaneousFailures">>;
+export type ResolvedAllureServiceConfig = AllureServiceConfig & Required<Pick<AllureServiceConfig, "uploadMaxAttempts" | "uploadMaxSimultaneousFailures">>;

package/dist/config.js

@@ -1 +1,7 @@
-export {};
+export const parseIntegerConfigValue = (value, minValue) => {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        return undefined;
+    }
+    const normalized = Math.floor(value);
+    return minValue === undefined || normalized >= minValue ? normalized : undefined;
+};

package/dist/history.d.ts

@@ -24,10 +24,12 @@ export interface HistoryDataPoint {
     metrics: Record<string, number>;
     url: string;
 }
+export type HistoryTestResultUrlResolver = (historyUrl: string, pluginId: string, historicalResultId: string) => string;
 export interface AllureHistory {
     readHistory(params?: {
         repo?: string;
         branch?: string;
     }): Promise<HistoryDataPoint[]>;
     appendHistory(history: HistoryDataPoint): Promise<void>;
+    resolveTestResultUrl?: HistoryTestResultUrlResolver;
 }

package/dist/index.d.ts

@@ -6,10 +6,11 @@ export type * from "./environment.js";
 export type * from "./history.js";
 export type * from "./resolutions.js";
 export type * from "./metadata.js";
+export * from "./metrics.js";
 export type * from "./model.js";
 export type * from "./testCase.js";
 export type * from "./testPlan.js";
-export type * from "./config.js";
+export * from "./config.js";
 export * from "./static.js";
 export * from "./categories.js";
 export * from "./utils/step.js";
@@ -21,6 +22,7 @@ export * from "./utils/label.js";
 export * from "./utils/parameter.js";
 export * from "./utils/testplan.js";
 export * from "./utils/status.js";
+export * from "./utils/successRate.js";
 export * from "./utils/environment.js";
 export * from "./utils/history.js";
 export * from "./utils/strings.js";

package/dist/index.js

@@ -1,6 +1,8 @@
 export * from "./constants.js";
 export * from "./ci.js";
 export * from "./gitFlow.js";
+export * from "./metrics.js";
+export * from "./config.js";
 export * from "./static.js";
 export * from "./categories.js";
 export * from "./utils/step.js";
@@ -11,6 +13,7 @@ export * from "./utils/label.js";
 export * from "./utils/parameter.js";
 export * from "./utils/testplan.js";
 export * from "./utils/status.js";
+export * from "./utils/successRate.js";
 export * from "./utils/environment.js";
 export * from "./utils/history.js";
 export * from "./utils/strings.js";

package/dist/metrics.d.ts

@@ -0,0 +1,32 @@
+export type MetricBetter = "lower" | "higher" | "neutral";
+export interface PerformanceGroupConfig {
+    title: string;
+}
+export interface PerformanceMetricConfig {
+    title: string;
+    unit: string;
+    better: Exclude<MetricBetter, "neutral">;
+    group?: string;
+}
+export interface PerformanceConfig {
+    groups?: Record<string, PerformanceGroupConfig>;
+    metrics?: Record<string, PerformanceMetricConfig>;
+}
+export interface AllurePerformanceResult {
+    id: string;
+    key: string;
+    value: any;
+    start: number;
+    stop: number;
+}
+export interface MetricSample extends AllurePerformanceResult {
+    value: number;
+    source?: string;
+    title?: string;
+    unit?: string;
+    group?: string;
+    groupTitle?: string;
+    better?: MetricBetter;
+}
+export type ResolvableMetric = AllurePerformanceResult & Partial<Pick<MetricSample, "source" | "title" | "unit" | "group" | "groupTitle" | "better">>;
+export declare const resolveMetricSamples: (metrics: readonly ResolvableMetric[], performance?: PerformanceConfig) => MetricSample[];

package/dist/metrics.js

@@ -0,0 +1,29 @@
+const isValidMetricResult = (metric) => typeof metric.id === "string" &&
+    metric.id !== "" &&
+    typeof metric.key === "string" &&
+    metric.key !== "" &&
+    Number.isFinite(metric.start) &&
+    Number.isFinite(metric.stop);
+export const resolveMetricSamples = (metrics, performance = {}) => {
+    const metricsConfig = performance.metrics ?? {};
+    const groupsConfig = performance.groups ?? {};
+    return metrics.reduce((acc, metric) => {
+        const value = Number.isFinite(metric.value) ? Number(metric.value) : undefined;
+        if (value === undefined || !isValidMetricResult(metric)) {
+            return acc;
+        }
+        const metricConfig = metricsConfig[metric.key];
+        const group = metricConfig?.group ?? metric.group;
+        const groupConfig = group ? groupsConfig[group] : undefined;
+        acc.push({
+            ...metric,
+            value,
+            ...(metricConfig?.title ? { title: metricConfig.title } : {}),
+            ...(metricConfig?.unit ? { unit: metricConfig.unit } : {}),
+            ...(group ? { group } : {}),
+            ...(groupConfig?.title ? { groupTitle: groupConfig.title } : {}),
+            ...(metricConfig?.better ? { better: metricConfig.better } : {}),
+        });
+        return acc;
+    }, []);
+};

package/dist/model.d.ts

@@ -48,7 +48,9 @@ export interface TestResult {
     duration?: number;
     flaky: boolean;
     muted: boolean;
+    known: boolean;
     resolution?: ResolutionCategory;
+    resolutionComment?: string;
     transition?: TestStatusTransition;
     retryHash?: string;
     isRetry: boolean;

package/dist/utils/history.js

@@ -9,6 +9,12 @@ const normalizeHistoryTestResults = (testResults) => {
     }
     return Object.fromEntries(Object.entries(testResults).filter(([, value]) => isRecord(value)));
 };
+const normalizeHistoryMetrics = (metrics) => {
+    if (!isRecord(metrics)) {
+        return {};
+    }
+    return Object.fromEntries(Object.entries(metrics).filter(([, value]) => Number.isFinite(value)));
+};
 const parametersCompare = (a, b) => {
     return (a.name ?? "").localeCompare(b.name ?? "") || (a.value ?? "").localeCompare(b.value ?? "");
 };
@@ -41,7 +47,7 @@ export const normalizeHistoryDataPoint = (historyDataPoint) => ({
     ...historyDataPoint,
     knownTestCaseIds: Array.isArray(historyDataPoint.knownTestCaseIds) ? historyDataPoint.knownTestCaseIds : [],
     testResults: normalizeHistoryTestResults(historyDataPoint.testResults),
-    metrics: isRecord(historyDataPoint.metrics) ? historyDataPoint.metrics : {},
+    metrics: normalizeHistoryMetrics(historyDataPoint.metrics),
     url: historyDataPoint.url ?? "",
 });
 export const normalizeHistoryDataPointUrls = (historyDataPoint) => {

package/dist/utils/successRate.d.ts

@@ -0,0 +1,3 @@
+import type { Statistic } from "../aggregate.js";
+export declare const getSuccessRateTotal: (statistic: Partial<Statistic>) => number;
+export declare const getSuccessRate: (statistic: Partial<Statistic>) => number;

package/dist/utils/successRate.js

@@ -0,0 +1,6 @@
+import { includedInSuccessRate } from "../constants.js";
+export const getSuccessRateTotal = (statistic) => Array.from(includedInSuccessRate).reduce((total, status) => total + (statistic[status] ?? 0), 0);
+export const getSuccessRate = (statistic) => {
+    const total = getSuccessRateTotal(statistic);
+    return total > 0 ? (statistic.passed ?? 0) / total : 0;
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@allurereport/core-api",
-  "version": "3.16.1",
+  "version": "3.18.0",
   "description": "Allure Core API",
   "keywords": [
     "allure"