@alibarbar/common 1.0.0

package/dist/storage.d.ts

@@ -0,0 +1,176 @@
+import { RSAKeyPair } from './crypto.js';
+
+/**
+ * 存储工具函数
+ */
+
+/**
+ * 存储配置选项
+ */
+interface StorageOptions {
+    /** RSA公钥（用于加密） */
+    publicKey?: CryptoKey;
+    /** RSA私钥（用于解密） */
+    privateKey?: CryptoKey;
+    /** 是否启用加密，默认为 true */
+    encrypt?: boolean;
+}
+/**
+ * 设置全局RSA密钥对
+ * @param keyPair - RSA密钥对
+ */
+declare function setStorageKeyPair(keyPair: RSAKeyPair): void;
+/**
+ * 获取全局密钥对
+ * @returns 全局密钥对或null
+ */
+declare function getStorageKeyPair(): RSAKeyPair | null;
+/**
+ * localStorage封装（支持过期时间和RSA加密）
+ */
+declare const localStorage: {
+    /**
+     * 设置值
+     * @param key - 键
+     * @param value - 值
+     * @param options - 选项（过期时间、密钥等）
+     * @returns Promise<void>
+     */
+    set<T>(key: string, value: T, options?: {
+        expiry?: number;
+        publicKey?: CryptoKey;
+    }): Promise<void>;
+    /**
+     * 获取值
+     * @param key - 键
+     * @param options - 选项（默认值、私钥等）
+     * @returns Promise<T | undefined> 值或默认值
+     */
+    get<T>(key: string, options?: {
+        defaultValue?: T;
+        privateKey?: CryptoKey;
+    }): Promise<T | undefined>;
+    /**
+     * 移除值
+     * @param key - 键
+     */
+    remove(key: string): void;
+    /**
+     * 清空所有值
+     */
+    clear(): void;
+    /**
+     * 获取所有键
+     * @returns 键数组
+     */
+    keys(): string[];
+};
+/**
+ * sessionStorage封装（支持RSA加密）
+ */
+declare const sessionStorage: {
+    /**
+     * 设置值
+     * @param key - 键
+     * @param value - 值
+     * @param options - 选项（公钥等）
+     * @returns Promise<void>
+     */
+    set<T>(key: string, value: T, options?: {
+        publicKey?: CryptoKey;
+    }): Promise<void>;
+    /**
+     * 获取值
+     * @param key - 键
+     * @param options - 选项（默认值、私钥等）
+     * @returns Promise<T | undefined> 值或默认值
+     */
+    get<T>(key: string, options?: {
+        defaultValue?: T;
+        privateKey?: CryptoKey;
+    }): Promise<T | undefined>;
+    /**
+     * 移除值
+     * @param key - 键
+     */
+    remove(key: string): void;
+    /**
+     * 清空所有值
+     */
+    clear(): void;
+};
+/**
+ * Cookie操作封装
+ */
+declare const cookie: {
+    /**
+     * 设置Cookie
+     * @param key - 键
+     * @param value - 值
+     * @param options - Cookie选项
+     */
+    set(key: string, value: string, options?: {
+        expires?: number | Date;
+        path?: string;
+        domain?: string;
+        secure?: boolean;
+        sameSite?: "strict" | "lax" | "none";
+    }): void;
+    /**
+     * 获取Cookie
+     * @param key - 键
+     * @returns Cookie值
+     */
+    get(key: string): string | undefined;
+    /**
+     * 移除Cookie
+     * @param key - 键
+     * @param options - Cookie选项
+     */
+    remove(key: string, options?: {
+        path?: string;
+        domain?: string;
+    }): void;
+    /**
+     * 获取所有Cookie
+     * @returns Cookie对象
+     */
+    getAll(): Record<string, string>;
+};
+/**
+ * 统一存储接口（自动选择存储方式，支持RSA加密）
+ */
+declare const storage: {
+    /**
+     * 设置值（优先使用localStorage，失败则使用sessionStorage）
+     * @param key - 键
+     * @param value - 值
+     * @param options - 选项（过期时间、公钥等）
+     * @returns Promise<void>
+     */
+    set<T>(key: string, value: T, options?: {
+        expiry?: number;
+        publicKey?: CryptoKey;
+    }): Promise<void>;
+    /**
+     * 获取值
+     * @param key - 键
+     * @param options - 选项（默认值、私钥等）
+     * @returns Promise<T | undefined> 值或默认值
+     */
+    get<T>(key: string, options?: {
+        defaultValue?: T;
+        privateKey?: CryptoKey;
+    }): Promise<T | undefined>;
+    /**
+     * 移除值
+     * @param key - 键
+     */
+    remove(key: string): void;
+    /**
+     * 清空所有值
+     */
+    clear(): void;
+};
+
+export { type StorageOptions, cookie, getStorageKeyPair, localStorage, sessionStorage, setStorageKeyPair, storage };

