@tma.sh/sdk 0.1.0 → 0.1.2

package/dist/bot/context.d.ts

@@ -0,0 +1,29 @@
+import type { TelegramUpdate } from "./telegram-types";
+import type { BotContext, BotEnv, KVStore } from "./types";
+/**
+ * Wraps a Cloudflare KV namespace binding into the SDK's {@link KVStore}
+ * interface with automatic JSON serialization.
+ *
+ * Values are stored as strings. On read, the wrapper attempts to parse the
+ * value as JSON; if parsing fails the raw string is returned.
+ */
+export declare const createKV: (binding: KVNamespace) => KVStore;
+/**
+ * Creates a {@link BotContext} for a single Telegram update.
+ *
+ * The context provides:
+ * - Resolved `chatId` and `from` fields extracted from the update
+ * - Reply helpers (`reply`, `replyPhoto`, `answerCallbackQuery`, etc.)
+ * - A typed `kv` store wrapping the environment's KV namespace
+ * - A generic `api.call()` for arbitrary Telegram Bot API methods
+ * - The raw `env` bindings for direct access
+ *
+ * @example
+ * ```ts
+ * const ctx = createBotContext(update, env);
+ * await ctx.reply('Hello!', { parse_mode: 'HTML' });
+ * await ctx.kv.set('seen:' + ctx.from?.id, true);
+ * ```
+ */
+export declare const createBotContext: (update: TelegramUpdate, env: BotEnv) => BotContext;
+//# sourceMappingURL=context.d.ts.map

package/dist/bot/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/bot/context.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAmB,MAAM,kBAAkB,CAAC;AACxE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,EAAU,OAAO,EAAE,MAAM,SAAS,CAAC;AA6CnE;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,WAAW,KAAG,OA+B9C,CAAC;AAuBH;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,QAAQ,cAAc,EACtB,KAAK,MAAM,KACV,UAyFF,CAAC"}

package/dist/bot/define-bot.d.ts

@@ -0,0 +1,14 @@
+import type { BotConfig } from "./types";
+export declare const defineBot: (config: BotConfig) => {
+    fetch: (request: Request, env: import("./types").BotEnv, ctx: ExecutionContext) => Promise<Response>;
+    commands?: readonly import("./types").BotCommand[];
+    description?: string;
+    shortDescription?: string;
+    middleware?: readonly import("./types").Middleware[];
+    onMessage?: (ctx: import("./types").BotContext) => Promise<void>;
+    onCallbackQuery?: (ctx: import("./types").BotContext) => Promise<void>;
+    onInlineQuery?: (ctx: import("./types").BotContext) => Promise<void>;
+    onPreCheckoutQuery?: (ctx: import("./types").BotContext) => Promise<void>;
+    onUpdate?: (ctx: import("./types").BotContext) => Promise<void>;
+};
+//# sourceMappingURL=define-bot.d.ts.map

package/dist/bot/define-bot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-bot.d.ts","sourceRoot":"","sources":["../../src/bot/define-bot.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGzC,eAAO,MAAM,SAAS,GAAI,QAAQ,SAAS;;;;;;;;;;;CAG1C,CAAC"}

package/dist/bot/index.d.ts

@@ -0,0 +1,5 @@
+export { defineBot } from "./define-bot";
+export { createKV } from "./context";
+export type { BotCommand, BotConfig, BotContext, BotEnv, KVStore, BotApi, Middleware, } from "./types";
+export type { TelegramUpdate, TelegramMessage, TelegramUser, TelegramChat, TelegramCallbackQuery, TelegramInlineQuery, TelegramPreCheckoutQuery, TelegramSuccessfulPayment, TelegramPhotoSize, TelegramDocument, InlineKeyboardButton, InlineKeyboardMarkup, ReplyKeyboardButton, ReplyKeyboardMarkup, SendMessageOptions, SendPhotoOptions, } from "./telegram-types";
+//# sourceMappingURL=index.d.ts.map

