zero-query 0.9.8 → 0.9.9

package/README.md

@@ -30,6 +30,7 @@
 | **HTTP** | Fetch wrapper with auto-JSON, interceptors (with unsubscribe & clear), HEAD requests, parallel requests (`http.all`), config inspection (`getConfig`), timeout/abort, base URL |
 | **Utils** | debounce, throttle, pipe, once, sleep, memoize, escapeHtml, stripHtml, uuid, capitalize, truncate, range, chunk, groupBy, unique, pick, omit, getPath/setPath, isEmpty, clamp, retry, timeout, deepClone, deepMerge, storage/session wrappers, event bus |
 | **Dev Tools** | CLI dev server with live-reload, CSS hot-swap, full-screen error overlay, floating toolbar, dark-themed inspector panel (Router view, DOM tree, network log, component viewer, performance dashboard), fetch interceptor, render instrumentation, CLI bundler for single-file production builds |
+| **SSR** | Server-side rendering to HTML strings in Node.js — `createSSRApp()`, `renderToString()`, `renderPage()` with SEO/Open Graph support, `renderBatch()` for parallel rendering, fragment mode, hydration markers, graceful error handling, `escapeHtml()` utility |
 
 ---
 
@@ -53,7 +54,7 @@ npx zquery dev my-app
 
 > **Tip:** Stay in the project root (where `node_modules` lives) instead of `cd`-ing into `my-app`. This keeps `index.d.ts` accessible to your IDE for full type/intellisense support.
 
-The `create` command generates a ready-to-run project with a sidebar layout, router, multiple components (including folder components with external templates and styles), and responsive styles. Use `--minimal` (or `-m`) to scaffold a lightweight 3-page starter instead. The dev server watches for file changes, hot-swaps CSS in-place, full-reloads on other changes, and handles SPA fallback routing.
+The `create` command generates a ready-to-run project with a sidebar layout, router, multiple components (including folder components with external templates and styles), and responsive styles. Use `--minimal` (or `-m`) to scaffold a lightweight 3-page starter instead. Use `--ssr` (or `-s`) to scaffold a project with a Node.js server-side rendering example. The dev server watches for file changes, hot-swaps CSS in-place, full-reloads on other changes, and handles SPA fallback routing.
 
 #### Error Overlay
 
