@hammadj/better-auth-core 1.5.0-beta.9

package/src/social-providers/index.ts

@@ -0,0 +1,127 @@
+import * as z from "zod";
+import { apple } from "./apple";
+import { atlassian } from "./atlassian";
+import { cognito } from "./cognito";
+import { discord } from "./discord";
+import { dropbox } from "./dropbox";
+import { facebook } from "./facebook";
+import { figma } from "./figma";
+import { github } from "./github";
+import { gitlab } from "./gitlab";
+import { google } from "./google";
+import { huggingface } from "./huggingface";
+import { kakao } from "./kakao";
+import { kick } from "./kick";
+import { line } from "./line";
+import { linear } from "./linear";
+import { linkedin } from "./linkedin";
+import { microsoft } from "./microsoft-entra-id";
+import { naver } from "./naver";
+import { notion } from "./notion";
+import { paybin } from "./paybin";
+import { paypal } from "./paypal";
+import { polar } from "./polar";
+import { reddit } from "./reddit";
+import { roblox } from "./roblox";
+import { salesforce } from "./salesforce";
+import { slack } from "./slack";
+import { spotify } from "./spotify";
+import { tiktok } from "./tiktok";
+import { twitch } from "./twitch";
+import { twitter } from "./twitter";
+import { vercel } from "./vercel";
+import { vk } from "./vk";
+import { zoom } from "./zoom";
+
+export const socialProviders = {
+	apple,
+	atlassian,
+	cognito,
+	discord,
+	facebook,
+	figma,
+	github,
+	microsoft,
+	google,
+	huggingface,
+	slack,
+	spotify,
+	twitch,
+	twitter,
+	dropbox,
+	kick,
+	linear,
+	linkedin,
+	gitlab,
+	tiktok,
+	reddit,
+	roblox,
+	salesforce,
+	vk,
+	zoom,
+	notion,
+	kakao,
+	naver,
+	line,
+	paybin,
+	paypal,
+	polar,
+	vercel,
+};
+
+export const socialProviderList = Object.keys(socialProviders) as [
+	"github",
+	...(keyof typeof socialProviders)[],
+];
+
+export const SocialProviderListEnum = z
+	.enum(socialProviderList)
+	.or(z.string()) as z.ZodType<SocialProviderList[number] | (string & {})>;
+
+export type SocialProvider = z.infer<typeof SocialProviderListEnum>;
+
+export type SocialProviders = {
+	[K in SocialProviderList[number]]?: Parameters<
+		(typeof socialProviders)[K]
+	>[0] & {
+		enabled?: boolean | undefined;
+	};
+};
+
+export * from "./apple";
+export * from "./atlassian";
+export * from "./cognito";
+export * from "./discord";
+export * from "./dropbox";
+export * from "./facebook";
+export * from "./figma";
+export * from "./github";
+export * from "./gitlab";
+export * from "./google";
+export * from "./huggingface";
+export * from "./kakao";
+export * from "./kick";
+export * from "./kick";
+export * from "./line";
+export * from "./linear";
+export * from "./linkedin";
+export * from "./linkedin";
+export * from "./microsoft-entra-id";
+export * from "./naver";
+export * from "./notion";
+export * from "./paybin";
+export * from "./paypal";
+export * from "./polar";
+export * from "./reddit";
+export * from "./roblox";
+export * from "./salesforce";
+export * from "./slack";
+export * from "./spotify";
+export * from "./tiktok";
+export * from "./twitch";
+export * from "./twitter";
+export * from "./vercel";
+export * from "./vk";
+export * from "./zoom";
+
+export type SocialProviderList = typeof socialProviderList;

package/src/social-providers/kakao.ts