package/dist/bot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/bot/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAErC,YAAY,EACV,UAAU,EACV,SAAS,EACT,UAAU,EACV,MAAM,EACN,OAAO,EACP,MAAM,EACN,UAAU,GACX,MAAM,SAAS,CAAC;AAEjB,YAAY,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,YAAY,EACZ,qBAAqB,EACrB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,iBAAiB,EACjB,gBAAgB,EAChB,oBAAoB,EACpB,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,kBAAkB,EAClB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC"}

package/dist/bot/runtime.d.ts

@@ -0,0 +1,7 @@
+import type { BotConfig, BotEnv } from "./types";
+type WorkerFetch = (request: Request, env: BotEnv, ctx: ExecutionContext) => Promise<Response>;
+export declare const createBotWorker: (config: BotConfig) => {
+    readonly fetch: WorkerFetch;
+};
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/bot/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/bot/runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAc,MAAM,EAAc,MAAM,SAAS,CAAC;AA8CzE,KAAK,WAAW,GAAG,CACjB,OAAO,EAAE,OAAO,EAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,gBAAgB,KAClB,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,eAAO,MAAM,eAAe,GAC1B,QAAQ,SAAS,KAChB;IAAE,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAA;CAoC/B,CAAC"}

package/dist/bot/telegram-types.d.ts

@@ -0,0 +1,119 @@
+export interface TelegramUser {
+    readonly id: number;
+    readonly is_bot: boolean;
+    readonly first_name: string;
+    readonly last_name?: string;
+    readonly username?: string;
+    readonly language_code?: string;
+}
+export interface TelegramChat {
+    readonly id: number;
+    readonly type: "private" | "group" | "supergroup" | "channel";
+    readonly title?: string;
+    readonly username?: string;
+    readonly first_name?: string;
+    readonly last_name?: string;
+}
+export interface TelegramMessage {
+    readonly message_id: number;
+    readonly from?: TelegramUser;
+    readonly chat: TelegramChat;
+    readonly date: number;
+    readonly text?: string;
+    readonly reply_to_message?: TelegramMessage;
+    readonly photo?: readonly TelegramPhotoSize[];
+    readonly document?: TelegramDocument;
+    readonly web_app_data?: {
+        readonly data: string;
+        readonly button_text: string;
+    };
+    readonly reply_markup?: InlineKeyboardMarkup;
+    readonly successful_payment?: TelegramSuccessfulPayment;
+}
+export interface TelegramPhotoSize {
+    readonly file_id: string;
+    readonly file_unique_id: string;
+    readonly width: number;
+    readonly height: number;
+    readonly file_size?: number;
+}
+export interface TelegramDocument {
+    readonly file_id: string;
+    readonly file_unique_id: string;
+    readonly file_name?: string;
+    readonly mime_type?: string;
+    readonly file_size?: number;
+}
+export interface TelegramCallbackQuery {
+    readonly id: string;
+    readonly from: TelegramUser;
+    readonly message?: TelegramMessage;
+    readonly data?: string;
+    readonly game_short_name?: string;
+}
+export interface TelegramInlineQuery {
+    readonly id: string;
+    readonly from: TelegramUser;
+    readonly query: string;
+    readonly offset: string;
+}
+export interface TelegramPreCheckoutQuery {
+    readonly id: string;
+    readonly from: TelegramUser;
+    readonly currency: string;
+    readonly total_amount: number;
+    readonly invoice_payload: string;
+}
+export interface TelegramSuccessfulPayment {
+    readonly currency: string;
+    readonly total_amount: number;
+    readonly invoice_payload: string;
+    readonly telegram_payment_charge_id: string;
+    readonly provider_payment_charge_id: string;
+}
+export interface TelegramUpdate {
+    readonly update_id: number;
+    readonly message?: TelegramMessage;
+    readonly callback_query?: TelegramCallbackQuery;
+    readonly inline_query?: TelegramInlineQuery;
+    readonly pre_checkout_query?: TelegramPreCheckoutQuery;
+}
+export interface InlineKeyboardButton {
+    readonly text: string;
+    readonly url?: string;
+    readonly callback_data?: string;
+    readonly web_app?: {
+        readonly url: string;
+    };
+    readonly pay?: boolean;
+}
+export interface InlineKeyboardMarkup {
+    readonly inline_keyboard: readonly (readonly InlineKeyboardButton[])[];
+}
+export interface ReplyKeyboardButton {
+    readonly text: string;
+    readonly request_contact?: boolean;
+    readonly request_location?: boolean;
+    readonly web_app?: {
+        readonly url: string;
+    };
+}
+export interface ReplyKeyboardMarkup {
+    readonly keyboard: readonly (readonly ReplyKeyboardButton[])[];
+    readonly resize_keyboard?: boolean;
+    readonly one_time_keyboard?: boolean;
+    readonly selective?: boolean;
+}
+export interface SendMessageOptions {
+    readonly parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+    readonly reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup;
+    readonly disable_web_page_preview?: boolean;
+    readonly reply_to_message_id?: number;
+}
+export interface SendPhotoOptions {
+    readonly caption?: string;
+    readonly parse_mode?: "HTML" | "Markdown" | "MarkdownV2";
+    readonly reply_markup?: InlineKeyboardMarkup | ReplyKeyboardMarkup;
+    readonly reply_to_message_id?: number;
+}
+//# sourceMappingURL=telegram-types.d.ts.map

