@binaryandthread/cli 0.1.0 → 0.1.2

package/README.md

@@ -1,26 +1,27 @@
-# @binaryandthread/cli — `bt`
+# @binaryandthread/cli, `bt`
 
-Buy a Binary & Thread heavyweight tee **from your terminal**, with the ceremony of a production
-deploy. A small, well-tested client over the Store API — the card never touches the terminal.
+Buy a Binary & Thread heavyweight piece **from your terminal**, with the ceremony of a production
+deploy. A small, well-tested client over the Store API, the card never touches the terminal.
 
 > `bt` is a dumb client. Every dangerous operation (payment, fulfilment) lives in the backend.
 > Checkout hands you a URL; you pay on the storefront's Stripe page in your own browser.
 
 ## Install
 
-Zero-config — it ships pointed at the live store (the publishable key is public by design):
+Zero-config, it ships pointed at the live store (the publishable key is public by design):
 
 ```bash
-# soft-launch tarball (friends): install the .tgz you were handed
-npm i -g ./binaryandthread-cli-0.1.0.tgz
+# recommended: install globally for a persistent `bt` on your PATH
+npm i -g @binaryandthread/cli
 bt browse
 
-# or, once published:
+# or run without installing (no persistent command):
 npx @binaryandthread/cli browse
 ```
 
-A bare `bt` may collide with another binary on your `PATH`; `npx @binaryandthread/cli …` is the
-unambiguous form.
+A bare `bt` may collide with another binary on your `PATH`. If it does, this package also installs
+**`btn`** as an alias, `btn browse` works identically. (`npx @binaryandthread/cli …` is always the
+unambiguous form.)
 
 ## Commands
 
@@ -28,7 +29,7 @@ unambiguous form.
 | --- | --- |
 | `bt browse` | the catalog (interactive ↑/↓ picker on a TTY; `--json` for scripts) |
 | `bt search <q>` | filter the catalog |
-| `bt view <handle>` | one tee — specs + mockup (`--colour black` renders the black row) |
+| `bt view <handle>` | one piece, specs + mockup (`--colour black` renders the black row) |
 | `bt stage <handle>` | add to your cart (`--size`, `--colour`) |
 | `bt cart` / `bt unstage <ref>` | show / remove a line |
 | `bt checkout` | mint a checkout, hand off to the browser to pay, then poll |
@@ -37,22 +38,22 @@ unambiguous form.
 | `bt drops` | terminal-visible drops |
 | `bt forget` | wipe your local session + config (keychain token, cart, email) |
 
-## Config (all optional — env overrides the baked-in prod defaults)
+## Config (all optional, env overrides the baked-in prod defaults)
 
 | var | notes |
 | --- | --- |
 | `BT_API_URL` | Store API base URL (default: production; set for local dev / staging) |
-| `BT_PUBLISHABLE_KEY` | the **publishable** key — public by design (a secret `sk_` key is rejected) |
+| `BT_PUBLISHABLE_KEY` | the **publishable** key, public by design (a secret `sk_` key is rejected) |
 | `NO_COLOR` / `--no-color` | plain output, no ANSI / inline images |
 | `--json` | machine-readable output for scripts / CI |
 
-Your auth token is **never** stored in config — it lives in the OS keychain (`bt login`).
+Your auth token is **never** stored in config, it lives in the OS keychain (`bt login`).
 Local config (cart id, email, defaults) lives at `~/.config/bt/config.json`.
 
 ## Scripting: `--json` output & exit codes
 
 Every command takes `--json` for stable, machine-readable output. `bt checkout --json` (or `--yes`)
-skips the interactive confirm so it never hangs in CI. Field shapes (stable — safe to depend on):
+skips the interactive confirm so it never hangs in CI. Field shapes (stable, safe to depend on):
 
 | command | `--json` shape |
 | --- | --- |
@@ -71,8 +72,8 @@ exits with a distinct code so CI/agents can branch:
 | `0` | — | success |
 | `65` | `client_error` / `stale_cart` | bad request / re-stage the cart |
 | `69` | `not_found` | no such product/order |
-| `75` | `rate_limited` / `upstream` | temporary — retry later (a `429` is auto-retried honoring `Retry-After`) |
-| `77` | `auth` | not logged in / forbidden — run `bt login` |
+| `75` | `rate_limited` / `upstream` | temporary, retry later (a `429` is auto-retried honoring `Retry-After`) |
+| `77` | `auth` | not logged in / forbidden, run `bt login` |
 | `1` | `error` | anything else |
 
 **Rate limits:** the client auto-retries `429` responses, honoring the server's `Retry-After`

