trackswap 0.0.1 → 0.0.2

package/dist/FIT/types.d.ts

@@ -0,0 +1,231 @@
+import { IProcessingContext } from "../core/base.js";
+/**
+ * Session 对应 AbstractTrackType Lap 对应 RouteSegType Records 对应 RouteType 每个Record 对应 PointType
+ */
+export interface FITFileType {
+    fileIdMesgs?: FileIdMesgType[];
+    fileCreatorMesgs?: FileCreatorMesgType[];
+    eventMesgs?: EventMesgType[];
+    deviceInfoMesgs?: DeviceInfoMesgType[];
+    deviceSettingsMesgs?: DeviceSettingsMesgType[];
+    userProfileMesgs?: UserProfileMesgType[];
+    sessionMesgs?: SessionMesgType[];
+    courseMesgs?: any[];
+}
+export type FITDecoderMesgs = {
+    fileIdMesgs?: FileIdMesgType[];
+    fileCreatorMesgs?: FileCreatorMesgType[];
+    eventMesgs?: EventMesgType[];
+    deviceInfoMesgs?: DeviceInfoMesgType[];
+    deviceSettingsMesgs?: DeviceSettingsMesgType[];
+    userProfileMesgs?: UserProfileMesgType[];
+    sessionMesgs?: Omit<SessionMesgType, "lapMesgs">[];
+    lapMesgs?: Omit<SessionMesgType, "recordMesgs">[];
+    recordMesgs?: RecordMesgType[];
+    courseMesgs?: any[];
+    [key: string]: any[] | undefined;
+};
+export interface FileIdMesgType {
+    serialNumber?: number;
+    timeCreated?: string;
+    manufacturer?: string;
+    product?: number;
+    type?: string;
+    garminProduct?: string;
+}
+export interface FileCreatorMesgType {
+    softwareVersion?: number;
+}
+export interface EventMesgType {
+    timestamp?: string;
+    data?: number;
+    event?: string;
+    eventType?: string;
+    eventGroup?: number;
+    timerTrigger?: string;
+}
+export interface DeviceInfoMesgType {
+    timestamp?: string;
+    serialNumber?: number;
+    manufacturer?: string;
+    product?: number;
+    softwareVersion?: number;
+    deviceIndex?: string;
+    deviceType?: number;
+    garminProduct?: string;
+}
+export interface DeviceSettingsMesgType {
+    utcOffset?: number;
+    timeOffset?: number;
+    activeTimeZone?: number;
+    timeMode?: string;
+    timeZoneOffset?: number;
+    backlightMode?: string;
+}
+/**
+ * FIT userProfileMesg
+ */
+export interface UserProfileMesgType {
+    friendlyName?: string;
+    weight?: number;
+    gender?: string;
+    age?: number;
+    height?: number;
+    language?: string;
+    elevSetting?: string;
+    weightSetting?: string;
+    defaultMaxBikingHeartRate?: number;
+    defaultMaxHeartRate?: number;
+    hrSetting?: string;
+    speedSetting?: string;
+    distSetting?: string;
+    powerSetting?: string;
+    activityClass?: number;
+    positionSetting?: string;
+    temperatureSetting?: string;
+}
+/**
+ * FIT SessionMesg
+ */
+export interface SessionMesgType {
+    /**
+     * 时间
+     */
+    timestamp?: string;
+    /**
+     * 开始时间
+     */
+    startTime?: string;
+    startPositionLat?: number;
+    startPositionLong?: number;
+    totalElapsedTime?: number;
+    totalTimerTime?: number;
+    totalDistance?: number;
+    totalCycles?: number;
+    necLat?: number;
+    necLong?: number;
+    swcLat?: number;
+    swcLong?: number;
+    totalWork?: number;
+    messageIndex?: number;
+    totalCalories?: number;
+    totalFatCalories?: number;
+    avgSpeed?: number;
+    maxSpeed?: number;
+    avgPower?: number;
+    maxPower?: number;
+    /**
+     * 总爬升
+     */
+    totalAscent?: number;
+    /**
+     * 总下降
+     */
+    totalDescent?: number;
+    firstLapIndex?: number;
+    numLaps?: number;
+    normalizedPower?: number;
+    trainingStressScore?: number;
+    intensityFactor?: number;
+    thresholdPower?: number;
+    event?: string;
+    eventType?: string;
+    sport?: string;
+    subSport?: string;
+    avgCadence?: number;
+    maxCadence?: number;
+    trigger?: number;
+    totalStrokes?: number;
+    enhancedAvgSpeed?: number;
+    enhancedMaxSpeed?: number;
+    lapMesgs?: LapMesgType[];
+}
+/**
+ * FIT RecordMesg
+ */
+export interface RecordMesgType {
+    timestamp?: string;
+    positionLat?: number;
+    positionLong?: number;
+    altitude?: number;
+    distance?: number;
+    accumulatedPower?: number;
+    speed?: number;
+    power?: number;
+    cadence?: number;
+    heartRate?: number;
+    temperature?: number;
+    enhancedAltitude?: number;
+    enhancedSpeed?: number;
+    [key: string]: number | string | undefined | any;
+}
+/**
+ * FIT 文件额外记录的数据 LapMesg
+ */
+export interface LapMesgType {
+    timestamp?: string;
+    startTime?: string;
+    startPositionLat?: number;
+    startPositionLong?: number;
+    endPositionLat?: number;
+    endPositionLong?: number;
+    totalElapsedTime?: number;
+    totalTimerTime?: number;
+    totalDistance?: number;
+    totalCycles?: number;
+    totalWork?: number;
+    messageIndex?: number;
+    totalCalories?: number;
+    totalFatCalories?: number;
+    avgSpeed?: number;
+    maxSpeed?: number;
+    avgPower?: number;
+    maxPower?: number;
+    totalAscent?: number;
+    totalDescent?: number;
+    normalizedPower?: number;
+    event?: string;
+    eventType?: string;
+    avgCadence?: number;
+    maxCadence?: number;
+    lapTrigger?: string;
+    sport?: string;
+    totalStrokes?: number;
+    enhancedAvgSpeed?: number;
+    enhancedMaxSpeed?: number;
+    recordMesgs?: RecordMesgType[];
+}
+export interface ActivityMesgType {
+    timestamp?: string;
+    totalTimerTime?: number;
+    numSessions?: number;
+    type?: string;
+    event?: string;
+    eventType?: string;
+    [key: string]: number | string | undefined | any;
+}
+/**
+ * FIT 消息处理上下文
+ */
+export interface FITContext extends IProcessingContext {
+    /** 原始二进制数据 */
+    rawData?: Buffer;
+    /** FIT SDK 解析的原始消息 */
+    rawMessages?: FITDecoderMesgs;
+    /** 最终结果 */
+    result?: FITFileType;
+    /** FIT 文件头信息 */
+    fileHeader?: {
+        type?: string;
+        manufacturer?: string;
+        product?: number;
+    };
+    /** FIT 特定的性能统计 */
+    performance: {
+        startTime: number;
+        parseTime?: number;
+        extractTime?: number;
+        structureTime?: number;
+        endTime?: number;
+    };
+}

