@kastov/grammy-nestjs 0.4.1

package/CHANGELOG.md

@@ -0,0 +1,54 @@
+# Changelog
+
+This file was generated using [@jscutlery/semver](https://github.com/jscutlery/semver).
+
+## [0.4.0](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.3.1...grammy-nestjs-0.4.0) (2023-01-08)
+
+### Features
+
+-   create composer decorators ([4be9318](https://github.com/grammyjs/nestjs/commit/4be93183f55eea3bd87c434d5b91292a0cb320ca))
+
+### [0.3.3](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.3.2...grammy-nestjs-0.3.3) (2023-01-08)
+
+### Add back `bot.use(...)` call in factory to fix middleware.
+
+-   bump deps - include NestJS@^9.0.0 ([44e17b0](https://github.com/grammyjs/nestjs/commit/44e17b04c2a3a093fa9cbaaacc9ab217111c4594))
+
+## [0.3.2](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.3.1...grammy-nestjs-0.3.2) (2022-10-07)
+
+### Publish peer dependency for NestJS ^9.0.0.
+
+### [0.3.1](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.3.0...grammy-nestjs-0.3.1) (2022-06-26)
+
+### Bug Fixes
+
+-   add lodash and other deps to package.json build ([ad7389c](https://github.com/grammyjs/nestjs/commit/ad7389c70cf9754482f6721638d140c5bc7c964a)), closes [#14](https://github.com/grammyjs/nestjs/issues/14)
+
+## [0.3.0](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.2.0...grammy-nestjs-0.3.0) (2022-06-25)
+
+### Features
+
+-   fix explorer startup race condition ([9de1ce5](https://github.com/grammyjs/nestjs/commit/9de1ce511cdcd052ae4dc83e19ad7a64fa6b1588)), closes [#10](https://github.com/grammyjs/nestjs/issues/10)
+-   misc cleanup ([ad47d69](https://github.com/grammyjs/nestjs/commit/ad47d69252af646a92e3c44ab66a24e6c59e34ab))
+-   rename emitter and cleanup code ([d7d5297](https://github.com/grammyjs/nestjs/commit/d7d529798ef2571dfe3e9b80cfbe145545dde6fc))
+
+## [0.2.0](https://github.com/grammyjs/nestjs/compare/grammy-nestjs-0.1.0...grammy-nestjs-0.2.0) (2022-04-23)
+
+### Features
+
+-   add callbackQuery decorator ([bb81d64](https://github.com/grammyjs/nestjs/commit/bb81d643c64c36f19941f7b463749888f9ac05be))
+-   changing startup webhook flag ([a1004ee](https://github.com/grammyjs/nestjs/commit/a1004ee343249fa4e845382f003b63ec3432b380))
+-   initial support for firebase serverless bot ([93d8f83](https://github.com/grammyjs/nestjs/commit/93d8f8335b567979d0a5729d50dff07df36f0ee1))
+-   updating deployment script ([558d5c1](https://github.com/grammyjs/nestjs/commit/558d5c165d4ff2546b50054bae26f3c599a836d5))
+
+## 0.1.0 (2022-04-19)
+
+### Features
+
+-   changing startup webhook flag ([a1004ee](https://github.com/grammyjs/nestjs/commit/a1004ee343249fa4e845382f003b63ec3432b380))
+-   initial support for firebase serverless bot ([93d8f83](https://github.com/grammyjs/nestjs/commit/93d8f8335b567979d0a5729d50dff07df36f0ee1))
+-   updating deployment script ([558d5c1](https://github.com/grammyjs/nestjs/commit/558d5c165d4ff2546b50054bae26f3c599a836d5))
+
+### Bug Fixes
+
+-   fix namespace to [@grammyjs](https://github.com/grammyjs) ([3f4c92a](https://github.com/grammyjs/nestjs/commit/3f4c92a2b61a04779f633e6dc5157d793b07c2c3))

package/README.md

@@ -0,0 +1,362 @@
+<div align="center">
+
+![issues](https://badgen.net/github/open-issues/grammyjs/nestjs)![GitHub last commit](https://img.shields.io/github/last-commit/grammyjs/nestjs)![tags](https://badgen.net/github/tags/grammyjs/nestjs)![license](https://badgen.net/badge/license/MIT/blue)
+
+</div>
+
+# grammY port of NestJS Telegraf
+
+> :information_source: This project would not be possible without the help and assistance of [Aleksandr Bukhalo](https://t.me/bukhalo_a) and the fantastic [bukhalo/nestjs-telegraf](https://github.com/bukhalo/nestjs-telegraf) project.
+
+## Table of Contents
+
+-   [grammY port of NestJS Telegraf](#grammy-port-of-nestjs-telegraf)
+    -   [Table of Contents](#table-of-contents)
+    -   [Features](#features)
+    -   [Installation](#installation)
+    -   [Usage](#usage)
+    -   [grammY instance access](#grammy-instance-access)
+    -   [Asynchronous Configuration](#asynchronous-configuration)
+    -   [Getting Updates](#getting-updates)
+        -   [Long polling](#long-polling)
+        -   [Webhooks](#webhooks)
+    -   [Middlewares](#middlewares)
+    -   [Multiple Bots](#multiple-bots)
+    -   [Standalone Applications](#standalone-applications)
+
+<img align="right" width="95" height="148" title="NestJS logotype"
+     src="https://nestjs.com/img/logo-small.svg">
+
+NestJS grammY – powerful solution for creating Telegram bots.
+
+This package uses the best of the NodeJS world under the hood. [grammY](https://github.com/grammyjs/grammY) is the most powerful library for creating bots and [NestJS](https://github.com/nestjs) is a progressive framework for creating well-architectured applications. This module provides fast and easy way for creating Telegram bots and deep integration with your NestJS application.
+
+## Features
+
+-   Simple. Easy to use.
+-   Ton of decorators available out of the box for handling bot actions.
+-   Ability to create custom decorators.
+-   grammY plugins and custom plugins support.
+-   Ability to run multiple bots simultaneously.
+-   Full support of NestJS guards, interceptors, filters and pipes!
+
+## Installation
+
+```bash
+npm i @grammyjs/nestjs
+# or
+yarn add @grammyjs/nestjs
+```
+
+## Usage
+
+Once the installation process is complete, we can import the `NestjsGrammyModule` into the root `AppModule`:
+
+```typescript
+import { Module } from '@nestjs/common'
+import { NestjsGrammyModule } from '@grammyjs/nestjs'
+
+@Module({
+    imports: [
+        NestjsGrammyModule.forRoot({
+            token: 'TELEGRAM_BOT_TOKEN',
+        }),
+    ],
+})
+export class AppModule {}
+```
+
+Then create `app.update.ts` file and add some decorators for handling Telegram bot API updates:
+
+```typescript
+import { Bot, Context } from 'grammy'
+import { InjectBot, Update, Message, Start, Hears, Ctx, Help, Admin } from '@grammyjs/nestjs'
+
+@Update()
+@UseInterceptors(ResponseTimeInterceptor)
+@UseFilters(GrammyExceptionFilter)
+export class EchoUpdate {
+    constructor(
+        @InjectBot(EchoBotName)
+        private readonly bot: Bot<Context>,
+        private readonly echoService: EchoService,
+    ) {
+        log('echo update starting', this.bot ? this.bot.botInfo.id : '(booting)')
+    }
+
+    @Start()
+    async onStart(@Ctx() ctx: Context): Promise<void> {
+        // const me = await this.bot.api.getMe()
+        log('onStart!!', this.bot ? this.bot.botInfo : '(booting)')
+        ctx.reply(`Hey, I'm ${this.bot.botInfo.first_name}`)
+    }
+
+    @Help()
+    async onHelp(@Ctx() ctx: Context): Promise<void> {
+        ctx.reply('Send me any text')
+    }
+
+    @Admin()
+    @UseGuards(AdminGuard)
+    async onAdminCommand(@Ctx() ctx: Context): Promise<void> {
+        ctx.reply('Welcome, Judge')
+    }
+
+    @Hears('greetings')
+    async onMessage(@Ctx() ctx: Context, @Message('text', new ReverseTextPipe()) reversedText: string): Promise<void> {
+        ctx.reply(reversedText)
+    }
+
+    @On('chat_member')
+    @UpdateFilter(ctx => ctx.chatMember?.new_chat_member.status === 'member')
+    greetNewMember(@Ctx() ctx: Context) {
+        ctx.reply(`Welcome to our chat, ${ctx.chatMember.new_chat_member.user.first_name}!`)
+    }
+
+    @On('message')
+    @ChatType('private')
+    onPrivateMessage(@Ctx() ctx: Context) {
+        ctx.reply('Hello! This is private chat. You can continue to tell me your secrets')
+    }
+}
+```
+
+## grammY instance access
+
+If you want to use `grammY` instance directly, you can use `@InjectBot` for that.
+
+```typescript
+import { Injectable } from '@nestjs/common'
+import { Bot, Context } from 'grammy'
+import { InjectBot } from '@grammyjs/nestjs'
+
+@Injectable()
+export class EchoService {
+  constructor(@InjectBot(EchoBotName) private readonly bot: Bot<Context>) {}
+  ...
+}
+```
+
+## Asynchronous Configuration
+
+When you need to pass module options asynchronously instead of statically, use the forRootAsync() method. As with most dynamic modules, Nest provides several techniques to deal with async configuration.
+
+One technique is to use a factory function:
+
+```typescript
+NestjsGrammyModule.forRootAsync({
+    useFactory: () => ({
+        token: 'TELEGRAM_BOT_TOKEN',
+    }),
+})
+```
+
+Like other [factory providers](https://docs.nestjs.com/fundamentals/custom-providers#factory-providers-usefactory), our factory function can be async and can inject dependencies through inject.
+
+```typescript
+NestjsGrammyModule.forRootAsync({
+    imports: [ConfigModule.forFeature(grammyModuleConfig)],
+    useFactory: async (configService: ConfigService) => ({
+        token: configService.get<string>('TELEGRAM_BOT_TOKEN'),
+    }),
+    inject: [ConfigService],
+})
+```
+
+Alternatively, you can configure the NestjsGrammyModule using a class instead of a factory, as shown below:
+
+```typescript
+NestjsGrammyModule.forRootAsync({
+    useClass: MyConfigService,
+})
+```
+
+The construction above instantiates `MyConfigService` inside `NestjsGrammyModule`, using it to create the required options object. Note that in this example, the `MyConfigService` has to implement the `MyOptionsFactory` interface, as shown below. The `NestjsGrammyModule` will call the `createMyOptions()` method on the instantiated object of the supplied class.
+
+```typescript
+@Injectable()
+class MyConfigService implements MyOptionsFactory {
+    createMyOptions(): NestjsGrammyModuleOptions {
+        return {
+            token: 'TELEGRAM_BOT_TOKEN',
+        }
+    }
+}
+```
+
+If you want to reuse an existing options provider instead of creating a private copy inside the `NestjsGrammyModule`, use the `useExisting` syntax.
+
+```typescript
+NestjsGrammyModule.forRootAsync({
+    imports: [ConfigModule.forFeature(grammyModuleConfig)],
+    useExisting: ConfigService,
+})
+```
+
+## Getting Updates
+
+### Long polling
+
+By default, the bot receives updates using long-polling and requires no additional action.
+
+### Webhooks
+
+To utilize webhooks, the best documentation is to review the [Sample Firebase Bot](tree/main/packages/sample-firebase-bot) package and how it configures webhooks.
+
+At a high level, you simply enable webhooks and pass the webhook module as follows:
+
+```ts
+      useWebhook: true,
+      include: [FirebaseWebhookModule],
+```
+
+This module must initialize the webhooks for grammY as such:
+
+```ts
+  configure(consumer: MiddlewareConsumer) {
+    consumer.apply(webhookCallback(this.bot, 'express')).forRoutes('*')
+  }
+```
+
+The last step is to write the update functions in a module like this:
+
+```ts
+@Update()
+@UseInterceptors(ResponseTimeInterceptor)
+@UseFilters(GrammyExceptionFilter)
+export class WebhookUpdater {
+  private readonly inlineKeyboard: InlineKeyboard
+
+  constructor(
+    @InjectBot(FirebaseBotName)
+    private readonly bot: Bot<Context>,
+    private readonly botService: FirebaseBotService,
+  ) {
+    log(`Initializing`, bot.isInited() ? bot.botInfo.first_name : '(pending)')
+  }
+
+  @Start()
+  async onStart(@Ctx() ctx: Context): Promise<any> {
+    log('onStart!!', this.bot ? this.bot.botInfo.first_name : '(booting)')
+    return ctx.reply('Curious? Click me!', { reply_markup: this.inlineKeyboard })
+  }
+
+  @CallbackQuery('click-payload')
+  async onCallback(@Ctx() ctx: Context): Promise<any> {
+    return ctx.answerCallbackQuery({
+      text: 'You were curious, indeed!',
+    })
+  }
+
+  ...
+```
+
+## Middlewares
+
+`@grammyjs/nestjs` has support of the grammY middleware packages. To use an existing middleware package, simply import it and add it to the middlewares array:
+
+```typescript
+NestjsGrammyModule.forRoot({
+  middlewares: [session()],
+}),
+```
+
+## Multiple Bots
+
+In some cases, you may need to run multiple bots at the same time. This can also be achieved with this module. To work with multiple bots, first create the bots. In this case, bot naming becomes mandatory.
+
+```typescript
+import { Module } from '@nestjs/common'
+import { ConfigModule } from '@nestjs/config'
+import { NestjsGrammyModule } from '@grammyjs/nestjs'
+
+@Module({
+    imports: [
+        ConfigModule.forRoot(),
+        NestjsGrammyModule.forRootAsync({
+            imports: [ConfigModule],
+            botName: 'cat',
+            useFactory: (configService: ConfigService) => ({
+                token: configService.get<string>('CAT_BOT_TOKEN'),
+            }),
+            inject: [ConfigService],
+        }),
+        NestjsGrammyModule.forRootAsync({
+            imports: [ConfigModule.forFeature(myModuleConfig)],
+            botName: 'dog',
+            useFactory: async (configService: ConfigService) => ({
+                token: configService.get<string>('DOG_BOT_TOKEN'),
+            }),
+            inject: [ConfigService],
+        }),
+    ],
+})
+export class AppModule {}
+```
+
+:::caution
+Please note that you shouldn't have multiple bots without a name, or with the same name, otherwise they will get overridden.
+:::
+
+You can also inject the `Bot` for a given bot:
+
+```typescript
+import { Injectable } from '@nestjs/common'
+import { InjectBot, Bot, Context } from '@grammyjs/nestjs'
+
+@Injectable()
+export class EchoService {
+    constructor(@InjectBot('cat') private catBot: Bot<Context>) {}
+}
+```
+
+To inject a given `Bot` to a custom provider (for example, factory provider), use the `getBotToken()` function passing the name of the bot as an argument.
+
+```typescript
+{
+  provide: CatsService,
+  useFactory: (catBot: Bot<Context>) => {
+    return new CatsService(catBot);
+  },
+  inject: [getBotToken('cat')],
+}
+```
+
+Another useful feature of the `@grammyjs/nestjs` module is the ability to choose which modules should handle updates for each launched bot. By default, module searches for handlers throughout the whole app. To limit this scan to only a subset of modules, use the include property.
+
+```typescript
+NestjsGrammyModule.forRootAsync({
+  imports: [ConfigModule],
+  botName: 'cat',
+  useFactory: (configService: ConfigService) => ({
+    token: configService.get<string>('CAT_BOT_TOKEN'),
+    include: [CatsModule],
+  }),
+  inject: [ConfigService],
+}),
+```
+
+## Standalone Applications
+
+If you initialized your application with the [Nest CLI](https://docs.nestjs.com/cli/overview), [Express](https://expressjs.com/) framework will be installed by default along with Nest. Nest and NestJS grammY does not require Express for work. So if you don't plan to getting bot updates through webhooks, and you don't need a web server, you can remove Express.
+
+To do this, change the `bootstrap` function in the `main.ts` file of your project on something like that:
+
+```typescript
+async function bootstrap() {
+    const app = await NestFactory.createApplicationContext(AppModule)
+}
+bootstrap()
+```
+
+This initializes Nest as a **standalone application** (without any network listeners).
+
+All that remains is to remove unused dependencies:
+
+```bash
+npm un @nestjs/platform-express @types/express
+```
+
+:::info
+More information about standalone applications located at [Nest documentation](https://docs.nestjs.com/standalone-applications)
+:::

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@kastov/grammy-nestjs",
+  "description": "grammY module for NestJS",
+  "version": "0.4.1",
+  "author": {
+    "name": "Mike Crowe",
+    "email": "drmikecrowe@gmail.com"
+  },
+  "bugs": "https://github.com/grammyjs/nestjs/issues",
+  "contributors": [
+    {
+      "name": "Arthur Asimov",
+      "email": "arthur.asimov.z0@gmail.com"
+    }
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org"
+  },
+  "homepage": "https://github.com/grammyjs/nestjs#README.md",
+  "keywords": [
+    "bot",
+    "bot api",
+    "bot framework",
+    "grammy",
+    "nest",
+    "nestjs",
+    "nestjs-module",
+    "telegram",
+    "telegram bot",
+    "telegram bot api"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "debug": "^4.3.4",
+    "lodash": "^4.17.21",
+    "source-map-support": "^0.5.21",
+    "tslib": "^2.0.0"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "^8.0.0 || ^9.0.0",
+    "@nestjs/core": "^8.0.0 || ^9.0.0",
+    "grammy": "^1.7.3"
+  },
+  "repository": "grammyjs/nestjs",
+  "type": "commonjs",
+  "main": "./src/index.js",
+  "typings": "./src/index.d.ts"
+}

package/src/decorators/composer/chat-type.decorator.d.ts

@@ -0,0 +1 @@
+export declare const ChatType: (arg: "private" | "group" | "supergroup" | "channel" | ("private" | "group" | "supergroup" | "channel")[]) => MethodDecorator;

package/src/decorators/composer/chat-type.decorator.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatType = void 0;
+const create_composer_decorator_util_1 = require("../../utils/create-composer-decorator.util");
+exports.ChatType = (0, create_composer_decorator_util_1.createComposerDecorator)('chatType');
+//# sourceMappingURL=chat-type.decorator.js.map

package/src/decorators/composer/chat-type.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chat-type.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/composer/chat-type.decorator.ts"],"names":[],"mappings":";;;AAAA,+FAAoF;AAEvE,QAAA,QAAQ,GAAG,IAAA,wDAAuB,EAAC,UAAU,CAAC,CAAA"}

package/src/decorators/composer/drop.decorator.d.ts

@@ -0,0 +1 @@
+export declare const Drop: (arg: (ctx: import("grammy").Context) => boolean | Promise<boolean>) => MethodDecorator;

package/src/decorators/composer/drop.decorator.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Drop = void 0;
+const create_composer_decorator_util_1 = require("../../utils/create-composer-decorator.util");
+exports.Drop = (0, create_composer_decorator_util_1.createComposerDecorator)('drop');
+//# sourceMappingURL=drop.decorator.js.map

package/src/decorators/composer/drop.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drop.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/composer/drop.decorator.ts"],"names":[],"mappings":";;;AAAA,+FAAoF;AAEvE,QAAA,IAAI,GAAG,IAAA,wDAAuB,EAAC,MAAM,CAAC,CAAA"}

package/src/decorators/composer/filter.decorator.d.ts

@@ -0,0 +1 @@
+export declare const UpdateFilter: (arg: (ctx: import("grammy").Context) => boolean | Promise<boolean>) => MethodDecorator;

package/src/decorators/composer/filter.decorator.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UpdateFilter = void 0;
+const create_composer_decorator_util_1 = require("../../utils/create-composer-decorator.util");
+exports.UpdateFilter = (0, create_composer_decorator_util_1.createComposerDecorator)('filter');
+//# sourceMappingURL=filter.decorator.js.map

package/src/decorators/composer/filter.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/composer/filter.decorator.ts"],"names":[],"mappings":";;;AAAA,+FAAoF;AAEvE,QAAA,YAAY,GAAG,IAAA,wDAAuB,EAAC,QAAQ,CAAC,CAAA"}

package/src/decorators/composer/index.d.ts

@@ -0,0 +1,3 @@
+export * from './chat-type.decorator';
+export * from './filter.decorator';
+export * from './drop.decorator';

package/src/decorators/composer/index.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./chat-type.decorator"), exports);
+tslib_1.__exportStar(require("./filter.decorator"), exports);
+tslib_1.__exportStar(require("./drop.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/src/decorators/composer/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/composer/index.ts"],"names":[],"mappings":";;;AAAA,gEAAqC;AACrC,6DAAkC;AAClC,2DAAgC"}

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

@@ -0,0 +1,2 @@
+export * from './inject-bot.decorator';
+export * from './update.decorator';

package/src/decorators/core/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./inject-bot.decorator"), exports);
+tslib_1.__exportStar(require("./update.decorator"), exports);
+//# sourceMappingURL=index.js.map

package/src/decorators/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/core/index.ts"],"names":[],"mappings":";;;AAAA,iEAAsC;AACtC,6DAAkC"}

package/src/decorators/core/inject-bot.decorator.d.ts

@@ -0,0 +1 @@
+export declare const InjectBot: (botName?: string) => ParameterDecorator;

package/src/decorators/core/inject-bot.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectBot = void 0;
+const common_1 = require("@nestjs/common");
+const utils_1 = require("../../utils");
+const InjectBot = (botName) => (0, common_1.Inject)((0, utils_1.getBotName)(botName));
+exports.InjectBot = InjectBot;
+//# sourceMappingURL=inject-bot.decorator.js.map

package/src/decorators/core/inject-bot.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-bot.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/core/inject-bot.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAuC;AACvC,uCAAwC;AAEjC,MAAM,SAAS,GAAG,CAAC,OAAgB,EAAsB,EAAE,CAAC,IAAA,eAAM,EAAC,IAAA,kBAAU,EAAC,OAAO,CAAC,CAAC,CAAA;AAAjF,QAAA,SAAS,aAAwE"}

package/src/decorators/core/update.decorator.d.ts

@@ -0,0 +1,5 @@
+/**
+ * `@Update` decorator, it's like NestJS `@Controller` decorator,
+ * but for Telegram Bot API updates.
+ */
+export declare const Update: () => ClassDecorator;

package/src/decorators/core/update.decorator.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Update = void 0;
+const common_1 = require("@nestjs/common");
+const nestjs_grammy_constants_1 = require("../../nestjs-grammy.constants");
+/**
+ * `@Update` decorator, it's like NestJS `@Controller` decorator,
+ * but for Telegram Bot API updates.
+ */
+const Update = () => (0, common_1.SetMetadata)(nestjs_grammy_constants_1.UPDATE_METADATA, true);
+exports.Update = Update;
+//# sourceMappingURL=update.decorator.js.map

package/src/decorators/core/update.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/core/update.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAA4C;AAC5C,2EAA+D;AAE/D;;;GAGG;AACI,MAAM,MAAM,GAAG,GAAmB,EAAE,CAAC,IAAA,oBAAW,EAAC,yCAAe,EAAE,IAAI,CAAC,CAAA;AAAjE,QAAA,MAAM,UAA2D"}

package/src/decorators/index.d.ts

@@ -0,0 +1,4 @@
+export * from './core';
+export * from './listeners';
+export * from './params';
+export * from './composer';

package/src/decorators/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./core"), exports);
+tslib_1.__exportStar(require("./listeners"), exports);
+tslib_1.__exportStar(require("./params"), exports);
+tslib_1.__exportStar(require("./composer"), exports);
+//# sourceMappingURL=index.js.map

package/src/decorators/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/grammy-nestjs/src/decorators/index.ts"],"names":[],"mappings":";;;AAAA,iDAAsB;AACtB,sDAA2B;AAC3B,mDAAwB;AACxB,qDAA0B"}

package/src/decorators/listeners/admin.decorator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handler for /help command.
+ *
+ * @see https://telegraf.js.org/#/?id=help
+ */
+export declare const Admin: (search?: string | RegExp | string[]) => MethodDecorator;

package/src/decorators/listeners/admin.decorator.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Admin = void 0;
+const utils_1 = require("../../utils");
+/**
+ * Handler for /help command.
+ *
+ * @see https://telegraf.js.org/#/?id=help
+ */
+exports.Admin = (0, utils_1.createBotDecorator)('command', 'admin');
+//# sourceMappingURL=admin.decorator.js.map

package/src/decorators/listeners/admin.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/listeners/admin.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAgD;AAEhD;;;;GAIG;AACU,QAAA,KAAK,GAAG,IAAA,0BAAkB,EAAC,SAAS,EAAE,OAAO,CAAC,CAAA"}

package/src/decorators/listeners/callback-query.decorator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Registers middleware for handling keyboard callbacks
+ *
+ * @see https://grammy.dev/plugins/keyboard.html#responding-to-clicks
+ */
+export declare const CallbackQuery: (search?: string | RegExp | string[]) => MethodDecorator;

package/src/decorators/listeners/callback-query.decorator.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CallbackQuery = void 0;
+const utils_1 = require("../../utils");
+/**
+ * Registers middleware for handling keyboard callbacks
+ *
+ * @see https://grammy.dev/plugins/keyboard.html#responding-to-clicks
+ */
+exports.CallbackQuery = (0, utils_1.createBotDecorator)('callbackQuery');
+//# sourceMappingURL=callback-query.decorator.js.map

package/src/decorators/listeners/callback-query.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback-query.decorator.js","sourceRoot":"","sources":["../../../../../../packages/grammy-nestjs/src/decorators/listeners/callback-query.decorator.ts"],"names":[],"mappings":";;;AAAA,uCAAgD;AAEhD;;;;GAIG;AACU,QAAA,aAAa,GAAG,IAAA,0BAAkB,EAAC,eAAe,CAAC,CAAA"}

package/src/decorators/listeners/command.decorator.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handler for /help command.
+ *
+ * @see https://telegraf.js.org/#/?id=help
+ */
+export declare const Command: (search?: string | RegExp | string[]) => MethodDecorator;