stitchkit 0.100.2 → 0.100.3

package/dist/telegram/screens/runtime.d.ts

@@ -0,0 +1,133 @@
+/**
+ * The screens of one bot, as grammY middleware.
+ *
+ * `bot.use(screens)` takes the presses whose `callback_data` carries this
+ * runtime's prefix and the messages a shown screen takes as input; every other
+ * update goes to the next handler untouched, and it is handed on outside the
+ * chat's queue. `screens.open(ctx, screen)` shows a screen from a command or a
+ * deep link; `screens.button(link(…))` puts a link to a screen into a message
+ * the screens do not own — a notification.
+ *
+ * Every chat is handled one update at a time: read the chat's record, resolve
+ * the screen, render, reconcile against what the chat shows, carry the plan
+ * out, write the record. The record is written after Telegram has answered, so
+ * it never names a message that was not sent; a crash in between leaves the
+ * chat ahead of its record, and the next press is handled as a press on a
+ * message the record does not know. Two processes serving one chat — builds
+ * overlapping during a release, a webhook fan-out — are not serialised: the
+ * last write wins.
+ */
+import type { Context, MiddlewareFn, MiddlewareObj } from 'grammy';
+import type { InlineKeyboardButton } from 'grammy/types';
+import { type DisplayRequest } from './display.js';
+import type { ExecutionReport, ScreenApi } from './execute.js';
+import type { ScreenOutcomeBuilders } from './outcome.js';
+import { type DeclaredScreen, type ScreenRegistry } from './registry.js';
+import type { AnyTelegramScreen, ScreenHandlerResult, ScreenLinkArgs } from './screen-types.js';
+import { type ScreenChatState, type TelegramScreenStorage } from './state.js';
+import type { ScreenButton } from './view.js';
+/** Why a press could not be answered by the screen it names. */
+export type ScreenStaleReason = 'malformed' | 'forged' | 'inaccessible' | 'unknown-token' | 'unknown-screen' | 'invalid-params' | 'unknown-action' | 'invalid-input';
+export type ScreenTrigger = 'open' | 'press' | 'input';
+export interface ScreenStaleContext<C extends Context> extends ScreenOutcomeBuilders {
+    readonly ctx: C;
+    readonly reason: ScreenStaleReason;
+}
+export interface ScreenErrorContext<C extends Context> extends ScreenOutcomeBuilders {
+    readonly ctx: C;
+    readonly trigger: ScreenTrigger;
+}
+/**
+ * What happened, for the application's journal. Never carries message text:
+ * screens are named by their path template, messages by id.
+ */
+export type ScreenEvent = {
+    readonly type: 'transition';
+    readonly trigger: ScreenTrigger;
+    readonly chat: string;
+    /** The screen shown before, as its path template; absent when none was. */
+    readonly from: string | undefined;
+    readonly to: string;
+    readonly durationMs: number;
+    readonly report: ExecutionReport;
+}
+/** A stored record did not match this release's schema and was set aside. */
+ | {
+    readonly type: 'state-discarded';
+    readonly chat: string;
+}
+/** Messages Telegram would not delete — an expired remark, the user's input. */
+ | {
+    readonly type: 'message-kept';
+    readonly chat: string;
+    readonly messageIds: readonly number[];
+}
+/**
+ * Deleting expired remarks on their timer failed — no update was there to
+ * carry the error. The chat's next update sweeps them again.
+ */
+ | {
+    readonly type: 'sweep-failed';
+    readonly chat: string;
+    readonly error: unknown;
+};
+export interface TelegramScreensConfig<C extends Context> {
+    readonly screens: readonly DeclaredScreen<C>[];
+    /** Where each chat's screen survives a restart — any grammY `StorageAdapter`. */
+    readonly storage: TelegramScreenStorage;
+    /** The storage key of a chat's record. Default: `screens:<chat id>`, apart from grammY sessions. */
+    readonly chatKey?: (ctx: C) => string | undefined;
+    /** What every screen button's `callback_data` starts with. Default `"~"`. */
+    readonly callbackPrefix?: string;
+    /** Which chats screens answer in. Default `'private'`: in a group any member could press or type. */
+    readonly chats?: 'private' | 'all';
+    /** A press this bot no longer understands, or that no button carried. Default: answered silently. */
+    readonly onStale?: (c: ScreenStaleContext<C>) => ScreenHandlerResult;
+    /**
+     * A load, action or input that threw. Its outcome is shown instead; without
+     * it the press is answered silently and the error reaches `bot.catch`.
+     */
+    readonly onError?: (error: unknown, c: ScreenErrorContext<C>) => ScreenHandlerResult;
+    readonly onEvent?: (event: ScreenEvent) => void;
+    /** Epoch milliseconds, for expiring notices. Default `Date.now`. */
+    readonly clock?: () => number;
+}
+export interface OpenOptions {
+    /** The view the chat showed: kept as it is (default) or deleted. */
+    readonly previous?: 'keep' | 'delete';
+}
+export type OpenArgs<TScreen> = ScreenLinkArgs<TScreen> extends [params: infer P] ? [params: P, options?: OpenOptions] : ScreenLinkArgs<TScreen> extends [params?: infer P] ? [params?: P, options?: OpenOptions] : never;
+export interface TelegramScreens<C extends Context> extends MiddlewareObj<C> {
+    middleware(): MiddlewareFn<C>;
+    /** Show a screen as a new message at the bottom of the chat. */
+    open<TScreen extends AnyTelegramScreen>(ctx: C, screen: TScreen, ...args: OpenArgs<TScreen>): Promise<void>;
+    /** A link for a message the screens do not own; pressing it opens the screen below. */
+    button(link: ScreenButton): InlineKeyboardButton.CallbackButton;
+    /** Cancel pending expiry timers; remarks left behind are swept on the chat's next update. */
+    close(): void;
+}
+/** What dispatch and display share for one bot. */
+export interface ScreensRuntime<C extends Context> {
+    readonly registry: ScreenRegistry<C>;
+    readonly config: TelegramScreensConfig<C>;
+    readonly prefix: string;
+    readonly clock: () => number;
+    chatKey(ctx: C): string | undefined;
+    answers(ctx: C): boolean;
+    /** Run `task` alone in the chat; a call from inside the chat's own task runs inline. */
+    exclusive<T>(ctx: C, chat: string, task: () => Promise<T>): Promise<T>;
+    readState(chat: string): Promise<ScreenChatState>;
+    display(request: DisplayRequest<C>): Promise<void>;
+    /** `open` showed a screen for this update. */
+    markOpened(ctx: C): void;
+    /** Whether `open` showed a screen for this update — from inside its handler, its navigation stands. */
+    openedDuring(ctx: C): boolean;
+    scheduleSweep(api: ScreenApi, chat: string, chatId: number, delayMs: number): void;
+    emit(event: ScreenEvent): void;
+}
+export interface OwnedScreensRuntime<C extends Context> extends ScreensRuntime<C> {
+    /** Expiry timers not yet fired, so `close()` can cancel them. */
+    readonly timers: Set<ReturnType<typeof setTimeout>>;
+}
+export declare function createScreensRuntime<C extends Context>(config: TelegramScreensConfig<C>): OwnedScreensRuntime<C>;
+//# sourceMappingURL=runtime.d.ts.map

