@engjts/nexus 0.1.0

package/dist/advanced/testing/index.d.ts

@@ -0,0 +1,235 @@
+/**
+ * Test Framework Integration
+ * Provides seamless integration with Jest, Vitest, and Node test runner
+ */
+import { Application } from '../../core/application';
+import { TestClient } from './harness';
+import { MockDatabase, MockFetch, MockTimers } from './mock';
+/**
+ * Detected test framework
+ */
+export type TestFramework = 'jest' | 'vitest' | 'node' | 'unknown';
+/**
+ * Detect which test framework is being used
+ */
+export declare function detectTestFramework(): TestFramework;
+/**
+ * Test suite configuration for framework integration
+ */
+export interface NexusTestConfig<T = void> {
+    /**
+     * Nexus application instance
+     */
+    app: Application;
+    /**
+     * Setup function called before all tests
+     */
+    setup?: () => Promise<T>;
+    /**
+     * Teardown function called after all tests
+     */
+    teardown?: (context: T) => Promise<void>;
+    /**
+     * Reset function called before each test
+     */
+    reset?: (context: T) => Promise<void>;
+    /**
+     * Enable mock database
+     * @default true
+     */
+    mockDatabase?: boolean;
+    /**
+     * Enable mock fetch
+     * @default false
+     */
+    mockFetch?: boolean;
+    /**
+     * Enable mock timers
+     * @default false
+     */
+    mockTimers?: boolean;
+    /**
+     * Auto-cleanup after each test
+     * @default true
+     */
+    autoCleanup?: boolean;
+}
+/**
+ * Test context available in tests
+ */
+export interface NexusTestContext<T = void> {
+    /**
+     * HTTP test client
+     */
+    client: TestClient;
+    /**
+     * Base URL of the test server
+     */
+    baseUrl: string;
+    /**
+     * Mock database instance
+     */
+    db: MockDatabase;
+    /**
+     * Mock fetch instance
+     */
+    fetch: MockFetch;
+    /**
+     * Mock timers instance
+     */
+    timers: MockTimers;
+    /**
+     * Custom context from setup
+     */
+    context: T;
+}
+/**
+ * Create a Nexus test suite with automatic setup/teardown
+ *
+ * @example Jest/Vitest
+ * ```typescript
+ * import { createNexusTest } from 'nexus/testing';
+ * import { app } from './app';
+ *
+ * const { beforeAll, afterAll, beforeEach, getContext } = createNexusTest({
+ *   app,
+ *   mockDatabase: true,
+ *   setup: async () => {
+ *     // Seed test data
+ *     return { adminToken: 'test-admin-token' };
+ *   }
+ * });
+ *
+ * describe('Users API', () => {
+ *   beforeAll();
+ *   afterAll();
+ *   beforeEach();
+ *
+ *   test('should list users', async () => {
+ *     const { client, context } = getContext();
+ *
+ *     const res = await client.get('/users', {
+ *       headers: { Authorization: `Bearer ${context.adminToken}` }
+ *     });
+ *
+ *     expect(res.status).toBe(200);
+ *     expect(res.json().users).toBeArray();
+ *   });
+ * });
+ * ```
+ */
+export declare function createNexusTest<T = void>(config: NexusTestConfig<T>): {
+    /**
+     * Call this in beforeAll/before hook
+     */
+    beforeAll: () => () => Promise<void>;
+    /**
+     * Call this in afterAll/after hook
+     */
+    afterAll: () => () => Promise<void>;
+    /**
+     * Call this in beforeEach hook
+     */
+    beforeEach: () => () => Promise<void>;
+    /**
+     * Call this in afterEach hook (optional)
+     */
+    afterEach: () => () => Promise<void>;
+    /**
+     * Get current test context
+     */
+    getContext: () => NexusTestContext<T>;
+    /**
+     * Get the test client directly
+     */
+    getClient: () => TestClient;
+};
+/**
+ * Assertion helpers for Nexus testing
+ */
+export declare const assertions: {
+    /**
+     * Assert response status
+     */
+    expectStatus(response: {
+        status: number;
+    }, expected: number): void;
+    /**
+     * Assert response is JSON
+     */
+    expectJson(response: {
+        body: string;
+        headers: Record<string, any>;
+    }): any;
+    /**
+     * Assert response contains key
+     */
+    expectBodyHas(response: {
+        body: string;
+    }, key: string): void;
+    /**
+     * Assert response body equals
+     */
+    expectBodyEquals(response: {
+        body: string;
+    }, expected: any): void;
+    /**
+     * Assert header exists
+     */
+    expectHeader(response: {
+        headers: Record<string, any>;
+    }, name: string, value?: string): void;
+    /**
+     * Assert response time
+     */
+    expectFast(response: {
+        duration: number;
+    }, maxMs?: number): void;
+};
+/**
+ * Create authenticated test client
+ *
+ * @example
+ * ```typescript
+ * const adminClient = createAuthenticatedClient(app, {
+ *   token: 'admin-jwt-token',
+ *   headers: { 'X-Tenant-ID': 'test-tenant' }
+ * });
+ *
+ * const res = await adminClient.get('/admin/users');
+ * ```
+ */
+export declare function createAuthenticatedClient(app: Application, auth: {
+    token?: string;
+    headers?: Record<string, string>;
+    user?: any;
+}): TestClient;
+/**
+ * Wait for condition with timeout
+ */
+export declare function waitForCondition(condition: () => boolean | Promise<boolean>, options?: {
+    timeout?: number;
+    interval?: number;
+    message?: string;
+}): Promise<void>;
+/**
+ * Retry function with exponential backoff
+ */
+export declare function retryAsync<T>(fn: () => Promise<T>, options?: {
+    maxAttempts?: number;
+    delay?: number;
+    backoff?: boolean;
+}): Promise<T>;
+/**
+ * Measure execution time of async function
+ */
+export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    duration: number;
+}>;
+export * from './harness';
+export * from './mock';
+export * from './factory';
+export * from './load-test';
+export * from './mock-server';
+//# sourceMappingURL=index.d.ts.map

