@cedros/login-react 0.0.42 → 0.0.44

package/dist/index.d.ts

@@ -89,6 +89,22 @@ export declare interface AccreditationPendingListResponse {
     total: number;
 }
 
+/**
+ * Item returned by GET /admin/accreditation/pending — includes user context.
+ */
+export declare interface AccreditationQueueItem extends AccreditationSubmissionItem {
+    userId: string;
+    userEmail?: string;
+}
+
+/**
+ * Response for GET /admin/accreditation/pending (queue list variant)
+ */
+export declare interface AccreditationQueueListResponse {
+    items: AccreditationQueueItem[];
+    total: number;
+}
+
 /** Overall accreditation status for a user. */
 export declare type AccreditationStatus = 'none' | 'pending' | 'approved' | 'rejected' | 'expired';
 
@@ -150,6 +166,28 @@ export declare interface AcknowledgeRecoveryRequest {
     confirmed: boolean;
 }
 
+/**
+ * Admin accreditation review queue.
+ *
+ * Inputs: className.
+ * Outputs: renders tabbed queue; approves/rejects submissions via API.
+ * Errors: displayed inline per row and globally.
+ */
+export declare function AdminAccreditationQueue({ className }: AdminAccreditationQueueProps): JSX.Element;
+
+/**
+ * Admin queue for reviewing accredited investor submissions.
+ *
+ * Tabs: Pending | All
+ * Each row is expandable to show submission detail, documents, and the
+ * approve/reject review form.
+ *
+ * Requires system admin privileges.
+ */
+export declare interface AdminAccreditationQueueProps {
+    className?: string;
+}
+
 /**
  * Admin-level detail view of a single submission, including documents.
  */
@@ -431,6 +469,27 @@ declare interface AdminReferredUsersResponse {
     offset: number;
 }
 
