@deshina/agekey-core

Core AgeKey SDK package providing authentication and token management functionality.

Installation

npm install @deshina/agekey-core

Quick Start

import { init, verifyAge, requestToken } from "@deshina/agekey-core";

// Initialize SDK
init({
  apiKey: "your-api-key",
  apiBaseUrl: "https://agekey-auth.richiemuhammed.workers.dev"
});

// Verify age
const result = await verifyAge({
  email: "[email protected]",
  apiKey: "your-api-key",  // Required if not set in init()
  userId: "user-123"       // Optional
});

// Get stored token
const token = await requestToken();

API Reference

init(config)

Initialize the SDK with configuration.

init({
  apiKey: string;           // API key (optional, can be passed in verifyAge)
  apiBaseUrl?: string;      // Worker URL (optional)
  endpoint?: string;        // Legacy: same as apiBaseUrl
});

verifyAge(request)

Verify user age. Requires email and apiKey (if not set in init).

const result = await verifyAge({
  email: string;            // Required
  apiKey?: string;          // Required if not set in init()
  userId?: string;          // Optional
});

Returns: { verified: boolean, age?: number, token?: string }

requestToken()

Get the stored token after verification.

Configuration Priority

1. config.apiBaseUrl (explicit override)
2. config.endpoint (legacy, for backward compatibility)
3. Environment variable (AGEKEY_API_BASE_URL or VITE_AGEKEY_API_BASE_URL)
4. Default: https://api.agekey.com

Environment Variables

• Node.js/React Native: AGEKEY_API_BASE_URL
• Vite/Web: VITE_AGEKEY_API_BASE_URL (requires VITE_ prefix)