mirror of
https://github.com/binaricat/Netcatty.git
synced 2026-11-17 21:10:48 +00:00
* 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>
71 lines
2.7 KiB
JavaScript
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,
|
|
};
|