github-search-cli 9.4.1 → 9.4.3

package/src/session.ts

@@ -1,24 +1,26 @@
-/**
- * Session restore — save/restore UI state between restarts.
- */
-import type { SessionState } from "./types";
-import { readJSON, writeJSON } from "./storage";
-
-const SESSION_FILE = "session.json";
-
-export function saveSession(state: SessionState): void {
-  try {
-    writeJSON(SESSION_FILE, state);
-  } catch (err) {
-    if (process.env.DEBUG)
-      console.error(`[ghfind] Failed to save session: ${err instanceof Error ? err.message : String(err)}`);
-  }
-}
-
-export function restoreSession(): SessionState | null {
-  return readJSON<SessionState | null>(SESSION_FILE, null);
-}
-
-export function clearSession(): void {
-  writeJSON(SESSION_FILE, null);
-}
+/**
+ * Session restore — save/restore UI state between restarts.
+ */
+import type { SessionState } from "./types";
+import { readJSON, writeJSON } from "./storage";
+
+const SESSION_FILE = "session.json";
+
+export function saveSession(state: SessionState): void {
+  try {
+    writeJSON(SESSION_FILE, state);
+  } catch (err) {
+    if (process.env.DEBUG)
+      console.error(
+        `[ghfind] Failed to save session: ${err instanceof Error ? err.message : String(err)}`,
+      );
+  }
+}
+
+export function restoreSession(): SessionState | null {
+  return readJSON<SessionState | null>(SESSION_FILE, null);
+}
+
+export function clearSession(): void {
+  writeJSON(SESSION_FILE, null);
+}

package/src/share.ts

@@ -1,54 +1,61 @@
-/**
- * Share repo — copy formatted snippets to clipboard.
- */
-import type { Repo } from "./types";
-
-export type ShareFormat = "markdown" | "plain" | "gh-cli" | "short";
-
-export function formatShare(repo: Repo, format: ShareFormat): string {
-  switch (format) {
-    case "markdown":
-      return `[${repo.fullName}](${repo.url}) — ${repo.description ?? ""}`.trim();
-    case "plain":
-      return `${repo.fullName} — ${repo.description ?? ""} — ${repo.url}`.trim();
-    case "gh-cli":
-      return `gh repo view ${repo.fullName}`;
-    case "short":
-      return repo.fullName;
-  }
-}
-
-/** Copy text to clipboard via platform command. */
-import { spawn } from "child_process";
-
-export async function copyToClipboard(text: string): Promise<boolean> {
-  try {
-    const p = process.platform;
-    const cmd = p === "win32" ? ["clip"] : p === "darwin" ? ["pbcopy"] : await findLinuxClipCmd();
-    if (!cmd) return false;
-    const proc = spawn(cmd[0], cmd.slice(1), { stdio: ["pipe", "ignore", "ignore"] });
-    proc.stdin.write(text);
-    proc.stdin.end();
-    return new Promise((resolve) => {
-      proc.on("close", (code) => resolve(code === 0));
-      proc.on("error", () => resolve(false));
-    });
-  } catch {
-    return false;
-  }
-}
-
-async function findLinuxClipboard(): Promise<string[] | null> {
-  const { execFileSync } = await import("child_process");
-  try {
-    execFileSync("xclip", ["-version"], { stdio: "ignore" });
-    return ["xclip", "-selection", "clipboard"];
-  } catch {
-    try {
-      execFileSync("wl-copy", ["--version"], { stdio: "ignore" });
-      return ["wl-copy"];
-    } catch {
-      return null;
-    }
-  }
-}
+/**
+ * Share repo — copy formatted snippets to clipboard.
+ */
+import type { Repo } from "./types";
+
+export type ShareFormat = "markdown" | "plain" | "gh-cli" | "short";
+
+export function formatShare(repo: Repo, format: ShareFormat): string {
+  switch (format) {
+    case "markdown":
+      return `[${repo.fullName}](${repo.url}) — ${repo.description ?? ""}`.trim();
+    case "plain":
+      return `${repo.fullName} — ${repo.description ?? ""} — ${repo.url}`.trim();
+    case "gh-cli":
+      return `gh repo view ${repo.fullName}`;
+    case "short":
+      return repo.fullName;
+  }
+}
+
+/** Copy text to clipboard via platform command. */
+import { spawn } from "child_process";
+
+export async function copyToClipboard(text: string): Promise<boolean> {
+  try {
+    const p = process.platform;
+    const cmd =
+      p === "win32"
+        ? ["clip"]
+        : p === "darwin"
+          ? ["pbcopy"]
+          : await findLinuxClipboard();
+    if (!cmd) return false;
+    const proc = spawn(cmd[0], cmd.slice(1), {
+      stdio: ["pipe", "ignore", "ignore"],
+    });
+    proc.stdin.write(text);
+    proc.stdin.end();
+    return new Promise((resolve) => {
+      proc.on("close", (code) => resolve(code === 0));
+      proc.on("error", () => resolve(false));
+    });
+  } catch {
+    return false;
+  }
+}
+
+async function findLinuxClipboard(): Promise<string[] | null> {
+  const { execFileSync } = await import("child_process");
+  try {
+    execFileSync("xclip", ["-version"], { stdio: "ignore" });
+    return ["xclip", "-selection", "clipboard"];
+  } catch {
+    try {
+      execFileSync("wl-copy", ["--version"], { stdio: "ignore" });
+      return ["wl-copy"];
+    } catch {
+      return null;
+    }
+  }
+}

