Core API

Types, errors, and utility functions.

Types

import type {
  NormalizedProfile,
  GoogleOAuthConfig,
  FacebookOAuthConfig,
  TelegramConfig,
  AuthKitConfig,
} from "auth-kit-js/core";

Error Classes

AuthKitError

Base error class.

import { AuthKitError } from "auth-kit-js/core";

try {
  // ...
} catch (error) {
  if (error instanceof AuthKitError) {
    console.log(error.code); // ERROR_CODE
    console.log(error.statusCode); // HTTP status
  }
}

OAuthError

OAuth-specific errors.

import { OAuthError } from "auth-kit-js/core";

TelegramVerificationError

Telegram verification errors.

import { TelegramVerificationError } from "auth-kit-js/core";

// error.code can be:
// - 'invalid_hash'
// - 'expired'
// - 'missing_data'

Crypto Utilities

generateState

Generate OAuth state parameter.

import { generateState } from "auth-kit-js/core";

const state = generateState(); // Random 32-char string

generateCodeVerifier / generateCodeChallenge

PKCE helpers.

import { generateCodeVerifier, generateCodeChallenge } from "auth-kit-js/core";

const verifier = generateCodeVerifier();
const challenge = await generateCodeChallenge(verifier);

timingSafeEqual

Timing-safe string comparison.

import { timingSafeEqual } from "auth-kit-js/core";

const isEqual = timingSafeEqual(a, b);