@skyvexsoftware/stratos-sdk 0.10.0 → 0.10.1

package/dist/index.d.ts

@@ -4,6 +4,8 @@ export type { PluginBackgroundModule, PluginRouteComponent, PluginUIModule, } fr
 export { FlightPhase, SimulatorType, EventCategory, } 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 { ADDITIONAL_FIELD_PHASES, toPhaseKey, } from "./shared-types/additional-fields";
+export type { AdditionalFieldsConfig, FieldDelivery, } from "./shared-types/additional-fields";
 export type { FlightPlan, FlightStatus, CurrentFlight, FlightComment, PreflightCheck, PreflightCheckResult, StartFlightOptions, FlightManagerPayload, StartFlightResult, RecoverableFlight, } from "./shared-types/flight-manager";
 export { createPlugin } from "./helpers/createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";

package/dist/index.js

@@ -1,5 +1,6 @@
 // ── Shared Types ───────────────────────────────────────────────────────
 export { FlightPhase, SimulatorType, EventCategory, } from "./shared-types/simulator";
+export { ADDITIONAL_FIELD_PHASES, toPhaseKey, } from "./shared-types/additional-fields";
 // ── Helper Functions ───────────────────────────────────────────────────
 export { createPlugin } from "./helpers/createPlugin";
 export { STRATOS_APP_PORT, STRATOS_APP_BASE } from "./helpers/server";

package/dist/shared-types/additional-fields.d.ts

@@ -0,0 +1,26 @@
+import { FlightPhase } from "./simulator";
+/**
+ * Per-field delivery rule. `phases` lists the uppercase flight-phase keys in
+ * which the field is appended to position-update ticks; `submission` controls
+ * whether the field is included in the `/flights/complete` payload.
+ */
+export type FieldDelivery = {
+    phases: string[];
+    submission: boolean;
+};
+/**
+ * Airline-scoped `additionalFields` config: a map keyed by field key, each
+ * value a {@link FieldDelivery} rule. A field absent from the map is sent
+ * nowhere.
+ */
+export type AdditionalFieldsConfig = Record<string, FieldDelivery>;
+/** The 15 canonical phase keys (uppercase), in flight order. Excludes UNKNOWN. */
+export declare const ADDITIONAL_FIELD_PHASES: readonly ["BOARDING", "PUSH_BACK", "TAXI", "TAKE_OFF", "REJECTED_TAKE_OFF", "CLIMB", "CRUISE", "DESCENT", "APPROACH", "FINAL", "LANDED", "GO_AROUND", "TAXI_IN", "ARRIVED", "DEBOARDING"];
+/**
+ * Map a FlightPhase enum value to its uppercase config phase key, or null if it
+ * has no column (UNKNOWN, or a missing/undefined phase). Defensive against
+ * runtime flight data that arrives before phase detection has populated
+ * `phase` — never assume the flight starts in a known phase.
+ */
+export declare function toPhaseKey(phase: FlightPhase | undefined | null): string | null;
+//# sourceMappingURL=additional-fields.d.ts.map

package/dist/shared-types/additional-fields.js

@@ -0,0 +1,30 @@
+import { FlightPhase } from "./simulator";
+/** The 15 canonical phase keys (uppercase), in flight order. Excludes UNKNOWN. */
+export const ADDITIONAL_FIELD_PHASES = [
+    "BOARDING",
+    "PUSH_BACK",
+    "TAXI",
+    "TAKE_OFF",
+    "REJECTED_TAKE_OFF",
+    "CLIMB",
+    "CRUISE",
+    "DESCENT",
+    "APPROACH",
+    "FINAL",
+    "LANDED",
+    "GO_AROUND",
+    "TAXI_IN",
+    "ARRIVED",
+    "DEBOARDING",
+];
+/**
+ * Map a FlightPhase enum value to its uppercase config phase key, or null if it
+ * has no column (UNKNOWN, or a missing/undefined phase). Defensive against
+ * runtime flight data that arrives before phase detection has populated
+ * `phase` — never assume the flight starts in a known phase.
+ */
+export function toPhaseKey(phase) {
+    if (phase == null || phase === FlightPhase.UNKNOWN)
+        return null;
+    return phase.toUpperCase();
+}

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

