openclaw
Version:
Multi-channel AI gateway with extensible messaging integrations
120 lines (119 loc) • 6.14 kB
JavaScript
import { p as resolveUserPath } from "./utils-CCC-BEJH.js";
import { n as resolveBundledPluginsDir, t as areBundledPluginsDisabled } from "./bundled-dir-CG-NYRXR.js";
import fs from "node:fs";
import path from "node:path";
//#region src/plugins/public-surface-runtime.ts
const PUBLIC_SURFACE_SOURCE_EXTENSIONS = [
".ts",
".mts",
".js",
".mjs",
".cts",
".cjs"
];
/** Normalizes a bundled public artifact subpath and rejects traversal/absolute paths. */
function normalizeBundledPluginArtifactSubpath(artifactBasename) {
if (path.posix.isAbsolute(artifactBasename) || path.win32.isAbsolute(artifactBasename) || artifactBasename.includes("\\")) throw new Error(`Bundled plugin artifact path must stay plugin-local: ${artifactBasename}`);
const normalized = artifactBasename.replace(/^\.\//u, "");
if (!normalized) throw new Error("Bundled plugin artifact path must not be empty");
if (normalized.split("/").some((segment) => segment.length === 0 || segment === "." || segment === ".." || segment.includes(":"))) throw new Error(`Bundled plugin artifact path must stay plugin-local: ${artifactBasename}`);
return normalized;
}
/** Normalizes a bundled plugin directory name and rejects path-like values. */
function normalizeBundledPluginDirName(dirName) {
const normalized = dirName.trim();
if (!normalized || normalized === "." || normalized === ".." || normalized.includes("/") || normalized.includes("\\") || normalized.includes(":")) throw new Error(`Bundled plugin dirName must be a single directory: ${dirName}`);
return normalized;
}
/** Resolves a source-tree public surface artifact path for bundled plugin development. */
function resolveBundledPluginSourcePublicSurfacePath(params) {
const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename);
const dirName = normalizeBundledPluginDirName(params.dirName);
const sourceBaseName = artifactBasename.replace(/\.js$/u, "");
for (const ext of PUBLIC_SURFACE_SOURCE_EXTENSIONS) {
const sourceCandidate = path.resolve(params.sourceRoot, dirName, `${sourceBaseName}${ext}`);
if (fs.existsSync(sourceCandidate)) return sourceCandidate;
}
return null;
}
function resolvePackageFallbackForBundledDir(params) {
const normalizedBundledDir = path.resolve(params.bundledPluginsDir);
const normalizedRootDir = path.resolve(params.rootDir);
const packageBundledDirs = [path.join(normalizedRootDir, "dist", "extensions"), path.join(normalizedRootDir, "dist-runtime", "extensions")];
if (!packageBundledDirs.includes(normalizedBundledDir)) return null;
for (const packageBundledDir of packageBundledDirs) {
if (packageBundledDir === normalizedBundledDir) continue;
const builtCandidate = path.join(packageBundledDir, params.dirName, params.artifactBasename);
if (fs.existsSync(builtCandidate)) return builtCandidate;
}
return resolveBundledPluginSourcePublicSurfacePath({
sourceRoot: path.join(normalizedRootDir, "extensions"),
dirName: params.dirName,
artifactBasename: params.artifactBasename
});
}
function sameExistingPath(left, right) {
try {
return fs.realpathSync.native(left) === fs.realpathSync.native(right);
} catch {
return false;
}
}
function resolveExplicitEnvBundledPluginsDir(env) {
const envOverride = env.OPENCLAW_BUNDLED_PLUGINS_DIR?.trim();
if (!envOverride) return;
const bundledPluginsDir = resolveBundledPluginsDir(env);
if (!bundledPluginsDir) return;
return sameExistingPath(resolveUserPath(envOverride, env), bundledPluginsDir) ? bundledPluginsDir : void 0;
}
function resolvePublicSurfaceFromBundledDir(params) {
const pluginDir = path.resolve(params.bundledPluginsDir, params.dirName);
const builtCandidate = path.join(pluginDir, params.artifactBasename);
if (fs.existsSync(builtCandidate)) return builtCandidate;
const packageLocalBuiltCandidate = path.join(pluginDir, "dist", params.artifactBasename);
if (fs.existsSync(packageLocalBuiltCandidate)) return packageLocalBuiltCandidate;
return resolveBundledPluginSourcePublicSurfacePath({
sourceRoot: params.bundledPluginsDir,
dirName: params.dirName,
artifactBasename: params.artifactBasename
}) ?? resolvePackageFallbackForBundledDir({
rootDir: params.rootDir,
bundledPluginsDir: params.bundledPluginsDir,
dirName: params.dirName,
artifactBasename: params.artifactBasename
});
}
/** Resolves a bundled plugin public surface artifact across source, dist, and package layouts. */
function resolveBundledPluginPublicSurfacePath(params) {
const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename);
const dirName = normalizeBundledPluginDirName(params.dirName);
const env = params.env ?? process.env;
const explicitBundledPluginsDir = params.bundledPluginsDirMode === "auto" ? resolveExplicitEnvBundledPluginsDir(env) : params.bundledPluginsDir ?? resolveExplicitEnvBundledPluginsDir(env);
if (explicitBundledPluginsDir) return resolvePublicSurfaceFromBundledDir({
rootDir: params.rootDir,
bundledPluginsDir: explicitBundledPluginsDir,
dirName,
artifactBasename
});
if (areBundledPluginsDisabled(env)) return null;
const sourceCandidate = resolveBundledPluginSourcePublicSurfacePath({
sourceRoot: path.resolve(params.rootDir, "extensions"),
dirName,
artifactBasename
});
if (sourceCandidate) return sourceCandidate;
const bundledPluginsDir = params.bundledPluginsDirMode === "auto" ? params.bundledPluginsDir : resolveBundledPluginsDir(env);
if (bundledPluginsDir) {
const bundledCandidate = resolvePublicSurfaceFromBundledDir({
rootDir: params.rootDir,
bundledPluginsDir,
dirName,
artifactBasename
});
if (bundledCandidate) return bundledCandidate;
}
for (const candidate of [path.resolve(params.rootDir, "dist", "extensions", dirName, artifactBasename), path.resolve(params.rootDir, "dist-runtime", "extensions", dirName, artifactBasename)]) if (fs.existsSync(candidate)) return candidate;
return null;
}
//#endregion
export { resolveBundledPluginSourcePublicSurfacePath as a, resolveBundledPluginPublicSurfacePath as i, normalizeBundledPluginArtifactSubpath as n, normalizeBundledPluginDirName as r, PUBLIC_SURFACE_SOURCE_EXTENSIONS as t };