seroval 0.11.6 → 0.12.0

package/src/core/cross/async.ts

@@ -1,754 +1,9 @@
-/* eslint-disable no-await-in-loop */
-/* eslint-disable @typescript-eslint/no-use-before-define */
-import { BIGINT_FLAG, Feature } from '../compat';
-import type { CrossParserContext } from './context';
-import {
-  createCrossIndexedValue,
-} from './context';
-import { serializeString } from '../string';
-import type {
-  BigIntTypedArrayValue,
-  TypedArrayValue,
-} from '../../types';
-import UnsupportedTypeError from '../UnsupportedTypeError';
-import {
-  TRUE_NODE,
-  FALSE_NODE,
-  UNDEFINED_NODE,
-  NULL_NODE,
-} from '../literals';
-import {
-  createBigIntTypedArrayNode,
-  createTypedArrayNode,
-  createDataViewNode,
-  createSymbolNode,
-  createFunctionNode,
-  serializeArrayBuffer,
-} from './primitives';
-import { hasReferenceID } from '../reference';
-import {
-  getErrorConstructorName,
-  getErrorOptions,
-  getObjectFlag,
-  isIterable,
-} from '../shared';
-import type {
-  SerovalAggregateErrorNode,
-  SerovalArrayNode,
-  SerovalBoxedNode,
-  SerovalCustomEventNode,
-  SerovalErrorNode,
-  SerovalEventNode,
-  SerovalFormDataNode,
-  SerovalHeadersNode,
-  SerovalMapNode,
-  SerovalNode,
-  SerovalNullConstructorNode,
-  SerovalObjectNode,
-  SerovalObjectRecordKey,
-  SerovalObjectRecordNode,
-  SerovalPlainRecordNode,
-  SerovalPromiseNode,
-  SerovalRequestNode,
-  SerovalResponseNode,
-  SerovalSetNode,
-} from '../types';
-import {
-  SerovalObjectRecordSpecialKey,
-} from '../types';
-import {
-  createBlobNode,
-  createFileNode,
-} from './web-api';
-import { SerovalNodeType } from '../constants';
-import {
-  createArrayBufferNode,
-  createBigIntNode,
-  createDateNode,
-  createIndexedValueNode,
-  createNumberNode,
-  createReferenceNode,
-  createRegExpNode,
-  createStringNode,
-} from '../base-primitives';
-import { createDOMExceptionNode, createURLNode, createURLSearchParamsNode } from '../web-api';
-import promiseToResult from '../promise-to-result';
-import {
-  createCustomEventOptions,
-  createEventOptions,
-  createRequestOptions,
-  createResponseOptions,
-} from '../constructors';
+import BaseAsyncParserContext from '../base/async';
+import type { CrossParserContextOptions } from './cross-parser';
+import type { SerovalMode } from '../plugin';
 
-type ObjectLikeNode =
-  | SerovalObjectNode
-  | SerovalNullConstructorNode
-  | SerovalPromiseNode;
+export type CrossAsyncParserContextOptions = CrossParserContextOptions
 
