RubyGems - mongo - Versions diffs - 2.12.1 → 2.13.0 - Mend

mongo 2.12.1 → 2.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (856) hide show

data/lib/mongo/error/credential_check_error.rb ADDED

@@ -0,0 +1,26 @@
+# Copyright (C) 2020 MongoDB Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Mongo
+  class Error
+    # Credential check for MONGODB-AWS authentication mechanism failed.
+    #
+    # This exception is raised when the driver attempts to verify the
+    # credentials via STS prior to sending them to the server, and the
+    # verification fails due to an error response from the STS.
+    class CredentialCheckError < AuthError
+    end
+  end
+end

data/lib/mongo/error/extra_file_chunk.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/file_not_found.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/handshake_error.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2018-2019 MongoDB, Inc.
+# Copyright (C) 2018-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/insufficient_iteration_count.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_address.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_application_name.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2016-2019 MongoDB, Inc.
+# Copyright (C) 2016-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_bulk_operation.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_bulk_operation_type.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_collection_name.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_cursor_operation.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_database_name.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_document.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_file.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_file_revision.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_min_pool_size.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_nonce.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -16,7 +16,7 @@ module Mongo
   class Error
     # This exception is raised when the server nonce returned does not
-    # match the client nonce sent to it.
+    # start with the client nonce sent to it.
     #
     # @since 2.0.0
     class InvalidNonce < Error

data/lib/mongo/error/invalid_read_option.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2018-2019 MongoDB, Inc.
+# Copyright (C) 2018-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_replacement_document.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_server_auth_host.rb ADDED

@@ -0,0 +1,22 @@
+# Copyright (C) 2020 MongoDB Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Mongo
+  class Error
+    # Raised when the server returned an invalid Host value in AWS auth.
+    class InvalidServerAuthHost < InvalidServerAuthResponse
+    end
+  end
+end

data/lib/mongo/error/invalid_server_auth_response.rb ADDED

@@ -0,0 +1,23 @@
+# Copyright (C) 2020 MongoDB Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Mongo
+  class Error
+    # Raised when authentication is aborted on the client because the server
+    # responded in an unacceptable manner.
+    class InvalidServerAuthResponse < AuthError
+    end
+  end
+end

data/lib/mongo/error/invalid_server_preference.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -30,6 +30,11 @@ module Mongo
       # @since 2.4.0
       NO_MAX_STALENESS_SUPPORT = 'max_staleness cannot be set for this read preference.'.freeze
+      # Error message when hedge is specified for a read preference that does not support it.
+      #
+      # @api private
+      NO_HEDGE_SUPPORT = 'The hedge option cannot be set for this read preference'.freeze
       # Error message for when the max staleness is not at least twice the heartbeat frequency.
       #
       # @since 2.4.0

data/lib/mongo/error/invalid_session.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,7 +15,8 @@
 module Mongo
   class Error
-    # This exception is raised when a session is attempted to be used and it is invalid.
+    # This exception is raised when a session is attempted to be used and it
+    # is invalid.
     #
     # @since 2.5.0
     class InvalidSession < Error

data/lib/mongo/error/invalid_signature.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_transaction_operation.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_txt_record.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_update_document.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_uri.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/invalid_write_concern.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/lint_error.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2018-2019 MongoDB, Inc.
+# Copyright (C) 2018-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/max_bson_size.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/max_message_size.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/mismatched_domain.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_file_chunk.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_password.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_resume_token.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/missing_scram_server_signature.rb ADDED

@@ -0,0 +1,27 @@
+# Copyright (C) 2020 MongoDB Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#   http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+module Mongo
+  class Error
+    # This exception is raised when the server returned +{done: true}+ in a
+    # SCRAM conversation but did not provide a ServerSignature.
+    class MissingScramServerSignature < Error
+      def initialize(msg = nil)
+        msg ||= "Server signaled completion of SCRAM conversation without providing ServerSignature"
+        super(msg)
+      end
+    end
+  end
+end

data/lib/mongo/error/multi_index_drop.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/need_primary_server.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/no_server_available.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2014-2019 MongoDB, Inc.
+# Copyright (C) 2014-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/no_srv_records.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2017-2019 MongoDB, Inc.
+# Copyright (C) 2017-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.

data/lib/mongo/error/notable.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2019 MongoDB, Inc.
+# Copyright (C) 2019-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -15,8 +15,9 @@
 module Mongo
   class Error < StandardError
