@xlsft/grammy-reactive 0.7.34

package/dist/lib/state/events/onclick.event.js

@@ -0,0 +1,36 @@
+import { globalButtonCallbacks } from "~/utils";
+import { createErrorMessageState } from "../lifecycle/error.state";
+/**
+ * Dispatches registered reactive button callbacks for callback queries.
+ *
+ * This internal middleware resolves callback payloads against the
+ * button callback registry and executes the matching handler within
+ * its owning lifecycle session.
+ *
+ * If no registered callback exists, middleware control is delegated
+ * directly to the next handler.
+ *
+ * On handler failure, the owning lifecycle session is transitioned
+ * into its error fallback state.
+ *
+ * @param {ReactiveContext} ctx - The reactive Telegram context.
+ * @param {NextFunction} next - The next middleware in the pipeline.
+ * @returns {Promise<void>}
+ */
+export async function createOnClickEvent(ctx, next) {
+    if (ctx.callbackQuery?.data === undefined || !globalButtonCallbacks[ctx.callbackQuery.data])
+        return await next();
+    const id = ctx.callbackQuery.data.match(/^::(.*?)::/)?.[1] ?? null;
+    if (!id)
+        return await next();
+    try {
+        await globalButtonCallbacks[ctx.callbackQuery.data](ctx);
+        await ctx.answerCallbackQuery();
+        await next();
+    }
+    catch (e) {
+        await createErrorMessageState(id, ctx, e);
+        console.error(e);
+    }
+}
+//# sourceMappingURL=onclick.event.js.map

package/dist/lib/state/events/onclick.event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onclick.event.js","sourceRoot":"","sources":["../../../../src/lib/state/events/onclick.event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAA;AAIlE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,GAAoB,EAAE,IAAkB;IAC7E,IAAI,GAAG,CAAC,aAAa,EAAE,IAAI,KAAK,SAAS,IAAI,CAAC,qBAAqB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC;QAAE,OAAO,MAAM,IAAI,EAAE,CAAA;IAChH,MAAM,EAAE,GAAG,GAAG,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAA;IAClE,IAAI,CAAC,EAAE;QAAE,OAAO,MAAM,IAAI,EAAE,CAAA;IAC5B,IAAI,CAAC;QACD,MAAM,qBAAqB,CAAC,GAAG,CAAC,aAAa,CAAC,IAAI,CAAE,CAAC,GAAG,CAAC,CAAA;QACzD,MAAM,GAAG,CAAC,mBAAmB,EAAE,CAAA;QAC/B,MAAM,IAAI,EAAE,CAAA;IAChB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAU,CAAC,CAAA;QAClD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;AACL,CAAC"}

package/dist/lib/state/hooks/callback.hooks.d.ts

@@ -0,0 +1,2 @@
+export declare function useCallback<T extends (...args: any[]) => any>(callback: T, deps?: unknown[]): T;
+//# sourceMappingURL=callback.hooks.d.ts.map

package/dist/lib/state/hooks/callback.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"callback.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/callback.hooks.ts"],"names":[],"mappings":"AAEA,wBAAgB,WAAW,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAE/F"}

package/dist/lib/state/hooks/create.d.ts

@@ -0,0 +1,7 @@
+export declare const createHook: () => {
+    runtime: import("../../../types/hooks.types").HookRuntime;
+    key: string;
+    hooks: unknown[];
+    index: number;
+};
+//# sourceMappingURL=create.d.ts.map

package/dist/lib/state/hooks/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/create.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,UAAU;;;;;CAOtB,CAAA"}

package/dist/lib/state/hooks/create.hooks.d.ts

