@tangle-network/sandbox-ui 0.18.0 → 0.20.1

package/dist/dashboard.d.ts

@@ -149,6 +149,54 @@ interface CreditBalanceProps {
 }
 declare function CreditBalance({ amount, description, onTopUp, quickAmounts, className, }: CreditBalanceProps): react_jsx_runtime.JSX.Element;
 
+/**
+ * Canonical "out of credits" UX, shared across every Tangle product.
+ *
+ * Backends emit a 402 with `{ error, code: "insufficient_balance", manageUrl,
+ * plan?, remainingBalanceUsd? }` when a billable action can't be funded. The
+ * frontend catches it, calls {@link parseInsufficientBalance} to extract the
+ * shape, and renders {@link OutOfCreditsModal} — a single "add credits /
+ * subscribe" CTA that links to the platform billing page (`manageUrl`).
+ *
+ * This replaces the per-app bespoke handling (silent failures, raw errors,
+ * un-clickable text) with one component so the funnel is uniform + testable.
+ */
+declare const INSUFFICIENT_BALANCE_CODE = "insufficient_balance";
+interface InsufficientBalance {
+    /** Platform billing URL to add credits / subscribe / connect a card. */
+    manageUrl: string;
+    /** Current plan, when the backend includes it. */
+    plan?: string;
+    /** Remaining balance (USD), when included. */
+    remainingBalanceUsd?: number;
+    /** Backend-supplied human message, when included. */
+    message?: string;
+}
+/**
+ * Detect + parse an insufficient-balance 402 from a parsed JSON body. Returns
+ * the typed shape when the body is an insufficient-balance error, else `null`.
+ * Falls back to the platform default billing URL when the backend omits
+ * `manageUrl` so the CTA is never dead.
+ */
+declare function parseInsufficientBalance(payload: unknown, opts?: {
+    defaultManageUrl?: string;
+}): InsufficientBalance | null;
+interface OutOfCreditsModalProps {
+    /** Parsed insufficient-balance details (from {@link parseInsufficientBalance}). */
+    balance: InsufficientBalance | null;
+    /** Dismiss handler. When omitted the modal cannot be closed (hard paywall). */
+    onClose?: () => void;
+    /** Override the primary CTA label. Default "Add credits". */
+    ctaLabel?: string;
+    className?: string;
+}
+/**
+ * Modal shown when a user runs out of credits. Renders nothing when
+ * `balance` is null. The primary CTA opens the platform billing page where
+ * the user can add credits, subscribe, or connect a card for pay-per-use.
+ */
+declare function OutOfCreditsModal({ balance, onClose, ctaLabel, className, }: OutOfCreditsModalProps): react_jsx_runtime.JSX.Element | null;
+
 interface ClusterStatusItem {
     icon?: React.ReactNode;
     label: string;
@@ -622,4 +670,4 @@ interface InfoPanelProps {
 }
 declare function InfoPanel({ label, title, description, className }: InfoPanelProps): react_jsx_runtime.JSX.Element;
 
-export { type Backend, BackendConfig, type BackendConfigProps, BackendSelector, type BackendSelectorProps, type BackendStatusData, ClusterStatusBar, type ClusterStatusBarProps, type ClusterStatusItem, CreditBalance, type CreditBalanceProps, DashboardLayout, type DashboardLayoutProps, type Profile as DashboardProfile, type SnapshotInfo as DashboardSnapshotInfo, type DashboardUser, type ExposedPort, type GitCommitData, GitPanel, type GitPanelProps, type GitStatusData, HARNESS_OPTIONS, HarnessPicker, type HarnessPickerProps, type HarnessType, InfoPanel, type InfoPanelProps, type Invoice, InvoiceTable, type InvoiceTableProps, type McpServer, type NavItem, NetworkConfig, type NetworkConfigData, type NetworkConfigProps, NewSandboxCard, type NewSandboxCardProps, type PlanCardData, PlanCards, type PlanCardsProps, type PlanFeature, PortsList, type PortsListProps, type ProcessInfo, ProcessList, type ProcessListProps, type ProductVariant, ProfileAvatar, type ProfileAvatarProps, ProfileComparison, type ProfileComparisonProps, ProfileSelector, type ProfileSelectorProps, PromoBanner, type PromoBannerProps, RailButton, type RailButtonProps, RailModeButton, type RailModeButtonProps, RailSeparator, type RailSeparatorProps, ResourceMeter, type ResourceMeterProps, SIDEBAR_MOBILE_WIDTH, SIDEBAR_PANEL_WIDTH, SIDEBAR_RAIL_WIDTH, SIDEBAR_TOTAL_WIDTH, SandboxCard, type SandboxCardData, type SandboxCardProps, type SandboxStatus, SandboxTable, type SandboxTableProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarPanel, SidebarPanelContent, type SidebarPanelContentProps, SidebarPanelHeader, type SidebarPanelHeaderProps, type SidebarPanelProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarRailFooter, type SidebarRailFooterProps, SidebarRailHeader, type SidebarRailHeaderProps, SidebarRailNav, type SidebarRailNavProps, type SidebarRailProps, type SidebarUser, SnapshotList, type SnapshotListProps, SystemLogsViewer, type SystemLogsViewerProps, type TeamRole, UsageSummary, type UsageSummaryData, type UsageSummaryProps, type Variant, VariantList, type VariantListProps, type VariantOutcome, type VariantStatus, canAdminSandbox, useSidebar };
+export { type Backend, BackendConfig, type BackendConfigProps, BackendSelector, type BackendSelectorProps, type BackendStatusData, ClusterStatusBar, type ClusterStatusBarProps, type ClusterStatusItem, CreditBalance, type CreditBalanceProps, DashboardLayout, type DashboardLayoutProps, type Profile as DashboardProfile, type SnapshotInfo as DashboardSnapshotInfo, type DashboardUser, type ExposedPort, type GitCommitData, GitPanel, type GitPanelProps, type GitStatusData, HARNESS_OPTIONS, HarnessPicker, type HarnessPickerProps, type HarnessType, INSUFFICIENT_BALANCE_CODE, InfoPanel, type InfoPanelProps, type InsufficientBalance, type Invoice, InvoiceTable, type InvoiceTableProps, type McpServer, type NavItem, NetworkConfig, type NetworkConfigData, type NetworkConfigProps, NewSandboxCard, type NewSandboxCardProps, OutOfCreditsModal, type OutOfCreditsModalProps, type PlanCardData, PlanCards, type PlanCardsProps, type PlanFeature, PortsList, type PortsListProps, type ProcessInfo, ProcessList, type ProcessListProps, type ProductVariant, ProfileAvatar, type ProfileAvatarProps, ProfileComparison, type ProfileComparisonProps, ProfileSelector, type ProfileSelectorProps, PromoBanner, type PromoBannerProps, RailButton, type RailButtonProps, RailModeButton, type RailModeButtonProps, RailSeparator, type RailSeparatorProps, ResourceMeter, type ResourceMeterProps, SIDEBAR_MOBILE_WIDTH, SIDEBAR_PANEL_WIDTH, SIDEBAR_RAIL_WIDTH, SIDEBAR_TOTAL_WIDTH, SandboxCard, type SandboxCardData, type SandboxCardProps, type SandboxStatus, SandboxTable, type SandboxTableProps, Sidebar, SidebarContent, type SidebarContentProps, SidebarPanel, SidebarPanelContent, type SidebarPanelContentProps, SidebarPanelHeader, type SidebarPanelHeaderProps, type SidebarPanelProps, type SidebarProps, SidebarProvider, type SidebarProviderProps, SidebarRail, SidebarRailFooter, type SidebarRailFooterProps, SidebarRailHeader, type SidebarRailHeaderProps, SidebarRailNav, type SidebarRailNavProps, type SidebarRailProps, type SidebarUser, SnapshotList, type SnapshotListProps, SystemLogsViewer, type SystemLogsViewerProps, type TeamRole, UsageSummary, type UsageSummaryData, type UsageSummaryProps, type Variant, VariantList, type VariantListProps, type VariantOutcome, type VariantStatus, canAdminSandbox, parseInsufficientBalance, useSidebar };

package/dist/dashboard.js

@@ -7,9 +7,11 @@ import {
   GitPanel,
   HARNESS_OPTIONS,
   HarnessPicker,
+  INSUFFICIENT_BALANCE_CODE,
   InvoiceTable,
   NetworkConfig,
   NewSandboxCard,
+  OutOfCreditsModal,
   PlanCards,
   PortsList,
   ProcessList,
@@ -42,8 +44,9 @@ import {
   UsageSummary,
   VariantList,
   canAdminSandbox,
+  parseInsufficientBalance,
   useSidebar
-} from "./chunk-5I363RL7.js";
+} from "./chunk-R6QNJQRH.js";
 import {
   BillingDashboard,
   InfoPanel,
@@ -68,11 +71,13 @@ export {
   GitPanel,
   HARNESS_OPTIONS,
   HarnessPicker,
+  INSUFFICIENT_BALANCE_CODE,
   InfoPanel,
   InvoiceTable,
   ModelPicker,
   NetworkConfig,
   NewSandboxCard,
+  OutOfCreditsModal,
   PlanCards,
   PortsList,
   PricingPage,
@@ -112,5 +117,6 @@ export {
   formatContext,
   formatPrice,
   formatPricing,
+  parseInsufficientBalance,
   useSidebar
 };