@tma.js/sdk 2.6.1 → 3.0.0

package/dist/dts/features/uncategorized/shareStory.d.ts

@@ -0,0 +1,50 @@
+import { PostEventError } from '@tma.js/bridge';
+import * as E from 'fp-ts/Either';
+export interface ShareStoryOptions {
+    /**
+     * The caption to be added to the media.
+     * 0-200 characters for regular users and 0-2048 characters for premium subscribers.
+     * @see https://telegram.org/faq_premium#telegram-premium
+     */
+    text?: string;
+    /**
+     * An object that describes a widget link to be included in the story.
+     * Note that only premium subscribers can post stories with links.
+     * @see https://telegram.org/faq_premium#telegram-premium
+     */
+    widgetLink?: {
+        /**
+         * The URL to be included in the story.
+         */
+        url: string;
+        /**
+         * The name to be displayed for the widget link, 0-48 characters.
+         */
+        name?: string;
+    };
+}
+export type ShareStoryError = PostEventError;
+/**
+ * Opens the native story editor.
+ * @since Mini Apps v7.8
+ * @example
+ * pipe(
+ *   shareStory('https://example.com/background.png', {
+ *     text: 'Look at this cool group!',
+ *     widgetLink: {
+ *       url: 'https://t.me/heyqbnk',
+ *       name: 'Vlad\'s community',
+ *     },
+ *   }),
+ *   TE.match(error => {
+ *     console.error('Something went wrong', error);
+ *   }, () => {
+ *     console.log('Call was successful');
+ *   }),
+ * );
+ */
+export declare const shareStoryFp: import('../../with-checks/withChecksFp.js').WithChecksFp<(mediaUrl: string, options?: ShareStoryOptions) => E.Either<ShareStoryError, void>, true, never>;
+/**
+ * @see shareStoryFp
+ */
+export declare const shareStory: import('../../with-checks/withChecksFp.js').WithChecks<(mediaUrl: string, options?: ShareStoryOptions) => E.Either<ShareStoryError, void>, true, never>;

package/dist/dts/features/uncategorized/switchInlineQuery.d.ts

@@ -0,0 +1,28 @@
+import { PostEventError, SwitchInlineQueryChatType } from '@tma.js/bridge';
+import * as E from 'fp-ts/Either';
+export type SwitchInlineQueryError = PostEventError;
+/**
+ * Inserts the bot's username and the specified inline query in the current chat's input field.
+ * Query may be empty, in which case only the bot's username will be inserted. The client prompts
+ * the user to choose a specific chat, then opens that chat and inserts the bot's username and
+ * the specified inline query in the input field.
+ * @param query - text which should be inserted in the input after the current bot name. Max
+ * length is 256 symbols.
+ * @param chatTypes - List of chat types which could be chosen to send the message. Could be an
+ * empty list.
+ * @since Mini Apps v6.7
+ * @example
+ * pipe(
+ *   switchInlineQuery('my query goes here', ['users']),
+ *   E.match(error => {
+ *     console.error('Something went wrong', error);
+ *   }, () => {
+ *     console.log('Call was successful');
+ *   }),
+ * );
+ */
+export declare const switchInlineQueryFp: import('../../with-checks/withChecksFp.js').WithChecksFp<(query: string, chatTypes?: SwitchInlineQueryChatType[]) => E.Either<SwitchInlineQueryError, void>, true, never>;
+/**
+ * @see switchInlineQueryFp
+ */
+export declare const switchInlineQuery: import('../../with-checks/withChecksFp.js').WithChecks<(query: string, chatTypes?: SwitchInlineQueryChatType[]) => E.Either<SwitchInlineQueryError, void>, true, never>;

package/dist/dts/fn-options/bottomButtonOptions.d.ts

@@ -0,0 +1,11 @@
+import { EventName } from '@tma.js/bridge';
+export declare function bottomButtonOptions<S, D>(storageName: string, trackedClickEvent: EventName, defaults: D): {
+    defaults: D;
+    onClick(listener: VoidFunction, once?: boolean): VoidFunction;
+    offClick(listener: VoidFunction, once?: boolean): void;
+    isTma: import('../types.js').MaybeAccessor<boolean>;
+    postEvent: import('@tma.js/bridge').PostEventFpFn;
+    version: import('../types.js').MaybeAccessor<import('@tma.js/types').Version>;
+    storage: import('../helpers/component-storage.js').ComponentStorage<S>;
+    isPageReload: import('../types.js').MaybeAccessor<boolean>;
+};

