@macroui/event-tracker 1.3.0

package/dist/types/plugins/exposure/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * exposure 插件：元素曝光（IntersectionObserver）
+ *  - $element_exposure 事件
+ *  - 元素进入视口超过阈值持续 X ms 才上报（默认 500ms）
+ *  - 同元素同阈值只上报一次
+ */
+import type { Plugin } from '../../core/plugin.js';
+export interface ExposureOptions {
+    /** 选择器或元素集合 */
+    selector?: string;
+    /** 阈值（0~1，默认 0.5） */
+    threshold?: number;
+    /** 最小停留时间（ms，默认 500） */
+    duration?: number;
+    /** 额外附加属性（按 data-attr 注入到事件） */
+    attrPrefix?: string;
+}
+export declare function exposure(opts?: ExposureOptions): Plugin;

package/dist/types/plugins/indexeddb-sender/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * indexeddb-sender 插件：把事件写到 IndexedDB（用于离线缓存 / 批量消费）
+ *  - 不实际发送，只把序列化事件追加到指定 IDB store
+ *  - 适合后续被 webview bridge / native / service worker 消费
+ */
+import type { Plugin } from '../../core/plugin.js';
+export interface IndexedDBSenderOptions {
+    /** IDB 名（默认 event-tracker-outbox） */
+    dbName?: string;
+    /** object store 名（默认 outbox） */
+    storeName?: string;
+    /** 上限（条），超过从头丢弃 */
+    max?: number;
+}
+export declare function indexedDBSender(opts?: IndexedDBSenderOptions): Plugin;

package/dist/types/plugins/pageleave/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * pageleave 插件：用户离开页面（关闭、跳转、切到后台）时上报
+ *  - $WebPageLeave 事件
+ *  - 包含 $event_duration / $url_path / $referrer / $viewport_position
+ *  - 包含 page_visible 标记（visibilitychange API）
+ */
+import type { Plugin } from '../../core/plugin.js';
+export interface PageLeaveOptions {
+    /** 是否同步阻塞（sendBeacon 异步即可） */
+    sendOnUnload?: boolean;
+}
+export declare function pageLeave(_opts?: PageLeaveOptions): Plugin;

package/dist/types/plugins/pageload/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * pageload 插件：performance API 采集首屏加载性能
+ *  - $WebPageLoad 事件，包含：
+ *    $load_time / $dom_ready_time / $dom_interactive_time / $response_time
+ *    $page_resource_size / $page_height / $viewport_position
+ */
+import type { Plugin } from '../../core/plugin.js';
+export interface PageLoadOptions {
+    /** 是否立即触发（默认 true） */
+    immediate?: boolean;
+    /** 自定义时间轴 */
+    measures?: string[];
+}
+export declare function pageLoad(opts?: PageLoadOptions): Plugin;

package/dist/types/plugins/session-event/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * session-event 插件：会话管理
+ *  - 每条事件附 $event_session_id（首次访问生成，存 storage）
+ *  - $session_start / $session_end 事件
+ *  - 超时（默认 30 分钟）则重开会话
+ */
+import type { Plugin } from '../../core/plugin.js';
+export interface SessionOptions {
+    /** 会话超时（ms） */
+    timeout?: number;
+    /** 是否在超时上报 $session_end */
+    endOnTimeout?: boolean;
+}
+export declare function sessionEvent(opts?: SessionOptions): Plugin;

package/dist/types/plugins/webview-bridge/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * WebView 桥（vapph5 协议）
+ *  - 客户端（iOS/Android）注入 window.vapph5define 对象
+ *  - H5 通过 vapph5define.call(name, args) 调用客户端方法
+ *  - 客户端通过 vapph5define.handle(name, fn) 监听 H5 调用
+ *
+ * 本插件负责：
+ *  1. 探测 WebView 标识
+ *  2. 在 SDK 启动时调用 vapph5define.call('getAppInfo')，把 app_version/app_id/...
+ *     注入到 config 与公共属性
+ *  3. 暴露 helper：bridge.call(name, args) 与 bridge.on(name, fn)
+ */
+import type { Plugin } from '../../core/plugin.js';
+declare global {
+    interface Window {
+        vapph5define?: {
+            call: (name: string, ...args: unknown[]) => unknown;
+            handle: (name: string, fn: (...args: unknown[]) => unknown) => void;
+            isInApp?: boolean;
+        };
+    }
+}
+export interface WebViewBridgeOptions {
+    /** 自定义 vapph5 对象，默认 window.vapph5define */
+    defineName?: string;
+    /** 是否在 install 时立刻拉 app 信息 */
+    fetchOnInit?: boolean;
+    /** 自定义取 app 信息的协议名（默认 'getAppInfo'） */
+    protocolName?: string;
+    /** 取回的应用信息合并到 SDK 的字段映射 */
+    fieldMap?: Partial<Record<'app_version' | 'app_id' | 'app_state' | 'channel' | 'lib', string>>;
+}
+export declare function webviewBridge(opts?: WebViewBridgeOptions): Plugin;

