npm - @tacone/prosey - Versions diffs - 0.6.0 → 0.7.0 - Mend

@tacone/prosey 0.6.0 → 0.7.0

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 (8) hide show

package/bin/prosey CHANGED Viewed

@@ -101600,46 +101600,6 @@ var lt = (r) => {
 };
 // src/config.ts
-var FALLBACK_CONFIG_TOML = `# Default prosey configuration
-# Created automatically on first run. Edit as needed.
-# Pager command for transcript and summary output.
-# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
-# Set to a custom command (e.g. "less -R") to override.
-# Can also be set via the PROSEY_PAGER env var (takes precedence).
-pager = "auto"
-# Show hints for missing tools (e.g. markdown highlighter).
-# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
-hints = true
-[ai]
-# Default command for AI operations (summarize, transcribe).
-# Can be overridden per-section via the command key below.
-command = "opencode run"
-[summarize]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are summarized.
-prompt = """
-Write a comprehensive summary of the following transcription.
-"""
-# Command override for summarize. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-[transcribe]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are formatted as markdown.
-prompt = """
-Convert this transcript to clean, readable markdown.
-"""
-# Command override for transcribe. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-`;
 async function readDefaultConfig() {
   const paths = [
     join(dirname(fileURLToPath(import.meta.url)), "default-config.toml"),
@@ -101649,7 +101609,7 @@ async function readDefaultConfig() {
     if (existsSync(p2))
       return readFile(p2, "utf8");
   }
-  return FALLBACK_CONFIG_TOML;
+  throw new Error("default-config.toml not found");
 }
 function configDir() {
   const env = process.env.XDG_CONFIG_HOME;
@@ -103188,14 +103148,23 @@ 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;");
 }
-async function generateHtml(markdown, title) {
+function watchMetaHtml(duration, wordCount, videoId) {
+  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`;
+}
+async function generateHtml(markdown, title, watchMeta) {
   const [css, body] = await Promise.all([getPicoCss(), g2.parse(markdown)]);
   return `<!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${escapeHtml(title ?? "Prosey")}</title>
+<title>${title ? escapeHtml(title) + " - Prosey" : "Prosey"}</title>
 <script>(function(){var m=localStorage.getItem('prosey-theme'),t=m||'auto';if(t==='auto')t=window.matchMedia('(prefers-color-scheme:dark)').matches?'dark':'light';document.documentElement.setAttribute('data-theme',t);if(!m)localStorage.setItem('prosey-theme','auto')})();</script>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -103249,14 +103218,17 @@ blockquote:last-child { margin-bottom: 0; }
 #theme-btn:hover, #theme-btn:focus, #theme-btn:active { opacity: 1 !important; }
 img[alt="Prosey"] { filter: grayscale(100%); }
 img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { filter: grayscale(0%); }
+.watch-link { color: inherit; text-decoration: none; }
+.watch-link:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
-<div style="display:flex;justify-content:space-between;align-items:flex-start;padding:1rem 1rem 0">
-<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top">
-<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">\uD83D\uDCA1</button>
+<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>
+<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 style="max-width:720px;margin:0 auto;padding:1rem">
+<main style="max-width:50em;margin:0 auto;padding:1rem">
 ${body}
 </main>
 <script>
@@ -103291,7 +103263,7 @@ function openInBrowser(htmlPath) {
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.6.0",
+  version: "0.7.0",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -122307,18 +122279,23 @@ try {
       exitProcess(1);
     }
     let structuredContent;
+    let videoTitle;
+    let videoDuration = 0;
     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;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
-        description: result.videoDetails.description
+        description: result.videoDetails.description,
+        duration: videoDuration
       });
       cachedInfo = infoJson;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
+      videoTitle = result.videoDetails.title;
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
@@ -122348,10 +122325,12 @@ ${structuredContent}
         debug("Cache missing info.json, re-fetching video details");
         const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
         const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
-          description: fallbackResult.videoDetails.description
+          description: fallbackResult.videoDetails.description,
+          duration: videoDuration
         });
         await writeCache(dir2, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(extractChapters(fallbackResult.videoDetails.description));
@@ -122363,6 +122342,8 @@ ${structuredContent}
       }
       const transcriptText = toText(segments2, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -122395,7 +122376,12 @@ ${structuredContent}
     }
     const formatted = noFormat ? summary : await formatMd(summary);
     if (format3 === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = summary.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount
+      });
       const htmlPath = join5(dir2, "summary.html");
       await writeFile3(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);
@@ -122426,6 +122412,8 @@ ${structuredContent}
     const dir2 = cacheDir(videoId, cacheOpts2);
     let segments2 = null;
     let md = null;
+    let videoTitle;
+    let videoDuration = 0;
     startTimer();
     let cachedInfo = null;
     if (!noCache) {
@@ -122453,12 +122441,15 @@ ${structuredContent}
       const opts = lang ? { lang, videoDetails: true } : { videoDetails: true };
       const result = await fetchTranscript(videoId, opts);
       segments2 = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
-        description: result.videoDetails.description
+        description: result.videoDetails.description,
+        duration: videoDuration
       });
       cachedInfo = infoJson;
