@hook-sdk/template 0.14.0 → 0.14.1

package/dist/index.js

@@ -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),
@@ -497,6 +501,7 @@ import { useEffect as useEffect4, useRef } from "react";
 
 // src/hooks/useInstallPrompt.ts
 import { useCallback as useCallback2, useEffect as useEffect3, 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 +571,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,6 +646,15 @@ function useInstallPrompt(slug) {
   const [isDismissedSession, setIsDismissedSession] = useState2(() => readSessionSkip(slug));
   const [isDismissedPermanent, setIsDismissedPermanent] = useState2(() => readPermanentDismiss(slug).dismissed);
   const [skipCount, setSkipCount] = useState2(() => readSkipCount(slug));
+  const [promptWaitElapsed, setPromptWaitElapsed] = useState2(() => {
+    if (typeof window === "undefined") return true;
+    return window.__pwaInstallPrompt != null;
+  });
+  useEffect3(() => {
+    if (promptWaitElapsed) return;
+    const id = setTimeout(() => setPromptWaitElapsed(true), ANDROID_PROMPT_WAIT_MS);
+    return () => clearTimeout(id);
+  }, [promptWaitElapsed]);
   useEffect3(() => {
     if (typeof window === "undefined") return;
     if (window.__pwaInstallPrompt) {
@@ -677,17 +692,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 +1241,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 +1296,7 @@ function Step2({
         textAlign: "left"
       },
       children: [
-        /* @__PURE__ */ jsx10(
+        /* @__PURE__ */ jsx11(
           "div",
           {
             style: {
@@ -1262,8 +1316,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 +1326,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 +1334,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 +1352,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 +1375,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 +1398,7 @@ function IOSafariVariant({
               padding: "10px 14px",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx11(
+            children: /* @__PURE__ */ jsx12(
               "span",
               {
                 style: {
@@ -1359,7 +1413,7 @@ function IOSafariVariant({
         )
       }
     ),
-    /* @__PURE__ */ jsx11(
+    /* @__PURE__ */ jsx12(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1369,7 +1423,7 @@ function IOSafariVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx11(
+    showPermanent && /* @__PURE__ */ jsx12(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1383,7 +1437,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 +1445,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 +1463,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 +1486,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 +1509,7 @@ function IOSOtherVariant({
               padding: "10px 14px",
               marginTop: 8
             },
-            children: /* @__PURE__ */ jsx12(
+            children: /* @__PURE__ */ jsx13(
               "span",
               {
                 style: {
@@ -1470,7 +1524,7 @@ function IOSOtherVariant({
         )
       }
     ),
-    /* @__PURE__ */ jsx12(
+    /* @__PURE__ */ jsx13(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1480,7 +1534,7 @@ function IOSOtherVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx12(
+    showPermanent && /* @__PURE__ */ jsx13(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1495,7 +1549,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 +1566,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 +1578,7 @@ function InAppBrowserVariant({
         children: copied ? copy.copiedToast : copy.copy
       }
     ),
-    /* @__PURE__ */ jsx13(
+    /* @__PURE__ */ jsx14(
       "button",
       {
         "data-testid": "install-prompt-skip-session",
@@ -1534,7 +1588,7 @@ function InAppBrowserVariant({
         children: copy.skip
       }
     ),
-    showPermanent && /* @__PURE__ */ jsx13(
+    showPermanent && /* @__PURE__ */ jsx14(
       "button",
       {
         "data-testid": "install-prompt-skip-permanent",
@@ -1565,7 +1619,7 @@ function Step3({
         textAlign: "left"
       },
       children: [
-        /* @__PURE__ */ jsx13(
+        /* @__PURE__ */ jsx14(
           "div",
           {
             style: {
@@ -1584,15 +1638,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 +1662,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 +1689,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 +1713,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 +1733,7 @@ function DesktopVariant({
               padding: 4,
               flexShrink: 0
             },
-            children: /* @__PURE__ */ jsx14(XIcon, { size: 16 })
+            children: /* @__PURE__ */ jsx15(XIcon, { size: 16 })
           }
         )
       ]
@@ -1703,7 +1757,7 @@ 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");
@@ -1724,30 +1778,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 });
   }
 }
 
@@ -1759,7 +1815,7 @@ 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 { 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() {
@@ -1788,11 +1844,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 +1857,7 @@ function SessionExpiredBanner() {
           children: "Fazer login"
         }
       ),
-      /* @__PURE__ */ jsx16(
+      /* @__PURE__ */ jsx17(
         "button",
         {
           type: "button",
@@ -1817,7 +1873,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,18 +1892,18 @@ 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 { 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";
@@ -1910,19 +1966,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 +1991,7 @@ function PaymentReturnHandler({ children }) {
             children: "Tentar de novo"
           }
         ),
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "button",
           {
             type: "button",
@@ -1945,7 +2001,7 @@ function PaymentReturnHandler({ children }) {
             children: "Voltar pro app"
           }
         ),
-        /* @__PURE__ */ jsx18(
+        /* @__PURE__ */ jsx19(
           "a",
           {
             href: SUPPORT_MAILTO,
@@ -1957,7 +2013,7 @@ function PaymentReturnHandler({ children }) {
       ] })
     ] }) });
   }
-  return /* @__PURE__ */ jsx18(Fragment5, { children });
+  return /* @__PURE__ */ jsx19(Fragment5, { children });
 }
 var overlayStyle2 = {
   position: "fixed",
@@ -1996,7 +2052,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 +2062,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 +2129,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 +2146,7 @@ function AppRoot(props) {
         PreAuthFlow,
         children: /* @__PURE__ */ jsxs14(SubscriptionGate, { Paywall: Paywall ?? FallbackPaywall, children: [
           children,
-          /* @__PURE__ */ jsx19(PushPrompt, {})
+          /* @__PURE__ */ jsx20(PushPrompt, {})
         ] })
       }
     ) })
@@ -2102,24 +2167,24 @@ function AuthGated({
   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;
@@ -2210,7 +2275,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 +2299,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,23 +2333,23 @@ 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 })
   ] });
 }
 
@@ -2711,20 +2776,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,9 +2797,9 @@ 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
@@ -2755,7 +2820,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) {
@@ -2833,7 +2898,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