@bedrock-engineer/bro-xml-parser 0.1.0

package/dist/namespaces.js

@@ -0,0 +1,48 @@
+/**
+ * BRO XML namespace definitions
+ *
+ * Centralizes all namespace URIs and prefixes used in BRO documents.
+ */
+/**
+ * Standard BRO namespace URIs
+ */
+export const BRO_NAMESPACES = {
+    // CPT namespaces
+    dscpt: 'http://www.broservices.nl/xsd/dscpt/1.1',
+    brocom: 'http://www.broservices.nl/xsd/brocommon/3.0',
+    cptcommon: 'http://www.broservices.nl/xsd/cptcommon/1.1',
+    // Bore namespaces (BHR-GT dsbhr-gt/2.1)
+    dsbhrgt: 'http://www.broservices.nl/xsd/dsbhr-gt/2.1',
+    bhrcommon: 'http://www.broservices.nl/xsd/bhrcommon/1.1',
+    bhrgt: 'http://www.broservices.nl/xsd/bhrgt/1.1',
+    bhrgtcom: 'http://www.broservices.nl/xsd/bhrgtcommon/2.1',
+    // BHR-G namespaces (dsbhrg/3.1)
+    dsbhrg: 'http://www.broservices.nl/xsd/dsbhrg/3.1',
+    bhrgcom: 'http://www.broservices.nl/xsd/bhrgcommon/3.1',
+    // Common geospatial namespaces
+    gml: 'http://www.opengis.net/gml/3.2',
+    swe: 'http://www.opengis.net/swe/2.0',
+    om: 'http://www.opengis.net/om/2.0',
+    sampling: 'http://www.opengis.net/sampling/2.0'
+};
+/**
+ * List of known BRO namespace prefixes
+ * Used by NodeXMLAdapter for pre-populating the xpath library's namespace map
+ */
+export const KNOWN_BRO_PREFIXES = [
+    'dscpt',
+    'brocom',
+    'cptcommon',
+    'gml',
+    'swe',
+    'om',
+    'sampling',
+    'dsbhr',
+    'dsbhrgt',
+    'bhrcommon',
+    'bhrgt',
+    'bhrgtcom',
+    'dsbhrg',
+    'bhrgcom'
+];
+//# sourceMappingURL=namespaces.js.map

package/dist/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,iBAAiB;IACjB,KAAK,EAAE,yCAAyC;IAChD,MAAM,EAAE,6CAA6C;IACrD,SAAS,EAAE,6CAA6C;IAExD,wCAAwC;IACxC,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,6CAA6C;IACxD,KAAK,EAAE,yCAAyC;IAChD,QAAQ,EAAE,+CAA+C;IAEzD,gCAAgC;IAChC,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,8CAA8C;IAEvD,+BAA+B;IAC/B,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,gCAAgC;IACrC,EAAE,EAAE,+BAA+B;IACnC,QAAQ,EAAE,qCAAqC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,OAAO;IACP,QAAQ;IACR,WAAW;IACX,KAAK;IACL,KAAK;IACL,IAAI;IACJ,UAAU;IACV,OAAO;IACP,SAAS;IACT,WAAW;IACX,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;CACD,CAAC"}

