@bedrock-engineer/bro-xml-parser 0.1.0

package/dist/colors.js

@@ -0,0 +1,102 @@
+/**
+ * BRO Soil Color Utilities
+ *
+ * Maps Dutch BRO soil color names to hex color values.
+ * Colors are based on Munsell soil color chart conversions.
+ *
+ * Color naming convention:
+ * - licht* (light), standaard* (standard), donker* (dark)
+ * - Base colors: Blauw, Bruin, Geel, Grijs, Groen, Olijf, Oranje, Rood
+ * - Special: wit (white), zwart (black)
+ *
+ * @example
+ * ```typescript
+ * import { BRO_SOIL_COLORS, getSoilColor } from '@bedrock-engineer/bro-xml';
+ *
+ * // Direct lookup
+ * const hex = BRO_SOIL_COLORS['lichtBruin']; // '#b79a77'
+ *
+ * // Helper function (case-insensitive)
+ * const color = getSoilColor('lichtbruin'); // '#b79a77'
+ * const unknown = getSoilColor('invalid'); // null
+ * ```
+ */
+/**
+ * BRO soil color name to hex color mapping
+ *
+ * Based on Munsell soil color chart averages as defined in the BRO standard.
+ */
+export const BRO_SOIL_COLORS = {
+    // Blues (Blauw)
+    lichtBlauw: '#96abbc',
+    standaardBlauw: '#6c718a',
+    donkerBlauw: '#534350',
+    // Browns (Bruin)
+    lichtBruin: '#b79a77',
+    standaardBruin: '#896748',
+    donkerBruin: '#5b422d',
+    // Yellows (Geel)
+    lichtGeel: '#ddd1af',
+    standaardGeel: '#d0a55b',
+    donkerGeel: '#b18f40',
+    // Grays (Grijs)
+    lichtGrijs: '#adb1a3',
+    standaardGrijs: '#84857a',
+    donkerGrijs: '#56564d',
+    // Greens (Groen)
+    lichtGroen: '#8cab94',
+    standaardGroen: '#5e8269',
+    donkerGroen: '#3d4f44',
+    // Olives (Olijf)
+    lichtOlijf: '#938e63',
+    standaardOlijf: '#787049',
+    donkerOlijf: '#525134',
+    // Oranges (Oranje) - estimated from Munsell descriptions
+    lichtOranje: '#e8c89a',
+    standaardOranje: '#d9a870',
+    donkerOranje: '#c48b50',
+    // Reds (Rood)
+    lichtRood: '#bc9183',
+    standaardRood: '#b37c67',
+    donkerRood: '#5f3633',
+    // Black & White
+    wit: '#ddd2ca',
+    zwart: '#3a3a31',
+    // Simple colors (IMBRO/A - NEN5104Synthetisch, no intensity modifier)
+    // Map to standard intensity as reasonable default
+    blauw: '#6c718a',
+    bruin: '#896748',
+    geel: '#d0a55b',
+    grijs: '#84857a',
+    groen: '#5e8269',
+    olijf: '#787049',
+    oranje: '#d9a870',
+    paars: '#8070a0', // Purple - estimated
+    rood: '#b37c67',
+};
+/**
+ * Normalized lookup map (lowercase keys for case-insensitive matching)
+ */
+const normalizedColorMap = Object.fromEntries(Object.entries(BRO_SOIL_COLORS).map(([key, value]) => [key.toLowerCase(), value]));
+export function getSoilColor(colorName, defaultColor) {
+    const normalized = colorName.toLowerCase();
+    return normalizedColorMap[normalized] ?? defaultColor ?? null;
+}
+/**
+ * Check if a color name is a valid BRO soil color
+ *
+ * @param colorName - Color name to validate
+ * @returns true if the color name is recognized
+ */
+export function isValidSoilColor(colorName) {
+    return colorName.toLowerCase() in normalizedColorMap;
+}
+/**
+ * Get all available BRO soil color names
+ *
+ * @returns Array of color names in their canonical form
+ */
+export function getSoilColorNames() {
+    return Object.keys(BRO_SOIL_COLORS);
+}
+//# sourceMappingURL=colors.js.map

