@hook-sdk/template 0.14.0 → 0.15.0

package/dist/index.js

@@ -1,7 +1,7 @@
 // src/AppRoot.tsx
 import { useMemo as useMemo3 } from "react";
 import { BrowserRouter, MemoryRouter, Navigate, Route, Routes } from "react-router-dom";
-import { useHook as useHook5 } from "@hook-sdk/sdk";
+import { useHook as useHook6 } from "@hook-sdk/sdk";
 
 // src/config/AppConfigContext.tsx
 import { createContext, useContext } from "react";
@@ -77,7 +77,11 @@ var DeepLinksSchema = z.object({
 var AppConfigSchema = z.object({
   slug: z.string().regex(/^[a-z0-9-]+$/),
   name: z.string().min(1),
-  branding: z.object({ primaryColor: z.string(), logoUrl: z.string().url() }),
+  branding: z.object({
+    primaryColor: z.string(),
+    logoUrl: z.string().url(),
+    iconUrl: z.string().url().optional()
+  }),
   authFlow: AuthFlowSchema,
   paywall: PaywallSchema,
   persistedKeys: z.array(PersistedKeySchema),
@@ -175,7 +179,7 @@ function ThemeProvider({ children }) {
 
 // src/hooks/usePaywallState.ts
 import { useCallback, useContext as useContext3, useMemo as useMemo2, useState } from "react";
-import { useHook as useHook2 } from "@hook-sdk/sdk";
+import { useHook as useHook3 } from "@hook-sdk/sdk";
 
 // src/errors/asaas-pt-br.ts
 var MAP = {
@@ -196,6 +200,35 @@ function asaasErrorMessage(code) {
   return MAP[code] ?? "Ocorreu um erro inesperado. Tente novamente em instantes.";
 }
 
+// src/hooks/usePaywallTracker.ts
+import { useEffect as useEffect3, useRef } from "react";
+import { useHook as useHook2 } from "@hook-sdk/sdk";
+function deriveStep(s) {
+  if (s.pixPaid) return "success";
+  if (s.hasError) return "error";
+  if (s.pixPendingShown) return "pix_qr_shown";
+  if (s.selectedMethod === "card" && s.cpfValid) return "card_form";
+  if (s.cpfRequired && !s.cpfValid) return "cpf_input";
+  if (s.selectedMethod) return "method_select";
+  return "plan_select";
+}
+function usePaywallTracker(snapshot) {
+  const ctx = useHook2();
+  const track2 = typeof ctx.track === "function" ? ctx.track : void 0;
+  const lastStepRef = useRef(null);
+  const step = deriveStep(snapshot);
+  useEffect3(() => {
+    if (lastStepRef.current === step) return;
+    lastStepRef.current = step;
+    if (!track2) return;
+    track2("paywall_step_viewed", {
+      step,
+      method: snapshot.selectedMethod,
+      cycle: snapshot.cycle
+    });
+  }, [step]);
+}
+
 // src/hooks/usePaywallState.ts
 function isCheckoutFailure(r) {
   return "ok" in r && r.ok === false;
@@ -210,7 +243,7 @@ var FALLBACK_PAYWALL = {
 };
 var isMethodAvailable = (availability, method) => availability[method] !== false;
 function usePaywallState() {
-  const { subscription, plan } = useHook2();
+  const { subscription, plan } = useHook3();
   const configFromCtx = useContext3(AppConfigContext);
   const paywall = configFromCtx?.paywall ?? FALLBACK_PAYWALL;
   const isFree = paywall.mode === "free";
@@ -439,6 +472,16 @@ function usePaywallState() {
     () => ({ required: cpfRequired, value: cpf, set: setCpf, valid: cpfValid }),
     [cpfRequired, cpf, cpfValid]
   );
+  usePaywallTracker({
+    selectedMethod,
+    cycle,
+    cpfRequired,
+    cpfValid,
+    pixPendingShown: pixPending !== null,
+    pixPaid: pixPending?.paid === true,
+    hasError: error !== null,
+    submitting
+  });
   return {
     // Subscription status (reactive, proxied from SDK)
     status,
@@ -493,10 +536,11 @@ function SubscriptionGate({ Paywall, children }) {
 }
 
 // src/components/InstallGate/InstallGate.tsx
-import { useEffect as useEffect4, useRef } from "react";
+import { useEffect as useEffect5, useRef as useRef2 } from "react";
 
 // src/hooks/useInstallPrompt.ts
-import { useCallback as useCallback2, useEffect as useEffect3, useState as useState2 } from "react";
+import { useCallback as useCallback2, useEffect as useEffect4, useState as useState2 } from "react";
+var ANDROID_PROMPT_WAIT_MS = 3e3;
 var IOS_RE = /iPad|iPhone|iPod/;
 var IOS_NON_SAFARI_RE = /CriOS|FxiOS|EdgiOS/;
 var ANDROID_RE = /Android/;
@@ -566,11 +610,12 @@ function track(event, props) {
   if (typeof window === "undefined") return;
   window.posthog?.capture?.(event, props);
 }
-function pickVariant(state) {
+function pickVariant(state, promptWaitElapsed) {
   if (state.isInstalled) return "none";
   switch (state.platform) {
     case "android":
-      return state.isInstallable ? "android-native" : "android-manual";
+      if (state.isInstallable) return "android-native";
+      return promptWaitElapsed ? "android-manual" : "android-pending";
     case "ios-safari":
       return "ios-safari";
     case "ios-other":
@@ -640,7 +685,16 @@ function useInstallPrompt(slug) {
   const [isDismissedSession, setIsDismissedSession] = useState2(() => readSessionSkip(slug));
   const [isDismissedPermanent, setIsDismissedPermanent] = useState2(() => readPermanentDismiss(slug).dismissed);
   const [skipCount, setSkipCount] = useState2(() => readSkipCount(slug));
-  useEffect3(() => {
+  const [promptWaitElapsed, setPromptWaitElapsed] = useState2(() => {
+    if (typeof window === "undefined") return true;
+    return window.__pwaInstallPrompt != null;
+  });
+  useEffect4(() => {
+    if (promptWaitElapsed) return;
+    const id = setTimeout(() => setPromptWaitElapsed(true), ANDROID_PROMPT_WAIT_MS);
+    return () => clearTimeout(id);
+  }, [promptWaitElapsed]);
+  useEffect4(() => {
     if (typeof window === "undefined") return;
     if (window.__pwaInstallPrompt) {
       setIsInstallable(true);
@@ -664,7 +718,7 @@ function useInstallPrompt(slug) {
       window.removeEventListener("appinstalled", onInstalled);
     };
   }, [slug]);
-  useEffect3(() => {
+  useEffect4(() => {
     if (typeof window === "undefined") return;
     const mq = window.matchMedia?.("(display-mode: standalone)");
     if (!mq) return;
@@ -677,17 +731,20 @@ function useInstallPrompt(slug) {
     mq.addEventListener?.("change", handler);
     return () => mq.removeEventListener?.("change", handler);
   }, [slug]);
-  const variant = pickVariant({
-    platform,
-    iosBrowser,
-    androidBrowser,
-    inAppApp,
-    isInstallable,
-    isInstalled,
-    isDismissedSession,
-    isDismissedPermanent,
-    skipCount
-  });
+  const variant = pickVariant(
+    {
+      platform,
+      iosBrowser,
+      androidBrowser,
+      inAppApp,
+      isInstallable,
+      isInstalled,
+      isDismissedSession,
+      isDismissedPermanent,
+      skipCount
+    },
+    promptWaitElapsed
+  );
   const promptInstall = useCallback2(async () => {
     if (typeof window === "undefined") return false;
     const prompt = window.__pwaInstallPrompt;
@@ -1223,8 +1280,44 @@ function Step({ n, icon, children }) {
   );
 }
 
+// src/components/InstallGate/variants/AndroidPendingVariant.tsx
+import { jsx as jsx10 } from "react/jsx-runtime";
+function AndroidPendingVariant() {
+  const copy = INSTALL_COPY.android.native;
+  return /* @__PURE__ */ jsx10(InstallSplash, { title: copy.title, children: /* @__PURE__ */ jsx10(
+    "div",
+    {
+      style: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        gap: 16,
+        padding: "24px 0"
+      },
+      children: /* @__PURE__ */ jsx10(Spinner, {})
+    }
+  ) });
+}
+function Spinner() {
+  return /* @__PURE__ */ jsx10(
+    "div",
+    {
+      "aria-hidden": true,
+      style: {
+        width: 28,
+        height: 28,
+        borderRadius: "50%",
+        border: "3px solid #e5e5e7",
+        borderTopColor: "var(--hook-color-primary)",
+        animation: "hook-install-spin 0.8s linear infinite"
+      },
+      children: /* @__PURE__ */ jsx10("style", { children: `@keyframes hook-install-spin { to { transform: rotate(360deg); } }` })
+    }
+  );
+}
+
 // src/components/InstallGate/Step.tsx
-import { jsx as jsx10, jsxs as jsxs5 } from "react/jsx-runtime";
+import { jsx as jsx11, jsxs as jsxs5 } from "react/jsx-runtime";
 function Step2({
   n,
   title,
@@ -1242,7 +1335,7 @@ function Step2({
         textAlign: "left"
       },
       children: [
-        /* @__PURE__ */ jsx10(
+        /* @__PURE__ */ jsx11(
           "div",
           {
             style: {
@@ -1262,8 +1355,8 @@ function Step2({
           }
         ),
         /* @__PURE__ */ jsxs5("div", { style: { flex: 1 }, children: [
-          /* @__PURE__ */ jsx10("p", { style: { margin: 0, fontSize: 15, fontWeight: 500, color: "#111", lineHeight: 1.3 }, children: title }),
-          subtitle && /* @__PURE__ */ jsx10("p", { style: { margin: "4px 0 0 0", fontSize: 13, color: "#777" }, children: subtitle }),
+          /* @__PURE__ */ jsx11("p", { style: { margin: 0, fontSize: 15, fontWeight: 500, color: "#111", lineHeight: 1.3 }, children: title }),
+          subtitle && /* @__PURE__ */ jsx11("p", { style: { margin: "4px 0 0 0", fontSize: 13, color: "#777" }, children: subtitle }),
           visual
         ] })
       ]
@@ -1272,7 +1365,7 @@ function Step2({
 }
 
 // src/components/InstallGate/variants/IOSafariVariant.tsx
-import { jsx as jsx11, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx12, jsxs as jsxs6 } from "react/jsx-runtime";
 function IOSafariVariant({
   state,
   actions
@@ -1280,13 +1373,13 @@ function IOSafariVariant({
   const copy = INSTALL_COPY.iosSafari;
   const showPermanent = shouldShowPermanentOption(state);
   return /* @__PURE__ */ jsxs6(InstallSplash, { title: copy.title, subtitle: copy.subtitle, children: [
-    /* @__PURE__ */ jsx11(
+    /* @__PURE__ */ jsx12(
       Step2,
       {
         n: 1,
         title: copy.step1.title,
         subtitle: copy.step1.subtitle,
-        visual: /* @__PURE__ */ jsx11(
+        visual: /* @__PURE__ */ jsx12(
           "div",
           {
             style: {
@@ -1298,12 +1391,12 @@ function IOSafariVariant({
               padding: "12px 0",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx11(ShareIconIOS, { size: 32, style: { color: "var(--hook-color-primary)" } })
+            children: /* @__PURE__ */ jsx12(ShareIconIOS, { size: 32, style: { color: "var(--hook-color-primary)" } })
           }
         )
       }
     ),
-    /* @__PURE__ */ jsx11(
+    /* @__PURE__ */ jsx12(
       Step2,
       {
         n: 2,
@@ -1321,19 +1414,19 @@ function IOSafariVariant({
               marginTop: 8
             },
             children: [
-              /* @__PURE__ */ jsx11(SquarePlusIcon, { size: 22, style: { color: "#555" } }),
-              /* @__PURE__ */ jsx11("span", { style: { fontSize: 14, color: "#333" }, children: copy.step2.iconLabel })
+              /* @__PURE__ */ jsx12(SquarePlusIcon, { size: 22, style: { color: "#555" } }),
+              /* @__PURE__ */ jsx12("span", { style: { fontSize: 14, color: "#333" }, children: copy.step2.iconLabel })
             ]
           }
         )
       }
     ),
-    /* @__PURE__ */ jsx11(
+    /* @__PURE__ */ jsx12(
       Step2,
       {
         n: 3,
         title: copy.step3.title,
-        visual: /* @__PURE__ */ jsx11(
+        visual: /* @__PURE__ */ jsx12(
           "div",
           {
             style: {
@@ -1344,7 +1437,7 @@ function IOSafariVariant({
               padding: "10px 14px",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx11(
+            children: /* @__PURE__ */ jsx12(
               "span",
               {
                 style: {
@@ -1359,7 +1452,7 @@ function IOSafariVariant({
         )
       }
     ),
-    /* @__PURE__ */ jsx11(
+    /* @__PURE__ */ jsx12(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1369,7 +1462,7 @@ function IOSafariVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx11(
+    showPermanent && /* @__PURE__ */ jsx12(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1383,7 +1476,7 @@ function IOSafariVariant({
 }
 
 // src/components/InstallGate/variants/IOSOtherVariant.tsx
-import { jsx as jsx12, jsxs as jsxs7 } from "react/jsx-runtime";
+import { jsx as jsx13, jsxs as jsxs7 } from "react/jsx-runtime";
 function IOSOtherVariant({
   state,
   actions
@@ -1391,13 +1484,13 @@ function IOSOtherVariant({
   const copy = INSTALL_COPY.iosOther;
   const showPermanent = shouldShowPermanentOption(state);
   return /* @__PURE__ */ jsxs7(InstallSplash, { title: copy.title, subtitle: copy.subtitle, children: [
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(
       Step2,
       {
         n: 1,
         title: copy.step1.title,
         subtitle: copy.step1.subtitle,
-        visual: /* @__PURE__ */ jsx12(
+        visual: /* @__PURE__ */ jsx13(
           "div",
           {
             style: {
@@ -1409,12 +1502,12 @@ function IOSOtherVariant({
               padding: "12px 0",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx12(ShareIconIOS, { size: 32, style: { color: "var(--hook-color-primary)" } })
+            children: /* @__PURE__ */ jsx13(ShareIconIOS, { size: 32, style: { color: "var(--hook-color-primary)" } })
           }
         )
       }
     ),
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(
       Step2,
       {
         n: 2,
@@ -1432,19 +1525,19 @@ function IOSOtherVariant({
               marginTop: 8
             },
             children: [
-              /* @__PURE__ */ jsx12(SquarePlusIcon, { size: 22, style: { color: "#555" } }),
-              /* @__PURE__ */ jsx12("span", { style: { fontSize: 14, color: "#333" }, children: copy.step2.iconLabel })
+              /* @__PURE__ */ jsx13(SquarePlusIcon, { size: 22, style: { color: "#555" } }),
+              /* @__PURE__ */ jsx13("span", { style: { fontSize: 14, color: "#333" }, children: copy.step2.iconLabel })
             ]
           }
         )
       }
     ),
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(
       Step2,
       {
         n: 3,
         title: copy.step3.title,
-        visual: /* @__PURE__ */ jsx12(
+        visual: /* @__PURE__ */ jsx13(
           "div",
           {
             style: {
@@ -1455,7 +1548,7 @@ function IOSOtherVariant({
               padding: "10px 14px",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx12(
+            children: /* @__PURE__ */ jsx13(
               "span",
               {
                 style: {
@@ -1470,7 +1563,7 @@ function IOSOtherVariant({
         )
       }
     ),
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1480,7 +1573,7 @@ function IOSOtherVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx12(
+    showPermanent && /* @__PURE__ */ jsx13(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1495,7 +1588,7 @@ function IOSOtherVariant({
 
 // src/components/InstallGate/variants/InAppBrowserVariant.tsx
 import { useState as useState3 } from "react";
-import { jsx as jsx13, jsxs as jsxs8 } from "react/jsx-runtime";
+import { jsx as jsx14, jsxs as jsxs8 } from "react/jsx-runtime";
 function InAppBrowserVariant({
   state,
   actions
@@ -1512,9 +1605,9 @@ function InAppBrowserVariant({
   };
   const DotsIcon = app === "facebook" || app === "telegram" ? MenuDotsVerticalIcon : MenuDotsHorizontalIcon;
   return /* @__PURE__ */ jsxs8(InstallSplash, { title: appCopy.title, children: [
-    /* @__PURE__ */ jsx13(Step3, { n: 1, icon: /* @__PURE__ */ jsx13(DotsIcon, { size: 20 }), children: appCopy.step1 }),
-    /* @__PURE__ */ jsx13(Step3, { n: 2, icon: /* @__PURE__ */ jsx13(ExternalLinkIcon, { size: 18 }), children: appCopy.step2 }),
-    /* @__PURE__ */ jsx13(
+    /* @__PURE__ */ jsx14(Step3, { n: 1, icon: /* @__PURE__ */ jsx14(DotsIcon, { size: 20 }), children: appCopy.step1 }),
+    /* @__PURE__ */ jsx14(Step3, { n: 2, icon: /* @__PURE__ */ jsx14(ExternalLinkIcon, { size: 18 }), children: appCopy.step2 }),
+    /* @__PURE__ */ jsx14(
       "button",
       {
         "data-testid": "install-prompt-cta-inapp-copy",
@@ -1524,7 +1617,7 @@ function InAppBrowserVariant({
         children: copied ? copy.copiedToast : copy.copy
       }
     ),
-    /* @__PURE__ */ jsx13(
+    /* @__PURE__ */ jsx14(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1534,7 +1627,7 @@ function InAppBrowserVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx13(
+    showPermanent && /* @__PURE__ */ jsx14(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1565,7 +1658,7 @@ function Step3({
         textAlign: "left"
       },
       children: [
-        /* @__PURE__ */ jsx13(
+        /* @__PURE__ */ jsx14(
           "div",
           {
             style: {
@@ -1584,15 +1677,15 @@ function Step3({
             children: n
           }
         ),
-        /* @__PURE__ */ jsx13("div", { style: { flex: 1, fontSize: 14, color: "#333" }, children }),
-        /* @__PURE__ */ jsx13("div", { style: { color: "#888", flexShrink: 0 }, children: icon })
+        /* @__PURE__ */ jsx14("div", { style: { flex: 1, fontSize: 14, color: "#333" }, children }),
+        /* @__PURE__ */ jsx14("div", { style: { color: "#888", flexShrink: 0 }, children: icon })
       ]
     }
   );
 }
 
 // src/components/InstallGate/variants/DesktopVariant.tsx
-import { jsx as jsx14, jsxs as jsxs9 } from "react/jsx-runtime";
+import { jsx as jsx15, jsxs as jsxs9 } from "react/jsx-runtime";
 function DesktopVariant({
   state,
   actions
@@ -1608,14 +1701,14 @@ function DesktopVariant({
       "aria-label": copy.title,
       style: bannerStyle,
       children: [
-        iconUrl ? /* @__PURE__ */ jsx14(
+        iconUrl ? /* @__PURE__ */ jsx15(
           "img",
           {
             src: iconUrl,
             alt: "",
             style: { width: 40, height: 40, borderRadius: 10, objectFit: "cover", flexShrink: 0 }
           }
-        ) : /* @__PURE__ */ jsx14(
+        ) : /* @__PURE__ */ jsx15(
           "div",
           {
             style: {
@@ -1635,8 +1728,8 @@ function DesktopVariant({
           }
         ),
         /* @__PURE__ */ jsxs9("div", { style: { flex: 1, minWidth: 0 }, children: [
-          /* @__PURE__ */ jsx14("div", { style: { fontSize: 14, fontWeight: 600, color: "#111" }, children: copy.title }),
-          /* @__PURE__ */ jsx14("div", { style: { fontSize: 12, color: "#666" }, children: copy.subtitle })
+          /* @__PURE__ */ jsx15("div", { style: { fontSize: 14, fontWeight: 600, color: "#111" }, children: copy.title }),
+          /* @__PURE__ */ jsx15("div", { style: { fontSize: 12, color: "#666" }, children: copy.subtitle })
         ] }),
         /* @__PURE__ */ jsxs9(
           "button",
@@ -1659,12 +1752,12 @@ function DesktopVariant({
               flexShrink: 0
             },
             children: [
-              /* @__PURE__ */ jsx14(DownloadIcon, { size: 14 }),
+              /* @__PURE__ */ jsx15(DownloadIcon, { size: 14 }),
               copy.cta
             ]
           }
         ),
-        /* @__PURE__ */ jsx14(
+        /* @__PURE__ */ jsx15(
           "button",
           {
             "data-testid": "install-prompt-desktop-close",
@@ -1679,7 +1772,7 @@ function DesktopVariant({
               padding: 4,
               flexShrink: 0
             },
-            children: /* @__PURE__ */ jsx14(XIcon, { size: 16 })
+            children: /* @__PURE__ */ jsx15(XIcon, { size: 16 })
           }
         )
       ]
@@ -1703,14 +1796,14 @@ var bannerStyle = {
 };
 
 // src/components/InstallGate/InstallGate.tsx
-import { Fragment as Fragment3, jsx as jsx15, jsxs as jsxs10 } from "react/jsx-runtime";
+import { Fragment as Fragment3, jsx as jsx16, jsxs as jsxs10 } from "react/jsx-runtime";
 function InstallGate({ children }) {
   const { slug, features_enabled } = useTemplateConfig();
   const enabled = features_enabled.includes("install_prompt");
   const installState = useInstallPrompt(slug);
   const shouldBlock = enabled && shouldBlockInstall(installState);
-  const trackedRef = useRef(null);
-  useEffect4(() => {
+  const trackedRef = useRef2(null);
+  useEffect5(() => {
     if (!shouldBlock) return;
     if (typeof window === "undefined") return;
     const variantKey = `${slug}:${installState.variant}`;
@@ -1724,30 +1817,32 @@ function InstallGate({ children }) {
       variant: installState.variant
     });
   }, [shouldBlock, slug, installState.variant, installState.platform, installState.iosBrowser, installState.androidBrowser, installState.inAppApp]);
-  if (!enabled) return /* @__PURE__ */ jsx15(Fragment3, { children });
-  if (installState.isInstalled) return /* @__PURE__ */ jsx15(Fragment3, { children });
+  if (!enabled) return /* @__PURE__ */ jsx16(Fragment3, { children });
+  if (installState.isInstalled) return /* @__PURE__ */ jsx16(Fragment3, { children });
   if (installState.variant === "desktop") {
     const showBanner = !installState.isDismissedSession && !installState.isDismissedPermanent;
     return /* @__PURE__ */ jsxs10(Fragment3, { children: [
       children,
-      showBanner && /* @__PURE__ */ jsx15(DesktopVariant, { state: installState, actions: installState })
+      showBanner && /* @__PURE__ */ jsx16(DesktopVariant, { state: installState, actions: installState })
     ] });
   }
-  if (!shouldBlock) return /* @__PURE__ */ jsx15(Fragment3, { children });
+  if (!shouldBlock) return /* @__PURE__ */ jsx16(Fragment3, { children });
   switch (installState.variant) {
     case "android-native":
-      return /* @__PURE__ */ jsx15(AndroidNativeVariant, { state: installState, actions: installState });
+      return /* @__PURE__ */ jsx16(AndroidNativeVariant, { state: installState, actions: installState });
     case "android-manual":
-      return /* @__PURE__ */ jsx15(AndroidManualVariant, { state: installState, actions: installState });
+      return /* @__PURE__ */ jsx16(AndroidManualVariant, { state: installState, actions: installState });
+    case "android-pending":
+      return /* @__PURE__ */ jsx16(AndroidPendingVariant, {});
     case "ios-safari":
-      return /* @__PURE__ */ jsx15(IOSafariVariant, { state: installState, actions: installState });
+      return /* @__PURE__ */ jsx16(IOSafariVariant, { state: installState, actions: installState });
     case "ios-other":
-      return /* @__PURE__ */ jsx15(IOSOtherVariant, { state: installState, actions: installState });
+      return /* @__PURE__ */ jsx16(IOSOtherVariant, { state: installState, actions: installState });
     case "in-app":
-      return /* @__PURE__ */ jsx15(InAppBrowserVariant, { state: installState, actions: installState });
+      return /* @__PURE__ */ jsx16(InAppBrowserVariant, { state: installState, actions: installState });
     case "none":
     default:
-      return /* @__PURE__ */ jsx15(Fragment3, { children });
+      return /* @__PURE__ */ jsx16(Fragment3, { children });
   }
 }
 
@@ -1757,16 +1852,16 @@ function PushPrompt() {
 }
 
 // src/internal/SessionExpiredBanner.tsx
-import { useEffect as useEffect5, useRef as useRef2, useState as useState4 } from "react";
-import { useHook as useHook3 } from "@hook-sdk/sdk";
-import { jsx as jsx16, jsxs as jsxs11 } from "react/jsx-runtime";
+import { useEffect as useEffect6, useRef as useRef3, useState as useState4 } from "react";
+import { useHook as useHook4 } from "@hook-sdk/sdk";
+import { jsx as jsx17, jsxs as jsxs11 } from "react/jsx-runtime";
 var DISMISS_KEY = "hook:session-expired-dismissed-until";
 var DISMISS_TTL_MS = 60 * 60 * 1e3;
 function SessionExpiredBanner() {
-  const { authStatus } = useHook3();
-  const wasAuthRef = useRef2(false);
+  const { authStatus } = useHook4();
+  const wasAuthRef = useRef3(false);
   const [show, setShow] = useState4(false);
-  useEffect5(() => {
+  useEffect6(() => {
     if (authStatus === "authenticated") {
       wasAuthRef.current = true;
       setShow(false);
@@ -1788,11 +1883,11 @@ function SessionExpiredBanner() {
   }
   return /* @__PURE__ */ jsxs11("div", { role: "alert", className: "fixed top-0 inset-x-0 bg-red-600 text-white px-4 py-2 flex items-center justify-between gap-3 text-sm shadow", style: { zIndex: 10001 }, children: [
     /* @__PURE__ */ jsxs11("span", { children: [
-      /* @__PURE__ */ jsx16("strong", { children: "Sua sess\xE3o expirou." }),
+      /* @__PURE__ */ jsx17("strong", { children: "Sua sess\xE3o expirou." }),
       " Fa\xE7a login novamente para continuar."
     ] }),
     /* @__PURE__ */ jsxs11("div", { className: "flex items-center gap-2", children: [
-      /* @__PURE__ */ jsx16(
+      /* @__PURE__ */ jsx17(
         "button",
         {
           type: "button",
@@ -1801,7 +1896,7 @@ function SessionExpiredBanner() {
           children: "Fazer login"
         }
       ),
-      /* @__PURE__ */ jsx16(
+      /* @__PURE__ */ jsx17(
         "button",
         {
           type: "button",
@@ -1817,7 +1912,7 @@ function SessionExpiredBanner() {
 
 // src/defaults/ErrorBoundary.tsx
 import { Component } from "react";
-import { Fragment as Fragment4, jsx as jsx17, jsxs as jsxs12 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx18, jsxs as jsxs12 } from "react/jsx-runtime";
 var ErrorBoundary = class extends Component {
   state = { error: null };
   static getDerivedStateFromError(error) {
@@ -1836,27 +1931,27 @@ var ErrorBoundary = class extends Component {
   render() {
     if (this.state.error) {
       return this.props.fallback ?? /* @__PURE__ */ jsxs12("div", { role: "alert", style: { padding: 24, textAlign: "center" }, children: [
-        /* @__PURE__ */ jsx17("h2", { children: "Algo deu errado" }),
-        /* @__PURE__ */ jsx17("p", { style: { opacity: 0.7 }, children: "Recarregue a p\xE1gina pra tentar de novo." })
+        /* @__PURE__ */ jsx18("h2", { children: "Algo deu errado" }),
+        /* @__PURE__ */ jsx18("p", { style: { opacity: 0.7 }, children: "Recarregue a p\xE1gina pra tentar de novo." })
       ] });
     }
-    return /* @__PURE__ */ jsx17(Fragment4, { children: this.props.children });
+    return /* @__PURE__ */ jsx18(Fragment4, { children: this.props.children });
   }
 };
 
 // src/internal/PaymentReturnHandler.tsx
-import { useCallback as useCallback3, useEffect as useEffect6, useRef as useRef3, useState as useState5 } from "react";
-import { useHook as useHook4 } from "@hook-sdk/sdk";
-import { Fragment as Fragment5, jsx as jsx18, jsxs as jsxs13 } from "react/jsx-runtime";
+import { useCallback as useCallback3, useEffect as useEffect7, useRef as useRef4, useState as useState5 } from "react";
+import { useHook as useHook5 } from "@hook-sdk/sdk";
+import { Fragment as Fragment5, jsx as jsx19, jsxs as jsxs13 } from "react/jsx-runtime";
 var BACKOFF_MS = [2e3, 5e3, 1e4, 2e4, 4e4];
 var MAX_CYCLES = 3;
 var SUPPORT_MAILTO = "mailto:suporte@usehook.net?subject=Pagamento%20pendente";
 function PaymentReturnHandler({ children }) {
-  const { subscription } = useHook4();
-  const subRef = useRef3(subscription);
+  const { subscription } = useHook5();
+  const subRef = useRef4(subscription);
   subRef.current = subscription;
-  const runIdRef = useRef3(0);
-  const cyclesRef = useRef3(0);
+  const runIdRef = useRef4(0);
+  const cyclesRef = useRef4(0);
   const [state, setState] = useState5("idle");
   const runPoll = useCallback3(() => {
     const runId = ++runIdRef.current;
@@ -1893,7 +1988,7 @@ function PaymentReturnHandler({ children }) {
     };
     void tick();
   }, []);
-  useEffect6(() => {
+  useEffect7(() => {
     if (typeof window === "undefined") return;
     const url = new URL(window.location.href);
     if (url.searchParams.get("paymentReturn") !== "1") return;
@@ -1910,19 +2005,19 @@ function PaymentReturnHandler({ children }) {
     window.location.href = cleanUrl.toString();
   }, []);
   if (state === "confirming") {
-    return /* @__PURE__ */ jsx18("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: "Confirmando pagamento\u2026" });
+    return /* @__PURE__ */ jsx19("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: "Confirmando pagamento\u2026" });
   }
   if (state === "waiting") {
-    return /* @__PURE__ */ jsx18("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 320, textAlign: "center", lineHeight: 1.5 }, children: [
-      /* @__PURE__ */ jsx18("div", { style: { marginBottom: 16 }, children: "Pagamento aceito. Estamos confirmando com o banco \u2014 pode levar alguns minutos." }),
-      /* @__PURE__ */ jsx18("button", { type: "button", onClick: runPoll, style: buttonStyle, children: "Atualizar" })
+    return /* @__PURE__ */ jsx19("div", { role: "status", "aria-live": "polite", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 320, textAlign: "center", lineHeight: 1.5 }, children: [
+      /* @__PURE__ */ jsx19("div", { style: { marginBottom: 16 }, children: "Pagamento aceito. Estamos confirmando com o banco \u2014 pode levar alguns minutos." }),
+      /* @__PURE__ */ jsx19("button", { type: "button", onClick: runPoll, style: buttonStyle, children: "Atualizar" })
     ] }) });
   }
   if (state === "timeout") {
-    return /* @__PURE__ */ jsx18("div", { role: "alert", "aria-live": "assertive", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 360, textAlign: "center", lineHeight: 1.5 }, children: [
-      /* @__PURE__ */ jsx18("div", { style: { marginBottom: 16 }, children: "Ainda n\xE3o conseguimos confirmar seu pagamento com o banco. Voc\xEA pode tentar de novo, voltar pro app, ou falar com a gente." }),
+    return /* @__PURE__ */ jsx19("div", { role: "alert", "aria-live": "assertive", style: overlayStyle2, children: /* @__PURE__ */ jsxs13("div", { style: { maxWidth: 360, textAlign: "center", lineHeight: 1.5 }, children: [
+      /* @__PURE__ */ jsx19("div", { style: { marginBottom: 16 }, children: "Ainda n\xE3o conseguimos confirmar seu pagamento com o banco. Voc\xEA pode tentar de novo, voltar pro app, ou falar com a gente." }),
       /* @__PURE__ */ jsxs13("div", { style: { display: "flex", flexDirection: "column", gap: 8 }, children: [
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "button",
           {
             type: "button",
@@ -1935,7 +2030,7 @@ function PaymentReturnHandler({ children }) {
             children: "Tentar de novo"
           }
         ),
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "button",
           {
             type: "button",
@@ -1945,7 +2040,7 @@ function PaymentReturnHandler({ children }) {
             children: "Voltar pro app"
           }
         ),
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "a",
           {
             href: SUPPORT_MAILTO,
@@ -1957,7 +2052,7 @@ function PaymentReturnHandler({ children }) {
       ] })
     ] }) });
   }
-  return /* @__PURE__ */ jsx18(Fragment5, { children });
+  return /* @__PURE__ */ jsx19(Fragment5, { children });
 }
 var overlayStyle2 = {
   position: "fixed",
@@ -1996,7 +2091,7 @@ var linkStyle = {
 };
 
 // src/AppRoot.tsx
-import { Fragment as Fragment6, jsx as jsx19, jsxs as jsxs14 } from "react/jsx-runtime";
+import { Fragment as Fragment6, jsx as jsx20, jsxs as jsxs14 } from "react/jsx-runtime";
 function buildLegacyConfigShim(config) {
   const paywall = config.paywall;
   const isFree = paywall.mode === "free";
@@ -2006,7 +2101,16 @@ function buildLegacyConfigShim(config) {
     slug: config.slug,
     name: config.name,
     email_alias: config.slug,
-    theme: { primary_color: config.branding.primaryColor },
+    // Map branding into the legacy theme shape so InstallSplash (and
+    // anything else reading theme.icon_url / theme.logo_url) can surface
+    // the app icon instead of the generic "first letter of name" fallback.
+    // Falls back to logoUrl when iconUrl is unset — apps that haven't
+    // adopted iconUrl keep their previous behavior unchanged.
+    theme: {
+      primary_color: config.branding.primaryColor,
+      icon_url: config.branding.iconUrl ?? config.branding.logoUrl,
+      logo_url: config.branding.logoUrl
+    },
     features_enabled: config.features_enabled ?? [],
     dependencies_allowlist: ["react", "react-dom"],
     subscription: {
@@ -2064,10 +2168,10 @@ function AppRoot(props) {
   const Router = testRouter === "memory" ? MemoryRouter : BrowserRouter;
   const basename = `/app/${config.slug}`;
   const routerProps = testRouter === "memory" ? { basename, initialEntries: testInitialEntries } : { basename };
-  return /* @__PURE__ */ jsx19(ErrorBoundary, { children: /* @__PURE__ */ jsx19(AppConfigProvider, { config, children: /* @__PURE__ */ jsx19(TemplateConfigProvider, { config: legacyShim, children: /* @__PURE__ */ jsx19(ThemeProvider, { children: /* @__PURE__ */ jsx19(PersistenceRegistry, { config: config.persistedKeys, children: /* @__PURE__ */ jsxs14(Router, { ...routerProps, children: [
-    /* @__PURE__ */ jsx19(DeepLinkHandler, { deepLinks: config.deepLinks }),
-    /* @__PURE__ */ jsx19(SessionExpiredBanner, {}),
-    /* @__PURE__ */ jsx19(InstallGate, { children: /* @__PURE__ */ jsx19(
+  return /* @__PURE__ */ jsx20(ErrorBoundary, { children: /* @__PURE__ */ jsx20(AppConfigProvider, { config, children: /* @__PURE__ */ jsx20(TemplateConfigProvider, { config: legacyShim, children: /* @__PURE__ */ jsx20(ThemeProvider, { children: /* @__PURE__ */ jsx20(PersistenceRegistry, { config: config.persistedKeys, children: /* @__PURE__ */ jsxs14(Router, { ...routerProps, children: [
+    /* @__PURE__ */ jsx20(DeepLinkHandler, { deepLinks: config.deepLinks }),
+    /* @__PURE__ */ jsx20(SessionExpiredBanner, {}),
+    /* @__PURE__ */ jsx20(InstallGate, { children: /* @__PURE__ */ jsx20(
       AuthGated,
       {
         config,
@@ -2081,7 +2185,7 @@ function AppRoot(props) {
         PreAuthFlow,
         children: /* @__PURE__ */ jsxs14(SubscriptionGate, { Paywall: Paywall ?? FallbackPaywall, children: [
           children,
-          /* @__PURE__ */ jsx19(PushPrompt, {})
+          /* @__PURE__ */ jsx20(PushPrompt, {})
         ] })
       }
     ) })
@@ -2097,37 +2201,37 @@ function AuthGated({
   EmailVerify,
   PreAuthFlow
 }) {
-  const { authStatus } = useHook5();
+  const { authStatus } = useHook6();
   if (authStatus === "loading") return null;
   if (authStatus !== "authenticated") {
     if (config.onboarding?.trigger === "pre_signup_custom" && PreAuthFlow) {
       return /* @__PURE__ */ jsxs14(Routes, { children: [
-        /* @__PURE__ */ jsx19(Route, { path: "/signin", element: /* @__PURE__ */ jsx19(Login, {}) }),
-        /* @__PURE__ */ jsx19(Route, { path: "/signup", element: /* @__PURE__ */ jsx19(Signup, {}) }),
-        /* @__PURE__ */ jsx19(Route, { path: "/forgot", element: /* @__PURE__ */ jsx19(Forgot, {}) }),
-        /* @__PURE__ */ jsx19(Route, { path: "/reset", element: /* @__PURE__ */ jsx19(Reset, {}) }),
-        EmailVerify ? /* @__PURE__ */ jsx19(Route, { path: "/verify", element: /* @__PURE__ */ jsx19(EmailVerify, {}) }) : null,
-        /* @__PURE__ */ jsx19(Route, { path: "/*", element: /* @__PURE__ */ jsx19(PreAuthFlow, {}) })
+        /* @__PURE__ */ jsx20(Route, { path: "/signin", element: /* @__PURE__ */ jsx20(Login, {}) }),
+        /* @__PURE__ */ jsx20(Route, { path: "/signup", element: /* @__PURE__ */ jsx20(Signup, {}) }),
+        /* @__PURE__ */ jsx20(Route, { path: "/forgot", element: /* @__PURE__ */ jsx20(Forgot, {}) }),
+        /* @__PURE__ */ jsx20(Route, { path: "/reset", element: /* @__PURE__ */ jsx20(Reset, {}) }),
+        EmailVerify ? /* @__PURE__ */ jsx20(Route, { path: "/verify", element: /* @__PURE__ */ jsx20(EmailVerify, {}) }) : null,
+        /* @__PURE__ */ jsx20(Route, { path: "/*", element: /* @__PURE__ */ jsx20(PreAuthFlow, {}) })
       ] });
     }
     return /* @__PURE__ */ jsxs14(Routes, { children: [
-      /* @__PURE__ */ jsx19(Route, { path: "/", element: /* @__PURE__ */ jsx19(Login, {}) }),
-      /* @__PURE__ */ jsx19(Route, { path: "/signup", element: /* @__PURE__ */ jsx19(Signup, {}) }),
-      /* @__PURE__ */ jsx19(Route, { path: "/forgot", element: /* @__PURE__ */ jsx19(Forgot, {}) }),
-      /* @__PURE__ */ jsx19(Route, { path: "/reset", element: /* @__PURE__ */ jsx19(Reset, {}) }),
-      EmailVerify ? /* @__PURE__ */ jsx19(Route, { path: "/verify", element: /* @__PURE__ */ jsx19(EmailVerify, {}) }) : null,
-      /* @__PURE__ */ jsx19(Route, { path: "*", element: /* @__PURE__ */ jsx19(Navigate, { to: "/", replace: true }) })
+      /* @__PURE__ */ jsx20(Route, { path: "/", element: /* @__PURE__ */ jsx20(Login, {}) }),
+      /* @__PURE__ */ jsx20(Route, { path: "/signup", element: /* @__PURE__ */ jsx20(Signup, {}) }),
+      /* @__PURE__ */ jsx20(Route, { path: "/forgot", element: /* @__PURE__ */ jsx20(Forgot, {}) }),
+      /* @__PURE__ */ jsx20(Route, { path: "/reset", element: /* @__PURE__ */ jsx20(Reset, {}) }),
+      EmailVerify ? /* @__PURE__ */ jsx20(Route, { path: "/verify", element: /* @__PURE__ */ jsx20(EmailVerify, {}) }) : null,
+      /* @__PURE__ */ jsx20(Route, { path: "*", element: /* @__PURE__ */ jsx20(Navigate, { to: "/", replace: true }) })
     ] });
   }
-  return /* @__PURE__ */ jsx19(Fragment6, { children });
+  return /* @__PURE__ */ jsx20(Fragment6, { children });
 }
 function FallbackPaywall() {
   return null;
 }
 
 // src/hooks/usePush.ts
-import { useCallback as useCallback4, useEffect as useEffect7, useState as useState6 } from "react";
-import { useHook as useHook6 } from "@hook-sdk/sdk";
+import { useCallback as useCallback4, useEffect as useEffect8, useState as useState6 } from "react";
+import { useHook as useHook7 } from "@hook-sdk/sdk";
 var DISMISS_STORAGE_KEY = "push:dismissed-until";
 var DISMISS_TTL_MS2 = 7 * 24 * 60 * 60 * 1e3;
 function detectIosNeedsInstall() {
@@ -2171,9 +2275,9 @@ function deriveState(push) {
   return { kind: "prompt" };
 }
 function usePush() {
-  const { push } = useHook6();
+  const { push } = useHook7();
   const [state, setState] = useState6(() => deriveState(push));
-  useEffect7(() => {
+  useEffect8(() => {
     setState(deriveState(push));
   }, [push]);
   const subscribe = useCallback4(async () => {
@@ -2210,7 +2314,7 @@ function usePush() {
 }
 
 // src/components/PushPrompt.tsx
-import { jsx as jsx20, jsxs as jsxs15 } from "react/jsx-runtime";
+import { jsx as jsx21, jsxs as jsxs15 } from "react/jsx-runtime";
 function platformRecoveryCopy(texts) {
   if (typeof navigator === "undefined") return null;
   const ua = navigator.userAgent || "";
@@ -2234,27 +2338,27 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
   if (state.kind === "subscribed" || state.kind === "dismissed") return null;
   if (state.kind === "ios_needs_install") {
     return /* @__PURE__ */ jsxs15("div", { className, role: "region", "aria-label": texts.iosInstallTitle, children: [
-      /* @__PURE__ */ jsx20("h3", { children: texts.iosInstallTitle }),
-      /* @__PURE__ */ jsx20("p", { children: texts.iosInstallBody }),
-      onInstallRequested && texts.iosInstallCta && /* @__PURE__ */ jsx20("button", { onClick: onInstallRequested, children: texts.iosInstallCta })
+      /* @__PURE__ */ jsx21("h3", { children: texts.iosInstallTitle }),
+      /* @__PURE__ */ jsx21("p", { children: texts.iosInstallBody }),
+      onInstallRequested && texts.iosInstallCta && /* @__PURE__ */ jsx21("button", { onClick: onInstallRequested, children: texts.iosInstallCta })
     ] });
   }
   if (state.kind === "denied") {
     const recovery = platformRecoveryCopy(texts);
     return /* @__PURE__ */ jsxs15("div", { className, role: "region", "aria-label": texts.deniedTitle, children: [
-      /* @__PURE__ */ jsx20("h3", { children: texts.deniedTitle }),
-      /* @__PURE__ */ jsx20("p", { children: texts.deniedBody }),
-      recovery && /* @__PURE__ */ jsx20("p", { "data-testid": "denied-recovery", children: recovery })
+      /* @__PURE__ */ jsx21("h3", { children: texts.deniedTitle }),
+      /* @__PURE__ */ jsx21("p", { children: texts.deniedBody }),
+      recovery && /* @__PURE__ */ jsx21("p", { "data-testid": "denied-recovery", children: recovery })
     ] });
   }
   if (state.kind === "unsupported") {
-    return /* @__PURE__ */ jsx20("div", { className, role: "region", children: /* @__PURE__ */ jsx20("p", { children: texts.unsupportedBody }) });
+    return /* @__PURE__ */ jsx21("div", { className, role: "region", children: /* @__PURE__ */ jsx21("p", { children: texts.unsupportedBody }) });
   }
   if (state.kind === "error") {
-    return /* @__PURE__ */ jsx20("div", { className, role: "region", "aria-label": "error", children: /* @__PURE__ */ jsx20("p", { children: state.message }) });
+    return /* @__PURE__ */ jsx21("div", { className, role: "region", "aria-label": "error", children: /* @__PURE__ */ jsx21("p", { children: state.message }) });
   }
   return /* @__PURE__ */ jsxs15("div", { className, role: "region", children: [
-    /* @__PURE__ */ jsx20(
+    /* @__PURE__ */ jsx21(
       "button",
       {
         type: "button",
@@ -2268,29 +2372,29 @@ function PushPrompt2({ texts, onSubscribed, onDeclined, onInstallRequested, clas
         children: texts.cta
       }
     ),
-    onDeclined && /* @__PURE__ */ jsx20("button", { type: "button", onClick: onDeclined, children: texts.declineCta })
+    onDeclined && /* @__PURE__ */ jsx21("button", { type: "button", onClick: onDeclined, children: texts.declineCta })
   ] });
 }
 
 // src/defaults/LoadingState.tsx
-import { jsx as jsx21 } from "react/jsx-runtime";
+import { jsx as jsx22 } from "react/jsx-runtime";
 function LoadingState({ message }) {
-  return /* @__PURE__ */ jsx21("div", { role: "status", "aria-live": "polite", style: { padding: 24, textAlign: "center" }, children: /* @__PURE__ */ jsx21("span", { children: message ?? "Carregando..." }) });
+  return /* @__PURE__ */ jsx22("div", { role: "status", "aria-live": "polite", style: { padding: 24, textAlign: "center" }, children: /* @__PURE__ */ jsx22("span", { children: message ?? "Carregando..." }) });
 }
 
 // src/defaults/EmptyState.tsx
-import { jsx as jsx22, jsxs as jsxs16 } from "react/jsx-runtime";
+import { jsx as jsx23, jsxs as jsxs16 } from "react/jsx-runtime";
 function EmptyState({ title, description, action }) {
   return /* @__PURE__ */ jsxs16("div", { role: "status", style: { padding: 32, textAlign: "center" }, children: [
-    /* @__PURE__ */ jsx22("h2", { style: { marginBottom: 8 }, children: title }),
-    description && /* @__PURE__ */ jsx22("p", { style: { opacity: 0.7 }, children: description }),
-    action && /* @__PURE__ */ jsx22("div", { style: { marginTop: 16 }, children: action })
+    /* @__PURE__ */ jsx23("h2", { style: { marginBottom: 8 }, children: title }),
+    description && /* @__PURE__ */ jsx23("p", { style: { opacity: 0.7 }, children: description }),
+    action && /* @__PURE__ */ jsx23("div", { style: { marginTop: 16 }, children: action })
   ] });
 }
 
 // src/hooks/useLoginForm.ts
 import { useCallback as useCallback5, useMemo as useMemo4, useState as useState7 } from "react";
-import { useHook as useHook7 } from "@hook-sdk/sdk";
+import { useHook as useHook8 } from "@hook-sdk/sdk";
 
 // src/errors.ts
 import { SdkError, SdkAuthError, SdkRateLimitError } from "@hook-sdk/sdk";
@@ -2325,7 +2429,7 @@ function mapSdkError(err) {
 var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 var MIN_PASSWORD = 8;
 function useLoginForm() {
-  const { auth } = useHook7();
+  const { auth } = useHook8();
   const [email, setEmail] = useState7("");
   const [password, setPassword] = useState7("");
   const [submitting, setSubmitting] = useState7(false);
@@ -2381,11 +2485,11 @@ function useLoginForm() {
 
 // src/hooks/useSignupForm.ts
 import { useCallback as useCallback6, useMemo as useMemo5, useState as useState8 } from "react";
-import { useHook as useHook8 } from "@hook-sdk/sdk";
+import { useHook as useHook9 } from "@hook-sdk/sdk";
 var EMAIL_RE2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 var MIN_PASSWORD2 = 8;
 function useSignupForm() {
-  const { auth } = useHook8();
+  const { auth } = useHook9();
   const [name, setName] = useState8("");
   const [email, setEmail] = useState8("");
   const [password, setPassword] = useState8("");
@@ -2453,10 +2557,10 @@ function useSignupForm() {
 
 // src/hooks/useForgotForm.ts
 import { useCallback as useCallback7, useMemo as useMemo6, useState as useState9 } from "react";
-import { useHook as useHook9 } from "@hook-sdk/sdk";
+import { useHook as useHook10 } from "@hook-sdk/sdk";
 var EMAIL_RE3 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function useForgotForm() {
-  const { auth } = useHook9();
+  const { auth } = useHook10();
   const [email, setEmail] = useState9("");
   const [submitting, setSubmitting] = useState9(false);
   const [sent, setSent] = useState9(false);
@@ -2501,11 +2605,11 @@ function useForgotForm() {
 }
 
 // src/hooks/useResetForm.ts
-import { useCallback as useCallback8, useEffect as useEffect8, useMemo as useMemo7, useState as useState10 } from "react";
-import { useHook as useHook10 } from "@hook-sdk/sdk";
+import { useCallback as useCallback8, useEffect as useEffect9, useMemo as useMemo7, useState as useState10 } from "react";
+import { useHook as useHook11 } from "@hook-sdk/sdk";
 var MIN_PASSWORD3 = 12;
 function useResetForm() {
-  const { auth } = useHook10();
+  const { auth } = useHook11();
   const [token, setToken] = useState10(null);
   const [password, setPassword] = useState10("");
   const [confirm, setConfirm] = useState10("");
@@ -2515,7 +2619,7 @@ function useResetForm() {
   const [touchedPassword, setTouchedPassword] = useState10(false);
   const [touchedConfirm, setTouchedConfirm] = useState10(false);
   const [formSubmitAttempted, setFormSubmitAttempted] = useState10(false);
-  useEffect8(() => {
+  useEffect9(() => {
     if (typeof window === "undefined") return;
     const params = new URLSearchParams(window.location.search);
     const t = params.get("token");
@@ -2574,9 +2678,9 @@ function useResetForm() {
 }
 
 // src/hooks/usePlan.ts
-import { useHook as useHook11 } from "@hook-sdk/sdk";
+import { useHook as useHook12 } from "@hook-sdk/sdk";
 function usePlan() {
-  const { plan } = useHook11();
+  const { plan } = useHook12();
   return plan;
 }
 
@@ -2609,12 +2713,12 @@ function discountPercent(anchorCents, realCents) {
 }
 
 // src/hooks/useAuthPrimitives.ts
-import { useEffect as useEffect9 } from "react";
-import { useHook as useHook12 } from "@hook-sdk/sdk";
+import { useEffect as useEffect10 } from "react";
+import { useHook as useHook13 } from "@hook-sdk/sdk";
 var warned = false;
 function useAuthPrimitives() {
-  const { auth } = useHook12();
-  useEffect9(() => {
+  const { auth } = useHook13();
+  useEffect10(() => {
     if (!warned && process.env.NODE_ENV !== "production") {
       warned = true;
       console.warn(
@@ -2636,9 +2740,9 @@ function useAuthPrimitives() {
 }
 
 // src/hooks/useAuth.ts
-import { useHook as useHook13 } from "@hook-sdk/sdk";
+import { useHook as useHook14 } from "@hook-sdk/sdk";
 function useAuth() {
-  const { user, authStatus, auth } = useHook13();
+  const { user, authStatus, auth } = useHook14();
   return {
     user,
     authStatus,
@@ -2647,19 +2751,19 @@ function useAuth() {
 }
 
 // src/hooks/useSubscription.ts
-import { useHook as useHook14 } from "@hook-sdk/sdk";
+import { useHook as useHook15 } from "@hook-sdk/sdk";
 function useSubscription() {
-  const { subscription } = useHook14();
+  const { subscription } = useHook15();
   return {
     status: subscription.status()
   };
 }
 
 // src/hooks/useReminders.ts
-import { useCallback as useCallback9, useEffect as useEffect10, useState as useState11 } from "react";
-import { useHook as useHook15 } from "@hook-sdk/sdk";
+import { useCallback as useCallback9, useEffect as useEffect11, useState as useState11 } from "react";
+import { useHook as useHook16 } from "@hook-sdk/sdk";
 function useReminders() {
-  const { push } = useHook15();
+  const { push } = useHook16();
   const r = push.reminders;
   const [reminders, setReminders] = useState11([]);
   const [loading, setLoading] = useState11(true);
@@ -2672,7 +2776,7 @@ function useReminders() {
       setLoading(false);
     }
   }, [r]);
-  useEffect10(() => {
+  useEffect11(() => {
     void reload();
   }, [reload]);
   const setReminder = useCallback9(async (input) => {
@@ -2711,20 +2815,20 @@ function useToast() {
 
 // src/RouteBoundary.tsx
 import { Routes as Routes2, Route as Route2 } from "react-router-dom";
-import { jsx as jsx23, jsxs as jsxs17 } from "react/jsx-runtime";
+import { jsx as jsx24, jsxs as jsxs17 } from "react/jsx-runtime";
 function RouteBoundary({ children }) {
   return /* @__PURE__ */ jsxs17(Routes2, { children: [
     children,
-    /* @__PURE__ */ jsx23(Route2, { path: "*", element: /* @__PURE__ */ jsx23(DefaultNotFound, {}) })
+    /* @__PURE__ */ jsx24(Route2, { path: "*", element: /* @__PURE__ */ jsx24(DefaultNotFound, {}) })
   ] });
 }
 function DefaultNotFound() {
-  return /* @__PURE__ */ jsx23("div", { role: "alert", children: "P\xE1gina n\xE3o encontrada" });
+  return /* @__PURE__ */ jsx24("div", { role: "alert", children: "P\xE1gina n\xE3o encontrada" });
 }
 
 // src/PreAuthShell.tsx
 import { BrowserRouter as BrowserRouter2, MemoryRouter as MemoryRouter2, Routes as Routes3 } from "react-router-dom";
-import { jsx as jsx24 } from "react/jsx-runtime";
+import { jsx as jsx25 } from "react/jsx-runtime";
 function PreAuthShell({
   basename,
   testRouter,
@@ -2732,14 +2836,14 @@ function PreAuthShell({
   children
 }) {
   if (testRouter === "memory") {
-    return /* @__PURE__ */ jsx24(MemoryRouter2, { basename, initialEntries: testInitialEntries, children: /* @__PURE__ */ jsx24(Routes3, { children }) });
+    return /* @__PURE__ */ jsx25(MemoryRouter2, { basename, initialEntries: testInitialEntries, children: /* @__PURE__ */ jsx25(Routes3, { children }) });
   }
-  return /* @__PURE__ */ jsx24(BrowserRouter2, { basename, children: /* @__PURE__ */ jsx24(Routes3, { children }) });
+  return /* @__PURE__ */ jsx25(BrowserRouter2, { basename, children: /* @__PURE__ */ jsx25(Routes3, { children }) });
 }
 
 // src/OnboardingFlow.tsx
-import { useCallback as useCallback11, useMemo as useMemo8, useRef as useRef4 } from "react";
-import { usePersistedState } from "@hook-sdk/sdk";
+import { useCallback as useCallback11, useEffect as useEffect12, useMemo as useMemo8, useRef as useRef5 } from "react";
+import { usePersistedState, useHook as useHook17 } from "@hook-sdk/sdk";
 
 // src/hooks/useOnboardingStep.ts
 import { createContext as createContext3, useContext as useContext4 } from "react";
@@ -2755,7 +2859,7 @@ function useOnboardingStep() {
 }
 
 // src/OnboardingFlow.tsx
-import { jsx as jsx25 } from "react/jsx-runtime";
+import { jsx as jsx26 } from "react/jsx-runtime";
 var isFilled = (v) => v != null && v !== "";
 var CURRENT_STEP_FIELD = "currentStep";
 function readPersistedStepIdx(draft) {
@@ -2769,7 +2873,7 @@ function OnboardingFlow({
   persistKey
 }) {
   const [draft, setDraft, status] = usePersistedState(persistKey, {});
-  const draftRef = useRef4(draft);
+  const draftRef = useRef5(draft);
   draftRef.current = draft;
   const idx = readPersistedStepIdx(draft);
   const clampedIdx = Math.min(Math.max(idx, 0), Math.max(steps.length - 1, 0));
@@ -2791,6 +2895,18 @@ function OnboardingFlow({
     [setDraft]
   );
   const step = steps[clampedIdx];
+  const hookCtx = useHook17();
+  const track2 = typeof hookCtx.track === "function" ? hookCtx.track : void 0;
+  useEffect12(() => {
+    if (status.loading) return;
+    if (!step) return;
+    if (!track2) return;
+    track2("onboarding_step_viewed", {
+      step: step.id,
+      step_index: clampedIdx,
+      total_steps: steps.length
+    });
+  }, [step?.id, clampedIdx, steps.length, status.loading, track2]);
   const valid = useMemo8(
     () => step ? (step.validates ?? []).every((field) => isFilled(draft[field])) : false,
     [draft, step]
@@ -2833,7 +2949,7 @@ function OnboardingFlow({
       `[hook-template] OnboardingFlow: missing screen component for step '${step.id}' (expected key '${step.screen}' in screens prop)`
     );
   }
-  return /* @__PURE__ */ jsx25(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx25(Screen, {}) });
+  return /* @__PURE__ */ jsx26(OnboardingStepContext.Provider, { value: ctx, children: /* @__PURE__ */ jsx26(Screen, {}) });
 }
 
 // src/hooks/useFeature.ts