@kwirthmagnify/kwirth-plugin-provider-debug 0.1.0

package/back.js

@@ -0,0 +1,272 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __commonJS = (cb, mod) => function __require() {
+  return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+};
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// kwirth-back-globals:@kwirthmagnify/kwirth-common-back
+var require_kwirth_common_back = __commonJS({
+  "kwirth-back-globals:@kwirthmagnify/kwirth-common-back"(exports2, module2) {
+    module2.exports = global.__kwirth_back__.kwirthCommonBack;
+  }
+});
+
+// src/back/index.ts
+var index_exports = {};
+__export(index_exports, {
+  default: () => index_default
+});
+module.exports = __toCommonJS(index_exports);
+var import_kwirth_common_back = __toESM(require_kwirth_common_back(), 1);
+var ProviderDebugChannel = class {
+  constructor(clusterInfo, backChannelObject) {
+    this.channelId = "provider-debug";
+    /**
+     * Deliberadamente vacío: el core solo instancia y arranca los providers que algún canal
+     * declara aquí, así que este canal se limita a depurar los que ya están en marcha por
+     * cuenta de otros plugins. Declarar providers concretos los arrancaría como efecto
+     * colateral de tener instalado un depurador, que es justo lo que no queremos.
+     */
+    this.requirements = { storage: false, providers: [] };
+    this.webSockets = [];
+    this.getChannelData = () => ({
+      id: "provider-debug",
+      routable: false,
+      pauseable: true,
+      modifiable: false,
+      // F1: para cambiar de provider se para y se rearranca la instancia
+      reconnectable: true,
+      metrics: false,
+      sources: [import_kwirth_common_back.EClusterType.KUBERNETES, import_kwirth_common_back.EClusterType.DOCKER],
+      endpoints: [],
+      websocket: false,
+      cluster: true,
+      // los providers son cluster-wide, no cuelgan de un pod
+      resourced: false
+    });
+    this.getChannelScopeLevel = (scope) => ["", "none", "cluster"].indexOf(scope);
+    this.startChannel = async () => {
+    };
+    // ---- registro: los canales cluster llegan aquí vía addObject('*all') ----
+    this.addObject = async (webSocket, instanceConfig, _ns, _pod, _container) => {
+      let socket = this.webSockets.find((s) => s.ws === webSocket);
+      if (!socket) {
+        const len = this.webSockets.push({ ws: webSocket, lastRefresh: Date.now(), instances: [] });
+        socket = this.webSockets[len - 1];
+      }
+      if (socket.instances.find((i) => i.instanceId === instanceConfig.instance)) return true;
+      const configData = instanceConfig.data ?? { providerId: "", subscriptionData: "" };
+      const instance = {
+        instanceId: instanceConfig.instance,
+        accessKey: (0, import_kwirth_common_back.accessKeyDeserialize)(instanceConfig.accessKey),
+        providerId: configData.providerId ?? "",
+        paused: false
+      };
+      socket.instances.push(instance);
+      this.sendProviders(socket, instance);
+      if (instance.providerId) this.subscribe(socket, instance, configData.subscriptionData);
+      return true;
+    };
+    this.deleteObject = async (webSocket, instanceConfig, _ns, _pod, _container) => {
+      this.removeInstance(webSocket, instanceConfig.instance);
+      return true;
+    };
+    this.pauseContinueInstance = (webSocket, instanceConfig, action) => {
+      const instance = this.getInstance(webSocket, instanceConfig.instance);
+      if (!instance) {
+        this.sendSignalMessage(webSocket, action, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.ERROR, instanceConfig.instance, "Provider debug instance not found");
+        return;
+      }
+      if (action === import_kwirth_common_back.EInstanceMessageAction.PAUSE) instance.paused = true;
+      if (action === import_kwirth_common_back.EInstanceMessageAction.CONTINUE) instance.paused = false;
+    };
+    this.modifyInstance = (_webSocket, _instanceConfig) => {
+    };
+    this.containsInstance = (instanceId) => this.webSockets.some((socket) => socket.instances.some((i) => i.instanceId === instanceId));
+    this.containsAsset = (_webSocket, _podNamespace, _podName, _containerName) => false;
+    this.stopInstance = (webSocket, instanceConfig) => {
+      const instance = this.getInstance(webSocket, instanceConfig.instance);
+      if (instance) {
+        this.removeInstance(webSocket, instanceConfig.instance);
+        this.sendSignalMessage(webSocket, import_kwirth_common_back.EInstanceMessageAction.STOP, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.INFO, instanceConfig.instance, "Provider debug instance stopped");
+      } else {
+        this.sendSignalMessage(webSocket, import_kwirth_common_back.EInstanceMessageAction.STOP, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.ERROR, instanceConfig.instance, "Provider debug instance not found");
+      }
+    };
+    this.removeInstance = (webSocket, instanceId) => {
+      const socket = this.webSockets.find((s) => s.ws === webSocket);
+      if (!socket) return;
+      const pos = socket.instances.findIndex((i) => i.instanceId === instanceId);
+      if (pos < 0) return;
+      this.unsubscribe(socket.instances[pos]);
+      socket.instances.splice(pos, 1);
+    };
+    this.processCommand = async (webSocket, instanceMessage) => {
+      if (instanceMessage.flow === import_kwirth_common_back.EInstanceMessageFlow.IMMEDIATE) return false;
+      const instance = this.getInstance(webSocket, instanceMessage.instance);
+      if (!instance) {
+        this.sendSignalMessage(webSocket, instanceMessage.action, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.ERROR, instanceMessage.instance, "Provider debug instance not found");
+        return false;
+      }
+      return true;
+    };
+    this.containsConnection = (webSocket) => Boolean(this.webSockets.find((s) => s.ws === webSocket));
+    this.removeConnection = (webSocket) => {
+      const pos = this.webSockets.findIndex((s) => s.ws === webSocket);
+      if (pos < 0) return;
+      for (const instance of this.webSockets[pos].instances) this.unsubscribe(instance);
+      this.webSockets.splice(pos, 1);
+    };
+    this.refreshConnection = (webSocket) => {
+      const socket = this.webSockets.find((s) => s.ws === webSocket);
+      if (socket) {
+        socket.lastRefresh = Date.now();
+        return true;
+      }
+      return false;
+    };
+    this.updateConnection = (newWebSocket, instanceId) => {
+      for (const entry of this.webSockets) {
+        if (entry.instances.find((i) => i.instanceId === instanceId)) {
+          entry.ws = newWebSocket;
+          return true;
+        }
+      }
+      return false;
+    };
+    // ---- suscripción a un provider en marcha ---------------------------------
+    this.subscribe = (socket, instance, rawSubscriptionData) => {
+      const provider = this.clusterInfo.providers?.find((p) => p.id === instance.providerId);
+      if (!provider) {
+        this.sendSignalMessage(socket.ws, import_kwirth_common_back.EInstanceMessageAction.START, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.ERROR, instance.instanceId, `Provider '${instance.providerId}' is not running`);
+        return;
+      }
+      let subscriptionData = {};
+      if (rawSubscriptionData && rawSubscriptionData.trim() !== "") {
+        try {
+          subscriptionData = JSON.parse(rawSubscriptionData);
+        } catch (err) {
+          this.sendSignalMessage(socket.ws, import_kwirth_common_back.EInstanceMessageAction.START, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.ERROR, instance.instanceId, `Subscription payload is not valid JSON: ${String(err)}`);
+          return;
+        }
+      }
+      const subscriber = {
+        processProviderEvent: (providerId, obj) => this.deliver(socket, instance, providerId, obj)
+      };
+      instance.subscriber = subscriber;
+      instance.provider = provider;
+      provider.addSubscriber(subscriber, subscriptionData);
+      this.backChannelObject.logInfo?.(`Provider debug instance ${instance.instanceId} subscribed to provider '${instance.providerId}'`);
+      this.sendSignalMessage(socket.ws, import_kwirth_common_back.EInstanceMessageAction.START, import_kwirth_common_back.EInstanceMessageFlow.RESPONSE, import_kwirth_common_back.ESignalMessageLevel.INFO, instance.instanceId, `Subscribed to provider '${instance.providerId}'`);
+    };
+    this.unsubscribe = (instance) => {
+      if (instance.provider && instance.subscriber) {
+        instance.provider.removeSubscriber(instance.subscriber);
+        this.backChannelObject.logInfo?.(`Provider debug instance ${instance.instanceId} unsubscribed from provider '${instance.providerId}'`);
+      }
+      instance.provider = void 0;
+      instance.subscriber = void 0;
+    };
+    this.deliver = (socket, instance, providerId, obj) => {
+      if (instance.paused) return;
+      const msg = {
+        msgtype: "providerdebugmessageresponse",
+        channel: this.channelId,
+        action: import_kwirth_common_back.EInstanceMessageAction.NONE,
+        flow: import_kwirth_common_back.EInstanceMessageFlow.UNSOLICITED,
+        type: import_kwirth_common_back.EInstanceMessageType.DATA,
+        instance: instance.instanceId,
+        payloadType: "event" /* EVENT */,
+        event: { ts: Date.now(), providerId, event: obj }
+      };
+      socket.ws.send(JSON.stringify(msg));
+    };
+    /**
+     * getSubscriptionHelp() es opcional en IProvider y lo implementa quien quiere, así que se llama
+     * a la defensiva: ni existir es un error, ni lo es que reviente. Un provider mal escrito no
+     * puede tumbar el catálogo del resto.
+     */
+    this.helpOf = (provider) => {
+      if (typeof provider.getSubscriptionHelp !== "function") return void 0;
+      try {
+        const help = provider.getSubscriptionHelp();
+        if (!help || typeof help.usage !== "string" || typeof help.example !== "object") return void 0;
+        return help;
+      } catch (err) {
+        this.backChannelObject.logWarning?.(`Provider '${provider.id}' failed to report its subscription help: ${String(err)}`);
+        return void 0;
+      }
+    };
+    this.sendProviders = (socket, instance) => {
+      const running = this.clusterInfo.providers ?? [];
+      const providers = running.map((p) => {
+        const help = this.helpOf(p);
+        return {
+          id: p.id,
+          providesRouter: p.providesRouter,
+          ...p.routerAlias ? { routerAlias: p.routerAlias } : {},
+          ...help ? { help } : {}
+        };
+      });
+      const msg = {
+        msgtype: "providerdebugmessageresponse",
+        channel: this.channelId,
+        action: import_kwirth_common_back.EInstanceMessageAction.NONE,
+        flow: import_kwirth_common_back.EInstanceMessageFlow.UNSOLICITED,
+        type: import_kwirth_common_back.EInstanceMessageType.DATA,
+        instance: instance.instanceId,
+        payloadType: "providers" /* PROVIDERS */,
+        providers
+      };
+      socket.ws.send(JSON.stringify(msg));
+    };
+    this.sendSignalMessage = (ws, action, flow, level, instanceId, text) => {
+      const resp = { action, flow, channel: this.channelId, instance: instanceId, type: import_kwirth_common_back.EInstanceMessageType.SIGNAL, text, level };
+      ws.send(JSON.stringify(resp));
+    };
+    this.clusterInfo = clusterInfo;
+    this.backChannelObject = backChannelObject;
+  }
+  /**
+   * Nunca se invoca: el canal no se registra a sí mismo como subscriber, cada instancia
+   * registra su propio proxy (ver IInstance.subscriber).
+   */
+  processProviderEvent(_providerId, _obj) {
+  }
+  endpointRequest(_endpoint, _req, _res, _accessKey) {
+  }
+  websocketRequest(_newWebSocket, _instanceId, _instanceConfig) {
+  }
+  getInstance(webSocket, instanceId) {
+    const socket = this.webSockets.find((entry) => entry.ws === webSocket);
+    if (socket) return socket.instances.find((i) => i.instanceId === instanceId);
+    return void 0;
+  }
+};
+var index_default = ProviderDebugChannel;

