[Init] Initial commit - NetMesh terminal manager

electron/preload/terminalDataMeta.cjs

@@ -0,0 +1,76 @@
+"use strict";
+
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+
+function normalizeTerminalDataMeta(meta) {
+  if (!isRecord(meta)) return undefined;
+  return { ...meta };
+}
+
+function hasMetaFields(meta) {
+  return Boolean(meta && Object.keys(meta).length > 0);
+}
+
+function mergeTerminalDataMeta(first, second, options = {}) {
+  const merged = {
+    ...(normalizeTerminalDataMeta(first) || {}),
+    ...(normalizeTerminalDataMeta(second) || {}),
+  };
+
+  const droppedOutputMayAffectTerminalState = Boolean(
+    first?.droppedOutputMayAffectTerminalState
+    || second?.droppedOutputMayAffectTerminalState
+  );
+  const droppedOutputAlternateScreenAction = second?.droppedOutputMayAffectTerminalState
+    ? second?.droppedOutputAlternateScreenAction
+    : (second?.droppedOutputAlternateScreenAction ?? first?.droppedOutputAlternateScreenAction);
+  const firstHasPluginPipelineIngress = Number.isFinite(first?.pluginPipelineIngressBytes);
+  const secondHasPluginPipelineIngress = Number.isFinite(second?.pluginPipelineIngressBytes);
+  const pluginPipelineIngressBytes = Math.max(
+    0,
+    Number(first?.pluginPipelineIngressBytes ?? 0)
+      + Number(second?.pluginPipelineIngressBytes ?? 0),
+  );
+
+  if (typeof second?.pluginPipelineSensitiveInput === "boolean") {
+    merged.pluginPipelineSensitiveInput = second.pluginPipelineSensitiveInput;
+  } else {
+    delete merged.pluginPipelineSensitiveInput;
+  }
+
+  if (second?.pluginPipelineProcessed === true) {
+    merged.pluginPipelineProcessed = true;
+  } else {
+    delete merged.pluginPipelineProcessed;
+  }
+
+  if (droppedOutputMayAffectTerminalState) {
+    merged.droppedOutputMayAffectTerminalState = true;
+  } else {
+    delete merged.droppedOutputMayAffectTerminalState;
+  }
+
+  if (droppedOutputAlternateScreenAction) {
+    merged.droppedOutputAlternateScreenAction = droppedOutputAlternateScreenAction;
+  } else {
+    delete merged.droppedOutputAlternateScreenAction;
+  }
+
+  if (firstHasPluginPipelineIngress || secondHasPluginPipelineIngress) {
+    merged.pluginPipelineIngressBytes = pluginPipelineIngressBytes;
+  } else {
+    delete merged.pluginPipelineIngressBytes;
+  }
+
+  if (options.preserveTerminalPerf !== true) {
+    delete merged.terminalPerf;
+  }
+
+  return hasMetaFields(merged) ? merged : undefined;
+}
+
+module.exports = {
+  mergeTerminalDataMeta,
+};