API Reference

Use getCurrentUser() to access the current user object.

If the user is not logged in, this will return null.

• JavaScript
• React
• TypeScript
• curl

const user = getCurrentUser();

let email = user.email;
let name = user.name;

{
    "id": "334a2050-5720-4cb9-82b2-efdf7009bac7",
    "email": "jon@snow.com"
}

function UserDetails() {
    const user = useCurrentUser();

    return <div>{user.email}</div>;
}

function UserDetails() {
    const user = useCurrentUser();

    return <div>{user.email}</div>;
}

curl https://<thin-backend-url>/api/user \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer: <ihp_backend_jwt>"

{
    "id": "334a2050-5720-4cb9-82b2-efdf7009bac7",
    "email": "jon@snow.com"
}

Useful to implement a login button. Redirects the user to the login page.

The returned promise never resolves, as the browser is redirected to a different page.

• JavaScript
• React
• TypeScript
• curl

import { loginWithRedirect } from 'thin-backend';

await loginWithRedirect();

import { loginWithRedirect } from 'thin-backend';

function LoginButton() {
    const isLoading = useState(false);

    async function doLogin() {
        setLoading(true);
        await loginWithRedirect();
        setLoading(false);
    }

    return <button onClick={doLogin} disabled={isLoading}>Login</button>
}

import { loginWithRedirect } from 'thin-backend';

function LoginButton() {
    const isLoading = useState(false);

    async function doLogin() {
        setLoading(true);
        await loginWithRedirect();
        setLoading(false);
    }

    return <button onClick={doLogin} disabled={isLoading}>Login</button>
}

• JavaScript
• React
• TypeScript
• curl

import { logout } from 'thin-backend';

// Logout and redirect to login page
await logout();

// Logout and redirect to https://example.com
await logout({ redirect: 'https://example.com' })

function LogoutButton() {
    const isLoading = useState(false);

    async function doLogout() {
        setLoading(true);
        await logout();
        setLoading(false);
    }

    return <button onClick={doLogout} disabled={isLoading}>Logout</button>
}

function LogoutButton() {
    const isLoading = useState(false);

    async function doLogout() {
        setLoading(true);
        await logout();
        setLoading(false);
    }

    return <button onClick={doLogout} disabled={isLoading}>Logout</button>
}

This react component provides the AuthCompletedContext context.

Internally it calls initAuth() to provide the current user to the application and to handle redirects from the login page.

If you pass requireLogin, like <ThinBackend requireLogin/>, it will call ensureIsUser() to trigger a redirect to the login page if the user is not logged in yet.

• JavaScript
• curl

import { ThinBackend } from 'thin-backend-react';

// React entrypoint component
function App() {
    // The `requireLogin` triggers a redirect to the login page if not logged in already
    return <ThinBackend>
        <div>Hello World</div>
    </ThinBackend>
}


// Start the React app
ReactDOM.render(<App/>, document.getElementById('app'));

Should be called at the start of your application before any query calls.

This function checks if there's a current JWT in the localStorage and then prepares the state for functions such as getCurrentUserId() to work.

If the user was redirect to the app from the login page, this function will trade the received access token to a full JWT, and then save it to the localStorage.

If you use react, use <ThinBackend/> instead. Internally it calls initAuth().

If the user is logged out, this function does not do anything. See ensureIsUser(), which is a variant of initAuth() but redirects to the login page if there's no user session.

• JavaScript
• curl

import { initAuth } from 'thin-backend';

// Called before any query logic below:
await initAuth();

// This call is authenticated now:
const tasks = await query('tasks').fetch();