meodp 0.0.9 → 0.2.0

package/dist/cli/main.cjs

@@ -0,0 +1,272 @@
+'use strict';
+
+const process = require('node:process');
+
+function _interopDefaultCompat (e) { return e && typeof e === 'object' && 'default' in e ? e.default : e; }
+
+const process__default = /*#__PURE__*/_interopDefaultCompat(process);
+
+const name = "meodp";
+const type = "module";
+const version = "0.2.0";
+const description = "Check website and friend-link availability with sitemap discovery, history, and portable reports.";
+const author = {
+	name: "YunYouJun",
+	url: "https://www.yunyoujun.cn"
+};
+const license = "MIT";
+const homepage = "https://yunyoujun.github.io/meodp/";
+const repository = {
+	type: "git",
+	url: "git+https://github.com/YunYouJun/meodp.git",
+	directory: "packages/meodp"
+};
+const bugs = {
+	url: "https://github.com/YunYouJun/meodp/issues"
+};
+const keywords = [
+	"meodp",
+	"link-checker",
+	"broken-links",
+	"sitemap",
+	"friend-links",
+	"cli"
+];
+const exports$1 = {
+	".": {
+		types: "./dist/index.d.ts",
+		"import": "./dist/index.mjs",
+		require: "./dist/index.cjs"
+	},
+	"./check": {
+		"import": {
+			types: "./dist/check/index.d.mts",
+			"default": "./dist/check/index.mjs"
+		},
+		require: {
+			types: "./dist/check/index.d.cts",
+			"default": "./dist/check/index.cjs"
+		}
+	},
+	"./config": {
+		"import": {
+			types: "./dist/config/index.d.mts",
+			"default": "./dist/config/index.mjs"
+		},
+		require: {
+			types: "./dist/config/index.d.cts",
+			"default": "./dist/config/index.cjs"
+		}
+	},
+	"./notify": {
+		"import": {
+			types: "./dist/notify/index.d.mts",
+			"default": "./dist/notify/index.mjs"
+		},
+		require: {
+			types: "./dist/notify/index.d.cts",
+			"default": "./dist/notify/index.cjs"
+		}
+	},
+	"./notify/feishu": {
+		"import": {
+			types: "./dist/notify/feishu.d.mts",
+			"default": "./dist/notify/feishu.mjs"
+		},
+		require: {
+			types: "./dist/notify/feishu.d.cts",
+			"default": "./dist/notify/feishu.cjs"
+		}
+	},
+	"./notify/email": {
+		"import": {
+			types: "./dist/notify/email.d.mts",
+			"default": "./dist/notify/email.mjs"
+		},
+		require: {
+			types: "./dist/notify/email.d.cts",
+			"default": "./dist/notify/email.cjs"
+		}
+	}
+};
+const main = "./dist/index.mjs";
+const module$1 = "./dist/index.mjs";
+const types = "./dist/index.d.ts";
+const bin = {
+	meodp: "bin/index.mjs"
+};
+const files = [
+	"bin/index.mjs",
+	"dist"
+];
+const engines = {
+	node: ">=22.19.0"
+};
+const scripts = {
+	build: "tsx scripts/build-report-viewer.ts && unbuild",
+	dev: "tsx scripts/build-report-viewer.ts && unbuild --stub",
+	test: "tsx scripts/build-report-viewer.ts && tsx --test test/*.test.ts",
+	"test:e2e": "tsx scripts/build-report-viewer.ts && playwright test",
+	typecheck: "tsx scripts/build-report-viewer.ts && tsc --noEmit -p tsconfig.json",
+	prepack: "npm run build",
+	release: "npm version --no-git-tag-version"
+};
+const peerDependencies = {
+	nodemailer: "^10.0.3",
+	playwright: "^1",
+	typescript: "^5.0.0"
+};
+const peerDependenciesMeta = {
+	nodemailer: {
+		optional: true
+	},
+	playwright: {
+		optional: true
+	},
+	typescript: {
+		optional: true
+	}
+};
+const dependencies = {
+	c12: "^2.0.1",
+	"cli-progress": "^3.12.0",
+	consola: "^3.2.3",
+	"date-fns": "^4.1.0",
+	"fast-xml-parser": "^5.11.1",
+	"fs-extra": "^11.2.0",
+	"js-yaml": "^4.1.0",
+	linkinator: "^8.1.0",
+	lowdb: "^7.0.1",
+	"markdown-table": "^3.0.4",
+	"p-queue": "^8.0.1",
+	"strip-ansi": "^7.1.0",
+	winston: "^3.17.0",
+	yargs: "^17.7.2"
+};
+const devDependencies = {
+	"@playwright/test": "^1.48.2",
+	"@types/bun": "latest",
+	"@types/cli-progress": "^3.11.6",
+	"@types/fs-extra": "^11.0.4",
+	"@types/js-yaml": "^4.0.9",
+	"@types/node": "^22.9.0",
+	"@types/nodemailer": "^8.0.1",
+	"@types/yargs": "^17.0.33",
+	cilicili: "^0.1.1",
+	esbuild: "^0.28.2",
+	nodemailer: "^10.0.3",
+	playwright: "^1.48.2",
+	tsx: "^4.19.2",
+	unbuild: "^2.0.0",
+	"vite-node": "^2.1.4"
+};
+const publishConfig = {
+	access: "public",
+	registry: "https://registry.npmjs.org/"
+};
+const pkg = {
+	name: name,
+	type: type,
+	version: version,
+	description: description,
+	author: author,
+	license: license,
+	homepage: homepage,
+	repository: repository,
+	bugs: bugs,
+	keywords: keywords,
+	exports: exports$1,
+	main: main,
+	module: module$1,
+	types: types,
+	bin: bin,
+	files: files,
+	engines: engines,
+	scripts: scripts,
+	peerDependencies: peerDependencies,
+	peerDependenciesMeta: peerDependenciesMeta,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	publishConfig: publishConfig
+};
+
+const help = `Usage: meodp <command> [options]
+
+Commands:
+  check <links.json|links.yml>  Request listed HTTP(S) URLs and write fresh reports
+  sitemap <sitemap-url>        Check pages listed in an XML sitemap or nested index
+  report [report.json]         Render saved data using JSON, Markdown or HTML reporters
+  notify                      Send configured report notifications; supports --dry-run
+  scan [root]                 Run the legacy browser scanner using meodp.config.ts
+  export [root]               Export a legacy browser-scan report
+
+Options:
+  -h, --help                  Show this help
+  -v, --version               Show the package version
+
+Examples:
+  meodp check links.yml --output reports/links
+  meodp sitemap https://example.com/sitemap.xml --output reports/pages
+  meodp report reports/links/report.json --output reports/site
+  meodp report reports/links/report.json --reporter json,markdown,html
+  meodp check --help
+  meodp help report
+
+check, sitemap, and scan initiate site checks. scan requires Playwright.
+Running meodp without arguments shows help; no scan starts automatically.
+`;
+async function runCli(args = process__default.argv.slice(2)) {
+  try {
+    const [command, ...rest] = args;
+    if (!command || command === "--help" || command === "-h") {
+      if (rest.length)
+        throw new Error("Use meodp <command> --help for command-specific help");
+      console.log(help);
+      return 0;
+    }
+    if (command === "--version" || command === "-v") {
+      if (rest.length)
+        throw new Error("--version does not accept additional arguments");
+      console.log(pkg.version);
+      return 0;
+    }
+    if (command === "help") {
+      if (!rest.length)
+        return runCli(["--help"]);
+      if (rest.length !== 1 || !["check", "sitemap", "report", "notify", "scan", "export"].includes(rest[0]))
+        throw new Error("Use meodp help <check|sitemap|report|notify|scan|export>");
+      return runCli([rest[0], "--help"]);
+    }
+    if (command === "notify") {
+      const { runNotifyCli } = await import('../notify/cli.cjs');
+      return runNotifyCli(rest);
+    }
+    if (command === "check") {
+      const { runCheckCli } = await import('../check/cli.cjs');
+      return runCheckCli(rest);
+    }
+    if (command === "report") {
+      const { runReportCli } = await import('../check/cli.cjs');
+      return runReportCli(rest);
+    }
+    if (command === "sitemap") {
+      const { runSitemapCli } = await import('../check/cli.cjs');
+      return runSitemapCli(rest);
+    }
+    if (command === "scan" || command === "export") {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        console.log(command === "scan" ? "Usage: meodp scan [root]\n\nRun the legacy Playwright scanner with meodp.config.ts in root (default: .).\nThis starts browser/network activity and uses the legacy configuration and reports." : "Usage: meodp export [root] [--type md|html]\n\nExport the legacy browser scanner's stored data.\nFor a schemaVersion: 1 report.json, use meodp report instead.");
+        return 0;
+      }
+      const { run } = await import('./index.cjs');
+      await run(command === "scan" ? rest : ["export", ...rest], command === "scan" ? "meodp scan" : "meodp");
+      return 0;
+    }
+    throw new Error(`Unknown command ${JSON.stringify(command)}. Use meodp --help. For the legacy scanner, use meodp scan [root].`);
+  } catch (error) {
+    console.error(`meodp: ${error instanceof Error ? error.message : String(error)}`);
+    return 2;
+  }
+}
+
+exports.runCli = runCli;

