@squiz/dx-json-schema-lib 1.87.0 → 1.89.0

package/lib/utils/jsonBreakDetector/checks/findStringConstraintNarrowing.js

@@ -0,0 +1,106 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findStringConstraintNarrowing = findStringConstraintNarrowing;
+exports.checkStringConstraintNarrowing = checkStringConstraintNarrowing;
+const types_1 = require("../types");
+/** Recursively detects narrowed string constraints at each schema level, accumulating dotted paths. */
+function findStringConstraintNarrowing(beforeSchema, afterSchema, path, breaks) {
+    var _a, _b;
+    const beforeProperties = (_a = beforeSchema.properties) !== null && _a !== void 0 ? _a : {};
+    const afterProperties = (_b = afterSchema.properties) !== null && _b !== void 0 ? _b : {};
+    // Recurse into latest nested object properties.
+    for (const [key, afterPropertySchema] of Object.entries(afterProperties)) {
+        // Skip if the property is not an object.
+        if (!afterPropertySchema || typeof afterPropertySchema !== 'object') {
+            continue;
+        }
+        const beforePropertySchema = beforeProperties[key];
+        const childPath = path ? `${path}.${key}` : key;
+        // Only compare string constraints on fields that existed in the before schema. New fields are skipped.
+        if (beforePropertySchema && typeof beforePropertySchema === 'object') {
+            checkStringConstraintNarrowing(beforePropertySchema, afterPropertySchema, childPath, breaks);
+            findStringConstraintNarrowing(beforePropertySchema, afterPropertySchema, childPath, breaks);
+        }
+    }
+    const beforeItems = beforeSchema.items;
+    const afterItems = afterSchema.items;
+    // Recurse into latest nested array items.
+    if (afterItems && typeof afterItems === 'object' && !Array.isArray(afterItems)) {
+        const itemsPath = path ? `${path}[]` : '[]';
+        const beforeItemSchema = beforeItems && typeof beforeItems === 'object' && !Array.isArray(beforeItems) ? beforeItems : undefined;
+        // Only compare string constraints on items that existed in the before schema. New items are skipped.
+        if (beforeItemSchema) {
+            checkStringConstraintNarrowing(beforeItemSchema, afterItems, itemsPath, breaks);
+            findStringConstraintNarrowing(beforeItemSchema, afterItems, itemsPath, breaks);
+        }
+    }
+}
+/** Returns true when a schema represents a string field. */
+function isStringFieldSchema(schema) {
+    const type = schema.type;
+    if (type === 'string') {
+        return true;
+    }
+    // Type can be defined as a union of strings e.g. ['string', 'number'], so check if 'string' is included.
+    if (Array.isArray(type) && type.includes('string')) {
+        return true;
+    }
+    return (schema.minLength !== undefined ||
+        schema.maxLength !== undefined ||
+        schema.format !== undefined ||
+        schema.pattern !== undefined);
+}
+/** Returns true when afterSchema requires a longer string than beforeSchema. */
+function hasMinLengthIncreased(beforeSchema, afterSchema) {
+    var _a, _b;
+    const beforeMinLength = (_a = beforeSchema.minLength) !== null && _a !== void 0 ? _a : 0;
+    const afterMinLength = (_b = afterSchema.minLength) !== null && _b !== void 0 ? _b : 0;
+    return afterMinLength > beforeMinLength;
+}
+/** Returns true when afterSchema allows a shorter string than beforeSchema. */
+function hasMaxLengthLowered(beforeSchema, afterSchema) {
+    const beforeMaxLength = beforeSchema.maxLength;
+    const afterMaxLength = afterSchema.maxLength;
+    if (afterMaxLength === undefined) {
+        return false;
+    }
+    if (beforeMaxLength === undefined) {
+        return true;
+    }
+    return afterMaxLength < beforeMaxLength;
+}
+/** Returns true when afterSchema adds or changes a format constraint. */
+function hasFormatChanged(beforeSchema, afterSchema) {
+    const afterFormat = afterSchema.format;
+    if (afterFormat === undefined) {
+        return false;
+    }
+    return beforeSchema.format !== afterFormat;
+}
+/** Returns true when afterSchema adds or changes a pattern constraint. */
+function hasPatternChanged(beforeSchema, afterSchema) {
+    const afterPattern = afterSchema.pattern;
+    if (afterPattern === undefined) {
+        return false;
+    }
+    return beforeSchema.pattern !== afterPattern;
+}
+/** Checks string constraint keywords on a single schema for narrowing changes. */
+function checkStringConstraintNarrowing(beforeSchema, afterSchema, path, breaks) {
+    if (!isStringFieldSchema(beforeSchema) && !isStringFieldSchema(afterSchema)) {
+        return;
+    }
+    if (hasMinLengthIncreased(beforeSchema, afterSchema)) {
+        (0, types_1.pushBreak)(breaks, path, types_1.BREAK_MESSAGES.minLength);
+    }
+    if (hasMaxLengthLowered(beforeSchema, afterSchema)) {
+        (0, types_1.pushBreak)(breaks, path, types_1.BREAK_MESSAGES.maxLength);
+    }
+    if (hasFormatChanged(beforeSchema, afterSchema)) {
+        (0, types_1.pushBreak)(breaks, path, types_1.BREAK_MESSAGES.format);
+    }
+    if (hasPatternChanged(beforeSchema, afterSchema)) {
+        (0, types_1.pushBreak)(breaks, path, types_1.BREAK_MESSAGES.pattern);
+    }
+}
+//# sourceMappingURL=findStringConstraintNarrowing.js.map

