iptv-doctor 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IPTV Star contributors
+
+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,30 @@
+# IPTV Doctor
+
+Flagship CLI for checking, cleaning, and reporting on IPTV M3U/HLS playlists.
+
+## Run
+
+Published package:
+
+```bash
+npx iptv-doctor check playlist.m3u --report report.html --json report.json --csv report.csv
+npx iptv-doctor report report.json --html report.html --csv report.csv --badge badge.json
+npx iptv-doctor clean playlist.m3u --out clean.m3u
+npx iptv-doctor epg check playlist.m3u guide.xml --json epg.json
+npx iptv-doctor epg fix playlist.m3u guide.xml --out fixed.m3u
+npx iptv-doctor badge report.json --out badge.json
+npx iptv-doctor mcp --list-tools
+npx iptv-doctor worldcup --country US --format xmltv --out worldcup.xml
+npx iptv-doctor worldcup --country US --format html --out worldcup-guide.html
+```
+
+Source checkout:
+
+```bash
+pnpm --filter iptv-doctor doctor check playlist.m3u --report report.html --json report.json --csv report.csv
+```
+
+`check` can also write `--badge badge.json` directly for Shields endpoint usage.
+`mcp` starts a stdio MCP server; `--list-tools` prints the bundled tool names for verification.
+
+IPTV Doctor does not provide streams, paid channel lists, Xtream credentials, Stalker portals, MAC lists, or DRM bypass tools.

package/bin/iptv-doctor.mjs

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+const { runIptvDoctorCli } = await import("../dist/cli.js");
+
+runIptvDoctorCli().catch((error) => {
+  console.error(error instanceof Error ? error.message : error);
+  process.exit(1);
+});

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { type ProbeOptions } from "iptv-doctor-core";
+export interface IptvDoctorCliOptions extends ProbeOptions {
+    stdout?: (value: string) => void;
+}
+export declare function runIptvDoctorCli(argv?: string[], options?: IptvDoctorCliOptions): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAKA,OAAO,EAWL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAc1B,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED,wBAAsB,gBAAgB,CAAC,IAAI,WAAe,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CA4C7G"}

package/dist/cli.js

