zero-query 1.1.1 → 1.2.0

package/cli/commands/dev/server.js

@@ -1,220 +1,220 @@
-/**
- * cli/commands/dev/server.js - HTTP server & SSE broadcasting
- *
- * Creates the zero-http app, serves static files, injects the
- * error-overlay snippet into HTML responses, and manages the
- * SSE connection pool for live-reload events.
- *
- * Uses zero-http middleware:
- *   - helmet()   → security headers (relaxed CSP for dev inline scripts)
- *   - compress() → brotli/gzip/deflate response compression
- *   - cors()     → allow cross-origin requests in development
- *   - serveStatic() → static file serving with ETag & Cache-Control
- *   - SSE with keepAlive, retry, pad for proxy compatibility
- */
-
-'use strict';
-
-const fs   = require('fs');
-const path = require('path');
-const OVERLAY_SCRIPT = require('./overlay');
-const DEVTOOLS_HTML  = require('./devtools');
-
-// ---------------------------------------------------------------------------
-// SSE client pool
-// ---------------------------------------------------------------------------
-
-class SSEPool {
-  constructor() {
-    this._clients = new Set();
-  }
-
-  /** @param {import('zero-http').SSEStream} sse */
-  add(sse) {
-    this._clients.add(sse);
-    sse.on('close', () => this._clients.delete(sse));
-  }
-
-  broadcast(eventType, data) {
-    for (const sse of this._clients) {
-      try { sse.event(eventType, data || ''); } catch { this._clients.delete(sse); }
-    }
-  }
-
-  /** Number of connected SSE clients. */
-  get size() { return this._clients.size; }
-
-  closeAll() {
-    for (const sse of this._clients) {
-      try { sse.close(); } catch { /* ignore */ }
-    }
-    this._clients.clear();
-  }
-}
-
-// ---------------------------------------------------------------------------
-// Server factory
-// ---------------------------------------------------------------------------
-
-/**
- * Prompt the user to auto-install zero-http when it isn't found.
- * Resolves `true` if the user accepts, `false` otherwise.
- */
-function promptInstall() {
-  const rl = require('readline').createInterface({
-    input: process.stdin,
-    output: process.stdout,
-  });
-  return new Promise((resolve) => {
-    rl.question(
-      '\n  The local dev server requires zero-http, which is not installed.\n' +
-      '  This package is only used during development and is not needed\n' +
-      '  for building, bundling, or production.\n' +
-      '  Install it now? (y/n): ',
-      (answer) => {
-        rl.close();
-        resolve(answer.trim().toLowerCase() === 'y');
-      }
-    );
-  });
-}
-
-/**
- * @param {object} opts
- * @param {string} opts.root        - absolute path to project root
- * @param {string} opts.htmlEntry   - e.g. 'index.html'
- * @param {number} opts.port
- * @param {boolean} opts.noIntercept - skip zquery.min.js auto-resolve
- * @returns {Promise<{ app, pool: SSEPool, listen: Function }>}
- */
-async function createServer({ root, htmlEntry, port, noIntercept }) {
-  let zeroHttp;
-  try {
-    zeroHttp = require('zero-http');
-  } catch {
-    const ok = await promptInstall();
-    if (!ok) {
-      console.error('\n  ✖ Cannot start dev server without zero-http.\n');
-      process.exit(1);
-    }
-    const { execSync } = require('child_process');
-    console.log('\n  Installing zero-http...\n');
-    execSync('npm install zero-http --save-dev', { stdio: 'inherit' });
-    zeroHttp = require('zero-http');
-  }
-
-  const {
-    createApp,
-    static: serveStatic,
-    helmet,
-    compress,
-    cors,
-    debug,
-  } = zeroHttp;
-
-  debug.level('silent');
-
-  const app  = createApp();
-  const pool = new SSEPool();
-
-  // ---- Security headers (dev-friendly CSP) ----
-  app.use(helmet({
-    contentSecurityPolicy: {
-      directives: {
-        defaultSrc:  ["'self'"],
-        scriptSrc:   ["'self'", "'unsafe-inline'", "'unsafe-eval'"],
-        styleSrc:    ["'self'", "'unsafe-inline'"],
-        imgSrc:      ["'self'", 'data:', 'blob:'],
-        connectSrc:  ["'self'", 'ws:', 'wss:'],
-        fontSrc:     ["'self'", 'data:'],
-      },
-    },
-    // SPA dev server runs over plain HTTP
-    hsts: false,
-    // Allow framing for devtools panel
-    frameguard: false,
-  }));
-
-  // ---- CORS (allow cross-origin during development) ----
-  app.use(cors());
-
-  // ---- Compression (brotli > gzip > deflate) ----
-  app.use(compress({
-    threshold: 1024,
-  }));
-
-  // ---- SSE endpoint ----
-  app.get('/__zq_reload', (req, res) => {
-    const sse = res.sse({
-      keepAlive: 30000,
-      keepAliveComment: 'ping',
-      retry: 3000,
-      pad: 2048,
-    });
-    pool.add(sse);
-  });
-
-  // ---- DevTools panel ----
-  app.get('/_devtools', (req, res) => {
-    res.set('Content-Type', 'text/html; charset=utf-8');
-    res.set('Cache-Control', 'no-cache');
-    res.send(DEVTOOLS_HTML);
-  });
-
-  // ---- Auto-resolve zquery.min.js ----
-  const pkgRoot = path.resolve(__dirname, '..', '..', '..');
-
-  app.use((req, res, next) => {
-    if (noIntercept) return next();
-    const basename = path.basename(req.url.split('?')[0]).toLowerCase();
-    if (basename !== 'zquery.min.js') return next();
-
-    const candidates = [
-      path.join(pkgRoot, 'dist', 'zquery.min.js'),
-      path.join(root, 'node_modules', 'zero-query', 'dist', 'zquery.min.js'),
-    ];
-    for (const p of candidates) {
-      if (fs.existsSync(p)) {
-        res.set('Content-Type', 'application/javascript; charset=utf-8');
-        res.set('Cache-Control', 'no-cache');
-        res.send(fs.readFileSync(p, 'utf-8'));
-        return;
-      }
-    }
-    next();
-  });
-
-  // ---- Static files ----
-  app.use(serveStatic(root, { index: false, dotfiles: 'ignore' }));
-
-  // ---- SPA fallback - inject overlay/SSE snippet ----
-  app.get('*', (req, res) => {
-    if (path.extname(req.url) && path.extname(req.url) !== '.html') {
-      res.status(404).send('Not Found');
-      return;
-    }
-    const indexPath = path.join(root, htmlEntry);
-    if (!fs.existsSync(indexPath)) {
-      res.status(404).send(`${htmlEntry} not found`);
-      return;
-    }
-    let html = fs.readFileSync(indexPath, 'utf-8');
-    if (html.includes('</body>')) {
-      html = html.replace('</body>', OVERLAY_SCRIPT + '\n</body>');
-    } else {
-      html += OVERLAY_SCRIPT;
-    }
-    res.html(html);
-  });
-
-  function listen(cb) {
-    const server = app.listen(port, cb);
-    server.keepAliveTimeout = 65000;
-    server.headersTimeout   = 66000;
-    return server;
-  }
-
-  return { app, pool, listen };
-}
-
-module.exports = { createServer, SSEPool };
+/**
+ * cli/commands/dev/server.js - HTTP server & SSE broadcasting
+ *
+ * Creates the zero-http app, serves static files, injects the
+ * error-overlay snippet into HTML responses, and manages the
+ * SSE connection pool for live-reload events.
+ *
+ * Uses zero-http middleware:
+ *   - helmet()   → security headers (relaxed CSP for dev inline scripts)
+ *   - compress() → brotli/gzip/deflate response compression
+ *   - cors()     → allow cross-origin requests in development
+ *   - serveStatic() → static file serving with ETag & Cache-Control
+ *   - SSE with keepAlive, retry, pad for proxy compatibility
+ */
+
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+const OVERLAY_SCRIPT = require('./overlay');
+const DEVTOOLS_HTML  = require('./devtools');
+
+// ---------------------------------------------------------------------------
+// SSE client pool
+// ---------------------------------------------------------------------------
+
+class SSEPool {
+  constructor() {
+    this._clients = new Set();
+  }
+
+  /** @param {import('zero-http').SSEStream} sse */
+  add(sse) {
+    this._clients.add(sse);
+    sse.on('close', () => this._clients.delete(sse));
+  }
+
+  broadcast(eventType, data) {
+    for (const sse of this._clients) {
+      try { sse.event(eventType, data || ''); } catch { this._clients.delete(sse); }
+    }
+  }
+
+  /** Number of connected SSE clients. */
+  get size() { return this._clients.size; }
+
+  closeAll() {
+    for (const sse of this._clients) {
+      try { sse.close(); } catch { /* ignore */ }
+    }
+    this._clients.clear();
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Server factory
+// ---------------------------------------------------------------------------
+
+/**
+ * Prompt the user to auto-install zero-http when it isn't found.
+ * Resolves `true` if the user accepts, `false` otherwise.
+ */
+function promptInstall() {
+  const rl = require('readline').createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+  return new Promise((resolve) => {
+    rl.question(
+      '\n  The local dev server requires zero-http, which is not installed.\n' +
+      '  This package is only used during development and is not needed\n' +
+      '  for building, bundling, or production.\n' +
+      '  Install it now? (y/n): ',
+      (answer) => {
+        rl.close();
+        resolve(answer.trim().toLowerCase() === 'y');
+      }
+    );
+  });
+}
+
+/**
+ * @param {object} opts
+ * @param {string} opts.root        - absolute path to project root
+ * @param {string} opts.htmlEntry   - e.g. 'index.html'
+ * @param {number} opts.port
+ * @param {boolean} opts.noIntercept - skip zquery.min.js auto-resolve
+ * @returns {Promise<{ app, pool: SSEPool, listen: Function }>}
+ */
+async function createServer({ root, htmlEntry, port, noIntercept }) {
+  let zeroHttp;
+  try {
+    zeroHttp = require('zero-http');
+  } catch {
+    const ok = await promptInstall();
+    if (!ok) {
+      console.error('\n  ✖ Cannot start dev server without zero-http.\n');
+      process.exit(1);
+    }
+    const { execSync } = require('child_process');
+    console.log('\n  Installing zero-http...\n');
+    execSync('npm install zero-http --save-dev', { stdio: 'inherit' });
+    zeroHttp = require('zero-http');
+  }
+
+  const {
+    createApp,
+    static: serveStatic,
+    helmet,
+    compress,
+    cors,
+    debug,
+  } = zeroHttp;
+
+  debug.level('silent');
+
+  const app  = createApp();
+  const pool = new SSEPool();
+
+  // ---- Security headers (dev-friendly CSP) ----
+  app.use(helmet({
+    contentSecurityPolicy: {
+      directives: {
+        defaultSrc:  ["'self'"],
+        scriptSrc:   ["'self'", "'unsafe-inline'", "'unsafe-eval'"],
+        styleSrc:    ["'self'", "'unsafe-inline'"],
+        imgSrc:      ["'self'", 'data:', 'blob:'],
+        connectSrc:  ["'self'", 'ws:', 'wss:'],
+        fontSrc:     ["'self'", 'data:'],
+      },
+    },
+    // SPA dev server runs over plain HTTP
+    hsts: false,
+    // Allow framing for devtools panel
+    frameguard: false,
+  }));
+
+  // ---- CORS (allow cross-origin during development) ----
+  app.use(cors());
+
+  // ---- Compression (brotli > gzip > deflate) ----
+  app.use(compress({
+    threshold: 1024,
+  }));
+
+  // ---- SSE endpoint ----
+  app.get('/__zq_reload', (req, res) => {
+    const sse = res.sse({
+      keepAlive: 30000,
+      keepAliveComment: 'ping',
+      retry: 3000,
+      pad: 2048,
+    });
+    pool.add(sse);
+  });
+
+  // ---- DevTools panel ----
+  app.get('/_devtools', (req, res) => {
+    res.set('Content-Type', 'text/html; charset=utf-8');
+    res.set('Cache-Control', 'no-cache');
+    res.send(DEVTOOLS_HTML);
+  });
+
+  // ---- Auto-resolve zquery.min.js ----
+  const pkgRoot = path.resolve(__dirname, '..', '..', '..');
+
+  app.use((req, res, next) => {
+    if (noIntercept) return next();
+    const basename = path.basename(req.url.split('?')[0]).toLowerCase();
+    if (basename !== 'zquery.min.js') return next();
+
+    const candidates = [
+      path.join(pkgRoot, 'dist', 'zquery.min.js'),
+      path.join(root, 'node_modules', 'zero-query', 'dist', 'zquery.min.js'),
+    ];
+    for (const p of candidates) {
+      if (fs.existsSync(p)) {
+        res.set('Content-Type', 'application/javascript; charset=utf-8');
+        res.set('Cache-Control', 'no-cache');
+        res.send(fs.readFileSync(p, 'utf-8'));
+        return;
+      }
+    }
+    next();
+  });
+
+  // ---- Static files ----
+  app.use(serveStatic(root, { index: false, dotfiles: 'ignore' }));
+
+  // ---- SPA fallback - inject overlay/SSE snippet ----
+  app.get('*', (req, res) => {
+    if (path.extname(req.url) && path.extname(req.url) !== '.html') {
+      res.status(404).send('Not Found');
+      return;
+    }
+    const indexPath = path.join(root, htmlEntry);
+    if (!fs.existsSync(indexPath)) {
+      res.status(404).send(`${htmlEntry} not found`);
+      return;
+    }
+    let html = fs.readFileSync(indexPath, 'utf-8');
+    if (html.includes('</body>')) {
+      html = html.replace('</body>', OVERLAY_SCRIPT + '\n</body>');
+    } else {
+      html += OVERLAY_SCRIPT;
+    }
+    res.html(html);
+  });
+
+  function listen(cb) {
+    const server = app.listen(port, cb);
+    server.keepAliveTimeout = 65000;
+    server.headersTimeout   = 66000;
+    return server;
+  }
+
+  return { app, pool, listen };
+}
+
+module.exports = { createServer, SSEPool };

package/cli/commands/dev/validator.js

@@ -1,94 +1,94 @@
-/**
- * cli/commands/dev/validator.js - JS syntax validation
- *
- * Pre-validates JavaScript files on save using Node's VM module.
- * Returns structured error descriptors with code frames compatible
- * with the browser error overlay.
- */
-
-'use strict';
-
-const fs = require('fs');
-const vm = require('vm');
-
-// ---------------------------------------------------------------------------
-// Code frame generator
-// ---------------------------------------------------------------------------
-
-/**
- * Build a code frame showing ~4 lines of context around the error
- * with a caret pointer at the offending column.
- *
- * @param {string} source   - full file contents
- * @param {number} line     - 1-based line number
- * @param {number} column   - 1-based column number
- * @returns {string}
- */
-function generateCodeFrame(source, line, column) {
-  const lines = source.split('\n');
-  const start = Math.max(0, line - 4);
-  const end   = Math.min(lines.length, line + 3);
-  const pad   = String(end).length;
-  const frame = [];
-
-  for (let i = start; i < end; i++) {
-    const num    = String(i + 1).padStart(pad);
-    const marker = i === line - 1 ? '>' : ' ';
-    frame.push(`${marker} ${num} | ${lines[i]}`);
-    if (i === line - 1 && column > 0) {
-      frame.push(`  ${' '.repeat(pad)} | ${' '.repeat(column - 1)}^`);
-    }
-  }
-  return frame.join('\n');
-}
-
-// ---------------------------------------------------------------------------
-// JS validation
-// ---------------------------------------------------------------------------
-
-/**
- * Validate a JavaScript file for syntax errors.
- *
- * Strips ESM import/export statements (preserving line numbers) so the
- * VM can parse module-style code, then compiles via vm.Script.
- *
- * @param {string} filePath - absolute path to the file
- * @param {string} relPath  - display-friendly relative path
- * @returns {object|null}   - error descriptor, or null if valid
- */
-function validateJS(filePath, relPath) {
-  let source;
-  try { source = fs.readFileSync(filePath, 'utf-8'); } catch { return null; }
-
-  const normalized = source.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
-  const stripped = normalized.split('\n').map(line => {
-    if (/^\s*import\s+.*from\s+['"]/.test(line))  return ' '.repeat(line.length);
-    if (/^\s*import\s+['"]/.test(line))            return ' '.repeat(line.length);
-    if (/^\s*export\s*\{/.test(line))              return ' '.repeat(line.length);
-    line = line.replace(/^(\s*)export\s+default\s+/, '$1');
-    line = line.replace(/^(\s*)export\s+(const|let|var|function|class|async\s+function)\s/, '$1$2 ');
-    line = line.replace(/import\.meta\.url/g, "'__meta__'");
-    line = line.replace(/import\.meta/g, '({})');
-    return line;
-  }).join('\n');
-
-  try {
-    new vm.Script(stripped, { filename: relPath });
-    return null;
-  } catch (err) {
-    const line   = err.stack ? parseInt((err.stack.match(/:(\d+)/) || [])[1]) || 0 : 0;
-    const col    = err.stack ? parseInt((err.stack.match(/:(\d+):(\d+)/) || [])[2]) || 0 : 0;
-    const frame  = line > 0 ? generateCodeFrame(source, line, col) : '';
-    return {
-      code:    'ZQ_DEV_SYNTAX',
-      type:    err.constructor.name || 'SyntaxError',
-      message: err.message,
-      file:    relPath,
-      line,
-      column:  col,
-      frame,
-    };
-  }
-}
-
-module.exports = { generateCodeFrame, validateJS };
+/**
+ * cli/commands/dev/validator.js - JS syntax validation
+ *
+ * Pre-validates JavaScript files on save using Node's VM module.
+ * Returns structured error descriptors with code frames compatible
+ * with the browser error overlay.
+ */
+
+'use strict';
+
+const fs = require('fs');
+const vm = require('vm');
+
+// ---------------------------------------------------------------------------
+// Code frame generator
+// ---------------------------------------------------------------------------
+
+/**
+ * Build a code frame showing ~4 lines of context around the error
+ * with a caret pointer at the offending column.
+ *
+ * @param {string} source   - full file contents
+ * @param {number} line     - 1-based line number
+ * @param {number} column   - 1-based column number
+ * @returns {string}
+ */
+function generateCodeFrame(source, line, column) {
+  const lines = source.split('\n');
+  const start = Math.max(0, line - 4);
+  const end   = Math.min(lines.length, line + 3);
+  const pad   = String(end).length;
+  const frame = [];
+
+  for (let i = start; i < end; i++) {
+    const num    = String(i + 1).padStart(pad);
+    const marker = i === line - 1 ? '>' : ' ';
+    frame.push(`${marker} ${num} | ${lines[i]}`);
+    if (i === line - 1 && column > 0) {
+      frame.push(`  ${' '.repeat(pad)} | ${' '.repeat(column - 1)}^`);
+    }
+  }
+  return frame.join('\n');
+}
+
+// ---------------------------------------------------------------------------
+// JS validation
+// ---------------------------------------------------------------------------
+
+/**
+ * Validate a JavaScript file for syntax errors.
+ *
+ * Strips ESM import/export statements (preserving line numbers) so the
+ * VM can parse module-style code, then compiles via vm.Script.
+ *
+ * @param {string} filePath - absolute path to the file
+ * @param {string} relPath  - display-friendly relative path
+ * @returns {object|null}   - error descriptor, or null if valid
+ */
+function validateJS(filePath, relPath) {
+  let source;
+  try { source = fs.readFileSync(filePath, 'utf-8'); } catch { return null; }
+
+  const normalized = source.replace(/\r\n/g, '\n').replace(/\r/g, '\n');
+  const stripped = normalized.split('\n').map(line => {
+    if (/^\s*import\s+.*from\s+['"]/.test(line))  return ' '.repeat(line.length);
+    if (/^\s*import\s+['"]/.test(line))            return ' '.repeat(line.length);
+    if (/^\s*export\s*\{/.test(line))              return ' '.repeat(line.length);
+    line = line.replace(/^(\s*)export\s+default\s+/, '$1');
+    line = line.replace(/^(\s*)export\s+(const|let|var|function|class|async\s+function)\s/, '$1$2 ');
+    line = line.replace(/import\.meta\.url/g, "'__meta__'");
+    line = line.replace(/import\.meta/g, '({})');
+    return line;
+  }).join('\n');
+
+  try {
+    new vm.Script(stripped, { filename: relPath });
+    return null;
+  } catch (err) {
+    const line   = err.stack ? parseInt((err.stack.match(/:(\d+)/) || [])[1]) || 0 : 0;
+    const col    = err.stack ? parseInt((err.stack.match(/:(\d+):(\d+)/) || [])[2]) || 0 : 0;
+    const frame  = line > 0 ? generateCodeFrame(source, line, col) : '';
+    return {
+      code:    'ZQ_DEV_SYNTAX',
+      type:    err.constructor.name || 'SyntaxError',
+      message: err.message,
+      file:    relPath,
+      line,
+      column:  col,
+      frame,
+    };
+  }
+}
+
+module.exports = { generateCodeFrame, validateJS };