package/lib/utils/jsonBreakDetector/checks/findStringConstraintNarrowing.js.map

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

package/lib/utils/jsonBreakDetector/compareSubschemas.d.ts

@@ -0,0 +1,9 @@
+import type { JSONSchema } from '@squiz/json-schema-library';
+import { JsonBreak } from './types';
+/**
+ * Compares two schemas at the same path using every jsonBreakDetector check,
+ * including leaf-level constraints on the current node.
+ */
+export declare function compareSubschemas(beforeSchema: JSONSchema, afterSchema: JSONSchema, path: string, breaks: JsonBreak[]): void;
+/** Compares array `contains` subschemas using the full jsonBreakDetector check suite. */
+export declare function compareContainsSubschemas(beforeArraySchema: JSONSchema, afterArraySchema: JSONSchema, arrayPath: string, breaks: JsonBreak[]): void;

package/lib/utils/jsonBreakDetector/compareSubschemas.js

@@ -0,0 +1,49 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compareSubschemas = compareSubschemas;
+exports.compareContainsSubschemas = compareContainsSubschemas;
+const findArrayConstraintNarrowing_1 = require("./checks/findArrayConstraintNarrowing");
+const findConstChanges_1 = require("./checks/findConstChanges");
+const findFieldTypeChanges_1 = require("./checks/findFieldTypeChanges");
+const findNewRequiredFields_1 = require("./checks/findNewRequiredFields");
+const findNumericConstraintNarrowing_1 = require("./checks/findNumericConstraintNarrowing");
+const findEnumNarrowing_1 = require("./checks/findEnumNarrowing");
+const findStringConstraintNarrowing_1 = require("./checks/findStringConstraintNarrowing");
+const types_1 = require("./types");
+/**
+ * Compares two schemas at the same path using every jsonBreakDetector check,
+ * including leaf-level constraints on the current node.
+ */
+function compareSubschemas(beforeSchema, afterSchema, path, breaks) {
+    // Only applicable to nested schemas (from `contains` subschemas), not the root schema.
+    if (path !== '') {
+        if ((0, findFieldTypeChanges_1.hasTypeChange)(beforeSchema, afterSchema)) {
+            (0, types_1.pushBreak)(breaks, path, types_1.BREAK_MESSAGES.type);
+        }
+        (0, findEnumNarrowing_1.checkEnumNarrowingAtNode)(beforeSchema, afterSchema, path, breaks);
+        (0, findConstChanges_1.checkConstNarrowingAtNode)(beforeSchema, afterSchema, path, breaks);
+    }
+    (0, findArrayConstraintNarrowing_1.checkArrayConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+    (0, findNumericConstraintNarrowing_1.checkNumericConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+    (0, findStringConstraintNarrowing_1.checkStringConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+    // Find breaking changes at children properties and items
+    (0, findNewRequiredFields_1.findNewRequiredFields)(beforeSchema, afterSchema, path, breaks);
+    (0, findFieldTypeChanges_1.findFieldTypeChanges)(beforeSchema, afterSchema, path, breaks);
+    (0, findEnumNarrowing_1.findEnumNarrowing)(beforeSchema, afterSchema, path, breaks);
+    (0, findConstChanges_1.findConstChanges)(beforeSchema, afterSchema, path, breaks);
+    (0, findArrayConstraintNarrowing_1.findArrayConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+    (0, findNumericConstraintNarrowing_1.findNumericConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+    (0, findStringConstraintNarrowing_1.findStringConstraintNarrowing)(beforeSchema, afterSchema, path, breaks);
+}
+/** Compares array `contains` subschemas using the full jsonBreakDetector check suite. */
+function compareContainsSubschemas(beforeArraySchema, afterArraySchema, arrayPath, breaks) {
+    const afterContains = afterArraySchema.contains;
+    if (!afterContains || typeof afterContains !== 'object') {
+        return;
+    }
+    const beforeContains = beforeArraySchema.contains;
+    const containsPath = arrayPath ? `${arrayPath}.{contains}` : '{contains}';
+    const beforeSubschema = beforeContains && typeof beforeContains === 'object' ? beforeContains : {};
+    compareSubschemas(beforeSubschema, afterContains, containsPath, breaks);
+}
+//# sourceMappingURL=compareSubschemas.js.map

package/lib/utils/jsonBreakDetector/compareSubschemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compareSubschemas.js","sourceRoot":"","sources":["../../../src/utils/jsonBreakDetector/compareSubschemas.ts"],"names":[],"mappings":";;AAkBA,8CA4BC;AAGD,8DAiBC;AAhED,wFAAoH;AACpH,gEAAwF;AACxF,wEAAoF;AACpF,0EAAuE;AACvE,4FAGiD;AACjD,kEAAyF;AACzF,0FAAuH;AACvH,mCAA+D;AAE/D;;;GAGG;AACH,SAAgB,iBAAiB,CAC/B,YAAwB,EACxB,WAAuB,EACvB,IAAY,EACZ,MAAmB;IAEnB,uFAAuF;IACvF,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;QAChB,IAAI,IAAA,oCAAa,EAAC,YAAY,EAAE,WAAW,CAAC,EAAE,CAAC;YAC7C,IAAA,iBAAS,EAAC,MAAM,EAAE,IAAI,EAAE,sBAAc,CAAC,IAAI,CAAC,CAAC;QAC/C,CAAC;QAED,IAAA,4CAAwB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAClE,IAAA,4CAAyB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC;IAED,IAAA,4DAA6B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACvE,IAAA,gEAA+B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACzE,IAAA,8DAA8B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAExE,yDAAyD;IACzD,IAAA,6CAAqB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAA,2CAAoB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC9D,IAAA,qCAAiB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC3D,IAAA,mCAAgB,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1D,IAAA,2DAA4B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACtE,IAAA,+DAA8B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,IAAA,6DAA6B,EAAC,YAAY,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AACzE,CAAC;AAED,yFAAyF;AACzF,SAAgB,yBAAyB,CACvC,iBAA6B,EAC7B,gBAA4B,EAC5B,SAAiB,EACjB,MAAmB;IAEnB,MAAM,aAAa,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAEhD,IAAI,CAAC,aAAa,IAAI,OAAO,aAAa,KAAK,QAAQ,EAAE,CAAC;QACxD,OAAO;IACT,CAAC;IAED,MAAM,cAAc,GAAG,iBAAiB,CAAC,QAAQ,CAAC;IAClD,MAAM,YAAY,GAAG,SAAS,CAAC,CAAC,CAAC,GAAG,SAAS,aAAa,CAAC,CAAC,CAAC,YAAY,CAAC;IAC1E,MAAM,eAAe,GAAG,cAAc,IAAI,OAAO,cAAc,KAAK,QAAQ,CAAC,CAAC,CAAE,cAA6B,CAAC,CAAC,CAAC,EAAE,CAAC;IAEnH,iBAAiB,CAAC,eAAe,EAAE,aAA2B,EAAE,YAAY,EAAE,MAAM,CAAC,CAAC;AACxF,CAAC"}

package/lib/utils/jsonBreakDetector/dereference/dereference.d.ts

@@ -0,0 +1,6 @@
+import type { JSONSchema } from '@squiz/json-schema-library';
+export type GenericSchema = Record<string, any>;
+/**
+ * Synchronously dereferences internal ($ref: "#/...") JSON schema references.
+ */
+export declare function dereferenceLocal<T extends GenericSchema = JSONSchema>(schema: T): T;

package/lib/utils/jsonBreakDetector/dereference/dereference.js

@@ -0,0 +1,52 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dereferenceLocal = dereferenceLocal;
+/**
+ * Synchronously dereferences internal ($ref: "#/...") JSON schema references.
+ */
+function dereferenceLocal(schema) {
+    function resolvePointer(root, pointer) {
+        if (!pointer.startsWith('#/')) {
+            throw new Error(`Only internal references starting with "#/" are supported. Received: "${pointer}"`);
+        }
+        const pathSegments = pointer.replace(/^#\//, '').split('/');
+        return pathSegments.reduce((acc, key) => {
+            // Decode RFC 6901 JSON Pointer escaped sequences (~1 -> /, ~0 -> ~)
+            const unescapedKey = key.replace(/~1/g, '/').replace(/~0/g, '~');
+            if (acc && typeof acc === 'object' && unescapedKey in acc) {
+                return acc[unescapedKey];
+            }
+            throw new Error(`Could not resolve JSON pointer reference: "${pointer}" at segment "${key}"`);
+        }, root);
+    }
+    function walk(node, root, seen = new WeakSet()) {
+        if (node === null || typeof node !== 'object') {
+            return node;
+        }
+        // Prevent infinite loops on circular references
+        if (seen.has(node)) {
+            return node;
+        }
+        seen.add(node);
+        if (Array.isArray(node)) {
+            return node.map((item) => walk(item, root, seen));
+        }
+        // Check if current object contains a string $ref property
+        if (typeof node.$ref === 'string') {
+            const resolvedTarget = resolvePointer(root, node.$ref);
+            // Separate $ref from rest of keys (JSON Schema draft 2019-09+ allows sibling properties)
+            const { $ref: _ref, ...rest } = node;
+            return {
+                ...walk(resolvedTarget, root, seen),
+                ...walk(rest, root, seen),
+            };
+        }
+        const result = {};
+        for (const [key, value] of Object.entries(node)) {
+            result[key] = walk(value, root, seen);
+        }
+        return result;
+    }
+    return walk(schema, schema);
+}
+//# sourceMappingURL=dereference.js.map

package/lib/utils/jsonBreakDetector/dereference/dereference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dereference.js","sourceRoot":"","sources":["../../../../src/utils/jsonBreakDetector/dereference/dereference.ts"],"names":[],"mappings":";;AAOA,4CAyDC;AA5DD;;GAEG;AACH,SAAgB,gBAAgB,CAAuC,MAAS;IAC9E,SAAS,cAAc,CAAC,IAAyB,EAAE,OAAe;QAChE,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9B,MAAM,IAAI,KAAK,CAAC,yEAAyE,OAAO,GAAG,CAAC,CAAC;QACvG,CAAC;QAED,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE5D,OAAO,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE;YACtC,oEAAoE;YACpE,MAAM,YAAY,GAAG,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;YAEjE,IAAI,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,YAAY,IAAI,GAAG,EAAE,CAAC;gBAC1D,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;YAC3B,CAAC;YAED,MAAM,IAAI,KAAK,CAAC,8CAA8C,OAAO,iBAAiB,GAAG,GAAG,CAAC,CAAC;QAChG,CAAC,EAAE,IAAI,CAAC,CAAC;IACX,CAAC;IAED,SAAS,IAAI,CAAC,IAAS,EAAE,IAAyB,EAAE,OAAO,IAAI,OAAO,EAAU;QAC9E,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,IAAI,CAAC;QACd,CAAC;QAED,gDAAgD;QAChD,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAEf,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;QACpD,CAAC;QAED,0DAA0D;QAC1D,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAClC,MAAM,cAAc,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAEvD,yFAAyF;YACzF,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAC;YAErC,OAAO;gBACL,GAAG,IAAI,CAAC,cAAc,EAAE,IAAI,EAAE,IAAI,CAAC;gBACnC,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;aAC1B,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAwB,EAAE,CAAC;QACvC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YAChD,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QACxC,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,CAAM,CAAC;AACnC,CAAC"}

package/lib/utils/jsonBreakDetector/dereference/dereference.spec.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/utils/jsonBreakDetector/dereference/dereference.spec.js

@@ -0,0 +1,225 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const dereference_1 = require("./dereference");
+describe('dereferenceLocal', () => {
+    describe('JSON Schema Draft 7', () => {
+        it('dereferences a top-level $ref to a definition', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                $ref: '#/definitions/Person',
+                definitions: {
+                    Person: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                        },
+                        required: ['name'],
+                    },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                definitions: {
+                    Person: {
+                        type: 'object',
+                        properties: {
+                            name: { type: 'string' },
+                        },
+                        required: ['name'],
+                    },
+                },
+                type: 'object',
+                properties: {
+                    name: { type: 'string' },
+                },
+                required: ['name'],
+            });
+        });
+        it('dereferences nested $refs in properties', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                type: 'object',
+                properties: {
+                    address: { $ref: '#/definitions/Address' },
+                },
+                definitions: {
+                    Address: {
+                        type: 'object',
+                        properties: {
+                            city: { $ref: '#/definitions/City' },
+                        },
+                    },
+                    City: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                type: 'object',
+                properties: {
+                    address: {
+                        type: 'object',
+                        properties: {
+                            city: {
+                                type: 'string',
+                                minLength: 1,
+                            },
+                        },
+                    },
+                },
+                definitions: {
+                    Address: {
+                        type: 'object',
+                        properties: {
+                            city: { $ref: '#/definitions/City' },
+                        },
+                    },
+                    City: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                },
+            });
+        });
+        it('dereferences $refs inside combinators', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                oneOf: [{ $ref: '#/definitions/StringValue' }, { $ref: '#/definitions/NumberValue' }],
+                definitions: {
+                    StringValue: { type: 'string' },
+                    NumberValue: { type: 'number' },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                oneOf: [{ type: 'string' }, { type: 'number' }],
+                definitions: {
+                    StringValue: { type: 'string' },
+                    NumberValue: { type: 'number' },
+                },
+            });
+        });
+        it('dereferences chained $refs', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                $ref: '#/definitions/Outer',
+                definitions: {
+                    Outer: { $ref: '#/definitions/Inner' },
+                    Inner: {
+                        type: 'boolean',
+                    },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                definitions: {
+                    Outer: { $ref: '#/definitions/Inner' },
+                    Inner: {
+                        type: 'boolean',
+                    },
+                },
+                type: 'boolean',
+            });
+        });
+        it('merges sibling properties alongside a $ref', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                properties: {
+                    title: {
+                        $ref: '#/definitions/NonEmptyString',
+                        description: 'A human-readable title',
+                    },
+                },
+                definitions: {
+                    NonEmptyString: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                properties: {
+                    title: {
+                        type: 'string',
+                        minLength: 1,
+                        description: 'A human-readable title',
+                    },
+                },
+                definitions: {
+                    NonEmptyString: {
+                        type: 'string',
+                        minLength: 1,
+                    },
+                },
+            });
+        });
+        it('resolves JSON pointer escaped property names', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                properties: {
+                    'foo/bar': { $ref: '#/definitions/foo~1bar' },
+                },
+                definitions: {
+                    'foo/bar': {
+                        type: 'string',
+                    },
+                },
+            };
+            expect((0, dereference_1.dereferenceLocal)(schema)).toEqual({
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                properties: {
+                    'foo/bar': {
+                        type: 'string',
+                    },
+                },
+                definitions: {
+                    'foo/bar': {
+                        type: 'string',
+                    },
+                },
+            });
+        });
+        it('does not infinitely recurse on circular definitions', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                $ref: '#/definitions/Node',
+                definitions: {
+                    Node: {
+                        type: 'object',
+                        properties: {
+                            child: { $ref: '#/definitions/Node' },
+                        },
+                    },
+                },
+            };
+            const result = (0, dereference_1.dereferenceLocal)(schema);
+            expect(result.type).toBe('object');
+            expect(result.properties.child).toEqual({
+                type: 'object',
+                properties: {
+                    child: { $ref: '#/definitions/Node' },
+                },
+            });
+        });
+        it('throws when a reference is not internal', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                $ref: 'https://example.com/schema.json',
+            };
+            expect(() => (0, dereference_1.dereferenceLocal)(schema)).toThrow('Only internal references starting with "#/" are supported. Received: "https://example.com/schema.json"');
+        });
+        it('throws when a JSON pointer cannot be resolved', () => {
+            const schema = {
+                $schema: 'http://json-schema.org/draft-07/schema#',
+                properties: {
+                    missing: { $ref: '#/definitions/DoesNotExist' },
+                },
+            };
+            expect(() => (0, dereference_1.dereferenceLocal)(schema)).toThrow('Could not resolve JSON pointer reference: "#/definitions/DoesNotExist" at segment "definitions"');
+        });
+    });
+});
+//# sourceMappingURL=dereference.spec.js.map

