@mitre/hdf-validators 3.0.0 → 3.1.0-rc.1

package/LICENSE.md

@@ -0,0 +1,55 @@
+# License
+
+Copyright © 2025 The MITRE Corporation.
+
+Approved for Public Release; Distribution Unlimited. Case Number 18-3678.
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may
+not use this file except in compliance with the License. You may obtain a
+copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations
+under the License.
+
+## Redistribution Terms
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+- Redistributions of source code must retain the above copyright/digital
+  rights legend, this list of conditions and the following Notice.
+- Redistributions in binary form must reproduce the above
+  copyright/digital rights legend, this list of conditions and the
+  following Notice in the documentation and/or other materials provided
+  with the distribution.
+- Neither the name of The MITRE Corporation nor the names of its contributors
+  may be used to endorse or promote products derived from this software
+  without specific prior written permission.
+
+## Notice
+
+The MITRE Corporation grants permission to reproduce, distribute, modify, and
+otherwise use this software to the extent permitted by the licensed terms
+provided in the LICENSE file included with this project.
+
+This software was produced by The MITRE Corporation for the U.S. Government
+under contract. As such the U.S. Government has certain use and data
+rights in this software. No use other than those granted to the U.S.
+Government, or to those acting on behalf of the U.S. Government, under
+these contract arrangements is authorized without the express written
+permission of The MITRE Corporation.
+
+Some files in this codebase were generated by generative AI, under the
+direction and review of The MITRE Corporation employees, for the purpose of
+development efficiency. All AI-generated code functionality was validated
+by standard quality and assurance testing.
+
+For further information, please contact The MITRE Corporation,
+Contracts Management Office, 7515 Colshire Drive, McLean, VA 22102-7539,
+(703) 983-6000.

package/README.md

@@ -1,12 +1,12 @@
 # @mitre/hdf-validators
 
-JSON Schema validation for Heimdall Data Format (HDF) documents. Validates HDF Results and Baselines against the official HDF schemas to ensure structural correctness and data integrity.
+JSON Schema validation for Heimdall Data Format (HDF) documents. Validates all 7 HDF document types against their official schemas to ensure structural correctness and data integrity.
 
 ## Scope and Responsibilities
 
 **hdf-validators** provides schema-based validation:
-- Validate HDF Results documents against the HDF Results schema
-- Validate HDF Baseline documents against the HDF Baseline schema
+- Validate all HDF document types: Results, Baseline, System, Plan, Amendments, Evidence Package, Comparison
+- Auto-detect document type via the generic `validate()` function
 - Detailed error reporting with field-level validation messages
 - Support for both TypeScript and Go implementations
 
