@tma.js/sdk 0.11.6 → 0.12.0

package/dist/dts/components/CloudStorage/CloudStorage.d.ts

@@ -1,4 +1,4 @@
-import { type RequestOptions } from '@tma.js/bridge';
+import { postEvent as defaultPostEvent, type RequestOptions } from '@tma.js/bridge';
 import type { Version } from '@tma.js/utils';
 import { type SupportsFunc } from '../../supports.js';
 import type { CreateRequestIdFunc } from '../../types.js';
@@ -6,7 +6,7 @@ type WiredRequestOptions = Omit<RequestOptions, 'postEvent'>;
 export declare class CloudStorage {
     private readonly createRequestId;
     private readonly postEvent;
-    constructor(version: Version, createRequestId: CreateRequestIdFunc, postEvent?: any);
+    constructor(version: Version, createRequestId: CreateRequestIdFunc, postEvent?: typeof defaultPostEvent);
     /**
      * Invokes custom method related to CloudStorage.
      * @param method - method name.

package/dist/dts/components/ThemeParams/ThemeParams.d.ts

@@ -1,6 +1,7 @@
+import { type ThemeParams as ThemeParamsType } from '@tma.js/theme-params';
 import { type RequestOptions } from '@tma.js/bridge';
 import type { RGB } from '@tma.js/colors';
-import { type ThemeParamsType } from '../../theme-params.js';
+import type { ThemeParamsEvents } from './types.js';
 /**
  * Contains information about currently used theme by application.
  * @see https://core.telegram.org/bots/webapps#themeparams
@@ -56,11 +57,11 @@ export declare class ThemeParams {
     /**
      * Adds new event listener.
      */
-    on: any;
+    on: <E extends "changed" | "backgroundColorChanged" | "textColorChanged" | "buttonColorChanged" | "buttonTextColorChanged" | "hintColorChanged" | "linkColorChanged" | "secondaryBackgroundColorChanged">(event: E, listener: import("@tma.js/event-emitter").EventListener<ThemeParamsEvents[E]>) => void;
     /**
      * Removes event listener.
      */
-    off: any;
+    off: <E extends "changed" | "backgroundColorChanged" | "textColorChanged" | "buttonColorChanged" | "buttonTextColorChanged" | "hintColorChanged" | "linkColorChanged" | "secondaryBackgroundColorChanged">(event: E, listener: import("@tma.js/event-emitter").EventListener<ThemeParamsEvents[E]>) => void;
     /**
      * Returns secondary background color.
      */

package/dist/dts/components/ThemeParams/types.d.ts

@@ -1,8 +1,8 @@
 import type { HasUndefined, If } from '@tma.js/util-types';
-import type { ThemeParamsType } from '../../theme-params.js';
+import type { ThemeParams } from '@tma.js/theme-params';
 import type { StateEvents } from '../../state/index.js';
 export type ThemeParamsState = {
-    [K in keyof ThemeParamsType]-?: If<HasUndefined<ThemeParamsType[K]>, Exclude<ThemeParamsType[K], undefined> | null, ThemeParamsType[K]>;
+    [K in keyof ThemeParams]-?: If<HasUndefined<ThemeParams[K]>, Exclude<ThemeParams[K], undefined> | null, ThemeParams[K]>;
 };
 export type ThemeParamsEvents = StateEvents<ThemeParamsState>;
 export type ThemeParamsEventName = keyof ThemeParamsEvents;

package/dist/dts/components/WebApp/WebApp.d.ts

@@ -1,9 +1,10 @@
 import { type Version } from '@tma.js/utils';
 import { type RGB } from '@tma.js/colors';
 import { type PhoneRequestedStatus, type WriteAccessRequestedStatus, type InvoiceStatus, type PostEvent } from '@tma.js/bridge';
+import type { Platform } from '@tma.js/launch-params';
 import { type SupportsFunc } from '../../supports.js';
-import type { ColorScheme, Platform } from '../../types.js';
-import type { WebAppHeaderColor } from './types.js';
+import type { ColorScheme } from '../../types.js';
+import type { WebAppEvents, WebAppHeaderColor } from './types.js';
 /**
  * Provides common Web Apps functionality not covered by other system
  * components.
@@ -65,11 +66,11 @@ export declare class WebApp {
     /**
      * Adds new event listener.
      */
-    on: any;
+    on: <E extends "changed" | "backgroundColorChanged" | "headerColorChanged">(event: E, listener: import("@tma.js/event-emitter").EventListener<WebAppEvents[E]>) => void;
     /**
      * Removes event listener.
      */
-    off: any;
+    off: <E extends "changed" | "backgroundColorChanged" | "headerColorChanged">(event: E, listener: import("@tma.js/event-emitter").EventListener<WebAppEvents[E]>) => void;
     /**
      * Returns current Web App platform.
      */

package/dist/dts/index.d.ts

@@ -1,8 +1,7 @@
 export * from './components/index.js';
-export { init, type InitResult, type InitOptions } from './init/index.js';
-export { MethodNotSupportedError } from './errors/index.js';
+export * from './errors/index.js';
+export * from './init/index.js';
 export * from './env.js';
 export * from './launch-params.js';
-export * from './theme-params.js';
 export * from './types.js';
 export * from './url.js';

package/dist/dts/init/creators/createBackButton.d.ts

@@ -3,7 +3,8 @@ import { BackButton } from '../../components/index.js';
 /**
  * Creates BackButton instance using last locally saved data also saving each state in
  * the storage.
+ * @param isPageReload - was current page reloaded.
  * @param version - platform version.
  * @param postEvent - Bridge postEvent function
  */
-export declare function createBackButton(version: string, postEvent: PostEvent): BackButton;
+export declare function createBackButton(isPageReload: boolean, version: string, postEvent: PostEvent): BackButton;

package/dist/dts/init/creators/createClosingBehavior.d.ts

@@ -3,6 +3,7 @@ import { ClosingBehaviour } from '../../components/index.js';
 /**
  * Creates ClosingBehaviour instance using last locally saved data also saving each state in
  * the storage.
+ * @param isPageReload - was current page reloaded.
  * @param postEvent - Bridge postEvent function
  */
-export declare function createClosingBehavior(postEvent: PostEvent): ClosingBehaviour;
+export declare function createClosingBehavior(isPageReload: boolean, postEvent: PostEvent): ClosingBehaviour;

package/dist/dts/init/creators/createMainButton.d.ts

@@ -4,8 +4,9 @@ import { MainButton } from '../../components/index.js';
 /**
  * Creates MainButton instance using last locally saved data also saving each state in
  * the storage.
+ * @param isPageReload - was current page reloaded.
  * @param backgroundColor - background color.
  * @param textColor - text color.
  * @param postEvent - Bridge postEvent function
  */
-export declare function createMainButton(backgroundColor: RGB, textColor: RGB, postEvent: PostEvent): MainButton;
+export declare function createMainButton(isPageReload: boolean, backgroundColor: RGB, textColor: RGB, postEvent: PostEvent): MainButton;

package/dist/dts/init/creators/createThemeParams.d.ts

@@ -0,0 +1,7 @@
+import type { ThemeParams as ThemeParamsType } from '@tma.js/theme-params';
+import { ThemeParams } from '../../components/index.js';
+/**
+ * Creates synced instance of ThemeParams.
+ * @param params - theme parameters.
+ */
+export declare function createThemeParams(params: ThemeParamsType): ThemeParams;

package/dist/dts/init/creators/createViewport.d.ts

@@ -1,10 +1,11 @@
 import type { PostEvent } from '@tma.js/bridge';
+import type { Platform } from '@tma.js/launch-params';
 import { Viewport } from '../../components/index.js';
-import type { Platform } from '../../types.js';
 /**
  * Creates Viewport instance using last locally saved data also saving each state in
  * the storage.
+ * @param isPageReload - was current page reloaded.
  * @param platform - Telegram Web Apps platform name.
  * @param postEvent - Bridge postEvent function
  */
-export declare function createViewport(platform: Platform, postEvent: PostEvent): Promise<Viewport>;
+export declare function createViewport(isPageReload: boolean, platform: Platform, postEvent: PostEvent): Promise<Viewport>;

package/dist/dts/init/creators/createWebApp.d.ts

@@ -1,14 +1,16 @@
 import type { RGB } from '@tma.js/colors';
 import type { PostEvent } from '@tma.js/bridge';
+import type { Platform } from '@tma.js/launch-params';
 import { WebApp } from '../../components/index.js';
-import type { CreateRequestIdFunc, Platform } from '../../types.js';
+import type { CreateRequestIdFunc } from '../../types.js';
 /**
  * Creates WebApp instance using last locally saved data also saving each state in
  * the storage.
+ * @param isPageReload - was current page reloaded.
  * @param backgroundColor - web app background color.
  * @param version - platform version.
  * @param platform - Telegram Web Apps platform name.
  * @param createRequestId - function which generates request identifiers.
  * @param postEvent - Bridge postEvent function
  */
-export declare function createWebApp(backgroundColor: RGB, version: string, platform: Platform, createRequestId: CreateRequestIdFunc, postEvent: PostEvent): WebApp;
+export declare function createWebApp(isPageReload: boolean, backgroundColor: RGB, version: string, platform: Platform, createRequestId: CreateRequestIdFunc, postEvent: PostEvent): WebApp;

package/dist/dts/init/creators/index.d.ts

@@ -3,6 +3,6 @@ export * from './createClosingBehavior.js';
 export * from './createMainButton.js';
 export * from './createPostEvent.js';
 export * from './createRequestIdGenerator.js';
-export * from './createSyncedThemeParams.js';
+export * from './createThemeParams.js';
 export * from './createViewport.js';
 export * from './createWebApp.js';

package/dist/dts/init/types.d.ts

@@ -1,7 +1,7 @@
 import type { PostEvent } from '@tma.js/bridge';
+import type { LaunchParams } from '@tma.js/launch-params';
 import type { BackButton, ClosingBehaviour, CloudStorage, HapticFeedback, InitData, MainButton, Popup, QRScanner, ThemeParams, Viewport, WebApp } from '../components/index.js';
-import type { LaunchParams } from '../launch-params.js';
-export type InitResult = {
+export interface InitResult {
     backButton: BackButton;
     closingBehavior: ClosingBehaviour;
     cloudStorage: CloudStorage;
@@ -15,8 +15,8 @@ export type InitResult = {
     themeParams: ThemeParams;
     viewport: Viewport;
     webApp: WebApp;
-};
-export type InitCSSVarsSpecificOption = {
+}
+export interface InitCSSVarsSpecificOption {
     /**
      * Enables theme parameters CSS variables:
      * - `--tg-theme-bg-color`
@@ -46,7 +46,7 @@ export type InitCSSVarsSpecificOption = {
      * @see bindWebAppVariables
      */
     webApp?: true;
-};
+}
 export type InitCSSVarsOption = boolean | InitCSSVarsSpecificOption;
 export interface InitOptions {
     /**

package/dist/dts/launch-params.d.ts

@@ -1,20 +1,6 @@
-import { type InitData } from '@tma.js/init-data';
-import { type ThemeParamsType } from './theme-params.js';
-import type { Platform } from './types.js';
-export interface LaunchParams {
-    version: string;
-    initData?: InitData;
-    initDataRaw?: string;
-    platform: Platform;
-    themeParams: ThemeParamsType;
-}
+import type { LaunchParams } from '@tma.js/launch-params';
 /**
- * Parses query parameters as launch parameters.
- * @param query - query parameters presented as string or URLSearchParams
- * instance.
- */
-export declare function parseLaunchParams(query: string | URLSearchParams): LaunchParams;
-/**
- * Extracts launch params from the current environment.
+ * Attempts to extract launch params from window.location.hash. In case, window.location.hash
+ * lacks of valid data, function attempts to extract launch params from the sessionStorage.
  */
 export declare function retrieveLaunchParams(): LaunchParams;

package/dist/dts/state/State.d.ts

@@ -6,7 +6,7 @@ import type { StateEvents, StringKeys } from './types.js';
 export declare class State<S extends object> {
     private readonly state;
     private readonly ee?;
-    constructor(state: S, ee?: EventEmitter<StateEvents<S>>);
+    constructor(state: S, ee?: EventEmitter<StateEvents<S>> | undefined);
     private emit;
     private internalSet;
     set<K extends StringKeys<S>>(key: K, value: S[K]): void;

package/dist/dts/storage.d.ts

@@ -28,7 +28,6 @@ interface StorageParams {
         backgroundColor: RGB;
         headerColor: HeaderColorKey | RGB;
     };
-    'launch-params': string;
 }
 /**
  * Key which could be used to store data in storage.

package/dist/dts/types.d.ts

@@ -4,10 +4,6 @@ export type PostEvent = BridgePostEvent;
  * Color scheme.
  */
 export type ColorScheme = 'dark' | 'light';
-/**
- * Native Telegram application identifier.
- */
-export type Platform = 'android' | 'android_x' | 'ios' | 'macos' | 'tdesktop' | 'web' | 'weba' | 'unigram' | 'unknown' | string;
 /**
  * Function which generates unique request identifiers.
  */