@sayren/storefront-sdk 0.2.0 → 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;
@@ -7,6 +8,11 @@ const SESSION_CAMPAIGN_COOKIE = "sy_scmp";
 const MAX_BATCH = 50;
 /** 이벤트 이름당 분당 상한 — 무한 루프 버그가 트래픽을 만들지 못하게 */
 const PER_NAME_PER_MINUTE = 30;
+/**
+* 전체 분당 상한 — 서버의 방문자당 분당 한도(120)보다 낮게 둬, SDK가 보낸 이벤트가 서버 한도에 걸려
+* 조용히 버려지지 않게 한다(이름당 상한만으로는 이름 5종 × 30 = 150까지 갈 수 있다).
+*/
+const TOTAL_PER_MINUTE = 100;
 const MAX_QUEUE = 500;
 const DEV_HOST = /^(localhost|127\.\d+\.\d+\.\d+|\[?::1\]?|0\.0\.0\.0|10\.\d+\.\d+\.\d+|192\.168\.\d+\.\d+|172\.(1[6-9]|2\d|3[01])\.\d+\.\d+)$|\.local$/i;
 function createAnalytics(options) {
@@ -27,9 +33,15 @@ function createAnalyticsWith(options, env) {
 	let visibleMs = 0;
 	let engagementSent = false;
 	let firstPage = true;
+	/**
+	* 지금 페이지뷰를 보냈는가 — 상한으로 페이지뷰가 버려졌으면 그 페이지의 상품 조회·목록·검색·체류도 보내지 않는다.
+	* 그러지 않으면 존재하지 않는 페이지뷰를 가리키는 이벤트가 남는다.
+	*/
+	let pageAccepted = false;
 	const seen = /* @__PURE__ */ new Set();
 	let rateMinute = -1;
 	const perName = /* @__PURE__ */ new Map();
+	let totalThisMinute = 0;
 	const cleanups = [];
 	const campaignOf = (href) => {
 		try {
@@ -64,19 +76,23 @@ function createAnalyticsWith(options, env) {
 		if (minute !== rateMinute) {
 			rateMinute = minute;
 			perName.clear();
+			totalThisMinute = 0;
 		}
 		const used = perName.get(name) ?? 0;
-		if (used >= PER_NAME_PER_MINUTE) return false;
+		if (used >= PER_NAME_PER_MINUTE || totalThisMinute >= TOTAL_PER_MINUTE) return false;
 		perName.set(name, used + 1);
+		totalThisMinute += 1;
 		return true;
 	};
+	/** 큐에 넣었으면 true — 중복·상한·거부로 버리면 false */
 	const push = (event, dedupeKey) => {
-		if (!enabled || consent === "denied") return;
-		if (seen.has(dedupeKey) || !allowRate(event.name)) return;
+		if (!enabled || consent === "denied") return false;
+		if (seen.has(dedupeKey) || !allowRate(event.name)) return false;
 		seen.add(dedupeKey);
 		if (queue.length >= MAX_QUEUE) queue.shift();
 		queue.push(event);
 		if (queue.length >= MAX_BATCH) flush();
+		return true;
 	};
 	const flush = () => {
 		if (!enabled || queue.length === 0) return;
@@ -96,7 +112,7 @@ function createAnalyticsWith(options, env) {
 	const occurredAt = () => new Date(env.now()).toISOString();
 	/** 지금 페이지의 체류를 한 번 보낸다(이동·숨김·닫힘 중 먼저 오는 때) */
 	const endPage = () => {
-		if (!pageViewId || engagementSent) return;
+		if (!pageViewId || engagementSent || !pageAccepted) return;
 		if (visibleSince !== null) {
 			visibleMs += env.now() - visibleSince;
 			visibleSince = env.visible() ? env.now() : null;
@@ -126,14 +142,14 @@ function createAnalyticsWith(options, env) {
 		visibleSince = env.visible() ? env.now() : null;
 		engagementSent = false;
 		const referrer = firstPage ? env.referrer() : "";
-		firstPage = false;
-		push({
+		pageAccepted = push({
 			name: "page_view",
 			occurredAt: occurredAt(),
 			url: href,
 			pageViewId,
 			...referrer ? { referrer } : {}
 		}, `page:${pageViewId}`);
+		if (pageAccepted) firstPage = false;
 	};
 	/** 프리렌더·숨은 탭은 화면에 보이는 순간 첫 페이지뷰를 보낸다 */
 	const startWhenVisible = () => {
@@ -164,6 +180,7 @@ function createAnalyticsWith(options, env) {
 	return {
 		track(input) {
 			if (!pageViewId) startPage();
+			if (!pageAccepted) return;
 			const common = {
 				occurredAt: occurredAt(),
 				url: env.href(),
@@ -198,7 +215,13 @@ function createAnalyticsWith(options, env) {
 		setConsent(next) {
 			consent = next;
 			if (next === "denied") queue = [];
-			if (next === "granted") flush();
+			if (next === "granted") {
+				if (pageViewId && !pageAccepted && options.autoPageViews !== false) {
+					pageKey = "";
+					startPage();
+				}
+				flush();
+			}
 		},
 		ids: () => enabled ? ensureIds() : null,
 		flush,

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 };