@virex-tech/paywallo-sdk 2.5.3 → 2.6.0

package/dist/index.mjs

@@ -648,9 +648,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() {
@@ -2285,18 +2288,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;
   }
 });
 
@@ -2611,8 +2611,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 {
   }
@@ -3066,10 +3066,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);
       }
@@ -3245,7 +3242,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"
     };
   }
 });
@@ -3275,16 +3273,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",
@@ -3296,33 +3298,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;
       }
@@ -3354,6 +3344,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();
   }
@@ -5221,7 +5219,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)
@@ -5234,7 +5232,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++;
@@ -5246,7 +5244,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,
@@ -5257,7 +5255,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
@@ -5287,7 +5285,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)
@@ -5298,7 +5296,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 = z.object({
-      type: z.enum(["step", "complete", "drop"]),
-      step_index: z.number().int().nonnegative().optional(),
+      type: z.enum(["step", "complete"]),
+      family: z.literal("onboarding").optional(),
+      order: z.number().nonnegative().optional(),
       step_name: z.string().optional(),
       variant_key: z.string().optional(),
       time_on_prev_s: 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();
   }
 });
@@ -8751,7 +8756,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) {
@@ -8760,7 +8765,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) {
@@ -8914,12 +8919,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);
@@ -9154,6 +9162,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);
@@ -9635,18 +9644,14 @@ init_onboarding();
 import { useCallback as useCallback9 } from "react";
 function useOnboarding() {
   const step = useCallback9(
-    (stepName, order) => onboardingManager.step(stepName, order),
+    (stepName, order, options) => onboardingManager.step(stepName, order, options),
     []
   );
   const complete = useCallback9(
-    () => onboardingManager.complete(),
-    []
-  );
-  const drop = useCallback9(
-    (stepName) => onboardingManager.drop(stepName),
+    (options) => onboardingManager.complete(options),
     []
   );
-  return { step, complete, drop };
+  return { step, complete };
 }
 
 // src/hooks/usePaywallo.ts
@@ -10960,6 +10965,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();