package/dist/telegram/screens/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/runtime.ts"],"names":[],"mappings":"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"}

package/dist/telegram/screens/screen-types.d.ts

@@ -0,0 +1,130 @@
+/**
+ * The types a screen is declared with, and the loose shape the runtime drives.
+ *
+ * A declared screen is typed end to end — its params come from its path (or a
+ * params schema), its data from its loads, its action buttons from its
+ * actions — and the runtime sees none of that. It holds a
+ * {@link ScreenDefinition}: closures over the typed declaration that take raw,
+ * untrusted params and input, validate them, and only then call the
+ * application. The one crossing from raw to typed is the params schema, which
+ * runs on every resolution.
+ */
+import type { Context } from 'grammy';
+import type { Message } from 'grammy/types';
+import type { ActionValue } from './callback-codec.js';
+import type { TelegramText } from './html.js';
+import type { ScreenOutcome, ScreenOutcomeBuilders } from './outcome.js';
+import type { ScreenPath } from './path.js';
+import type { ButtonLabel, ScreenButton, ScreenViewResult } from './view.js';
+/** A param value after its schema: text, or a number a schema produced. */
+export type ScreenParamValue = string | number;
+export type ScreenParams = Readonly<Record<string, ScreenParamValue>>;
+declare const noInput: unique symbol;
+/** An action declared without an input schema. */
+export type NoActionInput = typeof noInput;
+/** Action name → what its button takes (`NoActionInput` when nothing). */
+export type ScreenActions = Readonly<Record<string, unknown>>;
+export type MaybePromise<TValue> = TValue | Promise<TValue>;
+/** What a handler may answer with; nothing — a body with no `return` — is `stay()`. */
+export type ScreenHandlerResult = MaybePromise<ScreenOutcome | undefined> | MaybePromise<void>;
+export interface ScreenLoadContext<C extends Context, P extends ScreenParams, D> extends ScreenOutcomeBuilders {
+    /** The grammY context of the update being answered. */
+    readonly ctx: C;
+    /** Params from the button that was pressed — user input, validated by the params schema. */
+    readonly params: P;
+    /** What the enclosing group loaded; `undefined` outside a group. */
+    readonly data: D;
+}
+export interface ScreenActionContext<C extends Context, P extends ScreenParams, D, I> extends ScreenOutcomeBuilders {
+    readonly ctx: C;
+    readonly params: P;
+    /** What this screen's loads returned for this press. */
+    readonly data: D;
+    /** The button's input, parsed by the action's schema. */
+    readonly input: I;
+}
+/** An outcome after a message: there is no press to answer, so no toast. */
+export type ScreenInputOutcomeBuilders = Omit<ScreenOutcomeBuilders, 'toast'>;
+export interface ScreenInputContext<C extends Context, P extends ScreenParams, D> extends ScreenInputOutcomeBuilders {
+    readonly ctx: C;
+    readonly params: P;
+    readonly data: D;
+    /** The message as Telegram sent it. It is never stored. */
+    readonly message: Message;
+    /** Its text, or its caption, or `''`. */
+    readonly text: string;
+    /** Show a "working on it" message; it is removed when the handler ends, however it ends. */
+    pending(content: TelegramText): Promise<void>;
+}
+/** The action buttons of a screen, one factory per declared action. */
+export type ScreenActionButtons<A extends ScreenActions> = {
+    readonly [K in keyof A]: A[K] extends NoActionInput ? (label: ButtonLabel) => ScreenButton : (label: ButtonLabel, input: A[K]) => ScreenButton;
+};
+export interface ScreenViewContext<C extends Context, P extends ScreenParams, D, A extends ScreenActions> {
+    readonly ctx: C;
+    readonly params: P;
+    readonly data: D;
+    readonly act: ScreenActionButtons<A>;
+}
+/** Message kinds a screen can take as input. */
+export type ScreenInputKind = 'text' | 'rich' | 'photo' | 'video' | 'animation' | 'document' | 'audio' | 'voice' | 'video_note' | 'sticker' | 'location' | 'contact';
+export interface ScreenInputOptions {
+    /** Leave the user's message in the chat. Default: removed before the handler runs. */
+    readonly keepMessage?: boolean;
+}
+/** Why raw params or input did not become a screen. */
+export type ScreenRefusal = 'invalid-params' | 'unknown-action' | 'invalid-input';
+/** A screen resolved for one update: params parsed, data loaded. */
+export interface ResolvedScreen {
+    readonly params: ScreenParams;
+    render(): ScreenViewResult;
+    runAction(action: string, input: Readonly<Record<string, ActionValue>> | undefined): Promise<ScreenOutcome | undefined | ScreenRefusal>;
+    input(kind: ScreenInputKind): ResolvedScreenInput | undefined;
+}
+export interface ResolvedScreenInput {
+    readonly keepMessage: boolean;
+    handle(message: Message, pending: (content: TelegramText) => Promise<void>): Promise<ScreenOutcome | undefined>;
+}
+/** The loose screen the runtime drives. Methods, so a narrower context still assigns. */
+export interface ScreenDefinition<C extends Context> {
+    readonly path: ScreenPath;
+    readonly id: string;
+    readonly explicitId: boolean;
+    /** Some load — the screen's own or a group's — runs before it: its params are checked. */
+    readonly guarded: boolean;
+    readonly actions: readonly string[];
+    readonly inputKinds: readonly ScreenInputKind[];
+    /** The screen takes this kind and leaves the user's message in the chat. */
+    keepsInput(kind: ScreenInputKind): boolean;
+    /** The params pass the schemas — no load runs. */
+    acceptsParams(params: Readonly<Record<string, ActionValue>>): boolean;
+    resolve(ctx: C, params: Readonly<Record<string, ActionValue>>): Promise<ResolvedScreen | ScreenOutcome | 'invalid-params'>;
+}
+/** A declared screen. The type parameters exist for the declaration's callers. */
+export declare class TelegramScreen<C extends Context, P extends ScreenParams, D, A extends ScreenActions> {
+    readonly definition: ScreenDefinition<C>;
+    readonly '~types'?: {
+        readonly ctx: C;
+        readonly params: P;
+        readonly data: D;
+        readonly actions: A;
+    };
+    constructor(definition: ScreenDefinition<C>);
+    get path(): string;
+}
+/** Any declared screen, whatever its context, params, data and actions. */
+export type AnyTelegramScreen = TelegramScreen<Context, ScreenParams, unknown, ScreenActions>;
+/**
+ * The params argument of a link or a `go`: required exactly when the path has
+ * params, and refused when it has none — a param the path does not name would
+ * make the button unreadable.
+ */
+export type ScreenLinkArgs<TScreen> = TScreen extends {
+    readonly '~types'?: {
+        readonly params: infer P;
+    };
+} ? keyof P extends never ? [params?: {
+    readonly [name: string]: never;
+}] : [params: P] : never;
+export {};
+//# sourceMappingURL=screen-types.d.ts.map

