@depup/expo__cli 55.0.16-depup.0

package/build/src/start/server/DevServerManager.js

@@ -0,0 +1,259 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DevServerManager", {
+    enumerable: true,
+    get: function() {
+        return DevServerManager;
+    }
+});
+function _config() {
+    const data = require("@expo/config");
+    _config = function() {
+        return data;
+    };
+    return data;
+}
+function _assert() {
+    const data = /*#__PURE__*/ _interop_require_default(require("assert"));
+    _assert = function() {
+        return data;
+    };
+    return data;
+}
+function _chalk() {
+    const data = /*#__PURE__*/ _interop_require_default(require("chalk"));
+    _chalk = function() {
+        return data;
+    };
+    return data;
+}
+const _DevToolsPluginManager = /*#__PURE__*/ _interop_require_default(require("./DevToolsPluginManager"));
+const _platformBundlers = require("./platformBundlers");
+const _log = require("../../log");
+const _FileNotifier = require("../../utils/FileNotifier");
+const _env = require("../../utils/env");
+const _TypeScriptProjectPrerequisite = require("../doctor/typescript/TypeScriptProjectPrerequisite");
+const _commandsTable = require("../interface/commandsTable");
+const _adb = /*#__PURE__*/ _interop_require_wildcard(require("../platforms/android/adb"));
+const _resolveOptions = require("../resolveOptions");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+function _getRequireWildcardCache(nodeInterop) {
+    if (typeof WeakMap !== "function") return null;
+    var cacheBabelInterop = new WeakMap();
+    var cacheNodeInterop = new WeakMap();
+    return (_getRequireWildcardCache = function(nodeInterop) {
+        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
+    })(nodeInterop);
+}
+function _interop_require_wildcard(obj, nodeInterop) {
+    if (!nodeInterop && obj && obj.__esModule) {
+        return obj;
+    }
+    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
+        return {
+            default: obj
+        };
+    }
+    var cache = _getRequireWildcardCache(nodeInterop);
+    if (cache && cache.has(obj)) {
+        return cache.get(obj);
+    }
+    var newObj = {
+        __proto__: null
+    };
+    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
+    for(var key in obj){
+        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
+            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
+            if (desc && (desc.get || desc.set)) {
+                Object.defineProperty(newObj, key, desc);
+            } else {
+                newObj[key] = obj[key];
+            }
+        }
+    }
+    newObj.default = obj;
+    if (cache) {
+        cache.set(obj, newObj);
+    }
+    return newObj;
+}
+const debug = require('debug')('expo:start:server:devServerManager');
+const BUNDLERS = {
+    webpack: ()=>require('./webpack/WebpackBundlerDevServer').WebpackBundlerDevServer,
+    metro: ()=>require('./metro/MetroBundlerDevServer').MetroBundlerDevServer
+};
+class DevServerManager {
+    static async startMetroAsync(projectRoot, startOptions) {
+        const devServerManager = new DevServerManager(projectRoot, startOptions);
+        await devServerManager.startAsync([
+            {
+                type: 'metro',
+                options: startOptions
+            }
+        ]);
+        return devServerManager;
+    }
+    constructor(projectRoot, /** Keep track of the original CLI options for bundlers that are started interactively. */ options){
+        this.projectRoot = projectRoot;
+        this.options = options;
+        this.devServers = [];
+        this.projectPrerequisites = [];
+        this.notifier = null;
+        if (!options.isExporting) {
+            this.notifier = this.watchBabelConfig();
+        }
+        this.devtoolsPluginManager = new _DevToolsPluginManager.default(projectRoot);
+    }
+    watchBabelConfig() {
+        const notifier = new _FileNotifier.FileNotifier(this.projectRoot, [
+            './babel.config.js',
+            './babel.config.json',
+            './.babelrc.json',
+            './.babelrc',
+            './.babelrc.js'
+        ], {
+            additionalWarning: (0, _chalk().default)` You may need to clear the bundler cache with the {bold --clear} flag for your changes to take effect.`
+        });
+        notifier.startObserving();
+        return notifier;
+    }
+    /** Lazily load and assert a project-level prerequisite. */ async ensureProjectPrerequisiteAsync(PrerequisiteClass) {
+        let prerequisite = this.projectPrerequisites.find((prerequisite)=>prerequisite instanceof PrerequisiteClass);
+        if (!prerequisite) {
+            prerequisite = new PrerequisiteClass(this.projectRoot);
+            this.projectPrerequisites.push(prerequisite);
+        }
+        return await prerequisite.assertAsync();
+    }
+    /**
+   * Sends a message over web sockets to all connected devices,
+   * does nothing when the dev server is not running.
+   *
+   * @param method name of the command. In RN projects `reload`, and `devMenu` are available. In Expo Go, `sendDevCommand` is available.
+   * @param params extra event info to send over the socket.
+   */ broadcastMessage(method, params) {
+        this.devServers.forEach((server)=>{
+            server.broadcastMessage(method, params);
+        });
+    }
+    /** Get the port for the dev server (either Webpack or Metro) that is hosting code for React Native runtimes. */ getNativeDevServerPort() {
+        var _server_getInstance;
+        const server = this.devServers.find((server)=>server.isTargetingNative());
+        return (server == null ? void 0 : (_server_getInstance = server.getInstance()) == null ? void 0 : _server_getInstance.location.port) ?? null;
+    }
+    /** Get the first server that targets web. */ getWebDevServer() {
+        const server = this.devServers.find((server)=>server.isTargetingWeb());
+        return server ?? null;
+    }
+    getDefaultDevServer() {
+        // Return the first native dev server otherwise return the first dev server.
+        const server = this.devServers.find((server)=>server.isTargetingNative());
+        const defaultServer = server ?? this.devServers[0];
+        (0, _assert().default)(defaultServer, 'No dev servers are running');
+        return defaultServer;
+    }
+    async ensureWebDevServerRunningAsync() {
+        const [server] = this.devServers.filter((server)=>server.isTargetingWeb());
+        if (server) {
+            return;
+        }
+        const { exp } = (0, _config().getConfig)(this.projectRoot, {
+            skipPlugins: true,
+            skipSDKVersionRequirement: true
+        });
+        const bundler = (0, _platformBundlers.getPlatformBundlers)(this.projectRoot, exp).web;
+        debug(`Starting ${bundler} dev server for web`);
+        return this.startAsync([
+            {
+                type: bundler,
+                options: this.options
+            }
+        ]);
+    }
+    /** Switch between Expo Go and Expo Dev Clients. */ async toggleRuntimeMode(isUsingDevClient = !this.options.devClient) {
+        const nextMode = isUsingDevClient ? '--dev-client' : '--go';
+        _log.Log.log((0, _commandsTable.printItem)(`Switching to ${(0, _chalk().default)`{bold ${nextMode}}`}`, {
+            dim: true
+        }));
+        _log.Log.log();
+        const nextScheme = await (0, _resolveOptions.resolveSchemeAsync)(this.projectRoot, {
+            devClient: isUsingDevClient
+        });
+        this.options.location.scheme = nextScheme;
+        this.options.devClient = isUsingDevClient;
+        for (const devServer of this.devServers){
+            devServer.isDevClient = isUsingDevClient;
+            // TODO(@kitten): Clean up mode switching better
+            const urlCreator = devServer.getUrlCreator();
+            urlCreator.defaults ??= {};
+            urlCreator.defaults.scheme = nextScheme;
+        }
+        debug(`New runtime options (runtime: ${nextMode}):`, this.options);
+        return true;
+    }
+    /** Start all dev servers. */ async startAsync(startOptions) {
+        const { exp } = (0, _config().getConfig)(this.projectRoot, {
+            skipSDKVersionRequirement: true
+        });
+        const platformBundlers = (0, _platformBundlers.getPlatformBundlers)(this.projectRoot, exp);
+        // Start all dev servers...
+        for (const { type, options } of startOptions){
+            const BundlerDevServerClass = await BUNDLERS[type]();
+            const server = new BundlerDevServerClass(this.projectRoot, platformBundlers, {
+                devToolsPluginManager: this.devtoolsPluginManager,
+                isDevClient: !!(options == null ? void 0 : options.devClient)
+            });
+            await server.startAsync(options ?? this.options);
+            this.devServers.push(server);
+        }
+        return exp;
+    }
+    async bootstrapTypeScriptAsync() {
+        const typescriptPrerequisite = await this.ensureProjectPrerequisiteAsync(_TypeScriptProjectPrerequisite.TypeScriptProjectPrerequisite);
+        if (_env.env.EXPO_NO_TYPESCRIPT_SETUP) {
+            return;
+        }
+        // Optionally, wait for the user to add TypeScript during the
+        // development cycle.
+        const server = this.devServers.find((server)=>server.name === 'metro');
+        if (!server) {
+            return;
+        }
+        // The dev server shouldn't wait for the typescript services
+        if (!typescriptPrerequisite) {
+            server.waitForTypeScriptAsync().then(async (success)=>{
+                if (success) {
+                    server.startTypeScriptServices();
+                }
+            });
+        } else {
+            server.startTypeScriptServices();
+        }
+    }
+    async watchEnvironmentVariables() {
+        var _this_devServers_find;
+        await ((_this_devServers_find = this.devServers.find((server)=>server.name === 'metro')) == null ? void 0 : _this_devServers_find.watchEnvironmentVariables());
+    }
+    /** Stop all servers including ADB. */ async stopAsync() {
+        var _this_notifier;
+        await Promise.allSettled([
+            (_this_notifier = this.notifier) == null ? void 0 : _this_notifier.stopObserving(),
+            // Stop ADB
+            _adb.getServer().stopAsync(),
+            // Stop all dev servers
+            ...this.devServers.map((server)=>server.stopAsync().catch((error)=>{
+                    _log.Log.error(`Failed to stop dev server (bundler: ${server.name})`);
+                    _log.Log.exception(error);
+                }))
+        ]);
+    }
+}
+
+//# sourceMappingURL=DevServerManager.js.map

