assert-json-body 1.0.2

package/dist-cjs/assertion/diff-recordings-vs-spec.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env ts-node
+"use strict";
+/*
+ * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH under
+ * one or more contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright ownership.
+ * Licensed under the Camunda License 1.0. You may not use this file
+ * except in compliance with the Camunda License 1.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Diff recorder observations against the spec-derived responses.json to
+ * recommend which optional fields (top-level & deep) should be promoted
+ * to required based on presence frequency.
+ *
+ * Data sources:
+ *   1. Recording directory (JSONL) from TEST_RESPONSE_BODY_RECORD_DIR (or arg1)
+ *   2. responses.json (default path or ROUTE_TEST_RESPONSES_FILE override)
+ *
+ * Usage:
+ *   ts-node diff-recordings-vs-spec.ts <record-dir?> <thresholdPct=100>
+ *
+ * Output: JSON report similar to summarize-recordings but restricted only to
+ * fields that are optional in the current spec.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const recordDir = process.argv[2] || process.env.TEST_RESPONSE_BODY_RECORD_DIR;
+const thresholdPct = Number(process.argv[3] || '100');
+if (!recordDir) {
+    console.error('Usage: diff-recordings-vs-spec <record-dir?> <thresholdPct=100>');
+    process.exit(1);
+}
+// Resolve responses.json path (same logic as runtime module)
+const RESPONSES_FILE_ENV = process.env.ROUTE_TEST_RESPONSES_FILE;
+const DEFAULT_RESPONSES_PATH = (0, node_path_1.resolve)(__dirname, '../../response-required-extractor/output/responses.json');
+const RESPONSES_PATH = RESPONSES_FILE_ENV
+    ? (0, node_path_1.resolve)(process.cwd(), RESPONSES_FILE_ENV)
+    : DEFAULT_RESPONSES_PATH;
+let parsedSpec = null;
+try {
+    parsedSpec = JSON.parse((0, node_fs_1.readFileSync)(RESPONSES_PATH, 'utf8'));
+}
+catch (e) {
+    console.error('Failed to load responses.json at', RESPONSES_PATH, e);
+    process.exit(1);
+}
+function specKey(path, method, status) {
+    return `${method.toUpperCase()} ${status} ${path}`;
+}
+const specIndex = new Map();
+for (const entry of parsedSpec.responses) {
+    specIndex.set(specKey(entry.path, entry.method, entry.status), {
+        required: new Set((entry.schema.required || []).map((f) => f.name)),
+        optional: new Set((entry.schema.optional || []).map((f) => f.name)),
+    });
+}
+function recKey(route, method, status) {
+    return `${(method || 'ANY').toUpperCase()} ${(status || 'ANY')} ${route}`;
+}
+const aggIndex = new Map();
+function isJsonl(f) { return f.endsWith('.jsonl'); }
+for (const file of (0, node_fs_1.readdirSync)(recordDir)) {
+    if (!isJsonl(file))
+        continue;
+    const full = (0, node_path_1.resolve)(recordDir, file);
+    const st = (0, node_fs_1.statSync)(full);
+    if (!st.isFile())
+        continue;
+    const lines = (0, node_fs_1.readFileSync)(full, 'utf8').split(/\n+/).filter(Boolean);
+    for (const line of lines) {
+        try {
+            const obj = JSON.parse(line);
+            const key = recKey(obj.route, obj.method, obj.status);
+            let a = aggIndex.get(key);
+            if (!a) {
+                a = {
+                    route: obj.route,
+                    method: (obj.method || 'ANY').toUpperCase(),
+                    status: obj.status || 'ANY',
+                    samples: 0,
+                    required: new Set(obj.required || []),
+                    presentCounts: new Map(),
+                    deepCounts: new Map(),
+                };
+                aggIndex.set(key, a);
+            }
+            a.samples++;
+            for (const f of obj.present || []) {
+                a.presentCounts.set(f, (a.presentCounts.get(f) || 0) + 1);
+            }
+            for (const p of obj.deepPresent || []) {
+                a.deepCounts.set(p, (a.deepCounts.get(p) || 0) + 1);
+            }
+        }
+        catch { /* ignore malformed */ }
+    }
+}
+const results = [];
+for (const [, agg] of aggIndex.entries()) {
+    // Only attempt method/status exact matches in spec; skip wildcard ANY groups
+    if (agg.method === 'ANY' || agg.status === 'ANY')
+        continue;
+    const sKey = specKey(agg.route, agg.method, agg.status);
+    const spec = specIndex.get(sKey);
+    if (!spec)
+        continue; // skip recordings not in spec (maybe new route)
+    const thresholdCount = Math.ceil((thresholdPct / 100) * agg.samples);
+    const candidates = [];
+    // Top-level optional candidates
+    for (const [field, count] of agg.presentCounts.entries()) {
+        if (spec.required.has(field))
+            continue; // already required
+        if (!spec.optional.has(field))
+            continue; // ignore undeclared extras
+        if (count >= thresholdCount) {
+            candidates.push({
+                field,
+                pct: (count / agg.samples) * 100,
+                count,
+                level: 'top',
+                reason: `Observed in ${count}/${agg.samples} samples (${((count / agg.samples) * 100).toFixed(1)}%)`,
+            });
+        }
+    }
+    // Deep candidates: we only look at pointers where the first segment is an optional top-level field
+    for (const [ptr, count] of agg.deepCounts.entries()) {
+        if (!ptr.startsWith('/'))
+            continue;
+        const topSeg = ptr.split('/')[1];
+        if (!spec.optional.has(topSeg))
+            continue; // only consider deep paths under optional parents
+        if (spec.required.has(topSeg))
+            continue; // parent already required
+        if (count >= thresholdCount) {
+            candidates.push({
+                field: ptr,
+                pct: (count / agg.samples) * 100,
+                count,
+                level: 'deep',
+                reason: `Deep presence under optional parent ${topSeg} in ${count}/${agg.samples} samples (${((count / agg.samples) * 100).toFixed(1)}%)`,
+            });
+        }
+    }
+    candidates.sort((a, b) => b.pct - a.pct || a.field.localeCompare(b.field));
+    results.push({
+        route: agg.route,
+        method: agg.method,
+        status: agg.status,
+        samples: agg.samples,
+        specRequired: Array.from(spec.required).sort(),
+        specOptional: Array.from(spec.optional).sort(),
+        candidates,
+    });
+}
+results.sort((a, b) => a.route.localeCompare(b.route) ||
+    a.method.localeCompare(b.method) ||
+    a.status.localeCompare(b.status));
+const payload = {
+    generatedAt: new Date().toISOString(),
+    thresholdPct,
+    totalGroups: results.length,
+    items: results,
+};
+console.log(JSON.stringify(payload, null, 2));
+// Human summary to stderr
+console.error('\n--- Promotion diff (spec optional -> always observed) ---');
+for (const r of results) {
+    const top = r.candidates
+        .filter((c) => c.level === 'top')
+        .slice(0, 6)
+        .map((c) => `${c.field}:${c.pct.toFixed(0)}%`)
+        .join(', ');
+    if (top) {
+        console.error(`${r.method} ${r.status} ${r.route}  samples=${r.samples}  promote: ${top}`);
+    }
+}
+//# sourceMappingURL=diff-recordings-vs-spec.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/assertion/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC"}

