@gamelobby/common 1.0.373 → 1.0.375

package/build/interfaces/index.d.ts

@@ -76,3 +76,4 @@ export * from './wallet.interface';
 export * from './imageGallery.interface';
 export * from './gameDayStatus.interface';
 export * from './gameDay.interface';
+export * from './prizePool.interface';

package/build/interfaces/index.js

@@ -88,3 +88,4 @@ __exportStar(require("./wallet.interface"), exports);
 __exportStar(require("./imageGallery.interface"), exports);
 __exportStar(require("./gameDayStatus.interface"), exports);
 __exportStar(require("./gameDay.interface"), exports);
+__exportStar(require("./prizePool.interface"), exports);

package/build/interfaces/prizePool.interface.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Prize Pool Configuration
+ * Defines how coins are collected and distributed in tournaments
+ */
+/**
+ * Prize distribution per position
+ */
+export interface PrizePosition {
+    position: number;
+    percentage: number;
+    minAmount?: number;
+    label?: string;
+}
+/**
+ * Platform fee configuration
+ */
+export interface PlatformFeeConfig {
+    enabled: boolean;
+    percentage: number;
+    minFee?: number;
+    maxFee?: number;
+}
+/**
+ * Prize pool source configuration
+ */
+export declare enum PrizePoolSource {
+    ENTRY_FEES = "entry_fees",
+    GUARANTEED = "guaranteed",
+    MIXED = "mixed"
+}
+/**
+ * Prize pool status
+ */
+export declare enum PrizePoolStatus {
+    COLLECTING = "collecting",
+    LOCKED = "locked",
+    DISTRIBUTING = "distributing",
+    DISTRIBUTED = "distributed",
+    REFUNDED = "refunded"
+}
+/**
+ * Individual escrow hold for a participant
+ */
+export interface ParticipantEscrow {
+    participantId: number;
+    participantType: 'team' | 'player';
+    amount: number;
+    currency: string;
+    holdId?: string;
+    status: 'held' | 'released' | 'refunded';
+    heldAt: Date;
+    releasedAt?: Date;
+    refundedAt?: Date;
+}
+/**
+ * Prize distribution record
+ */
+export interface PrizeDistributionRecord {
+    participantId: number;
+    participantType: 'team' | 'player';
+    participantName: string;
+    position: number;
+    percentage: number;
+    amount: number;
+    currency: string;
+    transactionId?: string;
+    distributedAt?: Date;
+    status: 'pending' | 'distributed' | 'failed';
+    errorMessage?: string;
+}
+/**
+ * Complete Prize Pool Configuration for a Room
+ */
+export interface PrizePoolConfig {
+    enabled: boolean;
+    source: PrizePoolSource;
+    currency: string;
+    entryFee: number;
+    entryFeePerPlayer?: boolean;
+    guaranteedAmount?: number;
+    distribution: PrizePosition[];
+    platformFee: PlatformFeeConfig;
+    minParticipantsForPrizes: number;
+    insufficientParticipantsAction: 'refund_all' | 'distribute_anyway' | 'cancel';
+}
+/**
+ * Live Prize Pool State (runtime state)
+ */
+export interface PrizePoolState {
+    roomId: number;
+    gameDayId?: string;
+    totalCollected: number;
+    guaranteedAmount: number;
+    platformFeeAmount: number;
+    distributedAmount: number;
+    totalPoolAmount: number;
+    availableForDistribution: number;
+    status: PrizePoolStatus;
+    participantCount: number;
+    escrows: ParticipantEscrow[];
+    distributions: PrizeDistributionRecord[];
+    createdAt: Date;
+    updatedAt: Date;
+    lockedAt?: Date;
+    distributedAt?: Date;
+    refundedAt?: Date;
+}
+/**
+ * Default prize distributions for common tournament sizes
+ */
+export declare const DEFAULT_PRIZE_DISTRIBUTIONS: Record<string, PrizePosition[]>;
+/**
+ * Helper to calculate prize amount for a position
+ */
+export declare function calculatePrizeAmount(position: number, totalPool: number, distribution: PrizePosition[]): number;
+/**
+ * Validate that distribution percentages sum to 100 (or less)
+ */
+export declare function validateDistribution(distribution: PrizePosition[]): {
+    valid: boolean;
+    totalPercentage: number;
+    message?: string;
+};

