@ollaid/native-sso 1.0.0

package/dist/hooks/useNativeAuth.d.ts

@@ -0,0 +1,262 @@
+/**
+ * Hook d'authentification Native SSO v1.0
+ * Architecture Frontend-First avec appels directs à l'IAM
+ *
+ * @version 1.0.0
+ */
+import type { NativeAuthStatus, NativeExchangeResponse, AccountType } from '../types/native';
+export interface UseNativeAuthOptions {
+    /** URL du Backend SaaS */
+    saasApiUrl: string;
+    /** URL du Backend IAM */
+    iamApiUrl: string;
+    /** Charger les credentials automatiquement au montage */
+    autoLoadCredentials?: boolean;
+    /** Mode debug */
+    debug?: boolean;
+}
+export declare function useNativeAuth(options: UseNativeAuthOptions): {
+    credentialsLoaded: boolean;
+    processToken: string | null;
+    status: NativeAuthStatus | null;
+    user: import("..").NativeUser | null;
+    application: {
+        id: number;
+        name: string;
+        logo?: string;
+    } | null;
+    prompt: {
+        title: string;
+        message: string;
+        actions: string[];
+    } | null;
+    alternativeMethod: {
+        type: "email" | "phone";
+        value: string;
+    } | null;
+    conflict: {
+        type: "email" | "phone";
+        maskedIdentifier: string;
+        options: {
+            canLogin: boolean;
+            canRecoverByEmail: boolean;
+            canRecoverBySms: boolean;
+            maskedEmail?: string;
+            maskedPhone?: string;
+        };
+    } | null;
+    loading: boolean;
+    error: string | null;
+    errorType: string | null;
+    isAuthenticated: boolean;
+    accountType: AccountType;
+    isPhoneOnly: boolean;
+    otpMethod: "email" | "sms" | null | undefined;
+    otpSentTo: string | null | undefined;
+    loadCredentials: () => Promise<{
+        success: boolean;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string;
+    }>;
+    loginWithEmail: (email: string, acctType?: "user" | "admin") => Promise<{
+        success: boolean;
+        status: string;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: NativeAuthStatus | undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        status?: undefined;
+    }>;
+    loginWithPhone: (ccphone: string, phone: string, acctType?: "user" | "admin") => Promise<{
+        success: boolean;
+        status: string;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: NativeAuthStatus | undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        status?: undefined;
+    }>;
+    loginWithAccessOtp: (otpCode: string) => Promise<{
+        success: boolean;
+        status: string;
+        callback_token?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: string;
+        callback_token: string;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: NativeAuthStatus | undefined;
+        callback_token?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        status?: undefined;
+        callback_token?: undefined;
+    }>;
+    submitPassword: (password: string) => Promise<{
+        success: boolean;
+        error: string;
+        user?: undefined;
+        callback_token?: undefined;
+        requires_2fa?: undefined;
+        status?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        user: import("..").NativeUser;
+        callback_token: string;
+        error?: undefined;
+        requires_2fa?: undefined;
+        status?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        requires_2fa: boolean;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        status?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: string;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        requires_2fa?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        requires_2fa?: undefined;
+        status?: undefined;
+    }>;
+    submitOtp: (otpCode: string) => Promise<{
+        success: boolean;
+        error: string;
+        user?: undefined;
+        callback_token?: undefined;
+        status?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        user: import("..").NativeUser;
+        callback_token: string;
+        error?: undefined;
+        status?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        status: string;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        status?: undefined;
+    }>;
+    submitTotp: (totpCode: string) => Promise<{
+        success: boolean;
+        error: string;
+        user?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        user: import("..").NativeUser;
+        error?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        error?: undefined;
+        user?: undefined;
+    }>;
+    grantAccess: () => Promise<{
+        success: boolean;
+        error: string;
+        user?: undefined;
+        callback_token?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        user: import("..").NativeUser;
+        callback_token: string;
+        error?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string;
+        error?: undefined;
+        user?: undefined;
+        callback_token?: undefined;
+    }>;
+    resendOtp: () => Promise<{
+        success: boolean;
+        error: string;
+        cooldown?: undefined;
+        message?: undefined;
+        otp_code_dev?: undefined;
+    } | {
+        success: boolean;
+        cooldown: number | undefined;
+        message: string | undefined;
+        otp_code_dev: string | undefined;
+        error?: undefined;
+    } | {
+        success: boolean;
+        error?: undefined;
+        cooldown?: undefined;
+        message?: undefined;
+        otp_code_dev?: undefined;
+    }>;
+    setSession: (data: NativeExchangeResponse) => void;
+    logout: () => Promise<void>;
+    reset: () => void;
+    clearError: () => void;
+    register: (data: {
+        name: string;
+        email?: string;
+        ccphone: string;
+        phone: string;
+        town?: string;
+        country?: string;
+    }) => Promise<{
+        success: boolean;
+        status: NativeAuthStatus | undefined;
+        error_type?: undefined;
+    } | {
+        success: boolean;
+        error_type: string | undefined;
+        status?: undefined;
+    }>;
+    setAccountType: import("react").Dispatch<import("react").SetStateAction<AccountType>>;
+};
+export default useNativeAuth;

package/dist/hooks/useTokenHealthCheck.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Hook de vérification périodique du token Sanctum
+ *
+ * - Premier check 2 min après login
+ * - Checks suivants toutes les 5 min
+ * - Ne déconnecte PAS si offline ou serveur inaccessible
+ * - Déconnecte UNIQUEMENT si le backend retourne 401 (token invalide)
+ *
+ * @version 1.0.0
+ */
+import type { UserInfos } from '../types/native';
+export interface UseTokenHealthCheckOptions {
+    /** Whether to enable health checks (true when authenticated) */
+    enabled: boolean;
+    /** SaaS API base URL */
+    saasApiUrl: string;
+    /** Called when the backend explicitly invalidates the token (401) */
+    onTokenInvalid: () => void;
+    /** Called when fresh user_infos are received */
+    onUserUpdated?: (userInfos: UserInfos) => void;
+    /** Debug mode */
+    debug?: boolean;
+}
+export declare function useTokenHealthCheck(options: UseTokenHealthCheckOptions): void;
+export default useTokenHealthCheck;