@grammy-x/conversations 0.2.0 → 0.2.1

package/dist/conversations/src/conversation.d.ts

@@ -0,0 +1,6 @@
+import type { ConversationConfig } from "@grammyjs/conversations";
+import type { Conversation } from "@grammyjs/conversations";
+import type { Context, MiddlewareFn } from "grammy";
+export type ConversationFn<C extends Context = Context> = (conversation: Conversation<C>, ctx: C) => unknown | Promise<unknown>;
+export declare function createCustomConversation<C extends Context = Context>(builder: ConversationFn<C>, config?: string | ConversationConfig): MiddlewareFn<any>;
+//# sourceMappingURL=conversation.d.ts.map

package/dist/conversations/src/conversation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversation.d.ts","sourceRoot":"","sources":["../../../src/conversation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAEjE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AAE3D,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAA;AAGnD,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,CACtD,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,EAC7B,GAAG,EAAE,CAAC,KACL,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;AAE/B,wBAAgB,wBAAwB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAChE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAC1B,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,GACrC,YAAY,CAAC,GAAG,CAAC,CA2DnB"}

package/dist/conversations/src/index.d.ts

@@ -0,0 +1,4 @@
+export { QuestionHelper } from "./question-helper.js";
+export { createCustomConversation } from "./conversation.js";
+export type { ConversationFn } from "./conversation.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/conversations/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAA;AAC5D,YAAY,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA"}

package/dist/conversations/src/question-helper.d.ts

@@ -0,0 +1,111 @@
+import type { Conversation } from "@grammyjs/conversations";
+import { Context, InlineKeyboard, Keyboard } from "grammy";
+import type { ChatAdministratorRights, ChatShared, Contact, Location, Poll, UsersShared } from "grammy/types";
+type MaybePromise<T> = PromiseLike<T> | T;
+type ButtonsMarkup = InlineKeyboard | Keyboard;
+interface QuestionParameters {
+    markup?: ButtonsMarkup;
+    autoBold?: boolean;
+    entities?: any[];
+    fastMenu?: boolean;
+    fastMenuCallbackData?: string;
+    fastMenuText?: string;
+    newMessage?: boolean;
+}
+interface QuestionCallbackParameters extends QuestionParameters {
+    columnCount?: number;
+    noChoiceAllowed?: boolean;
+    rowCount?: number;
+    continueButton?: string;
+    pagination?: {
+        enabled: boolean;
+        extraControls?: boolean;
+    };
+}
+interface QuestionMultiParameters extends QuestionCallbackParameters {
+    continueInlineEnd?: boolean;
+}
+interface QuestionChatParameters extends QuestionParameters {
+    chat: {
+        requiredUserRights?: ChatAdministratorRights;
+        requiredBotRights?: ChatAdministratorRights;
+        botIsMember?: boolean;
+        isChannel: boolean;
+        requestTitle?: boolean;
+        requestUsername?: boolean;
+        requestPhoto?: boolean;
+    };
+}
+interface QuestionUserParameters extends QuestionParameters {
+    user?: {
+        isBot?: boolean;
+        isPremium?: boolean;
+        requestName?: boolean;
+        requestUsername?: boolean;
+        requestPhoto?: boolean;
+    };
+}
+interface QuestionUsersParameters extends QuestionParameters {
+    users?: {
+        maxQuantity?: number;
+        isBot?: boolean;
+        isPremium?: boolean;
+        requestName?: boolean;
+        requestUsername?: boolean;
+        requestPhoto?: boolean;
+    };
+}
+interface QuestionPollParameters extends QuestionParameters {
+    poll?: {
+        type?: "regular" | "quiz";
+    };
+}
+type QuestionUniversalParameters = Partial<QuestionMultiParameters & QuestionChatParameters & QuestionUserParameters & QuestionUsersParameters & QuestionPollParameters>;
+export interface TextParserResult<R> {
+    result?: R;
+    callbackQuery?: string;
+    answerCtx?: any;
+    message?: any;
+}
+export declare class QuestionHelper<C extends Context = Context, T extends Conversation<C> = Conversation<C>> {
+    private conversation;
+    private config;
+    private ctx;
+    message_id?: number;
+    constructor(conversation: T, ctx: C, config?: QuestionUniversalParameters);
+    private updateCtx;
+    delete: () => Promise<void>;
+    back: () => Promise<unknown>;
+    private reply;
+    private getCallbackDataFromKeyboard;
+    private textParser;
+    text: (text: string, options?: QuestionParameters) => Promise<TextParserResult<string>>;
+    int: (text: string, options?: QuestionParameters) => Promise<TextParserResult<number>>;
+    float: (text: string, options?: QuestionParameters) => Promise<TextParserResult<number>>;
+    chat: (text: string, options: QuestionChatParameters) => Promise<ChatShared>;
+    user: (text: string, options?: QuestionUserParameters) => Promise<import("grammy/types").SharedUser>;
+    users: (text: string, options?: QuestionUsersParameters) => Promise<UsersShared>;
+    contact: (text: string, options?: QuestionParameters) => Promise<Contact>;
+    location: (text: string, options?: QuestionParameters) => Promise<Location>;
+    poll: (text: string, options?: QuestionPollParameters) => Promise<Poll>;
+    private renderPaginationButtons;
+    private resetChoice;
+    private basicChoice;
+    choice: <const R_1 extends string>(text: string, choices: [string, R_1][], options?: QuestionCallbackParameters) => Promise<{
+        result: R_1;
+        message: any;
+    }>;
+    multi: <const R_1 extends string>(text: string | ((choices: R_1[], currentPage: number, pagesCount: number) => MaybePromise<string>), choices: [string, R_1][], options?: QuestionCallbackParameters) => Promise<{
+        result: R_1[];
+        callbackData?: string;
+        message: any;
+    }>;
+    boolean: (text: string, yesNoStrings?: string[], options?: QuestionCallbackParameters) => Promise<{
+        result: boolean;
+        message: any;
+    }>;
+    photo: (text: string, options?: QuestionParameters) => Promise<string>;
+    file: (text: string, options?: QuestionParameters) => Promise<string>;
+}
+export {};
+//# sourceMappingURL=question-helper.d.ts.map