@@ -0,0 +1,29 @@
+import type { BotEventHooks, BotHandlerLifecycleInstance, BotMessageHandler } from "~/types/lib.types";
+import type { ReactiveContext } from "~/types/plugin.types";
+/**
+ * Creates the reactive hook bindings for a mounted message lifecycle session.
+ *
+ * This internal factory builds the concrete hook runtime implementation
+ * used by reactive message handlers, including state persistence and
+ * rerender-triggering setters.
+ *
+ * Hook state is bound to the provided lifecycle session ID and uses
+ * stable call-order indexing semantics.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {BotMessageHandler<C>} handler - The reactive handler owning the hooks.
+ * @param {BotHandlerLifecycleInstance<C>} state - The active lifecycle controller.
+ * @returns {BotEventHooks} The concrete reactive hook bindings.
+ *
+ * @see {@link BotEventHooks}
+ */
+export declare function createHooks<C extends ReactiveContext>({ id, ctx, handler, state, controller }: {
+    id: string;
+    ctx: C;
+    handler: BotMessageHandler<C>;
+    state: BotHandlerLifecycleInstance<C>;
+    controller?: AbortController;
+}): BotEventHooks;
+//# sourceMappingURL=create.hooks.d.ts.map

package/dist/lib/state/hooks/create.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/create.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGvG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE;IAC5F,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAC;IACtC,UAAU,CAAC,EAAE,eAAe,CAAC;CAChC,GAAG,aAAa,CAoBhB"}

package/dist/lib/state/hooks/create.hooks.js

@@ -0,0 +1,38 @@
+import { getHook } from "./get.hooks";
+import { setHook } from "./set.hooks";
+/**
+ * Creates the reactive hook bindings for a mounted message lifecycle session.
+ *
+ * This internal factory builds the concrete hook runtime implementation
+ * used by reactive message handlers, including state persistence and
+ * rerender-triggering setters.
+ *
+ * Hook state is bound to the provided lifecycle session ID and uses
+ * stable call-order indexing semantics.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {BotMessageHandler<C>} handler - The reactive handler owning the hooks.
+ * @param {BotHandlerLifecycleInstance<C>} state - The active lifecycle controller.
+ * @returns {BotEventHooks} The concrete reactive hook bindings.
+ *
+ * @see {@link BotEventHooks}
+ */
+export function createHooks({ id, ctx, handler, state, controller }) {
+    let i = 0;
+    function useState(initial) {
+        const index = i++;
+        const value = getHook(id, index, () => initial);
+        const setValue = async (v) => {
+            const newValue = typeof v === "function"
+                ? v(getHook(id, index, () => initial))
+                : v;
+            setHook(id, index, newValue);
+            await state.rerender();
+        };
+        return [value, setValue];
+    }
+    return { useState };
+}
+//# sourceMappingURL=create.hooks.js.map

package/dist/lib/state/hooks/create.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.hooks.js","sourceRoot":"","sources":["../../../../src/lib/state/hooks/create.hooks.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,WAAW,CAA4B,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAM3F;IACG,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,SAAS,QAAQ,CAAI,OAAU;QAC3B,MAAM,KAAK,GAAG,CAAC,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,OAAO,CAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QAEnD,MAAM,QAAQ,GAAG,KAAK,EAAE,CAAuB,EAAE,EAAE;YAC/C,MAAM,QAAQ,GAAG,OAAO,CAAC,KAAK,UAAU;gBACpC,CAAC,CAAE,CAAoB,CAAC,OAAO,CAAI,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;gBAC7D,CAAC,CAAC,CAAC,CAAC;YAER,OAAO,CAAI,EAAE,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;YAChC,MAAM,KAAK,CAAC,QAAQ,EAAE,CAAA;QAC1B,CAAC,CAAC;QAEF,OAAO,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC7B,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,CAAC;AACxB,CAAC"}

package/dist/lib/state/hooks/effect.hooks.d.ts

@@ -0,0 +1,5 @@
+import type { EffectCleanup } from "~/types/hooks.types";
+export declare function useEffect(effect: () => EffectCleanup | Promise<EffectCleanup>, deps?: unknown[]): void;
+export declare function flushEffects(): Promise<void>;
+export declare function cleanupEffects(): Promise<void>;
+//# sourceMappingURL=effect.hooks.d.ts.map

package/dist/lib/state/hooks/effect.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"effect.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/effect.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAInF,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,IAAI,CAyBtG;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAclD;AAED,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAYpD"}