package/dist/cli/main.d.cts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };

package/dist/cli/main.d.mts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };

package/dist/cli/main.d.ts

@@ -0,0 +1,4 @@
+/** Keep command discovery independent of optional browser dependencies. */
+declare function runCli(args?: string[]): Promise<number>;
+
+export { runCli };

package/dist/cli/main.mjs

@@ -0,0 +1,266 @@
+import process from 'node:process';
+
+const name = "meodp";
+const type = "module";
+const version = "0.2.0";
+const description = "Check website and friend-link availability with sitemap discovery, history, and portable reports.";
+const author = {
+	name: "YunYouJun",
+	url: "https://www.yunyoujun.cn"
+};
+const license = "MIT";
+const homepage = "https://yunyoujun.github.io/meodp/";
+const repository = {
+	type: "git",
+	url: "git+https://github.com/YunYouJun/meodp.git",
+	directory: "packages/meodp"
+};
+const bugs = {
+	url: "https://github.com/YunYouJun/meodp/issues"
+};
+const keywords = [
+	"meodp",
+	"link-checker",
+	"broken-links",
+	"sitemap",
+	"friend-links",
+	"cli"
+];
+const exports = {
+	".": {
+		types: "./dist/index.d.ts",
+		"import": "./dist/index.mjs",
+		require: "./dist/index.cjs"
+	},
+	"./check": {
+		"import": {
+			types: "./dist/check/index.d.mts",
+			"default": "./dist/check/index.mjs"
+		},
+		require: {
+			types: "./dist/check/index.d.cts",
+			"default": "./dist/check/index.cjs"
+		}
+	},
+	"./config": {
+		"import": {
+			types: "./dist/config/index.d.mts",
+			"default": "./dist/config/index.mjs"
+		},
+		require: {
+			types: "./dist/config/index.d.cts",
+			"default": "./dist/config/index.cjs"
+		}
+	},
+	"./notify": {
+		"import": {
+			types: "./dist/notify/index.d.mts",
+			"default": "./dist/notify/index.mjs"
+		},
+		require: {
+			types: "./dist/notify/index.d.cts",
+			"default": "./dist/notify/index.cjs"
+		}
+	},
+	"./notify/feishu": {
+		"import": {
+			types: "./dist/notify/feishu.d.mts",
+			"default": "./dist/notify/feishu.mjs"
+		},
+		require: {
+			types: "./dist/notify/feishu.d.cts",
+			"default": "./dist/notify/feishu.cjs"
+		}
+	},
+	"./notify/email": {
+		"import": {
+			types: "./dist/notify/email.d.mts",
+			"default": "./dist/notify/email.mjs"
+		},
+		require: {
+			types: "./dist/notify/email.d.cts",
+			"default": "./dist/notify/email.cjs"
+		}
+	}
+};
+const main = "./dist/index.mjs";
+const module = "./dist/index.mjs";
+const types = "./dist/index.d.ts";
+const bin = {
+	meodp: "bin/index.mjs"
+};
+const files = [
+	"bin/index.mjs",
+	"dist"
+];
+const engines = {
+	node: ">=22.19.0"
+};
+const scripts = {
+	build: "tsx scripts/build-report-viewer.ts && unbuild",
+	dev: "tsx scripts/build-report-viewer.ts && unbuild --stub",
+	test: "tsx scripts/build-report-viewer.ts && tsx --test test/*.test.ts",
+	"test:e2e": "tsx scripts/build-report-viewer.ts && playwright test",
+	typecheck: "tsx scripts/build-report-viewer.ts && tsc --noEmit -p tsconfig.json",
+	prepack: "npm run build",
+	release: "npm version --no-git-tag-version"
+};
+const peerDependencies = {
+	nodemailer: "^10.0.3",
+	playwright: "^1",
+	typescript: "^5.0.0"
+};
+const peerDependenciesMeta = {
+	nodemailer: {
+		optional: true
+	},
+	playwright: {
+		optional: true
+	},
+	typescript: {
+		optional: true
+	}
+};
+const dependencies = {
+	c12: "^2.0.1",
+	"cli-progress": "^3.12.0",
+	consola: "^3.2.3",
+	"date-fns": "^4.1.0",
+	"fast-xml-parser": "^5.11.1",
+	"fs-extra": "^11.2.0",
+	"js-yaml": "^4.1.0",
+	linkinator: "^8.1.0",
+	lowdb: "^7.0.1",
+	"markdown-table": "^3.0.4",
+	"p-queue": "^8.0.1",
+	"strip-ansi": "^7.1.0",
+	winston: "^3.17.0",
+	yargs: "^17.7.2"
+};
+const devDependencies = {
+	"@playwright/test": "^1.48.2",
+	"@types/bun": "latest",
+	"@types/cli-progress": "^3.11.6",
+	"@types/fs-extra": "^11.0.4",
+	"@types/js-yaml": "^4.0.9",
+	"@types/node": "^22.9.0",
+	"@types/nodemailer": "^8.0.1",
+	"@types/yargs": "^17.0.33",
+	cilicili: "^0.1.1",
+	esbuild: "^0.28.2",
+	nodemailer: "^10.0.3",
+	playwright: "^1.48.2",
+	tsx: "^4.19.2",
+	unbuild: "^2.0.0",
+	"vite-node": "^2.1.4"
+};
+const publishConfig = {
+	access: "public",
+	registry: "https://registry.npmjs.org/"
+};
+const pkg = {
+	name: name,
+	type: type,
+	version: version,
+	description: description,
+	author: author,
+	license: license,
+	homepage: homepage,
+	repository: repository,
+	bugs: bugs,
+	keywords: keywords,
+	exports: exports,
+	main: main,
+	module: module,
+	types: types,
+	bin: bin,
+	files: files,
+	engines: engines,
+	scripts: scripts,
+	peerDependencies: peerDependencies,
+	peerDependenciesMeta: peerDependenciesMeta,
+	dependencies: dependencies,
+	devDependencies: devDependencies,
+	publishConfig: publishConfig
+};
+
+const help = `Usage: meodp <command> [options]
+
+Commands:
+  check <links.json|links.yml>  Request listed HTTP(S) URLs and write fresh reports
+  sitemap <sitemap-url>        Check pages listed in an XML sitemap or nested index
+  report [report.json]         Render saved data using JSON, Markdown or HTML reporters
+  notify                      Send configured report notifications; supports --dry-run
+  scan [root]                 Run the legacy browser scanner using meodp.config.ts
+  export [root]               Export a legacy browser-scan report
+
+Options:
+  -h, --help                  Show this help
+  -v, --version               Show the package version
+
+Examples:
+  meodp check links.yml --output reports/links
+  meodp sitemap https://example.com/sitemap.xml --output reports/pages
+  meodp report reports/links/report.json --output reports/site
+  meodp report reports/links/report.json --reporter json,markdown,html
+  meodp check --help
+  meodp help report
+
+check, sitemap, and scan initiate site checks. scan requires Playwright.
+Running meodp without arguments shows help; no scan starts automatically.
+`;
+async function runCli(args = process.argv.slice(2)) {
+  try {
+    const [command, ...rest] = args;
+    if (!command || command === "--help" || command === "-h") {
+      if (rest.length)
+        throw new Error("Use meodp <command> --help for command-specific help");
+      console.log(help);
+      return 0;
+    }
+    if (command === "--version" || command === "-v") {
+      if (rest.length)
+        throw new Error("--version does not accept additional arguments");
+      console.log(pkg.version);
+      return 0;
+    }
+    if (command === "help") {
+      if (!rest.length)
+        return runCli(["--help"]);
+      if (rest.length !== 1 || !["check", "sitemap", "report", "notify", "scan", "export"].includes(rest[0]))
+        throw new Error("Use meodp help <check|sitemap|report|notify|scan|export>");
+      return runCli([rest[0], "--help"]);
+    }
+    if (command === "notify") {
+      const { runNotifyCli } = await import('../notify/cli.mjs');
+      return runNotifyCli(rest);
+    }
+    if (command === "check") {
+      const { runCheckCli } = await import('../check/cli.mjs');
+      return runCheckCli(rest);
+    }
+    if (command === "report") {
+      const { runReportCli } = await import('../check/cli.mjs');
+      return runReportCli(rest);
+    }
+    if (command === "sitemap") {
+      const { runSitemapCli } = await import('../check/cli.mjs');
+      return runSitemapCli(rest);
+    }
+    if (command === "scan" || command === "export") {
+      if (rest.includes("--help") || rest.includes("-h")) {
+        console.log(command === "scan" ? "Usage: meodp scan [root]\n\nRun the legacy Playwright scanner with meodp.config.ts in root (default: .).\nThis starts browser/network activity and uses the legacy configuration and reports." : "Usage: meodp export [root] [--type md|html]\n\nExport the legacy browser scanner's stored data.\nFor a schemaVersion: 1 report.json, use meodp report instead.");
+        return 0;
+      }
+      const { run } = await import('./index.mjs');
+      await run(command === "scan" ? rest : ["export", ...rest], command === "scan" ? "meodp scan" : "meodp");
+      return 0;
+    }
+    throw new Error(`Unknown command ${JSON.stringify(command)}. Use meodp --help. For the legacy scanner, use meodp scan [root].`);
+  } catch (error) {
+    console.error(`meodp: ${error instanceof Error ? error.message : String(error)}`);
+    return 2;
+  }
+}
+
+export { runCli };

