import { LiteralString } from "./helper.mjs"; import { BetterAuthPlugin } from "./plugin.mjs"; import { BetterAuthOptions } from "./init-options.mjs"; import { BetterFetch, BetterFetchOption, BetterFetchPlugin } from "@better-fetch/fetch"; import { Atom, WritableAtom } from "nanostores"; //#region src/types/plugin-client.d.ts interface ClientStore { notify: (signal: string) => void; listen: (signal: string, listener: () => void) => void; atoms: Record>; } type ClientAtomListener = { matcher: (path: string) => boolean; signal: "$sessionSignal" | Omit; }; /** * Better-Fetch options but with additional options for the auth-client. */ type ClientFetchOption = any, Params extends Record | Array | undefined = any, Res = any> = BetterFetchOption & { /** * Certain endpoints, upon successful response, will trigger atom signals and thus rerendering all hooks related to that atom. * * This option is useful when you want to skip hook rerenders. */ disableSignal?: boolean | undefined; }; interface RevalidateOptions { /** * A time interval (in seconds) after which the session will be re-fetched. * If set to `0` (default), the session is not polled. * * This helps prevent session expiry during idle periods by periodically * refreshing the session. * * @default 0 */ refetchInterval?: number | undefined; /** * Automatically refetch the session when the user switches back to the window/tab. * This option activates this behavior if set to `true` (default). * * Prevents expired sessions when users switch tabs and come back later. * * @default true */ refetchOnWindowFocus?: boolean | undefined; /** * Set to `false` to stop polling when the device has no internet access * (determined by `navigator.onLine`). * * @default false * @see https://developer.mozilla.org/en-US/docs/Web/API/NavigatorOnLine/onLine */ refetchWhenOffline?: boolean | undefined; } interface BetterAuthClientOptions { fetchOptions?: ClientFetchOption | undefined; plugins?: BetterAuthClientPlugin[] | undefined; baseURL?: string | undefined; basePath?: string | undefined; disableDefaultFetchPlugins?: boolean | undefined; $InferAuth?: BetterAuthOptions | undefined; sessionOptions?: RevalidateOptions | undefined; } interface BetterAuthClientPlugin { id: LiteralString; /** * only used for type inference. don't pass the * actual plugin */ $InferServerPlugin?: BetterAuthPlugin | undefined; /** * Custom actions */ getActions?: ($fetch: BetterFetch, $store: ClientStore, /** * better-auth client options */ options: BetterAuthClientOptions | undefined) => Record; /** * State atoms that'll be resolved by each framework * auth store. */ getAtoms?: (($fetch: BetterFetch) => Record>) | undefined; /** * specify path methods for server plugin inferred * endpoints to force a specific method. */ pathMethods?: Record | undefined; /** * Better fetch plugins */ fetchPlugins?: BetterFetchPlugin[] | undefined; /** * a list of recaller based on a matcher function. * The signal name needs to match a signal in this * plugin or any plugin the user might have added. */ atomListeners?: ClientAtomListener[] | undefined; } //#endregion export { BetterAuthClientOptions, BetterAuthClientPlugin, ClientAtomListener, ClientFetchOption, ClientStore }; //# sourceMappingURL=plugin-client.d.mts.map