@skyvexsoftware/stratos-sdk 0.1.13 → 0.1.15

package/dist/bin/deploy.js

@@ -15,6 +15,12 @@ import { execSync } from "child_process";
 import * as https from "https";
 import * as http from "http";
 const API_BASE = "https://skyvexsoftware.com/api/stratos";
+// ── CLI flags ───────────────────────────────────────────────────────
+const releaseModeArg = process.argv.find((a) => a.startsWith("--release-mode="));
+const releaseMode = releaseModeArg?.split("=")[1] ?? "automatic";
+if (releaseMode !== "automatic" && releaseMode !== "manual") {
+    fatal("--release-mode must be 'automatic' or 'manual'");
+}
 // ── Helpers ──────────────────────────────────────────────────────────
 function fatal(message) {
     console.error(`\n  Error: ${message}\n`);
@@ -67,17 +73,18 @@ function createBundle(cwd) {
     return bundlePath;
 }
 // ── Upload ───────────────────────────────────────────────────────────
-function upload(pluginId, version, bundlePath, token) {
+function upload(pluginId, bundlePath, token) {
     return new Promise((resolve) => {
         const boundary = `----StratosDeploy${Date.now()}`;
         const fileContent = fs.readFileSync(bundlePath);
         const parts = [];
-        // Version field
-        parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="version"\r\n\r\n${version}\r\n`));
-        // File field
+        // File field (version is extracted from plugin.json inside the zip server-side)
         parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="file"; filename="bundle.zip"\r\nContent-Type: application/zip\r\n\r\n`));
         parts.push(fileContent);
-        parts.push(Buffer.from(`\r\n--${boundary}--\r\n`));
+        parts.push(Buffer.from("\r\n"));
+        // Release mode field
+        parts.push(Buffer.from(`--${boundary}\r\nContent-Disposition: form-data; name="release_mode"\r\n\r\n${releaseMode}\r\n`));
+        parts.push(Buffer.from(`--${boundary}--\r\n`));
         const body = Buffer.concat(parts);
         const url = new URL(`${API_BASE}/plugins/${pluginId}/versions`);
         const options = {
@@ -114,10 +121,11 @@ async function main() {
     const bundlePath = createBundle(cwd);
     const bundleSize = fs.statSync(bundlePath).size;
     console.log(`\n  ${name} v${version} — bundle.zip (${formatSize(bundleSize)})`);
+    console.log(`  Release mode: ${releaseMode}`);
     const token = process.env.SKYVEX_API_TOKEN;
     if (token) {
         console.log("  Uploading to Skyvex...");
-        const result = await upload(id, version, bundlePath, token);
+        const result = await upload(id, bundlePath, token);
         if (result.ok) {
             console.log("  Published! Server is signing and publishing to CDN.\n");
             fs.unlinkSync(bundlePath);

package/dist/types/manifest.d.ts

@@ -38,5 +38,7 @@ export type PluginManifest = {
     icon_dark: string;
     /** Typed settings this plugin declares. User-scoped settings render in the Settings page; airline-scoped settings are managed by the VA platform. */
     availableSettings?: PluginSettingDefinition[];
+    /** Whether to include source maps in the published CDN bundle. Defaults to false — source maps are stripped on approval. Set to true if you want end users to have access to source maps for debugging. */
+    includeSourceMaps?: boolean;
 };
 //# sourceMappingURL=manifest.d.ts.map

package/dist/vite/css-inject.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Vite plugin that injects extracted CSS into the JS bundle for library mode.
+ *
+ * In Vite library mode, CSS imports are extracted to a separate .css file.
+ * Since plugins are loaded via dynamic import(), the CSS file is never loaded.
+ * This plugin moves the CSS content into the JS entry chunk so it's injected
+ * into the DOM automatically when the plugin module is imported.
+ */
+import type { Plugin } from "vite";
+export declare function cssInject(): Plugin;
+//# sourceMappingURL=css-inject.d.ts.map

package/dist/vite/css-inject.js

@@ -0,0 +1,47 @@
+/**
+ * Vite plugin that injects extracted CSS into the JS bundle for library mode.
+ *
+ * In Vite library mode, CSS imports are extracted to a separate .css file.
+ * Since plugins are loaded via dynamic import(), the CSS file is never loaded.
+ * This plugin moves the CSS content into the JS entry chunk so it's injected
+ * into the DOM automatically when the plugin module is imported.
+ */
+export function cssInject() {
+    return {
+        name: "stratos-css-inject",
+        apply: "build",
+        enforce: "post",
+        generateBundle(_, bundle) {
+            // Find emitted CSS assets
+            const cssAssets = [];
+            let cssContent = "";
+            for (const [fileName, chunk] of Object.entries(bundle)) {
+                if (fileName.endsWith(".css") && chunk.type === "asset") {
+                    cssContent +=
+                        typeof chunk.source === "string"
+                            ? chunk.source
+                            : new TextDecoder().decode(chunk.source);
+                    cssAssets.push(fileName);
+                }
+            }
+            if (!cssContent)
+                return;
+            // Find the JS entry chunk
+            const jsEntry = Object.values(bundle).find((chunk) => chunk.type === "chunk" && chunk.isEntry);
+            if (!jsEntry || jsEntry.type !== "chunk")
+                return;
+            // Prepend CSS injection code to the JS entry
+            const escaped = cssContent
+                .replace(/\\/g, "\\\\")
+                .replace(/`/g, "\\`")
+                .replace(/\$/g, "\\$");
+            const injection = `(function(){try{var s=document.createElement("style");s.textContent=\`${escaped}\`;document.head.appendChild(s)}catch(e){}})();\n`;
+            jsEntry.code = injection + jsEntry.code;
+            // Remove the separate CSS files
+            for (const name of cssAssets) {
+                delete bundle[name];
+            }
+        },
+    };
+}
+//# sourceMappingURL=css-inject.js.map

package/dist/vite/plugin-config.js

@@ -17,9 +17,11 @@
  */
 import * as fs from "fs";
 import * as path from "path";
+import MagicString from "magic-string";
 import { UI_EXTERNALS } from "./externals.js";
 import { serveExternals } from "./serve-externals.js";
 import { stratosDevServer } from "./stratos-dev-server.js";
+import { cssInject } from "./css-inject.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 */
@@ -63,49 +65,84 @@ function stratosExternals() {
     return {
         name: "stratos-externals",
         renderChunk(code) {
-            let result = code;
+            const s = new MagicString(code);
             for (const modId of UI_EXTERNALS) {
                 const escaped = modId.replace(/[-/\\^$*+?.()|[\]{}@]/g, "\\$&");
                 const global = `window.__stratos_modules__[${JSON.stringify(modId)}]`;
-                // 1. import Default, { named as alias } from 'mod';
-                // Note: [\w$]+ handles Rollup's conflict-resolution names like Map$1
-                result = result.replace(new RegExp(`import\\s+([\\w$]+)\\s*,\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"), (_, def, names) => {
-                    const destructured = names.replace(/([\w$]+)\s+as\s+([\w$]+)/g, "$1: $2");
-                    return `const ${def} = ${global}.default || ${global};\nconst {${destructured}} = ${global};`;
-                });
-                // 2. import { named as alias } from 'mod';
-                result = result.replace(new RegExp(`import\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"), (_, names) => {
-                    const destructured = names.replace(/([\w$]+)\s+as\s+([\w$]+)/g, "$1: $2");
-                    return `const {${destructured}} = ${global};`;
-                });
-                // 3. import * as ns from 'mod';
-                result = result.replace(new RegExp(`import\\s+\\*\\s+as\\s+([\\w$]+)\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"), (_, name) => `const ${name} = ${global};`);
-                // 4. import Default from 'mod';
-                result = result.replace(new RegExp(`import\\s+([\\w$]+)\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"), (_, def) => `const ${def} = ${global}.default || ${global};`);
-                // 5. import 'mod'; (side effect only)
-                result = result.replace(new RegExp(`import\\s+['"]${escaped}['"]\\s*;?`, "g"), "");
-                // 6. export { name } from 'mod'; (re-export)
-                result = result.replace(new RegExp(`export\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"), (_, names) => {
-                    const parts = names.split(",").map((n) => n.trim());
-                    const decls = [];
-                    const exportNames = [];
-                    for (const part of parts) {
-                        const asMatch = part.match(/^([\w$]+)\s+as\s+([\w$]+)$/);
-                        if (asMatch) {
-                            decls.push(`const ${asMatch[2]} = ${global}[${JSON.stringify(asMatch[1])}];`);
-                            exportNames.push(asMatch[2]);
-                        }
-                        else {
-                            exportNames.push(part);
-                        }
+                const patterns = [
+                    // 1. import Default, { named } from 'mod';
+                    [
+                        new RegExp(`import\\s+([\\w$]+)\\s*,\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"),
+                        (_, def, names) => {
+                            const destructured = names.replace(/([\w$]+)\s+as\s+([\w$]+)/g, "$1: $2");
+                            return `const ${def} = ${global}.default || ${global};\nconst {${destructured}} = ${global};`;
+                        },
+                    ],
+                    // 2. import { named } from 'mod';
+                    [
+                        new RegExp(`import\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"),
+                        (_, names) => {
+                            const destructured = names.replace(/([\w$]+)\s+as\s+([\w$]+)/g, "$1: $2");
+                            return `const {${destructured}} = ${global};`;
+                        },
+                    ],
+                    // 3. import * as ns from 'mod';
+                    [
+                        new RegExp(`import\\s+\\*\\s+as\\s+([\\w$]+)\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"),
+                        (_, name) => `const ${name} = ${global};`,
+                    ],
+                    // 4. import Default from 'mod';
+                    [
+                        new RegExp(`import\\s+([\\w$]+)\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"),
+                        (_, def) => `const ${def} = ${global}.default || ${global};`,
+                    ],
+                    // 5. import 'mod';
+                    [new RegExp(`import\\s+['"]${escaped}['"]\\s*;?`, "g"), () => ""],
+                    // 6. export { name } from 'mod';
+                    [
+                        new RegExp(`export\\s*\\{([^}]+)\\}\\s+from\\s+['"]${escaped}['"]\\s*;?`, "g"),
+                        (_, names) => {
+                            const parts = names.split(",").map((n) => n.trim());
+                            const decls = [];
+                            const exportNames = [];
+                            for (const part of parts) {
+                                const asMatch = part.match(/^([\w$]+)\s+as\s+([\w$]+)$/);
+                                if (asMatch) {
+                                    decls.push(`const ${asMatch[2]} = ${global}[${JSON.stringify(asMatch[1])}];`);
+                                    exportNames.push(asMatch[2]);
+                                }
+                                else {
+                                    exportNames.push(part);
+                                }
+                            }
+                            if (decls.length > 0) {
+                                return `${decls.join("\n")}\nconst {${exportNames.join(", ")}} = ${global};\nexport {${exportNames.join(", ")}};`;
+                            }
+                            return `const {${exportNames.join(", ")}} = ${global};\nexport {${exportNames.join(", ")}};`;
+                        },
+                    ],
+                ];
+                // Collect all matches first, then apply in reverse order to preserve offsets
+                const matches = [];
+                for (const [re, replacer] of patterns) {
+                    re.lastIndex = 0;
+                    let match;
+                    while ((match = re.exec(code)) !== null) {
+                        matches.push({
+                            start: match.index,
+                            end: match.index + match[0].length,
+                            replacement: replacer(match[0], ...match.slice(1)),
+                        });
                     }
-                    if (decls.length > 0) {
-                        return `${decls.join("\n")}\nconst {${exportNames.join(", ")}} = ${global};\nexport {${exportNames.join(", ")}};`;
-                    }
-                    return `const {${exportNames.join(", ")}} = ${global};\nexport {${exportNames.join(", ")}};`;
-                });
+                }
+                // Apply in reverse so earlier offsets stay valid
+                matches
+                    .sort((a, b) => b.start - a.start)
+                    .forEach((m) => s.overwrite(m.start, m.end, m.replacement));
             }
-            return result;
+            if (!s.hasChanged())
+                return null;
+            return { code: s.toString(), map: s.generateMap({ hires: true }) };
         },
     };
 }
@@ -205,6 +242,7 @@ function createUIConfig(pluginDir, entry, extraConfig) {
             },
             sourcemap: true,
             minify: isProduction ? "esbuild" : false,
+            assetsInlineLimit: 10 * 1024 * 1024,
         },
         esbuild: {
             jsx: "automatic",
@@ -216,6 +254,7 @@ function createUIConfig(pluginDir, entry, extraConfig) {
             serveExternals(),
             stratosDevServer({ pluginDir }),
             stratosExternals(),
+            cssInject(),
             copyPluginAssets(pluginDir),
             ...(extraConfig?.plugins ?? []),
         ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@skyvexsoftware/stratos-sdk",
-  "version": "0.1.13",
+  "version": "0.1.15",
   "description": "Plugin SDK for Stratos — types, hooks, and UI components",
   "author": {
     "name": "Skyvex Software",
@@ -84,6 +84,7 @@
   },
   "dependencies": {
     "clsx": "^2.1.1",
+    "magic-string": "^0.30.21",
     "tailwind-merge": "^3.2.0"
   },
   "devDependencies": {