@apidevtools/json-schema-ref-parser 15.3.1 → 15.3.2

package/lib/util/schema-resources.ts

@@ -0,0 +1,73 @@
+import * as url from "./url.js";
+import type { ParserOptions } from "../options.js";
+import type { JSONSchema } from "../index.js";
+import type $Refs from "../refs.js";
+
+export function getSchemaBasePath(basePath: string, value: unknown) {
+  const schemaId = getSchemaId(value);
+  return schemaId ? url.resolve(basePath, schemaId) : basePath;
+}
+
+export function usesDynamicIdScope(value: unknown) {
+  if (!value || typeof value !== "object" || ArrayBuffer.isView(value)) {
+    return false;
+  }
+
+  const schema = (value as { $schema?: unknown }).$schema;
+  if (
+    typeof schema === "string" &&
+    (schema.includes("draft/2019-09/") || schema.includes("draft/2020-12/") || schema.includes("oas/3.1/"))
+  ) {
+    return true;
+  }
+
+  const openapi = (value as { openapi?: unknown }).openapi;
+  return typeof openapi === "string" && /^3\.1(?:\.|$)/.test(openapi);
+}
+
+export function registerSchemaResources<S extends object = JSONSchema, O extends ParserOptions<S> = ParserOptions<S>>(
+  $refs: $Refs<S, O>,
+  basePath: string,
+  value: unknown,
+  pathType?: string | unknown,
+  dynamicIdScope = false,
+) {
+  if (!dynamicIdScope) {
+    return;
+  }
+
+  const seen = new Set<object>();
+
+  const visit = (node: unknown, scopeBase: string) => {
+    if (!node || typeof node !== "object" || ArrayBuffer.isView(node) || seen.has(node)) {
+      return;
+    }
+
+    seen.add(node);
+
+    const nextScopeBase = getSchemaBasePath(scopeBase, node);
+    if (nextScopeBase !== scopeBase) {
+      $refs._addAlias(nextScopeBase, node as S, pathType, dynamicIdScope);
+    }
+
+    for (const key of Object.keys(node)) {
+      visit((node as Record<string, unknown>)[key], nextScopeBase);
+    }
+  };
+
+  visit(value, basePath);
+}
+
+function getSchemaId(value: unknown): string | undefined {
+  if (
+    value &&
+    typeof value === "object" &&
+    "$id" in value &&
+    typeof (value as { $id?: unknown }).$id === "string" &&
+    (value as { $id: string }).$id.length > 0
+  ) {
+    return (value as { $id: string }).$id;
+  }
+
+  return undefined;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@apidevtools/json-schema-ref-parser",
-  "version": "15.3.1",
+  "version": "15.3.2",
   "description": "Parse, Resolve, and Dereference JSON Schema $ref pointers",
   "type": "module",
   "types": "dist/lib/index.d.ts",
@@ -75,29 +75,29 @@
     "js-yaml": "^4.1.1"
   },
   "devDependencies": {
-    "@eslint/compat": "^2.0.2",
+    "@eslint/compat": "^2.0.3",
     "@eslint/js": "^10.0.1",
     "@types/eslint": "^9.6.1",
     "@types/js-yaml": "^4.0.9",
     "@types/json-schema": "^7.0.15",
     "@types/node": "^25",
-    "@typescript-eslint/eslint-plugin": "^8.56.1",
-    "@typescript-eslint/parser": "^8.56.1",
-    "@vitest/coverage-v8": "^4.0.18",
+    "@typescript-eslint/eslint-plugin": "^8.57.2",
+    "@typescript-eslint/parser": "^8.57.2",
+    "@vitest/coverage-v8": "^4.1.1",
     "cross-env": "^10.1.0",
-    "eslint": "^10.0.2",
+    "eslint": "^10.1.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-import": "^2.32.0",
     "eslint-plugin-prettier": "^5.5.5",
     "eslint-plugin-promise": "^7.2.1",
     "eslint-plugin-unused-imports": "^4.4.1",
-    "globals": "^17.3.0",
-    "jsdom": "^28.1.0",
+    "globals": "^17.4.0",
+    "jsdom": "^29.0.1",
     "prettier": "^3.8.1",
     "rimraf": "^6.1.3",
-    "typescript": "^5.9.3",
-    "typescript-eslint": "^8.56.1",
-    "vitest": "^4.0.18"
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.57.2",
+    "vitest": "^4.1.1"
   },
   "release": {
     "branches": [
@@ -110,5 +110,5 @@
       "@semantic-release/github"
     ]
   },
-  "packageManager": "yarn@4.12.0"
+  "packageManager": "yarn@4.13.0"
 }