@olane/o-test 0.7.12

package/dist/src/fixtures/test-methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-methods.d.ts","sourceRoot":"","sources":["../../../src/fixtures/test-methods.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,kBAAkB,EAAE,OAwBhC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAqCjC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,OAiCpC,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAqDlD,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAE/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,UAAU,GAAE,GAAG,EAAO,GACrB,OAAO,CAOT"}

package/dist/src/fixtures/test-methods.js

@@ -0,0 +1,185 @@
+/**
+ * Test method definitions for testing
+ *
+ * Provides sample oMethod definitions for testing tools
+ */
+/**
+ * Simple test method definition
+ */
+export const TEST_METHOD_SIMPLE = {
+    name: 'test_method',
+    description: 'Simple test method for unit testing',
+    parameters: [
+        {
+            name: 'param1',
+            type: 'string',
+            description: 'First parameter',
+            required: true,
+            exampleValues: ['test-value'],
+        },
+    ],
+    dependencies: [],
+    examples: [
+        {
+            description: 'Basic usage',
+            intent: 'Test the basic functionality',
+            params: { param1: 'test' },
+            expectedResult: {
+                success: true,
+                result: { data: { param1: 'test' } },
+            },
+        },
+    ],
+};
+/**
+ * Method with multiple parameters and types
+ */
+export const TEST_METHOD_COMPLEX = {
+    name: 'test_complex',
+    description: 'Complex test method with multiple parameter types',
+    parameters: [
+        {
+            name: 'stringParam',
+            type: 'string',
+            description: 'String parameter',
+            required: true,
+        },
+        {
+            name: 'numberParam',
+            type: 'number',
+            description: 'Number parameter',
+            required: true,
+        },
+        {
+            name: 'booleanParam',
+            type: 'boolean',
+            description: 'Boolean parameter',
+            required: false,
+            defaultValue: false,
+        },
+        {
+            name: 'arrayParam',
+            type: 'array',
+            description: 'Array of strings',
+            required: false,
+            structure: {
+                arrayItems: {
+                    name: 'item',
+                    type: 'string',
+                },
+            },
+        },
+    ],
+    dependencies: [],
+};
+/**
+ * Method with validation and errors
+ */
+export const TEST_METHOD_VALIDATION = {
+    name: 'test_validation',
+    description: 'Test method with strict validation',
+    parameters: [
+        {
+            name: 'email',
+            type: 'string',
+            description: 'Valid email address',
+            required: true,
+            exampleValues: ['test@example.com'],
+        },
+        {
+            name: 'age',
+            type: 'number',
+            description: 'Age must be >= 0',
+            required: true,
+        },
+    ],
+    dependencies: [],
+    commonErrors: [
+        {
+            errorCode: 'INVALID_EMAIL',
+            message: 'Email format is invalid',
+            causes: ['Invalid email format provided'],
+            remediation: 'Provide a valid email address',
+        },
+        {
+            errorCode: 'INVALID_AGE',
+            message: 'Age must be >= 0',
+            causes: ['Negative age value provided'],
+            remediation: 'Provide a non-negative age',
+        },
+    ],
+};
+/**
+ * Collection of test methods
+ */
+export const TEST_METHODS = {
+    test_echo: {
+        name: 'test_echo',
+        description: 'Echo back the input parameters',
+        parameters: [
+            {
+                name: 'message',
+                type: 'string',
+                description: 'Message to echo',
+                required: true,
+            },
+        ],
+        dependencies: [],
+    },
+    test_add: {
+        name: 'test_add',
+        description: 'Add two numbers',
+        parameters: [
+            {
+                name: 'a',
+                type: 'number',
+                description: 'First number',
+                required: true,
+            },
+            {
+                name: 'b',
+                type: 'number',
+                description: 'Second number',
+                required: true,
+            },
+        ],
+        dependencies: [],
+    },
+    test_error: {
+        name: 'test_error',
+        description: 'Always throws an error (for testing error handling)',
+        parameters: [],
+        dependencies: [],
+    },
+    test_timeout: {
+        name: 'test_timeout',
+        description: 'Simulates a timeout',
+        parameters: [
+            {
+                name: 'delay',
+                type: 'number',
+                description: 'Delay in milliseconds',
+                required: false,
+                defaultValue: 5000,
+            },
+        ],
+        dependencies: [],
+    },
+};
+/**
+ * Get a test method definition by name
+ */
+export function getTestMethod(name) {
+    return TEST_METHODS[name];
+}
+/**
+ * Create a custom test method
+ */
+export function createTestMethod(name, description, parameters = []) {
+    return {
+        name,
+        description,
+        parameters,
+        dependencies: [],
+    };
+}

