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

package/dist/validate.d.ts

@@ -0,0 +1,21 @@
+import type { Schema } from './model.js';
+export interface ValidationResult {
+    valid: boolean;
+    /** Human-readable errors when invalid. */
+    errors?: string;
+}
+export declare class ResponseValidator {
+    private ajv;
+    private ids;
+    private failed;
+    private nextId;
+    private readonly openapi30;
+    /** @param openapi the spec's `openapi` version; 3.0 schemas get converted. */
+    constructor(openapi?: string);
+    /** Validate a value; throws if the schema itself can't be compiled (e.g. a non-JS regex). */
+    validate(schema: Schema, value: unknown): ValidationResult;
+    private register;
+    private child;
+}
+/** Rewrite a dereferenced (possibly cyclic) OpenAPI schema as one self-contained JSON Schema. */
+export declare function toJsonSchema(root: Schema, openapi30: boolean): Schema;

package/dist/validate.js

@@ -0,0 +1,164 @@
+import { Ajv2020 } from 'ajv/dist/2020.js';
+import addFormatsModule from 'ajv-formats';
+import { discriminatorOf } from './schema.js';
+// Validates generated responses against their schemas. OpenAPI schemas aren't quite
+// JSON Schema (3.0 has `nullable` and boolean exclusive bounds), and dereferenced
+// specs contain object cycles Ajv can't compile, so each schema is first rewritten
+// into plain JSON Schema with shared and circular parts moved into `$defs`.
+const addFormats = addFormatsModule;
+/** Keywords whose values are schemas, maps of schemas, or arrays of schemas. */
+const SCHEMA_KEYWORDS = new Set(['additionalProperties', 'items', 'not', 'if', 'then', 'else', 'contains', 'propertyNames', 'unevaluatedProperties', 'unevaluatedItems']);
+const SCHEMA_ARRAY_KEYWORDS = new Set(['allOf', 'anyOf', 'oneOf', 'prefixItems']);
+const SCHEMA_MAP_KEYWORDS = new Set(['properties', 'patternProperties', 'dependentSchemas', '$defs', 'definitions']);
+/** OpenAPI-only keywords that mean nothing to a validator. */
+const DROPPED_KEYWORDS = new Set(['discriminator', 'xml', 'externalDocs', 'example', 'deprecated']);
+export class ResponseValidator {
+    ajv = new Ajv2020({ strict: false, allErrors: false, logger: false, validateSchema: false });
+    ids = new WeakMap();
+    failed = new WeakSet();
+    nextId = 0;
+    openapi30;
+    /** @param openapi the spec's `openapi` version; 3.0 schemas get converted. */
+    constructor(openapi = '3.1.0') {
+        addFormats(this.ajv);
+        this.openapi30 = openapi.startsWith('3.0');
+    }
+    /** Validate a value; throws if the schema itself can't be compiled (e.g. a non-JS regex). */
+    validate(schema, value) {
+        if (this.failed.has(schema))
+            throw new Error('schema could not be compiled');
+        let fn;
+        try {
+            fn = this.ajv.getSchema(this.register(schema));
+        }
+        catch (err) {
+            this.failed.add(schema);
+            throw err;
+        }
+        if (!fn)
+            throw new Error('schema could not be compiled');
+        return fn(value) ? { valid: true } : { valid: false, errors: this.ajv.errorsText(fn.errors) };
+    }
+    // Every object-like schema is registered with Ajv once, under an id, and referenced
+    // from everywhere else. Shared and circular parts of big specs then compile once.
+    register(node) {
+        let id = this.ids.get(node);
+        if (!id) {
+            id = `mock:s${this.nextId++}`;
+            this.ids.set(node, id); // Before converting, so cycles find it.
+            this.ajv.addSchema({ $id: id, ...convertObject(node, this.openapi30, (child) => this.child(child)) });
+        }
+        return id;
+    }
+    child(node) {
+        if (!isObject(node))
+            return node;
+        return isComposite(node) ? { $ref: this.register(node) } : convertObject(node, this.openapi30, (c) => this.child(c));
+    }
+}
+/** Rewrite a dereferenced (possibly cyclic) OpenAPI schema as one self-contained JSON Schema. */
+export function toJsonSchema(root, openapi30) {
+    // Pass 1: count how often each schema object is reached; shared ones become $defs.
+    const refs = new Map();
+    const count = (node) => {
+        if (!isObject(node))
+            return;
+        const n = (refs.get(node) ?? 0) + 1;
+        refs.set(node, n);
+        if (n === 1)
+            forEachSubschema(node, count);
+    };
+    count(root);
+    const defs = {};
+    const names = new Map();
+    const convert = (node) => {
+        if (!isObject(node))
+            return node;
+        if ((refs.get(node) ?? 0) > 1) {
+            let name = names.get(node);
+            if (!name) {
+                name = `s${names.size}`;
+                names.set(node, name);
+                defs[name] = convertObject(node, openapi30, convert);
+            }
+            return { $ref: `#/$defs/${name}` };
+        }
+        return convertObject(node, openapi30, convert);
+    };
+    const schema = convertObject(root, openapi30, convert);
+    return Object.keys(defs).length ? { ...schema, $defs: { ...schema.$defs, ...defs } } : schema;
+}
+/** Convert one schema object's own keywords; `child` converts nested schemas. */
+function convertObject(node, openapi30, child) {
+    const out = {};
+    for (const [k, v] of Object.entries(node)) {
+        if (k.startsWith('x-') || DROPPED_KEYWORDS.has(k) || (openapi30 && k === 'nullable'))
+            continue;
+        if (SCHEMA_KEYWORDS.has(k))
+            out[k] = typeof v === 'boolean' ? v : child(v);
+        else if (SCHEMA_ARRAY_KEYWORDS.has(k) && Array.isArray(v))
+            out[k] = v.map(child);
+        else if (SCHEMA_MAP_KEYWORDS.has(k) && isObject(v))
+            out[k] = Object.fromEntries(Object.entries(v).map(([p, s]) => [p, child(s)]));
+        else if (k !== '$id' && k !== '$schema')
+            out[k] = v;
+    }
+    // OpenAPI semantics: a discriminator picks the branch, so branches that only differ
+    // by the discriminator value don't count as overlapping.
+    const disc = node.oneOf || node.anyOf ? discriminatorOf(node) : undefined;
+    if (disc) {
+        delete out.oneOf;
+        delete out.anyOf;
+        const p = disc.property;
+        out.allOf = [
+            ...(out.allOf ?? []),
+            { type: 'object', required: [p], properties: { [p]: { enum: disc.mapping.map((m) => m.value) } } },
+            ...disc.mapping.map((m) => ({ if: { properties: { [p]: { const: m.value } } }, then: child(m.schema) })),
+        ];
+    }
+    // Responses never contain writeOnly properties, so they can't be required there.
+    if (isObject(node.properties)) {
+        const writeOnly = Object.keys(node.properties).filter((p) => node.properties[p]?.writeOnly);
+        for (const p of writeOnly)
+            delete out.properties[p];
+        if (Array.isArray(out.required))
+            out.required = out.required.filter((r) => !writeOnly.includes(r));
+    }
+    if (openapi30) {
+        for (const [bound, exclusive] of [['minimum', 'exclusiveMinimum'], ['maximum', 'exclusiveMaximum']]) {
+            if (out[exclusive] === true) {
+                out[exclusive] = out[bound];
+                delete out[bound];
+            }
+            else if (out[exclusive] === false) {
+                delete out[exclusive];
+            }
+        }
+        if (node.nullable === true) {
+            if (Array.isArray(out.enum) && !out.enum.includes(null))
+                out.enum = [...out.enum, null];
+            if (typeof out.type === 'string')
+                out.type = [out.type, 'null'];
+            else if (!out.type)
+                return { anyOf: [out, { type: 'null' }] };
+        }
+    }
+    return out;
+}
+function isComposite(node) {
+    return !!(node.properties || node.allOf || node.anyOf || node.oneOf || node.items || node.additionalProperties);
+}
+function forEachSubschema(node, fn) {
+    for (const [k, v] of Object.entries(node)) {
+        if (SCHEMA_KEYWORDS.has(k))
+            fn(v);
+        else if (SCHEMA_ARRAY_KEYWORDS.has(k) && Array.isArray(v))
+            v.forEach(fn);
+        else if (SCHEMA_MAP_KEYWORDS.has(k) && isObject(v))
+            Object.values(v).forEach(fn);
+    }
+}
+function isObject(v) {
+    return !!v && typeof v === 'object' && !Array.isArray(v);
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"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","sourcesContent":["import { Ajv2020, type ValidateFunction } from 'ajv/dist/2020.js';\nimport addFormatsModule from 'ajv-formats';\nimport type { Schema } from './model.js';\nimport { discriminatorOf } from './schema.js';\n\n// Validates generated responses against their schemas. OpenAPI schemas aren't quite\n// JSON Schema (3.0 has `nullable` and boolean exclusive bounds), and dereferenced\n// specs contain object cycles Ajv can't compile, so each schema is first rewritten\n// into plain JSON Schema with shared and circular parts moved into `$defs`.\n\nconst addFormats = addFormatsModule as unknown as (ajv: Ajv2020) => void;\n\n/** Keywords whose values are schemas, maps of schemas, or arrays of schemas. */\nconst SCHEMA_KEYWORDS = new Set(['additionalProperties', 'items', 'not', 'if', 'then', 'else', 'contains', 'propertyNames', 'unevaluatedProperties', 'unevaluatedItems']);\nconst SCHEMA_ARRAY_KEYWORDS = new Set(['allOf', 'anyOf', 'oneOf', 'prefixItems']);\nconst SCHEMA_MAP_KEYWORDS = new Set(['properties', 'patternProperties', 'dependentSchemas', '$defs', 'definitions']);\n/** OpenAPI-only keywords that mean nothing to a validator. */\nconst DROPPED_KEYWORDS = new Set(['discriminator', 'xml', 'externalDocs', 'example', 'deprecated']);\n\nexport interface ValidationResult {\n  valid: boolean;\n  /** Human-readable errors when invalid. */\n  errors?: string;\n}\n\nexport class ResponseValidator {\n  private ajv = new Ajv2020({ strict: false, allErrors: false, logger: false, validateSchema: false });\n  private ids = new WeakMap<Schema, string>();\n  private failed = new WeakSet<Schema>();\n  private nextId = 0;\n  private readonly openapi30: boolean;\n\n  /** @param openapi the spec's `openapi` version; 3.0 schemas get converted. */\n  constructor(openapi = '3.1.0') {\n    addFormats(this.ajv);\n    this.openapi30 = openapi.startsWith('3.0');\n  }\n\n  /** Validate a value; throws if the schema itself can't be compiled (e.g. a non-JS regex). */\n  validate(schema: Schema, value: unknown): ValidationResult {\n    if (this.failed.has(schema)) throw new Error('schema could not be compiled');\n    let fn: ValidateFunction | undefined;\n    try {\n      fn = this.ajv.getSchema(this.register(schema));\n    } catch (err) {\n      this.failed.add(schema);\n      throw err;\n    }\n    if (!fn) throw new Error('schema could not be compiled');\n    return fn(value) ? { valid: true } : { valid: false, errors: this.ajv.errorsText(fn.errors) };\n  }\n\n  // Every object-like schema is registered with Ajv once, under an id, and referenced\n  // from everywhere else. Shared and circular parts of big specs then compile once.\n  private register(node: Schema): string {\n    let id = this.ids.get(node);\n    if (!id) {\n      id = `mock:s${this.nextId++}`;\n      this.ids.set(node, id); // Before converting, so cycles find it.\n      this.ajv.addSchema({ $id: id, ...convertObject(node, this.openapi30, (child) => this.child(child)) });\n    }\n    return id;\n  }\n\n  private child(node: unknown): unknown {\n    if (!isObject(node)) return node;\n    return isComposite(node) ? { $ref: this.register(node) } : convertObject(node, this.openapi30, (c) => this.child(c));\n  }\n}\n\n/** Rewrite a dereferenced (possibly cyclic) OpenAPI schema as one self-contained JSON Schema. */\nexport function toJsonSchema(root: Schema, openapi30: boolean): Schema {\n  // Pass 1: count how often each schema object is reached; shared ones become $defs.\n  const refs = new Map<object, number>();\n  const count = (node: unknown) => {\n    if (!isObject(node)) return;\n    const n = (refs.get(node) ?? 0) + 1;\n    refs.set(node, n);\n    if (n === 1) forEachSubschema(node, count);\n  };\n  count(root);\n\n  const defs: Record<string, Schema> = {};\n  const names = new Map<object, string>();\n  const convert = (node: unknown): unknown => {\n    if (!isObject(node)) return node;\n    if ((refs.get(node) ?? 0) > 1) {\n      let name = names.get(node);\n      if (!name) {\n        name = `s${names.size}`;\n        names.set(node, name);\n        defs[name] = convertObject(node, openapi30, convert);\n      }\n      return { $ref: `#/$defs/${name}` };\n    }\n    return convertObject(node, openapi30, convert);\n  };\n\n  const schema = convertObject(root, openapi30, convert);\n  return Object.keys(defs).length ? { ...schema, $defs: { ...schema.$defs, ...defs } } : schema;\n}\n\n/** Convert one schema object's own keywords; `child` converts nested schemas. */\nfunction convertObject(node: Schema, openapi30: boolean, child: (s: unknown) => unknown): Schema {\n  const out: Schema = {};\n  for (const [k, v] of Object.entries(node)) {\n    if (k.startsWith('x-') || DROPPED_KEYWORDS.has(k) || (openapi30 && k === 'nullable')) continue;\n    if (SCHEMA_KEYWORDS.has(k)) out[k] = typeof v === 'boolean' ? v : child(v);\n    else if (SCHEMA_ARRAY_KEYWORDS.has(k) && Array.isArray(v)) out[k] = v.map(child);\n    else if (SCHEMA_MAP_KEYWORDS.has(k) && isObject(v)) out[k] = Object.fromEntries(Object.entries(v).map(([p, s]) => [p, child(s)]));\n    else if (k !== '$id' && k !== '$schema') out[k] = v;\n  }\n\n  // OpenAPI semantics: a discriminator picks the branch, so branches that only differ\n  // by the discriminator value don't count as overlapping.\n  const disc = node.oneOf || node.anyOf ? discriminatorOf(node) : undefined;\n  if (disc) {\n    delete out.oneOf;\n    delete out.anyOf;\n    const p = disc.property;\n    out.allOf = [\n      ...(out.allOf ?? []),\n      { type: 'object', required: [p], properties: { [p]: { enum: disc.mapping.map((m) => m.value) } } },\n      ...disc.mapping.map((m) => ({ if: { properties: { [p]: { const: m.value } } }, then: child(m.schema) })),\n    ];\n  }\n\n  // Responses never contain writeOnly properties, so they can't be required there.\n  if (isObject(node.properties)) {\n    const writeOnly = Object.keys(node.properties).filter((p) => (node.properties[p] as Schema)?.writeOnly);\n    for (const p of writeOnly) delete out.properties[p];\n    if (Array.isArray(out.required)) out.required = out.required.filter((r: string) => !writeOnly.includes(r));\n  }\n\n  if (openapi30) {\n    for (const [bound, exclusive] of [['minimum', 'exclusiveMinimum'], ['maximum', 'exclusiveMaximum']] as const) {\n      if (out[exclusive] === true) {\n        out[exclusive] = out[bound];\n        delete out[bound];\n      } else if (out[exclusive] === false) {\n        delete out[exclusive];\n      }\n    }\n    if (node.nullable === true) {\n      if (Array.isArray(out.enum) && !out.enum.includes(null)) out.enum = [...out.enum, null];\n      if (typeof out.type === 'string') out.type = [out.type, 'null'];\n      else if (!out.type) return { anyOf: [out, { type: 'null' }] };\n    }\n  }\n  return out;\n}\n\nfunction isComposite(node: Schema): boolean {\n  return !!(node.properties || node.allOf || node.anyOf || node.oneOf || node.items || node.additionalProperties);\n}\n\nfunction forEachSubschema(node: Schema, fn: (s: unknown) => void) {\n  for (const [k, v] of Object.entries(node)) {\n    if (SCHEMA_KEYWORDS.has(k)) fn(v);\n    else if (SCHEMA_ARRAY_KEYWORDS.has(k) && Array.isArray(v)) v.forEach(fn);\n    else if (SCHEMA_MAP_KEYWORDS.has(k) && isObject(v)) Object.values(v).forEach(fn);\n  }\n}\n\nfunction isObject(v: unknown): v is Schema {\n  return !!v && typeof v === 'object' && !Array.isArray(v);\n}\n"]}

