trucoshi 13.2.1 → 14.0.0-rc.2

package/README.md

@@ -18,13 +18,34 @@ Proba la demo actual en [Trucoshi](https://trucoshi.com)
 
 [Lightning Accounts](https://github.com/jfrader/lightning-accounts)
 
-### Installation
+## Development
 
-`yarn`
+Use Node.js 24 (see `.nvmrc`) and Yarn 1.22.22. With `nvm` installed, a clean setup is:
 
-### Build
+```bash
+nvm install
+npm install --global yarn@1.22.22 # only when Yarn is missing
+cp .env.example .env
+yarn install --frozen-lockfile
+yarn prisma:generate
+```
+
+Run the local server watcher with `yarn dev`. It performs one clean initial build, then uses an
+incremental TypeScript cache for fast restarts. PostgreSQL and Redis must match `.env`.
+
+Use these checks before pushing:
+
+```bash
+yarn validate         # script syntax, formatting, types, and unit tests
+yarn format           # apply the repository's formatting rules
+yarn build            # clean CommonJS server build
+yarn build:dist:clean # clean publishable package build
+```
 
-`yarn build`
+`yarn test:e2e` is intentionally guarded: it loads `.env.test` before doing anything and refuses to
+reset a database unless `NODE_ENV=test` and the database host or name has a distinct `test` segment.
+Local launchers only stop local development/test containers; use `yarn docker:stop:all` when you
+explicitly intend to stop the production and staging Compose projects too.
 
 ### Full local dev stack
 
@@ -34,11 +55,19 @@ Run the three-repo local stack from this repo with:
 
 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 home screen continuously refreshes the stack status and service URLs. Use the numbered shortcuts or ↑/↓ to move, Enter or → to select, and ← or Esc to go back. It can also 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.
+For only the Trucoshi backend stack, use `yarn docker` with direct Docker access or `yarn docker:sudo` when Docker requires sudo. The matching stop commands are `yarn docker:stop` and `yarn docker:stop:sudo`.
+
+The launcher expects `lightning-accounts`, `trucoshi`, and `trucoshi-client` to be sibling folders
+with dependencies installed in each. It keeps all three in development mode and continuously
+refreshes their status and service URLs. Use the numbered shortcuts or ↑/↓ to move, Enter or → to
+select, and ← or Esc to go back. It can also build and host a client snapshot at
+`http://localhost: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` to override the defaults.
 
 # Test
 
-`yarn test`
+`yarn test` runs the full unit/socket suite on an automatically allocated local port, so it can run
+without colliding with the development or e2e servers.
 
 ### Card skins
 
@@ -52,13 +81,11 @@ Trucoshi e2e tests depend on a running Lightning Accounts e2e server. Start that
 terminal, then run the Trucoshi e2e suite in another:
 
 ```bash
-cd /home/fran/Workspace/trucoshi/lightning-accounts
-NODE_ENV=test ./init-e2e.sh
+(cd ../lightning-accounts && NODE_ENV=test ./init-e2e.sh)
 ```
 
 ```bash
-cd /home/fran/Workspace/trucoshi/trucoshi
-NODE_ENV=test ./init-e2e.sh
+yarn docker:e2e
 ```
 
 Use `../lightning-accounts/init-test.sh` when you want to run the Lightning Accounts Jest/e2e
@@ -88,6 +115,31 @@ yarn docker:prod:migrate
 docker compose -f docker-compose.prod.yml --env-file .env up -d --build server
 ```
 
+### Operations console
+
+Use the interactive console to check Accounts/game readiness, verify wallet and bets are disabled,
+inspect match/queue counts, drain before a deployment, wait for zero, or resume a cancelled release:
+
+```bash
+cp .env.ops.example .env.ops
+yarn ops
+```
+
+The menu supports development, staging, and production. Edit `.env.ops` with the public or local
+base URLs for each environment. Tokens may be supplied through the shell or the ignored file, but
+leaving them empty is safer: the console prompts without echo and retains each token in memory only.
+Production drain/resume actions require typing an environment-specific confirmation phrase.
+See the complete [operations console guide](docs/operations/ops-console.md) for configuration,
+output interpretation, and the staging/production release sequence.
+
+Direct environment shortcuts are also available:
+
+```bash
+yarn ops:dev
+yarn ops:staging
+yarn ops:prod
+```
+
 ### Admin users
 
 User roles live in Lightning Accounts. To promote an existing user by email:

package/dist/events.d.ts

@@ -1,5 +1,5 @@
 import { SocketError } from "./server";
-import { EMatchState, IAdminCreateChestRewardCodeInput, IAdminCreateChestRewardCodeResult, IAdminDashboard, IAdminSetNoticeBannerInput, IAdminSetNoticeBannerResult, IAccountDetails, CardSkinId, ICard, IChatMessage, IEquippedDeck, ILobbyOptions, IInventoryCardGroup, IMatchDetails, IPlayerRanking, IPublicChatRoom, IPublicMatch, IPublicMatchInfo, IPublicMatchStats, IJoinQueueOptions, IQueueMatchFound, IQueueMatchCancelled, IQueueMatchStarting, IQueueReadyUpdate, IQueueStatus, IRewardCodeRedeemResult, IPublicNoticeBanner, ITreasureOpenResult, ITreasureStatus, ISkinRollResult, ITrucoshiStats, IUserData, IWaitingPlayData, IWaitingSayData } from "./types";
+import { EMatchState, IAdminCreateChestRewardCodeInput, IAdminCreateChestRewardCodeResult, IAdminDashboard, IAdminSetNoticeBannerInput, IAdminSetNoticeBannerResult, IAccountDetails, CardSkinId, ICard, IChatMessage, IEquippedDeck, ILobbyOptions, IInventoryCardGroup, IMatchDetails, IPlayerRanking, IPublicChatRoom, IPublicMatch, IPublicMatchInfo, IPublicMatchStats, IJoinQueueOptions, IQueueMatchFound, IQueueMatchCancelled, IQueueMatchStarting, IQueueReadyUpdate, IQueueStatus, IRewardCodeRedeemResult, IPublicNoticeBanner, ITreasureOpenResult, ITreasureStatus, ISkinRollResult, ITrucoshiStats, IUserData, IWaitingPlayData, IWaitingSayData, IFeedbackInput } from "./types";
 export type IEventCallback<T = {}> = (args: {
     success: boolean;
     error?: SocketError;
@@ -80,6 +80,7 @@ export declare enum EClientEvent {
     OPEN_TREASURE_CHEST = "OPEN_TREASURE_CHEST",
     DEV_GRANT_TREASURE_CHEST = "DEV_GRANT_TREASURE_CHEST",
     FETCH_NOTICE_BANNER = "FETCH_NOTICE_BANNER",
+    SUBMIT_FEEDBACK = "SUBMIT_FEEDBACK",
     ADMIN_FETCH_DASHBOARD = "ADMIN_FETCH_DASHBOARD",
     ADMIN_CREATE_CHEST_REWARD_CODE = "ADMIN_CREATE_CHEST_REWARD_CODE",
     ADMIN_SET_NOTICE_BANNER = "ADMIN_SET_NOTICE_BANNER",
@@ -177,6 +178,7 @@ export interface ClientToServerEvents {
     [EClientEvent.FETCH_NOTICE_BANNER]: (callback: IEventCallback<{
         noticeBanner: IPublicNoticeBanner | null;
     }>) => void;
+    [EClientEvent.SUBMIT_FEEDBACK]: (input: IFeedbackInput, callback: IEventCallback<{}>) => void;
     [EClientEvent.ADMIN_FETCH_DASHBOARD]: (callback: IEventCallback<{
         dashboard: IAdminDashboard;
     }>) => void;

package/dist/events.js

@@ -52,6 +52,7 @@ export var EClientEvent;
     EClientEvent["OPEN_TREASURE_CHEST"] = "OPEN_TREASURE_CHEST";
     EClientEvent["DEV_GRANT_TREASURE_CHEST"] = "DEV_GRANT_TREASURE_CHEST";
     EClientEvent["FETCH_NOTICE_BANNER"] = "FETCH_NOTICE_BANNER";
+    EClientEvent["SUBMIT_FEEDBACK"] = "SUBMIT_FEEDBACK";
     EClientEvent["ADMIN_FETCH_DASHBOARD"] = "ADMIN_FETCH_DASHBOARD";
     EClientEvent["ADMIN_CREATE_CHEST_REWARD_CODE"] = "ADMIN_CREATE_CHEST_REWARD_CODE";
     EClientEvent["ADMIN_SET_NOTICE_BANNER"] = "ADMIN_SET_NOTICE_BANNER";

package/dist/lib/classes/Deck.js

@@ -76,9 +76,10 @@ export function dealCards(table, deck, fixedHandsByPlayerIdx) {
         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}`);
-                })())
+                ? 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) {

package/dist/tutorials/index.js

@@ -100,9 +100,7 @@ export const renderTutorialMessageText = (text, roundCards, previousRounds) => {
         if (!previousRoundScore) {
             return null;
         }
-        renderedText = renderedText
-            .split(TUTORIAL_PREVIOUS_ROUND_SCORE_TOKEN)
-            .join(previousRoundScore);
+        renderedText = renderedText.split(TUTORIAL_PREVIOUS_ROUND_SCORE_TOKEN).join(previousRoundScore);
     }
     return renderedText;
 };
