stitchkit 0.100.2 → 0.101.0

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

@@ -0,0 +1,67 @@
+/**
+ * From what the chat shows to what it should show, in the fewest Bot API calls
+ * that keep the chat in order.
+ *
+ * Telegram orders messages by when they were sent, and a sent message cannot
+ * move. So a message is kept (and edited in place) only while the new view's
+ * order allows it: walking the new view top to bottom, a message whose key the
+ * chat already shows — below the last one kept, and editable into the new
+ * shape — is kept. The first message that cannot be kept is sent, and so is
+ * every message after it, because anything sent lands at the bottom; whatever
+ * the chat showed and was not kept is deleted.
+ *
+ * Editable means what the Bot API can do in place: text into text and rich
+ * into rich (`editMessageText`), text or rich into media and media into media
+ * of any kind (`editMessageMedia`). Media into text or rich, and text into rich
+ * or back, is a new message.
+ *
+ * The plan is data. Carrying it out — and recovering when Telegram refuses an
+ * edit it allowed a moment ago — is `execute`'s.
+ */
+import type { MessageFingerprint, OutgoingMessage, RenderedKind } from './render.js';
+/** A message the chat shows, as the chat's state remembers it. */
+export interface ShownMessage {
+    readonly key: string;
+    readonly id: number;
+    readonly kind: RenderedKind;
+    /** `null` for a message whose content is not known — one adopted from a press. */
+    readonly fingerprint: MessageFingerprint | null;
+}
+export interface EditParts {
+    readonly content: boolean;
+    readonly media: boolean;
+    readonly markup: boolean;
+}
+export type PlanStep = {
+    readonly op: 'keep';
+    readonly id: number;
+    readonly from: ShownMessage;
+    readonly message: OutgoingMessage;
+} | {
+    readonly op: 'edit';
+    readonly id: number;
+    readonly from: ShownMessage;
+    readonly message: OutgoingMessage;
+    readonly parts: EditParts;
+} | {
+    readonly op: 'send';
+    readonly message: OutgoingMessage;
+};
+export interface ViewPlan {
+    /** The new view, top to bottom: each message kept, edited or sent. */
+    readonly steps: readonly PlanStep[];
+    /** Messages the chat showed that the new view does not keep. */
+    readonly deletions: readonly number[];
+}
+export declare function isEditable(from: RenderedKind, to: RenderedKind): boolean;
+export interface PlanOptions {
+    /**
+     * The message a press came from, when it is not part of the view the chat
+     * state knows. It becomes the first message of the new view if it can.
+     */
+    readonly adopt?: ShownMessage;
+    /** Send the whole view anew below everything, deleting what was shown. */
+    readonly fresh?: boolean;
+}
+export declare function planView(shown: readonly ShownMessage[], next: readonly OutgoingMessage[], options?: PlanOptions): ViewPlan;
+//# sourceMappingURL=reconcile.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,KAAK,EAAE,kBAAkB,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAElF,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,kFAAkF;IAClF,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,IAAI,CAAC;CACjD;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC1B;AAED,MAAM,MAAM,QAAQ,GAChB;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;CACnC,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC;CAC3B,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;CAAE,CAAC;AAE/D,MAAM,WAAW,QAAQ;IACvB,sEAAsE;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,QAAQ,EAAE,CAAC;IACpC,gEAAgE;IAChE,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;CACvC;AAID,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,EAAE,EAAE,EAAE,YAAY,GAAG,OAAO,CAExE;AAgBD,MAAM,WAAW,WAAW;IAC1B;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,YAAY,CAAC;IAC9B,0EAA0E;IAC1E,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,YAAY,EAAE,EAC9B,IAAI,EAAE,SAAS,eAAe,EAAE,EAChC,OAAO,GAAE,WAAgB,GACxB,QAAQ,CAiCV"}

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

@@ -0,0 +1,23 @@
+/**
+ * The screens a bot declared, by id and by object, with the tree between them.
+ *
+ * Checked once, when the bot is composed: two screens with one path or one id
+ * would make a button mean two things, and a screen whose id collides with
+ * another's derived id would do so silently on the next release.
+ */
+import type { Context } from 'grammy';
+import type { ButtonResolver } from './render.js';
+import type { AnyTelegramScreen, ScreenActions, ScreenDefinition, ScreenParams, TelegramScreen } from './screen-types.js';
+export type DeclaredScreen<C extends Context> = TelegramScreen<C, ScreenParams, unknown, ScreenActions>;
+export interface RegisteredScreen<C extends Context> {
+    readonly screen: DeclaredScreen<C>;
+    readonly definition: ScreenDefinition<C>;
+    readonly parent: RegisteredScreen<C> | undefined;
+}
+export interface ScreenRegistry<C extends Context> {
+    byId(id: string): RegisteredScreen<C> | undefined;
+    entryOf(screen: AnyTelegramScreen): RegisteredScreen<C>;
+    resolverFor(entry: RegisteredScreen<C>): ButtonResolver;
+}
+export declare function createScreenRegistry<C extends Context>(screens: readonly DeclaredScreen<C>[]): ScreenRegistry<C>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/registry.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EACV,iBAAiB,EACjB,aAAa,EACb,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,cAAc,CAAC,CAAC,SAAS,OAAO,IAAI,cAAc,CAC5D,CAAC,EACD,YAAY,EACZ,OAAO,EACP,aAAa,CACd,CAAC;AAEF,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,OAAO;IACjD,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IACnC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACzC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,OAAO;IAC/C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC;IAClD,OAAO,CAAC,MAAM,EAAE,iBAAiB,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxD,WAAW,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,cAAc,CAAC;CACzD;AAED,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,OAAO,EACpD,OAAO,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,GACpC,cAAc,CAAC,CAAC,CAAC,CAkFnB"}

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

