@stacknext/regression 0.0.0-stage → 0.6.0

package/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,uBAAuB,CAAA;AACxD,eAAO,MAAM,yBAAyB,uBAAuB,CAAA;AAC7D,eAAO,MAAM,2BAA2B,yBAAyB,CAAA;AACjE,eAAO,MAAM,mCAAmC,IAAI,CAAA;AACpD,eAAO,MAAM,mCAAmC,UAAU,CAAA;AAE1D,eAAO,MAAM,YAAY,0EAMf,CAAA;AACV,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,YAAY,CAAC,CAAC,MAAM,CAAC,CAAA;AAErD,eAAO,MAAM,eAAe,qEAMlB,CAAA;AACV,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,eAAe,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3D,eAAO,MAAM,wBAAwB,0CAA2C,CAAA;AAChF,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,wBAAwB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5E,eAAO,MAAM,oBAAoB,qCAAsC,CAAA;AACvE,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAA;AAErE,eAAO,MAAM,mBAAmB,iEAKtB,CAAA;AACV,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEnE,eAAO,MAAM,qBAAqB,4CAA6C,CAAA;AAC/E,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAA;AAEvE,eAAO,MAAM,uBAAuB,mEAM1B,CAAA;AACV,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE3E,eAAO,MAAM,qBAAqB,QAAkC,CAAA;AACpE,eAAO,MAAM,mBAAmB,QAAuB,CAAA;AACvD,eAAO,MAAM,iBAAiB,QAAuB,CAAA;AAErD,eAAO,MAAM,0BAA0B;;;;;;;;CAQ7B,CAAA;AAEV,eAAO,MAAM,sBAAsB,krBAOzB,CAAA"}

package/dist/constants.js

@@ -0,0 +1,56 @@
+export const STACKNEXT_RUN_FORMAT = 'stacknext-test-run';
+export const STACKNEXT_BASELINE_FORMAT = 'stacknext-baseline';
+export const STACKNEXT_COMPARISON_FORMAT = 'stacknext-comparison';
+export const STACKNEXT_REGRESSION_FORMAT_VERSION = 1;
+export const STACKNEXT_REGRESSION_ENGINE_VERSION = '0.6.0';
+export const RUN_STATUSES = [
+    'running',
+    'completed',
+    'failed',
+    'interrupted',
+    'incomplete',
+];
+export const SAMPLE_STATUSES = [
+    'passed',
+    'failed',
+    'timedOut',
+    'skipped',
+    'interrupted',
+];
+export const SAMPLE_EXPECTED_STATUSES = ['passed', 'failed', 'skipped'];
+export const CORRELATION_STATUSES = ['verified', 'incomplete'];
+export const REGRESSION_STATUSES = [
+    'improved',
+    'regressed',
+    'unchanged',
+    'inconclusive',
+];
+export const REGRESSION_SEVERITIES = ['high', 'medium', 'low', 'none'];
+export const REGRESSION_METRIC_KINDS = [
+    'duration',
+    'count',
+    'test-status',
+    'error',
+    'finding',
+];
+export const REGRESSION_ID_PATTERN = /^(run|base|cmp)-[0-9a-f]{16}$/;
+export const SCENARIO_ID_PATTERN = /^scn-[0-9a-f]{16}$/;
+export const SAMPLE_ID_PATTERN = /^smp-[0-9a-f]{16}$/;
+export const DEFAULT_COMPARISON_OPTIONS = {
+    minSamples: 3,
+    durationRegressionPct: 20,
+    durationRegressionMs: 25,
+    durationImprovementPct: 20,
+    durationImprovementMs: 25,
+    countRegressionMin: 1,
+    ignoreEnvironment: false,
+};
+export const REGRESSION_LIMITATIONS = [
+    'Comparisons use only telemetry correlated to Playwright scenario samples in the captured run.',
+    'Durations are wall-clock measurements from the local run and include machine and dev-server noise.',
+    'Medians reduce noise but are not a statistical significance test; StackNext makes no significance claim.',
+    'Null database durations are unmeasured and are never converted to zero.',
+    'A baseline or candidate with missing samples, incomplete correlation or a changed trace shape is inconclusive by default.',
+    'Environment differences such as Node.js, Next.js, OS, runtime, database, instrumentation or verbose tracing make a comparison inconclusive unless explicitly overridden.',
+];
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,oBAAoB,GAAG,oBAAoB,CAAA;AACxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AAC7D,MAAM,CAAC,MAAM,2BAA2B,GAAG,sBAAsB,CAAA;AACjE,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAA;AACpD,MAAM,CAAC,MAAM,mCAAmC,GAAG,OAAO,CAAA;AAE1D,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,SAAS;IACT,WAAW;IACX,QAAQ;IACR,aAAa;IACb,YAAY;CACJ,CAAA;AAGV,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,SAAS;IACT,aAAa;CACL,CAAA;AAGV,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAA;AAGhF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAU,EAAE,YAAY,CAAU,CAAA;AAGvE,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,UAAU;IACV,WAAW;IACX,WAAW;IACX,cAAc;CACN,CAAA;AAGV,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAU,CAAA;AAG/E,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,UAAU;IACV,OAAO;IACP,aAAa;IACb,OAAO;IACP,SAAS;CACD,CAAA;AAGV,MAAM,CAAC,MAAM,qBAAqB,GAAG,+BAA+B,CAAA;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAG,oBAAoB,CAAA;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAA;AAErD,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,UAAU,EAAE,CAAC;IACb,qBAAqB,EAAE,EAAE;IACzB,oBAAoB,EAAE,EAAE;IACxB,sBAAsB,EAAE,EAAE;IAC1B,qBAAqB,EAAE,EAAE;IACzB,kBAAkB,EAAE,CAAC;IACrB,iBAAiB,EAAE,KAAK;CAChB,CAAA;AAEV,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,+FAA+F;IAC/F,oGAAoG;IACpG,0GAA0G;IAC1G,yEAAyE;IACzE,2HAA2H;IAC3H,0KAA0K;CAClK,CAAA"}

