assert-json-body 1.0.2

package/dist/lib/responses.d.ts

@@ -0,0 +1,13 @@
+import { RouteContext } from '../types/index.js';
+interface ResolverOptions {
+    responsesFilePath?: string;
+    configPath?: string;
+}
+export interface PickRouteOptions extends ResolverOptions {
+    method?: string;
+    status?: string;
+}
+export declare function pickRoute(path: string, method?: string, status?: string, _deprecated?: unknown): RouteContext;
+export declare function pickRoute(path: string, options?: PickRouteOptions): RouteContext;
+export {};
+//# sourceMappingURL=responses.d.ts.map

package/dist/lib/responses.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/lib/responses.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgC,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAG/E,UAAU,eAAe;IAAG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE;AA0D7E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IAAG,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AAE9F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,YAAY,CAAC;AAC/G,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,YAAY,CAAC"}

package/dist/lib/responses.js

@@ -0,0 +1,114 @@
+import { readFileSync, existsSync } from 'node:fs';
+import { resolve, isAbsolute } from 'node:path';
+import { buildConfig } from './config.js';
+let cachedConfig = null;
+const responseIndexCache = new Map();
+function loadConfigOnce(configPath) {
+    if (!cachedConfig) {
+        cachedConfig = buildConfig(configPath);
+    }
+    return cachedConfig;
+}
+function resolveResponsesFile(opts = {}) {
+    // 1. explicit option
+    if (opts.responsesFilePath) {
+        const p = isAbsolute(opts.responsesFilePath) ? opts.responsesFilePath : resolve(process.cwd(), opts.responsesFilePath);
+        return { path: p, source: 'explicit' };
+    }
+    // 2. env var
+    const envPath = process.env.ROUTE_TEST_RESPONSES_FILE || process.env.AJB_RESPONSES_FILE;
+    if (envPath) {
+        const p = isAbsolute(envPath) ? envPath : resolve(process.cwd(), envPath);
+        return { path: p, source: 'env' };
+    }
+    // 3. config (load lazily)
+    const cfg = loadConfigOnce(opts.configPath);
+    const configured = cfg.resolved.extract.responsesFile || (cfg.resolved.extract.outputDir ? resolve(process.cwd(), cfg.resolved.extract.outputDir, 'responses.json') : undefined);
+    if (configured)
+        return { path: configured, source: 'config' };
+    // 4. default (cwd/assert-json-body/responses.json)
+    return { path: resolve(process.cwd(), 'assert-json-body', 'responses.json'), source: 'default' };
+}
+function buildIndex(filePath) {
+    if (!existsSync(filePath)) {
+        throw new Error(`Responses schema file not found at ${filePath}`);
+    }
+    let raw;
+    try {
+        raw = readFileSync(filePath, 'utf8');
+    }
+    catch (e) {
+        throw new Error(`Failed to read responses schema at ${filePath}: ${e.message}`);
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch (e) {
+        throw new Error(`Failed to parse responses schema JSON at ${filePath}: ${e.message}`);
+    }
+    if (!parsed || !Array.isArray(parsed.responses)) {
+        throw new Error(`Invalid responses schema format at ${filePath}: missing 'responses' array`);
+    }
+    const map = new Map();
+    for (const entry of parsed.responses) {
+        if (!entry || typeof entry !== 'object' || !entry.path)
+            continue; // skip malformed entries silently
+        const list = map.get(entry.path) || [];
+        list.push(entry);
+        map.set(entry.path, list);
+    }
+    return map;
+}
+function getIndex(filePath) {
+    let idx = responseIndexCache.get(filePath);
+    if (!idx) {
+        idx = buildIndex(filePath);
+        responseIndexCache.set(filePath, idx);
+    }
+    return idx;
+}
+export function pickRoute(path, a, b, _d) {
+    // Hard break: if second arg is object treat as options, else legacy signature still partially honored this release but will throw if 4th param used.
+    let method;
+    let status;
+    let opts = {};
+    if (a && typeof a === 'object' && !Array.isArray(a)) {
+        opts = a;
+        method = opts.method;
+        status = opts.status;
+    }
+    else {
+        method = a;
+        status = b;
+        if (_d !== undefined)
+            throw new Error('Fourth argument to pickRoute removed; use options object instead.');
+    }
+    const resolved = resolveResponsesFile({ responsesFilePath: opts.responsesFilePath, configPath: opts.configPath });
+    const idx = getIndex(resolved.path);
+    const entries = idx.get(path) || [];
+    if (entries.length === 0) {
+        throw new Error(`No OpenAPI response spec entries found for path '${path}' (schema source: ${resolved.source} @ ${resolved.path}).`);
+    }
+    let filtered = entries;
+    if (method)
+        filtered = filtered.filter(e => e.method.toLowerCase() === method.toLowerCase());
+    if (status)
+        filtered = filtered.filter(e => e.status === status);
+    if ((method || status) && filtered.length === 0) {
+        const available = entries.map(e => `${e.method} ${e.status}`).sort().join(', ');
+        throw new Error(`No matching spec entry for ${path} with method=${method || '*'} status=${status || '*'} (schema: ${resolved.path}).\nAvailable: ${available}`);
+    }
+    const chosen = filtered.find(e => e.status === '200' && e.method === 'GET') || filtered.find(e => e.status === '200') || filtered.find(e => e.status === '201') || filtered[0];
+    const required = chosen.schema.required || [];
+    const optional = chosen.schema.optional || [];
+    return {
+        route: path,
+        method: chosen.method,
+        status: chosen.status,
+        requiredFieldNames: required.map(f => f.name),
+        requiredFields: required,
+        optionalFields: optional,
+    };
+}
+//# sourceMappingURL=responses.js.map

package/dist/lib/responses.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"responses.js","sourceRoot":"","sources":["../../src/lib/responses.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK1C,IAAI,YAAY,GAA0C,IAAI,CAAC;AAC/D,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAAwC,CAAC;AAE3E,SAAS,cAAc,CAAC,UAAmB;IACzC,IAAI,CAAC,YAAY,EAAE,CAAC;QAAC,YAAY,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC;IAAC,CAAC;IAC9D,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,SAAS,oBAAoB,CAAC,OAAwB,EAAE;IACtD,qBAAqB;IACrB,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,UAAU,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,CAAC,iBAAiB,CAAC,CAAC;QACvH,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACzC,CAAC;IACD,aAAa;IACb,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,yBAAyB,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IACxF,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,CAAC,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,CAAC,CAAC;QAC1E,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC;IACpC,CAAC;IACD,0BAA0B;IAC1B,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACjL,IAAI,UAAU;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC9D,mDAAmD;IACnD,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,kBAAkB,EAAE,gBAAgB,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;AACnG,CAAC;AAED,SAAS,UAAU,CAAC,QAAgB;IAClC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,EAAE,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,GAAW,CAAC;IAChB,IAAI,CAAC;QAAC,GAAG,GAAG,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IACvJ,IAAI,MAAqB,CAAC;IAC1B,IAAI,CAAC;QAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAkB,CAAC;IAAC,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QAAC,MAAM,IAAI,KAAK,CAAC,4CAA4C,QAAQ,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;IAAC,CAAC;IAClK,IAAI,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,KAAK,CAAC,sCAAsC,QAAQ,6BAA6B,CAAC,CAAC;IAC/F,CAAC;IACD,MAAM,GAAG,GAAG,IAAI,GAAG,EAA2B,CAAC;IAC/C,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACrC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,IAAI;YAAE,SAAS,CAAC,kCAAkC;QACpG,MAAM,IAAI,GAAG,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QACvC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACjB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,QAAQ,CAAC,QAAgB;IAChC,IAAI,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC3C,IAAI,CAAC,GAAG,EAAE,CAAC;QAAC,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAC,kBAAkB,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IAAC,CAAC;IAChF,OAAO,GAAG,CAAC;AACb,CAAC;AAMD,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,CAA6B,EAAE,CAAU,EAAE,EAAY;IAC7F,qJAAqJ;IACrJ,IAAI,MAA0B,CAAC;IAC/B,IAAI,MAA0B,CAAC;IAC/B,IAAI,IAAI,GAAqB,EAAE,CAAC;IAChC,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,IAAI,GAAG,CAAqB,CAAC;QAC7B,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QACrB,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,CAAW,CAAC;QACrB,MAAM,GAAG,CAAC,CAAC;QACX,IAAI,EAAE,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,mEAAmE,CAAC,CAAC;IAC7G,CAAC;IACD,MAAM,QAAQ,GAAG,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;IAClH,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACpC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;IACpC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,oDAAoD,IAAI,qBAAqB,QAAQ,CAAC,MAAM,MAAM,QAAQ,CAAC,IAAI,IAAI,CAAC,CAAC;IACvI,CAAC;IACD,IAAI,QAAQ,GAAG,OAAO,CAAC;IACvB,IAAI,MAAM;QAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,WAAW,EAAE,CAAC,CAAC;IAC7F,IAAI,MAAM;QAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;IACjE,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CAAC,8BAA8B,IAAI,gBAAgB,MAAM,IAAI,GAAG,WAAW,MAAM,IAAI,GAAG,aAAa,QAAQ,CAAC,IAAI,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAClK,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,IAAI,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;IAC/K,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC;IAC9C,OAAO;QACL,KAAK,EAAE,IAAI;QACX,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,kBAAkB,EAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7C,cAAc,EAAE,QAAQ;QACxB,cAAc,EAAE,QAAQ;KACzB,CAAC;AACJ,CAAC"}

package/dist/lib/schema-flatten.d.ts

@@ -0,0 +1,2 @@
+export { flatten, flattenInternal, describeType, deriveFieldMetadata, isObjectLike, primitiveFromSchema } from '../extractor/src/lib/schema-flatten.js';
+//# sourceMappingURL=schema-flatten.d.ts.map

package/dist/lib/schema-flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-flatten.d.ts","sourceRoot":"","sources":["../../src/lib/schema-flatten.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/lib/schema-flatten.js

@@ -0,0 +1,2 @@
+export { flatten, flattenInternal, describeType, deriveFieldMetadata, isObjectLike, primitiveFromSchema } from '../extractor/src/lib/schema-flatten.js';
+//# sourceMappingURL=schema-flatten.js.map

package/dist/lib/schema-flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-flatten.js","sourceRoot":"","sources":["../../src/lib/schema-flatten.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/lib/tools/diff-recordings-vs-spec.d.ts

@@ -0,0 +1,2 @@
+export * from '../../assertion/diff-recordings-vs-spec.js';
+//# sourceMappingURL=diff-recordings-vs-spec.d.ts.map

package/dist/lib/tools/diff-recordings-vs-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-recordings-vs-spec.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/diff-recordings-vs-spec.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/lib/tools/diff-recordings-vs-spec.js

@@ -0,0 +1,2 @@
+export * from '../../assertion/diff-recordings-vs-spec.js';
+//# sourceMappingURL=diff-recordings-vs-spec.js.map

package/dist/lib/tools/diff-recordings-vs-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-recordings-vs-spec.js","sourceRoot":"","sources":["../../../src/lib/tools/diff-recordings-vs-spec.ts"],"names":[],"mappings":"AAAA,cAAc,4CAA4C,CAAC"}

package/dist/lib/tools/recorder.d.ts

@@ -0,0 +1,2 @@
+export * from '../recorder.js';
+//# sourceMappingURL=recorder.d.ts.map

package/dist/lib/tools/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/recorder.ts"],"names":[],"mappings":"AACA,cAAc,gBAAgB,CAAC"}

package/dist/lib/tools/recorder.js

@@ -0,0 +1,3 @@
+// Legacy recorder relocated under lib/tools. Prefer using lib/recorder for runtime decisions.
+export * from '../recorder.js';
+//# sourceMappingURL=recorder.js.map

package/dist/lib/tools/recorder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.js","sourceRoot":"","sources":["../../../src/lib/tools/recorder.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,cAAc,gBAAgB,CAAC"}

package/dist/lib/tools/summarize-recordings.d.ts

@@ -0,0 +1,2 @@
+export * from '../../assertion/summarize-recordings.js';
+//# sourceMappingURL=summarize-recordings.d.ts.map

package/dist/lib/tools/summarize-recordings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-recordings.d.ts","sourceRoot":"","sources":["../../../src/lib/tools/summarize-recordings.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC"}

package/dist/lib/tools/summarize-recordings.js

@@ -0,0 +1,2 @@
+export * from '../../assertion/summarize-recordings.js';
+//# sourceMappingURL=summarize-recordings.js.map

package/dist/lib/tools/summarize-recordings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"summarize-recordings.js","sourceRoot":"","sources":["../../../src/lib/tools/summarize-recordings.ts"],"names":[],"mappings":"AAAA,cAAc,yCAAyC,CAAC"}

