@gooddata/sdk-e2e-utils 11.61.0-alpha.0 → 11.61.0-alpha.2

package/esm/create-test/feature-hub/mock.d.ts

@@ -1,5 +1,5 @@
-import type { Test } from "../playwright/playwright-types.js";
+import type { PlaywrightTestInstance } from "../playwright/playwright-types.js";
 import type { IFeatureHubEnvironment } from "./types.js";
 /** FeatureHub mock — each test gets a fresh page, so route dies with it. */
-export declare function registerFeatureHubMock(testInstance: Test, featureHubResponse: IFeatureHubEnvironment[]): void;
+export declare function registerFeatureHubMock(testInstance: PlaywrightTestInstance, featureHubResponse: IFeatureHubEnvironment[]): void;
 //# sourceMappingURL=mock.d.ts.map

package/esm/create-test/feature-hub/mock.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/create-test/feature-hub/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,mCAAmC,CAAC;AAE9D,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,IAAI,EAClB,kBAAkB,EAAE,sBAAsB,EAAE,GAC7C,IAAI,CAYN"}
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../../../src/create-test/feature-hub/mock.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAEhF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAEzD,4EAA4E;AAC5E,wBAAgB,sBAAsB,CAClC,YAAY,EAAE,sBAAsB,EACpC,kBAAkB,EAAE,sBAAsB,EAAE,GAC7C,IAAI,CAYN"}

package/esm/create-test/goodmock/snapshot/sanitize-organization.d.ts

@@ -0,0 +1,12 @@
+import { type IGoodmockMapping } from "../types.js";
+export declare const DEFAULT_TEMPLATE_ORGANIZATION = "automation";
+/**
+ * Replace every ephemeral organization name (`ephemeral-{templateOrganization}-{hex}`) with the
+ * bare template organization name, so re-recording against a freshly created org does not churn
+ * the organization id, name, or `/entities/admin/organizations/...` paths in the saved mappings.
+ *
+ * The hex suffix is exactly 8 lowercase hex characters; the lookahead makes sure a longer hex run
+ * is not partially consumed.
+ */
+export declare function sanitizeOrganization(mappings: IGoodmockMapping[], templateOrganization?: string): IGoodmockMapping[];
+//# sourceMappingURL=sanitize-organization.d.ts.map

package/esm/create-test/goodmock/snapshot/sanitize-organization.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize-organization.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/sanitize-organization.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,eAAO,MAAM,6BAA6B,eAAe,CAAC;AAM1D;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAChC,QAAQ,EAAE,gBAAgB,EAAE,EAC5B,oBAAoB,GAAE,MAAsC,GAC7D,gBAAgB,EAAE,CAmBpB"}

package/esm/create-test/goodmock/snapshot/sanitize-organization.js

@@ -0,0 +1,28 @@
+// (C) 2026 GoodData Corporation
+export const DEFAULT_TEMPLATE_ORGANIZATION = "automation";
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+/**
+ * Replace every ephemeral organization name (`ephemeral-{templateOrganization}-{hex}`) with the
+ * bare template organization name, so re-recording against a freshly created org does not churn
+ * the organization id, name, or `/entities/admin/organizations/...` paths in the saved mappings.
+ *
+ * The hex suffix is exactly 8 lowercase hex characters; the lookahead makes sure a longer hex run
+ * is not partially consumed.
+ */
+export function sanitizeOrganization(mappings, templateOrganization = DEFAULT_TEMPLATE_ORGANIZATION) {
+    const template = escapeRegExp(templateOrganization);
+    const ephemeralOrganizationPattern = new RegExp(`ephemeral-${template}-[0-9a-f]{8}(?![0-9a-f])`, "g");
+    const dataString = JSON.stringify({ mappings });
+    const matches = dataString.match(ephemeralOrganizationPattern);
+    if (!matches) {
+        return mappings;
+    }
+    const sanitizedDataString = dataString.replace(ephemeralOrganizationPattern, templateOrganization);
+    const sanitizedData = JSON.parse(sanitizedDataString);
+    const distinctOrganizations = [...new Set(matches)].join(", ");
+    // oxlint-disable-next-line eslint-js/no-console
+    console.log(`Sanitized organization in mappings (${distinctOrganizations} -> ${templateOrganization})`);
+    return sanitizedData.mappings;
+}

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.d.ts