package/dist/bot/telegram-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram-types.d.ts","sourceRoot":"","sources":["../../src/bot/telegram-types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,GAAG,YAAY,GAAG,SAAS,CAAC;IAC9D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,eAAe,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC9C,QAAQ,CAAC,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,YAAY,CAAC,EAAE;QACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;KAC9B,CAAC;IACF,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC;IAC7C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,yBAAyB,CAAC;CACzD;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;IAC5C,QAAQ,CAAC,0BAA0B,EAAE,MAAM,CAAC;CAC7C;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,cAAc,CAAC,EAAE,qBAAqB,CAAC;IAChD,QAAQ,CAAC,YAAY,CAAC,EAAE,mBAAmB,CAAC;IAC5C,QAAQ,CAAC,kBAAkB,CAAC,EAAE,wBAAwB,CAAC;CACxD;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC,SAAS,oBAAoB,EAAE,CAAC,EAAE,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CAC7C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,SAAS,mBAAmB,EAAE,CAAC,EAAE,CAAC;IAC/D,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;IACnC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IACrC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACnE,QAAQ,CAAC,wBAAwB,CAAC,EAAE,OAAO,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,YAAY,CAAC;IACzD,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,GAAG,mBAAmB,CAAC;IACnE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC"}

package/dist/bot/types.d.ts