package/dist/src/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @olane/o-test - Testing utilities for O-Network nodes
+ *
+ * Provides comprehensive testing utilities, builders, and fixtures
+ * to eliminate boilerplate in O-Network package tests.
+ */
+export { TestEnvironment } from './test-environment.js';
+export type { TestNodeConfig, LeaderNodeOptions, ToolWithLeaderResult, } from './test-environment.js';
+export { SimpleNodeBuilder, LeaderChildBuilder, ManagerWorkerBuilder, } from './builders/index.js';
+export type { LeaderConfig, ManagerWorkerResult } from './builders/index.js';
+export { waitFor, waitForAsync, sleep, ChunkCapture, assertSuccess, assertError, assertRunning, assertStopped, assertHasData, assertDefined, assertArrayLength, assertHasProperty, assertOneOf, assert, generateId, createMockUser, createMockTask, createMockSession, createMockRequest, createMockSuccessResponse, createMockErrorResponse, generateMockArray, } from './utils/index.js';
+export { INVALID_PARAMS, VALID_PARAMS, } from './utils/mock-factories.js';
+export { MOCK_USERS, MOCK_TASKS, MOCK_SESSIONS, MOCK_CONFIGS, MOCK_ADDRESSES, MOCK_ERRORS, MOCK_STREAM_CHUNKS, TEST_METHOD_SIMPLE, TEST_METHOD_COMPLEX, TEST_METHOD_VALIDATION, TEST_METHODS, getTestMethod, createTestMethod, } from './fixtures/index.js';
+export { INVALID_PARAMS as FIXTURE_INVALID_PARAMS } from './fixtures/mock-data.js';
+export { VALID_PARAMS as FIXTURE_VALID_PARAMS } from './fixtures/mock-data.js';
+export * from './example-tool.tool.js';
+export * from './methods/example.methods.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EACV,cAAc,EACd,iBAAiB,EACjB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAG7E,OAAO,EACL,OAAO,EACP,YAAY,EACZ,KAAK,EACL,YAAY,EAEZ,aAAa,EACb,WAAW,EACX,aAAa,EACb,aAAa,EACb,aAAa,EACb,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,WAAW,EACX,MAAM,EAEN,UAAU,EACV,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,yBAAyB,EACzB,uBAAuB,EACvB,iBAAiB,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,cAAc,EACd,YAAY,GACb,MAAM,2BAA2B,CAAC;AAGnC,OAAO,EACL,UAAU,EACV,UAAU,EACV,aAAa,EACb,YAAY,EACZ,cAAc,EACd,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,mBAAmB,EACnB,sBAAsB,EACtB,YAAY,EACZ,aAAa,EACb,gBAAgB,GACjB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,cAAc,IAAI,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EAAE,YAAY,IAAI,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAG/E,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC"}

package/dist/src/index.js

@@ -0,0 +1,25 @@
+/**
+ * @olane/o-test - Testing utilities for O-Network nodes
+ *
+ * Provides comprehensive testing utilities, builders, and fixtures
+ * to eliminate boilerplate in O-Network package tests.
+ */
+// Core test environment
+export { TestEnvironment } from './test-environment.js';
+// Test builders
+export { SimpleNodeBuilder, LeaderChildBuilder, ManagerWorkerBuilder, } from './builders/index.js';
+// Utilities
+export { waitFor, waitForAsync, sleep, ChunkCapture, 
+// Assertions
+assertSuccess, assertError, assertRunning, assertStopped, assertHasData, assertDefined, assertArrayLength, assertHasProperty, assertOneOf, assert, 
+// Mock factories
+generateId, createMockUser, createMockTask, createMockSession, createMockRequest, createMockSuccessResponse, createMockErrorResponse, generateMockArray, } from './utils/index.js';
+export { INVALID_PARAMS, VALID_PARAMS, } from './utils/mock-factories.js';
+// Fixtures
+export { MOCK_USERS, MOCK_TASKS, MOCK_SESSIONS, MOCK_CONFIGS, MOCK_ADDRESSES, MOCK_ERRORS, MOCK_STREAM_CHUNKS, TEST_METHOD_SIMPLE, TEST_METHOD_COMPLEX, TEST_METHOD_VALIDATION, TEST_METHODS, getTestMethod, createTestMethod, } from './fixtures/index.js';
+// Re-export invalid/valid params from fixtures
+export { INVALID_PARAMS as FIXTURE_INVALID_PARAMS } from './fixtures/mock-data.js';
+export { VALID_PARAMS as FIXTURE_VALID_PARAMS } from './fixtures/mock-data.js';
+// Example tool (for reference/templates)
+export * from './example-tool.tool.js';
+export * from './methods/example.methods.js';

package/dist/src/methods/example.methods.d.ts

