@plan2net/typo3-playwright-toolkit 0.1.0

package/dist/global-teardown.js

@@ -0,0 +1,269 @@
+import * as fs from 'fs';
+import * as path from 'path';
+import { getToolkitConfig } from './config.js';
+import { httpCleanup } from './http/cleanup-client.js';
+import { readAttemptsFrom, readRegisteredTestIds } from './state/attempt-registry.js';
+import { listRunIds, runLastActiveMs, runPaths, runsRoot } from './state/run-namespace.js';
+import { assertDeletableDirectory, safeJoin } from './state/safe-paths.js';
+import { inspectUrl } from './inspect/token.js';
+import { resolveApiSecret } from './http/api-secret.js';
+export const DEFAULT_ORPHAN_AGE_MS = 86_400_000;
+/** Age at which a TYPO3 session directory is no longer any run's. */
+const STALE_SESSION_AGE_MS = 60 * 60 * 1000;
+const ALL_SCENARIOS = '*';
+export function failedScenarioKeys(config) {
+    const directory = runPaths(config).failuresDir;
+    if (!fs.existsSync(directory)) {
+        return [];
+    }
+    const keys = new Set();
+    for (const entry of fs.readdirSync(directory)) {
+        if (!entry.endsWith('.json')) {
+            continue;
+        }
+        try {
+            const record = JSON.parse(fs.readFileSync(path.join(directory, entry), 'utf-8'));
+            keys.add('string' === typeof record.scenarioKey ? record.scenarioKey : ALL_SCENARIOS);
+        }
+        catch {
+            // The run we cannot read is the one most likely to need its databases.
+            console.error(`[teardown] Unreadable failure record ${entry}: keeping every database.`);
+            keys.add(ALL_SCENARIOS);
+        }
+    }
+    return [...keys];
+}
+export function preservedTestIds(config) {
+    const failed = new Set(failedScenarioKeys(config));
+    if (failed.size === 0) {
+        return [];
+    }
+    const attempts = readAttemptsFrom(runPaths(config).attemptsFile);
+    const keepAll = failed.has(ALL_SCENARIOS);
+    return [
+        ...new Set(attempts
+            .filter((attempt) => keepAll || failed.has(attempt.key))
+            .map((attempt) => attempt.testId)),
+    ];
+}
+export function resolvePreservePlan(config, cleanupSwitchedOff) {
+    if (cleanupSwitchedOff) {
+        return { mode: 'all', reason: 'NO_DATABASE_CLEANUP=1' };
+    }
+    const failed = failedScenarioKeys(config);
+    if (failed.length === 0) {
+        return { mode: 'none' };
+    }
+    const reason = `${failed.length} failed scenario${failed.length === 1 ? '' : 's'}`;
+    switch (config.cleanup?.preserveOnFailure ?? 'failed') {
+        case 'none':
+            return { mode: 'none' };
+        case 'all':
+            return { mode: 'all', reason };
+        default:
+            return { mode: 'some', testIds: preservedTestIds(config), reason };
+    }
+}
+function preserveList(plan) {
+    return 'some' === plan.mode ? plan.testIds : [];
+}
+/** Only live runs go in `keepTestIds`; an abandoned run's databases are dropped. */
+export async function sweepOrphans(config, cleanup, now = Date.now()) {
+    const { stateDir } = config.paths;
+    const orphanAgeMs = config.cleanup?.orphanAgeMs ?? DEFAULT_ORPHAN_AGE_MS;
+    const cutoff = now - orphanAgeMs;
+    const currentRunId = runPaths(config).runId;
+    let reclaimed = 0;
+    const liveTestIds = new Set();
+    const abandonedRunIds = [];
+    for (const runId of listRunIds(stateDir)) {
+        const runDir = path.join(runsRoot(stateDir), runId);
+        const lastActiveMs = runLastActiveMs(runDir);
+        if (lastActiveMs === 0) {
+            continue;
+        }
+        if (runId !== currentRunId && lastActiveMs < cutoff) {
+            abandonedRunIds.push(runId);
+            continue;
+        }
+        for (const attempt of readAttemptsFrom(path.join(runDir, 'attempts.jsonl'))) {
+            liveTestIds.add(attempt.testId);
+        }
+    }
+    for (const runId of abandonedRunIds) {
+        const runDir = path.join(runsRoot(stateDir), runId);
+        // Re-check: another sweeper may have taken it, or it may have woken up.
+        const stillAbandoned = runLastActiveMs(runDir);
+        if (stillAbandoned === 0 || stillAbandoned >= cutoff) {
+            // A run that woke up is live now, and its ids were left out of the
+            // keep set during the first pass — so without this the sweep below
+            // would reclaim the databases it has just started using again.
+            for (const attempt of readAttemptsFrom(path.join(runDir, 'attempts.jsonl'))) {
+                liveTestIds.add(attempt.testId);
+            }
+            continue;
+        }
+        const testIds = readAttemptsFrom(path.join(runDir, 'attempts.jsonl')).map((attempt) => attempt.testId);
+        const results = await cleanup.drop(testIds);
+        reclaimed += results.filter((result) => 'dropped' === result.outcome).length;
+        // Only a failure is worth retrying, so the directory survives just that.
+        if (results.some((result) => 'failed' === result.outcome)) {
+            console.error(`[teardown] Keeping abandoned run ${runId}: some databases could not be dropped.`);
+            continue;
+        }
+        fs.rmSync(runDir, { recursive: true, force: true });
+    }
+    const sweep = await cleanup.sweep([...liveTestIds], orphanAgeMs);
+    reclaimed += sweep.results.filter((result) => 'dropped' === result.outcome).length;
+    return reclaimed;
+}
+export function describePreservedRun(config, keptTestIds, secret = '', now = Date.now()) {
+    const paths = runPaths(config);
+    const attempts = readAttemptsFrom(paths.attemptsFile);
+    const kept = undefined === keptTestIds ? attempts : attempts.filter((a) => keptTestIds.includes(a.testId));
+    if (kept.length === 0) {
+        return `[teardown] Run ${paths.runId} preserved (no databases recorded).`;
+    }
+    const lines = kept.map((attempt) => {
+        const line = `  ${attempt.name ?? attempt.key} → db${attempt.testId}`;
+        if ('' === secret) {
+            return line;
+        }
+        return `${line}\n    ${inspectUrl(config.testingURL, secret, attempt.testId, now)}`;
+    });
+    const dropped = attempts.length - kept.length;
+    const alsoDropped = dropped > 0 ? `, ${dropped} passing one(s) dropped` : '';
+    return [
+        `[teardown] Run ${paths.runId} kept ${kept.length} database(s)${alsoDropped}:`,
+        ...lines,
+    ].join('\n');
+}
+export async function runTeardown(config, options) {
+    const { stateDir, sessionDir } = config.paths;
+    const { cleanup, preserve } = options;
+    // setToolkitConfig bypasses defineToolkitConfig, so re-check here: everything
+    // below this line deletes recursively.
+    assertDeletableDirectory('stateDir', stateDir, config.paths.consumerRoot);
+    assertDeletableDirectory('sessionDir', sessionDir, config.paths.consumerRoot);
+    const kept = 'all' === preserve.mode ? readRegisteredTestIds(config) : preserveList(preserve);
+    const drop = 'all' === preserve.mode
+        ? { dropped: 0, leaked: [], incomplete: false }
+        : await dropRegisteredDatabases(config, cleanup, kept);
+    // A partial preserve still sweeps: the kept ids reach keepTestIds through
+    // this run's attempts.jsonl.
+    if ('all' !== preserve.mode) {
+        await sweepOrphans(config, cleanup);
+    }
+    const cleanedSessions = pruneStaleSessions(sessionDir, Date.now() - STALE_SESSION_AGE_MS);
+    if ('none' === preserve.mode) {
+        removeRunState(config, drop.incomplete);
+        report(drop.dropped, cleanedSessions);
+    }
+    return { dropped: drop.dropped, leaked: drop.leaked, preserved: kept };
+}
+async function dropRegisteredDatabases(config, cleanup, keep) {
+    const report = { dropped: 0, leaked: [], incomplete: false };
+    const kept = new Set(keep);
+    const targets = readRegisteredTestIds(config).filter((testId) => !kept.has(testId));
+    if (targets.length === 0) {
+        return report;
+    }
+    for (const result of await cleanup.drop(targets)) {
+        if ('dropped' === result.outcome) {
+            report.dropped++;
+            continue;
+        }
+        // Only a failure can change on a retry, so only it keeps the registry.
+        if ('failed' === result.outcome) {
+            report.incomplete = true;
+            report.leaked.push(result.testId);
+            continue;
+        }
+        // Terminal but worth saying out loud: something else owns a name this
+        // run recorded, or the id was never contract-shaped.
+        if ('absent' !== result.outcome) {
+            console.error(`[teardown] db${result.testId}: ${result.outcome}`);
+            report.leaked.push(result.testId);
+        }
+    }
+    return report;
+}
+function pruneStaleSessions(sessionDir, cutoffMs) {
+    if (!fs.existsSync(sessionDir)) {
+        return 0;
+    }
+    let cleaned = 0;
+    for (const dir of fs.readdirSync(sessionDir)) {
+        const sessionPath = safeJoin(sessionDir, dir);
+        // sessionDir is shared, so another teardown may have taken it since the listing.
+        const stats = fs.statSync(sessionPath, { throwIfNoEntry: false });
+        if (stats?.isDirectory() && stats.mtimeMs < cutoffMs) {
+            fs.rmSync(sessionPath, { recursive: true, force: true });
+            cleaned++;
+        }
+    }
+    return cleaned;
+}
+function removeRunState(config, keepRegistry) {
+    const paths = runPaths(config);
+    // Keep the registry when anything was left behind: it is the only record of
+    // the leak. Only this run's directory either way — other runs live in stateDir too.
+    if (keepRegistry) {
+        console.error(`[teardown] Keeping ${paths.runDir}: some databases could not be dropped. ` +
+            'Their ids are in attempts.jsonl.');
+        return;
+    }
+    fs.rmSync(paths.runDir, { recursive: true, force: true });
+}
+function report(droppedDatabases, cleanedSessions) {
+    const parts = [];
+    if (droppedDatabases > 0) {
+        parts.push(`${droppedDatabases} DBs`);
+    }
+    if (cleanedSessions > 0) {
+        parts.push(`${cleanedSessions} session dirs`);
+    }
+    if (parts.length > 0) {
+        console.log(`[teardown] Cleaned ${parts.join(', ')}.`);
+    }
+}
+async function globalTeardown() {
+    const config = getToolkitConfig();
+    const preserve = resolvePreservePlan(config, process.env.NO_DATABASE_CLEANUP === '1');
+    let summary;
+    try {
+        summary = await runTeardown(config, { cleanup: httpCleanup(config), preserve });
+        if ('none' !== preserve.mode) {
+            console.log(`[teardown] Kept for debugging (${preserve.reason}).`);
+            console.log(describePreservedRun(config, 'some' === preserve.mode ? preserve.testIds : undefined, inspectSecret(config)));
+        }
+    }
+    catch (error) {
+        console.error('[teardown] Error during cleanup:', error);
+        if (failOnLeak(config)) {
+            throw error;
+        }
+        return;
+    }
+    if (summary.leaked.length > 0 && failOnLeak(config)) {
+        // Swallowing this is how a suite stays green while it fills the disk.
+        throw new Error(`[teardown] ${summary.leaked.length} test database(s) could not be dropped: ` +
+            `${summary.leaked.map((testId) => `db${testId}`).join(', ')}. ` +
+            'Set cleanup.failOnLeak to false to downgrade this to a warning.');
+    }
+}
+/** No secret means no link; the databases are still named, which is the important part. */
+function inspectSecret(config) {
+    try {
+        return resolveApiSecret(config);
+    }
+    catch {
+        return '';
+    }
+}
+/** Defaults to failing in CI, where a leak has no one watching the output. */
+function failOnLeak(config) {
+    return config.cleanup?.failOnLeak ?? !!process.env.CI;
+}
+export default globalTeardown;
+//# sourceMappingURL=global-teardown.js.map