@@ -0,0 +1,178 @@
+import { betterFetch } from "@better-fetch/fetch";
+import type { OAuthProvider, ProviderOptions } from "../oauth2";
+import {
+	createAuthorizationURL,
+	refreshAccessToken,
+	validateAuthorizationCode,
+} from "../oauth2";
+
+interface Partner {
+	/** Partner-specific ID (consent required: kakaotalk_message) */
+	uuid?: string | undefined;
+}
+
+interface Profile {
+	/** Nickname (consent required: profile/nickname) */
+	nickname?: string | undefined;
+	/** Thumbnail image URL (consent required: profile/profile image) */
+	thumbnail_image_url?: string | undefined;
+	/** Profile image URL (consent required: profile/profile image) */
+	profile_image_url?: string | undefined;
+	/** Whether the profile image is the default */
+	is_default_image?: boolean | undefined;
+	/** Whether the nickname is the default */
+	is_default_nickname?: boolean | undefined;
+}
+
+interface KakaoAccount {
+	/** Consent required: profile info (nickname/profile image) */
+	profile_needs_agreement?: boolean | undefined;
+	/** Consent required: nickname */
+	profile_nickname_needs_agreement?: boolean | undefined;
+	/** Consent required: profile image */
+	profile_image_needs_agreement?: boolean | undefined;
+	/** Profile info */
+	profile?: Profile | undefined;
+	/** Consent required: name */
+	name_needs_agreement?: boolean | undefined;
+	/** Name */
+	name?: string | undefined;
+	/** Consent required: email */
+	email_needs_agreement?: boolean | undefined;
+	/** Email valid */
+	is_email_valid?: boolean | undefined;
+	/** Email verified */
+	is_email_verified?: boolean | undefined;
+	/** Email */
+	email?: string | undefined;
+	/** Consent required: age range */
+	age_range_needs_agreement?: boolean | undefined;
+	/** Age range */
+	age_range?: string | undefined;
+	/** Consent required: birth year */
+	birthyear_needs_agreement?: boolean | undefined;
+	/** Birth year (YYYY) */
+	birthyear?: string | undefined;
+	/** Consent required: birthday */
+	birthday_needs_agreement?: boolean | undefined;
+	/** Birthday (MMDD) */
+	birthday?: string | undefined;
+	/** Birthday type (SOLAR/LUNAR) */
+	birthday_type?: string | undefined;
+	/** Whether birthday is in a leap month */
+	is_leap_month?: boolean | undefined;
+	/** Consent required: gender */
+	gender_needs_agreement?: boolean | undefined;
+	/** Gender (male/female) */
+	gender?: string | undefined;
+	/** Consent required: phone number */
+	phone_number_needs_agreement?: boolean | undefined;
+	/** Phone number */
+	phone_number?: string | undefined;
+	/** Consent required: CI */
+	ci_needs_agreement?: boolean | undefined;
+	/** CI (unique identifier) */
+	ci?: string | undefined;
+	/** CI authentication time (UTC) */
+	ci_authenticated_at?: string | undefined;
+}
+
+export interface KakaoProfile {
+	/** Kakao user ID */
+	id: number;
+	/**
+	 * Whether the user has signed up (only present if auto-connection is disabled)
+	 * false: preregistered, true: registered
+	 */
+	has_signed_up?: boolean | undefined;
+	/** UTC datetime when the user connected the service */
+	connected_at?: string | undefined;
+	/** UTC datetime when the user signed up via Kakao Sync */
+	synched_at?: string | undefined;
+	/** Custom user properties */
+	properties?: Record<string, any> | undefined;
+	/** Kakao account info */
+	kakao_account: KakaoAccount;
+	/** Partner info */
+	for_partner?: Partner | undefined;
+}
+
+export interface KakaoOptions extends ProviderOptions<KakaoProfile> {
+	clientId: string;
+}
+
+export const kakao = (options: KakaoOptions) => {
+	return {
+		id: "kakao",
+		name: "Kakao",
+		createAuthorizationURL({ state, scopes, redirectURI }) {
+			const _scopes = options.disableDefaultScope
+				? []
+				: ["account_email", "profile_image", "profile_nickname"];
+			if (options.scope) _scopes.push(...options.scope);
+			if (scopes) _scopes.push(...scopes);
+			return createAuthorizationURL({
+				id: "kakao",
+				options,
+				authorizationEndpoint: "https://kauth.kakao.com/oauth/authorize",
+				scopes: _scopes,
+				state,
+				redirectURI,
+			});
+		},
+		validateAuthorizationCode: async ({ code, redirectURI }) => {
+			return validateAuthorizationCode({
+				code,
+				redirectURI,
+				options,
+				tokenEndpoint: "https://kauth.kakao.com/oauth/token",
+			});
+		},
+		refreshAccessToken: options.refreshAccessToken
+			? options.refreshAccessToken
+			: async (refreshToken) => {
+					return refreshAccessToken({
+						refreshToken,
+						options: {
+							clientId: options.clientId,
+							clientKey: options.clientKey,
+							clientSecret: options.clientSecret,
+						},
+						tokenEndpoint: "https://kauth.kakao.com/oauth/token",
+					});
+				},
+		async getUserInfo(token) {
+			if (options.getUserInfo) {
+				return options.getUserInfo(token);
+			}
+			const { data: profile, error } = await betterFetch<KakaoProfile>(
+				"https://kapi.kakao.com/v2/user/me",
+				{
+					headers: {
+						Authorization: `Bearer ${token.accessToken}`,
+					},
+				},
+			);
+			if (error || !profile) {
+				return null;
+			}
+			const userMap = await options.mapProfileToUser?.(profile);
+			const account = profile.kakao_account || {};
+			const kakaoProfile = account.profile || {};
+			const user = {
+				id: String(profile.id),
+				name: kakaoProfile.nickname || account.name || undefined,
+				email: account.email,
+				image:
+					kakaoProfile.profile_image_url || kakaoProfile.thumbnail_image_url,
+				emailVerified: !!account.is_email_valid && !!account.is_email_verified,
+				...userMap,
+			};
+			return {
+				user,
+				data: profile,
+			};
+		},
+		options,
+	} satisfies OAuthProvider<KakaoProfile>;
+};

