thatcher 1.0.47 → 1.0.49

package/src/lib/state-transport-client.js

@@ -1,178 +0,0 @@
-// state-sync channel (client side): browser WebSocket client with
-// exponential-backoff reconnect + polling fallback, part of the
-// state-protocol.js quartet. See the header comment in state-protocol.js --
-// this is a structured, reconnect-aware protocol distinct from
-// realtime-server.js's simple in-process pub/sub. Zero real importers found
-// repo-wide as of this writing; currently dormant/unwired.
-import Protocol from './state-protocol.js'
-import { CONFIG, ReconnectManager } from './state-transport-reconnect.js'
-import { createLogger } from './logger.js'
-
-const log = createLogger('[StateTransport]')
-
-class StateTransportClient {
-  constructor(config = {}) {
-    this.config = { ...CONFIG, ...config }
-    this.ws = null
-    this.state = 'disconnected'
-    this.listeners = new Map()
-    this.messageQueue = []
-    this.connectionTimeoutTimer = null
-
-    this.reconnect = new ReconnectManager(this.config, {
-      onReconnecting: (data) => { this.emit('reconnecting', data); this.connect() },
-      onFallback: (msg) => this.emit('fallback', msg),
-      onPollStart: () => this.emit('poll_start'),
-      onPollSuccess: (result) => this.emit('poll_success', result),
-      onPollError: (error) => this.emit('poll_error', error)
-    })
-  }
-
-  connect(url) {
-    this.url = url || this.url
-    if (!this.url) {
-      this.emit('error', new Error('No URL provided for connection'))
-      return
-    }
-    this.reconnect.wsUrl = this.url
-
-    if (this.state === 'connecting' || this.state === 'connected') return
-
-    this.state = 'connecting'
-    this.emit('connecting')
-
-    try {
-      this.ws = new WebSocket(this.url)
-
-      this.connectionTimeoutTimer = setTimeout(() => {
-        if (this.state === 'connecting') this.handleConnectionTimeout()
-      }, this.config.connectionTimeout)
-
-      this.ws.onopen = () => this.handleOpen()
-      this.ws.onclose = (event) => this.handleClose(event)
-      this.ws.onerror = (error) => this.handleError(error)
-      this.ws.onmessage = (event) => this.handleMessage(event)
-    } catch (error) {
-      this.handleConnectionFailure(error)
-    }
-  }
-
-  handleOpen() {
-    clearTimeout(this.connectionTimeoutTimer)
-    this.state = 'connected'
-    this.reconnect.resetAttempts()
-    this.emit('connected')
-    this.reconnect.startPingInterval(
-      (msg) => this.send(msg),
-      () => this.ws.close()
-    )
-    this.flushMessageQueue()
-    this.reconnect.stopPolling()
-  }
-
-  handleClose(event) {
-    clearTimeout(this.connectionTimeoutTimer)
-    this.state = 'disconnected'
-    this.reconnect.stopPingInterval()
-    this.emit('disconnected', { code: event.code, reason: event.reason })
-    this.reconnect.scheduleReconnect()
-  }
-
-  handleError(error) {
-    this.emit('error', error)
-  }
-
-  handleConnectionTimeout() {
-    if (this.ws) this.ws.close()
-    this.handleConnectionFailure(new Error('Connection timeout'))
-  }
-
-  handleConnectionFailure(error) {
-    this.emit('error', error)
-    this.state = 'disconnected'
-
-    if (this.reconnect.shouldFallback) {
-      this.reconnect.activateFallback()
-    } else {
-      this.reconnect.scheduleReconnect()
-    }
-  }
-
-  handleMessage(event) {
-    try {
-      const message = JSON.parse(event.data)
-      if (message.type === Protocol.MESSAGE_TYPES.PONG) {
-        this.reconnect.recordPong()
-        return
-      }
-      this.emit('message', message)
-    } catch (error) {
-      this.emit('error', { error, phase: 'message_parsing', data: event.data })
-    }
-  }
-
-  send(message) {
-    if (this.state === 'connected' && this.ws && this.ws.readyState === WebSocket.OPEN) {
-      try {
-        this.ws.send(JSON.stringify(message))
-        return true
-      } catch (error) {
-        this.emit('error', { error, phase: 'send' })
-        this.messageQueue.push(message)
-        return false
-      }
-    }
-    this.messageQueue.push(message)
-    return false
-  }
-
-  flushMessageQueue() {
-    while (this.messageQueue.length > 0 && this.state === 'connected') {
-      const message = this.messageQueue.shift()
-      this.send(message)
-    }
-  }
-
-  disconnect() {
-    this.reconnect.cleanup()
-    if (this.ws) {
-      this.ws.close()
-      this.ws = null
-    }
-    this.state = 'disconnected'
-  }
-
-  on(event, handler) {
-    if (!this.listeners.has(event)) this.listeners.set(event, [])
-    this.listeners.get(event).push(handler)
-  }
-
-  off(event, handler) {
-    if (!this.listeners.has(event)) return
-    const handlers = this.listeners.get(event)
-    const index = handlers.indexOf(handler)
-    if (index > -1) handlers.splice(index, 1)
-  }
-
-  emit(event, data) {
-    if (!this.listeners.has(event)) return
-    for (const handler of this.listeners.get(event)) {
-      try {
-        handler(data)
-      } catch (error) {
-        log.error(`event handler error for ${event}:`, { message: error?.message || String(error) })
-      }
-    }
-  }
-
-  getState() {
-    return this.state
-  }
-
-  isConnected() {
-    return this.state === 'connected'
-  }
-}
-
-export { StateTransportClient }
-export default StateTransportClient

