@interfere/test-utils 1.0.1 → 9.0.1-canary.0

package/dist/lib/tags.d.mts

@@ -0,0 +1,6 @@
+//#region src/lib/tags.d.ts
+declare const COMMON: "@common";
+declare const DESKTOP: "@desktop";
+declare const MOBILE: "@mobile";
+//#endregion
+export { COMMON, DESKTOP, MOBILE };

package/dist/lib/tags.mjs

@@ -0,0 +1 @@
+const COMMON=`@common`,DESKTOP=`@desktop`,MOBILE=`@mobile`;export{COMMON,DESKTOP,MOBILE};

package/dist/lib/viewports.d.mts

@@ -0,0 +1,14 @@
+import { TestUserConfig } from "vitest/config";
+
+//#region src/lib/viewports.d.ts
+type Viewport = NonNullable<TestUserConfig["browser"]>["viewport"];
+declare const DESKTOP: {
+  readonly width: 1280;
+  readonly height: 720;
+};
+declare const MOBILE: {
+  readonly width: 390;
+  readonly height: 844;
+};
+//#endregion
+export { DESKTOP, MOBILE, Viewport };

package/dist/lib/viewports.mjs

@@ -0,0 +1 @@
+const DESKTOP={width:1280,height:720},MOBILE={width:390,height:844};export{DESKTOP,MOBILE};

package/dist/playwright/base.d.mts

@@ -0,0 +1,48 @@
+//#region src/playwright/base.d.ts
+declare const _default: {
+  fullyParallel: true;
+  forbidOnly: boolean;
+  retries: number;
+  reporter: ["html"][] | (["github"] | ["junit", {
+    outputFile: string;
+  }])[];
+  use: {
+    trace: "on-first-retry";
+    screenshot: "only-on-failure";
+    actionTimeout?: number;
+    launchOptions?: {
+      executablePath: string;
+    };
+  };
+  expect?: {
+    timeout: number;
+  };
+  projects: ({
+    name: string;
+    grep: RegExp;
+    use: {
+      viewport: import("@playwright/test").ViewportSize;
+      userAgent: string;
+      deviceScaleFactor: number;
+      isMobile: boolean;
+      hasTouch: boolean;
+      defaultBrowserType: "chromium" | "firefox" | "webkit";
+    };
+  } | {
+    name: string;
+    grep: RegExp;
+    use: {
+      userAgent: string;
+      deviceScaleFactor: number;
+      defaultBrowserType: "chromium" | "firefox" | "webkit";
+      viewport: {
+        readonly width: 390;
+        readonly height: 844;
+      };
+      isMobile: true;
+      hasTouch: true;
+    };
+  })[];
+};
+//#endregion
+export { _default as default };

package/dist/playwright/base.mjs

@@ -0,0 +1 @@
+import{COMMON,DESKTOP,MOBILE}from"../lib/tags.mjs";import{MOBILE as MOBILE$1}from"../lib/viewports.mjs";import{devices}from"@playwright/test";const ci=!!process.env.CI,chromiumExecutablePath=process.env.CHROMIUM_EXECUTABLE_PATH;var base_default={fullyParallel:!0,forbidOnly:ci,retries:ci?2:0,reporter:ci?[[`github`],[`junit`,{outputFile:`./test-results/e2e-junit.xml`}]]:[[`html`]],use:{trace:`on-first-retry`,screenshot:`only-on-failure`,...ci&&{actionTimeout:1e4},...chromiumExecutablePath&&{launchOptions:{executablePath:chromiumExecutablePath}}},...ci&&{expect:{timeout:1e4}},projects:[{name:`desktop`,grep:RegExp(`${DESKTOP}|${COMMON}`),use:{...devices[`Desktop Chrome`]}},{name:`mobile`,grep:RegExp(`${MOBILE}|${COMMON}`),use:{...devices[`Desktop Chrome`],viewport:MOBILE$1,isMobile:!0,hasTouch:!0}}]};export{base_default as default};

package/dist/playwright/define-config.d.mts

@@ -0,0 +1,6 @@
+import { PlaywrightTestConfig } from "@playwright/test";
+
+//#region src/playwright/define-config.d.ts
+declare function defineConfig(...overrides: Array<Partial<PlaywrightTestConfig> | undefined>): PlaywrightTestConfig<{}, {}>;
+//#endregion
+export { defineConfig };

package/dist/playwright/define-config.mjs

@@ -0,0 +1 @@
+import base_default from"./base.mjs";import{defineConfig as defineConfig$1}from"@playwright/test";import{deepMerge}from"@interfere/helpers/deep-merge";function defineConfig(...overrides){return defineConfig$1(deepMerge(base_default,...overrides))}export{defineConfig};

package/dist/playwright/protection-bypass.d.mts

@@ -0,0 +1,5 @@
+//#region src/playwright/protection-bypass.d.ts
+type ProtectionProvider = "cloudflare-access";
+declare function protectionBypassHeaders(baseURL: string | undefined, provider: ProtectionProvider): Record<string, string> | undefined;
+//#endregion
+export { ProtectionProvider, protectionBypassHeaders };

package/dist/playwright/protection-bypass.mjs

