@prajwalshete/telegram-plugin 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -6,7 +6,24 @@ and the package uses [semantic versioning](https://semver.org/) (0.x: minor vers
 Schema changes are listed under **Schema**. Upgrade by applying the new `reference.sql` statements (or
 regenerating your Drizzle migration); the plugin answers `schema_outdated` until the tables match.
 
-## 0.1.0 (unreleased)
+## 0.1.2 (2026-10-29)
+
+### Added
+
+- `ActionResult.outcome`: a Telegram HTML line that closes the tapped message. The message is edited to its own
+  text plus the line, and its keyboard is removed (for example "Approved by Asha · 29 Oct, 7:05 pm"). If Telegram
+  refuses the edit, the buttons are disabled as before.
+- Dialog steps `skipRest: true` (optional steps only): `/skip` there also skips the optional steps right after it, so
+  a run of photo steps ends with one `/skip`. The step's hint then reads "Send /skip when you are done."
+  (`bot.dialog.skip_rest_hint`, en + mr).
+
+No schema change. Wire identifiers (keyring salt, queue mark, sql symbol) unchanged.
+
+## 0.1.1 (2026-10-28)
+
+No code changes: first release published from GitHub Actions with npm Trusted Publishing.
+
+## 0.1.0 (2026-10-28)
 
 First release.
 

package/dist/contracts/events.d.ts

@@ -41,8 +41,8 @@ export declare const EVENT_STATUSES: readonly ["pending", "processing", "done",
 export declare const EventStatus: z.ZodEnum<{
   pending: "pending";
   failed: "failed";
-  processing: "processing";
   done: "done";
+  processing: "processing";
   ignored: "ignored";
 }>;
 export type EventStatus = z.infer<typeof EventStatus>;

package/dist/contracts/problems.d.ts

@@ -4,8 +4,6 @@ export declare const TELEGRAM_PROBLEM_CODES: readonly ["feature_disabled", "bot_
 /** Zod enum of {@link TELEGRAM_PROBLEM_CODES}. */
 export declare const TelegramProblemCode: z.ZodEnum<{
   timezone_invalid: "timezone_invalid";
-  recipient_empty: "recipient_empty";
-  schedule_rule_invalid: "schedule_rule_invalid";
   feature_disabled: "feature_disabled";
   bot_token_invalid: "bot_token_invalid";
   bot_token_mismatch: "bot_token_mismatch";
@@ -21,6 +19,8 @@ export declare const TelegramProblemCode: z.ZodEnum<{
   template_variable_unknown: "template_variable_unknown";
   provider_unknown: "provider_unknown";
   provider_forbidden: "provider_forbidden";
+  schedule_rule_invalid: "schedule_rule_invalid";
+  recipient_empty: "recipient_empty";
   send_text_rejected: "send_text_rejected";
   file_too_large: "file_too_large";
   renderer_unavailable: "renderer_unavailable";
@@ -59,8 +59,6 @@ export declare const TelegramProblem: z.ZodObject<{
   instance: z.ZodOptional<z.ZodString>;
   code: z.ZodEnum<{
     timezone_invalid: "timezone_invalid";
-    recipient_empty: "recipient_empty";
-    schedule_rule_invalid: "schedule_rule_invalid";
     feature_disabled: "feature_disabled";
     bot_token_invalid: "bot_token_invalid";
     bot_token_mismatch: "bot_token_mismatch";
@@ -76,6 +74,8 @@ export declare const TelegramProblem: z.ZodObject<{
     template_variable_unknown: "template_variable_unknown";
     provider_unknown: "provider_unknown";
     provider_forbidden: "provider_forbidden";
+    schedule_rule_invalid: "schedule_rule_invalid";
+    recipient_empty: "recipient_empty";
     send_text_rejected: "send_text_rejected";
     file_too_large: "file_too_large";
     renderer_unavailable: "renderer_unavailable";

package/dist/engine/actions/callback.js

@@ -1,3 +1,4 @@
+import { escapeHtml } from "../../core/html/escape.js";
 import { shortId } from "../../core/random.js";
 import { sql } from "../../ports/sql.js";
 import { pickVariant, renderInline } from "../content/render.js";
@@ -10,7 +11,8 @@ import { z } from "zod";
 const Markup = z.looseObject({ inline_keyboard: z.array(z.array(z.looseObject({ text: z.string() }))) });
 const ActionResultShape = z.looseObject({
 	text: z.string().optional(),
-	sql: z.array(z.unknown()).optional()
+	sql: z.array(z.unknown()).optional(),
+	outcome: z.string().optional()
 });
 /**
 * Cuts text to at most `max` UTF-16 code units without splitting a grapheme (emoji, combined Devanagari) or a
@@ -68,6 +70,32 @@ async function editMarkup(ctx, markup) {
 		return r.outcome.kind === "ok";
 	});
 }
+/** Telegram's text limit for an edited message. */
+const MESSAGE_TEXT_MAX = 4096;
+/**
+* Closes the tapped message with the action's outcome: its own text (the HTML the plugin sent, else the plain text
+* Telegram returned, escaped) + a blank line + `outcome`, and no keyboard. False when it could not be edited.
+*/
+async function closeWithOutcome(ctx, outcome) {
+	const msg = ctx.update.callback_query?.message;
+	if (!msg || msg.date === 0 || !ctx.chat) return false;
+	const row = await ctx.rt.db.first(sql`SELECT body_html FROM tg_delivery WHERE tenant = ${ctx.rt.tenant} AND chat_ref = ${ctx.chat.id}
+        AND tg_message_id = ${msg.message_id} AND kind = 'text' AND body_html IS NOT NULL ORDER BY part DESC LIMIT 1`);
+	const plain = msg.text;
+	const original = row?.body_html ?? (typeof plain === "string" ? escapeHtml(plain) : "");
+	const text = original ? `${original}\n\n${outcome}` : outcome;
+	if (text.length > MESSAGE_TEXT_MAX) return false;
+	return withToken(ctx.rt, ctx.bot, async (api) => {
+		const r = await settle(api.editMessageText({
+			chat_id: msg.chat.id,
+			message_id: msg.message_id,
+			text,
+			parse_mode: "HTML"
+		}));
+		if (r.outcome.kind !== "ok") ctx.rt.log.debug("tg.callback_edit_failed", { code: r.outcome.reason ?? r.outcome.kind });
+		return r.outcome.kind === "ok";
+	});
+}
 const isCallback = (b) => "callback_data" in b;
 /** Every callback button disabled; the tapped one shows the result. Fallback: no keyboard. */
 async function finishKeyboard(ctx, tokenId, label, original) {
@@ -185,7 +213,7 @@ async function runAction(ctx, def, token, actor, params) {
 			outcome: "done"
 		});
 		await answer(ctx, label);
-		await finishKeyboard(ctx, token.id, label, original);
+		if (!result.outcome || !await closeWithOutcome(ctx, result.outcome)) await finishKeyboard(ctx, token.id, label, original);
 		if (result.text) await ctx.reply(result.text);
 	} catch (e) {
 		rt.log.warn("tg.action_failed", {

package/dist/engine/dialogs/dialog.js

@@ -57,7 +57,7 @@ async function askStep(ctx, step, actor, state, prefix = "") {
 	const lines = [prefix, escapeHtml(text(step.ask, locale))];
 	if (step.input === "photo") lines.push(rt.i18n.t(locale, "bot.dialog.send_photo"));
 	if (step.input === "document") lines.push(rt.i18n.t(locale, "bot.dialog.send_document"));
-	if (step.optional) lines.push(rt.i18n.t(locale, "bot.dialog.skip_hint"));
+	if (step.optional) lines.push(rt.i18n.t(locale, step.skipRest ? "bot.dialog.skip_rest_hint" : "bot.dialog.skip_hint"));
 	lines.push(rt.i18n.t(locale, "bot.dialog.cancel_hint"));
 	const markup = choices.length > 0 ? { inline_keyboard: choices.map((c, i) => [{
 		text: c.l,
@@ -164,8 +164,11 @@ async function finish(ctx, def, starterActor, data) {
 		await ctx.reply(rt.i18n.t(locale, "bot.dialog.failed"));
 	}
 }
-/** Saves the answer and asks the next step, or finishes. */
-async function advance(ctx, def, row, data) {
+/**
+* Saves the answer and asks the next step, or finishes. `skipRest`: a `/skip` on a step with `skipRest` also passes
+* over the optional steps that directly follow it.
+*/
+async function advance(ctx, def, row, data, skipRest = false) {
 	const { rt } = ctx;
 	const actor = row.user_id ? await rt.actor.forUser(row.user_id) : await ctx.actor();
 	if (actor === null || !await hostCan(rt, actor, def.permission)) {
@@ -174,7 +177,12 @@ async function advance(ctx, def, row, data) {
 		return "handled";
 	}
 	const index = def.steps.findIndex((s) => s.id === row.step);
-	const next = def.steps.slice(index + 1).find((s) => !Object.hasOwn(data.state, s.id));
+	let after = def.steps.slice(index + 1);
+	if (skipRest) {
+		const firstRequired = after.findIndex((s) => !s.optional);
+		after = firstRequired === -1 ? [] : after.slice(firstRequired);
+	}
+	const next = after.find((s) => !Object.hasOwn(data.state, s.id));
 	if (!next) {
 		if (await endDialog(ctx, row)) await finish(ctx, def, actor, data);
 		return "handled";
@@ -291,7 +299,7 @@ async function dialogHandler(ctx) {
 				await ctx.reply(await ctx.t("bot.dialog.required"));
 				return "handled";
 			}
-			return advance(ctx, def, row, data);
+			return advance(ctx, def, row, data, step.skipRest);
 		}
 		await endDialog(ctx, row);
 		rt.log.info("tg.dialog", {

package/dist/engine/registry.d.ts

@@ -260,6 +260,12 @@ export interface ActionResult {
   text?: string;
   /** Host writes committed in the same `db.batch()` as the token update. */
   sql?: SqlFragment[];
+  /**
+   * Telegram HTML line that closes the tapped message: the message is edited to its own text plus this line and
+   * its keyboard is removed (for example "Approved by Asha · 29 Oct, 7:05 pm"). Without it the buttons are only
+   * disabled. If the edit fails, the plugin falls back to disabling the buttons.
+   */
+  outcome?: string;
 }
 /** A callback-button action (`defineAction`); buttons carry an opaque `a:<token>` callback. */
 export interface ActionDef<P = unknown, A = unknown, E = unknown> {
@@ -316,6 +322,8 @@ export interface DialogStepDef<A = unknown, E = unknown> {
   readonly input: z.ZodType | "text" | "photo" | "document";
   /** The user may `/skip` this step. */
   readonly optional: boolean;
+  /** `/skip` here also skips the optional steps right after it (for example "more photos" ended by one `/skip`). */
+  readonly skipRest: boolean;
   /** Choices offered as buttons, computed from the answers so far. */
   choices?(ctx: {
     actor: A;
@@ -333,6 +341,11 @@ export interface DialogStepInput<A, E = unknown> {
   input?: z.ZodType | "text" | "photo" | "document";
   /** May be skipped. Default false. */
   optional?: boolean;
+  /**
+   * `/skip` on this (optional) step also skips the optional steps that directly follow it, so a run of optional
+   * steps such as photo 1..3 ends with one `/skip`. Default false.
+   */
+  skipRest?: boolean;
   /** Choices offered as buttons. */
   choices?(ctx: {
     actor: A;

package/dist/engine/registry.js

@@ -150,11 +150,13 @@ function defineDialog(def) {
 		const input = s.input ?? "text";
 		if (typeof input !== "string" && !isZod(input)) fail(what, `step ${s.id}: input must be a Zod schema or a kind`);
 		const { choices } = s;
+		if (s.skipRest && !s.optional) fail(what, `step ${s.id}: skipRest needs optional: true`);
 		return Object.freeze({
 			id: s.id,
 			ask: s.ask,
 			input,
 			optional: s.optional ?? false,
+			skipRest: s.skipRest ?? false,
 			...choices ? { choices } : {}
 		});
 	});

package/dist/locales/en.js

@@ -283,6 +283,7 @@ var en_default = {
 			"invalid": "That does not look right. Try again.",
 			"cancel_hint": "Send /cancel to stop.",
 			"skip_hint": "Send /skip to leave this out.",
+			"skip_rest_hint": "Send /skip when you are done.",
 			"send_photo": "Send a photo.",
 			"send_document": "Send a file.",
 			"pick_choice": "Please pick one of the buttons.",

package/dist/locales/en.json

@@ -284,6 +284,7 @@
       "invalid": "That does not look right. Try again.",
       "cancel_hint": "Send /cancel to stop.",
       "skip_hint": "Send /skip to leave this out.",
+      "skip_rest_hint": "Send /skip when you are done.",
       "send_photo": "Send a photo.",
       "send_document": "Send a file.",
       "pick_choice": "Please pick one of the buttons.",

package/dist/locales/mr.js

@@ -283,6 +283,7 @@ var mr_default = {
 			"invalid": "हे बरोबर वाटत नाही. पुन्हा प्रयत्न करा.",
 			"cancel_hint": "थांबवण्यासाठी /cancel पाठवा.",
 			"skip_hint": "हे वगळण्यासाठी /skip पाठवा.",
+			"skip_rest_hint": "पूर्ण झाल्यावर /skip पाठवा.",
 			"send_photo": "एक फोटो पाठवा.",
 			"send_document": "एक फाइल पाठवा.",
 			"pick_choice": "कृपया एक बटण निवडा.",

package/dist/locales/mr.json

@@ -284,6 +284,7 @@
       "invalid": "हे बरोबर वाटत नाही. पुन्हा प्रयत्न करा.",
       "cancel_hint": "थांबवण्यासाठी /cancel पाठवा.",
       "skip_hint": "हे वगळण्यासाठी /skip पाठवा.",
+      "skip_rest_hint": "पूर्ण झाल्यावर /skip पाठवा.",
       "send_photo": "एक फोटो पाठवा.",
       "send_document": "एक फाइल पाठवा.",
       "pick_choice": "कृपया एक बटण निवडा.",

package/dist/server/version.d.ts

@@ -1,2 +1,2 @@
 /** Kept equal to package.json `version` (a test checks it). Reported by `GET /admin/meta`. */
-export declare const PLUGIN_VERSION = "0.1.0";
+export declare const PLUGIN_VERSION = "0.1.2";

package/dist/server/version.js

@@ -1,4 +1,4 @@
 // src/server/version.ts
 /** Kept equal to package.json `version` (a test checks it). Reported by `GET /admin/meta`. */
-const PLUGIN_VERSION = "0.1.0";
+const PLUGIN_VERSION = "0.1.2";
 export { PLUGIN_VERSION };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prajwalshete/telegram-plugin",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Telegram bot plugin (logic only, no UI) for Cloudflare Workers apps on Hono + D1 + R2: linking, commands, templates, schedules, reports, events, broadcasts, actions, dialogs and an AI send bridge.",
   "license": "MIT",
   "author": "Prajwal Shete",