@theia/core 1.77.0-next.1 → 1.77.0-next.6

package/lib/browser/catalog.json

@@ -1477,6 +1477,12 @@
       "fileMatch": [],
       "url": "https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/partial-scheduled.json"
     },
+    {
+      "name": "partial-inwards.json",
+      "description": "Inwards architecture linter configuration for pyproject.toml",
+      "fileMatch": [],
+      "url": "https://raw.githubusercontent.com/SchemaStore/schemastore/master/src/schemas/json/partial-inwards.json"
+    },
     {
       "name": "bozr.suite.json",
       "description": "Bozr test suite file",

package/lib/node/backend-application-module.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend-application-module.d.ts","sourceRoot":"","sources":["../../src/node/backend-application-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC;AAgElE,eAAO,MAAM,wBAAwB,iBAqGnC,CAAC"}
+{"version":3,"file":"backend-application-module.d.ts","sourceRoot":"","sources":["../../src/node/backend-application-module.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,eAAe,EAAwB,MAAM,WAAW,CAAC;AAiElE,eAAO,MAAM,wBAAwB,iBAwGnC,CAAC"}

package/lib/node/backend-application-module.js

@@ -40,6 +40,7 @@ const performance_1 = require("./performance");
 const os_backend_provider_1 = require("./os-backend-provider");
 const backend_request_facade_1 = require("./request/backend-request-facade");
 const filesystem_locking_1 = require("./filesystem-locking");
+const bundled_resource_provider_1 = require("./bundled-resource-provider");
 const backend_remote_service_1 = require("./remote/backend-remote-service");
 const remote_cli_contribution_1 = require("./remote/remote-cli-contribution");
 const setting_service_1 = require("./setting-service");
@@ -115,6 +116,8 @@ exports.backendApplicationModule = new inversify_1.ContainerModule(bind => {
     (0, performance_1.bindNodeStopwatch)(bind);
     (0, performance_1.bindBackendStopwatchServer)(bind);
     bind(filesystem_locking_1.FileSystemLocking).to(filesystem_locking_1.FileSystemLockingImpl).inSingletonScope();
+    bind(bundled_resource_provider_1.BundledResourceProviderImpl).toSelf().inSingletonScope();
+    bind(bundled_resource_provider_1.BundledResourceProvider).toService(bundled_resource_provider_1.BundledResourceProviderImpl);
     bind(setting_service_1.SettingServiceImpl).toSelf().inSingletonScope();
     bind(setting_service_1.SettingService).toService(setting_service_1.SettingServiceImpl);
     (0, common_1.bindPreferenceConfigurations)(bind);

package/lib/node/backend-application-module.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend-application-module.js","sourceRoot":"","sources":["../../src/node/backend-application-module.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"backend-application-module.js","sourceRoot":"","sources":["../../src/node/backend-application-module.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;AAEhF,yCAAkE;AAClE,oEAAgE;AAChE,4CAAsD;AACtD,sCAgBmB;AACnB,+DAG+B;AAC/B,+BAAoD;AACpD,2CAAoD;AACpD,6DAA6D;AAC7D,yEAAoF;AACpF,6DAAiF;AACjF,mDAAyD;AACzD,yFAAoF;AACpF,qEAAgI;AAChI,mEAA6F;AAC7F,mDAA2E;AAC3E,yDAAyD;AACzD,uEAA2G;AAC3G,2DAAuD;AACvD,mDAA+C;AAC/C,6EAAwE;AACxE,+CAA8E;AAC9E,+DAA8D;AAC9D,6EAA2G;AAC3G,6DAAgF;AAChF,2EAAmG;AACnG,4EAAuE;AACvE,8EAAyE;AACzE,uDAAuE;AACvE,iEAAiE;AAEjE,IAAA,oBAAQ,EAAC,IAAA,sBAAU,GAAE,EAAE,wCAAkB,CAAC,CAAC;AAE3C,MAAM,uBAAuB,GAAG,uDAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE;IACzF,mBAAmB,CAAC,2BAAkB,EAAE,uBAAc,CAAC,CAAC;AAC5D,CAAC,CAAC,CAAC;AAEH,MAAM,uBAAuB,GAAG,uDAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE,EAAE,EAAE;IAC/F,mBAAmB,CAAC,2BAAkB,EAAE,sBAAa,CAAC,CAAC;IACvD,IAAI,CAAC,uBAAc,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,uDAAyB,CAAC,MAAM,CAAC,CAAC,EAAE,mBAAmB,EAAE,EAAE,EAAE;IAC3F,mBAAmB,CAAC,0CAAqB,EAAE,sCAAiB,CAAC,CAAC;IAC9D,mBAAmB,CAAC,yCAAoB,EAAE,qCAAgB,CAAC,CAAC;AAChE,CAAC,CAAC,CAAC;AAEU,QAAA,wBAAwB,GAAG,IAAI,2BAAe,CAAC,IAAI,CAAC,EAAE;IAC/D,IAAI,CAAC,uDAAyB,CAAC,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;IACzE,IAAI,CAAC,uDAAyB,CAAC,CAAC,eAAe,CAAC,uBAAuB,CAAC,CAAC;IACzE,IAAI,CAAC,uDAAyB,CAAC,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAC;IAE3E,IAAI,CAAC,gBAAU,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAC7C,IAAA,qCAA4B,EAAC,IAAI,EAAE,qBAAe,CAAC,CAAC;IAEpD,IAAI,CAAC,uDAAiC,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACpE,IAAI,CAAC,qBAAe,CAAC,CAAC,SAAS,CAAC,uDAAiC,CAAC,CAAC;IAEnE,IAAI,CAAC,4CAAsB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACzD,IAAI,CAAC,wCAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACrD,IAAI,CAAC,mCAAa,CAAC,CAAC,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;QACjD,IAAI,IAAI,GAAG,SAAS,CAAC;QACrB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IAChB,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACtB,IAAA,qCAA4B,EAAC,IAAI,EAAE,oDAA8B,CAAC,CAAC;IACnE,wEAAwE;IACxE,wDAAwD;IACxD,IAAI,CAAC,oDAA8B,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE;QACtD,IAAI,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,8CAAwB,CAAC,EAAE,CAAC;YAClD,OAAO,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,8CAAwB,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACJ,OAAO,CAAC,IAAI,CAAC,qEAAqE,CAAC,CAAC;YACpF,OAAO,EAAE,CAAC;QACd,CAAC;IACL,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEtB,IAAI,CAAC,iCAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAExD,IAAI,CAAC,0CAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,IAAI,CAAC,wCAAiB,CAAC,CAAC,SAAS,CAAC,0CAAqB,CAAC,CAAC;IACzD,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CACzC,IAAI,6BAAoB,CAAC,sCAAe,EAAE,GAAG,EAAE,CAC3C,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,wCAAiB,CAAC,CACvC,CACJ,CAAC,gBAAgB,EAAE,CAAC;IAErB,IAAI,CAAC,kCAAkB,CAAC,CAAC,EAAE,CAAC,sCAAsB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACvE,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CACzC,IAAI,6BAAoB,CAAC,gCAAgB,EAAE,GAAG,EAAE;QAC5C,MAAM,kBAAkB,GAAG,GAAG,CAAC,SAAS,CAAC,GAAG,CAAqB,kCAAkB,CAAC,CAAC;QACrF,OAAO,kBAAkB,CAAC;IAC9B,CAAC,CAAC,CACL,CAAC,gBAAgB,EAAE,CAAC;IAErB,IAAI,CAAC,wCAAkB,CAAC,CAAC,eAAe,CAAC,IAAI,wCAAkB,CAAC,EAAE,WAAW,EAAE,4CAAsB,EAAE,CAAC,CAAC,CAAC;IAE1G,IAAI,CAAC,0CAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACrD,IAAA,qCAA4B,EAAC,IAAI,EAAE,sDAA8B,CAAC,CAAC;IACnE,IAAI,CAAC,2BAAe,CAAC,CAAC,EAAE,CAAC,sCAAmB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACjE,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CACzC,IAAI,6BAAoB,CAAC,+BAAmB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAkB,2BAAe,CAAC,CAAC,CAC3G,CAAC,gBAAgB,EAAE,CAAC;IAErB,IAAI,CAAC,gDAA0B,CAAC,CAAC,EAAE,CAAC,oDAA8B,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAEvF,IAAI,CAAC,oCAAgB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACnD,IAAI,CAAC,4BAAY,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAE/C,IAAI,CAAC,2CAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,IAAI,CAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,2CAAqB,CAAC,CAAC;IACzD,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAClC,GAAG,CAAC,EAAE,CAAC,IAAI,6BAAoB,CAAC,8BAAqB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,0BAAiB,CAAC,CAAC,CACrG,CAAC,gBAAgB,EAAE,CAAC;IAErB,IAAI,CAAC,6CAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACvD,IAAI,CAAC,qBAAe,CAAC,CAAC,SAAS,CAAC,6CAAoB,CAAC,CAAC;IAEtD,IAAA,qCAA4B,EAAC,IAAI,EAAE,+CAAqB,CAAC,CAAC;IAC1D,IAAI,CAAC,6CAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACvD,IAAA,qCAA4B,EAAC,IAAI,EAAE,0DAAiC,CAAC,CAAC;IACtE,IAAI,CAAC,6CAAoB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACvD,IAAI,CAAC,0BAAiB,CAAC,CAAC,cAAc,CAClC,GAAG,CAAC,EAAE,CAAC,IAAI,6BAAoB,CAAC,8BAAoB,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,6CAAoB,CAAC,CAAC,CACvG,CAAC,gBAAgB,EAAE,CAAC;IAErB,IAAA,+BAAiB,EAAC,IAAI,CAAC,CAAC;IACxB,IAAA,wCAA0B,EAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,sCAAiB,CAAC,CAAC,EAAE,CAAC,0CAAqB,CAAC,CAAC,gBAAgB,EAAE,CAAC;IAErE,IAAI,CAAC,uDAA2B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAC9D,IAAI,CAAC,mDAAuB,CAAC,CAAC,SAAS,CAAC,uDAA2B,CAAC,CAAC;IAErE,IAAI,CAAC,oCAAkB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACrD,IAAI,CAAC,gCAAc,CAAC,CAAC,SAAS,CAAC,oCAAkB,CAAC,CAAC;IAEnD,IAAA,qCAA4B,EAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC,8BAAqB,CAAC,CAAC,eAAe,CAAC,CAAC,wBAAe,CAAC,OAAO,EAAE,wBAAe,CAAC,IAAI,CAAC,CAAC,CAAC;IAC7F,IAAA,qCAA4B,EAAC,IAAI,EAAE,+BAAsB,CAAC,CAAC;IAC3D,IAAI,CAAC,mCAA0B,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,KAAsB,EAAE,EAAE,CAAC,GAAG,CAAC,SAAS,CAAC,QAAQ,CAAC,2BAAkB,EAAE,KAAK,CAAC,CAAC,CAAC;IACjI,IAAI,CAAC,oCAA2B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IAC9D,IAAI,CAAC,gCAAuB,CAAC,CAAC,SAAS,CAAC,oCAA2B,CAAC,CAAC;IACrE,IAAI,CAAC,2BAAkB,CAAC,CAAC,EAAE,CAAC,mCAA0B,CAAC,CAAC,gBAAgB,EAAE,CAAC,eAAe,CAAC,wBAAe,CAAC,OAAO,CAAC,CAAC;IACpH,IAAI,CAAC,0CAAiC,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACpE,IAAI,CAAC,8BAAqB,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;IACxD,IAAI,CAAC,0BAAiB,CAAC,CAAC,SAAS,CAAC,8BAAqB,CAAC,CAAC;IACzD,IAAA,sCAAmB,EAAC,IAAI,CAAC,CAAC;IAC1B,IAAA,4BAAmB,EAAC,IAAI,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC"}

package/lib/node/bundled-resource-provider.d.ts

@@ -0,0 +1,86 @@
+import * as fs from 'fs';
+import { interfaces } from 'inversify';
+import { EnvVariablesServer } from '../common/env-variables';
+import { ILogger } from '../common/logger';
+import { FileSystemLocking } from './filesystem-locking';
+export declare const BundledResourceProvider: symbol & interfaces.Abstract<BundledResourceProvider>;
+/**
+ * Provides paths to resources that are bundled with the application, in a form that can also be used by
+ * processes which do not run inside the application, such as shells, debug adapters or other external tools.
+ *
+ * When an Electron application is packaged with `asar: true`, the resources of the application are stored in
+ * an `app.asar` archive. Paths pointing into such an archive can only be read through Electron's patched `fs`
+ * module, so handing them to an external process fails. Therefore, always resolve a bundled resource through
+ * this service before passing its path to a process outside of the application.
+ */
+export interface BundledResourceProvider {
+    /**
+     * Resolve the given path of a bundled file or directory to a path that external processes can read.
+     *
+     * If the resource is not packaged into an archive, its path is returned unchanged. Otherwise the copy that
+     * the packaging step has left outside of the archive is used, if it is complete, and the resource is
+     * extracted from the archive into the configuration directory as a last resort.
+     *
+     * Results are cached, so that a resource is extracted at most once per application version.
+     *
+     * @param resourcePath the path of the bundled resource, typically resolved against `__dirname`.
+     * @returns the path to use outside of the application.
+     * @throws if the resource does not exist or cannot be made available.
+     */
+    resolveExternalPath(resourcePath: string): Promise<string>;
+}
+export declare class BundledResourceProviderImpl implements BundledResourceProvider {
+    protected readonly logger: ILogger;
+    protected readonly envVariablesServer: EnvVariablesServer;
+    protected readonly fileSystemLocking: FileSystemLocking;
+    /** The folder within the configuration directory into which resources are extracted. */
+    protected readonly extractionFolder = "bundled-resources";
+    /** Resources extracted for another application version are removed when they are older than this. */
+    protected readonly staleExtractionAge: number;
+    protected readonly resolved: Map<string, Promise<string>>;
+    protected temporaryExtractionPath: Promise<string> | undefined;
+    resolveExternalPath(resourcePath: string): Promise<string>;
+    protected doResolveExternalPath(resourcePath: string): Promise<string>;
+    /**
+     * Find the archive that the given resource is packaged into, if any.
+     *
+     * @returns the path of the archive, i.e. the shortest prefix of the given path ending in an `.asar` segment,
+     * which is also how Electron itself determines the archive that a path refers to.
+     */
+    protected findArchivePath(resourcePath: string): string | undefined;
+    /**
+     * Whether every file of the given resource is already available at the given target path. Packaging tools
+     * only unpack the files that the application configured them to unpack, so a partial copy must be ignored.
+     */
+    protected isExtracted(resourcePath: string, targetPath: string): Promise<boolean>;
+    protected extract(resourcePath: string, targetPath: string): Promise<void>;
+    /**
+     * Collect the files of the given resource as paths relative to it. The relative path of a resource that is
+     * a plain file is the empty string.
+     */
+    protected collectFiles(resourcePath: string, relativePath?: string): Promise<string[]>;
+    protected copyFile(sourcePath: string, targetPath: string): Promise<void>;
+    protected isUpToDate(targetPath: string, sourceStat: fs.Stats): Promise<boolean>;
+    /**
+     * The directory into which resources of the given archive are extracted. It is specific to the content of
+     * the archive, so that updating the application invalidates previously extracted copies.
+     */
+    protected getExtractionPath(archivePath: string): Promise<string>;
+    /**
+     * Fallback for applications whose configuration directory cannot be written to. The directory is unique to
+     * this run of the application, so that resources are extracted again whenever the application is started.
+     */
+    protected getTemporaryExtractionPath(): Promise<string>;
+    /**
+     * Identify the content of the given archive. `process.noAsar` is toggled around the synchronous `stat` call
+     * to get the stats of the archive file itself rather than of the directory that it appears as.
+     */
+    protected getArchiveStamp(archivePath: string): string;
+    /**
+     * Remove resources that were extracted from an earlier version of the archive, unless they were used
+     * recently, because another application instance may still be running on that version.
+     */
+    protected removeStaleExtractions(extractionRoot: string, prefix: string, currentPath: string): void;
+    protected exists(targetPath: string): Promise<boolean>;
+}
+//# sourceMappingURL=bundled-resource-provider.d.ts.map

package/lib/node/bundled-resource-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-resource-provider.d.ts","sourceRoot":"","sources":["../../src/node/bundled-resource-provider.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AAGzB,OAAO,EAAsB,UAAU,EAAS,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAE7D,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAEzD,eAAO,MAAM,uBAAuB,EAAwC,MAAM,GAAG,UAAU,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAClI;;;;;;;;GAQG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;;;;;;;;OAYG;IACH,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC9D;AAED,qBACa,2BAA4B,YAAW,uBAAuB;IAGvE,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAGnC,SAAS,CAAC,QAAQ,CAAC,kBAAkB,EAAE,kBAAkB,CAAC;IAG1D,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB,CAAC;IAExD,wFAAwF;IACxF,SAAS,CAAC,QAAQ,CAAC,gBAAgB,uBAAuB;IAE1D,qGAAqG;IACrG,SAAS,CAAC,QAAQ,CAAC,kBAAkB,SAA2B;IAEhE,SAAS,CAAC,QAAQ,CAAC,QAAQ,+BAAsC;IACjE,SAAS,CAAC,uBAAuB,EAAE,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IAEzD,mBAAmB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;cAmBhD,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAoB5E;;;;;OAKG;IACH,SAAS,CAAC,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAMnE;;;OAGG;cACa,WAAW,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;cASvE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAMhF;;;OAGG;cACa,YAAY,CAAC,YAAY,EAAE,MAAM,EAAE,YAAY,GAAE,MAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;cAYhF,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;cAyB/D,UAAU,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,CAAC,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC;IAQtF;;;OAGG;cACa,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAcvE;;;OAGG;IACH,SAAS,CAAC,0BAA0B,IAAI,OAAO,CAAC,MAAM,CAAC;IAIvD;;;OAGG;IACH,SAAS,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM;IAYtD;;;OAGG;IACH,SAAS,CAAC,sBAAsB,CAAC,cAAc,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;cAiBnF,MAAM,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAS/D"}

package/lib/node/bundled-resource-provider.js

@@ -0,0 +1,241 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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.BundledResourceProviderImpl = exports.BundledResourceProvider = void 0;
+const tslib_1 = require("tslib");
+const crypto = require("crypto");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const inversify_1 = require("inversify");
+const env_variables_1 = require("../common/env-variables");
+const file_uri_1 = require("../common/file-uri");
+const logger_1 = require("../common/logger");
+const filesystem_locking_1 = require("./filesystem-locking");
+exports.BundledResourceProvider = Symbol('BundledResourceProvider');
+let BundledResourceProviderImpl = class BundledResourceProviderImpl {
+    constructor() {
+        /** The folder within the configuration directory into which resources are extracted. */
+        this.extractionFolder = 'bundled-resources';
+        /** Resources extracted for another application version are removed when they are older than this. */
+        this.staleExtractionAge = 7 * 24 * 60 * 60 * 1000;
+        this.resolved = new Map();
+    }
+    async resolveExternalPath(resourcePath) {
+        const normalizedPath = path.resolve(resourcePath);
+        const pending = this.resolved.get(normalizedPath);
+        if (pending) {
+            try {
+                const resolvedPath = await pending;
+                if (await this.exists(resolvedPath)) {
+                    return resolvedPath;
+                }
+            }
+            catch {
+                // the previous attempt failed, so try again below
+            }
+            this.resolved.delete(normalizedPath);
+        }
+        const result = this.doResolveExternalPath(normalizedPath);
+        this.resolved.set(normalizedPath, result);
+        return result;
+    }
+    async doResolveExternalPath(resourcePath) {
+        if (!await this.exists(resourcePath)) {
+            throw new Error(`Bundled resource does not exist: ${resourcePath}`);
+        }
+        const archivePath = this.findArchivePath(resourcePath);
+        if (!archivePath) {
+            // The resource is not packaged into an archive, so external processes can read it directly.
+            return resourcePath;
+        }
+        const relativePath = path.relative(archivePath, resourcePath);
+        const unpackedPath = path.join(`${archivePath}.unpacked`, relativePath);
+        if (await this.isExtracted(resourcePath, unpackedPath)) {
+            return unpackedPath;
+        }
+        const extractionPath = path.join(await this.getExtractionPath(archivePath), relativePath);
+        await this.fileSystemLocking.lockPath(archivePath, () => this.extract(resourcePath, extractionPath));
+        this.logger.info(`Extracted bundled resource '${resourcePath}' to '${extractionPath}'.`);
+        return extractionPath;
+    }
+    /**
+     * Find the archive that the given resource is packaged into, if any.
+     *
+     * @returns the path of the archive, i.e. the shortest prefix of the given path ending in an `.asar` segment,
+     * which is also how Electron itself determines the archive that a path refers to.
+     */
+    findArchivePath(resourcePath) {
+        const segments = resourcePath.split(/[\\/]/);
+        const archiveIndex = segments.findIndex(segment => segment.toLowerCase().endsWith('.asar'));
+        return archiveIndex < 0 ? undefined : segments.slice(0, archiveIndex + 1).join(path.sep);
+    }
+    /**
+     * Whether every file of the given resource is already available at the given target path. Packaging tools
+     * only unpack the files that the application configured them to unpack, so a partial copy must be ignored.
+     */
+    async isExtracted(resourcePath, targetPath) {
+        for (const file of await this.collectFiles(resourcePath)) {
+            if (!await this.exists(path.join(targetPath, file))) {
+                return false;
+            }
+        }
+        return true;
+    }
+    async extract(resourcePath, targetPath) {
+        for (const file of await this.collectFiles(resourcePath)) {
+            await this.copyFile(path.join(resourcePath, file), path.join(targetPath, file));
+        }
+    }
+    /**
+     * Collect the files of the given resource as paths relative to it. The relative path of a resource that is
+     * a plain file is the empty string.
+     */
+    async collectFiles(resourcePath, relativePath = '') {
+        const currentPath = path.join(resourcePath, relativePath);
+        if (!(await fs.promises.stat(currentPath)).isDirectory()) {
+            return [relativePath];
+        }
+        const files = [];
+        for (const entry of await fs.promises.readdir(currentPath)) {
+            files.push(...await this.collectFiles(resourcePath, path.join(relativePath, entry)));
+        }
+        return files;
+    }
+    async copyFile(sourcePath, targetPath) {
+        const sourceStat = await fs.promises.stat(sourcePath);
+        if (await this.isUpToDate(targetPath, sourceStat)) {
+            return;
+        }
+        await fs.promises.mkdir(path.dirname(targetPath), { recursive: true, mode: 0o700 });
+        // Write to a temporary file and move it into place, so that a concurrently starting application
+        // instance never reads partially written content.
+        const temporaryPath = `${targetPath}.${process.pid}.tmp`;
+        try {
+            // Electron reports the files of an asar archive as not executable, even those that the archive marks as
+            // executable, so every extracted file is made executable for the owner to keep bundled executables usable.
+            await fs.promises.writeFile(temporaryPath, await fs.promises.readFile(sourcePath), { mode: sourceStat.mode & 0o777 | 0o700 });
+            try {
+                await fs.promises.rename(temporaryPath, targetPath);
+            }
+            catch {
+                // renaming onto an existing file is not supported on all platforms
+                await fs.promises.rm(targetPath, { force: true });
+                await fs.promises.rename(temporaryPath, targetPath);
+            }
+        }
+        finally {
+            await fs.promises.rm(temporaryPath, { force: true });
+        }
+    }
+    async isUpToDate(targetPath, sourceStat) {
+        try {
+            return (await fs.promises.stat(targetPath)).size === sourceStat.size;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * The directory into which resources of the given archive are extracted. It is specific to the content of
+     * the archive, so that updating the application invalidates previously extracted copies.
+     */
+    async getExtractionPath(archivePath) {
+        const archiveName = path.basename(archivePath, path.extname(archivePath));
+        try {
+            const extractionRoot = path.join(file_uri_1.FileUri.fsPath(await this.envVariablesServer.getConfigDirUri()), this.extractionFolder);
+            const extractionPath = path.join(extractionRoot, `${archiveName}-${this.getArchiveStamp(archivePath)}`);
+            await fs.promises.mkdir(extractionPath, { recursive: true, mode: 0o700 });
+            this.removeStaleExtractions(extractionRoot, `${archiveName}-`, extractionPath);
+            return extractionPath;
+        }
+        catch (error) {
+            this.logger.warn('Could not extract bundled resources into the configuration directory, using a temporary directory instead.', error);
+            return this.getTemporaryExtractionPath();
+        }
+    }
+    /**
+     * Fallback for applications whose configuration directory cannot be written to. The directory is unique to
+     * this run of the application, so that resources are extracted again whenever the application is started.
+     */
+    getTemporaryExtractionPath() {
+        return this.temporaryExtractionPath ??= fs.promises.mkdtemp(path.join(os.tmpdir(), 'theia-bundled-resources-'));
+    }
+    /**
+     * Identify the content of the given archive. `process.noAsar` is toggled around the synchronous `stat` call
+     * to get the stats of the archive file itself rather than of the directory that it appears as.
+     */
+    getArchiveStamp(archivePath) {
+        const asarProcess = process;
+        const noAsar = asarProcess.noAsar;
+        try {
+            asarProcess.noAsar = true;
+            const stat = fs.statSync(archivePath);
+            return crypto.createHash('sha256').update(`${archivePath}:${stat.size}:${stat.mtimeMs}`).digest('hex').substring(0, 12);
+        }
+        finally {
+            asarProcess.noAsar = noAsar;
+        }
+    }
+    /**
+     * Remove resources that were extracted from an earlier version of the archive, unless they were used
+     * recently, because another application instance may still be running on that version.
+     */
+    removeStaleExtractions(extractionRoot, prefix, currentPath) {
+        const removeStale = async () => {
+            for (const entry of await fs.promises.readdir(extractionRoot)) {
+                const entryPath = path.join(extractionRoot, entry);
+                if (!entry.startsWith(prefix) || entryPath === currentPath) {
+                    continue;
+                }
+                const stat = await fs.promises.stat(entryPath);
+                if (Date.now() - stat.mtimeMs > this.staleExtractionAge) {
+                    await fs.promises.rm(entryPath, { recursive: true, force: true });
+                    this.logger.info(`Removed stale extracted resources: ${entryPath}`);
+                }
+            }
+        };
+        removeStale().catch(error => this.logger.warn(`Could not remove stale extracted resources in '${extractionRoot}'.`, error));
+    }
+    async exists(targetPath) {
+        try {
+            await fs.promises.stat(targetPath);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+};
+exports.BundledResourceProviderImpl = BundledResourceProviderImpl;
+tslib_1.__decorate([
+    (0, inversify_1.inject)(logger_1.ILogger),
+    (0, inversify_1.named)('core:BundledResourceProviderImpl'),
+    tslib_1.__metadata("design:type", Object)
+], BundledResourceProviderImpl.prototype, "logger", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(env_variables_1.EnvVariablesServer),
+    tslib_1.__metadata("design:type", Object)
+], BundledResourceProviderImpl.prototype, "envVariablesServer", void 0);
+tslib_1.__decorate([
+    (0, inversify_1.inject)(filesystem_locking_1.FileSystemLocking),
+    tslib_1.__metadata("design:type", Object)
+], BundledResourceProviderImpl.prototype, "fileSystemLocking", void 0);
+exports.BundledResourceProviderImpl = BundledResourceProviderImpl = tslib_1.__decorate([
+    (0, inversify_1.injectable)()
+], BundledResourceProviderImpl);
+//# sourceMappingURL=bundled-resource-provider.js.map

package/lib/node/bundled-resource-provider.js.map

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

package/lib/node/bundled-resource-provider.spec.d.ts

@@ -0,0 +1,2 @@
+import 'reflect-metadata';
+//# sourceMappingURL=bundled-resource-provider.spec.d.ts.map

package/lib/node/bundled-resource-provider.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-resource-provider.spec.d.ts","sourceRoot":"","sources":["../../src/node/bundled-resource-provider.spec.ts"],"names":[],"mappings":"AAgBA,OAAO,kBAAkB,CAAC"}

package/lib/node/bundled-resource-provider.spec.js

@@ -0,0 +1,160 @@
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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 });
+require("reflect-metadata");
+const chai_1 = require("chai");
+const fs = require("fs");
+const os = require("os");
+const path = require("path");
+const temp = require("temp");
+const inversify_1 = require("inversify");
+const env_variables_1 = require("../common/env-variables");
+const logger_1 = require("../common/logger");
+const mock_logger_1 = require("../common/test/mock-logger");
+const file_uri_1 = require("../common/file-uri");
+const bundled_resource_provider_1 = require("./bundled-resource-provider");
+const filesystem_locking_1 = require("./filesystem-locking");
+/**
+ * The provider recognizes archives by their `.asar` path segment and reads them through `fs`, which Electron
+ * patches to transparently read from the archive. Plain directories named `*.asar` therefore behave like
+ * archives from the point of view of the provider and let us test it outside of Electron.
+ */
+describe('BundledResourceProvider', () => {
+    const track = temp.track();
+    let configDir;
+    let appDir;
+    let provider;
+    beforeEach(() => {
+        const root = track.mkdirSync();
+        configDir = path.join(root, 'config');
+        appDir = path.join(root, 'app');
+        fs.mkdirSync(configDir);
+        fs.mkdirSync(appDir);
+        provider = createProvider();
+    });
+    /** Each provider instance stands for one run of the application, as resolved paths are cached. */
+    function createProvider() {
+        const container = new inversify_1.Container();
+        container.bind(logger_1.ILogger).toConstantValue(new mock_logger_1.MockLogger());
+        container.bind(filesystem_locking_1.FileSystemLocking).to(filesystem_locking_1.FileSystemLockingImpl).inSingletonScope();
+        container.bind(env_variables_1.EnvVariablesServer).toConstantValue({
+            getConfigDirUri: async () => file_uri_1.FileUri.create(configDir).toString()
+        });
+        container.bind(bundled_resource_provider_1.BundledResourceProviderImpl).toSelf().inSingletonScope();
+        container.bind(bundled_resource_provider_1.BundledResourceProvider).toService(bundled_resource_provider_1.BundledResourceProviderImpl);
+        return container.get(bundled_resource_provider_1.BundledResourceProvider);
+    }
+    afterEach(() => track.cleanupSync());
+    /**
+     * Assert that the given path is nested in the given directory. The provider derives the configuration
+     * directory from a URI, which on Windows yields a lower-case drive letter, so the paths cannot simply be
+     * compared by prefix. `path.relative` ignores the case of a path on Windows.
+     */
+    function expectNestedIn(directoryPath, nestedPath) {
+        const relativePath = path.relative(directoryPath, nestedPath);
+        (0, chai_1.expect)(relativePath).to.not.be.empty;
+        (0, chai_1.expect)(relativePath.split(path.sep)).to.not.contain('..');
+    }
+    function writeResources(rootPath, files) {
+        for (const [relativePath, content] of Object.entries(files)) {
+            const filePath = path.join(rootPath, relativePath);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, content);
+        }
+        return rootPath;
+    }
+    it('returns the path of a resource that is not packaged into an archive', async () => {
+        const resourcePath = path.join(writeResources(appDir, { 'scripts/greet.sh': 'echo hello' }), 'scripts');
+        (0, chai_1.expect)(await provider.resolveExternalPath(resourcePath)).to.equal(resourcePath);
+    });
+    it('rejects for a resource that does not exist', async () => {
+        const resourcePath = path.join(appDir, 'scripts');
+        await provider.resolveExternalPath(resourcePath).then(() => chai_1.expect.fail('should have been rejected'), error => (0, chai_1.expect)(String(error)).to.contain(resourcePath));
+    });
+    it('extracts a packaged resource into the configuration directory', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello', 'scripts/nested/.hidden': 'secret' });
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+        (0, chai_1.expect)(resolvedPath).to.not.contain('.asar');
+        expectNestedIn(configDir, resolvedPath);
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'nested', '.hidden'), 'utf8')).to.equal('secret');
+    });
+    it('extracts a packaged resource that is a plain file', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts', 'greet.sh'));
+        expectNestedIn(configDir, resolvedPath);
+        (0, chai_1.expect)(fs.readFileSync(resolvedPath, 'utf8')).to.equal('echo hello');
+    });
+    it('extracts a packaged file as executable', async function () {
+        if (process.platform === 'win32') {
+            this.skip();
+        }
+        // Electron reports the files of an asar archive with this mode, even executables.
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'native/tool': 'binary' });
+        fs.chmodSync(path.join(archivePath, 'native', 'tool'), 0o644);
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'native', 'tool'));
+        (0, chai_1.expect)(fs.statSync(resolvedPath).mode & 0o700).to.equal(0o700);
+    });
+    it('prefers the copy that the packaging step has left outside of the archive', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const unpackedPath = writeResources(`${archivePath}.unpacked`, { 'scripts/greet.sh': 'echo hello' });
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+        (0, chai_1.expect)(resolvedPath).to.equal(path.join(unpackedPath, 'scripts'));
+    });
+    it('extracts a packaged resource that was only unpacked partially', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello', 'scripts/farewell.sh': 'echo bye' });
+        writeResources(`${archivePath}.unpacked`, { 'scripts/greet.sh': 'echo hello' });
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+        expectNestedIn(configDir, resolvedPath);
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'farewell.sh'), 'utf8')).to.equal('echo bye');
+    });
+    it('re-extracts a resource that was removed from the configuration directory', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const resourcePath = path.join(archivePath, 'scripts');
+        const resolvedPath = await provider.resolveExternalPath(resourcePath);
+        fs.rmSync(resolvedPath, { recursive: true });
+        (0, chai_1.expect)(await provider.resolveExternalPath(resourcePath)).to.equal(resolvedPath);
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+    });
+    it('extracts into a temporary directory if the configuration directory cannot be written to', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        // a configuration directory that is a regular file cannot hold the extracted resources
+        configDir = path.join(appDir, 'not-a-directory');
+        fs.writeFileSync(configDir, '');
+        const resolvedPath = await createProvider().resolveExternalPath(path.join(archivePath, 'scripts'));
+        expectNestedIn(os.tmpdir(), resolvedPath);
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+        fs.rmSync(resolvedPath, { recursive: true, force: true });
+    });
+    it('updates an extracted resource when the application has been updated', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const resourcePath = path.join(archivePath, 'scripts');
+        await provider.resolveExternalPath(resourcePath);
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello again' });
+        const resolvedPath = await createProvider().resolveExternalPath(resourcePath);
+        (0, chai_1.expect)(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello again');
+    });
+});
+//# sourceMappingURL=bundled-resource-provider.spec.js.map

