github-search-cli 9.4.2 → 9.4.4

package/src/notifications.ts

@@ -1,59 +1,75 @@
-/** Notification center — ephemeral alerts for rate limits, watch changes, etc. */
-import { readJSON, writeJSON } from "./storage";
-
-export interface Notification {
-  id: number;
-  type: "info" | "warning" | "rate-limit" | "watch-change" | "upgrade" | "release";
-  icon: string;
-  message: string;
-  timestamp: number;
-}
-
-let nextId = 1;
-let notifs: Notification[] = [];
-const MAX_NOTIFS = 50;
-const FILE = "notifications.json";
-
-function load(): void {
-  notifs = readJSON<Notification[]>(FILE, []);
-  nextId = Math.max(...notifs.map((n) => n.id), 0) + 1;
-}
-
-function save(): void {
-  writeJSON(FILE, notifs);
-}
-
-export function addNotification(type: Notification["type"], message: string): Notification {
-  if (notifs.length === 0) load();
-  const n: Notification = { id: nextId++, type, icon: iconFor(type), message, timestamp: Date.now() };
-  notifs.unshift(n);
-  if (notifs.length > MAX_NOTIFS) notifs = notifs.slice(0, MAX_NOTIFS);
-  save();
-  return n;
-}
-
-function iconFor(type: Notification["type"]): string {
-  switch (type) {
-    case "info": return "ℹ";
-    case "warning": return "⚠";
-    case "rate-limit": return "🚫";
-    case "watch-change": return "🔔";
-    case "upgrade": return "📦";
-    case "release": return "🚀";
-  }
-}
-
-export function getNotifications(): Notification[] {
-  if (notifs.length === 0) load();
-  return [...notifs];
-}
-
-export function dismissNotification(id: number): void {
-  notifs = notifs.filter((n) => n.id !== id);
-  save();
-}
-
-export function dismissAll(): void {
-  notifs = [];
-  save();
-}
+/** Notification center — ephemeral alerts for rate limits, watch changes, etc. */
+import { readJSON, writeJSON } from "./storage";
+
+export interface Notification {
+  id: number;
+  type:
+    "info" | "warning" | "rate-limit" | "watch-change" | "upgrade" | "release";
+  icon: string;
+  message: string;
+  timestamp: number;
+}
+
+let nextId = 1;
+let notifs: Notification[] = [];
+const MAX_NOTIFS = 50;
+const FILE = "notifications.json";
+
+function load(): void {
+  notifs = readJSON<Notification[]>(FILE, []);
+  nextId = Math.max(...notifs.map((n) => n.id), 0) + 1;
+}
+
+function save(): void {
+  writeJSON(FILE, notifs);
+}
+
+export function addNotification(
+  type: Notification["type"],
+  message: string,
+): Notification {
+  if (notifs.length === 0) load();
+  const n: Notification = {
+    id: nextId++,
+    type,
+    icon: iconFor(type),
+    message,
+    timestamp: Date.now(),
+  };
+  notifs.unshift(n);
+  if (notifs.length > MAX_NOTIFS) notifs = notifs.slice(0, MAX_NOTIFS);
+  save();
+  return n;
+}
+
+function iconFor(type: Notification["type"]): string {
+  switch (type) {
+    case "info":
+      return "ℹ";
+    case "warning":
+      return "⚠";
+    case "rate-limit":
+      return "🚫";
+    case "watch-change":
+      return "🔔";
+    case "upgrade":
+      return "📦";
+    case "release":
+      return "🚀";
+  }
+}
+
+export function getNotifications(): Notification[] {
+  if (notifs.length === 0) load();
+  return [...notifs];
+}
+
+export function dismissNotification(id: number): void {
+  notifs = notifs.filter((n) => n.id !== id);
+  save();
+}
+
+export function dismissAll(): void {
+  notifs = [];
+  save();
+}

package/src/open-url.ts

