@jerp/xml-stream-ts 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jerome
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,116 @@
+# @jerp/xml-stream-ts
+
+A small TypeScript XML stream parser for extracting selected elements, text, attributes, and comments from arbitrarily chunked input.
+
+It is designed for event-style parsing: define the tags you care about, stream bytes in, and receive parsed results as the matching root elements close. Unmatched branches are skipped.
+
+## Install
+
+```sh
+npm install @jerp/xml-stream-ts
+```
+
+## Usage
+
+```ts
+import {
+  createParser,
+  decimal,
+  leafParser,
+  NamespaceMap,
+  rootResolver,
+  stringTextContent,
+} from '@jerp/xml-stream-ts'
+
+interface Book {
+  lang?: string | null
+  title?: string | null
+  price?: number | null
+}
+
+const nsMap = NamespaceMap.create({
+  '': 'urn:book',
+  xml: 'http://www.w3.org/XML/1998/namespace',
+})
+
+const book = rootResolver<Book>()('book', nsMap, {
+  attributes: ['xml:lang'] as const,
+  onStart(attributes) {
+    this.lang = stringTextContent(attributes.lang)
+  },
+  onEnd() {
+    return {
+      lang: this.lang,
+      title: this.title,
+      price: this.price,
+    }
+  },
+})
+
+book.onLeaf('title', leafParser<Book>()({
+  onTextContent(textContent) {
+    this.title = stringTextContent(textContent)
+  },
+}))
+
+book.onLeaf('price', leafParser<Book>()({
+  onTextContent(textContent) {
+    this.price = decimal(textContent)
+  },
+}))
+
+const parser = createParser<Book>(book, {})
+const writer = parser.writable.getWriter()
+
+await writer.write(new TextEncoder().encode('<book xmlns="urn:book" xml:lang="en">'))
+await writer.write(new TextEncoder().encode('<title>XML Guide</title><price>19.95</price></book>'))
+await writer.close()
+
+for await (const book of parser.readable) {
+  console.log(book)
+  // { lang: 'en', title: 'XML Guide', price: 19.95 }
+}
+```
+
+## Typed Resolvers
+
+`rootResolver`, `tagParser`, and `leafParser` are convenience helpers around `TagResolver`. They keep resolver declarations readable while preserving TypeScript validation for callback `this` values and attribute names.
+
+Use `as const` on `attributes` when you want precise keys in `onStart`:
+
+```ts
+const root = rootResolver<Book>()('book', nsMap, {
+  attributes: ['xml:lang', 'id'] as const,
+  onStart(attributes) {
+    attributes.lang // Uint8Array | undefined
+    attributes.id // Uint8Array | undefined
+  },
+})
+```
+
+Namespaced attribute keys use the local name at runtime, so `xml:lang` is read as `attributes.lang`.
+
+The parser callbacks receive `Uint8Array` text. Use the exported value resolvers to decode only when needed:
+
+```ts
+stringTextContent(bytes) // string | null
+decimal(bytes) // number | null
+```
+
+## Scope
+
+This library parses XML elements, text, comments, attributes, namespaces, and CDATA. Processing instructions and declarations are skipped. Unmatched element branches are skipped without building a DOM.
+
+Input is accepted as `Uint8Array` chunks through a `WritableStream`, and chunks may split anywhere in the document, including inside tag names, attributes, comments, and text.
+
+## Development
+
+```sh
+npm install
+npm run build
+npm test
+```
+
+## Publishing
+
+This package is intended to be published as `@jerp/xml-stream-ts` using npm Trusted Publishing from GitHub Actions.

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createParser } from './parser.ts';
+export { NamespaceMap } from './names.ts';
+export type { FQName, Namespace } from './names.ts';
+export { leafParser, rootResolver, TagResolver, tagParser } from './tagParser.ts';
+export type { LeafTagParser, LeafTagParserConfig, TagAttribute, TagAttributes, TagParser, TagParserConfig } from './tagParser.ts';
+export * from './valueResolver.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AACzC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnD,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AACjF,YAAY,EAAE,aAAa,EAAE,mBAAmB,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACjI,cAAc,oBAAoB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { createParser } from "./parser.js";
+export { NamespaceMap } from "./names.js";
+export { leafParser, rootResolver, TagResolver, tagParser } from "./tagParser.js";
+export * from "./valueResolver.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAEzC,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAEjF,cAAc,oBAAoB,CAAA"}

