@capacitor-plus/ios 8.0.0-beta.0

package/Capacitor/Capacitor/CAPInstanceConfiguration.swift

@@ -0,0 +1,78 @@
+import Foundation
+
+extension InstanceConfiguration {
+    @objc public var appStartFileURL: URL {
+        if let path = appStartPath {
+            return appLocation.appendingPathComponent(path)
+        }
+        return appLocation
+    }
+
+    @objc public var appStartServerURL: URL {
+        if let path = appStartPath {
+            return serverURL.appendingPathComponent(path)
+        }
+        return serverURL
+    }
+
+    @objc public var errorPathURL: URL? {
+        guard let errorPath = errorPath else {
+            return nil
+        }
+
+        return localURL.appendingPathComponent(errorPath)
+    }
+
+    @available(*, deprecated, message: "Use getPluginConfig")
+    @objc public func getPluginConfigValue(_ pluginId: String, _ configKey: String) -> Any? {
+        return (pluginConfigurations as? JSObject)?[keyPath: KeyPath("\(pluginId).\(configKey)")]
+    }
+
+    @objc public func getPluginConfig(_ pluginId: String) -> PluginConfig {
+        if let cfg = (pluginConfigurations as? JSObject)?[keyPath: KeyPath("\(pluginId)")] as? JSObject {
+            return PluginConfig(config: cfg)
+        }
+        return PluginConfig(config: JSObject())
+    }
+
+    @objc public func shouldAllowNavigation(to host: String) -> Bool {
+        for hostname in allowedNavigationHostnames {
+            if doesHost(host, match: hostname) {
+                return true
+            }
+        }
+        return false
+    }
+
+    @available(*, deprecated, message: "Use direct property accessors")
+    @objc public func getValue(_ key: String) -> Any? {
+        return (legacyConfig as? JSObject)?[keyPath: KeyPath(key)]
+    }
+
+    @available(*, deprecated, message: "Use direct property accessors")
+    @objc public func getString(_ key: String) -> String? {
+        return (legacyConfig as? JSObject)?[keyPath: KeyPath(key)] as? String
+    }
+
+    // MARK: - Private
+
+    private func doesHost(_ host: String, match pattern: String) -> Bool {
+        // bail early in the simple case
+        if pattern == "*" {
+            return true
+        }
+        // break apart the pieces
+        var hostComponents = host.lowercased().split(separator: ".")
+        var patternComponents = pattern.lowercased().split(separator: ".")
+        guard hostComponents.count == patternComponents.count else {
+            return false
+        }
+        // remove any wildcard segments
+        for wildcard in patternComponents.enumerated().reversed().filter({ $0.element == "*" }) {
+            hostComponents.remove(at: wildcard.offset)
+            patternComponents.remove(at: wildcard.offset)
+        }
+        // match with what's left
+        return hostComponents == patternComponents
+    }
+}

package/Capacitor/Capacitor/CAPInstanceDescriptor.h

