@stigmer/react 0.3.3 → 0.4.0

package/billing/LowBalanceBanner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LowBalanceBanner.js","sourceRoot":"","sources":["../../src/billing/LowBalanceBanner.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAY/C;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,gBAAgB,CAAC,EAC/B,eAAe,EACf,eAAe,EACf,SAAS,GACa;IACtB,IAAI,eAAe,IAAI,eAAe;QAAE,OAAO,IAAI,CAAC;IAEpD,MAAM,gBAAgB,GAAG,eAAe,IAAI,MAAM,CAAC,CAAC,CAAC,CAAC;IAEtD,OAAO,CACL,eACE,IAAI,EAAC,OAAO,EACZ,SAAS,EAAE,EAAE,CACX,gEAAgE,EAChE,gBAAgB;YACd,CAAC,CAAC,yDAAyD;YAC3D,CAAC,CAAC,wDAAwD,EAC5D,SAAS,CACV,aAED,KAAC,aAAa,IAAC,SAAS,EAAC,0BAA0B,iBAAa,MAAM,GAAG,EACzE,0BACE,YAAG,SAAS,EAAC,aAAa,YACvB,gBAAgB;4BACf,CAAC,CAAC,0BAA0B;4BAC5B,CAAC,CAAC,oBAAoB,GACtB,EACJ,YAAG,SAAS,EAAC,mBAAmB,YAC7B,gBAAgB;4BACf,CAAC,CAAC,qFAAqF;4BACvF,CAAC,CAAC,iBAAiB,mBAAmB,CAAC,eAAe,CAAC,2EAA2E,GAClI,IACA,IACF,CACP,CAAC;AACJ,CAAC"}

package/billing/PaymentMethodCard.d.ts

