@skyvexsoftware/stratos-sdk 0.1.1

package/dist/hooks/useTrackingSession.js

@@ -0,0 +1,152 @@
+/**
+ * useTrackingSession — Convenience hook that combines flight manager state
+ * with derived tracking metadata (isTracking, isPaused, elapsedTime, phase).
+ *
+ * Hydrates from GET /api/flight-manager/state on mount, then subscribes to
+ * flight:manager Socket.io events for real-time updates.
+ *
+ * Acts as a higher-level wrapper — plugins can still use useFlightManager()
+ * or lower-level hooks (useSimData, useFlightPhase, etc.) for more control.
+ */
+import { useState, useEffect, useCallback } from "react";
+import { useQuery, useQueryClient } from "@tanstack/react-query";
+import { useSocket } from "./useSimulatorData";
+import { SOCKET_EVENTS } from "../shared-types/socket-events";
+import { FlightPhase } from "../shared-types/simulator";
+const SERVER_PORT = 2066;
+const API_BASE = `http://127.0.0.1:${SERVER_PORT}/api/flight-manager`;
+export const trackingSessionKeys = {
+    state: ["tracking-session", "state"],
+    pendingRecovery: ["tracking-session", "pending-recovery"],
+};
+async function fetchFlightManagerState() {
+    const response = await fetch(`${API_BASE}/state`, {
+        headers: { Accept: "application/json" },
+    });
+    const json = (await response.json());
+    return json.data;
+}
+async function api(path, method, body) {
+    const response = await fetch(`${API_BASE}${path}`, {
+        method,
+        headers: { "Content-Type": "application/json", Accept: "application/json" },
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    return (await response.json());
+}
+export function useTrackingSession() {
+    const queryClient = useQueryClient();
+    const { socket } = useSocket();
+    const { data: stateData, isLoading, refetch, } = useQuery({
+        queryKey: trackingSessionKeys.state,
+        queryFn: fetchFlightManagerState,
+        staleTime: Infinity,
+        refetchOnWindowFocus: false,
+        refetchOnReconnect: false,
+    });
+    useEffect(() => {
+        if (!socket)
+            return;
+        const handleFlightManager = (payload) => {
+            queryClient.setQueryData(trackingSessionKeys.state, {
+                flight: payload.flight,
+                pendingRecovery: payload.pendingRecovery,
+            });
+        };
+        // Refetch on socket connect — catches flights started before the UI loaded
+        const handleConnect = () => {
+            void refetch();
+        };
+        socket.on(SOCKET_EVENTS.FLIGHT_MANAGER, handleFlightManager);
+        socket.on("connect", handleConnect);
+        return () => {
+            socket.off(SOCKET_EVENTS.FLIGHT_MANAGER, handleFlightManager);
+            socket.off("connect", handleConnect);
+        };
+    }, [socket, queryClient, refetch]);
+    const currentFlight = stateData?.flight ?? null;
+    const pendingRecovery = stateData?.pendingRecovery ?? null;
+    const startFlight = useCallback(async (plan, options) => {
+        const result = await api("/start", "POST", { flightPlan: plan, options });
+        return result.data;
+    }, []);
+    const pauseFlight = useCallback(async () => {
+        const result = await api("/pause", "POST");
+        return result.success;
+    }, []);
+    const resumeFlight = useCallback(async () => {
+        const result = await api("/resume", "POST");
+        return result.success;
+    }, []);
+    const endFlight = useCallback(async (status) => {
+        const result = await api("/end", "POST", { status });
+        return { success: result.success, error: result.error };
+    }, []);
+    const recoverFlight = useCallback(async () => {
+        const result = await api("/recover", "POST");
+        if (result.success) {
+            queryClient.setQueryData(trackingSessionKeys.state, (prev) => (prev ? { ...prev, pendingRecovery: null } : prev));
+        }
+        return result.success;
+    }, [queryClient]);
+    const dismissRecovery = useCallback(async () => {
+        const result = await api("/dismiss-recovery", "POST");
+        if (result.success) {
+            queryClient.setQueryData(trackingSessionKeys.state, (prev) => (prev ? { ...prev, pendingRecovery: null } : prev));
+        }
+        return result.success;
+    }, [queryClient]);
+    const flight = currentFlight;
+    const isActive = flight !== null &&
+        (flight.status === "active" || flight.status === "paused");
+    // Compute elapsed time locally so it ticks every second instead of
+    // only updating on 15-second server broadcasts.
+    const [elapsedTime, setElapsedTime] = useState(flight?.elapsedMs ?? 0);
+    useEffect(() => {
+        if (!isActive) {
+            setElapsedTime(flight?.elapsedMs ?? 0);
+            return;
+        }
+        const tick = () => {
+            const start = flight?.timeCaptureStartAt;
+            const end = flight?.timeCaptureEndAt;
+            if (!start) {
+                setElapsedTime(0);
+            }
+            else if (end) {
+                setElapsedTime(end - start);
+            }
+            else if (flight?.status === "paused" && flight.pausedAt) {
+                setElapsedTime(flight.pausedAt - start);
+            }
+            else {
+                setElapsedTime(Date.now() - start);
+            }
+        };
+        tick();
+        const interval = setInterval(tick, 1000);
+        return () => clearInterval(interval);
+    }, [
+        flight?.timeCaptureStartAt,
+        flight?.timeCaptureEndAt,
+        flight?.status,
+        flight?.pausedAt,
+        isActive,
+    ]);
+    return {
+        isTracking: isActive,
+        isPaused: flight?.status === "paused",
+        currentFlight: flight,
+        pendingRecovery,
+        elapsedTime,
+        phase: flight?.currentPhase ?? FlightPhase.BOARDING,
+        startFlight,
+        pauseFlight,
+        resumeFlight,
+        endFlight,
+        recoverFlight,
+        dismissRecovery,
+        isLoading,
+    };
+}
+//# sourceMappingURL=useTrackingSession.js.map

package/dist/icons.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Re-exports the full lucide-react icon set.
+ *
+ * Both Stratos and SkyVex keep lucide-react on the same version
+ * so the available icons are always in sync.
+ *
+ * - STRATOS_ICONS: Record<string, LucideIcon> — PascalCase keys (e.g. "BookOpen")
+ * - STRATOS_ICON_NAMES: string[] — sorted list of all available icon names
+ */
+import { icons } from "lucide-react";
+export declare const STRATOS_ICONS: typeof icons;
+export declare const STRATOS_ICON_NAMES: string[];
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.js

@@ -0,0 +1,13 @@
+/**
+ * Re-exports the full lucide-react icon set.
+ *
+ * Both Stratos and SkyVex keep lucide-react on the same version
+ * so the available icons are always in sync.
+ *
+ * - STRATOS_ICONS: Record<string, LucideIcon> — PascalCase keys (e.g. "BookOpen")
+ * - STRATOS_ICON_NAMES: string[] — sorted list of all available icon names
+ */
+import { icons } from "lucide-react";
+export const STRATOS_ICONS = icons;
+export const STRATOS_ICON_NAMES = Object.keys(icons).sort();
+//# sourceMappingURL=icons.js.map

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export type { PluginAuthor, PluginManifest } from "./types/manifest";
+export type { PluginAuthAccessor, PluginConfigStore, PluginContext, PluginDatabaseAccessor, PluginIPCRegistrar, PluginLogger, PluginNavigationHelper, PluginServerRegistrar, PluginToastAPI, PluginUIContext, PluginSettingType, PluginSettingOption, PluginSettingDefinition, PluginAvailableSettings, BooleanSettingDef, TextSettingDef, LongtextSettingDef, NumberSettingDef, RangeSettingDef, ListSettingDef, RadioSettingDef, DateSettingDef, JsonSettingDef, } from "./types/context";
+export type { PluginBackgroundModule, PluginRouteComponent, PluginUIModule, } from "./types/module";
+export { FlightPhase, SimulatorType, EventCategory, } from "./shared-types/simulator";
+export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, LandingSample, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./shared-types/simulator";
+export type { ThemeMode } from "./shared-types/theme";
+export type { FlightPlan, FlightStatus, CurrentFlight, FlightComment, PreflightCheck, PreflightCheckResult, StartFlightOptions, FlightManagerPayload, StartFlightResult, RecoverableFlight, } from "./shared-types/flight-manager";
+export { createPlugin } from "./helpers/createPlugin";
+export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./helpers/units";
+export type { WeightUnit, AltitudeUnit, DistanceUnit, UnitPreferences, } from "./helpers/units";
+export { PluginUICtx, usePluginContext } from "./hooks/context";
+export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";
+export { useFlightManager } from "./hooks/useFlightManager";
+export { useFlightPhase, flightPhaseKeys } from "./hooks/useFlightPhase";
+export { useLandingAnalysis, landingAnalysisKeys, } from "./hooks/useLandingAnalysis";
+export { useSimData, simDataKeys } from "./hooks/useSimData";
+export { useTrackingSession, trackingSessionKeys, } from "./hooks/useTrackingSession";
+export { usePluginLogger } from "./hooks/usePluginLogger";
+export { useShellAuth } from "./hooks/useShellAuth";
+export { useShellConfig } from "./hooks/useShellConfig";
+export { useShellNavigation } from "./hooks/useShellNavigation";
+export { useShellToast } from "./hooks/useShellToast";
+export { useSocket, useSimulatorData, useProtocolUrl, useNotifications, useSystemMetrics, } from "./hooks/useSimulatorData";
+export { SOCKET_EVENTS } from "./shared-types/socket-events";
+export type { ConnectionState, LogEntryPayload, NotificationPayload, ProtocolUrlPayload, SimulatorDataPayload, SimulatorStatusPayload, SocketEventName, SystemMetricsPayload, } from "./shared-types/socket-events";
+export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, Badge, badgeVariants, Button, buttonVariants, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Input, Label, RadioGroup, RadioGroupItem, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "./ui";
+export type { BadgeProps, ButtonProps } from "./ui";
+export { STRATOS_ICONS, STRATOS_ICON_NAMES } from "./icons";
+export { cn } from "./utils/cn";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,28 @@
+// ── Shared Types ───────────────────────────────────────────────────────
+export { FlightPhase, SimulatorType, EventCategory, } from "./shared-types/simulator";
+// ── Helper Functions ───────────────────────────────────────────────────
+export { createPlugin } from "./helpers/createPlugin";
+export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./helpers/units";
+// ── React Hooks ────────────────────────────────────────────────────────
+export { PluginUICtx, usePluginContext } from "./hooks/context";
+export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";
+export { useFlightManager } from "./hooks/useFlightManager";
+export { useFlightPhase, flightPhaseKeys } from "./hooks/useFlightPhase";
+export { useLandingAnalysis, landingAnalysisKeys, } from "./hooks/useLandingAnalysis";
+export { useSimData, simDataKeys } from "./hooks/useSimData";
+export { useTrackingSession, trackingSessionKeys, } from "./hooks/useTrackingSession";
+export { usePluginLogger } from "./hooks/usePluginLogger";
+export { useShellAuth } from "./hooks/useShellAuth";
+export { useShellConfig } from "./hooks/useShellConfig";
+export { useShellNavigation } from "./hooks/useShellNavigation";
+export { useShellToast } from "./hooks/useShellToast";
+export { useSocket, useSimulatorData, useProtocolUrl, useNotifications, useSystemMetrics, } from "./hooks/useSimulatorData";
+// ── Socket.io Event Catalog ──────────────────────────────────────────────
+export { SOCKET_EVENTS } from "./shared-types/socket-events";
+// ── UI Primitives ──────────────────────────────────────────────────────
+export { AlertDialog, AlertDialogPortal, AlertDialogOverlay, AlertDialogTrigger, AlertDialogContent, AlertDialogHeader, AlertDialogFooter, AlertDialogTitle, AlertDialogDescription, AlertDialogAction, AlertDialogCancel, Badge, badgeVariants, Button, buttonVariants, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, Input, Label, RadioGroup, RadioGroupItem, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Slider, Switch, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, } from "./ui";
+// ── Icons ─────────────────────────────────────────────────────────────
+export { STRATOS_ICONS, STRATOS_ICON_NAMES } from "./icons";
+// ── Utilities ──────────────────────────────────────────────────────────
+export { cn } from "./utils/cn";
+//# sourceMappingURL=index.js.map

package/dist/shared-types/flight-manager.d.ts

@@ -0,0 +1,112 @@
+import type { FlightPhase } from "./simulator";
+/** VA-agnostic flight plan, produced by any plugin */
+export type FlightPlan = {
+    source: "va" | "simbrief" | "manual";
+    sourceId?: string;
+    callsign: string;
+    flightNumber?: string;
+    airlineCode?: string;
+    departureIcao: string;
+    arrivalIcao: string;
+    route: string[];
+    aircraftIcao: string;
+    aircraftName?: string;
+    cruiseAltitude?: number;
+    plannedDistance?: number;
+    estimatedFlightTime?: number;
+    departureCoords?: {
+        lat: number;
+        lon: number;
+    };
+    arrivalCoords?: {
+        lat: number;
+        lon: number;
+    };
+};
+/** Flight lifecycle status */
+export type FlightStatus = "preflight" | "starting" | "active" | "paused" | "completing" | "completed" | "failed" | "cancelled";
+/** Active flight state broadcast via Socket.io */
+export type CurrentFlight = {
+    flightPlan: FlightPlan;
+    status: FlightStatus;
+    vaTrackingId: string | null;
+    stratosFlightId: string | null;
+    startedAt: number | null;
+    pausedAt: number | null;
+    totalPausedMs: number;
+    elapsedMs: number;
+    timeCaptureMode: "block" | "air";
+    timeCaptureStartAt: number | null;
+    timeCaptureEndAt: number | null;
+    currentPhase: FlightPhase;
+    latitude: number;
+    longitude: number;
+    altitude: number;
+    groundSpeed: number;
+    heading: number;
+    startingFuel: number;
+    currentFuel: number;
+    lastUpdateSentAt: number | null;
+    updatesSent: number;
+    updateIntervalMs: number;
+    comments: FlightComment[];
+    lastError: string | null;
+};
+/** Comment attached to an active flight */
+export type FlightComment = {
+    id: string;
+    message: string;
+    timestamp: number;
+    phase: FlightPhase;
+};
+/** Result of pre-flight validation checks */
+export type PreflightCheck = {
+    name: string;
+    passed: boolean;
+    message: string;
+    severity: "error" | "warning";
+};
+export type PreflightCheckResult = {
+    passed: boolean;
+    checks: PreflightCheck[];
+};
+/** Options for startFlight */
+export type StartFlightOptions = {
+    skipPreflightWarnings?: boolean;
+    forceStart?: boolean;
+};
+/** Lean subset of stored flight data for recovery prompt in the renderer */
+export type RecoverableFlight = {
+    id: string;
+    callsign: string | null;
+    departureIcao: string | null;
+    arrivalIcao: string | null;
+    aircraftIcao: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    altitude: number | null;
+    heading: number | null;
+    groundSpeed: number | null;
+    startedAt: number | null;
+    elapsedMs: number;
+    status: string;
+    phase: string | null;
+};
+/** Socket.io payload for flight:manager events */
+export type FlightManagerPayload = {
+    flight: CurrentFlight | null;
+    pendingRecovery: RecoverableFlight | null;
+    timestamp: number;
+};
+/** Result returned from startFlight */
+export type StartFlightResult = {
+    success: boolean;
+    flight?: CurrentFlight;
+    preflightResult?: PreflightCheckResult;
+    /** VA-issued confirmation message — pilot must acknowledge before tracking starts */
+    vaConfirmation?: string;
+    /** Sim variables sent to VA for display in confirmation dialog */
+    simVariables?: Record<string, string>;
+    error?: string;
+};
+//# sourceMappingURL=flight-manager.d.ts.map

package/dist/shared-types/flight-manager.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=flight-manager.js.map

package/dist/shared-types/index.d.ts

@@ -0,0 +1,7 @@
+export { FlightPhase, SimulatorType, EventCategory } from "./simulator";
+export type { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, HistoryReportEntry, LandingAnalysis, LandingAnalysisSnapshot, LandingAnalyzerDebugState, PendingPhaseTransition, SimDataSnapshot, SimulatorStatus, } from "./simulator";
+export type { ThemeMode } from "./theme";
+export type { FlightPlan, FlightStatus, CurrentFlight, FlightComment, PreflightCheck, PreflightCheckResult, StartFlightOptions, FlightManagerPayload, StartFlightResult, RecoverableFlight, } from "./flight-manager";
+export { SOCKET_EVENTS } from "./socket-events";
+export type { ConnectionState, LogEntryPayload, NotificationPayload, ProtocolUrlPayload, SimulatorDataPayload, SimulatorStatusPayload, SocketEventName, SystemMetricsPayload, } from "./socket-events";
+//# sourceMappingURL=index.d.ts.map

package/dist/shared-types/index.js

@@ -0,0 +1,4 @@
+export { FlightPhase, SimulatorType, EventCategory } from "./simulator";
+// ── Socket.io Event Catalog ──────────────────────────────────────────────
+export { SOCKET_EVENTS } from "./socket-events";
+//# sourceMappingURL=index.js.map