trackswap 0.2.2 → 0.2.4

package/dist/FIT/health.d.ts

@@ -1,122 +1,309 @@
 import { BaseFITStructurePlugin } from "./base.js";
 import type { FITContext } from "./types.js";
+/** High-level content categories detected in a decoded FIT file. */
 export type FITPrimaryKind = 'activity' | 'health' | 'workout' | 'course' | 'device' | 'unknown';
+/**
+ * Canonical metric identifiers emitted by the Health IR.
+ *
+ * Stable built-in identifiers include their physical unit where ambiguity
+ * would otherwise be likely (for example `_bpm`, `_m`, `_s`, and `_kcal`).
+ * Unstandardized values must use the `vendor:` namespace.
+ *
+ * Unit conventions:
+ * - heart/respiration rates: beats or breaths per minute;
+ * - distance/ascent/descent: metres;
+ * - activity durations: seconds;
+ * - energy: kilocalories;
+ * - SpO2: percent;
+ * - HRV RMSSD: milliseconds;
+ * - temperature and temperature deviations: degrees Celsius;
+ * - stress and Body Battery values: vendor-defined scores.
+ */
 export type HealthMetricCode = 'heart_rate_bpm' | 'resting_heart_rate_bpm' | 'resting_heart_rate_7_day_bpm' | 'steps' | 'distance_m' | 'active_time_s' | 'moderate_activity_time_s' | 'vigorous_activity_time_s' | 'active_energy_kcal' | 'total_energy_kcal' | 'stress_level' | 'respiration_rate_bpm' | 'spo2_percent' | 'body_battery_level' | 'body_battery_charged' | 'body_battery_drained' | 'hrv_rmssd_ms' | 'temperature_c' | 'wrist_temperature_c' | 'skin_temperature_deviation_c' | 'skin_temperature_7_day_deviation_c' | 'skin_temperature_nightly_c' | 'ascent_m' | 'descent_m' | `vendor:${string}`;
+/**
+ * Measurement usability independently of the numeric value.
+ *
+ * Only `valid` values are safe to use in ordinary physiological aggregates.
+ * Other statuses are retained as observation and data-quality facts. When a
+ * FIT sentinel produces a non-valid status, `value` is normally omitted and
+ * the decoded sentinel may be retained in `attributes.rawValue` for audit.
+ *
+ * Status meanings:
+ * - `valid`: usable measurement;
+ * - `invalid`: malformed, impossible, or explicitly invalid source value;
+ * - `off_wrist`: wearable contact was absent;
+ * - `motion`: motion prevented a reliable measurement;
+ * - `low_confidence`: a value exists but source confidence is insufficient;
+ * - `not_enough_data`: the source could not collect enough evidence;
+ * - `recovering`: the source algorithm is still establishing a baseline;
+ * - `unidentified`: the source reported an unclassified state;
+ * - `gap`: expected sample was absent or represented by a blank sentinel;
+ * - `unknown`: source status could not be normalized safely.
+ */
 export type HealthValueStatus = 'valid' | 'invalid' | 'off_wrist' | 'motion' | 'low_confidence' | 'not_enough_data' | 'recovering' | 'unidentified' | 'gap' | 'unknown';
+/** Pointer back to the decoded FIT message and field that produced a value. */
 export type HealthMessagePointerV1 = {
+    /** Garmin FIT SDK message collection name, such as `monitoringMesgs`. */
     messageName: string;
+    /** Zero-based index within the message collection. */
     messageIndex: number;
+    /** Source field name when the normalized value came from one field. */
     fieldName?: string;
+    /** Whether `fieldName` refers to a FIT developer field. */
     developerField?: boolean;
 };
