rename _undocumented to __undocumented

Macros/UnstableEnumMacro/+EnumCaseElementSyntax.swift

@@ -10,10 +10,10 @@ extension [EnumCaseElementSyntax] {
         guard self.count > 0 else { return ([], false) }
         var `self` = self
         let last = self.removeLast()
-        guard last.name.trimmedDescription == "_undocumented" else {
+        guard last.name.trimmedDescription == "__undocumented" else {
             let diagnostic = Diagnostic(
                 node: Syntax(last),
-                message: MacroError.lastCaseMustBe_undocumented
+                message: MacroError.lastCaseMustBe__undocumented
             )
             context.diagnose(diagnostic)
             return ([], false)

Macros/UnstableEnumMacro/EnumCase/+Decodable.swift

@@ -14,7 +14,7 @@ extension [EnumCase] {
             let rawValue = try container.decode(\#(raw: rawType.rawValue).self)
             self.init(rawValue: rawValue)!
             #if DISCORDBM_ENABLE_LOGGING_DURING_DECODE
-            if case let ._undocumented(rawValue) = self {
+            if case let .__undocumented(rawValue) = self {
                 DiscordGlobalConfiguration.makeDecodeLogger("\#(raw: enumIdentifier.trimmedDescription)").warning(
                     "Found an undocumented rawValue",
                     metadata: [

Macros/UnstableEnumMacro/EnumCase/+init(rawValue).swift

@@ -16,7 +16,7 @@ extension [EnumCase] {
             switch rawValue {
         \#(raw: cases.indented())
             default:
-                self = ._undocumented(rawValue)
+                self = .__undocumented(rawValue)
             }
         }
         """#

Macros/UnstableEnumMacro/EnumCase/+var rawValue.swift

@@ -15,7 +15,7 @@ extension [EnumCase] {
         \#(raw: accessLevel)var rawValue: \#(raw: rawType.rawValue) {
             switch self {
         \#(raw: cases.indented())
-            case let ._undocumented(rawValue):
+            case let .__undocumented(rawValue):
                 return rawValue
             }
         }

Macros/UnstableEnumMacro/MacroError.swift

@@ -14,7 +14,7 @@ enum MacroError: String, Error {
     case badEnumCaseTrailingTrivia
     case badEnumCaseComment
     case couldNotFindLocationOfNode
-    case lastCaseMustBe_undocumented
+    case lastCaseMustBe__undocumented
 }
 
 extension MacroError: DiagnosticMessage {

Macros/UnstableEnumMacro/UnstableEnum.swift

@@ -17,9 +17,9 @@ import SwiftSyntaxMacros
 /// case value12 // 12
 /// ```
 ///
+/// Requires you to add a new `.__undocumented(RawValue)` case as the last case.
 /// How it manipulates the code:
 /// Adds `RawRepresentable` conformance where `RawValue` is the generic argument of the macro.
-/// Adds a new `._undocumented(RawValue)` case.
 /// which can too easily result in code breakage.
 /// If `Decodable`, adds a slightly-modified `init(from:)` initializer.
 /// If `CaseIterable`, repairs the `static var allCases` requirement.
@@ -57,7 +57,6 @@ public struct UnstableEnum: MemberMacro {
 
         if hasError { return [] }
 
-
         /// Some validations
 
         let values = cases.map(\.value)

README.md

@@ -715,7 +715,7 @@ Finally, add `import DiscordBM` to your source code.
 ## Versioning
 `DiscordBM` will try to follow Semantic Versioning 2.0.0, with exceptions:    
 * To keep `DiscordBM` up to date with Discord API's frequent changes, `DiscordBM` will **add** any new properties to any types in **minor** versions, even if it's technically a breaking change.   
-* `DiscordBM` tries to minimize the effect of this requirement. For example most enums have an underscored case named `_undocumented` which asks users to use non-exhaustive switch statements, preventing future code-breakages.  
+* `DiscordBM` tries to minimize the effect of this requirement. For example most enums have an underscored case named `__undocumented` which asks users to use non-exhaustive switch statements, preventing future code-breakages.  
 
 ## Contribution & Support
 * If you need help with anything, ask in [DiscordBM's Discord server](https://discord.gg/kxfs5n7HVE).

Sources/DiscordGateway/DiscordCache.swift

@@ -829,7 +829,7 @@ public actor DiscordCache {
             self.autoModerationExecutions[execution.guild_id, default: []].append(execution)
         case let .applicationCommandPermissionsUpdate(update):
             self.applicationCommandPermissions[update.id] = update
-        case ._undocumented:
+        case .__undocumented:
             break
         }
     }

Sources/DiscordGateway/GatewayEventHandler.swift

@@ -498,7 +498,7 @@ extension GatewayEventHandler {
             await withLogging(for: "onAutoModerationActionExecution") {
                 try await onAutoModerationActionExecution(payload)
             }
-        case ._undocumented:
+        case .__undocumented:
             break
         }
 

Sources/DiscordModels/Types/Application Commands.swift

@@ -9,7 +9,7 @@ public struct ApplicationCommand: Sendable, Codable {
         case chatInput // 1
         case user // 2
         case message // 3
-        case _undocumented(UInt)
+        case __undocumented(UInt)
     }
 
     /// https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-structure
@@ -29,7 +29,7 @@ public struct ApplicationCommand: Sendable, Codable {
             case mentionable // 9
             case number // 10
             case attachment // 11
-            case _undocumented(UInt)
+            case __undocumented(UInt)
         }
 
         /// https://discord.com/developers/docs/interactions/application-commands#application-command-object-application-command-option-choice-structure
@@ -164,7 +164,7 @@ public struct GuildApplicationCommandPermissions: Sendable, Codable {
             case role // 1
             case user // 2
             case channel // 3
-            case _undocumented(Int)
+            case __undocumented(Int)
         }
 
         public var type: Kind

Sources/DiscordModels/Types/Application Role Connection Metadata.swift

@@ -13,7 +13,7 @@ public struct ApplicationRoleConnectionMetadata: Sendable, Codable, ValidatableP
         case dateTimeGreaterThanOrEqual // 6
         case booleanEqual // 7
         case booleanNotEqual // 8
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     public var type: Kind

Sources/DiscordModels/Types/Application.swift

@@ -15,7 +15,7 @@ public struct DiscordApplication: Sendable, Codable {
         case gatewayMessageContent // 18
         case gatewayMessageContentLimited // 19
         case applicationCommandBadge // 23
-        case _undocumented(UInt)
+        case __undocumented(UInt)
     }
 
     /// https://discord.com/developers/docs/resources/application#install-params-object

Sources/DiscordModels/Types/Audit Log.swift

@@ -183,7 +183,7 @@ public struct AuditLog: Sendable, Codable {
             case autoModerationUserCommunicationDisabled // 145
             case creatorMonetizationRequestCreated // 150
             case creatorMonetizationTermsAccepted // 151
-            case _undocumented(Int)
+            case __undocumented(Int)
         }
 
         /// A mix of the below two types.
@@ -246,7 +246,7 @@ public struct AuditLog: Sendable, Codable {
             case autoModerationUserCommunicationDisabled(AutoModerationInfo)
             case creatorMonetizationRequestCreated
             case creatorMonetizationTermsAccepted
-            case _undocumented
+            case __undocumented
 
             public struct OverwriteInfo: Sendable, Codable {
 
@@ -515,8 +515,8 @@ public struct AuditLog: Sendable, Codable {
                     self = .autoModerationUserCommunicationDisabled(moderationInfo)
                 case .creatorMonetizationRequestCreated: self = .creatorMonetizationRequestCreated
                 case .creatorMonetizationTermsAccepted: self = .creatorMonetizationTermsAccepted
-                case ._undocumented:
-                    self = ._undocumented
+                case .__undocumented:
+                    self = .__undocumented
                 }
             }
 
@@ -614,7 +614,7 @@ public struct AuditLog: Sendable, Codable {
                     try container.encode(moderationInfo, forKey: .options)
                 case .creatorMonetizationRequestCreated: break
                 case .creatorMonetizationTermsAccepted: break
-                case ._undocumented: break
+                case .__undocumented: break
                 }
             }
         }
@@ -651,7 +651,7 @@ public struct AuditLog: Sendable, Codable {
         }
 
         public func encode(to encoder: any Encoder) throws {
-            if case ._undocumented = action { return }
+            if case .__undocumented = action { return }
 
             var container = encoder.container(keyedBy: CodingKeys.self)
             try container.encodeIfPresent(self.guild_id, forKey: .guild_id)
@@ -736,8 +736,8 @@ extension AuditLog.Entry.ActionKind {
             self = .creatorMonetizationTermsAccepted
         case .creatorMonetizationRequestCreated:
             self = .creatorMonetizationRequestCreated
-        case ._undocumented:
-            self = ._undocumented(-1)
+        case .__undocumented:
+            self = .__undocumented(-1)
         }
     }
 }

Sources/DiscordModels/Types/Auto Moderation.swift

@@ -6,7 +6,7 @@ public struct AutoModerationRule: Sendable, Codable {
     @UnstableEnum<Int>
     public enum EventKind: Sendable, Codable {
         case messageSend // 1
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-types
@@ -16,7 +16,7 @@ public struct AutoModerationRule: Sendable, Codable {
         case spam // 3
         case keywordPreset // 4
         case mentionSpam // 5
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/auto-moderation#auto-moderation-rule-object-trigger-metadata
@@ -28,7 +28,7 @@ public struct AutoModerationRule: Sendable, Codable {
             case profanity // 1
             case sexualContent // 2
             case slurs // 3
-            case _undocumented(Int)
+            case __undocumented(Int)
         }
 
         public var keyword_filter: [String]?

Sources/DiscordModels/Types/Channel.swift

@@ -20,7 +20,7 @@ public struct DiscordChannel: Sendable, Codable {
         case guildStageVoice // 13
         case guildDirectory // 14
         case guildForum // 15
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/channel#overwrite-object
@@ -31,7 +31,7 @@ public struct DiscordChannel: Sendable, Codable {
         public enum Kind: Sendable, Codable {
             case role // 0
             case member // 1
-            case _undocumented(Int)
+            case __undocumented(Int)
         }
 
         public var id: AnySnowflake
@@ -45,7 +45,7 @@ public struct DiscordChannel: Sendable, Codable {
     public enum SortOrder: Sendable, Codable {
         case latestActivity // 0
         case creationDate // 1
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/channel#channel-object-forum-layout-types
@@ -54,23 +54,23 @@ public struct DiscordChannel: Sendable, Codable {
         case notSet // 0
         case listView // 1
         case galleryView // 2
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/channel#channel-object-channel-flags
     @UnstableEnum<UInt>
     public enum Flag: Sendable {
         case pinned // 1
         case requireTag // 4
-        case _undocumented(UInt)
+        case __undocumented(UInt)
     }
 
     /// https://discord.com/developers/docs/resources/channel#channel-object-video-quality-modes
     @UnstableEnum<Int>
     public enum VideoQualityMode: Sendable, Codable {
         case auto // 1
         case full // 2
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// Not exactly documented, but they do mention these times in a few different places.
@@ -82,7 +82,7 @@ public struct DiscordChannel: Sendable, Codable {
         case oneDay // 1_440
         case threeDays // 4_320
         case sevenDays // 10_080
-        case _undocumented(Int)
+        case __undocumented(Int)
     }
 
     /// https://discord.com/developers/docs/resources/channel#default-reaction-object-default-reaction-structure
@@ -208,7 +208,7 @@ extension DiscordChannel {
             case stageSpeaker // 29
             case stageTopic // 31
             case guildApplicationPremiumSubscription // 32
-            case _undocumented(Int)
+            case __undocumented(Int)
         }
 
         /// https://discord.com/developers/docs/resources/channel#message-object-message-flags
@@ -225,7 +225,7 @@ extension DiscordChannel {
             case failedToMentionSomeRolesInThread // 8
             case suppressNotifications // 12
             case isVoiceMessage // 13
-            case _undocumented(UInt)
+            case __undocumented(UInt)
         }
 
         /// https://discord.com/developers/docs/resources/channel#channel-mention-object
@@ -243,7 +243,7 @@ extension DiscordChannel {
             @UnstableEnum<UInt>
             public enum Flag: Sendable {
                 case isRemix // 2
-                case _undocumented(UInt)
+                case __undocumented(UInt)
             }
 
             public var id: AttachmentSnowflake
@@ -349,7 +349,7 @@ extension DiscordChannel {
                 case spectate // 2
                 case listen // 3
                 case joinRequest // 5
-                case _undocumented(Int)
+                case __undocumented(Int)
             }
 
             public var type: Kind
@@ -487,7 +487,7 @@ public enum ThreadKind: Sendable, Codable {
     case announcementThread // 10
     case publicThread // 11
     case privateThread // 12
-    case _undocumented(Int)
+    case __undocumented(Int)
 }
 
 extension DiscordChannel {
@@ -500,7 +500,7 @@ extension DiscordChannel {
             case roles
             case users
             case everyone
-            case _undocumented(String)
+            case __undocumented(String)
         }
 
         public var parse: [Kind]
@@ -523,7 +523,7 @@ public struct Embed: Sendable, Codable, ValidatablePayload {
         case article // "article"
         case link // "link"
         case autoModerationMessage // "auto_moderation_message"
-        case _undocumented(String)
+        case __undocumented(String)
     }
 
     public enum DynamicURL: Sendable, Codable, ExpressibleByStringLiteral {
@@ -708,7 +708,7 @@ extension DiscordChannel.Message.Kind {
             return true
         case .recipientAdd, .recipientRemove, .call, .channelNameChange, .channelIconChange, .guildDiscoveryDisqualified, .guildDiscoveryRequalified, .guildDiscoveryGracePeriodInitialWarning, .guildDiscoveryGracePeriodFinalWarning, .threadStarterMessage, .guildApplicationPremiumSubscription:
             return false
-        case ._undocumented: return false
+        case .__undocumented: return false
         }
     }
 }

Sources/DiscordModels/Types/Error Codes.swift

@@ -243,7 +243,7 @@ public enum JSONErrorCode: Sendable, Codable {
     case messageBlockedByHarmfulLinksFilter // 240000
     case cannotEnableOnboardingRequirementsAreNotMet // 350000
     case cannotUpdateOnboardingWhileBelowRequirements // 350001
-    case _undocumented(Int)
+    case __undocumented(Int)
 }
 
 /// https://discord.com/developers/docs/topics/opcodes-and-status-codes#json