@dwk/microsub 0.1.0-beta.0

package/dist/store.js

@@ -0,0 +1,393 @@
+/**
+ * `@dwk/microsub` — D1-backed authoritative state.
+ *
+ * Channels, the feeds each channel follows, the normalised JF2 timeline items,
+ * their per-item read flags, and a small per-feed poll cache (`ETag` /
+ * `Last-Modified`) all live here. This is correctness-sensitive state — a lost
+ * subscription or a dropped read flag is a bug, not a stale cache — so it lives
+ * in D1, a strongly-consistent store, and **never** KV (see
+ * `spec/non-functional-requirements.md`). The schema is created lazily on first
+ * use.
+ *
+ * Timeline paging uses a monotonic `seq` (an autoincrement rowid): the opaque
+ * `before` / `after` cursors a Microsub client round-trips are just `seq`
+ * values, so paging is stable under concurrent inserts and deletes.
+ *
+ * @packageDocumentation
+ */
+/** The reserved channel that always exists and cannot be deleted or renamed. */
+export const NOTIFICATIONS_CHANNEL = "notifications";
+const SCHEMA = [
+    `CREATE TABLE IF NOT EXISTS microsub_channels (
+     uid TEXT PRIMARY KEY,
+     name TEXT NOT NULL,
+     position INTEGER NOT NULL,
+     created_at INTEGER NOT NULL
+   )`,
+    `CREATE TABLE IF NOT EXISTS microsub_follows (
+     channel TEXT NOT NULL,
+     feed_url TEXT NOT NULL,
+     page_url TEXT NOT NULL,
+     created_at INTEGER NOT NULL,
+     PRIMARY KEY (channel, feed_url)
+   )`,
+    `CREATE TABLE IF NOT EXISTS microsub_items (
+     seq INTEGER PRIMARY KEY AUTOINCREMENT,
+     channel TEXT NOT NULL,
+     entry_id TEXT NOT NULL,
+     feed_url TEXT NOT NULL,
+     published INTEGER,
+     is_read INTEGER NOT NULL DEFAULT 0,
+     data TEXT NOT NULL,
+     created_at INTEGER NOT NULL,
+     UNIQUE (channel, entry_id)
+   )`,
+    `CREATE INDEX IF NOT EXISTS microsub_items_channel_seq
+     ON microsub_items (channel, seq)`,
+    `CREATE TABLE IF NOT EXISTS microsub_feeds (
+     feed_url TEXT PRIMARY KEY,
+     etag TEXT,
+     last_modified TEXT,
+     last_polled INTEGER
+   )`,
+];
+function channelFromRow(row) {
+    return {
+        uid: row.uid,
+        name: row.name,
+        position: row.position,
+        createdAt: row.created_at,
+    };
+}
+function itemFromRow(row) {
+    const entry = JSON.parse(row.data);
+    return {
+        seq: row.seq,
+        channel: row.channel,
+        entryId: row.entry_id,
+        feedUrl: row.feed_url,
+        isRead: row.is_read !== 0,
+        entry: { ...entry, _is_read: row.is_read !== 0 },
+    };
+}
+/** Parse a `published` ISO string to an epoch-seconds sort key, or `null`. */
+function publishedToEpoch(entry) {
+    if (!entry.published)
+        return null;
+    const ms = Date.parse(entry.published);
+    return Number.isFinite(ms) ? Math.floor(ms / 1000) : null;
+}
+/** A short, URL-safe channel uid: base36 timestamp plus random suffix. */
+function generateUid() {
+    const time = Date.now().toString(36);
+    const rand = Math.floor(Math.random() * 36 ** 5)
+        .toString(36)
+        .padStart(5, "0");
+    return `${time}${rand}`;
+}
+/**
+ * Create the D1-backed {@link MicrosubStore}. Fails loudly if the required
+ * `MICROSUB_DB` binding is missing — no silent degradation (composition
+ * contract).
+ */
+export function createMicrosubStore(env) {
+    if (!env.MICROSUB_DB) {
+        throw new Error("@dwk/microsub: missing required D1 binding `MICROSUB_DB`");
+    }
+    const db = env.MICROSUB_DB;
+    // The init promise is cached per store instance (not module-globally): the
+    // vitest-pool-workers test model resets D1 between tests while keeping one
+    // `env` singleton, so a global cache would skip re-creating the wiped tables.
+    // This matches `@dwk/websub`'s store. The reserved `notifications` channel is
+    // materialised as part of the same batch, so it always exists after any store
+    // operation — a client may hit `timeline`/`unread` for it on a fresh DB
+    // without first listing channels.
+    let ready = null;
+    const ensureSchema = () => {
+        // Clear the cached promise on failure so a transient D1 error during the
+        // first call doesn't permanently wedge the store.
+        ready ??= db
+            .batch([
+            ...SCHEMA.map((ddl) => db.prepare(ddl)),
+            db
+                .prepare(`INSERT OR IGNORE INTO microsub_channels (uid, name, position, created_at)
+             VALUES (?1, ?2, -1, ?3)`)
+                .bind(NOTIFICATIONS_CHANNEL, "Notifications", Math.floor(Date.now() / 1000)),
+        ])
+            .then(() => undefined)
+            .catch((err) => {
+            ready = null;
+            throw err;
+        });
+        return ready;
+    };
+    const seqOf = async (channel, entryId) => {
+        const row = await db
+            .prepare(`SELECT seq FROM microsub_items WHERE channel = ?1 AND entry_id = ?2`)
+            .bind(channel, entryId)
+            .first();
+        return row?.seq ?? null;
+    };
+    return {
+        async init() {
+            await ensureSchema();
+        },
+        // Channels ------------------------------------------------------------
+        async listChannels() {
+            await ensureSchema();
+            const { results } = await db
+                .prepare(`SELECT uid, name, position, created_at FROM microsub_channels
+           ORDER BY position ASC, created_at ASC`)
+                .all();
+            return results.map(channelFromRow);
+        },
+        async channelExists(uid) {
+            await ensureSchema();
+            const row = await db
+                .prepare(`SELECT 1 AS present FROM microsub_channels WHERE uid = ?1`)
+                .bind(uid)
+                .first();
+            return row !== null;
+        },
+        async createChannel(name, now) {
+            await ensureSchema();
+            const max = await db
+                .prepare(`SELECT MAX(position) AS maxPos FROM microsub_channels`)
+                .first();
+            const position = (max?.maxPos ?? -1) + 1;
+            const uid = generateUid();
+            await db
+                .prepare(`INSERT INTO microsub_channels (uid, name, position, created_at)
+           VALUES (?1, ?2, ?3, ?4)`)
+                .bind(uid, name, position, now)
+                .run();
+            return { uid, name, position, createdAt: now };
+        },
+        async renameChannel(uid, name) {
+            await ensureSchema();
+            if (uid === NOTIFICATIONS_CHANNEL)
+                return null;
+            const result = await db
+                .prepare(`UPDATE microsub_channels SET name = ?2 WHERE uid = ?1`)
+                .bind(uid, name)
+                .run();
+            if (result.meta.changes === 0)
+                return null;
+            const row = await db
+                .prepare(`SELECT uid, name, position, created_at FROM microsub_channels WHERE uid = ?1`)
+                .bind(uid)
+                .first();
+            return row ? channelFromRow(row) : null;
+        },
+        async deleteChannel(uid) {
+            await ensureSchema();
+            if (uid === NOTIFICATIONS_CHANNEL)
+                return false;
+            const result = await db.batch([
+                db.prepare(`DELETE FROM microsub_channels WHERE uid = ?1`).bind(uid),
+                db.prepare(`DELETE FROM microsub_follows WHERE channel = ?1`).bind(uid),
+                db.prepare(`DELETE FROM microsub_items WHERE channel = ?1`).bind(uid),
+            ]);
+            return (result[0]?.meta.changes ?? 0) > 0;
+        },
+        async reorderChannels(order) {
+            await ensureSchema();
+            const statements = order.map((uid, index) => db
+                .prepare(`UPDATE microsub_channels SET position = ?2 WHERE uid = ?1`)
+                .bind(uid, index));
+            if (statements.length > 0)
+                await db.batch(statements);
+        },
+        // Follows -------------------------------------------------------------
+        async listFollows(channel) {
+            await ensureSchema();
+            const { results } = await db
+                .prepare(`SELECT feed_url, page_url, created_at FROM microsub_follows
+           WHERE channel = ?1 ORDER BY created_at ASC`)
+                .bind(channel)
+                .all();
+            return results.map((row) => ({
+                feedUrl: row.feed_url,
+                pageUrl: row.page_url,
+                createdAt: row.created_at,
+            }));
+        },
+        async addFollow(channel, feedUrl, pageUrl, now) {
+            await ensureSchema();
+            await db
+                .prepare(`INSERT INTO microsub_follows (channel, feed_url, page_url, created_at)
+           VALUES (?1, ?2, ?3, ?4)
+           ON CONFLICT (channel, feed_url) DO UPDATE SET page_url = excluded.page_url`)
+                .bind(channel, feedUrl, pageUrl, now)
+                .run();
+        },
+        async removeFollow(channel, url) {
+            await ensureSchema();
+            const result = await db
+                .prepare(`DELETE FROM microsub_follows
+           WHERE channel = ?1 AND (feed_url = ?2 OR page_url = ?2)`)
+                .bind(channel, url)
+                .run();
+            return (result.meta.changes ?? 0) > 0;
+        },
+        async distinctFeedUrls() {
+            await ensureSchema();
+            const { results } = await db
+                .prepare(`SELECT DISTINCT feed_url FROM microsub_follows`)
+                .all();
+            return results.map((row) => row.feed_url);
+        },
+        async channelsForFeed(feedUrl) {
+            await ensureSchema();
+            const { results } = await db
+                .prepare(`SELECT channel FROM microsub_follows WHERE feed_url = ?1`)
+                .bind(feedUrl)
+                .all();
+            return results.map((row) => row.channel);
+        },
+        // Items ---------------------------------------------------------------
+        async insertItems(channel, feedUrl, entries, now, maxItems) {
+            await ensureSchema();
+            if (entries.length === 0)
+                return 0;
+            const statements = entries.map((entry) => db
+                .prepare(`INSERT OR IGNORE INTO microsub_items
+               (channel, entry_id, feed_url, published, is_read, data, created_at)
+             VALUES (?1, ?2, ?3, ?4, 0, ?5, ?6)`)
+                .bind(channel, entry._id, feedUrl, publishedToEpoch(entry), JSON.stringify(entry), now));
+            const results = await db.batch(statements);
+            const added = results.reduce((sum, r) => sum + (r.meta.changes ?? 0), 0);
+            // Retention: reap the oldest items past the ceiling so a runaway feed
+            // can't fill the store unbounded.
+            if (added > 0) {
+                await db
+                    .prepare(`DELETE FROM microsub_items
+             WHERE channel = ?1 AND seq NOT IN (
+               SELECT seq FROM microsub_items WHERE channel = ?1
+               ORDER BY seq DESC LIMIT ?2
+             )`)
+                    .bind(channel, maxItems)
+                    .run();
+            }
+            return added;
+        },
+        async listItems(channel, options) {
+            await ensureSchema();
+            const limit = Math.max(1, options.limit);
+            let rows;
+            if (options.after !== undefined) {
+                const after = Number.parseInt(options.after, 10);
+                const { results } = await db
+                    .prepare(`SELECT seq, channel, entry_id, feed_url, is_read, data
+             FROM microsub_items WHERE channel = ?1 AND seq > ?2
+             ORDER BY seq ASC LIMIT ?3`)
+                    .bind(channel, Number.isFinite(after) ? after : 0, limit)
+                    .all();
+                rows = results.slice().reverse();
+            }
+            else {
+                const before = options.before !== undefined
+                    ? Number.parseInt(options.before, 10)
+                    : Number.MAX_SAFE_INTEGER;
+                const { results } = await db
+                    .prepare(`SELECT seq, channel, entry_id, feed_url, is_read, data
+             FROM microsub_items WHERE channel = ?1 AND seq < ?2
+             ORDER BY seq DESC LIMIT ?3`)
+                    .bind(channel, Number.isFinite(before) ? before : Number.MAX_SAFE_INTEGER, limit)
+                    .all();
+                rows = results;
+            }
+            const items = rows.map(itemFromRow);
+            const page = {
+                items,
+            };
+            if (items.length > 0) {
+                const last = items[items.length - 1];
+                const first = items[0];
+                // `before` advances to older entries. Offer it when the page filled
+                // (there may be more below), and always when paginating with `after`:
+                // even a partial newer-page sits above the entries we paged up from, so
+                // the client must be able to navigate back down. `after` always points
+                // past the newest seen.
+                if ((items.length === limit || options.after !== undefined) && last) {
+                    page.before = String(last.seq);
+                }
+                if (first)
+                    page.after = String(first.seq);
+            }
+            return page;
+        },
+        async unreadCount(channel) {
+            await ensureSchema();
+            const row = await db
+                .prepare(`SELECT COUNT(*) AS n FROM microsub_items WHERE channel = ?1 AND is_read = 0`)
+                .bind(channel)
+                .first();
+            return row?.n ?? 0;
+        },
+        async markRead(channel, entryIds, read) {
+            await ensureSchema();
+            if (entryIds.length === 0)
+                return;
+            const flag = read ? 1 : 0;
+            const statements = entryIds.map((id) => db
+                .prepare(`UPDATE microsub_items SET is_read = ?3 WHERE channel = ?1 AND entry_id = ?2`)
+                .bind(channel, id, flag));
+            await db.batch(statements);
+        },
+        async markReadThrough(channel, entryId) {
+            await ensureSchema();
+            const seq = await seqOf(channel, entryId);
+            if (seq === null)
+                return;
+            await db
+                .prepare(`UPDATE microsub_items SET is_read = 1 WHERE channel = ?1 AND seq <= ?2`)
+                .bind(channel, seq)
+                .run();
+        },
+        async removeItem(channel, entryId) {
+            await ensureSchema();
+            const result = await db
+                .prepare(`DELETE FROM microsub_items WHERE channel = ?1 AND entry_id = ?2`)
+                .bind(channel, entryId)
+                .run();
+            return (result.meta.changes ?? 0) > 0;
+        },
+        async searchItems(channel, query, limit) {
+            await ensureSchema();
+            const like = `%${query.replace(/[%_\\]/g, (ch) => `\\${ch}`)}%`;
+            const { results } = await db
+                .prepare(`SELECT seq, channel, entry_id, feed_url, is_read, data
+           FROM microsub_items
+           WHERE channel = ?1 AND data LIKE ?2 ESCAPE '\\'
+           ORDER BY seq DESC LIMIT ?3`)
+                .bind(channel, like, Math.max(1, limit))
+                .all();
+            return results.map(itemFromRow);
+        },
+        // Feed poll cache -----------------------------------------------------
+        async getFeedCache(feedUrl) {
+            await ensureSchema();
+            const row = await db
+                .prepare(`SELECT etag, last_modified FROM microsub_feeds WHERE feed_url = ?1`)
+                .bind(feedUrl)
+                .first();
+            if (row === null)
+                return null;
+            return { etag: row.etag, lastModified: row.last_modified };
+        },
+        async setFeedCache(feedUrl, etag, lastModified, now) {
+            await ensureSchema();
+            await db
+                .prepare(`INSERT INTO microsub_feeds (feed_url, etag, last_modified, last_polled)
+           VALUES (?1, ?2, ?3, ?4)
+           ON CONFLICT (feed_url) DO UPDATE SET
+             etag = excluded.etag,
+             last_modified = excluded.last_modified,
+             last_polled = excluded.last_polled`)
+                .bind(feedUrl, etag, lastModified, now)
+                .run();
+        },
+    };
+}
+//# sourceMappingURL=store.js.map

