@suucha/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Suucha Studio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,83 @@
+# @suucha/core
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](../../LICENSE)
+
+Platform-agnostic core abstractions for the Suucha Web SDK. Defines reporter / interceptor / logger / storage / ad-manager interfaces and exposes the `suucha` singleton.
+
+This package has **no browser or Node.js dependencies** and can be reused by any platform (Web, React Native, mini-program).
+
+## Install
+
+```bash
+pnpm add @suucha/core
+# or
+npm install @suucha/core
+```
+
+## Quick Start
+
+```typescript
+import { suucha, LogLevel } from '@suucha/core';
+
+// Register a reporter (third-party implementation)
+class ConsoleReporter {
+  readonly name = 'console';
+  async logEvent(name: string, params: Record<string, any>) {
+    console.log('[event]', name, params);
+  }
+}
+
+suucha.addReporter(new ConsoleReporter());
+
+// Log events — anonymous_id is auto-attached
+suucha.log('page_view');
+suucha.log('add_to_cart', { item_id: 'sku_123', value: 99.9 });
+
+// Identify logged-in user — user_id is auto-attached on subsequent events
+suucha.identify('user_456');
+```
+
+## Key Concepts
+
+### Reporters
+Implement `ILogEventReporter` and register via `suucha.addReporter(...)`. Each reporter represents one third-party service (GA4, Sensors, etc.).
+
+### Interceptors
+- **Event interceptors** (`ILogEventIntercept`) can produce *new* events (e.g., event counting).
+- **Parameter interceptors** (`ILogEventParameterIntercept`) can modify event params (e.g., attribution, identity).
+
+Built-in:
+- `IdentityIntercept` — auto-attached, adds `anonymous_id` and `user_id`
+- `EventCounterIntercept` — count events, emit `event_NNN` at configured counts
+
+### Region Routing
+For domestic/overseas reporter switching:
+
+```typescript
+suucha.region.router((ctx) => {
+  if (ctx.host.endsWith('.cn')) return 'cn';
+  return 'global';
+});
+
+suucha.region.reporters({
+  cn:     [/* SensorsReporter */],
+  global: [/* GA4Reporter */],
+});
+```
+
+### Consent (Privacy)
+GDPR / PIPL compliance:
+
+```typescript
+suucha.setConsent(false);  // events buffer in memory
+// ... user grants consent ...
+suucha.setConsent(true);   // buffered events flush to reporters
+```
+
+## API
+
+See [`docs/api-draft.md`](../../docs/api-draft.md) for the full v1 API contract.
+
+## License
+
+MIT © Suucha Studio

package/dist/index.cjs