package/dist/conversations/src/question-helper.d.ts.map

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

package/dist/core/src/index.d.ts

@@ -0,0 +1,8 @@
+export type { GrammyXSessionData, GrammyXInternalSession, GrammyXFlavor, WithGrammyXSession } from "./session.js";
+export { smartReply, setActiveMessage } from "./message.js";
+export type { ReplyOptions } from "./message.js";
+export { grammyx, getGrammyXOptions, grammyXMenus } from "./plugin.js";
+export type { GrammyXDefaultColor, GrammyXPluginOptions, GrammyXRuntimeOptions } from "./plugin.js";
+export { GlobalMenuRegistry } from "./registry/menu.js";
+export type { MenuLike } from "./registry/menu.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/core/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../core/src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAA;AACjH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAC3D,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AACtE,YAAY,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,YAAY,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAA"}

package/dist/core/src/message.d.ts

@@ -0,0 +1,12 @@
+import type { Context } from "grammy";
+import type { Message } from "grammy/types";
+export interface ReplyOptions {
+    embolden?: boolean;
+    dedent?: boolean;
+    newMessage?: boolean;
+    messageToEdit?: number;
+    options?: Record<string, any>;
+}
+export declare function smartReply(ctx: Context, text: string, options?: ReplyOptions, replyMarkup?: any): Promise<Message>;
+export declare function setActiveMessage(ctx: Context, message: Message): void;
+//# sourceMappingURL=message.d.ts.map

package/dist/core/src/message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.d.ts","sourceRoot":"","sources":["../../../../core/src/message.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AACrC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAI3C,MAAM,WAAW,YAAY;IACzB,QAAQ,CAAC,EAAE,OAAO,CAAA;IAClB,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAChC;AAiBD,wBAAsB,UAAU,CAC5B,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,YAAY,EACtB,WAAW,CAAC,EAAE,GAAG,GAClB,OAAO,CAAC,OAAO,CAAC,CA0BlB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAQrE"}

package/dist/core/src/plugin.d.ts

