@theia/plugin-ext 1.76.0-next.7 → 1.77.0-next.0

package/lib/hosted/browser-only/browser-only-plugin-paths-service.js

@@ -0,0 +1,145 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Robert Jandow
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserOnlyPluginPathsService = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const core_1 = require("@theia/core");
+const uri_1 = require("@theia/core/lib/common/uri");
+const uuid_1 = require("@theia/core/lib/common/uuid");
+const strings_1 = require("@theia/core/lib/common/strings");
+const env_variables_1 = require("@theia/core/lib/common/env-variables");
+const file_service_1 = require("@theia/filesystem/lib/browser/file-service");
+const common_1 = require("@theia/workspace/lib/common");
+const const_1 = require("../../main/common/paths/const");
+/** Session folder name, e.g. `20181205T093828`, same format as the backend uses. */
+const SESSION_TIMESTAMP_PATTERN = /^\d{8}T\d{6}$/;
+/**
+ * Resolves plugin log and storage locations for a browser-only application, under the config
+ * directory, which lives on the same (browser-local) file system as the workspace.
+ */
+let BrowserOnlyPluginPathsService = class BrowserOnlyPluginPathsService {
+    constructor() {
+        /**
+         * Resolving re-hashes the workspace id and hits {@link FileService.createFolder}, and the plugin
+         * server asks for this on every workspace storage read/write. The roots are part of the key
+         * because an untitled workspace's id is derived from them.
+         */
+        this.hostStoragePaths = new Map();
+    }
+    getHostLogPath() {
+        // cached: unlike the backend, where each call creates a new session folder, here one tab
+        // runs one session, and the plugin host may ask again on a later load cycle
+        return this.hostLogPath ??= this.resolveHostLogPath();
+    }
+    async resolveHostLogPath() {
+        const configDirUri = new uri_1.default(await this.envServer.getConfigDirUri());
+        const logsDirUri = configDirUri.resolve(const_1.PluginPaths.PLUGINS_LOGS_DIR);
+        const hostLogPath = await this.ensureDirectory(logsDirUri.resolve(this.generateTimeFolderName()).resolve('host'));
+        // as on the backend, we never wait for the cleanup
+        this.cleanUpOldLogs(logsDirUri).catch(error => this.logger.error('Failed to clean up old plugin log folders:', error));
+        return hostLogPath;
+    }
+    async getHostStoragePath(workspaceUri, rootUris) {
+        if (!workspaceUri) {
+            // no workspace, no place to store workspace state - same as the backend
+            return undefined;
+        }
+        // '\n' cannot appear in a URI, so it is safe as a separator between the workspace URI and its roots
+        const cacheKey = `${workspaceUri}\n${[...rootUris].sort().join('\n')}`;
+        let hostStoragePath = this.hostStoragePaths.get(cacheKey);
+        if (!hostStoragePath) {
+            hostStoragePath = this.resolveHostStoragePath(workspaceUri, rootUris);
+            this.hostStoragePaths.set(cacheKey, hostStoragePath);
+            // a transient failure (e.g. a flaky file system call) shouldn't poison the cache forever
+            hostStoragePath.catch(() => this.hostStoragePaths.delete(cacheKey));
+        }
+        return hostStoragePath;
+    }
+    async resolveHostStoragePath(workspaceUri, rootUris) {
+        const configDirUri = new uri_1.default(await this.envServer.getConfigDirUri());
+        const workspaceId = await this.buildWorkspaceId(configDirUri, workspaceUri, rootUris);
+        return this.ensureDirectory(configDirUri.resolve(const_1.PluginPaths.PLUGINS_WORKSPACE_STORAGE_DIR).resolve(workspaceId));
+    }
+    async buildWorkspaceId(configDirUri, workspaceUri, rootUris) {
+        if (this.untitledWorkspaceService.isUntitledWorkspace(new uri_1.default(workspaceUri), configDirUri)) {
+            // an untitled workspace is named anew in every session, so key its storage on the roots instead
+            return (0, uuid_1.hashValue)([...rootUris].sort().join(','));
+        }
+        return (0, uuid_1.hashValue)(workspaceUri);
+    }
+    /**
+     * Generate time folder name in format: YYYYMMDDTHHMMSS, for example: 20181205T093828
+     */
+    generateTimeFolderName() {
+        const timeStamp = new Date().toISOString().replace(/[-:]|(\..*)/g, '');
+        // Helps ensure our timestamp generation logic is "valid".
+        // Changes to the timestamp structure may break old logs deletion logic.
+        if (!SESSION_TIMESTAMP_PATTERN.test(timeStamp)) {
+            this.logger.error(`Generated log folder name: "${timeStamp}" does not match expected pattern: ${SESSION_TIMESTAMP_PATTERN}`);
+        }
+        return timeStamp;
+    }
+    /**
+     * Keeps only the most recent {@link PluginPaths.DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS}
+     * session folders under `logsDirUri`, so reloading doesn't fill up browser storage.
+     */
+    async cleanUpOldLogs(logsDirUri) {
+        const logsDir = await this.fileService.resolve(logsDirUri);
+        const sessionDirs = (logsDir.children ?? [])
+            // we never clean a folder that is not a Theia logs session folder, even if it
+            // does appear under `logsDirUri`
+            .filter(child => child.isDirectory && SESSION_TIMESTAMP_PATTERN.test(child.resource.path.base))
+            .map(child => child.resource)
+            // newest first, so the oldest ones get cut off. Ordinal comparison, not
+            // localeCompare - the format is fixed ASCII, and locale-aware sorting could order
+            // it differently depending on the user's locale
+            .sort((one, other) => (0, strings_1.compare)(other.path.base, one.path.base));
+        const oldSessionDirs = sessionDirs.slice(const_1.PluginPaths.DEFAULT_PLUGIN_MAX_SESSION_LOGS_FOLDERS);
+        await Promise.all(oldSessionDirs.map(uri => this.fileService.delete(uri, { fromUserGesture: false, recursive: true })));
+    }
+    /**
+     * Creates `uri` as a directory (fine if it already exists) and returns its path. Plugins get
+     * the path rather than the URI, e.g. as `ExtensionContext.storagePath`.
+     */
+    async ensureDirectory(uri) {
+        await this.fileService.createFolder(uri, { fromUserGesture: false });
+        return this.fileService.fsPath(uri);
+    }
+};
+exports.BrowserOnlyPluginPathsService = BrowserOnlyPluginPathsService;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('plugin-ext:BrowserOnlyPluginPathsService'),
+    tslib_1.__metadata("design:type", Object)
+], BrowserOnlyPluginPathsService.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(env_variables_1.EnvVariablesServer),
+    tslib_1.__metadata("design:type", Object)
+], BrowserOnlyPluginPathsService.prototype, "envServer", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(file_service_1.FileService),
+    tslib_1.__metadata("design:type", file_service_1.FileService)
+], BrowserOnlyPluginPathsService.prototype, "fileService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(common_1.UntitledWorkspaceService),
+    tslib_1.__metadata("design:type", common_1.UntitledWorkspaceService)
+], BrowserOnlyPluginPathsService.prototype, "untitledWorkspaceService", void 0);
+exports.BrowserOnlyPluginPathsService = BrowserOnlyPluginPathsService = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], BrowserOnlyPluginPathsService);
+//# sourceMappingURL=browser-only-plugin-paths-service.js.map