package/dist/types/presets/preset-properties.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 公共属性 / 预置事件属性
+ *  - 每次事件都会附加的属性
+ *  - 包括 $lib / $lib_version / $app_id / $screen_width / $viewport_width / $url / $referrer / $latest_utm_* / ...
+ *
+ *  泛型 TRegisterProps：让用户能约束 register() / preset 的字段类型
+ */
+import type { TrackerConfig } from '../types/index.js';
+/** 默认 register 类型 */
+export type DefaultRegisterProps = Record<string, unknown>;
+export declare class PresetPropertyBuilder<TRegister extends DefaultRegisterProps = DefaultRegisterProps> {
+    /** 当前会话级用户预设属性（来自 config.preset_properties） */
+    private preset;
+    setPreset(props: Partial<TRegister>): void;
+    /** 一次性写入：每条事件都带 */
+    register(props: Partial<TRegister>): void;
+    /** 一次性写入：只在同会话内首次写入生效 */
+    registerOnce(props: Partial<TRegister>): void;
+    clearRegister(): void;
+    unsetRegister<K extends keyof TRegister>(key: K): void;
+    getPreset(): Partial<TRegister>;
+    /** 计算一次最终合并的属性（含 lib 自身信息、UA、URL 等） */
+    build(config: TrackerConfig, baseProps?: Record<string, unknown>): Record<string, unknown>;
+}
+export declare function parseUtm(query: string): Record<string, string>;

package/dist/types/send/ajax-sender.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Ajax 发送器（fetch + keepalive）
+ */
+import type { SendContext, Sender } from './sender.js';
+import type { EventData } from '../types/index.js';
+export declare class AjaxSender implements Sender {
+    name: "ajax";
+    canUse(): boolean;
+    send(event: EventData, ctx: SendContext): Promise<void>;
+    sendBatch(events: EventData[], ctx: SendContext): Promise<void>;
+}

package/dist/types/send/batch-sender.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Batch 发送器：事件先入队到 localStorage，定时或达上限时一次性 POST
+ */
+import type { SendContext, Sender } from './sender.js';
+import type { EventData } from '../types/index.js';
+export declare class BatchSender implements Sender {
+    name: "batch";
+    private timer;
+    canUse(): boolean;
+    start(ctx: SendContext): void;
+    stop(): void;
+    send(event: EventData, ctx: SendContext): Promise<void>;
+    private enqueue;
+    private read;
+    private write;
+    flush(ctx: SendContext): Promise<void>;
+}

package/dist/types/send/beacon-sender.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Beacon 发送器（navigator.sendBeacon）
+ */
+import type { SendContext, Sender } from './sender.js';
+import type { EventData } from '../types/index.js';
+export declare class BeaconSender implements Sender {
+    name: "beacon";
+    canUse(): boolean;
+    send(event: EventData, ctx: SendContext): Promise<void>;
+}

package/dist/types/send/encode.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 序列化 & 编码
+ */
+import type { EventData } from '../types/index.js';
+export type EncryptFn = (data: string) => string | Promise<string>;
+export declare function encodeEvent(event: EventData, encryptor?: EncryptFn): string | Promise<string>;
+export declare function encodeBatch(events: EventData[], encryptor?: EncryptFn): string | Promise<string>;
+export declare function buildUrl(serverUrl: string | string[], payload: string, contentType?: 'json' | 'form'): string;

