@dubsdotapp/expo 0.1.0

package/src/index.ts

@@ -0,0 +1,83 @@
+// Core
+export { DubsClient } from './client';
+export type { DubsClientConfig } from './client';
+export { DubsApiError, parseSolanaError, SOLANA_PROGRAM_ERRORS } from './errors';
+export { DEFAULT_BASE_URL, DEFAULT_RPC_URL } from './constants';
+
+// Types
+export type {
+  UnifiedEvent,
+  Opponent,
+  EventMedia,
+  EventStream,
+  EventMeta,
+  Pagination,
+  EsportsMatchDetail,
+  EsportsMatchOpponent,
+  EsportsMatchResult,
+  ValidateEventResult,
+  CreateGameParams,
+  CreateGameResult,
+  JoinGameParams,
+  JoinGameResult,
+  ConfirmGameParams,
+  ConfirmGameResult,
+  BuildClaimParams,
+  BuildClaimResult,
+  GameDetail,
+  GameMedia,
+  GameListItem,
+  GameListOpponent,
+  GetGamesParams,
+  GetNetworkGamesParams,
+  GetUpcomingEventsParams,
+  ParsedError,
+  SolanaErrorCode,
+  MutationStatus,
+  QueryResult,
+  MutationResult,
+  DubsUser,
+  DubsPublicUser,
+  DubsAppUser,
+  NonceResult,
+  AuthenticateParams,
+  AuthenticateResult,
+  RegisterParams,
+  RegisterResult,
+  CheckUsernameResult,
+  AuthStatus,
+} from './types';
+
+// Provider
+export { DubsProvider, useDubs } from './provider';
+export type { DubsProviderProps, DubsContextValue } from './provider';
+
+// Wallet
+export type { WalletAdapter } from './wallet';
+export { MwaWalletAdapter } from './wallet';
+export type { MwaAdapterConfig, MwaTransactFn } from './wallet';
+
+// Hooks
+export {
+  useEvents,
+  useGame,
+  useGames,
+  useNetworkGames,
+  useCreateGame,
+  useJoinGame,
+  useClaim,
+  useAuth,
+} from './hooks';
+export type {
+  CreateGameMutationResult,
+  JoinGameMutationResult,
+  ClaimMutationResult,
+  UseAuthResult,
+} from './hooks';
+
+// UI
+export { ConnectWalletScreen, UserProfileCard, SettingsSheet, useDubsTheme } from './ui';
+export type { ConnectWalletScreenProps, UserProfileCardProps, SettingsSheetProps, DubsTheme } from './ui';
+
+// Utils
+export { signAndSendBase64Transaction, pollTransactionConfirmation } from './utils/transaction';

package/src/provider.tsx

@@ -0,0 +1,39 @@
+import React, { createContext, useContext, useMemo } from 'react';
+import { Connection } from '@solana/web3.js';
+import { DubsClient } from './client';
+import { DEFAULT_RPC_URL } from './constants';
+import type { WalletAdapter } from './wallet/types';
+
+export interface DubsContextValue {
+  client: DubsClient;
+  wallet: WalletAdapter;
+  connection: Connection;
+}
+
+const DubsContext = createContext<DubsContextValue | null>(null);
+
+export interface DubsProviderProps {
+  apiKey: string;
+  baseUrl?: string;
+  rpcUrl?: string;
+  wallet: WalletAdapter;
+  children: React.ReactNode;
+}
+
+export function DubsProvider({ apiKey, baseUrl, rpcUrl, wallet, children }: DubsProviderProps) {
+  const value = useMemo<DubsContextValue>(() => {
+    const client = new DubsClient({ apiKey, baseUrl });
+    const connection = new Connection(rpcUrl || DEFAULT_RPC_URL, { commitment: 'confirmed' });
+    return { client, wallet, connection };
+  }, [apiKey, baseUrl, rpcUrl, wallet]);
+
+  return <DubsContext.Provider value={value}>{children}</DubsContext.Provider>;
+}
+
+export function useDubs(): DubsContextValue {
+  const ctx = useContext(DubsContext);
+  if (!ctx) {
+    throw new Error('useDubs must be used within a <DubsProvider>');
+  }
+  return ctx;
+}