package/dist/lib/state/hooks/get.hooks.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Reads a hook value from the lifecycle hook registry.
+ *
+ * Hook state is addressed by:
+ * - lifecycle session ID
+ * - stable hook slot index
+ *
+ * If the slot has not been initialized yet, the provided
+ * initializer is executed once and its result is stored
+ * for future rerender cycles.
+ *
+ * This provides React-like lazy first-render initialization
+ * semantics for stateful hooks.
+ *
+ * @template T
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {number} index - The stable hook slot index.
+ * @param {() => T} initializer - Lazy initializer for the hook value.
+ * @returns {T} The persisted hook value.
+ *
+ * @example
+ * const count = getHook(id, 0, () => 0);
+ */
+export declare function getHook<T>(id: string, index: number, initializer: () => T): T;
+//# sourceMappingURL=get.hooks.d.ts.map

package/dist/lib/state/hooks/get.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/get.hooks.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,GAAG,CAAC,CAQ7E"}

package/dist/lib/state/hooks/get.hooks.js

@@ -0,0 +1,33 @@
+import { globalHooks } from "~/utils";
+/**
+ * Reads a hook value from the lifecycle hook registry.
+ *
+ * Hook state is addressed by:
+ * - lifecycle session ID
+ * - stable hook slot index
+ *
+ * If the slot has not been initialized yet, the provided
+ * initializer is executed once and its result is stored
+ * for future rerender cycles.
+ *
+ * This provides React-like lazy first-render initialization
+ * semantics for stateful hooks.
+ *
+ * @template T
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {number} index - The stable hook slot index.
+ * @param {() => T} initializer - Lazy initializer for the hook value.
+ * @returns {T} The persisted hook value.
+ *
+ * @example
+ * const count = getHook(id, 0, () => 0);
+ */
+export function getHook(id, index, initializer) {
+    if (!globalHooks[id])
+        globalHooks[id] = [];
+    if (globalHooks[id][index] === undefined) {
+        globalHooks[id][index] = initializer();
+    }
+    return globalHooks[id][index];
+}
+//# sourceMappingURL=get.hooks.js.map

package/dist/lib/state/hooks/get.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.hooks.js","sourceRoot":"","sources":["../../../../src/lib/state/hooks/get.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,OAAO,CAAI,EAAU,EAAE,KAAa,EAAE,WAAoB;IACtE,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IAE3C,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;QACvC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,WAAW,EAAE,CAAC;IAC3C,CAAC;IAED,OAAO,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAM,CAAC;AACvC,CAAC"}

package/dist/lib/state/hooks/index.d.ts

@@ -0,0 +1,7 @@
+export { useState } from "./state.hooks";
+export { useMemo } from "./memo.hooks";
+export { useRef } from "./ref.hooks";
+export { useCallback } from "./callback.hooks";
+export { useReducer } from "./reducer.hooks";
+export { useEffect } from "./effect.hooks";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/state/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAA;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/lib/state/hooks/memo.hooks.d.ts

@@ -0,0 +1,2 @@
+export declare function useMemo<T>(factory: () => T, deps?: unknown[]): T;
+//# sourceMappingURL=memo.hooks.d.ts.map

package/dist/lib/state/hooks/memo.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memo.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/memo.hooks.ts"],"names":[],"mappings":"AAGA,wBAAgB,OAAO,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,CAUhE"}

package/dist/lib/state/hooks/reducer.hooks.d.ts

@@ -0,0 +1,3 @@
+import type { ReducerHook } from "~/types/hooks.types";
+export declare function useReducer<S, A>(reducer: ReducerHook<S, A>, initialState: S): [S, (action: A) => Promise<void>];
+//# sourceMappingURL=reducer.hooks.d.ts.map

package/dist/lib/state/hooks/reducer.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/reducer.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGvD,wBAAgB,UAAU,CAAC,CAAC,EAAE,CAAC,EAC3B,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC1B,YAAY,EAAE,CAAC,GAChB,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAQnC"}

