@camstack/server 0.1.7 → 0.2.0

package/src/__tests__/embedded-deps-e2e.test.ts

@@ -1,4 +1,3 @@
- 
 /**
  * Embedded dependencies E2E — verify ffmpeg/python resolution and download.
  *
@@ -11,9 +10,19 @@ import * as path from 'node:path'
 import * as os from 'node:os'
 // Import directly from source submodules because vitest+swc doesn't resolve
 // `export * from './deps/index.js'` barrel re-exports in the @camstack/core index.
-import { findInPath, getPlatformInfo, buildBinaryPath } from '../../../../packages/core/src/deps/binary-downloader'
-import { getFfmpegDownloadUrl, ensureFfmpeg } from '../../../../packages/core/src/deps/ffmpeg-downloader'
-import { getPythonDownloadUrl, ensurePython } from '../../../../packages/core/src/deps/python-downloader'
+import {
+  findInPath,
+  getPlatformInfo,
+  buildBinaryPath,
+} from '../../../../packages/core/src/deps/binary-downloader'
+import {
+  getFfmpegDownloadUrl,
+  ensureFfmpeg,
+} from '../../../../packages/core/src/deps/ffmpeg-downloader'
+import {
+  getPythonDownloadUrl,
+  ensurePython,
+} from '../../../../packages/core/src/deps/python-downloader'
 import type { IScopedLogger } from '@camstack/types'
 
 function createMockLogger(): IScopedLogger {
@@ -27,7 +36,6 @@ function createMockLogger(): IScopedLogger {
   return logger
 }
 
- 
 const mockLogger = createMockLogger()
 
 describe('Embedded Dependencies E2E', () => {
@@ -71,11 +79,15 @@ describe('Embedded Dependencies E2E', () => {
 
     // Only run download test if explicitly enabled (downloads ~80MB)
     const downloadTest = process.env.CAMSTACK_TEST_DOWNLOAD === 'true' ? it : it.skip
-    downloadTest('downloads ffmpeg binary', async () => {
-      const ffmpegPath = await ensureFfmpeg(tmpDir, mockLogger)
-      expect(ffmpegPath).toBeTruthy()
-      expect(fs.existsSync(ffmpegPath)).toBe(true)
-    }, 120000)
+    downloadTest(
+      'downloads ffmpeg binary',
+      async () => {
+        const ffmpegPath = await ensureFfmpeg(tmpDir, mockLogger)
+        expect(ffmpegPath).toBeTruthy()
+        expect(fs.existsSync(ffmpegPath)).toBe(true)
+      },
+      120000,
+    )
   })
 
   describe('Python', () => {
@@ -95,15 +107,19 @@ describe('Embedded Dependencies E2E', () => {
 
     // Only run download test if explicitly enabled (downloads ~25MB)
     const downloadTest = process.env.CAMSTACK_TEST_DOWNLOAD === 'true' ? it : it.skip
-    downloadTest('downloads portable Python', async () => {
-      const pythonPath = await ensurePython(tmpDir, mockLogger)
-      expect(pythonPath).toBeTruthy()
-      expect(fs.existsSync(pythonPath!)).toBe(true)
+    downloadTest(
+      'downloads portable Python',
+      async () => {
+        const pythonPath = await ensurePython(tmpDir, mockLogger)
+        expect(pythonPath).toBeTruthy()
+        expect(fs.existsSync(pythonPath!)).toBe(true)
 
-      // Verify it actually runs
-      const { execFileSync } = await import('node:child_process')
-      const version = execFileSync(pythonPath!, ['--version'], { encoding: 'utf8' }).trim()
-      expect(version).toMatch(/Python 3\.12/)
-    }, 120000)
+        // Verify it actually runs
+        const { execFileSync } = await import('node:child_process')
+        const version = execFileSync(pythonPath!, ['--version'], { encoding: 'utf8' }).trim()
+        expect(version).toMatch(/Python 3\.12/)
+      },
+      120000,
+    )
   })
 })

package/src/__tests__/event-bus-proxy-router.spec.ts

@@ -20,6 +20,7 @@ describe('event-bus-proxy router', () => {
       id: 'evt-1',
       timestamp: '2026-01-15T10:00:00.000Z',
       source: { type: 'addon', id: 'my-addon' },
+      // biome-ignore lint/plugin: synthetic test-only event category
       category: 'motion',
       data: { zone: 'front' },
     })
@@ -43,6 +44,7 @@ describe('event-bus-proxy router', () => {
       id: 'evt-2',
       timestamp: '2026-01-15T10:00:00.000Z',
       source: { type: 'device', id: 'cam-1' },
+      // biome-ignore lint/plugin: synthetic test-only event category
       category: 'alert',
       data: {},
     })
@@ -61,6 +63,7 @@ describe('event-bus-proxy router', () => {
       id: 'evt-3',
       timestamp: isoString,
       source: { type: 'addon', id: 'test' },
+      // biome-ignore lint/plugin: synthetic test-only event category
       category: 'info',
       data: {},
     })

package/src/__tests__/framework-allowlist.spec.ts

@@ -37,10 +37,11 @@ function readPackageJson(pkgJsonPath: string): PackageJsonView | null {
     const name = obj['name']
     if (typeof name !== 'string') return null
     const camstack = obj['camstack']
-    const isSystem = camstack !== null
-      && typeof camstack === 'object'
-      && !Array.isArray(camstack)
-      && (camstack as Record<string, unknown>)['system'] === true
+    const isSystem =
+      camstack !== null &&
+      typeof camstack === 'object' &&
+      !Array.isArray(camstack) &&
+      (camstack as Record<string, unknown>)['system'] === true
     return { name, system: isSystem, path: pkgJsonPath }
   } catch {
     return null

package/src/__tests__/https-e2e.test.ts

@@ -74,7 +74,9 @@ describe('HTTPS E2E', () => {
           { hostname: '127.0.0.1', port, path: '/', method: 'GET', rejectUnauthorized: false },
           (res) => {
             let data = ''
-            res.on('data', (c) => { data += c })
+            res.on('data', (c) => {
+              data += c
+            })
             res.on('end', () => resolve(data))
           },
         )
@@ -103,11 +105,15 @@ describe('HTTPS E2E', () => {
 
     try {
       const body = await new Promise<string>((resolve, reject) => {
-        http.get(`http://127.0.0.1:${port}/`, (res) => {
-          let data = ''
-          res.on('data', (c) => { data += c })
-          res.on('end', () => resolve(data))
-        }).on('error', reject)
+        http
+          .get(`http://127.0.0.1:${port}/`, (res) => {
+            let data = ''
+            res.on('data', (c) => {
+              data += c
+            })
+            res.on('end', () => resolve(data))
+          })
+          .on('error', reject)
       })
 
       expect(body).toBe('http-ok')

package/src/__tests__/lifecycle-e2e.test.ts

@@ -1,4 +1,3 @@
- 
 import { describe, it, expect, vi } from 'vitest'
 import { CapabilityRegistry, isInfraCapability } from '@camstack/kernel'
 import type { IScopedLogger } from '@camstack/types'
@@ -36,12 +35,42 @@ describe('Full Lifecycle E2E (mock, no external services)', () => {
     it('registers singleton and collection capabilities correctly', () => {
       const registry = createRegistry()
 
-      registry.declareCapability({ name: 'storage', scope: 'system', mode: 'singleton', methods: {} })
-      registry.declareCapability({ name: 'log-destination', scope: 'system', mode: 'collection', methods: {} })
-      registry.declareCapability({ name: 'streaming-engine', scope: 'system', mode: 'singleton', methods: {} })
-      registry.declareCapability({ name: 'analysis-pipeline', scope: 'system', mode: 'singleton', methods: {} })
-      registry.declareCapability({ name: 'device-provider', scope: 'system', mode: 'collection', methods: {} })
-      registry.declareCapability({ name: 'admin-ui', scope: 'system', mode: 'singleton', methods: {} })
+      registry.declareCapability({
+        name: 'storage',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'log-destination',
+        scope: 'system',
+        mode: 'collection',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'streaming-engine',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'analysis-pipeline',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'device-provider',
+        scope: 'system',
+        mode: 'collection',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'admin-ui',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
 
       const mockStorage = { id: 'sqlite' }
       const mockLogger = { id: 'winston' }
@@ -79,7 +108,12 @@ describe('Full Lifecycle E2E (mock, no external services)', () => {
   describe('Singleton swap', () => {
     it('swapping analysis provider changes getSingleton result', async () => {
       const registry = createRegistry()
-      registry.declareCapability({ name: 'analysis-pipeline', scope: 'system', mode: 'singleton', methods: {} })
+      registry.declareCapability({
+        name: 'analysis-pipeline',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
 
       const analysisA = { id: 'analysis-a', processFrame: vi.fn() }
       const analysisB = { id: 'analysis-b', processFrame: vi.fn() }
@@ -97,7 +131,12 @@ describe('Full Lifecycle E2E (mock, no external services)', () => {
   describe('Collection capability add/remove', () => {
     it('adding and removing device providers', () => {
       const registry = createRegistry()
-      registry.declareCapability({ name: 'device-provider', scope: 'system', mode: 'collection', methods: {} })
+      registry.declareCapability({
+        name: 'device-provider',
+        scope: 'system',
+        mode: 'collection',
+        methods: {},
+      })
 
       const frigate = { id: 'frigate', type: 'frigate' }
       const onvif = { id: 'onvif', type: 'onvif' }
@@ -116,8 +155,18 @@ describe('Full Lifecycle E2E (mock, no external services)', () => {
   describe('Capability introspection', () => {
     it('listCapabilities returns full info', () => {
       const registry = createRegistry()
-      registry.declareCapability({ name: 'storage', scope: 'system', mode: 'singleton', methods: {} })
-      registry.declareCapability({ name: 'device-provider', scope: 'system', mode: 'collection', methods: {} })
+      registry.declareCapability({
+        name: 'storage',
+        scope: 'system',
+        mode: 'singleton',
+        methods: {},
+      })
+      registry.declareCapability({
+        name: 'device-provider',
+        scope: 'system',
+        mode: 'collection',
+        methods: {},
+      })
 
       registry.registerProvider('storage', 'sqlite', { id: 'sqlite' })
       registry.registerProvider('device-provider', 'frigate', { id: 'frigate' })

package/src/__tests__/live-events-subscription.spec.ts

@@ -30,10 +30,9 @@ function makeEvent(category: string, data: Record<string, unknown> = {}) {
 describe('live events subscription', () => {
   it('delivers events emitted AFTER subscription', async () => {
     const bus = new SystemEventBus() as unknown as EventBusService
-    const router = createLiveEventsRouter(
-      bus,
-      { getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }) } as never,
-    )
+    const router = createLiveEventsRouter(bus, {
+      getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }),
+    } as never)
     const caller = router.createCaller(makeCtx('admin'))
 
     const iter = await caller.onEvent({ category: 'benchmark.progress' })
@@ -63,10 +62,9 @@ describe('live events subscription', () => {
 
   it('filters events that do not match the requested category', async () => {
     const bus = new SystemEventBus() as unknown as EventBusService
-    const router = createLiveEventsRouter(
-      bus,
-      { getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }) } as never,
-    )
+    const router = createLiveEventsRouter(bus, {
+      getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }),
+    } as never)
     const caller = router.createCaller(makeCtx('admin'))
 
     const iter = await caller.onEvent({ category: 'benchmark.progress' })
@@ -76,7 +74,10 @@ describe('live events subscription', () => {
     const collector = (async () => {
       for await (const ev of iter) {
         received.push(ev.category)
-        if (received.length >= 2) { stop(); return }
+        if (received.length >= 2) {
+          stop()
+          return
+        }
       }
     })()
 
@@ -97,10 +98,9 @@ describe('live events subscription', () => {
 
   it('receives recent events via recentSystemEvents query', async () => {
     const bus = new SystemEventBus() as unknown as EventBusService
-    const router = createLiveEventsRouter(
-      bus,
-      { getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }) } as never,
-    )
+    const router = createLiveEventsRouter(bus, {
+      getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }),
+    } as never)
     const caller = router.createCaller(makeCtx('admin'))
 
     bus.emit(makeEvent('benchmark.progress', { iteration: 1 }))
@@ -110,7 +110,7 @@ describe('live events subscription', () => {
     const recent = await caller.recentSystemEvents({ category: 'benchmark.progress', limit: 10 })
     expect(recent).toHaveLength(2)
     // recentSystemEvents returns newest-first
-    const iterations = recent.map((e) => e.data.iteration as number).sort((a, b) => a - b)
+    const iterations = recent.map((e) => e.data.iteration as number).toSorted((a, b) => a - b)
     expect(iterations).toEqual([1, 2])
   })
 
@@ -118,10 +118,9 @@ describe('live events subscription', () => {
     // Reproduces the benchmark scenario where runBenchmark emits 3 events
     // back-to-back; the subscription should buffer them and deliver all 3.
     const bus = new SystemEventBus() as unknown as EventBusService
-    const router = createLiveEventsRouter(
-      bus,
-      { getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }) } as never,
-    )
+    const router = createLiveEventsRouter(bus, {
+      getDeviceRegistry: () => ({ getAll: () => [], getAllForAddon: () => [] }),
+    } as never)
     const caller = router.createCaller(makeCtx('admin'))
 
     const iter = await caller.onEvent({ category: 'benchmark.progress' })

package/src/__tests__/moleculer/uds-readiness.spec.ts

@@ -71,7 +71,9 @@ describe('D1 — wireReadinessSnapshotHandler', () => {
 
     let capturedHandler: (() => readonly IReadinessRegistryRecord[]) | null = null
     const childReg: FakeLocalChildRegistry = {
-      onReadinessSnapshotRequest: (h) => { capturedHandler = h },
+      onReadinessSnapshotRequest: (h) => {
+        capturedHandler = h
+      },
     }
     const readinessReg: FakeReadinessRegistry = {
       getSnapshotForTransport: () => records,
@@ -85,7 +87,8 @@ describe('D1 — wireReadinessSnapshotHandler', () => {
   })
 
   it('handler calls getSnapshotForTransport on every invocation (live snapshot)', () => {
-    const getSnapshot = vi.fn<[], readonly IReadinessRegistryRecord[]>()
+    const getSnapshot = vi
+      .fn<[], readonly IReadinessRegistryRecord[]>()
       .mockReturnValueOnce([])
       .mockReturnValueOnce([
         {
@@ -101,7 +104,9 @@ describe('D1 — wireReadinessSnapshotHandler', () => {
 
     let capturedHandler: (() => readonly IReadinessRegistryRecord[]) | null = null
     const childReg: FakeLocalChildRegistry = {
-      onReadinessSnapshotRequest: (h) => { capturedHandler = h },
+      onReadinessSnapshotRequest: (h) => {
+        capturedHandler = h
+      },
     }
     const readinessReg: FakeReadinessRegistry = { getSnapshotForTransport: getSnapshot }
 
@@ -120,7 +125,9 @@ describe('D1 — wireReadinessSnapshotHandler', () => {
 
     let capturedHandler: (() => readonly IReadinessRegistryRecord[]) | null = null
     const childReg: FakeLocalChildRegistry = {
-      onReadinessSnapshotRequest: (h) => { capturedHandler = h },
+      onReadinessSnapshotRequest: (h) => {
+        capturedHandler = h
+      },
     }
 
     wireReadinessSnapshotHandler(childReg, readinessReg)

package/src/__tests__/moleculer/uds-topology.spec.ts

@@ -97,8 +97,12 @@ describe('E1 — wireHubChildManifest', () => {
     let capturedGoneHandler: ((childId: string) => void) | null = null
 
     const registry: FakeLocalChildRegistry = {
-      onChildRegistered: (h) => { capturedRegisteredHandler = h },
-      onChildGone: (h) => { capturedGoneHandler = h },
+      onChildRegistered: (h) => {
+        capturedRegisteredHandler = h
+      },
+      onChildGone: (h) => {
+        capturedGoneHandler = h
+      },
       setChildLogLevel: vi.fn<[string, string], boolean>().mockReturnValue(false),
     }
 
@@ -130,7 +134,9 @@ describe('E1 — wireHubChildManifest', () => {
 
     const registry: FakeLocalChildRegistry = {
       onChildRegistered: vi.fn(),
-      onChildGone: (h) => { capturedGoneHandler = h },
+      onChildGone: (h) => {
+        capturedGoneHandler = h
+      },
       setChildLogLevel: vi.fn<[string, string], boolean>().mockReturnValue(false),
     }
 
@@ -155,8 +161,12 @@ describe('E1 — wireHubChildManifest', () => {
     let goneHandler: ((childId: string) => void) | null = null
 
     const registry: FakeLocalChildRegistry = {
-      onChildRegistered: (h) => { registeredHandler = h },
-      onChildGone: (h) => { goneHandler = h },
+      onChildRegistered: (h) => {
+        registeredHandler = h
+      },
+      onChildGone: (h) => {
+        goneHandler = h
+      },
       setChildLogLevel: vi.fn<[string, string], boolean>().mockReturnValue(false),
     }
 
@@ -249,11 +259,15 @@ describe('E1 — idempotency (double-registration via RPC + UDS)', () => {
     // so the second call is a no-op at the CapabilityRegistry level.
     // Here we verify that onChildRegistered fires ONCE per UDS connect.
     let callCount = 0
-    const applyChildManifest = vi.fn<[string, readonly ChildCapDescriptor[]], void>(() => { callCount++ })
+    const applyChildManifest = vi.fn<[string, readonly ChildCapDescriptor[]], void>(() => {
+      callCount++
+    })
 
     let registeredHandler: ((child: RegisteredChild) => void) | null = null
     const registry: FakeLocalChildRegistry = {
-      onChildRegistered: (h) => { registeredHandler = h },
+      onChildRegistered: (h) => {
+        registeredHandler = h
+      },
       onChildGone: vi.fn(),
       setChildLogLevel: vi.fn<[string, string], boolean>().mockReturnValue(false),
     }
@@ -287,7 +301,9 @@ describe('E1 — idempotency (double-registration via RPC + UDS)', () => {
     let registeredHandler: ((child: RegisteredChild) => void) | null = null
 
     const registry: FakeLocalChildRegistry = {
-      onChildRegistered: (h) => { registeredHandler = h },
+      onChildRegistered: (h) => {
+        registeredHandler = h
+      },
       onChildGone: vi.fn(),
       setChildLogLevel: vi.fn<[string, string], boolean>().mockReturnValue(false),
     }
@@ -333,7 +349,11 @@ describe('E2 — LocalChildRegistry.setChildLogLevel (real implementation)', ()
     const result = registry.setChildLogLevel('unknown-child', 'debug')
     expect(result).toBe(false)
     // Cleanup: close the server without starting (no-op on most implementations).
-    try { await registry.close() } catch { /* server was never started */ }
+    try {
+      await registry.close()
+    } catch {
+      /* server was never started */
+    }
   })
 
   it('setProcessLogLevel falls back to Moleculer when setChildLogLevel returns false', () => {
@@ -344,7 +364,11 @@ describe('E2 — LocalChildRegistry.setChildLogLevel (real implementation)', ()
     // and the Moleculer fallback is invoked.
     const moleculerFallback = vi.fn<[string, string], void>()
 
-    const simulateSetProcessLogLevel = (nodeId: string, level: string, udsResult: boolean): void => {
+    const simulateSetProcessLogLevel = (
+      nodeId: string,
+      level: string,
+      udsResult: boolean,
+    ): void => {
       if (!udsResult) {
         moleculerFallback(nodeId, level)
       }
@@ -367,7 +391,11 @@ describe('E2 — LocalChildRegistry.setChildLogLevel (real implementation)', ()
     // We test the routing logic inline (no full MoleculerService instantiation).
     const hubNodeId = 'hub'
 
-    const routeSetLogLevel = (nodeId: string, level: string, registry: { setChildLogLevel(id: string, lvl: string): boolean } | null): boolean => {
+    const routeSetLogLevel = (
+      nodeId: string,
+      level: string,
+      registry: { setChildLogLevel(id: string, lvl: string): boolean } | null,
+    ): boolean => {
       if (!nodeId.startsWith(`${hubNodeId}/`)) return false
       const childId = nodeId.slice(hubNodeId.length + 1)
       if (registry === null) return false