package/lib/hosted/browser-only/browser-only-plugin-paths-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-only-plugin-paths-service.js","sourceRoot":"","sources":["../../../src/hosted/browser-only/browser-only-plugin-paths-service.ts"],"names":[],"mappings":"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"}

package/lib/hosted/browser-only/browser-only-plugin-paths-service.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-only-plugin-paths-service.spec.d.ts.map

package/lib/hosted/browser-only/browser-only-plugin-paths-service.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-only-plugin-paths-service.spec.d.ts","sourceRoot":"","sources":["../../../src/hosted/browser-only/browser-only-plugin-paths-service.spec.ts"],"names":[],"mappings":""}

package/lib/hosted/browser-only/browser-only-plugin-paths-service.spec.js

@@ -0,0 +1,165 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Robert Jandow
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const jsdom_1 = require("@theia/core/lib/browser/test/jsdom");
+// `FileService` transitively imports browser modules that touch `document` at load time.
+const disableJSDOM = (0, jsdom_1.enableJSDOM)();
+const chai_1 = require("chai");
+const core_1 = require("@theia/core");
+const uri_1 = require("@theia/core/lib/common/uri");
+const mock_logger_1 = require("@theia/core/lib/common/test/mock-logger");
+const inversify_1 = require("@theia/core/shared/inversify");
+const env_variables_1 = require("@theia/core/lib/common/env-variables");
+const file_service_1 = require("@theia/filesystem/lib/browser/file-service");
+const common_1 = require("@theia/workspace/lib/common");
+const browser_only_plugin_paths_service_1 = require("./browser-only-plugin-paths-service");
+disableJSDOM();
+/* eslint-disable @typescript-eslint/no-explicit-any */
+/** The directories of the browser local file system, enough of it for the path service. */
+class FakeFileService {
+    constructor() {
+        this.directories = new Set();
+        /** Lets tests assert that a cached path didn't go through {@link createFolder} again. */
+        this.createFolderCallCount = 0;
+    }
+    async createFolder(uri) {
+        this.createFolderCallCount++;
+        for (let current = uri; !current.path.isRoot; current = current.parent) {
+            this.directories.add(current.path.toString());
+        }
+    }
+    async fsPath(uri) {
+        return uri.path.toString();
+    }
+    async resolve(uri) {
+        const parent = uri.path.toString();
+        const children = [...this.directories]
+            .filter(directory => new uri_1.default(directory).parent.path.toString() === parent)
+            .map(directory => ({ isDirectory: true, resource: new uri_1.default(directory) }));
+        return { isDirectory: true, resource: uri, children };
+    }
+    async delete(uri) {
+        const prefix = `${uri.path.toString()}/`;
+        for (const directory of [...this.directories]) {
+            if (directory === uri.path.toString() || directory.startsWith(prefix)) {
+                this.directories.delete(directory);
+            }
+        }
+    }
+}
+describe('BrowserOnlyPluginPathsService', () => {
+    let fileService;
+    let service;
+    function createService() {
+        const container = new inversify_1.Container();
+        container.bind(browser_only_plugin_paths_service_1.BrowserOnlyPluginPathsService).toSelf().inSingletonScope();
+        container.bind(core_1.ILogger).to(mock_logger_1.MockLogger);
+        container.bind(file_service_1.FileService).toConstantValue(fileService);
+        container.bind(common_1.WorkspaceFileService).toSelf().inSingletonScope();
+        container.bind(common_1.UntitledWorkspaceService).toSelf().inSingletonScope();
+        container.bind(env_variables_1.EnvVariablesServer).toConstantValue({
+            getConfigDirUri: async () => 'file:///.theia'
+        });
+        return container.get(browser_only_plugin_paths_service_1.BrowserOnlyPluginPathsService);
+    }
+    /** A fake session folder name for the `session`th day of December 2025, e.g. `20251203T000000`. */
+    function sessionFolderName(session) {
+        const day = String(session).padStart(2, '0');
+        return `202512${day}T000000`;
+    }
+    function sessionFolderUri(session) {
+        return new uri_1.default(`file:///.theia/logs/${sessionFolderName(session)}/host`);
+    }
+    beforeEach(() => {
+        fileService = new FakeFileService();
+        service = createService();
+    });
+    describe('host log path', () => {
+        it('creates a session log folder', async () => {
+            const logPath = await service.getHostLogPath();
+            (0, chai_1.expect)(logPath).to.match(/^\/\.theia\/logs\/\d{8}T\d{6}\/host$/);
+            (0, chai_1.expect)(fileService.directories).to.include(logPath);
+        });
+        it('resolves the log path only once', async () => {
+            (0, chai_1.expect)(await service.getHostLogPath()).to.equal(await service.getHostLogPath());
+        });
+        it('keeps the ten most recent session folders, the one of this session among them', async () => {
+            for (let session = 1; session <= 12; session++) {
+                await fileService.createFolder(sessionFolderUri(session));
+            }
+            const logPath = await service.getHostLogPath();
+            const sessions = sessionFolders();
+            (0, chai_1.expect)(sessions).to.have.lengthOf(10);
+            (0, chai_1.expect)(logPath).to.contain(sessions.find(session => !session.startsWith('/.theia/logs/202512')));
+            // the three oldest gave way to the folder of this session
+            (0, chai_1.expect)(sessions).to.not.include(`/.theia/logs/${sessionFolderName(1)}`);
+            (0, chai_1.expect)(sessions).to.not.include(`/.theia/logs/${sessionFolderName(3)}`);
+            (0, chai_1.expect)(sessions).to.include(`/.theia/logs/${sessionFolderName(4)}`);
+            (0, chai_1.expect)(sessions).to.include(`/.theia/logs/${sessionFolderName(12)}`);
+        });
+        it('never cleans up a folder that is not a session folder', async () => {
+            for (let session = 1; session <= 12; session++) {
+                await fileService.createFolder(sessionFolderUri(session));
+            }
+            await fileService.createFolder(new uri_1.default('file:///.theia/logs/not-a-session'));
+            await service.getHostLogPath();
+            // getHostLogPath() doesn't wait for the cleanup, so give it a tick to finish
+            await new Promise(resolve => setImmediate(resolve));
+            (0, chai_1.expect)(fileService.directories).to.include('/.theia/logs/not-a-session');
+        });
+        function sessionFolders() {
+            return [...fileService.directories].filter(directory => /^\/\.theia\/logs\/[^/]+$/.test(directory)).sort();
+        }
+    });
+    describe('host storage path', () => {
+        it('has nowhere to store while no workspace is open', async () => {
+            (0, chai_1.expect)(await service.getHostStoragePath(undefined, [])).to.be.undefined;
+        });
+        it('gives every workspace a storage folder of its own', async () => {
+            const one = await service.getHostStoragePath('file:///one', []);
+            const other = await service.getHostStoragePath('file:///other', []);
+            (0, chai_1.expect)(one).to.match(/^\/\.theia\/workspace-storage\/.+$/);
+            (0, chai_1.expect)(one).to.not.equal(other);
+            (0, chai_1.expect)(fileService.directories).to.include(one);
+        });
+        it('gives a workspace the same storage folder in every session', async () => {
+            (0, chai_1.expect)(await service.getHostStoragePath('file:///one', [])).to.equal(await service.getHostStoragePath('file:///one', []));
+        });
+        it('keys the storage of an untitled workspace on its roots, which outlive its name', async () => {
+            const roots = ['file:///a', 'file:///b'];
+            const one = await service.getHostStoragePath('file:///.theia/workspaces/Untitled-1.theia-workspace', roots);
+            // the same roots under the name the next session gives the untitled workspace
+            const next = await service.getHostStoragePath('file:///.theia/workspaces/Untitled-2.theia-workspace', [...roots].reverse());
+            (0, chai_1.expect)(one).to.equal(next);
+        });
+        it('resolves the storage path only once per workspace', async () => {
+            await service.getHostStoragePath('file:///one', []);
+            const callsAfterFirst = fileService.createFolderCallCount;
+            await service.getHostStoragePath('file:///one', []);
+            (0, chai_1.expect)(fileService.createFolderCallCount).to.equal(callsAfterFirst);
+        });
+        it('resolves a new storage path when the roots of an untitled workspace change', async () => {
+            const workspaceUri = 'file:///.theia/workspaces/Untitled-1.theia-workspace';
+            const first = await service.getHostStoragePath(workspaceUri, ['file:///a']);
+            const callsAfterFirst = fileService.createFolderCallCount;
+            const second = await service.getHostStoragePath(workspaceUri, ['file:///a', 'file:///b']);
+            (0, chai_1.expect)(second).to.not.equal(first);
+            (0, chai_1.expect)(fileService.createFolderCallCount).to.be.greaterThan(callsAfterFirst);
+        });
+    });
+});
+//# sourceMappingURL=browser-only-plugin-paths-service.spec.js.map