package/dist/global-teardown.js.map

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

package/dist/http/api-secret.d.ts

@@ -0,0 +1,11 @@
+import type { ToolkitConfig } from '../config.js';
+export declare const SECRET_HEADER = "X-Playwright-Toolkit-Secret";
+export declare const SECRET_ENV = "PLAYWRIGHT_TOOLKIT_SECRET";
+/** Where `playwright:prepare` writes it, inside TYPO3's var path. */
+export declare function secretFileFor(config: ToolkitConfig): string;
+/**
+ * Every test endpoint requires this, so failing here is better than failing on
+ * each request with an unexplained 401.
+ */
+export declare function resolveApiSecret(config: ToolkitConfig): string;
+//# sourceMappingURL=api-secret.d.ts.map

package/dist/http/api-secret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-secret.d.ts","sourceRoot":"","sources":["../../src/http/api-secret.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,eAAO,MAAM,aAAa,gCAAgC,CAAA;AAC1D,eAAO,MAAM,UAAU,8BAA8B,CAAA;AAErD,qEAAqE;AACrE,wBAAgB,aAAa,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAE3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,aAAa,GAAG,MAAM,CAiB9D"}

package/dist/http/api-secret.js

@@ -0,0 +1,27 @@
+import * as fs from 'fs';
+import * as path from 'path';
+export const SECRET_HEADER = 'X-Playwright-Toolkit-Secret';
+export const SECRET_ENV = 'PLAYWRIGHT_TOOLKIT_SECRET';
+/** Where `playwright:prepare` writes it, inside TYPO3's var path. */
+export function secretFileFor(config) {
+    return path.join(config.paths.consumerRoot, 'var', 'playwright', 'api-secret');
+}
+/**
+ * Every test endpoint requires this, so failing here is better than failing on
+ * each request with an unexplained 401.
+ */
+export function resolveApiSecret(config) {
+    const fromEnvironment = (process.env[SECRET_ENV] ?? '').trim();
+    if (fromEnvironment) {
+        return fromEnvironment;
+    }
+    const file = secretFileFor(config);
+    const fromFile = fs.existsSync(file) ? fs.readFileSync(file, 'utf-8').trim() : '';
+    if (fromFile) {
+        return fromFile;
+    }
+    throw new Error(`[typo3-playwright-toolkit] No test API secret. Run \`ddev playwright-prepare\` ` +
+        `(or \`typo3 playwright:prepare\`) to create ${file}, or set ${SECRET_ENV} ` +
+        'to the same value when PHP and Node do not share a filesystem.');
+}
+//# sourceMappingURL=api-secret.js.map

