@skyvexsoftware/stratos-sdk 0.7.3 → 0.7.4

package/dist/shims/react-dom-client.js

@@ -5,7 +5,7 @@
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const __m = globalThis.__stratos_modules__?.["react-dom/client"];
 if (!__m)
-    throw new Error("Stratos: window.__stratos_modules__[\"react-dom/client\"] is not available. The shell must initialize it before plugin modules evaluate.");
+    throw new Error('Stratos: window.__stratos_modules__["react-dom/client"] is not available. The shell must initialize it before plugin modules evaluate.');
 export default __m.default ?? __m;
 export const createRoot = __m.createRoot;
 export const hydrateRoot = __m.hydrateRoot;

package/dist/shims/react-dom.js

@@ -5,7 +5,7 @@
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const __m = globalThis.__stratos_modules__?.["react-dom"];
 if (!__m)
-    throw new Error("Stratos: window.__stratos_modules__[\"react-dom\"] is not available. The shell must initialize it before plugin modules evaluate.");
+    throw new Error('Stratos: window.__stratos_modules__["react-dom"] is not available. The shell must initialize it before plugin modules evaluate.');
 export default __m.default ?? __m;
 export const __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE = __m.__DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
 export const createPortal = __m.createPortal;

package/dist/shims/react-jsx-dev-runtime.js

@@ -5,7 +5,7 @@
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const __m = globalThis.__stratos_modules__?.["react/jsx-dev-runtime"];
 if (!__m)
-    throw new Error("Stratos: window.__stratos_modules__[\"react/jsx-dev-runtime\"] is not available. The shell must initialize it before plugin modules evaluate.");
+    throw new Error('Stratos: window.__stratos_modules__["react/jsx-dev-runtime"] is not available. The shell must initialize it before plugin modules evaluate.');
 export default __m.default ?? __m;
 export const Fragment = __m.Fragment;
 export const jsxDEV = __m.jsxDEV;

package/dist/shims/react-jsx-runtime.js

@@ -5,7 +5,7 @@
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const __m = globalThis.__stratos_modules__?.["react/jsx-runtime"];
 if (!__m)
-    throw new Error("Stratos: window.__stratos_modules__[\"react/jsx-runtime\"] is not available. The shell must initialize it before plugin modules evaluate.");
+    throw new Error('Stratos: window.__stratos_modules__["react/jsx-runtime"] is not available. The shell must initialize it before plugin modules evaluate.');
 export default __m.default ?? __m;
 export const Fragment = __m.Fragment;
 export const jsx = __m.jsx;

package/dist/shims/react.js

@@ -5,7 +5,7 @@
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 const __m = globalThis.__stratos_modules__?.["react"];
 if (!__m)
-    throw new Error("Stratos: window.__stratos_modules__[\"react\"] is not available. The shell must initialize it before plugin modules evaluate.");
+    throw new Error('Stratos: window.__stratos_modules__["react"] is not available. The shell must initialize it before plugin modules evaluate.');
 export default __m.default ?? __m;
 export const __CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE = __m.__CLIENT_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE;
 export const __COMPILER_RUNTIME = __m.__COMPILER_RUNTIME;

package/dist/vite/hmr-base-rewrite.js

@@ -22,12 +22,36 @@
  *   /@vite/client imports added by importAnalysis (which runs after all
  *   user transforms)
  */
