seroval 0.5.0 → 0.6.0

package/src/tree/sync.ts

@@ -1,14 +1,15 @@
 /* eslint-disable @typescript-eslint/no-use-before-define */
 import assert from '../assert';
 import { Feature } from '../compat';
-import { createRef, ParserContext } from '../context';
-import { BigIntTypedArrayValue, ServerValue, TypedArrayValue } from '../types';
+import { createIndexedValue, getRootID, ParserContext } from '../context';
+import quote from '../quote';
+import { BigIntTypedArrayValue, TypedArrayValue } from '../types';
 import {
   createBigIntNode,
   createBigIntTypedArrayNode,
   createDateNode,
   createNumberNode,
-  createReferenceNode,
+  createIndexedValueNode,
   createRegExpNode,
   createStringNode,
   createTypedArrayNode,
@@ -21,14 +22,18 @@ import {
   NULL_NODE,
   TRUE_NODE,
   UNDEFINED_NODE,
+  createReferenceNode,
 } from './primitives';
+import {
+  hasReferenceID,
+} from './reference';
 import {
   getErrorConstructorName,
   getErrorOptions,
   getIterableOptions,
   isIterable,
 } from './shared';
-import { INV_SYMBOL_REF } from './symbols';
+import { WellKnownSymbols } from './symbols';
 import {
   SerovalAggregateErrorNode,
   SerovalArrayNode,
@@ -42,14 +47,15 @@ import {
   SerovalObjectRecordNode,
   SerovalSetNode,
 } from './types';
+import { createURLNode, createURLSearchParamsNode } from './web-api';
 
 type ObjectLikeNode = SerovalObjectNode | SerovalNullConstructorNode | SerovalIterableNode;
 
-function generateNodeList(ctx: ParserContext, current: ServerValue[]) {
+function generateNodeList(ctx: ParserContext, current: unknown[]) {
   const size = current.length;
   const nodes = new Array<SerovalNode>(size);
-  const deferred = new Array<ServerValue>(size);
-  let item: ServerValue;
+  const deferred = new Array<unknown>(size);
+  let item: unknown;
   for (let i = 0; i < size; i++) {
     if (i in current) {
       item = current[i];
@@ -71,7 +77,7 @@ function generateNodeList(ctx: ParserContext, current: ServerValue[]) {
 function generateArrayNode(
   ctx: ParserContext,
   id: number,
-  current: ServerValue[],
+  current: unknown[],
 ): SerovalArrayNode {
   return {
     t: SerovalNodeType.Array,
@@ -82,21 +88,21 @@ function generateArrayNode(
     m: undefined,
     d: undefined,
     a: generateNodeList(ctx, current),
-    n: undefined,
+    f: undefined,
   };
 }
 
 function generateMapNode(
   ctx: ParserContext,
   id: number,
-  current: Map<ServerValue, ServerValue>,
+  current: Map<unknown, unknown>,
 ): SerovalMapNode {
   assert(ctx.features & Feature.Map, 'Unsupported type "Map"');
   const len = current.size;
   const keyNodes = new Array<SerovalNode>(len);
   const valueNodes = new Array<SerovalNode>(len);
-  const deferredKey = new Array<ServerValue>(len);
-  const deferredValue = new Array<ServerValue>(len);
+  const deferredKey = new Array<unknown>(len);
+  const deferredValue = new Array<unknown>(len);
   let deferredSize = 0;
   let nodeSize = 0;
   for (const [key, value] of current.entries()) {
@@ -124,19 +130,19 @@ function generateMapNode(
     m: undefined,
     d: { k: keyNodes, v: valueNodes, s: len },
     a: undefined,
-    n: undefined,
+    f: undefined,
   };
 }
 
 function generateSetNode(
   ctx: ParserContext,
   id: number,
-  current: Set<ServerValue>,
+  current: Set<unknown>,
 ): SerovalSetNode {
   assert(ctx.features & Feature.Set, 'Unsupported type "Set"');
   const len = current.size;
   const nodes = new Array<SerovalNode>(len);
-  const deferred = new Array<ServerValue>(len);
+  const deferred = new Array<unknown>(len);
   let deferredSize = 0;
   let nodeSize = 0;
   for (const item of current.keys()) {
@@ -160,23 +166,23 @@ function generateSetNode(
     m: undefined,
     d: undefined,
     a: nodes,
-    n: undefined,
+    f: undefined,
   };
 }
 
 function generateProperties(
   ctx: ParserContext,
-  properties: Record<string, ServerValue>,
+  properties: Record<string, unknown>,
 ): SerovalObjectRecordNode {
   const keys = Object.keys(properties);
   const size = keys.length;
   const keyNodes = new Array<string>(size);
   const valueNodes = new Array<SerovalNode>(size);
   const deferredKeys = new Array<string>(size);
-  const deferredValues = new Array<ServerValue>(size);
+  const deferredValues = new Array<unknown>(size);
   let deferredSize = 0;
   let nodesSize = 0;
-  let item: ServerValue;
+  let item: unknown;
   for (const key of keys) {
     item = properties[key];
     if (isIterable(item)) {
@@ -203,7 +209,7 @@ function generateProperties(
 function generateIterableNode(
   ctx: ParserContext,
   id: number,
-  current: Iterable<ServerValue>,
+  current: Iterable<unknown>,
 ): SerovalIterableNode {
   assert(ctx.features & Feature.Symbol, 'Unsupported type "Iterable"');
   const options = getIterableOptions(current);
@@ -217,17 +223,17 @@ function generateIterableNode(
     m: undefined,
     // Parse options first before the items
     d: options
-      ? generateProperties(ctx, options as Record<string, ServerValue>)
+      ? generateProperties(ctx, options)
       : undefined,
     a: generateNodeList(ctx, array),
-    n: undefined,
+    f: undefined,
   };
 }
 
 function generateObjectNode(
   ctx: ParserContext,
   id: number,
-  current: Record<string, ServerValue> | Iterable<ServerValue>,
+  current: Record<string, unknown> | Iterable<unknown>,
   empty: boolean,
 ): ObjectLikeNode {
   if (Symbol.iterator in current) {
@@ -242,7 +248,7 @@ function generateObjectNode(
     m: undefined,
     d: generateProperties(ctx, current),
     a: undefined,
-    n: undefined,
+    f: undefined,
   };
 }
 
@@ -261,10 +267,10 @@ function generateAggregateErrorNode(
     s: undefined,
     l: current.errors.length,
     c: undefined,
-    m: current.message,
+    m: quote(current.message),
     d: optionsNode,
-    a: generateNodeList(ctx, current.errors as ServerValue[]),
-    n: undefined,
+    a: generateNodeList(ctx, current.errors as unknown[]),
+    f: undefined,
   };
 }
 
@@ -283,16 +289,16 @@ function generateErrorNode(
     s: undefined,
     l: undefined,
     c: getErrorConstructorName(current),
-    m: current.message,
+    m: quote(current.message),
     d: optionsNode,
     a: undefined,
-    n: undefined,
+    f: undefined,
   };
 }
 
-function parse(
+function parse<T>(
   ctx: ParserContext,
-  current: ServerValue,
+  current: T,
 ): SerovalNode {
   switch (typeof current) {
     case 'boolean':
@@ -302,20 +308,19 @@ function parse(
     case 'string':
       return createStringNode(current);
     case 'number':
-      // eslint-disable-next-line no-self-compare
-      if (current !== current) {
-        return NAN_NODE;
-      }
-      if (Object.is(current, -0)) {
-        return NEG_ZERO_NODE;
-      }
-      if (Object.is(current, Infinity)) {
-        return INFINITY_NODE;
-      }
-      if (Object.is(current, -Infinity)) {
-        return NEG_INFINITY_NODE;
+      switch (current) {
+        case Infinity: return INFINITY_NODE;
+        case -Infinity: return NEG_INFINITY_NODE;
+        default:
+          // eslint-disable-next-line no-self-compare
+          if (current !== current) {
+            return NAN_NODE;
+          }
+          if (Object.is(current, -0)) {
+            return NEG_ZERO_NODE;
+          }
+          return createNumberNode(current);
       }
-      return createNumberNode(current);
     case 'bigint':
       return createBigIntNode(ctx, current);
     case 'object': {
@@ -324,18 +329,21 @@ function parse(
       }
       // Non-primitive values needs a reference ID
       // mostly because the values themselves are stateful
-      const id = createRef(ctx, current, true);
+      const id = createIndexedValue(ctx, current);
       if (ctx.markedRefs.has(id)) {
-        return createReferenceNode(id);
+        return createIndexedValueNode(id);
+      }
+      if (hasReferenceID(current)) {
+        return createReferenceNode(id, current);
       }
       if (Array.isArray(current)) {
         return generateArrayNode(ctx, id, current);
       }
       switch (current.constructor) {
         case Date:
-          return createDateNode(id, current as Date);
+          return createDateNode(id, current as unknown as Date);
         case RegExp:
-          return createRegExpNode(id, current as RegExp);
+          return createRegExpNode(id, current as unknown as RegExp);
         case Int8Array:
         case Int16Array:
         case Int32Array:
@@ -345,23 +353,33 @@ function parse(
         case Uint8ClampedArray:
         case Float32Array:
         case Float64Array:
-          return createTypedArrayNode(ctx, id, current as TypedArrayValue);
+          return createTypedArrayNode(ctx, id, current as unknown as TypedArrayValue);
         case BigInt64Array:
         case BigUint64Array:
-          return createBigIntTypedArrayNode(ctx, id, current as BigIntTypedArrayValue);
+          return createBigIntTypedArrayNode(ctx, id, current as unknown as BigIntTypedArrayValue);
         case Map:
-          return generateMapNode(ctx, id, current as Map<ServerValue, ServerValue>);
+          return generateMapNode(ctx, id, current as unknown as Map<unknown, unknown>);
         case Set:
-          return generateSetNode(ctx, id, current as Set<ServerValue>);
+          return generateSetNode(ctx, id, current as unknown as Set<unknown>);
         case Object:
-          return generateObjectNode(ctx, id, current as Record<string, ServerValue>, false);
+          return generateObjectNode(
+            ctx,
+            id,
+            current as unknown as Record<string, unknown>,
+            false,
+          );
         case undefined:
-          return generateObjectNode(ctx, id, current as Record<string, ServerValue>, true);
+          return generateObjectNode(
+            ctx,
+            id,
+            current as unknown as Record<string, unknown>,
+            true,
+          );
         case AggregateError:
           if (ctx.features & Feature.AggregateError) {
-            return generateAggregateErrorNode(ctx, id, current as AggregateError);
+            return generateAggregateErrorNode(ctx, id, current as unknown as AggregateError);
           }
-          return generateErrorNode(ctx, id, current as AggregateError);
+          return generateErrorNode(ctx, id, current as unknown as AggregateError);
         case Error:
         case EvalError:
         case RangeError:
@@ -369,37 +387,57 @@ function parse(
         case SyntaxError:
         case TypeError:
         case URIError:
-          return generateErrorNode(ctx, id, current as Error);
+          return generateErrorNode(ctx, id, current as unknown as Error);
+        case URL:
+          return createURLNode(ctx, id, current as unknown as URL);
+        case URLSearchParams:
+          return createURLSearchParamsNode(ctx, id, current as unknown as URLSearchParams);
         default:
           break;
       }
-      if (current instanceof AggregateError && ctx.features & Feature.AggregateError) {
-        return generateAggregateErrorNode(ctx, id, current);
+      if (current instanceof AggregateError) {
+        if (ctx.features & Feature.AggregateError) {
+          return generateAggregateErrorNode(ctx, id, current);
+        }
+        return generateErrorNode(ctx, id, current);
       }
       if (current instanceof Error) {
         return generateErrorNode(ctx, id, current);
       }
       // Generator functions don't have a global constructor
       if (Symbol.iterator in current) {
-        return generateIterableNode(ctx, id, current);
+        return generateIterableNode(ctx, id, current as Iterable<unknown>);
       }
       throw new Error('Unsupported type');
     }
     case 'symbol':
-      assert(ctx.features & Feature.Symbol, 'Unsupported type "symbol"');
-      assert(current in INV_SYMBOL_REF, 'seroval only supports well-known symbols');
-      return createWKSymbolNode(current);
+      if (hasReferenceID(current)) {
+        const id = createIndexedValue(ctx, current);
+        if (ctx.markedRefs.has(id)) {
+          return createIndexedValueNode(id);
+        }
+        return createReferenceNode(id, current);
+      }
+      return createWKSymbolNode(ctx, current as WellKnownSymbols);
+    case 'function': {
+      assert(hasReferenceID(current), 'Cannot serialize function without reference ID.');
+      const id = createIndexedValue(ctx, current);
+      if (ctx.markedRefs.has(id)) {
+        return createIndexedValueNode(id);
+      }
+      return createReferenceNode(id, current);
+    }
     default:
       throw new Error('Unsupported type');
   }
 }
 
-export default function parseSync(
+export default function parseSync<T>(
   ctx: ParserContext,
-  current: ServerValue,
+  current: T,
 ) {
   const result = parse(ctx, current);
   const isObject = result.t === SerovalNodeType.Object
     || result.t === SerovalNodeType.Iterable;
-  return [result, createRef(ctx, current, false), isObject] as const;
+  return [result, getRootID(ctx, current), isObject] as const;
 }

package/src/tree/types.ts

@@ -11,7 +11,7 @@ export const enum SerovalNodeType {
   NegativeInfinity,
   NaN,
   BigInt,
-  Reference,
+  IndexedValue,
   Date,
   RegExp,
   Set,
@@ -26,6 +26,9 @@ export const enum SerovalNodeType {
   TypedArray,
   BigIntTypedArray,
   WKSymbol,
+  URL,
+  URLSearchParams,
+  Reference,
 }
 
 export interface SerovalBaseNode {
@@ -45,8 +48,8 @@ export interface SerovalBaseNode {
   d: SerovalDictionaryNode | undefined;
   // array of nodes
   a: SerovalNode[] | undefined;
-  // next node
-  n: SerovalNode | undefined;
+  // fulfilled node
+  f: SerovalNode | undefined;
 }
 
 export interface SerovalObjectRecordNode {
@@ -115,8 +118,8 @@ export type SerovalPrimitiveNode =
   | SerovalInfinityNode
   | SerovalNaNNode;
 
-export interface SerovalReferenceNode extends SerovalBaseNode {
-  t: SerovalNodeType.Reference;
+export interface SerovalIndexedValueNode extends SerovalBaseNode {
+  t: SerovalNodeType.IndexedValue;
   i: number;
 }
 
@@ -197,7 +200,7 @@ export interface SerovalNullConstructorNode extends SerovalBaseNode {
 
 export interface SerovalPromiseNode extends SerovalBaseNode {
   t: SerovalNodeType.Promise;
-  n: SerovalNode;
+  f: SerovalNode;
   i: number;
 }
 
@@ -231,9 +234,27 @@ export interface SerovalWKSymbolNode extends SerovalBaseNode {
   s: Symbols;
 }
 
+export interface SerovalURLNode extends SerovalBaseNode {
+  t: SerovalNodeType.URL;
+  i: number;
+  s: string;
+}
+
+export interface SerovalURLSearchParamsNode extends SerovalBaseNode {
+  t: SerovalNodeType.URLSearchParams;
+  i: number;
+  s: string;
+}
+
+export interface SerovalReferenceNode extends SerovalBaseNode {
+  t: SerovalNodeType.Reference;
+  i: number;
+  s: string;
+}
+
 export type SerovalNode =
   | SerovalPrimitiveNode
-  | SerovalReferenceNode
+  | SerovalIndexedValueNode
   | SerovalSemiPrimitiveNode
   | SerovalSetNode
   | SerovalMapNode
@@ -244,4 +265,7 @@ export type SerovalNode =
   | SerovalErrorNode
   | SerovalAggregateErrorNode
   | SerovalIterableNode
-  | SerovalWKSymbolNode;
+  | SerovalWKSymbolNode
+  | SerovalURLNode
+  | SerovalURLSearchParamsNode
+  | SerovalReferenceNode;

package/src/tree/web-api.ts

@@ -0,0 +1,42 @@
+import assert from '../assert';
+import { Feature } from '../compat';
+import { ParserContext } from '../context';
+import { SerovalNodeType, SerovalURLNode, SerovalURLSearchParamsNode } from './types';
+
+export function createURLNode(
+  ctx: ParserContext,
+  id: number,
+  current: URL,
+): SerovalURLNode {
+  assert(ctx.features & Feature.WebAPI, 'Unsupported type "URL"');
+  return {
+    t: SerovalNodeType.URL,
+    i: id,
+    s: current.href,
+    l: undefined,
+    c: undefined,
+    m: undefined,
+    d: undefined,
+    f: undefined,
+    a: undefined,
+  };
+}
+
+export function createURLSearchParamsNode(
+  ctx: ParserContext,
+  id: number,
+  current: URLSearchParams,
+): SerovalURLSearchParamsNode {
+  assert(ctx.features & Feature.WebAPI, 'Unsupported type "URLSearchParams"');
+  return {
+    t: SerovalNodeType.URLSearchParams,
+    i: id,
+    s: current.toString(),
+    l: undefined,
+    c: undefined,
+    m: undefined,
+    d: undefined,
+    f: undefined,
+    a: undefined,
+  };
+}

package/src/types.ts

@@ -34,12 +34,17 @@ export type BigIntTypedArrayValue =
   | BigInt64Array
   | BigUint64Array;
 
+export type WebAPIValue =
+  | URL
+  | URLSearchParams;
+
 export type SemiPrimitiveValue =
   | RegExp
   | Date
   | TypedArrayValue
   | BigIntTypedArrayValue
-  | bigint;
+  | bigint
+  | WebAPIValue;
 
 export type CommonServerValue =
   | PrimitiveValue