@nifrajs/mock 1.4.0

package/dist/index.d.ts

@@ -0,0 +1,57 @@
+/**
+ * `@nifrajs/mock` — contract-based mock server.
+ *
+ * Reads a Nifra app's registered routes and their Standard Schema / JSON Schema
+ * response definitions, then generates fake responses from supported JSON Schema keywords. Use it
+ * for frontend-first development, agent testing, or CI smoke tests.
+ */
+export declare class UnsupportedMockSchemaError extends Error {
+    readonly keyword: string;
+    constructor(keyword: string, message: string);
+}
+/**
+ * Generate a mock value from a schema object. Inspects JSON Schema properties
+ * (`type`, `properties`, `items`, `enum`, `format`) that TypeBox / NifraSchema
+ * objects carry directly. Unsupported constraints fail closed with
+ * {@link UnsupportedMockSchemaError} rather than returning a known-invalid response.
+ *
+ * @param schema  A JSON-Schema-shaped object (TypeBox, NifraSchema, or raw JSON Schema)
+ * @param fieldName  Optional field name hint for generating contextual string values
+ * @param rng  Optional seeded random function for deterministic output
+ */
+export declare function generateMockValue(schema: unknown, fieldName?: string | undefined, rng?: (() => number) | undefined): unknown;
+/** Minimal route shape returned by `app.routes()`. */
+export interface MockableRoute {
+    readonly method: string;
+    readonly path: string;
+    readonly schema?: {
+        readonly response?: unknown;
+    } | undefined;
+}
+/** App shape — anything with a `routes()` method. */
+export interface MockableApp {
+    routes(): readonly MockableRoute[];
+}
+export interface MockServerOptions {
+    /** Seed for deterministic mock generation. */
+    readonly seed?: number | undefined;
+    /** Log mock requests to console. */
+    readonly verbose?: boolean | undefined;
+}
+export interface MockServer {
+    /** Handle a request against the mock routes. */
+    fetch(request: Request): Promise<Response>;
+    /** The generated mock routes for inspection. */
+    readonly mockRoutes: ReadonlyArray<{
+        method: string;
+        path: string;
+    }>;
+}
+/**
+ * Create a mock server from a Nifra app's route definitions. For each route
+ * with a `schema.response`, generates a handler returning fake data that
+ * matches the response schema structure. Routes without response schemas
+ * return `{}`.
+ */
+export declare function createMockServer(app: MockableApp, options?: MockServerOptions | undefined): MockServer;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAsBH,qBAAa,0BAA2B,SAAQ,KAAK;IAEjD,QAAQ,CAAC,OAAO,EAAE,MAAM;gBAAf,OAAO,EAAE,MAAM,EACxB,OAAO,EAAE,MAAM;CAKlB;AAwDD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,OAAO,EACf,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,EAC9B,GAAG,CAAC,EAAE,CAAC,MAAM,MAAM,CAAC,GAAG,SAAS,GAC/B,OAAO,CAmJT;AAMD,sDAAsD;AACtD,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,CAAC,EACZ;QACE,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAC5B,GACD,SAAS,CAAA;CACd;AAED,qDAAqD;AACrD,MAAM,WAAW,WAAW;IAC1B,MAAM,IAAI,SAAS,aAAa,EAAE,CAAA;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IAClC,oCAAoC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;CACvC;AAED,MAAM,WAAW,UAAU;IACzB,gDAAgD;IAChD,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC1C,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CACrE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,WAAW,EAChB,OAAO,CAAC,EAAE,iBAAiB,GAAG,SAAS,GACtC,UAAU,CAgEZ"}

package/dist/index.js

