@tacone/prosey 0.9.1 → 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 {
@@ -103340,7 +103361,7 @@ async function fetchChannelDescription(channelId) {
 // package.json
 var package_default = {
   name: "@tacone/prosey",
-  version: "0.9.1",
+  version: "0.10.0",
   description: "Download YouTube video transcripts from the CLI",
   module: "src/index.ts",
   type: "module",
@@ -122323,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) {
@@ -122339,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;
@@ -122514,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.1",
+  "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/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,7 +18,7 @@ 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";
@@ -431,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) {
@@ -451,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;
@@ -637,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;