@last1id/login-button
v0.3.0
Published
Last1 ID login button. completeLoginCallback exchanges the authorization code by default and returns verified claims.
Readme
@last1id/login-button
Last1 ID login button. completeLoginCallback exchanges the authorization code by default and returns verified claims. Set exchange: false only when your server will exchange the code.
Install
npm install @last1id/[email protected] @last1id/[email protected]Usage
import { Last1LoginButton } from "@last1id/login-button";
export function SignIn() {
return (
<Last1LoginButton
issuer="https://auth.last1.id"
clientId={process.env.NEXT_PUBLIC_LAST1_CLIENT_ID!}
redirectUri="https://app.example.com/auth/callback"
scopes={["openid", "email", "profile", "offline_access"]}
iconSrc="https://last1.id/last1-mark.png"
/>
);
}By default, the button renders:
- Last1 mark icon (
https://last1.id/last1-mark.png, 18px) - Bundled PNG fallback if the CDN icon cannot load
- "Continue with Last1 ID" label
- Accessible rounded outlined button styling (drop-in ready)
Self-host the mark from the package:
import { Last1LoginButton, DEFAULT_LAST1_ICON_SRC } from "@last1id/login-button";
// Option A: CDN default (recommended)
<Last1LoginButton issuer="..." clientId="..." redirectUri="..." />
// Option B: copy assets/last1-mark-32.png into your public/ folder
<Last1LoginButton iconSrc="/integrations/logos/last1-mark.png" ... />You can customize with:
iconSrc- custom icon URL (defaults toDEFAULT_LAST1_ICON_SRC)showIcon- hide icon when set tofalseclassName- override default button stylinglabel- override button text
The button stores state, nonce, and the PKCE verifier together in
sessionStorage (last1_login_request). On the callback page,
completeLoginCallback exchanges the code by default:
import { completeLoginCallback } from "@last1id/login-button";
const callback = await completeLoginCallback(window.location.href, {
clientId,
redirectUri,
issuer: "https://auth.last1.id",
});
if (!callback.ok || callback.status !== "verified") {
throw new Error(callback.ok ? callback.status : callback.error);
}
const userId = callback.claims.sub;clientId is the app slug. The id_token aud is that slug. Pass audience
only when clientId is still a legacy UUID. Pass clientSecret for a
confidential client.
Set exchange: false when your server will exchange the code. That result
is { ok: true, status: "needs_verification", nonce, codeVerifier }. It is
not a verified login. Pass nonce to exchangeCode on the server.
A callback with ?error= and a matching state returns authorization_error.
A failed discovery fetch is caught in the button click handler and reported
through onError. The browser does not navigate.