@@ -1,6 +1,8 @@
 export { FlightPhase, SimulatorType, EventCategory } 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 { ADDITIONAL_FIELD_PHASES, toPhaseKey } from "./additional-fields";
+export type { AdditionalFieldsConfig, FieldDelivery, } from "./additional-fields";
 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";

package/dist/shared-types/index.js

@@ -1,3 +1,4 @@
 export { FlightPhase, SimulatorType, EventCategory } from "./simulator";
+export { ADDITIONAL_FIELD_PHASES, toPhaseKey } from "./additional-fields";
 // ── Socket.io Event Catalog ──────────────────────────────────────────────
 export { SOCKET_EVENTS } from "./socket-events";

package/dist/vite/plugin-config.js

@@ -17,6 +17,7 @@
  */
 import * as fs from "fs";
 import * as path from "path";
+import { builtinModules } from "module";
 import { UI_EXTERNALS } from "./externals.js";
 import { stratosExternals } from "./stratos-externals.js";
 import { serveExternals } from "./serve-externals.js";
@@ -26,35 +27,16 @@ import { hmrBaseRewrite } from "./hmr-base-rewrite.js";
 import { reactShimAliases } from "./react-shim.js";
 /** Modules external in background builds (available in Electron main process) */
 const BG_EXTERNALS = ["electron", "socket.io-client"];
-/** Node.js built-in modules to externalize in background builds */
-const NODE_BUILTINS = [
-    "assert",
-    "buffer",
-    "child_process",
-    "cluster",
-    "crypto",
-    "dgram",
-    "dns",
-    "events",
-    "fs",
-    "http",
-    "https",
-    "module",
-    "net",
-    "os",
-    "path",
-    "perf_hooks",
-    "querystring",
-    "readline",
-    "stream",
-    "tls",
-    "url",
-    "util",
-    "v8",
-    "vm",
-    "worker_threads",
-    "zlib",
-];
+/**
+ * Node.js built-in modules to externalize in background builds. Derived from
+ * Node's own registry (with both bare `fs` and prefixed `node:fs` forms) so it
+ * can never drift — the old hand-maintained list omitted modules like
+ * `async_hooks`, which then got browser-stubbed and broke at runtime.
+ */
+const NODE_BUILTINS = new Set([
+    ...builtinModules,
+    ...builtinModules.map((m) => `node:${m}`),
+]);
 /**
  * Rollup plugin that copies plugin.json and assets/ to dist/ after the build.
  * Only runs during the UI build (not background) to avoid duplicate copies.
@@ -211,6 +193,13 @@ export function backgroundBuildOptions(pluginDir, entry) {
             alias: [
                 { find: /^@\//, replacement: path.resolve(pluginDir, "src") + "/" },
             ],
+            // Resolve dependencies for Node, not the browser. Vite's default
+            // resolution is browser-first, which picks the "browser" build of
+            // packages like `ws` (whose browser shim has no WebSocketServer). The
+            // background module runs in the Electron main process, so it needs the
+            // Node build of everything it bundles.
+            conditions: ["node", "module", "import", "default"],
+            mainFields: ["module", "jsnext:main", "main"],
         },
         build: {
             outDir: path.resolve(pluginDir, "dist/background"),
@@ -228,7 +217,7 @@ export function backgroundBuildOptions(pluginDir, entry) {
                         return true;
                     if (BG_EXTERNALS.some((ext) => id === ext || id.startsWith(`${ext}/`)))
                         return true;
-                    if (NODE_BUILTINS.some((b) => id === b || id === `node:${b}`))
+                    if (NODE_BUILTINS.has(id))
                         return true;
                     return false;
                 },

package/package.json

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