feat(model): add support to configuration at query builder

docs/content/en/api/query-builder-methods.md

@@ -160,6 +160,22 @@ Build custom endpoints.
   </code-block>
 </code-group>
 
+## `config`
+<alert type="success">Available in version >= v1.8.0</alert>
+
+- Arguments: `(config)`
+- Returns: `self`
+
+Configuration of HTTP Instance.
+
+```js
+await Model.config({
+  method: 'PATCH',
+  header: { /* ... */ },
+  data: { foo: 'bar' }
+}).save()
+```
+
 ## `get`
 - Returns: `Collection | { data: Collection }`
 

docs/content/en/building-the-query.md

@@ -560,6 +560,21 @@ We can build a resource to get the latest `Posts` that belongs to a **User**:
   </code-block>
 </code-group>
 
+## Configuring the Request
+
+<alert type="success">Available in version >= v1.8.0</alert>
+
+See the [API reference](/api/query-builder-methods#config)
+
+The `config` method can be used to configure the current request at query builder. We can pass any config available 
+from the HTTP Instance. If we are using [Axios](https://github.com/axios/axios), 
+we should pass an [AxiosRequestConfig](https://github.com/axios/axios#request-config).
+
+We can add headers, change the method, anything we want:
+
+```js
+await Post.config({ headers: { /*...*/ } }).get()
+```
 
 ## Needless Parent Request
 
@@ -586,8 +601,10 @@ We can get a list of **Posts** that belongs to an **User**:
   </code-block>
 </code-group>
 
-And the same thing using for the example above, if we want to define a dynamic resource, 
-we can create a new **User** instance with the ID:
+And the same thing can be done if we want to define a 
+[dynamic resource](/building-the-query#defining-a-dynamic-resource).
+
+We can create a new **User** instance with the ID:
 
 <code-group>
   <code-block label="Query" active>

docs/content/en/performing-operations.md

@@ -91,6 +91,38 @@ Then we can update our newly created **Post**:
   </code-block>
 </code-group>
 
+And if we want to use `PATCH`, we can easily do that using [config](/api/query-builder-methods#config).
+
+<code-group>
+  <code-block Label="Query" active>
+
+  ```js
+  const post = await Post.find(1)
+
+  post.text = 'An updated text for our Post!'
+
+  await post.config({ method: 'PATCH' }).save()
+  ```
+
+  </code-block>
+  <code-block Label="Find Request">
+
+  ```http request
+  GET /posts/1
+  ```
+
+  </code-block>
+  <code-block Label="Save Request">
+
+  ```http request
+  PATCH /posts/1
+  ```
+
+  </code-block>
+</code-group>
+
+<alert type="info">You can safely use `PATCH` with `save()`. The `POST` method will not be overridden, only `PUT`.</alert>
+
 ### Deleting a Model
 
 See the [API reference](/api/crud-operations#delete).

src/Model.js

@@ -36,6 +36,11 @@ export default class Model extends StaticModel {
     return Model.$http
   }
 
+  config(config) {
+    this._config = config
+    return this
+  }
+
   resource() {
     return `${this.constructor.name.toLowerCase()}s`
   }
@@ -277,6 +282,25 @@ export default class Model extends StaticModel {
     }
   }
 
+  _reqConfig(config, options = { forceMethod: false }) {
+    const _config = { ...config, ...this._config }
+
+    if (options.forceMethod) {
+      _config.method = config.method
+    }
+
+    // Check if config has data
+    if ('data' in _config) {
+      // Ditch private data
+      _config.data = Object.fromEntries(
+        Object.entries(_config.data)
+          .filter(([key]) => !key.startsWith('_'))
+      )
+    }
+
+    return _config
+  }
+
   first() {
     return this.get().then(response => {
       let item
@@ -304,10 +328,12 @@ export default class Model extends StaticModel {
     let base = this._fromResource || `${this.baseURL()}/${this.resource()}`
     let url = `${base}/${identifier}${this._builder.query()}`
 
-    return this.request({
-      url,
-      method: 'GET'
-    }).then(response => {
+    return this.request(
+      this._reqConfig({
+        url,
+        method: 'GET'
+      })
+    ).then(response => {
       return this._applyInstance(response.data)
     })
   }
@@ -327,10 +353,12 @@ export default class Model extends StaticModel {
     base = this._customResource ? `${this.baseURL()}/${this._customResource}` : base
     let url = `${base}${this._builder.query()}`
 
-    return this.request({
-      url,
-      method: 'GET'
-    }).then(response => {
+    return this.request(
+      this._reqConfig({
+        url,
+        method: 'GET'
+      })
+    ).then(response => {
       let collection = this._applyInstanceCollection(response.data)
 
       if (response.data.data !== undefined) {
@@ -358,32 +386,38 @@ export default class Model extends StaticModel {
       throw new Error('This model has a empty ID.')
     }
 
-    return this.request({
-      url: this.endpoint(),
-      method: 'DELETE'
-    }).then(response => response)
+    return this.request(
+      this._reqConfig({
+        method: 'DELETE',
+        url: this.endpoint()
+      })
+    ).then(response => response)
   }
 
   save() {
     return this.hasId() ? this._update() : this._create()
   }
 
   _create() {
-    return this.request({
-      method: 'POST',
-      url: this.endpoint(),
-      data: this
-    }).then(response => {
+    return this.request(
+      this._reqConfig({
+        method: 'POST',
+        url: this.endpoint(),
+        data: this
+      }, { forceMethod: true })
+    ).then(response => {
       return this._applyInstance(response.data.data || response.data)
     })
   }
 
   _update() {
-    return this.request({
-      method: 'PUT',
-      url: this.endpoint(),
-      data: this
-    }).then(response => {
+    return this.request(
+      this._reqConfig({
+        method: 'PUT',
+        url: this.endpoint(),
+        data: this
+      })
+    ).then(response => {
       return this._applyInstance(response.data.data || response.data)
     })
   }
@@ -393,18 +427,22 @@ export default class Model extends StaticModel {
    */
 
   attach(params) {
-    return this.request({
-      method: 'POST',
-      url: this.endpoint(),
-      data: params
-    }).then(response => response)
+    return this.request(
+      this._reqConfig({
+        method: 'POST',
+        url: this.endpoint(),
+        data: params
+      })
+    ).then(response => response)
   }
 
   sync(params) {
-    return this.request({
-      method: 'PUT',
-      url: this.endpoint(),
-      data: params
-    }).then(response => response)
+    return this.request(
+      this._reqConfig({
+        method: 'PUT',
+        url: this.endpoint(),
+        data: params
+      })
+    ).then(response => response)
   }
 }

tests/model.test.js

@@ -383,6 +383,69 @@ describe('Model methods', () => {
     comment.save()
   })
 
+  test('save() method makes a PATCH request when method is set using `config`', async () => {
+    let post
+
+    axiosMock.onAny().reply((config) => {
+      const _post = post
+      delete _post._config
+
+      expect(config.method).toEqual('patch')
+      expect(config.data).toEqual(JSON.stringify(_post))
+      expect(config.url).toEqual('http://localhost/posts/1')
+
+      return [200, {}]
+    })
+
+    post = new Post({ id: 1, title: 'Cool!' })
+    await post.config({ method: 'PATCH' }).save()
+  })
+
+  test('save() method makes a POST request even when `config` set to PATCH', async () => {
+    let post
+    const _postResponse = {
+      id: 1,
+      title: 'Cool!',
+      text: 'Lorem Ipsum Dolor',
+      user: {
+        firstname: 'John',
+        lastname: 'Doe',
+        age: 25
+      },
+      relationships: {
+        tags: [
+          {
+            name: 'super'
+          },
+          {
+            name: 'awesome'
+          }
+        ]
+      }
+    }
+
+    axiosMock.onAny().reply((config) => {
+      const _post = post
+      delete _post._config
+
+      expect(config.method).toEqual('post')
+      expect(config.data).toEqual(JSON.stringify(_post))
+      expect(config.url).toEqual('http://localhost/posts')
+
+      return [200, _postResponse]
+    })
+
+    post = new Post({ title: 'Cool!' })
+    post = await post.config({ method: 'PATCH' }).save()
+
+    expect(post).toEqual(_postResponse)
+    expect(post).toBeInstanceOf(Post)
+    expect(post.user).toBeInstanceOf(User)
+    post.relationships.tags.forEach(tag => {
+      expect(tag).toBeInstanceOf(Tag)
+    })
+  })
+
   test('save() method makes a POST request when ID of object is null', async () => {
     let post