package/dist/store.js.map

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

package/dist/xml.d.ts

@@ -0,0 +1,51 @@
+/**
+ * `@dwk/microsub` — a minimal, dependency-free XML reader for feed parsing.
+ *
+ * Atom and RSS are XML; the Workers runtime exposes `HTMLRewriter` (an HTML
+ * tokenizer) but no XML parser, and the non-functional rules forbid pulling a
+ * heavy parser into the bundle. This module is a small recursive-descent reader
+ * tailored to feeds: elements, attributes, text, `CDATA`, comments, and the
+ * predefined/numeric entities — enough to turn a feed document into a tree the
+ * JF2 mapper walks. It is **pure** (plain string in, plain tree out) so it
+ * unit-tests without a Workers runtime.
+ *
+ * It is deliberately lenient (feeds in the wild are not always well-formed) and
+ * namespace-prefix-preserving but case-folding: element names are lowercased so
+ * `content:encoded`, `dc:creator`, and `media:content` match regardless of the
+ * source's casing.
+ *
+ * @packageDocumentation
+ */
+/** A parsed XML element: its lowercased name, attributes, and child nodes. */
+export interface XmlElement {
+    readonly type: "element";
+    /** Lowercased tag name, prefix included (e.g. `"content:encoded"`). */
+    readonly name: string;
+    /** Lowercased-key attribute map. */
+    readonly attrs: Readonly<Record<string, string>>;
+    readonly children: readonly XmlNode[];
+}
+/** A run of character data (already entity-decoded). */
+export interface XmlText {
+    readonly type: "text";
+    readonly value: string;
+}
+/** A node in the parsed tree. */
+export type XmlNode = XmlElement | XmlText;
+/** Decode XML predefined and numeric (`&#nn;` / `&#xnn;`) character references. */
+export declare function decodeEntities(text: string): string;
+/**
+ * Parse an XML document into a tree, returning the root element (or `null` when
+ * the input contains no element). Comments, the XML declaration, processing
+ * instructions, and `DOCTYPE` are skipped; `CDATA` sections become literal text.
+ */
+export declare function parseXml(input: string): XmlElement | null;
+/** The first direct child element named `name` (case-insensitive). */
+export declare function child(el: XmlElement, name: string): XmlElement | null;
+/** All direct child elements named `name` (case-insensitive), in order. */
+export declare function children(el: XmlElement, name: string): XmlElement[];
+/** Concatenated text of an element's descendants, trimmed. */
+export declare function text(el: XmlElement | null): string;
+/** Text of the first child element named `name`, or `""`. */
+export declare function childText(el: XmlElement, name: string): string;
+//# sourceMappingURL=xml.d.ts.map