@@ -0,0 +1,70 @@
+/**
+ * A view as Telegram will receive it: payloads, `callback_data` and the
+ * fingerprints the next render is compared against.
+ *
+ * Buttons are resolved here, against the registered screens: a link becomes
+ * its target's id and params, `back` the parent of the screen being shown, an
+ * action the screen's own id, params and input. An address longer than
+ * Telegram's 64 bytes is kept in the chat's state under a short token and the
+ * button carries the token — so a long param never makes a screen unrenderable.
+ */
+import type { InlineKeyboardButton, InlineKeyboardMarkup, InputRichMessageWithoutUpload } from 'grammy/types';
+import { type TelegramText } from './html.js';
+import type { AnyTelegramScreen, ScreenParams } from './screen-types.js';
+import { ScreenButton, type ScreenMediaKind, type ScreenViewResult } from './view.js';
+export type RenderedKind = 'text' | 'rich' | ScreenMediaKind;
+/** The parts of a message that are edited separately, as digests. */
+export interface MessageFingerprint {
+    readonly content: string;
+    readonly media: string;
+    readonly markup: string;
+}
+export interface OutgoingMessage {
+    readonly key: string;
+    readonly kind: RenderedKind;
+    /**
+     * Telegram HTML: the text of a text message, the caption of a media one.
+     * Always sent with `parse_mode: 'HTML'`, plain strings escaped — so no
+     * `parse_mode` default an application sets elsewhere can reinterpret it.
+     */
+    readonly html: string | undefined;
+    readonly rich: InputRichMessageWithoutUpload | undefined;
+    readonly linkPreview: boolean | undefined;
+    readonly media: string | undefined;
+    readonly markup: InlineKeyboardMarkup | undefined;
+    readonly fingerprint: MessageFingerprint;
+}
+/** Where a screen button leads, resolved against the registered screens. */
+export interface ButtonResolver {
+    /** The id and param order of a registered screen; throws for one not registered. */
+    addressOf(screen: AnyTelegramScreen): {
+        readonly id: string;
+        readonly params: readonly string[];
+    };
+    /** The parent of the screen being rendered, or `undefined` at the root. */
+    readonly parent: {
+        readonly id: string;
+        readonly params: readonly string[];
+    } | undefined;
+    readonly path: string;
+}
+export interface RenderContext {
+    readonly prefix: string;
+    readonly resolver: ButtonResolver;
+    readonly params: ScreenParams;
+}
+export interface RenderedView {
+    readonly messages: readonly OutgoingMessage[];
+    /** Addresses too long for a button, by token. */
+    readonly tokens: Readonly<Record<string, string>>;
+}
+/** Text as Telegram HTML: markup as it is, a plain string escaped. */
+export declare function htmlOf(text: TelegramText): string;
+export declare function renderView(view: ScreenViewResult, context: RenderContext): RenderedView;
+/**
+ * A link for a message the screens do not own — a notification. It carries
+ * its whole address, because no view record will hold a token for it, and it
+ * opens its screen below rather than changing the message it sits on.
+ */
+export declare function renderDetachedButton(button: ScreenButton, prefix: string, addressOf: ButtonResolver['addressOf']): InlineKeyboardButton.CallbackButton;
+//# sourceMappingURL=render.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../../../src/telegram/screens/render.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EACV,oBAAoB,EACpB,oBAAoB,EACpB,6BAA6B,EAC9B,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAgB,KAAK,YAAY,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEtE,OAAO,EAIL,YAAY,EACZ,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAEtB,MAAM,QAAQ,CAAC;AAEhB,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,MAAM,GAAG,eAAe,CAAC;AAE7D,qEAAqE;AACrE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,6BAA6B,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,WAAW,EAAE,OAAO,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAClD,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC;CAC1C;AAED,4EAA4E;AAC5E,MAAM,WAAW,cAAc;IAC7B,oFAAoF;IACpF,SAAS,CAAC,MAAM,EAAE,iBAAiB,GAAG;QACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QACpB,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;KACpC,CAAC;IACF,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS,CAAC;IACzF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;CAC/B;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,iDAAiD;IACjD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CACnD;AAED,sEAAsE;AACtE,wBAAgB,MAAM,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAEjD;AAoKD,wBAAgB,UAAU,CAAC,IAAI,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,YAAY,CA8BvF;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,YAAY,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,oBAAoB,CAAC,cAAc,CAmBrC"}

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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"}