package/src/status.ts

@@ -1,61 +1,68 @@
-/**
- * Status bar state machine with spinner animation.
- */
-export type StatusType = "idle" | "searching" | "loading" | "success" | "error";
-
-const SEARCH_SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
-const LOADING_SPINNER = ["▰▱▱▱▱", "▰▰▱▱▱", "▰▰▰▱▱", "▰▰▰▰▱", "▰▰▰▰▰"];
-
-export class StatusManager {
-  private spinnerInterval: ReturnType<typeof setInterval> | null = null;
-  private spinnerIndex = 0;
-  private type: StatusType = "idle";
-  private message = "";
-  private onUpdate: (text: string) => void;
-
-  constructor(onUpdate: (text: string) => void) {
-    this.onUpdate = onUpdate;
-  }
-
-  set(type: StatusType, message: string): void {
-    this.stopSpinner();
-    this.type = type;
-    this.message = message;
-
-    if (type === "searching" || type === "loading") {
-      this.startSpinner(type === "searching" ? SEARCH_SPINNER : LOADING_SPINNER);
-    } else {
-      this.emit();
-    }
-  }
-
-  private startSpinner(frames: string[]): void {
-    this.spinnerIndex = 0;
-    this.emit(frames[0]);
-    this.spinnerInterval = setInterval(() => {
-      this.spinnerIndex = (this.spinnerIndex + 1) % frames.length;
-      this.emit(frames[this.spinnerIndex]);
-    }, 120);
-  }
-
-  private stopSpinner(): void {
-    if (this.spinnerInterval) {
-      clearInterval(this.spinnerInterval);
-      this.spinnerInterval = null;
-    }
-  }
-
-  private emit(spinner?: string): void {
-    const icon = this.type === "searching" ? "🔍"
-      : this.type === "loading" ? "📦"
-      : this.type === "success" ? "✓"
-      : this.type === "error" ? "⚠"
-      : " ";
-    const prefix = spinner ?? "";
-    this.onUpdate(`${icon} ${this.message}  ${prefix}`.trim());
-  }
-
-  dispose(): void {
-    this.stopSpinner();
-  }
-}
+/**
+ * Status bar state machine with spinner animation.
+ */
+export type StatusType = "idle" | "searching" | "loading" | "success" | "error";
+
+const SEARCH_SPINNER = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
+const LOADING_SPINNER = ["▰▱▱▱▱", "▰▰▱▱▱", "▰▰▰▱▱", "▰▰▰▰▱", "▰▰▰▰▰"];
+
+export class StatusManager {
+  private spinnerInterval: ReturnType<typeof setInterval> | null = null;
+  private spinnerIndex = 0;
+  private type: StatusType = "idle";
+  private message = "";
+  private onUpdate: (text: string) => void;
+
+  constructor(onUpdate: (text: string) => void) {
+    this.onUpdate = onUpdate;
+  }
+
+  set(type: StatusType, message: string): void {
+    this.stopSpinner();
+    this.type = type;
+    this.message = message;
+
+    if (type === "searching" || type === "loading") {
+      this.startSpinner(
+        type === "searching" ? SEARCH_SPINNER : LOADING_SPINNER,
+      );
+    } else {
+      this.emit();
+    }
+  }
+
+  private startSpinner(frames: string[]): void {
+    this.spinnerIndex = 0;
+    this.emit(frames[0]);
+    this.spinnerInterval = setInterval(() => {
+      this.spinnerIndex = (this.spinnerIndex + 1) % frames.length;
+      this.emit(frames[this.spinnerIndex]);
+    }, 120);
+  }
+
+  private stopSpinner(): void {
+    if (this.spinnerInterval) {
+      clearInterval(this.spinnerInterval);
+      this.spinnerInterval = null;
+    }
+  }
+
+  private emit(spinner?: string): void {
+    const icon =
+      this.type === "searching"
+        ? "🔍"
+        : this.type === "loading"
+          ? "📦"
+          : this.type === "success"
+            ? "✓"
+            : this.type === "error"
+              ? "⚠"
+              : " ";
+    const prefix = spinner ?? "";
+    this.onUpdate(`${icon} ${this.message}  ${prefix}`.trim());
+  }
+
+  dispose(): void {
+    this.stopSpinner();
+  }
+}