package/dist/dts/fn-options/buttonOptions.d.ts

@@ -0,0 +1,10 @@
+import { EventName } from '@tma.js/bridge';
+export declare function buttonOptions<S>(storageName: string, trackedClickEvent: EventName): {
+    onClick(listener: VoidFunction, once?: boolean): VoidFunction;
+    offClick(listener: VoidFunction, once?: boolean): void;
+    isTma: import('../types.js').MaybeAccessor<boolean>;
+    postEvent: import('@tma.js/bridge').PostEventFpFn;
+    version: import('../types.js').MaybeAccessor<import('@tma.js/types').Version>;
+    storage: import('../helpers/component-storage.js').ComponentStorage<S>;
+    isPageReload: import('../types.js').MaybeAccessor<boolean>;
+};

package/dist/dts/fn-options/createFnOption.d.ts

@@ -0,0 +1,2 @@
+import { MaybeAccessor } from '../types.js';
+export declare function createFnOption<T>(mix: MaybeAccessor<T>): <O extends object>(obj: O) => O & T;

package/dist/dts/fn-options/sharedFeatureOptions.d.ts

@@ -0,0 +1,8 @@
+import { MaybeAccessor } from '../types.js';
+export interface SharedFeatureOptions {
+    /**
+     * True if the current environment is Telegram Mini Apps.
+     */
+    isTma: MaybeAccessor<boolean>;
+}
+export declare function sharedFeatureOptions(): SharedFeatureOptions;

package/dist/dts/fn-options/withInvokeCustomMethod.d.ts

@@ -0,0 +1,11 @@
+import { CustomMethodParams, CustomMethodName, InvokeCustomMethodError, InvokeCustomMethodFpOptions, RequestError } from '@tma.js/bridge';
+import type * as TE from 'fp-ts/TaskEither';
+export type { InvokeCustomMethodError };
+export interface InvokeCustomMethodNoRequestIdFn {
+    <M extends CustomMethodName>(this: void, method: M, params: CustomMethodParams<M>, options?: InvokeCustomMethodFpOptions): TE.TaskEither<InvokeCustomMethodError, unknown>;
+    (this: void, method: string, params: object, options?: InvokeCustomMethodFpOptions): TE.TaskEither<RequestError, unknown>;
+}
+export interface WithInvokeCustomMethod {
+    invokeCustomMethod: InvokeCustomMethodNoRequestIdFn;
+}
+export declare const withInvokeCustomMethod: <O extends object>(obj: O) => O & WithInvokeCustomMethod;

package/dist/dts/fn-options/withPostEvent.d.ts

@@ -0,0 +1,8 @@
+import { PostEventFpFn } from '@tma.js/bridge';
+export interface WithPostEvent {
+    /**
+     * A postEvent function to use to call Mini Apps methods.
+     */
+    postEvent: PostEventFpFn;
+}
+export declare const withPostEvent: <O extends object>(obj: O) => O & WithPostEvent;

package/dist/dts/fn-options/withRequest.d.ts

@@ -0,0 +1,8 @@
+import { RequestFpFn } from '@tma.js/bridge';
+export interface WithRequest {
+    /**
+     * A request function to use to call Mini Apps methods.
+     */
+    request: RequestFpFn;
+}
+export declare const withRequest: <O extends object>(obj: O) => O & WithRequest;

package/dist/dts/fn-options/withStateRestore.d.ts

@@ -0,0 +1,13 @@
+import { ComponentStorage } from '../helpers/component-storage.js';
+import { MaybeAccessor } from '../types.js';
+export interface WithStateRestore<T> {
+    /**
+     * A storage the component could use to store its data.
+     */
+    storage: ComponentStorage<T>;
+    /**
+     * True if the current page is reloaded.
+     */
+    isPageReload: MaybeAccessor<boolean>;
+}
+export declare function withStateRestore<S>(storageName: string): <O extends object>(obj: O) => O & WithStateRestore<S>;

package/dist/dts/fn-options/withVersion.d.ts

