@mitre/hdf-parsers 2.0.0

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

@@ -0,0 +1,437 @@
+# @mitre/hdf-parsers
+
+Parse and load Heimdall Data Format (HDF) documents with validation. Provides a simple, type-safe API for reading HDF Results and Baselines from JSON with automatic schema validation.
+
+## Scope and Responsibilities
+
+**hdf-parsers** provides validated parsing of HDF documents:
+- Parse HDF Results and Baseline documents from JSON
+- Automatic schema validation via hdf-validators
+- Auto-detection of document type (Results vs Baseline)
+- Type-safe output using hdf-schema types
+- Detailed error reporting with validation messages
+- Support for both TypeScript and Go implementations
+
+### hdf-parsers vs. hdf-validators
+
+| hdf-parsers | hdf-validators |
+|-------------|----------------|
+| Parse JSON → typed objects | Validate JSON against schema |
+| "Load and validate this HDF file" | "Is this valid HDF?" |
+| Returns typed HdfResults/HdfBaseline | Returns validation errors |
+| One-step parse + validate | Schema validation only |
+| Used by CLI commands and tools | Used internally by parsers |
+
+**Example:**
+- `validateResults(data)` → `{ valid: true, errors: [] }` (validators - just validates)
+- `parseResults(json)` → `{ success: true, data: HdfResults }` (parsers - validates AND parses)
+
+## Installation
+
+```bash
+npm install @mitre/hdf-parsers
+```
+
+## Usage
+
+### TypeScript
+
+```typescript
+import { parseResults, parseBaseline, parse } from '@mitre/hdf-parsers';
+
+// Parse HDF Results
+const json = '{"baselines":[...],"targets":[],"statistics":{}}';
+const result = parseResults(json);
+
+if (result.success) {
+  console.log('Parsed HDF Results:', result.data);
+  console.log('Number of baselines:', result.data.baselines?.length);
+} else {
+  console.error('Parse failed:', result.error);
+}
+```
+
+```typescript
+// Parse HDF Baseline
+const baselineJson = '{"name":"My Baseline","requirements":[...],...}';
+const baselineResult = parseBaseline(baselineJson);
+
+if (baselineResult.success) {
+  console.log('Baseline name:', baselineResult.data.name);
+  console.log('Requirements:', baselineResult.data.requirements.length);
+}
+```
+
+```typescript
+// Auto-detect document type
+const unknownJson = '...'; // Could be Results or Baseline
+const autoResult = parse(unknownJson);
+
+if (autoResult.success) {
+  console.log('Document type:', autoResult.type); // "results" or "baseline"
+  console.log('Parsed data:', autoResult.data);
+}
+```
+
+```typescript
+// Parse from Uint8Array (e.g., file reads)
+import { readFileSync } from 'fs';
+
+const bytes = readFileSync('scan-results.json');
+const result = parseResults(bytes);
+```
+
+### Go
+
+```go
+package main
+
+import (
+	"fmt"
+	"os"
+
+	parsers "github.com/mitre/hdf-parsers/go"
+)
+
+func main() {
+	// Read HDF file
+	data, err := os.ReadFile("results.json")
+	if err != nil {
+		panic(err)
+	}
+
+	// Parse HDF Results
+	result := parsers.ParseResults(data)
+
+	if result.Success {
+		fmt.Println("✓ Parsed HDF Results")
+		fmt.Printf("Baselines: %d\n", len(result.Data.Baselines))
+	} else {
+		fmt.Println("✗ Parse failed:")
+		fmt.Println(result.Error)
+		os.Exit(1)
+	}
+}
+```
+
+```go
+// Parse HDF Baseline
+result := parsers.ParseBaseline(baselineData)
+
+if result.Success {
+	fmt.Println("Baseline name:", result.Data.Name)
+	fmt.Printf("Requirements: %d\n", len(result.Data.Requirements))
+}
+```
+
+```go
+// Auto-detect document type
+result := parsers.Parse(data)
+
+if result.Success {
+	fmt.Println("Document type:", result.Type) // "results" or "baseline"
+}
+```
+
+## API Reference
+
+### TypeScript
+
+#### `parseResults(input: string | Uint8Array): ParseResult<HdfResults>`
+
+Parse HDF Results document from JSON string or bytes.
+
+- **Parameters:**
+  - `input` - JSON string or Uint8Array to parse
+- **Returns:** `ParseResult<HdfResults>` with parsed data or error
+
+#### `parseBaseline(input: string | Uint8Array): ParseResult<HdfBaseline>`
+
+Parse HDF Baseline document from JSON string or bytes.
+
+- **Parameters:**
+  - `input` - JSON string or Uint8Array to parse
+- **Returns:** `ParseResult<HdfBaseline>` with parsed data or error
+
+#### `parse(input: string | Uint8Array): ParseResult<HdfResults | HdfBaseline>`
+
+Parse HDF document with auto-detection of type (Results vs Baseline).
+
+- **Parameters:**
+  - `input` - JSON string or Uint8Array to parse
+- **Returns:** `ParseResult` with parsed data, type indicator, or error
+
+#### `ParseResult<T>`
+
+```typescript
+interface ParseResult<T> {
+  success: boolean;           // True if parsing succeeded
+  data?: T;                   // Parsed data (undefined if failed)
+  error?: string;             // Error message (undefined if succeeded)
+  type?: 'results' | 'baseline';  // Document type (only for parse())
+}
+```
+
+### Go
+
+#### `ParseResults(input []byte) ResultsParseResult`
+
+Parse HDF Results document from JSON bytes.
+
+- **Parameters:**
+  - `input` - JSON bytes to parse
+- **Returns:** `ResultsParseResult` with parsed data or error
+
+#### `ParseBaseline(input []byte) BaselineParseResult`
+
+Parse HDF Baseline document from JSON bytes.
+
+- **Parameters:**
+  - `input` - JSON bytes to parse
+- **Returns:** `BaselineParseResult` with parsed data or error
+
+#### `Parse(input []byte) ParseResult`
+
+Parse HDF document with auto-detection of type.
+
+- **Parameters:**
+  - `input` - JSON bytes to parse
+- **Returns:** `ParseResult` with parsed data, type indicator, or error
+
+#### Parse Result Types
+
+```go
+type ResultsParseResult struct {
+    Success bool            `json:"success"`
+    Data    *hdf.HDFResults `json:"data,omitempty"`
+    Error   string          `json:"error,omitempty"`
+}
+
+type BaselineParseResult struct {
+    Success bool             `json:"success"`
+    Data    *hdf.HDFBaseline `json:"data,omitempty"`
+    Error   string           `json:"error,omitempty"`
+}
+
+type ParseResult struct {
+    Success bool        `json:"success"`
+    Data    interface{} `json:"data,omitempty"`
+    Error   string      `json:"error,omitempty"`
+    Type    string      `json:"type,omitempty"` // "results" or "baseline"
+}
+```
+
+## Common Parse Errors
+
+### Invalid JSON Syntax
+
+```
+error: "Invalid JSON: Unexpected token } in JSON at position 42"
+```
+
+Ensure the input is valid JSON. Check for:
+- Missing or extra commas
+- Unquoted property names
+- Trailing commas in objects/arrays
+
+### Schema Validation Failure
+
+```
+error: "Schema validation failed: baselines: is required"
+```
+
+The JSON is valid but doesn't match the HDF schema. Common issues:
+- Missing required fields (baselines, name, requirements)
+- Wrong field types (string instead of number)
+- Invalid enum values (status must be passed/failed/error/etc.)
+
+### Empty Input
+
+```
+error: "Input is empty"
+```
+
+Provide non-empty JSON content.
+
+### Trailing Data
+
+```
+error: "Invalid JSON: unexpected trailing data after end of object"
+```
+
+The JSON has extra characters after the closing brace. Remove any trailing content.
+
+## Use Cases
+
+### CLI Commands
+
+Parse HDF files for CLI operations:
+
+```typescript
+import { parseResults } from '@mitre/hdf-parsers';
+import { readFileSync } from 'fs';
+
+const data = readFileSync(inputFile, 'utf-8');
+const result = parseResults(data);
+
+if (!result.success) {
+  console.error(`Failed to parse ${inputFile}: ${result.error}`);
+  process.exit(1);
+}
+
+// Process the validated HDF data
+processResults(result.data);
+```
+
+### Converter Input Validation
+
+Validate HDF input before conversion:
+
+```typescript
+import { parseResults } from '@mitre/hdf-parsers';
+
+export function convertHdfToCsv(hdfJson: string): string {
+  const result = parseResults(hdfJson);
+
+  if (!result.success) {
+    throw new Error(`Invalid HDF input: ${result.error}`);
+  }
+
+  // Convert validated data
+  return buildCsv(result.data);
+}
+```
+
+### HTTP API Endpoints
+
+Parse and validate HDF uploads:
+
+```typescript
+app.post('/api/upload', async (req, res) => {
+  const result = parseResults(req.body);
+
+  if (!result.success) {
+    return res.status(400).json({
+      error: 'Invalid HDF document',
+      details: result.error
+    });
+  }
+
+  // Store validated HDF data
+  await storeResults(result.data);
+  res.json({ success: true });
+});
+```
+
+### Type-Safe Processing
+
+Get type-safe HDF objects:
+
+```typescript
+import { parseResults } from '@mitre/hdf-parsers';
+import type { HdfResults } from '@mitre/hdf-schema';
+
+function processResults(data: HdfResults) {
+  // TypeScript knows the exact structure
+  for (const baseline of data.baselines ?? []) {
+    console.log(`Baseline: ${baseline.name}`);
+
+    for (const req of baseline.requirements ?? []) {
+      console.log(`  Requirement ${req.id}: ${req.results?.length ?? 0} results`);
+    }
+  }
+}
+
+const result = parseResults(jsonData);
+if (result.success) {
+  processResults(result.data); // Type-safe!
+}
+```
+
+## Error Handling Best Practices
+
+### Always Check success Flag
+
+```typescript
+const result = parseResults(data);
+
+if (!result.success) {
+  // Handle error - data is undefined here
+  console.error(result.error);
+  return;
+}
+
+// TypeScript knows data exists here
+console.log(result.data.baselines);
+```
+
+### Provide User-Friendly Error Messages
+
+```typescript
+const result = parseResults(userInput);
+
+if (!result.success) {
+  if (result.error.includes('JSON')) {
+    console.error('File contains invalid JSON syntax');
+  } else if (result.error.includes('Schema validation')) {
+    console.error('File does not match HDF format');
+  } else {
+    console.error('Failed to parse HDF file');
+  }
+
+  console.error('Details:', result.error);
+}
+```
+
+### Log Validation Errors for Debugging
+
+```typescript
+import { parseResults } from '@mitre/hdf-parsers';
+import { validateResults } from '@mitre/hdf-validators';
+
+// For detailed debugging, use validator directly
+const validationResult = validateResults(jsonData);
+
+if (!validationResult.valid) {
+  console.error('Validation errors:');
+  for (const error of validationResult.errors) {
+    console.error(`  ${error.field}: ${error.message}`);
+  }
+}
+
+// For normal use, parser is simpler
+const parseResult = parseResults(jsonData);
+```
+
+## Development
+
+```bash
+# Install dependencies
+pnpm install
+
+# Run TypeScript tests
+pnpm test:ts
+
+# Run Go tests
+pnpm test:go
+
+# Run all tests
+pnpm test
+
+# Run tests with coverage
+pnpm test:coverage
+
+# Build TypeScript package
+pnpm build
+
+# Lint code
+pnpm lint
+```
+
+## Test Coverage
+
+Both TypeScript and Go implementations maintain **>95% test coverage** with comprehensive parsing tests. Run `pnpm test:coverage` to view current coverage report.
+
+## License
+
+Apache-2.0 © MITRE Corporation

