@teactjs/telegram 0.1.0-alpha.1

package/dist/runtime/src/conversation.d.ts.map

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

package/dist/runtime/src/event-hooks.d.ts

@@ -0,0 +1,49 @@
+import { type NavigateOptions } from './router';
+/**
+ * Telegram update event types supported by `useOn` and `useEventData`.
+ * Use `'*'` to match all events.
+ */
+export type TelegramEvent = '*' | 'message' | 'text' | 'photo' | 'video' | 'audio' | 'voice' | 'document' | 'sticker' | 'contact' | 'location' | 'venue' | 'animation' | 'video_note' | 'poll' | 'poll_answer' | 'callback_query' | 'inline_query' | 'new_chat_members' | 'left_chat_member' | 'dice' | 'game' | 'web_app_data' | 'successful_payment' | 'pre_checkout_query';
+/** Context object passed to `useOn` handlers with navigation and reply helpers. */
+export interface EventContext {
+    navigate: (path: string, opts?: NavigateOptions) => void;
+    chatId: string;
+    userId: string;
+    user: {
+        id: string;
+        username?: string;
+        firstName?: string;
+    };
+    reply: (text: string) => Promise<void>;
+    raw: any;
+}
+type EventHandler = (data: any, ctx: EventContext) => void;
+/**
+ * Listen for a specific Telegram event type within a React component.
+ * The handler fires once per matching update and receives an `EventContext`
+ * with `navigate`, `reply`, and user info.
+ *
+ * @example
+ * useOn('callback_query', (data, ctx) => {
+ *   console.log('Callback from', ctx.user.firstName);
+ *   ctx.navigate('/details');
+ * });
+ *
+ * useOn('contact', (contact, ctx) => {
+ *   ctx.reply(`Got your number: ${contact.phone_number}`);
+ * });
+ */
+export declare function useOn(event: TelegramEvent, handler: EventHandler): void;
+/**
+ * Returns data from the current update if it matches the event, otherwise null.
+ * A declarative alternative to `useOn` — read the value instead of registering a callback.
+ *
+ * @example
+ * const contact = useEventData('contact');
+ * if (contact) {
+ *   return <Message text={`Got your number: ${contact.phone_number}`} />;
+ * }
+ */
+export declare function useEventData<T = any>(event: TelegramEvent): T | null;
+export {};
+//# sourceMappingURL=event-hooks.d.ts.map

package/dist/runtime/src/event-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-hooks.d.ts","sourceRoot":"","sources":["../../../../runtime/src/event-hooks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAa,KAAK,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,aAAa,GACrB,GAAG,GACH,SAAS,GAAG,MAAM,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAC1D,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,OAAO,GACzD,WAAW,GAAG,YAAY,GAAG,MAAM,GAAG,aAAa,GACnD,gBAAgB,GAAG,cAAc,GACjC,kBAAkB,GAAG,kBAAkB,GACvC,MAAM,GAAG,MAAM,GAAG,cAAc,GAChC,oBAAoB,GAAG,oBAAoB,CAAC;AAEhD,mFAAmF;AACnF,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,eAAe,KAAK,IAAI,CAAC;IACzD,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5D,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,GAAG,EAAE,GAAG,CAAC;CACV;AAED,KAAK,YAAY,GAAG,CAAC,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,YAAY,KAAK,IAAI,CAAC;AAiC3D;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI,CAsCvE;AAED;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,aAAa,GAAG,CAAC,GAAG,IAAI,CAKpE"}

package/dist/runtime/src/i18n.d.ts

