@hook-sdk/template 0.14.1 → 0.16.0

package/dist/index.cjs

@@ -64,14 +64,15 @@ __export(index_exports, {
   useResetForm: () => useResetForm,
   useSignupForm: () => useSignupForm,
   useSubscription: () => useSubscription,
-  useToast: () => useToast
+  useToast: () => useToast,
+  useTrackOnboardingStep: () => import_sdk19.useTrackOnboardingStep
 });
 module.exports = __toCommonJS(index_exports);
 
 // src/AppRoot.tsx
-var import_react12 = require("react");
+var import_react13 = require("react");
 var import_react_router_dom2 = require("react-router-dom");
-var import_sdk5 = require("@hook-sdk/sdk");
+var import_sdk6 = require("@hook-sdk/sdk");
 
 // src/config/AppConfigContext.tsx
 var import_react = require("react");
@@ -248,8 +249,8 @@ function ThemeProvider({ children }) {
 }
 
 // src/hooks/usePaywallState.ts
-var import_react5 = require("react");
-var import_sdk2 = require("@hook-sdk/sdk");
+var import_react6 = require("react");
+var import_sdk3 = require("@hook-sdk/sdk");
 
 // src/errors/asaas-pt-br.ts
 var MAP = {
@@ -270,6 +271,35 @@ function asaasErrorMessage(code) {
   return MAP[code] ?? "Ocorreu um erro inesperado. Tente novamente em instantes.";
 }
 
+// src/hooks/usePaywallTracker.ts
+var import_react5 = require("react");
+var import_sdk2 = require("@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 = (0, import_sdk2.useHook)();
+  const track2 = typeof ctx.track === "function" ? ctx.track : void 0;
+  const lastStepRef = (0, import_react5.useRef)(null);
+  const step = deriveStep(snapshot);
+  (0, import_react5.useEffect)(() => {
+    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;
@@ -284,11 +314,11 @@ var FALLBACK_PAYWALL = {
 };
 var isMethodAvailable = (availability, method) => availability[method] !== false;
 function usePaywallState() {
-  const { subscription, plan } = (0, import_sdk2.useHook)();
-  const configFromCtx = (0, import_react5.useContext)(AppConfigContext);
+  const { subscription, plan } = (0, import_sdk3.useHook)();
+  const configFromCtx = (0, import_react6.useContext)(AppConfigContext);
   const paywall = configFromCtx?.paywall ?? FALLBACK_PAYWALL;
   const isFree = paywall.mode === "free";
-  const declaredMethods = (0, import_react5.useMemo)(
+  const declaredMethods = (0, import_react6.useMemo)(
     () => isFree ? [] : paywall.checkoutMethods,
     [isFree, paywall]
   );
@@ -297,33 +327,33 @@ function usePaywallState() {
     "pix-auto": null,
     "pix-once": null
   };
-  const methods = (0, import_react5.useMemo)(
+  const methods = (0, import_react6.useMemo)(
     () => declaredMethods.filter((m) => isMethodAvailable(availability, m)),
     [declaredMethods, availability]
   );
   const defaultMethod = methods[0] ?? declaredMethods[0] ?? "card";
-  const [selectedMethodRaw, setSelectedMethod] = (0, import_react5.useState)(defaultMethod);
+  const [selectedMethodRaw, setSelectedMethod] = (0, import_react6.useState)(defaultMethod);
   const selectedMethod = methods.includes(selectedMethodRaw) ? selectedMethodRaw : methods[0] ?? selectedMethodRaw;
   const initialCycle = isFree ? "MONTHLY" : paywall.cycles[0] ?? "MONTHLY";
-  const [cycle, setCycle] = (0, import_react5.useState)(initialCycle);
+  const [cycle, setCycle] = (0, import_react6.useState)(initialCycle);
   const cpfRequired = !isFree && paywall.requiresCpf;
-  const [cpf, setCpf] = (0, import_react5.useState)("");
-  const cpfValid = (0, import_react5.useMemo)(() => /^[0-9]{11}$/.test(cpf), [cpf]);
-  const [card, setCardState] = (0, import_react5.useState)({
+  const [cpf, setCpf] = (0, import_react6.useState)("");
+  const cpfValid = (0, import_react6.useMemo)(() => /^[0-9]{11}$/.test(cpf), [cpf]);
+  const [card, setCardState] = (0, import_react6.useState)({
     number: "",
     cvv: "",
     expiry: "",
     holder: ""
   });
-  const setCard = (0, import_react5.useCallback)((patch) => {
+  const setCard = (0, import_react6.useCallback)((patch) => {
     setCardState((prev) => ({ ...prev, ...patch }));
   }, []);
-  const [error, setError] = (0, import_react5.useState)(null);
-  const [submitting, setSubmitting] = (0, import_react5.useState)(false);
+  const [error, setError] = (0, import_react6.useState)(null);
+  const [submitting, setSubmitting] = (0, import_react6.useState)(false);
   const status = subscription.status();
   const daysLeftInTrial = subscription.daysLeftInTrial();
   const initialLoadComplete = subscription.initialLoadComplete;
-  const pixPending = (0, import_react5.useMemo)(() => {
+  const pixPending = (0, import_react6.useMemo)(() => {
     const sdkPix = subscription.pixPending;
     if (!sdkPix) return null;
     const liveStatus = subscription.current?.status;
@@ -336,7 +366,7 @@ function usePaywallState() {
       paid
     };
   }, [subscription.pixPending, subscription.current]);
-  const monthlyEquivalent = (0, import_react5.useCallback)(
+  const monthlyEquivalent = (0, import_react6.useCallback)(
     (c) => {
       const monthlyCents = plan.data?.priceCents ?? (isFree ? 0 : paywall.prices.monthlyCents);
       const yearlyCents = plan.data?.yearlyPriceCents ?? (isFree ? null : paywall.prices.yearlyCents);
@@ -345,7 +375,7 @@ function usePaywallState() {
     },
     [plan, paywall, isFree]
   );
-  const planDerived = (0, import_react5.useMemo)(() => {
+  const planDerived = (0, import_react6.useMemo)(() => {
     if (isFree) return null;
     const monthlyCents = paywall.prices.monthlyCents;
     const yearlyCents = paywall.prices.yearlyCents;
@@ -361,7 +391,7 @@ function usePaywallState() {
     };
   }, [paywall, cycle, isFree]);
   const useDefaultMessages = paywall.mode !== "free" && paywall.errorMessages === "default";
-  const buildError = (0, import_react5.useCallback)(
+  const buildError = (0, import_react6.useCallback)(
     (code, fallbackMessage) => ({
       code,
       message: fallbackMessage,
@@ -369,7 +399,7 @@ function usePaywallState() {
     }),
     [useDefaultMessages]
   );
-  const submit = (0, import_react5.useCallback)(async () => {
+  const submit = (0, import_react6.useCallback)(async () => {
     setSubmitting(true);
     setError(null);
     const methodToUse = selectedMethod;
@@ -431,7 +461,7 @@ function usePaywallState() {
       return void 0;
     }
   }, [selectedMethod, availability, subscription, cycle, cpf, card, buildError]);
-  const checkout = (0, import_react5.useCallback)(
+  const checkout = (0, import_react6.useCallback)(
     async (args) => {
       setSubmitting(true);
       setError(null);
@@ -495,7 +525,7 @@ function usePaywallState() {
     },
     [subscription, buildError]
   );
-  const cancel = (0, import_react5.useCallback)(async () => {
+  const cancel = (0, import_react6.useCallback)(async () => {
     try {
       await subscription.cancel();
       await subscription.refresh();
@@ -505,14 +535,24 @@ function usePaywallState() {
       setError(buildError(code, message));
     }
   }, [subscription, buildError]);
-  const cardState = (0, import_react5.useMemo)(
+  const cardState = (0, import_react6.useMemo)(
     () => ({ ...card, set: setCard }),
     [card, setCard]
   );
-  const cpfState = (0, import_react5.useMemo)(
+  const cpfState = (0, import_react6.useMemo)(
     () => ({ 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,
@@ -567,10 +607,10 @@ function SubscriptionGate({ Paywall, children }) {
 }
 
 // src/components/InstallGate/InstallGate.tsx
-var import_react8 = require("react");
+var import_react9 = require("react");
 
 // src/hooks/useInstallPrompt.ts
-var import_react6 = require("react");
+var import_react7 = require("react");
 var ANDROID_PROMPT_WAIT_MS = 3e3;
 var IOS_RE = /iPad|iPhone|iPod/;
 var IOS_NON_SAFARI_RE = /CriOS|FxiOS|EdgiOS/;
@@ -705,27 +745,27 @@ function useInstallPrompt(slug) {
   const iosBrowser = detectIOSBrowser(ua);
   const androidBrowser = detectAndroidBrowser(ua);
   const inAppApp = detectInAppApp(ua);
-  const [isInstallable, setIsInstallable] = (0, import_react6.useState)(() => {
+  const [isInstallable, setIsInstallable] = (0, import_react7.useState)(() => {
     if (typeof window === "undefined") return false;
     return window.__pwaInstallPrompt != null;
   });
-  const [isInstalled, setIsInstalled] = (0, import_react6.useState)(() => {
+  const [isInstalled, setIsInstalled] = (0, import_react7.useState)(() => {
     const { installed } = detectStandalone();
     return installed || readInstalledMarker(slug);
   });
-  const [isDismissedSession, setIsDismissedSession] = (0, import_react6.useState)(() => readSessionSkip(slug));
-  const [isDismissedPermanent, setIsDismissedPermanent] = (0, import_react6.useState)(() => readPermanentDismiss(slug).dismissed);
-  const [skipCount, setSkipCount] = (0, import_react6.useState)(() => readSkipCount(slug));
-  const [promptWaitElapsed, setPromptWaitElapsed] = (0, import_react6.useState)(() => {
+  const [isDismissedSession, setIsDismissedSession] = (0, import_react7.useState)(() => readSessionSkip(slug));
+  const [isDismissedPermanent, setIsDismissedPermanent] = (0, import_react7.useState)(() => readPermanentDismiss(slug).dismissed);
+  const [skipCount, setSkipCount] = (0, import_react7.useState)(() => readSkipCount(slug));
+  const [promptWaitElapsed, setPromptWaitElapsed] = (0, import_react7.useState)(() => {
     if (typeof window === "undefined") return true;
     return window.__pwaInstallPrompt != null;
   });
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (promptWaitElapsed) return;
     const id = setTimeout(() => setPromptWaitElapsed(true), ANDROID_PROMPT_WAIT_MS);
     return () => clearTimeout(id);
   }, [promptWaitElapsed]);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (typeof window === "undefined") return;
     if (window.__pwaInstallPrompt) {
       setIsInstallable(true);
@@ -749,7 +789,7 @@ function useInstallPrompt(slug) {
       window.removeEventListener("appinstalled", onInstalled);
     };
   }, [slug]);
-  (0, import_react6.useEffect)(() => {
+  (0, import_react7.useEffect)(() => {
     if (typeof window === "undefined") return;
     const mq = window.matchMedia?.("(display-mode: standalone)");
     if (!mq) return;
@@ -776,7 +816,7 @@ function useInstallPrompt(slug) {
     },
     promptWaitElapsed
   );
-  const promptInstall = (0, import_react6.useCallback)(async () => {
+  const promptInstall = (0, import_react7.useCallback)(async () => {
     if (typeof window === "undefined") return false;
     const prompt = window.__pwaInstallPrompt;
     if (!prompt) return false;
@@ -798,7 +838,7 @@ function useInstallPrompt(slug) {
       return false;
     }
   }, [slug]);
-  const dismissSession = (0, import_react6.useCallback)(() => {
+  const dismissSession = (0, import_react7.useCallback)(() => {
     if (typeof sessionStorage !== "undefined") {
       try {
         sessionStorage.setItem(storageKey.sessionSkip(slug), "true");
@@ -812,20 +852,20 @@ function useInstallPrompt(slug) {
     setIsDismissedSession(true);
     track("pwa_install_session_skip", { slug, platform, skip_count: newCount });
   }, [slug, skipCount, platform]);
-  const dismissPermanent = (0, import_react6.useCallback)(() => {
+  const dismissPermanent = (0, import_react7.useCallback)(() => {
     const storage = safeStorage();
     if (storage) storage.setItem(storageKey.dismissedAt(slug), (/* @__PURE__ */ new Date()).toISOString());
     setIsDismissedPermanent(true);
     track("pwa_install_permanent_dismiss", { slug, platform, prior_skip_count: skipCount });
   }, [slug, platform, skipCount]);
-  const copyLink = (0, import_react6.useCallback)(async () => {
+  const copyLink = (0, import_react7.useCallback)(async () => {
     if (typeof navigator === "undefined" || typeof location === "undefined") return;
     try {
       await navigator.clipboard?.writeText?.(location.href);
     } catch {
     }
   }, []);
-  const reset = (0, import_react6.useCallback)(() => {
+  const reset = (0, import_react7.useCallback)(() => {
     const storage = safeStorage();
     if (storage) {
       storage.removeItem(storageKey.dismissedAt(slug));
@@ -1618,7 +1658,7 @@ function IOSOtherVariant({
 }
 
 // src/components/InstallGate/variants/InAppBrowserVariant.tsx
-var import_react7 = require("react");
+var import_react8 = require("react");
 var import_jsx_runtime14 = require("react/jsx-runtime");
 function InAppBrowserVariant({
   state,
@@ -1628,7 +1668,7 @@ function InAppBrowserVariant({
   const appCopy = INSTALL_COPY.inApp[app] ?? INSTALL_COPY.inApp.other;
   const copy = INSTALL_COPY.inApp;
   const showPermanent = shouldShowPermanentOption(state);
-  const [copied, setCopied] = (0, import_react7.useState)(false);
+  const [copied, setCopied] = (0, import_react8.useState)(false);
   const handleCopy = async () => {
     await actions.copyLink();
     setCopied(true);
@@ -1833,8 +1873,8 @@ function InstallGate({ children }) {
   const enabled = features_enabled.includes("install_prompt");
   const installState = useInstallPrompt(slug);
   const shouldBlock = enabled && shouldBlockInstall(installState);
-  const trackedRef = (0, import_react8.useRef)(null);
-  (0, import_react8.useEffect)(() => {
+  const trackedRef = (0, import_react9.useRef)(null);
+  (0, import_react9.useEffect)(() => {
     if (!shouldBlock) return;
     if (typeof window === "undefined") return;
     const variantKey = `${slug}:${installState.variant}`;
@@ -1883,16 +1923,16 @@ function PushPrompt() {
 }
 
 // src/internal/SessionExpiredBanner.tsx
-var import_react9 = require("react");
-var import_sdk3 = require("@hook-sdk/sdk");
+var import_react10 = require("react");
+var import_sdk4 = require("@hook-sdk/sdk");
 var import_jsx_runtime17 = require("react/jsx-runtime");
 var DISMISS_KEY = "hook:session-expired-dismissed-until";
 var DISMISS_TTL_MS = 60 * 60 * 1e3;
 function SessionExpiredBanner() {
-  const { authStatus } = (0, import_sdk3.useHook)();
-  const wasAuthRef = (0, import_react9.useRef)(false);
-  const [show, setShow] = (0, import_react9.useState)(false);
-  (0, import_react9.useEffect)(() => {
+  const { authStatus } = (0, import_sdk4.useHook)();
+  const wasAuthRef = (0, import_react10.useRef)(false);
+  const [show, setShow] = (0, import_react10.useState)(false);
+  (0, import_react10.useEffect)(() => {
     if (authStatus === "authenticated") {
       wasAuthRef.current = true;
       setShow(false);
@@ -1942,9 +1982,9 @@ function SessionExpiredBanner() {
 }
 
 // src/defaults/ErrorBoundary.tsx
-var import_react10 = require("react");
+var import_react11 = require("react");
 var import_jsx_runtime18 = require("react/jsx-runtime");
-var ErrorBoundary = class extends import_react10.Component {
+var ErrorBoundary = class extends import_react11.Component {
   state = { error: null };
   static getDerivedStateFromError(error) {
     return { error };
@@ -1971,20 +2011,20 @@ var ErrorBoundary = class extends import_react10.Component {
 };
 
 // src/internal/PaymentReturnHandler.tsx
-var import_react11 = require("react");
-var import_sdk4 = require("@hook-sdk/sdk");
+var import_react12 = require("react");
+var import_sdk5 = require("@hook-sdk/sdk");
 var import_jsx_runtime19 = require("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 } = (0, import_sdk4.useHook)();
-  const subRef = (0, import_react11.useRef)(subscription);
+  const { subscription } = (0, import_sdk5.useHook)();
+  const subRef = (0, import_react12.useRef)(subscription);
   subRef.current = subscription;
-  const runIdRef = (0, import_react11.useRef)(0);
-  const cyclesRef = (0, import_react11.useRef)(0);
-  const [state, setState] = (0, import_react11.useState)("idle");
-  const runPoll = (0, import_react11.useCallback)(() => {
+  const runIdRef = (0, import_react12.useRef)(0);
+  const cyclesRef = (0, import_react12.useRef)(0);
+  const [state, setState] = (0, import_react12.useState)("idle");
+  const runPoll = (0, import_react12.useCallback)(() => {
     const runId = ++runIdRef.current;
     cyclesRef.current += 1;
     setState("confirming");
@@ -2019,7 +2059,7 @@ function PaymentReturnHandler({ children }) {
     };
     void tick();
   }, []);
-  (0, import_react11.useEffect)(() => {
+  (0, import_react12.useEffect)(() => {
     if (typeof window === "undefined") return;
     const url = new URL(window.location.href);
     if (url.searchParams.get("paymentReturn") !== "1") return;
@@ -2029,7 +2069,7 @@ function PaymentReturnHandler({ children }) {
       runIdRef.current++;
     };
   }, [runPoll]);
-  const goHome = (0, import_react11.useCallback)(() => {
+  const goHome = (0, import_react12.useCallback)(() => {
     const cleanUrl = new URL(window.location.href);
     cleanUrl.searchParams.delete("paymentReturn");
     cleanUrl.pathname = "/app/home";
@@ -2195,7 +2235,7 @@ function AppRoot(props) {
       "[hook-template] <AppRoot>: PreAuthFlow slot prop is required when config.onboarding.trigger === 'pre_signup_custom'."
     );
   }
-  const legacyShim = (0, import_react12.useMemo)(() => buildLegacyConfigShim(config), [config]);
+  const legacyShim = (0, import_react13.useMemo)(() => buildLegacyConfigShim(config), [config]);
   const Router = testRouter === "memory" ? import_react_router_dom2.MemoryRouter : import_react_router_dom2.BrowserRouter;
   const basename = `/app/${config.slug}`;
   const routerProps = testRouter === "memory" ? { basename, initialEntries: testInitialEntries } : { basename };
@@ -2232,7 +2272,7 @@ function AuthGated({
   EmailVerify,
   PreAuthFlow
 }) {
-  const { authStatus } = (0, import_sdk5.useHook)();
+  const { authStatus } = (0, import_sdk6.useHook)();
   if (authStatus === "loading") return null;
   if (authStatus !== "authenticated") {
     if (config.onboarding?.trigger === "pre_signup_custom" && PreAuthFlow) {
@@ -2261,8 +2301,8 @@ function FallbackPaywall() {
 }
 
 // src/hooks/usePush.ts
-var import_react13 = require("react");
-var import_sdk6 = require("@hook-sdk/sdk");
+var import_react14 = require("react");
+var import_sdk7 = require("@hook-sdk/sdk");
 var DISMISS_STORAGE_KEY = "push:dismissed-until";
 var DISMISS_TTL_MS2 = 7 * 24 * 60 * 60 * 1e3;
 function detectIosNeedsInstall() {
@@ -2306,12 +2346,12 @@ function deriveState(push) {
   return { kind: "prompt" };
 }
 function usePush() {
-  const { push } = (0, import_sdk6.useHook)();
-  const [state, setState] = (0, import_react13.useState)(() => deriveState(push));
-  (0, import_react13.useEffect)(() => {
+  const { push } = (0, import_sdk7.useHook)();
+  const [state, setState] = (0, import_react14.useState)(() => deriveState(push));
+  (0, import_react14.useEffect)(() => {
     setState(deriveState(push));
   }, [push]);
-  const subscribe = (0, import_react13.useCallback)(async () => {
+  const subscribe = (0, import_react14.useCallback)(async () => {
     try {
       await push.subscribe();
       setState({ kind: "subscribed" });
@@ -2323,7 +2363,7 @@ function usePush() {
       throw e;
     }
   }, [push]);
-  const unsubscribe = (0, import_react13.useCallback)(async () => {
+  const unsubscribe = (0, import_react14.useCallback)(async () => {
     try {
       await push.unsubscribe();
       setState({ kind: "prompt" });
@@ -2332,7 +2372,7 @@ function usePush() {
       throw e;
     }
   }, [push]);
-  const dismiss = (0, import_react13.useCallback)(() => {
+  const dismiss = (0, import_react14.useCallback)(() => {
     if (typeof localStorage !== "undefined") {
       try {
         localStorage.setItem(DISMISS_STORAGE_KEY, String(Date.now() + DISMISS_TTL_MS2));
@@ -2424,20 +2464,20 @@ function EmptyState({ title, description, action }) {
 }
 
 // src/hooks/useLoginForm.ts
-var import_react14 = require("react");
-var import_sdk8 = require("@hook-sdk/sdk");
+var import_react15 = require("react");
+var import_sdk9 = require("@hook-sdk/sdk");
 
 // src/errors.ts
-var import_sdk7 = require("@hook-sdk/sdk");
+var import_sdk8 = require("@hook-sdk/sdk");
 function mapSdkError(err) {
-  if (err instanceof import_sdk7.SdkRateLimitError) {
+  if (err instanceof import_sdk8.SdkRateLimitError) {
     return {
       code: "rate_limited",
       message: `Aguarde ${err.retryAfter}s e tente novamente.`,
       retryAfter: err.retryAfter
     };
   }
-  if (err instanceof import_sdk7.SdkAuthError) {
+  if (err instanceof import_sdk8.SdkAuthError) {
     const detail = err.detail;
     if (detail === "email_unverified") {
       return { code: "email_unverified", message: "Confirme seu e-mail antes de entrar." };
@@ -2447,7 +2487,7 @@ function mapSdkError(err) {
     }
     return { code: "invalid_credentials", message: "E-mail ou senha inv\xE1lidos." };
   }
-  if (err instanceof import_sdk7.SdkError && err.httpStatus === 0) {
+  if (err instanceof import_sdk8.SdkError && err.httpStatus === 0) {
     return { code: "network", message: "Sem conex\xE3o com o servidor. Verifique sua internet." };
   }
   if (err instanceof TypeError) {
@@ -2460,20 +2500,20 @@ function mapSdkError(err) {
 var EMAIL_RE = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 var MIN_PASSWORD = 8;
 function useLoginForm() {
-  const { auth } = (0, import_sdk8.useHook)();
-  const [email, setEmail] = (0, import_react14.useState)("");
-  const [password, setPassword] = (0, import_react14.useState)("");
-  const [submitting, setSubmitting] = (0, import_react14.useState)(false);
-  const [error, setError] = (0, import_react14.useState)(null);
-  const [touchedEmail, setTouchedEmail] = (0, import_react14.useState)(false);
-  const [touchedPassword, setTouchedPassword] = (0, import_react14.useState)(false);
-  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react14.useState)(false);
-  const validateEmail = (0, import_react14.useMemo)(() => {
+  const { auth } = (0, import_sdk9.useHook)();
+  const [email, setEmail] = (0, import_react15.useState)("");
+  const [password, setPassword] = (0, import_react15.useState)("");
+  const [submitting, setSubmitting] = (0, import_react15.useState)(false);
+  const [error, setError] = (0, import_react15.useState)(null);
+  const [touchedEmail, setTouchedEmail] = (0, import_react15.useState)(false);
+  const [touchedPassword, setTouchedPassword] = (0, import_react15.useState)(false);
+  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react15.useState)(false);
+  const validateEmail = (0, import_react15.useMemo)(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
-  const validatePassword = (0, import_react14.useMemo)(() => {
+  const validatePassword = (0, import_react15.useMemo)(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD) return `M\xEDnimo de ${MIN_PASSWORD} caracteres.`;
     return null;
@@ -2481,7 +2521,7 @@ function useLoginForm() {
   const emailError = touchedEmail || formSubmitAttempted ? validateEmail : null;
   const passwordError = touchedPassword || formSubmitAttempted ? validatePassword : null;
   const canSubmit = email.length > 0 && password.length >= MIN_PASSWORD && validateEmail === null && validatePassword === null && !submitting;
-  const submit = (0, import_react14.useCallback)(async () => {
+  const submit = (0, import_react15.useCallback)(async () => {
     setFormSubmitAttempted(true);
     if (!canSubmit) return false;
     setSubmitting(true);
@@ -2515,32 +2555,32 @@ function useLoginForm() {
 }
 
 // src/hooks/useSignupForm.ts
-var import_react15 = require("react");
-var import_sdk9 = require("@hook-sdk/sdk");
+var import_react16 = require("react");
+var import_sdk10 = require("@hook-sdk/sdk");
 var EMAIL_RE2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 var MIN_PASSWORD2 = 8;
 function useSignupForm() {
-  const { auth } = (0, import_sdk9.useHook)();
-  const [name, setName] = (0, import_react15.useState)("");
-  const [email, setEmail] = (0, import_react15.useState)("");
-  const [password, setPassword] = (0, import_react15.useState)("");
-  const [submitting, setSubmitting] = (0, import_react15.useState)(false);
-  const [error, setError] = (0, import_react15.useState)(null);
-  const [touchedName, setTouchedName] = (0, import_react15.useState)(false);
-  const [touchedEmail, setTouchedEmail] = (0, import_react15.useState)(false);
-  const [touchedPassword, setTouchedPassword] = (0, import_react15.useState)(false);
-  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react15.useState)(false);
-  const validateName = (0, import_react15.useMemo)(() => {
+  const { auth } = (0, import_sdk10.useHook)();
+  const [name, setName] = (0, import_react16.useState)("");
+  const [email, setEmail] = (0, import_react16.useState)("");
+  const [password, setPassword] = (0, import_react16.useState)("");
+  const [submitting, setSubmitting] = (0, import_react16.useState)(false);
+  const [error, setError] = (0, import_react16.useState)(null);
+  const [touchedName, setTouchedName] = (0, import_react16.useState)(false);
+  const [touchedEmail, setTouchedEmail] = (0, import_react16.useState)(false);
+  const [touchedPassword, setTouchedPassword] = (0, import_react16.useState)(false);
+  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react16.useState)(false);
+  const validateName = (0, import_react16.useMemo)(() => {
     if (name.length === 0) return null;
     if (name.trim().length < 2) return "Nome muito curto.";
     return null;
   }, [name]);
-  const validateEmail = (0, import_react15.useMemo)(() => {
+  const validateEmail = (0, import_react16.useMemo)(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE2.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
-  const validatePassword = (0, import_react15.useMemo)(() => {
+  const validatePassword = (0, import_react16.useMemo)(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD2) return `M\xEDnimo de ${MIN_PASSWORD2} caracteres.`;
     return null;
@@ -2549,7 +2589,7 @@ function useSignupForm() {
   const emailError = touchedEmail || formSubmitAttempted ? validateEmail : null;
   const passwordError = touchedPassword || formSubmitAttempted ? validatePassword : null;
   const canSubmit = name.trim().length >= 2 && email.length > 0 && password.length >= MIN_PASSWORD2 && validateName === null && validateEmail === null && validatePassword === null && !submitting;
-  const submit = (0, import_react15.useCallback)(async () => {
+  const submit = (0, import_react16.useCallback)(async () => {
     setFormSubmitAttempted(true);
     if (!canSubmit) return false;
     setSubmitting(true);
@@ -2587,25 +2627,25 @@ function useSignupForm() {
 }
 
 // src/hooks/useForgotForm.ts
-var import_react16 = require("react");
-var import_sdk10 = require("@hook-sdk/sdk");
+var import_react17 = require("react");
+var import_sdk11 = require("@hook-sdk/sdk");
 var EMAIL_RE3 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function useForgotForm() {
-  const { auth } = (0, import_sdk10.useHook)();
-  const [email, setEmail] = (0, import_react16.useState)("");
-  const [submitting, setSubmitting] = (0, import_react16.useState)(false);
-  const [sent, setSent] = (0, import_react16.useState)(false);
-  const [error, setError] = (0, import_react16.useState)(null);
-  const [touchedEmail, setTouchedEmail] = (0, import_react16.useState)(false);
-  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react16.useState)(false);
-  const validateEmail = (0, import_react16.useMemo)(() => {
+  const { auth } = (0, import_sdk11.useHook)();
+  const [email, setEmail] = (0, import_react17.useState)("");
+  const [submitting, setSubmitting] = (0, import_react17.useState)(false);
+  const [sent, setSent] = (0, import_react17.useState)(false);
+  const [error, setError] = (0, import_react17.useState)(null);
+  const [touchedEmail, setTouchedEmail] = (0, import_react17.useState)(false);
+  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react17.useState)(false);
+  const validateEmail = (0, import_react17.useMemo)(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE3.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
   const emailError = touchedEmail || formSubmitAttempted ? validateEmail : null;
   const canSubmit = email.length > 0 && validateEmail === null && !submitting;
-  const submit = (0, import_react16.useCallback)(async () => {
+  const submit = (0, import_react17.useCallback)(async () => {
     setFormSubmitAttempted(true);
     if (!canSubmit) return false;
     setSubmitting(true);
@@ -2636,32 +2676,32 @@ function useForgotForm() {
 }
 
 // src/hooks/useResetForm.ts
-var import_react17 = require("react");
-var import_sdk11 = require("@hook-sdk/sdk");
+var import_react18 = require("react");
+var import_sdk12 = require("@hook-sdk/sdk");
 var MIN_PASSWORD3 = 12;
 function useResetForm() {
-  const { auth } = (0, import_sdk11.useHook)();
-  const [token, setToken] = (0, import_react17.useState)(null);
-  const [password, setPassword] = (0, import_react17.useState)("");
-  const [confirm, setConfirm] = (0, import_react17.useState)("");
-  const [submitting, setSubmitting] = (0, import_react17.useState)(false);
-  const [done, setDone] = (0, import_react17.useState)(false);
-  const [error, setError] = (0, import_react17.useState)(null);
-  const [touchedPassword, setTouchedPassword] = (0, import_react17.useState)(false);
-  const [touchedConfirm, setTouchedConfirm] = (0, import_react17.useState)(false);
-  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react17.useState)(false);
-  (0, import_react17.useEffect)(() => {
+  const { auth } = (0, import_sdk12.useHook)();
+  const [token, setToken] = (0, import_react18.useState)(null);
+  const [password, setPassword] = (0, import_react18.useState)("");
+  const [confirm, setConfirm] = (0, import_react18.useState)("");
+  const [submitting, setSubmitting] = (0, import_react18.useState)(false);
+  const [done, setDone] = (0, import_react18.useState)(false);
+  const [error, setError] = (0, import_react18.useState)(null);
+  const [touchedPassword, setTouchedPassword] = (0, import_react18.useState)(false);
+  const [touchedConfirm, setTouchedConfirm] = (0, import_react18.useState)(false);
+  const [formSubmitAttempted, setFormSubmitAttempted] = (0, import_react18.useState)(false);
+  (0, import_react18.useEffect)(() => {
     if (typeof window === "undefined") return;
     const params = new URLSearchParams(window.location.search);
     const t = params.get("token");
     setToken(t && t.length > 0 ? t : null);
   }, []);
-  const validatePassword = (0, import_react17.useMemo)(() => {
+  const validatePassword = (0, import_react18.useMemo)(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD3) return `M\xEDnimo de ${MIN_PASSWORD3} caracteres.`;
     return null;
   }, [password]);
-  const validateConfirm = (0, import_react17.useMemo)(() => {
+  const validateConfirm = (0, import_react18.useMemo)(() => {
     if (confirm.length === 0) return null;
     if (confirm !== password) return "Senhas n\xE3o coincidem.";
     return null;
@@ -2669,7 +2709,7 @@ function useResetForm() {
   const passwordError = touchedPassword || formSubmitAttempted ? validatePassword : null;
   const confirmError = touchedConfirm || formSubmitAttempted ? validateConfirm : null;
   const canSubmit = token !== null && password.length >= MIN_PASSWORD3 && confirm === password && validatePassword === null && validateConfirm === null && !submitting && !done;
-  const submit = (0, import_react17.useCallback)(async () => {
+  const submit = (0, import_react18.useCallback)(async () => {
     setFormSubmitAttempted(true);
     if (!canSubmit || token === null) return;
     setSubmitting(true);
@@ -2709,9 +2749,9 @@ function useResetForm() {
 }
 
 // src/hooks/usePlan.ts
-var import_sdk12 = require("@hook-sdk/sdk");
+var import_sdk13 = require("@hook-sdk/sdk");
 function usePlan() {
-  const { plan } = (0, import_sdk12.useHook)();
+  const { plan } = (0, import_sdk13.useHook)();
   return plan;
 }
 
@@ -2744,12 +2784,12 @@ function discountPercent(anchorCents, realCents) {
 }
 
 // src/hooks/useAuthPrimitives.ts
-var import_react18 = require("react");
-var import_sdk13 = require("@hook-sdk/sdk");
+var import_react19 = require("react");
+var import_sdk14 = require("@hook-sdk/sdk");
 var warned = false;
 function useAuthPrimitives() {
-  const { auth } = (0, import_sdk13.useHook)();
-  (0, import_react18.useEffect)(() => {
+  const { auth } = (0, import_sdk14.useHook)();
+  (0, import_react19.useEffect)(() => {
     if (!warned && process.env.NODE_ENV !== "production") {
       warned = true;
       console.warn(
@@ -2771,9 +2811,9 @@ function useAuthPrimitives() {
 }
 
 // src/hooks/useAuth.ts
-var import_sdk14 = require("@hook-sdk/sdk");
+var import_sdk15 = require("@hook-sdk/sdk");
 function useAuth() {
-  const { user, authStatus, auth } = (0, import_sdk14.useHook)();
+  const { user, authStatus, auth } = (0, import_sdk15.useHook)();
   return {
     user,
     authStatus,
@@ -2781,24 +2821,27 @@ function useAuth() {
   };
 }
 
+// src/index.ts
+var import_sdk19 = require("@hook-sdk/sdk");
+
 // src/hooks/useSubscription.ts
-var import_sdk15 = require("@hook-sdk/sdk");
+var import_sdk16 = require("@hook-sdk/sdk");
 function useSubscription() {
-  const { subscription } = (0, import_sdk15.useHook)();
+  const { subscription } = (0, import_sdk16.useHook)();
   return {
     status: subscription.status()
   };
 }
 
 // src/hooks/useReminders.ts
-var import_react19 = require("react");
-var import_sdk16 = require("@hook-sdk/sdk");
+var import_react20 = require("react");
+var import_sdk17 = require("@hook-sdk/sdk");
 function useReminders() {
-  const { push } = (0, import_sdk16.useHook)();
+  const { push } = (0, import_sdk17.useHook)();
   const r = push.reminders;
-  const [reminders, setReminders] = (0, import_react19.useState)([]);
-  const [loading, setLoading] = (0, import_react19.useState)(true);
-  const reload = (0, import_react19.useCallback)(async () => {
+  const [reminders, setReminders] = (0, import_react20.useState)([]);
+  const [loading, setLoading] = (0, import_react20.useState)(true);
+  const reload = (0, import_react20.useCallback)(async () => {
     setLoading(true);
     try {
       const next = await r.list();
@@ -2807,38 +2850,38 @@ function useReminders() {
       setLoading(false);
     }
   }, [r]);
-  (0, import_react19.useEffect)(() => {
+  (0, import_react20.useEffect)(() => {
     void reload();
   }, [reload]);
-  const setReminder = (0, import_react19.useCallback)(async (input) => {
+  const setReminder = (0, import_react20.useCallback)(async (input) => {
     await r.set(input);
     await reload();
   }, [r, reload]);
-  const deleteReminder = (0, import_react19.useCallback)(async (slot) => {
+  const deleteReminder = (0, import_react20.useCallback)(async (slot) => {
     await r.delete(slot);
     await reload();
   }, [r, reload]);
-  const schedule = (0, import_react19.useCallback)(async (items) => {
+  const schedule = (0, import_react20.useCallback)(async (items) => {
     return r.schedule(items);
   }, [r]);
-  const setFallbacks = (0, import_react19.useCallback)(async (items) => {
+  const setFallbacks = (0, import_react20.useCallback)(async (items) => {
     return r.setFallbacks(items);
   }, [r]);
   return { reminders, loading, setReminder, deleteReminder, schedule, setFallbacks };
 }
 
 // src/hooks/useToast.ts
-var import_react20 = require("react");
+var import_react21 = require("react");
 function useToast() {
-  const [items, setItems] = (0, import_react20.useState)([]);
-  const show = (0, import_react20.useCallback)((message, kind = "info") => {
+  const [items, setItems] = (0, import_react21.useState)([]);
+  const show = (0, import_react21.useCallback)((message, kind = "info") => {
     const id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     setItems((prev) => [...prev, { id, message, kind }]);
     setTimeout(() => {
       setItems((prev) => prev.filter((t) => t.id !== id));
     }, 4e3);
   }, []);
-  const dismiss = (0, import_react20.useCallback)((id) => {
+  const dismiss = (0, import_react21.useCallback)((id) => {
     setItems((prev) => prev.filter((t) => t.id !== id));
   }, []);
   return { items, show, dismiss };
@@ -2873,14 +2916,14 @@ function PreAuthShell({
 }
 
 // src/OnboardingFlow.tsx
-var import_react22 = require("react");
-var import_sdk17 = require("@hook-sdk/sdk");
+var import_react23 = require("react");
+var import_sdk18 = require("@hook-sdk/sdk");
 
 // src/hooks/useOnboardingStep.ts
-var import_react21 = require("react");
-var OnboardingStepContext = (0, import_react21.createContext)(null);
+var import_react22 = require("react");
+var OnboardingStepContext = (0, import_react22.createContext)(null);
 function useOnboardingStep() {
-  const ctx = (0, import_react21.useContext)(OnboardingStepContext);
+  const ctx = (0, import_react22.useContext)(OnboardingStepContext);
   if (!ctx) {
     throw new Error(
       "[hook-template] useOnboardingStep must be used inside <OnboardingFlow>. (G75)"
@@ -2903,12 +2946,12 @@ function OnboardingFlow({
   onComplete,
   persistKey
 }) {
-  const [draft, setDraft, status] = (0, import_sdk17.usePersistedState)(persistKey, {});
-  const draftRef = (0, import_react22.useRef)(draft);
+  const [draft, setDraft, status] = (0, import_sdk18.usePersistedState)(persistKey, {});
+  const draftRef = (0, import_react23.useRef)(draft);
   draftRef.current = draft;
   const idx = readPersistedStepIdx(draft);
   const clampedIdx = Math.min(Math.max(idx, 0), Math.max(steps.length - 1, 0));
-  const setIdx = (0, import_react22.useCallback)(
+  const setIdx = (0, import_react23.useCallback)(
     (n) => {
       setDraft((prev) => {
         const prevIdx = readPersistedStepIdx(prev);
@@ -2918,7 +2961,7 @@ function OnboardingFlow({
     },
     [setDraft]
   );
-  const setValue = (0, import_react22.useCallback)(
+  const setValue = (0, import_react23.useCallback)(
     (patch) => {
       draftRef.current = { ...draftRef.current, ...patch };
       setDraft((prev) => ({ ...prev, ...patch }));
@@ -2926,11 +2969,23 @@ function OnboardingFlow({
     [setDraft]
   );
   const step = steps[clampedIdx];
-  const valid = (0, import_react22.useMemo)(
+  const hookCtx = (0, import_sdk18.useHook)();
+  const track2 = typeof hookCtx.track === "function" ? hookCtx.track : void 0;
+  (0, import_react23.useEffect)(() => {
+    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 = (0, import_react23.useMemo)(
     () => step ? (step.validates ?? []).every((field) => isFilled(draft[field])) : false,
     [draft, step]
   );
-  const next = (0, import_react22.useCallback)(() => {
+  const next = (0, import_react23.useCallback)(() => {
     if (!step) return;
     const current = draftRef.current;
     const validNow = (step.validates ?? []).every((field) => isFilled(current[field]));
@@ -2941,8 +2996,8 @@ function OnboardingFlow({
       setIdx(clampedIdx + 1);
     }
   }, [clampedIdx, onComplete, step, steps.length, setIdx]);
-  const prevStep = (0, import_react22.useCallback)(() => setIdx((i) => Math.max(0, i - 1)), [setIdx]);
-  const ctx = (0, import_react22.useMemo)(
+  const prevStep = (0, import_react23.useCallback)(() => setIdx((i) => Math.max(0, i - 1)), [setIdx]);
+  const ctx = (0, import_react23.useMemo)(
     () => ({
       stepIndex: clampedIdx,
       totalSteps: steps.length,
@@ -3022,6 +3077,7 @@ function useFeature(name) {
   useResetForm,
   useSignupForm,
   useSubscription,
-  useToast
+  useToast,
+  useTrackOnboardingStep
 });
 //# sourceMappingURL=index.cjs.map