package/src/social-providers/kick.ts

@@ -0,0 +1,109 @@
+import { betterFetch } from "@better-fetch/fetch";
+import type { OAuthProvider, ProviderOptions } from "../oauth2";
+import {
+	createAuthorizationURL,
+	refreshAccessToken,
+	validateAuthorizationCode,
+} from "../oauth2";
+
+export interface KickProfile {
+	/**
+	 * The user id of the user
+	 */
+	user_id: string;
+	/**
+	 * The name of the user
+	 */
+	name: string;
+	/**
+	 * The email of the user
+	 */
+	email: string;
+	/**
+	 * The picture of the user
+	 */
+	profile_picture: string;
+}
+
+export interface KickOptions extends ProviderOptions<KickProfile> {
+	clientId: string;
+}
+
+export const kick = (options: KickOptions) => {
+	return {
+		id: "kick",
+		name: "Kick",
+		createAuthorizationURL({ state, scopes, redirectURI, codeVerifier }) {
+			const _scopes = options.disableDefaultScope ? [] : ["user:read"];
+			if (options.scope) _scopes.push(...options.scope);
+			if (scopes) _scopes.push(...scopes);
+
+			return createAuthorizationURL({
+				id: "kick",
+				redirectURI,
+				options,
+				authorizationEndpoint: "https://id.kick.com/oauth/authorize",
+				scopes: _scopes,
+				codeVerifier,
+				state,
+			});
+		},
+		async validateAuthorizationCode({ code, redirectURI, codeVerifier }) {
+			return validateAuthorizationCode({
+				code,
+				redirectURI,
+				options,
+				tokenEndpoint: "https://id.kick.com/oauth/token",
+				codeVerifier,
+			});
+		},
+		refreshAccessToken: options.refreshAccessToken
+			? options.refreshAccessToken
+			: async (refreshToken) => {
+					return refreshAccessToken({
+						refreshToken,
+						options: {
+							clientId: options.clientId,
+							clientSecret: options.clientSecret,
+						},
+						tokenEndpoint: "https://id.kick.com/oauth/token",
+					});
+				},
+		async getUserInfo(token) {
+			if (options.getUserInfo) {
+				return options.getUserInfo(token);
+			}
+
+			const { data, error } = await betterFetch<{
+				data: KickProfile[];
+			}>("https://api.kick.com/public/v1/users", {
+				method: "GET",
+				headers: {
+					Authorization: `Bearer ${token.accessToken}`,
+				},
+			});
+
+			if (error) {
+				return null;
+			}
+
+			const profile = data.data[0]!;
+
+			const userMap = await options.mapProfileToUser?.(profile);
+			// Kick does not provide email_verified claim.
+			// We default to false for security consistency.
+			return {
+				user: {
+					id: profile.user_id,
+					name: profile.name,
+					email: profile.email,
+					image: profile.profile_picture,
+					emailVerified: false,
+					...userMap,
+				},
+				data: profile,
+			};
+		},
+		options,
+	} satisfies OAuthProvider<KickProfile>;
+};

package/src/social-providers/line.ts

