@tacone/prosey 0.9.0 → 0.10.0

package/bin/prosey

@@ -101628,6 +101628,7 @@ function mergeOverDefaults(user, defaults) {
     pager: user.pager ?? defaults.pager,
     hints: user.hints ?? defaults.hints,
     format: user.format ?? defaults.format,
+    dataDir: user.dataDir ?? defaults.dataDir,
     ai: user.ai?.command !== undefined ? user.ai : defaults.ai,
     summarize: {
       command: user.summarize?.command ?? defaults.summarize?.command,
@@ -101639,9 +101640,17 @@ function mergeOverDefaults(user, defaults) {
     }
   };
 }
+function camelizeKeys(obj) {
+  const out = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const camel = key.replace(/_([a-z])/g, (_2, c2) => c2.toUpperCase());
+    out[camel] = value !== null && typeof value === "object" && !Array.isArray(value) ? camelizeKeys(value) : value;
+  }
+  return out;
+}
 async function parseOrEmpty(text) {
   try {
-    return lt(text);
+    return camelizeKeys(lt(text));
   } catch {
     return {};
   }
@@ -101734,6 +101743,7 @@ import { createHash } from "node:crypto";
 import { readFile as readFile2, writeFile as writeFile2, mkdir as mkdir2 } from "node:fs/promises";
 import { existsSync as existsSync2 } from "node:fs";
 import { join as join2 } from "node:path";
+import { homedir as homedir2 } from "node:os";
 var RE_YOUTUBE2 = /(?:v=|\/|v\/|embed\/|watch\?.*v=|youtu\.be\/|\/v\/|e\/|watch\?.*vi?=|\/embed\/|\/v\/|vi?\/|watch\?.*vi?=|youtu\.be\/|\/vi?\/|\/e\/)([a-zA-Z0-9_-]{11})/i;
 var RE_BARE_ID = /^[a-zA-Z0-9_-]{11}$/;
 function extractVideoId(input) {
@@ -101750,8 +101760,19 @@ function hashOptions(opts) {
 function cacheKey(videoId, opts) {
   return `${videoId}_${hashOptions(opts)}`;
 }
-function cacheDir(videoId, opts) {
-  return join2("/tmp", "prosey", cacheKey(videoId, opts));
+function dataDir(configDataDir) {
+  const env = process.env.PROSEY_DATA_PATH;
+  if (env)
+    return env;
+  if (configDataDir)
+    return configDataDir;
+  const xdg = process.env.XDG_DATA_HOME;
+  if (xdg)
+    return join2(xdg, "prosey");
+  return join2(homedir2(), ".local", "share", "prosey");
+}
+function cacheDir(videoId, opts, baseDir) {
+  return join2(baseDir ?? dataDir(), cacheKey(videoId, opts));
 }
 async function readCache(dir, filename) {
   try {
@@ -103317,10 +103338,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.9.0",
+  version: "0.10.0",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -121947,25 +121988,6 @@ var debugApis = {
 };
 
 // src/index.ts
-var YT_INNERTUBE_API_KEY = "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8";
-async function fetchChannelDescription(channelId) {
-  try {
-    const resp = await fetch(`https://www.youtube.com/youtubei/v1/browse?key=${YT_INNERTUBE_API_KEY}`, {
-      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;
-  }
-}
 process.stdout.on("error", (err) => {
   if (err.code === "EPIPE")
     process.exit(0);
@@ -122322,6 +122344,7 @@ if (extractTimestamps) {
   exitProcess(0);
 }
 try {
+  const activeDataDir = dataDir(config.dataDir);
   if (mode === "info") {
     const result = await fetchTranscript(videoId, { videoDetails: true, lang });
     if (outputJson) {
@@ -122338,7 +122361,7 @@ try {
       exitProcess(1);
     }
     const cacheOpts2 = { lang, mode: "summarize", noDecode };
-    const dir2 = cacheDir(videoId, cacheOpts2);
+    const dir2 = cacheDir(videoId, cacheOpts2, activeDataDir);
     let segments2 = null;
     let summary = null;
     let cachedInfo = null;
@@ -122513,7 +122536,7 @@ ${structuredContent}
       exitProcess(1);
     }
     const cacheOpts2 = { lang, mode: "transcribe", noDecode };
-    const dir2 = cacheDir(videoId, cacheOpts2);
+    const dir2 = cacheDir(videoId, cacheOpts2, activeDataDir);
     let segments2 = null;
     let md = null;
     let videoTitle;

package/package.json

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

package/src/cache.test.ts

@@ -2,12 +2,18 @@ import { describe, expect, test, afterEach } from "bun:test";
 import { rm, readFile } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
-import { cacheKey, cacheDir, readCache, writeCache, extractVideoId } from "./cache";
+import { cacheKey, cacheDir, readCache, writeCache, extractVideoId, dataDir } from "./cache";
 
-const testDir = "/tmp/prosey/test-cache-spec";
+const testDir = "/tmp/prosey-test/test-cache-spec";
+const ORIGINAL_DATA_PATH = process.env.PROSEY_DATA_PATH;
+const ORIGINAL_XDG_DATA = process.env.XDG_DATA_HOME;
 
 afterEach(async () => {
   await rm(testDir, { recursive: true, force: true });
+  if (ORIGINAL_DATA_PATH) process.env.PROSEY_DATA_PATH = ORIGINAL_DATA_PATH;
+  else delete process.env.PROSEY_DATA_PATH;
+  if (ORIGINAL_XDG_DATA) process.env.XDG_DATA_HOME = ORIGINAL_XDG_DATA;
+  else delete process.env.XDG_DATA_HOME;
 });
 
 describe("cacheKey", () => {
@@ -36,11 +42,32 @@ describe("cacheKey", () => {
   });
 });
 
+describe("dataDir", () => {
+  test("PROSEY_DATA_PATH takes precedence", () => {
+    process.env.PROSEY_DATA_PATH = "/custom/data";
+    delete process.env.XDG_DATA_HOME;
+    expect(dataDir()).toBe("/custom/data");
+  });
+
+  test("config dataDir argument used when set", () => {
+    delete process.env.PROSEY_DATA_PATH;
+    delete process.env.XDG_DATA_HOME;
+    expect(dataDir("/from/config")).toBe("/from/config");
+  });
+
+  test("falls back to XDG_DATA_HOME", () => {
+    delete process.env.PROSEY_DATA_PATH;
+    process.env.XDG_DATA_HOME = "/custom/xdg-data";
+    expect(dataDir()).toBe("/custom/xdg-data/prosey");
+  });
+});
+
 describe("cacheDir", () => {
-  test("returns path under /tmp/prosey with cache key", () => {
+  test("returns path under the data dir with cache key", () => {
+    process.env.PROSEY_DATA_PATH = "/custom/data";
     const key = cacheKey("abc123def45", {});
     const dir = cacheDir("abc123def45", {});
-    expect(dir).toBe(`/tmp/prosey/${key}`);
+    expect(dir).toBe(`/custom/data/${key}`);
   });
 });
 

package/src/cache.ts

@@ -2,6 +2,7 @@ import { createHash } from "node:crypto";
 import { readFile, writeFile, mkdir } from "node:fs/promises";
 import { existsSync } from "node:fs";
 import { join } from "node:path";
+import { homedir } from "node:os";
 
 const RE_YOUTUBE =
   /(?:v=|\/|v\/|embed\/|watch\?.*v=|youtu\.be\/|\/v\/|e\/|watch\?.*vi?=|\/embed\/|\/v\/|vi?\/|watch\?.*vi?=|youtu\.be\/|\/vi?\/|\/e\/)([a-zA-Z0-9_-]{11})/i;
@@ -30,8 +31,17 @@ export function cacheKey(videoId: string, opts: CacheOptions): string {
   return `${videoId}_${hashOptions(opts)}`;
 }
 
-export function cacheDir(videoId: string, opts: CacheOptions): string {
-  return join("/tmp", "prosey", cacheKey(videoId, opts));
+export function dataDir(configDataDir?: string): string {
+  const env = process.env.PROSEY_DATA_PATH;
+  if (env) return env;
+  if (configDataDir) return configDataDir;
+  const xdg = process.env.XDG_DATA_HOME;
+  if (xdg) return join(xdg, "prosey");
+  return join(homedir(), ".local", "share", "prosey");
+}
+
+export function cacheDir(videoId: string, opts: CacheOptions, baseDir?: string): string {
+  return join(baseDir ?? dataDir(), cacheKey(videoId, opts));
 }
 
 export async function readCache(dir: string, filename: string): Promise<string | null> {

package/src/channel-description.test.ts

@@ -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

@@ -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/config.test.ts

@@ -53,6 +53,7 @@ describe("loadConfig", () => {
     expect(config.pager).toBe("auto");
     expect(config.hints).toBe(true);
     expect(config.format).toBe("html");
+    expect(config.dataDir).toBe("");
     expect(config.ai?.command).toBeString();
     expect(config.summarize?.prompt).toBeString();
     expect(existsSync(tmpConfig)).toBe(true);
@@ -125,6 +126,7 @@ describe("mergeOverDefaults", () => {
     pager: "auto",
     hints: true,
     format: "html",
+    dataDir: "",
     ai: { command: "opencode run" },
     summarize: { prompt: "default summary", command: "opencode run" },
     transcribe: { prompt: "default transcribe" },
@@ -135,6 +137,7 @@ describe("mergeOverDefaults", () => {
     expect(result.pager).toBe("auto");
     expect(result.hints).toBe(true);
     expect(result.format).toBe("html");
+    expect(result.dataDir).toBe("");
     expect(result.ai?.command).toBe("opencode run");
     expect(result.summarize?.prompt).toBe("default summary");
     expect(result.transcribe?.prompt).toBe("default transcribe");
@@ -158,6 +161,12 @@ describe("mergeOverDefaults", () => {
     expect(result.hints).toBe(true);
   });
 
+  test("user dataDir overrides default", () => {
+    const result = mergeOverDefaults({ dataDir: "/custom/data" }, defaults);
+    expect(result.dataDir).toBe("/custom/data");
+    expect(result.pager).toBe("auto");
+  });
+
   test("user ai.command overrides default", () => {
     const result = mergeOverDefaults({ ai: { command: "my-cmd" } }, defaults);
     expect(result.ai?.command).toBe("my-cmd");

package/src/config.ts

@@ -9,6 +9,7 @@ export interface ProseyConfig {
   pager?: string;
   hints?: boolean;
   format?: string;
+  dataDir?: string;
   ai?: {
     command?: string;
   };
@@ -52,6 +53,7 @@ export function mergeOverDefaults(user: ProseyConfig, defaults: ProseyConfig): P
     pager: user.pager ?? defaults.pager,
     hints: user.hints ?? defaults.hints,
     format: user.format ?? defaults.format,
+    dataDir: user.dataDir ?? defaults.dataDir,
     ai: user.ai?.command !== undefined ? user.ai : defaults.ai,
     summarize: {
       command: user.summarize?.command ?? defaults.summarize?.command,
@@ -64,9 +66,21 @@ export function mergeOverDefaults(user: ProseyConfig, defaults: ProseyConfig): P
   };
 }
 
+function camelizeKeys(obj: Record<string, unknown>): Record<string, unknown> {
+  const out: Record<string, unknown> = {};
+  for (const [key, value] of Object.entries(obj)) {
+    const camel = key.replace(/_([a-z])/g, (_, c: string) => c.toUpperCase());
+    out[camel] =
+      value !== null && typeof value === "object" && !Array.isArray(value)
+        ? camelizeKeys(value as Record<string, unknown>)
+        : value;
+  }
+  return out;
+}
+
 async function parseOrEmpty(text: string): Promise<ProseyConfig> {
   try {
-    return load(text) as ProseyConfig;
+    return camelizeKeys(load(text) as Record<string, unknown>) as ProseyConfig;
   } catch {
     return {};
   }

package/src/default-config.toml

@@ -15,6 +15,11 @@ pager = "auto"
 # Can also be set via PROSEY_HINTS env var (yes, no, 1, 0, true, false).
 hints = true
 
+# Data directory for cached transcripts, summaries, and generated HTML.
+# Empty (default): $XDG_DATA_HOME/prosey, or ~/.local/share/prosey.
+# Can also be set via the PROSEY_DATA_PATH env var (takes precedence).
+data_dir = ""
+
 [ai]
 
 # Default command for AI operations (summarize, transcribe).

package/src/index.ts

@@ -18,37 +18,14 @@ import {
   resolveTranscribeCmd,
   resolveTranscribePrompt,
 } from "./config-resolve";
-import { cacheDir, readCache, writeCache, extractVideoId } from "./cache";
+import { cacheDir, readCache, writeCache, extractVideoId, dataDir } 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";
 
-const YT_INNERTUBE_API_KEY = "AIzaSyAO_FJ2SlqU8Q4STEHLGCilw_Y9_11qcW8";
-
-async function fetchChannelDescription(channelId: string): Promise<string | undefined> {
-  try {
-    const resp = await fetch(
-      `https://www.youtube.com/youtubei/v1/browse?key=${YT_INNERTUBE_API_KEY}`,
-      {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({
-          context: {
-            client: { clientName: "WEB", clientVersion: "2.20240101.00.00" },
-          },
-          browseId: channelId,
-        }),
-      },
-    );
-    const data: any = await resp.json();
-    return data?.metadata?.channelMetadataRenderer?.description;
-  } catch {
-    return undefined;
-  }
-}
-
 process.stdout.on("error", (err: NodeJS.ErrnoException) => {
   if (err.code === "EPIPE") process.exit(0);
 });
@@ -454,6 +431,8 @@ if (extractTimestamps) {
 }
 
 try {
+  const activeDataDir = dataDir(config.dataDir);
+
   if (mode === "info") {
     const result = await fetchTranscript(videoId, { videoDetails: true, lang } as any);
     if (outputJson) {
@@ -474,7 +453,7 @@ try {
     }
 
     const cacheOpts = { lang, mode: "summarize", noDecode };
-    const dir = cacheDir(videoId, cacheOpts);
+    const dir = cacheDir(videoId, cacheOpts, activeDataDir);
     let segments: TranscriptSegment[] | null = null;
     let summary: string | null = null;
     let cachedInfo: string | null = null;
@@ -660,7 +639,7 @@ try {
     }
 
     const cacheOpts = { lang, mode: "transcribe", noDecode };
-    const dir = cacheDir(videoId, cacheOpts);
+    const dir = cacheDir(videoId, cacheOpts, activeDataDir);
     let segments: TranscriptSegment[] | null = null;
     let md: string | null = null;
     let videoTitle: string | undefined;