@backend-master/test-utils 1.0.0

package/README.md

@@ -0,0 +1,250 @@
+# @backend-master/test-utils
+
+A comprehensive testing utilities library for Node.js backend projects. Provides mocks, fixtures, spies, and assertion helpers to make testing easier and faster.
+
+## Installation
+
+```bash
+npm install @backend-master/test-utils
+```
+
+## Features
+
+- **Mock Database**: In-memory database for testing without external dependencies
+- **HTTP Helpers**: Build and assert HTTP responses easily
+- **Fixtures**: Generate realistic test data with customizable builders
+- **Spies & Mocks**: Track function calls and create mock objects
+- **TypeScript Support**: Full type safety and IDE autocomplete
+
+## Quick Start
+
+### Mock Database
+
+```typescript
+import { MockDatabase } from '@backend-master/test-utils';
+
+const db = new MockDatabase();
+db.createTable('users');
+
+const user = db.insert('users', { 
+  name: 'Alice', 
+  email: 'alice@example.com' 
+});
+
+const found = db.findOne('users', { email: 'alice@example.com' });
+expect(found).toEqual(user);
+```
+
+### HTTP Test Helpers
+
+```typescript
+import { HttpTestBuilder, HttpResponseAssertion } from '@backend-master/test-utils';
+
+// Create responses
+const response = HttpTestBuilder.ok({ userId: 1, name: 'Alice' });
+
+// Assert responses
+HttpResponseAssertion.assertStatus(response, 200);
+HttpResponseAssertion.assertBodyHasKey(response, 'userId');
+HttpResponseAssertion.assertSuccess(response);
+```
+
+### Test Fixtures
+
+```typescript
+import { Fixtures, FixtureBuilder } from '@backend-master/test-utils';
+
+// Quick fixtures
+const user = Fixtures.user({ role: 'admin' });
+const products = Fixtures.products(10);
+
+// Custom builder
+const builder = new FixtureBuilder({ name: 'Test', active: true });
+const items = builder
+  .set('name', 'Updated Name')
+  .merge({ active: false })
+  .buildMany(5);
+```
+
+### Spies & Mocks
+
+```typescript
+import { Spy, MockObject, Defer } from '@backend-master/test-utils';
+
+// Create a spy
+const spy = Spy.create().returnValue('result');
+spy(); // Call it
+expect(spy.wasCalled()).toBe(true);
+expect(spy.getCallCount()).toBe(1);
+
+// Mock an object
+const mockService = MockObject.create({
+  fetch: async () => ({ data: 'test' })
+});
+
+mockService.fetch();
+expect(mockService.fetch.wasCalled()).toBe(true);
+
+// Defer for async testing
+const defer = new Defer();
+defer.resolve('value');
+await expect(defer.promise).resolves.toBe('value');
+```
+
+## API Reference
+
+### MockDatabase
+
+#### Methods
+
+- `createTable(name, schema?)` - Create a new table
+- `insert(table, record)` - Insert a record
+- `find(table, query)` - Find matching records
+- `findOne(table, query)` - Find first matching record
+- `update(table, query, updates)` - Update matching records
+- `delete(table, query)` - Delete matching records
+- `getAll(table)` - Get all records
+- `clearTable(table)` - Clear a table
+- `clearAll()` - Clear all tables
+- `count(table)` - Count records in table
+
+### HttpTestBuilder
+
+Static methods to create HTTP responses:
+
+- `ok(body)` - 200 response
+- `created(body)` - 201 response
+- `badRequest(message)` - 400 response
+- `unauthorized(message)` - 401 response
+- `forbidden(message)` - 403 response
+- `notFound(message)` - 404 response
+- `serverError(message)` - 500 response
+- `custom(status, body, headers)` - Custom response
+
+### HttpResponseAssertion
+
+Methods to assert HTTP responses:
+
+- `assertStatus(response, status)` - Check status code
+- `assertBodyHasKey(response, key)` - Check body contains key
+- `assertBodyMatches(response, expected)` - Check body values
+- `assertHeaderExists(response, name)` - Check header exists
+- `assertSuccess(response)` - Check 2xx status
+- `assertError(response)` - Check 4xx/5xx status
+
+### Fixtures
+
+Pre-built fixture generators:
+
+- `user(overrides?)` - Generate a user
+- `users(count, overrides?)` - Generate multiple users
+- `product(overrides?)` - Generate a product
+- `products(count, overrides?)` - Generate multiple products
+- `order(overrides?)` - Generate an order
+- `orders(count, overrides?)` - Generate multiple orders
+- `email(domain?)` - Generate a random email
+- `randomString(length?)` - Generate random string
+- `uuid()` - Generate a UUID
+- `custom(data, count?)` - Create custom fixture
+
+### FixtureBuilder<T>
+
+Builder pattern for complex fixtures:
+
+- `set(key, value)` - Set a property
+- `merge(overrides)` - Merge properties
+- `build()` - Build single fixture
+- `buildMany(count)` - Build multiple fixtures
+
+### Spy
+
+Function spy for tracking calls:
+
+- `create(implementation?)` - Create a spy
+- `returnValue(value)` - Set return value
+- `throwError(error)` - Make it throw
+- `getCalls()` - Get all calls
+- `getCallCount()` - Get call count
+- `getArguments(index)` - Get call arguments
+- `getFirstArg()` - Get first arg of first call
+- `wasCalled()` - Check if called
+- `wasCalledWith(...args)` - Check arguments
+- `reset()` - Reset spy
+
+### MockObject
+
+Object mocking utilities:
+
+- `create(shape)` - Create object with properties
+- `createWithSpies(keys)` - Create object with spy methods
+
+### Defer<T>
+
+Promise deferred for testing async code:
+
+- `promise` - The promise
+- `resolve(value)` - Resolve the promise
+- `reject(reason)` - Reject the promise
+
+## Usage Examples
+
+### Testing a User Service
+
+```typescript
+import { MockDatabase, Fixtures, Spy } from '@backend-master/test-utils';
+
+describe('UserService', () => {
+  let db: MockDatabase;
+  let emailService: any;
+
+  beforeEach(() => {
+    db = new MockDatabase();
+    db.createTable('users');
+    emailService = { send: Spy.create() };
+  });
+
+  test('should create user and send email', () => {
+    const user = Fixtures.user({ email: 'new@example.com' });
+    db.insert('users', user);
+    emailService.send();
+
+    expect(db.count('users')).toBe(1);
+    expect(emailService.send.wasCalled()).toBe(true);
+  });
+});
+```
+
+### Testing an API Endpoint
+
+```typescript
+import { HttpTestBuilder, HttpResponseAssertion } from '@backend-master/test-utils';
+
+describe('GET /api/users/:id', () => {
+  test('should return user when found', () => {
+    const response = HttpTestBuilder.ok({ 
+      id: 1, 
+      name: 'Alice' 
+    });
+
+    HttpResponseAssertion.assertStatus(response, 200);
+    HttpResponseAssertion.assertBodyHasKey(response, 'name');
+  });
+
+  test('should return 404 when not found', () => {
+    const response = HttpTestBuilder.notFound('User not found');
+    HttpResponseAssertion.assertStatus(response, 404);
+  });
+});
+```
+
+## Best Practices
+
+1. **Use Fixtures for Realistic Data**: Always use fixtures instead of hardcoding test data
+2. **Separate Concerns**: Keep database mocks, HTTP mocks, and service mocks separate
+3. **Reset State**: Always reset spies and databases between tests
+4. **Type Safety**: Leverage TypeScript types for better IDE support
+5. **Readable Assertions**: Use assertion helpers instead of raw comparisons
+
+## License
+
+MIT

