@mtcute/dispatcher 0.1.0

package/esm/filters/logic.d.ts

@@ -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/esm/filters/logic.js

@@ -0,0 +1,107 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// ^^ will be looked into in MTQ-29
+/**
+ * Filter that matches any update
+ */
+export const any = () => true;
+/**
+ * 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 function not(fn) {
+    return (upd, state) => {
+        const res = fn(upd, state);
+        if (typeof res === 'boolean')
+            return !res;
+        return res.then((r) => !r);
+    };
+}
+/**
+ * Combine multiple filters by applying an AND logical
+ * operation between every one of them:
+ * `and(fn1, fn2, ..., fnN) = fn1 AND fn2 AND ... AND fnN`
+ *
+ * > **Note**: This also combines type modifications, i.e.
+ * > if the 1st has modification `{ field1: string }`
+ * > and the 2nd has modification `{ field2: number }`,
+ * > then the combined filter will have
+ * > combined modification `{ field1: string, field2: number }`
+ *
+ * > **Note**: Due to TypeScript limitations (or more likely my lack of brain cells),
+ * > state type is only correctly inferred for up to 6 filters.
+ * > If you need more, either provide type explicitly (e.g. `filters.state<SomeState>(...)`),
+ * > or combine multiple `and` calls.
+ *
+ * @param fns  Filters to combine
+ */
+export 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();
+    };
+}
+/**
+ * Combine multiple filters by applying an OR logical
+ * operation between every one of them:
+ * `or(fn1, fn2, ..., fnN) = fn1 OR fn2 OR ... OR fnN`
+ *
+ * > **Note**: This also combines type modifications in a union, i.e.
+ * > if the 1st has modification `{ field1: string }`
+ * > and the 2nd has modification `{ field2: number }`,
+ * > then the combined filter will have
+ * > modification `{ field1: string } | { field2: number }`.
+ *
+ * > **Note**: Due to TypeScript limitations (or more likely my lack of brain cells),
+ * > state type is only correctly inferred for up to 6 filters.
+ * > If you need more, either provide type explicitly (e.g. `filters.state<SomeState>(...)`),
+ * > or combine multiple `and` calls.
+ *
+ * @param fns  Filters to combine
+ */
+export 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();
+    };
+}
+//# sourceMappingURL=logic.js.map

