@gooddata/sdk-e2e-utils 11.46.0-alpha.2 → 11.46.0-alpha.4

package/esm/goodmock.d.ts

@@ -44,14 +44,19 @@ export declare function goodmockMode(): GoodmockMode;
  * {@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?: Map<string, any>;
+        jsonBody?: unknown;
+        body?: string;
     };
 }
 /**
@@ -61,25 +66,73 @@ 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.
  *
- * This mirrors the Cypress recording flow: two snapshot calls are made —
- * one for executionResults URLs (with repeatsAsScenarios) and one for
- * everything else — then the results are merged and written out.
+ * 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 -
- * @param mappingFilePath -
- * @param workspaceIdMappings - Optional source/target workspace ID rewrite(s)
- * applied before mappings are saved. Accepts a single mapping or an array.
- * @param backendHost - Optional 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.
- * @param baseUrl - Optional app base URL (e.g. "http://kpi-dashboards-ui:9500")
- * that replaces backendHost references in the saved mappings.
+ * @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, workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[], backendHost?: string, baseUrl?: string): Promise<void>;
+export declare function snapshotAndSaveRecording(host: string, mappingFilePath: string, options?: ISnapshotAndSaveRecordingOptions): Promise<void>;
 //# sourceMappingURL=goodmock.d.ts.map

package/esm/goodmock.d.ts.map

@@ -1 +1 @@
-{"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,MAAM,WAAW,gBAAgB;IAC7B,OAAO,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAClD,QAAQ,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC;CAC/E;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,iBAAiB,EAAE,MAAM,CAAC;CAC7B;AAqBD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,EACjE,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAqFf"}
+{"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

@@ -139,47 +139,39 @@ function sanitizeWorkspaceId(mappings, sourceWorkspaceId, targetWorkspaceId) {
  * Snapshot goodmock recordings, save the combined mappings to a JSON file
  * on disk, and sanitize any credentials from the output.
  *
- * This mirrors the Cypress recording flow: two snapshot calls are made —
- * one for executionResults URLs (with repeatsAsScenarios) and one for
- * everything else — then the results are merged and written out.
+ * 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 -
- * @param mappingFilePath -
- * @param workspaceIdMappings - Optional source/target workspace ID rewrite(s)
- * applied before mappings are saved. Accepts a single mapping or an array.
- * @param backendHost - Optional 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.
- * @param baseUrl - Optional app base URL (e.g. "http://kpi-dashboards-ui:9500")
- * that replaces backendHost references in the saved mappings.
+ * @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, workspaceIdMappings, backendHost, baseUrl) {
-    // Snapshot executionResults with scenarios
-    const scenariosRes = await fetch(`http://${host}/__admin/recordings/snapshot`, {
+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,
-            filters: { urlPattern: ".*executionResults.*" },
             persist: false,
             ...snapshotParams,
         }),
     });
-    const scenariosData = (await scenariosRes.json());
-    // Snapshot everything else without scenarios
-    const plainRes = await fetch(`http://${host}/__admin/recordings/snapshot`, {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-            repeatsAsScenarios: false,
-            filters: { urlPattern: "((?!executionResults).)*" },
-            persist: false,
-            ...snapshotParams,
-        }),
-    });
-    const plainData = (await plainRes.json());
-    const mappings = [...plainData.mappings, ...scenariosData.mappings];
+    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") {
@@ -188,37 +180,104 @@ export async function snapshotAndSaveRecording(host, mappingFilePath, workspaceI
                 delete mapping.response.headers["Set-Cookie"];
             }
         }
-        const requestUrl = mapping?.request?.url;
-        if (typeof requestUrl === "string" &&
-            /^\/api\/v1\/actions\/workspaces\/[^/]+\/resolveSettings$/.test(requestUrl)) {
+        // 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 parsedBody = mapping?.response?.jsonBody;
-                if (Array.isArray(parsedBody)) {
-                    for (const setting of parsedBody) {
-                        if ((setting?.id === "agGridToken" || setting?.id === "mapboxToken") &&
-                            setting?.content &&
-                            typeof setting.content === "object") {
-                            setting.content.value = "";
+                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"] = "";
                         }
                     }
-                    mapping.response.jsonBody = parsedBody;
                 }
             }
             catch {
-                console.warn(`sanitizeCredentials – resolveSettings body is not valid JSON for url: ${requestUrl}`);
+                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), mappings);
+    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);
     // eslint-disable-next-line no-console

package/esm/index.d.ts

@@ -1,5 +1,5 @@
 export { authHeader, authedRouteFetch, injectAuthHeader } from "./auth.js";
-export { type IWorkspaceIdMapping, loadMappings, resetMappings, resetScenarios, mockLogRequests, goodmockMode, GoodmockMode, startRecording, snapshotAndSaveRecording, } from "./goodmock.js";
+export { type IGoodmockMapping, type ILeakPattern, type ISecretMapping, type ISnapshotAndSaveRecordingOptions, type IWorkspaceIdMapping, loadMappings, resetMappings, resetScenarios, mockLogRequests, goodmockMode, GoodmockMode, startRecording, snapshotAndSaveRecording, } from "./goodmock.js";
 export { type BaseTestArgs, type BaseWorkerArgs, type ICreateTestOptions, type IDescribeFunction, type IE2eTest, type IE2eTestDetails, type IFeatureHubEnvironment, type IFeatureHubFeature, type IGoodmockOptions, createTest, } from "./playwright.js";
 export { clickByBoundingBox, hoverByBoundingBox } from "./helpers/mouse-actions.js";
 export { GOODMOCK_HOST, API_TOKEN, BACKEND_HOST, getBaseUrl, getEnvWithFallback, getWorkspaceId, getDangerWorkspaceId, } from "./constants.js";

package/esm/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACH,KAAK,mBAAmB,EACxB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,wBAAwB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACH,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACvB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,gCAAgC,EACrC,KAAK,mBAAmB,EACxB,YAAY,EACZ,aAAa,EACb,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,wBAAwB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACH,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,QAAQ,EACb,KAAK,eAAe,EACpB,KAAK,sBAAsB,EAC3B,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,UAAU,GACb,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AACpF,OAAO,EACH,aAAa,EACb,SAAS,EACT,YAAY,EACZ,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,oBAAoB,GACvB,MAAM,gBAAgB,CAAC"}

package/esm/playwright.d.ts

@@ -1,5 +1,5 @@
 import { type Fixtures, type PlaywrightTestArgs, type PlaywrightTestOptions, type PlaywrightWorkerArgs, type PlaywrightWorkerOptions, type TestDetails, test } from "@playwright/test";
-import { type IWorkspaceIdMapping } from "./goodmock.js";
+import { type IGoodmockMapping, type ILeakPattern, type ISecretMapping, type IWorkspaceIdMapping } from "./goodmock.js";
 /**
  * @internal
  */