package/lib/node/bundled-resource-provider.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundled-resource-provider.spec.js","sourceRoot":"","sources":["../../src/node/bundled-resource-provider.spec.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;AAEhF,4BAA0B;AAC1B,+BAA8B;AAC9B,yBAAyB;AACzB,yBAAyB;AACzB,6BAA6B;AAC7B,6BAA6B;AAC7B,yCAAsC;AACtC,2DAA6D;AAC7D,6CAA2C;AAC3C,4DAAwD;AACxD,iDAA6C;AAC7C,2EAAmG;AACnG,6DAAgF;AAEhF;;;;GAIG;AACH,QAAQ,CAAC,yBAAyB,EAAE,GAAG,EAAE;IAErC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAE3B,IAAI,SAAiB,CAAC;IACtB,IAAI,MAAc,CAAC;IACnB,IAAI,QAAiC,CAAC;IAEtC,UAAU,CAAC,GAAG,EAAE;QACZ,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,EAAE,CAAC;QAC/B,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QACtC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAChC,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC;QACxB,EAAE,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrB,QAAQ,GAAG,cAAc,EAAE,CAAC;IAChC,CAAC,CAAC,CAAC;IAEH,kGAAkG;IAClG,SAAS,cAAc;QACnB,MAAM,SAAS,GAAG,IAAI,qBAAS,EAAE,CAAC;QAClC,SAAS,CAAC,IAAI,CAAC,gBAAO,CAAC,CAAC,eAAe,CAAC,IAAI,wBAAU,EAAE,CAAC,CAAC;QAC1D,SAAS,CAAC,IAAI,CAAC,sCAAiB,CAAC,CAAC,EAAE,CAAC,0CAAqB,CAAC,CAAC,gBAAgB,EAAE,CAAC;QAC/E,SAAS,CAAC,IAAI,CAAC,kCAAkB,CAAC,CAAC,eAAe,CAAC;YAC/C,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC,kBAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,QAAQ,EAAE;SACnC,CAAC,CAAC;QACpC,SAAS,CAAC,IAAI,CAAC,uDAA2B,CAAC,CAAC,MAAM,EAAE,CAAC,gBAAgB,EAAE,CAAC;QACxE,SAAS,CAAC,IAAI,CAAC,mDAAuB,CAAC,CAAC,SAAS,CAAC,uDAA2B,CAAC,CAAC;QAC/E,OAAO,SAAS,CAAC,GAAG,CAAC,mDAAuB,CAAC,CAAC;IAClD,CAAC;IAED,SAAS,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IAErC;;;;OAIG;IACH,SAAS,cAAc,CAAC,aAAqB,EAAE,UAAkB;QAC7D,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;QAC9D,IAAA,aAAM,EAAC,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,KAAK,CAAC;QACrC,IAAA,aAAM,EAAC,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC9D,CAAC;IAED,SAAS,cAAc,CAAC,QAAgB,EAAE,KAA6B;QACnE,KAAK,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACnD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAC1D,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACxC,CAAC;QACD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAED,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,EAAE,SAAS,CAAC,CAAC;QACxG,IAAA,aAAM,EAAC,MAAM,QAAQ,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACpF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,KAAK,IAAI,EAAE;QACxD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;QAClD,MAAM,QAAQ,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,IAAI,CACjD,GAAG,EAAE,CAAC,aAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,EAC9C,KAAK,CAAC,EAAE,CAAC,IAAA,aAAM,EAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,YAAY,CAAC,CAC1D,CAAC;IACN,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,wBAAwB,EAAE,QAAQ,EAAE,CAAC,CAAC;QAEtG,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QAE3F,IAAA,aAAM,EAAC,YAAY,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAC7C,cAAc,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxC,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5F,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,SAAS,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACrG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;QAC/D,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAElE,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;QAEvG,cAAc,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxC,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,KAAK;QAC9C,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;YAC/B,IAAI,CAAC,IAAI,EAAE,CAAC;QAChB,CAAC;QACD,kFAAkF;QAClF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,aAAa,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,KAAK,CAAC,CAAC;QAE9D,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;QAElG,IAAA,aAAM,EAAC,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,cAAc,CAAC,GAAG,WAAW,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAErG,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QAE3F,IAAA,aAAM,EAAC,YAAY,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC,CAAC;IACtE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,KAAK,IAAI,EAAE;QAC3E,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,qBAAqB,EAAE,UAAU,EAAE,CAAC,CAAC;QACrG,cAAc,CAAC,GAAG,WAAW,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAEhF,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QAE3F,cAAc,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QACxC,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,aAAa,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACjG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0EAA0E,EAAE,KAAK,IAAI,EAAE;QACtF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEvD,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACtE,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE7C,IAAA,aAAM,EAAC,MAAM,QAAQ,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAChF,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IAChG,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yFAAyF,EAAE,KAAK,IAAI,EAAE;QACrG,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,uFAAuF;QACvF,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;QACjD,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAEhC,MAAM,YAAY,GAAG,MAAM,cAAc,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAC;QAEnG,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,YAAY,CAAC,CAAC;QAC1C,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QAC5F,EAAE,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,qEAAqE,EAAE,KAAK,IAAI,EAAE;QACjF,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QAClD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,YAAY,EAAE,CAAC,CAAC;QAClE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAEvD,MAAM,QAAQ,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QACjD,cAAc,CAAC,WAAW,EAAE,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,CAAC,CAAC;QACxE,MAAM,YAAY,GAAG,MAAM,cAAc,EAAE,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAE9E,IAAA,aAAM,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC;IACtG,CAAC,CAAC,CAAC;AAEP,CAAC,CAAC,CAAC"}

