@scalar/openapi-parser 0.18.3 → 0.20.0

package/CHANGELOG.md

@@ -1,5 +1,38 @@
 # @scalar/openapi-parser
 
+## 0.20.0
+
+### Minor Changes
+
+- c418e92: feat(openapi-parser): join multiple openapi documents
+
+### Patch Changes
+
+- d4adeba: fix: ensure upgrader doesn't lose schema properties
+- 66b18fc: feat: update the references to handle $refs from the magic proxy
+- 5f022b5: feat: use registry.scalar.com URLs as example
+- Updated dependencies [b93e1fe]
+- Updated dependencies [0fcd446]
+- Updated dependencies [c4bf497]
+- Updated dependencies [d8adbed]
+- Updated dependencies [0c80ef0]
+  - @scalar/json-magic@0.3.0
+  - @scalar/openapi-types@0.3.7
+
+## 0.19.1
+
+### Patch Changes
+
+- e203e90: fix: can’t import plugins from parser package anymore
+  - @scalar/openapi-types@0.3.7
+
+## 0.19.0
+
+### Minor Changes
+
+- 952bde2: feat(json-magic): move json tooling to the new package
+- 2888e18: feat(openapi-parser): partial bundle to a depth
+
 ## 0.18.3
 
 ### Patch Changes

package/README.md

@@ -55,208 +55,6 @@ const specification = `{
 const { schema, errors } = await dereference(specification)
 ```
 
-### Bundle external references
-
-The OpenAPI specification allows to point to external files (URLs or files). But sometimes, you just want to combine all files into one.
-
-#### Plugins
-
-If you are on a browser environment import plugins from `@scalar/openapi-parser/plugins-browser` while if you are on a node environment you can import from `@scalar/openapi-parser/plugins`
-
-##### fetchUrls
-This plugins handles all external urls. It works for both node.js and browser environment
-
-```ts
-import { bundle } from '@scalar/openapi-parser'
-import { fetchUrls } from '@scalar/openapi-parser/plugins-browser'
-
-const document = {
-  openapi: '3.1.0',
-  info: { title: 'Bundled API', version: '1.0.0' },
-  paths: {},
-  components: {
-    schemas: {
-      User: { $ref: 'https://example.com/user-schema.json#' }
-    }
-  }
-}
-
-// This will bundle all external documents and turn all references from external into internal
-await bundle(document, {
-  plugins: [fetchUrls()],
-  treeShake: true  // <------  This flag will try to remove any unused part of the external document
-})
-
-console.log(document)
-```
-
-###### Limiting the number of concurrent requests
-
-```ts
-await bundle(document, {
-  plugins: [
-    fetchUrls({
-      limit: 10, // it should run at most 10 requests at the same time
-    }),
-  ],
-  treeShake: false
-})
-
-```
-
-###### Custom headers
-To pass custom headers to requests for specific domains you can configure the fetch plugin like the example
-
-```ts
-await bundle(
-  document,
-  {
-    plugins: [
-      fetchUrls({
-        // Pass custom headers
-        // The header will only be attached to the list of domains
-        headers: [
-          {
-            domains: ['example.com'],
-            headers: {
-              'Authorization': 'Bearer <TOKEN>'
-            }
-          }
-        ]
-      }),
-      readFiles(),
-    ],
-    treeShake: false
-  },
-)
-```
-
-###### Custom fetch function
-For advanced use cases like proxying requests or implementing custom network logic, you can provide your own fetch implementation. This allows you to handle things like CORS restrictions, custom authentication flows, or request/response transformations.
-
-```ts
-await bundle(
-  document,
-  {
-    plugins: [
-      fetchUrls({
-        // Custom fetcher function
-        fetch: async (input, init) => {
-          console.log('Custom fetch logic')
-          return fetch(input, init)
-        },
-      })
-      readFiles(),
-    ],
-    treeShake: false
-  },
-)
-```
-
-###### Bundle from remote url
-
-```ts
-const result = await bundle(
-  'https://example.com/openapi.json',
-  {
-    plugins: [
-      fetchUrls(),
-    ],
-    treeShake: false
-  },
-)
-
-// Bundled document
-console.log(result)
-```
-
-##### readFiles
-This plugins handles local files. Only works on node.js environment
-
-```ts
-import { bundle } from '@scalar/openapi-parser'
-import { readFiles } from '@scalar/openapi-parser/plugins-browser'
-
-const document = {
-  openapi: '3.1.0',
-  info: { title: 'Bundled API', version: '1.0.0' },
-  paths: {},
-  components: {
-    schemas: {
-      User: { $ref: './user-schema.json#' }
-    }
-  }
-}
-
-// This will bundle all external documents and turn all references from external into internal
-await bundle(document, {
-  plugins: [readFiles()],
-  treeShake: false
-})
-
-console.log(document)
-```
-
-###### Bundle from local file
-You can pass the file path directly but make sure to have the correct plugins to handle reading from the local files
-
-```ts
-const result = await bundle(
-  './input.json',
-  {
-    plugins: [
-      readFiles(),
-    ],
-    treeShake: false
-  },
-)
-
-// Bundled document
-console.log(result)
-```
-
-##### parseJson
-
-You can pass raw json string as input
-```ts
-import { bundle } from '@scalar/openapi-parser'
-import { parseJson } from '@scalar/openapi-parser/plugins-browser'
-
-const result = await bundle(
-  '{ "openapi": "3.1.1" }',
-  {
-    plugins: [
-      parseJson(),
-    ],
-    treeShake: false
-  },
-)
-
-// Bundled document
-console.log(result)
-```
-
-##### parseYaml
-
-You can pass raw yaml string as input
-```ts
-import { bundle } from '@scalar/openapi-parser'
-import { parseYaml } from '@scalar/openapi-parser/plugins-browser'
-
-const result = await bundle(
-  'openapi: "3.1.1"\n',
-  {
-    plugins: [
-      parseYaml(),
-    ],
-    treeShake: false
-  },
-)
-
-// Bundled document
-console.log(result)
-```
-
 ### Track references
 
 The `dereference` function accepts an `onDereference` callback option that gets called whenever a reference is resolved. This can be useful for tracking which schemas are being dereferenced:
@@ -412,7 +210,7 @@ import { fetchUrls } from '@scalar/openapi-parser/plugins/fetch-urls'
 
 // Load a file and all referenced files
 const { filesystem } = await load(
-  'https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.yaml',
+  'https://registry.scalar.com/@scalar/apis/galaxy/latest?format=yaml',
   {
     plugins: [fetchUrls()],
   },
@@ -429,7 +227,7 @@ import { fetchUrls } from '@scalar/openapi-parser/plugins/fetch-urls'
 
 // Load a file and all referenced files
 const { filesystem } = await load(
-  'https://cdn.jsdelivr.net/npm/@scalar/galaxy/dist/latest.yaml',
+  'https://registry.scalar.com/@scalar/apis/galaxy/latest?format=yaml',
   {
     plugins: [
       fetchUrls({

package/dist/index.d.ts

@@ -14,7 +14,7 @@ export { upgrade } from './utils/upgrade.js';
 export { upgradeFromThreeToThreeOne } from './utils/upgrade-from-three-to-three-one.js';
 export { upgradeFromTwoToThree } from './utils/upgrade-from-two-to-three.js';
 export { validate } from './utils/validate.js';
-export { bundle } from './utils/bundle/bundle.js';
+export { join } from './utils/join/index.js';
 export type { LoadResult, Filesystem, AnyObject, ErrorObject } from './types/index.js';
 export { openapi } from './utils/openapi/openapi.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAC9C,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,0BAA0B,EAAE,MAAM,yCAAyC,CAAA;AACpF,OAAO,EAAE,qBAAqB,EAAE,MAAM,mCAAmC,CAAA;AACzE,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAA;AACnC,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAA"}

package/dist/index.js

@@ -14,15 +14,15 @@ import { upgrade } from "./utils/upgrade.js";
 import { upgradeFromThreeToThreeOne } from "./utils/upgrade-from-three-to-three-one.js";
 import { upgradeFromTwoToThree } from "./utils/upgrade-from-two-to-three.js";
 import { validate } from "./utils/validate.js";
-import { bundle } from "./utils/bundle/bundle.js";
+import { join } from "./utils/join/index.js";
 import { openapi } from "./utils/openapi/openapi.js";
 export {
-  bundle,
   dereference,
   escapeJsonPointer,
   filter,
   isJson,
   isYaml,
+  join,
   load,
   normalize,
   openapi,

package/dist/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["export { dereference } from './utils/dereference'\nexport { escapeJsonPointer } from './utils/escape-json-pointer'\nexport { filter } from './utils/filter'\nexport { isJson } from './utils/is-json'\nexport { isYaml } from './utils/is-yaml'\nexport { load } from './utils/load'\nexport { normalize } from './utils/normalize'\nexport { sanitize } from './utils/transform/sanitize'\nexport { toJson } from './utils/to-json'\nexport { toYaml } from './utils/to-yaml'\nexport { traverse } from './utils/traverse'\nexport { unescapeJsonPointer } from './utils/unescape-json-pointer'\nexport { upgrade } from './utils/upgrade'\nexport { upgradeFromThreeToThreeOne } from './utils/upgrade-from-three-to-three-one'\nexport { upgradeFromTwoToThree } from './utils/upgrade-from-two-to-three'\nexport { validate } from './utils/validate'\nexport { bundle } from './utils/bundle/bundle'\nexport type { LoadResult, Filesystem, AnyObject, ErrorObject } from './types'\nexport { openapi } from './utils/openapi/openapi'\n"],
-  "mappings": "AAAA,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AACxB,SAAS,kCAAkC;AAC3C,SAAS,6BAA6B;AACtC,SAAS,gBAAgB;AACzB,SAAS,cAAc;AAEvB,SAAS,eAAe;",
+  "sourcesContent": ["// biome-ignore lint/performance/noBarrelFile: <explanation>\nexport { dereference } from './utils/dereference'\nexport { escapeJsonPointer } from './utils/escape-json-pointer'\nexport { filter } from './utils/filter'\nexport { isJson } from './utils/is-json'\nexport { isYaml } from './utils/is-yaml'\nexport { load } from './utils/load'\nexport { normalize } from './utils/normalize'\nexport { sanitize } from './utils/transform/sanitize'\nexport { toJson } from './utils/to-json'\nexport { toYaml } from './utils/to-yaml'\nexport { traverse } from './utils/traverse'\nexport { unescapeJsonPointer } from './utils/unescape-json-pointer'\nexport { upgrade } from './utils/upgrade'\nexport { upgradeFromThreeToThreeOne } from './utils/upgrade-from-three-to-three-one'\nexport { upgradeFromTwoToThree } from './utils/upgrade-from-two-to-three'\nexport { validate } from './utils/validate'\nexport { join } from './utils/join'\nexport type { LoadResult, Filesystem, AnyObject, ErrorObject } from './types'\nexport { openapi } from './utils/openapi/openapi'\n"],
+  "mappings": "AACA,SAAS,mBAAmB;AAC5B,SAAS,yBAAyB;AAClC,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,YAAY;AACrB,SAAS,iBAAiB;AAC1B,SAAS,gBAAgB;AACzB,SAAS,cAAc;AACvB,SAAS,cAAc;AACvB,SAAS,gBAAgB;AACzB,SAAS,2BAA2B;AACpC,SAAS,eAAe;AACxB,SAAS,kCAAkC;AAC3C,SAAS,6BAA6B;AACtC,SAAS,gBAAgB;AACzB,SAAS,YAAY;AAErB,SAAS,eAAe;",
   "names": []
 }

package/dist/utils/join/index.d.ts

@@ -0,0 +1,3 @@
+export { join } from './join.js';
+export type { Conflicts } from './join.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/join/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/join/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAA;AAC7B,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA"}

package/dist/utils/join/index.js

@@ -0,0 +1,5 @@
+import { join } from "./join.js";
+export {
+  join
+};
+//# sourceMappingURL=index.js.map

package/dist/utils/join/index.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/join/index.ts"],
+  "sourcesContent": ["// biome-ignore lint/performance/noBarrelFile: <explanation>\nexport { join } from './join'\nexport type { Conflicts } from './join'\n"],
+  "mappings": "AACA,SAAS,YAAY;",
+  "names": []
+}

package/dist/utils/join/join.d.ts

@@ -0,0 +1,59 @@
+import type { UnknownObject } from '../../types/index.js';
+import type { OpenAPIV3_1 } from '@scalar/openapi-types';
+export type Conflicts = {
+    type: 'path';
+    path: string;
+    method: string;
+} | {
+    type: 'webhook';
+    path: string;
+    method: string;
+} | {
+    type: 'component';
+    componentType: string;
+    name: string;
+};
+type JoinResult = {
+    ok: true;
+    document: OpenAPIV3_1.Document;
+} | {
+    ok: false;
+    conflicts: Conflicts[];
+};
+/**
+ * Joins multiple OpenAPI documents into a single document.
+ *
+ * - Merges the "info" object, paths, webhooks, tags, and servers from all input documents.
+ * - If there are conflicting paths or webhooks (same path and method), returns a list of conflicts.
+ * - Only the first occurrence of a tag (by name) or server (by url) is included.
+ * - The merge is performed in reverse order, so the first document in the input array has the highest precedence.
+ *
+ * @param inputs - Array of OpenAPI documents (UnknownObject) to join
+ * @returns {JoinResult} - { ok: true, document } if successful, or { ok: false, conflicts } if there are conflicts
+ *
+ * @example
+ * const doc1 = {
+ *   info: { title: "API 1", version: "1.0.0" },
+ *   paths: { "/foo": { get: { summary: "Get Foo" } } },
+ *   tags: [{ name: "foo" }],
+ *   servers: [{ url: "https://api1.example.com" }]
+ * }
+ * const doc2 = {
+ *   info: { description: "Second API" },
+ *   paths: { "/bar": { get: { summary: "Get Bar" } } },
+ *   tags: [{ name: "bar" }],
+ *   servers: [{ url: "https://api2.example.com" }]
+ * }
+ * const result = join([doc1, doc2])
+ * // result.ok === true
+ * // result.document.info.title === "API 1"
+ * // result.document.info.description === "Second API"
+ * // result.document.paths has both "/foo" and "/bar"
+ * // result.document.tags contains both "foo" and "bar"
+ * // result.document.servers contains both server URLs
+ */
+export declare const join: (inputs: UnknownObject[], config?: {
+    prefixComponents: string[];
+}) => Promise<JoinResult>;
+export {};
+//# sourceMappingURL=join.d.ts.map

package/dist/utils/join/join.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"join.d.ts","sourceRoot":"","sources":["../../../src/utils/join/join.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAI5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAA;AAuOxD,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,aAAa,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAC9D,KAAK,UAAU,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,EAAE,WAAW,CAAC,QAAQ,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,SAAS,EAAE,CAAA;CAAE,CAAA;AAEtG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,IAAI,WAAkB,aAAa,EAAE,WAAW;IAAE,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,KAAG,OAAO,CAAC,UAAU,CAkE/G,CAAA"}

package/dist/utils/join/join.js

@@ -0,0 +1,178 @@
+import { mergeObjects } from "../../utils/join/merge-objects.js";
+import { upgrade } from "../../utils/upgrade.js";
+import { bundle } from "@scalar/json-magic/bundle";
+const getSetIntersection = (a, b) => {
+  const result = [];
+  for (const value of a) {
+    if (b.has(value)) {
+      result.push(value);
+    }
+  }
+  return result;
+};
+const withDefault = (value, defaultValue) => {
+  if (Array.isArray(value)) {
+    return value.length ? value : defaultValue;
+  }
+  if (typeof value === "object" && value !== null) {
+    return Object.keys(value).length ? value : defaultValue;
+  }
+  return value ?? defaultValue;
+};
+const mergePaths = (inputs) => {
+  const result = {};
+  const conflicts = [];
+  for (const paths of inputs) {
+    if (typeof paths !== "object") {
+      continue;
+    }
+    for (const [path, pathItem] of Object.entries(paths)) {
+      if (!result[path]) {
+        result[path] = pathItem;
+        continue;
+      }
+      const intersectingKeys = getSetIntersection(new Set(Object.keys(result[path])), new Set(Object.keys(pathItem)));
+      result[path] = { ...result[path], ...pathItem };
+      intersectingKeys.forEach((key) => conflicts.push({ method: key, path }));
+    }
+  }
+  return { paths: result, conflicts };
+};
+const mergeTags = (inputs) => {
+  const cache = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const tags of inputs) {
+    for (const tag of tags) {
+      if (!cache.has(tag.name)) {
+        result.push(tag);
+      }
+      cache.add(tag.name);
+    }
+  }
+  return result;
+};
+const mergeServers = (inputs) => {
+  const cache = /* @__PURE__ */ new Set();
+  const result = [];
+  for (const servers of inputs) {
+    for (const server of servers) {
+      if (!cache.has(server.url)) {
+        result.push(server);
+      }
+      cache.add(server.url);
+    }
+  }
+  return result;
+};
+const mergeComponents = (inputs) => {
+  const result = {};
+  const conflicts = [];
+  for (const components of inputs) {
+    if (typeof components !== "object") {
+      continue;
+    }
+    for (const [key, value] of Object.entries(components)) {
+      for (const [name, component] of Object.entries(value)) {
+        if (!result[key]) {
+          result[key] = {};
+        }
+        if (result[key][name]) {
+          conflicts.push({ componentType: key, name });
+        } else {
+          result[key][name] = component;
+        }
+      }
+    }
+  }
+  return { components: result, conflicts };
+};
+const prefixComponents = async (inputs, prefixes) => {
+  for (const index of inputs.keys()) {
+    await bundle(inputs[index], {
+      treeShake: false,
+      urlMap: false,
+      plugins: [
+        // Plugin to update $ref values to use the prefixed component names
+        {
+          type: "lifecycle",
+          onBeforeNodeProcess: (node) => {
+            const ref = node["$ref"];
+            if (typeof ref !== "string") {
+              return;
+            }
+            if (!ref.startsWith("#/components/")) {
+              return;
+            }
+            const parts = ref.split("/");
+            if (parts.length < 4) {
+              return;
+            }
+            parts[3] = `${prefixes[index] ?? ""}${parts[3]}`;
+            node["$ref"] = parts.join("/");
+          }
+        },
+        // Plugin to rename component keys with the prefix
+        {
+          type: "lifecycle",
+          onBeforeNodeProcess: (node, context) => {
+            if (context.path.length === 2 && context.path[0] === "components") {
+              const prefix = prefixes[index];
+              Object.keys(node).forEach((key) => {
+                const newKey = `${prefix ?? ""}${key}`;
+                const childNode = node[key];
+                delete node[key];
+                node[newKey] = childNode;
+              });
+            }
+          }
+        }
+      ]
+    });
+  }
+};
+const join = async (inputs, config) => {
+  const upgraded = inputs.map((it) => upgrade(it).specification);
+  if (config?.prefixComponents) {
+    await prefixComponents(upgraded, config.prefixComponents);
+  }
+  upgraded.reverse();
+  const info = upgraded.reduce((acc, curr) => {
+    if (curr.info && typeof curr.info === "object") {
+      return mergeObjects(acc, curr.info);
+    }
+    return acc;
+  }, {});
+  const { paths, conflicts: pathConflicts } = mergePaths(upgraded.map((it) => it.paths ?? {}));
+  const { paths: webhooks, conflicts: webhookConflicts } = mergePaths(upgraded.map((it) => it.webhooks ?? {}));
+  const tags = mergeTags(upgraded.map((it) => it.tags ?? []));
+  const servers = mergeServers(upgraded.map((it) => it.servers ?? []));
+  const { components, conflicts: componentConflicts } = mergeComponents(upgraded.map((it) => it.components ?? {}));
+  const result = upgraded.reduce((acc, curr) => ({ ...acc, ...curr }), {});
+  const conflicts = [
+    ...pathConflicts.map((it) => ({ type: "path", ...it })),
+    ...webhookConflicts.map((it) => ({ type: "webhook", ...it })),
+    ...componentConflicts.map((it) => ({ type: "component", ...it }))
+  ];
+  if (conflicts.length) {
+    return {
+      ok: false,
+      conflicts
+    };
+  }
+  return {
+    ok: true,
+    document: {
+      ...result,
+      info,
+      paths,
+      webhooks: withDefault(webhooks, void 0),
+      tags: withDefault(tags, void 0),
+      servers: withDefault(servers, void 0),
+      components: withDefault(components, void 0)
+    }
+  };
+};
+export {
+  join
+};
+//# sourceMappingURL=join.js.map

package/dist/utils/join/join.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/utils/join/join.ts"],
+  "sourcesContent": ["import type { UnknownObject } from '@/types'\nimport { mergeObjects } from '@/utils/join/merge-objects'\nimport { upgrade } from '@/utils/upgrade'\nimport { bundle } from '@scalar/json-magic/bundle'\nimport type { OpenAPIV3_1 } from '@scalar/openapi-types'\n\n/**\n * Returns the intersection of two sets as an array.\n *\n * @param a - The first set\n * @param b - The second set\n * @returns An array containing the elements present in both sets\n *\n * @example\n * const setA = new Set([1, 2, 3, 4])\n * const setB = new Set([3, 4, 5, 6])\n * const intersection = getSetIntersection(setA, setB)\n * // intersection: [3, 4]\n */\nconst getSetIntersection = <T>(a: Set<T>, b: Set<T>): T[] => {\n  const result: T[] = []\n  for (const value of a) {\n    if (b.has(value)) {\n      result.push(value)\n    }\n  }\n  return result\n}\n\n/**\n * Returns the value if it is not nullish (or, for arrays, not empty), otherwise returns the provided default value.\n * Useful for handling OpenAPI fields that may be missing or empty.\n */\nconst withDefault = <T, K>(value: T, defaultValue: K): T | K => {\n  if (Array.isArray(value)) {\n    return value.length ? value : defaultValue\n  }\n\n  if (typeof value === 'object' && value !== null) {\n    return Object.keys(value).length ? value : defaultValue\n  }\n\n  return value ?? defaultValue\n}\n\n/**\n * Merges multiple OpenAPI PathsObjects into a single PathsObject.\n * - If a path does not exist in the result, it is added directly.\n * - If a path already exists, its operations (get, post, etc.) are merged.\n * - If the same operation (e.g., \"get\") exists for the same path in multiple inputs,\n *   a conflict is recorded for that path and method.\n *\n * @param inputs - Array of OpenAPIV3_1.PathsObject to merge\n * @returns An object containing the merged paths and a list of conflicts\n */\nconst mergePaths = (inputs: OpenAPIV3_1.PathsObject[]) => {\n  const result: OpenAPIV3_1.PathsObject = {}\n  const conflicts: { path: string; method: string }[] = []\n\n  for (const paths of inputs) {\n    if (typeof paths !== 'object') {\n      continue\n    }\n\n    for (const [path, pathItem] of Object.entries(paths)) {\n      if (!result[path]) {\n        // If the path does not exist, add it directly\n        result[path] = pathItem\n        continue\n      }\n\n      // Find intersecting operation keys (e.g., \"get\", \"post\") for this path\n      const intersectingKeys = getSetIntersection(new Set(Object.keys(result[path])), new Set(Object.keys(pathItem)))\n\n      // If the path exists, merge the operations (get, post, etc.)\n      result[path] = { ...result[path], ...pathItem }\n      // Record conflicts for each intersecting operation key\n      intersectingKeys.forEach((key) => conflicts.push({ method: key, path }))\n    }\n  }\n\n  return { paths: result, conflicts }\n}\n\n/**\n * Merges multiple arrays of OpenAPI TagObjects into a single array, ensuring uniqueness by tag name.\n * - If a tag with the same name appears in multiple arrays, only the first occurrence is included in the result.\n *\n * @param inputs - Array of arrays of OpenAPIV3_1.TagObject to merge\n * @returns An array of unique TagObjects (by name)\n */\nconst mergeTags = (inputs: OpenAPIV3_1.TagObject[][]) => {\n  const cache = new Set<string>()\n  const result: OpenAPIV3_1.TagObject[] = []\n\n  for (const tags of inputs) {\n    for (const tag of tags) {\n      if (!cache.has(tag.name)) {\n        result.push(tag)\n      }\n      cache.add(tag.name)\n    }\n  }\n\n  return result\n}\n\n/**\n * Merges multiple arrays of OpenAPI ServerObjects into a single array, ensuring uniqueness by server URL.\n * - If a server with the same URL appears in multiple arrays, only the first occurrence is included in the result.\n *\n * @param inputs - Array of arrays of OpenAPIV3_1.ServerObject to merge\n * @returns An array of unique ServerObjects (by url)\n */\nconst mergeServers = (inputs: OpenAPIV3_1.ServerObject[][]) => {\n  const cache = new Set<string>()\n  const result: OpenAPIV3_1.ServerObject[] = []\n\n  for (const servers of inputs) {\n    for (const server of servers) {\n      if (!cache.has(server.url)) {\n        result.push(server)\n      }\n      cache.add(server.url)\n    }\n  }\n\n  return result\n}\n\n/**\n * Merges multiple OpenAPI ComponentsObject instances into a single components object.\n * - If a component with the same type and name appears in multiple inputs, only the first occurrence is included.\n * - Any conflicts (duplicate component names within the same type) are recorded in the `conflicts` array.\n *\n * @param inputs - Array of OpenAPIV3_1.ComponentsObject to merge\n * @returns An object containing the merged components and an array of conflicts\n */\nconst mergeComponents = (inputs: OpenAPIV3_1.ComponentsObject[]) => {\n  const result: OpenAPIV3_1.ComponentsObject = {}\n  const conflicts: { componentType: string; name: string }[] = []\n\n  for (const components of inputs) {\n    if (typeof components !== 'object') {\n      continue\n    }\n\n    // Merge each component type (schemas, responses, parameters, etc.)\n    for (const [key, value] of Object.entries(components)) {\n      for (const [name, component] of Object.entries(value)) {\n        if (!result[key]) {\n          result[key] = {}\n        }\n\n        if (result[key][name]) {\n          // If the component already exists, record a conflict\n          conflicts.push({ componentType: key, name })\n        } else {\n          // Otherwise, add the component\n          result[key][name] = component\n        }\n      }\n    }\n  }\n\n  return { components: result, conflicts }\n}\n\n/**\n * Prefixes component names and their references in multiple OpenAPI documents.\n *\n * This function mutates each input document in-place by:\n *   1. Prefixing all component names (e.g., schema names) with the corresponding prefix.\n *   2. Updating all $ref values that point to components to use the prefixed names.\n *\n * This is useful when merging multiple OpenAPI documents to avoid component name collisions.\n *\n * @param inputs - Array of OpenAPI documents to mutate.\n * @param prefixes - Array of prefixes to apply to each document's components.\n */\nconst prefixComponents = async (inputs: OpenAPIV3_1.Document[], prefixes: string[]) => {\n  for (const index of inputs.keys()) {\n    await bundle(inputs[index], {\n      treeShake: false,\n      urlMap: false,\n      plugins: [\n        // Plugin to update $ref values to use the prefixed component names\n        {\n          type: 'lifecycle',\n          onBeforeNodeProcess: (node) => {\n            const ref = node['$ref']\n\n            if (typeof ref !== 'string') {\n              return\n            }\n\n            // Only process refs that point to components\n            if (!ref.startsWith('#/components/')) {\n              return\n            }\n\n            const parts = ref.split('/')\n            // Ensure the ref has the expected structure: #/components/{type}/{name}\n            if (parts.length < 4) {\n              return\n            }\n\n            // Prefix the component name (parts[3]) with the provided prefix\n            parts[3] = `${prefixes[index] ?? ''}${parts[3]}`\n\n            node['$ref'] = parts.join('/')\n          },\n        },\n        // Plugin to rename component keys with the prefix\n        {\n          type: 'lifecycle',\n          onBeforeNodeProcess: (node, context) => {\n            // Check if the node is a component type object (e.g., schemas, responses) under \"components\"\n            if (context.path.length === 2 && context.path[0] === 'components') {\n              const prefix = prefixes[index]\n\n              Object.keys(node).forEach((key) => {\n                const newKey = `${prefix ?? ''}${key}`\n                const childNode = node[key]\n                delete node[key]\n                node[newKey] = childNode\n              })\n            }\n          },\n        },\n      ],\n    })\n  }\n}\n\nexport type Conflicts =\n  | { type: 'path'; path: string; method: string }\n  | { type: 'webhook'; path: string; method: string }\n  | { type: 'component'; componentType: string; name: string }\ntype JoinResult = { ok: true; document: OpenAPIV3_1.Document } | { ok: false; conflicts: Conflicts[] }\n\n/**\n * Joins multiple OpenAPI documents into a single document.\n *\n * - Merges the \"info\" object, paths, webhooks, tags, and servers from all input documents.\n * - If there are conflicting paths or webhooks (same path and method), returns a list of conflicts.\n * - Only the first occurrence of a tag (by name) or server (by url) is included.\n * - The merge is performed in reverse order, so the first document in the input array has the highest precedence.\n *\n * @param inputs - Array of OpenAPI documents (UnknownObject) to join\n * @returns {JoinResult} - { ok: true, document } if successful, or { ok: false, conflicts } if there are conflicts\n *\n * @example\n * const doc1 = {\n *   info: { title: \"API 1\", version: \"1.0.0\" },\n *   paths: { \"/foo\": { get: { summary: \"Get Foo\" } } },\n *   tags: [{ name: \"foo\" }],\n *   servers: [{ url: \"https://api1.example.com\" }]\n * }\n * const doc2 = {\n *   info: { description: \"Second API\" },\n *   paths: { \"/bar\": { get: { summary: \"Get Bar\" } } },\n *   tags: [{ name: \"bar\" }],\n *   servers: [{ url: \"https://api2.example.com\" }]\n * }\n * const result = join([doc1, doc2])\n * // result.ok === true\n * // result.document.info.title === \"API 1\"\n * // result.document.info.description === \"Second API\"\n * // result.document.paths has both \"/foo\" and \"/bar\"\n * // result.document.tags contains both \"foo\" and \"bar\"\n * // result.document.servers contains both server URLs\n */\nexport const join = async (inputs: UnknownObject[], config?: { prefixComponents: string[] }): Promise<JoinResult> => {\n  // Reverse the input list and upgrade them (first input has highest precedence)\n  const upgraded = inputs.map((it) => upgrade(it).specification)\n\n  // Preprocess documents by prefixing components if specified\n  if (config?.prefixComponents) {\n    await prefixComponents(upgraded, config.prefixComponents)\n  }\n\n  // Reverse the upgraded documents to ensure the first document has the highest precedence\n  upgraded.reverse()\n\n  // Merge only the \"info\" object from all inputs\n  const info = upgraded.reduce<OpenAPIV3_1.InfoObject>((acc, curr) => {\n    if (curr.info && typeof curr.info === 'object') {\n      return mergeObjects(acc, curr.info)\n    }\n    return acc\n  }, {} as OpenAPIV3_1.InfoObject)\n\n  // Merge paths from all documents, collecting conflicts\n  const { paths, conflicts: pathConflicts } = mergePaths(upgraded.map((it) => it.paths ?? {}))\n\n  // Merge webhooks from all documents, collecting conflicts\n  const { paths: webhooks, conflicts: webhookConflicts } = mergePaths(upgraded.map((it) => it.webhooks ?? {}))\n\n  // Merge tags, ensuring uniqueness by tag name\n  const tags = mergeTags(upgraded.map((it) => it.tags ?? []))\n\n  // Merge servers, ensuring uniqueness by server url\n  const servers = mergeServers(upgraded.map((it) => it.servers ?? []))\n\n  // Merge components, collecting conflicts\n  const { components, conflicts: componentConflicts } = mergeComponents(upgraded.map((it) => it.components ?? {}))\n\n  // Merge all documents in the upgraded array into a single object (shallow merge)\n  const result = upgraded.reduce<UnknownObject>((acc, curr) => ({ ...acc, ...curr }), {})\n\n  // Collect all conflicts (paths and webhooks)\n  const conflicts: Conflicts[] = [\n    ...pathConflicts.map((it) => ({ type: 'path', ...it }) as const),\n    ...webhookConflicts.map((it) => ({ type: 'webhook', ...it }) as const),\n    ...componentConflicts.map((it) => ({ type: 'component', ...it }) as const),\n  ]\n\n  // If there are any conflicts, return them\n  if (conflicts.length) {\n    return {\n      ok: false,\n      conflicts,\n    }\n  }\n\n  // Return the merged OpenAPI document\n  return {\n    ok: true,\n    document: {\n      ...result,\n      info,\n      paths,\n      webhooks: withDefault(webhooks, undefined),\n      tags: withDefault(tags, undefined),\n      servers: withDefault(servers, undefined),\n      components: withDefault(components, undefined),\n    },\n  }\n}\n"],
+  "mappings": "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",
+  "names": []
+}

package/dist/utils/join/merge-objects.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Deep merges two objects, combining their properties recursively.
+ *
+ * ⚠️ Note: This operation assumes there are no key collisions between the objects.
+ * @param a - Target object to merge into
+ * @param b - Source object to merge from
+ * @returns The merged object (mutates and returns a)
+ *
+ * @example
+ * // Simple merge
+ * const a = { name: 'John' }
+ * const b = { age: 30 }
+ * mergeObjects(a, b) // { name: 'John', age: 30 }
+ *
+ * // Nested merge
+ * const a = { user: { name: 'John' } }
+ * const b = { user: { age: 30 } }
+ * mergeObjects(a, b) // { user: { name: 'John', age: 30 } }
+ */
+export declare const mergeObjects: <R>(a: Record<string, unknown>, b: Record<string, unknown>) => R;
+//# sourceMappingURL=merge-objects.d.ts.map

package/dist/utils/join/merge-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge-objects.d.ts","sourceRoot":"","sources":["../../../src/utils/join/merge-objects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,GAAI,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,CAiBxF,CAAA"}

package/dist/utils/join/merge-objects.js

@@ -0,0 +1,20 @@
+const mergeObjects = (a, b) => {
+  for (const key in b) {
+    if (!(key in a)) {
+      a[key] = b[key];
+    } else {
+      const aValue = a[key];
+      const bValue = b[key];
+      if (typeof aValue === "object" && aValue !== null && typeof bValue === "object" && bValue !== null) {
+        mergeObjects(aValue, bValue);
+      } else {
+        a[key] = bValue;
+      }
+    }
+  }
+  return a;
+};
+export {
+  mergeObjects
+};
+//# sourceMappingURL=merge-objects.js.map