@ce1pers/social-login-redirect

브라우저에서 social login provider의 OAuth authorization URL을 만들거나 해당 URL로 이동시키는 TypeScript helper입니다. token 교환, callback 검증, 사용자 session 처리는 제공하지 않습니다.

설치

npm install @ce1pers/social-login-redirect

공개 API

make*LoginUrl은 URL 문자열을 반환하고, *Login은 window.location.href를 변경해 브라우저를 이동시킨 뒤 별도 값을 반환하지 않습니다.

| API | 입력 필드 | | --- | --- | | makeGoogleLoginUrl, googleLogin | 필수 client_id, redirect_uri, scope; 선택 response_type, access_type, state, include_granted_scopes, enable_granular_consent, login_hint, prompt | | makeKakaoLoginUrl, kakaoLogin | 필수 client_id, redirect_uri; 선택 response_type, scope, prompt, login_hint, service_terms, state, nonce | | makeNaverLoginUrl, naverLogin | 라이브러리 입력 필수 clientId, redirectUri, state; 선택 response_type | | appleLogin | client_id, redirect_uri, nonce, response_mode, scope, state; 선택 response_type | | facebookLogin | client_id, redirect_uri, state; 선택 version, response_type, scope | | makeLineLoginUrl, lineLogin | client_id, redirect_uri, state, scope; response_type는 code 기본값, version, nonce, prompt, max_age, ui_locales, bot_prompt, initial_amr_display, switch_amr, disable_auto_login, disable_ios_auto_login, code_challenge, code_challenge_method, response_mode 선택 |

Provider마다 필드명이 다릅니다. Kakao·Google은 라이브러리 입력과 URL에서 client_id/redirect_uri를 사용하고, Naver는 라이브러리 입력으로 clientId/redirectUri를 받은 뒤 URL에서는 client_id/redirect_uri로 변환합니다.

사용 예제

import {
  googleLogin,
  makeKakaoLoginUrl,
  makeLineLoginUrl,
  makeNaverLoginUrl,
} from "@ce1pers/social-login-redirect";

const kakaoUrl = makeKakaoLoginUrl({
  client_id: "YOUR_KAKAO_REST_API_KEY",
  redirect_uri: "https://example.com/auth/kakao/callback",
  state: "random-state-value",
});

const naverUrl = makeNaverLoginUrl({
  clientId: "YOUR_NAVER_CLIENT_ID",
  redirectUri: "https://example.com/auth/naver/callback",
  state: "random-state-value",
});

const lineUrl = makeLineLoginUrl({
  client_id: "YOUR_LINE_CHANNEL_ID",
  redirect_uri: "https://example.com/auth/line/callback",
  state: "random-state-value",
  scope: "profile openid email",
});

// URL을 직접 이동시키는 함수는 반환값이 없습니다.
googleLogin({
  client_id: "YOUR_GOOGLE_CLIENT_ID",
  redirect_uri: "https://example.com/auth/google/callback",
  scope: "openid email profile",
  state: "random-state-value",
});

redirect_uri는 각 provider console에 등록한 원본 callback URL을 전달하며, helper가 query string에 맞게 인코딩합니다. state는 로그인 시도마다 예측할 수 없는 값으로 만들고 callback에서 원래 값과 비교해야 합니다. 이 라이브러리는 state·PKCE 검증이나 token 교환을 대신하지 않습니다.

검증

npm run lint
npm run build
npm test

관련 문서

• 저장소 문서 지도
• Google OAuth 공식 문서
• LINE Login 공식 문서