@mtcute/dispatcher 0.1.2 → 0.2.0

package/esm/filters/index.d.ts

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

package/esm/filters/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/filters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAgB,CAAA","sourcesContent":["import * as filters from './bundle.js'\nimport UpdateFilter = filters.UpdateFilter\nexport { filters, UpdateFilter }\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/filters/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,aAAa,CAAA;AAEtC,OAAO,EAAE,OAAO,EAAE,CAAA","sourcesContent":["import * as filters from './bundle.js'\nimport UpdateFilter = filters.UpdateFilter\nexport { filters }\nexport type { UpdateFilter }\n"]}

package/esm/filters/logic.test.d.ts

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

package/esm/filters/logic.test.js

@@ -0,0 +1,167 @@
+import { describe, expect, it, vi } from 'vitest';
+import { and, not, or } from './logic.js';
+describe('filters.not', () => {
+    it('should negate a given sync filter', () => {
+        const filter = vi.fn().mockReturnValue(true);
+        const negated = not(filter);
+        expect(negated(1)).toBe(false);
+        expect(filter).toHaveBeenCalledTimes(1);
+        expect(filter).toHaveBeenCalledWith(1, undefined);
+    });
+    it('should negate a given async filter', async () => {
+        const filter = vi.fn().mockResolvedValue(true);
+        const negated = not(filter);
+        await expect(negated(1)).resolves.toBe(false);
+        expect(filter).toHaveBeenCalledTimes(1);
+        expect(filter).toHaveBeenCalledWith(1, undefined);
+    });
+});
+describe('filters.and', () => {
+    it.each([
+        ['sync', 'sync'],
+        ['sync', 'async'],
+        ['async', 'sync'],
+        ['async', 'async'],
+    ])('should combine %s and %s filters', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const combined = and(a, b);
+        expect(await combined(1)).toBe(true);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+    });
+    it.each([
+        ['sync', 'sync'],
+        ['sync', 'async'],
+        ['async', 'sync'],
+        ['async', 'async'],
+    ])('should not continue execution after false (%s and %s filters)', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const combined = and(a, b);
+        expect(await combined(1)).toBe(false);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).not.toHaveBeenCalled();
+    });
+    it.each([
+        ['sync', 'sync', 'sync'],
+        ['sync', 'sync', 'async'],
+        ['sync', 'async', 'sync'],
+        ['sync', 'async', 'async'],
+        ['async', 'sync', 'sync'],
+        ['async', 'sync', 'async'],
+        ['async', 'async', 'sync'],
+        ['async', 'async', 'async'],
+    ])('should combine %s, %s and %s filters', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const c = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const combined = and(a, b, c);
+        expect(await combined(1)).toBe(true);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+        expect(c).toHaveBeenCalledTimes(1);
+        expect(c).toHaveBeenCalledWith(1, undefined);
+    });
+    it.each([
+        ['sync', 'sync', 'sync'],
+        ['sync', 'sync', 'async'],
+        ['sync', 'async', 'sync'],
+        ['sync', 'async', 'async'],
+        ['async', 'sync', 'sync'],
+        ['async', 'sync', 'async'],
+        ['async', 'async', 'sync'],
+        ['async', 'async', 'async'],
+    ])('should not continue execution after false (%s, %s and %s filters)', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false));
+        const c = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const combined = and(a, b, c);
+        expect(await combined(1)).toBe(false);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+        expect(c).not.toHaveBeenCalled();
+    });
+});
+describe('filters.or', () => {
+    it.each([
+        ['sync', 'sync'],
+        ['sync', 'async'],
+        ['async', 'sync'],
+        ['async', 'async'],
+    ])('should combine %s and %s filters', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false));
+        const combined = or(a, b);
+        expect(await combined(1)).toBe(false);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+    });
+    it.each([
+        ['sync', 'sync'],
+        ['sync', 'async'],
+        ['async', 'sync'],
+        ['async', 'async'],
+    ])('should not continue execution after true (%s and %s filters)', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const b = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false));
+        const combined = or(a, b);
+        expect(await combined(1)).toBe(true);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).not.toHaveBeenCalled();
+    });
+    it.each([
+        ['sync', 'sync', 'sync'],
+        ['sync', 'sync', 'async'],
+        ['sync', 'async', 'sync'],
+        ['sync', 'async', 'async'],
+        ['async', 'sync', 'sync'],
+        ['async', 'sync', 'async'],
+        ['async', 'async', 'sync'],
+        ['async', 'async', 'async'],
+    ])('should combine %s, %s and %s filters', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false));
+        const c = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false));
+        const combined = or(a, b, c);
+        expect(await combined(1)).toBe(false);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+        expect(c).toHaveBeenCalledTimes(1);
+        expect(c).toHaveBeenCalledWith(1, undefined);
+    });
+    it.each([
+        ['sync', 'sync', 'sync'],
+        ['sync', 'sync', 'async'],
+        ['sync', 'async', 'sync'],
+        ['sync', 'async', 'async'],
+        ['async', 'sync', 'sync'],
+        ['async', 'sync', 'async'],
+        ['async', 'async', 'sync'],
+        ['async', 'async', 'async'],
+    ])('should not continue execution after true (%s, %s and %s filters)', async (aType, bType) => {
+        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false));
+        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true));
+        const c = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false));
+        const combined = or(a, b, c);
+        expect(await combined(1)).toBe(true);
+        expect(a).toHaveBeenCalledTimes(1);
+        expect(a).toHaveBeenCalledWith(1, undefined);
+        expect(b).toHaveBeenCalledTimes(1);
+        expect(b).toHaveBeenCalledWith(1, undefined);
+        expect(c).not.toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=logic.test.js.map

