@mitre/hdf-utilities 2.0.0

package/dist/csv/index.js

@@ -0,0 +1,251 @@
+/**
+ * CSV parsing and generation utilities using d3-dsv
+ *
+ * SECURITY WARNING: CSV files opened in Excel/LibreOffice may execute formulas.
+ * Use sanitization options when exporting data that may contain user-controlled content.
+ */
+import { dsvFormat } from 'd3-dsv';
+export { extractColumn as extractCsvColumn, findRows as findCsvRows, } from '../object/index.js';
+/**
+ * Default options for parsing CSV with headers
+ */
+const DEFAULT_PARSE_OPTIONS = {
+    header: true,
+    skipEmptyLines: true,
+    transformHeader: undefined,
+    dynamicTyping: false,
+};
+/**
+ * Default options for parsing CSV without headers
+ */
+const DEFAULT_PARSE_ARRAY_OPTIONS = {
+    header: false,
+    skipEmptyLines: true,
+    dynamicTyping: false,
+};
+/**
+ * Default options for building CSV
+ */
+const DEFAULT_BUILD_OPTIONS = {
+    header: true,
+    newline: '\n',
+    skipEmptyLines: true,
+};
+/**
+ * Validate CSV quoting — throws if unclosed quotes are found
+ */
+function validateQuoting(csv) {
+    let inQuotes = false;
+    let row = 0;
+    for (let i = 0; i < csv.length; i++) {
+        if (csv[i] === '"') {
+            if (inQuotes && i + 1 < csv.length && csv[i + 1] === '"') {
+                i++; // skip escaped quote ""
+            }
+            else {
+                inQuotes = !inQuotes;
+            }
+        }
+        else if (csv[i] === '\n' && !inQuotes) {
+            row++;
+        }
+    }
+    if (inQuotes) {
+        throw new Error(`CSV parsing failed: Row ${row}: Unclosed quote`);
+    }
+}
+/**
+ * Convert string value to number or boolean when appropriate
+ */
+function dynamicTypeConvert(value) {
+    if (value === '')
+        return value;
+    if (value === 'true')
+        return true;
+    if (value === 'false')
+        return false;
+    const num = Number(value);
+    if (!isNaN(num) && value.trim() !== '')
+        return num;
+    return value;
+}
+/**
+ * Parse CSV string into array of objects with headers as keys
+ * @param csv - CSV string to parse
+ * @param options - Optional parse configuration
+ * @returns Array of objects representing rows
+ * @throws Error if parsing fails
+ */
+export function parseCsv(csv, options) {
+    if (options?.maxSize !== undefined && csv.length > options.maxSize) {
+        throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
+    }
+    const opts = { ...DEFAULT_PARSE_OPTIONS, ...options };
+    const trimmed = csv.trim();
+    validateQuoting(trimmed);
+    const dsv = dsvFormat(opts.delimiter ?? ',');
+    const parsed = dsv.parse(trimmed);
+    const { columns } = parsed;
+    // Pre-compute transformed headers
+    const headers = opts.transformHeader
+        ? columns.map((col, i) => opts.transformHeader(col, i))
+        : columns;
+    let rows = parsed.map((row) => {
+        const obj = {};
+        columns.forEach((col, i) => {
+            let value = row[col] ?? '';
+            if (opts.dynamicTyping && typeof value === 'string') {
+                value = dynamicTypeConvert(value);
+            }
+            const key = headers[i];
+            if (key !== undefined) {
+                obj[key] = value;
+            }
+        });
+        return obj;
+    });
+    if (opts.skipEmptyLines) {
+        rows = rows.filter((row) => Object.values(row).some((v) => v !== '' && v !== null && v !== undefined));
+    }
+    return rows;
+}
+/**
+ * Parse CSV string into array of arrays without treating first row as headers
+ * @param csv - CSV string to parse
+ * @param options - Optional parse configuration
+ * @returns Array of arrays representing rows
+ * @throws Error if parsing fails
+ */
+export function parseCsvArray(csv, options) {
+    if (options?.maxSize !== undefined && csv.length > options.maxSize) {
+        throw new Error(`Input exceeds maximum allowed size: ${csv.length} bytes exceeds limit of ${options.maxSize} bytes`);
+    }
+    const opts = { ...DEFAULT_PARSE_ARRAY_OPTIONS, ...options };
+    const trimmed = csv.trim();
+    validateQuoting(trimmed);
+    const dsv = dsvFormat(opts.delimiter ?? ',');
+    let rows = dsv.parseRows(trimmed);
+    if (opts.skipEmptyLines) {
+        rows = rows.filter((row) => !(row.length === 1 && row[0] === ''));
+    }
+    return rows;
+}
+/**
+ * Build CSV string from array of objects
+ *
+ * SECURITY: Set sanitize=true when data may contain user-controlled content
+ * to prevent CSV formula injection attacks in Excel/LibreOffice.
+ *
+ * @param data - Array of objects to convert to CSV
+ * @param options - Optional build configuration and sanitize flag
+ * @returns CSV string
+ */
+export function buildCsv(data, options) {
+    const { sanitize, ...buildOpts } = options || {};
+    const opts = { ...DEFAULT_BUILD_OPTIONS, ...buildOpts };
+    if (data.length === 0)
+        return '';
+    let processedData = data;
+    if (sanitize) {
+        processedData = data.map((row) => sanitizeCsvObject(row));
+    }
+    const dsv = dsvFormat(opts.delimiter ?? ',');
+    let result;
+    if (opts.header === false) {
+        const rows = processedData.map((row) => Object.values(row).map(String));
+        result = dsv.formatRows(rows);
+    }
+    else {
+        result = dsv.format(processedData);
+    }
+    if (opts.newline && opts.newline !== '\n') {
+        result = result.replace(/\n/g, opts.newline);
+    }
+    return result;
+}
+/**
+ * Build CSV string from array of arrays
+ *
+ * SECURITY: Set sanitize=true when data may contain user-controlled content
+ * to prevent CSV formula injection attacks in Excel/LibreOffice.
+ *
+ * @param data - Array of arrays to convert to CSV
+ * @param options - Optional build configuration and sanitize flag
+ * @returns CSV string
+ */
+export function buildCsvArray(data, options) {
+    const { sanitize, ...buildOpts } = options || {};
+    const opts = { ...DEFAULT_BUILD_OPTIONS, header: false, ...buildOpts };
+    if (data.length === 0)
+        return '';
+    let processedData = data;
+    if (sanitize) {
+        processedData = data.map((row) => sanitizeCsvArray(row));
+    }
+    const dsv = dsvFormat(opts.delimiter ?? ',');
+    let result = dsv.formatRows(processedData);
+    if (opts.newline && opts.newline !== '\n') {
+        result = result.replace(/\n/g, opts.newline);
+    }
+    return result;
+}
+/**
+ * Validate CSV format
+ * @param csv - CSV string to validate
+ * @returns True if valid CSV, false otherwise
+ */
+export function isValidCsv(csv) {
+    if (!csv || csv.trim().length === 0)
+        return false;
+    const trimmed = csv.trim();
+    // CSV must have at least one delimiter (comma) to be considered CSV structure
+    if (!trimmed.includes(','))
+        return false;
+    try {
+        validateQuoting(trimmed);
+    }
+    catch {
+        return false;
+    }
+    return true;
+}
+/**
+ * Sanitize a single CSV value to prevent formula injection
+ *
+ * Prefixes values starting with =, +, -, @, |, or % with a single quote
+ * to prevent Excel/LibreOffice from interpreting them as formulas.
+ *
+ * @param value - Value to sanitize
+ * @returns Sanitized value
+ */
+export function sanitizeCsvValue(value) {
+    const str = String(value);
+    // Check if string starts with formula trigger characters
+    if (/^[=+\-@|%]/.test(str)) {
+        return `'${str}`;
+    }
+    return str;
+}
+/**
+ * Sanitize all values in an array to prevent formula injection
+ *
+ * @param values - Array of values to sanitize
+ * @returns Array with sanitized values
+ */
+export function sanitizeCsvArray(values) {
+    return values.map(sanitizeCsvValue);
+}
+/**
+ * Sanitize all values in an object to prevent formula injection
+ *
+ * @param obj - Object with values to sanitize
+ * @returns New object with sanitized values
+ */
+export function sanitizeCsvObject(obj) {
+    const sanitized = {};
+    for (const [key, value] of Object.entries(obj)) {
+        sanitized[key] = sanitizeCsvValue(value);
+    }
+    return sanitized;
+}
+//# sourceMappingURL=index.js.map

