trackswap 0.0.2 → 0.0.3

package/dist/FIT/base.d.ts

@@ -1,47 +1,23 @@
 import { IPlugin } from "../core/base.js";
 import { FITContext, FITDecoderMesgs, FITFileType } from "./types.js";
-/**
- * FIT 消息转换器插件接口
- */
 export interface IFITMessageConverter extends IPlugin<FITContext> {
-    /** 支持的消息类型 */
     supportedMessageTypes: string[];
-    /** 转换消息 */
     convertMessages(messages: any[], context: FITContext): any;
-    /** 是否支持该消息类型 */
     supports(messageType: string): boolean;
-    /** 优先级 */
     priority?: number;
 }
-/**
- * FIT 数据结构化插件接口
- */
 export interface IFITStructurePlugin extends IPlugin<FITContext> {
-    /** 结构化数据 */
     structureData(messages: FITDecoderMesgs, context: FITContext): Partial<FITFileType>;
-    /** 优先级 */
     priority?: number;
 }
-/**
- * FIT 中间件插件接口
- */
 export interface IFITMiddlewarePlugin extends IPlugin<FITContext> {
-    /** 优先级 */
     priority?: number;
-    /** 在解析阶段执行 */
     onParse?(buffer: Buffer, context: FITContext): Promise<Buffer> | Buffer;
-    /** 在消息提取阶段执行 */
     onExtractMessages?(messages: FITDecoderMesgs, context: FITContext): Promise<FITDecoderMesgs> | FITDecoderMesgs;
-    /** 在数据结构化阶段执行 */
     onStructure?(result: Partial<FITFileType>, context: FITContext): Promise<Partial<FITFileType>> | Partial<FITFileType>;
-    /** 在完成阶段执行 */
     onComplete?(result: FITFileType, context: FITContext): Promise<FITFileType> | FITFileType;
-    /** 错误处理 */
     onError?(error: Error, context: FITContext): Promise<void> | void;
 }
-/**
- * FIT 消息转换器基类
- */
 export declare abstract class BaseFITMessageConverter implements IFITMessageConverter {
     abstract name: string;
     abstract supportedMessageTypes: string[];
@@ -60,9 +36,6 @@ export declare abstract class BaseFITMessageConverter implements IFITMessageConv
         records: any[];
     }>;
 }
-/**
- * FIT 数据结构化插件基类
- */
 export declare abstract class BaseFITStructurePlugin implements IFITStructurePlugin {
     abstract name: string;
     version: string;
@@ -72,9 +45,6 @@ export declare abstract class BaseFITStructurePlugin implements IFITStructurePlu
     destroy(context: FITContext): Promise<void>;
     validate(context: FITContext): Promise<boolean>;
 }
