trackswap 0.0.1 → 0.0.2

package/dist/GPX/converters.js

@@ -1,9 +1,9 @@
-import { BaseConverter, BaseMiddleware } from "./base.js";
+import { BaseGPXConverter } from "./base.js";
 // ============ 核心转换器 ============
 /**
  * WPT转换器
  */
-export class WptConverter extends BaseConverter {
+export class WptConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "wpt-converter";
@@ -67,7 +67,7 @@ export class WptConverter extends BaseConverter {
 /**
  * Route转换器
  */
-export class RteConverter extends BaseConverter {
+export class RteConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "rte-converter";
@@ -114,7 +114,7 @@ export class RteConverter extends BaseConverter {
 /**
  * Track转换器
  */
-export class TrkConverter extends BaseConverter {
+export class TrkConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "trk-converter";
@@ -161,7 +161,7 @@ export class TrkConverter extends BaseConverter {
 /**
  * Track Segment转换器
  */
-export class TrksegConverter extends BaseConverter {
+export class TrksegConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "trkseg-converter";
@@ -190,7 +190,7 @@ export class TrksegConverter extends BaseConverter {
 /**
  * Link转换器
  */
-export class LinkConverter extends BaseConverter {
+export class LinkConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "link-converter";
@@ -211,7 +211,7 @@ export class LinkConverter extends BaseConverter {
 /**
  * Metadata转换器
  */
-export class MetadataConverter extends BaseConverter {
+export class MetadataConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "metadata-converter";
@@ -263,7 +263,7 @@ export class MetadataConverter extends BaseConverter {
 /**
  * Person转换器
  */
-export class PersonConverter extends BaseConverter {
+export class PersonConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "person-converter";
@@ -294,7 +294,7 @@ export class PersonConverter extends BaseConverter {
 /**
  * Email转换器
  */
-export class EmailConverter extends BaseConverter {
+export class EmailConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "email-converter";
@@ -312,7 +312,7 @@ export class EmailConverter extends BaseConverter {
 /**
  * Copyright转换器
  */
-export class CopyrightConverter extends BaseConverter {
+export class CopyrightConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "copyright-converter";
@@ -333,7 +333,7 @@ export class CopyrightConverter extends BaseConverter {
 /**
  * Bounds转换器
  */
-export class BoundsConverter extends BaseConverter {
+export class BoundsConverter extends BaseGPXConverter {
     constructor() {
         super(...arguments);
         this.name = "bounds-converter";
@@ -350,95 +350,3 @@ export class BoundsConverter extends BaseConverter {
         return bounds;
     }
 }
-// ============ 示例中间件 ============
-/**
- * 性能监控中间件
- */
-export class PerformanceMiddleware extends BaseMiddleware {
-    constructor() {
-        super(...arguments);
-        this.name = "performance-middleware";
-        this.description = "监控解析性能";
-    }
-    async onTokenize(tokens, context) {
-        console.log(`Token化完成，生成了 ${tokens.length} 个token`);
-        return tokens;
-    }
-    async onAstGenerate(ast, context) {
-        const nodeCount = this.countNodes(ast);
-        console.log(`AST生成完成，包含 ${nodeCount} 个节点`);
-        return ast;
-    }
-    async onComplete(result, context) {
-        const performance = context.metadata.get("performance");
-        console.log("解析性能统计:", performance);
-        return result;
-    }
-    countNodes(ast) {
-        let count = 1;
-        if (ast.children) {
-            for (const child of ast.children) {
-                count += this.countNodes(child);
-            }
-        }
-        return count;
-    }
-}
-/**
- * 验证中间件
- */
-export class ValidationMiddleware extends BaseMiddleware {
-    constructor() {
-        super(...arguments);
-        this.name = "validation-middleware";
-        this.description = "验证GPX数据的完整性";
-    }
-    async onComplete(result, context) {
-        const errors = this.validateGPX(result);
-        if (errors.length > 0) {
-            console.warn("GPX验证发现问题:", errors);
-            context.metadata.set("validation-errors", errors);
-        }
-        else {
-            console.log("GPX验证通过");
-        }
-        return result;
-    }
-    validateGPX(gpx) {
-        const errors = [];
-        if (!gpx.version) {
-            errors.push("缺少GPX版本信息");
-        }
-        if (!gpx.creator) {
-            errors.push("缺少GPX创建者信息");
-        }
-        // 验证轨迹点
-        if (gpx.trk) {
-            for (const track of gpx.trk) {
-                if (track.trkseg) {
-                    for (const segment of track.trkseg) {
-                        if (segment.trkpt) {
-                            for (const point of segment.trkpt) {
-                                if (typeof point.lat !== "number" ||
-                                    typeof point.lon !== "number") {
-                                    errors.push("轨迹点坐标无效");
-                                }
-                            }
-                        }
-                    }
-                }
-            }
-        }
-        return errors;
-    }
-}
-// ============ 默认转换器注册函数 ============
-/**
- * 注册所有默认中间件
- */
-export async function registerDefaultMiddlewares(decoder) {
-    const middlewares = [new PerformanceMiddleware(), new ValidationMiddleware()];
-    for (const middleware of middlewares) {
-        await decoder.registerMiddleware(middleware);
-    }
-}

package/dist/GPX/decoder.d.ts

@@ -1,5 +1,5 @@
 import { ExtensionsType, TokenAST } from "../types.js";
-import { IConverterPlugin, IMiddlewarePlugin } from "./base.js";
+import { IGPXConverterPlugin, IGPXMiddlewarePlugin } from "./base.js";
 import { GPX11Type } from "./types.js";
 /**
  * GPX解码器主类
@@ -27,19 +27,19 @@ export declare class GPXDecoder {
     /**
      * 注册转换器插件
      */
-    registerConverter(plugin: IConverterPlugin): Promise<void>;
+    registerConverter(plugin: IGPXConverterPlugin): Promise<void>;
     /**
      * 注册中间件插件 - 真正的扩展点
      */
-    registerMiddleware(plugin: IMiddlewarePlugin): Promise<void>;
+    registerMiddleware(plugin: IGPXMiddlewarePlugin): Promise<void>;
     /**
      * 获取转换器（返回优先级最高的）
      */
-    getConverter(tag: string): IConverterPlugin | undefined;
+    getConverter(tag: string): IGPXConverterPlugin | undefined;
     /**
      * 获取指定标签的所有转换器（按优先级排序）
      */
-    getAllConverters(tag: string): IConverterPlugin[];
+    getAllConverters(tag: string): IGPXConverterPlugin[];
     /**
      * 移除转换器
      */

package/dist/GPX/decoder.js

@@ -292,6 +292,12 @@ export class GPXDecoder {
         return {
             metadata: new Map(),
             errors: [],
+            warnings: [],
+            stats: {
+                startTime: Date.now(),
+                processedTokens: 0,
+                convertedElements: 0,
+            },
             performance: {
                 startTime: Date.now(),
             },

package/dist/GPX/encoder.d.ts

@@ -148,3 +148,7 @@ export declare class GPXEncoder {
      */
     encoder(node: GPX11Type): Promise<Buffer>;
 }
+declare const _default: {
+    GPXEncoder: typeof GPXEncoder;
+};
+export default _default;

package/dist/GPX/encoder.js

@@ -508,3 +508,6 @@ export class GPXEncoder {
         return this.encode(node);
     }
 }
+export default {
+    GPXEncoder,
+};

package/dist/GPX/index.d.ts

@@ -1,6 +1,6 @@
 import { GPXDecoder } from "./decoder.js";
 import { GPXEncoder } from "./encoder.js";
-import { registerDefaultMiddlewares } from "./converters.js";
+import { registerDefaultMiddlewares } from "./middleware.js";
 import { PipelineStage } from "./processor.js";
 export { GPXDecoder, GPXEncoder, registerDefaultMiddlewares, PipelineStage };
 declare const _default: {

package/dist/GPX/index.js

@@ -1,6 +1,6 @@
 import { GPXDecoder } from "./decoder.js";
 import { GPXEncoder } from "./encoder.js";
-import { registerDefaultMiddlewares } from "./converters.js";
+import { registerDefaultMiddlewares } from "./middleware.js";
 import { PipelineStage } from "./processor.js";
 export { GPXDecoder, GPXEncoder, registerDefaultMiddlewares, PipelineStage };
 export default {

package/dist/GPX/middleware.d.ts

@@ -0,0 +1,27 @@
+import { Token, TokenAST } from "../types";
+import { BaseGPXMiddleware } from "./base";
+import { DecoderContext } from "./types";
+/**
+ * 性能监控中间件
+ */
+export declare class PerformanceMiddleware extends BaseGPXMiddleware {
+    name: string;
+    description: string;
+    onTokenize(tokens: Token[], context: DecoderContext): Promise<Token[]>;
+    onAstGenerate(ast: TokenAST, context: DecoderContext): Promise<TokenAST>;
+    onComplete(result: any, context: DecoderContext): Promise<any>;
+    private countNodes;
+}
+/**
+ * 验证中间件
+ */
+export declare class ValidationMiddleware extends BaseGPXMiddleware {
+    name: string;
+    description: string;
+    onComplete(result: any, context: DecoderContext): Promise<any>;
+    private validateGPX;
+}
+/**
+ * 注册所有默认中间件
+ */
+export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;

package/dist/GPX/middleware.js

@@ -0,0 +1,93 @@
+import { BaseGPXMiddleware } from "./base";
+// ============ 示例中间件 ============
+/**
+ * 性能监控中间件
+ */
+export class PerformanceMiddleware extends BaseGPXMiddleware {
+    constructor() {
+        super(...arguments);
+        this.name = "performance-middleware";
+        this.description = "监控解析性能";
+    }
+    async onTokenize(tokens, context) {
+        console.log(`Token化完成，生成了 ${tokens.length} 个token`);
+        return tokens;
+    }
+    async onAstGenerate(ast, context) {
+        const nodeCount = this.countNodes(ast);
+        console.log(`AST生成完成，包含 ${nodeCount} 个节点`);
+        return ast;
+    }
+    async onComplete(result, context) {
+        const performance = context.metadata.get("performance");
+        console.log("解析性能统计:", performance);
+        return result;
+    }
+    countNodes(ast) {
+        let count = 1;
+        if (ast.children) {
+            for (const child of ast.children) {
+                count += this.countNodes(child);
+            }
+        }
+        return count;
+    }
+}
+/**
+ * 验证中间件
+ */
+export class ValidationMiddleware extends BaseGPXMiddleware {
+    constructor() {
+        super(...arguments);
+        this.name = "validation-middleware";
+        this.description = "验证GPX数据的完整性";
+    }
+    async onComplete(result, context) {
+        const errors = this.validateGPX(result);
+        if (errors.length > 0) {
+            console.warn("GPX验证发现问题:", errors);
+            context.metadata.set("validation-errors", errors);
+        }
+        else {
+            console.log("GPX验证通过");
+        }
+        return result;
+    }
+    validateGPX(gpx) {
+        const errors = [];
+        if (!gpx.version) {
+            errors.push("缺少GPX版本信息");
+        }
+        if (!gpx.creator) {
+            errors.push("缺少GPX创建者信息");
+        }
+        // 验证轨迹点
+        if (gpx.trk) {
+            for (const track of gpx.trk) {
+                if (track.trkseg) {
+                    for (const segment of track.trkseg) {
+                        if (segment.trkpt) {
+                            for (const point of segment.trkpt) {
+                                if (typeof point.lat !== "number" ||
+                                    typeof point.lon !== "number") {
+                                    errors.push("轨迹点坐标无效");
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        }
+        return errors;
+    }
+}
+// ============ 默认转换器注册函数 ============
+/**
+ * 注册所有默认中间件
+ */
+export async function registerDefaultMiddlewares(decoder) {
+    const middlewares = [new PerformanceMiddleware(), new ValidationMiddleware()];
+    for (const middleware of middlewares) {
+        await decoder.registerMiddleware(middleware);
+    }
+}

package/dist/GPX/processor.d.ts

@@ -16,7 +16,7 @@ export interface IPipelineProcessor {
     process(context: DecoderContext): Promise<DecoderContext>;
 }
 /**
- * Tokenize处理器
+ * Tokenize处理器, 将xml转为 token
  */
 export declare class TokenizeProcessor implements IPipelineProcessor {
     stage: PipelineStage;

package/dist/GPX/processor.js

@@ -10,7 +10,7 @@ export var PipelineStage;
     PipelineStage["COMPLETE"] = "complete";
 })(PipelineStage || (PipelineStage = {}));
 /**
- * Tokenize处理器
+ * Tokenize处理器, 将xml转为 token
  */
 export class TokenizeProcessor {
     constructor() {
@@ -122,18 +122,19 @@ export class ConvertProcessor {
         // 处理子节点
         context.ast.children?.forEach((child) => {
             const converter = this.getConverter(child.tag);
-            if (converter) {
-                try {
-                    const result = converter.convert(child, context);
-                    if (result) {
-                        this.assignResult(gpx, child.tag, result);
-                    }
-                }
-                catch (error) {
-                    context.errors.push(error);
-                    console.error(`转换器 ${converter.name} 处理标签 ${child.tag} 时出错:`, error);
+            if (!converter) {
+                console.error(`标签 ${child.tag} 未找到对应的 converter`);
+            }
+            try {
+                const result = converter.convert(child, context);
+                if (result) {
+                    this.assignResult(gpx, child.tag, result);
                 }
             }
+            catch (error) {
+                context.errors.push(error);
+                console.error(`转换器 ${converter.name} 处理标签 ${child.tag} 时出错:`, error);
+            }
         });
         context.result = gpx;
         context.performance.convertTime = Date.now() - startTime;

package/dist/GPX/types.d.ts

@@ -1,4 +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.
  */
@@ -211,14 +212,12 @@ export interface TrksegType {
     trkpt?: WptType[];
     extensions?: ExtensionsType;
 }
-export interface DecoderContext {
+export interface DecoderContext extends IProcessingContext {
     rawData?: Buffer;
     xmlContent?: string;
     tokens?: Token[];
     ast?: TokenAST;
     result?: GPX11Type;
-    metadata: Map<string, any>;
-    errors: Error[];
     performance: {
         startTime: number;
         tokenizeTime?: number;

package/dist/TCX/base.d.ts

@@ -0,0 +1,52 @@
+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/base.js

@@ -0,0 +1,62 @@
+import { BaseConverter, BaseMiddleware, } from "../core/base.js";
+// ============ TCX 特定基础类 ============
+/**
+ * TCX 基础转换器抽象类（继承通用基础转换器）
+ */
+export class BaseTCXConverter extends BaseConverter {
+    // TCX 特定的工具方法可以在这里添加
+    /**
+     * 解析 TCX 心率值
+     */
+    parseHeartRate(value) {
+        const hr = this.parseFloat(value);
+        return hr > 0 && hr < 300 ? hr : undefined; // 合理的心率范围
+    }
+    /**
+     * 解析 TCX 时间格式（ISO 8601）
+     */
+    parseTCXTime(value) {
+        if (!value)
+            return undefined;
+        // TCX 使用 ISO 8601 格式
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? undefined : date;
+    }
+    /**
+     * 解析 TCX 距离值（米）
+     */
+    parseDistance(value) {
+        const distance = this.parseFloat(value);
+        return distance >= 0 ? distance : undefined;
+    }
+    /**
+     * 解析 TCX 速度值（m/s）
+     */
+    parseSpeed(value) {
+        const speed = this.parseFloat(value);
+        return speed >= 0 ? speed : undefined;
+    }
+    /**
+     * 解析 TCX 海拔值（米）
+     */
+    parseAltitude(value) {
+        return this.parseFloat(value);
+    }
+    /**
+     * 解析 TCX 坐标值（纬度/经度）
+     */
+    parseCoordinate(value) {
+        const coord = this.parseFloat(value);
+        return coord !== 0 ? coord : undefined;
+    }
+}
+/**
+ * TCX 基础中间件抽象类（继承通用基础中间件）
+ */
+export class BaseTCXMiddleware extends BaseMiddleware {
+    // TCX 特定的中间件逻辑可以在这里添加
+    async onError(error, context) {
+        console.error(`TCX中间件 ${this.name} 处理错误:`, error);
+        context.warnings.push(`中间件 ${this.name} 错误: ${error.message}`);
+    }
+}

package/dist/TCX/converters.d.ts

@@ -0,0 +1,75 @@
+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[];
+    convert(ast: TokenAST, context: TCXContext): TrackpointType | undefined;
+    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[];
+    convert(ast: TokenAST, context: TCXContext): ActivityLapType | undefined;
+    protected convertExtensions(extensionsAST: TokenAST): any;
+    protected convertExtensionContent(extension: TokenAST): any;
+}
+/**
+ * 活动转换器
+ */
+export declare class ActivityConverter extends BaseTCXConverter {
+    name: string;
+    supportedTags: string[];
+    convert(ast: TokenAST, context: TCXContext): ActivityType | undefined;
+    private convertTraining;
+    private convertCreator;
+    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[];
+    convert(ast: TokenAST, context: TCXContext): AbstractSourceType | undefined;
+}