@roottale/analytics-runtime 0.5.0 → 0.6.0

package/dist/chunk-KIOFZXJX.js

@@ -0,0 +1,99 @@
+// src/entry-channels.ts
+var ENTRY_CHANNEL_IDS = [
+  "search",
+  "direct",
+  "referral",
+  "social",
+  "paid",
+  "ai",
+  "shortlink",
+  "other"
+];
+function isEntryChannelId(value) {
+  return ENTRY_CHANNEL_IDS.includes(value);
+}
+var ENTRY_CHANNEL_LABEL = {
+  search: "\uAC80\uC0C9",
+  direct: "\uC8FC\uC18C \uC785\uB825\xB7\uC990\uACA8\uCC3E\uAE30",
+  referral: "\uB2E4\uB978 \uC0AC\uC774\uD2B8 \uB9C1\uD06C",
+  social: "\uC18C\uC15C \uBBF8\uB514\uC5B4",
+  paid: "\uAD11\uACE0",
+  ai: "AI \uCC57\uBD07",
+  shortlink: "\uB2E8\uCD95\uB9C1\uD06C\xB7QR",
+  other: "\uAE30\uD0C0 \uCEA0\uD398\uC778"
+};
+var SEARCH_HOSTS = [
+  { host: "google.com" },
+  { host: "google.co.kr" },
+  { host: "search.naver.com" },
+  { host: "naver.com", exact: true },
+  { host: "m.naver.com", exact: true },
+  { host: "search.daum.net" },
+  { host: "daum.net", exact: true },
+  { host: "m.daum.net", exact: true },
+  { host: "bing.com" },
+  { host: "duckduckgo.com" },
+  { host: "search.yahoo.com" },
+  { host: "yandex.com" },
+  { host: "baidu.com" },
+  { host: "search.zum.com" },
+  { host: "zum.com", exact: true },
+  { host: "search.nate.com" },
+  { host: "nate.com", exact: true }
+];
+var SOCIAL_HOSTS = [
+  { host: "facebook.com" },
+  { host: "instagram.com" },
+  { host: "threads.net" },
+  { host: "twitter.com" },
+  { host: "x.com" },
+  { host: "t.co", exact: true },
+  { host: "linkedin.com" },
+  { host: "youtube.com" },
+  { host: "youtu.be", exact: true },
+  { host: "tiktok.com" },
+  { host: "pinterest.com" },
+  { host: "band.us" },
+  { host: "story.kakao.com" },
+  { host: "pf.kakao.com" },
+  { host: "cafe.naver.com" },
+  { host: "cafe.daum.net" }
+];
+function matchesRules(host, rules) {
+  for (const rule of rules) {
+    if (host === rule.host) return true;
+    if (!rule.exact && host.endsWith(`.${rule.host}`)) return true;
+  }
+  return false;
+}
+var PAID_MEDIUM_RE = /^(cpc|ppc|cpm|cpv|cpa|display|banner|paid[\w-]*|retargeting|remarketing)$/i;
+var SOCIAL_MEDIUM_RE = /^(social|sns|social[-_]media)$/i;
+function classifyEntryChannel(signals) {
+  const host = signals.referrerHost?.trim().toLowerCase() || null;
+  const medium = signals.utmMedium?.trim() || null;
+  const hasUtm = Boolean(
+    signals.utmSource?.trim() || medium || signals.utmCampaign?.trim()
+  );
+  if (signals.aiReferralId) return "ai";
+  if (signals.rtSrc?.trim()) return "shortlink";
+  if (signals.hasAdClick || medium && PAID_MEDIUM_RE.test(medium)) {
+    return "paid";
+  }
+  if (medium && SOCIAL_MEDIUM_RE.test(medium)) return "social";
+  if (host) {
+    if (matchesRules(host, SEARCH_HOSTS)) return "search";
+    if (matchesRules(host, SOCIAL_HOSTS)) return "social";
+  }
+  if (hasUtm) return "other";
+  if (host) return "referral";
+  if (signals.hasReferrer) return null;
+  return "direct";
+}
+
+export {
+  ENTRY_CHANNEL_IDS,
+  isEntryChannelId,
+  ENTRY_CHANNEL_LABEL,
+  classifyEntryChannel
+};
+//# sourceMappingURL=chunk-KIOFZXJX.js.map

package/dist/chunk-KIOFZXJX.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/entry-channels.ts"],"sourcesContent":["/**\n * 유입 경로(entry channel) 분류 — ROOT-ANALYTICS 자체 수집의 \"어디서 왔나\".\n *\n * 비콘은 신호(외부 referrer **호스트명**·utm·광고클릭 유무·rt_src·AI 라벨)만\n * 보내고, 판정은 서버(`api-core /v1/collect`)가 이 모듈로 한다 — 판정 목록을\n * 고치면 워커 배포만으로 전 사이트에 반영된다(고객 사이트 재배포 불필요).\n *\n * Privacy(ADR-0038 §2 동의 면제 유지): 입력이 이미 비식별이다 — referrer 는\n * 경로·쿼리 없는 호스트명뿐, gclid/fbclid 는 존재 여부 불리언뿐(원값 미수신),\n * utm 은 고객이 자기 캠페인 링크에 직접 붙인 라벨이다. 출력은 고정 사전의\n * id 하나라 임의 문자열이 차원에 들어갈 수 없다.\n *\n * GA4 화면의 6묶음(search/direct/referral/social/paid/other)과 말을 맞추되,\n * 자체 수집만 아는 두 가지를 더 가른다 — `ai`(챗봇 유입, ai-referrals.ts 와\n * 동일 사전) · `shortlink`(roottale.link 단축링크/QR 의 rt_src).\n *\n * 이 파일은 브라우저 비콘 생성기·서버 양쪽에서 참조하므로 런타임 의존이\n * 없어야 한다(ai-referrals.ts 와 동일 제약).\n */\n\nexport const ENTRY_CHANNEL_IDS = [\n  \"search\",\n  \"direct\",\n  \"referral\",\n  \"social\",\n  \"paid\",\n  \"ai\",\n  \"shortlink\",\n  \"other\",\n] as const;\n\nexport type EntryChannelId = (typeof ENTRY_CHANNEL_IDS)[number];\n\n/** 수집 라우트·어드민 조회의 입력 검증 — 사전 밖 문자열 차단. */\nexport function isEntryChannelId(value: string): value is EntryChannelId {\n  return (ENTRY_CHANNEL_IDS as readonly string[]).includes(value);\n}\n\n/** 고객 화면 라벨 — GA4 6묶음과 같은 말을 쓴다(두 화면이 다르게 부르지 않게). */\nexport const ENTRY_CHANNEL_LABEL: Record<EntryChannelId, string> = {\n  search: \"검색\",\n  direct: \"주소 입력·즐겨찾기\",\n  referral: \"다른 사이트 링크\",\n  social: \"소셜 미디어\",\n  paid: \"광고\",\n  ai: \"AI 챗봇\",\n  shortlink: \"단축링크·QR\",\n  other: \"기타 캠페인\",\n};\n\n/**\n * 호스트 규칙 — 기본은 정확 일치 또는 서브도메인(`.` 접미) 일치.\n * `exact` 는 정확 일치만: `naver.com` 을 접미 매칭하면 `blog.naver.com`(블로그\n * = 다른 사이트 링크)까지 검색으로 잘못 묶인다.\n */\ntype HostRule = { readonly host: string; readonly exact?: true };\n\nconst SEARCH_HOSTS: readonly HostRule[] = [\n  { host: \"google.com\" },\n  { host: \"google.co.kr\" },\n  { host: \"search.naver.com\" },\n  { host: \"naver.com\", exact: true },\n  { host: \"m.naver.com\", exact: true },\n  { host: \"search.daum.net\" },\n  { host: \"daum.net\", exact: true },\n  { host: \"m.daum.net\", exact: true },\n  { host: \"bing.com\" },\n  { host: \"duckduckgo.com\" },\n  { host: \"search.yahoo.com\" },\n  { host: \"yandex.com\" },\n  { host: \"baidu.com\" },\n  { host: \"search.zum.com\" },\n  { host: \"zum.com\", exact: true },\n  { host: \"search.nate.com\" },\n  { host: \"nate.com\", exact: true },\n];\n\nconst SOCIAL_HOSTS: readonly HostRule[] = [\n  { host: \"facebook.com\" },\n  { host: \"instagram.com\" },\n  { host: \"threads.net\" },\n  { host: \"twitter.com\" },\n  { host: \"x.com\" },\n  { host: \"t.co\", exact: true },\n  { host: \"linkedin.com\" },\n  { host: \"youtube.com\" },\n  { host: \"youtu.be\", exact: true },\n  { host: \"tiktok.com\" },\n  { host: \"pinterest.com\" },\n  { host: \"band.us\" },\n  { host: \"story.kakao.com\" },\n  { host: \"pf.kakao.com\" },\n  { host: \"cafe.naver.com\" },\n  { host: \"cafe.daum.net\" },\n];\n\n/** 부분 문자열 매칭 금지 — `naver.com.evil.com` 같은 위장 도메인 차단. */\nfunction matchesRules(host: string, rules: readonly HostRule[]): boolean {\n  for (const rule of rules) {\n    if (host === rule.host) return true;\n    if (!rule.exact && host.endsWith(`.${rule.host}`)) return true;\n  }\n  return false;\n}\n\n/** utm_medium 유료 표기 — GA4 의 paid 판정 표기와 겹치는 관용 값들. */\nconst PAID_MEDIUM_RE =\n  /^(cpc|ppc|cpm|cpv|cpa|display|banner|paid[\\w-]*|retargeting|remarketing)$/i;\n\nconst SOCIAL_MEDIUM_RE = /^(social|sns|social[-_]media)$/i;\n\nexport interface EntryChannelSignals {\n  /** 외부 referrer 호스트명(소문자, www 제거) — 같은 호스트면 비콘이 생략. */\n  readonly referrerHost?: string | null;\n  readonly utmSource?: string | null;\n  readonly utmMedium?: string | null;\n  readonly utmCampaign?: string | null;\n  /** gclid/fbclid 존재 여부 — 원값은 어디에도 없다. */\n  readonly hasAdClick?: boolean;\n  /** roottale.link 단축링크/QR 토큰(rt_src). */\n  readonly rtSrc?: string | null;\n  /** 비콘이 판정한 AI 챗봇 라벨(ai-referrals 사전 통과분). */\n  readonly aiReferralId?: string | null;\n  /** referrer 존재 여부(내부 이동 포함) — 비콘 `ref` 플래그. */\n  readonly hasReferrer?: boolean;\n}\n\n/**\n * 한 pageview 의 유입 경로 판정. **`null` = 유입이 아님**(내부 이동 — 같은\n * 사이트 안에서 다음 페이지로 넘어온 조회). 집계에서 내부 이동을 빼야\n * \"채널별 유입\"이 실제 들어온 횟수를 뜻한다.\n *\n * 우선순위: ai > shortlink > paid > social(utm) > search(host) >\n * social(host) > other(utm만) > referral(그 외 외부 host) > 내부/직접.\n * utm_medium 명시가 host 추정보다 먼저다 — 고객이 직접 붙인 라벨이 더 정확.\n */\nexport function classifyEntryChannel(\n  signals: EntryChannelSignals,\n): EntryChannelId | null {\n  const host = signals.referrerHost?.trim().toLowerCase() || null;\n  const medium = signals.utmMedium?.trim() || null;\n  const hasUtm = Boolean(\n    signals.utmSource?.trim() || medium || signals.utmCampaign?.trim(),\n  );\n\n  if (signals.aiReferralId) return \"ai\";\n  if (signals.rtSrc?.trim()) return \"shortlink\";\n  if (signals.hasAdClick || (medium && PAID_MEDIUM_RE.test(medium))) {\n    return \"paid\";\n  }\n  if (medium && SOCIAL_MEDIUM_RE.test(medium)) return \"social\";\n  if (host) {\n    if (matchesRules(host, SEARCH_HOSTS)) return \"search\";\n    if (matchesRules(host, SOCIAL_HOSTS)) return \"social\";\n  }\n  if (hasUtm) return \"other\"; // email·뉴스레터 등 — 라벨은 utm 원문으로 확인\n  if (host) return \"referral\";\n  // referrer 는 있는데 외부 호스트가 아니다 = 내부 이동 → 유입 아님.\n  if (signals.hasReferrer) return null;\n  return \"direct\";\n}\n"],"mappings":"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","names":[]}