@@ -0,0 +1,55 @@
+import React from 'react';
+/** Configuration for {@link createI18n}. */
+export interface I18nConfig {
+    /** Language code used on first load (e.g. `'en'`). */
+    defaultLocale: string;
+    /** i18next-style resources keyed by locale, each containing a `translation` object. */
+    resources: Record<string, {
+        translation: Record<string, any>;
+    }>;
+    /** Locale to fall back to when a key is missing. Defaults to `defaultLocale`. */
+    fallbackLocale?: string;
+}
+/**
+ * Create an i18n instance powered by i18next + react-i18next.
+ *
+ * Each locale must have a `translation` key following the i18next convention.
+ *
+ * @example
+ * ```ts
+ * import en from './locales/en.json';
+ * import am from './locales/am.json';
+ *
+ * const i18n = createI18n({
+ *   defaultLocale: 'en',
+ *   resources: {
+ *     en: { translation: en },
+ *     am: { translation: am },
+ *   },
+ * });
+ * ```
+ */
+export declare function createI18n(config: I18nConfig): {
+    Provider: ({ children }: {
+        children: React.ReactNode;
+    }) => React.ReactElement;
+    instance: import("node_modules/i18next").i18n;
+};
+/**
+ * Access translations from any component.
+ *
+ * Returns `t` (bound to the current locale), `locale`, `setLocale`, and `availableLocales`.
+ *
+ * @example
+ * ```tsx
+ * const { t, locale, setLocale } = useLocale();
+ * return <Message text={t('home.title')} />;
+ * ```
+ */
+export declare function useLocale(): {
+    t: import("i18next").TFunction<"translation", undefined>;
+    locale: string;
+    setLocale: (lng: string) => void;
+    availableLocales: string[];
+};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/runtime/src/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../../../../runtime/src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAoE,MAAM,OAAO,CAAC;AAIzF,4CAA4C;AAC5C,MAAM,WAAW,UAAU;IACzB,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC;IACtB,uFAAuF;IACvF,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;KAAE,CAAC,CAAC;IAChE,iFAAiF;IACjF,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AASD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,UAAU;6BASX;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,KAAG,KAAK,CAAC,YAAY;;EAoBnF;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS;;;qBAlEN,MAAM,KAAK,IAAI;;EA8EjC"}

package/dist/runtime/src/index.d.ts

@@ -0,0 +1,28 @@
+export { createBot } from './bot';
+export type { CreateBotOptions, CommandContext, CommandDef, ReplyOptions, ReplyButton, ReplyKeyboardButton, WebhookConfig } from './bot';
+export { MemorySessionStore } from './session';
+export { compose, commandMiddleware } from './middleware';
+export { createRouter, useNavigate, useParams, useRoute, redirect } from './router';
+export type { RouterConfig, NavigateOptions, NavigateMode, BeforeLoadContext, RouteGuard, GuardRedirect, GuardComponent, GuardReply, GuardReplyOptions, GuardButton, RouteValue, CreateRouterOptions } from './router';
+export { useConversation, useForm, useConversationContext, useFormContext, Conversation, Form } from './conversation';
+export type { ConversationState, FormFieldDef, FormResult, Validator, ValidateFn, SchemaLike, StepDef, StepsConfig, StepActions, ConversationActions, FormActions } from './conversation';
+export type { TeactPlugin } from './plugin';
+export { useStream } from './stream';
+export type { UseStreamResult } from './stream';
+export { authPlugin, useAuth } from './auth';
+export type { AuthConfig, AuthState } from './auth';
+export { useAuthSession } from './auth-session';
+export type { AuthTokens, AuthSessionState } from './auth-session';
+export { defineConfig } from './config';
+export type { TeactConfig } from './config';
+export { RuntimeContext, useBot, useSession, usePlatform, useChatId, useText, useCallbackData, useCommand, } from './context';
+export type { RuntimeContextValue } from './context';
+export { useChat, useTelegram, usePhoto, useVideo, useAnimation, useAudio, useVoice, useDocument, useSticker, useLocation, useContact, useVenue, usePoll, } from './media-hooks';
+export type { ChatInfo, TelegramAccess } from './media-hooks';
+export { useOn, useEventData } from './event-hooks';
+export type { TelegramEvent, EventContext } from './event-hooks';
+export { createI18n, useLocale } from './i18n';
+export type { I18nConfig } from './i18n';
+export { useInvoice } from './invoice';
+export type { InvoiceConfig, InvoiceResult, LabeledPrice, SuccessfulPayment } from './invoice';
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../runtime/src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,mBAAmB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAEzI,OAAO,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAE/C,OAAO,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAE1D,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,eAAe,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,aAAa,EAAE,cAAc,EAAE,UAAU,EAAE,iBAAiB,EAAE,WAAW,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,UAAU,CAAC;AAEvN,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,sBAAsB,EAAE,cAAc,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtH,YAAY,EAAE,iBAAiB,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAE1L,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,YAAY,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAEhD,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAChD,YAAY,EAAE,UAAU,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEnE,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACxC,YAAY,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EACL,cAAc,EACd,MAAM,EACN,UAAU,EACV,WAAW,EACX,SAAS,EACT,OAAO,EACP,eAAe,EACf,UAAU,GACX,MAAM,WAAW,CAAC;AACnB,YAAY,EAAE,mBAAmB,EAAE,MAAM,WAAW,CAAC;AAErD,OAAO,EACL,OAAO,EACP,WAAW,EACX,QAAQ,EACR,QAAQ,EACR,YAAY,EACZ,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,UAAU,EACV,WAAW,EACX,UAAU,EACV,QAAQ,EACR,OAAO,GACR,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAE9D,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AACpD,YAAY,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAEjE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAC/C,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC"}

