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

package/dist/core/schema-parser.js

@@ -7,6 +7,7 @@
  * public {@link BROParser.parseCustom} surface.
  */
 import { BROParseError } from "../types/index.js";
+import { adaptNamespacesToDocument } from "../namespaces.js";
 /** Trimmed text content of a node, or `null` when empty. */
 function readText(node) {
     const trimmed = node.textContent?.trim();
@@ -15,12 +16,24 @@ function readText(node) {
     }
     return trimmed;
 }
+const LEAF_KINDS = new Set(["scalar", "code"]);
+/** Leaf producers are value-bearing and text-presence driven (`scalar`, `code`). */
+function isLeafKind(kind) {
+    return LEAF_KINDS.has(kind);
+}
 export class SchemaParser {
     adapter;
     namespaces;
+    /**
+     * The namespace URIs the XPath resolver binds to. Defaults to the configured
+     * {@link namespaces}, but each {@link produce} call re-points it at the exact
+     * versions the document declares (see {@link adaptNamespacesToDocument}).
+     */
+    activeNamespaces;
     constructor(adapter, namespaces) {
         this.adapter = adapter;
         this.namespaces = namespaces;
+        this.activeNamespaces = namespaces;
     }
     /**
      * Interpret a {@link Producer} schema against a document, recursing through
@@ -35,17 +48,42 @@ export class SchemaParser {
      *   instead — see the absence model).
      */
     produce(doc, root, rootPath) {
-        const rootElement = this.resolveRoot(doc, rootPath);
-        const self = root.at ? this.xpath(rootElement, root.at) : rootElement;
-        if (!self) {
-            throw new BROParseError(`Root element not found: ${root.at ?? rootPath ?? "."}`, {
-                code: "MISSING_ROOT",
-                path: root.at ?? rootPath,
-            });
+        const previousNamespaces = this.activeNamespaces;
+        this.activeNamespaces = this.namespacesForDocument(doc);
+        try {
+            const rootElement = this.resolveRoot(doc, rootPath);
+            const self = root.at ? this.xpath(rootElement, root.at) : rootElement;
+            if (!self) {
+                throw new BROParseError(`Root element not found: ${root.at ?? rootPath ?? "."}`, {
+                    code: "MISSING_ROOT",
+                    path: root.at ?? rootPath,
+                });
+            }
+            const warnings = [];
+            const value = this.runObject(self, root, warnings, true).value;
+            return { value, warnings };
+        }
+        finally {
+            this.activeNamespaces = previousNamespaces;
         }
-        const warnings = [];
-        const value = this.runObject(self, root, warnings, true).value;
-        return { value, warnings };
+    }
+    /**
+     * Adapt the configured namespaces to the versions this document declares.
+     *
+     * BRO declares every namespace on the root element, so its `xmlns`/`xmlns:*`
+     * attributes are the full set of URIs in play. Reading them lets the resolver
+     * bind to the document's actual minor version (e.g. `dsbhrg/3` vs `/3.1`).
+     */
+    namespacesForDocument(doc) {
+        const attributes = doc.documentElement.attributes;
+        const declaredUris = [];
+        for (let i = 0; i < attributes.length; i++) {
+            const attribute = attributes.item(i);
+            if (attribute && (attribute.name === "xmlns" || attribute.name.startsWith("xmlns:"))) {
+                declaredUris.push(attribute.value);
+            }
+        }
+        return adaptNamespacesToDocument(this.namespaces, declaredUris);
     }
     /**
      * Resolve the schema root: the first child of `rootPath` (the registration
@@ -66,7 +104,7 @@ export class SchemaParser {
         return root;
     }
     get nsResolver() {
-        return (prefix) => (prefix ? (this.namespaces[prefix] ?? null) : null);
+        return (prefix) => (prefix ? (this.activeNamespaces[prefix] ?? null) : null);
     }
     xpath(from, query) {
         return this.adapter.evaluateXPath(from, query, this.nsResolver);
@@ -84,7 +122,16 @@ export class SchemaParser {
         switch (producer.kind) {
             case "scalar": {
                 const raw = readText(self);
-                return { value: producer.decode(raw), satisfied: raw !== null };
+                return {
+                    value: producer.decode(raw, (msg) => warnings.push(msg)),
+                    satisfied: raw !== null,
+                };
+            }
+            case "code": {
+                const raw = readText(self);
+                const csNode = this.xpath(self, "@codeSpace");
+                const codeSpace = csNode ? readText(csNode) : null;
+                return { value: producer.decode(raw, codeSpace), satisfied: raw !== null };
             }
             case "custom": {
                 return { value: producer.produce(this.makeLens(self)), satisfied: true };
@@ -99,8 +146,8 @@ export class SchemaParser {
                     const outcome = this.run(itemNode, producer.item, warnings);
                     if (!outcome.satisfied) {
                         // Structured items (object/oneOf) that fail a required field are a
-                        // meaningful data loss; an empty scalar in a code list is not.
-                        if (producer.item.kind !== "scalar") {
+                        // meaningful data loss; an empty leaf (scalar/code) in a value list is not.
+                        if (!isLeafKind(producer.item.kind)) {
                             warnings.push(`Dropped an item from array "${producer.each}": required data was missing`);
                         }
                         continue;
@@ -179,6 +226,8 @@ export class SchemaParser {
         switch (producer.kind) {
             case "scalar":
                 return producer.decode(null);
+            case "code":
+                return producer.decode(null, null);
             case "array":
                 return [];
             default:

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

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

package/dist/core/select.d.ts

@@ -0,0 +1,71 @@
+/**
+ * `project` — a typed path-tree selector over a producer schema.
+ *
+ * Navigate a producer (e.g. `CPT_PRODUCER`) through a proxy that mirrors its
+ * structure, naming your own output keys. The selection is compiled back into an
+ * {@link ObjectProducer} that reuses the original leaf decoders, so parsing runs
+ * through the same {@link SchemaParser}. No hand-written XPath strings.
+ *
+ * ```ts
+ * const survey = project(CPT_PRODUCER, (t) => ({
+ *   id:    t.broId,
+ *   depth: t.finalDepth,
+ *   klass: t.qualityClass,      // Coded | null
+ * }));
+ * parser.parseSelection(xml, survey, "CPT"); // { id, depth, klass, meta }
+ * ```
+ *
+ * The selector type is derived from the *producer* structure, not the output
+ * type: an atomic `custom`/`columns` field (whose value may look structural, like
+ * `CPTMeasurement[]`) stays a leaf and is selected whole, matching what the
+ * runtime can actually decompose.
+ */
+import type { Presence, Produced, ObjectProducer } from "./producer.js";
+declare const OUT: unique symbol;
+/** A selection token carrying the value type `V` it will parse to. */
+export interface Leaf<V> {
+    readonly [OUT]?: V;
+}
+/** An array node: select the whole array (it is a {@link Leaf}), or `.each` a row. */
+export interface ArraySel<I> extends Leaf<Array<Produced<I>>> {
+    each<R>(fn: (el: SelectableProducer<I>) => R): Leaf<Array<ProjectResult<R>>>;
+}
+/** Intersect the `fields` maps of every `oneOf` branch (a tuple of `BranchInput`). */
+type BranchFields<Br> = Br extends readonly [infer H, ...infer T] ? (H extends {
+    fields: infer F;
+} ? F : object) & BranchFields<T> : object;
+/**
+ * Mirror a producer as a navigable path tree. Array producers → {@link ArraySel};
+ * object producers → descend by field; `oneOf` → descend the merged base + branch
+ * fields (selecting one flattens the union); every leaf (`text`/`number`/`date`/
+ * `boolean`/`code`) and atomic `custom`/`columns` → a whole-value {@link Leaf}.
+ */
+export type SelectableProducer<P> = P extends {
+    kind: "array";
+    _item?: infer I;
+} ? ArraySel<I> : P extends {
+    kind: "object";
+    _fields?: infer F;
+} ? {
+    [K in keyof F]-?: SelectableProducer<F[K]>;
+} : P extends {
+    kind: "oneOf";
+    _base?: infer B;
+    _branches?: infer Br;
+} ? {
+    [K in keyof (B & BranchFields<Br>)]-?: SelectableProducer<(B & BranchFields<Br>)[K]>;
+} : P extends {
+    readonly _out?: infer V;
+} ? Leaf<V> : never;
+/** Resolve a returned selection tree to its parsed output type. */
+export type ProjectResult<S> = S extends Leaf<infer V> ? V : S extends Record<string, unknown> ? {
+    [K in keyof S]: ProjectResult<S[K]>;
+} : never;
+/**
+ * Compile a selection over `root` into an {@link ObjectProducer}. The result
+ * parses through {@link SchemaParser} like any producer (e.g. via
+ * `BROParser.parseSelection`).
+ */
+export declare function project<P extends ObjectProducer<unknown, Presence>, S>(root: P, select: (t: SelectableProducer<P>) => S): ObjectProducer<ProjectResult<S>>;
+export {};
+//# sourceMappingURL=select.d.ts.map

package/dist/core/select.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.d.ts","sourceRoot":"","sources":["../../src/core/select.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,KAAK,EAAY,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAMlF,OAAO,CAAC,MAAM,GAAG,EAAE,OAAO,MAAM,CAAC;AAEjC,sEAAsE;AACtE,MAAM,WAAW,IAAI,CAAC,CAAC;IACrB,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;CACpB;AAED,sFAAsF;AACtF,MAAM,WAAW,QAAQ,CAAC,CAAC,CAAE,SAAQ,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,IAAI,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC9E;AAED,sFAAsF;AACtF,KAAK,YAAY,CAAC,EAAE,IAAI,EAAE,SAAS,SAAS,CAAC,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,CAAC,GAC7D,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,GAC9D,MAAM,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAC5E,QAAQ,CAAC,CAAC,CAAC,GACX,CAAC,SAAS;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GAC7C;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GAC9C,CAAC,SAAS;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,GAChE;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACxF,CAAC,SAAS;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAA;CAAE,GACnC,IAAI,CAAC,CAAC,CAAC,GACP,KAAK,CAAC;AAEhB,mEAAmE;AACnE,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,CAAC,GAClD,CAAC,GACD,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACvC,KAAK,CAAC;AAoJZ;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,cAAc,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC,EACpE,IAAI,EAAE,CAAC,EACP,MAAM,EAAE,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,KAAK,CAAC,GACtC,cAAc,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAMlC"}

package/dist/core/select.js

@@ -0,0 +1,143 @@
+/**
+ * `project` — a typed path-tree selector over a producer schema.
+ *
+ * Navigate a producer (e.g. `CPT_PRODUCER`) through a proxy that mirrors its
+ * structure, naming your own output keys. The selection is compiled back into an
+ * {@link ObjectProducer} that reuses the original leaf decoders, so parsing runs
+ * through the same {@link SchemaParser}. No hand-written XPath strings.
+ *
+ * ```ts
+ * const survey = project(CPT_PRODUCER, (t) => ({
+ *   id:    t.broId,
+ *   depth: t.finalDepth,
+ *   klass: t.qualityClass,      // Coded | null
+ * }));
+ * parser.parseSelection(xml, survey, "CPT"); // { id, depth, klass, meta }
+ * ```
+ *
+ * The selector type is derived from the *producer* structure, not the output
+ * type: an atomic `custom`/`columns` field (whose value may look structural, like
+ * `CPTMeasurement[]`) stays a leaf and is selected whole, matching what the
+ * runtime can actually decompose.
+ */
+import { object, array } from "./producer.js";
+// ===========================================================================
+// Runtime
+// ===========================================================================
+const TOKEN = Symbol("bro.selectToken");
+/** Join a context path with a producer's own relative `at`. */
+function joinPath(prefix, at) {
+    if (!at) {
+        return prefix;
+    }
+    if (!prefix) {
+        return at;
+    }
+    return `${prefix}/${at.replace(/^\.\//, "")}`;
+}
+function readOwn(target, key) {
+    return Reflect.get(target, key);
+}
+/** Build a navigation proxy (or terminal token) for `producer` reached at `path`. */
+function proxyFor(producer, path) {
+    if (producer.kind === "object") {
+        const node = producer;
+        const token = { [TOKEN]: "object", producer, path };
+        return new Proxy(token, {
+            get(target, key) {
+                if (typeof key === "symbol" || Reflect.has(target, key)) {
+                    return readOwn(target, key);
+                }
+                const child = node.fields[key];
+                if (!child) {
+                    throw new Error(`project: unknown field '${key}'`);
+                }
+                return proxyFor(child, joinPath(path, child.at));
+            },
+        });
+    }
+    if (producer.kind === "array") {
+        const node = producer;
+        const token = { [TOKEN]: "array", producer, path };
+        return new Proxy(token, {
+            get(target, key) {
+                if (key === "each") {
+                    return (fn) => {
+                        const itemSel = fn(proxyFor(node.item, ""));
+                        return { [TOKEN]: "each", producer, path, itemSel };
+                    };
+                }
+                if (typeof key === "symbol" || Reflect.has(target, key)) {
+                    return readOwn(target, key);
+                }
+                throw new Error("project: use .each() to select array elements");
+            },
+        });
+    }
+    if (producer.kind === "oneOf") {
+        // Navigate the merged base + branch fields; selecting one flattens the union.
+        const node = producer;
+        const token = { [TOKEN]: "leaf", producer, path };
+        return new Proxy(token, {
+            get(target, key) {
+                if (typeof key === "symbol" || Reflect.has(target, key)) {
+                    return readOwn(target, key);
+                }
+                const baseField = node.base[key];
+                if (baseField) {
+                    return proxyFor(baseField, joinPath(path, baseField.at));
+                }
+                for (const branch of node.branches) {
+                    const bf = branch.fields[key];
+                    if (bf) {
+                        return proxyFor(bf, joinPath(joinPath(path, branch.at), bf.at));
+                    }
+                }
+                throw new Error(`project: unknown field '${key}' on union`);
+            },
+        });
+    }
+    // Leaf kinds (scalar, code, custom): a terminal token, selected whole.
+    return { [TOKEN]: "leaf", producer, path };
+}
+function isToken(v) {
+    return typeof v === "object" && v !== null && TOKEN in v;
+}
+/** Compile one selection value into a producer. */
+function buildProducer(value) {
+    if (isToken(value)) {
+        const { producer, path } = value;
+        if (value[TOKEN] === "each") {
+            const node = producer;
+            return array({
+                ...(path ? { at: path } : {}),
+                each: node.each,
+                item: object({ fields: buildFields(value.itemSel ?? {}) }),
+            });
+        }
+        // Leaf / whole-object / whole-array: reuse the producer, retarget its `at`.
+        return { ...producer, ...(path ? { at: path } : {}) };
+    }
+    // A plain nested record the caller assembled by hand.
+    return object({ fields: buildFields(value) });
+}
+function buildFields(sel) {
+    const fields = {};
+    for (const [key, value] of Object.entries(sel)) {
+        fields[key] = buildProducer(value);
+    }
+    return fields;
+}
+/**
+ * Compile a selection over `root` into an {@link ObjectProducer}. The result
+ * parses through {@link SchemaParser} like any producer (e.g. via
+ * `BROParser.parseSelection`).
+ */
+export function project(root, select) {
+    const start = root.at ?? "";
+    const selection = select(proxyFor(root, start));
+    return object({
+        fields: buildFields(selection),
+    });
+}
+//# sourceMappingURL=select.js.map

package/dist/core/select.js.map

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

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

@@ -5,7 +5,9 @@
  * supported by this library. Uses graceful degradation for same
  * major versions with warnings.
  */
-export type DataType = "CPT" | "BHR-GT" | "BHR-G" | "GMW" | "GLD";
+import type { BROFileType } from "../types/index.js";
+/** Alias of the canonical {@link BROFileType} union (single source in `types/index`). */
+export type DataType = BROFileType;
 /**
  * Schema version info
  */

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

@@ -1 +1 @@
-{"version":3,"file":"version-detector.d.ts","sourceRoot":"","sources":["../../src/core/version-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,MAAM,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,CAAC;AAElE;;GAEG;AACH,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAyFD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB;AA4DD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,QAAQ,GACrB,sBAAsB,CA6GxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,GACZ;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiC/D"}
+{"version":3,"file":"version-detector.d.ts","sourceRoot":"","sources":["../../src/core/version-detector.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAErD,yFAAyF;AACzF,MAAM,MAAM,QAAQ,GAAG,WAAW,CAAC;AAEnC;;GAEG;AACH,UAAU,iBAAiB;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAmHD;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;;;CAMrB,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;CACzB;AAmCD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,QAAQ,EACb,YAAY,EAAE,QAAQ,GACrB,sBAAsB,CA2HxB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,GACZ;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAiC/D"}