added support for passing the mod Id directly into withModId()

Author: Smef

README.md

@@ -271,14 +271,24 @@ The Data API lets you set a [Modification ID](https://help.claris.com/en/data-ap
 
  > Specifying a modification ID ensures that you are editing the current version of a record. If the modification ID value does not match the current modification ID value in the database, the record is not changed.
 
-If you wish to include the modId when editing a record you can call `withModId()` before calling `save()` on the model object. This will send the ModID to FileMaker when updating the record, and will throw a `FileMakerDataApiException` if the ModId does not match.
+If you wish to include the modId when editing a record you can call `withModId()` before calling `save()` on the model object. This will send the ModID to FileMaker when updating the record, and will throw a `FileMakerDataApiException` with code `306` if the ModId does not match.
 
 ```php
 $person->withModId()->save();
 ```
 
 The modId is automatically set on the model object when you retrieve a record from FileMaker, so you don't need to set it manually.
 
+If you want to set the ModId manually you can do so by either passing the modId into `withModId($myModId)` or calling `setModId($myModId)` on the model object.
+
+
+```php
+
+// set the ModId and flag it submit the modification ID when saving the record
+$person->withModId(12)->save();
+
+```
+
 If you always want the ModId to be included when saving a record, you can set the `$withModId` property to true on your model class.
 
 ```php

src/Database/Eloquent/FMModel.php

@@ -227,11 +227,22 @@ public function setModId($modId): void
 
     /**
      * Include the modification Id when editing a record
+     *
+     * @param  int|string|bool  $includeModId  This can be an integer to set the ModId or a boolean to include it or not
      */
-    public function withModId($include = true): static
+    public function withModId(int|string|bool $includeModId = true): static
     {
+        // check if the parameter is an integer, if not, default to true
+        if (! is_bool($includeModId)) {
+            $modId = $includeModId;
+
+            // set the mod ID and include it
+            $this->setModId($modId);
+            $includeModId = true;
+        }
+
         // remove any set ModId if the user wishes to remove it
-        $this->withModId = $include;
+        $this->withModId = $includeModId;
 
         return $this;
     }