@rip-lang/server 0.6.0 → 0.7.0

package/README.md

@@ -6,9 +6,9 @@
 
 ## Overview
 
-`@rip-lang/server` is a production-grade application server written entirely in Rip. It provides multi-worker process management, hot reloading, automatic HTTPS, and mDNS service discovery — all in a single ~1,100 line file.
+`@rip-lang/server` is a production-grade application server written entirely in Rip. It provides multi-worker process management, hot reloading, automatic HTTPS, and mDNS service discovery — all in a single ~1,110 line file.
 
-- **`server.rip`** (~1,100 lines) — Complete server: CLI, workers, load balancing, TLS, mDNS
+- **`server.rip`** (~1,110 lines) — Complete server: CLI, workers, load balancing, TLS, mDNS
 
 **Core Philosophy**: Application servers should be simple, fast, and reliable. No complex configuration files. No dependency on external process managers. Just run your app.
 
@@ -39,7 +39,7 @@ bun add -g rip-lang @rip-lang/server
 ### Running Your App
 
 ```bash
-# Basic usage (HTTPS on port 443 or fallback)
+# Basic usage (HTTPS on port 443, or 5700 if unavailable)
 rip-server ./app.rip
 
 # HTTP only mode
@@ -104,18 +104,20 @@ rip-server [flags] <app-path>[@alias1,alias2,...]
 | Flag | Description | Default |
 |------|-------------|---------|
 | `-v`, `--version` | Show version and exit | — |
+| `--env=<mode>` | Environment mode (`dev`, `prod`, `development`, `production`) | `development` |
+| `--debug` | Enable debug logging | Disabled |
+| `--static` | Disable hot reload (production) | Hot reload enabled |
 | `http` | HTTP-only mode (no HTTPS) | HTTPS enabled |
 | `https` | HTTPS mode (explicit) | Auto |
 | `http:<port>` | Set HTTP port | 80 or 5700 |
 | `https:<port>` | Set HTTPS port | 443 or 5700 |
 | `w:<n>` | Worker count (`auto`, `half`, `2x`, `3x`, or number) | `half` of cores |
-| `r:<policy>` | Restart policy (e.g., `5000,3600s`) | `10000,3600s` |
+| `r:<reqs>,<secs>s` | Restart policy: requests, seconds (e.g., `5000,3600s`) | `10000,3600s` |
 | `--cert=<path>` | TLS certificate path | Auto-generated |
 | `--key=<path>` | TLS private key path | Auto-generated |
-| `--auto-tls` | Use mkcert for TLS | Fallback to self-signed |
+| `--auto-tls` | Try mkcert first, then self-signed | Self-signed only |
 | `--hsts` | Enable HSTS headers | Disabled |
 | `--no-redirect-http` | Don't redirect HTTP to HTTPS | Redirects enabled |
-| `--static` | Disable hot reload (production) | Hot reload enabled |
 | `--json-logging` | Output JSON access logs | Human-readable |
 | `--no-access-log` | Disable access logging | Enabled |
 
@@ -141,8 +143,11 @@ rip-server http app.rip
 # Development: HTTPS with mkcert
 rip-server --auto-tls app.rip
 
-# Production: 8 workers, HTTPS
-rip-server w:8 https app.rip
+# Production: 8 workers, HTTPS, no hot reload
+rip-server --env=prod w:8 https app.rip
+
+# Debug mode to troubleshoot issues
+rip-server --debug http app.rip
 
 # Custom ports
 rip-server http:3000 app.rip
@@ -277,19 +282,39 @@ export default
 
 ## Environment Variables
 
-| Variable | Description |
-|----------|-------------|
-| `RIP_WORKER_MODE` | Set by server when spawning workers |
-| `RIP_DEBUG` | Enable debug logging |
-| `RIP_MAX_REQUESTS` | Default max requests per worker |
-| `RIP_MAX_SECONDS` | Default max seconds per worker |
-| `RIP_MAX_QUEUE` | Maximum request queue size |
-| `RIP_QUEUE_TIMEOUT_MS` | Queue timeout in milliseconds |
-| `RIP_STATIC` | Set to `1` to disable hot reload |
+Most settings are configured via CLI flags, but environment variables provide an alternative for containers, CI/CD, or system-wide defaults.
+
+**Essential:**
+
+| Variable | CLI Equivalent | Default | Description |
+|----------|----------------|---------|-------------|
+| `NODE_ENV` | `--env=` | `development` | Environment mode (`development` or `production`) |
+| `RIP_DEBUG` | `--debug` | — | Enable debug logging |
+| `RIP_STATIC` | `--static` | `0` | Set to `1` to disable hot reload |
+
+**Advanced (rarely needed):**
+
+| Variable | CLI Equivalent | Default | Description |
+|----------|----------------|---------|-------------|
+| `RIP_MAX_REQUESTS` | `r:N,...` | `10000` | Max requests before worker recycle |
+| `RIP_MAX_SECONDS` | `r:...,Ns` | `3600` | Max seconds before worker recycle |
+| `RIP_MAX_QUEUE` | `--max-queue=` | `512` | Request queue limit |
+| `RIP_QUEUE_TIMEOUT_MS` | `--queue-timeout-ms=` | `2000` | Queue wait timeout (ms) |
+| `RIP_CONNECT_TIMEOUT_MS` | `--connect-timeout-ms=` | `200` | Worker connect timeout (ms) |
+| `RIP_READ_TIMEOUT_MS` | `--read-timeout-ms=` | `5000` | Worker read timeout (ms) |
 
 ## Dashboard
 
-The server includes a built-in dashboard accessible at `http://rip.local/` (when mDNS is active). The dashboard shows server status, worker count, and registered hosts.
+The server includes a built-in dashboard accessible at `http://rip.local/` (when mDNS is active). This is a **meta-UI for the server itself**, not your application.
+
+**Dashboard Features:**
+
+- **Server Status** — Health status and uptime
+- **Worker Overview** — Active worker count
+- **Registered Hosts** — All mDNS aliases being advertised
+- **Server Ports** — HTTP/HTTPS port configuration
+
+The dashboard uses the same mDNS infrastructure as your app, so it's always available at `rip.local` when any rip-server instance is running.
 
 ## Troubleshooting
 
