assert-json-body 1.0.2

package/dist-cjs/extractor/src/lib/child-expansion.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildSchemaTree = buildSchemaTree;
+exports.resolveFieldSchema = resolveFieldSchema;
+const type_utils_js_1 = require("./type-utils.js");
+const schema_flatten_js_1 = require("./schema-flatten.js");
+function buildSchemaTree(schema, components, seen = new Set()) {
+    const flat = (0, schema_flatten_js_1.flatten)(schema, components, seen);
+    for (const group of [flat.required, flat.optional]) {
+        for (const field of group) {
+            const resolved = resolveFieldSchema(field.name, schema, components);
+            if (resolved) {
+                const { kind, target } = resolved;
+                if ((kind === 'object' || kind === 'array-object') && target) {
+                    field.children = buildSchemaTree(target, components, new Set(seen));
+                }
+                else if (kind === 'ref-object' && target) {
+                    field.children = buildSchemaTree(target, components, new Set(seen.add((0, type_utils_js_1.refNameOf)(field.type))));
+                }
+            }
+        }
+    }
+    return flat;
+}
+function resolveFieldSchema(fieldName, parentSchema, components) {
+    const isRef = (s) => '$ref' in s;
+    const isSchemaObject = (s) => !('$ref' in s);
+    const visited = new Set();
+    const propertyDefs = {};
+    const collect = (sch) => {
+        if (!sch)
+            return;
+        if (isRef(sch)) {
+            const refName = sch.$ref.split('/').pop();
+            if (visited.has(refName))
+                return;
+            visited.add(refName);
+            const target = components[refName];
+            if (target)
+                collect(target);
+            return;
+        }
+        if (isSchemaObject(sch) && sch.allOf)
+            for (const part of sch.allOf)
+                collect(part);
+        if (isSchemaObject(sch) && sch.properties)
+            Object.assign(propertyDefs, sch.properties);
+    };
+    collect(parentSchema);
+    const propSchema = propertyDefs[fieldName];
+    if (!propSchema)
+        return null;
+    if (isRef(propSchema)) {
+        const refName = propSchema.$ref.split('/').pop();
+        const target = components[refName];
+        if (target && isSchemaObject(target) && (target.type === 'object' || target.properties || target.allOf))
+            return { kind: 'ref-object', target };
+        return { kind: 'ref' };
+    }
+    if (propSchema.type === 'object' || propSchema.properties || propSchema.allOf)
+        return { kind: 'object', target: propSchema };
+    if (propSchema.type === 'array' && propSchema.items) {
+        const it = propSchema.items;
+        if (isRef(it)) {
+            const refName = it.$ref.split('/').pop();
+            const target = components[refName];
+            if (target && isSchemaObject(target) && (target.type === 'object' || target.properties || target.allOf))
+                return { kind: 'array-object', target };
+        }
+        else if (it.type === 'object' || it.properties || it.allOf) {
+            return { kind: 'array-object', target: it };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=child-expansion.js.map

package/dist-cjs/extractor/src/lib/child-expansion.js.map

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

package/dist-cjs/extractor/src/lib/git.d.ts

@@ -0,0 +1,9 @@
+export declare function run(cmd: string, args: string[], opts?: {
+    inherit?: boolean;
+}): string;
+export declare function sparseCheckout(repo: string, specPath: string, ref?: string): {
+    workdir: string;
+    commit: string;
+    specContent: string;
+};
+//# sourceMappingURL=git.d.ts.map

package/dist-cjs/extractor/src/lib/git.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.d.ts","sourceRoot":"","sources":["../../../../src/extractor/src/lib/git.ts"],"names":[],"mappings":"AAKA,wBAAgB,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,UAIhF;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,SAAS,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAUrI"}

package/dist-cjs/extractor/src/lib/git.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.run = run;
+exports.sparseCheckout = sparseCheckout;
+const node_child_process_1 = require("node:child_process");
+const node_fs_1 = require("node:fs");
+const node_os_1 = require("node:os");
+const node_path_1 = require("node:path");
+function run(cmd, args, opts = {}) {
+    const res = (0, node_child_process_1.spawnSync)(cmd, args, { stdio: opts.inherit ? 'inherit' : 'pipe', encoding: 'utf8' });
+    if (res.status !== 0)
+        throw new Error(`${cmd} ${args.join(' ')} failed: ${res.stderr || res.status}`);
+    return res.stdout;
+}
+function sparseCheckout(repo, specPath, ref = 'main') {
+    const workdir = (0, node_path_1.join)((0, node_os_1.tmpdir)(), `spec-checkout-${Date.now()}`);
+    run('git', ['init', workdir]);
+    run('git', ['-C', workdir, 'remote', 'add', '-f', 'origin', repo]);
+    run('git', ['-C', workdir, 'config', 'core.sparseCheckout', 'true']);
+    (0, node_fs_1.writeFileSync)((0, node_path_1.join)(workdir, '.git', 'info', 'sparse-checkout'), specPath + '\n');
+    run('git', ['-C', workdir, 'pull', 'origin', ref]);
+    const commit = run('git', ['-C', workdir, 'rev-parse', 'HEAD']).trim();
+    const specContent = (0, node_fs_1.readFileSync)((0, node_path_1.join)(workdir, specPath), 'utf8');
+    return { workdir, commit, specContent };
+}
+//# sourceMappingURL=git.js.map

package/dist-cjs/extractor/src/lib/git.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git.js","sourceRoot":"","sources":["../../../../src/extractor/src/lib/git.ts"],"names":[],"mappings":";;AAKA,kBAIC;AAED,wCAUC;AArBD,2DAA+C;AAC/C,qCAAsD;AACtD,qCAAiC;AACjC,yCAAiC;AAEjC,SAAgB,GAAG,CAAC,GAAW,EAAE,IAAc,EAAE,OAA8B,EAAE;IAC/E,MAAM,GAAG,GAAG,IAAA,8BAAS,EAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;IACjG,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,IAAI,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IACtG,OAAO,GAAG,CAAC,MAAM,CAAC;AACpB,CAAC;AAED,SAAgB,cAAc,CAAC,IAAY,EAAE,QAAgB,EAAE,GAAG,GAAG,MAAM;IACzE,MAAM,OAAO,GAAG,IAAA,gBAAI,EAAC,IAAA,gBAAM,GAAE,EAAE,iBAAiB,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC9D,GAAG,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9B,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC;IACnE,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC;IACrE,IAAA,uBAAa,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,iBAAiB,CAAC,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IACjF,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IACvE,MAAM,WAAW,GAAG,IAAA,sBAAY,EAAC,IAAA,gBAAI,EAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,CAAC;IAClE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;AAC1C,CAAC"}

package/dist-cjs/extractor/src/lib/schema-flatten.d.ts

@@ -0,0 +1,10 @@
+import { FieldSpec, FlattenResult, SchemaGroup as OutputSchema } from '../../../types/index.js';
+import { OpenAPIV3 } from 'openapi-types';
+export type SchemaOrRef = OpenAPIV3.SchemaObject | OpenAPIV3.ReferenceObject;
+export declare function flatten(schema: SchemaOrRef, components: Record<string, SchemaOrRef>, seen?: Set<string>): OutputSchema;
+export declare function flattenInternal(schema: SchemaOrRef, components: Record<string, SchemaOrRef>, seen?: Set<string>): FlattenResult;
+export declare function describeType(schema: SchemaOrRef | undefined, components: Record<string, SchemaOrRef>, stack?: string[]): string;
+export declare function deriveFieldMetadata(schema: SchemaOrRef, components: Record<string, SchemaOrRef>): Partial<FieldSpec>;
+export declare function isObjectLike(s: SchemaOrRef | undefined | null): boolean;
+export declare function primitiveFromSchema(schema: SchemaOrRef | undefined, components: Record<string, SchemaOrRef>, stack: string[]): string | null;
+//# sourceMappingURL=schema-flatten.d.ts.map

package/dist-cjs/extractor/src/lib/schema-flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-flatten.d.ts","sourceRoot":"","sources":["../../../../src/extractor/src/lib/schema-flatten.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEhG,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAG1C,MAAM,MAAM,WAAW,GAAG,SAAS,CAAC,YAAY,GAAG,SAAS,CAAC,eAAe,CAAC;AAM7E,wBAAgB,OAAO,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,cAAoB,GAAG,YAAY,CAG5H;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,cAAoB,GAAG,aAAa,CAkDrI;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,GAAE,MAAM,EAAO,GAAG,MAAM,CAoCnI;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,CA2CpH;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,IAAI,GAAG,OAAO,CAIvE;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,GAAG,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,GAAG,IAAI,CA2B5I"}

package/dist-cjs/extractor/src/lib/schema-flatten.js

@@ -0,0 +1,211 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.flatten = flatten;
+exports.flattenInternal = flattenInternal;
+exports.describeType = describeType;
+exports.deriveFieldMetadata = deriveFieldMetadata;
+exports.isObjectLike = isObjectLike;
+exports.primitiveFromSchema = primitiveFromSchema;
+const type_utils_js_1 = require("./type-utils.js");
+function isRef(s) { return !!s && '$ref' in s; }
+function isSchemaObject(s) { return !!s && !('$ref' in s); }
+// Functions here are extracted from original single-file implementation for clarity and testability.
+function flatten(schema, components, seen = new Set()) {
+    const { required, optional } = flattenInternal(schema, components, seen);
+    return { required, optional };
+}
+function flattenInternal(schema, components, seen = new Set()) {
+    if (isRef(schema)) {
+        const ref = schema.$ref.split('/').pop();
+        if (seen.has(ref))
+            return { required: [], optional: [] };
+        seen.add(ref);
+        const target = components[ref];
+        if (!target)
+            return { required: [], optional: [] };
+        return flattenInternal(target, components, seen);
+    }
+    let reqFields = [];
+    let optFields = [];
+    const expand = (sch, acc, refSeen) => {
+        if (!sch)
+            return;
+        if (isRef(sch)) {
+            const name = sch.$ref.split('/').pop();
+            if (refSeen.has(name))
+                return;
+            refSeen.add(name);
+            const target = components[name];
+            if (target)
+                expand(target, acc, refSeen);
+            return;
+        }
+        if (sch.allOf)
+            for (const part of sch.allOf)
+                expand(part, acc, refSeen);
+        if (isSchemaObject(sch))
+            acc.push(sch);
+    };
+    const directSchemas = [];
+    expand(schema, directSchemas, new Set());
+    const collectedRequired = new Set();
+    const collectedProps = {};
+    for (const s of directSchemas) {
+        for (const r of (s.required || []))
+            collectedRequired.add(r);
+        if (s.properties)
+            Object.assign(collectedProps, s.properties);
+    }
+    for (const [prop, propSchema] of Object.entries(collectedProps)) {
+        const metadata = deriveFieldMetadata(propSchema, components);
+        const rawType = describeType(propSchema, components);
+        const spec = {
+            name: prop,
+            type: (0, type_utils_js_1.normalizeType)(rawType),
+            ...metadata,
+        };
+        if (collectedRequired.has(prop))
+            reqFields.push(spec);
+        else
+            optFields.push(spec);
+    }
+    reqFields = (0, type_utils_js_1.dedupeFields)(reqFields);
+    optFields = (0, type_utils_js_1.dedupeFields)(optFields.filter(f => !reqFields.some(r => r.name === f.name)));
+    return { required: reqFields, optional: optFields };
+}
+function describeType(schema, components, stack = []) {
+    if (!schema)
+        return 'unknown';
+    if (isRef(schema)) {
+        const ref = schema.$ref.split('/').pop();
+        const target = components[ref];
+        if (!target)
+            return ref;
+        const prim = primitiveFromSchema(target, components, [...stack, ref]);
+        return prim ?? ref;
+    }
+    if (schema.type === 'array') {
+        const items = schema.items;
+        return `array<${(0, type_utils_js_1.normalizeType)(describeType(items, components, stack))}>`;
+    }
+    if (schema.allOf) {
+        const primCandidates = schema.allOf
+            .map((s) => primitiveFromSchema(s, components, stack))
+            .filter((t) => !!t && t !== 'object');
+        const unique = [...new Set(primCandidates)];
+        if (unique.length === 1)
+            return unique[0];
+        const hasObject = schema.allOf.some((s) => isObjectLike(s));
+        if (hasObject)
+            return 'object';
+    }
+    if (schema.type === 'object' || schema.properties)
+        return 'object';
+    if (schema.type) {
+        if (schema.type === 'string')
+            return 'string';
+        return schema.format ? `${schema.type}(${schema.format})` : schema.type;
+    }
+    if (schema.oneOf) {
+        const branches = schema.oneOf.map((s) => (0, type_utils_js_1.normalizeType)(describeType(s, components, stack)));
+        return branches.join('|');
+    }
+    if (schema.anyOf) {
+        const branches = schema.anyOf.map((s) => (0, type_utils_js_1.normalizeType)(describeType(s, components, stack)));
+        return branches.join('|');
+    }
+    return 'unknown';
+}
+function deriveFieldMetadata(schema, components) {
+    const meta = {};
+    const collectEnum = (sch) => {
+        if (!sch)
+            return undefined;
+        if (isSchemaObject(sch) && Array.isArray(sch.enum))
+            return sch.enum.map((v) => String(v));
+        if (isSchemaObject(sch) && sch.allOf) {
+            const enums = sch.allOf
+                .map((p) => collectEnum(p))
+                .filter((e) => Array.isArray(e));
+            if (enums.length)
+                return [...new Set(enums.flat())];
+        }
+        return undefined;
+    };
+    const detectWrapper = (refName, target) => {
+        if (!target)
+            return {};
+        const enumValues = collectEnum(target);
+        const underlyingPrim = primitiveFromSchema(target, components, [refName]);
+        const isPrimitiveLike = !!underlyingPrim && !(isSchemaObject(target) && (target.properties || target.type === 'object'));
+        return {
+            underlying: underlyingPrim ? (0, type_utils_js_1.normalizeType)(underlyingPrim) : undefined,
+            wrapper: !!underlyingPrim && isPrimitiveLike,
+            enumValues,
+        };
+    };
+    if (isRef(schema)) {
+        const ref = schema.$ref.split('/').pop();
+        const target = components[ref];
+        const { underlying, wrapper, enumValues } = detectWrapper(ref, target);
+        if (enumValues?.length)
+            meta.enumValues = enumValues;
+        if (wrapper && underlying)
+            meta.underlyingPrimitive = underlying;
+        meta.rawRefName = ref;
+        if (wrapper)
+            meta.wrapper = true;
+        return meta;
+    }
+    if (schema.allOf) {
+        const enumValues = collectEnum(schema);
+        if (enumValues?.length)
+            meta.enumValues = enumValues;
+    }
+    else if (isSchemaObject(schema) && schema.enum) {
+        meta.enumValues = schema.enum.map((v) => String(v));
+    }
+    return meta;
+}
+function isObjectLike(s) {
+    if (!s)
+        return false;
+    if (isRef(s))
+        return false; // handled elsewhere
+    return !!(s.type === 'object' || s.properties || s.allOf);
+}
+function primitiveFromSchema(schema, components, stack) {
+    if (!schema)
+        return null;
+    if (isRef(schema)) {
+        const ref = schema.$ref.split('/').pop();
+        if (stack.includes(ref))
+            return ref; // cycle guard returns ref name
+        const target = components[ref];
+        if (!target)
+            return ref;
+        const rec = primitiveFromSchema(target, components, [...stack, ref]);
+        return rec ?? ref;
+    }
+    if (schema.allOf) {
+        const parts = schema.allOf.map((p) => primitiveFromSchema(p, components, stack)).filter(Boolean);
+        const uniq = [...new Set(parts)];
+        if (uniq.length === 1)
+            return uniq[0];
+        const bases = [...new Set(uniq.map(u => u.split('(')[0]))];
+        if (bases.length === 1) {
+            const withFormat = uniq.filter(u => u.includes('('));
+            if (withFormat.length === 1)
+                return withFormat[0];
+            return uniq.sort((a, b) => b.length - a.length)[0];
+        }
+        return null;
+    }
+    if (schema.type && schema.type !== 'object' && !schema.properties && schema.items === undefined) {
+        if (schema.type === 'string')
+            return 'string';
+        return schema.format ? `${schema.type}(${schema.format})` : schema.type;
+    }
+    return null;
+}
+//# sourceMappingURL=schema-flatten.js.map

package/dist-cjs/extractor/src/lib/schema-flatten.js.map

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

package/dist-cjs/extractor/src/lib/type-utils.d.ts

@@ -0,0 +1,5 @@
+import { FieldSpec } from '../../../types/index.js';
+export declare function normalizeType(t: string): string;
+export declare function refNameOf(t: string): string;
+export declare function dedupeFields(arr: FieldSpec[]): FieldSpec[];
+//# sourceMappingURL=type-utils.d.ts.map

package/dist-cjs/extractor/src/lib/type-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.d.ts","sourceRoot":"","sources":["../../../../src/extractor/src/lib/type-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEpD,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAW/C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAmD;AAE/F,wBAAgB,YAAY,CAAC,GAAG,EAAE,SAAS,EAAE,GAAG,SAAS,EAAE,CAK1D"}

package/dist-cjs/extractor/src/lib/type-utils.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeType = normalizeType;
+exports.refNameOf = refNameOf;
+exports.dedupeFields = dedupeFields;
+function normalizeType(t) {
+    if (!t)
+        return t;
+    if (t.startsWith('string('))
+        return 'string';
+    t = t.replace(/array<string\([^>]+\)>/g, 'array<string>');
+    if (t === 'integer' || /^integer\(/.test(t))
+        t = 'number';
+    t = t.replace(/\binteger(?:\([^)]*\))?\b/g, 'number');
+    t = t.replace(/array<integer(?:\([^>]*\))?>/g, 'array<number>');
+    // Collapse formatted numbers produced after integer replacement inside unions or generics
+    t = t.replace(/\bnumber\([^)]*\)\b/g, 'number');
+    t = t.replace(/array<number\([^>]*\)>/g, 'array<number>');
+    return t;
+}
+function refNameOf(t) { return t.split('<').pop().replace(/>.*/, ''); }
+function dedupeFields(arr) {
+    const seen = new Set();
+    const out = [];
+    for (const f of arr)
+        if (!seen.has(f.name)) {
+            out.push(f);
+            seen.add(f.name);
+        }
+    return out.sort((a, b) => a.name.localeCompare(b.name));
+}
+//# sourceMappingURL=type-utils.js.map

package/dist-cjs/extractor/src/lib/type-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-utils.js","sourceRoot":"","sources":["../../../../src/extractor/src/lib/type-utils.ts"],"names":[],"mappings":";;AAEA,sCAWC;AAED,8BAA+F;AAE/F,oCAKC;AApBD,SAAgB,aAAa,CAAC,CAAS;IACrC,IAAI,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IACjB,IAAI,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAC7C,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;IAC1D,IAAI,CAAC,KAAK,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC;QAAE,CAAC,GAAG,QAAQ,CAAC;IAC1D,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,4BAA4B,EAAE,QAAQ,CAAC,CAAC;IACtD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,+BAA+B,EAAE,eAAe,CAAC,CAAC;IAChE,0FAA0F;IAC1F,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,sBAAsB,EAAE,QAAQ,CAAC,CAAC;IAChD,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,yBAAyB,EAAE,eAAe,CAAC,CAAC;IAC1D,OAAO,CAAC,CAAC;AACX,CAAC;AAED,SAAgB,SAAS,CAAC,CAAS,IAAY,OAAO,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;AAE/F,SAAgB,YAAY,CAAC,GAAgB;IAC3C,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;YAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAAC,CAAC;IAC9E,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAC,CAAC,EAAC,EAAE,CAAA,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AACvD,CAAC"}

package/dist-cjs/index.d.ts

@@ -0,0 +1,5 @@
+export * from './types/index.js';
+export { pickRoute } from './lib/responses.js';
+export { validateResponseShape, ValidateResultBase } from './lib/validator.js';
+export { recordBody } from './lib/recorder.js';
+//# sourceMappingURL=index.d.ts.map

package/dist-cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC"}

package/dist-cjs/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordBody = exports.validateResponseShape = exports.pickRoute = void 0;
+// Framework-agnostic public API surface
+__exportStar(require("./types/index.js"), exports);
+var responses_js_1 = require("./lib/responses.js");
+Object.defineProperty(exports, "pickRoute", { enumerable: true, get: function () { return responses_js_1.pickRoute; } });
+var validator_js_1 = require("./lib/validator.js");
+Object.defineProperty(exports, "validateResponseShape", { enumerable: true, get: function () { return validator_js_1.validateResponseShape; } });
+var recorder_js_1 = require("./lib/recorder.js");
+Object.defineProperty(exports, "recordBody", { enumerable: true, get: function () { return recorder_js_1.recordBody; } });
+//# sourceMappingURL=index.js.map

package/dist-cjs/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,wCAAwC;AACxC,mDAAiC;AACjC,mDAA+C;AAAtC,yGAAA,SAAS,OAAA;AAClB,mDAA+E;AAAtE,qHAAA,qBAAqB,OAAA;AAC9B,iDAA+C;AAAtC,yGAAA,UAAU,OAAA"}

package/dist-cjs/lib/assert.d.ts

@@ -0,0 +1,27 @@
+export interface AssertionSpec {
+    path: string;
+    method?: string;
+    status?: string;
+}
+export interface AssertionOptions {
+    /** If false, do not throw; instead return { ok:false, errors } */
+    throw?: boolean;
+    /** Enable body recording (requires env TEST_RESPONSE_BODY_RECORD_DIR); optional test label */
+    record?: boolean | {
+        label?: string;
+    };
+    /** Alternate responses file path (overrides environment resolution) */
+    responsesFilePath?: string;
+    /** Optional explicit config file path (looked up relative to cwd if relative) */
+    configPath?: string;
+}
+export interface AssertionResult {
+    ok: boolean;
+    errors?: string[];
+}
+/**
+ * High-level assertion helper: resolves the route spec entry and validates the given body.
+ * Throws by default on mismatch; pass { throw:false } to receive a structured result instead.
+ */
+export declare function assertResponseShape(spec: AssertionSpec, body: unknown, options?: AssertionOptions): AssertionResult | void;
+//# sourceMappingURL=assert.d.ts.map

package/dist-cjs/lib/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../src/lib/assert.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,aAAa;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACjF,MAAM,WAAW,gBAAgB;IAC/B,kEAAkE;IAClE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,8FAA8F;IAC9F,MAAM,CAAC,EAAE,OAAO,GAAG;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACtC,uEAAuE;IACvE,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iFAAiF;IACjF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAAG,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE;AAEnE;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,eAAe,GAAG,IAAI,CAoB9H"}

package/dist-cjs/lib/assert.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertResponseShape = assertResponseShape;
+const responses_js_1 = require("./responses.js");
+const recorder_js_1 = require("./recorder.js");
+const validator_js_1 = require("./validator.js");
+/**
+ * High-level assertion helper: resolves the route spec entry and validates the given body.
+ * Throws by default on mismatch; pass { throw:false } to receive a structured result instead.
+ */
+function assertResponseShape(spec, body, options = {}) {
+    const routeCtx = (0, responses_js_1.pickRoute)(spec.path, { method: spec.method, status: spec.status, responsesFilePath: options.responsesFilePath, configPath: options.configPath });
+    const wantRecord = !!options.record;
+    if (wantRecord) {
+        let label;
+        if (typeof options.record === 'object' && options.record)
+            label = options.record.label;
+        (0, recorder_js_1.recordBody)({ routeCtx, body, label });
+    }
+    try {
+        (0, validator_js_1._validateRouteContext)(routeCtx, body);
+        if (options.throw === false)
+            return { ok: true };
+    }
+    catch (err) {
+        if (options.throw === false) {
+            const msg = err.message || '';
+            // first line is summary; retain full message lines after summary for detail
+            const lines = msg.split('\n');
+            return { ok: false, errors: lines.slice(1).filter(Boolean) };
+        }
+        throw err;
+    }
+}
+//# sourceMappingURL=assert.js.map

package/dist-cjs/lib/assert.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.js","sourceRoot":"","sources":["../../src/lib/assert.ts"],"names":[],"mappings":";;AAuBA,kDAoBC;AA3CD,iDAA2C;AAC3C,+CAA2C;AAC3C,iDAAuD;AAiBvD;;;GAGG;AACH,SAAgB,mBAAmB,CAAC,IAAmB,EAAE,IAAa,EAAE,UAA4B,EAAE;IACpG,MAAM,QAAQ,GAAiB,IAAA,wBAAS,EAAC,IAAI,CAAC,IAAI,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,iBAAiB,EAAE,OAAO,CAAC,iBAAiB,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChL,MAAM,UAAU,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACpC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,KAAyB,CAAC;QAC9B,IAAI,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,IAAI,OAAO,CAAC,MAAM;YAAE,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;QACvF,IAAA,wBAAU,EAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC;QACL,IAAA,oCAAqB,EAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpC,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK;YAAE,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;YAC5B,MAAM,GAAG,GAAI,GAAa,CAAC,OAAO,IAAI,EAAE,CAAC;YACzC,4EAA4E;YAC5E,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC9B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/D,CAAC;QACD,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist-cjs/lib/child-expansion.d.ts

@@ -0,0 +1,2 @@
+export { buildSchemaTree, resolveFieldSchema } from '../extractor/src/lib/child-expansion.js';
+//# sourceMappingURL=child-expansion.d.ts.map

package/dist-cjs/lib/child-expansion.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-expansion.d.ts","sourceRoot":"","sources":["../../src/lib/child-expansion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC"}

package/dist-cjs/lib/child-expansion.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveFieldSchema = exports.buildSchemaTree = void 0;
+var child_expansion_js_1 = require("../extractor/src/lib/child-expansion.js");
+Object.defineProperty(exports, "buildSchemaTree", { enumerable: true, get: function () { return child_expansion_js_1.buildSchemaTree; } });
+Object.defineProperty(exports, "resolveFieldSchema", { enumerable: true, get: function () { return child_expansion_js_1.resolveFieldSchema; } });
+//# sourceMappingURL=child-expansion.js.map

package/dist-cjs/lib/child-expansion.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-expansion.js","sourceRoot":"","sources":["../../src/lib/child-expansion.ts"],"names":[],"mappings":";;;AAAA,8EAA8F;AAArF,qHAAA,eAAe,OAAA;AAAE,wHAAA,kBAAkB,OAAA"}

package/dist-cjs/lib/config.d.ts

@@ -0,0 +1,27 @@
+import { ExtractConfig, ValidateConfig, ConfigFile, ConfigResolution, ResolvedConfig } from '../types/index.js';
+export declare function loadConfigFile(cwd?: string, explicitPath?: string): {
+    filePath?: string;
+    file?: ConfigFile;
+    error?: Error;
+};
+export declare function parseCliArgs(argv?: string[]): {
+    command?: string;
+    args: Record<string, string | boolean>;
+    positionals: string[];
+};
+export declare function cliConfigSubset(raw: Record<string, string | boolean>): ExtractConfig;
+export declare function envConfigSubset(env?: NodeJS.ProcessEnv): {
+    extract: ExtractConfig;
+    validate: ValidateConfig;
+};
+export declare function resolveConfig(parts: {
+    file?: ConfigFile;
+    cli: ExtractConfig;
+    env: {
+        extract: ExtractConfig;
+        validate: ValidateConfig;
+    };
+    warnings: string[];
+}): ResolvedConfig;
+export declare function buildConfig(explicitConfigPath?: string): ConfigResolution;
+//# sourceMappingURL=config.d.ts.map

package/dist-cjs/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAiD,gBAAgB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAqB/J,wBAAgB,cAAc,CAAC,GAAG,GAAE,MAAsB,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAE,CAU1I;AAED,wBAAgB,YAAY,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,GAAC,OAAO,CAAC,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,CAiBrJ;AAQD,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAC,MAAM,GAAC,OAAO,CAAC,GAAG,aAAa,CAEjF;AAED,wBAAgB,eAAe,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG;IAAE,OAAO,EAAE,aAAa,CAAC;IAAC,QAAQ,EAAE,cAAc,CAAA;CAAE,CAoB1H;AAaD,wBAAgB,aAAa,CAAC,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,UAAU,CAAC;IAAC,GAAG,EAAE,aAAa,CAAC;IAAC,GAAG,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,QAAQ,EAAE,cAAc,CAAA;KAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,cAAc,CAoB7K;AAED,wBAAgB,WAAW,CAAC,kBAAkB,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAUzE"}