@sayren/storefront-sdk 0.1.0

package/src/session.ts

@@ -0,0 +1,212 @@
+import { toApiError, unwrapData } from "./http";
+import type { LoginRequest, SignupRequest, TokenPair } from "./schemas/auth";
+import { loginRequestSchema, signupRequestSchema, tokenPairSchema } from "./schemas/auth";
+import type { Member } from "./schemas/member";
+import { memberSchema } from "./schemas/member";
+
+/**
+ * SDK 세션 매니저 — 스토어프론트(회원, member) CREDENTIAL 로그인(email/password)의
+ * 저장·무음 갱신·회전을 캡슐화한다. store-sdk의 세션과 동형이지만 진입 메서드는
+ * `.login()`이다 (구매자는 oauth2 authorize 플로우를 타지 않는다 — `/auth/login` → tokenPair).
+ *
+ * 저장 매체(쿠키/localStorage/…)와 그 속성은 **어댑터(앱) 책임**이다. SDK는 "무엇을 어떤 키로
+ * 저장할지"만 알고, "어떻게 저장할지"는 SessionStorage 어댑터에 위임한다.
+ */
+export interface SessionStorage {
+  get(key: string): string | null;
+  set(key: string, value: string): void;
+  remove(key: string): void;
+}
+
+/** 세션 키 상수 — SDK가 소유한다. store-sdk와 겹치지 않는 별도 네임스페이스. */
+export const STOREFRONT_SESSION_KEYS = {
+  accessToken: "sayren.storefront.accessToken",
+  refreshToken: "sayren.storefront.refreshToken",
+} as const;
+
+/** Web Locks 이름 — 탭 간 refresh 회전 직렬화용 */
+const REFRESH_LOCK = STOREFRONT_SESSION_KEYS.refreshToken;
+
+export interface StorefrontSessionOptions {
+  /** 예: https://shop.api.example.com/storefront/v1 */
+  baseUrl: string;
+  /** 테넌트 스토어 코드 — X-Store-Code 헤더로 전송한다 */
+  storeCode?: string;
+  /** 저장 매체 어댑터 (앱 소유) */
+  storage: SessionStorage;
+  fetch?: typeof globalThis.fetch;
+}
+
+export interface StorefrontSession {
+  /** POST /auth/login — 성공 시 accessToken/refreshToken 저장 + 구독자 통지 */
+  login(body: LoginRequest): Promise<void>;
+  /** POST /auth/signup — login과 동일하게 tokenPair를 저장한다 */
+  signup(body: SignupRequest): Promise<void>;
+  /**
+   * 무음 세션 갱신 — refreshToken으로 새 tokenPair를 받아 회전 저장한다.
+   * - 탭 내부: 동시 다발 호출을 single-flight로 합친다.
+   * - 탭 간: navigator.locks(있으면)로 회전을 직렬화하고, 락 진입 시 다른 탭이 이미
+   *   회전했으면(accessToken 변경) 내 refreshToken을 소비하지 않고 true를 반환한다.
+   * refreshToken이 없거나 실패(만료·재사용 폐기)하면 세션을 clear하고 false.
+   */
+  refresh(): Promise<boolean>;
+  /** 현재 accessToken (없으면 null) */
+  readonly accessToken: string | null;
+  /** 현재 refreshToken (없으면 null) */
+  readonly refreshToken: string | null;
+  /** GET /me — 토큰이 없으면 null, 있으면 Member */
+  userinfo(): Promise<Member | null>;
+  /** 세션 키를 지우고 best-effort로 /auth/logout을 호출한 뒤 구독자에게 통지한다 */
+  clear(): void;
+  /** 변경 구독(useSyncExternalStore 소비용) — 해지 함수 반환 */
+  subscribe(cb: () => void): () => void;
+}
+
+function buildHeaders(storeCode: string | undefined, accessToken?: string): Record<string, string> {
+  const headers: Record<string, string> = {};
+  if (storeCode) headers["x-store-code"] = storeCode;
+  if (accessToken) headers.authorization = `Bearer ${accessToken}`;
+  return headers;
+}
+
+async function postJson(
+  fetchFn: typeof globalThis.fetch,
+  baseUrl: string,
+  path: string,
+  body: unknown,
+  storeCode: string | undefined,
+  accessToken?: string,
+): Promise<unknown> {
+  const response = await fetchFn(`${baseUrl}${path}`, {
+    method: "POST",
+    headers: { "content-type": "application/json", ...buildHeaders(storeCode, accessToken) },
+    body: JSON.stringify(body ?? {}),
+  });
+  const json: unknown = await response.json().catch(() => null);
+  // createStorefrontClient(http.ts)와 동일한 ApiError 형태로 던진다 — 앱이 error.code/status로 분기.
+  if (!response.ok) throw toApiError(response.status, json);
+  return unwrapData(json);
+}
+
+export function createStorefrontSession(options: StorefrontSessionOptions): StorefrontSession {
+  const { baseUrl, storeCode, storage } = options;
+  const fetchFn = options.fetch ?? globalThis.fetch;
+  const listeners = new Set<() => void>();
+
+  function notify(): void {
+    for (const listener of listeners) listener();
+  }
+
+  function getAccessToken(): string | null {
+    return storage.get(STOREFRONT_SESSION_KEYS.accessToken);
+  }
+
+  function getRefreshToken(): string | null {
+    return storage.get(STOREFRONT_SESSION_KEYS.refreshToken);
+  }
+
+  function setTokens(tokens: TokenPair): void {
+    storage.set(STOREFRONT_SESSION_KEYS.accessToken, tokens.accessToken);
+    storage.set(STOREFRONT_SESSION_KEYS.refreshToken, tokens.refreshToken);
+    notify();
+  }
+
+  function clear(): void {
+    const accessToken = getAccessToken();
+    storage.remove(STOREFRONT_SESSION_KEYS.accessToken);
+    storage.remove(STOREFRONT_SESSION_KEYS.refreshToken);
+    notify();
+    // best-effort — 실패해도 clear() 호출부로 전파하지 않는다 (fire and forget)
+    void postJson(fetchFn, baseUrl, "/auth/logout", {}, storeCode, accessToken ?? undefined).catch(
+      () => {},
+    );
+  }
+
+  async function login(body: LoginRequest): Promise<void> {
+    const parsed = loginRequestSchema.parse(body);
+    const raw = await postJson(fetchFn, baseUrl, "/auth/login", parsed, storeCode);
+    setTokens(tokenPairSchema.parse(raw));
+  }
+
+  async function signup(body: SignupRequest): Promise<void> {
+    const parsed = signupRequestSchema.parse(body);
+    const raw = await postJson(fetchFn, baseUrl, "/auth/signup", parsed, storeCode);
+    setTokens(tokenPairSchema.parse(raw));
+  }
+
+  let refreshInFlight: Promise<boolean> | null = null;
+
+  function refresh(): Promise<boolean> {
+    if (!refreshInFlight) {
+      refreshInFlight = doRefresh().finally(() => {
+        refreshInFlight = null;
+      });
+    }
+    return refreshInFlight;
+  }
+
+  async function doRefresh(): Promise<boolean> {
+    // 락을 기다리는 동안 다른 탭이 회전을 끝낼 수 있으므로, 대기 전 accessToken을 스냅샷한다.
+    const before = getAccessToken();
+    const locks = typeof navigator !== "undefined" ? navigator.locks : undefined;
+    return locks ? locks.request(REFRESH_LOCK, () => rotate(before)) : rotate(before);
+  }
+
+  async function rotate(before: string | null): Promise<boolean> {
+    // 락 획득 후 accessToken이 바뀌었으면 다른 탭이 이미 회전한 것 → 내 refreshToken은 소비하지 않는다.
+    if (getAccessToken() !== before) return true;
+    const refreshToken = getRefreshToken();
+    if (!refreshToken) {
+      clear();
+      return false;
+    }
+    try {
+      const raw = await postJson(
+        fetchFn,
+        baseUrl,
+        "/auth/token/refresh",
+        { refreshToken },
+        storeCode,
+      );
+      setTokens(tokenPairSchema.parse(raw));
+      return true;
+    } catch {
+      clear(); // refreshToken까지 함께 폐기
+      return false;
+    }
+  }
+
+  async function userinfo(): Promise<Member | null> {
+    const accessToken = getAccessToken();
+    if (!accessToken) return null;
+    const response = await fetchFn(`${baseUrl}/me`, {
+      method: "GET",
+      headers: buildHeaders(storeCode, accessToken),
+    });
+    const json: unknown = await response.json().catch(() => null);
+    if (!response.ok) throw toApiError(response.status, json);
+    return memberSchema.parse(unwrapData(json));
+  }
+
+  function subscribe(cb: () => void): () => void {
+    listeners.add(cb);
+    return () => {
+      listeners.delete(cb);
+    };
+  }
+
+  return {
+    login,
+    signup,
+    refresh,
+    clear,
+    subscribe,
+    userinfo,
+    get accessToken() {
+      return getAccessToken();
+    },
+    get refreshToken() {
+      return getRefreshToken();
+    },
+  };
+}