vaderjs 1.1.0 → 1.1.2

package/website/node_modules/ts-interface-checker/dist/index.js

@@ -0,0 +1,224 @@
+"use strict";
+var __spreadArrays = (this && this.__spreadArrays) || function () {
+    for (var s = 0, i = 0, il = arguments.length; i < il; i++) s += arguments[i].length;
+    for (var r = Array(s), k = 0, i = 0; i < il; i++)
+        for (var a = arguments[i], j = 0, jl = a.length; j < jl; j++, k++)
+            r[k] = a[j];
+    return r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Checker = exports.createCheckers = void 0;
+var types_1 = require("./types");
+var util_1 = require("./util");
+/**
+ * Export functions used to define interfaces.
+ */
+var types_2 = require("./types");
+Object.defineProperty(exports, "TArray", { enumerable: true, get: function () { return types_2.TArray; } });
+Object.defineProperty(exports, "TEnumType", { enumerable: true, get: function () { return types_2.TEnumType; } });
+Object.defineProperty(exports, "TEnumLiteral", { enumerable: true, get: function () { return types_2.TEnumLiteral; } });
+Object.defineProperty(exports, "TFunc", { enumerable: true, get: function () { return types_2.TFunc; } });
+Object.defineProperty(exports, "TIface", { enumerable: true, get: function () { return types_2.TIface; } });
+Object.defineProperty(exports, "TLiteral", { enumerable: true, get: function () { return types_2.TLiteral; } });
+Object.defineProperty(exports, "TName", { enumerable: true, get: function () { return types_2.TName; } });
+Object.defineProperty(exports, "TOptional", { enumerable: true, get: function () { return types_2.TOptional; } });
+Object.defineProperty(exports, "TParam", { enumerable: true, get: function () { return types_2.TParam; } });
+Object.defineProperty(exports, "TParamList", { enumerable: true, get: function () { return types_2.TParamList; } });
+Object.defineProperty(exports, "TProp", { enumerable: true, get: function () { return types_2.TProp; } });
+Object.defineProperty(exports, "TTuple", { enumerable: true, get: function () { return types_2.TTuple; } });
+Object.defineProperty(exports, "TType", { enumerable: true, get: function () { return types_2.TType; } });
+Object.defineProperty(exports, "TUnion", { enumerable: true, get: function () { return types_2.TUnion; } });
+Object.defineProperty(exports, "TIntersection", { enumerable: true, get: function () { return types_2.TIntersection; } });
+Object.defineProperty(exports, "array", { enumerable: true, get: function () { return types_2.array; } });
+Object.defineProperty(exports, "enumlit", { enumerable: true, get: function () { return types_2.enumlit; } });
+Object.defineProperty(exports, "enumtype", { enumerable: true, get: function () { return types_2.enumtype; } });
+Object.defineProperty(exports, "func", { enumerable: true, get: function () { return types_2.func; } });
+Object.defineProperty(exports, "iface", { enumerable: true, get: function () { return types_2.iface; } });
+Object.defineProperty(exports, "lit", { enumerable: true, get: function () { return types_2.lit; } });
+Object.defineProperty(exports, "name", { enumerable: true, get: function () { return types_2.name; } });
+Object.defineProperty(exports, "opt", { enumerable: true, get: function () { return types_2.opt; } });
+Object.defineProperty(exports, "param", { enumerable: true, get: function () { return types_2.param; } });
+Object.defineProperty(exports, "tuple", { enumerable: true, get: function () { return types_2.tuple; } });
+Object.defineProperty(exports, "union", { enumerable: true, get: function () { return types_2.union; } });
+Object.defineProperty(exports, "intersection", { enumerable: true, get: function () { return types_2.intersection; } });
+Object.defineProperty(exports, "BasicType", { enumerable: true, get: function () { return types_2.BasicType; } });
+var util_2 = require("./util");
+Object.defineProperty(exports, "VError", { enumerable: true, get: function () { return util_2.VError; } });
+/**
+ * Takes one of more type suites (e.g. a module generated by `ts-interface-builder`), and combines
+ * them into a suite of interface checkers. If a type is used by name, that name should be present
+ * among the passed-in type suites.
+ *
+ * The returned object maps type names to Checker objects.
+ */
+function createCheckers() {
+    var typeSuite = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        typeSuite[_i] = arguments[_i];
+    }
+    var fullSuite = Object.assign.apply(Object, __spreadArrays([{}, types_1.basicTypes], typeSuite));
+    var checkers = {};
+    for (var _a = 0, typeSuite_1 = typeSuite; _a < typeSuite_1.length; _a++) {
+        var suite_1 = typeSuite_1[_a];
+        for (var _b = 0, _c = Object.keys(suite_1); _b < _c.length; _b++) {
+            var name = _c[_b];
+            checkers[name] = new Checker(fullSuite, suite_1[name]);
+        }
+    }
+    return checkers;
+}
+exports.createCheckers = createCheckers;
+/**
+ * Checker implements validation of objects, and also includes accessors to validate method calls.
+ * Checkers should be created using `createCheckers()`.
+ */
+var Checker = /** @class */ (function () {
+    // Create checkers by using `createCheckers()` function.
+    function Checker(suite, ttype, _path) {
+        if (_path === void 0) { _path = 'value'; }
+        this.suite = suite;
+        this.ttype = ttype;
+        this._path = _path;
+        this.props = new Map();
+        if (ttype instanceof types_1.TIface) {
+            for (var _i = 0, _a = ttype.props; _i < _a.length; _i++) {
+                var p = _a[_i];
+                this.props.set(p.name, p.ttype);
+            }
+        }
+        this.checkerPlain = this.ttype.getChecker(suite, false);
+        this.checkerStrict = this.ttype.getChecker(suite, true);
+    }
+    /**
+     * Set the path to report in errors, instead of the default "value". (E.g. if the Checker is for
+     * a "person" interface, set path to "person" to report e.g. "person.name is not a string".)
+     */
+    Checker.prototype.setReportedPath = function (path) {
+        this._path = path;
+    };
+    /**
+     * Check that the given value satisfies this checker's type, or throw Error.
+     */
+    Checker.prototype.check = function (value) { return this._doCheck(this.checkerPlain, value); };
+    /**
+     * A fast check for whether or not the given value satisfies this Checker's type. This returns
+     * true or false, does not produce an error message, and is fast both on success and on failure.
+     */
+    Checker.prototype.test = function (value) {
+        return this.checkerPlain(value, new util_1.NoopContext());
+    };
+    /**
+     * Returns an error object describing the errors if the given value does not satisfy this
+     * Checker's type, or null if it does.
+     */
+    Checker.prototype.validate = function (value) {
+        return this._doValidate(this.checkerPlain, value);
+    };
+    /**
+     * Check that the given value satisfies this checker's type strictly. This checks that objects
+     * and tuples have no extra members. Note that this prevents backward compatibility, so usually
+     * a plain check() is more appropriate.
+     */
+    Checker.prototype.strictCheck = function (value) { return this._doCheck(this.checkerStrict, value); };
+    /**
+     * A fast strict check for whether or not the given value satisfies this Checker's type. Returns
+     * true or false, does not produce an error message, and is fast both on success and on failure.
+     */
+    Checker.prototype.strictTest = function (value) {
+        return this.checkerStrict(value, new util_1.NoopContext());
+    };
+    /**
+     * Returns an error object describing the errors if the given value does not satisfy this
+     * Checker's type strictly, or null if it does.
+     */
+    Checker.prototype.strictValidate = function (value) {
+        return this._doValidate(this.checkerStrict, value);
+    };
+    /**
+     * If this checker is for an interface, returns a Checker for the type required for the given
+     * property of this interface.
+     */
+    Checker.prototype.getProp = function (prop) {
+        var ttype = this.props.get(prop);
+        if (!ttype) {
+            throw new Error("Type has no property " + prop);
+        }
+        return new Checker(this.suite, ttype, this._path + "." + prop);
+    };
+    /**
+     * If this checker is for an interface, returns a Checker for the argument-list required to call
+     * the given method of this interface. E.g. if this Checker is for the interface:
+     *    interface Foo {
+     *      find(s: string, pos?: number): number;
+     *    }
+     * Then methodArgs("find").check(...) will succeed for ["foo"] and ["foo", 3], but not for [17].
+     */
+    Checker.prototype.methodArgs = function (methodName) {
+        var tfunc = this._getMethod(methodName);
+        return new Checker(this.suite, tfunc.paramList);
+    };
+    /**
+     * If this checker is for an interface, returns a Checker for the return value of the given
+     * method of this interface.
+     */
+    Checker.prototype.methodResult = function (methodName) {
+        var tfunc = this._getMethod(methodName);
+        return new Checker(this.suite, tfunc.result);
+    };
+    /**
+     * If this checker is for a function, returns a Checker for its argument-list.
+     */
+    Checker.prototype.getArgs = function () {
+        if (!(this.ttype instanceof types_1.TFunc)) {
+            throw new Error("getArgs() applied to non-function");
+        }
+        return new Checker(this.suite, this.ttype.paramList);
+    };
+    /**
+     * If this checker is for a function, returns a Checker for its result.
+     */
+    Checker.prototype.getResult = function () {
+        if (!(this.ttype instanceof types_1.TFunc)) {
+            throw new Error("getResult() applied to non-function");
+        }
+        return new Checker(this.suite, this.ttype.result);
+    };
+    /**
+     * Return the type for which this is a checker.
+     */
+    Checker.prototype.getType = function () {
+        return this.ttype;
+    };
+    /**
+     * Actual implementation of check() and strictCheck().
+     */
+    Checker.prototype._doCheck = function (checkerFunc, value) {
+        var noopCtx = new util_1.NoopContext();
+        if (!checkerFunc(value, noopCtx)) {
+            var detailCtx = new util_1.DetailContext();
+            checkerFunc(value, detailCtx);
+            throw detailCtx.getError(this._path);
+        }
+    };
+    Checker.prototype._doValidate = function (checkerFunc, value) {
+        var noopCtx = new util_1.NoopContext();
+        if (checkerFunc(value, noopCtx)) {
+            return null;
+        }
+        var detailCtx = new util_1.DetailContext();
+        checkerFunc(value, detailCtx);
+        return detailCtx.getErrorDetail(this._path);
+    };
+    Checker.prototype._getMethod = function (methodName) {
+        var ttype = this.props.get(methodName);
+        if (!ttype) {
+            throw new Error("Type has no property " + methodName);
+        }
+        if (!(ttype instanceof types_1.TFunc)) {
+            throw new Error("Property " + methodName + " is not a method");
+        }
+        return ttype;
+    };
+    return Checker;
+}());
+exports.Checker = Checker;