package/dist/telegram/screens/screen-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen-types.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/screen-types.ts"],"names":[],"mappings":"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"}

package/dist/telegram/screens/screen.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Declaring screens: `tg.screen(path).load(…).action(…).on(…).view(…)`, and
+ * groups that share a path, params and a load.
+ *
+ * Every step narrows the types the next one sees, the way a Hono route or an
+ * Elysia handler does: the path names the params, `load` names the data, each
+ * `action` adds a typed button factory to `act`. `load` comes first or not at
+ * all — actions and input run after it and read what it returned — and `view`
+ * ends the declaration.
+ *
+ * A group is where access is checked once for everything under it:
+ * `tg.group('/bot/:botId', { params }).load(ownedBot)` runs its params schema and
+ * its load before every screen of the group — before its load, its actions and
+ * its input — and hands the screen what it loaded as `c.data`. Params arrive
+ * from a button, so they are user input; a screen with params and no load
+ * anywhere above it is refused when the bot is composed.
+ *
+ * What the runtime receives is a {@link ScreenDefinition}: closures over the
+ * typed declaration that take raw params and raw button input, validate them,
+ * and only then call the application's functions.
+ */
+import type { Context } from 'grammy';
+import { z } from 'zod';
+import { type ActionValue } from './callback-codec.js';
+import { ScreenOutcome } from './outcome.js';
+import { type ScreenPathParams } from './path.js';
+import type { MaybePromise, NoActionInput, ScreenActionContext, ScreenActions, ScreenHandlerResult, ScreenInputContext, ScreenInputKind, ScreenInputOptions, ScreenLoadContext, ScreenParams, ScreenViewContext } from './screen-types.js';
+import { TelegramScreen } from './screen-types.js';
+import { type ScreenViewResult } from './view.js';
+/** A schema for an action's input: an object whose fields a button can carry. */
+export type ActionInputSchema = z.ZodType<Readonly<Record<string, unknown>>, Readonly<Record<string, ActionValue | undefined>>>;
+/** A schema for the params a path segment adds: one field per `:name`. */
+export type ParamsSchemaFor<TPath extends string> = z.ZodType<{
+    readonly [K in keyof ScreenPathParams<TPath>]: string | number;
+}, {
+    readonly [K in keyof ScreenPathParams<TPath>]: unknown;
+}>;
+/**
+ * `S` when it accepts what it produces, else `never`. A button carries the
+ * parsed params, and the schema parses them again when it is pressed: a
+ * transform whose output its own input refuses — `z.string().transform(Number)`
+ * — would make every link to the screen stale. `z.coerce.number()` accepts it.
+ */
+export type AcceptsOwnOutput<S> = S extends z.ZodType<infer O, infer I> ? ([O] extends [I] ? S : never) : never;
+export interface ScopeOptions<TSchema> {
+    /** Validates (and may coerce) the params this path adds — they come from a button. */
+    readonly params?: TSchema;
+}
+export interface ScreenOptions<TSchema> extends ScopeOptions<TSchema> {
+    /**
+     * The id buttons carry instead of the path. Set it to keep buttons already
+     * sent working after the path is renamed. Default: derived from the path.
+     */
+    readonly id?: string;
+}
+/** What a scope — the root, or a group — hands the screens declared in it. */
+export interface ScopeCore<C extends Context, P extends ScreenParams, D> {
+    readonly prefix: string;
+    readonly paramNames: readonly string[];
+    readonly parseParams: (raw: Readonly<Record<string, ActionValue>>) => P | undefined;
+    readonly load: (ctx: C, params: P) => Promise<D | ScreenOutcome>;
+    readonly guarded: boolean;
+}
+interface HandlerBase<C extends Context, P extends ScreenParams, D> {
+    readonly ctx: C;
+    readonly params: P;
+    readonly data: D;
+}
+type ActionEntry<C extends Context, P extends ScreenParams, D> = (base: HandlerBase<C, P, D>, input: Readonly<Record<string, ActionValue>> | undefined) => Promise<ScreenOutcome | undefined | 'invalid-input'>;
+type InputEntry<C extends Context, P extends ScreenParams, D> = {
+    readonly keepMessage: boolean;
+    readonly handler: (c: ScreenInputContext<C, P, D>) => ScreenHandlerResult;
+};
+/** A screen after `load` (or without one): actions, input and the view. */
+export declare class ScreenBodyBuilder<C extends Context, P extends ScreenParams, D, A extends ScreenActions> {
+    protected readonly core: ScopeCore<C, P, D>;
+    protected readonly id: {
+        readonly value: string;
+        readonly explicit: boolean;
+    };
+    protected readonly actions: ReadonlyMap<string, ActionEntry<C, P, D>>;
+    protected readonly inputs: ReadonlyMap<ScreenInputKind, InputEntry<C, P, D>>;
+    constructor(core: ScopeCore<C, P, D>, id: {
+        readonly value: string;
+        readonly explicit: boolean;
+    }, actions: ReadonlyMap<string, ActionEntry<C, P, D>>, inputs: ReadonlyMap<ScreenInputKind, InputEntry<C, P, D>>);
+    /** A button handler. Its button is `act.<name>(label)`. */
+    action<N extends string>(name: N, handler: (c: ScreenActionContext<C, P, D, undefined>) => ScreenHandlerResult): ScreenBodyBuilder<C, P, D, A & {
+        readonly [K in N]: NoActionInput;
+    }>;
+    /** A button handler with typed input. Its button is `act.<name>(label, input)`. */
+    action<N extends string, S extends ActionInputSchema>(name: N, schema: S, handler: (c: ScreenActionContext<C, P, D, z.output<S>>) => ScreenHandlerResult): ScreenBodyBuilder<C, P, D, A & {
+        readonly [K in N]: z.input<S>;
+    }>;
+    /**
+     * Messages of these kinds, while this screen is shown. Other kinds, and
+     * commands, go to the next handler.
+     */
+    on(kinds: ScreenInputKind | readonly ScreenInputKind[], handler: (c: ScreenInputContext<C, P, D>) => ScreenHandlerResult, options?: ScreenInputOptions): ScreenBodyBuilder<C, P, D, A>;
+    /** What the chat shows. Ends the declaration. */
+    view(render: (c: ScreenViewContext<C, P, D, A>) => ScreenViewResult): TelegramScreen<C, P, D, A>;
+}
+/** A screen before `load`: it may still load data. */
+export declare class ScreenBuilder<C extends Context, P extends ScreenParams, D> extends ScreenBodyBuilder<C, P, D, Record<never, never>> {
+    /**
+     * The data this screen shows and its actions act on. Runs before every show,
+     * every action and every input, after the group's load, whose data it reads
+     * as `c.data`. Return an outcome instead of data to go somewhere else.
+     */
+    load<R>(fetch: (c: ScreenLoadContext<C, P, D>) => MaybePromise<R>): ScreenBodyBuilder<C, P, Exclude<R, ScreenOutcome>, Record<never, never>>;
+}
+/** Where screens are declared: the root, or a group of them. */
+export declare class ScreenScope<C extends Context, P extends ScreenParams, D> {
+    protected readonly core: ScopeCore<C, P, D>;
+    constructor(core: ScopeCore<C, P, D>);
+    /** A screen at `path`, relative to this scope. */
+    screen<TPath extends string>(path: TPath, options?: ScreenOptions<undefined>): ScreenBuilder<C, P & ScreenPathParams<TPath>, D>;
+    screen<TPath extends string, S extends ParamsSchemaFor<TPath>>(path: TPath, options: ScreenOptions<S> & {
+        readonly params: S & AcceptsOwnOutput<S>;
+    }): ScreenBuilder<C, P & z.output<S>, D>;
+    /** Screens that share a path prefix, its params and — once `load` is called — a load. */
+    group<TPath extends string>(path: TPath, options?: ScopeOptions<undefined>): ScreenGroupBuilder<C, P & ScreenPathParams<TPath>, D>;
+    group<TPath extends string, S extends ParamsSchemaFor<TPath>>(path: TPath, options: ScopeOptions<S> & {
+        readonly params: S & AcceptsOwnOutput<S>;
+    }): ScreenGroupBuilder<C, P & z.output<S>, D>;
+}
+/** A group before `load`. */
+export declare class ScreenGroupBuilder<C extends Context, P extends ScreenParams, D> extends ScreenScope<C, P, D> {
+    /**
+     * Runs before every screen of the group — before its load, its actions and
+     * its input. The place to check that the params are the user's to use.
+     */
+    load<R>(fetch: (c: ScreenLoadContext<C, P, D>) => MaybePromise<R>): ScreenScope<C, P, Exclude<R, ScreenOutcome>>;
+}
+/** The root: no prefix, no params, nothing loaded. */
+export declare function rootScopeCore<C extends Context>(): ScopeCore<C, Record<never, never>, undefined>;
+export {};
+//# sourceMappingURL=screen.d.ts.map

