@stratix/testing 0.1.0

package/dist/TestApplication.js

@@ -0,0 +1,90 @@
+import { ApplicationBuilder } from '@stratix/runtime';
+import { AwilixContainer } from '@stratix/impl-di-awilix';
+import { ConsoleLogger } from '@stratix/impl-logger-console';
+import { LogLevel } 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 class TestApplication {
+    builder;
+    testContainer;
+    testLogger;
+    constructor() {
+        this.builder = ApplicationBuilder.create();
+    }
+    /**
+     * Create a new test application builder
+     */
+    static create() {
+        return new TestApplication();
+    }
+    /**
+     * Use in-memory defaults for testing
+     *
+     * Includes:
+     * - Awilix Container
+     * - Console Logger (error level only)
+     */
+    useInMemoryDefaults() {
+        this.testContainer = new AwilixContainer();
+        this.testLogger = new ConsoleLogger({ level: LogLevel.ERROR });
+        this.builder.useContainer(this.testContainer).useLogger(this.testLogger);
+        return this;
+    }
+    /**
+     * Set a custom container
+     */
+    useContainer(container) {
+        this.builder.useContainer(container);
+        return this;
+    }
+    /**
+     * Set a custom logger
+     */
+    useLogger(logger) {
+        this.builder.useLogger(logger);
+        return this;
+    }
+    /**
+     * Add a custom plugin
+     */
+    usePlugin(plugin, config) {
+        this.builder.usePlugin(plugin, config);
+        return this;
+    }
+    /**
+     * Build the application
+     */
+    async build() {
+        return await this.builder.build();
+    }
+}
+/**
+ * Create and start a test application
+ *
+ * @example
+ * ```typescript
+ * const app = await createTestApp();
+ * // Run tests
+ * await app.stop();
+ * ```
+ */
+export async function createTestApp() {
+    const app = await TestApplication.create().useInMemoryDefaults().build();
+    await app.start();
+    return app;
+}
+//# sourceMappingURL=TestApplication.js.map

package/dist/TestApplication.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TestApplication.js","sourceRoot":"","sources":["../src/TestApplication.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,eAAe;IAClB,OAAO,CAAqB;IAC5B,aAAa,CAAa;IAC1B,UAAU,CAAU;IAE5B;QACE,IAAI,CAAC,OAAO,GAAG,kBAAkB,CAAC,MAAM,EAAE,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,eAAe,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;OAMG;IACH,mBAAmB;QACjB,IAAI,CAAC,aAAa,GAAG,IAAI,eAAe,EAAE,CAAC;QAC3C,IAAI,CAAC,UAAU,GAAG,IAAI,aAAa,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;QAE/D,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QAEzE,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,SAAoB;QAC/B,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc;QACtB,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,MAAc,EAAE,MAAgB;QACxC,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,OAAO,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa;IACjC,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAK,EAAE,CAAC;IAEzE,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAElB,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/assertions.d.ts

@@ -0,0 +1,41 @@
+import type { AgentResult } from '@stratix/primitives';
+/**
+ * Assertion helpers for testing agents
+ */
+/**
+ * Asserts that the agent result is successful
+ */
+export declare function expectSuccess<T>(result: AgentResult<T>): asserts result is AgentResult<T> & {
+    data: T;
+};
+/**
+ * Asserts that the agent result is a failure
+ */
+export declare function expectFailure<T>(result: AgentResult<T>): asserts result is AgentResult<T> & {
+    error: Error;
+};
+/**
+ * Asserts that the result data matches the expected value
+ */
+export declare function expectData<T>(result: AgentResult<T>, expected: T): void;
+/**
+ * Asserts that the result data contains the expected subset
+ */
+export declare function expectDataContains<T extends Record<string, unknown>>(result: AgentResult<T>, expected: Partial<T>): void;
+/**
+ * Asserts that execution cost is within budget
+ */
+export declare function expectCostWithinBudget<T>(result: AgentResult<T>, budget: number): void;
+/**
+ * Asserts that execution duration is within limit
+ */
+export declare function expectDurationWithinLimit<T>(result: AgentResult<T>, maxDuration: number): void;
+/**
+ * Asserts that the error message contains the expected text
+ */
+export declare function expectErrorContains<T>(result: AgentResult<T>, expectedText: string): void;
+/**
+ * Asserts that the result uses the expected model
+ */
+export declare function expectModel<T>(result: AgentResult<T>, expectedModel: string): void;
+//# sourceMappingURL=assertions.d.ts.map