package/esm/filters/logic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logic.js","sourceRoot":"","sources":["../../../src/filters/logic.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,mCAAmC;AAMnC;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAsB,GAAG,EAAE,CAAC,IAAI,CAAA;AAEhD;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,GAAG,CACf,EAAkC;IAElC,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClB,MAAM,GAAG,GAAG,EAAE,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;QAE1B,IAAI,OAAO,GAAG,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAA;QAEzC,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;IAC9B,CAAC,CAAA;AACL,CAAC;AAyGD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,GAAG,CAAC,GAAG,GAAkC;IACrD,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClB,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;QAEtB,MAAM,IAAI,GAAG,GAAwB,EAAE;YACnC,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,IAAI,CAAA;YAE1B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAEhC,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE;gBAC1B,IAAI,CAAC,GAAG;oBAAE,OAAO,KAAK,CAAA;gBAEtB,OAAO,IAAI,EAAE,CAAA;aAChB;YAED,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAC3B,IAAI,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAA;gBAEpB,OAAO,IAAI,EAAE,CAAA;YACjB,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QAED,OAAO,IAAI,EAAE,CAAA;IACjB,CAAC,CAAA;AACL,CAAC;AAuGD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,EAAE,CAAC,GAAG,GAAkC;IACpD,OAAO,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE;QAClB,IAAI,CAAC,GAAG,CAAC,CAAA;QACT,MAAM,GAAG,GAAG,GAAG,CAAC,MAAM,CAAA;QAEtB,MAAM,IAAI,GAAG,GAAwB,EAAE;YACnC,IAAI,CAAC,KAAK,GAAG;gBAAE,OAAO,KAAK,CAAA;YAE3B,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,CAAA;YAEhC,IAAI,OAAO,GAAG,KAAK,SAAS,EAAE;gBAC1B,IAAI,GAAG;oBAAE,OAAO,IAAI,CAAA;gBAEpB,OAAO,IAAI,EAAE,CAAA;aAChB;YAED,OAAO,GAAG,CAAC,IAAI,CAAC,CAAC,CAAU,EAAE,EAAE;gBAC3B,IAAI,CAAC;oBAAE,OAAO,IAAI,CAAA;gBAElB,OAAO,IAAI,EAAE,CAAA;YACjB,CAAC,CAAC,CAAA;QACN,CAAC,CAAA;QAED,OAAO,IAAI,EAAE,CAAA;IACjB,CAAC,CAAA;AACL,CAAC","sourcesContent":["/* eslint-disable @typescript-eslint/no-explicit-any */\n// ^^ will be looked into in MTQ-29\n\nimport { MaybeAsync } from '@mtcute/client'\n\nimport { ExtractBaseMany, ExtractMod, Invert, UnionToIntersection, UpdateFilter } from './types.js'\n\n/**\n * Filter that matches any update\n */\nexport const any: UpdateFilter<any> = () => true\n\n/**\n * Invert a filter by applying a NOT logical operation:\n * `not(fn) = NOT fn`\n *\n * > **Note**: This also inverts type modification, i.e.\n * > if the base is `{ field: string | number | null }`\n * > and the modification is `{ field: string }`,\n * > then the negated filter will have\n * > inverted modification `{ field: number | null }`\n *\n * @param fn  Filter to negate\n */\nexport function not<Base, Mod, State extends object>(\n    fn: UpdateFilter<Base, Mod, State>,\n): UpdateFilter<Base, Invert<Base, Mod>, State> {\n    return (upd, state) => {\n        const res = fn(upd, state)\n\n        if (typeof res === 'boolean') return !res\n\n        return res.then((r) => !r)\n    }\n}\n\n// i couldn't come up with proper types for these 😭\n// if you know how to do this better - PRs are welcome!\n\nexport function and<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n): UpdateFilter<Base1 & Base2, Mod1 & Mod2, State1 | State2>\nexport function and<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n): UpdateFilter<Base1 & Base2 & Base3, Mod1 & Mod2 & Mod3, State1 | State2 | State3>\nexport function and<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n): UpdateFilter<Base1 & Base2 & Base3 & Base4, Mod1 & Mod2 & Mod3 & Mod4, State1 | State2 | State3 | State4>\nexport function and<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n    Base5,\n    Mod5,\n    State5 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n    fn5: UpdateFilter<Base5, Mod5, State5>,\n): UpdateFilter<\n    Base1 & Base2 & Base3 & Base4 & Base5,\n    Mod1 & Mod2 & Mod3 & Mod4 & Mod5,\n    State1 | State2 | State3 | State4 | State5\n>\nexport function and<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n    Base5,\n    Mod5,\n    State5 extends object,\n    Base6,\n    Mod6,\n    State6 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n    fn5: UpdateFilter<Base5, Mod5, State5>,\n    fn6: UpdateFilter<Base6, Mod6, State6>,\n): UpdateFilter<\n    Base1 & Base2 & Base3 & Base4 & Base5 & Base6,\n    Mod1 & Mod2 & Mod3 & Mod4 & Mod5 & Mod6,\n    State1 | State2 | State3 | State4 | State5 | State6\n>\nexport function and<Filters extends UpdateFilter<any, any>[]>(\n    ...fns: Filters\n): UpdateFilter<ExtractBaseMany<Filters>, UnionToIntersection<ExtractMod<Filters[number]>>>\n\n/**\n * Combine multiple filters by applying an AND logical\n * operation between every one of them:\n * `and(fn1, fn2, ..., fnN) = fn1 AND fn2 AND ... AND fnN`\n *\n * > **Note**: This also combines type modifications, i.e.\n * > if the 1st has modification `{ field1: string }`\n * > and the 2nd has modification `{ field2: number }`,\n * > then the combined filter will have\n * > combined modification `{ field1: string, field2: number }`\n *\n * > **Note**: Due to TypeScript limitations (or more likely my lack of brain cells),\n * > state type is only correctly inferred for up to 6 filters.\n * > If you need more, either provide type explicitly (e.g. `filters.state<SomeState>(...)`),\n * > or combine multiple `and` calls.\n *\n * @param fns  Filters to combine\n */\nexport function and(...fns: UpdateFilter<any, any, any>[]): UpdateFilter<any, any, any> {\n    return (upd, state) => {\n        let i = 0\n        const max = fns.length\n\n        const next = (): MaybeAsync<boolean> => {\n            if (i === max) return true\n\n            const res = fns[i++](upd, state)\n\n            if (typeof res === 'boolean') {\n                if (!res) return false\n\n                return next()\n            }\n\n            return res.then((r: boolean) => {\n                if (!r) return false\n\n                return next()\n            })\n        }\n\n        return next()\n    }\n}\n\nexport function or<Base1, Mod1, State1 extends object, Base2, Mod2, State2 extends object>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n): UpdateFilter<Base1 & Base2, Mod1 | Mod2, State1 | State2>\n\nexport function or<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n): UpdateFilter<Base1 & Base2 & Base3, Mod1 | Mod2 | Mod3, State1 | State2 | State3>\n\nexport function or<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n): UpdateFilter<Base1 & Base2 & Base3 & Base4, Mod1 | Mod2 | Mod3 | Mod4, State1 | State2 | State3 | State4>\n\nexport function or<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n    Base5,\n    Mod5,\n    State5 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n    fn5: UpdateFilter<Base5, Mod5, State5>,\n): UpdateFilter<\n    Base1 & Base2 & Base3 & Base4 & Base5,\n    Mod1 | Mod2 | Mod3 | Mod4 | Mod5,\n    State1 | State2 | State3 | State4 | State5\n>\n\nexport function or<\n    Base1,\n    Mod1,\n    State1 extends object,\n    Base2,\n    Mod2,\n    State2 extends object,\n    Base3,\n    Mod3,\n    State3 extends object,\n    Base4,\n    Mod4,\n    State4 extends object,\n    Base5,\n    Mod5,\n    State5 extends object,\n    Base6,\n    Mod6,\n    State6 extends object,\n>(\n    fn1: UpdateFilter<Base1, Mod1, State1>,\n    fn2: UpdateFilter<Base2, Mod2, State2>,\n    fn3: UpdateFilter<Base3, Mod3, State3>,\n    fn4: UpdateFilter<Base4, Mod4, State4>,\n    fn5: UpdateFilter<Base5, Mod5, State5>,\n    fn6: UpdateFilter<Base6, Mod6, State6>,\n): UpdateFilter<\n    Base1 & Base2 & Base3 & Base4 & Base5 & Base6,\n    Mod1 | Mod2 | Mod3 | Mod4 | Mod5 | Mod6,\n    State1 | State2 | State3 | State4 | State5 | State6\n>\n\n/**\n * Combine multiple filters by applying an OR logical\n * operation between every one of them:\n * `or(fn1, fn2, ..., fnN) = fn1 OR fn2 OR ... OR fnN`\n *\n * > **Note**: This also combines type modifications in a union, i.e.\n * > if the 1st has modification `{ field1: string }`\n * > and the 2nd has modification `{ field2: number }`,\n * > then the combined filter will have\n * > modification `{ field1: string } | { field2: number }`.\n *\n * > **Note**: Due to TypeScript limitations (or more likely my lack of brain cells),\n * > state type is only correctly inferred for up to 6 filters.\n * > If you need more, either provide type explicitly (e.g. `filters.state<SomeState>(...)`),\n * > or combine multiple `and` calls.\n *\n * @param fns  Filters to combine\n */\nexport function or(...fns: UpdateFilter<any, any, any>[]): UpdateFilter<any, any, any> {\n    return (upd, state) => {\n        let i = 0\n        const max = fns.length\n\n        const next = (): MaybeAsync<boolean> => {\n            if (i === max) return false\n\n            const res = fns[i++](upd, state)\n\n            if (typeof res === 'boolean') {\n                if (res) return true\n\n                return next()\n            }\n\n            return res.then((r: boolean) => {\n                if (r) return true\n\n                return next()\n            })\n        }\n\n        return next()\n    }\n}\n"]}

