Server SDK

npm install git+https://github.com/Ciright-Inc/keyra-typescript-sdk.git

import { createKeyraServer } from "@keyra/typescript-sdk";

const keyra = createKeyraServer({
  baseUrl: process.env.KEYRA_BASE_URL ?? "https://auth.keyra.ie",
  // timeoutMs?: optional request timeout
});
// No clientSecret / sk_* in this factory.

const { codeVerifier, codeChallenge, codeChallengeMethod } = keyra.generatePkce();
// codeChallengeMethod === "S256"

const pkce = keyra.generatePkce();
// Persist codeVerifier server-side (session) keyed by state

const started = await keyra.createVerification({
  client_id: process.env.KEYRA_PUBLISHABLE_CLIENT_ID!,
  redirect_uri: "https://example.com/auth/keyra/callback",
  code_challenge: pkce.codeChallenge,
  code_challenge_method: pkce.codeChallengeMethod,
  state: opaqueState,
  scope: "verify",
});

// Return started.authorize_url to the browser

const outcome = await keyra.validateVerification({
  verification_token: tokenFromBrowser,
  client_id: process.env.KEYRA_PUBLISHABLE_CLIENT_ID, // optional
});

if (!outcome.valid) {
  // reject — do not create a session
}