max-nestjs 0.0.5 → 0.0.6

package/dist/constants.d.ts

@@ -0,0 +1,20 @@
+export declare const UPDATE_METADATA = "MAX_UPDATE_METADATA";
+export declare const SCENE_METADATA = "MAX_SCENE_METADATA";
+export declare const COMPOSER_METADATA = "MAX_COMPOSER_METADATA";
+export declare const LISTENERS_METADATA = "MAX_LISTENERS_METADATA";
+export declare const WIZARD_STEP_METADATA = "MAX_WIZARD_STEP_METADATA";
+export declare const MAX_MODULE_OPTIONS = "MAX_MODULE_OPTIONS";
+export declare const MAX_BOT_NAME = "MAX_BOT_NAME";
+export declare const MAX_STAGE = "MAX_STAGE";
+export declare const DEFAULT_BOT_NAME = "DEFAULT_MAX_BOT";
+export declare const PARAM_ARGS_METADATA = "__routeArguments__";
+export declare const DEFAULT_MAX_INIT_DATA_HEADER = "x-max-init-data";
+export declare const MAX_WEB_APP_DATA_KEY = "WebAppData";
+/** Тип параметра обработчика, разрешаемый MaxParamsFactory. */
+export declare enum MaxParamtype {
+    CONTEXT = 0,
+    NEXT = 1,
+    SENDER = 2,
+    MESSAGE = 3,
+    PAYLOAD = 4
+}

package/dist/constants.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxParamtype = exports.MAX_WEB_APP_DATA_KEY = exports.DEFAULT_MAX_INIT_DATA_HEADER = exports.PARAM_ARGS_METADATA = exports.DEFAULT_BOT_NAME = exports.MAX_STAGE = exports.MAX_BOT_NAME = exports.MAX_MODULE_OPTIONS = exports.WIZARD_STEP_METADATA = exports.LISTENERS_METADATA = exports.COMPOSER_METADATA = exports.SCENE_METADATA = exports.UPDATE_METADATA = void 0;
+const constants_1 = require("@nestjs/common/constants");
+// Метаданные классов/методов
+exports.UPDATE_METADATA = 'MAX_UPDATE_METADATA';
+exports.SCENE_METADATA = 'MAX_SCENE_METADATA';
+exports.COMPOSER_METADATA = 'MAX_COMPOSER_METADATA';
+exports.LISTENERS_METADATA = 'MAX_LISTENERS_METADATA';
+exports.WIZARD_STEP_METADATA = 'MAX_WIZARD_STEP_METADATA';
+// DI-токены
+exports.MAX_MODULE_OPTIONS = 'MAX_MODULE_OPTIONS';
+exports.MAX_BOT_NAME = 'MAX_BOT_NAME';
+exports.MAX_STAGE = 'MAX_STAGE';
+exports.DEFAULT_BOT_NAME = 'DEFAULT_MAX_BOT';
+// Метаданные параметров (переиспользуем nest-овский ключ ROUTE_ARGS)
+exports.PARAM_ARGS_METADATA = constants_1.ROUTE_ARGS_METADATA;
+exports.DEFAULT_MAX_INIT_DATA_HEADER = 'x-max-init-data';
+exports.MAX_WEB_APP_DATA_KEY = 'WebAppData';
+/** Тип параметра обработчика, разрешаемый MaxParamsFactory. */
+var MaxParamtype;
+(function (MaxParamtype) {
+    MaxParamtype[MaxParamtype["CONTEXT"] = 0] = "CONTEXT";
+    MaxParamtype[MaxParamtype["NEXT"] = 1] = "NEXT";
+    MaxParamtype[MaxParamtype["SENDER"] = 2] = "SENDER";
+    MaxParamtype[MaxParamtype["MESSAGE"] = 3] = "MESSAGE";
+    MaxParamtype[MaxParamtype["PAYLOAD"] = 4] = "PAYLOAD";
+})(MaxParamtype || (exports.MaxParamtype = MaxParamtype = {}));
+//# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,wDAA8D;AAE9D,6BAA6B;AAChB,QAAA,eAAe,GAAG,qBAAqB,CAAA;AACvC,QAAA,cAAc,GAAG,oBAAoB,CAAA;AACrC,QAAA,iBAAiB,GAAG,uBAAuB,CAAA;AAC3C,QAAA,kBAAkB,GAAG,wBAAwB,CAAA;AAC7C,QAAA,oBAAoB,GAAG,0BAA0B,CAAA;AAE9D,YAAY;AACC,QAAA,kBAAkB,GAAG,oBAAoB,CAAA;AACzC,QAAA,YAAY,GAAG,cAAc,CAAA;AAC7B,QAAA,SAAS,GAAG,WAAW,CAAA;AACvB,QAAA,gBAAgB,GAAG,iBAAiB,CAAA;AAEjD,qEAAqE;AACxD,QAAA,mBAAmB,GAAG,+BAAmB,CAAA;AAEzC,QAAA,4BAA4B,GAAG,iBAAiB,CAAA;AAChD,QAAA,oBAAoB,GAAG,YAAY,CAAA;AAEhD,+DAA+D;AAC/D,IAAY,YAMX;AAND,WAAY,YAAY;IACtB,qDAAO,CAAA;IACP,+CAAI,CAAA;IACJ,mDAAM,CAAA;IACN,qDAAO,CAAA;IACP,qDAAO,CAAA;AACT,CAAC,EANW,YAAY,4BAAZ,YAAY,QAMvB"}