@@ -0,0 +1 @@
+const LOCAL_HOSTNAMES=new Set([`localhost`,`127.0.0.1`,`0.0.0.0`,`[::1]`]);function isLocal(baseURL){try{return LOCAL_HOSTNAMES.has(new URL(baseURL).hostname)}catch{return!1}}function cloudflareAccessHeaders(baseURL){let clientId=process.env.CF_ACCESS_CLIENT_ID,clientSecret=process.env.CF_ACCESS_CLIENT_SECRET;if(!(clientId&&clientSecret))throw Error([`Missing CF_ACCESS_CLIENT_ID / CF_ACCESS_CLIENT_SECRET while BASE_URL points at a remote Cloudflare deployment.`,`BASE_URL=${baseURL}`,"Playwright cannot bypass Cloudflare Access without the `cf-iac-ci` service token.","Fetch both values from GSM: `cf-access-service-token-id` and `cf-access-service-token-secret`."].join(` `));return{"CF-Access-Client-Id":clientId,"CF-Access-Client-Secret":clientSecret}}function protectionBypassHeaders(baseURL,provider){if(!(!baseURL||isLocal(baseURL))){if(provider===`cloudflare-access`)return cloudflareAccessHeaders(baseURL);throw Error(`Unsupported protection provider: ${provider}`)}}export{protectionBypassHeaders};

package/dist/vitest/base.d.mts

@@ -0,0 +1,51 @@
+//#region src/vitest/base.d.ts
+declare const _default: {
+  root: string;
+  resolve: {
+    conditions: string[];
+  };
+  ssr: {
+    resolve: {
+      conditions: string[];
+    };
+  };
+  test: {
+    env: {
+      NODE_ENV: string;
+    };
+    environment: "node";
+    globals: true;
+    isolate: true;
+    pool: "forks";
+    maxWorkers: string;
+    clearMocks: true;
+    restoreMocks: true;
+    ui: boolean;
+    unstubEnvs: true;
+    unstubGlobals: true;
+    sequence: {
+      shuffle: boolean;
+    };
+    server: {
+      deps: {
+        inline: string[];
+      };
+    };
+    include: string[];
+    exclude: string[];
+    reporters: ("default" | "junit")[];
+    coverage: {
+      enabled: true;
+      provider: "v8";
+      include: string[];
+      exclude: string[];
+      reporter: ("json" | "json-summary" | "lcov")[] | ("clover" | "html" | "json" | "text")[];
+    };
+    setupFiles?: string[];
+    outputFile?: {
+      junit: string;
+    };
+  };
+};
+//#endregion
+export { _default as default };

package/dist/vitest/base.mjs

@@ -0,0 +1 @@
+import{omitUndefined}from"@interfere/helpers/omit-undefined";import{existsSync}from"node:fs";import{resolve}from"node:path";import{config}from"dotenv";import{configDefaults}from"vitest/config";const root=process.cwd(),isCI=!!process.env.CI,env=config({path:resolve(root,`.env.test`),quiet:!0}).parsed??{},setupFiles=[`./test/setup.ts`,`./test/unit/setup.ts`].filter(rel=>existsSync(resolve(root,rel)));var base_default={root,resolve:{conditions:[`monorepo`]},ssr:{resolve:{conditions:[`monorepo`]}},test:{env:{...env,NODE_ENV:`test`},environment:`node`,globals:!0,isolate:!0,pool:`forks`,maxWorkers:`50%`,clearMocks:!0,restoreMocks:!0,ui:!!process.env.UI,unstubEnvs:!0,unstubGlobals:!0,sequence:{shuffle:!isCI},server:{deps:{inline:[`zod`]}},include:[`src/**/*.{test,spec}.?(c|m)[jt]s?(x)`,`test/**/*.{test,spec}.?(c|m)[jt]s?(x)`],exclude:[`test/e2e/**/*.{test,spec}.?(c|m)[jt]s?(x)`,...configDefaults.exclude],reporters:isCI?[`default`,`junit`]:[`default`],coverage:{enabled:!0,provider:`v8`,include:[`src/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}`],exclude:[`**/*.json`,...configDefaults.coverage?.exclude??[]],reporter:isCI?[`json`,`json-summary`,`lcov`]:[`text`,`html`,`clover`,`json`]},...omitUndefined({setupFiles:setupFiles.length>0?setupFiles:void 0,outputFile:isCI?{junit:`./test-results/junit.xml`}:void 0})}};export{base_default as default};

package/dist/vitest/define-config.d.mts

@@ -0,0 +1,6 @@
+import { ViteUserConfig } from "vitest/config";
+
+//#region src/vitest/define-config.d.ts
+declare function defineConfig(...overrides: Array<Partial<ViteUserConfig> | undefined>): ViteUserConfig;
+//#endregion
+export { defineConfig };

package/dist/vitest/define-config.mjs

@@ -0,0 +1 @@
+import base_default from"./base.mjs";import{deepMerge}from"@interfere/helpers/deep-merge";import{defineConfig as defineConfig$1}from"vitest/config";function defineConfig(...overrides){return defineConfig$1(deepMerge(base_default,...overrides))}export{defineConfig};

package/dist/vitest/msw-browser.d.mts

@@ -0,0 +1,5 @@
+//#region src/vitest/msw-browser.d.ts
+declare const worker: import("msw/browser").SetupWorker;
+declare function enableMSW(): void;
+//#endregion
+export { enableMSW, worker };

package/dist/vitest/msw-browser.mjs

@@ -0,0 +1 @@
+import{setupWorker}from"msw/browser";import{afterAll,afterEach,beforeAll}from"vitest";const worker=setupWorker();function enableMSW(){beforeAll(async()=>{await worker.start({onUnhandledRequest:`bypass`,quiet:!0})}),afterEach(()=>{worker.resetHandlers()}),afterAll(()=>{worker.stop()})}export{enableMSW,worker};