@@ -5,6 +5,12 @@ import { type IGoodmockMapping, type ILeakPattern, type ISecretMapping, type IWo
 export interface ISnapshotAndSaveRecordingOptions {
     /** Source/target workspace ID rewrite(s) applied before mappings are saved. */
     workspaceIdMappings?: IWorkspaceIdMapping | IWorkspaceIdMapping[];
+    /**
+     * Template organization name. Every ephemeral organization name in the saved mappings
+     * (`ephemeral-{templateOrganization}-{hex}`) is replaced with this bare name so re-recording
+     * against a fresh ephemeral org does not churn the recordings. Defaults to "automation".
+     */
+    templateOrganization?: string;
     /**
      * 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

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"snapshot-and-save-recording.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/snapshot-and-save-recording.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAC3B,MAAM,aAAa,CAAC;AASrB;;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;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CAoDf"}
+{"version":3,"file":"snapshot-and-save-recording.d.ts","sourceRoot":"","sources":["../../../../src/create-test/goodmock/snapshot/snapshot-and-save-recording.ts"],"names":[],"mappings":"AAKA,OAAO,EACH,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EAC3B,MAAM,aAAa,CAAC;AAUrB;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC7C,+EAA+E;IAC/E,mBAAmB,CAAC,EAAE,mBAAmB,GAAG,mBAAmB,EAAE,CAAC;IAClE;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;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;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,wBAAwB,CAC1C,IAAI,EAAE,MAAM,EACZ,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,gCAAqC,GAC/C,OAAO,CAAC,IAAI,CAAC,CA6Df"}

package/esm/create-test/goodmock/snapshot/snapshot-and-save-recording.js

@@ -5,6 +5,7 @@ import { assertNoLeakPatterns } from "./assert-no-leak-patterns.js";
 import { assertNoSecretLeaks } from "./assert-no-secret-leaks.js";
 import { replaceSecrets } from "./replace-secrets.js";
 import { sanitizeCredentials } from "./sanitize-credentials.js";
+import { DEFAULT_TEMPLATE_ORGANIZATION, sanitizeOrganization } from "./sanitize-organization.js";
 import { sanitizeWorkspaceIds } from "./sanitize-workspace-ids.js";
 import { snapshotParams } from "./snapshot-param.js";
 /**
@@ -21,7 +22,7 @@ import { snapshotParams } from "./snapshot-param.js";
  * @param options - See {@link ISnapshotAndSaveRecordingOptions}.
  */
 export async function snapshotAndSaveRecording(host, mappingFilePath, options = {}) {
-    const { workspaceIdMappings, backendHost, baseUrl, secretMappings, leakPatterns, sanitizeMappings } = options;
+    const { workspaceIdMappings, templateOrganization = DEFAULT_TEMPLATE_ORGANIZATION, 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
@@ -49,7 +50,8 @@ export async function snapshotAndSaveRecording(host, mappingFilePath, options =
     // 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 sanitizedMappings = sanitizeWorkspaceIds(sanitizedByCaller, workspaceIdMappings);
+    const sanitizedWorkspaceIds = sanitizeWorkspaceIds(sanitizedByCaller, workspaceIdMappings);
+    const sanitizedMappings = sanitizeOrganization(sanitizedWorkspaceIds, templateOrganization);
     let output = JSON.stringify({ mappings: sanitizedMappings }, null, 4) + "\n";
     if (backendHost && baseUrl) {
         output = output.replaceAll(backendHost, baseUrl);

package/esm/create-test/playwright/factory.d.ts

@@ -0,0 +1,8 @@
+import type { PlaywrightBaseTestArgs, PlaywrightBaseWorkerArgs } from "./playwright-types.js";
+import type { ICreateTestOptions, Test, TestConditionsValueConstraint } from "./types.js";
+/**
+ * @internal
+ * @param options -
+ */
+export declare function createTest<TestConditionsValue extends TestConditionsValueConstraint = never, T extends {} = {}, W extends {} = {}>(options: ICreateTestOptions<TestConditionsValue, T, W>): Test<TestConditionsValue, PlaywrightBaseTestArgs & T, PlaywrightBaseWorkerArgs & W>;
+//# sourceMappingURL=factory.d.ts.map

package/esm/create-test/playwright/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/factory.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACR,sBAAsB,EACtB,wBAAwB,EAE3B,MAAM,uBAAuB,CAAC;AAQ/B,OAAO,KAAK,EAER,kBAAkB,EAElB,IAAI,EACJ,6BAA6B,EAGhC,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,wBAAgB,UAAU,CACtB,mBAAmB,SAAS,6BAA6B,GAAG,KAAK,EACjE,CAAC,SAAS,EAAE,GAAG,EAAE,EACjB,CAAC,SAAS,EAAE,GAAG,EAAE,EAEjB,OAAO,EAAE,kBAAkB,CAAC,mBAAmB,EAAE,CAAC,EAAE,CAAC,CAAC,GACvD,IAAI,CAAC,mBAAmB,EAAE,sBAAsB,GAAG,CAAC,EAAE,wBAAwB,GAAG,CAAC,CAAC,CAsMrF"}

package/esm/create-test/playwright/factory.js

@@ -0,0 +1,143 @@
+// (C) 2026 GoodData Corporation
+// oxlint-disable typescript-eslint/no-empty-object-type
+import { basename } from "path";
+import { test } from "@playwright/test";
+import { registerFeatureHubMock } from "../feature-hub/mock.js";
+import { registerGoodmockHooks } from "../goodmock/playwright.js";
+import { getCallerLocation, getPlaywrightInternals, } from "./playwright-internals.js";
+import { assertRequiredConditions, assertValidConditions, combineConditions, shouldRunTest, } from "./test-conditions.js";
+import { toPlaywrightDetails } from "./to-playwright-details.js";
+import { withDescribeDetails, withTestDetails } from "./with-describe-details.js";
+/**
+ * @internal
+ * @param options -
+ */
+export function createTest(options) {
+    // Tracks whether we're inside the outermost describe of a spec file during synchronous registration.
+    let insideRootDescribe = false;
+    // Stacks track workspace settings / additionalWindowProperties hierarchy during
+    // synchronous describe registration. Each level merges on top of the parent's.
+    // The beforeEach at each level captures the fully-merged snapshot, so the
+    // innermost beforeEach (which runs last) wins.
+    const settingsStack = [];
+    const awpStack = [];
+    // Combined test conditions and titles of the enclosing describes, during synchronous registration.
+    // Describes only feed these; each test decides for itself whether it runs (a describe whose own
+    // conditions are false may still contain tests whose combined conditions are true).
+    const { testConditions } = options;
+    const conditionsStack = [];
+    const titleStack = [];
+    const withDescribeScope = (title, details, body) => {
+        conditionsStack.push(combineConditions(testConditions, conditionsStack[conditionsStack.length - 1], details.conditions));
+        titleStack.push(title);
+        try {
+            body();
+        }
+        finally {
+            titleStack.pop();
+            conditionsStack.pop();
+        }
+    };
+    // Same type `test.extend<T, W>()` returns. Without fixtures, T and W (inferred from `options.fixtures`)
+    // add nothing, so the base `test` already is that type.
+    const testInstance = options.fixtures
+        ? test.extend(options.fixtures)
+        : test;
+    const internals = getPlaywrightInternals(testInstance);
+    // specName -> spec file it was derived from. Playwright loads each file once per process, so the
+    // same file again means a second outermost describe in it, and another file means a duplicate specName.
+    const specNameFiles = new Map();
+    const makeDescribe = (type, name) => {
+        const describeFunction = (title, details, callback) => {
+            const location = getCallerLocation(describeFunction);
+            assertValidConditions(details.conditions, `${name}("${title}")`);
+            const pwDetails = toPlaywrightDetails(details);
+            if (insideRootDescribe) {
+                internals.describe(type, location, title, pwDetails, () => withDescribeScope(title, details, () => withDescribeDetails(testInstance, settingsStack, awpStack, details, callback)));
+                return;
+            }
+            // Outermost describe of the spec file: it also sets up the spec.
+            // "some-file-name.spec.ts" -> "some-file-name"
+            const specName = basename(location.file).replace(/\.(spec|test)\.[cm]?[jt]sx?$/, "");
+            const existingFile = specNameFiles.get(specName);
+            if (existingFile === location.file) {
+                throw new Error(`${name}("${title}"): only one outermost test.describe() is allowed per file (${location.file}).`);
+            }
+            if (existingFile !== undefined) {
+                throw new Error(`${name}("${title}"): duplicate specName "${specName}" in ${location.file} and ${existingFile}. Spec file names must be unique.`);
+            }
+            specNameFiles.set(specName, location.file);
+            internals.describe(type, location, title, pwDetails, () => {
+                registerFeatureHubMock(testInstance, options.featureHubResponse);
+                if (options.goodmock) {
+                    registerGoodmockHooks(testInstance, options.goodmock, specName);
+                }
+                // Workspace settings + additional window properties — merge with parent
+                // stack and inject beforeEach. Wraps the callback so nested describes inherit.
+                insideRootDescribe = true;
+                try {
+                    withDescribeScope(title, details, () => withDescribeDetails(testInstance, settingsStack, awpStack, details, callback));
+                }
+                finally {
+                    // Reset even if the body throws, so the next spec file starts outside again.
+                    insideRootDescribe = false;
+                }
+            });
+        };
+        return describeFunction;
+    };
+    const makeTest = (name, register) => {
+        const testFunction = (...args) => {
+            const location = getCallerLocation(testFunction);
+            const [title, detailsOrBody, bodyArg] = args;
+            // Only the `(title, ...)` forms register a test; the title-less forms
+            // (`test.skip()`, `test.skip(condition)`, ...) are used inside tests and describes.
+            if (typeof title !== "string") {
+                register(location, ...args);
+                return;
+            }
+            if (!insideRootDescribe) {
+                throw new Error(`${name}("${title}") must be nested inside a test.describe() block.`);
+            }
+            const details = typeof detailsOrBody === "function"
+                ? undefined
+                : detailsOrBody;
+            const body = typeof detailsOrBody === "function" ? detailsOrBody : bodyArg;
+            assertValidConditions(details?.conditions, `${name}("${title}")`);
+            const conditions = combineConditions(testConditions, conditionsStack[conditionsStack.length - 1], details?.conditions);
+            assertRequiredConditions(testConditions, conditions, `${name}("${title}")`, location.file);
+            if (!shouldRunTest(testConditions, conditions, location.file, [...titleStack, title])) {
+                // Conditions not met: register as skipped, whatever the variant (`only`, `fail`, ...).
+                internals.modifier("skip", location, title, details ? toPlaywrightDetails(details) : {}, body);
+                return;
+            }
+            if (!details) {
+                register(location, title, body);
+                return;
+            }
+            withTestDetails(testInstance, settingsStack, awpStack, location, title, details);
+            register(location, title, toPlaywrightDetails(details), body);
+        };
+        return testFunction;
+    };
+    return Object.assign(makeTest("test", (location, ...args) => internals.createTest("default", location, ...args)), testInstance, {
+        only: makeTest("test.only", (location, ...args) => internals.createTest("only", location, ...args)),
+        skip: makeTest("test.skip", (location, ...args) => internals.modifier("skip", location, ...args)),
+        fixme: makeTest("test.fixme", (location, ...args) => internals.modifier("fixme", location, ...args)),
+        fail: Object.assign(makeTest("test.fail", (location, ...args) => internals.modifier("fail", location, ...args)), testInstance.fail, {
+            only: makeTest("test.fail.only", (location, ...args) => internals.createTest("fail.only", location, ...args)),
+        }),
+        /** Build the overridden `test.describe` (with its variants) for a single `createTest` instance. */
+        describe: Object.assign(makeDescribe("default", "test.describe"), testInstance.describe, {
+            only: makeDescribe("only", "test.describe.only"),
+            fixme: makeDescribe("fixme", "test.describe.fixme"),
+            skip: makeDescribe("skip", "test.describe.skip"),
+            serial: Object.assign(makeDescribe("serial", "test.describe.serial"), {
+                only: makeDescribe("serial.only", "test.describe.serial.only"),
+            }),
+            parallel: Object.assign(makeDescribe("parallel", "test.describe.parallel"), {
+                only: makeDescribe("parallel.only", "test.describe.parallel.only"),
+            }),
+        }),
+    });
+}

package/esm/create-test/playwright/fixtures.d.ts

@@ -1,7 +1,7 @@
 import type { Fixtures as PlaywrightFixtures } from "@playwright/test";
-import { type BaseTestArgs, type BaseWorkerArgs } from "./playwright-types.js";
+import { type PlaywrightBaseTestArgs, type PlaywrightBaseWorkerArgs } from "./playwright-types.js";
 /**
  * @internal
  */
-export type Fixtures<T extends {} = {}, W extends {} = {}> = PlaywrightFixtures<T, W, BaseTestArgs, BaseWorkerArgs>;
+export type Fixtures<T extends {} = {}, W extends {} = {}> = PlaywrightFixtures<T, W, PlaywrightBaseTestArgs, PlaywrightBaseWorkerArgs>;
 //# sourceMappingURL=fixtures.d.ts.map

package/esm/create-test/playwright/fixtures.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/fixtures.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,KAAK,YAAY,EAAE,KAAK,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAE/E;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,kBAAkB,CAC3E,CAAC,EACD,CAAC,EACD,YAAY,EACZ,cAAc,CACjB,CAAC"}
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/fixtures.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,IAAI,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEvE,OAAO,EAAE,KAAK,sBAAsB,EAAE,KAAK,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEnG;;GAEG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,SAAS,EAAE,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE,IAAI,kBAAkB,CAC3E,CAAC,EACD,CAAC,EACD,sBAAsB,EACtB,wBAAwB,CAC3B,CAAC"}

package/esm/create-test/playwright/playwright-internals.d.ts

@@ -0,0 +1,38 @@
+import type { PlaywrightTestInstance } from "./playwright-types.js";
+/**
+ * Source location Playwright records for tests, describes and modifiers.
+ */
+export interface IPlaywrightLocation {
+    file: string;
+    line: number;
+    column: number;
+}
+export type PlaywrightCreateTestType = "default" | "only" | "fail.only";
+export type PlaywrightModifierType = "skip" | "fixme" | "fail";
+export type PlaywrightDescribeType = "default" | "only" | "skip" | "fixme" | "serial" | "serial.only" | "parallel" | "parallel.only";
+export interface IPlaywrightInternals {
+    /** Same as `test(...)`, `test.only(...)`, `test.fail.only(...)`. */
+    createTest(type: PlaywrightCreateTestType, location: IPlaywrightLocation, ...args: unknown[]): void;
+    /** Same as `test.skip(...)`, `test.fixme(...)`, `test.fail(...)`, in both their title and title-less forms. */
+    modifier(type: PlaywrightModifierType, location: IPlaywrightLocation, ...args: unknown[]): void;
+    /** Same as `test.describe(...)` and its variants. */
+    describe(type: PlaywrightDescribeType, location: IPlaywrightLocation, ...args: unknown[]): void;
+}
+/**
+ * Get the private `TestTypeImpl` behind a Playwright `test` function.
+ */
+export declare function getPlaywrightInternals(testInstance: PlaywrightTestInstance): IPlaywrightInternals;
+/**
+ * Location of whoever called `wrapper` (the spec file, or a consumer helper): the same frame
+ * Playwright's public API would have recorded.
+ *
+ * Frames are cut by function identity (`Error.captureStackTrace` omits `wrapper` and everything above it),
+ * not by file path, so this keeps working when consumers bundle this package into their own chunks.
+ *
+ * Playwright installs source-map-support while loading test files, so the stack already shows
+ * the original TypeScript file and line.
+ *
+ * @param wrapper - our public function the spec called (`test`, `test.describe`, ...); must be on the stack
+ */
+export declare function getCallerLocation(wrapper: (...args: never[]) => unknown): IPlaywrightLocation;
+//# sourceMappingURL=playwright-internals.d.ts.map

package/esm/create-test/playwright/playwright-internals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright-internals.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-internals.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAUpE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,MAAM,GAAG,WAAW,CAAC;AACxE,MAAM,MAAM,sBAAsB,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AAC/D,MAAM,MAAM,sBAAsB,GAC5B,SAAS,GACT,MAAM,GACN,MAAM,GACN,OAAO,GACP,QAAQ,GACR,aAAa,GACb,UAAU,GACV,eAAe,CAAC;AAEtB,MAAM,WAAW,oBAAoB;IACjC,oEAAoE;IACpE,UAAU,CAAC,IAAI,EAAE,wBAAwB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACpG,+GAA+G;IAC/G,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChG,qDAAqD;IACrD,QAAQ,CAAC,IAAI,EAAE,sBAAsB,EAAE,QAAQ,EAAE,mBAAmB,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CACnG;AAoBD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,YAAY,EAAE,sBAAsB,GAAG,oBAAoB,CAkBjG;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,mBAAmB,CAmB7F"}

package/esm/create-test/playwright/playwright-internals.js

@@ -0,0 +1,60 @@
+// (C) 2026 GoodData Corporation
+import { fileURLToPath } from "url";
+function isTestTypeImpl(value) {
+    if (typeof value !== "object" || value === null) {
+        return false;
+    }
+    const impl = value;
+    return (typeof impl._createTest === "function" &&
+        typeof impl._modifier === "function" &&
+        typeof impl._describe === "function");
+}
+/**
+ * Get the private `TestTypeImpl` behind a Playwright `test` function.
+ */
+export function getPlaywrightInternals(testInstance) {
+    // Playwright stores it under a module-private `Symbol("testType")`, so look it up by description.
+    const symbol = Object.getOwnPropertySymbols(testInstance).find((s) => s.description === "testType");
+    const impl = symbol ? testInstance[symbol] : undefined;
+    if (!isTestTypeImpl(impl)) {
+        throw new Error("@gooddata/sdk-e2e-utils: Playwright internals (TestTypeImpl._createTest/_modifier/_describe) " +
+            "were not found. They changed in this @playwright/test version; update " +
+            "src/create-test/playwright/playwright-internals.ts.");
+    }
+    return {
+        createTest: (type, location, ...args) => impl._createTest(type, location, ...args),
+        modifier: (type, location, ...args) => impl._modifier(type, location, ...args),
+        describe: (type, location, ...args) => impl._describe(type, location, ...args),
+    };
+}
+// Matches the location at the end of a stack line: "at fn (/path/file.ts:12:3)", "at /path/file.ts:12:3",
+// "at fn (file:///path/file.ts:12:3)".
+const STACK_FRAME_LOCATION = /\(?((?:file:\/\/)?[^\s()]+):(\d+):(\d+)\)?$/;
+/**
+ * Location of whoever called `wrapper` (the spec file, or a consumer helper): the same frame
+ * Playwright's public API would have recorded.
+ *
+ * Frames are cut by function identity (`Error.captureStackTrace` omits `wrapper` and everything above it),
+ * not by file path, so this keeps working when consumers bundle this package into their own chunks.
+ *
+ * Playwright installs source-map-support while loading test files, so the stack already shows
+ * the original TypeScript file and line.
+ *
+ * @param wrapper - our public function the spec called (`test`, `test.describe`, ...); must be on the stack
+ */
+export function getCallerLocation(wrapper) {
+    const target = {};
+    Error.captureStackTrace(target, wrapper);
+    for (const stackLine of (target.stack ?? "").split("\n").slice(1)) {
+        const match = STACK_FRAME_LOCATION.exec(stackLine.trim());
+        if (!match) {
+            continue;
+        }
+        const file = match[1].startsWith("file://") ? fileURLToPath(match[1]) : match[1];
+        if (file.startsWith("node:")) {
+            continue;
+        }
+        return { file, line: Number(match[2]), column: Number(match[3]) };
+    }
+    throw new Error("@gooddata/sdk-e2e-utils: could not determine the caller location from the stack.");
+}

package/esm/create-test/playwright/playwright-types.d.ts

@@ -1,42 +1,34 @@
-import type { PlaywrightTestArgs, PlaywrightTestOptions, PlaywrightWorkerArgs, PlaywrightWorkerOptions, test } from "@playwright/test";
+import type { PlaywrightTestArgs, PlaywrightTestOptions, TestType as PlaywrightTestType, PlaywrightWorkerArgs, PlaywrightWorkerOptions, TestInfo } from "@playwright/test";
 /**
  * @internal
  */
-export type BaseTestArgs = PlaywrightTestArgs & PlaywrightTestOptions;
+export type PlaywrightBaseTestArgs = PlaywrightTestArgs & PlaywrightTestOptions;
 /**
  * @internal
  */
-export type BaseWorkerArgs = PlaywrightWorkerArgs & PlaywrightWorkerOptions;
+export type PlaywrightBaseWorkerArgs = PlaywrightWorkerArgs & PlaywrightWorkerOptions;
 /**
  * @internal
  */
-export type Test = typeof test;
+export type { PlaywrightTestType };
 /**
  * @internal
  */
-export type Describe = typeof test.describe;
+export type PlaywrightTestInstance = PlaywrightTestType<PlaywrightTestArgs & PlaywrightTestOptions, PlaywrightWorkerArgs & PlaywrightWorkerOptions>;
 /**
  * @internal
  */
-export type DescribeOnly = typeof test.describe.only;
+export type PlaywrightDescribeConfigure = PlaywrightTestInstance["describe"]["configure"];
 /**
  * @internal
+ * Body of a test: `(fixtures, testInfo) => ...`. Mirrors Playwright's internal `TestBody<TestArgs>`,
+ * which `@playwright/test` doesn't export.
  */
-export type DescribeConfigure = typeof test.describe.configure;
+export type PlaywrightTestBody<TestArgs> = (args: TestArgs, testInfo: TestInfo) => Promise<unknown> | unknown;
 /**
  * @internal
+ * Condition callback of `test.skip(callback, description?)` and friends. Mirrors Playwright's internal
+ * `ConditionBody<TestArgs>`, which `@playwright/test` doesn't export.
  */
-export type DescribeFixme = typeof test.describe.fixme;
-/**
- * @internal
- */
-export type DescribeSerial = typeof test.describe.serial;
-/**
- * @internal
- */
-export type DescribeParallel = typeof test.describe.parallel;
-/**
- * @internal
- */
-export type DescribeSkip = typeof test.describe.skip;
+export type PlaywrightConditionBody<TestArgs> = (args: TestArgs) => boolean;
 //# sourceMappingURL=playwright-types.d.ts.map

package/esm/create-test/playwright/playwright-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-types.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,IAAI,EACP,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAE5E;;GAEG;AACH,MAAM,MAAM,IAAI,GAAG,OAAO,IAAI,CAAC;AAE/B;;GAEG;AACH,MAAM,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;AAE/D;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;AAEvD;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;AAEzD;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC"}
+{"version":3,"file":"playwright-types.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/playwright-types.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACR,kBAAkB,EAClB,qBAAqB,EACrB,QAAQ,IAAI,kBAAkB,EAC9B,oBAAoB,EACpB,uBAAuB,EACvB,QAAQ,EACX,MAAM,kBAAkB,CAAC;AAE1B;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,qBAAqB,CAAC;AAEhF;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,GAAG,uBAAuB,CAAC;AAEtF;;GAEG;AACH,YAAY,EAAE,kBAAkB,EAAE,CAAC;AAEnC;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,CACnD,kBAAkB,GAAG,qBAAqB,EAC1C,oBAAoB,GAAG,uBAAuB,CACjD,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,2BAA2B,GAAG,sBAAsB,CAAC,UAAU,CAAC,CAAC,WAAW,CAAC,CAAC;AAE1F;;;;GAIG;AACH,MAAM,MAAM,kBAAkB,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC;AAE9G;;;;GAIG;AACH,MAAM,MAAM,uBAAuB,CAAC,QAAQ,IAAI,CAAC,IAAI,EAAE,QAAQ,KAAK,OAAO,CAAC"}

package/esm/create-test/playwright/test-conditions.d.ts

@@ -0,0 +1,25 @@
+import type { ITestConditions, TestConditionsValueConstraint } from "./types.js";
+/** Combine a describe's or test's own conditions with the inherited ones (`child` replaces `parent` by default). */
+export declare function combineConditions<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, parent: TestConditionsValue | undefined, child: TestConditionsValue | undefined): TestConditionsValue | undefined;
+/**
+ * Throw if `conditions` is set (not `undefined`) but empty or of a type that isn't allowed. Empty values
+ * shouldn't be set at all. `0` is a valid number; objects other than plain objects, arrays, `Map` and
+ * `Set` (class instances, `Date`, ...) aren't checked for emptiness.
+ *
+ * @param conditions - the value from `details.conditions`
+ * @param where - call description used in the error message, e.g. `test.describe("title")`
+ */
+export declare function assertValidConditions(conditions: unknown, where: string): void;
+/**
+ * Throw if `testConditions.required` is set and a test ends up without conditions, neither its own
+ * nor inherited from an enclosing describe.
+ *
+ * @param where - call description used in the error message, e.g. `test("title")`
+ */
+export declare function assertRequiredConditions<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, conditions: TestConditionsValue | undefined, where: string, file: string): void;
+/**
+ * Whether a test runs. Without conditions anywhere in its chain (or without `testConditions`
+ * configured), the predicate isn't called and the test runs.
+ */
+export declare function shouldRunTest<TestConditionsValue extends TestConditionsValueConstraint>(testConditions: ITestConditions<TestConditionsValue> | undefined, conditions: TestConditionsValue | undefined, file: string, titlePath: string[]): boolean;
+//# sourceMappingURL=test-conditions.d.ts.map

package/esm/create-test/playwright/test-conditions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-conditions.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/test-conditions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEjF,oHAAoH;AACpH,wBAAgB,iBAAiB,CAAC,mBAAmB,SAAS,6BAA6B,EACvF,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,MAAM,EAAE,mBAAmB,GAAG,SAAS,EACvC,KAAK,EAAE,mBAAmB,GAAG,SAAS,GACvC,mBAAmB,GAAG,SAAS,CAKjC;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAS9E;AAgCD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,mBAAmB,SAAS,6BAA6B,EAC9F,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,GACb,IAAI,CAON;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,mBAAmB,SAAS,6BAA6B,EACnF,cAAc,EAAE,eAAe,CAAC,mBAAmB,CAAC,GAAG,SAAS,EAChE,UAAU,EAAE,mBAAmB,GAAG,SAAS,EAC3C,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EAAE,GACpB,OAAO,CAKT"}

package/esm/create-test/playwright/test-conditions.js

@@ -0,0 +1,76 @@
+// (C) 2026 GoodData Corporation
+/** Combine a describe's or test's own conditions with the inherited ones (`child` replaces `parent` by default). */
+export function combineConditions(testConditions, parent, child) {
+    if (child === undefined) {
+        return parent;
+    }
+    return testConditions?.merge ? testConditions.merge(parent, child) : child;
+}
+/**
+ * Throw if `conditions` is set (not `undefined`) but empty or of a type that isn't allowed. Empty values
+ * shouldn't be set at all. `0` is a valid number; objects other than plain objects, arrays, `Map` and
+ * `Set` (class instances, `Date`, ...) aren't checked for emptiness.
+ *
+ * @param conditions - the value from `details.conditions`
+ * @param where - call description used in the error message, e.g. `test.describe("title")`
+ */
+export function assertValidConditions(conditions, where) {
+    if (conditions === undefined) {
+        return;
+    }
+    const problem = getConditionsProblem(conditions);
+    if (problem) {
+        throw new Error(`${where}: \`conditions\` ${problem}. Leave \`conditions\` out instead.`);
+    }
+}
+function getConditionsProblem(conditions) {
+    // `null` and `boolean` are already rejected by the types; this catches values cast past them.
+    if (conditions === null) {
+        return "is null";
+    }
+    if (typeof conditions === "boolean") {
+        return "is a boolean, which isn't an allowed conditions value";
+    }
+    if (typeof conditions === "string") {
+        return conditions === "" ? "is set but empty (empty string)" : undefined;
+    }
+    if (typeof conditions === "number") {
+        return Number.isNaN(conditions) ? "is set but not a number (NaN)" : undefined;
+    }
+    if (Array.isArray(conditions)) {
+        return conditions.length === 0 ? "is set but empty (empty array)" : undefined;
+    }
+    if (conditions instanceof Map || conditions instanceof Set) {
+        return conditions.size === 0 ? `is set but empty (empty ${conditions.constructor.name})` : undefined;
+    }
+    if (typeof conditions === "object") {
+        const prototype = Object.getPrototypeOf(conditions);
+        const isPlainObject = prototype === Object.prototype || prototype === null;
+        return isPlainObject && Object.keys(conditions).length === 0
+            ? "is set but empty (object without keys)"
+            : undefined;
+    }
+    return undefined;
+}
+/**
+ * Throw if `testConditions.required` is set and a test ends up without conditions, neither its own
+ * nor inherited from an enclosing describe.
+ *
+ * @param where - call description used in the error message, e.g. `test("title")`
+ */
+export function assertRequiredConditions(testConditions, conditions, where, file) {
+    if (testConditions?.required && conditions === undefined) {
+        throw new Error(`${where}: \`testConditions.required\` is set, but neither this test nor any enclosing ` +
+            `test.describe() sets \`conditions\` (${file}).`);
+    }
+}
+/**
+ * Whether a test runs. Without conditions anywhere in its chain (or without `testConditions`
+ * configured), the predicate isn't called and the test runs.
+ */
+export function shouldRunTest(testConditions, conditions, file, titlePath) {
+    if (!testConditions || conditions === undefined) {
+        return true;
+    }
+    return testConditions.shouldRun(conditions, { file, titlePath });
+}

package/esm/create-test/playwright/to-playwright-details.d.ts

@@ -0,0 +1,5 @@
+import type { TestDetails } from "@playwright/test";
+import type { ITestDetails, TestConditionsValueConstraint } from "./types.js";
+/** Strip custom fields before passing details to Playwright. */
+export declare function toPlaywrightDetails(details: ITestDetails<TestConditionsValueConstraint>): TestDetails;
+//# sourceMappingURL=to-playwright-details.d.ts.map

package/esm/create-test/playwright/to-playwright-details.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-playwright-details.d.ts","sourceRoot":"","sources":["../../../src/create-test/playwright/to-playwright-details.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAE9E,gEAAgE;AAChE,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,CAAC,6BAA6B,CAAC,GAAG,WAAW,CAIrG"}

package/esm/create-test/playwright/to-playwright-details.js

@@ -0,0 +1,7 @@
+// (C) 2026 GoodData Corporation
+/** Strip custom fields before passing details to Playwright. */
+export function toPlaywrightDetails(details) {
+    // oxlint-disable-next-line @typescript-eslint/no-unused-vars
+    const { workspaceSettings: _ws, additionalWindowProperties: _awp, conditions: _c, ...rest } = details;
+    return Object.keys(rest).length > 0 ? rest : {};
+}