ai.matey.testing 0.2.0

package/dist/types/fixture-helpers.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Fixture helpers - utilities for using fixtures in tests
+ */
+import type { IRChatRequest, IRChatResponse, IRStreamChunk } from 'ai.matey.types';
+import type { Fixture, ChatFixture, StreamingFixture } from './fixture-types.js';
+/**
+ * Simple mock backend from a fixture (for testing)
+ */
+export interface SimpleMockBackend {
+    readonly name: string;
+    chat(_request: IRChatRequest): Promise<IRChatResponse>;
+    chatStream?(_request: IRChatRequest): AsyncIterable<IRStreamChunk>;
+}
+/**
+ * Create a mock backend adapter from a fixture
+ */
+export declare function createMockFromFixture(fixture: Fixture): SimpleMockBackend;
+/**
+ * Replay streaming fixture with timing
+ */
+export declare function replayStreamWithTiming(fixture: StreamingFixture, options?: {
+    /** Delay between chunks in ms */
+    chunkDelay?: number;
+    /** Speed multiplier (1.0 = real-time, 2.0 = 2x speed, 0.5 = half speed) */
+    speedMultiplier?: number;
+}): AsyncIterable<IRStreamChunk>;
+/**
+ * Create multiple mocks from multiple fixtures
+ */
+export declare function createMocksFromFixtures(fixtures: Fixture[]): Map<string, SimpleMockBackend>;
+/**
+ * Check if a fixture is for streaming
+ */
+export declare function fixtureIsStreaming(fixture: Fixture): boolean;
+/**
+ * Validate that a response matches a fixture
+ */
+export declare function validateAgainstFixture(response: IRChatResponse, fixture: ChatFixture, options?: {
+    /** Check exact match (default: false) */
+    exact?: boolean;
+    /** Fields to ignore when comparing */
+    ignoreFields?: string[];
+}): boolean;
+/**
+ * Extract request from fixture (useful for replaying)
+ */
+export declare function extractRequest(fixture: Fixture): IRChatRequest;
+/**
+ * Extract response from fixture
+ */
+export declare function extractResponse(fixture: ChatFixture): IRChatResponse;
+/**
+ * Extract streaming chunks from fixture
+ */
+export declare function extractChunks(fixture: StreamingFixture): readonly IRStreamChunk[];
+/**
+ * Collect streaming chunks into a single response
+ */
+export declare function collectChunksToResponse(chunks: readonly IRStreamChunk[]): IRChatResponse;
+/**
+ * Create a test-friendly mock with custom responses
+ */
+export declare function createConfigurableMock(name: string, defaultResponse?: IRChatResponse): SimpleMockBackend & {
+    setResponse: (response: IRChatResponse) => void;
+    setStreamChunks: (chunks: IRStreamChunk[]) => void;
+    setError: (error: Error) => void;
+    reset: () => void;
+};
+//# sourceMappingURL=fixture-helpers.d.ts.map

package/dist/types/fixture-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-helpers.d.ts","sourceRoot":"","sources":["../../src/fixture-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnF,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGjF;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,IAAI,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACvD,UAAU,CAAC,CAAC,QAAQ,EAAE,aAAa,GAAG,aAAa,CAAC,aAAa,CAAC,CAAC;CACpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB,CAMzE;AAqCD;;GAEG;AACH,wBAAuB,sBAAsB,CAC3C,OAAO,EAAE,gBAAgB,EACzB,OAAO,CAAC,EAAE;IACR,iCAAiC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2EAA2E;IAC3E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,aAAa,CAAC,aAAa,CAAC,CAa9B;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAS3F;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAE5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,cAAc,EACxB,OAAO,EAAE,WAAW,EACpB,OAAO,CAAC,EAAE;IACR,yCAAyC;IACzC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,sCAAsC;IACtC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACA,OAAO,CA0BT;AA2CD;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,aAAa,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAEpE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,gBAAgB,GAAG,SAAS,aAAa,EAAE,CAEjF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,GAAG,cAAc,CA0BxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,MAAM,EACZ,eAAe,CAAC,EAAE,cAAc,GAC/B,iBAAiB,GAAG;IACrB,WAAW,EAAE,CAAC,QAAQ,EAAE,cAAc,KAAK,IAAI,CAAC;IAChD,eAAe,EAAE,CAAC,MAAM,EAAE,aAAa,EAAE,KAAK,IAAI,CAAC;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,MAAM,IAAI,CAAC;CACnB,CAsDA"}

