openclaw
Version:
Multi-channel AI gateway with extensible messaging integrations
138 lines (137 loc) • 7.19 kB
JavaScript
import { c as resolveUserPath } from "./home-dir-BPhrG-aM.js";
import "./utils-P__uGsPB.js";
import { a as pluginCacheRealpathSync, r as pluginCacheExistsSync } from "./plugin-cache-files-DLPF_Tw2.js";
import { i as resolveBundledPluginsDir, t as areBundledPluginsDisabled } from "./bundled-dir-BEfbEeCF.js";
import { t as resolvePluginRootArtifactPath } from "./root-artifact-path-BqN5KCyd.js";
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 (pluginCacheExistsSync(sourceCandidate)) return sourceCandidate;
}
return null;
}
/** Resolves a public surface artifact within one installed plugin root. */
function resolvePluginRootPublicSurfacePath(params) {
const artifactBasename = normalizeBundledPluginArtifactSubpath(params.artifactBasename);
const pluginRoot = path.resolve(params.pluginRoot);
const builtCandidate = resolvePluginRootArtifactPath(pluginRoot, [artifactBasename, path.join("dist", artifactBasename)]);
if (builtCandidate) return builtCandidate;
const sourceBaseName = artifactBasename.replace(/\.js$/u, "");
for (const ext of PUBLIC_SURFACE_SOURCE_EXTENSIONS) {
const candidate = path.join(pluginRoot, `${sourceBaseName}${ext}`);
if (pluginCacheExistsSync(candidate)) return candidate;
}
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 (pluginCacheExistsSync(builtCandidate)) return builtCandidate;
}
return resolveRetainedConfigDoctorPath(params) ?? resolveBundledPluginSourcePublicSurfacePath({
sourceRoot: path.join(normalizedRootDir, "extensions"),
dirName: params.dirName,
artifactBasename: params.artifactBasename
});
}
function resolveRetainedConfigDoctorPath(params) {
if (params.artifactBasename !== "config-doctor-api.js") return null;
for (const dist of ["dist", "dist-runtime"]) {
const candidate = path.resolve(params.rootDir, dist, "config-doctor", `${params.dirName}.js`);
if (pluginCacheExistsSync(candidate)) return candidate;
}
return null;
}
function sameExistingPath(left, right) {
const canonicalLeft = pluginCacheRealpathSync(left);
return canonicalLeft !== null && canonicalLeft === pluginCacheRealpathSync(right);
}
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) {
return resolvePluginRootPublicSurfacePath({
pluginRoot: path.resolve(params.bundledPluginsDir, 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 (pluginCacheExistsSync(candidate)) return candidate;
return resolveRetainedConfigDoctorPath({
...params,
dirName,
artifactBasename
});
}
//#endregion
export { resolvePluginRootPublicSurfacePath as a, resolveBundledPluginSourcePublicSurfacePath as i, normalizeBundledPluginArtifactSubpath as n, resolveBundledPluginPublicSurfacePath as r, PUBLIC_SURFACE_SOURCE_EXTENSIONS as t };