@verdaccio/plugin-verifier 1.0.0-next-9.1

package/build/diagnostics.cjs

@@ -0,0 +1,209 @@
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+const require_sanity_checks = require("./sanity-checks.cjs");
+let debug = require("debug");
+debug = require_runtime.__toESM(debug);
+let node_path = require("node:path");
+let _verdaccio_core = require("@verdaccio/core");
+let node_fs = require("node:fs");
+let node_module = require("node:module");
+let node_url = require("node:url");
+//#region src/diagnostics.ts
+var debug$1 = (0, debug.default)("verdaccio:plugin:verifier:diagnostics");
+var requireModule = (0, node_module.createRequire)(typeof __filename !== "undefined" ? __filename : {}.url);
+function isValidExport(plugin) {
+	return typeof plugin === "function" || typeof plugin?.default === "function";
+}
+function isES6(plugin) {
+	return plugin && typeof plugin === "object" && "default" in plugin;
+}
+/**
+* Resolve the ESM entry point for a directory-based plugin.
+* import() doesn't support directory imports, so we resolve via package.json.
+*/
+function resolveEntryPoint(dirPath) {
+	const pkgPath = (0, node_path.join)(dirPath, "package.json");
+	if ((0, node_fs.existsSync)(pkgPath)) try {
+		const pkg = JSON.parse((0, node_fs.readFileSync)(pkgPath, "utf-8"));
+		if (pkg.exports) {
+			const dotExport = pkg.exports["."];
+			if (typeof dotExport === "string") return (0, node_path.join)(dirPath, dotExport);
+			if (dotExport?.import?.default) return (0, node_path.join)(dirPath, dotExport.import.default);
+			if (dotExport?.import && typeof dotExport.import === "string") return (0, node_path.join)(dirPath, dotExport.import);
+			if (dotExport?.default) return (0, node_path.join)(dirPath, dotExport.default);
+		}
+		if (pkg.module) return (0, node_path.join)(dirPath, pkg.module);
+		if (pkg.main) return (0, node_path.join)(dirPath, pkg.main);
+	} catch {}
+	return (0, node_path.join)(dirPath, "index.js");
+}
+/**
+* Try to load a module, falling back from require() to import() for ESM.
+* Handles CJS require(), ESM require() shim errors (bundlers), and
+* ERR_REQUIRE_ESM — always falls through to dynamic import() on any
+* require() failure.
+*/
+async function tryResolve(modulePath) {
+	try {
+		return { module: requireModule(modulePath) };
+	} catch (requireErr) {
+		debug$1("require() failed for %o: %s — trying dynamic import", modulePath, requireErr.message);
+	}
+	try {
+		let importPath = modulePath;
+		if ((0, node_fs.existsSync)(modulePath) && (0, node_fs.existsSync)((0, node_path.join)(modulePath, "package.json"))) {
+			importPath = resolveEntryPoint(modulePath);
+			debug$1("resolved ESM entry point: %o", importPath);
+		}
+		return { module: await (importPath.startsWith("/") ? import((0, node_url.pathToFileURL)(importPath).href) : import(importPath)) };
+	} catch (importErr) {
+		return {
+			module: null,
+			error: importErr.message
+		};
+	}
+}
+/**
+* Runs step-by-step diagnostics to identify exactly which phase of
+* plugin loading fails. This replicates the same resolution logic
+* as `asyncLoadPlugin` but tests each step independently.
+*/
+async function runDiagnostics(options) {
+	const { pluginPath, category, pluginConfig = {}, sanityCheck: customSanityCheck, prefix = _verdaccio_core.PLUGIN_PREFIX, pluginsFolder } = options;
+	const steps = [];
+	const pluginName = pluginPath.startsWith("@") && pluginPath.includes("/") ? pluginPath : `${prefix}-${pluginPath}`;
+	debug$1("running diagnostics for %o (resolved name: %o)", pluginPath, pluginName);
+	let pluginModule = null;
+	let resolvedFrom = "";
+	if (pluginsFolder) {
+		const absFolder = (0, node_path.resolve)(pluginsFolder);
+		const pluginDir = (0, node_path.join)(absFolder, pluginName);
+		debug$1("checking plugins folder: %o", pluginDir);
+		if (!(0, node_fs.existsSync)(absFolder)) {
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: `Plugins folder does not exist: ${absFolder}`
+			});
+			return steps;
+		}
+		if (!(0, node_fs.existsSync)(pluginDir)) {
+			debug$1("plugin directory not found: %o", pluginDir);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: `Plugin directory not found: ${pluginDir} — expected a folder named "${pluginName}" inside "${absFolder}"`
+			});
+			return steps;
+		}
+		const result = await tryResolve(pluginDir);
+		if (result.module) {
+			pluginModule = result.module;
+			resolvedFrom = pluginDir;
+			debug$1("resolved from plugins folder: %o", pluginDir);
+		} else {
+			const missingDep = parseMissingDependency(result.error ?? "", pluginDir);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: missingDep ? `Plugin found at ${pluginDir} but has a missing dependency: ${missingDep}` : `Plugin found at ${pluginDir} but failed to load: ${result.error}`
+			});
+			return steps;
+		}
+	}
+	if (!pluginModule) {
+		const result = await tryResolve(pluginName);
+		if (result.module) {
+			pluginModule = result.module;
+			resolvedFrom = pluginName;
+			debug$1("resolved from node_modules: %o", pluginName);
+		} else {
+			const missingDep = parseMissingDependency(result.error ?? "", pluginName);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: missingDep ? `Package "${pluginName}" found but has a missing dependency: ${missingDep}` : `Package "${pluginName}" not found in node_modules — try: npm install ${pluginName}`
+			});
+			return steps;
+		}
+	}
+	steps.push({
+		phase: "resolve",
+		pass: true,
+		message: `Module resolved from ${resolvedFrom}`
+	});
+	if (!isValidExport(pluginModule)) {
+		const exportKeys = pluginModule ? Object.keys(pluginModule).join(", ") : "none";
+		steps.push({
+			phase: "export",
+			pass: false,
+			message: `Module does not export a function or class (default export). Exported keys: [${exportKeys}]`
+		});
+		return steps;
+	}
+	const moduleType = isES6(pluginModule) ? "ES6 (default export)" : "CommonJS (factory function)";
+	steps.push({
+		phase: "export",
+		pass: true,
+		message: `Valid ${moduleType} plugin export detected`
+	});
+	let instance;
+	try {
+		if (isES6(pluginModule)) instance = new pluginModule.default(pluginConfig, {
+			config: pluginConfig,
+			logger: console
+		});
+		else instance = pluginModule(pluginConfig, {
+			config: pluginConfig,
+			logger: console
+		});
+	} catch (err) {
+		steps.push({
+			phase: "instantiate",
+			pass: false,
+			message: `Plugin threw during instantiation: ${err.message}`
+		});
+		return steps;
+	}
+	if (!instance || typeof instance !== "object" && typeof instance !== "function") {
+		steps.push({
+			phase: "instantiate",
+			pass: false,
+			message: `Plugin constructor/factory returned ${instance === null ? "null" : typeof instance} instead of an object`
+		});
+		return steps;
+	}
+	steps.push({
+		phase: "instantiate",
+		pass: true,
+		message: "Plugin instantiated successfully"
+	});
+	if (!(customSanityCheck ?? require_sanity_checks.getSanityCheck(category))(instance)) {
+		const methods = Object.getOwnPropertyNames(Object.getPrototypeOf(instance) ?? {}).filter((m) => m !== "constructor").concat(Object.keys(instance));
+		const unique = [...new Set(methods)];
+		steps.push({
+			phase: "sanity-check",
+			pass: false,
+			message: `Plugin does not implement the required methods for category "${category}". Available methods: [${unique.join(", ")}]`
+		});
+		return steps;
+	}
+	steps.push({
+		phase: "sanity-check",
+		pass: true,
+		message: `Plugin passes sanity check for category "${category}"`
+	});
+	return steps;
+}
+/**
+* When a MODULE_NOT_FOUND error is about a transitive dependency
+* (not the plugin itself), extract the missing module name.
+*/
+function parseMissingDependency(message, pluginPath) {
+	const match = message.match(/Cannot find module '([^']+)'/);
+	if (match && match[1] && !match[1].includes(pluginPath)) return match[1];
+	return null;
+}
+//#endregion
+exports.runDiagnostics = runDiagnostics;
+
+//# sourceMappingURL=diagnostics.cjs.map