package/lib/node/index.d.ts

@@ -6,6 +6,7 @@ export * from './messaging';
 export * from './cli';
 export * from './setting-service';
 export { FileSystemLocking } from './filesystem-locking';
+export { BundledResourceProvider } from './bundled-resource-provider';
 export { BackendRequestAllowedContribution } from './request/backend-request-facade';
 export { HttpConnectionValidator } from './hosting/browser-connection-token';
 //# sourceMappingURL=index.d.ts.map

package/lib/node/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":"AAgBA,cAAc,uBAAuB,CAAC;AACtC,cAAc,kBAAkB,CAAC;AACjC,cAAc,SAAS,CAAC;AACxB,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,mBAAmB,CAAC;AAClC,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AACtE,OAAO,EAAE,iCAAiC,EAAE,MAAM,kCAAkC,CAAC;AACrF,OAAO,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC"}

package/lib/node/index.js

@@ -15,7 +15,7 @@
 // SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
 // *****************************************************************************
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.HttpConnectionValidator = exports.BackendRequestAllowedContribution = exports.FileSystemLocking = void 0;
+exports.HttpConnectionValidator = exports.BackendRequestAllowedContribution = exports.BundledResourceProvider = exports.FileSystemLocking = void 0;
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./backend-application"), exports);
 tslib_1.__exportStar(require("./backend-global"), exports);
