tar.x({ file: tarballPath, cwd: extractDir, sync: true });

const packageDir = path.join(extractDir, "package");

const packageJson = JSON.parse(fs.readFileSync(path.join(packageDir, "package.json"), "utf8"));

const files = listFiles(packageDir);

return {

packageJson,

files: listFiles(packageDir),

files,

readme: readPackedPackageReadme(packageDir, files),

};

}

export function findPackedPackageReadmePath(files) {

return files.find((file) => /^readme(?:\.(?:md|markdown|txt|rst))?$/iu.test(file)) ?? "";

}

function readPackedPackageReadme(packageDir, files) {

const readmePath = findPackedPackageReadmePath(files);

if (!readmePath) {

return "";

}

return fs.readFileSync(path.join(packageDir, readmePath), "utf8").trim();

}

export async function verifyPublishedPluginRuntime(spec) {

const workingDir = fs.mkdtempSync(path.join(os.tmpdir(), "openclaw-plugin-npm-runtime."));

try {

if (errors.length > 0) {

throw new Error(errors.join("\n"));

}

const readme = await verifyPublishedPackageReadme(spec);

let readme;

try {

readme = await verifyPublishedPackageReadme(spec);

} catch (error) {

if (!packedPackage.readme) {

throw error;

}

console.error(

`npm readme metadata for ${spec} was unavailable; verified README from published tarball instead.`,

);

readme = packedPackage.readme;

}

return {

packageName: packedPackage.packageJson.name,

version: packedPackage.packageJson.version,

import { describe, expect, it } from "vitest";

import {

collectPluginNpmPublishedRuntimeErrors,

findPackedPackageReadmePath,

parseNpmReadmeMetadata,

readPositiveIntEnv,

resolveNpmPackFilename,

});

});

describe("findPackedPackageReadmePath", () => {

it("finds a root package README without accepting nested documentation files", () => {

expect(

findPackedPackageReadmePath(["package.json", "docs/README.md", "README.md", "dist/index.js"]),

).toBe("README.md");

expect(findPackedPackageReadmePath(["package.json", "docs/README.md"])).toBe("");

});

});

describe("parseNpmReadmeMetadata", () => {

it("accepts non-empty npm readme metadata", () => {

expect(parseNpmReadmeMetadata(JSON.stringify("# Plugin\n\nInstall it."))).toBe(