trackswap 0.0.1

package/dist/GPX/processor.js

@@ -0,0 +1,187 @@
+import { Parser } from "htmlparser2";
+/**
+ * 流水线阶段
+ */
+export var PipelineStage;
+(function (PipelineStage) {
+    PipelineStage["TOKENIZE"] = "tokenize";
+    PipelineStage["AST_GENERATE"] = "ast_generate";
+    PipelineStage["CONVERT"] = "convert";
+    PipelineStage["COMPLETE"] = "complete";
+})(PipelineStage || (PipelineStage = {}));
+/**
+ * Tokenize处理器
+ */
+export class TokenizeProcessor {
+    constructor() {
+        this.stage = PipelineStage.TOKENIZE;
+    }
+    async process(context) {
+        const startTime = Date.now();
+        if (!context.xmlContent) {
+            throw new Error("XML内容不能为空");
+        }
+        const tokens = [];
+        const parser = new Parser({
+            onopentag(name, attribs) {
+                tokens.push({
+                    type: "open",
+                    tag: name,
+                    attributes: attribs,
+                });
+            },
+            ontext(text) {
+                const filteredText = text.replace(/\n/g, "").trim();
+                if (filteredText) {
+                    tokens.push({ type: "text", tag: "text", value: filteredText });
+                }
+            },
+            onclosetag(name) {
+                tokens.push({ type: "close", tag: name });
+            },
+        }, { xmlMode: true });
+        parser.write(context.xmlContent);
+        parser.end();
+        context.tokens = tokens;
+        context.performance.tokenizeTime = Date.now() - startTime;
+        return context;
+    }
+}
+/**
+ * AST生成处理器
+ */
+export class AstGenerateProcessor {
+    constructor() {
+        this.stage = PipelineStage.AST_GENERATE;
+    }
+    async process(context) {
+        const startTime = Date.now();
+        if (!context.tokens) {
+            throw new Error("Tokens不能为空");
+        }
+        const stack = [];
+        let root = undefined;
+        let current = null;
+        for (const token of context.tokens) {
+            if (token.type === "open") {
+                const newElement = {
+                    tag: token.tag,
+                    attributes: token.attributes || {},
+                    children: [],
+                };
+                if (!root) {
+                    root = newElement;
+                }
+                else if (current) {
+                    current.children?.push(newElement);
+                }
+                stack.push(newElement);
+                current = newElement;
+            }
+            else if (token.type === "text" && current) {
+                current.value = token.value;
+            }
+            else if (token.type === "close") {
+                stack.pop();
+                current = stack[stack.length - 1] || null;
+            }
+        }
+        context.ast = root;
+        context.performance.astTime = Date.now() - startTime;
+        return context;
+    }
+}
+/**
+ * 转换处理器
+ */
+export class ConvertProcessor {
+    constructor(getConverter) {
+        this.getConverter = getConverter;
+        this.stage = PipelineStage.CONVERT;
+    }
+    async process(context) {
+        const startTime = Date.now();
+        if (!context.ast) {
+            throw new Error("AST不能为空");
+        }
+        const gpx = {};
+        // 处理根节点属性
+        if (context.ast.attributes) {
+            Object.entries(context.ast.attributes).forEach(([key, value]) => {
+                if (key.startsWith("xmlns:")) {
+                    gpx[key] = value.replace(/'/g, "'");
+                }
+                else if (key === "xsi:schemaLocation") {
+                    gpx[key] = value.replace(/'/g, "'");
+                }
+                else {
+                    gpx[key] = value;
+                }
+            });
+        }
+        // 处理子节点
+        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);
+                }
+            }
+        });
+        context.result = gpx;
+        context.performance.convertTime = Date.now() - startTime;
+        return context;
+    }
+    assignResult(gpx, tag, result) {
+        switch (tag) {
+            case "metadata":
+                gpx.metadata = result;
+                break;
+            case "wpt":
+                if (!gpx.wpt)
+                    gpx.wpt = [];
+                gpx.wpt.push(result);
+                break;
+            case "rte":
+                if (!gpx.rte)
+                    gpx.rte = [];
+                gpx.rte.push(result);
+                break;
+            case "trk":
+                if (!gpx.trk)
+                    gpx.trk = [];
+                gpx.trk.push(result);
+                break;
+            case "extensions":
+                gpx.extensions = result;
+                break;
+        }
+    }
+}
+/**
+ * 完成处理器
+ */
+export class CompleteProcessor {
+    constructor() {
+        this.stage = PipelineStage.COMPLETE;
+    }
+    async process(context) {
+        context.performance.endTime = Date.now();
+        // 记录性能指标
+        const totalTime = context.performance.endTime - context.performance.startTime;
+        context.metadata.set("performance", {
+            totalTime,
+            tokenizeTime: context.performance.tokenizeTime,
+            astTime: context.performance.astTime,
+            convertTime: context.performance.convertTime,
+        });
+        return context;
+    }
+}