+/** A point-in-time health measurement or measurement-status observation. */
 export type HealthPointV1 = {
+    /** Canonical metric identifier. */
     metric: HealthMetricCode;
+    /** Absolute observation instant. Serialized as an ISO 8601 UTC timestamp. */
     timestamp: Date;
+    /**
+     * Local wall-clock timestamp without a zone suffix.
+     *
+     * Interpret it together with `offsetSeconds`; it is not another instant.
+     */
     localTimestamp?: string;
+    /** UTC offset at `timestamp`, in seconds (for example `28800` is UTC+08:00). */
     offsetSeconds?: number;
+    /**
+     * Normalized numeric value in `unit`.
+     *
+     * Usually absent when `status !== 'valid'`; never interpret an absent value
+     * or `attributes.rawValue` as a physiological measurement.
+     */
     value?: number;
+    /** Unit of `value`, such as `bpm`, `breaths/min`, `percent`, or `score`. */
     unit: string;
+    /** Measurement usability and, for non-valid samples, the missing-data reason. */
     status: HealthValueStatus;
+    /** Source-provided confidence when available; its scale is metric-specific. */
     quality?: number;
+    /** Statistical meaning of this point in the source file. */
     aggregation?: 'instant' | 'mean' | 'min' | 'max' | 'sum' | 'latest';
+    /** FIT source location for audit and deterministic identity. */
     source: HealthMessagePointerV1;
+    /**
+     * Additional source metadata. For non-valid samples, `rawValue` may contain
+     * the original FIT sentinel solely for diagnostics and round-trip audit.
+     */
     attributes?: Record<string, string | number | boolean | null>;
 };
+/** A health value or state covering the half-open range `[startTime, endTime)`. */
 export type HealthIntervalV1 = {
+    /** Canonical metric identifier. */
     metric: HealthMetricCode;
+    /** Absolute inclusive start instant. */
     startTime: Date;
+    /** Absolute exclusive end instant. */
     endTime: Date;
+    /** Local wall-clock start without a zone suffix; pair with `offsetSeconds`. */
     localStartTime?: string;
+    /** UTC offset at `startTime`, in seconds. */
     offsetSeconds?: number;
+    /** Normalized interval value; absent when no usable numeric value exists. */
     value?: number;
+    /** Unit of `value`. */
     unit: string;
+    /** Measurement usability for the interval. */
     status: HealthValueStatus;
+    /** Source activity classification when the FIT message provides one. */
     activityType?: string;
+    /** Source intensity classification when the FIT message provides one. */
     intensity?: string;
+    /** FIT source location for audit and deterministic event identity. */
     source: HealthMessagePointerV1;
+    /** Additional normalized or source-specific metadata. */
     attributes?: Record<string, string | number | boolean | null>;
 };
+/** A non-sampled aggregate or device/window summary from the FIT file. */
 export type HealthSummaryV1 = {
+    /** Semantic category of the summary. */
     summaryType: 'daily' | 'sleep' | 'hrv_status' | 'monitoring_window' | 'device';
+    /** Stable source-derived identifier suitable for idempotent upsert. */
     externalId: string;
+    /** Source-local calendar date in `YYYY-MM-DD` form, when defined. */
     calendarDate?: string;
+    /** Absolute start instant of the summarized range, when defined. */
     startTime?: Date;
+    /** Absolute end instant of the summarized range, when defined. */
     endTime?: Date;
+    /** UTC offset associated with the summary, in seconds. */
     offsetSeconds?: number;
+    /** Named summary values; keys are summary-type specific. */
     metrics: Record<string, number | string | boolean | null>;
+    /** FIT source location. */
     source: HealthMessagePointerV1;
 };
+/** One staged portion of a sleep or other health session. */
 export type HealthSessionSegmentV1 = {
+    /** Normalized segment stage or a vendor-namespaced extension. */
     segmentType: 'awake' | 'light' | 'deep' | 'rem' | 'unmeasurable' | 'sleeping' | `vendor:${string}`;
+    /** Absolute inclusive start instant. */
     startTime: Date;
+    /** Absolute exclusive end instant. */
     endTime: Date;
+    /** Segment usability. */
     status: HealthValueStatus;
+    /** FIT source location. */
     source: HealthMessagePointerV1;
 };
+/** A bounded health session such as sleep, a nap, or a health snapshot. */
 export type HealthSessionV1 = {
+    /** Normalized session category or a vendor-namespaced extension. */
     sessionType: 'sleep' | 'nap' | 'health_snapshot' | `vendor:${string}`;
+    /** Stable source-derived identifier suitable for idempotent upsert. */
     externalId: string;
+    /** Absolute inclusive session start instant. */
     startTime: Date;
+    /** Absolute exclusive session end instant. */
     endTime: Date;
+    /** UTC offset at `startTime`, in seconds; this is not a duration. */
     startOffsetSeconds?: number;
+    /** UTC offset at `endTime`, in seconds; may differ across a DST transition. */
     endOffsetSeconds?: number;
+    /** Source-local session date in `YYYY-MM-DD` form. */
     calendarDate?: string;
+    /** Source tombstone indicating that a previously emitted session was deleted. */
     deleted?: boolean;
+    /** Ordered session stages; may be empty when the source only supplies bounds. */
     segments: HealthSessionSegmentV1[];
+    /** Session-level values whose keys depend on `sessionType`. */
     metrics: Record<string, number | string | boolean | null>;
+    /** FIT source location. */
     source: HealthMessagePointerV1;
+    /** Additional source metadata, such as automatic/manual origin or update time. */
     attributes?: Record<string, string | number | boolean | null>;
 };
