@tollbooth-dpyc/web 1.0.0 → 1.1.0

package/dist/wallet.js

@@ -0,0 +1,153 @@
+/**
+ * The wallet's logic without a framework: the top-up state machine, the reading
+ * of a check_payment answer, and the words a coupon row needs. Pure, so it is
+ * tested without React or a server.
+ *
+ * A top-up goes idle → creating → awaiting (an invoice is out) → settled, or
+ * back to idle on cancel, or to failed when the invoice expires, is invalid or
+ * the service refuses. While awaiting, check_payment may be polled: it is free,
+ * idempotent and safe to repeat, unlike receive_npub_proof.
+ */
+export const TOP_UP_IDLE = { phase: "idle", message: null };
+export function paymentPhase(status) {
+    switch (status) {
+        case "Settled":
+            return "settled";
+        case "Expired":
+            return "expired";
+        case "Invalid":
+            return "invalid";
+        default:
+            return "waiting"; // New, Processing, Pending, or a word we do not know yet
+    }
+}
+/** The invoice in a purchase_credits answer, or null when there is none to pay. */
+export function invoiceFrom(result, asked) {
+    if (result.error || result.success === false || !result.invoice_id)
+        return null;
+    const bolt11 = result.lightning_invoice || result.payment_request || null;
+    return {
+        id: result.invoice_id,
+        checkoutLink: result.checkout_link || null,
+        bolt11,
+        sats: typeof result.amount_sats === "number" ? result.amount_sats : asked,
+    };
+}
+/** A whole number of sats worth invoicing, from what the patron typed; else null. */
+export function parseSats(input) {
+    const n = typeof input === "number" ? input : Number(String(input).replace(/[\s,_]/g, ""));
+    return Number.isSafeInteger(n) && n > 0 ? n : null;
+}
+export function topUpReducer(state, event) {
+    switch (event.type) {
+        case "create":
+            if (state.phase === "creating" || state.phase === "awaiting")
+                return state;
+            return parseSats(event.sats) === null
+                ? { phase: "idle", message: "Choose a whole number of sats above zero." }
+                : { phase: "creating", sats: event.sats };
+        case "created": {
+            if (state.phase !== "creating")
+                return state;
+            const invoice = invoiceFrom(event.result, state.sats);
+            if (!invoice) {
+                return {
+                    phase: "failed",
+                    invoice: null,
+                    message: event.result.error ?? "The service did not return an invoice. Try again.",
+                };
+            }
+            return { phase: "awaiting", invoice, checking: false, status: null, checks: 0 };
+        }
+        case "check":
+            if (state.phase !== "awaiting" || state.checking)
+                return state;
+            return { ...state, checking: true };
+        case "checked": {
+            if (state.phase !== "awaiting")
+                return state;
+            const r = event.result;
+            if (r.error)
+                return { ...state, checking: false, status: r.error, checks: state.checks + 1 };
+            switch (paymentPhase(r.status)) {
+                case "settled":
+                    return {
+                        phase: "settled",
+                        invoice: state.invoice,
+                        credited: typeof r.credits_granted === "number" ? r.credits_granted : state.invoice.sats,
+                    };
+                case "expired":
+                    return { phase: "failed", invoice: state.invoice, message: "The invoice expired. Make a new one." };
+                case "invalid":
+                    return { phase: "failed", invoice: state.invoice, message: "The payment was invalid." };
+                default:
+                    return {
+                        ...state,
+                        checking: false,
+                        status: r.message ?? r.status ?? null,
+                        checks: state.checks + 1,
+                    };
+            }
+        }
+        case "error":
+            if (state.phase === "creating")
+                return { phase: "failed", invoice: null, message: event.message };
+            if (state.phase === "awaiting") {
+                return { ...state, checking: false, status: event.message, checks: state.checks + 1 };
+            }
+            return state;
+        case "cancel":
+        case "reset":
+            return TOP_UP_IDLE;
+    }
+}
+/** Whether a poll should run now: an invoice is out, nothing is in flight, and the budget is not spent. */
+export function shouldPoll(state, maxChecks) {
+    return state.phase === "awaiting" && !state.checking && state.checks < maxChecks;
+}
+/** Sats as the fleet writes them. Null is unknown, and unknown is a dash, never 0. */
+export function formatSats(n) {
+    return typeof n === "number" && Number.isFinite(n) ? n.toLocaleString("en-US") : "—";
+}
+// ── Coupons ────────────────────────────────────────────────────────────────
+/** The wheel's coupon status, in words a patron reads. */
+export function couponStatusLabel(status) {
+    switch (status) {
+        case "active":
+            return "Active";
+        case "window_closed":
+            return "Expired";
+        case "window_not_started":
+            return "Not yet active";
+        case "patron_limit":
+            return "All uses claimed";
+        case "total_limit":
+            return "Fully claimed";
+        default:
+            return status;
+    }
+}
+export function couponUsesText(c) {
+    if (c.uses_per_patron == null)
+        return "∞ uses";
+    const n = c.uses_per_patron;
+    return `${c.uses_remaining ?? 0} of ${n} use${n === 1 ? "" : "s"} left`;
+}
+/** Whole days until the window closes, never below zero; null when the date is unreadable. */
+export function couponDaysLeft(validUntil, now = Date.now()) {
+    const end = new Date(validUntil).getTime();
+    if (!Number.isFinite(end))
+        return null;
+    return Math.max(0, Math.ceil((end - now) / 86_400_000));
+}
+export function couponExpiryText(validUntil, now = Date.now()) {
+    const days = couponDaysLeft(validUntil, now);
+    if (days === null)
+        return null;
+    return days === 0 ? "expires today" : `expires in ${days} day${days === 1 ? "" : "s"}`;
+}
+/** What a successful redeem_coupon says back. */
+export function redeemedText(r) {
+    const left = r.uses_remaining != null ? ` — ${r.uses_remaining} use${r.uses_remaining === 1 ? "" : "s"} left` : "";
+    return `${r.name ?? "Coupon"}: ${r.discount_percent ?? 0}% off${left}.`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tollbooth-dpyc/web",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Shared browser SDK for Tollbooth DPYC operator front ends: npub sign-in, proofs, MCP client, profile and wallet",
   "license": "Apache-2.0",
   "author": "Lonnie VanZandt",

package/theme.css

@@ -51,3 +51,25 @@
     --tb-notice-ink: #d8b4fe;
   }
 }
+
+/* An explicit dark pick (bootstrapTheme / useTheme set data-theme) wins over
+   a light OS, just as data-theme="light" wins over a dark one above. */
+:root[data-theme="dark"] {
+  --tb-accent: #7aa7ff;
+  --tb-on-accent: #0b1220;
+  --tb-surface: #151a21;
+  --tb-surface-2: #1d232c;
+  --tb-ink: #e6ebf2;
+  --tb-muted: #9aa5b4;
+  --tb-line: #2b333e;
+  --tb-ok: #5fd39a;
+  --tb-warn-bg: #2a2110;
+  --tb-warn-line: #5c4717;
+  --tb-warn-ink: #f2cf7a;
+  --tb-err-bg: #2c1515;
+  --tb-err-line: #5e2525;
+  --tb-err-ink: #f4a3a3;
+  --tb-notice-bg: #241532;
+  --tb-notice-line: #4d2d6e;
+  --tb-notice-ink: #d8b4fe;
+}