package/dist/http/api-secret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-secret.js","sourceRoot":"","sources":["../../src/http/api-secret.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAA;AACxB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAA;AAG5B,MAAM,CAAC,MAAM,aAAa,GAAG,6BAA6B,CAAA;AAC1D,MAAM,CAAC,MAAM,UAAU,GAAG,2BAA2B,CAAA;AAErD,qEAAqE;AACrE,MAAM,UAAU,aAAa,CAAC,MAAqB;IAC/C,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,CAAC,CAAA;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAAqB;IAClD,MAAM,eAAe,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC9D,IAAI,eAAe,EAAE,CAAC;QAClB,OAAO,eAAe,CAAA;IAC1B,CAAC;IAED,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,CAAC,CAAA;IAClC,MAAM,QAAQ,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IACjF,IAAI,QAAQ,EAAE,CAAC;QACX,OAAO,QAAQ,CAAA;IACnB,CAAC;IAED,MAAM,IAAI,KAAK,CACX,iFAAiF;QAC7E,+CAA+C,IAAI,YAAY,UAAU,GAAG;QAC5E,gEAAgE,CACvE,CAAA;AACL,CAAC"}

package/dist/http/cleanup-client.d.ts

@@ -0,0 +1,26 @@
+import type { ToolkitConfig } from '../config.js';
+/** Mirrors the extension's CleanupOutcome. */
+export type CleanupOutcome = 'dropped' | 'absent' | 'unclaimed' | 'refused' | 'failed';
+export interface CleanupResult {
+    testId: string;
+    outcome: CleanupOutcome;
+}
+export interface SweepReport {
+    results: CleanupResult[];
+    kept: number;
+    cutoffMs: number;
+    /** True when the site could not be reached, which is not a run failure. */
+    unreachable: boolean;
+}
+/** The endpoint refuses a larger batch, so requests are chunked to this size. */
+export declare const MAXIMUM_BATCH = 500;
+export type DropDatabases = (testIds: string[]) => Promise<CleanupResult[]>;
+export interface CleanupClient {
+    drop: DropDatabases;
+    sweep(keepTestIds: string[], minimumAgeMs: number): Promise<SweepReport>;
+}
+export declare function httpCleanup(config: ToolkitConfig, options?: {
+    fetchImpl?: typeof fetch;
+    timeoutMs?: number;
+}): CleanupClient;
+//# sourceMappingURL=cleanup-client.d.ts.map