package/package.json

@@ -1,6 +1,70 @@
 {
   "name": "@wylan24/mockgen",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0-alpha.2",
+  "description": "Turn an OpenAPI spec into a running mock server with realistic, deterministic fake data — one command.",
+  "keywords": [
+    "mock",
+    "openapi",
+    "mock-server",
+    "api",
+    "faker",
+    "testing"
+  ],
+  "license": "MIT",
+  "author": "wylan24",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/wylan24/mockgen.git"
+  },
+  "homepage": "https://github.com/wylan24/mockgen#readme",
+  "bugs": "https://github.com/wylan24/mockgen/issues",
+  "type": "module",
+  "bin": {
+    "mockgen": "dist/cli.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.19"
+  },
+  "scripts": {
+    "clean": "node -e \"require('node:fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "npm run clean && tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "serve:example": "npm run build && node dist/cli.js serve examples/petstore.yaml",
+    "prepublishOnly": "npm run build",
+    "corpus:fetch": "tsx scripts/corpus-fetch.ts",
+    "corpus": "tsx scripts/corpus.ts",
+    "corpus:explain": "tsx scripts/corpus-explain.ts",
+    "smoke": "npm run build && tsx scripts/smoke-pack.ts"
+  },
+  "dependencies": {
+    "@apidevtools/json-schema-ref-parser": "^16.0.5",
+    "@faker-js/faker": "10.6.0",
+    "ajv": "8.20.0",
+    "ajv-formats": "3.0.1",
+    "randexp": "0.5.3",
+    "yaml": "^2.9.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.20.5",
+    "tsx": "^4.23.15",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}