woographqlnext.jsuseTokenManageruseSessionFlaggetTokenManagerInstancesessionhooks

useTokenManager

Client hook binding a TokenManager instance to the React session

AxisTaylor, LLC

1 min read

Loading…

Export	Signature	Description
`useTokenManager`	`<T extends TokenManager>(TokenManagerClass: new () => T) => T`	Construct (once) and return the app's `TokenManager` instance, memoized for the component tree.
`getTokenManagerInstance`	`<T extends TokenManager>() => T \| null`	Imperative accessor for the singleton instance outside React (e.g. in a server action helper). Returns `null` before the first `useTokenManager` call.
`useSessionFlag`	`() => string \| null`	Track the `SESSION_FLAG` cookie value, returning `null` until the first client-side read settles (so SSR markup matches the first client paint). Used as the session store's revalidate key so it re-fetches when server-side auth state changes.
`Cookies` (type)	`{ name: string; value: string }[]`	Shape of the cookie bag a `TokenManager` reads/writes.

Export

Signature

Description

useTokenManager

<T extends TokenManager>(TokenManagerClass: new () => T) => T

Construct (once) and return the app's TokenManager instance, memoized for the component tree.

getTokenManagerInstance

<T extends TokenManager>() => T | null

Imperative accessor for the singleton instance outside React (e.g. in a server action helper). Returns null before the first useTokenManager call.

useSessionFlag

() => string | null

Track the SESSION_FLAG cookie value, returning null until the first client-side read settles (so SSR markup matches the first client paint). Used as the session store's revalidate key so it re-fetches when server-side auth state changes.

Cookies (type)

{ name: string; value: string }[]

Shape of the cookie bag a TokenManager reads/writes.

'use client';
import { useTokenManager } from '@woographql/next';
import { ClientTokenManager } from '@auth/ClientTokenManager';

export function useAuthHeader() {
  const tokenManager = useTokenManager(ClientTokenManager);
  // tokenManager.getTokens(), tokenManager.saveTokens(...), etc.
  return tokenManager;
}

Export	Signature	Description
`useTokenManager`	`<T extends TokenManager>(TokenManagerClass: new () => T) => T`	Construct (once) and return the app's `TokenManager` instance, memoized for the component tree.
`getTokenManagerInstance`	`<T extends TokenManager>() => T \| null`	Imperative accessor for the singleton instance outside React (e.g. in a server action helper). Returns `null` before the first `useTokenManager` call.
`useSessionFlag`	`() => string \| null`	Track the `SESSION_FLAG` cookie value, returning `null` until the first client-side read settles (so SSR markup matches the first client paint). Used as the session store's revalidate key so it re-fetches when server-side auth state changes.
`Cookies` (type)	`{ name: string; value: string }[]`	Shape of the cookie bag a `TokenManager` reads/writes.

Export

Signature

Description

useTokenManager

<T extends TokenManager>(TokenManagerClass: new () => T) => T

Construct (once) and return the app's TokenManager instance, memoized for the component tree.

getTokenManagerInstance

<T extends TokenManager>() => T | null

Imperative accessor for the singleton instance outside React (e.g. in a server action helper). Returns null before the first useTokenManager call.

useSessionFlag

() => string | null

Cookies (type)

{ name: string; value: string }[]

Shape of the cookie bag a TokenManager reads/writes.

'use client';
import { useTokenManager } from '@woographql/next';
import { ClientTokenManager } from '@auth/ClientTokenManager';

export function useAuthHeader() {
  const tokenManager = useTokenManager(ClientTokenManager);
  // tokenManager.getTokens(), tokenManager.saveTokens(...), etc.
  return tokenManager;
}

useTokenManager

useTokenManager