package/dist/advanced/testing/index.d.ts.map

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

package/dist/advanced/testing/index.js

@@ -0,0 +1,306 @@
+"use strict";
+/**
+ * Test Framework Integration
+ * Provides seamless integration with Jest, Vitest, and Node test runner
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertions = void 0;
+exports.detectTestFramework = detectTestFramework;
+exports.createNexusTest = createNexusTest;
+exports.createAuthenticatedClient = createAuthenticatedClient;
+exports.waitForCondition = waitForCondition;
+exports.retryAsync = retryAsync;
+exports.measureTime = measureTime;
+const harness_1 = require("./harness");
+const mock_1 = require("./mock");
+/**
+ * Detect which test framework is being used
+ */
+function detectTestFramework() {
+    // Check for Jest
+    if (typeof globalThis.jest !== 'undefined') {
+        return 'jest';
+    }
+    // Check for Vitest
+    if (typeof globalThis.__vitest__ !== 'undefined') {
+        return 'vitest';
+    }
+    // Check for Node test runner
+    if (typeof globalThis.describe === 'function' &&
+        typeof globalThis.test === 'function' &&
+        typeof globalThis.it === 'function') {
+        return 'node';
+    }
+    return 'unknown';
+}
+/**
+ * Create a Nexus test suite with automatic setup/teardown
+ *
+ * @example Jest/Vitest
+ * ```typescript
+ * import { createNexusTest } from 'nexus/testing';
+ * import { app } from './app';
+ *
+ * const { beforeAll, afterAll, beforeEach, getContext } = createNexusTest({
+ *   app,
+ *   mockDatabase: true,
+ *   setup: async () => {
+ *     // Seed test data
+ *     return { adminToken: 'test-admin-token' };
+ *   }
+ * });
+ *
+ * describe('Users API', () => {
+ *   beforeAll();
+ *   afterAll();
+ *   beforeEach();
+ *
+ *   test('should list users', async () => {
+ *     const { client, context } = getContext();
+ *
+ *     const res = await client.get('/users', {
+ *       headers: { Authorization: `Bearer ${context.adminToken}` }
+ *     });
+ *
+ *     expect(res.status).toBe(200);
+ *     expect(res.json().users).toBeArray();
+ *   });
+ * });
+ * ```
+ */
+function createNexusTest(config) {
+    const { app, setup, teardown, reset, mockDatabase = true, mockFetch: enableMockFetch = false, mockTimers: enableMockTimers = false, autoCleanup = true } = config;
+    const client = new harness_1.TestClient(app);
+    let setupContext = undefined;
+    let baseUrl = '';
+    // Context getter
+    const getContext = () => ({
+        client,
+        baseUrl,
+        db: mock_1.mockDb,
+        fetch: mock_1.mockFetch,
+        timers: mock_1.mockTimers,
+        context: setupContext
+    });
+    return {
+        /**
+         * Call this in beforeAll/before hook
+         */
+        beforeAll: () => async () => {
+            // Start test server
+            await client.start();
+            baseUrl = client.baseUrl;
+            // Install mocks
+            if (enableMockFetch) {
+                mock_1.mockFetch.install();
+            }
+            if (enableMockTimers) {
+                mock_1.mockTimers.install();
+            }
+            // Run custom setup
+            if (setup) {
+                setupContext = await setup();
+            }
+        },
+        /**
+         * Call this in afterAll/after hook
+         */
+        afterAll: () => async () => {
+            // Stop test server
+            await client.stop();
+            // Run custom teardown
+            if (teardown) {
+                await teardown(setupContext);
+            }
+            // Restore mocks
+            if (enableMockFetch) {
+                mock_1.mockFetch.restore();
+            }
+            if (enableMockTimers) {
+                mock_1.mockTimers.restore();
+            }
+        },
+        /**
+         * Call this in beforeEach hook
+         */
+        beforeEach: () => async () => {
+            // Reset mocks
+            if (autoCleanup) {
+                if (mockDatabase) {
+                    mock_1.mockDb.clear();
+                }
+                if (enableMockFetch) {
+                    mock_1.mockFetch.reset();
+                }
+            }
+            // Run custom reset
+            if (reset) {
+                await reset(setupContext);
+            }
+        },
+        /**
+         * Call this in afterEach hook (optional)
+         */
+        afterEach: () => async () => {
+            // Additional cleanup if needed
+        },
+        /**
+         * Get current test context
+         */
+        getContext,
+        /**
+         * Get the test client directly
+         */
+        getClient: () => client
+    };
+}
+/**
+ * Assertion helpers for Nexus testing
+ */
+exports.assertions = {
+    /**
+     * Assert response status
+     */
+    expectStatus(response, expected) {
+        if (response.status !== expected) {
+            throw new Error(`Expected status ${expected} but got ${response.status}`);
+        }
+    },
+    /**
+     * Assert response is JSON
+     */
+    expectJson(response) {
+        const contentType = response.headers['content-type'];
+        if (!contentType?.includes('application/json')) {
+            throw new Error(`Expected JSON content-type but got ${contentType}`);
+        }
+        return JSON.parse(response.body);
+    },
+    /**
+     * Assert response contains key
+     */
+    expectBodyHas(response, key) {
+        const body = JSON.parse(response.body);
+        if (!(key in body)) {
+            throw new Error(`Expected body to have key "${key}"`);
+        }
+    },
+    /**
+     * Assert response body equals
+     */
+    expectBodyEquals(response, expected) {
+        const body = JSON.parse(response.body);
+        const actual = JSON.stringify(body);
+        const exp = JSON.stringify(expected);
+        if (actual !== exp) {
+            throw new Error(`Body mismatch:\nExpected: ${exp}\nActual: ${actual}`);
+        }
+    },
+    /**
+     * Assert header exists
+     */
+    expectHeader(response, name, value) {
+        const headerValue = response.headers[name.toLowerCase()];
+        if (!headerValue) {
+            throw new Error(`Expected header "${name}" to exist`);
+        }
+        if (value !== undefined && headerValue !== value) {
+            throw new Error(`Expected header "${name}" to be "${value}" but got "${headerValue}"`);
+        }
+    },
+    /**
+     * Assert response time
+     */
+    expectFast(response, maxMs = 100) {
+        if (response.duration > maxMs) {
+            throw new Error(`Expected response within ${maxMs}ms but took ${response.duration}ms`);
+        }
+    }
+};
+/**
+ * Create authenticated test client
+ *
+ * @example
+ * ```typescript
+ * const adminClient = createAuthenticatedClient(app, {
+ *   token: 'admin-jwt-token',
+ *   headers: { 'X-Tenant-ID': 'test-tenant' }
+ * });
+ *
+ * const res = await adminClient.get('/admin/users');
+ * ```
+ */
+function createAuthenticatedClient(app, auth) {
+    const client = new harness_1.TestClient(app);
+    if (auth.token) {
+        client.authenticate(auth.token);
+    }
+    if (auth.headers) {
+        client.setDefaultHeaders(auth.headers);
+    }
+    return client;
+}
+/**
+ * Wait for condition with timeout
+ */
+async function waitForCondition(condition, options = {}) {
+    const { timeout = 5000, interval = 50, message = 'Condition not met' } = options;
+    const start = Date.now();
+    while (Date.now() - start < timeout) {
+        if (await condition()) {
+            return;
+        }
+        await new Promise(resolve => setTimeout(resolve, interval));
+    }
+    throw new Error(`${message} (timeout: ${timeout}ms)`);
+}
+/**
+ * Retry function with exponential backoff
+ */
+async function retryAsync(fn, options = {}) {
+    const { maxAttempts = 3, delay = 100, backoff = true } = options;
+    let lastError;
+    for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error;
+            if (attempt < maxAttempts) {
+                const waitTime = backoff ? delay * Math.pow(2, attempt - 1) : delay;
+                await new Promise(resolve => setTimeout(resolve, waitTime));
+            }
+        }
+    }
+    throw lastError;
+}
+/**
+ * Measure execution time of async function
+ */
+async function measureTime(fn) {
+    const start = Date.now();
+    const result = await fn();
+    const duration = Date.now() - start;
+    return { result, duration };
+}
+// Re-export everything
+__exportStar(require("./harness"), exports);
+__exportStar(require("./mock"), exports);
+__exportStar(require("./factory"), exports);
+__exportStar(require("./load-test"), exports);
+__exportStar(require("./mock-server"), exports);
+//# sourceMappingURL=index.js.map

