@technobuddha/library/src/json-deserialize.ts

A large library of useful functions

import { type JsonValue } from 'type-fest';

import { type TBJsonValue } from './json.ts';
import { reviver } from './reviver.ts';

/**
 * Deserializes a value that may be a specially formatted JSON string.
 *
 * If the input is a string that starts with '⁅' and ends with '⁆', the function
 * removes these delimiters and parses the inner content as JSON. Otherwise, it
 * returns the value as-is, cast to `JsonValue`.
 * @param value - The value to deserialize, which may be a specially formatted JSON string.
 * @returns The deserialized `JsonValue` if the input was a specially formatted string,
 *          or the original value cast as `JsonValue` otherwise.
 * @internal
 */
export function jsonDeserialize(value: unknown): TBJsonValue {
  if (typeof value === 'string' && value.startsWith('⁅') && value.endsWith('⁆')) {
    return JSON.parse(value.slice(1, -1), reviver);
  }

  return value as JsonValue;
}