@truelab/trueserver 0.0.4 → 0.1.0

package/README.md

@@ -1,13 +1,13 @@
 # @truelab/trueserver
 
-Fastify-based server package for TrueLab games.
+Fastify-based server package for TrueLab games. Implements the **Game Server** contract described in [GS Documentation](https://www.notion.so/truelab/GS-Documentation-36dd90f8c00680d485d4e4e3eba928f0).
 
-The package provides ready-to-use HTTP routes, request/response validation, shared TypeBox schemas, API key checks, Sentry integration, and Swagger UI for local development. A game server only needs to register game metadata and route handlers.
+The package provides HTTP routes, TypeBox request/response schemas, API-key authentication, error envelope, Sentry integration and Swagger UI. A game team only needs to call `registerGameConfig`, register handlers and start the server.
 
 ## Requirements
 
-- Node.js 22.12+ (uses `require()` of an ESM-only `typebox` dependency)
-- npm package access for `@truelab/trueserver`
+- Node.js 22.12+
+- npm access to `@truelab/trueserver`
 
 ## Installation
 
@@ -17,18 +17,15 @@ npm install @truelab/trueserver
 
 ## Quick Start
 
-Register game config and handlers before building the Fastify app:
-
 ```typescript
 import {
     Application,
-    ECategory,
     EStakeType,
-    EVolatility,
     handlers,
     getenv,
     logger,
     registerGameConfig,
+    type TChecksumReply,
     type TClientReply,
     type TConfigReply,
     type TPlayReply,
@@ -44,57 +41,63 @@ const stakeModes = [{
 }]
 
 registerGameConfig({
-    name: 'My Game',
+    gameId: 'my-game',
+    rtpVersion: '96',
     stakeModes,
-    hasBuy: false,
-    hasChoice: false,
-    hasGamble: false,
     hasMeta: false,
+    hasChoice: false,
+    hasRestore: false,
     hasMultiStake: false,
-    hasValidation: false,
+    hasVariableLevels: false,
     coinRatio: 10,
+    hasValidate: false,
 })
 
-handlers.register('client', async (): Promise<TClientReply> => ({
-    ok: true,
-    data: {},
-}))
-
 handlers.register('config', async (): Promise<TConfigReply> => ({
-    ok: true,
-    name: 'My Game',
-    category: ECategory.slots,
-    stakeModes,
-    rtp: 96,
-    hitrate: 25,
-    volatility: EVolatility.med,
+    gameId: 'my-game',
+    volatility: 2.5,
+    rtp: '96.17',
+    rtpVersion: '96',
     hasMeta: false,
     hasChoice: false,
-    hasBuy: false,
+    hasRestore: false,
     hasMultiStake: false,
-    hasValidation: false,
-    hasGamble: false,
-    freeroundsAllowed: false,
+    hasVariableLevels: false,
+    coinRatio: 10,
     minWin: 0.1,
     maxWin: 5000,
-    apiVersion: 0,
-    coinRatio: 10,
+    freeroundsAllowed: false,
+    hasValidate: false,
+    stakeModes,
 }))
 
-handlers.register('play', async (): Promise<TPlayReply> => ({
-    ok: true,
-    rng: '[]',
-    finished: true,
-    results: {
-        response: '{}',
-        winCash: 0,
-    },
+handlers.register('client', async (): Promise<TClientReply> => ({
+    data: {},
 }))
 
-handlers.register('validate', async (): Promise<TValidateReply> => ({
-    ok: true,
+handlers.register('play', async (request): Promise<TPlayReply> => {
+    // request.params.rtpVersion is available for routing math by RTP
+    return {
+        gameResponse: {},
+        rng: [],
+        winCash: 0,
+        finished: true,
+        hasMaxWin: false,
+    }
+})
+
+handlers.register('checksum', async (): Promise<TChecksumReply> => ({
+    files: [
+        { path: 'src/math/spin.js', hash: '...' },
+    ],
 }))
 
+// Optional. Enabled when hasValidate=true in registerGameConfig.
+handlers.register('validate', async (request): Promise<TValidateReply> => {
+    // Return a verdict: valid=true allows the round; valid=false rejects it (HTTP 200, no round opened).
+    return { valid: true }
+})
+
 async function main() {
     const app = new Application()
     const server = await app.build()
@@ -111,63 +114,74 @@ main().catch((error) => {
 })
 ```
 
-`registerGameConfig` must be called before `app.build()`: validation plugins read this config while the server is being built.
+`registerGameConfig` must be called before `app.build()` — validation plugins read the config while the server is being built. The function throws if invariants are violated (e.g. `hasChoice=true` without `hasMeta=true`, `hasVariableLevels=true` without `variableLevels`/`defaultLevel`, or `hasMultiStake=true` without `hasValidate=true`).
 
 ## Runtime API
 
-The server registers these routes:
+`{rtpVersion}` is a path segment (e.g. `96`, `97`, `98`) — RGS picks the correct RTP per call. Game Server receives it as `request.params.rtpVersion`.
 
 | Method | Path | Handler | Description |
 | ------ | ---- | ------- | ----------- |
-| `POST` | `/client` | `handlers.register('client', ...)` | Client settings payload |
-| `POST` | `/config` | `handlers.register('config', ...)` | Public game config |
-| `POST` | `/play` | `handlers.register('play', ...)` | Game round calculation |
-| `POST` | `/validate` | `handlers.register('validate', ...)` | Optional stake/meta validation |
-| `POST` | `/healthcheck` | built in | Service status and metrics |
+| `GET` | `/healthcheck` | built-in | Liveness/readiness probe |
+| `GET` | `/:rtpVersion/config` | `handlers.register('config', ...)` | Game config (RTP-specific) |
+| `GET` | `/:rtpVersion/client` | `handlers.register('client', ...)` | Client-side payload |
+| `GET` | `/:rtpVersion/checksum` | `handlers.register('checksum', ...)` | File hashes for integrity check |
+| `POST` | `/:rtpVersion/play` | `handlers.register('play', ...)` | One step of a round |
+| `POST` | `/:rtpVersion/validate` | `handlers.register('validate', ...)` | Pre-round stake validation — returns `{ valid, reason? }` (enabled when `hasValidate=true`) |
+
+Every request must carry the API key header. By default it is `x-api-key: test`; override with `API_HEADER` and `API_KEY`.
+
+`ROUTE_PREFIX` is prepended to every route. For `ROUTE_PREFIX=/api/v1`, the play endpoint becomes `POST /api/v1/96/play`. `/healthcheck` is always mounted directly under the prefix (no `{rtpVersion}` segment).
 
-All `POST` routes require an API key header. By default the server expects `x-api-key: test`; configure it with `API_HEADER` and `API_KEY`.
+## Error envelope
 
-`ROUTE_PREFIX` is applied to all routes. For example, `ROUTE_PREFIX=/api/game` turns `/play` into `/api/game/play`.
+Non-2xx responses follow:
 
-## Imports
+```json
+{
+    "status": false,
+    "code": 4001,
+    "message": "Invalid choice value"
+}
+```
 
-Use the root entry for runtime code, schemas, enums, helpers, and public types:
+Recommended code ranges: `1xxx` validation, `2xxx` auth, `4xxx` business, `9xxx` internal. The `EErrorCode` enum exports the codes used by this package.
 
 ```typescript
-import {
-    Application,
-    EStakeType,
-    PlayRequestSchema,
-    handlers,
-    registerGameConfig,
-    type TPlayReply,
-} from '@truelab/trueserver'
+import { EErrorCode, httpError } from '@truelab/trueserver'
+
+throw httpError('Invalid choice value', 400, EErrorCode.BusinessChoiceUnknown)
 ```
 
-Test helpers are intentionally published through a separate entry:
+## Test utilities
 
 ```typescript
-import { testBuild } from '@truelab/trueserver/test-utils'
+import {
+    checkSchemaPropertyDescriptions,
+    testBuild,
+    testHeaders,
+    validator,
+} from '@truelab/trueserver/test-utils'
 ```
 
-Published code is compiled into `dist/`; package `exports` exposes only the public root entry and test utilities.
+`test-utils` uses Jest globals (`expect`), so consumers should keep `jest` and usually `@types/jest` in `devDependencies`.
 
-## Environment Variables
+## Environment variables
 
 | Variable | Default | Description |
 | -------- | ------- | ----------- |
-| `HOST` | `localhost` | Listen host used by the consuming game server |
-| `PORT` | `2980` | Listen port used by the consuming game server |
-| `ROUTE_PREFIX` | empty | Prefix for all autoloaded routes |
-| `API_HEADER` | `x-api-key` | Header name used by the API key plugin |
-| `API_KEY` | `test` | Expected API key for `POST` requests |
+| `HOST` | `localhost` | Listen host |
+| `PORT` | `2980` | Listen port |
+| `ROUTE_PREFIX` | empty | Prefix for all routes |
+| `API_HEADER` | `x-api-key` | Header name used by API-key plugin |
+| `API_KEY` | `test` | Expected API key value |
 | `LOG_LEVEL` | `error` | Pino log level |
-| `APP_ENV` | unset | `dev`, `release`, or `master`; controls Swagger and environment mapping |
+| `APP_ENV` | unset | `dev`, `release`, `master`; controls Swagger and environment mapping |
 | `SENTRY_DSN` | unset | Sentry DSN |
 | `SENTRY_RATE` | `0.01` | Sentry traces sample rate |
-| `GAME_ID` | `0001` | Sentry `game.id` tag |
+| `GAME_ID` | `0001` | Sentry `game.id` tag fallback |
 
-The environment helper imports `dotenv/config`, so `.env` is loaded when `@truelab/trueserver` is imported.
+The environment helper imports `dotenv/config`, so `.env` is loaded automatically.
 
 ## Swagger
 
@@ -175,45 +189,51 @@ Swagger UI is enabled only for `APP_ENV=dev`.
 
 - `GET /` redirects to `/docs`
 - `GET /docs` serves Swagger UI
-- `release` and `master` disable Swagger UI
 
-When `ROUTE_PREFIX` is set, it affects game routes, not the Swagger UI route.
+`release` and `master` disable Swagger UI.
 
 ## Advanced Validation
 
-The package validates both requests and successful replies with TypeBox schemas. It also performs game-specific checks based on `registerGameConfig`.
+The package validates both requests and replies via TypeBox schemas and runs game-specific checks based on `registerGameConfig`:
 
-- `/config` checks stake modes and requires exactly one of `coinRatio` or `variableLevels`.
-- `/play` checks stakes, choices, meta data, gamble flag, and reply consistency.
-- `/validate` is available only when `hasValidation` is `true`.
-- `test` data is rejected in production mapping (`APP_ENV=master` or unset).
+- `/config` checks stake modes, the `hasChoice ⇒ hasMeta` invariant, the `hasVariableLevels ⇔ {variableLevels, defaultLevel}` pair, and `hasMultiStake=true ⇒ freeroundsAllowed=false` and `hasValidate=true`.
+- `/play` checks stakes (uniqueness, qty, level in `variableLevels`, parametric/params), `stepIndex` consistency (opening vs continuation), `choice`/`meta` presence per flags, and reply shape (`finished`, `choices`, `meta`, `hasMaxWin`).
+- `/validate` is available only when `hasValidate=true`. Returns `{ valid: boolean, reason?: string }`.
+- `test` field is rejected on production (`APP_ENV=master` or unset).
 
-For stepped games, set `hasChoice: true`; for games with meta state, set `hasMeta: true`; for line/table variants, use `variableLevels` instead of `coinRatio`.
+## Money-value precision
 
-## Test Utilities
+All monetary values on the wire — `winCash`, `winCoins`, `coinValue`, `minWin`, `maxWin`, `amount` — must be **exact decimal representations**. «Exact» means the value round-trips through `JSON.parse → number → toString` to itself. For example, `0.3` is exact; `0.30000000000000004` (the IEEE 754 artefact of `0.1 + 0.2` in native JavaScript) is not.
 
-Integration tests in consuming game servers can import Jest helpers from:
+RGS compares all incoming money values with **strict equality** (no epsilon tolerance). Any float drift in upstream computation will cause RGS to reject the value as invalid.
 
-```typescript
-import {
-    checkSchemaPropertyDescriptions,
-    testBuild,
-    testHeaders,
-    validator,
-} from '@truelab/trueserver/test-utils'
+**What this means in practice:**
+
+- Compute `winCash`, `winCoins` and any derived monetary values in decimal arithmetic — avoid `+ - × ÷` on native floating-point types for money-valued outputs.
+- Use a decimal library. The package exports `Big`, `roundMoney` and `isExactDecimal` from `big.js` so you do not need to add a separate dependency.
+
+```ts
+import { Big, roundMoney, isExactDecimal } from '@truelab/trueserver'
+
+const winCash = roundMoney(new Big(coins).times(coinValue), currencyDecimals) // exact-decimal number
+isExactDecimal(winCash, currencyDecimals) // true
 ```
 
-`test-utils` uses Jest globals (`expect`), so the consuming project should keep `jest` and usually `@types/jest` in `devDependencies`.
+`roundMoney(value, decimals)` returns a `number` rounded to `decimals` decimal places using decimal arithmetic (half-up by default). `isExactDecimal(value, decimals)` checks that the number has at most `decimals` fractional digits — useful as a self-check in tests.
+
+## Migration
+
+This release is breaking. See [MIGRATION.md](MIGRATION.md) for a full mapping of old fields/paths to new ones.
 
 ## Package Development
 
 ```bash
-npm test        # run Jest tests
-npm run build   # compile TypeScript to dist/
-npm pack        # build and inspect the npm tarball
+npm test
+npm run build
+npm pack
 ```
 
-`bitbucket-pipelines.yml` runs tests and build on the default branch. The custom `publish` pipeline publishes to npm with `NPM_PUBLISH_TOKEN`.
+`bitbucket-pipelines.yml` runs tests and build on the default branch.
 
 ## License
 

package/dist/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../application.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAkB,MAAM,0BAA0B,CAAA;AAGzE,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,MAAM,EAAE,cAAc,CAAA;;IAchB,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;CAiBzC"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../application.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,cAAc,EAAkB,MAAM,0BAA0B,CAAA;AAGzE,MAAM,CAAC,OAAO,OAAO,WAAW;IAC5B,MAAM,EAAE,cAAc,CAAA;;IAchB,KAAK,IAAI,OAAO,CAAC,cAAc,CAAC;CAuBzC"}

package/dist/application.js

@@ -22,16 +22,20 @@ class Application {
         }).withTypeProvider();
     }
     async build() {
-        // Load plugins
         await this.server.register(autoload_1.default, {
             dir: path_1.default.join(__dirname, 'plugins'),
         });
-        // Load routes
+        const prefix = (0, fastify_helper_1.getRoutePrefix)();
+        // Version-agnostic routes (healthcheck)
+        await this.server.register(autoload_1.default, {
+            dir: path_1.default.join(__dirname, 'routes-public'),
+            options: { prefix },
+            dirNameRoutePrefix: false,
+        });
+        // Version-scoped routes (config, client, play, validate, checksum)
         await this.server.register(autoload_1.default, {
             dir: path_1.default.join(__dirname, 'routes'),
-            options: {
-                prefix: (0, fastify_helper_1.getRoutePrefix)(),
-            },
+            options: { prefix: `${prefix}/:rtpVersion` },
             dirNameRoutePrefix: false,
         });
         return this.server;

package/dist/application.js.map

@@ -1 +1 @@
-{"version":3,"file":"application.js","sourceRoot":"","sources":["../application.ts"],"names":[],"mappings":";;;;;AAAA,iEAA+C;AAE/C,sDAA6B;AAC7B,gDAAuB;AAEvB,6DAAyE;AACzE,2DAAuD;AAEvD,MAAqB,WAAW;IAC5B,MAAM,CAAgB;IAEtB;QACI,IAAI,CAAC,MAAM,GAAG,IAAA,iBAAO,EAAC;YAClB,GAAG,EAAE;gBACD,aAAa,EAAE;oBACX,QAAQ,EAAE,CAAC,YAAY,CAAC;iBAC3B;aACJ;YACD,MAAM,EAAE,6BAAa;YACrB,qBAAqB,EAAE,IAAI;SAC9B,CAAC,CAAC,gBAAgB,EAAuB,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACX,eAAe;QACX,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAe,EAAE;YACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;SACvC,CAAC,CAAA;QAEF,cAAc;QACd,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAe,EAAE;YACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE;gBACL,MAAM,EAAE,IAAA,+BAAc,GAAE;aAC3B;YACD,kBAAkB,EAAE,KAAK;SAC5B,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,MAAM,CAAA;IACtB,CAAC;CACJ;AAhCD,8BAgCC"}
+{"version":3,"file":"application.js","sourceRoot":"","sources":["../application.ts"],"names":[],"mappings":";;;;;AAAA,iEAA+C;AAE/C,sDAA6B;AAC7B,gDAAuB;AAEvB,6DAAyE;AACzE,2DAAuD;AAEvD,MAAqB,WAAW;IAC5B,MAAM,CAAgB;IAEtB;QACI,IAAI,CAAC,MAAM,GAAG,IAAA,iBAAO,EAAC;YAClB,GAAG,EAAE;gBACD,aAAa,EAAE;oBACX,QAAQ,EAAE,CAAC,YAAY,CAAC;iBAC3B;aACJ;YACD,MAAM,EAAE,6BAAa;YACrB,qBAAqB,EAAE,IAAI;SAC9B,CAAC,CAAC,gBAAgB,EAAuB,CAAA;IAC9C,CAAC;IAED,KAAK,CAAC,KAAK;QACP,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAe,EAAE;YACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC;SACvC,CAAC,CAAA;QAEF,MAAM,MAAM,GAAG,IAAA,+BAAc,GAAE,CAAA;QAE/B,wCAAwC;QACxC,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAe,EAAE;YACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,eAAe,CAAC;YAC1C,OAAO,EAAE,EAAE,MAAM,EAAE;YACnB,kBAAkB,EAAE,KAAK;SAC5B,CAAC,CAAA;QAEF,mEAAmE;QACnE,MAAM,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,kBAAe,EAAE;YACxC,GAAG,EAAE,cAAI,CAAC,IAAI,CAAC,SAAS,EAAE,QAAQ,CAAC;YACnC,OAAO,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,cAAc,EAAE;YAC5C,kBAAkB,EAAE,KAAK;SAC5B,CAAC,CAAA;QAEF,OAAO,IAAI,CAAC,MAAM,CAAA;IACtB,CAAC;CACJ;AAtCD,8BAsCC"}

package/dist/examples.d.ts

@@ -1,3 +1,4 @@
+export { checksumReplyExamples } from './schemas/examples/checksum.schema.examples';
 export { clientReplyExamples } from './schemas/examples/client.schema.examples';
 export { configReplyExamples } from './schemas/examples/config.schema.examples';
 export { healthcheckReplyExamples } from './schemas/examples/healthcheck.schema.examples';

package/dist/examples.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAA;AACzF,OAAO,EACH,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACH,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,6CAA6C,CAAA"}
+{"version":3,"file":"examples.d.ts","sourceRoot":"","sources":["../examples.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAA;AACnF,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,mBAAmB,EAAE,MAAM,2CAA2C,CAAA;AAC/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,gDAAgD,CAAA;AACzF,OAAO,EACH,iBAAiB,EACjB,mBAAmB,GACtB,MAAM,yCAAyC,CAAA;AAChD,OAAO,EACH,qBAAqB,EACrB,uBAAuB,GAC1B,MAAM,6CAA6C,CAAA"}

package/dist/examples.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateRequestExamples = exports.validateReplyExamples = exports.playRequestExamples = exports.playReplyExamples = exports.healthcheckReplyExamples = exports.configReplyExamples = exports.clientReplyExamples = void 0;
+exports.validateRequestExamples = exports.validateReplyExamples = exports.playRequestExamples = exports.playReplyExamples = exports.healthcheckReplyExamples = exports.configReplyExamples = exports.clientReplyExamples = exports.checksumReplyExamples = void 0;
+var checksum_schema_examples_1 = require("./schemas/examples/checksum.schema.examples");
+Object.defineProperty(exports, "checksumReplyExamples", { enumerable: true, get: function () { return checksum_schema_examples_1.checksumReplyExamples; } });
 var client_schema_examples_1 = require("./schemas/examples/client.schema.examples");
 Object.defineProperty(exports, "clientReplyExamples", { enumerable: true, get: function () { return client_schema_examples_1.clientReplyExamples; } });
 var config_schema_examples_1 = require("./schemas/examples/config.schema.examples");

package/dist/examples.js.map

@@ -1 +1 @@
-{"version":3,"file":"examples.js","sourceRoot":"","sources":["../examples.ts"],"names":[],"mappings":";;;AAAA,oFAA+E;AAAtE,6HAAA,mBAAmB,OAAA;AAC5B,oFAA+E;AAAtE,6HAAA,mBAAmB,OAAA;AAC5B,8FAAyF;AAAhF,uIAAA,wBAAwB,OAAA;AACjC,gFAGgD;AAF5C,yHAAA,iBAAiB,OAAA;AACjB,2HAAA,mBAAmB,OAAA;AAEvB,wFAGoD;AAFhD,iIAAA,qBAAqB,OAAA;AACrB,mIAAA,uBAAuB,OAAA"}
+{"version":3,"file":"examples.js","sourceRoot":"","sources":["../examples.ts"],"names":[],"mappings":";;;AAAA,wFAAmF;AAA1E,iIAAA,qBAAqB,OAAA;AAC9B,oFAA+E;AAAtE,6HAAA,mBAAmB,OAAA;AAC5B,oFAA+E;AAAtE,6HAAA,mBAAmB,OAAA;AAC5B,8FAAyF;AAAhF,uIAAA,wBAAwB,OAAA;AACjC,gFAGgD;AAF5C,yHAAA,iBAAiB,OAAA;AACjB,2HAAA,mBAAmB,OAAA;AAEvB,wFAGoD;AAFhD,iIAAA,qBAAqB,OAAA;AACrB,mIAAA,uBAAuB,OAAA"}

package/dist/helpers/config.helper.d.ts

@@ -1,5 +1,13 @@
 import { TConfigReply } from '../schemas/config.schema';
-export type TGameConfig = Pick<TConfigReply, 'name' | 'stakeModes' | 'hasBuy' | 'hasChoice' | 'hasGamble' | 'hasMeta' | 'hasMultiStake' | 'hasValidation' | 'variableLevels' | 'coinRatio'>;
+export type TGameConfig = Pick<TConfigReply, 'gameId' | 'stakeModes' | 'hasMeta' | 'hasChoice' | 'hasRestore' | 'hasMultiStake' | 'hasVariableLevels' | 'hasValidate' | 'variableLevels' | 'defaultLevel' | 'coinRatio'> & {
+    /**
+     * RTP version label. Optional: set it only for single-RTP deployments.
+     * Multi-RTP servers omit it and take rtpVersion from the {rtpVersion} path
+     * segment per request — in that case /config validates the reply against the
+     * path segment only.
+     */
+    rtpVersion?: TConfigReply['rtpVersion'];
+};
 export declare function registerGameConfig(config: TGameConfig): void;
 export declare function getGameConfig(): TGameConfig;
 //# sourceMappingURL=config.helper.d.ts.map

package/dist/helpers/config.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.helper.d.ts","sourceRoot":"","sources":["../../helpers/config.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAC3C,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,WAAW,GACX,SAAS,GACT,eAAe,GACf,eAAe,GACf,gBAAgB,GAChB,WAAW,CACV,CAAA;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,QAErD;AAED,wBAAgB,aAAa,IAAI,WAAW,CAE3C"}
+{"version":3,"file":"config.helper.d.ts","sourceRoot":"","sources":["../../helpers/config.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAGvD,MAAM,MAAM,WAAW,GAAG,IAAI,CAAC,YAAY,EAC3C,QAAQ,GACR,YAAY,GACZ,SAAS,GACT,WAAW,GACX,YAAY,GACZ,eAAe,GACf,mBAAmB,GACnB,aAAa,GACb,gBAAgB,GAChB,cAAc,GACd,WAAW,CACV,GAAG;IACA;;;;;OAKG;IACH,UAAU,CAAC,EAAE,YAAY,CAAC,YAAY,CAAC,CAAC;CAC3C,CAAA;AAID,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,QAiCrD;AAED,wBAAgB,aAAa,IAAI,WAAW,CAE3C"}

package/dist/helpers/config.helper.js

@@ -2,8 +2,37 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerGameConfig = registerGameConfig;
 exports.getGameConfig = getGameConfig;
+const fastify_helper_1 = require("./fastify.helper");
 let gameConfig;
 function registerGameConfig(config) {
+    if (config.rtpVersion !== undefined && (typeof config.rtpVersion !== 'string' || config.rtpVersion.length === 0)) {
+        throw (0, fastify_helper_1.httpError)('Game config: rtpVersion must be a non-empty string when provided', 500);
+    }
+    if (config.hasChoice && !config.hasMeta) {
+        throw (0, fastify_helper_1.httpError)('Game config: hasChoice=true requires hasMeta=true', 500);
+    }
+    if (config.hasMultiStake && config.hasValidate !== true) {
+        throw (0, fastify_helper_1.httpError)('Game config: hasValidate must be true when hasMultiStake=true', 500);
+    }
+    if (config.hasVariableLevels) {
+        if (!Array.isArray(config.variableLevels) || config.variableLevels.length === 0) {
+            throw (0, fastify_helper_1.httpError)('Game config: variableLevels must be a non-empty array when hasVariableLevels=true', 500);
+        }
+        if (config.defaultLevel === undefined || !config.variableLevels.includes(config.defaultLevel)) {
+            throw (0, fastify_helper_1.httpError)('Game config: defaultLevel must be one of variableLevels when hasVariableLevels=true', 500);
+        }
+        if (config.coinRatio !== undefined) {
+            throw (0, fastify_helper_1.httpError)('Game config: coinRatio must not be set when hasVariableLevels=true', 500);
+        }
+    }
+    else {
+        if (config.coinRatio === undefined) {
+            throw (0, fastify_helper_1.httpError)('Game config: coinRatio is required when hasVariableLevels=false', 500);
+        }
+        if (config.variableLevels !== undefined || config.defaultLevel !== undefined) {
+            throw (0, fastify_helper_1.httpError)('Game config: variableLevels/defaultLevel must not be set when hasVariableLevels=false', 500);
+        }
+    }
     gameConfig = config;
 }
 function getGameConfig() {

package/dist/helpers/config.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.helper.js","sourceRoot":"","sources":["../../helpers/config.helper.ts"],"names":[],"mappings":";;AAiBA,gDAEC;AAED,sCAEC;AARD,IAAI,UAAuB,CAAA;AAE3B,SAAgB,kBAAkB,CAAC,MAAmB;IAClD,UAAU,GAAG,MAAM,CAAA;AACvB,CAAC;AAED,SAAgB,aAAa;IACzB,OAAO,UAAU,CAAA;AACrB,CAAC"}
+{"version":3,"file":"config.helper.js","sourceRoot":"","sources":["../../helpers/config.helper.ts"],"names":[],"mappings":";;AA2BA,gDAiCC;AAED,sCAEC;AA/DD,qDAA4C;AAwB5C,IAAI,UAAuB,CAAA;AAE3B,SAAgB,kBAAkB,CAAC,MAAmB;IAClD,IAAI,MAAM,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/G,MAAM,IAAA,0BAAS,EAAC,kEAAkE,EAAE,GAAG,CAAC,CAAA;IAC5F,CAAC;IAED,IAAI,MAAM,CAAC,SAAS,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACtC,MAAM,IAAA,0BAAS,EAAC,mDAAmD,EAAE,GAAG,CAAC,CAAA;IAC7E,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC;QACtD,MAAM,IAAA,0BAAS,EAAC,+DAA+D,EAAE,GAAG,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QAC3B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,cAAc,CAAC,IAAI,MAAM,CAAC,cAAc,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC9E,MAAM,IAAA,0BAAS,EAAC,mFAAmF,EAAE,GAAG,CAAC,CAAA;QAC7G,CAAC;QACD,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5F,MAAM,IAAA,0BAAS,EAAC,qFAAqF,EAAE,GAAG,CAAC,CAAA;QAC/G,CAAC;QACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAA,0BAAS,EAAC,oEAAoE,EAAE,GAAG,CAAC,CAAA;QAC9F,CAAC;IACL,CAAC;SAAM,CAAC;QACJ,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,EAAE,CAAC;YACjC,MAAM,IAAA,0BAAS,EAAC,iEAAiE,EAAE,GAAG,CAAC,CAAA;QAC3F,CAAC;QACD,IAAI,MAAM,CAAC,cAAc,KAAK,SAAS,IAAI,MAAM,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YAC3E,MAAM,IAAA,0BAAS,EAAC,uFAAuF,EAAE,GAAG,CAAC,CAAA;QACjH,CAAC;IACL,CAAC;IAED,UAAU,GAAG,MAAM,CAAA;AACvB,CAAC;AAED,SAAgB,aAAa;IACzB,OAAO,UAAU,CAAA;AACrB,CAAC"}

package/dist/helpers/errors.helper.d.ts

@@ -0,0 +1,19 @@
+export declare const EErrorCode: {
+    readonly ValidationBody: 1001;
+    readonly ValidationStakes: 1002;
+    readonly ValidationMeta: 1003;
+    readonly ValidationChoice: 1004;
+    readonly ValidationStepIndex: 1005;
+    readonly ValidationConfig: 1006;
+    readonly ValidationTest: 1007;
+    readonly ApiKey: 2001;
+    readonly BusinessChoiceUnknown: 4001;
+    readonly BusinessMetaShape: 4002;
+    readonly BusinessFinishedMismatch: 4003;
+    readonly BusinessChoicesMismatch: 4004;
+    readonly BusinessMaxWinMismatch: 4005;
+    readonly Unhandled: 9001;
+    readonly NotFound: 9404;
+};
+export type TErrorCode = (typeof EErrorCode)[keyof typeof EErrorCode];
+//# sourceMappingURL=errors.helper.d.ts.map

package/dist/helpers/errors.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.helper.d.ts","sourceRoot":"","sources":["../../helpers/errors.helper.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;CAgBb,CAAA;AAEV,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAA"}

package/dist/helpers/errors.helper.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EErrorCode = void 0;
+exports.EErrorCode = {
+    ValidationBody: 1001,
+    ValidationStakes: 1002,
+    ValidationMeta: 1003,
+    ValidationChoice: 1004,
+    ValidationStepIndex: 1005,
+    ValidationConfig: 1006,
+    ValidationTest: 1007,
+    ApiKey: 2001,
+    BusinessChoiceUnknown: 4001,
+    BusinessMetaShape: 4002,
+    BusinessFinishedMismatch: 4003,
+    BusinessChoicesMismatch: 4004,
+    BusinessMaxWinMismatch: 4005,
+    Unhandled: 9001,
+    NotFound: 9404,
+};
+//# sourceMappingURL=errors.helper.js.map

package/dist/helpers/errors.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.helper.js","sourceRoot":"","sources":["../../helpers/errors.helper.ts"],"names":[],"mappings":";;;AAAa,QAAA,UAAU,GAAG;IACtB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,gBAAgB,EAAE,IAAI;IACtB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,cAAc,EAAE,IAAI;IACpB,MAAM,EAAE,IAAI;IACZ,qBAAqB,EAAE,IAAI;IAC3B,iBAAiB,EAAE,IAAI;IACvB,wBAAwB,EAAE,IAAI;IAC9B,uBAAuB,EAAE,IAAI;IAC7B,sBAAsB,EAAE,IAAI;IAC5B,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,IAAI;CACR,CAAA"}

package/dist/helpers/fastify.helper.d.ts

@@ -1,9 +1,13 @@
 import { TypeBoxTypeProvider } from '@fastify/type-provider-typebox';
 import { FastifyBaseLogger, FastifyError, FastifyInstance, RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault } from 'fastify';
+import { TErrorCode } from './errors.helper';
 export type FastifyTypebox = FastifyInstance<RawServerDefault, RawRequestDefaultExpression<RawServerDefault>, RawReplyDefaultExpression<RawServerDefault>, FastifyBaseLogger, TypeBoxTypeProvider>;
+export type FastifyError$Coded = FastifyError & {
+    errorCode?: TErrorCode;
+};
 export declare function registerRoute(callback: (fastify: FastifyTypebox) => Promise<void>): (fastify: FastifyTypebox) => Promise<void>;
 export declare function registerPlugin(callback: (fastify: FastifyTypebox) => Promise<void>): (fastify: FastifyTypebox) => Promise<void>;
 export declare function getRoutePrefix(): string;
 /** This is handled in error.plugin.ts */
-export declare function httpError(message: string, statusCode?: number): FastifyError;
+export declare function httpError(message: string, statusCode?: number, code?: TErrorCode): FastifyError$Coded;
 //# sourceMappingURL=fastify.helper.d.ts.map

package/dist/helpers/fastify.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fastify.helper.d.ts","sourceRoot":"","sources":["../../helpers/fastify.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EACH,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAChD,yBAAyB,EAAE,2BAA2B,EAAE,gBAAgB,EAC3E,MAAM,SAAS,CAAA;AAKhB,MAAM,MAAM,cAAc,GAAG,eAAe,CAC5C,gBAAgB,EAChB,2BAA2B,CAAC,gBAAgB,CAAC,EAC7C,yBAAyB,CAAC,gBAAgB,CAAC,EAC3C,iBAAiB,EACjB,mBAAmB,CAClB,CAAA;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,aAAjC,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,CAElF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,aAAjC,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,CAEnF;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,GAAG,YAAY,CAKjF"}
+{"version":3,"file":"fastify.helper.d.ts","sourceRoot":"","sources":["../../helpers/fastify.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAA;AACpE,OAAO,EACH,iBAAiB,EAAE,YAAY,EAAE,eAAe,EAChD,yBAAyB,EAAE,2BAA2B,EAAE,gBAAgB,EAC3E,MAAM,SAAS,CAAA;AAIhB,OAAO,EAAc,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAExD,MAAM,MAAM,cAAc,GAAG,eAAe,CAC5C,gBAAgB,EAChB,2BAA2B,CAAC,gBAAgB,CAAC,EAC7C,yBAAyB,CAAC,gBAAgB,CAAC,EAC3C,iBAAiB,EACjB,mBAAmB,CAClB,CAAA;AAED,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG;IAAE,SAAS,CAAC,EAAE,UAAU,CAAA;CAAE,CAAA;AAE1E,wBAAgB,aAAa,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,aAAjC,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,CAElF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,aAAjC,cAAc,KAAK,OAAO,CAAE,IAAI,CAAC,CAEnF;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,yCAAyC;AACzC,wBAAgB,SAAS,CACrB,OAAO,EAAE,MAAM,EACf,UAAU,GAAE,MAAY,EACxB,IAAI,GAAE,UAAiC,GACxC,kBAAkB,CAMpB"}

package/dist/helpers/fastify.helper.js

@@ -9,6 +9,7 @@ exports.getRoutePrefix = getRoutePrefix;
 exports.httpError = httpError;
 const fastify_plugin_1 = __importDefault(require("fastify-plugin"));
 const env_helper_1 = require("./env.helper");
+const errors_helper_1 = require("./errors.helper");
 function registerRoute(callback) {
     return callback;
 }
@@ -19,9 +20,10 @@ function getRoutePrefix() {
     return (0, env_helper_1.getenv)('ROUTE_PREFIX', '');
 }
 /** This is handled in error.plugin.ts */
-function httpError(message, statusCode = 500) {
+function httpError(message, statusCode = 500, code = errors_helper_1.EErrorCode.Unhandled) {
     const error = new Error(message);
     error.statusCode = statusCode;
+    error.errorCode = code;
     return error;
 }
 //# sourceMappingURL=fastify.helper.js.map

package/dist/helpers/fastify.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"fastify.helper.js","sourceRoot":"","sources":["../../helpers/fastify.helper.ts"],"names":[],"mappings":";;;;;AAiBA,sCAEC;AAED,wCAEC;AAED,wCAEC;AAGD,8BAKC;AA9BD,oEAA0C;AAE1C,6CAAqC;AAUrC,SAAgB,aAAa,CAAC,QAAqD;IAC/E,OAAO,QAAQ,CAAA;AACnB,CAAC;AAED,SAAgB,cAAc,CAAC,QAAqD;IAChF,OAAO,IAAA,wBAAa,EAAC,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED,SAAgB,cAAc;IAC1B,OAAO,IAAA,mBAAM,EAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AACrC,CAAC;AAED,yCAAyC;AACzC,SAAgB,SAAS,CAAC,OAAe,EAAE,aAAqB,GAAG;IAC/D,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAiB,CAAA;IAChD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAA;IAE7B,OAAO,KAAK,CAAA;AAChB,CAAC"}
+{"version":3,"file":"fastify.helper.js","sourceRoot":"","sources":["../../helpers/fastify.helper.ts"],"names":[],"mappings":";;;;;AAoBA,sCAEC;AAED,wCAEC;AAED,wCAEC;AAGD,8BAUC;AAtCD,oEAA0C;AAE1C,6CAAqC;AACrC,mDAAwD;AAYxD,SAAgB,aAAa,CAAC,QAAqD;IAC/E,OAAO,QAAQ,CAAA;AACnB,CAAC;AAED,SAAgB,cAAc,CAAC,QAAqD;IAChF,OAAO,IAAA,wBAAa,EAAC,QAAQ,CAAC,CAAA;AAClC,CAAC;AAED,SAAgB,cAAc;IAC1B,OAAO,IAAA,mBAAM,EAAC,cAAc,EAAE,EAAE,CAAC,CAAA;AACrC,CAAC;AAED,yCAAyC;AACzC,SAAgB,SAAS,CACrB,OAAe,EACf,aAAqB,GAAG,EACxB,OAAmB,0BAAU,CAAC,SAAS;IAEvC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,CAAuB,CAAA;IACtD,KAAK,CAAC,UAAU,GAAG,UAAU,CAAA;IAC7B,KAAK,CAAC,SAAS,GAAG,IAAI,CAAA;IAEtB,OAAO,KAAK,CAAA;AAChB,CAAC"}

package/dist/helpers/handlers.helper.d.ts

@@ -1,11 +1,16 @@
 import { RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault, RouteHandlerMethod } from 'fastify';
+import { TChecksumReply, TChecksumRequest } from '../schemas/checksum.schema';
 import { TClientReply, TClientRequest } from '../schemas/client.schema';
 import { TConfigReply, TConfigRequest } from '../schemas/config.schema';
 import { TPlayReply, TPlayRequest } from '../schemas/play.schema';
 import { TValidateReply, TValidateRequest } from '../schemas/validate.schema';
-export type RouteHandler<TRequest, TReply> = RouteHandlerMethod<RawServerDefault, RawRequestDefaultExpression, RawReplyDefaultExpression, {
+export type TRtpParams = {
+    rtpVersion: string;
+};
+export type RouteHandler<TRequest, TReply, TParams = TRtpParams> = RouteHandlerMethod<RawServerDefault, RawRequestDefaultExpression, RawReplyDefaultExpression, {
     Body: TRequest;
     Reply: TReply;
+    Params: TParams;
 }>;
 export declare class HandlersHelper<IHandlers extends {
     [key: string]: {
@@ -35,5 +40,9 @@ export declare const handlers: HandlersHelper<{
         request: TClientRequest;
         reply: TClientReply;
     };
+    checksum: {
+        request: TChecksumRequest;
+        reply: TChecksumReply;
+    };
 }>;
 //# sourceMappingURL=handlers.helper.d.ts.map

package/dist/helpers/handlers.helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.helper.d.ts","sourceRoot":"","sources":["../../helpers/handlers.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,kBAAkB,EAC/F,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAG7E,MAAM,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,IAAI,kBAAkB,CAC/D,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,EACzB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAChC,CAAA;AAED,qBAAa,cAAc,CAAC,SAAS,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAA;CAAE;IACzF,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAE,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAY;IAEpE,QAAQ,CAAC,KAAK,SAAS,MAAM,SAAS,EAClC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IAMjF,GAAG,CAAC,KAAK,SAAS,MAAM,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IASrH,GAAG,CAAC,KAAK,SAAS,MAAM,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;CAI3D;AAED,eAAO,MAAM,QAAQ;UACT;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE;cACxC;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE;YACtD;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE;YAChD;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE;EAC1D,CAAA"}
+{"version":3,"file":"handlers.helper.d.ts","sourceRoot":"","sources":["../../helpers/handlers.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,yBAAyB,EAAE,2BAA2B,EAAE,gBAAgB,EAAE,kBAAkB,EAC/F,MAAM,SAAS,CAAA;AAEhB,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7E,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AACvE,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,cAAc,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAI7E,MAAM,MAAM,UAAU,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAA;AAE/C,MAAM,MAAM,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAG,UAAU,IAAI,kBAAkB,CACrF,gBAAgB,EAChB,2BAA2B,EAC3B,yBAAyB,EACzB;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,CACjD,CAAA;AAED,qBAAa,cAAc,CAAC,SAAS,SAAS;IAAE,CAAC,GAAG,EAAE,MAAM,GAAG;QAAE,OAAO,EAAE,GAAG,CAAC;QAAC,KAAK,EAAE,GAAG,CAAA;KAAE,CAAA;CAAE;IACzF,SAAS,CAAC,QAAQ,EAAE,GAAG,CAAE,MAAM,EAAE,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAY;IAEpE,QAAQ,CAAC,KAAK,SAAS,MAAM,SAAS,EAClC,IAAI,EAAE,KAAK,EACX,OAAO,EAAE,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IAMjF,GAAG,CAAC,KAAK,SAAS,MAAM,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,YAAY,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC;IASrH,GAAG,CAAC,KAAK,SAAS,MAAM,SAAS,EAAE,IAAI,EAAE,KAAK,GAAG,OAAO;CAI3D;AAED,eAAO,MAAM,QAAQ;UACT;QAAE,OAAO,EAAE,YAAY,CAAC;QAAC,KAAK,EAAE,UAAU,CAAA;KAAE;cACxC;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE;YACtD;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE;YAChD;QAAE,OAAO,EAAE,cAAc,CAAC;QAAC,KAAK,EAAE,YAAY,CAAA;KAAE;cAC9C;QAAE,OAAO,EAAE,gBAAgB,CAAC;QAAC,KAAK,EAAE,cAAc,CAAA;KAAE;EAChE,CAAA"}

package/dist/helpers/handlers.helper.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.handlers = exports.HandlersHelper = void 0;
+const errors_helper_1 = require("./errors.helper");
 const fastify_helper_1 = require("./fastify.helper");
 class HandlersHelper {
     handlers = new Map();
@@ -13,7 +14,7 @@ class HandlersHelper {
             const handlerName = name;
             return this.handlers.get(handlerName);
         }
-        throw (0, fastify_helper_1.httpError)(`Handler "${String(name)}" is not registered`);
+        throw (0, fastify_helper_1.httpError)(`Handler "${String(name)}" is not registered`, 500, errors_helper_1.EErrorCode.Unhandled);
     }
     has(name) {
         const handlerName = name;

package/dist/helpers/handlers.helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"handlers.helper.js","sourceRoot":"","sources":["../../helpers/handlers.helper.ts"],"names":[],"mappings":";;;AAQA,qDAA4C;AAS5C,MAAa,cAAc;IACb,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAA;IAEpE,QAAQ,CACJ,IAAW,EACX,OAA6E;QAE7E,MAAM,WAAW,GAAG,IAAc,CAAA;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,GAAG,CAAgC,IAAW;QAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,IAAc,CAAA;YAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QAED,MAAM,IAAA,0BAAS,EAAC,YAAY,MAAM,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAA;IAClE,CAAC;IAED,GAAG,CAAgC,IAAW;QAC1C,MAAM,WAAW,GAAG,IAAc,CAAA;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACzC,CAAC;CACJ;AAxBD,wCAwBC;AAEY,QAAA,QAAQ,GAAG,IAAI,cAAc,EAKtC,CAAA"}
+{"version":3,"file":"handlers.helper.js","sourceRoot":"","sources":["../../helpers/handlers.helper.ts"],"names":[],"mappings":";;;AASA,mDAA4C;AAC5C,qDAA4C;AAW5C,MAAa,cAAc;IACb,QAAQ,GAAyC,IAAI,GAAG,EAAE,CAAA;IAEpE,QAAQ,CACJ,IAAW,EACX,OAA6E;QAE7E,MAAM,WAAW,GAAG,IAAc,CAAA;QAClC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,EAAE,OAAO,CAAC,CAAA;IAC3C,CAAC;IAED,GAAG,CAAgC,IAAW;QAC1C,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YACjB,MAAM,WAAW,GAAG,IAAc,CAAA;YAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACzC,CAAC;QAED,MAAM,IAAA,0BAAS,EAAC,YAAY,MAAM,CAAC,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE,0BAAU,CAAC,SAAS,CAAC,CAAA;IAC7F,CAAC;IAED,GAAG,CAAgC,IAAW;QAC1C,MAAM,WAAW,GAAG,IAAc,CAAA;QAClC,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;IACzC,CAAC;CACJ;AAxBD,wCAwBC;AAEY,QAAA,QAAQ,GAAG,IAAI,cAAc,EAMtC,CAAA"}