package/build/diagnostics.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.cjs","names":[],"sources":["../src/diagnostics.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { PLUGIN_PREFIX } from '@verdaccio/core';\n\nimport { getSanityCheck } from './sanity-checks';\nimport type { DiagnosticStep, VerifyPluginOptions } from './types';\n\nconst debug = buildDebug('verdaccio:plugin:verifier:diagnostics');\n\n// createRequire needs an absolute path; works in both ESM and CJS contexts\nconst requireModule = createRequire(\n  typeof __filename !== 'undefined' ? __filename : import.meta.url\n);\n\nfunction isValidExport(plugin: any): boolean {\n  return typeof plugin === 'function' || typeof plugin?.default === 'function';\n}\n\nfunction isES6(plugin: any): boolean {\n  return plugin && typeof plugin === 'object' && 'default' in plugin;\n}\n\n/**\n * Resolve the ESM entry point for a directory-based plugin.\n * import() doesn't support directory imports, so we resolve via package.json.\n */\nexport function resolveEntryPoint(dirPath: string): string {\n  const pkgPath = join(dirPath, 'package.json');\n  if (existsSync(pkgPath)) {\n    try {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      if (pkg.exports) {\n        const dotExport = pkg.exports['.'];\n        if (typeof dotExport === 'string') {\n          return join(dirPath, dotExport);\n        }\n        if (dotExport?.import?.default) {\n          return join(dirPath, dotExport.import.default);\n        }\n        if (dotExport?.import && typeof dotExport.import === 'string') {\n          return join(dirPath, dotExport.import);\n        }\n        if (dotExport?.default) {\n          return join(dirPath, dotExport.default);\n        }\n      }\n      if (pkg.module) {\n        return join(dirPath, pkg.module);\n      }\n      if (pkg.main) {\n        return join(dirPath, pkg.main);\n      }\n    } catch {\n      // fall through\n    }\n  }\n  return join(dirPath, 'index.js');\n}\n\n/**\n * Try to load a module, falling back from require() to import() for ESM.\n * Handles CJS require(), ESM require() shim errors (bundlers), and\n * ERR_REQUIRE_ESM — always falls through to dynamic import() on any\n * require() failure.\n */\nasync function tryResolve(modulePath: string): Promise<{ module: any; error?: string }> {\n  // Try require() first (fast path for CJS modules)\n  try {\n    return { module: requireModule(modulePath) };\n  } catch (requireErr: any) {\n    debug('require() failed for %o: %s — trying dynamic import', modulePath, requireErr.message);\n  }\n\n  // Fallback to dynamic import() for ESM modules\n  try {\n    let importPath = modulePath;\n    if (existsSync(modulePath) && existsSync(join(modulePath, 'package.json'))) {\n      importPath = resolveEntryPoint(modulePath);\n      debug('resolved ESM entry point: %o', importPath);\n    }\n    const importUrl = importPath.startsWith('/') ? pathToFileURL(importPath).href : importPath;\n    const mod = await import(importUrl);\n    return { module: mod };\n  } catch (importErr: any) {\n    return { module: null, error: importErr.message };\n  }\n}\n\n/**\n * Runs step-by-step diagnostics to identify exactly which phase of\n * plugin loading fails. This replicates the same resolution logic\n * as `asyncLoadPlugin` but tests each step independently.\n */\nexport async function runDiagnostics(options: VerifyPluginOptions): Promise<DiagnosticStep[]> {\n  const {\n    pluginPath,\n    category,\n    pluginConfig = {},\n    sanityCheck: customSanityCheck,\n    prefix = PLUGIN_PREFIX,\n    pluginsFolder,\n  } = options;\n\n  const steps: DiagnosticStep[] = [];\n  const isScoped = pluginPath.startsWith('@') && pluginPath.includes('/');\n  const pluginName = isScoped ? pluginPath : `${prefix}-${pluginPath}`;\n\n  debug('running diagnostics for %o (resolved name: %o)', pluginPath, pluginName);\n\n  // --- Phase 1: Resolve ---\n  let pluginModule: any = null;\n  let resolvedFrom = '';\n\n  // Try plugins folder first\n  if (pluginsFolder) {\n    const absFolder = resolve(pluginsFolder);\n    const pluginDir = join(absFolder, pluginName);\n    debug('checking plugins folder: %o', pluginDir);\n\n    if (!existsSync(absFolder)) {\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: `Plugins folder does not exist: ${absFolder}`,\n      });\n      return steps;\n    }\n\n    if (!existsSync(pluginDir)) {\n      debug('plugin directory not found: %o', pluginDir);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: `Plugin directory not found: ${pluginDir} — expected a folder named \"${pluginName}\" inside \"${absFolder}\"`,\n      });\n      return steps;\n    }\n\n    const result = await tryResolve(pluginDir);\n    if (result.module) {\n      pluginModule = result.module;\n      resolvedFrom = pluginDir;\n      debug('resolved from plugins folder: %o', pluginDir);\n    } else {\n      const missingDep = parseMissingDependency(result.error ?? '', pluginDir);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: missingDep\n          ? `Plugin found at ${pluginDir} but has a missing dependency: ${missingDep}`\n          : `Plugin found at ${pluginDir} but failed to load: ${result.error}`,\n      });\n      return steps;\n    }\n  }\n\n  // Try node_modules if not found in plugins folder\n  if (!pluginModule) {\n    const result = await tryResolve(pluginName);\n    if (result.module) {\n      pluginModule = result.module;\n      resolvedFrom = pluginName;\n      debug('resolved from node_modules: %o', pluginName);\n    } else {\n      const missingDep = parseMissingDependency(result.error ?? '', pluginName);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: missingDep\n          ? `Package \"${pluginName}\" found but has a missing dependency: ${missingDep}`\n          : `Package \"${pluginName}\" not found in node_modules — try: npm install ${pluginName}`,\n      });\n      return steps;\n    }\n  }\n\n  steps.push({\n    phase: 'resolve',\n    pass: true,\n    message: `Module resolved from ${resolvedFrom}`,\n  });\n\n  // --- Phase 2: Export validation ---\n  if (!isValidExport(pluginModule)) {\n    const exportKeys = pluginModule ? Object.keys(pluginModule).join(', ') : 'none';\n    steps.push({\n      phase: 'export',\n      pass: false,\n      message: `Module does not export a function or class (default export). Exported keys: [${exportKeys}]`,\n    });\n    return steps;\n  }\n\n  const moduleType = isES6(pluginModule) ? 'ES6 (default export)' : 'CommonJS (factory function)';\n  steps.push({\n    phase: 'export',\n    pass: true,\n    message: `Valid ${moduleType} plugin export detected`,\n  });\n\n  // --- Phase 3: Instantiation ---\n  let instance: any;\n  try {\n    if (isES6(pluginModule)) {\n      instance = new pluginModule.default(pluginConfig, { config: pluginConfig, logger: console });\n    } else {\n      instance = pluginModule(pluginConfig, { config: pluginConfig, logger: console });\n    }\n  } catch (err: any) {\n    steps.push({\n      phase: 'instantiate',\n      pass: false,\n      message: `Plugin threw during instantiation: ${err.message}`,\n    });\n    return steps;\n  }\n\n  if (!instance || (typeof instance !== 'object' && typeof instance !== 'function')) {\n    steps.push({\n      phase: 'instantiate',\n      pass: false,\n      message: `Plugin constructor/factory returned ${instance === null ? 'null' : typeof instance} instead of an object`,\n    });\n    return steps;\n  }\n\n  steps.push({\n    phase: 'instantiate',\n    pass: true,\n    message: 'Plugin instantiated successfully',\n  });\n\n  // --- Phase 4: Sanity check ---\n  const sanityCheck = customSanityCheck ?? getSanityCheck(category);\n  const passed = sanityCheck(instance);\n\n  if (!passed) {\n    const methods = Object.getOwnPropertyNames(Object.getPrototypeOf(instance) ?? {})\n      .filter((m) => m !== 'constructor')\n      .concat(Object.keys(instance));\n    const unique = [...new Set(methods)];\n\n    steps.push({\n      phase: 'sanity-check',\n      pass: false,\n      message: `Plugin does not implement the required methods for category \"${category}\". Available methods: [${unique.join(', ')}]`,\n    });\n    return steps;\n  }\n\n  steps.push({\n    phase: 'sanity-check',\n    pass: true,\n    message: `Plugin passes sanity check for category \"${category}\"`,\n  });\n\n  return steps;\n}\n\n/**\n * When a MODULE_NOT_FOUND error is about a transitive dependency\n * (not the plugin itself), extract the missing module name.\n */\nfunction parseMissingDependency(message: string, pluginPath: string): string | null {\n  const match = message.match(/Cannot find module '([^']+)'/);\n  if (match && match[1] && !match[1].includes(pluginPath)) {\n    return match[1];\n  }\n  return null;\n}\n"],"mappings":"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"}