package/dist/environment.d.ts

@@ -0,0 +1,23 @@
+import { type ConnectionInfo, type NextOtelVerboseStatus, type StackNextConfig } from '@stacknext/core';
+import type { EnvironmentDifference, EnvironmentSnapshot } from './schema.js';
+export interface BuildEnvironmentInput {
+    config: StackNextConfig;
+    connections?: ConnectionInfo[];
+    verbose?: NextOtelVerboseStatus;
+    nodeVersion?: string;
+    platform?: string;
+    arch?: string;
+    observedDatabases?: string[];
+    playwrightVersion?: string;
+}
+/**
+ * Captures only environment facts that can change runtime measurements. No
+ * hostnames, usernames, tokens or machine identifiers are stored.
+ */
+export declare function buildEnvironmentSnapshot(input: BuildEnvironmentInput): EnvironmentSnapshot;
+/**
+ * Compares the environment recorded with each side. Any difference defaults to
+ * an inconclusive comparison unless the caller explicitly overrides it.
+ */
+export declare function compareEnvironments(baseline: EnvironmentSnapshot, candidate: EnvironmentSnapshot): EnvironmentDifference[];
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACrB,MAAM,iBAAiB,CAAA;AACxB,OAAO,KAAK,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAA;AAE7E,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,eAAe,CAAA;IACvB,WAAW,CAAC,EAAE,cAAc,EAAE,CAAA;IAC9B,OAAO,CAAC,EAAE,qBAAqB,CAAA;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAA;CAC3B;AAuBD;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,qBAAqB,GAC3B,mBAAmB,CAwBrB;AAwBD;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,SAAS,EAAE,mBAAmB,GAC7B,qBAAqB,EAAE,CAczB"}

package/dist/environment.js

