@jmfederico/pi-web 1.202608.0 → 1.202608.2

package/dist/server/piWebPluginLifecycle.js

@@ -0,0 +1,162 @@
+import { PI_WEB_PLUGIN_LIFECYCLE_VERSION, } from "../shared/apiTypes.js";
+import { PI_WEB_PLUGIN_RECOVERY_COMMANDS, pluginDisableRecoveryCommand } from "../shared/pluginRecoveryCommands.js";
+/** Pure desired/active reconciliation shared by the manifest and diagnostics API. */
+export function reconcilePiWebPluginLifecycle(desired, runtime, browserModuleUrl, desiredSafeStart) {
+    const activeSnapshot = runtime.status === "available" ? runtime.snapshot : undefined;
+    const desiredById = new Map(desired.plugins.map((plugin) => [plugin.id, plugin]));
+    const recordsById = new Map(activeSnapshot?.records.map((record) => [record.pluginId, record]) ?? []);
+    const healthById = new Map(activeSnapshot?.health.map((inspection) => [inspection.pluginId, inspection]) ?? []);
+    const diagnostics = publicDiagnostics(desired.diagnostics, activeSnapshot?.diagnostics ?? []);
+    const conflictIds = new Set(diagnostics.flatMap((diagnostic) => diagnostic.kind === "conflict" && diagnostic.pluginId !== undefined ? [diagnostic.pluginId] : []));
+    const pluginIds = new Set([...desiredById.keys(), ...recordsById.keys()]);
+    const browserPlugins = [];
+    const activeSafeStart = activeSnapshot?.safeStart ?? "off";
+    const effectiveDesiredSafeStart = desiredSafeStart ?? activeSafeStart;
+    const plugins = [...pluginIds]
+        .sort((left, right) => left.localeCompare(right))
+        .map((pluginId) => {
+        const plugin = desiredById.get(pluginId);
+        const record = recordsById.get(pluginId);
+        const server = plugin?.serverModule !== undefined || record !== undefined
+            ? serverInfo(pluginId, plugin, record, healthById.get(pluginId), runtime.status, activeSafeStart, effectiveDesiredSafeStart)
+            : undefined;
+        if (plugin?.browserModule !== undefined && shouldPublishBrowserPlugin(plugin, server)) {
+            browserPlugins.push({
+                plugin,
+                ...(server?.activeRevision === undefined ? {} : { backendRevision: server.activeRevision }),
+            });
+        }
+        if (plugin !== undefined) {
+            return {
+                id: plugin.id,
+                ...(plugin.browserModule === undefined ? {} : { module: browserModuleUrl(plugin) }),
+                source: plugin.source,
+                scope: plugin.scope,
+                machineSpecific: plugin.machineSpecific,
+                enabled: plugin.enabled,
+                discovered: true,
+                conflict: conflictIds.has(plugin.id),
+                ...(server === undefined ? {} : { server }),
+            };
+        }
+        if (record === undefined || server === undefined)
+            throw new Error(`Missing active server plugin record: ${pluginId}`);
+        return {
+            id: record.pluginId,
+            source: record.source,
+            scope: record.scope,
+            machineSpecific: record.machineSpecific,
+            enabled: false,
+            discovered: false,
+            conflict: conflictIds.has(record.pluginId),
+            server,
+        };
+    });
+    const safeStartRestartRequired = desiredSafeStart === undefined
+        ? false
+        : runtime.status === "available"
+            ? desiredSafeStart !== (activeSnapshot?.safeStart ?? "off")
+            : desiredSafeStart !== "off";
+    const restartRequired = safeStartRestartRequired || plugins.some((plugin) => plugin.server?.restartRequired === true);
+    return {
+        response: {
+            lifecycleVersion: PI_WEB_PLUGIN_LIFECYCLE_VERSION,
+            plugins,
+            diagnostics,
+            serverRuntime: {
+                status: runtime.status,
+                ...(activeSnapshot?.safeStart === undefined ? {} : { safeStart: activeSnapshot.safeStart }),
+                ...(desiredSafeStart === undefined ? {} : { desiredSafeStart }),
+                restartRequired,
+                ...(runtime.status === "available" ? {} : { message: runtime.message }),
+                recovery: PI_WEB_PLUGIN_RECOVERY_COMMANDS,
+            },
+        },
+        browserPlugins: Object.freeze(browserPlugins),
+    };
+}
+function serverInfo(pluginId, desired, active, health, runtimeStatus, activeSafeStart, desiredSafeStart) {
+    const staleRevision = revisionsAreStale(desired, active);
+    const state = runtimeStatus !== "available"
+        ? "unknown"
+        : active?.state ?? (desired !== undefined && !serverEnabledForSafeStart(desired, activeSafeStart) ? "disabled" : "missing");
+    const restartRequired = runtimeStatus === "available" && serverRestartRequired(desired, active, staleRevision, desiredSafeStart);
+    const phase = active?.phase ?? health?.phase;
+    const message = active?.message ?? health?.error;
+    return {
+        state,
+        ...(desired?.serverModule === undefined ? {} : { desiredRevision: desired.serverModule.revision }),
+        ...(active === undefined ? {} : { activeRevision: active.moduleRevision }),
+        ...(phase === undefined ? {} : { phase }),
+        ...(message === undefined ? {} : { message }),
+        ...(health === undefined ? {} : {
+            health: {
+                status: health.health.status,
+                ...(health.health.message === undefined ? {} : { message: health.health.message }),
+            },
+        }),
+        staleRevision,
+        restartRequired,
+        disableCommand: pluginDisableRecoveryCommand(pluginId),
+    };
+}
+function serverRestartRequired(desired, active, staleRevision, desiredSafeStart) {
+    if (desired === undefined) {
+        if (active === undefined)
+            return false;
+        return active.state !== "disabled";
+    }
+    const shouldBeActive = serverEnabledForSafeStart(desired, desiredSafeStart);
+    if (active === undefined)
+        return shouldBeActive;
+    if (!shouldBeActive)
+        return active.state !== "disabled";
+    if (staleRevision)
+        return true;
+    return active.state !== "active";
+}
+function serverEnabledForSafeStart(plugin, safeStart) {
+    return plugin.enabled
+        && safeStart !== "none"
+        && (safeStart !== "bundled-only" || plugin.scope === "bundled");
+}
+function shouldPublishBrowserPlugin(plugin, server) {
+    if (plugin.browserModule === undefined)
+        return false;
+    if (server === undefined)
+        return plugin.enabled;
+    if (plugin.serverModule === undefined)
+        return false;
+    return server.state === "active"
+        && !server.staleRevision
+        && server.health?.status !== "unhealthy";
+}
+function revisionsAreStale(desired, active) {
+    if (desired === undefined)
+        return false;
+    if (active === undefined)
+        return false;
+    const browserRevision = desired.browserModule?.revision;
+    return desired.serverModule?.revision !== active.moduleRevision
+        || (browserRevision !== undefined && browserRevision !== active.browserRevision)
+        || desired.settingsRevision !== active.settingsRevision
+        || desired.source !== active.source
+        || desired.scope !== active.scope
+        || desired.machineSpecific !== active.machineSpecific;
+}
+function publicDiagnostics(desired, active) {
+    return [
+        ...desired.map((diagnostic) => publicDiagnostic(diagnostic, "desired")),
+        ...active.map((diagnostic) => publicDiagnostic(diagnostic, "active")),
+    ];
+}
+function publicDiagnostic(diagnostic, snapshot) {
+    return {
+        kind: diagnostic.code === "duplicate-id" ? "conflict" : "discovery",
+        snapshot,
+        source: diagnostic.source,
+        message: diagnostic.message,
+        ...(diagnostic.pluginId === undefined ? {} : { pluginId: diagnostic.pluginId }),
+    };
+}
+//# sourceMappingURL=piWebPluginLifecycle.js.map

