trackswap 0.0.1 → 0.0.3

package/dist/GPX/encoder.d.ts

@@ -1,150 +1,45 @@
 import { GPX11Type } from "./types.js";
-/**
- * GPX 编码器 - 将 GPX11Type 数据编码为 GPX XML 格式
- */
 export declare class GPXEncoder {
     private compact;
-    /**
-     * 构造函数
-     * @param options 编码器选项
-     */
     constructor(options?: {
         compact?: boolean;
     });
-    /**
-     * 编码 GPX 数据为 Buffer
-     */
     encode(gpxData: GPX11Type): Promise<Buffer>;
-    /**
-     * 编码 GPX 数据为 XML 字符串
-     */
     encodeToString(gpxData: GPX11Type): string;
-    /**
-     * 构建完整的 GPX XML
-     */
     private buildGPXXML;
-    /**
-     * 压缩XML字符串，去掉多余的换行和空格
-     */
     private compressXML;
-    /**
-     * 构建 XML 头部
-     */
     private buildXMLHeader;
-    /**
-     * 构建 GPX 内容
-     */
     private buildGPXContent;
-    /**
-     * 构建 metadata 元素
-     */
     private buildMetadata;
-    /**
-     * 构建 author 元素
-     */
     private buildAuthor;
-    /**
-     * 构建 copyright 元素
-     */
     private buildCopyright;
-    /**
-     * 构建 bounds 元素
-     */
     private buildBounds;
-    /**
-     * 构建航路点元素
-     */
     private buildWaypoint;
-    /**
-     * 添加标准航路点元素
-     */
     private addStandardWaypointElements;
-    /**
-     * 构建 rte 元素
-     */
     private buildRoute;
-    /**
-     * 构建轨迹元素
-     */
     private buildTrack;
-    /**
-     * 构建轨迹段元素
-     */
     private buildTrackSegment;
-    /**
-     * 添加路线和轨迹的公共元素
-     */
     private addRouteTrackCommonElements;
-    /**
-     * 处理点的扩展属性
-     */
     private processPointExtensions;
-    /**
-     * 构建 TrackPoint 扩展
-     */
     private buildTrackPointExtension;
-    /**
-     * 构建 Power 扩展
-     */
     private buildPowerExtension;
-    /**
-     * 构建 GPX 扩展
-     */
     private buildGpxExtensions;
-    /**
-     * 构建扩展元素
-     */
     private buildExtensions;
-    /**
-     * 递归构建扩展内容
-     */
     private buildExtensionContent;
-    /**
-     * 构建 link 元素
-     */
     private buildLink;
-    /**
-     * 添加多个 link 元素
-     */
     private addLinks;
-    /**
-     * 构建时间元素
-     */
     private buildTimeElement;
-    /**
-     * 添加可选元素
-     */
     private addOptionalElement;
-    /**
-     * 验证坐标有效性
-     */
     private isValidCoordinate;
-    /**
-     * 格式化坐标
-     */
     private formatCoordinate;
-    /**
-     * 格式化高程
-     */
     private formatElevation;
-    /**
-     * 数字四舍五入
-     */
     private roundTo;
-    /**
-     * XML 转义
-     */
     private escapeXML;
-    /**
-     * XML 属性值转义（专门用于属性值的安全转义）
-     */
     private escapeXMLAttribute;
-    /**
-     * 深度拷贝
-     */
     private deepClone;
-    /**
-     * @deprecated 使用 encode() 替代
-     */
     encoder(node: GPX11Type): Promise<Buffer>;
 }
+declare const _default: {
+    GPXEncoder: typeof GPXEncoder;
+};
+export default _default;

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/middleware.d.ts

@@ -0,0 +1,18 @@
+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/processor.d.ts

@@ -1,37 +1,22 @@
 import { DecoderContext } from "./types.js";
-/**
- * 流水线阶段
- */
 export declare enum PipelineStage {
     TOKENIZE = "tokenize",
     AST_GENERATE = "ast_generate",
     CONVERT = "convert",
     COMPLETE = "complete"
 }
-/**
- * 流水线处理器
- */
 export interface IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * Tokenize处理器
- */
 export declare class TokenizeProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * AST生成处理器
- */
 export declare class AstGenerateProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;
 }