package/dist/{max-user.decorator.js → decorators/auth.js}

@@ -10,4 +10,4 @@ exports.MaxUser = (0, common_1.createParamDecorator)((prop = null, ctx) => {
     }
     return prop ? user[prop] : user;
 });
-//# sourceMappingURL=max-user.decorator.js.map
+//# sourceMappingURL=auth.js.map

package/dist/decorators/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../../src/decorators/auth.ts"],"names":[],"mappings":";;;AAAA,2CAA4E;AAG/D,QAAA,OAAO,GAAG,IAAA,6BAAoB,EACzC,CAAC,OAAiC,IAAI,EAAE,GAAqB,EAAE,EAAE;IAC/D,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC,UAAU,EAAc,CAAA;IAC3D,MAAM,IAAI,GAAG,OAAO,EAAE,WAAW,EAAE,IAAI,CAAA;IAEvC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,IAAI,CAAA;IACb,CAAC;IAED,OAAO,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACjC,CAAC,CACF,CAAA"}

package/dist/decorators/common.d.ts

@@ -0,0 +1,28 @@
+import { Context } from '@maxhub/max-bot-api';
+import { SceneOptions } from '../scenes';
+/** Класс-обработчик апдейтов (аналог `@Controller`). Регистрируется на боте. */
+export declare const Update: () => ClassDecorator;
+/** Класс-обработчик отдельного composer'а; добавляется в Stage до сцен. */
+export declare const MaxComposer: () => ClassDecorator;
+/** Базовая сцена. */
+export declare const Scene: (sceneId: string, options?: SceneOptions<Context>) => ClassDecorator;
+/** Wizard-сцена (пошаговый диалог). */
+export declare const Wizard: (sceneId: string, options?: SceneOptions<Context>) => ClassDecorator;
+/** Инжект бота по имени. */
+export declare const InjectBot: (botName?: string) => ParameterDecorator;
+export declare const Use: (...args: unknown[]) => MethodDecorator;
+export declare const On: (...args: ("message_callback" | "message_created" | "message_removed" | "message_edited" | "bot_added" | "bot_removed" | "user_added" | "user_removed" | "bot_started" | "chat_title_changed" | "message_construction_request" | "message_constructed" | "message_chat_created")[]) => MethodDecorator;
+export declare const Command: (...args: unknown[]) => MethodDecorator;
+export declare const Hears: (...args: unknown[]) => MethodDecorator;
+export declare const Action: (...args: unknown[]) => MethodDecorator;
+/** Обработчик входа в сцену. */
+export declare const SceneEnter: (...args: unknown[]) => MethodDecorator;
+/** Обработчик выхода из сцены. */
+export declare const SceneLeave: (...args: unknown[]) => MethodDecorator;
+/** Шаг wizard-сцены (нумерация с 0). */
+export declare const WizardStep: (step: number) => MethodDecorator;
+export declare const Ctx: (data?: string) => ParameterDecorator;
+export declare const Next: (data?: string) => ParameterDecorator;
+export declare const Sender: (data?: string) => ParameterDecorator;
+export declare const Message: (data?: string) => ParameterDecorator;
+export declare const Payload: (data?: string) => ParameterDecorator;