package/dist/server/piWebPluginLifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"piWebPluginLifecycle.js","sourceRoot":"","sources":["../../src/server/piWebPluginLifecycle.ts"],"names":[],"mappings":"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"}

package/dist/server/piWebPluginService.js

@@ -1,156 +1,184 @@
-import { existsSync } from "node:fs";
-import { readdir, readFile, realpath, stat } from "node:fs/promises";
-import { dirname, join, relative, resolve, sep } from "node:path";
-import { fileURLToPath } from "node:url";
-import { DefaultPackageManager, SettingsManager } from "@earendil-works/pi-coding-agent";
-import { loadPiWebConfig, piWebDataDir } from "../config.js";
+import { PI_WEB_PLUGIN_LIFECYCLE_VERSION } from "../shared/apiTypes.js";
 import { isPiWebPluginId } from "../shared/pluginIds.js";
-export class DefaultPiPackageProvider {
-    constructor(cwd, agentDir) {
-        this.cwd = cwd;
-        this.agentDir = agentDir;
-    }
-    listPackages() {
-        return this.createPackageManager().listConfiguredPackages();
-    }
-    getInstalledPath(source, scope) {
-        return this.createPackageManager().getInstalledPath(source, scope);
-    }
-    createPackageManager() {
-        return new DefaultPackageManager({
-            cwd: this.cwd,
-            agentDir: this.agentDir,
-            settingsManager: SettingsManager.create(this.cwd, this.agentDir),
-        });
-    }
-}
+import { PiWebPluginCatalog, readPiWebPluginPackageArtifact, } from "./piWebPluginCatalog.js";
+import { reconcilePiWebPluginLifecycle } from "./piWebPluginLifecycle.js";
+import { WorkspaceCatalogProtocolError } from "./workspaces/workspaceCatalog.js";
+export { DefaultPiPackageProvider, PiWebPluginCatalog, } from "./piWebPluginCatalog.js";
+const BROWSER_ARTIFACT_CACHE_MAX_ENTRIES = 32;
+const BROWSER_ARTIFACT_CACHE_MAX_BYTES = 64 * 1024 * 1024;
+/** Browser manifest and asset adapter over the process-neutral package catalog. */
 export class PiWebPluginService {
     constructor(options = {}) {
-        const cwd = options.cwd ?? process.cwd();
-        this.roots = options.roots ?? defaultPluginRoots(cwd);
-        this.agentDir = options.agentDir;
-        this.agentDirProvider = options.agentDirProvider;
-        const packageProvider = options.packageProvider;
-        this.staticPackageProvider = packageProvider === false || packageProvider === undefined ? undefined : packageProvider;
-        this.packageProviderForAgentDir = packageProvider === false || packageProvider !== undefined
-            ? undefined
-            : (agentDir) => new DefaultPiPackageProvider(cwd, agentDir);
-        this.configProvider = options.configProvider ?? (() => loadPiWebConfig({ cwd }).config);
+        this.browserArtifacts = new Map();
+        this.browserArtifactBytes = 0;
+        this.catalog = options.catalog ?? new PiWebPluginCatalog(options);
+        this.runtimeProvider = options.runtimeProvider;
+        this.recoveryProvider = options.recoveryProvider;
     }
     async manifest() {
-        return {
-            plugins: (await this.plugins()).plugins
-                .filter((plugin) => plugin.enabled)
-                .map((plugin) => ({ id: plugin.id, module: plugin.module, source: plugin.source, scope: plugin.scope, machineSpecific: plugin.machineSpecific })),
-        };
+        const lifecycle = await this.lifecycle();
+        const plugins = [];
+        for (const { plugin, backendRevision } of lifecycle.browserPlugins) {
+            const artifact = await this.captureBrowserArtifact(plugin, backendRevision);
+            if (artifact === undefined)
+                continue;
+            plugins.push({
+                id: plugin.id,
+                module: browserModuleUrl(plugin),
+                ...(backendRevision === undefined ? {} : { backendRevision }),
+                source: plugin.source,
+                scope: plugin.scope,
+                machineSpecific: plugin.machineSpecific,
+            });
+        }
+        return { lifecycleVersion: PI_WEB_PLUGIN_LIFECYCLE_VERSION, plugins };
     }
     async plugins() {
-        const config = await this.configProvider();
-        const plugins = await this.discoverPlugins();
-        return { plugins: plugins.map((plugin) => this.pluginInfo(plugin, config)) };
+        return (await this.lifecycle()).response;
     }
-    async readAsset(pluginId, assetPath) {
+    async readAsset(pluginId, assetPath, browserRevision) {
         if (!isPiWebPluginId(pluginId))
             return undefined;
-        const plugin = await this.findPlugin(pluginId);
-        if (plugin === undefined)
+        let artifact = this.browserArtifacts.get(pluginId);
+        if (artifact !== undefined && !await this.cachedArtifactIsActive(artifact))
+            artifact = undefined;
+        artifact ??= await this.loadBrowserArtifact(pluginId);
+        if (artifact === undefined)
             return undefined;
-        const resolved = resolve(plugin.root, assetPath);
-        const [realRoot, realAsset] = await Promise.all([
-            realpath(plugin.root),
-            realpath(resolved).catch(() => undefined),
-        ]);
-        if (realAsset === undefined || !isWithin(realRoot, realAsset))
+        if (browserRevision !== undefined && assetPath === artifact.entryPath && artifact.revision !== browserRevision)
             return undefined;
-        const assetStat = await stat(realAsset).catch(() => undefined);
-        if (assetStat?.isFile() !== true)
+        const content = artifact.files.get(assetPath);
+        if (content === undefined)
             return undefined;
-        return { content: await readFile(realAsset), contentType: contentTypeFor(realAsset) };
-    }
-    pluginInfo(plugin, config) {
-        return {
-            id: plugin.id,
-            module: `/pi-web-plugins/${encodeURIComponent(plugin.id)}/${plugin.entryFile}?${pluginModuleQuery(plugin)}`,
-            source: plugin.source,
-            scope: plugin.scope,
-            machineSpecific: plugin.machineSpecific,
-            enabled: config.plugins?.[plugin.id]?.enabled !== false,
-        };
+        this.touchBrowserArtifact(artifact);
+        return { content, contentType: contentTypeFor(assetPath) };
     }
-    async discoverPlugins() {
-        const records = new Map();
-        for (const plugin of await this.discoverLocalPlugins())
-            addUnique(records, plugin);
-        const packageProvider = await this.currentPackageProvider();
-        if (packageProvider !== undefined) {
-            for (const plugin of await this.discoverPiPackagePlugins(packageProvider))
-                addUnique(records, plugin);
+    async loadBrowserArtifact(pluginId) {
+        try {
+            const lifecycle = await this.lifecycle();
+            const browserPlugin = lifecycle.browserPlugins.find(({ plugin }) => plugin.id === pluginId);
+            if (browserPlugin === undefined)
+                return undefined;
+            return await this.captureBrowserArtifact(browserPlugin.plugin, browserPlugin.backendRevision);
+        }
+        catch (error) {
+            const localPlugin = await this.catalog.browserPlugin(pluginId);
+            if (localPlugin?.serverModule !== undefined)
+                throw error;
+            return localPlugin === undefined ? undefined : await this.captureBrowserArtifact(localPlugin);
         }
-        return [...records.values()].sort((left, right) => left.id.localeCompare(right.id));
     }
-    async findPlugin(pluginId) {
-        const localPlugin = (await this.discoverLocalPlugins()).find((candidate) => candidate.id === pluginId);
-        if (localPlugin !== undefined)
-            return localPlugin;
-        const packageProvider = await this.currentPackageProvider();
-        if (packageProvider === undefined)
+    async captureBrowserArtifact(plugin, backendRevision) {
+        const module = plugin.browserModule;
+        if (module === undefined)
             return undefined;
-        const records = new Map();
-        for (const plugin of await this.discoverPiPackagePlugins(packageProvider))
-            addUnique(records, plugin);
-        return records.get(pluginId);
-    }
-    async currentPackageProvider() {
-        if (this.staticPackageProvider !== undefined)
-            return this.staticPackageProvider;
-        if (this.packageProviderForAgentDir === undefined)
+        const browserRoot = plugin.browserRoot;
+        if (browserRoot === undefined)
+            throw new Error(`PI WEB plugin has no browser root: ${plugin.id}`);
+        const cached = this.browserArtifacts.get(plugin.id);
+        if (cached !== undefined) {
+            const matches = cached.revision === module.revision
+                && cached.entryPath === module.path
+                && cached.entryFilePath === module.filePath
+                && cached.browserRootPath === browserRoot.path
+                && cached.browserRootDirectoryPath === browserRoot.directoryPath
+                && cached.packageRoot === plugin.packageRoot
+                && cached.backendRevision === backendRevision;
+            if (matches) {
+                this.touchBrowserArtifact(cached);
+                return cached;
+            }
+        }
+        const packageArtifact = await readPiWebPluginPackageArtifact(plugin.packageRoot, browserRoot).catch(() => undefined);
+        if (packageArtifact?.revision !== module.revision || !packageArtifact.files.has(module.path))
             return undefined;
-        return this.packageProviderForAgentDir(await this.currentAgentDir());
-    }
-    async currentAgentDir() {
-        if (this.agentDirProvider !== undefined)
-            return await this.agentDirProvider();
-        if (this.agentDir !== undefined)
-            return this.agentDir;
-        throw new Error("Pi package plugin discovery requires an explicit active agent directory");
-    }
-    async discoverLocalPlugins() {
-        const plugins = [];
-        for (const root of this.roots)
-            plugins.push(...await discoverLocalRoot(root));
-        return plugins;
+        const artifact = {
+            pluginId: plugin.id,
+            revision: module.revision,
+            entryPath: module.path,
+            entryFilePath: module.filePath,
+            browserRootPath: browserRoot.path,
+            browserRootDirectoryPath: browserRoot.directoryPath,
+            packageRoot: plugin.packageRoot,
+            ...(backendRevision === undefined ? {} : { backendRevision }),
+            files: packageArtifact.files,
+            byteLength: packageArtifact.byteLength,
+        };
+        this.cacheBrowserArtifact(artifact);
+        return artifact;
+    }
+    async cachedArtifactIsActive(artifact) {
+        if (artifact.backendRevision === undefined)
+            return true;
+        const runtime = await this.loadRuntime();
+        if (runtime.status !== "available")
+            return false;
+        const record = runtime.snapshot.records.find(({ pluginId }) => pluginId === artifact.pluginId);
+        const health = runtime.snapshot.health.find(({ pluginId }) => pluginId === artifact.pluginId);
+        return record?.state === "active"
+            && record.moduleRevision === artifact.backendRevision
+            && record.browserRevision === artifact.revision
+            && health?.health.status !== "unhealthy";
+    }
+    cacheBrowserArtifact(artifact) {
+        const current = this.browserArtifacts.get(artifact.pluginId);
+        if (current !== undefined) {
+            this.browserArtifacts.delete(artifact.pluginId);
+            this.browserArtifactBytes -= current.byteLength;
+        }
+        while (this.browserArtifacts.size >= BROWSER_ARTIFACT_CACHE_MAX_ENTRIES
+            || this.browserArtifactBytes + artifact.byteLength > BROWSER_ARTIFACT_CACHE_MAX_BYTES) {
+            const oldest = this.browserArtifacts.values().next().value;
+            if (oldest === undefined)
+                break;
+            this.browserArtifacts.delete(oldest.pluginId);
+            this.browserArtifactBytes -= oldest.byteLength;
+        }
+        this.browserArtifacts.set(artifact.pluginId, artifact);
+        this.browserArtifactBytes += artifact.byteLength;
+    }
+    touchBrowserArtifact(artifact) {
+        if (this.browserArtifacts.get(artifact.pluginId) !== artifact)
+            return;
+        this.browserArtifacts.delete(artifact.pluginId);
+        this.browserArtifacts.set(artifact.pluginId, artifact);
+    }
+    async lifecycle() {
+        const desired = await this.catalog.snapshot();
+        const [runtime, desiredSafeStart] = await Promise.all([this.loadRuntime(), this.loadDesiredSafeStart()]);
+        return reconcilePiWebPluginLifecycle(desired, runtime, browserModuleUrl, desiredSafeStart);
+    }
+    async loadDesiredSafeStart() {
+        if (this.recoveryProvider === undefined)
+            return undefined;
+        return (await this.recoveryProvider()).safeStart ?? "off";
     }
-    async discoverPiPackagePlugins(packageProvider) {
-        const plugins = [];
-        for (const configuredPackage of packageProvider.listPackages()) {
-            const root = configuredPackage.installedPath ?? packageProvider.getInstalledPath(configuredPackage.source, configuredPackage.scope);
-            if (root === undefined)
-                continue;
-            try {
-                plugins.push(...await discoverPackageRoot(root, configuredPackage));
-            }
-            catch (error) {
-                warnInvalidPlugin(configuredPackage.source, error);
-            }
+    async loadRuntime() {
+        if (this.runtimeProvider === undefined) {
+            return { status: "unavailable", message: "Session daemon server-plugin runtime is unavailable" };
+        }
+        try {
+            return { status: "available", snapshot: await this.runtimeProvider.providerRuntime() };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                status: error instanceof WorkspaceCatalogProtocolError ? "incompatible" : "unavailable",
+                message,
+            };
         }
-        return plugins;
     }
 }
-function defaultPluginRoots(cwd) {
-    const moduleDir = dirname(fileURLToPath(import.meta.url));
-    const packageRoot = join(moduleDir, "..", "..");
-    return [
-        { path: bundledPluginRoot(packageRoot), source: "bundled", scope: "bundled" },
-        ...sourceCheckoutPluginRoots(cwd),
-        { path: join(piWebDataDir(), "plugins"), source: "local", scope: "local" },
-    ];
+function browserModuleUrl(plugin) {
+    const browserModule = plugin.browserModule;
+    if (browserModule === undefined)
+        throw new Error(`PI WEB plugin has no browser module: ${plugin.id}`);
+    const path = browserModule.path.split("/").map((segment) => encodeURIComponent(segment)).join("/");
+    return `/pi-web-plugins/${encodeURIComponent(plugin.id)}/${path}?${pluginModuleQuery(plugin.id, browserModule.revision)}`;
 }
-function bundledPluginRoot(packageRoot) {
-    return join(packageRoot, "dist", "pi-web-plugins");
-}
-function pluginModuleQuery(plugin) {
-    const params = new URLSearchParams({ v: plugin.version });
-    const dockerMode = plugin.id === "updates" ? dockerModeFromEnv() : undefined;
+function pluginModuleQuery(pluginId, revision) {
+    const params = new URLSearchParams({ v: revision });
+    const dockerMode = pluginId === "updates" ? dockerModeFromEnv() : undefined;
     if (dockerMode !== undefined)
         params.set("piWebDockerMode", dockerMode);
     return params.toString();
@@ -179,136 +207,9 @@ function isTruthyEnv(key) {
     const value = process.env[key];
     return value !== undefined && value !== "" && value !== "0" && value.toLowerCase() !== "false";
 }
-function sourceCheckoutPluginRoots(cwd) {
-    const pluginsRoot = join(cwd, "plugins");
-    if (!existsSync(join(cwd, "src", "server", "index.ts")) || !existsSync(pluginsRoot))
-        return [];
-    return [{ path: pluginsRoot, source: "dev", scope: "local" }];
-}
-async function discoverLocalRoot(root) {
-    if (!existsSync(root.path))
-        return [];
-    const entries = await readdir(root.path, { withFileTypes: true }).catch(() => []);
-    const plugins = [];
-    for (const entry of entries) {
-        if (!isPiWebPluginId(entry.name))
-            continue;
-        const pluginRoot = join(root.path, entry.name);
-        const pluginStat = entry.isDirectory() ? undefined : entry.isSymbolicLink() ? await stat(pluginRoot).catch(() => undefined) : undefined;
-        if (!entry.isDirectory() && pluginStat?.isDirectory() !== true)
-            continue;
-        try {
-            plugins.push(...await discoverLocalPlugin(pluginRoot, root));
-        }
-        catch (error) {
-            warnInvalidPlugin(pluginRoot, error);
-        }
-    }
-    return plugins;
-}
-async function discoverLocalPlugin(root, localRoot) {
-    const config = await readPiWebPackageConfig(root);
-    if (config === undefined)
-        return [];
-    const plugins = await discoverPluginEntries(root, config);
-    return plugins.map((plugin) => ({ ...plugin, source: localRoot.source, scope: localRoot.scope }));
-}
-async function discoverPackageRoot(root, configuredPackage) {
-    const config = await readPiWebPackageConfig(root);
-    if (config === undefined)
-        return [];
-    const plugins = await discoverPluginEntries(root, config);
-    return plugins.map((plugin) => ({ ...plugin, source: configuredPackage.source, scope: configuredPackage.scope }));
-}
-async function discoverPluginEntries(root, config) {
-    const plugins = [];
-    for (const entry of config.plugins) {
-        if (!isSafeRelativePath(entry.module))
-            throw new Error(`Unsafe PI WEB plugin module path for ${entry.id}: ${entry.module}`);
-        const entryPath = join(root, entry.module);
-        const entryStat = await stat(entryPath).catch(() => undefined);
-        if (entryStat?.isFile() !== true)
-            throw new Error(`PI WEB plugin module not found for ${entry.id}: ${entry.module}`);
-        plugins.push({ id: entry.id, root, entryFile: entry.module, version: String(Math.floor(entryStat.mtimeMs)), machineSpecific: entry.machineSpecific });
-    }
-    return plugins;
-}
-async function readPiWebPackageConfig(root) {
-    const packagePath = join(root, "package.json");
-    const content = await readFile(packagePath, "utf8").catch(() => undefined);
-    if (content === undefined)
-        return undefined;
-    const parsed = JSON.parse(content);
-    if (!isRecord(parsed))
-        return undefined;
-    const piWeb = parsed["piWeb"];
-    if (!isRecord(piWeb))
-        return undefined;
-    const plugins = parsePluginEntries(piWeb, packagePath);
-    if (plugins.length === 0)
-        return undefined;
-    return { plugins };
-}
-function parsePluginEntries(piWeb, packagePath) {
-    if (piWeb["plugin"] !== undefined)
-        throw new Error(`Unsupported PI WEB plugin metadata in ${packagePath}: use piWeb.plugins with { id, module, machineSpecific? } entries`);
-    const plugins = piWeb["plugins"];
-    if (plugins === undefined)
-        return [];
-    if (!Array.isArray(plugins))
-        throw new Error(`PI WEB plugins must be an array in ${packagePath}`);
-    return plugins.map((entry, index) => {
-        if (!isRecord(entry))
-            throw new Error(`PI WEB plugin entry ${String(index + 1)} must be an object in ${packagePath}`);
-        const id = entry["id"];
-        const module = entry["module"];
-        if (typeof id !== "string" || !isPiWebPluginId(id))
-            throw new Error(`Invalid PI WEB plugin id in ${packagePath}: ${String(id)}`);
-        if (typeof module !== "string" || module === "")
-            throw new Error(`Invalid PI WEB plugin module for ${id} in ${packagePath}`);
-        return { id, module, machineSpecific: parseMachineSpecific(entry["machineSpecific"], packagePath, id) };
-    });
-}
-function parseMachineSpecific(value, packagePath, pluginId) {
-    if (value === undefined)
-        return false;
-    if (typeof value !== "boolean")
-        throw new Error(`Invalid PI WEB plugin machineSpecific value for ${pluginId} in ${packagePath}: ${formatUnknownValue(value)}`);
-    return value;
-}
-function formatUnknownValue(value) {
-    if (typeof value === "string")
-        return value;
-    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint" || typeof value === "symbol" || typeof value === "function" || value === null || value === undefined)
-        return String(value);
-    try {
-        return JSON.stringify(value);
-    }
-    catch {
-        return Object.prototype.toString.call(value);
-    }
-}
-function addUnique(records, plugin) {
-    if (records.has(plugin.id)) {
-        warnInvalidPlugin(plugin.source, `Duplicate PI WEB plugin id: ${plugin.id}`);
-        return;
-    }
-    records.set(plugin.id, plugin);
-}
-function warnInvalidPlugin(source, error) {
-    const message = error instanceof Error ? error.message : String(error);
-    console.warn(`Skipping PI WEB plugin from ${source}: ${message}`);
-}
-function isSafeRelativePath(path) {
-    return path !== "" && !path.includes("..") && !path.startsWith("/");
-}
-function isWithin(root, candidate) {
-    const rel = relative(root, candidate);
-    return rel === "" || (!rel.startsWith("..") && !rel.startsWith(sep));
-}
 function contentTypeFor(path) {
     const lowerPath = path.toLowerCase();
-    if (lowerPath.endsWith(".js"))
+    if (lowerPath.endsWith(".js") || lowerPath.endsWith(".mjs"))
         return "application/javascript; charset=utf-8";
     if (lowerPath.endsWith(".json"))
         return "application/json; charset=utf-8";
@@ -320,7 +221,4 @@ function contentTypeFor(path) {
         return "image/svg+xml";
     return "application/octet-stream";
 }
-function isRecord(value) {
-    return typeof value === "object" && value !== null && !Array.isArray(value);
-}
 //# sourceMappingURL=piWebPluginService.js.map