-    # A module encapsulating note tracking functionality, since currently
-    # the driver does not have a single exception hierarchy root.
+    # A module encapsulating functionality to manage data attached to
+    # exceptions in the driver, since the driver does not currently have a
+    # single exception hierarchy root.
     #
     # @since 2.11.0
     # @api private
@@ -42,9 +43,23 @@ module Mongo
         unless @notes
           @notes = []
         end
+        if Lint.enabled?
+          if @notes.include?(note)
+            # The driver makes an effort to not add duplicated notes, by
+            # keeping track of *when* a particular exception should have the
+            # particular notes attached to it throughout the call stack.
+            raise Error::LintError, "Adding a note which already exists in exception #{self}: #{note}"
+          end
+        end
         @notes << note
       end
+      # Returns connection pool generation for the connection on which the
+      # error occurred.
+      #
+      # @return [ Integer | nil ] Connection pool generation.
+      attr_accessor :generation
       # @api public
       def to_s
         super + notes_tail

data/lib/mongo/error/operation_failure.rb CHANGED

@@ -1,4 +1,4 @@
-# Copyright (C) 2015-2019 MongoDB, Inc.
+# Copyright (C) 2015-2020 MongoDB Inc.
 #
 # Licensed under the Apache License, Version 2.0 (the "License");
 # you may not use this file except in compliance with the License.
@@ -28,18 +28,18 @@ module Mongo
       # @since 2.6.0
       # @api private
       WRITE_RETRY_ERRORS = [
-        {:code_name => 'InterruptedAtShutdown', :code => 11600},
-        {:code_name => 'InterruptedDueToStepDown', :code => 11602},
-        {:code_name => 'NotMaster', :code => 10107},
-        {:code_name => 'NotMasterNoSlaveOk', :code => 13435},
-        {:code_name => 'NotMasterOrSecondary', :code => 13436},
-        {:code_name => 'PrimarySteppedDown', :code => 189},
-        {:code_name => 'ShutdownInProgress', :code => 91},
-        {:code_name => 'HostNotFound', :code => 7},
         {:code_name => 'HostUnreachable', :code => 6},
+        {:code_name => 'HostNotFound', :code => 7},
         {:code_name => 'NetworkTimeout', :code => 89},
+        {:code_name => 'ShutdownInProgress', :code => 91},
+        {:code_name => 'PrimarySteppedDown', :code => 189},
+        {:code_name => 'ExceededTimeLimit', :code => 262},
         {:code_name => 'SocketException', :code => 9001},
-        {:code_name => 'ExceededTimeLimit', :code => 262}
+        {:code_name => 'NotMaster', :code => 10107},
+        {:code_name => 'InterruptedAtShutdown', :code => 11600},
+        {:code_name => 'InterruptedDueToReplStateChange', :code => 11602},
+        {:code_name => 'NotMasterNoSlaveOk', :code => 13435},
+        {:code_name => 'NotMasterOrSecondary', :code => 13436},
       ].freeze
       # These are magic error messages that could indicate a master change.
@@ -71,6 +71,14 @@ module Mongo
       def_delegators :@result, :operation_time
+      # @!method connection_description
+      #
+      # @return [ Server::Description ] Server description of the server that
+      #   the operation that this exception refers to was performed on.
+      #
+      # @api private
+      def_delegator :@result, :connection_description
       # @return [ Integer ] The error code parsed from the document.
       #
       # @since 2.6.0
@@ -119,12 +127,26 @@ module Mongo
       # Error codes and code names that should result in a failing getMore
       # command on a change stream NOT being resumed.
       #
-      # @since 2.6.0
       # @api private