package/dist/FIT/types.js

@@ -0,0 +1 @@
+export {};

package/dist/FIT/util.d.ts

@@ -0,0 +1 @@
+export declare const FITRecordOriginKey: string[];

package/dist/FIT/util.js

@@ -0,0 +1,7 @@
+export const FITRecordOriginKey = [
+    'speed',
+    'power',
+    'cadence',
+    'temperature',
+    'heartRate',
+];

package/dist/GPX/base.d.ts

@@ -1,84 +1,60 @@
-import { Token, TokenAST } from "../types.js";
+import { IPlugin as ICorePlugin, IConverterPlugin as ICoreConverterPlugin, IMiddlewarePlugin as ICoreMiddlewarePlugin, BaseConverter as CoreBaseConverter, BaseMiddleware as CoreBaseMiddleware } from "../core/base.js";
 import { DecoderContext, GPX11Type } from "./types.js";
 /**
- * 插件接口
+ * GPX 插件接口（继承通用插件接口）
  */
-export interface IPlugin {
-    /** 插件名称 */
-    name: string;
-    /** 插件版本 */
-    version?: string;
-    /** 插件描述 */
-    description?: string;
-    /** 依赖的其他插件 */
-    dependencies?: string[];
-    /** 支持的标签 */
-    supportedTags?: string[];
-    /** 插件初始化 */
-    initialize?(context: DecoderContext): Promise<void> | void;
-    /** 插件销毁 */
-    destroy?(context: DecoderContext): Promise<void> | void;
-    /** 插件验证 */
-    validate?(context: DecoderContext): Promise<boolean> | boolean;
+export interface IGPXPlugin extends ICorePlugin<DecoderContext> {
 }
 /**
- * 转换器插件接口
+ * GPX 转换器插件接口（继承通用转换器接口）
  */
-export interface IConverterPlugin extends IPlugin {
-    /** 转换方法 */
-    convert(ast: TokenAST, context: DecoderContext): any | undefined;
-    /** 是否支持该标签 */
-    supports(tag: string): boolean;
-    /** 优先级（数字越小优先级越高） */
-    priority?: number;
+export interface IGPXConverterPlugin extends ICoreConverterPlugin<DecoderContext> {
 }
 /**
- * 中间件插件接口
+ * GPX 中间件插件接口（继承通用中间件接口）
  */
-export interface IMiddlewarePlugin extends IPlugin {
-    /** 在tokenize阶段执行 */
-    onTokenize?(tokens: Token[], context: DecoderContext): Promise<Token[]> | Token[];
-    /** 在AST生成阶段执行 */
-    onAstGenerate?(ast: TokenAST, context: DecoderContext): Promise<TokenAST> | TokenAST;
-    /** 在转换阶段执行 */
-    onConvert?(result: any, context: DecoderContext): Promise<any> | any;
-    /** 在完成阶段执行 */
-    onComplete?(result: GPX11Type, context: DecoderContext): Promise<GPX11Type> | GPX11Type;
-    /** 错误处理 */
-    onError?(error: Error, context: DecoderContext): Promise<void> | void;
+export interface IGPXMiddlewarePlugin extends ICoreMiddlewarePlugin<DecoderContext, GPX11Type> {
 }
 /**
- * 基础转换器抽象类
+ * GPX 基础转换器抽象类（继承通用基础转换器）
  */
-export declare abstract class BaseConverter implements IConverterPlugin {
-    abstract name: string;
-    abstract supportedTags: string[];
-    version: string;
-    priority: number;
-    abstract convert(ast: TokenAST, context: DecoderContext): any | undefined;
-    supports(tag: string): boolean;
-    initialize(context: DecoderContext): Promise<void>;
-    destroy(context: DecoderContext): Promise<void>;
-    validate(context: DecoderContext): Promise<boolean>;
-    protected parseFloat(value: string | number | undefined): number;
-    protected parseString(value: string | number | undefined): string;
-    protected hasRequiredAttributes(ast: TokenAST, required: string[]): boolean;
-    protected extractAttributes<U extends Record<string, any>>(ast: TokenAST, target: U, mapping: Record<string, keyof U>): void;
-    protected processChildren<U extends Record<string, any>>(ast: TokenAST, target: U, processors: Record<string, (child: TokenAST, target: U) => void>): void;
+export declare abstract class BaseGPXConverter extends CoreBaseConverter<DecoderContext> implements IGPXConverterPlugin {
+    /**
+     * 解析 GPX 坐标值（经纬度）
+     */
+    protected parseCoordinate(value: string | number | undefined): number | undefined;
+    /**
+     * 解析 GPX 时间格式
+     */
+    protected parseGPXTime(value: string | undefined): Date | undefined;
+    /**
+     * 提取数值属性（GPX 常用的处理方式）
+     */
+    protected extractNumericAttributes<U extends Record<string, any>>(ast: any, target: U, mapping: Record<string, keyof U>): void;
 }
 /**
- * 基础中间件抽象类
+ * GPX 基础中间件抽象类（继承通用基础中间件）
  */
-export declare abstract class BaseMiddleware implements IMiddlewarePlugin {
-    abstract name: string;
-    version: string;
-    description: string;
-    initialize(context: DecoderContext): Promise<void>;
-    destroy(context: DecoderContext): Promise<void>;
-    validate(context: DecoderContext): Promise<boolean>;
-    onTokenize(tokens: Token[], context: DecoderContext): Promise<Token[]>;
-    onAstGenerate(ast: TokenAST, context: DecoderContext): Promise<TokenAST>;
-    onConvert(result: any, context: DecoderContext): Promise<any>;
-    onComplete(result: GPX11Type, context: DecoderContext): Promise<GPX11Type>;
+export declare abstract class BaseGPXMiddleware extends CoreBaseMiddleware<DecoderContext, GPX11Type> implements IGPXMiddlewarePlugin {
     onError(error: Error, context: DecoderContext): Promise<void>;
 }
+/**
+ * @deprecated 使用 IGPXPlugin 替代
+ */
+export type IPlugin = IGPXPlugin;
+/**
+ * @deprecated 使用 IGPXConverterPlugin 替代
+ */
+export type IConverterPlugin = IGPXConverterPlugin;
+/**
+ * @deprecated 使用 IGPXMiddlewarePlugin 替代
+ */
+export type IMiddlewarePlugin = IGPXMiddlewarePlugin;
+/**
+ * @deprecated 使用 BaseGPXConverter 替代
+ */
+export declare const BaseConverter: typeof BaseGPXConverter;
+/**
+ * @deprecated 使用 BaseGPXMiddleware 替代
+ */
+export declare const BaseMiddleware: typeof BaseGPXMiddleware;

package/dist/GPX/base.js

@@ -1,83 +1,56 @@
-// ============ 基础工具类 ============
+import { BaseConverter as CoreBaseConverter, BaseMiddleware as CoreBaseMiddleware, } from "../core/base.js";
+// ============ GPX 特定基础类 ============
 /**
- * 基础转换器抽象类
+ * GPX 基础转换器抽象类（继承通用基础转换器）
  */
-export class BaseConverter {
-    constructor() {
-        this.version = "1.0.0";
-        this.priority = 100;
-    }
-    supports(tag) {
-        return this.supportedTags.includes(tag);
-    }
-    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;
-    }
-    // 工具方法
-    parseFloat(value) {
-        if (typeof value === "number")
-            return value;
-        if (typeof value === "string")
-            return parseFloat(value) || 0;
-        return 0;
-    }
-    parseString(value) {
-        return String(value || "");
-    }
-    hasRequiredAttributes(ast, required) {
-        return required.every((attr) => ast.attributes?.[attr]);
-    }
-    extractAttributes(ast, target, mapping) {
+export class BaseGPXConverter extends CoreBaseConverter {
+    // GPX 特定的工具方法可以在这里添加
+    /**
+     * 解析 GPX 坐标值（经纬度）
+     */
+    parseCoordinate(value) {
+        const coord = this.parseFloat(value);
+        return coord === 0 ? undefined : coord;
+    }
+    /**
+     * 解析 GPX 时间格式
+     */
+    parseGPXTime(value) {
+        if (!value)
+            return undefined;
+        // GPX 使用 ISO 8601 格式
+        const date = new Date(value);
+        return isNaN(date.getTime()) ? undefined : date;
+    }
+    /**
+     * 提取数值属性（GPX 常用的处理方式）
+     */
+    extractNumericAttributes(ast, target, mapping) {
         if (!ast.attributes)
             return;
         Object.entries(ast.attributes).forEach(([key, value]) => {
             const targetKey = mapping[key];
-            if (targetKey && targetKey in target) {
+            if (targetKey && targetKey in target && typeof value !== "undefined") {
                 target[targetKey] = this.parseFloat(value);
             }
         });
     }
-    processChildren(ast, target, processors) {
-        ast.children?.forEach((child) => {
-            const processor = processors[child.tag];
-            if (processor) {
-                processor(child, target);
-            }
-        });
-    }
 }
 /**
- * 基础中间件抽象类
+ * GPX 基础中间件抽象类（继承通用基础中间件）
  */
-export class BaseMiddleware {
-    constructor() {
-        this.version = "1.0.0";
-        this.description = "";
-    }
-    async initialize(context) { }
-    async destroy(context) { }
-    async validate(context) {
-        return true;
-    }
-    async onTokenize(tokens, context) {
-        return tokens;
-    }
-    async onAstGenerate(ast, context) {
-        return ast;
-    }
-    async onConvert(result, context) {
-        return result;
-    }
-    async onComplete(result, context) {
-        return result;
-    }
+export class BaseGPXMiddleware extends CoreBaseMiddleware {
+    // GPX 特定的中间件逻辑可以在这里添加
     async onError(error, context) {
-        console.error(`中间件 ${this.name} 处理错误:`, error);
+        console.error(`GPX中间件 ${this.name} 处理错误:`, error);
+        context.warnings.push(`中间件 ${this.name} 错误: ${error.message}`);
     }
 }
+/**
+ * @deprecated 使用 BaseGPXConverter 替代
+ */
+export const BaseConverter = BaseGPXConverter;
+/**
+ * @deprecated 使用 BaseGPXMiddleware 替代
+ */
+export const BaseMiddleware = BaseGPXMiddleware;

package/dist/GPX/converters.d.ts

@@ -1,10 +1,10 @@
-import { BaseConverter, BaseMiddleware } from "./base.js";
-import { TokenAST, Token } from "../types.js";
+import { BaseGPXConverter } from "./base.js";
+import { TokenAST } from "../types.js";
 import { BoundsType, CopyrightType, EmailType, LinkType, MetadataType, PersonType, RteType, TrksegType, TrkType, WptType, DecoderContext } from "./types.js";
 /**
  * WPT转换器
  */
-export declare class WptConverter extends BaseConverter {
+export declare class WptConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     version: string;
@@ -13,7 +13,7 @@ export declare class WptConverter extends BaseConverter {
 /**
  * Route转换器
  */
-export declare class RteConverter extends BaseConverter {
+export declare class RteConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): RteType | undefined;
@@ -21,7 +21,7 @@ export declare class RteConverter extends BaseConverter {
 /**
  * Track转换器
  */
-export declare class TrkConverter extends BaseConverter {
+export declare class TrkConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): TrkType | undefined;
@@ -29,7 +29,7 @@ export declare class TrkConverter extends BaseConverter {
 /**
  * Track Segment转换器
  */
-export declare class TrksegConverter extends BaseConverter {
+export declare class TrksegConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): TrksegType | undefined;
@@ -37,7 +37,7 @@ export declare class TrksegConverter extends BaseConverter {
 /**
  * Link转换器
  */
-export declare class LinkConverter extends BaseConverter {
+export declare class LinkConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): LinkType | undefined;
@@ -45,7 +45,7 @@ export declare class LinkConverter extends BaseConverter {
 /**
  * Metadata转换器
  */
-export declare class MetadataConverter extends BaseConverter {
+export declare class MetadataConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): MetadataType | undefined;
@@ -53,7 +53,7 @@ export declare class MetadataConverter extends BaseConverter {
 /**
  * Person转换器
  */
-export declare class PersonConverter extends BaseConverter {
+export declare class PersonConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): PersonType | undefined;
@@ -61,7 +61,7 @@ export declare class PersonConverter extends BaseConverter {
 /**
  * Email转换器
  */
-export declare class EmailConverter extends BaseConverter {
+export declare class EmailConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): EmailType | undefined;
@@ -69,7 +69,7 @@ export declare class EmailConverter extends BaseConverter {
 /**
  * Copyright转换器
  */
-export declare class CopyrightConverter extends BaseConverter {
+export declare class CopyrightConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): CopyrightType | undefined;
@@ -77,32 +77,8 @@ export declare class CopyrightConverter extends BaseConverter {
 /**
  * Bounds转换器
  */
-export declare class BoundsConverter extends BaseConverter {
+export declare class BoundsConverter extends BaseGPXConverter {
     name: string;
     supportedTags: string[];
     convert(ast: TokenAST, context: DecoderContext): BoundsType | undefined;
 }
-/**
- * 性能监控中间件
- */
-export declare class PerformanceMiddleware extends BaseMiddleware {
-    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 BaseMiddleware {
-    name: string;
-    description: string;
-    onComplete(result: any, context: DecoderContext): Promise<any>;
-    private validateGPX;
-}
-/**
- * 注册所有默认中间件
- */
-export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;