@@ -0,0 +1,35 @@
+import type { PaymentMethodSummary } from "@stigmer/protos/ai/stigmer/billing/v1/billing_account_pb";
+import { BillingAccountStatus } from "@stigmer/protos/ai/stigmer/billing/v1/enum_pb";
+/** Props for {@link PaymentMethodCard}. */
+export interface PaymentMethodCardProps {
+    /** The saved payment method, or undefined if none is on file. */
+    readonly paymentMethod?: PaymentMethodSummary;
+    /** Account status — portal button disabled when suspended or closed. */
+    readonly accountStatus: BillingAccountStatus;
+    /** `true` while the portal session is being created. */
+    readonly isPortalLoading?: boolean;
+    /** Called when the user clicks "Manage payment methods". */
+    readonly onManage: () => void;
+    /** Additional CSS class names. */
+    readonly className?: string;
+}
+/**
+ * Displays the saved payment method with a button to open the
+ * Stripe Customer Portal for management.
+ *
+ * Shows card brand, last 4 digits, and expiry when a payment method
+ * is on file. Shows an empty state prompt when none exists. The
+ * "Manage" button opens the Stripe Customer Portal where users can
+ * add, update, or remove payment methods.
+ *
+ * @example
+ * ```tsx
+ * <PaymentMethodCard
+ *   paymentMethod={account.defaultPaymentMethod}
+ *   accountStatus={account.status}
+ *   onManage={() => openPortal(orgId)}
+ * />
+ * ```
+ */
+export declare function PaymentMethodCard({ paymentMethod, accountStatus, isPortalLoading, onManage, className, }: PaymentMethodCardProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=PaymentMethodCard.d.ts.map

package/billing/PaymentMethodCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentMethodCard.d.ts","sourceRoot":"","sources":["../../src/billing/PaymentMethodCard.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,0DAA0D,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAErF,2CAA2C;AAC3C,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAC9C,wEAAwE;IACxE,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,wDAAwD;IACxD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,EAAE,MAAM,IAAI,CAAC;IAC9B,kCAAkC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAsBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,aAAa,EACb,aAAa,EACb,eAAe,EACf,QAAQ,EACR,SAAS,GACV,EAAE,sBAAsB,2CA0DxB"}

package/billing/PaymentMethodCard.js

@@ -0,0 +1,48 @@
+"use client";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "@stigmer/theme";
+import { BillingAccountStatus } from "@stigmer/protos/ai/stigmer/billing/v1/enum_pb";
+const BRAND_DISPLAY = {
+    visa: "Visa",
+    mastercard: "Mastercard",
+    amex: "American Express",
+    discover: "Discover",
+    diners: "Diners Club",
+    jcb: "JCB",
+    unionpay: "UnionPay",
+};
+function formatBrand(brand) {
+    return BRAND_DISPLAY[brand.toLowerCase()] ?? brand;
+}
+function formatExpiry(month, year) {
+    const m = String(month).padStart(2, "0");
+    const y = String(year).slice(-2);
+    return `${m}/${y}`;
+}
+/**
+ * Displays the saved payment method with a button to open the
+ * Stripe Customer Portal for management.
+ *
+ * Shows card brand, last 4 digits, and expiry when a payment method
+ * is on file. Shows an empty state prompt when none exists. The
+ * "Manage" button opens the Stripe Customer Portal where users can
+ * add, update, or remove payment methods.
+ *
+ * @example
+ * ```tsx
+ * <PaymentMethodCard
+ *   paymentMethod={account.defaultPaymentMethod}
+ *   accountStatus={account.status}
+ *   onManage={() => openPortal(orgId)}
+ * />
+ * ```
+ */
+export function PaymentMethodCard({ paymentMethod, accountStatus, isPortalLoading, onManage, className, }) {
+    const isAccountActive = accountStatus === BillingAccountStatus.billing_account_active;
+    const hasPm = paymentMethod != null && paymentMethod.paymentMethodId !== "";
+    return (_jsxs("div", { className: cn("rounded-lg border border-border bg-card px-4 py-4", className), children: [_jsxs("div", { className: "flex items-center justify-between", children: [_jsx("h3", { className: "text-xs font-semibold text-foreground", children: "Payment Method" }), hasPm && (_jsx("button", { type: "button", disabled: !isAccountActive || isPortalLoading, onClick: onManage, className: cn("rounded-md px-2.5 py-1 text-xs font-medium transition-colors", "text-muted-foreground hover:bg-accent hover:text-foreground", "disabled:pointer-events-none disabled:opacity-50"), "aria-busy": isPortalLoading, children: isPortalLoading ? "Opening\u2026" : "Manage" }))] }), hasPm ? (_jsxs("div", { className: "mt-2 flex items-center gap-3", children: [_jsx(CardBrandIcon, { brand: paymentMethod.brand }), _jsxs("div", { children: [_jsxs("div", { className: "text-sm font-medium text-foreground", children: [formatBrand(paymentMethod.brand), " \u00B7\u00B7\u00B7\u00B7", " ", paymentMethod.last4] }), _jsxs("div", { className: "text-xs text-muted-foreground", children: ["Expires", " ", formatExpiry(paymentMethod.expMonth, paymentMethod.expYear)] })] })] })) : (_jsx("div", { className: "mt-2", children: _jsx("p", { className: "text-xs text-muted-foreground", children: "No payment method on file. A card will be saved automatically when you purchase your first credit pack." }) }))] }));
+}
+function CardBrandIcon({ brand }) {
+    return (_jsx("div", { className: "flex size-9 items-center justify-center rounded-md border border-border bg-background", children: _jsx("span", { className: "text-[0.6rem] font-bold uppercase text-muted-foreground", children: brand.slice(0, 4) }) }));
+}
+//# sourceMappingURL=PaymentMethodCard.js.map

package/billing/PaymentMethodCard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PaymentMethodCard.js","sourceRoot":"","sources":["../../src/billing/PaymentMethodCard.tsx"],"names":[],"mappings":"AAAA,YAAY,CAAC;;AAEb,OAAO,EAAE,EAAE,EAAE,MAAM,gBAAgB,CAAC;AAEpC,OAAO,EAAE,oBAAoB,EAAE,MAAM,+CAA+C,CAAC;AAgBrF,MAAM,aAAa,GAA2B;IAC5C,IAAI,EAAE,MAAM;IACZ,UAAU,EAAE,YAAY;IACxB,IAAI,EAAE,kBAAkB;IACxB,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,aAAa;IACrB,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;CACrB,CAAC;AAEF,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,aAAa,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,IAAI,KAAK,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,IAAY;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IACzC,MAAM,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,OAAO,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;AACrB,CAAC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAChC,aAAa,EACb,aAAa,EACb,eAAe,EACf,QAAQ,EACR,SAAS,GACc;IACvB,MAAM,eAAe,GACnB,aAAa,KAAK,oBAAoB,CAAC,sBAAsB,CAAC;IAChE,MAAM,KAAK,GACT,aAAa,IAAI,IAAI,IAAI,aAAa,CAAC,eAAe,KAAK,EAAE,CAAC;IAEhE,OAAO,CACL,eACE,SAAS,EAAE,EAAE,CACX,mDAAmD,EACnD,SAAS,CACV,aAED,eAAK,SAAS,EAAC,mCAAmC,aAChD,aAAI,SAAS,EAAC,uCAAuC,+BAEhD,EACJ,KAAK,IAAI,CACR,iBACE,IAAI,EAAC,QAAQ,EACb,QAAQ,EAAE,CAAC,eAAe,IAAI,eAAe,EAC7C,OAAO,EAAE,QAAQ,EACjB,SAAS,EAAE,EAAE,CACX,8DAA8D,EAC9D,6DAA6D,EAC7D,kDAAkD,CACnD,eACU,eAAe,YAEzB,eAAe,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,QAAQ,GACtC,CACV,IACG,EAEL,KAAK,CAAC,CAAC,CAAC,CACP,eAAK,SAAS,EAAC,8BAA8B,aAC3C,KAAC,aAAa,IAAC,KAAK,EAAE,aAAa,CAAC,KAAK,GAAI,EAC7C,0BACE,eAAK,SAAS,EAAC,qCAAqC,aACjD,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,+BAAO,GAAG,EAC1C,aAAa,CAAC,KAAK,IAChB,EACN,eAAK,SAAS,EAAC,+BAA+B,wBACpC,GAAG,EACV,YAAY,CAAC,aAAa,CAAC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,IACxD,IACF,IACF,CACP,CAAC,CAAC,CAAC,CACF,cAAK,SAAS,EAAC,MAAM,YACnB,YAAG,SAAS,EAAC,+BAA+B,wHAGxC,GACA,CACP,IACG,CACP,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,EAAE,KAAK,EAAqB;IACjD,OAAO,CACL,cAAK,SAAS,EAAC,uFAAuF,YACpG,eAAM,SAAS,EAAC,yDAAyD,YACtE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,GACb,GACH,CACP,CAAC;AACJ,CAAC"}

package/billing/credit-packs.d.ts

@@ -0,0 +1,25 @@
+/** Metadata for a self-serve credit pack. */
+export interface CreditPackInfo {
+    /** Stable identifier matching the backend catalog (e.g., "starter"). */
+    readonly packId: string;
+    /** Display name shown in the UI. */
+    readonly displayName: string;
+    /** Brief description of the pack's positioning. */
+    readonly description: string;
+    /** Price in USD cents (e.g., 1000 = $10.00). */
+    readonly priceCents: number;
+    /** Number of credits granted (1 credit = $0.01 USD). */
+    readonly credits: number;
+}
+/**
+ * Static credit pack catalog matching the backend `CreditPackCatalog`.
+ *
+ * Packs are static product entries, not database-backed resources.
+ * At launch, credits equal the dollar value (no volume bonus).
+ */
+export declare const CREDIT_PACKS: readonly CreditPackInfo[];
+/** Format a cent amount as a dollar string (e.g., 1000 -> "$10"). */
+export declare function formatPackPrice(cents: number): string;
+/** Format a credit count with commas (e.g., 5000 -> "5,000"). */
+export declare function formatCreditCount(credits: number): string;
+//# sourceMappingURL=credit-packs.d.ts.map

package/billing/credit-packs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-packs.d.ts","sourceRoot":"","sources":["../../src/billing/credit-packs.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,WAAW,cAAc;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,EAAE,SAAS,cAAc,EAsBjD,CAAC;AAEF,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEzD"}

package/billing/credit-packs.js

@@ -0,0 +1,39 @@
+/**
+ * Static credit pack catalog matching the backend `CreditPackCatalog`.
+ *
+ * Packs are static product entries, not database-backed resources.
+ * At launch, credits equal the dollar value (no volume bonus).
+ */
+export const CREDIT_PACKS = [
+    {
+        packId: "starter",
+        displayName: "Starter",
+        description: "For trying things out",
+        priceCents: 1_000,
+        credits: 1_000,
+    },
+    {
+        packId: "growth",
+        displayName: "Growth",
+        description: "For growing teams",
+        priceCents: 5_000,
+        credits: 5_000,
+    },
+    {
+        packId: "team",
+        displayName: "Team",
+        description: "For production workloads",
+        priceCents: 20_000,
+        credits: 20_000,
+    },
+];
+/** Format a cent amount as a dollar string (e.g., 1000 -> "$10"). */
+export function formatPackPrice(cents) {
+    const dollars = cents / 100;
+    return dollars % 1 === 0 ? `$${dollars}` : `$${dollars.toFixed(2)}`;
+}
+/** Format a credit count with commas (e.g., 5000 -> "5,000"). */
+export function formatCreditCount(credits) {
+    return credits.toLocaleString("en-US");
+}
+//# sourceMappingURL=credit-packs.js.map

package/billing/credit-packs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-packs.js","sourceRoot":"","sources":["../../src/billing/credit-packs.ts"],"names":[],"mappings":"AAcA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAA8B;IACrD;QACE,MAAM,EAAE,SAAS;QACjB,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,uBAAuB;QACpC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,MAAM,EAAE,QAAQ;QAChB,WAAW,EAAE,QAAQ;QACrB,WAAW,EAAE,mBAAmB;QAChC,UAAU,EAAE,KAAK;QACjB,OAAO,EAAE,KAAK;KACf;IACD;QACE,MAAM,EAAE,MAAM;QACd,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,0BAA0B;QACvC,UAAU,EAAE,MAAM;QAClB,OAAO,EAAE,MAAM;KAChB;CACF,CAAC;AAEF,qEAAqE;AACrE,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,GAAG,GAAG,CAAC;IAC5B,OAAO,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;AACtE,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,OAAO,OAAO,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;AACzC,CAAC"}

package/billing/format.d.ts

@@ -0,0 +1,39 @@
+import { LedgerEntryType } from "@stigmer/protos/ai/stigmer/billing/v1/enum_pb";
+/**
+ * Convert micro-USD (bigint) to a display string like "$12.50".
+ *
+ * Micro-USD uses 6 decimal places (1 USD = 1,000,000 micros).
+ * The output always shows exactly 2 decimal places.
+ */
+export declare function formatCreditBalance(micros: bigint | undefined): string;
+/**
+ * Convert micro-USD (bigint) to a signed display string.
+ *
+ * Positive amounts show "+$5.00", negative show "-$0.23",
+ * zero shows "$0.00" (no sign).
+ */
+export declare function formatLedgerAmount(micros: bigint): string;
+/** Human-readable label for a ledger entry type. */
+export declare function ledgerEntryLabel(type: LedgerEntryType): string;
+/**
+ * Whether a ledger entry type represents a credit (positive amount).
+ *
+ * Used by UI components to choose semantic colors: green for credits,
+ * red for debits, gray for holds/releases.
+ */
+export declare function isCredit(type: LedgerEntryType): boolean;
+/**
+ * Whether a ledger entry type represents a hold operation.
+ *
+ * Holds are neither credits nor debits in the user's mental model —
+ * they represent temporary balance changes (reservations, disputes).
+ */
+export declare function isHold(type: LedgerEntryType): boolean;
+/**
+ * Format a protobuf Timestamp for ledger display.
+ *
+ * Returns a locale-appropriate date and time string
+ * (e.g., "May 3, 2026, 4:30 PM").
+ */
+export declare function formatLedgerDate(seconds: bigint): string;
+//# sourceMappingURL=format.d.ts.map

package/billing/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/billing/format.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AAEhF;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAKtE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAQzD;AAiBD,oDAAoD;AACpD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,eAAe,GAAG,MAAM,CAE9D;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CASvD;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAKrD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CASxD"}

package/billing/format.js

@@ -0,0 +1,90 @@
+import { LedgerEntryType } from "@stigmer/protos/ai/stigmer/billing/v1/enum_pb";
+/**
+ * Convert micro-USD (bigint) to a display string like "$12.50".
+ *
+ * Micro-USD uses 6 decimal places (1 USD = 1,000,000 micros).
+ * The output always shows exactly 2 decimal places.
+ */
+export function formatCreditBalance(micros) {
+    if (micros === undefined)
+        return "$0.00";
+    const cents = Number(micros) / 10_000;
+    const dollars = cents / 100;
+    return `$${dollars.toFixed(2)}`;
+}
+/**
+ * Convert micro-USD (bigint) to a signed display string.
+ *
+ * Positive amounts show "+$5.00", negative show "-$0.23",
+ * zero shows "$0.00" (no sign).
+ */
+export function formatLedgerAmount(micros) {
+    const zero = BigInt(0);
+    const absMicros = micros < zero ? -micros : micros;
+    const dollars = Number(absMicros) / 1_000_000;
+    const formatted = `$${dollars.toFixed(2)}`;
+    if (micros > zero)
+        return `+${formatted}`;
+    if (micros < zero)
+        return `-${formatted}`;
+    return formatted;
+}
+const ENTRY_LABELS = {
+    [LedgerEntryType.purchase_credit]: "Credit Purchase",
+    [LedgerEntryType.promotional_credit]: "Promotional Credit",
+    [LedgerEntryType.usage_debit]: "Usage",
+    [LedgerEntryType.reservation_hold]: "Reservation Hold",
+    [LedgerEntryType.reservation_release]: "Reservation Release",
+    [LedgerEntryType.adjustment_credit]: "Admin Credit",
+    [LedgerEntryType.adjustment_debit]: "Admin Debit",
+    [LedgerEntryType.refund_reversal]: "Refund",
+    [LedgerEntryType.dispute_hold]: "Dispute Hold",
+    [LedgerEntryType.dispute_release]: "Dispute Release",
+    [LedgerEntryType.expiry_debit]: "Credit Expiry",
+    [LedgerEntryType.auto_recharge_credit]: "Auto-Recharge",
+};
+/** Human-readable label for a ledger entry type. */
+export function ledgerEntryLabel(type) {
+    return ENTRY_LABELS[type] ?? "Unknown";
+}
+/**
+ * Whether a ledger entry type represents a credit (positive amount).
+ *
+ * Used by UI components to choose semantic colors: green for credits,
+ * red for debits, gray for holds/releases.
+ */
+export function isCredit(type) {
+    return (type === LedgerEntryType.purchase_credit ||
+        type === LedgerEntryType.promotional_credit ||
+        type === LedgerEntryType.adjustment_credit ||
+        type === LedgerEntryType.reservation_release ||
+        type === LedgerEntryType.dispute_release ||
+        type === LedgerEntryType.auto_recharge_credit);
+}
+/**
+ * Whether a ledger entry type represents a hold operation.
+ *
+ * Holds are neither credits nor debits in the user's mental model —
+ * they represent temporary balance changes (reservations, disputes).
+ */
+export function isHold(type) {
+    return (type === LedgerEntryType.reservation_hold ||
+        type === LedgerEntryType.dispute_hold);
+}
+/**
+ * Format a protobuf Timestamp for ledger display.
+ *
+ * Returns a locale-appropriate date and time string
+ * (e.g., "May 3, 2026, 4:30 PM").
+ */
+export function formatLedgerDate(seconds) {
+    const date = new Date(Number(seconds) * 1000);
+    return new Intl.DateTimeFormat("en-US", {
+        month: "short",
+        day: "numeric",
+        year: "numeric",
+        hour: "numeric",
+        minute: "2-digit",
+    }).format(date);
+}
+//# sourceMappingURL=format.js.map

package/billing/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/billing/format.ts"],"names":[],"mappings":"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"}

package/billing/index.d.ts

@@ -0,0 +1,32 @@
+export { useBillingAccount } from "./useBillingAccount";
+export type { UseBillingAccountReturn } from "./useBillingAccount";
+export { useCreditLedger } from "./useCreditLedger";
+export type { UseCreditLedgerReturn, UseCreditLedgerOptions } from "./useCreditLedger";
+export { useBillingUsageReport } from "./useBillingUsageReport";
+export type { UseBillingUsageReportReturn } from "./useBillingUsageReport";
+export { useCustomerModelPricing } from "./useCustomerModelPricing";
+export type { UseCustomerModelPricingReturn } from "./useCustomerModelPricing";
+export { useCreateCheckoutSession } from "./useCreateCheckoutSession";
+export type { CreateCheckoutSessionInput, UseCreateCheckoutSessionReturn, } from "./useCreateCheckoutSession";
+export { useCreateBillingPortalSession } from "./useCreateBillingPortalSession";
+export type { UseCreateBillingPortalSessionReturn } from "./useCreateBillingPortalSession";
+export { useSetAutoRechargeConfig } from "./useSetAutoRechargeConfig";
+export type { SetAutoRechargeConfigInput, UseSetAutoRechargeConfigReturn, } from "./useSetAutoRechargeConfig";
+export { BillingSection } from "./BillingSection";
+export type { BillingSectionProps } from "./BillingSection";
+export { CreditBalanceCard } from "./CreditBalanceCard";
+export type { CreditBalanceCardProps } from "./CreditBalanceCard";
+export { PaymentMethodCard } from "./PaymentMethodCard";
+export type { PaymentMethodCardProps } from "./PaymentMethodCard";
+export { AutoRechargeCard } from "./AutoRechargeCard";
+export type { AutoRechargeCardProps } from "./AutoRechargeCard";
+export { CreditPackGrid } from "./CreditPackGrid";
+export type { CreditPackGridProps } from "./CreditPackGrid";
+export { CreditLedgerTable } from "./CreditLedgerTable";
+export type { CreditLedgerTableProps } from "./CreditLedgerTable";
+export { LowBalanceBanner } from "./LowBalanceBanner";
+export type { LowBalanceBannerProps } from "./LowBalanceBanner";
+export { CREDIT_PACKS, formatPackPrice, formatCreditCount } from "./credit-packs";
+export type { CreditPackInfo } from "./credit-packs";
+export { formatCreditBalance, formatLedgerAmount, ledgerEntryLabel, isCredit, isHold, formatLedgerDate, } from "./format";
+//# sourceMappingURL=index.d.ts.map

package/billing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,YAAY,EAAE,qBAAqB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACvF,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAChE,YAAY,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACpE,YAAY,EAAE,6BAA6B,EAAE,MAAM,2BAA2B,CAAC;AAG/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAChF,YAAY,EAAE,mCAAmC,EAAE,MAAM,iCAAiC,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,YAAY,EACV,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AAGpC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,YAAY,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAClF,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

package/billing/index.js

@@ -0,0 +1,21 @@
+// Data hooks
+export { useBillingAccount } from "./useBillingAccount";
+export { useCreditLedger } from "./useCreditLedger";
+export { useBillingUsageReport } from "./useBillingUsageReport";
+export { useCustomerModelPricing } from "./useCustomerModelPricing";
+// Behavior hooks
+export { useCreateCheckoutSession } from "./useCreateCheckoutSession";
+export { useCreateBillingPortalSession } from "./useCreateBillingPortalSession";
+export { useSetAutoRechargeConfig } from "./useSetAutoRechargeConfig";
+// Styled components
+export { BillingSection } from "./BillingSection";
+export { CreditBalanceCard } from "./CreditBalanceCard";
+export { PaymentMethodCard } from "./PaymentMethodCard";
+export { AutoRechargeCard } from "./AutoRechargeCard";
+export { CreditPackGrid } from "./CreditPackGrid";
+export { CreditLedgerTable } from "./CreditLedgerTable";
+export { LowBalanceBanner } from "./LowBalanceBanner";
+// Credit pack catalog and formatting utilities
+export { CREDIT_PACKS, formatPackPrice, formatCreditCount } from "./credit-packs";
+export { formatCreditBalance, formatLedgerAmount, ledgerEntryLabel, isCredit, isHold, formatLedgerDate, } from "./format";
+//# sourceMappingURL=index.js.map

package/billing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/billing/index.ts"],"names":[],"mappings":"AAAA,aAAa;AACb,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAGpE,iBAAiB;AACjB,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAKtE,OAAO,EAAE,6BAA6B,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAMtE,oBAAoB;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAExD,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAGtD,+CAA+C;AAC/C,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAElF,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,EAChB,QAAQ,EACR,MAAM,EACN,gBAAgB,GACjB,MAAM,UAAU,CAAC"}

package/billing/useBillingAccount.d.ts

@@ -0,0 +1,40 @@
+import type { BillingAccount } from "@stigmer/protos/ai/stigmer/billing/v1/billing_account_pb";
+/** Return value of {@link useBillingAccount}. */
+export interface UseBillingAccountReturn {
+    /** The billing account, or `null` before the first successful fetch. */
+    readonly account: BillingAccount | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches the billing account for an organization.
+ *
+ * Calls `billing.getOrCreateBillingAccount` which is idempotent —
+ * creates the account on first call, returns the existing account
+ * on subsequent calls. The returned `BillingAccount` includes
+ * the embedded `CreditBalance` with available, reserved,
+ * promotional, and purchased breakdowns.
+ *
+ * Pass `null` as `orgId` to skip fetching (stable no-op).
+ *
+ * @param orgId - Organization ID, or `null` to skip.
+ *
+ * @example
+ * ```tsx
+ * const { account, isLoading, error } = useBillingAccount(orgId);
+ *
+ * if (isLoading) return <Skeleton />;
+ * if (error) return <ErrorMessage error={error} />;
+ * if (!account) return null;
+ *
+ * return <div>Balance: {formatCreditBalance(account.balance?.availableMicros)}</div>;
+ * ```
+ */
+export declare function useBillingAccount(orgId: string | null): UseBillingAccountReturn;
+//# sourceMappingURL=useBillingAccount.d.ts.map

package/billing/useBillingAccount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingAccount.d.ts","sourceRoot":"","sources":["../../src/billing/useBillingAccount.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0DAA0D,CAAC;AAI/F,iDAAiD;AACjD,MAAM,WAAW,uBAAuB;IACtC,wEAAwE;IACxE,QAAQ,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,CAAC;IACxC,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,MAAM,GAAG,IAAI,GACnB,uBAAuB,CAazB"}

package/billing/useBillingAccount.js

@@ -0,0 +1,35 @@
+"use client";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches the billing account for an organization.
+ *
+ * Calls `billing.getOrCreateBillingAccount` which is idempotent —
+ * creates the account on first call, returns the existing account
+ * on subsequent calls. The returned `BillingAccount` includes
+ * the embedded `CreditBalance` with available, reserved,
+ * promotional, and purchased breakdowns.
+ *
+ * Pass `null` as `orgId` to skip fetching (stable no-op).
+ *
+ * @param orgId - Organization ID, or `null` to skip.
+ *
+ * @example
+ * ```tsx
+ * const { account, isLoading, error } = useBillingAccount(orgId);
+ *
+ * if (isLoading) return <Skeleton />;
+ * if (error) return <ErrorMessage error={error} />;
+ * if (!account) return null;
+ *
+ * return <div>Balance: {formatCreditBalance(account.balance?.availableMicros)}</div>;
+ * ```
+ */
+export function useBillingAccount(orgId) {
+    const stigmer = useStigmer();
+    const { data: account, isLoading, isRefetching, error, refetch } = useFetch(orgId
+        ? () => stigmer.billing.getOrCreateBillingAccount(orgId)
+        : null, [orgId, stigmer], null);
+    return { account, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useBillingAccount.js.map

package/billing/useBillingAccount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingAccount.js","sourceRoot":"","sources":["../../src/billing/useBillingAccount.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAOb,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,iBAAiB,CAC/B,KAAoB;IAEpB,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACzE,KAAK;QACH,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,OAAO,CAAC,yBAAyB,CAAC,KAAK,CAAC;QACpD,CAAC,CAAC,IAAI,EACR,CAAC,KAAK,EAAE,OAAO,CAAC,EAChB,IAA6B,CAC9B,CAAC;IAEF,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC9D,CAAC"}

package/billing/useBillingUsageReport.d.ts

@@ -0,0 +1,42 @@
+import type { BillingUsageReportResponse } from "@stigmer/protos/ai/stigmer/billing/v1/io_pb";
+/** Return value of {@link useBillingUsageReport}. */
+export interface UseBillingUsageReportReturn {
+    /** The usage report, or `null` before the first successful fetch. */
+    readonly report: BillingUsageReportResponse | null;
+    /** `true` while the initial fetch is in flight. */
+    readonly isLoading: boolean;
+    /** `true` while a background refetch is in flight and stale data is shown. */
+    readonly isRefetching: boolean;
+    /** Error from the last failed request, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Discard cached data and re-fetch from the server. */
+    readonly refetch: () => void;
+}
+/**
+ * Data hook that fetches an aggregated billing usage report for a date range.
+ *
+ * Returns total provider cost, total billable amount, execution and LLM
+ * call counts, and a per-model breakdown with cost tier attribution.
+ *
+ * Pass `null` as `orgId` to skip fetching (stable no-op).
+ *
+ * @param orgId - Organization ID, or `null` to skip.
+ * @param startTime - Start of the reporting period.
+ * @param endTime - End of the reporting period.
+ *
+ * @example
+ * ```tsx
+ * const { report, isLoading } = useBillingUsageReport(
+ *   orgId,
+ *   new Date("2026-05-01"),
+ *   new Date("2026-05-31"),
+ * );
+ *
+ * if (isLoading) return <Skeleton />;
+ * if (!report) return null;
+ *
+ * return <div>Total: {formatCreditBalance(report.totalBillableAmountMicros)}</div>;
+ * ```
+ */
+export declare function useBillingUsageReport(orgId: string | null, startTime: Date, endTime: Date): UseBillingUsageReportReturn;
+//# sourceMappingURL=useBillingUsageReport.d.ts.map

package/billing/useBillingUsageReport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingUsageReport.d.ts","sourceRoot":"","sources":["../../src/billing/useBillingUsageReport.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,0BAA0B,EAC3B,MAAM,6CAA6C,CAAC;AAIrD,qDAAqD;AACrD,MAAM,WAAW,2BAA2B;IAC1C,qEAAqE;IACrE,QAAQ,CAAC,MAAM,EAAE,0BAA0B,GAAG,IAAI,CAAC;IACnD,mDAAmD;IACnD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,8EAA8E;IAC9E,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,wDAAwD;IACxD,QAAQ,CAAC,OAAO,EAAE,MAAM,IAAI,CAAC;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,SAAS,EAAE,IAAI,EACf,OAAO,EAAE,IAAI,GACZ,2BAA2B,CAoB7B"}

package/billing/useBillingUsageReport.js

@@ -0,0 +1,43 @@
+"use client";
+import { useStigmer } from "../hooks";
+import { useFetch } from "../internal/useFetch";
+/**
+ * Data hook that fetches an aggregated billing usage report for a date range.
+ *
+ * Returns total provider cost, total billable amount, execution and LLM
+ * call counts, and a per-model breakdown with cost tier attribution.
+ *
+ * Pass `null` as `orgId` to skip fetching (stable no-op).
+ *
+ * @param orgId - Organization ID, or `null` to skip.
+ * @param startTime - Start of the reporting period.
+ * @param endTime - End of the reporting period.
+ *
+ * @example
+ * ```tsx
+ * const { report, isLoading } = useBillingUsageReport(
+ *   orgId,
+ *   new Date("2026-05-01"),
+ *   new Date("2026-05-31"),
+ * );
+ *
+ * if (isLoading) return <Skeleton />;
+ * if (!report) return null;
+ *
+ * return <div>Total: {formatCreditBalance(report.totalBillableAmountMicros)}</div>;
+ * ```
+ */
+export function useBillingUsageReport(orgId, startTime, endTime) {
+    const stigmer = useStigmer();
+    const startKey = startTime.toISOString();
+    const endKey = endTime.toISOString();
+    const { data: report, isLoading, isRefetching, error, refetch } = useFetch(orgId
+        ? () => stigmer.billing.getBillingUsageReport({
+            orgId,
+            startTime,
+            endTime,
+        })
+        : null, [orgId, startKey, endKey, stigmer], null);
+    return { report, isLoading, isRefetching, error, refetch };
+}
+//# sourceMappingURL=useBillingUsageReport.js.map

package/billing/useBillingUsageReport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBillingUsageReport.js","sourceRoot":"","sources":["../../src/billing/useBillingUsageReport.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAKb,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,OAAO,EAAE,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAgBhD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAoB,EACpB,SAAe,EACf,OAAa;IAEb,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,MAAM,QAAQ,GAAG,SAAS,CAAC,WAAW,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAErC,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,QAAQ,CACxE,KAAK;QACH,CAAC,CAAC,GAAG,EAAE,CACH,OAAO,CAAC,OAAO,CAAC,qBAAqB,CAAC;YACpC,KAAK;YACL,SAAS;YACT,OAAO;SACR,CAAC;QACN,CAAC,CAAC,IAAI,EACR,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAClC,IAAyC,CAC1C,CAAC;IAEF,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC"}

package/billing/useCreateBillingPortalSession.d.ts

@@ -0,0 +1,35 @@
+/** Return value of {@link useCreateBillingPortalSession}. */
+export interface UseCreateBillingPortalSessionReturn {
+    /**
+     * Open the Stripe Customer Portal for payment method management.
+     *
+     * On success, redirects the user to the Stripe-hosted portal page.
+     * The promise resolves before the redirect occurs.
+     */
+    readonly openPortal: (orgId: string) => Promise<void>;
+    /** `true` while the portal session is being created. */
+    readonly isLoading: boolean;
+    /** Error from the last failed attempt, or `null` when healthy. */
+    readonly error: Error | null;
+    /** Reset `error` to `null`. */
+    readonly clearError: () => void;
+}
+/**
+ * Behavior hook that opens the Stripe Customer Portal for payment
+ * method management.
+ *
+ * Wraps `billing.createBillingPortalSession` with loading and error
+ * state management. On success, redirects the user to the Stripe-hosted
+ * portal. Payment method changes are synced back via webhooks.
+ *
+ * @example
+ * ```tsx
+ * const { openPortal, isLoading } = useCreateBillingPortalSession();
+ *
+ * <button onClick={() => openPortal(orgId)} disabled={isLoading}>
+ *   Manage payment methods
+ * </button>
+ * ```
+ */
+export declare function useCreateBillingPortalSession(): UseCreateBillingPortalSessionReturn;
+//# sourceMappingURL=useCreateBillingPortalSession.d.ts.map

package/billing/useCreateBillingPortalSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCreateBillingPortalSession.d.ts","sourceRoot":"","sources":["../../src/billing/useCreateBillingPortalSession.ts"],"names":[],"mappings":"AAMA,6DAA6D;AAC7D,MAAM,WAAW,mCAAmC;IAClD;;;;;OAKG;IACH,QAAQ,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,kEAAkE;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,6BAA6B,IAAI,mCAAmC,CAmCnF"}