package/dist/colors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colors.js","sourceRoot":"","sources":["../src/colors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,gBAAgB;IAChB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IAEtB,iBAAiB;IACjB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IAEtB,iBAAiB;IACjB,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IAErB,gBAAgB;IAChB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IAEtB,iBAAiB;IACjB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IAEtB,iBAAiB;IACjB,UAAU,EAAE,SAAS;IACrB,cAAc,EAAE,SAAS;IACzB,WAAW,EAAE,SAAS;IAEtB,yDAAyD;IACzD,WAAW,EAAE,SAAS;IACtB,eAAe,EAAE,SAAS;IAC1B,YAAY,EAAE,SAAS;IAEvB,cAAc;IACd,SAAS,EAAE,SAAS;IACpB,aAAa,EAAE,SAAS;IACxB,UAAU,EAAE,SAAS;IAErB,gBAAgB;IAChB,GAAG,EAAE,SAAS;IACd,KAAK,EAAE,SAAS;IAEhB,sEAAsE;IACtE,kDAAkD;IAClD,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,SAAS;IACjB,KAAK,EAAE,SAAS,EAAE,qBAAqB;IACvC,IAAI,EAAE,SAAS;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,kBAAkB,GAA2B,MAAM,CAAC,WAAW,CACnE,MAAM,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,WAAW,EAAE,EAAE,KAAK,CAAC,CAAC,CAClF,CAAC;AAmBF,MAAM,UAAU,YAAY,CAAC,SAAiB,EAAE,YAAqB;IACnE,MAAM,UAAU,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IAC3C,OAAO,kBAAkB,CAAC,UAAU,CAAC,IAAI,YAAY,IAAI,IAAI,CAAC;AAChE,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,OAAO,SAAS,CAAC,WAAW,EAAE,IAAI,kBAAkB,CAAC;AACvD,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB;IAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AACtC,CAAC"}

package/dist/core/schema-parser.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Generic schema-driven XML parser
+ *
+ * This parser interprets a schema definition (field configurations)
+ * and extracts data from XML documents accordingly.
+ * The same parser works for any schema (CPT, Bore, etc.)
+ */
+import type { XMLAdapter, Schema, Namespaces } from "../types/index.js";
+export declare class SchemaParser {
+    private adapter;
+    private namespaces;
+    constructor(adapter: XMLAdapter, namespaces: Namespaces);
+    /**
+     * Parse XML document using provided schema
+     *
+     * @param doc - Parsed XML document
+     * @param schema - Field definitions (field name -> config)
+     * @param rootPath - Optional XPath to root element
+     * @returns Parsed data object with fields from schema
+     */
+    parse<T = Record<string, unknown>>(doc: Document, schema: Schema, rootPath?: string): T;
+    /**
+     * Extract single field using schema config
+     *
+     * @param element - Root element to search from
+     * @param config - Field configuration (xpath, resolver, etc.)
+     * @returns Extracted and resolved value
+     */
+    private extractField;
+}
+//# sourceMappingURL=schema-parser.d.ts.map

package/dist/core/schema-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-parser.d.ts","sourceRoot":"","sources":["../../src/core/schema-parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,UAAU,EACV,MAAM,EAEN,UAAU,EAEX,MAAM,mBAAmB,CAAC;AAG3B,qBAAa,YAAY;IAErB,OAAO,CAAC,OAAO;IACf,OAAO,CAAC,UAAU;gBADV,OAAO,EAAE,UAAU,EACnB,UAAU,EAAE,UAAU;IAGhC;;;;;;;OAOG;IAEH,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,CAAC;IA0DvF;;;;;;OAMG;IACH,OAAO,CAAC,YAAY;CAoCrB"}

package/dist/core/schema-parser.js

