yaebal 0.0.1-fake → 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 neverlane
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,16 @@
+# yaebal
+
+yaebal — the batteries-included entry point (the gramio idea). re-exports the
+core engine, the auto-generated contexts, and the common plugins so a bot needs
+a single import. `createBot()` wires the rich per-update contexts (with their
+auto-generated shortcut methods) onto every update via the core context factory.
+
+## install
+
+```sh
+pnpm add yaebal
+```
+
+---
+
+part of [**yaebal**](https://github.com/neverlane/yaebal) — a type-safe, runtime-agnostic Telegram Bot API framework. MIT.

package/lib/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * yaebal — the batteries-included entry point (the gramio idea). re-exports the
+ * core engine, the auto-generated contexts, and the common plugins so a bot needs
+ * a single import. `createBot()` wires the rich per-update contexts (with their
+ * auto-generated shortcut methods) onto every update via the core context factory.
+ */
+export * from "@yaebal/core";
+export * from "@yaebal/contexts";
+export { and, filters, not, or } from "@yaebal/filters";
+export { html, htmlToEntities, md, mdToEntities } from "@yaebal/fmt";
+export { InlineKeyboard, Keyboard } from "@yaebal/keyboard";
+export { callbackData } from "@yaebal/callback-data";
+export { session } from "@yaebal/session";
+export { i18n } from "@yaebal/i18n";
+export { deleteWebhook, serve, setWebhook, webhook } from "@yaebal/web";
+import { type ContextByType } from "@yaebal/contexts";
+import { type BotOptions, Context, Bot as CoreBot, type FilterQuery, type Filtered, type Middleware } from "@yaebal/core";
+type ContextFactory = NonNullable<BotOptions["contextFactory"]>;
+/**
+ * build a base {@link Context} and graft the auto-generated shortcut methods
+ * (`react`, `editText`, `pin`, …) of the matching per-update context onto it.
+ * core's own methods (`send`/`reply`/…) win; the rest are added.
+ */
+export declare const richContext: ContextFactory;
+type QueryHead<Q extends string> = Q extends `${infer H}:${string}` ? H : Q;
+type RichFor<Q extends string> = QueryHead<Q> extends keyof ContextByType ? ContextByType[QueryHead<Q>] : Record<never, never>;
+/**
+ * a {@link CoreBot} whose routers type the handler context to the matching
+ * per-update generated context — so `ctx.react`, `ctx.editText`, … are typed
+ * (not just present at runtime). `on("message:text")` → `MessageContext`,
+ * `on("callback_query:data")` → `CallbackQueryContext`, etc.
+ */
+export declare class Bot<C extends Context = Context> extends CoreBot<C> {
+    constructor(token: string, options?: BotOptions);
+    on<Q extends FilterQuery>(query: Q, ...handlers: Middleware<Filtered<C, Q> & RichFor<Q>>[]): this;
+    command(name: string, ...handlers: Middleware<C & {
+        command: string;
+        args: string[];
+    } & ContextByType["message"]>[]): this;
+}
+/** create a bot whose handlers receive the rich auto-generated context — typed and at runtime. */
+export declare function createBot(token: string, options?: BotOptions): Bot;
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAE,KAAK,aAAa,EAAc,MAAM,kBAAkB,CAAC;AAClE,OAAO,EACN,KAAK,UAAU,EACf,OAAO,EACP,GAAG,IAAI,OAAO,EAEd,KAAK,WAAW,EAChB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,MAAM,cAAc,CAAC;AAEtB,KAAK,cAAc,GAAG,WAAW,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,CAAC;AA0BhE;;;;GAIG;AACH,eAAO,MAAM,WAAW,EAAE,cA0CzB,CAAC;AAGF,KAAK,SAAS,CAAC,CAAC,SAAS,MAAM,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC,IAAI,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC;AAC5E,KAAK,OAAO,CAAC,CAAC,SAAS,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,SAAS,MAAM,aAAa,GACtE,aAAa,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,GAC3B,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAExB;;;;;GAKG;AACH,qBAAa,GAAG,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;gBACnD,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe;IAK1C,EAAE,CAAC,CAAC,SAAS,WAAW,EAChC,KAAK,EAAE,CAAC,EACR,GAAG,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GACpD,IAAI;IAIE,OAAO,CACf,IAAI,EAAE,MAAM,EACZ,GAAG,QAAQ,EAAE,UAAU,CAAC,CAAC,GAAG;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC,EAAE,GAC3F,IAAI;CAMP;AAED,kGAAkG;AAClG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAe,GAAG,GAAG,CAEtE"}

package/lib/index.js

@@ -0,0 +1,100 @@
+/**
+ * yaebal — the batteries-included entry point (the gramio idea). re-exports the
+ * core engine, the auto-generated contexts, and the common plugins so a bot needs
+ * a single import. `createBot()` wires the rich per-update contexts (with their
+ * auto-generated shortcut methods) onto every update via the core context factory.
+ */
+export * from "@yaebal/core";
+export * from "@yaebal/contexts";
+export { and, filters, not, or } from "@yaebal/filters";
+export { html, htmlToEntities, md, mdToEntities } from "@yaebal/fmt";
+export { InlineKeyboard, Keyboard } from "@yaebal/keyboard";
+export { callbackData } from "@yaebal/callback-data";
+export { session } from "@yaebal/session";
+export { i18n } from "@yaebal/i18n";
+export { deleteWebhook, serve, setWebhook, webhook } from "@yaebal/web";
+import { contextFor } from "@yaebal/contexts";
+import { Context, Bot as CoreBot, } from "@yaebal/core";
+/**
+ * auto-detect the runtime and read a local file into bytes — so `media.path()` just
+ * works on node, bun and deno from a single `yaebal` import, no platform package to pick.
+ * the `node:fs` import is dynamic AND guarded by the node check, so on edge/web it's
+ * never reached (or bundled): there the last branch throws and you send
+ * `media.buffer()` / `media.url()` instead. this is the whole "platform layer" — yaebal
+ * needs no mtcute-style `setPlatform()` global because Telegram Bot API is just fetch + this.
+ */
+const autoReadFile = async (path) => {
+    const g = globalThis;
+    if (g.Deno)
+        return g.Deno.readFile(path);
+    if (g.Bun)
+        return g.Bun.file(path).bytes();
+    if (g.process?.versions?.node)
+        return (await import("node:fs/promises")).readFile(path);
+    throw new Error("yaebal: no filesystem in this runtime — send media.buffer()/url() instead of media.path().");
+};
+/**
+ * build a base {@link Context} and graft the auto-generated shortcut methods
+ * (`react`, `editText`, `pin`, …) of the matching per-update context onto it.
+ * core's own methods (`send`/`reply`/…) win; the rest are added.
+ */
+export const richContext = (api, update, updateType) => {
+    const ctx = new Context({ api, update, updateType });
+    const rich = contextFor(updateType, api, update);
+    const target = ctx;
+    // payload fields — define as own props so they SHADOW Context's getters
+    // (plain assignment throws on getter-only props like `chat`)
+    for (const [key, value] of Object.entries(rich)) {
+        Object.defineProperty(ctx, key, {
+            value,
+            writable: true,
+            enumerable: true,
+            configurable: true,
+        });
+    }
+    // shortcut methods (`react`, `editText`, …) and accessors (`senderId`, `isPM`, …)
+    // live UP the generated prototype chain — the immediate prototype is just
+    // `{ constructor }`, the sugar sits on its bases. walk the whole chain and graft
+    // every member core lacks; core's own methods/getters (`send`, `chat`, …) win, and
+    // a more-derived override wins over a base one (we never overwrite an own prop).
+    for (let proto = Object.getPrototypeOf(rich); proto && proto !== Object.prototype; proto = Object.getPrototypeOf(proto)) {
+        for (const [name, desc] of Object.entries(Object.getOwnPropertyDescriptors(proto))) {
+            if (name === "constructor" || name in target)
+                continue;
+            if (typeof desc.value === "function") {
+                target[name] = desc.value.bind(ctx);
+            }
+            else if (desc.get) {
+                Object.defineProperty(ctx, name, {
+                    get: desc.get.bind(ctx),
+                    enumerable: true,
+                    configurable: true,
+                });
+            }
+        }
+    }
+    return ctx;
+};
+/**
+ * a {@link CoreBot} whose routers type the handler context to the matching
+ * per-update generated context — so `ctx.react`, `ctx.editText`, … are typed
+ * (not just present at runtime). `on("message:text")` → `MessageContext`,
+ * `on("callback_query:data")` → `CallbackQueryContext`, etc.
+ */
+export class Bot extends CoreBot {
+    constructor(token, options = {}) {
+        // auto-detecting file reader as the default; an explicit `readFile` still wins
+        super(token, { readFile: autoReadFile, ...options });
+    }
+    on(query, ...handlers) {
+        return super.on(query, ...handlers);
+    }
+    command(name, ...handlers) {
+        return super.command(name, ...handlers);
+    }
+}
+/** create a bot whose handlers receive the rich auto-generated context — typed and at runtime. */
+export function createBot(token, options = {}) {
+    return new Bot(token, { contextFactory: richContext, ...options });
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,EAAE,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAExE,OAAO,EAAsB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAClE,OAAO,EAEN,OAAO,EACP,GAAG,IAAI,OAAO,GAKd,MAAM,cAAc,CAAC;AAItB;;;;;;;GAOG;AACH,MAAM,YAAY,GAAe,KAAK,EAAE,IAAI,EAAE,EAAE;IAC/C,MAAM,CAAC,GAAG,UAIT,CAAC;IAEF,IAAI,CAAC,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,CAAC,GAAG;QAAE,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC;IAC3C,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI;QAAE,OAAO,CAAC,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;IAExF,MAAM,IAAI,KAAK,CACd,4FAA4F,CAC5F,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE;IACtE,MAAM,GAAG,GAAG,IAAI,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC;IACrD,MAAM,IAAI,GAAG,UAAU,CAAC,UAAiC,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,GAAyC,CAAC;IAEzD,wEAAwE;IACxE,6DAA6D;IAC7D,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE;YAC/B,KAAK;YACL,QAAQ,EAAE,IAAI;YACd,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,IAAI;SAClB,CAAC,CAAC;IACJ,CAAC;IAED,kFAAkF;IAClF,0EAA0E;IAC1E,iFAAiF;IACjF,mFAAmF;IACnF,iFAAiF;IACjF,KACC,IAAI,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,EACvC,KAAK,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,EACnC,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EACnC,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,yBAAyB,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YACpF,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,IAAI,MAAM;gBAAE,SAAS;YAEvD,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,GAAI,IAAI,CAAC,KAAyC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1E,CAAC;iBAAM,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC;gBACrB,MAAM,CAAC,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE;oBAChC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC;oBACvB,UAAU,EAAE,IAAI;oBAChB,YAAY,EAAE,IAAI;iBAClB,CAAC,CAAC;YACJ,CAAC;QACF,CAAC;IACF,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC,CAAC;AAQF;;;;;GAKG;AACH,MAAM,OAAO,GAAiC,SAAQ,OAAU;IAC/D,YAAY,KAAa,EAAE,UAAsB,EAAE;QAClD,+EAA+E;QAC/E,KAAK,CAAC,KAAK,EAAE,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtD,CAAC;IAEQ,EAAE,CACV,KAAQ,EACR,GAAG,QAAmD;QAEtD,OAAO,KAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAI,QAAoD,CAAC,CAAC;IAClF,CAAC;IAEQ,OAAO,CACf,IAAY,EACZ,GAAG,QAA0F;QAE7F,OAAO,KAAK,CAAC,OAAO,CACnB,IAAI,EACJ,GAAI,QAA6E,CACjF,CAAC;IACH,CAAC;CACD;AAED,kGAAkG;AAClG,MAAM,UAAU,SAAS,CAAC,KAAa,EAAE,UAAsB,EAAE;IAChE,OAAO,IAAI,GAAG,CAAC,KAAK,EAAE,EAAE,cAAc,EAAE,WAAW,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;AACpE,CAAC"}

package/lib/index.test.d.ts

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

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

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

package/lib/index.test.js

@@ -0,0 +1,48 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Context, createBot, richContext } from "./index.js";
+const api = {};
+const messageUpdate = {
+    update_id: 1,
+    message: {
+        message_id: 5,
+        date: 0,
+        chat: { id: 42, type: "private" },
+        from: { id: 7, is_bot: false, first_name: "u" },
+        text: "hi",
+    },
+};
+test("richContext is a real Context with payload fields and shortcut methods", () => {
+    const ctx = richContext(api, messageUpdate, "message");
+    assert.ok(ctx instanceof Context); // satisfies the middleware's Context contract
+    assert.equal(ctx.text, "hi"); // core getter still works
+    assert.equal(ctx.message_id, 5); // payload field grafted on
+    assert.equal(typeof ctx.react, "function"); // autogen shortcut grafted on
+    assert.equal(typeof ctx.send, "function"); // core method preserved
+});
+test("createBot returns a Bot wired with the rich factory", () => {
+    const bot = createBot("123:abc");
+    assert.equal(typeof bot.handleUpdate, "function");
+    assert.equal(typeof bot.start, "function");
+});
+// compile-time proof: the typed routers narrow ctx to the rich per-update context.
+// (this block only builds if the types actually flow — it's the type test.)
+test("typed routers expose the generated shortcuts + narrowed fields", () => {
+    const bot = createBot("123:abc");
+    bot.on("message:text", (ctx) => {
+        const t = ctx.text; // narrowed to string by the filter query
+        void t;
+        void ctx.react; // MessageContext shortcut — typed, not just runtime
+        void ctx.editText;
+    });
+    bot.on("callback_query:data", (ctx) => {
+        void ctx.answer; // CallbackQueryContext shortcut
+    });
+    bot.command("start", (ctx) => {
+        const args = ctx.args;
+        void args;
+        void ctx.react; // command handlers get the message context
+    });
+    assert.ok(bot);
+});
+//# sourceMappingURL=index.test.js.map

package/lib/index.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.test.js","sourceRoot":"","sources":["../src/index.test.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,MAAM,GAAG,GAAG,EAAW,CAAC;AAExB,MAAM,aAAa,GAAG;IACrB,SAAS,EAAE,CAAC;IACZ,OAAO,EAAE;QACR,UAAU,EAAE,CAAC;QACb,IAAI,EAAE,CAAC;QACP,IAAI,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE;QACjC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE;QAC/C,IAAI,EAAE,IAAI;KACV;CACQ,CAAC;AAEX,IAAI,CAAC,wEAAwE,EAAE,GAAG,EAAE;IACnF,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAEvD,MAAM,CAAC,EAAE,CAAC,GAAG,YAAY,OAAO,CAAC,CAAC,CAAC,8CAA8C;IAEjF,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,0BAA0B;IACxD,MAAM,CAAC,KAAK,CAAE,GAAwC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,2BAA2B;IAClG,MAAM,CAAC,KAAK,CAAC,OAAQ,GAAoC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,8BAA8B;IAC5G,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC,CAAC,wBAAwB;AACpE,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAChE,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAEjC,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,YAAY,EAAE,UAAU,CAAC,CAAC;IAClD,MAAM,CAAC,KAAK,CAAC,OAAO,GAAG,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,mFAAmF;AACnF,4EAA4E;AAC5E,IAAI,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC3E,MAAM,GAAG,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC;IAEjC,GAAG,CAAC,EAAE,CAAC,cAAc,EAAE,CAAC,GAAG,EAAE,EAAE;QAC9B,MAAM,CAAC,GAAW,GAAG,CAAC,IAAI,CAAC,CAAC,yCAAyC;QAErE,KAAK,CAAC,CAAC;QACP,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,oDAAoD;QACpE,KAAK,GAAG,CAAC,QAAQ,CAAC;IACnB,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,EAAE,CAAC,qBAAqB,EAAE,CAAC,GAAG,EAAE,EAAE;QACrC,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,gCAAgC;IAClD,CAAC,CAAC,CAAC;IAEH,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAa,GAAG,CAAC,IAAI,CAAC;QAEhC,KAAK,IAAI,CAAC;QACV,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,2CAA2C;IAC5D,CAAC,CAAC,CAAC;IAEH,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC;AAChB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,12 +1,57 @@
 {
   "name": "yaebal",
-  "version": "0.0.1-fake",
-  "description": "Yet Another tElegram Bot Api Library",
-  "main": "index.js",
-  "keywords": [],
-  "author": "neverlane",
-  "license": "WTFPL",
+  "version": "0.0.1",
+  "description": "yaebal — batteries-included Telegram Bot API framework: core + auto-generated contexts + the common plugins, one import.",
+  "type": "module",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "import": "./lib/index.js"
+    }
+  },
+  "files": [
+    "lib",
+    "src"
+  ],
+  "dependencies": {
+    "@yaebal/core": "0.0.1",
+    "@yaebal/contexts": "0.0.1",
+    "@yaebal/keyboard": "0.0.1",
+    "@yaebal/filters": "0.0.1",
+    "@yaebal/session": "0.0.1",
+    "@yaebal/callback-data": "0.0.1",
+    "@yaebal/fmt": "0.0.1",
+    "@yaebal/i18n": "0.0.1",
+    "@yaebal/web": "0.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "latest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "bot-api",
+    "framework",
+    "typescript",
+    "yaebal"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neverlane/yaebal",
+    "directory": "packages/yaebal"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test lib"
   }
 }

