@bettoredge/calcutta 0.2.0 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettoredge/calcutta",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "Calcutta auction competition components for BettorEdge applications",
   "main": "src/index.ts",
   "types": "src/index.ts",
@@ -29,7 +29,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@bettoredge/styles": "^0.4.0"
+    "@bettoredge/styles": "^0.4.2"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
@@ -40,7 +40,7 @@
     "react": ">=18.3.1",
     "react-native": ">=0.76.5",
     "@expo/vector-icons": "*",
-    "@bettoredge/api": ">=0.8.0",
-    "@bettoredge/types": ">=0.5.0"
+    "@bettoredge/api": ">=0.8.3",
+    "@bettoredge/types": ">=0.5.2"
   }
 }

package/src/components/CalcuttaAuction.tsx

@@ -1,5 +1,5 @@
-import React, { useEffect, useState, useRef, useCallback } from 'react';
-import { StyleSheet, TouchableOpacity, ActivityIndicator, FlatList, ScrollView } from 'react-native';
+import React, { useEffect, useState, useRef, useCallback, useMemo } from 'react';
+import { StyleSheet, TouchableOpacity, ActivityIndicator, FlatList, ScrollView, Image, TextInput } from 'react-native';
 import { View, Text, useTheme } from '@bettoredge/styles';
 import { Ionicons } from '@expo/vector-icons';
 import type { CalcuttaEscrowProps } from '@bettoredge/types';
@@ -9,7 +9,8 @@ import { useCalcuttaEscrow } from '../hooks/useCalcuttaEscrow';
 import { useCalcuttaBid } from '../hooks/useCalcuttaBid';
 import { useCalcuttaSocket, CalcuttaPresence, CalcuttaPresencePlayer } from '../hooks/useCalcuttaSocket';
 import { useCalcuttaItemImages } from '../hooks/useCalcuttaItemImages';
-import { formatCurrency, getStatusLabel } from '../helpers/formatting';
+import { useCalcuttaPlayers } from '../hooks/useCalcuttaPlayers';
+import { formatCurrency, getStatusLabel, resolveItemImageUrl } from '../helpers/formatting';
 import { CalcuttaAuctionItem } from './CalcuttaAuctionItem';
 import { CalcuttaEscrow } from './CalcuttaEscrow';
 import { SealedBidAuction } from './sealed/SealedBidAuction';
@@ -334,6 +335,303 @@ const LiveAuction: React.FC<CalcuttaAuctionProps> = ({
     );
 };
 