@@ -9,6 +9,12 @@ export interface IGoodmockOptions {
     getMappingPath: (specFile: string) => string;
     workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
     baseUrl?: string;
+    /** Secret values replaced by placeholders in saved recordings (see {@link ISecretMapping}). */
+    secretMappings?: ISecretMapping[];
+    /** Credential-shaped patterns that must never appear in saved recordings (see {@link ILeakPattern}). */
+    leakPatterns?: ILeakPattern[];
+    /** Consumer-supplied redaction hook for domain-specific secrets (see snapshotAndSaveRecording). */
+    sanitizeMappings?: (mappings: IGoodmockMapping[]) => IGoodmockMapping[];
 }
 /**
  * @internal

package/esm/playwright.d.ts.map

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

package/esm/playwright.js

@@ -106,7 +106,14 @@ export function createTest(options = {}) {
                     });
                     testInstance.afterAll(async () => {
                         if (goodmockMode === GoodmockMode.Record) {
-                            await snapshotAndSaveRecording(gm.host, gm.getMappingPath(specName), gm.workspaceIdMappings, gm.backendHost, gm.baseUrl);
+                            await snapshotAndSaveRecording(gm.host, gm.getMappingPath(specName), {
+                                workspaceIdMappings: gm.workspaceIdMappings,
+                                backendHost: gm.backendHost,
+                                baseUrl: gm.baseUrl,
+                                secretMappings: gm.secretMappings,
+                                leakPatterns: gm.leakPatterns,
+                                sanitizeMappings: gm.sanitizeMappings,
+                            });
                         }
                         await resetMappings(gm.host);
                     });

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

@@ -183,6 +183,22 @@ export declare interface IFeatureHubFeature {
     v?: string;
 }
 
+/**
+ * @internal
+ */
+export declare interface IGoodmockMapping {
+    request: {
+        url?: string;
+        urlPath?: string;
+        bodyPatterns?: unknown;
+    };
+    response: {
+        headers?: Record<string, string>;
+        jsonBody?: unknown;
+        body?: string;
+    };
+}
+
 /**
  * @internal
  */
