flowstack-sdk 0.2.1

package/dist/types-BmCPwbGH.d.mts

@@ -0,0 +1,153 @@
+/**
+ * Types for the wallet module (flowstack-sdk/wallet).
+ */
+interface WalletAuthState {
+    /** Whether a wallet is connected and authenticated */
+    isConnected: boolean;
+    /** Loading state during auth */
+    isLoading: boolean;
+    /** Connected wallet address (checksummed) */
+    address: string | null;
+    /** Whether this is a Privy embedded wallet (vs MetaMask) */
+    isEmbeddedWallet: boolean;
+    /** Auth method used */
+    authMethod: 'privy' | 'siwe' | null;
+    /** Error message if auth failed */
+    error: string | null;
+}
+interface UseWalletAuthReturn extends WalletAuthState {
+    /** Login via Privy (email/Google) or external wallet (MetaMask) */
+    login: (method?: 'privy' | 'wallet') => Promise<void>;
+    /** Disconnect wallet and clear session */
+    logout: () => void;
+}
+interface InferBalance {
+    /** Raw on-chain balance in wei */
+    balanceWei: string;
+    /** Held amount in wei (pending query charges) */
+    heldWei: string;
+    /** Available balance in wei (balance - held) */
+    availableWei: string;
+    /** Human-readable INFER token balance */
+    balance: number;
+    /** Human-readable available balance */
+    available: number;
+    /** Number of queries this balance can cover */
+    queryCredits: number;
+}
+interface UseInferBalanceReturn {
+    /** Current balance data (null if not loaded) */
+    data: InferBalance | null;
+    /** Whether balance is being fetched */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Manually refresh balance */
+    refetch: () => Promise<void>;
+}
+interface UseDepositReturn {
+    /** Execute approve + deposit flow */
+    deposit: (amount: number) => Promise<string | null>;
+    /** Whether deposit is in progress */
+    isDepositing: boolean;
+    /** Transaction hash of last deposit */
+    txHash: string | null;
+    /** Error message */
+    error: string | null;
+}
+interface UseBuyInferReturn {
+    /** Open fiat on-ramp widget */
+    buy: (amount?: number) => void;
+    /** Whether purchase flow is active */
+    isBuying: boolean;
+    /** Purchase status */
+    status: 'idle' | 'pending' | 'completed' | 'failed';
+    /** Error message */
+    error: string | null;
+}
+interface AgentBalance {
+    /** Raw on-chain AGENT balance in wei */
+    balanceWei: string;
+    /** Held amount in wei (active query charges) */
+    heldWei: string;
+    /** Available balance in wei (balance - held) */
+    availableWei: string;
+    /** Human-readable AGENT token balance */
+    balance: number;
+    /** Human-readable available AGENT balance */
+    available: number;
+    /** Number of build credits equivalent */
+    buildCredits: number;
+}
+interface UseAgentBalanceReturn {
+    /** Current AGENT balance data (null if not loaded or no wallet) */
+    data: AgentBalance | null;
+    /** Whether balance is being fetched */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Manually refresh balance */
+    refetch: () => Promise<void>;
+}
+interface NeedsAgentProps {
+    /** Minimum AGENT balance required to proceed */
+    amountNeeded: number;
+    /** Called when balance is sufficient and user clicks the gated action */
+    onProceed: () => void;
+    /** Current page URL to return to after OIF purchase (defaults to window.location.href) */
+    returnUrl?: string;
+    /** Content to show when user has sufficient AGENT */
+    children?: React.ReactNode;
+    /** OIF base URL (default: 'https://openinferencefoundation.org') */
+    oifBaseUrl?: string;
+}
+interface AppAccessStatus {
+    /** Whether the end-user has access to this built app */
+    hasAccess: boolean;
+    /** Number of free queries used this month */
+    queriesUsed: number;
+    /** Remaining free queries this month (null = unlimited — paid access) */
+    queriesRemaining: number | null;
+    /** Payment mode configured by the builder */
+    paymentMode: 'stripe' | 'agent' | 'both' | null;
+    /** One-time unlock price in USD cents (null = free or not configured) */
+    unlockPriceCents: number | null;
+    /** Human-readable unlock price label */
+    unlockPriceLabel: string | null;
+}
+interface UseAppAccessReturn extends AppAccessStatus {
+    /** Whether the access check is being fetched */
+    isLoading: boolean;
+    /** Error message if the status check failed */
+    error: string | null;
+    /** Open Stripe Checkout to unlock this app */
+    checkout: (opts?: {
+        successUrl?: string;
+        cancelUrl?: string;
+    }) => Promise<void>;
+    /** Manually refresh the access status */
+    refetch: () => Promise<void>;
+}
+interface AppPaywallProps {
+    /** Site ID of the built app (typically config.appScope) */
+    siteId: string;
+    /** Builder's tenant ID — needed to load app config */
+    builderTenantId?: string;
+    /** Content to show when the user has access */
+    children: React.ReactNode;
+    /** Called when the backend returns an app_paywall SSE event */
+    onBlocked?: (reason: string) => void;
+}
+interface WalletProviderProps {
+    children: React.ReactNode;
+    /** Privy app ID (enables embedded wallet flow) */
+    privyAppId?: string;
+    /** Chain to use */
+    chain?: 'arbitrum-sepolia' | 'arbitrum';
+    /** Casino API base URL */
+    baseUrl?: string;
+    /** WalletConnect v2 Cloud project ID — enables the WalletConnect connector in Privy's login modal */
+    walletConnectProjectId?: string;
+}
+
+export type { AppPaywallProps as A, InferBalance as I, NeedsAgentProps as N, UseWalletAuthReturn as U, WalletProviderProps as W, UseInferBalanceReturn as a, UseAgentBalanceReturn as b, UseDepositReturn as c, UseBuyInferReturn as d, UseAppAccessReturn as e, WalletAuthState as f, AgentBalance as g, AppAccessStatus as h };

