|
|
- declare var ajv: {
- (options?: ajv.Options): ajv.Ajv;
- new(options?: ajv.Options): ajv.Ajv;
- ValidationError: typeof AjvErrors.ValidationError;
- MissingRefError: typeof AjvErrors.MissingRefError;
- $dataMetaSchema: object;
- }
-
- declare namespace AjvErrors {
- class ValidationError extends Error {
- constructor(errors: Array<ajv.ErrorObject>);
-
- message: string;
- errors: Array<ajv.ErrorObject>;
- ajv: true;
- validation: true;
- }
-
- class MissingRefError extends Error {
- constructor(baseId: string, ref: string, message?: string);
- static message: (baseId: string, ref: string) => string;
-
- message: string;
- missingRef: string;
- missingSchema: string;
- }
- }
-
- declare namespace ajv {
- type ValidationError = AjvErrors.ValidationError;
-
- type MissingRefError = AjvErrors.MissingRefError;
-
- interface Ajv {
- /**
- * Validate data using schema
- * Schema will be compiled and cached (using serialized JSON as key, [fast-json-stable-stringify](https://github.com/epoberezkin/fast-json-stable-stringify) is used to serialize by default).
- * @param {string|object|Boolean} schemaKeyRef key, ref or schema object
- * @param {Any} data to be validated
- * @return {Boolean} validation result. Errors from the last validation will be available in `ajv.errors` (and also in compiled schema: `schema.errors`).
- */
- validate(schemaKeyRef: object | string | boolean, data: any): boolean | PromiseLike<any>;
- /**
- * Create validating function for passed schema.
- * @param {object|Boolean} schema schema object
- * @return {Function} validating function
- */
- compile(schema: object | boolean): ValidateFunction;
- /**
- * Creates validating function for passed schema with asynchronous loading of missing schemas.
- * `loadSchema` option should be a function that accepts schema uri and node-style callback.
- * @this Ajv
- * @param {object|Boolean} schema schema object
- * @param {Boolean} meta optional true to compile meta-schema; this parameter can be skipped
- * @param {Function} callback optional node-style callback, it is always called with 2 parameters: error (or null) and validating function.
- * @return {PromiseLike<ValidateFunction>} validating function
- */
- compileAsync(schema: object | boolean, meta?: Boolean, callback?: (err: Error, validate: ValidateFunction) => any): PromiseLike<ValidateFunction>;
- /**
- * Adds schema to the instance.
- * @param {object|Array} schema schema or array of schemas. If array is passed, `key` and other parameters will be ignored.
- * @param {string} key Optional schema key. Can be passed to `validate` method instead of schema object or id/ref. One schema per instance can have empty `id` and `key`.
- * @return {Ajv} this for method chaining
- */
- addSchema(schema: Array<object> | object, key?: string): Ajv;
- /**
- * Add schema that will be used to validate other schemas
- * options in META_IGNORE_OPTIONS are alway set to false
- * @param {object} schema schema object
- * @param {string} key optional schema key
- * @return {Ajv} this for method chaining
- */
- addMetaSchema(schema: object, key?: string): Ajv;
- /**
- * Validate schema
- * @param {object|Boolean} schema schema to validate
- * @return {Boolean} true if schema is valid
- */
- validateSchema(schema: object | boolean): boolean;
- /**
- * Get compiled schema from the instance by `key` or `ref`.
- * @param {string} keyRef `key` that was passed to `addSchema` or full schema reference (`schema.id` or resolved id).
- * @return {Function} schema validating function (with property `schema`). Returns undefined if keyRef can't be resolved to an existing schema.
- */
- getSchema(keyRef: string): ValidateFunction | undefined;
- /**
- * Remove cached schema(s).
- * If no parameter is passed all schemas but meta-schemas are removed.
- * If RegExp is passed all schemas with key/id matching pattern but meta-schemas are removed.
- * Even if schema is referenced by other schemas it still can be removed as other schemas have local references.
- * @param {string|object|RegExp|Boolean} schemaKeyRef key, ref, pattern to match key/ref or schema object
- * @return {Ajv} this for method chaining
- */
- removeSchema(schemaKeyRef?: object | string | RegExp | boolean): Ajv;
- /**
- * Add custom format
- * @param {string} name format name
- * @param {string|RegExp|Function} format string is converted to RegExp; function should return boolean (true when valid)
- * @return {Ajv} this for method chaining
- */
- addFormat(name: string, format: FormatValidator | FormatDefinition): Ajv;
- /**
- * Define custom keyword
- * @this Ajv
- * @param {string} keyword custom keyword, should be a valid identifier, should be different from all standard, custom and macro keywords.
- * @param {object} definition keyword definition object with properties `type` (type(s) which the keyword applies to), `validate` or `compile`.
- * @return {Ajv} this for method chaining
- */
- addKeyword(keyword: string, definition: KeywordDefinition): Ajv;
- /**
- * Get keyword definition
- * @this Ajv
- * @param {string} keyword pre-defined or custom keyword.
- * @return {object|Boolean} custom keyword definition, `true` if it is a predefined keyword, `false` otherwise.
- */
- getKeyword(keyword: string): object | boolean;
- /**
- * Remove keyword
- * @this Ajv
- * @param {string} keyword pre-defined or custom keyword.
- * @return {Ajv} this for method chaining
- */
- removeKeyword(keyword: string): Ajv;
- /**
- * Validate keyword
- * @this Ajv
- * @param {object} definition keyword definition object
- * @param {boolean} throwError true to throw exception if definition is invalid
- * @return {boolean} validation result
- */
- validateKeyword(definition: KeywordDefinition, throwError: boolean): boolean;
- /**
- * Convert array of error message objects to string
- * @param {Array<object>} errors optional array of validation errors, if not passed errors from the instance are used.
- * @param {object} options optional options with properties `separator` and `dataVar`.
- * @return {string} human readable string with all errors descriptions
- */
- errorsText(errors?: Array<ErrorObject> | null, options?: ErrorsTextOptions): string;
- errors?: Array<ErrorObject> | null;
- }
-
- interface CustomLogger {
- log(...args: any[]): any;
- warn(...args: any[]): any;
- error(...args: any[]): any;
- }
-
- interface ValidateFunction {
- (
- data: any,
- dataPath?: string,
- parentData?: object | Array<any>,
- parentDataProperty?: string | number,
- rootData?: object | Array<any>
- ): boolean | PromiseLike<any>;
- schema?: object | boolean;
- errors?: null | Array<ErrorObject>;
- refs?: object;
- refVal?: Array<any>;
- root?: ValidateFunction | object;
- $async?: true;
- source?: object;
- }
-
- interface Options {
- $data?: boolean;
- allErrors?: boolean;
- verbose?: boolean;
- jsonPointers?: boolean;
- uniqueItems?: boolean;
- unicode?: boolean;
- format?: false | string;
- formats?: object;
- keywords?: object;
- unknownFormats?: true | string[] | 'ignore';
- schemas?: Array<object> | object;
- schemaId?: '$id' | 'id' | 'auto';
- missingRefs?: true | 'ignore' | 'fail';
- extendRefs?: true | 'ignore' | 'fail';
- loadSchema?: (uri: string, cb?: (err: Error, schema: object) => void) => PromiseLike<object | boolean>;
- removeAdditional?: boolean | 'all' | 'failing';
- useDefaults?: boolean | 'empty' | 'shared';
- coerceTypes?: boolean | 'array';
- strictDefaults?: boolean | 'log';
- strictKeywords?: boolean | 'log';
- strictNumbers?: boolean;
- async?: boolean | string;
- transpile?: string | ((code: string) => string);
- meta?: boolean | object;
- validateSchema?: boolean | 'log';
- addUsedSchema?: boolean;
- inlineRefs?: boolean | number;
- passContext?: boolean;
- loopRequired?: number;
- ownProperties?: boolean;
- multipleOfPrecision?: boolean | number;
- errorDataPath?: string,
- messages?: boolean;
- sourceCode?: boolean;
- processCode?: (code: string, schema: object) => string;
- cache?: object;
- logger?: CustomLogger | false;
- nullable?: boolean;
- serialize?: ((schema: object | boolean) => any) | false;
- }
-
- type FormatValidator = string | RegExp | ((data: string) => boolean | PromiseLike<any>);
- type NumberFormatValidator = ((data: number) => boolean | PromiseLike<any>);
-
- interface NumberFormatDefinition {
- type: "number",
- validate: NumberFormatValidator;
- compare?: (data1: number, data2: number) => number;
- async?: boolean;
- }
-
- interface StringFormatDefinition {
- type?: "string",
- validate: FormatValidator;
- compare?: (data1: string, data2: string) => number;
- async?: boolean;
- }
-
- type FormatDefinition = NumberFormatDefinition | StringFormatDefinition;
-
- interface KeywordDefinition {
- type?: string | Array<string>;
- async?: boolean;
- $data?: boolean;
- errors?: boolean | string;
- metaSchema?: object;
- // schema: false makes validate not to expect schema (ValidateFunction)
- schema?: boolean;
- statements?: boolean;
- dependencies?: Array<string>;
- modifying?: boolean;
- valid?: boolean;
- // one and only one of the following properties should be present
- validate?: SchemaValidateFunction | ValidateFunction;
- compile?: (schema: any, parentSchema: object, it: CompilationContext) => ValidateFunction;
- macro?: (schema: any, parentSchema: object, it: CompilationContext) => object | boolean;
- inline?: (it: CompilationContext, keyword: string, schema: any, parentSchema: object) => string;
- }
-
- interface CompilationContext {
- level: number;
- dataLevel: number;
- dataPathArr: string[];
- schema: any;
- schemaPath: string;
- baseId: string;
- async: boolean;
- opts: Options;
- formats: {
- [index: string]: FormatDefinition | undefined;
- };
- keywords: {
- [index: string]: KeywordDefinition | undefined;
- };
- compositeRule: boolean;
- validate: (schema: object) => boolean;
- util: {
- copy(obj: any, target?: any): any;
- toHash(source: string[]): { [index: string]: true | undefined };
- equal(obj: any, target: any): boolean;
- getProperty(str: string): string;
- schemaHasRules(schema: object, rules: any): string;
- escapeQuotes(str: string): string;
- toQuotedString(str: string): string;
- getData(jsonPointer: string, dataLevel: number, paths: string[]): string;
- escapeJsonPointer(str: string): string;
- unescapeJsonPointer(str: string): string;
- escapeFragment(str: string): string;
- unescapeFragment(str: string): string;
- };
- self: Ajv;
- }
-
- interface SchemaValidateFunction {
- (
- schema: any,
- data: any,
- parentSchema?: object,
- dataPath?: string,
- parentData?: object | Array<any>,
- parentDataProperty?: string | number,
- rootData?: object | Array<any>
- ): boolean | PromiseLike<any>;
- errors?: Array<ErrorObject>;
- }
-
- interface ErrorsTextOptions {
- separator?: string;
- dataVar?: string;
- }
-
- interface ErrorObject {
- keyword: string;
- dataPath: string;
- schemaPath: string;
- params: ErrorParameters;
- // Added to validation errors of propertyNames keyword schema
- propertyName?: string;
- // Excluded if messages set to false.
- message?: string;
- // These are added with the `verbose` option.
- schema?: any;
- parentSchema?: object;
- data?: any;
- }
-
- type ErrorParameters = RefParams | LimitParams | AdditionalPropertiesParams |
- DependenciesParams | FormatParams | ComparisonParams |
- MultipleOfParams | PatternParams | RequiredParams |
- TypeParams | UniqueItemsParams | CustomParams |
- PatternRequiredParams | PropertyNamesParams |
- IfParams | SwitchParams | NoParams | EnumParams;
-
- interface RefParams {
- ref: string;
- }
-
- interface LimitParams {
- limit: number;
- }
-
- interface AdditionalPropertiesParams {
- additionalProperty: string;
- }
-
- interface DependenciesParams {
- property: string;
- missingProperty: string;
- depsCount: number;
- deps: string;
- }
-
- interface FormatParams {
- format: string
- }
-
- interface ComparisonParams {
- comparison: string;
- limit: number | string;
- exclusive: boolean;
- }
-
- interface MultipleOfParams {
- multipleOf: number;
- }
-
- interface PatternParams {
- pattern: string;
- }
-
- interface RequiredParams {
- missingProperty: string;
- }
-
- interface TypeParams {
- type: string;
- }
-
- interface UniqueItemsParams {
- i: number;
- j: number;
- }
-
- interface CustomParams {
- keyword: string;
- }
-
- interface PatternRequiredParams {
- missingPattern: string;
- }
-
- interface PropertyNamesParams {
- propertyName: string;
- }
-
- interface IfParams {
- failingKeyword: string;
- }
-
- interface SwitchParams {
- caseIndex: number;
- }
-
- interface NoParams { }
-
- interface EnumParams {
- allowedValues: Array<any>;
- }
- }
-
- export = ajv;
|