ab-ecosystem-sso 0.1.11 → 0.1.13

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { ReactNode } from 'react';
 
-export declare function AccountSettings({ open, onOpenChange, initialSection, data, title, projectId, token, apiBaseUrl, onSaveProfile, onUpdateWhatsApp, onChangePassword, onToggleTwoFactor, onRevokeSession, onAddFunds, onChangePlan, onLogout, }: AccountSettingsProps): JSX_2.Element | null;
+export declare function AccountSettings({ open, onOpenChange, initialSection, syncUrlHash, data, title, projectId, token, apiBaseUrl, onSaveProfile, onUpdateWhatsApp, onChangePassword, onToggleTwoFactor, onRevokeSession, onAddFunds, onChangePlan, onLogout, }: AccountSettingsProps): JSX_2.Element | null;
 
 export declare interface AccountSettingsData {
     user: {
@@ -85,6 +85,12 @@ export declare interface AccountSettingsProps {
     onOpenChange: (open: boolean) => void;
     /** Section to show first. Defaults to "general". */
     initialSection?: AccountSettingsSection;
+    /**
+     * Sync the open state + active section to the URL hash as `#settings-<section>`,
+     * so a page refresh re-opens the modal on the same section. The hash is cleared
+     * when the modal closes. Defaults to `true`; set `false` to leave the URL alone.
+     */
+    syncUrlHash?: boolean;
     /** Override any slice of the built-in sample data. Provided slices replace the defaults. */
     data?: Partial<AccountSettingsData>;
     /** Modal heading shown above the nav. Defaults to "Settings". */
@@ -224,6 +230,10 @@ export declare interface CreditWallet {
     rechargeable: boolean;
 }
 
+declare function fetchAuthConfig(projectId: string, apiBaseUrl?: string): Promise<AuthConfig>;
+export { fetchAuthConfig }
+export { fetchAuthConfig as getAuthConfig }
+
 export declare function ForgotPassword(props: ForgotPasswordProps): JSX_2.Element;
 
 export declare interface ForgotPasswordProps extends AuthComponentBaseProps {
@@ -384,6 +394,12 @@ export declare type OpenAccountSettingsOptions = Omit<AccountSettingsProps, "ope
     onClose?: () => void;
 };
 
+/**
+ * Reads the current URL hash and returns the settings section it encodes, or
+ * `null` if the hash isn't a `#settings-<section>` value we recognise.
+ */
+export declare function parseSettingsHash(): AccountSettingsSection | null;
+
 export declare interface ProfileFormValues {
     firstName: string;
     lastName: string;
@@ -400,6 +416,19 @@ export declare interface ProfileFormValues {
     language: string;
 }
 
+/**
+ * Re-opens the Account Settings modal if the current URL hash points at it
+ * (`#settings-<section>`) — call this once on app load so an imperatively-opened
+ * modal survives a page refresh. Returns the modal handle if it was opened, or
+ * `null` when there's no settings hash to restore.
+ *
+ *   import { restoreAccountSettings } from "ab-ecosystem-sso";
+ *   useEffect(() => { restoreAccountSettings({ projectId, token, apiBaseUrl }); }, []);
+ *
+ * The section comes from the hash; any `initialSection` in `options` is ignored.
+ */
+export declare function restoreAccountSettings(options?: OpenAccountSettingsOptions): AccountSettingsHandle | null;
+
 declare interface SessionContextValue {
     isAuthenticated: boolean;
     isValidating: boolean;
@@ -424,6 +453,9 @@ declare interface SessionProviderProps {
     children: ReactNode;
 }
 
+/** Every section that can appear in the hash. Order is not significant. */
+export declare const SETTINGS_SECTIONS: AccountSettingsSection[];
+
 export declare function Signup(props: SignupProps): JSX_2.Element;
 
 export declare interface SignupProps extends AuthComponentBaseProps {
@@ -482,6 +514,58 @@ export declare interface UserWallets {
 
 export declare function useSession(): SessionContextValue;
 
+/**
+ * Email-verification screen for a `/verify/:token` route.
+ *
+ *   <VerifyEmail
+ *     projectId="…"
+ *     token={params.token}
+ *     onVerified={() => navigate("/login")}
+ *     onLoginClick={() => navigate("/login")}
+ *     onSignupClick={() => navigate("/signup")}
+ *   />
+ */
+export declare function VerifyEmail(props: VerifyEmailProps): JSX_2.Element;
+
+/**
+ * POST /auth/verify-email — confirms an email address using the token from the
+ * verification link, plus a captcha token when the project requires one.
+ *
+ * The endpoint can answer HTTP 200 with `{ success: false }`, so a successful
+ * verification requires BOTH a 2xx status and `success === true`; anything else
+ * throws AuthApiError.
+ */
+export declare function verifyEmailApi(projectId: string, data: VerifyEmailRequest, apiBaseUrl?: string): Promise<VerifyEmailResponse>;
+
+/**
+ * Email-verification screen for a `/verify/:token` route. `onSuccess` doesn't
+ * apply here (no session is created), so it's omitted in favour of `onVerified`.
+ */
+export declare interface VerifyEmailProps extends Omit<AuthComponentBaseProps, "onSuccess"> {
+    /**
+     * The verification token from the `/verify/:token` route — pass it from your
+     * router's params. Falls back to the last segment of `window.location.pathname`.
+     */
+    token?: string;
+    /** Called once the email is verified — send the user to your login route here. */
+    onVerified?: () => void;
+    /** Navigate to your login route (shown on success and on failure). */
+    onLoginClick?: () => void;
+    /** Navigate to your signup route (shown on failure). */
+    onSignupClick?: () => void;
+}
+
+export declare interface VerifyEmailRequest {
+    /** The verification token from the emailed link (the `/verify/:token` path param). */
+    token: string;
+    captchaToken?: string;
+}
+
+export declare interface VerifyEmailResponse {
+    success: boolean;
+    message?: string;
+}
+
 export declare interface VerifyTwoFactorRequest {
     email: string;
     password: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ab-ecosystem-sso",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "main": "dist/ab-ecosystem-sso.cjs",
   "module": "dist/ab-ecosystem-sso.js",