@vaultix.ai/react 0.3.3 → 0.3.5

package/dist/index.d.mts

@@ -1,6 +1,12 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1 from 'react';
 
+type AuthMethod = "password" | "magic_link" | "passkey";
+type OAuthProvider = "google" | "github" | "meta" | "linkedin" | "x" | "threads";
+interface AppConfig {
+    methods: AuthMethod[];
+    providers: OAuthProvider[];
+}
 type RiskLevel = "low" | "medium" | "high" | "critical";
 type ChallengeType = "passkey" | "magic_link" | "password" | "totp" | "sms_otp" | "email_otp";
 interface SessionClaims {
@@ -76,6 +82,11 @@ interface VaultixContextValue {
     isSignedIn: boolean;
     /** Resolved API origin derived from the publishable key. */
     apiOrigin: string;
+    /**
+     * Per-app auth configuration. Null while loading, then set from /api/v1/app/config.
+     * Controls which login methods and OAuth providers are rendered by <SignIn /> and <SignUp />.
+     */
+    appConfig: AppConfig | null;
     signOut: (redirectUrl?: string) => Promise<void>;
     /** Update the current user's profile. Resolves with the updated user. */
     updateUser: (params: UpdateUserParams) => Promise<VaultixUser>;
@@ -87,6 +98,28 @@ interface VaultixContextValue {
      */
     connectPlatform: (provider: string, options?: ConnectPlatformOptions) => void;
 }
+interface VaultixAppearanceVariables {
+    /** Primary accent color — used for buttons, focus rings, and icons. Accepts any CSS color value. */
+    colorPrimary?: string;
+    /** Card / form background. Default: dark glass (rgba(22,27,45,0.92)). */
+    colorBackground?: string;
+    /** Primary text color. Default: rgba(255,255,255,0.9). */
+    colorText?: string;
+    /** Secondary / muted text color. Default: #475569. */
+    colorTextMuted?: string;
+}
+interface VaultixAppearance {
+    variables?: VaultixAppearanceVariables;
+}
+interface PlatformConnectResult {
+    provider: string;
+    platformUserId?: string;
+    username?: string;
+    accessToken?: string;
+    scope?: string;
+    /** Full decoded JWT payload. */
+    raw: Record<string, unknown>;
+}
 interface VaultixProviderProps {
     publishableKey: string;
     /** Required for smritix_ keys. The base URL of your auth-engine (no trailing slash). */
@@ -132,6 +165,28 @@ interface UseAuthReturn {
     /** Returns the session JWT for use in API calls via Authorization: Bearer header. */
     getToken: () => Promise<string | null>;
 }
+interface UsePlatformConnectReturn {
+    /** Redirect the user to the provider's OAuth authorization page. */
+    connect: (overrides?: ConnectPlatformOptions) => void;
+    /**
+     * Non-null immediately after the OAuth callback lands on the current page.
+     * The token is parsed from `__vaultix_connect` in the URL and then removed
+     * from the address bar. Null if the user has not connected yet this page load.
+     */
+    connectedAccount: PlatformConnectResult | null;
+}
+/**
+ * Hook for connecting a social/platform account via Vaultix OAuth.
+ *
+ * @example
+ * const { connect, connectedAccount } = usePlatformConnect("google", {
+ *   scopes: ["https://www.googleapis.com/auth/youtube.upload"],
+ * });
+ *
+ * // After connect() → user returns with __vaultix_connect in URL
+ * // connectedAccount.accessToken has the token; URL is cleaned automatically
+ */
+declare function usePlatformConnect(provider: string, defaultOptions?: ConnectPlatformOptions): UsePlatformConnectReturn;
 /** Returns key auth identifiers and helpers. */
 declare function useAuth(): UseAuthReturn;
 
@@ -144,8 +199,10 @@ interface SignInProps {
     /** API origin — injected by VaultixProvider via DOM attribute, or pass directly. */
     apiOrigin?: string;
     className?: string;
+    /** Override colors and card background. */
+    appearance?: VaultixAppearance;
 }
-declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignInProps): react_jsx_runtime.JSX.Element;
+declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, appearance, }: SignInProps): react_jsx_runtime.JSX.Element;
 
 interface SignUpProps {
     redirectUrl?: string;
@@ -153,8 +210,10 @@ interface SignUpProps {
     onError?: (message: string) => void;
     apiOrigin?: string;
     className?: string;
+    /** Override colors and card background. */
+    appearance?: VaultixAppearance;
 }
-declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignUpProps): react_jsx_runtime.JSX.Element;
+declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, appearance, }: SignUpProps): react_jsx_runtime.JSX.Element;
 
 /** Renders children only when the user is signed in and auth is loaded. */
 declare function SignedIn({ children }: {
@@ -192,4 +251,4 @@ declare function getStoredToken(): string | null;
 /** Clears the stored session JWT. Call on 401 so the user is prompted to sign in again. */
 declare function clearStoredToken(): void;
 
-export { type ChallengeType, type ConnectPlatformOptions, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, type UpdateUserParams, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, useSession, useUser, useVaultix };
+export { type AppConfig, type AuthMethod, type ChallengeType, type ConnectPlatformOptions, type OAuthProvider, OrganizationSwitcher, type PlatformConnectResult, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, type UpdateUserParams, UserButton, type VaultixAppearance, type VaultixAppearanceVariables, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, usePlatformConnect, useSession, useUser, useVaultix };

package/dist/index.d.ts

@@ -1,6 +1,12 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React$1 from 'react';
 
+type AuthMethod = "password" | "magic_link" | "passkey";
+type OAuthProvider = "google" | "github" | "meta" | "linkedin" | "x" | "threads";
+interface AppConfig {
+    methods: AuthMethod[];
+    providers: OAuthProvider[];
+}
 type RiskLevel = "low" | "medium" | "high" | "critical";
 type ChallengeType = "passkey" | "magic_link" | "password" | "totp" | "sms_otp" | "email_otp";
 interface SessionClaims {
@@ -76,6 +82,11 @@ interface VaultixContextValue {
     isSignedIn: boolean;
     /** Resolved API origin derived from the publishable key. */
     apiOrigin: string;
+    /**
+     * Per-app auth configuration. Null while loading, then set from /api/v1/app/config.
+     * Controls which login methods and OAuth providers are rendered by <SignIn /> and <SignUp />.
+     */
+    appConfig: AppConfig | null;
     signOut: (redirectUrl?: string) => Promise<void>;
     /** Update the current user's profile. Resolves with the updated user. */
     updateUser: (params: UpdateUserParams) => Promise<VaultixUser>;
@@ -87,6 +98,28 @@ interface VaultixContextValue {
      */
     connectPlatform: (provider: string, options?: ConnectPlatformOptions) => void;
 }
+interface VaultixAppearanceVariables {
+    /** Primary accent color — used for buttons, focus rings, and icons. Accepts any CSS color value. */
+    colorPrimary?: string;
+    /** Card / form background. Default: dark glass (rgba(22,27,45,0.92)). */
+    colorBackground?: string;
+    /** Primary text color. Default: rgba(255,255,255,0.9). */
+    colorText?: string;
+    /** Secondary / muted text color. Default: #475569. */
+    colorTextMuted?: string;
+}
+interface VaultixAppearance {
+    variables?: VaultixAppearanceVariables;
+}
+interface PlatformConnectResult {
+    provider: string;
+    platformUserId?: string;
+    username?: string;
+    accessToken?: string;
+    scope?: string;
+    /** Full decoded JWT payload. */
+    raw: Record<string, unknown>;
+}
 interface VaultixProviderProps {
     publishableKey: string;
     /** Required for smritix_ keys. The base URL of your auth-engine (no trailing slash). */
@@ -132,6 +165,28 @@ interface UseAuthReturn {
     /** Returns the session JWT for use in API calls via Authorization: Bearer header. */
     getToken: () => Promise<string | null>;
 }
+interface UsePlatformConnectReturn {
+    /** Redirect the user to the provider's OAuth authorization page. */
+    connect: (overrides?: ConnectPlatformOptions) => void;
+    /**
+     * Non-null immediately after the OAuth callback lands on the current page.
+     * The token is parsed from `__vaultix_connect` in the URL and then removed
+     * from the address bar. Null if the user has not connected yet this page load.
+     */
+    connectedAccount: PlatformConnectResult | null;
+}
+/**
+ * Hook for connecting a social/platform account via Vaultix OAuth.
+ *
+ * @example
+ * const { connect, connectedAccount } = usePlatformConnect("google", {
+ *   scopes: ["https://www.googleapis.com/auth/youtube.upload"],
+ * });
+ *
+ * // After connect() → user returns with __vaultix_connect in URL
+ * // connectedAccount.accessToken has the token; URL is cleaned automatically
+ */
+declare function usePlatformConnect(provider: string, defaultOptions?: ConnectPlatformOptions): UsePlatformConnectReturn;
 /** Returns key auth identifiers and helpers. */
 declare function useAuth(): UseAuthReturn;
 
@@ -144,8 +199,10 @@ interface SignInProps {
     /** API origin — injected by VaultixProvider via DOM attribute, or pass directly. */
     apiOrigin?: string;
     className?: string;
+    /** Override colors and card background. */
+    appearance?: VaultixAppearance;
 }
-declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignInProps): react_jsx_runtime.JSX.Element;
+declare function SignIn({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, appearance, }: SignInProps): react_jsx_runtime.JSX.Element;
 
 interface SignUpProps {
     redirectUrl?: string;
@@ -153,8 +210,10 @@ interface SignUpProps {
     onError?: (message: string) => void;
     apiOrigin?: string;
     className?: string;
+    /** Override colors and card background. */
+    appearance?: VaultixAppearance;
 }
-declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, }: SignUpProps): react_jsx_runtime.JSX.Element;
+declare function SignUp({ redirectUrl, onSuccess, onError, apiOrigin: apiOriginProp, className, appearance, }: SignUpProps): react_jsx_runtime.JSX.Element;
 
 /** Renders children only when the user is signed in and auth is loaded. */
 declare function SignedIn({ children }: {
@@ -192,4 +251,4 @@ declare function getStoredToken(): string | null;
 /** Clears the stored session JWT. Call on 401 so the user is prompted to sign in again. */
 declare function clearStoredToken(): void;
 
-export { type ChallengeType, type ConnectPlatformOptions, OrganizationSwitcher, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, type UpdateUserParams, UserButton, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, useSession, useUser, useVaultix };
+export { type AppConfig, type AuthMethod, type ChallengeType, type ConnectPlatformOptions, type OAuthProvider, OrganizationSwitcher, type PlatformConnectResult, RedirectToSignIn, RedirectToSignUp, type RiskLevel, type SessionClaims, SignIn, SignUp, SignedIn, SignedOut, type UpdateUserParams, UserButton, type VaultixAppearance, type VaultixAppearanceVariables, type VaultixContextValue, type VaultixOrganization, VaultixProvider, type VaultixProviderProps, type VaultixSession, type VaultixUser, clearStoredToken, getStoredToken, useAuth, useOrganization, usePlatformConnect, useSession, useUser, useVaultix };