package/dist/types/fixture-loader.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Fixture loader - loads fixtures from files
+ */
+import type { Fixture, FixtureQuery, FixtureCollection } from './fixture-types.js';
+/**
+ * Default fixtures directory (relative to project root)
+ */
+export declare const FIXTURES_DIR: string;
+/**
+ * Load a single fixture from file
+ */
+export declare function loadFixture(provider: string, scenario: string, options?: {
+    useCache?: boolean;
+}): Promise<Fixture>;
+/**
+ * Load all fixtures for a provider
+ */
+export declare function loadProviderFixtures(provider: string, options?: {
+    useCache?: boolean;
+}): Promise<Fixture[]>;
+/**
+ * Search fixtures by query
+ */
+export declare function findFixtures(query: FixtureQuery): Promise<Fixture[]>;
+/**
+ * Clear fixture cache
+ */
+export declare function clearFixtureCache(): void;
+/**
+ * Get cache statistics
+ */
+export declare function getFixtureCacheStats(): {
+    size: number;
+    keys: string[];
+};
+/**
+ * Load a fixture collection (multiple fixtures in one file)
+ */
+export declare function loadFixtureCollection(provider: string, collectionName: string): Promise<FixtureCollection>;
+//# sourceMappingURL=fixture-loader.d.ts.map

package/dist/types/fixture-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-loader.d.ts","sourceRoot":"","sources":["../../src/fixture-loader.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGnF;;GAEG;AACH,eAAO,MAAM,YAAY,QAAkC,CAAC;AAO5D;;GAEG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,CAAC,CAgClB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAE,GAC/B,OAAO,CAAC,OAAO,EAAE,CAAC,CAsBpB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,CA8D1E;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,CAKvE;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,MAAM,EAChB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,iBAAiB,CAAC,CAW5B"}

package/dist/types/fixture-types.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Type definitions for test fixtures
+ */
+import type { IRChatRequest, IRChatResponse, IRStreamChunk } from 'ai.matey.types';
+/**
+ * Fixture metadata
+ */
+export interface FixtureMetadata {
+    /** Provider name (e.g., "openai", "anthropic") */
+    readonly provider: string;
+    /** Scenario description (e.g., "basic-chat", "streaming-with-tools") */
+    readonly scenario: string;
+    /** API version used to capture this fixture */
+    readonly apiVersion?: string;
+    /** Model used in this fixture */
+    readonly model: string;
+    /** When this fixture was captured */
+    readonly capturedAt: string;
+    /** Description of what this fixture tests */
+    readonly description?: string;
+    /** Tags for categorization */
+    readonly tags?: readonly string[];
+}
+/**
+ * Non-streaming fixture
+ */
+export interface ChatFixture {
+    readonly metadata: FixtureMetadata;
+    readonly request: IRChatRequest;
+    readonly response: IRChatResponse;
+    readonly providerRequest?: unknown;
+    readonly providerResponse?: unknown;
+}
+/**
+ * Streaming fixture
+ */
+export interface StreamingFixture {
+    readonly metadata: FixtureMetadata;
+    readonly request: IRChatRequest;
+    readonly chunks: readonly IRStreamChunk[];
+    readonly finalResponse?: IRChatResponse;
+    readonly providerRequest?: unknown;
+    readonly providerStreamEvents?: readonly unknown[];
+}
+/**
+ * Combined fixture type
+ */
+export type Fixture = ChatFixture | StreamingFixture;
+/**
+ * Type guard for streaming fixtures
+ */
+export declare function isStreamingFixture(fixture: Fixture): fixture is StreamingFixture;
+/**
+ * Type guard for chat fixtures
+ */
+export declare function isChatFixture(fixture: Fixture): fixture is ChatFixture;
+/**
+ * Fixture collection (multiple fixtures grouped together)
+ */
+export interface FixtureCollection {
+    readonly provider: string;
+    readonly fixtures: readonly Fixture[];
+    readonly version: string;
+    readonly createdAt: string;
+}
+/**
+ * Fixture search criteria
+ */
+export interface FixtureQuery {
+    readonly provider?: string;
+    readonly scenario?: string;
+    readonly model?: string;
+    readonly tags?: readonly string[];
+    readonly streaming?: boolean;
+}
+//# sourceMappingURL=fixture-types.d.ts.map