+      videoTitle = result.videoDetails.title;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
@@ -122504,10 +122495,12 @@ ${structuredContent}
         debug("Cache missing info.json, re-fetching video details");
         const fallbackOpts = lang ? { lang, videoDetails: true } : { videoDetails: true };
         const fallbackResult = await fetchTranscript(videoId, fallbackOpts);
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
-          description: fallbackResult.videoDetails.description
+          description: fallbackResult.videoDetails.description,
+          duration: videoDuration
         });
         await writeCache(dir2, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(extractChapters(fallbackResult.videoDetails.description));
@@ -122519,6 +122512,8 @@ ${structuredContent}
       }
       const transcriptText = toText(segments2, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -122547,7 +122542,12 @@ ${transcriptText}`;
     }
     const formatted = noFormat ? md : await formatMd(md);
     if (format3 === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = md.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount
+      });
       const htmlPath = join5(dir2, "transcript.html");
       await writeFile3(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);

package/package.json CHANGED Viewed

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

package/src/config.ts CHANGED Viewed

@@ -21,47 +21,6 @@ export interface ProseyConfig {
   };
 }
-const FALLBACK_CONFIG_TOML = `# Default prosey configuration
-# Created automatically on first run. Edit as needed.
-# Pager command for transcript and summary output.
-# Defaults to "auto": bat -lmd --style plain → glow -p → mdcat -l -p → less
-# Set to a custom command (e.g. "less -R") to override.
-# Can also be set via the PROSEY_PAGER env var (takes precedence).
-pager = "auto"
-# Show hints for missing tools (e.g. markdown highlighter).
-# Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
-hints = true
-[ai]
-# Default command for AI operations (summarize, transcribe).
-# Can be overridden per-section via the command key below.
-command = "opencode run"
-[summarize]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are summarized.
-prompt = """
-Write a comprehensive summary of the following transcription.
-"""
-# Command override for summarize. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-[transcribe]
-# Prompt sent to the command via stdin.
-# Customize this to change how transcripts are formatted as markdown.
-prompt = """
-Convert this transcript to clean, readable markdown.
-"""
-# Command override for transcribe. Uncomment to use a different command
-# than the one specified in [ai].
-# command = "opencode run"
-`;
 async function readDefaultConfig(): Promise<string> {
   const paths = [
     join(dirname(fileURLToPath(import.meta.url)), "default-config.toml"),
@@ -70,7 +29,7 @@ async function readDefaultConfig(): Promise<string> {
   for (const p of paths) {
     if (existsSync(p)) return readFile(p, "utf8");
   }
-  return FALLBACK_CONFIG_TOML;
+  throw new Error("default-config.toml not found");
 }
 function configDir(): string {

package/src/default-config.toml CHANGED Viewed

@@ -37,6 +37,7 @@ Guidelines:
 - use the TIMESTAMPS only to understand the structure, don't output time markers
 - content length: aim to be the same range as the original text or more.
 - section titles should be h2 headers
+- paragraph length soft-limit. 250 characters
 Content considerations:

package/src/format.ts CHANGED Viewed

@@ -24,6 +24,13 @@ export function formatDuration(seconds: number): string {
   return `${m}:${String(s).padStart(2, "0")}`;
 }
+export function formatReadableDuration(seconds: number): string {
+  const h = Math.floor(seconds / 3600);
+  const m = Math.round((seconds % 3600) / 60);
+  if (h > 0) return `${h}h ${m}min`;
+  return `${m}min`;
+}
 export function decodeEntities(text: string): string {
   return text
     .replace(/&#(\d+);/g, (_, code) => String.fromCharCode(Number(code)))

package/src/html.test.ts CHANGED Viewed

@@ -5,7 +5,7 @@ describe("generateHtml", () => {
   test("wraps markdown in HTML with PicoCSS", async () => {
     const html = await generateHtml("# Hello\n\nWorld", "Test");
     expect(html).toStartWith("<!DOCTYPE html>");
-    expect(html).toContain("<title>Test</title>");
+    expect(html).toContain("<title>Test - Prosey</title>");
     expect(html).toContain("<style>");
     expect(html).toContain("--pico-");
     expect(html).toContain("<h1>Hello</h1>");

package/src/html.ts CHANGED Viewed

@@ -34,7 +34,21 @@ function escapeHtml(text: string): string {
     .replace(/"/g, "&quot;");
 }
-export async function generateHtml(markdown: string, title?: string): Promise<string> {
+function watchMetaHtml(duration: number, wordCount: number, videoId: string): string {
+  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`;
+}
+export async function generateHtml(
+  markdown: string,
+  title?: string,
+  watchMeta?: { videoId: string; duration: number; wordCount: number },
+): Promise<string> {
   const [css, body] = await Promise.all([getPicoCss(), marked.parse(markdown)]);
   return `<!DOCTYPE html>
@@ -42,7 +56,7 @@ export async function generateHtml(markdown: string, title?: string): Promise<st
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
-<title>${escapeHtml(title ?? "Prosey")}</title>
+<title>${title ? escapeHtml(title) + " - Prosey" : "Prosey"}</title>
 <script>(function(){var m=localStorage.getItem('prosey-theme'),t=m||'auto';if(t==='auto')t=window.matchMedia('(prefers-color-scheme:dark)').matches?'dark':'light';document.documentElement.setAttribute('data-theme',t);if(!m)localStorage.setItem('prosey-theme','auto')})();</script>
 <link rel="preconnect" href="https://fonts.googleapis.com">
 <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
@@ -96,14 +110,17 @@ blockquote:last-child { margin-bottom: 0; }
 #theme-btn:hover, #theme-btn:focus, #theme-btn:active { opacity: 1 !important; }
 img[alt="Prosey"] { filter: grayscale(100%); }
 img[alt="Prosey"]:hover, img[alt="Prosey"]:active, img[alt="Prosey"]:focus { filter: grayscale(0%); }
+.watch-link { color: inherit; text-decoration: none; }
+.watch-link:hover { text-decoration: underline; }
 </style>
 </head>
 <body>
-<div style="display:flex;justify-content:space-between;align-items:flex-start;padding:1rem 1rem 0">
-<img src="${LOGO_DATA_URI}" alt="Prosey" title="Prosey" style="vertical-align:top">
-<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">💡</button>
+<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>
+<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 style="max-width:720px;margin:0 auto;padding:1rem">
+<main style="max-width:50em;margin:0 auto;padding:1rem">
 ${body}
 </main>
 <script>

package/src/index.ts CHANGED Viewed

@@ -472,6 +472,8 @@ try {
     }
     let structuredContent: string;
+    let videoTitle: string | undefined;
+    let videoDuration = 0;
     if (!segments) {
       info("Fetching transcript...");
@@ -481,13 +483,16 @@ try {
         segments: TranscriptSegment[];
       };
       segments = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
         description: result.videoDetails.description,
+        duration: videoDuration,
       });
       cachedInfo = infoJson;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
+      videoTitle = result.videoDetails.title;
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
@@ -517,10 +522,12 @@ try {
           videoDetails: VideoDetails;
           segments: TranscriptSegment[];
         };
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
           description: fallbackResult.videoDetails.description,
+          duration: videoDuration,
         });
         await writeCache(dir, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(
@@ -534,6 +541,8 @@ try {
       }
       const transcriptText = toText(segments, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -562,7 +571,12 @@ try {
     const formatted = noFormat ? summary : await formatMd(summary);
     if (format === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = summary!.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount,
+      });
       const htmlPath = join(dir, "summary.html");
       await writeFile(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);
@@ -596,6 +610,8 @@ try {
     const dir = cacheDir(videoId, cacheOpts);
     let segments: TranscriptSegment[] | null = null;
     let md: string | null = null;
+    let videoTitle: string | undefined;
+    let videoDuration = 0;
     startTimer();
@@ -633,12 +649,15 @@ try {
         segments: TranscriptSegment[];
       };
       segments = result.segments;
+      videoDuration = result.videoDetails.lengthSeconds;
       const infoJson = JSON.stringify({
         title: result.videoDetails.title,
         channel: result.videoDetails.author,
         description: result.videoDetails.description,
+        duration: videoDuration,
       });
       cachedInfo = infoJson;
+      videoTitle = result.videoDetails.title;
       const chapterValue = formatChaptersAsJson(extractChapters(result.videoDetails.description));
       const truncatedInfo = JSON.stringify({
         title: result.videoDetails.title,
@@ -682,10 +701,12 @@ try {
           videoDetails: VideoDetails;
           segments: TranscriptSegment[];
         };
+        videoDuration = fallbackResult.videoDetails.lengthSeconds;
         cachedInfo = JSON.stringify({
           title: fallbackResult.videoDetails.title,
           channel: fallbackResult.videoDetails.author,
           description: fallbackResult.videoDetails.description,
+          duration: videoDuration,
         });
         await writeCache(dir, "info.json", cachedInfo);
         chapterValue = formatChaptersAsJson(
@@ -699,6 +720,8 @@ try {
       }
       const transcriptText = toText(segments, !noDecode);
       const cachedInfoObj = JSON.parse(cachedInfo);
+      videoTitle = cachedInfoObj.title;
+      videoDuration = cachedInfoObj.duration ?? 0;
       const truncatedInfo = JSON.stringify({
         title: cachedInfoObj.title,
         channel: cachedInfoObj.channel,
@@ -722,7 +745,12 @@ try {
     const formatted = noFormat ? md : await formatMd(md);
     if (format === "html") {
-      const htmlContent = await generateHtml(formatted);
+      const wordCount = md!.split(/\s+/).filter(Boolean).length;
+      const htmlContent = await generateHtml(formatted, videoTitle, {
+        videoId,
+        duration: videoDuration,
+        wordCount,
+      });
       const htmlPath = join(dir, "transcript.html");
       await writeFile(htmlPath, htmlContent, "utf8");
       debug("HTML written:", htmlPath);