+/** A recoverable parser warning with an optional FIT source pointer. */
 export type FITDiagnosticWarningV1 = {
+    /** Stable machine-readable warning code. */
     code: string;
+    /** Human-readable diagnostic message. */
     message: string;
+    /** FIT source location when the warning belongs to one message or field. */
     source?: HealthMessagePointerV1;
 };
+/** Parse coverage, invalid-value counts, and bounded warning diagnostics. */
 export type FITDiagnosticsV1 = {
+    /** Garmin FIT SDK profile version used for decoding. */
     sdkProfileVersion?: string;
+    /** TrackSwap Health IR parser version that produced this document. */
     parserVersion: string;
+    /** Total decoded message count keyed by Garmin SDK message collection name. */
     messageCounts: Record<string, number>;
+    /** Counts for message collections recognized by the Health IR parser. */
     recognizedMessageCounts: Record<string, number>;
+    /** Counts for decoded collections not recognized by the Health IR parser. */
     unknownMessageCounts: Record<string, number>;
+    /** Non-valid sample counts keyed as `<metric>:<status>`. */
     invalidValueCounts: Record<string, number>;
+    /** Complete warning count by code, including warnings omitted from `warnings`. */
     warningCounts: Record<string, number>;
+    /**
+     * Bounded warning examples. Repeated warnings are sampled to avoid unbounded
+     * diagnostic payloads; use `warningCounts` for their full cardinality.
+     */
     warnings: FITDiagnosticWarningV1[];
+    /** Raw unknown messages, present only when explicitly requested. */
     unknownMessages?: Record<string, unknown[]>;
 };
+/** Canonical, provider-neutral Health Intermediate Representation (Health IR). */
 export type HealthDocumentV1 = {
+    /** Health IR schema version. */
     schemaVersion: '1';
+    /** Earliest absolute instant observed in the health content. */
     observedStart?: Date;
+    /** Latest absolute instant observed in the health content. */
     observedEnd?: Date;
+    /** Timezone evidence used to derive local wall-clock fields and dates. */
     timezone: {
+        /**
+         * Provenance of the selected offsets: explicit FIT offset, timestamp
+         * correlation, conservative inference, or no usable timezone evidence.
+         */
         strategy: 'explicit_offset' | 'timestamp_correlation' | 'inferred' | 'unknown';
+        /**
+         * Chronological UTC-offset anchors. Each offset applies from `at` until the
+         * next anchor; `offsetSeconds` is seconds east of UTC.
+         */
         offsets: Array<{
             at: Date;
             offsetSeconds: number;
         }>;
     };
+    /** Point-in-time measurements and non-valid measurement-status observations. */
     points: HealthPointV1[];
+    /** Duration-based values and states. */
     intervals: HealthIntervalV1[];
+    /** Aggregate source summaries that should not be treated as sampled series. */
     summaries: HealthSummaryV1[];
+    /** Bounded sessions such as sleep, naps, and health snapshots. */
     sessions: HealthSessionV1[];
+    /** Parser version, coverage, invalid values, and warning diagnostics. */
     diagnostics: FITDiagnosticsV1;
 };
+/** Options controlling FIT document normalization and diagnostic retention. */
 export type FITDocumentParseOptions = {
+    /** Retain decoded message collections not recognized by the Health parser. */
     includeUnknownMessages?: boolean;
+    /** Retain FIT developer fields when supported by the decoder. */
     includeDeveloperFields?: boolean;
+    /** Fail on recoverable parse problems instead of returning diagnostics. */
     strict?: boolean;
+    /** Health-specific normalization options. */
     health?: {
+        /**
+         * Reconstruct intervals/deltas from cumulative monitoring counters.
+         * Defaults to enabled.
+         */
         reconstructIntervals?: boolean;
+        /**
+         * Also retain raw cumulative counter points when interval reconstruction is
+         * enabled. Defaults to disabled to prevent accidental double counting.
+         */
         retainCumulativeValues?: boolean;
     };
 };