@@ -0,0 +1,169 @@
+import { betterFetch } from "@better-fetch/fetch";
+import { decodeJwt } from "jose";
+import type { OAuthProvider, ProviderOptions } from "../oauth2";
+import {
+	createAuthorizationURL,
+	refreshAccessToken,
+	validateAuthorizationCode,
+} from "../oauth2";
+
+export interface LineIdTokenPayload {
+	iss: string;
+	sub: string;
+	aud: string;
+	exp: number;
+	iat: number;
+	name?: string | undefined;
+	picture?: string | undefined;
+	email?: string | undefined;
+	amr?: string[] | undefined;
+	nonce?: string | undefined;
+}
+
+export interface LineUserInfo {
+	sub: string;
+	name?: string | undefined;
+	picture?: string | undefined;
+	email?: string | undefined;
+}
+
+export interface LineOptions
+	extends ProviderOptions<LineUserInfo | LineIdTokenPayload> {
+	clientId: string;
+}
+
+/**
+ * LINE Login v2.1
+ * - Authorization endpoint: https://access.line.me/oauth2/v2.1/authorize
+ * - Token endpoint: https://api.line.me/oauth2/v2.1/token
+ * - UserInfo endpoint: https://api.line.me/oauth2/v2.1/userinfo
+ * - Verify ID token: https://api.line.me/oauth2/v2.1/verify
+ *
+ * Docs: https://developers.line.biz/en/reference/line-login/#issue-access-token
+ */
+export const line = (options: LineOptions) => {
+	const authorizationEndpoint = "https://access.line.me/oauth2/v2.1/authorize";
+	const tokenEndpoint = "https://api.line.me/oauth2/v2.1/token";
+	const userInfoEndpoint = "https://api.line.me/oauth2/v2.1/userinfo";
+	const verifyIdTokenEndpoint = "https://api.line.me/oauth2/v2.1/verify";
+
+	return {
+		id: "line",
+		name: "LINE",
+		async createAuthorizationURL({
+			state,
+			scopes,
+			codeVerifier,
+			redirectURI,
+			loginHint,
+		}) {
+			const _scopes = options.disableDefaultScope
+				? []
+				: ["openid", "profile", "email"];
+			if (options.scope) _scopes.push(...options.scope);
+			if (scopes) _scopes.push(...scopes);
+			return await createAuthorizationURL({
+				id: "line",
+				options,
+				authorizationEndpoint,
+				scopes: _scopes,
+				state,
+				codeVerifier,
+				redirectURI,
+				loginHint,
+			});
+		},
+		validateAuthorizationCode: async ({ code, codeVerifier, redirectURI }) => {
+			return validateAuthorizationCode({
+				code,
+				codeVerifier,
+				redirectURI,
+				options,
+				tokenEndpoint,
+			});
+		},
+		refreshAccessToken: options.refreshAccessToken
+			? options.refreshAccessToken
+			: async (refreshToken) => {
+					return refreshAccessToken({
+						refreshToken,
+						options: {
+							clientId: options.clientId,
+							clientSecret: options.clientSecret,
+						},
+						tokenEndpoint,
+					});
+				},
+		async verifyIdToken(token, nonce) {
+			if (options.disableIdTokenSignIn) {
+				return false;
+			}
+			if (options.verifyIdToken) {
+				return options.verifyIdToken(token, nonce);
+			}
+			const body = new URLSearchParams();
+			body.set("id_token", token);
+			body.set("client_id", options.clientId);
+			if (nonce) body.set("nonce", nonce);
+			const { data, error } = await betterFetch<LineIdTokenPayload>(
+				verifyIdTokenEndpoint,
+				{
+					method: "POST",
+					headers: {
+						"content-type": "application/x-www-form-urlencoded",
+					},
+					body,
+				},
+			);
+			if (error || !data) {
+				return false;
+			}
+			// aud must match clientId; nonce (if provided) must also match nonce
+			if (data.aud !== options.clientId) return false;
+			if (data.nonce && data.nonce !== nonce) return false;
+			return true;
+		},
+		async getUserInfo(token) {
+			if (options.getUserInfo) {
+				return options.getUserInfo(token);
+			}
+			let profile: LineUserInfo | LineIdTokenPayload | null = null;
+			// Prefer ID token if available
+			if (token.idToken) {
+				try {
+					profile = decodeJwt(token.idToken) as LineIdTokenPayload;
+				} catch {}
+			}
+			// Fallback to UserInfo endpoint
+			if (!profile) {
+				const { data } = await betterFetch<LineUserInfo>(userInfoEndpoint, {
+					headers: {
+						authorization: `Bearer ${token.accessToken}`,
+					},
+				});
+				profile = data || null;
+			}
+			if (!profile) return null;
+			const userMap = await options.mapProfileToUser?.(profile as any);
+			// ID preference order
+			const id = (profile as any).sub || (profile as any).userId;
+			const name = (profile as any).name || (profile as any).displayName;
+			const image =
+				(profile as any).picture || (profile as any).pictureUrl || undefined;
+			const email = (profile as any).email;
+			return {
+				user: {
+					id,
+					name,
+					email,
+					image,
+					// LINE does not expose email verification status in ID token/userinfo
+					emailVerified: false,
+					...userMap,
+				},
+				data: profile as any,
+			};
+		},
+		options,
+	} satisfies OAuthProvider<LineUserInfo | LineIdTokenPayload, LineOptions>;
+};

