@mitre/hdf-utilities 2.0.0

package/dist/object/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,MAAM,EACX,QAAQ,SAAM,GACb,OAAO,EAAE,CAIX;AAiCD;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,EAAE,CAEX;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CACtB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC/B,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,GACb,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAE3B"}

package/dist/object/index.js

@@ -0,0 +1,70 @@
+/**
+ * Generic object query utilities for traversing parsed data structures.
+ *
+ * These functions work on any plain JS objects — parsed XML, JSON, or CSV rows
+ * are all objects by the time converters work with them.
+ */
+/**
+ * Recursively find all values for a given key anywhere in a nested object tree.
+ *
+ * Walks the entire tree depth-first. When a property matching `key` is found,
+ * its value is collected. Recurse continues into all child values (objects and
+ * arrays) regardless of whether the current level matched.
+ *
+ * @param obj - Object tree to search (parsed XML, JSON, etc.)
+ * @param key - Property name to search for
+ * @param maxDepth - Maximum recursion depth (default 100). Nodes beyond this depth are silently skipped.
+ * @returns Flat array of all matched values
+ */
+export function findValuesByKey(obj, key, maxDepth = 100) {
+    const results = [];
+    walk(obj, key, results, 0, maxDepth);
+    return results;
+}
+function walk(node, key, results, depth, maxDepth) {
+    if (depth > maxDepth) {
+        return;
+    }
+    if (node === null || node === undefined || typeof node !== 'object') {
+        return;
+    }
+    if (Array.isArray(node)) {
+        for (const item of node) {
+            walk(item, key, results, depth + 1, maxDepth);
+        }
+        return;
+    }
+    const record = node;
+    if (key in record) {
+        results.push(record[key]);
+    }
+    for (const value of Object.values(record)) {
+        walk(value, key, results, depth + 1, maxDepth);
+    }
+}
+/**
+ * Extract all values for a named field from an array of objects.
+ *
+ * Rows where the column is `undefined` are skipped.
+ *
+ * @param rows - Array of objects (e.g. parsed CSV rows)
+ * @param column - Property name to extract
+ * @returns Array of values for that column
+ */
+export function extractColumn(rows, column) {
+    return rows.map((r) => r[column]).filter((v) => v !== undefined);
+}
+/**
+ * Filter an array of objects to rows where a column matches a value.
+ *
+ * Uses strict equality (`===`).
+ *
+ * @param rows - Array of objects to filter
+ * @param column - Property name to check
+ * @param value - Value to match against
+ * @returns Filtered array of matching rows
+ */
+export function findRows(rows, column, value) {
+    return rows.filter((r) => r[column] === value);
+}
+//# sourceMappingURL=index.js.map

package/dist/object/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/object/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAC7B,GAAY,EACZ,GAAW,EACX,QAAQ,GAAG,GAAG;IAEd,MAAM,OAAO,GAAc,EAAE,CAAC;IAC9B,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,CAAC,CAAC;IACrC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,IAAI,CACX,IAAa,EACb,GAAW,EACX,OAAkB,EAClB,KAAa,EACb,QAAgB;IAEhB,IAAI,KAAK,GAAG,QAAQ,EAAE,CAAC;QACrB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,SAAS,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpE,OAAO;IACT,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACxB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACxB,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;QAChD,CAAC;QACD,OAAO;IACT,CAAC;IAED,MAAM,MAAM,GAAG,IAA+B,CAAC;IAC/C,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;QAClB,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QAC1C,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,GAAG,CAAC,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA+B,EAC/B,MAAc;IAEd,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,QAAQ,CACtB,IAA+B,EAC/B,MAAc,EACd,KAAc;IAEd,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,KAAK,CAAC,CAAC;AACjD,CAAC"}

package/dist/string/index.d.ts