+/** Garmin FIT SDK message collections keyed by their plural message name. */
 export type FITMessages = Record<string, unknown[] | undefined>;
-export declare const TRACKSWAP_HEALTH_PARSER_VERSION = "trackswap-0.2.2-health-ir-v1";
-export declare function detectFITKinds(messages: FITMessages): FITPrimaryKind[];
-export declare function buildHealthDocumentFromMessages(messages: FITMessages, options?: FITDocumentParseOptions, environment?: {
+/** Decoder environment metadata recorded in Health IR diagnostics. */
+export type FITHealthBuildEnvironment = {
+    /** Garmin FIT SDK profile version used to decode `messages`. */
     sdkProfileVersion?: string;
-}): HealthDocumentV1;
+};
+/** Parser revision embedded in `HealthDocumentV1.diagnostics.parserVersion`. */
+export declare const TRACKSWAP_HEALTH_PARSER_VERSION = "trackswap-health-ir-v1";
+/**
+ * Detects every high-level content kind represented by decoded FIT messages.
+ *
+ * The result may contain more than one kind for mixed-content files. It falls
+ * back to `unknown` when no supported evidence is present.
+ */
+export declare function detectFITKinds(messages: FITMessages): FITPrimaryKind[];
+/**
+ * Normalizes Garmin FIT SDK message collections into Health IR schema v1.
+ *
+ * Absolute timestamps are represented as `Date` values. Local wall-clock
+ * fields never replace those instants and must be interpreted with their UTC
+ * offset. Garmin sentinel values are mapped to `HealthValueStatus`; non-valid
+ * sentinels are not emitted as physiological numeric values.
+ *
+ * @param messages Decoded Garmin FIT SDK message collections.
+ * @param options Normalization and diagnostic-retention options.
+ * @param environment Decoder metadata that affects diagnostics, not values.
+ * @returns A deterministic, chronologically ordered Health IR document.
+ */
+export declare function buildHealthDocumentFromMessages(messages: FITMessages, options?: FITDocumentParseOptions, environment?: FITHealthBuildEnvironment): HealthDocumentV1;
+/**
+ * FIT structure plugin that attaches detected content kinds and a normalized
+ * Health IR facet to TrackSwap's decoded FIT document.
+ */
 export declare class HealthStructurePlugin extends BaseFITStructurePlugin {
+    /** Stable plugin identifier. */
     name: string;
+    /** Structure-plugin execution priority. */
     priority: number;
+    /** Builds the health facet and FIT document metadata for decoded messages. */
     structureData(messages: FITMessages, context: FITContext): Partial<import('./types.js').FITFileType>;
 }

package/dist/FIT/index.d.ts

@@ -3,7 +3,7 @@ export { FITEncoder } from "./encoder.js";
 export { IFITMessageConverter, IFITStructurePlugin, IFITMiddlewarePlugin, BaseFITMessageConverter, BaseFITStructurePlugin, BaseFITMiddleware, } from "./base.js";
 export { SessionStructurePlugin, CourseStructurePlugin, FileHeaderPlugin, } from "./plugins.js";
 export { HealthStructurePlugin, buildHealthDocumentFromMessages, detectFITKinds, TRACKSWAP_HEALTH_PARSER_VERSION, } from "./health.js";
-export type { FITDocumentParseOptions, FITPrimaryKind, FITDiagnosticsV1, HealthDocumentV1, HealthIntervalV1, HealthMetricCode, HealthPointV1, HealthSessionSegmentV1, HealthSessionV1, HealthSummaryV1, HealthValueStatus, } from "./health.js";
+export type { FITDocumentParseOptions, FITHealthBuildEnvironment, FITPrimaryKind, FITDiagnosticsV1, HealthDocumentV1, HealthIntervalV1, HealthMetricCode, HealthPointV1, HealthSessionSegmentV1, HealthSessionV1, HealthSummaryV1, HealthValueStatus, } from "./health.js";
 export * from "./types.js";
 export { encodeCourse, buildCourseMesgs, type CoursePlan, type CourseRecordPoint, type CourseCuePoint, type FitMesg as CourseFitMesg, } from "./encoderCourse.js";
 import { FITDecoder } from "./decoder.js";

