@mantleframework/testing

Test utilities, mocks, and fixture helpers for Mantle applications.

Fixture Utilities

Load and generate JSON test fixtures.

import { loadFixture, loadFixtures, generateFixture, generateFixtureFromLog } from '@mantleframework/testing/fixtures';

loadFixture(name, options?)

Load a single JSON fixture by name.

const user = loadFixture<User>('user');
// Loads from test/fixtures/user.json by default

loadFixtures(options?)

Load all JSON fixtures from a directory.

const fixtures = loadFixtures<Record<string, unknown>>();
fixtures.get('user'); // { id: '1', name: 'Alice' }
fixtures.get('order'); // { id: '2', total: 100 }

generateFixture(name, data, options?)

Write a fixture file and return the path.

const path = generateFixture('api-response', responseData);

generateFixtureFromLog(name, logLine, options?)

Extract event data from a structured log line and save as a fixture.

generateFixtureFromLog('webhook-event', structuredLogLine);

Entity Mocks

Generate realistic mock data for database entities.

import { createMockUser, createMockSession, createMockEntity } from '@mantleframework/testing/entity-mocks';

createMockUser(overrides?)

Generate a mock user with realistic defaults.

const user = createMockUser({ name: 'Alice' });
// { id: 'uuid', email: 'alice@example.com', name: 'Alice', ... }

createMockSession(overrides?)

Generate a mock auth session.

createMockEntity(schema, overrides?)

Generate a mock entity from a Drizzle schema definition.

AWS SDK Mocks

Pre-configured mock helpers for AWS SDK client testing.

import { createMockS3, createMockSQS, createMockLambda } from '@mantleframework/testing/aws-mocks';

createMockS3()

Create a mock S3 client with common operations pre-configured.

const { client, mock } = createMockS3();

// Configure specific responses
mock.on(GetObjectCommand).resolves({
  Body: createReadStream('test-data'),
});

createMockSQS()

Create a mock SQS client.

createMockLambda()

Create a mock Lambda client.

createMockEventBridge()

Create a mock EventBridge client.

createMockSNS()

Create a mock SNS client.

createMockDynamoDB()

Create a mock DynamoDB client.