package/lib/hosted/browser-only/browser-only-plugin-paths-service.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-only-plugin-paths-service.spec.js","sourceRoot":"","sources":["../../../src/hosted/browser-only/browser-only-plugin-paths-service.spec.ts"],"names":[],"mappings":"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"}

package/lib/hosted/browser-only/browser-only-plugin-server.d.ts

@@ -0,0 +1,54 @@
+import { Mutex } from 'async-mutex';
+import { ILogger } from '@theia/core';
+import { StorageService } from '@theia/core/lib/browser/storage-service';
+import { PluginDeployOptions, PluginIdentifiers, PluginServer, PluginStorageKind, PluginType } from '../../common';
+import { KeysToAnyValues, KeysToKeysToAnyValue } from '../../common/types';
+import { PluginPathsService } from '../../main/common/plugin-paths-protocol';
+/**
+ * Plugins of a browser-only application are deployed at build time, so they can't be installed,
+ * uninstalled, enabled or disabled at runtime. The queries just report an empty result instead
+ * of failing, so callers like the plugin view still have something to render.
+ *
+ * The plugin key-value storage backing `ExtensionContext.globalState` and
+ * `ExtensionContext.workspaceState` lives in the browser's local storage.
+ */
+export declare class BrowserOnlyPluginServer implements PluginServer {
+    protected readonly logger: ILogger;
+    protected readonly storageService: StorageService;
+    protected readonly pluginPathsService: PluginPathsService;
+    /** Fallback for {@link withStoreLock} when the Web Locks API is unavailable. */
+    protected readonly localLock: Mutex;
+    protected missingLocksWarned: boolean;
+    install(pluginEntry: string, type?: PluginType, options?: PluginDeployOptions): Promise<void>;
+    uninstall(pluginId: PluginIdentifiers.VersionedId): Promise<void>;
+    enablePlugin(pluginId: PluginIdentifiers.UnversionedId): Promise<boolean>;
+    disablePlugin(pluginId: PluginIdentifiers.UnversionedId): Promise<boolean>;
+    getInstalledPlugins(): Promise<readonly PluginIdentifiers.VersionedId[]>;
+    getUninstalledPlugins(): Promise<readonly PluginIdentifiers.VersionedId[]>;
+    getDisabledPlugins(): Promise<readonly PluginIdentifiers.UnversionedId[]>;
+    setStorageValue(key: string, value: KeysToAnyValues, kind: PluginStorageKind): Promise<boolean>;
+    getStorageValue(key: string, kind: PluginStorageKind): Promise<KeysToAnyValues>;
+    getAllStorageValues(kind: PluginStorageKind): Promise<KeysToKeysToAnyValue>;
+    protected getStore(storeKey: string): Promise<KeysToKeysToAnyValue>;
+    /**
+     * Runs `task` while holding the cross-tab lock for `storeKey`, via the Web Locks API, so a
+     * concurrent {@link setStorageValue} on this or another tab can't interleave with it.
+     */
+    protected withStoreLock<T>(storeKey: string, task: () => Promise<T>): Promise<T>;
+    /** The Web Locks API of this browsing context, or `undefined` in an insecure context or an older browser. */
+    protected getWebLocks(): LockManager | undefined;
+    /**
+     * Requests `name` from `locks` and runs `callback` once granted, same as `LockManager.request()`.
+     *
+     * `LockGrantedCallback` is typed as `(lock: Lock | null) => T`, which doesn't account for an
+     * async or never-settling callback even though the API itself supports and awaits one, hence
+     * the cast. Kept as its own method so a subclass or test can swap the lock implementation.
+     */
+    protected requestLock<T>(locks: LockManager, name: string, callback: () => T | PromiseLike<T>): Promise<T>;
+    /**
+     * The browser storage key holding the given kind of values, or `undefined` if there's
+     * nowhere to keep them - e.g. workspace state while no workspace is open.
+     */
+    protected getStoreKey(kind: PluginStorageKind): Promise<string | undefined>;
+}
+//# sourceMappingURL=browser-only-plugin-server.d.ts.map

