@yaebal/core 0.0.1

package/lib/composer.js

@@ -0,0 +1,178 @@
+/** koa-style middleware composer with single-`next()` protection. */
+export function compose(middlewares) {
+    return function composed(ctx, next) {
+        let lastIndex = -1;
+        const dispatch = async (i) => {
+            if (i <= lastIndex)
+                throw new Error("next() called multiple times");
+            lastIndex = i;
+            const fn = i === middlewares.length ? next : middlewares[i];
+            if (!fn)
+                return;
+            await fn(ctx, () => dispatch(i + 1));
+        };
+        return dispatch(0);
+    };
+}
+function checkField(ctx, field) {
+    switch (field) {
+        case "text":
+        case "caption":
+            return typeof ctx.text === "string" && ctx.text.length > 0;
+        case "data":
+            return Boolean(ctx.callbackQuery?.data);
+        case "entities":
+            return Boolean(ctx.message?.entities?.length);
+        default: {
+            const msg = ctx.message;
+            return Boolean(msg?.[field]);
+        }
+    }
+}
+export function matchQuery(ctx, query) {
+    const [head, ...rest] = query.split(":");
+    if (head && head.length > 0 && ctx.updateType !== head)
+        return false;
+    for (const field of rest) {
+        if (!checkField(ctx, field))
+            return false;
+    }
+    return true;
+}
+/**
+ * the chainable middleware pipeline. every context-enriching method returns a
+ * composer whose context type carries the new properties — types flow through
+ * the whole chain (the GramIO idea). `Composer` is also usable standalone, so
+ * feature files can be plain composers with no `Bot` and no token.
+ */
+export class Composer {
+    middlewares = [];
+    /** raw middleware. call `next()` to continue the chain. */
+    use(...middleware) {
+        this.middlewares.push(...middleware);
+        return this;
+    }
+    /** handle a specific update, optionally narrowed by a filter query. */
+    on(query, ...handlers) {
+        const handler = compose(handlers);
+        this.middlewares.push((ctx, next) => matchQuery(ctx, query) ? handler(ctx, next) : next());
+        return this;
+    }
+    /** handle `/<name>` commands. Strips a trailing `@botname` and parses args. */
+    command(name, ...handlers) {
+        const handler = compose(handlers);
+        this.middlewares.push((ctx, next) => {
+            const text = ctx.text;
+            if (text === undefined || !text.startsWith("/"))
+                return next();
+            const [head, ...args] = text.slice(1).split(/\s+/);
+            const base = head?.split("@")[0];
+            if (base !== name)
+                return next();
+            Object.assign(ctx, { command: base, args });
+            return handler(ctx, next);
+        });
+        return this;
+    }
+    /** match message text/caption against a string or regex; exposes `ctx.match`. */
+    hears(trigger, ...handlers) {
+        const handler = compose(handlers);
+        this.middlewares.push((ctx, next) => {
+            const text = ctx.text;
+            if (text === undefined)
+                return next();
+            if (typeof trigger === "string") {
+                if (text !== trigger)
+                    return next();
+                Object.assign(ctx, { match: text });
+            }
+            else {
+                const m = text.match(trigger);
+                if (!m)
+                    return next();
+                Object.assign(ctx, { match: m });
+            }
+            return handler(ctx, next);
+        });
+        return this;
+    }
+    /** match callback-query data against a string or regex; exposes `ctx.match`. */
+    callbackQuery(trigger, ...handlers) {
+        const handler = compose(handlers);
+        this.middlewares.push((ctx, next) => {
+            const data = ctx.callbackQuery?.data;
+            if (data === undefined)
+                return next();
+            if (typeof trigger === "string") {
+                if (data !== trigger)
+                    return next();
+                Object.assign(ctx, { match: data });
+            }
+            else {
+                const m = data.match(trigger);
+                if (!m)
+                    return next();
+                Object.assign(ctx, { match: m });
+            }
+            return handler(ctx, next);
+        });
+        return this;
+    }
+    /** continue only if the predicate holds. */
+    guard(predicate) {
+        this.middlewares.push(async (ctx, next) => {
+            if (await predicate(ctx))
+                await next();
+        });
+        return this;
+    }
+    /**
+     * run `handlers` only when `filter` matches. the filter narrows the context
+     * (and may attach data), so handlers see `C & Add`. compose filters with
+     * `and` / `or` / `not` from `@yaebal/filters`.
+     */
+    filter(filter, ...handlers) {
+        const handler = compose(handlers);
+        this.middlewares.push((ctx, next) => (filter.test(ctx) ? handler(ctx, next) : next()));
+        return this;
+    }
+    /** apply a plugin. its required context (`In`) is checked at compile time. */
+    install(plugin) {
+        return plugin(this);
+    }
+    // biome-ignore lint/suspicious/noExplicitAny: overload implementation
+    derive(a, b) {
+        const scoped = typeof a !== "function";
+        const only = scoped ? (Array.isArray(a) ? a : [a]) : null;
+        const fn = (scoped ? b : a);
+        this.middlewares.push(async (ctx, next) => {
+            if (!only || only.includes(ctx.updateType))
+                Object.assign(ctx, await fn(ctx));
+            await next();
+        });
+        return this;
+    }
+    /**
+     * static context enrichment. adds `D` to the context type.
+     * NOTE: a production build would hoist this out of the per-request path entirely;
+     * here it is applied once at the top of the chain for simplicity.
+     */
+    decorate(value) {
+        this.middlewares.push((ctx, next) => {
+            Object.assign(ctx, value);
+            return next();
+        });
+        return this;
+    }
+    /** merge another composer in, inheriting its full context type. */
+    extend(other) {
+        this.middlewares.push(other.toMiddleware());
+        return this;
+    }
+    /** collapse this composer into a single middleware (used by `extend` and `Bot`). */
+    toMiddleware() {
+        const composed = compose(this.middlewares);
+        return (ctx, next) => composed(ctx, next);
+    }
+}
+//# sourceMappingURL=composer.js.map