@@ -0,0 +1,9 @@
+import { Version } from '@tma.js/types';
+import { MaybeAccessor } from '../types.js';
+export interface WithVersion {
+    /**
+     * The currently supported Telegram Mini Apps version by the Telegram client.
+     */
+    version: MaybeAccessor<Version>;
+}
+export declare const withVersion: <O extends object>(obj: O) => O & WithVersion;

package/dist/dts/globals/createRequestId.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @returns A new request identifier.
+ */
+export declare function createRequestId(): string;

package/dist/dts/globals/inline-mode.d.ts

@@ -0,0 +1,4 @@
+/**
+ * True if the application is launched in inline mode.
+ */
+export declare const isInlineMode: import('@tma.js/signals').Signal<boolean>;

package/dist/dts/globals/invokeCustomMethod.d.ts

@@ -0,0 +1,16 @@
+import { RequestError, CustomMethodName, CustomMethodParams, InvokeCustomMethodOptions } from '@tma.js/bridge';
+import * as TE from 'fp-ts/TaskEither';
+/**
+ * Invokes known custom method. Returns method execution result.
+ * @param method - method name.
+ * @param params - method parameters.
+ * @param options - additional options.
+ */
+export declare function invokeCustomMethod<M extends CustomMethodName>(method: M, params: CustomMethodParams<M>, options?: InvokeCustomMethodOptions): TE.TaskEither<RequestError, unknown>;
+/**
+ * Invokes unknown custom method. Returns method execution result.
+ * @param method - method name.
+ * @param params - method parameters.
+ * @param options - additional options.
+ */
+export declare function invokeCustomMethod(method: string, params: object, options?: InvokeCustomMethodOptions): TE.TaskEither<RequestError, unknown>;

package/dist/dts/globals/post-event.d.ts

@@ -0,0 +1,4 @@
+import { postEventFp as _postEventFp, PostEventFpFn, PostEventFn } from '@tma.js/bridge';
+export declare const postEventFpSignal: import('@tma.js/signals').Signal<typeof _postEventFp>;
+export declare const postEventFp: PostEventFpFn;
+export declare const postEvent: PostEventFn;

package/dist/dts/globals/request.d.ts

@@ -0,0 +1,3 @@
+import { RequestFpFn, RequestFn } from '@tma.js/bridge';
+export declare const requestFp: RequestFpFn;
+export declare const request: RequestFn;

package/dist/dts/globals/resetGlobals.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resets all bridge globals and locally created signals.
+ */
+export declare function resetGlobals(): void;

package/dist/dts/globals/signals-registry.d.ts

@@ -0,0 +1,39 @@
+import { Computed, Signal, SignalOptions } from '@tma.js/signals';
+export type SignalsTuple<T> = [Signal<T>, Computed<T>];
+/**
+ * Creates a new signal with the initial value.
+ * @param initialValue - the initial value.
+ * @param options - additional options.
+ */
+export declare function createSignal<T>(initialValue: T, options?: SignalOptions<T>): Signal<T>;
+/**
+ * Creates a new signal without the initial value.
+ * @param initialValue - the initial value.
+ * @param options - additional options.
+ */
+export declare function createSignal<T>(initialValue?: T, options?: SignalOptions<T | undefined>): Signal<T | undefined>;
+/**
+ * Creates a signal, which wil be automatically updated if some of its dependant signals were
+ * modified.
+ * @param fn - computation function.
+ * @param options - additional functions.
+ */
+export declare function createComputed<T>(fn: (prev?: T) => T, options?: SignalOptions<T>): Computed<T>;
+/**
+ * Resets all signals states.
+ */
+export declare function resetSignals(): void;
+/**
+ * @returns A tuple, containing a manual and computed signals. The computed signal is based on
+ * the manual one.
+ * @param initialValue - the initial value.
+ * @param options - additional options.
+ */
+export declare function createSignalsTuple<T>(initialValue: T, options?: SignalOptions<T>): SignalsTuple<T>;
+/**
+ * @returns A tuple, containing a manual and computed signals. The computed signal is based on
+ * the manual one.
+ * @param initialValue - an initial value.
+ * @param options - additional options.
+ */
+export declare function createSignalsTuple<T>(initialValue?: T, options?: SignalOptions<T | undefined>): SignalsTuple<T | undefined>;