package/dist/GPX/types.d.ts

@@ -0,0 +1,230 @@
+import { DegreesType, ExtensionsType, LatitudeType, LongitudeType, Token, TokenAST } from "../types.js";
+/**
+ * Two lat/lon pairs defining the extent of an element.
+ */
+export interface BoundsType {
+    minlat?: LatitudeType;
+    minlon?: LongitudeType;
+    maxlat?: LatitudeType;
+    maxlon?: LongitudeType;
+}
+export interface PersonType {
+    name?: string;
+    email?: EmailType;
+    link?: LinkType;
+}
+export interface CopyrightType {
+    author?: string;
+    year?: string;
+    license?: string;
+}
+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;
+    xmlns?: string;
+    "xmlns:gte"?: string;
+    "xmlns:xsi"?: string;
+    "xsi:schemaLocation"?: string;
+    metadata?: MetadataType;
+    wpt?: WptType[];
+    rte?: RteType[];
+    trk?: TrkType[];
+    extensions?: any;
+    [key: string]: any | undefined;
+}
+export interface MetadataType {
+    name?: string;
+    desc?: string;
+    /**
+     * The person or organization who created the GPX file.
+     */
+    author?: PersonType;
+    copyright?: CopyrightType;
+    link?: LinkType[];
+    time?: Date;
+    keywords?: string;
+    bounds?: BoundsType;
+    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[];
+}
+export interface TrkType {
+    name?: string;
+    cmt?: string;
+    desc?: string;
+    src?: string;
+    link?: LinkType[];
+    number?: number;
+    type?: string;
+    extensions?: ExtensionsType;
+    trkseg?: TrksegType[];
+}
+export interface TrksegType {
+    trkpt?: WptType[];
+    extensions?: ExtensionsType;
+}
+export interface DecoderContext {
+    rawData?: Buffer;
+    xmlContent?: string;
+    tokens?: Token[];
+    ast?: TokenAST;
+    result?: GPX11Type;
+    metadata: Map<string, any>;
+    errors: Error[];
+    performance: {
+        startTime: number;
+        tokenizeTime?: number;
+        astTime?: number;
+        convertTime?: number;
+        endTime?: number;
+    };
+}
+export {};

package/dist/GPX/types.js

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

package/dist/GPX/util.d.ts

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

package/dist/GPX/util.js

@@ -0,0 +1,18 @@
+export const GPXWPTOriginKey = [
+    'magvar',
+    'geoidheight',
+    'name',
+    'cmt',
+    'src',
+    'link',
+    'sym',
+    'type',
+    'fix',
+    'sat',
+    'desc',
+    'hdop',
+    'vdop',
+    'pdop',
+    'ageofdgpsdata',
+    'dgpsid',
+];

package/dist/TrackSwap.d.ts

@@ -0,0 +1,47 @@
+import { GPXDecoder, GPXEncoder } from "./GPX/index.js";
+import { GPX11Type } from "./GPX/types.js";
+/**
+ * GPX轨迹交换处理类
+ * 提供GPX文件的解析和编码功能
+ */
+export declare class TrackSwap {
+    private decoder;
+    private encoder;
+    constructor();
+    /**
+     * 解析GPX文件Buffer为GPX对象
+     */
+    parseGPX(buffer: Buffer): Promise<GPX11Type | undefined>;
+    /**
+     * 解析GPX文件字符串为GPX对象
+     */
+    parseGPXString(xmlString: string): Promise<GPX11Type | undefined>;
+    /**
+     * 编码GPX对象为Buffer
+     */
+    encodeGPX(gpxData: GPX11Type): Promise<Buffer>;
+    /**
+     * 编码GPX对象为XML字符串
+     */
+    encodeGPXString(gpxData: GPX11Type): string;
+    /**
+     * 获取解码器实例
+     */
+    getDecoder(): GPXDecoder;
+    /**
+     * 获取编码器实例
+     */
+    getEncoder(): GPXEncoder;
+    /**
+     * 销毁实例，清理资源
+     */
+    destroy(): Promise<void>;
+    /**
+     * @deprecated 使用 encodeGPX() 替代
+     */
+    encoderGPX(gpx: GPX11Type): Promise<Buffer>;
+}
+declare const _default: {
+    TrackSwap: typeof TrackSwap;
+};
+export default _default;