package/lib/composer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer.js","sourceRoot":"","sources":["../src/composer.ts"],"names":[],"mappings":"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"}

package/lib/context.d.ts

@@ -0,0 +1,40 @@
+import type { Api } from "./api.js";
+import type { FormatResult } from "./format.js";
+import type { MediaSource } from "./media.js";
+import type { CallbackQuery, Chat, Message, Update, UpdateName, User } from "./telegram-types.js";
+export interface ContextOptions {
+    api: Api;
+    update: Update;
+    updateType: UpdateName;
+}
+type SendText = string | FormatResult;
+/**
+ * the base context every update is wrapped in. plugins and `derive`/`decorate`
+ * enrich it with extra properties; those extras are tracked at the type level
+ * by the Composer, so handlers see them without casting.
+ */
+export declare class Context {
+    readonly api: Api;
+    readonly update: Update;
+    readonly updateType: UpdateName;
+    constructor(options: ContextOptions);
+    get message(): Message | undefined;
+    get callbackQuery(): CallbackQuery | undefined;
+    get from(): User | undefined;
+    get chat(): Chat | undefined;
+    get text(): string | undefined;
+    /** narrowing helper in the puregram spirit: `if (ctx.is("callback_query"))`. */
+    is(updateType: UpdateName): boolean;
+    /** send a message to the current chat. accepts a plain string or a `format` result. */
+    send(text: SendText, extra?: Record<string, unknown>): Promise<Message>;
+    /** reply to the triggering message. */
+    reply(text: SendText, extra?: Record<string, unknown>): Promise<Message>;
+    /** send a photo. accepts a {@link MediaSource} or a raw file_id / URL string. */
+    sendPhoto(photo: MediaSource | string, extra?: Record<string, unknown>): Promise<Message>;
+    /** send a document. accepts a {@link MediaSource} or a raw file_id / URL string. */
+    sendDocument(document: MediaSource | string, extra?: Record<string, unknown>): Promise<Message>;
+    /** answer the current callback query (no-op if there is none). */
+    answerCallbackQuery(extra?: Record<string, unknown>): Promise<boolean>;
+}
+export {};
+//# sourceMappingURL=context.d.ts.map