package/src/social-providers/linear.ts

@@ -0,0 +1,121 @@
+import { betterFetch } from "@better-fetch/fetch";
+import type { OAuthProvider, ProviderOptions } from "../oauth2";
+import {
+	createAuthorizationURL,
+	refreshAccessToken,
+	validateAuthorizationCode,
+} from "../oauth2";
+
+export interface LinearUser {
+	id: string;
+	name: string;
+	email: string;
+	avatarUrl?: string | undefined;
+	active: boolean;
+	createdAt: string;
+	updatedAt: string;
+}
+
+export interface LinearProfile {
+	data: {
+		viewer: LinearUser;
+	};
+}
+
+export interface LinearOptions extends ProviderOptions<LinearUser> {
+	clientId: string;
+}
+
+export const linear = (options: LinearOptions) => {
+	const tokenEndpoint = "https://api.linear.app/oauth/token";
+	return {
+		id: "linear",
+		name: "Linear",
+		createAuthorizationURL({ state, scopes, loginHint, redirectURI }) {
+			const _scopes = options.disableDefaultScope ? [] : ["read"];
+			if (options.scope) _scopes.push(...options.scope);
+			if (scopes) _scopes.push(...scopes);
+			return createAuthorizationURL({
+				id: "linear",
+				options,
+				authorizationEndpoint: "https://linear.app/oauth/authorize",
+				scopes: _scopes,
+				state,
+				redirectURI,
+				loginHint,
+			});
+		},
+		validateAuthorizationCode: async ({ code, redirectURI }) => {
+			return validateAuthorizationCode({
+				code,
+				redirectURI,
+				options,
+				tokenEndpoint,
+			});
+		},
+		refreshAccessToken: options.refreshAccessToken
+			? options.refreshAccessToken
+			: async (refreshToken) => {
+					return refreshAccessToken({
+						refreshToken,
+						options: {
+							clientId: options.clientId,
+							clientKey: options.clientKey,
+							clientSecret: options.clientSecret,
+						},
+						tokenEndpoint,
+					});
+				},
+		async getUserInfo(token) {
+			if (options.getUserInfo) {
+				return options.getUserInfo(token);
+			}
+
+			const { data: profile, error } = await betterFetch<LinearProfile>(
+				"https://api.linear.app/graphql",
+				{
+					method: "POST",
+					headers: {
+						"Content-Type": "application/json",
+						Authorization: `Bearer ${token.accessToken}`,
+					},
+					body: JSON.stringify({
+						query: `
+							query {
+								viewer {
+									id
+									name
+									email
+									avatarUrl
+									active
+									createdAt
+									updatedAt
+								}
+							}
+						`,
+					}),
+				},
+			);
+			if (error || !profile?.data?.viewer) {
+				return null;
+			}
+
+			const userData = profile.data.viewer;
+			const userMap = await options.mapProfileToUser?.(userData);
+			// Linear does not provide email_verified claim.
+			// We default to false for security consistency.
+			return {
+				user: {
+					id: profile.data.viewer.id,
+					name: profile.data.viewer.name,
+					email: profile.data.viewer.email,
+					image: profile.data.viewer.avatarUrl,
+					emailVerified: false,
+					...userMap,
+				},
+				data: userData,
+			};
+		},
+		options,
+	} satisfies OAuthProvider<LinearUser>;
+};