@hook-sdk/template 0.17.0 → 0.18.1

package/dist/index.d.cts

@@ -400,6 +400,7 @@ interface PaywallPlanDerived {
  */
 declare function usePaywallState(): {
     status: SubscriptionStatus;
+    hasAccess: boolean | null;
     daysLeftInTrial: number | null;
     initialLoadComplete: boolean;
     plan: PaywallPlanDerived | null;
@@ -722,7 +723,21 @@ declare function shouldBlockInstall(state: InstallState, now?: number): boolean;
  */
 declare function shouldShowPermanentOption(state: InstallState): boolean;
 
-declare function asaasErrorMessage(code: string): string;
+/**
+ * Map Asaas error → PT-BR user-facing message.
+ *
+ * Two inputs because backend folds Asaas's specific error code into a
+ * compound code (`payments.capture_card.tokenize_failed:invalid_holderInfo`)
+ * and only the *description* string ("O CEP informado é inválido.")
+ * distinguishes between sub-cases of `invalid_holderInfo` (CEP, phone, name).
+ *
+ * Asaas keeps a snapshot of Correios CEPs that lags real registrations by
+ * months — CEPs of recently-cadastrated streets (ex: bairros novos) get
+ * rejected even though they're valid in ViaCEP/BrasilAPI. We don't suggest
+ * a fictitious CEP (would mess up nota fiscal/comms); we explain the issue
+ * is on the processor's side and ask user to try a nearby street's CEP.
+ */
+declare function asaasErrorMessage(code: string, description?: string): string;
 
 type RouteBoundaryProps = {
     children: ReactNode;

package/dist/index.d.ts

@@ -400,6 +400,7 @@ interface PaywallPlanDerived {
  */
 declare function usePaywallState(): {
     status: SubscriptionStatus;
+    hasAccess: boolean | null;
     daysLeftInTrial: number | null;
     initialLoadComplete: boolean;
     plan: PaywallPlanDerived | null;
@@ -722,7 +723,21 @@ declare function shouldBlockInstall(state: InstallState, now?: number): boolean;
  */
 declare function shouldShowPermanentOption(state: InstallState): boolean;
 
-declare function asaasErrorMessage(code: string): string;
+/**
+ * Map Asaas error → PT-BR user-facing message.
+ *
+ * Two inputs because backend folds Asaas's specific error code into a
+ * compound code (`payments.capture_card.tokenize_failed:invalid_holderInfo`)
+ * and only the *description* string ("O CEP informado é inválido.")
+ * distinguishes between sub-cases of `invalid_holderInfo` (CEP, phone, name).
+ *
+ * Asaas keeps a snapshot of Correios CEPs that lags real registrations by
+ * months — CEPs of recently-cadastrated streets (ex: bairros novos) get
+ * rejected even though they're valid in ViaCEP/BrasilAPI. We don't suggest
+ * a fictitious CEP (would mess up nota fiscal/comms); we explain the issue
+ * is on the processor's side and ask user to try a nearby street's CEP.
+ */
+declare function asaasErrorMessage(code: string, description?: string): string;
 
 type RouteBoundaryProps = {
     children: ReactNode;

package/dist/index.js

@@ -196,7 +196,16 @@ var MAP = {
   pix_expired: "QR Code do PIX expirou. Gere um novo.",
   pix_not_paid_yet: "PIX ainda n\xE3o foi pago. Aguardando confirma\xE7\xE3o."
 };
-function asaasErrorMessage(code) {
+function asaasErrorMessage(code, description) {
+  if (description) {
+    const lower = description.toLowerCase();
+    if (lower.includes("cep")) {
+      return "Nosso processador de pagamentos n\xE3o reconheceu esse CEP \u2014 a base deles pode estar desatualizada. Tente outro CEP.";
+    }
+    if (lower.includes("telefone") || lower.includes("contato com ddd")) {
+      return "Telefone inv\xE1lido. Confira o n\xFAmero com DDD e tente novamente.";
+    }
+  }
   return MAP[code] ?? "Ocorreu um erro inesperado. Tente novamente em instantes.";
 }
 
@@ -282,6 +291,7 @@ function usePaywallState() {
   const status = subscription.status();
   const daysLeftInTrial = subscription.daysLeftInTrial();
   const initialLoadComplete = subscription.initialLoadComplete;
+  const hasAccess = subscription.hasAccess;
   const pixPending = useMemo2(() => {
     const sdkPix = subscription.pixPending;
     if (!sdkPix) return null;
@@ -324,7 +334,9 @@ function usePaywallState() {
     (code, fallbackMessage) => ({
       code,
       message: fallbackMessage,
-      userMessage: useDefaultMessages ? asaasErrorMessage(code) : fallbackMessage
+      // fallbackMessage carries Asaas's PT-BR description ("O CEP informado é inválido.")
+      // that distinguishes invalid_holderInfo sub-cases (CEP vs phone vs name).
+      userMessage: useDefaultMessages ? asaasErrorMessage(code, fallbackMessage) : fallbackMessage
     }),
     [useDefaultMessages]
   );
@@ -485,6 +497,7 @@ function usePaywallState() {
   return {
     // Subscription status (reactive, proxied from SDK)
     status,
+    hasAccess,
     daysLeftInTrial,
     initialLoadComplete,
     // Plan derivation from config (sync, no fetch)
@@ -528,9 +541,10 @@ var BLOCKING = /* @__PURE__ */ new Set([
 ]);
 function SubscriptionGate({ Paywall, children }) {
   const { mode } = useTemplateConfig();
-  const { status, initialLoadComplete } = usePaywallState();
+  const { status, hasAccess, initialLoadComplete } = usePaywallState();
   if (mode === "free") return /* @__PURE__ */ jsx5(Fragment2, { children });
   if (!initialLoadComplete && status === "none") return null;
+  if (hasAccess === true && status !== "none") return /* @__PURE__ */ jsx5(Fragment2, { children });
   if (BLOCKING.has(status)) return /* @__PURE__ */ jsx5(Paywall, {});
   return /* @__PURE__ */ jsx5(Fragment2, { children });
 }