-
Notifications
You must be signed in to change notification settings - Fork 90
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
4 changed files
with
649 additions
and
0 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -1,4 +1,19 @@ | ||
| export { TonConnectUI as default } from './ton-connect-ui'; | ||
| export { TonConnectUI } from './ton-connect-ui'; | ||
| export type { | ||
| UserActionEvent, | ||
| ConnectionEvent, | ||
| ConnectionStartedEvent, | ||
| ConnectionCompletedEvent, | ||
| ConnectionErrorEvent, | ||
| ConnectionRestoringStartedEvent, | ||
| ConnectionRestoringCompletedEvent, | ||
| ConnectionRestoringErrorEvent, | ||
| DisconnectionEvent, | ||
| TransactionSigningEvent, | ||
| TransactionSentForSignatureEvent, | ||
| TransactionSignedEvent, | ||
| TransactionSigningFailedEvent | ||
| } from './tracker/types'; | ||
| export * from './models'; | ||
| export * from './errors'; |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,184 @@ | ||
| import { | ||
| createConnectionCompletedEvent, | ||
| createConnectionErrorEvent, | ||
| createConnectionRestoringCompletedEvent, | ||
| createConnectionRestoringErrorEvent, | ||
| createConnectionRestoringStartedEvent, | ||
| createConnectionStartedEvent, | ||
| createDisconnectionEvent, | ||
| createTransactionSentForSignatureEvent, | ||
| createTransactionSignedEvent, | ||
| createTransactionSigningFailedEvent, | ||
| UserActionEvent | ||
| } from './types'; | ||
| import { getWindow } from 'src/app/utils/web-api'; | ||
|
|
||
| /** | ||
| * Tracker for TonConnectUI user actions, such as transaction signing, connection, etc. | ||
| * | ||
| * List of events: | ||
| * — `connection-started`: when a user starts connecting a wallet. | ||
| * — `connection-completed`: when a user successfully connected a wallet. | ||
| * — `connection-error`: when a user cancels a connection or there is an error during the connection process. | ||
| * — `disconnection`: when a user starts disconnecting a wallet. | ||
| * — `transaction-sent-for-signature`: when a user sends a transaction for signature. | ||
| * — `transaction-signed`: when a user successfully signs a transaction. | ||
| * — `transaction-signing-failed`: when a user cancels transaction signing or there is an error during the signing process. | ||
| * | ||
| * If you want to track user actions, you can subscribe to the window events with prefix `ton-connect-ui-`: | ||
| * ```typescript | ||
| * window.addEventListener('ton-connect-ui-transaction-sent-for-signature', (event) => { | ||
| * console.log('Transaction init', event.detail); | ||
| * }); | ||
| * ``` | ||
| * | ||
| * @internal | ||
| */ | ||
| export class TonConnectTracker { | ||
| /** | ||
| * Event prefix for user actions. | ||
| * @private | ||
| */ | ||
| private readonly eventPrefix = 'ton-connect-ui-'; | ||
|
|
||
| /** | ||
| * Window object, possibly undefined in the server environment. | ||
| * @private | ||
| */ | ||
| private readonly window: Window | undefined = getWindow(); | ||
|
|
||
| /** | ||
| * Emit user action event to the window. | ||
| * @param eventDetails | ||
| * @private | ||
| */ | ||
| private dispatchUserActionEvent(eventDetails: UserActionEvent): void { | ||
| try { | ||
| const eventName = `${this.eventPrefix}${eventDetails.type}`; | ||
| const event = new CustomEvent<UserActionEvent>(eventName, { detail: eventDetails }); | ||
| this.window?.dispatchEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection init event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionStarted(...args: Parameters<typeof createConnectionStartedEvent>): void { | ||
| try { | ||
| const event = createConnectionStartedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection success event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionCompleted( | ||
| ...args: Parameters<typeof createConnectionCompletedEvent> | ||
| ): void { | ||
| try { | ||
| const event = createConnectionCompletedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection error event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionError(...args: Parameters<typeof createConnectionErrorEvent>): void { | ||
| try { | ||
| const event = createConnectionErrorEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection restoring init event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionRestoringStarted( | ||
| ...args: Parameters<typeof createConnectionRestoringStartedEvent> | ||
| ): void { | ||
| try { | ||
| const event = createConnectionRestoringStartedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection restoring success event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionRestoringCompleted( | ||
| ...args: Parameters<typeof createConnectionRestoringCompletedEvent> | ||
| ): void { | ||
| try { | ||
| const event = createConnectionRestoringCompletedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track connection restoring error event. | ||
| * @param args | ||
| */ | ||
| public trackConnectionRestoringError( | ||
| ...args: Parameters<typeof createConnectionRestoringErrorEvent> | ||
| ): void { | ||
| try { | ||
| const event = createConnectionRestoringErrorEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track disconnect event. | ||
| * @param args | ||
| */ | ||
| public trackDisconnection(...args: Parameters<typeof createDisconnectionEvent>): void { | ||
| try { | ||
| const event = createDisconnectionEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track transaction init event. | ||
| * @param args | ||
| */ | ||
| public trackTransactionSentForSignature( | ||
| ...args: Parameters<typeof createTransactionSentForSignatureEvent> | ||
| ): void { | ||
| try { | ||
| const event = createTransactionSentForSignatureEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track transaction signed event. | ||
| * @param args | ||
| */ | ||
| public trackTransactionSigned(...args: Parameters<typeof createTransactionSignedEvent>): void { | ||
| try { | ||
| const event = createTransactionSignedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
|
|
||
| /** | ||
| * Track transaction error event. | ||
| * @param args | ||
| */ | ||
| public trackTransactionSigningFailed( | ||
| ...args: Parameters<typeof createTransactionSigningFailedEvent> | ||
| ): void { | ||
| try { | ||
| const event = createTransactionSigningFailedEvent(...args); | ||
| this.dispatchUserActionEvent(event); | ||
| } catch (e) {} | ||
| } | ||
| } |
Oops, something went wrong.