@stacknext/playwright 0.0.0-stage → 0.6.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 StackNext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,30 @@
-# Temporary Holding Version
+# @stacknext/playwright
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional Playwright fixtures that correlate browser scenarios with verified
+StackNext server traces.
+
+```ts
+import { stackNextFixtures } from '@stacknext/playwright'
+
+const { test, expect } = stackNextFixtures()
+
+test(
+  'renders the overview',
+  { annotation: { type: 'stacknext.scenario', description: 'app.overview' } },
+  async ({ page }) => {
+    await page.goto('/')
+    await expect(page.getByRole('heading', { name: 'Projects' })).toBeVisible()
+  },
+)
+```
+
+The fixture injects W3C trace context into loopback and `baseURL` requests and
+is inert outside an active `stacknext capture` run. A sample is verified only
+when the collector finds the injected trace and a server span parented to the
+injected span id. There is no time-window fallback.
+
+Captured runs must use one Playwright worker. The package is ESM-only, requires
+Node.js 20.9 or newer, and has an optional `@playwright/test` peer dependency
+(1.40 or newer).
+
+License: MIT.

package/dist/collector-client.d.ts

@@ -0,0 +1,24 @@
+import type { SampleSubmission, ScenarioIdentity } from '@stacknext/regression';
+export interface CaptureConfig {
+    runId: string;
+    collectorUrl: string;
+    token: string;
+    settleMs: number;
+    timeoutMs: number;
+}
+export declare class CaptureTransportError extends Error {
+    constructor(message: string);
+}
+/**
+ * Resolves capture state from the environment. Nothing is captured unless the
+ * capture command explicitly started a test run.
+ */
+export declare function resolveCaptureConfig(env?: NodeJS.ProcessEnv): CaptureConfig | null;
+export interface TraceProbe {
+    found: boolean;
+    spanCount: number;
+}
+/** Checks whether a correlated trace has reached the collector store yet. */
+export declare function probeTrace(config: CaptureConfig, traceId: string): Promise<TraceProbe>;
+export declare function submitSample(config: CaptureConfig, scenario: ScenarioIdentity, sample: SampleSubmission): Promise<void>;
+//# sourceMappingURL=collector-client.d.ts.map

package/dist/collector-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collector-client.d.ts","sourceRoot":"","sources":["../src/collector-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAE/E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;IACpB,KAAK,EAAE,MAAM,CAAA;IACb,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qBAAa,qBAAsB,SAAQ,KAAK;gBAClC,OAAO,EAAE,MAAM;CAI5B;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,GAAG,GAAE,MAAM,CAAC,UAAwB,GACnC,aAAa,GAAG,IAAI,CA6BtB;AA4BD,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,OAAO,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,6EAA6E;AAC7E,wBAAsB,UAAU,CAC9B,MAAM,EAAE,aAAa,EACrB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,UAAU,CAAC,CAarB;AAED,wBAAsB,YAAY,CAChC,MAAM,EAAE,aAAa,EACrB,QAAQ,EAAE,gBAAgB,EAC1B,MAAM,EAAE,gBAAgB,GACvB,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/collector-client.js

