@molecule/api-mock-server 1.0.0

package/dist/fixtures/seed.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Deterministic seeded PRNG for stable fixture generation.
+ * Uses Mulberry32 algorithm for fast, reproducible random numbers.
+ */
+/**
+ * Fixed "now" anchor (2026-04-01T12:00:00Z) for all generated dates.
+ *
+ * Dates are deliberately anchored to a constant instead of the wall clock so
+ * fixture output is byte-stable across runs (reliable screenshot diffs).
+ * Consequence: "recent"/"future" are relative to this anchor, not the real
+ * current time — never assert generated dates against `Date.now()`.
+ */
+export declare const FIXTURE_NOW: Date;
+/**
+ * Create a seeded random number generator using Mulberry32.
+ * Returns a function that produces numbers in [0, 1).
+ * @param seed - The seed value
+ * @returns A function that returns the next pseudo-random number
+ */
+export declare function createSeededRandom(seed: number): () => number;
+/**
+ * Derive a deterministic seed from an app type and endpoint path.
+ * The same app+path always produces the same seed, ensuring stable fixture output.
+ * @param appType - The application type (e.g. 'personal-finance')
+ * @param path - The endpoint path (e.g. '/accounts')
+ * @returns A numeric seed value
+ */
+export declare function seedFromPath(appType: string, path: string): number;
+/**
+ * Pick a random element from an array using the RNG.
+ * @param rng - The seeded random function
+ * @param arr - The array to pick from
+ * @returns A random element from the array
+ */
+export declare function pick<T>(rng: () => number, arr: readonly T[]): T;
+/**
+ * Pick a random integer in [min, max] inclusive.
+ * @param rng - The seeded random function
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @returns A random integer in the given range
+ */
+export declare function randomInt(rng: () => number, min: number, max: number): number;
+/**
+ * Generate a random dollar amount rounded to cents.
+ * @param rng - The seeded random function
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns A number rounded to 2 decimal places
+ */
+export declare function randomDollars(rng: () => number, min: number, max: number): number;
+/**
+ * Generate a "recent" ISO date string within the last N days of the fixed
+ * `FIXTURE_NOW` anchor (NOT the wall clock — see `FIXTURE_NOW`).
+ * @param rng - The seeded random function
+ * @param daysBack - Maximum days in the past (default 90)
+ * @returns An ISO date string
+ */
+export declare function recentDate(rng: () => number, daysBack?: number): string;
+/**
+ * Generate a UUID-like string from the RNG (not cryptographically secure).
+ * @param rng - The seeded random function
+ * @returns A UUID v4-like string
+ */
+export declare function seededUUID(rng: () => number): string;
+/**
+ * Generate a "future" ISO date string within the next N days of the fixed
+ * `FIXTURE_NOW` anchor (NOT the wall clock — see `FIXTURE_NOW`).
+ * @param rng - The seeded random function
+ * @param daysAhead - Maximum days in the future (default 365)
+ * @returns An ISO date string
+ */
+export declare function futureDate(rng: () => number, daysAhead?: number): string;
+//# sourceMappingURL=seed.d.ts.map

package/dist/fixtures/seed.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.d.ts","sourceRoot":"","sources":["../../src/fixtures/seed.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW,MAAmC,CAAA;AAE3D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,MAAM,CAQ7D;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CASlE;AAED;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,GAAG,CAAC,CAE/D;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,QAAQ,SAAK,GAAG,MAAM,CAGnE;AAED;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM,CASpD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,MAAM,EAAE,SAAS,SAAM,GAAG,MAAM,CAGrE"}

package/dist/fixtures/seed.js