package/src/types.ts

@@ -0,0 +1,340 @@
+// ── Unified Event (returned by /events/upcoming, /sports/events/:league, /esports/matches/upcoming) ──
+
+export interface Opponent {
+  name: string | null;
+  imageUrl: string | null;
+  score: number | null;
+}
+
+export interface EventMedia {
+  poster: string | null;
+  thumbnail: string | null;
+  streams: EventStream[];
+}
+
+export interface EventStream {
+  url: string | null;
+  language: string | null;
+}
+
+export interface EventMeta {
+  matchType: string | null;
+  numberOfGames: number | null;
+  tournament: string | null;
+  country: string | null;
+}
+
+export interface UnifiedEvent {
+  id: string;
+  type: 'sports' | 'esports';
+  title: string;
+  league: string | null;
+  game: string | null;
+  startTime: string | null;
+  status: 'upcoming' | 'live' | 'finished' | 'canceled';
+  tier: string | null;
+  venue: string | null;
+  opponents: Opponent[];
+  media: EventMedia;
+  meta: EventMeta;
+}
+
+export interface Pagination {
+  page: number;
+  perPage: number;
+  total: number;
+  totalPages: number;
+}
+
+// ── Esports Match Detail (returned by /esports/matches/:matchId) ──
+
+export interface EsportsMatchOpponent {
+  id: number;
+  name: string;
+  acronym: string | null;
+  imageUrl: string | null;
+}
+
+export interface EsportsMatchResult {
+  teamId: number;
+  score: number;
+}
+
+export interface EsportsMatchDetail {
+  matchId: number;
+  title: string;
+  status: string;
+  videogame: string | null;
+  league: string | null;
+  serie: string | null;
+  tournament: string | null;
+  tier: string | null;
+  startTime: string | null;
+  endTime: string | null;
+  matchType: string | null;
+  numberOfGames: number | null;
+  opponents: EsportsMatchOpponent[];
+  results: EsportsMatchResult[];
+  winnerId: number | null;
+}
+
+// ── Validate Event ──
+
+export interface ValidateEventResult {
+  bettable: boolean;
+  gameMode: number;
+  lockTimestamp: number;
+  startTime: string | null;
+  status: string;
+}
+
+// ── Create Game ──
+
+export interface CreateGameParams {
+  id: string;
+  playerWallet: string;
+  teamChoice: 'home' | 'away' | 'draw';
+  wagerAmount: number;
+}
+
+export interface CreateGameResult {
+  gameId: string;
+  gameAddress: string;
+  transaction: string;
+  lockTimestamp: number;
+  event: UnifiedEvent;
+}
+
+// ── Join Game ──
+
+export interface JoinGameParams {
+  playerWallet: string;
+  gameId: string;
+  teamChoice: 'home' | 'away' | 'draw';
+  amount: number;
+}
+
+export interface JoinGameResult {
+  gameId: string;
+  transaction: string;
+  gameAddress: string;
+}
+
+// ── Confirm Game ──
+
+export interface ConfirmGameParams {
+  gameId: string;
+  playerWallet: string;
+  signature: string;
+  teamChoice?: 'home' | 'away' | 'draw';
+  wagerAmount?: number;
+  role?: 'creator' | 'joiner';
+  gameAddress?: string;
+}
+
+export interface ConfirmGameResult {
+  gameId: string;
+  signature: string;
+  explorerUrl: string;
+  message: string;
+}
+
+// ── Build Claim Transaction ──
+
+export interface BuildClaimParams {
+  playerWallet: string;
+  gameId: string;
+}
+
+export interface BuildClaimResult {
+  transaction: string;
+  gameAddress: string;
+  message: string;
+}
+
+// ── Game Detail (returned by /games/:gameId) ──
+
+export interface GameMedia {
+  poster: string | null;
+  thumbnail: string | null;
+}
+
+export interface GameDetail {
+  gameId: string;
+  gameAddress: string;
+  title: string;
+  buyIn: number;
+  gameMode: number;
+  isLocked: boolean;
+  isResolved: boolean;
+  status: string;
+  lockTimestamp: number | null;
+  homePlayers: string[];
+  awayPlayers: string[];
+  drawPlayers: string[];
+  homePool: number;
+  awayPool: number;
+  drawPool: number;
+  totalPool: number;
+  sportsEvent: Record<string, unknown> | null;
+  media: GameMedia;
+  createdAt: string;
+  updatedAt: string;
+}
+
+// ── Game List Item (returned by /games) ──
+
+export interface GameListOpponent {
+  name: string | null;
+  imageUrl: string | null;
+}
+
+export interface GameListItem {
+  gameId: string;
+  title: string;
+  buyIn: number;
+  gameMode: number;
+  isLocked: boolean;
+  isResolved: boolean;
+  status: string;
+  totalPool: number;
+  league: string | null;
+  lockTimestamp: number | null;
+  createdAt: string;
+  opponents: GameListOpponent[];
+  media: GameMedia;
+}
+
+export interface GetGamesParams {
+  wallet?: string;
+  status?: 'open' | 'locked' | 'resolved';
+  limit?: number;
+  offset?: number;
+}
+
+// ── Network Games Query ──
+
+export interface GetNetworkGamesParams {
+  league?: string;
+  limit?: number;
+  offset?: number;
+}
+
+// ── Upcoming Events Query ──
+
+export interface GetUpcomingEventsParams {
+  type?: 'sports' | 'esports';
+  game?: string;
+  page?: number;
+  per_page?: number;
+}
+
+// ── Error Parsing ──
+
+export interface ParsedError {
+  code: string;
+  message: string;
+}
+
+export interface SolanaErrorCode {
+  code: string;
+  message: string;
+}
+
+// ── User Auth ──
+
+export interface DubsUser {
+  walletAddress: string;
+  username: string;
+  avatar: string | null;
+  myReferralCode: string | null;
+  onboardingComplete: boolean;
+  createdAt: string;
+}
+
+export interface DubsPublicUser {
+  walletAddress: string;
+  username: string;
+  avatar: string | null;
+  createdAt: string;
+}
+
+export interface DubsAppUser extends DubsPublicUser {
+  firstSeenAt: string;
+  lastSeenAt: string;
+}
+
+export interface NonceResult {
+  nonce: string;
+  message: string;
+}
+
+export interface AuthenticateParams {
+  walletAddress: string;
+  signature: string;
+  nonce: string;
+}
+
+export interface AuthenticateResult {
+  needsRegistration: boolean;
+  user?: DubsUser;
+  token?: string;
+}
+
+export interface RegisterParams {
+  walletAddress: string;
+  signature: string;
+  nonce: string;
+  username: string;
+  referralCode?: string;
+}
+
+export interface RegisterResult {
+  user: DubsUser;
+  token: string;
+}
+
+export interface CheckUsernameResult {
+  available: boolean;
+  reason?: string;
+}
+
+export type AuthStatus =
+  | 'idle'
+  | 'authenticating'
+  | 'signing'
+  | 'verifying'
+  | 'needsRegistration'
+  | 'registering'
+  | 'authenticated'
+  | 'error';
+
+// ── Mutation Hook Status ──
+
+export type MutationStatus =
+  | 'idle'
+  | 'building'
+  | 'signing'
+  | 'confirming'
+  | 'saving'
+  | 'success'
+  | 'error';
+
+// ── Query Hook Result ──
+
+export interface QueryResult<T> {
+  data: T | null;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => void;
+}
+
+// ── Mutation Hook Result ──
+
+export interface MutationResult<TParams, TResult> {
+  execute: (params: TParams) => Promise<TResult>;
+  status: MutationStatus;
+  error: Error | null;
+  data: TResult | null;
+  reset: () => void;
+}

