fix: resolve accented filesystem path correctly in $RefParser lib

The internal `$refs` Class of the json-schema-ref-parser library stores
paths in a URI encoded fashion. This is to prevent confusion between #
hash internal references (mentioned in the full json path) and #
characters in the filesystem path.

This commit makes sure to fetch the parsed values from the `$refs`
object from the `$refs.values()` function (instead of the
`$refs.get($ref)` function).

I got a bit confused with the internals of the lib as I expected to be
able to provide the returned values of `$Refs.paths()` to the
`$Refs.get()` function transparently. But this does not work for
filesystem paths containing special characters. The best solution is
thus to fetch the `$refs.values()` object which has decoded file path
as keys. I.e. exactly what we need.

examples/valid/__gitlab-é__.yml

@@ -0,0 +1,16 @@
+openapi: 3.0.0
+info:
+  description: |
+    An OpenAPI definition for the GitLab REST API.
+  version: v4
+  title: GitLab API
+
+paths:
+  # ...
+
+
+  # ACCESS REQUESTS (PROJECTS)
+  /v4/projects/{id}/access_requests:
+    $ref: 'v4/access_requests.yaml#/accessRequestsProjects'
+
+  # ...

examples/valid/v4/access_requests.yaml

@@ -0,0 +1,12 @@
+accessRequestsProjects:
+  get:
+    description: Lists access requests for a project
+    parameters:
+      - name: id
+        in: path
+    responses:
+      '200':
+        description: Successful operation
+        content:
+          'application/json':
+            $ref: 'models/ProjectAccessResponse.yaml'

examples/valid/v4/models/ProjectAccessResponse.yaml

@@ -0,0 +1,11 @@
+schema:
+  title: ProjectAccessResponse
+  type: object
+  properties:
+    id:
+      type: integer
+    usename:
+      type: string
+example:
+  - "id": 1
+    "username": "raymond_smith"

src/definition.ts

@@ -114,17 +114,18 @@ class API {
   }
 
   resolveContent($refs: $RefParser.$Refs): [string, APIDefinition] {
-    const paths = $refs.paths();
-    let mainReference;
-    let absPath = paths.shift();
+    const values = $refs.values();
+    let mainReference: JSONSchemaWithRaw = { parsed: {}, raw: '' };
 
-    while (typeof absPath !== 'undefined') {
+    for (const [absPath, reference] of Object.entries(values)) {
       if (absPath === this.location || absPath === path.resolve(this.location)) {
-        mainReference = absPath;
+        // $refs.values is not properly typed so we need to force it
+        // with the resulting type of our custom defined parser
+        mainReference = reference as JSONSchemaWithRaw;
       } else {
-        // $refs.get is not properly typed so we need to force it
+        // $refs.values is not properly typed so we need to force it
         // with the resulting type of our custom defined parser
-        const { raw } = $refs.get(absPath) as JSONSchemaWithRaw;
+        const { raw } = reference as JSONSchemaWithRaw;
 
         if (!raw) {
           throw new UnsupportedFormat('Reference ${absPath} is empty');
@@ -135,18 +136,9 @@ class API {
           content: raw,
         });
       }
-      absPath = paths.shift();
-    }
-
-    if (typeof mainReference === 'undefined') {
-      throw new UnsupportedFormat(
-        "JSON Schema $ref parser couldn't parse the main definition",
-      );
     }
 
-    // $refs.get is not properly typed so we need to force it
-    // with the resulting type of our custom defined parser
-    const { raw, parsed } = $refs.get(mainReference) as JSONSchemaWithRaw;
+    const { raw, parsed } = mainReference;
 
     if (!parsed || !(parsed instanceof Object) || !('info' in parsed)) {
       throw new UnsupportedFormat(

test/unit/definition.test.ts

@@ -50,6 +50,13 @@ describe('API definition class', () => {
     });
   });
 
+  describe('with a file path containing special characters', () => {
+    test.it('parses successfully', async () => {
+      const api = await API.loadAPI('./examples/valid/__gitlab-é__.yml');
+      expect(api.version).to.equal('3.0.0');
+    });
+  });
+
   describe('with an http file containing relative URL refs', () => {
     test
       .nock('http://example.org', (api) =>