@truelab/trueserver 0.0.3

package/CHANGELOG.md

@@ -0,0 +1,36 @@
+# Changelog
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [Unreleased]
+
+### Added
+- NPM-пакет `@truelab/trueserver` (exports, dist, prepack, publishConfig)
+- Bitbucket Pipelines: test / build / publish
+
+## [0.0.2] - 2024-02-29
+
+### Remove
+- Play helper
+
+### Added
+- Default swagger redirect (for dev)
+- New stake level validation
+- coinRatio/levels valiadtion
+
+### Changed
+- Volatility, Hitrate, Min win are optional now (can be variable for some games)
+- Currency decimals is optional for play/validate
+
+### Fixed
+- Winning calculation
+- Schema types (literals broke types)
+- Orginized imports
+- Game types enum ('casual' => 'table')
+
+## [0.0.1] - 2024-02-18
+
+### Added
+- Initial version

package/README.md

@@ -0,0 +1,220 @@
+# @truelab/trueserver
+
+Fastify-based server package for TrueLab games.
+
+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.
+
+## Requirements
+
+- Node.js 22.12+ (uses `require()` of an ESM-only `typebox` dependency)
+- npm package access for `@truelab/trueserver`
+
+## Installation
+
+```bash
+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 TClientReply,
+    type TConfigReply,
+    type TPlayReply,
+    type TValidateReply,
+} from '@truelab/trueserver'
+
+const stakeModes = [{
+    name: 'default',
+    type: EStakeType.default,
+    bets: 1,
+    parametric: false,
+    multiple: false,
+}]
+
+registerGameConfig({
+    name: 'My Game',
+    stakeModes,
+    hasBuy: false,
+    hasChoice: false,
+    hasGamble: false,
+    hasMeta: false,
+    hasMultiStake: false,
+    hasValidation: false,
+    coinRatio: 10,
+})
+
+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,
+    hasMeta: false,
+    hasChoice: false,
+    hasBuy: false,
+    hasMultiStake: false,
+    hasValidation: false,
+    hasGamble: false,
+    freeroundsAllowed: false,
+    minWin: 0.1,
+    maxWin: 5000,
+    apiVersion: 0,
+    coinRatio: 10,
+}))
+
+handlers.register('play', async (): Promise<TPlayReply> => ({
+    ok: true,
+    rng: '[]',
+    finished: true,
+    results: {
+        response: '{}',
+        winCash: 0,
+    },
+}))
+
+handlers.register('validate', async (): Promise<TValidateReply> => ({
+    ok: true,
+}))
+
+async function main() {
+    const app = new Application()
+    const server = await app.build()
+
+    await server.listen({
+        host: getenv('HOST', 'localhost'),
+        port: Number.parseInt(getenv('PORT', '2980'), 10),
+    })
+}
+
+main().catch((error) => {
+    logger.error(error)
+    process.exit(1)
+})
+```
+
+`registerGameConfig` must be called before `app.build()`: validation plugins read this config while the server is being built.
+
+## Runtime API
+
+The server registers these routes:
+
+| 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 |
+
+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`.
+
+`ROUTE_PREFIX` is applied to all routes. For example, `ROUTE_PREFIX=/api/game` turns `/play` into `/api/game/play`.
+
+## Imports
+
+Use the root entry for runtime code, schemas, enums, helpers, and public types:
+
+```typescript
+import {
+    Application,
+    EStakeType,
+    PlayRequestSchema,
+    handlers,
+    registerGameConfig,
+    type TPlayReply,
+} from '@truelab/trueserver'
+```
+
+Test helpers are intentionally published through a separate entry:
+
+```typescript
+import { testBuild } from '@truelab/trueserver/test-utils'
+```
+
+Published code is compiled into `dist/`; package `exports` exposes only the public root entry and test utilities.
+
+## 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 |
+| `LOG_LEVEL` | `error` | Pino log level |
+| `APP_ENV` | unset | `dev`, `release`, or `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 |
+
+The environment helper imports `dotenv/config`, so `.env` is loaded when `@truelab/trueserver` is imported.
+
+## Swagger
+
+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.
+
+## Advanced Validation
+
+The package validates both requests and successful replies with TypeBox schemas. It also performs 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).
+
+For stepped games, set `hasChoice: true`; for games with meta state, set `hasMeta: true`; for line/table variants, use `variableLevels` instead of `coinRatio`.
+
+## Test Utilities
+
+Integration tests in consuming game servers can import Jest helpers from:
+
+```typescript
+import {
+    checkSchemaPropertyDescriptions,
+    testBuild,
+    testHeaders,
+    validator,
+} from '@truelab/trueserver/test-utils'
+```
+
+`test-utils` uses Jest globals (`expect`), so the consuming project should keep `jest` and usually `@types/jest` in `devDependencies`.
+
+## Package Development
+
+```bash
+npm test        # run Jest tests
+npm run build   # compile TypeScript to dist/
+npm pack        # build and inspect the npm tarball
+```
+
+`bitbucket-pipelines.yml` runs tests and build on the default branch. The custom `publish` pipeline publishes to npm with `NPM_PUBLISH_TOKEN`.
+
+## License
+
+ISC

