@mtcute/dispatcher 0.17.2 → 0.18.0

package/filters/group.js

@@ -0,0 +1,44 @@
+function every(filter) {
+  return (ctx, state) => {
+    let i = 0;
+    const upds = ctx.messages;
+    const max = upds.length;
+    const next = () => {
+      if (i === max) return true;
+      const res = filter(upds[i++], state);
+      if (typeof res === "boolean") {
+        if (!res) return false;
+        return next();
+      }
+      return res.then((r) => {
+        if (!r) return false;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+function some(filter) {
+  return (ctx, state) => {
+    let i = 0;
+    const upds = ctx.messages;
+    const max = upds.length;
+    const next = () => {
+      if (i === max) return false;
+      const res = filter(upds[i++], state);
+      if (typeof res === "boolean") {
+        if (res) return true;
+        return next();
+      }
+      return res.then((r) => {
+        if (r) return true;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+export {
+  every,
+  some
+};

package/filters/index.d.cts

@@ -0,0 +1,4 @@
+import * as filters from './bundle.js';
+import UpdateFilter = filters.UpdateFilter;
+export { filters };
+export type { UpdateFilter };

package/filters/logic.cjs

@@ -0,0 +1,57 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const any = () => true;
+function not(fn) {
+  return (upd, state) => {
+    const res = fn(upd, state);
+    if (typeof res === "boolean") return !res;
+    return res.then((r) => !r);
+  };
+}
+function and(...fns) {
+  return (upd, state) => {
+    let i = 0;
+    const max = fns.length;
+    const next = () => {
+      if (i === max) return true;
+      const res = fns[i++](upd, state);
+      if (typeof res === "boolean") {
+        if (!res) return false;
+        return next();
+      }
+      return res.then((r) => {
+        if (!r) return false;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+function or(...fns) {
+  return (upd, state) => {
+    let i = 0;
+    const max = fns.length;
+    const next = () => {
+      if (i === max) return false;
+      const res = fns[i++](upd, state);
+      if (typeof res === "boolean") {
+        if (res) return true;
+        return next();
+      }
+      return res.then((r) => {
+        if (r) return true;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+exports.and = and;
+exports.any = any;
+exports.not = not;
+exports.or = or;

package/filters/logic.d.cts

@@ -0,0 +1,29 @@
+import { ExtractBaseMany, ExtractMod, Invert, UnionToIntersection, UpdateFilter } from './types.js';
+/**
+ * Filter that matches any update
+ */
+export declare const any: UpdateFilter<any>;
+/**
+ * Invert a filter by applying a NOT logical operation:
+ * `not(fn) = NOT fn`
+ *
+ * > **Note**: This also inverts type modification, i.e.
+ * > if the base is `{ field: string | number | null }`
+ * > and the modification is `{ field: string }`,
+ * > then the negated filter will have
+ * > inverted modification `{ field: number | null }`
+ *
+ * @param fn  Filter to negate
+ */
+export declare function not<Base, Mod, State extends object>(fn: UpdateFilter<Base, Mod, State>): UpdateFilter<Base, Invert<Base, Mod>, State>;
+export declare function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>): UpdateFilter<Base1 & Base2, Mod1 & Mod2, State1 | State2>;
+export declare function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>): UpdateFilter<Base1 & Base2 & Base3, Mod1 & Mod2 & Mod3, State1 | State2 | State3>;
+export declare function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>): UpdateFilter<Base1 & Base2 & Base3 & Base4, Mod1 & Mod2 & Mod3 & Mod4, State1 | State2 | State3 | State4>;
+export declare function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object, Base5, Mod5, State5 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>, fn5: UpdateFilter<Base5, Mod5, State5>): UpdateFilter<Base1 & Base2 & Base3 & Base4 & Base5, Mod1 & Mod2 & Mod3 & Mod4 & Mod5, State1 | State2 | State3 | State4 | State5>;
+export declare function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object, Base5, Mod5, State5 extends object, Base6, Mod6, State6 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>, fn5: UpdateFilter<Base5, Mod5, State5>, fn6: UpdateFilter<Base6, Mod6, State6>): UpdateFilter<Base1 & Base2 & Base3 & Base4 & Base5 & Base6, Mod1 & Mod2 & Mod3 & Mod4 & Mod5 & Mod6, State1 | State2 | State3 | State4 | State5 | State6>;
+export declare function and<Filters extends UpdateFilter<any, any>[]>(...fns: Filters): UpdateFilter<ExtractBaseMany<Filters>, UnionToIntersection<ExtractMod<Filters[number]>>>;
+export declare function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>): UpdateFilter<Base1 & Base2, Mod1 | Mod2, State1 | State2>;
+export declare function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>): UpdateFilter<Base1 & Base2 & Base3, Mod1 | Mod2 | Mod3, State1 | State2 | State3>;
+export declare function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>): UpdateFilter<Base1 & Base2 & Base3 & Base4, Mod1 | Mod2 | Mod3 | Mod4, State1 | State2 | State3 | State4>;
+export declare function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object, Base5, Mod5, State5 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>, fn5: UpdateFilter<Base5, Mod5, State5>): UpdateFilter<Base1 & Base2 & Base3 & Base4 & Base5, Mod1 | Mod2 | Mod3 | Mod4 | Mod5, State1 | State2 | State3 | State4 | State5>;
+export declare function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object, Base3, Mod3, State3 extends object, Base4, Mod4, State4 extends object, Base5, Mod5, State5 extends object, Base6, Mod6, State6 extends object>(fn1: UpdateFilter<Base1, Mod1, State1>, fn2: UpdateFilter<Base2, Mod2, State2>, fn3: UpdateFilter<Base3, Mod3, State3>, fn4: UpdateFilter<Base4, Mod4, State4>, fn5: UpdateFilter<Base5, Mod5, State5>, fn6: UpdateFilter<Base6, Mod6, State6>): UpdateFilter<Base1 & Base2 & Base3 & Base4 & Base5 & Base6, Mod1 | Mod2 | Mod3 | Mod4 | Mod5 | Mod6, State1 | State2 | State3 | State4 | State5 | State6>;

package/filters/logic.js

@@ -0,0 +1,52 @@
+const any = () => true;
+function not(fn) {
+  return (upd, state) => {
+    const res = fn(upd, state);
+    if (typeof res === "boolean") return !res;
+    return res.then((r) => !r);
+  };
+}
+function and(...fns) {
+  return (upd, state) => {
+    let i = 0;
+    const max = fns.length;
+    const next = () => {
+      if (i === max) return true;
+      const res = fns[i++](upd, state);
+      if (typeof res === "boolean") {
+        if (!res) return false;
+        return next();
+      }
+      return res.then((r) => {
+        if (!r) return false;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+function or(...fns) {
+  return (upd, state) => {
+    let i = 0;
+    const max = fns.length;
+    const next = () => {
+      if (i === max) return false;
+      const res = fns[i++](upd, state);
+      if (typeof res === "boolean") {
+        if (res) return true;
+        return next();
+      }
+      return res.then((r) => {
+        if (r) return true;
+        return next();
+      });
+    };
+    return next();
+  };
+}
+export {
+  and,
+  any,
+  not,
+  or
+};

package/filters/logic.test.d.cts

@@ -0,0 +1 @@
+export {};

package/filters/message.cjs

@@ -0,0 +1,130 @@
+if (typeof globalThis !== "undefined" && !globalThis._MTCUTE_CJS_DEPRECATION_WARNED) {
+  globalThis._MTCUTE_CJS_DEPRECATION_WARNED = true;
+  console.warn("[mtcute-workspace] CommonJS support is deprecated and will be removed in 0.20.0. Please consider switching to ESM, it's " + (/* @__PURE__ */ new Date()).getFullYear() + " already.");
+  console.warn("[mtcute-workspace] Learn more about switching to ESM: https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c");
+}
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const core = require("@mtcute/core");
+const incoming = (msg) => !msg.isOutgoing;
+const outgoing = (msg) => msg.isOutgoing;
+const scheduled = (msg) => msg.isScheduled;
+const reply = (msg) => msg.replyToMessage !== null;
+function replyOrigin(origin) {
+  return (msg) => msg.replyToMessage?.originIs(origin) ?? false;
+}
+const media = (msg) => msg.media !== null;
+function mediaOf(type) {
+  return (msg) => msg.media?.type === type;
+}
+const photo = mediaOf("photo");
+const dice = mediaOf("dice");
+const contact = mediaOf("contact");
+const audio = mediaOf("audio");
+const voice = mediaOf("voice");
+const sticker = mediaOf("sticker");
+const document = mediaOf("document");
+const anyVideo = mediaOf("video");
+const location = mediaOf("location");
+const liveLocation = mediaOf("live_location");
+const game = mediaOf("game");
+const webpage = mediaOf("webpage");
+const venue = mediaOf("venue");
+const poll = mediaOf("poll");
+const invoice = mediaOf("invoice");
+const story = mediaOf("story");
+const anyLocation = (msg) => msg.media instanceof core.RawLocation;
+const anyDocument = (msg) => msg.media instanceof core.RawDocument;
+const video = (msg) => msg.media?.type === "video" && !msg.media.isAnimation && !msg.media.isRound;
+const animation = (msg) => msg.media?.type === "video" && msg.media.isAnimation && !msg.media.isRound;
+const roundMessage = (msg) => msg.media?.type === "video" && !msg.media.isAnimation && msg.media.isRound;
+function stickerByType(type) {
+  return (msg) => msg.media?.type === "sticker" && msg.media.stickerType === type;
+}
+function stickerBySourceType(type) {
+  return (msg) => msg.media?.type === "sticker" && msg.media.sourceType === type;
+}
+const text = (msg) => msg.media === null && !msg.isService;
+const service = (msg) => msg.isService;
+function 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;
+}
+function sender(type) {
+  return (msg) => msg.sender.type === type;
+}
+function replyTo(filter) {
+  return async (msg, state) => {
+    if (!msg.replyToMessage?.id) return false;
+    const reply2 = msg._name === "new_message" ? await msg.getReplyTo() : msg.replyTo;
+    if (!reply2) return false;
+    if (msg._name === "new_message") {
+      msg.getReplyTo = () => Promise.resolve(reply2);
+    }
+    if (!filter) return true;
+    return filter(reply2, state);
+  };
+}
+function withCompleteSender(filter) {
+  return async (msg, state) => {
+    try {
+      await msg.getCompleteSender();
+    } catch {
+      return false;
+    }
+    if (!filter) return true;
+    return filter(msg, state);
+  };
+}
+function withCompleteChat(filter) {
+  return async (msg, state) => {
+    try {
+      await msg.getCompleteChat();
+    } catch {
+      return false;
+    }
+    if (!filter) return true;
+    return filter(msg, state);
+  };
+}
+exports.action = action;
+exports.animation = animation;
+exports.anyDocument = anyDocument;
+exports.anyLocation = anyLocation;
+exports.anyVideo = anyVideo;
+exports.audio = audio;
+exports.contact = contact;
+exports.dice = dice;
+exports.document = document;
+exports.game = game;
+exports.incoming = incoming;
+exports.invoice = invoice;
+exports.liveLocation = liveLocation;
+exports.location = location;
+exports.media = media;
+exports.mediaOf = mediaOf;
+exports.outgoing = outgoing;
+exports.photo = photo;
+exports.poll = poll;
+exports.reply = reply;
+exports.replyOrigin = replyOrigin;
+exports.replyTo = replyTo;
+exports.roundMessage = roundMessage;
+exports.scheduled = scheduled;
+exports.sender = sender;
+exports.service = service;
+exports.sticker = sticker;
+exports.stickerBySourceType = stickerBySourceType;
+exports.stickerByType = stickerByType;
+exports.story = story;
+exports.text = text;
+exports.venue = venue;
+exports.video = video;
+exports.voice = voice;
+exports.webpage = webpage;
+exports.withCompleteChat = withCompleteChat;
+exports.withCompleteSender = withCompleteSender;

package/filters/message.d.cts

@@ -0,0 +1,223 @@
+import { _RepliedMessageAssertionsByOrigin, Audio, Contact, Dice, Document, Game, Invoice, LiveLocation, Location, MaybeArray, Message, MessageAction, MessageMediaType, Peer, Photo, Poll, RepliedMessageInfo, RepliedMessageOrigin, Sticker, StickerSourceType, StickerType, Story, User, Venue, Video, Voice, WebPage, RawDocument } from '@mtcute/core';
+import { BusinessMessageContext } from '../context/business-message.js';
+import { MessageContext } from '../index.js';
+import { Modify, UpdateFilter } from './types.js';
+/**
+ * Filter incoming messages.
+ *
+ * Messages sent to yourself (i.e. Saved Messages) are also "incoming"
+ */
+export declare const incoming: UpdateFilter<Message, {
+    isOutgoing: false;
+}>;
+/**
+ * Filter outgoing messages.
+ *
+ * Messages sent to yourself (i.e. Saved Messages) are **not** "outgoing"
+ */
+export declare const outgoing: UpdateFilter<Message, {
+    isOutgoing: true;
+}>;
+/**
+ * Filter for scheduled messages
+ */
+export declare const scheduled: UpdateFilter<Message, {
+    isScheduled: true;
+}>;
+/**
+ * Filter messages that are replies to some other message
+ */
+export declare const reply: UpdateFilter<Message, {
+    replyToMessage: RepliedMessageInfo;
+}>;
+/**
+ * Filter messages that are replies with the given origin type
+ */
+export declare function replyOrigin<T extends RepliedMessageOrigin>(origin: T): UpdateFilter<Message, {
+    replyToMessage: Modify<RepliedMessageInfo, _RepliedMessageAssertionsByOrigin[T] & {
+        origin: T;
+    }>;
+}>;
+/**
+ * Filter messages containing some media
+ */
+export declare const media: UpdateFilter<Message, {
+    media: Exclude<Message['media'], null>;
+}>;
+/**
+ * Filter messages containing media of given type
+ */
+export declare function mediaOf<T extends MessageMediaType>(type: T): UpdateFilter<Message, {
+    media: Extract<Message['media'], {
+        type: T;
+    }>;
+}>;
+/** Filter messages containing a photo */
+export declare const photo: UpdateFilter<Message, {
+    media: Photo;
+}>;
+/** Filter messages containing a dice */
+export declare const dice: UpdateFilter<Message, {
+    media: Dice;
+}>;
+/** Filter messages containing a contact */
+export declare const contact: UpdateFilter<Message, {
+    media: Contact;
+}>;
+/** Filter messages containing an audio file */
+export declare const audio: UpdateFilter<Message, {
+    media: Audio;
+}>;
+/** Filter messages containing a voice message (audio-only) */
+export declare const voice: UpdateFilter<Message, {
+    media: Voice;
+}>;
+/** Filter messages containing a sticker */
+export declare const sticker: UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/** Filter messages containing a document (a file) */
+export declare const document: UpdateFilter<Message, {
+    media: Document;
+}>;
+/** Filter messages containing any video (videos, round messages and animations) */
+export declare const anyVideo: UpdateFilter<Message, {
+    media: Video;
+}>;
+/** Filter messages containing a static location */
+export declare const location: UpdateFilter<Message, {
+    media: Location;
+}>;
+/** Filter messages containing a live location */
+export declare const liveLocation: UpdateFilter<Message, {
+    media: LiveLocation;
+}>;
+/** Filter messages containing a game */
+export declare const game: UpdateFilter<Message, {
+    media: Game;
+}>;
+/** Filter messages containing a web page */
+export declare const webpage: UpdateFilter<Message, {
+    media: WebPage;
+}>;
+/** Filter messages containing a venue */
+export declare const venue: UpdateFilter<Message, {
+    media: Venue;
+}>;
+/** Filter messages containing a poll */
+export declare const poll: UpdateFilter<Message, {
+    media: Poll;
+}>;
+/** Filter messages containing an invoice */
+export declare const invoice: UpdateFilter<Message, {
+    media: Invoice;
+}>;
+/** Filter messages containing a story */
+export declare const story: UpdateFilter<Message, {
+    media: Story;
+}>;
+/**
+ * Filter messages containing any location (live or static).
+ */
+export declare const anyLocation: UpdateFilter<Message, {
+    media: Location;
+}>;
+/**
+ * Filter messages containing a document
+ *
+ * This will also match media like audio, video, voice
+ * that also use Documents
+ */
+export declare const anyDocument: UpdateFilter<Message, {
+    media: RawDocument;
+}>;
+/**
+ * Filter messages containing a simple video.
+ *
+ * This does not include round messages and animations
+ */
+export declare const video: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: false;
+        isAnimation: false;
+    }>;
+}>;
+/**
+ * Filter messages containing an animation.
+ *
+ * > **Note**: Legacy GIFs (i.e. documents with `image/gif` MIME)
+ * > are also considered animations.
+ */
+export declare const animation: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: false;
+        isAnimation: true;
+    }>;
+}>;
+/**
+ * Filter messages containing a round message (aka video note).
+ */
+export declare const roundMessage: UpdateFilter<Message, {
+    media: Modify<Video, {
+        isRound: true;
+        isAnimation: false;
+    }>;
+}>;
+/**
+ * Filter messages containing a sticker by its type
+ */
+export declare function stickerByType(type: StickerType): UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/**
+ * Filter messages containing a sticker by its source file type
+ */
+export declare function stickerBySourceType(type: StickerSourceType): UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/**
+ * Filter text-only messages non-service messages
+ */
+export declare const text: UpdateFilter<Message, {
+    media: null;
+    isService: false;
+}>;
+/**
+ * Filter service messages
+ */
+export declare const service: UpdateFilter<Message, {
+    isService: true;
+}>;
+/**
+ * Filter service messages by action type
+ */
+export declare function action<T extends Exclude<MessageAction, null>['type']>(type: MaybeArray<T>): UpdateFilter<Message, {
+    action: Extract<MessageAction, {
+        type: T;
+    }>;
+    sender: T extends 'user_joined_link' | 'user_removed' | 'history_cleared' | 'contact_joined' | 'bot_allowed' ? User : Peer;
+}>;
+export declare function sender<T extends Message['sender']['type']>(type: T): UpdateFilter<Message, {
+    sender: Extract<Message['sender'], {
+        type: T;
+    }>;
+}>;
+/**
+ * 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 declare function replyTo<Mod, State extends object>(filter?: UpdateFilter<Message, Mod, State>): UpdateFilter<MessageContext | BusinessMessageContext, {
+    getReplyTo: () => Promise<Message & Mod>;
+}, 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 declare function withCompleteSender<Mod, State extends object>(filter?: UpdateFilter<MessageContext, Mod, State>): UpdateFilter<MessageContext, Mod, State>;
+/**
+ * Middleware-like filter that will fetch the chat of the message
+ * and make it available to further filters, as well as the handler itself.
+ */
+export declare function withCompleteChat<Mod, State extends object>(filter?: UpdateFilter<MessageContext, Mod, State>): UpdateFilter<MessageContext, Mod, State>;

package/filters/message.d.ts

@@ -1,4 +1,4 @@
-import { Audio, Contact, Dice, Document, Game, Invoice, LiveLocation, Location, MaybeArray, Message, MessageAction, MessageMediaType, Peer, Photo, Poll, RepliedMessageInfo, RepliedMessageOrigin, Sticker, StickerSourceType, StickerType, User, Venue, Video, Voice, WebPage, _RepliedMessageAssertionsByOrigin, RawDocument } from '@mtcute/core';
+import { _RepliedMessageAssertionsByOrigin, Audio, Contact, Dice, Document, Game, Invoice, LiveLocation, Location, MaybeArray, Message, MessageAction, MessageMediaType, Peer, Photo, Poll, RepliedMessageInfo, RepliedMessageOrigin, Sticker, StickerSourceType, StickerType, Story, User, Venue, Video, Voice, WebPage, RawDocument } from '@mtcute/core';
 import { BusinessMessageContext } from '../context/business-message.js';
 import { MessageContext } from '../index.js';
 import { Modify, UpdateFilter } from './types.js';
@@ -112,6 +112,10 @@ export declare const poll: UpdateFilter<Message, {
 export declare const invoice: UpdateFilter<Message, {
     media: Invoice;
 }>;
+/** Filter messages containing a story */
+export declare const story: UpdateFilter<Message, {
+    media: Story;
+}>;
 /**
  * Filter messages containing any location (live or static).
  */

package/filters/message.js

@@ -0,0 +1,125 @@
+import { RawLocation, RawDocument } from "@mtcute/core";
+const incoming = (msg) => !msg.isOutgoing;
+const outgoing = (msg) => msg.isOutgoing;
+const scheduled = (msg) => msg.isScheduled;
+const reply = (msg) => msg.replyToMessage !== null;
+function replyOrigin(origin) {
+  return (msg) => msg.replyToMessage?.originIs(origin) ?? false;
+}
+const media = (msg) => msg.media !== null;
+function mediaOf(type) {
+  return (msg) => msg.media?.type === type;
+}
+const photo = mediaOf("photo");
+const dice = mediaOf("dice");
+const contact = mediaOf("contact");
+const audio = mediaOf("audio");
+const voice = mediaOf("voice");
+const sticker = mediaOf("sticker");
+const document = mediaOf("document");
+const anyVideo = mediaOf("video");
+const location = mediaOf("location");
+const liveLocation = mediaOf("live_location");
+const game = mediaOf("game");
+const webpage = mediaOf("webpage");
+const venue = mediaOf("venue");
+const poll = mediaOf("poll");
+const invoice = mediaOf("invoice");
+const story = mediaOf("story");
+const anyLocation = (msg) => msg.media instanceof RawLocation;
+const anyDocument = (msg) => msg.media instanceof RawDocument;
+const video = (msg) => msg.media?.type === "video" && !msg.media.isAnimation && !msg.media.isRound;
+const animation = (msg) => msg.media?.type === "video" && msg.media.isAnimation && !msg.media.isRound;
+const roundMessage = (msg) => msg.media?.type === "video" && !msg.media.isAnimation && msg.media.isRound;
+function stickerByType(type) {
+  return (msg) => msg.media?.type === "sticker" && msg.media.stickerType === type;
+}
+function stickerBySourceType(type) {
+  return (msg) => msg.media?.type === "sticker" && msg.media.sourceType === type;
+}
+const text = (msg) => msg.media === null && !msg.isService;
+const service = (msg) => msg.isService;
+function 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;
+}
+function sender(type) {
+  return (msg) => msg.sender.type === type;
+}
+function replyTo(filter) {
+  return async (msg, state) => {
+    if (!msg.replyToMessage?.id) return false;
+    const reply2 = msg._name === "new_message" ? await msg.getReplyTo() : msg.replyTo;
+    if (!reply2) return false;
+    if (msg._name === "new_message") {
+      msg.getReplyTo = () => Promise.resolve(reply2);
+    }
+    if (!filter) return true;
+    return filter(reply2, state);
+  };
+}
+function withCompleteSender(filter) {
+  return async (msg, state) => {
+    try {
+      await msg.getCompleteSender();
+    } catch {
+      return false;
+    }
+    if (!filter) return true;
+    return filter(msg, state);
+  };
+}
+function withCompleteChat(filter) {
+  return async (msg, state) => {
+    try {
+      await msg.getCompleteChat();
+    } catch {
+      return false;
+    }
+    if (!filter) return true;
+    return filter(msg, state);
+  };
+}
+export {
+  action,
+  animation,
+  anyDocument,
+  anyLocation,
+  anyVideo,
+  audio,
+  contact,
+  dice,
+  document,
+  game,
+  incoming,
+  invoice,
+  liveLocation,
+  location,
+  media,
+  mediaOf,
+  outgoing,
+  photo,
+  poll,
+  reply,
+  replyOrigin,
+  replyTo,
+  roundMessage,
+  scheduled,
+  sender,
+  service,
+  sticker,
+  stickerBySourceType,
+  stickerByType,
+  story,
+  text,
+  venue,
+  video,
+  voice,
+  webpage,
+  withCompleteChat,
+  withCompleteSender
+};