-/**
- * 转换处理器
- */
 export declare class ConvertProcessor implements IPipelineProcessor {
     private getConverter;
     stage: PipelineStage;
@@ -39,9 +24,6 @@ export declare class ConvertProcessor implements IPipelineProcessor {
     process(context: DecoderContext): Promise<DecoderContext>;
     private assignResult;
 }
-/**
- * 完成处理器
- */
 export declare class CompleteProcessor implements IPipelineProcessor {
     stage: PipelineStage;
     process(context: DecoderContext): Promise<DecoderContext>;

package/dist/GPX/types.d.ts

@@ -1,7 +1,5 @@
 import { DegreesType, ExtensionsType, LatitudeType, LongitudeType, Token, TokenAST } from "../types.js";
-/**
- * Two lat/lon pairs defining the extent of an element.
- */
+import { IProcessingContext } from "../core/base.js";
 export interface BoundsType {
     minlat?: LatitudeType;
     minlon?: LongitudeType;
@@ -22,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;
@@ -60,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[];
@@ -72,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[];
@@ -211,14 +104,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,19 @@
+import { IPlugin, IConverterPlugin, IMiddlewarePlugin, BaseConverter, BaseMiddleware } from "../core/base.js";
+import { TCXContext, TCXFileType } from "./types.js";
+export interface ITCXPlugin extends IPlugin<TCXContext> {
+}
+export interface ITCXConverterPlugin extends IConverterPlugin<TCXContext> {
+}
+export interface ITCXMiddlewarePlugin extends IMiddlewarePlugin<TCXContext, TCXFileType> {
+}
+export declare abstract class BaseTCXConverter extends BaseConverter<TCXContext> implements ITCXConverterPlugin {
+    protected parseHeartRate(value: string | number | undefined): number | undefined;
+    protected parseTCXTime(value: string | undefined): Date | undefined;
+    protected parseDistance(value: string | number | undefined): number | undefined;
+    protected parseSpeed(value: string | number | undefined): number | undefined;
+    protected parseAltitude(value: string | number | undefined): number | undefined;
+    protected parseCoordinate(value: string | number | undefined): number | undefined;
+}
+export declare abstract class BaseTCXMiddleware extends BaseMiddleware<TCXContext, TCXFileType> implements ITCXMiddlewarePlugin {
+    onError(error: Error, context: TCXContext): Promise<void>;
+}

package/dist/TCX/converters.d.ts

@@ -0,0 +1,51 @@
+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;
+}

package/dist/TCX/decoder.d.ts

@@ -0,0 +1,33 @@
+import { ExtensionsType, TokenAST } from "../types.js";
+import { ITCXConverterPlugin, ITCXMiddlewarePlugin } from "./base.js";
+import { TCXFileType } from "./types.js";
+export declare class TCXDecoder {
+    private converterPlugins;
+    private registeredPlugins;
+    private middlewarePlugins;
+    private processors;
+    private initialized;
+    private defaultConvertersRegistered;
+    constructor();
+    private initializePipeline;
+    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>;
+    convertExtensions(extensionsAST: TokenAST): ExtensionsType;
+    parserByBuffer(buffer: Buffer): Promise<TCXFileType | undefined>;
+    parseByString(xmlContent: string): Promise<TCXFileType | undefined>;
+}
+declare const _default: {
+    TCXDecoder: typeof TCXDecoder;
+};
+export default _default;

package/dist/TCX/encoder.d.ts

@@ -0,0 +1,41 @@
+import { TCXFileType } from "./types.js";
+export declare class TCXEncoder {
+    private compact;
+    constructor(options?: {
+        compact?: boolean;
+    });
+    encode(tcxData: TCXFileType): Promise<Buffer>;
+    encodeToString(tcxData: TCXFileType): string;
+    private buildTCXXML;
+    private compressXML;
+    private buildXMLHeader;
+    private buildTCXContent;
+    private buildFolders;
+    private buildHistory;
+    private buildHistoryFolder;
+    private buildActivities;
+    private buildActivity;
+    private buildActivityLap;
+    private buildTrack;
+    private buildTrackpoint;
+    private buildPosition;
+    private buildCadence;
+    private buildMultiSportSession;
+    private buildFirstSport;
+    private buildNextSport;
+    private buildWorkouts;
+    private buildCourses;
+    private buildAuthor;
+    private buildExtensions;
+    private buildExtensionContent;
+    private formatTime;
+    private addOptionalElement;
+    private addOptionalNumericElement;
+    private isValidCoordinate;
+    private formatCoordinate;
+    private roundTo;
+    private escapeXML;
+    private escapeXMLAttribute;
+    private deepClone;
+    encoder(node: TCXFileType): Promise<Buffer>;
+}

package/dist/TCX/index.d.ts

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

package/dist/TCX/middleware.d.ts

@@ -0,0 +1,18 @@
+import { Token, TokenAST } from "../types.js";
+import { BaseTCXMiddleware } from "./base.js";
+import { TCXContext } from "./types.js";
+export declare class PerformanceMiddleware extends BaseTCXMiddleware {
+    name: string;
+    description: string;
+    onTokenize(tokens: Token[], context: TCXContext): Promise<Token[]>;
+    onAstGenerate(ast: TokenAST, context: TCXContext): Promise<TokenAST>;
+    onComplete(result: any, context: TCXContext): Promise<any>;
+    private countNodes;
+}
+export declare class ValidationMiddleware extends BaseTCXMiddleware {
+    name: string;
+    description: string;
+    onComplete(result: any, context: TCXContext): Promise<any>;
+    private validateGPX;
+}
+export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;

package/dist/TCX/processor.d.ts

@@ -0,0 +1,30 @@
+import { TCXContext } from "./types.js";
+export declare enum PipelineStage {
+    TOKENIZE = "tokenize",
+    AST_GENERATE = "ast_generate",
+    CONVERT = "convert",
+    COMPLETE = "complete"
+}
+export interface IPipelineProcessor {
+    stage: PipelineStage;
+    process(context: TCXContext): Promise<TCXContext>;
+}
+export declare class TokenizeProcessor implements IPipelineProcessor {
+    stage: PipelineStage;
+    process(context: TCXContext): Promise<TCXContext>;
+}
+export declare class AstGenerateProcessor implements IPipelineProcessor {
+    stage: PipelineStage;
+    process(context: TCXContext): Promise<TCXContext>;
+}
+export declare class ConvertProcessor implements IPipelineProcessor {
+    private getConverter;
+    stage: PipelineStage;
+    constructor(getConverter: (tag: string) => any);
+    process(context: TCXContext): Promise<TCXContext>;
+    private assignResult;
+}
+export declare class CompleteProcessor implements IPipelineProcessor {
+    stage: PipelineStage;
+    process(context: TCXContext): Promise<TCXContext>;
+}