@@ -0,0 +1,9 @@
+import { oMethod } from '@olane/o-protocol';
+/**
+ * Method definitions for the Example Tool
+ * These methods are discoverable by AI agents and define the tool's capabilities
+ */
+export declare const EXAMPLE_METHODS: {
+    [key: string]: oMethod;
+};
+//# sourceMappingURL=example.methods.d.ts.map

package/dist/src/methods/example.methods.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"example.methods.d.ts","sourceRoot":"","sources":["../../../src/methods/example.methods.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CAgDrD,CAAC"}

package/dist/src/methods/example.methods.js

@@ -0,0 +1,50 @@
+/**
+ * Method definitions for the Example Tool
+ * These methods are discoverable by AI agents and define the tool's capabilities
+ */
+export const EXAMPLE_METHODS = {
+    example_method: {
+        name: 'example_method',
+        description: 'Process a message and return a result. This is a simple example method demonstrating basic tool functionality.',
+        parameters: [
+            {
+                name: 'message',
+                type: 'string',
+                description: 'The message to process',
+                required: true,
+            },
+            {
+                name: 'metadata',
+                type: 'object',
+                description: 'Optional metadata to include with the request',
+                required: false,
+            },
+        ],
+        dependencies: [],
+    },
+    process_data: {
+        name: 'process_data',
+        description: 'Process and transform data according to specified options. Supports multiple output formats and validation.',
+        parameters: [
+            {
+                name: 'data',
+                type: 'string | object',
+                description: 'The data to process (can be string or object)',
+                required: true,
+            },
+            {
+                name: 'options',
+                type: 'object',
+                description: 'Processing options including format and validation settings',
+                required: false,
+            },
+        ],
+        dependencies: [],
+    },
+    get_status: {
+        name: 'get_status',
+        description: 'Get the current status of the tool including configuration and runtime information.',
+        parameters: [],
+        dependencies: [],
+    },
+};

package/dist/src/test-environment.d.ts

@@ -0,0 +1,185 @@
+/**
+ * TestEnvironment - Core test setup and lifecycle management for O-Network nodes
+ *
+ * Provides automatic cleanup, node factories, and common test utilities
+ * to eliminate boilerplate in O-Network package tests.
+ *
+ * @example
+ * ```typescript
+ * describe('MyTool', () => {
+ *   const env = new TestEnvironment();
+ *
+ *   afterEach(async () => {
+ *     await env.cleanup();
+ *   });
+ *
+ *   it('should work', async () => {
+ *     const { leader, tool } = await env.createToolWithLeader(MyTool);
+ *     expect(tool.state).to.equal(NodeState.RUNNING);
+ *   });
+ * });
+ * ```
+ */
+import type { oNode, oNodeAddress } from '@olane/o-node';
+/**
+ * Node configuration for test environment
+ */
+export interface TestNodeConfig {
+    address?: oNodeAddress;
+    leader?: oNodeAddress | null;
+    parent?: oNodeAddress | null;
+    description?: string;
+    [key: string]: any;
+}
+/**
+ * Options for creating leader nodes
+ */
+export interface LeaderNodeOptions {
+    address?: oNodeAddress;
+    description?: string;
+    autoStart?: boolean;
+}
+/**
+ * Result of creating a tool with leader
+ */
+export interface ToolWithLeaderResult<T = any> {
+    leader: any;
+    tool: T;
+}
+/**
+ * Core test environment class for O-Network testing
+ *
+ * Manages node lifecycle, automatic cleanup, and provides
+ * factory methods for common test scenarios.
+ */
+export declare class TestEnvironment {
+    private nodes;
+    private cleanupCallbacks;
+    /**
+     * Create a leader node for testing
+     *
+     * @param LeaderClass - Leader node class (e.g., oLeaderNode)
+     * @param options - Configuration options
+     * @returns Started leader node instance
+     *
+     * @example
+     * ```typescript
+     * const leader = await env.createLeader(oLeaderNode);
+     * ```
+     */
+    createLeader<T extends oNode>(LeaderClass: new (config: any) => T, options?: LeaderNodeOptions): Promise<T>;
+    /**
+     * Create a tool with a leader node
+     *
+     * Automatically handles:
+     * - Leader creation and startup
+     * - Tool creation with parent/leader references
+     * - Hook injection for child registration
+     * - Lifecycle tracking for cleanup
+     *
+     * @param ToolClass - Tool class to instantiate
+     * @param config - Tool configuration
+     * @param LeaderClass - Leader class (defaults to oLeaderNode if available)
+     * @returns Object with leader and tool instances
+     *
+     * @example
+     * ```typescript
+     * const { leader, tool } = await env.createToolWithLeader(MyTool, {
+     *   apiKey: 'test-key'
+     * });
+     * ```
+     */
+    createToolWithLeader<T extends oNode>(ToolClass: new (config: any) => T, config?: TestNodeConfig, LeaderClass?: new (config: any) => any): Promise<ToolWithLeaderResult<T>>;
+    /**
+     * Create a simple node without leader
+     *
+     * @param NodeClass - Node class to instantiate
+     * @param config - Node configuration
+     * @param autoStart - Whether to start node automatically (default: true)
+     * @returns Node instance
+     *
+     * @example
+     * ```typescript
+     * const node = await env.createNode(MyTool, {
+     *   address: new oNodeAddress('o://test')
+     * });
+     * ```
+     */
+    createNode<T extends oNode>(NodeClass: new (config: any) => T, config?: TestNodeConfig, autoStart?: boolean): Promise<T>;
+    /**
+     * Track a node for automatic cleanup
+     *
+     * @param node - Node instance to track
+     *
+     * @example
+     * ```typescript
+     * const node = new MyNode({});
+     * env.track(node);
+     * await node.start();
+     * ```
+     */
+    track(node: oNode): void;
+    /**
+     * Register a cleanup callback
+     *
+     * Useful for cleaning up external resources (databases, files, etc.)
+     *
+     * @param callback - Async cleanup function
+     *
+     * @example
+     * ```typescript
+     * const db = await createTestDB();
+     * env.onCleanup(async () => {
+     *   await db.close();
+     * });
+     * ```
+     */
+    onCleanup(callback: () => Promise<void>): void;
+    /**
+     * Stop all tracked nodes and execute cleanup callbacks
+     *
+     * Stops nodes in reverse order (children before parents)
+     * Call this in afterEach hooks.
+     *
+     * @example
+     * ```typescript
+     * afterEach(async () => {
+     *   await env.cleanup();
+     * });
+     * ```
+     */
+    cleanup(): Promise<void>;
+    /**
+     * Get all tracked nodes
+     *
+     * @returns Array of tracked node instances
+     */
+    getNodes(): oNode[];
+    /**
+     * Get count of tracked nodes
+     *
+     * @returns Number of tracked nodes
+     */
+    getNodeCount(): number;
+    /**
+     * Check if all tracked nodes are stopped
+     *
+     * @returns True if all nodes are stopped
+     */
+    allNodesStopped(): boolean;
+    /**
+     * Wait for a condition to be true
+     *
+     * @param condition - Function that returns true when condition is met
+     * @param timeoutMs - Maximum time to wait in milliseconds (default: 5000)
+     * @param intervalMs - Check interval in milliseconds (default: 100)
+     * @returns Promise that resolves when condition is met or rejects on timeout
+     *
+     * @example
+     * ```typescript
+     * await env.waitFor(() => tool.isReady, 10000);
+     * ```
+     */
+    waitFor(condition: () => boolean, timeoutMs?: number, intervalMs?: number): Promise<void>;
+}
+//# sourceMappingURL=test-environment.d.ts.map

