aboutsummaryrefslogtreecommitdiffstats
path: root/packages/json-schemas/src/schema_validator.ts
blob: 43647b5940ef4a1cc6a60d3b2d3d180a3bfb5aab (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
import { Schema, Validator, ValidatorResult } from 'jsonschema';
import values = require('lodash.values');

import { schemas } from './schemas';

/**
 * A validator for [JSON-schemas](http://json-schema.org/)
 */
export class SchemaValidator {
    private readonly _validator: Validator;
    private static _assertSchemaDefined(schema: Schema): void {
        if (schema === undefined) {
            throw new Error(`Cannot add undefined schema`);
        }
    }
    /**
     * Instantiates a SchemaValidator instance
     */
    constructor() {
        this._validator = new Validator();
        for (const schema of values(schemas)) {
            SchemaValidator._assertSchemaDefined(schema);
            this._validator.addSchema(schema, schema.id);
        }
    }
    /**
     * Add a schema to the validator. All schemas and sub-schemas must be added to
     * the validator before the `validate` and `isValid` methods can be called with
     * instances of that schema.
     * @param schema The schema to add
     */
    public addSchema(schema: Schema): void {
        SchemaValidator._assertSchemaDefined(schema);
        this._validator.addSchema(schema, schema.id);
    }
    // In order to validate a complex JS object using jsonschema, we must replace any complex
    // sub-types (e.g BigNumber) with a simpler string representation. Since BigNumber and other
    // complex types implement the `toString` method, we can stringify the object and
    // then parse it. The resultant object can then be checked using jsonschema.
    /**
     * Validate the JS object conforms to a specific JSON schema
     * @param instance JS object in question
     * @param schema Schema to check against
     * @returns The results of the validation
     */
    public validate(instance: any, schema: Schema): ValidatorResult {
        SchemaValidator._assertSchemaDefined(schema);
        const jsonSchemaCompatibleObject = JSON.parse(JSON.stringify(instance));
        return this._validator.validate(jsonSchemaCompatibleObject, schema);
    }
    /**
     * Check whether an instance properly adheres to a JSON schema
     * @param instance JS object in question
     * @param schema Schema to check against
     * @returns Whether or not the instance adheres to the schema
     */
    public isValid(instance: any, schema: Schema): boolean {
        const isValid = this.validate(instance, schema).errors.length === 0;
        return isValid;
    }
}