@yaebal/prompt 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,13 @@
+# @yaebal/prompt
+
+handles the message that answers a prompt. may call `ctx.prompt` again to chain.
+
+## install
+
+```sh
+pnpm add @yaebal/prompt
+```
+
+---
+
+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,22 @@
+import type { Context, FormatResult, Message, Plugin } from "@yaebal/core";
+/** handles the message that answers a prompt. may call `ctx.prompt` again to chain. */
+export type PromptHandler = (ctx: Context) => unknown | Promise<unknown>;
+export interface PromptControl {
+    /** send `question`, then run `handler` on the next message in this chat. */
+    prompt(question: string | FormatResult, handler: PromptHandler, extra?: Record<string, unknown>): Promise<Message>;
+}
+export interface PromptOptions {
+    /** prompt key for an update. defaults to per-chat (`ctx.chat.id`). */
+    getKey?: (ctx: Context) => string | undefined;
+}
+/**
+ * prompt plugin: `ctx.prompt(question, handler)` sends a question and runs the
+ * handler on the next message — no suspended promise, so it is safe under the
+ * sequential update loop. pending handlers are in-memory (lost on restart).
+ *
+ * the answering message is consumed, so a user typing `/menu` instead of an
+ * answer has it eaten by the pending handler — check for an escape in the handler
+ * if that matters.
+ */
+export declare function prompt(options?: PromptOptions): Plugin<Context, PromptControl>;
+//# 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,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAE3E,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzE,MAAM,WAAW,aAAa;IAC7B,4EAA4E;IAC5E,MAAM,CACL,QAAQ,EAAE,MAAM,GAAG,YAAY,EAC/B,OAAO,EAAE,aAAa,EACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,OAAO,CAAC,OAAO,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC7B,sEAAsE;IACtE,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,MAAM,GAAG,SAAS,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CAAC,OAAO,GAAE,aAAkB,GAAG,MAAM,CAAC,OAAO,EAAE,aAAa,CAAC,CAmClF"}

package/lib/index.js