@@ -0,0 +1,99 @@
+/**
+ * Generic schema-driven XML parser
+ *
+ * This parser interprets a schema definition (field configurations)
+ * and extracts data from XML documents accordingly.
+ * The same parser works for any schema (CPT, Bore, etc.)
+ */
+import { BROParseError } from "../types/index.js";
+export class SchemaParser {
+    constructor(adapter, namespaces) {
+        this.adapter = adapter;
+        this.namespaces = namespaces;
+    }
+    /**
+     * Parse XML document using provided schema
+     *
+     * @param doc - Parsed XML document
+     * @param schema - Field definitions (field name -> config)
+     * @param rootPath - Optional XPath to root element
+     * @returns Parsed data object with fields from schema
+     */
+    parse(doc, schema, rootPath) {
+        // Find root element if specified
+        let rootElement = doc;
+        if (rootPath) {
+            // First try with namespace-aware search
+            let root = this.adapter.evaluateXPath(doc, `.//${rootPath}/*[1]`, (prefix) => (prefix ? (this.namespaces[prefix] ?? null) : null));
+            // If not found, try without namespace prefix
+            root ?? (root = this.adapter.evaluateXPath(doc, `//*[local-name()='${rootPath}']/*[1]`, (prefix) => (prefix ? (this.namespaces[prefix] ?? null) : null)));
+            if (!root) {
+                throw new BROParseError(`Root element not found: ${rootPath}`, {
+                    code: "MISSING_ROOT",
+                    path: rootPath,
+                });
+            }
+            rootElement = root;
+        }
+        const result = {};
+        // Iterate through schema fields and extract each one
+        for (const [fieldName, config] of Object.entries(schema)) {
+            try {
+                const value = this.extractField(rootElement, config);
+                result[fieldName] = value;
+            }
+            catch (error) {
+                // If field is required and extraction failed, throw error
+                if (config.required) {
+                    throw new BROParseError(`Required field missing or invalid: ${fieldName}`, {
+                        code: "MISSING_REQUIRED_FIELD",
+                        field: fieldName,
+                        xpath: config.xpath,
+                        originalError: error,
+                    });
+                }
+                // Optional fields default to null on error
+                result[fieldName] = null;
+            }
+        }
+        return result;
+    }
+    /**
+     * Extract single field using schema config
+     *
+     * @param element - Root element to search from
+     * @param config - Field configuration (xpath, resolver, etc.)
+     * @returns Extracted and resolved value
+     */
+    extractField(element, config) {
+        // Find element using XPath
+        const node = this.adapter.evaluateXPath(element, config.xpath, (prefix) => prefix ? (this.namespaces[prefix] ?? null) : null);
+        if (!node) {
+            return null;
+        }
+        // Get value from element (text content or attribute)
+        let value;
+        if (config.attribute) {
+            // Get specific attribute (e.g., "textContent")
+            // Use type assertion to access dynamic properties
+            const element = node;
+            const attrValue = element[config.attribute];
+            value = typeof attrValue === "string" ? attrValue : null;
+        }
+        else {
+            // Default to text content
+            value = node.textContent;
+        }
+        if (config.resolver) {
+            const context = {
+                node,
+                element,
+                namespaces: this.namespaces,
+                adapter: this.adapter,
+            };
+            return config.resolver(value, context);
+        }
+        return value;
+    }
+}
+//# sourceMappingURL=schema-parser.js.map

package/dist/core/schema-parser.js.map

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

package/dist/core/version-detector.d.ts