@@ -0,0 +1,50 @@
+/**
+ * String manipulation utilities for HDF converters.
+ *
+ * These handle common operations on security tool output strings:
+ * HTML stripping for STIG descriptions and SonarQube messages,
+ * and multi-format timestamp parsing for tool output dates.
+ */
+/**
+ * Remove HTML tags from a string and normalize whitespace.
+ *
+ * Strips all HTML/XML tags, collapses multiple whitespace characters
+ * into single spaces, and trims leading/trailing whitespace.
+ *
+ * For XML documents, use {@link extractTextFromXml} from the xml module instead.
+ * This function is for inline HTML in non-XML strings (STIG descriptions,
+ * SonarQube messages, etc.).
+ *
+ * @param html - String potentially containing HTML tags
+ * @returns Plain text with tags removed and whitespace normalized
+ *
+ * @example
+ * ```typescript
+ * stripHtml('<p>hello</p> <b>world</b>'); // 'hello world'
+ * stripHtml('no tags here'); // 'no tags here'
+ * ```
+ */
+export declare function stripHtml(html: string): string;
+/**
+ * Parse a timestamp string in various common formats.
+ *
+ * Attempts to parse the input using the JavaScript Date constructor, which
+ * supports ISO 8601, RFC 2822, and several other formats natively.
+ *
+ * Returns `null` if the input is empty or cannot be parsed.
+ *
+ * Equivalent to the Go `ParseTimestamp` in shared/go/converterutil.go.
+ *
+ * @param s - Timestamp string to parse
+ * @returns Parsed Date or null if unparseable
+ *
+ * @example
+ * ```typescript
+ * parseTimestamp('2024-01-15T10:30:00Z'); // Date object
+ * parseTimestamp('Mon, 15 Jan 2024 10:30:00 UTC'); // Date object
+ * parseTimestamp('not a date'); // null
+ * parseTimestamp(''); // null
+ * ```
+ */
+export declare function parseTimestamp(s: string): Date | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/string/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAWrD"}

package/dist/string/index.js

@@ -0,0 +1,62 @@
+/**
+ * String manipulation utilities for HDF converters.
+ *
+ * These handle common operations on security tool output strings:
+ * HTML stripping for STIG descriptions and SonarQube messages,
+ * and multi-format timestamp parsing for tool output dates.
+ */
+/**
+ * Remove HTML tags from a string and normalize whitespace.
+ *
+ * Strips all HTML/XML tags, collapses multiple whitespace characters
+ * into single spaces, and trims leading/trailing whitespace.
+ *
+ * For XML documents, use {@link extractTextFromXml} from the xml module instead.
+ * This function is for inline HTML in non-XML strings (STIG descriptions,
+ * SonarQube messages, etc.).
+ *
+ * @param html - String potentially containing HTML tags
+ * @returns Plain text with tags removed and whitespace normalized
+ *
+ * @example
+ * ```typescript
+ * stripHtml('<p>hello</p> <b>world</b>'); // 'hello world'
+ * stripHtml('no tags here'); // 'no tags here'
+ * ```
+ */
+export function stripHtml(html) {
+    const stripped = html.replace(/<[^>]*>/g, ' ');
+    return stripped.replace(/\s+/g, ' ').trim();
+}
+/**
+ * Parse a timestamp string in various common formats.
+ *
+ * Attempts to parse the input using the JavaScript Date constructor, which
+ * supports ISO 8601, RFC 2822, and several other formats natively.
+ *
+ * Returns `null` if the input is empty or cannot be parsed.
+ *
+ * Equivalent to the Go `ParseTimestamp` in shared/go/converterutil.go.
+ *
+ * @param s - Timestamp string to parse
+ * @returns Parsed Date or null if unparseable
+ *
+ * @example
+ * ```typescript
+ * parseTimestamp('2024-01-15T10:30:00Z'); // Date object
+ * parseTimestamp('Mon, 15 Jan 2024 10:30:00 UTC'); // Date object
+ * parseTimestamp('not a date'); // null
+ * parseTimestamp(''); // null
+ * ```
+ */
+export function parseTimestamp(s) {
+    if (!s || s.trim().length === 0) {
+        return null;
+    }
+    const parsed = new Date(s);
+    if (isNaN(parsed.getTime())) {
+        return null;
+    }
+    return parsed;
+}
+//# sourceMappingURL=index.js.map

