@camstack/server 0.1.7 → 0.2.0

package/src/core/repl/repl-engine.service.spec.ts

@@ -14,7 +14,7 @@ import { ReplEngineService } from './repl-engine.service'
 import { SystemEventBus } from '@camstack/core'
 import type { ReplSessionContext } from '@camstack/core'
 import type { DeviceBinding } from '@camstack/types'
-import { DeviceType } from '@camstack/types'
+import { DeviceType, EventCategory } from '@camstack/types'
 
 // ── In-process broker api fixture ─────────────────────────────────────
 //
@@ -26,19 +26,22 @@ import { DeviceType } from '@camstack/types'
 interface BrokerApiState {
   bindings: Map<number, DeviceBinding>
   snapshots: Record<string, Record<string, Record<string, unknown>>>
-  devices: Map<number, {
-    id: number
-    stableId: string
-    addonId: string
-    type: DeviceType
-    name: string
-    parentDeviceId: number | null
-    role: string | null
-    online: boolean
-    features: string[]
-    isCamera: boolean
-    config: Record<string, unknown>
-  }>
+  devices: Map<
+    number,
+    {
+      id: number
+      stableId: string
+      addonId: string
+      type: DeviceType
+      name: string
+      parentDeviceId: number | null
+      role: string | null
+      online: boolean
+      features: string[]
+      isCamera: boolean
+      config: Record<string, unknown>
+    }
+  >
 }
 
 function makeBrokerApi(state: BrokerApiState): unknown {
@@ -51,14 +54,18 @@ function makeBrokerApi(state: BrokerApiState): unknown {
         query: vi.fn(async () => Array.from(state.devices.values())),
       },
       getBindings: {
-        query: vi.fn(async ({ deviceId }: { deviceId: number }) =>
-          state.bindings.get(deviceId) ?? { deviceId, entries: [] }),
+        query: vi.fn(
+          async ({ deviceId }: { deviceId: number }) =>
+            state.bindings.get(deviceId) ?? { deviceId, entries: [] },
+        ),
       },
     },
     deviceState: {
       getCapSlice: {
-        query: vi.fn(async ({ deviceId, capName }: { deviceId: number; capName: string }) =>
-          state.snapshots[String(deviceId)]?.[capName] ?? null),
+        query: vi.fn(
+          async ({ deviceId, capName }: { deviceId: number; capName: string }) =>
+            state.snapshots[String(deviceId)]?.[capName] ?? null,
+        ),
       },
       getAllSnapshots: {
         query: vi.fn(async () => state.snapshots),
@@ -123,7 +130,13 @@ function makeHarness(seed?: Partial<BrokerApiState>): Harness {
   } as any
 
   const loggingService = {
-    createLogger: () => ({ info: vi.fn(), child: vi.fn(), debug: vi.fn(), warn: vi.fn(), error: vi.fn() }),
+    createLogger: () => ({
+      info: vi.fn(),
+      child: vi.fn(),
+      debug: vi.fn(),
+      warn: vi.fn(),
+      error: vi.fn(),
+    }),
   } as any
 
   const service = new ReplEngineService(addonRegistry, eventBusService, loggingService)
@@ -141,20 +154,24 @@ const mkBinding = (deviceId: number, capNames: string[]): DeviceBinding => ({
   })),
 })
 
-const mkDevice = (id: number, overrides: Partial<BrokerApiState['devices'] extends Map<number, infer V> ? V : never> = {}): BrokerApiState['devices'] extends Map<number, infer V> ? V : never => ({
-  id,
-  stableId: `stable-${id}`,
-  addonId: 'addon-test',
-  type: DeviceType.Camera,
-  name: `Device ${id}`,
-  parentDeviceId: null,
-  role: null,
-  online: true,
-  features: [],
-  isCamera: true,
-  config: {},
-  ...overrides,
-} as any)
+const mkDevice = (
+  id: number,
+  overrides: Partial<BrokerApiState['devices'] extends Map<number, infer V> ? V : never> = {},
+): BrokerApiState['devices'] extends Map<number, infer V> ? V : never =>
+  ({
+    id,
+    stableId: `stable-${id}`,
+    addonId: 'addon-test',
+    type: DeviceType.Camera,
+    name: `Device ${id}`,
+    parentDeviceId: null,
+    role: null,
+    online: true,
+    features: [],
+    isCamera: true,
+    config: {},
+    ...overrides,
+  }) as any
 
 const SYSTEM_CTX: ReplSessionContext = { scope: { type: 'system' }, variables: {} }
 
