@dubsdotapp/expo 0.5.30 → 0.5.31

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dubsdotapp/expo",
-  "version": "0.5.30",
+  "version": "0.5.31",
   "description": "React Native SDK for the Dubs betting platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/client.ts

@@ -53,6 +53,7 @@ import type {
   JackpotConfig,
   BuildJackpotEnterResult,
   ConfirmJackpotEnterResult,
+  PromoCredit,
 } from './types';
 
 export interface DubsClientConfig {
@@ -592,6 +593,22 @@ export class DubsClient {
     return { round: res.round, lastWinner: res.lastWinner };
   }
 
+  /**
+   * List the authenticated user's active promo credits — codes that
+   * have been reserved to them but not yet used in a game. Includes
+   * streak-milestone unlocks (auto-minted at each 1000-dub crossing)
+   * and any manually-reserved Twitter giveaway codes.
+   */
+  async getCredits(): Promise<{ credits: PromoCredit[]; totalLamports: number; totalSOL: number }> {
+    const res = await this.request<{
+      success: true;
+      credits: PromoCredit[];
+      totalLamports: number;
+      totalSOL: number;
+    }>('GET', '/me/credits');
+    return { credits: res.credits, totalLamports: res.totalLamports, totalSOL: res.totalSOL };
+  }
+
   /** Get current round entries with odds */
   async getJackpotEntries(): Promise<{ roundId: string; entries: JackpotEntry[]; totalEntries: number }> {
     const res = await this.request<{ success: true; roundId: string; entries: JackpotEntry[]; totalEntries: number }>(

package/src/hooks/index.ts

@@ -40,3 +40,5 @@ export { useJackpotHistory } from './useJackpotHistory';
 export type { UseJackpotHistoryResult } from './useJackpotHistory';
 export { useEnterJackpot } from './useEnterJackpot';
 export type { EnterJackpotMutationResult } from './useEnterJackpot';
+export { useCredits } from './useCredits';
+export type { UseCreditsResult } from './useCredits';

package/src/hooks/useCredits.ts

@@ -0,0 +1,48 @@
+import { useState, useEffect, useCallback } from 'react';
+import { useDubs } from '../provider';
+import type { PromoCredit } from '../types';
+
+export interface UseCreditsResult {
+  credits: PromoCredit[];
+  totalLamports: number;
+  totalSOL: number;
+  loading: boolean;
+  error: Error | null;
+  refetch: () => Promise<void>;
+}
+
+/**
+ * Returns every active promo credit reserved to the authenticated user
+ * (streak-milestone unlocks + any unused Twitter giveaway codes).
+ *
+ * Credits are kept on the server (`promo_codes` table); this hook just
+ * mirrors them. After a streak shake that mints a new unlock, call
+ * `refetch()` to pull the new credit into the list immediately.
+ */
+export function useCredits(): UseCreditsResult {
+  const { client } = useDubs();
+  const [credits, setCredits] = useState<PromoCredit[]>([]);
+  const [totalLamports, setTotalLamports] = useState(0);
+  const [totalSOL, setTotalSOL] = useState(0);
+  const [loading, setLoading] = useState(false);
+  const [error, setError] = useState<Error | null>(null);
+
+  const fetch = useCallback(async () => {
+    setLoading(true);
+    setError(null);
+    try {
+      const result = await client.getCredits();
+      setCredits(result.credits);
+      setTotalLamports(result.totalLamports);
+      setTotalSOL(result.totalSOL);
+    } catch (err) {
+      setError(err instanceof Error ? err : new Error(String(err)));
+    } finally {
+      setLoading(false);
+    }
+  }, [client]);
+
+  useEffect(() => { fetch(); }, [fetch]);
+
+  return { credits, totalLamports, totalSOL, loading, error, refetch: fetch };
+}

package/src/index.ts

@@ -86,6 +86,7 @@ export type {
   JackpotConfig,
   BuildJackpotEnterResult,
   ConfirmJackpotEnterResult,
+  PromoCredit,
 } from './types';
 
 // Provider

package/src/types.ts

@@ -680,3 +680,18 @@ export interface WhatsNewPost {
   created_at: string;
   updated_at: string;
 }
+
+/**
+ * A single promo credit reserved to the authenticated user. Returned by
+ * GET /me/credits and surfaced via useCredits. `source = 'streak_milestone'`
+ * for credits auto-minted at each 1000-dub streak threshold; 'manual' for
+ * Twitter-giveaway codes typed in during onboarding.
+ */
+export interface PromoCredit {
+  id: number;
+  code: string;
+  amountLamports: number;
+  amountSOL: number;
+  awardedAt: string;
+  source: 'streak_milestone' | 'manual' | string;
+}