package/build/diagnostics.d.ts

@@ -0,0 +1,13 @@
+import { DiagnosticStep, VerifyPluginOptions } from './types';
+/**
+ * Resolve the ESM entry point for a directory-based plugin.
+ * import() doesn't support directory imports, so we resolve via package.json.
+ */
+export declare function resolveEntryPoint(dirPath: string): string;
+/**
+ * Runs step-by-step diagnostics to identify exactly which phase of
+ * plugin loading fails. This replicates the same resolution logic
+ * as `asyncLoadPlugin` but tests each step independently.
+ */
+export declare function runDiagnostics(options: VerifyPluginOptions): Promise<DiagnosticStep[]>;
+//# sourceMappingURL=diagnostics.d.ts.map

package/build/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../src/diagnostics.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAiBnE;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CA+BzD;AA+BD;;;;GAIG;AACH,wBAAsB,cAAc,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAoK5F"}

package/build/diagnostics.js

@@ -0,0 +1,207 @@
+import { getSanityCheck } from "./sanity-checks.js";
+import buildDebug from "debug";
+import { join, resolve } from "node:path";
+import { PLUGIN_PREFIX } from "@verdaccio/core";
+import { existsSync, readFileSync } from "node:fs";
+import { createRequire } from "node:module";
+import { pathToFileURL } from "node:url";
+//#region src/diagnostics.ts
+var debug = buildDebug("verdaccio:plugin:verifier:diagnostics");
+var requireModule = createRequire(typeof __filename !== "undefined" ? __filename : import.meta.url);
+function isValidExport(plugin) {
+	return typeof plugin === "function" || typeof plugin?.default === "function";
+}
+function isES6(plugin) {
+	return plugin && typeof plugin === "object" && "default" in plugin;
+}
+/**
+* Resolve the ESM entry point for a directory-based plugin.
+* import() doesn't support directory imports, so we resolve via package.json.
+*/
+function resolveEntryPoint(dirPath) {
+	const pkgPath = join(dirPath, "package.json");
+	if (existsSync(pkgPath)) try {
+		const pkg = JSON.parse(readFileSync(pkgPath, "utf-8"));
+		if (pkg.exports) {
+			const dotExport = pkg.exports["."];
+			if (typeof dotExport === "string") return join(dirPath, dotExport);
+			if (dotExport?.import?.default) return join(dirPath, dotExport.import.default);
+			if (dotExport?.import && typeof dotExport.import === "string") return join(dirPath, dotExport.import);
+			if (dotExport?.default) return join(dirPath, dotExport.default);
+		}
+		if (pkg.module) return join(dirPath, pkg.module);
+		if (pkg.main) return join(dirPath, pkg.main);
+	} catch {}
+	return join(dirPath, "index.js");
+}
+/**
+* Try to load a module, falling back from require() to import() for ESM.
+* Handles CJS require(), ESM require() shim errors (bundlers), and
+* ERR_REQUIRE_ESM — always falls through to dynamic import() on any
+* require() failure.
+*/
+async function tryResolve(modulePath) {
+	try {
+		return { module: requireModule(modulePath) };
+	} catch (requireErr) {
+		debug("require() failed for %o: %s — trying dynamic import", modulePath, requireErr.message);
+	}
+	try {
+		let importPath = modulePath;
+		if (existsSync(modulePath) && existsSync(join(modulePath, "package.json"))) {
+			importPath = resolveEntryPoint(modulePath);
+			debug("resolved ESM entry point: %o", importPath);
+		}
+		return { module: await (importPath.startsWith("/") ? import(pathToFileURL(importPath).href) : import(importPath)) };
+	} catch (importErr) {
+		return {
+			module: null,
+			error: importErr.message
+		};
+	}
+}
+/**
+* Runs step-by-step diagnostics to identify exactly which phase of
+* plugin loading fails. This replicates the same resolution logic
+* as `asyncLoadPlugin` but tests each step independently.
+*/
+async function runDiagnostics(options) {
+	const { pluginPath, category, pluginConfig = {}, sanityCheck: customSanityCheck, prefix = PLUGIN_PREFIX, pluginsFolder } = options;
+	const steps = [];
+	const pluginName = pluginPath.startsWith("@") && pluginPath.includes("/") ? pluginPath : `${prefix}-${pluginPath}`;
+	debug("running diagnostics for %o (resolved name: %o)", pluginPath, pluginName);
+	let pluginModule = null;
+	let resolvedFrom = "";
+	if (pluginsFolder) {
+		const absFolder = resolve(pluginsFolder);
+		const pluginDir = join(absFolder, pluginName);
+		debug("checking plugins folder: %o", pluginDir);
+		if (!existsSync(absFolder)) {
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: `Plugins folder does not exist: ${absFolder}`
+			});
+			return steps;
+		}
+		if (!existsSync(pluginDir)) {
+			debug("plugin directory not found: %o", pluginDir);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: `Plugin directory not found: ${pluginDir} — expected a folder named "${pluginName}" inside "${absFolder}"`
+			});
+			return steps;
+		}
+		const result = await tryResolve(pluginDir);
+		if (result.module) {
+			pluginModule = result.module;
+			resolvedFrom = pluginDir;
+			debug("resolved from plugins folder: %o", pluginDir);
+		} else {
+			const missingDep = parseMissingDependency(result.error ?? "", pluginDir);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: missingDep ? `Plugin found at ${pluginDir} but has a missing dependency: ${missingDep}` : `Plugin found at ${pluginDir} but failed to load: ${result.error}`
+			});
+			return steps;
+		}
+	}
+	if (!pluginModule) {
+		const result = await tryResolve(pluginName);
+		if (result.module) {
+			pluginModule = result.module;
+			resolvedFrom = pluginName;
+			debug("resolved from node_modules: %o", pluginName);
+		} else {
+			const missingDep = parseMissingDependency(result.error ?? "", pluginName);
+			steps.push({
+				phase: "resolve",
+				pass: false,
+				message: missingDep ? `Package "${pluginName}" found but has a missing dependency: ${missingDep}` : `Package "${pluginName}" not found in node_modules — try: npm install ${pluginName}`
+			});
+			return steps;
+		}
+	}
+	steps.push({
+		phase: "resolve",
+		pass: true,
+		message: `Module resolved from ${resolvedFrom}`
+	});
+	if (!isValidExport(pluginModule)) {
+		const exportKeys = pluginModule ? Object.keys(pluginModule).join(", ") : "none";
+		steps.push({
+			phase: "export",
+			pass: false,
+			message: `Module does not export a function or class (default export). Exported keys: [${exportKeys}]`
+		});
+		return steps;
+	}
+	const moduleType = isES6(pluginModule) ? "ES6 (default export)" : "CommonJS (factory function)";
+	steps.push({
+		phase: "export",
+		pass: true,
+		message: `Valid ${moduleType} plugin export detected`
+	});
+	let instance;
+	try {
+		if (isES6(pluginModule)) instance = new pluginModule.default(pluginConfig, {
+			config: pluginConfig,
+			logger: console
+		});
+		else instance = pluginModule(pluginConfig, {
+			config: pluginConfig,
+			logger: console
+		});
+	} catch (err) {
+		steps.push({
+			phase: "instantiate",
+			pass: false,
+			message: `Plugin threw during instantiation: ${err.message}`
+		});
+		return steps;
+	}
+	if (!instance || typeof instance !== "object" && typeof instance !== "function") {
+		steps.push({
+			phase: "instantiate",
+			pass: false,
+			message: `Plugin constructor/factory returned ${instance === null ? "null" : typeof instance} instead of an object`
+		});
+		return steps;
+	}
+	steps.push({
+		phase: "instantiate",
+		pass: true,
+		message: "Plugin instantiated successfully"
+	});
+	if (!(customSanityCheck ?? getSanityCheck(category))(instance)) {
+		const methods = Object.getOwnPropertyNames(Object.getPrototypeOf(instance) ?? {}).filter((m) => m !== "constructor").concat(Object.keys(instance));
+		const unique = [...new Set(methods)];
+		steps.push({
+			phase: "sanity-check",
+			pass: false,
+			message: `Plugin does not implement the required methods for category "${category}". Available methods: [${unique.join(", ")}]`
+		});
+		return steps;
+	}
+	steps.push({
+		phase: "sanity-check",
+		pass: true,
+		message: `Plugin passes sanity check for category "${category}"`
+	});
+	return steps;
+}
+/**
+* When a MODULE_NOT_FOUND error is about a transitive dependency
+* (not the plugin itself), extract the missing module name.
+*/
+function parseMissingDependency(message, pluginPath) {
+	const match = message.match(/Cannot find module '([^']+)'/);
+	if (match && match[1] && !match[1].includes(pluginPath)) return match[1];
+	return null;
+}
+//#endregion
+export { runDiagnostics };
+
+//# sourceMappingURL=diagnostics.js.map