package/dist/types/fixture-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture-types.d.ts","sourceRoot":"","sources":["../../src/fixture-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kDAAkD;IAClD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,wEAAwE;IACxE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAE7B,iCAAiC;IACjC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAEvB,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAE5B,6CAA6C;IAC7C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAE9B,8BAA8B;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,cAAc,CAAC;IACxC,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACpD;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG,WAAW,GAAG,gBAAgB,CAAC;AAErD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,gBAAgB,CAEhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,IAAI,WAAW,CAEtE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B"}

package/dist/types/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Testing utilities and fixtures
+ */
+export type { FixtureMetadata, ChatFixture, StreamingFixture, Fixture, FixtureCollection, FixtureQuery, } from './fixture-types.js';
+export { isChatFixture, isStreamingFixture } from './fixture-types.js';
+export { FIXTURES_DIR, loadFixture, loadProviderFixtures, findFixtures, clearFixtureCache, getFixtureCacheStats, loadFixtureCollection, } from './fixture-loader.js';
+export type { CaptureConfig } from './fixture-capture.js';
+export { captureChat, captureStream, createCaptureMiddleware, bulkCapture, } from './fixture-capture.js';
+export { createMockFromFixture, replayStreamWithTiming, createMocksFromFixtures, validateAgainstFixture, extractRequest, extractResponse, extractChunks, collectChunksToResponse, createConfigurableMock, } from './fixture-helpers.js';
+export { assertValidChatResponse, assertValidStreamChunk, assertValidChatRequest, assertValidMessage, assertValidMessageContent, assertResponseHasText, assertResponseHasToolUse, assertValidStreamSequence, buildChatRequest, buildMultiTurnRequest, extractTextFromResponse, extractToolUsesFromResponse, accumulateStreamText, estimateTokens, assertReasonableUsage, } from './test-helpers.js';
+export { SeededRandom, generateTextContent, generateUserMessage, generateAssistantMessage, generateSystemMessage, generateParameters, generateChatRequest, forAll, shrinkChatRequest, propertyValidRequest, propertyMultiTurnAlternates, } from './property-testing.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EACV,eAAe,EACf,WAAW,EACX,gBAAgB,EAChB,OAAO,EACP,iBAAiB,EACjB,YAAY,GACb,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGvE,OAAO,EACL,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,qBAAqB,GACtB,MAAM,qBAAqB,CAAC;AAG7B,YAAY,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,aAAa,EACb,uBAAuB,EACvB,WAAW,GACZ,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,uBAAuB,EACvB,sBAAsB,EACtB,cAAc,EACd,eAAe,EACf,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,sBAAsB,CAAC;AAG9B,OAAO,EACL,uBAAuB,EACvB,sBAAsB,EACtB,sBAAsB,EACtB,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,wBAAwB,EACxB,yBAAyB,EACzB,gBAAgB,EAChB,qBAAqB,EACrB,uBAAuB,EACvB,2BAA2B,EAC3B,oBAAoB,EACpB,cAAc,EACd,qBAAqB,GACtB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EAClB,mBAAmB,EACnB,MAAM,EACN,iBAAiB,EACjB,oBAAoB,EACpB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC"}

