SchemaUtils | SignalWire

SchemaUtils validates SWML documents against structural rules and provides schema-driven verb extraction and validation. Results are cached with an LRU-style eviction policy. Set SWML_SKIP_SCHEMA_VALIDATION=true to disable validation globally.

import { SchemaUtils } from '@signalwire/sdk';
const schema = new SchemaUtils();
const result = schema.validate(swmlDocument);
console.log(result.valid, result.errors);

Constructor

opts

object

Optional constructor configuration.

opts.skipValidation

boolean

Skip all validation checks. When omitted, defaults to true if the SWML_SKIP_SCHEMA_VALIDATION environment variable is "true", otherwise false.

opts.maxCacheSize

numberDefaults to 100

Maximum number of cached validation results before LRU eviction.

opts.schemaPath

string

Path to a custom JSON Schema file. When omitted, the bundled schema.json is used. Mirrors the Python SDK’s schema_path parameter. A load failure falls back to the bundled schema silently.

Methods

getVerbNames

Get all verb names defined in the SWML schema.

getVerbProperties

Get the inner properties schema for a specific verb.

getVerbRequiredProperties

Get the required properties for a verb.

getVerbDescription

Get the description text for a verb.

hasVerb

Check if a verb name exists in the schema.

validateVerb

Lightweight validation of a verb config against the schema.

validate

Validate a SWML document against structural rules.

clearCache

Clear the validation result cache.

getCacheSize

Get the number of cached validation results.

Example

import { SchemaUtils } from '@signalwire/sdk';
const schema = new SchemaUtils();
// Validate a SWML document
const result = schema.validate({
  version: '1.0.0',
  sections: { main: [{ answer: {} }, { hangup: {} }] },
});
console.log(result.valid);  // true
console.log(result.errors); // []