@@ -192,6 +208,24 @@ export declare interface IGoodmockOptions {
     getMappingPath: (specFile: string) => string;
     workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
     baseUrl?: string;
+    /** Secret values replaced by placeholders in saved recordings (see {@link ISecretMapping}). */
+    secretMappings?: ISecretMapping[];
+    /** Credential-shaped patterns that must never appear in saved recordings (see {@link ILeakPattern}). */
+    leakPatterns?: ILeakPattern[];
+    /** Consumer-supplied redaction hook for domain-specific secrets (see snapshotAndSaveRecording). */
+    sanitizeMappings?: (mappings: IGoodmockMapping[]) => IGoodmockMapping[];
+}
+
+/**
+ * @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 declare interface ILeakPattern {
+    label: string;
+    pattern: RegExp;
 }
 
 /**
@@ -200,6 +234,52 @@ export declare interface IGoodmockOptions {
  */
 export declare function injectAuthHeader(page: Page, token: string): Promise<void>;
 
+/**
+ * @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 declare interface ISecretMapping {
+    secret: string;
+    placeholder: string;
+}
+
+/**
+ * @internal
+ */
+export declare 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
  */
@@ -243,22 +323,15 @@ export declare function resetScenarios(host: string): Promise<void>;
  * Snapshot goodmock recordings, save the combined mappings to a JSON file
  * on disk, and sanitize any credentials from the output.
  *
- * This mirrors the Cypress recording flow: two snapshot calls are made —
- * one for executionResults URLs (with repeatsAsScenarios) and one for
- * everything else — then the results are merged and written out.
+ * 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 -
- * @param mappingFilePath -
- * @param workspaceIdMappings - Optional source/target workspace ID rewrite(s)
- * applied before mappings are saved. Accepts a single mapping or an array.
- * @param backendHost - Optional 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.
- * @param baseUrl - Optional app base URL (e.g. "http://kpi-dashboards-ui:9500")
- * that replaces backendHost references in the saved mappings.
- */
-export declare function snapshotAndSaveRecording(host: string, mappingFilePath: string, workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[], backendHost?: string, baseUrl?: string): Promise<void>;
+ * @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>;
 
 /**
  * @internal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gooddata/sdk-e2e-utils",
-  "version": "11.46.0-alpha.2",
+  "version": "11.46.0-alpha.4",
   "description": "GoodData utility functions for Playwright E2E tests",
   "license": "MIT",
   "author": "GoodData",
@@ -51,8 +51,8 @@
     "oxlint": "1.51.0",
     "oxlint-tsgolint": "0.15.0",
     "typescript": "5.9.3",
-    "@gooddata/eslint-config": "11.46.0-alpha.2",
-    "@gooddata/oxlint-config": "11.46.0-alpha.2"
+    "@gooddata/eslint-config": "11.46.0-alpha.4",
+    "@gooddata/oxlint-config": "11.46.0-alpha.4"
   },
   "scripts": {
     "_phase:build": "npm run build",