⭐️⭐️⭐️ Open-source, self-hosted alternative to Linear and Plane. Project management and issue tracking where teams and AI agents work side by side to plan and ship products.
TypeScript agenticagileai-agentsbug-reportingbug-trackerganttissue-trackerjirajira-alternativekanbanlinearlinear-alternativeopen-sourceproduct-managementproject-managementroadmapself-hostedsprint-planningteam-collaborationtrello-alternative
import { useSyncExternalStore } from 'react';
import { createAuthClient } from 'better-auth/react';
import { inferAdditionalFields } from 'better-auth/client/plugins';
import { magicLinkClient, usernameClient } from 'better-auth/client/plugins';
import { passkeyClient } from '@better-auth/passkey/client';
import { oauthProviderClient } from '@better-auth/oauth-provider/client';
import { apiKeyClient } from '@better-auth/api-key/client';
import { API_URL, markSigningOut } from '@/lib/api/core/client';
// better-auth appends its default /api/auth only to a bare origin; an API_URL with a
// path would be used as-is, so the mount is spelled out.
export function authBaseURL(apiUrl: string): string {
return `${apiUrl.replace(/\/+$/, '')}/api/auth`;
}
// The better-auth handler lives on the backend (Elysia), so baseURL is the API origin.
// inferAdditionalFields declares the custom `role` column added in @repo/auth so the
// session user is typed with it (the web app never imports server packages).
export const authClient = createAuthClient({
baseURL: authBaseURL(API_URL),
plugins: [
inferAdditionalFields({
user: {
// Server-assigned (see @repo/auth) — not part of the sign-up input.
role: { type: 'string', input: false },
},
}),
// WebAuthn passkeys: signIn.passkey() and passkey.addPasskey().
passkeyClient(),
// Personal API keys: apiKey.create()/list()/delete().
apiKeyClient(),
// Sign-in by emailed link: signIn.magicLink(). Whether it is offered is an
// instance setting the sign-in screen reads from /auth-config; the server
// refuses to send when it is off.
magicLinkClient(),
// An MCP client's authorization sends the person to the sign-in and consent
// screens with a signed request in the URL; this hands it back with every POST
// they make, so the server can carry on with the authorization.
oauthProviderClient(),
// Usernames: signIn.username(). The sign-in screen sends its one field here when
// what was typed is not an address, and the plugin types `username` on the
// session user so the profile page can show it.
usernameClient(),
],
});
export const {
signIn,
signUp,
useSession,
getSession,
passkey,
apiKey,
updateUser,
changePassword,
// Password reset by email: request sends the link, reset consumes its token.
requestPasswordReset,
resetPassword,
// Resends the address confirmation link.
sendVerificationEmail,
// Connected sign-in providers, managed on the account's Accounts page.
listAccounts,
linkSocial,
unlinkAccount,
} = authClient;
// True from the start of a sign-out until the browser leaves the page. SigningOutGate
// swaps the app for a neutral screen meanwhile, so nothing on it asks the api for data
// once the session is gone.
let signingOut = false;
const signingOutListeners = new Set<() => void>();
export function isSigningOut(): boolean {
return signingOut;
}
export function useSigningOut(): boolean {
return useSyncExternalStore(
(listener) => {
signingOutListeners.add(listener);
return () => signingOutListeners.delete(listener);
},
isSigningOut,
() => false,
);
}
// Sign out through this wrapper rather than through the client: it tells lib/api
// that the 401s the dropped session causes are expected, so they do not send the
// browser to the expired-session screen. It then loads /login, or with `here` the same
// page, as a full load: navigating inside the app would draw it again with no session.
export async function signOut(then: 'login' | 'here' = 'login'): Promise<void> {
markSigningOut();
signingOut = true;
for (const listener of signingOutListeners) listener();
// Lets React take the app down before the session goes.
await new Promise((resolve) => setTimeout(resolve, 0));
// Leaves whatever the sign-out answered, as lib/api's endSession does: a failed
// request must not hold the browser on the signing-out screen.
await authClient.signOut().catch(() => {});
if (then === 'here') window.location.reload();
else window.location.replace('/login');
}
export type SessionUser = typeof authClient.$Infer.Session.user;