Added initializer to VAPID.Key for decoding Base64 strings directly.

Author: dimitribouniol

README.md

@@ -29,7 +29,7 @@ Please check the [releases](https://github.com/mochidev/swift-webpush/releases)
 dependencies: [
     .package(
         url: "https://github.com/mochidev/swift-webPush.git", 
-        .upToNextMinor(from: "0.1.3")
+        .upToNextMinor(from: "0.1.4")
     ),
 ],
 ...
@@ -105,7 +105,13 @@ Before integrating WebPush into your server, you must generate one time VAPID ke
 
 To uninstall the generator:
 ```zsh
-% package experimental-uninstall vapid-key-generator
+% swift package experimental-uninstall vapid-key-generator
+```
+
+To update the generator, uninstall it and re-install it after pulling from main:
+```zsh
+% swift package experimental-uninstall vapid-key-generator
+% swift package experimental-install
 ```
 
 Once installed, a new configuration can be generated as needed:

Sources/WebPush/VAPID/VAPIDKey.swift

@@ -16,13 +16,26 @@ extension VoluntaryApplicationServerIdentification {
     public struct Key: Sendable {
         private var privateKey: P256.Signing.PrivateKey
 
+        /// Create a brand new VAPID signing key.
+        ///
+        /// - Note: You must persist this key somehow if you are creating it yourself.
         public init() {
             privateKey = P256.Signing.PrivateKey(compactRepresentable: false)
         }
 
+        /// Initialize a key from a P256 SIgning Private Key.
+        ///
+        /// - Warning: Do not re-use this key for any other purpose other than VAPID authorization!
         public init(privateKey: P256.Signing.PrivateKey) {
             self.privateKey = privateKey
         }
+        
+        /// Decode a key directly from a Base 64 (URL) encoded string, or throw an error if decoding failed.
+        public init(base64URLEncoded: String) throws {
+            guard let data = Data(base64URLEncoded: base64URLEncoded)
+            else { throw Base64URLDecodingError() }
+            privateKey = try P256.Signing.PrivateKey(rawRepresentation: data)
+        }
     }
 }
 

vapid-key-generator/Sources/VAPIDKeyGenerator.swift

@@ -53,11 +53,11 @@ struct MyCoolerTool: ParsableCommand {
             if silent {
                 print("\(json)")
             } else {
-                print("VAPID.Key (with quotes): \(json)\n\n")
+                print("VAPID.Key: \(json)\n\n")
                 print("Example Usage:")
                 print("    // TODO: Load this data from .env or from file system")
-                print("    let keyData = Data(#\" \(json) \"#.utf8)")
-                print("    let vapidKey = try JSONDecoder().decode(VAPID.Key.self, from: keyData)")
+                print("    let keyData = Data(\(json).utf8)")
+                print("    let vapidKey = try VAPID.Key(base64URLEncoded: keyData)")
             }
         } else if !keyOnly {
             let contactInformation = if let supportURL, email == nil {