package/dist/assertions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertions.d.ts","sourceRoot":"","sources":["../src/assertions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,IAAI,EAAE,CAAC,CAAA;CAAE,CAIhD;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,GACrB,OAAO,CAAC,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG;IAAE,KAAK,EAAE,KAAK,CAAA;CAAE,CAIrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,CAQvE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,GACnB,IAAI,CAWN;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAMtF;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAU9F;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAWzF;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAMlF"}

package/dist/assertions.js

@@ -0,0 +1,82 @@
+/**
+ * Assertion helpers for testing agents
+ */
+/**
+ * Asserts that the agent result is successful
+ */
+export function expectSuccess(result) {
+    if (!result.isSuccess()) {
+        throw new Error(`Expected success but got failure: ${result.error?.message}`);
+    }
+}
+/**
+ * Asserts that the agent result is a failure
+ */
+export function expectFailure(result) {
+    if (!result.isFailure()) {
+        throw new Error('Expected failure but got success');
+    }
+}
+/**
+ * Asserts that the result data matches the expected value
+ */
+export function expectData(result, expected) {
+    expectSuccess(result);
+    if (JSON.stringify(result.data) !== JSON.stringify(expected)) {
+        throw new Error(`Expected data ${JSON.stringify(expected)} but got ${JSON.stringify(result.data)}`);
+    }
+}
+/**
+ * Asserts that the result data contains the expected subset
+ */
+export function expectDataContains(result, expected) {
+    expectSuccess(result);
+    for (const [key, value] of Object.entries(expected)) {
+        const actualValue = result.data[key];
+        if (JSON.stringify(actualValue) !== JSON.stringify(value)) {
+            throw new Error(`Expected ${key} to be ${JSON.stringify(value)} but got ${JSON.stringify(actualValue)}`);
+        }
+    }
+}
+/**
+ * Asserts that execution cost is within budget
+ */
+export function expectCostWithinBudget(result, budget) {
+    const cost = result.metadata.cost || 0;
+    if (cost > budget) {
+        throw new Error(`Cost $${cost.toFixed(4)} exceeds budget $${budget.toFixed(4)}`);
+    }
+}
+/**
+ * Asserts that execution duration is within limit
+ */
+export function expectDurationWithinLimit(result, maxDuration) {
+    const duration = result.metadata.duration;
+    if (duration === undefined) {
+        throw new Error('Duration metadata is not available');
+    }
+    if (duration > maxDuration) {
+        throw new Error(`Duration ${duration}ms exceeds limit ${maxDuration}ms`);
+    }
+}
+/**
+ * Asserts that the error message contains the expected text
+ */
+export function expectErrorContains(result, expectedText) {
+    expectFailure(result);
+    const errorMessage = result.error.message.toLowerCase();
+    const searchText = expectedText.toLowerCase();
+    if (!errorMessage.includes(searchText)) {
+        throw new Error(`Expected error message to contain "${expectedText}" but got "${result.error.message}"`);
+    }
+}
+/**
+ * Asserts that the result uses the expected model
+ */
+export function expectModel(result, expectedModel) {
+    const actualModel = result.metadata.model;
+    if (actualModel !== expectedModel) {
+        throw new Error(`Expected model "${expectedModel}" but got "${actualModel}"`);
+    }
+}
+//# sourceMappingURL=assertions.js.map

package/dist/assertions.js.map

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

package/dist/builders/EntityBuilder.d.ts

