@zero-server/sdk 0.9.6 → 0.9.8

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'],

package/lib/orm/seed/fake.js

@@ -5,13 +5,13 @@
  * @description Extensible fake data generator.
  *
  *  Key capabilities:
- *    • Seeded / reproducible output  — Fake.seed(42)
- *    • Guaranteed-unique values      — Fake.unique(() => Fake.email())
- *    • Multi-locale names            — Fake.firstName({ locale: 'ja', sex: 'female' })
- *    • Rich phone formats            — Fake.phone({ countryCode: 'DE', format: 'international' })
- *    • Configurable emails           — Fake.email({ provider: 'company.io' })
- *    • Flexible usernames            — Fake.username({ style: 'underscore' })
- *    • Fixed-length numeric strings  — Fake.numericString(8)
+ *    • Seeded / reproducible output  - Fake.seed(42)
+ *    • Guaranteed-unique values      - Fake.unique(() => Fake.email())
+ *    • Multi-locale names            - Fake.firstName({ locale: 'ja', sex: 'female' })
+ *    • Rich phone formats            - Fake.phone({ countryCode: 'DE', format: 'international' })
+ *    • Configurable emails           - Fake.email({ provider: 'company.io' })
+ *    • Flexible usernames            - Fake.username({ style: 'underscore' })
+ *    • Fixed-length numeric strings  - Fake.numericString(8)
  *    • Person: job titles, bio, zodiac, gender, prefix/suffix
  *    • Location: city, country, state, address, lat/lng, timezone
  *    • Commerce: product, company, category, price, industry
@@ -928,7 +928,7 @@ class Fake
     // -- Internet & Network -------------------------------------------------
 
     /**
-     * Random email address (backward-compatible shorthand — same as email()).
+     * Random email address (backward-compatible shorthand - same as email()).
      * Accepts no arguments for historical use.
      */
 
@@ -1051,7 +1051,7 @@ class Fake
     static userAgent() { return _pick(USER_AGENTS); }
 
     /**
-     * Random password-like string. NOT suitable for real passwords — uses a
+     * Random password-like string. NOT suitable for real passwords - uses a
      * PRNG seeded from Math.random, not a CSPRNG.
      *
      * @param {object}  [options] - Configuration options.
@@ -1180,7 +1180,7 @@ class Fake
     }
 }
 
-// Static uniqueness tracker — shared across all calls in the process lifetime
+// Static uniqueness tracker - shared across all calls in the process lifetime
 Fake._tracker = new UniqueTracker();
 
 module.exports = { Fake };

package/lib/orm/seed/index.js

@@ -5,10 +5,10 @@
  * @description Public API for the seed subsystem.
  *
  * Re-exports:
- *   - `Fake`         — static fake-data generator
- *   - `Factory`      — model factory for defining / creating test fixtures
- *   - `Seeder`       — base class for database seeders
- *   - `SeederRunner` — orchestrates running multiple seeders
+ *   - `Fake`         - static fake-data generator
+ *   - `Factory`      - model factory for defining / creating test fixtures
+ *   - `Seeder`       - base class for database seeders
+ *   - `SeederRunner` - orchestrates running multiple seeders
  */
 
 const { Fake }                   = require('./fake');

package/lib/orm/seed/rng.js

@@ -14,7 +14,7 @@
  */
 
 /**
- * mulberry32 — minimal, high-quality 32-bit PRNG.
+ * mulberry32 - minimal, high-quality 32-bit PRNG.
  * @param {number} s - Unsigned 32-bit integer seed.
  * @returns {() => number} Float in [0, 1).
  */

package/lib/orm/snapshot.js

@@ -234,7 +234,7 @@ function generateMigrationCode(migrationName, changes, currentSnap)
     for (const table of changes.tables.dropped)
     {
         upLines.push(`        await db.adapter.dropTable('${table}');`);
-        // down recreates — but we need the previous snapshot's schema for that
+        // down recreates - but we need the previous snapshot's schema for that
         // This is handled via the `prev` reference embedded in the dropped table
     }
 