package/dist/csv/index.js.map

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

package/dist/hash/index.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Hash utilities for HDF content
+ * Provides cryptographic hashing functions for content identification and integrity verification
+ * Uses the Web Crypto API (globalThis.crypto.subtle) for browser and Node.js compatibility
+ */
+/**
+ * Supported hash algorithms
+ */
+export type HashAlgorithm = 'sha256' | 'sha512';
+/**
+ * Supported output encodings
+ */
+export type HashEncoding = 'hex' | 'base64';
+/**
+ * Options for hash generation
+ */
+export interface HashOptions {
+    /** Hash algorithm (default: 'sha256') */
+    algorithm?: HashAlgorithm;
+    /** Output encoding (default: 'hex') */
+    encoding?: HashEncoding;
+}
+/**
+ * Generate a hash of the given data
+ *
+ * @param data - String data to hash
+ * @param options - Hash generation options
+ * @returns Hex-encoded hash string
+ *
+ * @example
+ * ```typescript
+ * const hash = await generateHash('hello world');
+ * // Returns: 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+export declare function generateHash(data: string, options?: HashOptions): Promise<string>;
+/**
+ * Generate a SHA-256 hash (recommended for most use cases)
+ *
+ * @param data - String data to hash
+ * @returns Hex-encoded SHA-256 hash
+ *
+ * @example
+ * ```typescript
+ * const hash = await sha256('hello world');
+ * // Returns: 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+export declare function sha256(data: string): Promise<string>;
+/**
+ * Generate a SHA-512 hash (enhanced security for sensitive data)
+ *
+ * @param data - String data to hash
+ * @returns Hex-encoded SHA-512 hash
+ *
+ * @example
+ * ```typescript
+ * const hash = await sha512('hello world');
+ * // Returns: '309ecc489c12d6eb4cc40f50c902f2b4d0ed77ee511a7c7a9bcd3ca86d4cd86f989dd35bc5ff499670da34255b45b0cfd830e81f605dcf7dc5542e93ae9cd76f'
+ * ```
+ */
+export declare function sha512(data: string): Promise<string>;
+/**
+ * Generate a hash of an object by stringifying it first
+ * Useful for hashing HDF control objects or other structured data
+ *
+ * @param obj - Object to hash
+ * @param options - Hash generation options
+ * @returns Hex-encoded hash string
+ *
+ * @example
+ * ```typescript
+ * const control = { id: 'V-12345', title: 'Test Control' };
+ * const hash = await hashObject(control);
+ * // Returns hash of the JSON-stringified object
+ * ```
+ */
+export declare function hashObject(obj: unknown, options?: HashOptions): Promise<string>;
+/**
+ * Verify that data matches a given hash
+ *
+ * @param data - String data to verify
+ * @param expectedHash - Expected hash value
+ * @param options - Hash generation options (must match hash generation)
+ * @returns True if data matches the hash
+ *
+ * @example
+ * ```typescript
+ * const data = 'hello world';
+ * const hash = await sha256(data);
+ * const isValid = await verifyHash(data, hash); // true
+ * ```
+ */
+export declare function verifyHash(data: string, expectedHash: string, options?: HashOptions): Promise<boolean>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hash/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,MAAM,aAAa,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEhD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,yCAAyC;IACzC,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,uCAAuC;IACvC,QAAQ,CAAC,EAAE,YAAY,CAAC;CACzB;AA4BD;;;;;;;;;;;;GAYG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAM3F;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAE1D;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,GAAE,WAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzF;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,OAAO,CAAC,CAGlB"}