-/**
- * FIT 中间件基类
- */
 export declare abstract class BaseFITMiddleware implements IFITMiddlewarePlugin {
     abstract name: string;
     version: string;

package/dist/FIT/decoder.d.ts

@@ -1,8 +1,5 @@
 import { IFITMessageConverter, IFITStructurePlugin, IFITMiddlewarePlugin } from "./base.js";
 import { FITFileType } from "./types.js";
-/**
- * FIT 解码器 - 遵循 GPX 风格的插件架构
- */
 export declare class FITDecoder {
     private converterPlugins;
     private registeredPlugins;
@@ -12,65 +9,20 @@ export declare class FITDecoder {
     private initialized;
     private defaultPluginsRegistered;
     constructor();
-    /**
-     * 初始化流水线 - 注册固定的核心处理器
-     */
     private initializePipeline;
-    /**
-     * 自动注册默认插件
-     */
     private registerDefaultPlugins;
-    /**
-     * 为指定消息类型添加转换器，按优先级排序
-     */
     private addConverterForMessageType;
-    /**
-     * 添加结构化插件
-     */
     private addStructurePlugin;
-    /**
-     * 注册消息转换器插件
-     */
     registerMessageConverter(plugin: IFITMessageConverter): Promise<void>;
-    /**
-     * 注册结构化插件
-     */
     registerStructurePlugin(plugin: IFITStructurePlugin): Promise<void>;
-    /**
-     * 注册中间件插件
-     */
     registerMiddleware(plugin: IFITMiddlewarePlugin): Promise<void>;
-    /**
-     * 获取消息类型转换器（返回优先级最高的）
-     */
     getConverter(messageType: string): IFITMessageConverter | undefined;
-    /**
-     * 获取指定消息类型的所有转换器（按优先级排序）
-     */
     getConverters(messageType: string): IFITMessageConverter[];
-    /**
-     * 移除插件
-     */
     unregisterPlugin(pluginName: string): boolean;
-    /**
-     * 初始化解码器
-     */
     initialize(): Promise<void>;
-    /**
-     * 销毁解码器
-     */
     destroy(): Promise<void>;
-    /**
-     * 创建解码上下文
-     */
     private createContext;
-    /**
-     * 执行中间件钩子
-     */
     private executeMiddlewareHook;
-    /**
-     * 主解析方法 - 固定的流水线 + 灵活的中间件
-     */
     parseByBuffer(buffer: Buffer, options?: {
         skipValidation?: boolean;
         enableStats?: boolean;

package/dist/FIT/encoder.d.ts

@@ -1,139 +1,42 @@
 import { FITFileType } from "./types.js";
-/**
- * FIT 编码器选项
- */
 export interface FITEncoderOptions {
-    /** 是否启用紧凑模式 */
     compact?: boolean;
-    /** 默认运动类型 */
     defaultSport?: string;
-    /** 默认子运动类型 */
     defaultSubSport?: string;
 }
-/**
- * FIT 编码器 - 将 FITFileType 数据编码为 FIT 二进制格式
- */
 export declare class FITEncoder {
     private localNum;
     private mesgDefn;
     private messages;
     private options;
-    /**
-     * 构造函数
-     * @param options 编码器选项
-     */
     constructor(options?: FITEncoderOptions);
-    /**
-     * 编码 FIT 数据为 Buffer - Activity 文件类型
-     */
     encode(fitData: FITFileType): Promise<Buffer>;
-    /**
-     * 编码 FIT 数据为 Buffer - Course 文件类型
-     */
     encodeCourse(fitData: FITFileType): Promise<Buffer>;
-    /**
-     * 编码 FIT 数据为 Blob
-     */
     encodeToBlob(fitData: FITFileType, fileType?: "activity" | "course"): Promise<Blob>;
-    /**
-     * 重置编码器状态
-     */
     private reset;
-    /**
-     * 构建 FIT 文件内容
-     */
     private buildFITContent;
-    /**
-     * 构建 Activity 文件内容
-     */
     private buildActivityContent;
-    /**
-     * 构建 Course 文件内容
-     */
     private buildCourseContent;
-    /**
-     * 构建文件ID
-     */
     private buildFileId;
-    /**
-     * 构建Session
-     */
     private buildSession;
-    /**
-     * 构建Laps
-     */
     private buildLaps;
-    /**
-     * 构建单个Lap
-     */
     private buildLap;
-    /**
-     * 构建Records
-     */
     private buildRecords;
-    /**
-     * 构建单个Record
-     */
     private buildRecord;
-    /**
-     * 构建Event
-     */
     private buildEvent;
-    /**
-     * 构建Activity
-     */
     private buildActivity;
-    /**
-     * 构建Course
-     */
     private buildCourse;
-    /**
-     * 从Laps构建Events
-     */
     private buildEventsFromLaps;
-    /**
-     * 从Session构建Activity
-     */
     private buildActivityFromSession;
-    /**
-     * 解析时间戳
-     */
     private parseTimestamp;
-    /**
-     * 转换坐标为半圆单位
-     */
     private convertToSemicircles;
-    /**
-     * 验证必要字段
-     */
     private validateRequiredFields;
-    /**
-     * 写入消息
-     */
     private writeMesg;
-    /**
-     * 获取Blob对象
-     */
     get blob(): Blob;
-    /**
-     * 获取数据长度
-     */
     get dataLen(): number;
-    /**
-     * 获取数据CRC
-     */
     get dataCrc(): number;
-    /**
-     * 获取文件头
-     */
     get header(): ArrayBuffer;
-    /**
-     * 获取文件尾
-     */
     get trailer(): ArrayBuffer;
-    /**
-     * @deprecated 使用 encode() 替代
-     */
     encoder(fitData: FITFileType): Promise<Buffer>;
 }
 declare const _default: {

package/dist/FIT/mesg.d.ts

@@ -29,9 +29,6 @@ export declare class Mesg {
     constructor(localNum: number, mesgName: string, values: {
         [key: string]: any;
     });
-    /**
-     * 获取 defns，并获取了 size
-     */
     get mesgDefn(): ProcessedMesgDefn;
     isSameDefn(mesgDefn: ProcessedMesgDefn): boolean;
     get defnRecord(): ArrayBuffer;

package/dist/FIT/middleware.d.ts

@@ -1,8 +1,5 @@
 import { BaseFITMiddleware } from "./base.js";
 import { FITDecoderMesgs, FITFileType, FITContext } from "./types.js";
-/**
- * 性能监控中间件
- */
 export declare class PerformanceMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
@@ -15,34 +12,22 @@ export declare class PerformanceMiddleware extends BaseFITMiddleware {
     private analyzeStructure;
     private getSummary;
 }
-/**
- * 数据验证中间件
- */
 export declare class ValidationMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onComplete(result: FITFileType, context: FITContext): Promise<FITFileType>;
     private validateFIT;
 }
-/**
- * 数据清理中间件
- */
 export declare class DataCleanupMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onStructure(result: Partial<FITFileType>, context: FITContext): Promise<Partial<FITFileType>>;
     private cleanupData;
 }
-/**
- * 文件信息提取中间件
- */
 export declare class FileInfoMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onExtractMessages(messages: FITDecoderMesgs, context: FITContext): Promise<FITDecoderMesgs>;
     private extractFileInfo;
 }
-/**
- * 注册所有默认中间件
- */
 export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;

package/dist/FIT/plugins.d.ts

@@ -1,24 +1,15 @@
 import { BaseFITStructurePlugin } from "./base.js";
 import { FITDecoderMesgs, FITFileType, FITContext } from "./types.js";
-/**
- * Session 数据结构化插件
- */
 export declare class SessionStructurePlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;
     structureData(messages: FITDecoderMesgs, context: FITContext): Partial<FITFileType>;
 }
-/**
- * Course 数据结构化插件
- */
 export declare class CourseStructurePlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;
     structureData(messages: FITDecoderMesgs, context: FITContext): Partial<FITFileType>;
 }
-/**
- * 文件头信息提取插件
- */
 export declare class FileHeaderPlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;

package/dist/FIT/processor.d.ts

@@ -1,58 +1,34 @@
 import { IFITMessageConverter, IFITStructurePlugin } from "./base.js";
 import { FITContext } from "./types.js";
-/**
- * FIT 流水线阶段
- */
 export declare enum FITPipelineStage {
     PARSE = "parse",
     EXTRACT = "extract",
     STRUCTURE = "structure",
     COMPLETE = "complete"
 }
-/**
- * FIT 流水线处理器接口
- */
 export interface IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
 }
-/**
- * Parse处理器 - 解析二进制FIT数据为消息
- */
 export declare class ParseProcessor implements IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
-    /**
-     * 使用 FIT SDK 解析二进制数据
-     */
     private parseWithFitSDK;
 }
