chrome/renderer/extensions/api/app_hooks_delegate.h

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

#ifndef CHROME_RENDERER_EXTENSIONS_API_APP_HOOKS_DELEGATE_H_
#define CHROME_RENDERER_EXTENSIONS_API_APP_HOOKS_DELEGATE_H_

#include <string>

#include "base/memory/raw_ptr.h"
#include "base/memory/weak_ptr.h"
#include "extensions/renderer/bindings/api_binding_hooks_delegate.h"
#include "v8/include/v8.h"

namespace extensions {
class APIRequestHandler;
class Dispatcher;
class IPCMessageSender;
class ScriptContext;

// The custom hooks for the chrome.app API.
class AppHooksDelegate : public APIBindingHooksDelegate {
 public:
  AppHooksDelegate(Dispatcher* dispatcher,
                   APIRequestHandler* request_handler,
                   IPCMessageSender* ipc_sender);

  AppHooksDelegate(const AppHooksDelegate&) = delete;
  AppHooksDelegate& operator=(const AppHooksDelegate&) = delete;

  ~AppHooksDelegate() override;

  // APIBindingHooksDelegate:
  APIBindingHooks::RequestResult HandleRequest(
      const std::string& method_name,
      const APISignature* signature,
      v8::Local<v8::Context> context,
      v8::LocalVector<v8::Value>* arguments,
      const APITypeReferenceMap& refs) override;
  void InitializeTemplate(v8::Isolate* isolate,
                          v8::Local<v8::ObjectTemplate> object_template,
                          const APITypeReferenceMap& type_refs) override;

  // Total misnomer. Returns true if there is a hosted app associated with
  // |script_context| active in this process. This naming is to match the
  // chrome.app function it implements.
  bool GetIsInstalled(ScriptContext* script_context) const;

 private:
  static void IsInstalledGetterCallback(
      v8::Local<v8::Name> property,
      const v8::PropertyCallbackInfo<v8::Value>& info);

  // Returns the manifest of the extension associated with the frame.
  v8::Local<v8::Value> GetDetails(ScriptContext* script_context) const;

  // Determines the install state for the extension associated with the frame.
  // Note that this could be "disabled" for hosted apps when the user visits the
  // site but doesn't have the app enabled. The response is determined
  // asynchronously before completing the request with the given |request_id|.
  void GetInstallState(ScriptContext* script_context, int request_id);

  // Returns the "running state" (one of running, cannot run, and ready to run)
  // for the extension associated with the frame of the script context.
  const char* GetRunningState(ScriptContext* script_context) const;

  // Handles the reply from GetInstallState().
  void OnAppInstallStateResponse(int request_id, const std::string& state);

  // Dispatcher handle. Not owned.
  raw_ptr<Dispatcher> dispatcher_ = nullptr;

  raw_ptr<APIRequestHandler> request_handler_ = nullptr;

  // IPC sender used for activity log call.
  // Not owned. This is owned by NativeExtensionBindingsSystem.
  raw_ptr<IPCMessageSender> ipc_sender_ = nullptr;

  base::WeakPtrFactory<AppHooksDelegate> weak_factory_{this};
};

}  // namespace extensions

#endif  // CHROME_RENDERER_EXTENSIONS_API_APP_HOOKS_DELEGATE_H_