Add support for the type field in PubNubMembershipMetadata (#194)

feat(membership): add support for the `type` field in `PubNubMembershipMetadata`

feat(app-context): deprecate methods containing `uuid` parameter,  introduce new versions

feat(app-context): deprecate methods containing the `include` parameter of the `Bool` type, introduce new versions

feat(app-context): deprecate `remove(channel:custom:completion:)`, introduce new version 

feat(app-context): replace `PubNubUUIDMetadata` with `PubNubUserMetadata`

feat(app-context): replace `PubNubUUIDMetadataBase` with `PubNubUserMetadataBase`

feat(app-context): add an alias for backward compatibility with the customer code using `PubNubUUIDMetadata`

feat(app-context): add an alias for backward compatibility with the customer code using `PubNubUUIDMetadataBase`

feat(listeners): replace `PubNubUUIDMetadataChangeset` with `PubNubUserMetadataChangeset`

feat(listeners): add an alias for backward compatibility with the customer code using `PubNubUUIDMetadataChangeset`

Author: jguz-pubnub

.pubnub.yml

@@ -1,9 +1,32 @@
 ---
 name: swift
 scm: github.com/pubnub/swift
-version: "8.1.0"
+version: "8.2.0"
 schema: 1
 changelog:
+  - date: 2024-12-04
+    version: 8.2.0
+    changes:
+      - type: feature
+        text: "Add support for the Membership `type` field."
+      - type: feature
+        text: "Deprecate methods containing `uuid` parameter,  introduce new versions."
+      - type: feature
+        text: "Deprecate methods containing `include` parameter of `Bool` type, introduce new versions."
+      - type: feature
+        text: "Deprecate `remove(channel:custom:completion:)`, introduce new version ."
+      - type: feature
+        text: "Replace `PubNubUUIDMetadata` with `PubNubUserMetadata`."
+      - type: feature
+        text: "Replace `PubNubUUIDMetadataBase` with `PubNubUserMetadataBase`."
+      - type: feature
+        text: "Add an alias for backward compatibility with the customer code using `PubNubUUIDMetadata`."
+      - type: feature
+        text: "Add an alias for backward compatibility with the customer code using `PubNubUUIDMetadataBase`."
+      - type: feature
+        text: "Replace `PubNubUUIDMetadataChangeset` with `PubNubUserMetadataChangeset`."
+      - type: feature
+        text: "Add an alias for backward compatibility with the customer code using `PubNubUUIDMetadataChangeset`."
   - date: 2024-11-18
     version: 8.1.0
     changes:
@@ -596,7 +619,7 @@ sdks:
           - distribution-type: source
             distribution-repository: GitHub release
             package-name: PubNub
-            location: https://github.com/pubnub/swift/archive/refs/tags/8.1.0.zip
+            location: https://github.com/pubnub/swift/archive/refs/tags/8.2.0.zip
             supported-platforms:
               supported-operating-systems:
                 macOS:

Gemfile

@@ -2,4 +2,4 @@ source "https://rubygems.org"
 
 gem "cocoapods"
 gem "fastlane"
-gem 'rexml', '3.3.8'
+gem 'rexml', '3.3.9'

Gemfile.lock

@@ -252,7 +252,7 @@ GEM
       trailblazer-option (>= 0.1.1, < 0.2.0)
       uber (< 0.2.0)
     retriable (3.1.2)
-    rexml (3.3.8)
+    rexml (3.3.9)
     rouge (2.0.7)
     ruby-macho (2.5.1)
     ruby2_keywords (0.0.5)
@@ -311,7 +311,7 @@ PLATFORMS
 DEPENDENCIES
   cocoapods
   fastlane
-  rexml (= 3.3.8)
+  rexml (= 3.3.9)
 
 BUNDLED WITH
    2.5.22

PubNub.xcodeproj/project.pbxproj

@@ -350,7 +350,7 @@ public extension PubNubMembershipInterface {
         customFields: nil,
         totalCount: false,
         changes: .init(
-          set: users.map { .init(metadataId: $0.user.id, status: $0.status, custom: $0.custom?.flatJSON) },
+          set: users.map { .init(metadataId: $0.user.id, status: $0.status, type: nil, custom: $0.custom?.flatJSON) },
           delete: []
         ),
         filter: nil,
@@ -387,7 +387,7 @@ public extension PubNubMembershipInterface {
         customFields: nil,
         totalCount: false,
         changes: .init(
-          set: spaces.map { .init(metadataId: $0.space.id, status: $0.status, custom: $0.custom?.flatJSON) },
+          set: spaces.map { .init(metadataId: $0.space.id, status: $0.status, type: nil, custom: $0.custom?.flatJSON) },
           delete: []
         ),
         filter: nil,
@@ -451,7 +451,7 @@ public extension PubNubMembershipInterface {
         totalCount: false,
         changes: .init(
           set: [],
-          delete: userIds.map { .init(metadataId: $0, status: nil, custom: nil) }
+          delete: userIds.map { .init(metadataId: $0, status: nil, type: nil, custom: nil) }
         ),
         filter: nil,
         sort: [],
@@ -488,7 +488,7 @@ public extension PubNubMembershipInterface {
         totalCount: false,
         changes: .init(
           set: [],
-          delete: spaceIds.map { .init(metadataId: $0, status: nil, custom: nil) }
+          delete: spaceIds.map { .init(metadataId: $0, status: nil, type: nil, custom: nil) }
         ),
         filter: nil,
         sort: [],

PubNubMembership/Sources/Membership+PubNub.swift

@@ -197,7 +197,7 @@ public extension PubNubSpaceInterface {
   ) {
     let router = ObjectsChannelRouter(
       .all(
-        customFields: includeCustom,
+        include: PubNub.ChannelIncludeFields(custom: includeCustom).includeFields,
         totalCount: includeTotalCount,
         filter: filter,
         sort: sort.map { $0.routerParameter },
@@ -229,7 +229,7 @@ public extension PubNubSpaceInterface {
     completion: @escaping (Result<PubNubSpace, Error>) -> Void
   ) {
     let router = ObjectsChannelRouter(
-      .fetch(metadataId: spaceId, customFields: includeCustom),
+      .fetch(metadataId: spaceId, include: PubNub.ChannelIncludeFields(custom: includeCustom).includeFields),
       configuration: requestConfig.customConfiguration ?? configuration
     )
 
@@ -265,7 +265,7 @@ public extension PubNubSpaceInterface {
           channelDescription: description,
           custom: custom?.flatJSON
         ),
-        customFields: includeCustom
+        include: PubNub.ChannelIncludeFields(custom: includeCustom).includeFields
       ),
       configuration: requestConfig.customConfiguration ?? configuration
     )

PubNubSpace/Sources/Space+PubNub.swift

@@ -1,6 +1,6 @@
 Pod::Spec.new do |s|
   s.name     = 'PubNubSwift'
-  s.version  = '8.1.0'
+  s.version  = '8.2.0'
   s.homepage = 'https://github.com/pubnub/swift'
   s.documentation_url = 'https://www.pubnub.com/docs/swift-native/pubnub-swift-sdk'
   s.authors = { 'PubNub, Inc.' => '[email protected]' }

PubNubSwift.podspec

@@ -139,8 +139,8 @@ extension PubNubUser: Codable {
 
 // MARK: Object v2 Migration
 
-public extension PubNubUUIDMetadata {
-  /// Converts Object V2 UUID Metadata to a Space entity
+public extension PubNubUserMetadata {
+  /// Converts Object V2 User Metadata to a User entity
   ///
   /// - returns: The `PubNubUser` built from the Object V2 data
   func convert() -> PubNubUser {

PubNubUser/Sources/PubNubUser.swift

@@ -203,9 +203,9 @@ public extension PubNubUserInterface {
     requestConfig: PubNub.RequestConfiguration = .init(),
     completion: @escaping ((Result<(users: [PubNubUser], next: PubNubHashedPage?), Error>) -> Void)
   ) {
-    let router = ObjectsUUIDRouter(
+    let router = ObjectsUserRouter(
       .all(
-        customFields: includeCustom,
+        include: PubNub.UserIncludeFields(custom: includeCustom).includeFields,
         totalCount: includeTotalCount,
         filter: filter,
         sort: sort.map { $0.routerParameter },
@@ -226,7 +226,7 @@ public extension PubNubUserInterface {
         completion(result.map { (
           users: $0.payload.data,
           next: PubNub.Page(next: $0.payload.next, prev: $0.payload.prev, totalCount: $0.payload.totalCount)
-        ) })
+        )})
       }
   }
 
@@ -236,10 +236,10 @@ public extension PubNubUserInterface {
     requestConfig: PubNub.RequestConfiguration = .init(),
     completion: @escaping (Result<PubNubUser, Error>) -> Void
   ) {
-    let router = ObjectsUUIDRouter(
+    let router = ObjectsUserRouter(
       .fetch(
         metadataId: userId ?? (requestConfig.customConfiguration?.uuid ?? configuration.uuid),
-        customFields: includeCustom
+        include: PubNub.UserIncludeFields(custom: includeCustom).includeFields
       ),
       configuration: requestConfig.customConfiguration ?? configuration
     )
@@ -268,9 +268,9 @@ public extension PubNubUserInterface {
     requestConfig: PubNub.RequestConfiguration = .init(),
     completion: ((Result<PubNubUser, Error>) -> Void)?
   ) {
-    let router = ObjectsUUIDRouter(
+    let router = ObjectsUserRouter(
       .set(
-        metadata: PubNubUUIDMetadataBase(
+        metadata: PubNubUserMetadataBase(
           metadataId: userId ?? (requestConfig.customConfiguration?.uuid ?? configuration.uuid),
           name: name,
           type: type,
@@ -280,7 +280,7 @@ public extension PubNubUserInterface {
           email: email,
           custom: custom?.flatJSON
         ),
-        customFields: includeCustom
+        include: PubNub.UserIncludeFields(custom: includeCustom).includeFields
       ),
       configuration: requestConfig.customConfiguration ?? configuration
     )
@@ -329,7 +329,7 @@ public extension PubNubUserInterface {
     requestConfig: PubNub.RequestConfiguration = .init(),
     completion: ((Result<Void, Error>) -> Void)?
   ) {
-    let router = ObjectsUUIDRouter(
+    let router = ObjectsUserRouter(
       .remove(metadataId: userId ?? (requestConfig.customConfiguration?.uuid ?? configuration.uuid)),
       configuration: requestConfig.customConfiguration ?? configuration
     )

PubNubUser/Sources/User+PubNub.swift

@@ -103,7 +103,7 @@ class PubNubUserModelTests: XCTestCase {
   }
 
   func testPubNubUser_Convert_UUIDMetadata() {
-    let userMetadata = PubNubUUIDMetadataBase(
+    let userMetadata = PubNubUserMetadataBase(
       metadataId: testUser.id,
       name: testUser.name,
       type: testUser.type,
@@ -120,7 +120,7 @@ class PubNubUserModelTests: XCTestCase {
   }
 
   func testPubNubUser_Convert_UUIDMetadata_nilProfileUrl() {
-    let userMetadata = PubNubUUIDMetadataBase(
+    let userMetadata = PubNubUserMetadataBase(
       metadataId: testUser.id,
       name: testUser.name,
       type: testUser.type,
@@ -140,7 +140,7 @@ class PubNubUserModelTests: XCTestCase {
   }
 
   func testPubNubUser_Convert_UUIDMetadata_nilCustom() {
-    let userMetadata = PubNubUUIDMetadataBase(
+    let userMetadata = PubNubUserMetadataBase(
       metadataId: testUser.id,
       name: testUser.name,
       type: testUser.type,