+/**
+ * Admin sanctions screening status panel.
+ *
+ * Inputs: className.
+ * Outputs: displays stats and allows force-refresh of the OFAC/sanctions cache.
+ * Errors: displayed inline with retry support.
+ */
+export declare function AdminSanctionsPanel({ className }: AdminSanctionsPanelProps): JSX.Element;
+
+/**
+ * Admin panel for sanctions screening status and cache management.
+ *
+ * Shows: sanctioned addresses count, sanctioned countries count, cache age,
+ * last refresh timestamp, and a "Force Refresh" action.
+ *
+ * Requires system admin privileges.
+ */
+export declare interface AdminSanctionsPanelProps {
+    className?: string;
+}
+
 /**
  * Section configuration for sidebar navigation.
  *
@@ -1167,6 +1226,12 @@ export declare interface CompleteAccountPromptProps {
     className?: string;
 }
 
+export declare function ComplianceSettings({ className }: ComplianceSettingsProps): JSX.Element;
+
+export declare interface ComplianceSettingsProps {
+    className?: string;
+}
+
 /** Request to create a derived wallet */
 export declare interface CreateDerivedWalletRequest {
     /** Human-readable label for the wallet (1-100 chars) */
@@ -1338,30 +1403,10 @@ declare interface CustomTokenDefinition {
 }
 
 /**
- * Unified Admin Dashboard
- *
- * A complete, ready-to-use admin panel following shadcn/ui dashboard patterns.
- *
- * @example
- * ```tsx
- * // Minimal setup - everything included
- * function AdminPage() {
- *   return <CedrosAdminDashboard />;
- * }
- *
- * // Customized sections
- * function AdminPage() {
- *   return (
- *     <CedrosAdminDashboard
- *       sections={['users', 'team', 'deposits', 'settings-auth']}
- *       title="My App Admin"
- *     />
- *   );
- * }
- * ```
+ * Types and props interfaces for CedrosAdminDashboard
  */
 /** Available dashboard sections */
-export declare type DashboardSection = 'users' | 'team' | 'referrals' | 'deposits' | 'withdrawals' | 'settings-wallet' | 'settings-auth' | 'settings-messaging' | 'settings-credits' | 'settings-server' | 'settings-images';
+export declare type DashboardSection = 'users' | 'team' | 'referrals' | 'deposits' | 'withdrawals' | 'compliance' | 'accreditation-queue' | 'sanctions' | 'settings-wallet' | 'settings-auth' | 'settings-messaging' | 'settings-credits' | 'settings-compliance' | 'settings-referrals' | 'settings-server' | 'settings-images';
 
 declare type DeepPartial<T> = {
     [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P];
@@ -3036,6 +3081,12 @@ declare interface ReferralInfo {
     directPayoutEnabled: boolean;
 }
 
+export declare function ReferralSettings({ className }: ReferralSettingsProps): JSX.Element;
+
+export declare interface ReferralSettingsProps {
+    className?: string;
+}
+
 /**
  * A single user entry in the referral network response
  */
@@ -3109,6 +3160,53 @@ export declare interface RevokeAllSessionsResponse {
     message: string;
 }
 
+declare interface RewardHistoryItem {
+    id: string;
+    triggerType: string;
+    amount: number;
+    currency: string;
+    status: string;
+    txSignature: string | null;
+    createdAt: string;
+    completedAt: string | null;
+}
+
+declare interface RewardsHistoryResponse {
+    items: RewardHistoryItem[];
+    total: number;
+}
+
+declare interface RewardsInfo {
+    totalEarned: number;
+    pendingAmount: number;
+    pendingCount: number;
+    currency: string;
+    rewardType: string;
+    payoutWalletAddress: string | null;
+    referralCount: number;
+}
+
+/**
+ * Self-contained rewards dashboard panel.
+ *
+ * Shows a summary of earned rewards, pending payouts, referral count,
+ * a payout wallet editor (for direct_payout mode), and a paginated history
+ * table with Solana explorer links.
+ *
+ * @example
+ * ```tsx
+ * <RewardsPanel explorerUrl="https://explorer.solana.com" />
+ * ```
+ */
+export declare function RewardsPanel({ explorerUrl, className }: RewardsPanelProps): JSX.Element;
+
+export declare interface RewardsPanelProps {
+    /** Solana explorer URL base (default: https://explorer.solana.com) */
+    explorerUrl?: string;
+    /** Additional CSS class */
+    className?: string;
+}
+
 /**
  * Request to rotate user secret (re-encrypt Share A)
  *
@@ -3135,6 +3233,17 @@ export declare type RotateUserSecretRequest = UnlockCredentialRequest & {
     prfSalt?: string;
 };
 
+/**
+ * Stats returned by GET /admin/sanctions/stats
+ */
+export declare interface SanctionsStats {
+    sanctionedAddresses: number;
+    sanctionedCountries: number;
+    cacheAgeSeconds?: number;
+    lastRefreshedAt?: string;
+    configured: boolean;
+}
+
 /** Section identifier, unique within a plugin */
 export declare type SectionId = string;
 
@@ -3691,6 +3800,50 @@ export declare interface TokenBalanceEntry {
     decimals: number;
 }
 
+/**
+ * Token gate enforcement scope.
+ */
+export declare type TokenGateEnforcement = 'all' | 'deposits' | 'withdrawals';
+
+/**
+ * A single token gate rule stored in the `token_gating_rules` system setting.
+ */
+export declare interface TokenGateRule {
+    id: string;
+    name: string;
+    ruleType: TokenGateRuleType;
+    collectionAddress?: string;
+    mintAddress?: string;
+    minQuantity?: number;
+    minAmount?: string;
+    enforcement: TokenGateEnforcement;
+}
+
+/**
+ * Token gate rule type.
+ */
+export declare type TokenGateRuleType = 'nft_collection' | 'fungible_token' | 'any_nft';
+
+/**
+ * Admin settings panel for token gate rules.
+ *
+ * Inputs: className optional CSS modifier.
+ * Outputs: reads/writes `token_gating_rules` system setting as JSON.
+ * Errors: displayed inline; save errors shown near the form.
+ */
+export declare function TokenGateSettings({ className }: TokenGateSettingsProps): JSX.Element;
+
+/**
+ * Admin settings page for managing token gate rules.
+ *
+ * Rules are persisted as JSON in the `token_gating_rules` system setting.
+ * Each rule specifies a token type, address/mint, minimum hold amount, and
+ * which operations (deposits / withdrawals / all) are gated.
+ */
+export declare interface TokenGateSettingsProps {
+    className?: string;
+}
+
 /**
  * JWT token pair returned from authentication
  */
@@ -5050,6 +5203,48 @@ export declare interface UseReferralReturn {
     error: Error | null;
 }
 
+/**
+ * Hook for fetching rewards info and history, and managing payout wallet.
+ *
+ * @example
+ * ```tsx
+ * const { rewards, history, fetchRewards, fetchHistory, setPayoutWallet, isLoading } = useRewards();
+ *
+ * useEffect(() => {
+ *   fetchRewards();
+ *   fetchHistory(10, 0);
+ * }, [fetchRewards, fetchHistory]);
+ * ```
+ */
+export declare function useRewards(): UseRewardsReturn;
+
+/**
+ * Return type for the useRewards hook.
+ *
+ * Inputs: none (reads config from CedrosLoginProvider context)
+ * Outputs: rewards summary, history list, and mutation methods
+ * Errors: all methods throw on failure and set `error` state
+ * Invariants: `isLoading` is true only while a request is in flight
+ */
+export declare interface UseRewardsReturn {
+    /** Rewards summary data */
+    rewards: RewardsInfo | null;
+    /** Reward history items */
+    history: RewardHistoryItem[];
+    /** Total history count */
+    historyTotal: number;
+    /** Fetch rewards summary */
+    fetchRewards: () => Promise<RewardsInfo>;
+    /** Fetch reward history (paginated) */
+    fetchHistory: (limit?: number, offset?: number) => Promise<RewardsHistoryResponse>;
+    /** Set payout wallet address (null to clear) */
+    setPayoutWallet: (walletAddress: string | null) => Promise<void>;
+    /** Whether a request is in progress */
+    isLoading: boolean;
+    /** Error from the last operation */
+    error: Error | null;
+}
+
 /**
  * User profile settings panel.
  *