@mtcute/dispatcher 0.16.0 → 0.16.9

package/esm/filters/message.js

@@ -1,156 +0,0 @@
-/* eslint-disable @typescript-eslint/no-explicit-any */
-// ^^ will be looked into in MTQ-29
-import { RawDocument, RawLocation, } from '@mtcute/core';
-/**
- * Filter incoming messages.
- *
- * Messages sent to yourself (i.e. Saved Messages) are also "incoming"
- */
-export const incoming = (msg) => !msg.isOutgoing;
-/**
- * Filter outgoing messages.
- *
- * Messages sent to yourself (i.e. Saved Messages) are **not** "outgoing"
- */
-export const outgoing = (msg) => msg.isOutgoing;
-/**
- * Filter for scheduled messages
- */
-export const scheduled = (msg) => msg.isScheduled;
-/**
- * Filter messages that are replies to some other message
- */
-export const reply = (msg) => msg.replyToMessage !== null;
-/**
- * Filter messages that are replies with the given origin type
- */
-export const replyOrigin = (origin) => (msg) => msg.replyToMessage?.originIs(origin) ?? false; // originIs does additional checks
-/**
- * Filter messages containing some media
- */
-export const media = (msg) => msg.media !== null;
-/**
- * Filter messages containing media of given type
- */
-export const mediaOf = (type) => (msg) => msg.media?.type === type;
-/** Filter messages containing a photo */
-export const photo = mediaOf('photo');
-/** Filter messages containing a dice */
-export const dice = mediaOf('dice');
-/** Filter messages containing a contact */
-export const contact = mediaOf('contact');
-/** Filter messages containing an audio file */
-export const audio = mediaOf('audio');
-/** Filter messages containing a voice message (audio-only) */
-export const voice = mediaOf('voice');
-/** Filter messages containing a sticker */
-export const sticker = mediaOf('sticker');
-/** Filter messages containing a document (a file) */
-export const document = mediaOf('document');
-/** Filter messages containing any video (videos, round messages and animations) */
-export const anyVideo = mediaOf('video');
-/** Filter messages containing a static location */
-export const location = mediaOf('location');
-/** Filter messages containing a live location */
-export const liveLocation = mediaOf('live_location');
-/** Filter messages containing a game */
-export const game = mediaOf('game');
-/** Filter messages containing a web page */
-export const webpage = mediaOf('webpage');
-/** Filter messages containing a venue */
-export const venue = mediaOf('venue');
-/** Filter messages containing a poll */
-export const poll = mediaOf('poll');
-/** Filter messages containing an invoice */
-export const invoice = mediaOf('invoice');
-/**
- * Filter messages containing any location (live or static).
- */
-export const anyLocation = (msg) => msg.media instanceof RawLocation;
-/**
- * Filter messages containing a document
- *
- * This will also match media like audio, video, voice
- * that also use Documents
- */
-export const anyDocument = (msg) => msg.media instanceof RawDocument;
-/**
- * Filter messages containing a simple video.
- *
- * This does not include round messages and animations
- */
-export const video = (msg) => msg.media?.type === 'video' && !msg.media.isAnimation && !msg.media.isRound;
-/**
- * Filter messages containing an animation.
- *
- * > **Note**: Legacy GIFs (i.e. documents with `image/gif` MIME)
- * > are also considered animations.
- */
-export const animation = (msg) => msg.media?.type === 'video' && msg.media.isAnimation && !msg.media.isRound;
-/**
- * Filter messages containing a round message (aka video note).
- */
-export const roundMessage = (msg) => msg.media?.type === 'video' && !msg.media.isAnimation && msg.media.isRound;
-/**
- * Filter messages containing a sticker by its type
- */
-export const stickerByType = (type) => (msg) => msg.media?.type === 'sticker' && msg.media.stickerType === type;
-/**
- * Filter messages containing a sticker by its source file type
- */
-export const stickerBySourceType = (type) => (msg) => msg.media?.type === 'sticker' && msg.media.sourceType === type;
-/**
- * Filter text-only messages non-service messages
- */
-export const text = (msg) => msg.media === null && !msg.isService;
-/**
- * Filter service messages
- */
-export const service = (msg) => msg.isService;
-/**
- * Filter service messages by action type
- */
-export const action = (type) => {
-    if (Array.isArray(type)) {
-        const index = {};
-        type.forEach((it) => (index[it] = true));
-        return (msg) => msg.action?.type in index;
-    }
-    return (msg) => msg.action?.type === type;
-};
-export const sender = (type) => (msg) => msg.sender.type === type;
-/**
- * Filter that matches messages that are replies to some other message that can be fetched
- * (i.e. not `private` origin, and has not been deleted)
- *
- * Optionally, you can pass a filter that will be applied to the replied message.
- */
-export const replyTo = (filter) => async (msg, state) => {
-    if (!msg.replyToMessage?.id)
-        return false;
-    const reply = msg._name === 'new_message' ? await msg.getReplyTo() : msg.replyTo;
-    if (!reply)
-        return false;
-    if (msg._name === 'new_message') {
-        msg.getReplyTo = () => Promise.resolve(reply);
-    }
-    if (!filter)
-        return true;
-    return filter(reply, state);
-};
-/**
- * Middleware-like filter that will fetch the sender of the message
- * and make it available to further filters, as well as the handler itself.
- */
-export const withCompleteSender = (filter) => async (msg, state) => {
-    try {
-        await msg.getCompleteSender();
-    }
-    catch (e) {
-        return false;
-    }
-    if (!filter)
-        return true;
-    return filter(msg, state);
-};
-//# sourceMappingURL=message.js.map

