test: add shared test utilities package

[denolfe]

Overview

Introduces @tools/test-utils, a shared test utilities package under tools/test-utils/ that consolidates test helpers for reuse across the core repo and external repos via git submodule + pnpm workspace:* protocol.

Key Changes

• New package @tools/test-utils at tools/test-utils/

  • Exports TypeScript source directly (no build step)
  • Multiple entry points: /int, /e2e, /shared, /database, /setup/vitest, /setup/playwright

• Migrated test utilities from test/helpers/

  • Integration test helpers (SDK, REST client, seed utilities)
  • E2E/Playwright helpers (navigation, assertions, accessibility)
  • Database adapter generation (MongoDB, Postgres, SQLite, etc.)
  • Shared credentials and test email adapter

• Backwards-compatible re-exports

  • Original test/helpers/ files now re-export from @tools/test-utils
  • Existing test imports continue to work unchanged

Design Decisions

Source exports over build: The package exports .ts files directly rather than compiled output. This simplifies the workflow since test utilities don't need publishing - consumers use workspace:* protocol which resolves to source.

Peer dependencies for flexibility: Database adapters, Playwright, Vitest, etc. are peer dependencies. This allows the package to work with whatever versions the consuming repo uses.

Informational typecheck: TypeScript typecheck filters to only show src/ errors (ignoring workspace package noise) and uses strict: false since this is test utility code. IDE provides real-time feedback; tests catch runtime issues.

Overall Flow

flowchart TD
    A["test/helpers/"] -->|re-exports| B["tools/test-utils"]
    C["test/*.spec.ts"] -->|imports| A
    D["External Repos"] -->|git submodule| B
    E["External repo tests"] -->|imports| B
    
    subgraph pkg ["tools/test-utils package"]
        B1["/int"]
        B2["/e2e"]
        B3["/shared"]
        B4["/database"]
    end
    
    B --> B1
    B --> B2
    B --> B3
    B --> B4

Loading

[denolfe]

Diverged too far from main to resolve conflicts cleanly, will create new branch.