package/dist/flatten.d.ts

@@ -0,0 +1,31 @@
+import type { HdfResults } from '@mitre/hdf-schema';
+export interface FlattenResult {
+    results: HdfResults;
+    metadata: FlattenMetadata;
+}
+export interface FlattenMetadata {
+    originalBaselineCount: number;
+    flattenedBaselineCount: number;
+    merges: BaselineMerge[];
+    warnings: string[];
+}
+export interface BaselineMerge {
+    rootBaseline: string;
+    absorbedBaselines: string[];
+    controlsBefore: number;
+    controlsAfter: number;
+    pattern: 'deep' | 'wide' | 'hybrid';
+}
+/**
+ * Flatten overlay/wrapper baselines in an HDF Results document.
+ *
+ * Handles:
+ * - Deep nesting (overlay chains with shared control IDs via parentBaseline)
+ * - Wide nesting (wrapper profiles aggregating independent bases)
+ * - Hybrid (both patterns in one document)
+ *
+ * @param results - Parsed HDF Results (from parseResults() or equivalent)
+ * @returns FlattenResult with flattened data and merge metadata
+ */
+export declare function flattenOverlays(results: HdfResults): FlattenResult;
+//# sourceMappingURL=flatten.d.ts.map

package/dist/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../typescript/flatten.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2C,MAAM,mBAAmB,CAAC;AAI7F,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,UAAU,CAAC;IACpB,QAAQ,EAAE,eAAe,CAAC;CAC3B;AAED,MAAM,WAAW,eAAe;IAC9B,qBAAqB,EAAE,MAAM,CAAC;IAC9B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,MAAM,EAAE,aAAa,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;CACrC;AA+GD;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,UAAU,GAAG,aAAa,CAwJlE"}