package/build/interfaces/prizePool.interface.js

@@ -0,0 +1,105 @@
+"use strict";
+/**
+ * Prize Pool Configuration
+ * Defines how coins are collected and distributed in tournaments
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateDistribution = exports.calculatePrizeAmount = exports.DEFAULT_PRIZE_DISTRIBUTIONS = exports.PrizePoolStatus = exports.PrizePoolSource = void 0;
+/**
+ * Prize pool source configuration
+ */
+var PrizePoolSource;
+(function (PrizePoolSource) {
+    PrizePoolSource["ENTRY_FEES"] = "entry_fees";
+    PrizePoolSource["GUARANTEED"] = "guaranteed";
+    PrizePoolSource["MIXED"] = "mixed"; // Entry fees + guaranteed minimum
+})(PrizePoolSource = exports.PrizePoolSource || (exports.PrizePoolSource = {}));
+/**
+ * Prize pool status
+ */
+var PrizePoolStatus;
+(function (PrizePoolStatus) {
+    PrizePoolStatus["COLLECTING"] = "collecting";
+    PrizePoolStatus["LOCKED"] = "locked";
+    PrizePoolStatus["DISTRIBUTING"] = "distributing";
+    PrizePoolStatus["DISTRIBUTED"] = "distributed";
+    PrizePoolStatus["REFUNDED"] = "refunded"; // Tournament cancelled, all refunded
+})(PrizePoolStatus = exports.PrizePoolStatus || (exports.PrizePoolStatus = {}));
+/**
+ * Default prize distributions for common tournament sizes
+ */
+exports.DEFAULT_PRIZE_DISTRIBUTIONS = {
+    // Winner takes all
+    'winner_takes_all': [
+        { position: 1, percentage: 100, label: 'Champion' }
+    ],
+    // Top 2
+    'top_2': [
+        { position: 1, percentage: 70, label: 'Champion' },
+        { position: 2, percentage: 30, label: 'Runner-up' }
+    ],
+    // Top 3
+    'top_3': [
+        { position: 1, percentage: 50, label: 'Champion' },
+        { position: 2, percentage: 30, label: 'Runner-up' },
+        { position: 3, percentage: 20, label: '3rd Place' }
+    ],
+    // Top 4
+    'top_4': [
+        { position: 1, percentage: 40, label: 'Champion' },
+        { position: 2, percentage: 25, label: 'Runner-up' },
+        { position: 3, percentage: 20, label: '3rd Place' },
+        { position: 4, percentage: 15, label: '4th Place' }
+    ],
+    // Top 8
+    'top_8': [
+        { position: 1, percentage: 30, label: 'Champion' },
+        { position: 2, percentage: 20, label: 'Runner-up' },
+        { position: 3, percentage: 15, label: '3rd Place' },
+        { position: 4, percentage: 10, label: '4th Place' },
+        { position: 5, percentage: 7, label: '5th-8th' },
+        { position: 6, percentage: 7, label: '5th-8th' },
+        { position: 7, percentage: 6, label: '5th-8th' },
+        { position: 8, percentage: 5, label: '5th-8th' }
+    ]
+};
+/**
+ * Helper to calculate prize amount for a position
+ */
+function calculatePrizeAmount(position, totalPool, distribution) {
+    var positionConfig = distribution.find(function (d) { return d.position === position; });
+    if (!positionConfig)
+        return 0;
+    var calculatedAmount = Math.floor((totalPool * positionConfig.percentage) / 100);
+    // Apply minimum if configured
+    if (positionConfig.minAmount && calculatedAmount < positionConfig.minAmount) {
+        return positionConfig.minAmount;
+    }
+    return calculatedAmount;
+}
+exports.calculatePrizeAmount = calculatePrizeAmount;
+/**
+ * Validate that distribution percentages sum to 100 (or less)
+ */
+function validateDistribution(distribution) {
+    var totalPercentage = distribution.reduce(function (sum, pos) { return sum + pos.percentage; }, 0);
+    if (totalPercentage > 100) {
+        return {
+            valid: false,
+            totalPercentage: totalPercentage,
+            message: "Distribution percentages sum to " + totalPercentage + "%, which exceeds 100%"
+        };
+    }
+    if (totalPercentage < 100) {
+        return {
+            valid: true,
+            totalPercentage: totalPercentage,
+            message: "Distribution uses " + totalPercentage + "%, remaining " + (100 - totalPercentage) + "% goes to platform"
+        };
+    }
+    return {
+        valid: true,
+        totalPercentage: totalPercentage
+    };
+}
+exports.validateDistribution = validateDistribution;

