@alien_org/sso-sdk-core
v1.0.23
Published
Core TypeScript client for [Alien SSO](https://alien.org) authentication. Provides OIDC-compatible authentication with blockchain and TEE backing.
Readme
@alien_org/sso-sdk-core
Core TypeScript client for Alien SSO authentication. Provides OIDC-compatible authentication with blockchain and TEE backing.
⚠️ Alpha Version Notice
This is an early alpha version. The SDK is under active development and may contain bugs or undergo breaking changes. Use with caution in production environments.
Installation
npm install @alien_org/sso-sdk-coreFeatures
- ✅ TypeScript-first with full type safety
- ✅ Runtime validation via Zod schemas
- ✅ PKCE support for secure authorization
- ✅ Dual exports: ESM and CJS
- ✅ Zero UI dependencies - use in any JavaScript environment
- ✅ Storage management for tokens and session data
Documentation
📚 Full documentation at dev.alien.org/docs
- Integration Guide - Complete integration walkthrough
- API Reference - Detailed API documentation
- What is Alien Session? - Session architecture explained
- Demo App - Example application
React Integration
If you're using React, check out @alien_org/sso-sdk-react for hooks and pre-built components:
npm install @alien_org/sso-sdk-reactAuthentication Flow
- Generate deeplink → Display QR code or redirect
- User authenticates in Alien mobile app
- Poll for completion → Get authorization code
- Exchange code → Receive access token
- Verify token → Validate with server (optional)
Storage
The SDK uses browser storage for session management:
- localStorage:
alien-sso_access_token- Access token - sessionStorage:
alien-sso_code_verifier- PKCE code verifier
Getting a Provider Address
Register your application at the Developer Portal to get your provider credentials.
TypeScript Support
Includes full TypeScript declarations with Zod runtime validation:
import type {
AlienSsoClientConfig,
AuthorizeResponse,
PollResponse,
ExchangeCodeResponse,
TokenInfo
} from '@alien_org/sso-sdk-core';Browser Support
- Modern browsers with ES2020+ support
- Chrome, Firefox, Safari, Edge (latest versions)
License
MIT