@@ -0,0 +1,292 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/types.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["Trace"] = 0] = "Trace";
+  LogLevel2[LogLevel2["Debug"] = 1] = "Debug";
+  LogLevel2[LogLevel2["Information"] = 2] = "Information";
+  LogLevel2[LogLevel2["Warning"] = 3] = "Warning";
+  LogLevel2[LogLevel2["Error"] = 4] = "Error";
+  LogLevel2[LogLevel2["Critical"] = 5] = "Critical";
+  LogLevel2[LogLevel2["None"] = 6] = "None";
+  return LogLevel2;
+})(LogLevel || {});
+
+// src/interceptors.ts
+var IdentityIntercept = class {
+  constructor(getAnonymousId, getUserId) {
+    __publicField(this, "getAnonymousId", getAnonymousId);
+    __publicField(this, "getUserId", getUserId);
+    __publicField(this, "name", "suucha-identity");
+    __publicField(this, "order", 100);
+  }
+  async execute(_eventName, params) {
+    const enriched = {
+      ...params,
+      anonymous_id: this.getAnonymousId()
+    };
+    const userId = this.getUserId();
+    if (userId) {
+      enriched.user_id = userId;
+    }
+    return enriched;
+  }
+};
+var EventCounterIntercept = class {
+  constructor(configurations) {
+    __publicField(this, "configurations", configurations);
+    __publicField(this, "name", "suucha-event-counter");
+    __publicField(this, "order", 200);
+    __publicField(this, "counts", /* @__PURE__ */ new Map());
+  }
+  async execute(eventName, params) {
+    const events = [];
+    for (const config of this.configurations) {
+      const isMatch = eventName === config.name || eventName.startsWith(`${config.name}_`);
+      if (!isMatch) continue;
+      const current = (this.counts.get(config.name) ?? 0) + 1;
+      this.counts.set(config.name, current);
+      if (config.counts.includes(current)) {
+        const padLength = config.padLength ?? 3;
+        const padded = String(current).padStart(padLength, "0");
+        events.push({
+          name: `${config.name}_${padded}`,
+          params: { ...params }
+        });
+      }
+    }
+    return { events };
+  }
+};
+
+// src/suucha.ts
+var DefaultLogger = class {
+  log(_level, _message, ..._args) {
+  }
+};
+var DEFAULT_REGION = "default";
+var Suucha = class {
+  constructor() {
+    __publicField(this, "reporters", /* @__PURE__ */ new Map());
+    __publicField(this, "eventIntercepts", []);
+    __publicField(this, "paramIntercepts", []);
+    __publicField(this, "logger", new DefaultLogger());
+    __publicField(this, "logLevel", 2 /* Information */);
+    __publicField(this, "anonymousId");
+    __publicField(this, "userId", null);
+    __publicField(this, "consent", true);
+    __publicField(this, "consentQueue", []);
+    __publicField(this, "regionFn");
+    __publicField(this, "regionReportersMap", {});
+    __publicField(this, "currentRegion", DEFAULT_REGION);
+    __publicField(this, "resolvedRegionReporters", []);
+    __publicField(this, "regionContext", null);
+    __publicField(this, "adManagerValue", null);
+    __publicField(this, "storageValue");
+    __publicField(this, "region");
+    this.anonymousId = this.generateAnonymousId();
+    this.paramIntercepts.push(
+      new IdentityIntercept(() => this.anonymousId, () => this.userId)
+    );
+    this.region = {
+      router: (fn) => {
+        this.regionFn = fn;
+        this.resolveRegion();
+      },
+      reporters: (map) => {
+        this.regionReportersMap = map;
+        this.resolveRegion();
+      },
+      getRegion: () => this.currentRegion,
+      getReporters: () => this.getActiveReporters()
+    };
+  }
+  // ===== 日志 =====
+  setLogLevel(level) {
+    this.logLevel = level;
+  }
+  getLogLevel() {
+    return this.logLevel;
+  }
+  setLogger(logger) {
+    this.logger = logger;
+  }
+  getLogger() {
+    return this.logger;
+  }
+  // ===== 埋点 =====
+  async log(eventName, params = {}) {
+    let enriched = { ...params };
+    for (const ic of this.paramIntercepts) {
+      enriched = await ic.execute(eventName, enriched);
+    }
+    const allEvents = [
+      { name: eventName, params: enriched }
+    ];
+    for (const ic of this.eventIntercepts) {
+      const result = await ic.execute(eventName, enriched);
+      if (result.events) {
+        allEvents.push(...result.events);
+      }
+    }
+    if (!this.consent) {
+      for (const ev of allEvents) {
+        this.consentQueue.push(ev);
+      }
+      return;
+    }
+    await this.dispatch(allEvents);
+  }
+  addReporter(reporter) {
+    this.reporters.set(reporter.name, reporter);
+  }
+  removeReporter(name) {
+    this.reporters.delete(name);
+  }
+  getReporters() {
+    return this.getActiveReporters();
+  }
+  // ===== 拦截器 =====
+  addEventIntercept(ic) {
+    this.eventIntercepts.push(ic);
+    this.eventIntercepts.sort((a, b) => a.order - b.order);
+  }
+  addParameterIntercept(ic) {
+    this.paramIntercepts.push(ic);
+    this.paramIntercepts.sort((a, b) => a.order - b.order);
+  }
+  removeIntercept(name) {
+    const ei = this.eventIntercepts.findIndex((x) => x.name === name);
+    if (ei >= 0) this.eventIntercepts.splice(ei, 1);
+    const pi = this.paramIntercepts.findIndex((x) => x.name === name);
+    if (pi >= 0) this.paramIntercepts.splice(pi, 1);
+  }
+  // ===== 用户身份 =====
+  identify(userId, traits) {
+    this.userId = userId;
+    if (traits) {
+      this.log("user_identify", { user_id: userId, ...traits }).catch(() => {
+      });
+    }
+  }
+  getAnonymousId() {
+    return this.anonymousId;
+  }
+  setAnonymousId(id) {
+    this.anonymousId = id;
+  }
+  getUserId() {
+    return this.userId;
+  }
+  reset() {
+    this.userId = null;
+    this.anonymousId = this.generateAnonymousId();
+  }
+  // ===== Consent =====
+  setConsent(granted) {
+    const wasGranted = this.consent;
+    this.consent = granted;
+    if (granted && !wasGranted) {
+      const queue = [...this.consentQueue];
+      this.consentQueue.length = 0;
+      for (const ev of queue) {
+        this.dispatch([ev]).catch(() => {
+        });
+      }
+    }
+  }
+  hasConsent() {
+    return this.consent;
+  }
+  // ===== Storage =====
+  setStorage(storage) {
+    this.storageValue = storage;
+  }
+  getStorage() {
+    return this.storageValue;
+  }
+  // ===== Region Context（由平台层调用） =====
+  /**
+   * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。
+   * 注入后会立即运行 router 函数确定 region。
+   */
+  setRegionContext(ctx) {
+    this.regionContext = ctx;
+    this.resolveRegion();
+  }
+  getRegionContext() {
+    return this.regionContext;
+  }
+  // ===== 广告 =====
+  enableAds(manager) {
+    this.adManagerValue = manager;
+    return manager;
+  }
+  getAdManager() {
+    return this.adManagerValue;
+  }
+  // ===== 内部方法 =====
+  getActiveReporters() {
+    if (this.resolvedRegionReporters.length > 0) {
+      return this.resolvedRegionReporters;
+    }
+    return [...this.reporters.values()];
+  }
+  resolveRegion() {
+    if (this.regionFn && this.regionContext) {
+      const newRegion = this.regionFn(this.regionContext);
+      if (newRegion !== this.currentRegion) {
+        this.currentRegion = newRegion;
+      }
+    }
+    const provider = this.regionReportersMap[this.currentRegion];
+    if (Array.isArray(provider)) {
+      this.resolvedRegionReporters = provider;
+    } else if (typeof provider === "function") {
+      this.resolvedRegionReporters = [];
+      provider().then((rs) => {
+        this.resolvedRegionReporters = rs;
+      }).catch((err) => {
+        this.logger.log(
+          3 /* Warning */,
+          `[Suucha] Failed to load reporters for region "${this.currentRegion}":`,
+          err
+        );
+      });
+    }
+  }
+  async dispatch(events) {
+    const reporters = this.getActiveReporters();
+    if (reporters.length === 0) return;
+    await Promise.all(
+      events.flatMap(
+        (ev) => reporters.map(
+          (r) => r.logEvent(ev.name, ev.params).catch((err) => {
+            this.logger.log(
+              4 /* Error */,
+              `[Suucha] Reporter "${r.name}" failed to log "${ev.name}":`,
+              err
+            );
+          })
+        )
+      )
+    );
+  }
+  generateAnonymousId() {
+    const rand = Math.random().toString(36).slice(2, 10);
+    return `anon_${Date.now().toString(36)}_${rand}`;
+  }
+};
+var suucha = new Suucha();
+
+exports.EventCounterIntercept = EventCounterIntercept;
+exports.IdentityIntercept = IdentityIntercept;
+exports.LogLevel = LogLevel;
+exports.Suucha = Suucha;
+exports.suucha = suucha;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/interceptors.ts","../src/suucha.ts"],"names":["LogLevel"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\r\n * @suucha/core - Type Definitions\r\n *\r\n * 平台无关的核心接口定义。\r\n * 此文件不依赖任何浏览器或 Node.js API，可被任何平台（Web、RN、小程序）复用。\r\n */\r\n\r\n// ===== 日志等级 =====\r\n\r\nexport enum LogLevel {\r\n  Trace = 0,\r\n  Debug = 1,\r\n  Information = 2,\r\n  Warning = 3,\r\n  Error = 4,\r\n  Critical = 5,\r\n  None = 6,\r\n}\r\n\r\n// ===== 日志事件相关 =====\r\n\r\nexport interface LogEvent {\r\n  name: string;\r\n  params: Record<string, any>;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * 日志事件上报器接口（第三方实现）\r\n *\r\n * 每个第三方服务（GA4、神策、Mixpanel 等）实现此接口，\r\n * 通过 `suucha.addReporter(...)` 或 `suucha.region.reporters(...)` 注册。\r\n */\r\nexport interface ILogEventReporter {\r\n  readonly name: string;\r\n  logEvent(name: string, params: Record<string, any>): Promise<void>;\r\n}\r\n\r\n/**\r\n * 事件拦截器：可产生新事件\r\n *\r\n * 用例：事件计数（spin 第 10 次自动产生 spin_010 事件）\r\n */\r\nexport interface ILogEventIntercept {\r\n  readonly name: string;\r\n  /** 越小越先执行 */\r\n  readonly order: number;\r\n  execute(\r\n    eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<{\r\n    events?: Array<{ name: string; params: Record<string, any> }>;\r\n  }>;\r\n}\r\n\r\n/**\r\n * 事件参数拦截器：可修改事件参数\r\n *\r\n * 用例：附加归因、用户身份、运行时长\r\n */\r\nexport interface ILogEventParameterIntercept {\r\n  readonly name: string;\r\n  /** 越小越先执行 */\r\n  readonly order: number;\r\n  execute(\r\n    eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<Record<string, any>>;\r\n}\r\n\r\n// ===== Logger =====\r\n\r\nexport interface ILogger {\r\n  log(level: LogLevel, message: string, ...args: any[]): void;\r\n}\r\n\r\n// ===== Storage =====\r\n\r\nexport interface IStorage {\r\n  get<T = any>(key: string): Promise<T | null>;\r\n  set<T = any>(key: string, value: T, ttl?: number): Promise<void>;\r\n  remove(key: string): Promise<void>;\r\n}\r\n\r\n// ===== 广告 =====\r\n\r\nexport interface AdSlotOptions {\r\n  container: string | HTMLElement;\r\n  slot?: string;\r\n  format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';\r\n  responsive?: boolean;\r\n}\r\n\r\nexport interface AdSlotHandle {\r\n  readonly id: string;\r\n  readonly slot: string;\r\n  destroy(): void;\r\n}\r\n\r\nexport interface IAdManager {\r\n  mountSlot(options: AdSlotOptions): Promise<AdSlotHandle>;\r\n  unmountSlot(handle: AdSlotHandle): void;\r\n  refresh?(handle: AdSlotHandle): void;\r\n}\r\n\r\n// ===== Consent =====\r\n\r\nexport interface IConsentManager {\r\n  hasConsent(): boolean;\r\n  onConsentChange(cb: (granted: boolean) => void): () => void;\r\n}\r\n\r\n// ===== Region 路由 =====\r\n\r\nexport interface RegionContext {\r\n  host: string;\r\n  pathname: string;\r\n  timezone: string;\r\n  language: string;\r\n  url: string;\r\n}\r\n\r\nexport type ReporterProvider = ILogEventReporter[] | (() => Promise<ILogEventReporter[]>);\r\n\r\nexport interface RegionRouter {\r\n  router(fn: (ctx: RegionContext) => string): void;\r\n  reporters(map: Record<string, ReporterProvider>): void;\r\n  getRegion(): string;\r\n  getReporters(): ILogEventReporter[];\r\n}\r\n","/**\r\n * @suucha/core - 内置拦截器\r\n */\r\n\r\nimport type {\r\n  ILogEventIntercept,\r\n  ILogEventParameterIntercept,\r\n} from './types.js';\r\n\r\n/**\r\n * 事件计数配置\r\n */\r\nexport interface EventCounterConfiguration {\r\n  /** 事件名或前缀 */\r\n  name: string;\r\n  /** 触发的次数列表 */\r\n  counts: number[];\r\n  /** 名称补 0 长度，默认 3 */\r\n  padLength?: number;\r\n}\r\n\r\n/**\r\n * 用户身份拦截器（自动启用）\r\n * 给每个事件附加 anonymous_id 和（如果已 identify）user_id\r\n */\r\nexport class IdentityIntercept implements ILogEventParameterIntercept {\r\n  readonly name = 'suucha-identity';\r\n  readonly order = 100;\r\n\r\n  constructor(\r\n    private readonly getAnonymousId: () => string,\r\n    private readonly getUserId: () => string | null,\r\n  ) {}\r\n\r\n  async execute(\r\n    _eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<Record<string, any>> {\r\n    const enriched: Record<string, any> = {\r\n      ...params,\r\n      anonymous_id: this.getAnonymousId(),\r\n    };\r\n    const userId = this.getUserId();\r\n    if (userId) {\r\n      enriched.user_id = userId;\r\n    }\r\n    return enriched;\r\n  }\r\n}\r\n\r\n/**\r\n * 事件计数拦截器\r\n *\r\n * 在配置的事件达到指定次数时，产生新事件（名称格式 {eventName}_{paddedCount}）\r\n */\r\nexport class EventCounterIntercept implements ILogEventIntercept {\r\n  readonly name = 'suucha-event-counter';\r\n  readonly order = 200;\r\n\r\n  private readonly counts = new Map<string, number>();\r\n\r\n  constructor(private readonly configurations: EventCounterConfiguration[]) {}\r\n\r\n  async execute(eventName: string, params: Record<string, any>) {\r\n    const events: Array<{ name: string; params: Record<string, any> }> = [];\r\n\r\n    for (const config of this.configurations) {\r\n      const isMatch =\r\n        eventName === config.name || eventName.startsWith(`${config.name}_`);\r\n      if (!isMatch) continue;\r\n\r\n      const current = (this.counts.get(config.name) ?? 0) + 1;\r\n      this.counts.set(config.name, current);\r\n\r\n      if (config.counts.includes(current)) {\r\n        const padLength = config.padLength ?? 3;\r\n        const padded = String(current).padStart(padLength, '0');\r\n        events.push({\r\n          name: `${config.name}_${padded}`,\r\n          params: { ...params },\r\n        });\r\n      }\r\n    }\r\n\r\n    return { events };\r\n  }\r\n}\r\n","/**\r\n * @suucha/core - Suucha 主类与单例\r\n */\r\n\r\nimport {\r\n  IdentityIntercept,\r\n} from './interceptors.js';\r\nimport { LogLevel } from './types.js';\r\nimport type {\r\n  ILogEventIntercept,\r\n  ILogEventParameterIntercept,\r\n  ILogEventReporter,\r\n  ILogger,\r\n  IStorage,\r\n  IAdManager,\r\n  RegionContext,\r\n  RegionRouter,\r\n  ReporterProvider,\r\n} from './types.js';\r\n\r\n/**\r\n * 默认 no-op logger，未配置 logger 时使用\r\n */\r\nclass DefaultLogger implements ILogger {\r\n  log(_level: LogLevel, _message: string, ..._args: any[]): void {\r\n    // no-op\r\n  }\r\n}\r\n\r\nconst DEFAULT_REGION = 'default';\r\n\r\nexport class Suucha {\r\n  private readonly reporters = new Map<string, ILogEventReporter>();\r\n  private readonly eventIntercepts: ILogEventIntercept[] = [];\r\n  private readonly paramIntercepts: ILogEventParameterIntercept[] = [];\r\n  private logger: ILogger = new DefaultLogger();\r\n  private logLevel: LogLevel = LogLevel.Information;\r\n  private anonymousId: string;\r\n  private userId: string | null = null;\r\n  private consent = true;\r\n  private readonly consentQueue: Array<{ name: string; params: Record<string, any> }> = [];\r\n  private regionFn?: (ctx: RegionContext) => string;\r\n  private regionReportersMap: Record<string, ReporterProvider> = {};\r\n  private currentRegion = DEFAULT_REGION;\r\n  private resolvedRegionReporters: ILogEventReporter[] = [];\r\n  private regionContext: RegionContext | null = null;\r\n  private adManagerValue: IAdManager | null = null;\r\n  private storageValue?: IStorage;\r\n\r\n  readonly region: RegionRouter;\r\n\r\n  constructor() {\r\n    this.anonymousId = this.generateAnonymousId();\r\n    this.paramIntercepts.push(\r\n      new IdentityIntercept(() => this.anonymousId, () => this.userId),\r\n    );\r\n\r\n    this.region = {\r\n      router: (fn) => {\r\n        this.regionFn = fn;\r\n        this.resolveRegion();\r\n      },\r\n      reporters: (map) => {\r\n        this.regionReportersMap = map;\r\n        this.resolveRegion();\r\n      },\r\n      getRegion: () => this.currentRegion,\r\n      getReporters: () => this.getActiveReporters(),\r\n    };\r\n  }\r\n\r\n  // ===== 日志 =====\r\n\r\n  setLogLevel(level: LogLevel): void {\r\n    this.logLevel = level;\r\n  }\r\n\r\n  getLogLevel(): LogLevel {\r\n    return this.logLevel;\r\n  }\r\n\r\n  setLogger(logger: ILogger): void {\r\n    this.logger = logger;\r\n  }\r\n\r\n  getLogger(): ILogger {\r\n    return this.logger;\r\n  }\r\n\r\n  // ===== 埋点 =====\r\n\r\n  async log(eventName: string, params: Record<string, any> = {}): Promise<void> {\r\n    // 1. 参数拦截器链\r\n    let enriched = { ...params };\r\n    for (const ic of this.paramIntercepts) {\r\n      enriched = await ic.execute(eventName, enriched);\r\n    }\r\n\r\n    // 2. 事件拦截器链（可产生新事件）\r\n    const allEvents: Array<{ name: string; params: Record<string, any> }> = [\r\n      { name: eventName, params: enriched },\r\n    ];\r\n    for (const ic of this.eventIntercepts) {\r\n      const result = await ic.execute(eventName, enriched);\r\n      if (result.events) {\r\n        allEvents.push(...result.events);\r\n      }\r\n    }\r\n\r\n    // 3. Consent 检查：未同意则入队，不外发\r\n    if (!this.consent) {\r\n      for (const ev of allEvents) {\r\n        this.consentQueue.push(ev);\r\n      }\r\n      return;\r\n    }\r\n\r\n    // 4. 分发到 reporters\r\n    await this.dispatch(allEvents);\r\n  }\r\n\r\n  addReporter(reporter: ILogEventReporter): void {\r\n    this.reporters.set(reporter.name, reporter);\r\n  }\r\n\r\n  removeReporter(name: string): void {\r\n    this.reporters.delete(name);\r\n  }\r\n\r\n  getReporters(): ILogEventReporter[] {\r\n    return this.getActiveReporters();\r\n  }\r\n\r\n  // ===== 拦截器 =====\r\n\r\n  addEventIntercept(ic: ILogEventIntercept): void {\r\n    this.eventIntercepts.push(ic);\r\n    this.eventIntercepts.sort((a, b) => a.order - b.order);\r\n  }\r\n\r\n  addParameterIntercept(ic: ILogEventParameterIntercept): void {\r\n    this.paramIntercepts.push(ic);\r\n    this.paramIntercepts.sort((a, b) => a.order - b.order);\r\n  }\r\n\r\n  removeIntercept(name: string): void {\r\n    const ei = this.eventIntercepts.findIndex((x) => x.name === name);\r\n    if (ei >= 0) this.eventIntercepts.splice(ei, 1);\r\n    const pi = this.paramIntercepts.findIndex((x) => x.name === name);\r\n    if (pi >= 0) this.paramIntercepts.splice(pi, 1);\r\n  }\r\n\r\n  // ===== 用户身份 =====\r\n\r\n  identify(userId: string, traits?: Record<string, any>): void {\r\n    this.userId = userId;\r\n    if (traits) {\r\n      this.log('user_identify', { user_id: userId, ...traits }).catch(() => {});\r\n    }\r\n  }\r\n\r\n  getAnonymousId(): string {\r\n    return this.anonymousId;\r\n  }\r\n\r\n  setAnonymousId(id: string): void {\r\n    this.anonymousId = id;\r\n  }\r\n\r\n  getUserId(): string | null {\r\n    return this.userId;\r\n  }\r\n\r\n  reset(): void {\r\n    this.userId = null;\r\n    this.anonymousId = this.generateAnonymousId();\r\n  }\r\n\r\n  // ===== Consent =====\r\n\r\n  setConsent(granted: boolean): void {\r\n    const wasGranted = this.consent;\r\n    this.consent = granted;\r\n    if (granted && !wasGranted) {\r\n      // flush 队列\r\n      const queue = [...this.consentQueue];\r\n      this.consentQueue.length = 0;\r\n      for (const ev of queue) {\r\n        this.dispatch([ev]).catch(() => {});\r\n      }\r\n    }\r\n  }\r\n\r\n  hasConsent(): boolean {\r\n    return this.consent;\r\n  }\r\n\r\n  // ===== Storage =====\r\n\r\n  setStorage(storage: IStorage): void {\r\n    this.storageValue = storage;\r\n  }\r\n\r\n  getStorage(): IStorage | undefined {\r\n    return this.storageValue;\r\n  }\r\n\r\n  // ===== Region Context（由平台层调用） =====\r\n\r\n  /**\r\n   * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。\r\n   * 注入后会立即运行 router 函数确定 region。\r\n   */\r\n  setRegionContext(ctx: RegionContext): void {\r\n    this.regionContext = ctx;\r\n    this.resolveRegion();\r\n  }\r\n\r\n  getRegionContext(): RegionContext | null {\r\n    return this.regionContext;\r\n  }\r\n\r\n  // ===== 广告 =====\r\n\r\n  enableAds(manager: IAdManager): IAdManager {\r\n    this.adManagerValue = manager;\r\n    return manager;\r\n  }\r\n\r\n  getAdManager(): IAdManager | null {\r\n    return this.adManagerValue;\r\n  }\r\n\r\n  // ===== 内部方法 =====\r\n\r\n  private getActiveReporters(): ILogEventReporter[] {\r\n    if (this.resolvedRegionReporters.length > 0) {\r\n      return this.resolvedRegionReporters;\r\n    }\r\n    return [...this.reporters.values()];\r\n  }\r\n\r\n  private resolveRegion(): void {\r\n    if (this.regionFn && this.regionContext) {\r\n      const newRegion = this.regionFn(this.regionContext);\r\n      if (newRegion !== this.currentRegion) {\r\n        this.currentRegion = newRegion;\r\n      }\r\n    }\r\n\r\n    const provider = this.regionReportersMap[this.currentRegion];\r\n    if (Array.isArray(provider)) {\r\n      this.resolvedRegionReporters = provider;\r\n    } else if (typeof provider === 'function') {\r\n      // 异步加载，先置空避免发送到错误 region\r\n      this.resolvedRegionReporters = [];\r\n      provider()\r\n        .then((rs) => {\r\n          this.resolvedRegionReporters = rs;\r\n        })\r\n        .catch((err) => {\r\n          this.logger.log(\r\n            LogLevel.Warning,\r\n            `[Suucha] Failed to load reporters for region \"${this.currentRegion}\":`,\r\n            err,\r\n          );\r\n        });\r\n    }\r\n    // 没有 provider 时保持现有 reporters（直接 addReporter 注册的）\r\n  }\r\n\r\n  private async dispatch(\r\n    events: Array<{ name: string; params: Record<string, any> }>,\r\n  ): Promise<void> {\r\n    const reporters = this.getActiveReporters();\r\n    if (reporters.length === 0) return;\r\n\r\n    await Promise.all(\r\n      events.flatMap((ev) =>\r\n        reporters.map((r) =>\r\n          r.logEvent(ev.name, ev.params).catch((err) => {\r\n            this.logger.log(\r\n              LogLevel.Error,\r\n              `[Suucha] Reporter \"${r.name}\" failed to log \"${ev.name}\":`,\r\n              err,\r\n            );\r\n          }),\r\n        ),\r\n      ),\r\n    );\r\n  }\r\n\r\n  private generateAnonymousId(): string {\r\n    const rand = Math.random().toString(36).slice(2, 10);\r\n    return `anon_${Date.now().toString(36)}_${rand}`;\r\n  }\r\n}\r\n\r\n/**\r\n * Suucha 全局单例\r\n */\r\nexport const suucha = new Suucha();\r\n"]}