package/src/lib/state-transport-reconnect.js

@@ -1,126 +0,0 @@
-// state-sync channel (reconnect logic): exponential-backoff + polling-fallback
-// manager consumed by state-transport-client.js, part of the state-protocol.js
-// quartet. See the header comment in state-protocol.js for the full
-// ws-broadcast vs state-sync distinction. Zero real importers repo-wide
-// outside this quartet's own internal cross-imports as of this writing.
-import Protocol from './state-protocol.js'
-
-const CONFIG = {
-  reconnectInitialDelay: 1000,
-  reconnectMaxDelay: 30000,
-  reconnectBackoffFactor: 2,
-  pingInterval: 25000,
-  connectionTimeout: 10000,
-  pollingInterval: 5000,
-  pollingFallbackDelay: 3000
-}
-
-class ReconnectManager {
-  constructor(config, callbacks) {
-    this.config = config
-    this.callbacks = callbacks
-    this.reconnectAttempts = 0
-    this.reconnectTimer = null
-    this.pingTimer = null
-    this.pollingTimer = null
-    this.lastPongTime = 0
-    this.useFallback = false
-    this.wsUrl = null
-  }
-
-  get shouldFallback() {
-    return this.reconnectAttempts >= 3 && !this.useFallback
-  }
-
-  resetAttempts() {
-    this.reconnectAttempts = 0
-    this.useFallback = false
-  }
-
-  recordPong() {
-    this.lastPongTime = Date.now()
-  }
-
-  scheduleReconnect() {
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer)
-    }
-
-    const delay = Math.min(
-      this.config.reconnectInitialDelay * Math.pow(this.config.reconnectBackoffFactor, this.reconnectAttempts),
-      this.config.reconnectMaxDelay
-    )
-
-    const jitter = Math.random() * 1000
-    this.reconnectAttempts++
-
-    this.reconnectTimer = setTimeout(() => {
-      this.callbacks.onReconnecting({ attempt: this.reconnectAttempts })
-    }, delay + jitter)
-  }
-
-  activateFallback() {
-    this.useFallback = true
-    this.callbacks.onFallback('Switching to polling mode')
-    this.startPolling()
-  }
-
-  startPolling() {
-    if (this.pollingTimer) return
-
-    this.pollingTimer = setInterval(async () => {
-      try {
-        this.callbacks.onPollStart()
-        const result = await this.pollState()
-        this.callbacks.onPollSuccess(result)
-      } catch (error) {
-        this.callbacks.onPollError(error)
-      }
-    }, this.config.pollingInterval)
-  }
-
-  async pollState() {
-    const httpUrl = this.wsUrl.replace('ws://', 'http://').replace('wss://', 'https://')
-    const response = await fetch(`${httpUrl}/poll`)
-    if (!response.ok) {
-      throw new Error(`Polling failed: ${response.status}`)
-    }
-    return await response.json()
-  }
-
-  startPingInterval(sendFn, closeFn) {
-    this.pingTimer = setInterval(() => {
-      sendFn(Protocol.createPing())
-      const timeSinceLastPong = Date.now() - this.lastPongTime
-      if (timeSinceLastPong > this.config.pingInterval * 2) {
-        closeFn()
-      }
-    }, this.config.pingInterval)
-  }
-
-  stopPingInterval() {
-    if (this.pingTimer) {
-      clearInterval(this.pingTimer)
-      this.pingTimer = null
-    }
-  }
-
-  stopPolling() {
-    if (this.pollingTimer) {
-      clearInterval(this.pollingTimer)
-      this.pollingTimer = null
-    }
-  }
-
-  cleanup() {
-    if (this.reconnectTimer) {
-      clearTimeout(this.reconnectTimer)
-      this.reconnectTimer = null
-    }
-    this.stopPolling()
-    this.stopPingInterval()
-  }
-}
-
-export { CONFIG, ReconnectManager }
-export default ReconnectManager

