UNPKG

openclaw

Version:

Multi-channel AI gateway with extensible messaging integrations

120 lines (119 loc) 6.14 kB
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 };