@monixlite/grammy-scenes 1.1.0 → 1.2.0

package/README.md

@@ -41,9 +41,6 @@ const bot = new Bot("..."); {
     bot.use(session({
         initial: () => ({
             scene: null,
-            step: null,
-            name: null,
-            age: null,
         }),
     }));
 };
@@ -179,6 +176,7 @@ Each scene step is described by the following structure:
 
     callbacks: {
         enter?: (ctx) => Promise<void>,
+        update?: (ctx) => Promise<SceneResult | void>,
         message?: (ctx) => Promise<SceneResult | void>,
         query?: Array<{
             match: RegExp,
@@ -207,20 +205,22 @@ Details:
 
 ---
 
-### callbacks.message(ctx)
+### callbacks.update(ctx)
 
-Triggered when a text message is received while the step is active.
+Triggered on **any update** while the step is active.
 
-The return value controls navigation:
+Details:
 
-• `undefined` or `"next"` → move to the next step
-• `"stop" | "exit" | "!"` → terminate the scene
-• `"<" | "prev"` → move to the previous step
-• `">" | "next"` → move to the next step
-• `"^step"` → jump to a step within the current scene
-• `"^scene:step"` → jump to another scene
-• `{ step: "..." }` → jump to a specific step
-• `{ scene: { title, step } }` → jump to another scene
+• Executed before `message` and `query`
+• Receives the raw grammY context
+• Can be used for global step logic (timeouts, guards, media handling)
+• Return value controls navigation using standard SceneResult rules
+
+---
+
+### callbacks.message(ctx)
+
+Triggered when a text message is received while the step is active.
 
 ---
 
@@ -305,6 +305,19 @@ Transitions are determined by the value returned from callbacks.
 
 ---
 
+### All Transitions
+
+• `undefined` or `"next"` → move to the next step
+• `"stop" | "exit" | "!"` → terminate the scene
+• `"<" | "prev"` → move to the previous step
+• `">" | "next"` → move to the next step
+• `"^step"` → jump to a step within the current scene
+• `"^scene:step"` → jump to another scene
+• `{ step: "..." }` → jump to a specific step
+• `{ scene: { title, step } }` → jump to another scene
+
+---
+
 ### Relative Transitions
 
 • `undefined` / `"next"` / `">"` → next step

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@monixlite/grammy-scenes",
-    "version": "1.1.0",
+    "version": "1.2.0",
     "description": "Scene middleware for grammY with step-based navigation",
     "main": "src/index.js",
     "type": "commonjs",

package/src/index.js

@@ -171,14 +171,24 @@ class ScenesMiddleware {
         };
 
 
-        if (ctx.message && current.callbacks.message) {
+        if (ctx?.update && current.callbacks?.update) {
+            const result = await current.callbacks.update(ctx);
+
+            return await this.handle(ctx, scene, result);
+        };
+
+
+        if (ctx?.message && current.callbacks?.message) {
+            if (ctx?.message?.caption) ctx.message.text ??= ctx.message.caption;
+
+
             const result = await current.callbacks.message(ctx);
 
             return await this.handle(ctx, scene, result);
         };
 
 
-        if (ctx.callbackQuery && current.callbacks.query) {
+        if (ctx?.callbackQuery && current.callbacks?.query) {
             const data = ctx.callbackQuery.data;