package/esm/filters/logic.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.test.js","sourceRoot":"","sources":["../../../src/filters/logic.test.ts"],"names":[],"mappings":"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","sourcesContent":["import { describe, expect, it, vi } from 'vitest'\n\nimport { and, not, or } from './logic.js'\n\ndescribe('filters.not', () => {\n    it('should negate a given sync filter', () => {\n        const filter = vi.fn().mockReturnValue(true)\n        const negated = not(filter)\n\n        expect(negated(1)).toBe(false)\n        expect(filter).toHaveBeenCalledTimes(1)\n        expect(filter).toHaveBeenCalledWith(1, undefined)\n    })\n\n    it('should negate a given async filter', async () => {\n        const filter = vi.fn().mockResolvedValue(true)\n        const negated = not(filter)\n\n        await expect(negated(1)).resolves.toBe(false)\n        expect(filter).toHaveBeenCalledTimes(1)\n        expect(filter).toHaveBeenCalledWith(1, undefined)\n    })\n})\n\ndescribe('filters.and', () => {\n    it.each([\n        ['sync', 'sync'],\n        ['sync', 'async'],\n        ['async', 'sync'],\n        ['async', 'async'],\n    ])('should combine %s and %s filters', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n\n        const combined = and(a, b)\n\n        expect(await combined(1)).toBe(true)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n    })\n\n    it.each([\n        ['sync', 'sync'],\n        ['sync', 'async'],\n        ['async', 'sync'],\n        ['async', 'async'],\n    ])('should not continue execution after false (%s and %s filters)', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n\n        const combined = and(a, b)\n\n        expect(await combined(1)).toBe(false)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).not.toHaveBeenCalled()\n    })\n\n    it.each([\n        ['sync', 'sync', 'sync'],\n        ['sync', 'sync', 'async'],\n        ['sync', 'async', 'sync'],\n        ['sync', 'async', 'async'],\n        ['async', 'sync', 'sync'],\n        ['async', 'sync', 'async'],\n        ['async', 'async', 'sync'],\n        ['async', 'async', 'async'],\n    ])('should combine %s, %s and %s filters', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n        const c = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n\n        const combined = and(a, b, c)\n\n        expect(await combined(1)).toBe(true)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n        expect(c).toHaveBeenCalledTimes(1)\n        expect(c).toHaveBeenCalledWith(1, undefined)\n    })\n\n    it.each([\n        ['sync', 'sync', 'sync'],\n        ['sync', 'sync', 'async'],\n        ['sync', 'async', 'sync'],\n        ['sync', 'async', 'async'],\n        ['async', 'sync', 'sync'],\n        ['async', 'sync', 'async'],\n        ['async', 'async', 'sync'],\n        ['async', 'async', 'async'],\n    ])('should not continue execution after false (%s, %s and %s filters)', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? true : Promise.resolve(true))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false))\n        const c = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n\n        const combined = and(a, b, c)\n\n        expect(await combined(1)).toBe(false)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n        expect(c).not.toHaveBeenCalled()\n    })\n})\n\ndescribe('filters.or', () => {\n    it.each([\n        ['sync', 'sync'],\n        ['sync', 'async'],\n        ['async', 'sync'],\n        ['async', 'async'],\n    ])('should combine %s and %s filters', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false))\n\n        const combined = or(a, b)\n\n        expect(await combined(1)).toBe(false)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n    })\n\n    it.each([\n        ['sync', 'sync'],\n        ['sync', 'async'],\n        ['async', 'sync'],\n        ['async', 'async'],\n    ])('should not continue execution after true (%s and %s filters)', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n        const b = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false))\n\n        const combined = or(a, b)\n\n        expect(await combined(1)).toBe(true)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).not.toHaveBeenCalled()\n    })\n\n    it.each([\n        ['sync', 'sync', 'sync'],\n        ['sync', 'sync', 'async'],\n        ['sync', 'async', 'sync'],\n        ['sync', 'async', 'async'],\n        ['async', 'sync', 'sync'],\n        ['async', 'sync', 'async'],\n        ['async', 'async', 'sync'],\n        ['async', 'async', 'async'],\n    ])('should combine %s, %s and %s filters', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false))\n        const c = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false))\n\n        const combined = or(a, b, c)\n\n        expect(await combined(1)).toBe(false)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n        expect(c).toHaveBeenCalledTimes(1)\n        expect(c).toHaveBeenCalledWith(1, undefined)\n    })\n\n    it.each([\n        ['sync', 'sync', 'sync'],\n        ['sync', 'sync', 'async'],\n        ['sync', 'async', 'sync'],\n        ['sync', 'async', 'async'],\n        ['async', 'sync', 'sync'],\n        ['async', 'sync', 'async'],\n        ['async', 'async', 'sync'],\n        ['async', 'async', 'async'],\n    ])('should not continue execution after true (%s, %s and %s filters)', async (aType, bType) => {\n        const a = vi.fn().mockReturnValue(aType === 'sync' ? false : Promise.resolve(false))\n        const b = vi.fn().mockReturnValue(bType === 'sync' ? true : Promise.resolve(true))\n        const c = vi.fn().mockReturnValue(bType === 'sync' ? false : Promise.resolve(false))\n\n        const combined = or(a, b, c)\n\n        expect(await combined(1)).toBe(true)\n        expect(a).toHaveBeenCalledTimes(1)\n        expect(a).toHaveBeenCalledWith(1, undefined)\n        expect(b).toHaveBeenCalledTimes(1)\n        expect(b).toHaveBeenCalledWith(1, undefined)\n        expect(c).not.toHaveBeenCalled()\n    })\n})\n"]}

