feat!: rename useBodyJSON to useBody and unexposed cached value

Author: pi0

src/utils/body.ts

@@ -2,6 +2,9 @@ import type { IncomingMessage } from 'http'
 import destr from 'destr'
 import type { Encoding } from '../types/node'
 
+const RawBodySymbol = Symbol('h2RawBody')
+const ParsedBodySymbol = Symbol('h2RawBody')
+
 /**
  * Reads body of the request and returns encoded raw string (default) or `Buffer` if encoding if falsy.
  * @param req {IncomingMessage} An IncomingMessage object is created by
@@ -10,11 +13,11 @@ import type { Encoding } from '../types/node'
  *
  * @return {String|Buffer} Encoded raw string or raw Buffer of the body
  */
-export function useBody (req: IncomingMessage, encoding: Encoding = 'utf-8'): Encoding extends false ? Buffer : Promise<string> {
+export function useRawBody (req: IncomingMessage, encoding: Encoding = 'utf-8'): Encoding extends false ? Buffer : Promise<string> {
   // @ts-ignore
-  if (req.rawBody) {
+  if (req[RawBodySymbol]) {
     // @ts-ignore
-    return Promise.resolve(encoding ? req.rawBody.toString(encoding) : req.rawBody)
+    return Promise.resolve(encoding ? req[RawBodySymbol].toString(encoding) : req[RawBodySymbol])
   }
 
   return new Promise<string>((resolve, reject) => {
@@ -24,35 +27,33 @@ export function useBody (req: IncomingMessage, encoding: Encoding = 'utf-8'): En
       .on('data', (chunk) => { bodyData.push(chunk) })
       .on('end', () => {
         // @ts-ignore
-        req.rawBody = Buffer.concat(bodyData)
+        req[RawBodySymbol] = Buffer.concat(bodyData)
         // @ts-ignore
-        resolve(encoding ? req.rawBody.toString(encoding) : req.rawBody)
+        resolve(encoding ? req[RawBodySymbol].toString(encoding) : req[RawBodySymbol])
       })
   })
 }
 
 /**
- * Reads body of the request and returns encoded raw string or `Buffer`.
- * This utility uses {@link https://github.com/nuxt-contrib/destr destr} to parse the body
- *
+ * Reads request body and try to safely parse using {@link https://github.com/nuxt-contrib/destr destr}
  * @param req {IncomingMessage} An IncomingMessage object is created by
  *  <a href="https://nodejs.org/api/http.html#http_class_http_server">http.Server</a>
  * @param encoding {Encoding} encoding="utf-8" - The character encoding to use.
  *
  * @return {*} The Object, Array, string, number, boolean, or null value corresponding to the request JSON body
  */
-export async function useBodyJSON<T> (req: IncomingMessage): Promise<T> {
+export async function useBody<T=any> (req: IncomingMessage): Promise<T> {
   // @ts-ignore
-  if (req.jsonBody) {
+  if (req[ParsedBodySymbol]) {
     // @ts-ignore
-    return req.jsonBody
+    return req[ParsedBodySymbol]
   }
 
   const body = await useBody(req)
   const json = destr(body)
 
   // @ts-ignore
-  req.jsonBody = json
+  req[ParsedBodySymbol] = json
 
   return json
 }