package/build/diagnostics.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.js","names":[],"sources":["../src/diagnostics.ts"],"sourcesContent":["import buildDebug from 'debug';\nimport { existsSync, readFileSync } from 'node:fs';\nimport { createRequire } from 'node:module';\nimport { join, resolve } from 'node:path';\nimport { pathToFileURL } from 'node:url';\n\nimport { PLUGIN_PREFIX } from '@verdaccio/core';\n\nimport { getSanityCheck } from './sanity-checks';\nimport type { DiagnosticStep, VerifyPluginOptions } from './types';\n\nconst debug = buildDebug('verdaccio:plugin:verifier:diagnostics');\n\n// createRequire needs an absolute path; works in both ESM and CJS contexts\nconst requireModule = createRequire(\n  typeof __filename !== 'undefined' ? __filename : import.meta.url\n);\n\nfunction isValidExport(plugin: any): boolean {\n  return typeof plugin === 'function' || typeof plugin?.default === 'function';\n}\n\nfunction isES6(plugin: any): boolean {\n  return plugin && typeof plugin === 'object' && 'default' in plugin;\n}\n\n/**\n * Resolve the ESM entry point for a directory-based plugin.\n * import() doesn't support directory imports, so we resolve via package.json.\n */\nexport function resolveEntryPoint(dirPath: string): string {\n  const pkgPath = join(dirPath, 'package.json');\n  if (existsSync(pkgPath)) {\n    try {\n      const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));\n      if (pkg.exports) {\n        const dotExport = pkg.exports['.'];\n        if (typeof dotExport === 'string') {\n          return join(dirPath, dotExport);\n        }\n        if (dotExport?.import?.default) {\n          return join(dirPath, dotExport.import.default);\n        }\n        if (dotExport?.import && typeof dotExport.import === 'string') {\n          return join(dirPath, dotExport.import);\n        }\n        if (dotExport?.default) {\n          return join(dirPath, dotExport.default);\n        }\n      }\n      if (pkg.module) {\n        return join(dirPath, pkg.module);\n      }\n      if (pkg.main) {\n        return join(dirPath, pkg.main);\n      }\n    } catch {\n      // fall through\n    }\n  }\n  return join(dirPath, 'index.js');\n}\n\n/**\n * Try to load a module, falling back from require() to import() for ESM.\n * Handles CJS require(), ESM require() shim errors (bundlers), and\n * ERR_REQUIRE_ESM — always falls through to dynamic import() on any\n * require() failure.\n */\nasync function tryResolve(modulePath: string): Promise<{ module: any; error?: string }> {\n  // Try require() first (fast path for CJS modules)\n  try {\n    return { module: requireModule(modulePath) };\n  } catch (requireErr: any) {\n    debug('require() failed for %o: %s — trying dynamic import', modulePath, requireErr.message);\n  }\n\n  // Fallback to dynamic import() for ESM modules\n  try {\n    let importPath = modulePath;\n    if (existsSync(modulePath) && existsSync(join(modulePath, 'package.json'))) {\n      importPath = resolveEntryPoint(modulePath);\n      debug('resolved ESM entry point: %o', importPath);\n    }\n    const importUrl = importPath.startsWith('/') ? pathToFileURL(importPath).href : importPath;\n    const mod = await import(importUrl);\n    return { module: mod };\n  } catch (importErr: any) {\n    return { module: null, error: importErr.message };\n  }\n}\n\n/**\n * Runs step-by-step diagnostics to identify exactly which phase of\n * plugin loading fails. This replicates the same resolution logic\n * as `asyncLoadPlugin` but tests each step independently.\n */\nexport async function runDiagnostics(options: VerifyPluginOptions): Promise<DiagnosticStep[]> {\n  const {\n    pluginPath,\n    category,\n    pluginConfig = {},\n    sanityCheck: customSanityCheck,\n    prefix = PLUGIN_PREFIX,\n    pluginsFolder,\n  } = options;\n\n  const steps: DiagnosticStep[] = [];\n  const isScoped = pluginPath.startsWith('@') && pluginPath.includes('/');\n  const pluginName = isScoped ? pluginPath : `${prefix}-${pluginPath}`;\n\n  debug('running diagnostics for %o (resolved name: %o)', pluginPath, pluginName);\n\n  // --- Phase 1: Resolve ---\n  let pluginModule: any = null;\n  let resolvedFrom = '';\n\n  // Try plugins folder first\n  if (pluginsFolder) {\n    const absFolder = resolve(pluginsFolder);\n    const pluginDir = join(absFolder, pluginName);\n    debug('checking plugins folder: %o', pluginDir);\n\n    if (!existsSync(absFolder)) {\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: `Plugins folder does not exist: ${absFolder}`,\n      });\n      return steps;\n    }\n\n    if (!existsSync(pluginDir)) {\n      debug('plugin directory not found: %o', pluginDir);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: `Plugin directory not found: ${pluginDir} — expected a folder named \"${pluginName}\" inside \"${absFolder}\"`,\n      });\n      return steps;\n    }\n\n    const result = await tryResolve(pluginDir);\n    if (result.module) {\n      pluginModule = result.module;\n      resolvedFrom = pluginDir;\n      debug('resolved from plugins folder: %o', pluginDir);\n    } else {\n      const missingDep = parseMissingDependency(result.error ?? '', pluginDir);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: missingDep\n          ? `Plugin found at ${pluginDir} but has a missing dependency: ${missingDep}`\n          : `Plugin found at ${pluginDir} but failed to load: ${result.error}`,\n      });\n      return steps;\n    }\n  }\n\n  // Try node_modules if not found in plugins folder\n  if (!pluginModule) {\n    const result = await tryResolve(pluginName);\n    if (result.module) {\n      pluginModule = result.module;\n      resolvedFrom = pluginName;\n      debug('resolved from node_modules: %o', pluginName);\n    } else {\n      const missingDep = parseMissingDependency(result.error ?? '', pluginName);\n      steps.push({\n        phase: 'resolve',\n        pass: false,\n        message: missingDep\n          ? `Package \"${pluginName}\" found but has a missing dependency: ${missingDep}`\n          : `Package \"${pluginName}\" not found in node_modules — try: npm install ${pluginName}`,\n      });\n      return steps;\n    }\n  }\n\n  steps.push({\n    phase: 'resolve',\n    pass: true,\n    message: `Module resolved from ${resolvedFrom}`,\n  });\n\n  // --- Phase 2: Export validation ---\n  if (!isValidExport(pluginModule)) {\n    const exportKeys = pluginModule ? Object.keys(pluginModule).join(', ') : 'none';\n    steps.push({\n      phase: 'export',\n      pass: false,\n      message: `Module does not export a function or class (default export). Exported keys: [${exportKeys}]`,\n    });\n    return steps;\n  }\n\n  const moduleType = isES6(pluginModule) ? 'ES6 (default export)' : 'CommonJS (factory function)';\n  steps.push({\n    phase: 'export',\n    pass: true,\n    message: `Valid ${moduleType} plugin export detected`,\n  });\n\n  // --- Phase 3: Instantiation ---\n  let instance: any;\n  try {\n    if (isES6(pluginModule)) {\n      instance = new pluginModule.default(pluginConfig, { config: pluginConfig, logger: console });\n    } else {\n      instance = pluginModule(pluginConfig, { config: pluginConfig, logger: console });\n    }\n  } catch (err: any) {\n    steps.push({\n      phase: 'instantiate',\n      pass: false,\n      message: `Plugin threw during instantiation: ${err.message}`,\n    });\n    return steps;\n  }\n\n  if (!instance || (typeof instance !== 'object' && typeof instance !== 'function')) {\n    steps.push({\n      phase: 'instantiate',\n      pass: false,\n      message: `Plugin constructor/factory returned ${instance === null ? 'null' : typeof instance} instead of an object`,\n    });\n    return steps;\n  }\n\n  steps.push({\n    phase: 'instantiate',\n    pass: true,\n    message: 'Plugin instantiated successfully',\n  });\n\n  // --- Phase 4: Sanity check ---\n  const sanityCheck = customSanityCheck ?? getSanityCheck(category);\n  const passed = sanityCheck(instance);\n\n  if (!passed) {\n    const methods = Object.getOwnPropertyNames(Object.getPrototypeOf(instance) ?? {})\n      .filter((m) => m !== 'constructor')\n      .concat(Object.keys(instance));\n    const unique = [...new Set(methods)];\n\n    steps.push({\n      phase: 'sanity-check',\n      pass: false,\n      message: `Plugin does not implement the required methods for category \"${category}\". Available methods: [${unique.join(', ')}]`,\n    });\n    return steps;\n  }\n\n  steps.push({\n    phase: 'sanity-check',\n    pass: true,\n    message: `Plugin passes sanity check for category \"${category}\"`,\n  });\n\n  return steps;\n}\n\n/**\n * When a MODULE_NOT_FOUND error is about a transitive dependency\n * (not the plugin itself), extract the missing module name.\n */\nfunction parseMissingDependency(message: string, pluginPath: string): string | null {\n  const match = message.match(/Cannot find module '([^']+)'/);\n  if (match && match[1] && !match[1].includes(pluginPath)) {\n    return match[1];\n  }\n  return null;\n}\n"],"mappings":"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"}