package/dist/fixtures.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Test Fixtures & Data Generators
+ * Utilities for creating realistic test data
+ */
+export interface FixtureGeneratorOptions {
+    count?: number;
+    seed?: number;
+}
+export declare class Fixtures {
+    /**
+     * Generate a user fixture
+     */
+    static user(overrides?: Record<string, any>): any;
+    /**
+     * Generate multiple user fixtures
+     */
+    static users(count?: number, overrides?: Record<string, any>): any[];
+    /**
+     * Generate a product fixture
+     */
+    static product(overrides?: Record<string, any>): any;
+    /**
+     * Generate multiple product fixtures
+     */
+    static products(count?: number, overrides?: Record<string, any>): any[];
+    /**
+     * Generate an order fixture
+     */
+    static order(overrides?: Record<string, any>): any;
+    /**
+     * Generate multiple order fixtures
+     */
+    static orders(count?: number, overrides?: Record<string, any>): any[];
+    /**
+     * Generate a random email
+     */
+    static email(domain?: string): string;
+    /**
+     * Generate a random string
+     */
+    static randomString(length?: number): string;
+    /**
+     * Generate a random UUID
+     */
+    static uuid(): string;
+    /**
+     * Create a fixture with custom data
+     */
+    static custom(baseData: Record<string, any>, count?: number): any | any[];
+}
+/**
+ * Builder pattern for creating complex fixtures
+ */
+export declare class FixtureBuilder<T> {
+    private data;
+    constructor(initial: T);
+    set<K extends keyof T>(key: K, value: T[K]): this;
+    merge(overrides: Partial<T>): this;
+    build(): T;
+    buildMany(count: number): T[];
+}
+//# sourceMappingURL=fixtures.d.ts.map

package/dist/fixtures.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.d.ts","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,uBAAuB;IACpC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACjB;AA0BD,qBAAa,QAAQ;IACjB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAajD;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE;IAMvE;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAcpD;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE;IAM1E;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAalD;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,KAAK,GAAE,MAAU,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE;IAMxE;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,GAAE,MAAsB,GAAG,MAAM;IAKpD;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAIhD;;OAEG;IACH,MAAM,CAAC,IAAI,IAAI,MAAM;IAQrB;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,GAAE,MAAU,GAAG,GAAG,GAAG,GAAG,EAAE;CAS/E;AAED;;GAEG;AACH,qBAAa,cAAc,CAAC,CAAC;IACzB,OAAO,CAAC,IAAI,CAAI;gBAEJ,OAAO,EAAE,CAAC;IAItB,GAAG,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAKjD,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAKlC,KAAK,IAAI,CAAC;IAIV,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;CAGhC"}

package/dist/fixtures.js