package/dist/config/index.cjs

@@ -0,0 +1,7 @@
+'use strict';
+
+function defineConfig(config) {
+  return config;
+}
+
+exports.defineConfig = defineConfig;

package/dist/config/index.d.cts

@@ -0,0 +1,47 @@
+import { R as ReporterConfig, a as ReportVerificationOptions } from '../shared/meodp.4f1da070.cjs';
+import { S as SitemapOptions } from '../shared/meodp.93e06e00.cjs';
+import { EmailOptions } from '../notify/email.cjs';
+import { FeishuOptions } from '../notify/feishu.cjs';
+import { NotificationOptions } from '../notify/index.cjs';
+
+interface ScanConfig extends Omit<SitemapOptions, 'previousReport' | 'onResult'> {
+    input?: string;
+    reporter?: ReporterConfig;
+    output?: string;
+    history?: string;
+    /** Seed missing history from a committed snapshot. */
+    historySeed?: string;
+    observerMismatch?: 'error' | 'reset';
+    site?: string;
+    failOn?: 'unavailable' | 'review' | 'none';
+}
+interface NotificationConfig extends Omit<NotificationOptions, 'previousReport' | 'mode'> {
+    input: string;
+    previousReport?: string;
+    timeZone?: string;
+    maxItems?: number;
+    feishu?: FeishuOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+    email?: EmailOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+}
+interface MeodpConfig {
+    /** Shared reporters; command sections may override this selection. */
+    reporter?: ReporterConfig;
+    check?: ScanConfig;
+    sitemap?: ScanConfig;
+    report?: {
+        reporter?: ReporterConfig;
+        input?: string;
+        output?: string;
+        dataUrl?: string;
+        verify?: ReportVerificationOptions;
+    };
+    notify?: NotificationConfig;
+}
+/** Lightweight configuration entry; importing it does not load browser or mail clients. */
+declare function defineConfig<const T extends MeodpConfig>(config: T): T;
+
+export { type MeodpConfig, type NotificationConfig, type ScanConfig, defineConfig };