@@ -0,0 +1,303 @@
+/**
+ * `@nifrajs/mock` — contract-based mock server.
+ *
+ * Reads a Nifra app's registered routes and their Standard Schema / JSON Schema
+ * response definitions, then generates fake responses from supported JSON Schema keywords. Use it
+ * for frontend-first development, agent testing, or CI smoke tests.
+ */
+import { reflectRoutes, reflectSchema } from "@nifrajs/core/reflection";
+// ---------------------------------------------------------------------------
+// Seeded PRNG (deterministic mocks)
+// ---------------------------------------------------------------------------
+function seededRandom(seed) {
+    let s = seed;
+    return () => {
+        s = (s * 1664525 + 1013904223) & 0x7fffffff;
+        // Divide by 2^31 (not 2^31 - 1) so the result stays strictly below 1 and never
+        // produces an out-of-range index when scaled by an array length.
+        return s / 0x80000000;
+    };
+}
+/** Clamp a `rand() * length` index so an inclusive-range rng cannot index past the end. */
+const randomIndex = (rand, length) => Math.min(Math.floor(rand() * length), length - 1);
+export class UnsupportedMockSchemaError extends Error {
+    keyword;
+    constructor(keyword, message) {
+        super(message);
+        this.keyword = keyword;
+        this.name = "UnsupportedMockSchemaError";
+    }
+}
+function numericBounds(schema) {
+    const minimum = typeof schema.minimum === "number" ? schema.minimum : 0;
+    const maximum = typeof schema.maximum === "number" ? schema.maximum : 100;
+    const exclusiveMinimum = typeof schema.exclusiveMinimum === "number" ? schema.exclusiveMinimum : undefined;
+    const exclusiveMaximum = typeof schema.exclusiveMaximum === "number" ? schema.exclusiveMaximum : undefined;
+    const min = exclusiveMinimum === undefined ? minimum : Math.max(minimum, exclusiveMinimum + Number.EPSILON);
+    const max = exclusiveMaximum === undefined ? maximum : Math.min(maximum, exclusiveMaximum - Number.EPSILON);
+    if (min > max)
+        throw new UnsupportedMockSchemaError("minimum", "Numeric schema has no satisfiable range");
+    return { min, max };
+}
+function constrainedString(schema, initial, fieldName) {
+    const minLength = typeof schema.minLength === "number" ? schema.minLength : 0;
+    const maxLength = typeof schema.maxLength === "number" ? schema.maxLength : Number.POSITIVE_INFINITY;
+    if (minLength > maxLength) {
+        throw new UnsupportedMockSchemaError("minLength", "String schema has no satisfiable length");
+    }
+    const candidates = [
+        initial,
+        fieldName ?? "mock",
+        "mock_value",
+        "test",
+        "abc",
+        "123",
+        "A1",
+        "https://example.com",
+        "test@example.com",
+    ];
+    const pattern = typeof schema.pattern === "string" ? new RegExp(schema.pattern) : undefined;
+    for (const candidate of candidates) {
+        const padded = candidate.length < minLength ? candidate.padEnd(minLength, "a") : candidate;
+        const value = padded.slice(0, maxLength);
+        if (value.length >= minLength && (pattern === undefined || pattern.test(value)))
+            return value;
+    }
+    throw new UnsupportedMockSchemaError("pattern", `Cannot generate a value for pattern ${JSON.stringify(schema.pattern)}`);
+}
+// ---------------------------------------------------------------------------
+// Schema introspection → mock value generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate a mock value from a schema object. Inspects JSON Schema properties
+ * (`type`, `properties`, `items`, `enum`, `format`) that TypeBox / NifraSchema
+ * objects carry directly. Unsupported constraints fail closed with
+ * {@link UnsupportedMockSchemaError} rather than returning a known-invalid response.
+ *
+ * @param schema  A JSON-Schema-shaped object (TypeBox, NifraSchema, or raw JSON Schema)
+ * @param fieldName  Optional field name hint for generating contextual string values
+ * @param rng  Optional seeded random function for deterministic output
+ */
+export function generateMockValue(schema, fieldName, rng) {
+    const rand = rng ?? Math.random;
+    const reflected = reflectSchema(schema).jsonSchema;
+    if (reflected === true || reflected === undefined)
+        return {};
+    if (reflected === false) {
+        throw new UnsupportedMockSchemaError("false", "Boolean false schema has no valid value");
+    }
+    const raw = reflected;
+    if ("const" in raw)
+        return raw.const;
+    if (raw.$ref !== undefined) {
+        throw new UnsupportedMockSchemaError("$ref", "Resolve JSON Schema references before generating mocks");
+    }
+    if (raw.not !== undefined) {
+        throw new UnsupportedMockSchemaError("not", "JSON Schema `not` generation is unsupported");
+    }
+    if (raw.oneOf !== undefined) {
+        throw new UnsupportedMockSchemaError("oneOf", "Exclusive union generation requires a schema validator");
+    }
+    const alternatives = raw.anyOf;
+    if (Array.isArray(alternatives) && alternatives.length > 0) {
+        return generateMockValue(alternatives[randomIndex(rand, alternatives.length)], fieldName, rand);
+    }
+    const intersections = raw.allOf;
+    if (Array.isArray(intersections) && intersections.length > 0) {
+        const values = intersections.map((part) => generateMockValue(part, fieldName, rand));
+        if (values.every((value) => value !== null && typeof value === "object" && !Array.isArray(value))) {
+            return Object.assign({}, ...values);
+        }
+        const first = values[0];
+        if (values.every((value) => Object.is(value, first)))
+            return first;
+        throw new UnsupportedMockSchemaError("allOf", "Could not prove that a scalar satisfies every intersection branch");
+    }
+    // Enum — pick the first value (deterministic) or random
+    const enumValues = raw.enum;
+    if (enumValues && Array.isArray(enumValues) && enumValues.length > 0) {
+        return enumValues[randomIndex(rand, enumValues.length)];
+    }
+    const declaredType = raw.type;
+    const type = Array.isArray(declaredType)
+        ? (declaredType.find((candidate) => candidate !== "null") ?? "null")
+        : declaredType;
+    switch (type) {
+        case "string": {
+            const format = raw.format;
+            switch (format) {
+                case "email":
+                    return constrainedString(raw, `mock@${fieldName ?? "example"}.com`, fieldName);
+                case "uri":
+                case "url":
+                    return constrainedString(raw, `https://${fieldName ?? "example"}.mock.dev`, fieldName);
+                case "date":
+                    return constrainedString(raw, "2025-01-15", fieldName);
+                case "date-time":
+                    return constrainedString(raw, "2025-01-15T12:00:00.000Z", fieldName);
+                case "uuid":
+                    return constrainedString(raw, "00000000-0000-4000-8000-000000000001", fieldName);
+                default:
+                    return constrainedString(raw, `mock_${fieldName ?? "value"}`, fieldName);
+            }
+        }
+        case "number": {
+            const { min, max } = numericBounds(raw);
+            const multipleOf = typeof raw.multipleOf === "number" ? raw.multipleOf : undefined;
+            if (multipleOf !== undefined && multipleOf <= 0) {
+                throw new UnsupportedMockSchemaError("multipleOf", "multipleOf must be positive");
+            }
+            if (multipleOf !== undefined) {
+                const first = Math.ceil(min / multipleOf) * multipleOf;
+                const last = Math.floor(max / multipleOf) * multipleOf;
+                if (first > last)
+                    throw new UnsupportedMockSchemaError("multipleOf", "No multiple exists in range");
+                const steps = Math.floor((last - first) / multipleOf);
+                return first + Math.floor(rand() * (steps + 1)) * multipleOf;
+            }
+            return Math.round((min + rand() * (max - min)) * 100) / 100;
+        }
+        case "integer": {
+            const { min, max } = numericBounds(raw);
+            const multipleOf = typeof raw.multipleOf === "number" ? raw.multipleOf : 1;
+            const first = Math.ceil(min / multipleOf) * multipleOf;
+            const last = Math.floor(max / multipleOf) * multipleOf;
+            if (first > last)
+                throw new UnsupportedMockSchemaError("integer", "No integer exists in range");
+            const steps = Math.floor((last - first) / multipleOf);
+            return first + Math.floor(rand() * (steps + 1)) * multipleOf;
+        }
+        case "boolean":
+            return true;
+        case "null":
+            return null;
+        case "array": {
+            const items = raw.items;
+            if (!items)
+                return [];
+            const minItems = typeof raw.minItems === "number" ? raw.minItems : 1;
+            const maxItems = typeof raw.maxItems === "number" ? raw.maxItems : Math.max(minItems, 3);
+            if (minItems > maxItems) {
+                throw new UnsupportedMockSchemaError("minItems", "Array schema has no satisfiable length");
+            }
+            const count = minItems + Math.floor(rand() * (maxItems - minItems + 1));
+            const result = [];
+            for (let i = 0; i < count; i++) {
+                result.push(generateMockValue(items, `${fieldName ?? "item"}_${i}`, rand));
+            }
+            if (raw.uniqueItems === true &&
+                new Set(result.map((value) => JSON.stringify(value))).size !== result.length) {
+                throw new UnsupportedMockSchemaError("uniqueItems", "Could not generate enough unique items");
+            }
+            return result;
+        }
+        default: {
+            const properties = raw.properties;
+            if (!properties || typeof properties !== "object")
+                return {};
+            const result = {};
+            for (const [key, propSchema] of Object.entries(properties)) {
+                result[key] = generateMockValue(propSchema, key, rand);
+            }
+            return result;
+        }
+    }
+}
+/**
+ * Create a mock server from a Nifra app's route definitions. For each route
+ * with a `schema.response`, generates a handler returning fake data that
+ * matches the response schema structure. Routes without response schemas
+ * return `{}`.
+ */
+export function createMockServer(app, options) {
+    const seed = options?.seed ?? 42;
+    const verbose = options?.verbose ?? false;
+    const routes = reflectRoutes(app);
+    // Pre-generate mock responses for each route
+    const mockMap = new Map();
+    const mockRoutes = [];
+    for (const route of routes) {
+        const key = `${route.method.toUpperCase()} ${route.path}`;
+        const rng = seededRandom(seed);
+        const responseSchema = route.schema?.response?.jsonSchema;
+        const mockValue = responseSchema ? generateMockValue(responseSchema, undefined, rng) : {};
+        mockMap.set(key, mockValue);
+        mockRoutes.push({ method: route.method.toUpperCase(), path: route.path });
+    }
+    return {
+        mockRoutes,
+        async fetch(request) {
+            const url = new URL(request.url);
+            const method = request.method.toUpperCase();
+            const pathname = url.pathname;
+            // Exact match first
+            const exactKey = `${method} ${pathname}`;
+            if (mockMap.has(exactKey)) {
+                if (verbose)
+                    console.log(`[mock] ${exactKey} → 200`);
+                return new Response(JSON.stringify(mockMap.get(exactKey)), {
+                    status: 200,
+                    headers: {
+                        "content-type": "application/json",
+                        "x-nifra-mock": "true",
+                    },
+                });
+            }
+            // Try matching parameterized routes (e.g. /users/:id → /users/123)
+            for (const [key, value] of mockMap) {
+                const [routeMethod, routePath] = key.split(" ", 2);
+                if (routeMethod !== method || !routePath)
+                    continue;
+                if (matchParameterizedPath(routePath, pathname)) {
+                    if (verbose)
+                        console.log(`[mock] ${method} ${pathname} → ${routePath} → 200`);
+                    return new Response(JSON.stringify(value), {
+                        status: 200,
+                        headers: {
+                            "content-type": "application/json",
+                            "x-nifra-mock": "true",
+                        },
+                    });
+                }
+            }
+            if (verbose)
+                console.log(`[mock] ${method} ${pathname} → 404`);
+            return new Response(JSON.stringify({ error: "Not Found", mock: true }), {
+                status: 404,
+                headers: { "content-type": "application/json", "x-nifra-mock": "true" },
+            });
+        },
+    };
+}
+/**
+ * Match a parameterized route pattern (e.g. `/users/:id`) against a concrete pathname.
+ * Supports non-empty `:param` segments and Nifra's trailing `*wildcard` segment.
+ */
+function matchParameterizedPath(pattern, pathname) {
+    const patternParts = pattern.split("/");
+    const pathParts = pathname.split("/");
+    const wildcardIndex = patternParts.findIndex((part) => part.startsWith("*"));
+    if (wildcardIndex === -1 && patternParts.length !== pathParts.length)
+        return false;
+    if (wildcardIndex !== -1 && wildcardIndex !== patternParts.length - 1)
+        return false;
+    if (wildcardIndex !== -1 && pathParts.length < wildcardIndex + 1)
+        return false;
+    for (let i = 0; i < patternParts.length; i++) {
+        const pp = patternParts[i];
+        const actual = pathParts[i];
+        if (pp === undefined || actual === undefined)
+            return false;
+        if (pp.startsWith("*"))
+            return true;
+        if (pp.startsWith(":")) {
+            if (actual.length === 0)
+                return false;
+            continue;
+        }
+        if (pp !== actual)
+            return false;
+    }
+    return true;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@nifrajs/mock",
+  "version": "1.4.0",
+  "description": "Contract-based mock server — reads route schemas and generates fake responses.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "bun": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && bun run ../../scripts/fix-dts.ts dist"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@nifrajs/core": "1.4.0"
+  }
+}

