@stratix/testing 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 P. Andrés Carvajal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,36 @@
+# @stratix/testing
+
+Test utilities for Stratix applications.
+
+## Installation
+
+```bash
+pnpm add -D @stratix/testing
+```
+
+## Features
+
+- **MockLLMProvider** - Deterministic LLM responses
+- **InMemoryEventBus** - Event bus for testing
+- **TestContainer** - DI container for tests
+- Helper functions for test entities
+
+## Quick Example
+
+```typescript
+import { MockLLMProvider } from '@stratix/testing';
+
+const mockProvider = new MockLLMProvider({
+  responses: ['Mocked response'],
+  cost: 0.001
+});
+
+const agent = new MyAgent(mockProvider);
+const result = await agent.execute(input);
+
+// No API calls, deterministic results, zero cost
+```
+
+## License
+
+MIT

package/dist/AgentTester.d.ts

@@ -0,0 +1,120 @@
+import type { AIAgent, AgentResult, AgentContext } from '@stratix/primitives';
+import { MockLLMProvider } from './MockLLMProvider.js';
+/**
+ * Test configuration options
+ */
+export interface TestOptions {
+    /**
+     * Maximum execution time before timing out (ms)
+     */
+    timeout?: number;
+    /**
+     * Whether to capture execution traces
+     */
+    enableTracing?: boolean;
+    /**
+     * Mock LLM provider to use
+     */
+    mockProvider?: MockLLMProvider;
+}
+/**
+ * Test result with additional metadata
+ */
+export interface TestResult<TOutput> {
+    /**
+     * The agent result
+     */
+    result: AgentResult<TOutput>;
+    /**
+     * Execution duration in milliseconds
+     */
+    duration: number;
+    /**
+     * Whether the test passed
+     */
+    passed: boolean;
+    /**
+     * Error message if test failed
+     */
+    error?: string;
+}
+/**
+ * Agent tester utility for testing AI agents with deterministic responses.
+ *
+ * @example
+ * ```typescript
+ * import { AgentTester } from '@stratix/testing';
+ *
+ * describe('MyAgent', () => {
+ *   let tester: AgentTester;
+ *
+ *   beforeEach(() => {
+ *     tester = new AgentTester();
+ *   });
+ *
+ *   it('should process input correctly', async () => {
+ *     const agent = new MyAgent(...);
+ *
+ *     tester.setMockResponse({
+ *       content: '{"result": "success"}',
+ *       usage: { promptTokens: 10, completionTokens: 20, totalTokens: 30 }
+ *     });
+ *
+ *     const result = await tester.test(agent, input);
+ *
+ *     expect(result.passed).toBe(true);
+ *     expect(result.result.isSuccess()).toBe(true);
+ *   });
+ * });
+ * ```
+ */
+export declare class AgentTester {
+    private mockProvider;
+    private options;
+    constructor(options?: TestOptions);
+    /**
+     * Gets the mock LLM provider
+     */
+    getMockProvider(): MockLLMProvider;
+    /**
+     * Sets a single mock response
+     */
+    setMockResponse(response: Parameters<MockLLMProvider['setResponse']>[0]): void;
+    /**
+     * Sets multiple mock responses
+     */
+    setMockResponses(responses: Parameters<MockLLMProvider['setResponses']>[0]): void;
+    /**
+     * Tests an agent with the given input
+     */
+    test<TInput, TOutput>(agent: AIAgent<TInput, TOutput>, input: TInput, context?: AgentContext): Promise<TestResult<TOutput>>;
+    /**
+     * Executes agent with timeout
+     */
+    private executeWithTimeout;
+    /**
+     * Asserts that the result is successful
+     */
+    assertSuccess<TOutput>(result: TestResult<TOutput>): asserts result is TestResult<TOutput> & {
+        passed: true;
+    };
+    /**
+     * Asserts that the result is a failure
+     */
+    assertFailure<TOutput>(result: TestResult<TOutput>): asserts result is TestResult<TOutput> & {
+        passed: false;
+    };
+    /**
+     * Asserts that execution time is within limits
+     */
+    assertDuration<TOutput>(result: TestResult<TOutput>, maxDuration: number): void;
+    /**
+     * Asserts that the mock provider was called N times
+     */
+    assertCallCount(expectedCount: number): void;
+    /**
+     * Resets the tester state
+     */
+    reset(): void;
+}
+//# sourceMappingURL=AgentTester.d.ts.map

