kylebrowning · Oct 16, 2026 · Oct 16, 2026 · Oct 16, 2026
diff --git a/Package.swift b/Package.swift
@@ -10,7 +10,6 @@ let package = Package(
         .tvOS(.v16),
     ],
     products: [
-        .executable(name: "APNSExample", targets: ["APNSExample"]),
         .library(name: "APNS", targets: ["APNS"]),
         .library(name: "APNSCore", targets: ["APNSCore"]),
         .library(name: "APNSURLSession", targets: ["APNSURLSession"]),

diff --git a/README.md b/README.md
@@ -39,7 +39,6 @@ let client = APNSClient(
         ),
         environment: .development
     ),
-    eventLoopGroupProvider: .createNew,
     responseDecoder: JSONDecoder(),
     requestEncoder: JSONEncoder()
 )

diff --git a/Sources/APNS/APNS.docc/APNSwift.md b/Sources/APNS/APNS.docc/APNSwift.md
@@ -25,7 +25,6 @@ let client = APNSClient(
         ),
         environment: .development
     ),
-    eventLoopGroupProvider: .createNew,
     responseDecoder: JSONDecoder(),
     requestEncoder: JSONEncoder()
 )

diff --git a/Sources/APNS/APNSBroadcastClient.swift b/Sources/APNS/APNSBroadcastClient.swift
@@ -23,6 +23,7 @@ import struct Foundation.UUID
 #endif
 import NIOCore
 import NIOHTTP1
+import NIOPosix
 import NIOSSL
 
 /// A client for managing Apple Push Notification broadcast channels.
@@ -77,7 +78,7 @@ public final class APNSBroadcastClient<Decoder: APNSJSONDecoder & Sendable, Enco
         authenticationMethod: APNSClientConfiguration.AuthenticationMethod,
         environment: APNSBroadcastEnvironment,
         bundleID: String,
-        eventLoopGroupProvider: NIOEventLoopGroupProvider,
+        eventLoopGroupProvider: NIOEventLoopGroupProvider = .shared(MultiThreadedEventLoopGroup.singleton),
         responseDecoder: Decoder,
         requestEncoder: Encoder,
         byteBufferAllocator: ByteBufferAllocator = .init(),

diff --git a/Sources/APNS/APNSClient.swift b/Sources/APNS/APNSClient.swift
@@ -23,6 +23,7 @@ import struct Foundation.UUID
 #endif
 import NIOCore
 import NIOHTTP1
+import NIOPosix
 import NIOSSL
 
 /// A client to talk with the Apple Push Notification services.