@@ -162,7 +179,9 @@ const SYSTEM_CTX: ReplSessionContext = { scope: { type: 'system' }, variables: {
 
 describe('ReplEngineService — basic eval', () => {
   let h: Harness
-  beforeEach(() => { h = makeHarness() })
+  beforeEach(() => {
+    h = makeHarness()
+  })
 
   it('evaluates simple arithmetic expressions', async () => {
     const r = await h.service.execute('1 + 1', SYSTEM_CTX)
@@ -220,7 +239,10 @@ describe('ReplEngineService — system scope sandbox', () => {
   })
 
   it('sm.getDeviceById returns a typed proxy with sync state', async () => {
-    const r = await h.service.execute('sm.getDeviceById(1).state.battery.value.sleeping', SYSTEM_CTX)
+    const r = await h.service.execute(
+      'sm.getDeviceById(1).state.battery.value.sleeping',
+      SYSTEM_CTX,
+    )
     expect(r.type).toBe('value')
     expect(r.output).toBe('true')
   })
@@ -309,7 +331,7 @@ describe('ReplEngineService — device scope sandbox', () => {
 })
 
 describe('ReplEngineService — SystemManager warm-boot resilience', () => {
-  it('warm-boot does NOT hang on `live.onEvent` (regression — broker can\'t route)', async () => {
+  it("warm-boot does NOT hang on `live.onEvent` (regression — broker can't route)", async () => {
     // The bug: `getBrokerApi().live.onEvent.subscribe(...)` polls
     // forever for a Moleculer service that doesn't exist. The fix
     // injects a direct EventBus adapter for `live` so SM init never
@@ -363,21 +385,26 @@ describe('ReplEngineService — SystemManager warm-boot resilience', () => {
     h.eventBus.emit({
       id: 'test-1',
       timestamp: Date.now(),
-      category: 'device.state-changed',
+      category: EventCategory.DeviceStateChanged,
       source: { type: 'device', id: 1, deviceId: 1 },
       data: { deviceId: 1, capName: 'battery', slice: { sleeping: false, percentage: 90 } },
     })
     // Microtask flush.
     await new Promise((r) => setTimeout(r, 10))
 
-    const r = await h.service.execute('sm.getDeviceById(1).state.battery.value.sleeping', SYSTEM_CTX)
+    const r = await h.service.execute(
+      'sm.getDeviceById(1).state.battery.value.sleeping',
+      SYSTEM_CTX,
+    )
     expect(r.output).toBe('false')
   })
 })
 
 describe('ReplEngineService — error paths', () => {
   let h: Harness
-  beforeEach(() => { h = makeHarness() })
+  beforeEach(() => {
+    h = makeHarness()
+  })
 
   it('returns error when accessing undefined variables', async () => {
     const r = await h.service.execute('undefinedVariable.foo', SYSTEM_CTX)

package/src/core/repl/repl-engine.service.ts

@@ -35,16 +35,13 @@ export class ReplEngineService extends ReplEngine {
       live: {
         onEvent: {
           subscribe: (input, opts) => {
-            const off = eventBus.subscribe(
-              { category: input.category },
-              (evt) => {
-                try {
-                  opts.onData({ data: evt.data })
-                } catch (err) {
-                  opts.onError?.(err)
-                }
-              },
-            )
+            const off = eventBus.subscribe({ category: input.category }, (evt) => {
+              try {
+                opts.onData({ data: evt.data })
+              } catch (err) {
+                opts.onError?.(err)
+              }
+            })
             return { unsubscribe: off }
           },
         },
@@ -96,7 +93,8 @@ export class ReplEngineService extends ReplEngine {
           integrations: async () => (await integrationRegistry?.listIntegrations()) ?? [],
           addons: () => addonRegistry.listAddons(),
           getDevice: (id: number) => deviceRegistry.getById(id),
-          getIntegration: async (id: string) => (await integrationRegistry?.getIntegration(id)) ?? null,
+          getIntegration: async (id: string) =>
+            (await integrationRegistry?.getIntegration(id)) ?? null,
           getSystemMirror: () => Promise.resolve(sm),
         }
       },
@@ -131,7 +129,8 @@ export class ReplEngineService extends ReplEngine {
         const deviceRegistry = addonRegistry.getDeviceRegistry()
         const devices = deviceRegistry.getAllForAddon(addonId)
         return {
-          getIntegration: () => integrationRegistry?.getIntegration(addonId) ?? Promise.resolve(null),
+          getIntegration: () =>
+            integrationRegistry?.getIntegration(addonId) ?? Promise.resolve(null),
           devices,
         }
       },

package/src/core/storage/storage-location-manager.spec.ts

@@ -63,8 +63,15 @@ describe('StorageLocationManager', () => {
   it('getLocationNames returns all 6 location names', async () => {
     await manager.initializeDefaults()
     const names = manager.getLocationNames()
-    const expected: StorageLocationName[] = ['data', 'media', 'recordings', 'models', 'cache', 'logs']
-    expect(names.sort()).toEqual(expected.sort())
+    const expected: StorageLocationName[] = [
+      'data',
+      'media',
+      'recordings',
+      'models',
+      'cache',
+      'logs',
+    ]
+    expect(names.toSorted()).toEqual(expected.toSorted())
   })
 
   it('resolve joins subpath correctly within a location', async () => {
@@ -116,6 +123,8 @@ describe('StorageLocationManager', () => {
   })
 
   it('resolve on uninitialized location throws error', () => {
-    expect(() => manager.resolve('media', 'file.mp4')).toThrow('Storage location "media" not initialized')
+    expect(() => manager.resolve('media', 'file.mp4')).toThrow(
+      'Storage location "media" not initialized',
+    )
   })
 })

package/src/core/streaming/stream-probe.service.ts

@@ -25,9 +25,7 @@ export class StreamProbeService {
   private readonly logger: IScopedLogger
   private readonly cache = new Map<string, CacheEntry>()
 
-  constructor(
-    loggingService: LoggingService,
-  ) {
+  constructor(loggingService: LoggingService) {
     this.logger = loggingService.createLogger('StreamProbeService')
   }
 
@@ -55,7 +53,10 @@ export class StreamProbeService {
    * Generic field probe: given a field key and value, decides how to probe.
    * Stream fields (stream_*) → ffprobe, other URLs → HTTP HEAD check.
    */
-  async probeField(key: string, value: unknown): Promise<{ status: 'ok' | 'error'; labels?: string[]; error?: string }> {
+  async probeField(
+    key: string,
+    value: unknown,
+  ): Promise<{ status: 'ok' | 'error'; labels?: string[]; error?: string }> {
     const url = String(value ?? '').trim()
     if (!url) {
       return { status: 'error', error: 'No URL provided' }
@@ -131,15 +132,23 @@ export class StreamProbeService {
       // Query first video + first audio stream in one ffprobe pass.
       // `-show_streams` returns every stream in the container; we filter
       // by codec_type when parsing. Fields cover both kinds.
-      const { stdout } = await execFileAsync('ffprobe', [
-        '-v', 'error',
-        '-rtsp_transport', 'tcp',
-        '-timeout', '5000000',
-        '-show_entries',
-        'stream=codec_type,codec_name,profile,width,height,r_frame_rate,bit_rate,sample_rate,channels',
-        '-of', 'json',
-        url,
-      ], { timeout: PROBE_TIMEOUT_MS })
+      const { stdout } = await execFileAsync(
+        'ffprobe',
+        [
+          '-v',
+          'error',
+          '-rtsp_transport',
+          'tcp',
+          '-timeout',
+          '5000000',
+          '-show_entries',
+          'stream=codec_type,codec_name,profile,width,height,r_frame_rate,bit_rate,sample_rate,channels',
+          '-of',
+          'json',
+          url,
+        ],
+        { timeout: PROBE_TIMEOUT_MS },
+      )
 
       return this.parseOutput(stdout)
     } catch (err) {

package/src/core/topology/topology-emitter.service.ts

@@ -66,7 +66,11 @@ export class TopologyEmitterService {
     if (this.debounceTimer) clearTimeout(this.debounceTimer)
     if (this.heartbeatTimer) clearInterval(this.heartbeatTimer)
     for (const unsub of this.unsubscribers) {
-      try { unsub() } catch { /* idempotent */ }
+      try {
+        unsub()
+      } catch {
+        /* idempotent */
+      }
     }
     this.unsubscribers.length = 0
   }

package/src/launcher.ts

@@ -92,8 +92,8 @@ async function applyPendingRestore(dataDir: string): Promise<void> {
       if (p === ARCHIVE_MANIFEST_NAME || p === `./${ARCHIVE_MANIFEST_NAME}`) return false
       if (!allowedPrefixes) return true
       const normalized = p.replace(/^\.\//, '')
-      return allowedPrefixes.some((prefix) =>
-        normalized === prefix || normalized.startsWith(`${prefix}/`),
+      return allowedPrefixes.some(
+        (prefix) => normalized === prefix || normalized.startsWith(`${prefix}/`),
       )
     },
   })
@@ -125,7 +125,9 @@ function readConfigYaml(dataDir: string): unknown {
   try {
     return yaml.load(fs.readFileSync(found, 'utf-8')) ?? {}
   } catch (err) {
-    console.warn(`[launcher] Could not parse ${found}: ${err instanceof Error ? err.message : String(err)}`)
+    console.warn(
+      `[launcher] Could not parse ${found}: ${err instanceof Error ? err.message : String(err)}`,
+    )
     return null
   }
 }
@@ -164,7 +166,9 @@ function readBootstrapRequiredAddons(dataDir: string): readonly string[] | null
 
   const validation = bootstrapSchema.safeParse(raw)
   if (!validation.success) {
-    console.warn(`[launcher] config.yaml failed bootstrapSchema validation: ${validation.error.message}`)
+    console.warn(
+      `[launcher] config.yaml failed bootstrapSchema validation: ${validation.error.message}`,
+    )
     return null
   }
 
@@ -209,8 +213,8 @@ async function launch(): Promise<void> {
     workspaceDir = detectWorkspacePackagesDir(__dirname)
     if (workspaceDir === null) {
       console.warn(
-        `[launcher] installSource=${explicitSource} requested but no workspace `
-          + `packages/ dir found from ${__dirname} — falling back to 'npm'`,
+        `[launcher] installSource=${explicitSource} requested but no workspace ` +
+          `packages/ dir found from ${__dirname} — falling back to 'npm'`,
       )
       resolvedSource = 'npm'
     }
@@ -228,7 +232,9 @@ async function launch(): Promise<void> {
   // npm. Default (undefined) → fall back to the in-kernel constant.
   const bootstrapRequired = readBootstrapRequiredAddons(dataDir)
   if (bootstrapRequired !== null) {
-    console.log(`[launcher] bootstrap.requiredAddons from config.yaml: ${bootstrapRequired.length} packages`)
+    console.log(
+      `[launcher] bootstrap.requiredAddons from config.yaml: ${bootstrapRequired.length} packages`,
+    )
     await installer.ensureRequiredPackages(bootstrapRequired)
   } else {
     await installer.ensureRequiredPackages()
@@ -258,8 +264,7 @@ async function launch(): Promise<void> {
   // etc); the server-local node_modules has direct deps. Listing
   // both covers every realistic resolution.
   const workspaceRootNodeModules = path.resolve(serverDir, '..', '..', 'node_modules')
-  const extraNodePaths = [nodeModulesDir, workspaceRootNodeModules]
-    .filter((p) => fs.existsSync(p))
+  const extraNodePaths = [nodeModulesDir, workspaceRootNodeModules].filter((p) => fs.existsSync(p))
   if (extraNodePaths.length > 0) {
     const sep = process.platform === 'win32' ? ';' : ':'
     process.env['NODE_PATH'] = process.env['NODE_PATH']