package/dist/storage.js

@@ -0,0 +1,33 @@
+'use strict';
+
+var chunkXVUE53T3_js = require('./chunk-XVUE53T3.js');
+require('./chunk-DYBSRI7V.js');
+
+
+
+Object.defineProperty(exports, "cookie", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.cookie; }
+});
+Object.defineProperty(exports, "getStorageKeyPair", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.getStorageKeyPair; }
+});
+Object.defineProperty(exports, "localStorage", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.localStorage; }
+});
+Object.defineProperty(exports, "sessionStorage", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.sessionStorage; }
+});
+Object.defineProperty(exports, "setStorageKeyPair", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.setStorageKeyPair; }
+});
+Object.defineProperty(exports, "storage", {
+  enumerable: true,
+  get: function () { return chunkXVUE53T3_js.storage; }
+});
+//# sourceMappingURL=storage.js.map
+//# sourceMappingURL=storage.js.map

package/dist/storage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"storage.js"}

package/dist/storage.mjs

@@ -0,0 +1,4 @@
+export { cookie, getStorageKeyPair, localStorage, sessionStorage, setStorageKeyPair, storage } from './chunk-HME2N3VY.mjs';
+import './chunk-HLDFI7R2.mjs';
+//# sourceMappingURL=storage.mjs.map
+//# sourceMappingURL=storage.mjs.map

package/dist/storage.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"storage.mjs"}

package/dist/string.d.mts

@@ -0,0 +1,105 @@
+/**
+ * 字符串工具函数
+ */
+/**
+ * 首字母大写
+ * @param str - 输入字符串
+ * @returns 首字母大写的字符串
+ */
+declare function capitalize(str: string): string;
+/**
+ * 驼峰命名转换
+ * @param str - 输入字符串（支持 kebab-case, snake_case, space separated）
+ * @returns 驼峰命名字符串
+ */
+declare function camelCase(str: string): string;
+/**
+ * 短横线命名转换
+ * @param str - 输入字符串
+ * @returns kebab-case 字符串
+ */
+declare function kebabCase(str: string): string;
+/**
+ * 截断字符串
+ * @param str - 输入字符串
+ * @param length - 最大长度
+ * @param suffix - 后缀，默认为 '...'
+ * @returns 截断后的字符串
+ */
+declare function truncate(str: string, length: number, suffix?: string): string;
+/**
+ * 下划线命名转换
+ * @param str - 输入字符串
+ * @returns snake_case 字符串
+ */
+declare function snakeCase(str: string): string;
+/**
+ * 帕斯卡命名转换
+ * @param str - 输入字符串（支持 kebab-case, snake_case, space separated）
+ * @returns PascalCase 字符串
+ */
+declare function pascalCase(str: string): string;
+/**
+ * 字符串脱敏
+ * @param str - 输入字符串
+ * @param options - 脱敏选项
+ * @returns 脱敏后的字符串
+ */
+declare function mask(str: string, options?: {
+    start?: number;
+    end?: number;
+    maskChar?: string;
+}): string;
+/**
+ * 手机号脱敏（默认显示前3位和后4位）
+ * @param phone - 手机号
+ * @returns 脱敏后的手机号
+ */
+declare function maskPhone(phone: string): string;
+/**
+ * 邮箱脱敏（默认显示前2位和@后的域名）
+ * @param email - 邮箱地址
+ * @returns 脱敏后的邮箱
+ */
+declare function maskEmail(email: string): string;
+/**
+ * URL友好的字符串转换（slugify）
+ * @param str - 输入字符串
+ * @returns URL友好的字符串
+ */
+declare function slugify(str: string): string;
+/**
+ * 移除重音符号
+ * @param str - 输入字符串
+ * @returns 移除重音后的字符串
+ */
+declare function removeAccents(str: string): string;
+/**
+ * HTML转义
+ * @param str - 输入字符串
+ * @returns 转义后的字符串
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * HTML反转义
+ * @param str - 输入字符串
+ * @returns 反转义后的字符串
+ */
+declare function unescapeHtml(str: string): string;
+/**
+ * 模板字符串替换
+ * @param template - 模板字符串，使用 {{key}} 作为占位符
+ * @param data - 替换数据对象
+ * @returns 替换后的字符串
+ */
+declare function template(template: string, data: Record<string, unknown>): string;
+/**
+ * 关键词高亮
+ * @param text - 文本内容
+ * @param keyword - 关键词
+ * @param tag - 高亮标签，默认为 'mark'
+ * @returns 高亮后的HTML字符串
+ */
+declare function highlight(text: string, keyword: string, tag?: string): string;
+
+export { camelCase, capitalize, escapeHtml, highlight, kebabCase, mask, maskEmail, maskPhone, pascalCase, removeAccents, slugify, snakeCase, template, truncate, unescapeHtml };

