@agfs/cli 0.1.0

package/src/lib/format.ts

@@ -0,0 +1,33 @@
+import type { FsEntry, FsTreeNode } from "@agfs/contracts";
+
+export function renderEntries(entries: FsEntry[]) {
+  if (entries.length === 0) {
+    return "(empty)";
+  }
+
+  return entries
+    .map((entry) => {
+      const size = entry.size == null ? "folder" : `${entry.size} bytes`;
+      return `${entry.path}\t${entry.kind}\t${size}`;
+    })
+    .join("\n");
+}
+
+function renderTreeNode(node: FsTreeNode, prefix: string, isLast: boolean): string[] {
+  const branch = prefix ? `${prefix}${isLast ? "└─ " : "├─ "}` : "";
+  const lines = [`${branch}${node.name}${node.kind === "folder" ? "/" : ""}`];
+  const nextPrefix = prefix ? `${prefix}${isLast ? "   " : "│  "}` : "";
+  const children = (node.children ?? []) as FsTreeNode[];
+  children.forEach((child, index) => {
+    lines.push(...renderTreeNode(child, nextPrefix, index === children.length - 1));
+  });
+  return lines;
+}
+
+export function renderTree(nodes: FsTreeNode[]) {
+  if (nodes.length === 0) {
+    return "(empty)";
+  }
+
+  return nodes.flatMap((node, index) => renderTreeNode(node, "", index === nodes.length - 1)).join("\n");
+}

package/src/lib/progress.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from "vitest";
+import { summarizeFolderDownload } from "./progress";
+
+describe("summarizeFolderDownload", () => {
+  it("uses the singular noun for one file", () => {
+    expect(summarizeFolderDownload(1, "./downloads")).toBe("Downloaded 1 file into ./downloads");
+  });
+
+  it("uses the plural noun for multiple files", () => {
+    expect(summarizeFolderDownload(3, "./downloads")).toBe("Downloaded 3 files into ./downloads");
+  });
+});

package/src/lib/progress.ts

@@ -0,0 +1,110 @@
+import readline from "node:readline";
+
+function formatBytes(bytes: number): string {
+  if (!Number.isFinite(bytes) || bytes < 1024) {
+    return `${bytes} B`;
+  }
+  if (bytes < 1024 * 1024) {
+    return `${(bytes / 1024).toFixed(1)} KB`;
+  }
+  if (bytes < 1024 * 1024 * 1024) {
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+  }
+  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
+
+function formatDuration(ms: number): string {
+  if (ms < 1000) {
+    return "<1s";
+  }
+  const seconds = Math.round(ms / 1000);
+  if (seconds < 60) {
+    return `${seconds}s`;
+  }
+  const minutes = Math.floor(seconds / 60);
+  const remainingSeconds = seconds % 60;
+  return `${minutes}m${remainingSeconds}s`;
+}
+
+function trimLabel(label: string, maxLength = 26): string {
+  if (label.length <= maxLength) {
+    return label;
+  }
+
+  return `${label.slice(0, maxLength - 1)}…`;
+}
+
+export class TransferProgress {
+  private current = 0;
+  private readonly startedAt = Date.now();
+  private lastRenderAt = 0;
+  private readonly isInteractive = Boolean(process.stderr.isTTY);
+
+  constructor(
+    private readonly label: string,
+    private readonly totalBytes: number,
+  ) {}
+
+  update(currentBytes: number) {
+    this.current = currentBytes;
+    const now = Date.now();
+    if (now - this.lastRenderAt < 50 && currentBytes < this.totalBytes) {
+      return;
+    }
+
+    this.lastRenderAt = now;
+    this.render();
+  }
+
+  complete() {
+    if (this.totalBytes > 0) {
+      this.current = this.totalBytes;
+    }
+    this.render(true);
+  }
+
+  fail() {
+    if (this.isInteractive) {
+      process.stderr.write("\n");
+    }
+  }
+
+  private render(done = false) {
+    const elapsed = Math.max(Date.now() - this.startedAt, 1);
+    const rate = this.current / (elapsed / 1000);
+    const width = 20;
+    const hasTotal = this.totalBytes > 0;
+    const ratio = hasTotal ? Math.min(this.current / this.totalBytes, 1) : 0;
+    const percent = Math.round(ratio * 100);
+    const filled = Math.round(ratio * width);
+    const bar = hasTotal
+      ? `${"=".repeat(Math.max(0, filled - 1))}${filled > 0 ? ">" : ""}${" ".repeat(width - filled)}`
+      : `${"=".repeat(((Math.floor(elapsed / 120) % width) + 1)).padEnd(width, " ")}`;
+    const etaMs = rate > 0 && hasTotal ? ((this.totalBytes - this.current) / rate) * 1000 : 0;
+    const detail = hasTotal
+      ? `${String(percent).padStart(3)}% ${formatBytes(this.current)}/${formatBytes(this.totalBytes)} ${formatBytes(
+          Math.round(rate),
+        )}/s${done ? "" : ` ETA ${formatDuration(etaMs)}`}`
+      : `${formatBytes(this.current)} transferred ${formatBytes(Math.round(rate))}/s`;
+    const line = `${trimLabel(this.label).padEnd(27)} [${bar}] ${detail}`;
+
+    if (this.isInteractive) {
+      readline.cursorTo(process.stderr, 0);
+      process.stderr.write(line);
+      readline.clearLine(process.stderr, 1);
+      if (done) {
+        process.stderr.write("\n");
+      }
+      return;
+    }
+
+    if (done) {
+      process.stderr.write(`${line}\n`);
+    }
+  }
+}
+
+export function summarizeFolderDownload(fileCount: number, destination: string) {
+  const noun = fileCount === 1 ? "file" : "files";
+  return `Downloaded ${fileCount} ${noun} into ${destination}`;
+}

package/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "baseUrl": ".",
+    "rootDir": "src"
+  },
+  "include": [
+    "src/**/*"
+  ]
+}