npm - @tacone/prosey - Versions diffs - 0.8.1 → 0.9.1 - Mend

@tacone/prosey 0.8.1 → 0.9.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (6) hide show

package/bin/prosey +75 -10
package/package.json +1 -1
package/src/channel-description.test.ts +50 -0
package/src/channel-description.ts +22 -0
package/src/html.ts +29 -6
package/src/index.ts +41 -2

package/bin/prosey CHANGED Viewed

@@ -103177,14 +103177,21 @@ var LOGO_DATA_URI = `data:image/svg+xml;charset=utf-8,${encodeURIComponent(LOGO_
 function escapeHtml(text) {
   return text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
-function watchMetaHtml(duration, wordCount, videoId) {
+function watchMetaHtml(duration, wordCount, videoId, channelName, channelId, channelDescription) {
+  const sep = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
   const h2 = Math.floor(duration / 3600);
   const m3 = Math.round(duration % 3600 / 60);
   const durStr = h2 > 0 ? `${h2} h ${m3} min` : `${m3} min`;
   const readTime = Math.ceil(wordCount / 200);
-  const url = `https://youtube.com/watch?v=${videoId}`;
-  const separator = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
-  return `<a href="${url}" class="watch-link">${durStr} watch</a> ${separator} ${readTime} min read`;
+  const watchUrl = `https://youtube.com/watch?v=${videoId}`;
+  let parts = "";
+  if (channelName) {
+    const chUrl = channelId ? `https://youtube.com/channel/${channelId}` : `https://youtube.com/@${encodeURIComponent(channelName)}`;
+    const chDesc = channelDescription || channelName;
+    parts += `<a href="${chUrl}" class="watch-link" title="${escapeHtml(chDesc)}">${escapeHtml(channelName)}</a>${sep}`;
+  }
+  parts += `<a href="${watchUrl}" class="watch-link">${durStr} watch</a>${sep}${readTime} min read`;
+  return parts;
 }
 async function generateHtml(markdown, title, watchMeta) {
   const [css, body] = await Promise.all([getPicoCss(), g2.parse(markdown)]);
@@ -103275,7 +103282,7 @@ img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { fil
 <body>
 <div style="display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem 0">
 <img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top;flex-shrink:0">
-<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId) : ""}</div>
+<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId, watchMeta.channelName, watchMeta.channelId, watchMeta.channelDescription) : ""}</div>
 <button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s;flex-shrink:0">\uD83D\uDCA1</button>
 </div>
 <main class="content">
@@ -103310,10 +103317,30 @@ function openInBrowser(htmlPath) {
     setTimeout(() => resolve(), 5000);
   });
 }
+// src/channel-description.ts
+async function fetchChannelDescription(channelId) {
+  try {
+    const resp = await fetch(`https://www.youtube.com/youtubei/v1/browse`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        context: {
+          client: { clientName: "WEB", clientVersion: "2.20240101.00.00" }
+        },
+        browseId: channelId
+      })
+    });
+    const data = await resp.json();
+    return data?.metadata?.channelMetadataRenderer?.description;
+  } catch {
+    return;
+  }
+}
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.8.1",
+  version: "0.9.1",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -122340,15 +122367,23 @@ try {
     let structuredContent;
     let videoTitle;
     let videoDuration = 0;
+    let channelName;
+    let channelId;
+    let channelDescription;
     if (!segments2) {
       info("Fetching transcript...");
       const opts = lang ? { lang, videoDetails: true } : { videoDetails: true };
       const result = await fetchTranscript(videoId, opts);
       segments2 = result.segments;
       videoDuration = result.videoDetails.lengthSeconds;
+      channelName = result.videoDetails.author;
+      channelId = result.videoDetails.channelId;
+      channelDescription = await fetchChannelDescription(channelId);
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
-        channel: result.videoDetails.author,
+        channel: channelName,
+        channelId,
+        channelDescription,
         description: result.videoDetails.description,
         duration: videoDuration
       });
@@ -122385,9 +122420,14 @@ ${structuredContent}
         const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
         const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
         videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        channelName = fallbackResult.videoDetails.author;
+        channelId = fallbackResult.videoDetails.channelId;
+        channelDescription = await fetchChannelDescription(channelId);
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
+          channelId,
+          channelDescription,
           description: fallbackResult.videoDetails.description,
           duration: videoDuration
         });