@@ -0,0 +1,151 @@
+"use strict";
+/**
+ * Test Fixtures & Data Generators
+ * Utilities for creating realistic test data
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FixtureBuilder = exports.Fixtures = void 0;
+/**
+ * Simple seeded random number generator for reproducible tests
+ */
+class SeededRandom {
+    constructor(seed = Date.now()) {
+        this.seed = seed;
+    }
+    next() {
+        this.seed = (this.seed * 9301 + 49297) % 233280;
+        return this.seed / 233280;
+    }
+    nextInt(min, max) {
+        return Math.floor(this.next() * (max - min + 1)) + min;
+    }
+    choice(arr) {
+        return arr[Math.floor(this.next() * arr.length)];
+    }
+}
+class Fixtures {
+    /**
+     * Generate a user fixture
+     */
+    static user(overrides) {
+        const id = Math.floor(Math.random() * 100000);
+        return {
+            id,
+            name: `User ${id}`,
+            email: `user${id}@example.com`,
+            role: 'user',
+            createdAt: new Date().toISOString(),
+            isActive: true,
+            ...overrides
+        };
+    }
+    /**
+     * Generate multiple user fixtures
+     */
+    static users(count = 5, overrides) {
+        return Array.from({ length: count }, (_, i) => Fixtures.user({ id: i + 1, ...overrides }));
+    }
+    /**
+     * Generate a product fixture
+     */
+    static product(overrides) {
+        const id = Math.floor(Math.random() * 100000);
+        return {
+            id,
+            name: `Product ${id}`,
+            description: 'Test product description',
+            price: Math.floor(Math.random() * 10000) / 100,
+            stock: Math.floor(Math.random() * 1000),
+            sku: `SKU-${id}`,
+            createdAt: new Date().toISOString(),
+            ...overrides
+        };
+    }
+    /**
+     * Generate multiple product fixtures
+     */
+    static products(count = 5, overrides) {
+        return Array.from({ length: count }, (_, i) => Fixtures.product({ id: i + 1, ...overrides }));
+    }
+    /**
+     * Generate an order fixture
+     */
+    static order(overrides) {
+        const id = Math.floor(Math.random() * 100000);
+        return {
+            id,
+            userId: Math.floor(Math.random() * 1000),
+            items: [{ productId: 1, quantity: 2, price: 29.99 }],
+            total: 59.98,
+            status: 'pending',
+            createdAt: new Date().toISOString(),
+            ...overrides
+        };
+    }
+    /**
+     * Generate multiple order fixtures
+     */
+    static orders(count = 5, overrides) {
+        return Array.from({ length: count }, (_, i) => Fixtures.order({ id: i + 1, ...overrides }));
+    }
+    /**
+     * Generate a random email
+     */
+    static email(domain = 'example.com') {
+        const random = Math.random().toString(36).substring(2, 10);
+        return `test.${random}@${domain}`;
+    }
+    /**
+     * Generate a random string
+     */
+    static randomString(length = 10) {
+        return Math.random().toString(36).substring(2, 2 + length);
+    }
+    /**
+     * Generate a random UUID
+     */
+    static uuid() {
+        return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
+            const r = (Math.random() * 16) | 0;
+            const v = c === 'x' ? r : (r & 0x3) | 0x8;
+            return v.toString(16);
+        });
+    }
+    /**
+     * Create a fixture with custom data
+     */
+    static custom(baseData, count = 1) {
+        if (count === 1) {
+            return baseData;
+        }
+        return Array.from({ length: count }, (_, i) => ({
+            ...baseData,
+            id: i + 1
+        }));
+    }
+}
+exports.Fixtures = Fixtures;
+/**
+ * Builder pattern for creating complex fixtures
+ */
+class FixtureBuilder {
+    constructor(initial) {
+        this.data = JSON.parse(JSON.stringify(initial));
+    }
+    set(key, value) {
+        this.data[key] = value;
+        return this;
+    }
+    merge(overrides) {
+        this.data = { ...this.data, ...overrides };
+        return this;
+    }
+    build() {
+        return JSON.parse(JSON.stringify(this.data));
+    }
+    buildMany(count) {
+        return Array.from({ length: count }, () => this.build());
+    }
+}
+exports.FixtureBuilder = FixtureBuilder;
+//# sourceMappingURL=fixtures.js.map

package/dist/fixtures.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixtures.js","sourceRoot":"","sources":["../src/fixtures.ts"],"names":[],"mappings":"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"}

package/dist/http-test.d.ts

@@ -0,0 +1,70 @@
+/**
+ * HTTP Test Utilities
+ * Helpers for testing HTTP endpoints and mocking responses
+ */
+export interface HttpResponse {
+    status: number;
+    body: any;
+    headers?: Record<string, string>;
+}
+export declare class HttpTestBuilder {
+    /**
+     * Create a successful response (200)
+     */
+    static ok(body?: any): HttpResponse;
+    /**
+     * created response (201)
+     */
+    static created(body: any): HttpResponse;
+    /**
+     *bad request response (400)
+     */
+    static badRequest(message?: string): HttpResponse;
+    /**
+     * unauthorized response (401)
+     */
+    static unauthorized(message?: string): HttpResponse;
+    /**
+     * forbidden response (403)
+     */
+    static forbidden(message?: string): HttpResponse;
+    /**
+     * not found response (404)
+     */
+    static notFound(message?: string): HttpResponse;
+    /**
+     * server error response (500)
+     */
+    static serverError(message?: string): HttpResponse;
+    /**
+     * custom response
+     */
+    static custom(status: number, body?: any, headers?: Record<string, string>): HttpResponse;
+}
+export declare class HttpResponseAssertion {
+    /**
+     *  response status code
+     */
+    static assertStatus(response: HttpResponse, expectedStatus: number): void;
+    /**
+     * response body contains key
+     */
+    static assertBodyHasKey(response: HttpResponse, key: string): void;
+    /**
+     *  response body matches object
+     */
+    static assertBodyMatches(response: HttpResponse, expected: Record<string, any>): void;
+    /**
+     *  response header exists
+     */
+    static assertHeaderExists(response: HttpResponse, headerName: string): void;
+    /**
+     *  response is successful (2xx)
+     */
+    static assertSuccess(response: HttpResponse): void;
+    /**
+     *  response is error (4xx or 5xx)
+     */
+    static assertError(response: HttpResponse): void;
+}
+//# sourceMappingURL=http-test.d.ts.map

package/dist/http-test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-test.d.ts","sourceRoot":"","sources":["../src/http-test.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,GAAG,CAAC;IACV,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACpC;AAED,qBAAa,eAAe;IACxB;;OAEG;IACH,MAAM,CAAC,EAAE,CAAC,IAAI,GAAE,GAAQ,GAAG,YAAY;IAQvC;;OAEG;IACH,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,GAAG,YAAY;IAQvC;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,OAAO,GAAE,MAAsB,GAAG,YAAY;IAQhE;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,OAAO,GAAE,MAAuB,GAAG,YAAY;IAQnE;;OAEG;IACH,MAAM,CAAC,SAAS,CAAC,OAAO,GAAE,MAAoB,GAAG,YAAY;IAQ7D;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,OAAO,GAAE,MAAoB,GAAG,YAAY;IAQ5D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,GAAE,MAAgC,GAAG,YAAY;IAQ3E;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,GAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,YAAY;CAGhG;AAED,qBAAa,qBAAqB;IAC9B;;OAEG;IACH,MAAM,CAAC,YAAY,CAAC,QAAQ,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,GAAG,IAAI;IAQzE;;OAEG;IACH,MAAM,CAAC,gBAAgB,CAAC,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI;IAQlE;;OAEG;IACH,MAAM,CAAC,iBAAiB,CAAC,QAAQ,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,IAAI;IAYrF;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,IAAI;IAS3E;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAQlD;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;CAOnD"}