package/dist/lib/type-utils.d.ts

@@ -0,0 +1,2 @@
+export { normalizeType, refNameOf, dedupeFields } from '../extractor/src/lib/type-utils.js';
+//# sourceMappingURL=type-utils.d.ts.map

package/dist/lib/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../src/lib/type-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/lib/type-utils.js

@@ -0,0 +1,2 @@
+export { normalizeType, refNameOf, dedupeFields } from '../extractor/src/lib/type-utils.js';
+//# sourceMappingURL=type-utils.js.map

package/dist/lib/type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../src/lib/type-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/lib/validator.d.ts

@@ -0,0 +1,33 @@
+import { RouteContext, FieldSpec } from '../types/index.js';
+declare function _validateRouteContext(routeCtx: RouteContext, body: unknown): void;
+export interface ValidateOptions {
+    responsesFilePath?: string;
+    configPath?: string;
+    method?: string;
+    status?: string;
+    throw?: boolean;
+    record?: boolean | {
+        label?: string;
+    };
+}
+/**
+ * Public API: validateResponseShape(spec, body, options?)
+ * Resolves the route context (schema lookup) internally using configuration precedence.
+ */
+export interface ValidateResultBase {
+    ok: boolean;
+    errors?: string[];
+    response: unknown;
+    schema: {
+        required: FieldSpec[];
+        optional: FieldSpec[];
+    };
+    routeContext: RouteContext;
+}
+export declare function validateResponseShape(spec: {
+    path: string;
+    method?: string;
+    status?: string;
+}, body: unknown, options?: ValidateOptions): ValidateResultBase;
+export { _validateRouteContext };
+//# sourceMappingURL=validator.d.ts.map