@@ -0,0 +1,20 @@
+import type { MiddlewareFn } from "grammy";
+export type GrammyXDefaultColor = "primary" | "success" | "danger";
+export interface GrammyXRuntimeOptions {
+    defaultColor?: GrammyXDefaultColor;
+    interruptCommands?: Record<string, any>;
+    backText?: string;
+}
+export interface GrammyXPluginOptions {
+    sessionInitial?: () => any;
+    defaultColor?: GrammyXDefaultColor;
+    interruptCommands?: Record<string, any>;
+    backText?: string;
+}
+export declare function getGrammyXOptions(ctx: unknown): GrammyXRuntimeOptions | undefined;
+export declare function grammyx(options?: GrammyXPluginOptions): MiddlewareFn<any>;
+/**
+ * The Global Menu Handler.
+ */
+export declare function grammyXMenus(): MiddlewareFn<any>;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/core/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../core/src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,QAAQ,CAAA;AAMnD,MAAM,MAAM,mBAAmB,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAA;AAElE,MAAM,WAAW,qBAAqB;IAClC,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,MAAM,WAAW,oBAAoB;IACjC,cAAc,CAAC,EAAE,MAAM,GAAG,CAAA;IAC1B,YAAY,CAAC,EAAE,mBAAmB,CAAA;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,OAAO,GAAG,qBAAqB,GAAG,SAAS,CAEjF;AAgBD,wBAAgB,OAAO,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,YAAY,CAAC,GAAG,CAAC,CAqFzE;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,YAAY,CAAC,GAAG,CAAC,CAahD"}

package/dist/core/src/registry/menu.d.ts

@@ -0,0 +1,14 @@
+import type { Context } from "grammy";
+export interface MenuLike<C extends Context = Context> {
+    menuName: string;
+    send: (ctx: C, data?: any) => Promise<unknown>;
+}
+declare class MenuRegistry {
+    private menus;
+    register(menu: MenuLike<any>): void;
+    get<C extends Context>(name: string): MenuLike<C> | undefined;
+    getAll(): MenuLike<any>[];
+}
+export declare const GlobalMenuRegistry: MenuRegistry;
+export {};
+//# sourceMappingURL=menu.d.ts.map

package/dist/core/src/registry/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../../../core/src/registry/menu.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAA;AAErC,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IACjD,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CACjD;AAED,cAAM,YAAY;IACd,OAAO,CAAC,KAAK,CAAmC;IAEhD,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,CAAC;IAQ5B,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS;IAI7D,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,EAAE;CAG5B;AAED,eAAO,MAAM,kBAAkB,cAAqB,CAAA"}

package/dist/core/src/session.d.ts