package/dist/FIT/mesg.d.ts

@@ -29,6 +29,9 @@ export declare class Mesg {
     constructor(localNum: number, mesgName: string, values: {
         [key: string]: any;
     });
+    /**
+     * Get defns and obtain the size
+     */
     get mesgDefn(): ProcessedMesgDefn;
     isSameDefn(mesgDefn: ProcessedMesgDefn): boolean;
     get defnRecord(): ArrayBuffer;

package/dist/FIT/middleware.d.ts

@@ -1,5 +1,8 @@
 import { BaseFITMiddleware } from "./base.js";
 import { FITDecoderMesgs, FITFileType, FITContext } from "./types.js";
+/**
+ * Performance monitoring middleware
+ */
 export declare class PerformanceMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
@@ -12,22 +15,34 @@ export declare class PerformanceMiddleware extends BaseFITMiddleware {
     private analyzeStructure;
     private getSummary;
 }
+/**
+ * Data validation middleware
+ */
 export declare class ValidationMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onComplete(result: FITFileType, context: FITContext): Promise<FITFileType>;
     private validateFIT;
 }
+/**
+ * Data cleanup middleware
+ */
 export declare class DataCleanupMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onStructure(result: Partial<FITFileType>, context: FITContext): Promise<Partial<FITFileType>>;
     private cleanupData;
 }
+/**
+ * File information extraction middleware
+ */
 export declare class FileInfoMiddleware extends BaseFITMiddleware {
     name: string;
     description: string;
     onExtractMessages(messages: FITDecoderMesgs, context: FITContext): Promise<FITDecoderMesgs>;
     private extractFileInfo;
 }
+/**
+ * Register all default middlewares
+ */
 export declare function registerDefaultMiddlewares(decoder: any): Promise<void>;

package/dist/FIT/plugins.d.ts

@@ -1,15 +1,24 @@
 import { BaseFITStructurePlugin } from "./base.js";
 import { FITDecoderMesgs, FITFileType, FITContext } from "./types.js";
+/**
+ * Session data structuring plugin
+ */
 export declare class SessionStructurePlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;
     structureData(messages: FITDecoderMesgs, context: FITContext): Partial<FITFileType>;
 }
+/**
+ * Course data structuring plugin
+ */
 export declare class CourseStructurePlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;
     structureData(messages: FITDecoderMesgs, context: FITContext): Partial<FITFileType>;
 }
+/**
+ * File header information extraction plugin
+ */
 export declare class FileHeaderPlugin extends BaseFITStructurePlugin {
     name: string;
     priority: number;

package/dist/FIT/processor.d.ts

@@ -1,34 +1,58 @@
 import { IFITMessageConverter, IFITStructurePlugin } from "./base.js";
 import { FITContext } from "./types.js";
+/**
+ * FIT pipeline stages
+ */
 export declare enum FITPipelineStage {
     PARSE = "parse",
     EXTRACT = "extract",
     STRUCTURE = "structure",
     COMPLETE = "complete"
 }
+/**
+ * FIT pipeline processor interface
+ */
 export interface IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
 }
+/**
+ * Parse processor - parses binary FIT data to messages
+ */
 export declare class ParseProcessor implements IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
+    /**
+     * Parse binary data using FIT SDK
+     */
     private parseWithFitSDK;
 }
+/**
+ * Extract processor - extracts and converts messages
+ */
 export declare class ExtractProcessor implements IFITPipelineProcessor {
     private getConverters;
     stage: FITPipelineStage;
     constructor(getConverters: (messageType: string) => IFITMessageConverter[]);
     process(context: FITContext): Promise<FITContext>;
 }
+/**
+ * Structure processor - data structuring
+ */
 export declare class StructureProcessor implements IFITPipelineProcessor {
     private getStructurePlugins;
     stage: FITPipelineStage;
     constructor(getStructurePlugins: () => IFITStructurePlugin[]);
     process(context: FITContext): Promise<FITContext>;
 }
+/**
+ * Complete processor - final processing and cleanup
+ */
 export declare class CompleteProcessor implements IFITPipelineProcessor {
     stage: FITPipelineStage;
     process(context: FITContext): Promise<FITContext>;
+    /**
+     * Count total messages
+     */
     private countTotalMessages;
 }

package/dist/FIT/types/checksum_type.d.ts

