@vircle/plugin-ecommerce-core 0.1.0

package/dist/index.mjs

@@ -0,0 +1,401 @@
+// src/NetworkInterceptor.ts
+var NetworkInterceptor = class {
+  constructor(patterns, callback) {
+    this.patterns = [];
+    this.isActive = false;
+    this.patterns = patterns;
+    this.callback = callback;
+  }
+  /**
+   * Start intercepting network requests
+   */
+  start() {
+    if (this.isActive) return;
+    if (typeof window === "undefined") return;
+    this.patchFetch();
+    this.patchXHR();
+    this.isActive = true;
+  }
+  /**
+   * Stop intercepting and restore original functions
+   */
+  stop() {
+    if (!this.isActive) return;
+    this.restoreFetch();
+    this.restoreXHR();
+    this.isActive = false;
+  }
+  /**
+   * Check if a URL matches any registered pattern
+   */
+  matchUrl(url, method) {
+    return this.patterns.find((p) => {
+      const urlMatch = p.pattern instanceof RegExp ? p.pattern.test(url) : url.includes(p.pattern);
+      const methodMatch = !p.method || p.method === method?.toUpperCase();
+      return urlMatch && methodMatch;
+    });
+  }
+  patchFetch() {
+    if (typeof window.fetch !== "function") return;
+    this.originalFetch = window.fetch;
+    const self = this;
+    window.fetch = function(input, init) {
+      const url = typeof input === "string" ? input : input instanceof URL ? input.toString() : input.url;
+      const method = init?.method || "GET";
+      const pattern = self.matchUrl(url, method);
+      if (pattern && self.callback.onRequest) {
+        try {
+          let body;
+          try {
+            if (init?.body) {
+              body = typeof init.body === "string" ? init.body : init.body instanceof FormData ? Object.fromEntries(init.body.entries()) : init.body;
+            }
+          } catch {
+          }
+          self.callback.onRequest(url, method, body);
+        } catch {
+        }
+      }
+      return self.originalFetch.call(window, input, init).then((response) => {
+        if (pattern && self.callback.onResponse) {
+          try {
+            const contentType = response.headers.get("content-type") || "";
+            if (!contentType.includes("application/json") && !contentType.includes("text/")) {
+              try {
+                self.callback.onResponse(url, response.status, void 0);
+              } catch {
+              }
+            } else {
+              const cloned = response.clone();
+              cloned.text().then((text) => {
+                try {
+                  const json = JSON.parse(text);
+                  self.callback.onResponse(url, response.status, json);
+                } catch {
+                  try {
+                    self.callback.onResponse(url, response.status, text);
+                  } catch {
+                  }
+                }
+              }).catch(() => {
+                try {
+                  self.callback.onResponse(url, response.status, void 0);
+                } catch {
+                }
+              });
+            }
+          } catch {
+          }
+        }
+        return response;
+      });
+    };
+  }
+  patchXHR() {
+    if (typeof XMLHttpRequest === "undefined") return;
+    this.originalXHROpen = XMLHttpRequest.prototype.open;
+    this.originalXHRSend = XMLHttpRequest.prototype.send;
+    const self = this;
+    XMLHttpRequest.prototype.open = function(method, url, ...args) {
+      this.__vircle_url = typeof url === "string" ? url : url.toString();
+      this.__vircle_method = method;
+      return self.originalXHROpen.apply(this, [method, url, ...args]);
+    };
+    XMLHttpRequest.prototype.send = function(body) {
+      const url = this.__vircle_url;
+      const method = this.__vircle_method;
+      const pattern = url ? self.matchUrl(url, method) : void 0;
+      if (pattern && self.callback.onRequest) {
+        try {
+          let parsedBody;
+          try {
+            if (typeof body === "string") {
+              parsedBody = body;
+            } else if (body instanceof FormData) {
+              parsedBody = Object.fromEntries(body.entries());
+            }
+          } catch {
+          }
+          self.callback.onRequest(url, method, parsedBody);
+        } catch {
+        }
+      }
+      if (pattern && self.callback.onResponse) {
+        this.addEventListener("load", function() {
+          try {
+            const contentType = this.getResponseHeader("content-type") || "";
+            if (!contentType.includes("application/json") && !contentType.includes("text/")) {
+              self.callback.onResponse(url, this.status, void 0);
+              return;
+            }
+            const responseBody = this.responseType === "" || this.responseType === "text" ? JSON.parse(this.responseText) : this.response;
+            self.callback.onResponse(url, this.status, responseBody);
+          } catch {
+            try {
+              self.callback.onResponse(url, this.status, this.responseText);
+            } catch {
+            }
+          }
+        });
+      }
+      return self.originalXHRSend.call(this, body);
+    };
+  }
+  restoreFetch() {
+    if (this.originalFetch && typeof window !== "undefined") {
+      window.fetch = this.originalFetch;
+      this.originalFetch = void 0;
+    }
+  }
+  restoreXHR() {
+    if (typeof XMLHttpRequest === "undefined") return;
+    if (this.originalXHROpen) {
+      XMLHttpRequest.prototype.open = this.originalXHROpen;
+      this.originalXHROpen = void 0;
+    }
+    if (this.originalXHRSend) {
+      XMLHttpRequest.prototype.send = this.originalXHRSend;
+      this.originalXHRSend = void 0;
+    }
+  }
+};
+
+// src/types.ts
+var EcommerceEvent = /* @__PURE__ */ ((EcommerceEvent2) => {
+  EcommerceEvent2["PAGE_VIEWED"] = "page_viewed";
+  EcommerceEvent2["PRODUCT_VIEWED"] = "product_viewed";
+  EcommerceEvent2["PRODUCT_ADDED_TO_CART"] = "product_added_to_cart";
+  EcommerceEvent2["PRODUCT_REMOVED_FROM_CART"] = "product_removed_from_cart";
+  EcommerceEvent2["CART_VIEWED"] = "cart_viewed";
+  EcommerceEvent2["CART_UPDATED"] = "cart_updated";
+  EcommerceEvent2["PRODUCT_ADDED_TO_WISHLIST"] = "product_added_to_wishlist";
+  EcommerceEvent2["CHECKOUT_STARTED"] = "checkout_started";
+  EcommerceEvent2["EXTERNAL_PAYMENT_INITIATED"] = "external_payment_initiated";
+  EcommerceEvent2["ORDER_COMPLETED"] = "order_completed";
+  return EcommerceEvent2;
+})(EcommerceEvent || {});
+var PageType = /* @__PURE__ */ ((PageType2) => {
+  PageType2["HOME"] = "home";
+  PageType2["PRODUCT_LIST"] = "product_list";
+  PageType2["PRODUCT_DETAIL"] = "product_detail";
+  PageType2["CART"] = "cart";
+  PageType2["CHECKOUT"] = "checkout";
+  PageType2["ORDER_COMPLETE"] = "order_complete";
+  PageType2["SEARCH_RESULTS"] = "search_results";
+  PageType2["MY_PAGE"] = "my_page";
+  PageType2["OTHER"] = "other";
+  return PageType2;
+})(PageType || {});
+
+// src/BaseEcommercePlugin.ts
+var DEFAULT_DEDUPLICATION_WINDOW = 2e3;
+var CAMPAIGN_PARAMS = [
+  "utm_source",
+  "utm_medium",
+  "utm_campaign",
+  "utm_term",
+  "utm_content",
+  "gclid",
+  "fbclid",
+  "msclkid",
+  "ttclid"
+];
+var CAMPAIGN_STORAGE_PREFIX = "__vircle_campaign_";
+var BaseEcommercePlugin = class {
+  constructor() {
+    this.pluginConfig = {};
+    /** 모든 이벤트에 자동 첨부되는 글로벌 프로퍼티 (크로스 도메인 어트리뷰션 등) */
+    this.globalProperties = {};
+    this.recentEvents = /* @__PURE__ */ new Set();
+    this.dedupeTimers = /* @__PURE__ */ new Map();
+  }
+  /**
+   * Called after base initialization, override for platform-specific setup
+   */
+  onInitialized() {
+  }
+  /**
+   * Called before cleanup, override for platform-specific teardown
+   */
+  onCleanup() {
+  }
+  async initialize(config, context) {
+    this.pluginConfig = { ...this.getDefaultConfig(), ...config };
+    this.context = context;
+    this.adapter = this.createAdapter();
+    this.adapter.initialize(this.pluginConfig, context);
+    if (this.pluginConfig.trackNetworkRequests !== false) {
+      const patterns = this.getNetworkPatterns();
+      this.interceptor = new NetworkInterceptor(patterns, {
+        onRequest: (url, method, body) => {
+          this.handleNetworkRequest(url, method, body);
+        },
+        onResponse: (url, status, body) => {
+          this.handleNetworkResponse(url, status, body);
+        }
+      });
+      this.interceptor.start();
+    }
+    if (this.pluginConfig.trackPageViews !== false) {
+      this.setupNavigationTracking();
+    }
+    this.initCampaignParams();
+    this.onInitialized();
+    this.context.logger.info("Plugin initialized");
+  }
+  async cleanup() {
+    this.onCleanup();
+    if (this.interceptor) {
+      this.interceptor.stop();
+      this.interceptor = void 0;
+    }
+    if (this.navigationCleanup) {
+      this.navigationCleanup();
+      this.navigationCleanup = void 0;
+    }
+    if (this.adapter) {
+      this.adapter.cleanup();
+      this.adapter = void 0;
+    }
+    this.recentEvents.clear();
+    for (const timer of this.dedupeTimers.values()) {
+      clearTimeout(timer);
+    }
+    this.dedupeTimers.clear();
+    this.context?.logger.info("Plugin cleaned up");
+    this.context = void 0;
+  }
+  /**
+   * Track an e-commerce event with deduplication
+   */
+  trackEvent(event, properties) {
+    if (!this.context) return;
+    const identifier = properties.product_id || properties.order_id || properties.url || (Array.isArray(properties.items) ? `items:${properties.items.length}` : "");
+    const dedupeKey = `${event}:${identifier}`;
+    const dedupeWindow = this.pluginConfig.deduplicationWindow || DEFAULT_DEDUPLICATION_WINDOW;
+    if (this.recentEvents.has(dedupeKey)) {
+      this.context.logger.debug(`Deduplicating event: ${event}`);
+      return;
+    }
+    this.recentEvents.add(dedupeKey);
+    const timer = setTimeout(() => {
+      this.recentEvents.delete(dedupeKey);
+      this.dedupeTimers.delete(dedupeKey);
+    }, dedupeWindow);
+    this.dedupeTimers.set(dedupeKey, timer);
+    const meta = this.adapter?.getPlatformMeta() || {};
+    const enrichedProperties = {
+      ...this.globalProperties,
+      ...properties,
+      platform: meta
+    };
+    this.context.track(event, enrichedProperties);
+  }
+  /**
+   * Handle intercepted network request — override in subclass for specific behavior
+   */
+  handleNetworkRequest(_url, _method, _body) {
+  }
+  /**
+   * Handle intercepted network response — override in subclass for specific behavior
+   */
+  handleNetworkResponse(_url, _status, _body) {
+  }
+  /**
+   * Handle page navigation
+   */
+  handlePageNavigation(url) {
+    if (!this.adapter || !this.context) return;
+    const pageType = this.adapter.detectPageType();
+    this.trackEvent("page_viewed" /* PAGE_VIEWED */, {
+      url,
+      page_type: pageType,
+      title: typeof document !== "undefined" ? document.title : void 0
+    });
+  }
+  setupNavigationTracking() {
+    if (typeof window === "undefined") return;
+    const handleNavigation = () => {
+      this.handlePageNavigation(window.location.href);
+    };
+    const originalPushState = history.pushState;
+    const originalReplaceState = history.replaceState;
+    history.pushState = function(...args) {
+      const result = originalPushState.apply(this, args);
+      try {
+        handleNavigation();
+      } catch (_) {
+      }
+      return result;
+    };
+    history.replaceState = function(...args) {
+      const result = originalReplaceState.apply(this, args);
+      try {
+        handleNavigation();
+      } catch (_) {
+      }
+      return result;
+    };
+    window.addEventListener("popstate", handleNavigation);
+    this.navigationCleanup = () => {
+      history.pushState = originalPushState;
+      history.replaceState = originalReplaceState;
+      window.removeEventListener("popstate", handleNavigation);
+    };
+    handleNavigation();
+  }
+  /**
+   * URL의 캠페인 파라미터(UTM + 광고 ID)를 수집하여 globalProperties에 설정.
+   * sessionStorage를 사용하여 MPA 페이지 전환 간에도 유지.
+   */
+  initCampaignParams() {
+    if (typeof window === "undefined") return;
+    const params = new URLSearchParams(window.location.search);
+    let hasUrlCampaign = false;
+    for (const param of CAMPAIGN_PARAMS) {
+      if (params.get(param)) {
+        hasUrlCampaign = true;
+        break;
+      }
+    }
+    if (hasUrlCampaign) {
+      for (const param of CAMPAIGN_PARAMS) {
+        try {
+          sessionStorage.removeItem(CAMPAIGN_STORAGE_PREFIX + param);
+        } catch {
+        }
+      }
+    }
+    for (const param of CAMPAIGN_PARAMS) {
+      const value = params.get(param);
+      if (value) {
+        try {
+          sessionStorage.setItem(CAMPAIGN_STORAGE_PREFIX + param, value);
+        } catch {
+        }
+      }
+    }
+    for (const param of CAMPAIGN_PARAMS) {
+      try {
+        const stored = sessionStorage.getItem(CAMPAIGN_STORAGE_PREFIX + param);
+        if (stored) {
+          this.globalProperties[param] = stored;
+        }
+      } catch {
+      }
+    }
+  }
+  getDefaultConfig() {
+    return {
+      trackPageViews: true,
+      trackNetworkRequests: true,
+      trackDomInteractions: true,
+      deduplicationWindow: DEFAULT_DEDUPLICATION_WINDOW,
+      debug: false
+    };
+  }
+};
+
+export { BaseEcommercePlugin, EcommerceEvent, NetworkInterceptor, PageType };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/NetworkInterceptor.ts","../src/types.ts","../src/BaseEcommercePlugin.ts"],"names":["EcommerceEvent","PageType"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Network interceptor for capturing fetch/XHR requests\n * Patches window.fetch and XMLHttpRequest to intercept matching API calls\n */\n\nimport type { NetworkPattern, NetworkInterceptCallback } from './types';\n\nexport class NetworkInterceptor {\n    private patterns: NetworkPattern[] = [];\n    private callback: NetworkInterceptCallback;\n    private originalFetch?: typeof window.fetch;\n    private originalXHROpen?: typeof XMLHttpRequest.prototype.open;\n    private originalXHRSend?: typeof XMLHttpRequest.prototype.send;\n    private isActive = false;\n\n    constructor(patterns: NetworkPattern[], callback: NetworkInterceptCallback) {\n        this.patterns = patterns;\n        this.callback = callback;\n    }\n\n    /**\n     * Start intercepting network requests\n     */\n    start(): void {\n        if (this.isActive) return;\n        if (typeof window === 'undefined') return;\n\n        this.patchFetch();\n        this.patchXHR();\n        this.isActive = true;\n    }\n\n    /**\n     * Stop intercepting and restore original functions\n     */\n    stop(): void {\n        if (!this.isActive) return;\n\n        this.restoreFetch();\n        this.restoreXHR();\n        this.isActive = false;\n    }\n\n    /**\n     * Check if a URL matches any registered pattern\n     */\n    matchUrl(url: string, method?: string): NetworkPattern | undefined {\n        return this.patterns.find((p) => {\n            const urlMatch =\n                p.pattern instanceof RegExp ? p.pattern.test(url) : url.includes(p.pattern);\n            const methodMatch = !p.method || p.method === method?.toUpperCase();\n            return urlMatch && methodMatch;\n        });\n    }\n\n    private patchFetch(): void {\n        if (typeof window.fetch !== 'function') return;\n\n        this.originalFetch = window.fetch;\n        const self = this;\n\n        window.fetch = function (input: RequestInfo | URL, init?: RequestInit): Promise<Response> {\n            const url = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;\n            const method = init?.method || 'GET';\n            const pattern = self.matchUrl(url, method);\n\n            if (pattern && self.callback.onRequest) {\n                try {\n                    let body: any;\n                    try {\n                        if (init?.body) {\n                            body =\n                                typeof init.body === 'string'\n                                    ? init.body\n                                    : init.body instanceof FormData\n                                      ? Object.fromEntries((init.body as any).entries())\n                                      : init.body;\n                        }\n                    } catch {\n                        // Ignore body parsing errors\n                    }\n                    self.callback.onRequest(url, method, body);\n                } catch {\n                    // Never let interceptor errors break application fetch calls\n                }\n            }\n\n            return self.originalFetch!.call(window, input, init).then((response) => {\n                if (pattern && self.callback.onResponse) {\n                    try {\n                        // Content-Type 체크: JSON 응답만 파싱 (대용량 바이너리 응답 OOM 방지)\n                        const contentType = response.headers.get('content-type') || '';\n                        if (!contentType.includes('application/json') && !contentType.includes('text/')) {\n                            try {\n                                self.callback.onResponse!(url, response.status, undefined);\n                            } catch {\n                                // Ignore onResponse callback errors\n                            }\n                        } else {\n                            const cloned = response.clone();\n                            // text() 먼저 호출 후 JSON.parse 시도 (clone body는 1회만 소비 가능)\n                            cloned\n                                .text()\n                                .then((text) => {\n                                    try {\n                                        const json = JSON.parse(text);\n                                        self.callback.onResponse!(url, response.status, json);\n                                    } catch {\n                                        try {\n                                            self.callback.onResponse!(url, response.status, text);\n                                        } catch {\n                                            // Ignore onResponse callback errors\n                                        }\n                                    }\n                                })\n                                .catch(() => {\n                                    try {\n                                        self.callback.onResponse!(url, response.status, undefined);\n                                    } catch {\n                                        // Ignore onResponse callback errors\n                                    }\n                                });\n                        }\n                    } catch {\n                        // Ignore clone/response handling errors to avoid breaking the app\n                    }\n                }\n                return response;\n            });\n        };\n    }\n\n    private patchXHR(): void {\n        if (typeof XMLHttpRequest === 'undefined') return;\n\n        this.originalXHROpen = XMLHttpRequest.prototype.open;\n        this.originalXHRSend = XMLHttpRequest.prototype.send;\n        const self = this;\n\n        XMLHttpRequest.prototype.open = function (\n            method: string,\n            url: string | URL,\n            ...args: any[]\n        ) {\n            (this as any).__vircle_url = typeof url === 'string' ? url : url.toString();\n            (this as any).__vircle_method = method;\n            return self.originalXHROpen!.apply(this, [method, url, ...args] as any);\n        };\n\n        XMLHttpRequest.prototype.send = function (body?: Document | XMLHttpRequestBodyInit | null) {\n            const url = (this as any).__vircle_url as string;\n            const method = (this as any).__vircle_method as string;\n            const pattern = url ? self.matchUrl(url, method) : undefined;\n\n            if (pattern && self.callback.onRequest) {\n                try {\n                    let parsedBody: any;\n                    try {\n                        if (typeof body === 'string') {\n                            parsedBody = body;\n                        } else if (body instanceof FormData) {\n                            parsedBody = Object.fromEntries((body as any).entries());\n                        }\n                    } catch {\n                        // Ignore body parsing errors\n                    }\n                    self.callback.onRequest(url, method, parsedBody);\n                } catch {\n                    // Never let interceptor errors break application XHR calls\n                }\n            }\n\n            if (pattern && self.callback.onResponse) {\n                this.addEventListener('load', function () {\n                    try {\n                        // Content-Type 체크: JSON/text 응답만 파싱\n                        const contentType = this.getResponseHeader('content-type') || '';\n                        if (!contentType.includes('application/json') && !contentType.includes('text/')) {\n                            self.callback.onResponse!(url, this.status, undefined);\n                            return;\n                        }\n                        const responseBody =\n                            this.responseType === '' || this.responseType === 'text'\n                                ? JSON.parse(this.responseText)\n                                : this.response;\n                        self.callback.onResponse!(url, this.status, responseBody);\n                    } catch {\n                        try {\n                            self.callback.onResponse!(url, this.status, this.responseText);\n                        } catch {\n                            // Ignore onResponse callback errors\n                        }\n                    }\n                });\n            }\n\n            return self.originalXHRSend!.call(this, body);\n        };\n    }\n\n    private restoreFetch(): void {\n        if (this.originalFetch && typeof window !== 'undefined') {\n            window.fetch = this.originalFetch;\n            this.originalFetch = undefined;\n        }\n    }\n\n    private restoreXHR(): void {\n        if (typeof XMLHttpRequest === 'undefined') return;\n\n        if (this.originalXHROpen) {\n            XMLHttpRequest.prototype.open = this.originalXHROpen;\n            this.originalXHROpen = undefined;\n        }\n        if (this.originalXHRSend) {\n            XMLHttpRequest.prototype.send = this.originalXHRSend;\n            this.originalXHRSend = undefined;\n        }\n    }\n}\n","/**\n * E-commerce plugin core types\n */\n\nimport type { PluginContext } from '@vircle/sdk-core-ts';\n\n/**\n * Standard e-commerce event names\n */\nexport enum EcommerceEvent {\n    PAGE_VIEWED = 'page_viewed',\n    PRODUCT_VIEWED = 'product_viewed',\n    PRODUCT_ADDED_TO_CART = 'product_added_to_cart',\n    PRODUCT_REMOVED_FROM_CART = 'product_removed_from_cart',\n    CART_VIEWED = 'cart_viewed',\n    CART_UPDATED = 'cart_updated',\n    PRODUCT_ADDED_TO_WISHLIST = 'product_added_to_wishlist',\n    CHECKOUT_STARTED = 'checkout_started',\n    EXTERNAL_PAYMENT_INITIATED = 'external_payment_initiated',\n    ORDER_COMPLETED = 'order_completed',\n}\n\n/**\n * Product sub-object schema\n */\nexport interface Product {\n    product_id: string;\n    name: string;\n    price: number;\n    sku?: string;\n    category?: string;\n    brand?: string;\n    variant?: string;\n    quantity?: number;\n    currency?: string;\n    image_url?: string;\n    url?: string;\n    position?: number;\n}\n\n/**\n * Cart item sub-object schema\n */\nexport interface CartItem extends Product {\n    quantity: number;\n    item_total?: number;\n}\n\n/**\n * Order item sub-object schema\n */\nexport interface OrderItem extends Product {\n    quantity: number;\n    item_total: number;\n    discount?: number;\n}\n\n/**\n * E-commerce plugin configuration\n */\nexport interface EcommercePluginConfig {\n    /** Enable automatic page view tracking */\n    trackPageViews?: boolean;\n    /** Enable network request interception */\n    trackNetworkRequests?: boolean;\n    /** Enable DOM-based tracking */\n    trackDomInteractions?: boolean;\n    /** Custom URL patterns to intercept */\n    urlPatterns?: NetworkPattern[];\n    /** Event deduplication window in ms */\n    deduplicationWindow?: number;\n    /** Debug mode */\n    debug?: boolean;\n}\n\n/**\n * Network URL pattern for interception\n */\nexport interface NetworkPattern {\n    /** URL pattern (string match or regex) */\n    pattern: string | RegExp;\n    /** HTTP method filter */\n    method?: 'GET' | 'POST' | 'PUT' | 'DELETE';\n    /** Event to emit when matched */\n    event: EcommerceEvent;\n}\n\n/**\n * Platform adapter interface — contract for platform-specific implementations\n */\nexport interface PlatformAdapter {\n    /** Platform name */\n    readonly name: string;\n\n    /** Initialize adapter */\n    initialize(config: EcommercePluginConfig, context: PluginContext): void;\n\n    /** Cleanup adapter resources */\n    cleanup(): void;\n\n    /** Detect current page type */\n    detectPageType(): PageType;\n\n    /** Extract product data from current page */\n    extractProduct(): Product | null;\n\n    /** Extract cart items from current page */\n    extractCartItems(): CartItem[];\n\n    /** Extract order data from current page */\n    extractOrder(): OrderData | null;\n\n    /** Get platform-specific metadata */\n    getPlatformMeta(): Record<string, any>;\n}\n\n/**\n * Page types for e-commerce sites\n */\nexport enum PageType {\n    HOME = 'home',\n    PRODUCT_LIST = 'product_list',\n    PRODUCT_DETAIL = 'product_detail',\n    CART = 'cart',\n    CHECKOUT = 'checkout',\n    ORDER_COMPLETE = 'order_complete',\n    SEARCH_RESULTS = 'search_results',\n    MY_PAGE = 'my_page',\n    OTHER = 'other',\n}\n\n/**\n * Order data structure\n */\nexport interface OrderData {\n    order_id: string;\n    total: number;\n    subtotal?: number;\n    tax?: number;\n    shipping?: number;\n    discount?: number;\n    currency?: string;\n    payment_method?: string;\n    items: OrderItem[];\n}\n\n/**\n * Network intercept callback\n */\nexport interface NetworkInterceptCallback {\n    onRequest?(url: string, method: string, body?: any): void;\n    onResponse?(url: string, status: number, body?: any): void;\n}\n","/**\n * Base e-commerce plugin that platform-specific plugins extend\n */\n\nimport type { VirclePlugin, PluginContext, PluginHooks } from '@vircle/sdk-core-ts';\nimport { NetworkInterceptor } from './NetworkInterceptor';\nimport { EcommerceEvent } from './types';\nimport type {\n    EcommercePluginConfig,\n    PlatformAdapter,\n    NetworkPattern,\n} from './types';\n\nconst DEFAULT_DEDUPLICATION_WINDOW = 2000; // 2 seconds\n\nconst CAMPAIGN_PARAMS = [\n    'utm_source', 'utm_medium', 'utm_campaign', 'utm_term', 'utm_content',\n    'gclid', 'fbclid', 'msclkid', 'ttclid',\n];\nconst CAMPAIGN_STORAGE_PREFIX = '__vircle_campaign_';\n\nexport abstract class BaseEcommercePlugin implements VirclePlugin {\n    abstract readonly name: string;\n    abstract readonly version: string;\n    abstract readonly description: string;\n\n    protected context?: PluginContext;\n    protected pluginConfig: EcommercePluginConfig = {};\n    protected adapter?: PlatformAdapter;\n    protected interceptor?: NetworkInterceptor;\n    /** 모든 이벤트에 자동 첨부되는 글로벌 프로퍼티 (크로스 도메인 어트리뷰션 등) */\n    protected globalProperties: Record<string, unknown> = {};\n    private recentEvents = new Set<string>();\n    private dedupeTimers = new Map<string, ReturnType<typeof setTimeout>>();\n    private navigationCleanup?: () => void;\n\n    hooks?: PluginHooks;\n\n    /**\n     * Get network patterns for this platform\n     */\n    protected abstract getNetworkPatterns(): NetworkPattern[];\n\n    /**\n     * Create the platform adapter\n     */\n    protected abstract createAdapter(): PlatformAdapter;\n\n    /**\n     * Called after base initialization, override for platform-specific setup\n     */\n    protected onInitialized(): void {\n        // Override in subclass\n    }\n\n    /**\n     * Called before cleanup, override for platform-specific teardown\n     */\n    protected onCleanup(): void {\n        // Override in subclass\n    }\n\n    async initialize(config: EcommercePluginConfig, context: PluginContext): Promise<void> {\n        this.pluginConfig = { ...this.getDefaultConfig(), ...config };\n        this.context = context;\n\n        // Create platform adapter\n        this.adapter = this.createAdapter();\n        this.adapter.initialize(this.pluginConfig, context);\n\n        // Setup network interceptor\n        if (this.pluginConfig.trackNetworkRequests !== false) {\n            const patterns = this.getNetworkPatterns();\n            this.interceptor = new NetworkInterceptor(patterns, {\n                onRequest: (url, method, body) => {\n                    this.handleNetworkRequest(url, method, body);\n                },\n                onResponse: (url, status, body) => {\n                    this.handleNetworkResponse(url, status, body);\n                },\n            });\n            this.interceptor.start();\n        }\n\n        // Setup navigation tracking\n        if (this.pluginConfig.trackPageViews !== false) {\n            this.setupNavigationTracking();\n        }\n\n        this.initCampaignParams();\n        this.onInitialized();\n\n        this.context.logger.info('Plugin initialized');\n    }\n\n    async cleanup(): Promise<void> {\n        this.onCleanup();\n\n        if (this.interceptor) {\n            this.interceptor.stop();\n            this.interceptor = undefined;\n        }\n\n        if (this.navigationCleanup) {\n            this.navigationCleanup();\n            this.navigationCleanup = undefined;\n        }\n\n        if (this.adapter) {\n            this.adapter.cleanup();\n            this.adapter = undefined;\n        }\n\n        this.recentEvents.clear();\n        for (const timer of this.dedupeTimers.values()) {\n            clearTimeout(timer);\n        }\n        this.dedupeTimers.clear();\n        this.context?.logger.info('Plugin cleaned up');\n        this.context = undefined;\n    }\n\n    /**\n     * Track an e-commerce event with deduplication\n     */\n    protected trackEvent(event: EcommerceEvent, properties: Record<string, any>): void {\n        if (!this.context) return;\n\n        // Deduplication: skip if same event fired recently (key by event + primary identifier)\n        const identifier = properties.product_id\n            || properties.order_id\n            || properties.url\n            || (Array.isArray(properties.items) ? `items:${properties.items.length}` : '');\n        const dedupeKey = `${event}:${identifier}`;\n        const dedupeWindow = this.pluginConfig.deduplicationWindow || DEFAULT_DEDUPLICATION_WINDOW;\n\n        if (this.recentEvents.has(dedupeKey)) {\n            this.context.logger.debug(`Deduplicating event: ${event}`);\n            return;\n        }\n\n        this.recentEvents.add(dedupeKey);\n        // 자동 만료: deduplicationWindow 후 자동 삭제\n        const timer = setTimeout(() => {\n            this.recentEvents.delete(dedupeKey);\n            this.dedupeTimers.delete(dedupeKey);\n        }, dedupeWindow);\n        this.dedupeTimers.set(dedupeKey, timer);\n\n        // Add global properties and platform metadata\n        const meta = this.adapter?.getPlatformMeta() || {};\n        const enrichedProperties = {\n            ...this.globalProperties,\n            ...properties,\n            platform: meta,\n        };\n\n        this.context.track(event, enrichedProperties);\n    }\n\n    /**\n     * Handle intercepted network request — override in subclass for specific behavior\n     */\n    protected handleNetworkRequest(_url: string, _method: string, _body?: any): void {\n        // Default: no-op, subclasses implement specific logic\n    }\n\n    /**\n     * Handle intercepted network response — override in subclass for specific behavior\n     */\n    protected handleNetworkResponse(_url: string, _status: number, _body?: any): void {\n        // Default: no-op, subclasses implement specific logic\n    }\n\n    /**\n     * Handle page navigation\n     */\n    protected handlePageNavigation(url: string): void {\n        if (!this.adapter || !this.context) return;\n\n        const pageType = this.adapter.detectPageType();\n\n        this.trackEvent(EcommerceEvent.PAGE_VIEWED, {\n            url,\n            page_type: pageType,\n            title: typeof document !== 'undefined' ? document.title : undefined,\n        });\n    }\n\n    private setupNavigationTracking(): void {\n        if (typeof window === 'undefined') return;\n\n        const handleNavigation = () => {\n            this.handlePageNavigation(window.location.href);\n        };\n\n        // Listen for History API changes\n        const originalPushState = history.pushState;\n        const originalReplaceState = history.replaceState;\n\n        history.pushState = function (...args) {\n            const result = originalPushState.apply(this, args);\n            try { handleNavigation(); } catch (_) { /* SDK 오류가 호스트 앱 라우팅에 영향 주지 않도록 */ }\n            return result;\n        };\n\n        history.replaceState = function (...args) {\n            const result = originalReplaceState.apply(this, args);\n            try { handleNavigation(); } catch (_) { /* SDK 오류가 호스트 앱 라우팅에 영향 주지 않도록 */ }\n            return result;\n        };\n\n        window.addEventListener('popstate', handleNavigation);\n\n        this.navigationCleanup = () => {\n            history.pushState = originalPushState;\n            history.replaceState = originalReplaceState;\n            window.removeEventListener('popstate', handleNavigation);\n        };\n\n        // Track initial page view\n        handleNavigation();\n    }\n\n    /**\n     * URL의 캠페인 파라미터(UTM + 광고 ID)를 수집하여 globalProperties에 설정.\n     * sessionStorage를 사용하여 MPA 페이지 전환 간에도 유지.\n     */\n    private initCampaignParams(): void {\n        if (typeof window === 'undefined') return;\n\n        const params = new URLSearchParams(window.location.search);\n\n        // URL에 캠페인 파라미터가 하나라도 있으면 새 캠페인 진입 — 기존 값 클리어 후 새로 저장\n        let hasUrlCampaign = false;\n        for (const param of CAMPAIGN_PARAMS) {\n            if (params.get(param)) {\n                hasUrlCampaign = true;\n                break;\n            }\n        }\n        if (hasUrlCampaign) {\n            for (const param of CAMPAIGN_PARAMS) {\n                try { sessionStorage.removeItem(CAMPAIGN_STORAGE_PREFIX + param); } catch {}\n            }\n        }\n\n        // URL에 캠페인 파라미터가 있으면 sessionStorage에 저장\n        for (const param of CAMPAIGN_PARAMS) {\n            const value = params.get(param);\n            if (value) {\n                try {\n                    sessionStorage.setItem(CAMPAIGN_STORAGE_PREFIX + param, value);\n                } catch {}\n            }\n        }\n\n        // sessionStorage에서 복원하여 globalProperties에 설정\n        for (const param of CAMPAIGN_PARAMS) {\n            try {\n                const stored = sessionStorage.getItem(CAMPAIGN_STORAGE_PREFIX + param);\n                if (stored) {\n                    this.globalProperties[param] = stored;\n                }\n            } catch {}\n        }\n    }\n\n    private getDefaultConfig(): EcommercePluginConfig {\n        return {\n            trackPageViews: true,\n            trackNetworkRequests: true,\n            trackDomInteractions: true,\n            deduplicationWindow: DEFAULT_DEDUPLICATION_WINDOW,\n            debug: false,\n        };\n    }\n}\n"]}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@vircle/plugin-ecommerce-core",
+  "version": "0.1.0",
+  "description": "Vircle SDK E-commerce Plugin Core - Base classes and utilities for commerce tracking plugins",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "vircle",
+    "analytics",
+    "ecommerce",
+    "plugin",
+    "tracking"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mass-adoption/vircle-sdk.git",
+    "directory": "packages/plugin-ecommerce-core"
+  },
+  "author": "Vircle <it@vircle.co.kr> (https://vircle.co.kr)",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@vircle/sdk-core-ts": "1.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "jsdom": "^26.1.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": {
+    "node": ">= 18.0.0"
+  },
+  "sideEffects": false,
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}