package/src/index.test.ts

@@ -0,0 +1,61 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Context, createBot, richContext } from "./index.js";
+
+const api = {} as never;
+
+const messageUpdate = {
+	update_id: 1,
+	message: {
+		message_id: 5,
+		date: 0,
+		chat: { id: 42, type: "private" },
+		from: { id: 7, is_bot: false, first_name: "u" },
+		text: "hi",
+	},
+} as never;
+
+test("richContext is a real Context with payload fields and shortcut methods", () => {
+	const ctx = richContext(api, messageUpdate, "message");
+
+	assert.ok(ctx instanceof Context); // satisfies the middleware's Context contract
+
+	assert.equal(ctx.text, "hi"); // core getter still works
+	assert.equal((ctx as Context & { message_id: number }).message_id, 5); // payload field grafted on
+	assert.equal(typeof (ctx as Context & { react: unknown }).react, "function"); // autogen shortcut grafted on
+	assert.equal(typeof ctx.send, "function"); // core method preserved
+});
+
+test("createBot returns a Bot wired with the rich factory", () => {
+	const bot = createBot("123:abc");
+
+	assert.equal(typeof bot.handleUpdate, "function");
+	assert.equal(typeof bot.start, "function");
+});
+
+// compile-time proof: the typed routers narrow ctx to the rich per-update context.
+// (this block only builds if the types actually flow — it's the type test.)
+test("typed routers expose the generated shortcuts + narrowed fields", () => {
+	const bot = createBot("123:abc");
+
+	bot.on("message:text", (ctx) => {
+		const t: string = ctx.text; // narrowed to string by the filter query
+
+		void t;
+		void ctx.react; // MessageContext shortcut — typed, not just runtime
+		void ctx.editText;
+	});
+
+	bot.on("callback_query:data", (ctx) => {
+		void ctx.answer; // CallbackQueryContext shortcut
+	});
+
+	bot.command("start", (ctx) => {
+		const args: string[] = ctx.args;
+
+		void args;
+		void ctx.react; // command handlers get the message context
+	});
+	
+	assert.ok(bot);
+});