package/esm/filters/message.d.ts

@@ -1,4 +1,4 @@
-import { Chat, MaybeArray, Message, MessageAction, MessageReplyInfo, RawDocument, Sticker, StickerSourceType, StickerType, User, Video } from '@mtcute/client';
+import { _RepliedMessageAssertionsByOrigin, MaybeArray, Message, MessageAction, Peer, RawDocument, RepliedMessageInfo, RepliedMessageOrigin, Sticker, StickerSourceType, StickerType, User, Video } from '@mtcute/client';
 import { MessageContext } from '../index.js';
 import { Modify, UpdateFilter } from './types.js';
 /**
@@ -21,7 +21,15 @@ export declare const outgoing: UpdateFilter<Message, {
  * Filter messages that are replies to some other message
  */
 export declare const reply: UpdateFilter<Message, {
-    replyToMessage: MessageReplyInfo;
+    replyToMessage: RepliedMessageInfo;
+}>;
+/**
+ * Filter messages that are replies with the given origin type
+ */
+export declare const replyOrigin: <T extends RepliedMessageOrigin>(origin: T) => UpdateFilter<Message, {
+    replyToMessage: Modify<RepliedMessageInfo, _RepliedMessageAssertionsByOrigin[T] & {
+        origin: T;
+    }>;
 }>;
 /**
  * Filter messages containing some media
@@ -32,7 +40,7 @@ export declare const media: UpdateFilter<Message, {
 /**
  * Filter messages containing media of given type
  */
