@zero-server/sdk 0.9.5 → 0.9.7

package/lib/grpc/watch.js

@@ -4,7 +4,7 @@
  *              Watches `.proto` files for changes using `fs.watch()` and
  *              re-parses/re-registers gRPC services automatically.
  *
- *              **Dev-only** — disabled by default when `NODE_ENV=production`.
+ *              **Dev-only** - disabled by default when `NODE_ENV=production`.
  *
  * @example
  *   const { createApp, watchProto } = require('@zero-server/sdk');

package/lib/http/request.js

@@ -7,7 +7,7 @@
  *              to correctly resolve `req.ip`, `req.ips`, `req.protocol`, `req.secure`,
  *              and `req.hostname` when behind reverse proxies.
  *
- *              HTTP/2 compatible — detects pseudo-headers (`:method`, `:path`,
+ *              HTTP/2 compatible - detects pseudo-headers (`:method`, `:path`,
  *              `:authority`) from HTTP/2 requests automatically.
  */
 const net = require('net');
@@ -147,12 +147,12 @@ function _inCIDR(addr, cidr)
  * Compile a `trust proxy` setting into a function `(addr, index) => boolean`.
  *
  * Supported values:
- * - `true` / `'loopback'` — trust loopback IPs (127.0.0.0/8, ::1)
- * - `false` — trust nothing
- * - `number` — trust the first N hops (proxies)
- * - `string` — comma-separated IPs or CIDR ranges
- * - `string[]` — array of IPs or CIDR ranges
- * - `function` — custom `(addr, index) => boolean`
+ * - `true` / `'loopback'` - trust loopback IPs (127.0.0.0/8, ::1)
+ * - `false` - trust nothing
+ * - `number` - trust the first N hops (proxies)
+ * - `string` - comma-separated IPs or CIDR ranges
+ * - `string[]` - array of IPs or CIDR ranges
+ * - `function` - custom `(addr, index) => boolean`
  *
  * @param {*} val - The `trust proxy` setting value.
  * @returns {Function} `(addr: string, hopIndex: number) => boolean`
@@ -177,7 +177,7 @@ function compileTrust(val)
     if (val === false || val === undefined || val === null || val === 0) return () => false;
     if (typeof val === 'number' && val > 0)
     {
-        // Trust all addresses — the hop count is handled by _resolveProxyChain
+        // Trust all addresses - the hop count is handled by _resolveProxyChain
         return () => true;
     }
 
@@ -270,12 +270,12 @@ function _resolveProxyChain(socketAddr, xffHeader, trustFn, trustSetting)
     {
         if (!trustFn(addrs[i], addrs.length - i))
         {
-            // This address is not trusted — it's the client
+            // This address is not trusted - it's the client
             return { ip: addrs[i], ips: chain };
         }
     }
 
-    // All addresses are trusted — leftmost is the client
+    // All addresses are trusted - leftmost is the client
     return { ip: addrs[0] || socketAddr, ips: chain };
 }
 
@@ -316,7 +316,7 @@ class Request
         /** HTTP version (e.g. '2.0' for HTTP/2). @type {string} */
         this.httpVersion = req.httpVersion;
 
-        /** `true` when the connection is over TLS (HTTPS) — raw socket check. @private */
+        /** `true` when the connection is over TLS (HTTPS) - raw socket check. @private */
         this._socketSecure = !!(req.socket && req.socket.encrypted);
 
         /** ALPN protocol negotiated (e.g. 'h2', 'http/1.1'). @type {string|null} */
@@ -335,7 +335,7 @@ class Request
         this.locals = {};
 
         /**
-         * The original URL as received — never rewritten by middleware.
+         * The original URL as received - never rewritten by middleware.
          * Set by `app.handle()`.
          * @type {string}
          */