package/src/lib/state-transport-server.js

@@ -1,189 +0,0 @@
-// state-sync channel (server side): real `ws`-backed WebSocketServer with
-// connection-guard IP/rate limiting, part of the state-protocol.js quartet.
-// See the header comment in state-protocol.js for the full picture -- this is
-// a structured, reconnect-aware state-sync protocol, DIFFERENT from and not a
-// replacement for realtime-server.js's simple in-process pub/sub
-// (the "ws-broadcast" channel actually used by the CRUD write path). As of
-// this writing this file has zero real importers repo-wide; nothing
-// constructs a StateTransportServer today.
-import { WebSocketServer } from 'ws'
-import { EventEmitter } from 'events'
-import Protocol from '@/lib/state-protocol.js'
-import ConnectionGuard from '@/lib/connection-guard.js'
-
-const CONFIG = {
-  pingInterval: 30000,
-  connectionTimeout: 60000,
-  maxConnectionsPerIP: 10,
-  messageRateLimit: 100
-}
-
-class StateTransportServer extends EventEmitter {
-  constructor(server, config = {}) {
-    super()
-    this.config = { ...CONFIG, ...config }
-    this.wss = null
-    this.clients = new Map()
-    this.server = server
-    this.guard = new ConnectionGuard(this.config)
-    this.setupServer()
-  }
-
-  setupServer() {
-    try {
-      this.wss = new WebSocketServer({ server: this.server, path: '/state-sync' })
-      this.wss.on('connection', (ws, req) => this.handleConnection(ws, req))
-      this.wss.on('error', (error) => this.handleError(error))
-      this.guard.startPingInterval(this.clients, (id) => this.handleClose(id))
-      this.emit('ready')
-    } catch (error) {
-      this.emit('error', error)
-      setTimeout(() => this.setupServer(), 5000)
-    }
-  }
-
-  handleConnection(ws, req) {
-    const clientId = this.guard.generateClientId()
-    const ip = req.socket.remoteAddress
-
-    if (!this.guard.checkConnectionLimit(ip)) {
-      ws.close(1008, 'Too many connections from this IP')
-      return
-    }
-
-    const client = {
-      id: clientId,
-      ws,
-      ip,
-      alive: true,
-      connectedAt: Date.now(),
-      messageCount: 0
-    }
-
-    this.clients.set(clientId, client)
-    this.guard.trackIPConnection(ip)
-
-    ws.on('message', (data) => this.handleMessage(clientId, data))
-    ws.on('close', () => this.handleClose(clientId))
-    ws.on('error', (error) => this.handleClientError(clientId, error))
-    ws.on('pong', () => { client.alive = true })
-
-    this.emit('client_connected', clientId)
-  }
-
-  handleMessage(clientId, data) {
-    try {
-      const client = this.clients.get(clientId)
-      if (!client) return
-
-      if (!this.guard.checkRateLimit(clientId)) {
-        this.sendMessage(clientId, Protocol.createStateNack(
-          null,
-          'Rate limit exceeded',
-          Protocol.ERROR_CODES.RATE_LIMITED
-        ))
-        return
-      }
-
-      const message = JSON.parse(data.toString())
-      const validation = Protocol.MessageSchema.validate(message)
-
-      if (!validation.valid) {
-        this.sendMessage(clientId, Protocol.createStateNack(
-          message.id,
-          validation.error,
-          Protocol.ERROR_CODES.INVALID_MESSAGE
-        ))
-        return
-      }
-
-      client.messageCount++
-      this.emit('message', clientId, message)
-
-      if (message.type === Protocol.MESSAGE_TYPES.PING) {
-        this.sendMessage(clientId, Protocol.createPong(message.timestamp))
-      }
-    } catch (error) {
-      this.emit('error', { clientId, error, phase: 'message_handling' })
-    }
-  }
-
-  handleClose(clientId) {
-    const client = this.clients.get(clientId)
-    if (client) {
-      this.guard.untrackIPConnection(client.ip)
-      this.clients.delete(clientId)
-      this.guard.clearRateLimit(clientId)
-      this.emit('client_disconnected', clientId)
-    }
-  }
-
-  handleClientError(clientId, error) {
-    this.emit('error', { clientId, error, phase: 'client_error' })
-  }
-
-  handleError(error) {
-    this.emit('error', { error, phase: 'server_error' })
-  }
-
-  sendMessage(clientId, message) {
-    try {
-      const client = this.clients.get(clientId)
-      if (client && client.ws.readyState === 1) {
-        client.ws.send(JSON.stringify(message))
-        return true
-      }
-      return false
-    } catch (error) {
-      this.emit('error', { clientId, error, phase: 'send_message' })
-      return false
-    }
-  }
-
-  broadcast(message, excludeClientId = null) {
-    const results = { sent: 0, failed: 0 }
-    for (const [clientId] of this.clients) {
-      if (clientId === excludeClientId) continue
-      if (this.sendMessage(clientId, message)) {
-        results.sent++
-      } else {
-        results.failed++
-      }
-    }
-    return results
-  }
-
-  getClientCount() {
-    return this.clients.size
-  }
-
-  getClient(clientId) {
-    return this.clients.get(clientId)
-  }
-
-  close() {
-    this.guard.destroy()
-    for (const client of this.clients.values()) {
-      client.ws.close()
-    }
-    this.clients.clear()
-    if (this.wss) {
-      this.wss.close()
-    }
-  }
-}
-
-if (!global.stateTransportServer) {
-  global.stateTransportServer = null
-}
-
-export function createStateTransportServer(server, config) {
-  if (global.stateTransportServer) {
-    global.stateTransportServer.close()
-  }
-  global.stateTransportServer = new StateTransportServer(server, config)
-  return global.stateTransportServer
-}
-
-export { StateTransportServer }
-export default StateTransportServer