package/dist/entry-channels.d.ts

@@ -0,0 +1,52 @@
+/**
+ * 유입 경로(entry channel) 분류 — ROOT-ANALYTICS 자체 수집의 "어디서 왔나".
+ *
+ * 비콘은 신호(외부 referrer **호스트명**·utm·광고클릭 유무·rt_src·AI 라벨)만
+ * 보내고, 판정은 서버(`api-core /v1/collect`)가 이 모듈로 한다 — 판정 목록을
+ * 고치면 워커 배포만으로 전 사이트에 반영된다(고객 사이트 재배포 불필요).
+ *
+ * Privacy(ADR-0038 §2 동의 면제 유지): 입력이 이미 비식별이다 — referrer 는
+ * 경로·쿼리 없는 호스트명뿐, gclid/fbclid 는 존재 여부 불리언뿐(원값 미수신),
+ * utm 은 고객이 자기 캠페인 링크에 직접 붙인 라벨이다. 출력은 고정 사전의
+ * id 하나라 임의 문자열이 차원에 들어갈 수 없다.
+ *
+ * GA4 화면의 6묶음(search/direct/referral/social/paid/other)과 말을 맞추되,
+ * 자체 수집만 아는 두 가지를 더 가른다 — `ai`(챗봇 유입, ai-referrals.ts 와
+ * 동일 사전) · `shortlink`(roottale.link 단축링크/QR 의 rt_src).
+ *
+ * 이 파일은 브라우저 비콘 생성기·서버 양쪽에서 참조하므로 런타임 의존이
+ * 없어야 한다(ai-referrals.ts 와 동일 제약).
+ */
+declare const ENTRY_CHANNEL_IDS: readonly ["search", "direct", "referral", "social", "paid", "ai", "shortlink", "other"];
+type EntryChannelId = (typeof ENTRY_CHANNEL_IDS)[number];
+/** 수집 라우트·어드민 조회의 입력 검증 — 사전 밖 문자열 차단. */
+declare function isEntryChannelId(value: string): value is EntryChannelId;
+/** 고객 화면 라벨 — GA4 6묶음과 같은 말을 쓴다(두 화면이 다르게 부르지 않게). */
+declare const ENTRY_CHANNEL_LABEL: Record<EntryChannelId, string>;
+interface EntryChannelSignals {
+    /** 외부 referrer 호스트명(소문자, www 제거) — 같은 호스트면 비콘이 생략. */
+    readonly referrerHost?: string | null;
+    readonly utmSource?: string | null;
+    readonly utmMedium?: string | null;
+    readonly utmCampaign?: string | null;
+    /** gclid/fbclid 존재 여부 — 원값은 어디에도 없다. */
+    readonly hasAdClick?: boolean;
+    /** roottale.link 단축링크/QR 토큰(rt_src). */
+    readonly rtSrc?: string | null;
+    /** 비콘이 판정한 AI 챗봇 라벨(ai-referrals 사전 통과분). */
+    readonly aiReferralId?: string | null;
+    /** referrer 존재 여부(내부 이동 포함) — 비콘 `ref` 플래그. */
+    readonly hasReferrer?: boolean;
+}
+/**
+ * 한 pageview 의 유입 경로 판정. **`null` = 유입이 아님**(내부 이동 — 같은
+ * 사이트 안에서 다음 페이지로 넘어온 조회). 집계에서 내부 이동을 빼야
+ * "채널별 유입"이 실제 들어온 횟수를 뜻한다.
+ *
+ * 우선순위: ai > shortlink > paid > social(utm) > search(host) >
+ * social(host) > other(utm만) > referral(그 외 외부 host) > 내부/직접.
+ * utm_medium 명시가 host 추정보다 먼저다 — 고객이 직접 붙인 라벨이 더 정확.
+ */
+declare function classifyEntryChannel(signals: EntryChannelSignals): EntryChannelId | null;
+
+export { ENTRY_CHANNEL_IDS, ENTRY_CHANNEL_LABEL, type EntryChannelId, type EntryChannelSignals, classifyEntryChannel, isEntryChannelId };

package/dist/entry-channels.js

@@ -0,0 +1,13 @@
+import {
+  ENTRY_CHANNEL_IDS,
+  ENTRY_CHANNEL_LABEL,
+  classifyEntryChannel,
+  isEntryChannelId
+} from "./chunk-KIOFZXJX.js";
+export {
+  ENTRY_CHANNEL_IDS,
+  ENTRY_CHANNEL_LABEL,
+  classifyEntryChannel,
+  isEntryChannelId
+};
+//# sourceMappingURL=entry-channels.js.map

