@hook-sdk/template 0.6.0 → 0.7.1

package/dist/index.d.cts

@@ -267,14 +267,29 @@ interface UseResetFormResult {
 declare function useResetForm(): UseResetFormResult;
 
 type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'pending' | 'none';
+type PaymentMethod = 'card' | 'pix-auto' | 'pix-once';
+interface PixPending {
+    method: 'pix-auto' | 'pix-once';
+    qrCodePayload: string | null;
+    qrCodeBase64: string | null;
+    expiresAt: string | null;
+}
 /**
  * Hook headless pro Paywall. Expõe status atual da subscription + ação
- * `checkout(cpf)` que chama `POST /payments/checkout/card` e redireciona
- * o browser pro `invoiceUrl` hosted do Asaas. Após o checkout, Asaas
- * redireciona de volta com query string indicativa; subscription real
- * é atualizada via webhook (`PAYMENT_RECEIVED` / `SUBSCRIPTION_ACTIVATED`).
+ * `checkout({cpf, cycle, method})` com 3 métodos:
+ *
+ * - **card** (default): cria subscription Asaas recorrente, redireciona pro
+ *   invoiceUrl hosted. Após pagar, Asaas redireciona de volta e webhook
+ *   atualiza DB.
+ * - **pix-auto**: Pix Automático Jornada 3 BACEN. User escaneia QR 1x no app
+ *   do banco, autoriza débito recorrente. Retorna QR via `pixPending`
+ *   (hook fica populado até user confirmar no banco).
+ * - **pix-once**: Pix avulso. User paga QR único, ganha 1 ciclo. Sem
+ *   recorrência automática — renova voltando no app. Retorna QR via
+ *   `pixPending`.
  *
- * MVP: checkout só cartão. Pix vem depois (gatilho documentado em P10.7).
+ * Subscription real é atualizada via webhook (`PAYMENT_RECEIVED` ou
+ * `PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED`).
  */
 declare function usePaywallState(): {
     status: SubscriptionStatus;
@@ -283,10 +298,13 @@ declare function usePaywallState(): {
     checkout: (args: {
         cpf: string;
         cycle?: "MONTHLY" | "YEARLY";
+        method?: PaymentMethod;
     }) => Promise<void>;
     cancel: () => Promise<void>;
     opening: boolean;
     error: Error | null;
+    pixPending: PixPending | null;
+    dismissPix: () => void;
 };
 
 /**
@@ -348,6 +366,37 @@ declare function monthlyFromYearly(yearlyCents: number | null | undefined): numb
  *   dailyFromYearly(23988) = 66 → formatBRL = "R$ 0,66"
  */
 declare function dailyFromYearly(yearlyCents: number | null | undefined): number;
+/**
+ * Deriva o preço-ancoragem (valor "cheio" riscado) como múltiplo do preço
+ * real. Serve pra ancoragem psicológica em telas de paywall: mostra um valor
+ * maior riscado antes do preço real pra o usuário sentir desconto.
+ *
+ * Com `anchorMultiplier` no `paywall_config`, o creator mantém só o preço
+ * real no DB; a ancoragem acompanha automaticamente se o preço muda.
+ *
+ * Retorna `null` quando o multiplier não é utilizável (falta, ≤ 1, NaN,
+ * Infinity). Caller deve cair no fallback (valor absoluto em
+ * `paywall_config.anchorPriceCents`) ou pular a renderização da ancoragem.
+ *
+ * Examples:
+ *   computeAnchorCents(1999, 2.5)        = 4998
+ *   computeAnchorCents(1999, undefined)  = null
+ *   computeAnchorCents(1999, 1)          = null  // 1× não ancora nada
+ *   computeAnchorCents(1999, 0)          = null
+ *   computeAnchorCents(1999, NaN)        = null
+ */
+declare function computeAnchorCents(baseCents: number, multiplier: number | null | undefined): number | null;
+/**
+ * Percentual de desconto (anchor → real), arredondado pra baixo pra nunca
+ * overstate. Retorna 0 quando anchor ≤ real (sem desconto a mostrar).
+ *
+ * Examples:
+ *   discountPercent(4998, 1999) = 60   // (4998-1999)/4998 = 0.60...
+ *   discountPercent(3998, 1999) = 50
+ *   discountPercent(1000, 2000) = 0    // real > anchor
+ *   discountPercent(2000, 2000) = 0
+ */
+declare function discountPercent(anchorCents: number, realCents: number): number;
 
 /**
  * Escape hatch pra screens FORA do fluxo de auth (ex: settings/trocar-senha).
@@ -554,4 +603,4 @@ declare function shouldBlockInstall(state: InstallState, now?: number): boolean;
  */
 declare function shouldShowPermanentOption(state: InstallState): boolean;
 
-export { type AndroidBrowser, AppRoot, type AppRootProps, type AuthFormError, type AuthFormErrorCode, type AuthScreen, type AuthScreenProps, DefaultForgotScreen, DefaultLoginScreen, DefaultPaywall, DefaultResetScreen, DefaultSignupScreen, EmptyState, ErrorBoundary, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LoadingState, type Platform, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, formatBRL, monthlyFromYearly, shouldBlockInstall, shouldShowPermanentOption, useAuth, useAuthPrimitives, useForgotForm, useInstallPrompt, useLoginForm, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };
+export { type AndroidBrowser, AppRoot, type AppRootProps, type AuthFormError, type AuthFormErrorCode, type AuthScreen, type AuthScreenProps, DefaultForgotScreen, DefaultLoginScreen, DefaultPaywall, DefaultResetScreen, DefaultSignupScreen, EmptyState, ErrorBoundary, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LoadingState, type PaymentMethod, type PixPending, type Platform, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, monthlyFromYearly, shouldBlockInstall, shouldShowPermanentOption, useAuth, useAuthPrimitives, useForgotForm, useInstallPrompt, useLoginForm, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };

package/dist/index.d.ts

@@ -267,14 +267,29 @@ interface UseResetFormResult {
 declare function useResetForm(): UseResetFormResult;
 
 type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'pending' | 'none';
+type PaymentMethod = 'card' | 'pix-auto' | 'pix-once';
+interface PixPending {
+    method: 'pix-auto' | 'pix-once';
+    qrCodePayload: string | null;
+    qrCodeBase64: string | null;
+    expiresAt: string | null;
+}
 /**
  * Hook headless pro Paywall. Expõe status atual da subscription + ação
- * `checkout(cpf)` que chama `POST /payments/checkout/card` e redireciona
- * o browser pro `invoiceUrl` hosted do Asaas. Após o checkout, Asaas
- * redireciona de volta com query string indicativa; subscription real
- * é atualizada via webhook (`PAYMENT_RECEIVED` / `SUBSCRIPTION_ACTIVATED`).
+ * `checkout({cpf, cycle, method})` com 3 métodos:
+ *
+ * - **card** (default): cria subscription Asaas recorrente, redireciona pro
+ *   invoiceUrl hosted. Após pagar, Asaas redireciona de volta e webhook
+ *   atualiza DB.
+ * - **pix-auto**: Pix Automático Jornada 3 BACEN. User escaneia QR 1x no app
+ *   do banco, autoriza débito recorrente. Retorna QR via `pixPending`
+ *   (hook fica populado até user confirmar no banco).
+ * - **pix-once**: Pix avulso. User paga QR único, ganha 1 ciclo. Sem
+ *   recorrência automática — renova voltando no app. Retorna QR via
+ *   `pixPending`.
  *
- * MVP: checkout só cartão. Pix vem depois (gatilho documentado em P10.7).
+ * Subscription real é atualizada via webhook (`PAYMENT_RECEIVED` ou
+ * `PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED`).
  */
 declare function usePaywallState(): {
     status: SubscriptionStatus;
@@ -283,10 +298,13 @@ declare function usePaywallState(): {
     checkout: (args: {
         cpf: string;
         cycle?: "MONTHLY" | "YEARLY";
+        method?: PaymentMethod;
     }) => Promise<void>;
     cancel: () => Promise<void>;
     opening: boolean;
     error: Error | null;
+    pixPending: PixPending | null;
+    dismissPix: () => void;
 };
 
 /**
@@ -348,6 +366,37 @@ declare function monthlyFromYearly(yearlyCents: number | null | undefined): numb
  *   dailyFromYearly(23988) = 66 → formatBRL = "R$ 0,66"
  */
 declare function dailyFromYearly(yearlyCents: number | null | undefined): number;
+/**
+ * Deriva o preço-ancoragem (valor "cheio" riscado) como múltiplo do preço
+ * real. Serve pra ancoragem psicológica em telas de paywall: mostra um valor
+ * maior riscado antes do preço real pra o usuário sentir desconto.
+ *
+ * Com `anchorMultiplier` no `paywall_config`, o creator mantém só o preço
+ * real no DB; a ancoragem acompanha automaticamente se o preço muda.
+ *
+ * Retorna `null` quando o multiplier não é utilizável (falta, ≤ 1, NaN,
+ * Infinity). Caller deve cair no fallback (valor absoluto em
+ * `paywall_config.anchorPriceCents`) ou pular a renderização da ancoragem.
+ *
+ * Examples:
+ *   computeAnchorCents(1999, 2.5)        = 4998
+ *   computeAnchorCents(1999, undefined)  = null
+ *   computeAnchorCents(1999, 1)          = null  // 1× não ancora nada
+ *   computeAnchorCents(1999, 0)          = null
+ *   computeAnchorCents(1999, NaN)        = null
+ */
+declare function computeAnchorCents(baseCents: number, multiplier: number | null | undefined): number | null;
+/**
+ * Percentual de desconto (anchor → real), arredondado pra baixo pra nunca
+ * overstate. Retorna 0 quando anchor ≤ real (sem desconto a mostrar).
+ *
+ * Examples:
+ *   discountPercent(4998, 1999) = 60   // (4998-1999)/4998 = 0.60...
+ *   discountPercent(3998, 1999) = 50
+ *   discountPercent(1000, 2000) = 0    // real > anchor
+ *   discountPercent(2000, 2000) = 0
+ */
+declare function discountPercent(anchorCents: number, realCents: number): number;
 
 /**
  * Escape hatch pra screens FORA do fluxo de auth (ex: settings/trocar-senha).
@@ -554,4 +603,4 @@ declare function shouldBlockInstall(state: InstallState, now?: number): boolean;
  */
 declare function shouldShowPermanentOption(state: InstallState): boolean;
 
-export { type AndroidBrowser, AppRoot, type AppRootProps, type AuthFormError, type AuthFormErrorCode, type AuthScreen, type AuthScreenProps, DefaultForgotScreen, DefaultLoginScreen, DefaultPaywall, DefaultResetScreen, DefaultSignupScreen, EmptyState, ErrorBoundary, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LoadingState, type Platform, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, formatBRL, monthlyFromYearly, shouldBlockInstall, shouldShowPermanentOption, useAuth, useAuthPrimitives, useForgotForm, useInstallPrompt, useLoginForm, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };
+export { type AndroidBrowser, AppRoot, type AppRootProps, type AuthFormError, type AuthFormErrorCode, type AuthScreen, type AuthScreenProps, DefaultForgotScreen, DefaultLoginScreen, DefaultPaywall, DefaultResetScreen, DefaultSignupScreen, EmptyState, ErrorBoundary, type IOSBrowser, type InAppApp, type InstallActions, InstallGate, InstallSplash, type InstallState, type InstallVariant, LoadingState, type PaymentMethod, type PixPending, type Platform, PushPrompt, type PushPromptProps, type PushPromptTexts, type PushUiState, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, computeAnchorCents, dailyFromYearly, detectAndroidBrowser, detectIOSBrowser, detectInAppApp, detectPlatform, detectStandalone, discountPercent, formatBRL, monthlyFromYearly, shouldBlockInstall, shouldShowPermanentOption, useAuth, useAuthPrimitives, useForgotForm, useInstallPrompt, useLoginForm, usePaywallState, usePlan, usePush, useReminders, useResetForm, useSignupForm, useSubscription, useToast };

package/dist/index.js

@@ -98,6 +98,7 @@ function usePaywallState() {
   const { subscription } = useHook2();
   const [opening, setOpening] = useState2(false);
   const [error, setError] = useState2(null);
+  const [pixPending, setPixPending] = useState2(null);
   const status = subscription.status();
   const daysLeftInTrial = subscription.daysLeftInTrial();
   const initialLoadComplete = subscription.initialLoadComplete;
@@ -105,12 +106,37 @@ function usePaywallState() {
     async (args) => {
       setOpening(true);
       setError(null);
+      setPixPending(null);
+      const method = args.method ?? "card";
+      const cycle = args.cycle ?? "MONTHLY";
       try {
-        const result = await subscription.checkoutCard({
-          cpf: args.cpf,
-          cycle: args.cycle ?? "MONTHLY"
-        });
-        window.location.href = result.invoiceUrl;
+        if (method === "card") {
+          const result = await subscription.checkoutCard({ cpf: args.cpf, cycle });
+          window.location.href = result.invoiceUrl;
+          return;
+        }
+        if (method === "pix-auto") {
+          const result = await subscription.checkoutPixAuto({ cpf: args.cpf, cycle });
+          setPixPending({
+            method: "pix-auto",
+            qrCodePayload: result.qrCodePayload,
+            qrCodeBase64: result.qrCodeBase64,
+            expiresAt: null
+          });
+          setOpening(false);
+          return;
+        }
+        if (method === "pix-once") {
+          const result = await subscription.checkoutPixOnce({ cpf: args.cpf, cycle });
+          setPixPending({
+            method: "pix-once",
+            qrCodePayload: result.qrCodePayload,
+            qrCodeBase64: result.qrCodeBase64,
+            expiresAt: result.expiresAt
+          });
+          setOpening(false);
+          return;
+        }
       } catch (err) {
         setError(err);
         setOpening(false);
@@ -126,7 +152,18 @@ function usePaywallState() {
       setError(err);
     }
   }, [subscription]);
-  return { status, daysLeftInTrial, initialLoadComplete, checkout, cancel, opening, error };
+  const dismissPix = useCallback(() => setPixPending(null), []);
+  return {
+    status,
+    daysLeftInTrial,
+    initialLoadComplete,
+    checkout,
+    cancel,
+    opening,
+    error,
+    pixPending,
+    dismissPix
+  };
 }
 
 // src/internal/SubscriptionGate.tsx
@@ -2351,6 +2388,16 @@ function dailyFromYearly(yearlyCents) {
   if (yearlyCents === null || yearlyCents === void 0) return 0;
   return Math.round(yearlyCents / 365);
 }
+function computeAnchorCents(baseCents, multiplier) {
+  if (multiplier === null || multiplier === void 0) return null;
+  if (!Number.isFinite(multiplier)) return null;
+  if (multiplier <= 1) return null;
+  return Math.round(baseCents * multiplier);
+}
+function discountPercent(anchorCents, realCents) {
+  if (anchorCents <= realCents) return 0;
+  return Math.floor((anchorCents - realCents) / anchorCents * 100);
+}
 
 // src/hooks/useAuthPrimitives.ts
 import { useEffect as useEffect9 } from "react";
@@ -2454,12 +2501,14 @@ export {
   InstallSplash,
   LoadingState,
   PushPrompt2 as PushPrompt,
+  computeAnchorCents,
   dailyFromYearly,
   detectAndroidBrowser,
   detectIOSBrowser,
   detectInAppApp,
   detectPlatform,
   detectStandalone,
+  discountPercent,
   formatBRL,
   monthlyFromYearly,
   shouldBlockInstall,