trucoshi 12.1.0 → 12.2.0

package/README.md

@@ -30,9 +30,11 @@ Proba la demo actual en [Trucoshi](https://trucoshi.com)
 
 Run the three-repo local stack from this repo with:
 
-`yarn dev:all:sudo-docker`
+`yarn dev:all`
 
-Do not prefix the command with `sudo`. The script only uses sudo for Docker commands, and running Yarn itself as root can corrupt local links and generated Prisma files.
+If your user cannot run Docker directly, use `yarn dev:all:sudo-docker`. Do not prefix either command with `sudo`; that mode only elevates Docker commands, so Yarn, Vite, generated Prisma files, and local links remain owned by your user.
+
+The launcher keeps the local stack in development mode: Lightning Accounts, Trucoshi, and the Vite client. Its interactive control panel can show one service's logs at a time, display stack status, restart a service, and optionally build and host a client snapshot at `http://10.10.1.106:2993`. The snapshot is off by default, so it never slows Vite's hot-reload loop. Set `DEV_ALL_PUBLIC_HOST`, `DEV_ALL_CLIENT_HOST_PORT`, or `DEV_ALL_LOG_DIR` if you need different defaults.
 
 # Test
 

package/dist/events.d.ts

@@ -56,6 +56,7 @@ export declare enum EClientEvent {
     LOGOUT = "LOGOUT",
     LEAVE_MATCH = "LEAVE_MATCH",
     CREATE_MATCH = "CREATE_MATCH",
+    CREATE_TUTORIAL_MATCH = "CREATE_TUTORIAL_MATCH",
     FETCH_ACCOUNT_DETAILS = "FETCH_ACCOUNT_DETAILS",
     FETCH_MATCH_DETAILS = "FETCH_MATCH_DETAILS",
     SET_MATCH_OPTIONS = "SET_MATCH_OPTIONS",
@@ -67,6 +68,7 @@ export declare enum EClientEvent {
     PAUSE_MATCH = "PAUSE_MATCH",
     PLAY_AGAIN = "PLAY_AGAIN",
     JOIN_QUEUE = "JOIN_QUEUE",
+    FETCH_QUEUE_STATUS = "FETCH_QUEUE_STATUS",
     LEAVE_QUEUE = "LEAVE_QUEUE",
     CONFIRM_QUEUE_MATCH = "CONFIRM_QUEUE_MATCH",
     DECLINE_QUEUE_MATCH = "DECLINE_QUEUE_MATCH",
@@ -103,6 +105,10 @@ export interface ClientToServerEvents {
         match?: IPublicMatch;
         activeMatches?: IPublicMatchInfo[];
     }>) => void;
+    [EClientEvent.CREATE_TUTORIAL_MATCH]: (tutorialId: string | null | undefined, callback: IEventCallback<{
+        match?: IPublicMatch;
+        activeMatches?: IPublicMatchInfo[];
+    }>) => void;
     [EClientEvent.SET_MATCH_OPTIONS]: (matchSessionId: string, options: Partial<ILobbyOptions>, callback: IEventCallback<{
         match?: IPublicMatch;
         activeMatches?: IPublicMatchInfo[];
@@ -132,6 +138,9 @@ export interface ClientToServerEvents {
     [EClientEvent.JOIN_QUEUE]: (options: IJoinQueueOptions, callback: IEventCallback<{
         status?: IQueueStatus;
     }>) => void;
+    [EClientEvent.FETCH_QUEUE_STATUS]: (callback: IEventCallback<{
+        status?: IQueueStatus;
+    }>) => void;
     [EClientEvent.LEAVE_QUEUE]: (callback?: IEventCallback<{}>) => void;
     [EClientEvent.CONFIRM_QUEUE_MATCH]: (proposalId: string, callback?: IEventCallback<{
         update?: IQueueReadyUpdate;

package/dist/events.js

@@ -28,6 +28,7 @@ export var EClientEvent;
     EClientEvent["LOGOUT"] = "LOGOUT";
     EClientEvent["LEAVE_MATCH"] = "LEAVE_MATCH";
     EClientEvent["CREATE_MATCH"] = "CREATE_MATCH";
+    EClientEvent["CREATE_TUTORIAL_MATCH"] = "CREATE_TUTORIAL_MATCH";
     EClientEvent["FETCH_ACCOUNT_DETAILS"] = "FETCH_ACCOUNT_DETAILS";
     EClientEvent["FETCH_MATCH_DETAILS"] = "FETCH_MATCH_DETAILS";
     EClientEvent["SET_MATCH_OPTIONS"] = "SET_MATCH_OPTIONS";
@@ -39,6 +40,7 @@ export var EClientEvent;
     EClientEvent["PAUSE_MATCH"] = "PAUSE_MATCH";
     EClientEvent["PLAY_AGAIN"] = "PLAY_AGAIN";
     EClientEvent["JOIN_QUEUE"] = "JOIN_QUEUE";
+    EClientEvent["FETCH_QUEUE_STATUS"] = "FETCH_QUEUE_STATUS";
     EClientEvent["LEAVE_QUEUE"] = "LEAVE_QUEUE";
     EClientEvent["CONFIRM_QUEUE_MATCH"] = "CONFIRM_QUEUE_MATCH";
     EClientEvent["DECLINE_QUEUE_MATCH"] = "DECLINE_QUEUE_MATCH";

package/dist/lib/classes/Deck.d.ts

@@ -6,6 +6,6 @@ export declare function dealCards<TPlayer extends {
     key: string;
     idx: number;
     setHand(h: Array<ICard>): void;
-} = IPlayer>(table: ITable<TPlayer>, deck: IDeck): void;
+} = IPlayer>(table: ITable<TPlayer>, deck: IDeck, fixedHandsByPlayerIdx?: Record<string, ICard[]>): void;
 export declare function shuffleArray<T = unknown>(array: Array<T>, getRandom?: (max: number) => number): Array<T>;
 export declare function PlayedCard(player: IPlayer | IPublicPlayer, card: ICard, burn?: boolean): IPlayedCard;

package/dist/lib/classes/Deck.js

@@ -38,11 +38,54 @@ export function Deck() {
     return deck;
 }
 export const getAllCards = () => Object.keys(CARDS);
-export function dealCards(table, deck) {
+const normalizeFixedHands = (table, fixedHandsByPlayerIdx) => {
+    if (!fixedHandsByPlayerIdx) {
+        return null;
+    }
+    const fixedHands = new Map();
+    const usedCards = new Set();
+    const playersByIdx = new Set(table.players.map((player) => player.idx));
+    for (const [playerIdxText, cards] of Object.entries(fixedHandsByPlayerIdx)) {
+        const playerIdx = Number(playerIdxText);
+        if (!Number.isInteger(playerIdx) || !playersByIdx.has(playerIdx)) {
+            throw new Error(`Invalid fixed hand player index: ${playerIdxText}`);
+        }
+        if (!Array.isArray(cards) || cards.length !== 3) {
+            throw new Error(`Fixed hand for player ${playerIdx} must contain exactly 3 cards`);
+        }
+        for (const card of cards) {
+            if (!(card in CARDS)) {
+                throw new Error(`Invalid fixed hand card: ${card}`);
+            }
+            if (usedCards.has(card)) {
+                throw new Error(`Duplicate fixed hand card: ${card}`);
+            }
+            usedCards.add(card);
+        }
+        fixedHands.set(playerIdx, cards);
+    }
+    return fixedHands;
+};
+export function dealCards(table, deck, fixedHandsByPlayerIdx) {
     const cheat_lots_of_flowers = process.env.APP_CHEAT_LOTS_OF_FLOWERS_FOR_TESTING === "1";
     const cheat_cards = process.env.APP_CHEAT_CARDS || "";
     const playerHands = [];
     const players = table.getPlayersForehandFirst();
+    const fixedHands = normalizeFixedHands(table, fixedHandsByPlayerIdx);
+    if (fixedHands) {
+        for (const player of table.players) {
+            const fixedHand = fixedHands.get(player.idx);
+            playerHands[player.idx] = fixedHand
+                ? fixedHand.map((card) => deck.pick(card) || (() => {
+                    throw new Error(`Fixed hand card is not available in deck: ${card}`);
+                })())
+                : deck.takeThree();
+        }
+        for (const player of table.players) {
+            player.setHand(playerHands[player.idx]);
+        }
+        return;
+    }
     for (let i = 0; i < 3; i++) {
         for (const player of players) {
             playerHands[player.idx] = [...(playerHands[player.idx] || []), deck.takeCard()];
@@ -70,8 +113,8 @@ export function dealCards(table, deck) {
             playerHands[player.idx] = deck.takeThree();
         }
     }
-    for (const [key, player] of table.players.entries()) {
-        player.setHand(playerHands[key]);
+    for (const player of table.players) {
+        player.setHand(playerHands[player.idx]);
     }
 }
 const defaultGetRandom = (max) => Math.floor(Math.random() * max);