@@ -183,7 +181,9 @@ const validateBotAction = (botAction, context) => {
     if (botAction.action.type === "card" && !isCard(botAction.action.value)) {
         throw new Error(`${context} card action must use a valid card id`);
     }
-    if (botAction.action.type === "command" && !isCommand(botAction.action.value) && typeof botAction.action.value !== "number") {
+    if (botAction.action.type === "command" &&
+        !isCommand(botAction.action.value) &&
+        typeof botAction.action.value !== "number") {
         throw new Error(`${context} command action must use a valid command`);
     }
 };

package/dist/types.d.ts

@@ -36,6 +36,13 @@ export interface IUserData {
     session: string;
     account: User | null;
 }
+export declare const FEEDBACK_MESSAGE_MAX_LENGTH = 1000;
+export type FeedbackContext = "lobby" | "match";
+export interface IFeedbackInput {
+    message: string;
+    context: FeedbackContext;
+    matchSessionId?: string;
+}
 export interface ILobbyOptions {
     maxPlayers: 2 | 4 | 6;
     faltaEnvido: 1 | 2;
@@ -157,6 +164,7 @@ export interface IMatchFlorBattle {
     winnerTeamIdx: 0 | 1 | null;
     winner: IPublicPlayer | null;
 }
+export type PublicRoundResult = 0 | 1 | "tie" | null;
 export interface IMatchPreviousHand {
     envido: {
         winner: IPublicPlayer;
@@ -178,6 +186,7 @@ export interface IMatchPreviousHand {
         cards: ICard[];
     }>;
     rounds: IPlayedCard[][];
+    roundResults: PublicRoundResult[];
     points: IHandPoints;
     matchSessionId: string;
 }
@@ -200,6 +209,7 @@ export interface IPublicMatch {
     me: IPublicPlayer | null;
     freshHand: boolean;
     rounds: IPlayedCard[][];
+    roundResults: PublicRoundResult[];
     lastCard?: ICard | null;
     lastCommand?: ECommand | number | null;
     awardedSatsPerPlayer?: number;

package/dist/types.js

@@ -10,6 +10,7 @@ export var EMatchState;
     EMatchState["FINISHED"] = "FINISHED";
     EMatchState["PAUSED"] = "PAUSED";
 })(EMatchState || (EMatchState = {}));
+export const FEEDBACK_MESSAGE_MAX_LENGTH = 1000;
 export var EChatSystem;
 (function (EChatSystem) {
     EChatSystem[EChatSystem["TEAM_0"] = 0] = "TEAM_0";

package/package.json

@@ -1,6 +1,11 @@
 {
   "name": "trucoshi",
-  "version": "13.2.1",
+  "version": "14.0.0-rc.2",
+  "packageManager": "yarn@1.22.22",
+  "engines": {
+    "node": ">=24",
+    "yarn": ">=1.22.22 <2"
+  },
   "description": "Truco Game Server",
   "main": "dist/types.js",
   "license": "GPL-3.0",
@@ -18,25 +23,50 @@
     ]
   },
   "scripts": {
-    "build": "yarn prisma generate && yarn run rimraf ./build && yarn run tsc --project .",
-    "build:dist": "yarn run rimraf ./dist && yarn prisma generate && yarn run tsc --project ./tsconfig.dist.json",
+    "clean": "rimraf ./build ./dist",
+    "clean:build": "rimraf ./build",
+    "clean:dist": "rimraf ./dist",
+    "prisma:generate": "prisma generate",
+    "prisma:generate:dev": "test -f ./node_modules/.prisma/client/index.js && test -f ./prisma/client/index.js && test ./node_modules/.prisma/client/index.js -nt ./prisma/schema.prisma && test ./prisma/client/index.js -nt ./prisma/schema.prisma || prisma generate",
+    "typecheck": "tsc --noEmit --incremental --tsBuildInfoFile ./build/.typecheck.tsbuildinfo --project .",
+    "check:scripts": "node --check ./bin/trucoshi-server && find ./scripts -type f -name '*.js' -exec node --check {} \\; && bash -n ./init-*.sh",
+    "format": "prettier --write package.json nodemon.json 'tsconfig*.json' .prettierrc.json '.vscode/*.json' '.github/**/*.{yml,yaml,json,md}' '*.md' '*.{yml,yaml}' 'docs/**/*.md' 'scripts/**/*.js' 'src/**/*.{ts,json}' 'test/**/*.{ts,js,json}'",
+    "format:check": "prettier --check package.json nodemon.json 'tsconfig*.json' .prettierrc.json '.vscode/*.json' '.github/**/*.{yml,yaml,json,md}' '*.md' '*.{yml,yaml}' 'docs/**/*.md' 'scripts/**/*.js' 'src/**/*.{ts,json}' 'test/**/*.{ts,js,json}'",
+    "validate": "yarn check:scripts && yarn format:check && yarn typecheck && yarn test",
+    "build": "yarn prisma:generate && yarn clean:build && yarn build:server",
+    "build:server": "tsc --project .",
+    "build:dist": "yarn prisma:generate:dev && yarn build:dist:incremental",
+    "build:dist:incremental": "tsc --project ./tsconfig.dist.json",
+    "build:dist:clean": "yarn prisma:generate && yarn clean:dist && yarn build:dist:incremental",
+    "prestart": "yarn prisma:generate:dev && yarn clean:build",
     "start": "nodemon",
+    "dev": "yarn start",
     "start:migrate": "prisma db push && yarn start",
     "start:prod": "node bin/trucoshi-server",
     "start:prod:migrate": "prisma migrate deploy && yarn start:prod",
     "docker": "NODE_ENV=development ./init-dev.sh",
+    "docker:sudo": "DEV_DOCKER_SUDO=1 NODE_ENV=development ./init-dev.sh",
+    "docker:stop": "./init-stop-all.sh --local",
+    "docker:stop:sudo": "DEV_DOCKER_SUDO=1 ./init-stop-all.sh --local",
+    "docker:stop:all": "./init-stop-all.sh --all",
     "dev:all": "NODE_ENV=development ./init-dev-all.sh",
     "dev:all:sudo-docker": "DEV_ALL_DOCKER_SUDO=1 NODE_ENV=development ./init-dev-all.sh",
     "docker:exec": "docker compose exec -i server yarn",
-    "docker:prod": "NODE_ENV=production && docker compose -f docker-compose.prod.yml down && docker compose -f docker-compose.prod.yml --env-file .env up --build",
+    "docker:prod": "NODE_ENV=production docker compose -f docker-compose.prod.yml --env-file .env up -d --build --wait",
     "docker:prod:migrate": "docker compose -f docker-compose.prod.yml --env-file .env run --rm --no-deps server yarn prisma migrate deploy",
-    "docker:staging": "docker compose -f docker-compose.staging.yml down && docker compose -f docker-compose.staging.yml --env-file .env up --build",
+    "ops": "node ./scripts/ops-console.js",
+    "ops:dev": "node ./scripts/ops-console.js --env development",
+    "ops:staging": "node ./scripts/ops-console.js --env staging",
+    "ops:prod": "node ./scripts/ops-console.js --env production",
+    "docker:staging": "NODE_ENV=staging docker compose -f docker-compose.staging.yml --env-file .env up -d --build --wait",
     "docker:staging:migrate": "docker compose -f docker-compose.staging.yml --env-file .env run --rm --no-deps server yarn prisma migrate deploy",
     "docker:e2e": "NODE_ENV=test ./init-e2e.sh",
-    "test": "dotenv -e .env.test -- ts-mocha --exit ./test/lib/**/*.ts -t 50000",
-    "test:e2e": "prisma db push --force-reset && dotenv -e .env.test -- ts-mocha --reporter spec --verbose --exit ./test/**/*.ts -t 60000",
+    "test": "yarn test:scripts && yarn test:unit",
+    "test:scripts": "node --test ./test/scripts/*.test.js",
+    "test:unit": "node ./scripts/run-unit-tests.js",
+    "test:e2e": "node ./scripts/run-e2e.js",
     "profiler": "node --prof ./bin/trucoshi-server",
-    "prepublishOnly": "yarn test && yarn build:dist",
+    "prepublishOnly": "yarn validate && yarn build:dist:clean",
     "cli:autoplay": "APP_DEBUG_LEVEL=warn yarn run ts-node src/utils/scripts/autoplay",
     "cli:play": "APP_DEBUG_LEVEL=warn yarn run ts-node src/utils/scripts/play",
     "sync:skins": "node scripts/sync-skins.js",
@@ -57,10 +87,13 @@
     "chai": "^5.3.3",
     "mocha": "^11.7.5",
     "nodemon": "^3.1.14",
-    "prisma": "^6.19.2",
+    "prettier": "3.6.2",
+    "rimraf": "^6.1.3",
     "sinon": "^21.0.2",
     "socket.io-client": "4.8.3",
-    "ts-mocha": "^11.1.0"
+    "ts-mocha": "^11.1.0",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.9.3"
   },
   "files": [
     "dist/lib/*",
@@ -79,14 +112,12 @@
     "@socket.io/redis-adapter": "8.3.0",
     "@types/jsonwebtoken": "^9.0.5",
     "@types/node-forge": "^1.3.14",
-    "@types/redis": "^4.0.11",
-    "axios": "^1.13.6",
+    "axios": "^1.18.1",
     "axios-cookiejar-support": "^6.0.5",
     "dotenv": "^16.0.3",
-    "dotenv-cli": "^7.3.0",
-    "form-data": "^4.0.5",
+    "form-data": "^4.0.6",
     "jsonwebtoken": "^9.0.3",
-    "lightning-accounts": "6.3.0",
+    "lightning-accounts": "7.0.0-rc.0",
     "lodash.debounce": "^4.0.8",
     "lodash.memoize": "^4.1.2",
     "lodash.partialright": "^4.2.1",
@@ -95,11 +126,13 @@
     "path-scurry": "^2.0.2",
     "pino": "^9.14.0",
     "pino-pretty": "^13.1.3",
-    "rimraf": "^6.1.3",
+    "prisma": "6.19.2",
+    "redis": "5.7.0",
     "safe-rng": "^1.0.4",
     "sanitize-html": "^2.17.1",
-    "socket.io": "4.8.3",
-    "ts-node": "^10.9.1",
-    "typescript": "^5.9.3"
+    "socket.io": "4.8.3"
+  },
+  "resolutions": {
+    "axios/form-data": "4.0.6"
   }
 }

package/prisma/client/edge.js

@@ -36,11 +36,11 @@ exports.Prisma = Prisma
 exports.$Enums = {}
 
 /**
- * Prisma Client JS version: 6.19.3
+ * Prisma Client JS version: 6.19.2
  * Query Engine version: c2990dca591cba766e3b7ef5d9e8a84796e47ab7
  */
 Prisma.prismaVersion = {
-  client: "6.19.3",
+  client: "6.19.2",
   engine: "c2990dca591cba766e3b7ef5d9e8a84796e47ab7"
 }
 
@@ -342,7 +342,7 @@ const config = {
     "schemaEnvPath": "../../.env"
   },
   "relativePath": "..",
-  "clientVersion": "6.19.3",
+  "clientVersion": "6.19.2",
   "engineVersion": "c2990dca591cba766e3b7ef5d9e8a84796e47ab7",
   "datasourceNames": [
     "db"

package/prisma/client/index-browser.js

@@ -21,11 +21,11 @@ exports.Prisma = Prisma
 exports.$Enums = {}
 
 /**
- * Prisma Client JS version: 6.19.3
+ * Prisma Client JS version: 6.19.2
  * Query Engine version: c2990dca591cba766e3b7ef5d9e8a84796e47ab7
  */
 Prisma.prismaVersion = {
-  client: "6.19.3",
+  client: "6.19.2",
   engine: "c2990dca591cba766e3b7ef5d9e8a84796e47ab7"
 }
 

package/prisma/client/index.d.ts

@@ -433,7 +433,7 @@ export namespace Prisma {
   export import Exact = $Public.Exact
 
   /**
-   * Prisma Client JS version: 6.19.3
+   * Prisma Client JS version: 6.19.2
    * Query Engine version: c2990dca591cba766e3b7ef5d9e8a84796e47ab7
    */
   export type PrismaVersion = {

package/prisma/client/index.js

@@ -36,11 +36,11 @@ exports.Prisma = Prisma
 exports.$Enums = {}
 
 /**
- * Prisma Client JS version: 6.19.3
+ * Prisma Client JS version: 6.19.2
  * Query Engine version: c2990dca591cba766e3b7ef5d9e8a84796e47ab7
  */
 Prisma.prismaVersion = {
-  client: "6.19.3",
+  client: "6.19.2",
   engine: "c2990dca591cba766e3b7ef5d9e8a84796e47ab7"
 }
 
@@ -343,7 +343,7 @@ const config = {
     "schemaEnvPath": "../../.env"
   },
   "relativePath": "..",
-  "clientVersion": "6.19.3",
+  "clientVersion": "6.19.2",
   "engineVersion": "c2990dca591cba766e3b7ef5d9e8a84796e47ab7",
   "datasourceNames": [
     "db"

package/prisma/client/package.json

@@ -151,7 +151,7 @@
     },
     "./*": "./*"
   },
-  "version": "6.19.3",
+  "version": "6.19.2",
   "sideEffects": false,
   "imports": {
     "#wasm-engine-loader": {