package/lib/utils/jsonBreakDetector/dereference/dereference.spec.js.map

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

package/lib/utils/jsonBreakDetector/jsonBreakDetector.d.ts

@@ -0,0 +1,8 @@
+import type { JSONSchema } from '@squiz/json-schema-library';
+import { JsonBreak } from './types';
+/**
+ * Detects breaking schema changes between beforeSchema and afterSchema.
+ * Returns each break with a dotted path location, e.g. `subtitle`, `image.width`, `tags[]`,
+ * `tags.{contains}`, and a message identifying the kind of break.
+ */
+export default function jsonBreakDetector(beforeSchema: JSONSchema, afterSchema: JSONSchema): JsonBreak[];

package/lib/utils/jsonBreakDetector/jsonBreakDetector.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.default = jsonBreakDetector;
+const dereference_1 = require("./dereference/dereference");
+const compareSubschemas_1 = require("./compareSubschemas");
+const types_1 = require("./types");
+/**
+ * Detects breaking schema changes between beforeSchema and afterSchema.
+ * Returns each break with a dotted path location, e.g. `subtitle`, `image.width`, `tags[]`,
+ * `tags.{contains}`, and a message identifying the kind of break.
+ */
+function jsonBreakDetector(beforeSchema, afterSchema) {
+    const breaks = [];
+    // Unfold $refs so inline schemas and $defs references can be compared on equal footing.
+    let processedBeforeSchema;
+    try {
+        processedBeforeSchema = (0, dereference_1.dereferenceLocal)(beforeSchema);
+    }
+    catch (error) {
+        (0, types_1.pushBreak)(breaks, '', error instanceof Error ? error.message : 'Could not dereference schema');
+    }
+    let processedAfterSchema;
+    try {
+        processedAfterSchema = (0, dereference_1.dereferenceLocal)(afterSchema);
+    }
+    catch (error) {
+        (0, types_1.pushBreak)(breaks, '', error instanceof Error ? error.message : 'Could not dereference schema');
+    }
+    if (processedBeforeSchema === undefined || processedAfterSchema === undefined) {
+        return breaks;
+    }
+    (0, compareSubschemas_1.compareSubschemas)(processedBeforeSchema, processedAfterSchema, '', breaks);
+    return breaks;
+}
+//# sourceMappingURL=jsonBreakDetector.js.map