package/front.js

@@ -0,0 +1,428 @@
+"use strict";
+(() => {
+  var __create = Object.create;
+  var __defProp = Object.defineProperty;
+  var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+  var __getOwnPropNames = Object.getOwnPropertyNames;
+  var __getProtoOf = Object.getPrototypeOf;
+  var __hasOwnProp = Object.prototype.hasOwnProperty;
+  var __commonJS = (cb, mod) => function __require() {
+    return mod || (0, cb[__getOwnPropNames(cb)[0]])((mod = { exports: {} }).exports, mod), mod.exports;
+  };
+  var __copyProps = (to, from, except, desc) => {
+    if (from && typeof from === "object" || typeof from === "function") {
+      for (let key of __getOwnPropNames(from))
+        if (!__hasOwnProp.call(to, key) && key !== except)
+          __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+    }
+    return to;
+  };
+  var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+    // If the importer is in node compatibility mode or this is not an ESM
+    // file that has been converted to a CommonJS file using a Babel-
+    // compatible transform (i.e. "__esModule" has not been set), then set
+    // "default" to the CommonJS "module.exports" for node compatibility.
+    isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+    mod
+  ));
+
+  // kwirth-globals:@kwirthmagnify/kwirth-common
+  var require_kwirth_common = __commonJS({
+    "kwirth-globals:@kwirthmagnify/kwirth-common"(exports, module) {
+      var _m = window.__kwirth__.kwirthCommon;
+      var _d = _m != null && "default" in Object(_m) ? _m.default : _m;
+      if (typeof _d !== "function" && _d != null && typeof _d.default !== "undefined") _d = _d.default;
+      module.exports = Object.assign({}, typeof _m === "object" && _m !== null ? _m : {}, { default: _d, __esModule: true });
+    }
+  });
+
+  // kwirth-globals:@kwirthmagnify/kwirth-common-front
+  var require_kwirth_common_front = __commonJS({
+    "kwirth-globals:@kwirthmagnify/kwirth-common-front"(exports, module) {
+      var _m = window.__kwirth__.kwirthCommonFront;
+      var _d = _m != null && "default" in Object(_m) ? _m.default : _m;
+      if (typeof _d !== "function" && _d != null && typeof _d.default !== "undefined") _d = _d.default;
+      module.exports = Object.assign({}, typeof _m === "object" && _m !== null ? _m : {}, { default: _d, __esModule: true });
+    }
+  });
+
+  // kwirth-globals:react
+  var require_react = __commonJS({
+    "kwirth-globals:react"(exports, module) {
+      var _m = window.__kwirth__.React;
+      var _d = _m != null && "default" in Object(_m) ? _m.default : _m;
+      if (typeof _d !== "function" && _d != null && typeof _d.default !== "undefined") _d = _d.default;
+      module.exports = Object.assign({}, typeof _m === "object" && _m !== null ? _m : {}, { default: _d, __esModule: true });
+    }
+  });
+
+  // kwirth-globals:@mui/material
+  var require_material = __commonJS({
+    "kwirth-globals:@mui/material"(exports, module) {
+      var _m = window.__kwirth__.MUI.material;
+      var _d = _m != null && "default" in Object(_m) ? _m.default : _m;
+      if (typeof _d !== "function" && _d != null && typeof _d.default !== "undefined") _d = _d.default;
+      module.exports = Object.assign({}, typeof _m === "object" && _m !== null ? _m : {}, { default: _d, __esModule: true });
+    }
+  });
+
+  // kwirth-globals:@mui/icons-material
+  var require_icons_material = __commonJS({
+    "kwirth-globals:@mui/icons-material"(exports, module) {
+      var _m = window.__kwirth__.MUI.icons;
+      var _d = _m != null && "default" in Object(_m) ? _m.default : _m;
+      if (typeof _d !== "function" && _d != null && typeof _d.default !== "undefined") _d = _d.default;
+      module.exports = Object.assign({}, typeof _m === "object" && _m !== null ? _m : {}, { default: _d, __esModule: true });
+    }
+  });
+
+  // src/front/ProviderDebugChannel.ts
+  var import_kwirth_common = __toESM(require_kwirth_common(), 1);
+  var import_kwirth_common_front = __toESM(require_kwirth_common_front(), 1);
+
+  // src/front/ProviderDebugConfig.ts
+  var ProviderDebugConfig = class {
+    constructor() {
+      this.maxEvents = 200;
+    }
+  };
+  var ProviderDebugInstanceConfig = class {
+    constructor() {
+      this.providerId = "";
+      this.subscriptionData = "";
+    }
+  };
+
+  // src/front/ProviderDebugData.ts
+  var ProviderDebugData = class {
+    constructor() {
+      this.events = [];
+      this.providers = [];
+      this.signals = [];
+      this.paused = false;
+      this.started = false;
+    }
+  };
+
+  // src/front/ProviderDebugSetup.tsx
+  var import_react = __toESM(require_react(), 1);
+  var import_material = __toESM(require_material(), 1);
+  var import_icons_material = __toESM(require_icons_material(), 1);
+  var ProviderDebugIcon = /* @__PURE__ */ import_react.default.createElement(import_icons_material.DataObjectOutlined, null);
+  var ProviderDebugSetup = (props) => {
+    const instanceConfig = props.setupConfig?.channelInstanceConfig || new ProviderDebugInstanceConfig();
+    const config = props.setupConfig?.channelConfig || new ProviderDebugConfig();
+    const data = props.channelObject.data;
+    const [providerId, setProviderId] = (0, import_react.useState)(instanceConfig.providerId);
+    const [subscriptionData, setSubscriptionData] = (0, import_react.useState)(instanceConfig.subscriptionData);
+    const [maxEvents, setMaxEvents] = (0, import_react.useState)(config.maxEvents);
+    const [catalogue, setCatalogue] = (0, import_react.useState)([]);
+    const [catalogueLoaded, setCatalogueLoaded] = (0, import_react.useState)(false);
+    const [mode, setMode] = (0, import_react.useState)("form" /* FORM */);
+    const defaultRef = (0, import_react.useRef)(null);
+    (0, import_react.useEffect)(() => {
+      const url = props.channelObject.clusterUrl;
+      if (!url) return;
+      const token = props.channelObject.accessString;
+      fetch(`${url}/core/providers`, token ? { headers: { Authorization: `Bearer ${token}` } } : void 0).then((r) => r.json()).then((list) => {
+        setCatalogue(Array.isArray(list) ? list.filter((p) => p && p.id) : []);
+        setCatalogueLoaded(true);
+      }).catch(() => {
+      });
+    }, []);
+    const options = () => {
+      const source = catalogueLoaded ? catalogue.map((e) => ({
+        id: e.id,
+        state: e.running ? "running" /* RUNNING */ : "notRunning" /* NOT_RUNNING */,
+        help: e.subscriptionHelp
+      })) : (data?.providers ?? []).map((p) => ({ id: p.id, state: "unknown" /* UNKNOWN */, help: p.help }));
+      if (providerId && !source.some((o) => o.id === providerId)) source.push({ id: providerId, state: "unknown" /* UNKNOWN */ });
+      return source.sort((a, b) => a.id.localeCompare(b.id));
+    };
+    const help = options().find((o) => o.id === providerId)?.help;
+    const fields = help?.fields ?? [];
+    const invalidJson = () => {
+      if (!subscriptionData || subscriptionData.trim() === "") return false;
+      try {
+        JSON.parse(subscriptionData);
+        return false;
+      } catch {
+        return true;
+      }
+    };
+    const payload = () => {
+      if (!subscriptionData || subscriptionData.trim() === "") return {};
+      try {
+        const parsed = JSON.parse(subscriptionData);
+        return parsed && typeof parsed === "object" && !Array.isArray(parsed) ? parsed : {};
+      } catch {
+        return {};
+      }
+    };
+    const setField = (name, value) => {
+      const obj = payload();
+      if (value === void 0 || value === "" || Array.isArray(value) && value.length === 0) delete obj[name];
+      else obj[name] = value;
+      setSubscriptionData(Object.keys(obj).length === 0 ? "" : JSON.stringify(obj, null, 2));
+    };
+    const useExample = () => {
+      if (help) setSubscriptionData(JSON.stringify(help.example, null, 2));
+    };
+    const renderField = (field) => {
+      const current = payload()[field.name];
+      const label = field.required ? `${field.name} *` : field.name;
+      switch (field.type) {
+        case "boolean":
+          return /* @__PURE__ */ import_react.default.createElement(
+            import_material.FormControlLabel,
+            {
+              key: field.name,
+              control: /* @__PURE__ */ import_react.default.createElement(import_material.Checkbox, { checked: current === true, onChange: (e) => setField(field.name, e.target.checked ? true : void 0) }),
+              label: /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "column" }, /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "body2" }, label), /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary" }, field.description))
+            }
+          );
+        case "number":
+          return /* @__PURE__ */ import_react.default.createElement(import_material.TextField, { key: field.name, value: current ?? "", onChange: (e) => setField(field.name, e.target.value === "" ? void 0 : Number(e.target.value)), type: "number", variant: "standard", label, helperText: field.description, fullWidth: true });
+        case "string[]":
+          return /* @__PURE__ */ import_react.default.createElement(import_material.TextField, { key: field.name, value: Array.isArray(current) ? current.join(", ") : "", onChange: (e) => setField(field.name, e.target.value.split(",").map((s) => s.trim()).filter(Boolean)), variant: "standard", label, helperText: `${field.description} \u2014 comma separated`, fullWidth: true });
+        default:
+          return /* @__PURE__ */ import_react.default.createElement(import_material.TextField, { key: field.name, value: typeof current === "string" ? current : "", onChange: (e) => setField(field.name, e.target.value), variant: "standard", label, helperText: field.description, fullWidth: true });
+      }
+    };
+    const renderHelp = () => {
+      if (!providerId) return /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary" }, "Pick a provider to see how to subscribe to it.");
+      if (!help) {
+        return /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary" }, `'${providerId}' does not publish subscription help (getSubscriptionHelp is optional). Check its README for the payload it expects.`);
+      }
+      return /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary", sx: { whiteSpace: "pre-wrap" } }, help.usage);
+    };
+    const ok = () => {
+      config.maxEvents = maxEvents;
+      instanceConfig.providerId = providerId;
+      instanceConfig.subscriptionData = subscriptionData;
+      props.onChannelSetupClosed(props.channel, {
+        channelId: props.channel.channelId,
+        channelConfig: config,
+        channelInstanceConfig: instanceConfig
+      }, true, defaultRef.current?.checked || false);
+    };
+    const cancel = () => {
+      props.onChannelSetupClosed(props.channel, {
+        channelId: props.channel.channelId,
+        channelConfig: void 0,
+        channelInstanceConfig: void 0
+      }, false, false);
+    };
+    return /* @__PURE__ */ import_react.default.createElement(import_material.Dialog, { open: true, maxWidth: false, sx: { "& .MuiDialog-paper": { width: "46vw", maxWidth: "46vw", height: "76vh", maxHeight: "76vh" } } }, /* @__PURE__ */ import_react.default.createElement(import_material.DialogTitle, null, "Configure Provider Debug channel"), /* @__PURE__ */ import_react.default.createElement(import_material.DialogContent, null, /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "column", spacing: 2, sx: { m: 1 } }, /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "column", spacing: 0.5 }, /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary" }, "Provider"), /* @__PURE__ */ import_react.default.createElement(import_material.Select, { value: providerId, onChange: (e) => setProviderId(e.target.value), displayEmpty: true, size: "small", variant: "standard", inputProps: { "aria-label": "Provider" } }, /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { value: "" }, /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "body2", color: "text.secondary" }, "(none \u2014 just list the running providers)")), options().map((o) => /* @__PURE__ */ import_react.default.createElement(import_material.MenuItem, { key: o.id, value: o.id }, /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "row", spacing: 1, alignItems: "center" }, /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "body2" }, o.id), o.state === "notRunning" /* NOT_RUNNING */ && /* @__PURE__ */ import_react.default.createElement(import_material.Chip, { label: "not running", size: "small", variant: "outlined", color: "warning", sx: { fontSize: "0.65rem", height: 18 } }))))), /* @__PURE__ */ import_react.default.createElement(import_material.Typography, { variant: "caption", color: "text.secondary" }, catalogueLoaded ? "A provider only runs when some channel requires it. Only the ones marked as running can be subscribed to." : "Could not read the provider catalogue from the core \u2014 showing only what this channel already knows.")), /* @__PURE__ */ import_react.default.createElement(import_material.Box, { sx: { borderLeft: 3, borderColor: "divider", pl: 1.5 } }, renderHelp()), /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "column", spacing: 1 }, /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "row", alignItems: "center", justifyContent: "space-between" }, /* @__PURE__ */ import_react.default.createElement(import_material.Tabs, { value: fields.length > 0 ? mode : "json" /* JSON */, onChange: (_e, v) => setMode(v), sx: { minHeight: 32, "& .MuiTab-root": { minHeight: 32, py: 0 } } }, /* @__PURE__ */ import_react.default.createElement(import_material.Tooltip, { title: fields.length > 0 ? "" : "This provider does not describe its payload field by field" }, /* @__PURE__ */ import_react.default.createElement("span", null, /* @__PURE__ */ import_react.default.createElement(import_material.Tab, { label: "Form", value: "form" /* FORM */, disabled: fields.length === 0 }))), /* @__PURE__ */ import_react.default.createElement(import_material.Tab, { label: "JSON", value: "json" /* JSON */ })), /* @__PURE__ */ import_react.default.createElement(import_material.Button, { size: "small", onClick: useExample, disabled: !help }, "USE EXAMPLE")), fields.length > 0 && mode === "form" /* FORM */ ? /* @__PURE__ */ import_react.default.createElement(import_material.Stack, { direction: "column", spacing: 1.5 }, fields.map((f) => renderField(f))) : /* @__PURE__ */ import_react.default.createElement(import_material.TextField, { value: subscriptionData, onChange: (e) => setSubscriptionData(e.target.value), variant: "standard", label: "Subscription payload (JSON)", placeholder: "{}", multiline: true, minRows: 4, maxRows: 4, error: invalidJson(), helperText: invalidJson() ? "Not valid JSON" : "Empty means {} \u2014 note most providers deliver nothing without a payload", fullWidth: true })), /* @__PURE__ */ import_react.default.createElement(import_material.TextField, { value: maxEvents, onChange: (e) => setMaxEvents(+e.target.value), type: "number", variant: "standard", label: "Max events", fullWidth: true }))), /* @__PURE__ */ import_react.default.createElement(import_material.DialogActions, null, /* @__PURE__ */ import_react.default.createElement(import_material.FormControlLabel, { control: /* @__PURE__ */ import_react.default.createElement(import_material.Checkbox, { slotProps: { input: { ref: defaultRef } } }), label: "Set as default", sx: { width: "100%", ml: "8px" } }), /* @__PURE__ */ import_react.default.createElement(import_material.Button, { variant: "outlined", onClick: ok, disabled: invalidJson() }, "OK"), /* @__PURE__ */ import_react.default.createElement(import_material.Button, { variant: "outlined", onClick: cancel }, "CANCEL")));
+  };
+
+  // src/front/ProviderDebugTabContent.tsx
+  var import_react3 = __toESM(require_react(), 1);
+  var import_material3 = __toESM(require_material(), 1);
+  var import_icons_material2 = __toESM(require_icons_material(), 1);
+
+  // src/front/JsonBlock.tsx
+  var import_react2 = __toESM(require_react(), 1);
+  var import_material2 = __toESM(require_material(), 1);
+  var TOKEN = /("(?:\\u[a-fA-F0-9]{4}|\\[^u]|[^\\"])*"(\s*:)?|\b(?:true|false|null)\b|-?\d+(?:\.\d*)?(?:[eE][+-]?\d+)?)/g;
+  var JsonBlock = (props) => {
+    const theme = (0, import_material2.useTheme)();
+    const colorOf = (token) => {
+      if (token.startsWith('"')) return token.trimEnd().endsWith(":") ? theme.palette.primary.main : theme.palette.success.main;
+      if (token === "true" || token === "false" || token === "null") return theme.palette.secondary.main;
+      return theme.palette.warning.main;
+    };
+    const render = () => {
+      let text;
+      try {
+        text = JSON.stringify(props.value, null, 2) ?? String(props.value);
+      } catch {
+        return [/* @__PURE__ */ import_react2.default.createElement("span", { key: "err" }, "<unserializable event>")];
+      }
+      const nodes = [];
+      let last = 0;
+      let match;
+      TOKEN.lastIndex = 0;
+      while ((match = TOKEN.exec(text)) !== null) {
+        if (match.index > last) nodes.push(/* @__PURE__ */ import_react2.default.createElement("span", { key: `p${last}` }, text.slice(last, match.index)));
+        nodes.push(/* @__PURE__ */ import_react2.default.createElement("span", { key: `t${match.index}`, style: { color: colorOf(match[0]) } }, match[0]));
+        last = match.index + match[0].length;
+      }
+      if (last < text.length) nodes.push(/* @__PURE__ */ import_react2.default.createElement("span", { key: `p${last}` }, text.slice(last)));
+      return nodes;
+    };
+    return /* @__PURE__ */ import_react2.default.createElement(import_material2.Box, { component: "pre", sx: { m: 0, fontFamily: "monospace", fontSize: "0.75rem", whiteSpace: "pre-wrap", wordBreak: "break-all", overflowX: "auto" } }, render());
+  };
+
+  // src/front/ProviderDebugTabContent.tsx
+  var ProviderDebugTabContent = (props) => {
+    const data = props.channelObject.data;
+    const config = props.channelObject.config;
+    const instanceConfig = props.channelObject.instanceConfig;
+    const boxRef = (0, import_react3.useRef)(null);
+    const [boxTop, setBoxTop] = (0, import_react3.useState)(0);
+    const [, forceRender] = (0, import_react3.useState)(0);
+    const [copied, setCopied] = (0, import_react3.useState)(null);
+    (0, import_react3.useEffect)(() => {
+      if (boxRef.current) setBoxTop(boxRef.current.getBoundingClientRect().top);
+    });
+    const clear = () => {
+      data.events = [];
+      data.signals = [];
+      forceRender((n) => n + 1);
+    };
+    const writeClipboard = async (text) => {
+      try {
+        await navigator.clipboard.writeText(text);
+        return true;
+      } catch {
+        try {
+          const area = document.createElement("textarea");
+          area.value = text;
+          area.style.position = "fixed";
+          area.style.opacity = "0";
+          document.body.appendChild(area);
+          area.select();
+          const ok = document.execCommand("copy");
+          document.body.removeChild(area);
+          return ok;
+        } catch {
+          return false;
+        }
+      }
+    };
+    const copy = (event) => {
+      writeClipboard(JSON.stringify(event.event, null, 2)).then((ok) => {
+        if (!ok) return;
+        setCopied(event);
+        setTimeout(() => setCopied((current) => current === event ? null : current), 1500);
+      });
+    };
+    const summaryOf = (event) => {
+      if (event === null) return "null";
+      if (Array.isArray(event)) return `array \xB7 ${event.length} items`;
+      if (typeof event === "object") {
+        const keys = Object.keys(event);
+        return keys.length === 0 ? "{}" : keys.join(", ");
+      }
+      return String(event);
+    };
+    const formatProviders = () => {
+      if (data.providers.length === 0) return /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { variant: "body2", color: "text.secondary" }, "No providers running.");
+      return /* @__PURE__ */ import_react3.default.createElement(import_material3.Stack, { direction: "row", spacing: 1, flexWrap: "wrap", useFlexGap: true }, data.providers.map((p) => /* @__PURE__ */ import_react3.default.createElement(import_material3.Chip, { key: p.id, label: p.id, size: "small", variant: p.id === instanceConfig.providerId ? "filled" : "outlined" })));
+    };
+    const formatEvent = (event, index) => /* @__PURE__ */ import_react3.default.createElement(import_material3.Accordion, { key: index, disableGutters: true, slotProps: { transition: { unmountOnExit: true } } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.AccordionSummary, { expandIcon: /* @__PURE__ */ import_react3.default.createElement(import_icons_material2.ExpandMore, null) }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Stack, { direction: "row", spacing: 1.5, alignItems: "center", sx: { minWidth: 0, width: "100%" } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { variant: "caption", color: "text.secondary", sx: { fontFamily: "monospace" } }, new Date(event.ts).toISOString()), /* @__PURE__ */ import_react3.default.createElement(import_material3.Chip, { label: event.providerId, size: "small", variant: "outlined", sx: { fontSize: "0.65rem", height: 18 } }), /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { variant: "caption", color: "text.secondary", noWrap: true }, summaryOf(event.event)), /* @__PURE__ */ import_react3.default.createElement(import_material3.Tooltip, { title: copied === event ? "Copied" : "Copy event JSON" }, /* @__PURE__ */ import_react3.default.createElement(import_material3.IconButton, { size: "small", "aria-label": "Copy event JSON", sx: { ml: "auto" }, onClick: (e) => {
+      e.stopPropagation();
+      copy(event);
+    } }, copied === event ? /* @__PURE__ */ import_react3.default.createElement(import_icons_material2.Check, { fontSize: "small", color: "success" }) : /* @__PURE__ */ import_react3.default.createElement(import_icons_material2.ContentCopy, { fontSize: "small" }))))), /* @__PURE__ */ import_react3.default.createElement(import_material3.AccordionDetails, null, /* @__PURE__ */ import_react3.default.createElement(JsonBlock, { value: event.event })));
+    if (!data.started) {
+      return /* @__PURE__ */ import_react3.default.createElement(import_material3.Box, { sx: { p: 2 } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { color: "text.secondary" }, "Provider Debug not started. Start the channel (tab settings \u2699 \u2192 Start) to subscribe to a provider and watch its raw events."));
+    }
+    return /* @__PURE__ */ import_react3.default.createElement(import_material3.Card, { sx: { flex: 1, width: "98%", alignSelf: "center", m: 1 } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.CardHeader, { title: /* @__PURE__ */ import_react3.default.createElement(import_material3.Stack, { direction: "row", alignItems: "center", sx: { width: "100%" } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { mr: 4 }, /* @__PURE__ */ import_react3.default.createElement("b", null, "Provider:"), " ", instanceConfig.providerId || "(none)"), /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { mr: 4 }, /* @__PURE__ */ import_react3.default.createElement("b", null, "Events:"), " ", data.events.length, " / ", config.maxEvents), /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { mr: 4 }, /* @__PURE__ */ import_react3.default.createElement(import_icons_material2.Info, { fontSize: "small", sx: { mb: 0.25 } }), /* @__PURE__ */ import_react3.default.createElement("b", null, "\xA0Status:"), " ", data.paused ? "paused" : data.started ? "started" : "stopped"), /* @__PURE__ */ import_react3.default.createElement(import_material3.Tooltip, { title: "Clear captured events" }, /* @__PURE__ */ import_react3.default.createElement("span", { style: { marginLeft: "auto" } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.IconButton, { size: "small", "aria-label": "Clear captured events", onClick: clear, disabled: data.events.length === 0 && data.signals.length === 0 }, /* @__PURE__ */ import_react3.default.createElement(import_icons_material2.DeleteSweep, { fontSize: "small" }))))) }), /* @__PURE__ */ import_react3.default.createElement(import_material3.CardContent, null, /* @__PURE__ */ import_react3.default.createElement(import_material3.Stack, { direction: "column", spacing: 1, sx: { mb: 1 } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { variant: "caption", color: "text.secondary" }, "Running providers"), formatProviders(), data.signals.map((s, index) => /* @__PURE__ */ import_react3.default.createElement(import_material3.Typography, { key: index, variant: "caption", color: "text.secondary" }, "*** ", s, " ***"))), /* @__PURE__ */ import_react3.default.createElement(import_material3.Box, { ref: boxRef, sx: { display: "flex", flexDirection: "column", overflowY: "auto", overflowX: "hidden", width: "100%", flexGrow: 1, height: `calc(100vh - ${boxTop}px - 35px)` } }, /* @__PURE__ */ import_react3.default.createElement(import_material3.Box, { sx: { flex: 1, overflowY: "auto", ml: 1, mr: 1 } }, data.events.map((e, index) => formatEvent(e, index))))));
+  };
+
+  // src/front/ProviderDebugChannel.ts
+  var ProviderDebugChannel = class {
+    constructor() {
+      this.setupVisible = false;
+      this.SetupDialog = ProviderDebugSetup;
+      this.TabContent = ProviderDebugTabContent;
+      this.channelId = "provider-debug";
+      this.requirements = {
+        accessString: true,
+        clusterUrl: true,
+        clusterInfo: false,
+        exit: false,
+        frontChannels: false,
+        metrics: false,
+        notifier: true,
+        notifications: true,
+        setup: true,
+        settings: false,
+        palette: false,
+        userSettings: false,
+        webSocket: false,
+        backChannels: false
+      };
+    }
+    getScope() {
+      return import_kwirth_common.EInstanceConfigScope.NONE;
+    }
+    getChannelIcon() {
+      return ProviderDebugIcon;
+    }
+    getSetupVisibility() {
+      return this.setupVisible;
+    }
+    setSetupVisibility(visibility) {
+      this.setupVisible = visibility;
+    }
+    processChannelMessage(channelObject, wsEvent) {
+      const msg = JSON.parse(wsEvent.data);
+      const data = channelObject.data;
+      const config = channelObject.config;
+      switch (msg.type) {
+        case import_kwirth_common.EInstanceMessageType.DATA:
+          if (msg.payloadType === "providers" /* PROVIDERS */) {
+            data.providers = msg.providers ?? [];
+          } else {
+            if (msg.event) {
+              data.events.push(msg.event);
+              while (data.events.length > config.maxEvents) data.events.shift();
+            }
+          }
+          return { action: import_kwirth_common_front.EChannelRefreshAction.REFRESH };
+        case import_kwirth_common.EInstanceMessageType.SIGNAL: {
+          const signalMessage = JSON.parse(wsEvent.data);
+          if (signalMessage.flow === import_kwirth_common.EInstanceMessageFlow.RESPONSE && signalMessage.action === import_kwirth_common.EInstanceMessageAction.START) {
+            channelObject.instanceId = signalMessage.instance;
+          }
+          if (signalMessage.text) data.signals.push(signalMessage.text);
+          return { action: import_kwirth_common_front.EChannelRefreshAction.REFRESH };
+        }
+        default:
+          return { action: import_kwirth_common_front.EChannelRefreshAction.NONE };
+      }
+    }
+    async initChannel(channelObject) {
+      channelObject.instanceConfig = new ProviderDebugInstanceConfig();
+      channelObject.config = new ProviderDebugConfig();
+      channelObject.data = new ProviderDebugData();
+      return false;
+    }
+    startChannel(channelObject) {
+      const data = channelObject.data;
+      data.events = [];
+      data.signals = [];
+      data.paused = false;
+      data.started = true;
+      return true;
+    }
+    pauseChannel(channelObject) {
+      const data = channelObject.data;
+      data.paused = true;
+      return true;
+    }
+    continueChannel(channelObject) {
+      const data = channelObject.data;
+      data.paused = false;
+      return true;
+    }
+    stopChannel(channelObject) {
+      const data = channelObject.data;
+      data.paused = false;
+      data.started = false;
+      return true;
+    }
+    socketDisconnected(_channelObject) {
+      return false;
+    }
+    socketReconnect(_channelObject) {
+      return false;
+    }
+  };
+
+  // src/front/index.ts
+  window.__kwirth_plugins__ = window.__kwirth_plugins__ || {};
+  window.__kwirth_plugins__["provider-debug"] = ProviderDebugChannel;
+})();

package/package.json

@@ -0,0 +1,12 @@
+{
+  "type": "commonjs",
+  "extensionType": "plugin",
+  "id": "provider-debug",
+  "name": "@kwirthmagnify/kwirth-plugin-provider-debug",
+  "displayName": "Provider Debug",
+  "version": "0.1.0",
+  "description": "Provider debugging channel for Kwirth - subscribes to a running provider and streams its raw events",
+  "icon": "DataObjectOutlined",
+  "requiresRestart": false,
+  "requiresExtension": []
+}