@binaryandthread/cli 0.1.1 → 0.1.2

package/README.md

@@ -1,26 +1,27 @@
-# @binaryandthread/cli — `bt`
+# @binaryandthread/cli, `bt`
 
 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.
+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 piece — 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

@@ -44,7 +44,7 @@ import {
   versionLine,
   warn,
   working
-} from "./chunk-4TEWFVRJ.js";
+} from "./chunk-WYCZ6BPV.js";
 import {
   __require
 } from "./chunk-7OCVIDC7.js";
@@ -73,7 +73,7 @@ function makeLogger(debug, write = (s) => process.stderr.write(s)) {
 }
 
 // src/version.ts
-var VERSION = "0.1.1";
+var VERSION = "0.1.2";
 
 // src/eggs.ts
 function teapot() {
@@ -366,7 +366,7 @@ 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-HNU7Y3KG.js");
+      const { runInteractiveBrowse } = await import("./interactive-DYY27KBC.js");
       const handled = await runInteractiveBrowse(makeClient2(), loadConfig2(), { branch: opts.branch, brand });
       if (handled) return;
     }
@@ -529,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);
@@ -557,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("");