package/src/index.ts

@@ -0,0 +1,391 @@
+/**
+ * `@nifrajs/mock` — contract-based mock server.
+ *
+ * Reads a Nifra app's registered routes and their Standard Schema / JSON Schema
+ * response definitions, then generates fake responses from supported JSON Schema keywords. Use it
+ * for frontend-first development, agent testing, or CI smoke tests.
+ */
+
+import { reflectRoutes, reflectSchema } from "@nifrajs/core/reflection"
+
+// ---------------------------------------------------------------------------
+// Seeded PRNG (deterministic mocks)
+// ---------------------------------------------------------------------------
+
+function seededRandom(seed: number): () => number {
+  let s = seed
+  return () => {
+    s = (s * 1664525 + 1013904223) & 0x7fffffff
+    // Divide by 2^31 (not 2^31 - 1) so the result stays strictly below 1 and never
+    // produces an out-of-range index when scaled by an array length.
+    return s / 0x80000000
+  }
+}
+
+/** Clamp a `rand() * length` index so an inclusive-range rng cannot index past the end. */
+const randomIndex = (rand: () => number, length: number): number =>
+  Math.min(Math.floor(rand() * length), length - 1)
+
+export class UnsupportedMockSchemaError extends Error {
+  constructor(
+    readonly keyword: string,
+    message: string,
+  ) {
+    super(message)
+    this.name = "UnsupportedMockSchemaError"
+  }
+}
+
+function numericBounds(schema: Record<string, unknown>): { min: number; max: number } {
+  const minimum = typeof schema.minimum === "number" ? schema.minimum : 0
+  const maximum = typeof schema.maximum === "number" ? schema.maximum : 100
+  const exclusiveMinimum =
+    typeof schema.exclusiveMinimum === "number" ? schema.exclusiveMinimum : undefined
+  const exclusiveMaximum =
+    typeof schema.exclusiveMaximum === "number" ? schema.exclusiveMaximum : undefined
+  const min =
+    exclusiveMinimum === undefined ? minimum : Math.max(minimum, exclusiveMinimum + Number.EPSILON)
+  const max =
+    exclusiveMaximum === undefined ? maximum : Math.min(maximum, exclusiveMaximum - Number.EPSILON)
+  if (min > max)
+    throw new UnsupportedMockSchemaError("minimum", "Numeric schema has no satisfiable range")
+  return { min, max }
+}
+
+function constrainedString(
+  schema: Record<string, unknown>,
+  initial: string,
+  fieldName: string | undefined,
+): string {
+  const minLength = typeof schema.minLength === "number" ? schema.minLength : 0
+  const maxLength =
+    typeof schema.maxLength === "number" ? schema.maxLength : Number.POSITIVE_INFINITY
+  if (minLength > maxLength) {
+    throw new UnsupportedMockSchemaError("minLength", "String schema has no satisfiable length")
+  }
+  const candidates = [
+    initial,
+    fieldName ?? "mock",
+    "mock_value",
+    "test",
+    "abc",
+    "123",
+    "A1",
+    "https://example.com",
+    "test@example.com",
+  ]
+  const pattern = typeof schema.pattern === "string" ? new RegExp(schema.pattern) : undefined
+  for (const candidate of candidates) {
+    const padded = candidate.length < minLength ? candidate.padEnd(minLength, "a") : candidate
+    const value = padded.slice(0, maxLength)
+    if (value.length >= minLength && (pattern === undefined || pattern.test(value))) return value
+  }
+  throw new UnsupportedMockSchemaError(
+    "pattern",
+    `Cannot generate a value for pattern ${JSON.stringify(schema.pattern)}`,
+  )
+}
+
+// ---------------------------------------------------------------------------
+// Schema introspection → mock value generation
+// ---------------------------------------------------------------------------
+
+/**
+ * Generate a mock value from a schema object. Inspects JSON Schema properties
+ * (`type`, `properties`, `items`, `enum`, `format`) that TypeBox / NifraSchema
+ * objects carry directly. Unsupported constraints fail closed with
+ * {@link UnsupportedMockSchemaError} rather than returning a known-invalid response.
+ *
+ * @param schema  A JSON-Schema-shaped object (TypeBox, NifraSchema, or raw JSON Schema)
+ * @param fieldName  Optional field name hint for generating contextual string values
+ * @param rng  Optional seeded random function for deterministic output
+ */
+export function generateMockValue(
+  schema: unknown,
+  fieldName?: string | undefined,
+  rng?: (() => number) | undefined,
+): unknown {
+  const rand = rng ?? Math.random
+
+  const reflected = reflectSchema(schema).jsonSchema
+  if (reflected === true || reflected === undefined) return {}
+  if (reflected === false) {
+    throw new UnsupportedMockSchemaError("false", "Boolean false schema has no valid value")
+  }
+  const raw = reflected
+
+  if ("const" in raw) return raw.const
+  if (raw.$ref !== undefined) {
+    throw new UnsupportedMockSchemaError(
+      "$ref",
+      "Resolve JSON Schema references before generating mocks",
+    )
+  }
+  if (raw.not !== undefined) {
+    throw new UnsupportedMockSchemaError("not", "JSON Schema `not` generation is unsupported")
+  }
+  if (raw.oneOf !== undefined) {
+    throw new UnsupportedMockSchemaError(
+      "oneOf",
+      "Exclusive union generation requires a schema validator",
+    )
+  }
+  const alternatives = raw.anyOf as readonly unknown[] | undefined
+  if (Array.isArray(alternatives) && alternatives.length > 0) {
+    return generateMockValue(alternatives[randomIndex(rand, alternatives.length)], fieldName, rand)
+  }
+  const intersections = raw.allOf as readonly unknown[] | undefined
+  if (Array.isArray(intersections) && intersections.length > 0) {
+    const values = intersections.map((part) => generateMockValue(part, fieldName, rand))
+    if (
+      values.every((value) => value !== null && typeof value === "object" && !Array.isArray(value))
+    ) {
+      return Object.assign({}, ...values)
+    }
+    const first = values[0]
+    if (values.every((value) => Object.is(value, first))) return first
+    throw new UnsupportedMockSchemaError(
+      "allOf",
+      "Could not prove that a scalar satisfies every intersection branch",
+    )
+  }
+
+  // Enum — pick the first value (deterministic) or random
+  const enumValues = raw.enum as readonly unknown[] | undefined
+  if (enumValues && Array.isArray(enumValues) && enumValues.length > 0) {
+    return enumValues[randomIndex(rand, enumValues.length)]
+  }
+
+  const declaredType = raw.type as string | readonly string[] | undefined
+  const type = Array.isArray(declaredType)
+    ? (declaredType.find((candidate) => candidate !== "null") ?? "null")
+    : declaredType
+
+  switch (type) {
+    case "string": {
+      const format = raw.format as string | undefined
+      switch (format) {
+        case "email":
+          return constrainedString(raw, `mock@${fieldName ?? "example"}.com`, fieldName)
+        case "uri":
+        case "url":
+          return constrainedString(raw, `https://${fieldName ?? "example"}.mock.dev`, fieldName)
+        case "date":
+          return constrainedString(raw, "2025-01-15", fieldName)
+        case "date-time":
+          return constrainedString(raw, "2025-01-15T12:00:00.000Z", fieldName)
+        case "uuid":
+          return constrainedString(raw, "00000000-0000-4000-8000-000000000001", fieldName)
+        default:
+          return constrainedString(raw, `mock_${fieldName ?? "value"}`, fieldName)
+      }
+    }
+
+    case "number": {
+      const { min, max } = numericBounds(raw)
+      const multipleOf = typeof raw.multipleOf === "number" ? raw.multipleOf : undefined
+      if (multipleOf !== undefined && multipleOf <= 0) {
+        throw new UnsupportedMockSchemaError("multipleOf", "multipleOf must be positive")
+      }
+      if (multipleOf !== undefined) {
+        const first = Math.ceil(min / multipleOf) * multipleOf
+        const last = Math.floor(max / multipleOf) * multipleOf
+        if (first > last)
+          throw new UnsupportedMockSchemaError("multipleOf", "No multiple exists in range")
+        const steps = Math.floor((last - first) / multipleOf)
+        return first + Math.floor(rand() * (steps + 1)) * multipleOf
+      }
+      return Math.round((min + rand() * (max - min)) * 100) / 100
+    }
+
+    case "integer": {
+      const { min, max } = numericBounds(raw)
+      const multipleOf = typeof raw.multipleOf === "number" ? raw.multipleOf : 1
+      const first = Math.ceil(min / multipleOf) * multipleOf
+      const last = Math.floor(max / multipleOf) * multipleOf
+      if (first > last)
+        throw new UnsupportedMockSchemaError("integer", "No integer exists in range")
+      const steps = Math.floor((last - first) / multipleOf)
+      return first + Math.floor(rand() * (steps + 1)) * multipleOf
+    }
+
+    case "boolean":
+      return true
+
+    case "null":
+      return null
+
+    case "array": {
+      const items = raw.items as Record<string, unknown> | undefined
+      if (!items) return []
+      const minItems = typeof raw.minItems === "number" ? raw.minItems : 1
+      const maxItems = typeof raw.maxItems === "number" ? raw.maxItems : Math.max(minItems, 3)
+      if (minItems > maxItems) {
+        throw new UnsupportedMockSchemaError("minItems", "Array schema has no satisfiable length")
+      }
+      const count = minItems + Math.floor(rand() * (maxItems - minItems + 1))
+      const result: unknown[] = []
+      for (let i = 0; i < count; i++) {
+        result.push(generateMockValue(items, `${fieldName ?? "item"}_${i}`, rand))
+      }
+      if (
+        raw.uniqueItems === true &&
+        new Set(result.map((value) => JSON.stringify(value))).size !== result.length
+      ) {
+        throw new UnsupportedMockSchemaError(
+          "uniqueItems",
+          "Could not generate enough unique items",
+        )
+      }
+      return result
+    }
+
+    default: {
+      const properties = raw.properties as Record<string, Record<string, unknown>> | undefined
+      if (!properties || typeof properties !== "object") return {}
+
+      const result: Record<string, unknown> = {}
+      for (const [key, propSchema] of Object.entries(properties)) {
+        result[key] = generateMockValue(propSchema, key, rand)
+      }
+      return result
+    }
+  }
+}
+
+// ---------------------------------------------------------------------------
+// Mock server
+// ---------------------------------------------------------------------------
+
+/** Minimal route shape returned by `app.routes()`. */
+export interface MockableRoute {
+  readonly method: string
+  readonly path: string
+  readonly schema?:
+    | {
+        readonly response?: unknown
+      }
+    | undefined
+}
+
+/** App shape — anything with a `routes()` method. */
+export interface MockableApp {
+  routes(): readonly MockableRoute[]
+}
+
+export interface MockServerOptions {
+  /** Seed for deterministic mock generation. */
+  readonly seed?: number | undefined
+  /** Log mock requests to console. */
+  readonly verbose?: boolean | undefined
+}
+
+export interface MockServer {
+  /** Handle a request against the mock routes. */
+  fetch(request: Request): Promise<Response>
+  /** The generated mock routes for inspection. */
+  readonly mockRoutes: ReadonlyArray<{ method: string; path: string }>
+}
+
+/**
+ * Create a mock server from a Nifra app's route definitions. For each route
+ * with a `schema.response`, generates a handler returning fake data that
+ * matches the response schema structure. Routes without response schemas
+ * return `{}`.
+ */
+export function createMockServer(
+  app: MockableApp,
+  options?: MockServerOptions | undefined,
+): MockServer {
+  const seed = options?.seed ?? 42
+  const verbose = options?.verbose ?? false
+
+  const routes = reflectRoutes(app)
+
+  // Pre-generate mock responses for each route
+  const mockMap = new Map<string, unknown>()
+  const mockRoutes: Array<{ method: string; path: string }> = []
+
+  for (const route of routes) {
+    const key = `${route.method.toUpperCase()} ${route.path}`
+    const rng = seededRandom(seed)
+    const responseSchema = route.schema?.response?.jsonSchema
+    const mockValue = responseSchema ? generateMockValue(responseSchema, undefined, rng) : {}
+    mockMap.set(key, mockValue)
+    mockRoutes.push({ method: route.method.toUpperCase(), path: route.path })
+  }
+
+  return {
+    mockRoutes,
+
+    async fetch(request: Request): Promise<Response> {
+      const url = new URL(request.url)
+      const method = request.method.toUpperCase()
+      const pathname = url.pathname
+
+      // Exact match first
+      const exactKey = `${method} ${pathname}`
+      if (mockMap.has(exactKey)) {
+        if (verbose) console.log(`[mock] ${exactKey} → 200`)
+        return new Response(JSON.stringify(mockMap.get(exactKey)), {
+          status: 200,
+          headers: {
+            "content-type": "application/json",
+            "x-nifra-mock": "true",
+          },
+        })
+      }
+
+      // Try matching parameterized routes (e.g. /users/:id → /users/123)
+      for (const [key, value] of mockMap) {
+        const [routeMethod, routePath] = key.split(" ", 2)
+        if (routeMethod !== method || !routePath) continue
+
+        if (matchParameterizedPath(routePath, pathname)) {
+          if (verbose) console.log(`[mock] ${method} ${pathname} → ${routePath} → 200`)
+          return new Response(JSON.stringify(value), {
+            status: 200,
+            headers: {
+              "content-type": "application/json",
+              "x-nifra-mock": "true",
+            },
+          })
+        }
+      }
+
+      if (verbose) console.log(`[mock] ${method} ${pathname} → 404`)
+      return new Response(JSON.stringify({ error: "Not Found", mock: true }), {
+        status: 404,
+        headers: { "content-type": "application/json", "x-nifra-mock": "true" },
+      })
+    },
+  }
+}
+
+/**
+ * Match a parameterized route pattern (e.g. `/users/:id`) against a concrete pathname.
+ * Supports non-empty `:param` segments and Nifra's trailing `*wildcard` segment.
+ */
+function matchParameterizedPath(pattern: string, pathname: string): boolean {
+  const patternParts = pattern.split("/")
+  const pathParts = pathname.split("/")
+
+  const wildcardIndex = patternParts.findIndex((part) => part.startsWith("*"))
+  if (wildcardIndex === -1 && patternParts.length !== pathParts.length) return false
+  if (wildcardIndex !== -1 && wildcardIndex !== patternParts.length - 1) return false
+  if (wildcardIndex !== -1 && pathParts.length < wildcardIndex + 1) return false
+
+  for (let i = 0; i < patternParts.length; i++) {
+    const pp = patternParts[i]
+    const actual = pathParts[i]
+    if (pp === undefined || actual === undefined) return false
+    if (pp.startsWith("*")) return true
+    if (pp.startsWith(":")) {
+      if (actual.length === 0) return false
+      continue
+    }
+    if (pp !== actual) return false
+  }
+
+  return true
+}