package/dist/names.d.ts

@@ -0,0 +1,39 @@
+import type { TagResolver } from "./tagParser.ts";
+export declare const NO_XML_PREFIX: Uint8Array<ArrayBuffer>;
+export declare const PREDEFINED_XML_NAMESPACE: Namespace;
+export declare const XMLNS_NAMESPACE: Namespace;
+export interface Namespace {
+    readonly prefix: string;
+    readonly uri: string;
+}
+export interface FQName {
+    readonly namespace: Namespace;
+    readonly name: string;
+}
+export declare class TagNameMatcher<T> {
+    private nameMap;
+    setName(resolver: TagResolver<T>, tagName: string, namespace?: Namespace): void;
+    find(bytes: Uint8Array<ArrayBuffer>, begin: number, length: number, namespace?: Namespace): {
+        fqName: FQName;
+        resolver: TagResolver<T>;
+    } | undefined;
+}
+export declare class AttributeNameMatcher {
+    private nameMap;
+    setName(attributeName: string, namespace?: Namespace): void;
+    find(bytes: Uint8Array<ArrayBuffer>, begin: number, length: number, namespace?: Namespace): FQName | undefined;
+}
+export declare class NamespaceMap {
+    prefixes: Readonly<Uint8Array<ArrayBuffer>>[];
+    uris: Readonly<Uint8Array<ArrayBuffer>>[];
+    namespaces: Namespace[];
+    private constructor();
+    static create(nsMap: Record<string, string>): NamespaceMap;
+    registerNS(prefixBuffer: Uint8Array<ArrayBuffer> | null, nsUriBuffer: Uint8Array<ArrayBuffer>): NamespaceMap;
+    resolveNamespace(bytes: ArrayLike<number>, begin: number, prefixLength: number): Namespace;
+    get(prefix?: string): Namespace | undefined;
+    private indexOfPrefix;
+    private indexOfUri;
+    private print;
+}
+//# sourceMappingURL=names.d.ts.map

package/dist/names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"names.d.ts","sourceRoot":"","sources":["../src/names.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,aAAa,yBAAoB,CAAA;AAM9C,eAAO,MAAM,wBAAwB,EAAE,SAAsE,CAAA;AAC7G,eAAO,MAAM,eAAe,EAAE,SAAoD,CAAA;AAElF,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;AAKD,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,OAAO,CAAwH;IACvI,OAAO,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,GAAE,SAAoC;IAYlG,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAoC,GAAG;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,SAAS;CAS/K;AACD,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,OAAO,CAA6F;IAC5G,OAAO,CAAC,aAAa,EAAE,MAAM,EAAE,SAAS,GAAE,SAAoC;IAY9E,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAE,SAAoC,GAAG,MAAM,GAAG,SAAS;CASzI;AAED,qBAAa,YAAY;IACvB,QAAQ,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAA;IAC7C,IAAI,EAAE,QAAQ,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,EAAE,CAAA;IACzC,UAAU,EAAE,SAAS,EAAE,CAAA;IACvB,OAAO;IAKP,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;IAS3C,UAAU,CAAC,YAAY,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,IAAI,EAAE,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,GAAG,YAAY;IAmB5G,gBAAgB,CAAC,KAAK,EAAE,SAAS,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,SAAS;IAiB1F,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS;IAI3C,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,KAAK;CAKd"}

package/dist/names.js