package/dist/lib/state/hooks/ref.hooks.d.ts

@@ -0,0 +1,4 @@
+export declare function useRef<T>(initial: T): {
+    current: T;
+};
+//# sourceMappingURL=ref.hooks.d.ts.map

package/dist/lib/state/hooks/ref.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ref.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/ref.hooks.ts"],"names":[],"mappings":"AAEA,wBAAgB,MAAM,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC;;EAEnC"}

package/dist/lib/state/hooks/reset.hooks.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Clears all stored hook state for a lifecycle session.
+ *
+ * This fully resets the hook registry bucket associated with the
+ * provided session ID by replacing it with a new empty hook array.
+ *
+ * Primarily used before rerender cycles to restart hook indexing
+ * and ensure deterministic React-like hook ordering.
+ *
+ * @param {string} id - The unique lifecycle session identifier.
+ *
+ * @example
+ * resetHooks(id);
+ */
+export declare function resetHooks(id: string): void;
+//# sourceMappingURL=reset.hooks.d.ts.map

package/dist/lib/state/hooks/reset.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/reset.hooks.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;GAaG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,QAEpC"}

package/dist/lib/state/hooks/reset.hooks.js

@@ -0,0 +1,19 @@
+import { globalHooks } from "~/utils";
+/**
+ * Clears all stored hook state for a lifecycle session.
+ *
+ * This fully resets the hook registry bucket associated with the
+ * provided session ID by replacing it with a new empty hook array.
+ *
+ * Primarily used before rerender cycles to restart hook indexing
+ * and ensure deterministic React-like hook ordering.
+ *
+ * @param {string} id - The unique lifecycle session identifier.
+ *
+ * @example
+ * resetHooks(id);
+ */
+export function resetHooks(id) {
+    globalHooks[id] = [];
+}
+//# sourceMappingURL=reset.hooks.js.map

package/dist/lib/state/hooks/reset.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reset.hooks.js","sourceRoot":"","sources":["../../../../src/lib/state/hooks/reset.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,UAAU,CAAC,EAAU;IACjC,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;AACzB,CAAC"}

package/dist/lib/state/hooks/set.hooks.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Stores a hook value in the persistent lifecycle hook state registry.
+ *
+ * Hook state is addressed by:
+ * - lifecycle session ID
+ * - hook call index
+ *
+ * If the hook storage bucket for the session does not yet exist,
+ * it is created lazily.
+ *
+ * This function is primarily used by the reactive hook runtime
+ * to persist stateful values between rerender cycles.
+ *
+ * @template T
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {number} index - The stable hook slot index.
+ * @param {T} value - The hook value to store.
+ *
+ * @example
+ * setHook(id, 0, count);
+ */
+export declare function setHook<T>(id: string, index: number, value: T): void;
+//# sourceMappingURL=set.hooks.d.ts.map

package/dist/lib/state/hooks/set.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/set.hooks.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,QAG7D"}

package/dist/lib/state/hooks/set.hooks.js

@@ -0,0 +1,28 @@
+import { globalHooks } from "~/utils";
+/**
+ * Stores a hook value in the persistent lifecycle hook state registry.
+ *
+ * Hook state is addressed by:
+ * - lifecycle session ID
+ * - hook call index
+ *
+ * If the hook storage bucket for the session does not yet exist,
+ * it is created lazily.
+ *
+ * This function is primarily used by the reactive hook runtime
+ * to persist stateful values between rerender cycles.
+ *
+ * @template T
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {number} index - The stable hook slot index.
+ * @param {T} value - The hook value to store.
+ *
+ * @example
+ * setHook(id, 0, count);
+ */
+export function setHook(id, index, value) {
+    if (!globalHooks[id])
+        globalHooks[id] = [];
+    globalHooks[id][index] = value;
+}
+//# sourceMappingURL=set.hooks.js.map

package/dist/lib/state/hooks/set.hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"set.hooks.js","sourceRoot":"","sources":["../../../../src/lib/state/hooks/set.hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEtC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,OAAO,CAAI,EAAU,EAAE,KAAa,EAAE,KAAQ;IAC1D,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;QAAE,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC;IAC3C,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;AACnC,CAAC"}