@@ -186,6 +187,26 @@ my-app/                          ← minimal scaffold (npx zquery create my-app
   assets/
 ```
 
+Use `--ssr` for a project with server-side rendering:
+
+```
+my-app/                          ← SSR scaffold (npx zquery create my-app --ssr)
+  index.html                     ← client HTML shell
+  global.css
+  app/
+    app.js                       ← client entry — registers shared components
+    routes.js                    ← shared route definitions
+    components/
+      home.js                    ← shared component (SSR + client)
+      about.js
+      not-found.js
+  server/
+    index.js                     ← SSR HTTP server
+  assets/
+```
+
+Components in `app/components/` export plain definition objects — the client registers them with `$.component()`, the server with `app.component()`. The `--ssr` flag handles everything automatically — installs dependencies, starts the server at `http://localhost:3000`, and opens the browser.
+
 - One component per file inside `components/`.
 - Names **must contain a hyphen** (Web Component convention): `home-page`, `app-counter`, etc.
 - Components with external templates or styles can use a subfolder (e.g. `contacts/contacts.js` + `contacts.html` + `contacts.css`).
@@ -298,14 +319,16 @@ location / {
 | `$.retry` `$.timeout` | Async utils |
 | `$.param` `$.parseQuery` | URL utils |
 | `$.storage` `$.session` | Storage wrappers |
-| `$.EventBus` `$.bus` | Event bus || `$.onError` `$.ZQueryError` `$.ErrorCode` `$.guardCallback` `$.validate` | Error handling || `$.version` | Library version |\n| `$.libSize` | Minified bundle size string (e.g. `\"~100 KB\"`) |
+| `$.EventBus` `$.bus` | Event bus |
+| `$.onError` `$.ZQueryError` `$.ErrorCode` `$.guardCallback` `$.guardAsync` `$.formatError` `$.validate` | Error handling |
+| `$.version` | Library version |\n| `$.libSize` | Minified bundle size string (e.g. `\"~100 KB\"`) |
 | `$.unitTests` | Build-time test results `{ passed, failed, total, suites, duration, ok }` |
 | `$.meta` | Build metadata (populated by CLI bundler) |
 | `$.noConflict` | Release `$` global |
 
 | CLI Command | Description |
 | --- | --- |
-| `zquery create [dir]` | Scaffold a new project. Default: full-featured app. `--minimal` / `-m`: lightweight 3-page starter with 404 fallback. |
+| `zquery create [dir]` | Scaffold a new project. Default: full-featured app. `--minimal` / `-m`: lightweight 3-page starter. `--ssr` / `-s`: SSR project with shared components and HTTP server. |
 | `zquery dev [root]` | Dev server with live-reload, CSS hot-swap, error overlay, expandable floating toolbar & five-tab inspector panel (port 3100). Visit `/_devtools` for the standalone panel. `--index` for custom HTML, `--bundle` for bundled mode, `--no-intercept` to skip CDN intercept. |
 | `zquery bundle [dir\|file]` | Bundle app into a single IIFE file. Accepts dir or direct entry file. |
 | `zquery build` | Build the zQuery library (`dist/zquery.min.js`) |

package/cli/commands/create.js

@@ -6,6 +6,7 @@
 
 const fs   = require('fs');
 const path = require('path');
+const { execSync, spawn } = require('child_process');
 const { flag } = require('../args');
 
 /**
@@ -30,11 +31,15 @@ function createProject(args) {
   const target = dirArg ? path.resolve(dirArg) : process.cwd();
   const name   = path.basename(target);
 
-  // Determine scaffold variant: --minimal / -m  or  default
-  const variant = flag('minimal', 'm') ? 'minimal' : 'default';
+  // Determine scaffold variant: --minimal / -m  or  --ssr / -s  or  default
+  const variant = flag('minimal', 'm') ? 'minimal'
+                : flag('ssr', 's')     ? 'ssr'
+                :                        'default';
 
   // Guard: refuse to overwrite existing files
-  const conflicts = ['index.html', 'global.css', 'app', 'assets'].filter(f =>
+  const checkFiles = ['index.html', 'global.css', 'app', 'assets'];
+  if (variant === 'ssr') checkFiles.push('server');
+  const conflicts = checkFiles.filter(f =>
     fs.existsSync(path.join(target, f))
   );
   if (conflicts.length) {
@@ -70,11 +75,40 @@ function createProject(args) {
     console.log(`  ✓ ${rel}`);
   }
 
-  console.log(`
+  const devCmd = `npx zquery dev${target !== process.cwd() ? ` ${dirArg}` : ''}`;
+
+  if (variant === 'ssr') {
+    console.log(`\n  Installing dependencies...\n`);
+    // Install zero-query from the same package that provides this CLI
+    // (works both in local dev and when installed from npm)
+    const zqRoot = path.resolve(__dirname, '..', '..');
+    try {
+      execSync(`npm install "${zqRoot}"`, { cwd: target, stdio: 'inherit' });
+    } catch {
+      console.error(`\n  ✗ npm install failed. Run it manually:\n\n    cd ${dirArg || '.'}\n    npm install\n    node server/index.js\n`);
+      process.exit(1);
+    }
+
+    console.log(`\n  Starting SSR server...\n`);
+    const child = spawn('node', ['server/index.js'], { cwd: target, stdio: 'inherit' });
+
+    setTimeout(() => {
+      const open = process.platform === 'win32' ? 'start'
+                 : process.platform === 'darwin' ? 'open' : 'xdg-open';
+      try { execSync(`${open} http://localhost:3000`, { stdio: 'ignore' }); } catch {}
+    }, 500);
+
+    process.on('SIGINT',  () => { child.kill(); process.exit(); });
+    process.on('SIGTERM', () => { child.kill(); process.exit(); });
+    child.on('exit', (code) => process.exit(code || 0));
+    return; // keep process alive for the server
+  } else {
+    console.log(`
   Done! Next steps:
 
-    npx zquery dev${target !== process.cwd() ? ` ${dirArg}` : ''}
+    ${devCmd}
 `);
+  }
 }
 
 module.exports = createProject;

package/cli/help.js

@@ -11,6 +11,8 @@ function showHelp() {
                                (defaults to the current directory)
       --minimal, -m            Use the minimal template (home, counter, about)
                                instead of the full-featured default scaffold
+      --ssr, -s                Use the SSR template — includes server/index.js
+                               SSR HTTP server with shared component definitions
 
     dev [root]                 Start a dev server with live-reload
       --port, -p <number>     Port number (default: 3100)

package/cli/scaffold/ssr/app/app.js

@@ -0,0 +1,30 @@
+// app.js — Client entry point
+//
+// Imports shared component definitions and registers them with zQuery.
+// The SSR server imports the same definitions via createSSRApp().
+
+import { homePage }  from './components/home.js';
+import { aboutPage } from './components/about.js';
+import { notFound }  from './components/not-found.js';
+import { routes }    from './routes.js';
+
+// Register shared component definitions on the client
+$.component('home-page',  homePage);
+$.component('about-page', aboutPage);
+$.component('not-found',  notFound);
+
+// Client-side router
+const router = $.router({
+  el: '#app',
+  routes,
+  fallback: 'not-found',
+  mode: 'history'
+});
+
+// Active nav highlighting
+router.onChange((to) => {
+  $.qsa('.nav-link').forEach(link => {
+    const href = link.getAttribute('z-link') || link.getAttribute('href');
+    link.classList.toggle('active', href === to.path);
+  });
+});

package/cli/scaffold/ssr/app/components/about.js

@@ -0,0 +1,28 @@
+// about.js — About page component
+
+export const aboutPage = {
+  state: () => ({
+    features: [
+      'createSSRApp() — isolated component registry for Node.js',
+      'renderToString() — render a component to an HTML string',
+      'renderPage() — full HTML document with meta tags',
+      'renderBatch() — render multiple components in one call',
+      'Hydration markers (data-zq-ssr) for client takeover',
+      'SEO: description, canonical URL, Open Graph tags',
+    ]
+  }),
+
+  render() {
+    const list = this.state.features.map(f => `<li>${f}</li>`).join('');
+    return `
+      <div class="page-header">
+        <h1>About</h1>
+        <p class="subtitle">SSR capabilities in this scaffold.</p>
+      </div>
+      <div class="card">
+        <h3>SSR API</h3>
+        <ul style="padding-left:1.2rem; line-height:2;">${list}</ul>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/components/home.js

@@ -0,0 +1,37 @@
+// home.js — Home page component
+//
+// Exports a plain definition object that works on both client and server.
+// The client registers it with $.component(), the server with app.component().
+
+export const homePage = {
+  state: () => ({
+    greeting: 'Hello',
+    timestamp: new Date().toLocaleTimeString(),
+  }),
+
+  // init() runs on both client and server — no DOM required
+  init() {
+    const hour = new Date().getHours();
+    this.state.greeting =
+      hour < 12 ? 'Good morning' :
+      hour < 18 ? 'Good afternoon' : 'Good evening';
+  },
+
+  render() {
+    return `
+      <div class="page-header">
+        <h1>${this.state.greeting} 👋</h1>
+        <p class="subtitle">Rendered with zQuery SSR</p>
+      </div>
+      <div class="card">
+        <h3>Server-Side Rendering</h3>
+        <p>
+          This page was rendered to HTML on the server and served as a complete
+          document. The same component definition powers both the SSR server and
+          the client-side SPA.
+        </p>
+        <p>Rendered at <strong>${this.state.timestamp}</strong></p>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/components/not-found.js

@@ -0,0 +1,15 @@
+// not-found.js — 404 fallback component
+
+export const notFound = {
+  render() {
+    return `
+      <div class="page-header" style="text-align:center; margin-top:4rem;">
+        <h1>404</h1>
+        <p class="subtitle">Page not found.</p>
+        <p style="margin-top:1rem;">
+          <a href="/" style="color:var(--accent);">← Home</a>
+        </p>
+      </div>
+    `;
+  }
+};

package/cli/scaffold/ssr/app/routes.js

@@ -0,0 +1,6 @@
+// routes.js — Route definitions (shared between client and server)
+
+export const routes = [
+  { path: '/',     component: 'home-page'  },
+  { path: '/about', component: 'about-page' },
+];

package/cli/scaffold/ssr/global.css

@@ -0,0 +1,113 @@
+/* global.css — SSR Scaffold Styles */
+
+*, *::before, *::after {
+  box-sizing: border-box;
+  margin: 0;
+  padding: 0;
+}
+
+:root {
+  --bg: #0f0f0f;
+  --surface: #1a1a2e;
+  --text: #e0e0e0;
+  --muted: #888;
+  --accent: #00d4ff;
+  --accent-hover: #00b8d9;
+  --radius: 8px;
+  --gap: 1.5rem;
+}
+
+body {
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
+  background: var(--bg);
+  color: var(--text);
+  line-height: 1.6;
+  min-height: 100vh;
+}
+
+/* -- Navbar -- */
+.navbar {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 1rem 2rem;
+  background: var(--surface);
+  border-bottom: 1px solid rgba(255,255,255,0.06);
+}
+
+.brand {
+  font-weight: 700;
+  font-size: 1.2rem;
+  color: var(--accent);
+}
+
+.nav-links { display: flex; gap: 1rem; }
+
+.nav-link {
+  color: var(--muted);
+  text-decoration: none;
+  padding: 0.4rem 0.8rem;
+  border-radius: var(--radius);
+  transition: color 0.2s, background 0.2s;
+}
+.nav-link:hover, .nav-link.active {
+  color: var(--accent);
+  background: rgba(0, 212, 255, 0.08);
+}
+
+/* -- Main content -- */
+#app {
+  max-width: 800px;
+  margin: 2rem auto;
+  padding: 0 1.5rem;
+}
+
+[z-cloak] { display: none !important; }
+
+.page-header {
+  margin-bottom: var(--gap);
+}
+.page-header h1 {
+  font-size: 2rem;
+  margin-bottom: 0.5rem;
+}
+.page-header .subtitle {
+  color: var(--muted);
+}
+
+.card {
+  background: var(--surface);
+  border: 1px solid rgba(255,255,255,0.06);
+  border-radius: var(--radius);
+  padding: 1.5rem;
+  margin-bottom: var(--gap);
+}
+.card h3 {
+  margin-bottom: 0.75rem;
+  color: var(--accent);
+}
+.card code {
+  background: rgba(255,255,255,0.06);
+  padding: 0.15em 0.4em;
+  border-radius: 4px;
+  font-size: 0.9em;
+}
+
+.badge {
+  display: inline-block;
+  padding: 2px 8px;
+  border-radius: 4px;
+  font-size: 0.8em;
+  font-weight: 600;
+}
+.badge-ssr { background: rgba(0,212,255,0.15); color: var(--accent); }
+.badge-csr { background: rgba(255,165,0,0.15); color: #ffa500; }
+
+/* -- Footer -- */
+.footer {
+  text-align: center;
+  padding: 2rem;
+  color: var(--muted);
+  border-top: 1px solid rgba(255,255,255,0.06);
+  margin-top: 3rem;
+}

package/cli/scaffold/ssr/index.html

@@ -0,0 +1,31 @@
+<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{NAME}}</title>
+  <base href="/">
+  <link rel="stylesheet" href="global.css">
+  <script src="zquery.min.js"></script>
+  <script type="module" src="app/app.js"></script>
+</head>
+<body>
+
+  <!-- Navigation -->
+  <nav class="navbar">
+    <span class="brand">⚡ {{NAME}}</span>
+    <div class="nav-links">
+      <a z-link="/" class="nav-link">Home</a>
+      <a z-link="/about" class="nav-link">About</a>
+    </div>
+  </nav>
+
+  <!-- Main content — SSR output is injected here by the server -->
+  <main id="app" z-cloak></main>
+
+  <footer class="footer">
+    <small>Built with zQuery · SSR Scaffold</small>
+  </footer>
+
+</body>
+</html>

package/cli/scaffold/ssr/package.json

@@ -0,0 +1,8 @@
+{
+  "name": "{{NAME}}",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "zero-query": "latest"
+  }
+}