@@ -0,0 +1,86 @@
+import { STACKNEXT_SDK_VERSION, } from '@stacknext/core';
+function latestConnection(connections) {
+    if (!connections || connections.length === 0)
+        return null;
+    return [...connections].sort((a, b) => b.lastSeen - a.lastSeen)[0] ?? null;
+}
+function databaseNames(config, observed) {
+    const names = new Set();
+    if (config.database.drizzle)
+        names.add('drizzle');
+    if (config.database.prisma)
+        names.add('prisma');
+    for (const name of observed ?? []) {
+        const normalized = name.trim().toLowerCase();
+        if (normalized !== '')
+            names.add(normalized);
+    }
+    return [...names].sort();
+}
+/**
+ * Captures only environment facts that can change runtime measurements. No
+ * hostnames, usernames, tokens or machine identifiers are stored.
+ */
+export function buildEnvironmentSnapshot(input) {
+    const connection = latestConnection(input.connections);
+    const verbose = input.verbose ?? {
+        enabled: input.config.instrumentation.verbose,
+        source: input.config.instrumentation.verbose ? 'config' : 'disabled',
+    };
+    return {
+        nodeVersion: connection?.runtimeVersion ?? input.nodeVersion ?? process.version,
+        nextVersion: connection?.nextVersion ?? null,
+        platform: input.platform ?? process.platform,
+        arch: input.arch ?? process.arch,
+        runtime: 'nodejs',
+        databases: databaseNames(input.config, input.observedDatabases),
+        instrumentation: {
+            verbose: verbose.enabled,
+            verboseSource: verbose.source,
+            captureFetch: input.config.instrumentation.captureFetch,
+            captureErrors: input.config.instrumentation.captureErrors,
+        },
+        sdkVersion: connection?.sdkVersion ?? STACKNEXT_SDK_VERSION,
+        ...(input.playwrightVersion
+            ? { playwrightVersion: input.playwrightVersion.slice(0, 100) }
+            : {}),
+    };
+}
+function valueOrNone(value) {
+    return value && value !== '' ? value : 'none';
+}
+function environmentValues(environment) {
+    return [
+        ['nodeVersion', environment.nodeVersion],
+        ['nextVersion', valueOrNone(environment.nextVersion)],
+        ['platform', environment.platform],
+        ['arch', environment.arch],
+        ['runtime', environment.runtime],
+        ['databases', environment.databases.join(',') || 'none'],
+        ['instrumentation.verbose', environment.instrumentation.verbose ? 'enabled' : 'disabled'],
+        ['instrumentation.captureFetch', environment.instrumentation.captureFetch ? 'enabled' : 'disabled'],
+        ['instrumentation.captureErrors', environment.instrumentation.captureErrors ? 'enabled' : 'disabled'],
+        ['sdkVersion', environment.sdkVersion],
+        ['playwrightVersion', valueOrNone(environment.playwrightVersion)],
+    ];
+}
+/**
+ * Compares the environment recorded with each side. Any difference defaults to
+ * an inconclusive comparison unless the caller explicitly overrides it.
+ */
+export function compareEnvironments(baseline, candidate) {
+    const candidateValues = new Map(environmentValues(candidate));
+    const differences = [];
+    for (const [field, baselineValue] of environmentValues(baseline)) {
+        const candidateValue = candidateValues.get(field) ?? 'none';
+        if (baselineValue !== candidateValue) {
+            differences.push({
+                field,
+                baseline: baselineValue.slice(0, 500),
+                candidate: candidateValue.slice(0, 500),
+            });
+        }
+    }
+    return differences.sort((a, b) => (a.field < b.field ? -1 : a.field > b.field ? 1 : 0));
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,qBAAqB,GAItB,MAAM,iBAAiB,CAAA;AAcxB,SAAS,gBAAgB,CACvB,WAAyC;IAEzC,IAAI,CAAC,WAAW,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAA;IACzD,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;AAC5E,CAAC;AAED,SAAS,aAAa,CACpB,MAAuB,EACvB,QAA8B;IAE9B,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,IAAI,MAAM,CAAC,QAAQ,CAAC,OAAO;QAAE,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;IACjD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM;QAAE,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAA;IAC/C,KAAK,MAAM,IAAI,IAAI,QAAQ,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;QAC5C,IAAI,UAAU,KAAK,EAAE;YAAE,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,CAAA;IAC9C,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA;AAC1B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,KAA4B;IAE5B,MAAM,UAAU,GAAG,gBAAgB,CAAC,KAAK,CAAC,WAAW,CAAC,CAAA;IACtD,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI;QAC/B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO;QAC7C,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU;KACrE,CAAA;IACD,OAAO;QACL,WAAW,EAAE,UAAU,EAAE,cAAc,IAAI,KAAK,CAAC,WAAW,IAAI,OAAO,CAAC,OAAO;QAC/E,WAAW,EAAE,UAAU,EAAE,WAAW,IAAI,IAAI;QAC5C,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ;QAC5C,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI;QAChC,OAAO,EAAE,QAAQ;QACjB,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,iBAAiB,CAAC;QAC/D,eAAe,EAAE;YACf,OAAO,EAAE,OAAO,CAAC,OAAO;YACxB,aAAa,EAAE,OAAO,CAAC,MAAM;YAC7B,YAAY,EAAE,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,YAAY;YACvD,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC,aAAa;SAC1D;QACD,UAAU,EAAE,UAAU,EAAE,UAAU,IAAI,qBAAqB;QAC3D,GAAG,CAAC,KAAK,CAAC,iBAAiB;YACzB,CAAC,CAAC,EAAE,iBAAiB,EAAE,KAAK,CAAC,iBAAiB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE;YAC9D,CAAC,CAAC,EAAE,CAAC;KACR,CAAA;AACH,CAAC;AAED,SAAS,WAAW,CAAC,KAAgC;IACnD,OAAO,KAAK,IAAI,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAA;AAC/C,CAAC;AAED,SAAS,iBAAiB,CACxB,WAAgC;IAEhC,OAAO;QACL,CAAC,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC;QACxC,CAAC,aAAa,EAAE,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;QACrD,CAAC,UAAU,EAAE,WAAW,CAAC,QAAQ,CAAC;QAClC,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;QAC1B,CAAC,SAAS,EAAE,WAAW,CAAC,OAAO,CAAC;QAChC,CAAC,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC;QACxD,CAAC,yBAAyB,EAAE,WAAW,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACzF,CAAC,8BAA8B,EAAE,WAAW,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACnG,CAAC,+BAA+B,EAAE,WAAW,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;QACrG,CAAC,YAAY,EAAE,WAAW,CAAC,UAAU,CAAC;QACtC,CAAC,mBAAmB,EAAE,WAAW,CAAC,WAAW,CAAC,iBAAiB,CAAC,CAAC;KAClE,CAAA;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CACjC,QAA6B,EAC7B,SAA8B;IAE9B,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAA;IAC7D,MAAM,WAAW,GAA4B,EAAE,CAAA;IAC/C,KAAK,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,IAAI,iBAAiB,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjE,MAAM,cAAc,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,MAAM,CAAA;QAC3D,IAAI,aAAa,KAAK,cAAc,EAAE,CAAC;YACrC,WAAW,CAAC,IAAI,CAAC;gBACf,KAAK;gBACL,QAAQ,EAAE,aAAa,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;gBACrC,SAAS,EAAE,cAAc,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;aACxC,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AACzF,CAAC"}

package/dist/identity.d.ts

@@ -0,0 +1,35 @@
+import { type StackNextSpan, type TraceDetail } from '@stacknext/core';
+import { diagnosticSpanCategory } from '@stacknext/diagnostics';
+import type { ScenarioIdentity } from './schema.js';
+/** Removes dynamic path segments so trace and span identities survive test data changes. */
+export declare function normalizePathLike(value: string): string;
+export declare function normalizeSpanName(value: string): string;
+/**
+ * Scenario ids are stable hashes. An explicit `stacknext` Playwright annotation
+ * wins; Playwright's stable test id is the next choice; file/title/project is
+ * the final fallback. The raw annotation value is never used as a path or id.
+ */
+export declare function scenarioIdentity(input: {
+    title: string;
+    file: string;
+    project: string;
+    tags?: string[];
+    testId?: string;
+    annotation?: string;
+    rootDir?: string;
+}): ScenarioIdentity;
+export declare function normalizeScenarioFile(file: string, rootDir?: string): string;
+export declare function traceIdentity(detail: Pick<TraceDetail, 'request' | 'spans'>): {
+    key: string;
+    method: string | null;
+    route: string | null;
+    rootName: string;
+};
+export declare function spanIdentity(span: StackNextSpan): {
+    key: string;
+    name: string;
+    category: ReturnType<typeof diagnosticSpanCategory>;
+};
+/** Redacts local account paths and URL query values from stored command arguments. */
+export declare function sanitizeCommandArg(value: string): string;
+//# sourceMappingURL=identity.d.ts.map

package/dist/identity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.d.ts","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"AAEA,OAAO,EAGL,KAAK,aAAa,EAElB,KAAK,WAAW,EACjB,MAAM,iBAAiB,CAAA;AACxB,OAAO,EACL,sBAAsB,EAKvB,MAAM,wBAAwB,CAAA;AAC/B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAiBnD,4FAA4F;AAC5F,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASvD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,GAAG,gBAAgB,CAwBnB;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAY5E;AAoBD,wBAAgB,aAAa,CAC3B,MAAM,EAAE,IAAI,CAAC,WAAW,EAAE,SAAS,GAAG,OAAO,CAAC,GAC7C;IACD,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IACrB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;IACpB,QAAQ,EAAE,MAAM,CAAA;CACjB,CAaA;AAED,wBAAgB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG;IACjD,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,UAAU,CAAC,OAAO,sBAAsB,CAAC,CAAA;CACpD,CAgBA;AAED,sFAAsF;AACtF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOxD"}

