@better-auth/expo 1.4.0-beta.9 → 1.4.0

package/dist/client.d.mts

@@ -1,113 +1,167 @@
-import * as better_auth_types from 'better-auth/types';
-import * as _better_fetch_fetch from '@better-fetch/fetch';
-import { BetterFetchOption } from '@better-fetch/fetch';
+import * as _better_fetch_fetch0 from "@better-fetch/fetch";
+import { ClientFetchOption, ClientStore } from "@better-auth/core";
+import { FocusManager, OnlineManager } from "better-auth/client";
 
+//#region src/focus-manager.d.ts
+declare function setupExpoFocusManager(): FocusManager;
+//#endregion
+//#region src/online-manager.d.ts
+declare function setupExpoOnlineManager(): OnlineManager;
+//#endregion
+//#region src/client.d.ts
 interface CookieAttributes {
-    value: string;
-    expires?: Date;
-    "max-age"?: number;
-    domain?: string;
-    path?: string;
-    secure?: boolean;
-    httpOnly?: boolean;
-    sameSite?: "Strict" | "Lax" | "None";
+  value: string;
+  expires?: Date | undefined;
+  "max-age"?: number | undefined;
+  domain?: string | undefined;
+  path?: string | undefined;
+  secure?: boolean | undefined;
+  httpOnly?: boolean | undefined;
+  sameSite?: ("Strict" | "Lax" | "None") | undefined;
 }
 declare function parseSetCookieHeader(header: string): Map<string, CookieAttributes>;
 interface ExpoClientOptions {
-    scheme?: string;
-    storage: {
-        setItem: (key: string, value: string) => any;
-        getItem: (key: string) => string | null;
-    };
-    storagePrefix?: string;
-    disableCache?: boolean;
+  scheme?: string | undefined;
+  storage: {
+    setItem: (key: string, value: string) => any;
+    getItem: (key: string) => string | null;
+  };
+  /**
+   * Prefix for local storage keys (e.g., "my-app_cookie", "my-app_session_data")
+   * @default "better-auth"
+   */
+  storagePrefix?: string | undefined;
+  /**
+   * Prefix(es) for server cookie names to filter (e.g., "better-auth.session_token")
+   * This is used to identify which cookies belong to better-auth to prevent
+   * infinite refetching when third-party cookies are set.
+   * Can be a single string or an array of strings to match multiple prefixes.
+   * @default "better-auth"
+   * @example "better-auth"
+   * @example ["better-auth", "my-app"]
+   */
+  cookiePrefix?: string | string[] | undefined;
+  disableCache?: boolean | undefined;
 }
-declare function getSetCookie(header: string, prevCookie?: string): string;
+declare function getSetCookie(header: string, prevCookie?: string | undefined): string;
 declare function getCookie(cookie: string): string;