package/dist/flatten.js

@@ -0,0 +1,235 @@
+// ── Internal Helpers ───────────────────────────────────────
+/** BFS from root, returns names in top-down order. Cycle-safe. */
+function collectTree(root, childrenMap) {
+    const order = [];
+    const seen = new Set();
+    const queue = [root];
+    while (queue.length > 0) {
+        const name = queue.shift();
+        if (seen.has(name))
+            continue;
+        seen.add(name);
+        order.push(name);
+        for (const child of (childrenMap.get(name) || [])) {
+            queue.push(child);
+        }
+    }
+    return order;
+}
+/** Classify merge pattern based on tree shape */
+function detectPattern(root, childrenMap) {
+    const rootChildren = childrenMap.get(root) || [];
+    if (rootChildren.length <= 1) {
+        return 'deep';
+    }
+    for (const child of rootChildren) {
+        if ((childrenMap.get(child) || []).length > 0) {
+            return 'hybrid';
+        }
+    }
+    return 'wide';
+}
+/** Merge incoming requirement fields onto existing */
+function mergeRequirement(existing, incoming) {
+    const result = { ...existing };
+    // Impact: incoming always wins (required field, always present)
+    result.impact = incoming.impact;
+    // Results: keep whichever is non-empty (base has them, overlay doesn't)
+    if (incoming.results && incoming.results.length > 0) {
+        result.results = incoming.results;
+    }
+    // Code: incoming wins if non-empty
+    if (incoming.code && incoming.code.trim() !== '') {
+        result.code = incoming.code;
+    }
+    // Tags: shallow merge (incoming keys override)
+    if (incoming.tags) {
+        result.tags = { ...existing.tags, ...incoming.tags };
+    }
+    // Severity: incoming wins if present, else keep existing
+    if (incoming.severity !== undefined) {
+        result.severity = incoming.severity;
+    }
+    // EffectiveStatus: incoming wins only if it has results (otherwise its
+    // effectiveStatus is a computed artifact from empty results, not intentional).
+    // Overlays typically have empty results — the base has the real test results.
+    if (incoming.effectiveStatus !== undefined && incoming.results && incoming.results.length > 0) {
+        result.effectiveStatus = incoming.effectiveStatus;
+    }
+    // Descriptions: merge by label (incoming overrides same label)
+    if (incoming.descriptions && incoming.descriptions.length > 0) {
+        const descMap = new Map((existing.descriptions || []).map(d => [d.label, d]));
+        for (const d of incoming.descriptions) {
+            descMap.set(d.label, d);
+        }
+        result.descriptions = [...descMap.values()];
+    }
+    return result;
+}
+/**
+ * Resolve parentBaseline for a baseline.
+ * InSpec parent_profile can use depends-name aliases (e.g., 'k8s' instead of
+ * 'k8s-node-stig-baseline'). When the value isn't a direct profile name,
+ * find who depends on this baseline — that's the actual parent.
+ */
+function resolveParentBaseline(b, byName, allBaselines) {
+    if (!b.parentBaseline)
+        return undefined;
+    if (byName.has(b.parentBaseline))
+        return b.parentBaseline;
+    // Alias resolution: find the profile whose depends array includes this baseline
+    for (const candidate of allBaselines) {
+        if (candidate.depends?.some((d) => d.name === b.name)) {
+            return candidate.name;
+        }
+    }
+    return undefined; // orphan
+}
+// ── Public API ──────────────────────────────────────────────
+/**
+ * Flatten overlay/wrapper baselines in an HDF Results document.
+ *
+ * Handles:
+ * - Deep nesting (overlay chains with shared control IDs via parentBaseline)
+ * - Wide nesting (wrapper profiles aggregating independent bases)
+ * - Hybrid (both patterns in one document)
+ *
+ * @param results - Parsed HDF Results (from parseResults() or equivalent)
+ * @returns FlattenResult with flattened data and merge metadata
+ */
+export function flattenOverlays(results) {
+    const { baselines } = results;
+    const warnings = [];
+    const merges = [];
+    if (!baselines || baselines.length === 0) {
+        return {
+            results: { ...results, baselines: [] },
+            metadata: {
+                originalBaselineCount: 0,
+                flattenedBaselineCount: 0,
+                merges: [],
+                warnings: [],
+            },
+        };
+    }
+    // Index baselines by name
+    const byName = new Map();
+    for (const b of baselines) {
+        if (byName.has(b.name)) {
+            warnings.push(`Duplicate baseline name "${b.name}" — later entry overwrites earlier`);
+        }
+        byName.set(b.name, b);
+    }
+    // Resolve parentBaseline aliases and build parent map
+    const resolvedParent = new Map();
+    for (const b of baselines) {
+        const parent = resolveParentBaseline(b, byName, baselines);
+        resolvedParent.set(b.name, parent);
+        if (b.parentBaseline && !parent) {
+            warnings.push(`Baseline "${b.name}" references nonexistent parent "${b.parentBaseline}"`);
+        }
+    }
+    // Build parent → children adjacency using resolved parents
+    const childrenMap = new Map();
+    for (const b of baselines) {
+        const parent = resolvedParent.get(b.name);
+        if (parent) {
+            const list = childrenMap.get(parent) || [];
+            list.push(b.name);
+            childrenMap.set(parent, list);
+        }
+    }
+    // Find roots: no resolved parent
+    const roots = [];
+    const visited = new Set();
+    for (const b of baselines) {
+        if (!resolvedParent.get(b.name)) {
+            roots.push(b.name);
+        }
+    }
+    // Mark reachable from roots (iterative DFS to avoid stack overflow on deep trees)
+    function markReachable(start) {
+        const stack = [start];
+        while (stack.length > 0) {
+            const name = stack.pop();
+            if (visited.has(name))
+                continue;
+            visited.add(name);
+            const children = childrenMap.get(name);
+            if (children) {
+                for (const child of children) {
+                    stack.push(child);
+                }
+            }
+        }
+    }
+    for (const r of roots) {
+        markReachable(r);
+    }
+    // Detect cycles: unvisited baselines are in cycles
+    for (const b of baselines) {
+        if (!visited.has(b.name)) {
+            warnings.push(`Circular parentBaseline detected involving "${b.name}"`);
+            roots.push(b.name);
+            markReachable(b.name);
+        }
+    }
+    // Process each root tree
+    const flatBaselines = [];
+    for (const rootName of roots) {
+        const root = byName.get(rootName);
+        const treeNames = collectTree(rootName, childrenMap);
+        if (treeNames.length === 1) {
+            // Standalone baseline — pass through unchanged (preserve depends)
+            flatBaselines.push(root);
+            continue;
+        }
+        // Bottom-up order: reverse top-down BFS
+        const bottomUp = [...treeNames].reverse();
+        // Merge requirements across the tree
+        const merged = new Map();
+        let controlsBefore = 0;
+        const absorbed = [];
+        for (const name of bottomUp) {
+            const b = byName.get(name);
+            controlsBefore += b.requirements.length;
+            if (name !== rootName) {
+                absorbed.push(name);
+            }
+            for (const req of b.requirements) {
+                if (merged.has(req.id)) {
+                    merged.set(req.id, mergeRequirement(merged.get(req.id), req));
+                }
+                else {
+                    merged.set(req.id, { ...req });
+                }
+            }
+        }
+        const mergedReqs = [...merged.values()];
+        const pattern = detectPattern(rootName, childrenMap);
+        merges.push({
+            rootBaseline: rootName,
+            absorbedBaselines: absorbed,
+            controlsBefore,
+            controlsAfter: mergedReqs.length,
+            pattern,
+        });
+        const out = {
+            ...root,
+            requirements: mergedReqs,
+        };
+        delete out.parentBaseline;
+        delete out.depends;
+        flatBaselines.push(out);
+    }
+    return {
+        results: { ...results, baselines: flatBaselines },
+        metadata: {
+            originalBaselineCount: baselines.length,
+            flattenedBaselineCount: flatBaselines.length,
+            merges,
+            warnings,
+        },
+    };
+}
+//# sourceMappingURL=flatten.js.map