@@ -0,0 +1,167 @@
+#ifndef CAPInstanceDescriptor_h
+#define CAPInstanceDescriptor_h
+
+@import UIKit;
+@import Cordova;
+
+typedef NS_ENUM(NSInteger, CAPInstanceType) {
+    CAPInstanceTypeFixed NS_SWIFT_NAME(fixed),
+    CAPInstanceTypeVariable NS_SWIFT_NAME(variable)
+} NS_SWIFT_NAME(InstanceType);
+
+typedef NS_OPTIONS(NSUInteger, CAPInstanceWarning) {
+    CAPInstanceWarningMissingAppDir       NS_SWIFT_NAME(missingAppDir)      = 1 << 0,
+    CAPInstanceWarningMissingFile         NS_SWIFT_NAME(missingFile)        = 1 << 1,
+    CAPInstanceWarningInvalidFile         NS_SWIFT_NAME(invalidFile)        = 1 << 2,
+    CAPInstanceWarningMissingCordovaFile  NS_SWIFT_NAME(missingCordovaFile) = 1 << 3,
+    CAPInstanceWarningInvalidCordovaFile  NS_SWIFT_NAME(invalidCordovaFile) = 1 << 4
+} NS_SWIFT_NAME(InstanceWarning);
+
+typedef NS_OPTIONS(NSUInteger, CAPInstanceLoggingBehavior) {
+    CAPInstanceLoggingBehaviorNone          NS_SWIFT_NAME(none)         = 1 << 0,
+    CAPInstanceLoggingBehaviorDebug         NS_SWIFT_NAME(debug)        = 1 << 1,
+    CAPInstanceLoggingBehaviorProduction    NS_SWIFT_NAME(production)   = 1 << 2,
+} NS_SWIFT_NAME(InstanceLoggingBehavior);
+
+extern NSString * _Nonnull const CAPInstanceDescriptorDefaultScheme NS_SWIFT_UNAVAILABLE("Use InstanceDescriptorDefaults");
+extern NSString * _Nonnull const CAPInstanceDescriptorDefaultHostname NS_SWIFT_UNAVAILABLE("Use InstanceDescriptorDefaults");
+
+NS_SWIFT_NAME(InstanceDescriptor)
+@interface CAPInstanceDescriptor : NSObject
+/**
+ @brief A value to append to the @c User-Agent string. Ignored if @c overridenUserAgentString is set.
+ @discussion Set by @c appendUserAgent in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *appendedUserAgentString;
+/**
+ @brief A value that will completely replace the @c User-Agent string. Overrides @c appendedUserAgentString.
+ @discussion Set by @c overrideUserAgent in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *overridenUserAgentString;
+/**
+ @brief The background color to set on the web view where content is not visible.
+ @discussion Set by @c backgroundColor in the configuration file.
+ */
+@property (nonatomic, retain, nullable) UIColor *backgroundColor;
+/**
+ @brief Hostnames to which the web view is allowed to navigate without opening an external browser.
+ @discussion Set by @c allowNavigation in the configuration file.
+ */
+@property (nonatomic, copy, nonnull) NSArray<NSString*> *allowedNavigationHostnames;
+/**
+ @brief The scheme that will be used for the server URL.
+ @discussion Defaults to @c capacitor. Set by @c server.iosScheme in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *urlScheme;
+/**
+ @brief The path to a local html page to display in case of errors.
+ @discussion Defaults to nil.
+ */
+@property (nonatomic, copy, nullable) NSString *errorPath;
+/**
+ @brief The hostname that will be used for the server URL.
+ @discussion Defaults to @c localhost. Set by @c server.hostname in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *urlHostname;
+/**
+ @brief The fully formed URL that will be used as the server URL.
+ @discussion Defaults to nil, in which case the server URL will be constructed from @c urlScheme and @c urlHostname. If set, it will override the other properties. Set by @c server.url in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *serverURL;
+/**
+ @brief The JSON dictionary that contains the plugin-specific configuration information.
+ @discussion Set by @c plugins in the configuration file.
+ */
+@property (nonatomic, retain, nonnull) NSDictionary *pluginConfigurations;
+/**
+ @brief The build configurations under which logging should be enabled.
+ @discussion Defaults to @c debug. Set by @c loggingBehavior in the configuration file.
+ */
+@property (nonatomic, assign) CAPInstanceLoggingBehavior loggingBehavior;
+/**
+ @brief Whether or not the web view can scroll.
+ @discussion Set by @c ios.scrollEnabled in the configuration file. Corresponds to @c isScrollEnabled on WKWebView.
+ */
+@property (nonatomic, assign) BOOL scrollingEnabled;
+/**
+ @brief Whether or not the web view can zoom.
+ @discussion Set by @c zoomEnabled in the configuration file.
+ */
+@property (nonatomic, assign) BOOL zoomingEnabled;
+/**
+ @brief Whether or not the web view will preview links.
+ @discussion Set by @c ios.allowsLinkPreview in the configuration file. Corresponds to @c allowsLinkPreview on WKWebView.
+ */
+@property (nonatomic, assign) BOOL allowLinkPreviews;
+/**
+ @brief Whether or not the Capacitor runtime will set itself as the @c UNUserNotificationCenter delegate.
+ @discussion Defaults to @c true. Required to be @c true for notification plugins to work correctly. Set to @c false if your application will handle notifications independently.
+ */
+@property (nonatomic, assign) BOOL handleApplicationNotifications;
+/**
+ @brief Enables web debugging by setting isInspectable of  @c WKWebView to @c true on iOS 16.4 and greater
+ @discussion Defaults to true in debug mode and false in production
+ */
+@property (nonatomic, assign) BOOL isWebDebuggable;
+/**
+ @brief Whether or not the webview will have focus.
+ @discussion Defaults to @c true.  Set by @c ios.initialFocus in the configuration file.
+ */
+@property (nonatomic, assign) BOOL hasInitialFocus;
+
+/**
+ @brief How the web view will inset its content
+ @discussion Set by @c ios.contentInset in the configuration file. Corresponds to @c contentInsetAdjustmentBehavior on WKWebView.
+ */
+@property (nonatomic, assign) UIScrollViewContentInsetAdjustmentBehavior contentInsetAdjustmentBehavior;
+/**
+ @brief The base file URL from which Capacitor will load resources
+ @discussion Defaults to @c public/ located at the root of the application bundle.
+ */
+@property (nonatomic, copy, nonnull) NSURL *appLocation;
+/**
+ @brief The path (relative to @c appLocation) which Capacitor will use for the inital URL at launch.
+ @discussion Defaults to nil, in which case Capacitor will attempt to load @c index.html.
+ */
+@property (nonatomic, copy, nullable) NSString *appStartPath;
+/**
+ @brief Whether or not the Capacitor WebView will limit the navigation to @c WKAppBoundDomains listed in the Info.plist.
+ @discussion Defaults to @c false. Set by @c ios.limitsNavigationsToAppBoundDomains in the configuration file.  Required to be @c true for plugins to work if the app includes @c WKAppBoundDomains in the Info.plist.
+ */
+@property (nonatomic, assign) BOOL limitsNavigationsToAppBoundDomains;
+/**
+ @brief The content mode for the web view to use when it loads and renders web content.
+ @discussion Defaults to  @c recommended. Set by @c ios.preferredContentMode in the configuration file.
+ */
+@property (nonatomic, copy, nullable) NSString *preferredContentMode;
+/**
+ @brief The parser used to load the cofiguration for Cordova plugins.
+ */
+@property (nonatomic, copy, nonnull) CDVConfigParser *cordovaConfiguration;
+/**
+ @brief Warnings generated during initialization.
+ */
+@property (nonatomic, assign) CAPInstanceWarning warnings;
+/**
+ @brief The type of instance.
+ */
+@property (nonatomic, readonly) CAPInstanceType instanceType;
+/**
+ @brief The JSON dictionary representing the contents of the configuration file.
+ @warning Deprecated. Do not use.
+ */
+@property (nonatomic, retain, nonnull) NSDictionary *legacyConfig;
+/**
+ @brief Initialize the descriptor with the default environment. This assumes that the application was built with the help of the Capacitor CLI and that that the web app is located inside the application bundle at @c public/.
+ */
+- (instancetype _Nonnull)initAsDefault NS_SWIFT_NAME(init());
+/**
+ @brief Initialize the descriptor for use in other contexts. The app location is the one required parameter.
+ @param appURL The location of the folder containing the web app.
+ @param configURL The location of the Capacitor configuration file.
+ @param cordovaURL The location of the Cordova configuration file.
+ */
+- (instancetype _Nonnull)initAtLocation:(NSURL* _Nonnull)appURL configuration:(NSURL* _Nullable)configURL cordovaConfiguration:(NSURL* _Nullable)cordovaURL NS_SWIFT_NAME(init(at:configuration:cordovaConfiguration:));
+@end
+
+#endif /* CAPInstanceDescriptor_h */