package/dist/dts/globals/themeParams.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Mini application's theme parameters.
+ */
+export declare const themeParams: import('@tma.js/signals').Signal<Partial<Record<string, `#${string}`>>>;

package/dist/dts/globals/version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * The current Mini Apps version.
+ */
+export declare const version: import('@tma.js/signals').Signal<string>;

package/dist/dts/helpers/access.d.ts

@@ -0,0 +1,2 @@
+import { MaybeAccessor } from '../types.js';
+export declare function access<T>(value: MaybeAccessor<T>): T;

package/dist/dts/helpers/component-storage.d.ts

@@ -0,0 +1,9 @@
+export interface ComponentStorage<T> {
+    get: () => T | undefined;
+    set: (value: T) => void;
+}
+/**
+ * Creates a new sessionStorage-based component storage.
+ * @param key - session storage key to use.
+ */
+export declare function createComponentSessionStorage<T>(key: string): ComponentStorage<T>;

package/dist/dts/helpers/createIsSupportedSignal.d.ts

@@ -0,0 +1,5 @@
+import { MethodName } from '@tma.js/bridge';
+import { Computed } from '@tma.js/signals';
+import { Version } from '@tma.js/types';
+import { MaybeAccessor } from '../types.js';
+export declare function createIsSupportedSignal(method: MethodName, version: MaybeAccessor<Version>): Computed<boolean>;

package/dist/dts/helpers/css-vars.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Sets CSS variable globally.
+ * @param name - variable name.
+ * @param value - variable value.
+ */
+export declare function setCssVar(name: string, value: string | null): void;
+/**
+ * Deletes specified CSS variable.
+ * @param name - variable name.
+ */
+export declare function deleteCssVar(name: string): void;

package/dist/dts/helpers/isColorDark.d.ts

@@ -0,0 +1,11 @@
+import * as E from 'fp-ts/Either';
+/**
+ * @param color - color in any format acceptable by the `toRGB` function.
+ * @returns True if the color is recognized as dark.
+ * @see toRGB
+ */
+export declare function isColorDarkFp(color: string): E.Either<Error, boolean>;
+/**
+ * @see isColorDarkFp
+ */
+export declare const isColorDark: ((color: string) => boolean) & {};

package/dist/dts/{navigation/isPageReload.d.ts → helpers/navigation.d.ts}

@@ -1,5 +1,5 @@
 /**
- * @returns True, if current page was reloaded.
+ * @returns True, if the current page was reloaded.
  * @see https://stackoverflow.com/a/36444134/11894710
  */
 export declare function isPageReload(): boolean;

package/dist/dts/helpers/removeUndefined.d.ts

@@ -0,0 +1,10 @@
+import { UnionRequiredKeys } from '@tma.js/toolkit';
+type RemoveUndefined<T> = {
+    [K in UnionRequiredKeys<T>]-?: T[K];
+};
+/**
+ * @returns Object with keys having undefined values.
+ * @param value - an object to remove undefined values from.
+ */
+export declare function removeUndefined<T extends {}>(value: T): RemoveUndefined<T>;
+export {};

package/dist/dts/helpers/shallowEqual.d.ts

@@ -0,0 +1 @@
+export declare function shallowEqual<T extends object>(a: T, b: T): boolean;

package/dist/dts/index.d.ts