package/lib/utils/jsonBreakDetector/jsonBreakDetector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsonBreakDetector.js","sourceRoot":"","sources":["../../../src/utils/jsonBreakDetector/jsonBreakDetector.ts"],"names":[],"mappings":";;AAWA,oCAwBC;AAjCD,2DAA6D;AAC7D,2DAAwD;AACxD,mCAA+C;AAE/C;;;;GAIG;AACH,SAAwB,iBAAiB,CAAC,YAAwB,EAAE,WAAuB;IACzF,MAAM,MAAM,GAAgB,EAAE,CAAC;IAE/B,wFAAwF;IACxF,IAAI,qBAA6C,CAAC;IAClD,IAAI,CAAC;QACH,qBAAqB,GAAG,IAAA,8BAAgB,EAAC,YAAY,CAAC,CAAC;IACzD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,iBAAS,EAAC,MAAM,EAAE,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,oBAA4C,CAAC;IACjD,IAAI,CAAC;QACH,oBAAoB,GAAG,IAAA,8BAAgB,EAAC,WAAW,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAA,iBAAS,EAAC,MAAM,EAAE,EAAE,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;IACjG,CAAC;IAED,IAAI,qBAAqB,KAAK,SAAS,IAAI,oBAAoB,KAAK,SAAS,EAAE,CAAC;QAC9E,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,IAAA,qCAAiB,EAAC,qBAAqB,EAAE,oBAAoB,EAAE,EAAE,EAAE,MAAM,CAAC,CAAC;IAC3E,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/lib/utils/jsonBreakDetector/jsonBreakDetector.spec.d.ts

@@ -0,0 +1 @@
+export {};