package/dist/src/test-environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-environment.d.ts","sourceRoot":"","sources":["../../src/test-environment.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,MAAM,CAAC,EAAE,YAAY,GAAG,IAAI,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB,CAAC,CAAC,GAAG,GAAG;IAC3C,MAAM,EAAE,GAAG,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,gBAAgB,CAAkC;IAE1D;;;;;;;;;;;OAWG;IACG,YAAY,CAAC,CAAC,SAAS,KAAK,EAChC,WAAW,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,CAAC,EACnC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,CAAC,CAAC;IAkBb;;;;;;;;;;;;;;;;;;;;OAoBG;IACG,oBAAoB,CAAC,CAAC,SAAS,KAAK,EACxC,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,CAAC,EACjC,MAAM,GAAE,cAAmB,EAC3B,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,GAAG,GACrC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC;IAwCnC;;;;;;;;;;;;;;OAcG;IACG,UAAU,CAAC,CAAC,SAAS,KAAK,EAC9B,SAAS,EAAE,KAAK,MAAM,EAAE,GAAG,KAAK,CAAC,EACjC,MAAM,GAAE,cAAmB,EAC3B,SAAS,GAAE,OAAc,GACxB,OAAO,CAAC,CAAC,CAAC;IAgBb;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,IAAI,EAAE,KAAK,GAAG,IAAI;IAIxB;;;;;;;;;;;;;;OAcG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI;IAI9C;;;;;;;;;;;;OAYG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA4B9B;;;;OAIG;IACH,QAAQ,IAAI,KAAK,EAAE;IAInB;;;;OAIG;IACH,YAAY,IAAI,MAAM;IAItB;;;;OAIG;IACH,eAAe,IAAI,OAAO;IAI1B;;;;;;;;;;;;OAYG;IACG,OAAO,CACX,SAAS,EAAE,MAAM,OAAO,EACxB,SAAS,GAAE,MAAa,EACxB,UAAU,GAAE,MAAY,GACvB,OAAO,CAAC,IAAI,CAAC;CAUjB"}