[webview_flutter] Initial v4.0 platform interface implementation

packages/webview_flutter/webview_flutter_platform_interface/lib/src/v4/navigation_callback_handler_delegate.dart

@@ -0,0 +1,83 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:async';
+
+import 'package:flutter/foundation.dart';
+import 'package:plugin_platform_interface/plugin_platform_interface.dart';
+
+import 'webview_platform.dart';
+
+/// Interface for callbacks made by [NavigationCallbackHandlerDelegate].
+///
+/// The webview plugin implements this class, and passes an instance to the
+/// [NavigationCallbackHandlerDelegate].
+/// [NavigationCallbackHandlerDelegate] is notifying this handler on events that
+/// happened on the platform's webview.
+abstract class NavigationCallbackHandlerDelegate extends PlatformInterface {
+  /// Creates a new [NavigationCallbacksHandlerDelegate]
+  factory NavigationCallbackHandlerDelegate() {
+    final NavigationCallbackHandlerDelegate callbackHandlerDelegate =
+        WebViewPlatform.instance!.createNavigationCallbackHandlerDelegate();
+    PlatformInterface.verify(callbackHandlerDelegate, _token);
+    return callbackHandlerDelegate;
+  }
+
+  /// Used by the platform implementation to create a new
+  /// [NavigationCallbackHandlerDelegate].
+  ///
+  /// Should only be used by platform implementations because they can't extend
+  /// a class that only contains a factory constructor.
+  @protected
+  NavigationCallbackHandlerDelegate.implementation() : super(token: _token);
+
+  static final Object _token = Object();
+
+  /// Sets the callback method that is invoked by the
+  /// [WebViewPlatformControllerDelegate] when a navigation request is pending.
+  Future<void> setOnNavigationRequest(
+    void Function({required String url, required bool isForMainFrame})
+        onNavigationRequest,
+  ) {
+    throw UnimplementedError(
+        'setOnNavigationRequest is not implemented on the current platform.');
+  }
+
+  /// Sets the callback method that is invoked by [WebViewControllerDelegate]
+  /// when a page has started loading.
+  Future<void> setOnPageStarted(
+    void Function(String url) onPageStarted,
+  ) {
+    throw UnimplementedError(
+        'setOnPageStarted is not implemented on the current platform.');
+  }
+
+  /// Sets the callback method that is invoked by [WebViewControllerDelegate]
+  /// when a page has finished loading.
+  Future<void> setOnPageFinished(
+    void Function(String url) onPageFinished,
+  ) {
+    throw UnimplementedError(
+        'setOnPageFinished is not implemented on the current platform.');
+  }
+
+  /// Sets the callback method that is invoked by [WebViewControllerDelegate]
+  /// when a page is loading.
+  ///
+  /// Only works when [WebSettings.hasProgressTracking] is set to `true`.
+  Future<void> setOnProgress(
+    void Function(int progress) onProgress,
+  ) {
+    throw UnimplementedError(
+        'setOnProgress is not implemented on the current platform.');
+  }
+
+  /// Sets the callback that is invoked when a resource loading error occurred..
+  Future<void> setOnWebResourceError(
+    void Function(WebResourceErrorDelegate error) onWebResourceError,
+  ) {
+    throw UnimplementedError(
+        'setOnWebResourceError is not implemented on the current platform.');
+  }
+}

packages/webview_flutter/webview_flutter_platform_interface/lib/src/v4/types/javascript_message.dart

@@ -0,0 +1,17 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'package:meta/meta.dart';
+
+/// A message that was sent by JavaScript code running in a [WebView].
+@sealed
+class JavaScriptMessage {
+  /// Constructs a JavaScript message object.
+  ///
+  /// The `message` parameter must not be null.
+  const JavaScriptMessage(this.message) : assert(message != null);
+
+  /// The contents of the message that was sent by the JavaScript code.
+  final String message;
+}

packages/webview_flutter/webview_flutter_platform_interface/lib/src/v4/types/javascript_mode.dart

@@ -0,0 +1,12 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+/// Describes the state of JavaScript support in a given web view.
+enum JavaScriptMode {
+  /// JavaScript execution is disabled.
+  disabled,
+
+  /// JavaScript execution is not restricted.
+  unrestricted,
+}

packages/webview_flutter/webview_flutter_platform_interface/lib/src/v4/types/load_request_params_delegate.dart