@@ -0,0 +1,191 @@
+#!/usr/bin/env node
+import { readFileSync, writeFileSync } from "node:fs";
+import { generateICalendar, generateM3UPlaceholder, generateWorldCupGuideHtml, generateXMLTV } from "@bjia666/match2epg";
+import { getWorldCup2026Dataset } from "iptv-sports-data";
+import { IPTV_DOCTOR_MCP_TOOLS, runIptvDoctorMcpServer } from "./mcp.js";
+import { parseM3U, probePlaylist, analyzeEpgMatches, renderShieldsBadgeJson, renderCleanM3U, renderCsvReport, renderDiagnosticsHtml, renderFixedEpgM3U, renderJsonReport } from "iptv-doctor-core";
+function usage() {
+    return `Usage:
+  iptv-doctor check <playlist.m3u> --report report.html [--json report.json] [--csv report.csv] [--badge badge.json]
+  iptv-doctor clean <playlist.m3u> --out clean.m3u
+  iptv-doctor epg check <playlist.m3u> <guide.xml> --json epg.json
+  iptv-doctor epg fix <playlist.m3u> <guide.xml> --out fixed.m3u
+  iptv-doctor report <report.json> [--html report.html] [--csv report.csv] [--badge badge.json]
+  iptv-doctor badge <report.json> --out badge.json
+  iptv-doctor mcp [--list-tools]
+  iptv-doctor worldcup --country US --format xmltv|ics|m3u|html --out worldcup.xml`;
+}
+export async function runIptvDoctorCli(argv = process.argv, options = {}) {
+    const command = argv[2];
+    if (!command || command === "--help" || command === "-h" || command === "help") {
+        writeStdout(options, `${usage()}\n`);
+        return;
+    }
+    if (command === "check") {
+        await runCheck(argv.slice(3), options);
+        return;
+    }
+    if (command === "clean") {
+        await runClean(argv.slice(3), options);
+        return;
+    }
+    if (command === "worldcup") {
+        runWorldCup(argv.slice(3));
+        return;
+    }
+    if (command === "epg") {
+        runEpg(argv.slice(3));
+        return;
+    }
+    if (command === "badge") {
+        runBadge(argv.slice(3), options);
+        return;
+    }
+    if (command === "report") {
+        runReport(argv.slice(3), options);
+        return;
+    }
+    if (command === "mcp") {
+        await runMcp(argv.slice(3), options);
+        return;
+    }
+    throw new Error(usage());
+}
+async function runCheck(args, options) {
+    const input = args[0];
+    if (!input)
+        throw new Error(usage());
+    const report = readFlag(args, "--report") ?? "iptv-doctor-report.html";
+    const json = readFlag(args, "--json");
+    const csv = readFlag(args, "--csv");
+    const badge = readFlag(args, "--badge");
+    const playlist = readFileSync(input, "utf8");
+    const channels = parseM3U(playlist);
+    const diagnostics = await probePlaylist(channels, options);
+    writeFileSync(report, renderDiagnosticsHtml(diagnostics));
+    if (json)
+        writeFileSync(json, renderJsonReport(diagnostics));
+    if (csv)
+        writeFileSync(csv, renderCsvReport(diagnostics));
+    if (badge)
+        writeFileSync(badge, renderShieldsBadgeJson(diagnostics));
+    process.stdout.write(`Checked ${channels.length} channels. Report written to ${report}\n`);
+}
+async function runClean(args, options) {
+    const input = args[0];
+    const output = readFlag(args, "--out");
+    if (!input || !output)
+        throw new Error(usage());
+    const playlist = readFileSync(input, "utf8");
+    const channels = parseM3U(playlist);
+    const diagnostics = await probePlaylist(channels, options);
+    writeFileSync(output, renderCleanM3U(diagnostics));
+    process.stdout.write(`Wrote clean playlist to ${output}\n`);
+}
+function runEpg(args) {
+    const subcommand = args[0];
+    const playlistPath = args[1];
+    const guidePath = args[2];
+    if (!subcommand || !playlistPath || !guidePath)
+        throw new Error(usage());
+    const playlist = readFileSync(playlistPath, "utf8");
+    const guide = readFileSync(guidePath, "utf8");
+    if (subcommand === "check") {
+        const json = readFlag(args, "--json");
+        const result = `${JSON.stringify(analyzeEpgMatches(playlist, guide), null, 2)}\n`;
+        if (json) {
+            writeFileSync(json, result);
+        }
+        else {
+            process.stdout.write(result);
+        }
+        return;
+    }
+    if (subcommand === "fix") {
+        const output = readFlag(args, "--out");
+        if (!output)
+            throw new Error(usage());
+        writeFileSync(output, renderFixedEpgM3U(playlist, guide));
+        process.stdout.write(`Wrote EPG-fixed playlist to ${output}\n`);
+        return;
+    }
+    throw new Error(usage());
+}
+function runBadge(args, options) {
+    const input = args[0];
+    const output = readFlag(args, "--out");
+    if (!input || !output)
+        throw new Error(usage());
+    const diagnostics = readDiagnosticsReport(input);
+    writeFileSync(output, renderShieldsBadgeJson(diagnostics));
+    writeStdout(options, `Wrote health badge JSON to ${output}\n`);
+}
+function runReport(args, options) {
+    const input = args[0];
+    if (!input)
+        throw new Error(usage());
+    const html = readFlag(args, "--html");
+    const csv = readFlag(args, "--csv");
+    const badge = readFlag(args, "--badge");
+    if (!html && !csv && !badge)
+        throw new Error(usage());
+    const diagnostics = readDiagnosticsReport(input);
+    if (html)
+        writeFileSync(html, renderDiagnosticsHtml(diagnostics));
+    if (csv)
+        writeFileSync(csv, renderCsvReport(diagnostics));
+    if (badge)
+        writeFileSync(badge, renderShieldsBadgeJson(diagnostics));
+    writeStdout(options, `Rendered report assets from ${input}\n`);
+}
+async function runMcp(args, options) {
+    if (args.includes("--list-tools")) {
+        writeStdout(options, `${IPTV_DOCTOR_MCP_TOOLS.join("\n")}\n`);
+        return;
+    }
+    await runIptvDoctorMcpServer();
+}
+function runWorldCup(args) {
+    const country = (readFlag(args, "--country") ?? "US");
+    const format = readFlag(args, "--format") ?? "xmltv";
+    const output = readFlag(args, "--out");
+    if (!output)
+        throw new Error(usage());
+    if (!["US", "CA", "MX"].includes(country)) {
+        throw new Error("World Cup country must be one of US, CA, MX.");
+    }
+    const dataset = getWorldCup2026Dataset();
+    const content = format === "xmltv"
+        ? generateXMLTV(dataset, country)
+        : format === "ics"
+            ? generateICalendar(dataset)
+            : format === "m3u"
+                ? generateM3UPlaceholder(dataset, country)
+                : format === "html"
+                    ? generateWorldCupGuideHtml(dataset, country)
+                    : undefined;
+    if (!content)
+        throw new Error("World Cup format must be one of xmltv, ics, m3u, html.");
+    writeFileSync(output, content);
+    process.stdout.write(`Wrote World Cup ${format} metadata to ${output}\n`);
+}
+function readFlag(args, flag) {
+    const index = args.indexOf(flag);
+    return index >= 0 ? args[index + 1] : undefined;
+}
+function readDiagnosticsReport(input) {
+    const parsed = JSON.parse(readFileSync(input, "utf8"));
+    if (!Array.isArray(parsed.diagnostics)) {
+        throw new Error("Input must be a JSON diagnostics report generated by iptv-doctor check --json.");
+    }
+    return parsed.diagnostics;
+}
+function writeStdout(options, value) {
+    (options.stdout ?? process.stdout.write.bind(process.stdout))(value);
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+    runIptvDoctorCli().catch((error) => {
+        console.error(error instanceof Error ? error.message : error);
+        process.exit(1);
+    });
+}

