Data Schemas

Core Types

All data types are defined in @lakea/core. This page provides an overview; see the source code for complete definitions.

import type {
  Star,
  Galaxy,
  Exoplanet,
  Coordinates,
  Redshift
} from '@lakea/core';

Coordinates

Equatorial (J2000)

interface EquatorialCoordinates {
  ra: number;   // Right Ascension in degrees (0-360)
  dec: number;  // Declination in degrees (-90 to +90)
}

Full Spatial

interface Coordinates extends EquatorialCoordinates {
  distance?: number;   // Distance in parsecs
  parallax?: number;   // Parallax in milliarcseconds
}

Galactic

interface GalacticCoordinates {
  l: number;  // Galactic longitude in degrees
  b: number;  // Galactic latitude in degrees
}

Celestial Objects

Base Interface

interface CelestialObject {
  id: string;
  name?: string;
  designations?: Record<string, string>;
  coordinates: Coordinates;
  galacticCoordinates?: GalacticCoordinates;
}

Star

interface Star extends CelestialObject {
  type: 'star';
  magnitude: Magnitude;
  spectralType?: SpectralType;
  properMotion?: ProperMotion;
  temperature?: number;      // Kelvin
  radius?: number;           // Solar radii
  mass?: number;             // Solar masses
  luminosity?: number;       // Solar luminosities
}

Galaxy

interface Galaxy extends CelestialObject {
  type: 'galaxy';
  redshift?: Redshift;
  magnitude?: Magnitude;
  morphology?: GalaxyMorphology;
  angularSize?: {
    major: number;           // Arcminutes
    minor: number;
    positionAngle?: number;
  };
  luminosityDistance?: number; // Mpc
}

Exoplanet

interface Exoplanet extends CelestialObject {
  type: 'exoplanet';
  hostStarId: string;
  hostStarName?: string;
  detectionMethod: ExoplanetDetectionMethod;
  discoveryYear?: number;
  orbit?: OrbitalParameters;
  massEarth?: number;
  radiusEarth?: number;
  equilibriumTemperature?: number;
  inHabitableZone?: boolean;
}

Query Results

interface QueryResult<T> {
  data: T[];
  totalCount: number;
  source: DataSource;
  pagination?: {
    offset: number;
    limit: number;
    hasMore: boolean;
  };
}

Source Reference

See packages/core/src/types/index.ts for complete type definitions.