-async function generateNodeList(
-  ctx: CrossParserContext,
-  current: unknown[],
-): Promise<SerovalNode[]> {
-  const size = current.length;
-  const nodes = new Array<SerovalNode>(size);
-  const deferred = new Array<unknown>(size);
-  let item: unknown;
-  for (let i = 0; i < size; i++) {
-    if (i in current) {
-      item = current[i];
-      if (isIterable(ctx, item)) {
-        deferred[i] = item;
-      } else {
-        nodes[i] = await crossParseAsync(ctx, item);
-      }
-    }
-  }
-  for (let i = 0; i < size; i++) {
-    if (i in deferred) {
-      nodes[i] = await crossParseAsync(ctx, deferred[i]);
-    }
-  }
-  return nodes;
-}
-
-async function generateArrayNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: unknown[],
-): Promise<SerovalArrayNode> {
-  return {
-    t: SerovalNodeType.Array,
-    i: id,
-    s: undefined,
-    l: current.length,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: await generateNodeList(ctx, current),
-    f: undefined,
-    b: undefined,
-    o: getObjectFlag(current),
-  };
-}
-
-async function generateMapNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Map<unknown, unknown>,
-): Promise<SerovalMapNode> {
-  const len = current.size;
-  const keyNodes = new Array<SerovalNode>(len);
-  const valueNodes = new Array<SerovalNode>(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()) {
-    // Either key or value might be an iterable
-    if (isIterable(ctx, key) || isIterable(ctx, value)) {
-      deferredKey[deferredSize] = key;
-      deferredValue[deferredSize] = value;
-      deferredSize++;
-    } else {
-      keyNodes[nodeSize] = await crossParseAsync(ctx, key);
-      valueNodes[nodeSize] = await crossParseAsync(ctx, value);
-      nodeSize++;
-    }
-  }
-  for (let i = 0; i < deferredSize; i++) {
-    keyNodes[nodeSize + i] = await crossParseAsync(ctx, deferredKey[i]);
-    valueNodes[nodeSize + i] = await crossParseAsync(ctx, deferredValue[i]);
-  }
-  return {
-    t: SerovalNodeType.Map,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: { k: keyNodes, v: valueNodes, s: len },
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateSetNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Set<unknown>,
-): Promise<SerovalSetNode> {
-  const len = current.size;
-  const nodes = new Array<SerovalNode>(len);
-  const deferred = new Array<unknown>(len);
-  let deferredSize = 0;
-  let nodeSize = 0;
-  for (const item of current.keys()) {
-    // Iterables are lazy, so the evaluation must be deferred
-    if (isIterable(ctx, item)) {
-      deferred[deferredSize++] = item;
-    } else {
-      nodes[nodeSize++] = await crossParseAsync(ctx, item);
-    }
-  }
-  // Parse deferred items
-  for (let i = 0; i < deferredSize; i++) {
-    nodes[nodeSize + i] = await crossParseAsync(ctx, deferred[i]);
-  }
-  return {
-    t: SerovalNodeType.Set,
-    i: id,
-    s: undefined,
-    l: len,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: nodes,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateProperties(
-  ctx: CrossParserContext,
-  properties: Record<string, unknown>,
-): Promise<SerovalObjectRecordNode> {
-  const keys = Object.keys(properties);
-  let size = keys.length;
-  const keyNodes = new Array<SerovalObjectRecordKey>(size);
-  const valueNodes = new Array<SerovalNode>(size);
-  const deferredKeys = new Array<SerovalObjectRecordKey>(size);
-  const deferredValues = new Array<unknown>(size);
-  let deferredSize = 0;
-  let nodesSize = 0;
-  let item: unknown;
-  let escaped: SerovalObjectRecordKey;
-  for (const key of keys) {
-    item = properties[key];
-    escaped = serializeString(key);
-    if (isIterable(ctx, item)) {
-      deferredKeys[deferredSize] = escaped;
-      deferredValues[deferredSize] = item;
-      deferredSize++;
-    } else {
-      keyNodes[nodesSize] = escaped;
-      valueNodes[nodesSize] = await crossParseAsync(ctx, item);
-      nodesSize++;
-    }
-  }
-  for (let i = 0; i < deferredSize; i++) {
-    keyNodes[nodesSize + i] = deferredKeys[i];
-    valueNodes[nodesSize + i] = await crossParseAsync(ctx, deferredValues[i]);
-  }
-  if (ctx.features & Feature.Symbol) {
-    if (Symbol.iterator in properties) {
-      keyNodes[size] = SerovalObjectRecordSpecialKey.SymbolIterator;
-      const items = Array.from(properties as Iterable<unknown>);
-      valueNodes[size] = await generateArrayNode(
-        ctx,
-        createCrossIndexedValue(ctx, items),
-        items,
-      );
-      size++;
-    }
-  }
-  return {
-    k: keyNodes,
-    v: valueNodes,
-    s: size,
-  };
-}
-
-async function generatePlainProperties(
-  ctx: CrossParserContext,
-  properties: Record<string, unknown>,
-): Promise<SerovalPlainRecordNode> {
-  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<unknown>(size);
-  let deferredSize = 0;
-  let nodesSize = 0;
-  let item: unknown;
-  let escaped: string;
-  for (const key of keys) {
-    item = properties[key];
-    escaped = serializeString(key);
-    if (isIterable(ctx, item)) {
-      deferredKeys[deferredSize] = escaped;
-      deferredValues[deferredSize] = item;
-      deferredSize++;
-    } else {
-      keyNodes[nodesSize] = escaped;
-      valueNodes[nodesSize] = await crossParseAsync(ctx, item);
-      nodesSize++;
-    }
-  }
-  for (let i = 0; i < deferredSize; i++) {
-    keyNodes[nodesSize + i] = deferredKeys[i];
-    valueNodes[nodesSize + i] = await crossParseAsync(ctx, deferredValues[i]);
-  }
-  return {
-    k: keyNodes,
-    v: valueNodes,
-    s: size,
-  };
-}
-
-async function generatePromiseNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Promise<unknown>,
-): Promise<SerovalPromiseNode> {
-  const [status, result] = await promiseToResult(current);
-  return {
-    t: SerovalNodeType.Promise,
-    i: id,
-    s: status,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: undefined,
-    f: await crossParseAsync(ctx, result),
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateObjectNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Record<string, unknown>,
-  empty: boolean,
-): Promise<ObjectLikeNode> {
-  return {
-    t: empty ? SerovalNodeType.NullConstructor : SerovalNodeType.Object,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: await generateProperties(ctx, current),
-    e: undefined,
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: getObjectFlag(current),
-  };
-}
-
-async function generateAggregateErrorNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: AggregateError,
-): Promise<SerovalAggregateErrorNode> {
-  const options = getErrorOptions(ctx, current);
-  const optionsNode = options
-    ? await generateProperties(ctx, options)
-    : undefined;
-  return {
-    t: SerovalNodeType.AggregateError,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: serializeString(current.message),
-    p: optionsNode,
-    e: undefined,
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateErrorNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Error,
-): Promise<SerovalErrorNode> {
-  const options = getErrorOptions(ctx, current);
-  const optionsNode = options
-    ? await generateProperties(ctx, options)
-    : undefined;
-  return {
-    t: SerovalNodeType.Error,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: getErrorConstructorName(current),
-    m: serializeString(current.message),
-    p: optionsNode,
-    e: undefined,
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateHeadersNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Headers,
-): Promise<SerovalHeadersNode> {
-  const items: Record<string, string> = {};
-  current.forEach((value, key) => {
-    items[key] = value;
-  });
-  return {
-    t: SerovalNodeType.Headers,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: await generatePlainProperties(ctx, items),
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateFormDataNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: FormData,
-): Promise<SerovalFormDataNode> {
-  const items: Record<string, FormDataEntryValue> = {};
-  current.forEach((value, key) => {
-    items[key] = value;
-  });
-  return {
-    t: SerovalNodeType.FormData,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: await generatePlainProperties(ctx, items),
-    a: undefined,
-    f: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateBoxedNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: object,
-): Promise<SerovalBoxedNode> {
-  return {
-    t: SerovalNodeType.Boxed,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: undefined,
-    f: await crossParseAsync(ctx, current.valueOf()),
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateRequestNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Request,
-): Promise<SerovalRequestNode> {
-  return {
-    t: SerovalNodeType.Request,
-    i: id,
-    s: serializeString(current.url),
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    f: await parseObject(
-      ctx,
-      createRequestOptions(current, current.body ? await current.clone().arrayBuffer() : null),
-    ),
-    a: undefined,
-    b: undefined,
-    o: undefined,
-  };
-}
-async function generateResponseNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Response,
-): Promise<SerovalResponseNode> {
-  return {
-    t: SerovalNodeType.Response,
-    i: id,
-    s: undefined,
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    f: undefined,
-    a: [
-      current.body
-        ? serializeArrayBuffer(ctx, await current.clone().arrayBuffer())
-        : NULL_NODE,
-      await parseObject(ctx, createResponseOptions(current)),
-    ],
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateEventNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: Event,
-): Promise<SerovalEventNode> {
-  return {
-    t: SerovalNodeType.Event,
-    i: id,
-    s: serializeString(current.type),
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: undefined,
-    f: await parseObject(ctx, createEventOptions(current)),
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function generateCustomEventNode(
-  ctx: CrossParserContext,
-  id: number,
-  current: CustomEvent,
-): Promise<SerovalCustomEventNode> {
-  return {
-    t: SerovalNodeType.CustomEvent,
-    i: id,
-    s: serializeString(current.type),
-    l: undefined,
-    c: undefined,
-    m: undefined,
-    p: undefined,
-    e: undefined,
-    a: undefined,
-    f: await parseObject(ctx, createCustomEventOptions(current)),
-    b: undefined,
-    o: undefined,
-  };
-}
-
-async function parseObject(
-  ctx: CrossParserContext,
-  current: object | null,
-): Promise<SerovalNode> {
-  if (!current) {
-    return NULL_NODE;
-  }
-  // Non-primitive values needs a reference ID
-  // mostly because the values themselves are stateful
-  const registeredID = ctx.refs.get(current);
-  if (registeredID != null) {
-    return createIndexedValueNode(registeredID);
-  }
-  const id = ctx.refs.size;
-  ctx.refs.set(current, id);
-  if (hasReferenceID(current)) {
-    return createReferenceNode(id, current);
-  }
-  if (Array.isArray(current)) {
-    return generateArrayNode(ctx, id, current);
-  }
-  const currentClass = current.constructor;
-  switch (currentClass) {
-    case Number:
-    case Boolean:
-    case String:
-    case BigInt:
-      return generateBoxedNode(ctx, id, current);
-    case Date:
-      return createDateNode(id, current as unknown as Date);
-    case RegExp:
-      return createRegExpNode(id, current as unknown as RegExp);
-    case Object:
-      return generateObjectNode(
-        ctx,
-        id,
-        current as Record<string, unknown>,
-        false,
-      );
-    case undefined:
-      return generateObjectNode(
-        ctx,
-        id,
-        current as Record<string, unknown>,
-        true,
-      );
-    case Error:
-    case EvalError:
-    case RangeError:
-    case ReferenceError:
-    case SyntaxError:
-    case TypeError:
-    case URIError:
-      return generateErrorNode(ctx, id, current as unknown as Error);
-    default:
-      break;
-  }
-  // Typed Arrays
-  if (ctx.features & Feature.TypedArray) {
-    switch (currentClass) {
-      case ArrayBuffer:
-        return createArrayBufferNode(id, current as unknown as ArrayBuffer);
-      case Int8Array:
-      case Int16Array:
-      case Int32Array:
-      case Uint8Array:
-      case Uint16Array:
-      case Uint32Array:
-      case Uint8ClampedArray:
-      case Float32Array:
-      case Float64Array:
-        return createTypedArrayNode(ctx, id, current as unknown as TypedArrayValue);
-      case DataView:
-        return createDataViewNode(ctx, id, current as unknown as DataView);
-      default:
-        break;
-    }
-  }
-  // BigInt Typed Arrays
-  if ((ctx.features & BIGINT_FLAG) === BIGINT_FLAG) {
-    switch (currentClass) {
-      case BigInt64Array:
-      case BigUint64Array:
-        return createBigIntTypedArrayNode(ctx, id, current as unknown as BigIntTypedArrayValue);
-      default:
-        break;
-    }
-  }
-  // ES Collection
-  if (ctx.features & Feature.Map && currentClass === Map) {
-    return generateMapNode(
-      ctx,
-      id,
-      current as unknown as Map<unknown, unknown>,
-    );
-  }
-  if (ctx.features & Feature.Set && currentClass === Set) {
-    return generateSetNode(
-      ctx,
-      id,
-      current as unknown as Set<unknown>,
-    );
-  }
-  // Promises
-  if (
-    (ctx.features & Feature.Promise)
-    && (currentClass === Promise || current instanceof Promise)
-  ) {
-    return generatePromiseNode(ctx, id, current as unknown as Promise<unknown>);
-  }
-  // Web APIs
-  if (ctx.features & Feature.WebAPI) {
-    if (typeof URL !== 'undefined' && currentClass === URL) {
-      return createURLNode(id, current as unknown as URL);
-    }
-    if (typeof URLSearchParams !== 'undefined' && currentClass === URLSearchParams) {
-      return createURLSearchParamsNode(id, current as unknown as URLSearchParams);
-    }
-    if (typeof Blob !== 'undefined' && currentClass === Blob) {
-      return createBlobNode(ctx, id, current as unknown as Blob);
-    }
-    if (typeof File !== 'undefined' && currentClass === File) {
-      return createFileNode(ctx, id, current as unknown as File);
-    }
-    if (typeof Headers !== 'undefined' && currentClass === Headers) {
-      return generateHeadersNode(ctx, id, current as unknown as Headers);
-    }
-    if (typeof FormData !== 'undefined' && currentClass === FormData) {
-      return generateFormDataNode(ctx, id, current as unknown as FormData);
-    }
-    if (typeof Request !== 'undefined' && currentClass === Request) {
-      return generateRequestNode(ctx, id, current as unknown as Request);
-    }
-    if (typeof Response !== 'undefined' && currentClass === Response) {
-      return generateResponseNode(ctx, id, current as unknown as Response);
-    }
-    if (typeof Event !== 'undefined' && currentClass === Event) {
-      return generateEventNode(ctx, id, current as unknown as Event);
-    }
-    if (typeof CustomEvent !== 'undefined' && currentClass === CustomEvent) {
-      return generateCustomEventNode(ctx, id, current as unknown as CustomEvent);
-    }
-    if (typeof DOMException !== 'undefined' && currentClass === DOMException) {
-      return createDOMExceptionNode(id, current as unknown as DOMException);
-    }
-  }
-  if (
-    (ctx.features & Feature.AggregateError)
-    && typeof AggregateError !== 'undefined'
-    && (currentClass === AggregateError || current instanceof AggregateError)
-  ) {
-    return generateAggregateErrorNode(ctx, id, current as unknown as AggregateError);
-  }
-  // Slow path. We only need to handle Errors and Iterators
-  // since they have very broad implementations.
-  if (current instanceof Error) {
-    return generateErrorNode(ctx, id, current);
-  }
-  // Generator functions don't have a global constructor
-  // despite existing
-  if (ctx.features & Feature.Symbol && Symbol.iterator in current) {
-    return generateObjectNode(ctx, id, current, !!currentClass);
-  }
-  throw new UnsupportedTypeError(current);
-}
-
-export default async function crossParseAsync<T>(
-  ctx: CrossParserContext,
-  current: T,
-): Promise<SerovalNode> {
-  const t = typeof current;
-  if (ctx.features & Feature.BigInt && t === 'bigint') {
-    return createBigIntNode(current as bigint);
-  }
-  switch (t) {
-    case 'boolean':
-      return current ? TRUE_NODE : FALSE_NODE;
-    case 'undefined':
-      return UNDEFINED_NODE;
-    case 'string':
-      return createStringNode(current as string);
-    case 'number':
-      return createNumberNode(current as number);
-    case 'object':
-      return parseObject(ctx, current as object);
-    case 'symbol':
-      return createSymbolNode(ctx, current as symbol);
-    case 'function':
-      // eslint-disable-next-line @typescript-eslint/ban-types
-      return createFunctionNode(ctx, current as Function);
-    default:
-      throw new UnsupportedTypeError(current);
-  }
+export default class CrossAsyncParserContext extends BaseAsyncParserContext {
+  readonly mode: SerovalMode = 'cross';
 }