@hook-sdk/template 0.8.1 → 0.9.0

package/dist/index.d.cts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, Component } from 'react';
 import { z } from 'zod';
 import * as _hook_sdk_sdk from '@hook-sdk/sdk';
-import { PlanState, ReminderSlot } from '@hook-sdk/sdk';
+import { CheckoutCycle, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
 export { PlanInfo, PlanState } from '@hook-sdk/sdk';
 
 declare const AppConfigSchema: z.ZodObject<{
@@ -281,19 +281,34 @@ interface PixPending {
      */
     paid: boolean;
 }
+interface PaywallCheckoutArgs {
+    cpf: string;
+    cycle: CheckoutCycle;
+    method: 'card' | 'pix-auto';
+    /** Required when method === 'card'. */
+    card?: CheckoutCardData;
+    /** Required when method === 'card'. */
+    holderInfo?: CheckoutHolderInfo;
+    /** Optional; backend falls back to X-Forwarded-For when absent. */
+    remoteIp?: string;
+}
 /**
- * Hook headless pro Paywall. Expõe status atual da subscription + ação
- * `checkout({cpf, cycle, method})` com 3 métodos:
+ * Hook headless pro Paywall. Expõe status da subscription + ação
+ * `checkout({cpf, cycle, method, card?, holderInfo?, remoteIp?})`.
+ *
+ * App Store substrate (2026-04-24, SDK 0.14.0+):
  *
- * - **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`.
+ * - **method='card'** → backend tokeniza via Asaas `/v3/creditCard/tokenize`
+ *   e cria subscription com `nextDueDate = today + trialDays`. Sem cobrança
+ *   no day 0; trial corre enquanto Asaas já segura o instrumento. Caller
+ *   obrigatório passar `card` + `holderInfo`. Nada é persistido/loggado no
+ *   SDK — PAN/CVV transitam só no request HTTPS direto ao backend. Após
+ *   success chama `subscription.refresh()` pra SubscriptionGate liberar
+ *   o app automaticamente (status passa pra `trialing`).
+ *
+ * - **method='pix-auto'** → Pix Automático BACEN Jornada 3. User escaneia
+ *   QR 1x, autoriza débito recorrente no app do banco. Retorna QR via
+ *   `pixPending` (polling existing detecta ativação e flipa `paid=true`).
  *
  * Subscription real é atualizada via webhook (`PAYMENT_RECEIVED` ou
  * `PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED`).
@@ -302,16 +317,14 @@ declare function usePaywallState(): {
     status: SubscriptionStatus;
     daysLeftInTrial: number | null;
     initialLoadComplete: boolean;
-    checkout: (args: {
-        cpf: string;
-        cycle?: "MONTHLY" | "YEARLY";
-        method?: PaymentMethod;
-    }) => Promise<void>;
+    checkout: (args: PaywallCheckoutArgs) => Promise<void>;
     cancel: () => Promise<void>;
     opening: boolean;
     error: Error | null;
     pixPending: PixPending | null;
     dismissPix: () => void;
+    availableMethods: readonly ("card" | "pix-auto")[];
+    monthlyEquivalent: (cycle: CheckoutCycle) => number;
 };
 
 /**

package/dist/index.d.ts

@@ -2,7 +2,7 @@ import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ComponentType, Component } from 'react';
 import { z } from 'zod';
 import * as _hook_sdk_sdk from '@hook-sdk/sdk';
-import { PlanState, ReminderSlot } from '@hook-sdk/sdk';
+import { CheckoutCycle, CheckoutCardData, CheckoutHolderInfo, PlanState, ReminderSlot } from '@hook-sdk/sdk';
 export { PlanInfo, PlanState } from '@hook-sdk/sdk';
 
 declare const AppConfigSchema: z.ZodObject<{
@@ -281,19 +281,34 @@ interface PixPending {
      */
     paid: boolean;
 }
+interface PaywallCheckoutArgs {
+    cpf: string;
+    cycle: CheckoutCycle;
+    method: 'card' | 'pix-auto';
+    /** Required when method === 'card'. */
+    card?: CheckoutCardData;
+    /** Required when method === 'card'. */
+    holderInfo?: CheckoutHolderInfo;
+    /** Optional; backend falls back to X-Forwarded-For when absent. */
+    remoteIp?: string;
+}
 /**
- * Hook headless pro Paywall. Expõe status atual da subscription + ação
- * `checkout({cpf, cycle, method})` com 3 métodos:
+ * Hook headless pro Paywall. Expõe status da subscription + ação
+ * `checkout({cpf, cycle, method, card?, holderInfo?, remoteIp?})`.
+ *
+ * App Store substrate (2026-04-24, SDK 0.14.0+):
  *
- * - **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`.
+ * - **method='card'** → backend tokeniza via Asaas `/v3/creditCard/tokenize`
+ *   e cria subscription com `nextDueDate = today + trialDays`. Sem cobrança
+ *   no day 0; trial corre enquanto Asaas já segura o instrumento. Caller
+ *   obrigatório passar `card` + `holderInfo`. Nada é persistido/loggado no
+ *   SDK — PAN/CVV transitam só no request HTTPS direto ao backend. Após
+ *   success chama `subscription.refresh()` pra SubscriptionGate liberar
+ *   o app automaticamente (status passa pra `trialing`).
+ *
+ * - **method='pix-auto'** → Pix Automático BACEN Jornada 3. User escaneia
+ *   QR 1x, autoriza débito recorrente no app do banco. Retorna QR via
+ *   `pixPending` (polling existing detecta ativação e flipa `paid=true`).
  *
  * Subscription real é atualizada via webhook (`PAYMENT_RECEIVED` ou
  * `PIX_AUTOMATIC_RECURRING_AUTHORIZATION_ACTIVATED`).
@@ -302,16 +317,14 @@ declare function usePaywallState(): {
     status: SubscriptionStatus;
     daysLeftInTrial: number | null;
     initialLoadComplete: boolean;
-    checkout: (args: {
-        cpf: string;
-        cycle?: "MONTHLY" | "YEARLY";
-        method?: PaymentMethod;
-    }) => Promise<void>;
+    checkout: (args: PaywallCheckoutArgs) => Promise<void>;
     cancel: () => Promise<void>;
     opening: boolean;
     error: Error | null;
     pixPending: PixPending | null;
     dismissPix: () => void;
+    availableMethods: readonly ("card" | "pix-auto")[];
+    monthlyEquivalent: (cycle: CheckoutCycle) => number;
 };
 
 /**