@@ -26,6 +26,8 @@ tslib_1.__exportStar(require("./cli"), exports);
 tslib_1.__exportStar(require("./setting-service"), exports);
 var filesystem_locking_1 = require("./filesystem-locking");
 Object.defineProperty(exports, "FileSystemLocking", { enumerable: true, get: function () { return filesystem_locking_1.FileSystemLocking; } });
+var bundled_resource_provider_1 = require("./bundled-resource-provider");
+Object.defineProperty(exports, "BundledResourceProvider", { enumerable: true, get: function () { return bundled_resource_provider_1.BundledResourceProvider; } });
 var backend_request_facade_1 = require("./request/backend-request-facade");
 Object.defineProperty(exports, "BackendRequestAllowedContribution", { enumerable: true, get: function () { return backend_request_facade_1.BackendRequestAllowedContribution; } });
 var browser_connection_token_1 = require("./hosting/browser-connection-token");

package/lib/node/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,gEAAsC;AACtC,2DAAiC;AACjC,kDAAwB;AACxB,6DAAmC;AACnC,sDAA4B;AAC5B,gDAAsB;AACtB,4DAAkC;AAClC,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,2EAAqF;AAA5E,2IAAA,iCAAiC,OAAA;AAC1C,+EAA6E;AAApE,mIAAA,uBAAuB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/node/index.ts"],"names":[],"mappings":";AAAA,gFAAgF;AAChF,yCAAyC;AACzC,EAAE;AACF,2EAA2E;AAC3E,mEAAmE;AACnE,wCAAwC;AACxC,EAAE;AACF,4EAA4E;AAC5E,8EAA8E;AAC9E,6EAA6E;AAC7E,yDAAyD;AACzD,uDAAuD;AACvD,EAAE;AACF,gFAAgF;AAChF,gFAAgF;;;;AAEhF,gEAAsC;AACtC,2DAAiC;AACjC,kDAAwB;AACxB,6DAAmC;AACnC,sDAA4B;AAC5B,gDAAsB;AACtB,4DAAkC;AAClC,2DAAyD;AAAhD,uHAAA,iBAAiB,OAAA;AAC1B,yEAAsE;AAA7D,oIAAA,uBAAuB,OAAA;AAChC,2EAAqF;AAA5E,2IAAA,iCAAiC,OAAA;AAC1C,+EAA6E;AAApE,mIAAA,uBAAuB,OAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theia/core",
-  "version": "1.77.0-next.1+8b94967c4",
+  "version": "1.77.0-next.6+c1feaf3f9",
   "description": "Theia is a cloud & desktop IDE framework implemented in TypeScript.",
   "main": "lib/common/index.js",
   "typings": "lib/common/index.d.ts",