@@ -0,0 +1,35 @@
+export interface GrammyXInternalSession {
+    menu?: {
+        data?: any;
+        messageId?: number;
+    };
+    history: string[];
+    lazy: Record<string, any>;
+    conversations?: {
+        currentChoices: any;
+        currentPage: number;
+    };
+}
+export interface GrammyXSessionData {
+    _gx: GrammyXInternalSession;
+    conversation?: Record<string, any>;
+    [key: string]: any;
+}
+import type { Context, SessionFlavor } from "grammy";
+export interface GrammyXMenuControlPanel {
+    nav: (to: string, data?: any) => Promise<unknown>;
+    back: (data?: any) => Promise<unknown>;
+    update: (data?: any) => Promise<unknown>;
+    close: () => void;
+}
+export type GrammyXFlavor<C extends Context = Context> = C & SessionFlavor<GrammyXSessionData> & {
+    menu: GrammyXMenuControlPanel;
+};
+type SessionValue<C extends Context> = C extends {
+    session: infer S;
+} ? Awaited<S> : never;
+export type WithGrammyXSession<C extends Context> = C & SessionFlavor<SessionValue<C> & GrammyXSessionData> & {
+    menu: GrammyXMenuControlPanel;
+};
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/core/src/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../../core/src/session.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,sBAAsB;IACnC,IAAI,CAAC,EAAE;QACH,IAAI,CAAC,EAAE,GAAG,CAAA;QACV,SAAS,CAAC,EAAE,MAAM,CAAA;KACrB,CAAA;IACD,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IACzB,aAAa,CAAC,EAAE;QACZ,cAAc,EAAE,GAAG,CAAA;QACnB,WAAW,EAAE,MAAM,CAAA;KACtB,CAAA;CACJ;AAED,MAAM,WAAW,kBAAkB;IAC/B,GAAG,EAAE,sBAAsB,CAAA;IAC3B,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;IAClC,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAA;CACrB;AAED,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAA;AAEpD,MAAM,WAAW,uBAAuB;IACpC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACjD,IAAI,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACxC,KAAK,EAAE,MAAM,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,aAAa,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,IAAI,CAAC,GAAG,aAAa,CAAC,kBAAkB,CAAC,GAAG;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAA;AAElI,KAAK,YAAY,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,SAAS;IAAE,OAAO,EAAE,MAAM,CAAC,CAAA;CAAE,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,CAAA;AAE1F,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,OAAO,IAAI,CAAC,GAAG,aAAa,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,kBAAkB,CAAC,GAAG;IAAE,IAAI,EAAE,uBAAuB,CAAA;CAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,398 @@
+// src/question-helper.ts
+import { Context, InlineKeyboard, Keyboard } from "grammy";
+import { smartReply, GlobalMenuRegistry } from "@grammy-x/core";
+function randomInteger(minimum, maximum) {
+  return Math.floor(Math.random() * (maximum - minimum + 1) + minimum);
+}
+
+class QuestionHelper {
+  conversation;
+  config;
+  ctx;
+  message_id;
+  constructor(conversation, ctx, config) {
+    this.conversation = conversation;
+    this.config = config ?? {};
+    this.ctx = ctx;
+  }
+  updateCtx = (ctx) => {
+    Object.keys(this.ctx).forEach((key) => delete this.ctx[key]);
+    Object.assign(this.ctx, ctx);
+  };
+  delete = async () => {
+    if (this.message_id) {
+      await this.ctx.api.deleteMessage(this.ctx.from.id, this.message_id);
+    }
+  };
+  back = async () => {
+    const gx = this.ctx.session?._gx;
+    if (gx?.history.length > 0) {
+      gx.history.pop();
+    }
+    const targetId = gx?.history.length > 0 ? gx.history.pop() : undefined;
+    if (targetId) {
+      const menu = GlobalMenuRegistry.get(targetId);
+      if (menu)
+        return menu.send(this.ctx);
+    }
+  };
+  reply = async (text, options) => {
+    let newText = text;
+    const mergedOptions = { ...this.config, ...options };
+    if (mergedOptions.autoBold !== false)
+      newText = `<b>${newText}</b>`;
+    if (options?.markup instanceof InlineKeyboard)
+      mergedOptions.markup = options.markup;
+    if (!mergedOptions.markup)
+      mergedOptions.markup = new InlineKeyboard;
+    if (mergedOptions.markup instanceof InlineKeyboard && this.config.markup instanceof InlineKeyboard)
+      mergedOptions.markup.append(this.config.markup);
+    if (mergedOptions.fastMenu && mergedOptions.markup instanceof InlineKeyboard) {
+      const markup = mergedOptions.markup;
+      markup.text(mergedOptions.fastMenuText ?? this.config?.fastMenuText ?? "Main Menu", mergedOptions.fastMenuCallbackData ?? "start");
+    }
+    if (options?.sendContinueButton && mergedOptions.continueInlineEnd && mergedOptions.markup instanceof InlineKeyboard) {
+      const markup = mergedOptions.markup;
+      markup.text(options?.continueButton ?? this.config?.continueButton ?? "Continue", "continue");
+    }
+    const message = await smartReply(this.ctx, text, {
+      options: {
+        entities: mergedOptions.entities,
+        reply_markup: mergedOptions.markup
+      },
+      messageToEdit: this.message_id,
+      newMessage: mergedOptions?.newMessage,
+      embolden: false,
+      dedent: false
+    });
+    this.message_id = message?.message_id ?? this.message_id;
+    return message;
+  };
+  getCallbackDataFromKeyboard = (keyboard) => {
+    if (keyboard && keyboard instanceof InlineKeyboard)
+      return keyboard.inline_keyboard.flat().map((b) => b.callback_data).filter(Boolean);
+    return [];
+  };
+  textParser = async (text, parser, validator, options) => {
+    const message = await this.reply(text, options);
+    const additionalTriggers = this.getCallbackDataFromKeyboard(options?.markup);
+    const answer = await this.conversation.waitUntil((ctx) => Context.has.callbackQuery(additionalTriggers)(ctx) || ctx.has(":text"));
+    this.updateCtx(answer);
+    const callbackQuery = answer.callbackQuery?.data;
+    if (callbackQuery)
+      return { callbackQuery, answerCtx: answer, message };
+    if (answer.message?.text?.startsWith("/")) {
+      await this.ctx.api.deleteMessage(this.ctx.from.id, answer.message.message_id).catch(() => {});
+      const cmd = answer.message.text.split(" ")[0];
+      const err = new Error(`CommandInterrupt:${cmd}`);
+      err.name = "CommandInterruptError";
+      err.ctx = answer;
+      throw err;
+    }
+    const result = parser(answer.msg.text);
+    await this.ctx.api.deleteMessage(this.ctx.from.id, answer.msg.message_id).catch(() => {});
+    if (!validator(result))
+      return await this.conversation.skip();
+    return { result, answerCtx: answer, message };
+  };
+  text = (text, options) => this.textParser(text, (r) => r, () => true, options);
+  int = (text, options) => this.textParser(text, parseInt, (r) => !isNaN(r), options);
+  float = (text, options) => this.textParser(text, parseFloat, (r) => !isNaN(r), options);
+  chat = async (text, options) => {
+    const chat = options.chat;
+    const markup = new Keyboard().requestChat("Выбрать чат \uD83D\uDD0D", randomInteger(0, 999999), {
+      chat_is_channel: chat.isChannel,
+      bot_administrator_rights: chat.requiredBotRights,
+      bot_is_member: chat.botIsMember,
+      request_photo: chat.requestPhoto,
+      request_title: chat.requestTitle,
+      request_username: chat.requestUsername ?? true,
+      user_administrator_rights: chat.requiredUserRights
+    }).oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":chat_shared");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.chat_shared;
+  };
+  user = async (text, options) => {
+    const user = options?.user;
+    const markup = new Keyboard().requestUsers("Выбрать пользователя \uD83D\uDD0D", randomInteger(0, 999999), {
+      max_quantity: 1,
+      request_name: user?.requestName,
+      request_photo: user?.requestPhoto,
+      request_username: user?.requestUsername ?? true,
+      user_is_bot: user?.isBot,
+      user_is_premium: user?.isPremium
+    }).oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":users_shared");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.users_shared?.users[0];
+  };
+  users = async (text, options) => {
+    const users = options?.users;
+    const markup = new Keyboard().requestUsers("Выбрать пользователей \uD83D\uDD0D", randomInteger(0, 999999), {
+      max_quantity: users?.maxQuantity,
+      request_name: users?.requestName,
+      request_photo: users?.requestPhoto,
+      request_username: users?.requestUsername ?? true,
+      user_is_bot: users?.isBot,
+      user_is_premium: users?.isPremium
+    }).oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":users_shared");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.users_shared;
+  };
+  contact = async (text, options) => {
+    const markup = new Keyboard().requestContact("Поделиться контактом \uD83D\uDCDE").oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":contact");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.contact;
+  };
+  location = async (text, options) => {
+    const markup = new Keyboard().requestLocation("Поделиться геопозицией \uD83D\uDCCD").oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":location");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.location;
+  };
+  poll = async (text, options) => {
+    const pollType = options?.poll?.type;
+    const markup = new Keyboard().requestPoll("Отправить опрос \uD83D\uDCCA", pollType).oneTime(true).resized(true);
+    const message = await this.reply(text, { ...options, markup });
+    const answer = await this.conversation.waitFor(":poll");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.poll;
+  };
+  renderPaginationButtons = (pagesCount, currentPage, markup, columnCount, extraControls) => {
+    const oddColumnCount = columnCount % 2 === 0 ? columnCount + 1 : columnCount;
+    const emptyColumns = oddColumnCount >= 5 ? extraControls ? 0 : 1 : 0;
+    for (let i = 0;i < emptyColumns; i++) {
+      markup.text(" ", " ");
+    }
+    if (extraControls) {
+      markup.text(currentPage > 2 ? "⋘" : " ", "first");
+    }
+    markup.text(currentPage > 1 ? "←" : " ", "prev");
+    markup.text(currentPage + " / " + pagesCount, "page");
+    markup.text(currentPage < pagesCount ? "→" : " ", "next");
+    if (extraControls) {
+      markup.text(currentPage < pagesCount - 1 ? "⋙" : " ", "last");
+    }
+    for (let i = 0;i < emptyColumns; i++) {
+      markup.text(" ", " ");
+    }
+    return markup.row();
+  };
+  resetChoice = (session) => {
+    if (!session._gx.conversations)
+      session._gx.conversations = {
+        currentChoices: new Set,
+        currentPage: 1
+      };
+    else {
+      session._gx.conversations.currentChoices = new Set;
+      session._gx.conversations.currentPage = 1;
+    }
+  };
+  async basicChoice(text, choices, multi = false, options, inProgress) {
+    const markup = new InlineKeyboard;
+    const session = await this.conversation.external(() => this.ctx.session);
+    if (!session._gx.conversations)
+      this.resetChoice(session);
+    await this.conversation.external(() => !inProgress && this.resetChoice(session));
+    let currentRow = [];
+    const columnCount = options?.columnCount ?? this.config.columnCount ?? 1;
+    const rowCount = options?.rowCount ?? this.config.rowCount ?? 3;
+    const filledChoices = options?.pagination?.enabled ? choices.concat(Array.from({ length: columnCount * rowCount - choices.length % (columnCount * rowCount) }).map(() => [" ", "empty"])) : choices;
+    const pagesCount = Math.ceil(choices.length / (columnCount * rowCount));
+    const currentPage = session._gx.conversations.currentPage ?? 1;
+    let currentRowId = 0;
+    for (const [choiceId, choice] of filledChoices.entries()) {
+      if (options?.pagination?.enabled && choiceId < (currentPage - 1) * columnCount * rowCount)
+        continue;
+      const checked = session._gx.conversations.currentChoices.has(choice[1]);
+      currentRow.push([`${choice[0]}${checked ? " ✅" : ""}`, choice[1]]);
+      if (currentRow.length === columnCount) {
+        currentRow.forEach(([label, value]) => markup.text(label, value == "empty" ? "empty" : `answer:${value}`));
+        markup.row();
+        currentRow = [];
+        currentRowId++;
+        if (options?.pagination?.enabled && (currentRowId === rowCount || choiceId === filledChoices.length - 1)) {
+          this.renderPaginationButtons(pagesCount, currentPage, markup, columnCount, options?.pagination?.extraControls ?? false);
+          break;
+        }
+      }
+    }
+    if (currentRow.length > 0) {
+      currentRow.forEach(([label, value]) => {
+        markup.text(label, `answer:${value}`);
+      });
+      markup.row();
+    }
+    const additionalTriggers = this.getCallbackDataFromKeyboard(options?.markup);
+    if (options?.markup instanceof InlineKeyboard)
+      markup.append(options.markup).row();
+    const sendContinueButton = session._gx.conversations.currentChoices.size > 0;
+    const continueInlineEnd = options?.continueInlineEnd ?? this.config.continueInlineEnd;
+    if (multi && !options?.noChoiceAllowed && !continueInlineEnd && sendContinueButton)
+      markup.text(options?.continueButton ?? this.config?.continueButton ?? "Continue", "continue").row();
+    const messageText = typeof text === "function" ? await text(Array.from(session._gx.conversations.currentChoices), session._gx.conversations.currentPage, pagesCount) : text;
+    const message = await this.reply(messageText, {
+      ...options,
+      markup,
+      continueButton: options?.continueButton,
+      continueInlineEnd,
+      sendContinueButton: continueInlineEnd && sendContinueButton
+    });
+    let additionalTriggerCalled;
+    let answer;
+    const paginationsCallbacks = ["prev", "next", "page", "empty", "first", "last"];
+    do {
+      answer = await this.conversation.waitForCallbackQuery([
+        ...choices.map((c) => `answer:${c[1]}`),
+        ...multi ? ["continue"] : [],
+        ...options?.pagination?.enabled ? paginationsCallbacks : [],
+        ...additionalTriggers
+      ]);
+      this.updateCtx(answer);
+      const callbackData2 = answer.callbackQuery.data;
+      additionalTriggerCalled = additionalTriggers.includes(callbackData2);
+      if (callbackData2 == "continue" || additionalTriggerCalled) {
+        const choices2 = Array.from(session._gx.conversations.currentChoices);
+        this.ctx.session._gx.conversations.currentChoices = new Set;
+        if (additionalTriggerCalled)
+          return { result: choices2, callbackQuery: callbackData2, message };
+        return { result: choices2, message };
+      }
+    } while (additionalTriggerCalled);
+    const questionData = session._gx.conversations;
+    const callbackData = answer.callbackQuery.data;
+    const data = callbackData.split(":")[1];
+    const skip = await this.conversation.external(async () => {
+      if (callbackData == "prev")
+        questionData.currentPage = Math.max(currentPage - 1, 1);
+      if (callbackData == "next")
+        questionData.currentPage = Math.min(currentPage + 1, pagesCount);
+      if (callbackData == "first")
+        questionData.currentPage = 1;
+      if (callbackData == "last")
+        questionData.currentPage = pagesCount;
+      if (data) {
+        if (questionData.currentChoices.has(data))
+          questionData.currentChoices.delete(data);
+        else
+          questionData.currentChoices.add(data);
+      }
+      this.ctx.session._gx.conversations = questionData;
+      if (paginationsCallbacks.includes(callbackData) && questionData.currentPage == currentPage) {
+        await this.ctx.answerCallbackQuery();
+        return true;
+      }
+    });
+    if (skip)
+      return this.conversation.skip({ drop: true });
+    if (!multi && data) {
+      this.ctx.session._gx.conversations.currentChoices = new Set;
+      return {
+        result: data,
+        message
+      };
+    }
+    return this.basicChoice(text, choices, multi, options, true);
+  }
+  choice = async (text, choices, options) => this.basicChoice(text, choices, false, options);
+  multi = async (text, choices, options) => this.basicChoice(text, choices, true, options);
+  boolean = async (text, yesNoStrings, options) => {
+    const { result, message } = await this.choice(text, [
+      [yesNoStrings?.[0] ?? "✅ Да", "true"],
+      [yesNoStrings?.[1] ?? "❌ Нет", "false"]
+    ], { columnCount: 2, ...options });
+    const boolResult = result === "true";
+    return { result: boolResult, message };
+  };
+  photo = async (text, options) => {
+    const message = await this.reply(text, options);
+    const answer = await this.conversation.waitFor(":photo");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    const photo = answer.msg.photo?.[0];
+    if (!photo) {
+      throw new Error("No photo found in update");
+    }
+    return photo.file_id;
+  };
+  file = async (text, options) => {
+    const message = await this.reply(text, options);
+    const answer = await this.conversation.waitFor(":file");
+    this.updateCtx(answer);
+    await answer?.msg?.delete?.().catch?.(() => {});
+    return answer.msg.document?.file_id;
+  };
+}
+// src/conversation.ts
+import { createConversation } from "@grammyjs/conversations";
+import { hydrate } from "@grammyjs/hydrate";
+import { GlobalMenuRegistry as GlobalMenuRegistry2, getGrammyXOptions } from "@grammy-x/core";
+function createCustomConversation(builder, config) {
+  let cfg = typeof config === "string" ? { id: config } : config;
+  cfg = cfg ?? {};
+  const id = cfg.id ?? builder.name;
+  cfg.id = id;
+  GlobalMenuRegistry2.register({
+    menuName: id,
+    send: async (ctx) => {
+      if (!ctx.conversation) {
+        console.error(`[Grammy-X] Cannot enter conversation '${id}': ctx.conversation is undefined. Make sure bot.use(conversations()) is registered before components that use it.`);
+        return;
+      }
+      if (ctx.conversation.active) {
+        await ctx.conversation.exit();
+      }
+      return ctx.conversation.enter(id);
+    }
+  });
+  return createConversation(async (conversation, ctx) => {
+    await conversation.run(hydrate());
+    const gx = ctx.session?._gx;
+    if (gx && gx.history[gx.history.length - 1] !== id) {
+      gx.history.push(id);
+      if (gx.history.length > 20)
+        gx.history.shift();
+    }
+    try {
+      return await builder(conversation, ctx);
+    } catch (e) {
+      if (e.name === "CommandInterruptError") {
+        const cmd = e.message.split(":")[1];
+        const opts = getGrammyXOptions(e.ctx);
+        const targetMenu = opts?.interruptCommands?.[cmd];
+        if (targetMenu) {
+          try {
+            if (typeof targetMenu === "string") {
+              await e.ctx.menu.nav(targetMenu);
+            } else if (typeof targetMenu.send === "function") {
+              await targetMenu.send(e.ctx);
+            }
+          } catch (err) {
+            console.error(`Could not auto-nav to target menu for command ${cmd}`, err);
+          }
+        }
+        return;
+      }
+      throw e;
+    }
+  }, cfg);
+}
+export {
+  createCustomConversation,
+  QuestionHelper
+};

package/dist/utils/src/dedent.d.ts

@@ -0,0 +1,5 @@
+export declare const dedent: {
+    (literals: string): string;
+    (strings: TemplateStringsArray, ...values: unknown[]): string;
+};
+//# sourceMappingURL=dedent.d.ts.map