-/**
- * Extract处理器 - 提取和转换消息
- */
 export declare class ExtractProcessor implements IFITPipelineProcessor {
     private getConverters;
     stage: FITPipelineStage;
     constructor(getConverters: (messageType: string) => IFITMessageConverter[]);
     process(context: FITContext): Promise<FITContext>;
 }
-/**
- * Structure处理器 - 数据结构化
- */
 export declare class StructureProcessor implements IFITPipelineProcessor {
     private getStructurePlugins;
     stage: FITPipelineStage;
     constructor(getStructurePlugins: () => IFITStructurePlugin[]);
     process(context: FITContext): Promise<FITContext>;
 }
-/**
- * Complete处理器 - 最终处理和清理
- */
 export declare class CompleteProcessor implements IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
-    /**
-     * 计算消息总数
-     */
     private countTotalMessages;
 }

package/dist/FIT/types/mesg_num.d.ts

@@ -1,105 +1,105 @@
 export declare enum MesgNum {
-    FILE_ID = 0,// 文件标识
-    CAPABILITIES = 1,// 设备能力
-    DEVICE_SETTINGS = 2,// 设备设置
-    USER_PROFILE = 3,// 用户档案
-    HRM_PROFILE = 4,// 心率监测器档案
-    SDM_PROFILE = 5,// 速度距离监测器档案
-    BIKE_PROFILE = 6,// 自行车档案
-    ZONES_TARGET = 7,// 区间目标
-    HR_ZONE = 8,// 心率区间
-    POWER_ZONE = 9,// 功率区间
-    MET_ZONE = 10,// 代谢当量区间
-    SPORT = 12,// 运动类型
-    GOAL = 15,// 目标
-    SESSION = 18,// 运动段
-    LAP = 19,// 计圈
-    RECORD = 20,// 记录点
-    EVENT = 21,// 事件
-    DEVICE_INFO = 23,// 设备信息
-    WORKOUT = 26,// 训练
-    WORKOUT_STEP = 27,// 训练步骤
-    SCHEDULE = 28,// 日程安排
-    WEIGHT_SCALE = 30,// 体重秤
-    COURSE = 31,// 路线
-    COURSE_POINT = 32,// 路线点
-    TOTALS = 33,// 总计
-    ACTIVITY = 34,// 活动
-    SOFTWARE = 35,// 软件
-    FILE_CAPABILITIES = 37,// 文件能力
-    MESG_CAPABILITIES = 38,// 消息能力
-    FIELD_CAPABILITIES = 39,// 字段能力
-    FILE_CREATOR = 49,// 文件创建者
-    BLOOD_PRESSURE = 51,// 血压
-    SPEED_ZONE = 53,// 速度区间
-    MONITORING = 55,// 监测
-    TRAINING_FILE = 72,// 训练文件
-    HRV = 78,// 心率变异性
-    ANT_RX = 80,// ANT接收
-    ANT_TX = 81,// ANT发送
-    ANT_CHANNEL_ID = 82,// ANT通道ID
-    LENGTH = 101,// 长度
-    MONITORING_INFO = 103,// 监测信息
-    PAD = 105,// 填充
-    SLAVE_DEVICE = 106,// 从设备
-    CONNECTIVITY = 127,// 连接性
-    WEATHER_CONDITIONS = 128,// 天气状况
-    WEATHER_ALERT = 129,// 天气预警
-    CADENCE_ZONE = 131,// 步频区间
-    HR = 132,// 心率
-    SEGMENT_LAP = 142,// 段落计圈
-    MEMO_GLOB = 145,// 备忘录
-    SEGMENT_ID = 148,// 段落ID
-    SEGMENT_LEADERBOARD_ENTRY = 149,// 段落排行榜条目
-    SEGMENT_POINT = 150,// 段落点
-    SEGMENT_FILE = 151,// 段落文件
-    WORKOUT_SESSION = 158,// 训练段
-    WATCHFACE_SETTINGS = 159,// 表盘设置
-    GPS_METADATA = 160,// GPS元数据
-    CAMERA_EVENT = 161,// 相机事件
-    TIMESTAMP_CORRELATION = 162,// 时间戳关联
-    GYROSCOPE_DATA = 164,// 陀螺仪数据
-    ACCELEROMETER_DATA = 165,// 加速度计数据
-    THREE_D_SENSOR_CALIBRATION = 167,// 3D传感器校准
-    VIDEO_FRAME = 169,// 视频帧
-    OBDII_DATA = 174,// OBD-II数据
-    NMEA_SENTENCE = 177,// NMEA语句
-    AVIATION_ATTITUDE = 178,// 航空姿态
-    VIDEO = 184,// 视频
-    VIDEO_TITLE = 185,// 视频标题
-    VIDEO_DESCRIPTION = 186,// 视频描述
-    VIDEO_CLIP = 187,// 视频片段
-    SET = 225,// 组
-    JUMP = 285,// 跳跃
-    CLIMB_PRO = 317,// 攀爬专业
-    FIELD_DESCRIPTION = 206,// 字段描述
-    DEVELOPER_DATA_ID = 207,// 开发者数据ID
-    MAGNETOMETER_DATA = 208,// 磁力计数据
-    BAROMETER_DATA = 209,// 气压计数据
-    ONE_D_SENSOR_CALIBRATION = 210,// 1D传感器校准
-    MONITORING_HR_DATA = 211,// 心率监测数据
-    TIME_IN_ZONE = 216,// 区间时间
-    DIVE_SETTINGS = 258,// 潜水设置
-    DIVE_GAS = 259,// 潜水气体
-    DIVE_ALARM = 262,// 潜水警报
-    EXERCISE_TITLE = 264,// 运动标题
-    DIVE_SUMMARY = 268,// 潜水总结
-    SPLIT = 312,// 分段
-    SPLIT_SUMMARY = 313,// 分段总结
-    HSA_BODY_BATTERY_DATA = 314,// 身体电量数据
-    HSA_EVENT = 315,// HSA事件
-    TANK_UPDATE = 319,// 水箱更新
-    TANK_SUMMARY = 323,// 水箱总结
-    SLEEP_ASSESSMENT = 346,// 睡眠评估
-    HRV_STATUS_SUMMARY = 370,// 心率变异性状态总结
-    HRV_VALUE = 371,// 心率变异性值
-    RAW_BBI = 372,// 原始心跳间隔
-    DEVICE_AUX_BATTERY_INFO = 375,// 设备辅助电池信息
-    HSA_GYROSCOPE_DATA = 376,// HSA陀螺仪数据
-    CHRONO_SHOT_SESSION = 387,// 计时拍摄会话
-    CHRONO_SHOT_DATA = 388,// 计时拍摄数据
-    HSA_CONFIGURATION_DATA = 389,// HSA配置数据
-    DIVE_APNEA_ALARM = 393,// 屏息潜水警报
-    SKIN_TEMP_OVERNIGHT = 398,// 夜间皮肤温度
+    FILE_ID = 0,
+    CAPABILITIES = 1,
+    DEVICE_SETTINGS = 2,
+    USER_PROFILE = 3,
+    HRM_PROFILE = 4,
+    SDM_PROFILE = 5,
+    BIKE_PROFILE = 6,
+    ZONES_TARGET = 7,
+    HR_ZONE = 8,
+    POWER_ZONE = 9,
+    MET_ZONE = 10,
+    SPORT = 12,
+    GOAL = 15,
+    SESSION = 18,
+    LAP = 19,
+    RECORD = 20,
+    EVENT = 21,
+    DEVICE_INFO = 23,
+    WORKOUT = 26,
+    WORKOUT_STEP = 27,
+    SCHEDULE = 28,
+    WEIGHT_SCALE = 30,
+    COURSE = 31,
+    COURSE_POINT = 32,
+    TOTALS = 33,
+    ACTIVITY = 34,
+    SOFTWARE = 35,
+    FILE_CAPABILITIES = 37,
+    MESG_CAPABILITIES = 38,
+    FIELD_CAPABILITIES = 39,
+    FILE_CREATOR = 49,
+    BLOOD_PRESSURE = 51,
+    SPEED_ZONE = 53,
+    MONITORING = 55,
+    TRAINING_FILE = 72,
+    HRV = 78,
+    ANT_RX = 80,
+    ANT_TX = 81,
+    ANT_CHANNEL_ID = 82,
+    LENGTH = 101,
+    MONITORING_INFO = 103,
+    PAD = 105,
+    SLAVE_DEVICE = 106,
+    CONNECTIVITY = 127,
+    WEATHER_CONDITIONS = 128,
+    WEATHER_ALERT = 129,
+    CADENCE_ZONE = 131,
+    HR = 132,
+    SEGMENT_LAP = 142,
+    MEMO_GLOB = 145,
+    SEGMENT_ID = 148,
+    SEGMENT_LEADERBOARD_ENTRY = 149,
+    SEGMENT_POINT = 150,
+    SEGMENT_FILE = 151,
+    WORKOUT_SESSION = 158,
+    WATCHFACE_SETTINGS = 159,
+    GPS_METADATA = 160,
+    CAMERA_EVENT = 161,
+    TIMESTAMP_CORRELATION = 162,
+    GYROSCOPE_DATA = 164,
+    ACCELEROMETER_DATA = 165,
+    THREE_D_SENSOR_CALIBRATION = 167,
+    VIDEO_FRAME = 169,
+    OBDII_DATA = 174,
+    NMEA_SENTENCE = 177,
+    AVIATION_ATTITUDE = 178,
+    VIDEO = 184,
+    VIDEO_TITLE = 185,
+    VIDEO_DESCRIPTION = 186,
+    VIDEO_CLIP = 187,
+    SET = 225,
+    JUMP = 285,
+    CLIMB_PRO = 317,
+    FIELD_DESCRIPTION = 206,
+    DEVELOPER_DATA_ID = 207,
+    MAGNETOMETER_DATA = 208,
+    BAROMETER_DATA = 209,
+    ONE_D_SENSOR_CALIBRATION = 210,
+    MONITORING_HR_DATA = 211,
+    TIME_IN_ZONE = 216,
+    DIVE_SETTINGS = 258,
+    DIVE_GAS = 259,
+    DIVE_ALARM = 262,
+    EXERCISE_TITLE = 264,
+    DIVE_SUMMARY = 268,
+    SPLIT = 312,
+    SPLIT_SUMMARY = 313,
+    HSA_BODY_BATTERY_DATA = 314,
+    HSA_EVENT = 315,
+    TANK_UPDATE = 319,
+    TANK_SUMMARY = 323,
+    SLEEP_ASSESSMENT = 346,
+    HRV_STATUS_SUMMARY = 370,
+    HRV_VALUE = 371,
+    RAW_BBI = 372,
+    DEVICE_AUX_BATTERY_INFO = 375,
+    HSA_GYROSCOPE_DATA = 376,
+    CHRONO_SHOT_SESSION = 387,
+    CHRONO_SHOT_DATA = 388,
+    HSA_CONFIGURATION_DATA = 389,
+    DIVE_APNEA_ALARM = 393,
+    SKIN_TEMP_OVERNIGHT = 398,
     HSA_WRIST_TEMPERATURE_DATA = 409
 }