package/esm/filters/message.d.ts

@@ -0,0 +1,295 @@
+import { Chat, MaybeArray, Message, MessageAction, MessageReplyInfo, RawDocument, Sticker, StickerSourceType, StickerType, User, Video } from '@mtcute/client';
+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 messages that are replies to some other message
+ */
+export declare const reply: UpdateFilter<Message, {
+    replyToMessage: MessageReplyInfo;
+}>;
+/**
+ * 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 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, {
+    media: Extract<import("@mtcute/client").Photo, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Dice, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Contact, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Audio, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Voice, {
+        type: T;
+    }> | Extract<Sticker, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Document, {
+        type: T;
+    }> | Extract<Video, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Location, {
+        type: T;
+    }> | Extract<import("@mtcute/client").LiveLocation, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Game, {
+        type: T;
+    }> | Extract<import("@mtcute/client").WebPage, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Venue, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Poll, {
+        type: T;
+    }> | Extract<import("@mtcute/client").Invoice, {
+        type: T;
+    }>;
+}>;
+/** Filter messages containing a photo */
+export declare const photo: UpdateFilter<Message, {
+    media: import("@mtcute/client").Photo;
+}>;
+/** Filter messages containing a dice */
+export declare const dice: UpdateFilter<Message, {
+    media: import("@mtcute/client").Dice;
+}>;
+/** Filter messages containing a contact */
+export declare const contact: UpdateFilter<Message, {
+    media: import("@mtcute/client").Contact;
+}>;
+/** Filter messages containing an audio file */
+export declare const audio: UpdateFilter<Message, {
+    media: import("@mtcute/client").Audio;
+}>;
+/** Filter messages containing a voice message (audio-only) */
+export declare const voice: UpdateFilter<Message, {
+    media: import("@mtcute/client").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: import("@mtcute/client").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: import("@mtcute/client").Location;
+}>;
+/** Filter messages containing a live location */
+export declare const liveLocation: UpdateFilter<Message, {
+    media: import("@mtcute/client").LiveLocation;
+}>;
+/** Filter messages containing a game */
+export declare const game: UpdateFilter<Message, {
+    media: import("@mtcute/client").Game;
+}>;
+/** Filter messages containing a web page */
+export declare const webpage: UpdateFilter<Message, {
+    media: import("@mtcute/client").WebPage;
+}>;
+/** Filter messages containing a venue */
+export declare const venue: UpdateFilter<Message, {
+    media: import("@mtcute/client").Venue;
+}>;
+/** Filter messages containing a poll */
+export declare const poll: UpdateFilter<Message, {
+    media: import("@mtcute/client").Poll;
+}>;
+/** Filter messages containing an invoice */
+export declare const invoice: UpdateFilter<Message, {
+    media: import("@mtcute/client").Invoice;
+}>;
+/**
+ * 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 const stickerByType: (type: StickerType) => UpdateFilter<Message, {
+    media: Sticker;
+}>;
+/**
+ * Filter messages containing a sticker by its source file type
+ */
+export declare const 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 const action: <T extends "chat_created" | "channel_created" | "chat_migrate_to" | "channel_migrate_from" | "message_pinned" | "history_cleared" | "game_score" | "contact_joined" | "title_changed" | "photo_changed" | "photo_deleted" | "users_added" | "user_left" | "user_removed" | "user_joined_link" | "payment_received" | "payment_sent" | "call" | "screenshot_taken" | "bot_allowed" | "geo_proximity" | "group_call_started" | "group_call_ended" | "group_call_scheduled" | "group_call_invite" | "ttl_changed" | "topic_created" | "topic_edited" | "custom" | "theme_changed" | "user_joined_approved" | "webview_sent" | "webview_received" | "premium_gifted" | "photo_suggested" | "peer_chosen" | "wallpaper_changed">(type: MaybeArray<T>) => UpdateFilter<Message, {
+    action: Extract<import("@mtcute/client").ActionChatCreated, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionChannelCreated, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionChatMigrateTo, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionChannelMigrateFrom, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionMessagePinned, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionHistoryCleared, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGameScore, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionContactJoined, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionTitleChanged, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPhotoChanged, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPhotoDeleted, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionUsersAdded, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionUserLeft, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionUserRemoved, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionUserJoinedLink, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPaymentReceived, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPaymentSent, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionCall, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionScreenshotTaken, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionBotAllowed, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGeoProximity, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGroupCallStarted, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGroupCallEnded, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGroupCallScheduled, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionGroupInvite, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionTtlChanged, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionTopicCreated, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionTopicEdited, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionCustom, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionThemeChanged, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionUserJoinedApproved, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionWebviewDataSent, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionWebviewDataReceived, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPremiumGifted, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPhotoSuggested, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionPeerChosen, {
+        type: T;
+    }> | Extract<import("@mtcute/client").ActionWallpaperChanged, {
+        type: T;
+    }>;
+    sender: T extends "history_cleared" | "contact_joined" | "user_removed" | "user_joined_link" | "bot_allowed" ? User : User | Chat;
+}>;
+export declare const sender: <T extends "user" | "chat">(type: T) => UpdateFilter<Message, {
+    sender: Extract<User, {
+        type: T;
+    }> | Extract<Chat, {
+        type: T;
+    }>;
+}>;
+/**
+ * Filter that matches messages that are replies to some other message.
+ *
+ * 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>;

package/esm/filters/message.js

@@ -0,0 +1,130 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// ^^ will be looked into in MTQ-29
+import { RawDocument, RawLocation, } from '@mtcute/client';
+/**
+ * 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 messages that are replies to some other message
+ */
+export const reply = (msg) => msg.replyToMessage !== null;
+/**
+ * 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('web_page');
+/** 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.
+ *
+ * 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 = await msg.getReplyTo();
+    if (!reply)
+        return false;
+    msg.getReplyTo = () => Promise.resolve(reply);
+    if (!filter)
+        return true;
+    return filter(reply, state);
+};
+//# sourceMappingURL=message.js.map

package/esm/filters/message.js.map

@@ -0,0 +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"]}

package/esm/filters/state.d.ts

@@ -0,0 +1,15 @@
+import { MaybeAsync } from '@mtcute/client';
+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) => MaybeAsync<boolean>) => UpdateFilter<any, {}, T>;

package/esm/filters/state.js

@@ -0,0 +1,27 @@
+/**
+ * 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