package/dist/types/property-testing.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Property-based testing utilities - generate random valid inputs
+ */
+import type { IRChatRequest, IRMessage, MessageContent, IRParameters } from 'ai.matey.types';
+/**
+ * Random seed generator for deterministic randomness
+ */
+export declare class SeededRandom {
+    private seed;
+    constructor(seed?: number);
+    /**
+     * Generate next random number between 0 and 1
+     */
+    next(): number;
+    /**
+     * Generate random integer between min and max (inclusive)
+     */
+    nextInt(min: number, max: number): number;
+    /**
+     * Pick random element from array
+     */
+    pick<T>(array: readonly T[]): T;
+    /**
+     * Generate random boolean
+     */
+    nextBool(probability?: number): boolean;
+}
+/**
+ * Generate random text content
+ */
+export declare function generateTextContent(random: SeededRandom): MessageContent;
+/**
+ * Generate random user message
+ */
+export declare function generateUserMessage(random: SeededRandom): IRMessage;
+/**
+ * Generate random assistant message
+ */
+export declare function generateAssistantMessage(random: SeededRandom): IRMessage;
+/**
+ * Generate random system message
+ */
+export declare function generateSystemMessage(random: SeededRandom): IRMessage;
+/**
+ * Generate random parameters
+ */
+export declare function generateParameters(random: SeededRandom): IRParameters;
+/**
+ * Generate random chat request
+ */
+export declare function generateChatRequest(random: SeededRandom, options?: {
+    includeSystem?: boolean;
+    multiTurn?: boolean;
+    minMessages?: number;
+    maxMessages?: number;
+}): IRChatRequest;
+/**
+ * Property test: run test with multiple generated inputs
+ */
+export declare function forAll<T>(generator: (random: SeededRandom) => T, test: (value: T) => void | Promise<void>, options?: {
+    runs?: number;
+    seed?: number;
+}): Promise<void>;
+/**
+ * Shrink a failing value to find minimal failing case
+ */
+export declare function shrinkChatRequest(request: IRChatRequest): IRChatRequest[];
+/**
+ * Example property tests
+ */
+/**
+ * Property: All generated requests should be valid
+ */
+export declare function propertyValidRequest(): Promise<void>;
+/**
+ * Property: Multi-turn conversations should alternate user/assistant
+ */
+export declare function propertyMultiTurnAlternates(): Promise<void>;
+//# sourceMappingURL=property-testing.d.ts.map

package/dist/types/property-testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-testing.d.ts","sourceRoot":"","sources":["../../src/property-testing.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE7F;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,GAAE,MAAmB;IAIrC;;OAEG;IACH,IAAI,IAAI,MAAM;IAKd;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC;IAO/B;;OAEG;IACH,QAAQ,CAAC,WAAW,GAAE,MAAY,GAAG,OAAO;CAG7C;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAkBxE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAYnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAKxE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,YAAY,GAAG,SAAS,CAkBrE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAgBrE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE;IACR,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,GACA,aAAa,CAiCf;AAED;;GAEG;AACH,wBAAsB,MAAM,CAAC,CAAC,EAC5B,SAAS,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,CAAC,EACtC,IAAI,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EACxC,OAAO,CAAC,EAAE;IACR,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GACA,OAAO,CAAC,IAAI,CAAC,CA+Bf;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,aAAa,GAAG,aAAa,EAAE,CAuCzE;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8B1D;AAED;;GAEG;AACH,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAoBjE"}

