@sparkleideas/testing 3.0.0-alpha.10

package/src/index.ts

@@ -0,0 +1,232 @@
+/**
+ * @sparkleideas/testing - Testing Module
+ * TDD London School framework and test utilities for V3 Claude-Flow
+ *
+ * Based on ADR-008 (Vitest over Jest)
+ *
+ * @example
+ * // Basic test setup
+ * import {
+ *   setupV3Tests,
+ *   createMockApplication,
+ *   agentConfigs,
+ *   swarmConfigs,
+ * } from '@sparkleideas/testing';
+ *
+ * setupV3Tests();
+ *
+ * describe('MyModule', () => {
+ *   const app = createMockApplication();
+ *
+ *   it('should work', async () => {
+ *     const agent = await app.agentLifecycle.spawn(agentConfigs.queenCoordinator);
+ *     expect(agent.success).toBe(true);
+ *   });
+ * });
+ */
+
+// Test setup - Global configuration and custom matchers
+export * from './setup.js';
+
+// Helpers - Mock factories, utilities, and assertions
+// Explicitly export to avoid duplicates with fixtures
+export {
+  // create-mock.js
+  createMock,
+  createDeepMock,
+  createSpyMock,
+  createMockWithBehavior,
+  createRetryMock,
+  createSequenceMock,
+  InteractionRecorder,
+  type MockedInterface,
+} from './helpers/create-mock.js';
+
+export {
+  // test-application.js
+  createTestApplication,
+  type TestApplication,
+  type IEventBus,
+  type ITaskManager,
+  type IAgentLifecycle,
+  type IMemoryService,
+  type ISecurityService,
+  type ISwarmCoordinator,
+} from './helpers/test-application.js';
+
+export {
+  // swarm-instance.js - Only export what's not in fixtures
+  createSwarmTestInstance,
+  SwarmTestInstance,
+  type SwarmAgent,
+} from './helpers/swarm-instance.js';
+
+export {
+  // assertions.js
+  assertCallSequence,
+  assertNotCalledWith,
+  assertInteractionCount,
+  assertAllCalled,
+  assertNoneCalled,
+  assertContractCompliance,
+  assertTimingWithin,
+  assertTimingRange,
+  assertThrowsWithMessage,
+  assertEventPublished,
+  assertMockSequence,
+  assertNoSensitiveDataLogged,
+  assertPerformanceTarget,
+} from './helpers/assertions.js';
+
+export {
+  // test-utils.js
+  waitFor,
+  waitUntilChanged,
+  retry,
+  withTimeout,
+  sleep,
+  createDeferred,
+  parallelLimit,
+  measureTime,
+  createMockClock,
+  createTestEmitter,
+  createCallSpy,
+  createMockStream,
+  collectStream,
+  generateTestId,
+  createTestContext,
+  expectToReject,
+  createTrackedMock,
+  TimeoutError,
+  type WaitForOptions,
+  type WaitUntilChangedOptions,
+  type RetryOptions,
+  type Deferred,
+  type MockClock,
+  type TestEmitter,
+  type CallSpy,
+  type MockStreamOptions,
+  type TestContext,
+  type TrackedMock,
+} from './helpers/test-utils.js';
+
+export {
+  // mock-factory.js - Only non-duplicate exports
+  createMockEventBus,
+  createMockTaskManager,
+  createMockAgentLifecycle,
+  createMockMemoryService,
+  createMockSecurityService,
+  createMockSwarmCoordinator,
+  createMockMCPClient,
+  createMockLogger,
+  createMockApplication,
+  resetMockApplication,
+  type MockApplication,
+  type ILogger,
+  type IMCPClient,
+  type DomainEvent,
+  type EventHandler,
+  type Task,
+  type TaskFilters,
+  type TerminateOptions,
+  type AgentFilters,
+  type AgentHealthCheck,
+  type MemoryStats,
+  type IndexConfig,
+  type InputValidationOptions,
+  type ExecuteOptions,
+  type ExecuteResult,
+} from './helpers/mock-factory.js';
+
+export {
+  // assertion-helpers.js
+  assertCalledWithPattern,
+  assertEventOrder,
+  assertEventNotPublished,
+  assertMocksCalledInOrder,
+  assertCalledNTimesWith,
+  assertCompletesWithin,
+  assertThrowsError,
+  assertNoSensitiveData,
+  assertMatchesSnapshot,
+  assertV3PerformanceTargets,
+  assertValidDomainObject,
+  assertOnlyCalledWithAllowed,
+  assertPartialOrder,
+  assertAllPass,
+  assertNonePass,
+  assertSameElements,
+  assertMockReturnsSequence,
+  assertValidStateTransition,
+  assertRetryPattern,
+  assertDependencyInjected,
+  registerCustomMatchers,
+  type SnapshotOptions,
+  type V3PerformanceMetrics,
+  type RetryPatternOptions,
+} from './helpers/assertion-helpers.js';
+
+export {
+  // setup-teardown.js
+  createSetupContext,
+  getGlobalContext,
+  resetGlobalContext,
+  configureTestEnvironment,
+  createTestSuite,
+  createTestScope,
+  createInMemoryDatabaseHelper,
+  createNetworkTestHelper,
+  createInMemoryFileSystemHelper,
+  createPerformanceTestHelper,
+  setupV3Tests,
+  flushPromises,
+  withTestTimeout,
+  type SetupContext,
+  type CleanupFunction,
+  type Disposable,
+  type TestEnvironmentConfig,
+  type TestSuiteHelpers,
+  type TestScope,
+  type DatabaseTestHelper,
+  type NetworkTestHelper,
+  type MockFetchResponse,
+  type FileSystemTestHelper,
+  type PerformanceTestHelper,
+  type V3TestConfig,
+} from './helpers/setup-teardown.js';
+
+// Fixtures - Pre-defined test data (canonical source for shared types)
+export * from './fixtures/index.js';
+
+// Mocks - Service mock implementations (explicit to avoid duplicates)
+export {
+  MockAgentDB,
+  MockSwarmCoordinator,
+  MockSwarmAgent,
+  MockMemoryService,
+  MockEventBus,
+  MockSecurityService,
+  createMockServices,
+  resetMockServices,
+  type MockServiceBundle,
+} from './mocks/mock-services.js';
+
+export {
+  MockMCPClient,
+  MockMCPServer,
+  MockMCPConnection,
+  MCPClientError,
+  createStandardMockMCPClient,
+  createFailingMockMCPClient,
+  createSlowMockMCPClient,
+} from './mocks/mock-mcp-client.js';
+
+// Regression Testing - Prevent capability degradation
+export * from './regression/index.js';
+
+// V2 Compatibility Testing - Validate backward compatibility
+export * from './v2-compat/index.js';
+
+// Re-export commonly used Vitest utilities
+export { vi, expect, describe, it, test, beforeEach, afterEach, beforeAll, afterAll } from 'vitest';

package/src/mocks/index.ts

@@ -0,0 +1,29 @@
+/**
+ * @sparkleideas/testing - Mocks Index
+ *
+ * Central export for all mock implementations
+ */
+
+// Mock services
+export {
+  MockAgentDB,
+  MockSwarmCoordinator,
+  MockSwarmAgent,
+  MockMemoryService,
+  MockEventBus,
+  MockSecurityService,
+  createMockServices,
+  resetMockServices,
+  type MockServiceBundle,
+} from './mock-services.js';
+
+// Mock MCP client and server
+export {
+  MockMCPClient,
+  MockMCPServer,
+  MockMCPConnection,
+  MCPClientError,
+  createStandardMockMCPClient,
+  createFailingMockMCPClient,
+  createSlowMockMCPClient,
+} from './mock-mcp-client.js';