package/dist/application.d.ts

@@ -0,0 +1,7 @@
+import { FastifyTypebox } from './helpers/fastify.helper';
+export default class Application {
+    server: FastifyTypebox;
+    constructor();
+    build(): Promise<FastifyTypebox>;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -0,0 +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"}

package/dist/application.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const autoload_1 = __importDefault(require("@fastify/autoload"));
+const fastify_1 = __importDefault(require("fastify"));
+const path_1 = __importDefault(require("path"));
+const fastify_helper_1 = require("./helpers/fastify.helper");
+const logger_helper_1 = require("./helpers/logger.helper");
+class Application {
+    server;
+    constructor() {
+        this.server = (0, fastify_1.default)({
+            ajv: {
+                customOptions: {
+                    keywords: ['x-examples'],
+                },
+            },
+            logger: logger_helper_1.loggerOptions,
+            disableRequestLogging: true,
+        }).withTypeProvider();
+    }
+    async build() {
+        // Load plugins
+        await this.server.register(autoload_1.default, {
+            dir: path_1.default.join(__dirname, 'plugins'),
+        });
+        // Load routes
+        await this.server.register(autoload_1.default, {
+            dir: path_1.default.join(__dirname, 'routes'),
+            options: {
+                prefix: (0, fastify_helper_1.getRoutePrefix)(),
+            },
+            dirNameRoutePrefix: false,
+        });
+        return this.server;
+    }
+}
+exports.default = Application;
+//# sourceMappingURL=application.js.map

package/dist/application.js.map

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import { TConfigReply } from '../schemas/config.schema';
+export type TGameConfig = Pick<TConfigReply, 'name' | 'stakeModes' | 'hasBuy' | 'hasChoice' | 'hasGamble' | 'hasMeta' | 'hasMultiStake' | 'hasValidation' | 'variableLevels' | 'coinRatio'>;
+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

@@ -0,0 +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"}

package/dist/helpers/config.helper.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerGameConfig = registerGameConfig;
+exports.getGameConfig = getGameConfig;
+let gameConfig;
+function registerGameConfig(config) {
+    gameConfig = config;
+}
+function getGameConfig() {
+    return gameConfig;
+}
+//# sourceMappingURL=config.helper.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,5 @@
+import 'dotenv/config';
+export declare function getenv<T = string>(name: string, def: T): T;
+/** Вариации значений в зависимости от окружения */
+export declare function variation<T>(devBranch: T, releaseBranch: T, masterBranch: T): T;
+//# sourceMappingURL=env.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.helper.d.ts","sourceRoot":"","sources":["../../helpers/env.helper.ts"],"names":[],"mappings":"AAAA,OAAO,eAAe,CAAA;AAEtB,wBAAgB,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,CAY1D;AAED,mDAAmD;AACnD,wBAAgB,SAAS,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,CAY/E"}

package/dist/helpers/env.helper.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getenv = getenv;
+exports.variation = variation;
+require("dotenv/config");
+function getenv(name, def) {
+    if (name in process.env) {
+        const value = process.env[name];
+        switch (value) {
+            case 'true': return true;
+            case 'false': return false;
+            default: return value;
+        }
+    }
+    return def;
+}
+/** Вариации значений в зависимости от окружения */
+function variation(devBranch, releaseBranch, masterBranch) {
+    const variations = {
+        dev: devBranch,
+        release: releaseBranch,
+        master: masterBranch,
+    };
+    if (process.env.APP_ENV && process.env.APP_ENV in variations) {
+        return variations[process.env.APP_ENV];
+    }
+    return masterBranch;
+}
+//# sourceMappingURL=env.helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"env.helper.js","sourceRoot":"","sources":["../../helpers/env.helper.ts"],"names":[],"mappings":";;AAEA,wBAYC;AAGD,8BAYC;AA7BD,yBAAsB;AAEtB,SAAgB,MAAM,CAAa,IAAY,EAAE,GAAM;IACnD,IAAI,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACtB,MAAM,KAAK,GAAY,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAExC,QAAQ,KAAK,EAAE,CAAC;YACZ,KAAK,MAAM,CAAC,CAAC,OAAO,IAAoB,CAAA;YACxC,KAAK,OAAO,CAAC,CAAC,OAAO,KAAqB,CAAA;YAC1C,OAAO,CAAC,CAAC,OAAO,KAAU,CAAA;QAC9B,CAAC;IACL,CAAC;IAED,OAAO,GAAG,CAAA;AACd,CAAC;AAED,mDAAmD;AACnD,SAAgB,SAAS,CAAI,SAAY,EAAE,aAAgB,EAAE,YAAe;IACxE,MAAM,UAAU,GAAyB;QACrC,GAAG,EAAE,SAAS;QACd,OAAO,EAAE,aAAa;QACtB,MAAM,EAAE,YAAY;KACvB,CAAA;IAED,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,UAAU,EAAE,CAAC;QAC3D,OAAO,UAAU,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAC1C,CAAC;IAED,OAAO,YAAY,CAAA;AACvB,CAAC"}

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

@@ -0,0 +1,9 @@
+import { TypeBoxTypeProvider } from '@fastify/type-provider-typebox';
+import { FastifyBaseLogger, FastifyError, FastifyInstance, RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault } from 'fastify';
+export type FastifyTypebox = FastifyInstance<RawServerDefault, RawRequestDefaultExpression<RawServerDefault>, RawReplyDefaultExpression<RawServerDefault>, FastifyBaseLogger, TypeBoxTypeProvider>;
+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;
+//# sourceMappingURL=fastify.helper.d.ts.map

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

@@ -0,0 +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"}

package/dist/helpers/fastify.helper.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerRoute = registerRoute;
+exports.registerPlugin = registerPlugin;
+exports.getRoutePrefix = getRoutePrefix;
+exports.httpError = httpError;
+const fastify_plugin_1 = __importDefault(require("fastify-plugin"));
+const env_helper_1 = require("./env.helper");
+function registerRoute(callback) {
+    return callback;
+}
+function registerPlugin(callback) {
+    return (0, fastify_plugin_1.default)(callback);
+}
+function getRoutePrefix() {
+    return (0, env_helper_1.getenv)('ROUTE_PREFIX', '');
+}
+/** This is handled in error.plugin.ts */
+function httpError(message, statusCode = 500) {
+    const error = new Error(message);
+    error.statusCode = statusCode;
+    return error;
+}
+//# sourceMappingURL=fastify.helper.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,39 @@
+import { RawReplyDefaultExpression, RawRequestDefaultExpression, RawServerDefault, RouteHandlerMethod } from 'fastify';
+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, {
+    Body: TRequest;
+    Reply: TReply;
+}>;
+export declare class HandlersHelper<IHandlers extends {
+    [key: string]: {
+        request: any;
+        reply: any;
+    };
+}> {
+    protected handlers: Map<string, RouteHandler<any, any>>;
+    register<TName extends keyof IHandlers>(name: TName, handler: RouteHandler<IHandlers[TName]['request'], IHandlers[TName]['reply']>): void;
+    get<TName extends keyof IHandlers>(name: TName): RouteHandler<IHandlers[TName]['request'], IHandlers[TName]['reply']>;
+    has<TName extends keyof IHandlers>(name: TName): boolean;
+}
+export declare const handlers: HandlersHelper<{
+    play: {
+        request: TPlayRequest;
+        reply: TPlayReply;
+    };
+    validate: {
+        request: TValidateRequest;
+        reply: TValidateReply;
+    };
+    config: {
+        request: TConfigRequest;
+        reply: TConfigReply;
+    };
+    client: {
+        request: TClientRequest;
+        reply: TClientReply;
+    };
+}>;
+//# sourceMappingURL=handlers.helper.d.ts.map

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

@@ -0,0 +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"}

package/dist/helpers/handlers.helper.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handlers = exports.HandlersHelper = void 0;
+const fastify_helper_1 = require("./fastify.helper");
+class HandlersHelper {
+    handlers = new Map();
+    register(name, handler) {
+        const handlerName = name;
+        this.handlers.set(handlerName, handler);
+    }
+    get(name) {
+        if (this.has(name)) {
+            const handlerName = name;
+            return this.handlers.get(handlerName);
+        }
+        throw (0, fastify_helper_1.httpError)(`Handler "${String(name)}" is not registered`);
+    }
+    has(name) {
+        const handlerName = name;
+        return this.handlers.has(handlerName);
+    }
+}
+exports.HandlersHelper = HandlersHelper;
+exports.handlers = new HandlersHelper();
+//# sourceMappingURL=handlers.helper.js.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,6 @@
+import { FastifyLoggerOptions, RawServerBase } from 'fastify';
+import { FastifyBaseLogger, PinoLoggerOptions } from 'fastify/types/logger';
+import pino from 'pino';
+export declare const loggerOptions: boolean | FastifyLoggerOptions<RawServerBase> & PinoLoggerOptions | FastifyBaseLogger;
+export declare const logger: pino.Logger<never, boolean>;
+//# sourceMappingURL=logger.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.helper.d.ts","sourceRoot":"","sources":["../../helpers/logger.helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAC7D,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AAC3E,OAAO,IAAI,MAAM,MAAM,CAAA;AAIvB,eAAO,MAAM,aAAa,EAC1B,OAAO,GACP,oBAAoB,CAAC,aAAa,CAAC,GAAG,iBAAiB,GACvD,iBAUC,CAAA;AACD,eAAO,MAAM,MAAM,6BAAsB,CAAA"}

package/dist/helpers/logger.helper.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.logger = exports.loggerOptions = void 0;
+const pino_1 = __importDefault(require("pino"));
+const env_helper_1 = require("./env.helper");
+exports.loggerOptions = {
+    level: (0, env_helper_1.getenv)('LOG_LEVEL', 'error'),
+    transport: {
+        target: 'pino-pretty',
+        options: {
+            translateTime: 'UTC:yyyy-mm-dd HH:MM:ss.l',
+            colorize: true,
+            singleLine: true,
+        },
+    },
+};
+exports.logger = (0, pino_1.default)(exports.loggerOptions);
+//# sourceMappingURL=logger.helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.helper.js","sourceRoot":"","sources":["../../helpers/logger.helper.ts"],"names":[],"mappings":";;;;;;AAEA,gDAAuB;AAEvB,6CAAqC;AAExB,QAAA,aAAa,GAGN;IAChB,KAAK,EAAE,IAAA,mBAAM,EAAC,WAAW,EAAE,OAAO,CAAC;IACnC,SAAS,EAAE;QACP,MAAM,EAAE,aAAa;QACrB,OAAO,EAAE;YACL,aAAa,EAAE,2BAA2B;YAC1C,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;SACnB;KACJ;CACJ,CAAA;AACY,QAAA,MAAM,GAAG,IAAA,cAAI,EAAC,qBAAa,CAAC,CAAA"}

package/dist/helpers/pkg-version.helper.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Resolve package.json from either compiled output (`dist/helpers/…`) or source (`helpers/…` under ts-jest).
+ */
+export declare function getPackageVersion(): string;
+//# sourceMappingURL=pkg-version.helper.d.ts.map

package/dist/helpers/pkg-version.helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg-version.helper.d.ts","sourceRoot":"","sources":["../../helpers/pkg-version.helper.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAY1C"}

package/dist/helpers/pkg-version.helper.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackageVersion = getPackageVersion;
+const fs_1 = require("fs");
+const path_1 = require("path");
+/**
+ * Resolve package.json from either compiled output (`dist/helpers/…`) or source (`helpers/…` under ts-jest).
+ */
+function getPackageVersion() {
+    const candidates = [
+        (0, path_1.join)(__dirname, '..', 'package.json'),
+        (0, path_1.join)(__dirname, '..', '..', 'package.json'),
+    ];
+    for (const pkgPath of candidates) {
+        if ((0, fs_1.existsSync)(pkgPath)) {
+            const pkg = JSON.parse((0, fs_1.readFileSync)(pkgPath, 'utf-8'));
+            return pkg.version ?? '0.0.0';
+        }
+    }
+    return '0.0.0';
+}
+//# sourceMappingURL=pkg-version.helper.js.map

package/dist/helpers/pkg-version.helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pkg-version.helper.js","sourceRoot":"","sources":["../../helpers/pkg-version.helper.ts"],"names":[],"mappings":";;AAMA,8CAYC;AAlBD,2BAA6C;AAC7C,+BAA2B;AAE3B;;GAEG;AACH,SAAgB,iBAAiB;IAC7B,MAAM,UAAU,GAAG;QACf,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,cAAc,CAAC;QACrC,IAAA,WAAI,EAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC;KAC9C,CAAA;IACD,KAAK,MAAM,OAAO,IAAI,UAAU,EAAE,CAAC;QAC/B,IAAI,IAAA,eAAU,EAAC,OAAO,CAAC,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAA,iBAAY,EAAC,OAAO,EAAE,OAAO,CAAC,CAAyB,CAAA;YAC9E,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAA;QACjC,CAAC;IACL,CAAC;IACD,OAAO,OAAO,CAAA;AAClB,CAAC"}

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

@@ -0,0 +1,7 @@
+/** Simple random */
+export declare function random(range: number): number;
+/** Random element of array */
+export declare function randomOf<T = number>(arr: Array<T>): T;
+/** Get value by distribution */
+export declare function getByChance(distArray: Array<number> | Uint8Array): number;
+//# sourceMappingURL=random.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.helper.d.ts","sourceRoot":"","sources":["../../helpers/random.helper.ts"],"names":[],"mappings":"AAAA,oBAAoB;AACpB,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAE5C;AAED,8BAA8B;AAC9B,wBAAgB,QAAQ,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,EAAE,KAAK,CAAE,CAAC,CAAC,GAAG,CAAC,CAEtD;AAED,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,SAAS,EAAE,KAAK,CAAE,MAAM,CAAC,GAAG,UAAU,GAAG,MAAM,CAE1E"}

package/dist/helpers/random.helper.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.random = random;
+exports.randomOf = randomOf;
+exports.getByChance = getByChance;
+/** Simple random */
+function random(range) {
+    return Math.floor(Math.random() * 2000000000) % range;
+}
+/** Random element of array */
+function randomOf(arr) {
+    return arr[random(arr.length)];
+}
+/** Get value by distribution */
+function getByChance(distArray) {
+    return distArray[random(distArray.length)];
+}
+//# sourceMappingURL=random.helper.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"random.helper.js","sourceRoot":"","sources":["../../helpers/random.helper.ts"],"names":[],"mappings":";;AACA,wBAEC;AAGD,4BAEC;AAGD,kCAEC;AAbD,oBAAoB;AACpB,SAAgB,MAAM,CAAC,KAAa;IAChC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,UAAU,CAAC,GAAG,KAAK,CAAA;AACzD,CAAC;AAED,8BAA8B;AAC9B,SAAgB,QAAQ,CAAa,GAAc;IAC/C,OAAO,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAA;AAClC,CAAC;AAED,gCAAgC;AAChC,SAAgB,WAAW,CAAC,SAAsC;IAC9D,OAAO,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAA;AAC9C,CAAC"}

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

@@ -0,0 +1,9 @@
+import { Schema, ValidateFunction } from 'ajv';
+import { FastifyTypebox } from './fastify.helper';
+export declare function testBuild(): FastifyTypebox;
+export declare const testHeaders: {
+    "x-api-key": string;
+};
+export declare function validator(schema: Schema): ValidateFunction;
+export declare function checkSchemaPropertyDescriptions(props: Record<string, any>): void;
+//# sourceMappingURL=tests.helper.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tests.helper.d.ts","sourceRoot":"","sources":["../../helpers/tests.helper.ts"],"names":[],"mappings":"AACA,OAAY,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,KAAK,CAAA;AAInD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,wBAAgB,SAAS,IAAI,cAAc,CAQ1C;AAED,eAAO,MAAM,WAAW;;CAEvB,CAAA;AAED,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,gBAAgB,CAK1D;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,QAgBzE"}