@@ -1,4 +1,10 @@
 export declare enum ChecksumType {
+    /**
+     * Allows clear of checksum for flash memory where can only write 1 to 0 without erasing sector.
+     */
     CLEAR = 0,
+    /**
+     * Set to mark checksum as valid if computes to invalid values 0 or 0xFF. Checksum can also be set to ok to save encoding computation time.
+     */
     OK = 1
 }

package/dist/FIT/types/date_time_type.d.ts

@@ -1,3 +1,6 @@
 export declare enum DateTimeType {
+    /**
+     *  // if date_time is < 0x10000000 then it is system time (seconds from device power on)
+     */
     MIN = 268435456
 }

package/dist/FIT/types/file.d.ts

@@ -1,23 +1,86 @@
 export declare enum FITFile {
+    /**
+     * device（只读、单文件、必须在根目录）
+     */
     DEVICE = 1,
+    /**
+     * settings（读写、单文件、Directory=Settings）
+     */
     SETTINGS = 2,
+    /**
+     * sport（读写、多文件、file number = sport type、Directory=Sports）
+     */
     SPORT = 3,
+    /**
+     * activity（读/擦除、多文件、Directory=Activities）
+     */
     ACTIVITY = 4,
+    /**
+     * workout（读写/擦除、多文件、Directory=Workouts）
+     */
     WORKOUT = 5,
+    /**
+     * course（读写/擦除、多文件、Directory=Courses）
+     */
     COURSE = 6,
+    /**
+     * schedules（读写、单文件、Directory=Schedules）
+     */
     SCHEDULES = 7,
+    /**
+     * weight（只读、单文件、环形缓冲、所有消息定义在文件开头、Directory=Weight）
+     */
     WEIGHT = 9,
+    /**
+     * totals（只读、单文件、Directory=Totals）
+     */
     TOTALS = 10,
+    /**
+     * goals（读写、单文件、Directory=Goals）
+     */
     GOALS = 11,
+    /**
+     * bloodPressure（只读、Directory=Blood Pressure）
+     */
     BLOOD_PRESSURE = 14,
+    /**
+     * monitoringA（只读、Directory=Monitoring、file number=sub type）
+     */
     MONITORING_A = 15,
+    /**
+     * activitySummary（读/擦除、多文件、Directory=Activities）
+     */
     ACTIVITY_SUMMARY = 20,
+    /**
+     * monitoringDaily
+     */
     MONITORING_DAILY = 28,
+    /**
+     * monitoringB（只读、Directory=Monitoring、file number=identifier）
+     */
     MONITORING_B = 32,
+    /**
+     * segment（读写/擦除、多文件、Directory=Segments）
+     */
     SEGMENT = 34,
+    /**
+     * segmentList（读写/擦除、单文件、Directory=Segments）
+     */
     SEGMENT_LIST = 35,
+    /**
+     * exdConfiguration（读写/擦除、单文件、Directory=Settings）
+     */
     EXD_CONFIGURATION = 40,
+    /**
+     * mfgRangeMin（0xF7 - 0xFE 保留给厂商自定义 file types）
+     */
     MFG_RANGE_MIN = 247,
+    /**
+     * mfgRangeMax（0xF7 - 0xFE 保留给厂商自定义 file types）
+     */
     MFG_RANGE_MAX = 254,
+    /**
+     * invalid
+     */
     INVALID = 255
 }

package/dist/FIT/types/file_flags_type.d.ts

@@ -1,5 +1,14 @@
 export declare enum FileFlagsType {
+    /**
+     * 读
+     */
     READ = 2,
+    /**
+     * 写
+     */
     WRITE = 4,
+    /**
+     * 擦除文件
+     */
     ERASE = 8
 }

package/dist/FIT/types/local_date_time_type.d.ts

@@ -1,3 +1,6 @@
 export declare enum LocalDateTimeType {
+    /**
+     * // if date_time is < 0x10000000 then it is system time (seconds from device power on)
+     */
     MIN = 268435456
 }

package/dist/FIT/types/mesg_count_type.d.ts

@@ -1,5 +1,11 @@
 export declare enum MesgCountType {
+    /**
+     * 无消息计数
+     */
     NUMPERFILE = 0,
+    /**
+     * 消息计数
+     */
     MAXPERFILE = 1,
     MAXPERFILETYPE = 2
 }