package/esm/filters/message.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"message.js","sourceRoot":"","sources":["../../../src/filters/message.ts"],"names":[],"mappings":"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","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// ^^ will be looked into in MTQ-29\nimport {\n    _RepliedMessageAssertionsByOrigin,\n    MaybeArray,\n    Message,\n    MessageAction,\n    MessageMediaType,\n    Peer,\n    RawDocument,\n    RawLocation,\n    RepliedMessageInfo,\n    RepliedMessageOrigin,\n    Sticker,\n    StickerSourceType,\n    StickerType,\n    User,\n    Video,\n} from '@mtcute/core'\n\nimport { BusinessMessageContext } from '../context/business-message.js'\nimport { MessageContext } from '../index.js'\nimport { Modify, UpdateFilter } from './types.js'\n\n/**\n * Filter incoming messages.\n *\n * Messages sent to yourself (i.e. Saved Messages) are also \"incoming\"\n */\nexport const incoming: UpdateFilter<Message, { isOutgoing: false }> = (msg) => !msg.isOutgoing\n\n/**\n * Filter outgoing messages.\n *\n * Messages sent to yourself (i.e. Saved Messages) are **not** \"outgoing\"\n */\nexport const outgoing: UpdateFilter<Message, { isOutgoing: true }> = (msg) => msg.isOutgoing\n\n/**\n * Filter for scheduled messages\n */\nexport const scheduled: UpdateFilter<Message, { isScheduled: true }> = (msg) => msg.isScheduled\n\n/**\n * Filter messages that are replies to some other message\n */\nexport const reply: UpdateFilter<Message, { replyToMessage: RepliedMessageInfo }> = (msg) => msg.replyToMessage !== null\n\n/**\n * Filter messages that are replies with the given origin type\n */\nexport const replyOrigin =\n    <T extends RepliedMessageOrigin>(\n        origin: T,\n    ): UpdateFilter<\n        Message,\n        {\n            replyToMessage: Modify<RepliedMessageInfo, _RepliedMessageAssertionsByOrigin[T] & { origin: T }>\n        }\n    > =>\n        (msg) =>\n            msg.replyToMessage?.originIs(origin) ?? false // originIs does additional checks\n\n/**\n * Filter messages containing some media\n */\nexport const media: UpdateFilter<Message, { media: Exclude<Message['media'], null> }> = (msg) => msg.media !== null\n\n/**\n * Filter messages containing media of given type\n */\nexport const mediaOf =\n    <T extends MessageMediaType>(type: T): UpdateFilter<Message, { media: Extract<Message['media'], { type: T }> }> =>\n        (msg) =>\n            msg.media?.type === type\n\n/** Filter messages containing a photo */\nexport const photo = mediaOf('photo')\n/** Filter messages containing a dice */\nexport const dice = mediaOf('dice')\n/** Filter messages containing a contact */\nexport const contact = mediaOf('contact')\n/** Filter messages containing an audio file */\nexport const audio = mediaOf('audio')\n/** Filter messages containing a voice message (audio-only) */\nexport const voice = mediaOf('voice')\n/** Filter messages containing a sticker */\nexport const sticker = mediaOf('sticker')\n/** Filter messages containing a document (a file) */\nexport const document = mediaOf('document')\n/** Filter messages containing any video (videos, round messages and animations) */\nexport const anyVideo = mediaOf('video')\n/** Filter messages containing a static location */\nexport const location = mediaOf('location')\n/** Filter messages containing a live location */\nexport const liveLocation = mediaOf('live_location')\n/** Filter messages containing a game */\nexport const game = mediaOf('game')\n/** Filter messages containing a web page */\nexport const webpage = mediaOf('webpage')\n/** Filter messages containing a venue */\nexport const venue = mediaOf('venue')\n/** Filter messages containing a poll */\nexport const poll = mediaOf('poll')\n/** Filter messages containing an invoice */\nexport const invoice = mediaOf('invoice')\n\n/**\n * Filter messages containing any location (live or static).\n */\nexport const anyLocation: UpdateFilter<Message, { media: Location }> = (msg) => msg.media instanceof RawLocation\n\n/**\n * Filter messages containing a document\n *\n * This will also match media like audio, video, voice\n * that also use Documents\n */\nexport const anyDocument: UpdateFilter<Message, { media: RawDocument }> = (msg) => msg.media instanceof RawDocument\n\n/**\n * Filter messages containing a simple video.\n *\n * This does not include round messages and animations\n */\nexport const video: UpdateFilter<\n    Message,\n    {\n        media: Modify<\n            Video,\n            {\n                isRound: false\n                isAnimation: false\n            }\n        >\n    }\n> = (msg) => msg.media?.type === 'video' && !msg.media.isAnimation && !msg.media.isRound\n\n/**\n * Filter messages containing an animation.\n *\n * > **Note**: Legacy GIFs (i.e. documents with `image/gif` MIME)\n * > are also considered animations.\n */\nexport const animation: UpdateFilter<\n    Message,\n    {\n        media: Modify<\n            Video,\n            {\n                isRound: false\n                isAnimation: true\n            }\n        >\n    }\n> = (msg) => msg.media?.type === 'video' && msg.media.isAnimation && !msg.media.isRound\n\n/**\n * Filter messages containing a round message (aka video note).\n */\nexport const roundMessage: UpdateFilter<\n    Message,\n    {\n        media: Modify<\n            Video,\n            {\n                isRound: true\n                isAnimation: false\n            }\n        >\n    }\n> = (msg) => msg.media?.type === 'video' && !msg.media.isAnimation && msg.media.isRound\n\n/**\n * Filter messages containing a sticker by its type\n */\nexport const stickerByType =\n    (type: StickerType): UpdateFilter<Message, { media: Sticker }> =>\n        (msg) =>\n            msg.media?.type === 'sticker' && msg.media.stickerType === type\n\n/**\n * Filter messages containing a sticker by its source file type\n */\nexport const stickerBySourceType =\n    (type: StickerSourceType): UpdateFilter<Message, { media: Sticker }> =>\n        (msg) =>\n            msg.media?.type === 'sticker' && msg.media.sourceType === type\n\n/**\n * Filter text-only messages non-service messages\n */\nexport const text: UpdateFilter<\n    Message,\n    {\n        media: null\n        isService: false\n    }\n> = (msg) => msg.media === null && !msg.isService\n\n/**\n * Filter service messages\n */\nexport const service: UpdateFilter<Message, { isService: true }> = (msg) => msg.isService\n\n/**\n * Filter service messages by action type\n */\nexport const action = <T extends Exclude<MessageAction, null>['type']>(\n    type: MaybeArray<T>,\n): UpdateFilter<\n    Message,\n    {\n        action: Extract<MessageAction, { type: T }>\n        sender: T extends 'user_joined_link' | 'user_removed' | 'history_cleared' | 'contact_joined' | 'bot_allowed'\n            ? User\n            : Peer\n    }\n> => {\n    if (Array.isArray(type)) {\n        const index: Partial<Record<T, true>> = {}\n        type.forEach((it) => (index[it] = true))\n\n        return (msg) => (msg.action?.type as any) in index\n    }\n\n    return (msg) => msg.action?.type === type\n}\n\nexport const sender =\n    <T extends Message['sender']['type']>(\n        type: T,\n    ): UpdateFilter<Message, { sender: Extract<Message['sender'], { type: T }> }> =>\n        (msg) =>\n            msg.sender.type === type\n\n/**\n * Filter that matches messages that are replies to some other message that can be fetched\n * (i.e. not `private` origin, and has not been deleted)\n *\n * Optionally, you can pass a filter that will be applied to the replied message.\n */\nexport const replyTo =\n    <Mod, State extends object>(\n        filter?: UpdateFilter<Message, Mod, State>,\n    ): UpdateFilter<MessageContext | BusinessMessageContext, { getReplyTo: () => Promise<Message & Mod> }, State> =>\n        async (msg, state) => {\n            if (!msg.replyToMessage?.id) return false\n\n            const reply = msg._name === 'new_message' ? await msg.getReplyTo() : msg.replyTo\n            if (!reply) return false\n\n            if (msg._name === 'new_message') {\n                msg.getReplyTo = () => Promise.resolve(reply)\n            }\n\n            if (!filter) return true\n\n            return filter(reply, state)\n        }\n\n/**\n * Middleware-like filter that will fetch the sender of the message\n * and make it available to further filters, as well as the handler itself.\n */\nexport const withCompleteSender =\n    <Mod, State extends object>(\n        filter?: UpdateFilter<MessageContext, Mod, State>,\n    ): UpdateFilter<MessageContext, Mod, State> =>\n        async (msg, state) => {\n            try {\n                await msg.getCompleteSender()\n            } catch (e) {\n                return false\n            }\n\n            if (!filter) return true\n\n            return filter(msg, state)\n        }\n"]}

