@byronwade/test-utils

Part of Fakebase — a Supabase-shaped, local/dev-only development platform for Next.js prototypes. Not for production use.

The contract-test harness for Fakebase adapters and Supabase-compatibility checks. Ships shared schema/seed fixtures, a reusable adapter contract suite, and a compat runner that diffs Fakebase behavior against a Supabase-like client.

Installation

pnpm add -D @byronwade/test-utils

Requires vitest (peer dependency).

Usage

import { defineAdapterContractSuite } from "@byronwade/test-utils";
import { MemoryAdapter } from "@byronwade/adapter-memory";

defineAdapterContractSuite("memory", async () => new MemoryAdapter());

What's inside

• defineAdapterContractSuite(name, createAdapter, teardown?) — drops a full adapter contract suite into your Vitest run.
• runCompatSuite(scenarios, fakebaseClient, supabaseClient?) + DEFAULT_COMPAT_SCENARIOS.
• Fixtures: TEST_SCHEMA, TEST_SEEDS.
• Subpath entry points: @byronwade/test-utils/compat and @byronwade/test-utils/fixtures.

Documentation

• Project README
• Architecture
• Compatibility matrix

License

MIT