package/dist/index.d.cts

@@ -0,0 +1,208 @@
+/**
+ * @suucha/core - Type Definitions
+ *
+ * 平台无关的核心接口定义。
+ * 此文件不依赖任何浏览器或 Node.js API，可被任何平台（Web、RN、小程序）复用。
+ */
+declare enum LogLevel {
+    Trace = 0,
+    Debug = 1,
+    Information = 2,
+    Warning = 3,
+    Error = 4,
+    Critical = 5,
+    None = 6
+}
+interface LogEvent {
+    name: string;
+    params: Record<string, any>;
+    timestamp: number;
+}
+/**
+ * 日志事件上报器接口（第三方实现）
+ *
+ * 每个第三方服务（GA4、神策、Mixpanel 等）实现此接口，
+ * 通过 `suucha.addReporter(...)` 或 `suucha.region.reporters(...)` 注册。
+ */
+interface ILogEventReporter {
+    readonly name: string;
+    logEvent(name: string, params: Record<string, any>): Promise<void>;
+}
+/**
+ * 事件拦截器：可产生新事件
+ *
+ * 用例：事件计数（spin 第 10 次自动产生 spin_010 事件）
+ */
+interface ILogEventIntercept {
+    readonly name: string;
+    /** 越小越先执行 */
+    readonly order: number;
+    execute(eventName: string, params: Record<string, any>): Promise<{
+        events?: Array<{
+            name: string;
+            params: Record<string, any>;
+        }>;
+    }>;
+}
+/**
+ * 事件参数拦截器：可修改事件参数
+ *
+ * 用例：附加归因、用户身份、运行时长
+ */
+interface ILogEventParameterIntercept {
+    readonly name: string;
+    /** 越小越先执行 */
+    readonly order: number;
+    execute(eventName: string, params: Record<string, any>): Promise<Record<string, any>>;
+}
+interface ILogger {
+    log(level: LogLevel, message: string, ...args: any[]): void;
+}
+interface IStorage {
+    get<T = any>(key: string): Promise<T | null>;
+    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+interface AdSlotOptions {
+    container: string | HTMLElement;
+    slot?: string;
+    format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';
+    responsive?: boolean;
+}
+interface AdSlotHandle {
+    readonly id: string;
+    readonly slot: string;
+    destroy(): void;
+}
+interface IAdManager {
+    mountSlot(options: AdSlotOptions): Promise<AdSlotHandle>;
+    unmountSlot(handle: AdSlotHandle): void;
+    refresh?(handle: AdSlotHandle): void;
+}
+interface IConsentManager {
+    hasConsent(): boolean;
+    onConsentChange(cb: (granted: boolean) => void): () => void;
+}
+interface RegionContext {
+    host: string;
+    pathname: string;
+    timezone: string;
+    language: string;
+    url: string;
+}
+type ReporterProvider = ILogEventReporter[] | (() => Promise<ILogEventReporter[]>);
+interface RegionRouter {
+    router(fn: (ctx: RegionContext) => string): void;
+    reporters(map: Record<string, ReporterProvider>): void;
+    getRegion(): string;
+    getReporters(): ILogEventReporter[];
+}
+
+/**
+ * @suucha/core - 内置拦截器
+ */
+
+/**
+ * 事件计数配置
+ */
+interface EventCounterConfiguration {
+    /** 事件名或前缀 */
+    name: string;
+    /** 触发的次数列表 */
+    counts: number[];
+    /** 名称补 0 长度，默认 3 */
+    padLength?: number;
+}
+/**
+ * 用户身份拦截器（自动启用）
+ * 给每个事件附加 anonymous_id 和（如果已 identify）user_id
+ */
+declare class IdentityIntercept implements ILogEventParameterIntercept {
+    private readonly getAnonymousId;
+    private readonly getUserId;
+    readonly name = "suucha-identity";
+    readonly order = 100;
+    constructor(getAnonymousId: () => string, getUserId: () => string | null);
+    execute(_eventName: string, params: Record<string, any>): Promise<Record<string, any>>;
+}
+/**
+ * 事件计数拦截器
+ *
+ * 在配置的事件达到指定次数时，产生新事件（名称格式 {eventName}_{paddedCount}）
+ */
+declare class EventCounterIntercept implements ILogEventIntercept {
+    private readonly configurations;
+    readonly name = "suucha-event-counter";
+    readonly order = 200;
+    private readonly counts;
+    constructor(configurations: EventCounterConfiguration[]);
+    execute(eventName: string, params: Record<string, any>): Promise<{
+        events: {
+            name: string;
+            params: Record<string, any>;
+        }[];
+    }>;
+}
+
+/**
+ * @suucha/core - Suucha 主类与单例
+ */
+
+declare class Suucha {
+    private readonly reporters;
+    private readonly eventIntercepts;
+    private readonly paramIntercepts;
+    private logger;
+    private logLevel;
+    private anonymousId;
+    private userId;
+    private consent;
+    private readonly consentQueue;
+    private regionFn?;
+    private regionReportersMap;
+    private currentRegion;
+    private resolvedRegionReporters;
+    private regionContext;
+    private adManagerValue;
+    private storageValue?;
+    readonly region: RegionRouter;
+    constructor();
+    setLogLevel(level: LogLevel): void;
+    getLogLevel(): LogLevel;
+    setLogger(logger: ILogger): void;
+    getLogger(): ILogger;
+    log(eventName: string, params?: Record<string, any>): Promise<void>;
+    addReporter(reporter: ILogEventReporter): void;
+    removeReporter(name: string): void;
+    getReporters(): ILogEventReporter[];
+    addEventIntercept(ic: ILogEventIntercept): void;
+    addParameterIntercept(ic: ILogEventParameterIntercept): void;
+    removeIntercept(name: string): void;
+    identify(userId: string, traits?: Record<string, any>): void;
+    getAnonymousId(): string;
+    setAnonymousId(id: string): void;
+    getUserId(): string | null;
+    reset(): void;
+    setConsent(granted: boolean): void;
+    hasConsent(): boolean;
+    setStorage(storage: IStorage): void;
+    getStorage(): IStorage | undefined;
+    /**
+     * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。
+     * 注入后会立即运行 router 函数确定 region。
+     */
+    setRegionContext(ctx: RegionContext): void;
+    getRegionContext(): RegionContext | null;
+    enableAds(manager: IAdManager): IAdManager;
+    getAdManager(): IAdManager | null;
+    private getActiveReporters;
+    private resolveRegion;
+    private dispatch;
+    private generateAnonymousId;
+}
+/**
+ * Suucha 全局单例
+ */
+declare const suucha: Suucha;
+
+export { type AdSlotHandle, type AdSlotOptions, type EventCounterConfiguration, EventCounterIntercept, type IAdManager, type IConsentManager, type ILogEventIntercept, type ILogEventParameterIntercept, type ILogEventReporter, type ILogger, type IStorage, IdentityIntercept, type LogEvent, LogLevel, type RegionContext, type RegionRouter, type ReporterProvider, Suucha, suucha };

package/dist/index.d.ts

@@ -0,0 +1,208 @@
+/**
+ * @suucha/core - Type Definitions
+ *
+ * 平台无关的核心接口定义。
+ * 此文件不依赖任何浏览器或 Node.js API，可被任何平台（Web、RN、小程序）复用。
+ */
+declare enum LogLevel {
+    Trace = 0,
+    Debug = 1,
+    Information = 2,
+    Warning = 3,
+    Error = 4,
+    Critical = 5,
+    None = 6
+}
+interface LogEvent {
+    name: string;
+    params: Record<string, any>;
+    timestamp: number;
+}
+/**
+ * 日志事件上报器接口（第三方实现）
+ *
+ * 每个第三方服务（GA4、神策、Mixpanel 等）实现此接口，
+ * 通过 `suucha.addReporter(...)` 或 `suucha.region.reporters(...)` 注册。
+ */
+interface ILogEventReporter {
+    readonly name: string;
+    logEvent(name: string, params: Record<string, any>): Promise<void>;
+}
+/**
+ * 事件拦截器：可产生新事件
+ *
+ * 用例：事件计数（spin 第 10 次自动产生 spin_010 事件）
+ */
+interface ILogEventIntercept {
+    readonly name: string;
+    /** 越小越先执行 */
+    readonly order: number;
+    execute(eventName: string, params: Record<string, any>): Promise<{
+        events?: Array<{
+            name: string;
+            params: Record<string, any>;
+        }>;
+    }>;
+}
+/**
+ * 事件参数拦截器：可修改事件参数
+ *
+ * 用例：附加归因、用户身份、运行时长
+ */
+interface ILogEventParameterIntercept {
+    readonly name: string;
+    /** 越小越先执行 */
+    readonly order: number;
+    execute(eventName: string, params: Record<string, any>): Promise<Record<string, any>>;
+}
+interface ILogger {
+    log(level: LogLevel, message: string, ...args: any[]): void;
+}
+interface IStorage {
+    get<T = any>(key: string): Promise<T | null>;
+    set<T = any>(key: string, value: T, ttl?: number): Promise<void>;
+    remove(key: string): Promise<void>;
+}
+interface AdSlotOptions {
+    container: string | HTMLElement;
+    slot?: string;
+    format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';
+    responsive?: boolean;
+}
+interface AdSlotHandle {
+    readonly id: string;
+    readonly slot: string;
+    destroy(): void;
+}
+interface IAdManager {
+    mountSlot(options: AdSlotOptions): Promise<AdSlotHandle>;
+    unmountSlot(handle: AdSlotHandle): void;
+    refresh?(handle: AdSlotHandle): void;
+}
+interface IConsentManager {
+    hasConsent(): boolean;
+    onConsentChange(cb: (granted: boolean) => void): () => void;
+}
+interface RegionContext {
+    host: string;
+    pathname: string;
+    timezone: string;
+    language: string;
+    url: string;
+}
+type ReporterProvider = ILogEventReporter[] | (() => Promise<ILogEventReporter[]>);
+interface RegionRouter {
+    router(fn: (ctx: RegionContext) => string): void;
+    reporters(map: Record<string, ReporterProvider>): void;
+    getRegion(): string;
+    getReporters(): ILogEventReporter[];
+}
+
+/**
+ * @suucha/core - 内置拦截器
+ */
+
+/**
+ * 事件计数配置
+ */
+interface EventCounterConfiguration {
+    /** 事件名或前缀 */
+    name: string;
+    /** 触发的次数列表 */
+    counts: number[];
+    /** 名称补 0 长度，默认 3 */
+    padLength?: number;
+}
+/**
+ * 用户身份拦截器（自动启用）
+ * 给每个事件附加 anonymous_id 和（如果已 identify）user_id
+ */
+declare class IdentityIntercept implements ILogEventParameterIntercept {
+    private readonly getAnonymousId;
+    private readonly getUserId;
+    readonly name = "suucha-identity";
+    readonly order = 100;
+    constructor(getAnonymousId: () => string, getUserId: () => string | null);
+    execute(_eventName: string, params: Record<string, any>): Promise<Record<string, any>>;
+}
+/**
+ * 事件计数拦截器
+ *
+ * 在配置的事件达到指定次数时，产生新事件（名称格式 {eventName}_{paddedCount}）
+ */
+declare class EventCounterIntercept implements ILogEventIntercept {
+    private readonly configurations;
+    readonly name = "suucha-event-counter";
+    readonly order = 200;
+    private readonly counts;
+    constructor(configurations: EventCounterConfiguration[]);
+    execute(eventName: string, params: Record<string, any>): Promise<{
+        events: {
+            name: string;
+            params: Record<string, any>;
+        }[];
+    }>;
+}
+
+/**
+ * @suucha/core - Suucha 主类与单例
+ */
+
+declare class Suucha {
+    private readonly reporters;
+    private readonly eventIntercepts;
+    private readonly paramIntercepts;
+    private logger;
+    private logLevel;
+    private anonymousId;
+    private userId;
+    private consent;
+    private readonly consentQueue;
+    private regionFn?;
+    private regionReportersMap;
+    private currentRegion;
+    private resolvedRegionReporters;
+    private regionContext;
+    private adManagerValue;
+    private storageValue?;
+    readonly region: RegionRouter;
+    constructor();
+    setLogLevel(level: LogLevel): void;
+    getLogLevel(): LogLevel;
+    setLogger(logger: ILogger): void;
+    getLogger(): ILogger;
+    log(eventName: string, params?: Record<string, any>): Promise<void>;
+    addReporter(reporter: ILogEventReporter): void;
+    removeReporter(name: string): void;
+    getReporters(): ILogEventReporter[];
+    addEventIntercept(ic: ILogEventIntercept): void;
+    addParameterIntercept(ic: ILogEventParameterIntercept): void;
+    removeIntercept(name: string): void;
+    identify(userId: string, traits?: Record<string, any>): void;
+    getAnonymousId(): string;
+    setAnonymousId(id: string): void;
+    getUserId(): string | null;
+    reset(): void;
+    setConsent(granted: boolean): void;
+    hasConsent(): boolean;
+    setStorage(storage: IStorage): void;
+    getStorage(): IStorage | undefined;
+    /**
+     * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。
+     * 注入后会立即运行 router 函数确定 region。
+     */
+    setRegionContext(ctx: RegionContext): void;
+    getRegionContext(): RegionContext | null;
+    enableAds(manager: IAdManager): IAdManager;
+    getAdManager(): IAdManager | null;
+    private getActiveReporters;
+    private resolveRegion;
+    private dispatch;
+    private generateAnonymousId;
+}
+/**
+ * Suucha 全局单例
+ */
+declare const suucha: Suucha;
+
+export { type AdSlotHandle, type AdSlotOptions, type EventCounterConfiguration, EventCounterIntercept, type IAdManager, type IConsentManager, type ILogEventIntercept, type ILogEventParameterIntercept, type ILogEventReporter, type ILogger, type IStorage, IdentityIntercept, type LogEvent, LogLevel, type RegionContext, type RegionRouter, type ReporterProvider, Suucha, suucha };

package/dist/index.js

@@ -0,0 +1,286 @@
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+// src/types.ts
+var LogLevel = /* @__PURE__ */ ((LogLevel2) => {
+  LogLevel2[LogLevel2["Trace"] = 0] = "Trace";
+  LogLevel2[LogLevel2["Debug"] = 1] = "Debug";
+  LogLevel2[LogLevel2["Information"] = 2] = "Information";
+  LogLevel2[LogLevel2["Warning"] = 3] = "Warning";
+  LogLevel2[LogLevel2["Error"] = 4] = "Error";
+  LogLevel2[LogLevel2["Critical"] = 5] = "Critical";
+  LogLevel2[LogLevel2["None"] = 6] = "None";
+  return LogLevel2;
+})(LogLevel || {});
+
+// src/interceptors.ts
+var IdentityIntercept = class {
+  constructor(getAnonymousId, getUserId) {
+    __publicField(this, "getAnonymousId", getAnonymousId);
+    __publicField(this, "getUserId", getUserId);
+    __publicField(this, "name", "suucha-identity");
+    __publicField(this, "order", 100);
+  }
+  async execute(_eventName, params) {
+    const enriched = {
+      ...params,
+      anonymous_id: this.getAnonymousId()
+    };
+    const userId = this.getUserId();
+    if (userId) {
+      enriched.user_id = userId;
+    }
+    return enriched;
+  }
+};
+var EventCounterIntercept = class {
+  constructor(configurations) {
+    __publicField(this, "configurations", configurations);
+    __publicField(this, "name", "suucha-event-counter");
+    __publicField(this, "order", 200);
+    __publicField(this, "counts", /* @__PURE__ */ new Map());
+  }
+  async execute(eventName, params) {
+    const events = [];
+    for (const config of this.configurations) {
+      const isMatch = eventName === config.name || eventName.startsWith(`${config.name}_`);
+      if (!isMatch) continue;
+      const current = (this.counts.get(config.name) ?? 0) + 1;
+      this.counts.set(config.name, current);
+      if (config.counts.includes(current)) {
+        const padLength = config.padLength ?? 3;
+        const padded = String(current).padStart(padLength, "0");
+        events.push({
+          name: `${config.name}_${padded}`,
+          params: { ...params }
+        });
+      }
+    }
+    return { events };
+  }
+};
+
+// src/suucha.ts
+var DefaultLogger = class {
+  log(_level, _message, ..._args) {
+  }
+};
+var DEFAULT_REGION = "default";
+var Suucha = class {
+  constructor() {
+    __publicField(this, "reporters", /* @__PURE__ */ new Map());
+    __publicField(this, "eventIntercepts", []);
+    __publicField(this, "paramIntercepts", []);
+    __publicField(this, "logger", new DefaultLogger());
+    __publicField(this, "logLevel", 2 /* Information */);
+    __publicField(this, "anonymousId");
+    __publicField(this, "userId", null);
+    __publicField(this, "consent", true);
+    __publicField(this, "consentQueue", []);
+    __publicField(this, "regionFn");
+    __publicField(this, "regionReportersMap", {});
+    __publicField(this, "currentRegion", DEFAULT_REGION);
+    __publicField(this, "resolvedRegionReporters", []);
+    __publicField(this, "regionContext", null);
+    __publicField(this, "adManagerValue", null);
+    __publicField(this, "storageValue");
+    __publicField(this, "region");
+    this.anonymousId = this.generateAnonymousId();
+    this.paramIntercepts.push(
+      new IdentityIntercept(() => this.anonymousId, () => this.userId)
+    );
+    this.region = {
+      router: (fn) => {
+        this.regionFn = fn;
+        this.resolveRegion();
+      },
+      reporters: (map) => {
+        this.regionReportersMap = map;
+        this.resolveRegion();
+      },
+      getRegion: () => this.currentRegion,
+      getReporters: () => this.getActiveReporters()
+    };
+  }
+  // ===== 日志 =====
+  setLogLevel(level) {
+    this.logLevel = level;
+  }
+  getLogLevel() {
+    return this.logLevel;
+  }
+  setLogger(logger) {
+    this.logger = logger;
+  }
+  getLogger() {
+    return this.logger;
+  }
+  // ===== 埋点 =====
+  async log(eventName, params = {}) {
+    let enriched = { ...params };
+    for (const ic of this.paramIntercepts) {
+      enriched = await ic.execute(eventName, enriched);
+    }
+    const allEvents = [
+      { name: eventName, params: enriched }
+    ];
+    for (const ic of this.eventIntercepts) {
+      const result = await ic.execute(eventName, enriched);
+      if (result.events) {
+        allEvents.push(...result.events);
+      }
+    }
+    if (!this.consent) {
+      for (const ev of allEvents) {
+        this.consentQueue.push(ev);
+      }
+      return;
+    }
+    await this.dispatch(allEvents);
+  }
+  addReporter(reporter) {
+    this.reporters.set(reporter.name, reporter);
+  }
+  removeReporter(name) {
+    this.reporters.delete(name);
+  }
+  getReporters() {
+    return this.getActiveReporters();
+  }
+  // ===== 拦截器 =====
+  addEventIntercept(ic) {
+    this.eventIntercepts.push(ic);
+    this.eventIntercepts.sort((a, b) => a.order - b.order);
+  }
+  addParameterIntercept(ic) {
+    this.paramIntercepts.push(ic);
+    this.paramIntercepts.sort((a, b) => a.order - b.order);
+  }
+  removeIntercept(name) {
+    const ei = this.eventIntercepts.findIndex((x) => x.name === name);
+    if (ei >= 0) this.eventIntercepts.splice(ei, 1);
+    const pi = this.paramIntercepts.findIndex((x) => x.name === name);
+    if (pi >= 0) this.paramIntercepts.splice(pi, 1);
+  }
+  // ===== 用户身份 =====
+  identify(userId, traits) {
+    this.userId = userId;
+    if (traits) {
+      this.log("user_identify", { user_id: userId, ...traits }).catch(() => {
+      });
+    }
+  }
+  getAnonymousId() {
+    return this.anonymousId;
+  }
+  setAnonymousId(id) {
+    this.anonymousId = id;
+  }
+  getUserId() {
+    return this.userId;
+  }
+  reset() {
+    this.userId = null;
+    this.anonymousId = this.generateAnonymousId();
+  }
+  // ===== Consent =====
+  setConsent(granted) {
+    const wasGranted = this.consent;
+    this.consent = granted;
+    if (granted && !wasGranted) {
+      const queue = [...this.consentQueue];
+      this.consentQueue.length = 0;
+      for (const ev of queue) {
+        this.dispatch([ev]).catch(() => {
+        });
+      }
+    }
+  }
+  hasConsent() {
+    return this.consent;
+  }
+  // ===== Storage =====
+  setStorage(storage) {
+    this.storageValue = storage;
+  }
+  getStorage() {
+    return this.storageValue;
+  }
+  // ===== Region Context（由平台层调用） =====
+  /**
+   * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。
+   * 注入后会立即运行 router 函数确定 region。
+   */
+  setRegionContext(ctx) {
+    this.regionContext = ctx;
+    this.resolveRegion();
+  }
+  getRegionContext() {
+    return this.regionContext;
+  }
+  // ===== 广告 =====
+  enableAds(manager) {
+    this.adManagerValue = manager;
+    return manager;
+  }
+  getAdManager() {
+    return this.adManagerValue;
+  }
+  // ===== 内部方法 =====
+  getActiveReporters() {
+    if (this.resolvedRegionReporters.length > 0) {
+      return this.resolvedRegionReporters;
+    }
+    return [...this.reporters.values()];
+  }
+  resolveRegion() {
+    if (this.regionFn && this.regionContext) {
+      const newRegion = this.regionFn(this.regionContext);
+      if (newRegion !== this.currentRegion) {
+        this.currentRegion = newRegion;
+      }
+    }
+    const provider = this.regionReportersMap[this.currentRegion];
+    if (Array.isArray(provider)) {
+      this.resolvedRegionReporters = provider;
+    } else if (typeof provider === "function") {
+      this.resolvedRegionReporters = [];
+      provider().then((rs) => {
+        this.resolvedRegionReporters = rs;
+      }).catch((err) => {
+        this.logger.log(
+          3 /* Warning */,
+          `[Suucha] Failed to load reporters for region "${this.currentRegion}":`,
+          err
+        );
+      });
+    }
+  }
+  async dispatch(events) {
+    const reporters = this.getActiveReporters();
+    if (reporters.length === 0) return;
+    await Promise.all(
+      events.flatMap(
+        (ev) => reporters.map(
+          (r) => r.logEvent(ev.name, ev.params).catch((err) => {
+            this.logger.log(
+              4 /* Error */,
+              `[Suucha] Reporter "${r.name}" failed to log "${ev.name}":`,
+              err
+            );
+          })
+        )
+      )
+    );
+  }
+  generateAnonymousId() {
+    const rand = Math.random().toString(36).slice(2, 10);
+    return `anon_${Date.now().toString(36)}_${rand}`;
+  }
+};
+var suucha = new Suucha();
+
+export { EventCounterIntercept, IdentityIntercept, LogLevel, Suucha, suucha };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/interceptors.ts","../src/suucha.ts"],"names":["LogLevel"],"mappings":"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","file":"index.js","sourcesContent":["/**\r\n * @suucha/core - Type Definitions\r\n *\r\n * 平台无关的核心接口定义。\r\n * 此文件不依赖任何浏览器或 Node.js API，可被任何平台（Web、RN、小程序）复用。\r\n */\r\n\r\n// ===== 日志等级 =====\r\n\r\nexport enum LogLevel {\r\n  Trace = 0,\r\n  Debug = 1,\r\n  Information = 2,\r\n  Warning = 3,\r\n  Error = 4,\r\n  Critical = 5,\r\n  None = 6,\r\n}\r\n\r\n// ===== 日志事件相关 =====\r\n\r\nexport interface LogEvent {\r\n  name: string;\r\n  params: Record<string, any>;\r\n  timestamp: number;\r\n}\r\n\r\n/**\r\n * 日志事件上报器接口（第三方实现）\r\n *\r\n * 每个第三方服务（GA4、神策、Mixpanel 等）实现此接口，\r\n * 通过 `suucha.addReporter(...)` 或 `suucha.region.reporters(...)` 注册。\r\n */\r\nexport interface ILogEventReporter {\r\n  readonly name: string;\r\n  logEvent(name: string, params: Record<string, any>): Promise<void>;\r\n}\r\n\r\n/**\r\n * 事件拦截器：可产生新事件\r\n *\r\n * 用例：事件计数（spin 第 10 次自动产生 spin_010 事件）\r\n */\r\nexport interface ILogEventIntercept {\r\n  readonly name: string;\r\n  /** 越小越先执行 */\r\n  readonly order: number;\r\n  execute(\r\n    eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<{\r\n    events?: Array<{ name: string; params: Record<string, any> }>;\r\n  }>;\r\n}\r\n\r\n/**\r\n * 事件参数拦截器：可修改事件参数\r\n *\r\n * 用例：附加归因、用户身份、运行时长\r\n */\r\nexport interface ILogEventParameterIntercept {\r\n  readonly name: string;\r\n  /** 越小越先执行 */\r\n  readonly order: number;\r\n  execute(\r\n    eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<Record<string, any>>;\r\n}\r\n\r\n// ===== Logger =====\r\n\r\nexport interface ILogger {\r\n  log(level: LogLevel, message: string, ...args: any[]): void;\r\n}\r\n\r\n// ===== Storage =====\r\n\r\nexport interface IStorage {\r\n  get<T = any>(key: string): Promise<T | null>;\r\n  set<T = any>(key: string, value: T, ttl?: number): Promise<void>;\r\n  remove(key: string): Promise<void>;\r\n}\r\n\r\n// ===== 广告 =====\r\n\r\nexport interface AdSlotOptions {\r\n  container: string | HTMLElement;\r\n  slot?: string;\r\n  format?: 'auto' | 'horizontal' | 'vertical' | 'rectangle';\r\n  responsive?: boolean;\r\n}\r\n\r\nexport interface AdSlotHandle {\r\n  readonly id: string;\r\n  readonly slot: string;\r\n  destroy(): void;\r\n}\r\n\r\nexport interface IAdManager {\r\n  mountSlot(options: AdSlotOptions): Promise<AdSlotHandle>;\r\n  unmountSlot(handle: AdSlotHandle): void;\r\n  refresh?(handle: AdSlotHandle): void;\r\n}\r\n\r\n// ===== Consent =====\r\n\r\nexport interface IConsentManager {\r\n  hasConsent(): boolean;\r\n  onConsentChange(cb: (granted: boolean) => void): () => void;\r\n}\r\n\r\n// ===== Region 路由 =====\r\n\r\nexport interface RegionContext {\r\n  host: string;\r\n  pathname: string;\r\n  timezone: string;\r\n  language: string;\r\n  url: string;\r\n}\r\n\r\nexport type ReporterProvider = ILogEventReporter[] | (() => Promise<ILogEventReporter[]>);\r\n\r\nexport interface RegionRouter {\r\n  router(fn: (ctx: RegionContext) => string): void;\r\n  reporters(map: Record<string, ReporterProvider>): void;\r\n  getRegion(): string;\r\n  getReporters(): ILogEventReporter[];\r\n}\r\n","/**\r\n * @suucha/core - 内置拦截器\r\n */\r\n\r\nimport type {\r\n  ILogEventIntercept,\r\n  ILogEventParameterIntercept,\r\n} from './types.js';\r\n\r\n/**\r\n * 事件计数配置\r\n */\r\nexport interface EventCounterConfiguration {\r\n  /** 事件名或前缀 */\r\n  name: string;\r\n  /** 触发的次数列表 */\r\n  counts: number[];\r\n  /** 名称补 0 长度，默认 3 */\r\n  padLength?: number;\r\n}\r\n\r\n/**\r\n * 用户身份拦截器（自动启用）\r\n * 给每个事件附加 anonymous_id 和（如果已 identify）user_id\r\n */\r\nexport class IdentityIntercept implements ILogEventParameterIntercept {\r\n  readonly name = 'suucha-identity';\r\n  readonly order = 100;\r\n\r\n  constructor(\r\n    private readonly getAnonymousId: () => string,\r\n    private readonly getUserId: () => string | null,\r\n  ) {}\r\n\r\n  async execute(\r\n    _eventName: string,\r\n    params: Record<string, any>,\r\n  ): Promise<Record<string, any>> {\r\n    const enriched: Record<string, any> = {\r\n      ...params,\r\n      anonymous_id: this.getAnonymousId(),\r\n    };\r\n    const userId = this.getUserId();\r\n    if (userId) {\r\n      enriched.user_id = userId;\r\n    }\r\n    return enriched;\r\n  }\r\n}\r\n\r\n/**\r\n * 事件计数拦截器\r\n *\r\n * 在配置的事件达到指定次数时，产生新事件（名称格式 {eventName}_{paddedCount}）\r\n */\r\nexport class EventCounterIntercept implements ILogEventIntercept {\r\n  readonly name = 'suucha-event-counter';\r\n  readonly order = 200;\r\n\r\n  private readonly counts = new Map<string, number>();\r\n\r\n  constructor(private readonly configurations: EventCounterConfiguration[]) {}\r\n\r\n  async execute(eventName: string, params: Record<string, any>) {\r\n    const events: Array<{ name: string; params: Record<string, any> }> = [];\r\n\r\n    for (const config of this.configurations) {\r\n      const isMatch =\r\n        eventName === config.name || eventName.startsWith(`${config.name}_`);\r\n      if (!isMatch) continue;\r\n\r\n      const current = (this.counts.get(config.name) ?? 0) + 1;\r\n      this.counts.set(config.name, current);\r\n\r\n      if (config.counts.includes(current)) {\r\n        const padLength = config.padLength ?? 3;\r\n        const padded = String(current).padStart(padLength, '0');\r\n        events.push({\r\n          name: `${config.name}_${padded}`,\r\n          params: { ...params },\r\n        });\r\n      }\r\n    }\r\n\r\n    return { events };\r\n  }\r\n}\r\n","/**\r\n * @suucha/core - Suucha 主类与单例\r\n */\r\n\r\nimport {\r\n  IdentityIntercept,\r\n} from './interceptors.js';\r\nimport { LogLevel } from './types.js';\r\nimport type {\r\n  ILogEventIntercept,\r\n  ILogEventParameterIntercept,\r\n  ILogEventReporter,\r\n  ILogger,\r\n  IStorage,\r\n  IAdManager,\r\n  RegionContext,\r\n  RegionRouter,\r\n  ReporterProvider,\r\n} from './types.js';\r\n\r\n/**\r\n * 默认 no-op logger，未配置 logger 时使用\r\n */\r\nclass DefaultLogger implements ILogger {\r\n  log(_level: LogLevel, _message: string, ..._args: any[]): void {\r\n    // no-op\r\n  }\r\n}\r\n\r\nconst DEFAULT_REGION = 'default';\r\n\r\nexport class Suucha {\r\n  private readonly reporters = new Map<string, ILogEventReporter>();\r\n  private readonly eventIntercepts: ILogEventIntercept[] = [];\r\n  private readonly paramIntercepts: ILogEventParameterIntercept[] = [];\r\n  private logger: ILogger = new DefaultLogger();\r\n  private logLevel: LogLevel = LogLevel.Information;\r\n  private anonymousId: string;\r\n  private userId: string | null = null;\r\n  private consent = true;\r\n  private readonly consentQueue: Array<{ name: string; params: Record<string, any> }> = [];\r\n  private regionFn?: (ctx: RegionContext) => string;\r\n  private regionReportersMap: Record<string, ReporterProvider> = {};\r\n  private currentRegion = DEFAULT_REGION;\r\n  private resolvedRegionReporters: ILogEventReporter[] = [];\r\n  private regionContext: RegionContext | null = null;\r\n  private adManagerValue: IAdManager | null = null;\r\n  private storageValue?: IStorage;\r\n\r\n  readonly region: RegionRouter;\r\n\r\n  constructor() {\r\n    this.anonymousId = this.generateAnonymousId();\r\n    this.paramIntercepts.push(\r\n      new IdentityIntercept(() => this.anonymousId, () => this.userId),\r\n    );\r\n\r\n    this.region = {\r\n      router: (fn) => {\r\n        this.regionFn = fn;\r\n        this.resolveRegion();\r\n      },\r\n      reporters: (map) => {\r\n        this.regionReportersMap = map;\r\n        this.resolveRegion();\r\n      },\r\n      getRegion: () => this.currentRegion,\r\n      getReporters: () => this.getActiveReporters(),\r\n    };\r\n  }\r\n\r\n  // ===== 日志 =====\r\n\r\n  setLogLevel(level: LogLevel): void {\r\n    this.logLevel = level;\r\n  }\r\n\r\n  getLogLevel(): LogLevel {\r\n    return this.logLevel;\r\n  }\r\n\r\n  setLogger(logger: ILogger): void {\r\n    this.logger = logger;\r\n  }\r\n\r\n  getLogger(): ILogger {\r\n    return this.logger;\r\n  }\r\n\r\n  // ===== 埋点 =====\r\n\r\n  async log(eventName: string, params: Record<string, any> = {}): Promise<void> {\r\n    // 1. 参数拦截器链\r\n    let enriched = { ...params };\r\n    for (const ic of this.paramIntercepts) {\r\n      enriched = await ic.execute(eventName, enriched);\r\n    }\r\n\r\n    // 2. 事件拦截器链（可产生新事件）\r\n    const allEvents: Array<{ name: string; params: Record<string, any> }> = [\r\n      { name: eventName, params: enriched },\r\n    ];\r\n    for (const ic of this.eventIntercepts) {\r\n      const result = await ic.execute(eventName, enriched);\r\n      if (result.events) {\r\n        allEvents.push(...result.events);\r\n      }\r\n    }\r\n\r\n    // 3. Consent 检查：未同意则入队，不外发\r\n    if (!this.consent) {\r\n      for (const ev of allEvents) {\r\n        this.consentQueue.push(ev);\r\n      }\r\n      return;\r\n    }\r\n\r\n    // 4. 分发到 reporters\r\n    await this.dispatch(allEvents);\r\n  }\r\n\r\n  addReporter(reporter: ILogEventReporter): void {\r\n    this.reporters.set(reporter.name, reporter);\r\n  }\r\n\r\n  removeReporter(name: string): void {\r\n    this.reporters.delete(name);\r\n  }\r\n\r\n  getReporters(): ILogEventReporter[] {\r\n    return this.getActiveReporters();\r\n  }\r\n\r\n  // ===== 拦截器 =====\r\n\r\n  addEventIntercept(ic: ILogEventIntercept): void {\r\n    this.eventIntercepts.push(ic);\r\n    this.eventIntercepts.sort((a, b) => a.order - b.order);\r\n  }\r\n\r\n  addParameterIntercept(ic: ILogEventParameterIntercept): void {\r\n    this.paramIntercepts.push(ic);\r\n    this.paramIntercepts.sort((a, b) => a.order - b.order);\r\n  }\r\n\r\n  removeIntercept(name: string): void {\r\n    const ei = this.eventIntercepts.findIndex((x) => x.name === name);\r\n    if (ei >= 0) this.eventIntercepts.splice(ei, 1);\r\n    const pi = this.paramIntercepts.findIndex((x) => x.name === name);\r\n    if (pi >= 0) this.paramIntercepts.splice(pi, 1);\r\n  }\r\n\r\n  // ===== 用户身份 =====\r\n\r\n  identify(userId: string, traits?: Record<string, any>): void {\r\n    this.userId = userId;\r\n    if (traits) {\r\n      this.log('user_identify', { user_id: userId, ...traits }).catch(() => {});\r\n    }\r\n  }\r\n\r\n  getAnonymousId(): string {\r\n    return this.anonymousId;\r\n  }\r\n\r\n  setAnonymousId(id: string): void {\r\n    this.anonymousId = id;\r\n  }\r\n\r\n  getUserId(): string | null {\r\n    return this.userId;\r\n  }\r\n\r\n  reset(): void {\r\n    this.userId = null;\r\n    this.anonymousId = this.generateAnonymousId();\r\n  }\r\n\r\n  // ===== Consent =====\r\n\r\n  setConsent(granted: boolean): void {\r\n    const wasGranted = this.consent;\r\n    this.consent = granted;\r\n    if (granted && !wasGranted) {\r\n      // flush 队列\r\n      const queue = [...this.consentQueue];\r\n      this.consentQueue.length = 0;\r\n      for (const ev of queue) {\r\n        this.dispatch([ev]).catch(() => {});\r\n      }\r\n    }\r\n  }\r\n\r\n  hasConsent(): boolean {\r\n    return this.consent;\r\n  }\r\n\r\n  // ===== Storage =====\r\n\r\n  setStorage(storage: IStorage): void {\r\n    this.storageValue = storage;\r\n  }\r\n\r\n  getStorage(): IStorage | undefined {\r\n    return this.storageValue;\r\n  }\r\n\r\n  // ===== Region Context（由平台层调用） =====\r\n\r\n  /**\r\n   * 平台层（如 @suucha/web 的 setupWeb）调用此方法注入 region 上下文。\r\n   * 注入后会立即运行 router 函数确定 region。\r\n   */\r\n  setRegionContext(ctx: RegionContext): void {\r\n    this.regionContext = ctx;\r\n    this.resolveRegion();\r\n  }\r\n\r\n  getRegionContext(): RegionContext | null {\r\n    return this.regionContext;\r\n  }\r\n\r\n  // ===== 广告 =====\r\n\r\n  enableAds(manager: IAdManager): IAdManager {\r\n    this.adManagerValue = manager;\r\n    return manager;\r\n  }\r\n\r\n  getAdManager(): IAdManager | null {\r\n    return this.adManagerValue;\r\n  }\r\n\r\n  // ===== 内部方法 =====\r\n\r\n  private getActiveReporters(): ILogEventReporter[] {\r\n    if (this.resolvedRegionReporters.length > 0) {\r\n      return this.resolvedRegionReporters;\r\n    }\r\n    return [...this.reporters.values()];\r\n  }\r\n\r\n  private resolveRegion(): void {\r\n    if (this.regionFn && this.regionContext) {\r\n      const newRegion = this.regionFn(this.regionContext);\r\n      if (newRegion !== this.currentRegion) {\r\n        this.currentRegion = newRegion;\r\n      }\r\n    }\r\n\r\n    const provider = this.regionReportersMap[this.currentRegion];\r\n    if (Array.isArray(provider)) {\r\n      this.resolvedRegionReporters = provider;\r\n    } else if (typeof provider === 'function') {\r\n      // 异步加载，先置空避免发送到错误 region\r\n      this.resolvedRegionReporters = [];\r\n      provider()\r\n        .then((rs) => {\r\n          this.resolvedRegionReporters = rs;\r\n        })\r\n        .catch((err) => {\r\n          this.logger.log(\r\n            LogLevel.Warning,\r\n            `[Suucha] Failed to load reporters for region \"${this.currentRegion}\":`,\r\n            err,\r\n          );\r\n        });\r\n    }\r\n    // 没有 provider 时保持现有 reporters（直接 addReporter 注册的）\r\n  }\r\n\r\n  private async dispatch(\r\n    events: Array<{ name: string; params: Record<string, any> }>,\r\n  ): Promise<void> {\r\n    const reporters = this.getActiveReporters();\r\n    if (reporters.length === 0) return;\r\n\r\n    await Promise.all(\r\n      events.flatMap((ev) =>\r\n        reporters.map((r) =>\r\n          r.logEvent(ev.name, ev.params).catch((err) => {\r\n            this.logger.log(\r\n              LogLevel.Error,\r\n              `[Suucha] Reporter \"${r.name}\" failed to log \"${ev.name}\":`,\r\n              err,\r\n            );\r\n          }),\r\n        ),\r\n      ),\r\n    );\r\n  }\r\n\r\n  private generateAnonymousId(): string {\r\n    const rand = Math.random().toString(36).slice(2, 10);\r\n    return `anon_${Date.now().toString(36)}_${rand}`;\r\n  }\r\n}\r\n\r\n/**\r\n * Suucha 全局单例\r\n */\r\nexport const suucha = new Suucha();\r\n"]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@suucha/core",
+  "version": "0.1.0",
+  "description": "Core abstractions, types, and the Suucha singleton for Suucha Web SDK",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "suucha",
+    "analytics",
+    "sdk",
+    "core",
+    "typescript"
+  ],
+  "license": "MIT",
+  "author": "Suucha Studio",
+  "homepage": "https://github.com/suucha/Suucha.Web.Core#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/suucha/Suucha.Web.Core.git",
+    "directory": "packages/core"
+  },
+  "bugs": {
+    "url": "https://github.com/suucha/Suucha.Web.Core/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "typecheck": "tsc --noEmit"
+  }
+}