package/dist/vitest/msw-http.d.mts

@@ -0,0 +1,15 @@
+//#region src/vitest/msw-http.d.ts
+type HttpMethod = "post" | "get" | "put" | "delete" | "patch";
+type JsonValue = string | number | boolean | null | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+interface CapturedHttpCall {
+  body: unknown;
+  params: Record<string, string | readonly string[] | undefined>;
+}
+declare function createHttpInterceptor(baseUrl: string): {
+  intercept: (method: HttpMethod, path: string, response: JsonValue, status?: number) => CapturedHttpCall[];
+  interceptNetworkError: (method: HttpMethod, path: string) => void;
+};
+//#endregion
+export { CapturedHttpCall, HttpMethod, JsonValue, createHttpInterceptor };

package/dist/vitest/msw-http.mjs

@@ -0,0 +1 @@
+import{worker}from"./msw-browser.mjs";import{HttpResponse,http}from"msw";async function parseBody(request){let clone=request.clone();if((clone.headers.get(`content-type`)??``).includes(`multipart/form-data`)){let formData=await clone.formData();return Object.fromEntries(formData.entries())}return clone.json().catch(()=>null)}function createHttpInterceptor(baseUrl){function intercept(method,path,response,status=200){let calls=[];return worker.use(http[method](`${baseUrl}${path}`,async({request,params})=>(calls.push({body:await parseBody(request),params}),HttpResponse.json(response,{status})))),calls}function interceptNetworkError(method,path){worker.use(http[method](`${baseUrl}${path}`,()=>HttpResponse.error()))}return{intercept,interceptNetworkError}}export{createHttpInterceptor};

package/dist/vitest/package-contract.d.mts

@@ -0,0 +1,21 @@
+//#region src/vitest/package-contract.d.ts
+declare const PACKAGE_CONTRACT_TIMEOUT_MS = 30000;
+interface PackageContractOptions {
+  packageJsonUrl: URL;
+}
+interface PackedPackageFilesOptions extends PackageContractOptions {
+  expectedFiles: string[];
+}
+interface NodePackageResolutionOptions extends PackageContractOptions {
+  specifiers: string[];
+}
+declare function expectPackedPackageFiles({
+  expectedFiles,
+  packageJsonUrl
+}: PackedPackageFilesOptions): Promise<void>;
+declare function expectNodeCanLoadPackageSpecifiers({
+  packageJsonUrl,
+  specifiers
+}: NodePackageResolutionOptions): Promise<void>;
+//#endregion
+export { PACKAGE_CONTRACT_TIMEOUT_MS, expectNodeCanLoadPackageSpecifiers, expectPackedPackageFiles };

package/dist/vitest/package-contract.mjs

@@ -0,0 +1,4 @@
+import{dirname,join}from"node:path";import{expect}from"vitest";import{execFile}from"node:child_process";import{mkdir,mkdtemp,readFile,rename,rm,symlink}from"node:fs/promises";import{tmpdir}from"node:os";import{fileURLToPath}from"node:url";import{promisify}from"node:util";const execFileAsync=promisify(execFile),PACKED_LINE=/^packed\s+\S+\s+(.+)$/,TGZ_LINE=/^(\S+\.tgz)$/,PACKAGE_CONTRACT_TIMEOUT_MS=3e4;async function expectPackedPackageFiles({expectedFiles,packageJsonUrl}){let packedPackage=await createPackedPackage(packageJsonUrl);try{expect(packedPackage.files).toEqual(expect.arrayContaining(expectedFiles)),expect(packedPackage.files.filter(path=>path.startsWith(`src/`))).toEqual([]),expect(packedPackage.files.filter(path=>path.endsWith(`.map`))).toEqual([]),expect(packedPackage.packageJson.private).toBeUndefined(),expect(Object.keys(packedPackage.packageJson.devDependencies??{})).not.toContain(`@interfere/tsdown-config`)}finally{await packedPackage.cleanup()}}async function expectNodeCanLoadPackageSpecifiers({packageJsonUrl,specifiers}){let packedPackage=await createPackedPackage(packageJsonUrl);try{await runNodeScript({args:[`--input-type=module`,`--eval`,importScript(specifiers)],cwd:packedPackage.consumerDir,label:`ESM import`}),await runNodeScript({args:[`--eval`,requireScript(specifiers)],cwd:packedPackage.consumerDir,label:`CommonJS require`})}finally{await packedPackage.cleanup()}}async function createPackedPackage(packageJsonUrl){let packageDir=dirname(fileURLToPath(packageJsonUrl)),tempDir=await mkdtemp(join(tmpdir(),`interfere-package-contract-`)),consumerDir=join(tempDir,`consumer`),nodeModulesDir=join(consumerDir,`node_modules`),packageJson=JSON.parse(await readFile(packageJsonUrl,`utf8`)),installedPackageDir=joinPackageName(nodeModulesDir,packageJson.name);await mkdir(dirname(installedPackageDir),{recursive:!0});let{stdout}=await execFileAsync(`bun`,[`pm`,`pack`,`--ignore-scripts`],{cwd:packageDir}),{filename,files}=parseBunPackOutput(stdout),tarballPath=join(packageDir,filename),extractedDir=join(tempDir,`extracted`);await mkdir(extractedDir),await execFileAsync(`tar`,[`-xzf`,tarballPath,`-C`,extractedDir]),await rm(tarballPath),await rename(join(extractedDir,`package`),installedPackageDir),await linkRuntimeDependencies({nodeModulesDir,packageDir,packageJson});let packedPackageJson=JSON.parse(await readFile(join(installedPackageDir,`package.json`),`utf8`));return{cleanup:()=>rm(tempDir,{force:!0,recursive:!0}),consumerDir,files:files.toSorted(),packageJson:packedPackageJson}}function parseBunPackOutput(stdout){let files=[],filename=``;for(let line of stdout.split(`
+`)){let packMatch=line.match(PACKED_LINE);if(packMatch?.[1]){files.push(packMatch[1]);continue}let tgzMatch=line.match(TGZ_LINE);tgzMatch?.[1]&&(filename=tgzMatch[1])}if(!filename)throw Error(`bun pm pack did not produce a tarball:\n${stdout}`);return{filename,files}}async function linkRuntimeDependencies({nodeModulesDir,packageDir,packageJson}){let dependencies=new Set([...Object.keys(packageJson.dependencies??{}),...Object.keys(packageJson.peerDependencies??{})]);for(let dependencyName of Array.from(dependencies)){if(dependencyName===packageJson.name)continue;let source=joinPackageName(join(packageDir,`node_modules`),dependencyName),target=joinPackageName(nodeModulesDir,dependencyName);await mkdir(dirname(target),{recursive:!0}),await symlink(source,target,`junction`)}}function joinPackageName(nodeModulesDir,packageName){return join(nodeModulesDir,...packageName.split(`/`))}async function runNodeScript({args,cwd,label}){try{await execFileAsync(process.execPath,args,{cwd})}catch(error){throw error instanceof Error?Error(`${label} package contract failed:\n${error.message}`):error}}function importScript(specifiers){return specifiers.map(specifier=>`await import(${JSON.stringify(specifier)});`).join(`
+`)}function requireScript(specifiers){return specifiers.map(specifier=>`require(${JSON.stringify(specifier)});`).join(`
+`)}export{PACKAGE_CONTRACT_TIMEOUT_MS,expectNodeCanLoadPackageSpecifiers,expectPackedPackageFiles};

