@scalar/openapi-parser 0.10.2 → 0.10.4

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @scalar/openapi-parser
 
+## 0.10.4
+
+### Patch Changes
+
+- 64df4fc: fix: example arrays are transformed to objects
+
+## 0.10.3
+
+### Patch Changes
+
+- 8dce84f: Call `onDereference` after dereference process
+
 ## 0.10.2
 
 ### Patch Changes

package/dist/utils/resolveReferences.d.ts

@@ -6,6 +6,11 @@ export type ResolveReferencesResult = {
     schema: OpenAPI.Document;
 };
 export type ResolveReferencesOptions = ThrowOnErrorOption & {
+    /**
+     * Fired when dereferenced a schema.
+     *
+     * Note that for object schemas, its properties may not be dereferenced when the hook is called.
+     */
     onDereference?: (data: {
         schema: AnyObject;
         ref: string;

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

@@ -1 +1 @@
-{"version":3,"file":"resolveReferences.d.ts","sourceRoot":"","sources":["../../src/utils/resolveReferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,UAAU,CAAA;AAejB,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG;IAC1D,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACnE,CAAA;AAOD;;GAEG;AACH,wBAAgB,iBAAiB,CAE/B,KAAK,EAAE,SAAS,GAAG,UAAU,EAE7B,OAAO,CAAC,EAAE,wBAAwB,EAElC,IAAI,CAAC,EAAE,eAAe,EAEtB,MAAM,CAAC,EAAE,WAAW,EAAE,GACrB,uBAAuB,CAqGzB"}
+{"version":3,"file":"resolveReferences.d.ts","sourceRoot":"","sources":["../../src/utils/resolveReferences.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA;AAGpD,OAAO,KAAK,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,eAAe,EACf,kBAAkB,EACnB,MAAM,UAAU,CAAA;AAejB,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG,kBAAkB,GAAG;IAC1D;;;;OAIG;IACH,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAA;CACnE,CAAA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAE/B,KAAK,EAAE,SAAS,GAAG,UAAU,EAE7B,OAAO,CAAC,EAAE,wBAAwB,EAElC,IAAI,CAAC,EAAE,eAAe,EAEtB,MAAM,GAAE,WAAW,EAAO,GACzB,uBAAuB,CAqCzB"}

package/dist/utils/resolveReferences.js

@@ -14,66 +14,64 @@ options,
 // Fallback to the entrypoint
 file, 
 // Errors that occurred during the process
-errors) {
-    // Initialize errors
-    if (errors === undefined) {
-        errors = [];
-    }
+errors = []) {
     // Detach from input
     const clonedInput = structuredClone(input);
     // Make it a filesystem, even if it’s just one file
     const filesystem = makeFilesystem(clonedInput);
     // Get the main file
     const entrypoint = getEntrypoint(filesystem);
+    const finalInput = file?.specification ?? entrypoint.specification;
     // Recursively resolve all references
-    resolve(file?.specification ?? entrypoint.specification, filesystem, file ?? entrypoint);
+    dereference(finalInput, filesystem, file ?? entrypoint, new WeakSet(), errors, options);
     // Remove duplicats (according to message) from errors
     errors = errors.filter((error, index, self) => index ===
         self.findIndex((t) => t.message === error.message && t.code === error.code));
     // Return the resolved specification
     return {
         valid: errors.length === 0,
-        errors: errors,
-        schema: (file ?? getEntrypoint(filesystem))
-            .specification,
+        errors,
+        schema: finalInput,
     };
-    /**
-     * Resolves the circular reference to an object and deletes the $ref properties.
-     */
-    function resolve(schema, resolveFilesystem, resolveFile, 
-    // references to resolved object
-    resolved = new WeakSet()) {
-        let result = { errors: [] };
-        if (schema === null || resolved.has(schema))
-            return result;
-        resolved.add(schema);
-        function resolveExternal(externalFile) {
-            resolve(externalFile.specification, resolveFilesystem, externalFile, resolved);
-            return externalFile;
-        }
-        // Ignore parts without a reference
-        while (schema.$ref !== undefined) {
-            // Find the referenced content
-            const target = resolveUri(schema.$ref, options, resolveFile, resolveFilesystem, resolveExternal, errors);
-            // invalid
-            if (typeof target !== 'object' || target === null)
-                break;
-            options?.onDereference?.({ schema, ref: schema.$ref });
-            // Get rid of the reference
-            delete schema.$ref;
-            for (const key of Object.keys(target)) {
-                if (schema[key] === undefined) {
-                    schema[key] = target[key];
-                }
+}
+/**
+ * Resolves the circular reference to an object and deletes the $ref properties (in-place).
+ */
+function dereference(schema, filesystem, entrypoint, 
+// references to resolved object
+resolvedSchemas, 
+// error output
+errors, options) {
+    if (schema === null || resolvedSchemas.has(schema))
+        return;
+    resolvedSchemas.add(schema);
+    function resolveExternal(externalFile) {
+        dereference(externalFile.specification, filesystem, externalFile, resolvedSchemas, errors, options);
+        return externalFile;
+    }
+    while (schema.$ref !== undefined) {
+        // Find the referenced content
+        const resolved = resolveUri(schema.$ref, options, entrypoint, filesystem, resolveExternal, errors);
+        // invalid
+        if (typeof resolved !== 'object' || resolved === null)
+            break;
+        const dereferencedRef = schema.$ref;
+        // Get rid of the reference
+        delete schema.$ref;
+        for (const key of Object.keys(resolved)) {
+            if (schema[key] === undefined) {
+                schema[key] = resolved[key];
             }
         }
-        // Iterate over the whole object
-        for (const value of Object.values(schema)) {
-            if (typeof value === 'object' && value !== null) {
-                result = resolve(value, resolveFilesystem, resolveFile, resolved);
-            }
+        if (dereferencedRef) {
+            options?.onDereference?.({ schema, ref: dereferencedRef });
+        }
+    }
+    // Iterate over the whole object
+    for (const value of Object.values(schema)) {
+        if (typeof value === 'object' && value !== null) {
+            dereference(value, filesystem, entrypoint, resolvedSchemas, errors, options);
         }
-        return result;
     }
 }
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/utils/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;GAEG;AACH,wBAAgB,QAAQ,CACtB,aAAa,EAAE,SAAS,EACxB,SAAS,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,SAAS,EACnE,IAAI,GAAE,MAAM,EAAO,aAqBpB"}
+{"version":3,"file":"traverse.d.ts","sourceRoot":"","sources":["../../src/utils/traverse.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAEzC;;GAEG;AACH,wBAAgB,QAAQ,CACtB,aAAa,EAAE,SAAS,EACxB,SAAS,EAAE,CAAC,aAAa,EAAE,SAAS,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,SAAS,EACnE,IAAI,GAAE,MAAM,EAAO,aA0BpB"}

package/dist/utils/traverse.js

@@ -7,13 +7,15 @@ function traverse(specification, transform, path = []) {
         const currentPath = [...path, key];
         if (Array.isArray(value)) {
             result[key] = value.map((item, index) => {
-                if (typeof item === 'object' && item !== null) {
+                if (typeof item === 'object' && !Array.isArray(item) && item !== null) {
                     return traverse(item, transform, [...currentPath, index.toString()]);
                 }
                 return item;
             });
         }
-        else if (typeof value === 'object' && value !== null) {
+        else if (typeof value === 'object' &&
+            !Array.isArray(value) &&
+            value !== null) {
             result[key] = traverse(value, transform, currentPath);
         }
         else {

package/package.json

@@ -17,7 +17,7 @@
     "parser",
     "typescript"
   ],
-  "version": "0.10.2",
+  "version": "0.10.4",
   "engines": {
     "node": ">=18"
   },
@@ -64,9 +64,9 @@
     "json-to-ast": "^2.1.0",
     "just-diff": "^6.0.2",
     "tinybench": "^2.8.0",
-    "@scalar/openapi-types": "0.1.5",
     "@scalar/build-tooling": "0.1.12",
-    "@scalar/types": "0.0.25"
+    "@scalar/openapi-types": "0.1.6",
+    "@scalar/types": "0.0.26"
   },
   "scripts": {
     "build": "scalar-build-rollup",