@kiauth/web-sdk 1.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,71 @@
1
+ import { KiauthConfig, KiauthUser, LoginOptions, ProgrammaticLoginOptions } from './types';
2
+ export declare class KiauthSDK {
3
+ private config;
4
+ private api;
5
+ private socket;
6
+ private modal;
7
+ private buttonRenderer;
8
+ private isFallbackMode;
9
+ private healthCheckIntervalId;
10
+ private pollIntervalId;
11
+ private completed;
12
+ constructor(config: KiauthConfig);
13
+ private startHealthCheck;
14
+ renderButton(selector: string, options: LoginOptions): void;
15
+ startLogin(options: ProgrammaticLoginOptions & {
16
+ onCancel?: () => void;
17
+ }): Promise<void>;
18
+ private startPolling;
19
+ private stopPolling;
20
+ private triggerOtpFallback;
21
+ verifyToken(token: string): Promise<{
22
+ valid: boolean;
23
+ user?: KiauthUser;
24
+ }>;
25
+ reportSession(options: {
26
+ kiauthUserToken: string;
27
+ externalSessionId: string;
28
+ authMethod: 'EMAIL_PASSWORD' | 'GOOGLE_OAUTH' | 'FACEBOOK' | 'PHONE_OTP' | 'APPLE' | 'PASSKEY' | 'UNKNOWN';
29
+ deviceName?: string;
30
+ deviceType?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'TV' | 'UNKNOWN';
31
+ ipAddress?: string;
32
+ location?: string;
33
+ userAgent?: string;
34
+ }): Promise<{
35
+ bridgedSessionId: string;
36
+ }>;
37
+ reportBatchSessions(kiauthUserToken: string, sessions: Array<{
38
+ externalSessionId: string;
39
+ authMethod: string;
40
+ deviceName?: string;
41
+ deviceType?: string;
42
+ ipAddress?: string;
43
+ location?: string;
44
+ createdAt?: string;
45
+ }>): Promise<{
46
+ created: number;
47
+ skipped: number;
48
+ }>;
49
+ reportSessionByEmail(options: {
50
+ email: string;
51
+ externalSessionId: string;
52
+ authMethod: 'EMAIL_PASSWORD' | 'GOOGLE_OAUTH' | 'FACEBOOK' | 'PHONE_OTP' | 'APPLE' | 'PASSKEY' | 'UNKNOWN';
53
+ deviceName?: string;
54
+ deviceLabel?: string;
55
+ deviceType?: 'MOBILE' | 'DESKTOP' | 'TABLET' | 'TV' | 'UNKNOWN';
56
+ ipAddress?: string;
57
+ location?: string;
58
+ userAgent?: string;
59
+ }): Promise<{
60
+ accepted: boolean;
61
+ }>;
62
+ logout(opts: {
63
+ accessToken?: string;
64
+ sessionId?: string;
65
+ externalSessionId?: string;
66
+ }): Promise<{
67
+ success: boolean;
68
+ sessionId: string;
69
+ }>;
70
+ destroy(): void;
71
+ }
@@ -0,0 +1,7 @@
1
+ export declare class QrModal {
2
+ private dialog;
3
+ private timerInterval;
4
+ show(sessionId: string, qrData: string, expiresIn: number, // in seconds
5
+ onRefresh: () => void, onCancel: () => void): void;
6
+ close(): void;
7
+ }
@@ -0,0 +1,21 @@
1
+ export declare class KiauthWebsocket {
2
+ private serverUrl;
3
+ private ws;
4
+ private pingIntervalId;
5
+ private reconnectTimeoutId;
6
+ private reconnectAttempts;
7
+ private maxReconnectAttempts;
8
+ private isIntentionalDisconnect;
9
+ constructor(serverUrl: string);
10
+ connect(channelId: string, onAuthComplete: (data: {
11
+ code: string;
12
+ user: any;
13
+ }) => void, onError: (error: {
14
+ code: string;
15
+ message: string;
16
+ }) => void): void;
17
+ private startPinging;
18
+ private stopPinging;
19
+ private attemptReconnect;
20
+ disconnect(): void;
21
+ }
@@ -0,0 +1,65 @@
1
+ import { KiauthConfig, InitiateSessionResponse, KiauthUser } from './types';
2
+ export declare class KiauthApi {
3
+ private baseUrl;
4
+ constructor(config: KiauthConfig);
5
+ private static resolveBaseUrl;
6
+ getBaseUrl(): string;
7
+ healthCheck(timeoutMs?: number): Promise<boolean>;
8
+ initiateSession(clientId: string, scopes: string[], redirectUri?: string, codeChallenge?: string): Promise<InitiateSessionResponse>;
9
+ getSessionStatus(sessionId: string): Promise<{
10
+ status: string;
11
+ authCode: string | null;
12
+ }>;
13
+ /**
14
+ * Exchange the authorization code for tokens. Public clients pass
15
+ * { codeVerifier } (PKCE); confidential clients pass { clientSecret }.
16
+ */
17
+ exchangeToken(code: string, clientId: string, credentials: {
18
+ codeVerifier?: string;
19
+ clientSecret?: string;
20
+ }): Promise<{
21
+ accessToken: string;
22
+ user: KiauthUser;
23
+ }>;
24
+ verifyToken(token: string): Promise<{
25
+ valid: boolean;
26
+ user?: KiauthUser;
27
+ }>;
28
+ reportSession(clientId: string, clientSecret: string, options: {
29
+ kiauthUserToken: string;
30
+ externalSessionId: string;
31
+ authMethod: string;
32
+ deviceName?: string;
33
+ deviceType?: string;
34
+ ipAddress?: string;
35
+ location?: string;
36
+ userAgent?: string;
37
+ }): Promise<{
38
+ bridgedSessionId: string;
39
+ }>;
40
+ reportBatchSessions(clientId: string, clientSecret: string, kiauthUserToken: string, sessions: any[]): Promise<{
41
+ created: number;
42
+ skipped: number;
43
+ }>;
44
+ reportSessionByEmail(clientId: string, clientSecret: string, options: {
45
+ email: string;
46
+ externalSessionId: string;
47
+ authMethod: string;
48
+ deviceName?: string;
49
+ deviceLabel?: string;
50
+ deviceType?: string;
51
+ ipAddress?: string;
52
+ location?: string;
53
+ userAgent?: string;
54
+ }): Promise<{
55
+ accepted: boolean;
56
+ }>;
57
+ endSession(clientId: string, clientSecret: string, opts: {
58
+ accessToken?: string;
59
+ sessionId?: string;
60
+ externalSessionId?: string;
61
+ }): Promise<{
62
+ success: boolean;
63
+ sessionId: string;
64
+ }>;
65
+ }
@@ -0,0 +1,2 @@
1
+ export { KiauthSDK } from './KiauthSDK';
2
+ export * from './types';
@@ -0,0 +1,2 @@
1
+ import { KiauthSDK } from './KiauthSDK';
2
+ export default KiauthSDK;
@@ -0,0 +1,8 @@
1
+ /**
2
+ * PKCE (RFC 7636) helpers for public/browser clients, so the SDK never needs a
3
+ * confidential clientSecret in the browser. Uses the Web Crypto API.
4
+ */
5
+ /** Cryptographically-random code_verifier (43 chars, base64url of 32 bytes). */
6
+ export declare function generateCodeVerifier(): string;
7
+ /** code_challenge = BASE64URL(SHA256(code_verifier)). */
8
+ export declare function generateCodeChallenge(verifier: string): Promise<string>;
@@ -0,0 +1,2 @@
1
+ export declare const CSS_STYLES = "\n @import url('https://fonts.googleapis.com/css2?family=Outfit:wght@300;400;500;600;700&display=swap');\n\n :root {\n --kiauth-purple: #534ab7;\n --kiauth-purple-hover: #423a9c;\n --kiauth-bg-dark: #0f0c1b;\n --kiauth-border-dark: rgba(255, 255, 255, 0.1);\n --kiauth-glass: rgba(15, 12, 27, 0.7);\n --kiauth-glow: rgba(83, 74, 183, 0.3);\n }\n\n .kiauth-dialog {\n border: none;\n border-radius: 20px;\n padding: 0;\n background: var(--kiauth-bg-dark);\n box-shadow: 0 20px 50px rgba(0, 0, 0, 0.5), 0 0 0 1px var(--kiauth-border-dark), 0 0 30px var(--kiauth-glow);\n max-width: 420px;\n width: 90%;\n color: #ffffff;\n font-family: 'Outfit', -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n overflow: hidden;\n outline: none;\n opacity: 0;\n transform: scale(0.9);\n transition: opacity 0.3s cubic-bezier(0.16, 1, 0.3, 1), transform 0.3s cubic-bezier(0.16, 1, 0.3, 1);\n }\n\n .kiauth-dialog[open] {\n opacity: 1;\n transform: scale(1);\n }\n\n .kiauth-dialog::backdrop {\n background: rgba(10, 8, 20, 0.75);\n backdrop-filter: blur(12px);\n opacity: 0;\n transition: opacity 0.3s ease;\n }\n\n .kiauth-dialog[open]::backdrop {\n opacity: 1;\n }\n\n .kiauth-modal-content {\n padding: 32px 24px;\n display: flex;\n flex-direction: column;\n align-items: center;\n text-align: center;\n }\n\n .kiauth-header {\n display: flex;\n justify-content: space-between;\n align-items: center;\n width: 100%;\n margin-bottom: 24px;\n }\n\n .kiauth-title {\n font-size: 22px;\n font-weight: 600;\n color: #ffffff;\n margin: 0;\n letter-spacing: -0.5px;\n display: flex;\n align-items: center;\n gap: 8px;\n }\n\n .kiauth-title span {\n color: var(--kiauth-purple);\n font-weight: 700;\n }\n\n .kiauth-close-btn {\n background: transparent;\n border: none;\n color: rgba(255, 255, 255, 0.5);\n font-size: 24px;\n cursor: pointer;\n line-height: 1;\n padding: 4px;\n transition: color 0.2s;\n }\n\n .kiauth-close-btn:hover {\n color: #ffffff;\n }\n\n .kiauth-qr-container {\n background: #ffffff;\n padding: 16px;\n border-radius: 16px;\n margin-bottom: 20px;\n box-shadow: 0 8px 30px rgba(0, 0, 0, 0.3);\n position: relative;\n display: flex;\n justify-content: center;\n align-items: center;\n width: 220px;\n height: 220px;\n }\n\n .kiauth-qr-img {\n width: 200px;\n height: 200px;\n display: block;\n }\n\n .kiauth-qr-expired {\n position: absolute;\n top: 0;\n left: 0;\n right: 0;\n bottom: 0;\n background: rgba(15, 12, 27, 0.95);\n backdrop-filter: blur(4px);\n border-radius: 16px;\n display: flex;\n flex-direction: column;\n justify-content: center;\n align-items: center;\n color: #ffffff;\n opacity: 0;\n pointer-events: none;\n transition: opacity 0.3s;\n padding: 16px;\n }\n\n .kiauth-qr-expired.active {\n opacity: 1;\n pointer-events: auto;\n }\n\n .kiauth-btn-refresh {\n background: var(--kiauth-purple);\n color: #ffffff;\n border: none;\n padding: 10px 20px;\n border-radius: 8px;\n font-weight: 500;\n cursor: pointer;\n margin-top: 12px;\n font-family: inherit;\n transition: background 0.2s;\n }\n\n .kiauth-btn-refresh:hover {\n background: var(--kiauth-purple-hover);\n }\n\n .kiauth-instructions {\n font-size: 14px;\n color: rgba(255, 255, 255, 0.7);\n margin-bottom: 24px;\n line-height: 1.5;\n }\n\n .kiauth-timer {\n font-size: 13px;\n color: rgba(255, 255, 255, 0.4);\n margin-bottom: 20px;\n }\n\n .kiauth-timer span {\n color: var(--kiauth-purple);\n font-weight: 600;\n }\n\n .kiauth-divider {\n width: 100%;\n height: 1px;\n background: var(--kiauth-border-dark);\n margin: 20px 0;\n }\n\n .kiauth-mobile-direct {\n display: flex;\n flex-direction: column;\n gap: 12px;\n width: 100%;\n }\n\n .kiauth-btn-direct {\n background: var(--kiauth-purple);\n color: #ffffff;\n border: none;\n padding: 14px;\n border-radius: 12px;\n font-size: 16px;\n font-weight: 600;\n cursor: pointer;\n font-family: inherit;\n text-decoration: none;\n display: inline-block;\n transition: background 0.2s, transform 0.1s;\n box-shadow: 0 4px 12px var(--kiauth-glow);\n }\n\n .kiauth-btn-direct:hover {\n background: var(--kiauth-purple-hover);\n }\n\n .kiauth-btn-direct:active {\n transform: scale(0.98);\n }\n\n /* Button Renderers */\n .kiauth-login-button {\n display: inline-flex;\n align-items: center;\n justify-content: center;\n gap: 10px;\n font-family: 'Outfit', sans-serif;\n font-weight: 600;\n border-radius: 10px;\n cursor: pointer;\n transition: all 0.2s ease;\n border: 1px solid transparent;\n user-select: none;\n }\n\n .kiauth-btn-purple {\n background-color: var(--kiauth-purple);\n color: #ffffff;\n }\n .kiauth-btn-purple:hover {\n background-color: var(--kiauth-purple-hover);\n }\n\n .kiauth-btn-white {\n background-color: #ffffff;\n color: #0f0c1b;\n border-color: rgba(0, 0, 0, 0.1);\n }\n .kiauth-btn-white:hover {\n background-color: #f5f5f7;\n }\n\n .kiauth-btn-dark {\n background-color: #0f0c1b;\n color: #ffffff;\n border-color: var(--kiauth-border-dark);\n }\n .kiauth-btn-dark:hover {\n background-color: #1a1530;\n }\n\n .kiauth-btn-small {\n padding: 8px 16px;\n font-size: 13px;\n }\n .kiauth-btn-medium {\n padding: 12px 24px;\n font-size: 15px;\n }\n .kiauth-btn-large {\n padding: 16px 32px;\n font-size: 17px;\n }\n\n /* Fallback Form */\n .kiauth-fallback-container {\n width: 100%;\n display: flex;\n flex-direction: column;\n align-items: center;\n }\n\n .kiauth-input-group {\n width: 100%;\n margin-bottom: 16px;\n text-align: left;\n }\n\n .kiauth-input-label {\n display: block;\n font-size: 12px;\n font-weight: 500;\n color: rgba(255, 255, 255, 0.5);\n margin-bottom: 6px;\n text-transform: uppercase;\n letter-spacing: 0.5px;\n }\n\n .kiauth-input {\n width: 100%;\n background: rgba(255, 255, 255, 0.05);\n border: 1px solid var(--kiauth-border-dark);\n padding: 12px;\n border-radius: 8px;\n color: #ffffff;\n font-family: inherit;\n font-size: 15px;\n box-sizing: border-box;\n transition: border-color 0.2s, box-shadow 0.2s;\n }\n\n .kiauth-input:focus {\n outline: none;\n border-color: var(--kiauth-purple);\n box-shadow: 0 0 10px var(--kiauth-glow);\n }\n\n .kiauth-otp-inputs {\n display: flex;\n justify-content: space-between;\n gap: 8px;\n margin: 16px 0;\n width: 100%;\n }\n\n .kiauth-otp-box {\n width: 45px;\n height: 45px;\n background: rgba(255, 255, 255, 0.05);\n border: 1px solid var(--kiauth-border-dark);\n border-radius: 8px;\n text-align: center;\n color: #ffffff;\n font-size: 20px;\n font-weight: 600;\n transition: border-color 0.2s;\n }\n\n .kiauth-otp-box:focus {\n outline: none;\n border-color: var(--kiauth-purple);\n box-shadow: 0 0 10px var(--kiauth-glow);\n }\n\n .kiauth-spinner {\n border: 2px solid rgba(255, 255, 255, 0.1);\n width: 18px;\n height: 18px;\n border-radius: 50%;\n border-left-color: #ffffff;\n animation: spin 0.8s linear infinite;\n display: inline-block;\n }\n\n @keyframes spin {\n 0% { transform: rotate(0deg); }\n 100% { transform: rotate(360deg); }\n }\n";
2
+ export declare function injectStyles(): void;
@@ -0,0 +1,47 @@
1
+ export interface KiauthConfig {
2
+ clientId: string;
3
+ clientSecret?: string;
4
+ scopes: ('name' | 'email' | 'dob' | 'gender' | 'phone')[];
5
+ environment: 'sandbox' | 'production';
6
+ redirectUri?: string;
7
+ baseUrl?: string;
8
+ }
9
+ export interface KiauthUser {
10
+ name: string;
11
+ email: string | null;
12
+ kiauth_verified: boolean;
13
+ userToken: string;
14
+ verificationExpiry: string;
15
+ }
16
+ export interface ButtonStyleOptions {
17
+ text?: string;
18
+ theme?: 'purple' | 'white' | 'dark';
19
+ size?: 'small' | 'medium' | 'large';
20
+ color?: string;
21
+ textColor?: string;
22
+ shape?: 'rounded' | 'pill' | 'square';
23
+ fullWidth?: boolean;
24
+ logo?: boolean;
25
+ }
26
+ export interface LoginOptions extends ButtonStyleOptions {
27
+ onSuccess: (user: KiauthUser) => void;
28
+ onError: (error: {
29
+ code: string;
30
+ message: string;
31
+ }) => void;
32
+ onCancel?: () => void;
33
+ }
34
+ export interface ProgrammaticLoginOptions {
35
+ onSuccess: (user: KiauthUser) => void;
36
+ onError: (error: {
37
+ code: string;
38
+ message: string;
39
+ }) => void;
40
+ }
41
+ export interface InitiateSessionResponse {
42
+ success: boolean;
43
+ sessionId: string;
44
+ channelId: string;
45
+ qrData: string;
46
+ expiresIn: number;
47
+ }
package/package.json ADDED
@@ -0,0 +1,28 @@
1
+ {
2
+ "name": "@kiauth/web-sdk",
3
+ "version": "1.0.0",
4
+ "description": "Kiauth Business Web SDK",
5
+ "publishConfig": {
6
+ "access": "public"
7
+ },
8
+ "main": "dist/kiauth-sdk.js",
9
+ "module": "dist/kiauth-sdk.js",
10
+ "types": "dist/types/index.d.ts",
11
+ "files": [
12
+ "dist",
13
+ "README.md"
14
+ ],
15
+ "scripts": {
16
+ "build": "rollup -c rollup.config.mjs",
17
+ "prepack": "rollup -c rollup.config.mjs"
18
+ },
19
+ "devDependencies": {
20
+ "@rollup/plugin-typescript": "^11.1.5",
21
+ "@rollup/plugin-node-resolve": "^15.2.3",
22
+ "@rollup/plugin-commonjs": "^25.0.7",
23
+ "rollup": "^4.6.0",
24
+ "typescript": "^5.3.2",
25
+ "tslib": "^2.6.2",
26
+ "qrcode-generator": "^1.4.4"
27
+ }
28
+ }