package/build/index.cjs

@@ -0,0 +1,11 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_sanity_checks = require("./sanity-checks.cjs");
+const require_diagnostics = require("./diagnostics.cjs");
+const require_verify_plugin = require("./verify-plugin.cjs");
+exports.authSanityCheck = require_sanity_checks.authSanityCheck;
+exports.filterSanityCheck = require_sanity_checks.filterSanityCheck;
+exports.getSanityCheck = require_sanity_checks.getSanityCheck;
+exports.middlewareSanityCheck = require_sanity_checks.middlewareSanityCheck;
+exports.runDiagnostics = require_diagnostics.runDiagnostics;
+exports.storageSanityCheck = require_sanity_checks.storageSanityCheck;
+exports.verifyPlugin = require_verify_plugin.verifyPlugin;

package/build/index.d.ts

@@ -0,0 +1,5 @@
+export { verifyPlugin } from './verify-plugin';
+export { authSanityCheck, storageSanityCheck, middlewareSanityCheck, filterSanityCheck, getSanityCheck, } from './sanity-checks';
+export { runDiagnostics } from './diagnostics';
+export type { VerifyPluginOptions, VerifyResult, PluginCategory, DiagnosticStep } from './types';
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,GACf,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,YAAY,EAAE,mBAAmB,EAAE,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC"}