package/dist/http/cleanup-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cleanup-client.d.ts","sourceRoot":"","sources":["../../src/http/cleanup-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,8CAA8C;AAC9C,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,CAAA;AAEtF,MAAM,WAAW,aAAa;IAC1B,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,cAAc,CAAA;CAC1B;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,aAAa,EAAE,CAAA;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,2EAA2E;IAC3E,WAAW,EAAE,OAAO,CAAA;CACvB;AAED,iFAAiF;AACjF,eAAO,MAAM,aAAa,MAAM,CAAA;AAkChC,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,aAAa,EAAE,CAAC,CAAA;AAE3E,MAAM,WAAW,aAAa;IAC1B,IAAI,EAAE,aAAa,CAAA;IACnB,KAAK,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAAA;CAC3E;AAED,wBAAgB,WAAW,CACvB,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAE,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GAC/D,aAAa,CAuEf"}

package/dist/http/cleanup-client.js

@@ -0,0 +1,91 @@
+import { SECRET_HEADER, resolveApiSecret } from './api-secret.js';
+/** The endpoint refuses a larger batch, so requests are chunked to this size. */
+export const MAXIMUM_BATCH = 500;
+const OUTCOMES = ['dropped', 'absent', 'unclaimed', 'refused', 'failed'];
+/**
+ * Accepts only these five results. Teardown forgets a database once its result is
+ * final, and those records are the only proof the database ever existed — so an
+ * answer we do not understand must never count as final.
+ */
+function parseResults(body) {
+    if (!body || typeof body !== 'object' || !Array.isArray(body.results)) {
+        return [];
+    }
+    const parsed = [];
+    for (const entry of body.results) {
+        if (!entry || typeof entry !== 'object') {
+            continue;
+        }
+        const { testId, outcome } = entry;
+        if (typeof testId !== 'string') {
+            continue;
+        }
+        parsed.push({
+            testId,
+            outcome: OUTCOMES.includes(outcome)
+                ? outcome
+                : 'failed',
+        });
+    }
+    return parsed;
+}
+export function httpCleanup(config, options = {}) {
+    const doFetch = options.fetchImpl ?? fetch;
+    const timeoutMs = options.timeoutMs ?? (Number(process.env.PW_CLEANUP_TIMEOUT_MS) || 30000);
+    async function post(operation, payload) {
+        const url = `${config.testingURL}/typo3/test-api/databases/${operation}`;
+        // No test-ID header: one would make the extension provision a database
+        // on the way in, and this request exists to remove them.
+        const response = await doFetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                [SECRET_HEADER]: resolveApiSecret(config),
+            },
+            body: JSON.stringify(payload),
+            signal: AbortSignal.timeout(timeoutMs),
+        });
+        if (!response.ok) {
+            throw new Error(`${url} answered ${response.status}`);
+        }
+        return await response.json();
+    }
+    return {
+        async drop(testIds) {
+            const results = [];
+            for (let index = 0; index < testIds.length; index += MAXIMUM_BATCH) {
+                const batch = testIds.slice(index, index + MAXIMUM_BATCH);
+                let reported = [];
+                try {
+                    reported = parseResults(await post('drop', { testIds: batch }));
+                }
+                catch (error) {
+                    console.error(`[teardown] Cleanup request failed: ${error.message}`);
+                }
+                // An id the endpoint said nothing about is not known to be gone, so
+                // it counts as failed and keeps the run registry alive.
+                const byTestId = new Map(reported.map((result) => [result.testId, result]));
+                for (const testId of batch) {
+                    results.push(byTestId.get(testId) ?? { testId, outcome: 'failed' });
+                }
+            }
+            return results;
+        },
+        async sweep(keepTestIds, minimumAgeMs) {
+            try {
+                const body = (await post('sweep', { keepTestIds, minimumAgeMs }));
+                return {
+                    results: parseResults(body),
+                    kept: typeof body.kept === 'number' ? body.kept : 0,
+                    cutoffMs: typeof body.cutoffMs === 'number' ? body.cutoffMs : minimumAgeMs,
+                    unreachable: false,
+                };
+            }
+            catch (error) {
+                console.error(`[teardown] Orphan sweep skipped: ${error.message}`);
+                return { results: [], kept: 0, cutoffMs: minimumAgeMs, unreachable: true };
+            }
+        },
+    };
+}
+//# sourceMappingURL=cleanup-client.js.map