-export declare const mediaOf: <T extends "photo" | "location" | "poll" | "contact" | "game" | "sticker" | "dice" | "audio" | "voice" | "document" | "video" | "live_location" | "web_page" | "venue" | "invoice">(type: T) => UpdateFilter<Message, {
+export declare const mediaOf: <T extends "photo" | "location" | "poll" | "story" | "contact" | "game" | "sticker" | "dice" | "audio" | "voice" | "document" | "video" | "live_location" | "webpage" | "venue" | "invoice">(type: T) => UpdateFilter<Message, {
     media: Extract<import("@mtcute/client").Photo, {
         type: T;
     }> | Extract<import("@mtcute/client").Dice, {
@@ -63,6 +71,8 @@ export declare const mediaOf: <T extends "photo" | "location" | "poll" | "contac
         type: T;
     }> | Extract<import("@mtcute/client").Invoice, {
         type: T;
+    }> | Extract<import("@mtcute/client").MediaStory, {
+        type: T;
     }>;
 }>;
 /** Filter messages containing a photo */
@@ -276,20 +286,26 @@ export declare const action: <T extends "chat_created" | "channel_created" | "ch
     }> | Extract<import("@mtcute/client").ActionWallpaperChanged, {
         type: T;
     }>;
-    sender: T extends "history_cleared" | "contact_joined" | "user_removed" | "user_joined_link" | "bot_allowed" ? User : User | Chat;
+    sender: T extends "history_cleared" | "contact_joined" | "user_removed" | "user_joined_link" | "bot_allowed" ? User : Peer;
 }>;
 export declare const sender: <T extends "user" | "chat">(type: T) => UpdateFilter<Message, {
     sender: Extract<User, {
         type: T;
-    }> | Extract<Chat, {
+    }> | Extract<import("@mtcute/client").Chat, {
         type: T;
     }>;
 }>;
 /**
- * Filter that matches messages that are replies to some other message.
+ * 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 const replyTo: <Mod, State extends object>(filter?: UpdateFilter<Message, Mod, State> | undefined) => UpdateFilter<MessageContext, {
     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 const withCompleteSender: <Mod, State extends object>(filter?: UpdateFilter<MessageContext, Mod, State> | undefined) => UpdateFilter<MessageContext, Mod, State>;

package/esm/filters/message.js

@@ -17,6 +17,10 @@ export const outgoing = (msg) => msg.isOutgoing;
  * 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
  */
@@ -48,7 +52,7 @@ 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('web_page');
+export const webpage = mediaOf('webpage');
 /** Filter messages containing a venue */
 export const venue = mediaOf('venue');
 /** Filter messages containing a poll */
@@ -112,7 +116,8 @@ export const action = (type) => {
 };
 export const sender = (type) => (msg) => msg.sender.type === type;
 /**
- * Filter that matches messages that are replies to some other message.
+ * 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.
  */