package/Capacitor/Capacitor/CAPInstanceDescriptor.m

@@ -0,0 +1,56 @@
+#import "CAPInstanceDescriptor.h"
+#import <Capacitor/Capacitor-Swift.h>
+
+// Swift extensions marked as @objc and internal are available to the Obj-C runtime but are not available at compile time.
+// so we need this declaration to avoid compiler complaints
+@interface CAPInstanceDescriptor (InternalSwiftExtension)
+- (void)_parseConfigurationAt:(NSURL *)configURL cordovaConfiguration:(NSURL *)cordovaURL;
+@end
+
+NSString* const CAPInstanceDescriptorDefaultScheme = @"capacitor";
+NSString* const CAPInstanceDescriptorDefaultHostname = @"localhost";
+
+@implementation CAPInstanceDescriptor
+- (instancetype)initAsDefault {
+    if (self = [super init]) {
+        _instanceType = CAPInstanceTypeFixed;
+        [self _setDefaultsWithAppLocation:[[NSBundle mainBundle] URLForResource:@"public" withExtension:nil]];
+        [self _parseConfigurationAt:[[NSBundle mainBundle] URLForResource:@"capacitor.config" withExtension:@"json"] cordovaConfiguration:[[NSBundle mainBundle] URLForResource:@"config" withExtension:@"xml"]];
+    }
+    return self;
+}
+
+- (instancetype)initAtLocation:(NSURL*)appURL configuration:(NSURL*)configURL cordovaConfiguration:(NSURL*)cordovaURL {
+    if (self = [super init]) {
+        _instanceType = CAPInstanceTypeVariable;
+        [self _setDefaultsWithAppLocation:appURL];
+        [self _parseConfigurationAt:configURL cordovaConfiguration:cordovaURL];
+    }
+    return self;
+}
+
+- (void)_setDefaultsWithAppLocation:(NSURL*)location {
+    _allowedNavigationHostnames = @[];
+    _urlScheme = CAPInstanceDescriptorDefaultScheme;
+    _urlHostname = CAPInstanceDescriptorDefaultHostname;
+    _pluginConfigurations = @{};
+    _legacyConfig = @{};
+    _loggingBehavior = CAPInstanceLoggingBehaviorDebug;
+    _scrollingEnabled = YES;
+    _zoomingEnabled = NO;
+    _allowLinkPreviews = YES;
+    _handleApplicationNotifications = YES;
+    _isWebDebuggable = NO;
+    _hasInitialFocus = YES;
+    _contentInsetAdjustmentBehavior = UIScrollViewContentInsetAdjustmentNever;
+    _appLocation = location;
+    _limitsNavigationsToAppBoundDomains = FALSE;
+    _cordovaConfiguration = [[CDVConfigParser alloc] init];
+    _warnings = 0;
+    if (location == nil) {
+        _warnings |= CAPInstanceWarningMissingAppDir;
+        // location is nil so assume it was supposed to be the default
+        _appLocation = [[[NSBundle mainBundle] resourceURL] URLByAppendingPathComponent:@"public"];
+    }
+}
+@end