package/dist/lib/state/hooks/state.hooks.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Creates a persistent reactive state value for the current message handler.
+ *
+ * The state value is preserved across rerender cycles for the same
+ * mounted message session.
+ *
+ * The `initial` value is only used during the first render of the
+ * hook slot. On subsequent rerenders, the previously stored state
+ * value is returned instead.
+ *
+ * Calling the updater function stores the new value and immediately
+ * triggers an asynchronous message rerender.
+ *
+ * Supports both:
+ * - direct value updates
+ * - updater callbacks based on the previous state
+ *
+ * > Hook calls must remain in the same order between rerenders.
+ * > Changing the hook call order may corrupt state alignment.
+ *
+ * @template T
+ * @param {T} initial - The initial state value for the first render.
+ * @returns {[T, (val: T | ((prev: T) => T)) => Promise<void>]}
+ * A tuple containing the current state value and an async updater.
+ *
+ * @example
+ * const [count, setCount] = useState(0);
+ *
+ * @example
+ * await setCount(10);
+ *
+ * @example
+ * await setCount(prev => prev + 1);
+ *
+ * @example
+ * const Counter = defineMessageHandler(async ({ useState }) => {
+ *     const [count, setCount] = useState(0);
+ *
+ *     return (
+ *         <button
+ *             variant="callback"
+ *             onClick={() => setCount(prev => prev + 1)}
+ *         >
+ *             Count: {count}
+ *         </button>
+ *     );
+ * });
+ */
+export declare function useState<T>(initial: T): [T, (value: T | ((prev: T) => T)) => Promise<void>];
+//# sourceMappingURL=state.hooks.d.ts.map

package/dist/lib/state/hooks/state.hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.hooks.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/hooks/state.hooks.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC,CAe3F"}

package/dist/lib/state/lifecycle/error.state.d.ts

@@ -0,0 +1,7 @@
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare function createErrorMessageState<C extends ReactiveContext>({ id, ctx, error }: {
+    id: string;
+    ctx: C;
+    error: Error;
+}): Promise<void>;
+//# sourceMappingURL=error.state.d.ts.map

package/dist/lib/state/lifecycle/error.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.state.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/error.state.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAI3D,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE;IACzF,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,KAAK,EAAE,KAAK,CAAC;CAChB,iBA2BA"}

package/dist/lib/state/lifecycle/error.state.js

@@ -0,0 +1,55 @@
+import { InternalError } from "~/lib/render/components/Error";
+import { createMessageRender } from "~/lib/render/message.render";
+import { globalCurrentState, globalPreviousState } from "~/utils";
+/**
+ * Executes the error lifecycle transition for a mounted message session.
+ *
+ * When a lifecycle phase fails, this transition replaces the currently
+ * mounted Telegram message with an internal fallback error view.
+ *
+ * The existing mounted message is deleted first, after which the
+ * framework renders the built-in `InternalError` component and sends
+ * it as the new active lifecycle message.
+ *
+ * After a successful fallback render, the resulting error message
+ * snapshot becomes both the current and previous lifecycle state.
+ *
+ * If the session is no longer mounted, the operation exits silently.
+ *
+ * Errors occurring during the fallback rendering process are only
+ * logged to the console to avoid recursive error-state loops.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {Error} error - The original lifecycle error to render.
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await createErrorMessageState(id, ctx, error);
+ */
+export async function createErrorMessageState(id, ctx, error) {
+    try {
+        if (!globalCurrentState[id])
+            return;
+        await ctx.deleteMessage();
+        const data = await createMessageRender({
+            id,
+            method: createErrorMessageState.name,
+            jsx: await InternalError({ error, id }),
+            ctx,
+            other: {},
+        });
+        const message = await ctx.reply(data.text, data.other);
+        if (!message)
+            throw new Error("Failed to send error message");
+        globalCurrentState[id] = message;
+        if (!globalCurrentState[id])
+            throw new Error("No state rendered");
+        globalPreviousState[id] = globalCurrentState[id];
+    }
+    catch (e) {
+        console.error(e);
+    }
+}
+//# sourceMappingURL=error.state.js.map