package/dist/http/cleanup-client.js.map

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

package/dist/http/off-site-headers.d.ts

@@ -0,0 +1,13 @@
+import type { BrowserContext } from '@playwright/test';
+import type { ToolkitConfig } from '../config.js';
+/**
+ * Adds the test ID for the site under test, and takes both toolkit headers off
+ * anything else. Routing rather than extraHTTPHeaders: a context-wide header also
+ * rides on page.request, which context.route cannot reach.
+ *
+ * Register this last. Playwright runs the newest matching handler first, and
+ * `fallback` then passes the request down to the ones a consumer added earlier —
+ * `continue` would end the chain and silently disable them.
+ */
+export declare function applyToolkitHeaders(context: BrowserContext, config: ToolkitConfig, testId: string): Promise<void>;
+//# sourceMappingURL=off-site-headers.d.ts.map

package/dist/http/off-site-headers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"off-site-headers.d.ts","sourceRoot":"","sources":["../../src/http/off-site-headers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAGtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAIjD;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CACrC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAqBf"}

package/dist/http/off-site-headers.js

@@ -0,0 +1,27 @@
+import { SECRET_HEADER } from './api-secret.js';
+import { TEST_ID_HEADER, browserHeaders } from '../contract.js';
+const TOOLKIT_HEADERS = [TEST_ID_HEADER.toLowerCase(), SECRET_HEADER.toLowerCase()];
+/**
+ * Adds the test ID for the site under test, and takes both toolkit headers off
+ * anything else. Routing rather than extraHTTPHeaders: a context-wide header also
+ * rides on page.request, which context.route cannot reach.
+ *
+ * Register this last. Playwright runs the newest matching handler first, and
+ * `fallback` then passes the request down to the ones a consumer added earlier —
+ * `continue` would end the chain and silently disable them.
+ */
+export async function applyToolkitHeaders(context, config, testId) {
+    const site = new URL(config.testingURL).origin;
+    await context.route(() => true, async (route) => {
+        const headers = { ...route.request().headers() };
+        if (new URL(route.request().url()).origin === site) {
+            await route.fallback({ headers: { ...headers, ...browserHeaders(testId) } });
+            return;
+        }
+        for (const name of TOOLKIT_HEADERS) {
+            delete headers[name];
+        }
+        await route.fallback({ headers });
+    });
+}
+//# sourceMappingURL=off-site-headers.js.map