@@ -0,0 +1,55 @@
+import type { TelegramUpdate, TelegramMessage, TelegramCallbackQuery, TelegramInlineQuery, TelegramPreCheckoutQuery, SendMessageOptions, SendPhotoOptions } from "./telegram-types";
+export interface BotCommand {
+    readonly command: string;
+    readonly description: string;
+}
+export interface BotConfig {
+    readonly commands?: readonly BotCommand[];
+    readonly description?: string;
+    readonly shortDescription?: string;
+    readonly middleware?: readonly Middleware[];
+    readonly onMessage?: (ctx: BotContext) => Promise<void>;
+    readonly onCallbackQuery?: (ctx: BotContext) => Promise<void>;
+    readonly onInlineQuery?: (ctx: BotContext) => Promise<void>;
+    readonly onPreCheckoutQuery?: (ctx: BotContext) => Promise<void>;
+    readonly onUpdate?: (ctx: BotContext) => Promise<void>;
+}
+export interface BotEnv {
+    readonly BOT_TOKEN: string;
+    readonly WEB_APP_URL: string;
+    readonly KV: KVNamespace;
+    readonly [key: string]: unknown;
+}
+export interface KVStore {
+    readonly get: <T = string>(key: string) => Promise<T | null>;
+    readonly set: (key: string, value: unknown, ttl?: number) => Promise<void>;
+    readonly delete: (key: string) => Promise<void>;
+    readonly list: (prefix?: string) => Promise<readonly string[]>;
+}
+export interface BotApi {
+    readonly call: <T = unknown>(method: string, body?: Record<string, unknown>) => Promise<T>;
+}
+export interface BotContext {
+    readonly update: TelegramUpdate;
+    readonly message: TelegramMessage | undefined;
+    readonly callbackQuery: TelegramCallbackQuery | undefined;
+    readonly inlineQuery: TelegramInlineQuery | undefined;
+    readonly preCheckoutQuery: TelegramPreCheckoutQuery | undefined;
+    readonly chatId: number | undefined;
+    readonly from: {
+        readonly id: number;
+        readonly language_code?: string;
+    } | undefined;
+    readonly env: BotEnv;
+    readonly kv: KVStore;
+    readonly api: BotApi;
+    readonly reply: (text: string, options?: SendMessageOptions) => Promise<TelegramMessage>;
+    readonly replyPhoto: (photo: string, options?: SendPhotoOptions) => Promise<TelegramMessage>;
+    readonly answerCallbackQuery: (text?: string, options?: {
+        readonly show_alert?: boolean;
+    }) => Promise<void>;
+    readonly answerInlineQuery: (results: readonly unknown[], options?: Record<string, unknown>) => Promise<void>;
+    readonly answerPreCheckoutQuery: (ok: boolean, errorMessage?: string) => Promise<void>;
+}
+export type Middleware = (ctx: BotContext, next: () => Promise<void>) => Promise<void>;
+//# sourceMappingURL=types.d.ts.map

package/dist/bot/types.d.ts.map

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

package/dist/client/auth.d.ts

@@ -0,0 +1,19 @@
+import type { AuthResult, TMAConfig } from "../types";
+export interface AuthClient {
+    /**
+     * Validate Telegram initData and receive a signed JWT.
+     *
+     * Sends the raw initData string to the TMA API which verifies the
+     * HMAC-SHA256 signature using the project's bot token and returns a JWT
+     * containing the authenticated Telegram user claims.
+     */
+    readonly validate: (initData: string, projectId: string) => Promise<AuthResult>;
+    /** Returns the current JWT if authentication has been completed. */
+    readonly getJwt: () => string | null;
+}
+/** Set the JWT in memory (used internally after validation). */
+export declare const setStoredJwt: (jwt: string | null) => void;
+/** Get the current in-memory JWT. */
+export declare const getStoredJwt: () => string | null;
+export declare const createAuthClient: (config?: TMAConfig) => AuthClient;
+//# sourceMappingURL=auth.d.ts.map

package/dist/client/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/client/auth.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMtD,MAAM,WAAW,UAAU;IACzB;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,EAAE,CACjB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,KACd,OAAO,CAAC,UAAU,CAAC,CAAC;IAEzB,oEAAoE;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;CACtC;AAQD,gEAAgE;AAChE,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,GAAG,IAAI,KAAG,IAEjD,CAAC;AAEF,qCAAqC;AACrC,eAAO,MAAM,YAAY,QAAO,MAAM,GAAG,IAAiB,CAAC;AAM3D,eAAO,MAAM,gBAAgB,GAAI,SAAS,SAAS,KAAG,UAqBrD,CAAC"}

package/dist/client/http.d.ts

@@ -0,0 +1,11 @@
+export declare class TMAError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+export declare const resolveApiUrl: (apiUrl?: string) => string;
+export declare const makeRequest: <T>(baseUrl: string, path: string, options?: {
+    readonly method?: string;
+    readonly body?: unknown;
+    readonly jwt?: string | null;
+}) => Promise<T>;
+//# sourceMappingURL=http.d.ts.map