@@ -114,7 +114,7 @@ import (
 	"fmt"
 	"os"
 
-	validators "github.com/mitre/hdf-validators/go"
+	validators "github.com/mitre/hdf-libs/hdf-validators/go"
 )
 
 func main() {
@@ -174,6 +174,46 @@ Validate data against the HDF Baseline schema.
   - `data` - JavaScript object to validate
 - **Returns:** `ValidationResult` with validation status and errors
 
+#### `validateComparison(data: unknown): ValidationResult`
+
+Validate data against the HDF Comparison schema.
+
+- **Parameters:**
+  - `data` - JavaScript object to validate
+- **Returns:** `ValidationResult` with validation status and errors
+
+#### `validateSystem(data: unknown): ValidationResult`
+
+Validate data against the HDF System schema.
+
+- **Parameters:**
+  - `data` - JavaScript object to validate
+- **Returns:** `ValidationResult` with validation status and errors
+
+#### `validatePlan(data: unknown): ValidationResult`
+
+Validate data against the HDF Plan schema.
+
+- **Parameters:**
+  - `data` - JavaScript object to validate
+- **Returns:** `ValidationResult` with validation status and errors
+
+#### `validateAmendments(data: unknown): ValidationResult`
+
+Validate data against the HDF Amendments schema.
+
+- **Parameters:**
+  - `data` - JavaScript object to validate
+- **Returns:** `ValidationResult` with validation status and errors
+
+#### `validateEvidencePackage(data: unknown): ValidationResult`
+
+Validate data against the HDF Evidence Package schema.
+
+- **Parameters:**
+  - `data` - JavaScript object to validate
+- **Returns:** `ValidationResult` with validation status and errors
+
 #### `validate(data: unknown): ValidationResult`
 
 Auto-detect document type and validate.
@@ -288,7 +328,7 @@ The `name` field is required for each baseline.
 results[0].status: must be equal to one of the allowed values
 ```
 
-Result status must be one of: `passed`, `failed`, `error`, `skipped`, `not_applicable`, `not_reviewed`.
+Result status must be one of: `passed`, `failed`, `error`, `notApplicable`, `notReviewed`.
 
 ### Invalid Numeric Ranges
 

package/dist/index.d.ts

@@ -1,49 +1,52 @@
+//#region typescript/index.d.ts
 /**
  * Validation error details
  */
-export interface ValidationError {
-    field: string;
-    message: string;
-    value?: unknown;
+interface ValidationError {
+  field: string;
+  message: string;
+  value?: unknown;
 }
 /**
  * Result of schema validation
  */
-export interface ValidationResult {
-    valid: boolean;
-    errors: ValidationError[];
-    getErrorMessage(): string;
+interface ValidationResult {
+  valid: boolean;
+  errors: ValidationError[];
+  getErrorMessage(): string;
 }
 /**
  * Validate HDF Results document against schema
  */
-export declare function validateResults(data: unknown): ValidationResult;
+declare function validateResults(data: unknown): ValidationResult;
 /**
  * Validate HDF Baseline document against schema
  */
-export declare function validateBaseline(data: unknown): ValidationResult;
+declare function validateBaseline(data: unknown): ValidationResult;
 /**
  * Validate HDF Comparison document against schema
  */
-export declare function validateComparison(data: unknown): ValidationResult;
+declare function validateComparison(data: unknown): ValidationResult;
 /**
  * Validate HDF System document against schema
  */
-export declare function validateSystem(data: unknown): ValidationResult;
+declare function validateSystem(data: unknown): ValidationResult;
 /**
  * Validate HDF Plan document against schema
  */
-export declare function validatePlan(data: unknown): ValidationResult;
+declare function validatePlan(data: unknown): ValidationResult;
 /**
  * Validate HDF Amendments document against schema
  */
-export declare function validateAmendments(data: unknown): ValidationResult;
+declare function validateAmendments(data: unknown): ValidationResult;
 /**
  * Validate HDF Evidence Package document against schema
  */
-export declare function validateEvidencePackage(data: unknown): ValidationResult;
+declare function validateEvidencePackage(data: unknown): ValidationResult;
 /**
  * Validate HDF document (auto-detect type based on structure)
  */
-export declare function validate(data: unknown): ValidationResult;
+declare function validate(data: unknown): ValidationResult;
+//#endregion
+export { ValidationError, ValidationResult, validate, validateAmendments, validateBaseline, validateComparison, validateEvidencePackage, validatePlan, validateResults, validateSystem };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typescript/index.ts"],"names":[],"mappings":"AA0BA;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,eAAe,IAAI,MAAM,CAAC;CAC3B;AAuKD;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAG/D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAGhE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAGlE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAG9D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAG5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAGlE;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAGvE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,gBAAgB,CAoDxD"}
+{"version":3,"file":"index.d.ts","names":[],"sources":["../typescript/index.ts"],"mappings":";;AAkCA;;UAAiB,eAAA;EACf,KAAA;EACA,OAAA;EACA,KAAA;AAAA;;;AAMF;UAAiB,gBAAA;EACf,KAAA;EACA,MAAA,EAAQ,eAAA;EACR,eAAA;AAAA;;;;iBAuLc,eAAA,CAAgB,IAAA,YAAgB,gBAAA;AAAhD;;;AAAA,iBAQgB,gBAAA,CAAiB,IAAA,YAAgB,gBAAA;;AAAjD;;iBAQgB,kBAAA,CAAmB,IAAA,YAAgB,gBAAA;;;AAAnD;iBAQgB,cAAA,CAAe,IAAA,YAAgB,gBAAA;;;;iBAQ/B,YAAA,CAAa,IAAA,YAAgB,gBAAA;;;;iBAQ7B,kBAAA,CAAmB,IAAA,YAAgB,gBAAA;AARnD;;;AAAA,iBAgBgB,uBAAA,CAAwB,IAAA,YAAgB,gBAAA;;AARxD;;iBAgBgB,QAAA,CAAS,IAAA,YAAgB,gBAAA"}

package/dist/index.js

@@ -1,60 +1,43 @@
-import Ajv from 'ajv';
-import addFormats from 'ajv-formats';
-// Import all schemas (bare JSON imports — bundled by Vite via noExternal config)
-import hdfResultsSchema from '@mitre/hdf-schema/schemas/hdf-results.schema.json';
-import hdfBaselineSchema from '@mitre/hdf-schema/schemas/hdf-baseline.schema.json';
-import hdfComparisonSchema from '@mitre/hdf-schema/schemas/hdf-comparison.schema.json';
-import hdfSystemSchema from '@mitre/hdf-schema/schemas/hdf-system.schema.json';
-import hdfPlanSchema from '@mitre/hdf-schema/schemas/hdf-plan.schema.json';
-import hdfAmendmentsSchema from '@mitre/hdf-schema/schemas/hdf-amendments.schema.json';
-import hdfEvidencePackageSchema from '@mitre/hdf-schema/schemas/hdf-evidence-package.schema.json';
-import commonSchema from '@mitre/hdf-schema/schemas/primitives/common.schema.json';
-import extensionsSchema from '@mitre/hdf-schema/schemas/primitives/extensions.schema.json';
-import platformSchema from '@mitre/hdf-schema/schemas/primitives/platform.schema.json';
-import resultSchema from '@mitre/hdf-schema/schemas/primitives/result.schema.json';
-import runnerSchema from '@mitre/hdf-schema/schemas/primitives/runner.schema.json';
-import statisticsSchema from '@mitre/hdf-schema/schemas/primitives/statistics.schema.json';
-import targetSchema from '@mitre/hdf-schema/schemas/primitives/target.schema.json';
-import parameterSchema from '@mitre/hdf-schema/schemas/primitives/parameter.schema.json';
-import systemSchema from '@mitre/hdf-schema/schemas/primitives/system.schema.json';
-import planSchema from '@mitre/hdf-schema/schemas/primitives/plan.schema.json';
-import amendmentsSchema from '@mitre/hdf-schema/schemas/primitives/amendments.schema.json';
-import comparisonSchema from '@mitre/hdf-schema/schemas/primitives/comparison.schema.json';
-import componentSchema from '@mitre/hdf-schema/schemas/primitives/component.schema.json';
-import dataFlowSchema from '@mitre/hdf-schema/schemas/primitives/data-flow.schema.json';
+import Ajv from "ajv";
+import addFormats from "ajv-formats";
+import { amendmentsSchema, commonSchema, comparisonSchema, componentSchema, dataFlowSchema, extensionsSchema, hdfAmendmentsSchema, hdfBaselineSchema, hdfComparisonSchema, hdfEvidencePackageSchema, hdfPlanSchema, hdfResultsSchema, hdfSystemSchema, parameterSchema, planSchema, platformSchema, resultSchema, runnerSchema, statisticsSchema, systemSchema, targetSchema } from "@mitre/hdf-schema";
+//#region typescript/index.ts
 /**
- * Create and configure Ajv instance with all HDF schemas
- */
+* Create and configure Ajv instance with all HDF schemas
+*/
 function createValidator() {
-    const ajv = new Ajv({
-        allErrors: true,
-        verbose: true,
-        strict: false,
-        validateFormats: true,
-        validateSchema: false // Skip meta-schema validation for performance
-    });
-    // Add format validators (date-time, uri, etc.)
-    addFormats(ajv);
-    // Add all primitive schemas so they can be referenced
-    ajv.addSchema(commonSchema);
-    ajv.addSchema(platformSchema);
-    ajv.addSchema(resultSchema);
-    ajv.addSchema(runnerSchema);
-    ajv.addSchema(statisticsSchema);
-    ajv.addSchema(targetSchema);
-    ajv.addSchema(parameterSchema);
-    ajv.addSchema(amendmentsSchema); // before extensions (extensions $refs amendments Override_Type)
-    ajv.addSchema(extensionsSchema);
-    ajv.addSchema(systemSchema);
-    ajv.addSchema(planSchema);
-    ajv.addSchema(comparisonSchema);
-    ajv.addSchema(componentSchema);
-    ajv.addSchema(dataFlowSchema);
-    return ajv;
+	const ajv = new Ajv({
+		allErrors: true,
+		verbose: true,
+		strict: false,
+		validateFormats: true,
+		validateSchema: false
+	});
+	addFormats(ajv);
+	ajv.addSchema(commonSchema);
+	ajv.addSchema(platformSchema);
+	ajv.addSchema(resultSchema);
+	ajv.addSchema(runnerSchema);
+	ajv.addSchema(statisticsSchema);
+	ajv.addSchema(targetSchema);
+	ajv.addSchema(parameterSchema);
+	ajv.addSchema(amendmentsSchema);
+	ajv.addSchema(extensionsSchema);
+	ajv.addSchema(systemSchema);
+	ajv.addSchema(planSchema);
+	ajv.addSchema(comparisonSchema);
+	ajv.addSchema(componentSchema);
+	ajv.addSchema(dataFlowSchema);
+	ajv.addSchema(hdfResultsSchema);
+	ajv.addSchema(hdfBaselineSchema);
+	ajv.addSchema(hdfComparisonSchema);
+	ajv.addSchema(hdfSystemSchema);
+	ajv.addSchema(hdfPlanSchema);
+	ajv.addSchema(hdfAmendmentsSchema);
+	ajv.addSchema(hdfEvidencePackageSchema);
+	return ajv;
 }
-// Singleton Ajv instance
 const ajv = createValidator();
-// Compile schemas once (lazy initialization)
 let resultsValidator = null;
 let baselineValidator = null;
 let comparisonValidator = null;
@@ -63,204 +46,142 @@ let planValidator = null;
 let amendmentsValidator = null;
 let evidencePackageValidator = null;
 function getResultsValidator() {
-    if (!resultsValidator) {
-        resultsValidator = ajv.compile(hdfResultsSchema);
-    }
-    return resultsValidator;
+	if (!resultsValidator) resultsValidator = ajv.compile(hdfResultsSchema);
+	return resultsValidator;
 }
 function getBaselineValidator() {
-    if (!baselineValidator) {
-        baselineValidator = ajv.compile(hdfBaselineSchema);
-    }
-    return baselineValidator;
+	if (!baselineValidator) baselineValidator = ajv.compile(hdfBaselineSchema);
+	return baselineValidator;
 }
 function getComparisonValidator() {
-    if (!comparisonValidator) {
-        comparisonValidator = ajv.compile(hdfComparisonSchema);
-    }
-    return comparisonValidator;
+	if (!comparisonValidator) comparisonValidator = ajv.compile(hdfComparisonSchema);
+	return comparisonValidator;
 }
 function getSystemValidator() {
-    if (!systemValidator) {
-        systemValidator = ajv.compile(hdfSystemSchema);
-    }
-    return systemValidator;
+	if (!systemValidator) systemValidator = ajv.compile(hdfSystemSchema);
+	return systemValidator;
 }
 function getPlanValidator() {
-    if (!planValidator) {
-        planValidator = ajv.compile(hdfPlanSchema);
-    }
-    return planValidator;
+	if (!planValidator) planValidator = ajv.compile(hdfPlanSchema);
+	return planValidator;
 }
 function getAmendmentsValidator() {
-    if (!amendmentsValidator) {
-        amendmentsValidator = ajv.compile(hdfAmendmentsSchema);
-    }
-    return amendmentsValidator;
+	if (!amendmentsValidator) amendmentsValidator = ajv.compile(hdfAmendmentsSchema);
+	return amendmentsValidator;
 }
 function getEvidencePackageValidator() {
-    if (!evidencePackageValidator) {
-        evidencePackageValidator = ajv.compile(hdfEvidencePackageSchema);
-    }
-    return evidencePackageValidator;
+	if (!evidencePackageValidator) evidencePackageValidator = ajv.compile(hdfEvidencePackageSchema);
+	return evidencePackageValidator;
 }
 /**
- * Convert Ajv errors to ValidationError format
- */
+* Convert Ajv errors to ValidationError format
+*/
 function formatErrors(errors) {
-    if (!errors || errors.length === 0) {
-        return [];
-    }
-    return errors.map(err => {
-        // Clean up field path (remove leading slash, use dot notation)
-        let field = err.instancePath
-            .replace(/^\//, '')
-            .replace(/\//g, '.');
-        // If field is empty, use the data path from the error
-        if (!field && err.schemaPath) {
-            const pathParts = err.schemaPath.split('/');
-            field = pathParts[pathParts.length - 1] || '(root)';
-        }
-        // Build message
-        let message = err.message || 'validation failed';
-        if (err.params) {
-            // Add parameter info for more context
-            if ('missingProperty' in err.params) {
-                field = field ? `${field}.${err.params.missingProperty}` : err.params.missingProperty;
-                message = 'is required';
-            }
-            else if ('additionalProperty' in err.params) {
-                field = field ? `${field}.${err.params.additionalProperty}` : err.params.additionalProperty;
-                message = 'is not allowed';
-            }
-            else if ('limit' in err.params) {
-                message = `${message} (limit: ${err.params.limit})`;
-            }
-        }
-        return {
-            field: field || '(root)',
-            message,
-            value: err.data
-        };
-    });
+	if (!errors || errors.length === 0) return [];
+	return errors.map((err) => {
+		let field = err.instancePath.replace(/^\//, "").replace(/\//g, ".");
+		if (!field && err.schemaPath) {
+			const pathParts = err.schemaPath.split("/");
+			field = pathParts[pathParts.length - 1] || "(root)";
+		}
+		let message = err.message || "validation failed";
+		if (err.params) {
+			if ("missingProperty" in err.params) {
+				field = field ? `${field}.${err.params.missingProperty}` : err.params.missingProperty;
+				message = "is required";
+			} else if ("additionalProperty" in err.params) {
+				field = field ? `${field}.${err.params.additionalProperty}` : err.params.additionalProperty;
+				message = "is not allowed";
+			} else if ("limit" in err.params) message = `${message} (limit: ${err.params.limit})`;
+		}
+		return {
+			field: field || "(root)",
+			message,
+			value: err.data
+		};
+	});
 }
 /**
- * Create ValidationResult from validator output
- */
+* Create ValidationResult from validator output
+*/
 function createResult(validator, data) {
-    const valid = validator(data);
-    const errors = formatErrors(validator.errors);
-    return {
-        valid: valid === true,
-        errors,
-        getErrorMessage() {
-            if (this.valid) {
-                return '';
-            }
-            return this.errors
-                .map(e => {
-                if (e.field === '(root)') {
-                    return e.message;
-                }
-                return `${e.field}: ${e.message}`;
-            })
-                .join('; ');
-        }
-    };
+	const valid = validator(data);
+	const errors = formatErrors(validator.errors);
+	return {
+		valid: valid === true,
+		errors,
+		getErrorMessage() {
+			if (this.valid) return "";
+			return this.errors.map((e) => {
+				if (e.field === "(root)") return e.message;
+				return `${e.field}: ${e.message}`;
+			}).join("; ");
+		}
+	};
 }
 /**
- * Validate HDF Results document against schema
- */
-export function validateResults(data) {
-    const validator = getResultsValidator();
-    return createResult(validator, data);
+* Validate HDF Results document against schema
+*/
+function validateResults(data) {
+	return createResult(getResultsValidator(), data);
 }
 /**
- * Validate HDF Baseline document against schema
- */
-export function validateBaseline(data) {
-    const validator = getBaselineValidator();
-    return createResult(validator, data);
+* Validate HDF Baseline document against schema
+*/
+function validateBaseline(data) {
+	return createResult(getBaselineValidator(), data);
 }
 /**
- * Validate HDF Comparison document against schema
- */
-export function validateComparison(data) {
-    const validator = getComparisonValidator();
-    return createResult(validator, data);
+* Validate HDF Comparison document against schema
+*/
+function validateComparison(data) {
+	return createResult(getComparisonValidator(), data);
 }
 /**
- * Validate HDF System document against schema
- */
-export function validateSystem(data) {
-    const validator = getSystemValidator();
-    return createResult(validator, data);
+* Validate HDF System document against schema
+*/
+function validateSystem(data) {
+	return createResult(getSystemValidator(), data);
 }
 /**
- * Validate HDF Plan document against schema
- */
-export function validatePlan(data) {
-    const validator = getPlanValidator();
-    return createResult(validator, data);
+* Validate HDF Plan document against schema
+*/
+function validatePlan(data) {
+	return createResult(getPlanValidator(), data);
 }
 /**
- * Validate HDF Amendments document against schema
- */
-export function validateAmendments(data) {
-    const validator = getAmendmentsValidator();
-    return createResult(validator, data);
+* Validate HDF Amendments document against schema
+*/
+function validateAmendments(data) {
+	return createResult(getAmendmentsValidator(), data);
 }
 /**
- * Validate HDF Evidence Package document against schema
- */
-export function validateEvidencePackage(data) {
-    const validator = getEvidencePackageValidator();
-    return createResult(validator, data);
+* Validate HDF Evidence Package document against schema
+*/
+function validateEvidencePackage(data) {
+	return createResult(getEvidencePackageValidator(), data);
 }
 /**
- * Validate HDF document (auto-detect type based on structure)
- */
-export function validate(data) {
-    if (typeof data === 'object' && data !== null) {
-        const obj = data;
-        // HDF Results has 'baselines' array at root
-        if ('baselines' in obj) {
-            return validateResults(data);
-        }
-        // HDF Baseline has 'name' and 'requirements' at root
-        if ('name' in obj && 'requirements' in obj) {
-            return validateBaseline(data);
-        }
-        // HDF System has 'name' and 'components' at root
-        if ('name' in obj && 'components' in obj) {
-            return validateSystem(data);
-        }
-        // HDF Plan has 'name' and 'assessments' at root
-        if ('name' in obj && 'assessments' in obj) {
-            return validatePlan(data);
-        }
-        // HDF Amendments has 'name' and 'overrides' at root
-        if ('name' in obj && 'overrides' in obj) {
-            return validateAmendments(data);
-        }
-        // HDF Comparison has 'mode' and 'sources' at root
-        if ('mode' in obj && 'sources' in obj) {
-            return validateComparison(data);
-        }
-        // HDF Evidence Package has 'name' and 'contents' at root
-        if ('name' in obj && 'contents' in obj) {
-            return validateEvidencePackage(data);
-        }
-    }
-    // Cannot determine type, try results first (most common)
-    const resultsResult = validateResults(data);
-    if (resultsResult.valid) {
-        return resultsResult;
-    }
-    const baselineResult = validateBaseline(data);
-    if (baselineResult.valid) {
-        return baselineResult;
-    }
-    return resultsResult;
-}
+* Validate HDF document (auto-detect type based on structure)
+*/
+function validate(data) {
+	if (typeof data === "object" && data !== null) {
+		const obj = data;
+		if ("baselines" in obj) return validateResults(data);
+		if ("name" in obj && "requirements" in obj) return validateBaseline(data);
+		if ("name" in obj && "components" in obj) return validateSystem(data);
+		if ("name" in obj && "assessments" in obj) return validatePlan(data);
+		if ("name" in obj && "overrides" in obj) return validateAmendments(data);
+		if ("mode" in obj && "sources" in obj) return validateComparison(data);
+		if ("name" in obj && "contents" in obj) return validateEvidencePackage(data);
+	}
+	const resultsResult = validateResults(data);
+	if (resultsResult.valid) return resultsResult;
+	const baselineResult = validateBaseline(data);
+	if (baselineResult.valid) return baselineResult;
+	return resultsResult;
+}
+//#endregion
+export { validate, validateAmendments, validateBaseline, validateComparison, validateEvidencePackage, validatePlan, validateResults, validateSystem };
+
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../typescript/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../typescript/index.ts"],"sourcesContent":["import Ajv, { type ValidateFunction, type ErrorObject } from 'ajv';\nimport addFormats from 'ajv-formats';\n\n// Named JS-object schema imports — the schemas are inlined into\n// @mitre/hdf-schema's dist/index.js at build time, so downstream consumers\n// never see raw JSON imports. Works uniformly in raw Node ESM, Vite/Nuxt,\n// webpack, esbuild — no consumer-side noExternal configuration required.\nimport {\n  hdfResultsSchema,\n  hdfBaselineSchema,\n  hdfComparisonSchema,\n  hdfSystemSchema,\n  hdfPlanSchema,\n  hdfAmendmentsSchema,\n  hdfEvidencePackageSchema,\n  commonSchema,\n  extensionsSchema,\n  platformSchema,\n  resultSchema,\n  runnerSchema,\n  statisticsSchema,\n  targetSchema,\n  parameterSchema,\n  systemSchema,\n  planSchema,\n  amendmentsSchema,\n  comparisonSchema,\n  componentSchema,\n  dataFlowSchema,\n} from '@mitre/hdf-schema';\n\n/**\n * Validation error details\n */\nexport interface ValidationError {\n  field: string;\n  message: string;\n  value?: unknown;\n}\n\n/**\n * Result of schema validation\n */\nexport interface ValidationResult {\n  valid: boolean;\n  errors: ValidationError[];\n  getErrorMessage(): string;\n}\n\n/**\n * Create and configure Ajv instance with all HDF schemas\n */\nfunction createValidator(): Ajv {\n  const ajv = new Ajv({\n    allErrors: true,\n    verbose: true,\n    strict: false,\n    validateFormats: true,\n    validateSchema: false // Skip meta-schema validation for performance\n  });\n\n  // Add format validators (date-time, uri, etc.)\n  addFormats(ajv);\n\n  // Add all primitive schemas so they can be referenced via $ref\n  ajv.addSchema(commonSchema);\n  ajv.addSchema(platformSchema);\n  ajv.addSchema(resultSchema);\n  ajv.addSchema(runnerSchema);\n  ajv.addSchema(statisticsSchema);\n  ajv.addSchema(targetSchema);\n  ajv.addSchema(parameterSchema);\n  ajv.addSchema(amendmentsSchema);   // before extensions (extensions $refs amendments Override_Type)\n  ajv.addSchema(extensionsSchema);\n  ajv.addSchema(systemSchema);\n  ajv.addSchema(planSchema);\n  ajv.addSchema(comparisonSchema);\n  ajv.addSchema(componentSchema);\n  ajv.addSchema(dataFlowSchema);\n\n  // Register top-level schemas so cross-schema $refs resolve.\n  // The comparison primitive references hdf-results#/$defs/Evaluated_Requirement,\n  // so hdf-results must be registered before compiling comparison.\n  // Schemas are compiled lazily (in getXxxValidator) for performance.\n  ajv.addSchema(hdfResultsSchema);\n  ajv.addSchema(hdfBaselineSchema);\n  ajv.addSchema(hdfComparisonSchema);\n  ajv.addSchema(hdfSystemSchema);\n  ajv.addSchema(hdfPlanSchema);\n  ajv.addSchema(hdfAmendmentsSchema);\n  ajv.addSchema(hdfEvidencePackageSchema);\n\n  return ajv;\n}\n\n// Singleton Ajv instance\nconst ajv = createValidator();\n\n// Compile schemas once (lazy initialization)\nlet resultsValidator: ValidateFunction | null = null;\nlet baselineValidator: ValidateFunction | null = null;\nlet comparisonValidator: ValidateFunction | null = null;\nlet systemValidator: ValidateFunction | null = null;\nlet planValidator: ValidateFunction | null = null;\nlet amendmentsValidator: ValidateFunction | null = null;\nlet evidencePackageValidator: ValidateFunction | null = null;\n\nfunction getResultsValidator(): ValidateFunction {\n  if (!resultsValidator) {\n    resultsValidator = ajv.compile(hdfResultsSchema);\n  }\n  return resultsValidator;\n}\n\nfunction getBaselineValidator(): ValidateFunction {\n  if (!baselineValidator) {\n    baselineValidator = ajv.compile(hdfBaselineSchema);\n  }\n  return baselineValidator;\n}\n\nfunction getComparisonValidator(): ValidateFunction {\n  if (!comparisonValidator) {\n    comparisonValidator = ajv.compile(hdfComparisonSchema);\n  }\n  return comparisonValidator;\n}\n\nfunction getSystemValidator(): ValidateFunction {\n  if (!systemValidator) {\n    systemValidator = ajv.compile(hdfSystemSchema);\n  }\n  return systemValidator;\n}\n\nfunction getPlanValidator(): ValidateFunction {\n  if (!planValidator) {\n    planValidator = ajv.compile(hdfPlanSchema);\n  }\n  return planValidator;\n}\n\nfunction getAmendmentsValidator(): ValidateFunction {\n  if (!amendmentsValidator) {\n    amendmentsValidator = ajv.compile(hdfAmendmentsSchema);\n  }\n  return amendmentsValidator;\n}\n\nfunction getEvidencePackageValidator(): ValidateFunction {\n  if (!evidencePackageValidator) {\n    evidencePackageValidator = ajv.compile(hdfEvidencePackageSchema);\n  }\n  return evidencePackageValidator;\n}\n\n/**\n * Convert Ajv errors to ValidationError format\n */\nfunction formatErrors(errors: ErrorObject[] | null | undefined): ValidationError[] {\n  if (!errors || errors.length === 0) {\n    return [];\n  }\n\n  return errors.map(err => {\n    // Clean up field path (remove leading slash, use dot notation)\n    let field = err.instancePath\n      .replace(/^\\//, '')\n      .replace(/\\//g, '.');\n\n    // If field is empty, use the data path from the error\n    if (!field && err.schemaPath) {\n      const pathParts = err.schemaPath.split('/');\n      field = pathParts[pathParts.length - 1] || '(root)';\n    }\n\n    // Build message\n    let message = err.message || 'validation failed';\n    if (err.params) {\n      // Add parameter info for more context\n      if ('missingProperty' in err.params) {\n        field = field ? `${field}.${err.params.missingProperty}` : err.params.missingProperty;\n        message = 'is required';\n      } else if ('additionalProperty' in err.params) {\n        field = field ? `${field}.${err.params.additionalProperty}` : err.params.additionalProperty;\n        message = 'is not allowed';\n      } else if ('limit' in err.params) {\n        message = `${message} (limit: ${err.params.limit})`;\n      }\n    }\n\n    return {\n      field: field || '(root)',\n      message,\n      value: err.data\n    };\n  });\n}\n\n/**\n * Create ValidationResult from validator output\n */\nfunction createResult(validator: ValidateFunction, data: unknown): ValidationResult {\n  const valid = validator(data);\n\n  const errors = formatErrors(validator.errors);\n\n  return {\n    valid: valid === true,\n    errors,\n    getErrorMessage(): string {\n      if (this.valid) {\n        return '';\n      }\n      return this.errors\n        .map(e => {\n          if (e.field === '(root)') {\n            return e.message;\n          }\n          return `${e.field}: ${e.message}`;\n        })\n        .join('; ');\n    }\n  };\n}\n\n/**\n * Validate HDF Results document against schema\n */\nexport function validateResults(data: unknown): ValidationResult {\n  const validator = getResultsValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF Baseline document against schema\n */\nexport function validateBaseline(data: unknown): ValidationResult {\n  const validator = getBaselineValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF Comparison document against schema\n */\nexport function validateComparison(data: unknown): ValidationResult {\n  const validator = getComparisonValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF System document against schema\n */\nexport function validateSystem(data: unknown): ValidationResult {\n  const validator = getSystemValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF Plan document against schema\n */\nexport function validatePlan(data: unknown): ValidationResult {\n  const validator = getPlanValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF Amendments document against schema\n */\nexport function validateAmendments(data: unknown): ValidationResult {\n  const validator = getAmendmentsValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF Evidence Package document against schema\n */\nexport function validateEvidencePackage(data: unknown): ValidationResult {\n  const validator = getEvidencePackageValidator();\n  return createResult(validator, data);\n}\n\n/**\n * Validate HDF document (auto-detect type based on structure)\n */\nexport function validate(data: unknown): ValidationResult {\n  if (typeof data === 'object' && data !== null) {\n    const obj = data as Record<string, unknown>;\n\n    // HDF Results has 'baselines' array at root\n    if ('baselines' in obj) {\n      return validateResults(data);\n    }\n\n    // HDF Baseline has 'name' and 'requirements' at root\n    if ('name' in obj && 'requirements' in obj) {\n      return validateBaseline(data);\n    }\n\n    // HDF System has 'name' and 'components' at root\n    if ('name' in obj && 'components' in obj) {\n      return validateSystem(data);\n    }\n\n    // HDF Plan has 'name' and 'assessments' at root\n    if ('name' in obj && 'assessments' in obj) {\n      return validatePlan(data);\n    }\n\n    // HDF Amendments has 'name' and 'overrides' at root\n    if ('name' in obj && 'overrides' in obj) {\n      return validateAmendments(data);\n    }\n\n    // HDF Comparison has 'mode' and 'sources' at root\n    if ('mode' in obj && 'sources' in obj) {\n      return validateComparison(data);\n    }\n\n    // HDF Evidence Package has 'name' and 'contents' at root\n    if ('name' in obj && 'contents' in obj) {\n      return validateEvidencePackage(data);\n    }\n  }\n\n  // Cannot determine type, try results first (most common)\n  const resultsResult = validateResults(data);\n  if (resultsResult.valid) {\n    return resultsResult;\n  }\n\n  const baselineResult = validateBaseline(data);\n  if (baselineResult.valid) {\n    return baselineResult;\n  }\n\n  return resultsResult;\n}\n"],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mitre/hdf-validators",
-  "version": "3.0.0",
+  "version": "3.1.0-rc.1",
   "description": "JSON Schema validation for HDF documents (Results and Baselines)",
   "publishConfig": {
     "access": "public"
@@ -10,26 +10,13 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
-      "development": "./typescript/index.ts",
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
     }
   },
   "files": [
     "dist"
   ],
-  "scripts": {
-    "build": "pnpm clean && tsc",
-    "clean": "rimraf dist",
-    "test": "pnpm run test:ts && pnpm run test:go",
-    "test:ts": "vitest run",
-    "test:go": "cd go && go test ./...",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "type-check": "tsc --noEmit",
-    "lint": "eslint typescript",
-    "lint:fix": "eslint typescript --fix"
-  },
   "repository": {
     "type": "git",
     "url": "https://github.com/mitre/hdf-libs.git",
@@ -38,12 +25,12 @@
   "author": "MITRE Corporation",
   "license": "Apache-2.0",
   "dependencies": {
-    "@mitre/hdf-schema": "workspace:*",
     "ajv": "^8.17.1",
-    "ajv-formats": "^3.0.1"
+    "ajv-formats": "^3.0.1",
+    "@mitre/hdf-schema": "^3.1.0-rc.1"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=22.0.0"
   },
   "keywords": [
     "hdf",
@@ -54,5 +41,17 @@
   "devDependencies": {
     "@stryker-mutator/core": "^9.5.1",
     "@stryker-mutator/vitest-runner": "^9.5.1"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "clean": "rimraf dist",
+    "test": "pnpm run test:ts && pnpm run test:go",
+    "test:ts": "vitest run",
+    "test:go": "cd go && go test ./...",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint typescript",
+    "lint:fix": "eslint typescript --fix"
   }
-}
+}