@virex-tech/paywallo-sdk 2.5.2 → 2.6.0

package/dist/index.d.mts

@@ -641,7 +641,6 @@ type NotificationsEnvironment = "sandbox" | "production";
 interface NotificationsConfig {
     debug?: boolean;
     environment?: NotificationsEnvironment;
-    apiBaseUrl?: string;
 }
 
 declare const NOTIFICATIONS_ERROR_CODES: {
@@ -748,7 +747,6 @@ interface HandlersConfig {
 }
 interface NotificationsManagerConfig {
     appKey: string;
-    apiBaseUrl?: string;
     debug?: boolean;
     environment?: NotificationsConfig["environment"];
 }
@@ -1532,7 +1530,7 @@ declare class IAPService {
     private finishTransaction;
     startTransactionListener(): void;
     stopTransactionListener(): void;
-    emitTransactionUpdate(_update: NativeTransactionUpdate): Promise<void>;
+    emitTransactionUpdate(update: NativeTransactionUpdate): Promise<void>;
     purchase(productId: string, options?: ValidateOptions): Promise<PurchaseResult>;
     restore(): Promise<Purchase[]>;
     reset(): void;
@@ -1632,8 +1630,25 @@ declare class OnboardingError extends PaywalloError {
 declare const ONBOARDING_ERROR_CODES: {
     readonly NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED";
     readonly INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME";
+    readonly INVALID_ORDER: "ONBOARDING_INVALID_ORDER";
 };
 
+/** Payload sent with onboarding.step events. */
+interface OnboardingStepPayload {
+    step_name: string;
+    /** Ordem de exibição do step (aceita decimais, ex: 2.1 para variantes A/B). Obrigatório. */
+    order: number;
+    variant_key?: string;
+    time_on_prev_s?: number;
+}
+interface OnboardingStepOptions {
+    variantKey?: string;
+    timeOnPrevS?: number;
+}
+interface OnboardingCompleteOptions {
+    variantKey?: string;
+}
+
 /**
  * Minimal surface the OnboardingManager needs from the unified event pipeline.
  * `PaywalloClient` satisfies this interface (forwarding to
@@ -1661,42 +1676,26 @@ declare class OnboardingManager {
      * Saves the step name internally for implicit drop detection on the backend.
      *
      * @param stepName - Unique name for this onboarding step.
-     * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+     * @param order - Ordem de exibição do step. Obrigatório. Aceita decimais (ex: 2.1 para variantes A/B).
+     *   Deve ser um número finito e não-negativo. O servidor faz o floor — não arredondar aqui.
      */
-    step(stepName: string, order?: number): Promise<void>;
+    step(stepName: string, order: number, options?: OnboardingStepOptions): Promise<void>;
     /**
      * Tracks successful completion of the onboarding flow.
      * Marks the flow as finished.
      */
-    complete(): Promise<void>;
-    /**
-     * Tracks an explicit drop (abandonment) at the given step.
-     * Marks the flow as finished.
-     *
-     * @param stepName - The step name where the user dropped off.
-     */
-    drop(stepName: string): Promise<void>;
+    complete(options?: OnboardingCompleteOptions): Promise<void>;
     /** Returns the last step name seen, or null if no step was tracked yet. */
     getLastStep(): string | null;
-    /** Returns whether the flow has been marked as finished (complete or drop). */
+    /** Returns whether the flow has been marked as finished (complete). */
     isFinished(): boolean;
     private emit;
     private assertConfig;
     private validateStepName;
+    private validateOrder;
 }
 declare const onboardingManager: OnboardingManager;
 
-/** Payload sent with onboarding.step events. */
-interface OnboardingStepPayload {
-    step_name: string;
-    /** Optional explicit order (accepts decimals, e.g. 2.1 for A/B variants). */
-    order?: number;
-}
-/** Payload sent with onboarding.drop events. */
-interface OnboardingDropPayload {
-    step_name: string;
-}
-
 interface PaywallContextValue {
     nodes: Record<string, PaywallNode>;
     rootId: string;
@@ -1863,9 +1862,8 @@ interface UseOfferingsResult {
 declare function useOfferings(ids?: string[]): UseOfferingsResult;
 
 interface UseOnboardingResult {
-    step: (stepName: string, order?: number) => Promise<void>;
-    complete: () => Promise<void>;
-    drop: (stepName: string) => Promise<void>;
+    step: (stepName: string, order: number, options?: OnboardingStepOptions) => Promise<void>;
+    complete: (options?: OnboardingCompleteOptions) => Promise<void>;
 }
 /**
  * React hook that exposes bound onboarding tracking methods.
@@ -2017,4 +2015,4 @@ declare function hasVariables(text: string): boolean;
 
 declare const Paywallo: IPaywalloClient;
 
-export { type AllPlansResponse, ApiClient, type ApiClientConfig, type AttributionCapture, AttributionTracker, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedOfferings, type CachedPlans, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, type DeviceTokenRegistration, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IPushBridge, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, NOTIFICATIONS_ERROR_CODES, NativePushBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type NotificationEventType, type NotificationListener, type NotificationPayload, NotificationsError, NotificationsManager, ONBOARDING_ERROR_CODES, type Offering, type OfferingProduct, OfferingService, type OfferingServiceConfig, type OfflineQueueConfig, type OnboardingDropPayload, OnboardingError, OnboardingManager, type OnboardingStepPayload, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type Plan, PlanCache, type PlanProduct, PlanService, type PlanServiceConfig, type PlansResponse, type PrePromptHandle, type PrePromptOptions, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type PushPermissionStatus, type PushPlatform, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult$1 as RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, attributionTracker, createPurchaseError, Paywallo as default, detectDeviceLanguage, getActiveRouteName, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, notificationsManager, offeringService, offlineQueue, onboardingManager, parseVariables, planCache, planService, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, useOfferingPurchase, useOfferings, useOnboarding, usePaywallContext, usePaywallo, usePaywalloScreenTracking, usePlanPurchase, usePlans, useProducts, usePurchase, useSubscription };
+export { type AllPlansResponse, ApiClient, type ApiClientConfig, type AttributionCapture, AttributionTracker, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedOfferings, type CachedPlans, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, type DeviceTokenRegistration, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IPushBridge, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, NOTIFICATIONS_ERROR_CODES, NativePushBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type NotificationEventType, type NotificationListener, type NotificationPayload, NotificationsError, NotificationsManager, ONBOARDING_ERROR_CODES, type Offering, type OfferingProduct, OfferingService, type OfferingServiceConfig, type OfflineQueueConfig, OnboardingError, OnboardingManager, type OnboardingStepPayload, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type Plan, PlanCache, type PlanProduct, PlanService, type PlanServiceConfig, type PlansResponse, type PrePromptHandle, type PrePromptOptions, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type PushPermissionStatus, type PushPlatform, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult$1 as RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, attributionTracker, createPurchaseError, Paywallo as default, detectDeviceLanguage, getActiveRouteName, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, notificationsManager, offeringService, offlineQueue, onboardingManager, parseVariables, planCache, planService, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, useOfferingPurchase, useOfferings, useOnboarding, usePaywallContext, usePaywallo, usePaywalloScreenTracking, usePlanPurchase, usePlans, useProducts, usePurchase, useSubscription };

package/dist/index.d.ts

@@ -641,7 +641,6 @@ type NotificationsEnvironment = "sandbox" | "production";
 interface NotificationsConfig {
     debug?: boolean;
     environment?: NotificationsEnvironment;
-    apiBaseUrl?: string;
 }
 
 declare const NOTIFICATIONS_ERROR_CODES: {
@@ -748,7 +747,6 @@ interface HandlersConfig {
 }
 interface NotificationsManagerConfig {
     appKey: string;
-    apiBaseUrl?: string;
     debug?: boolean;
     environment?: NotificationsConfig["environment"];
 }
@@ -1532,7 +1530,7 @@ declare class IAPService {
     private finishTransaction;
     startTransactionListener(): void;
     stopTransactionListener(): void;
-    emitTransactionUpdate(_update: NativeTransactionUpdate): Promise<void>;
+    emitTransactionUpdate(update: NativeTransactionUpdate): Promise<void>;
     purchase(productId: string, options?: ValidateOptions): Promise<PurchaseResult>;
     restore(): Promise<Purchase[]>;
     reset(): void;
@@ -1632,8 +1630,25 @@ declare class OnboardingError extends PaywalloError {
 declare const ONBOARDING_ERROR_CODES: {
     readonly NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED";
     readonly INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME";
+    readonly INVALID_ORDER: "ONBOARDING_INVALID_ORDER";
 };
 
+/** Payload sent with onboarding.step events. */
+interface OnboardingStepPayload {
+    step_name: string;
+    /** Ordem de exibição do step (aceita decimais, ex: 2.1 para variantes A/B). Obrigatório. */
+    order: number;
+    variant_key?: string;
+    time_on_prev_s?: number;
+}
+interface OnboardingStepOptions {
+    variantKey?: string;
+    timeOnPrevS?: number;
+}
+interface OnboardingCompleteOptions {
+    variantKey?: string;
+}
+
 /**
  * Minimal surface the OnboardingManager needs from the unified event pipeline.
  * `PaywalloClient` satisfies this interface (forwarding to
@@ -1661,42 +1676,26 @@ declare class OnboardingManager {
      * Saves the step name internally for implicit drop detection on the backend.
      *
      * @param stepName - Unique name for this onboarding step.
-     * @param order - Optional explicit display order (accepts decimals, e.g. 2.1 for A/B variants).
+     * @param order - Ordem de exibição do step. Obrigatório. Aceita decimais (ex: 2.1 para variantes A/B).
+     *   Deve ser um número finito e não-negativo. O servidor faz o floor — não arredondar aqui.
      */
-    step(stepName: string, order?: number): Promise<void>;
+    step(stepName: string, order: number, options?: OnboardingStepOptions): Promise<void>;
     /**
      * Tracks successful completion of the onboarding flow.
      * Marks the flow as finished.
      */
-    complete(): Promise<void>;
-    /**
-     * Tracks an explicit drop (abandonment) at the given step.
-     * Marks the flow as finished.
-     *
-     * @param stepName - The step name where the user dropped off.
-     */
-    drop(stepName: string): Promise<void>;
+    complete(options?: OnboardingCompleteOptions): Promise<void>;
     /** Returns the last step name seen, or null if no step was tracked yet. */
     getLastStep(): string | null;
-    /** Returns whether the flow has been marked as finished (complete or drop). */
+    /** Returns whether the flow has been marked as finished (complete). */
     isFinished(): boolean;
     private emit;
     private assertConfig;
     private validateStepName;
+    private validateOrder;
 }
 declare const onboardingManager: OnboardingManager;
 
-/** Payload sent with onboarding.step events. */
-interface OnboardingStepPayload {
-    step_name: string;
-    /** Optional explicit order (accepts decimals, e.g. 2.1 for A/B variants). */
-    order?: number;
-}
-/** Payload sent with onboarding.drop events. */
-interface OnboardingDropPayload {
-    step_name: string;
-}
-
 interface PaywallContextValue {
     nodes: Record<string, PaywallNode>;
     rootId: string;
@@ -1863,9 +1862,8 @@ interface UseOfferingsResult {
 declare function useOfferings(ids?: string[]): UseOfferingsResult;
 
 interface UseOnboardingResult {
-    step: (stepName: string, order?: number) => Promise<void>;
-    complete: () => Promise<void>;
-    drop: (stepName: string) => Promise<void>;
+    step: (stepName: string, order: number, options?: OnboardingStepOptions) => Promise<void>;
+    complete: (options?: OnboardingCompleteOptions) => Promise<void>;
 }
 /**
  * React hook that exposes bound onboarding tracking methods.
@@ -2017,4 +2015,4 @@ declare function hasVariables(text: string): boolean;
 
 declare const Paywallo: IPaywalloClient;
 
-export { type AllPlansResponse, ApiClient, type ApiClientConfig, type AttributionCapture, AttributionTracker, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedOfferings, type CachedPlans, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, type DeviceTokenRegistration, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IPushBridge, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, NOTIFICATIONS_ERROR_CODES, NativePushBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type NotificationEventType, type NotificationListener, type NotificationPayload, NotificationsError, NotificationsManager, ONBOARDING_ERROR_CODES, type Offering, type OfferingProduct, OfferingService, type OfferingServiceConfig, type OfflineQueueConfig, type OnboardingDropPayload, OnboardingError, OnboardingManager, type OnboardingStepPayload, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type Plan, PlanCache, type PlanProduct, PlanService, type PlanServiceConfig, type PlansResponse, type PrePromptHandle, type PrePromptOptions, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type PushPermissionStatus, type PushPlatform, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult$1 as RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, attributionTracker, createPurchaseError, Paywallo as default, detectDeviceLanguage, getActiveRouteName, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, notificationsManager, offeringService, offlineQueue, onboardingManager, parseVariables, planCache, planService, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, useOfferingPurchase, useOfferings, useOnboarding, usePaywallContext, usePaywallo, usePaywalloScreenTracking, usePlanPurchase, usePlans, useProducts, usePurchase, useSubscription };
+export { type AllPlansResponse, ApiClient, type ApiClientConfig, type AttributionCapture, AttributionTracker, type BlockType, type BoxSpacing, CAMPAIGN_ERROR_CODES, type CachedOfferings, type CachedPlans, type CachedSubscription, CampaignError, type CampaignPresentOptions, type CampaignResponse, type CampaignResult, type ConditionalFlagContext, type ConditionalFlagResult, type DeviceTokenRegistration, PURCHASE_ERROR_CODES as ERROR_CODES, type EmergencyPaywallResponse, type Environment, type FlagVariant, HttpClient, type HttpClientConfig, type HttpResponse, type IAPProduct, type IAPPurchase, IAPService, IDENTITY_ERROR_CODES, type IPaywalloClient, type IPushBridge, type IdentifyOptions, IdentityError, IdentityManager, type IdentityState, type LocalizedText, MetaBridge, NOTIFICATIONS_ERROR_CODES, NativePushBridge, type NetworkListener, type NetworkMonitorConfig, type NetworkState, type NotificationEventType, type NotificationListener, type NotificationPayload, NotificationsError, NotificationsManager, ONBOARDING_ERROR_CODES, type Offering, type OfferingProduct, OfferingService, type OfferingServiceConfig, type OfflineQueueConfig, OnboardingError, OnboardingManager, type OnboardingStepPayload, PAYWALL_ERROR_CODES, PURCHASE_ERROR_CODES, type PaywallBlockConfig, type PaywallConfig, PaywallContext, PaywallError, type PaywallErrorStrings$1 as PaywallErrorStrings, PaywallModal, type PaywallNode, type PaywallPresentOptions, type PaywallResult, type PaywallState, Paywallo, PaywalloClient, type PaywalloConfig, PaywalloContext, PaywalloError, type PaywalloInitConfig, PaywalloProvider, type PaywalloProviderProps, type Plan, PlanCache, type PlanProduct, PlanService, type PlanServiceConfig, type PlansResponse, type PrePromptHandle, type PrePromptOptions, type PreloadCampaignResult, type PreloadResult, type Product, type ProductPriceInfo, type Purchase, type PurchaseControllerConfig, PurchaseError, type PurchaseResult, type PurchaseState, type PushPermissionStatus, type PushPlatform, type QueueEvent, type QueueItem, type QueueListener, type QueueProcessorConfig, type RequestOptions, type RestoreResult$1 as RestoreResult, type RetryConfig, SESSION_ERROR_CODES, type SessionConfig, SessionError, SessionManager, type SessionState, type Subscription, SubscriptionCache, type SubscriptionInfo, type SubscriptionManagerConfig, type SubscriptionPlatform, type SubscriptionStatus$1 as SubscriptionStatus, type SubscriptionStatusResponse$1 as SubscriptionStatusResponse, type TapBehavior, type TrackEventOptions, type UserProperties, type ValidatePurchaseResponse, type VariableContext, attributionTracker, createPurchaseError, Paywallo as default, detectDeviceLanguage, getActiveRouteName, getCurrentLanguage, getDefaultLanguage, getIAPService, getLocalizedString, hasVariables, identityManager, initLocalization, metaBridge, nativeStoreKit, networkMonitor, notificationsManager, offeringService, offlineQueue, onboardingManager, parseVariables, planCache, planService, queueProcessor, resolveText, sessionManager, setCurrentLanguage, setDefaultLanguage, subscriptionManager, useOfferingPurchase, useOfferings, useOnboarding, usePaywallContext, usePaywallo, usePaywalloScreenTracking, usePlanPurchase, usePlans, useProducts, usePurchase, useSubscription };