package/src/storage.ts

@@ -1,106 +1,136 @@
-/**
- * Storage adapter — single point of file I/O for state files.
- *
- * All domain modules (history, bookmarks, saved-searches, notifications,
- * session, config) delegate file I/O here. Swap for an in-memory
- * implementation in tests.
- */
-import { existsSync, mkdirSync, readFileSync, writeFileSync, appendFileSync, unlinkSync } from "fs";
-import { join } from "path";
-import { stateDir } from "./config";
-
-/** Ensure the state directory exists. */
-function ensureDir(): void {
-  mkdirSync(stateDir(), { recursive: true });
-}
-
-/** Read and parse a JSON file. Returns `fallback` on any error. */
-export function readJSON<T>(filename: string, fallback: T): T {
-  ensureDir();
-  try {
-    return JSON.parse(readFileSync(join(stateDir(), filename), "utf-8")) as T;
-  } catch {
-    return fallback;
-  }
-}
-
-/** Write data as JSON to a file. */
-export function writeJSON(filename: string, data: unknown): void {
-  ensureDir();
-  writeFileSync(join(stateDir(), filename), JSON.stringify(data, null, 2));
-}
-
-/** Append one JSON object as a line to a JSONL file. */
-export function appendJSONL(filename: string, obj: unknown): void {
-  ensureDir();
-  try {
-    appendFileSync(join(stateDir(), filename), JSON.stringify(obj) + "\n", "utf-8");
-  } catch {
-    // non-critical
-  }
-}
-
-/** Read all lines from a JSONL file, parsing each as JSON. */
-export function readJSONL<T>(filename: string): T[] {
-  ensureDir();
-  try {
-    const raw = readFileSync(join(stateDir(), filename), "utf-8").trim();
-    if (!raw) return [];
-    return raw.split("\n").filter(Boolean).map((l) => JSON.parse(l) as T);
-  } catch {
-    return [];
-  }
-}
-
-/** Write raw text to a file (bypasses JSON encoding). */
-export function writeRaw(filename: string, data: string): void {
-  ensureDir();
-  writeFileSync(join(stateDir(), filename), data);
-}
-
-/** Delete a file if it exists. */
-export function deleteFile(filename: string): void {
-  try {
-    unlinkSync(join(stateDir(), filename));
-  } catch {
-    // non-critical
-  }
-}
-
-/** Append a timestamped debug line to ghfind-debug.log (only when DEBUG is set). */
-export function debugLog(msg: string): void {
-  if (!process.env.DEBUG) return;
-  try {
-    appendFileSync(join(stateDir(), "ghfind-debug.log"), `[${new Date().toISOString()}] ${msg}\n`, "utf-8");
-  } catch { /* ignore */ }
-}
-
-/** Check if a file exists in the state dir. */
-export function fileExists(filename: string): boolean {
-  return existsSync(join(stateDir(), filename));
-}
-
-// ─── In-memory implementation for tests ────────────────────────────────
-
-const memStore = new Map<string, string>();
-
-export const memoryStorage = {
-  readJSON<T>(filename: string, fallback: T): T {
-    const raw = memStore.get(filename);
-    if (!raw) return fallback;
-    try { return JSON.parse(raw) as T; } catch { return fallback; }
-  },
-  writeJSON(filename: string, data: unknown): void {
-    memStore.set(filename, JSON.stringify(data, null, 2));
-  },
-  appendJSONL(filename: string, obj: unknown): void {
-    const existing = memStore.get(filename) ?? "";
-    memStore.set(filename, existing + JSON.stringify(obj) + "\n");
-  },
-  readJSONL<T>(filename: string): T[] {
-    const raw = memStore.get(filename);
-    if (!raw) return [];
-    return raw.trim().split("\n").filter(Boolean).map((l) => JSON.parse(l) as T);
-  },
-  clear(): void { memStore.clear(); },
-};
+/**
+ * Storage adapter — single point of file I/O for state files.
+ *
+ * All domain modules (history, bookmarks, saved-searches, notifications,
+ * session, config) delegate file I/O here. Swap for an in-memory
+ * implementation in tests.
+ */
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  appendFileSync,
+  unlinkSync,
+} from "fs";
+import { join } from "path";
+import { stateDir } from "./config";
+
+/** Ensure the state directory exists. */
+function ensureDir(): void {
+  mkdirSync(stateDir(), { recursive: true });
+}
+
+/** Read and parse a JSON file. Returns `fallback` on any error. */
+export function readJSON<T>(filename: string, fallback: T): T {
+  ensureDir();
+  try {
+    return JSON.parse(readFileSync(join(stateDir(), filename), "utf-8")) as T;
+  } catch {
+    return fallback;
+  }
+}
+
+/** Write data as JSON to a file. */
+export function writeJSON(filename: string, data: unknown): void {
+  ensureDir();
+  writeFileSync(join(stateDir(), filename), JSON.stringify(data, null, 2));
+}
+
+/** Append one JSON object as a line to a JSONL file. */
+export function appendJSONL(filename: string, obj: unknown): void {
+  ensureDir();
+  try {
+    appendFileSync(
+      join(stateDir(), filename),
+      JSON.stringify(obj) + "\n",
+      "utf-8",
+    );
+  } catch {
+    // non-critical
+  }
+}
+
+/** Read all lines from a JSONL file, parsing each as JSON. */
+export function readJSONL<T>(filename: string): T[] {
+  ensureDir();
+  try {
+    const raw = readFileSync(join(stateDir(), filename), "utf-8").trim();
+    if (!raw) return [];
+    return raw
+      .split("\n")
+      .filter(Boolean)
+      .map((l) => JSON.parse(l) as T);
+  } catch {
+    return [];
+  }
+}
+
+/** Write raw text to a file (bypasses JSON encoding). */
+export function writeRaw(filename: string, data: string): void {
+  ensureDir();
+  writeFileSync(join(stateDir(), filename), data);
+}
+
+/** Delete a file if it exists. */
+export function deleteFile(filename: string): void {
+  try {
+    unlinkSync(join(stateDir(), filename));
+  } catch {
+    // non-critical
+  }
+}
+
+/** Append a timestamped debug line to ghfind-debug.log (only when DEBUG is set). */
+export function debugLog(msg: string): void {
+  if (!process.env.DEBUG) return;
+  try {
+    appendFileSync(
+      join(stateDir(), "ghfind-debug.log"),
+      `[${new Date().toISOString()}] ${msg}\n`,
+      "utf-8",
+    );
+  } catch {
+    /* ignore */
+  }
+}
+
+/** Check if a file exists in the state dir. */
+export function fileExists(filename: string): boolean {
+  return existsSync(join(stateDir(), filename));
+}
+
+// ─── In-memory implementation for tests ────────────────────────────────
+
+const memStore = new Map<string, string>();
+
+export const memoryStorage = {
+  readJSON<T>(filename: string, fallback: T): T {
+    const raw = memStore.get(filename);
+    if (!raw) return fallback;
+    try {
+      return JSON.parse(raw) as T;
+    } catch {
+      return fallback;
+    }
+  },
+  writeJSON(filename: string, data: unknown): void {
+    memStore.set(filename, JSON.stringify(data, null, 2));
+  },
+  appendJSONL(filename: string, obj: unknown): void {
+    const existing = memStore.get(filename) ?? "";
+    memStore.set(filename, existing + JSON.stringify(obj) + "\n");
+  },
+  readJSONL<T>(filename: string): T[] {
+    const raw = memStore.get(filename);
+    if (!raw) return [];
+    return raw
+      .trim()
+      .split("\n")
+      .filter(Boolean)
+      .map((l) => JSON.parse(l) as T);
+  },
+  clear(): void {
+    memStore.clear();
+  },
+};