@skyvexsoftware/stratos-sdk 0.8.0 → 0.9.0

package/dist/helpers/aircraft.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Aircraft size classification used by the landing analyser (and any future
+ * scorer) to apply class-aware thresholds — a 1000 fpm descent at 50 ft is
+ * marginal in a narrowbody but a clear bust in a widebody, etc.
+ */
+export type AircraftClass = "widebody" | "narrowbody" | "regional";
+/**
+ * Classify an ICAO aircraft type into widebody / narrowbody / regional.
+ * Returns "narrowbody" when the type is unknown or unparseable — it's the
+ * most common class and yields sensible (non-overly-strict) thresholds.
+ */
+export declare function classifyAircraft(aircraftType: string | null | undefined): AircraftClass;
+//# sourceMappingURL=aircraft.d.ts.map

package/dist/helpers/aircraft.js

@@ -0,0 +1,130 @@
+/**
+ * Aircraft size classification used by the landing analyser (and any future
+ * scorer) to apply class-aware thresholds — a 1000 fpm descent at 50 ft is
+ * marginal in a narrowbody but a clear bust in a widebody, etc.
+ */
+/**
+ * Known ICAO type designators by class. Lists are deliberately
+ * conservative — when a type doesn't match, we fall back to narrowbody as the
+ * least-restrictive sensible default.
+ */
+const WIDEBODY_TYPES = [
+    "A306",
+    "A30B",
+    "A310",
+    "A330",
+    "A332",
+    "A333",
+    "A338",
+    "A339",
+    "A340",
+    "A342",
+    "A343",
+    "A345",
+    "A346",
+    "A350",
+    "A359",
+    "A35K",
+    "A380",
+    "A388",
+    "B742",
+    "B743",
+    "B744",
+    "B748",
+    "B74F",
+    "B752",
+    "B753",
+    "B762",
+    "B763",
+    "B764",
+    "B772",
+    "B773",
+    "B77F",
+    "B77L",
+    "B77W",
+    "B788",
+    "B789",
+    "B78X",
+    "DC10",
+    "IL96",
+    "MD11",
+];
+const REGIONAL_TYPES = [
+    "AT42",
+    "AT43",
+    "AT45",
+    "AT46",
+    "AT72",
+    "AT75",
+    "AT76",
+    "ATR",
+    "ATR42",
+    "ATR72",
+    "BCS1",
+    "BCS3",
+    "C25A",
+    "C56X",
+    "CRJ",
+    "CRJ1",
+    "CRJ2",
+    "CRJ7",
+    "CRJ9",
+    "CRJX",
+    "CRJ200",
+    "CRJ700",
+    "CRJ900",
+    "CRJ1000",
+    "DH8A",
+    "DH8B",
+    "DH8C",
+    "DH8D",
+    "DHC8",
+    "E135",
+    "E140",
+    "E145",
+    "E170",
+    "E175",
+    "E190",
+    "E195",
+    "E75L",
+    "E75S",
+    "ERJ",
+    "ERJ135",
+    "ERJ140",
+    "ERJ145",
+    "SB20",
+    "SF34",
+    "SF50",
+];
+/** Strip whitespace and non-alphanumeric chars and uppercase. */
+function normalizeType(aircraftType) {
+    if (!aircraftType)
+        return null;
+    const value = aircraftType.toUpperCase().trim();
+    if (!value || value === "—")
+        return null;
+    return value.replace(/[^A-Z0-9]/g, "");
+}
+/**
+ * Classify an ICAO aircraft type into widebody / narrowbody / regional.
+ * Returns "narrowbody" when the type is unknown or unparseable — it's the
+ * most common class and yields sensible (non-overly-strict) thresholds.
+ */
+export function classifyAircraft(aircraftType) {
+    const normalized = normalizeType(aircraftType);
+    if (!normalized)
+        return "narrowbody";
+    if (WIDEBODY_TYPES.includes(normalized))
+        return "widebody";
+    if (REGIONAL_TYPES.includes(normalized))
+        return "regional";
+    for (const prefix of WIDEBODY_TYPES) {
+        if (normalized.startsWith(prefix))
+            return "widebody";
+    }
+    for (const prefix of REGIONAL_TYPES) {
+        if (normalized.startsWith(prefix))
+            return "regional";
+    }
+    return "narrowbody";
+}

package/dist/helpers/index.d.ts

@@ -2,4 +2,6 @@ export { createPlugin } from "./createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./server";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./units";
 export type { WeightUnit, AltitudeUnit, DistanceUnit, UnitPreferences, } from "./units";
+export { classifyAircraft } from "./aircraft";
+export type { AircraftClass } from "./aircraft";
 //# sourceMappingURL=index.d.ts.map

package/dist/helpers/index.js

@@ -1,3 +1,4 @@
 export { createPlugin } from "./createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./server";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./units";
+export { classifyAircraft } from "./aircraft";

package/dist/hooks/useFlightEvents.js

@@ -34,12 +34,16 @@ async function fetchFlightEvents() {
 export function useFlightEvents(options) {
     const queryClient = useQueryClient();
     const { socket } = useSocket();
-    const queryKey = flightEventsKeys.log(options?.flightId);
+    // Memoized so the effect below can list queryKey in its deps without
+    // reattaching socket listeners on every render.
+    const queryKey = useMemo(() => flightEventsKeys.log(options?.flightId), [options?.flightId]);
     const { data, isLoading } = useQuery({
         queryKey,
         queryFn: fetchFlightEvents,
         staleTime: Infinity,
-        refetchOnWindowFocus: false,
+        // "always" (not true) because staleTime: Infinity would otherwise
+        // suppress the default focus refetch.
+        refetchOnWindowFocus: "always",
         refetchOnReconnect: false,
     });
     // Subscribe to Socket.io events and append new events to the cache
@@ -56,11 +60,18 @@ export function useFlightEvents(options) {
                 };
             });
         };
+        // Refetch on (re)connect — broadcasts during a disconnect window
+        // are lost from the append-only cache, so we resync from the DB.
+        const handleConnect = () => {
+            void queryClient.invalidateQueries({ queryKey });
+        };
         socket.on(SOCKET_EVENTS.FLIGHT_EVENT, handleEvent);
+        socket.on("connect", handleConnect);
         return () => {
             socket.off(SOCKET_EVENTS.FLIGHT_EVENT, handleEvent);
+            socket.off("connect", handleConnect);
         };
-    }, [socket, queryClient, options?.flightId]);
+    }, [socket, queryClient, queryKey]);
     // ── Comment Mutations ──────────────────────────────────────────────
     const addCommentMutation = useMutation({
         mutationFn: async (message) => {

package/dist/hooks/useSimulatorData.js

@@ -68,7 +68,9 @@ class SocketManager {
         this.socket = io(STRATOS_APP_BASE, {
             transports: ["websocket", "polling"],
             reconnection: true,
-            reconnectionAttempts: 5,
+            // Default Infinity — the shell is long-running and a user who
+            // alt-tabs for a minute should still find a live socket on return.
+            reconnectionAttempts: Infinity,
             reconnectionDelay: 1000,
             autoConnect: true,
         });

package/dist/hooks/useTrackingSession.js

@@ -41,7 +41,10 @@ export function useTrackingSession() {
         queryKey: trackingSessionKeys.state,
         queryFn: fetchFlightManagerState,
         staleTime: Infinity,
-        refetchOnWindowFocus: false,
+        // "always" (not true) because staleTime: Infinity would otherwise
+        // suppress the default focus refetch. Defensive against a socket
+        // that appears connected but stopped delivering broadcasts.
+        refetchOnWindowFocus: "always",
         refetchOnReconnect: false,
     });
     useEffect(() => {

package/dist/index.d.ts

@@ -2,7 +2,7 @@ export type { PluginAuthor, PluginManifest } from "./types/manifest";
 export type { PluginAirline, PluginAirlineAccessor, PluginAuthAccessor, PluginVaApiClient, PluginConfigStore, PluginContext, PluginDatabaseAccessor, PluginIPCRegistrar, PluginLogger, PluginNavigationHelper, PluginPilotUser, 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 { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, GateCapture, 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";
@@ -10,6 +10,8 @@ export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";
 export { vaApi } from "./api/vaApi";
 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 { classifyAircraft } from "./helpers/aircraft";
+export type { AircraftClass } from "./helpers/aircraft";
 export { PluginUICtx, usePluginContext } from "./hooks/context";
 export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";
 export { useFlightManager } from "./hooks/useFlightManager";

package/dist/index.js

@@ -5,6 +5,7 @@ export { createPlugin } from "./helpers/createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";
 export { vaApi } from "./api/vaApi";
 export { weightToLbs, weightFromLbs, altitudeToFt, altitudeFromFt, verticalSpeedFromFpm, verticalSpeedToFpm, distanceToNm, distanceFromNm, formatWeight, formatAltitude, formatDistance, formatVerticalSpeed, } from "./helpers/units";
+export { classifyAircraft } from "./helpers/aircraft";
 // ── React Hooks ────────────────────────────────────────────────────────
 export { PluginUICtx, usePluginContext } from "./hooks/context";
 export { useFlightEvents, flightEventsKeys } from "./hooks/useFlightEvents";

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

@@ -1,5 +1,5 @@
 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 { BounceData, CapturePoint, FlightData, FlightDataSnapshot, FlightEventPayload, FlightEventsSnapshot, FlightLandingPayload, FlightLogEvent, FlightPhasePayload, FlightPhaseSnapshot, FlightStateDebugInfo, FlightTrends, GateCapture, 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";

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

@@ -266,6 +266,17 @@ export type BounceData = {
     touchdownGForce: number;
     durationMs: number;
 };
+/** Snapshot of aircraft state at the 50 ft stabilized-approach gate */
+export type GateCapture = {
+    /** Actual AGL at capture, may be a few ft above/below the nominal 50 ft */
+    altitudeAgl: number;
+    indicatedAirspeed: number;
+    verticalSpeed: number;
+    bank: number;
+    pitch: number;
+    groundSpeed: number;
+    timestamp: number;
+};
 /** Complete landing analysis result */
 export type LandingAnalysis = {
     landingRateFpm: number;
@@ -281,7 +292,15 @@ export type LandingAnalysis = {
     approachAltitude: number;
     approachIas: number;
     approachVs: number;
+    approachBank: number;
+    approachPitch: number;
     approachTimestamp: number;
+    /**
+     * Snapshot at ~50 ft AGL on final, used for the stabilized-approach gate.
+     * Null when the capture was missed (e.g. very fast descent, sim disconnect
+     * right before touchdown, or capture armed below 50 ft).
+     */
+    gateCapture: GateCapture | null;
     descentTimeSeconds: number;
     averageDescentRateFpm: number;
     bounceCount: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyvexsoftware/stratos-sdk",
-  "version": "0.8.0",
+  "version": "0.9.0",
   "description": "Plugin SDK for Stratos — types, hooks, and UI components",
   "author": {
     "name": "Skyvex Software Pty Ltd",