@@ -0,0 +1,47 @@
+import { Entity } from '@stratix/primitives';
+/**
+ * Generic Entity Builder for testing
+ *
+ * Provides a fluent API for building test entities.
+ *
+ * @example
+ * ```typescript
+ * const user = new EntityBuilder(User)
+ *   .withProps({ email: 'test@example.com', name: 'Test' })
+ *   .build();
+ * ```
+ */
+export declare class EntityBuilder<E extends Entity<any>> {
+    private readonly EntityClass;
+    private props;
+    private id?;
+    constructor(EntityClass: new (props: any, id: any) => E);
+    /**
+     * Set entity properties
+     */
+    withProps(props: Partial<any>): this;
+    /**
+     * Set entity ID
+     */
+    withId(id: any): this;
+    /**
+     * Build the entity
+     */
+    build(): E;
+    /**
+     * Build multiple entities
+     */
+    buildMany(count: number): E[];
+}
+/**
+ * Create an entity builder
+ *
+ * @example
+ * ```typescript
+ * const user = entityBuilder(User)
+ *   .withProps({ email: 'test@example.com' })
+ *   .build();
+ * ```
+ */
+export declare function entityBuilder<E extends Entity<any>>(EntityClass: new (props: any, id: any) => E): EntityBuilder<E>;
+//# sourceMappingURL=EntityBuilder.d.ts.map

package/dist/builders/EntityBuilder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityBuilder.d.ts","sourceRoot":"","sources":["../../src/builders/EntityBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAY,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,qBAAa,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC;IAIlC,OAAO,CAAC,QAAQ,CAAC,WAAW;IAHxC,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,EAAE,CAAC,CAAM;gBAEY,WAAW,EAAE,KAAK,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC;IAExE;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG,IAAI;IAKpC;;OAEG;IACH,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,IAAI;IAKrB;;OAEG;IACH,KAAK,IAAI,CAAC;IAQV;;OAEG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE;CAS9B;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,MAAM,CAAC,GAAG,CAAC,EACjD,WAAW,EAAE,KAAK,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,KAAK,CAAC,GAC1C,aAAa,CAAC,CAAC,CAAC,CAElB"}

package/dist/builders/EntityBuilder.js

@@ -0,0 +1,68 @@
+import { EntityId } from '@stratix/primitives';
+/**
+ * Generic Entity Builder for testing
+ *
+ * Provides a fluent API for building test entities.
+ *
+ * @example
+ * ```typescript
+ * const user = new EntityBuilder(User)
+ *   .withProps({ email: 'test@example.com', name: 'Test' })
+ *   .build();
+ * ```
+ */
+export class EntityBuilder {
+    EntityClass;
+    props = {};
+    id;
+    constructor(EntityClass) {
+        this.EntityClass = EntityClass;
+    }
+    /**
+     * Set entity properties
+     */
+    withProps(props) {
+        this.props = { ...this.props, ...props };
+        return this;
+    }
+    /**
+     * Set entity ID
+     */
+    withId(id) {
+        this.id = id;
+        return this;
+    }
+    /**
+     * Build the entity
+     */
+    build() {
+        if (!this.id) {
+            this.id = EntityId.create();
+        }
+        return new this.EntityClass(this.props, this.id);
+    }
+    /**
+     * Build multiple entities
+     */
+    buildMany(count) {
+        const entities = [];
+        for (let i = 0; i < count; i++) {
+            entities.push(this.build());
+        }
+        return entities;
+    }
+}
+/**
+ * Create an entity builder
+ *
+ * @example
+ * ```typescript
+ * const user = entityBuilder(User)
+ *   .withProps({ email: 'test@example.com' })
+ *   .build();
+ * ```
+ */
+export function entityBuilder(EntityClass) {
+    return new EntityBuilder(EntityClass);
+}
+//# sourceMappingURL=EntityBuilder.js.map

package/dist/builders/EntityBuilder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityBuilder.js","sourceRoot":"","sources":["../../src/builders/EntityBuilder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,aAAa;IAIK;IAHrB,KAAK,GAAQ,EAAE,CAAC;IAChB,EAAE,CAAO;IAEjB,YAA6B,WAA2C;QAA3C,gBAAW,GAAX,WAAW,CAAgC;IAAG,CAAC;IAE5E;;OAEG;IACH,SAAS,CAAC,KAAmB;QAC3B,IAAI,CAAC,KAAK,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,KAAK,EAAE,CAAC;QACzC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAO;QACZ,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,IAAI,CAAC,EAAE,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC9B,CAAC;QAED,OAAO,IAAI,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACH,SAAS,CAAC,KAAa;QACrB,MAAM,QAAQ,GAAQ,EAAE,CAAC;QAEzB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;YAC/B,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9B,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;CACF;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,WAA2C;IAE3C,OAAO,IAAI,aAAa,CAAC,WAAW,CAAC,CAAC;AACxC,CAAC"}

