@bedrock-engineer/bro-xml-parser 0.1.7 → 0.3.0

package/dist/types/index.d.ts

@@ -141,18 +141,44 @@ export interface DissipationMeasurement {
  */
 export interface DissipationTest {
     penetrationLength: number;
-    phenomenonTime: Date | null;
+    phenomenonTime: string | null;
     measurements: Array<DissipationMeasurement>;
 }
+/**
+ * Common `brocom:RegistrationObject` fields shared by every BRO registration
+ * type (CPT, BHR-GT, BHR-G, ...).
+ *
+ * Mirrors how the XSDs model these: each registration object extends
+ * `brocom:RegistrationObject` via complexContent. Domain data interfaces extend
+ * this so the shared surface is declared once and stays consistent. The runtime
+ * counterpart is `COMMON_REGISTRATION_FIELDS` in schemas/common-fields.ts.
+ */
+export interface BRORegistrationObject {
+    broId: string | null;
+    /**
+     * BRO quality regime
+     *
+     * - IMBRO: Strict regime (all mandatory fields required)
+     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
+     */
+    qualityRegime: QualityRegime | null;
+    /** Party responsible for delivering the data to the BRO (bronhouder, KvK number or name) */
+    deliveryAccountableParty: string | null;
+    /** Object identifier assigned by the accountable party (their own reference) */
+    objectIdAccountableParty: string | null;
+    /** KvK number of the party responsible for the delivery */
+    deliveryResponsibleParty: string | null;
+    /** BRO registration history */
+    registrationHistory: RegistrationHistory | null;
+}
 /**
  * Complete CPT data (metadata + measurements)
  */
-export interface CPTData {
+export interface CPTData extends BRORegistrationObject {
     /**
      * Metadata about the parsed document (schema version, warnings)
      */
     meta: ParseMeta;
-    broId: string | null;
     /**
      * User-defined identifier (not parsed from XML)
      *
@@ -166,31 +192,34 @@ export interface CPTData {
      * ```
      */
     alias?: string;
-    /**
-     * BRO quality regime
-     *
-     * - IMBRO: Strict regime (all mandatory fields required)
-     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
-     */
-    qualityRegime: QualityRegime | null;
-    researchReportDate: Date | null;
+    /** KvK number of the operator that carried out the research */
+    researchOperator: string | null;
+    researchReportDate: string | null;
     /** When the cone penetration test was physically performed in the field (om:phenomenonTime) */
-    conePenetrationTestPhenomenonTime: Date | null;
+    conePenetrationTestPhenomenonTime: string | null;
     /** When the cone penetration test result was produced (om:resultTime) */
-    conePenetrationTestResultTime: Date | null;
+    conePenetrationTestResultTime: string | null;
     deliveredLocation: Location | null;
     standardizedLocation: Location | null;
+    /** Coordinate transformation applied to the standardized location (e.g. "RDNAPTRANS2018") */
+    coordinateTransformation: string | null;
     /** Date horizontal position was determined */
-    horizontalPositioningDate: Date | null;
+    horizontalPositioningDate: string | null;
     /** Method used to determine horizontal position (e.g., "onbekend", "GNSS") */
     horizontalPositioningMethod: string | null;
+    /** KvK number of the operator that determined the horizontal position */
+    horizontalPositioningOperator: string | null;
     deliveredVerticalPositionOffset: number | null;
     deliveredVerticalPositionDatum: string | null;
     deliveredVerticalPositionReferencePoint: string | null;
+    /** Water depth at the CPT location (m), when the survey was performed over water */
+    waterDepth: number | null;
     /** Date vertical position was determined */
-    verticalPositioningDate: Date | null;
+    verticalPositioningDate: string | null;
     /** Method used to determine vertical position (e.g., "onbekend", "waterpassingKlasse2") */
     verticalPositioningMethod: string | null;
+    /** KvK number of the operator that determined the vertical position */
+    verticalPositioningOperator: string | null;
     /** Delivery context (e.g., "publiekeTaak", "archiefoverdracht") */
     deliveryContext: string | null;
     /** Survey purpose (e.g., "waterkering", "onbekend") */
@@ -210,7 +239,7 @@ export interface CPTData {
     finalDepth: number | null;
     groundwaterLevel: number | null;
     /** Date of additional investigation (e.g. groundwater level measurement) */
-    investigationDate: Date | null;
+    investigationDate: string | null;
     /** Site conditions at time of investigation */
     conditions: string | null;
     /** Description of surface at CPT location */
@@ -218,7 +247,7 @@ export interface CPTData {
     /** Layers removed before CPT (e.g. asphalt, gravel fill) - affects depth interpretation */
     removedLayers: Array<RemovedLayer>;
     /** Date of final processing */
-    finalProcessingDate: Date | null;
+    finalProcessingDate: string | null;
     /** Whether signal processing was performed */
     signalProcessingPerformed: boolean | null;
     /** Whether interruption processing was performed */
@@ -255,7 +284,6 @@ export interface CPTData {
     zlmElectricalConductivityAfter: number | null;
     data: Array<CPTMeasurement>;
     dissipationTests: Array<DissipationTest>;
-    registrationHistory: RegistrationHistory | null;
 }
 /**
  * Grain shape properties for sand/gravel fractions
@@ -270,19 +298,105 @@ export interface Grainshape {
     /** Roughness of grains (e.g., "ruw", "glad") */
     roughness: string | null;
 }
+/**
+ * Weathering degree of a rock layer (three-axis classification)
+ */
+export interface RockWeatheringDegree {
+    /** Degree of discolouration */
+    discolouration: string | null;
+    /** Degree of disintegration */
+    disintegration: string | null;
+    /** Degree of decomposition */
+    decomposition: string | null;
+}
+/**
+ * Rock description for a layer (BHR-GT `rock` element).
+ *
+ * A layer describes either soil (flattened onto BHRGTLayer) or rock (this
+ * nested object). Yes/no fields keep their raw code (e.g. "ja", "nee",
+ * "nietWaargenomen") to preserve archive nuance.
+ */
+export interface RockDescription {
+    rockType: string | null;
+    cementType: string | null;
+    colour: string | null;
+    /** Tertiary rock constituents (1 or more) */
+    tertiaryRockConstituent: Array<string>;
+    interbedding: string | null;
+    /** Dispersed inhomogeneities (0-2) */
+    dispersedInhomogeneity: Array<string>;
+    carbonateContentClass: string | null;
+    crossBedding: string | null;
+    gradedBedding: string | null;
+    voidsPresent: string | null;
+    voidDistribution: string | null;
+    stability: string | null;
+    strengthClass: string | null;
+    weathered: string | null;
+    weatheringDegree?: RockWeatheringDegree;
+}
+/**
+ * Post-sedimentary discontinuity in the descriptive borehole log
+ * (e.g. a fracture or fault plane crossing the described interval)
+ */
+export interface PostSedimentaryDiscontinuity {
+    beginDepth: number;
+    endDepth: number;
+    /** Whether the discontinuity is in rock (raw code, e.g. "ja"/"nee") */
+    inRock: string | null;
+    discontinuityType: string | null;
+    compositeDiscontinuity: string | null;
+    /** Spacing between discontinuities (m) */
+    spacing: number | null;
+    smooth: string | null;
+    apertureClass: string | null;
+    infillMaterial: string | null;
+}
 /**
  * BHR-GT (Borehole Research Geotechnical) layer data
  *
  * Contains all fields from the BRO BHR-GT schema for a single soil layer.
  */
-export interface BHRGTLayer {
+/**
+ * Fields shared by every BHR-GT described layer, regardless of whether it
+ * describes soil or rock (they live directly on the XSD `layer` element).
+ */
+export interface BHRGTLayerBase {
     upperBoundary: number;
     lowerBoundary: number;
     upperBoundaryDetermination?: string | null;
     lowerBoundaryDetermination?: string | null;
     /** Whether the layer is anthropogenic (man-made) */
     anthropogenic?: boolean | null;
+    /** Whether the layer boundary is slanted */
+    slant?: boolean | null;
+    /** Whether the layer is bedded/stratified */
+    bedded?: boolean | null;
+    /** Bedding type of the layer (e.g., "dikGelamineerd") */
+    bedding?: string | null;
+    /** Whether the layer is a composite layer */
+    compositeLayer?: boolean | null;
+    /** Human activity type observed in the layer (e.g., "nietBepaald") */
+    activityType?: string | null;
+    /** Whether the internal structure is intact (undisturbed) */
+    internalStructureIntact?: boolean | null;
+    /** Special material in the layer (e.g. anthropogenic debris) */
+    specialMaterial?: string | null;
+}
+/**
+ * A BHR-GT layer that describes soil (the common case).
+ * Discriminate on `material === "soil"`.
+ */
+export interface BHRGTSoilLayer extends BHRGTLayerBase {
+    material: "soil";
+    /** Geotechnical soil name (may be "" for IMBRO/A archive data using NEN 5104) */
     geotechnicalSoilName: string;
+    /** Soil name per NEN 5104 (IMBRO/A archive data; geotechnicalSoilName is often nil there) */
+    soilNameNEN5104?: string | null;
+    /** Gravel content classification per NEN 5104 (IMBRO/A) */
+    gravelContentClassNEN5104?: string | null;
+    /** Organic matter content classification per NEN 5104 (IMBRO/A) */
+    organicMatterContentClassNEN5104?: string | null;
     /** Tertiary soil constituent (e.g., "schelpMateriaal", "plantenresten") */
     tertiaryConstituent?: string | null;
     /** Soil color code */
@@ -295,14 +409,14 @@ export interface BHRGTLayer {
     carbonateContentClass?: string | null;
     /** Sand median grain size classification */
     sandMedianClass?: string | null;
+    /** Gravel median grain size classification (e.g., "fijn", "middelgrof") */
+    gravelMedianClass?: string | null;
+    /** Depositional characteristic of the soil (e.g., "nietBepaald") */
+    geotechnicalDepositionalCharacteristic?: string | null;
+    /** Interbedding of other material in the soil (e.g., "kleiWeinigDikkeLaminae") */
+    interbedding?: string | null;
     /** Grain shape properties (for sand/gravel) */
     grainshape?: Grainshape;
-    /** Whether the layer boundary is slanted */
-    slant?: boolean | null;
-    /** Whether the layer is bedded/stratified */
-    bedded?: boolean | null;
-    /** Whether the internal structure is intact (undisturbed) */
-    internalStructureIntact?: boolean | null;
     /** Whether the soil is mixed */
     mixed?: boolean | null;
     /** Whether the soil has mottled appearance */
@@ -315,19 +429,55 @@ export interface BHRGTLayer {
     organicSoilTexture?: string | null;
     /** Tensile strength of peat */
     peatTensileStrength?: string | null;
+    /** Cross bedding present (raw code) */
+    crossBedding?: string | null;
+    /** Graded bedding present (raw code) */
+    gradedBedding?: string | null;
+    /** Mixing type of the soil */
+    mixingType?: string | null;
+    /** Fine gravel content classification */
+    fineGravelContentClass?: string | null;
+    /** Medium-coarse gravel content classification */
+    mediumCoarseGravelContentClass?: string | null;
+    /** Very coarse gravel content classification */
+    veryCoarseGravelContentClass?: string | null;
+    /** Sand sorting classification per NEN 5104 */
+    sandSortingNEN5104?: string | null;
+    /** Peat type classification */
+    peatType?: string | null;
+    /** Depositional age of the layer */
+    depositionalAge?: string | null;
+}
+/**
+ * A BHR-GT layer that describes rock.
+ * Discriminate on `material === "rock"`.
+ */
+export interface BHRGTRockLayer extends BHRGTLayerBase {
+    material: "rock";
+    /** Rock description */
+    rock: RockDescription;
 }
+/**
+ * A BHR-GT described layer: either soil or rock.
+ *
+ * Narrow on the `material` discriminant:
+ * ```ts
+ * if (layer.material === "rock") layer.rock.rockType;
+ * else layer.geotechnicalSoilName;
+ * ```
+ */
+export type BHRGTLayer = BHRGTSoilLayer | BHRGTRockLayer;
 /**
  * Complete Bore data (metadata + layers)
  *
  * Note: BHRGTData represents BHR-GT-BMB (Boormonsterbeschrijving - visual/textural description)
  * For laboratory analysis data, see the optional `analysis` field (BHR-GT-BMA)
  */
-export interface BHRGTData {
+export interface BHRGTData extends BRORegistrationObject {
     /**
      * Metadata about the parsed document (schema version, warnings)
      */
     meta: ParseMeta;
-    broId: string | null;
     /**
      * User-defined identifier (not parsed from XML)
      *
@@ -341,29 +491,38 @@ export interface BHRGTData {
      * ```
      */
     alias?: string;
-    /**
-     * BRO quality regime
-     *
-     * - IMBRO: Strict regime (all mandatory fields required)
-     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
-     */
-    qualityRegime: QualityRegime | null;
-    researchReportDate: Date | null;
+    researchReportDate: string | null;
     deliveredLocation: Location | null;
     standardizedLocation: Location | null;
     deliveredVerticalPositionOffset: number | null;
     deliveredVerticalPositionDatum: string | null;
     deliveredVerticalPositionReferencePoint: string | null;
+    /** Soil use at the site (e.g., "akker", "grasland", "geenBodemgebruik") */
+    soilUse: string | null;
+    /** Position of the borehole on the ground body (e.g. "kruin", "talud") */
+    positionOnGroundBody: string | null;
+    /** Temporary change at the site at time of drilling (e.g. "geen") */
+    temporaryChange: string | null;
     descriptionProcedure: string | null;
     groundwaterLevel: number | null;
+    /** Mean highest groundwater level in m relative to local reference (GHG) */
+    meanHighestGroundwaterLevel: number | null;
+    /** Mean lowest groundwater level in m relative to local reference (GLG) */
+    meanLowestGroundwaterLevel: number | null;
     boreRockReached: boolean | null;
     finalBoreDepth: number | null;
     finalSampleDepth: number | null;
+    /** Final depth reached during site preparation (m) */
+    finalDepthPreparation: number | null;
+    /** Final depth reached by excavation (m) */
+    finalDepthExcavation: number | null;
+    /** Final depth reached with a temporary casing (m) */
+    finalDepthTemporaryCasing: number | null;
     boreHoleCompleted: boolean | null;
     /** Start date of the boring operation */
-    boringStartDate: Date | null;
+    boringStartDate: string | null;
     /** End date of the boring operation */
-    boringEndDate: Date | null;
+    boringEndDate: string | null;
     /** Boring procedure standard used (e.g., "EN1997d2v2007") */
     boringProcedure: string | null;
     /** Boring technique used (e.g., "gestoken", "mechanischGestoken") */
@@ -374,6 +533,16 @@ export interface BHRGTData {
     subsurfaceContaminated: boolean | null;
     /** Stop criterion for boring */
     stopCriterion: string | null;
+    /** Whether a flushing medium was used during boring */
+    flushingMediumUsed: boolean | null;
+    /** Flushing additive used during boring (e.g. "geen"), when a flushing medium was used */
+    flushingAdditive: string | null;
+    /** Whether a temporary casing was used during boring */
+    temporaryCasingUsed: boolean | null;
+    /** Site preparation before boring (e.g., "geen") */
+    preparation: string | null;
+    /** KvK number of the operator that carried out the research */
+    researchOperator: string | null;
     /** Type of sampler used */
     samplerType: string | null;
     /** Sampling procedure standard */
@@ -411,7 +580,7 @@ export interface BHRGTData {
     /** Description location (field/lab) */
     descriptionLocation: string | null;
     /** Date of description report */
-    descriptionReportDate: Date | null;
+    descriptionReportDate: string | null;
     /** Described material type */
     describedMaterial: string | null;
     /** Whether sampling was continuous */
@@ -428,8 +597,14 @@ export interface BHRGTData {
     completedIntervals: Array<CompletedInterval>;
     /** Array of intervals not described (with reason) */
     notDescribedIntervals: Array<NotDescribedInterval>;
-    /** BRO registration history */
-    registrationHistory: RegistrationHistory | null;
+    /** Array of post-sedimentary discontinuities in the descriptive log */
+    postSedimentaryDiscontinuities: Array<PostSedimentaryDiscontinuity>;
+    /** Array of excavated layers (removed by excavation) */
+    excavatedLayers: Array<ExcavatedLayer>;
+    /** Boring velocity profile (elapsed time vs depth) */
+    boringVelocity: Array<BoringVelocityMeasurement>;
+    /** Fluid mud (slib) layer at the borehole, when present */
+    fluidMudLayer?: FluidMudLayer;
     /** Report history with events */
     reportHistory: ReportHistory | null;
     /** Delivery context (e.g., "publiekeTaak") */
@@ -443,10 +618,139 @@ export interface BHRGTData {
     /** Whether site characteristics were determined */
     siteCharacteristicDetermined: boolean | null;
 }
+/** Munsell colour notation (BHR-G soil colour) */
+export interface MunsellColour {
+    munsellHue: string | null;
+    munsellValue: string | null;
+    munsellChroma: string | null;
+}
+/** A constituent of the sand fraction */
+export interface SandConstituent {
+    grainColour: string | null;
+    percentageClass: string | null;
+    archiveClass: string | null;
+}
+/** Sand fraction description (BHR-G soil) */
+export interface SandFraction {
+    darkGrainContentClass: string | null;
+    darkGrainContentClassArchive: string | null;
+    angularity: string | null;
+    sandMedianClass: string | null;
+    sandSorting: string | null;
+    variegation: string | null;
+    anomalouslyCoarseContentClass: string | null;
+    anomalouslyCoarseContentClassArchive: string | null;
+    granuleContentClass: string | null;
+    granuleContentClassArchive: string | null;
+    estimatedMedian: number | null;
+    sandConstituents: Array<SandConstituent>;
+}
+/** A constituent of the shell fraction */
+export interface ShellConstituent {
+    shellTaxon: string | null;
+    relativeAbundance: string | null;
+    relativeAbundanceClass: string | null;
+    relativeAbundanceClassArchive: string | null;
+}
+/** Shell fraction description (BHR-G soil) */
+export interface ShellFraction {
+    gritContentClass: string | null;
+    fragmentContentClass: string | null;
+    remainsContentClass: string | null;
+    wholeContentClass: string | null;
+    doublets: string | null;
+    thickWalledContentClass: string | null;
+    thinWalledContentClass: string | null;
+    inSitu: string | null;
+    weatheringDegree: string | null;
+    shellConstituents: Array<ShellConstituent>;
+}
+/** A constituent of the gravel fraction */
+export interface GravelConstituent {
+    gravelType: string | null;
+    fractionProportion: number | null;
+    archiveClass: string | null;
+}
+/** Gravel fraction description (BHR-G soil) */
+export interface GravelFraction {
+    gravelMedianClass: string | null;
+    angularity: string | null;
+    fineGravelContentClass: string | null;
+    mediumCoarseGravelContentClass: string | null;
+    veryCoarseGravelContentClass: string | null;
+    ventifactPresent: string | null;
+    sphericity: string | null;
+    variegation: string | null;
+    gravelProvenance: string | null;
+    estimatedMedian: number | null;
+    gravelConstituents: Array<GravelConstituent>;
+}
+/** A constituent of the peat fraction */
+export interface PeatConstituent {
+    plantRemainType: string | null;
+    percentageClass: string | null;
+    archiveClass: string | null;
+}
+/** Peat fraction description (BHR-G soil) */
+export interface PeatFraction {
+    peatType: string | null;
+    peatConstituents: Array<PeatConstituent>;
+}
+/** A chunk (brok) of differing material within a layer */
+export interface Chunk {
+    soilType: string | null;
+    sizeClass: string | null;
+    percentageClass: string | null;
+    archiveClass: string | null;
+    colour: string | null;
+    geologicalOrigin: string | null;
+    cemented: string | null;
+}
+/** Fine fraction distribution for organic soils (mass proportions, %) */
+export interface FineFractionDistributionOrganicSoil {
+    estimatedMassProportionSand: number | null;
+    estimatedMassProportionSilt: number | null;
+    estimatedMassProportionLutum: number | null;
+}
+/** Fine fraction distribution for shelly soils (volume proportions, %) */
+export interface FineFractionDistributionShellySoil {
+    estimatedVolumeProportionSand: number | null;
+    estimatedVolumeProportionSilt: number | null;
+    estimatedVolumeProportionLutum: number | null;
+}
+/** Estimated fraction distribution of a layer's soil */
+export interface FractionDistribution {
+    fractionDistributionComplete: string | null;
+    estimatedMassProportionOrganicMatter: number | null;
+    estimatedMassProportionShellMatter: number | null;
+    estimatedVolumeProportionShellMatter: number | null;
+    estimatedMassProportionShell: number | null;
+    estimatedMassProportionGravel: number | null;
+    estimatedVolumeProportionGravel: number | null;
+    fineFractionDistributionOrganicSoil?: FineFractionDistributionOrganicSoil;
+    fineFractionDistributionShellySoil?: FineFractionDistributionShellySoil;
+}
+/** A mottle (vlek) in a layer */
+export interface Mottle {
+    colour: string | null;
+    density: string | null;
+    inBands: string | null;
+}
+/** A thin stratum (laagje) interbedded in a layer */
+export interface ThinStratum {
+    layerProportion: number | null;
+    layerProportionClass: string | null;
+    layerProportionClassArchive: string | null;
+    stratumThicknessClass: string | null;
+    geologicalOrigin: string | null;
+}
 /**
  * BHR-G (Geological Borehole) layer data
  *
  * Contains all fields from the BRO BHR-G schema for a single soil layer.
+ * Soil-level fields are flattened directly onto the layer (matching the parser's
+ * existing style); genuinely nested sub-structures (fractions, mottles, chunks,
+ * thin strata) are modelled as nested objects/arrays.
  */
 export interface BHRGLayer {
     upperBoundary: number;
@@ -463,42 +767,90 @@ export interface BHRGLayer {
     gravelContentClass?: string | null;
     carbonateContentClass?: string | null;
     sandMedianClass?: string | null;
+    /** Whether a post-sedimentary change is present (raw code) */
+    postSedimentary?: string | null;
+    horizonCode?: string | null;
+    humanTrace?: string | null;
+    geologicalOrigin?: string | null;
+    bioturbated?: string | null;
+    /** Sedimentary structures (0-3) */
+    structure?: Array<string>;
+    /** Vertical trends (0-3) */
+    verticalTrend?: Array<string>;
+    /** Archeological constituent types (0-5) */
+    archeologicalConstituents?: Array<string>;
+    /** Geological soil name (lithostratigraphic) */
+    geologicalSoilName?: string | null;
+    /** Shell matter content classification */
+    shellMatterContentClass?: string | null;
+    micaContentClass?: string | null;
+    micaContentClassArchive?: string | null;
+    shellMatterContentClassArchive?: string | null;
+    /** Very coarse fraction content classes (0-2) */
+    veryCoarseFractionContentClass?: Array<string>;
+    /** Very coarse fraction content classes, archive coding (0-2) */
+    veryCoarseFractionContentClassArchive?: Array<string>;
+    glauconiteContentClass?: string | null;
+    glauconiteContentClassArchive?: string | null;
+    sedimentaryPhenomenon?: string | null;
+    /** Animal fossil types found in the soil (0+) */
+    animalFossils?: Array<string>;
+    munsellColour?: MunsellColour;
+    sandFraction?: SandFraction;
+    shellFraction?: ShellFraction;
+    gravelFraction?: GravelFraction;
+    peatFraction?: PeatFraction;
+    fractionDistribution?: FractionDistribution;
+    /** Chunks of differing material (0-3) */
+    chunks?: Array<Chunk>;
+    /** Mottles (0-3) */
+    mottles?: Array<Mottle>;
+    /** Thin interbedded strata (0-4) */
+    thinStrata?: Array<ThinStratum>;
 }
 /**
  * Complete BHR-G (Geological Borehole) data (metadata + layers)
  */
-export interface BHRGData {
+export interface BHRGData extends BRORegistrationObject {
     /**
      * Metadata about the parsed document (schema version, warnings)
      */
     meta: ParseMeta;
-    broId: string | null;
     /**
      * User-defined identifier (not parsed from XML)
      */
     alias?: string;
-    /**
-     * BRO quality regime
-     *
-     * - IMBRO: Strict regime (all mandatory fields required)
-     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
-     */
-    qualityRegime: QualityRegime | null;
-    researchReportDate: Date | null;
+    researchReportDate: string | null;
     deliveredLocation: Location | null;
     standardizedLocation: Location | null;
     deliveredVerticalPositionOffset: number | null;
     deliveredVerticalPositionDatum: string | null;
     deliveredVerticalPositionReferencePoint: string | null;
+    /** Water depth at the borehole location (m), when the survey was over water */
+    waterDepth: number | null;
+    /** Date vertical position was determined */
+    verticalPositioningDate: string | null;
+    /** Method used to determine vertical position */
+    verticalPositioningMethod: string | null;
+    /** KvK number of the operator that determined the vertical position */
+    verticalPositioningOperator: string | null;
+    /** Landscape element at the site */
+    landscapeElement: string | null;
+    /** Hydrological setting at the site */
+    hydrologicalSetting: string | null;
+    /** Current geomorphological process at the site */
+    currentProcess: string | null;
     descriptionProcedure: string | null;
+    /** Tool used for the sample description */
+    utensil: string | null;
     boreRockReached: boolean | null;
     finalBoreDepth: number | null;
     finalSampleDepth: number | null;
     boreHoleCompleted: string | null;
     /** Start date of the boring operation */
-    boringStartDate: Date | null;
+    boringStartDate: string | null;
     /** End date of the boring operation */
-    boringEndDate: Date | null;
+    boringEndDate: string | null;
     /** Boring procedure standard used */
     boringProcedure: string | null;
     /** Boring technique used */
@@ -509,6 +861,8 @@ export interface BHRGData {
     subsurfaceContaminated: boolean | null;
     /** Stop criterion for boring */
     stopCriterion: string | null;
+    /** Whether a flushing additive was used (raw code) */
+    flushingAdditiveUsed: string | null;
     /** Sampling procedure standard */
     samplingProcedure: string | null;
     /** Sampling method used */
@@ -522,7 +876,7 @@ export interface BHRGData {
     /** Description location (field/lab) */
     descriptionLocation: string | null;
     /** Date of description report */
-    descriptionReportDate: Date | null;
+    descriptionReportDate: string | null;
     /** Described material type */
     describedMaterial: string | null;
     /** Whether sampling was continuous */
@@ -534,8 +888,6 @@ export interface BHRGData {
     boredIntervals: Array<BoredInterval>;
     /** Array of sampled intervals with method and quality */
     sampledIntervals: Array<SampledInterval>;
-    /** BRO registration history */
-    registrationHistory: RegistrationHistory | null;
     /** Report history with events */
     reportHistory: ReportHistory | null;
     /** Delivery context (e.g., "archiefoverdracht") */
@@ -574,6 +926,19 @@ export interface SamplerDetails {
     coreCatcherPresent: boolean | null;
     pistonPresent: boolean | null;
 }
+/**
+ * Core recovery measurements for a sampled interval (rock coring)
+ */
+export interface CoreRecovery {
+    /** Total core recovery (%) */
+    totalCoreRecovery: number | null;
+    /** Solid core recovery (%) */
+    solidCoreRecovery: number | null;
+    /** Rock Quality Designation (%) */
+    rockQualityDesignation: number | null;
+    /** Whether the core recovery was determined in the field */
+    fieldDetermined: boolean | null;
+}
 /**
  * Sampled interval - records sampling method and quality at specific depth ranges
  */
@@ -585,6 +950,8 @@ export interface SampledInterval {
     samplingQuality: string | null;
     orientatedSampled: boolean | null;
     sampler?: SamplerDetails;
+    /** Core recovery measurements (rock coring), when determined */
+    coreRecovery?: CoreRecovery;
 }
 /**
  * Completed interval - records how the borehole was completed/backfilled
@@ -593,10 +960,45 @@ export interface CompletedInterval {
     beginDepth: number;
     endDepth: number;
     permanentCasingPresent: boolean | null;
+    /** Diameter of the permanent casing (mm) */
+    diameterPermanentCasing: number | null;
+    /** Material of the permanent casing */
+    materialPermanentCasing: string | null;
     backfillMaterial: string | null;
     backfillMaterialWashed: boolean | null;
     backfillMaterialCertified: boolean | null;
 }
+/**
+ * Excavated layer - a layer removed by excavation before/during boring
+ */
+export interface ExcavatedLayer {
+    upperBoundary: number;
+    lowerBoundary: number;
+    /** Material that was excavated */
+    excavatedMaterial: string | null;
+}
+/**
+ * Boring velocity measurement - drilling depth reached after a given elapsed time
+ */
+export interface BoringVelocityMeasurement {
+    /** Elapsed time (s) */
+    elapsedTime: number | null;
+    /** Depth reached (m) */
+    depth: number | null;
+}
+/**
+ * Fluid mud layer - a layer of fluid mud (slib) recorded at the borehole
+ */
+export interface FluidMudLayer {
+    /** Thickness of the fluid mud layer (m) */
+    thickness: number | null;
+    /** Colour of the fluid mud */
+    colour: string | null;
+    /** Method used to position the upper boundary */
+    upperBoundaryPositioningMethod: string | null;
+    /** Method used to position the lower boundary */
+    lowerBoundaryPositioningMethod: string | null;
+}
 /**
  * Not described interval - records depth ranges that were not described and why
  */
@@ -610,15 +1012,25 @@ export interface NotDescribedInterval {
  */
 export interface IntermediateEvent {
     eventName: string | null;
-    eventDate: Date | null;
+    eventDate: string | null;
 }
 /**
  * Registration history - BRO administrative registration information
  */
 export interface RegistrationHistory {
-    objectRegistrationTime: Date | null;
+    objectRegistrationTime: string | null;
     registrationStatus: string | null;
-    registrationCompletionTime: Date | null;
+    registrationCompletionTime: string | null;
+    /** Time of the latest correction to the registered object */
+    latestCorrectionTime: string | null;
+    /** Time of the latest addition to the registered object */
+    latestAdditionTime: string | null;
+    /** Time the object was placed under review */
+    underReviewTime: string | null;
+    /** Time the object was deregistered */
+    deregistrationTime: string | null;
+    /** Time the object was reregistered after deregistration */
+    reregistrationTime: string | null;
     corrected: boolean | null;
     underReview: boolean | null;
     deregistered: boolean | null;
@@ -628,8 +1040,8 @@ export interface RegistrationHistory {
  * Report history - records when and how data was reported
  */
 export interface ReportHistory {
-    reportStartDate: Date | null;
-    reportEndDate: Date | null;
+    reportStartDate: string | null;
+    reportEndDate: string | null;
     intermediateEvents: Array<IntermediateEvent>;
 }
 /**
@@ -664,6 +1076,8 @@ export interface OrganicMatterContentDetermination {
     determinationProcedure: string | null;
     determinationMethod: string | null;
     removedMaterial: string | null;
+    /** Whether a lutum (clay fraction) correction was applied to the result */
+    lutumCorrectionApplied: boolean | null;
     organicMatterContent: number | null;
 }
 /**
@@ -682,6 +1096,8 @@ export interface VolumetricMassDensityOfSolidsDetermination {
     determinationProcedure: string | null;
     determinationMethod: string | null;
     liquidUsed: string | null;
+    /** Volume of the sample container used (e.g., "100ml") */
+    sampleContainerVolume: string | null;
     volumetricMassDensityOfSolids: number | null;
 }
 /**
@@ -696,9 +1112,13 @@ export interface ParticleSizeDistributionDetermination {
     removedMaterial: string | null;
     equivalentMassDeterminationMethod: string | null;
     equivalentMass: number | null;
+    /** Optical model used (for laser-diffraction methods) */
+    usedOpticalModel?: string | null;
     fractionSmaller63um: number | null;
     fractionLarger63um: number | null;
     fraction0to2um?: number | null;
+    /** 2–32 µm fraction — only present in the coarser standardDistributionFractionSmaller63um group */
+    fraction2to32um?: number | null;
     fraction2to4um?: number | null;
     fraction4to8um?: number | null;
     fraction8to16um?: number | null;
@@ -721,6 +1141,20 @@ export interface ParticleSizeDistributionDetermination {
     fraction16to31_5mm?: number | null;
     fraction31_5to63mm?: number | null;
     fractionLarger63mm?: number | null;
+    fraction63to75um?: number | null;
+    fraction75to90um?: number | null;
+    fraction90to106um?: number | null;
+    fraction106to125um?: number | null;
+    fraction125to150um?: number | null;
+    fraction150to180um?: number | null;
+    fraction180to212um?: number | null;
+    fraction212to250um?: number | null;
+    fraction4to5_6mm?: number | null;
+    fraction5_6to8mm?: number | null;
+    fraction8to11_2mm?: number | null;
+    fraction11_2to16mm?: number | null;
+    fraction16to20mm?: number | null;
+    fraction20to31_5mm?: number | null;
 }
 /**
  * Plasticity data point for Atterberg limits test
@@ -729,6 +1163,8 @@ export interface ParticleSizeDistributionDetermination {
 export interface PlasticityAtSpecificWaterContent {
     waterContent: number;
     numberOfFalls: number;
+    /** Cone penetration depth in mm (fall-cone method) */
+    penetrationDepth?: number | null;
 }
 /**
  * Consistency limits determination (Atterberg limits)
@@ -740,6 +1176,8 @@ export interface ConsistencyLimitsDetermination {
     fractionLarger500um: number | null;
     usedMedium: string | null;
     performanceIrregularity: string | null;
+    /** Fall-cone apparatus type used (e.g., "zweedseConus30graden") */
+    conusType: string | null;
     liquidLimit: number | null;
     plasticLimit: number | null;
     plasticityIndex: number | null;
@@ -753,6 +1191,17 @@ export interface HeightAtSpecificTime {
     time: number;
     height: number;
 }
+/**
+ * Stress/strain measurement at a specific time during a settlement step
+ * Columns of the StressAtSpecificSettlement time-series (oedometer/consolidation).
+ */
+export interface StressAtSpecificSettlement {
+    elapsedTime: number;
+    verticalStrain: number;
+    excessPoreWaterPressure: number | null;
+    verticalEffectiveStress: number | null;
+    horizontalEffectiveStress: number | null;
+}
 /**
  * Single loading step in settlement characteristics test
  * Represents one stress increment in oedometer/consolidation test
@@ -765,6 +1214,24 @@ export interface SettlementDeterminationStep {
     stepType: string | null;
     verticalStress: number | null;
     heightChangeDuringSettlement: Array<HeightAtSpecificTime>;
+    /** Stress/strain time-series for the step (alternative to heightChangeDuringSettlement) */
+    stressChangeDuringSettlement?: Array<StressAtSpecificSettlement>;
+}
+/**
+ * Saturation stage preceding compression in the oedometer/settlement test
+ * Documents how the specimen was saturated before loading.
+ */
+export interface SaturationStageAtCompression {
+    porousDiscWet: boolean | null;
+    usedMedium: string | null;
+    backPressure: number | null;
+    constantHeight: boolean | null;
+    specimenHeightAfterwards: number | null;
+    disturbanceInduced: boolean | null;
+    /** Maximum stress difference during saturation (kPa) */
+    maximumStressDifference: number | null;
+    /** Maximum strain during saturation (%) */
+    maximumStrain: number | null;
 }
 /**
  * Settlement characteristics determination (oedometer/consolidation test)
@@ -781,6 +1248,8 @@ export interface SettlementCharacteristicsDetermination {
     apparatusDeformationApplied: boolean | null;
     bearingFrictionCorrectionApplied: boolean | null;
     irregularResult: boolean | null;
+    /** Saturation stage performed before compression (optional) */
+    saturationStageAtCompression?: SaturationStageAtCompression;
     determinationSteps: Array<SettlementDeterminationStep>;
 }
 /**
@@ -790,6 +1259,13 @@ export interface SaturatedPermeabilityAtSpecificDensity {
     dryVolumetricMassDensity: number | null;
     saturatedPermeability: number | null;
 }
+/**
+ * Permeability at specific load measurement
+ */
+export interface SaturatedPermeabilityAtSpecificLoad {
+    load: number | null;
+    saturatedPermeability: number | null;
+}
 /**
  * Saturated permeability determination (hydraulic conductivity)
  * Used to determine water flow characteristics through soil
@@ -805,7 +1281,14 @@ export interface SaturatedPermeabilityDetermination {
     waterDegassed: boolean | null;
     temperature: number | null;
     maximumGradient: number | null;
+    /** Whether the confining ring was water-repellent (raw code) */
+    ringWaterRepellent: string | null;
+    /** Water content after the test (%) */
+    waterContentAfterwards: number | null;
+    /** Material irregularities observed (0-2 codes) */
+    materialIrregularity: Array<string>;
     saturatedPermeabilityAtSpecificDensity: Array<SaturatedPermeabilityAtSpecificDensity>;
+    saturatedPermeabilityAtSpecificLoad: Array<SaturatedPermeabilityAtSpecificLoad>;
 }
 /**
  * Membrane correction data for triaxial test
@@ -839,6 +1322,8 @@ export interface SaturationStageAtLoading {
     effectivePressure: number | null;
     skemptonBCoefficient: number | null;
     disturbanceInduced: boolean | null;
+    /** Stress difference during saturation (kPa) */
+    stressDifference: number | null;
 }
 /**
  * Volume change measurement at specific time during consolidation
@@ -872,6 +1357,14 @@ export interface ShearStressAtSpecificStrain {
     porePressure?: number | null;
     volumeChange?: number | null;
 }
+/**
+ * Reconstituted/remoulded specimen preparation for a triaxial loading test
+ * Present when the specimen was made in the lab rather than taken intact.
+ */
+export interface SpecimenMadeForLoading {
+    makingMethod: string | null;
+    dryVolumetricMassDensity: number | null;
+}
 /**
  * Load stage data for triaxial test
  * Documents the shearing/loading phase of the test
@@ -908,6 +1401,7 @@ export interface ShearStressChangeDuringLoadingDetermination {
     stopCriterion: string | null;
     membraneCorrection?: MembraneCorrection;
     drainageStripCorrection?: DrainageStripCorrection;
+    madeSpecimenForLoading?: SpecimenMadeForLoading;
     saturationStageAtLoading?: SaturationStageAtLoading;
     consolidationStageAtLoading?: ConsolidationStageAtLoading;
     loadStage?: LoadStage;
@@ -923,6 +1417,10 @@ export interface MaximumUndrainedShearStrengthDetermination {
     verticallyDetermined: boolean | null;
     sampleMoistness: string | null;
     maximumUndrainedShearStrength: number | null;
+    /** Lowest measured maximum undrained shear strength (kPa) */
+    lowestMaximumUndrainedShearStrength: number | null;
+    /** Highest measured maximum undrained shear strength (kPa) */
+    highestMaximumUndrainedShearStrength: number | null;
 }
 /**
  * Height measurement at specific time during consolidation in horizontal deformation test
@@ -1019,7 +1517,7 @@ export interface InvestigatedInterval {
  * Contains laboratory test results for soil samples
  */
 export interface BoreholeSampleAnalysis {
-    analysisReportDate: Date | null;
+    analysisReportDate: string | null;
     analysisProcedure: string | null;
     investigatedIntervals: Array<InvestigatedInterval>;
 }