package/cli/scaffold/ssr/server/index.js

@@ -0,0 +1,118 @@
+// server/index.js — SSR HTTP server
+//
+// Renders routes to HTML with zQuery SSR and serves them over HTTP.
+// Components are imported from app/components/ — the same definitions
+// the client uses.
+//
+// Usage:
+//   node server/index.js
+//   PORT=8080 node server/index.js
+
+import { createServer } from 'node:http';
+import { readFile } from 'node:fs/promises';
+import { join, extname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createSSRApp } from 'zero-query/ssr';
+
+// Shared component definitions — same ones the client registers
+import { homePage }  from '../app/components/home.js';
+import { aboutPage } from '../app/components/about.js';
+import { notFound }  from '../app/components/not-found.js';
+import { routes }    from '../app/routes.js';
+
+const __dirname = fileURLToPath(new URL('.', import.meta.url));
+const ROOT = join(__dirname, '..');
+const PORT = parseInt(process.env.PORT || '3000', 10);
+
+// --- SSR app ----------------------------------------------------------------
+
+const app = createSSRApp();
+app.component('home-page',  homePage);
+app.component('about-page', aboutPage);
+app.component('not-found',  notFound);
+
+// --- Route matching ---------------------------------------------------------
+
+function matchRoute(pathname) {
+  const route = routes.find(r => r.path === pathname);
+  return route ? route.component : 'not-found';
+}
+
+// --- Render a full HTML page ------------------------------------------------
+
+async function render(pathname) {
+  const component = matchRoute(pathname);
+  const body = await app.renderToString(component);
+
+  return `<!DOCTYPE html>
+<html lang="en">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>{{NAME}}</title>
+  <link rel="stylesheet" href="/global.css">
+</head>
+<body>
+  <nav class="navbar">
+    <span class="brand">⚡ {{NAME}}</span>
+    <div class="nav-links">
+${routes.map(r =>
+  `      <a href="${r.path}" class="nav-link${r.path === pathname ? ' active' : ''}">${
+    r.path === '/' ? 'Home' : r.path.slice(1)[0].toUpperCase() + r.path.slice(2)
+  }</a>`).join('\n')}
+    </div>
+  </nav>
+  <main id="app">${body}</main>
+  <footer class="footer"><small>Built with zQuery · SSR</small></footer>
+</body>
+</html>`;
+}
+
+// --- Static files -----------------------------------------------------------
+
+const MIME = {
+  '.css': 'text/css', '.js': 'text/javascript', '.json': 'application/json',
+  '.png': 'image/png', '.jpg': 'image/jpeg', '.svg': 'image/svg+xml',
+  '.ico': 'image/x-icon', '.woff2': 'font/woff2',
+};
+
+async function serveStatic(res, pathname) {
+  const ext = extname(pathname);
+  if (!MIME[ext]) return false;
+
+  const filePath = join(ROOT, pathname);
+  if (!resolve(filePath).startsWith(resolve(ROOT))) return false;
+
+  try {
+    const data = await readFile(filePath);
+    res.writeHead(200, { 'Content-Type': MIME[ext] });
+    res.end(data);
+    return true;
+  } catch { return false; }
+}
+
+// --- HTTP server ------------------------------------------------------------
+
+createServer(async (req, res) => {
+  const { pathname } = new URL(req.url, `http://localhost:${PORT}`);
+
+  // Static assets (CSS, images, etc.)
+  if (pathname !== '/' && await serveStatic(res, pathname)) return;
+
+  // SSR route
+  try {
+    const html = await render(pathname);
+    res.writeHead(200, { 'Content-Type': 'text/html; charset=utf-8' });
+    res.end(html);
+  } catch (err) {
+    console.error('SSR error:', err);
+    if (!res.headersSent) {
+      res.writeHead(500, { 'Content-Type': 'text/plain' });
+    }
+    res.end('Internal Server Error');
+  }
+}).listen(PORT, () => {
+  console.log(`\n  ⚡ SSR server → http://localhost:${PORT}\n`);
+  routes.forEach(r => console.log(`    ${r.path.padEnd(10)} → ${r.component}`));
+  console.log(`    *         → not-found\n`);
+});

