@aiot-nexus/plugin-sdk 2.1.1 → 3.1.0

package/dist/.generated/plugin-framework-version.d.ts

@@ -1,4 +1,4 @@
-export declare const PLUGIN_FRAMEWORK_VERSION = "2.1.0";
+export declare const PLUGIN_FRAMEWORK_VERSION = "3.1.0";
 export declare const PLUGIN_MANIFEST_SCHEMA_VERSION = 1;
 export declare const PLUGIN_COMPATIBLE_VERSION_PATTERN = "^(0|[1-9][0-9]*)(\\.(0|[1-9][0-9]*))?(\\.(0|[1-9][0-9]*))?$";
 export interface ParsedPluginVersion {

package/dist/.generated/plugin-framework-version.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPluginFrameworkVersionCompatible = exports.comparePluginVersions = exports.parsePluginCompatibleVersion = exports.PLUGIN_COMPATIBLE_VERSION_PATTERN = exports.PLUGIN_MANIFEST_SCHEMA_VERSION = exports.PLUGIN_FRAMEWORK_VERSION = void 0;
-exports.PLUGIN_FRAMEWORK_VERSION = "2.1.0";
+exports.PLUGIN_FRAMEWORK_VERSION = "3.1.0";
 exports.PLUGIN_MANIFEST_SCHEMA_VERSION = 1;
 exports.PLUGIN_COMPATIBLE_VERSION_PATTERN = "^(0|[1-9][0-9]*)(\\.(0|[1-9][0-9]*))?(\\.(0|[1-9][0-9]*))?$";
 function parsePluginCompatibleVersion(value) {

package/dist/.generated/plugin-manifest.schema.json

@@ -33,7 +33,7 @@
         "permissions": {
             "type": "array",
             "items": {
-                "enum": ["businessLog", "settings", "filesystem", "udp", "serial", "externalProcess", "dialog", "electronHostControl"]
+                "enum": ["businessLog", "settings", "filesystem", "udp", "serial", "externalProcess", "dialog"]
             },
             "uniqueItems": true
         },
@@ -73,7 +73,8 @@
                 "component": { "type": "string", "minLength": 1 },
                 "pageRoute": { "type": "string", "minLength": 1 },
                 "isFullBleed": { "type": "boolean" },
-                "showBusinessLogToggle": { "type": "boolean" }
+                "showBusinessLogToggle": { "type": "boolean" },
+                "showHostStatusBar": { "type": "boolean" }
             }
         },
         "tool": {

package/dist/browser/frame-client.d.ts

@@ -7,6 +7,7 @@ export declare class PluginFrameClientError extends Error {
 export interface PluginFrameClientOptions {
     frameWindow?: Window;
     targetWindow?: Window;
+    initializationTimeoutMs?: number;
     requestTimeoutMs?: number;
     autoResize?: boolean;
     resizeRoot?: HTMLElement;

package/dist/browser/frame-client.mjs

@@ -4,7 +4,7 @@ const readyMessageType = "nexus-plugin:ready";
 const requestMessageType = "nexus-plugin:request";
 const responseMessageType = "nexus-plugin:response";
 const resizeMessageType = "nexus-plugin:resize";
-const defaultRequestTimeoutMs = 20000;
+const defaultInitializationTimeoutMs = 20000;
 export class PluginFrameClientError extends Error {
     constructor(code, message) {
         super(message);
@@ -19,9 +19,13 @@ export function createPluginFrameClient(options = {}) {
     }
     const frameWindow = resolvedFrameWindow;
     const targetWindow = options.targetWindow || frameWindow.parent;
-    const requestTimeoutMs = options.requestTimeoutMs === undefined ? defaultRequestTimeoutMs : options.requestTimeoutMs;
-    if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) {
-        throw new PluginFrameClientError("ProtocolError", "requestTimeoutMs must be a positive finite number.");
+    const initializationTimeoutMs = options.initializationTimeoutMs === undefined ? defaultInitializationTimeoutMs : options.initializationTimeoutMs;
+    const requestTimeoutMs = options.requestTimeoutMs === undefined ? 0 : options.requestTimeoutMs;
+    if (!Number.isFinite(initializationTimeoutMs) || initializationTimeoutMs <= 0) {
+        throw new PluginFrameClientError("ProtocolError", "initializationTimeoutMs must be a positive finite number.");
+    }
+    if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs < 0) {
+        throw new PluginFrameClientError("ProtocolError", "requestTimeoutMs must be zero or a positive finite number.");
     }
     let requestSequence = 0;
     let disposed = false;
@@ -46,7 +50,7 @@ export function createPluginFrameClient(options = {}) {
             contextSettled = true;
             rejectContext(new PluginFrameClientError("RequestTimeout", "PluginFrame initialization timed out."));
         }
-    }, requestTimeoutMs);
+    }, initializationTimeoutMs);
     frameWindow.addEventListener("message", handleMessage);
     if (options.autoResize !== false) {
         frameWindow.addEventListener("resize", scheduleResize);
@@ -80,16 +84,18 @@ export function createPluginFrameClient(options = {}) {
         }
         const requestId = "nexus-sdk-" + Date.now() + "-" + (++requestSequence);
         return new Promise((resolve, reject) => {
-            const timeoutId = frameWindow.setTimeout(() => {
-                pendingRequests.delete(requestId);
-                reject(new PluginFrameClientError("RequestTimeout", "PluginFrame request timed out: " + method));
-            }, requestTimeoutMs);
+            const timeoutId = requestTimeoutMs > 0
+                ? frameWindow.setTimeout(() => {
+                    pendingRequests.delete(requestId);
+                    reject(new PluginFrameClientError("RequestTimeout", "PluginFrame request timed out: " + method));
+                }, requestTimeoutMs)
+                : undefined;
             pendingRequests.set(requestId, {
                 resolve: (result) => resolve(result),
                 reject,
                 timeoutId
             });
-            post({ type: requestMessageType, requestId, method, params });
+            post({ type: requestMessageType, requestId, method, params: encodeFrameValue(params) });
         });
     }
     function getSettings() {
@@ -140,12 +146,14 @@ export function createPluginFrameClient(options = {}) {
             return;
         }
         pendingRequests.delete(event.data.requestId);
-        frameWindow.clearTimeout(pending.timeoutId);
+        if (pending.timeoutId !== undefined) {
+            frameWindow.clearTimeout(pending.timeoutId);
+        }
         if (!isNexusResult(event.data.result)) {
             pending.reject(new PluginFrameClientError("ProtocolError", "PluginFrame response is malformed."));
             return;
         }
-        pending.resolve(event.data.result);
+        pending.resolve(decodeFrameResult(event.data.result));
     }
     function notifyContextChanged(context) {
         for (const listener of Array.from(contextListeners)) {
@@ -202,7 +210,9 @@ export function createPluginFrameClient(options = {}) {
             rejectContext(error);
         }
         for (const pending of pendingRequests.values()) {
-            frameWindow.clearTimeout(pending.timeoutId);
+            if (pending.timeoutId !== undefined) {
+                frameWindow.clearTimeout(pending.timeoutId);
+            }
             pending.reject(error);
         }
         pendingRequests.clear();
@@ -237,3 +247,101 @@ function isNexusResult(value) {
     }
     return isRecord(value.error) && typeof value.error.code === "string" && typeof value.error.message === "string";
 }
+function encodeFrameValue(value, seen = new WeakSet()) {
+    if (value === undefined) {
+        return { __nexusWire: "undefined" };
+    }
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value === "bigint") {
+        return { __nexusWire: "bigint", value: value.toString(10) };
+    }
+    if (value instanceof Date) {
+        return { __nexusWire: "date", value: value.toISOString() };
+    }
+    if (value instanceof Error) {
+        return { __nexusWire: "error", name: value.name, message: value.message, stack: value.stack };
+    }
+    if (value instanceof Uint8Array) {
+        return { __nexusWire: "buffer", value: bytesToHex(value) };
+    }
+    if (typeof value !== "object" || seen.has(value)) {
+        return null;
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item) => encodeFrameValue(item, seen));
+        }
+        const encoded = Object.fromEntries(Object.entries(value).map(([key, item]) => [key, encodeFrameValue(item, seen)]));
+        return Object.prototype.hasOwnProperty.call(value, "__nexusWire")
+            ? { __nexusWire: "object", value: encoded }
+            : encoded;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function decodeFrameResult(result) {
+    return result.ok
+        ? { ok: true, value: decodeFrameValue(result.value) }
+        : { ok: false, error: { ...result.error, details: decodeFrameValue(result.error.details) } };
+}
+function decodeFrameValue(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const record = value;
+    if (record.__nexusWire === "undefined") {
+        return undefined;
+    }
+    if (record.__nexusWire === "bigint" && typeof record.value === "string") {
+        try {
+            return BigInt(record.value);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (record.__nexusWire === "date" && typeof record.value === "string") {
+        const date = new Date(record.value);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    if (record.__nexusWire === "buffer" && typeof record.value === "string") {
+        return hexToUint8Array(record.value);
+    }
+    if (record.__nexusWire === "error" && typeof record.message === "string") {
+        const error = new Error(record.message);
+        if (typeof record.name === "string") {
+            error.name = record.name;
+        }
+        if (typeof record.stack === "string") {
+            error.stack = record.stack;
+        }
+        return error;
+    }
+    if (record.__nexusWire === "object" && isRecord(record.value)) {
+        return decodeFrameValue(record.value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => decodeFrameValue(item));
+    }
+    return Object.fromEntries(Object.entries(record).map(([key, item]) => [key, decodeFrameValue(item)]));
+}
+function bytesToHex(bytes) {
+    return Array.from(bytes).map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function hexToUint8Array(value) {
+    if (value.length % 2 !== 0 || !/^[0-9a-f]*$/i.test(value)) {
+        return null;
+    }
+    const bytes = new Uint8Array(value.length / 2);
+    for (let index = 0; index < bytes.length; index += 1) {
+        bytes[index] = Number.parseInt(value.slice(index * 2, index * 2 + 2), 16);
+    }
+    return bytes;
+}

package/dist/src/browser/frame-client.d.ts

@@ -7,6 +7,7 @@ export declare class PluginFrameClientError extends Error {
 export interface PluginFrameClientOptions {
     frameWindow?: Window;
     targetWindow?: Window;
+    initializationTimeoutMs?: number;
     requestTimeoutMs?: number;
     autoResize?: boolean;
     resizeRoot?: HTMLElement;

package/dist/src/browser/frame-client.js

@@ -7,7 +7,7 @@ const readyMessageType = "nexus-plugin:ready";
 const requestMessageType = "nexus-plugin:request";
 const responseMessageType = "nexus-plugin:response";
 const resizeMessageType = "nexus-plugin:resize";
-const defaultRequestTimeoutMs = 20000;
+const defaultInitializationTimeoutMs = 20000;
 class PluginFrameClientError extends Error {
     constructor(code, message) {
         super(message);
@@ -23,9 +23,13 @@ function createPluginFrameClient(options = {}) {
     }
     const frameWindow = resolvedFrameWindow;
     const targetWindow = options.targetWindow || frameWindow.parent;
-    const requestTimeoutMs = options.requestTimeoutMs === undefined ? defaultRequestTimeoutMs : options.requestTimeoutMs;
-    if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs <= 0) {
-        throw new PluginFrameClientError("ProtocolError", "requestTimeoutMs must be a positive finite number.");
+    const initializationTimeoutMs = options.initializationTimeoutMs === undefined ? defaultInitializationTimeoutMs : options.initializationTimeoutMs;
+    const requestTimeoutMs = options.requestTimeoutMs === undefined ? 0 : options.requestTimeoutMs;
+    if (!Number.isFinite(initializationTimeoutMs) || initializationTimeoutMs <= 0) {
+        throw new PluginFrameClientError("ProtocolError", "initializationTimeoutMs must be a positive finite number.");
+    }
+    if (!Number.isFinite(requestTimeoutMs) || requestTimeoutMs < 0) {
+        throw new PluginFrameClientError("ProtocolError", "requestTimeoutMs must be zero or a positive finite number.");
     }
     let requestSequence = 0;
     let disposed = false;
@@ -50,7 +54,7 @@ function createPluginFrameClient(options = {}) {
             contextSettled = true;
             rejectContext(new PluginFrameClientError("RequestTimeout", "PluginFrame initialization timed out."));
         }
-    }, requestTimeoutMs);
+    }, initializationTimeoutMs);
     frameWindow.addEventListener("message", handleMessage);
     if (options.autoResize !== false) {
         frameWindow.addEventListener("resize", scheduleResize);
@@ -84,16 +88,18 @@ function createPluginFrameClient(options = {}) {
         }
         const requestId = "nexus-sdk-" + Date.now() + "-" + (++requestSequence);
         return new Promise((resolve, reject) => {
-            const timeoutId = frameWindow.setTimeout(() => {
-                pendingRequests.delete(requestId);
-                reject(new PluginFrameClientError("RequestTimeout", "PluginFrame request timed out: " + method));
-            }, requestTimeoutMs);
+            const timeoutId = requestTimeoutMs > 0
+                ? frameWindow.setTimeout(() => {
+                    pendingRequests.delete(requestId);
+                    reject(new PluginFrameClientError("RequestTimeout", "PluginFrame request timed out: " + method));
+                }, requestTimeoutMs)
+                : undefined;
             pendingRequests.set(requestId, {
                 resolve: (result) => resolve(result),
                 reject,
                 timeoutId
             });
-            post({ type: requestMessageType, requestId, method, params });
+            post({ type: requestMessageType, requestId, method, params: encodeFrameValue(params) });
         });
     }
     function getSettings() {
@@ -144,12 +150,14 @@ function createPluginFrameClient(options = {}) {
             return;
         }
         pendingRequests.delete(event.data.requestId);
-        frameWindow.clearTimeout(pending.timeoutId);
+        if (pending.timeoutId !== undefined) {
+            frameWindow.clearTimeout(pending.timeoutId);
+        }
         if (!isNexusResult(event.data.result)) {
             pending.reject(new PluginFrameClientError("ProtocolError", "PluginFrame response is malformed."));
             return;
         }
-        pending.resolve(event.data.result);
+        pending.resolve(decodeFrameResult(event.data.result));
     }
     function notifyContextChanged(context) {
         for (const listener of Array.from(contextListeners)) {
@@ -206,7 +214,9 @@ function createPluginFrameClient(options = {}) {
             rejectContext(error);
         }
         for (const pending of pendingRequests.values()) {
-            frameWindow.clearTimeout(pending.timeoutId);
+            if (pending.timeoutId !== undefined) {
+                frameWindow.clearTimeout(pending.timeoutId);
+            }
             pending.reject(error);
         }
         pendingRequests.clear();
@@ -242,3 +252,101 @@ function isNexusResult(value) {
     }
     return isRecord(value.error) && typeof value.error.code === "string" && typeof value.error.message === "string";
 }
+function encodeFrameValue(value, seen = new WeakSet()) {
+    if (value === undefined) {
+        return { __nexusWire: "undefined" };
+    }
+    if (value === null || typeof value === "string" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "number") {
+        return Number.isFinite(value) ? value : null;
+    }
+    if (typeof value === "bigint") {
+        return { __nexusWire: "bigint", value: value.toString(10) };
+    }
+    if (value instanceof Date) {
+        return { __nexusWire: "date", value: value.toISOString() };
+    }
+    if (value instanceof Error) {
+        return { __nexusWire: "error", name: value.name, message: value.message, stack: value.stack };
+    }
+    if (value instanceof Uint8Array) {
+        return { __nexusWire: "buffer", value: bytesToHex(value) };
+    }
+    if (typeof value !== "object" || seen.has(value)) {
+        return null;
+    }
+    seen.add(value);
+    try {
+        if (Array.isArray(value)) {
+            return value.map((item) => encodeFrameValue(item, seen));
+        }
+        const encoded = Object.fromEntries(Object.entries(value).map(([key, item]) => [key, encodeFrameValue(item, seen)]));
+        return Object.prototype.hasOwnProperty.call(value, "__nexusWire")
+            ? { __nexusWire: "object", value: encoded }
+            : encoded;
+    }
+    finally {
+        seen.delete(value);
+    }
+}
+function decodeFrameResult(result) {
+    return result.ok
+        ? { ok: true, value: decodeFrameValue(result.value) }
+        : { ok: false, error: { ...result.error, details: decodeFrameValue(result.error.details) } };
+}
+function decodeFrameValue(value) {
+    if (value === null || typeof value !== "object") {
+        return value;
+    }
+    const record = value;
+    if (record.__nexusWire === "undefined") {
+        return undefined;
+    }
+    if (record.__nexusWire === "bigint" && typeof record.value === "string") {
+        try {
+            return BigInt(record.value);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (record.__nexusWire === "date" && typeof record.value === "string") {
+        const date = new Date(record.value);
+        return Number.isNaN(date.getTime()) ? null : date;
+    }
+    if (record.__nexusWire === "buffer" && typeof record.value === "string") {
+        return hexToUint8Array(record.value);
+    }
+    if (record.__nexusWire === "error" && typeof record.message === "string") {
+        const error = new Error(record.message);
+        if (typeof record.name === "string") {
+            error.name = record.name;
+        }
+        if (typeof record.stack === "string") {
+            error.stack = record.stack;
+        }
+        return error;
+    }
+    if (record.__nexusWire === "object" && isRecord(record.value)) {
+        return decodeFrameValue(record.value);
+    }
+    if (Array.isArray(value)) {
+        return value.map((item) => decodeFrameValue(item));
+    }
+    return Object.fromEntries(Object.entries(record).map(([key, item]) => [key, decodeFrameValue(item)]));
+}
+function bytesToHex(bytes) {
+    return Array.from(bytes).map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+function hexToUint8Array(value) {
+    if (value.length % 2 !== 0 || !/^[0-9a-f]*$/i.test(value)) {
+        return null;
+    }
+    const bytes = new Uint8Array(value.length / 2);
+    for (let index = 0; index < bytes.length; index += 1) {
+        bytes[index] = Number.parseInt(value.slice(index * 2, index * 2 + 2), 16);
+    }
+    return bytes;
+}

package/dist/src/cli/run.js

@@ -30,7 +30,7 @@ const scaffold_1 = require("../scaffold");
 const dev_1 = require("../dev");
 const web_dev_1 = require("../web-dev");
 const nexus_dev_1 = require("../nexus-dev");
-const nodeEngine = ">=16.20.0 <17";
+const upgrade_1 = require("../upgrade");
 function runCli(args, io) {
     const command = args[0];
     if (command === "--help" || command === "-h") {
@@ -38,14 +38,21 @@ function runCli(args, io) {
         return 0;
     }
     if (command === "info") {
+        if (args.length === 2 && args[1] === "--json") {
+            io.stdout(JSON.stringify((0, index_1.getPluginSdkInfo)(), null, 2));
+            return 0;
+        }
         if (args.length !== 1) {
-            return usageError(io, "info does not accept arguments.");
+            return usageError(io, "info only accepts --json.");
         }
         io.stdout([
             "SDK version: " + index_1.PLUGIN_SDK_VERSION,
             "Plugin Framework API: " + index_1.PLUGIN_FRAMEWORK_VERSION,
             "Manifest schema: " + index_1.PLUGIN_MANIFEST_SCHEMA_VERSION,
-            "Node engine: " + nodeEngine
+            "Node engine: " + index_1.PLUGIN_SDK_NODE_ENGINE,
+            "npm engine: " + index_1.PLUGIN_SDK_NPM_ENGINE,
+            "Electron: " + index_1.PLUGIN_SDK_ELECTRON_VERSION,
+            "TypeScript: " + index_1.PLUGIN_SDK_TYPESCRIPT_VERSION
         ].join("\n"));
         return 0;
     }
@@ -65,6 +72,9 @@ function runCli(args, io) {
     if (command === "create") {
         return runCreate(args.slice(1), io);
     }
+    if (command === "upgrade") {
+        return runUpgrade(args.slice(1), io);
+    }
     if (command === "dev") {
         return runDev(args.slice(1), io);
     }
@@ -80,10 +90,12 @@ exports.runCli = runCli;
 function usage() {
     return [
         "Usage:",
-        "  nexus-plugin info",
+        "  nexus-plugin info [--json]",
         "  nexus-plugin validate <plugin-package-directory>",
         "  nexus-plugin create <plugin-id> [--template minimal|sqlite] [--output <parent-directory>]",
         "    [--display-name <name>] [--sdk-source <version-or-local-tgz>] [--install]",
+        "  nexus-plugin upgrade [plugin-project-directory] [--check] [--sdk-source <version-or-local-tgz>]",
+        "    [--allow-major] [--skip-project-checks] [--json]",
         "  nexus-plugin dev [plugin-project-directory] [--no-build] [--inspect[=<port>] | --inspect-brk[=<port>]]",
         "    [--host-version <X.Y.Z>] [--language <culture>] [--theme system|light|dark] [--surface business|tool|settings]",
         "    [--contribution-id <id>] [--no-devtools]",
@@ -97,6 +109,69 @@ function usage() {
     ].join("\n");
 }
 exports.usage = usage;
+function runUpgrade(args, io) {
+    if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
+        io.stdout(usage());
+        return 0;
+    }
+    let projectDirectory = io.cwd();
+    let index = 0;
+    if (args[0] && !args[0].startsWith("--")) {
+        projectDirectory = path.resolve(io.cwd(), args[0]);
+        index = 1;
+    }
+    let sdkSource;
+    let checkOnly = false;
+    let allowMajor = false;
+    let skipProjectChecks = false;
+    let json = false;
+    const seen = new Set();
+    for (; index < args.length; index += 1) {
+        const option = args[index];
+        if (["--check", "--allow-major", "--skip-project-checks", "--json"].includes(option)) {
+            if (seen.has(option)) {
+                return usageError(io, "Duplicate option: " + option);
+            }
+            seen.add(option);
+            if (option === "--check") {
+                checkOnly = true;
+            }
+            else if (option === "--allow-major") {
+                allowMajor = true;
+            }
+            else if (option === "--skip-project-checks") {
+                skipProjectChecks = true;
+            }
+            else {
+                json = true;
+            }
+            continue;
+        }
+        if (option !== "--sdk-source") {
+            return usageError(io, "Unknown upgrade option: " + option);
+        }
+        if (seen.has(option)) {
+            return usageError(io, "Duplicate option: " + option);
+        }
+        seen.add(option);
+        const value = args[index + 1];
+        if (value === undefined || value.startsWith("--")) {
+            return usageError(io, option + " requires a value.");
+        }
+        sdkSource = value;
+        index += 1;
+    }
+    const result = (0, upgrade_1.runPluginSdkUpgrade)({
+        projectDirectory,
+        workingDirectory: io.cwd(),
+        sdkSource,
+        checkOnly,
+        allowMajor,
+        skipProjectChecks
+    });
+    io.stdout(json ? JSON.stringify(result, null, 2) : (0, upgrade_1.formatPluginSdkUpgradeResult)(result));
+    return result.status === "blocked" || result.status === "rolled-back" ? 1 : 0;
+}
 function runNexusDev(args, io) {
     if (args.length === 1 && (args[0] === "--help" || args[0] === "-h")) {
         io.stdout(usage());
@@ -126,7 +201,7 @@ function runNexusDev(args, io) {
         const inspector = parseInspectorOption(option);
         if (inspector) {
             if (options.inspectorMode) {
-                return usageError(io, "Only one plugin worker inspector option can be used.");
+                return usageError(io, "Only one plugin main-process inspector option can be used.");
             }
             const key = "--" + inspector.mode;
             if (seen.has(key)) {
@@ -304,7 +379,7 @@ function runDev(args, io) {
         const inspector = parseInspectorOption(option);
         if (inspector) {
             if (options.inspectorMode) {
-                return usageError(io, "Only one plugin worker inspector option can be used.");
+                return usageError(io, "Only one plugin main-process inspector option can be used.");
             }
             const key = "--" + inspector.mode;
             if (seen.has(key)) {

package/dist/src/cli/update-notice.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.showSdkUpdateNotice = void 0;
 function showSdkUpdateNotice(args, stdout, updateCheck, currentVersion) {
-    if (args.includes("--help") || args.includes("-h") || updateCheck.isDisabled(process.env)) {
+    if (args.includes("--help") || args.includes("-h") || args.includes("--json") || updateCheck.isDisabled(process.env)) {
         return;
     }
     const cached = updateCheck.readCachedSdkUpdate({ currentVersion });

package/dist/src/dev.js

@@ -52,14 +52,14 @@ function runPluginDev(options, io) {
         + "\nContribution: " + target.surface + ":" + target.contributionId
         + "\nSimulated Nexus application version: " + target.hostVersion);
     if (options.inspectorMode) {
-        io.stdout("Plugin worker debugger: " + options.inspectorMode
+        io.stdout("Plugin main-process debugger: " + options.inspectorMode
             + " on 127.0.0.1:" + String(options.inspectorPort || 9229));
     }
     const electronArgs = [];
-    electronArgs.push(target.devHostMainPath, "--plugin-package=" + target.packageDirectory, "--project-directory=" + target.projectDirectory, "--surface=" + target.surface, "--contribution-id=" + target.contributionId, "--language=" + target.language, "--theme=" + target.themeMode, "--host-version=" + target.hostVersion);
     if (options.inspectorMode) {
-        electronArgs.push("--worker-inspector=" + options.inspectorMode + ":" + String(options.inspectorPort || 9229));
+        electronArgs.push("--" + options.inspectorMode + "=" + String(options.inspectorPort || 9229));
     }
+    electronArgs.push(target.devHostMainPath, "--plugin-package=" + target.packageDirectory, "--project-directory=" + target.projectDirectory, "--surface=" + target.surface, "--contribution-id=" + target.contributionId, "--language=" + target.language, "--theme=" + target.themeMode, "--host-version=" + target.hostVersion);
     if (!options.openDevTools) {
         electronArgs.push("--no-devtools");
     }

package/dist/src/{electron-facade.js → electron-namespaces.js}

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.isPluginElectronProtocolScheme = exports.isPluginElectronIpcChannel = exports.createPluginElectronProtocolScheme = exports.createPluginElectronIpcChannel = void 0;
 const ipcPrefix = "nexus-plugin:";
 const protocolPrefix = "nexus-plugin-";
-const pluginIdPattern = /^[a-z0-9][a-z0-9._-]{0,63}$/;
+const pluginIdPattern = /^[a-z0-9][a-z0-9._-]{1,63}$/;
 const channelPattern = /^[A-Za-z0-9][A-Za-z0-9._:-]{0,119}$/;
 const schemePattern = /^[a-z][a-z0-9+.-]{0,62}$/;
 function createPluginElectronIpcChannel(pluginId, channel) {
@@ -44,8 +44,7 @@ function requirePluginId(value) {
     return normalized;
 }
 function normalizePluginId(value) {
-    const normalized = typeof value === "string" ? value.trim() : "";
-    return pluginIdPattern.test(normalized) ? normalized : undefined;
+    return typeof value === "string" && pluginIdPattern.test(value) ? value : undefined;
 }
 function requireLogicalName(value, pattern, label) {
     const normalized = String(value).trim();

package/dist/src/index.d.ts

@@ -1,8 +1,8 @@
 import pluginManifestSchema from "../.generated/plugin-manifest.schema.json";
-export declare const PLUGIN_SDK_VERSION = "2.1.1";
 export { pluginManifestSchema };
 export * from "../.generated/plugin-framework-version";
+export * from "./sdk-info";
 export * from "./types";
-export * from "./electron-facade";
+export * from "./electron-namespaces";
 export * from "./browser/frame-client";
 export * from "./validation";

package/dist/src/index.js

@@ -17,12 +17,12 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pluginManifestSchema = exports.PLUGIN_SDK_VERSION = void 0;
+exports.pluginManifestSchema = void 0;
 const plugin_manifest_schema_json_1 = __importDefault(require("../.generated/plugin-manifest.schema.json"));
 exports.pluginManifestSchema = plugin_manifest_schema_json_1.default;
-exports.PLUGIN_SDK_VERSION = "2.1.1";
 __exportStar(require("../.generated/plugin-framework-version"), exports);
+__exportStar(require("./sdk-info"), exports);
 __exportStar(require("./types"), exports);
-__exportStar(require("./electron-facade"), exports);
+__exportStar(require("./electron-namespaces"), exports);
 __exportStar(require("./browser/frame-client"), exports);
 __exportStar(require("./validation"), exports);

package/dist/src/nexus-dev-control.d.ts

@@ -1,4 +1,4 @@
-export type NexusDevUpdateType = "rendererUpdated" | "manifestUpdated" | "packageUpdatePreparing" | "packageUpdated";
+export type NexusDevUpdateType = "hostReady" | "rendererUpdated" | "manifestUpdated";
 export interface NexusDevUpdateResult {
     ok: boolean;
     message: string;