trigger ci

Co-authored-by: Cursor <cursoragent@cursor.com>

.gitignore

@@ -44,6 +44,3 @@ data
 
 # Dev TLS certs (self-signed for local testing)
 .dev-certs
-
-# CI artifact (kaniko reads .tags for image tag list)
-.tags

.woodpecker/ci.yml

@@ -0,0 +1,51 @@
+steps:
+  - name: lint
+    image: node:24-slim
+    commands:
+      - npm ci
+      - npm run lint
+    when:
+      - event: pull_request
+
+  - name: test
+    image: node:24-slim
+    environment:
+      CI: "true"
+    commands:
+      - npm run test
+    when:
+      - event: pull_request
+
+  - name: e2e
+    image: mcr.microsoft.com/playwright:v1.58.2-noble
+    commands:
+      - npm ci
+      - npm run test:e2e
+    environment:
+      CI: "true"
+      NODE_TLS_REJECT_UNAUTHORIZED: "0"
+    when:
+      - event: pull_request
+
+  - name: docker-build
+    image: woodpeckerci/plugin-docker-buildx
+    settings:
+      repo: git.keligrubb.com/${CI_REPO_OWNER}/${CI_REPO_NAME}
+      registry: git.keligrubb.com
+      tags: latest
+      dry_run: true
+    when:
+      - event: pull_request
+
+  - name: docker-build-push
+    image: woodpeckerci/plugin-docker-buildx
+    settings:
+      repo: git.keligrubb.com/${CI_REPO_OWNER}/${CI_REPO_NAME}
+      registry: git.keligrubb.com
+      tags: latest,${CI_COMMIT_SHA:0:7}
+      username: ${CI_REPO_OWNER}
+      password:
+        from_secret: gitea_registry_token
+    when:
+      - event: push
+        branch: main

.woodpecker/pr.yml

@@ -1,38 +0,0 @@
-when:
-  - event: pull_request
-
-steps:
-  - name: lint
-    image: node:24-slim
-    depends_on: []
-    commands:
-      - npm ci
-      - npm run lint
-
-  - name: test
-    image: node:24-slim
-    depends_on: []
-    commands:
-      - npm ci
-      - npm run test
-
-  - name: e2e
-    image: mcr.microsoft.com/playwright:v1.58.2-noble
-    depends_on: []
-    commands:
-      - npm ci
-      - ./scripts/gen-dev-cert.sh
-      - npm run test:e2e
-    environment:
-      NODE_TLS_REJECT_UNAUTHORIZED: "0"
-
-  - name: docker-build
-    image: woodpeckerci/plugin-kaniko
-    depends_on: []
-    settings:
-      repo: ${CI_REPO_OWNER}/${CI_REPO_NAME}
-      registry: git.keligrubb.com
-      tags: latest
-      dry-run: true
-      single-snapshot: true
-      cleanup: true

.woodpecker/push.yml

@@ -1,36 +0,0 @@
-when:
-  - event: push
-    branch: main
-
-steps:
-  - name: release
-    image: alpine
-    commands:
-      - apk add --no-cache git
-      - ./scripts/release.sh
-    environment:
-      GITEA_REPO_TOKEN:
-        from_secret: gitea_repo_token
-
-  - name: docker
-    image: woodpeckerci/plugin-kaniko
-    depends_on: [release]
-    settings:
-      repo: ${CI_REPO_OWNER}/${CI_REPO_NAME}
-      registry: git.keligrubb.com
-      username: ${CI_REPO_OWNER}
-      password:
-        from_secret: gitea_registry_token
-      single-snapshot: true
-      cleanup: true
-
-  - name: helm
-    image: alpine/helm
-    depends_on: [release]
-    environment:
-      GITEA_REGISTRY_TOKEN:
-        from_secret: gitea_registry_token
-    commands:
-      - apk add --no-cache curl
-      - helm package helm/kestrelos
-      - curl -sf -u $CI_REPO_OWNER:$GITEA_REGISTRY_TOKEN -X POST --upload-file kestrelos-*.tgz https://git.keligrubb.com/api/packages/$CI_REPO_OWNER/helm/api/charts

CHANGELOG.md

