1
    2
    3
    4
    5
    6
    7
    8
    9
   10
   11
   12
   13
   14
   15
   16
   17
   18
   19
   20
   21
   22
   23
   24
   25
   26
   27
   28
   29
   30
   31
   32
   33
   34
   35
   36
   37
   38
   39
   40
   41
   42
   43
   44
   45
   46
   47
   48
   49
   50
   51
   52
   53
   54
   55
   56
   57
   58
   59
   60
   61
   62
   63
   64
   65
   66
   67
   68
   69
   70
   71
   72
   73
   74
   75
   76
   77
   78
   79
   80
   81
   82
   83
   84
   85
   86
   87
   88
   89


ash / scanner / scanner_command.h [blame]

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

#ifndef ASH_SCANNER_SCANNER_COMMAND_H_
#define ASH_SCANNER_SCANNER_COMMAND_H_

#include <memory>
#include <string>
#include <string_view>
#include <variant>

#include "ash/ash_export.h"
#include "google_apis/people/people_api_request_types.h"
#include "url/gurl.h"

namespace ui {
class ClipboardData;
}

namespace ash {

// Command to open a URL in the browser.
struct ASH_EXPORT OpenUrlCommand {
  GURL url;

  explicit OpenUrlCommand(GURL url);

  OpenUrlCommand(const OpenUrlCommand&);
  OpenUrlCommand& operator=(const OpenUrlCommand&);
  OpenUrlCommand(OpenUrlCommand&&);
  OpenUrlCommand& operator=(OpenUrlCommand&&);

  ~OpenUrlCommand();
};

// Command to upload contents to Google Drive with the given MIME type,
// then open the resulting Google Workspace document.
struct ASH_EXPORT DriveUploadCommand {
  std::string title;
  std::string contents;
  std::string contents_mime_type;
  // Assumed to have static lifetime.
  std::string_view converted_mime_type;

  DriveUploadCommand(std::string title,
                     std::string contents,
                     std::string contents_mime_type,
                     std::string_view converted_mime_type);

  DriveUploadCommand(const DriveUploadCommand&);
  DriveUploadCommand& operator=(const DriveUploadCommand&);
  DriveUploadCommand(DriveUploadCommand&&);
  DriveUploadCommand& operator=(DriveUploadCommand&&);

  ~DriveUploadCommand();
};

struct ASH_EXPORT CopyToClipboardCommand {
  std::unique_ptr<ui::ClipboardData> clipboard_data;

  explicit CopyToClipboardCommand(
      std::unique_ptr<ui::ClipboardData> clipboard_data);

  CopyToClipboardCommand(CopyToClipboardCommand&&);
  CopyToClipboardCommand& operator=(CopyToClipboardCommand&&);

  ~CopyToClipboardCommand();
};

// Command to create a new contact in Google Contacts, then open the created
// contact's page in the Google Contacts web interface.
struct ASH_EXPORT CreateContactCommand {
  google_apis::people::Contact contact;
};

// Holds a single command that can be applied to the system. Used as an
// intermediate step between an `ash::ScannerAction` and performing the command.
// In some cases where `ash::ScannerAction` defines a very specific action
// without any preprocessing, the command type may be the same as the action
// type.
using ScannerCommand = std::variant<OpenUrlCommand,
                                    DriveUploadCommand,
                                    CopyToClipboardCommand,
                                    CreateContactCommand>;

}  // namespace ash

#endif  // ASH_SCANNER_SCANNER_COMMAND_H_