package/dist/types-BmCPwbGH.d.ts

@@ -0,0 +1,153 @@
+/**
+ * Types for the wallet module (flowstack-sdk/wallet).
+ */
+interface WalletAuthState {
+    /** Whether a wallet is connected and authenticated */
+    isConnected: boolean;
+    /** Loading state during auth */
+    isLoading: boolean;
+    /** Connected wallet address (checksummed) */
+    address: string | null;
+    /** Whether this is a Privy embedded wallet (vs MetaMask) */
+    isEmbeddedWallet: boolean;
+    /** Auth method used */
+    authMethod: 'privy' | 'siwe' | null;
+    /** Error message if auth failed */
+    error: string | null;
+}
+interface UseWalletAuthReturn extends WalletAuthState {
+    /** Login via Privy (email/Google) or external wallet (MetaMask) */
+    login: (method?: 'privy' | 'wallet') => Promise<void>;
+    /** Disconnect wallet and clear session */
+    logout: () => void;
+}
+interface InferBalance {
+    /** Raw on-chain balance in wei */
+    balanceWei: string;
+    /** Held amount in wei (pending query charges) */
+    heldWei: string;
+    /** Available balance in wei (balance - held) */
+    availableWei: string;
+    /** Human-readable INFER token balance */
+    balance: number;
+    /** Human-readable available balance */
+    available: number;
+    /** Number of queries this balance can cover */
+    queryCredits: number;
+}
+interface UseInferBalanceReturn {
+    /** Current balance data (null if not loaded) */
+    data: InferBalance | null;
+    /** Whether balance is being fetched */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Manually refresh balance */
+    refetch: () => Promise<void>;
+}
+interface UseDepositReturn {
+    /** Execute approve + deposit flow */
+    deposit: (amount: number) => Promise<string | null>;
+    /** Whether deposit is in progress */
+    isDepositing: boolean;
+    /** Transaction hash of last deposit */
+    txHash: string | null;
+    /** Error message */
+    error: string | null;
+}
+interface UseBuyInferReturn {
+    /** Open fiat on-ramp widget */
+    buy: (amount?: number) => void;
+    /** Whether purchase flow is active */
+    isBuying: boolean;
+    /** Purchase status */
+    status: 'idle' | 'pending' | 'completed' | 'failed';
+    /** Error message */
+    error: string | null;
+}
+interface AgentBalance {
+    /** Raw on-chain AGENT balance in wei */
+    balanceWei: string;
+    /** Held amount in wei (active query charges) */
+    heldWei: string;
+    /** Available balance in wei (balance - held) */
+    availableWei: string;
+    /** Human-readable AGENT token balance */
+    balance: number;
+    /** Human-readable available AGENT balance */
+    available: number;
+    /** Number of build credits equivalent */
+    buildCredits: number;
+}
+interface UseAgentBalanceReturn {
+    /** Current AGENT balance data (null if not loaded or no wallet) */
+    data: AgentBalance | null;
+    /** Whether balance is being fetched */
+    isLoading: boolean;
+    /** Error message */
+    error: string | null;
+    /** Manually refresh balance */
+    refetch: () => Promise<void>;
+}
+interface NeedsAgentProps {
+    /** Minimum AGENT balance required to proceed */
+    amountNeeded: number;
+    /** Called when balance is sufficient and user clicks the gated action */
+    onProceed: () => void;
+    /** Current page URL to return to after OIF purchase (defaults to window.location.href) */
+    returnUrl?: string;
+    /** Content to show when user has sufficient AGENT */
+    children?: React.ReactNode;
+    /** OIF base URL (default: 'https://openinferencefoundation.org') */
+    oifBaseUrl?: string;
+}
+interface AppAccessStatus {
+    /** Whether the end-user has access to this built app */
+    hasAccess: boolean;
+    /** Number of free queries used this month */
+    queriesUsed: number;
+    /** Remaining free queries this month (null = unlimited — paid access) */
+    queriesRemaining: number | null;
+    /** Payment mode configured by the builder */
+    paymentMode: 'stripe' | 'agent' | 'both' | null;
+    /** One-time unlock price in USD cents (null = free or not configured) */
+    unlockPriceCents: number | null;
+    /** Human-readable unlock price label */
+    unlockPriceLabel: string | null;
+}
+interface UseAppAccessReturn extends AppAccessStatus {
+    /** Whether the access check is being fetched */
+    isLoading: boolean;
+    /** Error message if the status check failed */
+    error: string | null;
+    /** Open Stripe Checkout to unlock this app */
+    checkout: (opts?: {
+        successUrl?: string;
+        cancelUrl?: string;
+    }) => Promise<void>;
+    /** Manually refresh the access status */
+    refetch: () => Promise<void>;
+}
+interface AppPaywallProps {
+    /** Site ID of the built app (typically config.appScope) */
+    siteId: string;
+    /** Builder's tenant ID — needed to load app config */
+    builderTenantId?: string;
+    /** Content to show when the user has access */
+    children: React.ReactNode;
+    /** Called when the backend returns an app_paywall SSE event */
+    onBlocked?: (reason: string) => void;
+}
+interface WalletProviderProps {
+    children: React.ReactNode;
+    /** Privy app ID (enables embedded wallet flow) */
+    privyAppId?: string;
+    /** Chain to use */
+    chain?: 'arbitrum-sepolia' | 'arbitrum';
+    /** Casino API base URL */
+    baseUrl?: string;
+    /** WalletConnect v2 Cloud project ID — enables the WalletConnect connector in Privy's login modal */
+    walletConnectProjectId?: string;
+}
+
+export type { AppPaywallProps as A, InferBalance as I, NeedsAgentProps as N, UseWalletAuthReturn as U, WalletProviderProps as W, UseInferBalanceReturn as a, UseAgentBalanceReturn as b, UseDepositReturn as c, UseBuyInferReturn as d, UseAppAccessReturn as e, WalletAuthState as f, AgentBalance as g, AppAccessStatus as h };