package/dist/decorators/common.js

@@ -0,0 +1,42 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Payload = exports.Message = exports.Sender = exports.Next = exports.Ctx = exports.WizardStep = exports.SceneLeave = exports.SceneEnter = exports.Action = exports.Hears = exports.Command = exports.On = exports.Use = exports.InjectBot = exports.Wizard = exports.Scene = exports.MaxComposer = exports.Update = void 0;
+const common_1 = require("@nestjs/common");
+const constants_1 = require("../constants");
+const utils_1 = require("../utils");
+// ── Классы ───────────────────────────────────────────────────────────────────
+/** Класс-обработчик апдейтов (аналог `@Controller`). Регистрируется на боте. */
+const Update = () => (0, common_1.SetMetadata)(constants_1.UPDATE_METADATA, true);
+exports.Update = Update;
+/** Класс-обработчик отдельного composer'а; добавляется в Stage до сцен. */
+const MaxComposer = () => (0, common_1.SetMetadata)(constants_1.COMPOSER_METADATA, true);
+exports.MaxComposer = MaxComposer;
+/** Базовая сцена. */
+const Scene = (sceneId, options) => (0, common_1.SetMetadata)(constants_1.SCENE_METADATA, { sceneId, type: 'base', options });
+exports.Scene = Scene;
+/** Wizard-сцена (пошаговый диалог). */
+const Wizard = (sceneId, options) => (0, common_1.SetMetadata)(constants_1.SCENE_METADATA, { sceneId, type: 'wizard', options });
+exports.Wizard = Wizard;
+/** Инжект бота по имени. */
+const InjectBot = (botName) => (0, common_1.Inject)((0, utils_1.getBotToken)(botName));
+exports.InjectBot = InjectBot;
+// ── Слушатели методов ────────────────────────────────────────────────────────
+exports.Use = (0, utils_1.createListenerDecorator)('use');
+exports.On = (0, utils_1.createListenerDecorator)('on');
+exports.Command = (0, utils_1.createListenerDecorator)('command');
+exports.Hears = (0, utils_1.createListenerDecorator)('hears');
+exports.Action = (0, utils_1.createListenerDecorator)('action');
+/** Обработчик входа в сцену. */
+exports.SceneEnter = (0, utils_1.createListenerDecorator)('enter');
+/** Обработчик выхода из сцены. */
+exports.SceneLeave = (0, utils_1.createListenerDecorator)('leave');
+/** Шаг wizard-сцены (нумерация с 0). */
+const WizardStep = (step) => (0, common_1.SetMetadata)(constants_1.WIZARD_STEP_METADATA, { step });
+exports.WizardStep = WizardStep;
+// ── Параметры ────────────────────────────────────────────────────────────────
+exports.Ctx = (0, utils_1.createParamDecorator)(constants_1.MaxParamtype.CONTEXT);
+exports.Next = (0, utils_1.createParamDecorator)(constants_1.MaxParamtype.NEXT);
+exports.Sender = (0, utils_1.createParamDecorator)(constants_1.MaxParamtype.SENDER);
+exports.Message = (0, utils_1.createParamDecorator)(constants_1.MaxParamtype.MESSAGE);
+exports.Payload = (0, utils_1.createParamDecorator)(constants_1.MaxParamtype.PAYLOAD);
+//# sourceMappingURL=common.js.map