package/src/index.ts

@@ -0,0 +1,143 @@
+/**
+ * yaebal — the batteries-included entry point (the gramio idea). re-exports the
+ * core engine, the auto-generated contexts, and the common plugins so a bot needs
+ * a single import. `createBot()` wires the rich per-update contexts (with their
+ * auto-generated shortcut methods) onto every update via the core context factory.
+ */
+
+export * from "@yaebal/core";
+export * from "@yaebal/contexts";
+export { and, filters, not, or } from "@yaebal/filters";
+export { html, htmlToEntities, md, mdToEntities } from "@yaebal/fmt";
+export { InlineKeyboard, Keyboard } from "@yaebal/keyboard";
+export { callbackData } from "@yaebal/callback-data";
+export { session } from "@yaebal/session";
+export { i18n } from "@yaebal/i18n";
+export { deleteWebhook, serve, setWebhook, webhook } from "@yaebal/web";
+
+import { type ContextByType, contextFor } from "@yaebal/contexts";
+import {
+	type BotOptions,
+	Context,
+	Bot as CoreBot,
+	type FileReader,
+	type FilterQuery,
+	type Filtered,
+	type Middleware,
+} from "@yaebal/core";
+
+type ContextFactory = NonNullable<BotOptions["contextFactory"]>;
+
+/**
+ * auto-detect the runtime and read a local file into bytes — so `media.path()` just
+ * works on node, bun and deno from a single `yaebal` import, no platform package to pick.
+ * the `node:fs` import is dynamic AND guarded by the node check, so on edge/web it's
+ * never reached (or bundled): there the last branch throws and you send
+ * `media.buffer()` / `media.url()` instead. this is the whole "platform layer" — yaebal
+ * needs no mtcute-style `setPlatform()` global because Telegram Bot API is just fetch + this.
+ */
+const autoReadFile: FileReader = async (path) => {
+	const g = globalThis as {
+		Deno?: { readFile(p: string): Promise<Uint8Array> };
+		Bun?: { file(p: string): { bytes(): Promise<Uint8Array> } };
+		process?: { versions?: { node?: string } };
+	};
+
+	if (g.Deno) return g.Deno.readFile(path);
+	if (g.Bun) return g.Bun.file(path).bytes();
+	if (g.process?.versions?.node) return (await import("node:fs/promises")).readFile(path);
+	
+	throw new Error(
+		"yaebal: no filesystem in this runtime — send media.buffer()/url() instead of media.path().",
+	);
+};
+
+/**
+ * build a base {@link Context} and graft the auto-generated shortcut methods
+ * (`react`, `editText`, `pin`, …) of the matching per-update context onto it.
+ * core's own methods (`send`/`reply`/…) win; the rest are added.
+ */
+export const richContext: ContextFactory = (api, update, updateType) => {
+	const ctx = new Context({ api, update, updateType });
+	const rich = contextFor(updateType as keyof ContextByType, api, update);
+	const target = ctx as unknown as Record<string, unknown>;
+
+	// payload fields — define as own props so they SHADOW Context's getters
+	// (plain assignment throws on getter-only props like `chat`)
+	for (const [key, value] of Object.entries(rich)) {
+		Object.defineProperty(ctx, key, {
+			value,
+			writable: true,
+			enumerable: true,
+			configurable: true,
+		});
+	}
+
+	// shortcut methods (`react`, `editText`, …) and accessors (`senderId`, `isPM`, …)
+	// live UP the generated prototype chain — the immediate prototype is just
+	// `{ constructor }`, the sugar sits on its bases. walk the whole chain and graft
+	// every member core lacks; core's own methods/getters (`send`, `chat`, …) win, and
+	// a more-derived override wins over a base one (we never overwrite an own prop).
+	for (
+		let proto = Object.getPrototypeOf(rich);
+		proto && proto !== Object.prototype;
+		proto = Object.getPrototypeOf(proto)
+	) {
+		for (const [name, desc] of Object.entries(Object.getOwnPropertyDescriptors(proto))) {
+			if (name === "constructor" || name in target) continue;
+
+			if (typeof desc.value === "function") {
+				target[name] = (desc.value as (...args: unknown[]) => unknown).bind(ctx);
+			} else if (desc.get) {
+				Object.defineProperty(ctx, name, {
+					get: desc.get.bind(ctx),
+					enumerable: true,
+					configurable: true,
+				});
+			}
+		}
+	}
+
+	return ctx;
+};
+
+// map a filter query to the matching generated context (the part before `:`).
+type QueryHead<Q extends string> = Q extends `${infer H}:${string}` ? H : Q;
+type RichFor<Q extends string> = QueryHead<Q> extends keyof ContextByType
+	? ContextByType[QueryHead<Q>]
+	: Record<never, never>;
+
+/**
+ * a {@link CoreBot} whose routers type the handler context to the matching
+ * per-update generated context — so `ctx.react`, `ctx.editText`, … are typed
+ * (not just present at runtime). `on("message:text")` → `MessageContext`,
+ * `on("callback_query:data")` → `CallbackQueryContext`, etc.
+ */
+export class Bot<C extends Context = Context> extends CoreBot<C> {
+	constructor(token: string, options: BotOptions = {}) {
+		// auto-detecting file reader as the default; an explicit `readFile` still wins
+		super(token, { readFile: autoReadFile, ...options });
+	}
+
+	override on<Q extends FilterQuery>(
+		query: Q,
+		...handlers: Middleware<Filtered<C, Q> & RichFor<Q>>[]
+	): this {
+		return super.on(query, ...(handlers as unknown as Middleware<Filtered<C, Q>>[]));
+	}
+
+	override command(
+		name: string,
+		...handlers: Middleware<C & { command: string; args: string[] } & ContextByType["message"]>[]
+	): this {
+		return super.command(
+			name,
+			...(handlers as unknown as Middleware<C & { command: string; args: string[] }>[]),
+		);
+	}
+}
+
+/** create a bot whose handlers receive the rich auto-generated context — typed and at runtime. */
+export function createBot(token: string, options: BotOptions = {}): Bot {
+	return new Bot(token, { contextFactory: richContext, ...options });
+}