package/lib/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAElG,MAAM,WAAW,cAAc;IAC9B,GAAG,EAAE,GAAG,CAAC;IACT,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,UAAU,CAAC;CACvB;AAED,KAAK,QAAQ,GAAG,MAAM,GAAG,YAAY,CAAC;AAOtC;;;;GAIG;AACH,qBAAa,OAAO;IACnB,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC;IAClB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAC;gBAEpB,OAAO,EAAE,cAAc;IAMnC,IAAI,OAAO,IAAI,OAAO,GAAG,SAAS,CAEjC;IAED,IAAI,aAAa,IAAI,aAAa,GAAG,SAAS,CAE7C;IAED,IAAI,IAAI,IAAI,IAAI,GAAG,SAAS,CAE3B;IAED,IAAI,IAAI,IAAI,IAAI,GAAG,SAAS,CAE3B;IAED,IAAI,IAAI,IAAI,MAAM,GAAG,SAAS,CAE7B;IAED,gFAAgF;IAChF,EAAE,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO;IAInC,uFAAuF;IACvF,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS3E,uCAAuC;IACvC,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5E,iFAAiF;IACjF,SAAS,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAQ7F,oFAAoF;IACpF,YAAY,CACX,QAAQ,EAAE,WAAW,GAAG,MAAM,EAC9B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GACjC,OAAO,CAAC,OAAO,CAAC;IASnB,kEAAkE;IAClE,mBAAmB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAM1E"}

package/lib/context.js

@@ -0,0 +1,78 @@
+function resolveText(text) {
+    if (typeof text === "string")
+        return { text };
+    return { text: text.text, entities: text.entities };
+}
+/**
+ * the base context every update is wrapped in. plugins and `derive`/`decorate`
+ * enrich it with extra properties; those extras are tracked at the type level
+ * by the Composer, so handlers see them without casting.
+ */
+export class Context {
+    api;
+    update;
+    updateType;
+    constructor(options) {
+        this.api = options.api;
+        this.update = options.update;
+        this.updateType = options.updateType;
+    }
+    get message() {
+        return this.update.message ?? this.update.edited_message ?? this.update.channel_post;
+    }
+    get callbackQuery() {
+        return this.update.callback_query;
+    }
+    get from() {
+        return this.message?.from ?? this.callbackQuery?.from;
+    }
+    get chat() {
+        return this.message?.chat ?? this.callbackQuery?.message?.chat;
+    }
+    get text() {
+        return this.message?.text ?? this.message?.caption;
+    }
+    /** narrowing helper in the puregram spirit: `if (ctx.is("callback_query"))`. */
+    is(updateType) {
+        return this.updateType === updateType;
+    }
+    /** send a message to the current chat. accepts a plain string or a `format` result. */
+    send(text, extra = {}) {
+        const chatId = this.chat?.id;
+        if (chatId === undefined) {
+            return Promise.reject(new Error("send(): no chat in this update"));
+        }
+        return this.api.sendMessage({ chat_id: chatId, ...resolveText(text), ...extra });
+    }
+    /** reply to the triggering message. */
+    reply(text, extra = {}) {
+        const replyTo = this.message?.message_id;
+        return this.send(text, {
+            ...(replyTo !== undefined ? { reply_parameters: { message_id: replyTo } } : {}),
+            ...extra,
+        });
+    }
+    /** send a photo. accepts a {@link MediaSource} or a raw file_id / URL string. */
+    sendPhoto(photo, extra = {}) {
+        const chatId = this.chat?.id;
+        if (chatId === undefined)
+            return Promise.reject(new Error("sendPhoto(): no chat in this update"));
+        return this.api.call("sendPhoto", { chat_id: chatId, photo, ...extra });
+    }
+    /** send a document. accepts a {@link MediaSource} or a raw file_id / URL string. */
+    sendDocument(document, extra = {}) {
+        const chatId = this.chat?.id;
+        if (chatId === undefined) {
+            return Promise.reject(new Error("sendDocument(): no chat in this update"));
+        }
+        return this.api.call("sendDocument", { chat_id: chatId, document, ...extra });
+    }
+    /** answer the current callback query (no-op if there is none). */
+    answerCallbackQuery(extra = {}) {
+        const id = this.callbackQuery?.id;
+        if (id === undefined)
+            return Promise.resolve(false);
+        return this.api.answerCallbackQuery({ callback_query_id: id, ...extra });
+    }
+}
+//# sourceMappingURL=context.js.map

package/lib/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"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"}

package/lib/core.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=core.test.d.ts.map

package/lib/core.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.test.d.ts","sourceRoot":"","sources":["../src/core.test.ts"],"names":[],"mappings":""}

package/lib/core.test.js