package/dist/AgentTester.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentTester.d.ts","sourceRoot":"","sources":["../src/AgentTester.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,YAAY,CAAC,EAAE,eAAe,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,OAAO;IACjC;;OAEG;IACH,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAE7B;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,YAAY,CAAkB;IACtC,OAAO,CAAC,OAAO,CAAc;gBAEjB,OAAO,GAAE,WAAgB;IAUrC;;OAEG;IACH,eAAe,IAAI,eAAe;IAIlC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,UAAU,CAAC,eAAe,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAI9E;;OAEG;IACH,gBAAgB,CAAC,SAAS,EAAE,UAAU,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI;IAIjF;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,OAAO,EACxB,KAAK,EAAE,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,YAAY,GACrB,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;IAuC/B;;OAEG;YACW,kBAAkB;IAiBhC;;OAEG;IACH,aAAa,CAAC,OAAO,EACnB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG;QAAE,MAAM,EAAE,IAAI,CAAA;KAAE;IAM3D;;OAEG;IACH,aAAa,CAAC,OAAO,EACnB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,GAC1B,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,CAAC,GAAG;QAAE,MAAM,EAAE,KAAK,CAAA;KAAE;IAM5D;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAM/E;;OAEG;IACH,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI;IAO5C;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/AgentTester.js

@@ -0,0 +1,152 @@
+import { MockLLMProvider } from './MockLLMProvider.js';
+/**
+ * Agent tester utility for testing AI agents with deterministic responses.
+ *
+ * @example
+ * ```typescript
+ * import { AgentTester } from '@stratix/testing';
+ *
+ * describe('MyAgent', () => {
+ *   let tester: AgentTester;
+ *
+ *   beforeEach(() => {
+ *     tester = new AgentTester();
+ *   });
+ *
+ *   it('should process input correctly', async () => {
+ *     const agent = new MyAgent(...);
+ *
+ *     tester.setMockResponse({
+ *       content: '{"result": "success"}',
+ *       usage: { promptTokens: 10, completionTokens: 20, totalTokens: 30 }
+ *     });
+ *
+ *     const result = await tester.test(agent, input);
+ *
+ *     expect(result.passed).toBe(true);
+ *     expect(result.result.isSuccess()).toBe(true);
+ *   });
+ * });
+ * ```
+ */
+export class AgentTester {
+    mockProvider;
+    options;
+    constructor(options = {}) {
+        this.options = {
+            timeout: 30000,
+            enableTracing: true,
+            ...options,
+        };
+        this.mockProvider = options.mockProvider || new MockLLMProvider();
+    }
+    /**
+     * Gets the mock LLM provider
+     */
+    getMockProvider() {
+        return this.mockProvider;
+    }
+    /**
+     * Sets a single mock response
+     */
+    setMockResponse(response) {
+        this.mockProvider.setResponse(response);
+    }
+    /**
+     * Sets multiple mock responses
+     */
+    setMockResponses(responses) {
+        this.mockProvider.setResponses(responses);
+    }
+    /**
+     * Tests an agent with the given input
+     */
+    async test(agent, input, context) {
+        const startTime = Date.now();
+        let result;
+        let error;
+        let passed = false;
+        try {
+            // Execute with timeout
+            result = await this.executeWithTimeout(agent, input, context);
+            // Check if successful
+            passed = result.isSuccess();
+            if (!passed) {
+                error = result.error?.message || 'Unknown error';
+            }
+        }
+        catch (err) {
+            result = {
+                success: false,
+                error: err instanceof Error ? err : new Error(String(err)),
+                data: undefined,
+                metadata: {
+                    model: 'unknown',
+                    duration: Date.now() - startTime,
+                },
+            };
+            error = err instanceof Error ? err.message : String(err);
+        }
+        const duration = Date.now() - startTime;
+        return {
+            result,
+            duration,
+            passed,
+            error,
+        };
+    }
+    /**
+     * Executes agent with timeout
+     */
+    async executeWithTimeout(agent, input, _context) {
+        const timeout = this.options.timeout;
+        return Promise.race([
+            agent.execute(input),
+            new Promise((_, reject) => {
+                setTimeout(() => {
+                    reject(new Error(`Test timeout after ${timeout}ms`));
+                }, timeout);
+            }),
+        ]);
+    }
+    /**
+     * Asserts that the result is successful
+     */
+    assertSuccess(result) {
+        if (!result.passed) {
+            throw new Error(`Expected success but got failure: ${result.error}`);
+        }
+    }
+    /**
+     * Asserts that the result is a failure
+     */
+    assertFailure(result) {
+        if (result.passed) {
+            throw new Error('Expected failure but got success');
+        }
+    }
+    /**
+     * Asserts that execution time is within limits
+     */
+    assertDuration(result, maxDuration) {
+        if (result.duration > maxDuration) {
+            throw new Error(`Expected duration <= ${maxDuration}ms but got ${result.duration}ms`);
+        }
+    }
+    /**
+     * Asserts that the mock provider was called N times
+     */
+    assertCallCount(expectedCount) {
+        const actualCount = this.mockProvider.getCallCount();
+        if (actualCount !== expectedCount) {
+            throw new Error(`Expected ${expectedCount} calls but got ${actualCount}`);
+        }
+    }
+    /**
+     * Resets the tester state
+     */
+    reset() {
+        this.mockProvider.reset();
+    }
+}
+//# sourceMappingURL=AgentTester.js.map

