// Copyright 2018 The Chromium Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

#ifndef EXTENSIONS_COMMON_EXTENSIONS_API_PROVIDER_H_
#define EXTENSIONS_COMMON_EXTENSIONS_API_PROVIDER_H_

#include <string>

#include "base/strings/string_piece_forward.h"

namespace extensions {
class FeatureProvider;
class JSONFeatureProviderSource;
class PermissionsInfo;

// A class to provide API-specific bits and bobs to the extensions system.
// This allows for composition of multiple providers, so that we can easily
// selectively add features in different configurations.
class ExtensionsAPIProvider {
 public:
  ExtensionsAPIProvider() = default;
  ExtensionsAPIProvider(const ExtensionsAPIProvider&) = delete;
  ExtensionsAPIProvider& operator=(const ExtensionsAPIProvider&) = delete;
  virtual ~ExtensionsAPIProvider() = default;

  // Adds feature definitions to the given |provider| of the specified type.
  virtual void AddAPIFeatures(FeatureProvider* provider) = 0;
  virtual void AddManifestFeatures(FeatureProvider* provider) = 0;
  virtual void AddPermissionFeatures(FeatureProvider* provider) = 0;
  virtual void AddBehaviorFeatures(FeatureProvider* provider) = 0;

  // Adds resources containing the JSON API definitions.
  virtual void AddAPIJSONSources(JSONFeatureProviderSource* json_source) = 0;

  // Returns true if this provider knows about a generated schema for the given
  // api |name|.
  virtual bool IsAPISchemaGenerated(const std::string& name) = 0;

  // Returns a the contents of the generated schema for the given api |name|,
  // or an empty string if this provider doesn't know of the generated API.
  virtual base::StringPiece GetAPISchema(const std::string& name) = 0;

  // Registers permissions for any associated API features.
  virtual void RegisterPermissions(PermissionsInfo* permissions_info) = 0;

  // Registers manifest handlers for any associated API features.
  virtual void RegisterManifestHandlers() = 0;
};

}  // namespace extensions

#endif  // EXTENSIONS_COMMON_EXTENSIONS_API_PROVIDER_H_