Function scanExtensions

src/back/extensions/ExtensionsScanner.ts:67–114

(configData: AppConfigData, extensionPath: string)

 * @param extensionPath Path to extensions folder
 */
export async function scanExtensions(configData: AppConfigData, extensionPath: string): Promise<IExtension[]> {
  const result = new Map<string, IExtension>();

  // TODO: System extensions (?)

  // User extensions
  const userExtPath = path.resolve(extensionPath);
  await fs.promises.access(userExtPath, fs.constants.F_OK | fs.constants.R_OK)
  .then(() => {/** Folder exists */})
  .catch(() => fs.promises.mkdir(userExtPath));
  await fsPromises.readdir(userExtPath)
  .then(filenames => {
    // Each folder inside is an Extension
    return Promise.all(filenames.map(async filename => {
      // Make sure it is a folder or symlink folder
      const stats = await fs.promises.stat(path.join(userExtPath, filename));
      if (!stats.isDirectory()) { return; }
      // Read Manifest
      const manifestPath = path.join(userExtPath, filename, 'package.json');
      return fsPromises.stat(manifestPath)
      .then(async (stats) => {
        // Manifest file (package.json) exists, continue loading extension
        if (stats.isFile()) {
          await fsPromises.access(manifestPath);
          const ext = await parseExtension(manifestPath, ExtensionType.User);
          if (UNSUPPORTED_EXTENSION_IDS.includes(ext.id)) {
            log.warn('Extensions', `Ignoring Extension ${ext.id} because of replacement with system extension.`);
            return;
          }
          if (result.get(ext.id) !== undefined) {
            // An Extension with the same id has been registered earlier, latest read survives
            log.warn('Extensions', `Overriding Extension ${ext.id} with extension at "${path.join(userExtPath, filename)}"`);
          }
          result.set(ext.id, ext);
        }
      })
      .catch(err => log.error('Extensions', `Error loading User extension at "${filename}"\n${err}`));
    }));
  });

  // Convert the map to an array and return
  const r: IExtension[] = [];
  result.forEach((ext) => {
    log.debug('Extensions', `Extension Scanned "${ext.manifest.displayName || ext.manifest.name}" (${ext.id})`);
    r.push(ext);
  });
  return r;
}

/**
 * Returns the extensions ID given its author and name from its manifest