package/esm/filters/state.d.ts

@@ -1,15 +0,0 @@
-import { MaybePromise } from '@mtcute/core';
-import { UpdateFilter } from './types.js';
-/**
- * Create a filter for the cases when the state is empty
- */
-export declare const stateEmpty: UpdateFilter<any>;
-/**
- * Create a filter based on state predicate
- *
- * If state exists and matches `predicate`, update passes
- * this filter, otherwise it doesn't
- *
- * @param predicate  State predicate
- */
-export declare const state: <T extends object>(predicate: (state: T) => MaybePromise<boolean>) => UpdateFilter<any, {}, T>;

package/esm/filters/state.js

@@ -1,27 +0,0 @@
-/**
- * Create a filter for the cases when the state is empty
- */
-export const stateEmpty = async (upd, state) => {
-    if (!state)
-        return false;
-    return !(await state.get());
-};
-/**
- * Create a filter based on state predicate
- *
- * If state exists and matches `predicate`, update passes
- * this filter, otherwise it doesn't
- *
- * @param predicate  State predicate
- */
-export const state = (predicate) => {
-    return async (upd, state) => {
-        if (!state)
-            return false;
-        const data = await state.get();
-        if (!data)
-            return false;
-        return predicate(data);
-    };
-};
-//# sourceMappingURL=state.js.map