package/dist/runtime/src/invoice.d.ts

@@ -0,0 +1,120 @@
+/** A price entry for a Telegram payment invoice. */
+export interface LabeledPrice {
+    label: string;
+    /** Price in the smallest currency unit (e.g. cents for USD: 499 = $4.99). */
+    amount: number;
+}
+/**
+ * Configuration for {@link useInvoice}.
+ *
+ * Maps 1-to-1 with Telegram's `sendInvoice` parameters.
+ * The `providerToken` is the secret token you get from BotFather
+ * after linking a payment provider.
+ *
+ * @example
+ * ```ts
+ * useInvoice({
+ *   title: 'Premium Plan',
+ *   description: 'Monthly subscription',
+ *   payload: 'premium-v1',
+ *   providerToken: process.env.CHAPA_PROVIDER_TOKEN!,
+ *   currency: 'ETB',
+ *   prices: [{ label: 'Premium', amount: 10000 }],
+ *   photoUrl: 'https://example.com/product.png',
+ *   photoWidth: 512,
+ *   photoHeight: 512,
+ *   needName: true,
+ *   needEmail: true,
+ * });
+ * ```
+ */
+export interface InvoiceConfig {
+    title: string;
+    description: string;
+    /** Bot-defined payload for tracking (1-128 bytes, not shown to users). */
+    payload: string;
+    /** Payment provider token from BotFather. */
+    providerToken: string;
+    /** Three-letter ISO 4217 currency code (e.g. "USD", "ETB"). */
+    currency: string;
+    prices: LabeledPrice[];
+    /** URL of the product photo for the invoice. */
+    photoUrl?: string;
+    /** Photo width in pixels. */
+    photoWidth?: number;
+    /** Photo height in pixels. */
+    photoHeight?: number;
+    /** Photo size in bytes. */
+    photoSize?: number;
+    /** Request the user's full name. */
+    needName?: boolean;
+    /** Request the user's phone number. */
+    needPhoneNumber?: boolean;
+    /** Request the user's email address. */
+    needEmail?: boolean;
+    /** Request the user's shipping address. */
+    needShippingAddress?: boolean;
+    /** Pass the user's phone number to the payment provider. */
+    sendPhoneNumberToProvider?: boolean;
+    /** Pass the user's email to the payment provider. */
+    sendEmailToProvider?: boolean;
+    /** True if the final price depends on the shipping method. */
+    isFlexible?: boolean;
+    /** Maximum accepted tip amount in the smallest currency unit. */
+    maxTipAmount?: number;
+    /** Suggested tip amounts (max 4 values). */
+    suggestedTipAmounts?: number[];
+    /** Deep-linking parameter for the invoice link. */
+    startParameter?: string;
+    /** JSON-serialized data about the invoice for the payment provider. */
+    providerData?: string;
+    /** Protect the content of the invoice message from forwarding/saving. */
+    protectContent?: boolean;
+}
+/** Data received after a successful Telegram payment. */
+export interface SuccessfulPayment {
+    currency: string;
+    totalAmount: number;
+    invoicePayload: string;
+    telegramPaymentChargeId: string;
+    providerPaymentChargeId: string;
+    orderInfo?: any;
+}
+/** Return value of {@link useInvoice} with send action and payment state. */
+export interface InvoiceResult {
+    /** Send the invoice to the current chat. */
+    send: () => Promise<void>;
+    /** Current payment status. */
+    status: 'idle' | 'pending' | 'success' | 'failed';
+    /** Populated after successful payment. */
+    receipt: SuccessfulPayment | null;
+    /** Error message when status is 'failed'. */
+    error: string | null;
+}
+/**
+ * Hook for sending Telegram payment invoices.
+ *
+ * @example
+ * ```tsx
+ * const invoice = useInvoice({
+ *   title: 'Premium',
+ *   description: 'Unlock all features',
+ *   payload: 'premium-v1',
+ *   providerToken: process.env.PAYMENT_PROVIDER_TOKEN!,
+ *   currency: 'USD',
+ *   prices: [{ label: 'Premium', amount: 499 }],
+ * });
+ *
+ * return (
+ *   <Message text={invoice.status === 'success' ? '✅ Paid!' : '💎 Buy Premium'}>
+ *     <InlineKeyboard>
+ *       <ButtonRow>
+ *         <Button text="💳 Pay $4.99" onClick={invoice.send} />
+ *       </ButtonRow>
+ *     </InlineKeyboard>
+ *   </Message>
+ * );
+ * ```
+ */
+export declare function useInvoice(config: InvoiceConfig): InvoiceResult;
+//# sourceMappingURL=invoice.d.ts.map

