Data Types

type Device = {
  short_id: string;
  hardware_id: string;
  device_type: string;
  name?: string;
  attributes: Record<string, unknown>;
  is_online?: boolean;
  created_at: Date;
  updated_at: Date;
  last_responded_at?: Date;
};

type GPSTelemetry = {
  hardware_id: string;
  timestamp: Date;
  lat: number;
  long: number;
  speed?: number;
};

type BatteryTelemetry = {
  hardware_id: string;
  timestamp: Date;
  battery_voltage: number;
};

type Trip = {
  hardware_id: string;
  startTime: Date;
  endTime: Date;
  startLocation: { lat: number; long: number };
  endLocation: { lat: number; long: number };
  distance: number;   // meters
  duration: number;    // seconds
  maxSpeed: number;    // km/h
  avgSpeed: number;    // km/h
  pointCount: number;
};

type Stop = {
  startTime: Date;
  endTime: Date;
  location: { lat: number; long: number };
  duration: number;  // seconds
};

type UnlockSource = "rfid" | "keypad" | "key" | "remote";

type LockEvent = {
  event_id: string;
  hardware_id: string;
  event: "unlock" | "lock";
  timestamp: Date;
  source: UnlockSource;
  code?: string;
  metadata?: Record<string, unknown>;
};

type TripConfig = {
  speedThreshold: number;         // km/h — below this speed is stopped
  minimalTripDuration: number;    // seconds
  minimalTripDistance: number;     // meters
  minimalParkingDuration: number; // seconds
  minimalNoDataDuration: number;  // seconds
  minimalAvgSpeed: number;        // km/h — filters GPS drift
  maxAcceleration: number;        // m/s² — filters GPS spikes
};

type UserRole = "user" | "admin";

type ApiUserUsage = {
  total_requests: number;
  last_used_at?: Date;
  first_used_at?: Date;
  requests_today: number;
  last_reset: Date;
};

type ApiUser = {
  user_id: string;
  name: string;
  email?: string;
  role: UserRole;
  is_active: boolean;
  allowed_hardware_ids?: string[] | null;
  created_at: Date;
  updated_at: Date;
  usage: ApiUserUsage;
};