@@ -0,0 +1,36 @@
+/**
+ * prompt plugin: `ctx.prompt(question, handler)` sends a question and runs the
+ * handler on the next message — no suspended promise, so it is safe under the
+ * sequential update loop. pending handlers are in-memory (lost on restart).
+ *
+ * the answering message is consumed, so a user typing `/menu` instead of an
+ * answer has it eaten by the pending handler — check for an escape in the handler
+ * if that matters.
+ */
+export function prompt(options = {}) {
+    const pending = new Map();
+    const getKey = options.getKey ?? ((ctx) => ctx.chat?.id?.toString());
+    const plugin = (composer) => composer
+        .derive((ctx) => ({
+        prompt: (question, handler, extra = {}) => {
+            const key = getKey(ctx);
+            if (key !== undefined)
+                pending.set(key, handler);
+            return ctx.send(question, extra);
+        },
+    }))
+        .use(async (ctx, next) => {
+        const key = getKey(ctx);
+        if (key !== undefined && ctx.message) {
+            const handler = pending.get(key);
+            if (handler) {
+                pending.delete(key);
+                await handler(ctx);
+                return; // consumed
+            }
+        }
+        await next();
+    });
+    return plugin;
+}
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA;;;;;;;;GAQG;AACH,MAAM,UAAU,MAAM,CAAC,UAAyB,EAAE;IACjD,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;IACjD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,CAAC,GAAY,EAAE,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;IAE9E,MAAM,MAAM,GAAmC,CAAC,QAAQ,EAAE,EAAE,CAC3D,QAAQ;SACN,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACjB,MAAM,EAAE,CACP,QAA+B,EAC/B,OAAsB,EACtB,QAAiC,EAAE,EAClC,EAAE;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;YACxB,IAAI,GAAG,KAAK,SAAS;gBAAE,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAEjD,OAAO,GAAG,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;KACD,CAAC,CAAC;SACF,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;QACxB,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAExB,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,CAAC,OAAO,EAAE,CAAC;YACtC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAEjC,IAAI,OAAO,EAAE,CAAC;gBACb,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBACpB,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;gBAEnB,OAAO,CAAC,WAAW;YACpB,CAAC;QACF,CAAC;QACD,MAAM,IAAI,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IAEL,OAAO,MAAM,CAAC;AACf,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,72 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Composer, Context } from "@yaebal/core";
+import { prompt } from "./index.js";
+const noop = async () => { };
+const entry = (c) => c.toMiddleware();
+function fakeApi() {
+    const sent = [];
+    const api = {
+        sendMessage(p) {
+            sent.push(String(p.text));
+            return Promise.resolve({ message_id: 1 });
+        },
+    };
+    return { api, sent };
+}
+const msgCtx = (api, text, chatId) => new Context({
+    api,
+    update: {
+        update_id: 1,
+        message: {
+            message_id: 1,
+            date: 0,
+            chat: { id: chatId, type: "private" },
+            from: { id: chatId, is_bot: false, first_name: "u" },
+            text,
+        },
+    },
+    updateType: "message",
+});
+test("prompt runs its handler on the next message and consumes it", async () => {
+    const { api } = fakeApi();
+    let answer = "";
+    let fellThrough = 0;
+    const mw = entry(new Composer()
+        .install(prompt())
+        .command("ask", (ctx) => ctx.prompt("name?", (c) => {
+        answer = c.text ?? "";
+    }))
+        .on("message:text", () => {
+        fellThrough++;
+    }));
+    await mw(msgCtx(api, "/ask", 1), noop); // asks
+    await mw(msgCtx(api, "Bob", 1), noop); // answers
+    assert.equal(answer, "Bob");
+    assert.equal(fellThrough, 0); // the answer was consumed
+});
+test("prompts chain", async () => {
+    const { api, sent } = fakeApi();
+    const got = [];
+    const mw = entry(new Composer().install(prompt()).command("ask", (ctx) => ctx.prompt("first?", (c1) => {
+        got.push(c1.text ?? "");
+        return c1.prompt("second?", (c2) => {
+            got.push(c2.text ?? "");
+        });
+    })));
+    await mw(msgCtx(api, "/ask", 1), noop);
+    await mw(msgCtx(api, "a", 1), noop);
+    await mw(msgCtx(api, "b", 1), noop);
+    assert.deepEqual(got, ["a", "b"]);
+    assert.deepEqual(sent, ["first?", "second?"]);
+});
+test("an unrelated message with no pending prompt falls through", async () => {
+    const { api } = fakeApi();
+    let seen = "";
+    const mw = entry(new Composer().install(prompt()).on("message:text", (ctx) => {
+        seen = ctx.text;
+    }));
+    await mw(msgCtx(api, "hello", 2), noop);
+    assert.equal(seen, "hello");
+});
+//# 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":"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"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@yaebal/prompt",
+  "version": "0.0.1",
+  "description": "yaebal prompt plugin — ask a question and handle the next message.",
+  "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"
+  },
+  "devDependencies": {
+    "@types/node": "latest"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "telegram",
+    "telegram-bot",
+    "yaebal",
+    "prompt"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/neverlane/yaebal",
+    "directory": "packages/prompt"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "node --test lib"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,103 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+import { Composer, Context, type Middleware } from "@yaebal/core";
+import { type PromptControl, prompt } from "./index.js";
+
+const noop = async () => {};
+const entry = <C extends Context>(c: Composer<C>) =>
+	c.toMiddleware() as unknown as Middleware<Context>;
+
+function fakeApi() {
+	const sent: string[] = [];
+	const api = {
+		sendMessage(p: Record<string, unknown>) {
+			sent.push(String(p.text));
+			return Promise.resolve({ message_id: 1 });
+		},
+	} as never;
+
+	return { api, sent };
+}
+
+const msgCtx = (api: never, text: string, chatId: number) =>
+	new Context({
+		api,
+		update: {
+			update_id: 1,
+			message: {
+				message_id: 1,
+				date: 0,
+				chat: { id: chatId, type: "private" },
+				from: { id: chatId, is_bot: false, first_name: "u" },
+				text,
+			},
+		} as never,
+		updateType: "message",
+	});
+
+type Ctx = Context & PromptControl;
+
+test("prompt runs its handler on the next message and consumes it", async () => {
+	const { api } = fakeApi();
+
+	let answer = "";
+	let fellThrough = 0;
+
+	const mw = entry(
+		new Composer<Context>()
+			.install(prompt())
+			.command("ask", (ctx) =>
+				(ctx as Ctx).prompt("name?", (c) => {
+					answer = c.text ?? "";
+				}),
+			)
+			.on("message:text", () => {
+				fellThrough++;
+			}),
+	);
+
+	await mw(msgCtx(api, "/ask", 1), noop); // asks
+	await mw(msgCtx(api, "Bob", 1), noop); // answers
+
+	assert.equal(answer, "Bob");
+	assert.equal(fellThrough, 0); // the answer was consumed
+});
+
+test("prompts chain", async () => {
+	const { api, sent } = fakeApi();
+
+	const got: string[] = [];
+	const mw = entry(
+		new Composer<Context>().install(prompt()).command("ask", (ctx) =>
+			(ctx as Ctx).prompt("first?", (c1) => {
+				got.push(c1.text ?? "");
+
+				return (c1 as Ctx).prompt("second?", (c2) => {
+					got.push(c2.text ?? "");
+				});
+			}),
+		),
+	);
+
+	await mw(msgCtx(api, "/ask", 1), noop);
+	await mw(msgCtx(api, "a", 1), noop);
+	await mw(msgCtx(api, "b", 1), noop);
+
+	assert.deepEqual(got, ["a", "b"]);
+	assert.deepEqual(sent, ["first?", "second?"]);
+});
+
+test("an unrelated message with no pending prompt falls through", async () => {
+	const { api } = fakeApi();
+
+	let seen = "";
+
+	const mw = entry(
+		new Composer<Context>().install(prompt()).on("message:text", (ctx) => {
+			seen = ctx.text;
+		}),
+	);
+	await mw(msgCtx(api, "hello", 2), noop);
+	
+	assert.equal(seen, "hello");
+});

package/src/index.ts

@@ -0,0 +1,64 @@
+import type { Context, FormatResult, Message, Plugin } from "@yaebal/core";
+
+/** handles the message that answers a prompt. may call `ctx.prompt` again to chain. */
+export type PromptHandler = (ctx: Context) => unknown | Promise<unknown>;
+
+export interface PromptControl {
+	/** send `question`, then run `handler` on the next message in this chat. */
+	prompt(
+		question: string | FormatResult,
+		handler: PromptHandler,
+		extra?: Record<string, unknown>,
+	): Promise<Message>;
+}
+
+export interface PromptOptions {
+	/** prompt key for an update. defaults to per-chat (`ctx.chat.id`). */
+	getKey?: (ctx: Context) => string | undefined;
+}
+
+/**
+ * prompt plugin: `ctx.prompt(question, handler)` sends a question and runs the
+ * handler on the next message — no suspended promise, so it is safe under the
+ * sequential update loop. pending handlers are in-memory (lost on restart).
+ *
+ * the answering message is consumed, so a user typing `/menu` instead of an
+ * answer has it eaten by the pending handler — check for an escape in the handler
+ * if that matters.
+ */
+export function prompt(options: PromptOptions = {}): Plugin<Context, PromptControl> {
+	const pending = new Map<string, PromptHandler>();
+	const getKey = options.getKey ?? ((ctx: Context) => ctx.chat?.id?.toString());
+
+	const plugin: Plugin<Context, PromptControl> = (composer) =>
+		composer
+			.derive((ctx) => ({
+				prompt: (
+					question: string | FormatResult,
+					handler: PromptHandler,
+					extra: Record<string, unknown> = {},
+				) => {
+					const key = getKey(ctx);
+					if (key !== undefined) pending.set(key, handler);
+
+					return ctx.send(question, extra);
+				},
+			}))
+			.use(async (ctx, next) => {
+				const key = getKey(ctx);
+				
+				if (key !== undefined && ctx.message) {
+					const handler = pending.get(key);
+
+					if (handler) {
+						pending.delete(key);
+						await handler(ctx);
+
+						return; // consumed
+					}
+				}
+				await next();
+			});
+
+	return plugin;
+}