max-nestjs 0.0.4 → 0.0.6

package/dist/max.module.js

@@ -5,42 +5,165 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var MaxModule_1;
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var MaxCoreModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.MaxModule = void 0;
+exports.MaxCoreModule = void 0;
 const common_1 = require("@nestjs/common");
-const max_constants_1 = require("./max.constants");
-const max_auth_guard_1 = require("./max-auth.guard");
-let MaxModule = MaxModule_1 = class MaxModule {
+const core_1 = require("@nestjs/core");
+const max_bot_api_1 = require("@maxhub/max-bot-api");
+const constants_1 = require("./constants");
+const services_1 = require("./services");
+const scenes_1 = require("./scenes");
+const utils_1 = require("./utils");
+const auth_guard_1 = require("./guards/auth.guard");
+const validation_1 = require("./validation");
+const RETRY_BASE_MS = 5000;
+const RETRY_MAX_MS = 60000;
+const formatError = (error) => error instanceof Error ? (error.stack ?? error.message) : String(error);
+/**
+ * Корневой модуль мини-фреймворка сцен/wizard для @maxhub/max-bot-api.
+ * Аналог `TelegrafModule` из nestjs-telegraf.
+ */
+let MaxCoreModule = MaxCoreModule_1 = class MaxCoreModule {
+    constructor(botName, options, moduleRef) {
+        this.botName = botName;
+        this.options = options;
+        this.moduleRef = moduleRef;
+        this.logger = new common_1.Logger(MaxCoreModule_1.name);
+        this.isStopping = false;
+    }
     static forRoot(options) {
+        if (!options.token.trim()) {
+            throw new Error('MAX bot token is required');
+        }
         return {
-            module: MaxModule_1,
+            module: MaxCoreModule_1,
+            global: true,
             providers: [
-                {
-                    provide: max_constants_1.MAX_OPTIONS_SYMBOL,
-                    useValue: normalizeOptions(options)
-                },
-                max_auth_guard_1.MaxAuthGuard
+                { provide: constants_1.MAX_MODULE_OPTIONS, useValue: options },
+                ...this.coreProviders((0, utils_1.getBotToken)(options.botName)),
+                validation_1.MaxValidationService,
+                auth_guard_1.MaxAuthGuard
+            ],
+            exports: [
+                constants_1.MAX_STAGE,
+                constants_1.MAX_MODULE_OPTIONS,
+                (0, utils_1.getBotToken)(options.botName),
+                validation_1.MaxValidationService,
+                auth_guard_1.MaxAuthGuard
+            ]
+        };
+    }
+    static forRootAsync(options) {
+        const botToken = (0, utils_1.getBotToken)(options.botName);
+        return {
+            module: MaxCoreModule_1,
+            global: true,
+            imports: options.imports ?? [],
+            providers: [
+                ...this.createAsyncProviders(options),
+                ...this.coreProviders(botToken),
+                validation_1.MaxValidationService,
+                auth_guard_1.MaxAuthGuard
             ],
-            exports: [max_constants_1.MAX_OPTIONS_SYMBOL, max_auth_guard_1.MaxAuthGuard],
-            global: true
+            exports: [constants_1.MAX_STAGE, constants_1.MAX_MODULE_OPTIONS, botToken, validation_1.MaxValidationService, auth_guard_1.MaxAuthGuard]
         };
     }
+    // Провайдеры, общие для forRoot/forRootAsync (бот, имя, stage).
+    static coreProviders(botToken) {
+        return [
+            { provide: constants_1.MAX_BOT_NAME, useValue: botToken },
+            { provide: constants_1.MAX_STAGE, useClass: scenes_1.Stage },
+            {
+                provide: botToken,
+                useFactory: (options) => {
+                    const contextType = options.contextType ?? scenes_1.WizardContext;
+                    const bot = new max_bot_api_1.Bot(options.token, { contextType });
+                    bot.use((0, scenes_1.session)());
+                    if (options.middlewares?.length) {
+                        bot.use(...options.middlewares);
+                    }
+                    bot.catch((error) => {
+                        // Отказ guard'а (CanActivate → false) бросает ForbiddenException;
+                        // пользователю уже ответил сам guard — шумить в лог не нужно.
+                        if (error instanceof common_1.ForbiddenException) {
+                            return;
+                        }
+                        common_1.Logger.error(`${formatError(error)}`, 'MaxBot');
+                    });
+                    return bot;
+                },
+                inject: [constants_1.MAX_MODULE_OPTIONS]
+            }
+        ];
+    }
+    static createAsyncProviders(options) {
+        if (options.useFactory) {
+            return [
+                {
+                    provide: constants_1.MAX_MODULE_OPTIONS,
+                    useFactory: options.useFactory,
+                    inject: options.inject ?? []
+                }
+            ];
+        }
+        const inject = (options.useExisting || options.useClass);
+        const providers = [
+            {
+                provide: constants_1.MAX_MODULE_OPTIONS,
+                useFactory: (factory) => factory.createMaxOptions(),
+                inject: [inject]
+            }
+        ];
+        if (options.useClass) {
+            providers.push({ provide: options.useClass, useClass: options.useClass });
+        }
+        return providers;
+    }
+    // ── Жизненный цикл polling'а ──────────────────────────────────────────────
+    onApplicationBootstrap() {
+        if (this.options.launch) {
+            this.bot = this.moduleRef.get(this.botName, { strict: false });
+            this.initialize();
+        }
+    }
+    initialize(attempt = 0) {
+        if (this.isStopping || !this.bot) {
+            return;
+        }
+        this.logger.log('MAX bot initializing ...');
+        this.bot.start().catch((error) => {
+            if (this.isStopping) {
+                return;
+            }
+            this.bot?.stop();
+            this.logger.error(`MAX bot polling crashed ${formatError(error)}`);
+            const delay = Math.min(RETRY_BASE_MS * 2 ** attempt, RETRY_MAX_MS);
+            this.logger.warn(`MAX bot restarting in ${delay / 1000}s (attempt ${attempt + 1})`);
+            setTimeout(() => this.initialize(attempt + 1), delay);
+        });
+    }
+    onApplicationShutdown() {
+        this.isStopping = true;
+        this.bot?.stop();
+        this.logger.log('MAX bot polling stopped');
+    }
 };
-exports.MaxModule = MaxModule;
-exports.MaxModule = MaxModule = MaxModule_1 = __decorate([
+exports.MaxCoreModule = MaxCoreModule;
+exports.MaxCoreModule = MaxCoreModule = MaxCoreModule_1 = __decorate([
     (0, common_1.Global)(),
-    (0, common_1.Module)({})
-], MaxModule);
-const normalizeOptions = (options) => {
-    const botToken = options.botToken.trim();
-    if (!botToken) {
-        throw new Error('MAX bot token is required');
-    }
-    const headerName = options.headerName?.trim() || max_constants_1.DEFAULT_MAX_INIT_DATA_HEADER;
-    return {
-        botToken,
-        headerName
-    };
-};
+    (0, common_1.Module)({
+        imports: [core_1.DiscoveryModule],
+        providers: [services_1.ListenersExplorerService, services_1.MetadataAccessorService]
+    }),
+    __param(0, (0, common_1.Inject)(constants_1.MAX_BOT_NAME)),
+    __param(1, (0, common_1.Inject)(constants_1.MAX_MODULE_OPTIONS)),
+    __metadata("design:paramtypes", [String, Object, core_1.ModuleRef])
+], MaxCoreModule);
 //# sourceMappingURL=max.module.js.map

package/dist/max.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"max.module.js","sourceRoot":"","sources":["../src/max.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAmE;AACnE,mDAAkF;AAElF,qDAA+C;AAIxC,IAAM,SAAS,iBAAf,MAAM,SAAS;IACb,MAAM,CAAC,OAAO,CAAC,OAAyB;QAC7C,OAAO;YACL,MAAM,EAAE,WAAS;YACjB,SAAS,EAAE;gBACT;oBACE,OAAO,EAAE,kCAAkB;oBAC3B,QAAQ,EAAE,gBAAgB,CAAC,OAAO,CAAC;iBACpC;gBACD,6BAAY;aACb;YACD,OAAO,EAAE,CAAC,kCAAkB,EAAE,6BAAY,CAAC;YAC3C,MAAM,EAAE,IAAI;SACb,CAAA;IACH,CAAC;CACF,CAAA;AAfY,8BAAS;oBAAT,SAAS;IAFrB,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,SAAS,CAerB;AAED,MAAM,gBAAgB,GAAG,CAAC,OAAyB,EAA4B,EAAE;IAC/E,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;IAExC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAA;IAC9C,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,4CAA4B,CAAA;IAE7E,OAAO;QACL,QAAQ;QACR,UAAU;KACX,CAAA;AACH,CAAC,CAAA"}
+{"version":3,"file":"max.module.js","sourceRoot":"","sources":["../src/max.module.ts"],"names":[],"mappings":"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"}

package/dist/params.factory.d.ts

@@ -0,0 +1,7 @@
+import { ParamData } from '@nestjs/common';
+import { ParamsFactory } from '@nestjs/core/helpers/external-context-creator';
+import { MaxParamtype } from './constants';
+/** Разрешает значения параметр-декораторов из `(ctx, next)`. */
+export declare class MaxParamsFactory implements ParamsFactory {
+    exchangeKeyForValue(type: MaxParamtype, data: ParamData, args: unknown[]): unknown;
+}

package/dist/params.factory.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MaxParamsFactory = void 0;
+const constants_1 = require("./constants");
+/** Разрешает значения параметр-декораторов из `(ctx, next)`. */
+class MaxParamsFactory {
+    exchangeKeyForValue(type, data, args) {
+        const ctx = args[0];
+        const next = args[1];
+        switch (type) {
+            case constants_1.MaxParamtype.CONTEXT:
+                return ctx;
+            case constants_1.MaxParamtype.NEXT:
+                return next;
+            case constants_1.MaxParamtype.SENDER: {
+                const sender = ctx.user ?? ctx.message?.sender ?? ctx.callback?.user;
+                return data && sender ? sender[data] : sender;
+            }
+            case constants_1.MaxParamtype.MESSAGE:
+                return data && ctx.message
+                    ? ctx.message[data]
+                    : ctx.message;
+            case constants_1.MaxParamtype.PAYLOAD:
+                return ctx.callback?.payload;
+            default:
+                return null;
+        }
+    }
+}
+exports.MaxParamsFactory = MaxParamsFactory;
+//# sourceMappingURL=params.factory.js.map

package/dist/params.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params.factory.js","sourceRoot":"","sources":["../src/params.factory.ts"],"names":[],"mappings":";;;AAGA,2CAA0C;AAE1C,gEAAgE;AAChE,MAAa,gBAAgB;IAC3B,mBAAmB,CAAC,IAAkB,EAAE,IAAe,EAAE,IAAe;QACtE,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAY,CAAA;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAwB,CAAA;QAE3C,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,wBAAY,CAAC,OAAO;gBACvB,OAAO,GAAG,CAAA;YACZ,KAAK,wBAAY,CAAC,IAAI;gBACpB,OAAO,IAAI,CAAA;YACb,KAAK,wBAAY,CAAC,MAAM,CAAC,CAAC,CAAC;gBACzB,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAA;gBACpE,OAAO,IAAI,IAAI,MAAM,CAAC,CAAC,CAAE,MAAkC,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,MAAM,CAAA;YACtF,CAAC;YACD,KAAK,wBAAY,CAAC,OAAO;gBACvB,OAAO,IAAI,IAAI,GAAG,CAAC,OAAO;oBACxB,CAAC,CAAE,GAAG,CAAC,OAA8C,CAAC,IAAc,CAAC;oBACrE,CAAC,CAAC,GAAG,CAAC,OAAO,CAAA;YACjB,KAAK,wBAAY,CAAC,OAAO;gBACvB,OAAO,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAA;YAC9B;gBACE,OAAO,IAAI,CAAA;QACf,CAAC;IACH,CAAC;CACF;AAxBD,4CAwBC"}

package/dist/scenes/base-scene.d.ts

@@ -0,0 +1,22 @@
+import { Composer, Context, Middleware, MiddlewareFn } from '@maxhub/max-bot-api';
+export interface SceneOptions<C extends Context> {
+    ttl?: number;
+    handlers?: ReadonlyArray<Middleware<C>>;
+    enterHandlers?: ReadonlyArray<Middleware<C>>;
+    leaveHandlers?: ReadonlyArray<Middleware<C>>;
+}
+/**
+ * Базовая сцена — Composer с идентификатором и обработчиками входа/выхода.
+ * Порт telegraf `scenes/base.ts` на @maxhub/max-bot-api.
+ */
+export declare class BaseScene<C extends Context = Context> extends Composer<C> {
+    id: string;
+    ttl?: number;
+    enterHandler: MiddlewareFn<C>;
+    leaveHandler: MiddlewareFn<C>;
+    constructor(id: string, options?: SceneOptions<C>);
+    enter(...fns: Array<Middleware<C>>): this;
+    leave(...fns: Array<Middleware<C>>): this;
+    enterMiddleware(): MiddlewareFn<C>;
+    leaveMiddleware(): MiddlewareFn<C>;
+}

package/dist/scenes/base-scene.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseScene = void 0;
+const max_bot_api_1 = require("@maxhub/max-bot-api");
+/**
+ * Базовая сцена — Composer с идентификатором и обработчиками входа/выхода.
+ * Порт telegraf `scenes/base.ts` на @maxhub/max-bot-api.
+ */
+class BaseScene extends max_bot_api_1.Composer {
+    constructor(id, options) {
+        const opts = {
+            handlers: [],
+            enterHandlers: [],
+            leaveHandlers: [],
+            ...options
+        };
+        super(...opts.handlers);
+        this.id = id;
+        this.ttl = opts.ttl;
+        this.enterHandler = max_bot_api_1.Composer.compose([...opts.enterHandlers]);
+        this.leaveHandler = max_bot_api_1.Composer.compose([...opts.leaveHandlers]);
+    }
+    enter(...fns) {
+        this.enterHandler = max_bot_api_1.Composer.compose([this.enterHandler, ...fns]);
+        return this;
+    }
+    leave(...fns) {
+        this.leaveHandler = max_bot_api_1.Composer.compose([this.leaveHandler, ...fns]);
+        return this;
+    }
+    enterMiddleware() {
+        return this.enterHandler;
+    }
+    leaveMiddleware() {
+        return this.leaveHandler;
+    }
+}
+exports.BaseScene = BaseScene;
+//# sourceMappingURL=base-scene.js.map

package/dist/scenes/base-scene.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-scene.js","sourceRoot":"","sources":["../../src/scenes/base-scene.ts"],"names":[],"mappings":";;;AAAA,qDAAiF;AASjF;;;GAGG;AACH,MAAa,SAAuC,SAAQ,sBAAW;IAMrE,YAAY,EAAU,EAAE,OAAyB;QAC/C,MAAM,IAAI,GAA0E;YAClF,QAAQ,EAAE,EAAE;YACZ,aAAa,EAAE,EAAE;YACjB,aAAa,EAAE,EAAE;YACjB,GAAG,OAAO;SACX,CAAA;QACD,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,CAAA;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAA;QACZ,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAA;QACnB,IAAI,CAAC,YAAY,GAAG,sBAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAA;QAC7D,IAAI,CAAC,YAAY,GAAG,sBAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,aAAa,CAAC,CAAC,CAAA;IAC/D,CAAC;IAED,KAAK,CAAC,GAAG,GAAyB;QAChC,IAAI,CAAC,YAAY,GAAG,sBAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,KAAK,CAAC,GAAG,GAAyB;QAChC,IAAI,CAAC,YAAY,GAAG,sBAAQ,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,GAAG,CAAC,CAAC,CAAA;QACjE,OAAO,IAAI,CAAA;IACb,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;IAED,eAAe;QACb,OAAO,IAAI,CAAC,YAAY,CAAA;IAC1B,CAAC;CACF;AArCD,8BAqCC"}

package/dist/scenes/context.d.ts

@@ -0,0 +1,17 @@
+import { Context } from '@maxhub/max-bot-api';
+import { SceneContextScene, SceneSession, SceneSessionData } from './scene-context';
+import { WizardContextWizard, WizardSession, WizardSessionData } from './wizard-context';
+/**
+ * Контекст со сценами. Свойства проставляются middleware'ами (`session`/`scene`),
+ * поэтому объявлены через `declare` (без runtime-инициализации).
+ */
+export declare class SceneContext<D extends SceneSessionData = SceneSessionData> extends Context {
+    session?: SceneSession<D>;
+    scene: SceneContextScene<any, D>;
+}
+/** Контекст wizard-сцены: добавляет `ctx.wizard` поверх сцен. */
+export declare class WizardContext<D extends WizardSessionData = WizardSessionData> extends Context {
+    session?: WizardSession<D>;
+    scene: SceneContextScene<any, D>;
+    wizard: WizardContextWizard<any>;
+}

package/dist/scenes/context.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardContext = exports.SceneContext = void 0;
+const max_bot_api_1 = require("@maxhub/max-bot-api");
+/**
+ * Контекст со сценами. Свойства проставляются middleware'ами (`session`/`scene`),
+ * поэтому объявлены через `declare` (без runtime-инициализации).
+ */
+class SceneContext extends max_bot_api_1.Context {
+}
+exports.SceneContext = SceneContext;
+/** Контекст wizard-сцены: добавляет `ctx.wizard` поверх сцен. */
+class WizardContext extends max_bot_api_1.Context {
+}
+exports.WizardContext = WizardContext;
+//# sourceMappingURL=context.js.map

package/dist/scenes/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/scenes/context.ts"],"names":[],"mappings":";;;AAAA,qDAA6C;AAI7C;;;GAGG;AACH,MAAa,YAA4D,SAAQ,qBAAO;CAGvF;AAHD,oCAGC;AAED,iEAAiE;AACjE,MAAa,aAA+D,SAAQ,qBAAO;CAI1F;AAJD,sCAIC"}

package/dist/scenes/index.d.ts

@@ -0,0 +1,11 @@
+export { session, MemorySessionStore, getDefaultSessionKey } from './session';
+export type { SessionStore, SessionOptions } from './session';
+export { BaseScene } from './base-scene';
+export type { SceneOptions } from './base-scene';
+export { SceneContextScene } from './scene-context';
+export type { SceneSession, SceneSessionData, SceneSessionContext, SceneContextSceneOptions } from './scene-context';
+export { Stage } from './stage';
+export { WizardContextWizard } from './wizard-context';
+export type { WizardSession, WizardSessionData, WizardSessionContext } from './wizard-context';
+export { WizardScene } from './wizard-scene';
+export { SceneContext, WizardContext } from './context';

package/dist/scenes/index.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WizardContext = exports.SceneContext = exports.WizardScene = exports.WizardContextWizard = exports.Stage = exports.SceneContextScene = exports.BaseScene = exports.getDefaultSessionKey = exports.MemorySessionStore = exports.session = void 0;
+var session_1 = require("./session");
+Object.defineProperty(exports, "session", { enumerable: true, get: function () { return session_1.session; } });
+Object.defineProperty(exports, "MemorySessionStore", { enumerable: true, get: function () { return session_1.MemorySessionStore; } });
+Object.defineProperty(exports, "getDefaultSessionKey", { enumerable: true, get: function () { return session_1.getDefaultSessionKey; } });
+var base_scene_1 = require("./base-scene");
+Object.defineProperty(exports, "BaseScene", { enumerable: true, get: function () { return base_scene_1.BaseScene; } });
+var scene_context_1 = require("./scene-context");
+Object.defineProperty(exports, "SceneContextScene", { enumerable: true, get: function () { return scene_context_1.SceneContextScene; } });
+var stage_1 = require("./stage");
+Object.defineProperty(exports, "Stage", { enumerable: true, get: function () { return stage_1.Stage; } });
+var wizard_context_1 = require("./wizard-context");
+Object.defineProperty(exports, "WizardContextWizard", { enumerable: true, get: function () { return wizard_context_1.WizardContextWizard; } });
+var wizard_scene_1 = require("./wizard-scene");
+Object.defineProperty(exports, "WizardScene", { enumerable: true, get: function () { return wizard_scene_1.WizardScene; } });
+var context_1 = require("./context");
+Object.defineProperty(exports, "SceneContext", { enumerable: true, get: function () { return context_1.SceneContext; } });
+Object.defineProperty(exports, "WizardContext", { enumerable: true, get: function () { return context_1.WizardContext; } });
+//# sourceMappingURL=index.js.map

package/dist/scenes/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/scenes/index.ts"],"names":[],"mappings":";;;AAAA,qCAA6E;AAApE,kGAAA,OAAO,OAAA;AAAE,6GAAA,kBAAkB,OAAA;AAAE,+GAAA,oBAAoB,OAAA;AAE1D,2CAAwC;AAA/B,uGAAA,SAAS,OAAA;AAElB,iDAAmD;AAA1C,kHAAA,iBAAiB,OAAA;AAO1B,iCAA+B;AAAtB,8FAAA,KAAK,OAAA;AACd,mDAAsD;AAA7C,qHAAA,mBAAmB,OAAA;AAE5B,+CAA4C;AAAnC,2GAAA,WAAW,OAAA;AACpB,qCAAuD;AAA9C,uGAAA,YAAY,OAAA;AAAE,wGAAA,aAAa,OAAA"}

package/dist/scenes/scene-context.d.ts

@@ -0,0 +1,38 @@
+import { Context } from '@maxhub/max-bot-api';
+import { BaseScene } from './base-scene';
+export interface SceneSessionData {
+    current?: string;
+    expires?: number;
+    state?: object;
+}
+export interface SceneSession<S extends SceneSessionData = SceneSessionData> {
+    __scenes?: S;
+}
+/** Контекст, у которого есть сессия со сценами (привязывается session middleware). */
+export type SceneSessionContext<D extends SceneSessionData = SceneSessionData> = Context & {
+    session?: SceneSession<D>;
+};
+export interface SceneContextSceneOptions<D extends SceneSessionData> {
+    ttl?: number;
+    default?: string;
+    defaultSession: D;
+}
+/**
+ * `ctx.scene` — управление текущей сценой пользователя. Состояние хранится в
+ * `ctx.session.__scenes`. Порт telegraf `scenes/context.ts`.
+ */
+export declare class SceneContextScene<C extends SceneSessionContext<D>, D extends SceneSessionData = SceneSessionData> {
+    private readonly ctx;
+    private readonly scenes;
+    private readonly options;
+    constructor(ctx: C, scenes: Map<string, BaseScene<C>>, options: Partial<SceneContextSceneOptions<D>>);
+    get session(): D;
+    get state(): object;
+    set state(value: object);
+    get current(): BaseScene<C> | undefined;
+    reset(): void;
+    enter(sceneId: string, initialState?: object, silent?: boolean): Promise<unknown>;
+    reenter(): Promise<unknown> | undefined;
+    private leaving;
+    leave(): Promise<void>;
+}

package/dist/scenes/scene-context.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SceneContextScene = void 0;
+const noop = () => Promise.resolve();
+const now = () => Math.floor(Date.now() / 1000);
+/**
+ * `ctx.scene` — управление текущей сценой пользователя. Состояние хранится в
+ * `ctx.session.__scenes`. Порт telegraf `scenes/context.ts`.
+ */
+class SceneContextScene {
+    constructor(ctx, scenes, options) {
+        this.ctx = ctx;
+        this.scenes = scenes;
+        this.leaving = false;
+        const fallbackSessionDefault = {};
+        this.options = { defaultSession: fallbackSessionDefault, ...options };
+    }
+    get session() {
+        const defaultSession = Object.assign({}, this.options.defaultSession);
+        let session = this.ctx.session?.__scenes ?? defaultSession;
+        if (session.expires !== undefined && session.expires < now()) {
+            session = defaultSession;
+        }
+        if (this.ctx.session === undefined) {
+            this.ctx.session = { __scenes: session };
+        }
+        else {
+            this.ctx.session.__scenes = session;
+        }
+        return session;
+    }
+    get state() {
+        return (this.session.state ??= {});
+    }
+    set state(value) {
+        this.session.state = { ...value };
+    }
+    get current() {
+        const sceneId = this.session.current ?? this.options.default;
+        return sceneId === undefined || !this.scenes.has(sceneId)
+            ? undefined
+            : this.scenes.get(sceneId);
+    }
+    reset() {
+        if (this.ctx.session !== undefined) {
+            this.ctx.session.__scenes = Object.assign({}, this.options.defaultSession);
+        }
+    }
+    async enter(sceneId, initialState = {}, silent = false) {
+        if (!this.scenes.has(sceneId)) {
+            throw new Error(`max-bot-nestjs: can't find scene: ${sceneId}`);
+        }
+        if (!silent) {
+            await this.leave();
+        }
+        this.session.current = sceneId;
+        this.state = initialState;
+        const ttl = this.current?.ttl ?? this.options.ttl;
+        if (ttl !== undefined) {
+            this.session.expires = now() + ttl;
+        }
+        if (this.current === undefined || silent) {
+            return;
+        }
+        const handler = 'enterMiddleware' in this.current && typeof this.current.enterMiddleware === 'function'
+            ? this.current.enterMiddleware()
+            : this.current.middleware();
+        return await handler(this.ctx, noop);
+    }
+    reenter() {
+        return this.session.current === undefined
+            ? undefined
+            : this.enter(this.session.current, this.state);
+    }
+    async leave() {
+        if (this.leaving)
+            return;
+        try {
+            this.leaving = true;
+            if (this.current === undefined) {
+                return;
+            }
+            const handler = 'leaveMiddleware' in this.current && typeof this.current.leaveMiddleware === 'function'
+                ? this.current.leaveMiddleware()
+                : noop;
+            await handler(this.ctx, noop);
+            return this.reset();
+        }
+        finally {
+            this.leaving = false;
+        }
+    }
+}
+exports.SceneContextScene = SceneContextScene;
+//# sourceMappingURL=scene-context.js.map

package/dist/scenes/scene-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scene-context.js","sourceRoot":"","sources":["../../src/scenes/scene-context.ts"],"names":[],"mappings":"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"}

package/dist/scenes/session.d.ts

@@ -0,0 +1,36 @@
+import { Context, MiddlewareFn } from '@maxhub/max-bot-api';
+/**
+ * Хранилище сессий. По умолчанию используется in-memory `MemorySessionStore`,
+ * но интерфейс позволяет подключить персистентное хранилище (например, Mongo).
+ */
+export interface SessionStore<T> {
+    get(key: string): T | undefined | Promise<T | undefined>;
+    set(key: string, value: T): void | Promise<void>;
+    delete(key: string): void | Promise<void>;
+}
+/** Простое in-memory хранилище сессий (Map). */
+export declare class MemorySessionStore<T> implements SessionStore<T> {
+    private readonly store;
+    get(key: string): T | undefined;
+    set(key: string, value: T): void;
+    delete(key: string): void;
+}
+export interface SessionOptions<S, C extends Context> {
+    /** Имя свойства контекста (по умолчанию `session`). */
+    property?: string;
+    /** Ключ сессии. По умолчанию — id пользователя MAX. */
+    getSessionKey?: (ctx: C) => string | undefined;
+    store?: SessionStore<S>;
+    defaultSession?: (ctx: C) => S;
+}
+/**
+ * Ключ сессии по умолчанию: id пользователя MAX (бот общается 1:1, поэтому
+ * достаточно ключа по пользователю). Берём id из любого типа апдейта.
+ */
+export declare const getDefaultSessionKey: (ctx: Context) => string | undefined;
+/**
+ * Middleware, добавляющий `ctx.session` поверх произвольного хранилища.
+ * Значение читается до выполнения цепочки и записывается обратно после неё.
+ * Упрощённая версия telegraf-session: один процесс, низкая конкуренция.
+ */
+export declare function session<S extends object, C extends Context = Context>(options?: SessionOptions<S, C>): MiddlewareFn<C>;

package/dist/scenes/session.js

@@ -0,0 +1,63 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultSessionKey = exports.MemorySessionStore = void 0;
+exports.session = session;
+/** Простое in-memory хранилище сессий (Map). */
+class MemorySessionStore {
+    constructor() {
+        this.store = new Map();
+    }
+    get(key) {
+        return this.store.get(key);
+    }
+    set(key, value) {
+        this.store.set(key, value);
+    }
+    delete(key) {
+        this.store.delete(key);
+    }
+}
+exports.MemorySessionStore = MemorySessionStore;
+/**
+ * Ключ сессии по умолчанию: id пользователя MAX (бот общается 1:1, поэтому
+ * достаточно ключа по пользователю). Берём id из любого типа апдейта.
+ */
+const getDefaultSessionKey = (ctx) => {
+    const userId = ctx.user?.user_id ?? ctx.message?.sender?.user_id ?? ctx.callback?.user?.user_id;
+    return userId === undefined ? undefined : String(userId);
+};
+exports.getDefaultSessionKey = getDefaultSessionKey;
+/**
+ * Middleware, добавляющий `ctx.session` поверх произвольного хранилища.
+ * Значение читается до выполнения цепочки и записывается обратно после неё.
+ * Упрощённая версия telegraf-session: один процесс, низкая конкуренция.
+ */
+function session(options) {
+    const property = options?.property ?? 'session';
+    const getSessionKey = options?.getSessionKey ?? exports.getDefaultSessionKey;
+    const store = options?.store ?? new MemorySessionStore();
+    const defaultSession = options?.defaultSession ?? (() => ({}));
+    return async (ctx, next) => {
+        const key = getSessionKey(ctx);
+        if (!key) {
+            return next();
+        }
+        let value = (await store.get(key)) ?? defaultSession(ctx);
+        Object.defineProperty(ctx, property, {
+            configurable: true,
+            enumerable: true,
+            get: () => value,
+            set: (next_) => {
+                value = next_;
+            }
+        });
+        await next();
+        if (value == null) {
+            await store.delete(key);
+        }
+        else {
+            await store.set(key, value);
+        }
+    };
+}
+//# sourceMappingURL=session.js.map