package/dist/client/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/client/http.ts"],"names":[],"mappings":"AAMA,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,SAAc;CAKhD;AASD,eAAO,MAAM,aAAa,GAAI,SAAS,MAAM,KAAG,MACW,CAAC;AAE5D,eAAO,MAAM,WAAW,GAAU,CAAC,EACjC,SAAS,MAAM,EACf,MAAM,MAAM,EACZ,UAAS;IACP,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB,KACL,OAAO,CAAC,CAAC,CAyBX,CAAC"}

package/dist/client/index.d.ts

@@ -0,0 +1,26 @@
+import { type AuthClient } from "./auth";
+import { type KVClient } from "./kv";
+import type { TMAConfig } from "../types";
+export interface TMAClient {
+    readonly auth: AuthClient;
+    readonly kv: KVClient;
+}
+/**
+ * Create a TMA SDK client instance.
+ *
+ * @example
+ * ```typescript
+ * import { createTMA } from '@tma.sh/sdk';
+ *
+ * const tma = createTMA();
+ * const { jwt, user } = await tma.auth.validate(initData, projectId);
+ * await tma.kv.set('key', 'value');
+ * ```
+ */
+export declare const createTMA: (config?: TMAConfig) => TMAClient;
+export type { AuthClient } from "./auth";
+export type { KVClient } from "./kv";
+export type { TMAConfig } from "../types";
+export type { TelegramUser, AuthResult, AuthState, KVKey, KVListResult, } from "../types";
+export { TMAError } from "./http";
+//# sourceMappingURL=index.d.ts.map

package/dist/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAM1C,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACvB;AAED;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,SAAS,GAAI,SAAS,SAAS,KAAG,SAG7C,CAAC;AAMH,YAAY,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACzC,YAAY,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AACrC,YAAY,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,YAAY,EACV,YAAY,EACZ,UAAU,EACV,SAAS,EACT,KAAK,EACL,YAAY,GACb,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAC"}

package/dist/client/kv.d.ts

@@ -0,0 +1,13 @@
+import type { TMAConfig, KVListResult } from "../types";
+export interface KVClient {
+    /** Store a value at the given key. Value is JSON-serialized. */
+    readonly set: (key: string, value: unknown) => Promise<void>;
+    /** Retrieve a value by key. Returns null if the key does not exist. */
+    readonly get: <T = unknown>(key: string) => Promise<T | null>;
+    /** Delete a key. */
+    readonly remove: (key: string) => Promise<void>;
+    /** List keys matching an optional prefix. */
+    readonly list: (prefix?: string) => Promise<KVListResult>;
+}
+export declare const createKVClient: (config?: TMAConfig) => KVClient;
+//# sourceMappingURL=kv.d.ts.map

package/dist/client/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/client/kv.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAMxD,MAAM,WAAW,QAAQ;IACvB,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAE7D,uEAAuE;IACvE,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAE9D,oBAAoB;IACpB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAEhD,6CAA6C;IAC7C,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;CAC3D;AAuBD,eAAO,MAAM,cAAc,GAAI,SAAS,SAAS,KAAG,QAyCnD,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,36 @@
+import type { TMAConfig, AuthState } from "../types";
+declare global {
+    interface Window {
+        Telegram?: {
+            WebApp?: {
+                initData?: string;
+            };
+        };
+    }
+}
+/**
+ * React hook that validates Telegram initData on mount and provides the
+ * authenticated user, JWT, loading state, and any error.
+ *
+ * @example
+ * ```tsx
+ * import { useTelegramAuth } from '@tma.sh/sdk/react';
+ *
+ * function App() {
+ *   const { user, jwt, isLoading, error } = useTelegramAuth({
+ *     projectId: 'my-project',
+ *   });
+ *
+ *   if (isLoading) return <div>Loading...</div>;
+ *   if (error) return <div>Error: {error.message}</div>;
+ *   if (!user) return <div>Not in Telegram</div>;
+ *
+ *   return <div>Welcome, {user.firstName}!</div>;
+ * }
+ * ```
+ */
+export declare const useTelegramAuth: (config?: TMAConfig) => AuthState;
+export { createTMA } from "../client/index";
+export type { TMAConfig, TMAClient, AuthClient, KVClient, } from "../client/index";
+export type { TelegramUser, AuthResult, AuthState } from "../types";
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMrD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE;YACT,MAAM,CAAC,EAAE;gBACP,QAAQ,CAAC,EAAE,MAAM,CAAC;aACnB,CAAC;SACH,CAAC;KACH;CACF;AAiED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,SAAS,KAAG,SAwBpD,CAAC;AAMF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/server/auth.d.ts