@@ -297,14 +322,14 @@ The server includes a built-in dashboard accessible at `http://rip.local/` (when
 
 **mDNS not working**: Ensure `dns-sd` is available (built into macOS). On Linux, install Avahi.
 
-**Workers keep restarting**: Check `RIP_DEBUG=1` for import errors in your app.
+**Workers keep restarting**: Use `--debug` (or `RIP_DEBUG=1`) to see import errors in your app.
 
 ## Comparison with Other Servers
 
 | Feature | rip-server | PM2 | Nginx |
 |---------|------------|-----|-------|
 | Pure Rip | ✅ | ❌ | ❌ |
-| Single File | ✅ (~1,100 lines) | ❌ | ❌ |
+| Single File | ✅ (~1,110 lines) | ❌ | ❌ |
 | Hot Reload | ✅ | ✅ | ❌ |
 | Multi-Worker | ✅ | ✅ | ✅ |
 | Auto HTTPS | ✅ | ❌ | ❌ |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rip-lang/server",
-  "version": "0.6.0",
+  "version": "0.7.0",
   "description": "Pure Rip application server — multi-worker, hot reload, HTTPS, mDNS",
   "type": "module",
   "main": "server.rip",
@@ -37,14 +37,10 @@
   },
   "author": "Steve Shreeve <steve.shreeve@gmail.com>",
   "license": "MIT",
-  "peerDependencies": {
-    "rip-lang": "^2.0.0",
-    "@rip-lang/api": "^0.5.0"
-  },
   "files": [
     "bin/",
     "server.rip",
-    "dashboard.html",
+    "server.html",
     "docs/",
     "README.md"
   ]

package/server.rip

@@ -43,10 +43,16 @@ coerceInt = (value, fallback) ->
   n = parseInt(String(value))
   if Number.isFinite(n) then n else fallback
 
+# Environment detection (can be overridden by --env flag)
+_envOverride = null
+_debugMode = false
+
 isDev = ->
-  env = (process.env.NODE_ENV or '').toLowerCase()
+  env = (_envOverride or process.env.NODE_ENV or '').toLowerCase()
   env in ['development', 'dev', '']
 
