feat(serialize): add generic type and typeGuard parameter to serialize and deserialize

Author: Kit-p

src/serialize.ts

@@ -1,32 +1,37 @@
 import { parse } from './parse.js';
 import { stringify } from './stringify.js';
+import type { TypeGuardFunction } from './types.js';
 
-export function serialize(obj: any) {
+export function serialize<T>(obj: any, typeGuard?: TypeGuardFunction<T>) {
   return parse(
     stringify(obj, {
       extended: { enable: true, relaxed: true },
       compress: { enable: false },
       minify: { enable: false },
     }),
+    null,
     {
       extended: { enable: false },
       decompress: { enable: false },
       unminify: { enable: false },
     },
+    typeGuard,
   );
 }
 
-export function deserialize(obj: any) {
+export function deserialize<T>(obj: any, typeGuard?: TypeGuardFunction<T>) {
   return parse(
     stringify(obj, {
       extended: { enable: false },
       compress: { enable: false },
       minify: { enable: false },
     }),
+    null,
     {
       extended: { enable: true, relaxed: true },
       decompress: { enable: false },
       unminify: { enable: false },
     },
+    typeGuard,
   );
 }

test/serialize.test.ts

@@ -7,7 +7,7 @@ describe('[serialize] serialize', () => {
   };
 
   it('serialize should transform JavaScript object into Extended JSON object', () => {
-    const serializedObj = JsonKit.serialize(obj);
+    const serializedObj = JsonKit.serialize<{ date: unknown }>(obj);
     expect(serializedObj.date).toHaveProperty('$date');
   });
 });
@@ -18,7 +18,7 @@ describe('[serialize] deserialize', () => {
   };
 
   it('deserialize should transform Extended JSON object into JavaScript object', () => {
-    const deserializedObj = JsonKit.deserialize(obj);
+    const deserializedObj = JsonKit.deserialize<{ date: unknown }>(obj);
     expect(deserializedObj.date).toBeInstanceOf(Date);
   });
 });