@@ -17,8 +17,8 @@
     "@lumino/virtualdom": "^2.0.5",
     "@lumino/widgets": "2.7.5",
     "@parcel/watcher": "^2.6.0",
-    "@theia/application-package": "1.77.0-next.1+8b94967c4",
-    "@theia/request": "1.77.0-next.1+8b94967c4",
+    "@theia/application-package": "1.77.0-next.6+c1feaf3f9",
+    "@theia/request": "1.77.0-next.6+c1feaf3f9",
     "@types/body-parser": "^1.19.6",
     "@types/express": "^4.17.25",
     "@types/fs-extra": "^4.0.15",
@@ -233,5 +233,5 @@
   "nyc": {
     "extends": "../../configs/nyc.json"
   },
-  "gitHead": "8b94967c4cfa0dcf688a345d28b3ac2e0d7e298a"
+  "gitHead": "c1feaf3f9adaa19555ccbc4eff7214b5a6601f53"
 }

package/src/node/backend-application-module.ts

@@ -57,6 +57,7 @@ import { bindNodeStopwatch, bindBackendStopwatchServer } from './performance';
 import { OSBackendProviderImpl } from './os-backend-provider';
 import { BackendRequestFacade, BackendRequestAllowedContribution } from './request/backend-request-facade';
 import { FileSystemLocking, FileSystemLockingImpl } from './filesystem-locking';