package/esm/filters/state.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"state.js","sourceRoot":"","sources":["../../../src/filters/state.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,CAAC,MAAM,UAAU,GAAsB,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IAC9D,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAA;IAExB,OAAO,CAAC,CAAC,MAAM,KAAK,CAAC,GAAG,EAAE,CAAC,CAAA;AAC/B,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CACjB,SAA8C,EAEtB,EAAE;IAC1B,OAAO,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;QACxB,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAA;QACxB,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,CAAA;QAC9B,IAAI,CAAC,IAAI;YAAE,OAAO,KAAK,CAAA;QAEvB,OAAO,SAAS,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC,CAAA;AACL,CAAC,CAAA","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\nimport { MaybePromise } from '@mtcute/core'\n\nimport { UpdateFilter } from './types.js'\n\n/**\n * Create a filter for the cases when the state is empty\n */\nexport const stateEmpty: UpdateFilter<any> = async (upd, state) => {\n    if (!state) return false\n\n    return !(await state.get())\n}\n\n/**\n * Create a filter based on state predicate\n *\n * If state exists and matches `predicate`, update passes\n * this filter, otherwise it doesn't\n *\n * @param predicate  State predicate\n */\nexport const state = <T extends object>(\n    predicate: (state: T) => MaybePromise<boolean>,\n    // eslint-disable-next-line @typescript-eslint/ban-types\n): UpdateFilter<any, {}, T> => {\n    return async (upd, state) => {\n        if (!state) return false\n        const data = await state.get()\n        if (!data) return false\n\n        return predicate(data)\n    }\n}\n"]}

package/esm/filters/text.js

@@ -1,127 +0,0 @@
-function extractText(obj) {
-    switch (obj._name) {
-        case 'new_message':
-        case 'new_business_message':
-            return obj.text;
-        case 'inline_query':
-            return obj.query;
-        case 'chosen_inline_result':
-            return obj.id;
-        case 'callback_query':
-        case 'inline_callback_query':
-        case 'business_callback_query':
-            if (obj.raw.data)
-                return obj.dataStr;
-    }
-    return null;
-}
-/**
- * Filter objects that match a given regular expression
- *  - for `Message`, `Message.text` is used
- *  - for `InlineQuery`, `InlineQuery.query` is used
- *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult#id} is used
- *  - for callback queries, `dataStr` is used
- *
- * When a regex matches, the match array is stored in a
- * type-safe extension field `.match` of the object
- *
- * @param regex  Regex to be matched
- */
-export const regex = (regex) => (obj) => {
-    const txt = extractText(obj);
-    if (!txt)
-        return false;
-    const m = txt.match(regex);
-    if (m) {
-        obj.match = m;
-        return true;
-    }
-    return false;
-};
-/**
- * Filter objects which contain the exact text given
- *  - for `Message`, `Message.text` is used
- *  - for `InlineQuery`, `InlineQuery.query` is used
- *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used
- *  - for callback queries, `dataStr` is used
- *
- * @param str  String to be matched
- * @param ignoreCase  Whether string case should be ignored
- */
-export const equals = (str, ignoreCase = false) => {
-    if (ignoreCase) {
-        str = str.toLowerCase();
-        return (obj) => extractText(obj)?.toLowerCase() === str;
-    }
-    return (obj) => extractText(obj) === str;
-};
-/**
- * Filter objects which contain the text given (as a substring)
- *  - for `Message`, `Message.text` is used
- *  - for `InlineQuery`, `InlineQuery.query` is used
- *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used
- *  - for callback queries, `dataStr` is used
- *
- * @param str  Substring to be matched
- * @param ignoreCase  Whether string case should be ignored
- */
-export const contains = (str, ignoreCase = false) => {
-    if (ignoreCase) {
-        str = str.toLowerCase();
-        return (obj) => {
-            const txt = extractText(obj);
-            return txt != null && txt.toLowerCase().includes(str);
-        };
-    }
-    return (obj) => {
-        const txt = extractText(obj);
-        return txt != null && txt.includes(str);
-    };
-};
-/**
- * Filter objects which contain the text starting with a given string
- *  - for `Message`, `Message.text` is used
- *  - for `InlineQuery`, `InlineQuery.query` is used
- *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used
- *  - for callback queries, `dataStr` is used
- *
- * @param str  Substring to be matched
- * @param ignoreCase  Whether string case should be ignored
- */
-export const startsWith = (str, ignoreCase = false) => {
-    if (ignoreCase) {
-        str = str.toLowerCase();
-        return (obj) => {
-            const txt = extractText(obj);
-            return txt != null && txt.toLowerCase().substring(0, str.length) === str;
-        };
-    }
-    return (obj) => {
-        const txt = extractText(obj);
-        return txt != null && txt.substring(0, str.length) === str;
-    };
-};
-/**
- * Filter objects which contain the text ending with a given string
- *  - for `Message`, `Message.text` is used
- *  - for `InlineQuery`, `InlineQuery.query` is used
- *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used
- *  - for callback queries, `dataStr` is used
- *
- * @param str  Substring to be matched
- * @param ignoreCase  Whether string case should be ignored
- */
-export const endsWith = (str, ignoreCase = false) => {
-    if (ignoreCase) {
-        str = str.toLowerCase();
-        return (obj) => {
-            const txt = extractText(obj);
-            return txt != null && txt.toLowerCase().substring(0, str.length) === str;
-        };
-    }
-    return (obj) => {
-        const txt = extractText(obj);
-        return txt != null && txt.substring(0, str.length) === str;
-    };
-};
-//# sourceMappingURL=text.js.map

