trackswap 0.0.2 → 0.0.3

package/dist/sport/processor.d.ts

@@ -0,0 +1,19 @@
+import { ISportConverterPlugin, ISportEncoderPlugin } from "./base.js";
+import { SportFileType } from "../types.js";
+import { GPX11Type } from "../GPX/types.js";
+import { FITFileType } from "../FIT/types.js";
+import { TCXFileType } from "../TCX/types.js";
+export declare class SportProcessor {
+    private converters;
+    private encoders;
+    constructor();
+    private registerDefaultConverters;
+    private registerDefaultEncoders;
+    registerConverter(converter: ISportConverterPlugin): void;
+    registerEncoder(encoder: ISportEncoderPlugin): void;
+    convertToSport(sourceData: GPX11Type | FITFileType | TCXFileType, sourceFormat: "gpx" | "fit" | "tcx"): Promise<SportFileType>;
+    encodeSport(sportData: SportFileType, targetFormat: "gpx" | "fit" | "tcx"): Promise<GPX11Type | FITFileType | TCXFileType>;
+    private findConverter;
+    private findEncoder;
+    destroy(): Promise<void>;
+}

package/dist/types.d.ts

@@ -1,3 +1,5 @@
+import { LapMesgType, RecordMesgType, SessionMesgType, UserProfileMesgType } from "./FIT/types.js";
+import { IntensityType, TriggerMethodType } from "./TCX/types.js";
 export interface Token {
     type: "open" | "close" | "text";
     tag: string;
@@ -13,22 +15,98 @@ export interface TokenAST {
 export interface AttributeType {
     [key: string]: string;
 }
-/**
- * The latitude of the point. Decimal degrees, WGS84 datum.
- * @type {number} -90.0 <= value <= 90.0
- */
 export type LatitudeType = number;
-/**
- * The longitude of the point. Decimal degrees, WGS84 datum.
- * @type {number} -180.0 <= value < 180.0
- */
 export type LongitudeType = number;
-/**
- * Used for bearing, heading, course. Units are decimal degrees, true (not magnetic).
- * @type {number} 0.0 <= value < 360.0
-
- */
 export type DegreesType = number;
 export interface ExtensionsType {
     [key: string]: string | number | undefined | ExtensionsType;
 }
+export interface SportFileType {
+    metadata?: {
+        originType: "GPX" | "FIT" | "TCX" | "HIJSON";
+        fileName?: string;
+        fileType?: string;
+        creator?: string;
+        date?: string;
+    };
+    points?: SportPointType[];
+    routes?: SportRouteSegType[];
+    tracks?: SportTrackType[];
+    __fit__UserProfileMesgs?: UserProfileMesgType[];
+}
+export interface SportPointType {
+    lat: LatitudeType;
+    lon: LongitudeType;
+    ele?: number;
+    time?: number;
+    heart?: number;
+    distance?: number;
+    accumulatedPower?: number;
+    speed?: number;
+    power?: number;
+    cadence?: number;
+    temperature?: number;
+    enhancedAltitude?: number;
+    enhancedSpeed?: number;
+    __fit__RecordMesgType?: RecordMesgType;
+    magvar?: DegreesType;
+    geoidheight?: number;
+    name?: string;
+    cmt?: string;
+    desc?: string;
+    src?: string;
+    sym?: string;
+    type?: string;
+    sat?: string;
+    hdop?: number;
+    vdop?: number;
+    pdop?: number;
+    ageofdgpsdata?: number;
+    dgpsid?: DegreesType;
+    turn?: number;
+    extensions?: ExtensionsType;
+}
+export interface SportTrackType {
+    name?: string;
+    sport?: string;
+    trackseg?: SportRouteSegType[];
+    extensions?: ExtensionsType;
+    startTime?: number;
+    startLat?: LatitudeType;
+    startLon?: LongitudeType;
+    duration?: number;
+    distance?: number;
+    endTime?: number;
+    endLat?: LatitudeType;
+    endLon?: LongitudeType;
+    __fit__sessionMesgType?: SessionMesgType;
+}
+export interface SportRouteSegType {
+    name?: string;
+    sport?: string;
+    points?: SportPointType[];
+    duration?: number;
+    distance?: number;
+    startTime?: number;
+    endTime?: number;
+    avgHeartRateBpm?: number;
+    maxHeartRateBpm?: number;
+    avgSpeed?: number;
+    maxSpeed?: number;
+    avgCadenceBpm?: number;
+    maxCadenceBpm?: number;
+    avgPower?: number;
+    maxPower?: number;
+    avgTemperature?: number;
+    maxTemperature?: number;
+    avgAltitude?: number;
+    maxEnhancedAltitude?: number;
+    totalAscent?: number;
+    totalDescent?: number;
+    calories?: number;
+    __tcx__Intensity?: IntensityType;
+    __tcx__TriggerMethod?: TriggerMethodType;
+    __tcx__Notes?: string;
+    __tcx__Extensions?: any;
+    __fit__lapMesgType?: LapMesgType;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "trackswap",
-  "version": "0.0.2",
+  "version": "0.0.3",
   "description": "A powerful and flexible GPX parser and encoder library for Node.js and TypeScript. TrackSwap provides comprehensive support for GPX 1.1 format with advanced features like plugin system, middleware support, and optimized performance.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -11,13 +11,26 @@
     }
   },
   "files": [
-    "dist/**/*",
+    "dist/index.js",
+    "dist/index.d.ts",
+    "dist/TrackSwap.d.ts",
+    "dist/types.d.ts",
+    "dist/**/*.d.ts",
     "README.md",
     "LICENSE"
   ],
   "scripts": {
     "dev": "ts-node src/index.ts",
-    "build": "tsc",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && npm run build:types && npm run build:prod && npm run build:optimize",
+    "build:types": "tsc --emitDeclarationOnly",
+    "build:prod": "NODE_ENV=production node build.config.js",
+    "build:dev": "npm run clean && npm run build:types && NODE_ENV=development node build.config.js",
+    "build:optimize": "node scripts/optimize-dist.js",
+    "build:js": "esbuild src/index.ts --bundle --platform=node --target=node14 --format=esm --outfile=dist/index.js --minify --sourcemap",
+    "build:tsc": "tsc && npm run minify",
+    "minify": "terser dist/**/*.js --compress --mangle --output dist/index.min.js --source-map",
+    "analyze": "NODE_ENV=production ANALYZE=true node build.config.js",
     "start": "node dist/index.js",
     "test:gpx": "cd example/gpx && rm -f output* test_*.json *_report.json *_encoded.xml && node test.js",
     "test:fit": "cd example/FIT && rm -rf output && node test.js",
@@ -54,6 +67,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.15.24",
+    "esbuild": "^0.19.12",
+    "terser": "^5.27.0",
     "ts-node": "^10.9.2",
     "typescript": "^5.8.3"
   },

package/dist/FIT/base.js

@@ -1,101 +0,0 @@
-// ============ 基础工具类 ============
-/**
- * FIT 消息转换器基类
- */
-export class BaseFITMessageConverter {
-    constructor() {
-        this.version = "1.0.0";
-        this.priority = 100;
-    }
-    supports(messageType) {
-        return this.supportedMessageTypes.includes(messageType);
-    }
-    async initialize(context) {
-        context.metadata.set(`plugin:${this.name}:initialized`, true);
-    }
-    async destroy(context) {
-        context.metadata.delete(`plugin:${this.name}:initialized`);
-    }
-    async validate(context) {
-        return true;
-    }
-    // ============ FIT 特定工具方法 ============
-    parseTimestamp(timestamp) {
-        if (!timestamp)
-            return undefined;
-        const date = new Date(timestamp);
-        return isNaN(date.getTime()) ? undefined : date;
-    }
-    calculateDuration(startTime, endTime) {
-        if (!startTime || !endTime)
-            return 0;
-        const start = new Date(startTime).getTime();
-        const end = new Date(endTime).getTime();
-        return Math.max(0, (end - start) / 1000); // 返回秒数
-    }
-    filterMessagesByTimeRange(messages, startTime, endTime, tolerance = 2000 // 默认2秒容错
-    ) {
-        const start = new Date(startTime).getTime();
-        const end = new Date(endTime).getTime();
-        return messages.filter((message) => {
-            if (!message.timestamp)
-                return false;
-            const messageTime = new Date(message.timestamp).getTime();
-            return messageTime >= start - tolerance && messageTime <= end + tolerance;
-        });
-    }
-    groupMessagesByLap(records, laps) {
-        return laps.map((lap) => {
-            const lapRecords = this.filterMessagesByTimeRange(records, lap.startTime, lap.timestamp);
-            return { lap, records: lapRecords };
-        });
-    }
-}
-/**
- * FIT 数据结构化插件基类
- */
-export class BaseFITStructurePlugin {
-    constructor() {
-        this.version = "1.0.0";
-        this.priority = 100;
-    }
-    async initialize(context) {
-        context.metadata.set(`plugin:${this.name}:initialized`, true);
-    }
-    async destroy(context) {
-        context.metadata.delete(`plugin:${this.name}:initialized`);
-    }
-    async validate(context) {
-        return true;
-    }
-}
-/**
- * FIT 中间件基类
- */
-export class BaseFITMiddleware {
-    constructor() {
-        this.version = "1.0.0";
-        this.description = "";
-        this.priority = 100;
-    }
-    async initialize(context) { }
-    async destroy(context) { }
-    async validate(context) {
-        return true;
-    }
-    async onParse(buffer, context) {
-        return buffer;
-    }
-    async onExtractMessages(messages, context) {
-        return messages;
-    }
-    async onStructure(result, context) {
-        return result;
-    }
-    async onComplete(result, context) {
-        return result;
-    }
-    async onError(error, context) {
-        console.error(`FIT中间件 ${this.name} 处理错误:`, error);
-    }
-}

package/dist/FIT/crc.js

@@ -1,16 +0,0 @@
-// prettier-ignore
-const crc_table = [
-    0x0000, 0xcc01, 0xd801, 0x1400, 0xf001, 0x3c00, 0x2800, 0xe401,
-    0xa001, 0x6c00, 0x7800, 0xb401, 0x5000, 0x9c01, 0x8801, 0x4400
-];
-const update_nibble = (crc, nibble) => ((crc >>> 4) ^ crc_table[(crc & 0xf) ^ nibble]) & 0xffff;
-const update_nibbles = (crc, lo, hi) => update_nibble(update_nibble(crc, lo), hi);
-const update = (crc, byte) => update_nibbles(crc, byte & 0xf, byte >>> 4);
-export function crc(buffer, initial = 0) {
-    let crcValue = initial;
-    const uint8Array = buffer instanceof ArrayBuffer ? new Uint8Array(buffer) : buffer;
-    for (let i = 0; i < uint8Array.length; i++) {
-        crcValue = update(crcValue, uint8Array[i]);
-    }
-    return crcValue;
-}

package/dist/FIT/decoder.js

@@ -1,323 +0,0 @@
-import { ParseProcessor, ExtractProcessor, StructureProcessor, CompleteProcessor, FITPipelineStage, } from "./processor.js";
-import { SessionStructurePlugin, CourseStructurePlugin, FileHeaderPlugin, } from "./plugins.js";
-/**
- * FIT 解码器 - 遵循 GPX 风格的插件架构
- */
-export class FITDecoder {
-    constructor() {
-        this.converterPlugins = new Map();
-        this.registeredPlugins = new Set(); // 跟踪已注册的插件名
-        this.structurePlugins = [];
-        this.middlewarePlugins = [];
-        this.processors = []; // 固定的核心处理器
-        this.initialized = false;
-        this.defaultPluginsRegistered = false;
-        this.initializePipeline();
-    }
-    /**
-     * 初始化流水线 - 注册固定的核心处理器
-     */
-    initializePipeline() {
-        // 固定的核心处理器，不允许用户修改
-        this.processors = [
-            new ParseProcessor(),
-            new ExtractProcessor((messageType) => this.getConverters(messageType)),
-            new StructureProcessor(() => this.structurePlugins),
-            new CompleteProcessor(),
-        ];
-        console.log("🔧 FIT核心流水线处理器已初始化 (固定不可修改)");
-    }
-    /**
-     * 自动注册默认插件
-     */
-    async registerDefaultPlugins() {
-        if (this.defaultPluginsRegistered)
-            return;
-        const defaultStructurePlugins = [
-            new FileHeaderPlugin(),
-            new SessionStructurePlugin(),
-            new CourseStructurePlugin(),
-        ];
-        for (const plugin of defaultStructurePlugins) {
-            this.addStructurePlugin(plugin);
-            this.registeredPlugins.add(plugin.name);
-        }
-        this.defaultPluginsRegistered = true;
-        console.log("✅ 默认FIT结构化插件已自动注册 (FileHeader, Session, Course等)");
-    }
-    /**
-     * 为指定消息类型添加转换器，按优先级排序
-     */
-    addConverterForMessageType(messageType, converter) {
-        if (!this.converterPlugins.has(messageType)) {
-            this.converterPlugins.set(messageType, []);
-        }
-        const converters = this.converterPlugins.get(messageType);
-        converters.push(converter);
-        // 按优先级排序（数字越小优先级越高）
-        converters.sort((a, b) => (a.priority || 100) - (b.priority || 100));
-    }
-    /**
-     * 添加结构化插件
-     */
-    addStructurePlugin(plugin) {
-        this.structurePlugins.push(plugin);
-        // 按优先级排序
-        this.structurePlugins.sort((a, b) => (a.priority || 100) - (b.priority || 100));
-    }
-    /**
-     * 注册消息转换器插件
-     */
-    async registerMessageConverter(plugin) {
-        // 检查插件是否已注册
-        if (this.registeredPlugins.has(plugin.name)) {
-            throw new Error(`消息转换器插件 ${plugin.name} 已存在`);
-        }
-        // 注册支持的消息类型
-        plugin.supportedMessageTypes.forEach((messageType) => {
-            this.addConverterForMessageType(messageType, plugin);
-        });
-        this.registeredPlugins.add(plugin.name);
-        // 显示优先级信息
-        const priorityInfo = plugin.priority !== undefined ? ` (优先级: ${plugin.priority})` : "";
-        console.log(`📦 已注册FIT消息转换器: ${plugin.name}${priorityInfo}, 支持消息类型: ${plugin.supportedMessageTypes.join(", ")}`);
-        // 显示消息类型的转换器优先级顺序
-        plugin.supportedMessageTypes.forEach((messageType) => {
-            const converters = this.converterPlugins.get(messageType) || [];
-            const converterNames = converters.map((c) => `${c.name}(${c.priority || 100})`);
-            console.log(`   📋 消息类型 "${messageType}" 转换器优先级: ${converterNames.join(" > ")}`);
-        });
-    }
-    /**
-     * 注册结构化插件
-     */
-    async registerStructurePlugin(plugin) {
-        if (this.registeredPlugins.has(plugin.name)) {
-            throw new Error(`结构化插件 ${plugin.name} 已存在`);
-        }
-        this.addStructurePlugin(plugin);
-        this.registeredPlugins.add(plugin.name);
-        const priorityInfo = plugin.priority !== undefined ? ` (优先级: ${plugin.priority})` : "";
-        console.log(`🏗️ 已注册FIT结构化插件: ${plugin.name}${priorityInfo}`);
-    }
-    /**
-     * 注册中间件插件
-     */
-    async registerMiddleware(plugin) {
-        const existingIndex = this.middlewarePlugins.findIndex((p) => p.name === plugin.name);
-        if (existingIndex !== -1) {
-            this.middlewarePlugins[existingIndex] = plugin;
-            console.log(`🔄 已更新FIT中间件: ${plugin.name}`);
-        }
-        else {
-            this.middlewarePlugins.push(plugin);
-            // 按优先级排序
-            this.middlewarePlugins.sort((a, b) => (a.priority || 100) - (b.priority || 100));
-            console.log(`🔌 已注册FIT中间件: ${plugin.name}`);
-        }
-        // 显示中间件支持的钩子
-        const hooks = [];
-        if (plugin.onParse)
-            hooks.push("onParse");
-        if (plugin.onExtractMessages)
-            hooks.push("onExtractMessages");
-        if (plugin.onStructure)
-            hooks.push("onStructure");
-        if (plugin.onComplete)
-            hooks.push("onComplete");
-        if (plugin.onError)
-            hooks.push("onError");
-        if (hooks.length > 0) {
-            console.log(`   🎣 支持的钩子: ${hooks.join(", ")}`);
-        }
-    }
-    /**
-     * 获取消息类型转换器（返回优先级最高的）
-     */
-    getConverter(messageType) {
-        const converters = this.converterPlugins.get(messageType);
-        return converters && converters.length > 0 ? converters[0] : undefined;
-    }
-    /**
-     * 获取指定消息类型的所有转换器（按优先级排序）
-     */
-    getConverters(messageType) {
-        return this.converterPlugins.get(messageType) || [];
-    }
-    /**
-     * 移除插件
-     */
-    unregisterPlugin(pluginName) {
-        if (!this.registeredPlugins.has(pluginName)) {
-            console.warn(`FIT插件 ${pluginName} 不存在`);
-            return false;
-        }
-        // 从消息转换器中移除
-        for (const [messageType, converters] of this.converterPlugins) {
-            const index = converters.findIndex((plugin) => plugin.name === pluginName);
-            if (index !== -1) {
-                converters.splice(index, 1);
-                if (converters.length === 0) {
-                    this.converterPlugins.delete(messageType);
-                }
-            }
-        }
-        // 从结构化插件中移除
-        const structureIndex = this.structurePlugins.findIndex((plugin) => plugin.name === pluginName);
-        if (structureIndex !== -1) {
-            this.structurePlugins.splice(structureIndex, 1);
-        }
-        // 从中间件中移除
-        const middlewareIndex = this.middlewarePlugins.findIndex((plugin) => plugin.name === pluginName);
-        if (middlewareIndex !== -1) {
-            this.middlewarePlugins.splice(middlewareIndex, 1);
-        }
-        this.registeredPlugins.delete(pluginName);
-        console.log(`🗑️ 已移除FIT插件: ${pluginName}`);
-        return true;
-    }
-    /**
-     * 初始化解码器
-     */
-    async initialize() {
-        if (this.initialized)
-            return;
-        // 首先注册默认插件
-        await this.registerDefaultPlugins();
-        const context = this.createContext();
-        // 初始化所有插件
-        const allPlugins = [
-            ...Array.from(this.converterPlugins.values()).flat(),
-            ...this.structurePlugins,
-            ...this.middlewarePlugins,
-        ];
-        for (const plugin of allPlugins) {
-            try {
-                await plugin.initialize?.(context);
-            }
-            catch (error) {
-                console.error(`FIT插件 ${plugin.name} 初始化失败:`, error);
-            }
-        }
-        this.initialized = true;
-    }
-    /**
-     * 销毁解码器
-     */
-    async destroy() {
-        if (!this.initialized)
-            return;
-        const context = this.createContext();
-        // 销毁所有插件
-        const allPlugins = [
-            ...Array.from(this.converterPlugins.values()).flat(),
-            ...this.structurePlugins,
-            ...this.middlewarePlugins,
-        ];
-        for (const plugin of allPlugins) {
-            try {
-                await plugin.destroy?.(context);
-            }
-            catch (error) {
-                console.error(`FIT插件 ${plugin.name} 销毁失败:`, error);
-            }
-        }
-        this.initialized = false;
-    }
-    /**
-     * 创建解码上下文
-     */
-    createContext() {
-        return {
-            metadata: new Map(),
-            errors: [],
-            warnings: [],
-            stats: {
-                startTime: Date.now(),
-                processedTokens: 0,
-                convertedElements: 0,
-            },
-            performance: {
-                startTime: Date.now(),
-            },
-        };
-    }
-    /**
-     * 执行中间件钩子
-     */
-    async executeMiddlewareHook(hookName, data, context) {
-        let result = data;
-        for (const middleware of this.middlewarePlugins) {
-            const hook = middleware[hookName];
-            if (hook) {
-                try {
-                    result = (await hook.call(middleware, result, context)) || result;
-                }
-                catch (error) {
-                    context.errors.push(error);
-                    await middleware.onError?.(error, context);
-                }
-            }
-        }
-        return result;
-    }
-    /**
-     * 主解析方法 - 固定的流水线 + 灵活的中间件
-     */
-    async parseByBuffer(buffer, options = {}) {
-        await this.initialize();
-        let context = this.createContext();
-        context.rawData = buffer;
-        context.userData = options.userData;
-        // 在上下文中传递解码器实例引用
-        context.metadata.set("decoder", this);
-        try {
-            // 固定的流水线阶段顺序执行
-            for (const processor of this.processors) {
-                try {
-                    // 1. 执行核心处理器
-                    context = await processor.process(context);
-                    // 2. 根据阶段执行对应的中间件钩子
-                    switch (processor.stage) {
-                        case FITPipelineStage.PARSE:
-                            if (context.rawData) {
-                                context.rawData = await this.executeMiddlewareHook("onParse", context.rawData, context);
-                            }
-                            break;
-                        case FITPipelineStage.EXTRACT:
-                            if (context.rawMessages) {
-                                context.rawMessages = await this.executeMiddlewareHook("onExtractMessages", context.rawMessages, context);
-                            }
-                            break;
-                        case FITPipelineStage.STRUCTURE:
-                            if (context.result) {
-                                context.result = await this.executeMiddlewareHook("onStructure", context.result, context);
-                            }
-                            break;
-                        case FITPipelineStage.COMPLETE:
-                            if (context.result) {
-                                context.result = await this.executeMiddlewareHook("onComplete", context.result, context);
-                            }
-                            break;
-                    }
-                }
-                catch (error) {
-                    context.errors.push(error);
-                    // 执行错误处理中间件
-                    for (const middleware of this.middlewarePlugins) {
-                        await middleware.onError?.(error, context);
-                    }
-                    console.error(`FIT流水线阶段 ${processor.stage} 处理失败:`, error);
-                }
-            }
-            return context.result || {};
-        }
-        catch (error) {
-            console.error("FIT解析失败:", error);
-            throw error;
-        }
-    }
-}
-export default {
-    FITDecoder,
-};