@@ -580,7 +580,7 @@ class Request
     }
 
     /**
-     * Content negotiation — check if the client accepts the given type(s).
+     * Content negotiation - check if the client accepts the given type(s).
      * Returns the best match, or `false` if none match.
      *
      * @param {...string} types - MIME types to check (e.g. 'json', 'html', 'text/plain').

package/lib/http/response.js

@@ -167,7 +167,7 @@ class Response
             if (!hasContentType)
             {
                 // Heuristic: if it looks like HTML, set text/html
-                // Avoid trimStart() allocation — scan for first non-whitespace char
+                // Avoid trimStart() allocation - scan for first non-whitespace char
                 let isHTML = false;
                 for (let i = 0; i < body.length; i++)
                 {
@@ -655,7 +655,7 @@ class Response
             // Handle RST_STREAM from client (browser doesn't want the push)
             stream.on('error', (e) =>
             {
-                if (e.code === 'ERR_HTTP2_STREAM_CANCEL') return; // Normal — client cancelled
+                if (e.code === 'ERR_HTTP2_STREAM_CANCEL') return; // Normal - client cancelled
                 log.debug('push stream error for %s: %s', path, e.message);
             });
 

package/lib/lifecycle.js

@@ -9,7 +9,7 @@
  *   const app = createApp();
  *   app.listen(3000);
  *
- *   // Automatic — SIGTERM/SIGINT handlers registered by listen()
+ *   // Automatic - SIGTERM/SIGINT handlers registered by listen()
  *   // Manual trigger:
  *   await app.shutdown();
  */