+// Sweepstakes: no auction, show the player's assigned item and prize structure
+const SweepstakesWaiting: React.FC<CalcuttaAuctionProps & { competition: any }> = ({
+    calcutta_competition_id,
+    player_id,
+    onClose,
+    onManage,
+    competition,
+}) => {
+    const { theme } = useTheme();
+    const { items, rounds, participants, item_results } = useCalcuttaCompetition(calcutta_competition_id);
+    const { images: itemImages } = useCalcuttaItemImages(items);
+    const isAdmin = player_id != null && competition?.admin_id == player_id;
+
+    // Build player lookup for owner usernames
+    const ownerIds = items.filter(i => i.winning_player_id).map(i => i.winning_player_id!);
+    const { players: enrichedPlayers } = useCalcuttaPlayers(ownerIds);
+
+    const [searchQuery, setSearchQuery] = useState('');
+
+    const [expandedRound, setExpandedRound] = useState<string | null>(null);
+
+    const myItem = items.find(i => i.winning_player_id == player_id);
+    const sortedRounds = [...(rounds ?? [])].sort((a, b) => a.round_number - b.round_number);
+
+    const filteredItems = useMemo(() => {
+        if (!searchQuery.trim()) return items;
+        const q = searchQuery.toLowerCase().trim();
+        return items.filter(item => {
+            if (item.item_name.toLowerCase().includes(q)) return true;
+            if (item.winning_player_id) {
+                const owner = enrichedPlayers[item.winning_player_id];
+                const ownerName = (owner?.username || owner?.show_name || '').toLowerCase();
+                if (ownerName.includes(q)) return true;
+            }
+            return false;
+        });
+    }, [items, searchQuery, enrichedPlayers]);
+    const statusLabel = competition.status === 'inprogress' ? 'In Progress'
+        : competition.status === 'closed' ? 'Completed' : 'Scheduled';
+
+    const statusColor = competition.status === 'inprogress' ? '#8B5CF6'
+        : competition.status === 'closed' ? '#6B7280'
+        : '#10B981';
+
+    return (
+        <View variant="transparent" style={styles.container}>
+            <ScrollView style={{ flex: 1 }} contentContainerStyle={{ gap: 16, paddingBottom: 40 }}>
+                {/* Hero with embedded title */}
+                <View style={{ position: 'relative' }}>
+                    {competition.image?.url ? (
+                        <Image source={{ uri: competition.image.url }} style={{ width: '100%', aspectRatio: 16 / 9 }} resizeMode="cover" />
+                    ) : (
+                        <View variant="transparent" style={{ width: '100%', aspectRatio: 16 / 9, backgroundColor: '#1e1b4b' }} />
+                    )}
+                    {/* Dark overlay for text readability */}
+                    <View variant="transparent" style={{ position: 'absolute', left: 0, right: 0, bottom: 0, height: '70%', backgroundColor: 'rgba(0,0,0,0.5)' }} />
+                    {/* Top bar: status badge + manage */}
+                    <View variant="transparent" style={{ position: 'absolute', top: 12, left: 16, right: 16, flexDirection: 'row', justifyContent: 'space-between', alignItems: 'center' }}>
+                        <View variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', backgroundColor: statusColor + '30', paddingHorizontal: 10, paddingVertical: 4, borderRadius: 12, gap: 6 }}>
+                            <View variant="transparent" style={{ width: 6, height: 6, borderRadius: 3, backgroundColor: statusColor }} />
+                            <Text variant="caption" bold style={{ color: statusColor }}>{statusLabel}</Text>
+                        </View>
+                        {isAdmin && onManage && (
+                            <TouchableOpacity
+                                onPress={onManage}
+                                activeOpacity={0.7}
+                                style={{ flexDirection: 'row', alignItems: 'center', gap: 6, backgroundColor: 'rgba(0,0,0,0.55)', paddingHorizontal: 12, paddingVertical: 6, borderRadius: 8, borderWidth: 1, borderColor: 'rgba(255,255,255,0.3)' }}
+                            >
+                                <Ionicons name="settings-outline" size={14} color="#fff" />
+                                <Text variant="caption" bold style={{ color: '#fff' }}>Manage</Text>
+                            </TouchableOpacity>
+                        )}
+                    </View>
+                    {/* Title overlay */}
+                    <View variant="transparent" style={{ position: 'absolute', left: 0, right: 0, bottom: 0, paddingHorizontal: 20, paddingBottom: 28 }}>
+                        <Text variant="h2" bold style={{ color: '#fff', fontSize: 26, lineHeight: 34, fontWeight: '800', letterSpacing: -0.5 }}>
+                            {competition.competition_name}
+                        </Text>
+                        <Text variant="caption" style={{ color: 'rgba(255,255,255,0.7)', marginTop: 4 }}>
+                            Sweepstakes
+                        </Text>
+                    </View>
+                </View>
+
+                {/* Assigned item */}
+                {myItem && (() => {
+                    const myItemImageUrl = resolveItemImageUrl(myItem.item_image) || itemImages[myItem.item_id]?.url;
+                    return (
+                        <View variant="transparent" style={[styles.rulesCard, { backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle, borderRadius: 10, marginHorizontal: 16 }]}>
+                            {myItemImageUrl ? (
+                                <Image source={{ uri: myItemImageUrl }} style={{ width: 40, height: 40, borderRadius: 8 }} resizeMode="cover" />
+                            ) : (
+                                <Ionicons name="trophy" size={24} color={theme.colors.primary.default} />
+                            )}
+                            <View variant="transparent" style={{ marginLeft: 12, flex: 1 }}>
+                                <Text variant="caption" color="tertiary">Your Team</Text>
+                                <Text variant="body" bold>{myItem.item_name}</Text>
+                                {myItem.seed != null && <Text variant="caption" color="tertiary">Seed #{myItem.seed}</Text>}
+                            </View>
+                        </View>
+                    );
+                })()}
+
+                {/* Stats */}
+                <View variant="transparent" style={{ flexDirection: 'row', gap: 12, paddingHorizontal: 16 }}>
+                    <View variant="transparent" style={[styles.rulesCard, { flex: 1, backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle, borderRadius: 10, alignItems: 'center' }]}>
+                        <Text variant="caption" color="tertiary">Players</Text>
+                        <Text variant="body" bold>{participants.length}</Text>
+                    </View>
+                    <View variant="transparent" style={[styles.rulesCard, { flex: 1, backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle, borderRadius: 10, alignItems: 'center' }]}>
+                        <Text variant="caption" color="tertiary">Teams</Text>
+                        <Text variant="body" bold>{items.length}</Text>
+                    </View>
+                    <View variant="transparent" style={[styles.rulesCard, { flex: 1, backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle, borderRadius: 10, alignItems: 'center' }]}>
+                        <Text variant="caption" color="tertiary">Rounds</Text>
+                        <Text variant="body" bold>{rounds.length}</Text>
+                    </View>
+                </View>
+
+                {/* Rounds with results */}
+                {sortedRounds.length > 0 && (
+                    <View variant="transparent" style={{ paddingHorizontal: 16 }}>
+                        <Text variant="body" bold style={{ marginBottom: 10 }}>Rounds</Text>
+                        {sortedRounds.map((round: any) => {
+                            const isExpanded = expandedRound === round.calcutta_round_id;
+                            const roundResults = item_results.filter(r => r.round_number === round.round_number);
+                            const advancedIds = roundResults.filter(r => r.result === 'advanced' || r.result === 'won').map(r => r.calcutta_auction_item_id);
+                            const eliminatedIds = roundResults.filter(r => r.result === 'eliminated').map(r => r.calcutta_auction_item_id);
+                            const advancedItems = items.filter(i => advancedIds.includes(i.calcutta_auction_item_id));
+                            const eliminatedItems = items.filter(i => eliminatedIds.includes(i.calcutta_auction_item_id));
+                            const hasResults = roundResults.length > 0;
+                            const statusColor = round.status === 'closed' ? theme.colors.status.success
+                                : round.status === 'inprogress' ? theme.colors.primary.default
+                                : theme.colors.text.tertiary;
+
+                            return (
+                                <View key={round.calcutta_round_id} variant="transparent" style={{ borderBottomWidth: 1, borderColor: theme.colors.border.subtle }}>
+                                    <TouchableOpacity
+                                        onPress={() => setExpandedRound(isExpanded ? null : round.calcutta_round_id)}
+                                        activeOpacity={0.7}
+                                        style={{ flexDirection: 'row', alignItems: 'center', paddingVertical: 12 }}
+                                    >
+                                        <View variant="transparent" style={{ flex: 1 }}>
+                                            <Text variant="body" bold>{round.round_name}</Text>
+                                            <View variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', marginTop: 4, gap: 8 }}>
+                                                <View variant="transparent" style={{ width: 6, height: 6, borderRadius: 3, backgroundColor: statusColor }} />
+                                                <Text variant="caption" color="tertiary">
+                                                    {round.status === 'closed' ? 'Resolved' : round.status === 'inprogress' ? 'In Progress' : 'Pending'}
+                                                </Text>
+                                                {hasResults && (
+                                                    <Text variant="caption" style={{ color: theme.colors.status.success }}>
+                                                        {advancedItems.length} advanced
+                                                    </Text>
+                                                )}
+                                            </View>
+                                            {round.prize_description && (
+                                                <View variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', marginTop: 4 }}>
+                                                    <Ionicons name="gift-outline" size={12} color={theme.colors.primary.default} />
+                                                    <Text variant="caption" style={{ color: theme.colors.primary.default, marginLeft: 4 }}>{round.prize_description}</Text>
+                                                </View>
+                                            )}
+                                        </View>
+                                        <Ionicons name={isExpanded ? 'chevron-up' : 'chevron-down'} size={16} color={theme.colors.text.tertiary} />
+                                    </TouchableOpacity>
+
+                                    {isExpanded && (
+                                        <View variant="transparent" style={{ paddingBottom: 12 }}>
+                                            {!hasResults && (
+                                                <Text variant="caption" color="tertiary" style={{ paddingVertical: 8 }}>No results yet</Text>
+                                            )}
+                                            {advancedItems.length > 0 && (
+                                                <>
+                                                    <Text variant="caption" bold color="secondary" style={{ marginTop: 4, marginBottom: 4 }}>Advanced ({advancedItems.length})</Text>
+                                                    {advancedItems.map(item => {
+                                                        const imgUrl = resolveItemImageUrl(item.item_image) || itemImages[item.item_id]?.url;
+                                                        const isMe = item.winning_player_id == player_id;
+                                                        return (
+                                                            <View key={item.calcutta_auction_item_id} variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', paddingVertical: 4, paddingLeft: 4 }}>
+                                                                {imgUrl ? (
+                                                                    <Image source={{ uri: imgUrl }} style={{ width: 20, height: 20, borderRadius: 4 }} resizeMode="cover" />
+                                                                ) : (
+                                                                    <Ionicons name="checkmark-circle" size={16} color={theme.colors.status.success} />
+                                                                )}
+                                                                <Text variant="caption" style={{ marginLeft: 6, flex: 1 }}>{item.item_name}</Text>
+                                                                {isMe && <Text variant="caption" bold style={{ color: theme.colors.primary.default }}>YOU</Text>}
+                                                            </View>
+                                                        );
+                                                    })}
+                                                </>
+                                            )}
+                                            {eliminatedItems.length > 0 && (
+                                                <>
+                                                    <Text variant="caption" bold color="secondary" style={{ marginTop: 8, marginBottom: 4 }}>Eliminated ({eliminatedItems.length})</Text>
+                                                    {eliminatedItems.map(item => {
+                                                        const imgUrl = resolveItemImageUrl(item.item_image) || itemImages[item.item_id]?.url;
+                                                        const isMe = item.winning_player_id == player_id;
+                                                        return (
+                                                            <View key={item.calcutta_auction_item_id} variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', paddingVertical: 4, paddingLeft: 4, opacity: 0.5 }}>
+                                                                {imgUrl ? (
+                                                                    <Image source={{ uri: imgUrl }} style={{ width: 20, height: 20, borderRadius: 4 }} resizeMode="cover" />
+                                                                ) : (
+                                                                    <Ionicons name="close-circle" size={16} color={theme.colors.status.error} />
+                                                                )}
+                                                                <Text variant="caption" style={{ marginLeft: 6, flex: 1 }}>{item.item_name}</Text>
+                                                                {isMe && <Text variant="caption" bold style={{ color: theme.colors.status.error }}>YOU</Text>}
+                                                            </View>
+                                                        );
+                                                    })}
+                                                </>
+                                            )}
+                                        </View>
+                                    )}
+                                </View>
+                            );
+                        })}
+                    </View>
+                )}
+
+                {/* All teams list */}
+                {items.length > 0 && (
+                    <View variant="transparent" style={{ paddingHorizontal: 16 }}>
+                        <Text variant="body" bold style={{ marginBottom: 10 }}>All Teams</Text>
+                        <TextInput
+                            style={{
+                                height: 36,
+                                borderRadius: 8,
+                                borderWidth: 1,
+                                borderColor: theme.colors.border.subtle,
+                                backgroundColor: theme.colors.surface.input,
+                                color: theme.colors.text.primary,
+                                paddingHorizontal: 12,
+                                fontSize: 14,
+                                marginBottom: 8,
+                            }}
+                            placeholder="Search by team or owner..."
+                            placeholderTextColor={theme.colors.text.tertiary}
+                            value={searchQuery}
+                            onChangeText={setSearchQuery}
+                            autoCapitalize="none"
+                            autoCorrect={false}
+                        />
+                        {filteredItems.map((item) => {
+                            const isMyItem = item.winning_player_id == player_id;
+                            const isEliminated = item.status === 'eliminated';
+                            const imageUrl = resolveItemImageUrl(item.item_image) || itemImages[item.item_id]?.url;
+                            const owner = item.winning_player_id ? enrichedPlayers[item.winning_player_id] : undefined;
+                            const ownerName = owner?.username || owner?.show_name;
+                            return (
+                                <View
+                                    key={item.calcutta_auction_item_id}
+                                    variant="transparent"
+                                    style={{ flexDirection: 'row', alignItems: 'center', paddingVertical: 8, borderBottomWidth: 1, borderColor: theme.colors.border.subtle, opacity: isEliminated ? 0.5 : 1 }}
+                                >
+                                    {imageUrl ? (
+                                        <Image source={{ uri: imageUrl }} style={{ width: 28, height: 28, borderRadius: 6 }} resizeMode="cover" />
+                                    ) : (
+                                        <Ionicons
+                                            name={isEliminated ? 'close-circle' : isMyItem ? 'star' : 'ellipse-outline'}
+                                            size={16}
+                                            color={isEliminated ? theme.colors.status.error : isMyItem ? theme.colors.primary.default : theme.colors.text.tertiary}
+                                        />
+                                    )}
+                                    <View variant="transparent" style={{ marginLeft: 8, flex: 1 }}>
+                                        <Text variant="body">{item.item_name}</Text>
+                                        {ownerName && (
+                                            <Text variant="caption" color="tertiary">
+                                                {isMyItem ? 'You' : ownerName}
+                                            </Text>
+                                        )}
+                                        {!item.winning_player_id && item.status !== 'unsold' && (
+                                            <Text variant="caption" color="tertiary">Unclaimed</Text>
+                                        )}
+                                        {item.status === 'unsold' && (
+                                            <Text variant="caption" color="tertiary">No owner</Text>
+                                        )}
+                                    </View>
+                                    {item.seed != null && <Text variant="caption" color="tertiary">#{item.seed}</Text>}
+                                    {isMyItem && <Text variant="caption" bold style={{ color: theme.colors.primary.default, marginLeft: 8 }}>YOU</Text>}
+                                </View>
+                            );
+                        })}
+                    </View>
+                )}
+
+                {!myItem && !isAdmin && (
+                    <View variant="transparent" style={{ alignItems: 'center', paddingVertical: 20, paddingHorizontal: 16 }}>
+                        <Ionicons name="time-outline" size={32} color={theme.colors.text.tertiary} />
+                        <Text variant="body" color="tertiary" style={{ marginTop: 8 }}>
+                            Waiting for the tournament to begin
+                        </Text>
+                    </View>
+                )}
+            </ScrollView>
+        </View>
+    );
+};
+
 // Main exported component — routes to sealed bid or live layout
 export const CalcuttaAuction: React.FC<CalcuttaAuctionProps> = (props) => {
     const { theme } = useTheme();
@@ -358,6 +656,10 @@ export const CalcuttaAuction: React.FC<CalcuttaAuctionProps> = (props) => {
         );
     }
 
+    if (competition.auction_type === 'sweepstakes') {
+        return <SweepstakesWaiting {...props} competition={competition} />;
+    }
+
     if (competition.auction_type === 'sealed_bid') {
         return <SealedBidAuction {...props} />;
     }

package/src/components/CalcuttaCard.tsx

@@ -19,7 +19,10 @@ export const CalcuttaCard: React.FC<CalcuttaCardProps> = ({
     const { theme } = useTheme();
 
     const statusLabel = getStatusLabel(competition.status);
-    const auctionLabel = competition.auction_type === 'live' ? 'Live Auction' : 'Sealed Bid';
+    const auctionLabel = competition.auction_type === 'sweepstakes'
+        ? 'Sweepstakes'
+        : competition.auction_type === 'live' ? 'Live Auction' : 'Sealed Bid';
+    const isSweepstakes = competition.auction_type === 'sweepstakes';
     const participantCount = competition.participants?.length ?? 0;
 
     return (
@@ -57,9 +60,15 @@ export const CalcuttaCard: React.FC<CalcuttaCardProps> = ({
                     </Text>
                 </View>
                 <View variant="transparent" style={styles.meta}>
-                    <Text variant="caption" color="secondary">
-                        Pot: {formatCurrency(competition.total_pot, competition.market_type)}
-                    </Text>
+                    {isSweepstakes ? (
+                        <Text variant="caption" color="secondary">
+                            {competition.rounds?.filter(r => r.prize_description).length ?? 0} Prizes
+                        </Text>
+                    ) : (
+                        <Text variant="caption" color="secondary">
+                            Pot: {formatCurrency(competition.total_pot, competition.market_type)}
+                        </Text>
+                    )}
                     <Text variant="caption" color="tertiary"> {'\u00B7'} </Text>
                     <Text variant="caption" color="secondary">
                         {participantCount} participant{participantCount !== 1 ? 's' : ''}

package/src/components/CalcuttaDetail.tsx

@@ -5,7 +5,8 @@ import { Ionicons } from '@expo/vector-icons';
 import type { CalcuttaParticipantProps } from '@bettoredge/types';
 import { useCalcuttaCompetition } from '../hooks/useCalcuttaCompetition';
 import { useCalcuttaPlayers } from '../hooks/useCalcuttaPlayers';
-import { formatCurrency, getStatusLabel } from '../helpers/formatting';
+import { formatCurrency, getStatusLabel, resolveItemImageUrl } from '../helpers/formatting';
+import { startSweepstakesCompetition } from '@bettoredge/api';
 
 export interface CalcuttaDetailProps {
     calcutta_competition_id: string;
@@ -53,6 +54,7 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
 
     const [joining, setJoining] = useState(false);
     const [leaving, setLeaving] = useState(false);
+    const [startingComp, setStartingComp] = useState(false);
 
     if (loading && !competition) {
         return (
@@ -75,11 +77,23 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
     const hasJoined = participants.some(p => p.player_id == player_id);
     const entryFee = Number(competition.entry_fee) || 0;
     const isFree = entryFee === 0;
-    const isJoinable = ['scheduled', 'auction_open'].includes(competition.status);
+    const isSweepstakes = competition.auction_type === 'sweepstakes';
+    const isJoinable = isSweepstakes
+        ? competition.status === 'scheduled'
+        : ['scheduled', 'auction_open'].includes(competition.status);
     const totalPot = Number(competition.total_pot) || 0;
-    const canLeave = hasJoined && ['pending', 'scheduled'].includes(competition.status);
+    const canLeave = hasJoined && !isSweepstakes && ['pending', 'scheduled'].includes(competition.status);
     const heroImage = competition.image?.url;
 
+    // Sweepstakes: find the player's assigned item
+    const myParticipant = participants.find(p => p.player_id == player_id);
+    const myAssignedItem = isSweepstakes && hasJoined
+        ? items.find(i => i.winning_player_id == player_id)
+        : undefined;
+    const unassignedItemCount = isSweepstakes
+        ? items.filter(i => !i.winning_player_id && i.status === 'pending').length
+        : 0;
+
     const sections = [
         { key: 'hero' },
         { key: 'info' },
@@ -112,7 +126,7 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                                 <Text variant="caption" bold style={{ color: statusConfig.color }}>{statusConfig.label}</Text>
                             </View>
                             <Text variant="caption" color="tertiary" style={{ marginLeft: 8 }}>
-                                {competition.auction_type === 'live' ? 'Live Auction' : 'Sealed Bid'}
+                                {isSweepstakes ? 'Sweepstakes' : competition.auction_type === 'live' ? 'Live Auction' : 'Sealed Bid'}
                             </Text>
                         </View>
                         <Text variant="h3" bold>{competition.competition_name}</Text>
@@ -135,17 +149,24 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                             <Text variant="caption" color="tertiary">Entry Fee</Text>
                             <Text variant="body" bold>{isFree ? 'FREE' : formatCurrency(entryFee, competition.market_type)}</Text>
                         </View>
-                        <View variant="transparent" style={[styles.statBox, { borderLeftWidth: 1, borderColor: theme.colors.border.subtle }]}>
-                            <Text variant="caption" color="tertiary">Pot</Text>
-                            <Text variant="body" bold>{formatCurrency(totalPot, competition.market_type)}</Text>
-                        </View>
+                        {isSweepstakes ? (
+                            <View variant="transparent" style={[styles.statBox, { borderLeftWidth: 1, borderColor: theme.colors.border.subtle }]}>
+                                <Text variant="caption" color="tertiary">Available</Text>
+                                <Text variant="body" bold>{unassignedItemCount}/{items.length}</Text>
+                            </View>
+                        ) : (
+                            <View variant="transparent" style={[styles.statBox, { borderLeftWidth: 1, borderColor: theme.colors.border.subtle }]}>
+                                <Text variant="caption" color="tertiary">Pot</Text>
+                                <Text variant="body" bold>{formatCurrency(totalPot, competition.market_type)}</Text>
+                            </View>
+                        )}
                         <View variant="transparent" style={[styles.statBox, { borderLeftWidth: 1, borderColor: theme.colors.border.subtle }]}>
                             <Text variant="caption" color="tertiary">Players</Text>
                             <Text variant="body" bold>{participants.length}{competition.max_participants > 0 ? `/${competition.max_participants}` : ''}</Text>
                         </View>
                         <View variant="transparent" style={[styles.statBox, { borderLeftWidth: 1, borderColor: theme.colors.border.subtle }]}>
-                            <Text variant="caption" color="tertiary">Items</Text>
-                            <Text variant="body" bold>{items.length}</Text>
+                            <Text variant="caption" color="tertiary">{isSweepstakes ? 'Prizes' : 'Items'}</Text>
+                            <Text variant="body" bold>{isSweepstakes ? rounds.filter(r => r.prize_description).length : items.length}</Text>
                         </View>
                     </View>
                 );
@@ -161,6 +182,33 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                             </TouchableOpacity>
                         )}
 
+                        {/* Admin start sweepstakes button */}
+                        {isAdmin && isSweepstakes && competition.status === 'scheduled' && (
+                            <TouchableOpacity
+                                onPress={async () => {
+                                    setStartingComp(true);
+                                    try {
+                                        await startSweepstakesCompetition(calcutta_competition_id);
+                                        await refresh();
+                                    } catch {}
+                                    setStartingComp(false);
+                                }}
+                                disabled={startingComp}
+                                style={[styles.ctaButton, { backgroundColor: '#8B5CF6', opacity: startingComp ? 0.7 : 1 }]}
+                            >
+                                {startingComp ? (
+                                    <ActivityIndicator size="small" color="#FFF" />
+                                ) : (
+                                    <>
+                                        <Ionicons name="play-circle-outline" size={18} color="#FFF" />
+                                        <Text variant="body" bold style={{ color: '#FFF', marginLeft: 8 }}>
+                                            Start Competition{unassignedItemCount > 0 ? ` (${unassignedItemCount} unassigned)` : ''}
+                                        </Text>
+                                    </>
+                                )}
+                            </TouchableOpacity>
+                        )}
+
                         {/* Join button */}
                         {isJoinable && !hasJoined && onJoin && (
                             <TouchableOpacity
@@ -179,38 +227,65 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                                     <ActivityIndicator size="small" color="#FFF" />
                                 ) : (
                                     <Text variant="body" bold style={{ color: '#FFF' }}>
-                                        {isFree ? 'Join - Free!' : `Join - ${formatCurrency(entryFee, competition.market_type)}`}
+                                        {isSweepstakes
+                                            ? (isFree ? 'Join Free — Get a Random Team!' : `Join — ${formatCurrency(entryFee, competition.market_type)}`)
+                                            : (isFree ? 'Join - Free!' : `Join - ${formatCurrency(entryFee, competition.market_type)}`)}
                                     </Text>
                                 )}
                             </TouchableOpacity>
                         )}
 
-                        {/* Already joined badge + leave */}
+                        {/* Already joined badge + assigned item (sweepstakes) + leave */}
                         {hasJoined && (
-                            <View variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', gap: 10 }}>
-                                <View variant="transparent" style={[styles.joinedBadge, { flex: 1, backgroundColor: '#10B98115' }]}>
-                                    <Ionicons name="checkmark-circle" size={16} color="#10B981" />
-                                    <Text variant="caption" bold style={{ color: '#10B981', marginLeft: 6 }}>You're in!</Text>
+                            <View variant="transparent" style={{ gap: 10 }}>
+                                <View variant="transparent" style={{ flexDirection: 'row', alignItems: 'center', gap: 10 }}>
+                                    <View variant="transparent" style={[styles.joinedBadge, { flex: 1, backgroundColor: '#10B98115' }]}>
+                                        <Ionicons name="checkmark-circle" size={16} color="#10B981" />
+                                        <Text variant="caption" bold style={{ color: '#10B981', marginLeft: 6 }}>You're in!</Text>
+                                    </View>
+                                    {onLeave && canLeave && (
+                                        <TouchableOpacity
+                                            onPress={async () => {
+                                                setLeaving(true);
+                                                try {
+                                                    await onLeave();
+                                                    await refresh();
+                                                } catch {}
+                                                setLeaving(false);
+                                            }}
+                                            disabled={leaving}
+                                            style={[styles.ctaButtonOutline, { borderColor: theme.colors.status.error, paddingHorizontal: 16, opacity: leaving ? 0.7 : 1 }]}
+                                        >
+                                            {leaving ? (
+                                                <ActivityIndicator size="small" color={theme.colors.status.error} />
+                                            ) : (
+                                                <Text variant="caption" bold style={{ color: theme.colors.status.error }}>Leave</Text>
+                                            )}
+                                        </TouchableOpacity>
+                                    )}
                                 </View>
-                                {onLeave && canLeave && (
-                                    <TouchableOpacity
-                                        onPress={async () => {
-                                            setLeaving(true);
-                                            try {
-                                                await onLeave();
-                                                await refresh();
-                                            } catch {}
-                                            setLeaving(false);
-                                        }}
-                                        disabled={leaving}
-                                        style={[styles.ctaButtonOutline, { borderColor: theme.colors.status.error, paddingHorizontal: 16, opacity: leaving ? 0.7 : 1 }]}
-                                    >
-                                        {leaving ? (
-                                            <ActivityIndicator size="small" color={theme.colors.status.error} />
+                                {/* Sweepstakes: show assigned item */}
+                                {isSweepstakes && myAssignedItem && (
+                                    <View variant="transparent" style={[styles.assignedItemCard, { backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle }]}>
+                                        {resolveItemImageUrl(myAssignedItem.item_image) ? (
+                                            <Image
+                                                source={{ uri: resolveItemImageUrl(myAssignedItem.item_image)! }}
+                                                style={styles.assignedItemImage}
+                                                resizeMode="cover"
+                                            />
                                         ) : (
-                                            <Text variant="caption" bold style={{ color: theme.colors.status.error }}>Leave</Text>
+                                            <View variant="transparent" style={[styles.assignedItemImage, { backgroundColor: theme.colors.primary.subtle, alignItems: 'center', justifyContent: 'center' }]}>
+                                                <Ionicons name="trophy" size={20} color={theme.colors.primary.default} />
+                                            </View>
                                         )}
-                                    </TouchableOpacity>
+                                        <View variant="transparent" style={{ flex: 1, marginLeft: 12 }}>
+                                            <Text variant="caption" color="tertiary">Your Team</Text>
+                                            <Text variant="body" bold>{myAssignedItem.item_name}</Text>
+                                            {myAssignedItem.seed != null && (
+                                                <Text variant="caption" color="tertiary">Seed #{myAssignedItem.seed}</Text>
+                                            )}
+                                        </View>
+                                    </View>
                                 )}
                             </View>
                         )}
@@ -226,6 +301,32 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                 );
 
             case 'payouts':
+                // Sweepstakes: show prize list per round instead of payout percentages
+                if (isSweepstakes) {
+                    const prizeRounds = rounds.filter(r => r.prize_description);
+                    if (prizeRounds.length === 0) return null;
+                    return (
+                        <View variant="transparent" style={[styles.section, { borderColor: theme.colors.border.subtle }]}>
+                            <Text variant="body" bold style={styles.sectionTitle}>Prizes</Text>
+                            {prizeRounds.map((round, i) => (
+                                <View key={round.calcutta_round_id} variant="transparent" style={[styles.payoutRow, i < prizeRounds.length - 1 && { borderBottomWidth: 1, borderColor: theme.colors.border.subtle }]}>
+                                    {round.prize_image?.url ? (
+                                        <Image
+                                            source={{ uri: round.prize_image.url }}
+                                            style={{ width: 40, height: 40, borderRadius: 6, marginRight: 10 }}
+                                            resizeMode="cover"
+                                        />
+                                    ) : null}
+                                    <View variant="transparent" style={{ flex: 1 }}>
+                                        <Text variant="body" bold>{round.round_name}</Text>
+                                        <Text variant="caption" color="secondary" style={{ marginTop: 2 }}>{round.prize_description}</Text>
+                                    </View>
+                                </View>
+                            ))}
+                        </View>
+                    );
+                }
+
                 if (payout_rules.length === 0) return null;
                 return (
                     <View variant="transparent" style={[styles.section, { borderColor: theme.colors.border.subtle }]}>
@@ -255,7 +356,7 @@ export const CalcuttaDetail: React.FC<CalcuttaDetailProps> = ({
                 if (items.length === 0) return null;
                 return (
                     <View variant="transparent" style={[styles.section, { borderColor: theme.colors.border.subtle, paddingBottom: 0 }]}>
-                        <Text variant="body" bold style={styles.sectionTitle}>Auction Items ({items.length})</Text>
+                        <Text variant="body" bold style={styles.sectionTitle}>{isSweepstakes ? 'Teams' : 'Auction Items'} ({items.length})</Text>
                     </View>
                 );
 
@@ -374,4 +475,6 @@ const styles = StyleSheet.create({
     participantRow: { flexDirection: 'row', alignItems: 'center', paddingVertical: 10 },
     avatarCircle: { width: 36, height: 36, borderRadius: 18, alignItems: 'center', justifyContent: 'center', marginRight: 10 },
     youBadge: { paddingHorizontal: 8, paddingVertical: 3, borderRadius: 8 },
+    assignedItemCard: { flexDirection: 'row', alignItems: 'center', padding: 12, borderRadius: 10, borderWidth: 1 },
+    assignedItemImage: { width: 44, height: 44, borderRadius: 8 },
 });

package/src/components/CalcuttaPayoutPreview.tsx

@@ -1,8 +1,8 @@
 import React from 'react';
-import { StyleSheet, FlatList } from 'react-native';
+import { StyleSheet, FlatList, Image } from 'react-native';
 import { View, Text, useTheme } from '@bettoredge/styles';
 import { Ionicons } from '@expo/vector-icons';
-import type { CalcuttaPayoutRuleProps } from '@bettoredge/types';
+import type { CalcuttaPayoutRuleProps, CalcuttaRoundProps } from '@bettoredge/types';
 import { formatCurrency } from '../helpers/formatting';
 
 export interface CalcuttaPayoutPreviewProps {
@@ -11,6 +11,8 @@ export interface CalcuttaPayoutPreviewProps {
     market_type: string;
     unclaimed_pot?: number;
     min_spend_pct?: number;
+    auction_type?: string;
+    rounds?: CalcuttaRoundProps[];
 }
 
 export const CalcuttaPayoutPreview: React.FC<CalcuttaPayoutPreviewProps> = ({
@@ -19,8 +21,58 @@ export const CalcuttaPayoutPreview: React.FC<CalcuttaPayoutPreviewProps> = ({
     market_type,
     unclaimed_pot,
     min_spend_pct,
+    auction_type,
+    rounds,
 }) => {
     const { theme } = useTheme();
+    const isSweepstakes = auction_type === 'sweepstakes';
+
+    // Sweepstakes: render prize list per round instead of percentages
+    if (isSweepstakes && rounds) {
+        const prizeRounds = rounds.filter(r => r.prize_description);
+        if (prizeRounds.length === 0) {
+            return (
+                <View variant="transparent" style={styles.container}>
+                    <Text variant="caption" color="tertiary" style={styles.emptyText}>
+                        No prizes defined
+                    </Text>
+                </View>
+            );
+        }
+        return (
+            <View variant="transparent" style={styles.container}>
+                <View
+                    variant="transparent"
+                    style={[styles.potSummary, { backgroundColor: theme.colors.surface.elevated, borderColor: theme.colors.border.subtle }]}
+                >
+                    <Ionicons name="gift-outline" size={20} color={theme.colors.primary.default} />
+                    <View variant="transparent" style={styles.potInfo}>
+                        <Text variant="caption" color="tertiary">Prizes</Text>
+                        <Text variant="body" bold>{prizeRounds.length} round{prizeRounds.length !== 1 ? 's' : ''}</Text>
+                    </View>
+                </View>
+                {prizeRounds.map(round => (
+                    <View
+                        key={round.calcutta_round_id}
+                        variant="transparent"
+                        style={[styles.ruleRow, { borderColor: theme.colors.border.subtle }]}
+                    >
+                        {round.prize_image?.url && (
+                            <Image
+                                source={{ uri: round.prize_image.url }}
+                                style={{ width: 36, height: 36, borderRadius: 6, marginRight: 10 }}
+                                resizeMode="cover"
+                            />
+                        )}
+                        <View variant="transparent" style={styles.ruleInfo}>
+                            <Text variant="body" numberOfLines={1}>{round.round_name}</Text>
+                            <Text variant="caption" color="secondary">{round.prize_description}</Text>
+                        </View>
+                    </View>
+                ))}
+            </View>
+        );
+    }
 
     const roundRules = payout_rules
         .filter(r => r.payout_type === 'round')

package/src/components/CalcuttaRoundResults.tsx

@@ -19,6 +19,7 @@ export interface CalcuttaRoundResultsProps {
     market_type: string;
     total_pot?: number;
     unclaimed_pot?: number;
+    auction_type?: string;
 }
 
 export const CalcuttaRoundResults: React.FC<CalcuttaRoundResultsProps> = ({
@@ -29,7 +30,9 @@ export const CalcuttaRoundResults: React.FC<CalcuttaRoundResultsProps> = ({
     market_type,
     total_pot,
     unclaimed_pot,
+    auction_type,
 }) => {
+    const isSweepstakes = auction_type === 'sweepstakes';
     const { theme } = useTheme();
     const { roundSummaries } = useCalcuttaResults(rounds, items, item_results, payout_rules);
     const [expandedRound, setExpandedRound] = useState<string | null>(null);
@@ -72,11 +75,16 @@ export const CalcuttaRoundResults: React.FC<CalcuttaRoundResultsProps> = ({
                             <Text variant="caption" color="tertiary">
                                 {getStatusLabel(summary.round.status)}
                             </Text>
-                            {summary.total_payout > 0 && (
+                            {!isSweepstakes && summary.total_payout > 0 && (
                                 <Text variant="caption" style={{ color: theme.colors.status.success, marginLeft: 8 }}>
                                     {formatCurrency(summary.total_payout, market_type)} paid
                                 </Text>
                             )}
+                            {isSweepstakes && summary.round.prize_description && (
+                                <Text variant="caption" style={{ color: theme.colors.primary.default, marginLeft: 8 }} numberOfLines={1}>
+                                    Prize available
+                                </Text>
+                            )}
                         </View>
                     </View>
                     <View variant="transparent" style={styles.roundCounts}>
@@ -95,8 +103,18 @@ export const CalcuttaRoundResults: React.FC<CalcuttaRoundResultsProps> = ({
 
                 {isExpanded && (
                     <View variant="transparent" style={[styles.roundBody, { borderColor: theme.colors.border.subtle }]}>
-                        {/* Payout rule */}
-                        {summary.payout_rule && (
+                        {/* Sweepstakes: show prize instead of payout rule */}
+                        {isSweepstakes && summary.round.prize_description && (
+                            <View variant="transparent" style={styles.payoutRow}>
+                                <Ionicons name="gift-outline" size={14} color={theme.colors.primary.default} />
+                                <Text variant="caption" style={{ marginLeft: 6, color: theme.colors.primary.default, flex: 1 }}>
+                                    Prize: {summary.round.prize_description}
+                                </Text>
+                            </View>
+                        )}
+
+                        {/* Payout rule (non-sweepstakes) */}
+                        {!isSweepstakes && summary.payout_rule && (
                             <View variant="transparent" style={styles.payoutRow}>
                                 <Ionicons name="cash-outline" size={14} color={theme.colors.text.tertiary} />
                                 <Text variant="caption" color="tertiary" style={{ marginLeft: 6 }}>
@@ -105,8 +123,8 @@ export const CalcuttaRoundResults: React.FC<CalcuttaRoundResultsProps> = ({
                             </View>
                         )}
 
-                        {/* Rollover notice for unsold advancing items */}
-                        {summary.round.status === 'closed' && summary.advanced_items.some(i => !i.winning_player_id) && (
+                        {/* Rollover notice for unsold advancing items (non-sweepstakes) */}
+                        {!isSweepstakes && summary.round.status === 'closed' && summary.advanced_items.some(i => !i.winning_player_id) && (
                             <View variant="transparent" style={[styles.payoutRow, { marginTop: 2 }]}>
                                 <Ionicons name="arrow-forward-circle-outline" size={14} color={theme.colors.primary.default} />
                                 <Text variant="caption" style={{ marginLeft: 6, color: theme.colors.primary.default, flex: 1 }}>

package/src/components/SweepstakesReveal.tsx

@@ -0,0 +1,178 @@
+import React, { useEffect, useRef } from 'react';
+import { StyleSheet, Modal, TouchableOpacity, Image, Animated } from 'react-native';
+import { View, Text, useTheme } from '@bettoredge/styles';
+import { Ionicons } from '@expo/vector-icons';
+import type { CalcuttaAuctionItemProps } from '@bettoredge/types';
+import { resolveItemImageUrl } from '../helpers/formatting';
+
+export interface SweepstakesRevealProps {
+    visible: boolean;
+    item?: CalcuttaAuctionItemProps;
+    /** Resolved image URL from sr_svc (getBulkTeams/getBulkAthletes) */
+    itemImageUrl?: string;
+    competitionName?: string;
+    onClose: () => void;
+}
+
+export const SweepstakesReveal: React.FC<SweepstakesRevealProps> = ({
+    visible,
+    item,
+    itemImageUrl,
+    competitionName,
+    onClose,
+}) => {
+    const { theme } = useTheme();
+    const scaleAnim = useRef(new Animated.Value(0.3)).current;
+    const opacityAnim = useRef(new Animated.Value(0)).current;
+
+    useEffect(() => {
+        if (visible && item) {
+            scaleAnim.setValue(0.3);
+            opacityAnim.setValue(0);
+            Animated.parallel([
+                Animated.spring(scaleAnim, {
+                    toValue: 1,
+                    tension: 50,
+                    friction: 7,
+                    useNativeDriver: true,
+                }),
+                Animated.timing(opacityAnim, {
+                    toValue: 1,
+                    duration: 300,
+                    useNativeDriver: true,
+                }),
+            ]).start();
+        }
+    }, [visible, item]);
+
+    if (!item) return null;
+
+    return (
+        <Modal
+            visible={visible}
+            transparent
+            animationType="fade"
+            onRequestClose={onClose}
+        >
+            <View variant="transparent" style={styles.backdrop}>
+                <Animated.View style={[
+                    styles.card,
+                    {
+                        backgroundColor: theme.colors.surface.elevated,
+                        borderColor: theme.colors.border.subtle,
+                        transform: [{ scale: scaleAnim }],
+                        opacity: opacityAnim,
+                    },
+                ]}>
+                    {/* Confetti-style header */}
+                    <View variant="transparent" style={[styles.celebrationHeader, { backgroundColor: '#8B5CF6' }]}>
+                        <Text style={styles.emoji}>🎉</Text>
+                        <Text variant="h3" bold style={{ color: '#FFF', textAlign: 'center' }}>
+                            You Got a Team!
+                        </Text>
+                        {competitionName && (
+                            <Text variant="caption" style={{ color: '#FFFFFFCC', marginTop: 4 }}>
+                                {competitionName}
+                            </Text>
+                        )}
+                    </View>
+
+                    {/* Item display */}
+                    <View variant="transparent" style={styles.itemSection}>
+                        {(itemImageUrl || resolveItemImageUrl(item.item_image)) ? (
+                            <Image
+                                source={{ uri: (itemImageUrl || resolveItemImageUrl(item.item_image))! }}
+                                style={styles.itemImage}
+                                resizeMode="cover"
+                            />
+                        ) : (
+                            <View variant="transparent" style={[styles.itemImage, styles.itemImageFallback, { backgroundColor: theme.colors.primary.subtle }]}>
+                                <Ionicons name="trophy" size={48} color={theme.colors.primary.default} />
+                            </View>
+                        )}
+
+                        <Text variant="h2" bold style={{ marginTop: 16, textAlign: 'center' }}>
+                            {item.item_name}
+                        </Text>
+
+                        {item.seed != null && (
+                            <View variant="transparent" style={[styles.seedBadge, { backgroundColor: theme.colors.primary.subtle }]}>
+                                <Text variant="body" bold style={{ color: theme.colors.primary.default }}>
+                                    Seed #{item.seed}
+                                </Text>
+                            </View>
+                        )}
+
+                        <Text variant="body" color="secondary" style={{ marginTop: 12, textAlign: 'center' }}>
+                            Cheer them on as they compete through each round!
+                        </Text>
+                    </View>
+
+                    {/* Close button */}
+                    <TouchableOpacity
+                        style={[styles.closeButton, { backgroundColor: '#8B5CF6' }]}
+                        onPress={onClose}
+                        activeOpacity={0.8}
+                    >
+                        <Text variant="body" bold style={{ color: '#FFF' }}>Let's Go!</Text>
+                    </TouchableOpacity>
+                </Animated.View>
+            </View>
+        </Modal>
+    );
+};
+
+const styles = StyleSheet.create({
+    backdrop: {
+        flex: 1,
+        backgroundColor: 'rgba(0,0,0,0.6)',
+        justifyContent: 'center',
+        alignItems: 'center',
+        padding: 24,
+    },
+    card: {
+        width: '100%',
+        maxWidth: 360,
+        borderRadius: 16,
+        borderWidth: 1,
+    },
+    celebrationHeader: {
+        paddingTop: 32,
+        paddingBottom: 24,
+        paddingHorizontal: 20,
+        alignItems: 'center',
+        borderTopLeftRadius: 15,
+        borderTopRightRadius: 15,
+    },
+    emoji: {
+        fontSize: 48,
+        marginBottom: 8,
+        lineHeight: 56,
+    },
+    itemSection: {
+        padding: 24,
+        alignItems: 'center',
+    },
+    itemImage: {
+        width: 120,
+        height: 120,
+        borderRadius: 16,
+    },
+    itemImageFallback: {
+        alignItems: 'center',
+        justifyContent: 'center',
+    },
+    seedBadge: {
+        paddingHorizontal: 16,
+        paddingVertical: 6,
+        borderRadius: 20,
+        marginTop: 10,
+    },
+    closeButton: {
+        marginHorizontal: 24,
+        marginBottom: 24,
+        paddingVertical: 14,
+        borderRadius: 10,
+        alignItems: 'center',
+    },
+});

package/src/helpers/formatting.ts

@@ -45,6 +45,15 @@ export const getItemStatusColor = (status: string): string => {
     }
 };
 
+/** Unwrap possibly double-wrapped image: { url: string } or { url: { url, secure_url, ... } } */
+export const resolveItemImageUrl = (item_image?: { url: any }): string | undefined => {
+    if (!item_image) return undefined;
+    const raw = item_image.url;
+    if (typeof raw === 'string') return raw;
+    if (raw && typeof raw === 'object') return raw.secure_url || raw.url;
+    return undefined;
+};
+
 export const getBidStatusColor = (status: string): string => {
     switch (status) {
         case 'active': return '#3B82F6';

package/src/helpers/lifecycleState.ts

@@ -15,19 +15,25 @@ export type CalcuttaLifecycleState =
 /**
  * Derive the lifecycle state from competition.status and competition.auction_status.
  *
- * CRITICAL: auction_status === 'closed' is the hard gate. If the server says
- * the auction is closed we NEVER return 'auctioning', no matter what `status` says.
+ * Sweepstakes competitions skip the auctioning phase entirely:
+ *   pending → scheduled → tournament → completed
  *
- * NOTE: We intentionally do NOT accept a client-side timer override here.
- * When the countdown expires but the server hasn't confirmed, the lifecycle
- * stays 'auctioning' and the orchestrator uses a separate `auctionExpired`
- * flag to disable all bid actions. This prevents showing empty results
- * before the server has resolved winners.
+ * @param auction_type - Optional. When 'sweepstakes', the auctioning state is never returned.
  */
 export function deriveLifecycleState(
     status?: string,
     auction_status?: string,
+    auction_type?: string,
 ): CalcuttaLifecycleState {
+    // ── Sweepstakes: no auction phase ──
+    if (auction_type === 'sweepstakes') {
+        if (!status || status === 'pending') return 'pending';
+        if (status === 'scheduled') return 'scheduled';
+        if (status === 'closed') return 'completed';
+        // auction_closed, inprogress → tournament
+        return 'tournament';
+    }
+
     // ── Hard gate: server confirmed auction closed ──
     if (auction_status === 'closed') {
         return status === 'closed' ? 'completed' : 'tournament';
@@ -59,12 +65,12 @@ export function deriveLifecycleState(
 }
 
 /** True when users can place / update / cancel bids */
-export const canBid = (state: CalcuttaLifecycleState): boolean =>
-    state === 'auctioning';
+export const canBid = (state: CalcuttaLifecycleState, auction_type?: string): boolean =>
+    auction_type === 'sweepstakes' ? false : state === 'auctioning';
 
 /** True when escrow deposit / withdraw controls should be interactive */
-export const canManageEscrow = (state: CalcuttaLifecycleState): boolean =>
-    state === 'scheduled' || state === 'auctioning';
+export const canManageEscrow = (state: CalcuttaLifecycleState, auction_type?: string): boolean =>
+    auction_type === 'sweepstakes' ? false : (state === 'scheduled' || state === 'auctioning');
 
 /** True when round results / leaderboard data is meaningful */
 export const showResults = (state: CalcuttaLifecycleState): boolean =>

package/src/hooks/useCalcuttaResults.ts

@@ -12,6 +12,10 @@ export interface RoundResultSummary {
     eliminated_items: CalcuttaAuctionItemProps[];
     payout_rule?: CalcuttaPayoutRuleProps;
     total_payout: number;
+    /** Prize description for this round (sweepstakes only) */
+    prize_description?: string;
+    /** Prize image for this round (sweepstakes only) */
+    prize_image?: { url: string };
 }
 
 export const useCalcuttaResults = (
@@ -35,6 +39,8 @@ export const useCalcuttaResults = (
                 eliminated_items: items.filter(i => eliminatedIds.includes(i.calcutta_auction_item_id)),
                 payout_rule: rule,
                 total_payout: totalPayout,
+                prize_description: round.prize_description,
+                prize_image: round.prize_image,
             };
         });
     }, [rounds, items, item_results, payout_rules]);

package/src/index.ts

@@ -26,6 +26,9 @@ export type { CalcuttaRoundResultsProps } from './components/CalcuttaRoundResult
 export { CalcuttaItemResults } from './components/CalcuttaItemResults';
 export type { CalcuttaItemResultsProps } from './components/CalcuttaItemResults';
 
+export { SweepstakesReveal } from './components/SweepstakesReveal';
+export type { SweepstakesRevealProps } from './components/SweepstakesReveal';
+
 export { CalcuttaTemplateSelector } from './components/CalcuttaTemplateSelector';
 export type { CalcuttaTemplateSelectorProps } from './components/CalcuttaTemplateSelector';
 
@@ -64,7 +67,7 @@ export { useCalcuttaItemImages } from './hooks/useCalcuttaItemImages';
 export type { ItemImageMap } from './hooks/useCalcuttaItemImages';
 
 // Helpers
-export { formatCurrency, formatPlace, getStatusLabel, getItemStatusColor, getBidStatusColor } from './helpers/formatting';
+export { formatCurrency, formatPlace, getStatusLabel, getItemStatusColor, getBidStatusColor, resolveItemImageUrl } from './helpers/formatting';
 export { calculatePayoutPreview, validatePayoutRules } from './helpers/payout';
 export { validateBidAmount, validateEscrowDeposit, validateEscrowWithdraw } from './helpers/validation';
 export { deriveLifecycleState, canBid, canManageEscrow, showResults } from './helpers/lifecycleState';

package/src/types.ts

@@ -27,5 +27,5 @@ export type {
 };
 
 export type CalcuttaStatus = 'pending' | 'scheduled' | 'auction_open' | 'auction_closed' | 'inprogress' | 'closed';
-export type AuctionType = 'sealed_bid' | 'live';
+export type AuctionType = 'sealed_bid' | 'live' | 'sweepstakes';
 export type PayoutType = 'round' | 'placement' | 'both';