@stuartshay/otel-graphql-types 1.0.0

package/README.md

@@ -0,0 +1,49 @@
+# @stuartshay/otel-graphql-types
+
+TypeScript types auto-generated from the otel-data-gateway GraphQL schema.
+
+## Installation
+
+```bash
+npm install @stuartshay/otel-graphql-types
+```
+
+## Usage
+
+### Import Types
+
+```typescript
+import type { Location, GarminActivity, LocationConnection } from '@stuartshay/otel-graphql-types';
+```
+
+### Use Schema for Client Codegen
+
+The package includes `schema.graphql` for use with `@graphql-codegen/cli` in
+client applications:
+
+```typescript
+// codegen.ts
+import type { CodegenConfig } from '@graphql-codegen/cli';
+
+const config: CodegenConfig = {
+  schema: 'node_modules/@stuartshay/otel-graphql-types/schema.graphql',
+  documents: 'src/graphql/**/*.ts',
+  generates: {
+    'src/__generated__/graphql.ts': {
+      plugins: ['typescript', 'typescript-operations', 'typescript-react-apollo'],
+    },
+  },
+};
+
+export default config;
+```
+
+## Generation
+
+Types are auto-generated from the GraphQL SDL schema using
+`@graphql-codegen/typescript`. Do not edit `index.d.ts` manually.
+
+## Related Packages
+
+- [`@stuartshay/otel-data-types`](https://www.npmjs.com/package/@stuartshay/otel-data-types) —
+  REST API types (OpenAPI-generated)

package/index.d.ts

@@ -0,0 +1,359 @@
+export type Maybe<T> = T | null;
+export type InputMaybe<T> = Maybe<T>;
+export type Exact<T extends { [key: string]: unknown }> = { [K in keyof T]: T[K] };
+export type MakeOptional<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]?: Maybe<T[SubKey]> };
+export type MakeMaybe<T, K extends keyof T> = Omit<T, K> & { [SubKey in K]: Maybe<T[SubKey]> };
+export type MakeEmpty<T extends { [key: string]: unknown }, K extends keyof T> = { [_ in K]?: never };
+export type Incremental<T> = T | { [P in keyof T]?: P extends ' $fragmentName' | '__typename' ? T[P] : never };
+/** All built-in and custom scalars, mapped to their actual values */
+export interface Scalars {
+  ID: { input: string; output: string; }
+  String: { input: string; output: string; }
+  Boolean: { input: boolean; output: boolean; }
+  Int: { input: number; output: number; }
+  Float: { input: number; output: number; }
+  DateTime: { input: string; output: string; }
+  JSON: { input: Record<string, unknown>; output: Record<string, unknown>; }
+}
+
+export interface DailyActivitySummary {
+  __typename?: 'DailyActivitySummary';
+  activity_date?: Maybe<Scalars['String']['output']>;
+  avg_accuracy?: Maybe<Scalars['Float']['output']>;
+  avg_heart_rate?: Maybe<Scalars['Int']['output']>;
+  garmin_activities?: Maybe<Scalars['Int']['output']>;
+  garmin_sport?: Maybe<Scalars['String']['output']>;
+  max_battery?: Maybe<Scalars['Int']['output']>;
+  min_battery?: Maybe<Scalars['Int']['output']>;
+  owntracks_device?: Maybe<Scalars['String']['output']>;
+  owntracks_points?: Maybe<Scalars['Int']['output']>;
+  total_calories?: Maybe<Scalars['Int']['output']>;
+  total_distance_km?: Maybe<Scalars['Float']['output']>;
+  total_duration_seconds?: Maybe<Scalars['Float']['output']>;
+}
+
+export interface DeviceInfo {
+  __typename?: 'DeviceInfo';
+  device_id: Scalars['String']['output'];
+}
+
+export interface DistanceResult {
+  __typename?: 'DistanceResult';
+  distance_meters: Scalars['Float']['output'];
+  from_lat: Scalars['Float']['output'];
+  from_lon: Scalars['Float']['output'];
+  to_lat: Scalars['Float']['output'];
+  to_lon: Scalars['Float']['output'];
+}
+
+export interface GarminActivity {
+  __typename?: 'GarminActivity';
+  activity_id: Scalars['String']['output'];
+  avg_cadence?: Maybe<Scalars['Int']['output']>;
+  avg_heart_rate?: Maybe<Scalars['Int']['output']>;
+  avg_pace?: Maybe<Scalars['Float']['output']>;
+  avg_speed_kmh?: Maybe<Scalars['Float']['output']>;
+  avg_temperature_c?: Maybe<Scalars['Int']['output']>;
+  calories?: Maybe<Scalars['Int']['output']>;
+  created_at?: Maybe<Scalars['String']['output']>;
+  device_manufacturer?: Maybe<Scalars['String']['output']>;
+  distance_km?: Maybe<Scalars['Float']['output']>;
+  duration_seconds?: Maybe<Scalars['Float']['output']>;
+  end_time?: Maybe<Scalars['String']['output']>;
+  max_cadence?: Maybe<Scalars['Int']['output']>;
+  max_heart_rate?: Maybe<Scalars['Int']['output']>;
+  max_speed_kmh?: Maybe<Scalars['Float']['output']>;
+  max_temperature_c?: Maybe<Scalars['Int']['output']>;
+  min_temperature_c?: Maybe<Scalars['Int']['output']>;
+  sport: Scalars['String']['output'];
+  start_time?: Maybe<Scalars['String']['output']>;
+  sub_sport?: Maybe<Scalars['String']['output']>;
+  total_ascent_m?: Maybe<Scalars['Float']['output']>;
+  total_descent_m?: Maybe<Scalars['Float']['output']>;
+  total_distance?: Maybe<Scalars['Float']['output']>;
+  total_elapsed_time?: Maybe<Scalars['Float']['output']>;
+  total_timer_time?: Maybe<Scalars['Float']['output']>;
+  track_point_count?: Maybe<Scalars['Int']['output']>;
+  uploaded_at?: Maybe<Scalars['String']['output']>;
+}
+
+export interface GarminActivityConnection {
+  __typename?: 'GarminActivityConnection';
+  items: Array<GarminActivity>;
+  limit: Scalars['Int']['output'];
+  offset: Scalars['Int']['output'];
+  total: Scalars['Int']['output'];
+}
+
+export interface GarminTrackPoint {
+  __typename?: 'GarminTrackPoint';
+  activity_id: Scalars['String']['output'];
+  altitude?: Maybe<Scalars['Float']['output']>;
+  cadence?: Maybe<Scalars['Int']['output']>;
+  created_at?: Maybe<Scalars['String']['output']>;
+  distance_from_start_km?: Maybe<Scalars['Float']['output']>;
+  heart_rate?: Maybe<Scalars['Int']['output']>;
+  id: Scalars['Int']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  speed_kmh?: Maybe<Scalars['Float']['output']>;
+  temperature_c?: Maybe<Scalars['Float']['output']>;
+  timestamp: Scalars['DateTime']['output'];
+}
+
+export interface GarminTrackPointConnection {
+  __typename?: 'GarminTrackPointConnection';
+  items: Array<GarminTrackPoint>;
+  limit: Scalars['Int']['output'];
+  offset: Scalars['Int']['output'];
+  total: Scalars['Int']['output'];
+}
+
+export interface HealthStatus {
+  __typename?: 'HealthStatus';
+  status: Scalars['String']['output'];
+  version: Scalars['String']['output'];
+}
+
+export interface Location {
+  __typename?: 'Location';
+  accuracy?: Maybe<Scalars['Float']['output']>;
+  altitude?: Maybe<Scalars['Float']['output']>;
+  battery?: Maybe<Scalars['Int']['output']>;
+  battery_status?: Maybe<Scalars['Int']['output']>;
+  connection_type?: Maybe<Scalars['String']['output']>;
+  created_at?: Maybe<Scalars['String']['output']>;
+  device_id: Scalars['String']['output'];
+  id: Scalars['Int']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  tid?: Maybe<Scalars['String']['output']>;
+  timestamp: Scalars['DateTime']['output'];
+  trigger?: Maybe<Scalars['String']['output']>;
+  velocity?: Maybe<Scalars['Float']['output']>;
+}
+
+export interface LocationConnection {
+  __typename?: 'LocationConnection';
+  items: Array<Location>;
+  limit: Scalars['Int']['output'];
+  offset: Scalars['Int']['output'];
+  total: Scalars['Int']['output'];
+}
+
+export interface LocationCount {
+  __typename?: 'LocationCount';
+  count: Scalars['Int']['output'];
+  date?: Maybe<Scalars['String']['output']>;
+  device_id?: Maybe<Scalars['String']['output']>;
+}
+
+export interface LocationDetail {
+  __typename?: 'LocationDetail';
+  accuracy?: Maybe<Scalars['Float']['output']>;
+  altitude?: Maybe<Scalars['Float']['output']>;
+  battery?: Maybe<Scalars['Int']['output']>;
+  battery_status?: Maybe<Scalars['Int']['output']>;
+  connection_type?: Maybe<Scalars['String']['output']>;
+  created_at?: Maybe<Scalars['String']['output']>;
+  device_id: Scalars['String']['output'];
+  id: Scalars['Int']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  raw_payload?: Maybe<Scalars['JSON']['output']>;
+  tid?: Maybe<Scalars['String']['output']>;
+  timestamp: Scalars['DateTime']['output'];
+  trigger?: Maybe<Scalars['String']['output']>;
+  velocity?: Maybe<Scalars['Float']['output']>;
+}
+
+export interface NearbyPoint {
+  __typename?: 'NearbyPoint';
+  distance_meters: Scalars['Float']['output'];
+  id: Scalars['Int']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  source: Scalars['String']['output'];
+  timestamp: Scalars['DateTime']['output'];
+}
+
+export interface PaginationInfo {
+  __typename?: 'PaginationInfo';
+  limit: Scalars['Int']['output'];
+  offset: Scalars['Int']['output'];
+  total: Scalars['Int']['output'];
+}
+
+export interface Query {
+  __typename?: 'Query';
+  calculateDistance: DistanceResult;
+  dailySummary: Array<DailyActivitySummary>;
+  devices: Array<DeviceInfo>;
+  garminActivities: GarminActivityConnection;
+  garminActivity?: Maybe<GarminActivity>;
+  garminSports: Array<SportInfo>;
+  garminTrackPoints: GarminTrackPointConnection;
+  health: HealthStatus;
+  location?: Maybe<LocationDetail>;
+  locationCount: LocationCount;
+  locations: LocationConnection;
+  nearbyPoints: Array<NearbyPoint>;
+  ready: ReadyStatus;
+  referenceLocation?: Maybe<ReferenceLocation>;
+  referenceLocations: Array<ReferenceLocation>;
+  unifiedGps: UnifiedGpsConnection;
+  withinReference: WithinReferenceResult;
+}
+
+
+export interface QueryCalculateDistanceArgs {
+  from_lat: Scalars['Float']['input'];
+  from_lon: Scalars['Float']['input'];
+  to_lat: Scalars['Float']['input'];
+  to_lon: Scalars['Float']['input'];
+}
+
+
+export interface QueryDailySummaryArgs {
+  date_from?: InputMaybe<Scalars['String']['input']>;
+  date_to?: InputMaybe<Scalars['String']['input']>;
+  limit?: InputMaybe<Scalars['Int']['input']>;
+}
+
+
+export interface QueryGarminActivitiesArgs {
+  date_from?: InputMaybe<Scalars['String']['input']>;
+  date_to?: InputMaybe<Scalars['String']['input']>;
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  offset?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<SortOrder>;
+  sort?: InputMaybe<Scalars['String']['input']>;
+  sport?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryGarminActivityArgs {
+  activity_id: Scalars['String']['input'];
+}
+
+
+export interface QueryGarminTrackPointsArgs {
+  activity_id: Scalars['String']['input'];
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  offset?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<SortOrder>;
+  simplify?: InputMaybe<Scalars['Float']['input']>;
+  sort?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryLocationArgs {
+  id: Scalars['Int']['input'];
+}
+
+
+export interface QueryLocationCountArgs {
+  date?: InputMaybe<Scalars['String']['input']>;
+  device_id?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryLocationsArgs {
+  date_from?: InputMaybe<Scalars['String']['input']>;
+  date_to?: InputMaybe<Scalars['String']['input']>;
+  device_id?: InputMaybe<Scalars['String']['input']>;
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  offset?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<SortOrder>;
+  sort?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryNearbyPointsArgs {
+  lat: Scalars['Float']['input'];
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  lon: Scalars['Float']['input'];
+  radius_meters?: InputMaybe<Scalars['Float']['input']>;
+  source?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryReferenceLocationArgs {
+  id: Scalars['Int']['input'];
+}
+
+
+export interface QueryUnifiedGpsArgs {
+  date_from?: InputMaybe<Scalars['String']['input']>;
+  date_to?: InputMaybe<Scalars['String']['input']>;
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  offset?: InputMaybe<Scalars['Int']['input']>;
+  order?: InputMaybe<SortOrder>;
+  source?: InputMaybe<Scalars['String']['input']>;
+}
+
+
+export interface QueryWithinReferenceArgs {
+  limit?: InputMaybe<Scalars['Int']['input']>;
+  name: Scalars['String']['input'];
+  source?: InputMaybe<Scalars['String']['input']>;
+}
+
+export interface ReadyStatus {
+  __typename?: 'ReadyStatus';
+  database?: Maybe<Scalars['String']['output']>;
+  status: Scalars['String']['output'];
+  version?: Maybe<Scalars['String']['output']>;
+}
+
+export interface ReferenceLocation {
+  __typename?: 'ReferenceLocation';
+  created_at?: Maybe<Scalars['String']['output']>;
+  description?: Maybe<Scalars['String']['output']>;
+  id: Scalars['Int']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  name: Scalars['String']['output'];
+  radius_meters: Scalars['Float']['output'];
+  updated_at?: Maybe<Scalars['String']['output']>;
+}
+
+export type SortOrder =
+  | 'asc'
+  | 'desc';
+
+export interface SportInfo {
+  __typename?: 'SportInfo';
+  activity_count: Scalars['Int']['output'];
+  sport: Scalars['String']['output'];
+}
+
+export interface UnifiedGpsConnection {
+  __typename?: 'UnifiedGpsConnection';
+  items: Array<UnifiedGpsPoint>;
+  limit: Scalars['Int']['output'];
+  offset: Scalars['Int']['output'];
+  total: Scalars['Int']['output'];
+}
+
+export interface UnifiedGpsPoint {
+  __typename?: 'UnifiedGpsPoint';
+  accuracy?: Maybe<Scalars['Float']['output']>;
+  battery?: Maybe<Scalars['Int']['output']>;
+  created_at?: Maybe<Scalars['String']['output']>;
+  heart_rate?: Maybe<Scalars['Int']['output']>;
+  identifier: Scalars['String']['output'];
+  latitude: Scalars['Float']['output'];
+  longitude: Scalars['Float']['output'];
+  source: Scalars['String']['output'];
+  speed_kmh?: Maybe<Scalars['Float']['output']>;
+  timestamp: Scalars['DateTime']['output'];
+}
+
+export interface WithinReferenceResult {
+  __typename?: 'WithinReferenceResult';
+  points: Array<NearbyPoint>;
+  radius_meters: Scalars['Float']['output'];
+  reference_name: Scalars['String']['output'];
+  total_points: Scalars['Int']['output'];
+}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@stuartshay/otel-graphql-types",
+  "version": "1.0.0",
+  "description": "TypeScript types for otel-data-gateway — Auto-generated from GraphQL schema",
+  "types": "index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts"
+    }
+  },
+  "files": [
+    "index.d.ts",
+    "schema.graphql",
+    "README.md"
+  ],
+  "scripts": {
+    "prepublishOnly": "echo 'Types should be generated before publishing'"
+  },
+  "keywords": [
+    "otel-data-gateway",
+    "graphql",
+    "typescript",
+    "types",
+    "apollo-server"
+  ],
+  "author": "Stuart Shay",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stuartshay/otel-data-gateway.git",
+    "directory": "packages/graphql-types"
+  },
+  "homepage": "https://github.com/stuartshay/otel-data-gateway/tree/master/packages/graphql-types",
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/schema.graphql

@@ -0,0 +1,330 @@
+# -------------------------------------------------------
+# Scalars
+# -------------------------------------------------------
+scalar DateTime
+
+# -------------------------------------------------------
+# Common Types
+# -------------------------------------------------------
+type PaginationInfo {
+  total: Int!
+  limit: Int!
+  offset: Int!
+}
+
+# -------------------------------------------------------
+# Health
+# -------------------------------------------------------
+type HealthStatus {
+  status: String!
+  version: String!
+}
+
+type ReadyStatus {
+  status: String!
+  database: String
+  version: String
+}
+
+# -------------------------------------------------------
+# Locations (OwnTracks)
+# -------------------------------------------------------
+type Location {
+  id: Int!
+  device_id: String!
+  tid: String
+  latitude: Float!
+  longitude: Float!
+  accuracy: Float
+  altitude: Float
+  velocity: Float
+  battery: Int
+  battery_status: Int
+  connection_type: String
+  trigger: String
+  timestamp: DateTime!
+  created_at: String
+}
+
+type LocationDetail {
+  id: Int!
+  device_id: String!
+  tid: String
+  latitude: Float!
+  longitude: Float!
+  accuracy: Float
+  altitude: Float
+  velocity: Float
+  battery: Int
+  battery_status: Int
+  connection_type: String
+  trigger: String
+  timestamp: DateTime!
+  created_at: String
+  raw_payload: JSON
+}
+
+scalar JSON
+
+type LocationConnection {
+  items: [Location!]!
+  total: Int!
+  limit: Int!
+  offset: Int!
+}
+
+type DeviceInfo {
+  device_id: String!
+}
+
+type LocationCount {
+  count: Int!
+  date: String
+  device_id: String
+}
+
+# -------------------------------------------------------
+# Garmin
+# -------------------------------------------------------
+type GarminActivity {
+  activity_id: String!
+  sport: String!
+  sub_sport: String
+  start_time: String
+  end_time: String
+  distance_km: Float
+  duration_seconds: Float
+  avg_heart_rate: Int
+  max_heart_rate: Int
+  avg_cadence: Int
+  max_cadence: Int
+  calories: Int
+  avg_speed_kmh: Float
+  max_speed_kmh: Float
+  total_ascent_m: Float
+  total_descent_m: Float
+  total_distance: Float
+  avg_pace: Float
+  device_manufacturer: String
+  avg_temperature_c: Int
+  min_temperature_c: Int
+  max_temperature_c: Int
+  total_elapsed_time: Float
+  total_timer_time: Float
+  created_at: String
+  uploaded_at: String
+  track_point_count: Int
+}
+
+type GarminActivityConnection {
+  items: [GarminActivity!]!
+  total: Int!
+  limit: Int!
+  offset: Int!
+}
+
+type GarminTrackPoint {
+  id: Int!
+  activity_id: String!
+  latitude: Float!
+  longitude: Float!
+  timestamp: DateTime!
+  altitude: Float
+  distance_from_start_km: Float
+  speed_kmh: Float
+  heart_rate: Int
+  cadence: Int
+  temperature_c: Float
+  created_at: String
+}
+
+type GarminTrackPointConnection {
+  items: [GarminTrackPoint!]!
+  total: Int!
+  limit: Int!
+  offset: Int!
+}
+
+type SportInfo {
+  sport: String!
+  activity_count: Int!
+}
+
+# -------------------------------------------------------
+# Unified GPS
+# -------------------------------------------------------
+type UnifiedGpsPoint {
+  source: String!
+  identifier: String!
+  latitude: Float!
+  longitude: Float!
+  timestamp: DateTime!
+  accuracy: Float
+  battery: Int
+  speed_kmh: Float
+  heart_rate: Int
+  created_at: String
+}
+
+type UnifiedGpsConnection {
+  items: [UnifiedGpsPoint!]!
+  total: Int!
+  limit: Int!
+  offset: Int!
+}
+
+type DailyActivitySummary {
+  activity_date: String
+  owntracks_device: String
+  owntracks_points: Int
+  min_battery: Int
+  max_battery: Int
+  avg_accuracy: Float
+  garmin_sport: String
+  garmin_activities: Int
+  total_distance_km: Float
+  total_duration_seconds: Float
+  avg_heart_rate: Int
+  total_calories: Int
+}
+
+# -------------------------------------------------------
+# Reference Locations
+# -------------------------------------------------------
+type ReferenceLocation {
+  id: Int!
+  name: String!
+  latitude: Float!
+  longitude: Float!
+  radius_meters: Float!
+  description: String
+  created_at: String
+  updated_at: String
+}
+
+# -------------------------------------------------------
+# Spatial
+# -------------------------------------------------------
+type NearbyPoint {
+  source: String!
+  id: Int!
+  latitude: Float!
+  longitude: Float!
+  distance_meters: Float!
+  timestamp: DateTime!
+}
+
+type DistanceResult {
+  distance_meters: Float!
+  from_lat: Float!
+  from_lon: Float!
+  to_lat: Float!
+  to_lon: Float!
+}
+
+type WithinReferenceResult {
+  reference_name: String!
+  radius_meters: Float!
+  total_points: Int!
+  points: [NearbyPoint!]!
+}
+
+# -------------------------------------------------------
+# Enums
+# -------------------------------------------------------
+enum SortOrder {
+  asc
+  desc
+}
+
+# -------------------------------------------------------
+# Queries
+# -------------------------------------------------------
+type Query {
+  # Health
+  health: HealthStatus!
+  ready: ReadyStatus!
+
+  # Locations
+  locations(
+    device_id: String
+    date_from: String
+    date_to: String
+    limit: Int
+    offset: Int
+    sort: String
+    order: SortOrder
+  ): LocationConnection!
+
+  location(id: Int!): LocationDetail
+
+  devices: [DeviceInfo!]!
+
+  locationCount(date: String, device_id: String): LocationCount!
+
+  # Garmin
+  garminActivities(
+    sport: String
+    date_from: String
+    date_to: String
+    limit: Int
+    offset: Int
+    sort: String
+    order: SortOrder
+  ): GarminActivityConnection!
+
+  garminActivity(activity_id: String!): GarminActivity
+
+  garminTrackPoints(
+    activity_id: String!
+    limit: Int
+    offset: Int
+    sort: String
+    order: SortOrder
+    simplify: Float
+  ): GarminTrackPointConnection!
+
+  garminSports: [SportInfo!]!
+
+  # Unified GPS
+  unifiedGps(
+    source: String
+    date_from: String
+    date_to: String
+    limit: Int
+    offset: Int
+    order: SortOrder
+  ): UnifiedGpsConnection!
+
+  dailySummary(
+    date_from: String
+    date_to: String
+    limit: Int
+  ): [DailyActivitySummary!]!
+
+  # Reference Locations
+  referenceLocations: [ReferenceLocation!]!
+  referenceLocation(id: Int!): ReferenceLocation
+
+  # Spatial
+  nearbyPoints(
+    lat: Float!
+    lon: Float!
+    radius_meters: Float
+    source: String
+    limit: Int
+  ): [NearbyPoint!]!
+
+  calculateDistance(
+    from_lat: Float!
+    from_lon: Float!
+    to_lat: Float!
+    to_lon: Float!
+  ): DistanceResult!
+
+  withinReference(
+    name: String!
+    source: String
+    limit: Int
+  ): WithinReferenceResult!
+}