package/Capacitor/Capacitor/CAPInstanceDescriptor.swift

@@ -0,0 +1,198 @@
+import Foundation
+
+public enum InstanceDescriptorDefaults {
+    public static let scheme = "capacitor"
+    public static let hostname = "localhost"
+}
+
+private extension InstanceLoggingBehavior {
+    static func behavior(from: String) -> InstanceLoggingBehavior? {
+        switch from.lowercased() {
+        case "none":
+            return InstanceLoggingBehavior.none
+        case "debug":
+            return InstanceLoggingBehavior.debug
+        case "production":
+            return InstanceLoggingBehavior.production
+        default:
+            return nil
+        }
+    }
+}
+
+/**
+ The purpose of this function is to hide the messy details of parsing the configuration(s) so
+ the complexity is worth it. And the name starts with an underscore to match the convention of
+ private APIs in Obj-C (from which it is called).
+ */
+internal extension InstanceDescriptor {
+    // swiftlint:disable cyclomatic_complexity
+    // swiftlint:disable function_body_length
+    // swiftlint:disable:next identifier_name
+    @objc func _parseConfiguration(at capacitorURL: URL?, cordovaConfiguration cordovaURL: URL?) {
+        // sanity check that the app directory is valid
+        var isDirectory: ObjCBool = ObjCBool(false)
+        if warnings.contains(.missingAppDir) == false,
+           FileManager.default.fileExists(atPath: appLocation.path, isDirectory: &isDirectory) == false || isDirectory.boolValue == false {
+            warnings.update(with: .missingAppDir)
+        }
+
+        // parse the capacitor configuration
+        var config: JSObject?
+        if let capacitorURL = capacitorURL,
+           FileManager.default.fileExists(atPath: capacitorURL.path, isDirectory: &isDirectory),
+           isDirectory.boolValue == false {
+            do {
+                let contents = try Data(contentsOf: capacitorURL)
+                config = JSTypes.coerceDictionaryToJSObject(try JSONSerialization.jsonObject(with: contents) as? [String: Any])
+            } catch {
+                warnings.update(with: .invalidFile)
+            }
+        } else {
+            warnings.update(with: .missingFile)
+        }
+
+        // parse the cordova configuration
+        var configParser: XMLParser?
+        if let cordovaURL = cordovaURL,
+           FileManager.default.fileExists(atPath: cordovaURL.path, isDirectory: &isDirectory),
+           isDirectory.boolValue == false {
+            configParser = XMLParser(contentsOf: cordovaURL)
+        } else {
+            warnings.update(with: .missingCordovaFile)
+            // we don't want to break up string literals
+            // swiftlint:disable:next line_length
+            if let cordovaXML = "<?xml version='1.0' encoding='utf-8'?><widget version=\"1.0.0\" xmlns=\"http://www.w3.org/ns/widgets\" xmlns:cdv=\"http://cordova.apache.org/ns/1.0\"><access origin=\"*\" /></widget>".data(using: .utf8) {
+                configParser = XMLParser(data: cordovaXML)
+            }
+        }
+        configParser?.delegate = cordovaConfiguration
+        configParser?.parse()
+
+        // extract our configuration values
+        if let config = config {
+            // to be removed
+            legacyConfig = config
+
+            if let agentString = (config[keyPath: "ios.appendUserAgent"] as? String) ?? (config[keyPath: "appendUserAgent"] as? String) {
+                appendedUserAgentString = agentString
+            }
+            if let agentString = (config[keyPath: "ios.overrideUserAgent"] as? String) ?? (config[keyPath: "overrideUserAgent"] as? String) {
+                overridenUserAgentString = agentString
+            }
+            if let colorString = (config[keyPath: "ios.backgroundColor"] as? String) ?? (config[keyPath: "backgroundColor"] as? String),
+               let color = UIColor.capacitor.color(fromHex: colorString) {
+                backgroundColor = color
+            }
+            if let allowNav = config[keyPath: "server.allowNavigation"] as? [String] {
+                allowedNavigationHostnames = allowNav
+            }
+            if let scheme = (config[keyPath: "server.iosScheme"] as? String)?.lowercased() {
+                urlScheme = scheme
+            }
+            if let host = config[keyPath: "server.hostname"] as? String {
+                urlHostname = host
+            }
+            if let urlString = config[keyPath: "server.url"] as? String {
+                serverURL = urlString
+            }
+            if let errorPathString = (config[keyPath: "server.errorPath"] as? String) {
+                errorPath = errorPathString
+            }
+            if let insetBehavior = config[keyPath: "ios.contentInset"] as? String {
+                let availableInsets: [String: UIScrollView.ContentInsetAdjustmentBehavior] = ["automatic": .automatic,
+                                                                                              "scrollableAxes": .scrollableAxes,
+                                                                                              "never": .never,
+                                                                                              "always": .always]
+                if let option = availableInsets[insetBehavior] {
+                    contentInsetAdjustmentBehavior = option
+                }
+            }
+            if let allowPreviews = config[keyPath: "ios.allowsLinkPreview"] as? Bool {
+                allowLinkPreviews = allowPreviews
+            }
+            if let scrollEnabled = config[keyPath: "ios.scrollEnabled"] as? Bool {
+                scrollingEnabled = scrollEnabled
+            }
+            if let zoomEnabled = (config[keyPath: "ios.zoomEnabled"] as? Bool) ?? (config[keyPath: "zoomEnabled"] as? Bool) {
+                zoomingEnabled = zoomEnabled
+            }
+            if let pluginConfig = config[keyPath: "plugins"] as? JSObject {
+                pluginConfigurations = pluginConfig
+            }
+            if let value = (config[keyPath: "ios.loggingBehavior"] as? String) ?? (config[keyPath: "loggingBehavior"] as? String) {
+                if let behavior = InstanceLoggingBehavior.behavior(from: value) {
+                    loggingBehavior = behavior
+                }
+            }
+            if let limitsNavigations = config[keyPath: "ios.limitsNavigationsToAppBoundDomains"] as? Bool {
+                limitsNavigationsToAppBoundDomains = limitsNavigations
+            }
+            if let preferredMode = (config[keyPath: "ios.preferredContentMode"] as? String) {
+                preferredContentMode = preferredMode
+            }
+            if let handleNotifications = config[keyPath: "ios.handleApplicationNotifications"] as? Bool {
+                handleApplicationNotifications = handleNotifications
+            }
+            if let webContentsDebuggingEnabled = config[keyPath: "ios.webContentsDebuggingEnabled"] as? Bool {
+                isWebDebuggable = webContentsDebuggingEnabled
+            } else {
+                #if DEBUG
+                isWebDebuggable = true
+                #else
+                // this is needed for SPM xcframework Capacitor.  Can eventually be removed when the SPM package moves to being source-based.
+                if let debugValue = Bundle.main.object(forInfoDictionaryKey: "CAPACITOR_DEBUG") as? String, debugValue == "true" {
+                    isWebDebuggable = true
+                }
+                #endif
+            }
+            if let initialFocus = (config[keyPath: "ios.initialFocus"] as? Bool) ?? (config[keyPath: "initialFocus"] as? Bool) {
+                hasInitialFocus = initialFocus
+            }
+            if let startPath = (config[keyPath: "server.appStartPath"] as? String) {
+                appStartPath = startPath
+            }
+        }
+    }
+    // swiftlint:enable cyclomatic_complexity
+    // swiftlint:enable function_body_length
+}
+
+extension InstanceDescriptor {
+    @objc public var cordovaDeployDisabled: Bool {
+        return (cordovaConfiguration.settings?["DisableDeploy".lowercased()] as? NSString)?.boolValue ?? false
+    }
+
+    @objc public func normalize() {
+        // first, make sure the scheme is valid
+        var schemeValid = false
+        if let scheme = urlScheme, WKWebView.handlesURLScheme(scheme) == false,
+           scheme.range(of: "^[a-z][a-z0-9.+-]*$", options: [.regularExpression, .caseInsensitive], range: nil, locale: nil) != nil {
+            schemeValid = true
+        }
+        if !schemeValid {
+            // reset to the default
+            urlScheme = InstanceDescriptorDefaults.scheme
+        }
+        // make sure we have a hostname
+        if urlHostname == nil {
+            urlHostname = InstanceDescriptorDefaults.hostname
+        }
+        // now validate the server.url
+        var urlValid = false
+        if let server = serverURL, URL(string: server) != nil {
+            urlValid = true
+        }
+        if !urlValid {
+            serverURL = nil
+        }
+        // reset the path if it's not valid
+        if let path = appStartPath?.trimmingCharacters(in: .whitespacesAndNewlines), path.isEmpty {
+            appStartPath = nil
+        }
+        // if the plugin configuration was programmatically modified, the necessary type information may have been lost.
+        // so perform a coercion here to make sure that casting will work as expected
+        pluginConfigurations = JSTypes.coerceDictionaryToJSObject(pluginConfigurations) ?? [:]
+        legacyConfig = JSTypes.coerceDictionaryToJSObject(legacyConfig) ?? [:]
+    }
+}