package/dist/node.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Node.js entry point for BRO Parser
+ *
+ * Uses @xmldom/xmldom for DOM parsing and fontoxpath for XPath evaluation.
+ *
+ * Usage:
+ * ```typescript
+ * import { BROParser, XMLAdapter } from 'bro-parser';
+ *
+ * const parser = new BROParser(new XMLAdapter());
+ * const cptData = parser.parseCPT(xmlString);
+ * ```
+ */
+export { BROParser } from "./parser.js";
+export { NodeXMLAdapter as XMLAdapter } from "./adapters/node-adapter.js";
+export type { CPTData, CPTMeasurement, BHRGTData, BHRGTLayer, Grainshape, BHRGData, BHRGLayer, BROData, BROFileType, Location, ParseMeta, Schema, SchemaField, ResolverFunction, ResolverContext, Namespaces, BoreholeSampleAnalysis, InvestigatedInterval, ParticleSizeDistributionDetermination, ConsistencyLimitsDetermination, SettlementCharacteristicsDetermination, SaturatedPermeabilityDetermination, SaturatedPermeabilityAtSpecificDensity, ShearStressChangeDuringLoadingDetermination, SettlementDeterminationStep, ShearStressAtSpecificStrain, } from "./types/index.js";
+export { BROParseError } from "./types/index.js";
+export { SUPPORTED_VERSIONS } from "./core/version-detector.js";
+export type { DataType } from "./core/version-detector.js";
+export { CPT_SCHEMA } from "./schemas/cpt-schema.js";
+export { BORE_SCHEMA } from "./schemas/bore-schema.js";
+export { BHRG_SCHEMA } from "./schemas/bhrg-schema.js";
+export { BRO_NAMESPACES, KNOWN_BRO_PREFIXES } from "./namespaces.js";
+export { BRO_SOIL_COLORS, getSoilColor, isValidSoilColor, getSoilColorNames } from './colors.js';
+export * from './reference-codes/index.js';
+export * as resolvers from './resolvers.js';
+export * as presets from './schema-presets.js';
+//# sourceMappingURL=node.d.ts.map

package/dist/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1E,YAAY,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,sCAAsC,EACtC,2CAA2C,EAC3C,2BAA2B,EAC3B,2BAA2B,GAC5B,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGjG,cAAc,4BAA4B,CAAC;AAG3C,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAG5C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}

package/dist/node.js