package/build/src/start/server/DevServerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/start/server/DevServerManager.ts"],"sourcesContent":["import { ExpoConfig, getConfig } from '@expo/config';\nimport assert from 'assert';\nimport chalk from 'chalk';\n\nimport { BundlerDevServer, BundlerStartOptions } from './BundlerDevServer';\nimport DevToolsPluginManager from './DevToolsPluginManager';\nimport { getPlatformBundlers } from './platformBundlers';\nimport { Log } from '../../log';\nimport { FileNotifier } from '../../utils/FileNotifier';\nimport { env } from '../../utils/env';\nimport { ProjectPrerequisite } from '../doctor/Prerequisite';\nimport { TypeScriptProjectPrerequisite } from '../doctor/typescript/TypeScriptProjectPrerequisite';\nimport { printItem } from '../interface/commandsTable';\nimport * as AndroidDebugBridge from '../platforms/android/adb';\nimport { resolveSchemeAsync } from '../resolveOptions';\n\nconst debug = require('debug')('expo:start:server:devServerManager') as typeof console.log;\n\nexport type MultiBundlerStartOptions = {\n  type: keyof typeof BUNDLERS;\n  options?: BundlerStartOptions;\n}[];\n\nconst BUNDLERS = {\n  webpack: () =>\n    require('./webpack/WebpackBundlerDevServer')\n      .WebpackBundlerDevServer as typeof import('./webpack/WebpackBundlerDevServer').WebpackBundlerDevServer,\n  metro: () =>\n    require('./metro/MetroBundlerDevServer')\n      .MetroBundlerDevServer as typeof import('./metro/MetroBundlerDevServer').MetroBundlerDevServer,\n};\n\n/** Manages interacting with multiple dev servers. */\nexport class DevServerManager {\n  private devServers: BundlerDevServer[] = [];\n\n  static async startMetroAsync(projectRoot: string, startOptions: BundlerStartOptions) {\n    const devServerManager = new DevServerManager(projectRoot, startOptions);\n\n    await devServerManager.startAsync([\n      {\n        type: 'metro',\n        options: startOptions,\n      },\n    ]);\n    return devServerManager;\n  }\n\n  private projectPrerequisites: ProjectPrerequisite<any, void>[] = [];\n  public readonly devtoolsPluginManager: DevToolsPluginManager;\n\n  private notifier: FileNotifier | null = null;\n\n  constructor(\n    public projectRoot: string,\n    /** Keep track of the original CLI options for bundlers that are started interactively. */\n    public options: BundlerStartOptions\n  ) {\n    if (!options.isExporting) {\n      this.notifier = this.watchBabelConfig();\n    }\n    this.devtoolsPluginManager = new DevToolsPluginManager(projectRoot);\n  }\n\n  private watchBabelConfig() {\n    const notifier = new FileNotifier(\n      this.projectRoot,\n      [\n        './babel.config.js',\n        './babel.config.json',\n        './.babelrc.json',\n        './.babelrc',\n        './.babelrc.js',\n      ],\n      {\n        additionalWarning: chalk` You may need to clear the bundler cache with the {bold --clear} flag for your changes to take effect.`,\n      }\n    );\n\n    notifier.startObserving();\n\n    return notifier;\n  }\n\n  /** Lazily load and assert a project-level prerequisite. */\n  async ensureProjectPrerequisiteAsync(PrerequisiteClass: typeof ProjectPrerequisite<any, any>) {\n    let prerequisite = this.projectPrerequisites.find(\n      (prerequisite) => prerequisite instanceof PrerequisiteClass\n    );\n    if (!prerequisite) {\n      prerequisite = new PrerequisiteClass(this.projectRoot);\n      this.projectPrerequisites.push(prerequisite);\n    }\n    return await prerequisite.assertAsync();\n  }\n\n  /**\n   * Sends a message over web sockets to all connected devices,\n   * does nothing when the dev server is not running.\n   *\n   * @param method name of the command. In RN projects `reload`, and `devMenu` are available. In Expo Go, `sendDevCommand` is available.\n   * @param params extra event info to send over the socket.\n   */\n  broadcastMessage(method: 'reload' | 'devMenu' | 'sendDevCommand', params?: Record<string, any>) {\n    this.devServers.forEach((server) => {\n      server.broadcastMessage(method, params);\n    });\n  }\n\n  /** Get the port for the dev server (either Webpack or Metro) that is hosting code for React Native runtimes. */\n  getNativeDevServerPort() {\n    const server = this.devServers.find((server) => server.isTargetingNative());\n    return server?.getInstance()?.location.port ?? null;\n  }\n\n  /** Get the first server that targets web. */\n  getWebDevServer() {\n    const server = this.devServers.find((server) => server.isTargetingWeb());\n    return server ?? null;\n  }\n\n  getDefaultDevServer(): BundlerDevServer {\n    // Return the first native dev server otherwise return the first dev server.\n    const server = this.devServers.find((server) => server.isTargetingNative());\n    const defaultServer = server ?? this.devServers[0];\n    assert(defaultServer, 'No dev servers are running');\n    return defaultServer;\n  }\n\n  async ensureWebDevServerRunningAsync() {\n    const [server] = this.devServers.filter((server) => server.isTargetingWeb());\n    if (server) {\n      return;\n    }\n    const { exp } = getConfig(this.projectRoot, {\n      skipPlugins: true,\n      skipSDKVersionRequirement: true,\n    });\n    const bundler = getPlatformBundlers(this.projectRoot, exp).web;\n    debug(`Starting ${bundler} dev server for web`);\n    return this.startAsync([\n      {\n        type: bundler,\n        options: this.options,\n      },\n    ]);\n  }\n\n  /** Switch between Expo Go and Expo Dev Clients. */\n  async toggleRuntimeMode(isUsingDevClient: boolean = !this.options.devClient): Promise<boolean> {\n    const nextMode = isUsingDevClient ? '--dev-client' : '--go';\n    Log.log(printItem(`Switching to ${chalk`{bold ${nextMode}}`}`, { dim: true }));\n    Log.log();\n\n    const nextScheme = await resolveSchemeAsync(this.projectRoot, {\n      devClient: isUsingDevClient,\n      // NOTE: The custom `--scheme` argument is lost from this point on.\n    });\n\n    this.options.location.scheme = nextScheme;\n    this.options.devClient = isUsingDevClient;\n    for (const devServer of this.devServers) {\n      devServer.isDevClient = isUsingDevClient;\n      // TODO(@kitten): Clean up mode switching better\n      const urlCreator = devServer.getUrlCreator();\n      urlCreator.defaults ??= {};\n      urlCreator.defaults.scheme = nextScheme;\n    }\n\n    debug(`New runtime options (runtime: ${nextMode}):`, this.options);\n    return true;\n  }\n\n  /** Start all dev servers. */\n  async startAsync(startOptions: MultiBundlerStartOptions): Promise<ExpoConfig> {\n    const { exp } = getConfig(this.projectRoot, { skipSDKVersionRequirement: true });\n    const platformBundlers = getPlatformBundlers(this.projectRoot, exp);\n\n    // Start all dev servers...\n    for (const { type, options } of startOptions) {\n      const BundlerDevServerClass = await BUNDLERS[type]();\n      const server = new BundlerDevServerClass(this.projectRoot, platformBundlers, {\n        devToolsPluginManager: this.devtoolsPluginManager,\n        isDevClient: !!options?.devClient,\n      });\n      await server.startAsync(options ?? this.options);\n      this.devServers.push(server);\n    }\n\n    return exp;\n  }\n\n  async bootstrapTypeScriptAsync() {\n    const typescriptPrerequisite = await this.ensureProjectPrerequisiteAsync(\n      TypeScriptProjectPrerequisite\n    );\n\n    if (env.EXPO_NO_TYPESCRIPT_SETUP) {\n      return;\n    }\n\n    // Optionally, wait for the user to add TypeScript during the\n    // development cycle.\n    const server = this.devServers.find((server) => server.name === 'metro');\n    if (!server) {\n      return;\n    }\n\n    // The dev server shouldn't wait for the typescript services\n    if (!typescriptPrerequisite) {\n      server.waitForTypeScriptAsync().then(async (success) => {\n        if (success) {\n          server.startTypeScriptServices();\n        }\n      });\n    } else {\n      server.startTypeScriptServices();\n    }\n  }\n\n  async watchEnvironmentVariables() {\n    await this.devServers.find((server) => server.name === 'metro')?.watchEnvironmentVariables();\n  }\n\n  /** Stop all servers including ADB. */\n  async stopAsync(): Promise<void> {\n    await Promise.allSettled([\n      this.notifier?.stopObserving(),\n      // Stop ADB\n      AndroidDebugBridge.getServer().stopAsync(),\n      // Stop all dev servers\n      ...this.devServers.map((server) =>\n        server.stopAsync().catch((error) => {\n          Log.error(`Failed to stop dev server (bundler: ${server.name})`);\n          Log.exception(error);\n        })\n      ),\n    ]);\n  }\n}\n"],"names":["DevServerManager","debug","require","BUNDLERS","webpack","WebpackBundlerDevServer","metro","MetroBundlerDevServer","startMetroAsync","projectRoot","startOptions","devServerManager","startAsync","type","options","constructor","devServers","projectPrerequisites","notifier","isExporting","watchBabelConfig","devtoolsPluginManager","DevToolsPluginManager","FileNotifier","additionalWarning","chalk","startObserving","ensureProjectPrerequisiteAsync","PrerequisiteClass","prerequisite","find","push","assertAsync","broadcastMessage","method","params","forEach","server","getNativeDevServerPort","isTargetingNative","getInstance","location","port","getWebDevServer","isTargetingWeb","getDefaultDevServer","defaultServer","assert","ensureWebDevServerRunningAsync","filter","exp","getConfig","skipPlugins","skipSDKVersionRequirement","bundler","getPlatformBundlers","web","toggleRuntimeMode","isUsingDevClient","devClient","nextMode","Log","log","printItem","dim","nextScheme","resolveSchemeAsync","scheme","devServer","isDevClient","urlCreator","getUrlCreator","defaults","platformBundlers","BundlerDevServerClass","devToolsPluginManager","bootstrapTypeScriptAsync","typescriptPrerequisite","TypeScriptProjectPrerequisite","env","EXPO_NO_TYPESCRIPT_SETUP","name","waitForTypeScriptAsync","then","success","startTypeScriptServices","watchEnvironmentVariables","stopAsync","Promise","allSettled","stopObserving","AndroidDebugBridge","getServer","map","catch","error","exception"],"mappings":"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"}

package/build/src/start/server/DevToolsPlugin.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DevToolsPlugin", {
+    enumerable: true,
+    get: function() {
+        return DevToolsPlugin;
+    }
+});
+const _DevToolsPluginschema = require("./DevToolsPlugin.schema");
+const _DevToolsPluginCliExtensionExecutor = require("./DevToolsPluginCliExtensionExecutor");
+const _DevToolsPluginManager = require("./DevToolsPluginManager");
+class DevToolsPlugin {
+    constructor(plugin, projectRoot){
+        this.plugin = plugin;
+        this.projectRoot = projectRoot;
+        this._executor = undefined;
+        // Validate configuration schema
+        const result = _DevToolsPluginschema.PluginSchema.safeParse(plugin);
+        if (!result.success) {
+            throw new Error(`Invalid plugin configuration: ${result.error.message}`, {
+                cause: result.error
+            });
+        }
+    }
+    get packageName() {
+        return this.plugin.packageName;
+    }
+    get packageRoot() {
+        return this.plugin.packageRoot;
+    }
+    get webpageEndpoint() {
+        var _this_plugin, _this_plugin1;
+        return ((_this_plugin = this.plugin) == null ? void 0 : _this_plugin.webpageRoot) ? `${_DevToolsPluginManager.DevToolsPluginEndpoint}/${(_this_plugin1 = this.plugin) == null ? void 0 : _this_plugin1.packageName}` : undefined;
+    }
+    get webpageRoot() {
+        var _this_plugin;
+        return (_this_plugin = this.plugin) == null ? void 0 : _this_plugin.webpageRoot;
+    }
+    get description() {
+        var _this_plugin_cliExtensions;
+        return ((_this_plugin_cliExtensions = this.plugin.cliExtensions) == null ? void 0 : _this_plugin_cliExtensions.description) ?? '';
+    }
+    get cliExtensions() {
+        return this.plugin.cliExtensions;
+    }
+    get executor() {
+        var _this_plugin_cliExtensions;
+        if (!((_this_plugin_cliExtensions = this.plugin.cliExtensions) == null ? void 0 : _this_plugin_cliExtensions.entryPoint)) {
+            return undefined;
+        }
+        if (!this._executor) {
+            this._executor = new _DevToolsPluginCliExtensionExecutor.DevToolsPluginCliExtensionExecutor(this.plugin, this.projectRoot);
+        }
+        return this._executor;
+    }
+}
+
+//# sourceMappingURL=DevToolsPlugin.js.map