+import { BundledResourceProvider, BundledResourceProviderImpl } from './bundled-resource-provider';
 import { BackendRemoteService } from './remote/backend-remote-service';
 import { RemoteCliContribution } from './remote/remote-cli-contribution';
 import { SettingService, SettingServiceImpl } from './setting-service';
@@ -164,6 +165,9 @@ export const backendApplicationModule = new ContainerModule(bind => {
 
     bind(FileSystemLocking).to(FileSystemLockingImpl).inSingletonScope();
 
+    bind(BundledResourceProviderImpl).toSelf().inSingletonScope();
+    bind(BundledResourceProvider).toService(BundledResourceProviderImpl);
+
     bind(SettingServiceImpl).toSelf().inSingletonScope();
     bind(SettingService).toService(SettingServiceImpl);
 

package/src/node/bundled-resource-provider.spec.ts

@@ -0,0 +1,196 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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
+// *****************************************************************************
+
+import 'reflect-metadata';
+import { expect } from 'chai';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import * as temp from 'temp';
+import { Container } from 'inversify';
+import { EnvVariablesServer } from '../common/env-variables';
+import { ILogger } from '../common/logger';
+import { MockLogger } from '../common/test/mock-logger';
+import { FileUri } from '../common/file-uri';
+import { BundledResourceProvider, BundledResourceProviderImpl } from './bundled-resource-provider';
+import { FileSystemLocking, FileSystemLockingImpl } from './filesystem-locking';
+
+/**
+ * The provider recognizes archives by their `.asar` path segment and reads them through `fs`, which Electron
+ * patches to transparently read from the archive. Plain directories named `*.asar` therefore behave like
+ * archives from the point of view of the provider and let us test it outside of Electron.
+ */
+describe('BundledResourceProvider', () => {
+
+    const track = temp.track();
+
+    let configDir: string;
+    let appDir: string;
+    let provider: BundledResourceProvider;
+
+    beforeEach(() => {
+        const root = track.mkdirSync();
+        configDir = path.join(root, 'config');
+        appDir = path.join(root, 'app');
+        fs.mkdirSync(configDir);
+        fs.mkdirSync(appDir);
+        provider = createProvider();
+    });
+
+    /** Each provider instance stands for one run of the application, as resolved paths are cached. */
+    function createProvider(): BundledResourceProvider {
+        const container = new Container();
+        container.bind(ILogger).toConstantValue(new MockLogger());
+        container.bind(FileSystemLocking).to(FileSystemLockingImpl).inSingletonScope();
+        container.bind(EnvVariablesServer).toConstantValue({
+            getConfigDirUri: async () => FileUri.create(configDir).toString()
+        } as unknown as EnvVariablesServer);
+        container.bind(BundledResourceProviderImpl).toSelf().inSingletonScope();
+        container.bind(BundledResourceProvider).toService(BundledResourceProviderImpl);
+        return container.get(BundledResourceProvider);
+    }
+
+    afterEach(() => track.cleanupSync());
+
+    /**
+     * Assert that the given path is nested in the given directory. The provider derives the configuration
+     * directory from a URI, which on Windows yields a lower-case drive letter, so the paths cannot simply be
+     * compared by prefix. `path.relative` ignores the case of a path on Windows.
+     */
+    function expectNestedIn(directoryPath: string, nestedPath: string): void {
+        const relativePath = path.relative(directoryPath, nestedPath);
+        expect(relativePath).to.not.be.empty;
+        expect(relativePath.split(path.sep)).to.not.contain('..');
+    }
+
+    function writeResources(rootPath: string, files: Record<string, string>): string {
+        for (const [relativePath, content] of Object.entries(files)) {
+            const filePath = path.join(rootPath, relativePath);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, content);
+        }
+        return rootPath;
+    }
+
+    it('returns the path of a resource that is not packaged into an archive', async () => {
+        const resourcePath = path.join(writeResources(appDir, { 'scripts/greet.sh': 'echo hello' }), 'scripts');
+        expect(await provider.resolveExternalPath(resourcePath)).to.equal(resourcePath);
+    });
+
+    it('rejects for a resource that does not exist', async () => {
+        const resourcePath = path.join(appDir, 'scripts');
+        await provider.resolveExternalPath(resourcePath).then(
+            () => expect.fail('should have been rejected'),
+            error => expect(String(error)).to.contain(resourcePath)
+        );
+    });
+
+    it('extracts a packaged resource into the configuration directory', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello', 'scripts/nested/.hidden': 'secret' });
+
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+
+        expect(resolvedPath).to.not.contain('.asar');
+        expectNestedIn(configDir, resolvedPath);
+        expect(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+        expect(fs.readFileSync(path.join(resolvedPath, 'nested', '.hidden'), 'utf8')).to.equal('secret');
+    });
+
+    it('extracts a packaged resource that is a plain file', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts', 'greet.sh'));
+
+        expectNestedIn(configDir, resolvedPath);
+        expect(fs.readFileSync(resolvedPath, 'utf8')).to.equal('echo hello');
+    });
+
+    it('extracts a packaged file as executable', async function (): Promise<void> {
+        if (process.platform === 'win32') {
+            this.skip();
+        }
+        // Electron reports the files of an asar archive with this mode, even executables.
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'native/tool': 'binary' });
+        fs.chmodSync(path.join(archivePath, 'native', 'tool'), 0o644);
+
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'native', 'tool'));
+
+        expect(fs.statSync(resolvedPath).mode & 0o700).to.equal(0o700);
+    });
+
+    it('prefers the copy that the packaging step has left outside of the archive', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const unpackedPath = writeResources(`${archivePath}.unpacked`, { 'scripts/greet.sh': 'echo hello' });
+
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+
+        expect(resolvedPath).to.equal(path.join(unpackedPath, 'scripts'));
+    });
+
+    it('extracts a packaged resource that was only unpacked partially', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello', 'scripts/farewell.sh': 'echo bye' });
+        writeResources(`${archivePath}.unpacked`, { 'scripts/greet.sh': 'echo hello' });
+
+        const resolvedPath = await provider.resolveExternalPath(path.join(archivePath, 'scripts'));
+
+        expectNestedIn(configDir, resolvedPath);
+        expect(fs.readFileSync(path.join(resolvedPath, 'farewell.sh'), 'utf8')).to.equal('echo bye');
+    });
+
+    it('re-extracts a resource that was removed from the configuration directory', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const resourcePath = path.join(archivePath, 'scripts');
+
+        const resolvedPath = await provider.resolveExternalPath(resourcePath);
+        fs.rmSync(resolvedPath, { recursive: true });
+
+        expect(await provider.resolveExternalPath(resourcePath)).to.equal(resolvedPath);
+        expect(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+    });
+
+    it('extracts into a temporary directory if the configuration directory cannot be written to', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        // a configuration directory that is a regular file cannot hold the extracted resources
+        configDir = path.join(appDir, 'not-a-directory');
+        fs.writeFileSync(configDir, '');
+
+        const resolvedPath = await createProvider().resolveExternalPath(path.join(archivePath, 'scripts'));
+
+        expectNestedIn(os.tmpdir(), resolvedPath);
+        expect(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello');
+        fs.rmSync(resolvedPath, { recursive: true, force: true });
+    });
+
+    it('updates an extracted resource when the application has been updated', async () => {
+        const archivePath = path.join(appDir, 'app.asar');
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello' });
+        const resourcePath = path.join(archivePath, 'scripts');
+
+        await provider.resolveExternalPath(resourcePath);
+        writeResources(archivePath, { 'scripts/greet.sh': 'echo hello again' });
+        const resolvedPath = await createProvider().resolveExternalPath(resourcePath);
+
+        expect(fs.readFileSync(path.join(resolvedPath, 'greet.sh'), 'utf8')).to.equal('echo hello again');
+    });
+
+});

