rip-lang 3.13.13 → 3.13.15

package/README.md

@@ -9,9 +9,9 @@
 </p>
 
 <p align="center">
-  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.13.13-blue.svg" alt="Version"></a>
+  <a href="CHANGELOG.md"><img src="https://img.shields.io/badge/version-3.13.15-blue.svg" alt="Version"></a>
   <a href="#zero-dependencies"><img src="https://img.shields.io/badge/dependencies-ZERO-brightgreen.svg" alt="Dependencies"></a>
-  <a href="#"><img src="https://img.shields.io/badge/tests-1%2C251%2F1%2C251-brightgreen.svg" alt="Tests"></a>
+  <a href="#"><img src="https://img.shields.io/badge/tests-1%2C255%2F1%2C255-brightgreen.svg" alt="Tests"></a>
   <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-green.svg" alt="License"></a>
 </p>
 
@@ -417,18 +417,17 @@ Rip includes optional packages for full-stack development:
 
 | Package | Version | Purpose |
 |---------|---------|---------|
-| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.10.10 | Core language compiler |
-| [@rip-lang/api](packages/api/) | 1.1.10 | HTTP framework (Sinatra-style routing, 37 validators) |
-| [@rip-lang/server](packages/server/) | 1.1.19 | Multi-worker app server (hot reload, HTTPS, mDNS) |
-| [@rip-lang/db](packages/db/) | 1.2.0 | DuckDB server with official UI + ActiveRecord-style client |
-| [@rip-lang/grid](packages/grid/) | 0.2.0 | Reactive data grid |
-| [@rip-lang/swarm](packages/swarm/) | 1.1.4 | Parallel job runner with worker pool |
-| [@rip-lang/csv](packages/csv/) | 1.1.4 | CSV parser + writer |
-| [@rip-lang/schema](packages/schema/) | 0.2.1 | Unified schema → TypeScript types, SQL DDL, validation, ORM |
+| [rip-lang](https://www.npmjs.com/package/rip-lang) | 3.13.13 | Core language compiler |
+| [@rip-lang/server](packages/server/) | 1.2.11 | Multi-worker app server (web framework, hot reload, HTTPS, mDNS) |
+| [@rip-lang/db](packages/db/) | 1.3.13 | DuckDB server with official UI + ActiveRecord-style client |
+| [@rip-lang/grid](packages/grid/) | 0.2.8 | Reactive data grid |
+| [@rip-lang/swarm](packages/swarm/) | 1.2.16 | Parallel job runner with worker pool |
+| [@rip-lang/csv](packages/csv/) | 1.3.4 | CSV parser + writer |
+| [@rip-lang/schema](packages/schema/) | 0.3.6 | Unified schema → TypeScript types, SQL DDL, validation, ORM |
 | [VS Code Extension](packages/vscode/) | 0.5.0 | Syntax highlighting, type intelligence, source maps |
 
 ```bash
-bun add -g @rip-lang/db    # Installs everything (rip-lang + api + db)
+bun add -g @rip-lang/db    # Installs everything (rip-lang + server + db)
 ```
 
 ---
@@ -463,7 +462,7 @@ rip file.rip           # Run
 rip -c file.rip        # Compile
 rip -t file.rip        # Tokens
 rip -s file.rip        # S-expressions
-bun run test           # 1251 tests
+bun run test           # 1255 tests
 bun run parser         # Rebuild parser
 bun run build          # Build browser bundle
 ```

package/bin/rip

@@ -1,26 +1,26 @@
 #!/usr/bin/env bun
 
-import { readFileSync, writeFileSync, existsSync, statSync, unlinkSync } from 'fs';
+import { readFileSync, readdirSync, writeFileSync, existsSync, statSync, unlinkSync } from 'fs';
 import { execSync, spawnSync, spawn } from 'child_process';
 import { fileURLToPath } from 'url';
 import { dirname, basename, join } from 'path';
 import { Compiler } from '../src/compiler.js';
-import { startREPL } from '../src/repl.js';
 import packageJson from '../package.json' with { type: 'json' };
 
-// Get the directory where this script lives
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = dirname(__filename);
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const loaderPath = join(__dirname, '../rip-loader.js');
 
-// Set NODE_PATH so spawned child processes can resolve @rip-lang/* packages
-const _nodeModules = join(__dirname, '..', '..');
-if (!process.env.NODE_PATH?.split(':').includes(_nodeModules)) {
-  process.env.NODE_PATH = [_nodeModules, process.env.NODE_PATH].filter(Boolean).join(':');
+// Ensure spawned processes can resolve @rip-lang/* packages
+const nodeModules = join(__dirname, '..', '..');
+if (!process.env.NODE_PATH?.split(':').includes(nodeModules)) {
+  process.env.NODE_PATH = [nodeModules, process.env.NODE_PATH].filter(Boolean).join(':');
 }
 
 const VERSION = packageJson.version;
 const SUMMARY = packageJson.description;
 
+const isFile = (path) => existsSync(path) && statSync(path).isFile();
+
 function printHelp() {
   console.log(`
 Rip ${VERSION} - ${SUMMARY}
@@ -40,15 +40,25 @@ Options:
   -s, --sexpr         Show s-expressions (only, unless -c also specified)
   -t, --tokens        Show token stream (only, unless -c also specified)
   -v, --version       Show version number
-  -w, --web           Launch browser REPL (auto-opens + auto-shutdown)
 
 Subcommands:
+  rip serve [flags] [app]       Start server (watches *.rip, HTTPS, mDNS)
   rip check [dir]               Type-check all .rip files in directory
 
+Serve flags:
+  --watch=<glob>      Watch glob pattern (default: *.rip)
+  --static            Disable hot reload and file watching
+  http                HTTP-only mode (no HTTPS)
+  http:<port>         Set HTTP port
+  w:<n>               Worker count (auto, half, 2x, 3x, or number)
+
 Examples:
   rip                           # Interactive REPL (terminal)
   rip script.rip                # Execute script directly
   rip script.rip arg1 arg2      # Execute with arguments
+  rip serve                     # Serve ./index.rip (watches *.rip)
+  rip serve http                # Serve HTTP-only
+  rip serve myapp               # Serve with mDNS name
   rip -c example.rip            # Compile and show JavaScript
   rip -o output.js example.rip  # Compile and save to file
   rip -s example.rip            # Show ONLY s-expressions
@@ -59,7 +69,6 @@ Examples:
   rip -m example.rip            # Compile with inline source map
   rip -cd example.rip           # Show compiled JS and type declarations
   rip -q -c example.rip         # Just the JS, no headers (for piping)
-  rip -w                        # Launch browser REPL (auto-opens)
   echo 'x = 1 + 2' | rip -c     # Compile from stdin
 
 Shebang support:
@@ -71,22 +80,14 @@ Shebang support:
 async function main() {
   const args = process.argv.slice(2);
 
-  // Find the script file position (first non-option argument)
-  // Everything BEFORE it is rip options, everything AFTER it is script arguments
+  // Find script file (first non-option argument)
+  // Everything before it is rip options, everything after is script arguments
   let scriptFileIndex = -1;
   for (let i = 0; i < args.length; i++) {
-    // Skip option values (like -o filename)
-    if (i > 0 && (args[i - 1] === '-o' || args[i - 1] === '--output')) {
-      continue;
-    }
-    // First non-option arg is the script file
-    if (!args[i].startsWith('-')) {
-      scriptFileIndex = i;
-      break;
-    }
+    if (i > 0 && (args[i - 1] === '-o' || args[i - 1] === '--output')) continue;
+    if (!args[i].startsWith('-')) { scriptFileIndex = i; break; }
   }
 
-  // Split into rip options and script arguments
   const rawOptions = scriptFileIndex === -1 ? args : args.slice(0, scriptFileIndex);
   const scriptArgs = scriptFileIndex === -1 ? [] : args.slice(scriptFileIndex + 1);
 
@@ -95,7 +96,6 @@ async function main() {
     /^-[a-zA-Z]{2,}$/.test(arg) ? [...arg.slice(1)].map(ch => `-${ch}`) : [arg]
   );
 
-  // Only check ripOptions for rip's flags (not script args!)
   if (ripOptions.includes('-h') || ripOptions.includes('--help')) {
     printHelp();
     process.exit(0);
@@ -104,13 +104,11 @@ async function main() {
   if (ripOptions.includes('-v') || ripOptions.includes('--version')) {
     console.log(`Rip ${VERSION} - ${SUMMARY}`);
     try {
-      const { readdirSync } = await import('fs');
       const home = process.env.HOME || process.env.USERPROFILE;
       const scopeDir = join(home, '.bun', 'install', 'global', 'node_modules', '@rip-lang');
       if (existsSync(scopeDir) && statSync(scopeDir).isDirectory()) {
-        const pkgs = readdirSync(scopeDir).sort();
         console.log();
-        for (const name of pkgs) {
+        for (const name of readdirSync(scopeDir).sort()) {
           try {
             const pkg = JSON.parse(readFileSync(join(scopeDir, name, 'package.json'), 'utf-8'));
             console.log(`  ${pkg.name.padEnd(24)} ${pkg.version}`);
@@ -121,58 +119,32 @@ async function main() {
     process.exit(0);
   }
 
-  // Launch local browser REPL (starts server + opens browser)
+  // --- Subcommands ---
+
   if (args[0] === 'check') {
-    const targetDir = args[1] || '.';
     const { runCheck } = await import('../src/typecheck.js');
-    const exitCode = await runCheck(targetDir, { quiet: args.includes('-q') || args.includes('--quiet') });
+    const exitCode = await runCheck(args[1] || '.', { quiet: args.includes('-q') || args.includes('--quiet') });
     process.exit(exitCode);
   }
 
-  if (ripOptions.includes('-w') || ripOptions.includes('--web')) {
-    console.log('🚀 Starting Rip browser REPL...\n');
-
-    // Start the server and capture output to get the actual port
-    const servePath = join(__dirname, '../scripts/serve.js');
-    const serverProcess = spawn('bun', [servePath], {
-      stdio: ['inherit', 'pipe', 'inherit'],
-      detached: false,
+  if (args[0] === 'serve') {
+    let serverPath;
+    try {
+      serverPath = fileURLToPath(import.meta.resolve('@rip-lang/server/server'));
+    } catch {
+      console.error('Error: @rip-lang/server is not installed.\n\n  bun add @rip-lang/server\n');
+      process.exit(1);
+    }
+    const result = spawnSync('bun', ['--preload', loaderPath, serverPath, ...args.slice(1)], {
+      stdio: 'inherit',
       env: process.env
     });
-
-    let actualPort = null;
-
-    // Capture server output and extract port
-    serverProcess.stdout.on('data', (data) => {
-      const output = data.toString();
-      process.stdout.write(output);
-
-      // Parse port from "Server running at http://localhost:PORT"
-      if (!actualPort) {
-        const match = output.match(/localhost:(\d+)/);
-        if (match) {
-          actualPort = match[1];
-
-          // Open browser once we know the port
-          setTimeout(() => {
-            const openCmd = process.platform === 'darwin' ? 'open' :
-                            process.platform === 'win32' ? 'start' : 'xdg-open';
-            execSync(`${openCmd} http://localhost:${actualPort}/`);
-            console.log('\n📱 Press Ctrl+C to stop server\n');
-          }, 300);
-        }
-      }
-    });
-
-    // Keep server running (don't exit)
-    return;
+    process.exit(result.status ?? 1);
   }
 
-  // Check if REPL should be started
-  // Launch REPL if: no args AND stdin is a TTY (not piped), OR explicit -r flag
-  const isTTY = process.stdin.isTTY;
-  if ((args.length === 0 && isTTY) || ripOptions.includes('-r') || ripOptions.includes('--repl')) {
-    // Spawn REPL with --experimental-vm-modules flag for proper ES module support
+  // --- REPL ---
+
+  if ((args.length === 0 && process.stdin.isTTY) || ripOptions.includes('-r') || ripOptions.includes('--repl')) {
     const replModule = join(__dirname, '../src/repl.js');
     const replProcess = spawn('bun', ['--experimental-vm-modules', '-e', `import('${replModule}').then(m => m.startREPL())`], {
       stdio: 'inherit',
@@ -182,6 +154,8 @@ async function main() {
     return;
   }
 
+  // --- Execute or compile ---
+
   const showTokens = ripOptions.includes('-t') || ripOptions.includes('--tokens');
   const showSExpr = ripOptions.includes('-s') || ripOptions.includes('--sexpr');
   const showCompiled = ripOptions.includes('-c') || ripOptions.includes('--compile');
@@ -189,133 +163,96 @@ async function main() {
   const generateMap = ripOptions.includes('-m') || ripOptions.includes('--map');
   const quiet = ripOptions.includes('-q') || ripOptions.includes('--quiet');
 
-  const options = {
-    showTokens,
-    showSExpr,
-    quiet,
-    types: generateDts ? 'emit' : undefined,
-    sourceMap: generateMap ? 'inline' : undefined,
-  };
-
-  // Find input file and output file from ripOptions only
   let inputFile = scriptFileIndex === -1 ? null : args[scriptFileIndex];
   let outputFile = null;
 
   for (let i = 0; i < ripOptions.length; i++) {
     if (ripOptions[i] === '-o' || ripOptions[i] === '--output') {
-      outputFile = ripOptions[i + 1];
-      i++;
+      outputFile = ripOptions[++i];
     }
   }
 
-  // Helper to check if path is a regular file (not a directory)
-  const isFile = (path) => existsSync(path) && statSync(path).isFile();
-
-  // If no compile flags and file exists → execute the script instead of compiling it
+  // Execute script directly (no compile flags)
   const hasCompileFlag = showCompiled || showTokens || showSExpr || generateDts || generateMap || outputFile;
   if (inputFile && !hasCompileFlag && isFile(inputFile)) {
-    const loaderPath = join(__dirname, '../rip-loader.js');
-
     if (inputFile.endsWith('.rip')) {
       const result = spawnSync('bun', ['--preload', loaderPath, inputFile, ...scriptArgs], {
         stdio: 'inherit',
         env: process.env
       });
       process.exit(result.status ?? 1);
-    } else {
-      // Non-.rip files (e.g. shebang scripts): compile, write temp file, execute
-      const source = readFileSync(inputFile, 'utf-8');
-      const compiler = new Compiler();
-      const result = compiler.compile(source);
-      const tmp = join(dirname(inputFile), `.${basename(inputFile)}.__rip__.mjs`);
-      let exitCode = 0;
-      try {
-        writeFileSync(tmp, result.code);
-        const r = spawnSync('bun', ['--preload', loaderPath, tmp, ...scriptArgs], { stdio: 'inherit', env: process.env });
-        exitCode = r.status ?? 1;
-      } catch (error) {
-        exitCode = error.status || 1;
-      }
-      try { unlinkSync(tmp); } catch {}
-      process.exit(exitCode);
     }
+
+    // Non-.rip files (e.g. shebang scripts): compile to temp file, execute, clean up
+    const source = readFileSync(inputFile, 'utf-8');
+    const result = new Compiler().compile(source);
+    const tmp = join(dirname(inputFile), `.${basename(inputFile)}.__rip__.mjs`);
+    let exitCode = 0;
+    try {
+      writeFileSync(tmp, result.code);
+      const r = spawnSync('bun', ['--preload', loaderPath, tmp, ...scriptArgs], { stdio: 'inherit', env: process.env });
+      exitCode = r.status ?? 1;
+    } catch (error) {
+      exitCode = error.status || 1;
+    }
+    try { unlinkSync(tmp); } catch {}
+    process.exit(exitCode);
   }
 
-  // Fallback: Check for bin/ script in git repo root
+  // Fallback: look for bin/{command} in git repo root
   // Allows `rip migrate --status` to find and run {repo}/bin/migrate
-  // Also triggers if inputFile is a directory (not a compilable file)
   if (inputFile && !inputFile.startsWith('-') && !isFile(inputFile)) {
     try {
-      // Check if we're in a git repo
       const repoRoot = execSync('git rev-parse --show-toplevel', {
         encoding: 'utf-8',
         stdio: ['pipe', 'pipe', 'pipe']
       }).trim();
-
-      // Look for bin/{command} in repo root
       const binScript = join(repoRoot, 'bin', inputFile);
-
       if (existsSync(binScript)) {
         const r = spawnSync(binScript, scriptArgs, { stdio: 'inherit', env: process.env });
         process.exit(r.status ?? 1);
       }
-    } catch {
-      // Not in a git repo, or git not available - fall through to normal error
-    }
+    } catch {}
   }
 
+  // --- Compile ---
+
   let source;
 
   try {
-    if (!inputFile) {
-      // Read from stdin if no file specified (file descriptor 0)
-      source = readFileSync(0, 'utf-8');
-    } else {
-      // Check if file exists and is a regular file
+    if (inputFile) {
       if (!isFile(inputFile)) {
         console.error(`Error: File not found: ${inputFile}`);
         process.exit(1);
       }
-      // Read source file
       source = readFileSync(inputFile, 'utf-8');
+    } else {
+      source = readFileSync(0, 'utf-8');
     }
 
-    // Compile
-    const compiler = new Compiler(options);
+    const compiler = new Compiler({ showTokens, showSExpr, quiet,
+      types: generateDts ? 'emit' : undefined,
+      sourceMap: generateMap ? 'inline' : undefined,
+    });
     const result = compiler.compile(source);
 
-    // Determine if we should show compiled output
-    // Show compiled JS if: -c flag, OR no debug flags (default mode), OR saving to file
     const shouldShowCompiled = showCompiled || (!showTokens && !showSExpr && !generateDts) || outputFile;
 
-    // Output
     if (outputFile) {
-      // Save to file
       writeFileSync(outputFile, result.code, 'utf-8');
-      if (!options.quiet) {
-        console.log(`Compiled to ${outputFile}`);
-      }
+      if (!quiet) console.log(`Compiled to ${outputFile}`);
     } else if (shouldShowCompiled) {
-      // Show compiled output to stdout
-      if (!options.quiet) {
-        console.log(`// == JavaScript output by Rip ${VERSION} == //\n`);
-      }
+      if (!quiet) console.log(`// == JavaScript output by Rip ${VERSION} == //\n`);
       console.log(result.code);
     }
 
-    // Show .d.ts type declarations to stdout
     if (generateDts && result.dts) {
-      if (!options.quiet) {
-        console.log(`// == Type declarations == //\n`);
-      }
+      if (!quiet) console.log(`// == Type declarations == //\n`);
       console.log(result.dts);
     }
-
   } catch (error) {
     console.error('Compilation Error:', error.message);
-    if (error.stack) {
-      console.error(error.stack);
-    }
+    if (error.stack) console.error(error.stack);
     process.exit(1);
   }
 }

package/docs/RIP-INTERNALS.md

@@ -494,7 +494,7 @@ The `Compiler` class's lexer adapter reconstructs `new String()` wrapping from t
 
 **Solar** is a complete SLR(1) parser generator included with Rip — written in Rip, compiled by Rip, zero external dependencies.
 
-**Location:** `src/grammar/solar.rip` (916 lines)
+**Location:** `src/grammar/solar.rip` (929 lines)
 
 ## Grammar Syntax
 
@@ -533,7 +533,7 @@ Parenthetical: [
 | Parse time | 12,500ms | ~50ms |
 | Dependencies | Many | Zero |
 | Self-hosting | No | Yes |
-| Code size | 2,285 LOC | 916 LOC |
+| Code size | 2,285 LOC | 929 LOC |
 
 After modifying `src/grammar/grammar.rip`:
 

package/docs/RIP-LANG.md

@@ -1232,8 +1232,7 @@ text =~ /line2/m        # Works with /m flag
 Rip includes optional packages for full-stack development. All are written in Rip, have zero dependencies, and run on Bun.
 
 ```bash
-bun add @rip-lang/api            # Web framework
-bun add @rip-lang/server         # Production server
+bun add @rip-lang/server         # Web framework + production server
 bun add @rip-lang/grid           # Reactive data grid
 bun add @rip-lang/db             # DuckDB server + client
 bun add @rip-lang/schema         # ORM + validation
@@ -1241,12 +1240,12 @@ bun add @rip-lang/swarm          # Parallel job runner
 bun add @rip-lang/csv            # CSV parser + writer
 ```
 
-## @rip-lang/api — Web Framework
+## @rip-lang/server — Web Framework & Production Server
 
-Sinatra-style routing with `@` context magic and built-in validators.
+Sinatra-style routing with `@` context magic and built-in validators. Run with `rip serve` for multi-worker production deployment with hot reload, HTTPS, and mDNS.
 
 ```coffee
-import { get, post, use, read, start, notFound } from '@rip-lang/api'
+import { get, post, use, read, start, notFound } from '@rip-lang/server'
 
 # Routes — return data directly
 get '/' -> { message: 'Hello!' }
@@ -1264,7 +1263,7 @@ get '/css/*' -> @send "public/#{@req.path.slice(5)}"
 notFound -> @send 'index.html', 'text/html; charset=UTF-8'
 
 # Middleware
-import { cors, logger, sessions } from '@rip-lang/api/middleware'
+import { cors, logger, sessions } from '@rip-lang/server/middleware'
 
 use logger()
 use cors origin: '*'
@@ -1277,6 +1276,15 @@ after -> console.log "#{@req.method} #{@req.path} - #{Date.now() - @start}ms"
 start port: 3000
 ```
 
+### Serving
+
+```bash
+rip serve                 # Start (uses ./index.rip)
+rip serve --static        # No watching, no hot reload (production)
+rip serve myapp           # Named (accessible at myapp.local)
+rip serve http:3000       # HTTP on specific port
+```
+
 ### read() Validators
 
 ```coffee
@@ -1298,25 +1306,14 @@ ids   = read 'ids', 'ids'       # "1,2,3" → [1, 2, 3]
 slug  = read 'slug', 'slug'     # URL-safe slug
 ```
 
-## @rip-lang/server — Production Server
-
-Multi-worker process manager with hot reload, automatic HTTPS, and mDNS.
-
-```bash
-rip-server                # Start (uses ./index.rip)
-rip-server -w             # With file watching + hot-reload
-rip-server myapp          # Named (accessible at myapp.local)
-rip-server http:3000      # HTTP on specific port
-```
-
 ## Rip UI — Reactive Web Framework (built into rip-lang)
 
 Zero-build reactive framework. Ships the compiler to the browser and compiles `.rip` components on demand. File-based routing, unified reactive stash, and SSE hot reload.
 
 ```coffee
 # Server setup (index.rip)
-import { get, use, start, notFound } from '@rip-lang/api'
-import { serve } from '@rip-lang/api/serve'
+import { get, use, start, notFound } from '@rip-lang/server'
+import { serve } from '@rip-lang/server/middleware'
 
 dir = import.meta.dir
 use serve dir: dir, watch: true
@@ -1412,8 +1409,8 @@ user.save!()
 A complete API server in Rip:
 
 ```coffee
-import { get, post, use, read, start, notFound } from '@rip-lang/api'
-import { cors, logger } from '@rip-lang/api/middleware'
+import { get, post, use, read, start, notFound } from '@rip-lang/server'
+import { cors, logger } from '@rip-lang/server/middleware'
 
 use logger()
 use cors origin: '*'

package/docs/dist/rip.js

@@ -8352,8 +8352,8 @@ globalThis.zip    ??= (...a) => a[0].map((_, i) => a.map(b => b[i]));
     return new CodeGenerator({}).getComponentRuntime();
   }
   // src/browser.js
-  var VERSION = "3.13.13";
-  var BUILD_DATE = "2026-02-25@00:01:59GMT";
+  var VERSION = "3.13.15";
+  var BUILD_DATE = "2026-02-25@06:33:14GMT";
   if (typeof globalThis !== "undefined") {
     if (!globalThis.__rip)
       new Function(getReactiveRuntime())();
@@ -9519,7 +9519,7 @@ ${indented}`);
     return renderer;
   };
   var launch = async function(appBase = "", opts = {}) {
-    let _save, _storage, _storageKey, app, appComponents, bundle, classesKey, compile2, el, hash, persist, renderer, res, resolver, router, saved, savedData, target;
+    let _save, _storage, _storageKey, app, appComponents, bundle, cached, classesKey, compile2, el, etag, etagKey, hash, headers, persist, renderer, res, resolver, router, saved, savedData, target;
     globalThis.__ripLaunched = true;
     if (typeof appBase === "object") {
       opts = appBase;
@@ -9541,11 +9541,24 @@ ${indented}`);
     if (opts.bundle) {
       bundle = opts.bundle;
     } else if (opts.bundleUrl) {
-      res = await fetch(opts.bundleUrl, { cache: "no-cache" });
-      if (!res.ok) {
+      headers = {};
+      etagKey = `__rip_etag_${opts.bundleUrl}`;
+      cached = sessionStorage.getItem(etagKey);
+      if (cached)
+        headers["If-None-Match"] = cached;
+      res = await fetch(opts.bundleUrl, { headers });
+      if (res.status === 304) {
+        bundle = JSON.parse(sessionStorage.getItem(`${etagKey}_data`));
+      } else if (res.ok) {
+        bundle = await res.json();
+        etag = res.headers.get("etag");
+        if (etag) {
+          sessionStorage.setItem(etagKey, etag);
+          sessionStorage.setItem(`${etagKey}_data`, JSON.stringify(bundle));
+        }
+      } else {
         throw new Error(`launch: ${opts.bundleUrl} (${res.status})`);
       }
-      bundle = await res.json();
     } else {
       throw new Error("launch: no bundle or bundleUrl provided");
     }