package/website/node_modules/ts-interface-checker/dist/types.d.ts

@@ -0,0 +1,181 @@
+/**
+ * This module defines nodes used to define types and validations for objects and interfaces.
+ */
+import { IContext } from "./util";
+export declare type CheckerFunc = (value: any, ctx: IContext) => boolean;
+/** Node that represents a type. */
+export declare abstract class TType {
+    abstract getChecker(suite: ITypeSuite, strict: boolean, allowedProps?: Set<string>): CheckerFunc;
+}
+/**
+ * Descriptor from which TType may be build (by parseSpec()). A plain string is equivalent to
+ * name(string).
+ */
+export declare type TypeSpec = TType | string;
+/**
+ * Represents a suite of named types. Suites are used to resolve type names.
+ */
+export interface ITypeSuite {
+    [name: string]: TType;
+}
+/**
+ * Defines a type name, either built-in, or defined in this suite. It can typically be included in
+ * the specs as just a plain string.
+ */
+export declare function name(value: string): TName;
+export declare class TName extends TType {
+    name: string;
+    private _failMsg;
+    constructor(name: string);
+    getChecker(suite: ITypeSuite, strict: boolean, allowedProps?: Set<string>): CheckerFunc;
+}
+/**
+ * Defines a literal value, e.g. lit('hello') or lit(123).
+ */
+export declare function lit(value: any): TLiteral;
+export declare class TLiteral extends TType {
+    value: any;
+    name: string;
+    private _failMsg;
+    constructor(value: any);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines an array type, e.g. array('number').
+ */
+export declare function array(typeSpec: TypeSpec): TArray;
+export declare class TArray extends TType {
+    ttype: TType;
+    constructor(ttype: TType);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines a tuple type, e.g. tuple('string', 'number').
+ */
+export declare function tuple(...typeSpec: TypeSpec[]): TTuple;
+export declare class TTuple extends TType {
+    ttypes: TType[];
+    constructor(ttypes: TType[]);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines a union type, e.g. union('number', 'null').
+ */
+export declare function union(...typeSpec: TypeSpec[]): TUnion;
+export declare class TUnion extends TType {
+    ttypes: TType[];
+    private _failMsg;
+    constructor(ttypes: TType[]);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines an intersection type, e.g. intersection('number', 'null').
+ */
+export declare function intersection(...typeSpec: TypeSpec[]): TIntersection;
+export declare class TIntersection extends TType {
+    ttypes: TType[];
+    constructor(ttypes: TType[]);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines an enum type, e.g. enum({'A': 1, 'B': 2}).
+ */
+export declare function enumtype(values: {
+    [name: string]: string | number;
+}): TEnumType;
+export declare class TEnumType extends TType {
+    members: {
+        [name: string]: string | number;
+    };
+    readonly validValues: Set<string | number>;
+    private _failMsg;
+    constructor(members: {
+        [name: string]: string | number;
+    });
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines a literal enum value, such as Direction.Up, specified as enumlit("Direction", "Up").
+ */
+export declare function enumlit(name: string, prop: string): TEnumLiteral;
+export declare class TEnumLiteral extends TType {
+    enumName: string;
+    prop: string;
+    private _failMsg;
+    constructor(enumName: string, prop: string);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines an interface. The first argument is an array of interfaces that it extends, and the
+ * second is an array of properties.
+ */
+export declare function iface(bases: string[], props: {
+    [name: string]: TOptional | TypeSpec;
+}): TIface;
+export declare class TIface extends TType {
+    bases: string[];
+    props: TProp[];
+    private propSet;
+    constructor(bases: string[], props: TProp[]);
+    getChecker(suite: ITypeSuite, strict: boolean, allowedProps?: Set<string>): CheckerFunc;
+}
+/**
+ * Defines an optional property on an interface.
+ */
+export declare function opt(typeSpec: TypeSpec): TOptional;
+export declare class TOptional extends TType {
+    ttype: TType;
+    constructor(ttype: TType);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines a property in an interface.
+ */
+export declare class TProp {
+    name: string;
+    ttype: TType;
+    isOpt: boolean;
+    constructor(name: string, ttype: TType, isOpt: boolean);
+}
+/**
+ * Defines a function. The first argument declares the function's return type, the rest declare
+ * its parameters.
+ */
+export declare function func(resultSpec: TypeSpec, ...params: TParam[]): TFunc;
+export declare class TFunc extends TType {
+    paramList: TParamList;
+    result: TType;
+    constructor(paramList: TParamList, result: TType);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines a function parameter.
+ */
+export declare function param(name: string, typeSpec: TypeSpec, isOpt?: boolean): TParam;
+export declare class TParam {
+    name: string;
+    ttype: TType;
+    isOpt: boolean;
+    constructor(name: string, ttype: TType, isOpt: boolean);
+}
+/**
+ * Defines a function parameter list.
+ */
+export declare class TParamList extends TType {
+    params: TParam[];
+    constructor(params: TParam[]);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Single TType implementation for all basic built-in types.
+ */
+export declare class BasicType extends TType {
+    validator: (value: any) => boolean;
+    private message;
+    constructor(validator: (value: any) => boolean, message: string);
+    getChecker(suite: ITypeSuite, strict: boolean): CheckerFunc;
+}
+/**
+ * Defines the suite of basic types.
+ */
+export declare const basicTypes: ITypeSuite;