choco-one-click-payment 1.1.0 → 1.1.2

package/README.md

@@ -20,7 +20,6 @@ const widget = new ChocoOneClickWidget({
   trackId: 'your-track-id',
   terminalId: 1234,
   amount: 10000,
-  amplitudeKey: 'YOUR_AMPLITUDE_API_KEY',
   environment: 'stage',
   onSuccess: (data) => console.log('Success', data),
   onError: (error) => console.error('Error', error),
@@ -31,7 +30,10 @@ const widget = new ChocoOneClickWidget({
     // Клиент сам выбирает, как открыть ссылку:
     // window.open(action_link, '_blank');
     window.location.href = action_link;
-  }
+  },
+  onUserEvent: ({ eventName, eventProperties }) => {
+    console.log('User event', eventName, eventProperties);
+  },
 });
 
 await widget.init();
@@ -44,7 +46,6 @@ const widget = new ChocoOneClickWidget({
   clientId: '12345678',
   terminalId: 1234,
   amount: 10000,
-  amplitudeKey: 'YOUR_AMPLITUDE_API_KEY',
   environment: 'stage',
   onSuccess: (data) => console.log('Success', data),
   onError: (error) => console.error('Error', error),
@@ -64,7 +65,7 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 
 ## Поведение init()
 
-- **clientId** и **amplitudeKey** обязательны. Без любого из них вызывается `onError` и `init()` возвращает `false`.
+- **clientId** обязателен. Без него вызывается `onError` и `init()` возвращает `false`.
 - Запрос на контекст оплаты (context) **не отправляется**, если нет ни `trackId`, ни `accessToken` (из cookie). В этом случае показывается виджет с заблокированным выбором способа оплаты; кнопка «Оплатить» активна.
 - Если есть **trackId** или **accessToken** — запрашиваются токены (при необходимости) и context, подключается WebSocket, отображается полный виджет.
 
@@ -73,7 +74,6 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | Параметр | Тип | Обязательный | Описание |
 |----------|-----|--------------|----------|
 | `clientId` | string | да | OAuth2 client_id приложения |
-| `amplitudeKey` | string | да | API-ключ Amplitude для аналитики внутри виджета |
 | `trackId` | string | нет | Идентификатор для получения access token |
 | `terminalId` | number | да | ID терминала Choco |
 | `amount` | number | да | Сумма в тиынах (1₸ = 100 тиынов) |
@@ -99,6 +99,7 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | `onPaymentMethodSelected` | Вызывается при выборе способа оплаты; получает выбранный `method` |
 | `onKaspiLink` | Вызывается для `kaspi_pay` при получении `action_link`/`action_url`; позволяет клиенту самому открыть ссылку |
 | `onAppliedBonus` | Вызывается при включении/выключении бонусов |
+| `onUserEvent` | Вызывается при пользовательских событиях виджета (`one_click_pay_cta_rendered`, `one_click_pay_method_resolved`, `one_click_pay_cta_tapped`) |
 
 ## Методы
 
@@ -116,9 +117,11 @@ const ChocoOneClickWidget = require('choco-one-click-payment');
 | `setDisabled(boolean)` | Блокирует/разблокирует интеракции. |
 | `setPreorderId(preorderId)` | Обновляет preorderId в рантайме. |
 | `setMerchantOrderId(merchantOrderId)` | Обновляет merchantOrderId в рантайме. |
+| `logout()` | Очищает auth cookies (`webPayToken`, `webPayRefreshToken`). |
 | `onConfirmPay(callback)` | Регистрирует callback подтверждения оплаты. Callback получает выбранный `method`. |
 | `onPaymentMethodSelected(callback)` | Регистрирует callback изменения выбранного способа оплаты. |
 | `onKaspiLink(callback)` | Регистрирует callback для обработки ссылки Kaspi Pay (`action_link`/`action_url`). |
+| `onUserEvent(callback)` | Регистрирует callback для пользовательских событий виджета. |
 | `pay()` | Подтверждает оплату и запускает создание заказа (после onConfirmPay). |
 
 ### Обработка ссылки Kaspi Pay

package/index.d.ts

@@ -100,11 +100,13 @@ export interface ChocoOneClickConfig {
     onKaspiLink?: (payload: KaspiLinkPayload) => void;
 
     /**
-     * API-ключ Amplitude для аналитики внутри виджета (обязательный).
-     * Виджет отправляет события: one_click_pay_cta_rendered,
-     * one_click_pay_method_resolved, one_click_pay_cta_tapped.
+     * Callback для пользовательских событий виджета.
+     * Виджет эмитит события:
+     * - one_click_pay_cta_rendered
+     * - one_click_pay_method_resolved
+     * - one_click_pay_cta_tapped
      */
-    amplitudeKey: string;
+    onUserEvent?: (event: UserEventPayload) => void;
 
     /**
      * Callback вызываемый при включении/выключении бонусов
@@ -251,6 +253,11 @@ export interface KaspiLinkPayload {
     event?: PaymentActionRequiredEvent | Record<string, unknown>;
 }
 
+export interface UserEventPayload {
+    eventName: 'one_click_pay_cta_rendered' | 'one_click_pay_method_resolved' | 'one_click_pay_cta_tapped' | string;
+    eventProperties: Record<string, unknown>;
+}
+
 export default class ChocoOneClickWidget {
     /**
      * Создает экземпляр виджета
@@ -315,6 +322,11 @@ export default class ChocoOneClickWidget {
      */
     setMerchantOrderId(merchantOrderId: string | number): Promise<void>;
 
+    /**
+     * Очищает auth cookies виджета (webPayToken и webPayRefreshToken)
+     */
+    logout(): Promise<void>;
+
     /**
      * Обновляет trackId в рантайме, запрашивает токены и подтягивает context
      * @returns Promise<boolean> — true при успехе
@@ -336,6 +348,11 @@ export default class ChocoOneClickWidget {
      */
     onKaspiLink(callback: (payload: KaspiLinkPayload) => void): Promise<void>;
 
+    /**
+     * Регистрирует callback для пользовательских событий виджета
+     */
+    onUserEvent(callback: (event: UserEventPayload) => void): Promise<void>;
+
     /**
      * Подтверждает оплату после onConfirmPay и запускает создание заказа
      */