@kaiord/fit 4.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Pablo Albaladejo
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the “Software”), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

package/README.md

@@ -0,0 +1,73 @@
+# @kaiord/fit
+
+[![npm version](https://img.shields.io/npm/v/@kaiord/fit.svg)](https://www.npmjs.com/package/@kaiord/fit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+FIT format adapter for Kaiord workout data conversion. Provides reading and writing of Garmin FIT workout files using the official Garmin FIT SDK.
+
+## Installation
+
+```bash
+pnpm add @kaiord/core @kaiord/fit
+```
+
+## Usage
+
+### With Core Providers (Recommended)
+
+```typescript
+import { createDefaultProviders } from "@kaiord/core";
+import { createFitProviders } from "@kaiord/fit";
+
+const providers = createDefaultProviders({
+  fit: createFitProviders(),
+});
+
+// FIT to KRD
+const krd = await providers.convertFitToKrd!({ fitBuffer });
+
+// KRD to FIT
+const fitBuffer = await providers.convertKrdToFit!({ krd });
+```
+
+### Standalone Adapter Access
+
+```typescript
+import {
+  createGarminFitSdkReader,
+  createGarminFitSdkWriter,
+} from "@kaiord/fit";
+import { createConsoleLogger } from "@kaiord/core";
+
+const logger = createConsoleLogger();
+const reader = createGarminFitSdkReader(logger);
+const writer = createGarminFitSdkWriter(logger);
+```
+
+## API
+
+### `createFitProviders(logger?: Logger): FitProviders`
+
+Creates FIT adapter instances for use with `createDefaultProviders()`.
+
+### `createGarminFitSdkReader(logger: Logger): FitReader`
+
+Creates a FIT file reader using the Garmin FIT SDK.
+
+### `createGarminFitSdkWriter(logger: Logger): FitWriter`
+
+Creates a FIT file writer using the Garmin FIT SDK.
+
+## Supported FIT Features
+
+- Workout files (structured workout steps)
+- Activity files (recorded activity data)
+- Course files (GPS routes)
+- Lap messages
+- Record messages (time-series data)
+- Event messages
+- Session/activity metadata
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+import { Logger, FitReader, FitWriter } from '@kaiord/core';
+
+type FitProviders = {
+    fitReader: FitReader;
+    fitWriter: FitWriter;
+};
+declare const createFitProviders: (logger?: Logger) => FitProviders;
+
+/**
+ * Garmin FIT SDK Adapter - converts FIT workout files to KRD format
+ * References: https://developer.garmin.com/fit/file-types/workout/
+ */
+
+declare const createGarminFitSdkReader: (logger: Logger) => FitReader;
+declare const createGarminFitSdkWriter: (logger: Logger) => FitWriter;
+
+export { type FitProviders, createFitProviders, createGarminFitSdkReader, createGarminFitSdkWriter };