@emesoft_company/playwright-core 2.1.0

package/dist/di/index.js

@@ -0,0 +1,45 @@
+// src/errors/app-error.ts
+var AppError = class extends Error {
+  code;
+  context;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code;
+    this.context = options.context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+
+// src/di/container.ts
+var ServiceContainer = class {
+  factories = /* @__PURE__ */ new Map();
+  singletons = /* @__PURE__ */ new Map();
+  register(key, factory) {
+    this.factories.set(key, factory);
+    this.singletons.delete(key);
+  }
+  /** Replaces an existing registration — this is how a project overrides a core-provided service. */
+  override(key, factory) {
+    this.register(key, factory);
+  }
+  resolve(key) {
+    if (this.singletons.has(key)) {
+      return this.singletons.get(key);
+    }
+    const factory = this.factories.get(key);
+    if (!factory) {
+      throw new AppError(`No provider registered for service "${key}"`, { code: "DI_UNRESOLVED" });
+    }
+    const instance = factory(this);
+    this.singletons.set(key, instance);
+    return instance;
+  }
+  has(key) {
+    return this.factories.has(key);
+  }
+};
+
+export { ServiceContainer };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/di/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/app-error.ts","../../src/di/container.ts"],"names":[],"mappings":";AAWO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EACzB,IAAA;AAAA,EACA,OAAA;AAAA,EAET,WAAA,CAAY,SAAiB,OAAA,EAA0B;AACrD,IAAA,KAAA,CAAM,OAAA,EAAS,EAAE,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAA;AACvC,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AACvB,IAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,IAAA;AACpB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF,CAAA;;;ACXO,IAAM,mBAAN,MAAuB;AAAA,EACX,SAAA,uBAAgB,GAAA,EAA8B;AAAA,EAC9C,UAAA,uBAAiB,GAAA,EAAqB;AAAA,EAEvD,QAAA,CAAY,KAAa,OAAA,EAA2B;AAClD,IAAA,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,GAAA,EAAK,OAA2B,CAAA;AACnD,IAAA,IAAA,CAAK,UAAA,CAAW,OAAO,GAAG,CAAA;AAAA,EAC5B;AAAA;AAAA,EAGA,QAAA,CAAY,KAAa,OAAA,EAA2B;AAClD,IAAA,IAAA,CAAK,QAAA,CAAS,KAAK,OAAO,CAAA;AAAA,EAC5B;AAAA,EAEA,QAAW,GAAA,EAAgB;AACzB,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA,EAAG;AAC5B,MAAA,OAAO,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,GAAG,CAAA;AAAA,IAChC;AACA,IAAA,MAAM,OAAA,GAAU,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,GAAG,CAAA;AACtC,IAAA,IAAI,CAAC,OAAA,EAAS;AACZ,MAAA,MAAM,IAAI,SAAS,CAAA,oCAAA,EAAuC,GAAG,KAAK,EAAE,IAAA,EAAM,iBAAiB,CAAA;AAAA,IAC7F;AACA,IAAA,MAAM,QAAA,GAAW,QAAQ,IAAI,CAAA;AAC7B,IAAA,IAAA,CAAK,UAAA,CAAW,GAAA,CAAI,GAAA,EAAK,QAAQ,CAAA;AACjC,IAAA,OAAO,QAAA;AAAA,EACT;AAAA,EAEA,IAAI,GAAA,EAAsB;AACxB,IAAA,OAAO,IAAA,CAAK,SAAA,CAAU,GAAA,CAAI,GAAG,CAAA;AAAA,EAC/B;AACF","file":"index.js","sourcesContent":["export interface AppErrorOptions {\n  code: string;\n  cause?: unknown;\n  context?: Record<string, unknown>;\n}\n\n/**\n * Base error class for the framework. Every error thrown by core carries a\n * machine-readable `code` and optional `context`, so callers can branch on\n * `error.code` instead of parsing messages.\n */\nexport class AppError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, options: AppErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code;\n    this.context = options.context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ConfigValidationError extends AppError {\n  constructor(message: string, issues: unknown, context?: Record<string, unknown>) {\n    super(message, { code: \"CONFIG_VALIDATION_ERROR\", context: { issues, ...context } });\n  }\n}\n\nexport class ApiError extends AppError {\n  readonly status?: number;\n  readonly method?: string;\n  readonly url?: string;\n\n  constructor(\n    message: string,\n    options: AppErrorOptions & { status?: number; method?: string; url?: string },\n  ) {\n    super(message, options);\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n  }\n}\n\nexport class AuthError extends AppError {\n  constructor(message: string, options: Omit<AppErrorOptions, \"code\"> = {}) {\n    super(message, { code: \"AUTH_ERROR\", ...options });\n  }\n}\n\nexport class ConfigMissingError extends AppError {\n  constructor(name: string) {\n    super(`Required environment variable \"${name}\" is not set`, {\n      code: \"ENV_VAR_MISSING\",\n      context: { name },\n    });\n  }\n}\n","import { AppError } from \"../errors/app-error.js\";\n\nexport type Factory<T> = (container: ServiceContainer) => T;\n\n/**\n * Minimal typed service locator used internally by core (and available to projects)\n * for wiring services that aren't naturally expressed as Playwright fixtures — e.g.\n * a token provider shared by both the API client and UI auth setup. Playwright's own\n * `test.extend()` remains the primary DI mechanism for anything test-scoped; this\n * container is for singletons that outlive a single fixture chain.\n */\nexport class ServiceContainer {\n  private readonly factories = new Map<string, Factory<unknown>>();\n  private readonly singletons = new Map<string, unknown>();\n\n  register<T>(key: string, factory: Factory<T>): void {\n    this.factories.set(key, factory as Factory<unknown>);\n    this.singletons.delete(key);\n  }\n\n  /** Replaces an existing registration — this is how a project overrides a core-provided service. */\n  override<T>(key: string, factory: Factory<T>): void {\n    this.register(key, factory);\n  }\n\n  resolve<T>(key: string): T {\n    if (this.singletons.has(key)) {\n      return this.singletons.get(key) as T;\n    }\n    const factory = this.factories.get(key);\n    if (!factory) {\n      throw new AppError(`No provider registered for service \"${key}\"`, { code: \"DI_UNRESOLVED\" });\n    }\n    const instance = factory(this);\n    this.singletons.set(key, instance);\n    return instance as T;\n  }\n\n  has(key: string): boolean {\n    return this.factories.has(key);\n  }\n}\n"]}

package/dist/errors/index.cjs

@@ -0,0 +1,90 @@
+'use strict';
+
+// src/errors/app-error.ts
+var AppError = class extends Error {
+  code;
+  context;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code;
+    this.context = options.context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ConfigValidationError = class extends AppError {
+  constructor(message, issues, context) {
+    super(message, { code: "CONFIG_VALIDATION_ERROR", context: { issues, ...context } });
+  }
+};
+var ApiError = class extends AppError {
+  status;
+  method;
+  url;
+  constructor(message, options) {
+    super(message, options);
+    this.status = options.status;
+    this.method = options.method;
+    this.url = options.url;
+  }
+};
+var AuthError = class extends AppError {
+  constructor(message, options = {}) {
+    super(message, { code: "AUTH_ERROR", ...options });
+  }
+};
+var ConfigMissingError = class extends AppError {
+  constructor(name) {
+    super(`Required environment variable "${name}" is not set`, {
+      code: "ENV_VAR_MISSING",
+      context: { name }
+    });
+  }
+};
+
+// src/utils/sleep.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/errors/retry.ts
+function backoffDelay(attempt, minDelayMs, maxDelayMs, factor) {
+  const exponential = minDelayMs * factor ** (attempt - 1);
+  const jitter = Math.random() * minDelayMs;
+  return Math.min(exponential + jitter, maxDelayMs);
+}
+async function withRetry(fn, options = {}) {
+  const {
+    retries = 2,
+    minDelayMs = 200,
+    maxDelayMs = 5e3,
+    factor = 2,
+    retryOn = () => true,
+    onRetry,
+    onGiveUp
+  } = options;
+  const maxAttempts = retries + 1;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      const isLastAttempt = attempt >= maxAttempts;
+      if (isLastAttempt || !retryOn(error)) {
+        onGiveUp?.(error, attempt);
+        throw error;
+      }
+      onRetry?.(error, attempt);
+      await sleep(backoffDelay(attempt, minDelayMs, maxDelayMs, factor));
+    }
+  }
+  throw new Error("withRetry: unreachable state");
+}
+
+exports.ApiError = ApiError;
+exports.AppError = AppError;
+exports.AuthError = AuthError;
+exports.ConfigMissingError = ConfigMissingError;
+exports.ConfigValidationError = ConfigValidationError;
+exports.withRetry = withRetry;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/errors/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/app-error.ts","../../src/utils/sleep.ts","../../src/errors/retry.ts"],"names":[],"mappings":";;;AAWO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EACzB,IAAA;AAAA,EACA,OAAA;AAAA,EAET,WAAA,CAAY,SAAiB,OAAA,EAA0B;AACrD,IAAA,KAAA,CAAM,OAAA,EAAS,EAAE,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAA;AACvC,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AACvB,IAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,IAAA;AACpB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;AAEO,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAS;AAAA,EAClD,WAAA,CAAY,OAAA,EAAiB,MAAA,EAAiB,OAAA,EAAmC;AAC/E,IAAA,KAAA,CAAM,OAAA,EAAS,EAAE,IAAA,EAAM,yBAAA,EAA2B,OAAA,EAAS,EAAE,MAAA,EAAQ,GAAG,OAAA,EAAQ,EAAG,CAAA;AAAA,EACrF;AACF;AAEO,IAAM,QAAA,GAAN,cAAuB,QAAA,CAAS;AAAA,EAC5B,MAAA;AAAA,EACA,MAAA;AAAA,EACA,GAAA;AAAA,EAET,WAAA,CACE,SACA,OAAA,EACA;AACA,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,MAAM,OAAA,CAAQ,GAAA;AAAA,EACrB;AACF;AAEO,IAAM,SAAA,GAAN,cAAwB,QAAA,CAAS;AAAA,EACtC,WAAA,CAAY,OAAA,EAAiB,OAAA,GAAyC,EAAC,EAAG;AACxE,IAAA,KAAA,CAAM,SAAS,EAAE,IAAA,EAAM,YAAA,EAAc,GAAG,SAAS,CAAA;AAAA,EACnD;AACF;AAEO,IAAM,kBAAA,GAAN,cAAiC,QAAA,CAAS;AAAA,EAC/C,YAAY,IAAA,EAAc;AACxB,IAAA,KAAA,CAAM,CAAA,+BAAA,EAAkC,IAAI,CAAA,YAAA,CAAA,EAAgB;AAAA,MAC1D,IAAA,EAAM,iBAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AAAA,EACH;AACF;;;AC3DO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;;;ACeA,SAAS,YAAA,CAAa,OAAA,EAAiB,UAAA,EAAoB,UAAA,EAAoB,MAAA,EAAwB;AACrG,EAAA,MAAM,WAAA,GAAc,UAAA,GAAa,MAAA,KAAW,OAAA,GAAU,CAAA,CAAA;AACtD,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,EAAO,GAAI,UAAA;AAC/B,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,WAAA,GAAc,MAAA,EAAQ,UAAU,CAAA;AAClD;AAYA,eAAsB,SAAA,CAAa,EAAA,EAAsB,OAAA,GAAwB,EAAC,EAAe;AAC/F,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,CAAA;AAAA,IACV,UAAA,GAAa,GAAA;AAAA,IACb,UAAA,GAAa,GAAA;AAAA,IACb,MAAA,GAAS,CAAA;AAAA,IACT,UAAU,MAAM,IAAA;AAAA,IAChB,OAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,cAAc,OAAA,GAAU,CAAA;AAE9B,EAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,WAAA,EAAa,OAAA,EAAA,EAAW;AACvD,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,EAAA,EAAG;AAAA,IAClB,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,gBAAgB,OAAA,IAAW,WAAA;AACjC,MAAA,IAAI,aAAA,IAAiB,CAAC,OAAA,CAAQ,KAAK,CAAA,EAAG;AACpC,QAAA,QAAA,GAAW,OAAO,OAAO,CAAA;AACzB,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,OAAA,GAAU,OAAO,OAAO,CAAA;AACxB,MAAA,MAAM,MAAM,YAAA,CAAa,OAAA,EAAS,UAAA,EAAY,UAAA,EAAY,MAAM,CAAC,CAAA;AAAA,IACnE;AAAA,EACF;AAGA,EAAA,MAAM,IAAI,MAAM,8BAA8B,CAAA;AAChD","file":"index.cjs","sourcesContent":["export interface AppErrorOptions {\n  code: string;\n  cause?: unknown;\n  context?: Record<string, unknown>;\n}\n\n/**\n * Base error class for the framework. Every error thrown by core carries a\n * machine-readable `code` and optional `context`, so callers can branch on\n * `error.code` instead of parsing messages.\n */\nexport class AppError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, options: AppErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code;\n    this.context = options.context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ConfigValidationError extends AppError {\n  constructor(message: string, issues: unknown, context?: Record<string, unknown>) {\n    super(message, { code: \"CONFIG_VALIDATION_ERROR\", context: { issues, ...context } });\n  }\n}\n\nexport class ApiError extends AppError {\n  readonly status?: number;\n  readonly method?: string;\n  readonly url?: string;\n\n  constructor(\n    message: string,\n    options: AppErrorOptions & { status?: number; method?: string; url?: string },\n  ) {\n    super(message, options);\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n  }\n}\n\nexport class AuthError extends AppError {\n  constructor(message: string, options: Omit<AppErrorOptions, \"code\"> = {}) {\n    super(message, { code: \"AUTH_ERROR\", ...options });\n  }\n}\n\nexport class ConfigMissingError extends AppError {\n  constructor(name: string) {\n    super(`Required environment variable \"${name}\" is not set`, {\n      code: \"ENV_VAR_MISSING\",\n      context: { name },\n    });\n  }\n}\n","export function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { sleep } from \"../utils/sleep.js\";\n\nexport interface RetryOptions {\n  /** Number of retry attempts after the initial try. Default: 2. */\n  retries?: number;\n  minDelayMs?: number;\n  maxDelayMs?: number;\n  /** Exponential backoff factor. Default: 2. */\n  factor?: number;\n  /** Return true to retry this error, false to fail fast. Default: retry everything. */\n  retryOn?: (error: unknown) => boolean;\n  /** Called before each retry (not before the first attempt). */\n  onRetry?: (error: unknown, attempt: number) => void;\n  /** Called once when giving up, with the total number of attempts made. */\n  onGiveUp?: (error: unknown, attempts: number) => void;\n}\n\nfunction backoffDelay(attempt: number, minDelayMs: number, maxDelayMs: number, factor: number): number {\n  const exponential = minDelayMs * factor ** (attempt - 1);\n  const jitter = Math.random() * minDelayMs;\n  return Math.min(exponential + jitter, maxDelayMs);\n}\n\n/**\n * Runs `fn` with exponential-backoff retry. Used for both flaky API calls and\n * flaky UI actions so the retry policy stays consistent across the framework.\n *\n * Always rethrows the ORIGINAL error — whether it failed fast (`retryOn` returned\n * false) or exhausted its retries. That's what makes `catch (e) { e instanceof ApiError }`\n * and `expect(...).rejects.toThrow(ApiError)` work in tests; wrapping the error in a\n * retry-specific type would hide the only thing the caller actually wants to assert on.\n * Use `onGiveUp` if you need the attempt count.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n  const {\n    retries = 2,\n    minDelayMs = 200,\n    maxDelayMs = 5_000,\n    factor = 2,\n    retryOn = () => true,\n    onRetry,\n    onGiveUp,\n  } = options;\n\n  const maxAttempts = retries + 1;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      const isLastAttempt = attempt >= maxAttempts;\n      if (isLastAttempt || !retryOn(error)) {\n        onGiveUp?.(error, attempt);\n        throw error;\n      }\n      onRetry?.(error, attempt);\n      await sleep(backoffDelay(attempt, minDelayMs, maxDelayMs, factor));\n    }\n  }\n\n  // Unreachable: the loop either returns or throws.\n  throw new Error(\"withRetry: unreachable state\");\n}\n"]}

package/dist/errors/index.d.cts

@@ -0,0 +1,38 @@
+export { R as RetryOptions, w as withRetry } from '../retry-XqnSC8YL.cjs';
+
+interface AppErrorOptions {
+    code: string;
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base error class for the framework. Every error thrown by core carries a
+ * machine-readable `code` and optional `context`, so callers can branch on
+ * `error.code` instead of parsing messages.
+ */
+declare class AppError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options: AppErrorOptions);
+}
+declare class ConfigValidationError extends AppError {
+    constructor(message: string, issues: unknown, context?: Record<string, unknown>);
+}
+declare class ApiError extends AppError {
+    readonly status?: number;
+    readonly method?: string;
+    readonly url?: string;
+    constructor(message: string, options: AppErrorOptions & {
+        status?: number;
+        method?: string;
+        url?: string;
+    });
+}
+declare class AuthError extends AppError {
+    constructor(message: string, options?: Omit<AppErrorOptions, "code">);
+}
+declare class ConfigMissingError extends AppError {
+    constructor(name: string);
+}
+
+export { ApiError, AppError, type AppErrorOptions, AuthError, ConfigMissingError, ConfigValidationError };

package/dist/errors/index.d.ts

@@ -0,0 +1,38 @@
+export { R as RetryOptions, w as withRetry } from '../retry-XqnSC8YL.js';
+
+interface AppErrorOptions {
+    code: string;
+    cause?: unknown;
+    context?: Record<string, unknown>;
+}
+/**
+ * Base error class for the framework. Every error thrown by core carries a
+ * machine-readable `code` and optional `context`, so callers can branch on
+ * `error.code` instead of parsing messages.
+ */
+declare class AppError extends Error {
+    readonly code: string;
+    readonly context?: Record<string, unknown>;
+    constructor(message: string, options: AppErrorOptions);
+}
+declare class ConfigValidationError extends AppError {
+    constructor(message: string, issues: unknown, context?: Record<string, unknown>);
+}
+declare class ApiError extends AppError {
+    readonly status?: number;
+    readonly method?: string;
+    readonly url?: string;
+    constructor(message: string, options: AppErrorOptions & {
+        status?: number;
+        method?: string;
+        url?: string;
+    });
+}
+declare class AuthError extends AppError {
+    constructor(message: string, options?: Omit<AppErrorOptions, "code">);
+}
+declare class ConfigMissingError extends AppError {
+    constructor(name: string);
+}
+
+export { ApiError, AppError, type AppErrorOptions, AuthError, ConfigMissingError, ConfigValidationError };

package/dist/errors/index.js

@@ -0,0 +1,83 @@
+// src/errors/app-error.ts
+var AppError = class extends Error {
+  code;
+  context;
+  constructor(message, options) {
+    super(message, { cause: options.cause });
+    this.name = new.target.name;
+    this.code = options.code;
+    this.context = options.context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var ConfigValidationError = class extends AppError {
+  constructor(message, issues, context) {
+    super(message, { code: "CONFIG_VALIDATION_ERROR", context: { issues, ...context } });
+  }
+};
+var ApiError = class extends AppError {
+  status;
+  method;
+  url;
+  constructor(message, options) {
+    super(message, options);
+    this.status = options.status;
+    this.method = options.method;
+    this.url = options.url;
+  }
+};
+var AuthError = class extends AppError {
+  constructor(message, options = {}) {
+    super(message, { code: "AUTH_ERROR", ...options });
+  }
+};
+var ConfigMissingError = class extends AppError {
+  constructor(name) {
+    super(`Required environment variable "${name}" is not set`, {
+      code: "ENV_VAR_MISSING",
+      context: { name }
+    });
+  }
+};
+
+// src/utils/sleep.ts
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+
+// src/errors/retry.ts
+function backoffDelay(attempt, minDelayMs, maxDelayMs, factor) {
+  const exponential = minDelayMs * factor ** (attempt - 1);
+  const jitter = Math.random() * minDelayMs;
+  return Math.min(exponential + jitter, maxDelayMs);
+}
+async function withRetry(fn, options = {}) {
+  const {
+    retries = 2,
+    minDelayMs = 200,
+    maxDelayMs = 5e3,
+    factor = 2,
+    retryOn = () => true,
+    onRetry,
+    onGiveUp
+  } = options;
+  const maxAttempts = retries + 1;
+  for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+    try {
+      return await fn();
+    } catch (error) {
+      const isLastAttempt = attempt >= maxAttempts;
+      if (isLastAttempt || !retryOn(error)) {
+        onGiveUp?.(error, attempt);
+        throw error;
+      }
+      onRetry?.(error, attempt);
+      await sleep(backoffDelay(attempt, minDelayMs, maxDelayMs, factor));
+    }
+  }
+  throw new Error("withRetry: unreachable state");
+}
+
+export { ApiError, AppError, AuthError, ConfigMissingError, ConfigValidationError, withRetry };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/errors/app-error.ts","../../src/utils/sleep.ts","../../src/errors/retry.ts"],"names":[],"mappings":";AAWO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EACzB,IAAA;AAAA,EACA,OAAA;AAAA,EAET,WAAA,CAAY,SAAiB,OAAA,EAA0B;AACrD,IAAA,KAAA,CAAM,OAAA,EAAS,EAAE,KAAA,EAAO,OAAA,CAAQ,OAAO,CAAA;AACvC,IAAA,IAAA,CAAK,OAAO,GAAA,CAAA,MAAA,CAAW,IAAA;AACvB,IAAA,IAAA,CAAK,OAAO,OAAA,CAAQ,IAAA;AACpB,IAAA,IAAA,CAAK,UAAU,OAAA,CAAQ,OAAA;AACvB,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAAA,EAClD;AACF;AAEO,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAS;AAAA,EAClD,WAAA,CAAY,OAAA,EAAiB,MAAA,EAAiB,OAAA,EAAmC;AAC/E,IAAA,KAAA,CAAM,OAAA,EAAS,EAAE,IAAA,EAAM,yBAAA,EAA2B,OAAA,EAAS,EAAE,MAAA,EAAQ,GAAG,OAAA,EAAQ,EAAG,CAAA;AAAA,EACrF;AACF;AAEO,IAAM,QAAA,GAAN,cAAuB,QAAA,CAAS;AAAA,EAC5B,MAAA;AAAA,EACA,MAAA;AAAA,EACA,GAAA;AAAA,EAET,WAAA,CACE,SACA,OAAA,EACA;AACA,IAAA,KAAA,CAAM,SAAS,OAAO,CAAA;AACtB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,SAAS,OAAA,CAAQ,MAAA;AACtB,IAAA,IAAA,CAAK,MAAM,OAAA,CAAQ,GAAA;AAAA,EACrB;AACF;AAEO,IAAM,SAAA,GAAN,cAAwB,QAAA,CAAS;AAAA,EACtC,WAAA,CAAY,OAAA,EAAiB,OAAA,GAAyC,EAAC,EAAG;AACxE,IAAA,KAAA,CAAM,SAAS,EAAE,IAAA,EAAM,YAAA,EAAc,GAAG,SAAS,CAAA;AAAA,EACnD;AACF;AAEO,IAAM,kBAAA,GAAN,cAAiC,QAAA,CAAS;AAAA,EAC/C,YAAY,IAAA,EAAc;AACxB,IAAA,KAAA,CAAM,CAAA,+BAAA,EAAkC,IAAI,CAAA,YAAA,CAAA,EAAgB;AAAA,MAC1D,IAAA,EAAM,iBAAA;AAAA,MACN,OAAA,EAAS,EAAE,IAAA;AAAK,KACjB,CAAA;AAAA,EACH;AACF;;;AC3DO,SAAS,MAAM,EAAA,EAA2B;AAC/C,EAAA,OAAO,IAAI,OAAA,CAAQ,CAAC,YAAY,UAAA,CAAW,OAAA,EAAS,EAAE,CAAC,CAAA;AACzD;;;ACeA,SAAS,YAAA,CAAa,OAAA,EAAiB,UAAA,EAAoB,UAAA,EAAoB,MAAA,EAAwB;AACrG,EAAA,MAAM,WAAA,GAAc,UAAA,GAAa,MAAA,KAAW,OAAA,GAAU,CAAA,CAAA;AACtD,EAAA,MAAM,MAAA,GAAS,IAAA,CAAK,MAAA,EAAO,GAAI,UAAA;AAC/B,EAAA,OAAO,IAAA,CAAK,GAAA,CAAI,WAAA,GAAc,MAAA,EAAQ,UAAU,CAAA;AAClD;AAYA,eAAsB,SAAA,CAAa,EAAA,EAAsB,OAAA,GAAwB,EAAC,EAAe;AAC/F,EAAA,MAAM;AAAA,IACJ,OAAA,GAAU,CAAA;AAAA,IACV,UAAA,GAAa,GAAA;AAAA,IACb,UAAA,GAAa,GAAA;AAAA,IACb,MAAA,GAAS,CAAA;AAAA,IACT,UAAU,MAAM,IAAA;AAAA,IAChB,OAAA;AAAA,IACA;AAAA,GACF,GAAI,OAAA;AAEJ,EAAA,MAAM,cAAc,OAAA,GAAU,CAAA;AAE9B,EAAA,KAAA,IAAS,OAAA,GAAU,CAAA,EAAG,OAAA,IAAW,WAAA,EAAa,OAAA,EAAA,EAAW;AACvD,IAAA,IAAI;AACF,MAAA,OAAO,MAAM,EAAA,EAAG;AAAA,IAClB,SAAS,KAAA,EAAO;AACd,MAAA,MAAM,gBAAgB,OAAA,IAAW,WAAA;AACjC,MAAA,IAAI,aAAA,IAAiB,CAAC,OAAA,CAAQ,KAAK,CAAA,EAAG;AACpC,QAAA,QAAA,GAAW,OAAO,OAAO,CAAA;AACzB,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,OAAA,GAAU,OAAO,OAAO,CAAA;AACxB,MAAA,MAAM,MAAM,YAAA,CAAa,OAAA,EAAS,UAAA,EAAY,UAAA,EAAY,MAAM,CAAC,CAAA;AAAA,IACnE;AAAA,EACF;AAGA,EAAA,MAAM,IAAI,MAAM,8BAA8B,CAAA;AAChD","file":"index.js","sourcesContent":["export interface AppErrorOptions {\n  code: string;\n  cause?: unknown;\n  context?: Record<string, unknown>;\n}\n\n/**\n * Base error class for the framework. Every error thrown by core carries a\n * machine-readable `code` and optional `context`, so callers can branch on\n * `error.code` instead of parsing messages.\n */\nexport class AppError extends Error {\n  readonly code: string;\n  readonly context?: Record<string, unknown>;\n\n  constructor(message: string, options: AppErrorOptions) {\n    super(message, { cause: options.cause });\n    this.name = new.target.name;\n    this.code = options.code;\n    this.context = options.context;\n    Object.setPrototypeOf(this, new.target.prototype);\n  }\n}\n\nexport class ConfigValidationError extends AppError {\n  constructor(message: string, issues: unknown, context?: Record<string, unknown>) {\n    super(message, { code: \"CONFIG_VALIDATION_ERROR\", context: { issues, ...context } });\n  }\n}\n\nexport class ApiError extends AppError {\n  readonly status?: number;\n  readonly method?: string;\n  readonly url?: string;\n\n  constructor(\n    message: string,\n    options: AppErrorOptions & { status?: number; method?: string; url?: string },\n  ) {\n    super(message, options);\n    this.status = options.status;\n    this.method = options.method;\n    this.url = options.url;\n  }\n}\n\nexport class AuthError extends AppError {\n  constructor(message: string, options: Omit<AppErrorOptions, \"code\"> = {}) {\n    super(message, { code: \"AUTH_ERROR\", ...options });\n  }\n}\n\nexport class ConfigMissingError extends AppError {\n  constructor(name: string) {\n    super(`Required environment variable \"${name}\" is not set`, {\n      code: \"ENV_VAR_MISSING\",\n      context: { name },\n    });\n  }\n}\n","export function sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n","import { sleep } from \"../utils/sleep.js\";\n\nexport interface RetryOptions {\n  /** Number of retry attempts after the initial try. Default: 2. */\n  retries?: number;\n  minDelayMs?: number;\n  maxDelayMs?: number;\n  /** Exponential backoff factor. Default: 2. */\n  factor?: number;\n  /** Return true to retry this error, false to fail fast. Default: retry everything. */\n  retryOn?: (error: unknown) => boolean;\n  /** Called before each retry (not before the first attempt). */\n  onRetry?: (error: unknown, attempt: number) => void;\n  /** Called once when giving up, with the total number of attempts made. */\n  onGiveUp?: (error: unknown, attempts: number) => void;\n}\n\nfunction backoffDelay(attempt: number, minDelayMs: number, maxDelayMs: number, factor: number): number {\n  const exponential = minDelayMs * factor ** (attempt - 1);\n  const jitter = Math.random() * minDelayMs;\n  return Math.min(exponential + jitter, maxDelayMs);\n}\n\n/**\n * Runs `fn` with exponential-backoff retry. Used for both flaky API calls and\n * flaky UI actions so the retry policy stays consistent across the framework.\n *\n * Always rethrows the ORIGINAL error — whether it failed fast (`retryOn` returned\n * false) or exhausted its retries. That's what makes `catch (e) { e instanceof ApiError }`\n * and `expect(...).rejects.toThrow(ApiError)` work in tests; wrapping the error in a\n * retry-specific type would hide the only thing the caller actually wants to assert on.\n * Use `onGiveUp` if you need the attempt count.\n */\nexport async function withRetry<T>(fn: () => Promise<T>, options: RetryOptions = {}): Promise<T> {\n  const {\n    retries = 2,\n    minDelayMs = 200,\n    maxDelayMs = 5_000,\n    factor = 2,\n    retryOn = () => true,\n    onRetry,\n    onGiveUp,\n  } = options;\n\n  const maxAttempts = retries + 1;\n\n  for (let attempt = 1; attempt <= maxAttempts; attempt++) {\n    try {\n      return await fn();\n    } catch (error) {\n      const isLastAttempt = attempt >= maxAttempts;\n      if (isLastAttempt || !retryOn(error)) {\n        onGiveUp?.(error, attempt);\n        throw error;\n      }\n      onRetry?.(error, attempt);\n      await sleep(backoffDelay(attempt, minDelayMs, maxDelayMs, factor));\n    }\n  }\n\n  // Unreachable: the loop either returns or throws.\n  throw new Error(\"withRetry: unreachable state\");\n}\n"]}

package/dist/expect/index.cjs

@@ -0,0 +1,36 @@
+'use strict';
+
+var test = require('@playwright/test');
+
+// src/expect/matchers.ts
+var expect = test.expect.extend({
+  /**
+   * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on
+   * failure — otherwise a wrong status tells you nothing about why.
+   */
+  toHaveStatus(received, expected) {
+    const pass = received.status === expected;
+    return {
+      pass,
+      name: "toHaveStatus",
+      expected,
+      actual: received.status,
+      message: () => pass ? `Expected status not to be ${expected}` : `Expected ${received.method} ${received.url} to return ${expected}, got ${received.status}
+Body: ${JSON.stringify(received.data, null, 2)}`
+    };
+  },
+  /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */
+  toMatchSchema(received, schema) {
+    const result = schema.safeParse(received);
+    return {
+      pass: result.success,
+      name: "toMatchSchema",
+      message: () => result.success ? "Expected value not to match the schema" : `Value did not match the schema:
+${result.error.issues.map((issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`).join("\n")}`
+    };
+  }
+});
+
+exports.expect = expect;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/expect/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/expect/matchers.ts"],"names":["baseExpect"],"mappings":";;;;;AASO,IAAM,MAAA,GAASA,YAAW,MAAA,CAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtC,YAAA,CAAa,UAAgC,QAAA,EAAkB;AAC7D,IAAA,MAAM,IAAA,GAAO,SAAS,MAAA,KAAW,QAAA;AACjC,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,IAAA,EAAM,cAAA;AAAA,MACN,QAAA;AAAA,MACA,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,SAAS,MACP,IAAA,GACI,CAAA,0BAAA,EAA6B,QAAQ,KACrC,CAAA,SAAA,EAAY,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,GAAG,CAAA,WAAA,EAAc,QAAQ,CAAA,MAAA,EAAS,SAAS,MAAM;AAAA,MAAA,EAChF,KAAK,SAAA,CAAU,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,KACvD;AAAA,EACF,CAAA;AAAA;AAAA,EAGA,aAAA,CAAc,UAAmB,MAAA,EAA0B;AACzD,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AACxC,IAAA,OAAO;AAAA,MACL,MAAM,MAAA,CAAO,OAAA;AAAA,MACb,IAAA,EAAM,eAAA;AAAA,MACN,OAAA,EAAS,MACP,MAAA,CAAO,OAAA,GACH,wCAAA,GACA,CAAA;AAAA,EAAoC,MAAA,CAAO,MAAM,MAAA,CAC9C,GAAA,CAAI,CAAC,KAAA,KAAU,CAAA,IAAA,EAAO,MAAM,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,IAAK,QAAQ,KAAK,KAAA,CAAM,OAAO,EAAE,CAAA,CAC1E,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACrB;AAAA,EACF;AACF,CAAC","file":"index.cjs","sourcesContent":["import { expect as baseExpect } from \"@playwright/test\";\nimport type { ZodType } from \"zod\";\nimport type { ApiResponse } from \"../api/types.js\";\n\n/**\n * `expect` with a few framework-specific matchers added. Projects get these automatically by\n * importing `expect` from `@emesoft_company/playwright-core/fixtures` (or their own `fixtures/index.ts`),\n * so there's nothing to register per project.\n */\nexport const expect = baseExpect.extend({\n  /**\n   * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on\n   * failure — otherwise a wrong status tells you nothing about why.\n   */\n  toHaveStatus(received: ApiResponse<unknown>, expected: number) {\n    const pass = received.status === expected;\n    return {\n      pass,\n      name: \"toHaveStatus\",\n      expected,\n      actual: received.status,\n      message: () =>\n        pass\n          ? `Expected status not to be ${expected}`\n          : `Expected ${received.method} ${received.url} to return ${expected}, got ${received.status}\\n` +\n            `Body: ${JSON.stringify(received.data, null, 2)}`,\n    };\n  },\n\n  /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */\n  toMatchSchema(received: unknown, schema: ZodType<unknown>) {\n    const result = schema.safeParse(received);\n    return {\n      pass: result.success,\n      name: \"toMatchSchema\",\n      message: () =>\n        result.success\n          ? \"Expected value not to match the schema\"\n          : `Value did not match the schema:\\n${result.error.issues\n              .map((issue) => `  - ${issue.path.join(\".\") || \"(root)\"}: ${issue.message}`)\n              .join(\"\\n\")}`,\n    };\n  },\n});\n"]}

package/dist/expect/index.d.cts

@@ -0,0 +1,30 @@
+import * as _playwright_test from '@playwright/test';
+import { ZodType } from 'zod';
+import { b as ApiResponse } from '../types-hInbkPXf.cjs';
+
+/**
+ * `expect` with a few framework-specific matchers added. Projects get these automatically by
+ * importing `expect` from `@emesoft_company/playwright-core/fixtures` (or their own `fixtures/index.ts`),
+ * so there's nothing to register per project.
+ */
+declare const expect: _playwright_test.Expect<{
+    /**
+     * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on
+     * failure — otherwise a wrong status tells you nothing about why.
+     */
+    toHaveStatus(this: _playwright_test.ExpectMatcherState, received: ApiResponse<unknown>, expected: number): {
+        pass: boolean;
+        name: string;
+        expected: number;
+        actual: number;
+        message: () => string;
+    };
+    /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */
+    toMatchSchema(this: _playwright_test.ExpectMatcherState, received: unknown, schema: ZodType<unknown>): {
+        pass: boolean;
+        name: string;
+        message: () => string;
+    };
+}>;
+
+export { expect };

package/dist/expect/index.d.ts

@@ -0,0 +1,30 @@
+import * as _playwright_test from '@playwright/test';
+import { ZodType } from 'zod';
+import { b as ApiResponse } from '../types-hInbkPXf.js';
+
+/**
+ * `expect` with a few framework-specific matchers added. Projects get these automatically by
+ * importing `expect` from `@emesoft_company/playwright-core/fixtures` (or their own `fixtures/index.ts`),
+ * so there's nothing to register per project.
+ */
+declare const expect: _playwright_test.Expect<{
+    /**
+     * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on
+     * failure — otherwise a wrong status tells you nothing about why.
+     */
+    toHaveStatus(this: _playwright_test.ExpectMatcherState, received: ApiResponse<unknown>, expected: number): {
+        pass: boolean;
+        name: string;
+        expected: number;
+        actual: number;
+        message: () => string;
+    };
+    /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */
+    toMatchSchema(this: _playwright_test.ExpectMatcherState, received: unknown, schema: ZodType<unknown>): {
+        pass: boolean;
+        name: string;
+        message: () => string;
+    };
+}>;
+
+export { expect };

package/dist/expect/index.js

@@ -0,0 +1,34 @@
+import { expect as expect$1 } from '@playwright/test';
+
+// src/expect/matchers.ts
+var expect = expect$1.extend({
+  /**
+   * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on
+   * failure — otherwise a wrong status tells you nothing about why.
+   */
+  toHaveStatus(received, expected) {
+    const pass = received.status === expected;
+    return {
+      pass,
+      name: "toHaveStatus",
+      expected,
+      actual: received.status,
+      message: () => pass ? `Expected status not to be ${expected}` : `Expected ${received.method} ${received.url} to return ${expected}, got ${received.status}
+Body: ${JSON.stringify(received.data, null, 2)}`
+    };
+  },
+  /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */
+  toMatchSchema(received, schema) {
+    const result = schema.safeParse(received);
+    return {
+      pass: result.success,
+      name: "toMatchSchema",
+      message: () => result.success ? "Expected value not to match the schema" : `Value did not match the schema:
+${result.error.issues.map((issue) => `  - ${issue.path.join(".") || "(root)"}: ${issue.message}`).join("\n")}`
+    };
+  }
+});
+
+export { expect };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/expect/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/expect/matchers.ts"],"names":["baseExpect"],"mappings":";;;AASO,IAAM,MAAA,GAASA,SAAW,MAAA,CAAO;AAAA;AAAA;AAAA;AAAA;AAAA,EAKtC,YAAA,CAAa,UAAgC,QAAA,EAAkB;AAC7D,IAAA,MAAM,IAAA,GAAO,SAAS,MAAA,KAAW,QAAA;AACjC,IAAA,OAAO;AAAA,MACL,IAAA;AAAA,MACA,IAAA,EAAM,cAAA;AAAA,MACN,QAAA;AAAA,MACA,QAAQ,QAAA,CAAS,MAAA;AAAA,MACjB,SAAS,MACP,IAAA,GACI,CAAA,0BAAA,EAA6B,QAAQ,KACrC,CAAA,SAAA,EAAY,QAAA,CAAS,MAAM,CAAA,CAAA,EAAI,SAAS,GAAG,CAAA,WAAA,EAAc,QAAQ,CAAA,MAAA,EAAS,SAAS,MAAM;AAAA,MAAA,EAChF,KAAK,SAAA,CAAU,QAAA,CAAS,IAAA,EAAM,IAAA,EAAM,CAAC,CAAC,CAAA;AAAA,KACvD;AAAA,EACF,CAAA;AAAA;AAAA,EAGA,aAAA,CAAc,UAAmB,MAAA,EAA0B;AACzD,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,SAAA,CAAU,QAAQ,CAAA;AACxC,IAAA,OAAO;AAAA,MACL,MAAM,MAAA,CAAO,OAAA;AAAA,MACb,IAAA,EAAM,eAAA;AAAA,MACN,OAAA,EAAS,MACP,MAAA,CAAO,OAAA,GACH,wCAAA,GACA,CAAA;AAAA,EAAoC,MAAA,CAAO,MAAM,MAAA,CAC9C,GAAA,CAAI,CAAC,KAAA,KAAU,CAAA,IAAA,EAAO,MAAM,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,IAAK,QAAQ,KAAK,KAAA,CAAM,OAAO,EAAE,CAAA,CAC1E,IAAA,CAAK,IAAI,CAAC,CAAA;AAAA,KACrB;AAAA,EACF;AACF,CAAC","file":"index.js","sourcesContent":["import { expect as baseExpect } from \"@playwright/test\";\nimport type { ZodType } from \"zod\";\nimport type { ApiResponse } from \"../api/types.js\";\n\n/**\n * `expect` with a few framework-specific matchers added. Projects get these automatically by\n * importing `expect` from `@emesoft_company/playwright-core/fixtures` (or their own `fixtures/index.ts`),\n * so there's nothing to register per project.\n */\nexport const expect = baseExpect.extend({\n  /**\n   * Asserts the status of an `ApiResponse` from `apiClient.send()`, printing the body on\n   * failure — otherwise a wrong status tells you nothing about why.\n   */\n  toHaveStatus(received: ApiResponse<unknown>, expected: number) {\n    const pass = received.status === expected;\n    return {\n      pass,\n      name: \"toHaveStatus\",\n      expected,\n      actual: received.status,\n      message: () =>\n        pass\n          ? `Expected status not to be ${expected}`\n          : `Expected ${received.method} ${received.url} to return ${expected}, got ${received.status}\\n` +\n            `Body: ${JSON.stringify(received.data, null, 2)}`,\n    };\n  },\n\n  /** Asserts a value matches a zod schema, listing the exact field-level issues on failure. */\n  toMatchSchema(received: unknown, schema: ZodType<unknown>) {\n    const result = schema.safeParse(received);\n    return {\n      pass: result.success,\n      name: \"toMatchSchema\",\n      message: () =>\n        result.success\n          ? \"Expected value not to match the schema\"\n          : `Value did not match the schema:\\n${result.error.issues\n              .map((issue) => `  - ${issue.path.join(\".\") || \"(root)\"}: ${issue.message}`)\n              .join(\"\\n\")}`,\n    };\n  },\n});\n"]}