@skyvexsoftware/stratos-sdk 0.1.1

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

@@ -0,0 +1,188 @@
+// NOTE: This file runs inside the plugin developer's Vite process, NOT inside
+// Stratos. Using console.log / console.error here is intentional and correct —
+// this is tooling/build infrastructure, not app code.
+import * as fs from "fs";
+import * as path from "path";
+import { build } from "vite";
+import { io as ioClient } from "socket.io-client";
+/**
+ * Vite plugin that auto-connects a plugin's dev server to a running Stratos
+ * app. Only active in serve (dev) mode.
+ *
+ * On startup it:
+ *  - Reads plugin.json from the plugin directory
+ *  - Derives the dev URL from the Vite HTTP server address
+ *  - Connects to Stratos's Socket.io server and emits dev:plugin-connect
+ *  - Retries with exponential backoff if Stratos isn't running
+ *
+ * If src/background/ exists, it watches for changes and rebuilds the
+ * background bundle, then notifies Stratos via dev:plugin-bg-updated.
+ */
+export function stratosDevServer(options) {
+    const { pluginDir } = options;
+    return {
+        name: "stratos-dev-server",
+        apply: "serve",
+        configureServer(server) {
+            const stratosPort = options.stratosPort ??
+                (process.env.STRATOS_PORT
+                    ? parseInt(process.env.STRATOS_PORT, 10)
+                    : 2066);
+            let socket = null;
+            let retryTimeout = null;
+            let retryDelay = 3000;
+            const MAX_RETRY_DELAY = 30000;
+            // Read plugin manifest
+            let manifest = {};
+            const manifestPath = path.resolve(pluginDir, "plugin.json");
+            try {
+                manifest = JSON.parse(fs.readFileSync(manifestPath, "utf-8"));
+            }
+            catch {
+                console.error("[stratos-dev-server] Failed to read plugin.json at", manifestPath);
+            }
+            const pluginId = manifest.id ?? "unknown";
+            function clearRetry() {
+                if (retryTimeout) {
+                    clearTimeout(retryTimeout);
+                    retryTimeout = null;
+                }
+            }
+            function scheduleRetry() {
+                clearRetry();
+                retryTimeout = setTimeout(() => {
+                    retryTimeout = null;
+                    connect();
+                }, retryDelay);
+                retryDelay = Math.min(retryDelay * 2, MAX_RETRY_DELAY);
+            }
+            function getDevUrl() {
+                const addr = server.httpServer?.address();
+                if (addr && typeof addr === "object") {
+                    const host = addr.address === "::" || addr.address === "0.0.0.0"
+                        ? "localhost"
+                        : addr.address;
+                    return `http://${host}:${addr.port}`;
+                }
+                return "http://localhost:5173";
+            }
+            function connect() {
+                if (socket) {
+                    socket.removeAllListeners();
+                    socket.disconnect();
+                    socket = null;
+                }
+                const stratosUrl = `http://127.0.0.1:${stratosPort}`;
+                socket = ioClient(stratosUrl, {
+                    reconnection: false,
+                    timeout: 5000,
+                });
+                socket.on("connect", () => {
+                    retryDelay = 3000; // reset on success
+                    const devUrl = getDevUrl();
+                    const distPath = path.resolve(pluginDir, "dist");
+                    console.log(`[stratos-dev-server] Connected to Stratos (localhost:${stratosPort})`);
+                    socket.emit("dev:plugin-connect", {
+                        manifest,
+                        devUrl,
+                        capabilities: ["ui", "hot-reload"],
+                        distPath,
+                    });
+                });
+                socket.on("dev:plugin-mounted", (data) => {
+                    const id = data?.pluginId ?? pluginId;
+                    console.log(`[stratos-dev-server] Plugin "${id}" mounted`);
+                });
+                socket.on("dev:plugin-error", (data) => {
+                    const msg = data?.message ?? data?.error ?? "Unknown error";
+                    console.error(`[stratos-dev-server] Plugin error from Stratos: ${msg}`);
+                });
+                socket.on("disconnect", () => {
+                    console.log("[stratos-dev-server] Disconnected from Stratos, retrying...");
+                    scheduleRetry();
+                });
+                socket.on("connect_error", () => {
+                    scheduleRetry();
+                });
+            }
+            // ── Background file watcher ──────────────────────────────────────────
+            const bgDir = path.resolve(pluginDir, "src/background");
+            let bgWatcher = null;
+            let bgDebounce = null;
+            async function rebuildBackground() {
+                try {
+                    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: true,
+                        },
+                        logLevel: "warn",
+                    });
+                    const bundlePath = path.resolve(pluginDir, "dist/background/index.js");
+                    console.log("[stratos-dev-server] Background rebuilt, notifying Stratos...");
+                    if (socket?.connected) {
+                        socket.emit("dev:plugin-bg-updated", {
+                            pluginId,
+                            bundlePath,
+                            timestamp: Date.now(),
+                        });
+                    }
+                }
+                catch (err) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    console.error(`[stratos-dev-server] Background build failed: ${message}`);
+                    if (socket?.connected) {
+                        socket.emit("dev:plugin-bg-error", {
+                            pluginId,
+                            error: message,
+                        });
+                    }
+                }
+            }
+            if (fs.existsSync(bgDir)) {
+                bgWatcher = fs.watch(bgDir, { recursive: true }, () => {
+                    if (bgDebounce)
+                        clearTimeout(bgDebounce);
+                    bgDebounce = setTimeout(() => {
+                        bgDebounce = null;
+                        void rebuildBackground();
+                    }, 200);
+                });
+            }
+            // ── Cleanup ───────────────────────────────────────────────────────────
+            function cleanup() {
+                clearRetry();
+                if (bgDebounce) {
+                    clearTimeout(bgDebounce);
+                    bgDebounce = null;
+                }
+                bgWatcher?.close();
+                if (socket) {
+                    if (socket.connected) {
+                        socket.emit("dev:plugin-disconnect", { pluginId });
+                    }
+                    socket.removeAllListeners();
+                    socket.disconnect();
+                    socket = null;
+                }
+            }
+            server.httpServer?.once("close", cleanup);
+            process.once("SIGINT", cleanup);
+            process.once("SIGTERM", cleanup);
+            // Start connecting after the HTTP server is listening
+            server.httpServer?.once("listening", () => {
+                connect();
+            });
+        },
+    };
+}
+//# sourceMappingURL=stratos-dev-server.js.map