package/dist/types/test-helpers.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Test helper utilities - assertions and test builders
+ */
+import type { IRChatRequest, IRChatResponse, IRStreamChunk, IRMessage, MessageContent } from 'ai.matey.types';
+/**
+ * Assert that a response has the correct structure
+ */
+export declare function assertValidChatResponse(response: IRChatResponse): void;
+/**
+ * Assert that a stream chunk has the correct structure
+ */
+export declare function assertValidStreamChunk(chunk: IRStreamChunk): void;
+/**
+ * Assert that a request has the correct structure
+ */
+export declare function assertValidChatRequest(request: IRChatRequest): void;
+/**
+ * Assert that a message has the correct structure
+ */
+export declare function assertValidMessage(message: IRMessage): void;
+/**
+ * Assert that message content has the correct structure
+ */
+export declare function assertValidMessageContent(content: MessageContent): void;
+/**
+ * Assert that response contains text
+ */
+export declare function assertResponseHasText(response: IRChatResponse): void;
+/**
+ * Assert that response contains tool use
+ */
+export declare function assertResponseHasToolUse(response: IRChatResponse): void;
+/**
+ * Assert that streaming produces expected sequence
+ */
+export declare function assertValidStreamSequence(stream: AsyncIterable<IRStreamChunk>): Promise<IRStreamChunk[]>;
+/**
+ * Build a simple chat request for testing
+ */
+export declare function buildChatRequest(userMessage: string, options?: {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+    systemMessage?: string;
+}): IRChatRequest;
+/**
+ * Build a multi-turn chat request for testing
+ */
+export declare function buildMultiTurnRequest(exchanges: Array<{
+    user: string;
+    assistant: string;
+}>, finalUserMessage: string, options?: {
+    model?: string;
+    temperature?: number;
+    maxTokens?: number;
+}): IRChatRequest;
+/**
+ * Extract text from response
+ */
+export declare function extractTextFromResponse(response: IRChatResponse): string;
+/**
+ * Extract tool uses from response
+ */
+export declare function extractToolUsesFromResponse(response: IRChatResponse): Array<{
+    id: string;
+    name: string;
+    input: unknown;
+}>;
+/**
+ * Accumulate text from stream chunks
+ */
+export declare function accumulateStreamText(stream: AsyncIterable<IRStreamChunk>): Promise<string>;
+/**
+ * Count tokens in text (rough estimate)
+ */
+export declare function estimateTokens(text: string): number;
+/**
+ * Assert that usage statistics are reasonable
+ */
+export declare function assertReasonableUsage(response: IRChatResponse): void;
+//# sourceMappingURL=test-helpers.d.ts.map

package/dist/types/test-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-helpers.d.ts","sourceRoot":"","sources":["../../src/test-helpers.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,SAAS,EACT,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAkBtE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAIjE;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAenE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,SAAS,GAAG,IAAI,CAY3D;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CA0BvE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAUpE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAYvE;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,GACnC,OAAO,CAAC,aAAa,EAAE,CAAC,CAuB1B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,GACA,aAAa,CA2Bf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,EACrD,gBAAgB,EAAE,MAAM,EACxB,OAAO,CAAC,EAAE;IACR,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GACA,aAAa,CA+Bf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAMxE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,QAAQ,EAAE,cAAc,GAAG,KAAK,CAAC;IAC3E,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB,CAAC,CAiBD;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,aAAa,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAUhG;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGnD;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAiBpE"}

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "ai.matey.testing",
+  "version": "0.2.0",
+  "description": "Testing utilities for AI Matey - Universal AI Adapter System",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/esm/index.js"
+      },
+      "require": {
+        "types": "./dist/types/index.d.ts",
+        "default": "./dist/cjs/index.js"
+      }
+    }
+  },
+  "files": [
+    "dist",
+    "readme.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "npm run build:esm && npm run build:cjs && npm run build:types",
+    "build:esm": "tsc -p tsconfig.esm.json",
+    "build:cjs": "tsc -p tsconfig.cjs.json",
+    "build:types": "tsc -p tsconfig.types.json",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "ai.matey.types": "*",
+    "ai.matey.utils": "*"
+  },
+  "devDependencies": {
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "keywords": [
+    "ai",
+    "llm",
+    "testing",
+    "fixtures",
+    "ai-matey"
+  ],
+  "author": "AI Matey",
+  "license": "MIT",
+  "homepage": "https://github.com/johnhenry/ai.matey#readme",
+  "bugs": {
+    "url": "https://github.com/johnhenry/ai.matey/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johnhenry/ai.matey.git",
+    "directory": "packages/ai.matey.testing"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/readme.md

@@ -0,0 +1,31 @@
+# ai.matey.testing
+
+Testing utilities, mocks, and fixtures for ai.matey
+
+Part of the [ai.matey](https://github.com/johnhenry/ai.matey) monorepo.
+
+## Installation
+
+```bash
+npm install ai.matey.testing
+```
+
+## Exports
+
+- `MockBackendAdapter`
+- `createMockResponse`
+- `assertChatRequest`
+
+## Usage
+
+```typescript
+import { MockBackendAdapter, createMockResponse, assertChatRequest } from 'ai.matey.testing';
+```
+
+## API Reference
+
+See the TypeScript definitions for detailed API documentation.
+
+## License
+
+MIT - see [LICENSE](./LICENSE) for details.