| name | paystack-testing-fixtures |
| description | Test @alexasomba/better-auth-paystack changes. Use for choosing focused vp test commands, Better Auth test clients, in-memory adapters, mocked Paystack SDK responses, webhook signatures, TanStack example tests, integration tests, type-safety tests, and verification before landing changes.
|
| type | core |
| library | @alexasomba/better-auth-paystack |
| library_version | 3.0.0 |
| license | MIT |
| compatibility | Node.js >=22.0.0; better-auth ^1.6.9; @alexasomba/paystack-node 1.10.x; @alexasomba/better-auth-paystack >=3.0.0 <4.0.0 |
| sources | ["alexasomba/better-auth-paystack:test/paystack.test.ts","alexasomba/better-auth-paystack:test/local_subscription.test.ts","alexasomba/better-auth-paystack:test/seat_billing.test.ts","alexasomba/better-auth-paystack:test/typesafety.test.ts","alexasomba/better-auth-paystack:examples/tanstack/src/__tests__"] |
Test Selection
Use vp test instead of invoking Vitest directly.
Focused suites:
- core plugin routes, schema, webhooks, products, org billing:
vp test test/paystack.test.ts
- local-managed subscriptions and authorization capture:
vp test test/local_subscription.test.ts
- seat billing, proration, local renewal UI paths:
vp test test/seat_billing.test.ts
- planCode and organization integration regressions:
vp test test/plancode-and-org.integration.test.ts
- package type contracts:
vp test test/typesafety.test.ts
- TanStack example components/routes:
pnpm --filter ./examples/tanstack test
Broad gates before landing:
vp check
vp test
Run integration tests only when needed and credentials/environment are available:
RUN_INTEGRATION_TESTS=1 vp test
Fixture Patterns
Mock Paystack SDK at the adapter boundary
Mocks should resemble @alexasomba/paystack-node grouped operations:
const paystackClient = {
transaction: {
initialize: vi.fn().mockResolvedValue({
data: { reference: "REF", authorization_url: "..." },
}),
verify: vi.fn().mockResolvedValue({ data: { status: "success", reference: "REF" } }),
chargeAuthorization: vi.fn(),
},
subscription: {
create: vi.fn(),
fetch: vi.fn(),
disable: vi.fn(),
enable: vi.fn(),
manageLink: vi.fn(),
},
};
The package supports SDK PaystackResponse objects and legacy/custom nested { data } test shapes.
Do not overfit tests to only one response wrapper unless the change is specifically about
unwrapSdkResult.
Sign webhooks like Paystack
Webhook tests should create the exact JSON payload string, sign it with HMAC SHA-512, and send the
signature in x-paystack-signature.
Use Better Auth client behavior realistically
For browser-style flows, sign up/sign in and pass cookies into the auth client. Use { throw: true }
when the test should fail immediately on Better Auth errors.
Common Mistakes
Only testing the root package after example changes
The TanStack example has its own component and route tests. Run its test/build command when touching
examples/tanstack.
Skipping type tests for client API changes
Any change to src/client.ts, route return shapes, or public exports should run
test/typesafety.test.ts.
Assuming live Paystack is available
Most tests should use mocked SDK operations. Keep live/integration tests opt-in.