package/src/node/bundled-resource-provider.ts

@@ -0,0 +1,266 @@
+// *****************************************************************************
+// Copyright (C) 2026 EclipseSource GmbH and others.
+//
+// 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
+// *****************************************************************************
+
+import * as crypto from 'crypto';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { inject, injectable, interfaces, named } from 'inversify';
+import { EnvVariablesServer } from '../common/env-variables';
+import { FileUri } from '../common/file-uri';
+import { ILogger } from '../common/logger';
+import { FileSystemLocking } from './filesystem-locking';
+
+export const BundledResourceProvider = Symbol('BundledResourceProvider') as symbol & interfaces.Abstract<BundledResourceProvider>;
+/**
+ * Provides paths to resources that are bundled with the application, in a form that can also be used by
+ * processes which do not run inside the application, such as shells, debug adapters or other external tools.
+ *
+ * When an Electron application is packaged with `asar: true`, the resources of the application are stored in
+ * an `app.asar` archive. Paths pointing into such an archive can only be read through Electron's patched `fs`
+ * module, so handing them to an external process fails. Therefore, always resolve a bundled resource through
+ * this service before passing its path to a process outside of the application.
+ */
+export interface BundledResourceProvider {
+    /**
+     * Resolve the given path of a bundled file or directory to a path that external processes can read.
+     *
+     * If the resource is not packaged into an archive, its path is returned unchanged. Otherwise the copy that
+     * the packaging step has left outside of the archive is used, if it is complete, and the resource is
+     * extracted from the archive into the configuration directory as a last resort.
+     *
+     * Results are cached, so that a resource is extracted at most once per application version.
+     *
+     * @param resourcePath the path of the bundled resource, typically resolved against `__dirname`.
+     * @returns the path to use outside of the application.
+     * @throws if the resource does not exist or cannot be made available.
+     */
+    resolveExternalPath(resourcePath: string): Promise<string>;
+}
+
+@injectable()
+export class BundledResourceProviderImpl implements BundledResourceProvider {
+
+    @inject(ILogger) @named('core:BundledResourceProviderImpl')
+    protected readonly logger: ILogger;
+
+    @inject(EnvVariablesServer)
+    protected readonly envVariablesServer: EnvVariablesServer;
+
+    @inject(FileSystemLocking)
+    protected readonly fileSystemLocking: FileSystemLocking;
+
+    /** The folder within the configuration directory into which resources are extracted. */
+    protected readonly extractionFolder = 'bundled-resources';
+
+    /** Resources extracted for another application version are removed when they are older than this. */
+    protected readonly staleExtractionAge = 7 * 24 * 60 * 60 * 1000;
+
+    protected readonly resolved = new Map<string, Promise<string>>();
+    protected temporaryExtractionPath: Promise<string> | undefined;
+
+    async resolveExternalPath(resourcePath: string): Promise<string> {
+        const normalizedPath = path.resolve(resourcePath);
+        const pending = this.resolved.get(normalizedPath);
+        if (pending) {
+            try {
+                const resolvedPath = await pending;
+                if (await this.exists(resolvedPath)) {
+                    return resolvedPath;
+                }
+            } catch {
+                // the previous attempt failed, so try again below
+            }
+            this.resolved.delete(normalizedPath);
+        }
+        const result = this.doResolveExternalPath(normalizedPath);
+        this.resolved.set(normalizedPath, result);
+        return result;
+    }
+
+    protected async doResolveExternalPath(resourcePath: string): Promise<string> {
+        if (!await this.exists(resourcePath)) {
+            throw new Error(`Bundled resource does not exist: ${resourcePath}`);
+        }
+        const archivePath = this.findArchivePath(resourcePath);
+        if (!archivePath) {
+            // The resource is not packaged into an archive, so external processes can read it directly.
+            return resourcePath;
+        }
+        const relativePath = path.relative(archivePath, resourcePath);
+        const unpackedPath = path.join(`${archivePath}.unpacked`, relativePath);
+        if (await this.isExtracted(resourcePath, unpackedPath)) {
+            return unpackedPath;
+        }
+        const extractionPath = path.join(await this.getExtractionPath(archivePath), relativePath);
+        await this.fileSystemLocking.lockPath(archivePath, () => this.extract(resourcePath, extractionPath));
+        this.logger.info(`Extracted bundled resource '${resourcePath}' to '${extractionPath}'.`);
+        return extractionPath;
+    }
+
+    /**
+     * Find the archive that the given resource is packaged into, if any.
+     *
+     * @returns the path of the archive, i.e. the shortest prefix of the given path ending in an `.asar` segment,
+     * which is also how Electron itself determines the archive that a path refers to.
+     */
+    protected findArchivePath(resourcePath: string): string | undefined {
+        const segments = resourcePath.split(/[\\/]/);
+        const archiveIndex = segments.findIndex(segment => segment.toLowerCase().endsWith('.asar'));
+        return archiveIndex < 0 ? undefined : segments.slice(0, archiveIndex + 1).join(path.sep);
+    }
+
+    /**
+     * Whether every file of the given resource is already available at the given target path. Packaging tools
+     * only unpack the files that the application configured them to unpack, so a partial copy must be ignored.
+     */
+    protected async isExtracted(resourcePath: string, targetPath: string): Promise<boolean> {
+        for (const file of await this.collectFiles(resourcePath)) {
+            if (!await this.exists(path.join(targetPath, file))) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    protected async extract(resourcePath: string, targetPath: string): Promise<void> {
+        for (const file of await this.collectFiles(resourcePath)) {
+            await this.copyFile(path.join(resourcePath, file), path.join(targetPath, file));
+        }
+    }
+
+    /**
+     * Collect the files of the given resource as paths relative to it. The relative path of a resource that is
+     * a plain file is the empty string.
+     */
+    protected async collectFiles(resourcePath: string, relativePath: string = ''): Promise<string[]> {
+        const currentPath = path.join(resourcePath, relativePath);
+        if (!(await fs.promises.stat(currentPath)).isDirectory()) {
+            return [relativePath];
+        }
+        const files: string[] = [];
+        for (const entry of await fs.promises.readdir(currentPath)) {
+            files.push(...await this.collectFiles(resourcePath, path.join(relativePath, entry)));
+        }
+        return files;
+    }
+
+    protected async copyFile(sourcePath: string, targetPath: string): Promise<void> {
+        const sourceStat = await fs.promises.stat(sourcePath);
+        if (await this.isUpToDate(targetPath, sourceStat)) {
+            return;
+        }
+        await fs.promises.mkdir(path.dirname(targetPath), { recursive: true, mode: 0o700 });
+        // Write to a temporary file and move it into place, so that a concurrently starting application
+        // instance never reads partially written content.
+        const temporaryPath = `${targetPath}.${process.pid}.tmp`;
+        try {
+            // Electron reports the files of an asar archive as not executable, even those that the archive marks as
+            // executable, so every extracted file is made executable for the owner to keep bundled executables usable.
+            await fs.promises.writeFile(temporaryPath, await fs.promises.readFile(sourcePath), { mode: sourceStat.mode & 0o777 | 0o700 });
+            try {
+                await fs.promises.rename(temporaryPath, targetPath);
+            } catch {
+                // renaming onto an existing file is not supported on all platforms
+                await fs.promises.rm(targetPath, { force: true });
+                await fs.promises.rename(temporaryPath, targetPath);
+            }
+        } finally {
+            await fs.promises.rm(temporaryPath, { force: true });
+        }
+    }
+
+    protected async isUpToDate(targetPath: string, sourceStat: fs.Stats): Promise<boolean> {
+        try {
+            return (await fs.promises.stat(targetPath)).size === sourceStat.size;
+        } catch {
+            return false;
+        }
+    }
+
+    /**
+     * The directory into which resources of the given archive are extracted. It is specific to the content of
+     * the archive, so that updating the application invalidates previously extracted copies.
+     */
+    protected async getExtractionPath(archivePath: string): Promise<string> {
+        const archiveName = path.basename(archivePath, path.extname(archivePath));
+        try {
+            const extractionRoot = path.join(FileUri.fsPath(await this.envVariablesServer.getConfigDirUri()), this.extractionFolder);
+            const extractionPath = path.join(extractionRoot, `${archiveName}-${this.getArchiveStamp(archivePath)}`);
+            await fs.promises.mkdir(extractionPath, { recursive: true, mode: 0o700 });
+            this.removeStaleExtractions(extractionRoot, `${archiveName}-`, extractionPath);
+            return extractionPath;
+        } catch (error) {
+            this.logger.warn('Could not extract bundled resources into the configuration directory, using a temporary directory instead.', error);
+            return this.getTemporaryExtractionPath();
+        }
+    }
+
+    /**
+     * Fallback for applications whose configuration directory cannot be written to. The directory is unique to
+     * this run of the application, so that resources are extracted again whenever the application is started.
+     */
+    protected getTemporaryExtractionPath(): Promise<string> {
+        return this.temporaryExtractionPath ??= fs.promises.mkdtemp(path.join(os.tmpdir(), 'theia-bundled-resources-'));
+    }
+
+    /**
+     * Identify the content of the given archive. `process.noAsar` is toggled around the synchronous `stat` call
+     * to get the stats of the archive file itself rather than of the directory that it appears as.
+     */
+    protected getArchiveStamp(archivePath: string): string {
+        const asarProcess = process as NodeJS.Process & { noAsar?: boolean };
+        const noAsar = asarProcess.noAsar;
+        try {
+            asarProcess.noAsar = true;
+            const stat = fs.statSync(archivePath);
+            return crypto.createHash('sha256').update(`${archivePath}:${stat.size}:${stat.mtimeMs}`).digest('hex').substring(0, 12);
+        } finally {
+            asarProcess.noAsar = noAsar;
+        }
+    }
+
+    /**
+     * Remove resources that were extracted from an earlier version of the archive, unless they were used
+     * recently, because another application instance may still be running on that version.
+     */
+    protected removeStaleExtractions(extractionRoot: string, prefix: string, currentPath: string): void {
+        const removeStale = async () => {
+            for (const entry of await fs.promises.readdir(extractionRoot)) {
+                const entryPath = path.join(extractionRoot, entry);
+                if (!entry.startsWith(prefix) || entryPath === currentPath) {
+                    continue;
+                }
+                const stat = await fs.promises.stat(entryPath);
+                if (Date.now() - stat.mtimeMs > this.staleExtractionAge) {
+                    await fs.promises.rm(entryPath, { recursive: true, force: true });
+                    this.logger.info(`Removed stale extracted resources: ${entryPath}`);
+                }
+            }
+        };
+        removeStale().catch(error => this.logger.warn(`Could not remove stale extracted resources in '${extractionRoot}'.`, error));
+    }
+
+    protected async exists(targetPath: string): Promise<boolean> {
+        try {
+            await fs.promises.stat(targetPath);
+            return true;
+        } catch {
+            return false;
+        }
+    }
+
+}

package/src/node/index.ts

@@ -22,5 +22,6 @@ export * from './messaging';
 export * from './cli';
 export * from './setting-service';
 export { FileSystemLocking } from './filesystem-locking';
+export { BundledResourceProvider } from './bundled-resource-provider';
 export { BackendRequestAllowedContribution } from './request/backend-request-facade';
 export { HttpConnectionValidator } from './hosting/browser-connection-token';