package/src/lib/static-server.js

@@ -1,97 +0,0 @@
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.join(__dirname, '../..');
-
-export function serveStatic(pathname, req, res, compress, getCacheHeaders, _loadModule) {
-  const acceptEncoding = req.headers['accept-encoding'] || '';
-
-  if (pathname === '/favicon.ico') {
-    res.setHeader('Content-Type', 'image/x-icon');
-    res.setHeader('Cache-Control', 'public, max-age=86400');
-    res.setHeader('Content-Length', '0');
-    res.writeHead(200);
-    res.end();
-    return true;
-  }
-
-  if (pathname === '/manifest.json') {
-    const manifest = JSON.stringify({ name: 'Thatcher', short_name: 'Thatcher', start_url: '/', display: 'standalone', background_color: '#f1f5f9', theme_color: '#04141f' });
-    res.setHeader('Content-Type', 'application/json');
-    res.setHeader('Cache-Control', 'public, max-age=86400');
-    res.setHeader('Content-Length', Buffer.byteLength(manifest, 'utf-8'));
-    res.writeHead(200);
-    res.end(manifest);
-    return true;
-  }
-
-  if (pathname === '/service-worker.js') {
-    const swPath = path.join(ROOT, 'src/service-worker.js');
-    if (fs.existsSync(swPath)) {
-      const content = fs.readFileSync(swPath, 'utf-8');
-      const cacheHeaders = getCacheHeaders('dynamic');
-      Object.entries(cacheHeaders).forEach(([k, v]) => res.setHeader(k, v));
-      res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
-      res.setHeader('Content-Length', Buffer.byteLength(content, 'utf-8'));
-      res.writeHead(200);
-      res.end(content);
-      return true;
-    }
-  }
-
-  if (pathname.startsWith('/lib/webjsx/')) {
-    const file = pathname.slice(12);
-    const filePath = path.join(ROOT, 'node_modules/webjsx/dist', file);
-    if (!fs.existsSync(filePath)) return false;
-    const content = fs.readFileSync(filePath, 'utf-8');
-    const cacheHeaders = getCacheHeaders('static', 31536000);
-    Object.entries(cacheHeaders).forEach(([k, v]) => res.setHeader(k, v));
-    const { content: finalContent, encoding } = compress(content, acceptEncoding);
-    res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
-    if (encoding) res.setHeader('Content-Encoding', encoding);
-    res.setHeader('Content-Length', Buffer.byteLength(finalContent));
-    res.writeHead(200);
-    res.end(finalContent);
-    return true;
-  }
-
-  if (pathname.startsWith('/ui/') && pathname.endsWith('.css')) {
-    const cssPath = path.join(ROOT, 'src/ui', path.basename(pathname));
-    if (!fs.existsSync(cssPath)) return false;
-    let content = fs.readFileSync(cssPath, 'utf-8');
-    const etag = `"${content.length}-${fs.statSync(cssPath).mtimeMs.toString(36)}"`;
-    if (req.headers['if-none-match'] === etag) { res.writeHead(304); res.end(); return true; }
-    res.setHeader('Cache-Control', 'public, max-age=0, must-revalidate');
-    res.setHeader('ETag', etag);
-    const { content: finalContent, encoding } = compress(content, acceptEncoding);
-    res.setHeader('Content-Type', 'text/css; charset=utf-8');
-    if (encoding) res.setHeader('Content-Encoding', encoding);
-    res.setHeader('Content-Length', Buffer.byteLength(finalContent));
-    res.writeHead(200);
-    res.end(finalContent);
-    return true;
-  }
-
-  if (pathname === '/ui/client.js' || pathname === '/ui/event-delegation.js' || pathname === '/ui/common-handlers.js') {
-    const jsPath = path.join(ROOT, 'src/ui', pathname.split('/').pop());
-    if (!fs.existsSync(jsPath)) return false;
-    const content = fs.readFileSync(jsPath, 'utf-8');
-    const cacheHeaders = getCacheHeaders('static', 86400);
-    Object.entries(cacheHeaders).forEach(([k, v]) => res.setHeader(k, v));
-    const { content: finalContent, encoding } = compress(content, acceptEncoding);
-    res.setHeader('Content-Type', 'application/javascript; charset=utf-8');
-    if (encoding) res.setHeader('Content-Encoding', encoding);
-    res.setHeader('Content-Length', Buffer.byteLength(finalContent));
-    res.writeHead(200);
-    res.end(finalContent);
-    return true;
-  }
-
-  return false;
-}
-
-export function html404() {
-  return `<!DOCTYPE html><html lang="en"><head><meta charset="UTF-8"><script>(function(){try{var t=localStorage.getItem('thatcher-theme')||((window.matchMedia&&window.matchMedia('(prefers-color-scheme: dark)').matches)?'dark':'light');document.documentElement.setAttribute('data-theme',t)}catch(e){document.documentElement.setAttribute('data-theme','light')}})();</script><meta name="viewport" content="width=device-width,initial-scale=1"><title>404 - Page Not Found | Thatcher</title><link href="/ui/rippleui.css" rel="stylesheet"><link href="/ui/styles2.css" rel="stylesheet"><style>body{margin:0;background:var(--color-bg,#f1f5f9);font-family:system-ui,sans-serif}.nav-shell{background:#04141f;padding:0 2rem;height:56px;display:flex;align-items:center}a.logo-link{color:#fff;text-decoration:none;font-weight:700;font-size:1.1rem}.error-shell{min-height:calc(100vh - 56px);display:flex;align-items:center;justify-content:center}.error-card{background:#fff;border-radius:12px;padding:3rem 4rem;text-align:center;box-shadow:0 1px 3px rgba(0,0,0,.1)}.error-code{font-size:4rem;font-weight:900;color:#04141f;line-height:1}.error-msg{font-size:1.2rem;color:#64748b;margin:0.5rem 0 2rem}.home-btn{display:inline-block;padding:0.75rem 2rem;background:#04141f;color:#fff;border-radius:8px;text-decoration:none;font-weight:600;font-size:0.95rem}</style></head><body><nav class="nav-shell"><a href="/" class="logo-link">Thatcher</a></nav><div class="error-shell"><div class="error-card"><div class="error-code">404</div><p class="error-msg">Page not found</p><a href="/" class="home-btn">Go to Dashboard</a></div></div></body></html>`;
-}