@@ -1,168 +1,33 @@
-/**
- * Bridge.
- */
-export { off } from './bridge/events/listening/off.js';
-export { on } from './bridge/events/listening/on.js';
-export { subscribe } from './bridge/events/listening/subscribe.js';
-export { unsubscribe } from './bridge/events/listening/unsubscribe.js';
-export * from './bridge/events/types.js';
-export { createPostEvent } from './bridge/methods/createPostEvent.js';
-export { type PostEvent, postEvent } from './bridge/methods/postEvent.js';
-export * from './bridge/methods/types/index.js';
-export { setTargetOrigin, targetOrigin } from './bridge/target-origin.js';
-export { captureSameReq } from './bridge/utils/captureSameReq.js';
-export { invokeCustomMethod } from './bridge/utils/invokeCustomMethod.js';
-export { request, type RequestOptions, type RequestCapture, type RequestResult, } from './bridge/utils/request.js';
-/**
- * Classnames.
- */
-export { classNames } from './classnames/classNames.js';
-export { type MergeClassNames, mergeClassNames } from './classnames/mergeClassNames.js';
-/**
- * Colors.
- */
-export { isColorDark } from './colors/isColorDark.js';
-export { isRGB } from './colors/isRGB.js';
-export { isRGBShort } from './colors/isRGBShort.js';
-export { toRGB } from './colors/toRGB.js';
-export * from './colors/types.js';
-/**
- * Components.
- */
-export { BackButton } from './components/BackButton/BackButton.js';
-export { initBackButton } from './components/BackButton/initBackButton.js';
-export type { BackButtonEventListener, BackButtonEventName, BackButtonEvents, BackButtonState, } from './components/BackButton/types.js';
-export { BiometryManager } from './components/BiometryManager/BiometryManager.js';
-export { initBiometryManager } from './components/BiometryManager/initBiometryManager.js';
-export { requestBiometryInfo } from './components/BiometryManager/requestBiometryInfo.js';
-export type { BiometryManagerAuthenticateOptions, BiometryManagerProps, BiometryManagerRequestAccessOptions, BiometryManagerUpdateTokenOptions, BiometryManagerState, } from './components/BiometryManager/types.js';
-export { ClosingBehavior } from './components/ClosingBehavior/ClosingBehavior.js';
-export { initClosingBehavior } from './components/ClosingBehavior/initClosingBehavior.js';
-export type { ClosingBehaviorEventListener, ClosingBehaviorEventName, ClosingBehaviorEvents, ClosingBehaviorState, } from './components/ClosingBehavior/types.js';
-export { CloudStorage } from './components/CloudStorage/CloudStorage.js';
-export { initCloudStorage } from './components/CloudStorage/initCloudStorage.js';
-export { HapticFeedback } from './components/HapticFeedback/HapticFeedback.js';
-export { initHapticFeedback } from './components/HapticFeedback/initHapticFeedback.js';
-export { InitData } from './components/InitData/InitData.js';
-export { initInitData } from './components/InitData/initInitData.js';
-export { parseInitData } from './components/InitData/parseInitData.js';
-export type { Chat, ChatType, User, InitDataParsed, } from './components/InitData/types.js';
-export { initInvoice } from './components/Invoice/initInvoice.js';
-export { Invoice } from './components/Invoice/Invoice.js';
-export type { InvoiceEventListener, InvoiceEventName, InvoiceEvents, InvoiceState, } from './components/Invoice/types.js';
-export { initMainButton } from './components/MainButton/initMainButton.js';
-export { MainButton } from './components/MainButton/MainButton.js';
-export type { MainButtonEventListener, MainButtonEventName, MainButtonEvents, MainButtonParams, MainButtonProps, MainButtonState, } from './components/MainButton/types.js';
-export { initMiniApp } from './components/MiniApp/initMiniApp.js';
-export { MiniApp } from './components/MiniApp/MiniApp.js';
-export type { MiniAppEventListener, MiniAppEventName, MiniAppEvents, MiniAppHeaderColor, MiniAppProps, MiniAppState, RequestedContact, } from './components/MiniApp/types.js';
-export { initPopup } from './components/Popup/initPopup.js';
-export { Popup } from './components/Popup/Popup.js';
-export type { OpenPopupOptions, OpenPopupOptionsButton, PopupEventListener, PopupEventName, PopupEvents, PopupState, } from './components/Popup/types.js';
-export { initQRScanner } from './components/QRScanner/initQRScanner.js';
-export { QRScanner } from './components/QRScanner/QRScanner.js';
-export type { QRScannerEventListener, QRScannerEventName, QRScannerEvents, QRScannerState, QRScannerOpenOptions } from './components/QRScanner/types.js';
-export { initSettingsButton } from './components/SettingsButton/initSettingsButton.js';
-export { SettingsButton } from './components/SettingsButton/SettingsButton.js';
-export type { SettingsButtonEventListener, SettingsButtonEventName, SettingsButtonEvents, SettingsButtonState, } from './components/SettingsButton/types.js';
-export { initThemeParams } from './components/ThemeParams/initThemeParams.js';
-export { parseThemeParams } from './components/ThemeParams/parsing/parseThemeParams.js';
-export { serializeThemeParams } from './components/ThemeParams/parsing/serializeThemeParams.js';
-export { requestThemeParams } from './components/ThemeParams/requestThemeParams.js';
-export { ThemeParams } from './components/ThemeParams/ThemeParams.js';
-export type { ThemeParamsEventListener, ThemeParamsEventName, ThemeParamsEvents, ThemeParamsKey, ThemeParamsParsed, ThemeParamsState, } from './components/ThemeParams/types.js';
-export { initUtils } from './components/Utils/initUtils.js';
-export { Utils } from './components/Utils/Utils.js';
-export { initViewport } from './components/Viewport/initViewport.js';
-export { requestViewport, type RequestViewportResult, } from './components/Viewport/requestViewport.js';
-export type { ViewportEventListener, ViewportEventName, ViewportEvents, ViewportProps, ViewportState, } from './components/Viewport/types.js';
-export { Viewport } from './components/Viewport/Viewport.js';
-/**
- * CSS Vars.
- */
-export { bindMiniAppCSSVars, type GetMiniAppCSSVarNameFn } from './css-vars/bindMiniAppCSSVars.js';
-export { bindThemeParamsCSSVars, type GetThemeParamsCSSVarNameFn, } from './css-vars/bindThemeParamsCSSVars.js';
-export { bindViewportCSSVars, type GetViewportCSSVarNameFn, } from './css-vars/bindViewportCSSVars.js';
-export { setCSSVar } from './css-vars/setCSSVar.js';
-/**
- * Debug.
- */
-export { setDebug } from './debug/debug.js';
-/**
- * Env.
- */
-export { initWeb } from './env/initWeb.js';
-export { isIframe } from './env/isIframe.js';
-export { isSSR } from './env/isSSR.js';
-export { isTMA } from './env/isTMA.js';
-export { mockTelegramEnv } from './env/mockTelegramEnv.js';
-/**
- * Errors.
- */
-export * from './errors/errors.js';
-export { isSDKError } from './errors/isSDKError.js';
-export { isSDKErrorOfType } from './errors/isSDKErrorOfType.js';
-export { SDKError } from './errors/SDKError.js';
-/**
- * Events.
- */
-export { EventEmitter } from './events/event-emitter/EventEmitter.js';
-export * from './events/event-emitter/types.js';
-export * from './events/types.js';
-/**
- * Launch params.
- */
-export { parseLaunchParams } from './launch-params/parseLaunchParams.js';
-export { retrieveLaunchParams } from './launch-params/retrieveLaunchParams.js';
-export { serializeLaunchParams } from './launch-params/serializeLaunchParams.js';
-export * from './launch-params/types.js';
-/**
- * Misc.
- */
-export type { FactoryOptions, FactoryStatic, Factory, FactoryDynamic, InitComponentFn, InitStaticComponentFn, InitDynamicComponentFn, WithOnChange, } from './misc/createComponentInitFn/types.js';
-/**
- * Navigation.
- */
-export { BasicNavigator } from './navigation/BasicNavigator/BasicNavigator.js';
-export type { BasicNavigatorAnyHistoryItem, BasicNavigatorEvents, BasicNavigatorHistoryItem, } from './navigation/BasicNavigator/types.js';
-export { BrowserNavigator } from './navigation/BrowserNavigator/BrowserNavigator.js';
-export { createBrowserNavigatorFromLocation, } from './navigation/BrowserNavigator/createBrowserNavigatorFromLocation.js';
-export { createSafeURL } from './navigation/createSafeURL.js';
-export { getHash } from './navigation/getHash.js';
-export { getPathname } from './navigation/getPathname.js';
-export { initNavigator } from './navigation/initNavigator.js';
-export { isPageReload } from './navigation/isPageReload.js';
-export { urlToPath } from './navigation/urlToPath.js';
-export type { BrowserNavigatorAnyHistoryItem, BrowserNavigatorConOptions, BrowserNavigatorEvents, BrowserNavigatorHashMode, BrowserNavigatorHistoryItem, URLLike, } from './navigation/BrowserNavigator/types.js';
-/**
- * Parsing.
- */
-export { array } from './parsing/parsers/array.js';
-export { boolean } from './parsing/parsers/boolean.js';
-export { date } from './parsing/parsers/date.js';
-export { json } from './parsing/parsers/json.js';
-export { number } from './parsing/parsers/number.js';
-export { rgb } from './parsing/parsers/rgb.js';
-export { searchParams } from './parsing/parsers/searchParams.js';
-export { string } from './parsing/parsers/string.js';
-/**
- * Request ID
- */
-export type { RequestId } from './request-id/types.js';
-/**
- * Supports.
- */
-export { supports } from './supports/supports.js';
-/**
- * Timeout.
- */
-export { withTimeout } from './timeout/withTimeout.js';
-/**
- * Types.
- */
-export * from './types/index.js';
-/**
- * Version.
- */
-export { compareVersions } from './version/compareVersions.js';
-export type { Version } from './version/types.js';
+export * from './features/BackButton/exports.js';
+export * from './features/Biometry/exports.js';
+export * from './features/ClosingBehavior/exports.js';
+export * from './features/CloudStorage/exports.js';
+export * from './features/emoji-status/exports.js';
+export * from './features/HapticFeedback/exports.js';
+export * from './features/home-screen/exports.js';
+export * from './features/InitData/exports.js';
+export * from './features/Invoice/exports.js';
+export * from './features/links/exports.js';
+export * from './features/LocationManager/exports.js';
+export * from './features/MainButton/exports.js';
+export * from './features/MiniApp/exports.js';
+export * from './features/Popup/exports.js';
+export * from './features/privacy/exports.js';
+export * from './features/QrScanner/exports.js';
+export * from './features/SecondaryButton/exports.js';
+export * from './features/SettingsButton/exports.js';
+export * from './features/SwipeBehavior/exports.js';
+export * from './features/ThemeParams/exports.js';
+export * from './features/uncategorized/exports.js';
+export * from './features/Viewport/exports.js';
+export { createRequestId } from './globals/createRequestId.js';
+export { invokeCustomMethod } from './globals/invokeCustomMethod.js';
+export { postEvent, postEventFp } from './globals/post-event.js';
+export { request, requestFp } from './globals/request.js';
+export { isColorDark, isColorDarkFp } from './helpers/isColorDark.js';
+export * from './errors.js';
+export { init, initFp, type InitOptions } from './init.js';
+export type { AsyncOptions } from './types.js';
+export { isTMA, isTMAFp, type isTMAError, mockTelegramEnv, off, offAll, on, type EventListener, type SubscribeListener, type Events, type WriteAccessRequestedStatus, type EmojiStatusAccessRequestedStatus, type BiometryAuthRequestStatus, type BiometryTokenUpdateStatus, type BiometryType, type EmojiStatusFailedError, type EventName, type EventPayload, type EventWithoutPayload, type EventWithPayload, type PhoneRequestedStatus, type FullScreenErrorStatus, type HomeScreenStatus, type InvoiceStatus, type SafeAreaInsets, createPostEvent, type CreatePostEventMode, type OnUnsupportedFn, getReleaseVersion, type PostEventFn, type PostEventFpFn, type PostEventError, supports, type AnyHapticFeedbackParams, type AnyInvokeCustomMethodParams, type CreateMethodParams, type CustomMethodName, type ImpactHapticFeedbackParams, type ImpactHapticFeedbackStyle, type CustomMethodsParams, type CustomMethodParams, type MethodName, type MethodVersionedParams, type NotificationHapticFeedbackParams, type NotificationHapticFeedbackType, type Methods, type SelectionHapticFeedbackParams, type MethodNameWithOptionalParams, type MethodNameWithoutParams, type MethodNameWithRequiredParams, type MethodNameWithVersionedParams, type MethodParams, type PopupParams, type BackgroundColor, type BottomBarColor, type HeaderColorKey, type PopupButton, type OpenLinkBrowser, type SecondaryButtonPosition, type SwitchInlineQueryChatType, type InvokeCustomMethodFn, type InvokeCustomMethodOptions, type InvokeCustomMethodFpFn, type InvokeCustomMethodError, type InvokeCustomMethodFpOptions, type RequestCaptureEventFn, type RequestCaptureEventsFn, type RequestCaptureFn, type RequestCaptureFnEventsPayload, type RequestFn, type RequestOptions, type RequestResult, type RequestError, type RequestFpOptions, type RequestFpFn, applyPolyfills, decodeBase64Url, encodeBase64Url, decodeBase64UrlFp, type DecodeBase64UrlError, LaunchParamsRetrieveError, InvalidLaunchParamsError, InvokeCustomMethodFailedError, MethodParameterUnsupportedError, MethodUnsupportedError, UnknownEnvError, setDebug, debug, logger, setTargetOrigin, targetOrigin, retrieveLaunchParams, retrieveRawInitData, retrieveRawInitDataFp, retrieveRawLaunchParams, retrieveRawLaunchParamsFp, retrieveLaunchParamsFp, type RetrieveLaunchParamsError, type RetrieveLaunchParamsResult, type RetrieveRawInitDataError, type RetrieveRawLaunchParamsError, createStartParam, createStartParamFp, decodeStartParam, decodeStartParamFp, isSafeToCreateStartParam, createLogger, deepSnakeToCamelObjKeys, type DeepConvertSnakeKeysToCamelCase, type Logger, type LoggerFn, type LoggerForceFn, type LoggerOptions, type LogLevel, CancelledError, TimeoutError, } from '@tma.js/bridge';
+export { parseInitDataQuery, parseInitDataQueryFp, type ParseInitDataQueryError, parseLaunchParamsQuery, parseLaunchParamsQueryFp, type ParseLaunchParamsQueryError, isRGBShort, isRGBAShort, isRGB, isRGBA, isAnyRGB, toRGBFullFp, toRGBFp, toRGB, toRGBFull, serializeInitDataQuery, type InitDataLike, serializeLaunchParamsQuery, type LaunchParamsLike, } from '@tma.js/transformers';
+export type { RGB, User, Chat, InitData, ChatType, Platform, ThemeParams, LaunchParams, KnownThemeParamsKey, Version, } from '@tma.js/types';

