@push.rocks/smartlinuxrepo 1.1.2 → 1.2.0

package/dist_ts/rpm/repodatareader.js

@@ -0,0 +1,414 @@
+import { LinuxRepoError, limitExceeded } from '../shared/errors.js';
+import { resolveLinuxPackageLimits } from '../shared/limits.js';
+import { assertLinuxCompression, assertReaderBytes, assertReaderInput, readIndexDocument } from '../readers/document.js';
+import { scanXmlDocument } from './xmlreader.js';
+const DOCUMENTS = new Map([
+    ['primary', 'metadata'],
+    ['filelists', 'filelists'],
+    ['other', 'otherdata'],
+]);
+/**
+ * Reads a `primary`, `filelists` or `other` document (`.xml`, `.xml.gz`,
+ * `.xml.xz`, `.xml.zst`; the caller names `compression` and `document`) into
+ * its frame and `<package>` units. The XML rules are the strict scanner's
+ * (see `IRpmXmlFrame`; any refusal is `malformed-index`): the root must be
+ * `<metadata>`, `<filelists>` or `<otherdata>` for the document, and its
+ * children `<package>` elements with only whitespace between them, which is
+ * not returned. A package without its key (primary `<checksum pkgid="YES">`,
+ * filelists and other `pkgid`) is `missing-field` (`pkgid`); a package with
+ * two of an element the view reads (`<name>`, `<arch>`, `<version>`, `<size>`,
+ * a key `<checksum>`) is `malformed-index`.
+ *
+ * Bounds: the decoded document by `maxIndexBytes`, packages and files per
+ * package by `maxEntries`, one package by `maxMetadataBytes`, one start tag
+ * by `maxHeaderBytes`. Duplicates are kept; all bytes are views into `decoded`.
+ */
+export async function readRpmRepodata(inputArg) {
+    assertReaderInput(inputArg);
+    assertReaderBytes(inputArg.bytes);
+    assertLinuxCompression(inputArg.compression);
+    const document = inputArg.document;
+    const rootName = typeof document === 'string' ? DOCUMENTS.get(document) : undefined;
+    if (rootName === undefined) {
+        throw new LinuxRepoError('invalid-input', "document must be 'primary', 'filelists' or 'other'", {
+            field: 'document',
+            value: typeof document === 'string' ? document : typeof document,
+        });
+    }
+    const limits = resolveLinuxPackageLimits(inputArg.limits);
+    const decoded = await readIndexDocument(inputArg.bytes, inputArg.compression, limits);
+    const packages = [];
+    const frame = scanXmlDocument(decoded, {
+        rootName,
+        unitName: 'package',
+        keepOtherChildren: false,
+        limits,
+        createUnit: (startArg) => new PackageHandler(document, startArg, limits),
+        unit: (handlerArg, startArg, endArg) => {
+            packages.push(handlerArg.result(decoded.subarray(startArg, endArg)));
+        },
+        other: () => undefined,
+    });
+    return { ...frameOf(decoded, rootName, frame), decoded, document, packages };
+}
+/**
+ * Reads an `updateinfo` document into its frame and `<update>` units: the
+ * root must be `<updates>`, the unit key is the `<id>` text (none is
+ * `missing-field`, two are `malformed-index`), and the packages are the
+ * `<pkglist><collection short><package …><filename>` entries in order (a
+ * package with two `<filename>` elements is `malformed-index`). XML rules,
+ * bounds and ownership as `readRpmRepodata`; packages per update count against
+ * `maxEntries`.
+ */
+export async function readRpmUpdateInfo(inputArg) {
+    assertReaderInput(inputArg);
+    assertReaderBytes(inputArg.bytes);
+    assertLinuxCompression(inputArg.compression);
+    const limits = resolveLinuxPackageLimits(inputArg.limits);
+    const decoded = await readIndexDocument(inputArg.bytes, inputArg.compression, limits);
+    const updates = [];
+    const frame = scanXmlDocument(decoded, {
+        rootName: 'updates',
+        unitName: 'update',
+        keepOtherChildren: false,
+        limits,
+        createUnit: (startArg) => new UpdateHandler(startArg, limits),
+        unit: (handlerArg, startArg, endArg) => {
+            updates.push(handlerArg.result(decoded.subarray(startArg, endArg)));
+        },
+        other: () => undefined,
+    });
+    return { ...frameOf(decoded, 'updates', frame), decoded, updates };
+}
+/**
+ * Reads a plain `repomd.xml` into its frame, `<data>` units and the other
+ * root children (kept raw, in `otherElements`). A `<data>` without a `type`
+ * attribute, `<checksum>` or `<location href>` is `missing-field`; a `<data>`
+ * with two of `<checksum>`, `<open-checksum>`, `<location>`, `<timestamp>`,
+ * `<size>` or `<open-size>` is `malformed-index`. XML rules and bounds as
+ * `readRpmRepodata` (the plain input counts against `maxIndexBytes`); all
+ * bytes are views into a copy of the input.
+ */
+export async function readRpmRepomd(inputArg) {
+    assertReaderInput(inputArg);
+    assertReaderBytes(inputArg.bytes);
+    const limits = resolveLinuxPackageLimits(inputArg.limits);
+    const decoded = await readIndexDocument(inputArg.bytes, 'none', limits);
+    const data = [];
+    const otherElements = [];
+    const frame = scanXmlDocument(decoded, {
+        rootName: 'repomd',
+        unitName: 'data',
+        keepOtherChildren: true,
+        limits,
+        createUnit: (startArg) => new RepomdDataHandler(startArg),
+        unit: (handlerArg, startArg, endArg) => {
+            data.push(handlerArg.result(decoded.subarray(startArg, endArg)));
+        },
+        other: (nameArg, startArg, endArg) => {
+            otherElements.push({ name: nameArg, bytes: decoded.subarray(startArg, endArg), offset: startArg });
+        },
+    });
+    return { ...frameOf(decoded, 'repomd', frame), data, otherElements };
+}
+function frameOf(decodedArg, rootNameArg, frameArg) {
+    return {
+        prolog: decodedArg.subarray(0, frameArg.rootStart),
+        rootName: rootNameArg,
+        rootStartTag: decodedArg.subarray(frameArg.rootStart, frameArg.rootStartEnd),
+        rootAttributes: frameArg.rootAttributes.map((attribute) => ({ name: attribute.name, value: attribute.value })),
+        namespace: attributeOf(frameArg.rootAttributes, 'xmlns'),
+        rootEndTag: decodedArg.subarray(frameArg.rootEndStart, frameArg.rootEnd),
+        trailer: decodedArg.subarray(frameArg.rootEnd),
+    };
+}
+function attributeOf(attributesArg, nameArg) {
+    return attributesArg.find((attribute) => attribute.name === nameArg)?.value ?? '';
+}
+function hasAttribute(attributesArg, nameArg) {
+    return attributesArg.some((attribute) => attribute.name === nameArg);
+}
+/** The path of open element names inside one unit, for the handlers' context. */
+class UnitHandler {
+    offset;
+    path = [];
+    constructor(offset) {
+        this.offset = offset;
+    }
+    start(depthArg, nameArg, attributesArg) {
+        const capture = this.open(depthArg, nameArg, attributesArg);
+        this.path.push(nameArg);
+        return capture;
+    }
+    end(depthArg, nameArg, textArg) {
+        this.path.pop();
+        this.close(depthArg, nameArg, textArg);
+    }
+    /** The parent element's name at `depthArg` (the unit element at depth 1). */
+    parent() {
+        return this.path[this.path.length - 1];
+    }
+    duplicate(whatArg) {
+        return new LinuxRepoError('malformed-index', `a unit holds two ${whatArg} elements`, { field: whatArg, value: this.offset });
+    }
+}
+class PackageHandler extends UnitHandler {
+    document;
+    limits;
+    pkgid = null;
+    name = null;
+    arch = null;
+    version = null;
+    size = null;
+    files = [];
+    fileType = '';
+    constructor(document, offsetArg, limits) {
+        super(offsetArg);
+        this.document = document;
+        this.limits = limits;
+    }
+    open(depthArg, nameArg, attributesArg) {
+        if (depthArg === 0) {
+            if (this.document !== 'primary') {
+                if (!hasAttribute(attributesArg, 'pkgid')) {
+                    throw this.missingKey();
+                }
+                this.pkgid = attributeOf(attributesArg, 'pkgid');
+                this.name = attributeOf(attributesArg, 'name');
+                this.arch = attributeOf(attributesArg, 'arch');
+            }
+            return false;
+        }
+        const parent = this.parent();
+        if (depthArg === 1) {
+            if (nameArg === 'version') {
+                if (this.version !== null) {
+                    throw this.duplicate('<version>');
+                }
+                this.version = {
+                    epoch: attributeOf(attributesArg, 'epoch'),
+                    version: attributeOf(attributesArg, 'ver'),
+                    release: attributeOf(attributesArg, 'rel'),
+                };
+                return false;
+            }
+            if (this.document === 'primary') {
+                if (nameArg === 'name' || nameArg === 'arch') {
+                    return true;
+                }
+                if (nameArg === 'checksum') {
+                    return attributeOf(attributesArg, 'pkgid') === 'YES';
+                }
+                if (nameArg === 'size') {
+                    if (this.size !== null) {
+                        throw this.duplicate('<size>');
+                    }
+                    this.size = {
+                        package: attributeOf(attributesArg, 'package'),
+                        installed: attributeOf(attributesArg, 'installed'),
+                        archive: attributeOf(attributesArg, 'archive'),
+                    };
+                    return false;
+                }
+                return false;
+            }
+            if (this.document === 'filelists' && nameArg === 'file') {
+                return this.openFile(attributesArg);
+            }
+            return false;
+        }
+        if (depthArg === 2 && this.document === 'primary' && parent === 'format' && nameArg === 'file') {
+            return this.openFile(attributesArg);
+        }
+        return false;
+    }
+    close(depthArg, nameArg, textArg) {
+        if (textArg === null) {
+            return;
+        }
+        if (nameArg === 'file') {
+            this.files.push({ path: textArg, type: this.fileType });
+        }
+        else if (nameArg === 'name') {
+            if (this.name !== null) {
+                throw this.duplicate('<name>');
+            }
+            this.name = textArg;
+        }
+        else if (nameArg === 'arch') {
+            if (this.arch !== null) {
+                throw this.duplicate('<arch>');
+            }
+            this.arch = textArg;
+        }
+        else if (nameArg === 'checksum') {
+            if (this.pkgid !== null) {
+                throw this.duplicate('<checksum pkgid="YES">');
+            }
+            this.pkgid = textArg;
+        }
+    }
+    openFile(attributesArg) {
+        if (this.files.length + 1 > this.limits.maxEntries) {
+            throw limitExceeded('maxEntries', this.limits.maxEntries, 'files per package');
+        }
+        this.fileType = attributeOf(attributesArg, 'type');
+        return true;
+    }
+    missingKey() {
+        return new LinuxRepoError('missing-field', `a ${this.document} <package> has no pkgid`, { field: 'pkgid', value: this.offset });
+    }
+    result(bytesArg) {
+        if (this.pkgid === null) {
+            throw this.missingKey();
+        }
+        return {
+            bytes: bytesArg,
+            offset: this.offset,
+            pkgid: this.pkgid,
+            name: this.name ?? '',
+            arch: this.arch ?? '',
+            epoch: this.version?.epoch ?? '',
+            version: this.version?.version ?? '',
+            release: this.version?.release ?? '',
+            size: this.size,
+            files: this.files,
+        };
+    }
+}
+class UpdateHandler extends UnitHandler {
+    limits;
+    id = null;
+    collection = '';
+    pending = null;
+    packages = [];
+    constructor(offsetArg, limits) {
+        super(offsetArg);
+        this.limits = limits;
+    }
+    open(depthArg, nameArg, attributesArg) {
+        const parent = this.parent();
+        if (depthArg === 1 && nameArg === 'id') {
+            return true;
+        }
+        if (depthArg === 2 && parent === 'pkglist' && nameArg === 'collection') {
+            this.collection = attributeOf(attributesArg, 'short');
+            return false;
+        }
+        if (depthArg === 3 && parent === 'collection' && this.path[1] === 'pkglist' && nameArg === 'package') {
+            if (this.packages.length + 1 > this.limits.maxEntries) {
+                throw limitExceeded('maxEntries', this.limits.maxEntries, 'packages per update');
+            }
+            this.pending = { attributes: attributesArg, fileName: null };
+            return false;
+        }
+        if (depthArg === 4 && parent === 'package' && this.pending !== null && nameArg === 'filename') {
+            return true;
+        }
+        return false;
+    }
+    close(depthArg, nameArg, textArg) {
+        if (depthArg === 1 && nameArg === 'id' && textArg !== null) {
+            if (this.id !== null) {
+                throw this.duplicate('<id>');
+            }
+            this.id = textArg;
+        }
+        else if (depthArg === 4 && nameArg === 'filename' && textArg !== null && this.pending !== null) {
+            if (this.pending.fileName !== null) {
+                throw this.duplicate('<filename>');
+            }
+            this.pending.fileName = textArg;
+        }
+        else if (depthArg === 3 && nameArg === 'package' && this.pending !== null) {
+            const attributes = this.pending.attributes;
+            this.packages.push({
+                collection: this.collection,
+                name: attributeOf(attributes, 'name'),
+                epoch: attributeOf(attributes, 'epoch'),
+                version: attributeOf(attributes, 'version'),
+                release: attributeOf(attributes, 'release'),
+                arch: attributeOf(attributes, 'arch'),
+                src: attributeOf(attributes, 'src'),
+                fileName: this.pending.fileName ?? '',
+            });
+            this.pending = null;
+        }
+        else if (depthArg === 2 && nameArg === 'collection') {
+            this.collection = '';
+        }
+    }
+    result(bytesArg) {
+        if (this.id === null) {
+            throw new LinuxRepoError('missing-field', 'an <update> has no <id>', { field: 'id', value: this.offset });
+        }
+        return { bytes: bytesArg, offset: this.offset, id: this.id, packages: this.packages };
+    }
+}
+class RepomdDataHandler extends UnitHandler {
+    type = null;
+    values = new Map();
+    pendingType = '';
+    open(depthArg, nameArg, attributesArg) {
+        if (depthArg === 0) {
+            if (hasAttribute(attributesArg, 'type')) {
+                this.type = attributeOf(attributesArg, 'type');
+            }
+            return false;
+        }
+        if (depthArg !== 1) {
+            return false;
+        }
+        switch (nameArg) {
+            case 'checksum':
+            case 'open-checksum':
+            case 'timestamp':
+            case 'size':
+            case 'open-size':
+            case 'location':
+                if (this.values.has(nameArg)) {
+                    throw this.duplicate(`<${nameArg}>`);
+                }
+                if (nameArg === 'location') {
+                    this.values.set(nameArg, { type: '', text: hasAttribute(attributesArg, 'href') ? attributeOf(attributesArg, 'href') : null });
+                    return false;
+                }
+                this.pendingType = attributeOf(attributesArg, 'type');
+                return true;
+            default:
+                return false;
+        }
+    }
+    close(depthArg, nameArg, textArg) {
+        if (depthArg === 1 && textArg !== null) {
+            this.values.set(nameArg, { type: this.pendingType, text: textArg });
+        }
+    }
+    result(bytesArg) {
+        const missing = (fieldArg) => new LinuxRepoError('missing-field', `a repomd <data> has no ${fieldArg}`, { field: fieldArg, value: this.offset });
+        if (this.type === null) {
+            throw missing('type');
+        }
+        const checksum = this.values.get('checksum');
+        if (checksum === undefined || checksum.text === null) {
+            throw missing('checksum');
+        }
+        const location = this.values.get('location');
+        if (location === undefined || location.text === null) {
+            throw missing('location');
+        }
+        const openChecksum = this.values.get('open-checksum');
+        return {
+            bytes: bytesArg,
+            offset: this.offset,
+            type: this.type,
+            location: location.text,
+            checksum: { type: checksum.type, value: checksum.text },
+            openChecksum: openChecksum === undefined || openChecksum.text === null ? null : { type: openChecksum.type, value: openChecksum.text },
+            timestamp: this.values.get('timestamp')?.text ?? null,
+            size: this.values.get('size')?.text ?? null,
+            openSize: this.values.get('open-size')?.text ?? null,
+        };
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicmVwb2RhdGFyZWFkZXIuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi90cy9ycG0vcmVwb2RhdGFyZWFkZXIudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLGNBQWMsRUFBRSxhQUFhLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNwRSxPQUFPLEVBQUUseUJBQXlCLEVBQTRCLE1BQU0scUJBQXFCLENBQUM7QUFFMUYsT0FBTyxFQUFFLHNCQUFzQixFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLGlCQUFpQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFDekgsT0FBTyxFQUFFLGVBQWUsRUFBZ0UsTUFBTSxnQkFBZ0IsQ0FBQztBQXFJL0csTUFBTSxTQUFTLEdBQWdDLElBQUksR0FBRyxDQUErQjtJQUNuRixDQUFDLFNBQVMsRUFBRSxVQUFVLENBQUM7SUFDdkIsQ0FBQyxXQUFXLEVBQUUsV0FBVyxDQUFDO0lBQzFCLENBQUMsT0FBTyxFQUFFLFdBQVcsQ0FBQztDQUN2QixDQUFDLENBQUM7QUFFSDs7Ozs7Ozs7Ozs7Ozs7O0dBZUc7QUFDSCxNQUFNLENBQUMsS0FBSyxVQUFVLGVBQWUsQ0FBQyxRQUtyQztJQUNDLGlCQUFpQixDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzVCLGlCQUFpQixDQUFDLFFBQVEsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUNsQyxzQkFBc0IsQ0FBQyxRQUFRLENBQUMsV0FBVyxDQUFDLENBQUM7SUFDN0MsTUFBTSxRQUFRLEdBQUcsUUFBUSxDQUFDLFFBQVEsQ0FBQztJQUNuQyxNQUFNLFFBQVEsR0FBRyxPQUFPLFFBQVEsS0FBSyxRQUFRLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztJQUNwRixJQUFJLFFBQVEsS0FBSyxTQUFTLEVBQUUsQ0FBQztRQUMzQixNQUFNLElBQUksY0FBYyxDQUFDLGVBQWUsRUFB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

package/dist_ts/rpm/xmlreader.d.ts

@@ -0,0 +1,70 @@
+import type { ILinuxPackageLimits } from '../shared/limits.js';
+/**
+ * A strict, iterative XML 1.0 scanner over the bytes of one repodata document,
+ * the reading side of `xml.ts`. It checks well-formedness and hands the
+ * elements of each unit (a child of the root) to a handler, without building a
+ * tree. Every refusal is `malformed-index` with the byte offset in
+ * `detail.value`:
+ * - the document must be strict UTF-8 holding only XML characters; an
+ *   optional UTF-8 byte order mark and XML declaration may lead it, and a
+ *   declared `encoding` other than UTF-8 (ASCII case-insensitive) is refused;
+ * - `<!DOCTYPE` (or any other `<!` declaration) is refused, so there are no
+ *   entity definitions: only `&lt; &gt; &amp; &apos; &quot;` and numeric
+ *   references to XML characters are accepted;
+ * - tags must match, attribute names must be unique within a tag and be
+ *   separated by whitespace, values are quoted and hold no `<`, text holds no
+ *   `]]>`, comments hold no `--`, a processing instruction's target is not
+ *   `xml` (except the declaration at the start), and there is exactly one root;
+ * - comments, processing instructions and whitespace may sit before and after
+ *   the root; inside it only whitespace may sit between units; inside a unit
+ *   CDATA sections, comments, processing instructions and empty-element tags
+ *   are accepted.
+ *
+ * Names are matched literally with their prefixes (no namespace processing);
+ * a name starts with an ASCII letter, `_`, `:` or a non-ASCII character and
+ * continues with those, digits, `.` and `-` (every non-ASCII character counts
+ * as a name character, a simplification of the XML name production). Values
+ * handed to the handler are decoded: references replaced, line ends
+ * normalized (CRLF and CR to LF), and in attribute values literal tabs and
+ * line ends become spaces (XML 1.0 sections 2.11 and 3.3.3).
+ *
+ * Bounds: one start tag by `maxHeaderBytes`, one unit by `maxMetadataBytes`,
+ * units and open elements at a time by `maxEntries`.
+ */
+export interface IXmlAttribute {
+    readonly name: string;
+    readonly value: string;
+}
+/** Receives the elements of one unit; `depth` 0 is the unit element itself. */
+export interface IXmlUnitHandler {
+    /** An element starts; returning true captures its direct character data for `end`. */
+    start(depthArg: number, nameArg: string, attributesArg: readonly IXmlAttribute[]): boolean;
+    /** An element ends; `textArg` is its captured character data, or null when not captured. */
+    end(depthArg: number, nameArg: string, textArg: string | null): void;
+}
+export interface IXmlScanOptions {
+    /** The required root element name. */
+    rootName: string;
+    /** The unit element name among the root's children. */
+    unitName: string;
+    /** Whether other root children are accepted (repomd); otherwise they are refused. */
+    keepOtherChildren: boolean;
+    limits: Readonly<ILinuxPackageLimits>;
+    /** A handler for the unit starting at `startArg` (the offset of its `<`). */
+    createUnit(startArg: number): IXmlUnitHandler;
+    /** A unit ended: its bytes are `[startArg, endArg)`. */
+    unit(handlerArg: IXmlUnitHandler, startArg: number, endArg: number): void;
+    /** Another root child ended (only with `keepOtherChildren`). */
+    other(nameArg: string, startArg: number, endArg: number): void;
+}
+/** Where the root element's tags sit in the document. */
+export interface IXmlFrameScan {
+    rootStart: number;
+    rootStartEnd: number;
+    rootAttributes: IXmlAttribute[];
+    /** The root end tag `[rootEndStart, rootEnd)`; both equal `rootStartEnd` for an empty-element root. */
+    rootEndStart: number;
+    rootEnd: number;
+}
+/** Scans one document; see the module comment. */
+export declare function scanXmlDocument(documentArg: Uint8Array, optionsArg: IXmlScanOptions): IXmlFrameScan;