package/dist/lib/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/lib/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,YAAY,EAAE,SAAS,EAAC,MAAM,mBAAmB,CAAC;AAe1D,iBAAS,qBAAqB,CAAC,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,QAkFnE;AAED,MAAM,WAAW,eAAe;IAAG,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AAE9K;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IAAG,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE;QAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAAC,QAAQ,EAAE,SAAS,EAAE,CAAA;KAAE,CAAC;IAAC,YAAY,EAAE,YAAY,CAAA;CAAE;AAE/K,wBAAgB,qBAAqB,CAAC,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,kBAAkB,CA0BhK;AAED,OAAO,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/lib/validator.js

@@ -0,0 +1,179 @@
+import { pickRoute } from './responses.js';
+import { recordBody } from './recorder.js';
+import { buildConfig } from './config.js';
+const isPrimitive = (t) => t === 'string' || t === 'number' || t === 'boolean';
+const extractArrayInner = (typeStr) => { const m = /^array<(.+)>$/.exec(typeStr.trim()); return m ? m[1].trim() : null; };
+const shouldTreatAsEnum = (typeStr) => /Enum$/.test(typeStr);
+const shouldTreatAsObject = (spec) => { if (spec.children)
+    return true; if (spec.type === 'object')
+    return true; if (/^[A-Z][A-Za-z0-9]+$/.test(spec.type) && !shouldTreatAsEnum(spec.type))
+    return true; return false; };
+const jsonPointerEscape = (seg) => seg.replace(/~/g, '~0').replace(/\//g, '~1');
+const toExpectedDescriptor = (spec) => { const inner = extractArrayInner(spec.type); if (inner)
+    return `array<${inner}>`; if (spec.wrapper && spec.underlyingPrimitive)
+    return `${spec.underlyingPrimitive} (wrapper ${spec.rawRefName || spec.type})`; if (spec.enumValues?.length)
+    return `enum<${spec.underlyingPrimitive || 'string'}>[${spec.enumValues.join('|')}]`; if (spec.children || spec.type === 'object')
+    return 'object'; return spec.type; };
+const actualDescriptor = (val) => { if (val === null)
+    return 'null'; if (Array.isArray(val))
+    return 'array'; return typeof val; };
+function _validateRouteContext(routeCtx, body) {
+    if (!routeCtx.route || routeCtx.requiredFields.length === 0)
+        return; // no spec
+    if (body === null || typeof body !== 'object' || Array.isArray(body)) {
+        throw new Error(`Expected object response body to validate route required fields for ${routeCtx.route}`);
+    }
+    const options = { arraySampleLimit: 25 };
+    const errors = [];
+    const checkPrimitiveType = (val, expected) => typeof val === expected;
+    const validateGroup = (obj, specs, pointer, mode, optionalSpecsForExtras) => {
+        if (mode === 'required') {
+            const allowed = new Set();
+            for (const s of specs)
+                allowed.add(s.name);
+            if (optionalSpecsForExtras) {
+                for (const s of optionalSpecsForExtras)
+                    allowed.add(s.name);
+            }
+            for (const key of Object.keys(obj)) {
+                if (!allowed.has(key)) {
+                    const fieldPath = pointer ? `${pointer}/${jsonPointerEscape(key)}` : `/${jsonPointerEscape(key)}`;
+                    errors.push(`[EXTRA] ${fieldPath} is not declared in spec`);
+                }
+            }
+        }
+        for (const spec of specs) {
+            const fieldPath = pointer ? `${pointer}/${jsonPointerEscape(spec.name)}` : `/${jsonPointerEscape(spec.name)}`;
+            const exists = spec.name in obj;
+            if (!exists) {
+                if (mode === 'required') {
+                    errors.push(`[MISSING] ${fieldPath} expected ${toExpectedDescriptor(spec)}`);
+                }
+                continue;
+            }
+            const value = obj[spec.name];
+            if (value === null) {
+                errors.push(`[TYPE] ${fieldPath} expected ${toExpectedDescriptor(spec)} but got null`);
+                continue;
+            }
+            const inner = extractArrayInner(spec.type);
+            if (inner) {
+                if (!Array.isArray(value)) {
+                    errors.push(`[TYPE] ${fieldPath} expected array<${inner}> but got ${actualDescriptor(value)}`);
+                }
+                else if (value.length > 0) {
+                    const sample = value.slice(0, options.arraySampleLimit);
+                    if (isPrimitive(inner)) {
+                        for (let i = 0; i < sample.length; i++) {
+                            const el = sample[i];
+                            if (typeof el !== inner) {
+                                errors.push(`[TYPE] ${fieldPath}/${i} expected ${inner} but got ${actualDescriptor(el)}`);
+                            }
+                        }
+                    }
+                    else if (spec.children) {
+                        for (let i = 0; i < sample.length; i++) {
+                            const el = sample[i];
+                            if (el === null || typeof el !== 'object' || Array.isArray(el)) {
+                                errors.push(`[TYPE] ${fieldPath}/${i} expected object but got ${actualDescriptor(el)}`);
+                                continue;
+                            }
+                            validateGroup(el, spec.children.required || [], `${fieldPath}/${i}`, 'required', spec.children.optional);
+                            if (spec.children.optional?.length) {
+                                validateGroup(el, spec.children.optional, `${fieldPath}/${i}`, 'optional-present');
+                            }
+                        }
+                    }
+                }
+                continue;
+            }
+            if (spec.wrapper && spec.underlyingPrimitive && isPrimitive(spec.underlyingPrimitive)) {
+                if (!checkPrimitiveType(value, spec.underlyingPrimitive)) {
+                    errors.push(`[TYPE] ${fieldPath} expected ${toExpectedDescriptor(spec)} but got ${actualDescriptor(value)}`);
+                }
+                if (spec.enumValues && typeof value === 'string') {
+                    if (!spec.enumValues.includes(value)) {
+                        errors.push(`[ENUM] ${fieldPath} value ${JSON.stringify(value)} not in [${spec.enumValues.join(', ')}]`);
+                    }
+                }
+                continue;
+            }
+            if (isPrimitive(spec.type)) {
+                if (!checkPrimitiveType(value, spec.type)) {
+                    errors.push(`[TYPE] ${fieldPath} expected ${toExpectedDescriptor(spec)} but got ${actualDescriptor(value)}`);
+                }
+                if (spec.enumValues && typeof value === 'string') {
+                    if (!spec.enumValues.includes(value)) {
+                        errors.push(`[ENUM] ${fieldPath} value ${JSON.stringify(value)} not in [${spec.enumValues.join(', ')}]`);
+                    }
+                }
+                continue;
+            }
+            if (shouldTreatAsEnum(spec.type)) {
+                if (typeof value !== 'string') {
+                    errors.push(`[TYPE] ${fieldPath} expected ${toExpectedDescriptor(spec)} but got ${actualDescriptor(value)}`);
+                }
+                if (spec.enumValues && typeof value === 'string') {
+                    if (!spec.enumValues.includes(value)) {
+                        errors.push(`[ENUM] ${fieldPath} value ${JSON.stringify(value)} not in [${spec.enumValues.join(', ')}]`);
+                    }
+                }
+                continue;
+            }
+            if (shouldTreatAsObject(spec)) {
+                if (typeof value !== 'object' || Array.isArray(value)) {
+                    errors.push(`[TYPE] ${fieldPath} expected object but got ${actualDescriptor(value)}`);
+                    continue;
+                }
+                if (spec.children) {
+                    validateGroup(value, spec.children.required || [], fieldPath, 'required', spec.children.optional);
+                    if (spec.children.optional?.length) {
+                        validateGroup(value, spec.children.optional, fieldPath, 'optional-present');
+                    }
+                }
+                continue;
+            }
+        }
+    };
+    validateGroup(body, routeCtx.requiredFields, '', 'required', routeCtx.optionalFields);
+    if (routeCtx.optionalFields.length) {
+        validateGroup(body, routeCtx.optionalFields, '', 'optional-present');
+    }
+    if (errors.length) {
+        const preview = errors.slice(0, 15).join('\n');
+        const extra = errors.length > 15 ? `\n...and ${errors.length - 15} more` : '';
+        throw new Error(`Response shape errors for route ${routeCtx.method || '*'} ${routeCtx.status || '*'} ${routeCtx.route}:\n${preview}${extra}`);
+    }
+}
+export function validateResponseShape(spec, body, options = {}) {
+    const routeCtx = pickRoute(spec.path, {
+        method: spec.method || options.method,
+        status: spec.status || options.status,
+        responsesFilePath: options.responsesFilePath,
+        configPath: options.configPath,
+    });
+    const cfg = buildConfig(options.configPath);
+    const globalThrow = cfg.resolved.validate.throwOnValidationFail;
+    const shouldThrow = options.throw !== undefined ? options.throw : globalThrow;
+    const globalRecord = cfg.resolved.validate.recordResponses;
+    const doRecord = options.record !== undefined ? !!options.record : globalRecord;
+    if (doRecord) {
+        let label;
+        if (typeof options.record === 'object' && options.record)
+            label = options.record.label;
+        recordBody({ routeCtx, body, label });
+    }
+    try {
+        _validateRouteContext(routeCtx, body);
+        return { ok: true, response: body, schema: { required: routeCtx.requiredFields, optional: routeCtx.optionalFields }, routeContext: routeCtx };
+    }
+    catch (err) {
+        if (shouldThrow)
+            throw err;
+        const msg = err.message || '';
+        const lines = msg.split('\n');
+        return { ok: false, errors: lines.slice(1).filter(Boolean), response: body, schema: { required: routeCtx.requiredFields, optional: routeCtx.optionalFields }, routeContext: routeCtx };
+    }
+}
+export { _validateRouteContext };
+//# sourceMappingURL=validator.js.map

package/dist/lib/validator.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,88 @@
+export interface FieldSpec {
+    name: string;
+    type: string;
+    children?: SchemaGroup;
+    enumValues?: string[];
+    underlyingPrimitive?: string;
+    rawRefName?: string;
+    wrapper?: boolean;
+}
+export interface SchemaGroup {
+    required: FieldSpec[];
+    optional: FieldSpec[];
+}
+export interface ResponseEntry {
+    path: string;
+    method: string;
+    status: string;
+    schema: SchemaGroup;
+}
+export interface ResponsesFileMetadata {
+    sourceRepo: string;
+    commit: string;
+    generatedAt: string;
+    specPath: string;
+    specSha256: string;
+}
+export interface ResponsesFile {
+    metadata?: ResponsesFileMetadata;
+    responses: ResponseEntry[];
+}
+export interface RouteContext {
+    route: string;
+    method?: string;
+    status?: string;
+    requiredFieldNames: string[];
+    requiredFields: FieldSpec[];
+    optionalFields: FieldSpec[];
+}
+export interface FlattenResult {
+    required: FieldSpec[];
+    optional: FieldSpec[];
+}
+/** Extraction (generate) configuration options */
+export interface ExtractConfig {
+    repo?: string;
+    specPath?: string;
+    ref?: string;
+    outputDir?: string;
+    preserveCheckout?: boolean;
+    dryRun?: boolean;
+    responsesFile?: string;
+    logLevel?: 'silent' | 'error' | 'warn' | 'info' | 'debug';
+    failIfExists?: boolean;
+}
+/** Validation behaviour configuration options */
+export interface ValidateConfig {
+    /** Enable recording of validated bodies globally (can still be overridden per call) */
+    recordResponses?: boolean;
+    /** Throw on validation failure by default (true) vs structured result mode */
+    throwOnValidationFail?: boolean;
+}
+/** Root JSON configuration file shape */
+export interface ConfigFile {
+    extract?: ExtractConfig;
+    validate?: ValidateConfig;
+    /** Room for future config sections */
+    assert?: Record<string, unknown>;
+}
+export interface ResolvedExtractConfig extends Required<Pick<ExtractConfig, 'repo' | 'specPath' | 'ref' | 'outputDir' | 'preserveCheckout' | 'dryRun' | 'logLevel' | 'failIfExists'>> {
+    responsesFile?: string;
+}
+export type ResolvedValidateConfig = Required<Pick<ValidateConfig, 'recordResponses' | 'throwOnValidationFail'>>;
+export interface ResolvedConfig {
+    extract: ResolvedExtractConfig;
+    validate: ResolvedValidateConfig;
+}
+export interface ConfigResolution {
+    filePath?: string;
+    file?: ConfigFile;
+    cli: ExtractConfig;
+    env: {
+        extract: ExtractConfig;
+        validate: ValidateConfig;
+    };
+    resolved: ResolvedConfig;
+    warnings: string[];
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

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

package/dist/types/index.js

@@ -0,0 +1,3 @@
+/* Unified type definitions combining assertion ResponseFieldSpec and extractor FieldSpec */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA,4FAA4F"}

package/dist-cjs/assertion/diff-recordings-vs-spec.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env ts-node
+export {};
+//# sourceMappingURL=diff-recordings-vs-spec.d.ts.map

package/dist-cjs/assertion/diff-recordings-vs-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff-recordings-vs-spec.d.ts","sourceRoot":"","sources":["../../src/assertion/diff-recordings-vs-spec.ts"],"names":[],"mappings":""}