@@ -0,0 +1,66 @@
+/**
+ * BRO XML format version detection
+ *
+ * Validates that XML documents match the expected schema versions
+ * supported by this library. Uses graceful degradation for same
+ * major versions with warnings.
+ */
+export type DataType = 'CPT' | 'BHR-GT' | 'BHR-G';
+/**
+ * Schema version info
+ */
+interface SchemaVersionInfo {
+    namespace: string;
+    version: string;
+    majorVersion: number;
+    description: string;
+}
+/**
+ * Get the supported (primary) version for a data type
+ */
+export declare function getSupportedVersion(dataType: DataType): SchemaVersionInfo;
+/**
+ * Exported for backward compatibility
+ */
+export declare const SUPPORTED_VERSIONS: {
+    readonly CPT: SchemaVersionInfo;
+    readonly 'BHR-GT': SchemaVersionInfo;
+    readonly 'BHR-G': SchemaVersionInfo;
+};
+/**
+ * Result of version detection
+ */
+export interface VersionDetectionResult {
+    dataType: DataType;
+    version: string;
+    namespace: string;
+    warnings: string[];
+}
+/**
+ * Detect and validate the BRO schema version from XML document
+ *
+ * Behavior:
+ * - Exact match: returns version info with no warnings
+ * - Same major version: returns version info with warning
+ * - Different major version: throws BROParseError
+ * - Unknown/invalid: throws BROParseError
+ *
+ * @param doc - Parsed XML document
+ * @param expectedType - Expected data type (CPT, BORE, or BHRG)
+ * @returns Version detection result with any warnings
+ * @throws {BROParseError} If version is incompatible or document is invalid
+ */
+export declare function detectAndValidateVersion(doc: Document, expectedType: DataType): VersionDetectionResult;
+/**
+ * Get version information from document (for informational purposes)
+ *
+ * @param doc - Parsed XML document
+ * @returns Version information or null if not detected
+ */
+export declare function getVersionInfo(doc: Document): {
+    type: DataType;
+    version: string;
+    namespace: string;
+} | null;
+export {};
+//# sourceMappingURL=version-detector.d.ts.map

package/dist/core/version-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-detector.d.ts","sourceRoot":"","sources":["../../src/core/version-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,CAAC;AAElD;;GAEG;AACH,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAyDD;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,GAAG,iBAAiB,CAIzE;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;CAIrB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA4CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,QAAQ,GACrB,sBAAsB,CAoHxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,GACZ;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiC/D"}

package/dist/core/version-detector.js