package/dist/http/off-site-headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"off-site-headers.js","sourceRoot":"","sources":["../../src/http/off-site-headers.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAG/D,MAAM,eAAe,GAAG,CAAC,cAAc,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,WAAW,EAAE,CAAC,CAAA;AAEnF;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACrC,OAAuB,EACvB,MAAqB,EACrB,MAAc;IAEd,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,MAAM,CAAA;IAE9C,MAAM,OAAO,CAAC,KAAK,CACf,GAAG,EAAE,CAAC,IAAI,EACV,KAAK,EAAE,KAAK,EAAE,EAAE;QACZ,MAAM,OAAO,GAAG,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,OAAO,EAAE,EAAE,CAAA;QAEhD,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,MAAM,KAAK,IAAI,EAAE,CAAC;YACjD,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,OAAO,EAAE,GAAG,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAA;YAE5E,OAAM;QACV,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,eAAe,EAAE,CAAC;YACjC,OAAO,OAAO,CAAC,IAAI,CAAC,CAAA;QACxB,CAAC;QAED,MAAM,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC,CAAA;IACrC,CAAC,CACJ,CAAA;AACL,CAAC"}

package/dist/http/prepare-context.d.ts

@@ -0,0 +1,4 @@
+import type { BrowserContext } from '@playwright/test';
+import type { ToolkitConfig } from '../config.js';
+export declare function prepareScenarioContext(context: BrowserContext, config: ToolkitConfig, testId: string): Promise<void>;
+//# sourceMappingURL=prepare-context.d.ts.map