package/dist/hash/index.js

@@ -0,0 +1,118 @@
+/**
+ * Hash utilities for HDF content
+ * Provides cryptographic hashing functions for content identification and integrity verification
+ * Uses the Web Crypto API (globalThis.crypto.subtle) for browser and Node.js compatibility
+ */
+/** Map our algorithm names to Web Crypto algorithm identifiers */
+const ALGORITHM_MAP = {
+    sha256: 'SHA-256',
+    sha512: 'SHA-512',
+};
+/** Convert an ArrayBuffer to a hex string */
+function bufferToHex(buffer) {
+    const bytes = new Uint8Array(buffer);
+    let hex = '';
+    for (const b of bytes) {
+        hex += b.toString(16).padStart(2, '0');
+    }
+    return hex;
+}
+/** Convert an ArrayBuffer to a base64 string */
+function bufferToBase64(buffer) {
+    const bytes = new Uint8Array(buffer);
+    let binary = '';
+    for (const b of bytes) {
+        binary += String.fromCharCode(b);
+    }
+    return btoa(binary);
+}
+/**
+ * Generate a hash of the given data
+ *
+ * @param data - String data to hash
+ * @param options - Hash generation options
+ * @returns Hex-encoded hash string
+ *
+ * @example
+ * ```typescript
+ * const hash = await generateHash('hello world');
+ * // Returns: 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+export async function generateHash(data, options = {}) {
+    const { algorithm = 'sha256', encoding = 'hex' } = options;
+    const webAlgorithm = ALGORITHM_MAP[algorithm];
+    const encoded = new TextEncoder().encode(data);
+    const hashBuffer = await globalThis.crypto.subtle.digest(webAlgorithm, encoded);
+    return encoding === 'base64' ? bufferToBase64(hashBuffer) : bufferToHex(hashBuffer);
+}
+/**
+ * Generate a SHA-256 hash (recommended for most use cases)
+ *
+ * @param data - String data to hash
+ * @returns Hex-encoded SHA-256 hash
+ *
+ * @example
+ * ```typescript
+ * const hash = await sha256('hello world');
+ * // Returns: 'b94d27b9934d3e08a52e52d7da7dabfac484efe37a5380ee9088f7ace2efcde9'
+ * ```
+ */
+export async function sha256(data) {
+    return generateHash(data, { algorithm: 'sha256' });
+}
+/**
+ * Generate a SHA-512 hash (enhanced security for sensitive data)
+ *
+ * @param data - String data to hash
+ * @returns Hex-encoded SHA-512 hash
+ *
+ * @example
+ * ```typescript
+ * const hash = await sha512('hello world');
+ * // Returns: '309ecc489c12d6eb4cc40f50c902f2b4d0ed77ee511a7c7a9bcd3ca86d4cd86f989dd35bc5ff499670da34255b45b0cfd830e81f605dcf7dc5542e93ae9cd76f'
+ * ```
+ */
+export async function sha512(data) {
+    return generateHash(data, { algorithm: 'sha512' });
+}
+/**
+ * Generate a hash of an object by stringifying it first
+ * Useful for hashing HDF control objects or other structured data
+ *
+ * @param obj - Object to hash
+ * @param options - Hash generation options
+ * @returns Hex-encoded hash string
+ *
+ * @example
+ * ```typescript
+ * const control = { id: 'V-12345', title: 'Test Control' };
+ * const hash = await hashObject(control);
+ * // Returns hash of the JSON-stringified object
+ * ```
+ */
+export async function hashObject(obj, options = {}) {
+    // JSON.stringify returns undefined for undefined, so handle it explicitly
+    const stringified = obj === undefined ? 'undefined' : JSON.stringify(obj);
+    return generateHash(stringified, options);
+}
+/**
+ * Verify that data matches a given hash
+ *
+ * @param data - String data to verify
+ * @param expectedHash - Expected hash value
+ * @param options - Hash generation options (must match hash generation)
+ * @returns True if data matches the hash
+ *
+ * @example
+ * ```typescript
+ * const data = 'hello world';
+ * const hash = await sha256(data);
+ * const isValid = await verifyHash(data, hash); // true
+ * ```
+ */
+export async function verifyHash(data, expectedHash, options = {}) {
+    const actualHash = await generateHash(data, options);
+    return actualHash === expectedHash;
+}
+//# sourceMappingURL=index.js.map