package/lib/hosted/browser-only/browser-only-plugin-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-only-plugin-server.d.ts","sourceRoot":"","sources":["../../../src/hosted/browser-only/browser-only-plugin-server.ts"],"names":[],"mappings":"AAiBA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACpC,OAAO,EAAE,OAAO,EAAO,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAuB,cAAc,EAAE,MAAM,yCAAyC,CAAC;AAC9F,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,YAAY,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AACnH,OAAO,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAM7E;;;;;;;GAOG;AACH,qBACa,uBAAwB,YAAW,YAAY;IAGxD,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAOnC,SAAS,CAAC,QAAQ,CAAC,cAAc,EAAE,cAAc,CAAC;IAGlD,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAE1D,gFAAgF;IAChF,SAAS,CAAC,QAAQ,CAAC,SAAS,QAAe;IAC3C,SAAS,CAAC,kBAAkB,UAAS;IAE/B,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7F,SAAS,CAAC,QAAQ,EAAE,iBAAiB,CAAC,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,YAAY,CAAC,QAAQ,EAAE,iBAAiB,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAIzE,aAAa,CAAC,QAAQ,EAAE,iBAAiB,CAAC,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAI1E,mBAAmB,IAAI,OAAO,CAAC,SAAS,iBAAiB,CAAC,WAAW,EAAE,CAAC;IAIxE,qBAAqB,IAAI,OAAO,CAAC,SAAS,iBAAiB,CAAC,WAAW,EAAE,CAAC;IAI1E,kBAAkB,IAAI,OAAO,CAAC,SAAS,iBAAiB,CAAC,aAAa,EAAE,CAAC;IAIzE,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC;IAqB/F,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,eAAe,CAAC;IAI/E,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAKjF,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAInE;;;OAGG;IACH,SAAS,CAAC,aAAa,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAchF,6GAA6G;IAC7G,SAAS,CAAC,WAAW,IAAI,WAAW,GAAG,SAAS;IAIhD;;;;;;OAMG;IACH,SAAS,CAAC,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAI1G;;;OAGG;cACa,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;CAQpF"}