+isDebug = -> _debugMode or process.env.RIP_DEBUG?
+
 formatTimestamp = ->
   now = new Date()
   pad = (n, w = 2) -> String(n).padStart(w, '0')
@@ -263,6 +269,18 @@ parseFlags = (argv) ->
 
   reload = not (has('--static') or process.env.RIP_STATIC is '1')
 
+  # Environment mode (--env=production, --env=dev, etc.)
+  envValue = getKV('--env=')
+  if envValue
+    normalized = envValue.toLowerCase()
+    _envOverride = switch normalized
+      when 'prod', 'production' then 'production'
+      when 'dev', 'development' then 'development'
+      else normalized
+
+  # Debug mode
+  _debugMode = has('--debug')
+
   httpsPort = do ->
     kv = getKV('--https-port=')
     return coerceInt(kv, 443) if kv?
@@ -480,7 +498,7 @@ class Manager
       RIP_LOG_JSON: if @flags.jsonLogging then '1' else '0'
       RIP_VERSION: String(version or @currentVersion)
 
-    proc = Bun.spawn ['rip', __filename],
+    proc = Bun.spawn ['rip', import.meta.path],
       stdout: 'inherit'
       stderr: 'inherit'
       stdin: 'ignore'
@@ -557,6 +575,15 @@ class Manager
 
     Promise.all!(pairs.map(({ old }) -> old.process.exited.catch(-> null)))
 
+    # Notify server to remove old workers' socket entries
+    ctl = getControlSocketPath(@flags.socketPrefix)
+    for { old } in pairs
+      try
+        body = JSON.stringify({ op: 'quit', workerId: old.id })
+        fetch!('http://localhost/worker', { method: 'POST', body, headers: { 'content-type': 'application/json' }, unix: ctl }).catch(-> null)
+      catch
+        null
+
     retiring = new Set(pairs.map((p) -> p.old.id))
     @workers = @workers.filter((w) -> not retiring.has(w.id))
     @retiringIds.delete(id) for id from retiring
@@ -668,9 +695,7 @@ class Server
 
     # Dashboard for rip.local
     if host is 'rip.local' and url.pathname in ['/', '']
-      headers = new Headers({ 'content-type': 'text/html; charset=utf-8' })
-      @maybeAddSecurityHeaders(headers)
-      return new Response(@getDashboardHTML(), { headers })
+      return new Response Bun.file(import.meta.dir + '/server.html')
 
     return @status() if url.pathname is '/status'
 
@@ -771,7 +796,7 @@ class Server
           @releaseWorker(retry)
           return @buildResponse(res, req, start, workerSeconds)
     catch err
-      console.error "[server] forwardToWorker error:", err.message or err if process.env.RIP_DEBUG
+      console.error "[server] forwardToWorker error:", err.message or err if isDebug()
       @sockets = @sockets.filter((x) -> x.socket isnt socket.socket)
       @availableWorkers = @availableWorkers.filter((x) -> x.socket isnt socket.socket)
       released = true
@@ -969,11 +994,6 @@ class Server
     catch e
       console.error "rip-server: failed to advertise #{host} via mDNS:", e.message
 
-  getDashboardHTML: ->
-    try
-      readFileSync(join(__dirname, 'dashboard.html'), 'utf8')
-    catch
-      '<!DOCTYPE html><html><body><h1>Rip Server</h1><p>Dashboard not found</p></body></html>'
 
 # ==============================================================================
 # Main Entry
@@ -983,7 +1003,7 @@ main = ->
   # Version flag
   if '--version' in process.argv or '-v' in process.argv
     try
-      pkg = JSON.parse(readFileSync(join(__dirname, 'package.json'), 'utf8'))
+      pkg = JSON.parse(readFileSync(import.meta.dir + '/package.json', 'utf8'))
       console.log "rip-server v#{pkg.version}"
     catch
       console.log 'rip-server (version unknown)'
@@ -1029,7 +1049,7 @@ main = ->
         console.log "rip-server: sent SIGTERM to process #{pid}"
       else
         console.log "rip-server: no PID file found at #{pidFile}, trying pkill..."
-        Bun.spawnSync(['pkill', '-f', __filename])
+        Bun.spawnSync(['pkill', '-f', import.meta.path])
     catch e
       console.error "rip-server: stop failed: #{e.message}"
     return