package/dist/bin.js

@@ -15,39 +15,36 @@ import {
   RecoverableCartError,
   StoreApiError,
   StoreClient,
+  box,
   brandOf,
+  colourMarker,
+  contributionBar,
+  cyan,
+  dim,
   displayName,
   empty,
   fail,
   firstPrice,
   fmtPrice,
   formatCartLine,
+  green,
+  header,
   lineColour,
   ok,
   printResult,
   productColours,
   redact,
-  registerBrowse,
   registerStage,
   registerView,
   resolveLineItemRef,
+  resolveOutput,
+  rule,
   runStage,
   stageMarker,
   versionLine,
   warn,
   working
-} from "./chunk-DWTH7CNI.js";
-import {
-  box,
-  colourMarker,
-  contributionBar,
-  cyan,
-  dim,
-  green,
-  header,
-  makeBrand,
-  rule
-} from "./chunk-P3LSUCEO.js";
+} from "./chunk-WYCZ6BPV.js";
 import {
   __require
 } from "./chunk-7OCVIDC7.js";
@@ -75,6 +72,9 @@ function makeLogger(debug, write = (s) => process.stderr.write(s)) {
   };
 }
 
+// src/version.ts
+var VERSION = "0.1.2";
+
 // src/eggs.ts
 function teapot() {
   return `${GLYPH.fail}  418 i'm a teapot. we make clothing, not coffee. (RFC 2324)`;
@@ -297,6 +297,84 @@ function deleteToken(deps = {}) {
   }
 }
 
