@core-ease/telegram-kit 3.0.1

package/dist/chunk-JXK5HCDV.mjs

@@ -0,0 +1,254 @@
+"use client";
+// src/core/fallback.ts
+var DEV_MODE_STORAGE_KEY = "@core-ease/telegram-kit:dev-mode-active";
+function markDevModeActive() {
+  try {
+    if (typeof window !== "undefined") window.sessionStorage.setItem(DEV_MODE_STORAGE_KEY, "1");
+  } catch (e) {
+  }
+}
+function isDevModeActive() {
+  try {
+    return typeof window !== "undefined" && window.sessionStorage.getItem(DEV_MODE_STORAGE_KEY) === "1";
+  } catch (e) {
+    return false;
+  }
+}
+var STORAGE_PREFIX = "@core-ease/telegram-kit:fallback:";
+function createLocalStorageFallback(namespace) {
+  const prefix = `${STORAGE_PREFIX}${namespace}:`;
+  const hasLocalStorage = () => typeof window !== "undefined" && !!window.localStorage;
+  return {
+    async setItem(key, value) {
+      if (!hasLocalStorage()) return false;
+      try {
+        window.localStorage.setItem(prefix + key, value);
+        return true;
+      } catch (e) {
+        return false;
+      }
+    },
+    async getItem(key) {
+      if (!hasLocalStorage()) return void 0;
+      try {
+        const value = window.localStorage.getItem(prefix + key);
+        return value === null ? void 0 : value;
+      } catch (e) {
+        return void 0;
+      }
+    },
+    async getItems(keys) {
+      const result = {};
+      if (!hasLocalStorage()) return result;
+      for (const key of keys) {
+        try {
+          const value = window.localStorage.getItem(prefix + key);
+          if (value !== null) result[key] = value;
+        } catch (e) {
+        }
+      }
+      return result;
+    },
+    async removeItem(key) {
+      if (!hasLocalStorage()) return false;
+      try {
+        window.localStorage.removeItem(prefix + key);
+        return true;
+      } catch (e) {
+        return false;
+      }
+    },
+    async removeItems(keys) {
+      if (!hasLocalStorage()) return false;
+      try {
+        keys.forEach((key) => window.localStorage.removeItem(prefix + key));
+        return true;
+      } catch (e) {
+        return false;
+      }
+    },
+    async getKeys() {
+      if (!hasLocalStorage()) return [];
+      try {
+        const keys = [];
+        for (let i = 0; i < window.localStorage.length; i++) {
+          const rawKey = window.localStorage.key(i);
+          if (rawKey && rawKey.startsWith(prefix)) keys.push(rawKey.slice(prefix.length));
+        }
+        return keys;
+      } catch (e) {
+        return [];
+      }
+    },
+    async clear() {
+      if (!hasLocalStorage()) return false;
+      try {
+        const keys = await this.getKeys();
+        keys.forEach((key) => window.localStorage.removeItem(prefix + key));
+        return true;
+      } catch (e) {
+        return false;
+      }
+    }
+  };
+}
+var HAPTIC_PATTERNS = {
+  light: 10,
+  medium: 20,
+  heavy: 30,
+  rigid: 15,
+  soft: 10,
+  success: [10, 30, 10],
+  warning: [20, 40, 20],
+  error: [30, 60, 30],
+  selection: 5
+};
+function vibrateFallback(kind) {
+  try {
+    if (typeof navigator !== "undefined" && typeof navigator.vibrate === "function") {
+      navigator.vibrate(HAPTIC_PATTERNS[kind]);
+    }
+  } catch (e) {
+  }
+}
+function downloadFileFallback(url, fileName) {
+  try {
+    if (typeof document === "undefined") return false;
+    const a = document.createElement("a");
+    a.href = url;
+    a.download = fileName;
+    a.rel = "noopener";
+    a.target = "_blank";
+    document.body.appendChild(a);
+    a.click();
+    document.body.removeChild(a);
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+function getLocationFallback() {
+  return new Promise((resolve) => {
+    if (typeof navigator === "undefined" || !navigator.geolocation) {
+      resolve(null);
+      return;
+    }
+    navigator.geolocation.getCurrentPosition(
+      (position) => {
+        resolve({
+          latitude: position.coords.latitude,
+          longitude: position.coords.longitude,
+          altitude: position.coords.altitude,
+          course: position.coords.heading,
+          speed: position.coords.speed,
+          horizontal_accuracy: position.coords.accuracy,
+          vertical_accuracy: position.coords.altitudeAccuracy,
+          course_accuracy: null,
+          speed_accuracy: null
+        });
+      },
+      () => resolve(null),
+      { enableHighAccuracy: false, timeout: 8e3, maximumAge: 6e4 }
+    );
+  });
+}
+async function readClipboardFallback() {
+  var _a;
+  try {
+    if (typeof navigator !== "undefined" && ((_a = navigator.clipboard) == null ? void 0 : _a.readText)) {
+      const text = await navigator.clipboard.readText();
+      return text != null ? text : null;
+    }
+  } catch (e) {
+  }
+  return null;
+}
+function scanQrFallback(promptText) {
+  if (typeof window === "undefined" || typeof window.prompt !== "function") return null;
+  const value = window.prompt(promptText || "Enter the QR code value:");
+  return value && value.length ? value : null;
+}
+async function shareTextFallback(text, url) {
+  var _a;
+  try {
+    if (typeof navigator !== "undefined" && typeof navigator.share === "function") {
+      await navigator.share({ text, url });
+      return true;
+    }
+  } catch (e) {
+  }
+  try {
+    if (typeof navigator !== "undefined" && ((_a = navigator.clipboard) == null ? void 0 : _a.writeText)) {
+      await navigator.clipboard.writeText(url ? `${text}
+${url}` : text);
+      return true;
+    }
+  } catch (e) {
+  }
+  return false;
+}
+function callNativeOrFallback(options) {
+  const { ready, native, fallback, timeoutMs = 4e3 } = options;
+  if (!ready) {
+    try {
+      return Promise.resolve(fallback());
+    } catch (e) {
+      return Promise.reject(e);
+    }
+  }
+  return new Promise((resolve) => {
+    let settled = false;
+    const finish = async (useFallback, value) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      resolve(useFallback ? await fallback() : value);
+    };
+    const timer = setTimeout(() => finish(true), timeoutMs);
+    try {
+      native().then(
+        (value) => finish(false, value),
+        () => finish(true)
+      );
+    } catch (e) {
+      finish(true);
+    }
+  });
+}
+async function orientationLockFallback(locked) {
+  try {
+    const orientation = typeof screen !== "undefined" ? screen.orientation : void 0;
+    if (!orientation) return false;
+    if (locked) {
+      await orientation.lock("portrait");
+    } else if (typeof orientation.unlock === "function") {
+      orientation.unlock();
+    }
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+async function fullscreenFallback(enter, el) {
+  var _a, _b;
+  try {
+    if (typeof document === "undefined") return false;
+    if (enter) {
+      const target = el != null ? el : document.documentElement;
+      await ((_a = target.requestFullscreen) == null ? void 0 : _a.call(target));
+    } else if (document.fullscreenElement) {
+      await ((_b = document.exitFullscreen) == null ? void 0 : _b.call(document));
+    }
+    return true;
+  } catch (e) {
+    return false;
+  }
+}
+function safeInvoke(fn) {
+  try {
+    fn();
+  } catch (e) {
+  }
+}
+
+export { callNativeOrFallback, createLocalStorageFallback, downloadFileFallback, fullscreenFallback, getLocationFallback, isDevModeActive, markDevModeActive, orientationLockFallback, readClipboardFallback, safeInvoke, scanQrFallback, shareTextFallback, vibrateFallback };

package/dist/chunk-OMH2JGOH.mjs

@@ -0,0 +1,88 @@
+"use client";
+import { createAnimationPlayerComponent } from './chunk-BQEUEAVK.mjs';
+import { __objRest, __spreadProps, __spreadValues } from './chunk-PXO36YTU.mjs';
+import * as React from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/_internal/animation/lottie/validate.ts
+function checkTgsCompliance(data) {
+  var _a, _b;
+  const errors = [];
+  if (data.tgs !== 1) {
+    errors.push("Must be marked as a TGS Lottie variant (tgs: 1)");
+  }
+  if ((data.op - data.ip) / data.fr > 3) {
+    errors.push("Longer than 3 seconds");
+  }
+  if (data.w !== 512 || data.h !== 512) {
+    errors.push("Dimensions should be exactly 512x512px");
+  }
+  if (data.ddd != null && data.ddd !== 0) {
+    errors.push("Must not have 3D layers");
+  }
+  if (data.markers && data.markers.length > 0) {
+    errors.push("Must not have markers");
+  }
+  for (const asset of (_a = data.assets) != null ? _a : []) {
+    if (asset.layers) {
+      for (const layer of asset.layers) errors.push(...checkLayer(layer));
+    }
+  }
+  for (const layer of (_b = data.layers) != null ? _b : []) {
+    errors.push(...checkLayer(layer));
+  }
+  return errors;
+}
+function checkLayer(layer) {
+  const errors = [];
+  if (layer.ddd != null && layer.ddd !== 0) {
+    errors.push("Composition should not include any 3D Layers");
+  }
+  if (layer.sr != null && layer.sr !== 1) {
+    errors.push("Composition should not include any Time Stretching");
+  }
+  if (layer.tm != null) {
+    errors.push("Composition should not include any Time Remapping");
+  }
+  if (layer.ty === 1) errors.push("Composition should not include any Solids");
+  if (layer.ty === 2) errors.push("Composition should not include any Images");
+  if (layer.ty === 5) errors.push("Composition should not include any Texts");
+  if (layer.masksProperties && layer.masksProperties.length > 0) {
+    errors.push("Composition should not include any Masks");
+  }
+  if (layer.tt != null) errors.push("Composition should not include any Mattes");
+  if (layer.ao === 1) errors.push("Composition should not include any Auto-Oriented Layers");
+  if (layer.ef != null) errors.push("Composition should not include any Layer Effects");
+  if (layer.shapes) {
+    errors.push(...checkItems(layer.shapes));
+  }
+  return errors;
+}
+function checkItems(items, isShapesLevel) {
+  const errors = [];
+  if (!items) return errors;
+  for (const item of items) {
+    if (item.ty === "rp") errors.push("Composition should not include any Repeaters");
+    if (item.ty === "sr") errors.push("Composition should not include any Star Shapes");
+    if (item.ty === "mm") errors.push("Composition should not include any Merge Paths");
+    if (item.ty === "gs") errors.push("Composition should not include any Gradient Strokes");
+    if (item.ty === "gr") {
+      errors.push(...checkItems(item.it));
+    }
+  }
+  return errors;
+}
+var BaseAnimationPlayer = createAnimationPlayerComponent("TgsPlayer", "Telegram animated sticker");
+var TgsPlayer = React.forwardRef(function TgsPlayer2(props, ref) {
+  const _a = props, { strict = true } = _a, rest = __objRest(_a, ["strict"]);
+  return /* @__PURE__ */ jsx(
+    BaseAnimationPlayer,
+    __spreadProps(__spreadValues({}, rest), {
+      ref,
+      validate: strict ? checkTgsCompliance : void 0
+    })
+  );
+});
+TgsPlayer.displayName = "TgsPlayer";
+
+export { TgsPlayer, checkTgsCompliance };

package/dist/chunk-PXO36YTU.mjs

@@ -0,0 +1,38 @@
+"use client";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
+export { __export, __objRest, __spreadProps, __spreadValues };

package/dist/core/index.d.mts

@@ -0,0 +1,151 @@
+import { P as PopupParams, D as DownloadFileParams, W as WebAppUser, C as ColorScheme, T as ThemeParams, a as WebApp, H as HapticFeedback, L as LocationData, S as ShareToStoryParams } from '../webapp-B-3_74nK.mjs';
+import { E as EmojiStatusParams } from '../webapp-BDi9q3-a.mjs';
+
+/**
+ * Browser-native fallbacks for `@core-ease/telegram-kit`.
+ *
+ * Every wrapper in `core/index.ts` calls into the real bundled SDK first.
+ * When that isn't possible - the Mini App is opened in a plain browser tab,
+ * or the installed Telegram client is older than a feature needs - these
+ * helpers provide the closest standard Web API equivalent instead of
+ * rejecting the call or spamming the console with "not supported"
+ * warnings. Where no meaningful browser equivalent exists (biometrics,
+ * emoji status, Telegram-account actions, ...) the wrapper still resolves
+ * predictably (`false`/`null`/`[]`) instead of throwing.
+ */
+
+/** Swallows synchronous throws from fire-and-forget SDK calls (e.g. hard version gates). */
+declare function safeInvoke(fn: () => void): void;
+
+/** Returns the bundled SDK's `WebApp` instance directly (never reads `window.Telegram`). */
+declare function getWebApp(): WebApp | null;
+/**
+ * `true` once real Telegram init data has been observed - i.e. the Mini
+ * App was actually opened from inside Telegram, or `installDevMode()`
+ * seeded matching fake data for local testing.
+ */
+declare function isInTelegram(): boolean;
+declare function isVersionAtLeast(version: string): boolean;
+declare function getRawUserData(): WebAppUser | null;
+declare function getUserDisplayName(user?: WebAppUser): string;
+declare function getUserIdentifier(user?: WebAppUser): string;
+declare function getUserAvatarUrl(user?: WebAppUser, fallback?: string): string;
+declare function getUserInfoWithAvatar(): {
+    user: WebAppUser | undefined;
+    avatarUrl: string;
+    displayName: string;
+    identifier: string;
+};
+declare function openExternalLink(url: string, tryInstantView?: boolean): void;
+declare function openTelegramLink(url: string): void;
+/** No meaningful browser fallback exists for Telegram Payments; rejects clearly instead of hanging. */
+declare function openInvoice(url: string): Promise<'paid' | 'cancelled' | 'failed' | 'pending'>;
+declare function switchInlineQuery(query: string, chooseChatTypes?: Array<'users' | 'bots' | 'groups' | 'channels'>): void;
+declare function hideKeyboard(): void;
+declare function getTheme(): {
+    colorScheme: ColorScheme;
+    themeParams: ThemeParams;
+};
+declare function getViewport(): {
+    height: number;
+    stableHeight: number;
+    isExpanded: boolean;
+};
+declare function expand(): void;
+declare function ready(): void;
+declare function close(): void;
+/** Fullscreen API fallback outside Telegram / older clients. */
+declare const fullscreen: {
+    enter: () => Promise<boolean>;
+    exit: () => Promise<boolean>;
+};
+/** Screen Orientation API fallback outside Telegram / older clients. */
+declare const orientation: {
+    lock: () => Promise<boolean>;
+    unlock: () => Promise<boolean>;
+};
+declare function enableClosingConfirmation(): void;
+declare function disableClosingConfirmation(): void;
+declare function enableVerticalSwipes(): void;
+declare function disableVerticalSwipes(): void;
+declare function setHeaderColor(color: string): void;
+declare function setBackgroundColor(color: string): void;
+declare function setBottomBarColor(color: string): void;
+/** No meaningful browser equivalent (this adds a Telegram Mini App shortcut, specifically) - safely no-ops outside Telegram. */
+declare function addToHomeScreen(): void;
+declare function checkHomeScreenStatus(): Promise<'unsupported' | 'unknown' | 'added' | 'missed'>;
+declare const haptic: {
+    light: () => void | HapticFeedback;
+    medium: () => void | HapticFeedback;
+    heavy: () => void | HapticFeedback;
+    rigid: () => void | HapticFeedback;
+    soft: () => void | HapticFeedback;
+    success: () => void | HapticFeedback;
+    warning: () => void | HapticFeedback;
+    error: () => void | HapticFeedback;
+    selection: () => void | HapticFeedback;
+};
+declare const cloudStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<string | undefined>;
+    getItems: (keys: string[]) => Promise<Record<string, string>>;
+    removeItem: (key: string) => Promise<boolean>;
+    removeItems: (keys: string[]) => Promise<boolean>;
+    getKeys: () => Promise<string[]>;
+};
+declare const deviceStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<string | undefined>;
+    removeItem: (key: string) => Promise<boolean>;
+    clear: () => Promise<boolean>;
+};
+declare const secureStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<{
+        value: string | null | undefined;
+        canRestore: boolean;
+    }>;
+    removeItem: (key: string) => Promise<boolean>;
+    clear: () => Promise<boolean>;
+    restoreItem: (key: string) => Promise<string | undefined>;
+};
+declare const dialog: {
+    alert: (message: string) => Promise<void>;
+    confirm: (message: string) => Promise<boolean>;
+    popup: (params: PopupParams) => Promise<string | null>;
+    prompt: (message: string, defaultValue?: string) => Promise<string | null>;
+};
+declare function readClipboard(): Promise<string | null>;
+declare function scanQr(text?: string): Promise<string | null>;
+declare function shareToStory(mediaUrl: string, params?: ShareToStoryParams): void;
+declare function shareMessage(msgId: string): Promise<boolean>;
+declare function downloadFile(params: DownloadFileParams): Promise<boolean>;
+declare function setEmojiStatus(customEmojiId: string, params?: EmojiStatusParams): Promise<boolean>;
+declare function requestEmojiStatusAccess(): Promise<boolean>;
+declare function requestWriteAccess(): Promise<boolean>;
+declare function requestContact(): Promise<boolean>;
+/**
+ * Opens Telegram's native chat-request dialog for a chat request you
+ * already created server-side, identified by `reqId`. Requires Bot API
+ * 9.6+. No browser fallback exists for this Telegram-account action.
+ */
+declare function requestChat(reqId: string): Promise<boolean>;
+/** No fallback: this calls your own bot's server-side logic, which only exists via the real Telegram client. */
+declare function invokeCustomMethod(method: string, params?: object): Promise<unknown>;
+declare const biometric: {
+    init: () => Promise<void>;
+    requestAccess: (reason?: string) => Promise<boolean>;
+    authenticate: (reason?: string) => Promise<{
+        authenticated: boolean;
+        token?: string;
+    }>;
+    updateBiometricToken: (token: string) => Promise<boolean>;
+    openSettings: () => void;
+};
+declare const location: {
+    init: () => Promise<void>;
+    getLocation: () => Promise<LocationData | null>;
+    openSettings: () => void;
+};
+
+export { addToHomeScreen, biometric, checkHomeScreenStatus, close, cloudStorage, deviceStorage, dialog, disableClosingConfirmation, disableVerticalSwipes, downloadFile, enableClosingConfirmation, enableVerticalSwipes, expand, fullscreen, getRawUserData, getTheme, getUserAvatarUrl, getUserDisplayName, getUserIdentifier, getUserInfoWithAvatar, getViewport, getWebApp, haptic, hideKeyboard, invokeCustomMethod, isInTelegram, isVersionAtLeast, location, openExternalLink, openInvoice, openTelegramLink, orientation, readClipboard, ready, requestChat, requestContact, requestEmojiStatusAccess, requestWriteAccess, safeInvoke, scanQr, secureStorage, setBackgroundColor, setBottomBarColor, setEmojiStatus, setHeaderColor, shareMessage, shareToStory, switchInlineQuery };