package/dist/zquery.js

@@ -1,5 +1,5 @@
 /**
- * zQuery (zeroQuery) v0.9.8
+ * zQuery (zeroQuery) v0.9.9
  * Lightweight Frontend Library
  * https://github.com/tonywied17/zero-query
  * (c) 2026 Anthony Wiedman - MIT License
@@ -59,6 +59,12 @@ const ErrorCode = Object.freeze({
   HTTP_INTERCEPTOR:    'ZQ_HTTP_INTERCEPTOR',
   HTTP_PARSE:          'ZQ_HTTP_PARSE',
 
+  // SSR
+  SSR_RENDER:          'ZQ_SSR_RENDER',
+  SSR_COMPONENT:       'ZQ_SSR_COMPONENT',
+  SSR_HYDRATION:       'ZQ_SSR_HYDRATION',
+  SSR_PAGE:            'ZQ_SSR_PAGE',
+
   // General
   INVALID_ARGUMENT:    'ZQ_INVALID_ARGUMENT',
 });
@@ -87,16 +93,28 @@ class ZQueryError extends Error {
 // ---------------------------------------------------------------------------
 // Global error handler
 // ---------------------------------------------------------------------------
-let _errorHandler = null;
+let _errorHandlers = [];
 
 /**
  * Register a global error handler.
  * Called whenever zQuery catches an error internally.
+ * Multiple handlers are supported — each receives the error.
+ * Pass `null` to clear all handlers.
  *
  * @param {Function|null} handler — (error: ZQueryError) => void
+ * @returns {Function} unsubscribe function to remove this handler
  */
 function onError(handler) {
-  _errorHandler = typeof handler === 'function' ? handler : null;
+  if (handler === null) {
+    _errorHandlers = [];
+    return () => {};
+  }
+  if (typeof handler !== 'function') return () => {};
+  _errorHandlers.push(handler);
+  return () => {
+    const idx = _errorHandlers.indexOf(handler);
+    if (idx !== -1) _errorHandlers.splice(idx, 1);
+  };
 }
 
 /**
@@ -113,9 +131,9 @@ function reportError(code, message, context = {}, cause) {
     ? cause
     : new ZQueryError(code, message, context, cause);
 
-  // User handler gets first crack
-  if (_errorHandler) {
-    try { _errorHandler(err); } catch { /* prevent handler from crashing framework */ }
+  // Notify all registered handlers
+  for (const handler of _errorHandlers) {
+    try { handler(err); } catch { /* prevent handler from crashing framework */ }
   }
 
   // Always log for developer visibility