package/dist/runtime/src/invoice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoice.d.ts","sourceRoot":"","sources":["../../../../runtime/src/invoice.ts"],"names":[],"mappings":"AAIA,oDAAoD;AACpD,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,0EAA0E;IAC1E,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,aAAa,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,gDAAgD;IAChD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6BAA6B;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oCAAoC;IACpC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,2CAA2C;IAC3C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,4DAA4D;IAC5D,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,qDAAqD;IACrD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,iEAAiE;IACjE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC/B,mDAAmD;IACnD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED,yDAAyD;AACzD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,uBAAuB,EAAE,MAAM,CAAC;IAChC,uBAAuB,EAAE,MAAM,CAAC;IAChC,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB;AAED,6EAA6E;AAC7E,MAAM,WAAW,aAAa;IAC5B,4CAA4C;IAC5C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,8BAA8B;IAC9B,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;IAClD,0CAA0C;IAC1C,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,6CAA6C;IAC7C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAkE/D"}

package/dist/runtime/src/media-hooks.d.ts

@@ -0,0 +1,178 @@
+/** Aggregated chat information for the current update. */
+export interface ChatInfo {
+    chatId: string;
+    userId: string;
+    user: {
+        id: string;
+        username?: string;
+        firstName?: string;
+        lastName?: string;
+        isBot?: boolean;
+    };
+    messageId?: string;
+    text?: string;
+    callbackData?: string;
+    platform: string;
+}
+/**
+ * Returns aggregated chat info (user, chatId, text, callbackData, etc.) for the current update.
+ *
+ * @example
+ * const { chatId, user, text } = useChat();
+ */
+export declare function useChat(): ChatInfo;
+/** Low-level access to the grammY API, context, chat, and sender objects. */
+export interface TelegramAccess {
+    api: any;
+    ctx: any;
+    chat: any;
+    from: any;
+    chatId: number;
+}
+/**
+ * Returns low-level Telegram API access for advanced use cases.
+ *
+ * @example
+ * const { api, chatId } = useTelegram();
+ * await api.sendMessage(chatId, 'Hello from raw API!');
+ */
+export declare function useTelegram(): TelegramAccess;
+/**
+ * Returns a callback to send a photo to the current chat.
+ *
+ * @example
+ * const sendPhoto = usePhoto();
+ * await sendPhoto('https://example.com/cat.jpg', { caption: 'A cute cat' });
+ */
+export declare function usePhoto(): (src: string, opts?: {
+    caption?: string;
+    parse_mode?: string;
+    has_spoiler?: boolean;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a video to the current chat.
+ *
+ * @example
+ * const sendVideo = useVideo();
+ * await sendVideo('https://example.com/clip.mp4', { caption: 'Watch this' });
+ */
+export declare function useVideo(): (src: string, opts?: {
+    caption?: string;
+    parse_mode?: string;
+    duration?: number;
+    width?: number;
+    height?: number;
+    supports_streaming?: boolean;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a GIF/animation to the current chat.
+ *
+ * @example
+ * const sendGif = useAnimation();
+ * await sendGif('https://example.com/funny.gif');
+ */
+export declare function useAnimation(): (src: string, opts?: {
+    caption?: string;
+    parse_mode?: string;
+    duration?: number;
+    width?: number;
+    height?: number;
+}) => Promise<any>;
+/**
+ * Returns a callback to send an audio file to the current chat.
+ *
+ * @example
+ * const sendAudio = useAudio();
+ * await sendAudio('https://example.com/song.mp3', { title: 'My Song' });
+ */
+export declare function useAudio(): (src: string, opts?: {
+    caption?: string;
+    parse_mode?: string;
+    performer?: string;
+    title?: string;
+    duration?: number;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a voice message to the current chat.
+ *
+ * @example
+ * const sendVoice = useVoice();
+ * await sendVoice('https://example.com/voice.ogg');
+ */
+export declare function useVoice(): (src: string, opts?: {
+    caption?: string;
+    parse_mode?: string;
+    duration?: number;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a document/file to the current chat.
+ *
+ * @example
+ * const sendDoc = useDocument();
+ * await sendDoc('https://example.com/report.pdf', { filename: 'report.pdf' });
+ */
+export declare function useDocument(): (src: string, opts?: {
+    caption?: string;
+    filename?: string;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a sticker to the current chat.
+ *
+ * @example
+ * const sendSticker = useSticker();
+ * await sendSticker('CAACAgIAAxkB...');
+ */
+export declare function useSticker(): (src: string, opts?: {
+    emoji?: string;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a location to the current chat.
+ *
+ * @example
+ * const sendLocation = useLocation();
+ * await sendLocation(9.0192, 38.7525);
+ */
+export declare function useLocation(): (latitude: number, longitude: number, opts?: {
+    live_period?: number;
+    horizontal_accuracy?: number;
+    heading?: number;
+    proximity_alert_radius?: number;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a contact card to the current chat.
+ *
+ * @example
+ * const sendContact = useContact();
+ * await sendContact('+1234567890', 'Jane');
+ */
+export declare function useContact(): (phoneNumber: string, firstName: string, opts?: {
+    last_name?: string;
+    vcard?: string;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a venue to the current chat.
+ *
+ * @example
+ * const sendVenue = useVenue();
+ * await sendVenue(9.0192, 38.7525, 'Meskel Square', 'Addis Ababa');
+ */
+export declare function useVenue(): (latitude: number, longitude: number, title: string, address: string, opts?: {
+    foursquare_id?: string;
+    google_place_id?: string;
+}) => Promise<any>;
+/**
+ * Returns a callback to send a poll to the current chat.
+ *
+ * @example
+ * const sendPoll = usePoll();
+ * await sendPoll('Favorite color?', ['Red', 'Blue', 'Green']);
+ */
+export declare function usePoll(): (question: string, options: string[], opts?: {
+    is_anonymous?: boolean;
+    type?: "regular" | "quiz";
+    allows_multiple_answers?: boolean;
+    correct_option_id?: number;
+    explanation?: string;
+    open_period?: number;
+}) => Promise<any>;
+//# sourceMappingURL=media-hooks.d.ts.map

package/dist/runtime/src/media-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-hooks.d.ts","sourceRoot":"","sources":["../../../../runtime/src/media-hooks.ts"],"names":[],"mappings":"AAKA,0DAA0D;AAC1D,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAChG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,OAAO,IAAI,QAAQ,CAWlC;AAID,6EAA6E;AAC7E,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,GAAG,CAAC;IACT,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,GAAG,CAAC;IACV,IAAI,EAAE,GAAG,CAAC;IACV,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,IAAI,cAAc,CAU5C;AAID;;;;;;GAMG;AACH,wBAAgB,QAAQ,UAGd,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,OAAO,CAAA;CAAE,KAC9C,OAAO,CAAC,GAAG,CAAC,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,UAGd,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAE,KACzG,OAAO,CAAC,GAAG,CAAC,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,UAGlB,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,KACvE,OAAO,CAAC,GAAG,CAAC,CAG1D;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,UAGd,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAC9E,OAAO,CAAC,GAAG,CAAC,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,UAGd,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1C,OAAO,CAAC,GAAG,CAAC,CAGtD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,UAGjB,MAAM,SAAS;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,KAClB,OAAO,CAAC,GAAG,CAAC,CAGzD;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,UAGhB,MAAM,SAAS;IAAE,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KACE,OAAO,CAAC,GAAG,CAAC,CAGxD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,eAGZ,MAAM,aAAa,MAAM,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,sBAAsB,CAAC,EAAE,MAAM,CAAA;CAAE,KAC5F,OAAO,CAAC,GAAG,CAAC,CAGzE;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,kBAGR,MAAM,aAAa,MAAM,SAAS;IAAE,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1B,OAAO,CAAC,GAAG,CAAC,CAG3E;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,eAGT,MAAM,aAAa,MAAM,SAAS,MAAM,WAAW,MAAM,SAAS;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,KAC1D,OAAO,CAAC,GAAG,CAAC,CAGtF;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,eAGR,MAAM,WAAW,MAAM,EAAE,SAAS;IAAE,YAAY,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAAC,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,KAE9I,OAAO,CAAC,GAAG,CAAC,CAI9E"}

package/dist/runtime/src/middleware.d.ts

@@ -0,0 +1,26 @@
+import type { BotContext, Middleware } from '@teactjs/renderer';
+/**
+ * Compose an array of middleware functions into a single middleware.
+ *
+ * Unlike Koa-style middleware, `next()` is called automatically if
+ * the middleware function completes without calling it. This means
+ * simple middleware (loggers, analytics) don't need to remember to
+ * call `next()` — the framework handles it.
+ *
+ * @param middlewares - Ordered list of middleware to chain.
+ * @returns A single middleware that runs the chain in order.
+ *
+ * @example
+ * const logger: Middleware = async (ctx) => {
+ *   console.log(ctx.text);  // no need to call next() — it's automatic
+ * };
+ */
+export declare function compose(middlewares: Middleware[]): Middleware;
+/**
+ * Middleware that intercepts `/command` messages and dispatches them to registered handlers.
+ *
+ * @param commands - Map of command names (without `/`) to their handler functions.
+ * @returns Middleware that calls the matching handler or passes through via `next()`.
+ */
+export declare function commandMiddleware(commands: Map<string, (ctx: BotContext, args: string[]) => Promise<void> | void>): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/runtime/src/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../../../runtime/src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAEhE;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,OAAO,CAAC,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAiB7D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAC/E,UAAU,CAUZ"}

package/dist/runtime/src/plugin.d.ts

@@ -0,0 +1,32 @@
+import type { FunctionComponent, ReactNode } from 'react';
+import type { Middleware } from '@teactjs/renderer';
+import type { TelegramAdapter } from '@teactjs/telegram';
+/**
+ * Teact plugin interface.
+ * Plugins can hook into the bot lifecycle, provide middleware,
+ * and wrap the component tree with React providers.
+ *
+ * @example
+ * export function myPlugin(opts: MyOpts): TeactPlugin {
+ *   return {
+ *     name: 'my-plugin',
+ *     Provider: ({ children }) => <MyContext.Provider value={...}>{children}</MyContext.Provider>,
+ *     middleware: async (ctx, next) => { ... ; await next(); },
+ *     onStart: (adapter) => console.log('bot started!'),
+ *   };
+ * }
+ */
+export interface TeactPlugin {
+    name: string;
+    /** Called when the bot starts. Receives the adapter for advanced setup. */
+    onStart?: (adapter: TelegramAdapter) => Promise<void> | void;
+    /** Middleware that runs on every update before the component renders. */
+    middleware?: Middleware;
+    /** React provider component that wraps the app tree. Receives children. */
+    Provider?: FunctionComponent<{
+        children: ReactNode;
+    }>;
+    /** Cleanup when the bot stops. */
+    onStop?: () => Promise<void> | void;
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/runtime/src/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../../runtime/src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1D,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,2EAA2E;IAC3E,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC7D,yEAAyE;IACzE,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,2EAA2E;IAC3E,QAAQ,CAAC,EAAE,iBAAiB,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAA;KAAE,CAAC,CAAC;IACtD,kCAAkC;IAClC,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrC"}