package/dist-cjs/assertion/index.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist-cjs/assertion/index.js.map

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

package/dist-cjs/assertion/recorder.d.ts

@@ -0,0 +1,7 @@
+import { RouteContext } from '../types/index.js';
+export declare function recordBody(opts: {
+    routeCtx: RouteContext;
+    body: unknown;
+    testTitle?: string;
+}): void;
+//# sourceMappingURL=recorder.d.ts.map

package/dist-cjs/assertion/recorder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"recorder.d.ts","sourceRoot":"","sources":["../../src/assertion/recorder.ts"],"names":[],"mappings":"AASA,OAAO,EAAC,YAAY,EAAC,MAAM,mBAAmB,CAAC;AAmB/C,wBAAgB,UAAU,CAAC,IAAI,EAAE;IAC/B,QAAQ,EAAE,YAAY,CAAC;IACvB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAsDP"}

package/dist-cjs/assertion/recorder.js

@@ -0,0 +1,84 @@
+"use strict";
+/*
+ * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH under
+ * one or more contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright ownership.
+ * Licensed under the Camunda License 1.0. You may not use this file
+ * except in compliance with the Camunda License 1.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.recordBody = recordBody;
+const node_fs_1 = require("node:fs");
+const RECORD_DIR = process.env.TEST_RESPONSE_BODY_RECORD_DIR;
+function ensureRecordDir() {
+    if (!RECORD_DIR)
+        return;
+    if (!(0, node_fs_1.existsSync)(RECORD_DIR)) {
+        try {
+            (0, node_fs_1.mkdirSync)(RECORD_DIR, { recursive: true });
+        }
+        catch {
+            /* ignore */
+        }
+    }
+}
+function sanitizeForFile(name) {
+    return name.replace(/^\//, '').replace(/[^A-Za-z0-9._-]+/g, '_');
+}
+function recordBody(opts) {
+    if (!RECORD_DIR)
+        return;
+    try {
+        ensureRecordDir();
+        const { routeCtx, body, testTitle } = opts;
+        const fileBase = `${(routeCtx.method || 'ANY').toUpperCase()}_${routeCtx.status || 'ANY'}_${sanitizeForFile(routeCtx.route)}`;
+        const file = `${RECORD_DIR}/${fileBase}.jsonl`;
+        const present = [];
+        const deepSet = new Set();
+        const isObj = (v) => !!v && typeof v === 'object' && !Array.isArray(v);
+        const escape = (seg) => seg.replace(/~/g, '~0').replace(/\//g, '~1');
+        const addPath = (p) => {
+            if (p)
+                deepSet.add(p);
+        };
+        const walk = (val, base) => {
+            if (isObj(val)) {
+                for (const key of Object.keys(val)) {
+                    const ptr = `${base}/${escape(key)}`;
+                    addPath(ptr);
+                    walk(val[key], ptr);
+                }
+            }
+            else if (Array.isArray(val)) {
+                for (let i = 0; i < val.length; i++) {
+                    const el = val[i];
+                    if (isObj(el) || Array.isArray(el)) {
+                        walk(el, `${base}/*`);
+                    }
+                }
+            }
+        };
+        if (isObj(body)) {
+            for (const k of Object.keys(body))
+                present.push(k);
+            walk(body, '');
+        }
+        const deepPresent = Array.from(deepSet).sort();
+        const line = JSON.stringify({
+            ts: new Date().toISOString(),
+            route: routeCtx.route,
+            method: routeCtx.method,
+            status: routeCtx.status,
+            test: testTitle,
+            required: routeCtx.requiredFieldNames,
+            present,
+            deepPresent,
+            body,
+        });
+        (0, node_fs_1.appendFileSync)(file, line + '\n');
+    }
+    catch {
+        /* ignore */
+    }
+}
+//# sourceMappingURL=recorder.js.map

package/dist-cjs/assertion/recorder.js.map

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

package/dist-cjs/assertion/summarize-recordings.d.ts

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

package/dist-cjs/assertion/summarize-recordings.d.ts.map

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

package/dist-cjs/assertion/summarize-recordings.js

@@ -0,0 +1,123 @@
+#!/usr/bin/env ts-node
+"use strict";
+/*
+ * Copyright Camunda Services GmbH and/or licensed to Camunda Services GmbH under
+ * one or more contributor license agreements. See the NOTICE file distributed
+ * with this work for additional information regarding copyright ownership.
+ * Licensed under the Camunda License 1.0. You may not use this file
+ * except in compliance with the Camunda License 1.0.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Summarize recorded response bodies (JSONL) produced by TEST_RESPONSE_BODY_RECORD_DIR
+ * to propose fields that appear in N% (default 100%) of observations but are not
+ * marked required in the spec-derived artifact.
+ */
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const dir = process.argv[2] || process.env.TEST_RESPONSE_BODY_RECORD_DIR;
+if (!dir) {
+    console.error('Usage: summarize-recordings <record-dir> [thresholdPct=100]');
+    process.exit(1);
+}
+const thresholdPct = Number(process.argv[3] || '100');
+function isJsonlFile(f) {
+    return f.endsWith('.jsonl');
+}
+function groupKey(route, method, status) {
+    return `${method || 'ANY'} ${status || 'ANY'} ${route}`;
+}
+const aggregates = new Map();
+for (const file of (0, node_fs_1.readdirSync)(dir)) {
+    const full = (0, node_path_1.resolve)(dir, file);
+    if (!isJsonlFile(file))
+        continue;
+    const stat = (0, node_fs_1.statSync)(full);
+    if (!stat.isFile())
+        continue;
+    const lines = (0, node_fs_1.readFileSync)(full, 'utf8').split(/\n+/).filter(Boolean);
+    for (const line of lines) {
+        try {
+            const parsed = JSON.parse(line);
+            const key = groupKey(parsed.route, parsed.method, parsed.status);
+            let agg = aggregates.get(key);
+            if (!agg) {
+                agg = {
+                    route: parsed.route,
+                    method: parsed.method || 'ANY',
+                    status: parsed.status || 'ANY',
+                    samples: 0,
+                    required: new Set(parsed.required || []),
+                    presentCounts: new Map(),
+                    deepCounts: new Map(),
+                };
+                aggregates.set(key, agg);
+            }
+            agg.samples++;
+            for (const f of parsed.present || []) {
+                agg.presentCounts.set(f, (agg.presentCounts.get(f) || 0) + 1);
+            }
+            for (const p of parsed.deepPresent || []) {
+                agg.deepCounts.set(p, (agg.deepCounts.get(p) || 0) + 1);
+            }
+        }
+        catch {
+            // skip malformed line
+        }
+    }
+}
+const report = [];
+for (const [key, agg] of aggregates.entries()) {
+    const promote = [];
+    const thresholdCount = Math.ceil((thresholdPct / 100) * agg.samples);
+    for (const [field, count] of agg.presentCounts.entries()) {
+        if (!agg.required.has(field) && count >= thresholdCount) {
+            promote.push({
+                field,
+                pct: (count / agg.samples) * 100,
+                count,
+                level: 'top',
+            });
+        }
+    }
+    for (const [ptr, count] of agg.deepCounts.entries()) {
+        // Skip root-level (empty) and focus on pointers like /field, /field/sub, /field/*/id
+        if (!ptr.startsWith('/'))
+            continue;
+        const topSeg = ptr.split('/')[1];
+        if (agg.required.has(topSeg))
+            continue; // already required at top-level
+        if (count >= thresholdCount) {
+            promote.push({
+                field: ptr,
+                pct: (count / agg.samples) * 100,
+                count,
+                level: 'deep',
+            });
+        }
+    }
+    promote.sort((a, b) => b.pct - a.pct || a.field.localeCompare(b.field));
+    report.push({
+        key,
+        route: agg.route,
+        method: agg.method,
+        status: agg.status,
+        samples: agg.samples,
+        required: Array.from(agg.required).sort(),
+        promote,
+    });
+}
+report.sort((a, b) => a.route.localeCompare(b.route) ||
+    a.method.localeCompare(b.method) ||
+    a.status.localeCompare(b.status));
+// Output JSON for machine usage & a concise human summary
+console.log(JSON.stringify({ thresholdPct, generatedAt: new Date().toISOString(), items: report }, null, 2));
+console.error('\n--- Promotion summary (top candidates) ---');
+for (const r of report) {
+    const tops = r.promote
+        .slice(0, 8)
+        .map((p) => `${p.field}(${p.level === 'top' ? 'T' : 'D'}:${p.pct.toFixed(0)}%)`)
+        .join(', ');
+    console.error(`${r.method} ${r.status} ${r.route}  samples=${r.samples}  promote: ${tops}`);
+}
+//# sourceMappingURL=summarize-recordings.js.map

package/dist-cjs/assertion/summarize-recordings.js.map

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

package/dist-cjs/assertion/validator.d.ts

@@ -0,0 +1,2 @@
+export { validateResponseShape } from '../lib/validator.js';
+//# sourceMappingURL=validator.d.ts.map

package/dist-cjs/assertion/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../src/assertion/validator.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist-cjs/assertion/validator.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResponseShape = void 0;
+// Shim: validator relocated to unified lib implementation
+var validator_js_1 = require("../lib/validator.js");
+Object.defineProperty(exports, "validateResponseShape", { enumerable: true, get: function () { return validator_js_1.validateResponseShape; } });
+//# sourceMappingURL=validator.js.map

package/dist-cjs/assertion/validator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.js","sourceRoot":"","sources":["../../src/assertion/validator.ts"],"names":[],"mappings":";;;AAAA,0DAA0D;AAC1D,oDAA4D;AAAnD,qHAAA,qBAAqB,OAAA"}

package/dist-cjs/base.d.ts

@@ -0,0 +1,2 @@
+export { validateResponseShape } from './lib/validator.js';
+//# sourceMappingURL=base.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist-cjs/base.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateResponseShape = void 0;
+// Minimal stable base export (no typed wrapper) for internal & generated imports
+var validator_js_1 = require("./lib/validator.js");
+Object.defineProperty(exports, "validateResponseShape", { enumerable: true, get: function () { return validator_js_1.validateResponseShape; } });
+//# sourceMappingURL=base.js.map

package/dist-cjs/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../src/base.ts"],"names":[],"mappings":";;;AAAA,iFAAiF;AACjF,mDAA2D;AAAlD,qHAAA,qBAAqB,OAAA"}

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist-cjs/cli/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const extractor_js_1 = require("../lib/extractor.js");
+const config_js_1 = require("../lib/config.js");
+const node_fs_1 = require("node:fs");
+function printVersion() {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const pkg = require('../../package.json');
+    console.log(pkg.version);
+}
+function printHelp() {
+    console.log(`assert-json-body <command> [options]\n\nCommands:\n  extract            Run extraction (default)\n  init-config        Create example assert-json-body.config.json\n  help               Show this help\n  version            Print version\n\nExtraction Options (CLI/env override config.extract):\n  --repo=URL\n  --specPath=PATH\n  --ref=REF                 (branch/tag/sha)\n  --outputDir=DIR           (default: assert-json-body)\n  --responsesFile=FILE      (override output file path)\n  --preserveCheckout        (do not delete temp git checkout)\n  --dryRun                  (simulate, no filesystem writes)\n  --failIfExists            (error if responses file exists)\n  --logLevel=VAL            (silent|error|warn|info|debug)\n  --config=FILE             (explicit config file path)\n\nValidation (env overrides only for now):\n  AJB_RECORD / TEST_RESPONSE_BODY_RECORD (enable global recording)\n  AJB_THROW_ON_FAIL (default throw behaviour)\n\nSchema file resolution precedence:\n  explicit option > env (AJB_RESPONSES_FILE / ROUTE_TEST_RESPONSES_FILE) > config.extract.responsesFile or <outputDir>/responses.json > default ./assert-json-body/responses.json\n`);
+}
+function initConfig() {
+    const path = 'assert-json-body.config.json';
+    if ((0, node_fs_1.existsSync)(path)) {
+        console.error(`Config file already exists at ${path}`);
+        process.exit(1);
+    }
+    const example = {
+        extract: {
+            repo: 'https://github.com/camunda/camunda-orchestration-cluster-api',
+            specPath: 'specification/openapi.yaml',
+            ref: 'main',
+            outputDir: 'assert-json-body',
+            preserveCheckout: false,
+            dryRun: false,
+            logLevel: 'info',
+            failIfExists: false
+        },
+        validate: {
+            recordResponses: false,
+            throwOnValidationFail: true
+        }
+    };
+    (0, node_fs_1.writeFileSync)(path, JSON.stringify(example, null, 2));
+    console.log(`Wrote example config to ${path}`);
+    // Idempotently add npm script to consumer package.json if exists
+    const pkgPath = 'package.json';
+    if ((0, node_fs_1.existsSync)(pkgPath)) {
+        try {
+            const raw = (0, node_fs_1.readFileSync)(pkgPath, 'utf8');
+            const pkg = JSON.parse(raw);
+            pkg.scripts = pkg.scripts || {};
+            if (pkg.scripts['responses:regenerate'] !== 'assert-json-body extract') {
+                pkg.scripts['responses:regenerate'] = 'assert-json-body extract';
+                (0, node_fs_1.writeFileSync)(pkgPath, JSON.stringify(pkg, null, 2));
+                console.log('Added script "responses:regenerate" to package.json');
+            }
+            else {
+                console.log('Script "responses:regenerate" already present in package.json');
+            }
+        }
+        catch (e) {
+            console.warn('Could not update package.json with responses:regenerate script:', e.message);
+        }
+    }
+}
+async function run() {
+    const { command, args } = (0, config_js_1.parseCliArgs)();
+    const baseCommand = command || 'extract';
+    if (args.help || baseCommand === 'help')
+        return printHelp();
+    if (args.version || baseCommand === 'version' || args.v)
+        return printVersion();
+    if (baseCommand === 'init-config')
+        return initConfig();
+    if (baseCommand !== 'extract') {
+        console.error(`Unknown command: ${baseCommand}`);
+        printHelp();
+        process.exit(1);
+    }
+    const cfgPath = typeof args.config === 'string' ? String(args.config) : undefined;
+    (0, config_js_1.buildConfig)(cfgPath);
+    const cliOverrides = (0, config_js_1.cliConfigSubset)(args);
+    try {
+        await (0, extractor_js_1.generate)(cliOverrides);
+    }
+    catch (err) {
+        console.error('[assert-json-body] extract failed:', err);
+        process.exit(1);
+    }
+}
+run();
+//# sourceMappingURL=index.js.map

package/dist-cjs/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;;AACA,sDAA+C;AAC/C,gDAA8E;AAC9E,qCAAkE;AAGlE,SAAS,YAAY;IACnB,iEAAiE;IACjE,MAAM,GAAG,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAC1C,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC,ipCAAipC,CAAC,CAAC;AACjqC,CAAC;AAED,SAAS,UAAU;IACjB,MAAM,IAAI,GAAG,8BAA8B,CAAC;IAC5C,IAAI,IAAA,oBAAU,EAAC,IAAI,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,iCAAiC,IAAI,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG;QACd,OAAO,EAAE;YACP,IAAI,EAAE,8DAA8D;YACpE,QAAQ,EAAE,4BAA4B;YACtC,GAAG,EAAE,MAAM;YACX,SAAS,EAAE,kBAAkB;YAC7B,gBAAgB,EAAE,KAAK;YACvB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,MAAM;YAChB,YAAY,EAAE,KAAK;SACpB;QACD,QAAQ,EAAE;YACR,eAAe,EAAE,KAAK;YACtB,qBAAqB,EAAE,IAAI;SAC5B;KACO,CAAC;IACX,IAAA,uBAAa,EAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IAE/C,iEAAiE;IACjE,MAAM,OAAO,GAAG,cAAc,CAAC;IAC/B,IAAI,IAAA,oBAAU,EAAC,OAAO,CAAC,EAAE,CAAC;QACxB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAA,sBAAY,EAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;YAC5B,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC;YAChC,IAAI,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,KAAK,0BAA0B,EAAE,CAAC;gBACvE,GAAG,CAAC,OAAO,CAAC,sBAAsB,CAAC,GAAG,0BAA0B,CAAC;gBACjE,IAAA,uBAAa,EAAC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;gBACrD,OAAO,CAAC,GAAG,CAAC,qDAAqD,CAAC,CAAC;YACrE,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,+DAA+D,CAAC,CAAC;YAC/E,CAAC;QACH,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,iEAAiE,EAAG,CAAW,CAAC,OAAO,CAAC,CAAC;QACxG,CAAC;IACH,CAAC;AACH,CAAC;AAED,KAAK,UAAU,GAAG;IAChB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,IAAA,wBAAY,GAAE,CAAC;IACzC,MAAM,WAAW,GAAG,OAAO,IAAI,SAAS,CAAC;IACzC,IAAI,IAAI,CAAC,IAAI,IAAI,WAAW,KAAK,MAAM;QAAE,OAAO,SAAS,EAAE,CAAC;IAC5D,IAAI,IAAI,CAAC,OAAO,IAAI,WAAW,KAAK,SAAS,IAAI,IAAI,CAAC,CAAC;QAAE,OAAO,YAAY,EAAE,CAAC;IAC/E,IAAI,WAAW,KAAK,aAAa;QAAE,OAAO,UAAU,EAAE,CAAC;IACvD,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,oBAAoB,WAAW,EAAE,CAAC,CAAC;QACjD,SAAS,EAAE,CAAC;QACZ,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,IAAA,uBAAW,EAAC,OAAO,CAAC,CAAC;IACrB,MAAM,YAAY,GAAkB,IAAA,2BAAe,EAAC,IAAqC,CAAC,CAAC;IAC3F,IAAI,CAAC;QACH,MAAM,IAAA,uBAAQ,EAAC,YAAY,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,GAAG,CAAC,CAAC;QACzD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC;AAED,GAAG,EAAE,CAAC"}

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

@@ -0,0 +1,8 @@
+import { SchemaGroup as OutputSchema } from '../../../types/index.js';
+import { SchemaOrRef } from './schema-flatten.js';
+export declare function buildSchemaTree(schema: SchemaOrRef, components: Record<string, SchemaOrRef>, seen?: Set<string>): OutputSchema;
+export declare function resolveFieldSchema(fieldName: string, parentSchema: SchemaOrRef, components: Record<string, SchemaOrRef>): {
+    kind: string;
+    target?: SchemaOrRef;
+} | null;
+//# sourceMappingURL=child-expansion.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"child-expansion.d.ts","sourceRoot":"","sources":["../../../../src/extractor/src/lib/child-expansion.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,IAAI,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEtE,OAAO,EAAW,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAG3D,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,EAAE,IAAI,cAAoB,GAAG,YAAY,CAgBpI;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GAAG,IAAI,CAuCvK"}