package/dist/string.d.ts

@@ -0,0 +1,105 @@
+/**
+ * 字符串工具函数
+ */
+/**
+ * 首字母大写
+ * @param str - 输入字符串
+ * @returns 首字母大写的字符串
+ */
+declare function capitalize(str: string): string;
+/**
+ * 驼峰命名转换
+ * @param str - 输入字符串（支持 kebab-case, snake_case, space separated）
+ * @returns 驼峰命名字符串
+ */
+declare function camelCase(str: string): string;
+/**
+ * 短横线命名转换
+ * @param str - 输入字符串
+ * @returns kebab-case 字符串
+ */
+declare function kebabCase(str: string): string;
+/**
+ * 截断字符串
+ * @param str - 输入字符串
+ * @param length - 最大长度
+ * @param suffix - 后缀，默认为 '...'
+ * @returns 截断后的字符串
+ */
+declare function truncate(str: string, length: number, suffix?: string): string;
+/**
+ * 下划线命名转换
+ * @param str - 输入字符串
+ * @returns snake_case 字符串
+ */
+declare function snakeCase(str: string): string;
+/**
+ * 帕斯卡命名转换
+ * @param str - 输入字符串（支持 kebab-case, snake_case, space separated）
+ * @returns PascalCase 字符串
+ */
+declare function pascalCase(str: string): string;
+/**
+ * 字符串脱敏
+ * @param str - 输入字符串
+ * @param options - 脱敏选项
+ * @returns 脱敏后的字符串
+ */
+declare function mask(str: string, options?: {
+    start?: number;
+    end?: number;
+    maskChar?: string;
+}): string;
+/**
+ * 手机号脱敏（默认显示前3位和后4位）
+ * @param phone - 手机号
+ * @returns 脱敏后的手机号
+ */
+declare function maskPhone(phone: string): string;
+/**
+ * 邮箱脱敏（默认显示前2位和@后的域名）
+ * @param email - 邮箱地址
+ * @returns 脱敏后的邮箱
+ */
+declare function maskEmail(email: string): string;
+/**
+ * URL友好的字符串转换（slugify）
+ * @param str - 输入字符串
+ * @returns URL友好的字符串
+ */
+declare function slugify(str: string): string;
+/**
+ * 移除重音符号
+ * @param str - 输入字符串
+ * @returns 移除重音后的字符串
+ */
+declare function removeAccents(str: string): string;
+/**
+ * HTML转义
+ * @param str - 输入字符串
+ * @returns 转义后的字符串
+ */
+declare function escapeHtml(str: string): string;
+/**
+ * HTML反转义
+ * @param str - 输入字符串
+ * @returns 反转义后的字符串
+ */
+declare function unescapeHtml(str: string): string;
+/**
+ * 模板字符串替换
+ * @param template - 模板字符串，使用 {{key}} 作为占位符
+ * @param data - 替换数据对象
+ * @returns 替换后的字符串
+ */
+declare function template(template: string, data: Record<string, unknown>): string;
+/**
+ * 关键词高亮
+ * @param text - 文本内容
+ * @param keyword - 关键词
+ * @param tag - 高亮标签，默认为 'mark'
+ * @returns 高亮后的HTML字符串
+ */
+declare function highlight(text: string, keyword: string, tag?: string): string;
+
+export { camelCase, capitalize, escapeHtml, highlight, kebabCase, mask, maskEmail, maskPhone, pascalCase, removeAccents, slugify, snakeCase, template, truncate, unescapeHtml };

