mirror of
https://github.com/binaricat/Netcatty.git
synced 2026-11-16 20:11:08 +00:00
* feat(plugins): add isolated plugin host runtime * test(plugins): build runtime dependencies before tests * fix(plugins): harden runtime lifecycle and recovery * fix(plugins): harden runtime extension boundaries * fix(plugins): enforce runtime integrity boundaries * fix(plugins): await utility process exit * fix(plugins): harden utility process containment * fix(plugins): close runtime recovery gaps * fix(plugins): harden runtime lifecycle boundaries
67 lines
2.3 KiB
JavaScript
67 lines
2.3 KiB
JavaScript
"use strict";
|
|
|
|
const path = require("node:path");
|
|
|
|
const Ajv2020 = require("ajv/dist/2020").default;
|
|
const addFormats = require("ajv-formats").default;
|
|
const schema = require("./generated/plugin-contract.schema.json");
|
|
const { assertPluginJsonValue } = require("./jsonBoundary.cjs");
|
|
const {
|
|
PLUGIN_RPC_MAX_JSON_BYTES,
|
|
PLUGIN_STREAM_MAX_FRAME_JSON_BYTES,
|
|
} = require("./constants.cjs");
|
|
|
|
function createDefinitionValidator(definitionName) {
|
|
if (!schema.$defs?.[definitionName]) throw new Error(`Unknown plugin contract definition: ${definitionName}`);
|
|
const ajv = new Ajv2020({ allErrors: true, strict: false, validateFormats: true });
|
|
addFormats(ajv);
|
|
ajv.addSchema(schema);
|
|
return ajv.compile({ $ref: `${schema.$id}#/$defs/${definitionName}` });
|
|
}
|
|
|
|
function formatValidationErrors(errors) {
|
|
return (errors ?? [])
|
|
.slice(0, 8)
|
|
.map((error) => `${error.instancePath || "/"} ${error.message ?? "is invalid"}`)
|
|
.join("; ");
|
|
}
|
|
|
|
const rpcMessageValidator = createDefinitionValidator("RpcMessage");
|
|
const initializeResultValidator = createDefinitionValidator("RuntimeInitializeResult");
|
|
const streamFrameValidator = createDefinitionValidator("StreamFrame");
|
|
|
|
function assertContractValue(validator, value, label) {
|
|
if (!validator(value)) {
|
|
throw new TypeError(`${label} violates the plugin contract: ${formatValidationErrors(validator.errors)}`);
|
|
}
|
|
return value;
|
|
}
|
|
|
|
function assertRpcMessage(value) {
|
|
assertPluginJsonValue(value, { maxBytes: PLUGIN_RPC_MAX_JSON_BYTES });
|
|
return assertContractValue(rpcMessageValidator, value, "RPC message");
|
|
}
|
|
|
|
function assertInitializeResult(value) {
|
|
assertPluginJsonValue(value, { maxBytes: PLUGIN_RPC_MAX_JSON_BYTES });
|
|
return assertContractValue(initializeResultValidator, value, "Initialize result");
|
|
}
|
|
|
|
function assertStreamFrameSchema(value) {
|
|
assertPluginJsonValue(value, { maxBytes: PLUGIN_STREAM_MAX_FRAME_JSON_BYTES });
|
|
return assertContractValue(streamFrameValidator, value, "Stream frame");
|
|
}
|
|
|
|
function resolveContractRuntimePath(...segments) {
|
|
return path.join(__dirname, "..", "..", "node_modules", "@netcatty", "plugin-contract", "dist", ...segments);
|
|
}
|
|
|
|
module.exports = {
|
|
assertInitializeResult,
|
|
assertRpcMessage,
|
|
assertStreamFrameSchema,
|
|
createDefinitionValidator,
|
|
formatValidationErrors,
|
|
resolveContractRuntimePath,
|
|
};
|