package/dist/advanced/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/advanced/testing/index.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;;;;;;;;;;;;;AAcH,kDAmBC;AAyHD,0CA2GC;AAoFD,8DAmBC;AAKD,4CAeC;AAKD,gCAoBC;AAKD,kCAKC;AAhaD,uCAA0E;AAC1E,iCAA4F;AAO5F;;GAEG;AACH,SAAgB,mBAAmB;IAC/B,iBAAiB;IACjB,IAAI,OAAQ,UAAkB,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAClD,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,mBAAmB;IACnB,IAAI,OAAQ,UAAkB,CAAC,UAAU,KAAK,WAAW,EAAE,CAAC;QACxD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,6BAA6B;IAC7B,IAAI,OAAQ,UAAkB,CAAC,QAAQ,KAAK,UAAU;QAClD,OAAQ,UAAkB,CAAC,IAAI,KAAK,UAAU;QAC9C,OAAQ,UAAkB,CAAC,EAAE,KAAK,UAAU,EAAE,CAAC;QAC/C,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,OAAO,SAAS,CAAC;AACrB,CAAC;AAsFD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,SAAgB,eAAe,CAAW,MAA0B;IAChE,MAAM,EACF,GAAG,EACH,KAAK,EACL,QAAQ,EACR,KAAK,EACL,YAAY,GAAG,IAAI,EACnB,SAAS,EAAE,eAAe,GAAG,KAAK,EAClC,UAAU,EAAE,gBAAgB,GAAG,KAAK,EACpC,WAAW,GAAG,IAAI,EACrB,GAAG,MAAM,CAAC;IAEX,MAAM,MAAM,GAAG,IAAI,oBAAU,CAAC,GAAG,CAAC,CAAC;IACnC,IAAI,YAAY,GAAM,SAAc,CAAC;IACrC,IAAI,OAAO,GAAG,EAAE,CAAC;IAEjB,iBAAiB;IACjB,MAAM,UAAU,GAAG,GAAwB,EAAE,CAAC,CAAC;QAC3C,MAAM;QACN,OAAO;QACP,EAAE,EAAE,aAAM;QACV,KAAK,EAAE,gBAAS;QAChB,MAAM,EAAE,iBAAU;QAClB,OAAO,EAAE,YAAY;KACxB,CAAC,CAAC;IAEH,OAAO;QACH;;WAEG;QACH,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YACxB,oBAAoB;YACpB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACrB,OAAO,GAAI,MAAc,CAAC,OAAO,CAAC;YAElC,gBAAgB;YAChB,IAAI,eAAe,EAAE,CAAC;gBAClB,gBAAS,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;YACD,IAAI,gBAAgB,EAAE,CAAC;gBACnB,iBAAU,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;YAED,mBAAmB;YACnB,IAAI,KAAK,EAAE,CAAC;gBACR,YAAY,GAAG,MAAM,KAAK,EAAE,CAAC;YACjC,CAAC;QACL,CAAC;QAED;;WAEG;QACH,QAAQ,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YACvB,mBAAmB;YACnB,MAAM,MAAM,CAAC,IAAI,EAAE,CAAC;YAEpB,sBAAsB;YACtB,IAAI,QAAQ,EAAE,CAAC;gBACX,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC;YACjC,CAAC;YAED,gBAAgB;YAChB,IAAI,eAAe,EAAE,CAAC;gBAClB,gBAAS,CAAC,OAAO,EAAE,CAAC;YACxB,CAAC;YACD,IAAI,gBAAgB,EAAE,CAAC;gBACnB,iBAAU,CAAC,OAAO,EAAE,CAAC;YACzB,CAAC;QACL,CAAC;QAED;;WAEG;QACH,UAAU,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YACzB,cAAc;YACd,IAAI,WAAW,EAAE,CAAC;gBACd,IAAI,YAAY,EAAE,CAAC;oBACf,aAAM,CAAC,KAAK,EAAE,CAAC;gBACnB,CAAC;gBACD,IAAI,eAAe,EAAE,CAAC;oBAClB,gBAAS,CAAC,KAAK,EAAE,CAAC;gBACtB,CAAC;YACL,CAAC;YAED,mBAAmB;YACnB,IAAI,KAAK,EAAE,CAAC;gBACR,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;YAC9B,CAAC;QACL,CAAC;QAED;;WAEG;QACH,SAAS,EAAE,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE;YACxB,+BAA+B;QACnC,CAAC;QAED;;WAEG;QACH,UAAU;QAEV;;WAEG;QACH,SAAS,EAAE,GAAG,EAAE,CAAC,MAAM;KAC1B,CAAC;AACN,CAAC;AAED;;GAEG;AACU,QAAA,UAAU,GAAG;IACtB;;OAEG;IACH,YAAY,CAAC,QAA4B,EAAE,QAAgB;QACvD,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,YAAY,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9E,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAAwD;QAC/D,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACrD,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,sCAAsC,WAAW,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,QAA0B,EAAE,GAAW;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,CAAC,GAAG,IAAI,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,GAAG,CAAC,CAAC;QAC1D,CAAC;IACL,CAAC;IAED;;OAEG;IACH,gBAAgB,CAAC,QAA0B,EAAE,QAAa;QACtD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpC,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,MAAM,KAAK,GAAG,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,aAAa,MAAM,EAAE,CAAC,CAAC;QAC3E,CAAC;IACL,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,QAA0C,EAAE,IAAY,EAAE,KAAc;QACjF,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,WAAW,EAAE,CAAC;YACf,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,YAAY,CAAC,CAAC;QAC1D,CAAC;QACD,IAAI,KAAK,KAAK,SAAS,IAAI,WAAW,KAAK,KAAK,EAAE,CAAC;YAC/C,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,YAAY,KAAK,cAAc,WAAW,GAAG,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;IAED;;OAEG;IACH,UAAU,CAAC,QAA8B,EAAE,QAAgB,GAAG;QAC1D,IAAI,QAAQ,CAAC,QAAQ,GAAG,KAAK,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,4BAA4B,KAAK,eAAe,QAAQ,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC3F,CAAC;IACL,CAAC;CACJ,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,SAAgB,yBAAyB,CACrC,GAAgB,EAChB,IAIC;IAED,MAAM,MAAM,GAAG,IAAI,oBAAU,CAAC,GAAG,CAAC,CAAC;IAEnC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED,OAAO,MAAM,CAAC;AAClB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,gBAAgB,CAClC,SAA2C,EAC3C,UAAqE,EAAE;IAEvE,MAAM,EAAE,OAAO,GAAG,IAAI,EAAE,QAAQ,GAAG,EAAE,EAAE,OAAO,GAAG,mBAAmB,EAAE,GAAG,OAAO,CAAC;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAEzB,OAAO,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE,CAAC;QAClC,IAAI,MAAM,SAAS,EAAE,EAAE,CAAC;YACpB,OAAO;QACX,CAAC;QACD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;IAChE,CAAC;IAED,MAAM,IAAI,KAAK,CAAC,GAAG,OAAO,cAAc,OAAO,KAAK,CAAC,CAAC;AAC1D,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,UAAU,CAC5B,EAAoB,EACpB,UAAuE,EAAE;IAEzE,MAAM,EAAE,WAAW,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,EAAE,OAAO,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACjE,IAAI,SAA4B,CAAC;IAEjC,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,WAAW,EAAE,OAAO,EAAE,EAAE,CAAC;QACtD,IAAI,CAAC;YACD,OAAO,MAAM,EAAE,EAAE,CAAC;QACtB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,SAAS,GAAG,KAAc,CAAC;YAC3B,IAAI,OAAO,GAAG,WAAW,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;gBACpE,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;YAChE,CAAC;QACL,CAAC;IACL,CAAC;IAED,MAAM,SAAS,CAAC;AACpB,CAAC;AAED;;GAEG;AACI,KAAK,UAAU,WAAW,CAAI,EAAoB;IACrD,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACzB,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;IAC1B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK,CAAC;IACpC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;AAChC,CAAC;AAED,uBAAuB;AACvB,4CAA0B;AAC1B,yCAAuB;AACvB,4CAA0B;AAC1B,8CAA4B;AAC5B,gDAA8B"}