-      CHANGE_STREAM_NOT_RESUME_ERRORS = [
-        {:code_name => 'CappedPositionLost', :code => 136},
-        {:code_name => 'CursorKilled', :code => 237},
-        {:code_name => 'Interrupted', :code => 11601},
+      CHANGE_STREAM_RESUME_ERRORS = [
+        {code_name: 'HostUnreachable', code: 6},
+        {code_name: 'HostNotFound', code: 7},
+        {code_name: 'NetworkTimeout', code: 89},
+        {code_name: 'ShutdownInProgress', code: 91},
+        {code_name: 'PrimarySteppedDown', code: 189},
+        {code_name: 'ExceededTimeLimit', code: 262},
+        {code_name: 'SocketException', code: 9001},
+        {code_name: 'NotMaster', code: 10107},
+        {code_name: 'InterruptedAtShutdown', code: 11600},
+        {code_name: 'InterruptedDueToReplStateChange', code: 11602},
+        {code_name: 'NotMasterNoSlaveOk', code: 13435},
+        {code_name: 'NotMasterOrSecondary', code: 13436},
+        {code_name: 'StaleShardVersion', code: 63},
+        {code_name: 'FailedToSatisfyReadPreference', code: 133},
+        {code_name: 'StaleEpoch', code: 150},
+        {code_name: 'RetryChangeStream', code: 234},
+        {code_name: 'StaleConfig', code: 13388},
       ].freeze
       # Change stream can be resumed when these error messages are encountered.
@@ -144,59 +166,53 @@ module Mongo
       # @since 2.6.0
       def change_stream_resumable?
         if @result && @result.is_a?(Mongo::Operation::GetMore::Result)
-          !change_stream_not_resumable_label? &&
-          (change_stream_resumable_message? ||
-          change_stream_resumable_code?)
+          # CursorNotFound exceptions are always resumable because the server
+          # is not aware of the cursor id, and thus cannot determine if
+          # the cursor is a change stream and cannot add the
+          # ResumableChangeStreamError label.
+          return true if code == 43
+          # Connection description is not populated for unacknowledged writes.
+          if connection_description.max_wire_version >= 9
+            label?('ResumableChangeStreamError')
+          else
+            change_stream_resumable_code?
+          end
         else
           false
         end
       end
-      def change_stream_resumable_message?
-        CHANGE_STREAM_RESUME_MESSAGES.any? { |m| message.include?(m) }
-      end
-      private :change_stream_resumable_message?
       def change_stream_resumable_code?
-        if code
-          !CHANGE_STREAM_NOT_RESUME_ERRORS.any? { |e| e[:code] == code }
-        else
-          true
-        end
+        CHANGE_STREAM_RESUME_ERRORS.any? { |e| e[:code] == code }
       end
       private :change_stream_resumable_code?
-      def change_stream_not_resumable_label?
-        if labels
-          labels.include? 'NonResumableChangeStreamError'
-        else
-          false
-        end
-      end
-      private :change_stream_not_resumable_label?
       # @return [ true | false ] Whether the failure includes a write
       #   concern error. A failure may have a top level error and a write
       #   concern error or either one of the two.
       #
       # @since 2.10.0
-      # @api experimental
       def write_concern_error?
-        @write_concern_error
+        !!@write_concern_error_document
       end
+      # Returns the write concern error document as it was reported by the
+      # server, if any.
+      #
+      # @return [ Hash | nil ] Write concern error as reported to the server.
+      attr_reader :write_concern_error_document
       # @return [ Integer | nil ] The error code for the write concern error,
       #   if a write concern error is present and has a code.
       #
       # @since 2.10.0
-      # @api experimental
       attr_reader :write_concern_error_code
       # @return [ String | nil ] The code name for the write concern error,
       #   if a write concern error is present and has a code name.
       #
       # @since 2.10.0
-      # @api experimental
       attr_reader :write_concern_error_code_name
       # Create the operation failure.
@@ -213,12 +229,14 @@ module Mongo
       #
       # @option options [ Integer ] :code Error code.
       # @option options [ String ] :code_name Error code name.
-      # @option options [ true | false ] :write_concern_error Whether the
-      #   write concern error is present.
+      # @option options [ Hash ] :write_concern_error_document The
+      #   server-supplied write concern error document, if any.
       # @option options [ Integer ] :write_concern_error_code Error code for
       #   write concern error, if any.
       # @option options [ String ] :write_concern_error_code_name Error code
       #   name for write concern error, if any.
+      # @option options [ Array<String> ] :write_concern_error_labels Error
+      #   labels for the write concern error, if any.
       # @option options [ Array<String> ] :labels The set of labels associated
       #   with the error.
       # @option options [ true | false ] :wtimeout Whether the error is a wtimeout.
@@ -229,9 +247,10 @@ module Mongo
         @result = result
         @code = options[:code]
         @code_name = options[:code_name]
-        @write_concern_error = !!options[:write_concern_error]
+        @write_concern_error_document = options[:write_concern_error_document]
         @write_concern_error_code = options[:write_concern_error_code]
         @write_concern_error_code_name = options[:write_concern_error_code_name]
+        @write_concern_error_labels = options[:write_concern_error_labels] || []
         @labels = options[:labels] || []
         @wtimeout = !!options[:wtimeout]
       end