package/dist/decorators/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../src/decorators/common.ts"],"names":[],"mappings":";;;AAAA,2CAAoD;AAEpD,4CAMqB;AAGrB,oCAAqF;AAGrF,gFAAgF;AAEhF,gFAAgF;AACzE,MAAM,MAAM,GAAG,GAAmB,EAAE,CAAC,IAAA,oBAAW,EAAC,2BAAe,EAAE,IAAI,CAAC,CAAA;AAAjE,QAAA,MAAM,UAA2D;AAE9E,2EAA2E;AACpE,MAAM,WAAW,GAAG,GAAmB,EAAE,CAAC,IAAA,oBAAW,EAAC,6BAAiB,EAAE,IAAI,CAAC,CAAA;AAAxE,QAAA,WAAW,eAA6D;AAErF,qBAAqB;AACd,MAAM,KAAK,GAAG,CAAC,OAAe,EAAE,OAA+B,EAAkB,EAAE,CACxF,IAAA,oBAAW,EAAwB,0BAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC,CAAA;AAD3E,QAAA,KAAK,SACsE;AAExF,uCAAuC;AAChC,MAAM,MAAM,GAAG,CAAC,OAAe,EAAE,OAA+B,EAAkB,EAAE,CACzF,IAAA,oBAAW,EAAwB,0BAAc,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC,CAAA;AAD7E,QAAA,MAAM,UACuE;AAE1F,4BAA4B;AACrB,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAsB,EAAE,CAAC,IAAA,eAAM,EAAC,IAAA,mBAAW,EAAC,OAAO,CAAC,CAAC,CAAA;AAAlF,QAAA,SAAS,aAAyE;AAE/F,gFAAgF;AAEnE,QAAA,GAAG,GAAG,IAAA,+BAAuB,EAAC,KAAK,CAAC,CAAA;AACpC,QAAA,EAAE,GAAG,IAAA,+BAAuB,EAAa,IAAI,CAAC,CAAA;AAC9C,QAAA,OAAO,GAAG,IAAA,+BAAuB,EAAC,SAAS,CAAC,CAAA;AAC5C,QAAA,KAAK,GAAG,IAAA,+BAAuB,EAAC,OAAO,CAAC,CAAA;AACxC,QAAA,MAAM,GAAG,IAAA,+BAAuB,EAAC,QAAQ,CAAC,CAAA;AAEvD,gCAAgC;AACnB,QAAA,UAAU,GAAG,IAAA,+BAAuB,EAAC,OAAO,CAAC,CAAA;AAC1D,kCAAkC;AACrB,QAAA,UAAU,GAAG,IAAA,+BAAuB,EAAC,OAAO,CAAC,CAAA;AAE1D,wCAAwC;AACjC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAmB,EAAE,CAC1D,IAAA,oBAAW,EAA6B,gCAAoB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAA;AAD5D,QAAA,UAAU,cACkD;AAEzE,gFAAgF;AAEnE,QAAA,GAAG,GAAG,IAAA,4BAAoB,EAAC,wBAAY,CAAC,OAAO,CAAC,CAAA;AAChD,QAAA,IAAI,GAAG,IAAA,4BAAoB,EAAC,wBAAY,CAAC,IAAI,CAAC,CAAA;AAC9C,QAAA,MAAM,GAAG,IAAA,4BAAoB,EAAC,wBAAY,CAAC,MAAM,CAAC,CAAA;AAClD,QAAA,OAAO,GAAG,IAAA,4BAAoB,EAAC,wBAAY,CAAC,OAAO,CAAC,CAAA;AACpD,QAAA,OAAO,GAAG,IAAA,4BAAoB,EAAC,wBAAY,CAAC,OAAO,CAAC,CAAA"}

package/dist/decorators/index.d.ts

@@ -0,0 +1,2 @@
+export * from './auth';
+export * from './common';

package/dist/decorators/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./auth"), exports);
+__exportStar(require("./common"), exports);
+//# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,yCAAsB;AACtB,2CAAwB"}

package/dist/execution-context.d.ts

