DOCSP-26075: pre image setting (#64)

* DOCSP-26075: pre image setting

* small fixes

* RL link suggestion

* DB PR fixes 1

Author: rustagir

source/source-connector/configuration-properties/change-stream.txt

@@ -64,11 +64,15 @@ Settings
        | **Description:**
        | Determines what values your change stream returns on update
          operations.
-       | The ``default`` setting returns the differences between the original
+       | The default setting returns the differences between the original
          document and the updated document.
        | The ``updateLookup`` setting returns the differences between the
          original document and updated document as well as a copy of the
          entire updated document at a *point in time* after the update.
+       | The ``whenAvailable`` setting returns the updated document,
+         if available.
+       | The ``required`` setting returns the updated document and
+         raises an error if it is not available.
 
        .. tip::
 
@@ -78,7 +82,32 @@ Settings
 
        |
        | **Default**: ``""``
-       | **Accepted Values**: ``""`` or ``"default"`` or ``"updateLookup"``
+       | **Accepted Values**: ``""``, ``"updateLookup"``, ``"whenAvailable"``, or ``"required"``
+       
+   * - | **change.stream.full.document.before.change**
+     - | **Type:** string
+       |
+       | **Description:**
+       | Configures the document pre-image your change stream returns on update
+         operations. The pre-image is not available for source records
+         published while copying existing data, and the pre-image configuration
+         has no effect on copying.
+         
+       .. tip::
+       
+          To learn how to configure a collection to enable
+          pre-images, see the :manual:`Server manual entry on pre- and
+          post-images </changeStreams/#change-streams-with-document-pre--and-post-images>`.
+       
+       | The default setting suppresses the document pre-image.
+       | The ``whenAvailable`` setting returns the document pre-image if
+         it's available, before it was replaced, updated, or
+         deleted.
+       | The ``required`` setting returns the document pre-image and
+         raises an error if it is not available.
+       |
+       | **Default**: ``""``
+       | **Accepted Values**: ``""`` or ``"whenAvailable"`` or ``"required"``
 
    * - | **publish.full.document.only**
      - | **Type:** boolean

source/whats-new.txt

@@ -30,13 +30,16 @@ Learn what's new by version:
 What's New in 1.9
 -----------------
 
-- Introduced ``startup.mode=timestamp`` setting that allows you to
+- Introduced the ``startup.mode=timestamp`` setting that allows you to
   start a Change Stream at a specific timestamp by setting the new
   ``startup.mode.timestamp.start.at.operation.time`` property.
 - Deprecated the ``copy.existing`` property and all ``copy.existing.*``
   properties. You should use ``startup.mode=copy_existing`` and
   ``startup.mode.copy.existing.*`` properties to configure the copy existing
   feature.
+- Introduced the ``change.stream.full.document.before.change`` setting that
+  allows you to access and configure the pre-image of an update
+  operation in the change stream event document.
 
 .. _kafka-connector-whats-new-1.8.1: