@alibarbar/common 1.0.0

package/dist/tracking.d.ts

@@ -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 };

package/dist/tracking.js

@@ -0,0 +1,52 @@
+'use strict';
+
+var chunk56W6YECK_js = require('./chunk-56W6YECK.js');
+
+
+
+Object.defineProperty(exports, "Tracker", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.Tracker; }
+});
+Object.defineProperty(exports, "createTracker", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.createTracker; }
+});
+Object.defineProperty(exports, "flush", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.flush; }
+});
+Object.defineProperty(exports, "getTracker", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.getTracker; }
+});
+Object.defineProperty(exports, "initTracker", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.initTracker; }
+});
+Object.defineProperty(exports, "setCommonParams", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.setCommonParams; }
+});
+Object.defineProperty(exports, "setUserInfo", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.setUserInfo; }
+});
+Object.defineProperty(exports, "trackClick", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.trackClick; }
+});
+Object.defineProperty(exports, "trackEvent", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.trackEvent; }
+});
+Object.defineProperty(exports, "trackExposure", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.trackExposure; }
+});
+Object.defineProperty(exports, "trackPageView", {
+  enumerable: true,
+  get: function () { return chunk56W6YECK_js.trackPageView; }
+});
+//# sourceMappingURL=tracking.js.map
+//# sourceMappingURL=tracking.js.map

package/dist/tracking.js.map

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

package/dist/tracking.mjs

@@ -0,0 +1,3 @@
+export { Tracker, createTracker, flush, getTracker, initTracker, setCommonParams, setUserInfo, trackClick, trackEvent, trackExposure, trackPageView } from './chunk-PJ7UCTX4.mjs';
+//# sourceMappingURL=tracking.mjs.map
+//# sourceMappingURL=tracking.mjs.map

package/dist/tracking.mjs.map

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

package/dist/transform.d.mts

@@ -0,0 +1,53 @@
+/**
+ * 数据转换工具函数
+ */
+/**
+ * CSV转JSON
+ * @param csv - CSV字符串
+ * @param options - 选项
+ * @returns JSON对象数组
+ */
+declare function csvToJson<T extends Record<string, unknown> = Record<string, string>>(csv: string, options?: {
+    delimiter?: string;
+    headers?: string[];
+    skipEmptyLines?: boolean;
+}): T[];
+/**
+ * JSON转CSV
+ * @param data - JSON对象数组
+ * @param options - 选项
+ * @returns CSV字符串
+ */
+declare function jsonToCsv<T extends Record<string, unknown>>(data: T[], options?: {
+    delimiter?: string;
+    headers?: string[];
+    includeHeaders?: boolean;
+}): string;
+/**
+ * XML转JSON
+ * @param xml - XML字符串
+ * @returns JSON对象
+ */
+declare function xmlToJson(xml: string): Record<string, unknown>;
+/**
+ * JSON转XML
+ * @param json - JSON对象
+ * @param rootTag - 根标签名，默认为 'root'
+ * @returns XML字符串
+ */
+declare function jsonToXml(json: unknown, rootTag?: string): string;
+/**
+ * YAML转JSON
+ * @param yaml - YAML字符串
+ * @returns JSON对象
+ */
+declare function yamlToJson(yaml: string): unknown;
+/**
+ * JSON转YAML
+ * @param json - JSON对象
+ * @param indent - 缩进空格数，默认为 2
+ * @returns YAML字符串
+ */
+declare function jsonToYaml(json: unknown, indent?: number): string;
+
+export { csvToJson, jsonToCsv, jsonToXml, jsonToYaml, xmlToJson, yamlToJson };