package/dist/types/send/image-sender.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Image 发送器（1x1 gif 兜底，兼容性最好）
+ */
+import type { SendContext, Sender } from './sender.js';
+import type { EventData } from '../types/index.js';
+export declare class ImageSender implements Sender {
+    name: "image";
+    canUse(): boolean;
+    send(event: EventData, ctx: SendContext): Promise<void>;
+}

package/dist/types/send/sender.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 发送器基类
+ */
+import type { EventData, TrackerConfig, SendType } from '../types/index.js';
+import type { Logger } from '../core/logger.js';
+export interface SendContext {
+    config: TrackerConfig;
+    logger: Logger;
+}
+export interface Sender {
+    /** 此发送器是否适用于当前上下文 */
+    canUse(): boolean;
+    /** 发送单条事件 */
+    send(event: EventData, ctx: SendContext): Promise<void> | void;
+    /** 批量发送（batch 模式） */
+    sendBatch?(events: EventData[], ctx: SendContext): Promise<void> | void;
+    /** 名称 */
+    name: SendType | string;
+}
+export declare function pickSender(type: SendType | undefined, candidates: Sender[]): Sender;

package/dist/types/storage/indexeddb-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * IndexedDB KV 存储（同步接口版本）
+ *  - 通过 localStorage 镜像 + 后台 IDB 写入实现同步语义
+ *  - 对 SDK 完全透明：实现同步 KVStore 接口
+ */
+import type { KVStore } from './store.js';
+export declare class IndexedDBStoreSync implements KVStore {
+    private dbPromise;
+    constructor();
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    keys(prefix?: string): string[];
+}

package/dist/types/storage/store.d.ts

@@ -0,0 +1,56 @@
+/**
+ * 统一 KV 存储抽象
+ * - CookieStore
+ * - LocalStorageStore
+ * - SessionStorageStore
+ * - MemoryStore
+ */
+import type { StorageType } from '../types/index.js';
+export interface KVStore {
+    get(key: string): string | null;
+    set(key: string, value: string, expiresDays?: number): void;
+    remove(key: string): void;
+    /** 当前所有 key（用于清除命名空间） */
+    keys(prefix?: string): string[];
+}
+export declare class MemoryStore implements KVStore {
+    private backing;
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    keys(prefix?: string): string[];
+}
+declare class CookieStore implements KVStore {
+    private domain?;
+    private crossSubdomain;
+    private secure;
+    constructor(domain?: string | undefined, crossSubdomain?: boolean, secure?: boolean);
+    get(key: string): string | null;
+    set(key: string, value: string, expiresDays?: number): void;
+    remove(key: string): void;
+    keys(prefix?: string): string[];
+}
+declare class LocalStorageStore implements KVStore {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    keys(prefix?: string): string[];
+}
+declare class SessionStorageStore implements KVStore {
+    get(key: string): string | null;
+    set(key: string, value: string): void;
+    remove(key: string): void;
+    keys(prefix?: string): string[];
+}
+export declare function createStore(type: StorageType, opts?: {
+    cookieDomain?: string;
+    cookieCrossSubdomain?: boolean;
+    secureCookie?: boolean;
+}): KVStore;
+/** 自动选最合适的存储（cookie 不可用 → localStorage → memory） */
+export declare function autoStore(opts?: {
+    cookieDomain?: string;
+    cookieCrossSubdomain?: boolean;
+    secureCookie?: boolean;
+}): KVStore;
+export { CookieStore, LocalStorageStore, SessionStorageStore };

package/dist/types/types/common.d.ts

@@ -0,0 +1,26 @@
+/**
+ * 通用类型（v1.1.1）
+ */
+/** 上报方式 */
+export type SendType = 'image' | 'beacon' | 'ajax' | 'batch';
+/** 存储类型 */
+export type StorageType = 'memory' | 'localStorage' | 'sessionStorage' | 'cookie' | 'indexeddb';
+/** 日志级别 */
+export type LogLevel = 'log' | 'info' | 'warn' | 'error' | 'debug';
+/** 事件回调 */
+export type Callback = (err: Error | null) => void;
+/** 任意 JSON 值 */
+export type JSONValue = string | number | boolean | null | JSONObject | JSONArray;
+export interface JSONObject {
+    [key: string]: JSONValue;
+}
+export interface JSONArray extends Array<JSONValue> {
+}
+/** 内部事件 payload 类型 */
+export type PropertyMap = Record<string, unknown>;
+/** 上报 URL 类型 */
+export type ServerURL = string | string[];
+/** 阶段名 */
+export type StageName = 'buildDataStage' | 'businessStage' | 'sendDataStage';
+/** 钩子名 */
+export type HookName = 'sdkReady' | 'sdkInitPara' | 'sdkAfterInitPara' | 'sdkInitAPI' | 'sdkAfterInitAPI' | 'changeDistinctId' | 'switch';

