feat: ENABLE_MINI feature flag + conditional build (#409)

next.config.mjs

@@ -1,4 +1,6 @@
 /** @type {import('next').NextConfig} */
+const enableMini = process.env.ENABLE_MINI === 'true'
+
 const nextConfig = {
   // Source maps for debugging production crashes
   productionBrowserSourceMaps: true,
@@ -27,6 +29,16 @@ const nextConfig = {
       test: /\.po$/,
       use: ['@lingui/loader'],
     })
+
+    // When ENABLE_MINI is not set, replace Mini modules with empty stubs
+    // so zero Mini code (including PubNub SDK) is bundled.
+    if (!enableMini) {
+      config.resolve.alias = {
+        ...config.resolve.alias,
+        pubnub: false,
+      }
+    }
+
     return config
   },
   reactCompiler: false,

package.json

@@ -69,6 +69,9 @@
     "zod": "^4.3.6",
     "zod-openapi": "^5.4.6"
   },
+  "optionalDependencies": {
+    "pubnub": "^10.2.9"
+  },
   "devDependencies": {
     "@babel/preset-typescript": "^7.28.5",
     "@eslint/css": "^1.0.0",

src/server/routers/app.ts

@@ -13,6 +13,13 @@ import { waterLevelRouter } from './waterLevel'
 import { runOnceRouter } from './runOnce'
 import { scheduleGroupsRouter } from './scheduleGroups'
 
+// Mini router — conditional dynamic import, only loaded when ENABLE_MINI=true.
+// When disabled: no Mini code is bundled (webpack resolve alias → false),
+// no PubNub SDK loaded, no Mini routes registered.
+const miniRouter = process.env.ENABLE_MINI === 'true'
+  ? (await import('./mini')).miniRouter
+  : null
+
 export const appRouter = router({
   healthcheck: publicProcedure
     .meta({ openapi: { method: 'GET', path: '/healthcheck', protect: false, tags: ['Health'] } })
@@ -35,6 +42,7 @@ export const appRouter = router({
   waterLevel: waterLevelRouter,
   runOnce: runOnceRouter,
   scheduleGroups: scheduleGroupsRouter,
+  ...(miniRouter ? { mini: miniRouter } : {}),
 })
 
 export type AppRouter = typeof appRouter

src/server/routers/mini.ts

@@ -0,0 +1,12 @@
+import { z } from 'zod'
+import { publicProcedure, router } from '@/src/server/trpc'
+
+export const miniRouter = router({
+  status: publicProcedure
+    .meta({ openapi: { method: 'GET', path: '/mini/status', protect: false, tags: ['Mini'] } })
+    .input(z.object({}))
+    .output(z.object({
+      enabled: z.boolean(),
+    }))
+    .query(() => ({ enabled: true })),
+})

src/services/mini/client.ts

@@ -0,0 +1,11 @@
+/**
+ * Snoo client — Auth (OAuth PKCE) and data API.
+ * Stub: implementation comes in the TS Snoo client step.
+ */
+
+export class SnooClient {
+  // OAuth PKCE auth flow to Happiest Baby
+  async authenticate(): Promise<void> {
+    throw new Error('Not implemented — awaiting TS Snoo client step')
+  }
+}

src/services/mini/index.ts

@@ -0,0 +1,3 @@
+export { SnooClient } from './client'
+export { MiniPubNubManager } from './pubnub'
+export type { MiniSession, MiniStatus, MiniSettings, MiniLevel, MiniCommand } from './types'

src/services/mini/pubnub.ts

@@ -0,0 +1,14 @@
+/**
+ * PubNub subscription manager for real-time Snoo state and commands.
+ * Stub: implementation comes in the TS Snoo client step.
+ */
+
+export class MiniPubNubManager {
+  async connect(): Promise<void> {
+    throw new Error('Not implemented — awaiting TS Snoo client step')
+  }
+
+  async disconnect(): Promise<void> {
+    // no-op until implemented
+  }
+}

src/services/mini/types.ts

@@ -0,0 +1,29 @@
+/**
+ * TypeScript types matching the Snoo data model.
+ * Populated in the TS Snoo client implementation step.
+ */
+
+export interface MiniSession {
+  sessionId: string
+  startTime: string
+  endTime?: string
+  levels: MiniLevel[]
+}
+
+export interface MiniStatus {
+  isOnline: boolean
+  babyName?: string
+  firmwareVersion?: string
+  lastSSID?: string
+}
+
+export interface MiniSettings {
+  responsiveness: 'low' | 'normal' | 'high'
+  volume: number
+  weaning: boolean
+  motionLimiter: boolean
+}
+
+export type MiniLevel = 'baseline' | 'level1' | 'level2' | 'level3' | 'level4'
+
+export type MiniCommand = 'start' | 'stop' | 'level_up' | 'level_down' | 'toggle'