package/build/src/start/server/DevToolsPlugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/start/server/DevToolsPlugin.ts"],"sourcesContent":["import { DevToolsPluginInfo, PluginSchema } from './DevToolsPlugin.schema';\nimport { DevToolsPluginCliExtensionExecutor } from './DevToolsPluginCliExtensionExecutor';\nimport { DevToolsPluginEndpoint } from './DevToolsPluginManager';\nimport { Log } from '../../log';\n\n/**\n * Class that represents a DevTools plugin with CLI and/or web extensions\n *\n * Responsibilities:\n * - Validates plugin configuration against schema\n * - Provides access to plugin metadata (name, description\n * , endpoints)\n * - Manages CLI command execution via DevToolsPluginExecutor\n * - Lazily initializes executor when needed\n * - Constructs web endpoint URLs based on server configuration\n */\nexport class DevToolsPlugin {\n  constructor(\n    private plugin: DevToolsPluginInfo,\n    public readonly projectRoot: string\n  ) {\n    // Validate configuration schema\n    const result = PluginSchema.safeParse(plugin);\n    if (!result.success) {\n      throw new Error(`Invalid plugin configuration: ${result.error.message}`, {\n        cause: result.error,\n      });\n    }\n  }\n\n  private _executor: DevToolsPluginCliExtensionExecutor | undefined = undefined;\n\n  get packageName(): string {\n    return this.plugin.packageName;\n  }\n\n  get packageRoot(): string {\n    return this.plugin.packageRoot;\n  }\n\n  get webpageEndpoint(): string | undefined {\n    return this.plugin?.webpageRoot\n      ? `${DevToolsPluginEndpoint}/${this.plugin?.packageName}`\n      : undefined;\n  }\n\n  get webpageRoot(): string | undefined {\n    return this.plugin?.webpageRoot;\n  }\n\n  get description(): string {\n    return this.plugin.cliExtensions?.description ?? '';\n  }\n\n  get cliExtensions(): DevToolsPluginInfo['cliExtensions'] {\n    return this.plugin.cliExtensions;\n  }\n\n  get executor(): DevToolsPluginCliExtensionExecutor | undefined {\n    if (!this.plugin.cliExtensions?.entryPoint) {\n      return undefined;\n    }\n\n    if (!this._executor) {\n      this._executor = new DevToolsPluginCliExtensionExecutor(this.plugin, this.projectRoot);\n    }\n\n    return this._executor;\n  }\n}\n"],"names":["DevToolsPlugin","constructor","plugin","projectRoot","_executor","undefined","result","PluginSchema","safeParse","success","Error","error","message","cause","packageName","packageRoot","webpageEndpoint","webpageRoot","DevToolsPluginEndpoint","description","cliExtensions","executor","entryPoint","DevToolsPluginCliExtensionExecutor"],"mappings":";;;;+BAgBaA;;;eAAAA;;;sCAhBoC;oDACE;uCACZ;AAchC,MAAMA;IACXC,YACE,AAAQC,MAA0B,EAClC,AAAgBC,WAAmB,CACnC;aAFQD,SAAAA;aACQC,cAAAA;aAWVC,YAA4DC;QATlE,gCAAgC;QAChC,MAAMC,SAASC,kCAAY,CAACC,SAAS,CAACN;QACtC,IAAI,CAACI,OAAOG,OAAO,EAAE;YACnB,MAAM,IAAIC,MAAM,CAAC,8BAA8B,EAAEJ,OAAOK,KAAK,CAACC,OAAO,EAAE,EAAE;gBACvEC,OAAOP,OAAOK,KAAK;YACrB;QACF;IACF;IAIA,IAAIG,cAAsB;QACxB,OAAO,IAAI,CAACZ,MAAM,CAACY,WAAW;IAChC;IAEA,IAAIC,cAAsB;QACxB,OAAO,IAAI,CAACb,MAAM,CAACa,WAAW;IAChC;IAEA,IAAIC,kBAAsC;YACjC,cAC0B;QADjC,OAAO,EAAA,eAAA,IAAI,CAACd,MAAM,qBAAX,aAAae,WAAW,IAC3B,GAAGC,6CAAsB,CAAC,CAAC,GAAE,gBAAA,IAAI,CAAChB,MAAM,qBAAX,cAAaY,WAAW,EAAE,GACvDT;IACN;IAEA,IAAIY,cAAkC;YAC7B;QAAP,QAAO,eAAA,IAAI,CAACf,MAAM,qBAAX,aAAae,WAAW;IACjC;IAEA,IAAIE,cAAsB;YACjB;QAAP,OAAO,EAAA,6BAAA,IAAI,CAACjB,MAAM,CAACkB,aAAa,qBAAzB,2BAA2BD,WAAW,KAAI;IACnD;IAEA,IAAIC,gBAAqD;QACvD,OAAO,IAAI,CAAClB,MAAM,CAACkB,aAAa;IAClC;IAEA,IAAIC,WAA2D;YACxD;QAAL,IAAI,GAAC,6BAAA,IAAI,CAACnB,MAAM,CAACkB,aAAa,qBAAzB,2BAA2BE,UAAU,GAAE;YAC1C,OAAOjB;QACT;QAEA,IAAI,CAAC,IAAI,CAACD,SAAS,EAAE;YACnB,IAAI,CAACA,SAAS,GAAG,IAAImB,sEAAkC,CAAC,IAAI,CAACrB,MAAM,EAAE,IAAI,CAACC,WAAW;QACvF;QAEA,OAAO,IAAI,CAACC,SAAS;IACvB;AACF"}

package/build/src/start/server/DevToolsPlugin.schema.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: all[name]
+    });
+}
+_export(exports, {
+    DevToolsPluginOutputSchema: function() {
+        return DevToolsPluginOutputSchema;
+    },
+    PluginSchema: function() {
+        return PluginSchema;
+    }
+});
+function _zod() {
+    const data = require("zod");
+    _zod = function() {
+        return data;
+    };
+    return data;
+}
+const CommandParameterSchema = _zod().z.object({
+    name: _zod().z.string().min(1),
+    type: _zod().z.enum([
+        'text',
+        'number',
+        'confirm'
+    ]),
+    description: _zod().z.string().optional()
+});
+const CommandSchema = _zod().z.object({
+    name: _zod().z.string().min(1),
+    title: _zod().z.string().min(1),
+    environments: _zod().z.array(_zod().z.enum([
+        'cli',
+        'mcp'
+    ])).readonly(),
+    parameters: _zod().z.array(CommandParameterSchema).optional()
+});
+const CliExtensionsSchema = _zod().z.object({
+    description: _zod().z.string(),
+    commands: _zod().z.array(CommandSchema).min(1),
+    entryPoint: _zod().z.string().min(1)
+});
+const PluginSchema = _zod().z.object({
+    packageName: _zod().z.string().min(1),
+    packageRoot: _zod().z.string().min(1),
+    webpageRoot: _zod().z.string().optional(),
+    cliExtensions: CliExtensionsSchema.optional()
+});
+const DevToolsPluginOutputLinesSchema = _zod().z.union([
+    _zod().z.object({
+        type: _zod().z.literal('text'),
+        text: _zod().z.string(),
+        url: _zod().z.string().optional(),
+        level: _zod().z.enum([
+            'info',
+            'warning',
+            'error'
+        ])
+    }),
+    _zod().z.object({
+        type: _zod().z.literal('audio'),
+        url: _zod().z.string().url(),
+        text: _zod().z.string().optional()
+    }),
+    _zod().z.object({
+        type: _zod().z.literal('image'),
+        url: _zod().z.string().url(),
+        text: _zod().z.string().optional()
+    })
+]);
+const DevToolsPluginOutputSchema = _zod().z.array(DevToolsPluginOutputLinesSchema);
+
+//# sourceMappingURL=DevToolsPlugin.schema.js.map