package/dist/hash/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/hash/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH,kEAAkE;AAClE,MAAM,aAAa,GAAkC;IACnD,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;CAClB,CAAC;AAEF,6CAA6C;AAC7C,SAAS,WAAW,CAAC,MAAmB;IACtC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,gDAAgD;AAChD,SAAS,cAAc,CAAC,MAAmB;IACzC,MAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAY,EAAE,UAAuB,EAAE;IACxE,MAAM,EAAE,SAAS,GAAG,QAAQ,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC3D,MAAM,YAAY,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,UAAU,GAAG,MAAM,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAChF,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,UAAU,CAAC,CAAC;AACtF,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAY;IACvC,OAAO,YAAY,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC,CAAC;AACrD,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAY,EAAE,UAAuB,EAAE;IACtE,0EAA0E;IAC1E,MAAM,WAAW,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IAC1E,OAAO,YAAY,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,IAAY,EACZ,YAAoB,EACpB,UAAuB,EAAE;IAEzB,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACrD,OAAO,UAAU,KAAK,YAAY,CAAC;AACrC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @mitre/hdf-utilities
+ * Utility functions for HDF libraries
+ */
+export { parseJSON, stringifyJSON, isValidJSON, findJsonValues, type StringifyOptions } from './json/index.js';
+export { generateHash, sha256, sha512, hashObject, verifyHash, type HashAlgorithm, type HashEncoding, type HashOptions, } from './hash/index.js';
+export { parseXml, buildXml, isValidXml, parseXmlWithArrays, extractTextFromXml, findXmlValues, } from './xml/index.js';
+export { parseCsv, parseCsvArray, buildCsv, buildCsvArray, isValidCsv, sanitizeCsvValue, sanitizeCsvArray, sanitizeCsvObject, extractCsvColumn, findCsvRows, type CsvParseOptions, type CsvBuildOptions, } from './csv/index.js';
+export { findValuesByKey, extractColumn, findRows } from './object/index.js';
+export { stripHtml, parseTimestamp } from './string/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAG/G,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAU,EACV,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,WAAW,GACjB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,EACX,KAAK,eAAe,EACpB,KAAK,eAAe,GACrB,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @mitre/hdf-utilities
+ * Utility functions for HDF libraries
+ */
+// JSON utilities
+export { parseJSON, stringifyJSON, isValidJSON, findJsonValues } from './json/index.js';
+// Hash utilities
+export { generateHash, sha256, sha512, hashObject, verifyHash, } from './hash/index.js';
+// XML utilities
+export { parseXml, buildXml, isValidXml, parseXmlWithArrays, extractTextFromXml, findXmlValues, } from './xml/index.js';
+// CSV utilities
+export { parseCsv, parseCsvArray, buildCsv, buildCsvArray, isValidCsv, sanitizeCsvValue, sanitizeCsvArray, sanitizeCsvObject, extractCsvColumn, findCsvRows, } from './csv/index.js';
+// Object utilities (generic traversal)
+export { findValuesByKey, extractColumn, findRows } from './object/index.js';
+// String utilities
+export { stripHtml, parseTimestamp } from './string/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,iBAAiB;AACjB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,cAAc,EAAyB,MAAM,iBAAiB,CAAC;AAE/G,iBAAiB;AACjB,OAAO,EACL,YAAY,EACZ,MAAM,EACN,MAAM,EACN,UAAU,EACV,UAAU,GAIX,MAAM,iBAAiB,CAAC;AAEzB,gBAAgB;AAChB,OAAO,EACL,QAAQ,EACR,QAAQ,EACR,UAAU,EACV,kBAAkB,EAClB,kBAAkB,EAClB,aAAa,GACd,MAAM,gBAAgB,CAAC;AAExB,gBAAgB;AAChB,OAAO,EACL,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,WAAW,GAGZ,MAAM,gBAAgB,CAAC;AAExB,uCAAuC;AACvC,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAE7E,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/json/index.d.ts

