Update docs and typings

Author: P0lip

docs/ref-parser.md

@@ -6,6 +6,7 @@ This is the default export of JSON Schema $Ref Parser.  You can creates instance
 ##### Properties
 - [`schema`](#schema)
 - [`$refs`](#refs)
+- [`errors`](#errors)
 
 ##### Methods
 - [`dereference()`](#dereferenceschema-options-callback)
@@ -42,6 +43,13 @@ await parser.dereference("my-schema.json");
 parser.$refs.paths();       // => ["my-schema.json"]
 ```
 
+### `errors`
+The `errors` property contains all list of errors that occurred during the bundling/resolving/dereferencing process.
+All errors share error properties:
+- path - json path to the document property
+- message
+- source - the uri of document where the faulty document was referenced
+
 
 ### `dereference(schema, [options], [callback])`
 

lib/index.d.ts

@@ -25,6 +25,13 @@ declare class $RefParser {
    */
   $refs: $RefParser.$Refs
 
+  /**
+   * List of all errors
+   *
+   * See https://github.com/APIDevTools/json-schema-ref-parser/blob/master/docs/ref-parser.md#errors
+   */
+  errors: Array<$RefParser.GenericError | $RefParser.ResolverError | $RefParser.ParserError | $RefParser.MissingPointerError>;
+
   /**
    * Dereferences all `$ref` pointers in the JSON Schema, replacing each reference with its resolved value. This results in a schema object that does not contain any `$ref` pointers. Instead, it's a normal JavaScript object tree that can easily be crawled and used just like any other JavaScript object. This is great for programmatic usage, especially when using tools that don't understand JSON references.
    *
@@ -210,6 +217,12 @@ declare namespace $RefParser {
       [key: string]: Partial<ResolverOptions>
     }
 
+    /**
+     * Determines how lenient the processing should be.
+     * If this option is enable, the processing will be performed in a bail mode - will abort upon the first exception.
+     */
+    failFast?: boolean;
+
     /**
      * The `dereference` options control how JSON Schema `$Ref` Parser will dereference `$ref` pointers within the JSON schema.
      */
@@ -398,4 +411,15 @@ declare namespace $RefParser {
     set($ref: string, value: JSONSchema4Type | JSONSchema6Type): void
   }
 
+  export class GenericError extends Error {
+    readonly message: string;
+    readonly path: Array<string | number>;
+    readonly source: string;
+  }
+
+  export class ParserError extends GenericError {}
+  export class ResolverError extends GenericError {
+    readonly code?: string;
+  }
+  export class MissingPointerError extends GenericError {}
 }