package/dist/advanced/testing/load-test.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Load testing utilities for stress testing APIs
+ */
+import { EventEmitter } from 'events';
+export interface LoadTestScenario {
+    name: string;
+    executor: 'constant-vus' | 'ramping-vus' | 'constant-rate' | 'ramping-rate';
+    vus?: number;
+    duration: string;
+    startVUs?: number;
+    stages?: Array<{
+        duration: string;
+        target: number;
+    }>;
+    rate?: number;
+    exec: string;
+}
+export interface LoadTestThresholds {
+    [metric: string]: string[];
+}
+export interface LoadTestOptions {
+    baseUrl: string;
+    duration?: string;
+    vus?: number;
+    scenarios?: Record<string, LoadTestScenario>;
+    thresholds?: LoadTestThresholds;
+    setupTimeout?: number;
+    teardownTimeout?: number;
+}
+export interface LoadTestResult {
+    totalRequests: number;
+    successfulRequests: number;
+    failedRequests: number;
+    duration: number;
+    requestsPerSecond: number;
+    latency: {
+        min: number;
+        max: number;
+        avg: number;
+        p50: number;
+        p90: number;
+        p95: number;
+        p99: number;
+    };
+    errorRate: number;
+    thresholdsPassed: boolean;
+    thresholdResults: Record<string, {
+        passed: boolean;
+        value: number;
+        threshold: string;
+    }>;
+    errors: Array<{
+        message: string;
+        count: number;
+    }>;
+}
+export interface VirtualUser {
+    id: number;
+    iteration: number;
+    data: Record<string, any>;
+}
+type TestFunction = (vu: VirtualUser, http: HttpClient) => Promise<void>;
+/**
+ * Simple HTTP client for load testing
+ */
+export declare class HttpClient {
+    private baseUrl;
+    private defaultHeaders;
+    private latencies;
+    private errors;
+    private successCount;
+    private failCount;
+    constructor(baseUrl: string);
+    setHeader(key: string, value: string): void;
+    get(path: string, options?: {
+        headers?: Record<string, string>;
+        timeout?: number;
+    }): Promise<HttpResponse>;
+    post(path: string, body?: any, options?: {
+        headers?: Record<string, string>;
+        timeout?: number;
+    }): Promise<HttpResponse>;
+    put(path: string, body?: any, options?: {
+        headers?: Record<string, string>;
+        timeout?: number;
+    }): Promise<HttpResponse>;
+    delete(path: string, options?: {
+        headers?: Record<string, string>;
+        timeout?: number;
+    }): Promise<HttpResponse>;
+    private request;
+    getStats(): {
+        latencies: number[];
+        errors: Map<string, number>;
+        successCount: number;
+        failCount: number;
+    };
+    reset(): void;
+}
+export interface HttpResponse {
+    status: number;
+    headers: Record<string, string | string[]>;
+    body: string;
+    latency: number;
+}
+/**
+ * Load test runner
+ */
+export declare class LoadTestRunner extends EventEmitter {
+    private options;
+    private tests;
+    private running;
+    private allLatencies;
+    private allErrors;
+    private totalSuccess;
+    private totalFail;
+    constructor(options: LoadTestOptions);
+    /**
+     * Register a test function
+     */
+    test(name: string, fn: TestFunction): this;
+    /**
+     * Run the load test
+     */
+    run(): Promise<LoadTestResult>;
+    /**
+     * Stop the test
+     */
+    stop(): void;
+    private runConstantVUs;
+    private runRampingVUs;
+    private runConstantRate;
+    private runVU;
+    private collectStats;
+    private calculateResults;
+    private evaluateThreshold;
+    private sleep;
+}
+/**
+ * Create a load test
+ */
+export declare function createLoadTest(options: LoadTestOptions): LoadTestRunner;
+/**
+ * Helper to format load test results
+ */
+export declare function formatLoadTestResults(results: LoadTestResult): string;
+export {};
+//# sourceMappingURL=load-test.d.ts.map