@@ -0,0 +1,263 @@
+/**
+ * BRO XML format version detection
+ *
+ * Validates that XML documents match the expected schema versions
+ * supported by this library. Uses graceful degradation for same
+ * major versions with warnings.
+ */
+import { BROParseError } from '../types/index.js';
+/**
+ * Known schema versions per data type
+ *
+ * The first entry for each type is the "supported" version.
+ * Additional entries are known older/newer versions that may
+ * be parseable with warnings.
+ */
+const KNOWN_VERSIONS = {
+    CPT: [
+        {
+            namespace: 'http://www.broservices.nl/xsd/dscpt/1.1',
+            version: '1.1',
+            majorVersion: 1,
+            description: 'Dispatch CPT schema version 1.1',
+        },
+        // Older known versions
+        {
+            namespace: 'http://www.broservices.nl/xsd/dscpt/1.0',
+            version: '1.0',
+            majorVersion: 1,
+            description: 'Dispatch CPT schema version 1.0',
+        },
+    ],
+    'BHR-GT': [
+        {
+            namespace: 'http://www.broservices.nl/xsd/dsbhr-gt/2.1',
+            version: '2.1',
+            majorVersion: 2,
+            description: 'Dispatch BHR-GT schema version 2.1',
+        },
+        // Older known versions
+        {
+            namespace: 'http://www.broservices.nl/xsd/dsbhr-gt/2.0',
+            version: '2.0',
+            majorVersion: 2,
+            description: 'Dispatch BHR-GT schema version 2.0',
+        },
+    ],
+    'BHR-G': [
+        {
+            namespace: 'http://www.broservices.nl/xsd/dsbhrg/3.1',
+            version: '3.1',
+            majorVersion: 3,
+            description: 'Dispatch BHR-G schema version 3.1',
+        },
+        // Older known versions
+        {
+            namespace: 'http://www.broservices.nl/xsd/dsbhrg/3.0',
+            version: '3.0',
+            majorVersion: 3,
+            description: 'Dispatch BHR-G schema version 3.0',
+        },
+    ],
+};
+/**
+ * Get the supported (primary) version for a data type
+ */
+export function getSupportedVersion(dataType) {
+    // First element is always the primary supported version
+    // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+    return KNOWN_VERSIONS[dataType][0];
+}
+/**
+ * Exported for backward compatibility
+ */
+export const SUPPORTED_VERSIONS = {
+    CPT: getSupportedVersion('CPT'),
+    'BHR-GT': getSupportedVersion('BHR-GT'),
+    'BHR-G': getSupportedVersion('BHR-G'),
+};
+/**
+ * Extract version from namespace URI
+ * e.g., "http://www.broservices.nl/xsd/dscpt/1.1" -> "1.1"
+ */
+function extractVersionFromNamespace(namespace) {
+    const match = /\/(\d+\.\d+)$/.exec(namespace);
+    return match?.[1] ?? 'unknown';
+}
+/**
+ * Extract major version from version string
+ * e.g., "1.1" -> 1
+ */
+function extractMajorVersion(version) {
+    const match = /^(\d+)/.exec(version);
+    return match?.[1] ? parseInt(match[1], 10) : 0;
+}
+/**
+ * Detect schema type from namespace pattern
+ */
+function detectDataTypeFromNamespace(namespace) {
+    if (namespace.includes('/dscpt/'))
+        return 'CPT';
+    if (namespace.includes('/dsbhr-gt/'))
+        return 'BHR-GT';
+    if (namespace.includes('/dsbhrg/'))
+        return 'BHR-G';
+    return null;
+}
+/**
+ * Get the parser method name for a data type
+ */
+function getParserMethodName(dataType) {
+    switch (dataType) {
+        case 'CPT':
+            return 'parseCPT';
+        case 'BHR-GT':
+            return 'parseBHRGT';
+        case 'BHR-G':
+            return 'parseBHRG';
+    }
+}
+/**
+ * Detect and validate the BRO schema version from XML document
+ *
+ * Behavior:
+ * - Exact match: returns version info with no warnings
+ * - Same major version: returns version info with warning
+ * - Different major version: throws BROParseError
+ * - Unknown/invalid: throws BROParseError
+ *
+ * @param doc - Parsed XML document
+ * @param expectedType - Expected data type (CPT, BORE, or BHRG)
+ * @returns Version detection result with any warnings
+ * @throws {BROParseError} If version is incompatible or document is invalid
+ */
+export function detectAndValidateVersion(doc, expectedType) {
+    const rootElement = doc.documentElement;
+    if (!rootElement) {
+        throw new BROParseError('Invalid XML: no root element found', {
+            code: 'INVALID_XML',
+        });
+    }
+    const namespace = rootElement.getAttribute('xmlns');
+    if (!namespace) {
+        throw new BROParseError('No namespace found in XML document', {
+            code: 'MISSING_NAMESPACE',
+            hint: 'BRO XML documents must declare a namespace',
+        });
+    }
+    const supportedVersion = getSupportedVersion(expectedType);
+    const warnings = [];
+    // Check for exact match with supported version
+    if (namespace === supportedVersion.namespace) {
+        return {
+            dataType: expectedType,
+            version: supportedVersion.version,
+            namespace,
+            warnings: [],
+        };
+    }
+    // Check if it's a known version for the expected type
+    const knownVersions = KNOWN_VERSIONS[expectedType];
+    const knownVersion = knownVersions.find((v) => v.namespace === namespace);
+    if (knownVersion) {
+        // Known version but not the primary supported one
+        warnings.push(`Parsing with schema version ${knownVersion.version}, ` +
+            `but this library is optimized for version ${supportedVersion.version}. ` +
+            `Some fields may be missing or have different formats.`);
+        return {
+            dataType: expectedType,
+            version: knownVersion.version,
+            namespace,
+            warnings,
+        };
+    }
+    // Check if it's a different data type
+    const detectedType = detectDataTypeFromNamespace(namespace);
+    if (detectedType && detectedType !== expectedType) {
+        throw new BROParseError(`Wrong document type: expected ${expectedType} but got ${detectedType}`, {
+            code: 'WRONG_DOCUMENT_TYPE',
+            expected: expectedType,
+            actual: detectedType,
+            namespace,
+            hint: `Use ${getParserMethodName(detectedType)}() instead of ${getParserMethodName(expectedType)}()`,
+        });
+    }
+    // Check if it's the same type but unknown version
+    if (detectedType === expectedType) {
+        const detectedVersion = extractVersionFromNamespace(namespace);
+        const detectedMajor = extractMajorVersion(detectedVersion);
+        const supportedMajor = supportedVersion.majorVersion;
+        if (detectedMajor === supportedMajor) {
+            // Same major version - attempt parsing with warning
+            warnings.push(`Unknown schema version ${detectedVersion} for ${expectedType}. ` +
+                `This library supports version ${supportedVersion.version}. ` +
+                `Attempting to parse as they share major version ${detectedMajor}.`);
+            return {
+                dataType: expectedType,
+                version: detectedVersion,
+                namespace,
+                warnings,
+            };
+        }
+        // Different major version - throw error
+        throw new BROParseError(`Incompatible schema major version: ${detectedVersion}`, {
+            code: 'INCOMPATIBLE_VERSION',
+            namespace,
+            detectedVersion,
+            detectedMajorVersion: detectedMajor,
+            supportedVersion: supportedVersion.version,
+            supportedMajorVersion: supportedMajor,
+            hint: `This library supports ${expectedType} schema major version ${supportedMajor} ` +
+                `(e.g., ${supportedVersion.version}). ` +
+                `The provided document uses major version ${detectedMajor}.`,
+        });
+    }
+    // Completely unknown namespace
+    throw new BROParseError(`Unsupported schema: ${namespace}`, {
+        code: 'UNSUPPORTED_SCHEMA',
+        namespace,
+        supportedSchemas: {
+            CPT: SUPPORTED_VERSIONS.CPT.namespace,
+            'BHR-GT': SUPPORTED_VERSIONS['BHR-GT'].namespace,
+            'BHR-G': SUPPORTED_VERSIONS['BHR-G'].namespace,
+        },
+        hint: 'This does not appear to be a supported BRO XML document.',
+    });
+}
+/**
+ * Get version information from document (for informational purposes)
+ *
+ * @param doc - Parsed XML document
+ * @returns Version information or null if not detected
+ */
+export function getVersionInfo(doc) {
+    const rootElement = doc.documentElement;
+    const namespace = rootElement?.getAttribute('xmlns');
+    if (!namespace) {
+        return null;
+    }
+    // Check all known versions
+    for (const [type, versions] of Object.entries(KNOWN_VERSIONS)) {
+        for (const info of versions) {
+            if (namespace === info.namespace) {
+                return {
+                    type: type,
+                    version: info.version,
+                    namespace: info.namespace,
+                };
+            }
+        }
+    }
+    // Try to detect from namespace pattern
+    const detectedType = detectDataTypeFromNamespace(namespace);
+    if (detectedType) {
+        const version = extractVersionFromNamespace(namespace);
+        return {
+            type: detectedType,
+            version,
+            namespace,
+        };
+    }
+    return null;
+}
+//# sourceMappingURL=version-detector.js.map

package/dist/core/version-detector.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/** Default entry point is the browser implementation.
+ * For Node.js, use: import { BROParser } from 'bro-parser/node'
+ */
+export * from './browser.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;;GAEG;AACH,cAAc,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+/** Default entry point is the browser implementation.
+ * For Node.js, use: import { BROParser } from 'bro-parser/node'
+ */
+export * from './browser.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;;GAEG;AACH,cAAc,cAAc,CAAC"}

package/dist/namespaces.d.ts

@@ -0,0 +1,16 @@
+/**
+ * BRO XML namespace definitions
+ *
+ * Centralizes all namespace URIs and prefixes used in BRO documents.
+ */
+import type { Namespaces } from './types/index.js';
+/**
+ * Standard BRO namespace URIs
+ */
+export declare const BRO_NAMESPACES: Namespaces;
+/**
+ * List of known BRO namespace prefixes
+ * Used by NodeXMLAdapter for pre-populating the xpath library's namespace map
+ */
+export declare const KNOWN_BRO_PREFIXES: ReadonlyArray<string>;
+//# sourceMappingURL=namespaces.d.ts.map

package/dist/namespaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAqB5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAe3C,CAAC"}