package/package.json

@@ -0,0 +1,96 @@
+{
+  "name": "@skyvexsoftware/stratos-sdk",
+  "version": "0.1.1",
+  "description": "Plugin SDK for Stratos — types, hooks, and UI components",
+  "author": {
+    "name": "Skyvex Software",
+    "email": "jordan@skyvexsoftware.com"
+  },
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/types/index.js"
+    },
+    "./ui": {
+      "types": "./dist/ui/index.d.ts",
+      "import": "./dist/ui/index.js"
+    },
+    "./hooks": {
+      "types": "./dist/hooks/index.d.ts",
+      "import": "./dist/hooks/index.js"
+    },
+    "./helpers": {
+      "types": "./dist/helpers/index.d.ts",
+      "import": "./dist/helpers/index.js"
+    },
+    "./vite": {
+      "types": "./dist/vite/plugin-config.d.ts",
+      "import": "./dist/vite/plugin-config.js"
+    }
+  },
+  "files": [
+    "dist",
+    "!dist/**/*.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "@radix-ui/react-alert-dialog": "^1.1.0",
+    "@radix-ui/react-dialog": "^1.1.0",
+    "@radix-ui/react-label": "^2.1.0",
+    "@radix-ui/react-radio-group": "^1.3.0",
+    "@radix-ui/react-select": "^2.1.0",
+    "@radix-ui/react-separator": "^1.1.0",
+    "@radix-ui/react-slider": "^1.3.0",
+    "@radix-ui/react-slot": "^1.2.0",
+    "@radix-ui/react-switch": "^1.2.0",
+    "@radix-ui/react-tabs": "^1.1.0",
+    "@radix-ui/react-tooltip": "^1.1.0",
+    "@tanstack/react-query": "^5.0.0",
+    "class-variance-authority": "^0.7.0",
+    "lucide-react": ">=0.300.0",
+    "react": "^19.0.0",
+    "socket.io-client": "^4.0.0",
+    "@vitejs/plugin-react": "^5.0.0",
+    "vite": "^7.0.0"
+  },
+  "dependencies": {
+    "clsx": "^2.1.1",
+    "tailwind-merge": "^3.2.0"
+  },
+  "devDependencies": {
+    "@radix-ui/react-alert-dialog": "^1.1.15",
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-radio-group": "^1.3.8",
+    "@radix-ui/react-select": "^2.1.8",
+    "@radix-ui/react-separator": "^1.1.4",
+    "@radix-ui/react-slider": "^1.3.6",
+    "@radix-ui/react-slot": "^1.2.0",
+    "@radix-ui/react-switch": "^1.2.6",
+    "@radix-ui/react-tabs": "^1.1.8",
+    "@radix-ui/react-tooltip": "^1.1.12",
+    "@types/react": "^19.1.2",
+    "class-variance-authority": "^0.7.1",
+    "lucide-react": "^0.503.0",
+    "@vitejs/plugin-react": "^5.1.4",
+    "socket.io-client": "^4.8.3",
+    "typescript": "^5.8.3",
+    "vite": "^7.3.1"
+  },
+  "scripts": {
+    "build": "tsc -b",
+    "lint": "eslint src --ext .ts,.tsx",
+    "tsc": "tsc --noEmit",
+    "typecheck": "tsc --noEmit"
+  }
+}