@donotdev/auth 0.0.2 → 0.0.3

package/dist/useAuth.d.ts

@@ -4,11 +4,13 @@ import type { AuthAPI } from '@donotdev/core';
  *
  * Single entry point for all authentication operations.
  * Lazy loads FirebaseAuth on first call and connects to store.
+ * Uses unified FeatureStatus enum for lifecycle management.
  *
  * **Property-based access (clean and simple):**
  * ```typescript
  * // ✅ State from store (reactive, re-renders on change)
  * const user = useAuth('user');
+ * const status = useAuth('status'); // 'initializing' | 'ready' | 'degraded' | 'error'
  * const loading = useAuth('loading');
  * const error = useAuth('error');
  *
@@ -18,9 +20,15 @@ import type { AuthAPI } from '@donotdev/core';
  * ```
  *
  * **How it works:**
- * - Store properties (user, loading, etc.) → Subscribe via Zustand (reactive)
+ * - Store properties (user, status, loading, etc.) → Subscribe via Zustand (reactive)
  * - Methods (signInWithEmail, etc.) → Get from FirebaseAuth instance (stable)
  *
+ * **Status-based behavior:**
+ * - `initializing`: Auth is loading (returns degraded API until ready)
+ * - `ready`: Auth fully operational (returns real API)
+ * - `degraded`: Auth unavailable (returns degraded API)
+ * - `error`: Auth encountered error (returns degraded API)
+ *
  * **Error Handling:**
  * All async methods throw DoNotDevError (already wrapped by FirebaseAuth/SmartRecovery).
  *
@@ -30,20 +38,21 @@ import type { AuthAPI } from '@donotdev/core';
  *
  * @example
  * ```typescript
+ * // Get status (re-renders when status changes)
+ * const status = useAuth('status');
+ * if (status === 'initializing') return <Loader />;
+ * if (status === 'degraded') return <Error>Auth unavailable</Error>;
+ *
  * // Get user (re-renders when user changes)
  * const user = useAuth('user');
  * if (!user) return <LoginButton />;
  *
- * // Get error (re-renders when error changes)
- * const error = useAuth('error');
- * if (error) return <Alert>{error.message}</Alert>;
- *
  * // Get sign-in method (stable, never re-renders)
  * const signIn = useAuth('signInWithEmail');
  * await signIn(email, password);
  * ```
  *
- * @version 0.0.1
+ * @version 0.0.3
  * @since 0.0.1
  * @author AMBROISE PARK Consulting
  */