@@ -127,4 +132,19 @@ export const replyTo = (filter) => async (msg, state) => {
         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 +1 @@
-{"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    Chat,\n    MaybeArray,\n    Message,\n    MessageAction,\n    MessageMediaType,\n    MessageReplyInfo,\n    RawDocument,\n    RawLocation,\n    Sticker,\n    StickerSourceType,\n    StickerType,\n    User,\n    Video,\n} from '@mtcute/client'\n\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 messages that are replies to some other message\n */\nexport const reply: UpdateFilter<Message, { replyToMessage: MessageReplyInfo }> = (msg) => msg.replyToMessage !== null\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('web_page')\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            : User | Chat\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.\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, { getReplyTo: () => Promise<Message & Mod> }, State> =>\n        async (msg, state) => {\n            if (!msg.replyToMessage?.id) return false\n\n            const reply = await msg.getReplyTo()\n            if (!reply) return false\n\n            msg.getReplyTo = () => Promise.resolve(reply)\n\n            if (!filter) return true\n\n            return filter(reply, state)\n        }\n"]}
+{"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/client'\n\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 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, { getReplyTo: () => Promise<Message & Mod> }, State> =>\n        async (msg, state) => {\n            if (!msg.replyToMessage?.id) return false\n\n            const reply = await msg.getReplyTo()\n            if (!reply) return false\n\n            msg.getReplyTo = () => Promise.resolve(reply)\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/state/key.d.ts

@@ -1,4 +1,4 @@
-import { Chat, MaybeAsync, User } from '@mtcute/client';
+import { MaybeAsync, Peer } from '@mtcute/client';
 import { CallbackQueryContext, MessageContext } from '../context/index.js';
 /**
  * Function that determines how the state key is derived.
@@ -8,7 +8,7 @@ import { CallbackQueryContext, MessageContext } from '../context/index.js';
  * @param msg  Message or callback from which to derive the key
  * @param scene  Current scene UID, or `null` if none
  */
-export type StateKeyDelegate = (upd: MessageContext | CallbackQueryContext | User | Chat) => MaybeAsync<string | null>;
+export type StateKeyDelegate = (upd: MessageContext | CallbackQueryContext | Peer) => MaybeAsync<string | null>;
 /**
  * Default state key delegate.
  *

package/esm/state/key.js.map

@@ -1 +1 @@
-{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/state/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAA0B,MAAM,gBAAgB,CAAA;AAcpE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqB,CAAC,GAAG,EAAiB,EAAE;IAC5E,IAAI,MAAM,IAAI,GAAG,EAAE;QACf,cAAc;QACd,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;KACxB;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE;QAC7B,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,KAAK,SAAS,CAAC;YACf,KAAK,KAAK,CAAC;YACX,KAAK,SAAS;gBACV,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9B,KAAK,OAAO,CAAC;YACb,KAAK,YAAY,CAAC;YAClB,KAAK,WAAW;gBACZ,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAA;YAC5C;gBACI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;SACrC;KACJ;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,gBAAgB,EAAE;QAChC,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC7B,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QAEpD,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;KACxC;IAED,OAAO,IAAI,CAAA;AACf,CAAC,CAAA","sourcesContent":["import { assertNever, Chat, MaybeAsync, User } from '@mtcute/client'\n\nimport { CallbackQueryContext, MessageContext } from '../context/index.js'\n\n/**\n * Function that determines how the state key is derived.\n *\n * The key is additionally prefixed with current scene, if any.\n *\n * @param msg  Message or callback from which to derive the key\n * @param scene  Current scene UID, or `null` if none\n */\nexport type StateKeyDelegate = (upd: MessageContext | CallbackQueryContext | User | Chat) => MaybeAsync<string | null>\n\n/**\n * Default state key delegate.\n *\n * Derives key as follows:\n *  - If private chat, `msg.chat.id`\n *  - If group chat, `msg.chat.id + '_' + msg.sender.id`\n *  - If channel, `msg.chat.id`\n *  - If non-inline callback query:\n *    - If in private chat (i.e. `upd.chatType === 'user'`), `upd.user.id`\n *    - If in group/channel/supergroup (i.e. `upd.chatType !== 'user'`), `upd.chatId + '_' + upd.user.id`\n */\nexport const defaultStateKeyDelegate: StateKeyDelegate = (upd): string | null => {\n    if ('type' in upd) {\n        // User | Chat\n        return String(upd.id)\n    }\n\n    if (upd._name === 'new_message') {\n        switch (upd.chat.chatType) {\n            case 'private':\n            case 'bot':\n            case 'channel':\n                return String(upd.chat.id)\n            case 'group':\n            case 'supergroup':\n            case 'gigagroup':\n                return `${upd.chat.id}_${upd.sender.id}`\n            default:\n                assertNever(upd.chat.chatType)\n        }\n    }\n\n    if (upd._name === 'callback_query') {\n        if (upd.isInline) return null\n        if (upd.chatType === 'user') return `${upd.user.id}`\n\n        return `${upd.chatId}_${upd.user.id}`\n    }\n\n    return null\n}\n"]}
+{"version":3,"file":"key.js","sourceRoot":"","sources":["../../../src/state/key.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAoB,MAAM,gBAAgB,CAAA;AAc9D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAqB,CAAC,GAAG,EAAiB,EAAE;IAC5E,IAAI,MAAM,IAAI,GAAG,EAAE;QACf,cAAc;QACd,OAAO,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;KACxB;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,aAAa,EAAE;QAC7B,QAAQ,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE;YACvB,KAAK,SAAS,CAAC;YACf,KAAK,KAAK,CAAC;YACX,KAAK,SAAS;gBACV,OAAO,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YAC9B,KAAK,OAAO,CAAC;YACb,KAAK,YAAY,CAAC;YAClB,KAAK,WAAW;gBACZ,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,MAAM,CAAC,EAAE,EAAE,CAAA;YAC5C;gBACI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;SACrC;KACJ;IAED,IAAI,GAAG,CAAC,KAAK,KAAK,gBAAgB,EAAE;QAChC,IAAI,GAAG,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAA;QAC7B,IAAI,GAAG,CAAC,QAAQ,KAAK,MAAM;YAAE,OAAO,GAAG,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QAEpD,OAAO,GAAG,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;KACxC;IAED,OAAO,IAAI,CAAA;AACf,CAAC,CAAA","sourcesContent":["import { assertNever, MaybeAsync, Peer } from '@mtcute/client'\n\nimport { CallbackQueryContext, MessageContext } from '../context/index.js'\n\n/**\n * Function that determines how the state key is derived.\n *\n * The key is additionally prefixed with current scene, if any.\n *\n * @param msg  Message or callback from which to derive the key\n * @param scene  Current scene UID, or `null` if none\n */\nexport type StateKeyDelegate = (upd: MessageContext | CallbackQueryContext | Peer) => MaybeAsync<string | null>\n\n/**\n * Default state key delegate.\n *\n * Derives key as follows:\n *  - If private chat, `msg.chat.id`\n *  - If group chat, `msg.chat.id + '_' + msg.sender.id`\n *  - If channel, `msg.chat.id`\n *  - If non-inline callback query:\n *    - If in private chat (i.e. `upd.chatType === 'user'`), `upd.user.id`\n *    - If in group/channel/supergroup (i.e. `upd.chatType !== 'user'`), `upd.chatId + '_' + upd.user.id`\n */\nexport const defaultStateKeyDelegate: StateKeyDelegate = (upd): string | null => {\n    if ('type' in upd) {\n        // User | Chat\n        return String(upd.id)\n    }\n\n    if (upd._name === 'new_message') {\n        switch (upd.chat.chatType) {\n            case 'private':\n            case 'bot':\n            case 'channel':\n                return String(upd.chat.id)\n            case 'group':\n            case 'supergroup':\n            case 'gigagroup':\n                return `${upd.chat.id}_${upd.sender.id}`\n            default:\n                assertNever(upd.chat.chatType)\n        }\n    }\n\n    if (upd._name === 'callback_query') {\n        if (upd.isInline) return null\n        if (upd.chatType === 'user') return `${upd.user.id}`\n\n        return `${upd.chatId}_${upd.user.id}`\n    }\n\n    return null\n}\n"]}

package/esm/state/storage.d.ts

@@ -12,6 +12,27 @@ import { MaybeAsync } from '@mtcute/client';
  * Alternatively, you can store them as simple strings
  */
 export interface IStateStorage {
+    /**
+     * Load state from some external storage.
+     * Should be used either to load session content from file/network/etc
+     * to memory, or to open required connections to fetch session content later
+     *
+     * This method may be called multiple times and should handle that.
+     */
+    load?(): MaybeAsync<void>;
+    /**
+     * Save state to some external storage.
+     * Should be used to commit pending changes in the session.
+     * For example, saving session content to file/network/etc,
+     * or committing a database transaction
+     */
+    save?(): MaybeAsync<void>;
+    /**
+     * Cleanup storage and release all used resources.
+     *
+     * This method may be called multiple times and should handle that.
+     */
+    destroy?(): MaybeAsync<void>;
     /**
      * Retrieve state from the storage
      *

package/esm/state/storage.js.map

@@ -1 +1 @@
-{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/state/storage.ts"],"names":[],"mappings":"AAsFA,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAChD,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,UAAU,IAAI,OAAO;QACrB,UAAU,IAAI,OAAO;QACrB,aAAa,IAAI,OAAO;QACxB,iBAAiB,IAAI,OAAO;QAC5B,iBAAiB,IAAI,OAAO;QAC5B,oBAAoB,IAAI,OAAO;QAC/B,cAAc,IAAI,OAAO;QACzB,gBAAgB,IAAI,OAAO,CAC9B,CAAA;AACL,CAAC","sourcesContent":["import { MaybeAsync } from '@mtcute/client'\n\n// ⚠️ Important: when modifying the below interface, also update it\n// in packages/core/src/storage/storage.test-utils.ts\n\n/**\n * Interface for FSM storage for the dispatcher.\n *\n * All of the officially supported storages already implement\n * this interface, so you can just re-use it.\n *\n * Current scene is a special case of a `string` state,\n * Most of the time you can just store it the same way\n * as normal state, prefixing with something like `$current_state_`\n * (scene name can't start with `$`).\n * Alternatively, you can store them as simple strings\n */\nexport interface IStateStorage {\n    /**\n     * Retrieve state from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    getState(key: string): MaybeAsync<unknown>\n\n    /**\n     * Save state to the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     * @param state  Object representing the state\n     * @param ttl  TTL for the state, in seconds\n     */\n    setState(key: string, state: unknown, ttl?: number): MaybeAsync<void>\n\n    /**\n     * Delete state from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    deleteState(key: string): MaybeAsync<void>\n\n    /**\n     * Retrieve the current scene UID from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    getCurrentScene(key: string): MaybeAsync<string | null>\n\n    /**\n     * Change current scene's UID from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     * @param scene  New scene\n     * @param ttl  TTL for the scene, in seconds\n     */\n    setCurrentScene(key: string, scene: string, ttl?: number): MaybeAsync<void>\n\n    /**\n     * Delete current scene from the storage, effectively \"exiting\" to root.\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    deleteCurrentScene(key: string): MaybeAsync<void>\n\n    /**\n     * Get information about a rate limit.\n     *\n     * It is recommended that you use sliding window or leaky bucket\n     * to implement rate limiting ([learn more](https://konghq.com/blog/how-to-design-a-scalable-rate-limiting-algorithm/)),\n     *\n     * @param key  Key of the rate limit\n     * @param limit  Maximum number of requests in `window`\n     * @param window  Window size in seconds\n     * @returns  Tuple containing the number of remaining and\n     *   unix time in ms when the user can try again\n     */\n    getRateLimit(key: string, limit: number, window: number): MaybeAsync<[number, number]>\n\n    /**\n     * Reset a rate limit.\n     *\n     * @param key  Key of the rate limit\n     */\n    resetRateLimit(key: string): MaybeAsync<void>\n}\n\nexport function isCompatibleStorage(storage: unknown): storage is IStateStorage {\n    return (\n        typeof storage === 'object' &&\n        storage !== null &&\n        'getState' in storage &&\n        'setState' in storage &&\n        'deleteState' in storage &&\n        'getCurrentScene' in storage &&\n        'setCurrentScene' in storage &&\n        'deleteCurrentScene' in storage &&\n        'getRateLimit' in storage &&\n        'resetRateLimit' in storage\n    )\n}\n"]}
+{"version":3,"file":"storage.js","sourceRoot":"","sources":["../../../src/state/storage.ts"],"names":[],"mappings":"AA4GA,MAAM,UAAU,mBAAmB,CAAC,OAAgB;IAChD,OAAO,CACH,OAAO,OAAO,KAAK,QAAQ;QAC3B,OAAO,KAAK,IAAI;QAChB,UAAU,IAAI,OAAO;QACrB,UAAU,IAAI,OAAO;QACrB,aAAa,IAAI,OAAO;QACxB,iBAAiB,IAAI,OAAO;QAC5B,iBAAiB,IAAI,OAAO;QAC5B,oBAAoB,IAAI,OAAO;QAC/B,cAAc,IAAI,OAAO;QACzB,gBAAgB,IAAI,OAAO,CAC9B,CAAA;AACL,CAAC","sourcesContent":["import { MaybeAsync } from '@mtcute/client'\n\n// ⚠️ Important: when modifying the below interface, also update it\n// in packages/core/src/storage/storage.test-utils.ts\n\n/**\n * Interface for FSM storage for the dispatcher.\n *\n * All of the officially supported storages already implement\n * this interface, so you can just re-use it.\n *\n * Current scene is a special case of a `string` state,\n * Most of the time you can just store it the same way\n * as normal state, prefixing with something like `$current_state_`\n * (scene name can't start with `$`).\n * Alternatively, you can store them as simple strings\n */\nexport interface IStateStorage {\n    /**\n     * Load state from some external storage.\n     * Should be used either to load session content from file/network/etc\n     * to memory, or to open required connections to fetch session content later\n     *\n     * This method may be called multiple times and should handle that.\n     */\n    load?(): MaybeAsync<void>\n    /**\n     * Save state to some external storage.\n     * Should be used to commit pending changes in the session.\n     * For example, saving session content to file/network/etc,\n     * or committing a database transaction\n     */\n    save?(): MaybeAsync<void>\n    /**\n     * Cleanup storage and release all used resources.\n     *\n     * This method may be called multiple times and should handle that.\n     */\n    destroy?(): MaybeAsync<void>\n\n    /**\n     * Retrieve state from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    getState(key: string): MaybeAsync<unknown>\n\n    /**\n     * Save state to the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     * @param state  Object representing the state\n     * @param ttl  TTL for the state, in seconds\n     */\n    setState(key: string, state: unknown, ttl?: number): MaybeAsync<void>\n\n    /**\n     * Delete state from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    deleteState(key: string): MaybeAsync<void>\n\n    /**\n     * Retrieve the current scene UID from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    getCurrentScene(key: string): MaybeAsync<string | null>\n\n    /**\n     * Change current scene's UID from the storage\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     * @param scene  New scene\n     * @param ttl  TTL for the scene, in seconds\n     */\n    setCurrentScene(key: string, scene: string, ttl?: number): MaybeAsync<void>\n\n    /**\n     * Delete current scene from the storage, effectively \"exiting\" to root.\n     *\n     * @param key  Key of the state, as defined by {@link StateKeyDelegate}\n     */\n    deleteCurrentScene(key: string): MaybeAsync<void>\n\n    /**\n     * Get information about a rate limit.\n     *\n     * It is recommended that you use sliding window or leaky bucket\n     * to implement rate limiting ([learn more](https://konghq.com/blog/how-to-design-a-scalable-rate-limiting-algorithm/)),\n     *\n     * @param key  Key of the rate limit\n     * @param limit  Maximum number of requests in `window`\n     * @param window  Window size in seconds\n     * @returns  Tuple containing the number of remaining and\n     *   unix time in ms when the user can try again\n     */\n    getRateLimit(key: string, limit: number, window: number): MaybeAsync<[number, number]>\n\n    /**\n     * Reset a rate limit.\n     *\n     * @param key  Key of the rate limit\n     */\n    resetRateLimit(key: string): MaybeAsync<void>\n}\n\nexport function isCompatibleStorage(storage: unknown): storage is IStateStorage {\n    return (\n        typeof storage === 'object' &&\n        storage !== null &&\n        'getState' in storage &&\n        'setState' in storage &&\n        'deleteState' in storage &&\n        'getCurrentScene' in storage &&\n        'setCurrentScene' in storage &&\n        'deleteCurrentScene' in storage &&\n        'getRateLimit' in storage &&\n        'resetRateLimit' in storage\n    )\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mtcute/dispatcher",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Updates dispatcher and bot framework for @mtcute/client",
   "author": "Alina Sireneva <alina@tei.su>",
   "license": "MIT",
@@ -8,7 +8,8 @@
   "type": "module",
   "scripts": {},
   "dependencies": {
-    "@mtcute/client": "^0.1.2",
+    "@mtcute/client": "^0.2.0",
+    "@mtcute/test": "^0.2.0",
     "events": "3.2.0"
   },
   "module": "esm/index.js",