@@ -0,0 +1,20 @@
+import { ArgumentsHost, ContextType, ExecutionContext } from '@nestjs/common';
+import { ExecutionContextHost } from '@nestjs/core/helpers/execution-context-host';
+export type MaxContextType = 'max' | ContextType;
+/**
+ * ExecutionContext для MAX-обработчиков. Позволяет guard'ам и param-декораторам
+ * (`@AuthUser`) достать `ctx`/`next` из аргументов `(ctx, next)`.
+ * Аналог `TelegrafExecutionContext` из nestjs-telegraf.
+ */
+export declare class MaxExecutionContext extends ExecutionContextHost {
+    static create(context: ExecutionContext): MaxExecutionContext;
+    getType<TContext extends string = MaxContextType>(): TContext;
+    getContext<T = unknown>(): T;
+    getNext<T = unknown>(): T;
+}
+/** Облегчённый ArgumentsHost (для exception-фильтров). */
+export declare class MaxArgumentsHost extends ExecutionContextHost {
+    static create(context: ArgumentsHost): MaxArgumentsHost;
+    getContext<T = unknown>(): T;
+    getNext<T = unknown>(): T;
+}

package/dist/execution-context.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxArgumentsHost = exports.MaxExecutionContext = void 0;
+const execution_context_host_1 = require("@nestjs/core/helpers/execution-context-host");
+/**
+ * ExecutionContext для MAX-обработчиков. Позволяет guard'ам и param-декораторам
+ * (`@AuthUser`) достать `ctx`/`next` из аргументов `(ctx, next)`.
+ * Аналог `TelegrafExecutionContext` из nestjs-telegraf.
+ */
+class MaxExecutionContext extends execution_context_host_1.ExecutionContextHost {
+    static create(context) {
+        const type = context.getType();
+        const ctx = new MaxExecutionContext(context.getArgs(), context.getClass(), context.getHandler());
+        ctx.setType(type);
+        return ctx;
+    }
+    getType() {
+        return super.getType();
+    }
+    getContext() {
+        return this.getArgByIndex(0);
+    }
+    getNext() {
+        return this.getArgByIndex(1);
+    }
+}
+exports.MaxExecutionContext = MaxExecutionContext;
+/** Облегчённый ArgumentsHost (для exception-фильтров). */
+class MaxArgumentsHost extends execution_context_host_1.ExecutionContextHost {
+    static create(context) {
+        const host = new MaxArgumentsHost(context.getArgs());
+        host.setType(context.getType());
+        return host;
+    }
+    getContext() {
+        return this.getArgByIndex(0);
+    }
+    getNext() {
+        return this.getArgByIndex(1);
+    }
+}
+exports.MaxArgumentsHost = MaxArgumentsHost;
+//# sourceMappingURL=execution-context.js.map

package/dist/execution-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execution-context.js","sourceRoot":"","sources":["../src/execution-context.ts"],"names":[],"mappings":";;;AACA,wFAAkF;AAIlF;;;;GAIG;AACH,MAAa,mBAAoB,SAAQ,6CAAoB;IAC3D,MAAM,CAAC,MAAM,CAAC,OAAyB;QACrC,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,EAAE,CAAA;QAC9B,MAAM,GAAG,GAAG,IAAI,mBAAmB,CACjC,OAAO,CAAC,OAAO,EAAE,EACjB,OAAO,CAAC,QAAQ,EAAE,EAClB,OAAO,CAAC,UAAU,EAAE,CACrB,CAAA;QACD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;QACjB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,OAAO;QACL,OAAO,KAAK,CAAC,OAAO,EAAE,CAAA;IACxB,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;CACF;AAvBD,kDAuBC;AAED,0DAA0D;AAC1D,MAAa,gBAAiB,SAAQ,6CAAoB;IACxD,MAAM,CAAC,MAAM,CAAC,OAAsB;QAClC,MAAM,IAAI,GAAG,IAAI,gBAAgB,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QACpD,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAA;QAC/B,OAAO,IAAI,CAAA;IACb,CAAC;IAED,UAAU;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;IAED,OAAO;QACL,OAAO,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC;CACF;AAdD,4CAcC"}

package/dist/guards/auth.guard.d.ts

@@ -0,0 +1,9 @@
+import { CanActivate, type ExecutionContext } from '@nestjs/common';
+import { MaxValidationService } from '../validation';
+import { MaxModuleOptions } from '../interfaces';
+export declare class MaxAuthGuard implements CanActivate {
+    private readonly options;
+    private readonly validationService;
+    constructor(options: MaxModuleOptions, validationService: MaxValidationService);
+    canActivate(context: ExecutionContext): boolean;
+}

