tidyread 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 parzival1l
+
+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,68 @@
+# tidyread
+
+Clean a web article once, then hand it to Instapaper pre-chewed — and build a
+Kobo-ready EPUB while you're at it.
+
+## Why
+
+Instapaper's parser re-fetches every URL you save and often mangles the page:
+lazy-loaded images vanish, code blocks reflow into prose, figures lose their
+captions. tidyread extracts and repairs the article locally, serves the clean
+copy on a short-lived public URL, and saves *that* to Instapaper. Instapaper's
+parser reads a page with nothing left to get wrong. The URL dies when the
+process exits.
+
+It also writes an EPUB (images embedded, e-ink stylesheet) and a Kobo-native
+KEPUB, so you can skip Instapaper entirely and sideload.
+
+## Install
+
+```sh
+npm install -g tidyread
+brew install cloudflared   # short-lived tunnel for the Instapaper handoff
+brew install kepubify      # optional: Kobo-native output
+```
+
+## Use
+
+```sh
+# clean + save to Instapaper via your logged-in browser
+tidyread <url> --open
+
+# clean + save with Instapaper credentials (Simple API)
+INSTAPAPER_USERNAME=you INSTAPAPER_PASSWORD=pw tidyread <url>
+
+# build files only, no tunnel, nothing leaves the machine
+tidyread <url> --no-send
+
+# choose the output directory (default: ~/Kobo/inbox)
+tidyread <url> -o ~/Desktop
+```
+
+Outputs per article: `<slug>.html`, `<slug>.epub`, `<slug>.kepub.epub`.
+
+## How it works
+
+1. **extract** — [defuddle](https://github.com/kepano/defuddle) finds the
+   article; @mozilla/readability catches pages defuddle can't read.
+2. **normalise** — real image URLs recovered from lazy-load attributes and
+   srcset, links made absolute, tracking pixels dropped, bare `<pre>` wrapped
+   in `<code>`, empty wrappers collapsed.
+3. **serve** — the cleaned HTML sits on localhost behind a 128-bit random path.
+4. **tunnel** — `cloudflared` quick tunnel exposes it, no account needed.
+5. **deliver** — the tunnel URL goes to Instapaper (Simple API or browser).
+   After Instapaper fetches, the tunnel closes and the URL stops resolving.
+6. **epub** — images downloaded and embedded, e-ink stylesheet applied,
+   kepubify converts for Kobo page numbers and reading stats.
+
+## Boundaries
+
+- The public copy is one article, behind an unguessable URL, alive for
+  seconds, for your own reading. tidyread refuses to be a mirror: the server
+  dies with the process.
+- Article text is never rewritten. Attribution and the original link sit at
+  the top of every artifact.
+
+## License
+
+MIT

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,104 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { mkdir, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+import { extract } from "./extract.js";
+import { renderHtml, readingMinutes } from "./render.js";
+import { serveOnce } from "./serve.js";
+import { openTunnel } from "./tunnel.js";
+import { buildEpub, toKepub } from "./epub.js";
+import { addByApi, addByBrowser, credentialsFromEnv } from "./instapaper.js";
+const DEFAULT_OUT = join(homedir(), "Kobo", "inbox");
+const FETCH_WAIT_MS = 90_000;
+function slug(title) {
+    return (title
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60) || "article");
+}
+function log(step, detail = "") {
+    process.stderr.write(`  ${step.padEnd(12)} ${detail}\n`);
+}
+const program = new Command();
+program
+    .name("tidyread")
+    .description("Clean an article once, then hand it to Instapaper pre-chewed " +
+    "and build a Kobo-ready EPUB.")
+    .version("0.1.0");
+program
+    .argument("<url>", "article URL")
+    .option("-o, --out <dir>", "output directory", DEFAULT_OUT)
+    .option("--no-epub", "skip the EPUB and KEPUB build")
+    .option("--no-send", "build files only, never open a tunnel")
+    .option("--open", "save via the browser instead of the Simple API")
+    .option("--keep-open", "leave the tunnel up until you press Ctrl-C")
+    .action(async (url, opts) => {
+    const outDir = resolve(opts.out);
+    await mkdir(outDir, { recursive: true });
+    log("fetching", url);
+    const article = await extract(url);
+    const name = slug(article.title);
+    log("extracted", `"${article.title}" · ${readingMinutes(article.text)} min · ` +
+        `${article.images.length} images`);
+    const html = renderHtml(article);
+    const htmlPath = join(outDir, `${name}.html`);
+    await writeFile(htmlPath, html, "utf8");
+    log("wrote", htmlPath);
+    if (opts.epub) {
+        const epubPath = await buildEpub(article, join(outDir, `${name}.epub`));
+        log("wrote", epubPath);
+        const kepubPath = await toKepub(epubPath);
+        if (kepubPath)
+            log("wrote", kepubPath);
+        else
+            log("skipped", "kepubify not found — install with: brew install kepubify");
+    }
+    if (!opts.send)
+        return;
+    const hosted = await serveOnce(html);
+    const tunnel = await openTunnel(hosted.port);
+    const publicUrl = `${tunnel.origin}${hosted.path}`;
+    const teardown = async () => {
+        await tunnel.close();
+        await hosted.close();
+    };
+    process.once("SIGINT", async () => {
+        await teardown();
+        process.exit(130);
+    });
+    try {
+        log("tunnel", publicUrl);
+        const creds = credentialsFromEnv();
+        if (opts.open || !creds) {
+            addByBrowser(publicUrl);
+            log("browser", "opened Instapaper save page — confirm it in the tab");
+        }
+        else {
+            await addByApi(publicUrl, article.title, creds);
+            log("instapaper", `saved as "${article.title}"`);
+        }
+        const timeout = new Promise((r) => setTimeout(() => r(null), FETCH_WAIT_MS));
+        const hit = await Promise.race([hosted.fetched, timeout]);
+        if (hit)
+            log("fetched", `by ${hit.userAgent.slice(0, 60)}`);
+        else
+            log("warning", `nothing fetched in ${FETCH_WAIT_MS / 1000}s — the save may not have landed`);
+        if (opts.keepOpen) {
+            log("holding", "tunnel open — press Ctrl-C to close");
+            await new Promise(() => { });
+        }
+    }
+    finally {
+        if (!opts.keepOpen) {
+            await teardown();
+            log("closed", "tunnel down, URL no longer resolves");
+        }
+    }
+});
+program.parseAsync(process.argv).catch((err) => {
+    process.stderr.write(`\ntidyread: ${err.message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/epub.d.ts

@@ -0,0 +1,7 @@
+import { basename } from "node:path";
+import type { Article } from "./types.js";
+/** Write a minimal, valid EPUB 3 for the article. */
+export declare function buildEpub(article: Article, outPath: string): Promise<string>;
+/** Convert to Kobo's EPUB dialect, for real page numbers and reading stats. */
+export declare function toKepub(epubPath: string): Promise<string | null>;
+export { basename };

package/dist/epub.js

@@ -0,0 +1,164 @@
+import JSZip from "jszip";
+import { parseHTML } from "linkedom";
+import { writeFile } from "node:fs/promises";
+import { spawn } from "node:child_process";
+import { randomUUID } from "node:crypto";
+import { basename, extname } from "node:path";
+import { readingMinutes } from "./render.js";
+/** Typography tuned for a small, slow, greyscale screen. */
+const STYLESHEET = `
+body { margin: 0 1.1em; line-height: 1.5; text-align: justify;
+       hyphens: auto; -webkit-hyphens: auto; }
+h1 { font-size: 1.5em; line-height: 1.25; text-align: left; margin: 1em 0 .2em; }
+h2 { font-size: 1.2em; text-align: left; page-break-after: avoid; }
+h3 { font-size: 1.05em; text-align: left; page-break-after: avoid; }
+p { margin: 0 0 .7em; widows: 2; orphans: 2; }
+img { max-width: 100%; height: auto; page-break-inside: avoid; margin: 1em auto; }
+figcaption, .credit { font-size: .8em; font-style: italic; text-align: center; }
+pre { white-space: pre-wrap; word-wrap: break-word; font-size: .75em;
+      background: #f2f2f2; padding: .5em; text-align: left; }
+code { font-family: monospace; }
+blockquote { margin: 1em 1.2em; font-style: italic; }
+table { border-collapse: collapse; width: 100%; font-size: .8em; }
+td, th { border: 1px solid #999; padding: .3em; }
+.credit { margin-bottom: 2em; }
+`;
+function escape(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+const MIME = {
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".png": "image/png",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+};
+/**
+ * Download body images so the book reads offline.
+ *
+ * Anything that fails is dropped rather than fatal: a missing figure should
+ * not cost you the article.
+ */
+async function collectImages(urls) {
+    const assets = [];
+    const map = new Map();
+    await Promise.all([...new Set(urls)].map(async (url, index) => {
+        try {
+            const res = await fetch(url);
+            if (!res.ok)
+                return;
+            const bytes = new Uint8Array(await res.arrayBuffer());
+            const type = (res.headers.get("content-type") ?? "").split(";")[0];
+            let ext = extname(new URL(url).pathname).toLowerCase() ||
+                Object.entries(MIME).find(([, m]) => m === type)?.[0] ||
+                ".jpg";
+            if (!MIME[ext])
+                ext = ".jpg";
+            const href = `images/img${index}${ext}`;
+            assets.push({ id: `img${index}`, href, mime: MIME[ext], bytes });
+            map.set(url, href);
+        }
+        catch {
+            /* skip unreachable image */
+        }
+    }));
+    return { assets, map };
+}
+/** Point <img> at the copies bundled in the book; drop the rest. */
+function rewriteImages(html, map) {
+    const { document } = parseHTML("<!DOCTYPE html><html><body></body></html>");
+    const root = document.createElement("div");
+    root.innerHTML = html;
+    for (const img of Array.from(root.querySelectorAll("img"))) {
+        const local = map.get(img.getAttribute("src") ?? "");
+        if (local)
+            img.setAttribute("src", local);
+        else
+            img.remove();
+    }
+    return root.innerHTML;
+}
+/** Write a minimal, valid EPUB 3 for the article. */
+export async function buildEpub(article, outPath) {
+    const { assets, map } = await collectImages(article.images);
+    const body = rewriteImages(article.html, map);
+    const uuid = randomUUID();
+    const modified = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
+    const credit = [article.siteName, article.byline].filter(Boolean).join(" — ");
+    const chapter = `<?xml version="1.0" encoding="utf-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${escape(article.lang)}">
+<head><meta charset="utf-8"/><title>${escape(article.title)}</title>
+<link rel="stylesheet" type="text/css" href="style.css"/></head>
+<body>
+<section epub:type="chapter">
+<h1>${escape(article.title)}</h1>
+<p class="credit">${credit ? `${escape(credit)} · ` : ""}${readingMinutes(article.text)} min read<br/>
+<a href="${escape(article.sourceUrl)}">${escape(article.sourceUrl)}</a></p>
+${body}
+</section>
+</body></html>`;
+    const nav = `<?xml version="1.0" encoding="utf-8"?>
+<html xmlns="http://www.w3.org/1999/xhtml" xmlns:epub="http://www.idpf.org/2007/ops" lang="${escape(article.lang)}">
+<head><meta charset="utf-8"/><title>Contents</title></head>
+<body><nav epub:type="toc" id="toc"><h1>Contents</h1>
+<ol><li><a href="chapter.xhtml">${escape(article.title)}</a></li></ol>
+</nav></body></html>`;
+    const manifest = assets
+        .map((a) => `<item id="${a.id}" href="${a.href}" media-type="${a.mime}"/>`)
+        .join("\n    ");
+    const opf = `<?xml version="1.0" encoding="utf-8"?>
+<package xmlns="http://www.idpf.org/2007/opf" version="3.0" unique-identifier="bookid">
+  <metadata xmlns:dc="http://purl.org/dc/elements/1.1/">
+    <dc:identifier id="bookid">urn:uuid:${uuid}</dc:identifier>
+    <dc:title>${escape(article.title)}</dc:title>
+    <dc:language>${escape(article.lang)}</dc:language>
+    <dc:creator>${escape(article.byline ?? article.siteName ?? "Unknown")}</dc:creator>
+    <dc:source>${escape(article.sourceUrl)}</dc:source>
+    <meta property="dcterms:modified">${modified}</meta>
+  </metadata>
+  <manifest>
+    <item id="nav" href="nav.xhtml" media-type="application/xhtml+xml" properties="nav"/>
+    <item id="chapter" href="chapter.xhtml" media-type="application/xhtml+xml"/>
+    <item id="style" href="style.css" media-type="text/css"/>
+    ${manifest}
+  </manifest>
+  <spine><itemref idref="chapter"/></spine>
+</package>`;
+    const zip = new JSZip();
+    zip.file("mimetype", "application/epub+zip", { compression: "STORE" });
+    zip.file("META-INF/container.xml", `<?xml version="1.0" encoding="utf-8"?>
+<container version="1.0" xmlns="urn:oasis:names:tc:opendocument:xmlns:container">
+<rootfiles><rootfile full-path="OEBPS/content.opf" media-type="application/oebps-package+xml"/></rootfiles>
+</container>`);
+    zip.file("OEBPS/content.opf", opf);
+    zip.file("OEBPS/nav.xhtml", nav);
+    zip.file("OEBPS/chapter.xhtml", chapter);
+    zip.file("OEBPS/style.css", STYLESHEET);
+    for (const asset of assets)
+        zip.file(`OEBPS/${asset.href}`, asset.bytes);
+    const buffer = await zip.generateAsync({
+        type: "nodebuffer",
+        compression: "DEFLATE",
+    });
+    await writeFile(outPath, buffer);
+    return outPath;
+}
+/** Convert to Kobo's EPUB dialect, for real page numbers and reading stats. */
+export async function toKepub(epubPath) {
+    const outPath = epubPath.replace(/\.epub$/, ".kepub.epub");
+    const ok = await new Promise((resolve) => {
+        const child = spawn("kepubify", ["-o", outPath, epubPath], {
+            stdio: "ignore",
+        });
+        child.once("error", () => resolve(false));
+        child.once("exit", (code) => resolve(code === 0));
+    });
+    return ok ? outPath : null;
+}
+export { basename };
+//# sourceMappingURL=epub.js.map

package/dist/epub.js.map

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

package/dist/extract.d.ts

@@ -0,0 +1,13 @@
+import type { Article } from "./types.js";
+/** Download a page as text, following redirects. */
+export declare function fetchPage(url: string): Promise<{
+    html: string;
+    finalUrl: string;
+}>;
+/**
+ * Turn a URL into a clean Article.
+ *
+ * Defuddle extracts; Readability catches what it misses; normalise repairs
+ * what any extractor leaves behind (lazy images, relative URLs, bare <pre>).
+ */
+export declare function extract(url: string): Promise<Article>;

package/dist/extract.js

@@ -0,0 +1,94 @@
+import { parseHTML } from "linkedom";
+import { Readability } from "@mozilla/readability";
+import { Defuddle } from "defuddle/node";
+import { normalise } from "./normalise.js";
+const UA = "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 " +
+    "(KHTML, like Gecko) Chrome/125.0 Safari/537.36";
+/** Below this many characters, an extraction is judged a failure. */
+const MIN_TEXT = 500;
+/** Download a page as text, following redirects. */
+export async function fetchPage(url) {
+    const res = await fetch(url, {
+        redirect: "follow",
+        headers: { "user-agent": UA, accept: "text/html,application/xhtml+xml" },
+    });
+    if (!res.ok) {
+        throw new Error(`fetch failed: ${res.status} ${res.statusText} for ${url}`);
+    }
+    return { html: await res.text(), finalUrl: res.url || url };
+}
+function textLength(html) {
+    return html.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim().length;
+}
+/**
+ * Primary extractor. Defuddle keeps structure Readability flattens:
+ * code blocks, footnotes, math, and tables survive it.
+ */
+async function byDefuddle(html, url) {
+    try {
+        const result = await Defuddle(html, url);
+        if (!result?.content || textLength(result.content) < MIN_TEXT)
+            return null;
+        return {
+            content: result.content,
+            title: result.title || null,
+            byline: result.author || null,
+            siteName: result.site || null,
+            excerpt: result.description || null,
+            lang: result.language || null,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+/** Fallback extractor for pages Defuddle cannot read. */
+function byReadability(html, url) {
+    const { document } = parseHTML(html);
+    const lang = document.documentElement?.getAttribute("lang")?.trim() || null;
+    const parsed = new Readability(document, {
+        charThreshold: 250,
+        keepClasses: false,
+    }).parse();
+    if (!parsed?.content || textLength(parsed.content) < MIN_TEXT)
+        return null;
+    return {
+        content: parsed.content,
+        title: parsed.title || null,
+        byline: parsed.byline || null,
+        siteName: parsed.siteName || null,
+        excerpt: parsed.excerpt || null,
+        lang,
+    };
+}
+/**
+ * Turn a URL into a clean Article.
+ *
+ * Defuddle extracts; Readability catches what it misses; normalise repairs
+ * what any extractor leaves behind (lazy images, relative URLs, bare <pre>).
+ */
+export async function extract(url) {
+    const { html, finalUrl } = await fetchPage(url);
+    const picked = (await byDefuddle(html, finalUrl)) ?? byReadability(html, finalUrl);
+    if (!picked) {
+        throw new Error(`could not find an article body at ${finalUrl}. ` +
+            `The page may render its content with JavaScript.`);
+    }
+    const { html: body, images } = normalise(picked.content, finalUrl);
+    const text = picked.content
+        .replace(/<[^>]+>/g, " ")
+        .replace(/\s+/g, " ")
+        .trim();
+    return {
+        sourceUrl: finalUrl,
+        title: (picked.title || "Untitled").trim(),
+        byline: picked.byline?.trim() || null,
+        siteName: picked.siteName || new URL(finalUrl).hostname,
+        excerpt: picked.excerpt?.trim() || null,
+        html: body,
+        text,
+        images,
+        lang: (picked.lang || "en").split(/[_-]/)[0] || "en",
+    };
+}
+//# sourceMappingURL=extract.js.map

package/dist/extract.js.map

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

package/dist/instapaper.d.ts

@@ -0,0 +1,20 @@
+export interface Credentials {
+    username: string;
+    password: string;
+}
+/** Read credentials from the environment, if the user set them. */
+export declare function credentialsFromEnv(): Credentials | null;
+/**
+ * Add a URL with the Simple API.
+ *
+ * This endpoint needs no developer approval, unlike the Full API. It accepts
+ * only a URL, which is all this tool needs: the URL already points at the
+ * cleaned payload.
+ */
+export declare function addByApi(url: string, title: string, creds: Credentials): Promise<void>;
+/**
+ * Open the save page in the browser, using the existing session.
+ * Set TIDYREAD_BROWSER (e.g. "Safari") to pick an app; otherwise the
+ * system default browser opens it.
+ */
+export declare function addByBrowser(url: string): string;

package/dist/instapaper.js

@@ -0,0 +1,50 @@
+import { spawn } from "node:child_process";
+const ADD_URL = "https://www.instapaper.com/api/add";
+const SAVE_URL = "https://www.instapaper.com/hello2";
+/** Read credentials from the environment, if the user set them. */
+export function credentialsFromEnv() {
+    const username = process.env.INSTAPAPER_USERNAME?.trim();
+    if (!username)
+        return null;
+    return { username, password: process.env.INSTAPAPER_PASSWORD ?? "" };
+}
+/**
+ * Add a URL with the Simple API.
+ *
+ * This endpoint needs no developer approval, unlike the Full API. It accepts
+ * only a URL, which is all this tool needs: the URL already points at the
+ * cleaned payload.
+ */
+export async function addByApi(url, title, creds) {
+    const body = new URLSearchParams({
+        username: creds.username,
+        password: creds.password,
+        url,
+        title,
+    });
+    const res = await fetch(ADD_URL, {
+        method: "POST",
+        headers: { "content-type": "application/x-www-form-urlencoded" },
+        body,
+    });
+    if (res.status === 201)
+        return;
+    if (res.status === 403) {
+        throw new Error("Instapaper rejected those credentials (403). If you sign in with " +
+            "Google or Apple your account has no password, so use --open instead.");
+    }
+    throw new Error(`Instapaper returned ${res.status} ${res.statusText}`);
+}
+/**
+ * Open the save page in the browser, using the existing session.
+ * Set TIDYREAD_BROWSER (e.g. "Safari") to pick an app; otherwise the
+ * system default browser opens it.
+ */
+export function addByBrowser(url) {
+    const saveUrl = `${SAVE_URL}?url=${encodeURIComponent(url)}`;
+    const app = process.env.TIDYREAD_BROWSER?.trim();
+    const args = app ? ["-a", app, saveUrl] : [saveUrl];
+    spawn("open", args, { stdio: "ignore", detached: true }).unref();
+    return saveUrl;
+}
+//# sourceMappingURL=instapaper.js.map

package/dist/instapaper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"instapaper.js","sourceRoot":"","sources":["../src/instapaper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAE3C,MAAM,OAAO,GAAG,oCAAoC,CAAC;AACrD,MAAM,QAAQ,GAAG,mCAAmC,CAAC;AAOrD,mEAAmE;AACnE,MAAM,UAAU,kBAAkB;IAChC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,CAAC;IACzD,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,EAAE,EAAE,CAAC;AACvE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAW,EACX,KAAa,EACb,KAAkB;IAElB,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC;QAC/B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,GAAG;QACH,KAAK;KACN,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,OAAO,EAAE;QAC/B,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,mCAAmC,EAAE;QAChE,IAAI;KACL,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO;IAC/B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mEAAmE;YACjE,sEAAsE,CACzE,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC;AACzE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,MAAM,OAAO,GAAG,GAAG,QAAQ,QAAQ,kBAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,EAAE,IAAI,EAAE,CAAC;IACjD,MAAM,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;IACpD,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IACjE,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/normalise.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Repair a Readability body so a downstream parser reads it correctly.
+ *
+ * Images keep their original absolute URLs rather than being rehosted, so the
+ * artifact stays text-only and the publisher still serves its own assets.
+ */
+export declare function normalise(bodyHtml: string, baseUrl: string): {
+    html: string;
+    images: string[];
+};

package/dist/normalise.js

@@ -0,0 +1,159 @@
+import { parseHTML } from "linkedom";
+import sanitizeHtml from "sanitize-html";
+/**
+ * Final gate before the body leaves this module. The article is third-party
+ * HTML that we serve on a public URL, so structure passes and active content
+ * does not: no event handlers, no javascript: URLs, no unknown tags.
+ */
+const SANITIZE = {
+    allowedTags: [
+        "a", "abbr", "b", "blockquote", "br", "caption", "cite", "code", "dd",
+        "del", "dfn", "dl", "dt", "em", "figcaption", "figure", "h1", "h2", "h3",
+        "h4", "h5", "h6", "hr", "i", "img", "ins", "kbd", "li", "mark", "ol", "p",
+        "pre", "q", "s", "samp", "small", "strong", "sub", "sup", "table", "tbody",
+        "td", "tfoot", "th", "thead", "tr", "u", "ul", "div", "span",
+    ],
+    allowedAttributes: {
+        a: ["href", "title"],
+        img: ["src", "alt", "width", "height"],
+        td: ["colspan", "rowspan"],
+        th: ["colspan", "rowspan", "scope"],
+    },
+    allowedSchemes: ["http", "https", "mailto"],
+    allowProtocolRelative: false,
+    disallowedTagsMode: "discard",
+};
+/** Attributes lazy-loading scripts hide the real image URL behind. */
+const LAZY_SRC = [
+    "data-src",
+    "data-original",
+    "data-lazy-src",
+    "data-actual-src",
+    "data-hi-res-src",
+];
+const LAZY_SRCSET = ["data-srcset", "data-lazy-srcset"];
+/** Wrappers that carry no meaning once styling is gone. */
+const UNWRAP = ["div", "span", "section", "article"];
+function absolute(value, base) {
+    try {
+        return new URL(value.trim(), base).href;
+    }
+    catch {
+        return null;
+    }
+}
+/** Pick the largest candidate from a srcset, so e-ink gets a sharp image. */
+function widestFromSrcset(srcset, base) {
+    let best = null;
+    for (const part of srcset.split(",")) {
+        const [rawUrl, descriptor] = part.trim().split(/\s+/, 2);
+        if (!rawUrl)
+            continue;
+        const url = absolute(rawUrl, base);
+        if (!url)
+            continue;
+        const width = descriptor?.endsWith("w")
+            ? Number.parseInt(descriptor, 10) || 0
+            : 0;
+        if (!best || width > best.width)
+            best = { url, width };
+    }
+    return best?.url ?? null;
+}
+/**
+ * Repair a Readability body so a downstream parser reads it correctly.
+ *
+ * Images keep their original absolute URLs rather than being rehosted, so the
+ * artifact stays text-only and the publisher still serves its own assets.
+ */
+export function normalise(bodyHtml, baseUrl) {
+    // linkedom silently drops content passed as a bare `<body>` fragment, so
+    // parse a real document and fill a container element instead.
+    const { document } = parseHTML("<!DOCTYPE html><html><body></body></html>");
+    const root = document.createElement("div");
+    root.innerHTML = bodyHtml;
+    // Drop anything that is chrome, tracking, or noise.
+    root
+        .querySelectorAll("script,style,noscript,iframe,form,button,svg,link,meta," +
+        "[role=navigation],[role=banner],[role=complementary],[aria-hidden=true]")
+        .forEach((el) => el.remove());
+    const images = [];
+    for (const img of Array.from(root.querySelectorAll("img"))) {
+        let src = null;
+        for (const attr of LAZY_SRC) {
+            const value = img.getAttribute(attr);
+            if (value) {
+                src = absolute(value, baseUrl);
+                if (src)
+                    break;
+            }
+        }
+        for (const attr of LAZY_SRCSET) {
+            if (src)
+                break;
+            const value = img.getAttribute(attr);
+            if (value)
+                src = widestFromSrcset(value, baseUrl);
+        }
+        if (!src) {
+            const srcset = img.getAttribute("srcset");
+            if (srcset)
+                src = widestFromSrcset(srcset, baseUrl);
+        }
+        if (!src) {
+            const raw = img.getAttribute("src");
+            if (raw && !raw.startsWith("data:"))
+                src = absolute(raw, baseUrl);
+        }
+        if (src && !/^https?:/i.test(src))
+            src = null;
+        const width = Number.parseInt(img.getAttribute("width") ?? "0", 10);
+        const height = Number.parseInt(img.getAttribute("height") ?? "0", 10);
+        const isPixel = width > 0 && width <= 2 && height > 0 && height <= 2;
+        if (!src || isPixel) {
+            img.remove();
+            continue;
+        }
+        const alt = img.getAttribute("alt")?.trim() ?? "";
+        for (const attr of Array.from(img.attributes)) {
+            img.removeAttribute(attr.name);
+        }
+        img.setAttribute("src", src);
+        img.setAttribute("alt", alt);
+        images.push(src);
+    }
+    // Make links absolute so they still work off the original domain.
+    for (const a of Array.from(root.querySelectorAll("a[href]"))) {
+        const href = absolute(a.getAttribute("href") ?? "", baseUrl);
+        if (href)
+            a.setAttribute("href", href);
+        else
+            a.removeAttribute("href");
+    }
+    // Readability often leaves code as a bare <pre> or a <code> soup. Parsers
+    // reflow that into prose unless the <pre><code> pair is explicit.
+    for (const pre of Array.from(root.querySelectorAll("pre"))) {
+        if (!pre.querySelector("code")) {
+            const code = document.createElement("code");
+            code.textContent = pre.textContent ?? "";
+            pre.textContent = "";
+            pre.appendChild(code);
+        }
+    }
+    // Collapse wrappers that hold a single child and add no structure.
+    for (const el of Array.from(root.querySelectorAll(UNWRAP.join(",")))) {
+        const kept = Array.from(el.childNodes).filter((n) => n.nodeType !== 3 || (n.textContent ?? "").trim() !== "");
+        if (kept.length === 1 && kept[0].nodeType === 1) {
+            el.replaceWith(kept[0]);
+        }
+    }
+    // Remove blocks left empty by the passes above.
+    for (const el of Array.from(root.querySelectorAll("p,div,li,h1,h2,h3,h4"))) {
+        const hasMedia = el.querySelector("img,pre,code,table");
+        if (!hasMedia && !(el.textContent ?? "").trim())
+            el.remove();
+    }
+    const clean = sanitizeHtml(root.innerHTML, SANITIZE).trim();
+    return { html: clean, images };
+}
+//# sourceMappingURL=normalise.js.map

package/dist/normalise.js.map

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

package/dist/render.d.ts

@@ -0,0 +1,12 @@
+import type { Article } from "./types.js";
+/** Rough reading time at 220 words per minute. */
+export declare function readingMinutes(text: string): number;
+/**
+ * Render the delivery payload.
+ *
+ * Deliberately no <link rel="canonical">: a canonical tag invites the reader
+ * service to resolve back to the original URL and re-parse it, which is the
+ * behaviour this whole tool exists to avoid. Attribution instead sits in the
+ * visible header, which no parser strips.
+ */
+export declare function renderHtml(article: Article): string;

package/dist/render.js

@@ -0,0 +1,60 @@
+function escape(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;")
+        .replace(/"/g, "&quot;");
+}
+/** Rough reading time at 220 words per minute. */
+export function readingMinutes(text) {
+    return Math.max(1, Math.round(text.split(/\s+/).filter(Boolean).length / 220));
+}
+/**
+ * Render the delivery payload.
+ *
+ * Deliberately no <link rel="canonical">: a canonical tag invites the reader
+ * service to resolve back to the original URL and re-parse it, which is the
+ * behaviour this whole tool exists to avoid. Attribution instead sits in the
+ * visible header, which no parser strips.
+ */
+export function renderHtml(article) {
+    const minutes = readingMinutes(article.text);
+    const credit = [article.siteName, article.byline].filter(Boolean).join(" — ");
+    return `<!doctype html>
+<html lang="${escape(article.lang)}">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="robots" content="noindex, nofollow, noarchive">
+<title>${escape(article.title)}</title>
+${article.byline ? `<meta name="author" content="${escape(article.byline)}">` : ""}
+${article.excerpt ? `<meta name="description" content="${escape(article.excerpt)}">` : ""}
+<style>
+body{max-width:38em;margin:0 auto;padding:1.5rem;
+ font:1rem/1.6 Georgia,"Iowan Old Style",serif;color:#111}
+img{max-width:100%;height:auto;display:block;margin:1.4em auto}
+figcaption,.tidyread-credit{font-size:.85em;color:#555}
+pre{white-space:pre-wrap;word-wrap:break-word;overflow-x:auto;
+ background:#f6f6f6;padding:.8em;border-radius:4px;font-size:.85em}
+code{font-family:ui-monospace,Menlo,Consolas,monospace}
+blockquote{margin:1.2em 0;padding-left:1em;border-left:3px solid #ccc;color:#444}
+table{border-collapse:collapse;width:100%;font-size:.9em}
+td,th{border:1px solid #ddd;padding:.4em}
+h1{font-size:1.7em;line-height:1.25}
+.tidyread-credit{margin:0 0 2em;padding-bottom:1em;border-bottom:1px solid #eee}
+</style>
+</head>
+<body>
+<article>
+<h1>${escape(article.title)}</h1>
+<p class="tidyread-credit">
+${credit ? `${escape(credit)} · ` : ""}${minutes} min read<br>
+Original: <a href="${escape(article.sourceUrl)}">${escape(article.sourceUrl)}</a>
+</p>
+${article.html}
+</article>
+</body>
+</html>
+`;
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAEA,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;AAC7B,CAAC;AAED,kDAAkD;AAClD,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;AACjF,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAAgB;IACzC,MAAM,OAAO,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9E,OAAO;cACK,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;;;;;SAKzB,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;EAC5B,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,gCAAgC,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;EAChF,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,qCAAqC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;;MAkBnF,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC;;EAEzB,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,OAAO;qBAC3B,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,KAAK,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;;EAE1E,OAAO,CAAC,IAAI;;;;CAIb,CAAC;AACF,CAAC"}

package/dist/serve.d.ts

@@ -0,0 +1,18 @@
+export interface Hosted {
+    /** Unguessable path the payload is served at, e.g. "/a1b2c3.../". */
+    path: string;
+    port: number;
+    /** Resolves the first time something outside this machine fetches it. */
+    fetched: Promise<{
+        userAgent: string;
+        at: Date;
+    }>;
+    close(): Promise<void>;
+}
+/**
+ * Serve one HTML payload on localhost at a random path.
+ *
+ * The path is 128 bits of randomness, so the URL is not discoverable during
+ * the seconds it is reachable. Every other path returns 404.
+ */
+export declare function serveOnce(html: string): Promise<Hosted>;

package/dist/serve.js

@@ -0,0 +1,61 @@
+import { createServer } from "node:http";
+import { randomBytes } from "node:crypto";
+import { once } from "node:events";
+function isLoopback(address) {
+    if (!address)
+        return false;
+    const ip = address.replace(/^::ffff:/, "");
+    return ip === "127.0.0.1" || ip === "::1";
+}
+/**
+ * Serve one HTML payload on localhost at a random path.
+ *
+ * The path is 128 bits of randomness, so the URL is not discoverable during
+ * the seconds it is reachable. Every other path returns 404.
+ */
+export async function serveOnce(html) {
+    const token = randomBytes(16).toString("hex");
+    const path = `/${token}`;
+    const body = Buffer.from(html, "utf8");
+    let announceFetch;
+    const fetched = new Promise((resolve) => {
+        announceFetch = resolve;
+    });
+    const server = createServer((req, res) => {
+        const url = (req.url ?? "").split("?")[0].replace(/\/$/, "") || "/";
+        if (url !== path) {
+            res.writeHead(404, { "content-type": "text/plain" });
+            res.end("not found");
+            return;
+        }
+        res.writeHead(200, {
+            "content-type": "text/html; charset=utf-8",
+            "content-length": String(body.length),
+            "cache-control": "no-store",
+            "x-robots-tag": "noindex, nofollow",
+        });
+        res.end(req.method === "HEAD" ? undefined : body);
+        if (!isLoopback(req.socket.remoteAddress)) {
+            announceFetch({
+                userAgent: req.headers["user-agent"] ?? "unknown",
+                at: new Date(),
+            });
+        }
+    });
+    server.listen(0, "127.0.0.1");
+    await once(server, "listening");
+    const address = server.address();
+    if (typeof address === "string" || address === null) {
+        throw new Error("could not bind a local port");
+    }
+    return {
+        path,
+        port: address.port,
+        fetched,
+        async close() {
+            server.closeAllConnections?.();
+            await new Promise((resolve) => server.close(() => resolve()));
+        },
+    };
+}
+//# sourceMappingURL=serve.js.map

package/dist/serve.js.map

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

package/dist/tunnel.d.ts

@@ -0,0 +1,14 @@
+export interface Tunnel {
+    /** Public https origin, e.g. "https://foo-bar.trycloudflare.com". */
+    origin: string;
+    close(): Promise<void>;
+}
+/**
+ * Open a Cloudflare quick tunnel to a local port.
+ *
+ * Quick tunnels need no account and no login. The address exists only while
+ * this process lives, so the payload cannot outlive the run. Cloudflare offers
+ * these on a best-effort basis with no SLA, which suits one-off personal use
+ * and nothing heavier.
+ */
+export declare function openTunnel(port: number): Promise<Tunnel>;

package/dist/tunnel.js

@@ -0,0 +1,64 @@
+import { spawn } from "node:child_process";
+const URL_PATTERN = /https:\/\/[a-z0-9-]+\.trycloudflare\.com/i;
+const START_TIMEOUT_MS = 30_000;
+/**
+ * Open a Cloudflare quick tunnel to a local port.
+ *
+ * Quick tunnels need no account and no login. The address exists only while
+ * this process lives, so the payload cannot outlive the run. Cloudflare offers
+ * these on a best-effort basis with no SLA, which suits one-off personal use
+ * and nothing heavier.
+ */
+export async function openTunnel(port) {
+    const child = spawn("cloudflared", [
+        "tunnel",
+        "--no-autoupdate",
+        "--url",
+        `http://127.0.0.1:${port}`,
+    ], { stdio: ["ignore", "pipe", "pipe"] });
+    const origin = await new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            reject(new Error("cloudflared did not produce a URL within 30s"));
+        }, START_TIMEOUT_MS);
+        const scan = (chunk) => {
+            const match = URL_PATTERN.exec(chunk.toString());
+            if (match) {
+                clearTimeout(timer);
+                resolve(match[0]);
+            }
+        };
+        child.stdout?.on("data", scan);
+        child.stderr?.on("data", scan);
+        child.once("error", (err) => {
+            clearTimeout(timer);
+            reject(new Error(`could not start cloudflared: ${err.message}. ` +
+                `Install it with: brew install cloudflared`));
+        });
+        child.once("exit", (code) => {
+            clearTimeout(timer);
+            reject(new Error(`cloudflared exited early with code ${code}`));
+        });
+    }).catch(async (err) => {
+        child.kill("SIGKILL");
+        throw err;
+    });
+    return {
+        origin,
+        async close() {
+            if (child.exitCode !== null || child.killed)
+                return;
+            child.kill("SIGTERM");
+            await new Promise((resolve) => {
+                const force = setTimeout(() => {
+                    child.kill("SIGKILL");
+                    resolve();
+                }, 3000);
+                child.once("exit", () => {
+                    clearTimeout(force);
+                    resolve();
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=tunnel.js.map

package/dist/tunnel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tunnel.js","sourceRoot":"","sources":["../src/tunnel.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAqB,MAAM,oBAAoB,CAAC;AAQ9D,MAAM,WAAW,GAAG,2CAA2C,CAAC;AAChE,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAiB,KAAK,CAC/B,aAAa,EACb;QACE,QAAQ;QACR,iBAAiB;QACjB,OAAO;QACP,oBAAoB,IAAI,EAAE;KAC3B,EACD,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,CACtC,CAAC;IAEF,MAAM,MAAM,GAAG,MAAM,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC,CAAC;QACpE,CAAC,EAAE,gBAAgB,CAAC,CAAC;QAErB,MAAM,IAAI,GAAG,CAAC,KAAa,EAAE,EAAE;YAC7B,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;YACjD,IAAI,KAAK,EAAE,CAAC;gBACV,YAAY,CAAC,KAAK,CAAC,CAAC;gBACpB,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;YACpB,CAAC;QACH,CAAC,CAAC;QACF,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAC/B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CACJ,IAAI,KAAK,CACP,gCAAgC,GAAG,CAAC,OAAO,IAAI;gBAC7C,2CAA2C,CAC9C,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE;YAC1B,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,MAAM,CAAC,IAAI,KAAK,CAAC,sCAAsC,IAAI,EAAE,CAAC,CAAC,CAAC;QAClE,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,EAAE;QACrB,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACtB,MAAM,GAAG,CAAC;IACZ,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM;QACN,KAAK,CAAC,KAAK;YACT,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,MAAM;gBAAE,OAAO;YACpD,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACtB,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBAC5B,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;oBACtB,OAAO,EAAE,CAAC;gBACZ,CAAC,EAAE,IAAI,CAAC,CAAC;gBACT,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;oBACtB,YAAY,CAAC,KAAK,CAAC,CAAC;oBACpB,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;QACL,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,26 @@
+/** A web page after extraction and normalisation. */
+export interface Article {
+    /** The page this came from. Always kept for attribution. */
+    sourceUrl: string;
+    title: string;
+    /** Author line, when the page declares one. */
+    byline: string | null;
+    /** Publication or site name. */
+    siteName: string | null;
+    /** Short summary the page declares, if any. */
+    excerpt: string | null;
+    /** Cleaned article body as an HTML fragment. */
+    html: string;
+    /** Plain text, used for reading-time and diagnostics. */
+    text: string;
+    /** Absolute URLs of every image kept in the body. */
+    images: string[];
+    /** Language tag, defaults to "en". */
+    lang: string;
+}
+/** Where a built artifact ended up on disk. */
+export interface BuildResult {
+    htmlPath: string;
+    epubPath?: string;
+    kepubPath?: string;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "tidyread",
+  "version": "0.1.0",
+  "description": "Clean an article once, hand it to Instapaper's parser pre-chewed, and build a Kobo-ready EPUB.",
+  "main": "dist/cli.js",
+  "scripts": {
+    "test": "node --test",
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "typecheck": "tsc --noEmit",
+    "check": "npm run build && npm test",
+    "prepublishOnly": "npm run check",
+    "pack:dry-run": "npm pack --dry-run"
+  },
+  "keywords": [
+    "instapaper",
+    "kobo",
+    "epub",
+    "kepub",
+    "readability",
+    "read-later",
+    "article",
+    "e-ink",
+    "defuddle"
+  ],
+  "author": "parzival1l <nandhu02111997@gmail.com>",
+  "license": "MIT",
+  "type": "module",
+  "dependencies": {
+    "@mozilla/readability": "^0.6.0",
+    "commander": "^15.0.0",
+    "defuddle": "^0.19.3",
+    "jszip": "^3.10.2",
+    "linkedom": "^0.18.13",
+    "sanitize-html": "^2.17.7"
+  },
+  "devDependencies": {
+    "@types/node": "^26.5.0",
+    "@types/sanitize-html": "^2.16.1",
+    "typescript": "^7.0.2"
+  },
+  "bin": {
+    "tidyread": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/parzival1l/tidyread.git"
+  },
+  "homepage": "https://github.com/parzival1l/tidyread#readme",
+  "bugs": {
+    "url": "https://github.com/parzival1l/tidyread/issues"
+  },
+  "engines": {
+    "node": ">=20"
+  }
+}