@stuartshay/otel-data-types

TypeScript types auto-generated from the otel-data-api OpenAPI 3.1 specification.

Installation

npm install @stuartshay/otel-data-types

Usage

import type { paths, components } from '@stuartshay/otel-data-types';

// Typed API response
type LocationsResponse = paths['/api/v1/locations']['get']['responses']['200']['content']['application/json'];

// Typed schema
type Location = components['schemas']['Location'];
type GarminActivity = components['schemas']['GarminActivity'];

Generation

Types are generated from the FastAPI source code using openapi-typescript:

./scripts/generate-types.sh

API Coverage

• Locations — OwnTracks GPS data (CRUD, count, devices)
• Garmin — Activities and track points
• Unified GPS — Combined OwnTracks + Garmin view
• Reference Locations — Named locations with radius
• Spatial — PostGIS queries (nearby, distance, within-reference)
• Health — Liveness and readiness probes