package/dist/telegram/screens/screen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screen.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/screen.ts"],"names":[],"mappings":"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"}

package/dist/telegram/screens/state.d.ts

@@ -0,0 +1,115 @@
+/**
+ * What a chat's screen is, kept where a restart cannot lose it.
+ *
+ * One record per chat: the view it shows — screen, params, the messages with
+ * their fingerprints, the tokens of buttons too long to carry their address —
+ * and the remarks waiting to expire. Nothing else: no history, no copy of
+ * application data. The record is read through its schema every time, because
+ * storage outlives releases and a record written by another version is not
+ * evidence of anything.
+ *
+ * The storage is grammY's own `StorageAdapter`, so any adapter a grammY bot
+ * already uses for sessions (`@grammyjs/storage-*`, `MemorySessionStorage` in
+ * tests, or ten lines over the application's database) keeps screens too.
+ */
+import type { StorageAdapter } from 'grammy';
+import { z } from 'zod';
+/**
+ * How much one chat's record may hold. A view is checked against these when it
+ * is rendered, before anything reaches Telegram: a record refused after the
+ * calls would leave the chat showing messages nothing tracks.
+ */
+export declare const RECORD_LIMITS: {
+    /** Messages in one view. */
+    messages: number;
+    /** Characters of a message key. */
+    key: number;
+    /** Buttons whose address is kept in the record, per view. */
+    tokens: number;
+    /** Characters of one kept address. */
+    tokenBody: number;
+    /** Remarks waiting to expire. */
+    remarks: number;
+};
+declare const ScreenViewStateSchema: z.ZodObject<{
+    screen: z.ZodString;
+    params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+    messages: z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        id: z.ZodNumber;
+        kind: z.ZodEnum<{
+            animation: "animation";
+            audio: "audio";
+            document: "document";
+            photo: "photo";
+            rich: "rich";
+            text: "text";
+            video: "video";
+        }>;
+        fingerprint: z.ZodNullable<z.ZodObject<{
+            content: z.ZodString;
+            media: z.ZodString;
+            markup: z.ZodString;
+        }, z.core.$strict>>;
+    }, z.core.$strict>>;
+    tokens: z.ZodRecord<z.ZodString, z.ZodString>;
+}, z.core.$strict>;
+export declare const ScreenChatStateSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    view: z.ZodNullable<z.ZodObject<{
+        screen: z.ZodString;
+        params: z.ZodRecord<z.ZodString, z.ZodUnion<readonly [z.ZodString, z.ZodNumber]>>;
+        messages: z.ZodArray<z.ZodObject<{
+            key: z.ZodString;
+            id: z.ZodNumber;
+            kind: z.ZodEnum<{
+                animation: "animation";
+                audio: "audio";
+                document: "document";
+                photo: "photo";
+                rich: "rich";
+                text: "text";
+                video: "video";
+            }>;
+            fingerprint: z.ZodNullable<z.ZodObject<{
+                content: z.ZodString;
+                media: z.ZodString;
+                markup: z.ZodString;
+            }, z.core.$strict>>;
+        }, z.core.$strict>>;
+        tokens: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, z.core.$strict>>;
+    expiring: z.ZodArray<z.ZodObject<{
+        id: z.ZodNumber;
+        at: z.ZodNumber;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ScreenChatState = z.infer<typeof ScreenChatStateSchema>;
+export type ScreenViewState = z.infer<typeof ScreenViewStateSchema>;
+/** Where chats' screen state survives a restart: grammY's storage contract. */
+export type TelegramScreenStorage = StorageAdapter<ScreenChatState>;
+export declare const emptyChatState: () => ScreenChatState;
+export interface ReadChatState {
+    readonly state: ScreenChatState;
+    /** The stored record did not match the schema and was set aside. */
+    readonly discarded: boolean;
+}
+/**
+ * The chat's record. A storage that fails to answer fails the update — reading
+ * "nothing" would send a message meant as input to whatever handles text next.
+ * A record that does not match this release's schema is set aside and
+ * reported: refusing it forever would leave the chat without screens.
+ */
+export declare function readChatState(storage: TelegramScreenStorage, key: string): Promise<ReadChatState>;
+export declare function writeChatState(storage: TelegramScreenStorage, key: string, state: ScreenChatState): Promise<void>;
+/**
+ * One chat at a time, in arrival order. Two presses in one chat are two
+ * read-render-write passes over one record; interleaved, the second would draw
+ * over messages the first is deleting. A chat's queue is dropped once it
+ * drains, and bounded while it has work: a chat that sends faster than
+ * Telegram answers is refused rather than queued without end.
+ */
+export type ChatQueue = <T>(key: string, task: () => Promise<T>) => Promise<T>;
+export declare function createChatQueue(maxPending: number): ChatQueue;
+export {};
+//# sourceMappingURL=state.d.ts.map

package/dist/telegram/screens/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AAC7C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,aAAa;IACxB,4BAA4B;IAC5B,QAAQ;IACR,mCAAmC;IACnC,GAAG;IACH,6DAA6D;IAC7D,MAAM;IACN,sCAAsC;IACtC,SAAS;IACT,iCAAiC;IACjC,OAAO;CACR,CAAC;AAeF,QAAA,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;kBAUhB,CAAC;AAMZ,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;kBAOvB,CAAC;AAEZ,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AACpE,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,+EAA+E;AAC/E,MAAM,MAAM,qBAAqB,GAAG,cAAc,CAAC,eAAe,CAAC,CAAC;AAEpE,eAAO,MAAM,cAAc,QAAO,eAIhC,CAAC;AAEH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,oEAAoE;IACpE,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;;;;GAKG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,qBAAqB,EAC9B,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;;;;GAMG;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC;AAE/E,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAiB7D"}

package/dist/telegram/screens/telegram-screens.d.ts

@@ -0,0 +1,18 @@
+/**
+ * `telegramScreens<Ctx>()` — where a bot's screens are declared and composed.
+ *
+ * The bot's grammY context type is named once; every screen, group and handler
+ * declared from here sees it. `create` checks the declaration as a whole — ids,
+ * paths, that every screen with params has a load above it — and returns the
+ * middleware.
+ */
+import type { Context } from 'grammy';
+import { type TelegramScreens, type TelegramScreensConfig } from './runtime.js';
+import { ScreenScope } from './screen.js';
+export declare class TelegramScreensRoot<C extends Context> extends ScreenScope<C, Record<never, never>, undefined> {
+    /** Compose the declared screens into grammY middleware. */
+    create(config: TelegramScreensConfig<C>): TelegramScreens<C>;
+}
+/** Declare a bot's screens against its grammY context type. */
+export declare function telegramScreens<C extends Context>(): TelegramScreensRoot<C>;
+//# sourceMappingURL=telegram-screens.d.ts.map

package/dist/telegram/screens/telegram-screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-screens.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/telegram-screens.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAKtC,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,WAAW,CAAC;AACnB,OAAO,EAAiB,WAAW,EAAE,MAAM,UAAU,CAAC;AAEtD,qBAAa,mBAAmB,CAAC,CAAC,SAAS,OAAO,CAAE,SAAQ,WAAW,CACrE,CAAC,EACD,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,EACpB,SAAS,CACV;IACC,2DAA2D;IAC3D,MAAM,CAAC,MAAM,EAAE,qBAAqB,CAAC,CAAC,CAAC,GAAG,eAAe,CAAC,CAAC,CAAC,CAE3D;CACF;AAED,+DAA+D;AAC/D,wBAAgB,eAAe,CAAC,CAAC,SAAS,OAAO,KAAK,mBAAmB,CAAC,CAAC,CAAC,CAE3E"}

package/dist/telegram/screens/test-chat-telegram.d.ts

@@ -0,0 +1,47 @@
+/**
+ * The Telegram side of the test chat: the messages it keeps and how it answers
+ * the Bot API calls screens make.
+ *
+ * It keeps the rules screens depend on: an edit that changes nothing is
+ * refused as "message is not modified", a deleted message cannot be edited or
+ * deleted again, a text message has no caption to edit, a media message no
+ * text.
+ */
+import type { Chat, InlineKeyboardMarkup, Message, User } from 'grammy/types';
+export type TestMessageKind = 'text' | 'rich' | 'photo' | 'video' | 'animation' | 'document' | 'audio';
+export interface StoredMessage {
+    id: number;
+    from: 'bot' | 'user';
+    kind: TestMessageKind;
+    text: string;
+    media: string | undefined;
+    rich: unknown;
+    markup: InlineKeyboardMarkup | undefined;
+    deleted: boolean;
+}
+export type TestChatPeer = Chat.PrivateChat | Chat.GroupChat | Chat.SupergroupChat;
+export interface FakeTelegramIdentity {
+    readonly chat: TestChatPeer;
+    readonly botUser: User;
+    readonly user: User;
+}
+export interface FakeTelegramRefusal {
+    readonly ok: false;
+    readonly error_code: number;
+    readonly description: string;
+}
+export interface FakeTelegram {
+    /** Every message the chat has had, deleted ones marked. */
+    readonly stored: StoredMessage[];
+    /** Press answers — the toasts — in order. */
+    readonly answers: string[];
+    /** A message still in the chat. */
+    find(id: unknown): StoredMessage | undefined;
+    asTelegram(message: StoredMessage): Message;
+    /** A Bot API call answered the way Telegram would. */
+    answer(method: string, payload: Readonly<Record<string, unknown>>): unknown;
+    refuse(description: string, errorCode?: number): FakeTelegramRefusal;
+    nextMessageId(): number;
+}
+export declare function createFakeTelegram({ chat, botUser, user, }: FakeTelegramIdentity): FakeTelegram;
+//# sourceMappingURL=test-chat-telegram.d.ts.map

package/dist/telegram/screens/test-chat-telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-chat-telegram.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/test-chat-telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,cAAc,CAAC;AAK9E,MAAM,MAAM,eAAe,GACvB,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,WAAW,GACX,UAAU,GACV,OAAO,CAAC;AAEZ,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,KAAK,GAAG,MAAM,CAAC;IACrB,IAAI,EAAE,eAAe,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,cAAc,CAAC;AAEnF,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,YAAY;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,CAAC;IACjC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAC3B,mCAAmC;IACnC,IAAI,CAAC,EAAE,EAAE,OAAO,GAAG,aAAa,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC;IAC5C,sDAAsD;IACtD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC;IAC5E,MAAM,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC;IACrE,aAAa,IAAI,MAAM,CAAC;CACzB;AAkID,wBAAgB,kBAAkB,CAAC,EACjC,IAAI,EACJ,OAAO,EACP,IAAI,GACL,EAAE,oBAAoB,GAAG,YAAY,CAgHrC"}