package/build/src/start/server/DevToolsPlugin.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/start/server/DevToolsPlugin.schema.ts"],"sourcesContent":["import { z } from 'zod';\n\nconst CommandParameterSchema = z.object({\n  name: z.string().min(1),\n  type: z.enum(['text', 'number', 'confirm']),\n  description: z.string().optional(),\n});\n\nexport type DevToolsPluginCommandParameter = z.infer<typeof CommandParameterSchema>;\n\nconst CommandSchema = z.object({\n  name: z.string().min(1),\n  title: z.string().min(1),\n  environments: z.array(z.enum(['cli', 'mcp'])).readonly(),\n  parameters: z.array(CommandParameterSchema).optional(),\n});\n\nexport type DevToolsPluginCommand = z.infer<typeof CommandSchema>;\n\nexport type DevToolsPluginExecutorArguments = {\n  command: string;\n  metroServerOrigin: string;\n  args?: Record<string, string | number | boolean> | undefined;\n  onOutput?: (output: DevToolsPluginOutput) => void;\n};\n\nconst CliExtensionsSchema = z.object({\n  description: z.string(),\n  commands: z.array(CommandSchema).min(1),\n  entryPoint: z.string().min(1),\n});\n\nexport type DevToolsPluginCliExtensions = z.infer<typeof CliExtensionsSchema>;\n\nexport const PluginSchema = z.object({\n  packageName: z.string().min(1),\n  packageRoot: z.string().min(1),\n  webpageRoot: z.string().optional(),\n  cliExtensions: CliExtensionsSchema.optional(),\n});\n\nexport type DevToolsPluginInfo = z.infer<typeof PluginSchema>;\n\nconst DevToolsPluginOutputLinesSchema = z.union([\n  z.object({\n    type: z.literal('text'),\n    text: z.string(),\n    url: z.string().optional(),\n    level: z.enum(['info', 'warning', 'error']),\n  }),\n  z.object({\n    type: z.literal('audio'),\n    url: z.string().url(),\n    text: z.string().optional(),\n  }),\n  z.object({\n    type: z.literal('image'),\n    url: z.string().url(),\n    text: z.string().optional(),\n  }),\n]);\n\nexport const DevToolsPluginOutputSchema = z.array(DevToolsPluginOutputLinesSchema);\n\nexport type DevToolsPluginOutput = z.infer<typeof DevToolsPluginOutputSchema>;\n"],"names":["DevToolsPluginOutputSchema","PluginSchema","CommandParameterSchema","z","object","name","string","min","type","enum","description","optional","CommandSchema","title","environments","array","readonly","parameters","CliExtensionsSchema","commands","entryPoint","packageName","packageRoot","webpageRoot","cliExtensions","DevToolsPluginOutputLinesSchema","union","literal","text","url","level"],"mappings":";;;;;;;;;;;IA8DaA,0BAA0B;eAA1BA;;IA5BAC,YAAY;eAAZA;;;;yBAlCK;;;;;;AAElB,MAAMC,yBAAyBC,QAAC,CAACC,MAAM,CAAC;IACtCC,MAAMF,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;IACrBC,MAAML,QAAC,CAACM,IAAI,CAAC;QAAC;QAAQ;QAAU;KAAU;IAC1CC,aAAaP,QAAC,CAACG,MAAM,GAAGK,QAAQ;AAClC;AAIA,MAAMC,gBAAgBT,QAAC,CAACC,MAAM,CAAC;IAC7BC,MAAMF,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;IACrBM,OAAOV,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;IACtBO,cAAcX,QAAC,CAACY,KAAK,CAACZ,QAAC,CAACM,IAAI,CAAC;QAAC;QAAO;KAAM,GAAGO,QAAQ;IACtDC,YAAYd,QAAC,CAACY,KAAK,CAACb,wBAAwBS,QAAQ;AACtD;AAWA,MAAMO,sBAAsBf,QAAC,CAACC,MAAM,CAAC;IACnCM,aAAaP,QAAC,CAACG,MAAM;IACrBa,UAAUhB,QAAC,CAACY,KAAK,CAACH,eAAeL,GAAG,CAAC;IACrCa,YAAYjB,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;AAC7B;AAIO,MAAMN,eAAeE,QAAC,CAACC,MAAM,CAAC;IACnCiB,aAAalB,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;IAC5Be,aAAanB,QAAC,CAACG,MAAM,GAAGC,GAAG,CAAC;IAC5BgB,aAAapB,QAAC,CAACG,MAAM,GAAGK,QAAQ;IAChCa,eAAeN,oBAAoBP,QAAQ;AAC7C;AAIA,MAAMc,kCAAkCtB,QAAC,CAACuB,KAAK,CAAC;IAC9CvB,QAAC,CAACC,MAAM,CAAC;QACPI,MAAML,QAAC,CAACwB,OAAO,CAAC;QAChBC,MAAMzB,QAAC,CAACG,MAAM;QACduB,KAAK1B,QAAC,CAACG,MAAM,GAAGK,QAAQ;QACxBmB,OAAO3B,QAAC,CAACM,IAAI,CAAC;YAAC;YAAQ;YAAW;SAAQ;IAC5C;IACAN,QAAC,CAACC,MAAM,CAAC;QACPI,MAAML,QAAC,CAACwB,OAAO,CAAC;QAChBE,KAAK1B,QAAC,CAACG,MAAM,GAAGuB,GAAG;QACnBD,MAAMzB,QAAC,CAACG,MAAM,GAAGK,QAAQ;IAC3B;IACAR,QAAC,CAACC,MAAM,CAAC;QACPI,MAAML,QAAC,CAACwB,OAAO,CAAC;QAChBE,KAAK1B,QAAC,CAACG,MAAM,GAAGuB,GAAG;QACnBD,MAAMzB,QAAC,CAACG,MAAM,GAAGK,QAAQ;IAC3B;CACD;AAEM,MAAMX,6BAA6BG,QAAC,CAACY,KAAK,CAACU"}