package/dist/lib/state/lifecycle/error.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.state.js","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/error.state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAA;AAEjE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAA;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAA4B,EAAU,EAAE,GAAM,EAAE,KAAY;IACrG,IAAI,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAAE,OAAM;QACnC,MAAM,GAAG,CAAC,aAAa,EAAE,CAAA;QACzB,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC;YACnC,EAAE;YACF,MAAM,EAAE,uBAAuB,CAAC,IAAI;YACpC,GAAG,EAAE,MAAM,aAAa,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;YACvC,GAAG;YACH,KAAK,EAAE,EAAS;SACnB,CAAC,CAAA;QACF,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;QACtD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAA;QAC7D,kBAAkB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;QAChC,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACjE,mBAAmB,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;AACL,CAAC"}

package/dist/lib/state/lifecycle/mount.state.d.ts

@@ -0,0 +1,10 @@
+import type { BotHandlerLifecycleInstance, BotMessageHandler } from "src/types/lib.types";
+import type { ReactiveContext } from "src/types/plugin.types";
+export declare function createMountMessageState<C extends ReactiveContext>({ id, ctx, handler, controller, state }: {
+    id: string;
+    ctx: C;
+    handler: BotMessageHandler<C>;
+    controller?: AbortController;
+    state: BotHandlerLifecycleInstance<C>;
+}): Promise<void>;
+//# sourceMappingURL=mount.state.d.ts.map

package/dist/lib/state/lifecycle/mount.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.state.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/mount.state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAGzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAK7D,wBAAsB,uBAAuB,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;IAC9G,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAA;CACxC,iBA+CA"}

package/dist/lib/state/lifecycle/mount.state.js

@@ -0,0 +1,84 @@
+import { createMessageRender } from "src/lib/render/message.render";
+import { globalCurrentState, globalPreviousState } from "src/utils";
+import { createErrorMessageState } from "./error.state";
+/**
+ * Executes the mount lifecycle transition for a message session.
+ *
+ * This lifecycle step performs the initial handler execution,
+ * renders the JSX tree into a Telegram payload, sends the first
+ * message output, and stores the resulting message snapshot as
+ * the active lifecycle state.
+ *
+ * Supported mount flows:
+ * - plain text messages via `reply`
+ * - media captions with single photo via `replyWithPhoto`
+ * - media groups via `replyWithMediaGroup`
+ *
+ * After a successful mount, the created message snapshot is stored
+ * as both the current and previous lifecycle state.
+ *
+ * Supports both static and reactive handlers. When provided,
+ * lifecycle controls and hook bindings are injected into the
+ * handler execution context.
+ *
+ * Any runtime errors during mounting are delegated to the lifecycle
+ * error handler before being logged.
+ *
+ * @template {ReactiveContext} C
+ * @param {string} id - The unique lifecycle session identifier.
+ * @param {C} ctx - The bound reactive Telegram context.
+ * @param {BotStaticMessageHandler<C> | BotMessageHandler<C>} handler
+ * The handler used to generate the initial JSX tree.
+ * @param {BotHandlerLifecycleInstance<C>} [state]
+ * Optional lifecycle controller injected into the handler.
+ * @param {ReturnType<typeof createHooks<C>>} [hooks]
+ * Optional reactive hook bindings for stateful handlers.
+ * @returns {Promise<void>}
+ *
+ * @example
+ * await createMountMessageState(id, ctx, handler, state, hooks);
+ */
+export async function createMountMessageState({ id, ctx, handler, state, hooks }) {
+    try {
+        const element = await handler({ ctx, ...state || {}, ...hooks || {} });
+        const data = await createMessageRender({
+            id,
+            method: createMountMessageState.name,
+            jsx: element,
+            ctx,
+            other: {},
+        });
+        if (data.view === 'message') {
+            const message = await ctx.reply(data.text, data.other);
+            if (!message)
+                throw new Error("Failed to send message");
+            globalCurrentState[id] = message;
+        }
+        else if (data.view === 'caption') {
+            if (data.media.length > 2) {
+                const messages = await ctx.replyWithMediaGroup(data.media.slice(0, 10), data.other);
+                if (!messages || !messages[0])
+                    throw new Error("Failed to send media group");
+                globalCurrentState[id] = messages[0];
+            }
+            else if (data.media.length === 1) {
+                if (!data.photo)
+                    throw new Error("No photo provided for caption view");
+                const message = await ctx.replyWithPhoto(data.photo, data.other);
+                if (!message)
+                    throw new Error("Failed to send photo");
+                globalCurrentState[id] = message;
+            }
+            else
+                throw new TypeError("No media provided for caption view");
+        }
+        if (!globalCurrentState[id])
+            throw new Error("No state rendered");
+        globalPreviousState[id] = globalCurrentState[id];
+    }
+    catch (e) {
+        await createErrorMessageState(id, ctx, e);
+        console.error(e);
+    }
+}
+//# sourceMappingURL=mount.state.js.map

