@razakalpha/convngx 0.2.4 → 0.2.6

package/types/razakalpha-convngx.d.ts

@@ -0,0 +1,990 @@
+import { BaseConvexClientOptions, OptimisticUpdate } from 'convex/browser';
+import { FunctionReference, FunctionArgs, FunctionReturnType } from 'convex/server';
+import * as _angular_core from '@angular/core';
+import { InjectionToken, Provider, ResourceRef, Signal } from '@angular/core';
+import * as nanostores from 'nanostores';
+import * as _better_fetch_fetch from '@better-fetch/fetch';
+import * as jose from 'jose';
+import * as better_auth from 'better-auth';
+import { createAuthClient } from 'better-auth/client';
+import { convexClient, crossDomainClient } from '@convex-dev/better-auth/client/plugins';
+
+/**
+ * Shared types for Convex Angular core.
+ * Pure extraction for readability; no behavior changes.
+ */
+/** Auth token fetcher used by ConvexAngularClient.setAuth */
+type FetchAccessToken = (o: {
+    forceRefreshToken: boolean;
+}) => Promise<string | null>;
+/** Snapshot of current auth state (token presence-based) */
+type AuthSnapshot = {
+    isAuthenticated: boolean;
+    token: string | null;
+    exp?: number;
+};
+
+/**
+ * ConvexAngularClient
+ * - Wraps Convex BaseConvexClient + ConvexHttpClient
+ * - Integrates Better Auth via pluggable fetcher (setAuth)
+ * - Caches JWT in sessionStorage with BroadcastChannel sync
+ * - Auto-refreshes auth token ahead of expiry with jitter
+ * - Provides:
+ *   - watchQuery: live subscription with localQueryResult + onUpdate
+ *   - query: HTTP one-shot with in-flight de-dupe + 401 retry
+ *   - mutation: supports optimisticUpdate passthrough
+ *   - action: HTTP call with 401 retry
+ * - Does not change any runtime behavior – documentation and structure only.
+ */
+
+type WatchHandle<Q extends FunctionReference<'query'>> = {
+    localQueryResult(): FunctionReturnType<Q> | undefined;
+    onUpdate(cb: () => void): () => void;
+    unsubscribe(): void;
+};
+declare class ConvexAngularClient {
+    private authListeners;
+    private lastSnap?;
+    private emitAuth;
+    private base;
+    private http;
+    private byToken;
+    private fetchToken?;
+    private inflightToken?;
+    private token?;
+    private refreshTimer?;
+    private inflightHttp;
+    private authLocked;
+    private readonly skewMs;
+    constructor(url: string, opts?: BaseConvexClientOptions & {
+        authSkewMs?: number;
+    });
+    setAuth(fetcher: FetchAccessToken): void;
+    /** Optional: call once on app start */
+    warmAuth(): Promise<void>;
+    private freshTokenInCache;
+    onAuth(cb: (s: AuthSnapshot) => void): () => void;
+    logoutLocal(lock?: boolean): void;
+    getAuthSnapshot(): {
+        isAuthenticated: boolean;
+        token: string | null;
+        exp: number | undefined;
+    };
+    /** Allow re-auth then fetch a fresh token (use after successful sign-in) */
+    refreshAuth(): Promise<void>;
+    private applyToken;
+    private scheduleRefresh;
+    private getToken;
+    private ensureHttpAuth;
+    watchQuery<Q extends FunctionReference<'query'>>(q: Q, args: FunctionArgs<Q>): WatchHandle<Q>;
+    mutation<M extends FunctionReference<'mutation'>>(m: M, args: FunctionArgs<M>, opts?: {
+        optimisticUpdate?: OptimisticUpdate<FunctionArgs<M>>;
+    }): Promise<FunctionReturnType<M>>;
+    action<A extends FunctionReference<'action'> & {
+        _args: Record<string, never>;
+    }>(a: A): Promise<FunctionReturnType<A>>;
+    action<A extends FunctionReference<'action'>>(a: A, args: FunctionArgs<A>): Promise<FunctionReturnType<A>>;
+    query<Q extends FunctionReference<'query'> & {
+        _args: Record<string, never>;
+    }>(q: Q): Promise<FunctionReturnType<Q>>;
+    query<Q extends FunctionReference<'query'>>(q: Q, args: FunctionArgs<Q>): Promise<FunctionReturnType<Q>>;
+}
+
+/**
+* Injection token and helper for accessing the Convex client from DI.
+* Keep this tiny and stable — many helpers rely on it.
+*/
+
+/** DI token for the configured ConvexAngularClient instance */
+declare const CONVEX: InjectionToken<ConvexAngularClient>;
+/** Convenience helper to inject the Convex client */
+declare const injectConvex: () => ConvexAngularClient;
+
+type AuthConfig = {
+    baseURL: string;
+    plugins: [ReturnType<typeof convexClient>, ReturnType<typeof crossDomainClient>];
+    fetchOptions: {
+        credentials: 'include';
+    };
+};
+type AuthClient = ReturnType<typeof createAuthClient<AuthConfig>>;
+interface ProvideAuthClientOptions {
+    baseURL: string;
+    fetchOptions?: RequestInit;
+}
+/**
+ * Un-typed DI token. We don't re-export types; callers who create the client
+ * get full type safety from better-auth directly.
+ */
+declare const AUTH_CLIENT: InjectionToken<{
+    convex: {
+        jwks: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+            query?: Record<string, any> | undefined;
+            fetchOptions?: FetchOptions | undefined;
+        }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<jose.JSONWebKeySet, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    convex: {
+        token: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+            query?: Record<string, any> | undefined;
+            fetchOptions?: FetchOptions | undefined;
+        }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+            token: string;
+        }, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    crossDomain: {
+        oneTimeToken: {
+            verify: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+                token: string;
+            }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+                token: string;
+            } & {
+                fetchOptions?: FetchOptions | undefined;
+            }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+                session: better_auth.Session & Record<string, any>;
+                user: better_auth.User & Record<string, any>;
+            }, {
+                code?: string | undefined;
+                message?: string | undefined;
+            }, FetchOptions["throw"] extends true ? true : false>>;
+        };
+    };
+} & {
+    signIn: {
+        social: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+            provider: (string & {}) | "github" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "huggingface" | "slack" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "linear" | "linkedin" | "gitlab" | "tiktok" | "reddit" | "roblox" | "salesforce" | "vk" | "zoom" | "notion" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "vercel";
+            callbackURL?: string | undefined;
+            newUserCallbackURL?: string | undefined;
+            errorCallbackURL?: string | undefined;
+            disableRedirect?: boolean | undefined;
+            idToken?: {
+                token: string;
+                nonce?: string | undefined;
+                accessToken?: string | undefined;
+                refreshToken?: string | undefined;
+                expiresAt?: number | undefined;
+            } | undefined;
+            scopes?: string[] | undefined;
+            requestSignUp?: boolean | undefined;
+            loginHint?: string | undefined;
+            additionalData?: Record<string, any> | undefined;
+        }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+            provider: (string & {}) | "github" | "apple" | "atlassian" | "cognito" | "discord" | "facebook" | "figma" | "microsoft" | "google" | "huggingface" | "slack" | "spotify" | "twitch" | "twitter" | "dropbox" | "kick" | "linear" | "linkedin" | "gitlab" | "tiktok" | "reddit" | "roblox" | "salesforce" | "vk" | "zoom" | "notion" | "kakao" | "naver" | "line" | "paybin" | "paypal" | "polar" | "vercel";
+            callbackURL?: string | undefined;
+            newUserCallbackURL?: string | undefined;
+            errorCallbackURL?: string | undefined;
+            disableRedirect?: boolean | undefined;
+            idToken?: {
+                token: string;
+                nonce?: string | undefined;
+                accessToken?: string | undefined;
+                refreshToken?: string | undefined;
+                expiresAt?: number | undefined;
+            } | undefined;
+            scopes?: string[] | undefined;
+            requestSignUp?: boolean | undefined;
+            loginHint?: string | undefined;
+            additionalData?: Record<string, any> | undefined;
+        } & {
+            fetchOptions?: FetchOptions | undefined;
+        }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<NonNullable<{
+            redirect: boolean;
+            url: string;
+        } | {
+            redirect: boolean;
+            token: string;
+            url: undefined;
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+        }>, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    signOut: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: Record<string, any> | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        success: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    signUp: {
+        email: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+            name: string;
+            email: string;
+            password: string;
+            image?: string | undefined;
+            callbackURL?: string | undefined;
+            rememberMe?: boolean | undefined;
+        }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+            email: string;
+            name: string;
+            password: string;
+            image?: string | undefined;
+            callbackURL?: string | undefined;
+            fetchOptions?: FetchOptions | undefined;
+        } & {} & {}>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<NonNullable<{
+            token: null;
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+        } | {
+            token: string;
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+        }>, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    signIn: {
+        email: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+            email: string;
+            password: string;
+            callbackURL?: string | undefined;
+            rememberMe?: boolean | undefined;
+        }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+            email: string;
+            password: string;
+            callbackURL?: string | undefined;
+            rememberMe?: boolean | undefined;
+        } & {
+            fetchOptions?: FetchOptions | undefined;
+        }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+            redirect: boolean;
+            token: string;
+            url?: string | undefined;
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined | undefined;
+            };
+        }, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    resetPassword: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        newPassword: string;
+        token?: string | undefined;
+    }> & Record<string, any>, Partial<{
+        token?: string | undefined;
+    }> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        newPassword: string;
+        token?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    verifyEmail: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<{
+        token: string;
+        callbackURL?: string | undefined;
+    }> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        query: {
+            token: string;
+            callbackURL?: string | undefined;
+        };
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<NonNullable<void | {
+        status: boolean;
+    }>, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    sendVerificationEmail: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        email: string;
+        callbackURL?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        email: string;
+        callbackURL?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    changeEmail: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        newEmail: string;
+        callbackURL?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        newEmail: string;
+        callbackURL?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    changePassword: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        newPassword: string;
+        currentPassword: string;
+        revokeOtherSessions?: boolean | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        newPassword: string;
+        currentPassword: string;
+        revokeOtherSessions?: boolean | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        token: string | null;
+        user: {
+            id: string;
+            email: string;
+            name: string;
+            image: string | null | undefined;
+            emailVerified: boolean;
+            createdAt: Date;
+            updatedAt: Date;
+        };
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    updateUser: <FetchOptions extends better_auth.ClientFetchOption<Partial<Partial<{}> & {
+        name?: string | undefined;
+        image?: string | undefined | null;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        image?: (string | null) | undefined;
+        name?: string | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    } & Partial<{} & {}>> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    deleteUser: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        callbackURL?: string | undefined;
+        password?: string | undefined;
+        token?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        callbackURL?: string | undefined;
+        password?: string | undefined;
+        token?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        success: boolean;
+        message: string;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    requestPasswordReset: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        email: string;
+        redirectTo?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        email: string;
+        redirectTo?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+        message: string;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    resetPassword: {
+        ":token": <FetchOptions extends better_auth.ClientFetchOption<never, Partial<{
+            callbackURL: string;
+        }> & Record<string, any>, {
+            token: string;
+        }>>(data_0: better_auth.Prettify<{
+            query: {
+                callbackURL: string;
+            };
+            fetchOptions?: FetchOptions | undefined;
+        }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<never, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    listSessions: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: Record<string, any> | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<better_auth.Prettify<{
+        id: string;
+        createdAt: Date;
+        updatedAt: Date;
+        userId: string;
+        expiresAt: Date;
+        token: string;
+        ipAddress?: string | null | undefined | undefined;
+        userAgent?: string | null | undefined | undefined;
+    }>[], {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    revokeSession: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        token: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        token: string;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    revokeSessions: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: Record<string, any> | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    revokeOtherSessions: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: Record<string, any> | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    linkSocial: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        provider: unknown;
+        callbackURL?: string | undefined;
+        idToken?: {
+            token: string;
+            nonce?: string | undefined;
+            accessToken?: string | undefined;
+            refreshToken?: string | undefined;
+            scopes?: string[] | undefined;
+        } | undefined;
+        requestSignUp?: boolean | undefined;
+        scopes?: string[] | undefined;
+        errorCallbackURL?: string | undefined;
+        disableRedirect?: boolean | undefined;
+        additionalData?: Record<string, any> | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        provider: unknown;
+        callbackURL?: string | undefined;
+        idToken?: {
+            token: string;
+            nonce?: string | undefined;
+            accessToken?: string | undefined;
+            refreshToken?: string | undefined;
+            scopes?: string[] | undefined;
+        } | undefined;
+        requestSignUp?: boolean | undefined;
+        scopes?: string[] | undefined;
+        errorCallbackURL?: string | undefined;
+        disableRedirect?: boolean | undefined;
+        additionalData?: Record<string, any> | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        url: string;
+        redirect: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    listAccounts: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: Record<string, any> | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        id: string;
+        providerId: string;
+        createdAt: Date;
+        updatedAt: Date;
+        accountId: string;
+        userId: string;
+        scopes: string[];
+    }[], {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    deleteUser: {
+        callback: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<{
+            token: string;
+            callbackURL?: string | undefined;
+        }> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+            query: {
+                token: string;
+                callbackURL?: string | undefined;
+            };
+            fetchOptions?: FetchOptions | undefined;
+        }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+            success: boolean;
+            message: string;
+        }, {
+            code?: string | undefined;
+            message?: string | undefined;
+        }, FetchOptions["throw"] extends true ? true : false>>;
+    };
+} & {
+    unlinkAccount: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        providerId: string;
+        accountId?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        providerId: string;
+        accountId?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        status: boolean;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    refreshToken: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        providerId: string;
+        accountId?: string | undefined;
+        userId?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        providerId: string;
+        accountId?: string | undefined;
+        userId?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        accessToken: string | undefined;
+        refreshToken: string | undefined;
+        accessTokenExpiresAt: Date | undefined;
+        refreshTokenExpiresAt: Date | undefined;
+        scope: string | null | undefined;
+        idToken: string | null | undefined;
+        providerId: string;
+        accountId: string;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    getAccessToken: <FetchOptions extends better_auth.ClientFetchOption<Partial<{
+        providerId: string;
+        accountId?: string | undefined;
+        userId?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: better_auth.Prettify<{
+        providerId: string;
+        accountId?: string | undefined;
+        userId?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        accessToken: string;
+        accessTokenExpiresAt: Date | undefined;
+        scopes: string[];
+        idToken: string | undefined;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    accountInfo: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<{
+        accountId?: string | undefined;
+    }> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: {
+            accountId?: string | undefined;
+        } | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        user: better_auth.OAuth2UserInfo;
+        data: Record<string, any>;
+    }, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    getSession: <FetchOptions extends better_auth.ClientFetchOption<never, Partial<{
+        disableCookieCache?: unknown;
+        disableRefresh?: unknown;
+    }> & Record<string, any>, Record<string, any> | undefined>>(data_0?: better_auth.Prettify<{
+        query?: {
+            disableCookieCache?: unknown;
+            disableRefresh?: unknown;
+        } | undefined;
+        fetchOptions?: FetchOptions | undefined;
+    }> | undefined, data_1?: FetchOptions | undefined) => Promise<_better_fetch_fetch.BetterFetchResponse<{
+        user: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            email: string;
+            emailVerified: boolean;
+            name: string;
+            image?: string | null | undefined;
+            userId?: string | null | undefined;
+        };
+        session: {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            userId: string;
+            expiresAt: Date;
+            token: string;
+            ipAddress?: string | null | undefined;
+            userAgent?: string | null | undefined;
+        };
+    } | null, {
+        code?: string | undefined;
+        message?: string | undefined;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    getCookie: () => string;
+    updateSession: () => void;
+    getSessionData: () => any;
+} & {
+    useSession: nanostores.Atom<{
+        data: {
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined;
+                userId?: string | null | undefined;
+            };
+            session: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined;
+                userAgent?: string | null | undefined;
+            };
+        } | null;
+        error: _better_fetch_fetch.BetterFetchError | null;
+        isPending: boolean;
+    }>;
+    $fetch: _better_fetch_fetch.BetterFetch<{
+        plugins: (_better_fetch_fetch.BetterFetchPlugin<Record<string, any>> | {
+            id: string;
+            name: string;
+            hooks: {
+                onSuccess(context: _better_fetch_fetch.SuccessContext<any>): void;
+            };
+        } | {
+            id: string;
+            name: string;
+            hooks: {
+                onSuccess: ((context: _better_fetch_fetch.SuccessContext<any>) => Promise<void> | void) | undefined;
+                onError: ((context: _better_fetch_fetch.ErrorContext) => Promise<void> | void) | 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;
+            };
+        })[];
+        cache?: RequestCache | undefined;
+        method: string;
+        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;
+        credentials?: RequestCredentials;
+        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;
+        onRetry?: ((response: _better_fetch_fetch.ResponseContext) => Promise<void> | void) | undefined;
+        hookOptions?: {
+            cloneResponse?: boolean;
+        } | undefined;
+        timeout?: number | undefined;
+        customFetchImpl: _better_fetch_fetch.FetchEsque;
+        baseURL: string;
+        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;
+        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;
+        disableSignal?: boolean | undefined;
+    }, unknown, unknown, {}>;
+    $store: {
+        notify: (signal?: (Omit<string, "$sessionSignal"> | "$sessionSignal") | undefined) => void;
+        listen: (signal: Omit<string, "$sessionSignal"> | "$sessionSignal", listener: (value: boolean, oldValue?: boolean | undefined) => void) => void;
+        atoms: Record<string, nanostores.WritableAtom<any>>;
+    };
+    $Infer: {
+        Session: {
+            user: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                email: string;
+                emailVerified: boolean;
+                name: string;
+                image?: string | null | undefined;
+                userId?: string | null | undefined;
+            };
+            session: {
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                userId: string;
+                expiresAt: Date;
+                token: string;
+                ipAddress?: string | null | undefined;
+                userAgent?: string | null | undefined;
+            };
+        };
+    };
+    $ERROR_CODES: {
+        readonly USER_NOT_FOUND: "User not found";
+        readonly FAILED_TO_CREATE_USER: "Failed to create user";
+        readonly FAILED_TO_CREATE_SESSION: "Failed to create session";
+        readonly FAILED_TO_UPDATE_USER: "Failed to update user";
+        readonly FAILED_TO_GET_SESSION: "Failed to get session";
+        readonly INVALID_PASSWORD: "Invalid password";
+        readonly INVALID_EMAIL: "Invalid email";
+        readonly INVALID_EMAIL_OR_PASSWORD: "Invalid email or password";
+        readonly SOCIAL_ACCOUNT_ALREADY_LINKED: "Social account already linked";
+        readonly PROVIDER_NOT_FOUND: "Provider not found";
+        readonly INVALID_TOKEN: "Invalid token";
+        readonly ID_TOKEN_NOT_SUPPORTED: "id_token not supported";
+        readonly FAILED_TO_GET_USER_INFO: "Failed to get user info";
+        readonly USER_EMAIL_NOT_FOUND: "User email not found";
+        readonly EMAIL_NOT_VERIFIED: "Email not verified";
+        readonly PASSWORD_TOO_SHORT: "Password too short";
+        readonly PASSWORD_TOO_LONG: "Password too long";
+        readonly USER_ALREADY_EXISTS: "User already exists.";
+        readonly USER_ALREADY_EXISTS_USE_ANOTHER_EMAIL: "User already exists. Use another email.";
+        readonly EMAIL_CAN_NOT_BE_UPDATED: "Email can not be updated";
+        readonly CREDENTIAL_ACCOUNT_NOT_FOUND: "Credential account not found";
+        readonly SESSION_EXPIRED: "Session expired. Re-authenticate to perform this action.";
+        readonly FAILED_TO_UNLINK_LAST_ACCOUNT: "You can't unlink your last account";
+        readonly ACCOUNT_NOT_FOUND: "Account not found";
+        readonly USER_ALREADY_HAS_PASSWORD: "User already has a password. Provide that to delete the account.";
+    };
+}>;
+/** Provide a configured Better Auth client via DI (default convex+crossDomain plugins) */
+declare function provideAuthClient(opts: ProvideAuthClientOptions): Provider;
+
+type QueryRef = FunctionReference<'query'>;
+type KeepMode = 'none' | 'last';
+interface ConvexResourceOptions {
+    keep?: KeepMode;
+}
+declare const CONVEX_RESOURCE_OPTIONS: InjectionToken<Required<ConvexResourceOptions>>;
+declare function provideConvexResourceOptions(opts: Partial<ConvexResourceOptions>): Provider;
+type NoArgsQuery = QueryRef & {
+    _args: Record<string, never>;
+};
+/** Overloads */
+declare function convexLiveResource<Q extends NoArgsQuery>(query: Q, opts?: ConvexResourceOptions): ResourceRef<FunctionReturnType<Q> | undefined>;
+declare function convexLiveResource<Q extends NoArgsQuery>(query: Q, params: () => {} | undefined, opts?: ConvexResourceOptions): ResourceRef<FunctionReturnType<Q> | undefined>;
+declare function convexLiveResource<Q extends QueryRef>(query: Q, params: () => Q['_args'] | undefined, opts?: ConvexResourceOptions): ResourceRef<FunctionReturnType<Q> | undefined>;
+
+interface ConvexAngularOptions {
+    /** Convex deployment URL, e.g. https://xxx.convex.cloud */
+    convexUrl: string;
+    /** Better Auth base URL (convex site url), e.g. https://xxx.convex.site */
+    authBaseURL: string;
+    /** Skew before JWT expiry to refresh token */
+    authSkewMs?: number;
+    /** Default keep mode for live resources ('last' | 'none') */
+    keep?: KeepMode;
+    /**
+     * Optional: user-provided Better Auth client.
+     * Must include convexClient() and crossDomainClient() plugins.
+     */
+    authClient?: AuthClient;
+}
+/**
+ * Single entry-point provider to wire Convex + Better Auth + resource defaults.
+ * Behavior:
+ * - If opts.authClient is provided, we use it (and verify required plugins).
+ * - Else we create a default Better Auth client using authBaseURL with required plugins.
+ */
+declare function provideConvexAngular(opts: ConvexAngularOptions): Provider[];
+
+/** Minimal surface this library relies on from Better Auth client */
+interface AuthClientRequired {
+    convex: {
+        token: () => Promise<{
+            data?: {
+                token?: string;
+            } | null;
+        }>;
+    };
+    crossDomain: {
+        oneTimeToken: {
+            verify: (args: {
+                token: string;
+            }) => Promise<{
+                data?: {
+                    session?: {
+                        token?: string;
+                    };
+                };
+            }>;
+        };
+    };
+    getSession: (o?: {
+        fetchOptions?: RequestInit;
+    }) => Promise<unknown>;
+    updateSession: () => void;
+}
+interface ConvexBetterAuthOptions {
+    /** Convex deployment URL, e.g. https://xxx.convex.cloud */
+    convexUrl: string;
+    /** Milliseconds before JWT expiry to refresh (default 45s in this provider) */
+    authSkewMs?: number;
+    authClient?: AuthClientRequired;
+}
+/**
+ * Registers the Convex client in DI and connects it to Better Auth for JWT retrieval.
+ * Consumers still need to provide the Better Auth HTTP client via provideAuthClient().
+ */
+declare function provideConvexBetterAuth(opts: ConvexBetterAuthOptions): Provider[];
+/**
+ * Optional environment initializer to handle OTT (?ott=...) once and upgrade to a cookie session.
+ * Keep separate from main provider for explicit opt-in.
+ */
+declare function provideBetterAuthOttBootstrap(): _angular_core.EnvironmentProviders;
+
+type MutationRef = FunctionReference<'mutation'>;
+type NoArgsMutation = MutationRef & {
+    _args: Record<string, never>;
+};
+type IfEmptyArgs$1<M extends MutationRef, TIfEmpty, TIfNot> = keyof M['_args'] extends never ? TIfEmpty : TIfNot;
+interface ConvexMutationOptions<M extends MutationRef> {
+    optimisticUpdate?: OptimisticUpdate<FunctionArgs<M>>;
+    onSuccess?: (data: FunctionReturnType<M>) => void;
+    onError?: (err: Error) => void;
+    /** concurrency: queue = sequential, drop = ignore while inflight, replace = prefer latest */
+    mode?: 'queue' | 'drop' | 'replace';
+    /** simple retry */
+    retries?: number;
+    retryDelayMs?: (attempt: number) => number;
+}
+type RunFn$1<M extends MutationRef> = IfEmptyArgs$1<M, (args?: FunctionArgs<M>) => Promise<FunctionReturnType<M>>, (args: FunctionArgs<M>) => Promise<FunctionReturnType<M>>>;
+interface ConvexMutationResource<M extends MutationRef> {
+    /** imperative trigger */
+    run: RunFn$1<M>;
+    /** resource-shaped state (bind in templates if you like) */
+    state: ResourceRef<FunctionReturnType<M> | undefined>;
+    /** convenience signals */
+    data: Signal<FunctionReturnType<M> | undefined>;
+    error: Signal<Error | undefined>;
+    isRunning: Signal<boolean>;
+    reset(): void;
+}
+/** Overloads for nice run() arg ergonomics */
+declare function convexMutationResource<M extends NoArgsMutation>(mutation: M, opts?: ConvexMutationOptions<M>): ConvexMutationResource<M>;
+declare function convexMutationResource<M extends MutationRef>(mutation: M, opts?: ConvexMutationOptions<M>): ConvexMutationResource<M>;
+
+type ActionRef = FunctionReference<'action'>;
+type NoArgsAction = ActionRef & {
+    _args: Record<string, never>;
+};
+type IfEmptyArgs<A extends ActionRef, TIfEmpty, TIfNot> = keyof A['_args'] extends never ? TIfEmpty : TIfNot;
+interface ConvexActionOptions<A extends ActionRef> {
+    onSuccess?: (data: FunctionReturnType<A>) => void;
+    onError?: (err: Error) => void;
+    /** concurrency: queue = sequential, drop = ignore while inflight, replace = prefer latest */
+    mode?: 'queue' | 'drop' | 'replace';
+    /** simple retry */
+    retries?: number;
+    retryDelayMs?: (attempt: number) => number;
+}
+type RunFn<A extends ActionRef> = IfEmptyArgs<A, (args?: FunctionArgs<A>) => Promise<FunctionReturnType<A>>, (args: FunctionArgs<A>) => Promise<FunctionReturnType<A>>>;
+interface ConvexActionResource<A extends ActionRef> {
+    run: RunFn<A>;
+    state: ResourceRef<FunctionReturnType<A> | undefined>;
+    data: Signal<FunctionReturnType<A> | undefined>;
+    error: Signal<Error | undefined>;
+    isRunning: Signal<boolean>;
+    reset(): void;
+}
+/** Overloads for nice run() arg ergonomics */
+declare function convexActionResource<A extends NoArgsAction>(action: A, opts?: ConvexActionOptions<A>): ConvexActionResource<A>;
+declare function convexActionResource<A extends ActionRef>(action: A, opts?: ConvexActionOptions<A>): ConvexActionResource<A>;
+
+export { AUTH_CLIENT, CONVEX, CONVEX_RESOURCE_OPTIONS, ConvexAngularClient, convexActionResource, convexLiveResource, convexMutationResource, injectConvex, provideAuthClient, provideBetterAuthOttBootstrap, provideConvexAngular, provideConvexBetterAuth, provideConvexResourceOptions };
+export type { ActionRef, AuthClient, AuthSnapshot, ConvexActionOptions, ConvexActionResource, ConvexAngularOptions, ConvexBetterAuthOptions, ConvexMutationOptions, ConvexMutationResource, ConvexResourceOptions, FetchAccessToken, KeepMode, MutationRef, ProvideAuthClientOptions, QueryRef };