@gooddata/sdk-e2e-utils 11.60.0-alpha.3 → 11.60.0

package/esm/sdk-e2e-utils.d.ts

@@ -1,14 +1,14 @@
 import { APIResponse } from '@playwright/test';
-import { Fixtures } from '@playwright/test';
+import type { Fixtures as Fixtures_2 } from '@playwright/test';
 import { Locator } from '@playwright/test';
 import { Page } from '@playwright/test';
-import { PlaywrightTestArgs } from '@playwright/test';
-import { PlaywrightTestOptions } from '@playwright/test';
-import { PlaywrightWorkerArgs } from '@playwright/test';
-import { PlaywrightWorkerOptions } from '@playwright/test';
+import type { PlaywrightTestArgs } from '@playwright/test';
+import type { PlaywrightTestOptions } from '@playwright/test';
+import type { PlaywrightWorkerArgs } from '@playwright/test';
+import type { PlaywrightWorkerOptions } from '@playwright/test';
 import { Route } from '@playwright/test';
-import { test } from '@playwright/test';
-import { TestDetails } from '@playwright/test';
+import type { test } from '@playwright/test';
+import type { TestDetails } from '@playwright/test';
 
 /**
  * @internal
@@ -45,6 +45,11 @@ export declare type BaseTestArgs = PlaywrightTestArgs & PlaywrightTestOptions;
  */
 export declare type BaseWorkerArgs = PlaywrightWorkerArgs & PlaywrightWorkerOptions;
 
+/**
+ * @internal
+ */
+export declare type Callback = () => void;
+
 /**
  * @internal
  * Click at the center of the bounding box of the given locator.
@@ -61,7 +66,42 @@ export declare function clickByBoundingBox(page: Page, locator: Locator, options
  * @internal
  * @param options -
  */
-export declare function createTest<T extends Record<string, unknown> = {}, W extends Record<string, unknown> = {}>(options?: ICreateTestOptions<T, W>): IE2eTest;
+export declare function createTest<T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<T, W>): ITest;
+
+/**
+ * @internal
+ */
+export declare type DescribeConfigure = typeof test.describe.configure;
+
+/**
+ * @internal
+ */
+export declare type DescribeFixme = typeof test.describe.fixme;
+
+/**
+ * @internal
+ */
+export declare type DescribeOnly = typeof test.describe.only;
+
+/**
+ * @internal
+ */
+export declare type DescribeParallel = typeof test.describe.parallel;
+
+/**
+ * @internal
+ */
+export declare type DescribeSerial = typeof test.describe.serial;
+
+/**
+ * @internal
+ */
+export declare type DescribeSkip = typeof test.describe.skip;
+
+/**
+ * @internal
+ */
+export declare type Fixtures<T extends {} = {}, W extends {} = {}> = Fixtures_2<T, W, BaseTestArgs, BaseWorkerArgs>;
 
 /**
  * @internal
@@ -115,50 +155,37 @@ export declare function hoverByBoundingBox(page: Page, locator: Locator, options
 /**
  * @internal
  */
