UNPKG

8.25 kBTypeScriptView Raw
1export { Format, FormatDefinition, AsyncFormatDefinition, KeywordDefinition, KeywordErrorDefinition, CodeKeywordDefinition, MacroKeywordDefinition, FuncKeywordDefinition, Vocabulary, Schema, SchemaObject, AnySchemaObject, AsyncSchema, AnySchema, ValidateFunction, AsyncValidateFunction, AnyValidateFunction, ErrorObject, ErrorNoParams, } from "./types";
2export { SchemaCxt, SchemaObjCxt } from "./compile";
3export interface Plugin<Opts> {
4 (ajv: Ajv, options?: Opts): Ajv;
5 [prop: string]: any;
6}
7export { KeywordCxt } from "./compile/validate";
8export { DefinedError } from "./vocabularies/errors";
9export { JSONType } from "./compile/rules";
10export { JSONSchemaType } from "./types/json-schema";
11export { JTDSchemaType, SomeJTDSchemaType, JTDDataType } from "./types/jtd-schema";
12export { _, str, stringify, nil, Name, Code, CodeGen, CodeGenOptions } from "./compile/codegen";
13import type { Schema, AnySchema, AnySchemaObject, SchemaObject, AsyncSchema, Vocabulary, KeywordDefinition, AddedKeywordDefinition, AnyValidateFunction, ValidateFunction, AsyncValidateFunction, ErrorObject, Format, AddedFormat, RegExpEngine } from "./types";
14import type { JSONSchemaType } from "./types/json-schema";
15import type { JTDSchemaType, SomeJTDSchemaType, JTDDataType } from "./types/jtd-schema";
16import ValidationError from "./runtime/validation_error";
17import MissingRefError from "./compile/ref_error";
18import { ValidationRules } from "./compile/rules";
19import { SchemaEnv } from "./compile";
20import { Code, ValueScope } from "./compile/codegen";
21export declare type Options = CurrentOptions & DeprecatedOptions;
22export interface CurrentOptions {
23 strict?: boolean | "log";
24 strictSchema?: boolean | "log";
25 strictNumbers?: boolean | "log";
26 strictTypes?: boolean | "log";
27 strictTuples?: boolean | "log";
28 strictRequired?: boolean | "log";
29 allowMatchingProperties?: boolean;
30 allowUnionTypes?: boolean;
31 validateFormats?: boolean;
32 $data?: boolean;
33 allErrors?: boolean;
34 verbose?: boolean;
35 discriminator?: boolean;
36 unicodeRegExp?: boolean;
37 timestamp?: "string" | "date";
38 parseDate?: boolean;
39 allowDate?: boolean;
40 $comment?: true | ((comment: string, schemaPath?: string, rootSchema?: AnySchemaObject) => unknown);
41 formats?: {
42 [Name in string]?: Format;
43 };
44 keywords?: Vocabulary;
45 schemas?: AnySchema[] | {
46 [Key in string]?: AnySchema;
47 };
48 logger?: Logger | false;
49 loadSchema?: (uri: string) => Promise<AnySchemaObject>;
50 removeAdditional?: boolean | "all" | "failing";
51 useDefaults?: boolean | "empty";
52 coerceTypes?: boolean | "array";
53 next?: boolean;
54 unevaluated?: boolean;
55 dynamicRef?: boolean;
56 schemaId?: "id" | "$id";
57 jtd?: boolean;
58 meta?: SchemaObject | boolean;
59 defaultMeta?: string | AnySchemaObject;
60 validateSchema?: boolean | "log";
61 addUsedSchema?: boolean;
62 inlineRefs?: boolean | number;
63 passContext?: boolean;
64 loopRequired?: number;
65 loopEnum?: number;
66 ownProperties?: boolean;
67 multipleOfPrecision?: number;
68 int32range?: boolean;
69 messages?: boolean;
70 code?: CodeOptions;
71}
72export interface CodeOptions {
73 es5?: boolean;
74 esm?: boolean;
75 lines?: boolean;
76 optimize?: boolean | number;
77 formats?: Code;
78 source?: boolean;
79 process?: (code: string, schema?: SchemaEnv) => string;
80 regExp?: RegExpEngine;
81}
82interface InstanceCodeOptions extends CodeOptions {
83 regExp: RegExpEngine;
84 optimize: number;
85}
86interface DeprecatedOptions {
87 /** @deprecated */
88 ignoreKeywordsWithRef?: boolean;
89 /** @deprecated */
90 jsPropertySyntax?: boolean;
91 /** @deprecated */
92 unicode?: boolean;
93}
94declare type RequiredInstanceOptions = {
95 [K in "strictSchema" | "strictNumbers" | "strictTypes" | "strictTuples" | "strictRequired" | "inlineRefs" | "loopRequired" | "loopEnum" | "meta" | "messages" | "schemaId" | "addUsedSchema" | "validateSchema" | "validateFormats" | "int32range" | "unicodeRegExp"]: NonNullable<Options[K]>;
96} & {
97 code: InstanceCodeOptions;
98};
99export declare type InstanceOptions = Options & RequiredInstanceOptions;
100export interface Logger {
101 log(...args: unknown[]): unknown;
102 warn(...args: unknown[]): unknown;
103 error(...args: unknown[]): unknown;
104}
105export default class Ajv {
106 opts: InstanceOptions;
107 errors?: ErrorObject[] | null;
108 logger: Logger;
109 readonly scope: ValueScope;
110 readonly schemas: {
111 [Key in string]?: SchemaEnv;
112 };
113 readonly refs: {
114 [Ref in string]?: SchemaEnv | string;
115 };
116 readonly formats: {
117 [Name in string]?: AddedFormat;
118 };
119 readonly RULES: ValidationRules;
120 readonly _compilations: Set<SchemaEnv>;
121 private readonly _loading;
122 private readonly _cache;
123 private readonly _metaOpts;
124 static ValidationError: typeof ValidationError;
125 static MissingRefError: typeof MissingRefError;
126 constructor(opts?: Options);
127 _addVocabularies(): void;
128 _addDefaultMetaSchema(): void;
129 defaultMeta(): string | AnySchemaObject | undefined;
130 validate(schema: Schema | string, data: unknown): boolean;
131 validate(schemaKeyRef: AnySchema | string, data: unknown): boolean | Promise<unknown>;
132 validate<T>(schema: Schema | JSONSchemaType<T> | string, data: unknown): data is T;
133 validate<T>(schema: JTDSchemaType<T>, data: unknown): data is T;
134 validate<N extends never, T extends SomeJTDSchemaType>(schema: T, data: unknown): data is JTDDataType<T>;
135 validate<T>(schema: AsyncSchema, data: unknown | T): Promise<T>;
136 validate<T>(schemaKeyRef: AnySchema | string, data: unknown): data is T | Promise<T>;
137 compile<T = unknown>(schema: Schema | JSONSchemaType<T>, _meta?: boolean): ValidateFunction<T>;
138 compile<T = unknown>(schema: JTDSchemaType<T>, _meta?: boolean): ValidateFunction<T>;
139 compile<N extends never, T extends SomeJTDSchemaType>(schema: T, _meta?: boolean): ValidateFunction<JTDDataType<T>>;
140 compile<T = unknown>(schema: AsyncSchema, _meta?: boolean): AsyncValidateFunction<T>;
141 compile<T = unknown>(schema: AnySchema, _meta?: boolean): AnyValidateFunction<T>;
142 compileAsync<T = unknown>(schema: SchemaObject | JSONSchemaType<T>, _meta?: boolean): Promise<ValidateFunction<T>>;
143 compileAsync<T = unknown>(schema: JTDSchemaType<T>, _meta?: boolean): Promise<ValidateFunction<T>>;
144 compileAsync<T = unknown>(schema: AsyncSchema, meta?: boolean): Promise<AsyncValidateFunction<T>>;
145 compileAsync<T = unknown>(schema: AnySchemaObject, meta?: boolean): Promise<AnyValidateFunction<T>>;
146 addSchema(schema: AnySchema | AnySchema[], // If array is passed, `key` will be ignored
147 key?: string, // 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`.
148 _meta?: boolean, // true if schema is a meta-schema. Used internally, addMetaSchema should be used instead.
149 _validateSchema?: boolean | "log"): Ajv;
150 addMetaSchema(schema: AnySchemaObject, key?: string, // schema key
151 _validateSchema?: boolean | "log"): Ajv;
152 validateSchema(schema: AnySchema, throwOrLogError?: boolean): boolean | Promise<unknown>;
153 getSchema<T = unknown>(keyRef: string): AnyValidateFunction<T> | undefined;
154 removeSchema(schemaKeyRef?: AnySchema | string | RegExp): Ajv;
155 addVocabulary(definitions: Vocabulary): Ajv;
156 addKeyword(kwdOrDef: string | KeywordDefinition, def?: KeywordDefinition): Ajv;
157 getKeyword(keyword: string): AddedKeywordDefinition | boolean;
158 removeKeyword(keyword: string): Ajv;
159 addFormat(name: string, format: Format): Ajv;
160 errorsText(errors?: ErrorObject[] | null | undefined, // optional array of validation errors
161 { separator, dataVar }?: ErrorsTextOptions): string;
162 $dataMetaSchema(metaSchema: AnySchemaObject, keywordsJsonPointers: string[]): AnySchemaObject;
163 private _removeAllSchemas;
164 _addSchema(schema: AnySchema, meta?: boolean, baseId?: string, validateSchema?: boolean | "log", addSchema?: boolean): SchemaEnv;
165 private _checkUnique;
166 private _compileSchemaEnv;
167 private _compileMetaSchema;
168}
169export interface ErrorsTextOptions {
170 separator?: string;
171 dataVar?: string;
172}