@motiadev/test 0.8.2-beta.140-799293 → 0.8.2-beta.140-628177

package/README.md

@@ -14,26 +14,24 @@ pnpm add @motiadev/test --save-dev
 
 ## Features
 
-- Create mock flow contexts for testing
-- Simulate event emission and capture
-- Mock loggers for testing
-- Test event-driven workflows in isolation
-- Utilities for testing state management
+* Create mock flow contexts for testing steps and workflows
+* Simulate event emission and capture events
+* Mock loggers for testing
+* Test event-driven workflows in isolation
+* Utilities for testing state management
 
 ## Usage
 
 ### Creating a Tester
 
 ```typescript
-import { createTester } from '@motiadev/test';
+import { createMotiaTester } from '@motiadev/test';
 
 // Create a tester instance
-const tester = createTester();
+const tester = createMotiaTester();
 
 // Use the tester to test your workflows
-const response = await tester.request()
-  .post('/api/endpoint')
-  .send({ data: 'test' });
+const response = await tester.post('/api/endpoint', { body: { data: 'test' } });
 
 // Assert on the response
 expect(response.status).toBe(200);
@@ -42,20 +40,18 @@ expect(response.status).toBe(200);
 ### Capturing Events
 
 ```typescript
-import { createTester } from '@motiadev/test';
+import { createMotiaTester } from '@motiadev/test';
 
-const tester = createTester();
+const tester = createMotiaTester();
 
 // Set up event capturing
-const watcher = tester.watchEvents('event.topic');
+const watcher = tester.watch('event.topic');
 
 // Trigger an action that emits events
-await tester.request()
-  .post('/api/trigger')
-  .send({ action: 'test' });
+await tester.post('/api/trigger', { body: { action: 'test' } });
 
 // Get captured events
-const events = watcher.getCapturedEvents();
+const events = await watcher;
 expect(events).toHaveLength(1);
 expect(events[0].data).toEqual({ result: 'success' });
 ```
@@ -90,79 +86,84 @@ const logger = createMockLogger();
 logger.info('Test message');
 
 // Assert on logged messages
-expect(logger.messages.info).toContain('Test message');
+expect(logger.info).toHaveBeenCalledWith('Test message');
 ```
 
 ## API Reference
 
-### `createTester()`
+### `createMotiaTester()`
 
 Creates a tester instance for testing Motia workflows.
 
 **Returns:**
-- `MotiaTester`: A tester instance with methods for testing workflows.
+
+* `MotiaTester`: Tester instance with methods for posting requests, watching events, and closing the tester.
 
 ### `createMockFlowContext()`
 
 Creates a mock flow context for testing step handlers.
 
 **Returns:**
-- `MockFlowContext`: A mock context object with spied methods.
+
+* `MockFlowContext`: Mocked context with spied methods like `emit` and `logger`.
 
 ### `createMockLogger()`
 
 Creates a mock logger for testing logging functionality.
 
 **Returns:**
-- `MockLogger`: A mock logger with methods for logging and tracking messages.
+
+* `MockLogger`: Mock logger with all standard logging methods mocked.
 
 ### `MotiaTester` Methods
 
-- `request()`: Returns a supertest instance for making HTTP requests.
-- `watchEvents(topic)`: Creates a watcher for capturing events on a specific topic.
-- `close()`: Closes the tester and cleans up resources.
+* `post(path, options)` → Send POST requests to your endpoint.
+* `get(path, options)` → Send GET requests.
+* `watch(event)` → Capture events emitted on a topic.
+* `waitEvents()` → Wait for all events to be processed.
+* `emit(event)` → Emit an event.
+* `close()` → Clean up resources after testing.
 
 ### `Watcher` Methods
 
-- `getCapturedEvents()`: Returns an array of captured events.
+* Returns a Promise of captured events.
+* `getCapturedEvents()` → Get an array of captured events.
 
 ## Example: Testing a Complete Flow
 
 ```typescript
-import { createTester } from '@motiadev/test';
+import { createMotiaTester } from '@motiadev/test';
 import { expect, test } from 'vitest';
 
 test('complete order flow works correctly', async () => {
-  const tester = createTester();
+  const tester = createMotiaTester();
   
   // Watch for order completion events
-  const orderCompletedWatcher = tester.watchEvents('order.completed');
+const orderCompletedWatcher = tester.watch('order.completed');
+
   
   // Trigger the order creation
-  const response = await tester.request()
-    .post('/api/orders')
-    .send({
+const response = await tester.post('/api/orders', {
+    body: {
       items: [{ id: 'item1', quantity: 2 }],
       customer: { id: 'cust1', email: 'test@example.com' }
-    });
+    }
+  });
   
   // Verify the API response
   expect(response.status).toBe(200);
   expect(response.body).toHaveProperty('orderId');
   
   // Wait for all events to be processed
-  await tester.waitForEvents();
+  await tester.waitEvents();
   
   // Verify the order completed event was emitted
-  const completedEvents = orderCompletedWatcher.getCapturedEvents();
+  const completedEvents = await orderCompletedWatcher;
   expect(completedEvents).toHaveLength(1);
-  expect(completedEvents[0].data).toMatchObject({
-    orderId: expect.any(String),
-    status: 'completed'
-  });
-  
+  expect(completedEvents[0].data).toMatchObject({ orderId: expect.any(String), status: 'completed' });
+
   // Clean up
-  await tester.close();
+await tester.close();
 });
 ```
 

package/dist/index.d.ts

@@ -1,3 +1,4 @@
 export * from './src/tester';
 export * from './src/types';
 export * from './src/helpers';
+export * from './src/event-manager';

package/dist/index.js

@@ -17,3 +17,4 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./src/tester"), exports);
 __exportStar(require("./src/types"), exports);
 __exportStar(require("./src/helpers"), exports);
+__exportStar(require("./src/event-manager"), exports);

package/dist/src/types.d.ts

@@ -17,6 +17,8 @@ export interface MotiaTester {
 }
 export type RequestOptions = {
     body?: Record<string, unknown>;
+    headers?: Record<string, string>;
+    cookies?: Record<string, string>;
 };
 export type CapturedEvent<TData = unknown> = Omit<Event<TData>, 'logger' | 'tracer'>;
 export type MockFlowContext = {

package/package.json

@@ -1,16 +1,16 @@
 {
   "name": "@motiadev/test",
   "description": "A testing utility package for Motia workflows that provides tools for mocking, testing, and simulating Motia components.",
-  "version": "0.8.2-beta.140-799293",
+  "version": "0.8.2-beta.140-628177",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "peerDependencies": {
-    "@motiadev/core": "0.8.2-beta.140-799293",
-    "motia": "0.8.2-beta.140-799293"
+    "@motiadev/core": "0.8.2-beta.140-628177",
+    "motia": "0.8.2-beta.140-628177"
   },
   "dependencies": {
-    "supertest": "^7.0.0",
-    "jest": "^29.7.0"
+    "jest": "^29.7.0",
+    "supertest": "^7.1.4"
   },
   "devDependencies": {
     "@types/jest": "^29.5.14",