package/dist/vitest/presets/browser.d.mts

@@ -0,0 +1,29 @@
+import { TestUserConfig, UserWorkspaceConfig } from "vitest/config";
+
+//#region src/vitest/presets/browser.d.ts
+type BrowserConfig = NonNullable<TestUserConfig["browser"]>;
+type BrowserInstance = NonNullable<BrowserConfig["instances"]>[number];
+interface BrowserProjectOptions {
+  /**
+   * Playwright browser instances to run against. Use `dualViewport()` for the
+   * standard Desktop + Mobile split keyed on the `src/**​/mobile/**` glob
+   * convention.
+   */
+  instances: BrowserInstance[];
+  testAlias?: string | false;
+  trace?: boolean;
+  [key: string]: unknown;
+}
+/**
+ * Glob matching all tests under a `mobile/` directory. Used by `dualViewport`
+ * to split the Desktop / Mobile test runs from a single file tree.
+ */
+declare const MOBILE_TESTS = "src/**/mobile/*.{test,spec}.?(c|m)[jt]s?(x)";
+/**
+ * Standard Desktop + Mobile viewport split for UI apps. Desktop runs every
+ * test except those under `src/**​/mobile/**`; Mobile runs only those.
+ */
+declare function dualViewport(): BrowserInstance[];
+declare function browserProject(opts: BrowserProjectOptions): UserWorkspaceConfig;
+//#endregion
+export { BrowserInstance, BrowserProjectOptions, MOBILE_TESTS, browserProject, dualViewport };

package/dist/vitest/presets/browser.mjs

@@ -0,0 +1 @@
+import{DESKTOP,MOBILE}from"../../lib/viewports.mjs";import base_default from"../base.mjs";import{deepMerge}from"@interfere/helpers/deep-merge";import{resolve}from"node:path";import react from"@vitejs/plugin-react";import{playwright}from"@vitest/browser-playwright";const INSTANCE_BASELINE_EXCLUDE=[`test/e2e/**/*.{test,spec}.?(c|m)[jt]s?(x)`],chromiumExecutablePath=process.env.CHROMIUM_EXECUTABLE_PATH,MOBILE_TESTS=`src/**/mobile/*.{test,spec}.?(c|m)[jt]s?(x)`;function dualViewport(){return[{browser:`chromium`,name:`Chrome - Desktop`,viewport:DESKTOP,exclude:[...INSTANCE_BASELINE_EXCLUDE,MOBILE_TESTS]},{browser:`chromium`,name:`Chrome - Mobile`,viewport:MOBILE,exclude:INSTANCE_BASELINE_EXCLUDE,include:[MOBILE_TESTS]}]}function browserProject(opts){let{instances,trace,testAlias=`test/unit`,...rest}=opts;return deepMerge(base_default,{server:{port:0,strictPort:!1},test:{name:`browser`,browser:{enabled:!0,provider:chromiumExecutablePath?playwright({launchOptions:{executablePath:chromiumExecutablePath}}):playwright(),screenshotFailures:!1,instances,...trace&&{trace:{mode:`retain-on-failure`}}}},plugins:[react()],optimizeDeps:{entries:[`src/**/*.{ts,tsx}`,`test/unit/**/*.{ts,tsx}`],exclude:[`fsevents`,`@opentelemetry/otlp-transformer`]},...testAlias!==!1&&{resolve:{tsconfigPaths:!0,alias:{"@test":resolve(process.cwd(),testAlias)}}}},rest)}export{MOBILE_TESTS,browserProject,dualViewport};

