@sayren/storefront-sdk 0.2.1 → 0.3.0

package/dist/analytics/index.mjs

@@ -1,4 +1,5 @@
-import { i as ANALYTICS_SESSION_COOKIE, n as safeDecode, o as ANALYTICS_VISITOR_COOKIE } from "../analytics-ids-o0a07Ohr.mjs";
+import { i as ANALYTICS_VISITOR_COOKIE, n as ANALYTICS_SESSION_COOKIE } from "../analytics-CgD70OqH.mjs";
+import { n as safeDecode } from "../analytics-ids-COElZiI3.mjs";
 //#region src/analytics/index.ts
 const VISITOR_MAX_AGE_SEC = 31536e3;
 const SESSION_MAX_AGE_SEC = 1800;

package/dist/{analytics-ids-o0a07Ohr.mjs → analytics-CgD70OqH.mjs}

@@ -87,40 +87,4 @@ webdriver: z.boolean().optional() }).optional()
 /** 배치 본문 상한(바이트) — 서버가 넘는 요청을 거부한다 */
 const ANALYTICS_MAX_BATCH_BYTES = 32768;
 //#endregion
-//#region src/analytics-ids.ts
-/**
-* 요청의 Cookie 헤더에서 방문자·세션 ID를 읽는다 — SSR 서버가 스토어프론트 API를 부를 때 쓴다.
-* 브라우저 모듈(`@sayren/storefront-sdk/analytics`)이 셀러 도메인에 남긴 쿠키다. 형식이 틀린 값은 버린다.
-*
-* ```ts
-* const ids = analyticsIdsFromCookie(request.headers.get("cookie"));
-* createStorefrontClient({ baseUrl, storeCode, ...ids });
-* ```
-*/
-function analyticsIdsFromCookie(cookieHeader) {
-	if (!cookieHeader) return {};
-	const pick = (name) => {
-		for (const part of cookieHeader.split(";")) {
-			const [key, ...rest] = part.trim().split("=");
-			if (key !== name) continue;
-			const value = safeDecode(rest.join("="));
-			return value !== null && analyticsIdSchema.safeParse(value).success ? value : void 0;
-		}
-	};
-	const visitorId = pick(ANALYTICS_VISITOR_COOKIE);
-	const sessionId = pick(ANALYTICS_SESSION_COOKIE);
-	return {
-		...visitorId ? { visitorId } : {},
-		...sessionId ? { sessionId } : {}
-	};
-}
-/** 잘못된 퍼센트 인코딩(`%E0%A4`)은 URIError를 던진다 — 쿠키 하나 때문에 SSR 전체가 500이 되지 않게 버린다 */
-function safeDecode(value) {
-	try {
-		return decodeURIComponent(value);
-	} catch {
-		return null;
-	}
-}
-//#endregion
-export { ANALYTICS_SESSION_HEADER as a, analyticsBatchSchema as c, analyticsIdSchema as d, analyticsServerEventNameSchema as f, ANALYTICS_SESSION_COOKIE as i, analyticsClientEventNameSchema as l, safeDecode as n, ANALYTICS_VISITOR_COOKIE as o, ANALYTICS_MAX_BATCH_BYTES as r, ANALYTICS_VISITOR_HEADER as s, analyticsIdsFromCookie as t, analyticsClientEventSchema as u };
+export { ANALYTICS_VISITOR_HEADER as a, analyticsClientEventSchema as c, ANALYTICS_VISITOR_COOKIE as i, analyticsIdSchema as l, ANALYTICS_SESSION_COOKIE as n, analyticsBatchSchema as o, ANALYTICS_SESSION_HEADER as r, analyticsClientEventNameSchema as s, ANALYTICS_MAX_BATCH_BYTES as t, analyticsServerEventNameSchema as u };

package/dist/analytics-ids-COElZiI3.mjs