package/dist/http/prepare-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-context.d.ts","sourceRoot":"","sources":["../../src/http/prepare-context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAGjD,wBAAsB,sBAAsB,CACxC,OAAO,EAAE,cAAc,EACvB,MAAM,EAAE,aAAa,EACrB,MAAM,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAGf"}

package/dist/http/prepare-context.js

@@ -0,0 +1,6 @@
+import { applyToolkitHeaders } from './off-site-headers.js';
+export async function prepareScenarioContext(context, config, testId) {
+    await config.prepareContext?.(context);
+    await applyToolkitHeaders(context, config, testId);
+}
+//# sourceMappingURL=prepare-context.js.map

package/dist/http/prepare-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare-context.js","sourceRoot":"","sources":["../../src/http/prepare-context.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAA;AAE3D,MAAM,CAAC,KAAK,UAAU,sBAAsB,CACxC,OAAuB,EACvB,MAAqB,EACrB,MAAc;IAEd,MAAM,MAAM,CAAC,cAAc,EAAE,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AACtD,CAAC"}

package/dist/http/record-edit.d.ts

@@ -0,0 +1,37 @@
+/** Relative to the backend entry point, which a project may have moved. */
+export declare const RECORD_EDIT_ROUTE = "/record/edit";
+/** Shaped like a DataHandler datamap: table → identifier → fields. */
+export type RecordDataMap = Record<string, Record<string, Record<string, unknown>>>;
+export interface FormResponse {
+    status(): number;
+    headers(): Record<string, string>;
+    text(): Promise<string>;
+}
+export interface FormPoster {
+    post(url: string, options: {
+        headers: Record<string, string>;
+        multipart: Record<string, string>;
+        maxRedirects: number;
+    }): Promise<FormResponse>;
+}
+export interface EditContext {
+    baseUrl: string;
+    backendPath: string;
+    testId: string;
+    routeToken: string;
+}
+export interface RecordToSave {
+    table: string;
+    /** A `NEW` prefix creates; anything else is a uid the form opens for editing. */
+    identifier: string;
+    /** `edit[table][target]` — the parent page when creating, the record itself when updating. */
+    target: number;
+    data: RecordDataMap;
+}
+/**
+ * The route the backend's own edit form posts to, so a TYPO3 release that changes
+ * it, its request-token rules or its field names fails the suite rather than
+ * passing quietly.
+ */
+export declare function saveRecord(poster: FormPoster, context: EditContext, record: RecordToSave): Promise<number>;
+//# sourceMappingURL=record-edit.d.ts.map

package/dist/http/record-edit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record-edit.d.ts","sourceRoot":"","sources":["../../src/http/record-edit.ts"],"names":[],"mappings":"AAGA,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,iBAAiB,CAAA;AAE/C,sEAAsE;AACtE,MAAM,MAAM,aAAa,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;AAEnF,MAAM,WAAW,YAAY;IACzB,MAAM,IAAI,MAAM,CAAA;IAChB,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACjC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;CAC1B;AAED,MAAM,WAAW,UAAU;IACvB,IAAI,CACA,GAAG,EAAE,MAAM,EACX,OAAO,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,GACtG,OAAO,CAAC,YAAY,CAAC,CAAA;CAC3B;AAED,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,UAAU,EAAE,MAAM,CAAA;IAClB,8FAA8F;IAC9F,MAAM,EAAE,MAAM,CAAA;IACd,IAAI,EAAE,aAAa,CAAA;CACtB;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC5B,MAAM,EAAE,UAAU,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EAAE,YAAY,GACrB,OAAO,CAAC,MAAM,CAAC,CAwCjB"}