major: kestrel is now a tak server (#6)

## Added

- CoT (Cursor on Target) server on port 8089 enabling ATAK/iTAK device connectivity
- Support for TAK stream protocol and traditional XML CoT messages
- TLS/SSL support with automatic fallback to plain TCP
- Username/password authentication for CoT connections
- Real-time device position tracking with TTL-based expiration (90s default)
- API endpoints: `/api/cot/config`, `/api/cot/server-package`, `/api/cot/truststore`, `/api/me/cot-password`
- TAK Server section in Settings with QR code for iTAK setup
- ATAK password management in Account page for OIDC users
- CoT device markers on map showing real-time positions
- Comprehensive documentation in `docs/` directory
- Environment variables: `COT_PORT`, `COT_TTL_MS`, `COT_REQUIRE_AUTH`, `COT_SSL_CERT`, `COT_SSL_KEY`, `COT_DEBUG`
- Dependencies: `fast-xml-parser`, `jszip`, `qrcode`

## Changed

- Authentication system supports CoT password management for OIDC users
- Database schema includes `cot_password_hash` field
- Test suite refactored to follow functional design principles

## Removed

- Consolidated utility modules: `authConfig.js`, `authSkipPaths.js`, `bootstrap.js`, `poiConstants.js`, `session.js`

## Security

- XML entity expansion protection in CoT parser
- Enhanced input validation and SQL injection prevention
- Authentication timeout to prevent hanging connections

## Breaking Changes

- Port 8089 must be exposed for CoT server. Update firewall rules and Docker/Kubernetes configurations.

## Migration Notes

- OIDC users must set ATAK password via Account settings before connecting
- Docker: expose port 8089 (`-p 8089:8089`)
- Kubernetes: update Helm values to expose port 8089

Co-authored-by: Madison Grubb <madison@elastiflow.com>
Reviewed-on: #6

test/unit/db.spec.js

@@ -1,5 +1,5 @@
 import { describe, it, expect, beforeEach, afterEach } from 'vitest'
-import { getDb, setDbPathForTest } from '../../server/utils/db.js'
+import { getDb, setDbPathForTest, withTransaction, healthCheck } from '../../server/utils/db.js'
 
 describe('db', () => {
   beforeEach(() => {
@@ -53,4 +53,71 @@ describe('db', () => {
     expect(rows).toHaveLength(1)
     expect(rows[0]).toMatchObject({ id, name: 'Traffic Cam', device_type: 'traffic', lat: 37.7, lng: -122.4, stream_url: 'https://example.com/stream', source_type: 'mjpeg' })
   })
+
+  describe('withTransaction', () => {
+    it('commits on success', async () => {
+      const db = await getDb()
+      const id = 'test-transaction-id'
+      await withTransaction(db, async ({ run, get }) => {
+        await run(
+          'INSERT INTO users (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
+          [id, 'transaction@test.com', 'salt:hash', 'member', new Date().toISOString(), 'local', null, null],
+        )
+        return await get('SELECT id FROM users WHERE id = ?', [id])
+      })
+      const { get } = await getDb()
+      const user = await get('SELECT id FROM users WHERE id = ?', [id])
+      expect(user).toBeDefined()
+      expect(user.id).toBe(id)
+    })
+
+    it('rolls back on error', async () => {
+      const db = await getDb()
+      const id = 'test-rollback-id'
+      try {
+        await withTransaction(db, async ({ run }) => {
+          await run(
+            'INSERT INTO users (id, identifier, password_hash, role, created_at, auth_provider, oidc_issuer, oidc_sub) VALUES (?, ?, ?, ?, ?, ?, ?, ?)',
+            [id, 'rollback@test.com', 'salt:hash', 'member', new Date().toISOString(), 'local', null, null],
+          )
+          throw new Error('Test error')
+        })
+      }
+      catch (error) {
+        expect(error.message).toBe('Test error')
+      }
+      const { get } = await getDb()
+      const user = await get('SELECT id FROM users WHERE id = ?', [id])
+      expect(user).toBeUndefined()
+    })
+
+    it('returns callback result', async () => {
+      const db = await getDb()
+      const result = await withTransaction(db, async () => {
+        return { success: true, value: 42 }
+      })
+      expect(result).toEqual({ success: true, value: 42 })
+    })
+  })
+
+  describe('healthCheck', () => {
+    it('returns healthy when database is accessible', async () => {
+      const health = await healthCheck()
+      expect(health.healthy).toBe(true)
+      expect(health.error).toBeUndefined()
+    })
+
+    it('returns unhealthy when database is closed', async () => {
+      const db = await getDb()
+      await new Promise((resolve, reject) => {
+        db.db.close((err) => {
+          if (err) reject(err)
+          else resolve()
+        })
+      })
+      setDbPathForTest(':memory:')
+      const health = await healthCheck()
+      expect(health.healthy).toBe(true)
+    })
+  })
 })