package/dist/TrackSwap.js

@@ -0,0 +1,84 @@
+import { GPXDecoder, GPXEncoder } from "./GPX/index.js";
+/**
+ * GPX轨迹交换处理类
+ * 提供GPX文件的解析和编码功能
+ */
+export class TrackSwap {
+    constructor() {
+        this.decoder = new GPXDecoder();
+        this.encoder = new GPXEncoder();
+    }
+    // ==================== 解析功能 ====================
+    /**
+     * 解析GPX文件Buffer为GPX对象
+     */
+    async parseGPX(buffer) {
+        try {
+            return await this.decoder.parserByBuffer(buffer);
+        }
+        catch (error) {
+            console.error("GPX解析失败:", error);
+            throw new Error(`GPX解析失败: ${error.message}`);
+        }
+    }
+    /**
+     * 解析GPX文件字符串为GPX对象
+     */
+    async parseGPXString(xmlString) {
+        const buffer = Buffer.from(xmlString, "utf-8");
+        return this.parseGPX(buffer);
+    }
+    // ==================== 编码功能 ====================
+    /**
+     * 编码GPX对象为Buffer
+     */
+    async encodeGPX(gpxData) {
+        try {
+            return await this.encoder.encode(gpxData);
+        }
+        catch (error) {
+            console.error("GPX编码失败:", error);
+            throw new Error(`GPX编码失败: ${error.message}`);
+        }
+    }
+    /**
+     * 编码GPX对象为XML字符串
+     */
+    encodeGPXString(gpxData) {
+        try {
+            return this.encoder.encodeToString(gpxData);
+        }
+        catch (error) {
+            console.error("GPX编码失败:", error);
+            throw new Error(`GPX编码失败: ${error.message}`);
+        }
+    }
+    // ==================== 实例管理 ====================
+    /**
+     * 获取解码器实例
+     */
+    getDecoder() {
+        return this.decoder;
+    }
+    /**
+     * 获取编码器实例
+     */
+    getEncoder() {
+        return this.encoder;
+    }
+    /**
+     * 销毁实例，清理资源
+     */
+    async destroy() {
+        await this.decoder.destroy();
+    }
+    // ==================== 向后兼容 ====================
+    /**
+     * @deprecated 使用 encodeGPX() 替代
+     */
+    async encoderGPX(gpx) {
+        return this.encodeGPX(gpx);
+    }
+}
+// 默认导出
+export default { TrackSwap };

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+import { TrackSwap } from "./TrackSwap.js";
+import GPXManager from "./GPX/index.js";
+import { Token, TokenAST, AttributeType, LatitudeType, LongitudeType, DegreesType, ExtensionsType } from "./types.js";
+export { TokenAST, AttributeType, LatitudeType, LongitudeType, DegreesType, ExtensionsType, Token, TrackSwap, };
+export { GPXManager };
+export default TrackSwap;

package/dist/index.js

@@ -0,0 +1,5 @@
+import { TrackSwap } from "./TrackSwap.js";
+import GPXManager from "./GPX/index.js";
+export { TrackSwap, };
+export { GPXManager };
+export default TrackSwap;

package/dist/types.d.ts

@@ -0,0 +1,34 @@
+export interface Token {
+    type: "open" | "close" | "text";
+    tag: string;
+    attributes?: AttributeType;
+    value?: string | number;
+}
+export interface TokenAST {
+    tag: string;
+    attributes?: AttributeType;
+    children?: TokenAST[];
+    value?: string | number;
+}
+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;
+}

package/dist/types.js

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

package/package.json

@@ -0,0 +1,63 @@
+{
+  "name": "trackswap",
+  "version": "0.0.1",
+  "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",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist/**/*",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "ts-node src/index.ts",
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test:gpx": "cd example/gpx && rm -f output* test_*.json *_report.json *_encoded.xml && node test.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "gpx",
+    "gps",
+    "parser",
+    "encoder",
+    "geolocation",
+    "track",
+    "waypoint",
+    "route",
+    "typescript",
+    "node",
+    "xml",
+    "geospatial",
+    "trackswap"
+  ],
+  "author": "buerber1016",
+  "license": "MIT",
+  "type": "module",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/buerber1016/trackswap.git"
+  },
+  "homepage": "https://github.com/buerber1016/trackswap#readme",
+  "bugs": {
+    "url": "https://github.com/buerber1016/trackswap/issues"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.15.24",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {
+    "dayjs": "^1.11.13",
+    "htmlparser2": "^10.0.0"
+  }
+}