lambder 1.0.129 → 1.0.130

package/tests/msw-integration.test.ts

@@ -0,0 +1,183 @@
+/**
+ * Example test file demonstrating MSW integration with Lambder
+ * 
+ * To run this test:
+ * 1. Install MSW: npm install --save-dev msw
+ * 2. Install Vitest (if not already): npm install --save-dev vitest
+ * 3. Run: npm test
+ */
+
+import { describe, it, expect, beforeAll, afterEach, afterAll } from 'vitest';
+// Uncomment when MSW is installed:
+// import { setupServer } from 'msw/node';
+import { 
+    mockLambderApi, 
+    mockLambderApiError,
+    mockLambderSessionExpired,
+    LambderCaller,
+    type ApiContractShape 
+} from '../src/index.js';
+
+// Define test API contract
+const testApiContract = {
+    'test.echo': {
+        input: { message: '' as string },
+        output: { echo: '' as string }
+    },
+    'test.add': {
+        input: { a: 0 as number, b: 0 as number },
+        output: { result: 0 as number }
+    },
+    'test.getUser': {
+        input: { userId: '' as string },
+        output: { id: '' as string, name: '' as string }
+    }
+} satisfies ApiContractShape;
+
+type TestApiContract = typeof testApiContract;
+
+// MSW handlers
+const handlers = [
+    mockLambderApi<TestApiContract, 'test.echo'>(
+        'test.echo',
+        (input) => ({
+            echo: input.message
+        })
+    ),
+    mockLambderApi<TestApiContract, 'test.add'>(
+        'test.add',
+        (input) => ({
+            result: input.a + input.b
+        })
+    ),
+    mockLambderApi<TestApiContract, 'test.getUser'>(
+        'test.getUser',
+        (input) => ({
+            id: input.userId,
+            name: `User ${input.userId}`
+        })
+    )
+];
+
+// Set up MSW server (uncomment when MSW is installed)
+// const server = setupServer(...handlers);
+
+describe('Lambder MSW Integration', () => {
+    // Uncomment when MSW is installed:
+    // beforeAll(() => server.listen());
+    // afterEach(() => server.resetHandlers());
+    // afterAll(() => server.close());
+
+    // Initialize Lambder caller
+    const caller = new LambderCaller<TestApiContract>({
+        apiPath: '/api',
+        isCorsEnabled: false
+    });
+
+    it.skip('should mock echo API successfully', async () => {
+        const result = await caller.api('test.echo', { message: 'Hello MSW!' });
+        
+        expect(result).toEqual({ echo: 'Hello MSW!' });
+    });
+
+    it.skip('should mock math API successfully', async () => {
+        const result = await caller.api('test.add', { a: 5, b: 3 });
+        
+        expect(result).toEqual({ result: 8 });
+    });
+
+    it.skip('should mock user API with dynamic data', async () => {
+        const result = await caller.api('test.getUser', { userId: '123' });
+        
+        expect(result).toEqual({
+            id: '123',
+            name: 'User 123'
+        });
+    });
+
+    it.skip('should handle API errors', async () => {
+        // Override handler for this test
+        // server.use(
+        //     mockLambderApiError<TestApiContract, 'test.getUser'>(
+        //         'test.getUser',
+        //         'User not found'
+        //     )
+        // );
+
+        const result = await caller.api('test.getUser', { userId: '999' });
+        
+        expect(result).toBeNull();
+    });
+
+    it.skip('should handle session expired', async () => {
+        // Override handler for this test
+        // server.use(
+        //     mockLambderSessionExpired<TestApiContract, 'test.getUser'>(
+        //         'test.getUser'
+        //     )
+        // );
+
+        const result = await caller.api('test.getUser', { userId: '123' });
+        
+        expect(result).toBeNull();
+    });
+
+    it('should export MSW utilities', () => {
+        // Verify exports are available
+        expect(mockLambderApi).toBeDefined();
+        expect(mockLambderApiError).toBeDefined();
+        expect(mockLambderSessionExpired).toBeDefined();
+    });
+});
+
+describe('MSW Utility Functions', () => {
+    it('should create type-safe mock handlers', () => {
+        const handler = mockLambderApi<TestApiContract, 'test.echo'>(
+            'test.echo',
+            (input) => ({
+                echo: input.message // Type-safe input access
+            })
+        );
+
+        expect(handler).toBeDefined();
+        expect(typeof handler).toBe('function');
+    });
+
+    it('should create error mock handlers', () => {
+        const handler = mockLambderApiError<TestApiContract, 'test.echo'>(
+            'test.echo',
+            'Test error message'
+        );
+
+        expect(handler).toBeDefined();
+        expect(typeof handler).toBe('function');
+    });
+
+    it('should support handler options', () => {
+        const handler = mockLambderApi<TestApiContract, 'test.echo'>(
+            'test.echo',
+            (input) => ({ echo: input.message }),
+            {
+                delay: 500,
+                apiPath: '/custom-api',
+                apiVersion: 'v1'
+            }
+        );
+
+        expect(handler).toBeDefined();
+    });
+});
+
+/**
+ * To enable these tests:
+ * 
+ * 1. Install MSW:
+ *    npm install --save-dev msw
+ * 
+ * 2. Uncomment the MSW server setup lines above
+ * 
+ * 3. Remove .skip from the test cases
+ * 
+ * 4. Run tests:
+ *    npm test
+ */