@hook-sdk/template 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,288 @@
+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';
+
+declare const AppConfigSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    slug: z.ZodString;
+    name: z.ZodString;
+    display_name: z.ZodOptional<z.ZodString>;
+    email_alias: z.ZodString;
+    theme: z.ZodObject<{
+        primary_color: z.ZodString;
+        background_color: z.ZodOptional<z.ZodString>;
+        logo_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        icon_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strict>;
+    features_enabled: z.ZodArray<z.ZodEnum<{
+        db: "db";
+        storage: "storage";
+        upload: "upload";
+        leaderboard: "leaderboard";
+        push: "push";
+        subscription: "subscription";
+    }>>;
+    dependencies_allowlist: z.ZodArray<z.ZodString>;
+    subscription: z.ZodObject<{
+        price_cents: z.ZodNumber;
+        currency: z.ZodLiteral<"brl">;
+        trial_days: z.ZodNumber;
+        paywall_config: z.ZodObject<{
+            title: z.ZodString;
+            subtitle: z.ZodOptional<z.ZodString>;
+            benefits: z.ZodArray<z.ZodString>;
+            cta: z.ZodString;
+            priceHint: z.ZodOptional<z.ZodString>;
+            footerNote: z.ZodOptional<z.ZodString>;
+        }, z.core.$strict>;
+    }, z.core.$strict>;
+    sdk_version_required: z.ZodString;
+    max_bundle_size_kb: z.ZodNumber;
+}, z.core.$strict>;
+type AppConfig = z.infer<typeof AppConfigSchema>;
+
+type AuthScreen = 'login' | 'signup' | 'forgot' | 'reset';
+interface AuthScreenProps {
+    onNavigate: (to: AuthScreen) => void;
+}
+declare function DefaultLoginScreen({ onNavigate }: AuthScreenProps): react_jsx_runtime.JSX.Element;
+
+interface AppRootProps {
+    config: AppConfig;
+    children: ReactNode;
+    Login?: ComponentType<AuthScreenProps>;
+    Signup?: ComponentType<AuthScreenProps>;
+    Forgot?: ComponentType<AuthScreenProps>;
+    /**
+     * Tela de reset de senha (form com nova senha via link do email).
+     * Renderizada pelo AuthGate quando URL tem `?token=` + user não logado.
+     * Default: DefaultResetScreen.
+     */
+    Reset?: ComponentType<AuthScreenProps>;
+    Paywall?: ComponentType;
+}
+declare function AppRoot({ config, children, Login, Signup, Forgot, Reset, Paywall, }: AppRootProps): react_jsx_runtime.JSX.Element;
+
+declare function DefaultSignupScreen({ onNavigate }: AuthScreenProps): react_jsx_runtime.JSX.Element;
+
+declare function DefaultForgotScreen({ onNavigate }: AuthScreenProps): react_jsx_runtime.JSX.Element;
+
+/**
+ * Tela default de reset de senha. Renderizada pelo AuthGate quando
+ * `?token=` está presente na URL (link vindo do email de password_reset).
+ *
+ * AuthScreenProps.onNavigate é usado pra voltar pro login após reset
+ * bem-sucedido (usuário precisa re-autenticar — backend revoga todos
+ * os refresh tokens na chamada de `auth.reset`).
+ */
+declare function DefaultResetScreen({ onNavigate }: AuthScreenProps): react_jsx_runtime.JSX.Element;
+
+declare function DefaultPaywall(): react_jsx_runtime.JSX.Element;
+
+declare function LoadingState({ message }: {
+    message?: string;
+}): react_jsx_runtime.JSX.Element;
+
+declare function EmptyState({ title, description, action }: {
+    title: string;
+    description?: string;
+    action?: ReactNode;
+}): react_jsx_runtime.JSX.Element;
+
+interface Props {
+    children: ReactNode;
+    fallback?: ReactNode;
+}
+interface State {
+    error: Error | null;
+}
+declare class ErrorBoundary extends Component<Props, State> {
+    state: State;
+    static getDerivedStateFromError(error: Error): State;
+    componentDidCatch(error: Error): void;
+    render(): string | number | boolean | Iterable<ReactNode> | react_jsx_runtime.JSX.Element;
+}
+
+type AuthFormErrorCode = 'invalid_credentials' | 'rate_limited' | 'email_unverified' | 'account_locked' | 'network' | 'server';
+interface AuthFormError {
+    code: AuthFormErrorCode;
+    message: string;
+    retryAfter?: number;
+}
+
+interface UseLoginFormResult {
+    email: string;
+    setEmail: (v: string) => void;
+    emailError: string | null;
+    password: string;
+    setPassword: (v: string) => void;
+    passwordError: string | null;
+    submit: () => Promise<void>;
+    submitting: boolean;
+    canSubmit: boolean;
+    error: AuthFormError | null;
+}
+declare function useLoginForm(): UseLoginFormResult;
+
+interface UseSignupFormResult {
+    name: string;
+    setName: (v: string) => void;
+    nameError: string | null;
+    email: string;
+    setEmail: (v: string) => void;
+    emailError: string | null;
+    password: string;
+    setPassword: (v: string) => void;
+    passwordError: string | null;
+    submit: () => Promise<void>;
+    submitting: boolean;
+    canSubmit: boolean;
+    error: AuthFormError | null;
+}
+declare function useSignupForm(): UseSignupFormResult;
+
+interface UseForgotFormResult {
+    email: string;
+    setEmail: (v: string) => void;
+    emailError: string | null;
+    submit: () => Promise<void>;
+    submitting: boolean;
+    canSubmit: boolean;
+    sent: boolean;
+    error: AuthFormError | null;
+}
+declare function useForgotForm(): UseForgotFormResult;
+
+interface UseResetFormResult {
+    /** Token JWT lido de `?token=` da URL. null se ausente. */
+    token: string | null;
+    password: string;
+    setPassword: (v: string) => void;
+    passwordError: string | null;
+    confirm: string;
+    setConfirm: (v: string) => void;
+    confirmError: string | null;
+    submit: () => Promise<void>;
+    submitting: boolean;
+    canSubmit: boolean;
+    /** true após submit 200. UI deve mostrar "senha alterada, volte pro login". */
+    done: boolean;
+    error: AuthFormError | null;
+}
+/**
+ * Hook headless pro fluxo de reset de senha via link do email.
+ *
+ * Lê `?token=` da URL atual automaticamente (readonly snapshot no mount).
+ * Se token ausente, `canSubmit` fica false + `token: null` pra UI mostrar
+ * mensagem "link inválido".
+ *
+ * Após submit 200, todos os refresh tokens do user são revogados pelo
+ * backend (forçar re-login). UI deve direcionar pra LoginScreen.
+ */
+declare function useResetForm(): UseResetFormResult;
+
+type SubscriptionStatus = 'active' | 'trialing' | 'expired' | 'canceled' | 'past_due' | 'none';
+/**
+ * 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`).
+ *
+ * MVP: checkout só cartão. Pix vem depois (gatilho documentado em P10.7).
+ */
+declare function usePaywallState(): {
+    status: SubscriptionStatus;
+    daysLeftInTrial: number | null;
+    checkout: (args: {
+        cpf: string;
+        cycle?: "MONTHLY" | "YEARLY";
+    }) => Promise<void>;
+    cancel: () => Promise<void>;
+    opening: boolean;
+    error: Error | null;
+};
+
+/**
+ * Escape hatch pra screens FORA do fluxo de auth (ex: settings/trocar-senha).
+ * Pra LoginScreen/SignupScreen/ForgotScreen custom, use useLoginForm/useSignupForm/useForgotForm.
+ */
+declare function useAuthPrimitives(): {
+    login: (args: {
+        email: string;
+        password: string;
+    }) => Promise<void>;
+    signup: (args: {
+        email: string;
+        password: string;
+        name?: string;
+    }) => Promise<void>;
+    logout: () => Promise<void>;
+    logoutAll: () => Promise<void>;
+    forgot: (args: {
+        email: string;
+    }) => Promise<void>;
+    resendVerify: () => Promise<void>;
+    changePassword: (args: {
+        oldPassword: string;
+        newPassword: string;
+    }) => Promise<void>;
+    changeEmail: (args: {
+        newEmail: string;
+    }) => Promise<void>;
+    refresh: () => Promise<void>;
+};
+
+/**
+ * Wrapper fino sobre useHook(). Expõe apenas `user`, `authStatus` e `refresh`
+ * pros consumidores que não precisam das methods completas do auth.
+ */
+declare function useAuth(): {
+    user: {
+        id: string;
+        email: string;
+        emailVerified: boolean;
+        createdAt: string;
+    } | null;
+    authStatus: _hook_sdk_sdk.AuthStatus;
+    refresh: () => Promise<void>;
+};
+
+/**
+ * Wrapper fino sobre `subscription` do SDK. MVP: apenas status (stub retorna 'none').
+ */
+declare function useSubscription(): {
+    status: _hook_sdk_sdk.SdkSubscriptionStatus;
+};
+
+/**
+ * Wrapper fino sobre `push` do SDK. MVP: stub retorna 'unsupported' no status
+ * e subscribe/unsubscribe lançam SdkError. A shape segue o SDK real.
+ */
+declare function usePush(): {
+    status: _hook_sdk_sdk.PushStatus;
+    subscribe: () => Promise<{
+        subscribed: true;
+    }>;
+    unsubscribe: () => Promise<{
+        subscribed: false;
+    }>;
+};
+
+interface ToastItem {
+    id: string;
+    message: string;
+    kind: 'info' | 'error' | 'success';
+}
+/**
+ * Toast mínimo in-memory. MVP: IA renderiza a lista onde quiser (ex: no final do <Home>).
+ * Não opina sobre UI; retorna items + actions.
+ */
+declare function useToast(): {
+    items: ToastItem[];
+    show: (message: string, kind?: ToastItem["kind"]) => void;
+    dismiss: (id: string) => void;
+};
+
+export { AppRoot, type AppRootProps, type AuthFormError, type AuthFormErrorCode, type AuthScreen, type AuthScreenProps, DefaultForgotScreen, DefaultLoginScreen, DefaultPaywall, DefaultResetScreen, DefaultSignupScreen, EmptyState, ErrorBoundary, LoadingState, type SubscriptionStatus, type ToastItem, type UseLoginFormResult, type UseResetFormResult, useAuth, useAuthPrimitives, useForgotForm, useLoginForm, usePaywallState, usePush, useResetForm, useSignupForm, useSubscription, useToast };