batman

docs/testing.md

@@ -0,0 +1,56 @@
+# Testing
+
+## Running Tests
+
+```bash
+# All unit tests
+pnpm test
+
+# E2E tests
+pnpm test:e2e
+
+# Specific test file
+cd apps/api
+npx jest --testPathPattern="auth.service.spec.ts"
+```
+
+## Test Structure
+
+### Unit Tests
+Located in `apps/api/src/` alongside source files with `.spec.ts` suffix.
+- Authentication service tests
+- Device token generation and validation
+- Command creation and acknowledgement
+- Venue isolation enforcement
+- Rate limiting
+
+### Integration/E2E Tests
+Located in `apps/api/test/` with `.e2e-spec.ts` suffix.
+- Login flow
+- Device registration and sync
+- Command lifecycle (create → sync → ack)
+- Device revocation
+- Cross-venue access prevention
+
+## Writing Tests
+
+```typescript
+import { Test, TestingModule } from '@nestjs/testing';
+import { AuthService } from './auth.service';
+
+describe('AuthService', () => {
+  let service: AuthService;
+
+  beforeEach(async () => {
+    const module: TestingModule = await Test.createTestingModule({
+      providers: [AuthService, /* mocks */],
+    }).compile();
+
+    service = module.get<AuthService>(AuthService);
+  });
+
+  it('should generate valid device tokens', () => {
+    // ...
+  });
+});
+```