package/dist/string.js

@@ -0,0 +1,68 @@
+'use strict';
+
+var chunkD7CS5EKF_js = require('./chunk-D7CS5EKF.js');
+
+
+
+Object.defineProperty(exports, "camelCase", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.camelCase; }
+});
+Object.defineProperty(exports, "capitalize", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.capitalize; }
+});
+Object.defineProperty(exports, "escapeHtml", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.escapeHtml; }
+});
+Object.defineProperty(exports, "highlight", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.highlight; }
+});
+Object.defineProperty(exports, "kebabCase", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.kebabCase; }
+});
+Object.defineProperty(exports, "mask", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.mask; }
+});
+Object.defineProperty(exports, "maskEmail", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.maskEmail; }
+});
+Object.defineProperty(exports, "maskPhone", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.maskPhone; }
+});
+Object.defineProperty(exports, "pascalCase", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.pascalCase; }
+});
+Object.defineProperty(exports, "removeAccents", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.removeAccents; }
+});
+Object.defineProperty(exports, "slugify", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.slugify; }
+});
+Object.defineProperty(exports, "snakeCase", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.snakeCase; }
+});
+Object.defineProperty(exports, "template", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.template; }
+});
+Object.defineProperty(exports, "truncate", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.truncate; }
+});
+Object.defineProperty(exports, "unescapeHtml", {
+  enumerable: true,
+  get: function () { return chunkD7CS5EKF_js.unescapeHtml; }
+});
+//# sourceMappingURL=string.js.map
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"string.js"}

package/dist/string.mjs

@@ -0,0 +1,3 @@
+export { camelCase, capitalize, escapeHtml, highlight, kebabCase, mask, maskEmail, maskPhone, pascalCase, removeAccents, slugify, snakeCase, template, truncate, unescapeHtml } from './chunk-XJTZDXSR.mjs';
+//# sourceMappingURL=string.mjs.map
+//# sourceMappingURL=string.mjs.map

package/dist/string.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"string.mjs"}

package/dist/tracking.d.mts

