website-to-markdown 1.0.0 → 1.0.1

package/dist/cli.d.ts

@@ -1,3 +1,10 @@
 #!/usr/bin/env bun
-export {};
+/**
+ * Fetch a public URL as markdown and print the result. Page metadata goes to
+ * stderr; markdown goes to stdout.
+ */
+import { type CliIO } from 'hanzio/cli';
+export declare const cli: import("hanzio/cli").Cli;
+/** The bin: 1.0 printed the help and exited 1 when no URL was given, even with `--help`. */
+export declare function main(argv: readonly string[], io?: CliIO): Promise<number>;
 //# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,KAAK,KAAK,EAAsC,MAAM,YAAY,CAAA;AAI3E,eAAO,MAAM,GAAG,0BAiEd,CAAA;AAEF,4FAA4F;AAC5F,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,EAAE,CAAC,EAAE,KAAK,mBAI7D"}

package/dist/cli.js

@@ -3,64 +3,67 @@
  * Fetch a public URL as markdown and print the result. Page metadata goes to
  * stderr; markdown goes to stdout.
  */
+import { CliError, defineCli, defineCommand } from 'hanzio/cli';
+import { z } from 'zod';
 import { createWebsiteToMarkdown } from './fetch-page.js';
-const HELP = `
-Fetch a public URL as markdown.
-
-Usage:
-  website-to-markdown <url> [--no-render]
-
-Options:
-  --no-render   Skip the Browser Rendering tier (HTML tiers only).
-
-Environment:
-  CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
-
-Example:
-  website-to-markdown https://example.com/about
-`.trim();
-const args = Bun.argv.slice(2);
-const url = args.find((arg) => !arg.startsWith('-'));
-if (!url || args.includes('-h') || args.includes('--help')) {
-    console.log(HELP);
-    process.exit(url ? 0 : 1);
-}
-const { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = process.env;
-if (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID) {
-    console.error('Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.');
-    process.exit(1);
-}
-const { fetchPageAsMarkdown } = createWebsiteToMarkdown({
-    cloudflare: {
-        apiToken: CLOUDFLARE_API_TOKEN,
-        accountId: CLOUDFLARE_ACCOUNT_ID
-    }
+export const cli = defineCli({
+    name: 'website-to-markdown',
+    commands: defineCommand({
+        description: 'Fetch a public URL as markdown. Needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.',
+        input: z.object({
+            url: z
+                .string()
+                .describe('e.g. https://example.com/about')
+                .meta({ positional: true }),
+            render: z
+                .boolean()
+                .default(true)
+                .describe('Use the Browser Rendering tier; --no-render keeps to HTML tiers.')
+        }),
+        run: async ({ url, render }, ctx) => {
+            const { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = ctx.env;
+            if (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID)
+                throw new CliError('Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.');
+            const { fetchPageAsMarkdown } = createWebsiteToMarkdown({
+                cloudflare: {
+                    apiToken: CLOUDFLARE_API_TOKEN,
+                    accountId: CLOUDFLARE_ACCOUNT_ID
+                }
+            });
+            ctx.stderr.write(`Fetching ${url}…\n`);
+            const page = await fetchPageAsMarkdown({ url, render });
+            ctx.stderr.write(`${JSON.stringify({
+                outcome: page.outcome,
+                status: page.status,
+                source: page.source,
+                url: page.url,
+                finalUrl: page.finalUrl,
+                contentType: page.contentType,
+                etag: page.etag,
+                lastModified: page.lastModified,
+                title: page.title,
+                lang: page.lang,
+                canonical: page.canonical,
+                metaDescription: page.metaDescription,
+                jsonLdBlocks: page.jsonLd.length,
+                links: page.links.length,
+                images: page.images.length,
+                markdownChars: page.markdown.length,
+                durationMs: page.durationMs
+            }, null, 2)}\n`);
+            if (page.outcome !== 'ok')
+                ctx.exitCode = 1;
+            return page.markdown;
+        }
+    })
 });
-console.error(`Fetching ${url}…`);
-const page = await fetchPageAsMarkdown({
-    url,
-    render: !args.includes('--no-render')
-});
-console.error(JSON.stringify({
-    outcome: page.outcome,
-    status: page.status,
-    source: page.source,
-    url: page.url,
-    finalUrl: page.finalUrl,
-    contentType: page.contentType,
-    etag: page.etag,
-    lastModified: page.lastModified,
-    title: page.title,
-    lang: page.lang,
-    canonical: page.canonical,
-    metaDescription: page.metaDescription,
-    jsonLdBlocks: page.jsonLd.length,
-    links: page.links.length,
-    images: page.images.length,
-    markdownChars: page.markdown.length,
-    durationMs: page.durationMs
-}, null, 2));
-console.log(page.markdown);
-if (page.outcome !== 'ok')
-    process.exit(1);
+/** The bin: 1.0 printed the help and exited 1 when no URL was given, even with `--help`. */
+export async function main(argv, io) {
+    if (argv.some((arg) => !arg.startsWith('-')))
+        return cli.run(argv, io);
+    await cli.run(['--help'], io);
+    return 1;
+}
+if (import.meta.main)
+    process.exitCode = await main(process.argv.slice(2));
 //# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;GAGG;AACH,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAA;AAEzD,MAAM,IAAI,GAAG;;;;;;;;;;;;;;CAcZ,CAAC,IAAI,EAAE,CAAA;AAER,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;AAC9B,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAA;AACpD,IAAI,CAAC,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;IAC5D,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IACjB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;AAC1B,CAAC;AAED,MAAM,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,GAAG,OAAO,CAAC,GAAG,CAAA;AACnE,IAAI,CAAC,oBAAoB,IAAI,CAAC,qBAAqB,EAAE,CAAC;IACrD,OAAO,CAAC,KAAK,CAAC,qDAAqD,CAAC,CAAA;IACpE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAChB,CAAC;AAED,MAAM,EAAE,mBAAmB,EAAE,GAAG,uBAAuB,CAAC;IACvD,UAAU,EAAE;QACX,QAAQ,EAAE,oBAAoB;QAC9B,SAAS,EAAE,qBAAqB;KAChC;CACD,CAAC,CAAA;AAEF,OAAO,CAAC,KAAK,CAAC,YAAY,GAAG,GAAG,CAAC,CAAA;AAEjC,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC;IACtC,GAAG;IACH,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC;CACrC,CAAC,CAAA;AAEF,OAAO,CAAC,KAAK,CACZ,IAAI,CAAC,SAAS,CACb;IACC,OAAO,EAAE,IAAI,CAAC,OAAO;IACrB,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,MAAM,EAAE,IAAI,CAAC,MAAM;IACnB,GAAG,EAAE,IAAI,CAAC,GAAG;IACb,QAAQ,EAAE,IAAI,CAAC,QAAQ;IACvB,WAAW,EAAE,IAAI,CAAC,WAAW;IAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,YAAY,EAAE,IAAI,CAAC,YAAY;IAC/B,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC,IAAI;IACf,SAAS,EAAE,IAAI,CAAC,SAAS;IACzB,eAAe,EAAE,IAAI,CAAC,eAAe;IACrC,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;IAChC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM;IACxB,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;IAC1B,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,MAAM;IACnC,UAAU,EAAE,IAAI,CAAC,UAAU;CAC3B,EACD,IAAI,EACJ,CAAC,CACD,CACD,CAAA;AAED,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AAC1B,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI;IAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA","sourcesContent":["#!/usr/bin/env bun\n/**\n * Fetch a public URL as markdown and print the result. Page metadata goes to\n * stderr; markdown goes to stdout.\n */\nimport { createWebsiteToMarkdown } from './fetch-page.js'\n\nconst HELP = `\nFetch a public URL as markdown.\n\nUsage:\n  website-to-markdown <url> [--no-render]\n\nOptions:\n  --no-render   Skip the Browser Rendering tier (HTML tiers only).\n\nEnvironment:\n  CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID\n\nExample:\n  website-to-markdown https://example.com/about\n`.trim()\n\nconst args = Bun.argv.slice(2)\nconst url = args.find((arg) => !arg.startsWith('-'))\nif (!url || args.includes('-h') || args.includes('--help')) {\n\tconsole.log(HELP)\n\tprocess.exit(url ? 0 : 1)\n}\n\nconst { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = process.env\nif (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID) {\n\tconsole.error('Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.')\n\tprocess.exit(1)\n}\n\nconst { fetchPageAsMarkdown } = createWebsiteToMarkdown({\n\tcloudflare: {\n\t\tapiToken: CLOUDFLARE_API_TOKEN,\n\t\taccountId: CLOUDFLARE_ACCOUNT_ID\n\t}\n})\n\nconsole.error(`Fetching ${url}…`)\n\nconst page = await fetchPageAsMarkdown({\n\turl,\n\trender: !args.includes('--no-render')\n})\n\nconsole.error(\n\tJSON.stringify(\n\t\t{\n\t\t\toutcome: page.outcome,\n\t\t\tstatus: page.status,\n\t\t\tsource: page.source,\n\t\t\turl: page.url,\n\t\t\tfinalUrl: page.finalUrl,\n\t\t\tcontentType: page.contentType,\n\t\t\tetag: page.etag,\n\t\t\tlastModified: page.lastModified,\n\t\t\ttitle: page.title,\n\t\t\tlang: page.lang,\n\t\t\tcanonical: page.canonical,\n\t\t\tmetaDescription: page.metaDescription,\n\t\t\tjsonLdBlocks: page.jsonLd.length,\n\t\t\tlinks: page.links.length,\n\t\t\timages: page.images.length,\n\t\t\tmarkdownChars: page.markdown.length,\n\t\t\tdurationMs: page.durationMs\n\t\t},\n\t\tnull,\n\t\t2\n\t)\n)\n\nconsole.log(page.markdown)\nif (page.outcome !== 'ok') process.exit(1)\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["#!/usr/bin/env bun\n/**\n * Fetch a public URL as markdown and print the result. Page metadata goes to\n * stderr; markdown goes to stdout.\n */\nimport { type CliIO, CliError, defineCli, defineCommand } from 'hanzio/cli'\nimport { z } from 'zod'\nimport { createWebsiteToMarkdown } from './fetch-page.js'\n\nexport const cli = defineCli({\n\tname: 'website-to-markdown',\n\tcommands: defineCommand({\n\t\tdescription:\n\t\t\t'Fetch a public URL as markdown. Needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.',\n\t\tinput: z.object({\n\t\t\turl: z\n\t\t\t\t.string()\n\t\t\t\t.describe('e.g. https://example.com/about')\n\t\t\t\t.meta({ positional: true }),\n\t\t\trender: z\n\t\t\t\t.boolean()\n\t\t\t\t.default(true)\n\t\t\t\t.describe(\n\t\t\t\t\t'Use the Browser Rendering tier; --no-render keeps to HTML tiers.'\n\t\t\t\t)\n\t\t}),\n\t\trun: async ({ url, render }, ctx) => {\n\t\t\tconst { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = ctx.env\n\t\t\tif (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID)\n\t\t\t\tthrow new CliError(\n\t\t\t\t\t'Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.'\n\t\t\t\t)\n\n\t\t\tconst { fetchPageAsMarkdown } = createWebsiteToMarkdown({\n\t\t\t\tcloudflare: {\n\t\t\t\t\tapiToken: CLOUDFLARE_API_TOKEN,\n\t\t\t\t\taccountId: CLOUDFLARE_ACCOUNT_ID\n\t\t\t\t}\n\t\t\t})\n\n\t\t\tctx.stderr.write(`Fetching ${url}…\\n`)\n\n\t\t\tconst page = await fetchPageAsMarkdown({ url, render })\n\n\t\t\tctx.stderr.write(\n\t\t\t\t`${JSON.stringify(\n\t\t\t\t\t{\n\t\t\t\t\t\toutcome: page.outcome,\n\t\t\t\t\t\tstatus: page.status,\n\t\t\t\t\t\tsource: page.source,\n\t\t\t\t\t\turl: page.url,\n\t\t\t\t\t\tfinalUrl: page.finalUrl,\n\t\t\t\t\t\tcontentType: page.contentType,\n\t\t\t\t\t\tetag: page.etag,\n\t\t\t\t\t\tlastModified: page.lastModified,\n\t\t\t\t\t\ttitle: page.title,\n\t\t\t\t\t\tlang: page.lang,\n\t\t\t\t\t\tcanonical: page.canonical,\n\t\t\t\t\t\tmetaDescription: page.metaDescription,\n\t\t\t\t\t\tjsonLdBlocks: page.jsonLd.length,\n\t\t\t\t\t\tlinks: page.links.length,\n\t\t\t\t\t\timages: page.images.length,\n\t\t\t\t\t\tmarkdownChars: page.markdown.length,\n\t\t\t\t\t\tdurationMs: page.durationMs\n\t\t\t\t\t},\n\t\t\t\t\tnull,\n\t\t\t\t\t2\n\t\t\t\t)}\\n`\n\t\t\t)\n\n\t\t\tif (page.outcome !== 'ok') ctx.exitCode = 1\n\t\t\treturn page.markdown\n\t\t}\n\t})\n})\n\n/** The bin: 1.0 printed the help and exited 1 when no URL was given, even with `--help`. */\nexport async function main(argv: readonly string[], io?: CliIO) {\n\tif (argv.some((arg) => !arg.startsWith('-'))) return cli.run(argv, io)\n\tawait cli.run(['--help'], io)\n\treturn 1\n}\n\nif (import.meta.main) process.exitCode = await main(process.argv.slice(2))\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "website-to-markdown",
-	"version": "1.0.0",
+	"version": "1.0.1",
 	"description": "Turn URLs, HTML and files into markdown, with sitemap discovery and per-host limits.",
 	"type": "module",
 	"license": "MIT",
@@ -62,16 +62,16 @@
 		"fflate": "^0.8.2"
 	},
 	"peerDependencies": {
-		"hanzio": "^3.0.0",
+		"hanzio": "^3.1.0",
 		"zod": "^4.0.0"
 	},
 	"devDependencies": {
+		"@arethetypeswrong/cli": "^0.18.2",
 		"@biomejs/biome": "^2.2.4",
 		"@types/bun": "^1.2.0",
-		"typescript": "^5.9.2",
-		"@arethetypeswrong/cli": "^0.18.2",
-		"hanzio": "^3.0.0",
+		"hanzio": "^3.1.0",
 		"publint": "^0.3.12",
+		"typescript": "^5.9.2",
 		"zod": "^4.4.3"
 	},
 	"bugs": {

package/src/cli.ts

@@ -3,76 +3,82 @@
  * Fetch a public URL as markdown and print the result. Page metadata goes to
  * stderr; markdown goes to stdout.
  */
+import { type CliIO, CliError, defineCli, defineCommand } from 'hanzio/cli'
+import { z } from 'zod'
 import { createWebsiteToMarkdown } from './fetch-page.js'
 
-const HELP = `
-Fetch a public URL as markdown.
+export const cli = defineCli({
+	name: 'website-to-markdown',
+	commands: defineCommand({
+		description:
+			'Fetch a public URL as markdown. Needs CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.',
+		input: z.object({
+			url: z
+				.string()
+				.describe('e.g. https://example.com/about')
+				.meta({ positional: true }),
+			render: z
+				.boolean()
+				.default(true)
+				.describe(
+					'Use the Browser Rendering tier; --no-render keeps to HTML tiers.'
+				)
+		}),
+		run: async ({ url, render }, ctx) => {
+			const { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = ctx.env
+			if (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID)
+				throw new CliError(
+					'Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.'
+				)
 
-Usage:
-  website-to-markdown <url> [--no-render]
+			const { fetchPageAsMarkdown } = createWebsiteToMarkdown({
+				cloudflare: {
+					apiToken: CLOUDFLARE_API_TOKEN,
+					accountId: CLOUDFLARE_ACCOUNT_ID
+				}
+			})
 
-Options:
-  --no-render   Skip the Browser Rendering tier (HTML tiers only).
+			ctx.stderr.write(`Fetching ${url}…\n`)
 
-Environment:
-  CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID
+			const page = await fetchPageAsMarkdown({ url, render })
 
-Example:
-  website-to-markdown https://example.com/about
-`.trim()
+			ctx.stderr.write(
+				`${JSON.stringify(
+					{
+						outcome: page.outcome,
+						status: page.status,
+						source: page.source,
+						url: page.url,
+						finalUrl: page.finalUrl,
+						contentType: page.contentType,
+						etag: page.etag,
+						lastModified: page.lastModified,
+						title: page.title,
+						lang: page.lang,
+						canonical: page.canonical,
+						metaDescription: page.metaDescription,
+						jsonLdBlocks: page.jsonLd.length,
+						links: page.links.length,
+						images: page.images.length,
+						markdownChars: page.markdown.length,
+						durationMs: page.durationMs
+					},
+					null,
+					2
+				)}\n`
+			)
 
-const args = Bun.argv.slice(2)
-const url = args.find((arg) => !arg.startsWith('-'))
-if (!url || args.includes('-h') || args.includes('--help')) {
-	console.log(HELP)
-	process.exit(url ? 0 : 1)
-}
-
-const { CLOUDFLARE_API_TOKEN, CLOUDFLARE_ACCOUNT_ID } = process.env
-if (!CLOUDFLARE_API_TOKEN || !CLOUDFLARE_ACCOUNT_ID) {
-	console.error('Set CLOUDFLARE_API_TOKEN and CLOUDFLARE_ACCOUNT_ID.')
-	process.exit(1)
-}
-
-const { fetchPageAsMarkdown } = createWebsiteToMarkdown({
-	cloudflare: {
-		apiToken: CLOUDFLARE_API_TOKEN,
-		accountId: CLOUDFLARE_ACCOUNT_ID
-	}
+			if (page.outcome !== 'ok') ctx.exitCode = 1
+			return page.markdown
+		}
+	})
 })
 
-console.error(`Fetching ${url}…`)
-
-const page = await fetchPageAsMarkdown({
-	url,
-	render: !args.includes('--no-render')
-})
-
-console.error(
-	JSON.stringify(
-		{
-			outcome: page.outcome,
-			status: page.status,
-			source: page.source,
-			url: page.url,
-			finalUrl: page.finalUrl,
-			contentType: page.contentType,
-			etag: page.etag,
-			lastModified: page.lastModified,
-			title: page.title,
-			lang: page.lang,
-			canonical: page.canonical,
-			metaDescription: page.metaDescription,
-			jsonLdBlocks: page.jsonLd.length,
-			links: page.links.length,
-			images: page.images.length,
-			markdownChars: page.markdown.length,
-			durationMs: page.durationMs
-		},
-		null,
-		2
-	)
-)
+/** The bin: 1.0 printed the help and exited 1 when no URL was given, even with `--help`. */
+export async function main(argv: readonly string[], io?: CliIO) {
+	if (argv.some((arg) => !arg.startsWith('-'))) return cli.run(argv, io)
+	await cli.run(['--help'], io)
+	return 1
+}
 
-console.log(page.markdown)
-if (page.outcome !== 'ok') process.exit(1)
+if (import.meta.main) process.exitCode = await main(process.argv.slice(2))