package/dist/entry-channels.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -1,11 +1,20 @@
-import { C as ConsentCategory, a as ConsentState, T as TagProvider, A as AnalyticsSiteConfig, b as AnalyticsManifest } from './consent-banner-WVGsxcY2.js';
-export { c as ConsentBannerOptions, d as ConsentValue, R as ResolvedTag, e as TagConfig, r as renderConsentBannerMarkup, f as renderConsentBannerScript } from './consent-banner-WVGsxcY2.js';
+import { C as ConsentCategory, a as ConsentState, T as TagProvider, A as AnalyticsSiteConfig, b as AnalyticsManifest } from './types-VA3xp0bt.js';
+export { c as ConsentValue, R as ResolvedTag, d as TagConfig } from './types-VA3xp0bt.js';
 export { AI_REFERRAL_IDS, AI_REFERRAL_LABEL, AiReferralId, AiReferralMetric, aiReferralRulesLiteral, classifyAiReferral, isAiReferralId, summarizeAiReferrals } from './ai-referrals.js';
+export { ENTRY_CHANNEL_IDS, ENTRY_CHANNEL_LABEL, EntryChannelId, EntryChannelSignals, classifyEntryChannel, isEntryChannelId } from './entry-channels.js';
 export { GA4_MIRROR, TRACK_EVENTS, TrackEventDef, TrackEventName, isTrackEvent } from './events.js';
 
 declare const ALL_CONSENT_CATEGORIES: readonly ConsentCategory[];
-/** fail-closed 기본값 — 전부 denied. */
+/**
+ * 방문자의 명시적 동의 선택 저장 키(localStorage) — 과거 배너가 저장한 값을
+ * 로더가 계속 읽는다. **과거에 "거부"를 누른 방문자의 선택은 기본값 변경
+ * 후에도 존중된다**(기본값은 선택 기록이 없는 방문자에게만 적용).
+ */
+declare const CONSENT_STORAGE_KEY = "rt_consent_v1";
+/** 전부 denied — 광고 도구 게이트·테스트 기준값으로 유지. */
 declare const DENIED_CONSENT: ConsentState;
+/** 기본 동의(Amend 4) — 통계 granted · 광고 denied. */
+declare const DEFAULT_CONSENT: ConsentState;
 /**
  * provider 가 발화하기 전 granted 여야 하는 동의 카테고리.
  * - analytics 도구(GA4·Clarity·Naver) → `analytics_storage`
@@ -21,22 +30,35 @@ declare function isTagAllowed(required: readonly ConsentCategory[], consent: Con
  * - `enabled=false` 또는 빈 id 는 제외.
  * - provider 당 1개 (중복은 첫 항목만).
  * - 각 태그에 필요한 동의 카테고리(`PROVIDER_CONSENT`)를 부착.
- * - 동의 기본값은 항상 전부 denied (fail-closed).
+ * - 동의 기본값 = 통계 granted · 광고 denied (ADR-0038 Amend 4 — 광고 도구는
+ *   동의 UI 없이는 발화하지 않는다).
  */
 declare function buildManifest(config: AnalyticsSiteConfig): AnalyticsManifest;
 
 /**
- * Consent Mode v2 default 부트스트랩. 전 카테고리 denied + `wait_for_update`.
- * 반드시 어떤 분석/광고 태그보다 먼저 실행돼야 한다.
+ * Consent Mode v2 default 부트스트랩 — 통계 granted · 광고 denied (Amend 4).
+ * 반드시 어떤 분석/광고 태그보다 먼저 실행돼야 한다. `wait_for_update` 는
+ * 로더가 저장된 과거 선택을 적용할 짧은 창.
  */
 declare function renderConsentBootstrap(): string;
 /**
- * manifest 를 embed 한 로더 스크립트. fail-closed — 기본 동의가 denied 라
- * `applyAll()` 은 아무 태그도 주입하지 않고, 동의 배너의 `updateConsent` 후에만
- * 허용된 태그가 붙는다.
+ * manifest 를 embed 한 로더 스크립트. 초기 `applyAll()` 이 동의 충족 태그
+ * (기본값에선 분석 도구)를 즉시 주입한다. 광고 도구는 `requiredConsent` 의
+ * ad_* 카테고리가 기본 denied 라 `updateConsent` 없이는 절대 붙지 않는다.
  */
 declare function renderLoaderScript(manifest: AnalyticsManifest): string;
 