@@ -72,7 +73,7 @@ public final class APNSClient<Decoder: APNSJSONDecoder, Encoder: APNSJSONEncoder
     ///   - byteBufferAllocator: The `ByteBufferAllocator`.
     public init(
         configuration: APNSClientConfiguration,
-        eventLoopGroupProvider: NIOEventLoopGroupProvider,
+        eventLoopGroupProvider: NIOEventLoopGroupProvider = .shared(MultiThreadedEventLoopGroup.singleton),
         responseDecoder: Decoder,
         requestEncoder: Encoder,
         byteBufferAllocator: ByteBufferAllocator = .init()

diff --git a/Sources/APNSCore/APNSEnvironment.swift b/Sources/APNSCore/APNSEnvironment.swift
@@ -17,10 +17,6 @@ public struct APNSEnvironment: Sendable {
     /// The production APNs environment.
     public static let production = Self(url: "https://api.push.apple.com", port: 443)
 
-    /// The sandbox APNs environment.
-    @available(*, deprecated, renamed: "development")
-    public static let sandbox = development
-
     /// The development APNs environment.
     public static let development = Self(url: "https://api.sandbox.push.apple.com", port: 443)
 

diff --git a/Sources/APNSCore/APNSError.swift b/Sources/APNSCore/APNSError.swift
@@ -62,7 +62,6 @@ public struct APNSError: Error {
             case internalServerError
             case serviceUnavailable
             case shutdown
-            case badEnvironmentKeyInToken
             case featureNotEnabled
             case missingChannelId
             case badChannelId
@@ -140,8 +139,6 @@ public struct APNSError: Error {
                     self = .serviceUnavailable
                 case "Shutdown":
                     self = .shutdown
-                case "BadEnvironmentKeyInToken":
-                    self = .badEnvironmentKeyInToken
                 case "FeatureNotEnabled":
                     self = .featureNotEnabled
                 case "MissingChannelId":
@@ -231,8 +228,6 @@ public struct APNSError: Error {
                     return "ServiceUnavailable"
                 case .shutdown:
                     return "Shutdown"
-                case .badEnvironmentKeyInToken:
-                    return "BadEnvironmentKeyInToken"
                 case .featureNotEnabled:
                     return "FeatureNotEnabled"
                 case .missingChannelId:
@@ -322,8 +317,6 @@ public struct APNSError: Error {
                     return "The service is unavailable"
                 case .shutdown:
                     return "The server is shutting down"
-                case .badEnvironmentKeyInToken:
-                    return "Environment mismatch between key and APNs endpoint"
                 case .featureNotEnabled:
                     return "The broadcast push feature isn't enabled for this topic"
                 case .missingChannelId:
@@ -488,11 +481,6 @@ public struct APNSError: Error {
             return .init(_reason: .shutdown)
         }
 
-        @available(*, deprecated, message: "Not a documented APNs error reason; see badEnvironmentKeyIdInToken.")
-        public static var badEnvironmentKeyInToken: Self {
-            return .init(_reason: .badEnvironmentKeyInToken)
-        }
-
         public static var featureNotEnabled: Self {
             return .init(_reason: .featureNotEnabled)
         }

diff --git a/Sources/APNSCore/LiveActivity/APNSClient+LiveActivity.swift b/Sources/APNSCore/LiveActivity/APNSClient+LiveActivity.swift
@@ -23,7 +23,7 @@ extension APNSClientProtocol {
     ///
     @discardableResult
     @inlinable
-    public func sendLiveActivityNotification<ContentState: Encodable>(
+    public func sendLiveActivityNotification<ContentState: Encodable & Sendable>(
         _ notification: APNSLiveActivityNotification<ContentState>,
         deviceToken: String
     ) async throws -> APNSResponse {

diff --git a/Sources/APNSCore/P256.Signing.PrivateKey+PrivateFilePath.swift b/Sources/APNSCore/P256.Signing.PrivateKey+PrivateFilePath.swift
diff --git a/Sources/APNSCore/Widgets/APNSClient+Widgets.swift b/Sources/APNSCore/Widgets/APNSClient+Widgets.swift
@@ -40,22 +40,4 @@ extension APNSClientProtocol {
         )
         return try await send(request)
     }
-
-    /// Sends a widgets update notification to APNs.
-    ///
-    /// - Parameters:
-    ///   - notification: The notification to send.
-    ///
-    ///   - deviceToken: The hexadecimal bytes that identify the user’s device. Your app receives the bytes for this device token
-    ///    when registering for remote notifications.
-    ///
-    @discardableResult
-    @inlinable
-    @available(*, deprecated, renamed: "sendWidgetsNotification(_:deviceToken:)")
-    public func sendWidgetsNotification(
-        notification: APNSWidgetsNotification,
-        deviceToken: String
-    ) async throws -> APNSResponse {
-        try await self.sendWidgetsNotification(notification, deviceToken: deviceToken)
-    }
 }
diff --git a/Tests/APNSTests/APNSClientIntegrationTests.swift b/Tests/APNSTests/APNSClientIntegrationTests.swift
@@ -311,7 +311,7 @@ struct APNSClientIntegrationTests {
             let notification = APNSWidgetsNotification(appID: "com.example.app")
 
             _ = try await client.sendWidgetsNotification(
-                notification: notification,
+                notification,
                 deviceToken: "aaaa1111aaaa1111aaaa1111aaaa1111aaaa1111aaaa1111aaaa1111aaaa1111"
             )
 

diff --git a/Tests/APNSTests/APNSEnvironmentTests.swift b/Tests/APNSTests/APNSEnvironmentTests.swift
@@ -28,15 +28,6 @@ struct APNSEnvironmentTests {
         #expect(APNSEnvironment.development.absoluteURL == "https://api.sandbox.push.apple.com:443/3/device")
     }
 
-    @available(*, deprecated, message: "Intentionally exercising the deprecated `.sandbox` alias.")
-    @Test func `Sandbox is alias for development`() {
-        // `.sandbox` is deprecated in favor of `.development`, but must remain behaviorally identical.
-        let sandbox = APNSEnvironment.sandbox
-        #expect(sandbox.url == APNSEnvironment.development.url)
-        #expect(sandbox.port == APNSEnvironment.development.port)
-        #expect(sandbox.absoluteURL == APNSEnvironment.development.absoluteURL)
-    }
-
     @Test func `Custom composes URL and port`() {
         let custom = APNSEnvironment.custom(url: "http://127.0.0.1", port: 8080)
         #expect(custom.url == "http://127.0.0.1")

diff --git a/Tests/APNSTests/APNSErrorReasonTests.swift b/Tests/APNSTests/APNSErrorReasonTests.swift
@@ -51,7 +51,6 @@ struct APNSErrorReasonTests {
         (.internalServerError, "InternalServerError"),
         (.serviceUnavailable, "ServiceUnavailable"),
         (.shutdown, "Shutdown"),
-        (.badEnvironmentKeyInToken, "BadEnvironmentKeyInToken"),
         (.featureNotEnabled, "FeatureNotEnabled"),
         (.missingChannelId, "MissingChannelId"),
         (.badChannelId, "BadChannelId"),
@@ -84,11 +83,7 @@ struct APNSErrorReasonTests {
     /// guard against the two being conflated.
     @Test func `Similar environment reasons are distinct`() {
         #expect(
-            APNSError.ErrorReason.Reason.badEnvironmentKeyInToken
-                != APNSError.ErrorReason.Reason.badEnvironmentKeyIdInToken
-        )
-        #expect(
-            APNSError.ErrorReason.Reason(rawValue: "BadEnvironmentKeyInToken") == .badEnvironmentKeyInToken
+            APNSError.ErrorReason.Reason(rawValue: "BadEnvironmentKeyInToken") == .unknown("BadEnvironmentKeyInToken")
         )
         #expect(
             APNSError.ErrorReason.Reason(rawValue: "BadEnvironmentKeyIdInToken") == .badEnvironmentKeyIdInToken