package/dist/http-test.js

@@ -0,0 +1,141 @@
+"use strict";
+/**
+ * HTTP Test Utilities
+ * Helpers for testing HTTP endpoints and mocking responses
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HttpResponseAssertion = exports.HttpTestBuilder = void 0;
+class HttpTestBuilder {
+    /**
+     * Create a successful response (200)
+     */
+    static ok(body = {}) {
+        return {
+            status: 200,
+            body,
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * created response (201)
+     */
+    static created(body) {
+        return {
+            status: 201,
+            body,
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     *bad request response (400)
+     */
+    static badRequest(message = 'Bad Request') {
+        return {
+            status: 400,
+            body: { error: message },
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * unauthorized response (401)
+     */
+    static unauthorized(message = 'Unauthorized') {
+        return {
+            status: 401,
+            body: { error: message },
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * forbidden response (403)
+     */
+    static forbidden(message = 'Forbidden') {
+        return {
+            status: 403,
+            body: { error: message },
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * not found response (404)
+     */
+    static notFound(message = 'Not Found') {
+        return {
+            status: 404,
+            body: { error: message },
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * server error response (500)
+     */
+    static serverError(message = 'Internal Server Error') {
+        return {
+            status: 500,
+            body: { error: message },
+            headers: { 'Content-Type': 'application/json' }
+        };
+    }
+    /**
+     * custom response
+     */
+    static custom(status, body = {}, headers) {
+        return { status, body, headers };
+    }
+}
+exports.HttpTestBuilder = HttpTestBuilder;
+class HttpResponseAssertion {
+    /**
+     *  response status code
+     */
+    static assertStatus(response, expectedStatus) {
+        if (response.status !== expectedStatus) {
+            throw new Error(`Expected status ${expectedStatus}, but got ${response.status}`);
+        }
+    }
+    /**
+     * response body contains key
+     */
+    static assertBodyHasKey(response, key) {
+        if (!(key in response.body)) {
+            throw new Error(`Expected response body to contain key "${key}", but it doesn't`);
+        }
+    }
+    /**
+     *  response body matches object
+     */
+    static assertBodyMatches(response, expected) {
+        for (const [key, value] of Object.entries(expected)) {
+            if (response.body[key] !== value) {
+                throw new Error(`Expected body.${key} to be ${JSON.stringify(value)}, but got ${JSON.stringify(response.body[key])}`);
+            }
+        }
+    }
+    /**
+     *  response header exists
+     */
+    static assertHeaderExists(response, headerName) {
+        const headers = response.headers || {};
+        if (!(headerName in headers)) {
+            throw new Error(`Expected header "${headerName}" to exist, but it doesn't`);
+        }
+    }
+    /**
+     *  response is successful (2xx)
+     */
+    static assertSuccess(response) {
+        if (response.status < 200 || response.status >= 300) {
+            throw new Error(`Expected successful response (2xx), but got ${response.status}`);
+        }
+    }
+    /**
+     *  response is error (4xx or 5xx)
+     */
+    static assertError(response) {
+        if (response.status < 400) {
+            throw new Error(`Expected error response (4xx/5xx), but got ${response.status}`);
+        }
+    }
+}
+exports.HttpResponseAssertion = HttpResponseAssertion;
+//# sourceMappingURL=http-test.js.map

package/dist/http-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-test.js","sourceRoot":"","sources":["../src/http-test.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @backend-master/test-utils
+ * Comprehensive testing utilities for Node.js backend projects
+ */
+import { MockDatabase } from './mock-db';
+import { HttpTestBuilder, HttpResponseAssertion } from './http-test';
+import { Fixtures, FixtureBuilder } from './fixtures';
+import { Spy, MockObject, Defer } from './spy';
+export { MockDatabase, MockDBConfig } from './mock-db';
+export { HttpTestBuilder, HttpResponseAssertion, HttpResponse } from './http-test';
+export { Fixtures, FixtureBuilder } from './fixtures';
+export { Spy, MockObject, Defer, CallInfo } from './spy';
+export declare const testUtils: {
+    db: {
+        MockDatabase: typeof MockDatabase;
+    };
+    http: {
+        HttpTestBuilder: typeof HttpTestBuilder;
+        HttpResponseAssertion: typeof HttpResponseAssertion;
+    };
+    fixtures: {
+        Fixtures: typeof Fixtures;
+        FixtureBuilder: typeof FixtureBuilder;
+    };
+    mocks: {
+        Spy: typeof Spy;
+        MockObject: typeof MockObject;
+        Defer: typeof Defer;
+    };
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,OAAO,CAAC;AAE/C,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAGzD,eAAO,MAAM,SAAS;;;;;;;;;;;;;;;;;CAiBrB,CAAC"}

package/dist/index.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @backend-master/test-utils
+ * Comprehensive testing utilities for Node.js backend projects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.testUtils = exports.Defer = exports.MockObject = exports.Spy = exports.FixtureBuilder = exports.Fixtures = exports.HttpResponseAssertion = exports.HttpTestBuilder = exports.MockDatabase = void 0;
+const mock_db_1 = require("./mock-db");
+const http_test_1 = require("./http-test");
+const fixtures_1 = require("./fixtures");
+const spy_1 = require("./spy");
+var mock_db_2 = require("./mock-db");
+Object.defineProperty(exports, "MockDatabase", { enumerable: true, get: function () { return mock_db_2.MockDatabase; } });
+var http_test_2 = require("./http-test");
+Object.defineProperty(exports, "HttpTestBuilder", { enumerable: true, get: function () { return http_test_2.HttpTestBuilder; } });
+Object.defineProperty(exports, "HttpResponseAssertion", { enumerable: true, get: function () { return http_test_2.HttpResponseAssertion; } });
+var fixtures_2 = require("./fixtures");
+Object.defineProperty(exports, "Fixtures", { enumerable: true, get: function () { return fixtures_2.Fixtures; } });
+Object.defineProperty(exports, "FixtureBuilder", { enumerable: true, get: function () { return fixtures_2.FixtureBuilder; } });
+var spy_2 = require("./spy");
+Object.defineProperty(exports, "Spy", { enumerable: true, get: function () { return spy_2.Spy; } });
+Object.defineProperty(exports, "MockObject", { enumerable: true, get: function () { return spy_2.MockObject; } });
+Object.defineProperty(exports, "Defer", { enumerable: true, get: function () { return spy_2.Defer; } });
+// Convenience exports
+exports.testUtils = {
+    db: {
+        MockDatabase: mock_db_1.MockDatabase
+    },
+    http: {
+        HttpTestBuilder: http_test_1.HttpTestBuilder,
+        HttpResponseAssertion: http_test_1.HttpResponseAssertion
+    },
+    fixtures: {
+        Fixtures: fixtures_1.Fixtures,
+        FixtureBuilder: fixtures_1.FixtureBuilder
+    },
+    mocks: {
+        Spy: spy_1.Spy,
+        MockObject: spy_1.MockObject,
+        Defer: spy_1.Defer
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,uCAAyC;AACzC,2CAAqE;AACrE,yCAAsD;AACtD,+BAA+C;AAE/C,qCAAuD;AAA9C,uGAAA,YAAY,OAAA;AACrB,yCAAmF;AAA1E,4GAAA,eAAe,OAAA;AAAE,kHAAA,qBAAqB,OAAA;AAC/C,uCAAsD;AAA7C,oGAAA,QAAQ,OAAA;AAAE,0GAAA,cAAc,OAAA;AACjC,6BAAyD;AAAhD,0FAAA,GAAG,OAAA;AAAE,iGAAA,UAAU,OAAA;AAAE,4FAAA,KAAK,OAAA;AAE/B,sBAAsB;AACT,QAAA,SAAS,GAAG;IACrB,EAAE,EAAE;QACA,YAAY,EAAZ,sBAAY;KACf;IACD,IAAI,EAAE;QACF,eAAe,EAAf,2BAAe;QACf,qBAAqB,EAArB,iCAAqB;KACxB;IACD,QAAQ,EAAE;QACN,QAAQ,EAAR,mBAAQ;QACR,cAAc,EAAd,yBAAc;KACjB;IACD,KAAK,EAAE;QACH,GAAG,EAAH,SAAG;QACH,UAAU,EAAV,gBAAU;QACV,KAAK,EAAL,WAAK;KACR;CACJ,CAAC"}

package/dist/mock-db.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Mock Database Helper
+ * Provides in-memory database simulation for testing without external dependencies
+ */
+export interface MockDBConfig {
+    tables?: Record<string, any[]>;
+    autoIncrement?: boolean;
+}
+export declare class MockDatabase {
+    private tables;
+    private autoIncrement;
+    private idCounters;
+    constructor(config?: MockDBConfig);
+    /**
+     * Create a new table
+     */
+    createTable(name: string, schema?: Record<string, string>): void;
+    /**
+     * Insert a record into a table
+     */
+    insert(table: string, record: any): any;
+    /**
+     * Find records matching a query
+     */
+    find(table: string, query?: Record<string, any>): any[];
+    /**
+     * Find a single record
+     */
+    findOne(table: string, query: Record<string, any>): any | null;
+    /**
+     * Update records matching a query
+     */
+    update(table: string, query: Record<string, any>, updates: Record<string, any>): number;
+    /**
+     * Delete records matching a query
+     */
+    delete(table: string, query: Record<string, any>): number;
+    /**
+     * Get all records from a table
+     */
+    getAll(table: string): any[];
+    /**
+     * Clear a table
+     */
+    clearTable(table: string): void;
+    /**
+     * Clear all tables
+     */
+    clearAll(): void;
+    /**
+     * Get table count
+     */
+    count(table: string): number;
+}
+//# sourceMappingURL=mock-db.d.ts.map

package/dist/mock-db.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-db.d.ts","sourceRoot":"","sources":["../src/mock-db.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IACzB,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;IAC/B,aAAa,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,qBAAa,YAAY;IACrB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,UAAU,CAAkC;gBAExC,MAAM,CAAC,EAAE,YAAY;IASjC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAQhE;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,GAAG;IAgBvC;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,GAAG,GAAG,EAAE;IAW3D;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,IAAI;IAK9D;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAqBvF;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM;IAoBzD;;OAEG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,EAAE;IAO5B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAQ/B;;OAEG;IACH,QAAQ,IAAI,IAAI;IAKhB;;OAEG;IACH,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM;CAM/B"}

package/dist/mock-db.js

@@ -0,0 +1,134 @@
+"use strict";
+/**
+ * Mock Database Helper
+ * Provides in-memory database simulation for testing without external dependencies
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MockDatabase = void 0;
+class MockDatabase {
+    constructor(config) {
+        this.tables = new Map();
+        this.idCounters = new Map();
+        this.autoIncrement = config?.autoIncrement ?? true;
+        if (config?.tables) {
+            Object.entries(config.tables).forEach(([table, data]) => {
+                this.tables.set(table, JSON.parse(JSON.stringify(data)));
+            });
+        }
+    }
+    /**
+     * Create a new table
+     */
+    createTable(name, schema) {
+        if (this.tables.has(name)) {
+            throw new Error(`Table "${name}" already exists`);
+        }
+        this.tables.set(name, []);
+        this.idCounters.set(name, 0);
+    }
+    /**
+     * Insert a record into a table
+     */
+    insert(table, record) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        const newRecord = { ...record };
+        if (this.autoIncrement && !newRecord.id) {
+            const count = this.idCounters.get(table) || 0;
+            newRecord.id = count + 1;
+            this.idCounters.set(table, count + 1);
+        }
+        this.tables.get(table).push(newRecord);
+        return newRecord;
+    }
+    /**
+     * Find records matching a query
+     */
+    find(table, query = {}) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        const records = this.tables.get(table);
+        return records.filter(record => Object.entries(query).every(([key, value]) => record[key] === value));
+    }
+    /**
+     * Find a single record
+     */
+    findOne(table, query) {
+        const results = this.find(table, query);
+        return results.length > 0 ? results[0] : null;
+    }
+    /**
+     * Update records matching a query
+     */
+    update(table, query, updates) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        const records = this.tables.get(table);
+        let updated = 0;
+        for (let i = 0; i < records.length; i++) {
+            const matches = Object.entries(query).every(([key, value]) => records[i][key] === value);
+            if (matches) {
+                records[i] = { ...records[i], ...updates };
+                updated++;
+            }
+        }
+        return updated;
+    }
+    /**
+     * Delete records matching a query
+     */
+    delete(table, query) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        const records = this.tables.get(table);
+        const originalLength = records.length;
+        for (let i = records.length - 1; i >= 0; i--) {
+            const matches = Object.entries(query).every(([key, value]) => records[i][key] === value);
+            if (matches) {
+                records.splice(i, 1);
+            }
+        }
+        return originalLength - records.length;
+    }
+    /**
+     * Get all records from a table
+     */
+    getAll(table) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        return JSON.parse(JSON.stringify(this.tables.get(table)));
+    }
+    /**
+     * Clear a table
+     */
+    clearTable(table) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        this.tables.set(table, []);
+        this.idCounters.set(table, 0);
+    }
+    /**
+     * Clear all tables
+     */
+    clearAll() {
+        this.tables.clear();
+        this.idCounters.clear();
+    }
+    /**
+     * Get table count
+     */
+    count(table) {
+        if (!this.tables.has(table)) {
+            throw new Error(`Table "${table}" does not exist`);
+        }
+        return this.tables.get(table).length;
+    }
+}
+exports.MockDatabase = MockDatabase;
+//# sourceMappingURL=mock-db.js.map

package/dist/mock-db.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-db.js","sourceRoot":"","sources":["../src/mock-db.ts"],"names":[],"mappings":"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"}

package/dist/spy.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Spy & Mock Utilities
+ * Helpers for tracking function calls and creating mocks
+ */
+export interface CallInfo {
+    args: any[];
+    returnValue?: any;
+    error?: Error;
+    timestamp: number;
+}
+export declare class Spy {
+    private calls;
+    private _returnValue;
+    private shouldThrow;
+    /**
+     * Create a spy function
+     */
+    static create<T extends (...args: any[]) => any>(implementation?: T): T & Spy;
+    /**
+     * Set return value
+     */
+    returnValue(value: any): this;
+    /**
+     * Set up to throw error
+     */
+    throwError(error: Error | string): this;
+    /**
+     * Implement with custom function
+     */
+    implementWith<T extends (...args: any[]) => any>(fn: T): T & Spy;
+    /**
+     * Record a call
+     */
+    private record;
+    /**
+     * Get all calls
+     */
+    getCalls(): CallInfo[];
+    /**
+     * Get call count
+     */
+    getCallCount(): number;
+    /**
+     * Get arguments of nth call
+     */
+    getArguments(callIndex?: number): any[];
+    /**
+     * Get first argument of first call
+     */
+    getFirstArg(): any;
+    /**
+     * Check if called
+     */
+    wasCalled(): boolean;
+    /**
+     * Check if called with specific arguments
+     */
+    wasCalledWith(...args: any[]): boolean;
+    /**
+     * Reset spy
+     */
+    reset(): void;
+}
+/**
+ * Maps an object type so function-valued properties become T[K] & Spy
+ */
+type SpyWrapped<T> = {
+    [K in keyof T]: T[K] extends (...args: any[]) => any ? T[K] & Spy : T[K];
+};
+/**
+ * Maps an object type so all properties become T[K] & Spy
+ */
+type AllSpies<T> = {
+    [K in keyof T]: T[K] & Spy;
+};
+/**
+ * Simple object mocking
+ */
+export declare class MockObject {
+    static create<T extends Record<string, any>>(shape: Partial<T>): SpyWrapped<T>;
+    /**
+     * Create a mock with all methods as spies
+     */
+    static createWithSpies<T extends Record<string, any>>(keys: (keyof T)[]): AllSpies<T>;
+}
+/**
+ * Defer helper for testing async code
+ */
+export declare class Defer<T> {
+    promise: Promise<T>;
+    resolve: (value: T) => void;
+    reject: (reason?: any) => void;
+    constructor();
+}
+export {};
+//# sourceMappingURL=spy.d.ts.map

package/dist/spy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spy.d.ts","sourceRoot":"","sources":["../src/spy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,GAAG,EAAE,CAAC;IACZ,WAAW,CAAC,EAAE,GAAG,CAAC;IAClB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACrB;AAED,qBAAa,GAAG;IACZ,OAAO,CAAC,KAAK,CAAkB;IAC/B,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,WAAW,CAAsB;IAEzC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAC3C,cAAc,CAAC,EAAE,CAAC,GACnB,CAAC,GAAG,GAAG;IAwBV;;OAEG;IACH,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,IAAI;IAM7B;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,KAAK,GAAG,MAAM,GAAG,IAAI;IAKvC;;OAEG;IACH,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,GAAG;IAmChE;;OAEG;IACH,OAAO,CAAC,MAAM;IAiBd;;OAEG;IACH,QAAQ,IAAI,QAAQ,EAAE;IAItB;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,YAAY,CAAC,SAAS,GAAE,MAAU,GAAG,GAAG,EAAE;IAO1C;;OAEG;IACH,WAAW,IAAI,GAAG;IAIlB;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,aAAa,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO;IAMtC;;OAEG;IACH,KAAK,IAAI,IAAI;CAKhB;AAED;;GAEG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI;KAChB,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;CAC3E,CAAC;AAEF;;GAEG;AACH,KAAK,QAAQ,CAAC,CAAC,IAAI;KACd,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG;CAC7B,CAAC;AAEF;;GAEG;AACH,qBAAa,UAAU;IACnB,MAAM,CAAC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IAc9E;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAChD,IAAI,EAAE,CAAC,MAAM,CAAC,CAAC,EAAE,GAClB,QAAQ,CAAC,CAAC,CAAC;CASjB;AAGD;;GAEG;AACH,qBAAa,KAAK,CAAC,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IACpB,OAAO,EAAG,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,CAAC;IAC7B,MAAM,EAAG,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,IAAI,CAAC;;CAQnC"}

package/dist/spy.js

@@ -0,0 +1,192 @@
+"use strict";
+/**
+ * Spy & Mock Utilities
+ * Helpers for tracking function calls and creating mocks
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Defer = exports.MockObject = exports.Spy = void 0;
+class Spy {
+    constructor() {
+        this.calls = [];
+        this.shouldThrow = null;
+    }
+    /**
+     * Create a spy function
+     */
+    static create(implementation) {
+        const spy = new Spy();
+        if (implementation) {
+            return spy.implementWith(implementation);
+        }
+        const fn = function (...args) {
+            return spy.record(args);
+        };
+        Object.setPrototypeOf(fn, Spy.prototype);
+        // Proxy property access to the spy instance so state stays in sync
+        for (const prop of ['calls', '_returnValue', 'shouldThrow']) {
+            Object.defineProperty(fn, prop, {
+                get: () => spy[prop],
+                set: (v) => { spy[prop] = v; },
+                configurable: true
+            });
+        }
+        return fn;
+    }
+    /**
+     * Set return value
+     */
+    returnValue(value) {
+        this._returnValue = value;
+        this.shouldThrow = null;
+        return this;
+    }
+    /**
+     * Set up to throw error
+     */
+    throwError(error) {
+        this.shouldThrow = typeof error === 'string' ? new Error(error) : error;
+        return this;
+    }
+    /**
+     * Implement with custom function
+     */
+    implementWith(fn) {
+        const spy = this;
+        const originalFn = fn;
+        const wrappedFn = function (...args) {
+            try {
+                const result = originalFn(...args);
+                spy.calls.push({
+                    args,
+                    returnValue: result,
+                    timestamp: Date.now()
+                });
+                return result;
+            }
+            catch (error) {
+                spy.calls.push({
+                    args,
+                    error: error,
+                    timestamp: Date.now()
+                });
+                throw error;
+            }
+        };
+        Object.setPrototypeOf(wrappedFn, Spy.prototype);
+        // Proxy property access to the spy instance so state stays in sync
+        for (const prop of ['calls', '_returnValue', 'shouldThrow']) {
+            Object.defineProperty(wrappedFn, prop, {
+                get: () => spy[prop],
+                set: (v) => { spy[prop] = v; },
+                configurable: true
+            });
+        }
+        return wrappedFn;
+    }
+    /**
+     * Record a call
+     */
+    record(args) {
+        const callInfo = {
+            args,
+            timestamp: Date.now()
+        };
+        if (this.shouldThrow) {
+            callInfo.error = this.shouldThrow;
+            this.calls.push(callInfo);
+            throw this.shouldThrow;
+        }
+        callInfo.returnValue = this._returnValue;
+        this.calls.push(callInfo);
+        return this._returnValue;
+    }
+    /**
+     * Get all calls
+     */
+    getCalls() {
+        return [...this.calls];
+    }
+    /**
+     * Get call count
+     */
+    getCallCount() {
+        return this.calls.length;
+    }
+    /**
+     * Get arguments of nth call
+     */
+    getArguments(callIndex = 0) {
+        if (callIndex >= this.calls.length) {
+            throw new Error(`Call at index ${callIndex} does not exist`);
+        }
+        return this.calls[callIndex].args;
+    }
+    /**
+     * Get first argument of first call
+     */
+    getFirstArg() {
+        return this.getArguments(0)[0];
+    }
+    /**
+     * Check if called
+     */
+    wasCalled() {
+        return this.calls.length > 0;
+    }
+    /**
+     * Check if called with specific arguments
+     */
+    wasCalledWith(...args) {
+        return this.calls.some(call => JSON.stringify(call.args) === JSON.stringify(args));
+    }
+    /**
+     * Reset spy
+     */
+    reset() {
+        this.calls.length = 0;
+        this._returnValue = undefined;
+        this.shouldThrow = null;
+    }
+}
+exports.Spy = Spy;
+/**
+ * Simple object mocking
+ */
+class MockObject {
+    static create(shape) {
+        const mock = {};
+        for (const [key, value] of Object.entries(shape)) {
+            if (typeof value === 'function') {
+                mock[key] = Spy.create(value);
+            }
+            else {
+                mock[key] = value;
+            }
+        }
+        return mock;
+    }
+    /**
+     * Create a mock with all methods as spies
+     */
+    static createWithSpies(keys) {
+        const mock = {};
+        for (const key of keys) {
+            mock[key] = Spy.create();
+        }
+        return mock;
+    }
+}
+exports.MockObject = MockObject;
+/**
+ * Defer helper for testing async code
+ */
+class Defer {
+    constructor() {
+        this.promise = new Promise((resolve, reject) => {
+            this.resolve = resolve;
+            this.reject = reject;
+        });
+    }
+}
+exports.Defer = Defer;
+//# sourceMappingURL=spy.js.map

package/dist/spy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spy.js","sourceRoot":"","sources":["../src/spy.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AASH,MAAa,GAAG;IAAhB;QACY,UAAK,GAAe,EAAE,CAAC;QAEvB,gBAAW,GAAiB,IAAI,CAAC;IAiK7C,CAAC;IA/JG;;OAEG;IACH,MAAM,CAAC,MAAM,CACT,cAAkB;QAElB,MAAM,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;QAEtB,IAAI,cAAc,EAAE,CAAC;YACjB,OAAO,GAAG,CAAC,aAAa,CAAC,cAAc,CAAC,CAAC;QAC7C,CAAC;QAED,MAAM,EAAE,GAAG,UAAqB,GAAG,IAAW;YAC1C,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAQ,CAAC;QAET,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QACzC,mEAAmE;QACnE,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,CAAU,EAAE,CAAC;YACnE,MAAM,CAAC,cAAc,CAAC,EAAE,EAAE,IAAI,EAAE;gBAC5B,GAAG,EAAE,GAAG,EAAE,CAAE,GAAW,CAAC,IAAI,CAAC;gBAC7B,GAAG,EAAE,CAAC,CAAM,EAAE,EAAE,GAAI,GAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5C,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,CAAC;QAED,OAAO,EAAa,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,KAAU;QAClB,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,KAAqB;QAC5B,IAAI,CAAC,WAAW,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACxE,OAAO,IAAI,CAAC;IAChB,CAAC;IAED;;OAEG;IACH,aAAa,CAAoC,EAAK;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC;QACjB,MAAM,UAAU,GAAG,EAAE,CAAC;QACtB,MAAM,SAAS,GAAG,UAAqB,GAAG,IAAW;YACjD,IAAI,CAAC;gBACD,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;gBACnC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,WAAW,EAAE,MAAM;oBACnB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACxB,CAAC,CAAC;gBACH,OAAO,MAAM,CAAC;YAClB,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC;oBACX,IAAI;oBACJ,KAAK,EAAE,KAAc;oBACrB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;iBACxB,CAAC,CAAC;gBACH,MAAM,KAAK,CAAC;YAChB,CAAC;QACL,CAAC,CAAC;QAEF,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,mEAAmE;QACnE,KAAK,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,aAAa,CAAU,EAAE,CAAC;YACnE,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE;gBACnC,GAAG,EAAE,GAAG,EAAE,CAAE,GAAW,CAAC,IAAI,CAAC;gBAC7B,GAAG,EAAE,CAAC,CAAM,EAAE,EAAE,GAAI,GAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;gBAC5C,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,CAAC;QAED,OAAO,SAA2B,CAAC;IACvC,CAAC;IAED;;OAEG;IACK,MAAM,CAAC,IAAW;QACtB,MAAM,QAAQ,GAAa;YACvB,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACxB,CAAC;QAEF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACnB,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC;YAClC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC1B,MAAM,IAAI,CAAC,WAAW,CAAC;QAC3B,CAAC;QAED,QAAQ,CAAC,WAAW,GAAG,IAAI,CAAC,YAAY,CAAC;QACzC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1B,OAAO,IAAI,CAAC,YAAY,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,QAAQ;QACJ,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,CAAC;IAED;;OAEG;IACH,YAAY;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,YAAoB,CAAC;QAC9B,IAAI,SAAS,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;YACjC,MAAM,IAAI,KAAK,CAAC,iBAAiB,SAAS,iBAAiB,CAAC,CAAC;QACjE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC;IACtC,CAAC;IAED;;OAEG;IACH,WAAW;QACP,OAAO,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,SAAS;QACL,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,GAAG,IAAW;QACxB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC1B,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CACrD,CAAC;IACN,CAAC;IAED;;OAEG;IACH,KAAK;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;QACtB,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC;IAC5B,CAAC;CACJ;AApKD,kBAoKC;AAgBD;;GAEG;AACH,MAAa,UAAU;IACnB,MAAM,CAAC,MAAM,CAAgC,KAAiB;QAC1D,MAAM,IAAI,GAAQ,EAAE,CAAC;QAErB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC/C,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC9B,IAAI,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC,KAAY,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACJ,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;YACtB,CAAC;QACL,CAAC;QAED,OAAO,IAAqB,CAAC;IACjC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAClB,IAAiB;QAEjB,MAAM,IAAI,GAAQ,EAAE,CAAC;QAErB,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACrB,IAAI,CAAC,GAAa,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC;QACvC,CAAC;QAED,OAAO,IAAmB,CAAC;IAC/B,CAAC;CACJ;AA7BD,gCA6BC;AAGD;;GAEG;AACH,MAAa,KAAK;IAKd;QACI,IAAI,CAAC,OAAO,GAAG,IAAI,OAAO,CAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YAC9C,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;YACvB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACzB,CAAC,CAAC,CAAC;IACP,CAAC;CACJ;AAXD,sBAWC"}

package/package.json

@@ -0,0 +1,51 @@
+{
+    "name": "@backend-master/test-utils",
+    "version": "1.0.0",
+    "description": "Comprehensive testing utilities for Node.js backend projects",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "files": [
+        "dist",
+        "README.md"
+    ],
+    "scripts": {
+        "build": "tsc",
+        "test": "jest",
+        "test:watch": "jest --watch",
+        "test:coverage": "jest --coverage",
+        "lint": "eslint src/**/*.ts",
+        "prepare": "npm run build"
+    },
+    "keywords": [
+        "testing",
+        "node.js",
+        "backend",
+        "utilities",
+        "mock",
+        "fixture",
+        "assertion"
+    ],
+    "author": "",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": ""
+    },
+    "publishConfig": {
+        "access": "public"
+    },
+    "devDependencies": {
+        "@types/jest": "^29.5.0",
+        "@types/node": "^20.0.0",
+        "@typescript-eslint/eslint-plugin": "^6.0.0",
+        "@typescript-eslint/parser": "^6.0.0",
+        "eslint": "^8.0.0",
+        "jest": "^29.5.0",
+        "ts-jest": "^29.1.0",
+        "typescript": "^5.0.0"
+    },
+    "peerDependencies": {
+        "jest": ">=25.0.0"
+    },
+    "peerDependenciesOptional": true
+}