+// src/commands/browse.ts
+function productRow(p, stage, style) {
+  const { amount, currency } = firstPrice(p);
+  const { title, handle } = displayName(p);
+  const colours = colourMarker(productColours(p));
+  const parts = [
+    title.padEnd(22),
+    cyan(style, fmtPrice(amount, currency).padEnd(11)),
+    dim(style, handle.padEnd(34)),
+    stageMarker(stage)
+  ];
+  const row = parts.join(" ").trimEnd();
+  return colours ? `${row}
+   ${dim(style, colours)}` : row;
+}
+async function runBrowse(client, config, args) {
+  const style = brandOf(args);
+  const region = await client.resolveRegion(config.region);
+  const products = await client.listProducts({ region });
+  const rows = products.map((p) => ({
+    p,
+    stage: p.metadata?.["channel_stage"] ?? "main"
+  }));
+  let drops = [];
+  if (args.branch === "next") {
+    drops = await client.listDrops();
+  }
+  const lines = [];
+  if (rows.length === 0 && drops.length === 0) {
+    lines.push(empty("nothing in stock on this branch yet. main is the latest."));
+    lines.push("   peek at next \u2192 bt browse --branch=next");
+  } else {
+    lines.push(header(style, "bt browse \u2014 in stock"));
+    for (const { p, stage } of rows) {
+      lines.push(productRow(p, stage, style));
+    }
+    for (const d of drops) {
+      const dt = (d.title ?? d.handle ?? d.id).toString();
+      lines.push(
+        [
+          dt.padEnd(22),
+          cyan(style, fmtPrice(d.price, region.currency_code).padEnd(11)),
+          dim(style, (d.handle ?? d.id).padEnd(34)),
+          stageMarker(d.channel_stage)
+        ].join(" ").trimEnd()
+      );
+    }
+    if (drops.length > 0) {
+      lines.push("   on next, before the web \u2192 bt drops");
+    }
+    lines.push("   view one \u2192 bt view <handle>   \xB7   stage one \u2192 bt stage <handle> --size L");
+  }
+  return {
+    lines,
+    json: args.json ? products.map((p) => ({
+      id: p.id,
+      handle: p.handle,
+      title: p.title,
+      price: firstPrice(p).amount,
+      currency: firstPrice(p).currency,
+      colours: productColours(p),
+      channel_stage: p.metadata?.["channel_stage"] ?? "main"
+    })) : void 0
+  };
+}
+function registerBrowse(program, makeClient2, loadConfig2) {
+  program.command("browse").alias("ls").description("list what's in stock on a branch.").option("--branch <branch>", "main (live) or next (terminal-only drops)").option("--plain", "force the static table (skip the interactive picker)").action(async (opts) => {
+    const { json, brand } = resolveOutput(program);
+    if (!json && !opts.plain && brand.color && process.stdout.isTTY) {
+      const { runInteractiveBrowse } = await import("./interactive-DYY27KBC.js");
+      const handled = await runInteractiveBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, brand });
+      if (handled) return;
+    }
+    const res = await runBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, json, brand });
+    printResult(res, json);
+  });
+}
+
 // src/commands/search.ts
 function matches(p, q) {
   const needle = q.toLowerCase();
@@ -343,9 +421,7 @@ async function runSearch(client, config, args) {
 }
 function registerSearch(program, makeClient2, loadConfig2) {
   program.command("search").argument("<query>", "what to look for").description("filter the catalog by a query.").action(async (query) => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const res = await runSearch(makeClient2(), loadConfig2(), { query, json, brand });
     printResult(res, json);
   });
@@ -397,9 +473,7 @@ async function runCart(client, config, args) {
 }
 function registerCart(program, makeClient2, loadConfig2) {
   program.command("cart").description("show your current cart \u2014 the authoritative server state.").action(async () => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const res = await runCart(makeClient2(), loadConfig2(), { json, brand });
     printResult(res, json);
   });
@@ -455,8 +529,30 @@ async function runCheckout(client, config, args, deps) {
   if (!prompts) {
     throw new Error("checkout requires a prompter");
   }
+  let shippedCart;
+  try {
+    shippedCart = await client.ensureCartShippingMethod(cartId);
+  } catch (e) {
+    if (e instanceof RecoverableCartError) {
+      return {
+        lines: [
+          warn("that cart is no longer valid (expired or already committed)."),
+          "   re-stage \u2192 bt browse  then  bt stage <slug>"
+        ]
+      };
+    }
+    return {
+      lines: [
+        fail({
+          code: 1,
+          what: "couldn't attach a shipping method to your cart.",
+          fix: "this region may not have shipping configured yet \u2014 try again shortly, or re-stage."
+        })
+      ]
+    };
+  }
   const itemCount = cart.items.reduce((n, li) => n + (li.quantity ?? 1), 0);
-  const totalLine = fmtPrice(cart.total, cart.currency_code ?? region.currency_code);
+  const totalLine = fmtPrice(shippedCart?.total ?? cart.total, cart.currency_code ?? region.currency_code);
   const reviewLines = [header(style, "bt checkout \u2014 staged for commit")];
   for (const li of cart.items) {
     const colour = lineColour(li);
@@ -483,34 +579,33 @@ async function runCheckout(client, config, args, deps) {
   }
   const allowed = supportedCountries(region);
   const shipsTo = (allowed[0] ?? "").toUpperCase();
+  const email = (config.email ?? "").trim();
+  const { checkout_url, session_id } = await client.mintCheckout(cartId, email || void 0, "cli");
+  const save = email ? { email } : {};
+  const opened = await deps.open(checkout_url);
+  for (const line of opened.lines) {
+    print(line);
+  }
+  print("   enter your details on the page \u2014 address + card. cards never touch the terminal.");
+  let outcome;
   try {
-    await client.ensureCartShippingMethod(cartId);
-  } catch (e) {
-    if (e instanceof RecoverableCartError) {
-      return {
-        lines: [
-          warn("that cart is no longer valid (expired or already committed)."),
-          "   re-stage \u2192 bt browse  then  bt stage <slug>"
-        ]
-      };
-    }
+    outcome = await deps.poll(session_id);
+  } catch {
     return {
       lines: [
+        "",
         fail({
-          code: 1,
-          what: "couldn't attach a shipping method to your cart.",
-          fix: "this region may not have shipping configured yet \u2014 try again shortly, or re-stage."
+          code: 75,
+          what: "lost the connection while waiting for your order to complete.",
+          money: "if you completed payment, your order is safe \u2014 we just couldn't confirm it here. check your email, or run bt order.",
+          fix: "bt checkout --resume   (or open the link below manually)",
+          link: checkout_url
         })
-      ]
+      ],
+      save
     };
   }
-  const email = (config.email ?? "").trim();
-  const { checkout_url, session_id } = await client.mintCheckout(cartId, email || void 0, "cli");
-  const save = email ? { email } : {};
-  const opened = await deps.open(checkout_url);
-  print("   enter your details on the page \u2014 address + card. cards never touch the terminal.");
-  const outcome = await deps.poll(session_id);
-  const lines = [...opened.lines];
+  const lines = [];
   if (outcome.status === "placed") {
     const displayId = await resolveDisplayId(client, outcome.order_id, email);
     lines.push("");
@@ -577,9 +672,7 @@ function maskEmail(email) {
 }
 function registerCheckout(program, makeClient2, loadConfig2) {
   const action = async (opts) => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const { makePrompts: makePrompts2 } = await import("./prompts-GTC5VYM6.js");
     const { openCheckout } = await import("./browser-EO5EQUXQ.js");
     const { pollUntilPlaced } = await import("./poll-O3VUD5WV.js");
@@ -666,9 +759,7 @@ async function runOrder(client, config, args) {
 }
 function registerOrder(program, makeClient2, loadConfig2) {
   program.command("order").argument("<id>", "the order number (display id)").description("track one order: staged \u2192 committed \u2192 printed \u2192 shipped \u2192 delivered.").action(async (id) => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const res = await runOrder(makeClient2(), loadConfig2(), { displayId: id, json, brand });
     printResult(res, json);
   });
@@ -704,7 +795,7 @@ function resolveBridgeToken(env, keychainToken) {
 }
 function registerToken(program) {
   program.command("token").description("print your keychain JWT for an MCP config (env BT_TOKEN). a bearer credential \u2014 handle with care.").action(() => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const token = resolveBridgeToken(process.env, getToken());
     if (!token) {
       process.stderr.write(empty("not logged in \u2014 run bt login first.") + "\n");
@@ -797,15 +888,14 @@ function renderFlat(orders) {
 // src/commands/log.ts
 var EMPTY_STATE2 = "no commits yet. your wardrobe is a fresh repo.";
 async function runLog(client, config, args) {
-  const history = client;
   const loggedIn = args.loggedIn ?? Boolean(config.email);
-  if (!loggedIn || typeof history.listOrders !== "function") {
+  if (!loggedIn) {
     return {
       lines: [empty(EMPTY_STATE2), "   start one \u2192 bt browse"],
       json: args.json ? { commits: [] } : void 0
     };
   }
-  const orders = await history.listOrders();
+  const orders = await client.listOrders();
   if (!orders || orders.length === 0) {
     return {
       lines: [empty(EMPTY_STATE2), "   start one \u2192 bt browse"],
@@ -821,9 +911,7 @@ async function runLog(client, config, args) {
 }
 function registerLog(program, makeClient2, loadConfig2) {
   program.command("log").option("--oneline", "compact one-line-per-order format").option("--graph", "graph format").description("your order history as a git log.").action(async (opts) => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const loggedIn = Boolean(resolveBridgeToken(process.env, getToken()));
     const res = await runLog(makeClient2(), loadConfig2(), { oneline: opts.oneline, graph: opts.graph, json, loggedIn, brand });
     printResult(res, json);
@@ -882,9 +970,7 @@ async function runStatus(client, config, args) {
 }
 function registerStatus(program, makeClient2, loadConfig2) {
   program.command("status").description("working-tree state: what's staged, what's in flight.").action(async () => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const res = await runStatus(makeClient2(), loadConfig2(), { json, brand });
     printResult(res, json);
   });
@@ -899,15 +985,6 @@ async function runUnstage(client, config, args) {
       json: args.json ? { cart_id: null, items: [] } : void 0
     };
   }
-  const remover = client;
-  if (typeof remover.removeLineItem !== "function") {
-    return {
-      lines: [
-        warn("unstage isn't wired to this client build yet."),
-        "   for now: bt forget clears your local cart, or re-stage to overwrite."
-      ]
-    };
-  }
   try {
     const before = await client.getCart(config.cart_id);
     const beforeItems = before.items ?? [];
@@ -927,7 +1004,7 @@ async function runUnstage(client, config, args) {
         json: args.json ? { cart_id: before.id, removed: null, items: beforeItems } : void 0
       };
     }
-    await remover.removeLineItem(config.cart_id, target.id);
+    await client.removeLineItem(config.cart_id, target.id);
     const after = await client.getCart(config.cart_id);
     const afterItems = after.items ?? [];
     const stillThere = afterItems.some((li) => li.id === target.id);
@@ -973,7 +1050,7 @@ async function runUnstage(client, config, args) {
 }
 function registerUnstage(program, makeClient2, loadConfig2) {
   program.command("unstage").alias("reset").argument("<ref>", "the staged item: its # (from bt cart), its line-item id, or its name").description("remove a staged item from the cart (git reset).").action(async (ref) => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const res = await runUnstage(makeClient2(), loadConfig2(), { itemId: ref, json });
     printResult(res, json);
   });
@@ -1078,9 +1155,7 @@ async function runWhoami(client, config, args, token) {
 }
 function registerWhoami(program, makeClient2, loadConfig2) {
   program.command("whoami").description("your contribution profile + standing.").action(async () => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const res = await runWhoami(makeClient2(), loadConfig2(), { json, brand }, getToken());
     printResult(res, json);
   });
@@ -1132,7 +1207,7 @@ async function runDrops(client, _config, args) {
 }
 function registerDrops(program, makeClient2, loadConfig2) {
   program.command("drops").alias("next").description("what's on next before it hits the web.").action(async () => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const res = await runDrops(makeClient2(), loadConfig2(), { json });
     printResult(res, json);
   });
@@ -1157,7 +1232,7 @@ async function runConnect(args) {
 }
 function registerConnect(program) {
   program.command("connect").description("the contributor on-ramp \u2014 what connecting unlocks. run bt login to connect.").action(async () => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const res = await runConnect({ json });
     printResult(res, json);
   });
@@ -1222,7 +1297,7 @@ async function runLogin(client, prompts, keychain, config, args) {
 }
 function registerLogin(program, makeClient2, loadConfig2, prompts, keychain, persist) {
   program.command("login").description("connect your wardrobe with a passwordless magic-link (no password, ever).").option("--email <email>", "your email (skips the prompt)").action(async (opts) => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const envToken = process.env.BT_MAGIC_TOKEN?.trim() || void 0;
     const res = await runLogin(makeClient2(), prompts, keychain, loadConfig2(), {
       email: opts.email,
@@ -1310,7 +1385,7 @@ async function runDrop(args, exec) {
 }
 function registerDrop(program, exec) {
   program.command("drop", { hidden: true }).argument("<sub>", "create | verify | promote | retire").option("--motif <slug>", "motif slug (create)").option("--drop-id <id>", "the drop id").option("--stage <stage>", "expected stage for verify (next|main)").description("operator: manage a drop's lifecycle (create/verify/promote/retire).").action(async (sub, opts) => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const operator = process.env.BT_OPERATOR === "1";
     process.stdout.write(working(`drop ${sub}\u2026`) + "\n");
     const res = await runDrop(
@@ -1351,10 +1426,7 @@ function runInit(args) {
 }
 function registerInit(program) {
   program.command("init").description("first-run welcome + the 3-command happy path.").action(async () => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const { makeBrand: makeBrand2 } = await import("./brand-TMOYK6QE.js");
-    const brand = json ? makeBrand2({ noColor: true }) : makeBrand2({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     printResult(runInit({ json, brand }), json);
   });
 }
@@ -1386,9 +1458,7 @@ async function runBuy(client, config, args, deps) {
 }
 function registerBuy(program, makeClient2, loadConfig2) {
   program.command("buy").argument("<handle>", "the product handle/slug").option("--size <size>", "garment size").option("--colour <colour>", "colour, e.g. white / black").description("stage + checkout in one \u2014 reserve, then open browser checkout. cards never touch the terminal.").action(async (handle, opts) => {
-    const gOpts = program.opts();
-    const json = Boolean(gOpts.json);
-    const brand = json ? makeBrand({ noColor: true }) : makeBrand({ noColor: gOpts.color === false });
+    const { json, brand } = resolveOutput(program);
     const { makePrompts: makePrompts2 } = await import("./prompts-GTC5VYM6.js");
     const { openCheckout } = await import("./browser-EO5EQUXQ.js");
     const { pollUntilPlaced } = await import("./poll-O3VUD5WV.js");
@@ -1446,7 +1516,7 @@ function runConfig(args, deps) {
 }
 function registerConfig(program) {
   program.command("config").argument("[sub]", "get | set", "get").argument("[key]", "config key").argument("[value]", "value (for set)").description("view or set local prefs (email, region, defaults). the auth token is never stored here.").action(async (sub, key, value) => {
-    const json = Boolean(program.opts().json);
+    const { json } = resolveOutput(program);
     const { loadConfig: loadConfig2, saveConfig: saveConfig2 } = await import("./config-FXGCWC6Y.js");
     const res = runConfig({ sub, key, value, json }, { load: loadConfig2, save: saveConfig2 });
     printResult(res, json);
@@ -1480,7 +1550,7 @@ function gatherDoctorSnapshot(opts = {}) {
   } catch {
   }
   return {
-    btVersion: "0.1.0",
+    btVersion: VERSION,
     node: process.versions.node,
     platform: `${process.platform}/${process.arch}`,
     storeUrl: baseUrl,
@@ -1558,7 +1628,6 @@ function registerReport(program, makeClient2) {
 }
 
 // src/bin.ts
-var VERSION = "0.1.0";
 function makeClient() {
   const { baseUrl, publishableKey } = resolveClientConfig();
   const jwt = resolveBridgeToken(process.env, getToken()) ?? void 0;