@@ -0,0 +1,141 @@
+export const NO_XML_PREFIX = new Uint8Array(0);
+const PREDEFINED_XML_PREFIX = "xml";
+const PREDEFINED_XML_URI = 'http://www.w3.org/XML/1998/namespace';
+const XMLNS_PREFIX = "xmlns";
+const XMLNS_URI = 'http://www.w3.org/2000/xmlns/';
+export const PREDEFINED_XML_NAMESPACE = { prefix: PREDEFINED_XML_PREFIX, uri: PREDEFINED_XML_URI };
+export const XMLNS_NAMESPACE = { prefix: XMLNS_PREFIX, uri: XMLNS_URI };
+const textDecoder = new TextDecoder();
+const textEncoder = new TextEncoder();
+export class TagNameMatcher {
+    nameMap = new Map();
+    setName(resolver, tagName, namespace = PREDEFINED_XML_NAMESPACE) {
+        for (const [ns, localNames] of this.nameMap.entries()) {
+            if (ns === namespace && localNames.some(({ fqName }) => fqName.name === tagName)) {
+                return;
+            }
+        }
+        if (!this.nameMap.has(namespace)) {
+            this.nameMap.set(namespace, []);
+        }
+        const name = textEncoder.encode(tagName);
+        this.nameMap.get(namespace).push({ name, fqName: { name: tagName, namespace }, resolver });
+    }
+    find(bytes, begin, length, namespace = PREDEFINED_XML_NAMESPACE) {
+        const fqNameMatches = this.nameMap.get(namespace);
+        if (fqNameMatches) {
+            const matched = fqNameMatches.find(({ name }) => name.length === length && name.every((value, index) => value === bytes[begin + index]));
+            if (matched) {
+                return { fqName: matched.fqName, resolver: matched.resolver };
+            }
+        }
+    }
+}
+export class AttributeNameMatcher {
+    nameMap = new Map();
+    setName(attributeName, namespace = PREDEFINED_XML_NAMESPACE) {
+        for (const [ns, localNames] of this.nameMap.entries()) {
+            if (ns === namespace && localNames.some(({ fqName }) => fqName.name === attributeName)) {
+                return;
+            }
+        }
+        if (!this.nameMap.has(namespace)) {
+            this.nameMap.set(namespace, []);
+        }
+        const name = textEncoder.encode(attributeName);
+        this.nameMap.get(namespace).push({ name, fqName: { name: attributeName, namespace } });
+    }
+    find(bytes, begin, length, namespace = PREDEFINED_XML_NAMESPACE) {
+        const fqNameMatches = this.nameMap.get(namespace);
+        if (fqNameMatches) {
+            const matched = fqNameMatches.find(({ name }) => name.length === length && name.every((value, index) => value === bytes[begin + index]));
+            if (matched) {
+                return matched.fqName;
+            }
+        }
+    }
+}
+export class NamespaceMap {
+    prefixes;
+    uris;
+    namespaces;
+    constructor(prefixes, uris, namespaces) {
+        this.prefixes = prefixes;
+        this.uris = uris;
+        this.namespaces = namespaces;
+    }
+    static create(nsMap) {
+        const nsList = Object.entries(nsMap).filter(([prefix, uri]) => {
+            return prefix !== 'xml' && uri !== PREDEFINED_XML_URI && prefix !== 'xmlns' && uri !== XMLNS_URI;
+        }).map(([prefix, uri]) => ({ prefix, uri }));
+        const prefixes = [PREDEFINED_XML_PREFIX, XMLNS_PREFIX].concat(nsList.map(ns => ns.prefix)).map(prefix => textEncoder.encode(prefix));
+        const uris = [PREDEFINED_XML_URI, XMLNS_URI].concat(nsList.map(ns => ns.uri)).map(uri => textEncoder.encode(uri));
+        const namespaces = [PREDEFINED_XML_NAMESPACE, XMLNS_NAMESPACE].concat(nsList);
+        return new NamespaceMap(prefixes, uris, namespaces);
+    }
+    registerNS(prefixBuffer, nsUriBuffer) {
+        const prefixIndex = this.indexOfUri(nsUriBuffer);
+        if (prefixIndex === -1) {
+            const prefix = prefixBuffer ? prefixBuffer.slice() : NO_XML_PREFIX;
+            this.prefixes.push(prefix);
+            this.uris.push(nsUriBuffer.slice());
+            this.namespaces.push({ prefix: textDecoder.decode(prefix), uri: textDecoder.decode(nsUriBuffer) });
+            return this;
+        }
+        else {
+            const existingPrefixIndex = this.indexOfPrefix(prefixBuffer ?? NO_XML_PREFIX);
+            if (existingPrefixIndex === prefixIndex) {
+                return this;
+            }
+            const clonedPrefixes = this.prefixes.slice();
+            clonedPrefixes[prefixIndex] = prefixBuffer ? prefixBuffer.slice() : NO_XML_PREFIX;
+            const clonedMap = new NamespaceMap(clonedPrefixes, this.uris, this.namespaces);
+            return clonedMap;
+        }
+    }
+    resolveNamespace(bytes, begin, prefixLength) {
+        for (let i = this.prefixes.length - 1; i >= 0; i--) {
+            const prefix = this.prefixes[i];
+            if (prefix.length !== prefixLength)
+                continue;
+            let matches = true;
+            for (let o = 0; o < prefixLength; o++) {
+                if (prefix[o] !== bytes[begin + o]) {
+                    matches = false;
+                    break;
+                }
+            }
+            if (matches) {
+                return this.namespaces[i];
+            }
+        }
+        return PREDEFINED_XML_NAMESPACE;
+    }
+    get(prefix) {
+        return this.namespaces.find(ns => ns.prefix === prefix);
+    }
+    indexOfPrefix(prefixBuffer) {
+        for (let i = this.prefixes.length - 1; i >= 0; i--) {
+            const prefix = this.prefixes[i];
+            if (prefixBuffer.length === prefix.length && prefixBuffer.every((value, index) => value === prefix[index])) {
+                return i;
+            }
+        }
+        return -1;
+    }
+    indexOfUri(uriBuffer) {
+        for (let i = this.uris.length - 1; i >= 0; i--) {
+            const uri = this.uris[i];
+            if (uriBuffer.length === uri.length && uriBuffer.every((value, index) => value === uri[index]))
+                return i;
+        }
+        return -1;
+    }
+    // @ts-ignore
+    print() {
+        const textDecoder = new TextDecoder();
+        const lines = this.namespaces.slice(2).map((ns, i) => `${textDecoder.decode(this.prefixes[i])} => ${ns.prefix}:${ns.uri}`);
+        return `NamespaceMap {\n${lines.join('\n  ')}\n}`;
+    }
+}
+//# sourceMappingURL=names.js.map

