@gj-kit/expo-auth

공동 refresh와 storage adapter를 포함한 Expo, React Native, 웹용 토큰 수명주기 프리미티브입니다.

현재 npm 최신판: 0.1.1

사용할 때

모바일과 브라우저 클라이언트 전체에서 재사용할 토큰 refresh 및 영속 경계가 필요할 때 사용합니다.

사용하지 않을 때

앱 route, identity provider 정책, telemetry, API client 소유권을 패키지에 넣지 마세요.

Golden path

완료 상태: 로그인 상태를 저장하고 동시 refresh를 조정하는 앱 소유 세션 하나를 만듭니다.

1. 설치

pnpm add @gj-kit/expo-auth

2. 앱이 소유할 경계를 정합니다

storage adapter를 한 번 선택하고, 앱의 refresh endpoint 콜백만 연결합니다.

3. 최소 연결부터 시작합니다

먼저 아래 코드를 복사한 뒤, 위에서 언급한 앱 소유 값만 교체하세요.

import { createAuthSession, type RefreshRequest } from '@gj-kit/expo-auth';
import { createTokenStorage, createWebLocksRefreshLock } from '@gj-kit/expo-auth/storage';

declare const refresh: RefreshRequest; // Your API client classifies rotated, invalid, or transient.

export const session = createAuthSession({
  storage: createTokenStorage({ keyPrefix: 'myapp.auth' }),
  lock: createWebLocksRefreshLock({ name: 'myapp.auth' }),
  refresh,
});

환경과 peer

엔진: node >=20

Peer	지원 범위	필요한 위치
`expo-secure-store`	`>=14.0.0`	문서화된 optional subpath에서만

공개 subpath

Entry	Exported symbols
`Root entry`	19
`./storage`	3
`./testing`	8

안전 경계

토큰은 secret으로 취급하세요. 제공된 오류 계약을 사용하고 토큰 문자열이나 원본 authorization 응답을 로그에 남기지 마세요.

API reference

전체 API reference에는 선언 파일에서 생성한 모든 공개 함수, 클래스, 타입, 상수, 오류 계약이 있습니다. 각 항목은 import path, release signature, package version을 표시합니다.