@@ -122403,6 +122443,9 @@ ${structuredContent}
       const cachedInfoObj = JSON.parse(cachedInfo);
       videoTitle = cachedInfoObj.title;
       videoDuration = cachedInfoObj.duration ?? 0;
+      channelName = cachedInfoObj.channel;
+      channelId = cachedInfoObj.channelId;
+      channelDescription = cachedInfoObj.channelDescription;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -122439,7 +122482,10 @@ ${structuredContent}
       const htmlContent = await generateHtml(formatted, videoTitle, {
         videoId,
         duration: videoDuration,
-        wordCount
+        wordCount,
+        channelName,
+        channelId,
+        channelDescription
       });
       const htmlPath = join5(dir2, "summary.html");
       await writeFile3(htmlPath, htmlContent, "utf8");
@@ -122473,6 +122519,9 @@ ${structuredContent}
     let md = null;
     let videoTitle;
     let videoDuration = 0;
+    let channelName;
+    let channelId;
+    let channelDescription;
     startTimer();
     let cachedInfo = null;
     if (!noCache) {
@@ -122501,9 +122550,14 @@ ${structuredContent}
       const result = await fetchTranscript(videoId, opts);
       segments2 = result.segments;
       videoDuration = result.videoDetails.lengthSeconds;
+      channelName = result.videoDetails.author;
+      channelId = result.videoDetails.channelId;
+      channelDescription = await fetchChannelDescription(channelId);
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
-        channel: result.videoDetails.author,
+        channel: channelName,
+        channelId,
+        channelDescription,
         description: result.videoDetails.description,
         duration: videoDuration
       });
@@ -122555,9 +122609,14 @@ ${structuredContent}
         const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
         const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
         videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        channelName = fallbackResult.videoDetails.author;
+        channelId = fallbackResult.videoDetails.channelId;
+        channelDescription = await fetchChannelDescription(channelId);
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
+          channelId,
+          channelDescription,
           description: fallbackResult.videoDetails.description,
           duration: videoDuration
         });
@@ -122573,6 +122632,9 @@ ${structuredContent}
       const cachedInfoObj = JSON.parse(cachedInfo);
       videoTitle = cachedInfoObj.title;
       videoDuration = cachedInfoObj.duration ?? 0;
+      channelName = cachedInfoObj.channel;
+      channelId = cachedInfoObj.channelId;
+      channelDescription = cachedInfoObj.channelDescription;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -122605,7 +122667,10 @@ ${transcriptText}`;
       const htmlContent = await generateHtml(formatted, videoTitle, {
         videoId,
         duration: videoDuration,
-        wordCount
+        wordCount,
+        channelName,
+        channelId,
+        channelDescription
       });
       const htmlPath = join5(dir2, "transcript.html");
       await writeFile3(htmlPath, htmlContent, "utf8");

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@tacone/prosey",
-  "version": "0.8.1",
+  "version": "0.9.1",
   "description": "Download YouTube video transcripts from the CLI",
   "module": "src/index.ts",
   "type": "module",

package/src/channel-description.test.ts ADDED Viewed

@@ -0,0 +1,50 @@
+import { describe, expect, test, mock } from "bun:test";
+import { fetchChannelDescription } from "./channel-description";
+function mockFetchResponse(data: unknown): void {
+  globalThis.fetch = mock(() =>
+    Promise.resolve({
+      ok: true,
+      json: () => Promise.resolve(data),
+    }),
+  ) as unknown as typeof fetch;
+}
+describe("fetchChannelDescription", () => {
+  test("calls the browse endpoint without an API key", async () => {
+    let capturedUrl = "";
+    let capturedInit: RequestInit | undefined;
+    globalThis.fetch = ((url: any, init: any) => {
+      capturedUrl = String(url);
+      capturedInit = init;
+      return Promise.resolve({
+        ok: true,
+        json: () =>
+          Promise.resolve({
+            metadata: {
+              channelMetadataRenderer: { description: "Channel bio" },
+            },
+          }),
+      });
+    }) as unknown as typeof fetch;
+    const desc = await fetchChannelDescription("UC123");
+    expect(desc).toBe("Channel bio");
+    expect(capturedUrl).toBe("https://www.youtube.com/youtubei/v1/browse");
+    expect(capturedUrl).not.toContain("key=");
+    expect(capturedInit!.method).toBe("POST");
+    const body = JSON.parse(String(capturedInit!.body));
+    expect(body.browseId).toBe("UC123");
+  });
+  test("returns undefined when response has no description", async () => {
+    mockFetchResponse({ metadata: {} });
+    expect(await fetchChannelDescription("UC123")).toBeUndefined();
+  });
+  test("returns undefined on network error", async () => {
+    globalThis.fetch = mock(() => Promise.reject(new Error("boom"))) as unknown as typeof fetch;
+    expect(await fetchChannelDescription("UC123")).toBeUndefined();
+  });
+});

package/src/channel-description.ts ADDED Viewed

@@ -0,0 +1,22 @@
+export interface ChannelDescriptionResult {
+  description?: string;
+}
+export async function fetchChannelDescription(channelId: string): Promise<string | undefined> {
+  try {
+    const resp = await fetch(`https://www.youtube.com/youtubei/v1/browse`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({
+        context: {
+          client: { clientName: "WEB", clientVersion: "2.20240101.00.00" },
+        },
+        browseId: channelId,
+      }),
+    });
+    const data: ChannelDescriptionResult = (await resp.json()) as ChannelDescriptionResult;
+    return (data as any)?.metadata?.channelMetadataRenderer?.description;
+  } catch {
+    return undefined;
+  }
+}