package/dist/types/types/config.d.ts

@@ -0,0 +1,117 @@
+/**
+ * TrackerConfig 类型分层（v1.1.1）
+ *
+ *   BaseConfig        公共基础
+ *   ├─ SendConfig     上报相关（URL / 模式 / 重试）
+ *   ├─ StorageConfig  存储类型 / cookie 配置
+ *   ├─ IdentityConfig 身份注入
+ *   ├─ EncryptConfig  加密 / 脱敏
+ *   ├─ PresetConfig   预设属性 / 事件
+ *   └─ DebugConfig    debug / 日志
+ *
+ * TrackerConfig = 所有子集
+ */
+import type { SendType, StorageType } from './common.js';
+export interface BaseConfig {
+    /** 项目 ID（必填） */
+    app_id: string;
+    /** SDK 名（默认 event-tracker） */
+    lib_name?: string;
+    /** SDK 版本（默认 1.1.0） */
+    lib_version?: string;
+    /** 关闭 SDK：true 后所有 track 都是 noop */
+    disabled?: boolean;
+    /** 自定义客户端事件时间戳（覆盖 Date.now） */
+    get_client_timestamp?: () => number;
+}
+export interface SendConfig {
+    /** 服务端接收地址（单点 / 多点） */
+    server_url: string | string[];
+    /** 发送方式（image/beacon/ajax/batch） */
+    send_type?: SendType;
+    /** 批量上报配置（batch 模式） */
+    batch_send?: {
+        send_interval?: number;
+        max_length?: number;
+    };
+    /** 单条超时（ms），超过后失败 */
+    send_timeout?: number;
+    /** 失败重试次数（默认 3） */
+    max_retry_count?: number;
+    /** 最大重试时长（ms），默认 30s */
+    max_retry_duration?: number;
+    /** 单条数据额外回调（成功后） */
+    callback?: (event: unknown) => void;
+    /** 单条数据发送失败回调 */
+    on_error?: (err: Error, event: unknown) => void;
+}
+export interface StorageConfig {
+    /** 存储类型（memory/localStorage/sessionStorage/cookie/indexeddb） */
+    storage_type?: StorageType;
+    /** cookie 作用域 */
+    cookie_domain?: string;
+    /** cookie 是否跨子域 */
+    cookie_cross_subdomain?: boolean;
+    /** cookie secure 标志 */
+    secure_cookie?: boolean;
+    /** localStorage 命名空间前缀 */
+    storage_prefix?: string;
+}
+export interface IdentityConfig {
+    /** 已有的 distinct_id（外部系统注入） */
+    get_distinct_id?: () => string;
+    set_distinct_id?: (id: string) => void;
+    get_anonymous_id?: () => string;
+    set_anonymous_id?: (id: string) => void;
+    get_first_id?: () => string;
+    set_first_id?: (id: string) => void;
+    /** 身份签名密钥（开启 signed identity） */
+    identity_secret?: string;
+}
+export interface EncryptConfig {
+    /** 加密（接收 JSON 字符串返回 string | Promise<string>） */
+    encryptor?: (data: string) => string | Promise<string>;
+    /** 解密（占位） */
+    decoder?: (data: string) => string;
+    /** 事件级加密前钩子（脱敏 / 补字段） */
+    encryptEvent?: (event: Record<string, unknown>) => unknown;
+    /** 解密后处理 */
+    decryptEvent?: (event: Record<string, unknown>) => unknown;
+}
+export interface PresetConfig {
+    /** 自定义预置属性（覆盖默认） */
+    preset_properties?: Record<string, unknown>;
+    /** 是否采集 UTM 参数（默认 true） */
+    is_collect_utm?: boolean;
+}
+export interface DebugConfig {
+    /** debug 模式（0=关闭 1=basic 2=verbose） */
+    debug?: 0 | 1 | 2;
+    /** 是否显示日志 */
+    show_log?: boolean;
+}
+export type TrackerConfig = BaseConfig & SendConfig & StorageConfig & IdentityConfig & EncryptConfig & PresetConfig & DebugConfig & JsAppConfig & ClientConfig & DebugSenderConfig;
+export interface JsAppConfig {
+    /** 应用版本（JS） */
+    app_version?: string;
+    /** 自定义 user-agent */
+    user_agent?: string;
+    /** 多实例 client_id */
+    client_id?: string;
+    /** 数据上报超时（batch 模式兜底，alias of send_timeout） */
+    datasend_timeout?: number;
+}
+export interface ClientConfig {
+    /** 自定义 fetch（用于测试 / polyfill） */
+    customFetch?: typeof fetch;
+    /** 自定义 navigator.sendBeacon（用于测试） */
+    customSendBeacon?: (url: string, data: BodyInit | null) => boolean;
+}
+export interface DebugSenderConfig {
+    /** debug 模式下是否启用 debug-sender 插件 */
+    debug_mode?: boolean;
+    /** debug 上报 URL（覆盖 server_url） */
+    debug_mode_url?: string;
+    /** debug 上传目标 */
+    debug_mode_upload?: string;
+}