package/dist/string/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/string/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC;IAC/C,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AAC9C,CAAC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC3B,IAAI,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,EAAE,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/xml/index.d.ts

@@ -0,0 +1,86 @@
+/**
+ * XML parsing utilities for HDF converters
+ * Provides XML parsing with sensible defaults for security tool output
+ */
+import type { X2jOptions, XmlBuilderOptions } from 'fast-xml-parser';
+export { findValuesByKey as findXmlValues } from '../object/index.js';
+/**
+ * Parse XML string to JavaScript object
+ *
+ * @param xml - XML string to parse
+ * @param options - Optional parser configuration (merged with defaults)
+ * @returns Parsed JavaScript object
+ *
+ * @example
+ * ```typescript
+ * const xmlString = '<root><item id="1">Test</item></root>';
+ * const result = parseXml(xmlString);
+ * // Returns: { root: { item: { id: '1', '#text': 'Test' } } }
+ * ```
+ */
+export declare function parseXml(xml: string, options?: Partial<X2jOptions> & {
+    maxSize?: number;
+}): Record<string, unknown>;
+/**
+ * Build XML string from JavaScript object
+ *
+ * @param obj - JavaScript object to convert to XML
+ * @param options - Optional builder configuration (merged with defaults)
+ * @returns XML string
+ *
+ * @example
+ * ```typescript
+ * const obj = { root: { item: { id: '1', '#text': 'Test' } } };
+ * const xml = buildXml(obj);
+ * // Returns formatted XML string
+ * ```
+ */
+export declare function buildXml(obj: Record<string, unknown>, options?: Partial<XmlBuilderOptions>): string;
+/**
+ * Validate if a string is well-formed XML
+ *
+ * @param xml - String to validate
+ * @returns True if valid XML, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidXml('<root><item>Test</item></root>'); // true
+ * isValidXml('<root><item>Test</root>'); // false (mismatched tags)
+ * isValidXml('not xml'); // false
+ * ```
+ */
+export declare function isValidXml(xml: string): boolean;
+/**
+ * Parse XML with array handling for repeated elements
+ * Forces specified tag names to always be arrays, even if only one element exists
+ *
+ * @param xml - XML string to parse
+ * @param arrayTags - Array of tag names that should always be parsed as arrays
+ * @returns Parsed JavaScript object with forced arrays
+ *
+ * @example
+ * ```typescript
+ * const xml = '<root><item>Test</item></root>';
+ * const result = parseXmlWithArrays(xml, ['item']);
+ * // Returns: { root: { item: ['Test'] } }
+ * // Without arrayTags, would return: { root: { item: 'Test' } }
+ * ```
+ */
+export declare function parseXmlWithArrays(xml: string, arrayTags: string[], options?: Partial<X2jOptions> & {
+    maxSize?: number;
+}): Record<string, unknown>;
+/**
+ * Extract text content from XML, stripping all tags
+ *
+ * @param xml - XML string
+ * @returns Plain text content with tags removed
+ *
+ * @example
+ * ```typescript
+ * const xml = '<root><b>Bold</b> and <i>italic</i></root>';
+ * const text = extractTextFromXml(xml);
+ * // Returns: 'Bold and italic'
+ * ```
+ */
+export declare function extractTextFromXml(xml: string): string;
+//# sourceMappingURL=index.d.ts.map

package/dist/xml/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/xml/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,IAAI,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAiCtE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoBzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,QAAQ,CACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5B,OAAO,CAAC,EAAE,OAAO,CAAC,iBAAiB,CAAC,GACnC,MAAM,CAQR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAO/C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,SAAS,EAAE,MAAM,EAAE,EACnB,OAAO,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAqBzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAWtD"}

package/dist/xml/index.js

