ASC FDL Checker (fdl-checker)

Validate ASC Framing Decision List (FDL) files against the official JSON‑Schema – from the command line or programmatically.

✨ Features

• Schema‑level validation with [Ajv 8] – fast, standards‑compliant.
• Logical cross‑checks (duplicate IDs, broken references, etc.) that JSON‑Schema alone can’t express.
• Version‑aware: validates each file against the exact schema that matches version.major/minor.
• Human‑friendly errors – shows the failing value, expected constants / patterns, and logical‑tree messages.
• Both CLI & API in pure ES‑modules; zero runtime dependencies beyond Ajv.

## Install

# Local project usage
npm install --save-dev fdl-checker

# Global CLI (optional)
npm install --global fdl-checker

## CLI usage

fdl-checker <file.fdl> [more‑files...]

# exit‑code = total number of errors

Example

$ fdl-checker tests/invalid_v1.0.fdl
===== Validating 'tests/invalid_v1.0.fdl' =====
/contexts/0/canvases/0/id: string "e9709e42‑…" length must not exceed 32 characters
/contexts/0/canvases/0/id: value "e9709e42‑…" must match pattern ^[A-Za-z0-9_]+$
ID Tree Error: Context (DXL2) > Canvas e9709e42‑… > Framing Decision 2‑1Framing: Framing Intent ID 2‑1Framing not in framing_intents

## Programmatic API

import { validateFdlObject } from 'fdl-checker';

// A valid FDL converted to a javascript object
const fdlObject = {};

const {version, errors} = validateFdlObject(fdlObject, { verbose: false });;
if (errors?.length) {
  console.error(`Failed validation for FDL version ${version.major}.${version.minor} with ${errors.length} validation errors`);
  process.exit(1);
}