# Trackunit geo-json-utils

`@trackunit/geo-json-utils` is Trackunit's shared GeoJSON utility package.
It contains runtime validation schemas, geometry helpers, and conversion utilities used by map adapters and other frontend libraries.

This library is published for use in the Trackunit [Iris App SDK](https://www.npmjs.com/package/@trackunit/iris-app) and other npm consumers.

For more info and a full guide on Iris App SDK Development, please visit our [Developer Hub](https://developers.trackunit.com/).

## Exports

The package entry (`src/index.ts`) exports these module surfaces:

- **Runtime validation** (`GeoJsonRuntimeValidation`) — These helpers validate unknown input against GeoJSON schemas and log warnings for invalid values so callers can fail safely without throwing.
- **Geometry helpers** (`GeoJsonGeometryUtils`)
- **General GeoJSON utilities** (`GeoJsonUtils`)
- **Zod schemas** — GeoJSON (`GeoJsonSchemas`) and Trackunit-oriented variants (`TuGeoJsonSchemas`)
- **Meridian / longitude helpers** (`MeridianUtils`)
- **Bridge utilities** — Trackunit GeoJSON bridging (`TuGeoJsonBridgeUtils`)
- **Conversions** — Trackunit-oriented conversions (`TuGeoJsonConversions`)

## Development

At this point this library is only developed by Trackunit Employees.  
Run library targets through Nx:

- `yarn nx run geo-json-utils:tsc-validate`
- `yarn nx run geo-json-utils:test`
- `yarn nx run geo-json-utils:build`

## Trackunit

This package was developed by Trackunit ApS.
Trackunit is the leading SaaS-based IoT solution for the construction industry, offering an ecosystem of hardware, fleet management software & telematics.

![The Trackunit logo](https://trackunit.com/wp-content/uploads/2022/03/top-logo.svg)