@prexjs/cookie

Fast, RFC 6265 compliant HTTP cookie parser and serializer with Set-Cookie attribute support.

@prexjs/cookie is a high-performance TypeScript library for parsing and serializing HTTP Cookie and Set-Cookie headers according to RFC 6265 and modern draft extensions (SameSite, Priority, Partitioned).

Features

• Parse HTTP Cookie header strings into simple key-value dictionaries.
• Parse and serialize Set-Cookie headers with all standard attributes: Max-Age, Expires, Domain, Path, HttpOnly, Secure, SameSite, Partitioned, and Priority.
• High-performance scanning with no regex overhead during delimiter parsing.
• Backward-compatible serialize(name, val, options) helper.
• Dual ES Module (.mjs) and CommonJS (.cjs) support with TypeScript definitions.
• Zero runtime dependencies.

Installation

Install using your preferred package manager:

# npm
npm install @prexjs/cookie

# pnpm
pnpm add @prexjs/cookie

# Yarn
yarn add @prexjs/cookie

# Bun
bun add @prexjs/cookie

Quick start

import cookie, { parse, serialize } from '@prexjs/cookie';
import http from 'node:http';

const server = http.createServer((req, res) => {
  // Parse incoming Cookie header
  const cookies = cookie.parse(req.headers.cookie || '');
  console.log(cookies.sessionId);

  // Set a new cookie
  res.setHeader(
    'Set-Cookie',
    cookie.serialize('sessionId', 'abc123xyz', {
      httpOnly: true,
      secure: true,
      sameSite: 'lax',
      maxAge: 3600, // 1 hour
    }),
  );

  res.end('Authenticated');
});

Both default and named exports are supported:

import cookie, {
  parse,
  serialize,
  parseCookie,
  stringifyCookie,
  parseSetCookie,
  stringifySetCookie,
  type Cookies,
  type SetCookie,
  type ParseOptions,
  type StringifyOptions,
  type SerializeOptions,
} from '@prexjs/cookie';

Examples

Parsing request cookies

import { parse } from '@prexjs/cookie';

const cookies = parse('foo=bar; equation=E%3Dmc%5E2');
console.log(cookies);
// { foo: 'bar', equation: 'E=mc^2' }

Serializing Set-Cookie with attributes

import { serialize } from '@prexjs/cookie';

const setCookie = serialize('session', 'secret-token', {
  domain: 'example.com',
  path: '/',
  httpOnly: true,
  secure: true,
  sameSite: 'strict',
  priority: 'high',
  partitioned: true,
});

Parsing Set-Cookie header string

import { parseSetCookie } from '@prexjs/cookie';

const parsed = parseSetCookie('id=a3fWa; Expires=Wed, 21 Oct 2026 07:28:00 GMT; Secure; HttpOnly; SameSite=Lax');
console.log(parsed.name);     // 'id'
console.log(parsed.value);    // 'a3fWa'
console.log(parsed.httpOnly); // true
console.log(parsed.sameSite); // 'lax'

Compatibility

@prexjs/cookie is designed for JavaScript and TypeScript projects. It is distributed with ES Modules (.mjs), CommonJS (.cjs), and TypeScript declarations. It runs in any modern JavaScript runtime (Node.js, Deno, Bun, browser) without external dependencies.

License

This project is licensed under the MIT License. See LICENSE for the full license text.

Related projects

• prex.js — prex.js monorepo and ecosystem.