package/dist/names.js.map

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

package/dist/parser.d.ts

@@ -0,0 +1,29 @@
+import { TagResolver } from "./tagParser.ts";
+declare class XMLTransformStream<T extends any = any> implements TransformStream<Uint8Array<ArrayBuffer>, T> {
+    readonly readable: ReadableStream<T>;
+    readonly writable: WritableStream<Uint8Array<ArrayBuffer>>;
+    constructor(readable: ReadableStream<T>, writable: WritableStream<Uint8Array<ArrayBuffer>>);
+}
+export declare function createParser<C extends object = any>(rootResolver: TagResolver<any, any>, context?: any): XMLTransformStream<C>;
+export declare class TailBuffer {
+    private bytes;
+    private end;
+    private tailByte;
+    private extendCapacityBy;
+    constructor(extendCapacityBy?: number);
+    addChunk(bytes: Uint8Array<ArrayBuffer>): {
+        front: null;
+        tail: Uint8Array<ArrayBuffer>;
+    } | {
+        front: Uint8Array<ArrayBuffer>;
+        tail: Uint8Array<ArrayBuffer>;
+    } | {
+        front: null;
+        tail: null;
+    };
+    saveTail(source: Uint8Array<ArrayBuffer>, begin: number, end: number, tailByte?: number): void;
+    reset(): void;
+    private appendBytes;
+}
+export {};
+//# sourceMappingURL=parser.d.ts.map

package/dist/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAwC5C,cAAM,kBAAkB,CAAC,CAAC,SAAS,GAAG,GAAG,GAAG,CAAE,YAAW,eAAe,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IAClG,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACrC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC,CAAC;gBAC/C,QAAQ,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;CAI3F;AAgBD,wBAAgB,YAAY,CAC1B,CAAC,SAAS,MAAM,GAAG,GAAG,EACtB,YAAY,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,OAAO,GAAE,GAAQ,yBA0evD;AAGD,qBAAa,UAAU;IACrB,OAAO,CAAC,KAAK,CAAyB;IACtC,OAAO,CAAC,GAAG,CAAQ;IACnB,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,gBAAgB,CAAQ;gBACpB,gBAAgB,CAAC,EAAE,MAAM;IAMrC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC;;;;;;;;;;IAyBvC,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,SAAgB;IAU9F,KAAK;IAIL,OAAO,CAAC,WAAW;CAapB"}