@hook-sdk/template 0.1.1 → 0.1.2

package/dist/index.d.cts

@@ -28,6 +28,11 @@ declare const AppConfigSchema: z.ZodObject<{
         price_cents: z.ZodNumber;
         currency: z.ZodLiteral<"brl">;
         trial_days: z.ZodNumber;
+        mode: z.ZodDefault<z.ZodEnum<{
+            trial: "trial";
+            pay_first: "pay_first";
+            free: "free";
+        }>>;
         paywall_config: z.ZodObject<{
             title: z.ZodString;
             subtitle: z.ZodOptional<z.ZodString>;
@@ -38,6 +43,7 @@ declare const AppConfigSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     sdk_version_required: z.ZodString;
+    template_version_required: z.ZodOptional<z.ZodString>;
     max_bundle_size_kb: z.ZodNumber;
 }, z.core.$strict>;
 type AppConfig = z.infer<typeof AppConfigSchema>;
@@ -118,7 +124,12 @@ interface UseLoginFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o login deu OK (cookies setados), false
+     * se validação falhou, credenciais inválidas, rate-limit ou erro de rede.
+     * Em caso de false, `error` state é populado com detalhes.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     error: AuthFormError | null;
@@ -135,7 +146,12 @@ interface UseSignupFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o signup deu OK (backend respondeu 2xx),
+     * false se validação falhou, houve erro de rede/servidor, ou email já em uso.
+     * Em caso de false, `error` state é populado com detalhes.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     error: AuthFormError | null;
@@ -146,7 +162,13 @@ interface UseForgotFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o backend aceitou a requisição (email
+     * de reset foi enfileirado — sem leak de "existe esse email" por design),
+     * false se validação falhou, rate-limit ou erro de rede.
+     * Em caso de sucesso, `sent` state também é setado para true.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     sent: boolean;
@@ -182,7 +204,7 @@ interface UseResetFormResult {
  */
 declare function useResetForm(): UseResetFormResult;
 
-type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'none';
+type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'pending' | 'none';
 /**
  * Hook headless pro Paywall. Expõe status atual da subscription + ação
  * `checkout(cpf)` que chama `POST /payments/checkout/card` e redireciona

package/dist/index.d.ts

@@ -28,6 +28,11 @@ declare const AppConfigSchema: z.ZodObject<{
         price_cents: z.ZodNumber;
         currency: z.ZodLiteral<"brl">;
         trial_days: z.ZodNumber;
+        mode: z.ZodDefault<z.ZodEnum<{
+            trial: "trial";
+            pay_first: "pay_first";
+            free: "free";
+        }>>;
         paywall_config: z.ZodObject<{
             title: z.ZodString;
             subtitle: z.ZodOptional<z.ZodString>;
@@ -38,6 +43,7 @@ declare const AppConfigSchema: z.ZodObject<{
         }, z.core.$strict>;
     }, z.core.$strict>;
     sdk_version_required: z.ZodString;
+    template_version_required: z.ZodOptional<z.ZodString>;
     max_bundle_size_kb: z.ZodNumber;
 }, z.core.$strict>;
 type AppConfig = z.infer<typeof AppConfigSchema>;
@@ -118,7 +124,12 @@ interface UseLoginFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o login deu OK (cookies setados), false
+     * se validação falhou, credenciais inválidas, rate-limit ou erro de rede.
+     * Em caso de false, `error` state é populado com detalhes.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     error: AuthFormError | null;
@@ -135,7 +146,12 @@ interface UseSignupFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o signup deu OK (backend respondeu 2xx),
+     * false se validação falhou, houve erro de rede/servidor, ou email já em uso.
+     * Em caso de false, `error` state é populado com detalhes.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     error: AuthFormError | null;
@@ -146,7 +162,13 @@ interface UseForgotFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
-    submit: () => Promise<void>;
+    /**
+     * Submete o form. Retorna true se o backend aceitou a requisição (email
+     * de reset foi enfileirado — sem leak de "existe esse email" por design),
+     * false se validação falhou, rate-limit ou erro de rede.
+     * Em caso de sucesso, `sent` state também é setado para true.
+     */
+    submit: () => Promise<boolean>;
     submitting: boolean;
     canSubmit: boolean;
     sent: boolean;
@@ -182,7 +204,7 @@ interface UseResetFormResult {
  */
 declare function useResetForm(): UseResetFormResult;
 
-type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'none';
+type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'pending' | 'none';
 /**
  * Hook headless pro Paywall. Expõe status atual da subscription + ação
  * `checkout(cpf)` que chama `POST /payments/checkout/card` e redireciona

package/dist/index.js

@@ -1,12 +1,20 @@
+// src/AppRoot.tsx
+import { useEffect as useEffect3, useState as useState8 } from "react";
+import { useHook as useHook7 } from "@hook-sdk/sdk";
+
 // src/internal/TemplateConfigContext.tsx
-import { createContext, useContext } from "react";
+import { createContext, useContext, useMemo } from "react";
 import { jsx } from "react/jsx-runtime";
 var TemplateConfigContext = createContext(null);
 function TemplateConfigProvider({
   config,
   children
 }) {
-  return /* @__PURE__ */ jsx(TemplateConfigContext.Provider, { value: config, children });
+  const value = useMemo(() => ({
+    ...config,
+    mode: config.subscription?.mode ?? "trial"
+  }), [config]);
+  return /* @__PURE__ */ jsx(TemplateConfigContext.Provider, { value, children });
 }
 function useTemplateConfig() {
   const ctx = useContext(TemplateConfigContext);
@@ -122,11 +130,17 @@ function usePaywallState() {
 
 // src/internal/SubscriptionGate.tsx
 import { Fragment as Fragment2, jsx as jsx5 } from "react/jsx-runtime";
+var BLOCKING = /* @__PURE__ */ new Set([
+  "pending",
+  "expired",
+  "canceled",
+  "none"
+]);
 function SubscriptionGate({ Paywall, children }) {
+  const { mode } = useTemplateConfig();
   const { status } = usePaywallState();
-  if (status === "expired" || status === "canceled" || status === "past_due") {
-    return /* @__PURE__ */ jsx5(Paywall, {});
-  }
+  if (mode === "free") return /* @__PURE__ */ jsx5(Fragment2, { children });
+  if (BLOCKING.has(status)) return /* @__PURE__ */ jsx5(Paywall, {});
   return /* @__PURE__ */ jsx5(Fragment2, { children });
 }
 
@@ -158,7 +172,7 @@ var ErrorBoundary = class extends Component {
 };
 
 // src/hooks/useLoginForm.ts
-import { useCallback as useCallback2, useMemo, useState as useState3 } from "react";
+import { useCallback as useCallback2, useMemo as useMemo2, useState as useState3 } from "react";
 import { useHook as useHook3 } from "@hook-sdk/sdk";
 
 // src/errors.ts
@@ -199,25 +213,27 @@ function useLoginForm() {
   const [password, setPassword] = useState3("");
   const [submitting, setSubmitting] = useState3(false);
   const [error, setError] = useState3(null);
-  const emailError = useMemo(() => {
+  const emailError = useMemo2(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
-  const passwordError = useMemo(() => {
+  const passwordError = useMemo2(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD) return `M\xEDnimo de ${MIN_PASSWORD} caracteres.`;
     return null;
   }, [password]);
   const canSubmit = email.length > 0 && password.length >= MIN_PASSWORD && emailError === null && passwordError === null && !submitting;
   const submit = useCallback2(async () => {
-    if (!canSubmit) return;
+    if (!canSubmit) return false;
     setSubmitting(true);
     setError(null);
     try {
       await auth.login({ email, password });
+      return true;
     } catch (err) {
       setError(mapSdkError(err));
+      return false;
     } finally {
       setSubmitting(false);
     }
@@ -304,7 +320,7 @@ function DefaultLoginScreen({ onNavigate }) {
 }
 
 // src/hooks/useSignupForm.ts
-import { useCallback as useCallback3, useMemo as useMemo2, useState as useState4 } from "react";
+import { useCallback as useCallback3, useMemo as useMemo3, useState as useState4 } from "react";
 import { useHook as useHook4 } from "@hook-sdk/sdk";
 var EMAIL_RE2 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 var MIN_PASSWORD2 = 8;
@@ -315,30 +331,32 @@ function useSignupForm() {
   const [password, setPassword] = useState4("");
   const [submitting, setSubmitting] = useState4(false);
   const [error, setError] = useState4(null);
-  const nameError = useMemo2(() => {
+  const nameError = useMemo3(() => {
     if (name.length === 0) return null;
     if (name.trim().length < 2) return "Nome muito curto.";
     return null;
   }, [name]);
-  const emailError = useMemo2(() => {
+  const emailError = useMemo3(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE2.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
-  const passwordError = useMemo2(() => {
+  const passwordError = useMemo3(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD2) return `M\xEDnimo de ${MIN_PASSWORD2} caracteres.`;
     return null;
   }, [password]);
   const canSubmit = name.trim().length >= 2 && email.length > 0 && password.length >= MIN_PASSWORD2 && nameError === null && emailError === null && passwordError === null && !submitting;
   const submit = useCallback3(async () => {
-    if (!canSubmit) return;
+    if (!canSubmit) return false;
     setSubmitting(true);
     setError(null);
     try {
       await auth.signup({ name, email, password });
+      return true;
     } catch (err) {
       setError(mapSdkError(err));
+      return false;
     } finally {
       setSubmitting(false);
     }
@@ -395,7 +413,7 @@ function DefaultSignupScreen({ onNavigate }) {
 }
 
 // src/hooks/useForgotForm.ts
-import { useCallback as useCallback4, useMemo as useMemo3, useState as useState5 } from "react";
+import { useCallback as useCallback4, useMemo as useMemo4, useState as useState5 } from "react";
 import { useHook as useHook5 } from "@hook-sdk/sdk";
 var EMAIL_RE3 = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 function useForgotForm() {
@@ -404,21 +422,23 @@ function useForgotForm() {
   const [submitting, setSubmitting] = useState5(false);
   const [sent, setSent] = useState5(false);
   const [error, setError] = useState5(null);
-  const emailError = useMemo3(() => {
+  const emailError = useMemo4(() => {
     if (email.length === 0) return null;
     if (!EMAIL_RE3.test(email)) return "Formato de e-mail inv\xE1lido.";
     return null;
   }, [email]);
   const canSubmit = email.length > 0 && emailError === null && !submitting;
   const submit = useCallback4(async () => {
-    if (!canSubmit) return;
+    if (!canSubmit) return false;
     setSubmitting(true);
     setError(null);
     try {
       await auth.forgot({ email });
       setSent(true);
+      return true;
     } catch (err) {
       setError(mapSdkError(err));
+      return false;
     } finally {
       setSubmitting(false);
     }
@@ -467,7 +487,7 @@ function DefaultForgotScreen({ onNavigate }) {
 }
 
 // src/hooks/useResetForm.ts
-import { useCallback as useCallback5, useEffect as useEffect2, useMemo as useMemo4, useState as useState6 } from "react";
+import { useCallback as useCallback5, useEffect as useEffect2, useMemo as useMemo5, useState as useState6 } from "react";
 import { useHook as useHook6 } from "@hook-sdk/sdk";
 var MIN_PASSWORD3 = 12;
 function useResetForm() {
@@ -484,12 +504,12 @@ function useResetForm() {
     const t = params.get("token");
     setToken(t && t.length > 0 ? t : null);
   }, []);
-  const passwordError = useMemo4(() => {
+  const passwordError = useMemo5(() => {
     if (password.length === 0) return null;
     if (password.length < MIN_PASSWORD3) return `M\xEDnimo de ${MIN_PASSWORD3} caracteres.`;
     return null;
   }, [password]);
-  const confirmError = useMemo4(() => {
+  const confirmError = useMemo5(() => {
     if (confirm.length === 0) return null;
     if (confirm !== password) return "Senhas n\xE3o coincidem.";
     return null;
@@ -632,7 +652,66 @@ function DefaultPaywall() {
 }
 
 // src/AppRoot.tsx
-import { jsx as jsx12, jsxs as jsxs7 } from "react/jsx-runtime";
+import { Fragment as Fragment4, jsx as jsx12, jsxs as jsxs7 } from "react/jsx-runtime";
+function PaymentReturnHandler({ children }) {
+  const { subscription } = useHook7();
+  const [confirming, setConfirming] = useState8(false);
+  useEffect3(() => {
+    if (typeof window === "undefined") return;
+    const url = new URL(window.location.href);
+    if (url.searchParams.get("paymentReturn") !== "1") return;
+    let cancelled = false;
+    let attempts = 0;
+    setConfirming(true);
+    const tick = async () => {
+      if (cancelled) return;
+      if (attempts >= 10) {
+        setConfirming(false);
+        return;
+      }
+      attempts++;
+      try {
+        await subscription.refresh();
+      } catch {
+      }
+      if (cancelled) return;
+      if (subscription.status() === "active") {
+        const cleanUrl = new URL(window.location.href);
+        cleanUrl.searchParams.delete("paymentReturn");
+        window.history.replaceState({}, "", cleanUrl.toString());
+        setConfirming(false);
+        return;
+      }
+      setTimeout(tick, 1e3);
+    };
+    void tick();
+    return () => {
+      cancelled = true;
+    };
+  }, [subscription]);
+  if (confirming) {
+    return /* @__PURE__ */ jsx12(
+      "div",
+      {
+        role: "status",
+        "aria-live": "polite",
+        style: {
+          position: "fixed",
+          inset: 0,
+          display: "flex",
+          alignItems: "center",
+          justifyContent: "center",
+          background: "rgba(0,0,0,0.4)",
+          zIndex: 9999,
+          color: "white",
+          fontSize: "1rem"
+        },
+        children: "Confirmando pagamento\u2026"
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx12(Fragment4, { children });
+}
 function AppRoot({
   config,
   children,
@@ -642,10 +721,10 @@ function AppRoot({
   Reset = DefaultResetScreen,
   Paywall = DefaultPaywall
 }) {
-  return /* @__PURE__ */ jsx12(TemplateConfigProvider, { config, children: /* @__PURE__ */ jsx12(ErrorBoundary, { children: /* @__PURE__ */ jsx12(ThemeProvider, { children: /* @__PURE__ */ jsx12(AuthGate, { Login, Signup, Forgot, Reset, children: /* @__PURE__ */ jsxs7(SubscriptionGate, { Paywall, children: [
+  return /* @__PURE__ */ jsx12(PaymentReturnHandler, { children: /* @__PURE__ */ jsx12(TemplateConfigProvider, { config, children: /* @__PURE__ */ jsx12(ErrorBoundary, { children: /* @__PURE__ */ jsx12(ThemeProvider, { children: /* @__PURE__ */ jsx12(AuthGate, { Login, Signup, Forgot, Reset, children: /* @__PURE__ */ jsxs7(SubscriptionGate, { Paywall, children: [
     children,
     /* @__PURE__ */ jsx12(PushPrompt, {})
-  ] }) }) }) }) });
+  ] }) }) }) }) }) });
 }
 
 // src/defaults/EmptyState.tsx
@@ -659,12 +738,12 @@ function EmptyState({ title, description, action }) {
 }
 
 // src/hooks/useAuthPrimitives.ts
-import { useEffect as useEffect3 } from "react";
-import { useHook as useHook7 } from "@hook-sdk/sdk";
+import { useEffect as useEffect4 } from "react";
+import { useHook as useHook8 } from "@hook-sdk/sdk";
 var warned = false;
 function useAuthPrimitives() {
-  const { auth } = useHook7();
-  useEffect3(() => {
+  const { auth } = useHook8();
+  useEffect4(() => {
     if (!warned && process.env.NODE_ENV !== "production") {
       warned = true;
       console.warn(
@@ -686,18 +765,18 @@ function useAuthPrimitives() {
 }
 
 // src/hooks/useSubscription.ts
-import { useHook as useHook8 } from "@hook-sdk/sdk";
+import { useHook as useHook9 } from "@hook-sdk/sdk";
 function useSubscription() {
-  const { subscription } = useHook8();
+  const { subscription } = useHook9();
   return {
     status: subscription.status()
   };
 }
 
 // src/hooks/usePush.ts
-import { useHook as useHook9 } from "@hook-sdk/sdk";
+import { useHook as useHook10 } from "@hook-sdk/sdk";
 function usePush() {
-  const { push } = useHook9();
+  const { push } = useHook10();
   return {
     status: push.status(),
     subscribe: push.subscribe,
@@ -706,9 +785,9 @@ function usePush() {
 }
 
 // src/hooks/useToast.ts
-import { useCallback as useCallback6, useState as useState8 } from "react";
+import { useCallback as useCallback6, useState as useState9 } from "react";
 function useToast() {
-  const [items, setItems] = useState8([]);
+  const [items, setItems] = useState9([]);
   const show = useCallback6((message, kind = "info") => {
     const id = `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
     setItems((prev) => [...prev, { id, message, kind }]);