trackswap 0.0.2 → 0.0.4

package/dist/GPX/types.d.ts

@@ -1,8 +1,5 @@
 import { DegreesType, ExtensionsType, LatitudeType, LongitudeType, Token, TokenAST } from "../types.js";
 import { IProcessingContext } from "../core/base.js";
-/**
- * Two lat/lon pairs defining the extent of an element.
- */
 export interface BoundsType {
     minlat?: LatitudeType;
     minlon?: LongitudeType;
@@ -23,27 +20,12 @@ export interface EmailType {
     id?: string;
     domain?: string;
 }
-/**
- * Type of GPS fix. none means GPS had no fix. To signify "the fix info is unknown, leave out fixType entirely. pps = military signal used
- */
 type FixType = "none" | "2d" | "3d" | "dgps" | "pps" | string;
 export type LinkType = {
-    /**
-     * URL of hyperlink.
-     */
     href?: string;
-    /**
-     * Text of hyperlink.
-     */
     text?: string;
-    /**
-     * Mime type of content (image/jpeg)
-     */
     type?: string;
 };
-/**
- * GPX 1.1 version type
- */
 export interface GPX11Type {
     version?: string;
     creator?: string;
@@ -61,9 +43,6 @@ export interface GPX11Type {
 export interface MetadataType {
     name?: string;
     desc?: string;
-    /**
-     * The person or organization who created the GPX file.
-     */
     author?: PersonType;
     copyright?: CopyrightType;
     link?: LinkType[];
@@ -73,126 +52,39 @@ export interface MetadataType {
     extensions?: ExtensionsType;
     [key: string]: any;
 }
-/**
- * A list of waypoints.
- */
 export interface WptType {
     lat: LatitudeType;
     lon: LongitudeType;
-    /**
-     * Elevation (in meters) of the point.
-     */
     ele?: number;
-    /**
-     * Creation/modification timestamp for element. Date and time in are in Univeral Coordinated Time (UTC), not local time! Conforms to ISO 8601 specification for date/time representation. Fractional seconds are allowed for millisecond timing in tracklogs.
-     */
     time?: Date;
-    /**
-     * Instantaneous speed at the point (meters per second)
-     */
     speed?: number;
-    /**
-     * Instantaneous course at the point (degrees, true north)
-     */
     course?: number;
-    /**
-     * Magnetic variation (in degrees) at the point
-     */
     magvar?: DegreesType;
-    /**
-     * Height (in meters) of geoid (mean sea level) above WGS84 earth ellipsoid. As defined in NMEA GGA message.
-     */
     geoidheight?: number;
-    /**
-     * The GPS name of the waypoint. This field will be transferred to and from the GPS. GPX does not place restrictions on the length of this field or the characters contained in it. It is up to the receiving application to validate the field before sending it to the GPS.
-     */
     name?: string;
-    /**
-     * GPS waypoint comment. Sent to GPS as comment.
-     */
     cmt?: string;
-    /**
-     * A text description of the element. Holds additional information about the element intended for the user, not the GPS.
-     */
     desc?: string;
-    /**
-     * Source of data. Included to give user some idea of reliability and accuracy of data. "Garmin eTrex", "USGS quad Boston North", e.g.
-     */
     src?: string;
-    /**
-     * Link to additional information about the waypoint.
-     */
     link?: LinkType[];
-    /**
-     * Text of GPS symbol name. For interchange with other programs, use the exact spelling of the symbol as displayed on the GPS. If the GPS abbreviates words, spell them out.
-     */
     sym?: string;
-    /**
-     * Type (classification) of the waypoint.
-     */
     type?: string;
     fix?: FixType;
-    /**
-     * Number of satellites used to calculate the GPX fix.
-     */
     sat?: string;
-    /**
-     * Horizontal dilution of precision.
-     */
     hdop?: number;
-    /**
-     * Vertical dilution of precision.
-     */
     vdop?: number;
-    /**
-     * Position dilution of precision.
-     */
     pdop?: number;
-    /**
-     * Number of seconds since last DGPS update.
-     */
     ageofdgpsdata?: number;
-    /**
-     * ID of DGPS station used in differential correction.
-     */
     dgpsid?: DegreesType;
-    /**
-     * You can add extend GPX by adding your own elements from another schema here.
-     */
     extensions?: ExtensionsType;
 }
-/**
- * A list of route points.
- */
 type RteptType = WptType;
 export interface RteType {
-    /**
-     * GPS name of route.
-     */
     name?: string;
-    /**
-     * GPS comment for route.
-     */
     cmt?: string;
-    /**
-     * Text description of route for user. Not sent to GPS.
-     */
     desc?: string;
-    /**
-     * Source of data. Included to give user some idea of reliability and accuracy of data.
-     */
     src?: string;
-    /**
-     * Links to external information about the route.
-     */
     link?: LinkType[];
-    /**
-     * GPS route number.
-     */
     number?: number;
-    /**
-     * Type (classification) of route.
-     */
     type?: string;
     extensions?: ExtensionsType;
     rtept?: RteptType[];

package/dist/TCX/base.d.ts

@@ -1,52 +1,19 @@
 import { IPlugin, IConverterPlugin, IMiddlewarePlugin, BaseConverter, BaseMiddleware } from "../core/base.js";
 import { TCXContext, TCXFileType } from "./types.js";
-/**
- * TCX 插件接口（继承通用插件接口）
- */
 export interface ITCXPlugin extends IPlugin<TCXContext> {
 }
-/**
- * TCX 转换器插件接口（继承通用转换器接口）
- */
 export interface ITCXConverterPlugin extends IConverterPlugin<TCXContext> {
 }
-/**
- * TCX 中间件插件接口（继承通用中间件接口）
- */
 export interface ITCXMiddlewarePlugin extends IMiddlewarePlugin<TCXContext, TCXFileType> {
 }
-/**
- * TCX 基础转换器抽象类（继承通用基础转换器）
- */
 export declare abstract class BaseTCXConverter extends BaseConverter<TCXContext> implements ITCXConverterPlugin {
-    /**
-     * 解析 TCX 心率值
-     */
     protected parseHeartRate(value: string | number | undefined): number | undefined;
-    /**
-     * 解析 TCX 时间格式（ISO 8601）
-     */
     protected parseTCXTime(value: string | undefined): Date | undefined;
-    /**
-     * 解析 TCX 距离值（米）
-     */
     protected parseDistance(value: string | number | undefined): number | undefined;
-    /**
-     * 解析 TCX 速度值（m/s）
-     */
     protected parseSpeed(value: string | number | undefined): number | undefined;
-    /**
-     * 解析 TCX 海拔值（米）
-     */
     protected parseAltitude(value: string | number | undefined): number | undefined;
-    /**
-     * 解析 TCX 坐标值（纬度/经度）
-     */
     protected parseCoordinate(value: string | number | undefined): number | undefined;
 }
-/**
- * TCX 基础中间件抽象类（继承通用基础中间件）
- */
 export declare abstract class BaseTCXMiddleware extends BaseMiddleware<TCXContext, TCXFileType> implements ITCXMiddlewarePlugin {
     onError(error: Error, context: TCXContext): Promise<void>;
 }

package/dist/TCX/converters.d.ts

@@ -1,17 +1,11 @@
 import { TokenAST } from "../types.js";
 import { BaseTCXConverter } from "./base.js";
 import { TCXContext, ActivityType, ActivityLapType, TrackType, TrackpointType, PositionType, ActivityListType, MultiSportSessionType, AbstractSourceType } from "./types.js";
-/**
- * 位置转换器
- */
 export declare class PositionConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: TCXContext): PositionType | undefined;
 }
-/**
- * 轨迹点转换器
- */
 export declare class TrackpointConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
@@ -19,17 +13,11 @@ export declare class TrackpointConverter extends BaseTCXConverter {
     protected convertExtensions(extensionsAST: TokenAST): any;
     protected convertExtensionContent(extension: TokenAST): any;
 }
-/**
- * 轨迹转换器
- */
 export declare class TrackConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: TCXContext): TrackType | undefined;
 }
-/**
- * 活动圈数转换器
- */
 export declare class ActivityLapConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
@@ -37,9 +25,6 @@ export declare class ActivityLapConverter extends BaseTCXConverter {
     protected convertExtensions(extensionsAST: TokenAST): any;
     protected convertExtensionContent(extension: TokenAST): any;
 }
-/**
- * 活动转换器
- */
 export declare class ActivityConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
@@ -49,25 +34,16 @@ export declare class ActivityConverter extends BaseTCXConverter {
     protected convertExtensions(extensionsAST: TokenAST): any;
     protected convertExtensionContent(extension: TokenAST): any;
 }
-/**
- * 活动列表转换器
- */
 export declare class ActivityListConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: TCXContext): ActivityListType | undefined;
 }