package/build/src/start/server/DevToolsPluginCliExtensionExecutor.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DevToolsPluginCliExtensionExecutor", {
+    enumerable: true,
+    get: function() {
+        return DevToolsPluginCliExtensionExecutor;
+    }
+});
+function _child_process() {
+    const data = require("child_process");
+    _child_process = function() {
+        return data;
+    };
+    return data;
+}
+function _path() {
+    const data = /*#__PURE__*/ _interop_require_default(require("path"));
+    _path = function() {
+        return data;
+    };
+    return data;
+}
+const _DevToolsPluginCliExtensionResults = require("./DevToolsPluginCliExtensionResults");
+function _interop_require_default(obj) {
+    return obj && obj.__esModule ? obj : {
+        default: obj
+    };
+}
+const DEFAULT_TIMEOUT_MS = 10000; // 10 seconds
+class DevToolsPluginCliExtensionExecutor {
+    constructor(plugin, projectRoot, spawnFunc = _child_process().spawn, timeoutMs = DEFAULT_TIMEOUT_MS // Timeout for command execution
+    ){
+        var _this_plugin_cliExtensions;
+        this.plugin = plugin;
+        this.projectRoot = projectRoot;
+        this.spawnFunc = spawnFunc;
+        this.timeoutMs = timeoutMs;
+        this.getCommandString = ({ command, args })=>{
+            return `node ${this.plugin.cliExtensions.entryPoint} ${command}${Object.keys(args ?? {}).length > 0 ? ' ' + JSON.stringify(args) : ''}`;
+        };
+        this.execute = async ({ command, args, metroServerOrigin, onOutput })=>{
+            this.validate({
+                command,
+                args
+            });
+            return new Promise(async (resolve)=>{
+                // Set up the command and its arguments
+                const tool = _path().default.join(this.plugin.packageRoot, this.plugin.cliExtensions.entryPoint);
+                const child = this.spawnFunc('node', [
+                    tool,
+                    command,
+                    `${JSON.stringify(args)}`,
+                    `${metroServerOrigin}`
+                ], {
+                    cwd: this.projectRoot,
+                    env: {
+                        ...process.env
+                    }
+                });
+                let finished = false;
+                const pluginResults = new _DevToolsPluginCliExtensionResults.DevToolsPluginCliExtensionResults(onOutput);
+                // Collect output/error data
+                child.stdout.on('data', (data)=>pluginResults.append(data.toString()));
+                child.stderr.on('data', (data)=>pluginResults.append(data.toString(), 'error'));
+                // Setup timeout
+                const timeout = setTimeout(()=>{
+                    if (!finished) {
+                        finished = true;
+                        child.kill('SIGKILL');
+                        pluginResults.append('Command timed out', 'error');
+                        resolve(pluginResults.getOutput());
+                    }
+                }, this.timeoutMs);
+                child.on('close', (code)=>{
+                    if (finished) return;
+                    clearTimeout(timeout);
+                    finished = true;
+                    pluginResults.exit(code);
+                    resolve(pluginResults.getOutput());
+                });
+                child.on('error', (err)=>{
+                    if (finished) return;
+                    clearTimeout(timeout);
+                    finished = true;
+                    pluginResults.append(err.toString(), 'error');
+                    resolve(pluginResults.getOutput());
+                });
+            });
+        };
+        // Validate that this is a plugin with cli extensions
+        if (!((_this_plugin_cliExtensions = this.plugin.cliExtensions) == null ? void 0 : _this_plugin_cliExtensions.entryPoint)) {
+            throw new Error(`Plugin ${this.plugin.packageName} has no CLI extensions`);
+        }
+    }
+    validate({ command, args }) {
+        var _this_plugin_cliExtensions, _commandElement_parameters;
+        const commandElement = (_this_plugin_cliExtensions = this.plugin.cliExtensions) == null ? void 0 : _this_plugin_cliExtensions.commands.find((c)=>c.name === command);
+        if (!commandElement) {
+            throw new Error(`Command "${command}" not found in plugin ${this.plugin.packageName}`);
+        }
+        const paramLength = ((_commandElement_parameters = commandElement.parameters) == null ? void 0 : _commandElement_parameters.length) ?? 0;
+        const argsLength = Object.keys(args ?? {}).length;
+        if (paramLength !== argsLength) {
+            // Quick check to see if the lengths match
+            throw new Error(`Expected ${paramLength} parameter(s), but got ${argsLength} argument(s) for the command "${command}".`);
+        }
+        const argsKeys = Object.keys(args ?? {});
+        for (const param of commandElement.parameters ?? []){
+            const found = argsKeys.find((key)=>key === param.name);
+            if (!found) {
+                throw new Error(`Parameter "${param.name}" not found in command "${command}" of plugin ${this.plugin.packageName}`);
+            }
+        }
+    }
+}
+
+//# sourceMappingURL=DevToolsPluginCliExtensionExecutor.js.map

