cdpotion

defmodule CDPotion.Domain.Browser do
  use CDPotion.Utils

  @doc """
  Set permission settings for given origin.
  ## Parameters:
    - `permission:PermissionDescriptor`: Descriptor of permission to override.
    - `setting:PermissionSetting`: Setting of the permission.
    - `origin:string`: (Optional) Origin the permission applies to, all origins if not specified.
    - `browserContextId:BrowserContextID`: (Optional) Context to override. When omitted, default browser context is used.
  """
  def set_permission(permission, setting, origin \\ nil, browser_context_id \\ nil) do
    params =
      as_query([
        {"permission", permission},
        {"setting", setting},
        {"origin", origin},
        {"browserContextId", browser_context_id}
      ])

    {"Browser.setPermission", params}
  end

  @doc """
  Grant specific permissions to the given origin and reject all others.
  ## Parameters:
    - `permissions:array`: description not provided :(
    - `origin:string`: (Optional) Origin the permission applies to, all origins if not specified.
    - `browserContextId:BrowserContextID`: (Optional) BrowserContext to override permissions. When omitted, default browser context is used.
  """
  def grant_permissions(permissions, origin \\ nil, browser_context_id \\ nil) do
    params =
      as_query([
        {"permissions", permissions},
        {"origin", origin},
        {"browserContextId", browser_context_id}
      ])

    {"Browser.grantPermissions", params}
  end

  @doc """
  Reset all permission management for all origins.
  ## Parameters:
    - `browserContextId:BrowserContextID`: (Optional) BrowserContext to reset permissions. When omitted, default browser context is used.
  """
  def reset_permissions(browser_context_id \\ nil) do
    params = as_query([{"browserContextId", browser_context_id}])
    {"Browser.resetPermissions", params}
  end

  @doc """
  Set the behavior when downloading a file.
  ## Parameters:
    - `behavior:string`: Whether to allow all or deny all download requests, or use default Chrome behavior if
  available (otherwise deny). |allowAndName| allows download and names files according to
  their dowmload guids.
    - `browserContextId:BrowserContextID`: (Optional) BrowserContext to set download behavior. When omitted, default browser context is used.
    - `downloadPath:string`: (Optional) The default path to save downloaded files to. This is required if behavior is set to 'allow'
  or 'allowAndName'.
    - `eventsEnabled:boolean`: (Optional) Whether to emit download events (defaults to false).
  """
  def set_download_behavior(
        behavior,
        browser_context_id \\ nil,
        download_path \\ nil,
        events_enabled \\ nil
      ) do
    params =
      as_query([
        {"behavior", behavior},
        {"browserContextId", browser_context_id},
        {"downloadPath", download_path},
        {"eventsEnabled", events_enabled}
      ])

    {"Browser.setDownloadBehavior", params}
  end

  @doc """
  Cancel a download if in progress
  ## Parameters:
    - `guid:string`: Global unique identifier of the download.
    - `browserContextId:BrowserContextID`: (Optional) BrowserContext to perform the action in. When omitted, default browser context is used.
  """
  def cancel_download(guid, browser_context_id \\ nil) do
    params = as_query([{"guid", guid}, {"browserContextId", browser_context_id}])
    {"Browser.cancelDownload", params}
  end

  @doc """
  Close browser gracefully.
  """
  def close() do
    {"Browser.close", %{}}
  end

  @doc """
  Crashes browser on the main thread.
  """
  def crash() do
    {"Browser.crash", %{}}
  end

  @doc """
  Crashes GPU process.
  """
  def crash_gpu_process() do
    {"Browser.crashGpuProcess", %{}}
  end

  @doc """
  Returns version information.
  """
  def get_version() do
    {"Browser.getVersion", %{}}
  end

  @doc """
  Returns the command line switches for the browser process if, and only if
  --enable-automation is on the commandline.
  """
  def get_browser_command_line() do
    {"Browser.getBrowserCommandLine", %{}}
  end

  @doc """
  Get Chrome histograms.
  ## Parameters:
    - `query:string`: (Optional) Requested substring in name. Only histograms which have query as a
  substring in their name are extracted. An empty or absent query returns
  all histograms.
    - `delta:boolean`: (Optional) If true, retrieve delta since last delta call.
  """
  def get_histograms(query \\ nil, delta \\ nil) do
    params = as_query([{"query", query}, {"delta", delta}])
    {"Browser.getHistograms", params}
  end

  @doc """
  Get a Chrome histogram by name.
  ## Parameters:
    - `name:string`: Requested histogram name.
    - `delta:boolean`: (Optional) If true, retrieve delta since last delta call.
  """
  def get_histogram(name, delta \\ nil) do
    params = as_query([{"name", name}, {"delta", delta}])
    {"Browser.getHistogram", params}
  end

  @doc """
  Get position and size of the browser window.
  ## Parameters:
    - `windowId:WindowID`: Browser window id.
  """
  def get_window_bounds(window_id) do
    params = as_query([{"windowId", window_id}])
    {"Browser.getWindowBounds", params}
  end

  @doc """
  Get the browser window that contains the devtools target.
  ## Parameters:
    - `targetId:Target.TargetID`: (Optional) Devtools agent host id. If called as a part of the session, associated targetId is used.
  """
  def get_window_for_target(target_id \\ nil) do
    params = as_query([{"targetId", target_id}])
    {"Browser.getWindowForTarget", params}
  end

  @doc """
  Set position and/or size of the browser window.
  ## Parameters:
    - `windowId:WindowID`: Browser window id.
    - `bounds:Bounds`: New window bounds. The 'minimized', 'maximized' and 'fullscreen' states cannot be combined
  with 'left', 'top', 'width' or 'height'. Leaves unspecified fields unchanged.
  """
  def set_window_bounds(window_id, bounds) do
    params = as_query([{"windowId", window_id}, {"bounds", bounds}])
    {"Browser.setWindowBounds", params}
  end

  @doc """
  Set dock tile details, platform-specific.
  ## Parameters:
    - `badgeLabel:string`: (Optional) description not provided :(
    - `image:string`: (Optional) Png encoded image. (Encoded as a base64 string when passed over JSON)
  """
  def set_dock_tile(badge_label \\ nil, image \\ nil) do
    params = as_query([{"badgeLabel", badge_label}, {"image", image}])
    {"Browser.setDockTile", params}
  end

  @doc """
  Invoke custom browser commands used by telemetry.
  ## Parameters:
    - `commandId:BrowserCommandId`: description not provided :(
  """
  def execute_browser_command(command_id) do
    params = as_query([{"commandId", command_id}])
    {"Browser.executeBrowserCommand", params}
  end

  @doc """
  Allows a site to use privacy sandbox features that require enrollment
  without the site actually being enrolled. Only supported on page targets.
  ## Parameters:
    - `url:string`: description not provided :(
  """
  def add_privacy_sandbox_enrollment_override(url) do
    params = as_query([{"url", url}])
    {"Browser.addPrivacySandboxEnrollmentOverride", params}
  end
end