@@ -0,0 +1,29 @@
+/**
+ * Node.js entry point for BRO Parser
+ *
+ * Uses @xmldom/xmldom for DOM parsing and fontoxpath for XPath evaluation.
+ *
+ * Usage:
+ * ```typescript
+ * import { BROParser, XMLAdapter } from 'bro-parser';
+ *
+ * const parser = new BROParser(new XMLAdapter());
+ * const cptData = parser.parseCPT(xmlString);
+ * ```
+ */
+export { BROParser } from "./parser.js";
+export { NodeXMLAdapter as XMLAdapter } from "./adapters/node-adapter.js";
+export { BROParseError } from "./types/index.js";
+export { SUPPORTED_VERSIONS } from "./core/version-detector.js";
+export { CPT_SCHEMA } from "./schemas/cpt-schema.js";
+export { BORE_SCHEMA } from "./schemas/bore-schema.js";
+export { BHRG_SCHEMA } from "./schemas/bhrg-schema.js";
+export { BRO_NAMESPACES, KNOWN_BRO_PREFIXES } from "./namespaces.js";
+export { BRO_SOIL_COLORS, getSoilColor, isValidSoilColor, getSoilColorNames } from './colors.js';
+// Re-export all BRO reference codes (generated from BRO API)
+export * from './reference-codes/index.js';
+// Export resolvers for custom schema definitions
+export * as resolvers from './resolvers.js';
+// Export schema presets for common use cases
+export * as presets from './schema-presets.js';
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA+B1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjG,6DAA6D;AAC7D,cAAc,4BAA4B,CAAC;AAE3C,iDAAiD;AACjD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,6CAA6C;AAC7C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,180 @@
+/**
+ * BRO Parser - Main parser class
+ *
+ * Uses dependency injection to work with any XMLAdapter implementation.
+ * The adapter is provided at construction time, making testing and
+ * environment-specific behavior explicit.
+ */
+import type { XMLAdapter, Namespaces, CPTData, BHRGTData, BHRGData, BROData, ParseMeta, Schema, BROFileType } from './types/index.js';
+/**
+ * Main BRO Parser class
+ *
+ * Usage:
+ * ```typescript
+ * import { BROParser, XMLAdapter } from 'bro-parser';
+ *
+ * const parser = new BROParser(new XMLAdapter());
+ * const cptData = parser.parseCPT(xmlString);
+ *
+ * // Check for warnings
+ * if (cptData.meta.warnings.length > 0) {
+ *   console.warn('Parse warnings:', cptData.meta.warnings);
+ * }
+ * ```
+ */
+export declare class BROParser {
+    private adapter;
+    private parser;
+    /**
+     * Create a BRO parser instance
+     *
+     * @param adapter - XML adapter for the target environment (browser/Node.js)
+     * @param namespaces - Optional namespace overrides (defaults to BRO_NAMESPACES)
+     */
+    constructor(adapter: XMLAdapter, namespaces?: Namespaces);
+    /**
+     * Create ParseMeta from version detection result
+     */
+    private createMeta;
+    /**
+     * Parse CPT data from BRO/XML string
+     *
+     * Extracts all 41 metadata fields and measurement data following
+     * the IMBRO CPT schema (dscpt/1.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed CPT data with metadata and measurements
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const cptData = parser.parseCPT(xmlString);
+     *
+     * console.log(cptData.bro_id);              // "CPT000000155283"
+     * console.log(cptData.final_depth);          // 10.5
+     * console.log(cptData.data.length);          // 525 measurements
+     * console.log(cptData.data[0].coneResistance); // 1.234
+     * console.log(cptData.meta.schemaVersion);   // "1.1"
+     * ```
+     */
+    parseCPT(xmlText: string): CPTData;
+    /**
+     * Parse Bore (borehole) data from BRO/XML string
+     *
+     * Extracts metadata and layer information following
+     * the IMBRO Bore schema (dsbhr-gt/2.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed BHR-GT data with metadata and soil layers
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const BHRGTData = parser.parseBHRGT(xmlString);
+     *
+     * console.log(BHRGTData.bro_id);              // "BHR000000123456"
+     * console.log(BHRGTData.final_bore_depth);    // 5.5
+     * console.log(BHRGTData.data.length);         // 8 layers
+     * console.log(BHRGTData.data[0].geotechnicalSoilName); // "zand"
+     * console.log(BHRGTData.meta.schemaVersion);  // "2.1"
+     * ```
+     */
+    parseBHRGT(xmlText: string): BHRGTData;
+    /**
+     * Parse BHR-G (Geological Borehole) data from BRO/XML string
+     *
+     * Extracts metadata and layer information following
+     * the IMBRO BHR-G schema (dsbhrg/3.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed BHR-G data with metadata and soil layers
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const BHRGData = parser.parseBHRG(xmlString);
+     *
+     * console.log(BHRGData.bro_id);              // "BHR000000123456"
+     * console.log(BHRGData.final_bore_depth);    // 3.0
+     * console.log(BHRGData.data.length);         // 5 layers
+     * console.log(BHRGData.data[0].soilNameNEN5104); // "zwakZandigeKlei"
+     * console.log(BHRGData.meta.schemaVersion);  // "3.1"
+     * ```
+     */
+    parseBHRG(xmlText: string): BHRGData;
+    /**
+     * Parse any BRO XML document, auto-detecting the data type
+     *
+     * This is the recommended entry point when you don't know the file type
+     * in advance. The method detects the data type from the XML namespace
+     * and calls the appropriate parser.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed data (CPTData, BHRGTData, or BHRGData)
+     * @throws {BROParseError} If parsing fails or data type is unknown
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const data = parser.parse(xmlString);
+     *
+     * // Use meta.dataType to discriminate
+     * switch (data.meta.dataType) {
+     *   case 'CPT':
+     *     console.log(data.final_depth);
+     *     break;
+     *   case 'BHR-GT':
+     *   case 'BHR-G':
+     *     console.log(data.final_bore_depth);
+     *     break;
+     * }
+     * ```
+     */
+    parse(xmlText: string): BROData;
+    /**
+     * Parse BRO XML with a custom schema for selective extraction
+     *
+     * This allows you to extract only the fields you need, which can be
+     * more efficient and gives you full control over the output structure.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @param schema - Custom schema defining fields to extract
+     * @param dataType - The BRO data type (for version validation)
+     * @returns Object with extracted fields matching your schema
+     *
+     * @example
+     * ```typescript
+     * import { BROParser, resolvers } from 'bro-parser';
+     *
+     * const parser = new BROParser(new XMLAdapter());
+     *
+     * // Define only the fields you need
+     * const mySchema = {
+     *   id: { xpath: 'brocom:broId' },
+     *   depth: {
+     *     xpath: './/cptcommon:finalDepth',
+     *     resolver: resolvers.parseFloat
+     *   },
+     *   location: {
+     *     xpath: './dscpt:deliveredLocation/cptcommon:location',
+     *     resolver: resolvers.parseGMLLocation
+     *   }
+     * };
+     *
+     * const result = parser.parseCustom(xmlText, mySchema, 'CPT');
+     * // { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "EPSG:28992" } }
+     * ```
+     */
+    parseCustom<T = Record<string, unknown>>(xmlText: string, schema: Schema, dataType?: BROFileType): T & {
+        meta: ParseMeta;
+    };
+    /**
+     * Get the underlying XML adapter
+     * (useful for advanced use cases or testing)
+     */
+    getAdapter(): XMLAdapter;
+}
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAe;IAE7B;;;;;OAKG;gBACS,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU;IAKxD;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAelC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAetC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAepC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAqB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,WAAW,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,WAAW,GACrB,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IA6B1B;;;OAGG;IACH,UAAU,IAAI,UAAU;CAGzB"}