package/esm/filters/text.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"text.js","sourceRoot":"","sources":["../../../src/filters/text.ts"],"names":[],"mappings":"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","sourcesContent":["import {\n    BusinessCallbackQuery,\n    BusinessMessage,\n    CallbackQuery,\n    ChosenInlineResult,\n    InlineCallbackQuery,\n    InlineQuery,\n    Message,\n} from '@mtcute/core'\n\nimport { UpdateContextDistributed } from '../context/base.js'\nimport { UpdateFilter } from './types.js'\n\ntype UpdatesWithText = UpdateContextDistributed<\n    | Message\n    | BusinessMessage\n    | InlineQuery\n    | ChosenInlineResult\n    | CallbackQuery\n    | InlineCallbackQuery\n    | BusinessCallbackQuery\n>\n\nfunction extractText(obj: UpdatesWithText): string | null {\n    switch (obj._name) {\n        case 'new_message':\n        case 'new_business_message':\n            return obj.text\n        case 'inline_query':\n            return obj.query\n        case 'chosen_inline_result':\n            return obj.id\n        case 'callback_query':\n        case 'inline_callback_query':\n        case 'business_callback_query':\n            if (obj.raw.data) return obj.dataStr\n    }\n\n    return null\n}\n\n/**\n * Filter objects that match a given regular expression\n *  - for `Message`, `Message.text` is used\n *  - for `InlineQuery`, `InlineQuery.query` is used\n *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult#id} is used\n *  - for callback queries, `dataStr` is used\n *\n * When a regex matches, the match array is stored in a\n * type-safe extension field `.match` of the object\n *\n * @param regex  Regex to be matched\n */\nexport const regex =\n    (regex: RegExp): UpdateFilter<UpdatesWithText, { match: RegExpMatchArray }> =>\n        (obj) => {\n            const txt = extractText(obj)\n            if (!txt) return false\n\n            const m = txt.match(regex)\n\n            if (m) {\n                (obj as typeof obj & { match: RegExpMatchArray }).match = m\n\n                return true\n            }\n\n            return false\n        }\n\n/**\n * Filter objects which contain the exact text given\n *  - for `Message`, `Message.text` is used\n *  - for `InlineQuery`, `InlineQuery.query` is used\n *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used\n *  - for callback queries, `dataStr` is used\n *\n * @param str  String to be matched\n * @param ignoreCase  Whether string case should be ignored\n */\nexport const equals = (str: string, ignoreCase = false): UpdateFilter<UpdatesWithText> => {\n    if (ignoreCase) {\n        str = str.toLowerCase()\n\n        return (obj) => extractText(obj)?.toLowerCase() === str\n    }\n\n    return (obj) => extractText(obj) === str\n}\n\n/**\n * Filter objects which contain the text given (as a substring)\n *  - for `Message`, `Message.text` is used\n *  - for `InlineQuery`, `InlineQuery.query` is used\n *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used\n *  - for callback queries, `dataStr` is used\n *\n * @param str  Substring to be matched\n * @param ignoreCase  Whether string case should be ignored\n */\nexport const contains = (str: string, ignoreCase = false): UpdateFilter<UpdatesWithText> => {\n    if (ignoreCase) {\n        str = str.toLowerCase()\n\n        return (obj) => {\n            const txt = extractText(obj)\n\n            return txt != null && txt.toLowerCase().includes(str)\n        }\n    }\n\n    return (obj) => {\n        const txt = extractText(obj)\n\n        return txt != null && txt.includes(str)\n    }\n}\n\n/**\n * Filter objects which contain the text starting with a given string\n *  - for `Message`, `Message.text` is used\n *  - for `InlineQuery`, `InlineQuery.query` is used\n *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used\n *  - for callback queries, `dataStr` is used\n *\n * @param str  Substring to be matched\n * @param ignoreCase  Whether string case should be ignored\n */\nexport const startsWith = (str: string, ignoreCase = false): UpdateFilter<UpdatesWithText> => {\n    if (ignoreCase) {\n        str = str.toLowerCase()\n\n        return (obj) => {\n            const txt = extractText(obj)\n\n            return txt != null && txt.toLowerCase().substring(0, str.length) === str\n        }\n    }\n\n    return (obj) => {\n        const txt = extractText(obj)\n\n        return txt != null && txt.substring(0, str.length) === str\n    }\n}\n\n/**\n * Filter objects which contain the text ending with a given string\n *  - for `Message`, `Message.text` is used\n *  - for `InlineQuery`, `InlineQuery.query` is used\n *  - for {@link ChosenInlineResult}, {@link ChosenInlineResult.id} is used\n *  - for callback queries, `dataStr` is used\n *\n * @param str  Substring to be matched\n * @param ignoreCase  Whether string case should be ignored\n */\nexport const endsWith = (str: string, ignoreCase = false): UpdateFilter<UpdatesWithText> => {\n    if (ignoreCase) {\n        str = str.toLowerCase()\n\n        return (obj) => {\n            const txt = extractText(obj)\n\n            return txt != null && txt.toLowerCase().substring(0, str.length) === str\n        }\n    }\n\n    return (obj) => {\n        const txt = extractText(obj)\n\n        return txt != null && txt.substring(0, str.length) === str\n    }\n}\n"]}

package/esm/filters/types.d.ts

