@zero-server/sdk 0.9.1 → 0.9.3

package/lib/orm/seed/index.js

@@ -1,18 +1,18 @@
-'use strict';
-
-/**
- * @module seed/index
- * @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
- */
-
-const { Fake }                   = require('./fake');
-const { Factory }                = require('./factory');
-const { Seeder, SeederRunner }   = require('./seeder');
-
-module.exports = { Fake, Factory, Seeder, SeederRunner };
+'use strict';
+
+/**
+ * @module seed/index
+ * @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
+ */
+
+const { Fake }                   = require('./fake');
+const { Factory }                = require('./factory');
+const { Seeder, SeederRunner }   = require('./seeder');
+
+module.exports = { Fake, Factory, Seeder, SeederRunner };

package/lib/orm/seed/rng.js

@@ -1,71 +1,71 @@
-'use strict';
-
-/**
- * @module seed/rng
- * @description Seeded PRNG (mulberry32) for reproducible fake data generation.
- *              When no seed is set, falls back to Math.random so default
- *              behaviour is indistinguishable from the original implementation.
- *
- * @example
- *   const { seed, rand } = require('./rng');
- *   seed(42);           // deterministic from here on
- *   rand();             // always the same sequence for seed 42
- *   seed(null);         // back to crypto-quality Math.random
- */
-
-/**
- * mulberry32 — minimal, high-quality 32-bit PRNG.
- * @param {number} s - Unsigned 32-bit integer seed.
- * @returns {() => number} Float in [0, 1).
- */
-function _mulberry32(s) {
-    s = s >>> 0;
-    return function () {
-        s += 0x6D2B79F5;
-        let t = s;
-        t = Math.imul(t ^ (t >>> 15), t | 1);
-        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
-        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
-    };
-}
-
-/** FNV-1a string → unsigned 32-bit integer. */
-function _hashString(str) {
-    let h = 0x811c9dc5;
-    for (let i = 0; i < str.length; i++) {
-        h ^= str.charCodeAt(i);
-        h = Math.imul(h, 0x01000193);
-    }
-    return h >>> 0;
-}
-
-let _rng  = Math.random.bind(Math);
-let _seed = null;
-
-/** Return a random float in [0, 1). */
-function rand() { return _rng(); }
-
-/**
- * Set a deterministic seed.  Pass `null` / `undefined` to reset to Math.random.
- *
+'use strict';
+
+/**
+ * @module seed/rng
+ * @description Seeded PRNG (mulberry32) for reproducible fake data generation.
+ *              When no seed is set, falls back to Math.random so default
+ *              behaviour is indistinguishable from the original implementation.
+ *
+ * @example
+ *   const { seed, rand } = require('./rng');
+ *   seed(42);           // deterministic from here on
+ *   rand();             // always the same sequence for seed 42
+ *   seed(null);         // back to crypto-quality Math.random
+ */
+
+/**
+ * mulberry32 — minimal, high-quality 32-bit PRNG.
+ * @param {number} s - Unsigned 32-bit integer seed.
+ * @returns {() => number} Float in [0, 1).
+ */
+function _mulberry32(s) {
+    s = s >>> 0;
+    return function () {
+        s += 0x6D2B79F5;
+        let t = s;
+        t = Math.imul(t ^ (t >>> 15), t | 1);
+        t ^= t + Math.imul(t ^ (t >>> 7), t | 61);
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+
+/** FNV-1a string → unsigned 32-bit integer. */
+function _hashString(str) {
+    let h = 0x811c9dc5;
+    for (let i = 0; i < str.length; i++) {
+        h ^= str.charCodeAt(i);
+        h = Math.imul(h, 0x01000193);
+    }
+    return h >>> 0;
+}
+
+let _rng  = Math.random.bind(Math);
+let _seed = null;
+
+/** Return a random float in [0, 1). */
+function rand() { return _rng(); }
+
+/**
+ * Set a deterministic seed.  Pass `null` / `undefined` to reset to Math.random.
+ *
  * @param {number|string|null} [value] - Value to set.
- * @returns {number|null} The numeric seed that was applied (or null if reset).
- */
-function seed(value) {
-    if (value === undefined || value === null) {
-        _rng  = Math.random.bind(Math);
-        _seed = null;
-    } else {
-        const n = typeof value === 'number'
-            ? (value >>> 0)
-            : _hashString(String(value));
-        _seed = n;
-        _rng  = _mulberry32(n);
-    }
-    return _seed;
-}
-
-/** @returns {number|null} Active numeric seed, or null when using Math.random. */
-function getSeed() { return _seed; }
-
-module.exports = { rand, seed, getSeed };
+ * @returns {number|null} The numeric seed that was applied (or null if reset).
+ */
+function seed(value) {
+    if (value === undefined || value === null) {
+        _rng  = Math.random.bind(Math);
+        _seed = null;
+    } else {
+        const n = typeof value === 'number'
+            ? (value >>> 0)
+            : _hashString(String(value));
+        _seed = n;
+        _rng  = _mulberry32(n);
+    }
+    return _seed;
+}
+
+/** @returns {number|null} Active numeric seed, or null when using Math.random. */
+function getSeed() { return _seed; }
+
+module.exports = { rand, seed, getSeed };

package/lib/orm/seed/seeder.js

@@ -1,125 +1,125 @@
-'use strict';
-
-/**
- * @module seed/seeder
- * @description Base Seeder class and SeederRunner for orchestrating database
- *              seeding operations.
- *
- * @example
- *   class UserSeeder extends Seeder {
- *       async run(db) {
- *           const factory = new Factory(User);
- *           factory.define({ name: () => Fake.fullName(), email: () => Fake.email() });
- *           await factory.count(50).create();
- *       }
- *   }
- *
- *   const runner = new SeederRunner(db);
- *   await runner.run(UserSeeder, PostSeeder);
- */
-
-const log = require('../../debug')('zero:seed');
-
-// ================================================================
-//  Seeder base class
-// ================================================================
-
-/**
- * Extend this class to create a seeder.  Override `run(db)` with your
- * seeding logic.
- */
-class Seeder
-{
-    /**
-     * Run the seeder.  Must be overridden in subclasses.
-     *
+'use strict';
+
+/**
+ * @module seed/seeder
+ * @description Base Seeder class and SeederRunner for orchestrating database
+ *              seeding operations.
+ *
+ * @example
+ *   class UserSeeder extends Seeder {
+ *       async run(db) {
+ *           const factory = new Factory(User);
+ *           factory.define({ name: () => Fake.fullName(), email: () => Fake.email() });
+ *           await factory.count(50).create();
+ *       }
+ *   }
+ *
+ *   const runner = new SeederRunner(db);
+ *   await runner.run(UserSeeder, PostSeeder);
+ */
+
+const log = require('../../debug')('zero:seed');
+
+// ================================================================
+//  Seeder base class
+// ================================================================
+
+/**
+ * Extend this class to create a seeder.  Override `run(db)` with your
+ * seeding logic.
+ */
+class Seeder
+{
+    /**
+     * Run the seeder.  Must be overridden in subclasses.
+     *
      * @param {import('../index').Database} db - Database instance.
-     * @returns {Promise<void>}
-     */
-    async run(db)  // eslint-disable-line no-unused-vars
-    {
-        throw new Error(`Seeder ${this.constructor.name}: run() is not implemented`);
-    }
-}
-
-// ================================================================
-//  SeederRunner
-// ================================================================
-
-/**
- * Orchestrates running one or more seeders against a database connection.
- *
- * @example
- *   const runner = new SeederRunner(db);
- *   await runner.run(UserSeeder, PostSeeder);
- *   await runner.call(UserSeeder);           // single seeder
- *   await runner.fresh(UserSeeder);          // clear then seed
- */
-class SeederRunner
-{
-    /**
-     * @constructor
-     * @param {import('../index').Database} db - Database connection instance.
-     */
-    constructor(db)
-    {
-        this._db = db;
-    }
-
-    /**
-     * Run one or more seeder classes (or instances) in order.
-     *
-     * @param {...(Function|Function[])} seeders - Seeder classes or instances.
-     * @returns {Promise<string[]>} Names of the seeders that ran.
-     */
-    async run(...seeders)
-    {
-        const flat  = seeders.flat();
-        const names = [];
-
-        for (const SeederClass of flat)
-        {
-            const instance = typeof SeederClass === 'function'
-                ? new SeederClass()
-                : SeederClass;
-
-            const name = instance.constructor.name || 'AnonymousSeeder';
-            log('Seeding: %s', name);
-
-            await instance.run(this._db);
-            names.push(name);
-
-            log('Seeded:  %s', name);
-        }
-
-        return names;
-    }
-
-    /**
-     * Run a single seeder class or instance.
-     *
-     * @param {Function} SeederClass - Seeder class or instance to run.
-     * @returns {Promise<void>}
-     */
-    async call(SeederClass)
-    {
-        await this.run(SeederClass);
-    }
-
-    /**
-     * Clear all adapter data then run the provided seeders.
-     * Works with adapters that expose a `clear()` method (memory, json, redis).
-     *
-     * @param {...Function} seeders - Seeder classes to run after clearing.
-     * @returns {Promise<string[]>} Names of the seeders that ran.
-     */
-    async fresh(...seeders)
-    {
-        if (typeof this._db.adapter.clear === 'function')
-            await this._db.adapter.clear();
-
-        return this.run(...seeders);
-    }
-}
-
-module.exports = { Seeder, SeederRunner };
+     * @returns {Promise<void>}
+     */
+    async run(db)  // eslint-disable-line no-unused-vars
+    {
+        throw new Error(`Seeder ${this.constructor.name}: run() is not implemented`);
+    }
+}
+
+// ================================================================
+//  SeederRunner
+// ================================================================
+
+/**
+ * Orchestrates running one or more seeders against a database connection.
+ *
+ * @example
+ *   const runner = new SeederRunner(db);
+ *   await runner.run(UserSeeder, PostSeeder);
+ *   await runner.call(UserSeeder);           // single seeder
+ *   await runner.fresh(UserSeeder);          // clear then seed
+ */
+class SeederRunner
+{
+    /**
+     * @constructor
+     * @param {import('../index').Database} db - Database connection instance.
+     */
+    constructor(db)
+    {
+        this._db = db;
+    }
+
+    /**
+     * Run one or more seeder classes (or instances) in order.
+     *
+     * @param {...(Function|Function[])} seeders - Seeder classes or instances.
+     * @returns {Promise<string[]>} Names of the seeders that ran.
+     */
+    async run(...seeders)
+    {
+        const flat  = seeders.flat();
+        const names = [];
+
+        for (const SeederClass of flat)
+        {
+            const instance = typeof SeederClass === 'function'
+                ? new SeederClass()
+                : SeederClass;
+
+            const name = instance.constructor.name || 'AnonymousSeeder';
+            log('Seeding: %s', name);
+
+            await instance.run(this._db);
+            names.push(name);
+
+            log('Seeded:  %s', name);
+        }
+
+        return names;
+    }
+
+    /**
+     * Run a single seeder class or instance.
+     *
+     * @param {Function} SeederClass - Seeder class or instance to run.
+     * @returns {Promise<void>}
+     */
+    async call(SeederClass)
+    {
+        await this.run(SeederClass);
+    }
+
+    /**
+     * Clear all adapter data then run the provided seeders.
+     * Works with adapters that expose a `clear()` method (memory, json, redis).
+     *
+     * @param {...Function} seeders - Seeder classes to run after clearing.
+     * @returns {Promise<string[]>} Names of the seeders that ran.
+     */
+    async fresh(...seeders)
+    {
+        if (typeof this._db.adapter.clear === 'function')
+            await this._db.adapter.clear();
+
+        return this.run(...seeders);
+    }
+}
+
+module.exports = { Seeder, SeederRunner };

package/lib/orm/seed/unique.js

@@ -1,68 +1,68 @@
-'use strict';
-
-/**
- * @module seed/unique
- * @description Per-namespace deduplication tracker used by `Fake.unique()`.
- *              Keeps a `Set` of already-returned values per key and retries
- *              the generator until a fresh value is produced.
- */
-
-const DEFAULT_MAX_ATTEMPTS = 1000;
-
-/**
- * Tracks generated values per namespace so callers can guarantee uniqueness
- * within a seeding session without maintaining external state.
- */
-class UniqueTracker {
-    constructor() {
-        /** @type {Map<string, Set<any>>} */
-        this._store = new Map();
-    }
-
-    /**
-     * Call `fn()` repeatedly until it returns a value not yet seen under `key`.
-     *
-     * @param {string}   key            - Uniqueness namespace (e.g. `'email'`).
-     * @param {() => any} fn            - Value generator.
-     * @param {number}   [maxAttempts]  - Give up after this many retries.
-     * @returns {any} The unique generated value.
-     * @throws {Error} When the generator pool is exhausted.
-     */
-    generate(key, fn, maxAttempts = DEFAULT_MAX_ATTEMPTS) {
-        if (!this._store.has(key)) this._store.set(key, new Set());
-        const seen = this._store.get(key);
-
-        for (let i = 0; i < maxAttempts; i++) {
-            const val = fn();
-            if (!seen.has(val)) {
-                seen.add(val);
-                return val;
-            }
-        }
-
-        throw new Error(
-            `Fake.unique: exhausted ${maxAttempts} attempts for key "${key}". ` +
-            `The data pool may be too small. Call Fake.resetUnique("${key}") to start fresh.`
-        );
-    }
-
-    /**
-     * Clear uniqueness tracking.
-     * @param {string} [key] - Clear only this namespace, or all if omitted.
-     */
-    reset(key) {
-        if (key !== undefined) this._store.delete(key);
-        else this._store.clear();
-    }
-
-    /**
-     * How many unique values have been generated for a namespace.
-     * @param {string} key - Cache or storage key.
-     * @returns {number} Count of unique values tracked for the key.
-     */
-    seen(key) {
-        return this._store.has(key) ? this._store.get(key).size : 0;
-    }
-}
-
-module.exports = { UniqueTracker };
+'use strict';
+
+/**
+ * @module seed/unique
+ * @description Per-namespace deduplication tracker used by `Fake.unique()`.
+ *              Keeps a `Set` of already-returned values per key and retries
+ *              the generator until a fresh value is produced.
+ */
+
+const DEFAULT_MAX_ATTEMPTS = 1000;
+
+/**
+ * Tracks generated values per namespace so callers can guarantee uniqueness
+ * within a seeding session without maintaining external state.
+ */
+class UniqueTracker {
+    constructor() {
+        /** @type {Map<string, Set<any>>} */
+        this._store = new Map();
+    }
+
+    /**
+     * Call `fn()` repeatedly until it returns a value not yet seen under `key`.
+     *
+     * @param {string}   key            - Uniqueness namespace (e.g. `'email'`).
+     * @param {() => any} fn            - Value generator.
+     * @param {number}   [maxAttempts]  - Give up after this many retries.
+     * @returns {any} The unique generated value.
+     * @throws {Error} When the generator pool is exhausted.
+     */
+    generate(key, fn, maxAttempts = DEFAULT_MAX_ATTEMPTS) {
+        if (!this._store.has(key)) this._store.set(key, new Set());
+        const seen = this._store.get(key);
+
+        for (let i = 0; i < maxAttempts; i++) {
+            const val = fn();
+            if (!seen.has(val)) {
+                seen.add(val);
+                return val;
+            }
+        }
+
+        throw new Error(
+            `Fake.unique: exhausted ${maxAttempts} attempts for key "${key}". ` +
+            `The data pool may be too small. Call Fake.resetUnique("${key}") to start fresh.`
+        );
+    }
+
+    /**
+     * Clear uniqueness tracking.
+     * @param {string} [key] - Clear only this namespace, or all if omitted.
+     */
+    reset(key) {
+        if (key !== undefined) this._store.delete(key);
+        else this._store.clear();
+    }
+
+    /**
+     * How many unique values have been generated for a namespace.
+     * @param {string} key - Cache or storage key.
+     * @returns {number} Count of unique values tracked for the key.
+     */
+    seen(key) {
+        return this._store.has(key) ? this._store.get(key).size : 0;
+    }
+}
+
+module.exports = { UniqueTracker };