@vaultix.ai/react 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
 
 type RiskLevel = "low" | "medium" | "high" | "critical";
 type ChallengeType = "passkey" | "magic_link" | "password" | "totp" | "sms_otp" | "email_otp";
@@ -82,12 +83,24 @@ declare function useSession(): UseSessionReturn;
 declare function useUser(): UseUserReturn;
 /** Returns the active organization for the current session. */
 declare function useOrganization(): UseOrganizationReturn;
+interface UseAuthReturn {
+    isLoaded: boolean;
+    isSignedIn: boolean;
+    userId: string | null;
+    sessionId: string | null;
+    orgId: string | null;
+    signOut: () => Promise<void>;
+    /** Returns the session JWT for use in API calls via Authorization: Bearer header. */
+    getToken: () => Promise<string | null>;
+}
+/** Clerk-compatible auth hook. Returns key auth identifiers and helpers. */
+declare function useAuth(): UseAuthReturn;
 
 interface SignInProps {
     /** Redirect URL after a successful sign-in. Overrides the provider default. */
     redirectUrl?: string;
-    /** Called with the raw session claims after successful sign-in. */
-    onSuccess?: (sessionId: string) => void;
+    /** Called with the handshake token after successful sign-in. */
+    onSuccess?: (handshakeToken: string) => void;
     onError?: (message: string) => void;
     /** API origin — injected by VaultixProvider via DOM attribute, or pass directly. */
     apiOrigin?: string;
@@ -97,13 +110,31 @@ declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginP
 
 interface SignUpProps {
     redirectUrl?: string;
-    onSuccess?: (sessionId: string) => void;
+    onSuccess?: (handshakeToken: string) => void;
     onError?: (message: string) => void;
     apiOrigin?: string;
     className?: string;
 }
 declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignUpProps): react_jsx_runtime.JSX.Element;
 
+/** Renders children only when the user is signed in and auth is loaded. */
+declare function SignedIn({ children }: {
+    children: React$1.ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+/** Renders children only when the user is signed out and auth is loaded. */
+declare function SignedOut({ children }: {
+    children: React$1.ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface RedirectProps {
+    /** Override the default redirect URL. */
+    redirectUrl?: string;
+}
+/** Redirects to /sign-in when the user is not authenticated. */
+declare function RedirectToSignIn({ redirectUrl }: RedirectProps): null;
+/** Redirects to /sign-up when the user is not authenticated. */
+declare function RedirectToSignUp({ redirectUrl }: RedirectProps): null;
+
 interface UserButtonProps {
     /** Show the user's name next to the avatar. Default false. */
     showName?: boolean;
@@ -118,4 +149,4 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ afterSwitchUrl, className, }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ChallengeType, OrganizationSwitcher, type RiskLevel, type SessionClaims, SignIn, SignUp, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useOrganization, useSession, useUser, useVaultix };
+export { type ChallengeType, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useAuth, useOrganization, useSession, useUser, useVaultix };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import React$1 from 'react';
 
 type RiskLevel = "low" | "medium" | "high" | "critical";
 type ChallengeType = "passkey" | "magic_link" | "password" | "totp" | "sms_otp" | "email_otp";
@@ -82,12 +83,24 @@ declare function useSession(): UseSessionReturn;
 declare function useUser(): UseUserReturn;
 /** Returns the active organization for the current session. */
 declare function useOrganization(): UseOrganizationReturn;
+interface UseAuthReturn {
+    isLoaded: boolean;
+    isSignedIn: boolean;
+    userId: string | null;
+    sessionId: string | null;
+    orgId: string | null;
+    signOut: () => Promise<void>;
+    /** Returns the session JWT for use in API calls via Authorization: Bearer header. */
+    getToken: () => Promise<string | null>;
+}
+/** Clerk-compatible auth hook. Returns key auth identifiers and helpers. */
+declare function useAuth(): UseAuthReturn;
 
 interface SignInProps {
     /** Redirect URL after a successful sign-in. Overrides the provider default. */
     redirectUrl?: string;
-    /** Called with the raw session claims after successful sign-in. */
-    onSuccess?: (sessionId: string) => void;
+    /** Called with the handshake token after successful sign-in. */
+    onSuccess?: (handshakeToken: string) => void;
     onError?: (message: string) => void;
     /** API origin — injected by VaultixProvider via DOM attribute, or pass directly. */
     apiOrigin?: string;
@@ -97,13 +110,31 @@ declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginP
 
 interface SignUpProps {
     redirectUrl?: string;
-    onSuccess?: (sessionId: string) => void;
+    onSuccess?: (handshakeToken: string) => void;
     onError?: (message: string) => void;
     apiOrigin?: string;
     className?: string;
 }
 declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignUpProps): react_jsx_runtime.JSX.Element;
 
+/** Renders children only when the user is signed in and auth is loaded. */
+declare function SignedIn({ children }: {
+    children: React$1.ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+/** Renders children only when the user is signed out and auth is loaded. */
+declare function SignedOut({ children }: {
+    children: React$1.ReactNode;
+}): react_jsx_runtime.JSX.Element | null;
+
+interface RedirectProps {
+    /** Override the default redirect URL. */
+    redirectUrl?: string;
+}
+/** Redirects to /sign-in when the user is not authenticated. */
+declare function RedirectToSignIn({ redirectUrl }: RedirectProps): null;
+/** Redirects to /sign-up when the user is not authenticated. */
+declare function RedirectToSignUp({ redirectUrl }: RedirectProps): null;
+
 interface UserButtonProps {
     /** Show the user's name next to the avatar. Default false. */
     showName?: boolean;
@@ -118,4 +149,4 @@ interface OrganizationSwitcherProps {
 }
 declare function OrganizationSwitcher({ afterSwitchUrl, className, }: OrganizationSwitcherProps): react_jsx_runtime.JSX.Element | null;
 
-export { type ChallengeType, OrganizationSwitcher, type RiskLevel, type SessionClaims, SignIn, SignUp, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useOrganization, useSession, useUser, useVaultix };
+export { type ChallengeType, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, useAuth, useOrganization, useSession, useUser, useVaultix };