package/dist/useAuth.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../src/useAuth.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAMV,OAAO,EACR,MAAM,gBAAgB,CAAC;AAqGxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAqTnE"}
+{"version":3,"file":"useAuth.d.ts","sourceRoot":"","sources":["../src/useAuth.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAMV,OAAO,EAER,MAAM,gBAAgB,CAAC;AAgJxB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;AACH,wBAAgB,OAAO,CAAC,CAAC,SAAS,MAAM,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAuTnE"}

package/dist/useAuth.js

@@ -1 +1 @@
-"use client";import{useEffect as H,useCallback as a}from"react";import{DEGRADED_AUTH_API as d,FRAMEWORK_FEATURES as N,handleError as q,isClient as n,useFeatureConsent as B,USER_ROLES as K,SUBSCRIPTION_TIERS as j}from"@donotdev/core";import{useAuthStore as u}from"./AuthStore";import{getAuthMethod as m}from"./constants";let e=null,o=!1,c=!1;function J(){return i=>{const r=u.getState();return i===!1?!0:i===!0?!!r.user:!(i.required&&!r.user||i.role&&r.user?.role!==i.role||i.tier&&r.userSubscription?.tier!==i.tier||i.validate&&r.userSubscription&&r.user?.role&&!i.validate(r.user.role,r.userSubscription.tier))}}const Q=J(),S=new Set(["user","loading","error","initialized","authStateChecked","userProfile","userSubscription","emailVerification","partnerError","getPartnerState","setPartnerState"]);function X(i){const r=B(N.AUTH);H(()=>{if(!n()||!r)return;const{initialized:t}=u.getState();t||o||(o=!0,(async()=>{try{const{getFirebaseAuth:s}=await import("./FirebaseAuth");e=s(),e.setStore(u.getState()),u.getState().setAuthService(e),await e.initialize();let l=!1;e.onAuthStateChanged(Y=>{l||(l=!0,u.getState().setAuthStateChecked(!0))}),u.getState().setInitialized(!0),c=!1}catch(s){c||(q(s,{userMessage:"Authentication initialization failed",context:{operation:"useAuth.initialize"},severity:"warning",showNotification:!1}),c=!0)}finally{o=!1}})())},[r]);const E=a(async(t,s)=>!n()||!e?null:e.signInWithEmail(t,s),[]),f=a(async(t,s)=>!n()||!e?null:e.createUserWithEmail(t,s),[]),y=a(async(t,s)=>{if(!n()||!e)return null;const l=m(s);return e.signInWithPartner(t,l)},[]),A=a(async(t,s)=>{if(!n()||!e)return null;const l=m(s);return e.linkWithPartner(t,l)},[]),C=a(async t=>!n()||!e?null:e.signInWithGoogleCredential(t),[]),W=a(async()=>{if(!(!n()||!e))return e.signOut()},[]),I=a(async t=>{if(!(!n()||!e))return e.sendPasswordResetEmail(t)},[]),P=a(async t=>{if(!(!n()||!e))return e.updatePassword(t)},[]),p=a(async()=>{if(!(!n()||!e))return e.sendEmailVerification()},[]),R=a(async(t,s)=>{if(!(!n()||!e))return e.sendSignInLinkToEmail(t,s)},[]),w=a(async(t,s)=>!n()||!e?null:e.signInWithEmailLink(t,s),[]),T=a(t=>!n()||!e?!1:e.isSignInWithEmailLink(t),[]),b=a(async()=>!n()||!e?null:e.getCurrentUser(),[]),k=a(async()=>!n()||!e?{status:"pending"}:e.getEmailVerificationStatus(),[]),U=a(async()=>!n()||!e?!1:e.isEmailVerificationEnabled(),[]),v=a(async t=>!n()||!e?!1:e.hasRole(t),[]),z=a(async t=>!n()||!e?!1:e.hasTier(t),[]),F=a(async t=>!n()||!e?!1:e.hasFeature(t),[]),L=a(()=>n()?u.getState().getCustomClaims():{},[]),V=a(t=>n()?u.getState().getCustomClaim(t):null,[]),O=a(async t=>{if(!(!n()||!e))return e.reauthenticateWithPassword(t)},[]),_=a(async(t,s)=>{if(!(!n()||!e))return e.reauthenticateWithProvider(t,s)},[]),G=a(async t=>{if(!(!n()||!e))return e.deleteAccount(t)},[]),h={signInWithEmail:E,createUserWithEmail:f,signInWithPartner:y,linkWithPartner:A,signInWithGoogleCredential:C,signOut:W,sendPasswordResetEmail:I,updatePassword:P,sendEmailVerification:p,getEmailVerificationStatus:k,isEmailVerificationEnabled:U,sendSignInLinkToEmail:R,signInWithEmailLink:w,isSignInWithEmailLink:T,getCurrentUser:b,reauthenticateWithPassword:O,reauthenticateWithProvider:_,deleteAccount:G,hasRole:v,hasTier:z,hasFeature:F,getCustomClaims:L,getCustomClaim:V},g=new Set(["isAuthenticated","userRole","userTier","canAccess"]),D=u(t=>S.has(i)?t[i]:null),M=u(t=>g.has(i)?i==="isAuthenticated"?!!t.user:i==="userRole"?t.user?.role||K.GUEST:i==="userTier"?t.userSubscription?.tier||j.FREE:i==="canAccess"?Q:null:null),x=u(t=>t.initialized);return!r||!x?d[i]:i==="isAvailable"?!0:S.has(i)?D:i in h?h[i]:g.has(i)?M:d[i]}export{X as useAuth};
+"use client";import{useEffect as x,useCallback as r}from"react";import{DEGRADED_AUTH_API as p,FEATURE_STATUS as c,FRAMEWORK_FEATURES as H,handleError as j,isClient as n,useFeatureConsent as q,USER_ROLES as B,SUBSCRIPTION_TIERS as K}from"@donotdev/core";import{useAuthStore as o}from"./AuthStore";import{getAuthMethod as I}from"./constants";let e=null,S=!1,y=!1;function Y(){const a=i=>{const u=o.getState();if(u.user?.role==="admin")return!0;const l=u.userProfile?.permissions;return l?l.includes(i):!1};return{navigate:i=>{const u=o.getState();return i===!1?!0:i===!0?!!u.user:!(i.required&&!u.user||i.role&&u.user?.role!==i.role||i.tier&&u.userSubscription?.tier!==i.tier||i.validate&&u.userSubscription&&u.user?.role&&!i.validate(u.user.role,u.userSubscription.tier))},view:i=>a(`${i}:view`),edit:i=>a(`${i}:edit`),delete:i=>a(`${i}:delete`),create:i=>a(`${i}:create`),has:i=>a(i),perform:(i,u)=>{const l=o.getState();if(l.user?.role==="admin")return!0;if(!a(i))return!1;if(u){const h=l.userProfile?.capabilities;if(h?.[i]){const f=h[i];for(const[E,g]of Object.entries(u))if(typeof f[E]=="number"&&typeof g=="number"&&g>f[E])return!1}}return!0}}}const Z=Y(),P=new Set(["user","loading","error","status","userProfile","userSubscription","emailVerification","partnerError","getPartnerState","setPartnerState"]);function J(a){const i=q(H.AUTH);x(()=>{if(!n())return;if(!i){o.getState().setStatus(c.DEGRADED);return}const{status:t}=o.getState();t===c.READY||S||(S=!0,(async()=>{try{const{getFirebaseAuth:s}=await import("./FirebaseAuth");e=s(),e.setStore(o.getState()),o.getState().setAuthService(e),await e.initialize(),e.onAuthStateChanged(()=>{}),y=!1}catch(s){o.getState().setStatus(c.DEGRADED),y||(j(s,{userMessage:"Authentication initialization failed",context:{operation:"useAuth.initialize"},severity:"warning",showNotification:!1}),y=!0)}finally{S=!1}})())},[i]);const u=r(async(t,s)=>!n()||!e?null:e.signInWithEmail(t,s),[]),l=r(async(t,s)=>!n()||!e?null:e.createUserWithEmail(t,s),[]),h=r(async(t,s)=>{if(!n()||!e)return null;const d=I(s);return e.signInWithPartner(t,d)},[]),f=r(async(t,s)=>{if(!n()||!e)return null;const d=I(s);return e.linkWithPartner(t,d)},[]),E=r(async t=>!n()||!e?null:e.signInWithGoogleCredential(t),[]),g=r(async()=>{if(!(!n()||!e))return e.signOut()},[]),W=r(async t=>{if(!(!n()||!e))return e.sendPasswordResetEmail(t)},[]),C=r(async t=>{if(!(!n()||!e))return e.updatePassword(t)},[]),T=r(async()=>{if(!(!n()||!e))return e.sendEmailVerification()},[]),b=r(async(t,s)=>{if(!(!n()||!e))return e.sendSignInLinkToEmail(t,s)},[]),w=r(async(t,s)=>!n()||!e?null:e.signInWithEmailLink(t,s),[]),D=r(t=>!n()||!e?!1:e.isSignInWithEmailLink(t),[]),U=r(async()=>!n()||!e?null:e.getCurrentUser(),[]),v=r(async()=>!n()||!e?{status:"pending"}:e.getEmailVerificationStatus(),[]),k=r(async()=>!n()||!e?!1:e.isEmailVerificationEnabled(),[]),F=r(async t=>!n()||!e?!1:e.hasRole(t),[]),G=r(async t=>!n()||!e?!1:e.hasTier(t),[]),L=r(async t=>!n()||!e?!1:e.hasFeature(t),[]),O=r(()=>n()?o.getState().getCustomClaims():{},[]),V=r(t=>n()?o.getState().getCustomClaim(t):null,[]),_=r(async t=>{if(!(!n()||!e))return e.reauthenticateWithPassword(t)},[]),N=r(async(t,s)=>{if(!(!n()||!e))return e.reauthenticateWithProvider(t,s)},[]),$=r(async t=>{if(!(!n()||!e))return e.deleteAccount(t)},[]),A={signInWithEmail:u,createUserWithEmail:l,signInWithPartner:h,linkWithPartner:f,signInWithGoogleCredential:E,signOut:g,sendPasswordResetEmail:W,updatePassword:C,sendEmailVerification:T,getEmailVerificationStatus:v,isEmailVerificationEnabled:k,sendSignInLinkToEmail:b,signInWithEmailLink:w,isSignInWithEmailLink:D,getCurrentUser:U,reauthenticateWithPassword:_,reauthenticateWithProvider:N,deleteAccount:$,hasRole:F,hasTier:G,hasFeature:L,getCustomClaims:O,getCustomClaim:V},R=new Set(["isAuthenticated","userRole","userTier","can"]),z=o(t=>P.has(a)?t[a]:null),M=o(t=>R.has(a)?a==="isAuthenticated"?!!t.user:a==="userRole"?t.user?.role||B.GUEST:a==="userTier"?t.userSubscription?.tier||K.FREE:a==="can"?Z:null:null),m=o(t=>t.status);return a==="status"?m:!i||m===c.INITIALIZING||m===c.DEGRADED||m===c.ERROR?p[a]:a==="isAvailable"?!0:P.has(a)?z:a in A?A[a]:R.has(a)?M:p[a]}export{J as useAuth};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/auth",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "private": false,
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -42,10 +42,10 @@
     "type-check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@donotdev/components": "0.0.2",
-    "@donotdev/core": "0.0.2",
-    "@donotdev/crud": "0.0.2",
-    "@donotdev/firebase": "0.0.2",
+    "@donotdev/components": "0.0.3",
+    "@donotdev/core": "0.0.3",
+    "@donotdev/crud": "0.0.3",
+    "@donotdev/firebase": "0.0.3",
     "firebase": "^12.5.0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3"