@@ -162,6 +180,42 @@ function validate(value, name, expectedType) {
       `"${name}" must be a ${expectedType}, got ${typeof value}`
     );
   }
+}
+
+/**
+ * Format a ZQueryError into a structured object suitable for overlays/logging.
+ * @param {ZQueryError|Error} err
+ * @returns {{ code: string, type: string, message: string, context: object, stack: string }}
+ */
+function formatError(err) {
+  const isZQ = err instanceof ZQueryError;
+  return {
+    code: isZQ ? err.code : '',
+    type: isZQ ? 'ZQueryError' : (err.name || 'Error'),
+    message: err.message || 'Unknown error',
+    context: isZQ ? err.context : {},
+    stack: err.stack || '',
+    cause: err.cause ? formatError(err.cause) : null,
+  };
+}
+
+/**
+ * Async version of guardCallback — wraps an async function so that
+ * rejections are caught, reported, and don't crash execution.
+ *
+ * @param {Function} fn — async function
+ * @param {string} code — ErrorCode to use
+ * @param {object} [context]
+ * @returns {Function}
+ */
+function guardAsync(fn, code, context = {}) {
+  return async (...args) => {
+    try {
+      return await fn(...args);
+    } catch (err) {
+      reportError(code, err.message || 'Async callback error', context, err);
+    }
+  };
 }
 
 // --- src/reactive.js ---------------------------------------------
@@ -5849,12 +5903,14 @@ $.onError        = onError;
 $.ZQueryError    = ZQueryError;
 $.ErrorCode      = ErrorCode;
 $.guardCallback  = guardCallback;
+$.guardAsync     = guardAsync;
 $.validate       = validate;
+$.formatError    = formatError;
 
 // --- Meta ------------------------------------------------------------------
-$.version   = '0.9.8';
+$.version   = '0.9.9';
 $.libSize   = '~101 KB';
-$.unitTests = {"passed":1733,"failed":0,"total":1733,"suites":489,"duration":2847,"ok":true};
+$.unitTests = {"passed":1808,"failed":0,"total":1808,"suites":493,"duration":2896,"ok":true};
 $.meta      = {};              // populated at build time by CLI bundler
 
 $.noConflict = () => {