-/**
- * 多运动会话转换器
- */
 export declare class MultiSportSessionConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: TCXContext): MultiSportSessionType | undefined;
 }
-/**
- * 抽象来源转换器
- */
 export declare class AbstractSourceConverter extends BaseTCXConverter {
     name: string;
     supportedTags: string[];

package/dist/TCX/decoder.d.ts

@@ -1,9 +1,6 @@
 import { ExtensionsType, TokenAST } from "../types.js";
 import { ITCXConverterPlugin, ITCXMiddlewarePlugin } from "./base.js";
 import { TCXFileType } from "./types.js";
-/**
- * https://www8.garmin.com/xmlschemas/TrainingCenterDatabasev2.xsd
- */
 export declare class TCXDecoder {
     private converterPlugins;
     private registeredPlugins;
@@ -12,73 +9,22 @@ export declare class TCXDecoder {
     private initialized;
     private defaultConvertersRegistered;
     constructor();
-    /**
-     * 初始化流水线 - 注册固定的核心处理器
-     */
     private initializePipeline;
-    /**
-     * 自动注册默认转换器 - 处理标准TCX标签
-     */
     private registerDefaultConverters;
-    /**
-     * 为指定标签添加转换器，按优先级排序
-     */
     private addConverterForTag;
-    /**
-     * 注册转换器插件
-     */
     registerConverter(plugin: ITCXConverterPlugin): Promise<void>;
-    /**
-     * 注册中间件插件 - 真正的扩展点
-     */
     registerMiddleware(plugin: ITCXMiddlewarePlugin): Promise<void>;
-    /**
-     * 获取转换器（返回优先级最高的）
-     */
     getConverter(tag: string): ITCXConverterPlugin | undefined;
-    /**
-     * 获取指定标签的所有转换器（按优先级排序）
-     */
     getAllConverters(tag: string): ITCXConverterPlugin[];
-    /**
-     * 移除转换器
-     */
     unregisterConverter(pluginName: string): void;
-    /**
-     * 移除中间件
-     */
     unregisterMiddleware(name: string): void;
-    /**
-     * 初始化解码器
-     */
     initialize(): Promise<void>;
-    /**
-     * 销毁解码器
-     */
     destroy(): Promise<void>;
-    /**
-     * 创建解码上下文
-     */
     private createContext;
-    /**
-     * 执行中间件钩子
-     */
     private executeMiddlewareHook;
-    /**
-     * 主解析方法 - 固定的流水线 + 灵活的中间件
-     */
     parseByBuffer(buffer: Buffer): Promise<TCXFileType | undefined>;
-    /**
-     * 转换Extensions（向后兼容）
-     */
     convertExtensions(extensionsAST: TokenAST): ExtensionsType;
-    /**
-     * @deprecated 使用 parseByBuffer 替代
-     */
     parserByBuffer(buffer: Buffer): Promise<TCXFileType | undefined>;
-    /**
-     * @deprecated 使用新的插件系统替代
-     */
     parseByString(xmlContent: string): Promise<TCXFileType | undefined>;
 }
 declare const _default: {

package/dist/TCX/encoder.d.ts

@@ -1,150 +1,41 @@
 import { TCXFileType } from "./types.js";
-/**
- * TCX 编码器 - 将 TCXFileType 数据编码为 TCX XML 格式
- */
 export declare class TCXEncoder {
     private compact;
-    /**
-     * 构造函数
-     * @param options 编码器选项
-     */
     constructor(options?: {
         compact?: boolean;
     });
-    /**
-     * 编码 TCX 数据为 Buffer
-     */
     encode(tcxData: TCXFileType): Promise<Buffer>;
-    /**
-     * 编码 TCX 数据为 XML 字符串
-     */
     encodeToString(tcxData: TCXFileType): string;
-    /**
-     * 构建完整的 TCX XML
-     */
     private buildTCXXML;
-    /**
-     * 压缩XML字符串，去掉多余的换行和空格
-     */
     private compressXML;
-    /**
-     * 构建 XML 头部
-     */
     private buildXMLHeader;
-    /**
-     * 构建 TCX 内容
-     */
     private buildTCXContent;
-    /**
-     * 构建 Folders 元素
-     */
     private buildFolders;
-    /**
-     * 构建 History 元素
-     */
     private buildHistory;
-    /**
-     * 构建 HistoryFolder 元素
-     */
     private buildHistoryFolder;
-    /**
-     * 构建 Activities 元素
-     */
     private buildActivities;
-    /**
-     * 构建单个 Activity 元素
-     */
     private buildActivity;
-    /**
-     * 构建 ActivityLap 元素
-     */
     private buildActivityLap;
-    /**
-     * 构建 Track 元素
-     */
     private buildTrack;
-    /**
-     * 构建 Trackpoint 元素
-     */
     private buildTrackpoint;
-    /**
-     * 构建 Position 元素
-     */
     private buildPosition;
-    /**
-     * 构建 Cadence 元素
-     */
     private buildCadence;
-    /**
-     * 构建 MultiSportSession 元素
-     */
     private buildMultiSportSession;
-    /**
-     * 构建 FirstSport 元素
-     */
     private buildFirstSport;
-    /**
-     * 构建 NextSport 元素
-     */
     private buildNextSport;
-    /**
-     * 构建 Workouts 元素
-     */
     private buildWorkouts;
-    /**
-     * 构建 Courses 元素
-     */
     private buildCourses;
-    /**
-     * 构建 Author 元素
-     */
     private buildAuthor;
-    /**
-     * 构建扩展元素
-     */
     private buildExtensions;
-    /**
-     * 递归构建扩展内容
-     */
     private buildExtensionContent;
-    /**
-     * 格式化时间
-     */
     private formatTime;
-    /**
-     * 添加可选元素
-     */
     private addOptionalElement;
-    /**
-     * 添加可选数值元素
-     */
     private addOptionalNumericElement;
-    /**
-     * 验证坐标有效性
-     */
     private isValidCoordinate;
-    /**
-     * 格式化坐标
-     */
     private formatCoordinate;
-    /**
-     * 数字四舍五入
-     */
     private roundTo;
-    /**
-     * XML 转义
-     */
     private escapeXML;
-    /**
-     * XML 属性值转义（专门用于属性值的安全转义）
-     */
     private escapeXMLAttribute;
-    /**
-     * 深度拷贝
-     */
     private deepClone;
-    /**
-     * @deprecated 使用 encode() 替代
-     */
     encoder(node: TCXFileType): Promise<Buffer>;
 }

package/dist/TCX/index.d.ts

@@ -1,8 +1,10 @@
 export { TCXDecoder } from "./decoder.js";
-export { TCXFileType, TCXContext } from "./types.js";
-export { AstGenerateProcessor, CompleteProcessor, ConvertProcessor, IPipelineProcessor, TokenizeProcessor, PipelineStage, } from "./processor.js";
+export { TCXEncoder } from "./encoder.js";
+export * from "./types.js";
 export * from "./base.js";
 export * from "./converters.js";
+export * from "./middleware.js";
+export * from "./processor.js";
 import { TCXDecoder } from "./decoder.js";
 declare const _default: {
     TCXDecoder: typeof TCXDecoder;

package/dist/TCX/middleware.d.ts

@@ -1,10 +1,7 @@
 import { Token, TokenAST } from "../types.js";
 import { BaseTCXMiddleware } from "./base.js";
 import { TCXContext } from "./types.js";
-/**
- * 性能监控中间件
- */
-export declare class PerformanceMiddleware extends BaseTCXMiddleware {
+export declare class TCXPerformanceMiddleware extends BaseTCXMiddleware {
     name: string;
     description: string;
     onTokenize(tokens: Token[], context: TCXContext): Promise<Token[]>;
@@ -12,16 +9,17 @@ export declare class PerformanceMiddleware extends BaseTCXMiddleware {
     onComplete(result: any, context: TCXContext): Promise<any>;
     private countNodes;
 }
-/**
- * 验证中间件
- */
-export declare class ValidationMiddleware extends BaseTCXMiddleware {
+export declare class TCXValidationMiddleware extends BaseTCXMiddleware {
     name: string;
     description: string;
     onComplete(result: any, context: TCXContext): Promise<any>;
-    private validateGPX;
+    private validateTCX;
 }
-/**
- * 注册所有默认中间件
- */
-export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;
+export declare class TCXEnhancementMiddleware extends BaseTCXMiddleware {
+    name: string;
+    description: string;
+    onComplete(result: any, context: TCXContext): Promise<any>;
+    private calculateTotalDistance;
+    private calculateTotalDuration;
+}
+export declare function registerDefaultTCXMiddlewares(decoder: any): Promise<void>;

package/dist/TCX/processor.d.ts

@@ -1,48 +1,40 @@
 import { TCXContext } from "./types.js";
-/**
- * 流水线阶段
- */
+import { ITCXConverterPlugin } from "./base.js";
 export declare enum PipelineStage {
     TOKENIZE = "tokenize",
-    AST_GENERATE = "ast_generate",
+    AST_GENERATE = "ast-generate",
     CONVERT = "convert",
     COMPLETE = "complete"
 }
-/**
- * 流水线处理器接口
- */
 export interface IPipelineProcessor {
     stage: PipelineStage;
+    name: string;
     process(context: TCXContext): Promise<TCXContext>;
 }
-/**
- * Tokenize处理器，将XML转为Token
- */
 export declare class TokenizeProcessor implements IPipelineProcessor {
     stage: PipelineStage;
+    name: string;
     process(context: TCXContext): Promise<TCXContext>;
 }
-/**
- * AST生成处理器
- */
 export declare class AstGenerateProcessor implements IPipelineProcessor {
     stage: PipelineStage;
+    name: string;
     process(context: TCXContext): Promise<TCXContext>;
+    private buildAST;
 }
-/**
- * 转换处理器
- */
 export declare class ConvertProcessor implements IPipelineProcessor {
     private getConverter;
     stage: PipelineStage;
-    constructor(getConverter: (tag: string) => any);
+    name: string;
+    constructor(getConverter: (tag: string) => ITCXConverterPlugin | undefined);
     process(context: TCXContext): Promise<TCXContext>;
-    private assignResult;
+    private findTCXRoot;
+    private convertAST;
+    private genericConvert;
+    private countElements;
 }
-/**
- * 完成处理器
- */
 export declare class CompleteProcessor implements IPipelineProcessor {
     stage: PipelineStage;
+    name: string;
     process(context: TCXContext): Promise<TCXContext>;
 }

package/dist/TCX/types.d.ts

@@ -1,8 +1,5 @@
 import { ExtensionsType, Token, TokenAST } from "../types.js";
 import { IProcessingContext } from "../core/base.js";
-/**
- * TCX 文件类型
- */
 export interface TCXFileType {
     version?: string;
     creator?: string;
@@ -139,10 +136,6 @@ export interface ActivityLapType {
     Extensions?: any;
 }
 export type TriggerMethodType = "Manual" | "Distance" | "Location" | "Time" | "HeartRate";
-/**
- * Active（高强度）
- * Resting（低强度）
- */
 export type IntensityType = "Active" | "Resting";
 export interface CadenceType {
     Low: number;
@@ -160,9 +153,6 @@ export interface MultiSportSessionType {
 export interface FirstSportType {
     Activity?: ActivityType;
 }
-/**
- * Each sport contains an optional transition and a run.
- */
 export interface NextSportType {
     Transition?: ActivityLapType;
     Activity?: ActivityType;
@@ -184,9 +174,6 @@ export interface PositionType {
     LatitudeDegrees?: string;
     LongitudeDegrees?: string;
 }
-/**
- * TCX 解码上下文
- */
 export interface TCXContext extends IProcessingContext {
     rawData?: Buffer;
     xmlContent?: string;
@@ -199,5 +186,6 @@ export interface TCXContext extends IProcessingContext {
         astTime?: number;
         convertTime?: number;
         endTime?: number;
+        processingTime?: number;
     };
 }