package/build/interfaces/room.interface.d.ts

@@ -6,6 +6,7 @@ import { Game } from "./game.interface";
 import { GameDay } from "./gameDay.interface";
 import { QualificationRules } from "./gameDayStatus.interface";
 import { GameMode } from "./gamemode.interface";
+import { PrizePoolConfig } from "./prizePool.interface";
 import { Platform } from "./platform.interface";
 import { Points } from "./points.interface";
 import { RegistrationType } from "./registrationType";
@@ -107,4 +108,5 @@ export interface Room {
     bannerImageUrl?: string;
     showOpponentInInvitation?: boolean;
     qualificationRules?: QualificationRules;
+    prizePoolConfig?: PrizePoolConfig;
 }

package/build/topics/walletLoyaltyTopics.d.ts

@@ -19,6 +19,13 @@ export declare enum Subjects {
     EscrowHoldReleased = "escrow:hold-released",
     EscrowHoldRefunded = "escrow:hold-refunded",
     EscrowHoldDisputed = "escrow:hold-disputed",
+    PrizePoolCreated = "prizepool:created",
+    PrizePoolContribution = "prizepool:contribution",
+    PrizePoolContributionRefunded = "prizepool:contribution-refunded",
+    PrizePoolLocked = "prizepool:locked",
+    PrizePoolDistributed = "prizepool:distributed",
+    PrizePoolRefunded = "prizepool:refunded",
+    PrizePoolCancelled = "prizepool:cancelled",
     ExternalPaymentReceived = "external-payment:received",
     ExternalPaymentProcessed = "external-payment:processed",
     ExternalPaymentFailed = "external-payment:failed",

package/build/topics/walletLoyaltyTopics.js

@@ -29,6 +29,14 @@ var Subjects;
     Subjects["EscrowHoldReleased"] = "escrow:hold-released";
     Subjects["EscrowHoldRefunded"] = "escrow:hold-refunded";
     Subjects["EscrowHoldDisputed"] = "escrow:hold-disputed";
+    // Prize Pool Topics
+    Subjects["PrizePoolCreated"] = "prizepool:created";
+    Subjects["PrizePoolContribution"] = "prizepool:contribution";
+    Subjects["PrizePoolContributionRefunded"] = "prizepool:contribution-refunded";
+    Subjects["PrizePoolLocked"] = "prizepool:locked";
+    Subjects["PrizePoolDistributed"] = "prizepool:distributed";
+    Subjects["PrizePoolRefunded"] = "prizepool:refunded";
+    Subjects["PrizePoolCancelled"] = "prizepool:cancelled";
     // External Payment Topics
     Subjects["ExternalPaymentReceived"] = "external-payment:received";
     Subjects["ExternalPaymentProcessed"] = "external-payment:processed";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gamelobby/common",
-  "version": "1.0.373",
+  "version": "1.0.375",
   "description": "",
   "main": "./build/index.js",
   "types": "./build/index.d.ts",