ios/web/web_state/ui/crw_media_capture_permission_request.h

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

#ifndef IOS_WEB_WEB_STATE_UI_CRW_MEDIA_CAPTURE_PERMISSION_REQUEST_H_
#define IOS_WEB_WEB_STATE_UI_CRW_MEDIA_CAPTURE_PERMISSION_REQUEST_H_

#import <WebKit/WebKit.h>

#import "base/memory/scoped_refptr.h"
#import "url/gurl.h"

namespace base {
class SequencedTaskRunner;
}  // namespace base

namespace web {
class WebStateImpl;
}  // namespace web

/// Object that manages the media capture permission request; usually the owner.
@protocol CRWMediaCapturePermissionPresenter <NSObject>

/// Web state that the media capture permission would take effect on.
- (web::WebStateImpl*)presentingWebState;

@end

/// Encapsulation of the media capture permission request from a WKWebView,
/// which displays a prompt on the main thread , handles user response and deals
/// with edge cases.
@interface CRWMediaCapturePermissionRequest : NSObject

/// The object that initiates the presentation the media capture permission.
@property(nonatomic, weak) id<CRWMediaCapturePermissionPresenter> presenter;

/// Initializer for the request.
- (instancetype)initWithDecisionHandler:
                    (void (^)(WKPermissionDecision decision))decisionHandler
                           onTaskRunner:
                               (const scoped_refptr<base::SequencedTaskRunner>&)
                                   taskRunner;

/// Displays a prompt to users and ask capture permission for `mediaCaptureType`
/// coming from a page with the given `origin`.
- (void)displayPromptForMediaCaptureType:(WKMediaCaptureType)mediaCaptureType
                                  origin:(const GURL&)origin;

@end

#endif  // IOS_WEB_WEB_STATE_UI_CRW_MEDIA_CAPTURE_PERMISSION_REQUEST_H_