package/dist/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../typescript/flatten.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import type { HdfResults, HdfBaseline } from '@mitre/hdf-schema';
+export { flattenOverlays } from './flatten.js';
+export type { FlattenResult, FlattenMetadata, BaselineMerge } from './flatten.js';
+/**
+ * Result of parsing operation
+ */
+export interface ParseResult<T> {
+    success: boolean;
+    data?: T;
+    error?: string;
+    type?: 'results' | 'baseline';
+}
+/**
+ * Parse HDF Results document from string or bytes
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data or error
+ */
+export declare function parseResults(input: string | Uint8Array): ParseResult<HdfResults>;
+/**
+ * Parse HDF Baseline document from string or bytes
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data or error
+ */
+export declare function parseBaseline(input: string | Uint8Array): ParseResult<HdfBaseline>;
+/**
+ * Parse HDF document with auto-detection of type
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data, type indicator, or error
+ */
+export declare function parse(input: string | Uint8Array): ParseResult<HdfResults | HdfBaseline>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../typescript/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,YAAY,EAAE,aAAa,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAGlF;;GAEG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC;IAC5B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,SAAS,GAAG,UAAU,CAAC;CAC/B;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,UAAU,CAAC,CA+ChF;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,WAAW,CAAC,CA8ClF;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC,UAAU,GAAG,WAAW,CAAC,CAqEvF"}