package/build/index.js

@@ -0,0 +1,4 @@
+import { authSanityCheck, filterSanityCheck, getSanityCheck, middlewareSanityCheck, storageSanityCheck } from "./sanity-checks.js";
+import { runDiagnostics } from "./diagnostics.js";
+import { verifyPlugin } from "./verify-plugin.js";
+export { authSanityCheck, filterSanityCheck, getSanityCheck, middlewareSanityCheck, runDiagnostics, storageSanityCheck, verifyPlugin };

package/build/sanity-checks.cjs

@@ -0,0 +1,27 @@
+require("./_virtual/_rolldown/runtime.cjs");
+let _verdaccio_core = require("@verdaccio/core");
+//#region src/sanity-checks.ts
+var authSanityCheck = _verdaccio_core.pluginUtils.authSanityCheck;
+var storageSanityCheck = _verdaccio_core.pluginUtils.storageSanityCheck;
+var middlewareSanityCheck = _verdaccio_core.pluginUtils.middlewareSanityCheck;
+var filterSanityCheck = _verdaccio_core.pluginUtils.filterSanityCheck;
+/**
+* Returns the appropriate sanity check function for the given plugin category.
+*/
+function getSanityCheck(category) {
+	switch (category) {
+		case _verdaccio_core.PLUGIN_CATEGORY.AUTHENTICATION: return authSanityCheck;
+		case _verdaccio_core.PLUGIN_CATEGORY.STORAGE: return storageSanityCheck;
+		case _verdaccio_core.PLUGIN_CATEGORY.MIDDLEWARE: return middlewareSanityCheck;
+		case _verdaccio_core.PLUGIN_CATEGORY.FILTER: return filterSanityCheck;
+		default: return () => true;
+	}
+}
+//#endregion
+exports.authSanityCheck = authSanityCheck;
+exports.filterSanityCheck = filterSanityCheck;
+exports.getSanityCheck = getSanityCheck;
+exports.middlewareSanityCheck = middlewareSanityCheck;
+exports.storageSanityCheck = storageSanityCheck;
+
+//# sourceMappingURL=sanity-checks.cjs.map