@@ -1,91 +0,0 @@
-import { MaybePromise } from '@mtcute/core';
-import { UpdateState } from '../state/update-state.js';
-/**
- * Type describing a primitive filter, which is a function taking some `Base`
- * and a {@link TelegramClient}, checking it against some condition
- * and returning a boolean.
- *
- * If `true` is returned, the filter is considered
- * to be matched, and the appropriate update handler function is called,
- * otherwise next registered handler is checked.
- *
- * Additionally, filter might contain a type modification
- * to `Base` for better code insights. If it is present,
- * it is used to overwrite types (!) of some of the `Base` fields
- * to given (note that this is entirely compile-time! object is not modified)
- *
- * For parametrized filters (like {@link filters.regex}),
- * type modification can also be used to add additional fields
- * (in case of `regex`, its match array is added to `.match`)
- *
- * Example without type mod:
- * ```typescript
- *
- * const hasPhoto: UpdateFilter<Message> = msg => msg.media?.type === 'photo'
- *
- * // ..later..
- * tg.onNewMessage(hasPhoto, async (msg) => {
- *     // `hasPhoto` filter matched, so we can safely assume
- *     // that `msg.media` is a Photo.
- *     //
- *     // but it is very redundant, verbose and error-rome,
- *     // wonder if we could make typescript do this automagically and safely...
- *     await (msg.media as Photo).downloadToFile(`${msg.id}.jpg`)
- * })
- * ```
- *
- * Example with type mod:
- * ```typescript
- *
- * const hasPhoto: UpdateFilter<Message, { media: Photo }> = msg => msg.media?.type === 'photo'
- *
- * // ..later..
- * tg.onNewMessage(hasPhoto, async (msg) => {
- *     // since `hasPhoto` filter matched,
- *     // we have applied the modification to `msg`,
- *     // and `msg.media` now has type `Photo`
- *     //
- *     // no more redundancy and type casts!
- *     await msg.media.downloadToFile(`${msg.id}.jpg`)
- * })
- * ```
- *
- * > **Note**: Type modification can contain anything, even totally unrelated types
- * > and it is *your* task to keep track that everything is correct.
- * >
- * > Bad example:
- * > ```typescript
- * > // we check for `Photo`, but type contains `Audio`. this will be a problem!
- * > const hasPhoto: UpdateFilter<Message, { media: Audio }> = msg => msg.media?.type === 'photo'
- * >
- * > // ..later..
- * > tg.onNewMessage(hasPhoto, async (msg) => {
- * >     // oops! `msg.media` is `Audio` and does not have `.width`!
- * >     console.log(msg.media.width)
- * > })
- * > ```
- *
- * > **Warning!** Do not use the generics provided in functions
- * > like `and`, `or`, etc. Those are meant to be inferred by the compiler!
- */
-export type UpdateFilter<Base, Mod = {}, State extends object = never> = (update: Base, state?: UpdateState<State>) => MaybePromise<boolean>;
-export type Modify<Base, Mod> = Omit<Base, keyof Mod> & Mod;
-export type Invert<Base, Mod> = {
-    [P in keyof Mod & keyof Base]: Exclude<Base[P], Mod[P]>;
-};
-export type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never;
-export type ExtractBase<Filter> = Filter extends UpdateFilter<infer I, any> ? I : never;
-export type ExtractMod<Filter> = Filter extends UpdateFilter<any, infer I> ? I : never;
-export type ExtractState<Filter> = Filter extends UpdateFilter<any, any, infer I> ? I : never;
-export type TupleKeys<T extends any[]> = Exclude<keyof T, keyof []>;
-export type WrapBase<T extends any[]> = {
-    [K in TupleKeys<T>]: {
-        base: ExtractBase<T[K]>;
-    };
-};
-export type Values<T> = T[keyof T];
-export type UnwrapBase<T> = T extends {
-    base: any;
-} ? T['base'] : never;
-export type ExtractBaseMany<Filters extends any[]> = UnwrapBase<UnionToIntersection<Values<WrapBase<Filters>>>>;
-export type EmptyObject = Record<never, never>;

package/esm/filters/types.js

@@ -1,5 +0,0 @@
-/* eslint-disable @typescript-eslint/ban-types */
-/* eslint-disable @typescript-eslint/no-explicit-any */
-// ^^ will be looked into in MTQ-29
-export {};
-//# sourceMappingURL=types.js.map

