🚀 snap-parse

A snappy, type-safe JSON parser for all JavaScript environments.

✨ Features

• 🎯 Type-safe parsing with TypeScript
• 🌍 Cross-platform support (Browser, Node.js, Deno, Bun, Cloudflare)
• 📅 Automatic date parsing
• 🔢 Smart number conversion
• ⚡ Special value handling (undefined, Infinity, NaN)
• 🛡️ Zero dependencies
• 📦 Tiny bundle size

📦 Installation

# Using npm
npx jsr add @openjs/snap-parse

# Using deno
deno add jsr:@openjs/snap-parse

# Using yarn
yarn dlx jsr add @openjs/snap-parse

# Using pnpm
pnpm dlx jsr add @openjs/snap-parse

# Using bun
bunx jsr add @openjs/snap-parse

🚀 Usage

import { parse, stringify } from "@openjs/snap-parse";

// Basic parsing
parse("123"); // => 123
parse("true"); // => true
parse('"hello"'); // => "hello"

// Date parsing
parse("2024-02-14T12:00:00Z"); // => Date object

// Special values
parse("undefined"); // => undefined
parse("Infinity"); // => Infinity
parse("NaN"); // => NaN

// Complex objects
const input = {
  number: "123",
  text: "hello",
  date: "2024-02-14T12:00:00Z",
  array: ["1", "2", "3"],
  nested: { special: "undefined" }
};

parse(input);
// => {
//   number: 123,
//   text: "hello",
//   date: Date object,
//   array: [1, 2, 3],
//   nested: { special: undefined }
// }

// Custom options
parse(input, { numbers: false }); // Keep numbers as strings
parse(input, { dates: false }); // Keep dates as strings
parse(input, { special: false }); // Keep special values as strings

// Stringify special values
stringify({ inf: Infinity, nan: NaN, undef: undefined });
// => '{"inf":"Infinity","nan":"NaN","undef":"undefined"}'

⚙️ API

parse<T>(value: unknown, options?: ParseOptions): T

Parse a value into a JSON-compatible format.

Options

• dates (default: true): Convert ISO date strings to Date objects
• numbers (default: true): Parse numeric strings as numbers
• special (default: true): Parse undefined and special values

stringify(value: unknown): string

Safely stringify a value to JSON, handling special values like undefined, Infinity, and NaN.

🧪 Testing

deno test

📄 License

MIT

👥 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.