@interfere/test-utils 1.0.0 → 9.0.0

package/package.json

@@ -1,26 +1,86 @@
 {
   "name": "@interfere/test-utils",
-  "version": "1.0.0",
+  "version": "9.0.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://github.com/interfere-inc/interfere.git",
+    "directory": "src/packages/public/test-utils"
+  },
+  "files": [
+    "dist"
+  ],
   "type": "module",
   "exports": {
-    "./*": "./src/*.ts"
+    "./lib/*": {
+      "@source": "./src/lib/*.ts",
+      "types": "./dist/lib/*.d.mts",
+      "default": "./dist/lib/*.mjs"
+    },
+    "./playwright/*": {
+      "@source": "./src/playwright/*.ts",
+      "types": "./dist/playwright/*.d.mts",
+      "default": "./dist/playwright/*.mjs"
+    },
+    "./vitest/*": {
+      "@source": "./src/vitest/*.ts",
+      "types": "./dist/vitest/*.d.mts",
+      "default": "./dist/vitest/*.mjs"
+    },
+    "./vitest/presets/*": {
+      "@source": "./src/vitest/presets/*.ts",
+      "types": "./dist/vitest/presets/*.d.mts",
+      "default": "./dist/vitest/presets/*.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
   },
   "scripts": {
+    "build": "tsdown",
     "typecheck": "tsc --noEmit --incremental"
   },
+  "peerDependencies": {
+    "@playwright/test": ">=1.59.0",
+    "@vitejs/plugin-react": ">=6.0.1",
+    "@vitest/browser-playwright": ">=4.1.4",
+    "msw": ">=2.13.4",
+    "vitest": ">=4.1.5"
+  },
+  "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.0",
+    "@interfere/typescript-config": "^9.0.0",
     "@playwright/test": "^1.59.0",
     "@types/node": "^24.12.0",
-    "@vitest/browser-playwright": "4.1.2",
-    "dotenv": "17.3.1",
-    "msw": "^2.12.14",
-    "typescript": "6.0.2",
-    "vitest": "^4.1.2"
+    "@vitejs/plugin-react": "^6.0.1",
+    "@vitest/browser-playwright": "4.1.5",
+    "msw": "^2.13.4",
+    "tsdown": "^0.21.10",
+    "typescript": "6.0.3",
+    "vitest": "^4.1.5"
   }
 }

package/.turbo/turbo-typecheck.log

@@ -1,2 +0,0 @@
-
-$ tsc --noEmit --incremental

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"]
-}