package/dist/identity.js

@@ -0,0 +1,121 @@
+import { createHash } from 'node:crypto';
+import path from 'node:path';
+import { redactText, stripUrlQueryInText, } from '@stacknext/core';
+import { diagnosticSpanCategory, safeRoute, safeSpanName, spanHttpEndpoint, spanHttpMethod, } from '@stacknext/diagnostics';
+const ID_SEGMENT_PATTERNS = [
+    /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+    /^[0-9a-f]{16,}$/i,
+    /^[a-zA-Z0-9_-]{32,}$/,
+    /^\d+$/,
+];
+function shortHash(value) {
+    return createHash('sha256').update(value).digest('hex').slice(0, 16);
+}
+function safeText(value, maxLength) {
+    return stripUrlQueryInText(redactText(value, maxLength));
+}
+/** Removes dynamic path segments so trace and span identities survive test data changes. */
+export function normalizePathLike(value) {
+    const withoutQuery = safeText(value, 1_000);
+    const segments = withoutQuery.split('/');
+    return segments
+        .map((segment, index) => {
+        if (index === 0)
+            return segment;
+        return ID_SEGMENT_PATTERNS.some((pattern) => pattern.test(segment)) ? ':id' : segment;
+    })
+        .join('/');
+}
+export function normalizeSpanName(value) {
+    return normalizePathLike(value).replace(/\s+/g, ' ').trim().slice(0, 300);
+}
+/**
+ * Scenario ids are stable hashes. An explicit `stacknext` Playwright annotation
+ * wins; Playwright's stable test id is the next choice; file/title/project is
+ * the final fallback. The raw annotation value is never used as a path or id.
+ */
+export function scenarioIdentity(input) {
+    const file = normalizeScenarioFile(input.file, input.rootDir);
+    const title = safeText(input.title, 500);
+    const project = safeText(input.project || 'default', 200);
+    const annotation = input.annotation?.trim();
+    const testId = input.testId?.trim();
+    const source = annotation
+        ? 'annotation'
+        : testId
+            ? 'test-id'
+            : 'title';
+    const basis = annotation
+        ? `annotation\u0000${annotation}`
+        : testId
+            ? `test-id\u0000${testId}`
+            : `title\u0000${file}\u0000${title}\u0000${project}`;
+    return {
+        id: `scn-${shortHash(basis)}`,
+        source,
+        title,
+        file,
+        project,
+        tags: [...new Set((input.tags ?? []).map((tag) => safeText(tag, 100)))].slice(0, 20),
+    };
+}
+export function normalizeScenarioFile(file, rootDir) {
+    let value = file.replace(/\\/g, '/');
+    if (path.isAbsolute(value)) {
+        if (rootDir) {
+            const relative = path.relative(rootDir, value).replace(/\\/g, '/');
+            value = relative.startsWith('..') ? path.basename(value) : relative;
+        }
+        else {
+            value = path.basename(value);
+        }
+    }
+    value = value.replace(/^\.\//, '');
+    return value === '' ? 'unknown.spec.ts' : value.slice(0, 1_000);
+}
+function compareText(left, right) {
+    return left < right ? -1 : left > right ? 1 : 0;
+}
+function traceRoot(detail) {
+    const spanIds = new Set(detail.spans.map((span) => span.spanId));
+    const roots = detail.spans.filter((span) => !span.parentSpanId || !spanIds.has(span.parentSpanId));
+    const candidates = roots.length > 0 ? roots : detail.spans;
+    return [...candidates].sort((left, right) => left.startTime - right.startTime || compareText(left.spanId, right.spanId))[0];
+}
+export function traceIdentity(detail) {
+    const root = traceRoot(detail);
+    const request = detail.request;
+    const optionRoute = safeRoute(request?.route ?? root?.route);
+    const rootName = safeSpanName(root?.name ?? request?.name ?? 'trace');
+    const route = optionRoute ?? (rootName ? safeRoute(rootName) : null);
+    const method = request?.method ?? root?.method ?? null;
+    return {
+        key: [method ?? '', route ?? '', normalizeSpanName(rootName)].join('|').slice(0, 2_000),
+        method,
+        route,
+        rootName,
+    };
+}
+export function spanIdentity(span) {
+    const category = diagnosticSpanCategory(span);
+    const name = safeSpanName(span.name);
+    const method = category === 'http' ? spanHttpMethod(span) ?? '' : '';
+    const endpoint = category === 'http' ? spanHttpEndpoint(span) ?? normalizeSpanName(name) : normalizeSpanName(name);
+    const key = [
+        category,
+        span.kind,
+        span.nextSpanType ?? '',
+        method,
+        endpoint,
+    ]
+        .join('|')
+        .slice(0, 2_000);
+    return { key, name, category };
+}
+/** Redacts local account paths and URL query values from stored command arguments. */
+export function sanitizeCommandArg(value) {
+    let output = stripUrlQueryInText(redactText(value, 500));
+    output = output.replace(/^(?:[A-Za-z]:\\Users\\[^\\]+|\/home\/[^/]+|\/Users\/[^/]+)/, '~');
+    return output;
+}
+//# sourceMappingURL=identity.js.map

package/dist/identity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"identity.js","sourceRoot":"","sources":["../src/identity.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from './constants.js';
+export * from './schema.js';
+export * from './identity.js';
+export * from './capture.js';
+export * from './environment.js';
+export * from './stats.js';
+export * from './storage.js';
+export * from './compare.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export * from './constants.js';
+export * from './schema.js';
+export * from './identity.js';
+export * from './capture.js';
+export * from './environment.js';
+export * from './stats.js';
+export * from './storage.js';
+export * from './compare.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA"}