@@ -1,16 +1,16 @@
-/**
- * Open a URL in the user's default browser — platform-aware.
- *
- * only if the open/xdg-open pattern fails somewhere.
- */
-
-export function openUrl(url: string): void {
-  try {
-    const p = process.platform;
-    if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
-    else if (p === "darwin") Bun.spawn(["open", url]);
-    else Bun.spawn(["xdg-open", url]);
-  } catch {
-    // non-critical — user can copy the URL manually
-  }
-}
+/**
+ * Open a URL in the user's default browser — platform-aware.
+ *
+ * only if the open/xdg-open pattern fails somewhere.
+ */
+
+export function openUrl(url: string): void {
+  try {
+    const p = process.platform;
+    if (p === "win32") Bun.spawn(["cmd", "/c", "start", "", url]);
+    else if (p === "darwin") Bun.spawn(["open", url]);
+    else Bun.spawn(["xdg-open", url]);
+  } catch {
+    // non-critical — user can copy the URL manually
+  }
+}

package/src/org.ts

@@ -144,9 +144,12 @@ export async function fetchOrgProfile(
 
   let orgPayload: GitHubOrgPayload;
   try {
-    const res = await fetch(`https://api.github.com/orgs/${encodeURIComponent(name)}`, {
-      headers: apiHeaders(token),
-    });
+    const res = await fetch(
+      `https://api.github.com/orgs/${encodeURIComponent(name)}`,
+      {
+        headers: apiHeaders(token),
+      },
+    );
     if (res.status === 404) {
       throw new Error(`Organization "${name}" not found.`);
     }
@@ -154,10 +157,13 @@ export async function fetchOrgProfile(
       const body = await res.text().catch(() => "");
       throw new Error(`GitHub API error ${res.status}: ${body.slice(0, 200)}`);
     }
-    orgPayload = await res.json() as GitHubOrgPayload;
+    orgPayload = (await res.json()) as GitHubOrgPayload;
   } catch (err) {
-    if (err instanceof Error && err.message.includes(`Organization "${name}"`)) throw err;
-    throw new Error(`Failed to fetch org "${name}": ${err instanceof Error ? err.message : String(err)}`);
+    if (err instanceof Error && err.message.includes(`Organization "${name}"`))
+      throw err;
+    throw new Error(
+      `Failed to fetch org "${name}": ${err instanceof Error ? err.message : String(err)}`,
+    );
   }
 
   // Orgs with no public repos don't need the repos request.
@@ -198,9 +204,15 @@ export function formatOrgText(p: OrgProfile): string {
   if (p.createdAt) meta.push(`Created   ${p.createdAt.slice(0, 10)}`);
   if (meta.length > 0) lines.push(meta.join("\n"));
 
-  lines.push(`Repos     ${p.publicRepoCount.toLocaleString()} public${p.fetchedRepoCount < p.publicRepoCount ? ` (aggregated ${p.fetchedRepoCount})` : ""}`);
-  lines.push(`Stars     ${p.totalStars.toLocaleString()} (sum of aggregated repos)`);
-  lines.push(`Forks     ${p.totalForks.toLocaleString()} (sum of aggregated repos)`);
+  lines.push(
+    `Repos     ${p.publicRepoCount.toLocaleString()} public${p.fetchedRepoCount < p.publicRepoCount ? ` (aggregated ${p.fetchedRepoCount})` : ""}`,
+  );
+  lines.push(
+    `Stars     ${p.totalStars.toLocaleString()} (sum of aggregated repos)`,
+  );
+  lines.push(
+    `Forks     ${p.totalForks.toLocaleString()} (sum of aggregated repos)`,
+  );
   lines.push(`URL       ${p.url}`);
 
   if (p.topLanguages.length > 0) {
@@ -214,7 +226,9 @@ export function formatOrgText(p: OrgProfile): string {
     lines.push("");
     lines.push("Top repos by stars:");
     for (const r of p.topRepos) {
-      lines.push(`  ${r.fullName}  ★ ${r.stars.toLocaleString()}  ${r.language ?? ""}`);
+      lines.push(
+        `  ${r.fullName}  ★ ${r.stars.toLocaleString()}  ${r.language ?? ""}`,
+      );
     }
   }
   if (p.activeRepos.length > 0) {
@@ -232,7 +246,8 @@ export function formatOrgJson(p: OrgProfile): string {
 }
 
 export function formatOrgCsv(p: OrgProfile): string {
-  const esc = (v: string) => (/[",\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v);
+  const esc = (v: string) =>
+    /[",\n]/.test(v) ? `"${v.replace(/"/g, '""')}"` : v;
   const row = [
     p.login,
     p.name ?? "",
@@ -243,7 +258,10 @@ export function formatOrgCsv(p: OrgProfile): string {
     p.topLanguages.map((l) => l.language).join(";"),
     p.createdAt,
   ].map(esc);
-  return ["login,name,url,public_repos,total_stars,total_forks,top_languages,created_at", row.join(",")].join("\n");
+  return [
+    "login,name,url,public_repos,total_stars,total_forks,top_languages,created_at",
+    row.join(","),
+  ].join("\n");
 }
 
 export function formatOrgMarkdown(p: OrgProfile): string {
@@ -259,12 +277,22 @@ export function formatOrgMarkdown(p: OrgProfile): string {
     `| Total forks (aggregated) | ${p.totalForks.toLocaleString()} |`,
   );
   if (p.topLanguages.length > 0) {
-    lines.push(`| Top languages | ${p.topLanguages.map((l) => `${l.language} (${l.repos})`).join(", ")} |`);
+    lines.push(
+      `| Top languages | ${p.topLanguages.map((l) => `${l.language} (${l.repos})`).join(", ")} |`,
+    );
   }
   if (p.topRepos.length > 0) {
-    lines.push("", "## Top repos by stars", "", "| Repo | Stars | Language |", "| --- | --- | --- |");
+    lines.push(
+      "",
+      "## Top repos by stars",
+      "",
+      "| Repo | Stars | Language |",
+      "| --- | --- | --- |",
+    );
     for (const r of p.topRepos) {
-      lines.push(`| [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.language ?? "—"} |`);
+      lines.push(
+        `| [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.language ?? "—"} |`,
+      );
     }
   }
   return lines.join("\n");

package/src/output.ts

@@ -1,137 +1,153 @@
-/**
- * Output module — unified formatting, export, and pipe execution.
- *
- * All format functions (JSON, CSV, Markdown, text, urls, names, ssh-urls,
- * clone-commands, ids) register in a single registry. One `format()` function
- * dispatches. `exportToFile` and `pipeExec` are methods on the same module.
- */
-import { writeFileSync } from "fs";
-import type { Repo } from "./types";
-import { openUrl } from "./open-url";
-
-export type Format =
-  | "json" | "csv" | "markdown" | "text"
-  | "urls" | "names" | "ssh-urls" | "clone-commands" | "ids";
-
-export type FormatFn = (repos: Repo[]) => string;
-
-/** Registry of all format functions. Adding a format = 1 line here. */
-const FORMATS: Map<Format, FormatFn> = new Map([
-  // Export formats
-  ["json", formatJson],
-  ["csv", formatCsv],
-  ["markdown", formatMarkdown],
-  ["text", formatText],
-  // Pipe formats
-  ["urls", formatUrls],
-  ["names", formatNames],
-  ["ssh-urls", formatSshUrls],
-  ["clone-commands", formatCloneCommands],
-  ["ids", formatIds],
-]);
-
-// ── Export format functions ────────────────────────────────────────────
-
-export function formatJson(repos: Repo[]): string {
-  return JSON.stringify(repos, null, 2);
-}
-
-function csvEscape(val: unknown): string {
-  const str = String(val ?? "");
-  if (str.includes('"') || str.includes(",") || str.includes("\n")) {
-    return `"${str.replace(/"/g, '""')}"`;
-  }
-  return str;
-}
-
-export function formatCsv(repos: Repo[]): string {
-  const header = "rank,full_name,stars,forks,language,url";
-  const rows = repos.map((r, i) =>
-    `${i + 1},${csvEscape(r.fullName)},${r.stars},${r.forks},${csvEscape(r.language ?? "")},${csvEscape(r.url)}`,
-  );
-  return [header, ...rows].join("\n");
-}
-
-export function formatMarkdown(repos: Repo[]): string {
-  const header = "| # | Repo | Stars | Forks | Language |";
-  const sep = "|---|------|-------|-------|----------|";
-  const rows = repos.map(
-    (r, i) =>
-      `| ${i + 1} | [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.forks.toLocaleString()} | ${r.language ?? "—"} |`,
-  );
-  return [header, sep, ...rows].join("\n");
-}
-
-export function formatText(repos: Repo[]): string {
-  return repos.map((r, i) => `${i + 1}. ${r.fullName} ★ ${r.stars.toLocaleString()} ${r.url}`).join("\n");
-}
-
-// ── Pipe format functions ──────────────────────────────────────────────
-
-export function formatUrls(repos: Repo[]): string {
-  return repos.map((r) => r.url).join("\n");
-}
-
-export function formatNames(repos: Repo[]): string {
-  return repos.map((r) => r.fullName).join("\n");
-}
-
-export function formatSshUrls(repos: Repo[]): string {
-  return repos.map((r) => `git@github.com:${r.fullName}.git`).join("\n");
-}
-
-export function formatCloneCommands(repos: Repo[]): string {
-  return repos.map((r) => `git clone git@github.com:${r.fullName}.git`).join("\n");
-}
-
-export function formatIds(repos: Repo[]): string {
-  return repos.map((r) => String(r.id)).join("\n");
-}
-
-// ── Public API ─────────────────────────────────────────────────────────
-
-/** Format repos using the registered format function. */
-export function format(repos: Repo[], format: Format): string {
-  const fn = FORMATS.get(format);
-  if (!fn) throw new Error(`Unknown format: ${format}`);
-  return fn(repos);
-}
-
-/** Export repos to a file. Returns the file path. */
-export function exportToFile(repos: Repo[], fmt: Format): string {
-  const ext = fmt === "markdown" ? "md" : fmt;
-  const ts = Date.now();
-  const path = `./ghfind-export-${ts}.${ext}`;
-  writeFileSync(path, format(repos, fmt), "utf-8");
-  return path;
-}
-
-/** Execute a pipe target (clone, open) on repos. */
-export async function pipeExec(repos: Repo[], target: string): Promise<void> {
-  for (const repo of repos) {
-    const url = repo.url;
-    switch (target) {
-      case "open":
-        await openUrl(url);
-        break;
-      case "clone":
-        console.log(`git clone git@github.com:${repo.fullName}.git`);
-        break;
-    }
-  }
-}
-
-// ─── Backward-compatible re-exports ─────────────────────────────────────
-
-export type ExportFormat = "json" | "csv" | "markdown" | "text";
-export type FormatLine = "urls" | "names" | "ssh-urls" | "clone-commands" | "ids";
-
-/** @deprecated Use `format()` instead. */
-export function formatRepos(repos: Repo[], fmt: ExportFormat): string {
-  return format(repos, fmt);
-}
-
-/** @deprecated Use `format()` instead. */
-export function formatLines(repos: Repo[], fmt: FormatLine): string {
-  return format(repos, fmt);
-}
+/**
+ * Output module — unified formatting, export, and pipe execution.
+ *
+ * All format functions (JSON, CSV, Markdown, text, urls, names, ssh-urls,
+ * clone-commands, ids) register in a single registry. One `format()` function
+ * dispatches. `exportToFile` and `pipeExec` are methods on the same module.
+ */
+import { writeFileSync } from "fs";
+import type { Repo } from "./types";
+import { openUrl } from "./open-url";
+
+export type Format =
+  | "json"
+  | "csv"
+  | "markdown"
+  | "text"
+  | "urls"
+  | "names"
+  | "ssh-urls"
+  | "clone-commands"
+  | "ids";
+
+export type FormatFn = (repos: Repo[]) => string;
+
+/** Registry of all format functions. Adding a format = 1 line here. */
+const FORMATS: Map<Format, FormatFn> = new Map([
+  // Export formats
+  ["json", formatJson],
+  ["csv", formatCsv],
+  ["markdown", formatMarkdown],
+  ["text", formatText],
+  // Pipe formats
+  ["urls", formatUrls],
+  ["names", formatNames],
+  ["ssh-urls", formatSshUrls],
+  ["clone-commands", formatCloneCommands],
+  ["ids", formatIds],
+]);
+
+// ── Export format functions ────────────────────────────────────────────
+
+export function formatJson(repos: Repo[]): string {
+  return JSON.stringify(repos, null, 2);
+}
+
+function csvEscape(val: unknown): string {
+  const str = String(val ?? "");
+  if (str.includes('"') || str.includes(",") || str.includes("\n")) {
+    return `"${str.replace(/"/g, '""')}"`;
+  }
+  return str;
+}
+
+export function formatCsv(repos: Repo[]): string {
+  const header = "rank,full_name,stars,forks,language,url";
+  const rows = repos.map(
+    (r, i) =>
+      `${i + 1},${csvEscape(r.fullName)},${r.stars},${r.forks},${csvEscape(r.language ?? "")},${csvEscape(r.url)}`,
+  );
+  return [header, ...rows].join("\n");
+}
+
+export function formatMarkdown(repos: Repo[]): string {
+  const header = "| # | Repo | Stars | Forks | Language |";
+  const sep = "|---|------|-------|-------|----------|";
+  const rows = repos.map(
+    (r, i) =>
+      `| ${i + 1} | [${r.fullName}](${r.url}) | ${r.stars.toLocaleString()} | ${r.forks.toLocaleString()} | ${r.language ?? "—"} |`,
+  );
+  return [header, sep, ...rows].join("\n");
+}
+
+export function formatText(repos: Repo[]): string {
+  return repos
+    .map(
+      (r, i) =>
+        `${i + 1}. ${r.fullName} ★ ${r.stars.toLocaleString()} ${r.url}`,
+    )
+    .join("\n");
+}
+
+// ── Pipe format functions ──────────────────────────────────────────────
+
+export function formatUrls(repos: Repo[]): string {
+  return repos.map((r) => r.url).join("\n");
+}
+
+export function formatNames(repos: Repo[]): string {
+  return repos.map((r) => r.fullName).join("\n");
+}
+
+export function formatSshUrls(repos: Repo[]): string {
+  return repos.map((r) => `git@github.com:${r.fullName}.git`).join("\n");
+}
+
+export function formatCloneCommands(repos: Repo[]): string {
+  return repos
+    .map((r) => `git clone git@github.com:${r.fullName}.git`)
+    .join("\n");
+}
+
+export function formatIds(repos: Repo[]): string {
+  return repos.map((r) => String(r.id)).join("\n");
+}
+
+// ── Public API ─────────────────────────────────────────────────────────
+
+/** Format repos using the registered format function. */
+export function format(repos: Repo[], format: Format): string {
+  const fn = FORMATS.get(format);
+  if (!fn) throw new Error(`Unknown format: ${format}`);
+  return fn(repos);
+}
+
+/** Export repos to a file. Returns the file path. */
+export function exportToFile(repos: Repo[], fmt: Format): string {
+  const ext = fmt === "markdown" ? "md" : fmt;
+  const ts = Date.now();
+  const path = `./ghfind-export-${ts}.${ext}`;
+  writeFileSync(path, format(repos, fmt), "utf-8");
+  return path;
+}
+
+/** Execute a pipe target (clone, open) on repos. */
+export async function pipeExec(repos: Repo[], target: string): Promise<void> {
+  for (const repo of repos) {
+    const url = repo.url;
+    switch (target) {
+      case "open":
+        await openUrl(url);
+        break;
+      case "clone":
+        console.log(`git clone git@github.com:${repo.fullName}.git`);
+        break;
+    }
+  }
+}
+
+// ─── Backward-compatible re-exports ─────────────────────────────────────
+
+export type ExportFormat = "json" | "csv" | "markdown" | "text";
+export type FormatLine =
+  "urls" | "names" | "ssh-urls" | "clone-commands" | "ids";
+
+/** @deprecated Use `format()` instead. */
+export function formatRepos(repos: Repo[], fmt: ExportFormat): string {
+  return format(repos, fmt);
+}
+
+/** @deprecated Use `format()` instead. */
+export function formatLines(repos: Repo[], fmt: FormatLine): string {
+  return format(repos, fmt);
+}