@bedrock-engineer/bro-xml-parser 0.6.0 → 0.7.0

package/dist/core/version-detector.js

@@ -7,89 +7,100 @@
  */
 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.
+ * The registration-type registry: version facts per {@link DataType}, the single
+ * source of truth the detector reads. (Producers live in `BROParser`, keyed by the
+ * same union — see the split rationale in the parser.)
  */
-const KNOWN_VERSIONS = {
-    CPT: [
-        {
+const REGISTRATIONS = {
+    CPT: {
+        urnFragment: "/dscpt/",
+        primary: {
             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": [
-        {
+        alsoKnown: [
+            {
+                namespace: "http://www.broservices.nl/xsd/dscpt/1.0",
+                version: "1.0",
+                majorVersion: 1,
+                description: "Dispatch CPT schema version 1.0",
+            },
+        ],
+    },
+    "BHR-GT": {
+        urnFragment: "/dsbhr-gt/",
+        primary: {
             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": [
-        {
+        alsoKnown: [
+            {
+                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": {
+        urnFragment: "/dsbhrg/",
+        primary: {
             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",
-        },
-    ],
-    GMW: [
-        {
+        alsoKnown: [
+            {
+                namespace: "http://www.broservices.nl/xsd/dsbhrg/3.0",
+                version: "3.0",
+                majorVersion: 3,
+                description: "Dispatch BHR-G schema version 3.0",
+            },
+        ],
+    },
+    GMW: {
+        urnFragment: "/dsgmw/",
+        primary: {
             namespace: "http://www.broservices.nl/xsd/dsgmw/1.1",
             version: "1.1",
             majorVersion: 1,
             description: "Dispatch GMW schema version 1.1",
         },
-        // Older known versions
-        {
-            namespace: "http://www.broservices.nl/xsd/dsgmw/1.0",
-            version: "1.0",
-            majorVersion: 1,
-            description: "Dispatch GMW schema version 1.0",
-        },
-    ],
-    GLD: [
-        {
+        alsoKnown: [
+            {
+                namespace: "http://www.broservices.nl/xsd/dsgmw/1.0",
+                version: "1.0",
+                majorVersion: 1,
+                description: "Dispatch GMW schema version 1.0",
+            },
+        ],
+    },
+    GLD: {
+        urnFragment: "/dsgld/",
+        primary: {
             namespace: "http://www.broservices.nl/xsd/dsgld/1.0",
             version: "1.0",
             majorVersion: 1,
             description: "Dispatch GLD schema version 1.0",
         },
-    ],
+        alsoKnown: [],
+    },
 };
+/** Every known version for a type, primary first. */
+function knownVersions(dataType) {
+    const reg = REGISTRATIONS[dataType];
+    return [reg.primary, ...reg.alsoKnown];
+}
 /**
  * Get the supported (primary) version for a data type
  */
 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];
+    return REGISTRATIONS[dataType].primary;
 }
 /**
  * Exported for backward compatibility
@@ -102,11 +113,12 @@ export const SUPPORTED_VERSIONS = {
     GLD: getSupportedVersion("GLD"),
 };
 /**
- * Extract version from namespace URI
- * e.g., "http://www.broservices.nl/xsd/dscpt/1.1" -> "1.1"
+ * Extract version from namespace URI. Accepts both the documented
+ * `major.minor` form and the bare-major form several BRO REST services return.
+ * e.g. `.../dscpt/1.1` -> "1.1", `.../dsbhrg/3` -> "3"
  */
 function extractVersionFromNamespace(namespace) {
-    const match = /\/(\d+\.\d+)$/.exec(namespace);
+    const match = /\/(\d+(?:\.\d+)?)$/.exec(namespace);
     return match?.[1] ?? "unknown";
 }
 /**
@@ -118,43 +130,18 @@ function extractMajorVersion(version) {
     return match?.[1] ? parseInt(match[1], 10) : 0;
 }
 /**
- * Detect schema type from namespace pattern
+ * Detect schema type from a namespace by matching its version-independent family
+ * fragment (e.g. `/dscpt/`) against the registry. `dsbhr-gt` and `dsbhrg` stay
+ * distinct because their fragments carry the hyphen.
  */
 function detectDataTypeFromNamespace(namespace) {
-    if (namespace.includes("/dscpt/")) {
-        return "CPT";
-    }
-    if (namespace.includes("/dsbhr-gt/")) {
-        return "BHR-GT";
-    }
-    if (namespace.includes("/dsbhrg/")) {
-        return "BHR-G";
-    }
-    if (namespace.includes("/dsgmw/")) {
-        return "GMW";
-    }
-    if (namespace.includes("/dsgld/")) {
-        return "GLD";
+    for (const [type, reg] of Object.entries(REGISTRATIONS)) {
+        if (namespace.includes(reg.urnFragment)) {
+            return type;
+        }
     }
     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";
-        case "GMW":
-            return "parseGMW";
-        case "GLD":
-            return "parseGLD";
-    }
-}
 /**
  * Detect and validate the BRO schema version from XML document
  *
@@ -190,8 +177,7 @@ export function detectAndValidateVersion(doc, expectedType) {
         };
     }
     // Check if it's a known version for the expected type
-    const knownVersions = KNOWN_VERSIONS[expectedType];
-    const knownVersion = knownVersions.find((v) => v.namespace === namespace);
+    const knownVersion = knownVersions(expectedType).find((v) => v.namespace === namespace);
     if (knownVersion) {
         // Known version but not the primary supported one
         warnings.push(`Parsing with schema version ${knownVersion.version}, ` +
@@ -212,7 +198,7 @@ export function detectAndValidateVersion(doc, expectedType) {
             expected: expectedType,
             actual: detectedType,
             namespace,
-            hint: `Use ${getParserMethodName(detectedType)}() instead of ${getParserMethodName(expectedType)}()`,
+            hint: `Document is ${detectedType}, not ${expectedType}. Use the ${detectedType} parser.`,
         });
     }
     // Check if it's the same type but unknown version
@@ -221,6 +207,20 @@ export function detectAndValidateVersion(doc, expectedType) {
         const detectedMajor = extractMajorVersion(detectedVersion);
         const supportedMajor = supportedVersion.majorVersion;
         if (detectedMajor === supportedMajor) {
+            // A bare-major namespace (e.g. `.../dsbhrg/3`) is the whole-major form
+            // several BRO REST services return for the very schema family we
+            // support. It resolves cleanly, so accept it without warning. A specific
+            // but unrecognized minor (e.g. `3.2`) is genuinely unverified and still
+            // warns below.
+            const isBareMajor = /\/\d+$/.test(namespace);
+            if (isBareMajor) {
+                return {
+                    dataType: expectedType,
+                    version: detectedVersion,
+                    namespace,
+                    warnings: [],
+                };
+            }
             // Same major version - attempt parsing with warning
             warnings.push(`Unknown schema version ${detectedVersion} for ${expectedType}. ` +
                 `This library supports version ${supportedVersion.version}. ` +
@@ -272,11 +272,11 @@ export function getVersionInfo(doc) {
         return null;
     }
     // Check all known versions
-    for (const [type, versions] of Object.entries(KNOWN_VERSIONS)) {
-        for (const info of versions) {
+    for (const type of Object.keys(REGISTRATIONS)) {
+        for (const info of knownVersions(type)) {
             if (namespace === info.namespace) {
                 return {
-                    type: type,
+                    type,
                     version: info.version,
                     namespace: info.namespace,
                 };

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

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

package/dist/namespaces.d.ts

@@ -13,4 +13,25 @@ export declare const BRO_NAMESPACES: Namespaces;
  * Used by NodeXMLAdapter for pre-populating the xpath library's namespace map
  */
 export declare const KNOWN_BRO_PREFIXES: ReadonlyArray<string>;
+/**
+ * Strip a trailing schema version from a namespace URI, yielding its "family".
+ *
+ * BRO publishes the same schema under several version suffixes — e.g.
+ * `.../dsbhrg/3.1` (the documented XSD) and `.../dsbhrg/3` (returned by several
+ * REST services); both share the family `.../dsbhrg`. Only a trailing
+ * `/<major>` or `/<major>.<minor>` is removed, so a URI like
+ * `.../1999/xlink` (version-free) is returned unchanged.
+ */
+export declare function namespaceFamily(uri: string): string;
+/**
+ * Re-point the configured namespace URIs at the versions a document declares.
+ *
+ * The XPath resolver binds each prefix to one exact URI, so a document that
+ * declares `.../dsbhrg/3` never matches queries bound to `.../dsbhrg/3.1`. For
+ * every configured prefix whose family also appears among `declaredUris`, adopt
+ * the document's URI; leave the rest untouched. Matching by family means a
+ * major-3 BHR-G parses whether it arrives as `/3`, `/3.0`, or `/3.1`, without
+ * the schema (which is prefix-keyed) needing to know which minor it got.
+ */
+export declare function adaptNamespacesToDocument(defaults: Namespaces, declaredUris: Iterable<string>): Namespaces;
 //# sourceMappingURL=namespaces.d.ts.map

package/dist/namespaces.d.ts.map

@@ -1 +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,UAiC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAqB3C,CAAC"}
+{"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,UAiC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAqB3C,CAAC;AAEX;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,UAAU,EACpB,YAAY,EAAE,QAAQ,CAAC,MAAM,CAAC,GAC7B,UAAU,CAcZ"}

package/dist/namespaces.js

@@ -61,4 +61,40 @@ export const KNOWN_BRO_PREFIXES = [
     "wml2",
     "xlink",
 ];
+/**
+ * Strip a trailing schema version from a namespace URI, yielding its "family".
+ *
+ * BRO publishes the same schema under several version suffixes — e.g.
+ * `.../dsbhrg/3.1` (the documented XSD) and `.../dsbhrg/3` (returned by several
+ * REST services); both share the family `.../dsbhrg`. Only a trailing
+ * `/<major>` or `/<major>.<minor>` is removed, so a URI like
+ * `.../1999/xlink` (version-free) is returned unchanged.
+ */
+export function namespaceFamily(uri) {
+    return uri.replace(/\/\d+(?:\.\d+)?$/, "");
+}
+/**
+ * Re-point the configured namespace URIs at the versions a document declares.
+ *
+ * The XPath resolver binds each prefix to one exact URI, so a document that
+ * declares `.../dsbhrg/3` never matches queries bound to `.../dsbhrg/3.1`. For
+ * every configured prefix whose family also appears among `declaredUris`, adopt
+ * the document's URI; leave the rest untouched. Matching by family means a
+ * major-3 BHR-G parses whether it arrives as `/3`, `/3.0`, or `/3.1`, without
+ * the schema (which is prefix-keyed) needing to know which minor it got.
+ */
+export function adaptNamespacesToDocument(defaults, declaredUris) {
+    const byFamily = new Map();
+    for (const uri of declaredUris) {
+        byFamily.set(namespaceFamily(uri), uri);
+    }
+    const adapted = { ...defaults };
+    for (const [prefix, uri] of Object.entries(defaults)) {
+        const declared = byFamily.get(namespaceFamily(uri));
+        if (declared) {
+            adapted[prefix] = declared;
+        }
+    }
+    return adapted;
+}
 //# sourceMappingURL=namespaces.js.map

package/dist/namespaces.js.map

@@ -1 +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,sDAAsD;IACtD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,uDAAuD;IACvD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,+BAA+B;IAC/B,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,gCAAgC;IACrC,EAAE,EAAE,+BAA+B;IACnC,QAAQ,EAAE,qCAAqC;IAC/C,kFAAkF;IAClF,0EAA0E;IAC1E,IAAI,EAAE,oCAAoC;IAC1C,KAAK,EAAE,8BAA8B;CACtC,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;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,WAAW;IACX,MAAM;IACN,OAAO;CACC,CAAC"}
+{"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,sDAAsD;IACtD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,uDAAuD;IACvD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,+BAA+B;IAC/B,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,gCAAgC;IACrC,EAAE,EAAE,+BAA+B;IACnC,QAAQ,EAAE,qCAAqC;IAC/C,kFAAkF;IAClF,0EAA0E;IAC1E,IAAI,EAAE,oCAAoC;IAC1C,KAAK,EAAE,8BAA8B;CACtC,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;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,WAAW;IACX,MAAM;IACN,OAAO;CACC,CAAC;AAEX;;;;;;;;GAQG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,OAAO,GAAG,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;AAC7C,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,yBAAyB,CACvC,QAAoB,EACpB,YAA8B;IAE9B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,YAAY,EAAE,CAAC;QAC/B,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAe,EAAE,GAAG,QAAQ,EAAE,CAAC;IAC5C,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QACrD,MAAM,QAAQ,GAAG,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC;QACpD,IAAI,QAAQ,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,GAAG,QAAQ,CAAC;QAC7B,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/node.d.ts

@@ -14,14 +14,14 @@
 export { BROParser } from "./parser.js";
 export { NodeXMLAdapter as XMLAdapter } from "./adapters/node-adapter.js";
 export type { CPTData, CPTMeasurement, DissipationMeasurement, BHRGTData, BHRGData, GMWData, GLDData, BROData, BROFileType, Location, ParseMeta, Namespaces, QualityRegime, } from "./types/index.js";
-export type { RegistrationHistory } from "./schemas/common-fields.js";
+export type { RegistrationHistory } 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_PRODUCER } from "./schemas/cpt-schema.js";
 export type { DissipationTest, RemovedLayer } from "./types/index.js";
 export { BORE_PRODUCER } from "./schemas/bore-schema.js";
-export type { BHRGTLayer, BHRGTLayerBase, BHRGTSoilLayer, BHRGTRockLayer, RockDescription, RockWeatheringDegree, Grainshape, BoredInterval, SampledInterval, SamplerDetails, CoreRecovery, CompletedInterval, PostSedimentaryDiscontinuity, ExcavatedLayer, BoringVelocityMeasurement, NotDescribedInterval, FluidMudLayer, } from "./schemas/bore-types.js";
+export type { BHRGTLayer, BHRGTLayerBase, BHRGTSoilLayer, BHRGTRockLayer, SoilDescription, RockDescription, RockWeatheringDegree, Grainshape, BoredInterval, SampledInterval, SamplerDetails, CoreRecovery, CompletedInterval, PostSedimentaryDiscontinuity, ExcavatedLayer, BoringVelocityMeasurement, NotDescribedInterval, FluidMudLayer, } from "./schemas/bore-types.js";
 export type { HeightAtSpecificTime, StressAtSpecificSettlement, VolumeChangeAtSpecificTime, ShearStressAtSpecificStrain, HorizontalDeformationDataPoint, BoreholeSampleAnalysis, InvestigatedInterval, WaterContentDetermination, VolumetricMassDensityDetermination, OrganicMatterContentDetermination, CarbonateContentDetermination, VolumetricMassDensityOfSolidsDetermination, MaximumUndrainedShearStrengthDetermination, ParticleSizeDistributionDetermination, ConsistencyLimitsDetermination, SettlementCharacteristicsDetermination, SettlementDeterminationStep, SaturationStageAtCompression, SaturatedPermeabilityDetermination, ShearStressChangeDuringLoadingDetermination, ConsolidationStepAtHorizontalDeformation, ShearStressChangeDuringHorizontalDeformationDetermination, PlasticityAtSpecificWaterContent, SaturatedPermeabilityAtSpecificDensity, SaturatedPermeabilityAtSpecificLoad, MembraneCorrection, DrainageStripCorrection, SpecimenMadeForLoading, SaturationStageAtLoading, ConsolidationStageAtLoading, LoadStage, ConsolidationStageAtHorizontalDeformation, ShearStageAtHorizontalDeformation, } from "./schemas/bhrgt-analysis.js";
 export type { GLDObservation, GLDObservationPoint, GroundwaterMonitoringTubeRef, } from "./schemas/gld-types.js";
 export { BHRG_PRODUCER } from "./schemas/bhrg-schema.js";

package/dist/node.d.ts.map

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

package/dist/node.js.map

@@ -1 +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;AAmB1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA4DzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqBzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,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,2EAA2E;AAC3E,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAK5C,sFAAsF;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,6CAA6C;AAC7C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}
+{"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;AAmB1E,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA6DzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqBzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,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,2EAA2E;AAC3E,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAK5C,sFAAsF;AACtF,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAG3C,6CAA6C;AAC7C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}

package/dist/parser.d.ts

@@ -37,6 +37,20 @@ export declare class BROParser {
      * Create ParseMeta from version detection result
      */
     private createMeta;
+    /**
+     * The one body behind every `parse*` method: validate the version, run the
+     * type's producer, fold warnings into `meta`. Takes an already-parsed `doc` so
+     * {@link parse} detects and parses without re-parsing the XML.
+     *
+     * The cast bridges one TS limitation only: it cannot relate a spread of the
+     * generic `value` to the indexed access `DataByType[T]` (it collapses the union
+     * to `never` on the conflicting `dataType` literals), so a direct `as` is
+     * refused and `as unknown as` is the idiom. Soundness rests entirely on guards
+     * elsewhere — the {@link PRODUCERS} map is type-checked against
+     * {@link DataByType}, and each `parse*` one-liner re-checks the concrete
+     * `DataByType[K]` against its declared `*Data` return type at the call site.
+     */
+    private parseAs;
     /**
      * Parse CPT data from BRO/XML string
      *
@@ -171,8 +185,8 @@ export declare class BROParser {
      * const parser = new BROParser(new XMLAdapter());
      * const data = parser.parse(xmlString);
      *
-     * // Use meta.dataType to discriminate
-     * switch (data.meta.dataType) {
+     * // Discriminate on the top-level dataType (narrows the union)
+     * switch (data.dataType) {
      *   case 'CPT':
      *     console.log(data.finalDepth);
      *     break;

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAE7F;;;;;;;;;;;;;;;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;IAYlC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAYtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAYpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAwB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EACrE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,QAAQ,CAAC,EAAE,WAAW,GACrB,cAAc,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IAU1C;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,CAAC,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,QAAQ,CAAC,EAAE,WAAW,GACrB,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IAU1B,iFAAiF;IACjF,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,UAAU,IAAI,UAAU;CAGzB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EAEP,SAAS,EACT,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAuB7F;;;;;;;;;;;;;;;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;IAgBlB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,OAAO;IAOf;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAItC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAIlC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAa/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EACrE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,QAAQ,CAAC,EAAE,WAAW,GACrB,cAAc,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IAU1C;;;;;;;;;;;;;;;;OAgBG;IACH,cAAc,CAAC,CAAC,EACd,OAAO,EAAE,MAAM,EACf,SAAS,EAAE,cAAc,CAAC,CAAC,CAAC,EAC5B,QAAQ,CAAC,EAAE,WAAW,GACrB,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IAU1B,iFAAiF;IACjF,OAAO,CAAC,WAAW;IAgBnB;;;OAGG;IACH,UAAU,IAAI,UAAU;CAGzB"}

package/dist/parser.js

@@ -15,6 +15,23 @@ import { GLD_PRODUCER } from "./schemas/gld-schema.js";
 import { BRO_NAMESPACES } from "./namespaces.js";
 import { BROParseError } from "./types/index.js";
 import { object } from "./core/producer.js";
+/**
+ * The producer for each registration type. Its value type is checked against
+ * {@link DataByType} — file a producer under the wrong key (or omit a key) and it
+ * fails to compile. This is the guard that makes the one cast in {@link
+ * BROParser.parseAs} a sound bridge (over TS's inability to type a generic spread)
+ * rather than an unchecked assertion.
+ *
+ * Version facts for the same types live in the registry in `version-detector`;
+ * producers stay here so that module keeps zero dependency on the schemas.
+ */
+const PRODUCERS = {
+    CPT: CPT_PRODUCER,
+    "BHR-GT": BORE_PRODUCER,
+    "BHR-G": BHRG_PRODUCER,
+    GMW: GMW_PRODUCER,
+    GLD: GLD_PRODUCER,
+};
 /**
  * Main BRO Parser class
  *
@@ -59,6 +76,25 @@ export class BROParser {
             warnings: versionResult.warnings,
         };
     }
+    /**
+     * The one body behind every `parse*` method: validate the version, run the
+     * type's producer, fold warnings into `meta`. Takes an already-parsed `doc` so
+     * {@link parse} detects and parses without re-parsing the XML.
+     *
+     * The cast bridges one TS limitation only: it cannot relate a spread of the
+     * generic `value` to the indexed access `DataByType[T]` (it collapses the union
+     * to `never` on the conflicting `dataType` literals), so a direct `as` is
+     * refused and `as unknown as` is the idiom. Soundness rests entirely on guards
+     * elsewhere — the {@link PRODUCERS} map is type-checked against
+     * {@link DataByType}, and each `parse*` one-liner re-checks the concrete
+     * `DataByType[K]` against its declared `*Data` return type at the call site.
+     */
+    parseAs(doc, type) {
+        const meta = this.createMeta(detectAndValidateVersion(doc, type));
+        const { value, warnings } = this.parser.produce(doc, PRODUCERS[type], "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { dataType: type, meta, ...value };
+    }
     /**
      * Parse CPT data from BRO/XML string
      *
@@ -82,12 +118,7 @@ export class BROParser {
      * ```
      */
     parseCPT(xmlText) {
-        const doc = this.adapter.parseXML(xmlText);
-        const versionResult = detectAndValidateVersion(doc, "CPT");
-        const meta = this.createMeta(versionResult);
-        const { value, warnings } = this.parser.produce(doc, CPT_PRODUCER, "dispatchDocument");
-        meta.warnings.push(...warnings);
-        return { meta, ...value };
+        return this.parseAs(this.adapter.parseXML(xmlText), "CPT");
     }
     /**
      * Parse Bore (borehole) data from BRO/XML string
@@ -112,12 +143,7 @@ export class BROParser {
      * ```
      */
     parseBHRGT(xmlText) {
-        const doc = this.adapter.parseXML(xmlText);
-        const versionResult = detectAndValidateVersion(doc, "BHR-GT");
-        const meta = this.createMeta(versionResult);
-        const { value, warnings } = this.parser.produce(doc, BORE_PRODUCER, "dispatchDocument");
-        meta.warnings.push(...warnings);
-        return { meta, ...value };
+        return this.parseAs(this.adapter.parseXML(xmlText), "BHR-GT");
     }
     /**
      * Parse BHR-G (Geological Borehole) data from BRO/XML string
@@ -142,12 +168,7 @@ export class BROParser {
      * ```
      */
     parseBHRG(xmlText) {
-        const doc = this.adapter.parseXML(xmlText);
-        const versionResult = detectAndValidateVersion(doc, "BHR-G");
-        const meta = this.createMeta(versionResult);
-        const { value, warnings } = this.parser.produce(doc, BHRG_PRODUCER, "dispatchDocument");
-        meta.warnings.push(...warnings);
-        return { meta, ...value };
+        return this.parseAs(this.adapter.parseXML(xmlText), "BHR-G");
     }
     /**
      * Parse GMW (groundwater monitoring well) data from BRO/XML string
@@ -172,12 +193,7 @@ export class BROParser {
      * ```
      */
     parseGMW(xmlText) {
-        const doc = this.adapter.parseXML(xmlText);
-        const versionResult = detectAndValidateVersion(doc, "GMW");
-        const meta = this.createMeta(versionResult);
-        const { value, warnings } = this.parser.produce(doc, GMW_PRODUCER, "dispatchDocument");
-        meta.warnings.push(...warnings);
-        return { meta, ...value };
+        return this.parseAs(this.adapter.parseXML(xmlText), "GMW");
     }
     /**
      * Parse GLD (groundwater level research) data from BRO/XML string
@@ -205,12 +221,7 @@ export class BROParser {
      * ```
      */
     parseGLD(xmlText) {
-        const doc = this.adapter.parseXML(xmlText);
-        const versionResult = detectAndValidateVersion(doc, "GLD");
-        const meta = this.createMeta(versionResult);
-        const { value, warnings } = this.parser.produce(doc, GLD_PRODUCER, "dispatchDocument");
-        meta.warnings.push(...warnings);
-        return { meta, ...value };
+        return this.parseAs(this.adapter.parseXML(xmlText), "GLD");
     }
     /**
      * Parse any BRO XML document, auto-detecting the data type
@@ -228,8 +239,8 @@ export class BROParser {
      * const parser = new BROParser(new XMLAdapter());
      * const data = parser.parse(xmlString);
      *
-     * // Use meta.dataType to discriminate
-     * switch (data.meta.dataType) {
+     * // Discriminate on the top-level dataType (narrows the union)
+     * switch (data.dataType) {
      *   case 'CPT':
      *     console.log(data.finalDepth);
      *     break;
@@ -248,18 +259,7 @@ export class BROParser {
                 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);
-            case "GMW":
-                return this.parseGMW(xmlText);
-            case "GLD":
-                return this.parseGLD(xmlText);
-        }
+        return this.parseAs(doc, versionInfo.type);
     }
     /**
      * Parse BRO XML with a custom schema for selective extraction