@@ -0,0 +1,87 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { encodeRequest } from "./api.js";
+import { Bot } from "./bot.js";
+import { isMediaSource, media } from "./media.js";
+import { webhookCallback } from "./webhook.js";
+test("media helpers are branded and discriminated", () => {
+    assert.ok(isMediaSource(media.fileId("AgAC")));
+    assert.ok(isMediaSource(media.url("https://x/y.png")));
+    assert.equal(isMediaSource({ kind: "fileId", fileId: "x" }), false); // unbranded
+});
+test("encodeRequest sends JSON when there is no upload", async () => {
+    const r = await encodeRequest({ chat_id: 1, photo: media.fileId("AgAC") });
+    assert.equal(r.contentType, "application/json");
+    assert.deepEqual(JSON.parse(r.body), { chat_id: 1, photo: "AgAC" });
+});
+test("encodeRequest inlines a url media to its string", async () => {
+    const r = await encodeRequest({ photo: media.url("https://e/p.png") });
+    assert.deepEqual(JSON.parse(r.body), { photo: "https://e/p.png" });
+});
+test("encodeRequest builds multipart for a buffer upload", async () => {
+    const r = await encodeRequest({
+        chat_id: 7,
+        photo: media.buffer(new Uint8Array([1, 2, 3]), "pic.png"),
+        reply_markup: { inline_keyboard: [] },
+    });
+    assert.ok(r.body instanceof FormData);
+    const form = r.body;
+    assert.equal(form.get("photo"), "attach://_file0");
+    assert.ok(form.get("_file0") instanceof Blob);
+    assert.equal(form.get("chat_id"), "7"); // non-string serialized
+    assert.equal(form.get("reply_markup"), '{"inline_keyboard":[]}'); // object → JSON
+});
+test("encodeRequest handles no params", async () => {
+    const r = await encodeRequest(undefined);
+    assert.equal(r.body, undefined);
+});
+test("encodeRequest rejects nested media (fails loud, no garbage)", async () => {
+    await assert.rejects(() => encodeRequest({ media: [{ type: "photo", media: media.path("./a.jpg") }] }), /nested MediaSource/);
+});
+test("encodeRequest throws a helpful error for media.path() without a readFile (edge)", async () => {
+    await assert.rejects(() => encodeRequest({ photo: media.path("./a.jpg") }), /needs a filesystem/);
+});
+test("encodeRequest uses an injected readFile for media.path() (runtime-agnostic)", async () => {
+    const readFile = async (p) => {
+        assert.equal(p, "./pics/cat.jpg"); // path forwarded verbatim
+        return new Uint8Array([9, 8, 7]);
+    };
+    const r = await encodeRequest({ chat_id: 1, photo: media.path("./pics/cat.jpg") }, readFile);
+    const form = r.body;
+    assert.ok(form.get("_file0") instanceof Blob);
+    assert.equal(form.get("photo"), "attach://_file0");
+    assert.equal(form.get("_file0").name, "cat.jpg"); // pure-js basename
+});
+test("webhookCallback dispatches a POSTed update and guards method/secret", async () => {
+    const seen = [];
+    const sink = { handleUpdate: async (u) => void seen.push(u.update_id) };
+    const handler = webhookCallback(sink, { secretToken: "s3cret" });
+    const body = JSON.stringify({ update_id: 7, message: { text: "hi" } });
+    const ok = await handler(new Request("http://x/hook", {
+        method: "POST",
+        headers: { "x-telegram-bot-api-secret-token": "s3cret" },
+        body,
+    }));
+    assert.equal(ok.status, 200);
+    assert.deepEqual(seen, [7]);
+    const wrongMethod = await handler(new Request("http://x/hook"));
+    assert.equal(wrongMethod.status, 405);
+    const wrongSecret = await handler(new Request("http://x/hook", {
+        method: "POST",
+        headers: { "x-telegram-bot-api-secret-token": "nope" },
+        body,
+    }));
+    assert.equal(wrongSecret.status, 401);
+});
+test("Bot.handleUpdate runs the middleware chain (webhook entry)", async () => {
+    let seen = "";
+    const bot = new Bot("123:abc").on("message:text", (ctx) => {
+        seen = ctx.text;
+    });
+    await bot.handleUpdate({
+        update_id: 1,
+        message: { message_id: 1, date: 0, chat: { id: 1, type: "private" }, text: "hi" },
+    });
+    assert.equal(seen, "hi");
+});
+//# sourceMappingURL=core.test.js.map

package/lib/core.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.test.js","sourceRoot":"","sources":["../src/core.test.ts"],"names":[],"mappings":"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"}

package/lib/filter.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=filter.test.d.ts.map