package/lib/hosted/browser-only/browser-only-plugin-server.js

@@ -0,0 +1,155 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 Robert Jandow
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserOnlyPluginServer = void 0;
+const tslib_1 = require("tslib");
+const inversify_1 = require("@theia/core/shared/inversify");
+const async_mutex_1 = require("async-mutex");
+const core_1 = require("@theia/core");
+const storage_service_1 = require("@theia/core/lib/browser/storage-service");
+const plugin_paths_protocol_1 = require("../../main/common/plugin-paths-protocol");
+const GLOBAL_STORAGE_KEY = 'plugin-storage:global';
+const WORKSPACE_STORAGE_KEY_PREFIX = 'plugin-storage:workspace:';
+const LOCK_NAME_PREFIX = 'theia:plugin-storage:';
+/**
+ * Plugins of a browser-only application are deployed at build time, so they can't be installed,
+ * uninstalled, enabled or disabled at runtime. The queries just report an empty result instead
+ * of failing, so callers like the plugin view still have something to render.
+ *
+ * The plugin key-value storage backing `ExtensionContext.globalState` and
+ * `ExtensionContext.workspaceState` lives in the browser's local storage.
+ */
+let BrowserOnlyPluginServer = class BrowserOnlyPluginServer {
+    constructor() {
+        /** Fallback for {@link withStoreLock} when the Web Locks API is unavailable. */
+        this.localLock = new async_mutex_1.Mutex();
+        this.missingLocksWarned = false;
+    }
+    async install(pluginEntry, type, options) {
+        throw new Error(core_1.nls.localize('theia/plugin-ext/browserOnlyInstallUnsupported', 'Installing plugins is not supported in a browser-only application.'));
+    }
+    async uninstall(pluginId) {
+        throw new Error(core_1.nls.localize('theia/plugin-ext/browserOnlyUninstallUnsupported', 'Uninstalling plugins is not supported in a browser-only application.'));
+    }
+    async enablePlugin(pluginId) {
+        throw new Error(core_1.nls.localize('theia/plugin-ext/browserOnlyEnableUnsupported', 'Enabling plugins is not supported in a browser-only application.'));
+    }
+    async disablePlugin(pluginId) {
+        throw new Error(core_1.nls.localize('theia/plugin-ext/browserOnlyDisableUnsupported', 'Disabling plugins is not supported in a browser-only application.'));
+    }
+    async getInstalledPlugins() {
+        return [];
+    }
+    async getUninstalledPlugins() {
+        return [];
+    }
+    async getDisabledPlugins() {
+        return [];
+    }
+    async setStorageValue(key, value, kind) {
+        const storeKey = await this.getStoreKey(kind);
+        if (!storeKey) {
+            this.logger.warn('Cannot save plugin data: no opened workspace.');
+            return false;
+        }
+        // the browser storage is shared with this application's other tabs, each running its own
+        // plugin host, so the read and write below need to be atomic - otherwise a concurrent
+        // update from another tab could land in between and get overwritten by this one
+        await this.withStoreLock(storeKey, async () => {
+            const store = await this.getStore(storeKey);
+            if (value === undefined || Object.keys(value).length === 0) {
+                delete store[key];
+            }
+            else {
+                store[key] = value;
+            }
+            await this.storageService.setData(storeKey, store);
+        });
+        return true;
+    }
+    async getStorageValue(key, kind) {
+        return (await this.getAllStorageValues(kind))[key] ?? {};
+    }
+    async getAllStorageValues(kind) {
+        const storeKey = await this.getStoreKey(kind);
+        return storeKey ? this.getStore(storeKey) : {};
+    }
+    getStore(storeKey) {
+        return this.storageService.getData(storeKey, {});
+    }
+    /**
+     * Runs `task` while holding the cross-tab lock for `storeKey`, via the Web Locks API, so a
+     * concurrent {@link setStorageValue} on this or another tab can't interleave with it.
+     */
+    withStoreLock(storeKey, task) {
+        const locks = this.getWebLocks();
+        if (locks) {
+            return this.requestLock(locks, `${LOCK_NAME_PREFIX}${storeKey}`, task);
+        }
+        // no Web Locks API (insecure context, older browser): fall back to serializing writes
+        // within this tab. A write from another tab can still race and get lost.
+        if (!this.missingLocksWarned) {
+            this.missingLocksWarned = true;
+            this.logger.warn('Web Locks API unavailable: plugin storage updates from different tabs may race.');
+        }
+        return this.localLock.runExclusive(task);
+    }
+    /** The Web Locks API of this browsing context, or `undefined` in an insecure context or an older browser. */
+    getWebLocks() {
+        return typeof navigator === 'object' ? navigator.locks : undefined;
+    }
+    /**
+     * Requests `name` from `locks` and runs `callback` once granted, same as `LockManager.request()`.
+     *
+     * `LockGrantedCallback` is typed as `(lock: Lock | null) => T`, which doesn't account for an
+     * async or never-settling callback even though the API itself supports and awaits one, hence
+     * the cast. Kept as its own method so a subclass or test can swap the lock implementation.
+     */
+    requestLock(locks, name, callback) {
+        return locks.request(name, callback);
+    }
+    /**
+     * The browser storage key holding the given kind of values, or `undefined` if there's
+     * nowhere to keep them - e.g. workspace state while no workspace is open.
+     */
+    async getStoreKey(kind) {
+        if (!kind) {
+            return GLOBAL_STORAGE_KEY;
+        }
+        // derived from the storage path so workspace state follows `ExtensionContext.storageUri`
+        const storagePath = await this.pluginPathsService.getHostStoragePath(kind.workspace, kind.roots);
+        return storagePath && `${WORKSPACE_STORAGE_KEY_PREFIX}${storagePath}`;
+    }
+};
+exports.BrowserOnlyPluginServer = BrowserOnlyPluginServer;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(core_1.ILogger),
+    (0, inversify_1.named)('plugin-ext:BrowserOnlyPluginServer'),
+    tslib_1.__metadata("design:type", Object)
+], BrowserOnlyPluginServer.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(storage_service_1.LocalStorageService),
+    tslib_1.__metadata("design:type", Object)
+], BrowserOnlyPluginServer.prototype, "storageService", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(plugin_paths_protocol_1.PluginPathsService),
+    tslib_1.__metadata("design:type", Object)
+], BrowserOnlyPluginServer.prototype, "pluginPathsService", void 0);
+exports.BrowserOnlyPluginServer = BrowserOnlyPluginServer = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], BrowserOnlyPluginServer);
+//# sourceMappingURL=browser-only-plugin-server.js.map

package/lib/hosted/browser-only/browser-only-plugin-server.js.map

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

package/lib/hosted/browser-only/browser-only-plugin-server.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=browser-only-plugin-server.spec.d.ts.map

package/lib/hosted/browser-only/browser-only-plugin-server.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-only-plugin-server.spec.d.ts","sourceRoot":"","sources":["../../../src/hosted/browser-only/browser-only-plugin-server.spec.ts"],"names":[],"mappings":""}