package/dist/types/types/constants.d.ts

@@ -0,0 +1,110 @@
+/**
+ * SDK 预置事件名与预置属性 key（v1.1：完整对齐神策）
+ * 命名风格对齐神策，方便跨平台对接
+ */
+/** 预置事件名 */
+export declare const PresetEvent: {
+    readonly PageView: "$pageview";
+    readonly WebPageLoad: "$WebPageLoad";
+    readonly WebPageLeave: "$WebPageLeave";
+    readonly WebClick: "$WebClick";
+    readonly WebStay: "$WebStay";
+    readonly SignUp: "$SignUp";
+    readonly BindID: "$BindID";
+    readonly UnbindID: "$UnbindID";
+    readonly ABTestTrigger: "$ABTestTrigger";
+    readonly PlanPopupClick: "$PlanPopupClick";
+    readonly PlanPopupDisplay: "$PlanPopupDisplay";
+    readonly ChannelLinkReaching: "$ChannelLinkReaching";
+    readonly ElementExposure: "$element_exposure";
+    readonly ScrollDepth: "$scrolldepth";
+    readonly ExitClick: "$exit_click";
+    readonly PageLeave: "$page_leave";
+    readonly HeatmapEvent: "$heatmap_event";
+};
+export type PresetEventName = (typeof PresetEvent)[keyof typeof PresetEvent];
+/** 预置属性 key */
+export declare const PresetProperty: {
+    readonly AppId: "$app_id";
+    readonly AppVersion: "$app_version";
+    readonly Lib: "$lib";
+    readonly LibMethod: "$lib_method";
+    readonly LibDetail: "$lib_detail";
+    readonly LibVersion: "$lib_version";
+    readonly ScreenWidth: "$screen_width";
+    readonly ScreenHeight: "$screen_height";
+    readonly ViewportWidth: "$viewport_width";
+    readonly ViewportHeight: "$viewport_height";
+    readonly TimezoneOffset: "$timezone_offset";
+    readonly UserAgent: "$user_agent";
+    readonly Language: "$language";
+    readonly FirstBrowserCharset: "$first_browser_charset";
+    readonly FirstBrowserLanguage: "$first_browser_language";
+    readonly URL: "$url";
+    readonly URLPath: "$url_path";
+    readonly Title: "$title";
+    readonly Referrer: "$referrer";
+    readonly ReferrerHost: "$referrer_host";
+    readonly LatestReferrer: "$latest_referrer";
+    readonly LatestReferrerHost: "$latest_referrer_host";
+    readonly LatestLandingPage: "$latest_landing_page";
+    readonly LatestSearchKeyword: "$latest_search_keyword";
+    readonly LatestTrafficSourceType: "$latest_traffic_source_type";
+    readonly FirstReferrer: "$first_referrer";
+    readonly FirstReferrerHost: "$first_referrer_host";
+    readonly FirstSearchKeyword: "$first_search_keyword";
+    readonly FirstTrafficSourceType: "$first_traffic_source_type";
+    readonly FirstVisitTime: "$first_visit_time";
+    readonly SearchKeywordId: "$search_keyword_id";
+    readonly SearchKeywordIdHash: "$search_keyword_id_hash";
+    readonly SearchKeywordIdType: "$search_keyword_id_type";
+    readonly IsFirstDay: "$is_first_day";
+    readonly IsFirstTime: "$is_first_time";
+    readonly LatestUtmSource: "$latest_utm_source";
+    readonly LatestUtmMedium: "$latest_utm_medium";
+    readonly LatestUtmCampaign: "$latest_utm_campaign";
+    readonly LatestUtmContent: "$latest_utm_content";
+    readonly LatestUtmTerm: "$latest_utm_term";
+    readonly Utms: "$utms";
+    readonly DistinctId: "$distinct_id";
+    readonly AnonymousId: "$anonymous_id";
+    readonly FirstId: "$first_id";
+    readonly OriginalId: "$original_id";
+    readonly LoginId: "$login_id";
+    readonly IsLoginId: "$is_login_id";
+    readonly IdentityLoginId: "$identity_login_id";
+    readonly IdentityAnonymousId: "$identity_anonymous_id";
+    readonly IdentityCookieId: "$identity_cookie_id";
+    readonly IdentityEmail: "$identity_email";
+    readonly IdentityMobile: "$identity_mobile";
+    readonly ElementSelector: "$element_selector";
+    readonly ElementPath: "$element_path";
+    readonly ElementType: "$element_type";
+    readonly ElementId: "$element_id";
+    readonly ElementClassName: "$element_class_name";
+    readonly ElementName: "$element_name";
+    readonly ElementContent: "$element_content";
+    readonly ElementTargetUrl: "$element_target_url";
+    readonly ElementPosition: "$element_position";
+    readonly PageX: "$page_x";
+    readonly PageY: "$page_y";
+    readonly PageHeight: "$page_height";
+    readonly PageResourceSize: "$page_resource_size";
+    readonly EventDuration: "$event_duration";
+    readonly ViewportPosition: "$viewport_position";
+    readonly LatestWxAdClickId: "$latest_wx_ad_click_id";
+    readonly LatestWxAdCallbacks: "$latest_wx_ad_callbacks";
+    readonly LatestWxAdHashKey: "$latest_wx_ad_hash_key";
+    readonly IsChannelCallbackEvent: "$is_channel_callback_event";
+    readonly EventSessionId: "$event_session_id";
+    readonly Time: "$time";
+    readonly Event: "$event";
+    readonly Option: "$option";
+    readonly Project: "$project";
+    readonly Token: "$token";
+    readonly SignupMethod: "$signup_method";
+};
+export type PresetPropertyKey = (typeof PresetProperty)[keyof typeof PresetProperty];
+/** 库自身信息 */
+export declare const LIB_NAME = "event-tracker";
+export declare const LIB_VERSION = "1.1.0";