package/lib/filter.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.test.d.ts","sourceRoot":"","sources":["../src/filter.test.ts"],"names":[],"mappings":""}

package/lib/filter.test.js

@@ -0,0 +1,158 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Composer, Context } from "./index.js";
+/** minimal no-op api stub — composer tests never make real api calls. */
+const stubApi = null;
+function makeCtx(update) {
+    const keys = Object.keys(update).filter((k) => k !== "update_id");
+    const updateType = keys[0];
+    return new Context({ api: stubApi, update, updateType });
+}
+function makeMessageCtx(text) {
+    return makeCtx({
+        update_id: 1,
+        message: {
+            message_id: 1,
+            date: 0,
+            chat: { id: 1, type: "private" },
+            ...(text !== undefined ? { text } : {}),
+        },
+    });
+}
+function makeCallbackCtx(data = "btn") {
+    return makeCtx({
+        update_id: 2,
+        callback_query: {
+            id: "q1",
+            from: { id: 99, is_bot: false, first_name: "U" },
+            chat_instance: "ci",
+            data,
+        },
+    });
+}
+/** run `composer.toMiddleware()` against ctx and resolve when the chain ends. */
+async function run(composer, ctx) {
+    await composer.toMiddleware()(ctx, async () => { });
+}
+test("filter: runs handlers when filter.test returns true", async () => {
+    const alwaysTrue = {
+        test(_ctx) {
+            return true;
+        },
+    };
+    let called = false;
+    const composer = new Composer().filter(alwaysTrue, (_ctx) => {
+        called = true;
+    });
+    await run(composer, makeMessageCtx("hi"));
+    assert.ok(called, "handler should have been called");
+});
+test("filter: skips handlers and calls next when filter.test returns false", async () => {
+    const alwaysFalse = {
+        test(_ctx) {
+            return false;
+        },
+    };
+    let handlerCalled = false;
+    let nextCalled = false;
+    const composer = new Composer()
+        .filter(alwaysFalse, (_ctx) => {
+        handlerCalled = true;
+    })
+        .use((_ctx, next) => {
+        nextCalled = true;
+        return next();
+    });
+    await run(composer, makeMessageCtx());
+    assert.equal(handlerCalled, false, "handler must not run when filter rejects");
+    assert.ok(nextCalled, "next middleware must still be reached");
+});
+test("filter: handler sees data attached by filter.test via Object.assign", async () => {
+    const regexFilter = {
+        test(ctx) {
+            const m = ctx.text?.match(/hello (\w+)/);
+            if (!m)
+                return false;
+            Object.assign(ctx, { match: m });
+            return true;
+        },
+    };
+    let captured;
+    const composer = new Composer().filter(regexFilter, (ctx) => {
+        captured = ctx.match;
+    });
+    await run(composer, makeMessageCtx("hello world"));
+    assert.ok(captured, "match should be set on ctx");
+    assert.equal(captured[1], "world");
+});
+test("filter: filter.test that attaches data is not called for non-matching ctx", async () => {
+    const regexFilter = {
+        test(ctx) {
+            const m = ctx.text?.match(/hello (\w+)/);
+            if (!m)
+                return false;
+            Object.assign(ctx, { match: m });
+            return true;
+        },
+    };
+    let handlerCalled = false;
+    const composer = new Composer().filter(regexFilter, (_ctx) => {
+        handlerCalled = true;
+    });
+    // callback_query ctx has no text — regex won't match
+    await run(composer, makeCallbackCtx());
+    assert.equal(handlerCalled, false);
+});
+test("filter: type guard narrows — handler sees ctx.tag added by filter", async () => {
+    const tagFilter = {
+        test(ctx) {
+            Object.assign(ctx, { tag: 42 });
+            return true;
+        },
+    };
+    let seenTag;
+    const composer = new Composer().filter(tagFilter, (ctx) => {
+        // typescript sees ctx.tag as number here (narrowed by the Filter type)
+        seenTag = ctx.tag;
+    });
+    await run(composer, makeMessageCtx());
+    assert.equal(seenTag, 42);
+});
+test("derive scoped: fn runs for the listed update type and field is present", async () => {
+    const composer = new Composer().derive("message", (_ctx) => ({ enriched: true }));
+    const msgCtx = makeMessageCtx("test");
+    await run(composer, msgCtx);
+    assert.equal(msgCtx.enriched, true);
+});
+test("derive scoped: fn does NOT run for a different update type", async () => {
+    const composer = new Composer().derive("message", (_ctx) => ({ enriched: true }));
+    const cbCtx = makeCallbackCtx();
+    await run(composer, cbCtx);
+    assert.equal(cbCtx.enriched, undefined);
+});
+test("derive scoped: both updateTypes work when given an array", async () => {
+    const composer = new Composer().derive(["message", "callback_query"], (_ctx) => ({
+        enriched: true,
+    }));
+    const msgCtx = makeMessageCtx();
+    const cbCtx = makeCallbackCtx();
+    await run(composer, msgCtx);
+    await run(composer, cbCtx);
+    assert.equal(msgCtx.enriched, true);
+    assert.equal(cbCtx.enriched, true);
+});
+test("derive scoped: unscoped array — non-listed type is not enriched", async () => {
+    const composer = new Composer().derive("message", (_ctx) => ({ enriched: true }));
+    const cbCtx = makeCallbackCtx();
+    await run(composer, cbCtx);
+    assert.equal(cbCtx.enriched, undefined);
+});
+test("derive scoped: fn receives the context for async enrichment", async () => {
+    const composer = new Composer().derive("message", async (ctx) => ({
+        textLen: ctx.text?.length ?? 0,
+    }));
+    const msgCtx = makeMessageCtx("hello");
+    await run(composer, msgCtx);
+    assert.equal(msgCtx.textLen, 5);
+});
+//# sourceMappingURL=filter.test.js.map

