1 | export {
|
2 | Format,
|
3 | FormatDefinition,
|
4 | AsyncFormatDefinition,
|
5 | KeywordDefinition,
|
6 | KeywordErrorDefinition,
|
7 | CodeKeywordDefinition,
|
8 | MacroKeywordDefinition,
|
9 | FuncKeywordDefinition,
|
10 | Vocabulary,
|
11 | Schema,
|
12 | SchemaObject,
|
13 | AnySchemaObject,
|
14 | AsyncSchema,
|
15 | AnySchema,
|
16 | ValidateFunction,
|
17 | AsyncValidateFunction,
|
18 | AnyValidateFunction,
|
19 | ErrorObject,
|
20 | ErrorNoParams,
|
21 | } from "./types"
|
22 |
|
23 | export {SchemaCxt, SchemaObjCxt} from "./compile"
|
24 | export interface Plugin<Opts> {
|
25 | (ajv: Ajv, options?: Opts): Ajv
|
26 | [prop: string]: any
|
27 | }
|
28 |
|
29 | export {KeywordCxt} from "./compile/validate"
|
30 | export {DefinedError} from "./vocabularies/errors"
|
31 | export {JSONType} from "./compile/rules"
|
32 | export {JSONSchemaType} from "./types/json-schema"
|
33 | export {JTDSchemaType, SomeJTDSchemaType, JTDDataType} from "./types/jtd-schema"
|
34 | export {_, str, stringify, nil, Name, Code, CodeGen, CodeGenOptions} from "./compile/codegen"
|
35 |
|
36 | import type {
|
37 | Schema,
|
38 | AnySchema,
|
39 | AnySchemaObject,
|
40 | SchemaObject,
|
41 | AsyncSchema,
|
42 | Vocabulary,
|
43 | KeywordDefinition,
|
44 | AddedKeywordDefinition,
|
45 | AnyValidateFunction,
|
46 | ValidateFunction,
|
47 | AsyncValidateFunction,
|
48 | ErrorObject,
|
49 | Format,
|
50 | AddedFormat,
|
51 | RegExpEngine,
|
52 | UriResolver,
|
53 | } from "./types"
|
54 | import type {JSONSchemaType} from "./types/json-schema"
|
55 | import type {JTDSchemaType, SomeJTDSchemaType, JTDDataType} from "./types/jtd-schema"
|
56 | import ValidationError from "./runtime/validation_error"
|
57 | import MissingRefError from "./compile/ref_error"
|
58 | import {getRules, ValidationRules, Rule, RuleGroup, JSONType} from "./compile/rules"
|
59 | import {SchemaEnv, compileSchema, resolveSchema} from "./compile"
|
60 | import {Code, ValueScope} from "./compile/codegen"
|
61 | import {normalizeId, getSchemaRefs} from "./compile/resolve"
|
62 | import {getJSONTypes} from "./compile/validate/dataType"
|
63 | import {eachItem} from "./compile/util"
|
64 | import * as $dataRefSchema from "./refs/data.json"
|
65 |
|
66 | import DefaultUriResolver from "./runtime/uri"
|
67 |
|
68 | const defaultRegExp: RegExpEngine = (str, flags) => new RegExp(str, flags)
|
69 | defaultRegExp.code = "new RegExp"
|
70 |
|
71 | const META_IGNORE_OPTIONS: (keyof Options)[] = ["removeAdditional", "useDefaults", "coerceTypes"]
|
72 | const EXT_SCOPE_NAMES = new Set([
|
73 | "validate",
|
74 | "serialize",
|
75 | "parse",
|
76 | "wrapper",
|
77 | "root",
|
78 | "schema",
|
79 | "keyword",
|
80 | "pattern",
|
81 | "formats",
|
82 | "validate$data",
|
83 | "func",
|
84 | "obj",
|
85 | "Error",
|
86 | ])
|
87 |
|
88 | export type Options = CurrentOptions & DeprecatedOptions
|
89 |
|
90 | export interface CurrentOptions {
|
91 |
|
92 | strict?: boolean | "log"
|
93 | strictSchema?: boolean | "log"
|
94 | strictNumbers?: boolean | "log"
|
95 | strictTypes?: boolean | "log"
|
96 | strictTuples?: boolean | "log"
|
97 | strictRequired?: boolean | "log"
|
98 | allowMatchingProperties?: boolean
|
99 | allowUnionTypes?: boolean
|
100 | validateFormats?: boolean
|
101 |
|
102 | $data?: boolean
|
103 | allErrors?: boolean
|
104 | verbose?: boolean
|
105 | discriminator?: boolean
|
106 | unicodeRegExp?: boolean
|
107 | timestamp?: "string" | "date"
|
108 | parseDate?: boolean
|
109 | allowDate?: boolean
|
110 | $comment?:
|
111 | | true
|
112 | | ((comment: string, schemaPath?: string, rootSchema?: AnySchemaObject) => unknown)
|
113 | formats?: {[Name in string]?: Format}
|
114 | keywords?: Vocabulary
|
115 | schemas?: AnySchema[] | {[Key in string]?: AnySchema}
|
116 | logger?: Logger | false
|
117 | loadSchema?: (uri: string) => Promise<AnySchemaObject>
|
118 |
|
119 | removeAdditional?: boolean | "all" | "failing"
|
120 | useDefaults?: boolean | "empty"
|
121 | coerceTypes?: boolean | "array"
|
122 |
|
123 | next?: boolean
|
124 | unevaluated?: boolean
|
125 | dynamicRef?: boolean
|
126 | schemaId?: "id" | "$id"
|
127 | jtd?: boolean
|
128 | meta?: SchemaObject | boolean
|
129 | defaultMeta?: string | AnySchemaObject
|
130 | validateSchema?: boolean | "log"
|
131 | addUsedSchema?: boolean
|
132 | inlineRefs?: boolean | number
|
133 | passContext?: boolean
|
134 | loopRequired?: number
|
135 | loopEnum?: number
|
136 | ownProperties?: boolean
|
137 | multipleOfPrecision?: number
|
138 | int32range?: boolean
|
139 | messages?: boolean
|
140 | code?: CodeOptions
|
141 | uriResolver?: UriResolver
|
142 | }
|
143 |
|
144 | export interface CodeOptions {
|
145 | es5?: boolean
|
146 | esm?: boolean
|
147 | lines?: boolean
|
148 | optimize?: boolean | number
|
149 | formats?: Code
|
150 | source?: boolean
|
151 | process?: (code: string, schema?: SchemaEnv) => string
|
152 | regExp?: RegExpEngine
|
153 | }
|
154 |
|
155 | interface InstanceCodeOptions extends CodeOptions {
|
156 | regExp: RegExpEngine
|
157 | optimize: number
|
158 | }
|
159 |
|
160 | interface DeprecatedOptions {
|
161 |
|
162 | ignoreKeywordsWithRef?: boolean
|
163 |
|
164 | jsPropertySyntax?: boolean
|
165 |
|
166 | unicode?: boolean
|
167 | }
|
168 |
|
169 | interface RemovedOptions {
|
170 | format?: boolean
|
171 | errorDataPath?: "object" | "property"
|
172 | nullable?: boolean
|
173 | jsonPointers?: boolean
|
174 | extendRefs?: true | "ignore" | "fail"
|
175 | missingRefs?: true | "ignore" | "fail"
|
176 | processCode?: (code: string, schema?: SchemaEnv) => string
|
177 | sourceCode?: boolean
|
178 | strictDefaults?: boolean
|
179 | strictKeywords?: boolean
|
180 | uniqueItems?: boolean
|
181 | unknownFormats?: true | string[] | "ignore"
|
182 | cache?: any
|
183 | serialize?: (schema: AnySchema) => unknown
|
184 | ajvErrors?: boolean
|
185 | }
|
186 |
|
187 | type OptionsInfo<T extends RemovedOptions | DeprecatedOptions> = {
|
188 | [K in keyof T]-?: string | undefined
|
189 | }
|
190 |
|
191 | const removedOptions: OptionsInfo<RemovedOptions> = {
|
192 | errorDataPath: "",
|
193 | format: "`validateFormats: false` can be used instead.",
|
194 | nullable: '"nullable" keyword is supported by default.',
|
195 | jsonPointers: "Deprecated jsPropertySyntax can be used instead.",
|
196 | extendRefs: "Deprecated ignoreKeywordsWithRef can be used instead.",
|
197 | missingRefs: "Pass empty schema with $id that should be ignored to ajv.addSchema.",
|
198 | processCode: "Use option `code: {process: (code, schemaEnv: object) => string}`",
|
199 | sourceCode: "Use option `code: {source: true}`",
|
200 | strictDefaults: "It is default now, see option `strict`.",
|
201 | strictKeywords: "It is default now, see option `strict`.",
|
202 | uniqueItems: '"uniqueItems" keyword is always validated.',
|
203 | unknownFormats: "Disable strict mode or pass `true` to `ajv.addFormat` (or `formats` option).",
|
204 | cache: "Map is used as cache, schema object as key.",
|
205 | serialize: "Map is used as cache, schema object as key.",
|
206 | ajvErrors: "It is default now.",
|
207 | }
|
208 |
|
209 | const deprecatedOptions: OptionsInfo<DeprecatedOptions> = {
|
210 | ignoreKeywordsWithRef: "",
|
211 | jsPropertySyntax: "",
|
212 | unicode: '"minLength"/"maxLength" account for unicode characters by default.',
|
213 | }
|
214 |
|
215 | type RequiredInstanceOptions = {
|
216 | [K in
|
217 | | "strictSchema"
|
218 | | "strictNumbers"
|
219 | | "strictTypes"
|
220 | | "strictTuples"
|
221 | | "strictRequired"
|
222 | | "inlineRefs"
|
223 | | "loopRequired"
|
224 | | "loopEnum"
|
225 | | "meta"
|
226 | | "messages"
|
227 | | "schemaId"
|
228 | | "addUsedSchema"
|
229 | | "validateSchema"
|
230 | | "validateFormats"
|
231 | | "int32range"
|
232 | | "unicodeRegExp"
|
233 | | "uriResolver"]: NonNullable<Options[K]>
|
234 | } & {code: InstanceCodeOptions}
|
235 |
|
236 | export type InstanceOptions = Options & RequiredInstanceOptions
|
237 |
|
238 | const MAX_EXPRESSION = 200
|
239 |
|
240 |
|
241 | function requiredOptions(o: Options): RequiredInstanceOptions {
|
242 | const s = o.strict
|
243 | const _optz = o.code?.optimize
|
244 | const optimize = _optz === true || _optz === undefined ? 1 : _optz || 0
|
245 | const regExp = o.code?.regExp ?? defaultRegExp
|
246 | const uriResolver = o.uriResolver ?? DefaultUriResolver
|
247 | return {
|
248 | strictSchema: o.strictSchema ?? s ?? true,
|
249 | strictNumbers: o.strictNumbers ?? s ?? true,
|
250 | strictTypes: o.strictTypes ?? s ?? "log",
|
251 | strictTuples: o.strictTuples ?? s ?? "log",
|
252 | strictRequired: o.strictRequired ?? s ?? false,
|
253 | code: o.code ? {...o.code, optimize, regExp} : {optimize, regExp},
|
254 | loopRequired: o.loopRequired ?? MAX_EXPRESSION,
|
255 | loopEnum: o.loopEnum ?? MAX_EXPRESSION,
|
256 | meta: o.meta ?? true,
|
257 | messages: o.messages ?? true,
|
258 | inlineRefs: o.inlineRefs ?? true,
|
259 | schemaId: o.schemaId ?? "$id",
|
260 | addUsedSchema: o.addUsedSchema ?? true,
|
261 | validateSchema: o.validateSchema ?? true,
|
262 | validateFormats: o.validateFormats ?? true,
|
263 | unicodeRegExp: o.unicodeRegExp ?? true,
|
264 | int32range: o.int32range ?? true,
|
265 | uriResolver: uriResolver,
|
266 | }
|
267 | }
|
268 |
|
269 | export interface Logger {
|
270 | log(...args: unknown[]): unknown
|
271 | warn(...args: unknown[]): unknown
|
272 | error(...args: unknown[]): unknown
|
273 | }
|
274 |
|
275 | export default class Ajv {
|
276 | opts: InstanceOptions
|
277 | errors?: ErrorObject[] | null
|
278 | logger: Logger
|
279 |
|
280 | readonly scope: ValueScope
|
281 | readonly schemas: {[Key in string]?: SchemaEnv} = {}
|
282 | readonly refs: {[Ref in string]?: SchemaEnv | string} = {}
|
283 | readonly formats: {[Name in string]?: AddedFormat} = {}
|
284 | readonly RULES: ValidationRules
|
285 | readonly _compilations: Set<SchemaEnv> = new Set()
|
286 | private readonly _loading: {[Ref in string]?: Promise<AnySchemaObject>} = {}
|
287 | private readonly _cache: Map<AnySchema, SchemaEnv> = new Map()
|
288 | private readonly _metaOpts: InstanceOptions
|
289 |
|
290 | static ValidationError = ValidationError
|
291 | static MissingRefError = MissingRefError
|
292 |
|
293 | constructor(opts: Options = {}) {
|
294 | opts = this.opts = {...opts, ...requiredOptions(opts)}
|
295 | const {es5, lines} = this.opts.code
|
296 |
|
297 | this.scope = new ValueScope({scope: {}, prefixes: EXT_SCOPE_NAMES, es5, lines})
|
298 | this.logger = getLogger(opts.logger)
|
299 | const formatOpt = opts.validateFormats
|
300 | opts.validateFormats = false
|
301 |
|
302 | this.RULES = getRules()
|
303 | checkOptions.call(this, removedOptions, opts, "NOT SUPPORTED")
|
304 | checkOptions.call(this, deprecatedOptions, opts, "DEPRECATED", "warn")
|
305 | this._metaOpts = getMetaSchemaOptions.call(this)
|
306 |
|
307 | if (opts.formats) addInitialFormats.call(this)
|
308 | this._addVocabularies()
|
309 | this._addDefaultMetaSchema()
|
310 | if (opts.keywords) addInitialKeywords.call(this, opts.keywords)
|
311 | if (typeof opts.meta == "object") this.addMetaSchema(opts.meta)
|
312 | addInitialSchemas.call(this)
|
313 | opts.validateFormats = formatOpt
|
314 | }
|
315 |
|
316 | _addVocabularies(): void {
|
317 | this.addKeyword("$async")
|
318 | }
|
319 |
|
320 | _addDefaultMetaSchema(): void {
|
321 | const {$data, meta, schemaId} = this.opts
|
322 | let _dataRefSchema: SchemaObject = $dataRefSchema
|
323 | if (schemaId === "id") {
|
324 | _dataRefSchema = {...$dataRefSchema}
|
325 | _dataRefSchema.id = _dataRefSchema.$id
|
326 | delete _dataRefSchema.$id
|
327 | }
|
328 | if (meta && $data) this.addMetaSchema(_dataRefSchema, _dataRefSchema[schemaId], false)
|
329 | }
|
330 |
|
331 | defaultMeta(): string | AnySchemaObject | undefined {
|
332 | const {meta, schemaId} = this.opts
|
333 | return (this.opts.defaultMeta = typeof meta == "object" ? meta[schemaId] || meta : undefined)
|
334 | }
|
335 |
|
336 |
|
337 |
|
338 | validate(schema: Schema | string, data: unknown): boolean
|
339 | validate(schemaKeyRef: AnySchema | string, data: unknown): boolean | Promise<unknown>
|
340 | validate<T>(schema: Schema | JSONSchemaType<T> | string, data: unknown): data is T
|
341 |
|
342 |
|
343 | validate<T>(schema: JTDSchemaType<T>, data: unknown): data is T
|
344 |
|
345 |
|
346 | validate<N extends never, T extends SomeJTDSchemaType>(
|
347 | schema: T,
|
348 | data: unknown
|
349 | ): data is JTDDataType<T>
|
350 | validate<T>(schema: AsyncSchema, data: unknown | T): Promise<T>
|
351 | validate<T>(schemaKeyRef: AnySchema | string, data: unknown): data is T | Promise<T>
|
352 | validate<T>(
|
353 | schemaKeyRef: AnySchema | string,
|
354 | data: unknown | T
|
355 | ): boolean | Promise<T> {
|
356 | let v: AnyValidateFunction | undefined
|
357 | if (typeof schemaKeyRef == "string") {
|
358 | v = this.getSchema<T>(schemaKeyRef)
|
359 | if (!v) throw new Error(`no schema with key or ref "${schemaKeyRef}"`)
|
360 | } else {
|
361 | v = this.compile<T>(schemaKeyRef)
|
362 | }
|
363 |
|
364 | const valid = v(data)
|
365 | if (!("$async" in v)) this.errors = v.errors
|
366 | return valid
|
367 | }
|
368 |
|
369 |
|
370 |
|
371 | compile<T = unknown>(schema: Schema | JSONSchemaType<T>, _meta?: boolean): ValidateFunction<T>
|
372 |
|
373 |
|
374 | compile<T = unknown>(schema: JTDSchemaType<T>, _meta?: boolean): ValidateFunction<T>
|
375 |
|
376 |
|
377 | compile<N extends never, T extends SomeJTDSchemaType>(
|
378 | schema: T,
|
379 | _meta?: boolean
|
380 | ): ValidateFunction<JTDDataType<T>>
|
381 | compile<T = unknown>(schema: AsyncSchema, _meta?: boolean): AsyncValidateFunction<T>
|
382 | compile<T = unknown>(schema: AnySchema, _meta?: boolean): AnyValidateFunction<T>
|
383 | compile<T = unknown>(schema: AnySchema, _meta?: boolean): AnyValidateFunction<T> {
|
384 | const sch = this._addSchema(schema, _meta)
|
385 | return (sch.validate || this._compileSchemaEnv(sch)) as AnyValidateFunction<T>
|
386 | }
|
387 |
|
388 |
|
389 |
|
390 |
|
391 |
|
392 | compileAsync<T = unknown>(
|
393 | schema: SchemaObject | JSONSchemaType<T>,
|
394 | _meta?: boolean
|
395 | ): Promise<ValidateFunction<T>>
|
396 |
|
397 |
|
398 | compileAsync<T = unknown>(schema: JTDSchemaType<T>, _meta?: boolean): Promise<ValidateFunction<T>>
|
399 | compileAsync<T = unknown>(schema: AsyncSchema, meta?: boolean): Promise<AsyncValidateFunction<T>>
|
400 |
|
401 | compileAsync<T = unknown>(
|
402 | schema: AnySchemaObject,
|
403 | meta?: boolean
|
404 | ): Promise<AnyValidateFunction<T>>
|
405 | compileAsync<T = unknown>(
|
406 | schema: AnySchemaObject,
|
407 | meta?: boolean
|
408 | ): Promise<AnyValidateFunction<T>> {
|
409 | if (typeof this.opts.loadSchema != "function") {
|
410 | throw new Error("options.loadSchema should be a function")
|
411 | }
|
412 | const {loadSchema} = this.opts
|
413 | return runCompileAsync.call(this, schema, meta)
|
414 |
|
415 | async function runCompileAsync(
|
416 | this: Ajv,
|
417 | _schema: AnySchemaObject,
|
418 | _meta?: boolean
|
419 | ): Promise<AnyValidateFunction> {
|
420 | await loadMetaSchema.call(this, _schema.$schema)
|
421 | const sch = this._addSchema(_schema, _meta)
|
422 | return sch.validate || _compileAsync.call(this, sch)
|
423 | }
|
424 |
|
425 | async function loadMetaSchema(this: Ajv, $ref?: string): Promise<void> {
|
426 | if ($ref && !this.getSchema($ref)) {
|
427 | await runCompileAsync.call(this, {$ref}, true)
|
428 | }
|
429 | }
|
430 |
|
431 | async function _compileAsync(this: Ajv, sch: SchemaEnv): Promise<AnyValidateFunction> {
|
432 | try {
|
433 | return this._compileSchemaEnv(sch)
|
434 | } catch (e) {
|
435 | if (!(e instanceof MissingRefError)) throw e
|
436 | checkLoaded.call(this, e)
|
437 | await loadMissingSchema.call(this, e.missingSchema)
|
438 | return _compileAsync.call(this, sch)
|
439 | }
|
440 | }
|
441 |
|
442 | function checkLoaded(this: Ajv, {missingSchema: ref, missingRef}: MissingRefError): void {
|
443 | if (this.refs[ref]) {
|
444 | throw new Error(`AnySchema ${ref} is loaded but ${missingRef} cannot be resolved`)
|
445 | }
|
446 | }
|
447 |
|
448 | async function loadMissingSchema(this: Ajv, ref: string): Promise<void> {
|
449 | const _schema = await _loadSchema.call(this, ref)
|
450 | if (!this.refs[ref]) await loadMetaSchema.call(this, _schema.$schema)
|
451 | if (!this.refs[ref]) this.addSchema(_schema, ref, meta)
|
452 | }
|
453 |
|
454 | async function _loadSchema(this: Ajv, ref: string): Promise<AnySchemaObject> {
|
455 | const p = this._loading[ref]
|
456 | if (p) return p
|
457 | try {
|
458 | return await (this._loading[ref] = loadSchema(ref))
|
459 | } finally {
|
460 | delete this._loading[ref]
|
461 | }
|
462 | }
|
463 | }
|
464 |
|
465 |
|
466 | addSchema(
|
467 | schema: AnySchema | AnySchema[],
|
468 | key?: string,
|
469 | _meta?: boolean,
|
470 | _validateSchema = this.opts.validateSchema
|
471 | ): Ajv {
|
472 | if (Array.isArray(schema)) {
|
473 | for (const sch of schema) this.addSchema(sch, undefined, _meta, _validateSchema)
|
474 | return this
|
475 | }
|
476 | let id: string | undefined
|
477 | if (typeof schema === "object") {
|
478 | const {schemaId} = this.opts
|
479 | id = schema[schemaId]
|
480 | if (id !== undefined && typeof id != "string") {
|
481 | throw new Error(`schema ${schemaId} must be string`)
|
482 | }
|
483 | }
|
484 | key = normalizeId(key || id)
|
485 | this._checkUnique(key)
|
486 | this.schemas[key] = this._addSchema(schema, _meta, key, _validateSchema, true)
|
487 | return this
|
488 | }
|
489 |
|
490 |
|
491 |
|
492 | addMetaSchema(
|
493 | schema: AnySchemaObject,
|
494 | key?: string,
|
495 | _validateSchema = this.opts.validateSchema
|
496 | ): Ajv {
|
497 | this.addSchema(schema, key, true, _validateSchema)
|
498 | return this
|
499 | }
|
500 |
|
501 |
|
502 | validateSchema(schema: AnySchema, throwOrLogError?: boolean): boolean | Promise<unknown> {
|
503 | if (typeof schema == "boolean") return true
|
504 | let $schema: string | AnySchemaObject | undefined
|
505 | $schema = schema.$schema
|
506 | if ($schema !== undefined && typeof $schema != "string") {
|
507 | throw new Error("$schema must be a string")
|
508 | }
|
509 | $schema = $schema || this.opts.defaultMeta || this.defaultMeta()
|
510 | if (!$schema) {
|
511 | this.logger.warn("meta-schema not available")
|
512 | this.errors = null
|
513 | return true
|
514 | }
|
515 | const valid = this.validate($schema, schema)
|
516 | if (!valid && throwOrLogError) {
|
517 | const message = "schema is invalid: " + this.errorsText()
|
518 | if (this.opts.validateSchema === "log") this.logger.error(message)
|
519 | else throw new Error(message)
|
520 | }
|
521 | return valid
|
522 | }
|
523 |
|
524 |
|
525 |
|
526 | getSchema<T = unknown>(keyRef: string): AnyValidateFunction<T> | undefined {
|
527 | let sch
|
528 | while (typeof (sch = getSchEnv.call(this, keyRef)) == "string") keyRef = sch
|
529 | if (sch === undefined) {
|
530 | const {schemaId} = this.opts
|
531 | const root = new SchemaEnv({schema: {}, schemaId})
|
532 | sch = resolveSchema.call(this, root, keyRef)
|
533 | if (!sch) return
|
534 | this.refs[keyRef] = sch
|
535 | }
|
536 | return (sch.validate || this._compileSchemaEnv(sch)) as AnyValidateFunction<T> | undefined
|
537 | }
|
538 |
|
539 |
|
540 |
|
541 |
|
542 |
|
543 | removeSchema(schemaKeyRef?: AnySchema | string | RegExp): Ajv {
|
544 | if (schemaKeyRef instanceof RegExp) {
|
545 | this._removeAllSchemas(this.schemas, schemaKeyRef)
|
546 | this._removeAllSchemas(this.refs, schemaKeyRef)
|
547 | return this
|
548 | }
|
549 | switch (typeof schemaKeyRef) {
|
550 | case "undefined":
|
551 | this._removeAllSchemas(this.schemas)
|
552 | this._removeAllSchemas(this.refs)
|
553 | this._cache.clear()
|
554 | return this
|
555 | case "string": {
|
556 | const sch = getSchEnv.call(this, schemaKeyRef)
|
557 | if (typeof sch == "object") this._cache.delete(sch.schema)
|
558 | delete this.schemas[schemaKeyRef]
|
559 | delete this.refs[schemaKeyRef]
|
560 | return this
|
561 | }
|
562 | case "object": {
|
563 | const cacheKey = schemaKeyRef
|
564 | this._cache.delete(cacheKey)
|
565 | let id = schemaKeyRef[this.opts.schemaId]
|
566 | if (id) {
|
567 | id = normalizeId(id)
|
568 | delete this.schemas[id]
|
569 | delete this.refs[id]
|
570 | }
|
571 | return this
|
572 | }
|
573 | default:
|
574 | throw new Error("ajv.removeSchema: invalid parameter")
|
575 | }
|
576 | }
|
577 |
|
578 |
|
579 | addVocabulary(definitions: Vocabulary): Ajv {
|
580 | for (const def of definitions) this.addKeyword(def)
|
581 | return this
|
582 | }
|
583 |
|
584 | addKeyword(
|
585 | kwdOrDef: string | KeywordDefinition,
|
586 | def?: KeywordDefinition
|
587 | ): Ajv {
|
588 | let keyword: string | string[]
|
589 | if (typeof kwdOrDef == "string") {
|
590 | keyword = kwdOrDef
|
591 | if (typeof def == "object") {
|
592 | this.logger.warn("these parameters are deprecated, see docs for addKeyword")
|
593 | def.keyword = keyword
|
594 | }
|
595 | } else if (typeof kwdOrDef == "object" && def === undefined) {
|
596 | def = kwdOrDef
|
597 | keyword = def.keyword
|
598 | if (Array.isArray(keyword) && !keyword.length) {
|
599 | throw new Error("addKeywords: keyword must be string or non-empty array")
|
600 | }
|
601 | } else {
|
602 | throw new Error("invalid addKeywords parameters")
|
603 | }
|
604 |
|
605 | checkKeyword.call(this, keyword, def)
|
606 | if (!def) {
|
607 | eachItem(keyword, (kwd) => addRule.call(this, kwd))
|
608 | return this
|
609 | }
|
610 | keywordMetaschema.call(this, def)
|
611 | const definition: AddedKeywordDefinition = {
|
612 | ...def,
|
613 | type: getJSONTypes(def.type),
|
614 | schemaType: getJSONTypes(def.schemaType),
|
615 | }
|
616 | eachItem(
|
617 | keyword,
|
618 | definition.type.length === 0
|
619 | ? (k) => addRule.call(this, k, definition)
|
620 | : (k) => definition.type.forEach((t) => addRule.call(this, k, definition, t))
|
621 | )
|
622 | return this
|
623 | }
|
624 |
|
625 | getKeyword(keyword: string): AddedKeywordDefinition | boolean {
|
626 | const rule = this.RULES.all[keyword]
|
627 | return typeof rule == "object" ? rule.definition : !!rule
|
628 | }
|
629 |
|
630 |
|
631 | removeKeyword(keyword: string): Ajv {
|
632 |
|
633 | const {RULES} = this
|
634 | delete RULES.keywords[keyword]
|
635 | delete RULES.all[keyword]
|
636 | for (const group of RULES.rules) {
|
637 | const i = group.rules.findIndex((rule) => rule.keyword === keyword)
|
638 | if (i >= 0) group.rules.splice(i, 1)
|
639 | }
|
640 | return this
|
641 | }
|
642 |
|
643 |
|
644 | addFormat(name: string, format: Format): Ajv {
|
645 | if (typeof format == "string") format = new RegExp(format)
|
646 | this.formats[name] = format
|
647 | return this
|
648 | }
|
649 |
|
650 | errorsText(
|
651 | errors: ErrorObject[] | null | undefined = this.errors,
|
652 | {separator = ", ", dataVar = "data"}: ErrorsTextOptions = {}
|
653 | ): string {
|
654 | if (!errors || errors.length === 0) return "No errors"
|
655 | return errors
|
656 | .map((e) => `${dataVar}${e.instancePath} ${e.message}`)
|
657 | .reduce((text, msg) => text + separator + msg)
|
658 | }
|
659 |
|
660 | $dataMetaSchema(metaSchema: AnySchemaObject, keywordsJsonPointers: string[]): AnySchemaObject {
|
661 | const rules = this.RULES.all
|
662 | metaSchema = JSON.parse(JSON.stringify(metaSchema))
|
663 | for (const jsonPointer of keywordsJsonPointers) {
|
664 | const segments = jsonPointer.split("/").slice(1)
|
665 | let keywords = metaSchema
|
666 | for (const seg of segments) keywords = keywords[seg] as AnySchemaObject
|
667 |
|
668 | for (const key in rules) {
|
669 | const rule = rules[key]
|
670 | if (typeof rule != "object") continue
|
671 | const {$data} = rule.definition
|
672 | const schema = keywords[key] as AnySchemaObject | undefined
|
673 | if ($data && schema) keywords[key] = schemaOrData(schema)
|
674 | }
|
675 | }
|
676 |
|
677 | return metaSchema
|
678 | }
|
679 |
|
680 | private _removeAllSchemas(schemas: {[Ref in string]?: SchemaEnv | string}, regex?: RegExp): void {
|
681 | for (const keyRef in schemas) {
|
682 | const sch = schemas[keyRef]
|
683 | if (!regex || regex.test(keyRef)) {
|
684 | if (typeof sch == "string") {
|
685 | delete schemas[keyRef]
|
686 | } else if (sch && !sch.meta) {
|
687 | this._cache.delete(sch.schema)
|
688 | delete schemas[keyRef]
|
689 | }
|
690 | }
|
691 | }
|
692 | }
|
693 |
|
694 | _addSchema(
|
695 | schema: AnySchema,
|
696 | meta?: boolean,
|
697 | baseId?: string,
|
698 | validateSchema = this.opts.validateSchema,
|
699 | addSchema = this.opts.addUsedSchema
|
700 | ): SchemaEnv {
|
701 | let id: string | undefined
|
702 | const {schemaId} = this.opts
|
703 | if (typeof schema == "object") {
|
704 | id = schema[schemaId]
|
705 | } else {
|
706 | if (this.opts.jtd) throw new Error("schema must be object")
|
707 | else if (typeof schema != "boolean") throw new Error("schema must be object or boolean")
|
708 | }
|
709 | let sch = this._cache.get(schema)
|
710 | if (sch !== undefined) return sch
|
711 |
|
712 | baseId = normalizeId(id || baseId)
|
713 | const localRefs = getSchemaRefs.call(this, schema, baseId)
|
714 | sch = new SchemaEnv({schema, schemaId, meta, baseId, localRefs})
|
715 | this._cache.set(sch.schema, sch)
|
716 | if (addSchema && !baseId.startsWith("#")) {
|
717 |
|
718 | if (baseId) this._checkUnique(baseId)
|
719 | this.refs[baseId] = sch
|
720 | }
|
721 | if (validateSchema) this.validateSchema(schema, true)
|
722 | return sch
|
723 | }
|
724 |
|
725 | private _checkUnique(id: string): void {
|
726 | if (this.schemas[id] || this.refs[id]) {
|
727 | throw new Error(`schema with key or id "${id}" already exists`)
|
728 | }
|
729 | }
|
730 |
|
731 | private _compileSchemaEnv(sch: SchemaEnv): AnyValidateFunction {
|
732 | if (sch.meta) this._compileMetaSchema(sch)
|
733 | else compileSchema.call(this, sch)
|
734 |
|
735 |
|
736 | if (!sch.validate) throw new Error("ajv implementation error")
|
737 | return sch.validate
|
738 | }
|
739 |
|
740 | private _compileMetaSchema(sch: SchemaEnv): void {
|
741 | const currentOpts = this.opts
|
742 | this.opts = this._metaOpts
|
743 | try {
|
744 | compileSchema.call(this, sch)
|
745 | } finally {
|
746 | this.opts = currentOpts
|
747 | }
|
748 | }
|
749 | }
|
750 |
|
751 | export interface ErrorsTextOptions {
|
752 | separator?: string
|
753 | dataVar?: string
|
754 | }
|
755 |
|
756 | function checkOptions(
|
757 | this: Ajv,
|
758 | checkOpts: OptionsInfo<RemovedOptions | DeprecatedOptions>,
|
759 | options: Options & RemovedOptions,
|
760 | msg: string,
|
761 | log: "warn" | "error" = "error"
|
762 | ): void {
|
763 | for (const key in checkOpts) {
|
764 | const opt = key as keyof typeof checkOpts
|
765 | if (opt in options) this.logger[log](`${msg}: option ${key}. ${checkOpts[opt]}`)
|
766 | }
|
767 | }
|
768 |
|
769 | function getSchEnv(this: Ajv, keyRef: string): SchemaEnv | string | undefined {
|
770 | keyRef = normalizeId(keyRef)
|
771 | return this.schemas[keyRef] || this.refs[keyRef]
|
772 | }
|
773 |
|
774 | function addInitialSchemas(this: Ajv): void {
|
775 | const optsSchemas = this.opts.schemas
|
776 | if (!optsSchemas) return
|
777 | if (Array.isArray(optsSchemas)) this.addSchema(optsSchemas)
|
778 | else for (const key in optsSchemas) this.addSchema(optsSchemas[key] as AnySchema, key)
|
779 | }
|
780 |
|
781 | function addInitialFormats(this: Ajv): void {
|
782 | for (const name in this.opts.formats) {
|
783 | const format = this.opts.formats[name]
|
784 | if (format) this.addFormat(name, format)
|
785 | }
|
786 | }
|
787 |
|
788 | function addInitialKeywords(
|
789 | this: Ajv,
|
790 | defs: Vocabulary | {[K in string]?: KeywordDefinition}
|
791 | ): void {
|
792 | if (Array.isArray(defs)) {
|
793 | this.addVocabulary(defs)
|
794 | return
|
795 | }
|
796 | this.logger.warn("keywords option as map is deprecated, pass array")
|
797 | for (const keyword in defs) {
|
798 | const def = defs[keyword] as KeywordDefinition
|
799 | if (!def.keyword) def.keyword = keyword
|
800 | this.addKeyword(def)
|
801 | }
|
802 | }
|
803 |
|
804 | function getMetaSchemaOptions(this: Ajv): InstanceOptions {
|
805 | const metaOpts = {...this.opts}
|
806 | for (const opt of META_IGNORE_OPTIONS) delete metaOpts[opt]
|
807 | return metaOpts
|
808 | }
|
809 |
|
810 | const noLogs = {log() {}, warn() {}, error() {}}
|
811 |
|
812 | function getLogger(logger?: Partial<Logger> | false): Logger {
|
813 | if (logger === false) return noLogs
|
814 | if (logger === undefined) return console
|
815 | if (logger.log && logger.warn && logger.error) return logger as Logger
|
816 | throw new Error("logger must implement log, warn and error methods")
|
817 | }
|
818 |
|
819 | const KEYWORD_NAME = /^[a-z_$][a-z0-9_$:-]*$/i
|
820 |
|
821 | function checkKeyword(this: Ajv, keyword: string | string[], def?: KeywordDefinition): void {
|
822 | const {RULES} = this
|
823 | eachItem(keyword, (kwd) => {
|
824 | if (RULES.keywords[kwd]) throw new Error(`Keyword ${kwd} is already defined`)
|
825 | if (!KEYWORD_NAME.test(kwd)) throw new Error(`Keyword ${kwd} has invalid name`)
|
826 | })
|
827 | if (!def) return
|
828 | if (def.$data && !("code" in def || "validate" in def)) {
|
829 | throw new Error('$data keyword must have "code" or "validate" function')
|
830 | }
|
831 | }
|
832 |
|
833 | function addRule(
|
834 | this: Ajv,
|
835 | keyword: string,
|
836 | definition?: AddedKeywordDefinition,
|
837 | dataType?: JSONType
|
838 | ): void {
|
839 | const post = definition?.post
|
840 | if (dataType && post) throw new Error('keyword with "post" flag cannot have "type"')
|
841 | const {RULES} = this
|
842 | let ruleGroup = post ? RULES.post : RULES.rules.find(({type: t}) => t === dataType)
|
843 | if (!ruleGroup) {
|
844 | ruleGroup = {type: dataType, rules: []}
|
845 | RULES.rules.push(ruleGroup)
|
846 | }
|
847 | RULES.keywords[keyword] = true
|
848 | if (!definition) return
|
849 |
|
850 | const rule: Rule = {
|
851 | keyword,
|
852 | definition: {
|
853 | ...definition,
|
854 | type: getJSONTypes(definition.type),
|
855 | schemaType: getJSONTypes(definition.schemaType),
|
856 | },
|
857 | }
|
858 | if (definition.before) addBeforeRule.call(this, ruleGroup, rule, definition.before)
|
859 | else ruleGroup.rules.push(rule)
|
860 | RULES.all[keyword] = rule
|
861 | definition.implements?.forEach((kwd) => this.addKeyword(kwd))
|
862 | }
|
863 |
|
864 | function addBeforeRule(this: Ajv, ruleGroup: RuleGroup, rule: Rule, before: string): void {
|
865 | const i = ruleGroup.rules.findIndex((_rule) => _rule.keyword === before)
|
866 | if (i >= 0) {
|
867 | ruleGroup.rules.splice(i, 0, rule)
|
868 | } else {
|
869 | ruleGroup.rules.push(rule)
|
870 | this.logger.warn(`rule ${before} is not defined`)
|
871 | }
|
872 | }
|
873 |
|
874 | function keywordMetaschema(this: Ajv, def: KeywordDefinition): void {
|
875 | let {metaSchema} = def
|
876 | if (metaSchema === undefined) return
|
877 | if (def.$data && this.opts.$data) metaSchema = schemaOrData(metaSchema)
|
878 | def.validateSchema = this.compile(metaSchema, true)
|
879 | }
|
880 |
|
881 | const $dataRef = {
|
882 | $ref: "https://raw.githubusercontent.com/ajv-validator/ajv/master/lib/refs/data.json#",
|
883 | }
|
884 |
|
885 | function schemaOrData(schema: AnySchema): AnySchemaObject {
|
886 | return {anyOf: [schema, $dataRef]}
|
887 | }
|