@@ -0,0 +1,38 @@
+import { i as ANALYTICS_VISITOR_COOKIE, l as analyticsIdSchema, n as ANALYTICS_SESSION_COOKIE } from "./analytics-CgD70OqH.mjs";
+//#region src/analytics-ids.ts
+/**
+* 요청의 Cookie 헤더에서 방문자·세션 ID를 읽는다 — SSR 서버가 스토어프론트 API를 부를 때 쓴다.
+* 브라우저 모듈(`@sayren/storefront-sdk/analytics`)이 셀러 도메인에 남긴 쿠키다. 형식이 틀린 값은 버린다.
+*
+* ```ts
+* const ids = analyticsIdsFromCookie(request.headers.get("cookie"));
+* createStorefrontClient({ baseUrl, storeCode, ...ids });
+* ```
+*/
+function analyticsIdsFromCookie(cookieHeader) {
+	if (!cookieHeader) return {};
+	const pick = (name) => {
+		for (const part of cookieHeader.split(";")) {
+			const [key, ...rest] = part.trim().split("=");
+			if (key !== name) continue;
+			const value = safeDecode(rest.join("="));
+			return value !== null && analyticsIdSchema.safeParse(value).success ? value : void 0;
+		}
+	};
+	const visitorId = pick(ANALYTICS_VISITOR_COOKIE);
+	const sessionId = pick(ANALYTICS_SESSION_COOKIE);
+	return {
+		...visitorId ? { visitorId } : {},
+		...sessionId ? { sessionId } : {}
+	};
+}
+/** 잘못된 퍼센트 인코딩(`%E0%A4`)은 URIError를 던진다 — 쿠키 하나 때문에 SSR 전체가 500이 되지 않게 버린다 */
+function safeDecode(value) {
+	try {
+		return decodeURIComponent(value);
+	} catch {
+		return null;
+	}
+}
+//#endregion
+export { safeDecode as n, analyticsIdsFromCookie as t };

package/dist/auth/index.d.mts

@@ -0,0 +1,43 @@
+import { a as AnonymousSession, c as TokenPair, o as LoginRequest, s as SignupRequest, t as ApiError } from "../http-DWaRhLfG.mjs";
+//#region src/auth/index.d.ts
+export interface StorefrontAuthOptions {
+  /** 예: https://api.sayren.app/storefront/v1 */
+  baseUrl: string;
+  /** 테넌트 스토어 코드 — `X-Store-Code` 헤더로 보낸다 */
+  storeCode: string;
+  fetch?: typeof globalThis.fetch;
+}
+/**
+ * 구매자 인증 — 화면은 스토어프런트가 그리고, 계정 저장과 인증 처리는 sayren이 한다.
+ * 어느 방식으로 로그인해도 결과는 같은 구매자 토큰(`TokenPair`)이고 `/me/*`·장바구니·주문 API에 그대로 쓴다.
+ *
+ * 토큰 보관은 앱 몫이다. 서버(loader·action)에서 호출하고 httpOnly 쿠키에 두기를 권한다.
+ *
+ * ```ts
+ * const auth = createStorefrontAuth({ baseUrl, storeCode });
+ * const guest = await auth.anonymous();                         // 비회원: 장바구니 토큰
+ * const tokens = await auth.session({ email, password, cartToken: guest.cartToken });
+ * ```
+ */
+export declare function createStorefrontAuth(options: StorefrontAuthOptions): {
+  /**
+   * 비회원 익명 세션 — 구매자 계정을 만들지 않는다. `cartToken`을 `X-Cart-Token`으로 보내면 장바구니·
+   * 비회원 주문이 쌓이고, `session()`·`signUp()`에 실으면 회원 장바구니로 병합된 뒤 닫힌다.
+   * 마지막 활동 후 30일이 지나면 만료된다.
+   */
+  anonymous(): Promise<AnonymousSession>;
+  /** 이메일·비밀번호 로그인. `cartToken`을 주면 비회원 장바구니를 병합한다 */
+  session(body: LoginRequest): Promise<TokenPair>;
+  /** 회원가입 — 가입과 동시에 로그인 토큰을 받는다. `cartToken`을 주면 장바구니를 병합한다 */
+  signUp(body: SignupRequest): Promise<TokenPair>;
+  /** 토큰 갱신 — refreshToken은 한 번 쓰면 폐기되고 새 쌍이 온다(회전) */
+  refresh(refreshToken: string): Promise<TokenPair>;
+  /**
+   * 로그아웃 — 이 구매자의 refreshToken을 모두 폐기한다. 앱은 보관한 토큰을 지운다.
+   * 액세스 토큰이 이미 만료됐으면(401) 서버에서 할 일이 없으므로 성공으로 본다.
+   */
+  signOut(accessToken: string): Promise<void>;
+};
+export type StorefrontAuth = ReturnType<typeof createStorefrontAuth>;
+//#endregion
+export { type AnonymousSession, ApiError, type LoginRequest, type SignupRequest, type TokenPair };

package/dist/auth/index.mjs

@@ -0,0 +1,58 @@
+import { t as createStorefrontClient, tt as ApiError } from "../client-Xb-2tNKT.mjs";
+//#region src/auth/index.ts
+/**
+* 구매자 인증 — 화면은 스토어프런트가 그리고, 계정 저장과 인증 처리는 sayren이 한다.
+* 어느 방식으로 로그인해도 결과는 같은 구매자 토큰(`TokenPair`)이고 `/me/*`·장바구니·주문 API에 그대로 쓴다.
+*
+* 토큰 보관은 앱 몫이다. 서버(loader·action)에서 호출하고 httpOnly 쿠키에 두기를 권한다.
+*
+* ```ts
+* const auth = createStorefrontAuth({ baseUrl, storeCode });
+* const guest = await auth.anonymous();                         // 비회원: 장바구니 토큰
+* const tokens = await auth.session({ email, password, cartToken: guest.cartToken });
+* ```
+*/
+function createStorefrontAuth(options) {
+	const client = (accessToken) => createStorefrontClient({
+		baseUrl: options.baseUrl,
+		storeCode: options.storeCode,
+		accessToken,
+		fetch: options.fetch
+	});
+	return {
+		/**
+		* 비회원 익명 세션 — 구매자 계정을 만들지 않는다. `cartToken`을 `X-Cart-Token`으로 보내면 장바구니·
+		* 비회원 주문이 쌓이고, `session()`·`signUp()`에 실으면 회원 장바구니로 병합된 뒤 닫힌다.
+		* 마지막 활동 후 30일이 지나면 만료된다.
+		*/
+		anonymous() {
+			return client().auth.anonymous();
+		},
+		/** 이메일·비밀번호 로그인. `cartToken`을 주면 비회원 장바구니를 병합한다 */
+		session(body) {
+			return client().auth.login(body);
+		},
+		/** 회원가입 — 가입과 동시에 로그인 토큰을 받는다. `cartToken`을 주면 장바구니를 병합한다 */
+		signUp(body) {
+			return client().auth.signup(body);
+		},
+		/** 토큰 갱신 — refreshToken은 한 번 쓰면 폐기되고 새 쌍이 온다(회전) */
+		refresh(refreshToken) {
+			return client().auth.refresh(refreshToken);
+		},
+		/**
+		* 로그아웃 — 이 구매자의 refreshToken을 모두 폐기한다. 앱은 보관한 토큰을 지운다.
+		* 액세스 토큰이 이미 만료됐으면(401) 서버에서 할 일이 없으므로 성공으로 본다.
+		*/
+		async signOut(accessToken) {
+			try {
+				await client(accessToken).auth.logout();
+			} catch (error) {
+				if (error instanceof ApiError && error.status === 401) return;
+				throw error;
+			}
+		}
+	};
+}
+//#endregion
+export { ApiError, createStorefrontAuth };