azirid-react 0.7.0 → 0.9.0

package/dist/index.d.cts

@@ -1,8 +1,9 @@
 import * as react from 'react';
-import { ReactNode, CSSProperties, FormEvent } from 'react';
+import { CSSProperties, ReactNode, FormEvent } from 'react';
 import * as _tanstack_react_query from '@tanstack/react-query';
 import { UseMutationResult, UseQueryResult } from '@tanstack/react-query';
 import { z } from 'zod';
+import { TenantRole, Environment } from '@azirid/shared';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ClassValue } from 'clsx';
 
@@ -15,9 +16,9 @@ interface AuthUser {
     mfaEnabled?: boolean;
     appId?: string;
     tenantId: string;
-    tenantRole: string;
+    tenantRole: TenantRole | string;
     workspaceId?: string;
-    environment?: 'development' | 'production';
+    environment?: Environment;
     mustChangePassword?: boolean;
     publicMetadata?: Record<string, unknown> | null;
     unsafeMetadata?: Record<string, unknown> | null;
@@ -126,6 +127,14 @@ interface AccessMessages {
         cancel: string;
         processing: string;
     };
+    navigation: {
+        noAccountText: string;
+        signUpLink: string;
+        hasAccountText: string;
+        signInLink: string;
+        forgotPassword: string;
+        backToLogin: string;
+    };
     validation: {
         emailRequired: string;
         emailInvalid: string;
@@ -359,6 +368,101 @@ interface SignupFormProps {
         confirmPasswordPlaceholder?: string;
     };
 }
+type AuthView = 'login' | 'signup' | 'forgot-password' | 'reset-password';
+interface ForgotPasswordFormProps {
+    /** Override the default onSubmit */
+    onSubmit?: (data: {
+        email: string;
+    }) => void | Promise<void>;
+    /** Custom Zod schema for validation */
+    schema?: z.ZodType;
+    /** Show a loading spinner / disable the form */
+    isLoading?: boolean;
+    /** Error message to display */
+    error?: string | null;
+    /** Custom class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: CSSProperties;
+    /** Title displayed above the form */
+    title?: string;
+    /** Subtitle / description below the title */
+    description?: string;
+    /** Logo or branding element rendered above the card */
+    logo?: ReactNode;
+    /** Text for the submit button */
+    submitText?: string;
+    /** Render a footer below the form */
+    footer?: ReactNode;
+    /** Pre-fill the form fields */
+    defaultValues?: {
+        email?: string;
+    };
+}
+interface ResetPasswordFormProps {
+    /** Token from the reset URL */
+    token: string;
+    /** Override the default onSubmit */
+    onSubmit?: (data: {
+        token: string;
+        newPassword: string;
+    }) => void | Promise<void>;
+    /** Custom Zod schema for validation */
+    schema?: z.ZodType;
+    /** Show a loading spinner / disable the form */
+    isLoading?: boolean;
+    /** Error message to display */
+    error?: string | null;
+    /** Custom class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: CSSProperties;
+    /** Title displayed above the form */
+    title?: string;
+    /** Subtitle / description below the title */
+    description?: string;
+    /** Logo or branding element rendered above the card */
+    logo?: ReactNode;
+    /** Text for the submit button */
+    submitText?: string;
+    /** Render a footer below the form */
+    footer?: ReactNode;
+    /** Callback on successful password reset */
+    onSuccess?: () => void;
+}
+interface AuthFormProps {
+    /** Controlled view (parent manages state) */
+    view?: AuthView;
+    /** Callback when navigation links are clicked (controlled mode) */
+    onViewChange?: (view: AuthView) => void;
+    /** Initial view for uncontrolled mode (default: 'login') */
+    defaultView?: AuthView;
+    /** Custom class name for the root element */
+    className?: string;
+    /** Inline styles for the root element */
+    style?: CSSProperties;
+    /** Logo or branding element rendered above the card */
+    logo?: ReactNode;
+    /** Show SSO buttons on login/signup (default: true) */
+    showSocialButtons?: boolean;
+    /** Hide navigation links between views */
+    hideNavigation?: boolean;
+    /** Token for reset-password view */
+    resetToken?: string;
+    /** Default form values passed to child forms */
+    defaultValues?: {
+        email?: string;
+        password?: string;
+    };
+    /** Props forwarded to LoginForm */
+    loginProps?: Omit<LoginFormProps, 'className' | 'style' | 'logo' | 'showSocialButtons' | 'footer' | 'forgotPassword'>;
+    /** Props forwarded to SignupForm */
+    signupProps?: Omit<SignupFormProps, 'className' | 'style' | 'logo' | 'showSocialButtons' | 'footer'>;
+    /** Props forwarded to ForgotPasswordForm */
+    forgotPasswordProps?: Omit<ForgotPasswordFormProps, 'className' | 'style' | 'logo' | 'footer'>;
+    /** Props forwarded to ResetPasswordForm */
+    resetPasswordProps?: Omit<ResetPasswordFormProps, 'className' | 'style' | 'logo' | 'footer' | 'token'>;
+}
 interface FieldError {
     field: string;
     message: string;
@@ -510,12 +614,12 @@ interface TenantWithRole {
     slug: string;
     description?: string | null;
     enabled: boolean;
-    role: 'OWNER' | 'MEMBER';
+    role: TenantRole;
     joinedAt: string;
 }
 interface TenantMemberInfo {
     id: string;
-    role: 'OWNER' | 'MEMBER';
+    role: TenantRole;
     joinedAt: string;
     user: {
         id: string;
@@ -534,6 +638,15 @@ declare const LoginForm: react.ForwardRefExoticComponent<LoginFormProps & react.
 
 declare const SignupForm: react.ForwardRefExoticComponent<SignupFormProps & react.RefAttributes<HTMLFormElement>>;
 
+declare const ForgotPasswordForm: react.ForwardRefExoticComponent<ForgotPasswordFormProps & react.RefAttributes<HTMLFormElement>>;
+
+declare const ResetPasswordForm: react.ForwardRefExoticComponent<ResetPasswordFormProps & react.RefAttributes<HTMLFormElement>>;
+
+declare function AuthForm({ view: controlledView, onViewChange, defaultView, className, style, logo, showSocialButtons, hideNavigation, resetToken, defaultValues, loginProps, signupProps, forgotPasswordProps, resetPasswordProps, }: AuthFormProps): react_jsx_runtime.JSX.Element;
+declare namespace AuthForm {
+    var displayName: string;
+}
+
 interface ReferralCardProps {
     className?: string;
     style?: CSSProperties;
@@ -656,6 +769,8 @@ declare const SUFFIXES: {
     readonly submitTransferProof: "billing/transfer-proof";
     readonly transferProofs: "billing/transfer-proofs";
     readonly payphoneConfirm: "billing/payphone/confirm";
+    readonly passwordResetRequest: "password/reset/request";
+    readonly passwordResetConfirm: "password/reset/confirm";
     readonly referralMe: "referrals/me";
     readonly referralStats: "referrals/stats";
     readonly userTenants: "tenants";
@@ -1442,6 +1557,92 @@ declare function useSwitchTenant(): {
     switchTenant: (tenantId: string) => Promise<void>;
 };
 
+interface PasswordResetRequestData {
+    email: string;
+}
+interface PasswordResetConfirmData {
+    token: string;
+    newPassword: string;
+}
+interface UsePasswordResetOptions {
+    /** Callback after reset email sent */
+    onRequestSuccess?: () => void;
+    /** Callback after password successfully reset */
+    onConfirmSuccess?: () => void;
+    /** Callback on error */
+    onError?: (error: Error) => void;
+}
+interface UsePasswordResetReturn {
+    /** Request a password reset email */
+    request: UseMutationResult<unknown, Error, PasswordResetRequestData>;
+    /** Confirm the password reset with token + new password */
+    confirm: UseMutationResult<unknown, Error, PasswordResetConfirmData>;
+}
+/**
+ * Standalone hook for password reset flow. Requires `<AziridProvider>`.
+ *
+ * @example
+ * ```tsx
+ * const passwordReset = usePasswordReset({
+ *   onRequestSuccess: () => toast.success("Check your email"),
+ *   onConfirmSuccess: () => router.push("/login"),
+ * });
+ *
+ * // Step 1: request reset
+ * passwordReset.request.mutate({ email: "user@test.com" });
+ *
+ * // Step 2: confirm with token from URL
+ * passwordReset.confirm.mutate({ token: "abc", newPassword: "newPass123!" });
+ * ```
+ */
+declare function usePasswordReset(options?: UsePasswordResetOptions): UsePasswordResetReturn;
+
+/**
+ * Options common to all simple mutation hooks created via `createMutationHook`.
+ */
+interface SimpleMutationOptions<TData> {
+    onSuccess?: (data: TData) => void;
+    onError?: (error: Error) => void;
+}
+/**
+ * Configuration for `createMutationHook`.
+ *
+ * @template TData  The response type from the API
+ * @template TInput The input/variables type for the mutation
+ */
+interface MutationHookConfig<TData, TInput> {
+    /** Static mutation key for deduplication / devtools */
+    mutationKey: string[];
+    /**
+     * Derive the mutation function from the AccessClient and input.
+     * Most hooks simply call `client.post<TData>(client.paths.someEndpoint, data)`.
+     */
+    mutationFn: (client: AccessClient, input: TInput) => Promise<TData>;
+}
+/**
+ * Factory that creates a simple `useMutation`-based hook.
+ *
+ * Eliminates the boilerplate of:
+ *   1. Calling `useAccessClient()`
+ *   2. Creating a `useMutation` with `mutationKey`, `mutationFn`, `onSuccess`, `onError`
+ *
+ * The resulting hook has the same return type as `useMutation` (`UseMutationResult`),
+ * preserving full compatibility with TanStack Query.
+ *
+ * @example
+ * ```ts
+ * export const useChangePassword = createMutationHook<
+ *   { updated: boolean },
+ *   ChangePasswordData
+ * >({
+ *   mutationKey: ['azirid-access', 'change-password'],
+ *   mutationFn: (client, data) =>
+ *     client.post<{ updated: boolean }>(client.paths.changePassword, data),
+ * })
+ * ```
+ */
+declare function createMutationHook<TData, TInput = void>(config: MutationHookConfig<TData, TInput>): (options?: SimpleMutationOptions<TData>) => UseMutationResult<TData, Error, TInput>;
+
 declare function useFormState<T extends Record<string, unknown>>(initialValues: T, schema: z.ZodType<unknown, z.ZodTypeDef, unknown>, onSubmit: (values: T) => void | Promise<void>): UseFormReturn<T>;
 
 declare function usePasswordToggle(): {
@@ -1566,6 +1767,64 @@ declare const socialLoginSchema: z.ZodObject<{
     turnstileToken?: string | undefined;
 }>;
 type SocialLoginInput = z.infer<typeof socialLoginSchema>;
+declare function createForgotPasswordSchema(v: AccessMessages['validation']): z.ZodObject<{
+    email: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+}, {
+    email: string;
+}>;
+declare const forgotPasswordSchema: z.ZodObject<{
+    email: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    email: string;
+}, {
+    email: string;
+}>;
+type ForgotPasswordInput = z.infer<typeof forgotPasswordSchema>;
+declare function createResetPasswordConfirmSchema(v: AccessMessages['validation']): z.ZodEffects<z.ZodObject<{
+    token: z.ZodString;
+    newPassword: z.ZodString;
+    confirmPassword: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}>, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}>;
+declare const resetPasswordConfirmSchema: z.ZodEffects<z.ZodObject<{
+    token: z.ZodString;
+    newPassword: z.ZodString;
+    confirmPassword: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}>, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}, {
+    token: string;
+    newPassword: string;
+    confirmPassword: string;
+}>;
+type ResetPasswordConfirmInput = z.infer<typeof resetPasswordConfirmSchema>;
 declare const passkeyRegisterStartSchema: z.ZodObject<{
     deviceName: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
@@ -1580,6 +1839,30 @@ declare function cn(...inputs: ClassValue[]): string;
 /** Remove injected styles from the DOM (useful when embedding in host apps). */
 declare function removeStyles(): void;
 
+interface PricingCardProps {
+    plan: BillingPlan;
+    isCurrentPlan: boolean;
+    isCheckoutPending: boolean;
+    onSelect: (plan: BillingPlan) => void;
+}
+
+interface PricingFeatureListProps {
+    features: string[];
+}
+
+interface ProviderModalProps {
+    providers: AvailableProvider[];
+    isPending: boolean;
+    onSelect: (provider: PaymentProviderType) => void;
+    onClose: () => void;
+    labels?: Record<string, string>;
+}
+interface TransferModalProps {
+    data: CheckoutResponse;
+    onClose: () => void;
+    labels?: Record<string, string>;
+}
+
 declare global {
     interface Window {
         PPaymentButtonBox: new (config: Record<string, unknown>) => {
@@ -1604,4 +1887,4 @@ interface SessionSyncOptions {
 
 declare const SDK_VERSION: string;
 
-export { type AccessClient, type AccessClientConfig, type AccessMessages, type ApiError, type AppBranding, type AuthPaths, type AuthState, type AuthSuccessResponse, type AuthUser, type AvailableProvider, type AziridContextValue, AziridProvider, type AziridProviderProps, BASE_PATHS, type BillingInvoice, type BillingPlan, type BootstrapResponse, type ChangePasswordData, type ChangePasswordInput, CheckoutButton, type CheckoutButtonProps, type CheckoutParams, type CheckoutResponse, type CreateTenantData, type FieldError, InvoiceList, type InvoiceListProps, type LoginData, LoginForm, type LoginFormProps, type LoginInput, type MagicLinkRequestData, type MagicLinkRequestInput, type MagicLinkVerifyData, type MagicLinkVerifyInput, PATHS, type PasskeyItem, type PasskeyLoginData, type PasskeyLoginStartData, type PasskeyLoginStartResponse, type PasskeyLoginVerifyData, type PasskeyRegisterStartData, type PasskeyRegisterStartInput, type PasskeyRegisterStartResponse, type PasskeyRegisterVerifyData, PayButton, type PayButtonProps, type PaymentIntent, type PaymentProviderType, PayphoneCallback, type PayphoneCallbackProps, type PayphoneConfirmParams, type PayphoneConfirmResult, type PayphoneModalProps, type PayphoneWidgetConfig, PricingTable, type PricingTableProps, ReferralCard, type ReferralCardProps, type ReferralInfo, type ReferralItem, ReferralStats, type ReferralStatsData, type ReferralStatsProps, type RegisterPasskeyData, SDK_VERSION, type SessionSyncOptions, type SignupData, SignupForm, type SignupFormProps, type SignupInput, type SocialLoginData, type SocialLoginInput, type SubmitTransferProofData, SubscriptionBadge, type SubscriptionBadgeProps, type SupportedLocale, type TenantMemberInfo, type TenantWithRole, type TransferProof, type UseBootstrapOptions, type UseBootstrapReturn, type UseChangePasswordOptions, type UseChangePasswordReturn, type UseCheckoutOptions, type UseFormReturn, type UseLoginOptions, type UseLoginReturn, type UseLogoutOptions, type UseLogoutReturn, type UseMagicLinkOptions, type UseMagicLinkReturn, type UsePasskeysOptions, type UsePasskeysReturn, type UsePayphoneConfirmOptions, type UseRefreshOptions, type UseRefreshReturn, type UseSessionOptions, type UseSessionReturn, type UseSignupOptions, type UseSignupReturn, type UseSocialLoginOptions, type UseSocialLoginReturn, type UserSubscription, buildPaths, changePasswordSchema, cn, createAccessClient, createLoginSchema, createSignupSchema, en, es, isAuthError, loginSchema, magicLinkRequestSchema, magicLinkVerifySchema, passkeyRegisterStartSchema, removeStyles, resolveMessages, signupSchema, socialLoginSchema, useAccessClient, useAzirid, useBootstrap, useBranding, useChangePassword, useCheckout, useFormState, useInvoices, useLogin, useLogout, useMagicLink, useMessages, usePasskeys, usePasswordToggle, usePaymentProviders, usePayphoneConfirm, usePlans, useReferral, useReferralStats, useRefresh, useSession, useSignup, useSocialLogin, useSubmitTransferProof, useSubscription, useSwitchTenant, useTenantMembers, useTenants, useTransferProofs };
+export { type AccessClient, type AccessClientConfig, type AccessMessages, type ApiError, type AppBranding, AuthForm, type AuthFormProps, type AuthPaths, type AuthState, type AuthSuccessResponse, type AuthUser, type AuthView, type AvailableProvider, type AziridContextValue, AziridProvider, type AziridProviderProps, BASE_PATHS, type BillingInvoice, type BillingPlan, type BootstrapResponse, type ChangePasswordData, type ChangePasswordInput, CheckoutButton, type CheckoutButtonProps, type CheckoutParams, type CheckoutResponse, type CreateTenantData, type FieldError, ForgotPasswordForm, type ForgotPasswordFormProps, type ForgotPasswordInput, InvoiceList, type InvoiceListProps, type LoginData, LoginForm, type LoginFormProps, type LoginInput, type MagicLinkRequestData, type MagicLinkRequestInput, type MagicLinkVerifyData, type MagicLinkVerifyInput, type MutationHookConfig, PATHS, type PasskeyItem, type PasskeyLoginData, type PasskeyLoginStartData, type PasskeyLoginStartResponse, type PasskeyLoginVerifyData, type PasskeyRegisterStartData, type PasskeyRegisterStartInput, type PasskeyRegisterStartResponse, type PasskeyRegisterVerifyData, type PasswordResetConfirmData, type PasswordResetRequestData, PayButton, type PayButtonProps, type PaymentIntent, type PaymentProviderType, PayphoneCallback, type PayphoneCallbackProps, type PayphoneConfirmParams, type PayphoneConfirmResult, type PayphoneModalProps, type PayphoneWidgetConfig, type PricingCardProps, type PricingFeatureListProps, PricingTable, type PricingTableProps, type ProviderModalProps, ReferralCard, type ReferralCardProps, type ReferralInfo, type ReferralItem, ReferralStats, type ReferralStatsData, type ReferralStatsProps, type RegisterPasskeyData, type ResetPasswordConfirmInput, ResetPasswordForm, type ResetPasswordFormProps, SDK_VERSION, type SessionSyncOptions, type SignupData, SignupForm, type SignupFormProps, type SignupInput, type SimpleMutationOptions, type SocialLoginData, type SocialLoginInput, type SubmitTransferProofData, SubscriptionBadge, type SubscriptionBadgeProps, type SupportedLocale, type TenantMemberInfo, type TenantWithRole, type TransferModalProps, type TransferProof, type UseBootstrapOptions, type UseBootstrapReturn, type UseChangePasswordOptions, type UseChangePasswordReturn, type UseCheckoutOptions, type UseFormReturn, type UseLoginOptions, type UseLoginReturn, type UseLogoutOptions, type UseLogoutReturn, type UseMagicLinkOptions, type UseMagicLinkReturn, type UsePasskeysOptions, type UsePasskeysReturn, type UsePasswordResetOptions, type UsePasswordResetReturn, type UsePayphoneConfirmOptions, type UseRefreshOptions, type UseRefreshReturn, type UseSessionOptions, type UseSessionReturn, type UseSignupOptions, type UseSignupReturn, type UseSocialLoginOptions, type UseSocialLoginReturn, type UserSubscription, buildPaths, changePasswordSchema, cn, createAccessClient, createForgotPasswordSchema, createLoginSchema, createMutationHook, createResetPasswordConfirmSchema, createSignupSchema, en, es, forgotPasswordSchema, isAuthError, loginSchema, magicLinkRequestSchema, magicLinkVerifySchema, passkeyRegisterStartSchema, removeStyles, resetPasswordConfirmSchema, resolveMessages, signupSchema, socialLoginSchema, useAccessClient, useAzirid, useBootstrap, useBranding, useChangePassword, useCheckout, useFormState, useInvoices, useLogin, useLogout, useMagicLink, useMessages, usePasskeys, usePasswordReset, usePasswordToggle, usePaymentProviders, usePayphoneConfirm, usePlans, useReferral, useReferralStats, useRefresh, useSession, useSignup, useSocialLogin, useSubmitTransferProof, useSubscription, useSwitchTenant, useTenantMembers, useTenants, useTransferProofs };