@virex-tech/paywallo-sdk 2.5.3 → 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"];
 }
@@ -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"];
 }
@@ -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.js

@@ -664,9 +664,12 @@ var init_IdentityManager = __esm({
               dateOfBirth: this.dateOfBirth ?? void 0,
               gender: this.gender ?? void 0
             });
+            if (this.debug) console.log("[Paywallo] identify confirmed", this.anonId.slice(0, 8));
           } catch (err) {
-            if (this.debug) console.log("[Paywallo] identify dispatch error", err);
+            if (this.debug) console.log("[Paywallo] identify failed:", err);
           }
+        } else {
+          if (this.debug) console.log("[Paywallo] identify skipped \u2014 anonId not ready");
         }
       }
       getDistinctId() {
@@ -2301,18 +2304,15 @@ var init_constants = __esm({
 });
 
 // src/domains/notifications/config.ts
-function resolveApiBaseUrl(config) {
-  if (config.apiBaseUrl) return config.apiBaseUrl;
-  if (config.environment === "sandbox") return SANDBOX_API_BASE_URL;
+function resolveApiBaseUrl() {
   return DEFAULT_API_BASE_URL;
 }
-var DEFAULT_API_BASE_URL, SANDBOX_API_BASE_URL;
+var DEFAULT_API_BASE_URL;
 var init_config = __esm({
   "src/domains/notifications/config.ts"() {
     "use strict";
     init_constants();
     DEFAULT_API_BASE_URL = DEFAULT_API_URL;
-    SANDBOX_API_BASE_URL = DEFAULT_API_URL;
   }
 });
 
@@ -2627,8 +2627,8 @@ var init_NotificationHandlerSetup = __esm({
 // src/core/version.ts
 function resolveVersion() {
   try {
-    if ("2.5.3") {
-      return "2.5.3";
+    if ("2.6.0") {
+      return "2.6.0";
     }
   } catch {
   }
@@ -3082,10 +3082,7 @@ var init_NotificationsManager = __esm({
       }
       applyConfig(config) {
         this.appKey = config.appKey;
-        this.apiBaseUrl = resolveApiBaseUrl({
-          apiBaseUrl: config.apiBaseUrl,
-          environment: config.environment
-        });
+        this.apiBaseUrl = resolveApiBaseUrl();
         this.debug = config.debug ?? false;
         this.permissionManager.setDebug(this.debug);
       }
@@ -3261,7 +3258,8 @@ var init_OnboardingError = __esm({
     };
     ONBOARDING_ERROR_CODES = {
       NOT_INITIALIZED: "ONBOARDING_NOT_INITIALIZED",
-      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME"
+      INVALID_STEP_NAME: "ONBOARDING_INVALID_STEP_NAME",
+      INVALID_ORDER: "ONBOARDING_INVALID_ORDER"
     };
   }
 });
@@ -3291,16 +3289,20 @@ var init_OnboardingManager = __esm({
        * 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.
        */
-      async step(stepName, order) {
+      async step(stepName, order, options) {
         this.assertConfig();
         this.validateStepName(stepName, "step");
+        this.validateOrder(order);
         this.lastStep = stepName;
-        const stepPayload = { step_name: stepName };
-        if (order !== void 0 && Number.isFinite(order) && order >= 0) {
-          stepPayload.order = order;
-        }
+        const stepPayload = {
+          step_name: stepName,
+          order,
+          ...options?.variantKey !== void 0 ? { variant_key: options.variantKey } : {},
+          ...options?.timeOnPrevS !== void 0 ? { time_on_prev_s: options.timeOnPrevS } : {}
+        };
         const payload = {
           family: "onboarding",
           type: "step",
@@ -3312,33 +3314,21 @@ var init_OnboardingManager = __esm({
        * Tracks successful completion of the onboarding flow.
        * Marks the flow as finished.
        */
-      async complete() {
-        this.assertConfig();
-        this.finished = true;
-        return this.emit("onboarding", { family: "onboarding", type: "complete" }, "complete");
-      }
-      /**
-       * Tracks an explicit drop (abandonment) at the given step.
-       * Marks the flow as finished.
-       *
-       * @param stepName - The step name where the user dropped off.
-       */
-      async drop(stepName) {
+      async complete(options) {
         this.assertConfig();
-        this.validateStepName(stepName, "drop");
         this.finished = true;
         const payload = {
           family: "onboarding",
-          type: "drop",
-          ...{ step_name: stepName }
+          type: "complete",
+          ...options?.variantKey !== void 0 ? { variant_key: options.variantKey } : {}
         };
-        return this.emit("onboarding", payload, "drop");
+        return this.emit("onboarding", payload, "complete");
       }
       /** Returns the last step name seen, or null if no step was tracked yet. */
       getLastStep() {
         return this.lastStep;
       }
-      /** Returns whether the flow has been marked as finished (complete or drop). */
+      /** Returns whether the flow has been marked as finished (complete). */
       isFinished() {
         return this.finished;
       }
@@ -3370,6 +3360,14 @@ var init_OnboardingManager = __esm({
           );
         }
       }
+      validateOrder(order) {
+        if (order === void 0 || order === null || !Number.isFinite(order) || order < 0) {
+          throw new OnboardingError(
+            ONBOARDING_ERROR_CODES.INVALID_ORDER,
+            "OnboardingManager.step(): order deve ser um n\xFAmero finito e n\xE3o-negativo."
+          );
+        }
+      }
     };
     onboardingManager = new OnboardingManager();
   }
@@ -5226,7 +5224,7 @@ var init_QueueProcessor = __esm({
             for (const item of batch) {
               retryIds.add(item.id);
             }
-            console.error("[Paywallo:QUEUE] event batch network error \u2014 items will retry", { size: batch.length, error: error instanceof Error ? error.message : String(error) });
+            if (this.config.debug) console.log("[Paywallo:QUEUE] event batch network error \u2014 items will retry", { size: batch.length, error: error instanceof Error ? error.message : String(error) });
             this.log("Event batch threw network error - will retry", {
               size: batch.length,
               error: error instanceof Error ? error.message : String(error)
@@ -5239,7 +5237,7 @@ var init_QueueProcessor = __esm({
               processed++;
             }
             this.log("Event batch processed successfully", { size: batch.length });
-          } else if (response.status >= 400 && response.status < 500) {
+          } else if (response.status >= 400 && response.status < 500 && response.status !== 429) {
             for (const item of batch) {
               await offlineQueue.removeItem(item.id);
               failed++;
@@ -5251,7 +5249,7 @@ var init_QueueProcessor = __esm({
                 console.log("[Paywallo:QUEUE] event batch deduplicated by server \u2014 items dropped (benign)", { status: response.status, size: batch.length, error: responseError });
               }
             } else {
-              console.error("[Paywallo:QUEUE] event batch failed PERMANENTLY (4xx) \u2014 items dropped", { status: response.status, size: batch.length, responseBody: typeof response.data === "string" ? response.data.slice(0, 1e3) : JSON.stringify(response.data).slice(0, 1e3), firstItemBody: typeof batch[0].body === "string" ? batch[0].body.slice(0, 1e3) : JSON.stringify(batch[0].body).slice(0, 1e3) });
+              if (this.config.debug) console.log("[Paywallo:QUEUE] event batch failed PERMANENTLY (4xx) \u2014 items dropped", { status: response.status, size: batch.length, responseBody: typeof response.data === "string" ? response.data.slice(0, 1e3) : JSON.stringify(response.data).slice(0, 1e3), firstItemBody: typeof batch[0].body === "string" ? batch[0].body.slice(0, 1e3) : JSON.stringify(batch[0].body).slice(0, 1e3) });
             }
             this.log("Event batch failed permanently (4xx) - removing from queue", {
               status: response.status,
@@ -5262,7 +5260,7 @@ var init_QueueProcessor = __esm({
             for (const item of batch) {
               retryIds.add(item.id);
             }
-            console.error("[Paywallo:QUEUE] event batch server error (5xx) \u2014 will retry", { status: response.status, size: batch.length });
+            if (this.config.debug) console.log("[Paywallo:QUEUE] event batch server error (5xx) \u2014 will retry", { status: response.status, size: batch.length });
             this.log("Event batch failed with server error - will retry", {
               status: response.status,
               size: batch.length
@@ -5292,7 +5290,7 @@ var init_QueueProcessor = __esm({
             skipRetry: false
           });
         } catch (error) {
-          console.error("[Paywallo:QUEUE] individual item network error \u2014 will retry", { id: item.id, url: item.url, error: error instanceof Error ? error.message : String(error) });
+          if (this.config.debug) console.log("[Paywallo:QUEUE] individual item network error \u2014 will retry", { id: item.id, url: item.url, error: error instanceof Error ? error.message : String(error) });
           this.log("Request threw network error - will retry", {
             id: item.id,
             error: error instanceof Error ? error.message : String(error)
@@ -5303,7 +5301,7 @@ var init_QueueProcessor = __esm({
           this.log("Queue item processed successfully", { id: item.id });
           return { success: true, permanent: false };
         }
-        if (response.status >= 400 && response.status < 500) {
+        if (response.status >= 400 && response.status < 500 && response.status !== 429) {
           this.log("Request failed with permanent client error - removing from queue", {
             id: item.id,
             url: item.url,
@@ -6821,8 +6819,9 @@ var init_schemas = __esm({
       path: ["transaction_id"]
     });
     onboardingEventSchema = import_zod.z.object({
-      type: import_zod.z.enum(["step", "complete", "drop"]),
-      step_index: import_zod.z.number().int().nonnegative().optional(),
+      type: import_zod.z.enum(["step", "complete"]),
+      family: import_zod.z.literal("onboarding").optional(),
+      order: import_zod.z.number().nonnegative().optional(),
       step_name: import_zod.z.string().optional(),
       variant_key: import_zod.z.string().optional(),
       time_on_prev_s: import_zod.z.number().nonnegative().optional()
@@ -6919,7 +6918,7 @@ function isValidEventName(name) {
 async function trackEvent(apiClient, state, eventName, options) {
   const distinctId = identityManager.getDistinctId();
   if (!distinctId) {
-    console.error("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
+    if (state.config?.debug) console.log("[Paywallo:DROP] event dropped \u2014 no distinctId available yet", { eventName });
     return;
   }
   if (!isValidEventName(eventName)) {
@@ -7654,6 +7653,11 @@ function isServerError(res) {
   const r = res;
   return r.ok === false && typeof r.status === "number" && r.status >= 500;
 }
+function isRateLimitError(res) {
+  if (typeof res !== "object" || res === null) return false;
+  const r = res;
+  return r.ok === false && r.status === 429;
+}
 async function postWithQueue(deps, url, payload, label, priority) {
   const enqueue = async () => {
     await offlineQueue.enqueue(
@@ -7675,6 +7679,9 @@ async function postWithQueue(deps, url, payload, label, priority) {
     if (isServerError(res) && deps.isOfflineQueueEnabled()) {
       if (deps.isDebug()) console.log("[Paywallo:ApiClient] Server error, queued for retry:", label, priority ?? "normal");
       await enqueue();
+    } else if (isRateLimitError(res) && deps.isOfflineQueueEnabled()) {
+      if (deps.isDebug()) console.log("[Paywallo:ApiClient] Rate limited (429), queued for retry:", label, priority ?? "normal");
+      await enqueue();
     }
   } catch (error) {
     if (deps.isDebug()) console.log("[Paywallo:ApiClient] Request failed:", label, error);
@@ -7971,7 +7978,7 @@ var init_EventBatcher = __esm({
           try {
             await this.postBatch([event], `event_critical:${event.eventName}`, "critical");
           } catch (err) {
-            console.error("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
+            if (this.debug) console.log("[Paywallo:CRITICAL] critical event post failed", { eventName: event.eventName, error: err instanceof Error ? err.message : String(err) });
           }
         }
       }
@@ -7985,7 +7992,7 @@ var init_EventBatcher = __esm({
         try {
           await this.postBatch(batch, `event_batch:${batch.length}`);
         } catch (err) {
-          console.error("[Paywallo:NORMAL] batch post failed \u2014 relying on OfflineQueue", { batchSize: batch.length, error: err instanceof Error ? err.message : String(err) });
+          if (this.debug) console.log("[Paywallo:NORMAL] batch post failed \u2014 relying on OfflineQueue", { batchSize: batch.length, error: err instanceof Error ? err.message : String(err) });
         }
       }
       async postBatch(events, label, priority = "normal") {
@@ -8000,7 +8007,7 @@ var init_EventBatcher = __esm({
         const parsed = v2EnvelopeSchema.safeParse(envelope);
         if (!parsed.success) {
           if (this.debug) console.log("[Paywallo EVENTS] V2 envelope schema validation failed:", parsed.error.issues);
-          console.error("[Paywallo:CRITICAL] V2 envelope schema validation failed", { issues: parsed.error.issues, eventCount: events.length, firstEventName: events[0]?.eventName, context: providerContext });
+          if (this.debug) console.log("[Paywallo:CRITICAL] V2 envelope schema validation failed", { issues: parsed.error.issues, eventCount: events.length, firstEventName: events[0]?.eventName, context: providerContext });
           throw parsed.error;
         }
         await this.post(V2_BATCH_ENDPOINT, parsed.data, label, priority);
@@ -8618,7 +8625,6 @@ function setupNotifications(apiClient, config, environment, eventPipeline) {
     notificationsManager.setupHandlers({ eventBatcher: eventPipeline });
     notificationsManager.initialize({
       appKey: config.appKey,
-      apiBaseUrl: DEFAULT_API_URL,
       debug: config.debug,
       environment: environment === "Sandbox" ? "sandbox" : "production"
     }).catch((err) => {
@@ -8660,7 +8666,6 @@ var init_PaywalloInitHelpers = __esm({
     init_identity();
     init_notifications();
     init_NativePushBridge();
-    init_constants();
     init_SecureStorage();
   }
 });
@@ -8750,7 +8755,7 @@ function reportInitFailure(state, config, error, reason) {
       error: error instanceof Error ? error.message : String(error)
     });
   } catch (err) {
-    console.error("[Paywallo] reportInitFailure error", err);
+    if (config.debug) console.log("[Paywallo] reportInitFailure error", err);
   }
 }
 function reportInitSuccess(state, config, attempts) {
@@ -8759,7 +8764,7 @@ function reportInitSuccess(state, config, attempts) {
       void state.apiClient.reportError("INIT_RECOVERED", `Succeeded after ${attempts} retries`, { attempts });
     }
   } catch (err) {
-    console.error("[Paywallo] reportInitSuccess error", err);
+    if (config.debug) console.log("[Paywallo] reportInitSuccess error", err);
   }
 }
 async function resolveSessionFlags(state, keys, apiClient, distinctId) {
@@ -8913,12 +8918,15 @@ async function doInit(state, config) {
   setupNotifications(apiClient, config, environment, eventPipeline);
   if (config.autoStartSession !== false) {
     sessionManager.startSession().catch((err) => {
-      console.error("[Paywallo INIT] autoStart session error", err);
+      if (config.debug) console.log("[Paywallo INIT] autoStart session error", err);
     });
   }
   new InstallTracker(config.debug, {
     distinctIdProvider: () => identityManager.getDistinctId()
-  }).trackIfNeeded(apiClient, config.requestATT === true).catch(() => {
+  }).trackIfNeeded(apiClient, config.requestATT === true).then(() => {
+    if (config.debug) console.log("[Paywallo INSTALL] $app_installed sent");
+  }).catch(() => {
+    if (config.debug) console.log("[Paywallo INSTALL] $app_installed failed \u2014 will retry on next launch");
   });
   if (config.sessionFlags && config.sessionFlags.length > 0) {
     await resolveSessionFlags(state, config.sessionFlags, apiClient, distinctId);
@@ -9155,6 +9163,7 @@ var init_PaywalloClient = __esm({
         }
         if (this.state.config?.debug) console.log("[Paywallo IDENTIFY]", options ? { hasEmail: "email" in options && !!options.email, hasProperties: "properties" in options } : void 0);
         await identityManager.identify(options);
+        if (this.state.config?.debug) console.log("[Paywallo IDENTIFY] done");
       }
       async track(eventName, options) {
         return trackEvent(this.getApiClientOrThrow(), this.state, eventName, options);
@@ -9715,18 +9724,14 @@ var import_react15 = require("react");
 init_onboarding();
 function useOnboarding() {
   const step = (0, import_react15.useCallback)(
-    (stepName, order) => onboardingManager.step(stepName, order),
+    (stepName, order, options) => onboardingManager.step(stepName, order, options),
     []
   );
   const complete = (0, import_react15.useCallback)(
-    () => onboardingManager.complete(),
-    []
-  );
-  const drop = (0, import_react15.useCallback)(
-    (stepName) => onboardingManager.drop(stepName),
+    (options) => onboardingManager.complete(options),
     []
   );
-  return { step, complete, drop };
+  return { step, complete };
 }
 
 // src/hooks/usePaywallo.ts
@@ -11040,6 +11045,7 @@ function PaywalloProvider({ children, config }) {
       void pushAttributionToSuperwall(configRef.current.debug);
       setDistinctId(PaywalloClient.getDistinctId());
       setIsInitialized(true);
+      if (configRef.current.debug) console.log("[Paywallo] SDK ready", PaywalloClient.getDistinctId()?.slice(0, 8));
       if (!autoPreloadTriggeredRef.current) {
         autoPreloadTriggeredRef.current = true;
         const placement = await PaywalloClient.waitForAutoPreloadedPlacement();