+// Virtual module that installs the React Fast Refresh globals. Must be
+// imported as a SIDE EFFECT at the top of the plugin's entry so ESM
+// evaluates it before any sibling (child-component) module — whose
+// plugin-react epilogue asserts `window.$RefreshReg$` exists.
+const PREAMBLE_VIRTUAL_ID = "/@stratos-refresh-preamble";
+const PREAMBLE_RESOLVED_ID = "\0stratos-refresh-preamble";
 export function hmrBaseRewrite() {
     let devOrigin = "";
     return {
         name: "stratos-hmr-base-rewrite",
         apply: "serve",
         enforce: "post",
+        resolveId(source) {
+            if (source === PREAMBLE_VIRTUAL_ID)
+                return PREAMBLE_RESOLVED_ID;
+            return null;
+        },
+        load(id) {
+            if (id !== PREAMBLE_RESOLVED_ID)
+                return null;
+            if (!devOrigin)
+                return null;
+            return [
+                `import RefreshRuntime from "${devOrigin}/@react-refresh";`,
+                `RefreshRuntime.injectIntoGlobalHook(window);`,
+                `window.$RefreshReg$ = () => {};`,
+                `window.$RefreshSig$ = () => (type) => type;`,
+                `window.__vite_plugin_react_preamble_installed__ = true;`,
+            ].join("\n");
+        },
         configureServer(server) {
             server.httpServer?.once("listening", () => {
                 const addr = server.httpServer?.address();
@@ -91,16 +115,23 @@ export function hmrBaseRewrite() {
             //    (catches imports from @vitejs/plugin-react and CSS transforms)
             patched = patched.replace(/(from\s+["'])(\/(?:@vite\/[^"']+|@react-refresh))(["'])/g, `$1${devOrigin}$2$3`);
             patched = patched.replace(/(import\s*\(\s*["'])(\/(?:@vite\/[^"']+|@react-refresh))(["'])/g, `$1${devOrigin}$2$3`);
-            // 3. Inject React Fast Refresh preamble into the entry file.
-            if (id.endsWith("/src/ui/index.tsx") || id.endsWith("/src/ui/index.ts")) {
-                const preamble = [
-                    `import __StratosRefresh__ from "${devOrigin}/@react-refresh";`,
-                    `__StratosRefresh__.injectIntoGlobalHook(window);`,
-                    `window.$RefreshReg$ = () => {};`,
-                    `window.$RefreshSig$ = () => (type) => type;`,
-                    `window.__vite_plugin_react_preamble_installed__ = true;`,
-                ].join("\n");
-                patched = preamble + "\n" + patched;
+            // 3. Inject the Fast Refresh preamble as a SIDE-EFFECT IMPORT at the
+            //    top of the entry. Prepending the preamble inline doesn't work:
+            //    ESM hoists all imports and evaluates them depth-first BEFORE any
+            //    top-level code runs, so every child component's plugin-react
+            //    epilogue (`if (!window.$RefreshReg$) throw ...`) fires before
+            //    the entry's top-level preamble sets those globals. A sibling
+            //    import evaluates *fully* before the next sibling begins, so
+            //    putting the preamble as the FIRST import means it's installed
+            //    before any component module evaluates.
+            //
+            //    Strip query string first: the shell appends `?t=<timestamp>` for
+            //    cache-busting, and Vite passes the id through with the query — so
+            //    a raw `endsWith` check misses every shell load.
+            const idPath = id.split("?")[0];
+            if (idPath.endsWith("/src/ui/index.tsx") ||
+                idPath.endsWith("/src/ui/index.ts")) {
+                patched = `import "${devOrigin}${PREAMBLE_VIRTUAL_ID}";\n${patched}`;
             }
             if (patched !== code) {
                 return { code: patched, map: null };

package/dist/vite/plugin-config.d.ts

@@ -40,5 +40,12 @@ export type PluginBuildOptions = {
  * - "background"     → builds the background module (Node.js, ESM)
  */
 export declare function createPluginConfig(options: PluginBuildOptions): UserConfig;
+/**
+ * Shared background build configuration — used both for the production
+ * build (createBackgroundConfig below) and the dev hot-rebuilder in
+ * stratos-dev-server. Extracted so dev and prod can never drift on
+ * aliases, externals, or output layout.
+ */
+export declare function backgroundBuildOptions(pluginDir: string, entry: string): Pick<UserConfig, "root" | "resolve" | "build">;
 export { UI_EXTERNALS, BG_EXTERNALS, stratosExternals };
 //# sourceMappingURL=plugin-config.d.ts.map

package/dist/vite/plugin-config.js

@@ -198,14 +198,16 @@ function createUIConfig(pluginDir, entry, extraConfig) {
         ],
     };
 }
-function createBackgroundConfig(pluginDir, entry) {
-    const isProduction = process.env.NODE_ENV === "production";
+/**
+ * Shared background build configuration — used both for the production
+ * build (createBackgroundConfig below) and the dev hot-rebuilder in
+ * stratos-dev-server. Extracted so dev and prod can never drift on
+ * aliases, externals, or output layout.
+ */
+export function backgroundBuildOptions(pluginDir, entry) {
     return {
         root: pluginDir,
         resolve: {
-            // Same default `@/` → `src/` alias as the UI config, so background
-            // code can share import conventions with the UI without each plugin
-            // wiring it up in its vite.config.ts.
             alias: [
                 { find: /^@\//, replacement: path.resolve(pluginDir, "src") + "/" },
             ],
@@ -220,7 +222,6 @@ function createBackgroundConfig(pluginDir, entry) {
             },
             rollupOptions: {
                 external: (id) => {
-                    // Bundle the SDK helpers subpath (createPlugin) into the output
                     if (id === "@skyvexsoftware/stratos-sdk/helpers")
                         return false;
                     if (id === "@skyvexsoftware/stratos-sdk")
@@ -237,4 +238,7 @@ function createBackgroundConfig(pluginDir, entry) {
         },
     };
 }
+function createBackgroundConfig(pluginDir, entry) {
+    return backgroundBuildOptions(pluginDir, entry);
+}
 export { UI_EXTERNALS, BG_EXTERNALS, stratosExternals };

package/dist/vite/stratos-dev-server.js

@@ -5,6 +5,7 @@ import * as fs from "fs";
 import * as path from "path";
 import { build } from "vite";
 import { io as ioClient } from "socket.io-client";
+import { backgroundBuildOptions } from "./plugin-config.js";
 /**
  * Vite plugin that auto-connects a plugin's dev server to a running Stratos
  * app. Only active in serve (dev) mode.
@@ -94,10 +95,17 @@ export function stratosDevServer(options) {
                     const devUrl = getDevUrl();
                     const distPath = path.resolve(pluginDir, "dist");
                     console.log(`[stratos-dev-server] Connected to Stratos (localhost:${stratosPort})`);
+                    // Stratos's dev-plugin-server-listener only starts the background
+                    // module when "background" is in this array. Advertise it whenever
+                    // src/background/ exists.
+                    const capabilities = ["ui", "hot-reload"];
+                    if (fs.existsSync(path.resolve(pluginDir, "src/background"))) {
+                        capabilities.push("background");
+                    }
                     socket.emit("dev:plugin-connect", {
                         manifest,
                         devUrl,
-                        capabilities: ["ui", "hot-reload"],
+                        capabilities,
                         distPath,
                         sourceRoot: pluginDir,
                         wsToken,
@@ -125,20 +133,11 @@ export function stratosDevServer(options) {
             let bgDebounce = null;
             async function rebuildBackground() {
                 try {
+                    // Reuse the same options the production build uses so dev rebuilds
+                    // get the `@/` alias, electron/node externals, etc.
                     await build({
                         configFile: false,
-                        root: pluginDir,
-                        build: {
-                            lib: {
-                                entry: "src/background/index.ts",
-                                formats: ["es"],
-                                fileName: () => "index.js",
-                            },
-                            outDir: path.resolve(pluginDir, "dist/background"),
-                            emptyOutDir: true,
-                            minify: false,
-                            sourcemap: false,
-                        },
+                        ...backgroundBuildOptions(pluginDir, "src/background/index.ts"),
                         logLevel: "warn",
                     });
                     const bundlePath = path.resolve(pluginDir, "dist/background/index.js");

package/package.json

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