feat!: update rpc and openapi serializer (#171)

* feat!: update rpc and openapi serializer

* fix types

* update bracket notation

* update bracket notation

Author: dinwwwh

apps/content/docs/advanced/rpc-protocol.md

@@ -5,11 +5,51 @@ description: Learn about the RPC protocol used by RPCHandler.
 
 # RPC Protocol
 
-The RPC protocol enables remote procedure calls over HTTP using JSON, supporting native data types. It is utilized by [RPCHandler](/docs/rpc-handler).
+The RPC protocol enables remote procedure calls over HTTP using JSON, supporting native data types. It is used by [RPCHandler](/docs/rpc-handler).
 
-## Request
+## Routing
 
-### Example using POST
+The procedure to call is determined by the `pathname`.
+
+```bash
+curl https://example.com/rpc/planet/create
+```
+
+This example calls the `planet.create` procedure, with `/rpc` as the prefix.
+
+```ts
+const router = {
+  planet: {
+    create: os.handler(() => {}) // [!code highlight]
+  }
+}
+```
+
+## Input
+
+Any HTTP method can be used. Input can be provided via URL query parameters or the request body.
+
+### Input in URL Query
+
+```ts
+const url = new URL('https://example.com/rpc/planet/create')
+
+url.searchParams.append('data', JSON.stringify({
+  json: {
+    name: 'Earth',
+    detached_at: '2022-01-01T00:00:00.000Z'
+  },
+  meta: [[1, ['detached_at']]]
+}))
+
+const response = await fetch(url)
+```
+
+::: info
+The payload can be empty (`undefined`).
+:::
+
+### Input in Request Body
 
 ```bash
 curl -X POST https://example.com/rpc/planet/create \
@@ -19,13 +59,41 @@ curl -X POST https://example.com/rpc/planet/create \
       "name": "Earth",
       "detached_at": "2022-01-01T00:00:00.000Z"
     },
-    "meta": [
-      ["detached_at", "date"]
-    ]
+    "meta": [[1, ["detached_at"]]]
   }'
 ```
 
-This request targets the `create` procedure within the `planet` module. The JSON payload includes `name` and `detached_at`, where `detached_at` is flagged as a date and will be converted to a Date object upon deserialization.
+::: info
+The payload can be empty (`undefined`).
+:::
+
+### Input with File
+
+```ts
+const form = new FormData()
+
+form.set('data', JSON.stringify({
+  json: {
+    name: 'Earth',
+    thumbnail: {},
+    images: [{}, {}]
+  },
+  meta: [[1, ['detached_at']]],
+  maps: [['images', 0], ['images', 1]]
+}))
+
+form.set('0', new Blob([''], { type: 'image/png' }))
+form.set('1', new Blob([''], { type: 'image/png' }))
+
+const response = await fetch('https://example.com/rpc/planet/create', {
+  method: 'POST',
+  body: form
+})
+```
+
+::: info
+The input can be empty (`undefined`) or binary data (`blob/file`).
+:::
 
 ## Success Response
 
@@ -39,19 +107,20 @@ Content-Type: application/json
     "name": "Earth",
     "detached_at": "2022-01-01T00:00:00.000Z"
   },
-  "meta": [
-    ["id", "bigint"],
-    ["detached_at", "date"]
-  ]
+  "meta": [[0, ["id"]], [1, ["detached_at"]]]
 }
 ```
 
-A success response has an HTTP status code between 200 and 299 and returns the procedure's output.
+A success response has an HTTP status code between `200-299` and returns the procedure's output.
+
+::: info
+The payload can be empty (`undefined`) or binary data (`blob/file`).
+:::
 
 ## Error Response
 
 ```http
-HTTP/1.1 400 Bad Request
+HTTP/1.1 500 Internal Server Error
 Content-Type: application/json
 
 {
@@ -66,64 +135,28 @@ Content-Type: application/json
 }
 ```
 
-An error response uses an HTTP status code between 400 and 599 and returns an `ORPCError` object.
+An error response has an HTTP status code between `400-599` and returns an `ORPCError` object.
 
-## Request Methods
+## Meta
 
-Although the examples above use the `POST` method, the RPC protocol is method-agnostic. You can use any HTTP method. For example, here’s how to use a `GET` request with input in the URL:
-
-```ts
-const url = new URL('https://example.com/rpc/planet/create')
+The `meta` field describes native data in the format `[type: number, path: (string | number)[]]`.
 
-url.searchParams.append('data', JSON.stringify({
-  json: {
-    name: 'Earth',
-    detached_at: '2022-01-01T00:00:00.000Z'
-  },
-  meta: [
-    ['detached_at', 'date']
-  ]
-}))
+- **type**: Data type (see [Supported Types](#supported-types)).
+- **path**: Path to the data inside `json`.
 
-const response = await fetch(url)
-```
+### Supported Types
 
-## File Upload/Download
+| Type | Description |
+| ---- | ----------- |
+| 0    | bigint      |
+| 1    | date        |
+| 2    | nan         |
+| 3    | undefined   |
+| 4    | url         |
+| 5    | regexp      |
+| 6    | set         |
+| 7    | map         |
 
-When the payload includes files or blobs, it is sent as a `FormData` object with `data` and `maps` fields. In the `data` object, file placeholders appear as empty objects `{}`. The `maps` array maps file keys in the `FormData` to their corresponding paths in the `data` object.
+## Maps
 
-```ts
-const form = new FormData()
-
-form.set('data', JSON.stringify({
-  json: {
-    name: 'Earth',
-    detached_at: '2022-01-01T00:00:00.000Z',
-    thumbnail: {},
-    images: [{}, {}]
-  },
-  meta: [
-    ['detached_at', 'date']
-  ]
-}))
-
-form.set('maps', JSON.stringify([
-  ['json', 'thumbnail'],
-  ['json', 'images', '0'],
-  ['json', 'images', '1']
-]))
-
-form.set('0', new Blob([''], { type: 'image/png' }))
-form.set('1', new Blob([''], { type: 'image/png' }))
-
-const response = await fetch('https://example.com/rpc/planet/create', {
-  method: 'POST',
-  body: form
-})
-```
-
-## Details
-
-:::info
-TODO
-:::
+The `maps` field is used with `FormData` to map a file or blob to a specific path in `json`.

apps/content/docs/openapi/bracket-notation.md

@@ -9,8 +9,8 @@ Bracket Notation encodes structured data in formats with limited syntax, like UR
 
 ## Usage
 
-- Append `[]` to denote an array.
-- Append `[number]` to specify an array index (missing indexes are filled with `null`).
+- Append `[]` **at the end** to denote an array.
+- Append `[number]` to specify an array index (missing indexes create sparse arrays).
 - Append `[key]` to denote an object property.
 
 ## Limitations