package/dist/factories/DataFactory.d.ts

@@ -0,0 +1,42 @@
+import { Email, EntityId } from '@stratix/primitives';
+/**
+ * Data Factory for generating test data
+ *
+ * Provides helper methods for creating common test data.
+ */
+export declare class DataFactory {
+    private static counter;
+    /**
+     * Generate a unique email
+     */
+    static email(prefix?: string): Email;
+    /**
+     * Generate a unique string
+     */
+    static string(prefix?: string): string;
+    /**
+     * Generate a unique number
+     */
+    static number(min?: number, max?: number): number;
+    /**
+     * Generate a unique entity ID
+     */
+    static entityId<T extends string>(): EntityId<T>;
+    /**
+     * Generate a random boolean
+     */
+    static boolean(): boolean;
+    /**
+     * Generate a random date
+     */
+    static date(daysAgo?: number): Date;
+    /**
+     * Pick a random element from an array
+     */
+    static pick<T>(array: T[]): T;
+    /**
+     * Reset the counter
+     */
+    static reset(): void;
+}
+//# sourceMappingURL=DataFactory.d.ts.map

package/dist/factories/DataFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataFactory.d.ts","sourceRoot":"","sources":["../../src/factories/DataFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAK;IAE3B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,SAAS,GAAG,KAAK;IASpC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,SAAS,GAAG,MAAM;IAKtC;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,SAAI,EAAE,GAAG,SAAO,GAAG,MAAM;IAI1C;;OAEG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,SAAS,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC;IAIhD;;OAEG;IACH,MAAM,CAAC,OAAO,IAAI,OAAO;IAIzB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,SAAI,GAAG,IAAI;IAM9B;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC;IAI7B;;OAEG;IACH,MAAM,CAAC,KAAK,IAAI,IAAI;CAGrB"}

package/dist/factories/DataFactory.js

@@ -0,0 +1,66 @@
+import { Email, EntityId } from '@stratix/primitives';
+/**
+ * Data Factory for generating test data
+ *
+ * Provides helper methods for creating common test data.
+ */
+export class DataFactory {
+    static counter = 0;
+    /**
+     * Generate a unique email
+     */
+    static email(prefix = 'test') {
+        this.counter++;
+        const result = Email.create(`${prefix}${this.counter}@example.com`);
+        if (!result.isSuccess) {
+            throw new Error('Failed to create email');
+        }
+        return result.value;
+    }
+    /**
+     * Generate a unique string
+     */
+    static string(prefix = 'test') {
+        this.counter++;
+        return `${prefix}${this.counter}`;
+    }
+    /**
+     * Generate a unique number
+     */
+    static number(min = 0, max = 1000) {
+        return Math.floor(Math.random() * (max - min + 1)) + min;
+    }
+    /**
+     * Generate a unique entity ID
+     */
+    static entityId() {
+        return EntityId.create();
+    }
+    /**
+     * Generate a random boolean
+     */
+    static boolean() {
+        return Math.random() > 0.5;
+    }
+    /**
+     * Generate a random date
+     */
+    static date(daysAgo = 0) {
+        const date = new Date();
+        date.setDate(date.getDate() - daysAgo);
+        return date;
+    }
+    /**
+     * Pick a random element from an array
+     */
+    static pick(array) {
+        return array[Math.floor(Math.random() * array.length)];
+    }
+    /**
+     * Reset the counter
+     */
+    static reset() {
+        this.counter = 0;
+    }
+}
+//# sourceMappingURL=DataFactory.js.map

