chore: implement Phase 3 initial setup (TypeScript cleanup and health test)

apps/api/src/index.ts

@@ -24,7 +24,7 @@ const server: FastifyInstance = fastify({
 });
 
 // Attach prisma to server instance for global access in routes
-(server as any).prisma = prisma;
+server.decorate('prisma', prisma);
 
 // ── Middleware & Plugins ──────────────────────────────────────────────────────
 server.register(cors, {

apps/api/src/routes/internal.ts

@@ -27,13 +27,13 @@ export async function internalRoutes(fastify: FastifyInstance) {
     const serverAdapter = new FastifyAdapter();
 
     createBullBoard({
-        queues: [new BullMQAdapter(whatsappQueue as any)],
+        queues: [new BullMQAdapter(whatsappQueue as any)], // Queue types are notoriously difficult to match with BullMQAdapter
         serverAdapter,
     });
 
     // Re-enabled BullBoard for production monitoring
     serverAdapter.setBasePath('/v1/internal/queues');
-    fastify.register(serverAdapter.registerPlugin() as any, {
+    fastify.register(serverAdapter.registerPlugin(), {
         prefix: '/v1/internal/queues',
         basePath: '/v1/internal/queues',
         config: { requireAuth: true }

apps/api/src/types/fastify.d.ts

@@ -10,6 +10,7 @@ declare module 'fastify' {
     interface FastifyRequest {
         jwtVerify(): Promise<void>;
         rawBody?: Buffer;
+        organizationId?: string; // For internal forwarding context
         user: {
             id: string;
             organizationId: string;

apps/api/test/health.test.ts

@@ -0,0 +1,45 @@
+import { describe, it, expect, beforeAll, afterAll } from 'vitest';
+import fastify, { FastifyInstance } from 'fastify';
+import { whatsappRoutes } from '../src/routes/whatsapp';
+import { authRoutes } from '../src/routes/auth';
+
+describe('API Health & Basic Routing', () => {
+    let server: FastifyInstance;
+
+    beforeAll(async () => {
+        server = fastify({ logger: false });
+        // Register minimal routes for health check
+        await server.register(authRoutes, { prefix: '/v1/auth' });
+        await server.register(whatsappRoutes, { prefix: '/v1/whatsapp' });
+        await server.ready();
+    });
+
+    afterAll(async () => {
+        await server.close();
+    });
+
+    it('should respond with 200 on WhatsApp webhook GET (Verification)', async () => {
+        const response = await server.inject({
+            method: 'GET',
+            url: '/v1/whatsapp/webhook',
+            query: {
+                'hub.mode': 'subscribe',
+                'hub.verify_token': process.env.WHATSAPP_VERIFY_TOKEN || 'test-token',
+                'hub.challenge': '1234'
+            }
+        });
+
+        expect(response.statusCode).toBe(200);
+        expect(response.payload).toBe('1234');
+    });
+
+    it('should have a working Auth registration endpoint structure', async () => {
+        const response = await server.inject({
+            method: 'POST',
+            url: '/v1/auth/register',
+            payload: {} // Empty payload should trigger validation error, not 404
+        });
+
+        expect(response.statusCode).not.toBe(404);
+    });
+});