trackrev 0.1.0 → 0.3.0

package/src/lib/prompt.js

@@ -0,0 +1,55 @@
+import { createInterface } from "node:readline";
+import { EXIT, die } from "./api.js";
+
+const CTRL_C = String.fromCharCode(3);
+const BACKSPACE = String.fromCharCode(127);
+
+/**
+ * Yes/no on stderr (stdout stays pipe-clean). `--yes` skips it; without a TTY
+ * and without --yes we refuse rather than hang a script waiting for a keypress.
+ */
+export async function confirm(question, { yes } = {}) {
+  if (yes) return true;
+  if (!process.stdin.isTTY) {
+    die(`${question}\nRefusing to run a destructive command non-interactively. Pass --yes.`, EXIT.USAGE);
+  }
+  const rl = createInterface({ input: process.stdin, output: process.stderr });
+  const answer = await new Promise((resolve) => rl.question(`${question} [y/N] `, resolve));
+  rl.close();
+  return /^y(es)?$/i.test(answer.trim());
+}
+
+/** Read a secret without echoing it. */
+export function promptSecret(label) {
+  if (!process.stdin.isTTY) {
+    die("No terminal to prompt on. Pass --key or set TRACKREV_KEY.", EXIT.USAGE);
+  }
+  process.stderr.write(`${label}: `);
+  return new Promise((resolve) => {
+    const { stdin } = process;
+    stdin.setRawMode(true);
+    stdin.resume();
+    stdin.setEncoding("utf8");
+    let buf = "";
+    const onData = (ch) => {
+      if (ch === CTRL_C) {
+        process.stderr.write("\n");
+        process.exit(EXIT.USAGE);
+      }
+      if (ch === "\r" || ch === "\n") {
+        stdin.setRawMode(false);
+        stdin.pause();
+        stdin.off("data", onData);
+        process.stderr.write("\n");
+        resolve(buf);
+        return;
+      }
+      if (ch === BACKSPACE || ch === "\b") {
+        buf = buf.slice(0, -1);
+        return;
+      }
+      buf += ch;
+    };
+    stdin.on("data", onData);
+  });
+}

package/src/registry.d.ts

@@ -0,0 +1,58 @@
+export interface CliFlag {
+  name: string;
+  type: "string" | "boolean";
+  meaning: string;
+  /** Placeholder shown after the flag in help, e.g. "N", "ISO", "URL". */
+  arg?: string;
+  multiple?: boolean;
+  default?: string;
+}
+
+/**
+ * The heading a command is filed under in `trackrev --help`, on /cli, on
+ * /agents and in the generated README tables. Kept in lockstep with the
+ * `group:` values in registry.js — a group that exists there but not here is
+ * invisible to every TypeScript consumer that filters by group.
+ */
+export type CliGroup =
+  | "Analytics"
+  | "Links"
+  | "Developers"
+  | "Setup"
+  | "Revenue"
+  | "Audience"
+  | "Domains"
+  | "Affiliate"
+  | "Money"
+  | "Settings"
+  | "Account";
+
+export interface CliCommand {
+  noun: string;
+  verb: string | null;
+  group: CliGroup;
+  summary: string;
+  example: string;
+  args: string[];
+  flags: CliFlag[];
+  module: string;
+  handler: string;
+  paid: boolean;
+  destructive?: boolean;
+  aliases?: string[];
+  bareNoun?: boolean;
+  note?: string;
+}
+
+export const VERSION: string;
+export const GLOBAL_FLAGS: CliFlag[];
+export const COMMANDS: CliCommand[];
+export function usageOf(cmd: CliCommand): string;
+export function flagLabel(f: CliFlag): string;
+export function resolve(
+  noun: string | undefined,
+  verb: string | undefined,
+): { command: CliCommand; consumed: number } | null;
+export function optionsFor(cmd: CliCommand | null): Record<string, unknown>;
+export function helpText(): string;
+export function helpFor(cmd: CliCommand): string;