-export declare interface ICreateTestOptions<T extends Record<string, unknown> = {}, W extends Record<string, unknown> = {}> {
-    goodmock?: IGoodmockOptions;
-    fixtures?: Fixtures<T, W, BaseTestArgs & T, BaseWorkerArgs & W>;
-    featureHubResponse?: IFeatureHubEnvironment[];
+export declare interface ICreateTestOptions<T extends {} = {}, W extends {} = {}> extends ICustomCreateTestOptions {
+    fixtures?: Fixtures<T, W>;
 }
 
 /**
  * @internal
  */
-export declare interface IDescribeFunction {
-    (suiteName: string, specName: string, fn: () => void): void;
-    (suiteName: string, specName: string, details: IE2eTestDetails, fn: () => void): void;
-    skip: {
-        (suiteName: string, specName: string, fn: () => void): void;
-        (suiteName: string, specName: string, details: IE2eTestDetails, fn: () => void): void;
-    };
+export declare interface ICustomCreateTestOptions {
+    featureHubResponse: IFeatureHubEnvironment[];
+    goodmock?: IGoodmockOptions;
 }
 
 /**
  * @internal
  */
-export declare type IE2eTest = typeof test & {
-    topLevelDescribe: IDescribeFunction;
-    describe: {
-        (title: string, callback: () => void): void;
-        (title: string, details: IE2eTestDetails, callback: () => void): void;
-        skip: {
-            (title: string, callback: () => void): void;
-            (title: string, details: IE2eTestDetails, callback: () => void): void;
-        };
-        only: (typeof test)["describe"]["only"];
-        configure: (typeof test)["describe"]["configure"];
-        fixme: (typeof test)["describe"]["fixme"];
-        serial: (typeof test)["describe"]["serial"];
-        parallel: (typeof test)["describe"]["parallel"];
-    };
-};
+export declare interface IDescribe extends IDescribeFunction {
+    skip: IDescribeFunction;
+    only: DescribeOnly;
+    configure: DescribeConfigure;
+    fixme: DescribeFixme;
+    serial: DescribeSerial;
+    parallel: DescribeParallel;
+}
 
 /**
  * @internal
+ * Call signatures of the overridden `test.describe` and `test.describe.skip`.
  */
-export declare interface IE2eTestDetails extends TestDetails {
-    workspaceSettings?: Record<string, unknown>;
-    additionalWindowProperties?: Record<string, unknown>;
+export declare interface IDescribeFunction {
+    (title: string, callback: Callback): void;
+    (title: string, details: ITestDetails, callback: Callback): void;
 }
 
 /**
@@ -280,6 +307,38 @@ export declare interface ISnapshotAndSaveRecordingOptions {
     sanitizeMappings?: (mappings: IGoodmockMapping[]) => IGoodmockMapping[];
 }
 
+/**
+ * @internal
+ */
+export declare type ITest = Test & {
+    topLevelDescribe: ITopLevelDescribe;
+    describe: IDescribe;
+};
+
+/**
+ * @internal
+ */
+export declare interface ITestDetails extends TestDetails {
+    workspaceSettings?: WorkspaceSettings;
+    additionalWindowProperties?: WindowProperties;
+}
+
+/**
+ * @internal
+ */
+export declare interface ITopLevelDescribe extends ITopLevelDescribeFunction {
+    skip: ITopLevelDescribeFunction;
+}
+
+/**
+ * @internal
+ * Call signatures of the overridden `test.describe` and `test.describe.skip`.
+ */
+export declare interface ITopLevelDescribeFunction {
+    (suiteName: string, specName: string, fn: Callback): void;
+    (suiteName: string, specName: string, details: ITestDetails, fn: Callback): void;
+}
+
 /**
  * @internal
  */
@@ -341,4 +400,19 @@ export declare function snapshotAndSaveRecording(host: string, mappingFilePath:
  */
 export declare function startRecording(host: string, backendHost: string): Promise<void>;
 
+/**
+ * @internal
+ */
+export declare type Test = typeof test;
+
+/**
+ * @internal
+ */
+export declare type WindowProperties = Record<string, unknown>;
+
+/**
+ * @internal
+ */
+export declare type WorkspaceSettings = Record<string, unknown>;
+
 export { }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-e2e-utils",
-  "version": "11.60.0-alpha.3",
+  "version": "11.60.0",
   "description": "GoodData utility functions for Playwright E2E tests",
   "license": "MIT",
   "author": "GoodData",
@@ -49,8 +49,8 @@
     "oxlint-plugin-eslint": "1.82.0",
     "oxlint-tsgolint": "7.0.2001",
     "typescript": "7.0.2",
-    "@gooddata/eslint-config": "11.60.0-alpha.3",
-    "@gooddata/oxlint-config": "11.60.0-alpha.3"
+    "@gooddata/eslint-config": "11.60.0",
+    "@gooddata/oxlint-config": "11.60.0"
   },
   "scripts": {
     "_phase:build": "npm run build",

package/esm/goodmock.d.ts

@@ -1,138 +0,0 @@
-/**
- * @internal
- * Load goodmock stub mappings from a JSON file on disk.
- *
- * @param host - Goodmock host:port (e.g. "backend-mock:8080")
- * @param mappingFilePath - Absolute path to the mapping JSON file
- */
-export declare function loadMappings(host: string, mappingFilePath: string): Promise<void>;
-/**
- * @internal
- * Reset goodmock scenario state (sequence counters) without clearing mappings.
- * Must be called between tests so scenario-driven stubs start from the
- * beginning for every test — mirrors the Cypress `resetRecordingsScenarios` task.
- */
-export declare function resetScenarios(host: string): Promise<void>;
-/**
- * @internal
- * Clear all goodmock stub mappings.
- */
-export declare function resetMappings(host: string): Promise<void>;
-/**
- * @internal
- * Add a goodmock stub that mocks log requests (POST /gdc/app/projects/.../log).
- * This prevents the app from failing when it tries to send logs.
- */
-export declare function mockLogRequests(host: string): Promise<void>;
-/**
- * @internal
- * Which mode goodmock is running in
- */
-export declare enum GoodmockMode {
-    Replay = "replay",
-    Record = "record",
-    Proxy = "proxy"
-}
-/**
- * @internal
- */
-export declare function goodmockMode(): GoodmockMode;
-/**
- * @internal
- * Add a catch-all proxy mapping so goodmock forwards every request to the
- * real backend and records the interactions.  Must be called after
- * {@link resetMappings} in recording mode.
- */
-export declare function startRecording(host: string, backendHost: string): Promise<void>;
-/**
- * @internal
- */
-export interface IGoodmockMapping {
-    request: {
-        url?: string;
-        urlPath?: string;
-        bodyPatterns?: unknown;
-    };
-    response: {
-        headers?: Record<string, string>;
-        jsonBody?: unknown;
-        body?: string;
-    };
-}
-/**
- * @internal
- */
-export interface IWorkspaceIdMapping {
-    sourceWorkspaceId: string;
-    targetWorkspaceId: string;
-}
-/**
- * @internal
- * Rewrite of a secret value in saved recordings. Every occurrence of `secret` (request bodies,
- * response bodies, URLs) is replaced with `placeholder`, so tests can type the placeholder at
- * replay time and still match the recorded request exactly.
- */
-export interface ISecretMapping {
-    secret: string;
-    placeholder: string;
-}
-/**
- * @internal
- * A credential shape that must never appear in a saved recording (checked against the fully
- * serialized output). Provide domain-specific shapes (e.g. a provider's API key format) via
- * {@link ISnapshotAndSaveRecordingOptions.leakPatterns} — this module has no built-in patterns of
- * its own, since it has no knowledge of what a given consumer's traffic considers a secret.
- */
-export interface ILeakPattern {
-    label: string;
-    pattern: RegExp;
-}
-/**
- * @internal
- */
-export interface ISnapshotAndSaveRecordingOptions {
-    /** Source/target workspace ID rewrite(s) applied before mappings are saved. */
-    workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
-    /**
-     * Real backend URL (e.g. "https://example.gooddata.com"). When provided together with
-     * baseUrl, all occurrences are replaced in the saved mappings so that recorded responses
-     * (e.g. geo tile URLs) resolve correctly during replay.
-     */
-    backendHost?: string;
-    /** App base URL (e.g. "http://kpi-dashboards-ui:9500") that replaces backendHost references. */
-    baseUrl?: string;
-    /**
-     * Secret rewrites. Each secret value is replaced by its placeholder everywhere in the saved
-     * mappings (request bodyPatterns included, and masked variants such as "sk-prox***abcd").
-     * Saving fails hard if any secret still remains afterwards.
-     */
-    secretMappings?: ISecretMapping[];
-    /**
-     * Credential-shaped patterns that must never appear anywhere in the saved output, regardless
-     * of which field they came from. A backstop for secrets `secretMappings` doesn't know about
-     * (e.g. a value a backend echoed back that the test never typed). Saving fails hard on a match.
-     */
-    leakPatterns?: ILeakPattern[];
-    /**
-     * Consumer-supplied hook to redact domain-specific secrets from the collected mappings (e.g.
-     * blank a `content.apiKey` field on a settings entity) before they're merged and written out.
-     * Runs once, right after the built-in credential handling (login cookie, resolveSettings map
-     * tokens) and before workspace-id rewriting.
-     */
-    sanitizeMappings?: (mappings: IGoodmockMapping[]) => IGoodmockMapping[];
-}
-/**
- * @internal
- * Snapshot goodmock recordings, save the combined mappings to a JSON file
- * on disk, and sanitize any credentials from the output.
- *
- * A single snapshot is taken with repeatsAsScenarios enabled: goodmock turns a
- * request into a scenario chain only when its responses differ across the
- * recording, so stateful sequences are preserved and everything else stays flat.
- *
- * @param host - Goodmock host:port (e.g. "backend-mock:8080")
- * @param mappingFilePath - Absolute path to write the mapping JSON file to
- * @param options - See {@link ISnapshotAndSaveRecordingOptions}.
- */
-export declare function snapshotAndSaveRecording(host: string, mappingFilePath: string, options?: ISnapshotAndSaveRecordingOptions): Promise<void>;
-//# sourceMappingURL=goodmock.d.ts.map

package/esm/goodmock.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"goodmock.d.ts","sourceRoot":"","sources":["../src/goodmock.ts"],"names":[],"mappings":"AAKA;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBvF;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhE;AAED;;;GAGG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAM/D;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjE;AAED;;;GAGG;AACH,oBAAY,YAAY;IACpB,MAAM,WAAW;IACjB,MAAM,WAAW;IACjB,KAAK,UAAU;CAClB;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAE3C;AAED;;;;;GAKG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWrF;AAWD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACpE,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrF;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;GAMG;AACH,MAAM,WAAW,YAAY;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAClE;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gGAAgG;IAChG,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;;;;OAIG;IACH,cAAc,CAAC,EAAE,cAAc,EAAE,CAAC;IAClC;;;;OAIG;IACH,YAAY,CAAC,EAAE,YAAY,EAAE,CAAC;IAC9B;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,KAAK,gBAAgB,EAAE,CAAC;CAC3E;AAqBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAkKf"}

package/esm/goodmock.js

@@ -1,284 +0,0 @@
-// (C) 2026 GoodData Corporation
-import { mkdirSync, readFileSync, writeFileSync } from "fs";
-import { dirname } from "path";
-/**
- * @internal
- * Load goodmock stub mappings from a JSON file on disk.
- *
- * @param host - Goodmock host:port (e.g. "backend-mock:8080")
- * @param mappingFilePath - Absolute path to the mapping JSON file
- */
-export async function loadMappings(host, mappingFilePath) {
-    let mappings;
-    try {
-        mappings = readFileSync(mappingFilePath, "utf-8");
-    }
-    catch {
-        console.warn(`No mapping file found: ${mappingFilePath}, skipping`);
-        return;
-    }
-    let json;
-    try {
-        json = JSON.parse(mappings);
-    }
-    catch {
-        console.error(`Failed to parse mapping file: ${mappingFilePath}`);
-        return;
-    }
-    const response = await fetch(`http://${host}/__admin/mappings/import`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify(json),
-    });
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Goodmock mappings loaded from ${mappingFilePath} (status: ${response.status})`);
-}
-/**
- * @internal
- * Reset goodmock scenario state (sequence counters) without clearing mappings.
- * Must be called between tests so scenario-driven stubs start from the
- * beginning for every test — mirrors the Cypress `resetRecordingsScenarios` task.
- */
-export async function resetScenarios(host) {
-    const response = await fetch(`http://${host}/__admin/scenarios/reset`, {
-        method: "POST",
-    });
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Goodmock scenarios reset (status: ${response.status})`);
-}
-/**
- * @internal
- * Clear all goodmock stub mappings.
- */
-export async function resetMappings(host) {
-    const response = await fetch(`http://${host}/__admin/reset`, {
-        method: "POST",
-    });
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Goodmock mappings reset (status: ${response.status})`);
-}
-/**
- * @internal
- * Add a goodmock stub that mocks log requests (POST /gdc/app/projects/.../log).
- * This prevents the app from failing when it tries to send logs.
- */
-export async function mockLogRequests(host) {
-    const response = await fetch(`http://${host}/__admin/mappings`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            request: {
-                method: "POST",
-                urlPattern: "/gdc/app/projects/.*/log",
-            },
-            response: {
-                body: "",
-                status: 200,
-            },
-        }),
-    });
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Goodmock log requests mocked (status: ${response.status})`);
-}
-/**
- * @internal
- * Which mode goodmock is running in
- */
-export var GoodmockMode;
-(function (GoodmockMode) {
-    GoodmockMode["Replay"] = "replay";
-    GoodmockMode["Record"] = "record";
-    GoodmockMode["Proxy"] = "proxy";
-})(GoodmockMode || (GoodmockMode = {}));
-/**
- * @internal
- */
-export function goodmockMode() {
-    return process.env["GOODMOCK_MODE"];
-}
-/**
- * @internal
- * Add a catch-all proxy mapping so goodmock forwards every request to the
- * real backend and records the interactions.  Must be called after
- * {@link resetMappings} in recording mode.
- */
-export async function startRecording(host, backendHost) {
-    const response = await fetch(`http://${host}/__admin/mappings`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            request: { method: "ANY", urlPattern: ".*" },
-            response: { proxyBaseUrl: backendHost },
-        }),
-    });
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Goodmock recording started, proxying to ${backendHost} (status: ${response.status})`);
-}
-const snapshotParams = {
-    captureHeaders: { "X-GDC-TEST-NAME": {} },
-    requestBodyPattern: {
-        matcher: "equalToJson",
-        ignoreArrayOrder: false,
-        ignoreExtraElements: false,
-    },
-};
-function sanitizeWorkspaceId(mappings, sourceWorkspaceId, targetWorkspaceId) {
-    if (sourceWorkspaceId === targetWorkspaceId) {
-        return mappings;
-    }
-    const dataString = JSON.stringify({ mappings });
-    const sanitizedDataString = dataString.split(sourceWorkspaceId).join(targetWorkspaceId);
-    const sanitizedData = JSON.parse(sanitizedDataString);
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Sanitized workspaceId in mappings (${sourceWorkspaceId} -> ${targetWorkspaceId})`);
-    return sanitizedData.mappings;
-}
-/**
- * @internal
- * Snapshot goodmock recordings, save the combined mappings to a JSON file
- * on disk, and sanitize any credentials from the output.
- *
- * A single snapshot is taken with repeatsAsScenarios enabled: goodmock turns a
- * request into a scenario chain only when its responses differ across the
- * recording, so stateful sequences are preserved and everything else stays flat.
- *
- * @param host - Goodmock host:port (e.g. "backend-mock:8080")
- * @param mappingFilePath - Absolute path to write the mapping JSON file to
- * @param options - See {@link ISnapshotAndSaveRecordingOptions}.
- */
-export async function snapshotAndSaveRecording(host, mappingFilePath, options = {}) {
-    const { workspaceIdMappings, backendHost, baseUrl, secretMappings, leakPatterns, sanitizeMappings } = options;
-    // Snapshot everything with scenarios enabled. goodmock only emits a scenario
-    // chain when a given request produced *different* responses across the
-    // recording; identical repeats collapse to a single mapping. This captures
-    // stateful sequences (e.g. a GET whose result changes after a POST) that the
-    // old per-URL dedup path silently dropped, while keeping idempotent traffic flat.
-    const snapshotRes = await fetch(`http://${host}/__admin/recordings/snapshot`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            repeatsAsScenarios: true,
-            persist: false,
-            ...snapshotParams,
-        }),
-    });
-    const snapshotData = (await snapshotRes.json());
-    const mappings = [...snapshotData.mappings];
-    // An empty snapshot means the recording journal was lost (e.g. a worker crash re-ran the
-    // beforeAll reset mid-spec) or the spec made no requests at all. Never overwrite a previous
-    // recording with an empty one, and fail the run so the broken recording cannot go unnoticed.
-    if (mappings.length === 0) {
-        throw new Error(`Recording snapshot for ${mappingFilePath} is empty — keeping the existing mapping ` +
-            `file. Investigate (worker crash mid-spec? goodmock proxy misconfigured?) and re-record.`);
-    }
-    // Sanitize credentials
-    for (const mapping of mappings) {
-        if (mapping?.request?.url === "/gdc/account/login") {
-            delete mapping.request.bodyPatterns;
-            if (mapping.response.headers) {
-                delete mapping.response.headers["Set-Cookie"];
-            }
-        }
-        // Sanitize secrets from resolveSettings responses. Match both org-level
-        // (/api/v1/actions/resolveSettings) and workspace-level variants, via either `url`
-        // (no query) or `urlPath` (with query params).
-        const requestPath = mapping?.request?.url ?? mapping?.request?.urlPath;
-        if (typeof requestPath === "string" && requestPath.includes("/resolveSettings")) {
-            try {
-                const body = mapping?.response?.jsonBody;
-                const settings = Array.isArray(body)
-                    ? body
-                    : Array.isArray(body?.data)
-                        ? body.data
-                        : null;
-                if (settings) {
-                    for (const setting of settings) {
-                        const content = setting?.content;
-                        if (!content || typeof content !== "object") {
-                            continue;
-                        }
-                        // Map tokens (agGrid, mapbox) are stored under content.value.
-                        if (setting?.id === "agGridToken" || setting?.id === "mapboxToken") {
-                            content["value"] = "";
-                        }
-                    }
-                }
-            }
-            catch {
-                console.warn(`sanitizeCredentials – resolveSettings body is not valid JSON for: ${requestPath}`);
-            }
-        }
-    }
-    // Consumer-supplied redaction for secrets this module has no knowledge of (e.g. an LLM
-    // provider's API key echoed back on a settings entity).
-    const sanitizedByCaller = sanitizeMappings ? sanitizeMappings(mappings) : mappings;
-    const mappingsToApply = Array.isArray(workspaceIdMappings)
-        ? workspaceIdMappings
-        : workspaceIdMappings
-            ? [workspaceIdMappings]
-            : [];
-    const sanitizedMappings = mappingsToApply.reduce((acc, { sourceWorkspaceId, targetWorkspaceId }) => sanitizeWorkspaceId(acc, sourceWorkspaceId, targetWorkspaceId), sanitizedByCaller);
-    let output = JSON.stringify({ mappings: sanitizedMappings }, null, 4) + "\n";
-    if (backendHost && baseUrl) {
-        output = output.replaceAll(backendHost, baseUrl);
-    }
-    // Replace secrets typed into the UI / sent by API helpers during recording with their
-    // replay-time placeholders. JSON-escape both sides so values containing characters that
-    // JSON.stringify escapes (quotes, backslashes) are still found in the serialized output.
-    // Provider error messages echo keys in a masked form ("sk-prox***********abcd"), so that
-    // shape is rewritten too — it still leaks the ends of a real key.
-    const escapeRegex = (value) => value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-    // Below this, prefix/suffix would overlap or leave nothing to mask — there's no safe
-    // "partial reveal" shape to detect, so such secrets rely on the exact-match replace above.
-    const MIN_MASKABLE_SECRET_LENGTH = 6;
-    // Masking keeps a variable-length prefix/suffix of the key around the asterisks; scale how
-    // much we match by the secret's own length instead of assuming a fixed provider convention
-    // (e.g. OpenAI's "sk-prox***********abcd") so shorter secrets and other providers' masking
-    // shapes are still caught.
-    const buildMaskedFormPattern = (escapedSecret) => {
-        if (escapedSecret.length < MIN_MASKABLE_SECRET_LENGTH) {
-            return undefined;
-        }
-        const prefixLength = Math.min(7, Math.floor(escapedSecret.length / 3));
-        const suffixLength = Math.min(4, Math.floor(escapedSecret.length / 4));
-        return new RegExp(`${escapeRegex(escapedSecret.slice(0, prefixLength))}[^"*\\\\]*[*]+[^"*\\\\]*${escapeRegex(escapedSecret.slice(-suffixLength))}`, "g");
-    };
-    const effectiveSecretMappings = (secretMappings ?? []).filter(({ secret, placeholder }) => secret && secret !== placeholder);
-    for (const { secret, placeholder } of effectiveSecretMappings) {
-        const escapedSecret = JSON.stringify(secret).slice(1, -1);
-        const escapedPlaceholder = JSON.stringify(placeholder).slice(1, -1);
-        output = output.replaceAll(escapedSecret, escapedPlaceholder);
-        const maskedForm = buildMaskedFormPattern(escapedSecret);
-        if (maskedForm) {
-            output = output.replace(maskedForm, escapedPlaceholder);
-        }
-    }
-    // Leak guard: never write a recording that still contains a real secret (full or masked).
-    for (const { secret } of effectiveSecretMappings) {
-        const escapedSecret = JSON.stringify(secret).slice(1, -1);
-        const maskedForm = buildMaskedFormPattern(escapedSecret);
-        if (output.includes(escapedSecret) || output.includes(secret) || maskedForm?.test(output)) {
-            throw new Error(`Recording for ${mappingFilePath} still contains a secret after sanitization ` +
-                `(e.g. in an encoded form). Refusing to save the mapping file.`);
-        }
-    }
-    // Pattern guard: catch credential-shaped values from ANY source (not just the ones the
-    // tests typed), e.g. a real key stored in a backend org setting under an unexpected field.
-    // Patterns are consumer-supplied — this module has no built-in notion of what a secret
-    // looks like for a given domain (see ISnapshotAndSaveRecordingOptions.leakPatterns).
-    for (const { label, pattern } of leakPatterns ?? []) {
-        // Reset lastIndex in case pattern carries the g/y flag — exec() on a stateful regex
-        // would otherwise resume from wherever a previous call (e.g. a prior recording) left off.
-        pattern.lastIndex = 0;
-        const match = pattern.exec(output);
-        if (match) {
-            throw new Error(`Recording for ${mappingFilePath} contains a value shaped like a ${label} ` +
-                `("${match[0].slice(0, 8)}…"). Refusing to save the mapping file — extend ` +
-                `sanitizeMappings / secretMappings so it gets sanitized.`);
-        }
-    }
-    mkdirSync(dirname(mappingFilePath), { recursive: true });
-    writeFileSync(mappingFilePath, output);
-    // oxlint-disable-next-line eslint-js/no-console
-    console.log(`Recording saved to ${mappingFilePath} (${sanitizedMappings.length} mappings)`);
-}