@commonpub/test-utils

Shared test helpers and factories for the CommonPub test suite.

Overview

Test factories for creating realistic test data across all CommonPub packages. Factories generate properly typed objects with auto-incrementing unique IDs, consistent timestamps, and sensible defaults.

Installation

pnpm add -D @commonpub/test-utils

Usage

User Factory

import { createTestUser, resetFactoryCounter } from '@commonpub/test-utils';

const user = createTestUser();
// {
//   id: 'test-user-1',
//   email: '[email protected]',
//   username: 'testuser1',
//   displayName: 'Test User 1',
//   role: 'member',
//   status: 'active',
//   ...
// }

const admin = createTestUser({ role: 'admin', email: '[email protected]' });

// Reset counter between test suites
resetFactoryCounter();

Session Factory

import { createTestSession } from '@commonpub/test-utils';

const session = createTestSession({ userId: user.id });
// { id: 'test-session-1', userId: '...', token: '...', expiresAt: ... }

Federated Account Factory

import { createTestFederatedAccount } from '@commonpub/test-utils';

const fedAccount = createTestFederatedAccount({
  userId: user.id,
  instanceDomain: 'deveco.io',
});

OAuth Client Factory

import { createTestOAuthClient } from '@commonpub/test-utils';

const client = createTestOAuthClient({
  instanceDomain: 'hack.build',
});

Test Config

import { createTestConfig } from '@commonpub/test-utils';

const config = createTestConfig();
// Returns a valid CommonPubConfig with all features enabled

const minConfig = createTestConfig({
  features: { federation: false, admin: false },
});

Development

pnpm build        # Compile TypeScript
pnpm test         # Run 14 tests
pnpm typecheck    # Type-check without emitting

Dependencies

• @commonpub/schema: Type definitions
• @commonpub/config: Config types