package/dist/AgentTester.js.map

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

package/dist/MockLLMProvider.d.ts

@@ -0,0 +1,80 @@
+import type { LLMProvider, ChatParams, ChatResponse, ChatChunk, EmbeddingParams, EmbeddingResponse } from '@stratix/abstractions';
+/**
+ * Mock response configuration
+ */
+export interface MockResponse {
+    content: string;
+    usage?: {
+        promptTokens: number;
+        completionTokens: number;
+        totalTokens: number;
+    };
+    finishReason?: 'stop' | 'length' | 'tool_calls' | 'content_filter';
+    delay?: number;
+}
+/**
+ * Mock LLM Provider for testing AI agents without making actual API calls.
+ *
+ * @example
+ * ```typescript
+ * const mockProvider = new MockLLMProvider();
+ *
+ * // Set deterministic response
+ * mockProvider.setResponse({
+ *   content: '{"result": "success"}',
+ *   usage: { promptTokens: 10, completionTokens: 20, totalTokens: 30 }
+ * });
+ *
+ * // Use in tests
+ * const agent = new MyAgent({ provider: mockProvider });
+ * const result = await agent.execute(input);
+ * ```
+ */
+export declare class MockLLMProvider implements LLMProvider {
+    readonly name = "mock";
+    readonly models: string[];
+    private responses;
+    private currentResponseIndex;
+    private callHistory;
+    /**
+     * Sets a single response that will be returned for all calls
+     */
+    setResponse(response: MockResponse): void;
+    /**
+     * Sets multiple responses that will be returned in sequence
+     */
+    setResponses(responses: MockResponse[]): void;
+    /**
+     * Adds a response to the queue
+     */
+    addResponse(response: MockResponse): void;
+    /**
+     * Gets the call history for assertions
+     */
+    getCallHistory(): ReadonlyArray<ChatParams>;
+    /**
+     * Gets the last call made to the provider
+     */
+    getLastCall(): ChatParams | undefined;
+    /**
+     * Gets the number of calls made
+     */
+    getCallCount(): number;
+    /**
+     * Clears all responses and call history
+     */
+    reset(): void;
+    /**
+     * Implements chat method
+     */
+    chat(params: ChatParams): Promise<ChatResponse>;
+    /**
+     * Implements streamChat method
+     */
+    streamChat(params: ChatParams): AsyncIterable<ChatChunk>;
+    /**
+     * Implements embeddings method
+     */
+    embeddings(params: EmbeddingParams): Promise<EmbeddingResponse>;
+}
+//# sourceMappingURL=MockLLMProvider.d.ts.map