package/src/ui/ConnectWalletScreen.tsx

@@ -0,0 +1,145 @@
+import React from 'react';
+import {
+  View,
+  Text,
+  TouchableOpacity,
+  ActivityIndicator,
+  StyleSheet,
+} from 'react-native';
+import { useDubsTheme } from './theme';
+
+export interface ConnectWalletScreenProps {
+  /** Called when the user taps Connect Wallet */
+  onConnect: () => void | Promise<void>;
+  /** Show a loading spinner on the button while connecting */
+  connecting?: boolean;
+  /** Error message to display (e.g. "User rejected the request") */
+  error?: string | null;
+  /** App name shown in the header. Defaults to "Dubs" */
+  appName?: string;
+}
+
+export function ConnectWalletScreen({
+  onConnect,
+  connecting = false,
+  error = null,
+  appName = 'Dubs',
+}: ConnectWalletScreenProps) {
+  const t = useDubsTheme();
+
+  return (
+    <View style={[styles.container, { backgroundColor: t.background }]}>
+      <View style={styles.content}>
+        {/* Branding */}
+        <View style={styles.brandingSection}>
+          <View style={[styles.logoCircle, { backgroundColor: t.accent }]}>
+            <Text style={styles.logoText}>D</Text>
+          </View>
+          <Text style={[styles.appName, { color: t.text }]}>{appName}</Text>
+          <Text style={[styles.subtitle, { color: t.textMuted }]}>
+            Connect your Solana wallet to get started
+          </Text>
+        </View>
+
+        {/* Action */}
+        <View style={styles.actionSection}>
+          {error ? (
+            <View
+              style={[
+                styles.errorBox,
+                { backgroundColor: t.errorBg, borderColor: t.errorBorder },
+              ]}
+            >
+              <Text style={[styles.errorText, { color: t.errorText }]}>{error}</Text>
+            </View>
+          ) : null}
+
+          <TouchableOpacity
+            style={[styles.connectButton, { backgroundColor: t.accent }]}
+            onPress={onConnect}
+            disabled={connecting}
+            activeOpacity={0.8}
+          >
+            {connecting ? (
+              <ActivityIndicator color="#FFFFFF" size="small" />
+            ) : (
+              <Text style={styles.connectButtonText}>Connect Wallet</Text>
+            )}
+          </TouchableOpacity>
+
+          <Text style={[styles.hint, { color: t.textDim }]}>
+            Phantom, Solflare, or any Solana wallet
+          </Text>
+        </View>
+      </View>
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    justifyContent: 'center',
+  },
+  content: {
+    flex: 1,
+    justifyContent: 'space-between',
+    paddingHorizontal: 32,
+    paddingTop: 120,
+    paddingBottom: 80,
+  },
+  brandingSection: {
+    alignItems: 'center',
+    gap: 12,
+  },
+  logoCircle: {
+    width: 80,
+    height: 80,
+    borderRadius: 40,
+    justifyContent: 'center',
+    alignItems: 'center',
+    marginBottom: 8,
+  },
+  logoText: {
+    fontSize: 36,
+    fontWeight: '800',
+    color: '#FFFFFF',
+  },
+  appName: {
+    fontSize: 32,
+    fontWeight: '800',
+  },
+  subtitle: {
+    fontSize: 16,
+    textAlign: 'center',
+    lineHeight: 22,
+  },
+  actionSection: {
+    gap: 16,
+  },
+  errorBox: {
+    borderWidth: 1,
+    borderRadius: 12,
+    paddingHorizontal: 16,
+    paddingVertical: 12,
+  },
+  errorText: {
+    fontSize: 14,
+    textAlign: 'center',
+  },
+  connectButton: {
+    height: 56,
+    borderRadius: 16,
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+  connectButtonText: {
+    color: '#FFFFFF',
+    fontSize: 18,
+    fontWeight: '700',
+  },
+  hint: {
+    fontSize: 13,
+    textAlign: 'center',
+  },
+});