package/src/html.ts CHANGED Viewed

@@ -34,20 +34,43 @@ function escapeHtml(text: string): string {
     .replace(/"/g, "&quot;");
 }
-function watchMetaHtml(duration: number, wordCount: number, videoId: string): string {
+function watchMetaHtml(
+  duration: number,
+  wordCount: number,
+  videoId: string,
+  channelName?: string,
+  channelId?: string,
+  channelDescription?: string,
+): string {
+  const sep = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
   const h = Math.floor(duration / 3600);
   const m = Math.round((duration % 3600) / 60);
   const durStr = h > 0 ? `${h} h ${m} min` : `${m} min`;
   const readTime = Math.ceil(wordCount / 200);
-  const url = `https://youtube.com/watch?v=${videoId}`;
-  const separator = '<span style="opacity: 0.4">&nbsp;&nbsp;|&nbsp;&nbsp;</span>';
-  return `<a href="${url}" class="watch-link">${durStr} watch</a> ${separator} ${readTime} min read`;
+  const watchUrl = `https://youtube.com/watch?v=${videoId}`;
+  let parts = "";
+  if (channelName) {
+    const chUrl = channelId
+      ? `https://youtube.com/channel/${channelId}`
+      : `https://youtube.com/@${encodeURIComponent(channelName)}`;
+    const chDesc = channelDescription || channelName;
+    parts += `<a href="${chUrl}" class="watch-link" title="${escapeHtml(chDesc)}">${escapeHtml(channelName)}</a>${sep}`;
+  }
+  parts += `<a href="${watchUrl}" class="watch-link">${durStr} watch</a>${sep}${readTime} min read`;
+  return parts;
 }
 export async function generateHtml(
   markdown: string,
   title?: string,
-  watchMeta?: { videoId: string; duration: number; wordCount: number },
+  watchMeta?: {
+    videoId: string;
+    duration: number;
+    wordCount: number;
+    channelName?: string;
+    channelId?: string;
+    channelDescription?: string;
+  },
 ): Promise<string> {
   const [css, body] = await Promise.all([getPicoCss(), marked.parse(markdown)]);
@@ -138,7 +161,7 @@ img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { fil
 <body>
 <div style="display:flex;align-items:center;justify-content:space-between;padding:1rem 1rem 0">
 <img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top;flex-shrink:0">
-<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId) : ""}</div>
+<div style="flex:1;text-align:center;font-size:.85rem;color:var(--pico-muted-color)">${watchMeta ? watchMetaHtml(watchMeta.duration, watchMeta.wordCount, watchMeta.videoId, watchMeta.channelName, watchMeta.channelId, watchMeta.channelDescription) : ""}</div>
 <button id="theme-btn" type="button" style="background:none;border:none;cursor:pointer;padding:0;line-height:1;opacity:.5;filter:grayscale(100%);transition:all 0.3s;flex-shrink:0">💡</button>
 </div>
 <main class="content">

package/src/index.ts CHANGED Viewed

@@ -21,6 +21,7 @@ import {
 import { cacheDir, readCache, writeCache, extractVideoId } from "./cache";
 import { extractChapters, formatChaptersAsText, formatChaptersAsJson } from "./extract-chapters";
 import { generateHtml, openInBrowser } from "./html";
+import { fetchChannelDescription } from "./channel-description";
 import { checkVersion } from "./version-check";
 import pkg from "../package.json";
 import prettier from "prettier";
@@ -484,6 +485,9 @@ try {
     let structuredContent: string;
     let videoTitle: string | undefined;
     let videoDuration = 0;
+    let channelName: string | undefined;
+    let channelId: string | undefined;
+    let channelDescription: string | undefined;
     if (!segments) {
       info("Fetching transcript...");
@@ -494,9 +498,14 @@ try {
       };
       segments = result.segments;
       videoDuration = result.videoDetails.lengthSeconds;
+      channelName = result.videoDetails.author;
+      channelId = result.videoDetails.channelId;
+      channelDescription = await fetchChannelDescription(channelId);
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
-        channel: result.videoDetails.author,
+        channel: channelName,
+        channelId: channelId,
+        channelDescription: channelDescription,
         description: result.videoDetails.description,
         duration: videoDuration,
       });
@@ -533,9 +542,14 @@ try {
           segments: TranscriptSegment[];
         };
         videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        channelName = fallbackResult.videoDetails.author;
+        channelId = fallbackResult.videoDetails.channelId;
+        channelDescription = await fetchChannelDescription(channelId);
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
+          channelId: channelId,
+          channelDescription: channelDescription,
           description: fallbackResult.videoDetails.description,
           duration: videoDuration,
         });
@@ -553,6 +567,9 @@ try {
       const cachedInfoObj = JSON.parse(cachedInfo);
       videoTitle = cachedInfoObj.title;
       videoDuration = cachedInfoObj.duration ?? 0;
+      channelName = cachedInfoObj.channel;
+      channelId = cachedInfoObj.channelId;
+      channelDescription = cachedInfoObj.channelDescription;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -586,6 +603,9 @@ try {
         videoId,
         duration: videoDuration,
         wordCount,
+        channelName,
+        channelId,
+        channelDescription,
       });
       const htmlPath = join(dir, "summary.html");
       await writeFile(htmlPath, htmlContent, "utf8");
@@ -622,6 +642,9 @@ try {
     let md: string | null = null;
     let videoTitle: string | undefined;
     let videoDuration = 0;
+    let channelName: string | undefined;
+    let channelId: string | undefined;
+    let channelDescription: string | undefined;
     startTimer();
@@ -660,9 +683,14 @@ try {
       };
       segments = result.segments;
       videoDuration = result.videoDetails.lengthSeconds;
+      channelName = result.videoDetails.author;
+      channelId = result.videoDetails.channelId;
+      channelDescription = await fetchChannelDescription(channelId);
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
-        channel: result.videoDetails.author,
+        channel: channelName,
+        channelId: channelId,
+        channelDescription: channelDescription,
         description: result.videoDetails.description,
         duration: videoDuration,
       });
@@ -712,9 +740,14 @@ try {
           segments: TranscriptSegment[];
         };
         videoDuration = fallbackResult.videoDetails.lengthSeconds;
+        channelName = fallbackResult.videoDetails.author;
+        channelId = fallbackResult.videoDetails.channelId;
+        channelDescription = await fetchChannelDescription(channelId);
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
+          channelId: channelId,
+          channelDescription: channelDescription,
           description: fallbackResult.videoDetails.description,
           duration: videoDuration,
         });
@@ -732,6 +765,9 @@ try {
       const cachedInfoObj = JSON.parse(cachedInfo);
       videoTitle = cachedInfoObj.title;
       videoDuration = cachedInfoObj.duration ?? 0;
+      channelName = cachedInfoObj.channel;
+      channelId = cachedInfoObj.channelId;
+      channelDescription = cachedInfoObj.channelDescription;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -760,6 +796,9 @@ try {
         videoId,
         duration: videoDuration,
         wordCount,
+        channelName,
+        channelId,
+        channelDescription,
       });
       const htmlPath = join(dir, "transcript.html");
       await writeFile(htmlPath, htmlContent, "utf8");