package/dist/types/types/index.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 类型总入口（v1.1.1）
+ */
+export type { SendType, StorageType, LogLevel, Callback, JSONValue, JSONObject, JSONArray, PropertyMap, ServerURL, StageName, HookName, } from './common.js';
+export type { BaseConfig, SendConfig, StorageConfig, IdentityConfig, EncryptConfig, PresetConfig, DebugConfig, JsAppConfig, ClientConfig, DebugSenderConfig, TrackerConfig, } from './config.js';
+/** 待发送事件结构 */
+export interface EventData {
+    type: 'track' | 'track_signup' | 'track_id_bind' | 'track_id_unbind' | 'profile_set' | 'profile_set_once' | 'profile_increment' | 'profile_append' | 'profile_unset' | 'profile_delete' | 'item_set' | 'item_delete';
+    event?: string;
+    time: number;
+    distinct_id: string;
+    anonymous_id?: string;
+    first_id?: string;
+    login_id?: string;
+    original_id?: string;
+    properties: Record<string, unknown>;
+    token?: string;
+    project?: string;
+    lib?: {
+        $lib?: string;
+        $lib_version?: string;
+    };
+    _encrypted?: string;
+}
+export { PresetEvent, PresetProperty, LIB_NAME, LIB_VERSION } from './constants.js';

package/dist/types/types.test-d.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 公共 API 类型测试（tsd）
+ * 验证公开类型签名稳定
+ */
+export {};