package/dist/parser.js

@@ -0,0 +1,256 @@
+/**
+ * BRO Parser - Main parser class
+ *
+ * Uses dependency injection to work with any XMLAdapter implementation.
+ * The adapter is provided at construction time, making testing and
+ * environment-specific behavior explicit.
+ */
+import { SchemaParser } from './core/schema-parser.js';
+import { detectAndValidateVersion, getVersionInfo, } from './core/version-detector.js';
+import { CPT_SCHEMA } from './schemas/cpt-schema.js';
+import { BORE_SCHEMA } from './schemas/bore-schema.js';
+import { BHRG_SCHEMA } from './schemas/bhrg-schema.js';
+import { BRO_NAMESPACES } from './namespaces.js';
+import { BROParseError } from './types/index.js';
+/**
+ * Main BRO Parser class
+ *
+ * Usage:
+ * ```typescript
+ * import { BROParser, XMLAdapter } from 'bro-parser';
+ *
+ * const parser = new BROParser(new XMLAdapter());
+ * const cptData = parser.parseCPT(xmlString);
+ *
+ * // Check for warnings
+ * if (cptData.meta.warnings.length > 0) {
+ *   console.warn('Parse warnings:', cptData.meta.warnings);
+ * }
+ * ```
+ */
+export class BROParser {
+    /**
+     * Create a BRO parser instance
+     *
+     * @param adapter - XML adapter for the target environment (browser/Node.js)
+     * @param namespaces - Optional namespace overrides (defaults to BRO_NAMESPACES)
+     */
+    constructor(adapter, namespaces) {
+        this.adapter = adapter;
+        this.parser = new SchemaParser(adapter, namespaces ?? BRO_NAMESPACES);
+    }
+    /**
+     * Create ParseMeta from version detection result
+     */
+    createMeta(versionResult) {
+        // Log warnings to console
+        for (const warning of versionResult.warnings) {
+            console.warn(`[BROParser] ${warning}`);
+        }
+        return {
+            schemaVersion: versionResult.version,
+            schemaNamespace: versionResult.namespace,
+            dataType: versionResult.dataType,
+            warnings: versionResult.warnings,
+        };
+    }
+    /**
+     * Parse CPT data from BRO/XML string
+     *
+     * Extracts all 41 metadata fields and measurement data following
+     * the IMBRO CPT schema (dscpt/1.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed CPT data with metadata and measurements
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const cptData = parser.parseCPT(xmlString);
+     *
+     * console.log(cptData.bro_id);              // "CPT000000155283"
+     * console.log(cptData.final_depth);          // 10.5
+     * console.log(cptData.data.length);          // 525 measurements
+     * console.log(cptData.data[0].coneResistance); // 1.234
+     * console.log(cptData.meta.schemaVersion);   // "1.1"
+     * ```
+     */
+    parseCPT(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionResult = detectAndValidateVersion(doc, 'CPT');
+        const meta = this.createMeta(versionResult);
+        const data = this.parser.parse(doc, CPT_SCHEMA, 'dispatchDocument');
+        return { meta, ...data };
+    }
+    /**
+     * Parse Bore (borehole) data from BRO/XML string
+     *
+     * Extracts metadata and layer information following
+     * the IMBRO Bore schema (dsbhr-gt/2.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed BHR-GT data with metadata and soil layers
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const BHRGTData = parser.parseBHRGT(xmlString);
+     *
+     * console.log(BHRGTData.bro_id);              // "BHR000000123456"
+     * console.log(BHRGTData.final_bore_depth);    // 5.5
+     * console.log(BHRGTData.data.length);         // 8 layers
+     * console.log(BHRGTData.data[0].geotechnicalSoilName); // "zand"
+     * console.log(BHRGTData.meta.schemaVersion);  // "2.1"
+     * ```
+     */
+    parseBHRGT(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionResult = detectAndValidateVersion(doc, 'BHR-GT');
+        const meta = this.createMeta(versionResult);
+        const data = this.parser.parse(doc, BORE_SCHEMA, 'dispatchDocument');
+        return { meta, ...data };
+    }
+    /**
+     * Parse BHR-G (Geological Borehole) data from BRO/XML string
+     *
+     * Extracts metadata and layer information following
+     * the IMBRO BHR-G schema (dsbhrg/3.1).
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed BHR-G data with metadata and soil layers
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const BHRGData = parser.parseBHRG(xmlString);
+     *
+     * console.log(BHRGData.bro_id);              // "BHR000000123456"
+     * console.log(BHRGData.final_bore_depth);    // 3.0
+     * console.log(BHRGData.data.length);         // 5 layers
+     * console.log(BHRGData.data[0].soilNameNEN5104); // "zwakZandigeKlei"
+     * console.log(BHRGData.meta.schemaVersion);  // "3.1"
+     * ```
+     */
+    parseBHRG(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionResult = detectAndValidateVersion(doc, 'BHR-G');
+        const meta = this.createMeta(versionResult);
+        const data = this.parser.parse(doc, BHRG_SCHEMA, 'dispatchDocument');
+        return { meta, ...data };
+    }
+    /**
+     * Parse any BRO XML document, auto-detecting the data type
+     *
+     * This is the recommended entry point when you don't know the file type
+     * in advance. The method detects the data type from the XML namespace
+     * and calls the appropriate parser.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed data (CPTData, BHRGTData, or BHRGData)
+     * @throws {BROParseError} If parsing fails or data type is unknown
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const data = parser.parse(xmlString);
+     *
+     * // Use meta.dataType to discriminate
+     * switch (data.meta.dataType) {
+     *   case 'CPT':
+     *     console.log(data.final_depth);
+     *     break;
+     *   case 'BHR-GT':
+     *   case 'BHR-G':
+     *     console.log(data.final_bore_depth);
+     *     break;
+     * }
+     * ```
+     */
+    parse(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionInfo = getVersionInfo(doc);
+        if (!versionInfo) {
+            throw new BROParseError('Unable to detect BRO data type from XML document', { code: 'UNKNOWN_DATA_TYPE' });
+        }
+        switch (versionInfo.type) {
+            case 'CPT':
+                return this.parseCPT(xmlText);
+            case 'BHR-GT':
+                return this.parseBHRGT(xmlText);
+            case 'BHR-G':
+                return this.parseBHRG(xmlText);
+        }
+    }
+    /**
+     * Parse BRO XML with a custom schema for selective extraction
+     *
+     * This allows you to extract only the fields you need, which can be
+     * more efficient and gives you full control over the output structure.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @param schema - Custom schema defining fields to extract
+     * @param dataType - The BRO data type (for version validation)
+     * @returns Object with extracted fields matching your schema
+     *
+     * @example
+     * ```typescript
+     * import { BROParser, resolvers } from 'bro-parser';
+     *
+     * const parser = new BROParser(new XMLAdapter());
+     *
+     * // Define only the fields you need
+     * const mySchema = {
+     *   id: { xpath: 'brocom:broId' },
+     *   depth: {
+     *     xpath: './/cptcommon:finalDepth',
+     *     resolver: resolvers.parseFloat
+     *   },
+     *   location: {
+     *     xpath: './dscpt:deliveredLocation/cptcommon:location',
+     *     resolver: resolvers.parseGMLLocation
+     *   }
+     * };
+     *
+     * const result = parser.parseCustom(xmlText, mySchema, 'CPT');
+     * // { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "EPSG:28992" } }
+     * ```
+     */
+    parseCustom(xmlText, schema, dataType) {
+        const doc = this.adapter.parseXML(xmlText);
+        // Validate version if dataType is provided
+        let meta;
+        if (dataType) {
+            const versionResult = detectAndValidateVersion(doc, dataType);
+            meta = this.createMeta(versionResult);
+        }
+        else {
+            // Auto-detect type
+            const versionInfo = getVersionInfo(doc);
+            if (versionInfo) {
+                const versionResult = detectAndValidateVersion(doc, versionInfo.type);
+                meta = this.createMeta(versionResult);
+            }
+            else {
+                meta = {
+                    schemaVersion: 'unknown',
+                    schemaNamespace: 'unknown',
+                    dataType: 'CPT', // fallback
+                    warnings: ['Could not detect BRO data type'],
+                };
+            }
+        }
+        const data = this.parser.parse(doc, schema, 'dispatchDocument');
+        return { meta, ...data };
+    }
+    /**
+     * Get the underlying XML adapter
+     * (useful for advanced use cases or testing)
+     */
+    getAdapter() {
+        return this.adapter;
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

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

package/dist/reference-codes/bhrg-activity-type.d.ts

@@ -0,0 +1,15 @@
+/**
+ * ActivityType codes and descriptions from the official BRO reference.
+ *
+ * @generated from urn:bro:bhrg:ActivityType
+ * @see https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn%3Abro%3Abhrg%3AActivityType
+ */
+export declare const BHRG_ACTIVITY_TYPE_CODES: Record<string, string>;
+/**
+ * Get the Dutch description for a ActivityType code.
+ *
+ * @param code - The code value
+ * @returns The Dutch description, or undefined if the code is not recognized
+ */
+export declare function getBhrgActivityTypeDescription(code: string): string | undefined;
+//# sourceMappingURL=bhrg-activity-type.d.ts.map

package/dist/reference-codes/bhrg-activity-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bhrg-activity-type.d.ts","sourceRoot":"","sources":["../../src/reference-codes/bhrg-activity-type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAK3D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE/E"}

package/dist/reference-codes/bhrg-activity-type.js

@@ -0,0 +1,22 @@
+/**
+ * ActivityType codes and descriptions from the official BRO reference.
+ *
+ * @generated from urn:bro:bhrg:ActivityType
+ * @see https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn%3Abro%3Abhrg%3AActivityType
+ */
+export const BHRG_ACTIVITY_TYPE_CODES = {
+    gecontroleerdAangebracht: 'Opgebracht materiaal dat tot een bepaalde graad verdicht is (engineered fill).',
+    geroerd: 'De natuurlijke samenhang van de grond is door ploegen of andere vormen van omwoelen verstoord.',
+    losGestort: 'Opgebracht materiaal dat los gestort is.',
+    nietBepaald: 'De wijze waarop de mens in de opbouw van de ondergrond heeft ingegrepen, kon niet worden bepaald.',
+};
+/**
+ * Get the Dutch description for a ActivityType code.
+ *
+ * @param code - The code value
+ * @returns The Dutch description, or undefined if the code is not recognized
+ */
+export function getBhrgActivityTypeDescription(code) {
+    return BHRG_ACTIVITY_TYPE_CODES[code];
+}
+//# sourceMappingURL=bhrg-activity-type.js.map

package/dist/reference-codes/bhrg-activity-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bhrg-activity-type.js","sourceRoot":"","sources":["../../src/reference-codes/bhrg-activity-type.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,wBAAwB,GAA2B;IAC9D,wBAAwB,EAAE,gFAAgF;IAC1G,OAAO,EAAE,gGAAgG;IACzG,UAAU,EAAE,0CAA0C;IACtD,WAAW,EAAE,mGAAmG;CACjH,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,8BAA8B,CAAC,IAAY;IACzD,OAAO,wBAAwB,CAAC,IAAI,CAAC,CAAC;AACxC,CAAC"}

package/dist/reference-codes/bhrg-analysis-procedure.d.ts

@@ -0,0 +1,15 @@
+/**
+ * AnalysisProcedure codes and descriptions from the official BRO reference.
+ *
+ * @generated from urn:bro:bhrg:AnalysisProcedure
+ * @see https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn%3Abro%3Abhrg%3AAnalysisProcedure
+ */
+export declare const BHRG_ANALYSIS_PROCEDURE_CODES: Record<string, string>;
+/**
+ * Get the Dutch description for a AnalysisProcedure code.
+ *
+ * @param code - The code value
+ * @returns The Dutch description, or undefined if the code is not recognized
+ */
+export declare function getBhrgAnalysisProcedureDescription(code: string): string | undefined;
+//# sourceMappingURL=bhrg-analysis-procedure.d.ts.map

package/dist/reference-codes/bhrg-analysis-procedure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bhrg-analysis-procedure.d.ts","sourceRoot":"","sources":["../../src/reference-codes/bhrg-analysis-procedure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,eAAO,MAAM,6BAA6B,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAGhE,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEpF"}

package/dist/reference-codes/bhrg-analysis-procedure.js

@@ -0,0 +1,20 @@
+/**
+ * AnalysisProcedure codes and descriptions from the official BRO reference.
+ *
+ * @generated from urn:bro:bhrg:AnalysisProcedure
+ * @see https://publiek.broservices.nl/bro/refcodes/v1/codes?domain=urn%3Abro%3Abhrg%3AAnalysisProcedure
+ */
+export const BHRG_ANALYSIS_PROCEDURE_CODES = {
+    GDNpraktijkrichtlijnv2023: 'De boormonsteranalyse is uitgevoerd conform de praktijkrichtlijn van de Geologische Dienst Nederland, versie 2023.',
+    geen: 'De boormonsteranalyse is niet volgens een praktijkrichtlijn uitgevoerd.',
+};
+/**
+ * Get the Dutch description for a AnalysisProcedure code.
+ *
+ * @param code - The code value
+ * @returns The Dutch description, or undefined if the code is not recognized
+ */
+export function getBhrgAnalysisProcedureDescription(code) {
+    return BHRG_ANALYSIS_PROCEDURE_CODES[code];
+}
+//# sourceMappingURL=bhrg-analysis-procedure.js.map

package/dist/reference-codes/bhrg-analysis-procedure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bhrg-analysis-procedure.js","sourceRoot":"","sources":["../../src/reference-codes/bhrg-analysis-procedure.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAA2B;IACnE,yBAAyB,EAAE,oHAAoH;IAC/I,IAAI,EAAE,yEAAyE;CAChF,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CAAC,IAAY;IAC9D,OAAO,6BAA6B,CAAC,IAAI,CAAC,CAAC;AAC7C,CAAC"}