package/Capacitor/Capacitor/CAPInstancePlugin.swift

@@ -0,0 +1,10 @@
+//
+//  CAPInstancePlugin.swift
+//  Capacitor
+//
+//  Created by Steven Sherry on 11/21/22.
+//  Copyright © 2022 Drifty Co. All rights reserved.
+//
+
+/// A CAPPlugin subclass meant to be explicitly initialized by the caller and not the bridge.
+@objc open class CAPInstancePlugin: CAPPlugin {}

package/Capacitor/Capacitor/CAPLog.swift

@@ -0,0 +1,11 @@
+public class CAPLog {
+    public static var enableLogging: Bool = true
+
+    public static func print(_ items: Any..., separator: String = " ", terminator: String = "\n") {
+        if enableLogging {
+            for (itemIndex, item) in items.enumerated() {
+                Swift.print("\(item)".prefix(4068), terminator: itemIndex == items.count - 1 ? terminator : separator)
+            }
+        }
+    }
+}

package/Capacitor/Capacitor/CAPNotifications.swift

@@ -0,0 +1,69 @@
+/**
+ Notificaton types for NotificationCenter and NSNotificationCenter
+
+ We want to include `capacitor` in the name(s) to uniquely identify these even though it can make the names long
+ and the deprecated notifications are only here for backwards compatibility.
+ */
+// swiftlint:disable identifier_name
+extension Notification.Name {
+    public static let capacitorOpenURL = Notification.Name(rawValue: "CapacitorOpenURLNotification")
+    public static let capacitorOpenUniversalLink = Notification.Name(rawValue: "CapacitorOpenUniversalLinkNotification")
+    public static let capacitorContinueActivity = Notification.Name(rawValue: "CapacitorContinueActivityNotification")
+    public static let capacitorDidRegisterForRemoteNotifications =
+        Notification.Name(rawValue: "CapacitorDidRegisterForRemoteNotificationsNotification")
+    public static let capacitorDidFailToRegisterForRemoteNotifications =
+        Notification.Name(rawValue: "CapacitorDidFailToRegisterForRemoteNotificationsNotification")
+    public static let capacitorDecidePolicyForNavigationAction =
+        Notification.Name(rawValue: "CapacitorDecidePolicyForNavigationActionNotification")
+    public static let capacitorStatusBarTapped = Notification.Name(rawValue: "CapacitorStatusBarTappedNotification")
+    public static let capacitorViewDidAppear = Notification.Name(rawValue: "CapacitorViewDidAppear")
+    public static let capacitorViewWillTransition = Notification.Name(rawValue: "CapacitorViewWillTransition")
+}
+
+@objc extension NSNotification {
+    public static let capacitorOpenURL = Notification.Name.capacitorOpenURL
+    public static let capacitorOpenUniversalLink = Notification.Name.capacitorOpenUniversalLink
+    public static let capacitorContinueActivity = Notification.Name.capacitorContinueActivity
+    public static let capacitorDidRegisterForRemoteNotifications = Notification.Name.capacitorDidRegisterForRemoteNotifications
+    public static let capacitorDidFailToRegisterForRemoteNotifications = Notification.Name.capacitorDidFailToRegisterForRemoteNotifications
+    public static let capacitorDecidePolicyForNavigationAction = Notification.Name.capacitorDecidePolicyForNavigationAction
+    public static let capacitorStatusBarTapped = Notification.Name.capacitorStatusBarTapped
+    public static let capacitorViewDidAppear = Notification.Name.capacitorViewDidAppear
+    public static let capacitorViewWillTransition = Notification.Name.capacitorViewWillTransition
+}
+
+/**
+ Deprecated, will be removed
+ */
+@objc public enum CAPNotifications: Int {
+    @available(*, deprecated, message: "renamed to 'Notification.Name.capacitorOpenURL'")
+    case URLOpen
+    @available(*, deprecated, message: "renamed to 'Notification.Name.capacitorOpenUniversalLink'")
+    case UniversalLinkOpen
+    @available(*, deprecated, message: "Notification.Name.capacitorContinueActivity'")
+    case ContinueActivity
+    @available(*, deprecated, message: "renamed to 'Notification.Name.capacitorDidRegisterForRemoteNotifications'")
+    case DidRegisterForRemoteNotificationsWithDeviceToken
+    @available(*, deprecated, message: "renamed to 'Notification.Name.capacitorDidFailToRegisterForRemoteNotifications'")
+    case DidFailToRegisterForRemoteNotificationsWithError
+    @available(*, deprecated, message: "renamed to 'Notification.Name.capacitorDecidePolicyForNavigationAction'")
+    case DecidePolicyForNavigationAction
+
+    public func name() -> String {
+        switch self {
+        case .URLOpen:
+            return Notification.Name.capacitorOpenURL.rawValue
+        case .UniversalLinkOpen:
+            return Notification.Name.capacitorOpenUniversalLink.rawValue
+        case .ContinueActivity:
+            return Notification.Name.capacitorContinueActivity.rawValue
+        case .DidRegisterForRemoteNotificationsWithDeviceToken:
+            return Notification.Name.capacitorDidRegisterForRemoteNotifications.rawValue
+        case .DidFailToRegisterForRemoteNotificationsWithError:
+            return Notification.Name.capacitorDidFailToRegisterForRemoteNotifications.rawValue
+        case .DecidePolicyForNavigationAction:
+            return Notification.Name.capacitorDecidePolicyForNavigationAction.rawValue
+        }
+    }
+}
+// swiftlint:enable identifier_name

package/Capacitor/Capacitor/CAPPlugin+LoadInstance.swift

@@ -0,0 +1,20 @@
+//
+//  CAPPlugin+LoadInstance.swift
+//  Capacitor
+//
+//  Created by Steven Sherry on 11/9/22.
+//  Copyright © 2022 Drifty Co. All rights reserved.
+//
+
+extension CAPBridgedPlugin where Self: CAPPlugin {
+    func load(on bridge: CAPBridgeProtocol) {
+        self.bridge = bridge
+        webView = bridge.webView
+        shouldStringifyDatesInCalls = true
+        retainedEventArguments = [:]
+        eventListeners = [:]
+        pluginId = identifier
+        pluginName = jsName
+        load()
+    }
+}