package/dist/dts/init.d.ts

@@ -0,0 +1,42 @@
+import { RetrieveLaunchParamsError, PostEventError, PostEventFpFn } from '@tma.js/bridge';
+import { Version, ThemeParams } from '@tma.js/types';
+import * as E from 'fp-ts/Either';
+export interface InitOptions {
+    /**
+     * True if SDK should accept styles sent from the Telegram application.
+     * @default true
+     */
+    acceptCustomStyles?: boolean;
+    /**
+     * True if the application is launched in inline mode.
+     * @default Will be calculated based on the launch parameters' tgWebAppBotInline field.
+     */
+    isInlineMode?: boolean;
+    /**
+     * A custom `postEvent` function to use across the package.
+     * @default tma.js/bridge's postEventFp function will be used.
+     */
+    postEvent?: PostEventFpFn;
+    /**
+     * Mini application theme parameters.
+     * @default Will be calculated based on the launch parameters' tgWebAppThemeParams field.
+     */
+    themeParams?: ThemeParams;
+    /**
+     * Telegram Mini Apps version supported by the Telegram client.
+     * @default Will be calculated based on the launch parameters' tgWebAppVersion field.
+     */
+    version?: Version;
+}
+/**
+ * Initializes the SDK allowing it to properly handle events, sent from the native Telegram
+ * application. This function also configure the package's global dependencies (functions,
+ * variables used across the package).
+ * @param options - function options.
+ * @returns A function, to perform a cleanup.
+ */
+export declare function initFp(options?: InitOptions): E.Either<RetrieveLaunchParamsError | PostEventError, VoidFunction>;
+/**
+ * @see initFp
+ */
+export declare const init: ((options?: InitOptions | undefined) => VoidFunction) & {};

package/dist/dts/types.d.ts

@@ -0,0 +1,6 @@
+import { BetterPromiseOptions } from 'better-promises';
+/**
+ * Async options allowed to be used in package's public functions.
+ */
+export type AsyncOptions = Pick<BetterPromiseOptions, 'abortSignal' | 'timeout'>;
+export type MaybeAccessor<T> = T | (() => T);

package/dist/dts/with-checks/throwifyWithChecksFp.d.ts

@@ -0,0 +1,3 @@
+import { AnyFn } from '@tma.js/toolkit';
+import { WithChecksFp, WithChecks } from './withChecksFp.js';
+export declare function throwifyWithChecksFp<Fn extends AnyFn, HasSupportCheck extends boolean, SupportsMapKeySchema extends string>(fn: WithChecksFp<Fn, HasSupportCheck, SupportsMapKeySchema>): WithChecks<Fn, HasSupportCheck, SupportsMapKeySchema>;