package/dist/vitest/presets/integration.d.mts

@@ -0,0 +1,36 @@
+import { ViteUserConfig } from "vitest/config";
+
+//#region src/vitest/presets/integration.d.ts
+/**
+ * Integration test resources. Each entry maps to a globalSetup module in
+ * `@interfere/internal-test-utils` that owns a single shared container for
+ * the duration of the run and tears it down on success, failure, and most
+ * signal scenarios.
+ *
+ * The matching per-worker harness lives at
+ * `@interfere/internal-test-utils/lifecycle/<resource>/harness` — import it
+ * from your `test/setup.ts`.
+ */
+type IntegrationResource = "pg" | "redis";
+interface IntegrationOptions {
+  /**
+   * Container resources to provision once per run. Defaults to `["pg"]`.
+   */
+  resources?: IntegrationResource[];
+}
+/**
+ * Build a Vitest config for an integration-test package. Wires up the
+ * shared-container globalSetup modules so each test run spins up exactly
+ * one of each requested resource (instead of one per worker fork) and tears
+ * them down reliably on exit.
+ *
+ * @example
+ * ```ts
+ * export default defineIntegrationConfig({ resources: ["pg", "redis"] }, {
+ *   test: { coverage: { provider: "v8" } },
+ * });
+ * ```
+ */
+declare function defineIntegrationConfig(options?: IntegrationOptions, ...overrides: Array<Partial<ViteUserConfig> | undefined>): ViteUserConfig;
+//#endregion
+export { IntegrationOptions, IntegrationResource, defineIntegrationConfig };

package/dist/vitest/presets/integration.mjs

@@ -0,0 +1 @@
+import base_default from"../base.mjs";import{deepMerge}from"@interfere/helpers/deep-merge";import{defineConfig}from"vitest/config";const GLOBAL_SETUP_BY_RESOURCE={pg:`@interfere/internal-test-utils/lifecycle/pg/global-setup`,redis:`@interfere/internal-test-utils/lifecycle/redis/global-setup`};function defineIntegrationConfig(options={},...overrides){let resources=options.resources??[`pg`],globalSetup=resources.map(r=>GLOBAL_SETUP_BY_RESOURCE[r]),redisOverrides=resources.includes(`redis`)?{test:{fileParallelism:!1}}:{};return defineConfig(deepMerge(base_default,{test:{globalSetup}},redisOverrides,...overrides))}export{defineIntegrationConfig};

package/dist/vitest/presets/node.d.mts

@@ -0,0 +1,15 @@
+import { UserWorkspaceConfig } from "vitest/config";
+
+//#region src/vitest/presets/node.d.ts
+/**
+ * Build a Vitest project config running against the Node environment.
+ * Spreads `opts` over a shared base; caller-provided fields win.
+ *
+ * `*.test.{tsx,jsx}` files are excluded by default — React test files can't
+ * import `vitest-browser-react` outside of Browser Mode, so they always
+ * belong in the `browserProject`. Opt a specific TSX test in by adding its
+ * path to the caller's `test.include`.
+ */
+declare function nodeProject(opts?: Partial<UserWorkspaceConfig>): UserWorkspaceConfig;
+//#endregion
+export { nodeProject };

package/dist/vitest/presets/node.mjs

@@ -0,0 +1 @@
+import base_default from"../base.mjs";import{deepMerge}from"@interfere/helpers/deep-merge";function nodeProject(opts={}){return deepMerge(base_default,{test:{name:`node`,environment:`node`,exclude:[`**/*.{test,spec}.tsx`,`**/*.{test,spec}.jsx`,`**/*.{test,spec}.mtsx`,`**/*.{test,spec}.mjsx`]}},opts)}export{nodeProject};

package/dist/vitest/presets/vite.d.mts

@@ -0,0 +1,15 @@
+import { TestUserConfig, UserWorkspaceConfig } from "vitest/config";
+
+//#region src/vitest/presets/vite.d.ts
+type BrowserConfig = NonNullable<TestUserConfig["browser"]>;
+type BrowserInstance = NonNullable<BrowserConfig["instances"]>[number];
+interface BrowserProjectOptions {
+  instances: BrowserInstance[];
+  testAlias?: string | false;
+  trace?: boolean;
+  [key: string]: unknown;
+}
+declare function dualViewport(): BrowserInstance[];
+declare function viteProject(opts: BrowserProjectOptions): UserWorkspaceConfig;
+//#endregion
+export { BrowserInstance, BrowserProjectOptions, dualViewport, viteProject };

package/dist/vitest/presets/vite.mjs

@@ -0,0 +1 @@
+import{DESKTOP,MOBILE}from"../../lib/viewports.mjs";import base_default from"../base.mjs";import{deepMerge}from"@interfere/helpers/deep-merge";import{playwright}from"@vitest/browser-playwright";const INSTANCE_BASELINE_EXCLUDE=[`test/e2e/**/*.{test,spec}.?(c|m)[jt]s?(x)`],chromiumExecutablePath=process.env.CHROMIUM_EXECUTABLE_PATH;function dualViewport(){return[{browser:`chromium`,name:`Chrome - Desktop`,viewport:DESKTOP,exclude:INSTANCE_BASELINE_EXCLUDE},{browser:`chromium`,name:`Chrome - Mobile`,viewport:MOBILE,exclude:INSTANCE_BASELINE_EXCLUDE}]}function viteProject(opts){let{instances,trace,testAlias=`test/unit`,...rest}=opts;return deepMerge({server:{port:0,strictPort:!1}},base_default,{test:{name:`vite`,browser:{enabled:!0,provider:chromiumExecutablePath?playwright({launchOptions:{executablePath:chromiumExecutablePath}}):playwright(),screenshotFailures:!1,instances,...trace&&{trace:{mode:`retain-on-failure`}}}}},rest)}export{dualViewport,viteProject};