@@ -0,0 +1,129 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:typed_data';
+
+import 'package:flutter/foundation.dart';
+import 'package:plugin_platform_interface/plugin_platform_interface.dart';
+import 'package:webview_flutter_platform_interface/src/v4/webview_controller_delegate.dart';
+
+import '../webview_platform.dart';
+
+/// Defines the supported HTTP methods for loading a page in
+/// [WebViewControllerDelegate].
+enum LoadRequestMethod {
+  /// HTTP GET method.
+  get,
+
+  /// HTTP POST method.
+  post,
+}
+
+/// Extension methods on the [LoadRequestMethod] enum.
+extension LoadRequestMethodExtensions on LoadRequestMethod {
+  /// Converts [LoadRequestMethod] to [String] format.
+  String serialize() {
+    switch (this) {
+      case LoadRequestMethod.get:
+        return 'get';
+      case LoadRequestMethod.post:
+        return 'post';
+    }
+  }
+}
+
+/// Defines the parameters that can be used to load a page with the
+/// [WebViewControllerDelegate].
+///
+/// Platform specific implementations can add additional fields by extending this
+/// class and provide a factory method that takes the
+/// [LoadRequestParamsDelegate] as a parameter.
+///
+/// {@tool sample}
+/// This example demonstrates how to extend the [LoadRequestParamsDelegate] to
+/// provide additional platform specific parameters.
+///
+/// Note that the additional parameters should always accept `null` or have a
+/// default value to prevent breaking changes.
+///
+/// ```dart
+/// class AndroidLoadRequestParamsDelegate extends LoadRequestParamsDelegate {
+///   AndroidLoadRequestParamsDelegate._(
+///     LoadRequestParamsDelegate loadRequestParams,
+///     this.historyUrl,
+///   ) : super(
+///     uri: loadRequestParams.uri,
+///     method: loadRequestParams.method,
+///     headers: loadRequestParams.headers,
+///     body: loadRequestParams.body,
+///   );
+///
+///   factory AndroidLoadRequestParamsDelegate.fromLoadRequestParamsDelegate(
+///     LoadRequestParamsDelegate loadRequestParams, {
+///     Uri? historyUrl,
+///   }) {
+///     return AndroidLoadRequestParamsDelegate._(
+///       loadRequestParams: loadRequestParams,
+///       historyUrl: historyUrl,
+///     );
+///   }
+///
+///   final Uri? historyUrl;
+/// }
+/// ```
+/// {@end-tool}
+class LoadRequestParamsDelegate extends PlatformInterface {
+  /// Creates a new [LoadRequestParamsDelegate].
+  factory LoadRequestParamsDelegate({
+    required Uri uri,
+    required LoadRequestMethod method,
+    Map<String, String> headers = const <String, String>{},
+    Uint8List? body,
+  }) {
+    final LoadRequestParamsDelegate loadRequestParamsDelegate =
+        WebViewPlatform.instance!.createLoadRequestParamsDelegate(
+      uri: uri,
+      method: method,
+      headers: headers,
+      body: body,
+    );
+    PlatformInterface.verify(loadRequestParamsDelegate, _token);
+    return loadRequestParamsDelegate;
+  }
+
+  /// Used by the platform implementation to create a new
+  /// [LoadRequestParamsDelegate].
+  ///
+  /// Should only be used by platform implementations because they can't extend
+  /// a class that only contains a factory constructor.
+  @protected
+  LoadRequestParamsDelegate.implementation({
+    required this.uri,
+    required this.method,
+    required this.headers,
+    this.body,
+  }) : super(token: _token);
+
+  static final Object _token = Object();
+
+  /// URI for the request.
+  final Uri uri;
+
+  /// HTTP method used to make the request.
+  final LoadRequestMethod method;
+
+  /// Headers for the request.
+  final Map<String, String> headers;
+
+  /// HTTP body for the request.
+  final Uint8List? body;
+
+  /// Serializes the [WebViewRequest] to JSON.
+  Map<String, dynamic> toJson() => <String, dynamic>{
+        'uri': uri.toString(),
+        'method': method.serialize(),
+        'headers': headers,
+        'body': body,
+      };
+}

packages/webview_flutter/webview_flutter_platform_interface/lib/src/v4/types/types.dart

@@ -0,0 +1,10 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+export 'javascript_message.dart';
+export 'javascript_mode.dart';
+export 'load_request_params_delegate.dart';
+export 'web_resource_error_delegate.dart';
+export 'web_settings_delegate.dart';
+export 'webview_cookie.dart';