package/build/src/start/server/DevToolsPluginCliExtensionExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/start/server/DevToolsPluginCliExtensionExecutor.ts"],"sourcesContent":["import { spawn } from 'child_process';\nimport path from 'path';\n\nimport {\n  DevToolsPluginExecutorArguments,\n  DevToolsPluginInfo,\n  DevToolsPluginOutput,\n} from './DevToolsPlugin.schema';\nimport { DevToolsPluginCliExtensionResults } from './DevToolsPluginCliExtensionResults';\n\nconst DEFAULT_TIMEOUT_MS = 10_000; // 10 seconds\n\n/**\n * Class that executes CLI Extension commands for a given plugin\n *\n * ## Responsibilities:\n * - Verifies that requested commands exist and have correct parameters\n * - Validates that provided arguments match expected parameter schema\n * - Spawns and manages child processes for command execution\n *  - Captures and streams stdout/stderr data from executed commands\n *  - Manages process errors, timeouts, and unexpected failures\n *  - Enforces execution time limits to prevent hanging processes\n *  - Configures proper execution environment with color support\n *  - Ensures proper cleanup of processes and timeouts\n *  - Provides structured output with exit codes and error states\n */\nexport class DevToolsPluginCliExtensionExecutor {\n  constructor(\n    private plugin: DevToolsPluginInfo,\n    private projectRoot: string,\n    private spawnFunc: typeof spawn = spawn, // Used for injection when testing,\n    private timeoutMs = DEFAULT_TIMEOUT_MS // Timeout for command execution\n  ) {\n    // Validate that this is a plugin with cli extensions\n    if (!this.plugin.cliExtensions?.entryPoint) {\n      throw new Error(`Plugin ${this.plugin.packageName} has no CLI extensions`);\n    }\n  }\n\n  public validate({ command, args }: Omit<DevToolsPluginExecutorArguments, 'metroServerOrigin'>) {\n    const commandElement = this.plugin.cliExtensions?.commands.find((c) => c.name === command);\n    if (!commandElement) {\n      throw new Error(`Command \"${command}\" not found in plugin ${this.plugin.packageName}`);\n    }\n\n    const paramLength = commandElement.parameters?.length ?? 0;\n    const argsLength = Object.keys(args ?? {}).length;\n    if (paramLength !== argsLength) {\n      // Quick check to see if the lengths match\n      throw new Error(\n        `Expected ${paramLength} parameter(s), but got ${argsLength} argument(s) for the command \"${command}\".`\n      );\n    }\n\n    const argsKeys = Object.keys(args ?? {});\n    for (const param of commandElement.parameters ?? []) {\n      const found = argsKeys.find((key) => key === param.name);\n      if (!found) {\n        throw new Error(\n          `Parameter \"${param.name}\" not found in command \"${command}\" of plugin ${this.plugin.packageName}`\n        );\n      }\n    }\n  }\n\n  /** this function is used for testing and showing the command in UI */\n  public getCommandString = ({\n    command,\n    args,\n  }: Omit<DevToolsPluginExecutorArguments, 'metroServerOrigin'>) => {\n    return `node ${this.plugin.cliExtensions!.entryPoint} ${command}${Object.keys(args ?? {}).length > 0 ? ' ' + JSON.stringify(args) : ''}`;\n  };\n\n  public execute = async ({\n    command,\n    args,\n    metroServerOrigin,\n    onOutput,\n  }: DevToolsPluginExecutorArguments): Promise<DevToolsPluginOutput> => {\n    this.validate({ command, args });\n    return new Promise<DevToolsPluginOutput>(async (resolve) => {\n      // Set up the command and its arguments\n      const tool = path.join(this.plugin.packageRoot, this.plugin.cliExtensions!.entryPoint);\n      const child = this.spawnFunc(\n        'node',\n        [tool, command, `${JSON.stringify(args)}`, `${metroServerOrigin}`],\n        {\n          cwd: this.projectRoot,\n          env: { ...process.env },\n        }\n      );\n\n      let finished = false;\n      const pluginResults = new DevToolsPluginCliExtensionResults(onOutput);\n\n      // Collect output/error data\n      child.stdout.on('data', (data) => pluginResults.append(data.toString()));\n      child.stderr.on('data', (data) => pluginResults.append(data.toString(), 'error'));\n\n      // Setup timeout\n      const timeout = setTimeout(() => {\n        if (!finished) {\n          finished = true;\n          child.kill('SIGKILL');\n          pluginResults.append('Command timed out', 'error');\n          resolve(pluginResults.getOutput());\n        }\n      }, this.timeoutMs);\n\n      child.on('close', (code: number) => {\n        if (finished) return;\n        clearTimeout(timeout);\n        finished = true;\n        pluginResults.exit(code);\n        resolve(pluginResults.getOutput());\n      });\n\n      child.on('error', (err: Error) => {\n        if (finished) return;\n        clearTimeout(timeout);\n        finished = true;\n        pluginResults.append(err.toString(), 'error');\n        resolve(pluginResults.getOutput());\n      });\n    });\n  };\n}\n"],"names":["DevToolsPluginCliExtensionExecutor","DEFAULT_TIMEOUT_MS","constructor","plugin","projectRoot","spawnFunc","spawn","timeoutMs","getCommandString","command","args","cliExtensions","entryPoint","Object","keys","length","JSON","stringify","execute","metroServerOrigin","onOutput","validate","Promise","resolve","tool","path","join","packageRoot","child","cwd","env","process","finished","pluginResults","DevToolsPluginCliExtensionResults","stdout","on","data","append","toString","stderr","timeout","setTimeout","kill","getOutput","code","clearTimeout","exit","err","Error","packageName","commandElement","commands","find","c","name","paramLength","parameters","argsLength","argsKeys","param","found","key"],"mappings":"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"}