package/dist/lib/state/lifecycle/mount.state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.state.js","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/mount.state.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AACnE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAA;AACnE,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAA;AAGvD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAA4B,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAMxG;IACG,IAAI,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,EAAE,EAAE,GAAG,KAAK,IAAI,EAAE,EAAS,CAAC,CAAA;QAC7E,MAAM,IAAI,GAAG,MAAM,mBAAmB,CAAC;YACnC,EAAE;YACF,MAAM,EAAE,uBAAuB,CAAC,IAAI;YACpC,GAAG,EAAE,OAAO;YACZ,GAAG;YACH,KAAK,EAAE,EAAS;SACnB,CAAC,CAAA;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC1B,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;YACtD,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAA;YACvD,kBAAkB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;QACpC,CAAC;aAAM,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACxB,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBACnF,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAA;gBAC5E,kBAAkB,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAA;YACxC,CAAC;iBAAM,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACjC,IAAI,CAAC,IAAI,CAAC,KAAK;oBAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAA;gBACtE,MAAM,OAAO,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAA;gBAChE,IAAI,CAAC,OAAO;oBAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAA;gBACrD,kBAAkB,CAAC,EAAE,CAAC,GAAG,OAAO,CAAA;YACpC,CAAC;;gBAAM,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAA;QACpE,CAAC;QACD,IAAI,CAAC,kBAAkB,CAAC,EAAE,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAA;QACjE,mBAAmB,CAAC,EAAE,CAAC,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAA;IACpD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACT,MAAM,uBAAuB,CAAC,EAAE,EAAE,GAAG,EAAE,CAAU,CAAC,CAAA;QAClD,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IACpB,CAAC;AACL,CAAC"}

package/dist/lib/state/lifecycle/rerender.state.d.ts

@@ -0,0 +1,10 @@
+import type { BotHandlerLifecycleInstance, BotMessageHandler } from "~/types/lib.types";
+import type { ReactiveContext } from "~/types/plugin.types";
+export declare function createRerenderMessageState<C extends ReactiveContext>({ id, ctx, handler, controller, state }: {
+    id: string;
+    ctx: C;
+    handler: BotMessageHandler<C>;
+    controller?: AbortController;
+    state: BotHandlerLifecycleInstance<C>;
+}): Promise<void>;
+//# sourceMappingURL=rerender.state.d.ts.map

package/dist/lib/state/lifecycle/rerender.state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rerender.state.d.ts","sourceRoot":"","sources":["../../../../src/lib/state/lifecycle/rerender.state.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGvF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAM3D,wBAAsB,0BAA0B,CAAC,CAAC,SAAS,eAAe,EAAE,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE;IACjH,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,CAAC,CAAC;IACP,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAC9B,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,KAAK,EAAE,2BAA2B,CAAC,CAAC,CAAC,CAAA;CACxC,iBAyEA"}