package/dist/MockLLMProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MockLLMProvider.d.ts","sourceRoot":"","sources":["../src/MockLLMProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,UAAU,EACV,YAAY,EACZ,SAAS,EACT,eAAe,EACf,iBAAiB,EAClB,MAAM,uBAAuB,CAAC;AAE/B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE;QACN,YAAY,EAAE,MAAM,CAAC;QACrB,gBAAgB,EAAE,MAAM,CAAC;QACzB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,YAAY,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,gBAAgB,CAAC;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,qBAAa,eAAgB,YAAW,WAAW;IACjD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,MAAM,WAAkB;IAEjC,OAAO,CAAC,SAAS,CAAsB;IACvC,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,WAAW,CAAoB;IAEvC;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAKzC;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,GAAG,IAAI;IAK7C;;OAEG;IACH,WAAW,CAAC,QAAQ,EAAE,YAAY,GAAG,IAAI;IAIzC;;OAEG;IACH,cAAc,IAAI,aAAa,CAAC,UAAU,CAAC;IAI3C;;OAEG;IACH,WAAW,IAAI,UAAU,GAAG,SAAS;IAIrC;;OAEG;IACH,YAAY,IAAI,MAAM;IAItB;;OAEG;IACH,KAAK,IAAI,IAAI;IAMb;;OAEG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IA8BrD;;OAEG;IACI,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,CAAC,SAAS,CAAC;IA+B/D;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAgBtE"}

package/dist/MockLLMProvider.js

@@ -0,0 +1,143 @@
+/**
+ * Mock LLM Provider for testing AI agents without making actual API calls.
+ *
+ * @example
+ * ```typescript
+ * const mockProvider = new MockLLMProvider();
+ *
+ * // Set deterministic response
+ * mockProvider.setResponse({
+ *   content: '{"result": "success"}',
+ *   usage: { promptTokens: 10, completionTokens: 20, totalTokens: 30 }
+ * });
+ *
+ * // Use in tests
+ * const agent = new MyAgent({ provider: mockProvider });
+ * const result = await agent.execute(input);
+ * ```
+ */
+export class MockLLMProvider {
+    name = 'mock';
+    models = ['mock-model'];
+    responses = [];
+    currentResponseIndex = 0;
+    callHistory = [];
+    /**
+     * Sets a single response that will be returned for all calls
+     */
+    setResponse(response) {
+        this.responses = [response];
+        this.currentResponseIndex = 0;
+    }
+    /**
+     * Sets multiple responses that will be returned in sequence
+     */
+    setResponses(responses) {
+        this.responses = responses;
+        this.currentResponseIndex = 0;
+    }
+    /**
+     * Adds a response to the queue
+     */
+    addResponse(response) {
+        this.responses.push(response);
+    }
+    /**
+     * Gets the call history for assertions
+     */
+    getCallHistory() {
+        return this.callHistory;
+    }
+    /**
+     * Gets the last call made to the provider
+     */
+    getLastCall() {
+        return this.callHistory[this.callHistory.length - 1];
+    }
+    /**
+     * Gets the number of calls made
+     */
+    getCallCount() {
+        return this.callHistory.length;
+    }
+    /**
+     * Clears all responses and call history
+     */
+    reset() {
+        this.responses = [];
+        this.currentResponseIndex = 0;
+        this.callHistory = [];
+    }
+    /**
+     * Implements chat method
+     */
+    async chat(params) {
+        this.callHistory.push(params);
+        if (this.responses.length === 0) {
+            throw new Error('No mock responses configured. Use setResponse() or setResponses()');
+        }
+        const response = this.responses[this.currentResponseIndex];
+        // Cycle through responses or stick to last one
+        if (this.currentResponseIndex < this.responses.length - 1) {
+            this.currentResponseIndex++;
+        }
+        // Simulate delay if specified
+        if (response.delay) {
+            await new Promise((resolve) => setTimeout(resolve, response.delay));
+        }
+        return {
+            content: response.content,
+            usage: response.usage || {
+                promptTokens: 10,
+                completionTokens: 10,
+                totalTokens: 20,
+            },
+            finishReason: response.finishReason || 'stop',
+        };
+    }
+    /**
+     * Implements streamChat method
+     */
+    async *streamChat(params) {
+        this.callHistory.push(params);
+        if (this.responses.length === 0) {
+            throw new Error('No mock responses configured');
+        }
+        const response = this.responses[this.currentResponseIndex];
+        if (this.currentResponseIndex < this.responses.length - 1) {
+            this.currentResponseIndex++;
+        }
+        // Split content into chunks
+        const words = response.content.split(' ');
+        const delayPerWord = response.delay !== undefined ? response.delay / words.length : 0;
+        for (let i = 0; i < words.length; i++) {
+            const chunk = {
+                content: words[i] + (i < words.length - 1 ? ' ' : ''),
+                isComplete: i === words.length - 1,
+            };
+            if (delayPerWord > 0) {
+                await new Promise((resolve) => setTimeout(resolve, delayPerWord));
+            }
+            yield chunk;
+        }
+    }
+    /**
+     * Implements embeddings method
+     */
+    async embeddings(params) {
+        const inputs = Array.isArray(params.input) ? params.input : [params.input];
+        const tokenCount = inputs.join(' ').split(' ').length;
+        return {
+            embeddings: inputs.map(() => {
+                // Generate fake embedding vector
+                return Array.from({ length: 1536 }, () => Math.random());
+            }),
+            usage: {
+                promptTokens: tokenCount,
+                completionTokens: 0,
+                totalTokens: tokenCount,
+            },
+        };
+    }
+}
+//# sourceMappingURL=MockLLMProvider.js.map

