@grammyjs/commands 0.3.0 → 0.5.0

package/README.md

@@ -1,35 +1,37 @@
 ## grammY Commands Plugin
 
-This plugin provides a convenient way to define and manage commands for your grammY bot. It simplifies the process of setting up commands with scopes and localization.
+This plugin provides a convenient way to define and manage commands for your grammY bot. It simplifies the process of
+setting up commands with scopes and localization.
 
 ## Installation
 
-On NPM, this plugin is available as `@grammyjs/commands`, and on Deno it's available at [deno.land/x/grammy_commands](https://deno.land/x/grammy_commands).
-
-You can install it for Node.js with this command:
-
 ```sh
 npm i @grammyjs/commands
 ```
 
-
 ## Usage
 
-The main functionality of this plugin is to define your commands, localize them, and give them handlers for each [scope](https://core.telegram.org/bots/api#botcommandscope), like so:
-
+The main functionality of this plugin is to define your commands, localize them, and give them handlers for each
+[scope](https://core.telegram.org/bots/api#botcommandscope), like so:
 
 ```typescript
-import { Bot } from "https://deno.land/x/grammy/mod.ts";
-import { Commands } from "https://deno.land/x/grammy_commands/mod.ts";
+import { Bot } from "grammy";
+import { Commands } from "@grammyjs/commands";
 
 const bot = new Bot("<telegram token>");
 
 const myCommands = new Commands();
 
 myCommands.command("start", "Initializes bot configuration")
-  .localize("pt", "start", "Inicializa as configurações do bot")
-  .addToScope({ type: "all_private_chats" }, (ctx) => ctx.reply(`Hello, ${ctx.chat.first_name}!`))
-  .addToScope({ type: "all_group_chats" }, (ctx) => ctx.reply(`Hello, members of ${ctx.chat.title}!`));
+    .localize("pt", "start", "Inicializa as configurações do bot")
+    .addToScope(
+        { type: "all_private_chats" },
+        (ctx) => ctx.reply(`Hello, ${ctx.chat.first_name}!`),
+    )
+    .addToScope(
+        { type: "all_group_chats" },
+        (ctx) => ctx.reply(`Hello, members of ${ctx.chat.title}!`),
+    );
 
 // Calls `setMyCommands`
 await myCommands.setCommands(bot);
@@ -40,17 +42,17 @@ bot.use(myCommands);
 bot.start();
 ```
 
-It is very important that you call `bot.use` with your instance of the `Commands` class.
-Otherwise, the command handlers will not be registered, and your bot will not respond to those commands.
+It is very important that you call `bot.use` with your instance of the `Commands` class. Otherwise, the command handlers
+will not be registered, and your bot will not respond to those commands.
 
 ### Context shortcuts
 
-This plugin provides a shortcut for setting the commands for the current chat.
-To use it, you need to install the commands flavor and the plugin itself, like so:
+This plugin provides a shortcut for setting the commands for the current chat. To use it, you need to install the
+commands flavor and the plugin itself, like so:
 
 ```typescript
-import { Bot, Context } from "https://deno.land/x/grammy/mod.ts";
-import { Commands, CommandsFlavor, commands } from "https://deno.land/x/grammy_commands/mod.ts";
+import { Bot, Context } from "grammy";
+import { Commands, commands, CommandsFlavor } from "@grammyjs/commands";
 
 type BotContext = CommandsFlavor;
 
@@ -58,15 +60,15 @@ const bot = new Bot<BotContext>("<telegram_token>");
 bot.use(commands());
 
 bot.on("message", async (ctx) => {
-  const cmds = new Commands();
+    const cmds = new Commands();
 
-  cmds.command("start", "Initializes bot configuration")
-    .localize("pt", "start", "Inicializa as configurações do bot");
+    cmds.command("start", "Initializes bot configuration")
+        .localize("pt", "start", "Inicializa as configurações do bot");
 
-  await ctx.setMyCommands(cmds);
+    await ctx.setMyCommands(cmds);
 
-  return ctx.reply("Commands set!");
+    return ctx.reply("Commands set!");
 });
 
-bot.start()
-```
+bot.start();
+```

package/out/command.d.ts

@@ -1,24 +1,48 @@
 import { type BotCommand, type BotCommandScope, type BotCommandScopeAllChatAdministrators, type BotCommandScopeAllGroupChats, type BotCommandScopeAllPrivateChats, type ChatTypeMiddleware, type Context, type Middleware, type MiddlewareObj } from "./deps.node.js";
 export type MaybeArray<T> = T | T[];
+export type CommandOptions = {
+    /**
+     * The prefix used to identify a command.
+     * Defaults to `/`.
+     */
+    prefix: string;
+    /**
+     * Whether the command should only be matched at the start of the message.
+     * Defaults to `true`.
+     */
+    matchOnlyAtStart: boolean;
+    /**
+     * Whether to ignore or only care about commands ending with the bot's username.
+     * Defaults to `"optional"`.
+     *
+     * - `"ignored"`: only non-targeted commands are matched
+     * - `"optional"`: both targeted and non-targeted commands are matched
+     * - `"ignored"`: only targeted commands are matched
+     */
+    targetedCommands: "ignored" | "optional" | "required";
+};
 type BotCommandGroupsScope = BotCommandScopeAllGroupChats | BotCommandScopeAllChatAdministrators;
+export declare const matchesPattern: (value: string, pattern: string | RegExp) => boolean;
 export declare class Command<C extends Context = Context> implements MiddlewareObj<C> {
     private _scopes;
     private _languages;
     private _composer;
-    constructor(name: string, description: string);
+    private _options;
+    constructor(name: string | RegExp, description: string, options?: Partial<CommandOptions>);
     get scopes(): BotCommandScope[];
     get languages(): Map<string, {
-        name: string;
+        name: string | RegExp;
         description: string;
     }>;
-    get names(): string[];
-    get name(): string;
+    get names(): (string | RegExp)[];
+    get name(): string | RegExp;
     get description(): string;
-    addToScope(scope: BotCommandGroupsScope, ...middleware: ChatTypeMiddleware<C, "group" | "supergroup">[]): this;
-    addToScope(scope: BotCommandScopeAllPrivateChats, ...middleware: ChatTypeMiddleware<C, "private">[]): this;
-    addToScope(scope: BotCommandScope, ...middleware: Array<Middleware<C>>): this;
-    localize(languageCode: string, name: string, description: string): this;
-    getLocalizedName(languageCode: string): string;
+    addToScope(scope: BotCommandGroupsScope, middleware: MaybeArray<ChatTypeMiddleware<C, "group" | "supergroup">>, options?: Partial<CommandOptions>): this;
+    addToScope(scope: BotCommandScopeAllPrivateChats, middleware: MaybeArray<ChatTypeMiddleware<C, "private">>, options?: Partial<CommandOptions>): this;
+    addToScope(scope: BotCommandScope, middleware: MaybeArray<Middleware<C>>, options?: Partial<CommandOptions>): this;
+    static hasCommand(command: MaybeArray<string | RegExp>, options: CommandOptions): (ctx: Context) => boolean;
+    localize(languageCode: string, name: string | RegExp, description: string): this;
+    getLocalizedName(languageCode: string): string | RegExp;
     getLocalizedDescription(languageCode: string): string;
     toObject(languageCode?: string): BotCommand;
     middleware(): import("grammy").MiddlewareFn<C>;

package/out/command.js

@@ -1,14 +1,26 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Command = void 0;
+exports.Command = exports.matchesPattern = void 0;
 const deps_node_js_1 = require("./deps.node.js");
+const errors_js_1 = require("./errors.js");
+const ensureArray = (value) => Array.isArray(value) ? value : [value];
 const isAdmin = (ctx) => ctx.getAuthor().then((author) => ["administrator", "creator"].includes(author.status));
+const matchesPattern = (value, pattern) => typeof pattern === "string" ? value === pattern : pattern.test(value);
+exports.matchesPattern = matchesPattern;
 class Command {
-    constructor(name, description) {
+    constructor(name, description, options = {}) {
         this._scopes = [];
         this._languages = new Map();
         this._composer = new deps_node_js_1.Composer();
-        this._languages.set("default", { name, description });
+        this._options = {
+            prefix: "/",
+            matchOnlyAtStart: true,
+            targetedCommands: "optional",
+        };
+        this._options = { ...this._options, ...options };
+        if (this._options.prefix === "")
+            this._options.prefix = "/";
+        this._languages.set("default", { name: name, description });
     }
     get scopes() {
         return this._scopes;
@@ -25,21 +37,89 @@ class Command {
     get description() {
         return this._languages.get("default").description;
     }
-    addToScope(scope, ...middleware) {
-        (0, deps_node_js_1.match)(scope)
-            .with({ type: "default" }, () => this._composer.command(this.names, ...middleware))
-            .with({ type: "all_chat_administrators" }, () => this._composer.filter(isAdmin).command(this.names, ...middleware))
-            .with({ type: "all_private_chats" }, () => this._composer.chatType("private").command(this.names, ...middleware))
-            .with({ type: "all_group_chats" }, () => this._composer.chatType(["group", "supergroup"]).command(this.names, ...middleware))
-            .with({ type: deps_node_js_1.P.union("chat", "chat_administrators"), chat_id: deps_node_js_1.P.not(deps_node_js_1.P.nullish).select() }, (chatId) => this._composer.filter((ctx) => { var _a; return ((_a = ctx.chat) === null || _a === void 0 ? void 0 : _a.id) === chatId; }).filter(isAdmin).command(this.names, ...middleware))
-            .with({ type: "chat_member", chat_id: deps_node_js_1.P.not(deps_node_js_1.P.nullish).select("chatId"), user_id: deps_node_js_1.P.not(deps_node_js_1.P.nullish).select("userId") }, ({ chatId, userId }) => this._composer.filter((ctx) => { var _a; return ((_a = ctx.chat) === null || _a === void 0 ? void 0 : _a.id) === chatId; })
-            .filter((ctx) => { var _a; return ((_a = ctx.from) === null || _a === void 0 ? void 0 : _a.id) === userId; })
-            .command(this.names, ...middleware));
+    addToScope(scope, middleware, options = this._options) {
+        const middlewareArray = ensureArray(middleware);
+        const optionsObject = { ...this._options, ...options };
+        switch (scope.type) {
+            case "default":
+                this._composer
+                    .filter(Command.hasCommand(this.names, optionsObject))
+                    .use(...middlewareArray);
+                break;
+            case "all_chat_administrators":
+                this._composer
+                    .filter(Command.hasCommand(this.names, optionsObject))
+                    .filter(isAdmin)
+                    .use(...middlewareArray);
+                break;
+            case "all_private_chats":
+                this._composer
+                    .filter(Command.hasCommand(this.names, optionsObject))
+                    .chatType("private")
+                    .use(...middlewareArray);
+                break;
+            case "all_group_chats":
+                this._composer
+                    .filter(Command.hasCommand(this.names, optionsObject))
+                    .chatType(["group", "supergroup"])
+                    .use(...middlewareArray);
+                break;
+            case "chat":
+            case "chat_administrators":
+                if (scope.chat_id) {
+                    this._composer
+                        .filter(Command.hasCommand(this.names, optionsObject))
+                        .filter((ctx) => { var _a; return ((_a = ctx.chat) === null || _a === void 0 ? void 0 : _a.id) === scope.chat_id; })
+                        .filter(isAdmin)
+                        .use(...middlewareArray);
+                }
+                break;
+            case "chat_member":
+                if (scope.chat_id && scope.user_id) {
+                    this._composer
+                        .filter(Command.hasCommand(this.names, optionsObject))
+                        .filter((ctx) => { var _a; return ((_a = ctx.chat) === null || _a === void 0 ? void 0 : _a.id) === scope.chat_id; })
+                        .filter((ctx) => { var _a; return ((_a = ctx.from) === null || _a === void 0 ? void 0 : _a.id) === scope.user_id; })
+                        .use(...middlewareArray);
+                }
+                break;
+            default:
+                throw new errors_js_1.InvalidScopeError(scope);
+        }
         this._scopes.push(scope);
         return this;
     }
+    static hasCommand(command, options) {
+        const { matchOnlyAtStart, prefix, targetedCommands } = options;
+        return (ctx) => {
+            if (!ctx.has(":text"))
+                return false;
+            if (matchOnlyAtStart && !ctx.msg.text.startsWith(prefix)) {
+                return false;
+            }
+            const commandNames = ensureArray(command);
+            const commands = prefix === "/"
+                ? ctx.entities("bot_command")
+                : ctx.msg.text.split(prefix).map((text) => ({ text }));
+            for (const { text } of commands) {
+                const [command, username] = text.split("@");
+                if (targetedCommands === "ignored" && username)
+                    continue;
+                if (targetedCommands === "required" && !username)
+                    continue;
+                if (username && username !== ctx.me.username)
+                    continue;
+                if (commandNames.some((name) => (0, exports.matchesPattern)(command.replace(prefix, ""), name)))
+                    return true;
+            }
+            return false;
+        };
+    }
     localize(languageCode, name, description) {
-        this._languages.set(languageCode, { name, description });
+        this._languages.set(languageCode, {
+            name: new RegExp(name),
+            description,
+        });
         return this;
     }
     getLocalizedName(languageCode) {
@@ -51,8 +131,9 @@ class Command {
         return (_b = (_a = this._languages.get(languageCode)) === null || _a === void 0 ? void 0 : _a.description) !== null && _b !== void 0 ? _b : this.description;
     }
     toObject(languageCode = "default") {
+        const localizedName = this.getLocalizedName(languageCode);
         return {
-            command: this.getLocalizedName(languageCode),
+            command: localizedName instanceof RegExp ? "" : localizedName,
             description: this.getLocalizedDescription(languageCode),
         };
     }

package/out/{plugin.d.ts → commands.d.ts}

@@ -1,4 +1,4 @@
-import { Command } from "./command.js";
+import { Command, CommandOptions } from "./command.js";
 import { Api, BotCommand, BotCommandScope, Context } from "./deps.node.js";
 type SetMyCommandsParams = {
     scope?: BotCommandScope;
@@ -10,11 +10,12 @@ export declare class Commands<C extends Context> {
     private _scopes;
     private _commands;
     private _composer;
-    constructor(commands?: Command<C>[]);
+    private _commandOptions;
+    constructor(options?: Partial<CommandOptions>);
     private _addCommandToScope;
     private _populateComposer;
     private _populateMetadata;
-    command(name: string, description: string): Command<C>;
+    command(name: string | RegExp, description: string, options?: Partial<CommandOptions>): Command<C>;
     toArgs(): SetMyCommandsParams[];
     toSingleScopeArgs(scope: BotCommandScope): SetMyCommandsParams[];
     setCommands({ api }: {

package/out/{plugin.js → commands.js}

@@ -4,12 +4,13 @@ exports.Commands = void 0;
 const command_js_1 = require("./command.js");
 const deps_node_js_1 = require("./deps.node.js");
 class Commands {
-    constructor(commands = []) {
+    constructor(options = {}) {
         this._languages = new Set();
         this._scopes = new Map();
         this._commands = [];
         this._composer = new deps_node_js_1.Composer();
-        commands.forEach((command) => this._commands.push(command));
+        this._commandOptions = {};
+        this._commandOptions = options;
     }
     _addCommandToScope(scope, command) {
         var _a;
@@ -18,9 +19,7 @@ class Commands {
     }
     _populateComposer() {
         for (const command of this._commands) {
-            for (const args of command.languages.values()) {
-                this._composer.command(args.name, command.middleware());
-            }
+            this._composer.use(command.middleware());
         }
     }
     _populateMetadata() {
@@ -35,8 +34,8 @@ class Commands {
             }
         });
     }
-    command(name, description) {
-        const command = new command_js_1.Command(name, description);
+    command(name, description, options = this._commandOptions) {
+        const command = new command_js_1.Command(name, description, options);
         this._commands.push(command);
         return command;
     }
@@ -47,8 +46,11 @@ class Commands {
             for (const language of this._languages) {
                 params.push({
                     scope: JSON.parse(scope),
-                    language_code: language === "default" ? undefined : language,
-                    commands: commands.map((command) => command.toObject(language)),
+                    language_code: language === "default"
+                        ? undefined
+                        : language,
+                    commands: commands.map((command) => command.toObject(language))
+                        .filter((args) => args.command.length > 0),
                 });
             }
         }

package/out/context.d.ts

@@ -1,6 +1,7 @@
+import { Commands } from "./commands.js";
 import { Context, NextFunction } from "./deps.node.js";
-import { Commands } from "./plugin.js";
-export type CommandsFlavor<C extends Context = Context> = C & {
+import { JaroWinklerOptions } from "./jaro-winkler.js";
+export interface CommandsFlavor<C extends Context = Context> extends Context {
     /**
      * Sets the provided commands for the current chat.
      * Cannot be called on updates that don't have a `chat` property.
@@ -8,6 +9,18 @@ export type CommandsFlavor<C extends Context = Context> = C & {
      * @param commands List of available commands
      * @returns Promise with the result of the operations
      */
-    setMyCommands: (commands: Commands<C>) => Promise<true[]>;
-};
+    setMyCommands: (commands: Commands<C>) => Promise<void>;
+    /**
+     * Returns the nearest command to the user input.
+     * If no command is found, returns `null`.
+     *
+     * @param commands List of available commands
+     * @param options Options for the Jaro-Winkler algorithm
+     * @returns The nearest command or `null`
+     */
+    getNearestCommand: (commands: Commands<C>, options?: Partial<JaroWinklerOptions>) => string | null;
+}
+/**
+ * Installs the commands flavor into the context.
+ */
 export declare function commands<C extends Context>(): (ctx: CommandsFlavor<C>, next: NextFunction) => Promise<void>;

package/out/context.js

@@ -1,15 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.commands = void 0;
+const jaro_winkler_js_1 = require("./jaro-winkler.js");
+/**
+ * Installs the commands flavor into the context.
+ */
 function commands() {
     return (ctx, next) => {
-        ctx.setMyCommands = (commands) => {
-            if (!ctx.chat)
+        ctx.setMyCommands = async (commands) => {
+            if (!ctx.chat) {
                 throw new Error("cannot call `ctx.setMyCommands` on an update with no `chat` property");
-            return Promise.all(commands
+            }
+            await Promise.all(commands
                 .toSingleScopeArgs({ type: "chat", chat_id: ctx.chat.id })
                 .map((args) => ctx.api.raw.setMyCommands(args)));
         };
+        ctx.getNearestCommand = (commands, options) => {
+            var _a;
+            if ((_a = ctx.msg) === null || _a === void 0 ? void 0 : _a.text) {
+                const userInput = ctx.msg.text.substring(1);
+                return (0, jaro_winkler_js_1.fuzzyMatch)(userInput, commands, { ...options });
+            }
+            return null;
+        };
         return next();
     };
 }

package/out/deps.node.d.ts

@@ -1,3 +1,2 @@
 export { Api, Bot, type ChatTypeContext, type ChatTypeMiddleware, type CommandMiddleware, Composer, Context, type Middleware, type MiddlewareObj, type NextFunction, } from "grammy";
 export type { BotCommand, BotCommandScope, BotCommandScopeAllChatAdministrators, BotCommandScopeAllGroupChats, BotCommandScopeAllPrivateChats, Chat, } from "grammy/types";
-export { match, P } from "ts-pattern";

package/out/deps.node.js

@@ -1,12 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.P = exports.match = exports.Context = exports.Composer = exports.Bot = exports.Api = void 0;
-// TODO: Replace with official deno module, once it arrives (https://github.com/gvergnaud/ts-pattern/pull/108)
+exports.Context = exports.Composer = exports.Bot = exports.Api = void 0;
 var grammy_1 = require("grammy");
 Object.defineProperty(exports, "Api", { enumerable: true, get: function () { return grammy_1.Api; } });
 Object.defineProperty(exports, "Bot", { enumerable: true, get: function () { return grammy_1.Bot; } });
 Object.defineProperty(exports, "Composer", { enumerable: true, get: function () { return grammy_1.Composer; } });
 Object.defineProperty(exports, "Context", { enumerable: true, get: function () { return grammy_1.Context; } });
-var ts_pattern_1 = require("ts-pattern");
-Object.defineProperty(exports, "match", { enumerable: true, get: function () { return ts_pattern_1.match; } });
-Object.defineProperty(exports, "P", { enumerable: true, get: function () { return ts_pattern_1.P; } });

package/out/errors.d.ts

@@ -0,0 +1,4 @@
+import { BotCommandScope } from "./deps.node.js";
+export declare class InvalidScopeError extends Error {
+    constructor(scope: BotCommandScope);
+}

package/out/errors.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidScopeError = void 0;
+class InvalidScopeError extends Error {
+    constructor(scope) {
+        super(`Invalid scope: ${scope}`);
+        this.name = "InvalidScopeError";
+    }
+}
+exports.InvalidScopeError = InvalidScopeError;

package/out/jaro-winkler.d.ts

@@ -0,0 +1,9 @@
+import { Commands } from "./commands.js";
+import { Context } from "./deps.node.js";
+export declare function distance(s1: string, s2: string): number;
+export type JaroWinklerOptions = {
+    ignoreCase?: boolean;
+    similarityThreshold?: number;
+};
+export declare function JaroWinklerDistance(s1: string, s2: string, options: Partial<JaroWinklerOptions>): number;
+export declare function fuzzyMatch<C extends Context>(userInput: string, commands: Commands<C>, options: Partial<JaroWinklerOptions>): string | null;

package/out/jaro-winkler.js

@@ -0,0 +1,109 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fuzzyMatch = exports.JaroWinklerDistance = exports.distance = void 0;
+function distance(s1, s2) {
+    if (s1.length === 0 || s2.length === 0) {
+        return 0;
+    }
+    const matchWindow = Math.floor(Math.max(s1.length, s2.length) / 2.0) - 1;
+    const matches1 = new Array(s1.length);
+    const matches2 = new Array(s2.length);
+    let m = 0; // number of matches
+    let t = 0; // number of transpositions
+    let i = 0; // index for string 1
+    let k = 0; // index for string 2
+    for (i = 0; i < s1.length; i++) {
+        // loop to find matched characters
+        const start = Math.max(0, i - matchWindow); // use the higher of the window diff
+        const end = Math.min(i + matchWindow + 1, s2.length); // use the min of the window and string 2 length
+        for (k = start; k < end; k++) {
+            // iterate second string index
+            if (matches2[k]) {
+                // if second string character already matched
+                continue;
+            }
+            if (s1[i] !== s2[k]) {
+                // characters don't match
+                continue;
+            }
+            // assume match if the above 2 checks don't continue
+            matches1[i] = true;
+            matches2[k] = true;
+            m++;
+            break;
+        }
+    }
+    // nothing matched
+    if (m === 0) {
+        return 0.0;
+    }
+    k = 0; // reset string 2 index
+    for (i = 0; i < s1.length; i++) {
+        // loop to find transpositions
+        if (!matches1[i]) {
+            // non-matching character
+            continue;
+        }
+        while (!matches2[k]) {
+            // move k index to the next match
+            k++;
+        }
+        if (s1[i] !== s2[k]) {
+            // if the characters don't match, increase transposition
+            // HtD: t is always less than the number of matches m, because transpositions are a subset of matches
+            t++;
+        }
+        k++; // iterate k index normally
+    }
+    // transpositions divided by 2
+    t /= 2.0;
+    return (m / s1.length + m / s2.length + (m - t) / m) / 3.0; // HtD: therefore, m - t > 0, and m - t < m
+    // HtD: => return value is between 0 and 1
+}
+exports.distance = distance;
+// Computes the Winkler distance between two string -- intrepreted from:
+// http://en.wikipedia.org/wiki/Jaro%E2%80%93Winkler_distance
+// s1 is the first string to compare
+// s2 is the second string to compare
+// dj is the Jaro Distance (if you've already computed it), leave blank and the method handles it
+// ignoreCase: if true strings are first converted to lower case before comparison
+function JaroWinklerDistance(s1, s2, options) {
+    if (s1 === s2) {
+        return 1;
+    }
+    else {
+        if (options.ignoreCase) {
+            s1 = s1.toLowerCase();
+            s2 = s2.toLowerCase();
+        }
+        const jaro = distance(s1, s2);
+        const p = 0.1; // default scaling factor
+        let l = 0; // length of the matching prefix
+        while (s1[l] === s2[l] && l < 4) {
+            l++;
+        }
+        // HtD: 1 - jaro >= 0
+        return jaro + l * p * (1 - jaro);
+    }
+}
+exports.JaroWinklerDistance = JaroWinklerDistance;
+function fuzzyMatch(userInput, commands, options) {
+    const defaultSimilarityThreshold = 0.85;
+    const similarityThreshold = options.similarityThreshold ||
+        defaultSimilarityThreshold;
+    const commandsSet = new Set(commands
+        .toJSON()
+        .flatMap((item) => item.commands.map((command) => command.command)));
+    const bestMatch = Array.from(commandsSet).reduce((best, command) => {
+        const similarity = JaroWinklerDistance(userInput, command, {
+            ...options,
+        });
+        return similarity > best.similarity
+            ? { command, similarity }
+            : best;
+    }, { command: null, similarity: 0 });
+    return bestMatch.similarity > similarityThreshold
+        ? bestMatch.command
+        : null;
+}
+exports.fuzzyMatch = fuzzyMatch;

package/out/mod.d.ts

@@ -1,2 +1,2 @@
+export * from "./commands.js";
 export * from "./context.js";
-export * from "./plugin.js";

package/out/mod.js

@@ -14,5 +14,5 @@ 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("./commands.js"), exports);
 __exportStar(require("./context.js"), exports);
-__exportStar(require("./plugin.js"), exports);

package/package.json

@@ -1,27 +1,28 @@
 {
-  "name": "@grammyjs/commands",
-  "version": "0.3.0",
-  "description": "grammY Commands Plugin",
-  "main": "out/mod.js",
-  "scripts": {
-    "prepare": "deno task backport"
-  },
-  "keywords": [
-    "grammY",
-    "telegram",
-    "bot",
-    "commands"
-  ],
-  "author": "Roz <roz@rjmunhoz.me>",
-  "license": "MIT",
-  "dependencies": {
-    "grammy": "^1.17.1",
-    "ts-pattern": "^5.0.1"
-  },
-  "devDependencies": {
-    "typescript": "^5.1.6"
-  },
-  "files": [
-    "out"
-  ]
+    "name": "@grammyjs/commands",
+    "version": "0.5.0",
+    "description": "grammY Commands Plugin",
+    "main": "out/mod.js",
+    "scripts": {
+        "backport": "deno task backport",
+        "prepare": "deno task backport"
+    },
+    "keywords": [
+        "grammY",
+        "telegram",
+        "bot",
+        "commands"
+    ],
+    "author": "Roz <roz@rjmunhoz.me>",
+    "license": "MIT",
+    "dependencies": {
+        "grammy": "^1.17.1",
+        "ts-pattern": "^5.0.1"
+    },
+    "devDependencies": {
+        "typescript": "^5.1.6"
+    },
+    "files": [
+        "out"
+    ]
 }