@@ -0,0 +1,182 @@
+/**
+ * 埋点追踪工具
+ */
+/**
+ * 埋点事件类型
+ */
+type TrackingEventType = 'event' | 'pageview' | 'click' | 'exposure' | 'custom';
+/**
+ * 埋点事件数据
+ */
+interface TrackingEvent {
+    /** 事件类型 */
+    type: TrackingEventType;
+    /** 事件名称 */
+    name: string;
+    /** 事件参数 */
+    params?: Record<string, unknown>;
+    /** 时间戳 */
+    timestamp: number;
+    /** 页面URL */
+    url?: string;
+    /** 用户代理 */
+    userAgent?: string;
+    /** 用户ID */
+    userId?: string;
+    /** 会话ID */
+    sessionId?: string;
+    /** 其他自定义字段 */
+    [key: string]: unknown;
+}
+/**
+ * 埋点配置选项
+ */
+interface TrackerOptions {
+    /** 上报接口URL */
+    endpoint: string;
+    /** 批量上报大小，默认10 */
+    batchSize?: number;
+    /** 批量上报延迟（毫秒），默认3000 */
+    batchDelay?: number;
+    /** 是否自动追踪页面浏览，默认true */
+    autoTrackPageView?: boolean;
+    /** 是否自动追踪点击事件，默认false */
+    autoTrackClick?: boolean;
+    /** 公共参数 */
+    commonParams?: Record<string, unknown>;
+    /** 自定义上报函数 */
+    customSend?: (events: TrackingEvent[]) => Promise<void>;
+    /** 是否启用调试模式，默认false */
+    debug?: boolean;
+}
+/**
+ * 曝光追踪选项
+ */
+interface ExposureOptions {
+    /** 曝光阈值（0-1），元素可见比例达到此值才触发，默认0.5 */
+    threshold?: number;
+    /** 曝光时长（毫秒），元素可见时长达到此值才触发，默认1000 */
+    duration?: number;
+    /** 是否只触发一次，默认true */
+    once?: boolean;
+}
+/**
+ * 埋点追踪器类
+ */
+declare class Tracker {
+    private options;
+    private eventQueue;
+    private batchTimer;
+    private userInfo;
+    private sessionId;
+    private exposureObservers;
+    private exposureTimers;
+    private exposedElements;
+    constructor(options: TrackerOptions);
+    /**
+     * 生成会话ID
+     */
+    private generateSessionId;
+    /**
+     * 获取公共数据
+     */
+    private getCommonData;
+    /**
+     * 添加事件到队列
+     */
+    private enqueue;
+    /**
+     * 安排批量上报
+     */
+    private scheduleBatch;
+    /**
+     * 上报事件
+     */
+    private sendEvents;
+    /**
+     * 发送到上报接口
+     */
+    private sendToEndpoint;
+    /**
+     * 立即上报所有待上报事件
+     */
+    flush(): Promise<void>;
+    /**
+     * 追踪事件
+     */
+    trackEvent(name: string, params?: Record<string, unknown>): void;
+    /**
+     * 追踪页面浏览
+     */
+    trackPageView(params?: Record<string, unknown>): void;
+    /**
+     * 追踪点击事件
+     */
+    trackClick(element: Element | string, params?: Record<string, unknown>): void;
+    /**
+     * 追踪曝光事件
+     */
+    trackExposure(element: Element | string, options?: ExposureOptions, params?: Record<string, unknown>): void;
+    /**
+     * 设置用户信息
+     */
+    setUserInfo(userInfo: Record<string, unknown>): void;
+    /**
+     * 设置公共参数
+     */
+    setCommonParams(params: Record<string, unknown>): void;
+    /**
+     * 设置页面浏览监听器（SPA应用）
+     */
+    private setupPageViewListener;
+    /**
+     * 设置点击事件监听器
+     */
+    private setupClickListener;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
+}
+/**
+ * 创建埋点追踪器实例
+ */
+declare function createTracker(options: TrackerOptions): Tracker;
+/**
+ * 初始化默认追踪器
+ */
+declare function initTracker(options: TrackerOptions): Tracker;
+/**
+ * 获取默认追踪器
+ */
+declare function getTracker(): Tracker;
+/**
+ * 追踪事件（使用默认追踪器）
+ */
+declare function trackEvent(name: string, params?: Record<string, unknown>): void;
+/**
+ * 追踪页面浏览（使用默认追踪器）
+ */
+declare function trackPageView(params?: Record<string, unknown>): void;
+/**
+ * 追踪点击事件（使用默认追踪器）
+ */
+declare function trackClick(element: Element | string, params?: Record<string, unknown>): void;
+/**
+ * 追踪曝光事件（使用默认追踪器）
+ */
+declare function trackExposure(element: Element | string, options?: ExposureOptions, params?: Record<string, unknown>): void;
+/**
+ * 设置用户信息（使用默认追踪器）
+ */
+declare function setUserInfo(userInfo: Record<string, unknown>): void;
+/**
+ * 设置公共参数（使用默认追踪器）
+ */
+declare function setCommonParams(params: Record<string, unknown>): void;
+/**
+ * 立即上报（使用默认追踪器）
+ */
+declare function flush(): Promise<void>;
+
+export { type ExposureOptions, Tracker, type TrackerOptions, type TrackingEvent, type TrackingEventType, createTracker, flush, getTracker, initTracker, setCommonParams, setUserInfo, trackClick, trackEvent, trackExposure, trackPageView };