@@ -248,7 +248,7 @@ class LifecycleManager
     /**
      * Install `SIGTERM` and `SIGINT` process signal handlers that trigger
      * graceful shutdown. Called automatically by `app.listen()`.
-     * Safe to call multiple times — handlers are only installed once.
+     * Safe to call multiple times - handlers are only installed once.
      */
     installSignalHandlers()
     {
@@ -300,14 +300,14 @@ class LifecycleManager
      * Perform a full graceful shutdown.
      *
      * Shutdown sequence:
-     * 1. Emit `'beforeShutdown'` — run pre-shutdown hooks (flush metrics, etc.)
+     * 1. Emit `'beforeShutdown'` - run pre-shutdown hooks (flush metrics, etc.)
      * 2. Stop accepting new connections (server.close)
      * 3. Close all WebSocket connections with code `1001` (Going Away)
      * 4. Close all SSE streams
      * 5. Drain active gRPC calls
      * 6. Wait for in-flight HTTP requests to complete (with timeout)
      * 7. Close all registered ORM database connections
-     * 8. Emit `'shutdown'` — final cleanup complete
+     * 8. Emit `'shutdown'` - final cleanup complete
      *
      * If in-flight requests do not complete within the configured
      * timeout (default 30s), they are forcefully terminated.
@@ -345,7 +345,7 @@ class LifecycleManager
         this.state = LIFECYCLE_STATE.DRAINING;
         await this._emit('beforeShutdown');
 
-        // 2. Stop accepting new connections (non-blocking — server.close
+        // 2. Stop accepting new connections (non-blocking - server.close
         //    only resolves after all existing connections end, so we don't
         //    await it here; it will resolve after the drain step finishes).
         const serverClosePromise = this._closeServer();

package/lib/middleware/compress.js

@@ -28,7 +28,7 @@ const COMPRESSIBLE = /^text\/|^application\/(json|javascript|xml|x-www-form-urle
  * @param {number}  [opts.threshold=1024]  - Minimum body size in bytes to compress.
  * @param {number}  [opts.level]           - Compression level (zlib.constants.Z_DEFAULT_COMPRESSION).
  * @param {string|string[]} [opts.encoding] - Force specific encoding(s). Default: auto-negotiate.
- * @param {Function} [opts.filter]         - `(req, res) => boolean` — return false to skip compression.
+ * @param {Function} [opts.filter]         - `(req, res) => boolean` - return false to skip compression.
  * @returns {Function} Middleware `(req, res, next) => void`.
  *
  * @example
@@ -139,14 +139,14 @@ function compress(opts = {})
             // writeHead before write), we can no longer modify them.
             if (raw.headersSent) return false;
 
-            // Check Content-Type — skip non-compressible types
+            // Check Content-Type - skip non-compressible types
             const ct = raw.getHeader('content-type') || '';
             if (ct && !COMPRESSIBLE.test(ct))
             {
                 return false;
             }
 
-            // Never compress SSE streams — compression buffers
+            // Never compress SSE streams - compression buffers
             // the small frames and prevents real-time delivery.
             if (ct.includes('text/event-stream'))
             {
@@ -200,7 +200,7 @@ function compress(opts = {})
             {
                 headersWritten = true;
 
-                // Check threshold — if the total body is small, skip compression
+                // Check threshold - if the total body is small, skip compression
                 const totalChunk = chunk ? (Buffer.isBuffer(chunk) ? chunk : Buffer.from(String(chunk))) : null;
                 if (totalChunk && totalChunk.length < threshold)
                 {

package/lib/observe/health.js

@@ -157,7 +157,7 @@ function diskSpaceCheck(opts = {})
  * @param {Object<string, Function>} [opts.checks] - Named check functions. Each returns `{ healthy, details }` or a boolean/Promise.
  * @param {number} [opts.timeout=5000] - Max time to wait for all checks in ms.
  * @param {boolean} [opts.verbose=true] - Include check details in response.
- * @param {Function} [opts.onFailure] - `(results) => void` — called when any check fails.
+ * @param {Function} [opts.onFailure] - `(results) => void` - called when any check fails.
  * @returns {Function} Route handler `(req, res) => void`.
  *
  * @example

package/lib/observe/index.js

@@ -1,6 +1,6 @@
 /**
  * @module observe
- * @description Observability suite — structured logging, metrics, tracing,
+ * @description Observability suite - structured logging, metrics, tracing,
  *              and health checks. Zero external dependencies.
  */
 const { Logger, structuredLogger, LEVELS, LEVEL_NAMES } = require('./logger');

package/lib/observe/logger.js

@@ -256,7 +256,7 @@ class Logger
  * `requestId`, `method`, `url`, `status`, `duration`, `ip`, `userAgent`,
  * and `contentLength`.
  *
- * Also attaches `req.log` — a child logger with bound request context
+ * Also attaches `req.log` - a child logger with bound request context
  * so handlers can log with full correlation.
  *
  * @param {object} [opts] - Configuration options.
@@ -266,8 +266,8 @@ class Logger
  * @param {boolean} [opts.colors] - ANSI colors (default: TTY detection). Only applies to pretty format.
  * @param {boolean} [opts.timestamps=true] - Include timestamps.
  * @param {WritableStream} [opts.stream] - Output stream override.
- * @param {Function} [opts.skip] - `(req, res) => boolean` — skip logging for certain requests.
- * @param {Function} [opts.customFields] - `(req, res) => object` — extra fields to merge into each request log entry.
+ * @param {Function} [opts.skip] - `(req, res) => boolean` - skip logging for certain requests.
+ * @param {Function} [opts.customFields] - `(req, res) => object` - extra fields to merge into each request log entry.
  * @param {string} [opts.msg] - Custom message template. Supports placeholders: `:method`, `:url`, `:status`, `:duration`.
  * @returns {Function} Middleware `(req, res, next) => void`.
  *

package/lib/observe/metrics.js

@@ -35,7 +35,7 @@
 
 /**
  * Prometheus-compatible Counter. Monotonically increasing.
- * Thread-safe for single-threaded Node — no locking needed.
+ * Thread-safe for single-threaded Node - no locking needed.
  */
 class Counter
 {
@@ -271,7 +271,7 @@ class Histogram
      * Start a timer that, when stopped, observes the elapsed duration in seconds.
      *
      * @param {object} [labels] - Label values.
-     * @returns {Function} Stop function — call it to record the duration.
+     * @returns {Function} Stop function - call it to record the duration.
      *
      * @example
      *   const end = histogram.startTimer({ method: 'GET' });
@@ -654,8 +654,8 @@ function createDefaultMetrics(registry)
  *
  * @param {object} [opts] - Options.
  * @param {MetricsRegistry} [opts.registry] - Metrics registry. Creates a new one if not provided.
- * @param {Function} [opts.routeLabel] - `(req) => string` — extract route label for metrics. Default: `req.route || req.url`.
- * @param {Function} [opts.skip] - `(req) => boolean` — skip metrics for certain requests.
+ * @param {Function} [opts.routeLabel] - `(req) => string` - extract route label for metrics. Default: `req.route || req.url`.
+ * @param {Function} [opts.skip] - `(req) => boolean` - skip metrics for certain requests.
  * @returns {Function} Middleware `(req, res, next) => void`.
  *
  * @example

package/lib/observe/tracing.js

@@ -288,7 +288,7 @@ class Tracer
      * @constructor
      * @param {object} [opts] - Tracer options.
      * @param {string} [opts.serviceName='unknown'] - Service name for all spans.
-     * @param {Function} [opts.exporter] - `(spans: object[]) => void | Promise<void>` — called with batches of serialised spans.
+     * @param {Function} [opts.exporter] - `(spans: object[]) => void | Promise<void>` - called with batches of serialised spans.
      * @param {number} [opts.batchSize=100] - Max spans per export batch.
      * @param {number} [opts.flushInterval=5000] - Auto-flush interval in ms.
      * @param {number} [opts.sampleRate=1.0] - Sampling rate (0.0 to 1.0). 1.0 = sample everything.
@@ -414,7 +414,7 @@ class Tracer
         }
         catch (_)
         {
-            // Silently drop export errors — tracing should never break the app
+            // Silently drop export errors - tracing should never break the app
         }
     }
 
@@ -439,8 +439,8 @@ class Tracer
  *
  * @param {object} [opts] - Options.
  * @param {Tracer} [opts.tracer] - Tracer instance. Creates a default if not provided.
- * @param {Function} [opts.routeLabel] - `(req) => string` — extract route label for span name.
- * @param {Function} [opts.skip] - `(req) => boolean` — skip tracing for certain requests.
+ * @param {Function} [opts.routeLabel] - `(req) => string` - extract route label for span name.
+ * @param {Function} [opts.skip] - `(req) => boolean` - skip tracing for certain requests.
  * @param {boolean} [opts.propagate=true] - Propagate W3C trace context via response headers.
  * @returns {Function} Middleware `(req, res, next) => void`.
  *

package/lib/orm/adapters/json.js

@@ -1,7 +1,7 @@
 /**
  * @module orm/adapters/json
  * @description JSON file-backed database adapter.
- *              Persists data to JSON files on disk — one file per table.
+ *              Persists data to JSON files on disk - one file per table.
  *              Zero-dependency, suitable for prototyping, small apps, and
  *              embedded scenarios. Uses atomic writes for safety.
  *

package/lib/orm/adapters/memory.js

@@ -413,7 +413,7 @@ class MemoryAdapter
         for (let i = 0; i < where.length; i++)
         {
             const clause = where[i];
-            // Skip raw SQL clauses — not supported in memory adapter
+            // Skip raw SQL clauses - not supported in memory adapter
             if (clause.raw) continue;
             const matches = this._matchClause(row, clause);
 
@@ -695,7 +695,7 @@ class MemoryAdapter
 
     /**
      * Drop an index.
-     * @param {string} _table - Table name (unused — searches all tables).
+     * @param {string} _table - Table name (unused - searches all tables).
      * @param {string} name   - Index name.
      * @returns {Promise<void>}
      */

package/lib/orm/adapters/mongo.js

@@ -369,7 +369,7 @@ class MongoAdapter
 
         let results = await cursor.toArray();
 
-        // Distinct — in-memory since MongoDB distinct() only returns values for a single field
+        // Distinct - in-memory since MongoDB distinct() only returns values for a single field
         if (distinct && fields && fields.length > 0)
         {
             const seen = new Set();
@@ -420,7 +420,7 @@ class MongoAdapter
         for (let i = 0; i < where.length; i++)
         {
             const w = where[i];
-            // Skip raw SQL clauses — not applicable to MongoDB
+            // Skip raw SQL clauses - not applicable to MongoDB
             if (w.raw) continue;
             const { field, op, value, logic } = w;
             const clause = this._opToMongo(field, op, value);

package/lib/orm/adapters/mysql.js

@@ -685,7 +685,7 @@ class MysqlAdapter extends BaseSqlAdapter
     }
 
     /**
-     * Get full database overview — all tables with size and row counts.
+     * Get full database overview - all tables with size and row counts.
      * Returns a structured database summary.
      * @returns {Promise<{ tables: Array, totalSize: string, totalRows: number }>}
      */
@@ -724,7 +724,7 @@ class MysqlAdapter extends BaseSqlAdapter
     }
 
     /**
-     * Get processlist — active connections/queries.
+     * Get processlist - active connections/queries.
      * @returns {Promise<Array<{ id: number, user: string, host: string, db: string, command: string, time: number, state: string, info: string }>>}
      */
     async processlist()

package/lib/orm/adapters/postgres.js

@@ -129,7 +129,7 @@ class PostgresAdapter extends BaseSqlAdapter
         {
             const w = where[i];
 
-            // Handle raw WHERE clauses (from whereRaw) — convert ? to $N
+            // Handle raw WHERE clauses (from whereRaw) - convert ? to $N
             if (w.raw)
             {
                 let rawExpr = w.raw;
@@ -847,7 +847,7 @@ class PostgresAdapter extends BaseSqlAdapter
     }
 
     /**
-     * Get full database overview — all tables with size and row counts.
+     * Get full database overview - all tables with size and row counts.
      * @returns {Promise<{ tables: Array, totalSize: string, totalRows: number }>}
      */
     async overview()

package/lib/orm/adapters/sqlite.js

@@ -84,7 +84,7 @@ class SqliteAdapter extends BaseSqlAdapter
         this._db = new Database(filename, dbOpts);
         this._filename = filename;
 
-        /** @private Prepared statement cache — avoids recompilation overhead */
+        /** @private Prepared statement cache - avoids recompilation overhead */
         this._stmtCache = new Map();
         /** @private Maximum cached statements before LRU eviction */
         this._stmtCacheMax = options.stmtCacheSize || 256;
@@ -685,7 +685,7 @@ class SqliteAdapter extends BaseSqlAdapter
     }
 
     /**
-     * Get counts for all tables — structured database overview.
+     * Get counts for all tables - structured database overview.
      * @returns {{ tables: Array<{ name: string, rows: number }>, totalRows: number, fileSize: string }}
      */
     overview()
@@ -807,7 +807,7 @@ class SqliteAdapter extends BaseSqlAdapter
 
     /**
      * Drop an index.
-     * @param {string} _table - Table name (unused — SQLite indexes are schema-scoped).
+     * @param {string} _table - Table name (unused - SQLite indexes are schema-scoped).
      * @param {string} name   - Index name.
      */
     dropIndex(_table, name)

package/lib/orm/audit.js

@@ -134,7 +134,7 @@ class AuditLog
         }
         else
         {
-            // Memory/JSON adapter — ensure table structure
+            // Memory/JSON adapter - ensure table structure
             if (typeof adapter.createTable === 'function')
             {
                 const schema = {

package/lib/orm/index.js

@@ -5,12 +5,12 @@
  *              `TYPES` enum, and schema helpers.
  *
  * Supported adapters (all optional "bring your own driver"):
- *   - `memory`  — in-process (no driver needed)
- *   - `json`    — JSON file persistence (no driver needed)
- *   - `sqlite`  — requires `better-sqlite3`
- *   - `mysql`   — requires `mysql2`
- *   - `postgres` — requires `pg`
- *   - `mongo`   — requires `mongodb`
+ *   - `memory`  - in-process (no driver needed)
+ *   - `json`    - JSON file persistence (no driver needed)
+ *   - `sqlite`  - requires `better-sqlite3`
+ *   - `mysql`   - requires `mysql2`
+ *   - `postgres` - requires `pg`
+ *   - `mongo`   - requires `mongodb`
  *
  * @example
  *   const { Database, Model, TYPES } = require('@zero-server/sdk');
@@ -231,7 +231,7 @@ class Database
     }
 
     /**
-     * Synchronise all registered models — create tables if they don't exist.
+     * Synchronise all registered models - create tables if they don't exist.
      * Tables are ordered so referenced tables are created first (topological sort).
      * @returns {Promise<void>}
      */

package/lib/orm/migrate.js

@@ -322,7 +322,7 @@ class Migrator
 
     /**
      * Fresh start: drop ALL tables (not just migrated ones) then re-migrate.
-     * ⚠️  DESTRUCTIVE — use with caution.
+     * ⚠️  DESTRUCTIVE - use with caution.
      *
      * @returns {Promise<{ migrated: string[], batch: number }>}
      */

package/lib/orm/model.js

@@ -38,13 +38,13 @@ const { EventEmitter } = require('events');
 class Model
 {
     /**
-     * Table name — override in subclass.
+     * Table name - override in subclass.
      * @type {string}
      */
     static table = '';
 
     /**
-     * Column schema — override in subclass.
+     * Column schema - override in subclass.
      * @type {Object<string, object>}
      */
     static schema = {};
@@ -74,7 +74,7 @@ class Model
     static hidden = [];
 
     /**
-     * Named query scopes — reusable query conditions.
+     * Named query scopes - reusable query conditions.
      * Each scope is a function that receives a Query and returns it.
      * @type {Object<string, Function>}
      *
@@ -103,7 +103,7 @@ class Model
     // -- Computed & Virtual Columns ---------------------
 
     /**
-     * Computed column definitions — virtual columns derived from other fields.
+     * Computed column definitions - virtual columns derived from other fields.
      * Not stored in the database; calculated on the fly.
      * Each entry maps a column name to a getter function `(instance) => value`.
      * @type {Object<string, Function>}
@@ -122,17 +122,17 @@ class Model
     static computed = {};
 
     /**
-     * Attribute casts — automatic type transformations on get/set.
+     * Attribute casts - automatic type transformations on get/set.
      * Maps column names to cast types or custom cast objects.
      *
      * Built-in cast types:
-     * - `'json'`     — JSON.parse on get, JSON.stringify on set
-     * - `'boolean'`  — Cast to true/false
-     * - `'integer'`  — parseInt
-     * - `'float'`    — parseFloat
-     * - `'date'`     — Cast to Date object
-     * - `'string'`   — Cast to String
-     * - `'array'`    — JSON parse/stringify for array data
+     * - `'json'`     - JSON.parse on get, JSON.stringify on set
+     * - `'boolean'`  - Cast to true/false
+     * - `'integer'`  - parseInt
+     * - `'float'`    - parseFloat
+     * - `'date'`     - Cast to Date object
+     * - `'string'`   - Cast to String
+     * - `'array'`    - JSON parse/stringify for array data
      *
      * Custom casts:
      * - `{ get: (v) => transformed, set: (v) => transformed }`
@@ -211,7 +211,7 @@ class Model
     static _relations = {};
 
     /**
-     * Database adapter reference — set by Database.register().
+     * Database adapter reference - set by Database.register().
      * @type {object|null}
      * @private
      */
@@ -222,7 +222,7 @@ class Model
     /**
      * @constructor
      * Create a model instance from a data row.
-     * Generally you won't call this directly — use static methods.
+     * Generally you won't call this directly - use static methods.
      *
      * @param {object} data - Row data.
      */
@@ -825,7 +825,7 @@ class Model
 
     /**
      * Get all records, optionally filtered.
-     * Alias for find() — for LINQ-familiarity.
+     * Alias for find() - for LINQ-familiarity.
      *
      * @param {object} [conditions={}] - WHERE conditions.
      * @returns {Promise<Model[]>} All matching records.

package/lib/orm/procedures.js

@@ -56,7 +56,7 @@ class StoredProcedure
             throw new Error('StoredProcedure requires a "body" string');
         }
 
-        // Sanitize name — only allow identifiers
+        // Sanitize name - only allow identifiers
         if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(name))
         {
             throw new Error(`Invalid procedure name: "${name}"`);

package/lib/orm/profiler.js

@@ -117,7 +117,7 @@ class QueryProfiler
 
         if (!counter || (now - counter.firstTs) >= this._n1Window)
         {
-            // Window expired or first query — start a new window
+            // Window expired or first query - start a new window
             counter = { count: 1, firstTs: now };
             this._selectCounters.set(table, counter);
             return;

package/lib/orm/query.js

@@ -388,7 +388,7 @@ class Query
     }
 
     /**
-     * Alias for with() — mirrors Entity Framework include syntax.
+     * Alias for with() - mirrors Entity Framework include syntax.
      * @param {...string|object} relations - Relation names or config objects to eager-load.
      * @returns {Query} This query for chaining.
      */
@@ -998,7 +998,7 @@ class Query
     }
 
     /**
-     * Make Query thenable — allows `await query`.
+     * Make Query thenable - allows `await query`.
      * @param {Function} resolve - Fulfillment handler.
      * @param {Function} reject  - Rejection handler.
      * @returns {Promise} Result of exec().
@@ -1043,7 +1043,7 @@ class Query
     }
 
     /**
-     * Alias for exec — explicitly convert to array.
+     * Alias for exec - explicitly convert to array.
      * @returns {Promise<Array>} Matching rows as an array.
      */
     toArray()
@@ -1072,7 +1072,7 @@ class Query
     }
 
     /**
-     * Alias for first() — C# FirstOrDefault returns null on empty.
+     * Alias for first() - C# FirstOrDefault returns null on empty.
      * @returns {Promise<object|null>} Matching row or null.
      */
     firstOrDefault()
@@ -1081,7 +1081,7 @@ class Query
     }
 
     /**
-     * Alias for avg() — C# naming.
+     * Alias for avg() - C# naming.
      * @param {string} field - Column name.
      * @returns {Promise<number>} Average of the column values.
      */
@@ -1091,7 +1091,7 @@ class Query
     }
 
     /**
-     * Alias for reduce() — C# Aggregate naming.
+     * Alias for reduce() - C# Aggregate naming.
      * @param {Function} fn - Callback function.
      * @param {*} seed - Initial accumulator value.
      * @returns {Promise<*>} Accumulated value.
@@ -1126,7 +1126,7 @@ class Query
     }
 
     /**
-     * Alias for last() — C# naming.
+     * Alias for last() - C# naming.
      * @returns {Promise<object|null>} Matching row or null.
      */
     lastOrDefault()
@@ -1346,7 +1346,7 @@ class Query
     // -- Projection --
 
     /**
-     * FlatMap — project each element to an array and flatten.
+     * FlatMap - project each element to an array and flatten.
      * @param {Function} fn - (item, index) => Array
      * @returns {Promise<Array>} Flattened projected results.
      */
@@ -1599,7 +1599,7 @@ class Query
     }
 
     /**
-     * Inverse of when — apply query logic when condition is falsy.
+     * Inverse of when - apply query logic when condition is falsy.
      *
      * @param {*}        condition - Condition to evaluate.
      * @param {Function} fn - Callback function.

package/lib/orm/schema.js

@@ -180,7 +180,7 @@ function validateValue(value, colDef, colName)
                 try { return JSON.parse(value); }
                 catch (e) { throw new Error(`"${colName}" must be valid JSON`); }
             }
-            // Already an object/array — return as-is for storage
+            // Already an object/array - return as-is for storage
             return value;
         }
         case 'uuid':

package/lib/orm/seed/data/person.js

@@ -6,7 +6,7 @@
  *              job titles, prefixes/suffixes, gender, bio phrases, zodiac signs.
  */
 
-/** Title prefixes — separate lists per target sex for contextual use. */
+/** Title prefixes - separate lists per target sex for contextual use. */
 const NAME_PREFIXES = {
     male:    ['Mr.', 'Dr.', 'Prof.'],
     female:  ['Ms.', 'Mrs.', 'Dr.', 'Prof.', 'Miss'],