+/**
+ * Check if the Set-Cookie header contains better-auth cookies.
+ * This prevents infinite refetching when non-better-auth cookies (like third-party cookies) change.
+ *
+ * Supports multiple cookie naming patterns:
+ * - Default: "better-auth.session_token", "better-auth-passkey", "__Secure-better-auth.session_token"
+ * - Custom prefix: "myapp.session_token", "myapp-passkey", "__Secure-myapp.session_token"
+ * - Custom full names: "my_custom_session_token", "custom_session_data"
+ * - No prefix (cookiePrefix=""): matches any cookie with known suffixes
+ * - Multiple prefixes: ["better-auth", "my-app"] matches cookies starting with any of the prefixes
+ *
+ * @param setCookieHeader - The Set-Cookie header value
+ * @param cookiePrefix - The cookie prefix(es) to check for. Can be a string, array of strings, or empty string.
+ * @returns true if the header contains better-auth cookies, false otherwise
+ */
+declare function hasBetterAuthCookies(setCookieHeader: string, cookiePrefix: string | string[]): boolean;
+/**
+ * Expo secure store does not support colons in the keys.
+ * This function replaces colons with underscores.
+ *
+ * @see https://github.com/better-auth/better-auth/issues/5426
+ *
+ * @param name cookie name to be saved in the storage
+ * @returns normalized cookie name
+ */
+declare function normalizeCookieName(name: string): string;
+declare function storageAdapter(storage: {
+  getItem: (name: string) => string | null;
+  setItem: (name: string, value: string) => void;
+}): {
+  getItem: (name: string) => string | null;
+  setItem: (name: string, value: string) => void;
+};
 declare const expoClient: (opts: ExpoClientOptions) => {
-    id: "expo";
-    getActions(_: _better_fetch_fetch.BetterFetch, $store: better_auth_types.ClientStore): {
-        /**
-         * Get the stored cookie.
-         *
-         * You can use this to get the cookie stored in the device and use it in your fetch
-         * requests.
-         *
-         * @example
-         * ```ts
-         * const cookie = client.getCookie();
-         * fetch("https://api.example.com", {
-         * 	headers: {
-         * 		cookie,
-         * 	},
-         * });
-         */
-        getCookie: () => string;
+  id: "expo";
+  getActions(_: _better_fetch_fetch0.BetterFetch, $store: ClientStore): {
+    /**
+     * Get the stored cookie.
+     *
+     * You can use this to get the cookie stored in the device and use it in your fetch
+     * requests.
+     *
+     * @example
+     * ```ts
+     * const cookie = client.getCookie();
+     * fetch("https://api.example.com", {
+     * 	headers: {
+     * 		cookie,
+     * 	},
+     * });
+     */
+    getCookie: () => string;
+  };
+  fetchPlugins: {
+    id: string;
+    name: string;
+    hooks: {
+      onSuccess(context: _better_fetch_fetch0.SuccessContext<any>): Promise<void>;
     };
-    fetchPlugins: {
-        id: string;
-        name: string;
-        hooks: {
-            onSuccess(context: _better_fetch_fetch.SuccessContext<any>): Promise<void>;
-        };
-        init(url: string, options: {
-            cache?: RequestCache | undefined;
-            credentials?: RequestCredentials | undefined;
-            headers?: (HeadersInit & (HeadersInit | {
-                accept: "application/json" | "text/plain" | "application/octet-stream";
-                "content-type": "application/json" | "text/plain" | "application/x-www-form-urlencoded" | "multipart/form-data" | "application/octet-stream";
-                authorization: "Bearer" | "Basic";
-            })) | undefined;
-            integrity?: string | undefined;
-            keepalive?: boolean | undefined;
-            method?: string | undefined;
-            mode?: RequestMode | undefined;
-            priority?: RequestPriority | undefined;
-            redirect?: RequestRedirect | undefined;
-            referrer?: string | undefined;
-            referrerPolicy?: ReferrerPolicy | undefined;
-            signal?: (AbortSignal | null) | undefined;
-            window?: null | undefined;
-            onRequest?: (<T extends Record<string, any>>(context: _better_fetch_fetch.RequestContext<T>) => Promise<_better_fetch_fetch.RequestContext | void> | _better_fetch_fetch.RequestContext | void) | undefined;
-            onResponse?: ((context: _better_fetch_fetch.ResponseContext) => Promise<Response | void | _better_fetch_fetch.ResponseContext> | Response | _better_fetch_fetch.ResponseContext | void) | undefined;
-            onSuccess?: ((context: _better_fetch_fetch.SuccessContext<any>) => Promise<void> | void) | undefined;
-            onError?: ((context: _better_fetch_fetch.ErrorContext) => Promise<void> | void) | undefined;
-            onRetry?: ((response: _better_fetch_fetch.ResponseContext) => Promise<void> | void) | undefined;
-            hookOptions?: {
-                cloneResponse?: boolean;
-            } | undefined;
-            timeout?: number | undefined;
-            customFetchImpl?: _better_fetch_fetch.FetchEsque | undefined;
-            plugins?: _better_fetch_fetch.BetterFetchPlugin[] | undefined;
-            baseURL?: string | undefined;
-            throw?: boolean | undefined;
-            auth?: ({
-                type: "Bearer";
-                token: string | Promise<string | undefined> | (() => string | Promise<string | undefined> | undefined) | undefined;
-            } | {
-                type: "Basic";
-                username: string | (() => string | undefined) | undefined;
-                password: string | (() => string | undefined) | undefined;
-            } | {
-                type: "Custom";
-                prefix: string | (() => string | undefined) | undefined;
-                value: string | (() => string | undefined) | undefined;
-            }) | undefined;
-            body?: any;
-            query?: any;
-            params?: any;
-            duplex?: "full" | "half" | undefined;
-            jsonParser?: ((text: string) => Promise<any> | any) | undefined;
-            retry?: _better_fetch_fetch.RetryOptions | undefined;
-            retryAttempt?: number | undefined;
-            output?: (_better_fetch_fetch.StandardSchemaV1 | typeof Blob | typeof File) | undefined;
-            errorSchema?: _better_fetch_fetch.StandardSchemaV1 | undefined;
-            disableValidation?: boolean | undefined;
-        } | undefined): Promise<{
-            url: string;
-            options: BetterFetchOption;
-        }>;
-    }[];
+    init(url: string, options: {
+      method?: string | undefined;
+      headers?: (HeadersInit & (HeadersInit | {
+        accept: "application/json" | "text/plain" | "application/octet-stream";
+        "content-type": "application/json" | "text/plain" | "application/x-www-form-urlencoded" | "multipart/form-data" | "application/octet-stream";
+        authorization: "Bearer" | "Basic";
+      })) | undefined;
+      redirect?: RequestRedirect | undefined;
+      cache?: RequestCache | undefined;
+      credentials?: RequestCredentials | undefined;
+      integrity?: string | undefined;
+      keepalive?: boolean | undefined;
+      mode?: RequestMode | undefined;
+      priority?: RequestPriority | undefined;
+      referrer?: string | undefined;
+      referrerPolicy?: ReferrerPolicy | undefined;
+      signal?: (AbortSignal | null) | undefined;
+      window?: null | undefined;
+      onRequest?: (<T extends Record<string, any>>(context: _better_fetch_fetch0.RequestContext<T>) => Promise<_better_fetch_fetch0.RequestContext | void> | _better_fetch_fetch0.RequestContext | void) | undefined;
+      onResponse?: ((context: _better_fetch_fetch0.ResponseContext) => Promise<Response | void | _better_fetch_fetch0.ResponseContext> | Response | _better_fetch_fetch0.ResponseContext | void) | undefined;
+      onSuccess?: ((context: _better_fetch_fetch0.SuccessContext<any>) => Promise<void> | void) | undefined;
+      onError?: ((context: _better_fetch_fetch0.ErrorContext) => Promise<void> | void) | undefined;
+      onRetry?: ((response: _better_fetch_fetch0.ResponseContext) => Promise<void> | void) | undefined;
+      hookOptions?: {
+        cloneResponse?: boolean;
+      } | undefined;
+      timeout?: number | undefined;
+      customFetchImpl?: _better_fetch_fetch0.FetchEsque | undefined;
+      plugins?: _better_fetch_fetch0.BetterFetchPlugin[] | undefined;
+      baseURL?: string | undefined;
+      throw?: boolean | undefined;
+      auth?: ({
+        type: "Bearer";
+        token: string | Promise<string | undefined> | (() => string | Promise<string | undefined> | undefined) | undefined;
+      } | {
+        type: "Basic";
+        username: string | (() => string | undefined) | undefined;
+        password: string | (() => string | undefined) | undefined;
+      } | {
+        type: "Custom";
+        prefix: string | (() => string | undefined) | undefined;
+        value: string | (() => string | undefined) | undefined;
+      }) | undefined;
+      body?: any;
+      query?: any;
+      params?: any;
+      duplex?: "full" | "half" | undefined;
+      jsonParser?: ((text: string) => Promise<any> | any) | undefined;
+      retry?: _better_fetch_fetch0.RetryOptions | undefined;
+      retryAttempt?: number | undefined;
+      output?: (_better_fetch_fetch0.StandardSchemaV1 | typeof Blob | typeof File) | undefined;
+      errorSchema?: _better_fetch_fetch0.StandardSchemaV1 | undefined;
+      disableValidation?: boolean | undefined;
+    } | undefined): Promise<{
+      url: string;
+      options: ClientFetchOption;
+    }>;
+  }[];
 };
-
-export { expoClient, getCookie, getSetCookie, parseSetCookieHeader };
+//#endregion
+export { expoClient, getCookie, getSetCookie, hasBetterAuthCookies, normalizeCookieName, parseSetCookieHeader, setupExpoFocusManager, setupExpoOnlineManager, storageAdapter };