@wylan24/mockgen 0.0.0-stage → 0.1.0-alpha.1

package/dist/schema.js

@@ -0,0 +1,321 @@
+import { isIPv4, isIPv6 } from 'node:net';
+// Small schema helpers shared by the generator, server and collections.
+export function typeOf(schema) {
+    let t = schema.type;
+    if (Array.isArray(t)) {
+        // 3.1 nullable: prefer the non-null type so data looks real.
+        const nonNull = t.filter((x) => x !== 'null');
+        t = nonNull[0] ?? 'null';
+    }
+    if (t)
+        return t;
+    if (schema.properties || schema.additionalProperties)
+        return 'object';
+    if (schema.items)
+        return 'array';
+    if (schema.format || schema.pattern || schema.minLength !== undefined)
+        return 'string';
+    if (schema.minimum !== undefined || schema.maximum !== undefined)
+        return 'number';
+    return undefined;
+}
+/**
+ * OpenAPI `discriminator`s, resolved at load time. Plain JSON Schema can't tell
+ * `oneOf` branches apart when they differ only by a discriminator value, so the
+ * generator, `fits` and the validator all pick the branch from this mapping.
+ */
+export const DISCRIMINATOR = Symbol.for('mockgen.discriminator');
+export function discriminatorOf(schema) {
+    return schema[DISCRIMINATOR];
+}
+const LOWER_BOUNDS = new Set(['minimum', 'minLength', 'minItems', 'minProperties']);
+const UPPER_BOUNDS = new Set(['maximum', 'maxLength', 'maxItems', 'maxProperties']);
+/**
+ * Merge `allOf` members into one schema: properties and required lists combine.
+ * A member with `additionalProperties: false` only allows its own properties, so
+ * optional properties from other members are dropped (that's what a validator
+ * enforces). Required ones are kept: such a spec can't be satisfied anyway, and
+ * a realistic value beats a placeholder.
+ *
+ * Schemas are never mutated, so results are cached by identity: generation merges
+ * the same schemas for every record.
+ */
+export function mergeAllOf(schema) {
+    let merged = mergeCache.get(schema);
+    if (!merged)
+        mergeCache.set(schema, (merged = mergeUncached(schema)));
+    return merged;
+}
+const mergeCache = new WeakMap();
+/** `mergeAllOf({allOf: [base, branch]})`, cached per (base, branch) pair. */
+export function mergeBranch(base, branch) {
+    let byBranch = branchCache.get(base);
+    if (!byBranch)
+        branchCache.set(base, (byBranch = new WeakMap()));
+    let merged = byBranch.get(branch);
+    if (!merged)
+        byBranch.set(branch, (merged = mergeUncached({ allOf: [base, branch] })));
+    return merged;
+}
+const branchCache = new WeakMap();
+function mergeUncached(schema) {
+    const { allOf, ...rest } = schema;
+    const merged = { ...rest };
+    const closed = [];
+    if (rest.additionalProperties === false && rest.properties)
+        closed.push(new Set(Object.keys(rest.properties)));
+    for (const part of allOf) {
+        if (part.additionalProperties === false)
+            closed.push(new Set(Object.keys(part.properties ?? {})));
+        const flat = part.allOf ? mergeAllOf(part) : part;
+        for (const [k, v] of Object.entries(flat)) {
+            if (k === 'properties')
+                merged.properties = mergeProperties(merged.properties, v);
+            else if (k === 'required')
+                merged.required = [...new Set([...(merged.required ?? []), ...v])];
+            else if (!(k in merged))
+                merged[k] = v;
+            // Every member applies, so constraints narrow rather than first-one-wins.
+            else if (k === 'enum' && Array.isArray(v))
+                merged.enum = merged.enum.filter((e) => v.some((x) => JSON.stringify(x) === JSON.stringify(e)));
+            else if (LOWER_BOUNDS.has(k) && typeof v === 'number')
+                merged[k] = Math.max(merged[k], v);
+            else if (UPPER_BOUNDS.has(k) && typeof v === 'number')
+                merged[k] = Math.min(merged[k], v);
+        }
+    }
+    if (closed.length && merged.properties) {
+        const required = new Set(merged.required ?? []);
+        merged.properties = Object.fromEntries(Object.entries(merged.properties).filter(([k]) => required.has(k) || closed.every((allowed) => allowed.has(k))));
+    }
+    return merged;
+}
+/** A property defined by two members must satisfy both definitions. */
+function mergeProperties(a, b) {
+    const out = { ...a };
+    for (const [key, schema] of Object.entries(b)) {
+        const existing = out[key];
+        out[key] = existing && existing !== schema ? { allOf: [existing, schema] } : schema;
+    }
+    return out;
+}
+/**
+ * Whether `value` validates against `schema` — a compact validator covering the
+ * keywords OpenAPI uses, used to reject bad spec examples and to keep `oneOf`
+ * branches from overlapping. Returns false when there is no schema at all.
+ */
+export function fits(value, schema) {
+    return schema !== undefined && check(value, schema, 0);
+}
+const MAX_DEPTH = 64;
+function check(value, schema, depth) {
+    if (schema === undefined || schema === true)
+        return true;
+    if (schema === false)
+        return false;
+    if (depth > MAX_DEPTH)
+        return true;
+    const s = schema;
+    const d = depth + 1;
+    // OpenAPI 3.0.3: `nullable` widens `type` (and `enum`), but null must still pass
+    // oneOf/allOf and the rest. Mirrors how validate.ts converts it.
+    const nullable = value === null && s.nullable === true;
+    if (nullable && !s.type)
+        return true;
+    if (Array.isArray(s.enum) && !nullable && !s.enum.some((e) => equal(e, value)))
+        return false;
+    if ('const' in s && !equal(s.const, value))
+        return false;
+    if (Array.isArray(s.allOf) && !s.allOf.every((p) => check(value, p, d)))
+        return false;
+    const disc = s.oneOf || s.anyOf ? discriminatorOf(s) : undefined;
+    if (disc) {
+        const branch = value && typeof value === 'object' ? disc.mapping.find((m) => m.value === value[disc.property]) : undefined;
+        if (!branch || !check(value, branch.schema, d))
+            return false;
+    }
+    else {
+        if (Array.isArray(s.anyOf) && !s.anyOf.some((p) => check(value, p, d)))
+            return false;
+        if (Array.isArray(s.oneOf) && countMatches(value, s.oneOf, d, 2) !== 1)
+            return false;
+    }
+    if (s.not !== undefined && check(value, s.not, d))
+        return false;
+    const types = Array.isArray(s.type) ? s.type : s.type ? [s.type] : [];
+    if (types.length && !nullable && !types.some((t) => isType(value, t)))
+        return false;
+    if (typeof value === 'number')
+        return checkNumber(value, s);
+    if (typeof value === 'string')
+        return checkString(value, s);
+    if (Array.isArray(value))
+        return checkArray(value, s, d);
+    if (value && typeof value === 'object')
+        return checkObject(value, s, d);
+    return true;
+}
+/** How many of `schemas` the value matches, stopping early at `stopAt`. */
+export function countMatches(value, schemas, depth = 0, stopAt = Infinity) {
+    let n = 0;
+    for (const s of schemas)
+        if (check(value, s, depth) && ++n >= stopAt)
+            break;
+    return n;
+}
+function isType(v, t) {
+    switch (t) {
+        case 'null':
+            return v === null;
+        case 'integer':
+            return Number.isInteger(v);
+        case 'number':
+            return typeof v === 'number' && Number.isFinite(v);
+        case 'string':
+            return typeof v === 'string';
+        case 'boolean':
+            return typeof v === 'boolean';
+        case 'array':
+            return Array.isArray(v);
+        case 'object':
+            return !!v && typeof v === 'object' && !Array.isArray(v);
+        default:
+            return false;
+    }
+}
+function checkNumber(n, s) {
+    if (s.minimum !== undefined && (s.exclusiveMinimum === true ? n <= s.minimum : n < s.minimum))
+        return false;
+    if (s.maximum !== undefined && (s.exclusiveMaximum === true ? n >= s.maximum : n > s.maximum))
+        return false;
+    if (typeof s.exclusiveMinimum === 'number' && n <= s.exclusiveMinimum)
+        return false;
+    if (typeof s.exclusiveMaximum === 'number' && n >= s.exclusiveMaximum)
+        return false;
+    if (s.multipleOf) {
+        const q = n / s.multipleOf;
+        if (Math.abs(q - Math.round(q)) > 1e-9)
+            return false;
+    }
+    if (s.format === 'int32')
+        return Number.isInteger(n) && n >= -(2 ** 31) && n < 2 ** 31;
+    if (s.format === 'int64')
+        return Number.isInteger(n);
+    return true;
+}
+function checkString(v, s) {
+    const length = [...v].length;
+    if (s.minLength !== undefined && length < s.minLength)
+        return false;
+    if (s.maxLength !== undefined && length > s.maxLength)
+        return false;
+    if (s.pattern && !safeTest(s.pattern, v))
+        return false;
+    const format = s.format && FORMATS[s.format];
+    return !format || format(v);
+}
+function checkArray(v, s, d) {
+    if (s.minItems !== undefined && v.length < s.minItems)
+        return false;
+    if (s.maxItems !== undefined && v.length > s.maxItems)
+        return false;
+    if (s.uniqueItems && new Set(v.map((x) => JSON.stringify(x))).size !== v.length)
+        return false;
+    const prefix = s.prefixItems ?? [];
+    return v.every((item, i) => check(item, i < prefix.length ? prefix[i] : s.items, d));
+}
+function checkObject(v, s, d) {
+    const props = s.properties ?? {};
+    for (const key of s.required ?? []) {
+        // Responses never carry writeOnly fields, even required ones.
+        if (!(key in v) && !props[key]?.writeOnly)
+            return false;
+    }
+    const keys = Object.keys(v);
+    if (s.minProperties !== undefined && keys.length < s.minProperties)
+        return false;
+    if (s.maxProperties !== undefined && keys.length > s.maxProperties)
+        return false;
+    const patterns = Object.entries(s.patternProperties ?? {});
+    for (const key of keys) {
+        if (key in props) {
+            if (!check(v[key], props[key], d))
+                return false;
+            continue;
+        }
+        const matched = patterns.filter(([p]) => safeTest(p, key));
+        if (matched.length) {
+            if (!matched.every(([, ps]) => check(v[key], ps, d)))
+                return false;
+        }
+        else if (s.additionalProperties !== undefined && !check(v[key], s.additionalProperties, d)) {
+            return false;
+        }
+    }
+    return true;
+}
+/** Test against a spec pattern, compiled once; an invalid pattern matches nothing. */
+function safeTest(pattern, value) {
+    let re = regexCache.get(pattern);
+    if (re === undefined) {
+        try {
+            re = new RegExp(pattern, 'u');
+        }
+        catch {
+            re = null;
+        }
+        regexCache.set(pattern, re);
+    }
+    return re !== null && re.test(value);
+}
+const regexCache = new Map();
+function equal(a, b) {
+    return a === b || JSON.stringify(a) === JSON.stringify(b);
+}
+/** Characters RFC 3986 never allows unescaped — `{id}` placeholders in examples trip validators. */
+function uriChars(v) {
+    if (/^(https?|ftp):/i.test(v)) {
+        // WHATWG URL parsing accepts hosts like `***`; RFC 3986 validators don't.
+        const host = /^[a-z]+:\/\/(?:[^@/?#]*@)?([^/?#:]*)/i.exec(v)?.[1] ?? '';
+        if (!/^(\[[0-9a-f:.]+\]|[a-z0-9.-]+)$/i.test(host))
+            return false;
+    }
+    return !/[\s{}<>"\^`|]/.test(v) && !/%(?![0-9a-f]{2})/i.test(v);
+}
+const DATE = /^(\d{4})-(\d{2})-(\d{2})$/;
+const TIME = /^\d{2}:\d{2}:\d{2}(\.\d+)?([Zz]|[+-]\d{2}:\d{2})$/;
+function isDate(v) {
+    const m = DATE.exec(v);
+    if (!m)
+        return false;
+    const d = new Date(`${v}T00:00:00Z`);
+    return !Number.isNaN(d.getTime()) && d.getUTCDate() === Number(m[3]);
+}
+/** Formats checked as strictly as Ajv's `ajv-formats`, so passing here means passing there. */
+const FORMATS = {
+    date: isDate,
+    time: (v) => TIME.test(v),
+    'date-time': (v) => {
+        const i = v.search(/[Tt ]/);
+        return i === 10 && isDate(v.slice(0, 10)) && TIME.test(v.slice(11));
+    },
+    uuid: (v) => /^(urn:uuid:)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(v),
+    email: (v) => /^[a-z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/i.test(v),
+    uri: (v) => /^[a-z][a-z0-9+.-]*:/i.test(v) && uriChars(v) && URL.canParse(v),
+    url: (v) => /^(https?|ftp):\/\//i.test(v) && uriChars(v) && URL.canParse(v),
+    'uri-reference': uriChars,
+    hostname: (v) => /^(?=.{1,253}\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\.?$/i.test(v),
+    ipv4: (v) => isIPv4(v),
+    ipv6: (v) => isIPv6(v),
+    'json-pointer': (v) => /^(?:\/(?:[^~/]|~0|~1)*)*$/.test(v),
+    regex: (v) => {
+        try {
+            new RegExp(v, 'u');
+            return true;
+        }
+        catch {
+            return false;
+        }
+    },
+};
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../src/schema.ts"],"names":[],"mappings":"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","sourcesContent":["import { isIPv4, isIPv6 } from 'node:net';\nimport type { Schema } from './model.js';\n\n// Small schema helpers shared by the generator, server and collections.\n\nexport function typeOf(schema: Schema): string | undefined {\n  let t = schema.type;\n  if (Array.isArray(t)) {\n    // 3.1 nullable: prefer the non-null type so data looks real.\n    const nonNull = t.filter((x: string) => x !== 'null');\n    t = nonNull[0] ?? 'null';\n  }\n  if (t) return t;\n  if (schema.properties || schema.additionalProperties) return 'object';\n  if (schema.items) return 'array';\n  if (schema.format || schema.pattern || schema.minLength !== undefined) return 'string';\n  if (schema.minimum !== undefined || schema.maximum !== undefined) return 'number';\n  return undefined;\n}\n\n/**\n * OpenAPI `discriminator`s, resolved at load time. Plain JSON Schema can't tell\n * `oneOf` branches apart when they differ only by a discriminator value, so the\n * generator, `fits` and the validator all pick the branch from this mapping.\n */\nexport const DISCRIMINATOR = Symbol.for('mockgen.discriminator');\n\nexport interface Discriminator {\n  property: string;\n  /** One entry per `oneOf`/`anyOf` branch. */\n  mapping: { value: string; schema: Schema }[];\n}\n\nexport function discriminatorOf(schema: Schema): Discriminator | undefined {\n  return (schema as Record<symbol, Discriminator | undefined>)[DISCRIMINATOR];\n}\n\nconst LOWER_BOUNDS = new Set(['minimum', 'minLength', 'minItems', 'minProperties']);\nconst UPPER_BOUNDS = new Set(['maximum', 'maxLength', 'maxItems', 'maxProperties']);\n\n/**\n * Merge `allOf` members into one schema: properties and required lists combine.\n * A member with `additionalProperties: false` only allows its own properties, so\n * optional properties from other members are dropped (that's what a validator\n * enforces). Required ones are kept: such a spec can't be satisfied anyway, and\n * a realistic value beats a placeholder.\n *\n * Schemas are never mutated, so results are cached by identity: generation merges\n * the same schemas for every record.\n */\nexport function mergeAllOf(schema: Schema): Schema {\n  let merged = mergeCache.get(schema);\n  if (!merged) mergeCache.set(schema, (merged = mergeUncached(schema)));\n  return merged;\n}\n\nconst mergeCache = new WeakMap<Schema, Schema>();\n\n/** `mergeAllOf({allOf: [base, branch]})`, cached per (base, branch) pair. */\nexport function mergeBranch(base: Schema, branch: Schema): Schema {\n  let byBranch = branchCache.get(base);\n  if (!byBranch) branchCache.set(base, (byBranch = new WeakMap()));\n  let merged = byBranch.get(branch);\n  if (!merged) byBranch.set(branch, (merged = mergeUncached({ allOf: [base, branch] })));\n  return merged;\n}\n\nconst branchCache = new WeakMap<Schema, WeakMap<Schema, Schema>>();\n\nfunction mergeUncached(schema: Schema): Schema {\n  const { allOf, ...rest } = schema;\n  const merged: Schema = { ...rest };\n  const closed: Set<string>[] = [];\n  if (rest.additionalProperties === false && rest.properties) closed.push(new Set(Object.keys(rest.properties)));\n  for (const part of allOf as Schema[]) {\n    if (part.additionalProperties === false) closed.push(new Set(Object.keys(part.properties ?? {})));\n    const flat = part.allOf ? mergeAllOf(part) : part;\n    for (const [k, v] of Object.entries(flat)) {\n      if (k === 'properties') merged.properties = mergeProperties(merged.properties, v);\n      else if (k === 'required') merged.required = [...new Set([...(merged.required ?? []), ...v])];\n      else if (!(k in merged)) merged[k] = v;\n      // Every member applies, so constraints narrow rather than first-one-wins.\n      else if (k === 'enum' && Array.isArray(v)) merged.enum = merged.enum.filter((e: unknown) => v.some((x: unknown) => JSON.stringify(x) === JSON.stringify(e)));\n      else if (LOWER_BOUNDS.has(k) && typeof v === 'number') merged[k] = Math.max(merged[k], v);\n      else if (UPPER_BOUNDS.has(k) && typeof v === 'number') merged[k] = Math.min(merged[k], v);\n    }\n  }\n  if (closed.length && merged.properties) {\n    const required = new Set(merged.required ?? []);\n    merged.properties = Object.fromEntries(\n      Object.entries(merged.properties).filter(([k]) => required.has(k) || closed.every((allowed) => allowed.has(k))),\n    );\n  }\n  return merged;\n}\n\n/** A property defined by two members must satisfy both definitions. */\nfunction mergeProperties(a: Record<string, Schema> | undefined, b: Record<string, Schema>): Record<string, Schema> {\n  const out = { ...a };\n  for (const [key, schema] of Object.entries(b)) {\n    const existing = out[key];\n    out[key] = existing && existing !== schema ? { allOf: [existing, schema] } : schema;\n  }\n  return out;\n}\n\n/**\n * Whether `value` validates against `schema` — a compact validator covering the\n * keywords OpenAPI uses, used to reject bad spec examples and to keep `oneOf`\n * branches from overlapping. Returns false when there is no schema at all.\n */\nexport function fits(value: unknown, schema: Schema | undefined): boolean {\n  return schema !== undefined && check(value, schema, 0);\n}\n\nconst MAX_DEPTH = 64;\n\nfunction check(value: unknown, schema: Schema | boolean | undefined, depth: number): boolean {\n  if (schema === undefined || schema === true) return true;\n  if (schema === false) return false;\n  if (depth > MAX_DEPTH) return true;\n  const s = schema;\n  const d = depth + 1;\n\n  // OpenAPI 3.0.3: `nullable` widens `type` (and `enum`), but null must still pass\n  // oneOf/allOf and the rest. Mirrors how validate.ts converts it.\n  const nullable = value === null && s.nullable === true;\n  if (nullable && !s.type) return true;\n  if (Array.isArray(s.enum) && !nullable && !s.enum.some((e: unknown) => equal(e, value))) return false;\n  if ('const' in s && !equal(s.const, value)) return false;\n  if (Array.isArray(s.allOf) && !s.allOf.every((p: Schema) => check(value, p, d))) return false;\n  const disc = s.oneOf || s.anyOf ? discriminatorOf(s) : undefined;\n  if (disc) {\n    const branch = value && typeof value === 'object' ? disc.mapping.find((m) => m.value === (value as Record<string, unknown>)[disc.property]) : undefined;\n    if (!branch || !check(value, branch.schema, d)) return false;\n  } else {\n    if (Array.isArray(s.anyOf) && !s.anyOf.some((p: Schema) => check(value, p, d))) return false;\n    if (Array.isArray(s.oneOf) && countMatches(value, s.oneOf, d, 2) !== 1) return false;\n  }\n  if (s.not !== undefined && check(value, s.not, d)) return false;\n\n  const types: string[] = Array.isArray(s.type) ? s.type : s.type ? [s.type] : [];\n  if (types.length && !nullable && !types.some((t) => isType(value, t))) return false;\n\n  if (typeof value === 'number') return checkNumber(value, s);\n  if (typeof value === 'string') return checkString(value, s);\n  if (Array.isArray(value)) return checkArray(value, s, d);\n  if (value && typeof value === 'object') return checkObject(value as Record<string, unknown>, s, d);\n  return true;\n}\n\n/** How many of `schemas` the value matches, stopping early at `stopAt`. */\nexport function countMatches(value: unknown, schemas: Schema[], depth = 0, stopAt = Infinity): number {\n  let n = 0;\n  for (const s of schemas) if (check(value, s, depth) && ++n >= stopAt) break;\n  return n;\n}\n\nfunction isType(v: unknown, t: string): boolean {\n  switch (t) {\n    case 'null':\n      return v === null;\n    case 'integer':\n      return Number.isInteger(v);\n    case 'number':\n      return typeof v === 'number' && Number.isFinite(v);\n    case 'string':\n      return typeof v === 'string';\n    case 'boolean':\n      return typeof v === 'boolean';\n    case 'array':\n      return Array.isArray(v);\n    case 'object':\n      return !!v && typeof v === 'object' && !Array.isArray(v);\n    default:\n      return false;\n  }\n}\n\nfunction checkNumber(n: number, s: Schema): boolean {\n  if (s.minimum !== undefined && (s.exclusiveMinimum === true ? n <= s.minimum : n < s.minimum)) return false;\n  if (s.maximum !== undefined && (s.exclusiveMaximum === true ? n >= s.maximum : n > s.maximum)) return false;\n  if (typeof s.exclusiveMinimum === 'number' && n <= s.exclusiveMinimum) return false;\n  if (typeof s.exclusiveMaximum === 'number' && n >= s.exclusiveMaximum) return false;\n  if (s.multipleOf) {\n    const q = n / s.multipleOf;\n    if (Math.abs(q - Math.round(q)) > 1e-9) return false;\n  }\n  if (s.format === 'int32') return Number.isInteger(n) && n >= -(2 ** 31) && n < 2 ** 31;\n  if (s.format === 'int64') return Number.isInteger(n);\n  return true;\n}\n\nfunction checkString(v: string, s: Schema): boolean {\n  const length = [...v].length;\n  if (s.minLength !== undefined && length < s.minLength) return false;\n  if (s.maxLength !== undefined && length > s.maxLength) return false;\n  if (s.pattern && !safeTest(s.pattern, v)) return false;\n  const format = s.format && FORMATS[s.format];\n  return !format || format(v);\n}\n\nfunction checkArray(v: unknown[], s: Schema, d: number): boolean {\n  if (s.minItems !== undefined && v.length < s.minItems) return false;\n  if (s.maxItems !== undefined && v.length > s.maxItems) return false;\n  if (s.uniqueItems && new Set(v.map((x) => JSON.stringify(x))).size !== v.length) return false;\n  const prefix: Schema[] = s.prefixItems ?? [];\n  return v.every((item, i) => check(item, i < prefix.length ? prefix[i] : s.items, d));\n}\n\nfunction checkObject(v: Record<string, unknown>, s: Schema, d: number): boolean {\n  const props: Record<string, Schema> = s.properties ?? {};\n  for (const key of s.required ?? []) {\n    // Responses never carry writeOnly fields, even required ones.\n    if (!(key in v) && !props[key]?.writeOnly) return false;\n  }\n  const keys = Object.keys(v);\n  if (s.minProperties !== undefined && keys.length < s.minProperties) return false;\n  if (s.maxProperties !== undefined && keys.length > s.maxProperties) return false;\n  const patterns = Object.entries<Schema>(s.patternProperties ?? {});\n  for (const key of keys) {\n    if (key in props) {\n      if (!check(v[key], props[key], d)) return false;\n      continue;\n    }\n    const matched = patterns.filter(([p]) => safeTest(p, key));\n    if (matched.length) {\n      if (!matched.every(([, ps]) => check(v[key], ps, d))) return false;\n    } else if (s.additionalProperties !== undefined && !check(v[key], s.additionalProperties, d)) {\n      return false;\n    }\n  }\n  return true;\n}\n\n/** Test against a spec pattern, compiled once; an invalid pattern matches nothing. */\nfunction safeTest(pattern: string, value: string): boolean {\n  let re = regexCache.get(pattern);\n  if (re === undefined) {\n    try {\n      re = new RegExp(pattern, 'u');\n    } catch {\n      re = null;\n    }\n    regexCache.set(pattern, re);\n  }\n  return re !== null && re.test(value);\n}\n\nconst regexCache = new Map<string, RegExp | null>();\n\nfunction equal(a: unknown, b: unknown): boolean {\n  return a === b || JSON.stringify(a) === JSON.stringify(b);\n}\n\n/** Characters RFC 3986 never allows unescaped — `{id}` placeholders in examples trip validators. */\nfunction uriChars(v: string): boolean {\n  if (/^(https?|ftp):/i.test(v)) {\n    // WHATWG URL parsing accepts hosts like `***`; RFC 3986 validators don't.\n    const host = /^[a-z]+:\\/\\/(?:[^@/?#]*@)?([^/?#:]*)/i.exec(v)?.[1] ?? '';\n    if (!/^(\\[[0-9a-f:.]+\\]|[a-z0-9.-]+)$/i.test(host)) return false;\n  }\n  return !/[\\s{}<>\"\\^`|]/.test(v) && !/%(?![0-9a-f]{2})/i.test(v);\n}\n\nconst DATE = /^(\\d{4})-(\\d{2})-(\\d{2})$/;\nconst TIME = /^\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?([Zz]|[+-]\\d{2}:\\d{2})$/;\n\nfunction isDate(v: string): boolean {\n  const m = DATE.exec(v);\n  if (!m) return false;\n  const d = new Date(`${v}T00:00:00Z`);\n  return !Number.isNaN(d.getTime()) && d.getUTCDate() === Number(m[3]);\n}\n\n/** Formats checked as strictly as Ajv's `ajv-formats`, so passing here means passing there. */\nconst FORMATS: Record<string, (v: string) => boolean> = {\n  date: isDate,\n  time: (v) => TIME.test(v),\n  'date-time': (v) => {\n    const i = v.search(/[Tt ]/);\n    return i === 10 && isDate(v.slice(0, 10)) && TIME.test(v.slice(11));\n  },\n  uuid: (v) => /^(urn:uuid:)?[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(v),\n  email: (v) => /^[a-z0-9.!#$%&'*+/=?^_`{|}~-]+@[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?)*$/i.test(v),\n  uri: (v) => /^[a-z][a-z0-9+.-]*:/i.test(v) && uriChars(v) && URL.canParse(v),\n  url: (v) => /^(https?|ftp):\\/\\//i.test(v) && uriChars(v) && URL.canParse(v),\n  'uri-reference': uriChars,\n  hostname: (v) => /^(?=.{1,253}\\.?$)[a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?(?:\\.[a-z0-9](?:[-0-9a-z]{0,61}[0-9a-z])?)*\\.?$/i.test(v),\n  ipv4: (v) => isIPv4(v),\n  ipv6: (v) => isIPv6(v),\n  'json-pointer': (v) => /^(?:\\/(?:[^~/]|~0|~1)*)*$/.test(v),\n  regex: (v) => {\n    try {\n      new RegExp(v, 'u');\n      return true;\n    } catch {\n      return false;\n    }\n  },\n};\n"]}

package/dist/server.d.ts

@@ -0,0 +1,41 @@
+import http from 'node:http';
+import type { MockModel } from './model.js';
+export interface MockServerOptions {
+    model: MockModel;
+    /** Seed for generated data; same seed → same responses. Default 1. */
+    seed?: number;
+    /** Delay every response by this many milliseconds. Overridden per request by `X-Mock-Delay`. */
+    delay?: number;
+    /** Size of every list endpoint's collection, paged through with `?page=`/`?limit=`. Default 50. */
+    records?: number;
+    /** Called once per request with a one-line summary. */
+    log?: (line: string) => void;
+}
+export interface MockServer {
+    server: http.Server;
+    listen(port?: number, host?: string): Promise<string>;
+    close(): Promise<void>;
+    /** Swap the model in place, e.g. after the spec changed on disk. */
+    setModel(model: MockModel): void;
+}
+export interface MockResult {
+    status: number;
+    body: unknown;
+    headers: Record<string, string>;
+}
+export declare function createMockServer(options: MockServerOptions): MockServer;
+export interface RespondInput {
+    method: string;
+    path: string;
+    seed?: number;
+    /** Force a status code, e.g. from `X-Mock-Status`. */
+    status?: string | number;
+    /** Query string; drives pagination on list endpoints. */
+    query?: URLSearchParams | string;
+    /** `http://host:port`, used to build absolute next/prev links. */
+    origin?: string;
+    /** Collection size for list endpoints. Default 50. */
+    records?: number;
+}
+/** Produce the mock response for one request. Pure apart from the generator's seed. */
+export declare function respond(model: MockModel, input: RespondInput): MockResult;

package/dist/server.js

@@ -0,0 +1,171 @@
+import http from 'node:http';
+import { buildPage, findDetailRoute, findListShape } from './collections.js';
+import { generate } from './generate.js';
+import { fits, mergeAllOf } from './schema.js';
+const CORS_HEADERS = {
+    'access-control-allow-origin': '*',
+    'access-control-allow-methods': 'GET,POST,PUT,PATCH,DELETE,OPTIONS,HEAD',
+    'access-control-allow-headers': '*',
+    'access-control-expose-headers': '*',
+};
+export function createMockServer(options) {
+    let model = options.model;
+    const seed = options.seed ?? 1;
+    const server = http.createServer(async (req, res) => {
+        const started = performance.now();
+        const url = new URL(req.url ?? '/', 'http://localhost');
+        const method = (req.method ?? 'GET').toUpperCase();
+        req.resume(); // Request bodies are not used yet; drain them.
+        let result;
+        if (method === 'OPTIONS' && !findRoute(model, 'OPTIONS', url.pathname).route) {
+            result = { status: 204, body: undefined, headers: {} };
+        }
+        else {
+            result = respond(model, {
+                method,
+                path: url.pathname,
+                seed,
+                status: header(req, 'x-mock-status') ?? url.searchParams.get('__status') ?? undefined,
+                query: url.searchParams,
+                origin: req.headers.host ? `http://${req.headers.host}` : undefined,
+                records: options.records,
+            });
+        }
+        const delay = Number(header(req, 'x-mock-delay') ?? url.searchParams.get('__delay') ?? options.delay ?? 0);
+        if (delay > 0)
+            await new Promise((r) => setTimeout(r, delay));
+        const hasBody = result.body !== undefined && method !== 'HEAD' && result.status !== 204 && result.status !== 304;
+        res.writeHead(result.status, {
+            ...CORS_HEADERS,
+            ...(hasBody ? { 'content-type': 'application/json; charset=utf-8' } : {}),
+            ...result.headers,
+        });
+        res.end(hasBody ? JSON.stringify(result.body, null, 2) : undefined);
+        options.log?.(`${method} ${url.pathname}${url.search} → ${result.status} ${Math.round(performance.now() - started)}ms`);
+    });
+    return {
+        server,
+        listen(port = 4010, host = '127.0.0.1') {
+            return new Promise((resolve, reject) => {
+                server.once('error', reject);
+                server.listen(port, host, () => {
+                    const addr = server.address();
+                    resolve(`http://${host.includes(':') ? `[${host}]` : host}:${addr.port}`);
+                });
+            });
+        },
+        close() {
+            return new Promise((resolve, reject) => {
+                server.closeAllConnections();
+                server.close((err) => (err ? reject(err) : resolve()));
+            });
+        },
+        setModel(next) {
+            model = next;
+        },
+    };
+}
+/** Produce the mock response for one request. Pure apart from the generator's seed. */
+export function respond(model, input) {
+    const { route, params, pathExists } = findRoute(model, input.method, input.path);
+    if (!route) {
+        return pathExists
+            ? errorResult(405, `Method ${input.method} is not defined for ${input.path}`)
+            : errorResult(404, `No route in the spec matches ${input.method} ${input.path}`);
+    }
+    const forced = input.status !== undefined ? Number(input.status) : undefined;
+    if (forced !== undefined && !(forced >= 100 && forced <= 599)) {
+        return errorResult(400, `X-Mock-Status must be an HTTP status code, got "${input.status}"`);
+    }
+    const response = pickResponse(route.responses, forced);
+    const status = forced ?? response?.status ?? 200;
+    if (!response || (forced !== undefined && response.status !== forced && !response.isDefault)) {
+        // The spec doesn't describe this status; still honor it so error paths can be tested.
+        return status >= 400 ? errorResult(status, http.STATUS_CODES[status] ?? 'Error') : { status, body: undefined, headers: {} };
+    }
+    let body;
+    if (response.hasExample)
+        body = structuredClone(response.example);
+    else if (response.schema)
+        body = generate(response.schema, { seed: input.seed, key: `${route.method} ${input.path} ${status}` });
+    let headers = {};
+    // List endpoints (not `/users/{id}`) page through a stable collection.
+    const shape = route.method === 'GET' && !response.hasExample && status < 300 && !route.path.endsWith('}') ? findListShape(response.schema) : undefined;
+    if (shape) {
+        const requestPath = input.path.replace(/(.)\/$/, '$1');
+        const detailRoute = findDetailRoute(model.routes, route);
+        const detailResponse = detailRoute && pickResponse(detailRoute.responses);
+        const linked = !!detailResponse?.schema && !detailResponse.hasExample;
+        ({ body, headers } = buildPage({
+            schema: response.schema,
+            requestPath,
+            query: new URLSearchParams(input.query ?? ''),
+            origin: input.origin,
+            seed: input.seed,
+            shape,
+            body,
+            total: input.records ?? 50,
+            idKey: detailRoute?.paramNames.at(-1),
+            detailSchema: linked ? detailResponse.schema : undefined,
+            detail: linked
+                ? (id) => {
+                    const r = respond(model, { method: 'GET', path: `${requestPath}/${encodeURIComponent(String(id))}`, seed: input.seed });
+                    return r.status < 300 && isRecord(r.body) ? r.body : undefined;
+                }
+                : undefined,
+        }));
+    }
+    if (isRecord(body) && response.schema)
+        applyPathParams(body, response.schema, route, params);
+    return { status, body, headers };
+}
+function findRoute(model, method, rawPath) {
+    let p = rawPath;
+    if (model.basePath && (p === model.basePath || p.startsWith(`${model.basePath}/`))) {
+        p = p.slice(model.basePath.length) || '/';
+    }
+    let pathExists = false;
+    for (const route of model.routes) {
+        const m = route.pattern.exec(p);
+        if (!m)
+            continue;
+        pathExists = true;
+        if (route.method !== method && !(method === 'HEAD' && route.method === 'GET'))
+            continue;
+        const params = {};
+        route.paramNames.forEach((name, i) => (params[name] = decodeURIComponent(m[i + 1])));
+        return { route, params, pathExists };
+    }
+    return { route: undefined, params: {}, pathExists };
+}
+function pickResponse(responses, forced) {
+    if (forced !== undefined) {
+        return responses.find((r) => r.status === forced && !r.isDefault) ?? responses.find((r) => r.isDefault);
+    }
+    const explicit = responses.filter((r) => !r.isDefault).sort((a, b) => a.status - b.status);
+    return explicit.find((r) => r.status >= 200 && r.status < 300) ?? responses.find((r) => r.isDefault) ?? explicit[0];
+}
+/** `GET /users/42` returns a user whose `id` is 42 — when 42 is a valid `id` for the schema. */
+function applyPathParams(body, schema, route, params) {
+    const props = (schema.allOf ? mergeAllOf(schema) : schema).properties ?? {};
+    const last = route.paramNames.at(-1);
+    for (const [name, raw] of Object.entries(params)) {
+        const key = name in body ? name : name === last && 'id' in body ? 'id' : undefined;
+        if (!key)
+            continue;
+        const value = raw.trim() !== '' && typeof body[key] === 'number' ? Number(raw) : raw;
+        if (fits(value, props[key]))
+            body[key] = value;
+    }
+}
+function isRecord(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+function errorResult(status, message) {
+    return { status, body: { error: http.STATUS_CODES[status] ?? 'Error', message }, headers: {} };
+}
+function header(req, name) {
+    const v = req.headers[name];
+    return Array.isArray(v) ? v[0] : v;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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","sourcesContent":["import http from 'node:http';\nimport type { AddressInfo } from 'node:net';\nimport { buildPage, findDetailRoute, findListShape } from './collections.js';\nimport { generate } from './generate.js';\nimport type { MockModel, MockResponse, MockRoute, Schema } from './model.js';\nimport { fits, mergeAllOf } from './schema.js';\n\nexport interface MockServerOptions {\n  model: MockModel;\n  /** Seed for generated data; same seed → same responses. Default 1. */\n  seed?: number;\n  /** Delay every response by this many milliseconds. Overridden per request by `X-Mock-Delay`. */\n  delay?: number;\n  /** Size of every list endpoint's collection, paged through with `?page=`/`?limit=`. Default 50. */\n  records?: number;\n  /** Called once per request with a one-line summary. */\n  log?: (line: string) => void;\n}\n\nexport interface MockServer {\n  server: http.Server;\n  listen(port?: number, host?: string): Promise<string>;\n  close(): Promise<void>;\n  /** Swap the model in place, e.g. after the spec changed on disk. */\n  setModel(model: MockModel): void;\n}\n\nexport interface MockResult {\n  status: number;\n  body: unknown;\n  headers: Record<string, string>;\n}\n\nconst CORS_HEADERS = {\n  'access-control-allow-origin': '*',\n  'access-control-allow-methods': 'GET,POST,PUT,PATCH,DELETE,OPTIONS,HEAD',\n  'access-control-allow-headers': '*',\n  'access-control-expose-headers': '*',\n};\n\nexport function createMockServer(options: MockServerOptions): MockServer {\n  let model = options.model;\n  const seed = options.seed ?? 1;\n\n  const server = http.createServer(async (req, res) => {\n    const started = performance.now();\n    const url = new URL(req.url ?? '/', 'http://localhost');\n    const method = (req.method ?? 'GET').toUpperCase();\n    req.resume(); // Request bodies are not used yet; drain them.\n\n    let result: MockResult;\n    if (method === 'OPTIONS' && !findRoute(model, 'OPTIONS', url.pathname).route) {\n      result = { status: 204, body: undefined, headers: {} };\n    } else {\n      result = respond(model, {\n        method,\n        path: url.pathname,\n        seed,\n        status: header(req, 'x-mock-status') ?? url.searchParams.get('__status') ?? undefined,\n        query: url.searchParams,\n        origin: req.headers.host ? `http://${req.headers.host}` : undefined,\n        records: options.records,\n      });\n    }\n\n    const delay = Number(header(req, 'x-mock-delay') ?? url.searchParams.get('__delay') ?? options.delay ?? 0);\n    if (delay > 0) await new Promise((r) => setTimeout(r, delay));\n\n    const hasBody = result.body !== undefined && method !== 'HEAD' && result.status !== 204 && result.status !== 304;\n    res.writeHead(result.status, {\n      ...CORS_HEADERS,\n      ...(hasBody ? { 'content-type': 'application/json; charset=utf-8' } : {}),\n      ...result.headers,\n    });\n    res.end(hasBody ? JSON.stringify(result.body, null, 2) : undefined);\n\n    options.log?.(`${method} ${url.pathname}${url.search} → ${result.status} ${Math.round(performance.now() - started)}ms`);\n  });\n\n  return {\n    server,\n    listen(port = 4010, host = '127.0.0.1') {\n      return new Promise((resolve, reject) => {\n        server.once('error', reject);\n        server.listen(port, host, () => {\n          const addr = server.address() as AddressInfo;\n          resolve(`http://${host.includes(':') ? `[${host}]` : host}:${addr.port}`);\n        });\n      });\n    },\n    close() {\n      return new Promise((resolve, reject) => {\n        server.closeAllConnections();\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n    },\n    setModel(next) {\n      model = next;\n    },\n  };\n}\n\nexport interface RespondInput {\n  method: string;\n  path: string;\n  seed?: number;\n  /** Force a status code, e.g. from `X-Mock-Status`. */\n  status?: string | number;\n  /** Query string; drives pagination on list endpoints. */\n  query?: URLSearchParams | string;\n  /** `http://host:port`, used to build absolute next/prev links. */\n  origin?: string;\n  /** Collection size for list endpoints. Default 50. */\n  records?: number;\n}\n\n/** Produce the mock response for one request. Pure apart from the generator's seed. */\nexport function respond(model: MockModel, input: RespondInput): MockResult {\n  const { route, params, pathExists } = findRoute(model, input.method, input.path);\n  if (!route) {\n    return pathExists\n      ? errorResult(405, `Method ${input.method} is not defined for ${input.path}`)\n      : errorResult(404, `No route in the spec matches ${input.method} ${input.path}`);\n  }\n\n  const forced = input.status !== undefined ? Number(input.status) : undefined;\n  if (forced !== undefined && !(forced >= 100 && forced <= 599)) {\n    return errorResult(400, `X-Mock-Status must be an HTTP status code, got \"${input.status}\"`);\n  }\n\n  const response = pickResponse(route.responses, forced);\n  const status = forced ?? response?.status ?? 200;\n  if (!response || (forced !== undefined && response.status !== forced && !response.isDefault)) {\n    // The spec doesn't describe this status; still honor it so error paths can be tested.\n    return status >= 400 ? errorResult(status, http.STATUS_CODES[status] ?? 'Error') : { status, body: undefined, headers: {} };\n  }\n\n  let body: unknown;\n  if (response.hasExample) body = structuredClone(response.example);\n  else if (response.schema) body = generate(response.schema, { seed: input.seed, key: `${route.method} ${input.path} ${status}` });\n\n  let headers: Record<string, string> = {};\n  // List endpoints (not `/users/{id}`) page through a stable collection.\n  const shape = route.method === 'GET' && !response.hasExample && status < 300 && !route.path.endsWith('}') ? findListShape(response.schema) : undefined;\n  if (shape) {\n    const requestPath = input.path.replace(/(.)\\/$/, '$1');\n    const detailRoute = findDetailRoute(model.routes, route);\n    const detailResponse = detailRoute && pickResponse(detailRoute.responses);\n    const linked = !!detailResponse?.schema && !detailResponse.hasExample;\n    ({ body, headers } = buildPage({\n      schema: response.schema!,\n      requestPath,\n      query: new URLSearchParams(input.query ?? ''),\n      origin: input.origin,\n      seed: input.seed,\n      shape,\n      body,\n      total: input.records ?? 50,\n      idKey: detailRoute?.paramNames.at(-1),\n      detailSchema: linked ? detailResponse.schema : undefined,\n      detail: linked\n        ? (id) => {\n            const r = respond(model, { method: 'GET', path: `${requestPath}/${encodeURIComponent(String(id))}`, seed: input.seed });\n            return r.status < 300 && isRecord(r.body) ? r.body : undefined;\n          }\n        : undefined,\n    }));\n  }\n\n  if (isRecord(body) && response.schema) applyPathParams(body, response.schema, route, params);\n  return { status, body, headers };\n}\n\nfunction findRoute(model: MockModel, method: string, rawPath: string) {\n  let p = rawPath;\n  if (model.basePath && (p === model.basePath || p.startsWith(`${model.basePath}/`))) {\n    p = p.slice(model.basePath.length) || '/';\n  }\n  let pathExists = false;\n  for (const route of model.routes) {\n    const m = route.pattern.exec(p);\n    if (!m) continue;\n    pathExists = true;\n    if (route.method !== method && !(method === 'HEAD' && route.method === 'GET')) continue;\n    const params: Record<string, string> = {};\n    route.paramNames.forEach((name, i) => (params[name] = decodeURIComponent(m[i + 1]!)));\n    return { route, params, pathExists };\n  }\n  return { route: undefined, params: {}, pathExists };\n}\n\nfunction pickResponse(responses: MockResponse[], forced?: number): MockResponse | undefined {\n  if (forced !== undefined) {\n    return responses.find((r) => r.status === forced && !r.isDefault) ?? responses.find((r) => r.isDefault);\n  }\n  const explicit = responses.filter((r) => !r.isDefault).sort((a, b) => a.status - b.status);\n  return explicit.find((r) => r.status >= 200 && r.status < 300) ?? responses.find((r) => r.isDefault) ?? explicit[0];\n}\n\n/** `GET /users/42` returns a user whose `id` is 42 — when 42 is a valid `id` for the schema. */\nfunction applyPathParams(body: Record<string, unknown>, schema: Schema, route: MockRoute, params: Record<string, string>) {\n  const props: Record<string, Schema> = (schema.allOf ? mergeAllOf(schema) : schema).properties ?? {};\n  const last = route.paramNames.at(-1);\n  for (const [name, raw] of Object.entries(params)) {\n    const key = name in body ? name : name === last && 'id' in body ? 'id' : undefined;\n    if (!key) continue;\n    const value = raw.trim() !== '' && typeof body[key] === 'number' ? Number(raw) : raw;\n    if (fits(value, props[key])) body[key] = value;\n  }\n}\n\nfunction isRecord(v: unknown): v is Record<string, unknown> {\n  return !!v && typeof v === 'object' && !Array.isArray(v);\n}\n\nfunction errorResult(status: number, message: string): MockResult {\n  return { status, body: { error: http.STATUS_CODES[status] ?? 'Error', message }, headers: {} };\n}\n\nfunction header(req: http.IncomingMessage, name: string): string | undefined {\n  const v = req.headers[name];\n  return Array.isArray(v) ? v[0] : v;\n}\n"]}