package/build/src/start/server/DevToolsPluginCliExtensionResults.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+Object.defineProperty(exports, "DevToolsPluginCliExtensionResults", {
+    enumerable: true,
+    get: function() {
+        return DevToolsPluginCliExtensionResults;
+    }
+});
+const _DevToolsPluginschema = require("./DevToolsPlugin.schema");
+class DevToolsPluginCliExtensionResults {
+    constructor(onOutput){
+        this.onOutput = onOutput;
+        this._output = [];
+    }
+    append(output, level = 'info') {
+        const results = this.parseOutputText(output, level);
+        this._output.push(...results);
+        this.onOutput == null ? void 0 : this.onOutput.call(this, results);
+    }
+    exit(code) {
+        if (code === 0) return;
+        this.append(`Process exited with code ${code}`, 'error');
+    }
+    getOutput() {
+        return this._output;
+    }
+    parseOutputText(txt, level = 'info') {
+        // Validate against schema
+        try {
+            const result = _DevToolsPluginschema.DevToolsPluginOutputSchema.safeParse(JSON.parse(txt));
+            if (!result.success) {
+                return [
+                    {
+                        type: 'text',
+                        text: `Invalid JSON: ${result.error.issues.map((issue)=>issue.message).join(', ')}`,
+                        level: 'error'
+                    }
+                ];
+            }
+            return result.data;
+        } catch  {
+            // Not JSON, treat as plain text
+            const lines = txt.split('\n');
+            const results = [];
+            for (const line of lines){
+                if (line) {
+                    results.push({
+                        type: 'text',
+                        text: line,
+                        level
+                    });
+                }
+            }
+            return results;
+        }
+    }
+}
+
+//# sourceMappingURL=DevToolsPluginCliExtensionResults.js.map