package/dist/transform.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 数据转换工具函数
+ */
+/**
+ * CSV转JSON
+ * @param csv - CSV字符串
+ * @param options - 选项
+ * @returns JSON对象数组
+ */
+declare function csvToJson<T extends Record<string, unknown> = Record<string, string>>(csv: string, options?: {
+    delimiter?: string;
+    headers?: string[];
+    skipEmptyLines?: boolean;
+}): T[];
+/**
+ * JSON转CSV
+ * @param data - JSON对象数组
+ * @param options - 选项
+ * @returns CSV字符串
+ */
+declare function jsonToCsv<T extends Record<string, unknown>>(data: T[], options?: {
+    delimiter?: string;
+    headers?: string[];
+    includeHeaders?: boolean;
+}): string;
+/**
+ * XML转JSON
+ * @param xml - XML字符串
+ * @returns JSON对象
+ */
+declare function xmlToJson(xml: string): Record<string, unknown>;
+/**
+ * JSON转XML
+ * @param json - JSON对象
+ * @param rootTag - 根标签名，默认为 'root'
+ * @returns XML字符串
+ */
+declare function jsonToXml(json: unknown, rootTag?: string): string;
+/**
+ * YAML转JSON
+ * @param yaml - YAML字符串
+ * @returns JSON对象
+ */
+declare function yamlToJson(yaml: string): unknown;
+/**
+ * JSON转YAML
+ * @param json - JSON对象
+ * @param indent - 缩进空格数，默认为 2
+ * @returns YAML字符串
+ */
+declare function jsonToYaml(json: unknown, indent?: number): string;
+
+export { csvToJson, jsonToCsv, jsonToXml, jsonToYaml, xmlToJson, yamlToJson };

package/dist/transform.js

@@ -0,0 +1,32 @@
+'use strict';
+
+var chunkZDMFMUDR_js = require('./chunk-ZDMFMUDR.js');
+
+
+
+Object.defineProperty(exports, "csvToJson", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.csvToJson; }
+});
+Object.defineProperty(exports, "jsonToCsv", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.jsonToCsv; }
+});
+Object.defineProperty(exports, "jsonToXml", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.jsonToXml; }
+});
+Object.defineProperty(exports, "jsonToYaml", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.jsonToYaml; }
+});
+Object.defineProperty(exports, "xmlToJson", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.xmlToJson; }
+});
+Object.defineProperty(exports, "yamlToJson", {
+  enumerable: true,
+  get: function () { return chunkZDMFMUDR_js.yamlToJson; }
+});
+//# sourceMappingURL=transform.js.map
+//# sourceMappingURL=transform.js.map

package/dist/transform.js.map

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

package/dist/transform.mjs

@@ -0,0 +1,3 @@
+export { csvToJson, jsonToCsv, jsonToXml, jsonToYaml, xmlToJson, yamlToJson } from './chunk-7E6GELHJ.mjs';
+//# sourceMappingURL=transform.mjs.map
+//# sourceMappingURL=transform.mjs.map

package/dist/transform.mjs.map

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

package/dist/upload-DzlQtUBc.d.mts

@@ -0,0 +1,202 @@
+/**
+ * 文件上传相关类型定义
+ */
+/**
+ * 上传初始化请求参数
+ */
+interface UploadInitRequest {
+    fileName: string;
+    fileSize: number;
+    fileMd5: string;
+    chunkSize?: number;
+}
+/**
+ * 上传初始化响应
+ */
+interface UploadInitResponse {
+    taskId: string;
+    totalChunks: number;
+    existingChunks: number[];
+    instantUpload: boolean;
+    fileUrl?: string;
+    chunkSize: number;
+}
+/**
+ * 分片上传响应
+ */
+interface ChunkUploadResponse {
+    chunkIndex: number;
+    success: boolean;
+    message: string;
+    chunkMd5: string;
+}
+/**
+ * 完成上传响应
+ */
+interface CompleteUploadResponse {
+    taskId: string;
+    fileUrl: string;
+    fileName: string;
+    fileSize: number;
+    fileMd5: string;
+    success: boolean;
+    message: string;
+}
+/**
+ * 上传进度信息
+ */
+interface UploadProgress {
+    taskId: string;
+    fileName: string;
+    fileSize: number;
+    totalChunks: number;
+    uploadedChunks: number;
+    percentage: number;
+    status: string;
+    uploadedSize: number;
+}
+/**
+ * API响应包装类型
+ */
+interface ApiResponse<T> {
+    code: number;
+    message: string;
+    data: T;
+    timestamp: number;
+}
+/**
+ * 上传配置选项
+ */
+interface UploadOptions {
+    /** 分片大小（字节），默认 2MB */
+    chunkSize?: number;
+    /** 并发上传数量，默认 3 */
+    concurrency?: number;
+    /** 重试次数，默认 3 */
+    retryCount?: number;
+    /** 重试延迟（毫秒），默认 1000 */
+    retryDelay?: number;
+    /** 基础API地址 */
+    baseURL?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 上传进度回调 */
+    onProgress?: (progress: UploadProgress) => void;
+    /** 上传完成回调 */
+    onComplete?: (result: CompleteUploadResponse) => void;
+    /** 上传错误回调 */
+    onError?: (error: Error) => void;
+}
+/**
+ * 上传状态
+ */
+declare enum UploadStatus {
+    PENDING = "pending",
+    UPLOADING = "uploading",
+    PAUSED = "paused",
+    COMPLETED = "completed",
+    FAILED = "failed",
+    CANCELLED = "cancelled"
+}
+/**
+ * 文件分片信息
+ */
+interface ChunkInfo {
+    index: number;
+    start: number;
+    end: number;
+    blob: Blob;
+    md5?: string;
+}
+
+/**
+ * 文件分片上传工具类
+ * 支持分片上传、断点续传、进度追踪
+ */
+
+/**
+ * 文件上传器类
+ */
+declare class ChunkUploader {
+    private file;
+    private options;
+    private taskId;
+    private chunks;
+    private uploadedChunks;
+    private status;
+    private abortController;
+    constructor(file: File, options?: UploadOptions);
+    /**
+     * 初始化上传
+     */
+    private initUpload;
+    /**
+     * 计算文件MD5（简化版，实际应该使用spark-md5等库）
+     */
+    private calculateFileMD5;
+    /**
+     * 准备分片
+     */
+    private prepareChunks;
+    /**
+     * 获取已上传的分片列表
+     */
+    private getUploadedChunks;
+    /**
+     * 上传单个分片
+     */
+    private uploadChunk;
+    /**
+     * 并发上传分片
+     */
+    private uploadChunksConcurrently;
+    /**
+     * 完成上传
+     */
+    private completeUpload;
+    /**
+     * 更新上传进度
+     */
+    private updateProgress;
+    /**
+     * 开始上传
+     */
+    upload(): Promise<CompleteUploadResponse>;
+    /**
+     * 暂停上传
+     */
+    pause(): void;
+    /**
+     * 恢复上传
+     */
+    resume(): Promise<CompleteUploadResponse>;
+    /**
+     * 取消上传
+     */
+    cancel(): Promise<void>;
+    /**
+     * 获取当前状态
+     */
+    getStatus(): UploadStatus;
+    /**
+     * 获取任务ID
+     */
+    getTaskId(): string | null;
+    /**
+     * HTTP请求封装
+     */
+    private request;
+    /**
+     * 延迟函数
+     */
+    private delay;
+}
+/**
+ * 创建文件上传器实例
+ * @param file - 文件对象
+ * @param options - 上传配置选项
+ * @returns 上传器实例
+ */
+declare function createUploader(file: File, options?: UploadOptions): ChunkUploader;
+
+export { type ApiResponse as A, ChunkUploader as C, type UploadInitRequest as U, type UploadInitResponse as a, type ChunkUploadResponse as b, createUploader as c, type CompleteUploadResponse as d, type UploadProgress as e, type UploadOptions as f, UploadStatus as g, type ChunkInfo as h };