package/dist/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../src/xml.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,wDAAwD;AACxD,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,iCAAiC;AACjC,MAAM,MAAM,OAAO,GAAG,UAAU,GAAG,OAAO,CAAC;AAU3C,mFAAmF;AACnF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoBnD;AAsBD;;;;GAIG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA+FzD;AAED,sEAAsE;AACtE,wBAAgB,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAMrE;AAED,2EAA2E;AAC3E,wBAAgB,QAAQ,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CAOnE;AAED,8DAA8D;AAC9D,wBAAgB,IAAI,CAAC,EAAE,EAAE,UAAU,GAAG,IAAI,GAAG,MAAM,CAYlD;AAED,6DAA6D;AAC7D,wBAAgB,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE9D"}

package/dist/xml.js

@@ -0,0 +1,196 @@
+/**
+ * `@dwk/microsub` — a minimal, dependency-free XML reader for feed parsing.
+ *
+ * Atom and RSS are XML; the Workers runtime exposes `HTMLRewriter` (an HTML
+ * tokenizer) but no XML parser, and the non-functional rules forbid pulling a
+ * heavy parser into the bundle. This module is a small recursive-descent reader
+ * tailored to feeds: elements, attributes, text, `CDATA`, comments, and the
+ * predefined/numeric entities — enough to turn a feed document into a tree the
+ * JF2 mapper walks. It is **pure** (plain string in, plain tree out) so it
+ * unit-tests without a Workers runtime.
+ *
+ * It is deliberately lenient (feeds in the wild are not always well-formed) and
+ * namespace-prefix-preserving but case-folding: element names are lowercased so
+ * `content:encoded`, `dc:creator`, and `media:content` match regardless of the
+ * source's casing.
+ *
+ * @packageDocumentation
+ */
+const NAMED_ENTITIES = {
+    amp: "&",
+    lt: "<",
+    gt: ">",
+    quot: '"',
+    apos: "'",
+};
+/** Decode XML predefined and numeric (`&#nn;` / `&#xnn;`) character references. */
+export function decodeEntities(text) {
+    return text.replace(/&(#x?[0-9a-fA-F]+|[a-zA-Z][a-zA-Z0-9]*);/g, (whole, body) => {
+        if (body[0] === "#") {
+            const code = body[1] === "x" || body[1] === "X"
+                ? Number.parseInt(body.slice(2), 16)
+                : Number.parseInt(body.slice(1), 10);
+            if (!Number.isFinite(code) || code < 0 || code > 0x10ffff)
+                return whole;
+            try {
+                return String.fromCodePoint(code);
+            }
+            catch {
+                return whole;
+            }
+        }
+        const named = NAMED_ENTITIES[body];
+        return named ?? whole;
+    });
+}
+/** Parse attributes out of a start-tag's interior (everything after the name). */
+function parseAttrs(source) {
+    const attrs = {};
+    const re = /([^\s=/]+)\s*=\s*("([^"]*)"|'([^']*)'|([^\s"'=<>`]+))/g;
+    let match;
+    while ((match = re.exec(source)) !== null) {
+        const name = (match[1] ?? "").toLowerCase();
+        const raw = match[3] ?? match[4] ?? match[5] ?? "";
+        if (name !== "")
+            attrs[name] = decodeEntities(raw);
+    }
+    return attrs;
+}
+/**
+ * Parse an XML document into a tree, returning the root element (or `null` when
+ * the input contains no element). Comments, the XML declaration, processing
+ * instructions, and `DOCTYPE` are skipped; `CDATA` sections become literal text.
+ */
+export function parseXml(input) {
+    const root = {
+        type: "element",
+        name: "#root",
+        attrs: {},
+        children: [],
+    };
+    const stack = [root];
+    let i = 0;
+    const n = input.length;
+    const pushText = (value) => {
+        if (value === "")
+            return;
+        const parent = stack[stack.length - 1];
+        if (parent)
+            parent.children.push({ type: "text", value });
+    };
+    while (i < n) {
+        const lt = input.indexOf("<", i);
+        if (lt === -1) {
+            pushText(decodeEntities(input.slice(i)));
+            break;
+        }
+        if (lt > i) {
+            pushText(decodeEntities(input.slice(i, lt)));
+        }
+        // Comments, CDATA, DOCTYPE, and declarations all start `<!`.
+        if (input.startsWith("<!--", lt)) {
+            const end = input.indexOf("-->", lt + 4);
+            i = end === -1 ? n : end + 3;
+            continue;
+        }
+        if (input.startsWith("<![CDATA[", lt)) {
+            const end = input.indexOf("]]>", lt + 9);
+            const data = input.slice(lt + 9, end === -1 ? n : end);
+            pushText(data); // CDATA is literal — no entity decoding.
+            i = end === -1 ? n : end + 3;
+            continue;
+        }
+        if (input[lt + 1] === "!") {
+            // DOCTYPE or other declaration: skip to the matching `>`.
+            const end = input.indexOf(">", lt);
+            i = end === -1 ? n : end + 1;
+            continue;
+        }
+        if (input[lt + 1] === "?") {
+            // Processing instruction / XML declaration.
+            const end = input.indexOf("?>", lt);
+            i = end === -1 ? n : end + 2;
+            continue;
+        }
+        const gt = input.indexOf(">", lt);
+        if (gt === -1) {
+            // Unterminated tag — treat the remainder as text and stop.
+            pushText(decodeEntities(input.slice(lt)));
+            break;
+        }
+        let tag = input.slice(lt + 1, gt);
+        i = gt + 1;
+        if (tag[0] === "/") {
+            // Close tag: pop to the nearest matching open element.
+            const name = tag.slice(1).trim().toLowerCase();
+            for (let s = stack.length - 1; s >= 1; s--) {
+                if (stack[s]?.name === name) {
+                    stack.length = s;
+                    break;
+                }
+            }
+            continue;
+        }
+        const selfClosing = tag.endsWith("/");
+        if (selfClosing)
+            tag = tag.slice(0, -1);
+        const space = tag.search(/\s/);
+        const name = (space === -1 ? tag : tag.slice(0, space)).toLowerCase();
+        const attrs = space === -1 ? {} : parseAttrs(tag.slice(space + 1));
+        const element = {
+            type: "element",
+            name,
+            attrs,
+            children: [],
+        };
+        const parent = stack[stack.length - 1];
+        if (parent)
+            parent.children.push(element);
+        if (!selfClosing)
+            stack.push(element);
+    }
+    const first = root.children.find((node) => node.type === "element");
+    return first ?? null;
+}
+/** The first direct child element named `name` (case-insensitive). */
+export function child(el, name) {
+    const lower = name.toLowerCase();
+    for (const node of el.children) {
+        if (node.type === "element" && node.name === lower)
+            return node;
+    }
+    return null;
+}
+/** All direct child elements named `name` (case-insensitive), in order. */
+export function children(el, name) {
+    const lower = name.toLowerCase();
+    const out = [];
+    for (const node of el.children) {
+        if (node.type === "element" && node.name === lower)
+            out.push(node);
+    }
+    return out;
+}
+/** Concatenated text of an element's descendants, trimmed. */
+export function text(el) {
+    if (el === null)
+        return "";
+    let out = "";
+    const walk = (node) => {
+        if (node.type === "text") {
+            out += node.value;
+        }
+        else {
+            for (const c of node.children)
+                walk(c);
+        }
+    };
+    for (const c of el.children)
+        walk(c);
+    return out.trim();
+}
+/** Text of the first child element named `name`, or `""`. */
+export function childText(el, name) {
+    return text(child(el, name));
+}
+//# sourceMappingURL=xml.js.map