@@ -0,0 +1,103 @@
+export class CaptureTransportError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CaptureTransportError';
+    }
+}
+function loopbackHost(hostname) {
+    return (hostname === '127.0.0.1' ||
+        hostname === 'localhost' ||
+        hostname === '[::1]' ||
+        hostname === '::1');
+}
+function positiveNumber(value, fallback) {
+    if (!value)
+        return fallback;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) && parsed >= 0 ? parsed : fallback;
+}
+/**
+ * Resolves capture state from the environment. Nothing is captured unless the
+ * capture command explicitly started a test run.
+ */
+export function resolveCaptureConfig(env = process.env) {
+    const runId = env.STACKNEXT_TEST_RUN_ID?.trim();
+    if (!runId)
+        return null;
+    if (!/^run-[0-9a-f]{16}$/.test(runId)) {
+        throw new CaptureTransportError('STACKNEXT_TEST_RUN_ID is not a valid StackNext run id');
+    }
+    const collectorUrl = env.STACKNEXT_COLLECTOR_URL?.trim() ?? '';
+    const token = env.STACKNEXT_TOKEN?.trim() ?? '';
+    if (!collectorUrl || !token) {
+        throw new CaptureTransportError('STACKNEXT_COLLECTOR_URL and STACKNEXT_TOKEN are required when capture is active');
+    }
+    let url;
+    try {
+        url = new URL(collectorUrl);
+    }
+    catch {
+        throw new CaptureTransportError('STACKNEXT_COLLECTOR_URL is not a valid URL');
+    }
+    if (url.protocol !== 'http:' || !loopbackHost(url.hostname)) {
+        throw new CaptureTransportError('StackNext capture only connects to a loopback HTTP collector');
+    }
+    return {
+        runId,
+        collectorUrl: url.origin,
+        token,
+        settleMs: positiveNumber(env.STACKNEXT_CAPTURE_SETTLE_MS, 500),
+        timeoutMs: positiveNumber(env.STACKNEXT_CAPTURE_TIMEOUT_MS, 5_000),
+    };
+}
+async function request(config, pathname, init = {}) {
+    let response;
+    try {
+        response = await fetch(`${config.collectorUrl}${pathname}`, {
+            ...init,
+            headers: {
+                authorization: `Bearer ${config.token}`,
+                ...(init.body ? { 'content-type': 'application/json' } : {}),
+                ...(init.headers ?? {}),
+            },
+            signal: AbortSignal.timeout(Math.max(config.timeoutMs, 1_000)),
+        });
+    }
+    catch (error) {
+        throw new CaptureTransportError(`Could not reach the StackNext collector at ${config.collectorUrl}: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return response;
+}
+/** Checks whether a correlated trace has reached the collector store yet. */
+export async function probeTrace(config, traceId) {
+    const response = await request(config, `/api/traces/${traceId}`);
+    if (response.status === 404)
+        return { found: false, spanCount: 0 };
+    if (!response.ok) {
+        throw new CaptureTransportError(`Collector rejected trace lookup with HTTP ${response.status}`);
+    }
+    const payload = (await response.json());
+    return {
+        found: true,
+        spanCount: Array.isArray(payload.spans) ? payload.spans.length : 0,
+    };
+}
+export async function submitSample(config, scenario, sample) {
+    const response = await request(config, `/api/test-runs/${config.runId}/samples`, {
+        method: 'POST',
+        body: JSON.stringify({ scenario, sample }),
+    });
+    if (!response.ok) {
+        let detail = '';
+        try {
+            const payload = (await response.json());
+            if (payload.error)
+                detail = `: ${payload.error}`;
+        }
+        catch {
+            // Keep the status-only message.
+        }
+        throw new CaptureTransportError(`Collector rejected the captured sample with HTTP ${response.status}${detail}`);
+    }
+}
+//# sourceMappingURL=collector-client.js.map

package/dist/collector-client.js.map

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

package/dist/fixture.d.ts

@@ -0,0 +1,15 @@
+import { expect } from '@playwright/test';
+export { expect };
+type StackNextFixtures = {
+    stacknextCapture: void;
+};
+/**
+ * Auto fixture that injects W3C trace context into same-origin browser requests
+ * and submits only verified, collector-backed evidence for this test.
+ */
+export declare const test: import("@playwright/test").TestType<import("@playwright/test").PlaywrightTestArgs & import("@playwright/test").PlaywrightTestOptions & StackNextFixtures, import("@playwright/test").PlaywrightWorkerArgs & import("@playwright/test").PlaywrightWorkerOptions>;
+export declare function stackNextFixtures(): {
+    test: typeof test;
+    expect: typeof expect;
+};
+//# sourceMappingURL=fixture.d.ts.map

package/dist/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../src/fixture.ts"],"names":[],"mappings":"AAAA,OAAO,EAAgB,MAAM,EAAiB,MAAM,kBAAkB,CAAA;AAEtE,OAAO,EAAE,MAAM,EAAE,CAAA;AAmJjB,KAAK,iBAAiB,GAAG;IACvB,gBAAgB,EAAE,IAAI,CAAA;CACvB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,iQA4Cf,CAAA;AAEF,wBAAgB,iBAAiB,IAAI;IAAE,IAAI,EAAE,OAAO,IAAI,CAAC;IAAC,MAAM,EAAE,OAAO,MAAM,CAAA;CAAE,CAEhF"}

package/dist/fixture.js

@@ -0,0 +1,165 @@
+import { test as base, expect } from '@playwright/test';
+export { expect };
+import { createSampleId, scenarioIdentity, } from '@stacknext/regression';
+import { probeTrace, resolveCaptureConfig, submitSample, } from './collector-client.js';
+import { createTraceparent } from './traceparent.js';
+const INJECTED_TYPES = new Set(['document', 'fetch', 'xhr']);
+const MAX_TRACES = 20;
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+function loopbackHost(hostname) {
+    return (hostname === '127.0.0.1' ||
+        hostname === 'localhost' ||
+        hostname === '[::1]' ||
+        hostname === '::1');
+}
+function shouldInject(rawUrl, baseURL) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        return false;
+    }
+    if (url.protocol !== 'http:' && url.protocol !== 'https:')
+        return false;
+    if (loopbackHost(url.hostname))
+        return true;
+    if (!baseURL)
+        return false;
+    try {
+        return new URL(baseURL).origin === url.origin;
+    }
+    catch {
+        return false;
+    }
+}
+function scenarioAnnotation(testInfo) {
+    for (const annotation of testInfo.annotations) {
+        if (!annotation.type.startsWith('stacknext'))
+            continue;
+        const description = annotation.description?.trim();
+        if (description)
+            return description;
+    }
+    return undefined;
+}
+function identityFor(testInfo) {
+    return scenarioIdentity({
+        title: testInfo.title,
+        file: testInfo.file,
+        project: testInfo.project.name,
+        tags: testInfo.tags,
+        testId: testInfo.testId,
+        annotation: scenarioAnnotation(testInfo),
+        rootDir: testInfo.config.rootDir,
+    });
+}
+async function waitForInjectedTraces(config, injected) {
+    const found = new Map();
+    const documents = injected.filter((request) => request.resourceType === 'document');
+    const deadline = Date.now() + config.timeoutMs;
+    await sleep(config.settleMs);
+    const inspect = async () => {
+        for (const request of injected) {
+            if (found.has(request.traceId))
+                continue;
+            const probe = await probeTrace(config, request.traceId);
+            if (probe.found && probe.spanCount > 0)
+                found.set(request.traceId, probe.spanCount);
+        }
+    };
+    await inspect();
+    while (Date.now() < deadline &&
+        documents.some((request) => !found.has(request.traceId))) {
+        await sleep(150);
+        await inspect();
+    }
+    return found;
+}
+async function captureSample(config, testInfo, injected) {
+    const found = await waitForInjectedTraces(config, injected);
+    const ordered = [...injected].sort((left, right) => {
+        const leftDocument = left.resourceType === 'document' ? 0 : 1;
+        const rightDocument = right.resourceType === 'document' ? 0 : 1;
+        return leftDocument - rightDocument || left.sequence - right.sequence;
+    });
+    const references = ordered
+        .filter((request) => request.resourceType === 'document' || found.has(request.traceId))
+        .slice(0, MAX_TRACES)
+        .map((request) => ({
+        traceId: request.traceId,
+        injectedSpanId: request.spanId,
+    }));
+    const sample = {
+        id: createSampleId(),
+        status: testInfo.status === 'timedOut' ||
+            testInfo.status === 'interrupted' ||
+            testInfo.status === 'failed'
+            ? testInfo.status
+            : 'passed',
+        expectedStatus: testInfo.expectedStatus === 'failed' || testInfo.expectedStatus === 'skipped'
+            ? testInfo.expectedStatus
+            : 'passed',
+        retry: testInfo.retry,
+        repeatEachIndex: testInfo.repeatEachIndex,
+        durationMs: testInfo.duration,
+        capturedAt: Date.now(),
+    };
+    await submitSample(config, identityFor(testInfo), { ...sample, traces: references });
+}
+/**
+ * Auto fixture that injects W3C trace context into same-origin browser requests
+ * and submits only verified, collector-backed evidence for this test.
+ */
+export const test = base.extend({
+    stacknextCapture: [
+        async ({ context }, use, testInfo) => {
+            const config = resolveCaptureConfig();
+            if (!config) {
+                await use();
+                return;
+            }
+            let sequence = 0;
+            const injected = [];
+            const baseURL = testInfo.project.use.baseURL;
+            await context.route('**/*', async (route) => {
+                const request = route.request();
+                if (!INJECTED_TYPES.has(request.resourceType())) {
+                    await route.fallback();
+                    return;
+                }
+                if (!shouldInject(request.url(), baseURL)) {
+                    await route.fallback();
+                    return;
+                }
+                const trace = createTraceparent();
+                injected.push({
+                    traceId: trace.traceId,
+                    spanId: trace.spanId,
+                    resourceType: request.resourceType(),
+                    url: request.url(),
+                    sequence,
+                });
+                sequence += 1;
+                await route.fallback({
+                    headers: {
+                        ...request.headers(),
+                        traceparent: trace.traceparent,
+                    },
+                });
+            });
+            await use();
+            await context.unroute('**/*');
+            if (testInfo.status === 'skipped')
+                return;
+            await captureSample(config, testInfo, injected);
+        },
+        { auto: true },
+    ],
+});
+export function stackNextFixtures() {
+    return { test, expect };
+}
+//# sourceMappingURL=fixture.js.map

package/dist/fixture.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { test, expect, stackNextFixtures } from './fixture.js';
+export { resolveCaptureConfig, CaptureTransportError, type CaptureConfig, } from './collector-client.js';
+export { createTraceparent, type InjectedTraceContext } from './traceparent.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,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAAE,KAAK,oBAAoB,EAAE,MAAM,kBAAkB,CAAA"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { test, expect, stackNextFixtures } from './fixture.js';
+export { resolveCaptureConfig, CaptureTransportError, } from './collector-client.js';
+export { createTraceparent } from './traceparent.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,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAA;AAC9D,OAAO,EACL,oBAAoB,EACpB,qBAAqB,GAEtB,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,iBAAiB,EAA6B,MAAM,kBAAkB,CAAA"}

package/dist/traceparent.d.ts

@@ -0,0 +1,11 @@
+export interface InjectedTraceContext {
+    traceId: string;
+    spanId: string;
+    traceparent: string;
+}
+/**
+ * Creates a W3C trace context for one browser request. The child span id is
+ * what proves server correlation: Next.js must parent a server span to it.
+ */
+export declare function createTraceparent(): InjectedTraceContext;
+//# sourceMappingURL=traceparent.d.ts.map

package/dist/traceparent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.d.ts","sourceRoot":"","sources":["../src/traceparent.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,WAAW,EAAE,MAAM,CAAA;CACpB;AAQD;;;GAGG;AACH,wBAAgB,iBAAiB,IAAI,oBAAoB,CAQxD"}

package/dist/traceparent.js

@@ -0,0 +1,21 @@
+import { randomBytes } from 'node:crypto';
+function nonZeroHex(bytes) {
+    const buffer = randomBytes(bytes);
+    if (buffer.every((value) => value === 0))
+        buffer[bytes - 1] = 1;
+    return buffer.toString('hex');
+}
+/**
+ * Creates a W3C trace context for one browser request. The child span id is
+ * what proves server correlation: Next.js must parent a server span to it.
+ */
+export function createTraceparent() {
+    const traceId = nonZeroHex(16);
+    const spanId = nonZeroHex(8);
+    return {
+        traceId,
+        spanId,
+        traceparent: `00-${traceId}-${spanId}-01`,
+    };
+}
+//# sourceMappingURL=traceparent.js.map

package/dist/traceparent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traceparent.js","sourceRoot":"","sources":["../src/traceparent.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAQzC,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAA;IACjC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;QAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAA;IAC/D,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;AAC/B,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,OAAO,GAAG,UAAU,CAAC,EAAE,CAAC,CAAA;IAC9B,MAAM,MAAM,GAAG,UAAU,CAAC,CAAC,CAAC,CAAA;IAC5B,OAAO;QACL,OAAO;QACP,MAAM;QACN,WAAW,EAAE,MAAM,OAAO,IAAI,MAAM,KAAK;KAC1C,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,62 @@
 {
   "name": "@stacknext/playwright",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.6.1",
+  "description": "Playwright fixtures that correlate browser scenarios with StackNext server telemetry",
+  "license": "MIT",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "dependencies": {
+    "@stacknext/regression": "0.6.1"
+  },
+  "peerDependencies": {
+    "@playwright/test": ">=1.40.0 <2"
+  },
+  "devDependencies": {
+    "@playwright/test": "1.58.2"
+  },
+  "engines": {
+    "node": ">=20.9.0"
+  },
+  "author": "StackNext contributors",
+  "homepage": "https://github.com/marrrkkk/stacknext#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/marrrkkk/stacknext.git",
+    "directory": "packages/playwright"
+  },
+  "bugs": {
+    "url": "https://github.com/marrrkkk/stacknext/issues"
+  },
+  "keywords": [
+    "stacknext",
+    "nextjs",
+    "playwright",
+    "testing",
+    "tracing",
+    "regression-testing"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    }
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit"
+  }
 }