package/esm/filters/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/filters/types.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,uDAAuD;AACvD,mCAAmC","sourcesContent":["/* eslint-disable @typescript-eslint/ban-types */\n/* eslint-disable @typescript-eslint/no-explicit-any */\n// ^^ will be looked into in MTQ-29\n\nimport { MaybePromise } from '@mtcute/core'\n\nimport { UpdateState } from '../state/update-state.js'\n/**\n * Type describing a primitive filter, which is a function taking some `Base`\n * and a {@link TelegramClient}, checking it against some condition\n * and returning a boolean.\n *\n * If `true` is returned, the filter is considered\n * to be matched, and the appropriate update handler function is called,\n * otherwise next registered handler is checked.\n *\n * Additionally, filter might contain a type modification\n * to `Base` for better code insights. If it is present,\n * it is used to overwrite types (!) of some of the `Base` fields\n * to given (note that this is entirely compile-time! object is not modified)\n *\n * For parametrized filters (like {@link filters.regex}),\n * type modification can also be used to add additional fields\n * (in case of `regex`, its match array is added to `.match`)\n *\n * Example without type mod:\n * ```typescript\n *\n * const hasPhoto: UpdateFilter<Message> = msg => msg.media?.type === 'photo'\n *\n * // ..later..\n * tg.onNewMessage(hasPhoto, async (msg) => {\n *     // `hasPhoto` filter matched, so we can safely assume\n *     // that `msg.media` is a Photo.\n *     //\n *     // but it is very redundant, verbose and error-rome,\n *     // wonder if we could make typescript do this automagically and safely...\n *     await (msg.media as Photo).downloadToFile(`${msg.id}.jpg`)\n * })\n * ```\n *\n * Example with type mod:\n * ```typescript\n *\n * const hasPhoto: UpdateFilter<Message, { media: Photo }> = msg => msg.media?.type === 'photo'\n *\n * // ..later..\n * tg.onNewMessage(hasPhoto, async (msg) => {\n *     // since `hasPhoto` filter matched,\n *     // we have applied the modification to `msg`,\n *     // and `msg.media` now has type `Photo`\n *     //\n *     // no more redundancy and type casts!\n *     await msg.media.downloadToFile(`${msg.id}.jpg`)\n * })\n * ```\n *\n * > **Note**: Type modification can contain anything, even totally unrelated types\n * > and it is *your* task to keep track that everything is correct.\n * >\n * > Bad example:\n * > ```typescript\n * > // we check for `Photo`, but type contains `Audio`. this will be a problem!\n * > const hasPhoto: UpdateFilter<Message, { media: Audio }> = msg => msg.media?.type === 'photo'\n * >\n * > // ..later..\n * > tg.onNewMessage(hasPhoto, async (msg) => {\n * >     // oops! `msg.media` is `Audio` and does not have `.width`!\n * >     console.log(msg.media.width)\n * > })\n * > ```\n *\n * > **Warning!** Do not use the generics provided in functions\n * > like `and`, `or`, etc. Those are meant to be inferred by the compiler!\n */\n// we need the second parameter because it carries meta information\n// eslint-disable-next-line @typescript-eslint/no-unused-vars\nexport type UpdateFilter<Base, Mod = {}, State extends object = never> = (\n    update: Base,\n    state?: UpdateState<State>,\n) => MaybePromise<boolean>\n\nexport type Modify<Base, Mod> = Omit<Base, keyof Mod> & Mod\nexport type Invert<Base, Mod> = {\n    [P in keyof Mod & keyof Base]: Exclude<Base[P], Mod[P]>\n}\n\nexport type UnionToIntersection<U> = (U extends any ? (k: U) => void : never) extends (k: infer I) => void ? I : never\n\nexport type ExtractBase<Filter> = Filter extends UpdateFilter<infer I, any> ? I : never\n\nexport type ExtractMod<Filter> = Filter extends UpdateFilter<any, infer I> ? I : never\n\nexport type ExtractState<Filter> = Filter extends UpdateFilter<any, any, infer I> ? I : never\n\nexport type TupleKeys<T extends any[]> = Exclude<keyof T, keyof []>\nexport type WrapBase<T extends any[]> = {\n    [K in TupleKeys<T>]: { base: ExtractBase<T[K]> }\n}\nexport type Values<T> = T[keyof T]\nexport type UnwrapBase<T> = T extends { base: any } ? T['base'] : never\nexport type ExtractBaseMany<Filters extends any[]> = UnwrapBase<UnionToIntersection<Values<WrapBase<Filters>>>>\n\nexport type EmptyObject = Record<never, never>\n"]}

package/esm/filters/updates.d.ts

@@ -1,39 +0,0 @@
-import { ChatMemberUpdate, ChatMemberUpdateType, UserStatus, UserStatusUpdate } from '@mtcute/core';
-import { UpdateFilter } from './types.js';
-/**
- * Create a filter for {@link ChatMemberUpdate} by update type
- *
- * @param types  Update type(s)
- * @link ChatMemberUpdate.Type
- */
-export declare const chatMember: {
-    <T extends ChatMemberUpdateType>(type: T): UpdateFilter<ChatMemberUpdate, {
-        type: T;
-    }>;
-    <T extends ChatMemberUpdateType[]>(types: T): UpdateFilter<ChatMemberUpdate, {
-        type: T[number];
-    }>;
-};
-/**
- * Create a filter for {@link UserStatusUpdate} by new user status
- *
- * @param statuses  Update type(s)
- * @link User.Status
- */
-export declare const userStatus: {
-    <T extends UserStatus>(status: T): UpdateFilter<UserStatusUpdate, {
-        type: T;
-        lastOnline: T extends 'offline' ? Date : null;
-        nextOffline: T extends 'online' ? Date : null;
-    }>;
-    <T extends UserStatus[]>(statuses: T): UpdateFilter<UserStatusUpdate, {
-        type: T[number];
-    }>;
-};
-/**
- * Create a filter for {@link ChatMemberUpdate} for updates
- * regarding current user
- */
-export declare const chatMemberSelf: UpdateFilter<ChatMemberUpdate, {
-    isSelf: true;
-}>;

package/esm/filters/updates.js

@@ -1,34 +0,0 @@
-/**
- * Create a filter for {@link ChatMemberUpdate} by update type
- *
- * @param types  Update type(s)
- * @link ChatMemberUpdate.Type
- */
-export const chatMember = (types) => {
-    if (Array.isArray(types)) {
-        const index = {};
-        types.forEach((typ) => (index[typ] = true));
-        return (upd) => upd.type in index;
-    }
-    return (upd) => upd.type === types;
-};
-/**
- * Create a filter for {@link UserStatusUpdate} by new user status
- *
- * @param statuses  Update type(s)
- * @link User.Status
- */
-export const userStatus = (statuses) => {
-    if (Array.isArray(statuses)) {
-        const index = {};
-        statuses.forEach((typ) => (index[typ] = true));
-        return (upd) => upd.status in index;
-    }
-    return (upd) => upd.status === statuses;
-};
-/**
- * Create a filter for {@link ChatMemberUpdate} for updates
- * regarding current user
- */
-export const chatMemberSelf = (upd) => upd.isSelf;
-//# sourceMappingURL=updates.js.map