+interface ConsentBannerOptions {
+    /** 개인정보처리방침 링크 (테넌트별). 없으면 링크 생략. */
+    privacyUrl?: string;
+    /** 본문 카피. 기본 한국어. */
+    message?: string;
+}
+/** 배너 마크업(HTML). 스크립트 미포함 — 컨테이너로 주입. */
+declare function renderConsentBannerMarkup(options?: ConsentBannerOptions): string;
+/** 배너 동작(JS 본문). <script is:inline> 로 감싸 주입. */
+declare function renderConsentBannerScript(): string;
+
 interface BeaconOptions {
     /** first-party 수집 엔드포인트 (예: https://api.roottale.com/v1/collect). */
     collectUrl: string;
@@ -113,6 +135,15 @@ interface LastTouchAttribution {
  * 비콘 dispatcher JS 본문. <script is:inline> 로 감싸 주입.
  * `ref` 는 referrer 존재 여부(0/1)만 — raw referrer 미전송(privacy).
  *
+ * 유입 경로 신호(2026-08-19) — pageview 에만 동봉, 전부 있을 때만 실린다:
+ *   `rh` 외부 referrer **호스트명**(경로·쿼리 없음, www 제거) · `us`/`um`/`uc`
+ *   utm source/medium/campaign · `rs` rt_src · `gc:1` gclid/fbclid **존재
+ *   여부**(원값 미전송) · `lg` 브라우저 언어 1차 서브태그(ko·en···, full
+ *   locale 미전송). 판정은 서버가 한다 —
+ *   `entry-channels.ts` classifyEntryChannel() 이 `/v1/collect` 에서 채널
+ *   묶음으로 접어 AE blob10~ 에 적재(값 계약은 collect.ts 와 공유, 동시 갱신).
+ *   raw referrer URL 은 여전히 어디에도 전송·저장되지 않는다(ADR-0026 §5).
+ *
  * ADR-0065 — 글 조회수 식별자: pageview 시 `<meta name="rt:content-id">` 의
  * content 를 읽어 `pid`(=post_id) 로 동봉한다. 사이트 레벨 단일 비콘이 페이지별
  * 글 식별자를 갖게 해 URL/컬렉션 basePath 변경에 무관한 안정 매칭을 만든다.
@@ -201,4 +232,4 @@ declare global {
     }
 }
 
-export { ALL_CONSENT_CATEGORIES, ATTRIBUTION_STORAGE_KEY, ATTRIBUTION_TTL_MS, AnalyticsManifest, AnalyticsSiteConfig, type BeaconOptions, ConsentCategory, ConsentState, DENIED_CONSENT, type FirstTouchAttribution, JOURNEY_MAX_ITEMS, JOURNEY_STORAGE_KEY, type JourneyEntry, type LastTouchAttribution, type LastTouchChannel, PROVIDER_CONSENT, TagProvider, buildManifest, initObservers, isTagAllowed, readJourney, renderBeaconScript, renderConsentBootstrap, renderGa4BridgeScript, renderJourneyBridgeScript, renderLoaderScript, teardownObservers, trackCustomEvent };
+export { ALL_CONSENT_CATEGORIES, ATTRIBUTION_STORAGE_KEY, ATTRIBUTION_TTL_MS, AnalyticsManifest, AnalyticsSiteConfig, type BeaconOptions, CONSENT_STORAGE_KEY, type ConsentBannerOptions, ConsentCategory, ConsentState, DEFAULT_CONSENT, DENIED_CONSENT, type FirstTouchAttribution, JOURNEY_MAX_ITEMS, JOURNEY_STORAGE_KEY, type JourneyEntry, type LastTouchAttribution, type LastTouchChannel, PROVIDER_CONSENT, TagProvider, buildManifest, initObservers, isTagAllowed, readJourney, renderBeaconScript, renderConsentBannerMarkup, renderConsentBannerScript, renderConsentBootstrap, renderGa4BridgeScript, renderJourneyBridgeScript, renderLoaderScript, teardownObservers, trackCustomEvent };

package/dist/index.js

@@ -1,24 +1,28 @@
 import {
+  ALL_CONSENT_CATEGORIES,
+  CONSENT_STORAGE_KEY,
+  DEFAULT_CONSENT,
+  DENIED_CONSENT,
   JOURNEY_MAX_ITEMS,
   JOURNEY_STORAGE_KEY,
+  PROVIDER_CONSENT,
+  isTagAllowed,
   readJourney,
-  renderConsentBannerMarkup,
-  renderConsentBannerScript,
   renderConsentBootstrap,
   renderGa4BridgeScript,
   renderJourneyBridgeScript,
   renderLoaderScript
-} from "./chunk-G7OLBHT5.js";
+} from "./chunk-EHXYDR7C.js";
 import {
   initObservers,
   teardownObservers
-} from "./chunk-ABGGPWIX.js";
+} from "./chunk-GV4CWEWY.js";
 import {
   ATTRIBUTION_STORAGE_KEY,
   ATTRIBUTION_TTL_MS,
   renderBeaconScript,
   trackCustomEvent
-} from "./chunk-ANB42OLW.js";
+} from "./chunk-K3NVHH7K.js";
 import {
   GA4_MIRROR,
   TRACK_EVENTS,
@@ -31,30 +35,13 @@ import {
   classifyAiReferral,
   isAiReferralId,
   summarizeAiReferrals
-} from "./chunk-2WQ7PVRU.js";
-
-// src/consent.ts
-var ALL_CONSENT_CATEGORIES = [
-  "analytics_storage",
-  "ad_storage",
-  "ad_user_data",
-  "ad_personalization"
-];
-var DENIED_CONSENT = {
-  analytics_storage: "denied",
-  ad_storage: "denied",
-  ad_user_data: "denied",
-  ad_personalization: "denied"
-};
-var PROVIDER_CONSENT = {
-  ga4: ["analytics_storage"],
-  clarity: ["analytics_storage"],
-  naver: ["analytics_storage"],
-  meta_pixel: ["ad_storage", "ad_user_data", "ad_personalization"]
-};
-function isTagAllowed(required, consent) {
-  return required.every((c) => consent[c] === "granted");
-}
+} from "./chunk-6NWJK7V7.js";
+import {
+  ENTRY_CHANNEL_IDS,
+  ENTRY_CHANNEL_LABEL,
+  classifyEntryChannel,
+  isEntryChannelId
+} from "./chunk-KIOFZXJX.js";
 
 // src/manifest.ts
 function buildManifest(config) {
@@ -73,16 +60,73 @@ function buildManifest(config) {
   return {
     siteId: config.siteId,
     tags,
-    consentDefault: { ...DENIED_CONSENT }
+    consentDefault: { ...DEFAULT_CONSENT }
   };
 }
+
+// src/consent-banner.ts
+var BANNER_ID = "rt-consent";
+var STORAGE_KEY = CONSENT_STORAGE_KEY;
+function renderConsentBannerMarkup(options = {}) {
+  const message = options.message ?? "\uC774 \uC0AC\uC774\uD2B8\uB294 ROOT-ANALYTICS\uC640 \uC678\uBD80 \uBD84\uC11D\xB7\uAD11\uACE0 \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4. \uB3D9\uC758 \uC5EC\uBD80\uB97C \uC120\uD0DD\uD574 \uC8FC\uC138\uC694.";
+  const privacy = options.privacyUrl ? ` <a href="${escapeAttr(options.privacyUrl)}" target="_blank" rel="noopener">\uAC1C\uC778\uC815\uBCF4\uCC98\uB9AC\uBC29\uCE68</a>` : "";
+  return [
+    `<div id="${BANNER_ID}" role="dialog" aria-live="polite" aria-label="\uB3D9\uC758 \uC548\uB0B4" hidden`,
+    ` style="position:fixed;left:0;right:0;bottom:0;z-index:2147483647;`,
+    `background:#fff;border-top:1px solid #e5e7eb;padding:16px;`,
+    `display:flex;flex-wrap:wrap;gap:8px;align-items:center;justify-content:center;`,
+    `font-size:14px;line-height:1.5;color:#111;box-shadow:0 -2px 12px rgba(0,0,0,.06)">`,
+    `<span style="flex:1 1 280px;min-width:240px">${escapeHtml(message)}${privacy}</span>`,
+    `<button id="rt-consent-all" type="button" style="${BTN_PRIMARY}">\uBAA8\uB450 \uD5C8\uC6A9</button>`,
+    `<button id="rt-consent-analytics" type="button" style="${BTN_SECONDARY}">\uBD84\uC11D\uB9CC \uD5C8\uC6A9</button>`,
+    `<button id="rt-consent-deny" type="button" style="${BTN_GHOST}">\uAC70\uBD80</button>`,
+    `</div>`
+  ].join("");
+}
+function renderConsentBannerScript() {
+  return `(function(){
+var KEY=${JSON.stringify(STORAGE_KEY)};
+var el=document.getElementById(${JSON.stringify(BANNER_ID)});
+function apply(state){
+if(window.RootTaleAnalytics&&typeof window.RootTaleAnalytics.updateConsent==='function'){
+window.RootTaleAnalytics.updateConsent(state);
+}}
+function persist(state){try{localStorage.setItem(KEY,JSON.stringify(state));}catch(e){}}
+function read(){try{return JSON.parse(localStorage.getItem(KEY)||'null');}catch(e){return null;}}
+var ALL={analytics_storage:'granted',ad_storage:'granted',ad_user_data:'granted',ad_personalization:'granted'};
+var ANALYTICS={analytics_storage:'granted',ad_storage:'denied',ad_user_data:'denied',ad_personalization:'denied'};
+var DENY={analytics_storage:'denied',ad_storage:'denied',ad_user_data:'denied',ad_personalization:'denied'};
+function choose(state){apply(state);persist(state);if(el){el.hidden=true;}}
+var prior=read();
+if(prior){apply(prior);if(el){el.hidden=true;}}
+else if(el){el.hidden=false;}
+function bind(id,state){var b=document.getElementById(id);if(b){b.addEventListener('click',function(){choose(state);});}}
+bind('rt-consent-all',ALL);
+bind('rt-consent-analytics',ANALYTICS);
+bind('rt-consent-deny',DENY);
+})();`;
+}
+var BTN_BASE = "padding:8px 14px;border-radius:8px;font-size:14px;cursor:pointer;border:1px solid #d1d5db;";
+var BTN_PRIMARY = BTN_BASE + "background:#111;color:#fff;border-color:#111;";
+var BTN_SECONDARY = BTN_BASE + "background:#f3f4f6;color:#111;";
+var BTN_GHOST = BTN_BASE + "background:transparent;color:#6b7280;";
+function escapeHtml(s) {
+  return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
+}
+function escapeAttr(s) {
+  return escapeHtml(s).replace(/"/g, "&quot;");
+}
 export {
   AI_REFERRAL_IDS,
   AI_REFERRAL_LABEL,
   ALL_CONSENT_CATEGORIES,
   ATTRIBUTION_STORAGE_KEY,
   ATTRIBUTION_TTL_MS,
+  CONSENT_STORAGE_KEY,
+  DEFAULT_CONSENT,
   DENIED_CONSENT,
+  ENTRY_CHANNEL_IDS,
+  ENTRY_CHANNEL_LABEL,
   GA4_MIRROR,
   JOURNEY_MAX_ITEMS,
   JOURNEY_STORAGE_KEY,
@@ -91,8 +135,10 @@ export {
   aiReferralRulesLiteral,
   buildManifest,
   classifyAiReferral,
+  classifyEntryChannel,
   initObservers,
   isAiReferralId,
+  isEntryChannelId,
   isTagAllowed,
   isTrackEvent,
   readJourney,

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/consent.ts","../src/manifest.ts"],"sourcesContent":["// ADR-0038 §2 — 동의 fail-closed + provider↔consent 매핑.\n\nimport type { ConsentCategory, ConsentState, TagProvider } from \"./types\";\n\nexport const ALL_CONSENT_CATEGORIES: readonly ConsentCategory[] = [\n  \"analytics_storage\",\n  \"ad_storage\",\n  \"ad_user_data\",\n  \"ad_personalization\",\n] as const;\n\n/** fail-closed 기본값 — 전부 denied. */\nexport const DENIED_CONSENT: ConsentState = {\n  analytics_storage: \"denied\",\n  ad_storage: \"denied\",\n  ad_user_data: \"denied\",\n  ad_personalization: \"denied\",\n};\n\n/**\n * provider 가 발화하기 전 granted 여야 하는 동의 카테고리.\n * - analytics 도구(GA4·Clarity·Naver) → `analytics_storage`\n * - 광고 도구(Meta Pixel) → `ad_storage` + `ad_user_data` + `ad_personalization`\n *   (국외이전·광고목적이라 동의 요건 가장 강함)\n */\nexport const PROVIDER_CONSENT: Record<TagProvider, ConsentCategory[]> = {\n  ga4: [\"analytics_storage\"],\n  clarity: [\"analytics_storage\"],\n  naver: [\"analytics_storage\"],\n  meta_pixel: [\"ad_storage\", \"ad_user_data\", \"ad_personalization\"],\n};\n\n/** required 카테고리가 *모두* granted 일 때만 true. */\nexport function isTagAllowed(\n  required: readonly ConsentCategory[],\n  consent: ConsentState,\n): boolean {\n  return required.every((c) => consent[c] === \"granted\");\n}\n","// ADR-0038 §1 — site 태그 구성 → manifest (순수 함수).\n\nimport { DENIED_CONSENT, PROVIDER_CONSENT } from \"./consent\";\nimport type { AnalyticsManifest, AnalyticsSiteConfig } from \"./types\";\n\n/**\n * site 태그 구성을 manifest 로 해석.\n * - `enabled=false` 또는 빈 id 는 제외.\n * - provider 당 1개 (중복은 첫 항목만).\n * - 각 태그에 필요한 동의 카테고리(`PROVIDER_CONSENT`)를 부착.\n * - 동의 기본값은 항상 전부 denied (fail-closed).\n */\nexport function buildManifest(config: AnalyticsSiteConfig): AnalyticsManifest {\n  const seen = new Set<string>();\n  const tags = config.tags\n    .filter(\n      (t) => t.enabled && typeof t.id === \"string\" && t.id.trim() !== \"\",\n    )\n    .filter((t) => {\n      if (seen.has(t.provider)) return false;\n      seen.add(t.provider);\n      return true;\n    })\n    .map((t) => ({\n      provider: t.provider,\n      id: t.id.trim(),\n      requiredConsent: PROVIDER_CONSENT[t.provider],\n    }));\n\n  return {\n    siteId: config.siteId,\n    tags,\n    consentDefault: { ...DENIED_CONSENT },\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAIO,IAAM,yBAAqD;AAAA,EAChE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF;AAGO,IAAM,iBAA+B;AAAA,EAC1C,mBAAmB;AAAA,EACnB,YAAY;AAAA,EACZ,cAAc;AAAA,EACd,oBAAoB;AACtB;AAQO,IAAM,mBAA2D;AAAA,EACtE,KAAK,CAAC,mBAAmB;AAAA,EACzB,SAAS,CAAC,mBAAmB;AAAA,EAC7B,OAAO,CAAC,mBAAmB;AAAA,EAC3B,YAAY,CAAC,cAAc,gBAAgB,oBAAoB;AACjE;AAGO,SAAS,aACd,UACA,SACS;AACT,SAAO,SAAS,MAAM,CAAC,MAAM,QAAQ,CAAC,MAAM,SAAS;AACvD;;;AC1BO,SAAS,cAAc,QAAgD;AAC5E,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,OAAO,OAAO,KACjB;AAAA,IACC,CAAC,MAAM,EAAE,WAAW,OAAO,EAAE,OAAO,YAAY,EAAE,GAAG,KAAK,MAAM;AAAA,EAClE,EACC,OAAO,CAAC,MAAM;AACb,QAAI,KAAK,IAAI,EAAE,QAAQ,EAAG,QAAO;AACjC,SAAK,IAAI,EAAE,QAAQ;AACnB,WAAO;AAAA,EACT,CAAC,EACA,IAAI,CAAC,OAAO;AAAA,IACX,UAAU,EAAE;AAAA,IACZ,IAAI,EAAE,GAAG,KAAK;AAAA,IACd,iBAAiB,iBAAiB,EAAE,QAAQ;AAAA,EAC9C,EAAE;AAEJ,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf;AAAA,IACA,gBAAgB,EAAE,GAAG,eAAe;AAAA,EACtC;AACF;","names":[]}
+{"version":3,"sources":["../src/manifest.ts","../src/consent-banner.ts"],"sourcesContent":["// ADR-0038 §1 — site 태그 구성 → manifest (순수 함수).\n\nimport { DEFAULT_CONSENT, PROVIDER_CONSENT } from \"./consent\";\nimport type { AnalyticsManifest, AnalyticsSiteConfig } from \"./types\";\n\n/**\n * site 태그 구성을 manifest 로 해석.\n * - `enabled=false` 또는 빈 id 는 제외.\n * - provider 당 1개 (중복은 첫 항목만).\n * - 각 태그에 필요한 동의 카테고리(`PROVIDER_CONSENT`)를 부착.\n * - 동의 기본값 = 통계 granted · 광고 denied (ADR-0038 Amend 4 — 광고 도구는\n *   동의 UI 없이는 발화하지 않는다).\n */\nexport function buildManifest(config: AnalyticsSiteConfig): AnalyticsManifest {\n  const seen = new Set<string>();\n  const tags = config.tags\n    .filter(\n      (t) => t.enabled && typeof t.id === \"string\" && t.id.trim() !== \"\",\n    )\n    .filter((t) => {\n      if (seen.has(t.provider)) return false;\n      seen.add(t.provider);\n      return true;\n    })\n    .map((t) => ({\n      provider: t.provider,\n      id: t.id.trim(),\n      requiredConsent: PROVIDER_CONSENT[t.provider],\n    }));\n\n  return {\n    siteId: config.siteId,\n    tags,\n    consentDefault: { ...DEFAULT_CONSENT },\n  };\n}\n","// ADR-0038 §2 — 동의 배너. **Amend 4(2026-08-19)부터 기본 미렌더** —\n// 통계는 기본 허용이라 배너가 필요 없고, 광고 도구는 기본 denied 로 잠겨\n// 있다. 광고 연동을 도입하는 날 이 모듈을 다시 렌더러에 물린다(그때까지\n// 광고 태그는 발화 불가). 과거 배너가 저장한 선택은 loader.ts 가 계속 읽어\n// 존중한다(CONSENT_STORAGE_KEY 공유).\n//\n// 주의: `set:html`/`dangerouslySetInnerHTML` 로 주입된 <script> 는 실행되지\n// 않는다. 본 모듈은 *마크업* 과 *JS 본문* 을 분리 반환하고, 렌더러가 JS 는\n// <script is:inline> 로, 마크업은 컨테이너로 주입해야 한다.\n//\n// 마크업/스크립트가 공유하는 DOM id (계약):\n//   #rt-consent · #rt-consent-all · #rt-consent-analytics · #rt-consent-deny\n\nimport { CONSENT_STORAGE_KEY } from \"./consent\";\n\nexport interface ConsentBannerOptions {\n  /** 개인정보처리방침 링크 (테넌트별). 없으면 링크 생략. */\n  privacyUrl?: string;\n  /** 본문 카피. 기본 한국어. */\n  message?: string;\n}\n\nconst BANNER_ID = \"rt-consent\";\nconst STORAGE_KEY = CONSENT_STORAGE_KEY;\n\n/** 배너 마크업(HTML). 스크립트 미포함 — 컨테이너로 주입. */\nexport function renderConsentBannerMarkup(\n  options: ConsentBannerOptions = {},\n): string {\n  const message =\n    options.message ??\n    \"이 사이트는 ROOT-ANALYTICS와 외부 분석·광고 도구를 사용할 수 있습니다. 동의 여부를 선택해 주세요.\";\n  const privacy = options.privacyUrl\n    ? ` <a href=\"${escapeAttr(options.privacyUrl)}\" target=\"_blank\" rel=\"noopener\">개인정보처리방침</a>`\n    : \"\";\n\n  return [\n    `<div id=\"${BANNER_ID}\" role=\"dialog\" aria-live=\"polite\" aria-label=\"동의 안내\" hidden`,\n    ` style=\"position:fixed;left:0;right:0;bottom:0;z-index:2147483647;`,\n    `background:#fff;border-top:1px solid #e5e7eb;padding:16px;`,\n    `display:flex;flex-wrap:wrap;gap:8px;align-items:center;justify-content:center;`,\n    `font-size:14px;line-height:1.5;color:#111;box-shadow:0 -2px 12px rgba(0,0,0,.06)\">`,\n    `<span style=\"flex:1 1 280px;min-width:240px\">${escapeHtml(message)}${privacy}</span>`,\n    `<button id=\"rt-consent-all\" type=\"button\" style=\"${BTN_PRIMARY}\">모두 허용</button>`,\n    `<button id=\"rt-consent-analytics\" type=\"button\" style=\"${BTN_SECONDARY}\">분석만 허용</button>`,\n    `<button id=\"rt-consent-deny\" type=\"button\" style=\"${BTN_GHOST}\">거부</button>`,\n    `</div>`,\n  ].join(\"\");\n}\n\n/** 배너 동작(JS 본문). <script is:inline> 로 감싸 주입. */\nexport function renderConsentBannerScript(): string {\n  return `(function(){\nvar KEY=${JSON.stringify(STORAGE_KEY)};\nvar el=document.getElementById(${JSON.stringify(BANNER_ID)});\nfunction apply(state){\nif(window.RootTaleAnalytics&&typeof window.RootTaleAnalytics.updateConsent==='function'){\nwindow.RootTaleAnalytics.updateConsent(state);\n}}\nfunction persist(state){try{localStorage.setItem(KEY,JSON.stringify(state));}catch(e){}}\nfunction read(){try{return JSON.parse(localStorage.getItem(KEY)||'null');}catch(e){return null;}}\nvar ALL={analytics_storage:'granted',ad_storage:'granted',ad_user_data:'granted',ad_personalization:'granted'};\nvar ANALYTICS={analytics_storage:'granted',ad_storage:'denied',ad_user_data:'denied',ad_personalization:'denied'};\nvar DENY={analytics_storage:'denied',ad_storage:'denied',ad_user_data:'denied',ad_personalization:'denied'};\nfunction choose(state){apply(state);persist(state);if(el){el.hidden=true;}}\nvar prior=read();\nif(prior){apply(prior);if(el){el.hidden=true;}}\nelse if(el){el.hidden=false;}\nfunction bind(id,state){var b=document.getElementById(id);if(b){b.addEventListener('click',function(){choose(state);});}}\nbind('rt-consent-all',ALL);\nbind('rt-consent-analytics',ANALYTICS);\nbind('rt-consent-deny',DENY);\n})();`;\n}\n\nconst BTN_BASE =\n  \"padding:8px 14px;border-radius:8px;font-size:14px;cursor:pointer;border:1px solid #d1d5db;\";\nconst BTN_PRIMARY = BTN_BASE + \"background:#111;color:#fff;border-color:#111;\";\nconst BTN_SECONDARY = BTN_BASE + \"background:#f3f4f6;color:#111;\";\nconst BTN_GHOST = BTN_BASE + \"background:transparent;color:#6b7280;\";\n\nfunction escapeHtml(s: string): string {\n  return s\n    .replace(/&/g, \"&amp;\")\n    .replace(/</g, \"&lt;\")\n    .replace(/>/g, \"&gt;\");\n}\n\nfunction escapeAttr(s: string): string {\n  return escapeHtml(s).replace(/\"/g, \"&quot;\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAaO,SAAS,cAAc,QAAgD;AAC5E,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,OAAO,OAAO,KACjB;AAAA,IACC,CAAC,MAAM,EAAE,WAAW,OAAO,EAAE,OAAO,YAAY,EAAE,GAAG,KAAK,MAAM;AAAA,EAClE,EACC,OAAO,CAAC,MAAM;AACb,QAAI,KAAK,IAAI,EAAE,QAAQ,EAAG,QAAO;AACjC,SAAK,IAAI,EAAE,QAAQ;AACnB,WAAO;AAAA,EACT,CAAC,EACA,IAAI,CAAC,OAAO;AAAA,IACX,UAAU,EAAE;AAAA,IACZ,IAAI,EAAE,GAAG,KAAK;AAAA,IACd,iBAAiB,iBAAiB,EAAE,QAAQ;AAAA,EAC9C,EAAE;AAEJ,SAAO;AAAA,IACL,QAAQ,OAAO;AAAA,IACf;AAAA,IACA,gBAAgB,EAAE,GAAG,gBAAgB;AAAA,EACvC;AACF;;;ACbA,IAAM,YAAY;AAClB,IAAM,cAAc;AAGb,SAAS,0BACd,UAAgC,CAAC,GACzB;AACR,QAAM,UACJ,QAAQ,WACR;AACF,QAAM,UAAU,QAAQ,aACpB,aAAa,WAAW,QAAQ,UAAU,CAAC,0FAC3C;AAEJ,SAAO;AAAA,IACL,YAAY,SAAS;AAAA,IACrB;AAAA,IACA;AAAA,IACA;AAAA,IACA;AAAA,IACA,gDAAgD,WAAW,OAAO,CAAC,GAAG,OAAO;AAAA,IAC7E,oDAAoD,WAAW;AAAA,IAC/D,0DAA0D,aAAa;AAAA,IACvE,qDAAqD,SAAS;AAAA,IAC9D;AAAA,EACF,EAAE,KAAK,EAAE;AACX;AAGO,SAAS,4BAAoC;AAClD,SAAO;AAAA,UACC,KAAK,UAAU,WAAW,CAAC;AAAA,iCACJ,KAAK,UAAU,SAAS,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAmB1D;AAEA,IAAM,WACJ;AACF,IAAM,cAAc,WAAW;AAC/B,IAAM,gBAAgB,WAAW;AACjC,IAAM,YAAY,WAAW;AAE7B,SAAS,WAAW,GAAmB;AACrC,SAAO,EACJ,QAAQ,MAAM,OAAO,EACrB,QAAQ,MAAM,MAAM,EACpB,QAAQ,MAAM,MAAM;AACzB;AAEA,SAAS,WAAW,GAAmB;AACrC,SAAO,WAAW,CAAC,EAAE,QAAQ,MAAM,QAAQ;AAC7C;","names":[]}

package/dist/next.js

@@ -2,11 +2,11 @@
 import {
   initObservers,
   teardownObservers
-} from "./chunk-ABGGPWIX.js";
+} from "./chunk-GV4CWEWY.js";
 import {
   trackCustomEvent
-} from "./chunk-ANB42OLW.js";
-import "./chunk-2WQ7PVRU.js";
+} from "./chunk-K3NVHH7K.js";
+import "./chunk-6NWJK7V7.js";
 
 // src/next.tsx
 import { useEffect, useRef } from "react";

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
-import { b as AnalyticsManifest, c as ConsentBannerOptions } from './consent-banner-WVGsxcY2.js';
+import { b as AnalyticsManifest } from './types-VA3xp0bt.js';
 
 interface RootTaleAnalyticsProps {
     /** buildManifest() 결과. plane ① 태그 + fail-closed 동의 기본값. */
@@ -8,12 +8,8 @@ interface RootTaleAnalyticsProps {
     collectUrl?: string;
     /** 비콘용 site 식별자. collectUrl 과 함께 제공. */
     siteId?: string;
-    /** 동의 배너 개인정보처리방침 링크. */
-    privacyUrl?: string;
     /** 비콘 pageview 자동 전송 (기본 true). */
     trackPageview?: boolean;
-    /** 동의 배너 카피 override. */
-    bannerOptions?: ConsentBannerOptions;
     /**
      * GA4 미러 브리지 스크립트 주입 여부(설계 §0, 기본 true). beacon 이 없으면
      * (collectUrl/siteId 미설정) 어차피 미주입 — 이벤트를 흘려보낼 send() 자체가
@@ -34,6 +30,6 @@ interface RootTaleAnalyticsProps {
  * 단일 드롭인 컴포넌트. RSC 호환(hook/상태 없음) — Server Component layout 에
  * 바로 배치 가능.
  */
-declare function RootTaleAnalytics({ manifest, collectUrl, siteId, privacyUrl, trackPageview, bannerOptions, enableGa4Bridge, enableObservers, }: RootTaleAnalyticsProps): react_jsx_runtime.JSX.Element;
+declare function RootTaleAnalytics({ manifest, collectUrl, siteId, trackPageview, enableGa4Bridge, enableObservers, }: RootTaleAnalyticsProps): react_jsx_runtime.JSX.Element;
 
 export { RootTaleAnalytics, type RootTaleAnalyticsProps };

package/dist/react.js

@@ -1,16 +1,14 @@
 import {
-  renderConsentBannerMarkup,
-  renderConsentBannerScript,
   renderConsentBootstrap,
   renderGa4BridgeScript,
   renderJourneyBridgeScript,
   renderLoaderScript
-} from "./chunk-G7OLBHT5.js";
+} from "./chunk-EHXYDR7C.js";
 import {
   renderBeaconScript
-} from "./chunk-ANB42OLW.js";
+} from "./chunk-K3NVHH7K.js";
 import "./chunk-GBIGQHVN.js";
-import "./chunk-2WQ7PVRU.js";
+import "./chunk-6NWJK7V7.js";
 
 // src/react.tsx
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
@@ -18,17 +16,11 @@ function RootTaleAnalytics({
   manifest,
   collectUrl,
   siteId,
-  privacyUrl,
   trackPageview,
-  bannerOptions,
   enableGa4Bridge = true,
   enableObservers = true
 }) {
   const beacon = collectUrl && siteId ? renderBeaconScript({ collectUrl, siteId, trackPageview }) : null;
-  const bannerOpts = {
-    privacyUrl,
-    ...bannerOptions
-  };
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsx(
       "script",
@@ -42,21 +34,6 @@ function RootTaleAnalytics({
         dangerouslySetInnerHTML: { __html: renderLoaderScript(manifest) }
       }
     ),
-    /* @__PURE__ */ jsx(
-      "div",
-      {
-        suppressHydrationWarning: true,
-        dangerouslySetInnerHTML: {
-          __html: renderConsentBannerMarkup(bannerOpts)
-        }
-      }
-    ),
-    /* @__PURE__ */ jsx(
-      "script",
-      {
-        dangerouslySetInnerHTML: { __html: renderConsentBannerScript() }
-      }
-    ),
     beacon ? /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: beacon } }) : null,
     beacon ? /* @__PURE__ */ jsx(
       "script",

package/dist/react.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/react.tsx"],"sourcesContent":["// ADR-0038 — Next.js/React 드롭인 어댑터.\n//\n// `@roottale/analytics-runtime/react` 로 import. core 는 React-free 유지하고\n// 본 어댑터만 react(peerDependency)에 의존한다.\n//\n// 사용 (Next App Router root layout):\n//   import { RootTaleAnalytics } from \"@roottale/analytics-runtime/react\";\n//   ...\n//   <body>\n//     {children}\n//     <RootTaleAnalytics manifest={manifest} collectUrl={url} siteId={id} />\n//   </body>\n//\n// 모든 <script> 는 dangerouslySetInnerHTML 인라인 — Next 가 실제 실행되는\n// <script> 로 렌더(set:html innerHTML 함정 회피). 순서: consent bootstrap(전부\n// denied) → loader(fail-closed) → 배너 → 비콘.\n\nimport type { AnalyticsManifest } from \"./types\";\nimport { renderConsentBootstrap, renderLoaderScript } from \"./loader\";\nimport {\n  renderConsentBannerMarkup,\n  renderConsentBannerScript,\n  type ConsentBannerOptions,\n} from \"./consent-banner\";\nimport { renderBeaconScript } from \"./beacon\";\nimport { renderJourneyBridgeScript } from \"./journey\";\nimport { renderGa4BridgeScript } from \"./ga4-bridge\";\n\nexport interface RootTaleAnalyticsProps {\n  /** buildManifest() 결과. plane ① 태그 + fail-closed 동의 기본값. */\n  manifest: AnalyticsManifest;\n  /** plane ② 비콘 수집 엔드포인트. 없으면 비콘 미주입. */\n  collectUrl?: string;\n  /** 비콘용 site 식별자. collectUrl 과 함께 제공. */\n  siteId?: string;\n  /** 동의 배너 개인정보처리방침 링크. */\n  privacyUrl?: string;\n  /** 비콘 pageview 자동 전송 (기본 true). */\n  trackPageview?: boolean;\n  /** 동의 배너 카피 override. */\n  bannerOptions?: ConsentBannerOptions;\n  /**\n   * GA4 미러 브리지 스크립트 주입 여부(설계 §0, 기본 true). beacon 이 없으면\n   * (collectUrl/siteId 미설정) 어차피 미주입 — 이벤트를 흘려보낼 send() 자체가\n   * 없기 때문.\n   */\n  enableGa4Bridge?: boolean;\n  /**\n   * 방문 여정(observers.ts) 감지기 활성 여부(설계 §1 2단계, 기본 true). 본\n   * 컴포넌트는 RSC 호환(hook 없음)이라 IntersectionObserver 등을 직접\n   * 구동하지 못한다 — `false` 로 지정하면 `window.__rtObserversEnabled=false`\n   * 를 심어 `RootTaleAnalyticsNextAdapter`(next.tsx)가 initObservers() 호출\n   * 전 이 값을 읽고 건너뛰게 한다. `true`(기본)는 아무 것도 심지 않음(next.tsx\n   * 의 기본값이 이미 활성이므로 무동작이 곧 활성).\n   */\n  enableObservers?: boolean;\n}\n\n/**\n * 단일 드롭인 컴포넌트. RSC 호환(hook/상태 없음) — Server Component layout 에\n * 바로 배치 가능.\n */\nexport function RootTaleAnalytics({\n  manifest,\n  collectUrl,\n  siteId,\n  privacyUrl,\n  trackPageview,\n  bannerOptions,\n  enableGa4Bridge = true,\n  enableObservers = true,\n}: RootTaleAnalyticsProps) {\n  const beacon =\n    collectUrl && siteId\n      ? renderBeaconScript({ collectUrl, siteId, trackPageview })\n      : null;\n  const bannerOpts: ConsentBannerOptions = {\n    privacyUrl,\n    ...bannerOptions,\n  };\n\n  return (\n    <>\n      <script\n        dangerouslySetInnerHTML={{ __html: renderConsentBootstrap() }}\n      />\n      <script\n        dangerouslySetInnerHTML={{ __html: renderLoaderScript(manifest) }}\n      />\n      {/*\n        suppressHydrationWarning: `renderConsentBannerScript()` 는 일반\n        `<script>` 로 삽입되어 브라우저가 이 div 뒤에서 그 스크립트를 만나는\n        즉시(React 하이드레이션이 시작되기 전, 최초 HTML 파싱 도중) 동의 기록이\n        없으면 `el.hidden = false` 를 실행해 `hidden` 속성을 지운다 — 배너를\n        깜빡임 없이 보여주기 위해 의도된 동작이다. 그 결과 React 가 하이드레이션\n        시점에 비교하는 실제 DOM 은 이 컴포넌트가 SSR 로 낸 `__html`(hidden 포함)\n        과 달라져 \"tree hydrated but attributes didn't match\" 경고가 난다 —\n        React 문서가 안내하는 FOUC-방지 스크립트의 표준 처방(next-themes 류가\n        `<html>` 에 쓰는 것과 동일 패턴)대로 이 노드에서만 경고를 억제한다.\n      */}\n      <div\n        suppressHydrationWarning\n        dangerouslySetInnerHTML={{\n          __html: renderConsentBannerMarkup(bannerOpts),\n        }}\n      />\n      <script\n        dangerouslySetInnerHTML={{ __html: renderConsentBannerScript() }}\n      />\n      {beacon ? (\n        <script dangerouslySetInnerHTML={{ __html: beacon }} />\n      ) : null}\n      {/*\n        journey 브리지는 beacon 이 있을 때만 의미가 있다(훅 대상인\n        window.__rtTrack/send() 자체가 beacon 스크립트가 심는다) — opt-out\n        프롭 없음(1차 캡처 인프라, 설계 §3).\n      */}\n      {beacon ? (\n        <script\n          dangerouslySetInnerHTML={{ __html: renderJourneyBridgeScript() }}\n        />\n      ) : null}\n      {beacon && enableGa4Bridge ? (\n        <script\n          dangerouslySetInnerHTML={{ __html: renderGa4BridgeScript() }}\n        />\n      ) : null}\n      {enableObservers === false ? (\n        <script\n          dangerouslySetInnerHTML={{\n            __html: \"window.__rtObserversEnabled=false;\",\n          }}\n        />\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;AAkFI,mBACE,KADF;AApBG,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB,kBAAkB;AACpB,GAA2B;AACzB,QAAM,SACJ,cAAc,SACV,mBAAmB,EAAE,YAAY,QAAQ,cAAc,CAAC,IACxD;AACN,QAAM,aAAmC;AAAA,IACvC;AAAA,IACA,GAAG;AAAA,EACL;AAEA,SACE,iCACE;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,uBAAuB,EAAE;AAAA;AAAA,IAC9D;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,mBAAmB,QAAQ,EAAE;AAAA;AAAA,IAClE;AAAA,IAYA;AAAA,MAAC;AAAA;AAAA,QACC,0BAAwB;AAAA,QACxB,yBAAyB;AAAA,UACvB,QAAQ,0BAA0B,UAAU;AAAA,QAC9C;AAAA;AAAA,IACF;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,0BAA0B,EAAE;AAAA;AAAA,IACjE;AAAA,IACC,SACC,oBAAC,YAAO,yBAAyB,EAAE,QAAQ,OAAO,GAAG,IACnD;AAAA,IAMH,SACC;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,0BAA0B,EAAE;AAAA;AAAA,IACjE,IACE;AAAA,IACH,UAAU,kBACT;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,sBAAsB,EAAE;AAAA;AAAA,IAC7D,IACE;AAAA,IACH,oBAAoB,QACnB;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB;AAAA,UACvB,QAAQ;AAAA,QACV;AAAA;AAAA,IACF,IACE;AAAA,KACN;AAEJ;","names":[]}
+{"version":3,"sources":["../src/react.tsx"],"sourcesContent":["// ADR-0038 — Next.js/React 드롭인 어댑터.\n//\n// `@roottale/analytics-runtime/react` 로 import. core 는 React-free 유지하고\n// 본 어댑터만 react(peerDependency)에 의존한다.\n//\n// 사용 (Next App Router root layout):\n//   import { RootTaleAnalytics } from \"@roottale/analytics-runtime/react\";\n//   ...\n//   <body>\n//     {children}\n//     <RootTaleAnalytics manifest={manifest} collectUrl={url} siteId={id} />\n//   </body>\n//\n// 모든 <script> 는 dangerouslySetInnerHTML 인라인 — Next 가 실제 실행되는\n// <script> 로 렌더(set:html innerHTML 함정 회피). 순서: consent bootstrap\n// (통계 granted·광고 denied, ADR-0038 Amend 4) → loader → 비콘.\n//\n// 동의 배너는 렌더하지 않는다(Amend 4) — 통계는 한국법상 옵트인 대상이\n// 아니고, 광고 도구는 기본 denied 라 동의 UI 없이는 발화 자체가 불가하다.\n// 광고 연동을 도입하는 날이 오면 그때 consent-banner.ts 를 다시 물린다.\n\nimport type { AnalyticsManifest } from \"./types\";\nimport { renderConsentBootstrap, renderLoaderScript } from \"./loader\";\nimport { renderBeaconScript } from \"./beacon\";\nimport { renderJourneyBridgeScript } from \"./journey\";\nimport { renderGa4BridgeScript } from \"./ga4-bridge\";\n\nexport interface RootTaleAnalyticsProps {\n  /** buildManifest() 결과. plane ① 태그 + fail-closed 동의 기본값. */\n  manifest: AnalyticsManifest;\n  /** plane ② 비콘 수집 엔드포인트. 없으면 비콘 미주입. */\n  collectUrl?: string;\n  /** 비콘용 site 식별자. collectUrl 과 함께 제공. */\n  siteId?: string;\n  /** 비콘 pageview 자동 전송 (기본 true). */\n  trackPageview?: boolean;\n  /**\n   * GA4 미러 브리지 스크립트 주입 여부(설계 §0, 기본 true). beacon 이 없으면\n   * (collectUrl/siteId 미설정) 어차피 미주입 — 이벤트를 흘려보낼 send() 자체가\n   * 없기 때문.\n   */\n  enableGa4Bridge?: boolean;\n  /**\n   * 방문 여정(observers.ts) 감지기 활성 여부(설계 §1 2단계, 기본 true). 본\n   * 컴포넌트는 RSC 호환(hook 없음)이라 IntersectionObserver 등을 직접\n   * 구동하지 못한다 — `false` 로 지정하면 `window.__rtObserversEnabled=false`\n   * 를 심어 `RootTaleAnalyticsNextAdapter`(next.tsx)가 initObservers() 호출\n   * 전 이 값을 읽고 건너뛰게 한다. `true`(기본)는 아무 것도 심지 않음(next.tsx\n   * 의 기본값이 이미 활성이므로 무동작이 곧 활성).\n   */\n  enableObservers?: boolean;\n}\n\n/**\n * 단일 드롭인 컴포넌트. RSC 호환(hook/상태 없음) — Server Component layout 에\n * 바로 배치 가능.\n */\nexport function RootTaleAnalytics({\n  manifest,\n  collectUrl,\n  siteId,\n  trackPageview,\n  enableGa4Bridge = true,\n  enableObservers = true,\n}: RootTaleAnalyticsProps) {\n  const beacon =\n    collectUrl && siteId\n      ? renderBeaconScript({ collectUrl, siteId, trackPageview })\n      : null;\n\n  return (\n    <>\n      <script\n        dangerouslySetInnerHTML={{ __html: renderConsentBootstrap() }}\n      />\n      <script\n        dangerouslySetInnerHTML={{ __html: renderLoaderScript(manifest) }}\n      />\n      {beacon ? (\n        <script dangerouslySetInnerHTML={{ __html: beacon }} />\n      ) : null}\n      {/*\n        journey 브리지는 beacon 이 있을 때만 의미가 있다(훅 대상인\n        window.__rtTrack/send() 자체가 beacon 스크립트가 심는다) — opt-out\n        프롭 없음(1차 캡처 인프라, 설계 §3).\n      */}\n      {beacon ? (\n        <script\n          dangerouslySetInnerHTML={{ __html: renderJourneyBridgeScript() }}\n        />\n      ) : null}\n      {beacon && enableGa4Bridge ? (\n        <script\n          dangerouslySetInnerHTML={{ __html: renderGa4BridgeScript() }}\n        />\n      ) : null}\n      {enableObservers === false ? (\n        <script\n          dangerouslySetInnerHTML={{\n            __html: \"window.__rtObserversEnabled=false;\",\n          }}\n        />\n      ) : null}\n    </>\n  );\n}\n"],"mappings":";;;;;;;;;;;;;AAuEI,mBACE,KADF;AAdG,SAAS,kBAAkB;AAAA,EAChC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,kBAAkB;AAAA,EAClB,kBAAkB;AACpB,GAA2B;AACzB,QAAM,SACJ,cAAc,SACV,mBAAmB,EAAE,YAAY,QAAQ,cAAc,CAAC,IACxD;AAEN,SACE,iCACE;AAAA;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,uBAAuB,EAAE;AAAA;AAAA,IAC9D;AAAA,IACA;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,mBAAmB,QAAQ,EAAE;AAAA;AAAA,IAClE;AAAA,IACC,SACC,oBAAC,YAAO,yBAAyB,EAAE,QAAQ,OAAO,GAAG,IACnD;AAAA,IAMH,SACC;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,0BAA0B,EAAE;AAAA;AAAA,IACjE,IACE;AAAA,IACH,UAAU,kBACT;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB,EAAE,QAAQ,sBAAsB,EAAE;AAAA;AAAA,IAC7D,IACE;AAAA,IACH,oBAAoB,QACnB;AAAA,MAAC;AAAA;AAAA,QACC,yBAAyB;AAAA,UACvB,QAAQ;AAAA,QACV;AAAA;AAAA,IACF,IACE;AAAA,KACN;AAEJ;","names":[]}

package/dist/{consent-banner-WVGsxcY2.d.ts → types-VA3xp0bt.d.ts}

@@ -39,15 +39,4 @@ interface AnalyticsManifest {
     consentDefault: ConsentState;
 }
 
-interface ConsentBannerOptions {
-    /** 개인정보처리방침 링크 (테넌트별). 없으면 링크 생략. */
-    privacyUrl?: string;
-    /** 본문 카피. 기본 한국어. */
-    message?: string;
-}
-/** 배너 마크업(HTML). 스크립트 미포함 — 컨테이너로 주입. */
-declare function renderConsentBannerMarkup(options?: ConsentBannerOptions): string;
-/** 배너 동작(JS 본문). <script is:inline> 로 감싸 주입. */
-declare function renderConsentBannerScript(): string;
-
-export { type AnalyticsSiteConfig as A, type ConsentCategory as C, type ResolvedTag as R, type TagProvider as T, type ConsentState as a, type AnalyticsManifest as b, type ConsentBannerOptions as c, type ConsentValue as d, type TagConfig as e, renderConsentBannerScript as f, renderConsentBannerMarkup as r };
+export type { AnalyticsSiteConfig as A, ConsentCategory as C, ResolvedTag as R, TagProvider as T, ConsentState as a, AnalyticsManifest as b, ConsentValue as c, TagConfig as d };