@@ -0,0 +1,112 @@
+/**
+ * Deterministic seeded PRNG for stable fixture generation.
+ * Uses Mulberry32 algorithm for fast, reproducible random numbers.
+ */
+/**
+ * Fixed "now" anchor (2026-04-01T12:00:00Z) for all generated dates.
+ *
+ * Dates are deliberately anchored to a constant instead of the wall clock so
+ * fixture output is byte-stable across runs (reliable screenshot diffs).
+ * Consequence: "recent"/"future" are relative to this anchor, not the real
+ * current time — never assert generated dates against `Date.now()`.
+ */
+export const FIXTURE_NOW = new Date('2026-04-01T12:00:00Z');
+/**
+ * Create a seeded random number generator using Mulberry32.
+ * Returns a function that produces numbers in [0, 1).
+ * @param seed - The seed value
+ * @returns A function that returns the next pseudo-random number
+ */
+export function createSeededRandom(seed) {
+    let s = seed | 0;
+    return function mulberry32() {
+        s = (s + 0x6d2b79f5) | 0;
+        let t = Math.imul(s ^ (s >>> 15), 1 | s);
+        t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+        return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+    };
+}
+/**
+ * Derive a deterministic seed from an app type and endpoint path.
+ * The same app+path always produces the same seed, ensuring stable fixture output.
+ * @param appType - The application type (e.g. 'personal-finance')
+ * @param path - The endpoint path (e.g. '/accounts')
+ * @returns A numeric seed value
+ */
+export function seedFromPath(appType, path) {
+    const str = `${appType}:${path}`;
+    let hash = 0;
+    for (let i = 0; i < str.length; i++) {
+        const char = str.charCodeAt(i);
+        hash = ((hash << 5) - hash + char) | 0;
+    }
+    // Ensure positive
+    return hash >>> 0;
+}
+/**
+ * Pick a random element from an array using the RNG.
+ * @param rng - The seeded random function
+ * @param arr - The array to pick from
+ * @returns A random element from the array
+ */
+export function pick(rng, arr) {
+    return arr[Math.floor(rng() * arr.length)];
+}
+/**
+ * Pick a random integer in [min, max] inclusive.
+ * @param rng - The seeded random function
+ * @param min - Minimum value (inclusive)
+ * @param max - Maximum value (inclusive)
+ * @returns A random integer in the given range
+ */
+export function randomInt(rng, min, max) {
+    return Math.floor(rng() * (max - min + 1)) + min;
+}
+/**
+ * Generate a random dollar amount rounded to cents.
+ * @param rng - The seeded random function
+ * @param min - Minimum value
+ * @param max - Maximum value
+ * @returns A number rounded to 2 decimal places
+ */
+export function randomDollars(rng, min, max) {
+    return Math.round((rng() * (max - min) + min) * 100) / 100;
+}
+/**
+ * Generate a "recent" ISO date string within the last N days of the fixed
+ * `FIXTURE_NOW` anchor (NOT the wall clock — see `FIXTURE_NOW`).
+ * @param rng - The seeded random function
+ * @param daysBack - Maximum days in the past (default 90)
+ * @returns An ISO date string
+ */
+export function recentDate(rng, daysBack = 90) {
+    const offset = Math.floor(rng() * daysBack) * 24 * 60 * 60 * 1000;
+    return new Date(FIXTURE_NOW.getTime() - offset).toISOString();
+}
+/**
+ * Generate a UUID-like string from the RNG (not cryptographically secure).
+ * @param rng - The seeded random function
+ * @returns A UUID v4-like string
+ */
+export function seededUUID(rng) {
+    const hex = (n) => {
+        let result = '';
+        for (let i = 0; i < n; i++) {
+            result += Math.floor(rng() * 16).toString(16);
+        }
+        return result;
+    };
+    return `${hex(8)}-${hex(4)}-4${hex(3)}-${hex(1)}${hex(3)}-${hex(12)}`;
+}
+/**
+ * Generate a "future" ISO date string within the next N days of the fixed
+ * `FIXTURE_NOW` anchor (NOT the wall clock — see `FIXTURE_NOW`).
+ * @param rng - The seeded random function
+ * @param daysAhead - Maximum days in the future (default 365)
+ * @returns An ISO date string
+ */
+export function futureDate(rng, daysAhead = 365) {
+    const offset = Math.floor(rng() * daysAhead) * 24 * 60 * 60 * 1000;
+    return new Date(FIXTURE_NOW.getTime() + offset).toISOString();
+}
+//# sourceMappingURL=seed.js.map

package/dist/fixtures/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/fixtures/seed.ts"],"names":[],"mappings":"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"}

package/dist/fixtures/semantic-generator.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Field-name heuristic matching for generating realistic fixture values.
+ * Uses pattern matching on field names to select appropriate data generators.
+ */
+import type { SemanticRule } from '../types.js';
+/**
+ * Default semantic rules that match field names to realistic generators.
+ * Rules are checked in order; the first match wins.
+ */
+export declare const defaultSemanticRules: SemanticRule[];
+/**
+ * Apply semantic rules to generate a value for a given field name.
+ * @param fieldName - The name of the field to generate a value for
+ * @param rng - The seeded random function
+ * @param index - The item index (for cycling through pools)
+ * @param rules - Custom rules to apply (defaults to defaultSemanticRules)
+ * @returns The generated value, or undefined if no rule matched
+ */
+export declare function applySemanticRules(fieldName: string, rng: () => number, index: number, rules?: SemanticRule[]): unknown | undefined;
+//# sourceMappingURL=semantic-generator.d.ts.map

package/dist/fixtures/semantic-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"semantic-generator.d.ts","sourceRoot":"","sources":["../../src/fixtures/semantic-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAuR/C;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,YAAY,EAiQ9C,CAAA;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,GAAG,EAAE,MAAM,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,YAAY,EAAyB,GAC3C,OAAO,GAAG,SAAS,CAOrB"}