package/package.json

@@ -1,26 +1,86 @@
 {
   "name": "@interfere/test-utils",
-  "version": "1.0.1",
+  "version": "9.0.1-canary.0",
   "license": "MIT",
-  "publishConfig": {
-    "access": "public"
-  },
   "description": "Shared test utilities used across Interfere packages.",
+  "homepage": "https://interfere.com",
+  "bugs": {
+    "url": "mailto:support@interfere.com"
+  },
+  "author": "Interfere <support@interfere.com> (https://interfere.com)",
+  "repository": {
+    "type": "git",
+    "url": "git+https://interfere.ghe.com/interfere/interfere.git",
+    "directory": "src/packages/public/test-utils"
+  },
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "exports": {
-    "./*": "./src/*.ts"
+    "./lib/*": {
+      "monorepo": "./src/lib/*.ts",
+      "types": "./dist/lib/*.d.mts",
+      "default": "./dist/lib/*.mjs"
+    },
+    "./playwright/*": {
+      "monorepo": "./src/playwright/*.ts",
+      "types": "./dist/playwright/*.d.mts",
+      "default": "./dist/playwright/*.mjs"
+    },
+    "./vitest/*": {
+      "monorepo": "./src/vitest/*.ts",
+      "types": "./dist/vitest/*.d.mts",
+      "default": "./dist/vitest/*.mjs"
+    },
+    "./vitest/presets/*": {
+      "monorepo": "./src/vitest/presets/*.ts",
+      "types": "./dist/vitest/presets/*.d.mts",
+      "default": "./dist/vitest/presets/*.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
-    "typecheck": "tsc --noEmit --incremental"
+    "build": "tsdown",
+    "typecheck": "tsgo --noEmit"
+  },
+  "peerDependencies": {
+    "@playwright/test": "^1.61.1",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/browser-playwright": "4.1.9",
+    "msw": "^2.14.6",
+    "vitest": "4.1.9"
+  },
+  "peerDependenciesMeta": {
+    "@playwright/test": {
+      "optional": true
+    },
+    "@vitejs/plugin-react": {
+      "optional": true
+    },
+    "@vitest/browser-playwright": {
+      "optional": true
+    },
+    "msw": {
+      "optional": true
+    }
+  },
+  "dependencies": {
+    "@interfere/helpers": "^9.0.0",
+    "dotenv": "^17.4.2"
   },
   "devDependencies": {
-    "@interfere/typescript-config": "^8.1.1",
-    "@playwright/test": "^1.59.0",
-    "@types/node": "^24.12.0",
-    "@vitest/browser-playwright": "4.1.4",
-    "dotenv": "^17.4.1",
-    "msw": "^2.13.1",
-    "typescript": "6.0.2",
-    "vitest": "^4.1.4"
+    "@interfere/typescript-config": "^9.0.0",
+    "@playwright/test": "^1.61.1",
+    "@types/node": "^26.0.0",
+    "@typescript/native-preview": "7.0.0-dev.20260623.1",
+    "@vitejs/plugin-react": "^6.0.3",
+    "@vitest/browser-playwright": "4.1.9",
+    "msw": "^2.14.6",
+    "tsdown": "^0.22.2",
+    "vitest": "4.1.9"
   }
 }

package/CHANGELOG.md

@@ -1,7 +0,0 @@
-# @interfere/test-utils
-
-## 1.0.1
-
-### Patch Changes
-
-- [`669f5e4`](https://github.com/interfere-inc/interfere/commit/669f5e40c24cf47b4335b8e51df09efe40112d29) Thanks [@skve](https://github.com/skve)! - Added telemetry for per-sdk breakdowns

package/src/lib/deep-merge.ts

@@ -1,71 +0,0 @@
-function isPlainObject(value: unknown): value is Record<string, unknown> {
-  return (
-    typeof value === "object" &&
-    value !== null &&
-    !Array.isArray(value) &&
-    Object.getPrototypeOf(value) === Object.prototype
-  );
-}
-
-function cloneValue<T>(value: T): T {
-  if (Array.isArray(value)) {
-    return value.map((item) => cloneValue(item)) as T;
-  }
-
-  if (isPlainObject(value)) {
-    const out: Record<string, unknown> = {};
-    for (const [key, nested] of Object.entries(value)) {
-      out[key] = cloneValue(nested);
-    }
-    return out as T;
-  }
-
-  return value;
-}
-
-function mergeValues(base: unknown, override: unknown): unknown {
-  if (typeof override === "undefined") {
-    return cloneValue(base);
-  }
-
-  if (Array.isArray(base) || Array.isArray(override)) {
-    const baseArr = Array.isArray(base) ? base : [];
-    const overrideArr = Array.isArray(override) ? override : [];
-    return [...baseArr, ...overrideArr].map((item) => cloneValue(item));
-  }
-
-  if (isPlainObject(base) && isPlainObject(override)) {
-    const out: Record<string, unknown> = {};
-    const keys = new Set(Object.keys(base)).union(
-      new Set(Object.keys(override))
-    );
-    for (const key of keys) {
-      out[key] = mergeValues(base[key], override[key]);
-    }
-    return out;
-  }
-
-  return cloneValue(override);
-}
-
-/**
- * Deep-merge any number of config objects.
- * - Plain objects merge recursively.
- * - Arrays are concatenated (base first, then overrides).
- * - Primitives take the rightmost value.
- */
-export function deepMerge<T extends object>(
-  base: T,
-  ...overrides: Array<Record<string, unknown> | undefined>
-): T {
-  let result = cloneValue(base);
-
-  for (const override of overrides) {
-    if (override === undefined) {
-      continue;
-    }
-    result = mergeValues(result, override) as T;
-  }
-
-  return result;
-}

package/src/lib/tags.ts

@@ -1,3 +0,0 @@
-export const COMMON = "@common" as const;
-export const DESKTOP = "@desktop" as const;
-export const MOBILE = "@mobile" as const;

package/src/lib/viewports.ts

@@ -1,6 +0,0 @@
-import type { TestUserConfig } from "vitest/config";
-
-export type Viewport = NonNullable<TestUserConfig["browser"]>["viewport"];
-
-export const DESKTOP = { width: 1280, height: 720 } as const satisfies Viewport;
-export const MOBILE = { width: 390, height: 844 } as const satisfies Viewport;

package/src/playwright/base.ts

@@ -1,44 +0,0 @@
-import { devices, type PlaywrightTestConfig } from "@playwright/test";
-
-import { COMMON, DESKTOP, MOBILE as MOBILE_TAG } from "../lib/tags";
-import { MOBILE } from "../lib/viewports";
-
-const ci = !!process.env["CI"];
-
-export default {
-  fullyParallel: true,
-  forbidOnly: ci,
-  reporter: ci
-    ? [["github"], ["junit", { outputFile: "./test-results/e2e-junit.xml" }]]
-    : [["html"]],
-
-  use: {
-    trace: "on-first-retry",
-    screenshot: "only-on-failure",
-    ...(ci && {
-      actionTimeout: 10_000,
-    }),
-  },
-
-  ...(ci && {
-    expect: { timeout: 10_000 },
-  }),
-
-  projects: [
-    {
-      name: "desktop",
-      grep: new RegExp(`${DESKTOP}|${COMMON}`),
-      use: { ...devices["Desktop Chrome"] },
-    },
-    {
-      name: "mobile",
-      grep: new RegExp(`${MOBILE_TAG}|${COMMON}`),
-      use: {
-        ...devices["Desktop Chrome"],
-        viewport: MOBILE,
-        isMobile: true,
-        hasTouch: true,
-      },
-    },
-  ],
-} satisfies PlaywrightTestConfig;

package/src/playwright/define-config.ts

@@ -1,13 +0,0 @@
-import {
-  type PlaywrightTestConfig,
-  defineConfig as pwDefineConfig,
-} from "@playwright/test";
-
-import { deepMerge } from "../lib/deep-merge";
-import base from "./base";
-
-export function defineConfig(
-  ...overrides: Array<Partial<PlaywrightTestConfig> | undefined>
-) {
-  return pwDefineConfig(deepMerge(base, ...overrides));
-}

package/src/vitest/base.ts

@@ -1,50 +0,0 @@
-import { resolve } from "node:path";
-import { config } from "dotenv";
-import { configDefaults, type ViteUserConfig } from "vitest/config";
-
-const env =
-  config({ path: resolve(process.cwd(), ".env.test"), quiet: true }).parsed ??
-  {};
-
-export default {
-  root: process.cwd(),
-  resolve: {
-    conditions: ["@source"],
-  },
-  ssr: {
-    resolve: {
-      conditions: ["@source"],
-    },
-  },
-  test: {
-    env: {
-      ...env,
-      NODE_ENV: "test",
-    },
-    environment: "node",
-    globals: true,
-    isolate: true,
-    pool: "forks",
-    maxWorkers: "50%",
-    clearMocks: true,
-    restoreMocks: true,
-    unstubEnvs: true,
-    unstubGlobals: true,
-    sequence: {
-      shuffle: true,
-    },
-    include: [
-      "src/**/*.{test,spec}.?(c|m)[jt]s?(x)",
-      "test/**/*.{test,spec}.?(c|m)[jt]s?(x)",
-    ],
-    exclude: [...configDefaults.exclude],
-    reporters: process.env["CI"] ? ["default", "junit"] : ["default"],
-    ...(process.env["CI"] && {
-      outputFile: { junit: "./test-results/junit.xml" },
-    }),
-    coverage: {
-      include: ["src/**/*.{ts,tsx,js,jsx,mts,cts,mjs,cjs}"],
-      exclude: [...(configDefaults.coverage?.exclude ?? [])],
-    },
-  },
-} satisfies ViteUserConfig;

package/src/vitest/define-config.ts

@@ -1,13 +0,0 @@
-import {
-  type ViteUserConfig,
-  defineConfig as vitestDefineConfig,
-} from "vitest/config";
-
-import { deepMerge } from "../lib/deep-merge.ts";
-import base from "./base.ts";
-
-export function defineConfig(
-  ...overrides: Array<Partial<ViteUserConfig> | undefined>
-) {
-  return vitestDefineConfig(deepMerge(base, ...overrides));
-}

package/src/vitest/msw-browser.ts

@@ -1,18 +0,0 @@
-import { setupWorker } from "msw/browser";
-import { afterAll, afterEach, beforeAll } from "vitest";
-
-export const worker = setupWorker();
-
-export function enableMSW(): void {
-  beforeAll(async () => {
-    await worker.start({ onUnhandledRequest: "bypass", quiet: true });
-  });
-
-  afterEach(() => {
-    worker.resetHandlers();
-  });
-
-  afterAll(() => {
-    worker.stop();
-  });
-}

package/src/vitest/msw-http.ts

@@ -1,60 +0,0 @@
-import { HttpResponse, http } from "msw";
-
-import { worker } from "./msw-browser.js";
-
-export type HttpMethod = "post" | "get" | "put" | "delete" | "patch";
-export type JsonValue =
-  | string
-  | number
-  | boolean
-  | null
-  | JsonValue[]
-  | { [key: string]: JsonValue };
-
-export interface CapturedHttpCall {
-  body: unknown;
-  params: Record<string, string | readonly string[] | undefined>;
-}
-
-async function parseBody(request: Request): Promise<unknown> {
-  const clone = request.clone();
-  const contentType = clone.headers.get("content-type") ?? "";
-  if (contentType.includes("multipart/form-data")) {
-    const formData = await clone.formData();
-    return Object.fromEntries(formData.entries());
-  }
-  return clone.json().catch(() => null);
-}
-
-export function createHttpInterceptor(baseUrl: string) {
-  function intercept(
-    method: HttpMethod,
-    path: string,
-    response: JsonValue,
-    status = 200
-  ): CapturedHttpCall[] {
-    const calls: CapturedHttpCall[] = [];
-
-    worker.use(
-      http[method](`${baseUrl}${path}`, async ({ request, params }) => {
-        calls.push({
-          body: await parseBody(request),
-          params,
-        });
-
-        return HttpResponse.json(response, { status });
-      })
-    );
-
-    return calls;
-  }
-
-  function interceptNetworkError(method: HttpMethod, path: string): void {
-    worker.use(http[method](`${baseUrl}${path}`, () => HttpResponse.error()));
-  }
-
-  return {
-    intercept,
-    interceptNetworkError,
-  };
-}

package/src/vitest/presets/browser.ts

@@ -1,55 +0,0 @@
-import { playwright } from "@vitest/browser-playwright";
-import type { TestUserConfig, ViteUserConfig } from "vitest/config";
-
-import { deepMerge } from "../../lib/deep-merge.ts";
-import base from "../base.ts";
-
-type BrowserInstance = NonNullable<
-  NonNullable<TestUserConfig["browser"]>["instances"]
->[number];
-type InlineProjectConfig = NonNullable<TestUserConfig["projects"]>[number];
-
-export function browserProject(opts: {
-  instances: BrowserInstance[];
-  name?: string;
-  setupFiles?: string[];
-  plugins?: ViteUserConfig["plugins"];
-  include?: string[];
-  exclude?: string[];
-  trace?: boolean;
-  optimizeDeps?: ViteUserConfig["optimizeDeps"];
-  define?: ViteUserConfig["define"];
-  resolve?: ViteUserConfig["resolve"];
-}): InlineProjectConfig {
-  return deepMerge(
-    {
-      ...(opts.plugins && { plugins: opts.plugins }),
-      ...(opts.define && { define: opts.define }),
-      ...(opts.resolve && { resolve: opts.resolve }),
-      ...(opts.optimizeDeps && { optimizeDeps: opts.optimizeDeps }),
-      server: { port: 0, strictPort: false },
-    },
-    {
-      test: {
-        ...base.test,
-        name: opts.name ?? "browser",
-        ...(opts.setupFiles && { setupFiles: opts.setupFiles }),
-        ...(opts.include && { include: opts.include }),
-        ...(opts.exclude && { exclude: opts.exclude }),
-        browser: {
-          enabled: true,
-          provider: playwright(),
-          screenshotFailures: false,
-          instances: opts.instances,
-          ...(opts.trace && {
-            trace: {
-              mode: "retain-on-failure" as const,
-            },
-          }),
-        },
-      },
-    }
-  ) as InlineProjectConfig;
-}
-
-export type { BrowserInstance };

package/src/vitest/presets/node.ts

@@ -1,23 +0,0 @@
-import type { TestUserConfig } from "vitest/config";
-
-import base from "../base.ts";
-
-type InlineProjectConfig = NonNullable<TestUserConfig["projects"]>[number];
-
-export function nodeProject(opts?: {
-  name?: string;
-  include?: string[];
-  exclude?: string[];
-  setupFiles?: string[];
-}): InlineProjectConfig {
-  return {
-    test: {
-      ...base.test,
-      name: opts?.name ?? "node",
-      environment: "node",
-      ...(opts?.include && { include: opts.include }),
-      ...(opts?.exclude && { exclude: opts.exclude }),
-      ...(opts?.setupFiles && { setupFiles: opts.setupFiles }),
-    },
-  };
-}

package/tsconfig.json

@@ -1,10 +0,0 @@
-{
-  "extends": "@interfere/typescript-config/base.json",
-  "compilerOptions": {
-    "allowImportingTsExtensions": true,
-    "outDir": "./dist",
-    "rootDir": "./src",
-    "types": ["node"]
-  },
-  "include": ["src"]
-}