package/dist/wallet/index.d.mts

@@ -0,0 +1,195 @@
+import { U as UseWalletAuthReturn, a as UseInferBalanceReturn, b as UseAgentBalanceReturn, c as UseDepositReturn, d as UseBuyInferReturn, e as UseAppAccessReturn, W as WalletProviderProps, N as NeedsAgentProps, A as AppPaywallProps } from '../types-BmCPwbGH.mjs';
+export { g as AgentBalance, h as AppAccessStatus, I as InferBalance, f as WalletAuthState } from '../types-BmCPwbGH.mjs';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { createConfig } from '@privy-io/wagmi';
+import React from 'react';
+
+/**
+ * useWalletAuth — handles both Privy (embedded) and SIWE (external) auth paths.
+ *
+ * Both paths produce the same result: a JWT with a wallet_address claim
+ * stored via the existing FlowstackProvider credential flow.
+ */
+
+declare function useWalletAuth(): UseWalletAuthReturn;
+
+/**
+ * useInferBalance — polls the backend for INFER token balance.
+ *
+ * Uses GET /billing/infer/balance which reads on-chain balance
+ * and subtracts active holds.
+ */
+
+declare function useInferBalance(): UseInferBalanceReturn;
+
+/**
+ * useAgentBalance — polls the backend for AGENT token balance.
+ *
+ * Uses GET /billing/agent/balance which reads on-chain AGENT balance
+ * from the AgentPayment contract and subtracts active holds.
+ */
+
+declare function useAgentBalance(): UseAgentBalanceReturn;
+
+/**
+ * useDeposit — approve + deposit INFER tokens into InferencePayment contract.
+ *
+ * For crypto-native users who already have INFER tokens.
+ * Handles the two-step ERC-20 flow: approve → deposit.
+ */
+
+declare function useDeposit(chain?: string): UseDepositReturn;
+
+/**
+ * useBuyInfer — opens fiat on-ramp widget (MoonPay/Transak).
+ *
+ * Handles: credit card → INFER → auto-deposit. User never touches crypto.
+ * The on-ramp provider delivers INFER to the user's embedded wallet,
+ * then the SDK auto-deposits into InferencePayment.
+ */
+
+interface BuyInferOptions {
+    /** MoonPay or Transak API key */
+    apiKey?: string;
+    /** sandbox or production */
+    environment?: 'sandbox' | 'production';
+    /** Wallet address to receive INFER */
+    walletAddress?: string;
+}
+declare function useBuyInfer(options?: BuyInferOptions): UseBuyInferReturn;
+
+/**
+ * useAppAccess — checks whether the authenticated end-user has access to a
+ * monetized built app, and provides a checkout function to unlock it.
+ *
+ * Polls GET /billing/app-access/status every 60 seconds.
+ * On `checkout()` call, opens a Stripe Checkout session for one-time purchase.
+ *
+ * Usage:
+ *   const { hasAccess, queriesRemaining, checkout } = useAppAccess(config.appScope);
+ *   if (!hasAccess) return <AppPaywall siteId={config.appScope} ... />;
+ */
+
+declare function useAppAccess(siteId: string, opts?: {
+    builderTenantId?: string;
+}): UseAppAccessReturn;
+
+declare global {
+    interface Window {
+        __wagmiConfig?: ReturnType<typeof createConfig>;
+    }
+}
+declare function WalletProvider({ children, privyAppId, chain, baseUrl, walletConnectProjectId, }: WalletProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * LoginButton — "Sign up with Google" / "Connect Wallet" toggle.
+ *
+ * Default: Privy (email/Google) signup. Toggle to external wallet (MetaMask).
+ */
+interface LoginButtonProps {
+    /** Callback after successful auth */
+    onSuccess?: (walletAddress: string) => void;
+    /** Callback on auth error */
+    onError?: (error: string) => void;
+    /** Show wallet connect option */
+    showWalletOption?: boolean;
+    /** CSS class name */
+    className?: string;
+}
+declare function LoginButton({ onSuccess, onError, showWalletOption, className, }: LoginButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * InferBalanceBadge — shows INFER balance in a compact badge.
+ *
+ * Displays query credits remaining. Shows "Buy More" when low.
+ */
+interface InferBalanceBadgeProps {
+    /** Threshold to show "Buy More" warning */
+    lowBalanceThreshold?: number;
+    /** Callback when "Buy More" is clicked */
+    onBuyMore?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function InferBalanceBadge({ lowBalanceThreshold, onBuyMore, className, }: InferBalanceBadgeProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * AgentBalanceBadge — shows AGENT token balance in a compact badge.
+ *
+ * Displays build credits remaining. Shows "Buy More" when low.
+ */
+interface AgentBalanceBadgeProps {
+    /** Threshold to show "Buy More" warning */
+    lowBalanceThreshold?: number;
+    /** Callback when "Buy More" is clicked */
+    onBuyMore?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function AgentBalanceBadge({ lowBalanceThreshold, onBuyMore, className, }: AgentBalanceBadgeProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * NeedsAgent — gating component for AGENT-token-gated features in built apps.
+ *
+ * Checks the user's AGENT balance. If sufficient, renders children and calls
+ * onProceed when the user activates the gated action. If insufficient, renders
+ * a "Get AGENT" CTA that deep-links to the OIF /buy page with returnTo + need
+ * params so the user lands back in the app after purchasing.
+ *
+ * Usage:
+ *   <NeedsAgent amountNeeded={2} onProceed={generateAlbumArt} returnUrl={window.location.href}>
+ *     <p>Generate a new design for 2 AGENT</p>
+ *   </NeedsAgent>
+ *
+ * The user never sees a seed phrase — Privy handles wallet creation on OIF.
+ * No auth setup required in the built app: the component works for anonymous users
+ * (balance will read 0) and authenticated wallet users alike.
+ */
+
+declare function NeedsAgent({ amountNeeded, onProceed, returnUrl, children, oifBaseUrl, }: NeedsAgentProps): React.ReactElement;
+
+/**
+ * PaymentRequired — shown when user's INFER balance is insufficient (402).
+ *
+ * Displays current balance and a "Buy INFER" CTA.
+ */
+interface PaymentRequiredProps {
+    /** Current balance in query credits */
+    queryCredits?: number;
+    /** INFER tokens needed per query */
+    inferPerQuery?: number;
+    /** Callback to open buy flow */
+    onBuy?: () => void;
+    /** Callback to dismiss */
+    onDismiss?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function PaymentRequired({ queryCredits, inferPerQuery, onBuy, onDismiss, className, }: PaymentRequiredProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * BuyInferModal — fiat on-ramp widget for purchasing INFER with a credit card.
+ *
+ * Wraps MoonPay/Transak with Casino-branded pricing tiers.
+ */
+interface BuyInferModalProps {
+    /** Whether the modal is open */
+    isOpen: boolean;
+    /** Close callback */
+    onClose: () => void;
+    /** MoonPay/Transak API key */
+    apiKey: string;
+    /** sandbox or production */
+    environment?: 'sandbox' | 'production';
+    /** User's wallet address */
+    walletAddress: string;
+    /** INFER per query (for pricing display) */
+    inferPerQuery?: number;
+    /** CSS class name */
+    className?: string;
+}
+declare function BuyInferModal({ isOpen, onClose, apiKey, environment, walletAddress, inferPerQuery, className, }: BuyInferModalProps): react_jsx_runtime.JSX.Element | null;
+
+declare function AppPaywall({ siteId, builderTenantId, children, onBlocked }: AppPaywallProps): react_jsx_runtime.JSX.Element;
+
+export { AgentBalanceBadge, AppPaywall, AppPaywallProps, BuyInferModal, InferBalanceBadge, LoginButton, NeedsAgent, NeedsAgentProps, PaymentRequired, UseAgentBalanceReturn, UseAppAccessReturn, UseBuyInferReturn, UseDepositReturn, UseInferBalanceReturn, UseWalletAuthReturn, WalletProvider, WalletProviderProps, useAgentBalance, useAppAccess, useBuyInfer, useDeposit, useInferBalance, useWalletAuth };

package/dist/wallet/index.d.ts

@@ -0,0 +1,195 @@
+import { U as UseWalletAuthReturn, a as UseInferBalanceReturn, b as UseAgentBalanceReturn, c as UseDepositReturn, d as UseBuyInferReturn, e as UseAppAccessReturn, W as WalletProviderProps, N as NeedsAgentProps, A as AppPaywallProps } from '../types-BmCPwbGH.js';
+export { g as AgentBalance, h as AppAccessStatus, I as InferBalance, f as WalletAuthState } from '../types-BmCPwbGH.js';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { createConfig } from '@privy-io/wagmi';
+import React from 'react';
+
+/**
+ * useWalletAuth — handles both Privy (embedded) and SIWE (external) auth paths.
+ *
+ * Both paths produce the same result: a JWT with a wallet_address claim
+ * stored via the existing FlowstackProvider credential flow.
+ */
+
+declare function useWalletAuth(): UseWalletAuthReturn;
+
+/**
+ * useInferBalance — polls the backend for INFER token balance.
+ *
+ * Uses GET /billing/infer/balance which reads on-chain balance
+ * and subtracts active holds.
+ */
+
+declare function useInferBalance(): UseInferBalanceReturn;
+
+/**
+ * useAgentBalance — polls the backend for AGENT token balance.
+ *
+ * Uses GET /billing/agent/balance which reads on-chain AGENT balance
+ * from the AgentPayment contract and subtracts active holds.
+ */
+
+declare function useAgentBalance(): UseAgentBalanceReturn;
+
+/**
+ * useDeposit — approve + deposit INFER tokens into InferencePayment contract.
+ *
+ * For crypto-native users who already have INFER tokens.
+ * Handles the two-step ERC-20 flow: approve → deposit.
+ */
+
+declare function useDeposit(chain?: string): UseDepositReturn;
+
+/**
+ * useBuyInfer — opens fiat on-ramp widget (MoonPay/Transak).
+ *
+ * Handles: credit card → INFER → auto-deposit. User never touches crypto.
+ * The on-ramp provider delivers INFER to the user's embedded wallet,
+ * then the SDK auto-deposits into InferencePayment.
+ */
+
+interface BuyInferOptions {
+    /** MoonPay or Transak API key */
+    apiKey?: string;
+    /** sandbox or production */
+    environment?: 'sandbox' | 'production';
+    /** Wallet address to receive INFER */
+    walletAddress?: string;
+}
+declare function useBuyInfer(options?: BuyInferOptions): UseBuyInferReturn;
+
+/**
+ * useAppAccess — checks whether the authenticated end-user has access to a
+ * monetized built app, and provides a checkout function to unlock it.
+ *
+ * Polls GET /billing/app-access/status every 60 seconds.
+ * On `checkout()` call, opens a Stripe Checkout session for one-time purchase.
+ *
+ * Usage:
+ *   const { hasAccess, queriesRemaining, checkout } = useAppAccess(config.appScope);
+ *   if (!hasAccess) return <AppPaywall siteId={config.appScope} ... />;
+ */
+
+declare function useAppAccess(siteId: string, opts?: {
+    builderTenantId?: string;
+}): UseAppAccessReturn;
+
+declare global {
+    interface Window {
+        __wagmiConfig?: ReturnType<typeof createConfig>;
+    }
+}
+declare function WalletProvider({ children, privyAppId, chain, baseUrl, walletConnectProjectId, }: WalletProviderProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * LoginButton — "Sign up with Google" / "Connect Wallet" toggle.
+ *
+ * Default: Privy (email/Google) signup. Toggle to external wallet (MetaMask).
+ */
+interface LoginButtonProps {
+    /** Callback after successful auth */
+    onSuccess?: (walletAddress: string) => void;
+    /** Callback on auth error */
+    onError?: (error: string) => void;
+    /** Show wallet connect option */
+    showWalletOption?: boolean;
+    /** CSS class name */
+    className?: string;
+}
+declare function LoginButton({ onSuccess, onError, showWalletOption, className, }: LoginButtonProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * InferBalanceBadge — shows INFER balance in a compact badge.
+ *
+ * Displays query credits remaining. Shows "Buy More" when low.
+ */
+interface InferBalanceBadgeProps {
+    /** Threshold to show "Buy More" warning */
+    lowBalanceThreshold?: number;
+    /** Callback when "Buy More" is clicked */
+    onBuyMore?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function InferBalanceBadge({ lowBalanceThreshold, onBuyMore, className, }: InferBalanceBadgeProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * AgentBalanceBadge — shows AGENT token balance in a compact badge.
+ *
+ * Displays build credits remaining. Shows "Buy More" when low.
+ */
+interface AgentBalanceBadgeProps {
+    /** Threshold to show "Buy More" warning */
+    lowBalanceThreshold?: number;
+    /** Callback when "Buy More" is clicked */
+    onBuyMore?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function AgentBalanceBadge({ lowBalanceThreshold, onBuyMore, className, }: AgentBalanceBadgeProps): react_jsx_runtime.JSX.Element | null;
+
+/**
+ * NeedsAgent — gating component for AGENT-token-gated features in built apps.
+ *
+ * Checks the user's AGENT balance. If sufficient, renders children and calls
+ * onProceed when the user activates the gated action. If insufficient, renders
+ * a "Get AGENT" CTA that deep-links to the OIF /buy page with returnTo + need
+ * params so the user lands back in the app after purchasing.
+ *
+ * Usage:
+ *   <NeedsAgent amountNeeded={2} onProceed={generateAlbumArt} returnUrl={window.location.href}>
+ *     <p>Generate a new design for 2 AGENT</p>
+ *   </NeedsAgent>
+ *
+ * The user never sees a seed phrase — Privy handles wallet creation on OIF.
+ * No auth setup required in the built app: the component works for anonymous users
+ * (balance will read 0) and authenticated wallet users alike.
+ */
+
+declare function NeedsAgent({ amountNeeded, onProceed, returnUrl, children, oifBaseUrl, }: NeedsAgentProps): React.ReactElement;
+
+/**
+ * PaymentRequired — shown when user's INFER balance is insufficient (402).
+ *
+ * Displays current balance and a "Buy INFER" CTA.
+ */
+interface PaymentRequiredProps {
+    /** Current balance in query credits */
+    queryCredits?: number;
+    /** INFER tokens needed per query */
+    inferPerQuery?: number;
+    /** Callback to open buy flow */
+    onBuy?: () => void;
+    /** Callback to dismiss */
+    onDismiss?: () => void;
+    /** CSS class name */
+    className?: string;
+}
+declare function PaymentRequired({ queryCredits, inferPerQuery, onBuy, onDismiss, className, }: PaymentRequiredProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * BuyInferModal — fiat on-ramp widget for purchasing INFER with a credit card.
+ *
+ * Wraps MoonPay/Transak with Casino-branded pricing tiers.
+ */
+interface BuyInferModalProps {
+    /** Whether the modal is open */
+    isOpen: boolean;
+    /** Close callback */
+    onClose: () => void;
+    /** MoonPay/Transak API key */
+    apiKey: string;
+    /** sandbox or production */
+    environment?: 'sandbox' | 'production';
+    /** User's wallet address */
+    walletAddress: string;
+    /** INFER per query (for pricing display) */
+    inferPerQuery?: number;
+    /** CSS class name */
+    className?: string;
+}
+declare function BuyInferModal({ isOpen, onClose, apiKey, environment, walletAddress, inferPerQuery, className, }: BuyInferModalProps): react_jsx_runtime.JSX.Element | null;
+
+declare function AppPaywall({ siteId, builderTenantId, children, onBlocked }: AppPaywallProps): react_jsx_runtime.JSX.Element;
+
+export { AgentBalanceBadge, AppPaywall, AppPaywallProps, BuyInferModal, InferBalanceBadge, LoginButton, NeedsAgent, NeedsAgentProps, PaymentRequired, UseAgentBalanceReturn, UseAppAccessReturn, UseBuyInferReturn, UseDepositReturn, UseInferBalanceReturn, UseWalletAuthReturn, WalletProvider, WalletProviderProps, useAgentBalance, useAppAccess, useBuyInfer, useDeposit, useInferBalance, useWalletAuth };