@hook-sdk/template 0.13.0 → 0.14.1

package/dist/index.d.cts

@@ -61,6 +61,14 @@ type AppConfig = {
     branding: {
         primaryColor: string;
         logoUrl: string;
+        /**
+         * Optional. When set, InstallSplash uses this as the app icon (vs.
+         * falling back to logoUrl, then to the "first letter of name"
+         * generic). Apps that have a distinct app-icon asset should set
+         * this; apps where logoUrl already serves both roles can leave it
+         * unset (logoUrl is used as the icon).
+         */
+        iconUrl?: string;
     };
     authFlow: AuthFlowConfig;
     paywall: PaywallConfig;
@@ -200,9 +208,15 @@ interface UseLoginFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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.
@@ -225,12 +239,20 @@ interface UseSignupFormResult {
     name: string;
     setName: (v: string) => void;
     nameError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markNameTouched: () => void;
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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.
@@ -254,6 +276,10 @@ interface UseForgotFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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),
@@ -274,9 +300,15 @@ interface UseResetFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
     confirm: string;
     setConfirm: (v: string) => void;
     confirmError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markConfirmTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     submit: () => Promise<void>;
     submitting: boolean;
     canSubmit: boolean;
@@ -632,7 +664,7 @@ type Platform = 'android' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' |
 type IOSBrowser = 'safari' | 'chrome' | 'firefox' | 'edge' | 'other';
 type AndroidBrowser = 'chrome' | 'firefox' | 'opera' | 'samsung' | 'edge' | 'other';
 type InAppApp = 'instagram' | 'facebook' | 'tiktok' | 'whatsapp' | 'twitter' | 'linkedin' | 'telegram' | 'line' | 'snapchat' | 'pinterest' | 'wechat' | 'other';
-type InstallVariant = 'android-native' | 'android-manual' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' | 'none';
+type InstallVariant = 'android-native' | 'android-manual' | 'android-pending' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' | 'none';
 interface BeforeInstallPromptEvent extends Event {
     prompt: () => Promise<void>;
     userChoice: Promise<{
@@ -765,6 +797,7 @@ declare const AppConfigSchema: z.ZodObject<{
     branding: z.ZodObject<{
         primaryColor: z.ZodString;
         logoUrl: z.ZodString;
+        iconUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     authFlow: z.ZodObject<{
         minPassword: z.ZodNumber;

package/dist/index.d.ts

@@ -61,6 +61,14 @@ type AppConfig = {
     branding: {
         primaryColor: string;
         logoUrl: string;
+        /**
+         * Optional. When set, InstallSplash uses this as the app icon (vs.
+         * falling back to logoUrl, then to the "first letter of name"
+         * generic). Apps that have a distinct app-icon asset should set
+         * this; apps where logoUrl already serves both roles can leave it
+         * unset (logoUrl is used as the icon).
+         */
+        iconUrl?: string;
     };
     authFlow: AuthFlowConfig;
     paywall: PaywallConfig;
@@ -200,9 +208,15 @@ interface UseLoginFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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.
@@ -225,12 +239,20 @@ interface UseSignupFormResult {
     name: string;
     setName: (v: string) => void;
     nameError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markNameTouched: () => void;
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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.
@@ -254,6 +276,10 @@ interface UseForgotFormResult {
     email: string;
     setEmail: (v: string) => void;
     emailError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markEmailTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     /**
      * 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),
@@ -274,9 +300,15 @@ interface UseResetFormResult {
     password: string;
     setPassword: (v: string) => void;
     passwordError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markPasswordTouched: () => void;
     confirm: string;
     setConfirm: (v: string) => void;
     confirmError: string | null;
+    /** Wave 5 #42: call on input blur so the error becomes visible. */
+    markConfirmTouched: () => void;
+    /** True after the user has attempted submit at least once. */
+    formSubmitAttempted: boolean;
     submit: () => Promise<void>;
     submitting: boolean;
     canSubmit: boolean;
@@ -632,7 +664,7 @@ type Platform = 'android' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' |
 type IOSBrowser = 'safari' | 'chrome' | 'firefox' | 'edge' | 'other';
 type AndroidBrowser = 'chrome' | 'firefox' | 'opera' | 'samsung' | 'edge' | 'other';
 type InAppApp = 'instagram' | 'facebook' | 'tiktok' | 'whatsapp' | 'twitter' | 'linkedin' | 'telegram' | 'line' | 'snapchat' | 'pinterest' | 'wechat' | 'other';
-type InstallVariant = 'android-native' | 'android-manual' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' | 'none';
+type InstallVariant = 'android-native' | 'android-manual' | 'android-pending' | 'ios-safari' | 'ios-other' | 'in-app' | 'desktop' | 'none';
 interface BeforeInstallPromptEvent extends Event {
     prompt: () => Promise<void>;
     userChoice: Promise<{
@@ -765,6 +797,7 @@ declare const AppConfigSchema: z.ZodObject<{
     branding: z.ZodObject<{
         primaryColor: z.ZodString;
         logoUrl: z.ZodString;
+        iconUrl: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     authFlow: z.ZodObject<{
         minPassword: z.ZodNumber;