roku-mcp 1.5.2 → 1.7.0

package/dist/stream/charles.js

@@ -0,0 +1,268 @@
+/**
+ * Parse a Charles Proxy session (or HAR capture) into normalized HTTP entries
+ * and classify each request as manifest / segment / license / key / other.
+ *
+ * Supported export formats:
+ *   - Charles ".chlsj" (JSON Session File): either a single JSON array of
+ *     request objects, or newline-delimited JSON (one object per line).
+ *   - ".har" (HTTP Archive): the standard `{ log: { entries: [...] } }` shape
+ *     produced by Charles "Export > HAR" and by browser devtools.
+ *
+ * NOTE: the binary ".chls" format is NOT supported (it is a proprietary binary
+ * blob). Callers should instruct the user to export as ".chlsj" or ".har".
+ *
+ * Charles .chlsj entry shape (varies slightly by version) roughly looks like:
+ *   {
+ *     "host": "...", "method": "GET", "path": "/x.m3u8",
+ *     "scheme": "https", "status": 200,
+ *     "request":  { "header": { "headers": [{ "name", "value" }] }, "body": {...} },
+ *     "response": { "header": { "headers": [...] }, "body": { "text"|"encoded", "contentType" } },
+ *     "times": { "totalDuration": 123 }
+ *   }
+ */
+function lowerHeaderMap(headers) {
+    const out = {};
+    if (!Array.isArray(headers))
+        return out;
+    for (const h of headers) {
+        if (h && typeof h.name === 'string') {
+            out[h.name.toLowerCase()] = typeof h.value === 'string' ? h.value : String(h.value ?? '');
+        }
+    }
+    return out;
+}
+function classify(url, method, mimeType, reqHeaders) {
+    const path = url.split('?')[0].toLowerCase();
+    const mime = (mimeType ?? '').toLowerCase();
+    if (path.endsWith('.m3u8') || path.endsWith('.mpd') || path.endsWith('.m3u') ||
+        mime.includes('mpegurl') || mime.includes('dash+xml')) {
+        return 'manifest';
+    }
+    if (path.endsWith('.ts') || path.endsWith('.m4s') || path.endsWith('.mp4') ||
+        path.endsWith('.cmfv') || path.endsWith('.cmfa') || path.endsWith('.cmft') ||
+        path.endsWith('.aac') || path.endsWith('.m4a') || path.endsWith('.m4v') ||
+        mime.includes('video/') || mime.includes('audio/') || mime.includes('iso.segment')) {
+        return 'segment';
+    }
+    if (path.endsWith('.key') || mime.includes('pskc+xml')) {
+        return 'key';
+    }
+    // License requests: typically POST to a DRM endpoint, often octet-stream or json.
+    const accept = (reqHeaders['accept'] ?? '').toLowerCase();
+    const ct = (reqHeaders['content-type'] ?? '').toLowerCase();
+    if (method.toUpperCase() === 'POST' &&
+        (path.includes('license') || path.includes('licence') || path.includes('widevine') ||
+            path.includes('playready') || path.includes('drm') || path.includes('wv/') ||
+            path.includes('/cenc') || ct.includes('octet-stream') || accept.includes('octet-stream'))) {
+        return 'license';
+    }
+    if (path.includes('license') || path.includes('widevine') || path.includes('playready') || path.includes('/drm')) {
+        return 'license';
+    }
+    return 'other';
+}
+function decodeBody(body) {
+    if (!body || typeof body !== 'object')
+        return {};
+    const contentType = typeof body.contentType === 'string' ? body.contentType.toLowerCase() :
+        typeof body.mimeType === 'string' ? body.mimeType.toLowerCase() : undefined;
+    // Charles uses `text` (plain), or `encoded` (base64) with `encoding: "base64"`.
+    if (typeof body.text === 'string') {
+        if ((body.encoding ?? '').toLowerCase() === 'base64') {
+            try {
+                return { text: Buffer.from(body.text, 'base64').toString('utf-8'), mimeType: contentType };
+            }
+            catch {
+                return { mimeType: contentType };
+            }
+        }
+        return { text: body.text, mimeType: contentType };
+    }
+    if (typeof body.encoded === 'string') {
+        try {
+            return { text: Buffer.from(body.encoded, 'base64').toString('utf-8'), mimeType: contentType };
+        }
+        catch {
+            return { mimeType: contentType };
+        }
+    }
+    return { mimeType: contentType };
+}
+/** Normalize one Charles .chlsj entry. */
+function normalizeChlsjEntry(raw) {
+    if (!raw || typeof raw !== 'object')
+        return undefined;
+    const scheme = raw.scheme ?? raw.protocol ?? 'https';
+    const host = raw.host ?? raw.remoteHost ?? '';
+    const path = raw.path ?? raw.query ? `${raw.path ?? ''}${raw.query ? '?' + raw.query : ''}` : raw.path ?? '/';
+    const explicitUrl = typeof raw.url === 'string' ? raw.url : undefined;
+    const url = explicitUrl ?? (host ? `${scheme}://${host}${path.startsWith('/') ? '' : '/'}${path}` : path);
+    const method = (raw.method ?? 'GET').toUpperCase();
+    const status = Number(raw.status ?? raw.responseCode ?? raw.response?.status ?? 0) || 0;
+    const reqHeaders = lowerHeaderMap(raw.request?.header?.headers ?? raw.request?.headers);
+    const respHeaders = lowerHeaderMap(raw.response?.header?.headers ?? raw.response?.headers);
+    const decoded = decodeBody(raw.response?.body);
+    const mimeType = decoded.mimeType ?? respHeaders['content-type']?.split(';')[0]?.toLowerCase();
+    const durationMs = typeof raw.times?.totalDuration === 'number' ? raw.times.totalDuration :
+        typeof raw.totalDuration === 'number' ? raw.totalDuration : undefined;
+    const kind = classify(url, method, mimeType, reqHeaders);
+    return {
+        url,
+        host: host || safeHost(url),
+        path: path || new URLSafe(url).pathname,
+        method,
+        status,
+        reqHeaders,
+        respHeaders,
+        respBody: decoded.text,
+        mimeType,
+        durationMs,
+        kind,
+    };
+}
+/** Normalize one HAR entry. */
+function normalizeHarEntry(raw) {
+    if (!raw || typeof raw !== 'object' || !raw.request)
+        return undefined;
+    const url = raw.request.url ?? '';
+    const method = (raw.request.method ?? 'GET').toUpperCase();
+    const status = Number(raw.response?.status ?? 0) || 0;
+    const reqHeaders = lowerHeaderMap(raw.request.headers);
+    const respHeaders = lowerHeaderMap(raw.response?.headers);
+    const harContent = raw.response?.content;
+    let respBody;
+    let mimeType = harContent?.mimeType?.split(';')[0]?.toLowerCase();
+    if (harContent && typeof harContent.text === 'string') {
+        if ((harContent.encoding ?? '').toLowerCase() === 'base64') {
+            try {
+                respBody = Buffer.from(harContent.text, 'base64').toString('utf-8');
+            }
+            catch { /* ignore */ }
+        }
+        else {
+            respBody = harContent.text;
+        }
+    }
+    if (!mimeType)
+        mimeType = respHeaders['content-type']?.split(';')[0]?.toLowerCase();
+    const durationMs = typeof raw.time === 'number' ? raw.time : undefined;
+    const kind = classify(url, method, mimeType, reqHeaders);
+    return {
+        url,
+        host: safeHost(url),
+        path: new URLSafe(url).pathname,
+        method,
+        status,
+        reqHeaders,
+        respHeaders,
+        respBody,
+        mimeType,
+        durationMs,
+        kind,
+    };
+}
+/** A tiny URL helper that never throws on malformed input. */
+class URLSafe {
+    pathname = '/';
+    host = '';
+    constructor(url) {
+        try {
+            const u = new URL(url);
+            this.pathname = u.pathname;
+            this.host = u.host;
+        }
+        catch {
+            const m = /^[a-z]+:\/\/([^/]+)(\/[^?#]*)?/i.exec(url);
+            if (m) {
+                this.host = m[1];
+                this.pathname = m[2] ?? '/';
+            }
+        }
+    }
+}
+function safeHost(url) {
+    return new URLSafe(url).host;
+}
+/** Parse the raw text of a Charles .chlsj or .har file. */
+export function parseCharlesText(text) {
+    const notes = [];
+    const trimmed = text.trimStart();
+    // HAR detection.
+    if (trimmed.startsWith('{')) {
+        try {
+            const obj = JSON.parse(text);
+            if (obj && obj.log && Array.isArray(obj.log.entries)) {
+                const entries = obj.log.entries
+                    .map(normalizeHarEntry)
+                    .filter((e) => !!e);
+                return finalize(entries, 'har', notes);
+            }
+            // A single .chlsj object (rare) — treat as a one-element array.
+            const one = normalizeChlsjEntry(obj);
+            if (one)
+                return finalize([one], 'chlsj', notes);
+        }
+        catch {
+            /* fall through to line-delimited parsing */
+        }
+    }
+    // .chlsj as a JSON array.
+    if (trimmed.startsWith('[')) {
+        try {
+            const arr = JSON.parse(text);
+            if (Array.isArray(arr)) {
+                const entries = arr
+                    .map(normalizeChlsjEntry)
+                    .filter((e) => !!e);
+                return finalize(entries, 'chlsj', notes);
+            }
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    // Newline-delimited JSON objects (one Charles record per line).
+    const lineEntries = [];
+    let parsedAny = false;
+    for (const line of text.split(/\r?\n/)) {
+        const t = line.trim().replace(/,$/, '');
+        if (t === '' || t === '[' || t === ']')
+            continue;
+        try {
+            const obj = JSON.parse(t);
+            const norm = normalizeChlsjEntry(obj);
+            if (norm) {
+                lineEntries.push(norm);
+                parsedAny = true;
+            }
+        }
+        catch {
+            /* skip non-JSON lines */
+        }
+    }
+    if (parsedAny) {
+        notes.push('Parsed as newline-delimited JSON (one record per line).');
+        return finalize(lineEntries, 'chlsj', notes);
+    }
+    throw new Error('Could not parse the Charles session. Export it from Charles as a "JSON Session File" (.chlsj) or HAR (.har). ' +
+        'Binary ".chls" files are not supported.');
+}
+function finalize(entries, format, notes) {
+    const failing = entries.filter(isFailing);
+    if (entries.length === 0)
+        notes.push('No HTTP entries were found in the session.');
+    return { entries, failing, format, notes };
+}
+/** A request is "failing" if it has a non-2xx status, or an empty body where one is expected. */
+export function isFailing(entry) {
+    if (entry.status === 0)
+        return false; // unknown — don't flag
+    if (entry.status >= 400)
+        return true;
+    if (entry.status >= 300 && entry.status < 400) {
+        // Redirects on license/manifest are a common Roku gotcha.
+        return entry.kind === 'license' || entry.kind === 'manifest';
+    }
+    return false;
+}
+//# sourceMappingURL=charles.js.map

package/dist/stream/charles.js.map

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

package/dist/stream/diagnose.d.ts

@@ -0,0 +1,54 @@
+/**
+ * The correlation engine.
+ *
+ * Given any combination of three evidence sources —
+ *   1. the device error (Video node errorCode/errorInfo), and/or
+ *   2. the parsed manifest (codecs/container/DRM/segments), and/or
+ *   3. the HTTP traffic from a Charles/HAR session —
+ * produce ranked, plain-English root-cause findings, each with the evidence it
+ * relied on, a confidence level, a suggested fix, and a doc link.
+ *
+ * Confidence rises when sources agree. For example, `errorCode -6` (DRM)
+ * corroborated by a license POST returning 403 in the Charles session is a
+ * high-confidence diagnosis; a manifest-only hint ("declares Opus audio") is
+ * low confidence because the device might still play it.
+ */
+import type { NormalizedRokuError } from './error-info.js';
+import type { ManifestSummary } from './manifest.js';
+import type { CharlesSession } from './charles.js';
+export type Confidence = 'high' | 'medium' | 'low';
+/**
+ * How badly the issue breaks playback:
+ *  - 'blocking'  : the stream will not play at all (decoder/network/DRM/empty).
+ *  - 'degraded'  : the stream plays but is impaired (e.g. silent audio).
+ *  - 'advisory'  : a hint that may or may not matter (segment length, signaling).
+ */
+export type Severity = 'blocking' | 'degraded' | 'advisory';
+export interface Finding {
+    id: string;
+    cause: string;
+    /** Verbatim evidence strings that support this finding. */
+    evidence: string[];
+    confidence: Confidence;
+    /** Playback impact, used to rank a won't-play issue above a plays-but-silent one. */
+    severity: Severity;
+    fix: string;
+    docUrl: string;
+}
+export interface DiagnosisInput {
+    error?: NormalizedRokuError;
+    manifest?: ManifestSummary;
+    charles?: CharlesSession;
+    /** DRM hint the developer told us they configured. */
+    declaredDrm?: {
+        keySystem?: string;
+    };
+}
+export interface Diagnosis {
+    verdict: string;
+    findings: Finding[];
+    specVersion: string;
+    specDisclaimer: string;
+}
+export declare function diagnose(input: DiagnosisInput): Diagnosis;
+//# sourceMappingURL=diagnose.d.ts.map

package/dist/stream/diagnose.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnose.d.ts","sourceRoot":"","sources":["../../src/stream/diagnose.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAuB,MAAM,cAAc,CAAC;AA6CxE,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;AAEnD;;;;;GAKG;AACH,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAE5D,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,qFAAqF;IACrF,QAAQ,EAAE,QAAQ,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,mBAAmB,CAAC;IAC5B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,sDAAsD;IACtD,WAAW,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACtC;AAED,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;CACxB;AAmgBD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAwBzD"}