package/lib/filter.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter.test.js","sourceRoot":"","sources":["../src/filter.test.ts"],"names":[],"mappings":"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"}

package/lib/format.d.ts

@@ -0,0 +1,31 @@
+import type { MessageEntity } from "./telegram-types.js";
+/**
+ * formatting without `parse_mode`: tagged template literals that build proper
+ * `MessageEntity` objects, so there is nothing to escape (the GramIO idea).
+ */
+export interface FormatResult {
+    text: string;
+    entities: MessageEntity[];
+}
+/** a piece of text that carries its own entities, used inside `format`. */
+export declare class Stringable implements FormatResult {
+    readonly text: string;
+    readonly entities: MessageEntity[];
+    constructor(text: string, entities?: MessageEntity[]);
+}
+type Insertable = Stringable | FormatResult | string | number | bigint;
+/** stitches the literal parts and interpolations into one `{ text, entities }`. */
+export declare function format(strings: TemplateStringsArray, ...subs: Insertable[]): FormatResult;
+export declare const bold: (value: string) => Stringable;
+export declare const italic: (value: string) => Stringable;
+export declare const underline: (value: string) => Stringable;
+export declare const strikethrough: (value: string) => Stringable;
+export declare const spoiler: (value: string) => Stringable;
+export declare const code: (value: string) => Stringable;
+export declare const pre: (value: string) => Stringable;
+export declare function link(text: string, url: string): Stringable;
+export declare function mention(text: string, user: {
+    id: number;
+}): Stringable;
+export {};
+//# sourceMappingURL=format.d.ts.map

package/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../src/format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,2EAA2E;AAC3E,qBAAa,UAAW,YAAW,YAAY;IAE7C,QAAQ,CAAC,IAAI,EAAE,MAAM;IACrB,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE;gBADzB,IAAI,EAAE,MAAM,EACZ,QAAQ,GAAE,aAAa,EAAO;CAExC;AAED,KAAK,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAYvE,mFAAmF;AACnF,wBAAgB,MAAM,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,IAAI,EAAE,UAAU,EAAE,GAAG,YAAY,CAwBzF;AAOD,eAAO,MAAM,IAAI,UAJD,MAAM,KAAG,UAIO,CAAC;AACjC,eAAO,MAAM,MAAM,UALH,MAAM,KAAG,UAKW,CAAC;AACrC,eAAO,MAAM,SAAS,UANN,MAAM,KAAG,UAMiB,CAAC;AAC3C,eAAO,MAAM,aAAa,UAPV,MAAM,KAAG,UAOyB,CAAC;AACnD,eAAO,MAAM,OAAO,UARJ,MAAM,KAAG,UAQa,CAAC;AACvC,eAAO,MAAM,IAAI,UATD,MAAM,KAAG,UASO,CAAC;AACjC,eAAO,MAAM,GAAG,UAVA,MAAM,KAAG,UAUK,CAAC;AAE/B,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,CAE1D;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,UAAU,CAItE"}