@@ -0,0 +1,53 @@
+import type { CryptoKey as JoseCryptoKey, FlattenedJWSInput, JWSHeaderParameters } from "jose";
+/**
+ * Authenticated Telegram user context set by the `requireUser` middleware.
+ */
+export interface UserContext {
+    readonly telegramId: number;
+    readonly firstName: string;
+    readonly lastName?: string;
+    readonly username?: string;
+    readonly projectId: string;
+}
+/**
+ * Hono environment variables for routes protected by `requireUser`.
+ */
+export interface AuthEnv {
+    Variables: {
+        user: UserContext;
+    };
+}
+/** A JWKS resolver function compatible with jose `jwtVerify`. */
+type JWKSResolver = (protectedHeader?: JWSHeaderParameters, token?: FlattenedJWSInput) => Promise<JoseCryptoKey>;
+/**
+ * Options for `requireUser`.
+ *
+ * Provide either a `jwksUrl` string (for production use) or a `jwks` resolver
+ * function (useful for testing with `createLocalJWKSet`).
+ */
+export interface RequireUserOptions {
+    /** URL to the JWKS endpoint. Defaults to the TMA public endpoint. */
+    readonly jwksUrl?: string;
+    /** Pre-built JWKS resolver (e.g. from `createLocalJWKSet` in tests). */
+    readonly jwks?: JWKSResolver;
+}
+/**
+ * Hono middleware that verifies a JWT from the `Authorization: Bearer <token>`
+ * header using the TMA JWKS endpoint (or a custom one).
+ *
+ * On success the authenticated {@link UserContext} is available via
+ * `c.get('user')` in downstream handlers.
+ *
+ * @example
+ * ```ts
+ * import { Hono } from 'hono';
+ * import { requireUser } from '@tma.sh/sdk/server';
+ *
+ * const app = new Hono();
+ * app.use('/api/*', requireUser());
+ * app.get('/api/me', (c) => c.json({ user: c.get('user') }));
+ * ```
+ */
+export declare const requireUser: (options?: RequireUserOptions) => import("hono/types").MiddlewareHandler<AuthEnv, string, {}, Response>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/server/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/server/auth.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,SAAS,IAAI,aAAa,EAC1B,iBAAiB,EACjB,mBAAmB,EACpB,MAAM,MAAM,CAAC;AAOd;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,SAAS,EAAE;QACT,IAAI,EAAE,WAAW,CAAC;KACnB,CAAC;CACH;AAED,iEAAiE;AACjE,KAAK,YAAY,GAAG,CAClB,eAAe,CAAC,EAAE,mBAAmB,EACrC,KAAK,CAAC,EAAE,iBAAiB,KACtB,OAAO,CAAC,aAAa,CAAC,CAAC;AAE5B;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,CAAC,EAAE,YAAY,CAAC;CAC9B;AAYD;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,WAAW,GAAI,UAAU,kBAAkB,0EAiCvD,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,24 @@
+export { requireUser } from "./auth";
+export type { AuthEnv, RequireUserOptions, UserContext } from "./auth";
+export { createKV } from "./kv";
+export type { KVNamespaceBinding, TypedKV } from "./kv";
+/**
+ * Validate Telegram initData locally using HMAC-SHA256 verification.
+ *
+ * This performs the same algorithm as the TMA API endpoint but runs
+ * entirely on the caller's server, requiring only the bot token. No API
+ * call is made.
+ *
+ * @param initData - Raw initData query string from Telegram WebApp
+ * @param botToken - The Telegram bot token used to verify the HMAC signature
+ * @returns The parsed and verified Telegram user, or null if invalid
+ */
+export declare const validateInitData: (initData: string, botToken: string) => Promise<ValidatedInitData | null>;
+export interface ValidatedInitData {
+    readonly telegramId: number;
+    readonly firstName: string;
+    readonly lastName?: string;
+    readonly username?: string;
+    readonly authDate: number;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/server/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACrC,YAAY,EAAE,OAAO,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,QAAQ,CAAC;AACvE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,YAAY,EAAE,kBAAkB,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAExD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,gBAAgB,GAC3B,UAAU,MAAM,EAChB,UAAU,MAAM,KACf,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAyElC,CAAC;AAMF,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B"}

package/dist/server/kv.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Minimal interface for a Cloudflare KV namespace binding.
+ *
+ * This avoids a hard dependency on `@cloudflare/workers-types` so consumers
+ * don't need that package installed. The real `KVNamespace` satisfies this.
+ */
+export interface KVNamespaceBinding {
+    get(key: string, type: "json"): Promise<unknown>;
+    put(key: string, value: string, options?: {
+        expirationTtl?: number;
+    }): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(options?: {
+        prefix?: string;
+    }): Promise<{
+        keys: ReadonlyArray<{
+            readonly name: string;
+        }>;
+    }>;
+}
+/**
+ * Typed KV client returned by {@link createKV}.
+ */
+export interface TypedKV {
+    /** Retrieve a JSON value by key. Returns `null` if the key does not exist. */
+    get: <T = unknown>(key: string) => Promise<T | null>;
+    /** Store a JSON-serializable value. Optionally set a TTL in seconds. */
+    set: (key: string, value: unknown, ttl?: number) => Promise<void>;
+    /** Delete a key from the store. */
+    delete: (key: string) => Promise<void>;
+    /** List key names, optionally filtered by prefix. */
+    list: (prefix?: string) => Promise<string[]>;
+}
+/**
+ * Wraps a Cloudflare KV namespace binding with typed `get`/`set`/`delete`/`list`
+ * methods. Values are automatically JSON-serialized on write and parsed on read.
+ *
+ * @example
+ * ```ts
+ * import { createKV } from '@tma.sh/sdk/server';
+ *
+ * const kv = createKV(c.env.KV);
+ * await kv.set('user:123', { name: 'Alice' });
+ * const user = await kv.get<{ name: string }>('user:123');
+ * ```
+ */
+export declare const createKV: (binding: KVNamespaceBinding) => TypedKV;
+//# sourceMappingURL=kv.d.ts.map

package/dist/server/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/server/kv.ts"],"names":[],"mappings":"AAIA;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CACD,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAE,GACnC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjB,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAC3C,IAAI,EAAE,aAAa,CAAC;YAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;KAChD,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,8EAA8E;IAC9E,GAAG,EAAE,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,wEAAwE;IACxE,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAClE,mCAAmC;IACnC,MAAM,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,qDAAqD;IACrD,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,QAAQ,GAAI,SAAS,kBAAkB,KAAG,OAsBrD,CAAC"}

package/dist/svelte/index.d.ts

@@ -0,0 +1,42 @@
+import { type Writable } from "svelte/store";
+import type { TMAConfig, AuthState } from "../types";
+declare global {
+    interface Window {
+        Telegram?: {
+            WebApp?: {
+                initData?: string;
+            };
+        };
+    }
+}
+/**
+ * Create a Svelte writable store that validates Telegram initData and
+ * provides the authenticated user, JWT, loading state, and any error.
+ *
+ * Call this function once (e.g. at the top level of your root layout) and
+ * subscribe to the returned store.
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { createTelegramAuth } from '@tma.sh/sdk/svelte';
+ *
+ *   const auth = createTelegramAuth({ projectId: 'my-project' });
+ * </script>
+ *
+ * {#if $auth.isLoading}
+ *   <p>Loading...</p>
+ * {:else if $auth.error}
+ *   <p>Error: {$auth.error.message}</p>
+ * {:else if $auth.user}
+ *   <p>Welcome, {$auth.user.firstName}!</p>
+ * {:else}
+ *   <p>Not in Telegram</p>
+ * {/if}
+ * ```
+ */
+export declare const createTelegramAuth: (config?: TMAConfig) => Writable<AuthState>;
+export { createTMA } from "../client/index";
+export type { TMAConfig, TMAClient, AuthClient, KVClient, } from "../client/index";
+export type { TelegramUser, AuthResult, AuthState } from "../types";
+//# sourceMappingURL=index.d.ts.map

package/dist/svelte/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/svelte/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEvD,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAMrD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,QAAQ,CAAC,EAAE;YACT,MAAM,CAAC,EAAE;gBACP,QAAQ,CAAC,EAAE,MAAM,CAAC;aACnB,CAAC;SACH,CAAC;KACH;CACF;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,kBAAkB,GAAI,SAAS,SAAS,KAAG,QAAQ,CAAC,SAAS,CA6DzE,CAAC;AAMF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EACV,SAAS,EACT,SAAS,EACT,UAAU,EACV,QAAQ,GACT,MAAM,iBAAiB,CAAC;AACzB,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,39 @@
+export interface TMAConfig {
+    /** Base URL for the TMA API. Defaults to https://api.tma.sh */
+    readonly apiUrl?: string;
+    /** Project ID to scope all SDK operations to */
+    readonly projectId?: string;
+}
+export interface TelegramUser {
+    readonly telegramId: number;
+    readonly firstName: string;
+    readonly lastName?: string;
+    readonly username?: string;
+}
+export interface AuthResult {
+    readonly jwt: string;
+    readonly user: TelegramUser;
+}
+export interface KVKey {
+    readonly name: string;
+}
+export interface KVListResult {
+    readonly keys: readonly KVKey[];
+    readonly list_complete: boolean;
+}
+export interface ApiSuccessResponse<T> {
+    readonly success: true;
+    readonly data: T;
+}
+export interface ApiErrorResponse {
+    readonly success: false;
+    readonly error: string;
+}
+export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
+export interface AuthState {
+    readonly user: TelegramUser | null;
+    readonly jwt: string | null;
+    readonly isLoading: boolean;
+    readonly error: Error | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,SAAS;IACxB,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAMD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B;AAMD,MAAM,WAAW,KAAK;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,SAAS,KAAK,EAAE,CAAC;IAChC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAMD,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,GAAG,gBAAgB,CAAC;AAMtE,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CAC9B"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tma.sh/sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "type": "module",
   "description": "SDK for Telegram Mini Apps on TMA -- auth, KV storage, and framework bindings",
   "license": "MIT",
@@ -26,6 +26,22 @@
       "types": "./dist/bot/index.d.ts"
     }
   },
+  "typesVersions": {
+    "*": {
+      "svelte": [
+        "dist/svelte/index.d.ts"
+      ],
+      "react": [
+        "dist/react/index.d.ts"
+      ],
+      "server": [
+        "dist/server/index.d.ts"
+      ],
+      "bot": [
+        "dist/bot/index.d.ts"
+      ]
+    }
+  },
   "files": [
     "dist"
   ],