package/build/sanity-checks.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanity-checks.cjs","names":[],"sources":["../src/sanity-checks.ts"],"sourcesContent":["import { PLUGIN_CATEGORY, pluginUtils } from '@verdaccio/core';\n\nimport type { PluginCategory } from './types';\n\n// Re-export sanity checks from @verdaccio/core for convenience.\nexport const authSanityCheck = pluginUtils.authSanityCheck;\nexport const storageSanityCheck = pluginUtils.storageSanityCheck;\nexport const middlewareSanityCheck = pluginUtils.middlewareSanityCheck;\nexport const filterSanityCheck = pluginUtils.filterSanityCheck;\n\n/**\n * Returns the appropriate sanity check function for the given plugin category.\n */\nexport function getSanityCheck(category: PluginCategory): (plugin: any) => boolean {\n  switch (category) {\n    case PLUGIN_CATEGORY.AUTHENTICATION:\n      return authSanityCheck;\n    case PLUGIN_CATEGORY.STORAGE:\n      return storageSanityCheck;\n    case PLUGIN_CATEGORY.MIDDLEWARE:\n      return middlewareSanityCheck;\n    case PLUGIN_CATEGORY.FILTER:\n      return filterSanityCheck;\n    default:\n      return () => true;\n  }\n}\n"],"mappings":";;;AAKA,IAAa,kBAAkB,gBAAA,YAAY;AAC3C,IAAa,qBAAqB,gBAAA,YAAY;AAC9C,IAAa,wBAAwB,gBAAA,YAAY;AACjD,IAAa,oBAAoB,gBAAA,YAAY;;;;AAK7C,SAAgB,eAAe,UAAoD;AACjF,SAAQ,UAAR;EACE,KAAK,gBAAA,gBAAgB,eACnB,QAAO;EACT,KAAK,gBAAA,gBAAgB,QACnB,QAAO;EACT,KAAK,gBAAA,gBAAgB,WACnB,QAAO;EACT,KAAK,gBAAA,gBAAgB,OACnB,QAAO;EACT,QACE,cAAa"}