package/dist/{max-auth.guard.js → guards/auth.guard.js}

@@ -14,20 +14,20 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MaxAuthGuard = void 0;
 const common_1 = require("@nestjs/common");
-const max_constants_1 = require("./max.constants");
-const max_validation_1 = require("./max.validation");
+const validation_1 = require("../validation");
+const constants_1 = require("../constants");
 let MaxAuthGuard = class MaxAuthGuard {
-    constructor(options, maxValidationService) {
+    constructor(options, validationService) {
         this.options = options;
-        this.maxValidationService = maxValidationService;
+        this.validationService = validationService;
     }
     canActivate(context) {
         const request = context.switchToHttp().getRequest();
-        const rawInitData = request.headers[this.options.headerName];
+        const rawInitData = request.headers[this.options.headerName ?? constants_1.DEFAULT_MAX_INIT_DATA_HEADER];
         if (!rawInitData || typeof rawInitData !== 'string') {
             throw new common_1.UnauthorizedException('MAX init data is missing');
         }
-        const initData = this.maxValidationService.verify(rawInitData);
+        const initData = this.validationService.verify(rawInitData);
         request.maxInitData = initData;
         return true;
     }
@@ -35,7 +35,7 @@ let MaxAuthGuard = class MaxAuthGuard {
 exports.MaxAuthGuard = MaxAuthGuard;
 exports.MaxAuthGuard = MaxAuthGuard = __decorate([
     (0, common_1.Injectable)(),
-    __param(0, (0, common_1.Inject)(max_constants_1.MAX_OPTIONS_SYMBOL)),
-    __metadata("design:paramtypes", [Object, max_validation_1.MaxValidationService])
+    __param(0, (0, common_1.Inject)(constants_1.MAX_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [Object, validation_1.MaxValidationService])
 ], MaxAuthGuard);
-//# sourceMappingURL=max-auth.guard.js.map
+//# sourceMappingURL=auth.guard.js.map

package/dist/guards/auth.guard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.guard.js","sourceRoot":"","sources":["../../src/guards/auth.guard.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;AAAA,2CAMuB;AAEvB,8CAAoD;AAEpD,4CAA+E;AAGxE,IAAM,YAAY,GAAlB,MAAM,YAAY;IACvB,YAEmB,OAAyB,EACzB,iBAAuC;QADvC,YAAO,GAAP,OAAO,CAAkB;QACzB,sBAAiB,GAAjB,iBAAiB,CAAsB;IACvD,CAAC;IAEG,WAAW,CAAC,OAAyB;QAC1C,MAAM,OAAO,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,UAAU,EAAc,CAAA;QAC/D,MAAM,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,wCAA4B,CAAC,CAAA;QAE5F,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ,EAAE,CAAC;YACpD,MAAM,IAAI,8BAAqB,CAAC,0BAA0B,CAAC,CAAA;QAC7D,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;QAE3D,OAAO,CAAC,WAAW,GAAG,QAAQ,CAAA;QAE9B,OAAO,IAAI,CAAA;IACb,CAAC;CACF,CAAA;AArBY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,mBAAU,GAAE;IAGR,WAAA,IAAA,eAAM,EAAC,8BAAkB,CAAC,CAAA;6CAES,iCAAoB;GAJ/C,YAAY,CAqBxB"}

package/dist/index.d.ts

@@ -1,8 +1,11 @@
-export * from './max.constants';
-export * from './max.interface';
-export * from './max.module';
-export * from './max-auth.guard';
-export * from './max.validation';
-export { MaxUser } from './max-user.decorator';
-export type { MaxInitData, MaxRequest, MaxUserData } from './types';
-export type { MaxBridgeInitData, MaxBridgeInitDataChat, MaxBridgeInitDataUser } from 'max-bridge';
+export * from './scenes';
+export * from './decorators';
+export * from './guards/auth.guard';
+export * from './interfaces';
+export { MaxCoreModule } from './max.module';
+export { MAX_BOT_NAME, MAX_STAGE, MAX_MODULE_OPTIONS, MaxParamtype } from './constants';
+export { getBotToken } from './utils';
+export { MaxParamsFactory } from './params.factory';
+export { MaxExecutionContext, MaxArgumentsHost } from './execution-context';
+export type { MaxContextType } from './execution-context';
+export { MetadataAccessorService, ListenersExplorerService, BaseExplorerService } from './services';

package/dist/index.js

@@ -14,12 +14,28 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaxUser = void 0;
-__exportStar(require("./max.constants"), exports);
-__exportStar(require("./max.interface"), exports);
-__exportStar(require("./max.module"), exports);
-__exportStar(require("./max-auth.guard"), exports);
-__exportStar(require("./max.validation"), exports);
-var max_user_decorator_1 = require("./max-user.decorator");
-Object.defineProperty(exports, "MaxUser", { enumerable: true, get: function () { return max_user_decorator_1.MaxUser; } });
+exports.BaseExplorerService = exports.ListenersExplorerService = exports.MetadataAccessorService = exports.MaxArgumentsHost = exports.MaxExecutionContext = exports.MaxParamsFactory = exports.getBotToken = exports.MaxParamtype = exports.MAX_MODULE_OPTIONS = exports.MAX_STAGE = exports.MAX_BOT_NAME = exports.MaxCoreModule = void 0;
+// Публичный API мини-фреймворка сцен/wizard для @maxhub/max-bot-api.
+__exportStar(require("./scenes"), exports);
+__exportStar(require("./decorators"), exports);
+__exportStar(require("./guards/auth.guard"), exports);
+__exportStar(require("./interfaces"), exports);
+var max_module_1 = require("./max.module");
+Object.defineProperty(exports, "MaxCoreModule", { enumerable: true, get: function () { return max_module_1.MaxCoreModule; } });
+var constants_1 = require("./constants");
+Object.defineProperty(exports, "MAX_BOT_NAME", { enumerable: true, get: function () { return constants_1.MAX_BOT_NAME; } });
+Object.defineProperty(exports, "MAX_STAGE", { enumerable: true, get: function () { return constants_1.MAX_STAGE; } });
+Object.defineProperty(exports, "MAX_MODULE_OPTIONS", { enumerable: true, get: function () { return constants_1.MAX_MODULE_OPTIONS; } });
+Object.defineProperty(exports, "MaxParamtype", { enumerable: true, get: function () { return constants_1.MaxParamtype; } });
+var utils_1 = require("./utils");
+Object.defineProperty(exports, "getBotToken", { enumerable: true, get: function () { return utils_1.getBotToken; } });
+var params_factory_1 = require("./params.factory");
+Object.defineProperty(exports, "MaxParamsFactory", { enumerable: true, get: function () { return params_factory_1.MaxParamsFactory; } });
+var execution_context_1 = require("./execution-context");
+Object.defineProperty(exports, "MaxExecutionContext", { enumerable: true, get: function () { return execution_context_1.MaxExecutionContext; } });
+Object.defineProperty(exports, "MaxArgumentsHost", { enumerable: true, get: function () { return execution_context_1.MaxArgumentsHost; } });
+var services_1 = require("./services");
+Object.defineProperty(exports, "MetadataAccessorService", { enumerable: true, get: function () { return services_1.MetadataAccessorService; } });
+Object.defineProperty(exports, "ListenersExplorerService", { enumerable: true, get: function () { return services_1.ListenersExplorerService; } });
+Object.defineProperty(exports, "BaseExplorerService", { enumerable: true, get: function () { return services_1.BaseExplorerService; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,kDAA+B;AAC/B,kDAA+B;AAC/B,+CAA4B;AAC5B,mDAAgC;AAChC,mDAAgC;AAChC,2DAA8C;AAArC,6GAAA,OAAO,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,qEAAqE;AACrE,2CAAwB;AACxB,+CAA4B;AAC5B,sDAAmC;AACnC,+CAA4B;AAC5B,2CAA4C;AAAnC,2GAAA,aAAa,OAAA;AACtB,yCAAuF;AAA9E,yGAAA,YAAY,OAAA;AAAE,sGAAA,SAAS,OAAA;AAAE,+GAAA,kBAAkB,OAAA;AAAE,yGAAA,YAAY,OAAA;AAClE,iCAAqC;AAA5B,oGAAA,WAAW,OAAA;AACpB,mDAAmD;AAA1C,kHAAA,gBAAgB,OAAA;AACzB,yDAA2E;AAAlE,wHAAA,mBAAmB,OAAA;AAAE,qHAAA,gBAAgB,OAAA;AAE9C,uCAAmG;AAA1F,mHAAA,uBAAuB,OAAA;AAAE,oHAAA,wBAAwB,OAAA;AAAE,+GAAA,mBAAmB,OAAA"}

package/dist/interfaces.d.ts

@@ -0,0 +1,44 @@
+import { ModuleMetadata, Type } from '@nestjs/common';
+import { Bot, Context, Middleware } from '@maxhub/max-bot-api';
+import { SceneOptions } from './scenes';
+/** Запись слушателя метода: имя метода composer'а + его аргументы. */
+export interface ListenerMetadata {
+    method: 'use' | 'on' | 'command' | 'hears' | 'action' | 'enter' | 'leave';
+    args: unknown[];
+}
+export interface SceneMetadata {
+    sceneId: string;
+    type: 'base' | 'wizard';
+    options?: SceneOptions<Context>;
+}
+export interface WizardStepMetadata {
+    step: number;
+}
+export interface MaxModuleOptions {
+    token: string;
+    botName?: string;
+    /** Кастомный класс контекста (по умолчанию `WizardContext`). */
+    contextType?: new (...args: ConstructorParameters<typeof Context>) => Context;
+    /** Ограничить сканирование указанными модулями. */
+    include?: Function[];
+    /** Дополнительные middleware, применяемые сразу после session. */
+    middlewares?: ReadonlyArray<Middleware<Context>>;
+    /** Запускать ли polling (false для dev/тестов). */
+    launch?: boolean;
+    /**
+     * Имя HTTP-заголовка, из которого guard читает raw init data.
+     * По умолчанию: `x-max-init-data`.
+     */
+    headerName?: string;
+}
+export interface MaxOptionsFactory {
+    createMaxOptions(): Promise<MaxModuleOptions> | MaxModuleOptions;
+}
+export interface MaxModuleAsyncOptions extends Pick<ModuleMetadata, 'imports'> {
+    botName?: string;
+    useExisting?: Type<MaxOptionsFactory>;
+    useClass?: Type<MaxOptionsFactory>;
+    useFactory?: (...args: any[]) => Promise<MaxModuleOptions> | MaxModuleOptions;
+    inject?: any[];
+}
+export type MaxBot = Bot<Context>;

package/dist/{max.interface.js → interfaces.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=max.interface.js.map
+//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":""}

package/dist/max.module.d.ts

@@ -1,5 +1,23 @@
-import { type DynamicModule } from '@nestjs/common';
-import type { MaxModuleOptions } from './max.interface';
-export declare class MaxModule {
+import { DynamicModule, OnApplicationBootstrap, OnApplicationShutdown } from '@nestjs/common';
+import { ModuleRef } from '@nestjs/core';
+import { MaxModuleAsyncOptions, MaxModuleOptions } from './interfaces';
+/**
+ * Корневой модуль мини-фреймворка сцен/wizard для @maxhub/max-bot-api.
+ * Аналог `TelegrafModule` из nestjs-telegraf.
+ */
+export declare class MaxCoreModule implements OnApplicationBootstrap, OnApplicationShutdown {
+    private readonly botName;
+    private readonly options;
+    private readonly moduleRef;
+    private readonly logger;
+    private isStopping;
+    private bot?;
+    constructor(botName: string, options: MaxModuleOptions, moduleRef: ModuleRef);
     static forRoot(options: MaxModuleOptions): DynamicModule;
+    static forRootAsync(options: MaxModuleAsyncOptions): DynamicModule;
+    private static coreProviders;
+    private static createAsyncProviders;
+    onApplicationBootstrap(): void;
+    private initialize;
+    onApplicationShutdown(): void;
 }