package/dist/core/index.d.ts

@@ -0,0 +1,151 @@
+import { P as PopupParams, D as DownloadFileParams, W as WebAppUser, C as ColorScheme, T as ThemeParams, a as WebApp, H as HapticFeedback, L as LocationData, S as ShareToStoryParams } from '../webapp-B-3_74nK.js';
+import { E as EmojiStatusParams } from '../webapp-YvmwFYUQ.js';
+
+/**
+ * Browser-native fallbacks for `@core-ease/telegram-kit`.
+ *
+ * Every wrapper in `core/index.ts` calls into the real bundled SDK first.
+ * When that isn't possible - the Mini App is opened in a plain browser tab,
+ * or the installed Telegram client is older than a feature needs - these
+ * helpers provide the closest standard Web API equivalent instead of
+ * rejecting the call or spamming the console with "not supported"
+ * warnings. Where no meaningful browser equivalent exists (biometrics,
+ * emoji status, Telegram-account actions, ...) the wrapper still resolves
+ * predictably (`false`/`null`/`[]`) instead of throwing.
+ */
+
+/** Swallows synchronous throws from fire-and-forget SDK calls (e.g. hard version gates). */
+declare function safeInvoke(fn: () => void): void;
+
+/** Returns the bundled SDK's `WebApp` instance directly (never reads `window.Telegram`). */
+declare function getWebApp(): WebApp | null;
+/**
+ * `true` once real Telegram init data has been observed - i.e. the Mini
+ * App was actually opened from inside Telegram, or `installDevMode()`
+ * seeded matching fake data for local testing.
+ */
+declare function isInTelegram(): boolean;
+declare function isVersionAtLeast(version: string): boolean;
+declare function getRawUserData(): WebAppUser | null;
+declare function getUserDisplayName(user?: WebAppUser): string;
+declare function getUserIdentifier(user?: WebAppUser): string;
+declare function getUserAvatarUrl(user?: WebAppUser, fallback?: string): string;
+declare function getUserInfoWithAvatar(): {
+    user: WebAppUser | undefined;
+    avatarUrl: string;
+    displayName: string;
+    identifier: string;
+};
+declare function openExternalLink(url: string, tryInstantView?: boolean): void;
+declare function openTelegramLink(url: string): void;
+/** No meaningful browser fallback exists for Telegram Payments; rejects clearly instead of hanging. */
+declare function openInvoice(url: string): Promise<'paid' | 'cancelled' | 'failed' | 'pending'>;
+declare function switchInlineQuery(query: string, chooseChatTypes?: Array<'users' | 'bots' | 'groups' | 'channels'>): void;
+declare function hideKeyboard(): void;
+declare function getTheme(): {
+    colorScheme: ColorScheme;
+    themeParams: ThemeParams;
+};
+declare function getViewport(): {
+    height: number;
+    stableHeight: number;
+    isExpanded: boolean;
+};
+declare function expand(): void;
+declare function ready(): void;
+declare function close(): void;
+/** Fullscreen API fallback outside Telegram / older clients. */
+declare const fullscreen: {
+    enter: () => Promise<boolean>;
+    exit: () => Promise<boolean>;
+};
+/** Screen Orientation API fallback outside Telegram / older clients. */
+declare const orientation: {
+    lock: () => Promise<boolean>;
+    unlock: () => Promise<boolean>;
+};
+declare function enableClosingConfirmation(): void;
+declare function disableClosingConfirmation(): void;
+declare function enableVerticalSwipes(): void;
+declare function disableVerticalSwipes(): void;
+declare function setHeaderColor(color: string): void;
+declare function setBackgroundColor(color: string): void;
+declare function setBottomBarColor(color: string): void;
+/** No meaningful browser equivalent (this adds a Telegram Mini App shortcut, specifically) - safely no-ops outside Telegram. */
+declare function addToHomeScreen(): void;
+declare function checkHomeScreenStatus(): Promise<'unsupported' | 'unknown' | 'added' | 'missed'>;
+declare const haptic: {
+    light: () => void | HapticFeedback;
+    medium: () => void | HapticFeedback;
+    heavy: () => void | HapticFeedback;
+    rigid: () => void | HapticFeedback;
+    soft: () => void | HapticFeedback;
+    success: () => void | HapticFeedback;
+    warning: () => void | HapticFeedback;
+    error: () => void | HapticFeedback;
+    selection: () => void | HapticFeedback;
+};
+declare const cloudStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<string | undefined>;
+    getItems: (keys: string[]) => Promise<Record<string, string>>;
+    removeItem: (key: string) => Promise<boolean>;
+    removeItems: (keys: string[]) => Promise<boolean>;
+    getKeys: () => Promise<string[]>;
+};
+declare const deviceStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<string | undefined>;
+    removeItem: (key: string) => Promise<boolean>;
+    clear: () => Promise<boolean>;
+};
+declare const secureStorage: {
+    setItem: (key: string, value: string) => Promise<boolean>;
+    getItem: (key: string) => Promise<{
+        value: string | null | undefined;
+        canRestore: boolean;
+    }>;
+    removeItem: (key: string) => Promise<boolean>;
+    clear: () => Promise<boolean>;
+    restoreItem: (key: string) => Promise<string | undefined>;
+};
+declare const dialog: {
+    alert: (message: string) => Promise<void>;
+    confirm: (message: string) => Promise<boolean>;
+    popup: (params: PopupParams) => Promise<string | null>;
+    prompt: (message: string, defaultValue?: string) => Promise<string | null>;
+};
+declare function readClipboard(): Promise<string | null>;
+declare function scanQr(text?: string): Promise<string | null>;
+declare function shareToStory(mediaUrl: string, params?: ShareToStoryParams): void;
+declare function shareMessage(msgId: string): Promise<boolean>;
+declare function downloadFile(params: DownloadFileParams): Promise<boolean>;
+declare function setEmojiStatus(customEmojiId: string, params?: EmojiStatusParams): Promise<boolean>;
+declare function requestEmojiStatusAccess(): Promise<boolean>;
+declare function requestWriteAccess(): Promise<boolean>;
+declare function requestContact(): Promise<boolean>;
+/**
+ * Opens Telegram's native chat-request dialog for a chat request you
+ * already created server-side, identified by `reqId`. Requires Bot API
+ * 9.6+. No browser fallback exists for this Telegram-account action.
+ */
+declare function requestChat(reqId: string): Promise<boolean>;
+/** No fallback: this calls your own bot's server-side logic, which only exists via the real Telegram client. */
+declare function invokeCustomMethod(method: string, params?: object): Promise<unknown>;
+declare const biometric: {
+    init: () => Promise<void>;
+    requestAccess: (reason?: string) => Promise<boolean>;
+    authenticate: (reason?: string) => Promise<{
+        authenticated: boolean;
+        token?: string;
+    }>;
+    updateBiometricToken: (token: string) => Promise<boolean>;
+    openSettings: () => void;
+};
+declare const location: {
+    init: () => Promise<void>;
+    getLocation: () => Promise<LocationData | null>;
+    openSettings: () => void;
+};
+
+export { addToHomeScreen, biometric, checkHomeScreenStatus, close, cloudStorage, deviceStorage, dialog, disableClosingConfirmation, disableVerticalSwipes, downloadFile, enableClosingConfirmation, enableVerticalSwipes, expand, fullscreen, getRawUserData, getTheme, getUserAvatarUrl, getUserDisplayName, getUserIdentifier, getUserInfoWithAvatar, getViewport, getWebApp, haptic, hideKeyboard, invokeCustomMethod, isInTelegram, isVersionAtLeast, location, openExternalLink, openInvoice, openTelegramLink, orientation, readClipboard, ready, requestChat, requestContact, requestEmojiStatusAccess, requestWriteAccess, safeInvoke, scanQr, secureStorage, setBackgroundColor, setBottomBarColor, setEmojiStatus, setHeaderColor, shareMessage, shareToStory, switchInlineQuery };