package/build/sanity-checks.d.ts

@@ -0,0 +1,11 @@
+import { pluginUtils } from '@verdaccio/core';
+import { PluginCategory } from './types';
+export declare const authSanityCheck: typeof pluginUtils.authSanityCheck;
+export declare const storageSanityCheck: typeof pluginUtils.storageSanityCheck;
+export declare const middlewareSanityCheck: typeof pluginUtils.middlewareSanityCheck;
+export declare const filterSanityCheck: typeof pluginUtils.filterSanityCheck;
+/**
+ * Returns the appropriate sanity check function for the given plugin category.
+ */
+export declare function getSanityCheck(category: PluginCategory): (plugin: any) => boolean;
+//# sourceMappingURL=sanity-checks.d.ts.map

package/build/sanity-checks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanity-checks.d.ts","sourceRoot":"","sources":["../src/sanity-checks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C,eAAO,MAAM,eAAe,oCAA8B,CAAC;AAC3D,eAAO,MAAM,kBAAkB,uCAAiC,CAAC;AACjE,eAAO,MAAM,qBAAqB,0CAAoC,CAAC;AACvE,eAAO,MAAM,iBAAiB,sCAAgC,CAAC;AAE/D;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,cAAc,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,OAAO,CAajF"}

package/build/sanity-checks.js

@@ -0,0 +1,22 @@
+import { PLUGIN_CATEGORY, pluginUtils } from "@verdaccio/core";
+//#region src/sanity-checks.ts
+var authSanityCheck = pluginUtils.authSanityCheck;
+var storageSanityCheck = pluginUtils.storageSanityCheck;
+var middlewareSanityCheck = pluginUtils.middlewareSanityCheck;
+var filterSanityCheck = pluginUtils.filterSanityCheck;
+/**
+* Returns the appropriate sanity check function for the given plugin category.
+*/
+function getSanityCheck(category) {
+	switch (category) {
+		case PLUGIN_CATEGORY.AUTHENTICATION: return authSanityCheck;
+		case PLUGIN_CATEGORY.STORAGE: return storageSanityCheck;
+		case PLUGIN_CATEGORY.MIDDLEWARE: return middlewareSanityCheck;
+		case PLUGIN_CATEGORY.FILTER: return filterSanityCheck;
+		default: return () => true;
+	}
+}
+//#endregion
+export { authSanityCheck, filterSanityCheck, getSanityCheck, middlewareSanityCheck, storageSanityCheck };
+
+//# sourceMappingURL=sanity-checks.js.map

package/build/sanity-checks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanity-checks.js","names":[],"sources":["../src/sanity-checks.ts"],"sourcesContent":["import { PLUGIN_CATEGORY, pluginUtils } from '@verdaccio/core';\n\nimport type { PluginCategory } from './types';\n\n// Re-export sanity checks from @verdaccio/core for convenience.\nexport const authSanityCheck = pluginUtils.authSanityCheck;\nexport const storageSanityCheck = pluginUtils.storageSanityCheck;\nexport const middlewareSanityCheck = pluginUtils.middlewareSanityCheck;\nexport const filterSanityCheck = pluginUtils.filterSanityCheck;\n\n/**\n * Returns the appropriate sanity check function for the given plugin category.\n */\nexport function getSanityCheck(category: PluginCategory): (plugin: any) => boolean {\n  switch (category) {\n    case PLUGIN_CATEGORY.AUTHENTICATION:\n      return authSanityCheck;\n    case PLUGIN_CATEGORY.STORAGE:\n      return storageSanityCheck;\n    case PLUGIN_CATEGORY.MIDDLEWARE:\n      return middlewareSanityCheck;\n    case PLUGIN_CATEGORY.FILTER:\n      return filterSanityCheck;\n    default:\n      return () => true;\n  }\n}\n"],"mappings":";;AAKA,IAAa,kBAAkB,YAAY;AAC3C,IAAa,qBAAqB,YAAY;AAC9C,IAAa,wBAAwB,YAAY;AACjD,IAAa,oBAAoB,YAAY;;;;AAK7C,SAAgB,eAAe,UAAoD;AACjF,SAAQ,UAAR;EACE,KAAK,gBAAgB,eACnB,QAAO;EACT,KAAK,gBAAgB,QACnB,QAAO;EACT,KAAK,gBAAgB,WACnB,QAAO;EACT,KAAK,gBAAgB,OACnB,QAAO;EACT,QACE,cAAa"}