@@ -1,11 +0,0 @@
-## [0.3.0] - 2026-02-14
-### Changed
-- heavily simplify server and app content. unify styling (#4)
-
-## [0.2.0] - 2026-02-12
-### Changed
-- add a new release system (#3)
-
-# Changelog
-
-All notable changes to this project will be documented in this file.

Dockerfile

@@ -1,4 +1,5 @@
-FROM node:24-slim AS builder
+# Build stage
+FROM node:22-alpine AS builder
 
 WORKDIR /app
 
@@ -9,7 +10,7 @@ COPY . .
 RUN npm run build
 
 # Run stage
-FROM node:24-slim AS runner
+FROM node:22-alpine AS runner
 
 # Run as non-root user (node user exists in official image)
 USER node

README.md

@@ -22,7 +22,7 @@ Open http://localhost:3000. The app requires login by default; you will see the
 
 Camera and geolocation in the browser require a **secure context** (HTTPS) when you open the app from your phone. To test Share live from a device on your LAN without buying a domain or cert:
 
-1. Generate a self-signed cert (once). Use your machine's LAN IP so the phone can use it:
+1. Generate a self-signed cert (once). Use your machine’s LAN IP so the phone can use it:
    ```bash
    chmod +x scripts/gen-dev-cert.sh
    ./scripts/gen-dev-cert.sh 192.168.1.123
@@ -34,7 +34,7 @@ Camera and geolocation in the browser require a **secure context** (HTTPS) when
    npm run dev
    ```
 
-3. On your phone, open **https://192.168.1.123:3000** (same IP you passed above). Accept the browser's “untrusted certificate” warning once (e.g. Advanced → Proceed). Then log in and use Share live; camera and location will work.
+3. On your phone, open **https://192.168.1.123:3000** (same IP you passed above). Accept the browser’s “untrusted certificate” warning once (e.g. Advanced → Proceed). Then log in and use Share live; camera and location will work.
 
 Without the certs, `npm run dev` still runs over HTTP as before.
 
@@ -48,7 +48,7 @@ The **Share live** feature uses WebRTC for real-time video streaming from mobile
 - **Mediasoup** server (runs automatically in the Nuxt process)
 - **mediasoup-client** (browser library, included automatically)
 
-**Streaming from a phone on your LAN:** The server auto-detects your machine's LAN IP (from network interfaces) and uses it for WebRTC. Open **https://<your-LAN-IP>:3000** on both phone and laptop (same IP as for your dev cert). To override (e.g. Docker or multiple NICs), set `MEDIASOUP_ANNOUNCED_IP`. Ensure firewall allows UDP/TCP ports 40000–49999 on the server.
+**Streaming from a phone on your LAN:** The server auto-detects your machine’s LAN IP (from network interfaces) and uses it for WebRTC. Open **https://<your-LAN-IP>:3000** on both phone and laptop (same IP as for your dev cert). To override (e.g. Docker or multiple NICs), set `MEDIASOUP_ANNOUNCED_IP`. Ensure firewall allows UDP/TCP ports 40000–49999 on the server.
 
 See [docs/live-streaming.md](docs/live-streaming.md) for architecture details.
 
@@ -62,10 +62,10 @@ See [docs/live-streaming.md](docs/live-streaming.md) for architecture details.
 
 ## Configuration
 
-- **Devices**: Manage cameras/devices via the API (`/api/devices`) or the Members/Cameras UI. Each device needs `name`, `device_type`, `lat`, `lng`, `stream_url`, and `source_type` (`mjpeg` or `hls`).
+- **Feeds**: Edit `server/data/feeds.json` to add cameras/feeds. Each feed needs `id`, `name`, `lat`, `lng`, `streamUrl`, and `sourceType` (`mjpeg` or `hls`). Home Assistant and other sources use the same shape; use proxy URLs for HA.
 - **Environment**: No required env vars for basic run. For production, set `HOST=0.0.0.0` and `PORT` as needed (e.g. in Docker/Helm).
 - **Authentication**: The login page always offers password sign-in (local). Optionally set `BOOTSTRAP_EMAIL` and `BOOTSTRAP_PASSWORD` before the first run to create the first admin; otherwise a default admin is created and its credentials are printed in the terminal. To also show an OIDC sign-in button, configure `OIDC_ISSUER`, `OIDC_CLIENT_ID`, `OIDC_CLIENT_SECRET`, and optionally `OIDC_LABEL`, `OIDC_REDIRECT_URI`. See [docs/auth.md](docs/auth.md) for provider-specific examples.
-- **Bootstrap admin** (when using local auth): The server initializes the database and runs bootstrap at startup. On first run (no users in the database), it creates the first admin. If you set `BOOTSTRAP_EMAIL` and `BOOTSTRAP_PASSWORD` before starting, that account is created. If you don't set them, a default admin is created (identifier: `admin`) with a random password and the credentials are printed in the terminal—copy them and sign in at `/login`, then change the password or add users via Members. Use **Members** to change roles (admin, leader, member). Only admins can change roles; admins and leaders can edit POIs.
+- **Bootstrap admin** (when using local auth): The server initializes the database and runs bootstrap at startup. On first run (no users in the database), it creates the first admin. If you set `BOOTSTRAP_EMAIL` and `BOOTSTRAP_PASSWORD` before starting, that account is created. If you don’t set them, a default admin is created (identifier: `admin`) with a random password and the credentials are printed in the terminal—copy them and sign in at `/login`, then change the password or add users via Members. Use **Members** to change roles (admin, leader, member). Only admins can change roles; admins and leaders can edit POIs.
 - **Database**: SQLite file at `data/kestrelos.db` (created automatically). Contains users, sessions, and POIs.
 
 ## Docker
@@ -77,34 +77,16 @@ docker run -p 3000:3000 kestrelos:latest
 
 ## Kubernetes (Helm)
 
-**From Gitea registry:**
 ```bash
-helm repo add keligrubb --username YOUR_USER --password YOUR_TOKEN https://git.keligrubb.com/api/packages/keligrubb/helm
+helm install kestrelos ./helm/kestrelos --set image.repository=your-registry/kestrelos --set image.tag=latest
-helm repo update
-helm install kestrelos keligrubb/kestrelos
-```
-
-**From source:**
-```bash
-helm install kestrelos ./helm/kestrelos
 ```
 
 Health: `GET /health` (overview), `GET /health/live` (liveness), `GET /health/ready` (readiness). Probes are configured in the Helm chart. Optional: enable Ingress in `helm/kestrelos/values.yaml`.
 
-## Releases
-
-Merges to `main` trigger a semver release. Use one of these prefixes in your PR title to set the version bump:
-
-- `major:` – breaking changes
-- `minor:` – new features
-- `patch:` – bug fixes, docs (default if no prefix)
-
-Example: `minor: Add map layer toggle`
-
 ## Security
 
-- Device data is validated server-side; only valid entries are returned.
+- Feed list is validated server-side (`getValidFeeds`); only valid entries are returned.
-- Stream URLs are sanitized to `http://` or `https://` only; other protocols are rejected.
+- Stream URLs are treated as untrusted; the UI only uses `http://` or `https://` URLs for display.
 
 ## License
 

app/assets/css/main.css

@@ -1,128 +0,0 @@
-@tailwind base;
-@tailwind components;
-@tailwind utilities;
-
-@layer components {
-  .kestrel-page-heading { @apply text-xl font-semibold tracking-wide text-kestrel-text text-shadow-glow-sm; }
-  .kestrel-section-heading { @apply text-lg font-semibold tracking-wide text-kestrel-text text-shadow-glow-sm; }
-  .kestrel-panel-header { @apply flex items-center justify-between border-b border-kestrel-border px-4 py-3 shadow-border-header; }
-  .kestrel-video-frame { @apply relative aspect-video w-full overflow-hidden rounded border border-kestrel-border bg-black shadow-glow-inset-video; }
-  .kestrel-close-btn { @apply rounded p-1 text-kestrel-muted transition-colors hover:bg-kestrel-border hover:text-kestrel-accent; }
-  .kestrel-card { @apply rounded border border-kestrel-border bg-kestrel-surface shadow-glow-card; }
-  .kestrel-card-modal { @apply rounded-lg border border-kestrel-border bg-kestrel-surface shadow-glow-modal; }
-  .kestrel-label { @apply mb-1.5 block text-xs font-medium uppercase tracking-wider text-kestrel-muted; }
-  .kestrel-section-label { @apply mb-2 text-sm font-medium uppercase tracking-wider text-kestrel-muted; }
-  .kestrel-input { @apply w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text placeholder:text-kestrel-muted outline-none transition-colors focus:border-kestrel-accent; }
-  .kestrel-btn-secondary { @apply rounded border border-kestrel-border px-4 py-2 text-sm text-kestrel-text transition-colors hover:bg-kestrel-border; }
-  .kestrel-context-menu-item { @apply block w-full px-3 py-1.5 text-left text-sm text-kestrel-text transition-colors hover:bg-kestrel-border; }
-  .kestrel-context-menu-item-danger { @apply block w-full px-3 py-1.5 text-left text-sm text-red-400 transition-colors hover:bg-kestrel-border; }
-  .kestrel-panel-base { @apply flex flex-col border border-kestrel-border bg-kestrel-surface; }
-  .kestrel-panel-inline { @apply rounded-lg shadow-glow; }
-  .kestrel-panel-overlay { @apply absolute right-0 top-0 z-[1000] h-full w-full border-l shadow-glow md:w-[420px] shadow-glow-panel; }
-}
-
-/* Transitions: modal + drawer-backdrop (same fade) */
-.modal-enter-active, .modal-leave-active,
-.drawer-backdrop-enter-active, .drawer-backdrop-leave-active { transition: opacity 0.2s ease; }
-.modal-enter-from, .modal-leave-to,
-.drawer-backdrop-enter-from, .drawer-backdrop-leave-to { opacity: 0; }
-.modal-enter-active .relative, .modal-leave-active .relative { transition: transform 0.2s ease; }
-.modal-enter-from .relative, .modal-leave-to .relative { transform: scale(0.96); }
-
-.nav-drawer { box-shadow: 8px 0 24px -4px rgba(34, 201, 201, 0.12); }
-@media (min-width: 768px) { .nav-drawer { box-shadow: none; } }
-
-/* Leaflet map */
-.kestrel-map-container {
-  background: #000 !important;
-}
-.kestrel-map-container .leaflet-tile-pane,
-.kestrel-map-container .leaflet-map-pane,
-.kestrel-map-container .leaflet-tile-container {
-  background: #000 !important;
-}
-.kestrel-map-container img.leaflet-tile {
-  background: #000 !important;
-  mix-blend-mode: normal;
-}
-.kestrel-map-container .poi-div-icon {
-  background: none;
-  border: none;
-}
-.kestrel-map-container .poi-icon-svg {
-  display: block;
-  width: 100%;
-  height: 100%;
-  pointer-events: none;
-}
-.kestrel-map-container .kestrel-poi-tooltip,
-.kestrel-map-container .kestrel-live-popup-wrap .leaflet-popup-content-wrapper,
-.kestrel-map-container .kestrel-live-popup-wrap .leaflet-popup-tip {
-  @apply bg-kestrel-surface-elevated border border-kestrel-glow rounded-md shadow-elevated;
-}
-.kestrel-map-container .kestrel-poi-tooltip {
-  @apply text-kestrel-text-bright text-xs font-[inherit] py-1.5 px-2.5;
-}
-.kestrel-map-container .kestrel-poi-tooltip::before,
-.kestrel-map-container .kestrel-poi-tooltip::after {
-  border-color: #1e293b;
-}
-.kestrel-map-container .kestrel-live-popup-wrap .leaflet-popup-content {
-  @apply text-kestrel-text-bright my-2 mx-3 min-w-[200px];
-}
-.kestrel-map-container .kestrel-live-popup {
-  @apply text-kestrel-text-bright text-xs;
-}
-.kestrel-map-container .kestrel-live-popup img {
-  @apply block max-h-40 w-auto rounded bg-kestrel-bg;
-}
-.kestrel-map-container .leaflet-control-zoom,
-.kestrel-map-container .leaflet-control-locate,
-.kestrel-map-container .savetiles.leaflet-bar {
-  @apply rounded-md overflow-hidden font-mono border border-kestrel-glow shadow-glow-sm;
-  border-color: rgba(34, 201, 201, 0.35) !important;
-}
-.kestrel-map-container .leaflet-control-zoom a,
-.kestrel-map-container .leaflet-control-locate,
-.kestrel-map-container .savetiles.leaflet-bar a {
-  @apply w-8 h-8 leading-8 bg-kestrel-surface text-kestrel-text border-none rounded-none text-lg font-semibold no-underline transition-all duration-150;
-  width: 32px !important;
-  height: 32px !important;
-  line-height: 32px !important;
-  background: #0d1424 !important;
-  color: #b8c9e0 !important;
-  text-decoration: none !important;
-}
-.kestrel-map-container .leaflet-control-zoom a + a,
-.kestrel-map-container .savetiles.leaflet-bar a + a {
-  border-top: 1px solid rgba(34, 201, 201, 0.2);
-}
-.kestrel-map-container .leaflet-control-zoom a:hover,
-.kestrel-map-container .leaflet-control-locate:hover,
-.kestrel-map-container .savetiles.leaflet-bar a:hover {
-  @apply bg-kestrel-surface-hover text-kestrel-accent shadow-glow-md text-shadow-glow-md;
-}
-.kestrel-map-container .savetiles.leaflet-bar {
-  @apply flex flex-col;
-}
-.kestrel-map-container .savetiles.leaflet-bar a {
-  @apply min-w-[5.5em] leading-tight py-1.5 px-2.5 whitespace-nowrap text-center text-[11px] font-medium tracking-wide;
-  width: auto !important;
-  height: auto !important;
-  line-height: 1.25 !important;
-  padding: 6px 10px !important;
-  font-size: 11px !important;
-}
-.kestrel-map-container .leaflet-control-locate {
-  @apply flex items-center justify-center p-0 cursor-pointer;
-}
-.kestrel-map-container .leaflet-control-locate svg {
-  color: currentColor;
-}
-.kestrel-map-container .live-session-icon {
-  animation: live-pulse 1.5s ease-in-out infinite;
-}
-@keyframes live-pulse {
-  0%, 100% { opacity: 1; }
-  50% { opacity: 0.7; }
-}

app/components/CameraViewer.vue

@@ -7,18 +7,18 @@
   />
   <aside
     v-else
-    class="kestrel-panel-base"
+    class="flex flex-col border border-kestrel-border bg-kestrel-surface"
-    :class="inline ? 'kestrel-panel-inline' : 'kestrel-panel-overlay'"
+    :class="asideClass"
     role="dialog"
     aria-label="Camera feed"
   >
-    <div class="kestrel-panel-header">
+    <div class="flex items-center justify-between border-b border-kestrel-border px-4 py-3 [box-shadow:0_1px_0_0_rgba(34,201,201,0.08)]">
-      <h2 class="font-medium tracking-wide text-kestrel-text text-shadow-glow-sm">
+      <h2 class="font-medium tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
         {{ camera?.name ?? 'Camera' }}
       </h2>
       <button
         type="button"
-        class="kestrel-close-btn"
+        class="rounded p-1 text-kestrel-muted transition-colors hover:bg-kestrel-border hover:text-kestrel-accent"
         aria-label="Close panel"
         @click="$emit('close')"
       >
@@ -26,7 +26,7 @@
       </button>
     </div>
     <div class="flex-1 overflow-auto p-4">
-      <div class="kestrel-video-frame">
+      <div class="relative aspect-video w-full overflow-hidden rounded border border-kestrel-border bg-black [box-shadow:inset_0_0_20px_-8px_rgba(34,201,201,0.1)]">
         <template v-if="sourceType === 'hls'">
           <video
             ref="videoRef"
@@ -75,14 +75,18 @@ defineEmits(['close'])
 const videoRef = ref(null)
 const streamError = ref(false)
 
-const isLiveSession = computed(() => props.camera?.hasStream !== undefined)
+const isLiveSession = computed(() =>
+  props.camera && typeof props.camera.hasStream !== 'undefined')
+
+const asideClass = computed(() =>
+  props.inline ? 'rounded-lg shadow-glow' : 'absolute right-0 top-0 z-[1000] h-full w-full border-l shadow-glow md:w-[420px] [box-shadow:-8px_0_24px_-4px_rgba(34,201,201,0.12)]')
 
 const streamUrl = computed(() => props.camera?.streamUrl ?? '')
 const sourceType = computed(() => (props.camera?.sourceType === 'hls' ? 'hls' : 'mjpeg'))
 
 const safeStreamUrl = computed(() => {
-  const u = streamUrl.value?.trim()
+  const u = streamUrl.value
-  return (u?.startsWith('http://') || u?.startsWith('https://')) ? u : ''
+  return typeof u === 'string' && u.trim() && (u.startsWith('http://') || u.startsWith('https://')) ? u.trim() : ''
 })
 
 function initHls() {

app/components/KestrelMap.vue

@@ -7,13 +7,13 @@
     <div
       v-if="contextMenu.type"
       ref="contextMenuRef"
-      class="pointer-events-auto absolute z-[1000] min-w-[120px] rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow shadow-glow-context"
+      class="pointer-events-auto absolute z-[1000] min-w-[120px] rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.2)]"
       :style="{ left: contextMenu.x + 'px', top: contextMenu.y + 'px' }"
     >
       <template v-if="contextMenu.type === 'map'">
         <button
           type="button"
-          class="kestrel-context-menu-item"
+          class="block w-full px-3 py-1.5 text-left text-sm text-kestrel-text hover:bg-kestrel-border"
           @click="openAddPoiModal(contextMenu.latlng)"
         >
           Add POI here
@@ -22,14 +22,14 @@
       <template v-else-if="contextMenu.type === 'poi'">
         <button
           type="button"
-          class="kestrel-context-menu-item"
+          class="block w-full px-3 py-1.5 text-left text-sm text-kestrel-text hover:bg-kestrel-border"
           @click="openEditPoiModal(contextMenu.poi)"
         >
           Edit
         </button>
         <button
           type="button"
-          class="kestrel-context-menu-item-danger"
+          class="block w-full px-3 py-1.5 text-left text-sm text-red-400 hover:bg-kestrel-border"
           @click="openDeletePoiModal(contextMenu.poi)"
         >
           Delete
@@ -37,16 +37,176 @@
       </template>
     </div>
 
-    <PoiModal
+    <!-- POI modal (Add / Edit) -->
-      :show="showPoiModal"
+    <Teleport to="body">
-      :mode="poiModalMode"
+      <Transition name="modal">
-      :form="poiForm"
+        <div
-      :edit-poi="editPoi"
+          v-if="showPoiModal"
-      :delete-poi="deletePoi"
+          class="fixed inset-0 z-[2000] flex items-center justify-center p-4"
-      @close="closePoiModal"
+          role="dialog"
-      @submit="onPoiSubmit"
+          aria-modal="true"
-      @confirm-delete="confirmDeletePoi"
+          :aria-labelledby="poiModalMode === 'delete' ? 'delete-poi-title' : 'poi-modal-title'"
+          @keydown.escape="closePoiModal"
+        >
+          <button
+            type="button"
+            class="absolute inset-0 bg-black/60 transition-opacity"
+            aria-label="Close"
+            @click="closePoiModal"
           />
+          <!-- Add / Edit form -->
+          <div
+            v-if="poiModalMode === 'add' || poiModalMode === 'edit'"
+            ref="poiModalRef"
+            class="relative w-full max-w-md rounded-lg border border-kestrel-border bg-kestrel-surface p-6 shadow-glow [box-shadow:0_0_32px_-8px_rgba(34,201,201,0.25)]"
+            @click.stop
+          >
+            <h2
+              id="poi-modal-title"
+              class="mb-4 text-lg font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]"
+            >
+              {{ poiModalMode === 'edit' ? 'Edit POI' : 'Add POI' }}
+            </h2>
+            <form
+              class="space-y-4"
+              @submit.prevent="submitPoiModal"
+            >
+              <div>
+                <label
+                  for="add-poi-label"
+                  class="mb-1.5 block text-xs font-medium uppercase tracking-wider text-kestrel-muted"
+                >
+                  Label (optional)
+                </label>
+                <input
+                  id="add-poi-label"
+                  v-model="poiForm.label"
+                  type="text"
+                  placeholder="e.g. Rally point"
+                  class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text placeholder:text-kestrel-muted outline-none transition-colors focus:border-kestrel-accent"
+                  autocomplete="off"
+                >
+              </div>
+              <div>
+                <label
+                  class="mb-1.5 block text-xs font-medium uppercase tracking-wider text-kestrel-muted"
+                >
+                  Icon type
+                </label>
+                <div
+                  :ref="el => iconDropdownOpen && (iconDropdownRef.value = el)"
+                  class="relative inline-block w-full"
+                >
+                  <button
+                    type="button"
+                    class="flex w-full min-w-0 items-center justify-between gap-2 rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-left text-sm text-kestrel-text transition-colors hover:border-kestrel-accent/50"
+                    :aria-expanded="iconDropdownOpen"
+                    aria-haspopup="listbox"
+                    :aria-label="`Icon type: ${poiForm.iconType}`"
+                    @click="iconDropdownOpen = !iconDropdownOpen"
+                  >
+                    <span class="flex items-center gap-2 capitalize">
+                      <Icon
+                        :name="POI_ICONIFY_IDS[poiForm.iconType]"
+                        class="size-4 shrink-0"
+                      />
+                      {{ poiForm.iconType }}
+                    </span>
+                    <span
+                      class="text-kestrel-muted transition-transform"
+                      :class="iconDropdownOpen && 'rotate-180'"
+                    >
+                      ▾
+                    </span>
+                  </button>
+                  <Transition
+                    enter-active-class="transition duration-100 ease-out"
+                    enter-from-class="opacity-0 scale-95"
+                    enter-to-class="opacity-100 scale-100"
+                    leave-active-class="transition duration-75 ease-in"
+                    leave-from-class="opacity-100 scale-100"
+                    leave-to-class="opacity-0 scale-95"
+                  >
+                    <div
+                      v-show="iconDropdownOpen"
+                      class="absolute left-0 right-0 top-full z-10 mt-1 rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow [box-shadow:0_4px_12px_-2px_rgba(34,201,201,0.15)]"
+                      role="listbox"
+                    >
+                      <button
+                        v-for="opt in POI_ICON_TYPES"
+                        :key="opt"
+                        type="button"
+                        role="option"
+                        :aria-selected="poiForm.iconType === opt"
+                        class="flex w-full items-center gap-2 px-3 py-2 text-left text-sm capitalize transition-colors"
+                        :class="poiForm.iconType === opt
+                          ? 'bg-kestrel-accent-dim text-kestrel-accent'
+                          : 'text-kestrel-text hover:bg-kestrel-border'"
+                        @click="poiForm.iconType = opt; iconDropdownOpen = false"
+                      >
+                        <Icon
+                          :name="POI_ICONIFY_IDS[opt]"
+                          class="size-4 shrink-0"
+                        />
+                        {{ opt }}
+                      </button>
+                    </div>
+                  </Transition>
+                </div>
+              </div>
+              <div class="flex justify-end gap-2 pt-2">
+                <button
+                  type="button"
+                  class="rounded border border-kestrel-border px-4 py-2 text-sm text-kestrel-text transition-colors hover:bg-kestrel-border"
+                  @click="closePoiModal"
+                >
+                  Cancel
+                </button>
+                <button
+                  type="submit"
+                  class="rounded bg-kestrel-accent px-4 py-2 text-sm font-medium text-kestrel-bg transition-opacity hover:opacity-90"
+                >
+                  {{ poiModalMode === 'edit' ? 'Save changes' : 'Add POI' }}
+                </button>
+              </div>
+            </form>
+          </div>
+          <!-- Delete confirmation -->
+          <div
+            v-if="poiModalMode === 'delete'"
+            ref="poiModalRef"
+            class="relative w-full max-w-sm rounded-lg border border-kestrel-border bg-kestrel-surface p-6 shadow-glow [box-shadow:0_0_32px_-8px_rgba(34,201,201,0.25)]"
+            @click.stop
+          >
+            <h2
+              id="delete-poi-title"
+              class="mb-2 text-lg font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]"
+            >
+              Delete POI?
+            </h2>
+            <p class="mb-4 text-sm text-kestrel-muted">
+              {{ deletePoi?.label ? `“${deletePoi.label}” will be removed.` : 'This POI will be removed.' }}
+            </p>
+            <div class="flex justify-end gap-2">
+              <button
+                type="button"
+                class="rounded border border-kestrel-border px-4 py-2 text-sm text-kestrel-text transition-colors hover:bg-kestrel-border"
+                @click="closePoiModal"
+              >
+                Cancel
+              </button>
+              <button
+                type="button"
+                class="rounded bg-red-600 px-4 py-2 text-sm font-medium text-white transition-opacity hover:opacity-90"
+                @click="confirmDeletePoi"
+              >
+                Delete
+              </button>
+            </div>
+          </div>
+        </div>
+      </Transition>
+    </Teleport>
   </div>
 </template>
 
@@ -54,6 +214,10 @@
 import 'leaflet/dist/leaflet.css'
 
 const props = defineProps({
+  feeds: {
+    type: Array,
+    default: () => [],
+  },
   devices: {
     type: Array,
     default: () => [],
@@ -84,11 +248,14 @@ const liveMarkersRef = ref({})
 const contextMenu = ref({ ...CONTEXT_MENU_EMPTY })
 
 const showPoiModal = ref(false)
+const poiModalRef = ref(null)
 const poiModalMode = ref('add') // 'add' | 'edit' | 'delete'
 const addPoiLatlng = ref(null)
 const editPoi = ref(null)
 const deletePoi = ref(null)
 const poiForm = ref({ label: '', iconType: 'pin' })
+const iconDropdownOpen = ref(false)
+const iconDropdownRef = ref(null)
 
 const TILE_URL = 'https://{s}.basemaps.cartocdn.com/dark_all/{z}/{x}/{y}.png'
 const TILE_SUBDOMAINS = 'abcd'
@@ -96,7 +263,11 @@ const ATTRIBUTION = '&copy; <a href="https://www.openstreetmap.org/copyright">Op
 const DEFAULT_VIEW = [37.7749, -122.4194]
 const DEFAULT_ZOOM = 17
 const MARKER_ICON_PATH = '/'
+const POI_ICON_TYPES = ['pin', 'flag', 'waypoint']
 const POI_TOOLTIP_CLASS = 'kestrel-poi-tooltip'
+
+/** Tabler icon names (Nuxt Icon / Iconify) – modern technical aesthetic. */
+const POI_ICONIFY_IDS = { pin: 'tabler:map-pin', flag: 'tabler:flag', waypoint: 'tabler:current-location' }
 const POI_ICON_COLORS = { pin: '#22c9c9', flag: '#e53e3e', waypoint: '#a78bfa' }
 
 const ICON_SIZE = 28
@@ -112,9 +283,8 @@ function getPoiIconSvg(type) {
   return shapes[type] || shapes.pin
 }
 
-const VALID_POI_TYPES = ['pin', 'flag', 'waypoint']
 function getPoiIcon(L, poi) {
-  const type = VALID_POI_TYPES.includes(poi.icon_type) ? poi.icon_type : 'pin'
+  const type = poi.icon_type === 'pin' || poi.icon_type === 'flag' || poi.icon_type === 'waypoint' ? poi.icon_type : 'pin'
   const html = getPoiIconSvg(type)
   return L.divIcon({
     className: 'poi-div-icon',
@@ -124,7 +294,7 @@ function getPoiIcon(L, poi) {
   })
 }
 
-const LIVE_ICON_COLOR = '#22c9c9' /* kestrel-accent – JS string for Leaflet SVG */
+const LIVE_ICON_COLOR = '#22c9c9'
 function getLiveSessionIcon(L) {
   const html = `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 24 24" fill="none" stroke="${LIVE_ICON_COLOR}" stroke-width="2" stroke-linecap="round" stroke-linejoin="round"><circle cx="12" cy="12" r="9"/><circle cx="12" cy="12" r="5"/><circle cx="12" cy="12" r="2" fill="${LIVE_ICON_COLOR}"/></svg>`
   return L.divIcon({
@@ -212,7 +382,8 @@ function updateMarkers() {
     if (m) m.remove()
   })
 
-  const validSources = (props.devices || []).filter(f => typeof f?.lat === 'number' && typeof f?.lng === 'number')
+  const feedSources = [...(props.feeds || []), ...(props.devices || [])]
+  const validSources = feedSources.filter(f => typeof f?.lat === 'number' && typeof f?.lng === 'number')
   markersRef.value = validSources.map(item =>
     L.marker([item.lat, item.lng]).addTo(ctx.map).on('click', () => emit('select', item)),
   )
@@ -273,7 +444,7 @@ function updateLiveMarkers() {
   })
 
   const next = sessions.reduce((acc, session) => {
-    const content = `<div class="kestrel-live-popup"><strong>${escapeHtml(session.label)}</strong>${session.hasStream ? ' <span class="text-kestrel-accent">● Live</span>' : ''}</div>`
+    const content = `<div class="kestrel-live-popup"><strong>${escapeHtml(session.label)}</strong>${session.hasStream ? ' <span style="color:#22c9c9">● Live</span>' : ''}</div>`
     const existing = prev[session.id]
     if (existing) {
       existing.setLatLng([session.lat, session.lng])
@@ -307,6 +478,7 @@ function openAddPoiModal(latlng) {
   editPoi.value = null
   deletePoi.value = null
   poiForm.value = { label: '', iconType: 'pin' }
+  iconDropdownOpen.value = false
   showPoiModal.value = true
 }
 
@@ -317,6 +489,7 @@ function openEditPoiModal(poi) {
   addPoiLatlng.value = null
   deletePoi.value = null
   poiForm.value = { label: (poi.label ?? '').trim(), iconType: poi.icon_type || 'pin' }
+  iconDropdownOpen.value = false
   showPoiModal.value = true
 }
 
@@ -332,38 +505,52 @@ function openDeletePoiModal(poi) {
 function closePoiModal() {
   showPoiModal.value = false
   poiModalMode.value = 'add'
+  iconDropdownOpen.value = false
   addPoiLatlng.value = null
   editPoi.value = null
   deletePoi.value = null
 }
 
-async function doPoiFetch(fn) {
+function onPoiModalDocumentClick(e) {
+  if (!showPoiModal.value) return
+  if (iconDropdownOpen.value && iconDropdownRef.value && !iconDropdownRef.value.contains(e.target)) {
+    iconDropdownOpen.value = false
+  }
+}
+
+async function submitPoiModal() {
+  if (poiModalMode.value === 'add') {
+    const latlng = addPoiLatlng.value
+    if (!latlng) return
+    const { label, iconType } = poiForm.value
     try {
-    await fn()
+      await $fetch('/api/pois', { method: 'POST', body: { lat: latlng.lat, lng: latlng.lng, label: (label ?? '').trim(), iconType: iconType || 'pin' } })
       emit('refreshPois')
       closePoiModal()
     }
     catch { /* ignore */ }
-}
-
-async function onPoiSubmit(payload) {
-  const { label, iconType } = payload
-  const body = { label: (label ?? '').trim(), iconType: iconType || 'pin' }
-  if (poiModalMode.value === 'add') {
-    const latlng = addPoiLatlng.value
-    if (!latlng) return
-    await doPoiFetch(() => $fetch('/api/pois', { method: 'POST', body: { ...body, lat: latlng.lat, lng: latlng.lng } }))
     return
   }
   if (poiModalMode.value === 'edit' && editPoi.value) {
-    await doPoiFetch(() => $fetch(`/api/pois/${editPoi.value.id}`, { method: 'PATCH', body }))
+    const { label, iconType } = poiForm.value
+    try {
+      await $fetch(`/api/pois/${editPoi.value.id}`, { method: 'PATCH', body: { label: (label ?? '').trim(), iconType: iconType || 'pin' } })
+      emit('refreshPois')
+      closePoiModal()
+    }
+    catch { /* ignore */ }
   }
 }
 
 async function confirmDeletePoi() {
   const poi = deletePoi.value
   if (!poi?.id) return
-  await doPoiFetch(() => $fetch(`/api/pois/${poi.id}`, { method: 'DELETE' }))
+  try {
+    await $fetch(`/api/pois/${poi.id}`, { method: 'DELETE' })
+    emit('refreshPois')
+    closePoiModal()
+  }
+  catch { /* ignore */ }
 }
 
 function destroyMap() {
@@ -422,6 +609,7 @@ onMounted(async () => {
   leafletRef.value = { L, offlineApi: offline }
   initMapWithLocation()
   document.addEventListener('click', onDocumentClick)
+  document.addEventListener('click', onPoiModalDocumentClick)
 })
 
 function onDocumentClick(e) {
@@ -430,10 +618,166 @@ function onDocumentClick(e) {
 
 onBeforeUnmount(() => {
   document.removeEventListener('click', onDocumentClick)
+  document.removeEventListener('click', onPoiModalDocumentClick)
   destroyMap()
 })
 
-watch(() => props.devices, () => updateMarkers(), { deep: true })
+watch(() => [props.feeds, props.devices], () => updateMarkers(), { deep: true })
 watch([() => props.pois, () => props.canEditPois], () => updatePoiMarkers(), { deep: true })
 watch(() => props.liveSessions, () => updateLiveMarkers(), { deep: true })
 </script>
+
+<style scoped>
+.modal-enter-active,
+.modal-leave-active {
+  transition: opacity 0.2s ease;
+}
+.modal-enter-from,
+.modal-leave-to {
+  opacity: 0;
+}
+.modal-enter-active .relative,
+.modal-leave-active .relative {
+  transition: transform 0.2s ease;
+}
+.modal-enter-from .relative,
+.modal-leave-to .relative {
+  transform: scale(0.96);
+}
+
+/* Unrendered/loading tiles show black instead of white when panning */
+.kestrel-map-container {
+  background: #000 !important;
+}
+:deep(.leaflet-tile-pane),
+:deep(.leaflet-map-pane),
+:deep(.leaflet-tile-container) {
+  background: #000 !important;
+}
+:deep(img.leaflet-tile) {
+  background: #000 !important;
+  /* Override Leaflet’s plus-lighter so unloaded/empty tiles don’t flash white */
+  mix-blend-mode: normal;
+}
+/* Leaflet injects divIcon HTML into the map; :deep() so these styles apply to that content */
+:deep(.poi-div-icon) {
+  background: none;
+  border: none;
+}
+:deep(.poi-icon-svg) {
+  display: block;
+  width: 100%;
+  height: 100%;
+  pointer-events: none;
+}
+
+/* Dark-themed tooltip for POI labels (Leaflet creates these in the map container) */
+:deep(.kestrel-poi-tooltip) {
+  background: #1e293b;
+  border: 1px solid rgba(34, 201, 201, 0.35);
+  border-radius: 6px;
+  color: #e2e8f0;
+  font-size: 12px;
+  font-family: inherit;
+  padding: 6px 10px;
+  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.4);
+}
+:deep(.kestrel-poi-tooltip::before),
+:deep(.kestrel-poi-tooltip::after) {
+  border-top-color: #1e293b;
+  border-bottom-color: #1e293b;
+  border-left-color: #1e293b;
+  border-right-color: #1e293b;
+}
+
+/* Live session popup (content injected by Leaflet) */
+:deep(.kestrel-live-popup-wrap .leaflet-popup-content) {
+  margin: 8px 12px;
+  min-width: 200px;
+}
+:deep(.kestrel-live-popup) {
+  color: #e2e8f0;
+  font-size: 12px;
+}
+:deep(.kestrel-live-popup img) {
+  display: block;
+  max-height: 160px;
+  width: auto;
+  border-radius: 4px;
+  background: #0f172a;
+}
+:deep(.live-session-icon) {
+  animation: live-pulse 1.5s ease-in-out infinite;
+}
+@keyframes live-pulse {
+  0%, 100% { opacity: 1; }
+  50% { opacity: 0.7; }
+}
+
+/* Map controls – dark theme with cyan glow (zoom, locate, save/clear tiles) */
+:deep(.leaflet-control-zoom),
+:deep(.leaflet-control-locate),
+:deep(.savetiles.leaflet-bar) {
+  border: 1px solid rgba(34, 201, 201, 0.35) !important;
+  border-radius: 6px;
+  overflow: hidden;
+  box-shadow: 0 0 12px -2px rgba(34, 201, 201, 0.15);
+  font-family: "JetBrains Mono", "Fira Code", ui-monospace, monospace;
+}
+:deep(.leaflet-control-zoom a),
+:deep(.leaflet-control-locate),
+:deep(.savetiles.leaflet-bar a) {
+  width: 32px !important;
+  height: 32px !important;
+  line-height: 32px !important;
+  background: #0d1424 !important;
+  color: #b8c9e0 !important;
+  border: none !important;
+  border-radius: 0 !important;
+  font-size: 18px !important;
+  font-weight: 600;
+  text-decoration: none !important;
+  transition: background 0.15s, color 0.15s, box-shadow 0.15s, text-shadow 0.15s;
+}
+:deep(.leaflet-control-zoom a + a) {
+  border-top: 1px solid rgba(34, 201, 201, 0.2) !important;
+}
+:deep(.leaflet-control-zoom a:hover),
+:deep(.leaflet-control-locate:hover),
+:deep(.savetiles.leaflet-bar a:hover) {
+  background: #111a2e !important;
+  color: #22c9c9 !important;
+  box-shadow: 0 0 16px -2px rgba(34, 201, 201, 0.25);
+  text-shadow: 0 0 8px rgba(34, 201, 201, 0.35);
+}
+:deep(.leaflet-control-locate) {
+  display: flex !important;
+  align-items: center;
+  justify-content: center;
+  padding: 0;
+  cursor: pointer;
+}
+:deep(.leaflet-control-locate svg) {
+  color: currentColor;
+}
+/* Save/Clear tiles – text buttons */
+:deep(.savetiles.leaflet-bar) {
+  display: flex;
+  flex-direction: column;
+}
+:deep(.savetiles.leaflet-bar a) {
+  width: auto !important;
+  min-width: 5.5em;
+  height: auto !important;
+  line-height: 1.25 !important;
+  padding: 6px 10px !important;
+  white-space: nowrap;
+  text-align: center;
+  font-size: 11px !important;
+  font-weight: 500;
+  letter-spacing: 0.02em;
+}
+:deep(.savetiles.leaflet-bar a + a) {
+  border-top: 1px solid rgba(34, 201, 201, 0.2) !important;
+}
+</style>

app/components/LiveSessionPanel.vue

@@ -1,17 +1,17 @@
 <template>
   <aside
-    class="kestrel-panel-base"
+    class="flex flex-col border border-kestrel-border bg-kestrel-surface"
-    :class="inline ? 'kestrel-panel-inline' : 'kestrel-panel-overlay'"
+    :class="inline ? 'rounded-lg shadow-glow' : 'absolute right-0 top-0 z-[1000] h-full w-full border-l shadow-glow md:w-[420px] [box-shadow:-8px_0_24px_-4px_rgba(34,201,201,0.12)]'"
     role="dialog"
     aria-label="Live feed"
   >
-    <div class="kestrel-panel-header">
+    <div class="flex items-center justify-between border-b border-kestrel-border px-4 py-3 [box-shadow:0_1px_0_0_rgba(34,201,201,0.08)]">
-      <h2 class="font-medium tracking-wide text-kestrel-text text-shadow-glow-sm">
+      <h2 class="font-medium tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
         {{ session?.label ?? 'Live' }}
       </h2>
       <button
         type="button"
-        class="kestrel-close-btn"
+        class="rounded p-1 text-kestrel-muted transition-colors hover:bg-kestrel-border hover:text-kestrel-accent"
         aria-label="Close panel"
         @click="$emit('close')"
       >
@@ -22,7 +22,7 @@
       <p class="mb-3 text-xs text-kestrel-muted">
         Live camera feed (WebRTC)
       </p>
-      <div class="kestrel-video-frame">
+      <div class="relative aspect-video w-full overflow-hidden rounded border border-kestrel-border bg-black [box-shadow:inset_0_0_20px_-8px_rgba(34,201,201,0.1)]">
         <video
           ref="videoRef"
           autoplay

app/components/NavDrawer.vue

@@ -17,14 +17,14 @@
       :aria-expanded="modelValue"
     >
       <div
-        class="flex h-14 shrink-0 items-center justify-between border-b border-kestrel-border bg-kestrel-surface px-4 shadow-glow-sm shadow-glow-header"
+        class="flex h-14 shrink-0 items-center justify-between border-b border-kestrel-border bg-kestrel-surface px-4 shadow-glow-sm [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]"
       >
         <h2 class="text-sm font-medium uppercase tracking-wider text-kestrel-muted">
           Navigation
         </h2>
         <button
           type="button"
-          class="kestrel-close-btn"
+          class="rounded p-1 text-kestrel-muted transition-colors hover:bg-kestrel-border hover:text-kestrel-accent"
           aria-label="Close navigation"
           @click="close"
         >
@@ -41,7 +41,7 @@
               :to="item.to"
               class="block rounded px-3 py-2 text-sm transition-colors"
               :class="isActive(item.to)
-                ? 'border-l-2 border-kestrel-accent bg-kestrel-surface-hover font-medium text-kestrel-accent text-shadow-glow-sm'
+                ? 'border-l-2 border-kestrel-accent bg-kestrel-surface-hover font-medium text-kestrel-accent [text-shadow:0_0_8px_rgba(34,201,201,0.25)]'
                 : 'border-l-2 border-transparent text-kestrel-muted hover:bg-kestrel-border hover:text-kestrel-text'"
               @click="close"
             >
@@ -102,3 +102,24 @@ onBeforeUnmount(() => {
   document.removeEventListener('keydown', onEscape)
 })
 </script>
+
+<style scoped>
+.drawer-backdrop-enter-active,
+.drawer-backdrop-leave-active {
+  transition: opacity 0.2s ease;
+}
+.drawer-backdrop-enter-from,
+.drawer-backdrop-leave-to {
+  opacity: 0;
+}
+
+/* Same elevation as content: no right-edge shadow on desktop so drawer and navbar read as one layer */
+.nav-drawer {
+  box-shadow: 8px 0 24px -4px rgba(34, 201, 201, 0.12);
+}
+@media (min-width: 768px) {
+  .nav-drawer {
+    box-shadow: none;
+  }
+}
+</style>

app/components/PoiModal.vue

@@ -1,190 +0,0 @@
-<template>
-  <Teleport to="body">
-    <Transition name="modal">
-      <div
-        v-if="show"
-        class="fixed inset-0 z-[2000] flex items-center justify-center p-4"
-        role="dialog"
-        aria-modal="true"
-        :aria-labelledby="mode === 'delete' ? 'delete-poi-title' : 'poi-modal-title'"
-        @keydown.escape="$emit('close')"
-      >
-        <button
-          type="button"
-          class="absolute inset-0 bg-black/60 transition-opacity"
-          aria-label="Close"
-          @click="$emit('close')"
-        />
-        <div
-          v-if="mode === 'add' || mode === 'edit'"
-          ref="modalRef"
-          class="kestrel-card-modal relative w-full max-w-md p-6"
-          @click.stop
-        >
-          <h2
-            id="poi-modal-title"
-            class="kestrel-section-heading mb-4"
-          >
-            {{ mode === 'edit' ? 'Edit POI' : 'Add POI' }}
-          </h2>
-          <form
-            class="space-y-4"
-            @submit.prevent="$emit('submit', { label: localForm.label, iconType: localForm.iconType })"
-          >
-            <div>
-              <label
-                for="add-poi-label"
-                class="kestrel-label"
-              >Label (optional)</label>
-              <input
-                id="add-poi-label"
-                v-model="localForm.label"
-                type="text"
-                placeholder="e.g. Rally point"
-                class="kestrel-input"
-                autocomplete="off"
-              >
-            </div>
-            <div
-              ref="iconRef"
-              class="relative inline-block w-full"
-            >
-              <label class="kestrel-label">Icon type</label>
-              <button
-                type="button"
-                class="flex w-full min-w-0 items-center justify-between gap-2 rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-left text-sm text-kestrel-text transition-colors hover:border-kestrel-accent/50"
-                :aria-expanded="iconOpen"
-                aria-haspopup="listbox"
-                :aria-label="`Icon type: ${localForm.iconType}`"
-                @click="iconOpen = !iconOpen"
-              >
-                <span class="flex items-center gap-2 capitalize">
-                  <Icon
-                    :name="POI_ICONIFY_IDS[localForm.iconType]"
-                    class="size-4 shrink-0"
-                  />
-                  {{ localForm.iconType }}
-                </span>
-                <span
-                  class="text-kestrel-muted transition-transform"
-                  :class="iconOpen && 'rotate-180'"
-                >▾</span>
-              </button>
-              <Transition
-                enter-active-class="transition duration-100 ease-out"
-                enter-from-class="opacity-0 scale-95"
-                enter-to-class="opacity-100 scale-100"
-                leave-active-class="transition duration-75 ease-in"
-                leave-from-class="opacity-100 scale-100"
-                leave-to-class="opacity-0 scale-95"
-              >
-                <div
-                  v-show="iconOpen"
-                  class="absolute left-0 right-0 top-full z-10 mt-1 rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow shadow-glow-dropdown"
-                  role="listbox"
-                >
-                  <button
-                    v-for="opt in POI_ICON_TYPES"
-                    :key="opt"
-                    type="button"
-                    role="option"
-                    :aria-selected="localForm.iconType === opt"
-                    class="flex w-full items-center gap-2 px-3 py-2 text-left text-sm capitalize transition-colors"
-                    :class="localForm.iconType === opt ? 'bg-kestrel-accent-dim text-kestrel-accent' : 'text-kestrel-text hover:bg-kestrel-border'"
-                    @click="localForm.iconType = opt; iconOpen = false"
-                  >
-                    <Icon
-                      :name="POI_ICONIFY_IDS[opt]"
-                      class="size-4 shrink-0"
-                    />
-                    {{ opt }}
-                  </button>
-                </div>
-              </Transition>
-            </div>
-            <div class="flex justify-end gap-2 pt-2">
-              <button
-                type="button"
-                class="kestrel-btn-secondary"
-                @click="$emit('close')"
-              >
-                Cancel
-              </button>
-              <button
-                type="submit"
-                class="rounded bg-kestrel-accent px-4 py-2 text-sm font-medium text-kestrel-bg transition-opacity hover:opacity-90"
-              >
-                {{ mode === 'edit' ? 'Save changes' : 'Add POI' }}
-              </button>
-            </div>
-          </form>
-        </div>
-        <div
-          v-if="mode === 'delete'"
-          ref="modalRef"
-          class="kestrel-card-modal relative w-full max-w-sm p-6"
-          @click.stop
-        >
-          <h2
-            id="delete-poi-title"
-            class="kestrel-section-heading mb-2"
-          >
-            Delete POI?
-          </h2>
-          <p class="mb-4 text-sm text-kestrel-muted">
-            {{ deletePoi?.label ? `"${deletePoi.label}" will be removed.` : 'This POI will be removed.' }}
-          </p>
-          <div class="flex justify-end gap-2">
-            <button
-              type="button"
-              class="kestrel-btn-secondary"
-              @click="$emit('close')"
-            >
-              Cancel
-            </button>
-            <button
-              type="button"
-              class="rounded bg-red-600 px-4 py-2 text-sm font-medium text-white transition-opacity hover:opacity-90"
-              @click="$emit('confirmDelete')"
-            >
-              Delete
-            </button>
-          </div>
-        </div>
-      </div>
-    </Transition>
-  </Teleport>
-</template>
-
-<script setup>
-const POI_ICONIFY_IDS = { pin: 'tabler:map-pin', flag: 'tabler:flag', waypoint: 'tabler:current-location' }
-const POI_ICON_TYPES = Object.keys(POI_ICONIFY_IDS)
-
-const props = defineProps({
-  show: Boolean,
-  mode: { type: String, default: 'add' },
-  form: { type: Object, default: () => ({ label: '', iconType: 'pin' }) },
-  editPoi: { type: Object, default: null },
-  deletePoi: { type: Object, default: null },
-})
-defineEmits(['close', 'submit', 'confirmDelete'])
-
-const modalRef = ref(null)
-const iconRef = ref(null)
-const iconOpen = ref(false)
-const localForm = ref({ label: '', iconType: 'pin' })
-
-watch(() => props.show, (show) => {
-  if (!show) return
-  iconOpen.value = false
-  localForm.value = props.mode === 'edit' && props.editPoi
-    ? { label: (props.editPoi.label ?? '').trim(), iconType: props.editPoi.icon_type || 'pin' }
-    : { ...props.form }
-})
-
-function onDocClick(e) {
-  if (iconOpen.value && iconRef.value && !iconRef.value.contains(e.target)) iconOpen.value = false
-}
-onMounted(() => document.addEventListener('click', onDocClick))
-onBeforeUnmount(() => document.removeEventListener('click', onDocClick))
-</script>

app/composables/useAutoCloseLiveSession.js

@@ -1,12 +0,0 @@
-/** Auto-closes selectedCamera when the selected live session disappears from liveSessions. */
-export function useAutoCloseLiveSession(selectedCamera, liveSessions) {
-  watch(
-    [() => selectedCamera.value, () => liveSessions.value],
-    ([sel, sessions]) => {
-      if (!sel || typeof sel.hasStream === 'undefined') return
-      const stillActive = (sessions ?? []).some(s => s.id === sel.id)
-      if (!stillActive) selectedCamera.value = null
-    },
-    { deep: true },
-  )
-}

app/composables/useCameras.js

@@ -1,19 +1,16 @@
-/** Fetches devices + live sessions; polls when tab visible. */
+/**
+ * Fetches devices + live sessions (unified cameras). Optionally polls when tab is visible.
+ */
 const POLL_MS = 1500
-const EMPTY_RESPONSE = Object.freeze({ devices: [], liveSessions: [] })
 
 export function useCameras(options = {}) {
   const { poll: enablePoll = true } = options
   const { data, refresh } = useAsyncData(
     'cameras',
-    () => $fetch('/api/cameras').catch(() => EMPTY_RESPONSE),
+    () => $fetch('/api/cameras').catch(() => ({ devices: [], liveSessions: [] })),
-    { default: () => EMPTY_RESPONSE },
+    { default: () => ({ devices: [], liveSessions: [] }) },
   )
 
-  const devices = computed(() => Object.freeze([...(data.value?.devices ?? [])]))
-  const liveSessions = computed(() => Object.freeze([...(data.value?.liveSessions ?? [])]))
-  const cameras = computed(() => Object.freeze([...devices.value, ...liveSessions.value]))
-
   const pollInterval = ref(null)
   function startPolling() {
     if (!enablePoll || pollInterval.value) return
@@ -30,11 +27,22 @@ export function useCameras(options = {}) {
   onMounted(() => {
     if (typeof document === 'undefined') return
     document.addEventListener('visibilitychange', () => {
-      document.visibilityState === 'visible' ? (startPolling(), refresh()) : stopPolling()
+      if (document.visibilityState === 'visible') {
+        startPolling()
+        refresh()
+      }
+      else {
+        stopPolling()
+      }
     })
     if (document.visibilityState === 'visible') startPolling()
   })
   onBeforeUnmount(stopPolling)
 
-  return Object.freeze({ data, devices, liveSessions, cameras, refresh, startPolling, stopPolling })
+  const devices = computed(() => data.value?.devices ?? [])
+  const liveSessions = computed(() => data.value?.liveSessions ?? [])
+  /** All cameras: devices first, then live sessions */
+  const cameras = computed(() => [...devices.value, ...liveSessions.value])
+
+  return { data, devices, liveSessions, cameras, refresh, startPolling, stopPolling }
 }

app/composables/useLiveSessions.js

@@ -1,12 +1,24 @@
-/** Fetches live sessions; polls when tab visible. */
+/**
+ * Fetches active live sessions (camera + location sharing) and refreshes on an interval.
+ * Only runs when the app is focused so we don't poll in the background.
+ */
+
 const POLL_MS = 1500
 
 export function useLiveSessions() {
-  const { data: _sessions, refresh } = useAsyncData(
+  const { data: sessions, refresh } = useAsyncData(
     'live-sessions',
     async () => {
       try {
-        return await $fetch('/api/live')
+        const result = await $fetch('/api/live')
+        if (process.env.NODE_ENV === 'development') {
+          console.log('[useLiveSessions] Fetched sessions:', result.map(s => ({
+            id: s.id,
+            label: s.label,
+            hasStream: s.hasStream,
+          })))
+        }
+        return result
       }
       catch (err) {
         const msg = err?.message ?? String(err)
@@ -18,13 +30,14 @@ export function useLiveSessions() {
     { default: () => [] },
   )
 
-  const sessions = computed(() => Object.freeze([...(_sessions.value ?? [])]))
   const pollInterval = ref(null)
 
   function startPolling() {
     if (pollInterval.value) return
+    refresh() // Fetch immediately so new sessions show without waiting for first interval
+    pollInterval.value = setInterval(() => {
       refresh()
-    pollInterval.value = setInterval(refresh, POLL_MS)
+    }, POLL_MS)
   }
 
   function stopPolling() {
@@ -36,12 +49,21 @@ export function useLiveSessions() {
 
   onMounted(() => {
     if (typeof document === 'undefined') return
+    const onFocus = () => startPolling()
+    const onBlur = () => stopPolling()
     document.addEventListener('visibilitychange', () => {
-      document.visibilityState === 'visible' ? (startPolling(), refresh()) : stopPolling()
+      if (document.visibilityState === 'visible') {
+        onFocus()
+        refresh() // Fresh data when returning to tab
+      }
+      else onBlur()
     })
     if (document.visibilityState === 'visible') startPolling()
   })
-  onBeforeUnmount(stopPolling)
 
-  return Object.freeze({ sessions, refresh, startPolling, stopPolling })
+  onBeforeUnmount(() => {
+    stopPolling()
+  })
+
+  return { sessions, refresh, startPolling, stopPolling }
 }

app/composables/useUser.js

@@ -1,5 +1,3 @@
-const EDIT_ROLES = Object.freeze(['admin', 'leader'])
-
 export function useUser() {
   const requestFetch = useRequestFetch()
   const { data: user, refresh } = useAsyncData(
@@ -7,7 +5,7 @@ export function useUser() {
     () => (requestFetch ?? $fetch)('/api/me').catch(() => null),
     { default: () => null },
   )
-  const canEditPois = computed(() => EDIT_ROLES.includes(user.value?.role))
+  const canEditPois = computed(() => user.value?.role === 'admin' || user.value?.role === 'leader')
   const isAdmin = computed(() => user.value?.role === 'admin')
-  return Object.freeze({ user, canEditPois, isAdmin, refresh })
+  return { user, canEditPois, isAdmin, refresh }
 }

app/composables/useWebRTC.js

@@ -1,26 +1,61 @@
-/** WebRTC/Mediasoup client utilities. */
+/**
+ * WebRTC composable for Mediasoup client operations.
+ * Handles device initialization, transport creation, and WebSocket signaling.
+ */
+
 import { logError, logWarn } from '../utils/logger.js'
 
-const FETCH_OPTS = { credentials: 'include' }
+/**
-
+ * Initialize Mediasoup device from router RTP capabilities.
+ * @param {object} rtpCapabilities
+ * @returns {Promise<object>} Mediasoup device
+ */
 export async function createMediasoupDevice(rtpCapabilities) {
-  if (typeof window === 'undefined') throw new TypeError('Mediasoup device can only be created in browser')
+  // Dynamically import mediasoup-client only in browser
+  if (typeof window === 'undefined') {
+    throw new TypeError('Mediasoup device can only be created in browser')
+  }
+
+  // Use dynamic import for mediasoup-client
   const { Device } = await import('mediasoup-client')
   const device = new Device()
   await device.load({ routerRtpCapabilities: rtpCapabilities })
   return device
 }
 
+/**
+ * Create WebSocket connection for signaling.
+ * @param {string} url - WebSocket URL (e.g., 'ws://localhost:3000/ws')
+ * @returns {Promise<WebSocket>} WebSocket connection
+ */
 export function createWebSocketConnection(url) {
   return new Promise((resolve, reject) => {
     const protocol = window.location.protocol === 'https:' ? 'wss:' : 'ws:'
     const wsUrl = url.startsWith('ws') ? url : `${protocol}//${window.location.host}/ws`
     const ws = new WebSocket(wsUrl)
-    ws.onopen = () => resolve(ws)
+
-    ws.onerror = () => reject(new Error('WebSocket connection failed'))
+    ws.onopen = () => {
+      resolve(ws)
+    }
+
+    ws.onerror = () => {
+      reject(new Error('WebSocket connection failed'))
+    }
+
+    ws.onclose = () => {
+      // Connection closed
+    }
   })
 }
 
+/**
+ * Send WebSocket message and wait for response.
+ * @param {WebSocket} ws
+ * @param {string} sessionId
+ * @param {string} type
+ * @param {object} data
+ * @returns {Promise<object>} Response message
+ */
 export function sendWebSocketMessage(ws, sessionId, type, data = {}) {
   return new Promise((resolve, reject) => {
     if (ws.readyState !== WebSocket.OPEN) {
@@ -60,20 +95,41 @@ export function sendWebSocketMessage(ws, sessionId, type, data = {}) {
   })
 }
 
-function attachTransportHandlers(transport, transportParams, sessionId, label, { onConnectSuccess, onConnectFailure } = {}) {
+/**
+ * Create send transport (for publisher).
+ * @param {object} device
+ * @param {string} sessionId
+ * @param {{ onConnectSuccess?: () => void, onConnectFailure?: (err: Error) => void }} [options] - Optional callbacks when transport connect succeeds or fails.
+ * @returns {Promise<object>} Transport with send method
+ */
+export async function createSendTransport(device, sessionId, options = {}) {
+  const { onConnectSuccess, onConnectFailure } = options
+  // Create transport via HTTP API
+  const transportParams = await $fetch('/api/live/webrtc/create-transport', {
+    method: 'POST',
+    body: { sessionId, isProducer: true },
+    credentials: 'include',
+  })
+  const transport = device.createSendTransport({
+    id: transportParams.id,
+    iceParameters: transportParams.iceParameters,
+    iceCandidates: transportParams.iceCandidates,
+    dtlsParameters: transportParams.dtlsParameters,
+  })
+
   transport.on('connect', async ({ dtlsParameters }, callback, errback) => {
     try {
       await $fetch('/api/live/webrtc/connect-transport', {
         method: 'POST',
         body: { sessionId, transportId: transportParams.id, dtlsParameters },
-        ...FETCH_OPTS,
+        credentials: 'include',
       })
       onConnectSuccess?.()
       callback()
     }
     catch (err) {
-      logError(`useWebRTC: ${label} transport connect failed`, {
+      logError('useWebRTC: Send transport connect failed', {
-        err: err?.message ?? String(err),
+        err: err.message || String(err),
         transportId: transportParams.id,
         connectionState: transport.connectionState,
         sessionId,
@@ -82,50 +138,48 @@ function attachTransportHandlers(transport, transportParams, sessionId, label, {
       errback(err)
     }
   })
+
   transport.on('connectionstatechange', () => {
     const state = transport.connectionState
-    if (['failed', 'disconnected', 'closed'].includes(state)) {
+    if (state === 'failed' || state === 'disconnected' || state === 'closed') {
-      logWarn(`useWebRTC: ${label} transport connection state changed`, { state, transportId: transportParams.id, sessionId })
+      logWarn('useWebRTC: Send transport connection state changed', {
+        state,
+        transportId: transportParams.id,
+        sessionId,
+      })
     }
   })
-}
-
-export async function createSendTransport(device, sessionId, options = {}) {
-  const transportParams = await $fetch('/api/live/webrtc/create-transport', {
-    method: 'POST',
-    body: { sessionId, isProducer: true },
-    ...FETCH_OPTS,
-  })
-  const transport = device.createSendTransport({
-    id: transportParams.id,
-    iceParameters: transportParams.iceParameters,
-    iceCandidates: transportParams.iceCandidates,
-    dtlsParameters: transportParams.dtlsParameters,
-  })
-  attachTransportHandlers(transport, transportParams, sessionId, 'Send', options)
 
   transport.on('produce', async ({ kind, rtpParameters }, callback, errback) => {
     try {
       const { id } = await $fetch('/api/live/webrtc/create-producer', {
         method: 'POST',
         body: { sessionId, transportId: transportParams.id, kind, rtpParameters },
-        ...FETCH_OPTS,
+        credentials: 'include',
       })
       callback({ id })
     }
     catch (err) {
-      logError('useWebRTC: Producer creation failed', { err: err?.message ?? String(err) })
+      logError('useWebRTC: Producer creation failed', { err: err.message || String(err) })
       errback(err)
     }
   })
+
   return transport
 }
 
+/**
+ * Create receive transport (for viewer).
+ * @param {object} device
+ * @param {string} sessionId
+ * @returns {Promise<object>} Transport with consume method
+ */
 export async function createRecvTransport(device, sessionId) {
+  // Create transport via HTTP API
   const transportParams = await $fetch('/api/live/webrtc/create-transport', {
     method: 'POST',
     body: { sessionId, isProducer: false },
-    ...FETCH_OPTS,
+    credentials: 'include',
   })
   const transport = device.createRecvTransport({
     id: transportParams.id,
@@ -133,15 +187,55 @@ export async function createRecvTransport(device, sessionId) {
     iceCandidates: transportParams.iceCandidates,
     dtlsParameters: transportParams.dtlsParameters,
   })
-  attachTransportHandlers(transport, transportParams, sessionId, 'Recv')
+
+  // Set up connect handler (will be called by mediasoup-client when needed)
+  transport.on('connect', async ({ dtlsParameters }, callback, errback) => {
+    try {
+      await $fetch('/api/live/webrtc/connect-transport', {
+        method: 'POST',
+        body: { sessionId, transportId: transportParams.id, dtlsParameters },
+        credentials: 'include',
+      })
+      callback()
+    }
+    catch (err) {
+      logError('useWebRTC: Recv transport connect failed', {
+        err: err.message || String(err),
+        transportId: transportParams.id,
+        connectionState: transport.connectionState,
+        sessionId,
+      })
+      errback(err)
+    }
+  })
+
+  transport.on('connectionstatechange', () => {
+    const state = transport.connectionState
+    if (state === 'failed' || state === 'disconnected' || state === 'closed') {
+      logWarn('useWebRTC: Recv transport connection state changed', {
+        state,
+        transportId: transportParams.id,
+        sessionId,
+      })
+    }
+  })
+
   return transport
 }
 
+/**
+ * Consume producer's stream (for viewer).
+ * @param {object} transport
+ * @param {object} device
+ * @param {string} sessionId
+ * @returns {Promise<object>} Consumer with track
+ */
 export async function consumeProducer(transport, device, sessionId) {
+  const rtpCapabilities = device.rtpCapabilities
   const consumerParams = await $fetch('/api/live/webrtc/create-consumer', {
     method: 'POST',
-    body: { sessionId, transportId: transport.id, rtpCapabilities: device.rtpCapabilities },
+    body: { sessionId, transportId: transport.id, rtpCapabilities },
-    ...FETCH_OPTS,
+    credentials: 'include',
   })
 
   const consumer = await transport.consume({
@@ -162,6 +256,14 @@ export async function consumeProducer(transport, device, sessionId) {
   return consumer
 }
 
+/**
+ * Resolve when condition() returns truthy, or after timeoutMs (then resolve anyway).
+ * No mutable shared state; cleanup on first completion.
+ * @param {() => unknown} condition
+ * @param {number} timeoutMs
+ * @param {number} intervalMs
+ * @returns {Promise<void>}
+ */
 function waitForCondition(condition, timeoutMs = 3000, intervalMs = 100) {
   return new Promise((resolve) => {
     const timeoutId = setTimeout(() => {
@@ -183,6 +285,12 @@ function waitForCondition(condition, timeoutMs = 3000, intervalMs = 100) {
   })
 }
 
+/**
+ * Wait for transport connection state to reach a terminal state or timeout.
+ * @param {object} transport - Mediasoup transport with connectionState and on/off
+ * @param {number} timeoutMs
+ * @returns {Promise<string>} Final connection state
+ */
 export function waitForConnectionState(transport, timeoutMs = 10000) {
   const terminal = ['connected', 'failed', 'disconnected', 'closed']
   return new Promise((resolve) => {

app/composables/useWebRTCFailureReason.js

@@ -1,13 +1,18 @@
-/** Pure: fetches WebRTC failure reason (e.g. wrong host). Returns frozen object. */
+/**
+ * Fetch WebRTC failure reason (e.g. wrong host). Pure: same inputs → same output.
+ * @returns {Promise<{ wrongHost: { serverHostname: string, clientHostname: string } | null }>} Failure reason or null.
+ */
 export async function getWebRTCFailureReason() {
   try {
     const res = await $fetch('/api/live/debug-request-host', { credentials: 'include' })
     const clientHostname = typeof window !== 'undefined' ? window.location.hostname : ''
     const serverHostname = res?.hostname ?? ''
     if (serverHostname && clientHostname && serverHostname !== clientHostname) {
-      return Object.freeze({ wrongHost: Object.freeze({ serverHostname, clientHostname }) })
+      return { wrongHost: { serverHostname, clientHostname } }
     }
   }
-  catch { /* ignore */ }
+  catch {
-  return Object.freeze({ wrongHost: null })
+    // ignore
+  }
+  return { wrongHost: null }
 }

app/error.vue

@@ -1,7 +1,7 @@
 <template>
   <div class="flex min-h-screen items-center justify-center bg-kestrel-bg font-mono text-kestrel-text">
     <div class="text-center">
-      <h1 class="text-2xl font-semibold tracking-wide text-shadow-glow-md">
+      <h1 class="text-2xl font-semibold tracking-wide [text-shadow:0_0_12px_rgba(34,201,201,0.3)]">
         [ Error ]
       </h1>
       <p class="mt-2 text-sm text-kestrel-muted">

app/layouts/default.vue

@@ -6,7 +6,7 @@
         class="flex min-h-0 flex-1 flex-col transition-[margin] duration-200 ease-out"
         :class="{ 'md:ml-[260px]': drawerOpen }"
       >
-        <header class="flex h-14 shrink-0 items-center gap-3 border-b border-kestrel-border bg-kestrel-surface px-4 shadow-glow-sm shadow-glow-header">
+        <header class="flex h-14 shrink-0 items-center gap-3 border-b border-kestrel-border bg-kestrel-surface px-4 shadow-glow-sm [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
           <button
             type="button"
             class="rounded p-2 text-kestrel-muted transition-colors hover:bg-kestrel-border hover:text-kestrel-accent"
@@ -20,7 +20,7 @@
             >&#9776;</span>
           </button>
           <div class="min-w-0 flex-1">
-            <h1 class="text-lg font-semibold tracking-wide text-kestrel-text text-shadow-glow-md">
+            <h1 class="text-lg font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_12px_rgba(34,201,201,0.35)]">
               KestrelOS
             </h1>
             <p class="text-xs uppercase tracking-widest text-kestrel-muted">

app/pages/account.vue

@@ -1,14 +1,15 @@
 <template>
   <div class="p-6">
-    <h2 class="kestrel-page-heading mb-4">
+    <h2 class="mb-4 text-xl font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
       Account
     </h2>
 
+    <!-- Profile -->
     <section class="mb-8">
-      <h3 class="kestrel-section-label">
+      <h3 class="mb-2 text-sm font-medium uppercase tracking-wider text-kestrel-muted">
         Profile
       </h3>
-      <div class="kestrel-card p-4">
+      <div class="rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
         <template v-if="user">
           <dl class="space-y-2 text-sm">
             <div>
@@ -49,14 +50,15 @@
       </div>
     </section>
 
+    <!-- Change password (local only) -->
     <section
       v-if="user?.auth_provider === 'local'"
       class="mb-8"
     >
-      <h3 class="kestrel-section-label">
+      <h3 class="mb-2 text-sm font-medium uppercase tracking-wider text-kestrel-muted">
         Change password
       </h3>
-      <div class="kestrel-card p-4">
+      <div class="rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
         <p
           v-if="passwordSuccess"
           class="mb-3 text-sm text-green-400"
@@ -76,40 +78,46 @@
           <div>
             <label
               for="account-current-password"
-              class="kestrel-label"
+              class="mb-1 block text-xs text-kestrel-muted"
-            >Current password</label>
+            >
+              Current password
+            </label>
             <input
               id="account-current-password"
               v-model="currentPassword"
               type="password"
               autocomplete="current-password"
-              class="kestrel-input"
+              class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text outline-none focus:border-kestrel-accent"
             >
           </div>
           <div>
             <label
               for="account-new-password"
-              class="kestrel-label"
+              class="mb-1 block text-xs text-kestrel-muted"
-            >New password</label>
+            >
+              New password
+            </label>
             <input
               id="account-new-password"
               v-model="newPassword"
               type="password"
               autocomplete="new-password"
-              class="kestrel-input"
+              class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text outline-none focus:border-kestrel-accent"
             >
           </div>
           <div>
             <label
               for="account-confirm-password"
-              class="kestrel-label"
+              class="mb-1 block text-xs text-kestrel-muted"
-            >Confirm new password</label>
+            >
+              Confirm new password
+            </label>
             <input
               id="account-confirm-password"
               v-model="confirmPassword"
               type="password"
               autocomplete="new-password"
-              class="kestrel-input"
+              class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text outline-none focus:border-kestrel-accent"
             >
           </div>
           <button

app/pages/cameras.vue

@@ -1,6 +1,6 @@
 <template>
   <div class="p-6">
-    <h2 class="kestrel-page-heading mb-4">
+    <h2 class="mb-4 text-xl font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
       Cameras
     </h2>
     <p class="mb-4 text-sm text-kestrel-muted">
@@ -80,8 +80,6 @@
 <script setup>
 definePageMeta({ layout: 'default' })
 
-const { cameras, liveSessions } = useCameras()
+const { cameras } = useCameras()
 const selectedCamera = ref(null)
-
-useAutoCloseLiveSession(selectedCamera, liveSessions)
 </script>

app/pages/index.vue

@@ -3,6 +3,7 @@
     <div class="relative h-2/3 w-full md:h-full md:flex-1">
       <ClientOnly>
         <KestrelMap
+          :feeds="[]"
           :devices="devices ?? []"
           :pois="pois ?? []"
           :live-sessions="liveSessions ?? []"
@@ -28,8 +29,7 @@ const { canEditPois } = useUser()
 const selectedCamera = ref(null)
 
 function onSelectLive(session) {
-  selectedCamera.value = (liveSessions.value ?? []).find(s => s.id === session?.id) ?? session
+  const latest = (liveSessions.value || []).find(s => s.id === session?.id)
+  selectedCamera.value = latest ?? session
 }
-
-useAutoCloseLiveSession(selectedCamera, liveSessions)
 </script>

app/pages/login.vue

@@ -1,7 +1,7 @@
 <template>
   <div class="flex min-h-[60vh] items-center justify-center p-6">
-    <div class="kestrel-card w-full max-w-sm p-6">
+    <div class="w-full max-w-sm rounded border border-kestrel-border bg-kestrel-surface p-6 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
-      <h2 class="kestrel-section-heading mb-4">
+      <h2 class="mb-4 text-lg font-semibold text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
         Sign in
       </h2>
       <p
@@ -29,28 +29,28 @@
         <div class="mb-3">
           <label
             for="login-identifier"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Email or username</label>
           <input
             id="login-identifier"
             v-model="identifier"
             type="text"
             autocomplete="username"
-            class="kestrel-input"
+            class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text outline-none focus:border-kestrel-accent"
             required
           >
         </div>
         <div class="mb-4">
           <label
             for="login-password"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Password</label>
           <input
             id="login-password"
             v-model="password"
             type="password"
             autocomplete="current-password"
-            class="kestrel-input"
+            class="w-full rounded border border-kestrel-border bg-kestrel-bg px-3 py-2 text-sm text-kestrel-text outline-none focus:border-kestrel-accent"
             required
           >
         </div>
@@ -69,16 +69,16 @@
 <script setup>
 const route = useRoute()
 const redirect = computed(() => route.query.redirect || '/')
-const AUTH_CONFIG_DEFAULT = Object.freeze({ oidc: { enabled: false, label: '' } })
 const { data: authConfig } = useAsyncData(
   'auth-config',
-  () => $fetch('/api/auth/config').catch(() => AUTH_CONFIG_DEFAULT),
+  () => $fetch('/api/auth/config').catch(() => ({ oidc: { enabled: false, label: '' } })),
   { default: () => null },
 )
 const showDivider = computed(() => !!authConfig.value?.oidc?.enabled)
 const oidcAuthorizeUrl = computed(() => {
-  const r = redirect.value
+  const base = '/api/auth/oidc/authorize'
-  return `/api/auth/oidc/authorize${r && r !== '/' ? `?redirect=${encodeURIComponent(r)}` : ''}`
+  const q = redirect.value && redirect.value !== '/' ? `?redirect=${encodeURIComponent(redirect.value)}` : ''
+  return base + q
 })
 
 const identifier = ref('')

app/pages/members.vue

@@ -1,6 +1,6 @@
 <template>
   <div class="p-6">
-    <h2 class="kestrel-page-heading mb-2">
+    <h2 class="mb-2 text-xl font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
       Members
     </h2>
     <p
@@ -10,7 +10,7 @@
       Sign in to view members.
     </p>
     <p
-      v-else-if="!canEditPois"
+      v-else-if="!canViewMembers"
       class="text-sm text-kestrel-muted"
     >
       You don't have access to the members list.
@@ -149,7 +149,7 @@
             v-if="openRoleDropdownId && dropdownPlacement"
             ref="dropdownMenuRef"
             role="menu"
-            class="fixed z-[100] min-w-[6rem] rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow shadow-glow-dropdown"
+            class="fixed z-[100] min-w-[6rem] rounded border border-kestrel-border bg-kestrel-surface py-1 shadow-glow [box-shadow:0_4px_12px_-2px_rgba(34,201,201,0.15)]"
             :style="{
               top: `${dropdownPlacement.top}px`,
               left: `${dropdownPlacement.left}px`,
@@ -183,7 +183,7 @@
           @click.self="closeAddUserModal"
         >
           <div
-            class="kestrel-card-modal w-full max-w-sm p-4"
+            class="w-full max-w-sm rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow"
             @click.stop
           >
             <h3
@@ -204,7 +204,7 @@
                   type="text"
                   required
                   autocomplete="username"
-                  class="kestrel-input"
+                  class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1.5 text-sm text-kestrel-text"
                   placeholder="username"
                 >
               </div>
@@ -219,7 +219,7 @@
                   type="password"
                   required
                   autocomplete="new-password"
-                  class="kestrel-input"
+                  class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1.5 text-sm text-kestrel-text"
                   placeholder="••••••••"
                 >
               </div>
@@ -231,7 +231,7 @@
                 <select
                   id="add-role"
                   v-model="newUser.role"
-                  class="kestrel-input"
+                  class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1.5 text-sm text-kestrel-text"
                 >
                   <option value="member">
                     member
@@ -253,7 +253,7 @@
               <div class="flex justify-end gap-2">
                 <button
                   type="button"
-                  class="kestrel-btn-secondary"
+                  class="rounded border border-kestrel-border px-3 py-1.5 text-sm text-kestrel-text hover:bg-kestrel-surface-hover"
                   @click="closeAddUserModal"
                 >
                   Cancel
@@ -280,7 +280,7 @@
           @click.self="deleteConfirmUser = null"
         >
           <div
-            class="kestrel-card-modal w-full max-w-sm p-4"
+            class="w-full max-w-sm rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow"
             @click.stop
           >
             <h3
@@ -295,7 +295,7 @@
             <div class="flex justify-end gap-2">
               <button
                 type="button"
-                class="kestrel-btn-secondary"
+                class="rounded border border-kestrel-border px-3 py-1.5 text-sm text-kestrel-text hover:bg-kestrel-surface-hover"
                 @click="deleteConfirmUser = null"
               >
                 Cancel
@@ -318,7 +318,7 @@
           @click.self="editUserModal = null"
         >
           <div
-            class="kestrel-card-modal w-full max-w-sm p-4"
+            class="w-full max-w-sm rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow"
             role="dialog"
             aria-modal="true"
             aria-labelledby="edit-user-title"
@@ -340,7 +340,7 @@
                   v-model="editForm.identifier"
                   type="text"
                   required
-                  class="kestrel-input"
+                  class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1.5 text-sm text-kestrel-text"
                 >
               </div>
               <div class="mb-4 flex flex-col gap-1">
@@ -353,7 +353,7 @@
                   v-model="editForm.password"
                   type="password"
                   autocomplete="new-password"
-                  class="kestrel-input"
+                  class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1.5 text-sm text-kestrel-text"
                   placeholder="••••••••"
                 >
                 <p class="mt-0.5 text-xs text-kestrel-muted">
@@ -369,7 +369,7 @@
               <div class="flex justify-end gap-2">
                 <button
                   type="button"
-                  class="kestrel-btn-secondary"
+                  class="rounded border border-kestrel-border px-3 py-1.5 text-sm text-kestrel-text hover:bg-kestrel-surface-hover"
                   @click="editUserModal = null"
                 >
                   Cancel
@@ -390,14 +390,15 @@
 </template>
 
 <script setup>
-const { user, isAdmin, canEditPois, refresh: refreshUser } = useUser()
+const { user, isAdmin, refresh: refreshUser } = useUser()
+const canViewMembers = computed(() => user.value?.role === 'admin' || user.value?.role === 'leader')
 
 const { data: usersData, refresh: refreshUsers } = useAsyncData(
   'users',
   () => $fetch('/api/users').catch(() => []),
   { default: () => [] },
 )
-const users = computed(() => Object.freeze([...(usersData.value ?? [])]))
+const users = computed(() => (Array.isArray(usersData.value) ? usersData.value : []))
 
 const roleOptions = ['admin', 'leader', 'member']
 const pendingRoleUpdates = ref({})
@@ -427,8 +428,8 @@ function setDropdownWrapRef(userId, el) {
   }
 }
 
-watch(user, () => {
+watch(user, (u) => {
-  if (canEditPois.value) refreshUsers()
+  if (u?.role === 'admin' || u?.role === 'leader') refreshUsers()
 }, { immediate: true })
 
 function toggleRoleDropdown(userId) {

app/pages/poi.vue

@@ -1,6 +1,6 @@
 <template>
   <div class="p-6">
-    <h2 class="kestrel-page-heading mb-2">
+    <h2 class="mb-2 text-xl font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
       POI placement
     </h2>
     <p
@@ -17,7 +17,7 @@
         <div>
           <label
             for="poi-lat"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Lat</label>
           <input
             id="poi-lat"
@@ -25,13 +25,13 @@
             type="number"
             step="any"
             required
-            class="kestrel-input w-28"
+            class="w-28 rounded border border-kestrel-border bg-kestrel-bg px-2 py-1 text-sm text-kestrel-text"
           >
         </div>
         <div>
           <label
             for="poi-lng"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Lng</label>
           <input
             id="poi-lng"
@@ -39,37 +39,39 @@
             type="number"
             step="any"
             required
-            class="kestrel-input w-28"
+            class="w-28 rounded border border-kestrel-border bg-kestrel-bg px-2 py-1 text-sm text-kestrel-text"
           >
         </div>
         <div>
           <label
             for="poi-label"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Label</label>
           <input
             id="poi-label"
             v-model="form.label"
             type="text"
-            class="kestrel-input w-40"
+            class="w-40 rounded border border-kestrel-border bg-kestrel-bg px-2 py-1 text-sm text-kestrel-text"
           >
         </div>
         <div>
           <label
             for="poi-icon"
-            class="kestrel-label"
+            class="mb-1 block text-xs text-kestrel-muted"
           >Icon</label>
           <select
             id="poi-icon"
             v-model="form.iconType"
-            class="kestrel-input w-28"
+            class="rounded border border-kestrel-border bg-kestrel-bg px-2 py-1 text-sm text-kestrel-text"
           >
-            <option
+            <option value="pin">
-              v-for="opt in POI_ICON_TYPES"
+              pin
-              :key="opt"
+            </option>
-              :value="opt"
+            <option value="flag">
-            >
+              flag
-              {{ opt }}
+            </option>
+            <option value="waypoint">
+              waypoint
             </option>
           </select>
         </div>
@@ -143,8 +145,6 @@
 </template>
 
 <script setup>
-const POI_ICON_TYPES = Object.freeze(['pin', 'flag', 'waypoint'])
-
 const { data: poisData, refresh } = usePois()
 const { canEditPois } = useUser()
 const poisList = computed(() => poisData.value ?? [])

app/pages/settings.vue

@@ -1,14 +1,15 @@
 <template>
   <div class="p-6">
-    <h2 class="kestrel-page-heading mb-4">
+    <h2 class="mb-4 text-xl font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
       Settings
     </h2>
 
+    <!-- Map & offline -->
     <section class="mb-8">
-      <h3 class="kestrel-section-label">
+      <h3 class="mb-2 text-sm font-medium uppercase tracking-wider text-kestrel-muted">
         Map & offline
       </h3>
-      <div class="kestrel-card p-4">
+      <div class="rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
         <p class="mb-3 text-sm text-kestrel-text">
           Clear saved map tiles to free storage. The map will load tiles from the network again when you use it.
         </p>
@@ -27,7 +28,7 @@
         </p>
         <button
           type="button"
-          class="kestrel-btn-secondary disabled:opacity-50"
+          class="rounded border border-kestrel-border px-4 py-2 text-sm text-kestrel-text transition-colors hover:bg-kestrel-border disabled:opacity-50"
           :disabled="tilesLoading"
           @click="onClearTiles"
         >
@@ -36,11 +37,12 @@
       </div>
     </section>
 
+    <!-- About -->
     <section>
-      <h3 class="kestrel-section-label">
+      <h3 class="mb-2 text-sm font-medium uppercase tracking-wider text-kestrel-muted">
         About
       </h3>
-      <div class="kestrel-card p-4">
+      <div class="rounded border border-kestrel-border bg-kestrel-surface p-4 shadow-glow [box-shadow:0_0_20px_-4px_rgba(34,201,201,0.15)]">
         <p class="font-medium text-kestrel-text">
           KestrelOS
         </p>

app/pages/share-live.vue

@@ -1,7 +1,7 @@
 <template>
   <div class="flex min-h-[80vh] flex-col items-center justify-center p-6">
-    <div class="kestrel-card-modal w-full max-w-md p-6">
+    <div class="w-full max-w-md rounded-lg border border-kestrel-border bg-kestrel-surface p-6 shadow-glow [box-shadow:0_0_24px_-6px_rgba(34,201,201,0.2)]">
-      <h2 class="kestrel-section-heading mb-2">
+      <h2 class="mb-2 text-lg font-semibold tracking-wide text-kestrel-text [text-shadow:0_0_8px_rgba(34,201,201,0.25)]">
         Share live (camera + location)
       </h2>
       <p class="mb-4 text-sm text-kestrel-muted">
@@ -55,7 +55,7 @@
       <!-- Local preview -->
       <div
         v-if="stream && videoRef"
-        class="kestrel-video-frame mb-4"
+        class="relative mb-4 aspect-video w-full overflow-hidden rounded border border-kestrel-border bg-black"
       >
         <video
           ref="videoRef"

app/plugins/auth.client.js

@@ -1,4 +1,3 @@
-/** Wraps $fetch to redirect to /login on 401 for same-origin requests. */
 export default defineNuxtPlugin(() => {
   const route = useRoute()
   const baseFetch = globalThis.$fetch ?? $fetch
@@ -7,7 +6,8 @@ export default defineNuxtPlugin(() => {
       if (response?.status !== 401) return
       const url = typeof request === 'string' ? request : request?.url ?? ''
       if (!url.startsWith('/')) return
-      navigateTo({ path: '/login', query: { redirect: route.fullPath || '/' } }, { replace: true })
+      const redirect = (route.fullPath && route.fullPath !== '/' ? route.fullPath : '/')
+      navigateTo({ path: '/login', query: { redirect } }, { replace: true })
     },
   })
 })

app/utils/logger.js

@@ -1,30 +1,88 @@
-/** Client-side logger: sends to server, falls back to console. */
+/**
+ * Client-side logger that sends logs to server for debugging.
+ * Falls back to console if server logging fails.
+ */
+
 let sessionId = null
 let userId = null
 
-const CONSOLE_METHOD = Object.freeze({ error: 'error', warn: 'warn', info: 'log', debug: 'log' })
+/**
-
+ * Initialize logger with session/user context.
+ * @param {string} sessId
+ * @param {string} uid
+ */
 export function initLogger(sessId, uid) {
   sessionId = sessId
   userId = uid
 }
 
-function sendToServer(level, message, data) {
+/**
-  setTimeout(() => {
+ * Send log to server (non-blocking).
-    $fetch('/api/log', {
+ * @param {string} level
+ * @param {string} message
+ * @param {object} data
+ */
+async function sendToServer(level, message, data) {
+  // Use setTimeout to avoid blocking - fire and forget
+  setTimeout(async () => {
+    try {
+      await $fetch('/api/log', {
         method: 'POST',
-      body: { level, message, data, sessionId, userId, timestamp: new Date().toISOString() },
+        body: {
+          level,
+          message,
+          data,
+          sessionId,
+          userId,
+          timestamp: new Date().toISOString(),
+        },
         credentials: 'include',
-    }).catch(() => { /* server down - don't spam console */ })
+      }).catch(() => {
+        // Silently fail - don't spam console if server is down
+      })
+    }
+    catch {
+      // Ignore errors - logging shouldn't break the app
+    }
   }, 0)
 }
 
-function log(level, message, data) {
+/**
-  console[CONSOLE_METHOD[level]](`[${message}]`, data)
+ * Log at error level.
-  sendToServer(level, message, data)
+ * @param {string} message
+ * @param {object} data
+ */
+export function logError(message, data) {
+  console.error(`[${message}]`, data)
+  sendToServer('error', message, data)
 }
 
-export const logError = (message, data) => log('error', message, data)
+/**
-export const logWarn = (message, data) => log('warn', message, data)
+ * Log at warn level.
-export const logInfo = (message, data) => log('info', message, data)
+ * @param {string} message
-export const logDebug = (message, data) => log('debug', message, data)
+ * @param {object} data
+ */
+export function logWarn(message, data) {
+  console.warn(`[${message}]`, data)
+  sendToServer('warn', message, data)
+}
+
+/**
+ * Log at info level.
+ * @param {string} message
+ * @param {object} data
+ */
+export function logInfo(message, data) {
+  console.log(`[${message}]`, data)
+  sendToServer('info', message, data)
+}
+
+/**
+ * Log at debug level.
+ * @param {string} message
+ * @param {object} data
+ */
+export function logDebug(message, data) {
+  console.log(`[${message}]`, data)
+  sendToServer('debug', message, data)
+}

helm/kestrelos/Chart.yaml

@@ -2,5 +2,5 @@ apiVersion: v2
 name: kestrelos
 description: KestrelOS TOC for OSINT feeds - map, camera feeds, offline tiles
 type: application
-version: 0.3.0
+version: 0.1.0
-appVersion: "0.3.0"
+appVersion: "0.1.0"

helm/kestrelos/values.yaml

@@ -1,8 +1,8 @@
 replicaCount: 1
 
 image:
-  repository: git.keligrubb.com/keligrubb/kestrelos
+  repository: kestrelos
-  tag: 0.3.0
+  tag: latest
   pullPolicy: IfNotPresent
 
 service:

nuxt.config.js

@@ -27,7 +27,6 @@ export default defineNuxtConfig({
       ],
     },
   },
-  css: ['~/assets/css/main.css'],
   runtimeConfig: {
     public: {
       version: pkg.version ?? '',

package-lock.json

@@ -22,7 +22,6 @@
         "ws": "^8.18.0"
       },
       "devDependencies": {
-        "@iconify-json/tabler": "^1.2.26",
         "@nuxt/eslint": "^1.15.0",
         "@nuxt/test-utils": "^4.0.0",
         "@playwright/test": "^1.58.2",
@@ -1434,16 +1433,6 @@
         "url": "https://github.com/sponsors/nzakas"
       }
     },
-    "node_modules/@iconify-json/tabler": {
-      "version": "1.2.26",
-      "resolved": "https://registry.npmjs.org/@iconify-json/tabler/-/tabler-1.2.26.tgz",
-      "integrity": "sha512-92G+ZD70AZgeJf07JfQzH+isnai6DwPcMBuF/qL1F+xAxdXCJzGd3w2RmsRvOmB+w1ImmWEEDms50QivQIjd6g==",
-      "dev": true,
-      "license": "MIT",
-      "dependencies": {
-        "@iconify/types": "*"
-      }
-    },
     "node_modules/@iconify/collections": {
       "version": "1.0.649",
       "resolved": "https://registry.npmjs.org/@iconify/collections/-/collections-1.0.649.tgz",

package.json

@@ -1,6 +1,5 @@
 {
   "name": "kestrelos",
-  "version": "0.3.0",
   "private": true,
   "type": "module",
   "scripts": {
@@ -33,7 +32,6 @@
     "ws": "^8.18.0"
   },
   "devDependencies": {
-    "@iconify-json/tabler": "^1.2.26",
     "@nuxt/eslint": "^1.15.0",
     "@nuxt/test-utils": "^4.0.0",
     "@playwright/test": "^1.58.2",

playwright.config.js

@@ -35,7 +35,6 @@ export default defineConfig({
       name: 'desktop-chrome',
       use: {
         ...devices['Desktop Chrome'],
-        permissions: ['camera', 'microphone', 'geolocation'],
         launchOptions: {
           args: [
             '--use-fake-ui-for-media-stream',
@@ -53,10 +52,10 @@ export default defineConfig({
   ],
   webServer: {
     command: 'npm run dev',
-    url: 'https://localhost:3000/health/ready',
+    url: 'https://localhost:3000/health',
-    reuseExistingServer: !process.env.CI, // Don't reuse in CI (always start fresh)
+    reuseExistingServer: true, // Always reuse existing server for E2E tests
-    timeout: 180_000, // 3 minutes (180 seconds) for server startup (CI can be slower)
+    timeout: 120 * 1000, // 2 minutes for server startup
     ignoreHTTPSErrors: true,
   },
-  timeout: process.env.CI ? 180_000 : 60_000, // 3 minutes in CI, 1 minute locally (WebRTC setup takes time)
+  timeout: 60 * 1000, // 60 seconds per test (WebRTC setup takes time)
 })

scripts/release.sh

@@ -1,56 +0,0 @@
-#!/bin/sh
-set -e
-
-# version
-msg="${CI_COMMIT_MESSAGE:-}"
-bump=patch
-echo "$msg" | grep -qi minor: && bump=minor
-echo "$msg" | grep -qi major: && bump=major
-cur=$(awk '/"version"/ { match($0, /[0-9]+\.[0-9]+\.[0-9]+/); print substr($0, RSTART, RLENGTH); exit }' package.json)
-major=$(echo "$cur" | cut -d. -f1); minor=$(echo "$cur" | cut -d. -f2); patch=$(echo "$cur" | cut -d. -f3)
-case "$bump" in major) major=$((major+1)); minor=0; patch=0 ;; minor) minor=$((minor+1)); patch=0 ;; patch) patch=$((patch+1)) ;; esac
-newVersion="$major.$minor.$patch"
-[ -z "$cur" ] && { echo "error: could not read version from package.json"; exit 1; }
-
-# changelog entry (strip prefix from first line)
-changelogEntry=$(echo "$msg" | head -1 | awk '{sub(/^[mM]ajor:[ \t]*/,""); sub(/^[mM]inor:[ \t]*/,""); sub(/^[pP]atch:[ \t]*/,""); print}')
-[ -z "$changelogEntry" ] && changelogEntry="Release v$newVersion"
-
-# bump files
-awk -v v="$newVersion" '/"version"/ { sub(/[0-9]+\.[0-9]+\.[0-9]+/, v) } { print }' package.json > package.json.tmp && mv package.json.tmp package.json
-awk -v v="$newVersion" '/^version:/ { $0 = "version: " v }; /^appVersion:/ { $0 = "appVersion: \"" v "\"" }; { print }' helm/kestrelos/Chart.yaml > helm/kestrelos/Chart.yaml.tmp && mv helm/kestrelos/Chart.yaml.tmp helm/kestrelos/Chart.yaml
-awk -v v="$newVersion" '/^  tag:/ { $0 = "  tag: " v }; { print }' helm/kestrelos/values.yaml > helm/kestrelos/values.yaml.tmp && mv helm/kestrelos/values.yaml.tmp helm/kestrelos/values.yaml
-
-# changelog
-new="## [$newVersion] - $(date +%Y-%m-%d)
-### Changed
-- $changelogEntry
-
-"
-{ [ ! -f CHANGELOG.md ] && printf '# Changelog\n\n'; printf '%s' "$new"; [ -f CHANGELOG.md ] && cat CHANGELOG.md; } > CHANGELOG.md.tmp && mv CHANGELOG.md.tmp CHANGELOG.md
-
-# git
-git config user.email "ci@kestrelos" && git config user.name "CI"
-git add package.json helm/kestrelos/Chart.yaml helm/kestrelos/values.yaml CHANGELOG.md
-git commit -m "release v$newVersion [skip ci]"
-url="https://${CI_REPO_OWNER}:${GITEA_REPO_TOKEN}@${CI_FORGE_URL#https://}/${CI_REPO_OWNER}/${CI_REPO_NAME}.git"
-git tag "v$newVersion"
-# artifact for kaniko (tag list)
-printf '%s\n%s\n' "$newVersion" "latest" > .tags
-retry() { n=0; while ! "$@"; do n=$((n+1)); [ $n -ge 3 ] && return 1; sleep 2; done; }
-retry git push "$url" HEAD:main "v$newVersion"
-
-# gitea release
-body="## Changelog
-### Changed
-- $changelogEntry
-
-## Installation
-- [Docker image](${CI_FORGE_URL}/${CI_REPO_OWNER}/-/packages/container/${CI_REPO_NAME})
-- [Helm chart](${CI_FORGE_URL}/${CI_REPO_OWNER}/-/packages/helm/${CI_REPO_NAME})"
-release_url="${CI_FORGE_URL}/api/v1/repos/${CI_REPO_OWNER}/${CI_REPO_NAME}/releases"
-echo "$body" | awk -v tag="v$newVersion" 'BEGIN{printf "{\"tag_name\":\"" tag "\",\"name\":\"" tag "\",\"body\":\""} { gsub(/\\/,"\\\\"); gsub(/"/,"\\\""); if (NR>1) printf "\\n"; printf "%s", $0 } END{printf "\"}\n"}' > /tmp/release.json
-wget -q -O /dev/null --post-file=/tmp/release.json \
-  --header="Authorization: token ${GITEA_REPO_TOKEN}" \
-  --header="Content-Type: application/json" \
-  "$release_url"

server/api/cameras.get.js

@@ -7,6 +7,6 @@ export default defineEventHandler(async (event) => {
   requireAuth(event)
   const [db, sessions] = await Promise.all([getDb(), getActiveSessions()])
   const rows = await db.all('SELECT id, name, device_type, vendor, lat, lng, stream_url, source_type, config FROM devices ORDER BY id')
-  const devices = rows.map(rowToDevice).filter(Boolean).map(sanitizeDeviceForResponse)
+  const devices = rows.map(r => rowToDevice(r)).filter(Boolean).map(sanitizeDeviceForResponse)
   return { devices, liveSessions: sessions }
 })

server/api/live/webrtc/create-transport.post.js

@@ -26,7 +26,7 @@ export default defineEventHandler(async (event) => {
   const url = getRequestURL(event)
   const requestHost = url.hostname
   const router = await getRouter(sessionId)
-  const { transport, params } = await createTransport(router, requestHost)
+  const { transport, params } = await createTransport(router, Boolean(isProducer), requestHost)
 
   if (isProducer) {
     updateLiveSession(sessionId, {

server/api/log.post.js

@@ -1,11 +1,32 @@
-const CONSOLE_METHOD = Object.freeze({ error: 'error', warn: 'warn', info: 'log', debug: 'log' })
+/**
-
+ * Client-side logging endpoint.
+ * Accepts log messages from the browser and outputs them server-side.
+ */
 export default defineEventHandler(async (event) => {
+  // Note: Auth is optional - we rely on session cookie validation if needed
+
   const body = await readBody(event).catch(() => ({}))
   const { level, message, data, sessionId, userId } = body
-  const prefix = `[CLIENT${sessionId ? `:${sessionId}` : ''}${userId ? `:${userId.slice(0, 8)}` : ''}]`
+
-  const msg = data ? `${message} ${JSON.stringify(data)}` : message
+  const logPrefix = `[CLIENT${sessionId ? `:${sessionId}` : ''}${userId ? `:${userId.slice(0, 8)}` : ''}]`
-  const method = CONSOLE_METHOD[level] || 'log'
+  const logMessage = data ? `${message} ${JSON.stringify(data)}` : message
-  console[method](prefix, msg)
+
+  switch (level) {
+    case 'error':
+      console.error(logPrefix, logMessage)
+      break
+    case 'warn':
+      console.warn(logPrefix, logMessage)
+      break
+    case 'info':
+      console.log(logPrefix, logMessage)
+      break
+    case 'debug':
+      console.log(logPrefix, logMessage)
+      break
+    default:
+      console.log(logPrefix, logMessage)
+  }
+
   return { ok: true }
 })

server/api/pois.post.js

@@ -1,15 +1,18 @@
 import { getDb } from '../utils/db.js'
 import { requireAuth } from '../utils/authHelpers.js'
-import { POI_ICON_TYPES } from '../utils/poiConstants.js'
+
+const ICON_TYPES = ['pin', 'flag', 'waypoint']
 
 export default defineEventHandler(async (event) => {
   requireAuth(event, { role: 'adminOrLeader' })
   const body = await readBody(event)
   const lat = Number(body?.lat)
   const lng = Number(body?.lng)
-  if (!Number.isFinite(lat) || !Number.isFinite(lng)) throw createError({ statusCode: 400, message: 'lat and lng required as numbers' })
+  if (!Number.isFinite(lat) || !Number.isFinite(lng)) {
+    throw createError({ statusCode: 400, message: 'lat and lng required as numbers' })
+  }
   const label = typeof body?.label === 'string' ? body.label.trim() : ''
-  const iconType = POI_ICON_TYPES.includes(body?.iconType) ? body.iconType : 'pin'
+  const iconType = ICON_TYPES.includes(body?.iconType) ? body.iconType : 'pin'
   const id = crypto.randomUUID()
   const { run } = await getDb()
   await run(

server/api/pois/[id].patch.js

@@ -1,19 +1,20 @@
 import { getDb } from '../../utils/db.js'
 import { requireAuth } from '../../utils/authHelpers.js'
-import { POI_ICON_TYPES } from '../../utils/poiConstants.js'
+
+const ICON_TYPES = ['pin', 'flag', 'waypoint']
 
 export default defineEventHandler(async (event) => {
   requireAuth(event, { role: 'adminOrLeader' })
   const id = event.context.params?.id
   if (!id) throw createError({ statusCode: 400, message: 'id required' })
-  const body = (await readBody(event)) || {}
+  const body = await readBody(event) || {}
   const updates = []
   const params = []
   if (typeof body.label === 'string') {
     updates.push('label = ?')
     params.push(body.label.trim())
   }
-  if (POI_ICON_TYPES.includes(body.iconType)) {
+  if (ICON_TYPES.includes(body.iconType)) {
     updates.push('icon_type = ?')
     params.push(body.iconType)
   }

server/plugins/db.init.js

@@ -1,7 +1,14 @@
 import { getDb, closeDb } from '../utils/db.js'
+import { migrateFeedsToDevices } from '../utils/migrateFeedsToDevices.js'
+
+/**
+ * Initialize DB (and run bootstrap if no users) at server startup
+ * so credentials are printed in the terminal before any request.
+ * Close DB on server shutdown to avoid native sqlite3 crashes in worker teardown.
+ */
 
 export default defineNitroPlugin((nitroApp) => {
-  void getDb()
+  void getDb().then(() => migrateFeedsToDevices())
   nitroApp.hooks.hook('close', () => {
     closeDb()
   })

server/plugins/websocket.js

@@ -1,7 +1,17 @@
+/**
+ * WebSocket server for WebRTC signaling.
+ * Attaches to Nitro's HTTP server and handles WebSocket connections.
+ */
+
 import { WebSocketServer } from 'ws'
 import { getDb } from '../utils/db.js'
 import { handleWebSocketMessage } from '../utils/webrtcSignaling.js'
 
+/**
+ * Parse cookie header string into object.
+ * @param {string} cookieHeader
+ * @returns {Record<string, string>} Parsed cookie name-value pairs.
+ */
 function parseCookie(cookieHeader) {
   const cookies = {}
   if (!cookieHeader) return cookies
@@ -15,16 +25,30 @@ function parseCookie(cookieHeader) {
 }
 
 let wss = null
-const connections = new Map()
+const connections = new Map() // sessionId -> Set<WebSocket>
 
+/**
+ * Get WebSocket server instance.
+ * @returns {WebSocketServer | null} WebSocket server instance or null.
+ */
 export function getWebSocketServer() {
   return wss
 }
 
+/**
+ * Get connections for a session.
+ * @param {string} sessionId
+ * @returns {Set<WebSocket>} Set of WebSockets for the session.
+ */
 export function getSessionConnections(sessionId) {
   return connections.get(sessionId) || new Set()
 }
 
+/**
+ * Add connection to session.
+ * @param {string} sessionId
+ * @param {WebSocket} ws
+ */
 export function addSessionConnection(sessionId, ws) {
   if (!connections.has(sessionId)) {
     connections.set(sessionId, new Set())
@@ -32,6 +56,11 @@ export function addSessionConnection(sessionId, ws) {
   connections.get(sessionId).add(ws)
 }
 
+/**
+ * Remove connection from session.
+ * @param {string} sessionId
+ * @param {WebSocket} ws
+ */
 export function removeSessionConnection(sessionId, ws) {
   const conns = connections.get(sessionId)
   if (conns) {
@@ -42,6 +71,11 @@ export function removeSessionConnection(sessionId, ws) {
   }
 }
 
+/**
+ * Send message to all connections for a session.
+ * @param {string} sessionId
+ * @param {object} message
+ */
 export function broadcastToSession(sessionId, message) {
   const conns = getSessionConnections(sessionId)
   const data = JSON.stringify(message)

server/utils/authConfig.js

@@ -1,5 +1,17 @@
+/**
+ * Read auth config from env. Returns only non-secret data for client.
+ * Auth always allows local (password) sign-in and OIDC when configured.
+ * @returns {{ oidc: { enabled: boolean, label: string } }} Public auth config (oidc.enabled, oidc.label).
+ */
 export function getAuthConfig() {
-  const hasOidc = !!(process.env.OIDC_ISSUER && process.env.OIDC_CLIENT_ID && process.env.OIDC_CLIENT_SECRET)
+  const hasOidcEnv
-  const label = process.env.OIDC_LABEL?.trim() || (hasOidc ? 'Sign in with OIDC' : '')
+    = process.env.OIDC_ISSUER && process.env.OIDC_CLIENT_ID && process.env.OIDC_CLIENT_SECRET
-  return Object.freeze({ oidc: { enabled: hasOidc, label } })
+  const envLabel = process.env.OIDC_LABEL ?? ''
+  const label = envLabel || (hasOidcEnv ? 'Sign in with OIDC' : '')
+  return {
+    oidc: {
+      enabled: !!hasOidcEnv,
+      label,
+    },
+  }
 }

server/utils/authHelpers.js

@@ -1,10 +1,20 @@
-const ROLES_ADMIN_OR_LEADER = Object.freeze(['admin', 'leader'])
+/**
-
+ * Require authenticated user. Optionally require role. Throws 401 if none, 403 if role insufficient.
+ * @param {import('h3').H3Event} event
+ * @param {{ role?: 'admin' | 'adminOrLeader' }} [opts] - role: 'admin' = admin only; 'adminOrLeader' = admin or leader
+ * @returns {{ id: string, identifier: string, role: string }} The current user.
+ */
 export function requireAuth(event, opts = {}) {
   const user = event.context.user
-  if (!user) throw createError({ statusCode: 401, message: 'Unauthorized' })
+  if (!user) {
+    throw createError({ statusCode: 401, message: 'Unauthorized' })
+  }
   const { role } = opts
-  if (role === 'admin' && user.role !== 'admin') throw createError({ statusCode: 403, message: 'Forbidden' })
+  if (role === 'admin' && user.role !== 'admin') {
-  if (role === 'adminOrLeader' && !ROLES_ADMIN_OR_LEADER.includes(user.role)) throw createError({ statusCode: 403, message: 'Forbidden' })
+    throw createError({ statusCode: 403, message: 'Forbidden' })
+  }
+  if (role === 'adminOrLeader' && user.role !== 'admin' && user.role !== 'leader') {
+    throw createError({ statusCode: 403, message: 'Forbidden' })
+  }
   return user
 }

server/utils/authSkipPaths.js

@@ -1,21 +1,30 @@
-/** Paths that skip auth (no session required). Do not add if any handler uses requireAuth. */
+/**
-export const SKIP_PATHS = Object.freeze([
+ * Paths that skip auth middleware (no session required).
+ * Do not add a path here if any handler under it uses requireAuth (with or without role).
+ * When adding a new API route that requires auth, add its path prefix to PROTECTED_PATH_PREFIXES below
+ * so tests can assert it is never skipped.
+ */
+export const SKIP_PATHS = [
   '/api/auth/login',
   '/api/auth/logout',
   '/api/auth/config',
   '/api/auth/oidc/authorize',
   '/api/auth/oidc/callback',
-])
+]
 
-/** Path prefixes for protected routes. Used by tests to ensure they're never in SKIP_PATHS. */
+/**
-export const PROTECTED_PATH_PREFIXES = Object.freeze([
+ * Path prefixes for API routes that require an authenticated user (or role).
+ * Every path in this list must NOT be skipped (skipAuth must return false).
+ * Used by tests to prevent protected routes from being added to SKIP_PATHS.
+ */
+export const PROTECTED_PATH_PREFIXES = [
   '/api/cameras',
   '/api/devices',
   '/api/live',
   '/api/me',
   '/api/pois',
   '/api/users',
-])
+]
 
 export function skipAuth(path) {
   if (path.startsWith('/api/health') || path === '/health') return true

server/utils/bootstrap.js

@@ -1,26 +0,0 @@
-import { randomBytes } from 'node:crypto'
-import { hashPassword } from './password.js'
-
-const PASSWORD_CHARS = Object.freeze('abcdefghjkmnopqrstuvwxyzABCDEFGHJKMNPQRSTUVWXYZ23456789')
-
-const generateRandomPassword = () =>
-  Array.from(randomBytes(14), b => PASSWORD_CHARS[b % PASSWORD_CHARS.length]).join('')
-
-export async function bootstrapAdmin(run, get) {
-  const row = await get('SELECT COUNT(*) as n FROM users')
-  if (row?.n !== 0) return
-
-  const email = process.env.BOOTSTRAP_EMAIL?.trim()
-  const password = process.env.BOOTSTRAP_PASSWORD
-  const identifier = (email && password) ? email : 'admin'
-  const plainPassword = (email && password) ? password : generateRandomPassword()
-
-  await run(
-    'INSERT INTO users (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
-    [crypto.randomUUID(), identifier, hashPassword(plainPassword), 'admin', new Date().toISOString(), 'local', null, null],
-  )
-
-  if (!email || !password) {
-    console.log(`\n[KestrelOS] No bootstrap admin configured. Default admin created. Sign in at /login with:\n\n  Identifier: ${identifier}\n  Password:   ${plainPassword}\n\n  Set BOOTSTRAP_EMAIL and BOOTSTRAP_PASSWORD to use your own credentials on first run.\n`)
-  }
-}

server/utils/db.js

@@ -2,27 +2,38 @@ import { join } from 'node:path'
 import { mkdirSync, existsSync } from 'node:fs'
 import { createRequire } from 'node:module'
 import { promisify } from 'node:util'
-import { bootstrapAdmin } from './bootstrap.js'
+import { randomBytes } from 'node:crypto'
+import { hashPassword } from './password.js'
+
+const DEFAULT_ADMIN_IDENTIFIER = 'admin'
+const DEFAULT_PASSWORD_LENGTH = 14
+const PASSWORD_CHARS = 'abcdefghjkmnopqrstuvwxyzABCDEFGHJKMNPQRSTUVWXYZ23456789'
+
+function generateRandomPassword() {
+  const bytes = randomBytes(DEFAULT_PASSWORD_LENGTH)
+  let s = ''
+  for (let i = 0; i < DEFAULT_PASSWORD_LENGTH; i++) {
+    s += PASSWORD_CHARS[bytes[i] % PASSWORD_CHARS.length]
+  }
+  return s
+}
 
 const require = createRequire(import.meta.url)
 const sqlite3 = require('sqlite3')
 
-const SCHEMA_VERSION = 2
-const DB_BUSY_TIMEOUT_MS = 5000
-
 let dbInstance = null
+/** Set by tests to use :memory: or a temp path */
 let testPath = null
 
-const SCHEMA = {
+const USERS_SQL = `CREATE TABLE IF NOT EXISTS users (
-  schema_version: 'CREATE TABLE IF NOT EXISTS schema_version (version INTEGER PRIMARY KEY)',
-  users: `CREATE TABLE IF NOT EXISTS users (
   id TEXT PRIMARY KEY,
   identifier TEXT UNIQUE NOT NULL,
   password_hash TEXT NOT NULL,
   role TEXT NOT NULL DEFAULT 'member',
   created_at TEXT NOT NULL
-  )`,
+)`
-  users_v2: `CREATE TABLE users_new (
+
+const USERS_V2_SQL = `CREATE TABLE users_new (
   id TEXT PRIMARY KEY,
   identifier TEXT UNIQUE NOT NULL,
   password_hash TEXT,
@@ -31,23 +42,23 @@ const SCHEMA = {
   auth_provider TEXT NOT NULL DEFAULT 'local',
   oidc_issuer TEXT,
   oidc_sub TEXT
-  )`,
+)`
-  users_oidc_index: `CREATE UNIQUE INDEX IF NOT EXISTS users_oidc_unique ON users(oidc_issuer, oidc_sub) WHERE oidc_issuer IS NOT NULL AND oidc_sub IS NOT NULL`,
+const USERS_OIDC_UNIQUE = `CREATE UNIQUE INDEX IF NOT EXISTS users_oidc_unique ON users(oidc_issuer, oidc_sub) WHERE oidc_issuer IS NOT NULL AND oidc_sub IS NOT NULL`
-  sessions: `CREATE TABLE IF NOT EXISTS sessions (
+const SESSIONS_SQL = `CREATE TABLE IF NOT EXISTS sessions (
   id TEXT PRIMARY KEY,
   user_id TEXT NOT NULL,
   created_at TEXT NOT NULL,
   expires_at TEXT NOT NULL,
   FOREIGN KEY(user_id) REFERENCES users(id)
-  )`,
+)`
-  pois: `CREATE TABLE IF NOT EXISTS pois (
+const POIS_SQL = `CREATE TABLE IF NOT EXISTS pois (
   id TEXT PRIMARY KEY,
   lat REAL NOT NULL,
   lng REAL NOT NULL,
   label TEXT NOT NULL DEFAULT '',
   icon_type TEXT NOT NULL DEFAULT 'pin'
-  )`,
+)`
-  devices: `CREATE TABLE IF NOT EXISTS devices (
+const DEVICES_SQL = `CREATE TABLE IF NOT EXISTS devices (
   id TEXT PRIMARY KEY,
   name TEXT NOT NULL DEFAULT '',
   device_type TEXT NOT NULL,
@@ -57,117 +68,88 @@ const SCHEMA = {
   stream_url TEXT NOT NULL DEFAULT '',
   source_type TEXT NOT NULL DEFAULT 'mjpeg',
   config TEXT
-  )`,
+)`
-}
 
-const getDbPath = () => {
+function getDbPath() {
   if (testPath) return testPath
-  if (process.env.DB_PATH) return process.env.DB_PATH
   const dir = join(process.cwd(), 'data')
   if (!existsSync(dir)) mkdirSync(dir, { recursive: true })
   return join(dir, 'kestrelos.db')
 }
 
-const getSchemaVersion = async (get) => {
+async function bootstrap(db) {
-  try {
+  if (testPath) return
-    const row = await get('SELECT version FROM schema_version ORDER BY version DESC LIMIT 1')
+  const row = await db.get('SELECT COUNT(*) as n FROM users')
-    return row?.version || 0
+  if (row?.n !== 0) return
-  }
+  const email = process.env.BOOTSTRAP_EMAIL?.trim()
-  catch {
+  const password = process.env.BOOTSTRAP_PASSWORD
-    return 0
+  const identifier = (email && password) ? email : DEFAULT_ADMIN_IDENTIFIER
+  const plainPassword = (email && password) ? password : generateRandomPassword()
+  const id = crypto.randomUUID()
+  const now = new Date().toISOString()
+  await db.run(
+    'INSERT INTO users (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
+    [id, identifier, hashPassword(plainPassword), 'admin', now, 'local', null, null],
+  )
+  if (!email || !password) {
+    console.log('\n[KestrelOS] No bootstrap admin configured. Default admin created. Sign in at /login with:\n')
+
+    console.log(`  Identifier: ${identifier}\n  Password:   ${plainPassword}\n`)
+
+    console.log('  Set BOOTSTRAP_EMAIL and BOOTSTRAP_PASSWORD to use your own credentials on first run.\n')
   }
 }
 
-const setSchemaVersion = (run, version) => run('INSERT OR REPLACE INTO schema_version (version) VALUES (?)', [version])
+async function migrateUsersIfNeeded(run, all) {
-
-const migrateToV2 = async (run, all) => {
   const info = await all('PRAGMA table_info(users)')
   if (info.some(c => c.name === 'auth_provider')) return
-
+  await run(USERS_V2_SQL)
-  await run('BEGIN TRANSACTION')
+  await run(
-  try {
+    `INSERT INTO users_new (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub)
-    await run(SCHEMA.users_v2)
+     SELECT id, identifier, password_hash, role, created_at, 'local', NULL, NULL FROM users`,
-    await run('INSERT INTO users_new (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) SELECT id, identifier, password_hash, role, created_at, ?, ?, ? FROM users', ['local', null, null])
+  )
   await run('DROP TABLE users')
   await run('ALTER TABLE users_new RENAME TO users')
-    await run(SCHEMA.users_oidc_index)
+  await run(USERS_OIDC_UNIQUE)
-    await run('COMMIT')
-  }
-  catch (error) {
-    await run('ROLLBACK').catch(() => {})
-    throw error
-  }
-}
-
-const runMigrations = async (run, all, get) => {
-  const version = await getSchemaVersion(get)
-  if (version >= SCHEMA_VERSION) return
-  if (version < 2) {
-    await migrateToV2(run, all)
-    await setSchemaVersion(run, 2)
-  }
-}
-
-const initDb = async (db, run, all, get) => {
-  try {
-    await run('PRAGMA journal_mode = WAL')
-  }
-  catch {
-    // WAL not supported (e.g., network filesystem)
-  }
-  db.configure('busyTimeout', DB_BUSY_TIMEOUT_MS)
-
-  await run(SCHEMA.schema_version)
-  await run(SCHEMA.users)
-  await runMigrations(run, all, get)
-  await run(SCHEMA.sessions)
-  await run(SCHEMA.pois)
-  await run(SCHEMA.devices)
-
-  if (!testPath) await bootstrapAdmin(run, get)
 }
 
 export async function getDb() {
   if (dbInstance) return dbInstance
-
+  const path = getDbPath()
-  const db = new sqlite3.Database(getDbPath(), (err) => {
+  const db = new sqlite3.Database(path)
-    if (err) {
-      console.error('[db] Failed to open database:', err.message)
-      throw err
-    }
-  })
-
   const run = promisify(db.run.bind(db))
   const all = promisify(db.all.bind(db))
   const get = promisify(db.get.bind(db))
-
+  await run(USERS_SQL)
-  try {
+  await migrateUsersIfNeeded(run, all)
-    await initDb(db, run, all, get)
+  await run(SESSIONS_SQL)
-  }
+  await run(POIS_SQL)
-  catch (error) {
+  await run(DEVICES_SQL)
-    db.close()
+  await bootstrap({ run, get })
-    console.error('[db] Database initialization failed:', error.message)
-    throw error
-  }
-
   dbInstance = { db, run, all, get }
   return dbInstance
 }
 
+/**
+ * Close the DB connection. Call on server shutdown to avoid native sqlite3 crashes in worker teardown.
+ */
 export function closeDb() {
-  if (!dbInstance) return
+  if (dbInstance) {
     try {
-    dbInstance.db.close((err) => {
+      dbInstance.db.close()
-      if (err) console.error('[db] Error closing database:', err.message)
-    })
     }
-  catch (error) {
+    catch {
-    console.error('[db] Error closing database:', error.message)
+      // ignore if already closed
     }
     dbInstance = null
+  }
 }
 
+/**
+ * For tests: use in-memory DB and reset singleton.
+ * @param {string} path - e.g. ':memory:'
+ */
 export function setDbPathForTest(path) {
-  testPath = path || null
+  testPath = path
   closeDb()
 }

server/utils/deviceUtils.js

@@ -1,12 +1,8 @@
+import { sanitizeStreamUrl } from './feedUtils.js'
+
 const DEVICE_TYPES = Object.freeze(['alpr', 'nvr', 'doorbell', 'feed', 'traffic', 'ip', 'drone'])
 const SOURCE_TYPES = Object.freeze(['mjpeg', 'hls'])
 
-const sanitizeStreamUrl = (url) => {
-  if (typeof url !== 'string' || !url.trim()) return ''
-  const u = url.trim()
-  return (u.startsWith('https://') || u.startsWith('http://')) ? u : ''
-}
-
 /** @typedef {{ id: string, name: string, device_type: string, vendor: string | null, lat: number, lng: number, stream_url: string, source_type: string, config: string | null }} DeviceRow */
 
 /**

server/utils/feedUtils.js

@@ -0,0 +1,54 @@
+/**
+ * Validates a single feed object shape (pure function).
+ * @param {unknown} item
+ * @returns {boolean} True if item has id, name, lat, lng with correct types.
+ */
+export function isValidFeed(item) {
+  if (!item || typeof item !== 'object') return false
+  const o = /** @type {Record<string, unknown>} */ (item)
+  return (
+    typeof o.id === 'string'
+    && typeof o.name === 'string'
+    && typeof o.lat === 'number'
+    && typeof o.lng === 'number'
+  )
+}
+
+/**
+ * Returns a safe stream URL (http/https only) or empty string. Prevents javascript:, data:, etc.
+ * @param {unknown} url
+ * @returns {string} Safe http(s) URL or empty string.
+ */
+export function sanitizeStreamUrl(url) {
+  if (typeof url !== 'string' || !url.trim()) return ''
+  const u = url.trim()
+  if (u.startsWith('https://') || u.startsWith('http://')) return u
+  return ''
+}
+
+/**
+ * Sanitizes a validated feed for API response: safe streamUrl and sourceType only.
+ * @param {{ id: string, name: string, lat: number, lng: number, [key: string]: unknown }} feed
+ * @returns {{ id: string, name: string, lat: number, lng: number, streamUrl: string, sourceType: string, description?: string }} Sanitized feed for API.
+ */
+export function sanitizeFeedForResponse(feed) {
+  return {
+    id: feed.id,
+    name: feed.name,
+    lat: feed.lat,
+    lng: feed.lng,
+    streamUrl: sanitizeStreamUrl(feed.streamUrl),
+    sourceType: feed.sourceType === 'hls' ? 'hls' : 'mjpeg',
+    ...(typeof feed.description === 'string' ? { description: feed.description } : {}),
+  }
+}
+
+/**
+ * Filters and returns only valid feeds from an array (pure function).
+ * @param {unknown[]} list
+ * @returns {Array<{ id: string, name: string, lat: number, lng: number }>} Array of valid feed objects.
+ */
+export function getValidFeeds(list) {
+  if (!Array.isArray(list)) return []
+  return list.filter(isValidFeed)
+}

server/utils/liveSessions.js

@@ -1,17 +1,43 @@
+/**
+ * In-memory store for live sharing sessions (camera + location).
+ * Sessions expire after TTL_MS without an update.
+ */
+
 import { closeRouter, getProducer, getTransport } from './mediasoup.js'
 
-const TTL_MS = 60_000
+const TTL_MS = 60_000 // 60 seconds without update = inactive
+
 const sessions = new Map()
 
-export const createSession = (userId, label = '') => {
+/**
+ * @typedef {{
+ *   id: string
+ *   userId: string
+ *   label: string
+ *   lat: number
+ *   lng: number
+ *   updatedAt: number
+ *   routerId: string | null
+ *   producerId: string | null
+ *   transportId: string | null
+ * }} LiveSession
+ */
+
+/**
+ * @param {string} userId
+ * @param {string} [label]
+ * @returns {LiveSession} The created live session.
+ */
+export function createSession(userId, label = '') {
   const id = crypto.randomUUID()
+  const now = Date.now()
   const session = {
     id,
     userId,
     label: (label || 'Live').trim() || 'Live',
     lat: 0,
     lng: 0,
-    updatedAt: Date.now(),
+    updatedAt: now,
     routerId: null,
     producerId: null,
     transportId: null,
@@ -20,16 +46,34 @@ export const createSession = (userId, label = '') => {
   return session
 }
 
-export const getLiveSession = id => sessions.get(id)
+/**
-
+ * @param {string} id
-export const getActiveSessionByUserId = (userId) => {
+ * @returns {LiveSession | undefined} The session or undefined.
-  const now = Date.now()
+ */
-  for (const s of sessions.values()) {
+export function getLiveSession(id) {
-    if (s.userId === userId && now - s.updatedAt <= TTL_MS) return s
+  return sessions.get(id)
-  }
 }
 
-export const updateLiveSession = (id, updates) => {
+/**
+ * Get an existing active session for a user (for replacing with a new one).
+ * @param {string} userId
+ * @returns {LiveSession | undefined} The first active session for the user, or undefined.
+ */
+export function getActiveSessionByUserId(userId) {
+  const now = Date.now()
+  for (const [, s] of sessions) {
+    if (s.userId === userId && now - s.updatedAt <= TTL_MS) {
+      return s
+    }
+  }
+  return undefined
+}
+
+/**
+ * @param {string} id
+ * @param {{ lat?: number, lng?: number, routerId?: string | null, producerId?: string | null, transportId?: string | null }} updates
+ */
+export function updateLiveSession(id, updates) {
   const session = sessions.get(id)
   if (!session) return
   const now = Date.now()
@@ -41,52 +85,74 @@ export const updateLiveSession = (id, updates) => {
   session.updatedAt = now
 }
 
-export const deleteLiveSession = id => sessions.delete(id)
+/**
-
+ * @param {string} id
-export const clearSessions = () => sessions.clear()
+ */
-
+export function deleteLiveSession(id) {
-const cleanupSession = async (session) => {
+  sessions.delete(id)
-  if (session.producerId) {
-    const producer = getProducer(session.producerId)
-    producer?.close()
-  }
-  if (session.transportId) {
-    const transport = getTransport(session.transportId)
-    transport?.close()
-  }
-  if (session.routerId) {
-    await closeRouter(session.id).catch((err) => {
-      console.error(`[liveSessions] Error closing router for expired session ${session.id}:`, err)
-    })
-  }
 }
 
-export const getActiveSessions = async () => {
+/**
-  const now = Date.now()
+ * Clear all sessions (for tests only).
-  const active = []
+ */
-  const expired = []
+export function clearSessions() {
+  sessions.clear()
+}
 
-  for (const session of sessions.values()) {
+/**
-    if (now - session.updatedAt <= TTL_MS) {
+ * Returns sessions updated within TTL_MS (active only).
-      active.push({
+ * Also cleans up expired sessions.
-        id: session.id,
+ * @returns {Promise<Array<{ id: string, userId: string, label: string, lat: number, lng: number, updatedAt: number, hasStream: boolean }>>} Active sessions with hasStream flag.
-        userId: session.userId,
+ */
-        label: session.label,
+export async function getActiveSessions() {
-        lat: session.lat,
+  const now = Date.now()
-        lng: session.lng,
+  const result = []
-        updatedAt: session.updatedAt,
+  const expiredIds = []
-        hasStream: Boolean(session.producerId),
+  for (const [id, s] of sessions) {
+    if (now - s.updatedAt <= TTL_MS) {
+      result.push({
+        id: s.id,
+        userId: s.userId,
+        label: s.label,
+        lat: s.lat,
+        lng: s.lng,
+        updatedAt: s.updatedAt,
+        hasStream: Boolean(s.producerId),
       })
     }
     else {
-      expired.push(session)
+      expiredIds.push(id)
+    }
+  }
+  // Clean up expired sessions and their WebRTC resources
+  for (const id of expiredIds) {
+    const session = sessions.get(id)
+    if (session) {
+      // Clean up producer if it exists
+      if (session.producerId) {
+        const producer = getProducer(session.producerId)
+        if (producer) {
+          producer.close()
         }
       }
 
-  for (const session of expired) {
+      // Clean up transport if it exists
-    await cleanupSession(session)
+      if (session.transportId) {
-    sessions.delete(session.id)
+        const transport = getTransport(session.transportId)
+        if (transport) {
+          transport.close()
+        }
       }
 
-  return active
+      // Clean up router
+      if (session.routerId) {
+        await closeRouter(id).catch((err) => {
+          console.error(`[liveSessions] Error closing router for expired session ${id}:`, err)
+        })
+      }
+
+      sessions.delete(id)
+    }
+  }
+  return result
 }

server/utils/mediasoup.js

@@ -1,18 +1,21 @@
+/**
+ * Mediasoup SFU (Selective Forwarding Unit) setup and management.
+ * Handles WebRTC router, transport, producer, and consumer creation.
+ */
+
 import os from 'node:os'
 import mediasoup from 'mediasoup'
 
 let worker = null
-const routers = new Map()
+const routers = new Map() // sessionId -> Router
-const transports = new Map()
+const transports = new Map() // transportId -> WebRtcTransport
-export const producers = new Map()
+export const producers = new Map() // producerId -> Producer
 
-const MEDIA_CODECS = [
+/**
-  { kind: 'video', mimeType: 'video/H264', clockRate: 90000, parameters: { 'packetization-mode': 1, 'profile-level-id': '42e01f' } },
+ * Initialize Mediasoup worker (singleton).
-  { kind: 'video', mimeType: 'video/VP8', clockRate: 90000 },
+ * @returns {Promise<mediasoup.types.Worker>} The Mediasoup worker.
-  { kind: 'video', mimeType: 'video/VP9', clockRate: 90000 },
+ */
-]
+export async function getWorker() {
-
-export const getWorker = async () => {
   if (worker) return worker
   worker = await mediasoup.createWorker({
     logLevel: process.env.NODE_ENV === 'development' ? 'debug' : 'warn',
@@ -27,15 +30,50 @@ export const getWorker = async () => {
   return worker
 }
 
-export const getRouter = async (sessionId) => {
+/**
-  const existing = routers.get(sessionId)
+ * Create or get a router for a live session.
-  if (existing) return existing
+ * @param {string} sessionId
-  const router = await (await getWorker()).createRouter({ mediaCodecs: MEDIA_CODECS })
+ * @returns {Promise<mediasoup.types.Router>} Router for the session.
+ */
+export async function getRouter(sessionId) {
+  if (routers.has(sessionId)) {
+    return routers.get(sessionId)
+  }
+  const w = await getWorker()
+  const router = await w.createRouter({
+    mediaCodecs: [
+      {
+        kind: 'video',
+        mimeType: 'video/H264',
+        clockRate: 90000,
+        parameters: {
+          'packetization-mode': 1,
+          'profile-level-id': '42e01f',
+        },
+      },
+      {
+        kind: 'video',
+        mimeType: 'video/VP8',
+        clockRate: 90000,
+      },
+      {
+        kind: 'video',
+        mimeType: 'video/VP9',
+        clockRate: 90000,
+      },
+    ],
+  })
   routers.set(sessionId, router)
   return router
 }
 
-const isIPv4 = (host) => {
+/**
+ * True if the string is a valid IPv4 address (numeric a.b.c.d, each octet 0-255).
+ * Used to accept request Host as announced IP only when it's safe (no hostnames/DNS rebinding).
+ * @param {string} host
+ * @returns {boolean} True if host is a valid IPv4 address.
+ */
+function isIPv4(host) {
   if (typeof host !== 'string' || !host) return false
   const parts = host.split('.')
   if (parts.length !== 4) return false
@@ -46,24 +84,45 @@ const isIPv4 = (host) => {
   return true
 }
 
-const getAnnouncedIpFromInterfaces = () => {
+/**
-  for (const addrs of Object.values(os.networkInterfaces())) {
+ * First non-internal IPv4 from network interfaces (no env read).
+ * @returns {string | null} First non-internal IPv4 address or null.
+ */
+function getAnnouncedIpFromInterfaces() {
+  const ifaces = os.networkInterfaces()
+  for (const addrs of Object.values(ifaces)) {
     if (!addrs) continue
     for (const addr of addrs) {
-      if (addr.family === 'IPv4' && !addr.internal) return addr.address
+      if (addr.family === 'IPv4' && !addr.internal) {
+        return addr.address
+      }
     }
   }
   return null
 }
 
-const resolveAnnouncedIp = (requestHost) => {
+/**
+ * Resolve announced IP: env override, then request host if IPv4, then auto-detect. Pure and deterministic.
+ * @param {string | undefined} requestHost - Host header from the client.
+ * @returns {string | null} The IP to announce in ICE, or null for localhost-only.
+ */
+function resolveAnnouncedIp(requestHost) {
   const envIp = process.env.MEDIASOUP_ANNOUNCED_IP?.trim()
   if (envIp) return envIp
   if (requestHost && isIPv4(requestHost)) return requestHost
   return getAnnouncedIpFromInterfaces()
 }
 
-export const createTransport = async (router, requestHost = undefined) => {
+/**
+ * Create a WebRTC transport for a router.
+ * @param {mediasoup.types.Router} router
+ * @param {boolean} _isProducer - true for publisher, false for consumer (reserved for future use)
+ * @param {string} [requestHost] - Hostname from the request (e.g. getRequestURL(event).hostname). If a valid IPv4, used as announced IP so the client can reach the server.
+ * @returns {Promise<{ transport: mediasoup.types.WebRtcTransport, params: object }>} Transport and connection params.
+ */
+// eslint-disable-next-line no-unused-vars
+export async function createTransport(router, _isProducer = false, requestHost = undefined) {
+  // LAN first so the phone (and remote viewers) try the reachable IP before 127.0.0.1 (loopback on the client).
   const announcedIp = resolveAnnouncedIp(requestHost)
   const listenIps = announcedIp
     ? [{ ip: '0.0.0.0', announcedIp }, { ip: '127.0.0.1' }]
@@ -79,10 +138,10 @@ export const createTransport = async (router, requestHost = undefined) => {
     console.error('[mediasoup] Transport creation failed:', err)
     throw new Error(`Failed to create transport: ${err.message || String(err)}`)
   })
-
   transports.set(transport.id, transport)
-  transport.on('close', () => transports.delete(transport.id))
+  transport.on('close', () => {
-
+    transports.delete(transport.id)
+  })
   return {
     transport,
     params: {
@@ -94,22 +153,61 @@ export const createTransport = async (router, requestHost = undefined) => {
   }
 }
 
-export const getTransport = transportId => transports.get(transportId)
+/**
+ * Get transport by ID.
+ * @param {string} transportId
+ * @returns {mediasoup.types.WebRtcTransport | undefined} Transport or undefined.
+ */
+export function getTransport(transportId) {
+  return transports.get(transportId)
+}
 
-export const createProducer = async (transport, track) => {
+/**
+ * Create a producer (publisher's video track).
+ * @param {mediasoup.types.WebRtcTransport} transport
+ * @param {MediaStreamTrack} track
+ * @returns {Promise<mediasoup.types.Producer>} The producer.
+ */
+export async function createProducer(transport, track) {
   const producer = await transport.produce({ track })
   producers.set(producer.id, producer)
-  producer.on('close', () => producers.delete(producer.id))
+  producer.on('close', () => {
+    producers.delete(producer.id)
+  })
   return producer
 }
 
-export const getProducer = producerId => producers.get(producerId)
+/**
+ * Get producer by ID.
+ * @param {string} producerId
+ * @returns {mediasoup.types.Producer | undefined} Producer or undefined.
+ */
+export function getProducer(producerId) {
+  return producers.get(producerId)
+}
 
-export const getTransports = () => transports
+/**
+ * Get transports Map (for cleanup).
+ * @returns {Map<string, mediasoup.types.WebRtcTransport>} Map of transport ID to transport.
+ */
+export function getTransports() {
+  return transports
+}
 
-export const createConsumer = async (transport, producer, rtpCapabilities) => {
+/**
-  if (producer.closed) throw new Error('Producer is closed')
+ * Create a consumer (viewer subscribes to producer's stream).
-  if (producer.paused) await producer.resume()
+ * @param {mediasoup.types.WebRtcTransport} transport
+ * @param {mediasoup.types.Producer} producer
+ * @param {boolean} rtpCapabilities
+ * @returns {Promise<{ consumer: mediasoup.types.Consumer, params: object }>} Consumer and connection params.
+ */
+export async function createConsumer(transport, producer, rtpCapabilities) {
+  if (producer.closed) {
+    throw new Error('Producer is closed')
+  }
+  if (producer.paused) {
+    await producer.resume()
+  }
 
   const consumer = await transport.consume({
     producerId: producer.id,
@@ -131,7 +229,11 @@ export const createConsumer = async (transport, producer, rtpCapabilities) => {
   }
 }
 
-export const closeRouter = async (sessionId) => {
+/**
+ * Clean up router for a session.
+ * @param {string} sessionId
+ */
+export async function closeRouter(sessionId) {
   const router = routers.get(sessionId)
   if (router) {
     router.close()
@@ -139,4 +241,10 @@ export const closeRouter = async (sessionId) => {
   }
 }
 
-export const getActiveRouters = () => Array.from(routers.keys())
+/**
+ * Get all active routers (for debugging/monitoring).
+ * @returns {Array<string>} Session IDs with active routers
+ */
+export function getActiveRouters() {
+  return Array.from(routers.keys())
+}

server/utils/migrateFeedsToDevices.js

@@ -0,0 +1,27 @@
+import { join } from 'node:path'
+import { readFileSync, existsSync } from 'node:fs'
+import { getDb } from './db.js'
+import { sanitizeStreamUrl } from './feedUtils.js'
+
+/**
+ * One-time migration: insert entries from server/data/feeds.json into devices (device_type = 'feed').
+ * No-op if devices table already has rows or feeds file is missing.
+ */
+export async function migrateFeedsToDevices() {
+  const db = await getDb()
+  const row = await db.get('SELECT COUNT(*) as n FROM devices')
+  if (row?.n > 0) return
+  const path = join(process.cwd(), 'server/data/feeds.json')
+  if (!existsSync(path)) return
+  const data = JSON.parse(readFileSync(path, 'utf8'))
+  const list = Array.isArray(data) ? data : []
+  for (const feed of list) {
+    if (!feed?.id || typeof feed.name !== 'string' || typeof feed.lat !== 'number' || typeof feed.lng !== 'number') continue
+    const streamUrl = sanitizeStreamUrl(feed.streamUrl) ?? ''
+    const sourceType = feed.sourceType === 'hls' ? 'hls' : 'mjpeg'
+    await db.run(
+      'INSERT OR IGNORE INTO devices (id, name, device_type, vendor, lat, lng, stream_url, source_type, config) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
+      [feed.id, feed.name, 'feed', null, feed.lat, feed.lng, streamUrl, sourceType, null],
+    )
+  }
+}

server/utils/poiConstants.js

@@ -1 +0,0 @@
-export const POI_ICON_TYPES = Object.freeze(['pin', 'flag', 'waypoint'])

server/utils/session.js

@@ -1,6 +1,15 @@
-const [MIN_DAYS, MAX_DAYS, DEFAULT_DAYS] = [1, 365, 7]
+const DEFAULT_DAYS = 7
+const MIN_DAYS = 1
+const MAX_DAYS = 365
 
+/**
+ * Session lifetime in days (for cookie and DB expires_at). Uses SESSION_MAX_AGE_DAYS.
+ * Clamped to 1–365 days.
+ */
 export function getSessionMaxAgeDays() {
-  const raw = Number.parseInt(process.env.SESSION_MAX_AGE_DAYS ?? '', 10)
+  const raw = process.env.SESSION_MAX_AGE_DAYS != null
-  return Number.isFinite(raw) ? Math.max(MIN_DAYS, Math.min(MAX_DAYS, raw)) : DEFAULT_DAYS
+    ? Number.parseInt(process.env.SESSION_MAX_AGE_DAYS, 10)
+    : Number.NaN
+  if (Number.isFinite(raw)) return Math.max(MIN_DAYS, Math.min(MAX_DAYS, raw))
+  return DEFAULT_DAYS
 }

server/utils/webrtcSignaling.js

@@ -1,6 +1,19 @@
+/**
+ * WebRTC signaling message handlers.
+ * Processes WebSocket messages for WebRTC operations.
+ */
+
 import { getLiveSession, updateLiveSession } from './liveSessions.js'
 import { getRouter, createTransport, getTransport } from './mediasoup.js'
 
+/**
+ * Handle WebSocket message for WebRTC signaling.
+ * @param {string} userId
+ * @param {string} sessionId
+ * @param {string} type
+ * @param {object} data
+ * @returns {Promise<object | null>} Response message or null
+ */
 export async function handleWebSocketMessage(userId, sessionId, type, data) {
   const session = getLiveSession(sessionId)
   if (!session) {
@@ -19,7 +32,7 @@ export async function handleWebSocketMessage(userId, sessionId, type, data) {
       }
       case 'create-transport': {
         const router = await getRouter(sessionId)
-        const { transport, params } = await createTransport(router)
+        const { transport, params } = await createTransport(router, true)
         updateLiveSession(sessionId, { transportId: transport.id, routerId: router.id })
         return { type: 'transport-created', data: params }
       }

tailwind.config.js

@@ -16,11 +16,9 @@ export default {
         kestrel: {
           'bg': '#060b14',
           'surface': '#0d1424',
-          'surface-elevated': '#1e293b',
           'surface-hover': '#111a2e',
           'border': '#1a2744',
           'text': '#b8c9e0',
-          'text-bright': '#e2e8f0',
           'muted': '#5c6f8a',
           'accent': '#22c9c9',
           'accent-dim': '#0f3d3d',
@@ -32,30 +30,12 @@ export default {
         'glow': '0 0 20px -4px rgba(34, 201, 201, 0.3)',
         'glow-md': '0 0 24px -2px rgba(34, 201, 201, 0.25)',
         'glow-border': 'inset 0 0 20px -8px rgba(34, 201, 201, 0.15)',
-        'glow-header': '0 0 20px -4px rgba(34, 201, 201, 0.15)',
-        'glow-dropdown': '0 4px 12px -2px rgba(34, 201, 201, 0.15)',
-        'glow-panel': '-8px 0 24px -4px rgba(34, 201, 201, 0.12)',
-        'glow-modal': '0 0 32px -8px rgba(34, 201, 201, 0.25)',
-        'glow-card': '0 0 20px -4px rgba(34, 201, 201, 0.15)',
-        'glow-context': '0 0 20px -4px rgba(34, 201, 201, 0.2)',
-        'glow-inset-video': 'inset 0 0 20px -8px rgba(34, 201, 201, 0.1)',
-        'border-header': '0 1px 0 0 rgba(34, 201, 201, 0.08)',
-        'elevated': '0 4px 12px rgba(0, 0, 0, 0.4)',
       },
       textShadow: {
         'glow': '0 0 12px rgba(34, 201, 201, 0.4)',
-        'glow-sm': '0 0 8px rgba(34, 201, 201, 0.25)',
+        'glow-sm': '0 0 8px rgba(34, 201, 201, 0.3)',
-        'glow-md': '0 0 12px rgba(34, 201, 201, 0.35)',
       },
     },
   },
-  plugins: [
+  plugins: [],
-    function ({ addUtilities, theme }) {
-      addUtilities({
-        '.text-shadow-glow-sm': { textShadow: theme('textShadow.glow-sm') },
-        '.text-shadow-glow': { textShadow: theme('textShadow.glow') },
-        '.text-shadow-glow-md': { textShadow: theme('textShadow.glow-md') },
-      })
-    },
-  ],
 }

test/e2e/global-setup.js

@@ -1,58 +1,66 @@
+/**
+ * Global setup for E2E tests.
+ * Runs once before all tests.
+ */
+
 import { existsSync, mkdirSync } from 'node:fs'
 import { join, dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { execSync } from 'node:child_process'
 
-const projectRoot = join(dirname(fileURLToPath(import.meta.url)), '../../..')
+const _dirname = dirname(fileURLToPath(import.meta.url))
+const projectRoot = join(_dirname, '../../..')
 const devCertsDir = join(projectRoot, '.dev-certs')
 const devKey = join(devCertsDir, 'key.pem')
 const devCert = join(devCertsDir, 'cert.pem')
 
+// Import server modules (ES modules)
 const { getDb } = await import('../../server/utils/db.js')
 const { hashPassword } = await import('../../server/utils/password.js')
 const { TEST_ADMIN } = await import('./fixtures/users.js')
 
-const ensureDevCerts = () => {
+function ensureDevCerts() {
-  if (existsSync(devKey) && existsSync(devCert)) return
+  if (existsSync(devKey) && existsSync(devCert)) {
+    return // Certs already exist
+  }
 
+  // Create .dev-certs directory
   mkdirSync(devCertsDir, { recursive: true })
+
+  // Generate self-signed cert for localhost/127.0.0.1
+  const SAN = 'subjectAltName=IP:127.0.0.1,DNS:localhost'
   try {
     execSync(
-      `openssl req -x509 -newkey rsa:2048 -keyout "${devKey}" -out "${devCert}" -days 365 -nodes -subj "/CN=localhost" -addext "subjectAltName=IP:127.0.0.1,DNS:localhost"`,
+      `openssl req -x509 -newkey rsa:2048 -keyout "${devKey}" -out "${devCert}" -days 365 -nodes -subj "/CN=localhost" -addext "${SAN}"`,
-      { cwd: projectRoot, stdio: process.env.CI ? 'pipe' : 'inherit' },
+      { cwd: projectRoot, stdio: 'inherit' },
     )
+    console.log('[test] Generated .dev-certs/key.pem and .dev-certs/cert.pem')
   }
   catch (error) {
     throw new Error(`Failed to generate dev certificates: ${error.message}`)
   }
 }
 
-export default async function globalSetup() {
+async function globalSetup() {
+  // Ensure dev certificates exist
   ensureDevCerts()
 
-  let retries = 3
+  // Create test admin user if it doesn't exist
-  while (retries > 0) {
-    try {
   const { get, run } = await getDb()
-      const existing = await get('SELECT id FROM users WHERE identifier = ?', [TEST_ADMIN.identifier])
+  const existingUser = await get('SELECT id FROM users WHERE identifier = ?', [TEST_ADMIN.identifier])
 
-      if (!existing) {
+  if (!existingUser) {
+    const id = crypto.randomUUID()
+    const now = new Date().toISOString()
     await run(
       'INSERT INTO users (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
-          [crypto.randomUUID(), TEST_ADMIN.identifier, hashPassword(TEST_ADMIN.password), TEST_ADMIN.role, new Date().toISOString(), 'local', null, null],
+      [id, TEST_ADMIN.identifier, hashPassword(TEST_ADMIN.password), TEST_ADMIN.role, now, 'local', null, null],
     )
+    console.log(`[test] Created test admin user: ${TEST_ADMIN.identifier}`)
   }
-      return
+  else {
-    }
+    console.log(`[test] Test admin user already exists: ${TEST_ADMIN.identifier}`)
-    catch (error) {
-      if (error.message?.includes('SQLITE_BUSY') || error.message?.includes('database is locked')) {
-        retries--
-        if (retries > 0) {
-          await new Promise(resolve => setTimeout(resolve, 100 * (4 - retries)))
-          continue
-        }
-      }
-      throw error
-    }
   }
 }
+
+export default globalSetup

test/e2e/live-streaming.spec.js

@@ -28,10 +28,8 @@ test.describe('Live Streaming E2E', () => {
 
   test('publisher only: start sharing and reach Live', async ({ browser, browserName }) => {
     test.skip(browserName !== 'chromium', 'Fake camera only supported in Chromium')
-    // Skip in CI - WebRTC tests are flaky with fake media devices in CI environments
-    test.skip(!!process.env.CI, 'WebRTC tests skipped in CI due to flaky fake media device support')
     const ctx = await browser.newContext({
-      permissions: ['camera', 'microphone', 'geolocation'],
+      permissions: ['geolocation'],
       geolocation: { latitude: 37.7749, longitude: -122.4194 },
     })
     const page = await ctx.newPage()
@@ -57,11 +55,9 @@ test.describe('Live Streaming E2E', () => {
 
   test('Mobile Safari publishes, Desktop Chrome views', async ({ browser, browserName }) => {
     test.skip(browserName !== 'chromium', 'Fake camera only supported in Chromium')
-    // Skip in CI - WebRTC tests are flaky with fake media devices in CI environments
-    test.skip(!!process.env.CI, 'WebRTC tests skipped in CI due to flaky fake media device support')
     // Publisher context (same as publisher-only test for reliability)
     const publisherContext = await browser.newContext({
-      permissions: ['camera', 'microphone', 'geolocation'],
+      permissions: ['geolocation'],
       geolocation: { latitude: 37.7749, longitude: -122.4194 },
     })
     const publisherPage = await publisherContext.newPage()
@@ -127,10 +123,8 @@ test.describe('Live Streaming E2E', () => {
 
   test('Mobile Safari publishes, Desktop Firefox views', async ({ browser, browserName }) => {
     test.skip(browserName !== 'chromium', 'Fake camera only supported in Chromium')
-    // Skip in CI - WebRTC tests are flaky with fake media devices in CI environments
-    test.skip(!!process.env.CI, 'WebRTC tests skipped in CI due to flaky fake media device support')
     const publisherContext = await browser.newContext({
-      permissions: ['camera', 'microphone', 'geolocation'],
+      permissions: ['geolocation'],
       geolocation: { latitude: 37.7749, longitude: -122.4194 },
     })
     const publisherPage = await publisherContext.newPage()

test/nuxt/KestrelMap.spec.js

@@ -10,24 +10,24 @@ vi.mock('leaflet.offline', () => ({ tileLayerOffline: null, savetiles: null }))
 describe('KestrelMap', () => {
   it('renders map container', async () => {
     const wrapper = await mountSuspended(KestrelMap, {
-      props: { devices: [] },
+      props: { feeds: [] },
     })
     expect(wrapper.find('[data-testid="kestrel-map"]').exists()).toBe(true)
   })
 
-  it('accepts devices prop', async () => {
+  it('accepts feeds prop', async () => {
-    const devices = [
+    const feeds = [
       { id: '1', name: 'A', lat: 37.7, lng: -122.4, streamUrl: '', sourceType: 'mjpeg' },
     ]
     const wrapper = await mountSuspended(KestrelMap, {
-      props: { devices },
+      props: { feeds },
     })
-    expect(wrapper.props('devices')).toEqual(devices)
+    expect(wrapper.props('feeds')).toEqual(feeds)
   })
 
   it('has select emit', async () => {
     const wrapper = await mountSuspended(KestrelMap, {
-      props: { devices: [] },
+      props: { feeds: [] },
     })
     wrapper.vm.$emit('select', { id: 'x', name: 'X', lat: 0, lng: 0 })
     expect(wrapper.emitted('select')).toHaveLength(1)
@@ -67,7 +67,7 @@ describe('KestrelMap', () => {
   it('accepts pois and canEditPois props', async () => {
     const wrapper = await mountSuspended(KestrelMap, {
       props: {
-        devices: [],
+        feeds: [],
         pois: [{ id: 'p1', lat: 37.7, lng: -122.4, label: 'P', icon_type: 'pin' }],
         canEditPois: false,
       },

test/nuxt/api.spec.js

@@ -0,0 +1,14 @@
+import { describe, it, expect } from 'vitest'
+import { getValidFeeds } from '../../server/utils/feedUtils.js'
+
+describe('API contract', () => {
+  it('getValidFeeds returns array suitable for API response', () => {
+    const raw = [
+      { id: '1', name: 'A', lat: 1, lng: 2 },
+      { id: '2', name: 'B', lat: 3, lng: 4 },
+    ]
+    const out = getValidFeeds(raw)
+    expect(Array.isArray(out)).toBe(true)
+    expect(out).toHaveLength(2)
+  })
+})

test/unit/feedUtils.spec.js

@@ -0,0 +1,119 @@
+import { describe, it, expect } from 'vitest'
+import { isValidFeed, getValidFeeds, sanitizeStreamUrl, sanitizeFeedForResponse } from '../../server/utils/feedUtils.js'
+
+describe('feedUtils', () => {
+  describe('isValidFeed', () => {
+    it('returns true for valid feed', () => {
+      expect(isValidFeed({
+        id: '1',
+        name: 'Cam',
+        lat: 37.7,
+        lng: -122.4,
+      })).toBe(true)
+    })
+
+    it('returns false for null', () => {
+      expect(isValidFeed(null)).toBe(false)
+    })
+
+    it('returns false for missing id', () => {
+      expect(isValidFeed({ name: 'x', lat: 0, lng: 0 })).toBe(false)
+    })
+
+    it('returns false for wrong lat type', () => {
+      expect(isValidFeed({ id: '1', name: 'x', lat: '37', lng: -122 })).toBe(false)
+    })
+  })
+
+  describe('getValidFeeds', () => {
+    it('returns only valid feeds', () => {
+      const list = [
+        { id: 'a', name: 'A', lat: 1, lng: 2 },
+        null,
+        { id: 'b', name: 'B', lat: 3, lng: 4 },
+      ]
+      expect(getValidFeeds(list)).toHaveLength(2)
+    })
+
+    it('returns empty array for non-array', () => {
+      expect(getValidFeeds(null)).toEqual([])
+      expect(getValidFeeds({})).toEqual([])
+    })
+  })
+
+  describe('sanitizeStreamUrl', () => {
+    it('allows http and https', () => {
+      expect(sanitizeStreamUrl('https://example.com/stream')).toBe('https://example.com/stream')
+      expect(sanitizeStreamUrl('http://example.com/stream')).toBe('http://example.com/stream')
+    })
+
+    it('returns empty for javascript:, data:, and other schemes', () => {
+      expect(sanitizeStreamUrl('javascript:alert(1)')).toBe('')
+      expect(sanitizeStreamUrl('data:text/html,<script>')).toBe('')
+      expect(sanitizeStreamUrl('file:///etc/passwd')).toBe('')
+    })
+
+    it('returns empty for non-strings or empty', () => {
+      expect(sanitizeStreamUrl('')).toBe('')
+      expect(sanitizeStreamUrl('   ')).toBe('')
+      expect(sanitizeStreamUrl(null)).toBe('')
+      expect(sanitizeStreamUrl(123)).toBe('')
+    })
+  })
+
+  describe('sanitizeFeedForResponse', () => {
+    it('returns safe shape with sanitized streamUrl and sourceType', () => {
+      const feed = {
+        id: 'f1',
+        name: 'Cam',
+        lat: 37,
+        lng: -122,
+        streamUrl: 'https://safe.com/s',
+        sourceType: 'mjpeg',
+      }
+      const out = sanitizeFeedForResponse(feed)
+      expect(out).toEqual({
+        id: 'f1',
+        name: 'Cam',
+        lat: 37,
+        lng: -122,
+        streamUrl: 'https://safe.com/s',
+        sourceType: 'mjpeg',
+      })
+    })
+
+    it('strips dangerous streamUrl and normalizes sourceType', () => {
+      const feed = {
+        id: 'f2',
+        name: 'Bad',
+        lat: 0,
+        lng: 0,
+        streamUrl: 'javascript:alert(1)',
+        sourceType: 'hls',
+      }
+      const out = sanitizeFeedForResponse(feed)
+      expect(out.streamUrl).toBe('')
+      expect(out.sourceType).toBe('hls')
+    })
+
+    it('includes description only when string', () => {
+      const withDesc = sanitizeFeedForResponse({
+        id: 'a',
+        name: 'n',
+        lat: 0,
+        lng: 0,
+        description: 'A camera',
+      })
+      expect(withDesc.description).toBe('A camera')
+
+      const noDesc = sanitizeFeedForResponse({
+        id: 'b',
+        name: 'n',
+        lat: 0,
+        lng: 0,
+        description: 123,
+      })
+      expect(noDesc).not.toHaveProperty('description')
+    })
+  })
+})

test/unit/mediasoup.spec.js

@@ -25,7 +25,7 @@ describe('Mediasoup', () => {
 
   it('should create a transport', async () => {
     const router = await getRouter(sessionId)
-    const { transport, params } = await createTransport(router)
+    const { transport, params } = await createTransport(router, true)
     expect(transport).toBeDefined()
     expect(params.id).toBe(transport.id)
     expect(params.iceParameters).toBeDefined()
@@ -35,7 +35,7 @@ describe('Mediasoup', () => {
 
   it('should create a transport with requestHost IPv4 and return valid params', async () => {
     const router = await getRouter(sessionId)
-    const { transport, params } = await createTransport(router, '192.168.2.100')
+    const { transport, params } = await createTransport(router, true, '192.168.2.100')
     expect(transport).toBeDefined()
     expect(params.id).toBe(transport.id)
     expect(params.iceParameters).toBeDefined()

test/unit/migrateFeedsToDevices.spec.js

@@ -0,0 +1,32 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest'
+import { getDb, setDbPathForTest } from '../../server/utils/db.js'
+import { migrateFeedsToDevices } from '../../server/utils/migrateFeedsToDevices.js'
+
+describe('migrateFeedsToDevices', () => {
+  beforeEach(() => {
+    setDbPathForTest(':memory:')
+  })
+
+  afterEach(() => {
+    setDbPathForTest(null)
+  })
+
+  it('runs without error when devices table is empty', async () => {
+    const db = await getDb()
+    await expect(migrateFeedsToDevices()).resolves.toBeUndefined()
+    const rows = await db.all('SELECT id FROM devices')
+    expect(rows.length).toBeGreaterThanOrEqual(0)
+  })
+
+  it('is no-op when devices already has rows', async () => {
+    const db = await getDb()
+    await db.run(
+      'INSERT INTO devices (id, name, device_type, vendor, lat, lng, stream_url, source_type, config) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)',
+      ['existing', 'Existing', 'feed', null, 0, 0, '', 'mjpeg', null],
+    )
+    await migrateFeedsToDevices()
+    const rows = await db.all('SELECT id FROM devices')
+    expect(rows).toHaveLength(1)
+    expect(rows[0].id).toBe('existing')
+  })
+})

vitest.config.js

@@ -22,6 +22,7 @@ export default defineVitestConfig({
         'app/composables/useCameras.js', // Visibility/polling branches; covered by E2E
         'server/utils/mediasoup.js', // Requires real mediasoup worker; covered by integration/E2E
         'server/utils/db.js', // Bootstrap/path branches depend on env; covered by integration
+        'server/utils/migrateFeedsToDevices.js', // File-system branches; one-time migration
         '**/*.spec.js',
         '**/*.config.js',
         '**/node_modules/**',