package/dist/mcp.d.ts

@@ -0,0 +1,5 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const IPTV_DOCTOR_MCP_TOOLS: readonly ["list_worldcup_matches", "us_legal_viewing_paths", "generate_us_xmltv"];
+export declare function createIptvDoctorMcpServer(): McpServer;
+export declare function runIptvDoctorMcpServer(): Promise<void>;
+//# sourceMappingURL=mcp.d.ts.map

package/dist/mcp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../src/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKpE,eAAO,MAAM,qBAAqB,mFAAoF,CAAC;AAEvH,wBAAgB,yBAAyB,IAAI,SAAS,CAuDrD;AAED,wBAAsB,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC,CAG5D"}

package/dist/mcp.js

@@ -0,0 +1,49 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { generateXMLTV } from "@bjia666/match2epg";
+import { getWorldCup2026Dataset } from "iptv-sports-data";
+export const IPTV_DOCTOR_MCP_TOOLS = ["list_worldcup_matches", "us_legal_viewing_paths", "generate_us_xmltv"];
+export function createIptvDoctorMcpServer() {
+    const dataset = getWorldCup2026Dataset();
+    const server = new McpServer({
+        name: "iptv-doctor",
+        version: "0.1.0"
+    });
+    server.registerTool("list_worldcup_matches", {
+        description: "List sample FIFA World Cup 2026 matches from the local metadata dataset."
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: dataset.fixtures
+                    .map((fixture) => `${fixture.id}: ${fixture.homeTeam} vs ${fixture.awayTeam} at ${fixture.kickoffUtc} (${fixture.status})`)
+                    .join("\n")
+            }
+        ]
+    }));
+    server.registerTool("us_legal_viewing_paths", {
+        description: "Return US legal viewing metadata stored by this project."
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify(dataset.broadcasters.US?.channels ?? [], null, 2)
+            }
+        ]
+    }));
+    server.registerTool("generate_us_xmltv", {
+        description: "Generate XMLTV metadata for the US World Cup channel mapping."
+    }, async () => ({
+        content: [
+            {
+                type: "text",
+                text: generateXMLTV(dataset, "US")
+            }
+        ]
+    }));
+    return server;
+}
+export async function runIptvDoctorMcpServer() {
+    const server = createIptvDoctorMcpServer();
+    await server.connect(new StdioServerTransport());
+}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "iptv-doctor",
+  "version": "0.1.0",
+  "private": false,
+  "type": "module",
+  "bin": {
+    "iptv-doctor": "./bin/iptv-doctor.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "README.md",
+    "package.json"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.18.0",
+    "iptv-doctor-core": "0.1.0",
+    "@bjia666/match2epg": "0.1.0",
+    "iptv-sports-data": "0.1.0"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "doctor": "node --conditions=source --import tsx ./src/cli.ts"
+  }
+}