@@ -0,0 +1,187 @@
+/**
+ * XML parsing utilities for HDF converters
+ * Provides XML parsing with sensible defaults for security tool output
+ */
+import { XMLParser, XMLBuilder, XMLValidator } from 'fast-xml-parser';
+export { findValuesByKey as findXmlValues } from '../object/index.js';
+/**
+ * Default options for XML parsing optimized for security tool converters.
+ *
+ * **XXE Safety**: fast-xml-parser v5.x does not process DTD or external entities
+ * by default. The `processEntities: false` option is set as defense-in-depth to
+ * ensure entity expansion is disabled even if future versions change defaults.
+ * See: https://github.com/NaturalIntelligence/fast-xml-parser/blob/master/docs/v5/2.XMLparseOptions.md
+ */
+const DEFAULT_PARSE_OPTIONS = {
+    attributeNamePrefix: '',
+    textNodeName: '#text',
+    ignoreAttributes: false,
+    ignoreDeclaration: true,
+    parseAttributeValue: false,
+    parseTagValue: false,
+    removeNSPrefix: true,
+    processEntities: false,
+};
+/**
+ * Default options for XML building
+ */
+const DEFAULT_BUILD_OPTIONS = {
+    attributeNamePrefix: '',
+    textNodeName: '#text',
+    ignoreAttributes: false,
+    format: true,
+    indentBy: '  ',
+    suppressEmptyNode: false,
+};
+/**
+ * Parse XML string to JavaScript object
+ *
+ * @param xml - XML string to parse
+ * @param options - Optional parser configuration (merged with defaults)
+ * @returns Parsed JavaScript object
+ *
+ * @example
+ * ```typescript
+ * const xmlString = '<root><item id="1">Test</item></root>';
+ * const result = parseXml(xmlString);
+ * // Returns: { root: { item: { id: '1', '#text': 'Test' } } }
+ * ```
+ */
+export function parseXml(xml, options) {
+    if (options?.maxSize !== undefined && xml.length > options.maxSize) {
+        throw new Error(`Input exceeds maximum allowed size: ${xml.length} bytes exceeds limit of ${options.maxSize} bytes`);
+    }
+    // Validate XML first
+    const validation = XMLValidator.validate(xml);
+    if (validation !== true) {
+        throw new Error(`Invalid XML: ${validation.err.msg}`);
+    }
+    const mergedOptions = {
+        ...DEFAULT_PARSE_OPTIONS,
+        ...options,
+    };
+    const parser = new XMLParser(mergedOptions);
+    return parser.parse(xml);
+}
+/**
+ * Build XML string from JavaScript object
+ *
+ * @param obj - JavaScript object to convert to XML
+ * @param options - Optional builder configuration (merged with defaults)
+ * @returns XML string
+ *
+ * @example
+ * ```typescript
+ * const obj = { root: { item: { id: '1', '#text': 'Test' } } };
+ * const xml = buildXml(obj);
+ * // Returns formatted XML string
+ * ```
+ */
+export function buildXml(obj, options) {
+    const mergedOptions = {
+        ...DEFAULT_BUILD_OPTIONS,
+        ...options,
+    };
+    const builder = new XMLBuilder(mergedOptions);
+    return builder.build(obj);
+}
+/**
+ * Validate if a string is well-formed XML
+ *
+ * @param xml - String to validate
+ * @returns True if valid XML, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidXml('<root><item>Test</item></root>'); // true
+ * isValidXml('<root><item>Test</root>'); // false (mismatched tags)
+ * isValidXml('not xml'); // false
+ * ```
+ */
+export function isValidXml(xml) {
+    if (!xml || xml.trim().length === 0) {
+        return false;
+    }
+    const result = XMLValidator.validate(xml);
+    return result === true;
+}
+/**
+ * Parse XML with array handling for repeated elements
+ * Forces specified tag names to always be arrays, even if only one element exists
+ *
+ * @param xml - XML string to parse
+ * @param arrayTags - Array of tag names that should always be parsed as arrays
+ * @returns Parsed JavaScript object with forced arrays
+ *
+ * @example
+ * ```typescript
+ * const xml = '<root><item>Test</item></root>';
+ * const result = parseXmlWithArrays(xml, ['item']);
+ * // Returns: { root: { item: ['Test'] } }
+ * // Without arrayTags, would return: { root: { item: 'Test' } }
+ * ```
+ */
+export function parseXmlWithArrays(xml, arrayTags, options) {
+    if (options?.maxSize !== undefined && xml.length > options.maxSize) {
+        throw new Error(`Input exceeds maximum allowed size: ${xml.length} bytes exceeds limit of ${options.maxSize} bytes`);
+    }
+    // Validate XML first (consistency with parseXml)
+    const validation = XMLValidator.validate(xml);
+    if (validation !== true) {
+        throw new Error(`Invalid XML: ${validation.err.msg}`);
+    }
+    const mergedOptions = {
+        ...DEFAULT_PARSE_OPTIONS,
+        ...options,
+        isArray: (tagName) => arrayTags.includes(tagName),
+    };
+    const parser = new XMLParser(mergedOptions);
+    return parser.parse(xml);
+}
+/**
+ * Extract text content from XML, stripping all tags
+ *
+ * @param xml - XML string
+ * @returns Plain text content with tags removed
+ *
+ * @example
+ * ```typescript
+ * const xml = '<root><b>Bold</b> and <i>italic</i></root>';
+ * const text = extractTextFromXml(xml);
+ * // Returns: 'Bold and italic'
+ * ```
+ */
+export function extractTextFromXml(xml) {
+    if (!isValidXml(xml)) {
+        return '';
+    }
+    try {
+        const parsed = parseXml(xml, { ignoreAttributes: true });
+        return extractTextRecursive(parsed).trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Recursively extract text from parsed XML object
+ * @private
+ */
+function extractTextRecursive(obj) {
+    if (typeof obj === 'string' || typeof obj === 'number') {
+        return String(obj);
+    }
+    if (Array.isArray(obj)) {
+        return obj.map(extractTextRecursive).join(' ');
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        const record = obj;
+        // Recursively extract text from all properties
+        return Object.values(record)
+            .map(extractTextRecursive)
+            .filter(text => text.length > 0)
+            .join(' ');
+    }
+    return '';
+}
+//# sourceMappingURL=index.js.map

package/dist/xml/index.js.map

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

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "@mitre/hdf-utilities",
+  "version": "2.0.0",
+  "description": "Utility functions for HDF libraries (JSON parsing, validation helpers)",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./json": {
+      "import": "./dist/json/index.js",
+      "types": "./dist/json/index.d.ts"
+    },
+    "./hash": {
+      "import": "./dist/hash/index.js",
+      "types": "./dist/hash/index.d.ts"
+    },
+    "./xml": {
+      "import": "./dist/xml/index.js",
+      "types": "./dist/xml/index.d.ts"
+    },
+    "./csv": {
+      "import": "./dist/csv/index.js",
+      "types": "./dist/csv/index.d.ts"
+    },
+    "./object": {
+      "import": "./dist/object/index.js",
+      "types": "./dist/object/index.d.ts"
+    },
+    "./string": {
+      "import": "./dist/string/index.js",
+      "types": "./dist/string/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/mitre/hdf-libs.git",
+    "directory": "hdf-utilities"
+  },
+  "author": "MITRE Corporation",
+  "license": "Apache-2.0",
+  "dependencies": {
+    "d3-dsv": "^3.0.1",
+    "fast-xml-parser": "5.5.7"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "keywords": [
+    "hdf",
+    "heimdall",
+    "utilities",
+    "json",
+    "parsing"
+  ],
+  "devDependencies": {
+    "@stryker-mutator/core": "^9.5.1",
+    "@stryker-mutator/vitest-runner": "^9.5.1",
+    "@types/d3-dsv": "^3.0.7"
+  },
+  "scripts": {
+    "build": "pnpm clean && tsc",
+    "clean": "rimraf dist",
+    "test": "pnpm run test:ts",
+    "test:ts": "vitest run",
+    "test:go": "echo 'No Go tests in hdf-utilities'",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix"
+  }
+}