package/dist/index.js

@@ -0,0 +1,177 @@
+export { flattenOverlays } from './flatten.js';
+import { validateResults, validateBaseline, validate as autoValidate } from '@mitre/hdf-validators';
+/**
+ * Parse HDF Results document from string or bytes
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data or error
+ */
+export function parseResults(input) {
+    // Convert Uint8Array to string if needed
+    const jsonStr = typeof input === 'string' ? input : new TextDecoder().decode(input);
+    // Check for empty input
+    if (jsonStr.trim().length === 0) {
+        return {
+            success: false,
+            error: 'Input is empty'
+        };
+    }
+    // Parse JSON
+    let data;
+    try {
+        data = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`
+        };
+    }
+    // Check for trailing garbage by re-serializing and comparing length
+    // This catches cases like: {"valid":"json"}garbage
+    const serialized = JSON.stringify(data);
+    const trimmedInput = jsonStr.trim();
+    if (serialized.length !== trimmedInput.length && !isWhitespaceEquivalent(serialized, trimmedInput)) {
+        return {
+            success: false,
+            error: 'Invalid JSON: unexpected trailing data after end of object'
+        };
+    }
+    // Validate against schema
+    const validationResult = validateResults(data);
+    if (!validationResult.valid) {
+        return {
+            success: false,
+            error: `Schema validation failed: ${validationResult.getErrorMessage()}`
+        };
+    }
+    return {
+        success: true,
+        data: data
+    };
+}
+/**
+ * Parse HDF Baseline document from string or bytes
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data or error
+ */
+export function parseBaseline(input) {
+    // Convert Uint8Array to string if needed
+    const jsonStr = typeof input === 'string' ? input : new TextDecoder().decode(input);
+    // Check for empty input
+    if (jsonStr.trim().length === 0) {
+        return {
+            success: false,
+            error: 'Input is empty'
+        };
+    }
+    // Parse JSON
+    let data;
+    try {
+        data = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`
+        };
+    }
+    // Check for trailing garbage
+    const serialized = JSON.stringify(data);
+    const trimmedInput = jsonStr.trim();
+    if (serialized.length !== trimmedInput.length && !isWhitespaceEquivalent(serialized, trimmedInput)) {
+        return {
+            success: false,
+            error: 'Invalid JSON: unexpected trailing data after end of object'
+        };
+    }
+    // Validate against schema
+    const validationResult = validateBaseline(data);
+    if (!validationResult.valid) {
+        return {
+            success: false,
+            error: `Schema validation failed: ${validationResult.getErrorMessage()}`
+        };
+    }
+    return {
+        success: true,
+        data: data
+    };
+}
+/**
+ * Parse HDF document with auto-detection of type
+ * @param input - JSON string or Uint8Array to parse
+ * @returns ParseResult with parsed data, type indicator, or error
+ */
+export function parse(input) {
+    // Convert Uint8Array to string if needed
+    const jsonStr = typeof input === 'string' ? input : new TextDecoder().decode(input);
+    // Check for empty input
+    if (jsonStr.trim().length === 0) {
+        return {
+            success: false,
+            error: 'Input is empty'
+        };
+    }
+    // Parse JSON
+    let data;
+    try {
+        data = JSON.parse(jsonStr);
+    }
+    catch (err) {
+        return {
+            success: false,
+            error: `Invalid JSON: ${err instanceof Error ? err.message : String(err)}`
+        };
+    }
+    // Check for trailing garbage
+    const serialized = JSON.stringify(data);
+    const trimmedInput = jsonStr.trim();
+    if (serialized.length !== trimmedInput.length && !isWhitespaceEquivalent(serialized, trimmedInput)) {
+        return {
+            success: false,
+            error: 'Invalid JSON: unexpected trailing data after end of object'
+        };
+    }
+    // Auto-validate and detect type
+    const validationResult = autoValidate(data);
+    if (!validationResult.valid) {
+        return {
+            success: false,
+            error: `Schema validation failed: ${validationResult.getErrorMessage()}`
+        };
+    }
+    // Determine type based on structure
+    if (typeof data === 'object' && data !== null) {
+        const obj = data;
+        // HDF Results has 'baselines' array at root
+        if ('baselines' in obj) {
+            return {
+                success: true,
+                data: data,
+                type: 'results'
+            };
+        }
+        // HDF Baseline has 'name' and 'requirements' at root
+        if ('name' in obj && 'requirements' in obj) {
+            return {
+                success: true,
+                data: data,
+                type: 'baseline'
+            };
+        }
+    }
+    return {
+        success: false,
+        error: 'Unable to determine HDF document type'
+    };
+}
+/**
+ * Check if two JSON strings are equivalent modulo whitespace
+ * This is a simple heuristic - we check if one is just whitespace-padded version of other
+ */
+function isWhitespaceEquivalent(a, b) {
+    // Remove all whitespace and compare
+    const normalizeWhitespace = (s) => s.replace(/\s+/g, '');
+    return normalizeWhitespace(a) === normalizeWhitespace(b);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../typescript/index.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@mitre/hdf-parsers",
+  "version": "2.0.0",
+  "description": "Parse and load HDF documents with validation",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mitre/hdf-libs.git",
+    "directory": "hdf-parsers"
+  },
+  "author": "MITRE Corporation",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "@mitre/hdf-schema": "2.0.0",
+    "@mitre/hdf-validators": "2.0.0"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "hdf",
+    "heimdall",
+    "parser",
+    "json"
+  ],
+  "devDependencies": {
+    "@stryker-mutator/core": "^9.5.1",
+    "@stryker-mutator/vitest-runner": "^9.5.1"
+  },
+  "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"
+  }
+}