package/dist/config/index.d.mts

@@ -0,0 +1,47 @@
+import { R as ReporterConfig, a as ReportVerificationOptions } from '../shared/meodp.a704f8db.mjs';
+import { S as SitemapOptions } from '../shared/meodp.93e06e00.mjs';
+import { EmailOptions } from '../notify/email.mjs';
+import { FeishuOptions } from '../notify/feishu.mjs';
+import { NotificationOptions } from '../notify/index.mjs';
+
+interface ScanConfig extends Omit<SitemapOptions, 'previousReport' | 'onResult'> {
+    input?: string;
+    reporter?: ReporterConfig;
+    output?: string;
+    history?: string;
+    /** Seed missing history from a committed snapshot. */
+    historySeed?: string;
+    observerMismatch?: 'error' | 'reset';
+    site?: string;
+    failOn?: 'unavailable' | 'review' | 'none';
+}
+interface NotificationConfig extends Omit<NotificationOptions, 'previousReport' | 'mode'> {
+    input: string;
+    previousReport?: string;
+    timeZone?: string;
+    maxItems?: number;
+    feishu?: FeishuOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+    email?: EmailOptions & {
+        mode?: NotificationOptions['mode'];
+    };
+}
+interface MeodpConfig {
+    /** Shared reporters; command sections may override this selection. */
+    reporter?: ReporterConfig;
+    check?: ScanConfig;
+    sitemap?: ScanConfig;
+    report?: {
+        reporter?: ReporterConfig;
+        input?: string;
+        output?: string;
+        dataUrl?: string;
+        verify?: ReportVerificationOptions;
+    };
+    notify?: NotificationConfig;
+}
+/** Lightweight configuration entry; importing it does not load browser or mail clients. */
+declare function defineConfig<const T extends MeodpConfig>(config: T): T;
+
+export { type MeodpConfig, type NotificationConfig, type ScanConfig, defineConfig };