@apislash/validation

OpenAPI-driven request and form validation for any TypeScript project. Validate request payloads and individual form fields against any OpenAPI 3 schema — framework-agnostic, with schema loading, caching, and structured errors.

Generic and usable in any app; published and maintained by Apislash (offered to customers under the Apislash brand). MIT licensed.

Install

npm install @apislash/validation

Usage

import { createOpenApiValidator, ValidationError } from "@apislash/validation";

const validator = createOpenApiValidator(openApiDocument);

try {
  validator.validateRequest("POST", "/users", { body: { email: "[email protected]" } });
} catch (e) {
  if (e instanceof ValidationError) {
    console.error(e.details); // structured field errors
  }
}

Load a schema straight from a URL with createOpenApiValidatorFromUrl(url), validate a single field with validateFieldValue(...), or use the OpenApiValidator class directly.

Features

• Validates against any OpenAPI 3 document — no framework or Apislash coupling.
• Schema loading with caching (SchemaCacheStore, pluggable KvDriverLike) and immutable snapshots.
• Field-level validation for forms (validateFieldValue).
• Structured ValidationError (use isValidationError to narrow).

License

MIT © Apislash