package/dist/factories/DataFactory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"DataFactory.js","sourceRoot":"","sources":["../../src/factories/DataFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,OAAO,WAAW;IACd,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC;IAE3B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM;QAC1B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,cAAc,CAAC,CAAC;QACpE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,OAAO,MAAM,CAAC,KAAK,CAAC;IACtB,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM;QAC3B,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,OAAO,GAAG,MAAM,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,IAAI;QAC/B,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,QAAQ;QACb,OAAO,QAAQ,CAAC,MAAM,EAAK,CAAC;IAC9B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,OAAO;QACZ,OAAO,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC;QACrB,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,IAAI,CAAI,KAAU;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAK;QACV,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { TestApplication, createTestApp } from './TestApplication.js';
+export { EntityBuilder, entityBuilder } from './builders/EntityBuilder.js';
+export { DataFactory } from './factories/DataFactory.js';
+export { assertSuccess, assertFailure, unwrapSuccess, unwrapFailure } from './utils/assertions.js';
+export { MockLLMProvider } from './MockLLMProvider.js';
+export type { MockResponse } from './MockLLMProvider.js';
+export { AgentTester } from './AgentTester.js';
+export type { TestOptions, TestResult } from './AgentTester.js';
+export { expectSuccess, expectFailure, expectData, expectDataContains, expectCostWithinBudget, expectDurationWithinLimit, expectErrorContains, expectModel, } from './assertions.js';
+export { createTestContext, createTestAgentId, createDeterministicAgentId, wait, repeatTest, runInParallel, createTimeout, expectToReject, measureTime, } from './testHelpers.js';
+//# 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":"AACA,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGnG,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,YAAY,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGhE,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,IAAI,EACJ,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// Legacy testing utilities
+export { TestApplication, createTestApp } from './TestApplication.js';
+export { EntityBuilder, entityBuilder } from './builders/EntityBuilder.js';
+export { DataFactory } from './factories/DataFactory.js';
+export { assertSuccess, assertFailure, unwrapSuccess, unwrapFailure } from './utils/assertions.js';
+// AI Agent testing utilities
+export { MockLLMProvider } from './MockLLMProvider.js';
+export { AgentTester } from './AgentTester.js';
+// Agent-specific assertions
+export { expectSuccess, expectFailure, expectData, expectDataContains, expectCostWithinBudget, expectDurationWithinLimit, expectErrorContains, expectModel, } from './assertions.js';
+// Test helpers
+export { createTestContext, createTestAgentId, createDeterministicAgentId, wait, repeatTest, runInParallel, createTimeout, expectToReject, measureTime, } from './testHelpers.js';
+//# 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,2BAA2B;AAC3B,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACtE,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnG,6BAA6B;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAGvD,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAG/C,4BAA4B;AAC5B,OAAO,EACL,aAAa,EACb,aAAa,EACb,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACtB,yBAAyB,EACzB,mBAAmB,EACnB,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,eAAe;AACf,OAAO,EACL,iBAAiB,EACjB,iBAAiB,EACjB,0BAA0B,EAC1B,IAAI,EACJ,UAAU,EACV,aAAa,EACb,aAAa,EACb,cAAc,EACd,WAAW,GACZ,MAAM,kBAAkB,CAAC"}

package/dist/testHelpers.d.ts

@@ -0,0 +1,51 @@
+import { AgentContext } from '@stratix/primitives';
+import type { AgentId } from '@stratix/primitives';
+/**
+ * Helper functions for creating test data
+ */
+/**
+ * Creates a test AgentContext with default values
+ */
+export declare function createTestContext(overrides?: Partial<{
+    userId: string;
+    sessionId: string;
+    environment: 'development' | 'staging' | 'production';
+    metadata: Record<string, unknown>;
+    budget: number;
+}>): AgentContext;
+/**
+ * Creates a test AgentId
+ */
+export declare function createTestAgentId(): AgentId;
+/**
+ * Waits for a specified duration (for testing delays)
+ */
+export declare function wait(ms: number): Promise<void>;
+/**
+ * Creates a deterministic AgentId for testing (using a seed)
+ */
+export declare function createDeterministicAgentId(_seed: string): AgentId;
+/**
+ * Repeats a test function N times
+ */
+export declare function repeatTest<T>(times: number, testFn: (iteration: number) => Promise<T>): Promise<T[]>;
+/**
+ * Runs tests in parallel
+ */
+export declare function runInParallel<T>(testFns: Array<() => Promise<T>>): Promise<T[]>;
+/**
+ * Creates a timeout promise for testing
+ */
+export declare function createTimeout(ms: number, message?: string): Promise<never>;
+/**
+ * Asserts that a promise rejects with a specific error
+ */
+export declare function expectToReject(promise: Promise<unknown>, expectedError?: string | RegExp): Promise<void>;
+/**
+ * Measures execution time of an async function
+ */
+export declare function measureTime<T>(fn: () => Promise<T>): Promise<{
+    result: T;
+    duration: number;
+}>;
+//# sourceMappingURL=testHelpers.d.ts.map

package/dist/testHelpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testHelpers.d.ts","sourceRoot":"","sources":["../src/testHelpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAY,MAAM,qBAAqB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,SAAS,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,aAAa,GAAG,SAAS,GAAG,YAAY,CAAC;IACtD,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC,GACD,YAAY,CAad;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,OAAO,CAE3C;AAED;;GAEG;AACH,wBAAgB,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKjE;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,CAAC,EAChC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,CAAC,GACxC,OAAO,CAAC,CAAC,EAAE,CAAC,CAQd;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAErF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAM1E;AAED;;GAEG;AACH,wBAAsB,cAAc,CAClC,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,EACzB,aAAa,CAAC,EAAE,MAAM,GAAG,MAAM,GAC9B,OAAO,CAAC,IAAI,CAAC,CAmBf;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,CAAC,EACjC,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GACnB,OAAO,CAAC;IAAE,MAAM,EAAE,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAM1C"}

package/dist/testHelpers.js

@@ -0,0 +1,100 @@
+import { AgentContext, EntityId } from '@stratix/primitives';
+/**
+ * Helper functions for creating test data
+ */
+/**
+ * Creates a test AgentContext with default values
+ */
+export function createTestContext(overrides) {
+    const context = new AgentContext({
+        userId: overrides?.userId || 'test-user',
+        sessionId: overrides?.sessionId || 'test-session',
+        environment: overrides?.environment || 'development',
+        metadata: overrides?.metadata,
+    });
+    if (overrides?.budget !== undefined) {
+        context.setBudget(overrides.budget);
+    }
+    return context;
+}
+/**
+ * Creates a test AgentId
+ */
+export function createTestAgentId() {
+    return EntityId.create();
+}
+/**
+ * Waits for a specified duration (for testing delays)
+ */
+export function wait(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Creates a deterministic AgentId for testing (using a seed)
+ */
+export function createDeterministicAgentId(_seed) {
+    // This creates a reproducible ID based on the seed
+    // In real tests, you might want actual deterministic UUIDs
+    // TODO: Implement actual deterministic UUID generation based on seed
+    return EntityId.create();
+}
+/**
+ * Repeats a test function N times
+ */
+export async function repeatTest(times, testFn) {
+    const results = [];
+    for (let i = 0; i < times; i++) {
+        results.push(await testFn(i));
+    }
+    return results;
+}
+/**
+ * Runs tests in parallel
+ */
+export async function runInParallel(testFns) {
+    return Promise.all(testFns.map((fn) => fn()));
+}
+/**
+ * Creates a timeout promise for testing
+ */
+export function createTimeout(ms, message) {
+    return new Promise((_, reject) => {
+        setTimeout(() => {
+            reject(new Error(message || `Timeout after ${ms}ms`));
+        }, ms);
+    });
+}
+/**
+ * Asserts that a promise rejects with a specific error
+ */
+export async function expectToReject(promise, expectedError) {
+    try {
+        await promise;
+        throw new Error('Expected promise to reject but it resolved');
+    }
+    catch (error) {
+        if (expectedError) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (typeof expectedError === 'string') {
+                if (!message.includes(expectedError)) {
+                    throw new Error(`Expected error to include "${expectedError}" but got "${message}"`);
+                }
+            }
+            else {
+                if (!expectedError.test(message)) {
+                    throw new Error(`Expected error to match ${expectedError} but got "${message}"`);
+                }
+            }
+        }
+    }
+}
+/**
+ * Measures execution time of an async function
+ */
+export async function measureTime(fn) {
+    const start = Date.now();
+    const result = await fn();
+    const duration = Date.now() - start;
+    return { result, duration };
+}
+//# sourceMappingURL=testHelpers.js.map