package/esm/filters/updates.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"updates.js","sourceRoot":"","sources":["../../../src/filters/updates.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAGnB,CAAC,KAAuC,EAAkC,EAAE;IAC5E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,KAAK,GAAgD,EAAE,CAAA;QAC7D,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QAE3C,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,IAAI,KAAK,CAAA;IACrC,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,KAAK,KAAK,CAAA;AACtC,CAAC,CAAA;AAED;;;;;GAKG;AACH,MAAM,CAAC,MAAM,UAAU,GAYnB,CAAC,QAAgC,EAAkC,EAAE;IACrE,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,MAAM,KAAK,GAAsC,EAAE,CAAA;QACnD,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC,CAAA;QAE9C,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,IAAI,KAAK,CAAA;IACvC,CAAC;IAED,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,KAAK,QAAQ,CAAA;AAC3C,CAAC,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAqD,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,MAAM,CAAA","sourcesContent":["import { ChatMemberUpdate, ChatMemberUpdateType, MaybeArray, UserStatus, UserStatusUpdate } from '@mtcute/core'\n\nimport { UpdateFilter } from './types.js'\n\n/**\n * Create a filter for {@link ChatMemberUpdate} by update type\n *\n * @param types  Update type(s)\n * @link ChatMemberUpdate.Type\n */\nexport const chatMember: {\n    <T extends ChatMemberUpdateType>(type: T): UpdateFilter<ChatMemberUpdate, { type: T }>\n    <T extends ChatMemberUpdateType[]>(types: T): UpdateFilter<ChatMemberUpdate, { type: T[number] }>\n} = (types: MaybeArray<ChatMemberUpdateType>): UpdateFilter<ChatMemberUpdate> => {\n    if (Array.isArray(types)) {\n        const index: Partial<Record<ChatMemberUpdateType, true>> = {}\n        types.forEach((typ) => (index[typ] = true))\n\n        return (upd) => upd.type in index\n    }\n\n    return (upd) => upd.type === types\n}\n\n/**\n * Create a filter for {@link UserStatusUpdate} by new user status\n *\n * @param statuses  Update type(s)\n * @link User.Status\n */\nexport const userStatus: {\n    <T extends UserStatus>(\n        status: T,\n    ): UpdateFilter<\n        UserStatusUpdate,\n        {\n            type: T\n            lastOnline: T extends 'offline' ? Date : null\n            nextOffline: T extends 'online' ? Date : null\n        }\n    >\n    <T extends UserStatus[]>(statuses: T): UpdateFilter<UserStatusUpdate, { type: T[number] }>\n} = (statuses: MaybeArray<UserStatus>): UpdateFilter<UserStatusUpdate> => {\n    if (Array.isArray(statuses)) {\n        const index: Partial<Record<UserStatus, true>> = {}\n        statuses.forEach((typ) => (index[typ] = true))\n\n        return (upd) => upd.status in index\n    }\n\n    return (upd) => upd.status === statuses\n}\n\n/**\n * Create a filter for {@link ChatMemberUpdate} for updates\n * regarding current user\n */\nexport const chatMemberSelf: UpdateFilter<ChatMemberUpdate, { isSelf: true }> = (upd) => upd.isSelf\n"]}

package/esm/filters/user.js

@@ -1,72 +0,0 @@
-import { User, } from '@mtcute/core';
-/**
- * Filter messages generated by yourself (including Saved Messages)
- */
-export const me = (msg) => (msg.sender.type === 'user' && msg.sender.isSelf) || msg.isOutgoing;
-/**
- * Filter messages sent by bots
- */
-export const bot = (msg) => msg.sender.constructor === User && msg.sender.isBot;
-// prettier-ignore
-/**
- * Filter updates by user ID(s) or username(s)
- *
- * Note that only some updates support filtering by username.
- */
-export const userId = (id) => {
-    const indexId = new Set();
-    const indexUsername = new Set();
-    let matchSelf = false;
-    if (!Array.isArray(id))
-        id = [id];
-    id.forEach((id) => {
-        if (id === 'me' || id === 'self') {
-            matchSelf = true;
-        }
-        else if (typeof id === 'string') {
-            indexUsername.add(id);
-        }
-        else {
-            indexId.add(id);
-        }
-    });
-    return (upd) => {
-        switch (upd._name) {
-            case 'new_message':
-            case 'edit_message':
-            case 'new_business_message':
-            case 'edit_business_message': {
-                const sender = upd.sender;
-                return (matchSelf && sender.isSelf) ||
-                    indexId.has(sender.id) ||
-                    indexUsername.has(sender.username);
-            }
-            case 'user_status':
-            case 'user_typing': {
-                const id = upd.userId;
-                return (matchSelf && id === upd.client.storage.self.getCached()?.userId) ||
-                    indexId.has(id);
-            }
-            case 'poll_vote':
-            case 'story':
-            case 'delete_story': {
-                const peer = upd.peer;
-                if (peer.type !== 'user')
-                    return false;
-                return (matchSelf && peer.isSelf) ||
-                    indexId.has(peer.id) ||
-                    Boolean(peer.usernames?.some((u) => indexUsername.has(u.username)));
-            }
-            case 'history_read': {
-                const id = upd.chatId;
-                return (matchSelf && id === upd.client.storage.self.getCached()?.userId) ||
-                    indexId.has(id);
-            }
-        }
-        const user = upd.user;
-        return ((matchSelf && user.isSelf) ||
-            indexId.has(user.id) ||
-            Boolean(user.usernames?.some((u) => indexUsername.has(u.username))));
-    };
-};
-//# sourceMappingURL=user.js.map