Files
Netcatty/electron/plugins/terminalInterceptorTransport.cjs
T
陈大猫andryan-wong-coder 67f8108713 feat(plugins): add reviewed privileged terminal data pipeline (#2402)
* feat(plugins): add privileged terminal data pipeline

* fix(plugins): harden terminal interceptor lifecycle

* fix(plugins): close terminal interceptor lifecycle gaps

* fix(plugins): preserve terminal interceptor state transitions

* fix(plugin): close terminal pipeline lifecycle gaps

* fix(plugin): harden terminal interceptor startup

* fix(plugin): isolate terminal output route attempts

* fix(plugin): isolate reused terminal sessions

* fix(plugin): harden terminal interceptor boundaries

* fix(plugin): harden terminal replay metadata

* fix(plugin): preserve terminal replay provenance

* fix(plugin): close terminal pipeline lifecycle races

* fix(plugin): harden terminal route handoff

* fix(plugin): contain terminal handoff failures

* fix(plugin): route terminal attachment through RPC

* fix(plugin): validate terminal attachment RPC

* fix(plugin): close unexpected runtime ports

* fix(plugin): canonicalize terminal data frames

* fix(plugin): close terminal pipeline lifecycle gaps

* fix(plugin): close terminal interceptor review gaps

* fix(plugin): harden terminal interceptor protocol handling

* fix(plugin): preserve terminal flow compatibility

* fix(plugin): preserve terminal protocol accounting

* fix(plugin): bound terminal interceptor lifecycle

* fix(plugin): close terminal interceptor review gaps

---------

Co-authored-by: ryan-wong-coder <wangsiyuan19990317@gmail.com>
2026-07-23 09:42:47 +08:00

71 lines
2.7 KiB
JavaScript

"use strict";
const schema = require("./generated/plugin-contract.schema.json");
const { assertTerminalInterceptorFrameSchema } = require("./contractValidator.cjs");
const limits = schema.$defs.TerminalInterceptorLimits.const;
const TERMINAL_INTERCEPTOR_MAX_CHUNK_BYTES = limits.maxChunkBytes;
const TERMINAL_INTERCEPTOR_MAX_WINDOW_BYTES = limits.maxWindowBytes;
const arrayBufferByteLength = Object.getOwnPropertyDescriptor(
ArrayBuffer.prototype,
"byteLength",
)?.get;
function copyOwnDataRecord(value, label) {
if (value === null || typeof value !== "object" || Array.isArray(value)) {
throw new TypeError(`${label} must be a plain object`);
}
const copy = {};
for (const key of Object.keys(value)) {
const descriptor = Object.getOwnPropertyDescriptor(value, key);
if (!descriptor || !("value" in descriptor)) {
throw new TypeError(`${label} must contain data properties only`);
}
copy[key] = descriptor.value;
}
return copy;
}
function transferredByteLength(value) {
if (!arrayBufferByteLength) throw new TypeError("ArrayBuffer byteLength getter is unavailable");
try {
const byteLength = arrayBufferByteLength.call(value);
// The intrinsic getter reports zero for a detached zero-length buffer as
// well as for a valid empty buffer. Constructing a view distinguishes the
// two and also works for ArrayBuffers created in another realm.
new Uint8Array(value);
return byteLength;
} catch {
throw new TypeError("Terminal interceptor transfer requires a real, attached ArrayBuffer");
}
}
function createTerminalInterceptorEnvelope(frameValue, transfer) {
const frame = copyOwnDataRecord(frameValue, "Terminal interceptor frame");
assertTerminalInterceptorFrameSchema(frame);
const requiresTransfer = frame.type === "netcatty:terminal-interceptor:chunk"
|| (frame.type === "netcatty:terminal-interceptor:result" && frame.status === "ok");
if (!requiresTransfer) {
if (transfer !== undefined) {
throw new TypeError("This terminal interceptor frame must not include a transferred buffer");
}
return Object.freeze({ frame: Object.freeze(frame) });
}
if (transfer === undefined) {
throw new TypeError("This terminal interceptor frame requires a transferred ArrayBuffer");
}
const byteLength = transferredByteLength(transfer);
if (byteLength !== frame.byteLength) {
throw new RangeError(
`Terminal interceptor byteLength mismatch: declared ${frame.byteLength}, received ${byteLength}`,
);
}
return Object.freeze({ frame: Object.freeze(frame), transfer });
}
module.exports = {
TERMINAL_INTERCEPTOR_MAX_CHUNK_BYTES,
TERMINAL_INTERCEPTOR_MAX_WINDOW_BYTES,
createTerminalInterceptorEnvelope,
};