package/dist/MockLLMProvider.js.map

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

package/dist/TestApplication.d.ts

@@ -0,0 +1,64 @@
+import { Application } from '@stratix/runtime';
+import type { Plugin, Logger, Container } from '@stratix/abstractions';
+/**
+ * Test Application Builder
+ *
+ * Provides a simplified way to create test applications with in-memory implementations.
+ *
+ * @example
+ * ```typescript
+ * const app = await TestApplication.create()
+ *   .useInMemoryDefaults()
+ *   .build();
+ *
+ * await app.start();
+ * // Run tests
+ * await app.stop();
+ * ```
+ */
+export declare class TestApplication {
+    private builder;
+    private testContainer?;
+    private testLogger?;
+    private constructor();
+    /**
+     * Create a new test application builder
+     */
+    static create(): TestApplication;
+    /**
+     * Use in-memory defaults for testing
+     *
+     * Includes:
+     * - Awilix Container
+     * - Console Logger (error level only)
+     */
+    useInMemoryDefaults(): this;
+    /**
+     * Set a custom container
+     */
+    useContainer(container: Container): this;
+    /**
+     * Set a custom logger
+     */
+    useLogger(logger: Logger): this;
+    /**
+     * Add a custom plugin
+     */
+    usePlugin(plugin: Plugin, config?: unknown): this;
+    /**
+     * Build the application
+     */
+    build(): Promise<Application>;
+}
+/**
+ * Create and start a test application
+ *
+ * @example
+ * ```typescript
+ * const app = await createTestApp();
+ * // Run tests
+ * await app.stop();
+ * ```
+ */
+export declare function createTestApp(): Promise<Application>;
+//# sourceMappingURL=TestApplication.d.ts.map

package/dist/TestApplication.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestApplication.d.ts","sourceRoot":"","sources":["../src/TestApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAsB,MAAM,kBAAkB,CAAC;AAGnE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAGvE;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAqB;IACpC,OAAO,CAAC,aAAa,CAAC,CAAY;IAClC,OAAO,CAAC,UAAU,CAAC,CAAS;IAE5B,OAAO;IAIP;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,eAAe;IAIhC;;;;;;OAMG;IACH,mBAAmB,IAAI,IAAI;IAS3B;;OAEG;IACH,YAAY,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI;IAKxC;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;OAEG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,IAAI;IAKjD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;CAGpC;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,IAAI,OAAO,CAAC,WAAW,CAAC,CAM1D"}