chore: 📝 update readme

Author: Chantouch Sek

README.md

@@ -291,12 +291,43 @@ this.data = data
 ```
 **Note**: Query object above will transform into query string like:
 
-```js
+```text
 https://my-web-url.com?search[first_name]=Sek&search[last_name]=Chantouch&page[limit]=10&page[offset]=1&order[first_name]=asc&order[last_name]=desc&category_id=6
 ```
 
 if setParameter that value is empty or null it will remove that param for query string
 
+#### setParameter()
+
+#### Example 1
+```js
+const proxy = new ExampleProxy()
+const { data } = await proxy.setParameter('page', 1).all()
+this.data = data
+```
+Expected will be:
+```json
+{ "page": 1 }
+```
+
+#### Example 2
+```js
+const proxy = new ExampleProxy()
+const queryString = 'limit=10&page=1&search[name]=hello'
+const { data } = await proxy.setParameter(queryString).all()
+this.data = data
+```
+Expected will be:
+```json
+{
+  "limit": 10,
+  "page": 1,
+  "search": {
+    "name": "hello"
+  }
+}
+```
+
 Be sure to use only once in `mounted()` or `asyncData()` and `asyncData()` is only available in `NuxtJs`
 
 ## Use proxy in components

src/__tests__/base-proxy.test.ts

@@ -109,11 +109,21 @@ describe('BaseProxy', () => {
       pc: null,
     })
     const items = [user2, { first_name: 'Chantouch', last_name: 'Sek', id: 2 }]
-    mockAdapter.onGet('/posts?id=1&first_name=Dara').reply(200, { data: items })
+    mockAdapter
+      .onGet('/posts?id=1&last_name=Hok&search[name]=hello&first_name=Dara')
+      .reply(200, { data: items })
     const { data } = await proxy
-      .setParameter('id=1')
+      .setParameter('id=1&last_name=Hok&search[name]=hello')
       .setParameters({ first_name: 'Dara' })
       .all()
+    expect(proxy.parameters).toEqual({
+      id: '1',
+      first_name: 'Dara',
+      last_name: 'Hok',
+      search: {
+        name: 'hello',
+      },
+    })
     expect(data).toEqual(items)
   })
   it('it should be able to remove parameter(s)', async () => {

src/core/BaseProxy.ts

@@ -3,7 +3,7 @@ import { isArray, isFile } from '../util/objects'
 import type { Errors } from '..'
 import Validator from './Validator'
 import { objectToFormData } from '../util/formData'
-import qs from 'qs'
+import qs, { ParsedQs } from 'qs'
 
 const validator = Validator
 const UNPROCESSABLE_ENTITY = 422
@@ -105,16 +105,6 @@ class BaseProxy {
     return query ? `${url}?${query}` : url
   }
 
-  __getQueryString(parameter: string): any | any[] {
-    const queries: string[] = parameter.split('&')
-    const obj: any = {}
-    queries.forEach(function (property: string) {
-      const [key = null, value = null]: string[] = property.split('=')
-      obj[key] = value
-    })
-    return obj
-  }
-
   __validateRequestType(requestType: Method): void {
     const requestTypes: Array<string> = [
       'get',
@@ -182,11 +172,13 @@ class BaseProxy {
 
   setParameter(parameter: string, value?: any): this {
     if (!value) {
-      const params = this.__getQueryString(parameter)
-      Object.entries(params).forEach(
-        ([key, value]) => (this.parameters[key] = value),
-      )
-      return this
+      const options = {
+        comma: true,
+        allowDots: true,
+        ignoreQueryPrefix: true,
+      }
+      const params: ParsedQs = qs.parse(parameter, options)
+      return this.setParameters(params)
     }
     this.parameters[parameter] = value
     return this