@sayren/storefront-sdk 0.2.0 → 0.2.1

package/dist/analytics/index.mjs

@@ -7,6 +7,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 +32,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 +75,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 +111,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 +141,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 +179,7 @@ function createAnalyticsWith(options, env) {
 	return {
 		track(input) {
 			if (!pageViewId) startPage();
+			if (!pageAccepted) return;
 			const common = {
 				occurredAt: occurredAt(),
 				url: env.href(),
@@ -198,7 +214,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sayren/storefront-sdk",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "main": "./dist/index.mjs",
   "types": "./dist/index.d.mts",
   "exports": {

package/src/analytics/index.ts

@@ -84,6 +84,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 =
@@ -110,9 +115,15 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
   let visibleMs = 0;
   let engagementSent = false;
   let firstPage = true;
+  /**
+   * 지금 페이지뷰를 보냈는가 — 상한으로 페이지뷰가 버려졌으면 그 페이지의 상품 조회·목록·검색·체류도 보내지 않는다.
+   * 그러지 않으면 존재하지 않는 페이지뷰를 가리키는 이벤트가 남는다.
+   */
+  let pageAccepted = false;
   const seen = new Set<string>();
   let rateMinute = -1;
   const perName = new Map<string, number>();
+  let totalThisMinute = 0;
   const cleanups: Array<() => void> = [];
 
   const campaignOf = (href: string) => {
@@ -147,20 +158,24 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
     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;
   };
 
-  const push = (event: Pending, dedupeKey: string) => {
-    if (!enabled || consent === "denied") return;
-    if (seen.has(dedupeKey) || !allowRate(event.name)) return;
+  /** 큐에 넣었으면 true — 중복·상한·거부로 버리면 false */
+  const push = (event: Pending, dedupeKey: string): boolean => {
+    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 = () => {
@@ -183,7 +198,7 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
 
   /** 지금 페이지의 체류를 한 번 보낸다(이동·숨김·닫힘 중 먼저 오는 때) */
   const endPage = () => {
-    if (!pageViewId || engagementSent) return;
+    if (!pageViewId || engagementSent || !pageAccepted) return;
     if (visibleSince !== null) {
       visibleMs += env.now() - visibleSince;
       visibleSince = env.visible() ? env.now() : null;
@@ -219,8 +234,7 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
     visibleSince = env.visible() ? env.now() : null;
     engagementSent = false;
     const referrer = firstPage ? env.referrer() : "";
-    firstPage = false;
-    push(
+    pageAccepted = push(
       {
         name: "page_view",
         occurredAt: occurredAt(),
@@ -230,6 +244,8 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
       },
       `page:${pageViewId}`,
     );
+    // 외부 유입(리퍼러)은 실제로 보낸 첫 페이지뷰에만 싣는다 — 거부 중 버린 페이지뷰가 가져가지 않게
+    if (pageAccepted) firstPage = false;
   };
 
   /** 프리렌더·숨은 탭은 화면에 보이는 순간 첫 페이지뷰를 보낸다 */
@@ -268,6 +284,7 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
   return {
     track(input) {
       if (!pageViewId) startPage();
+      if (!pageAccepted) return; // 페이지뷰가 버려진 페이지의 행동은 보내지 않는다
       const common = { occurredAt: occurredAt(), url: env.href(), pageViewId };
       switch (input.name) {
         case "product_view":
@@ -308,7 +325,14 @@ export function createAnalyticsWith(options: AnalyticsOptions, env: AnalyticsEnv
     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,