@@ -268,8 +268,8 @@ function generateMigrationCode(migrationName, changes, currentSnap)
     return `'use strict';
 
 /**
- * Auto-generated migration — ${migrationName}
- * Generated by: npx zh make:migration
+ * Auto-generated migration - ${migrationName}
+ * Generated by: npx zs make:migration
  */
 module.exports = {
     name: '${migrationName}',

package/lib/orm/tenancy.js

@@ -43,8 +43,8 @@ class TenantContext
 /**
  * Multi-tenancy manager.
  * Supports two strategies:
- *   - `'row'`    — adds a tenant column to every query (row-level isolation)
- *   - `'schema'` — uses separate database schemas per tenant (PostgreSQL)
+ *   - `'row'`    - adds a tenant column to every query (row-level isolation)
+ *   - `'schema'` - uses separate database schemas per tenant (PostgreSQL)
  */
 class TenantManager
 {
@@ -242,7 +242,7 @@ class TenantManager
         const origCount      = ModelClass.count.bind(ModelClass);
         const origExists     = ModelClass.exists.bind(ModelClass);
 
-        // Patch query() — all query builder paths
+        // Patch query() - all query builder paths
         ModelClass.query = function ()
         {
             const q = origQuery();
@@ -251,7 +251,7 @@ class TenantManager
             return q;
         };
 
-        // Patch create() — inject tenant column
+        // Patch create() - inject tenant column
         ModelClass.create = async function (data)
         {
             const tid = manager.getCurrentTenant();
@@ -283,7 +283,7 @@ class TenantManager
             return origFindOne(conditions);
         };
 
-        // Patch findById() — still applies tenant scope
+        // Patch findById() - still applies tenant scope
         ModelClass.findById = async function (id)
         {
             const tid = manager.getCurrentTenant();
@@ -344,7 +344,7 @@ class TenantManager
                 throw new Error('Schema-based tenancy requires a SQL adapter');
             }
 
-            // Sanitize schema name — only allow alphanumerics and underscores
+            // Sanitize schema name - only allow alphanumerics and underscores
             if (!/^[a-zA-Z_][a-zA-Z0-9_]*$/.test(schema))
             {
                 throw new Error(`Invalid schema name: "${schema}"`);

package/lib/orm/views.js

@@ -293,7 +293,7 @@ class DatabaseView
         const descriptor = this._query.build();
         const table = descriptor.table;
 
-        // Validate field names and table — identifier-safe only
+        // Validate field names and table - identifier-safe only
         const idRe = /^[a-zA-Z_][a-zA-Z0-9_.*]*$/;
         const fields = descriptor.fields
             ? descriptor.fields.filter(f => idRe.test(f)).join(', ') || '*'

package/lib/router/index.js

@@ -298,56 +298,56 @@ class Router
     }
 
     /**
-     * @see Router#add — shortcut for GET requests.
+     * @see Router#add - shortcut for GET requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     get(path, ...fns) { const o = this._extractOpts(fns); this.add('GET', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for POST requests.
+     * @see Router#add - shortcut for POST requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     post(path, ...fns) { const o = this._extractOpts(fns); this.add('POST', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for PUT requests.
+     * @see Router#add - shortcut for PUT requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     put(path, ...fns) { const o = this._extractOpts(fns); this.add('PUT', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for DELETE requests.
+     * @see Router#add - shortcut for DELETE requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     delete(path, ...fns) { const o = this._extractOpts(fns); this.add('DELETE', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for PATCH requests.
+     * @see Router#add - shortcut for PATCH requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     patch(path, ...fns) { const o = this._extractOpts(fns); this.add('PATCH', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for OPTIONS requests.
+     * @see Router#add - shortcut for OPTIONS requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     options(path, ...fns) { const o = this._extractOpts(fns); this.add('OPTIONS', path, fns, o); return this; }
     /**
-     * @see Router#add — shortcut for HEAD requests.
+     * @see Router#add - shortcut for HEAD requests.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
      */
     head(path, ...fns) { const o = this._extractOpts(fns); this.add('HEAD', path, fns, o); return this; }
     /**
-     * @see Router#add — matches every HTTP method.
+     * @see Router#add - matches every HTTP method.
      * @param {string} path - Route pattern.
      * @param {...Function} fns - Handler functions.
      * @returns {Router} `this` for chaining.
@@ -355,7 +355,7 @@ class Router
     all(path, ...fns) { const o = this._extractOpts(fns); this.add('ALL', path, fns, o); return this; }
 
     /**
-     * Chainable route builder — register multiple methods on the same path.
+     * Chainable route builder - register multiple methods on the same path.
      *
      * @example
      *   router.route('/users')