@@ -0,0 +1,32 @@
+export { findValuesByKey as findJsonValues } from '../object/index.js';
+/**
+ * Options for JSON stringification
+ */
+export interface StringifyOptions {
+    /** Enable pretty printing with indentation */
+    pretty?: boolean;
+    /** Number of spaces for indentation (default: 2) */
+    indent?: number;
+}
+/**
+ * Safely parse a JSON string
+ * @param input - JSON string to parse
+ * @returns Parsed JSON value
+ * @throws Error if input is not valid JSON
+ */
+export declare function parseJSON<T = unknown>(input: string): T;
+/**
+ * Safely stringify a value to JSON
+ * @param value - Value to stringify
+ * @param options - Stringification options
+ * @returns JSON string
+ * @throws Error if value contains circular references or cannot be stringified
+ */
+export declare function stringifyJSON(value: unknown, options?: StringifyOptions): string;
+/**
+ * Check if a string is valid JSON
+ * @param input - String to validate
+ * @returns true if input is valid JSON, false otherwise
+ */
+export declare function isValidJSON(input: unknown): boolean;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,8CAA8C;IAC9C,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,CAAC,CAcvD;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,gBAAqB,GAAG,MAAM,CAWpF;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAenD"}

package/dist/json/index.js

@@ -0,0 +1,61 @@
+export { findValuesByKey as findJsonValues } from '../object/index.js';
+/**
+ * Safely parse a JSON string
+ * @param input - JSON string to parse
+ * @returns Parsed JSON value
+ * @throws Error if input is not valid JSON
+ */
+export function parseJSON(input) {
+    if (typeof input !== 'string') {
+        throw new Error('Input must be a string');
+    }
+    if (input.trim() === '') {
+        throw new Error('Input cannot be empty');
+    }
+    try {
+        return JSON.parse(input);
+    }
+    catch (error) {
+        throw new Error(`Invalid JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Safely stringify a value to JSON
+ * @param value - Value to stringify
+ * @param options - Stringification options
+ * @returns JSON string
+ * @throws Error if value contains circular references or cannot be stringified
+ */
+export function stringifyJSON(value, options = {}) {
+    const { pretty = false, indent = 2 } = options;
+    try {
+        if (pretty) {
+            return JSON.stringify(value, null, indent);
+        }
+        return JSON.stringify(value);
+    }
+    catch (error) {
+        throw new Error(`Failed to stringify JSON: ${error instanceof Error ? error.message : String(error)}`);
+    }
+}
+/**
+ * Check if a string is valid JSON
+ * @param input - String to validate
+ * @returns true if input is valid JSON, false otherwise
+ */
+export function isValidJSON(input) {
+    if (typeof input !== 'string') {
+        return false;
+    }
+    if (input.trim() === '') {
+        return false;
+    }
+    try {
+        JSON.parse(input);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/json/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/json/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAYvE;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAc,KAAa;IAClD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAC3C,CAAC;IAED,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,CAAM,CAAC;IAChC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,iBAAiB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,UAA4B,EAAE;IAC1E,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,MAAM,GAAG,CAAC,EAAE,GAAG,OAAO,CAAC;IAE/C,IAAI,CAAC;QACH,IAAI,MAAM,EAAE,CAAC;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,6BAA6B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzG,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAClB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/dist/object/index.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 declare function findValuesByKey(obj: unknown, key: string, maxDepth?: number): unknown[];
+/**
+ * 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 declare function extractColumn(rows: Record<string, unknown>[], column: string): unknown[];
+/**
+ * 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 declare function findRows(rows: Record<string, unknown>[], column: string, value: unknown): Record<string, unknown>[];
+//# sourceMappingURL=index.d.ts.map