cookie 1.1.1: parse and serialize cookies with cookie package

Clean-room public code sample — generation instructions

Write a brand-new, minimal, self-contained code sample in this clean-room directory.
Do not copy, paraphrase, or reference any existing project source. Work only from this spec.

A csx.json manifest scaffold already exists. Do not recreate it from memory. Preserve its case.goal, packages and symbols; fill its empty case.contract with exact assertions and correct its environment, commands and verifierAdapter for the files you generate.

Goal: parse and serialize cookies with cookie package
Kind: HOW

Use EXACTLY these public packages and versions:
  - pkg:npm/cookie@1.1.1
Demonstrate these symbols/APIs:
  - parse
  - serialize

Rules:
  - One focused purpose; the smallest project that proves the goal.
  - Include a contract test (test/contract.*) that runs OFFLINE and exits 0 exactly when the goal behavior works.
  - Pin every dependency with a lockfile so resolution is reproducible.
  - No secrets, credentials, or tokens. No real URLs (only example.com or localhost). No absolute paths.
  - No personal names, emails, company names, or project identifiers of any kind.
  - No binaries and no generated output (node_modules, dist, target, venv, .git, .env).
  - Keep it under 200 files and 256KB packed.

{"case":{"caseId":"case:sha256:c450ca83d3c1a1891cddad920df42a2ac28a16601616229a7a3bfbe33abdc2c5","contract":["cookie.parse parses Cookie header strings into key-value object pairs with URL decoding","cookie.parse supports custom decode option for value decoding and transformation","cookie.serialize serializes name-value pairs with HttpOnly, Secure, Max-Age, Path, Domain, and SameSite attributes","cookie.serialize formats expires Date objects to UTC date strings and handles SameSite None","cookie.serialize supports modern Partitioned and Priority attributes","cookie.parseSetCookie deserializes Set-Cookie header strings into structured cookie attribute objects","cookie.stringifyCookie serializes key-value dictionary objects into Cookie header strings"],"goal":"parse and serialize cookies with cookie package","kind":"HOW","packages":["pkg:npm/cookie@1.1.1"],"schemaVersion":1,"symbols":["parse","serialize"]},"contractCommand":["node","test/contract.js"],"environment":{"arch":"x64","distro":"ubuntu","ecosystem":"npm","libc":"glibc","libcVersion":"2.39","os":"linux","osVersionBucket":"24","packageManager":"npm","schemaVersion":1},"license":"MIT-0","packages":["pkg:npm/cookie@1.1.1"],"schemaVersion":1,"subject":"pkg:npm/cookie@1.1.1","symbols":["parse","serialize"],"verifierAdapter":"node-typescript@1"}

{
  "name": "sample-cookie",
  "version": "1.0.0",
  "lockfileVersion": 3,
  "requires": true,
  "packages": {
    "": {
      "name": "sample-cookie",
      "version": "1.0.0",
      "license": "MIT-0",
      "dependencies": {
        "cookie": "1.1.1"
      }
    },
    "node_modules/cookie": {
      "version": "1.1.1",
      "resolved": "https://registry.npmjs.org/cookie/-/cookie-1.1.1.tgz",
      "integrity": "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ==",
      "license": "MIT",
      "engines": {
        "node": ">=18"
      },
      "funding": {
        "type": "opencollective",
        "url": "https://opencollective.com/express"
      }
    }
  }
}

{
  "name": "sample-cookie",
  "version": "1.0.0",
  "private": true,
  "description": "Clean-room verification sample for cookie",
  "main": "src/index.js",
  "scripts": {
    "test": "node test/contract.js"
  },
  "dependencies": {
    "cookie": "1.1.1"
  },
  "license": "MIT-0"
}

{
  "schemaVersion": 1,
  "goal": "parse and serialize cookies with cookie package",
  "kind": "HOW",
  "packages": [
    "pkg:npm/cookie@1.1.1"
  ],
  "symbols": [
    "parse",
    "serialize"
  ]
}

const cookie = require('cookie');

function parseCookieHeader(headerStr, options) {
  return cookie.parse(headerStr, options);
}

function serializeCookie(name, value, options) {
  return cookie.serialize(name, value, options);
}

function parseSetCookieHeader(headerStr, options) {
  return cookie.parseSetCookie(headerStr, options);
}

function stringifyCookieHeader(cookies, options) {
  return cookie.stringifyCookie(cookies, options);
}

module.exports = {
  cookie,
  parseCookieHeader,
  serializeCookie,
  parseSetCookieHeader,
  stringifyCookieHeader
};

const assert = require('node:assert');
const cookie = require('cookie');
const {
  parseCookieHeader,
  serializeCookie,
  parseSetCookieHeader,
  stringifyCookieHeader
} = require('../src/index.js');

// 1. cookie.parse parses Cookie header strings into key-value object pairs with URL decoding
const parsed = cookie.parse('sessionId=abc123xyz; theme=dark; user_token=val%20with%20spaces; empty=');
assert.strictEqual(parsed.sessionId, 'abc123xyz');
assert.strictEqual(parsed.theme, 'dark');
assert.strictEqual(parsed.user_token, 'val with spaces');
assert.strictEqual(parsed.empty, '');
assert.strictEqual(parseCookieHeader('foo=bar; baz=qux').foo, 'bar');

// 2. cookie.parse supports custom decode option for value decoding and transformation
const customParsed = cookie.parse('status=ACTIVE; role=ADMIN', {
  decode: (str) => str.toLowerCase()
});
assert.strictEqual(customParsed.status, 'active');
assert.strictEqual(customParsed.role, 'admin');

// 3. cookie.serialize serializes name-value pairs with HttpOnly, Secure, Max-Age, Path, Domain, and SameSite attributes
const serialized = cookie.serialize('session_token', 'secret456', {
  httpOnly: true,
  secure: true,
  maxAge: 3600,
  sameSite: 'lax',
  path: '/',
  domain: 'example.com'
});
assert.strictEqual(
  serialized,
  'session_token=secret456; Max-Age=3600; Domain=example.com; Path=/; HttpOnly; Secure; SameSite=Lax'
);
assert.strictEqual(
  serializeCookie('pref', 'compact', { sameSite: 'strict', path: '/app' }),
  'pref=compact; Path=/app; SameSite=Strict'
);

// 4. cookie.serialize formats expires Date objects to UTC date strings and handles SameSite None
const expireDate = new Date('2030-01-01T00:00:00.000Z');
const expSerialized = cookie.serialize('auth_remember', 'true', {
  expires: expireDate,
  secure: true,
  sameSite: 'none'
});
assert.strictEqual(
  expSerialized,
  `auth_remember=true; Expires=${expireDate.toUTCString()}; Secure; SameSite=None`
);

// 5. cookie.serialize supports modern Partitioned and Priority attributes
const chipsCookie = cookie.serialize('cross_id', 'partitioned_val', {
  partitioned: true,
  priority: 'high',
  secure: true
});
assert.strictEqual(
  chipsCookie,
  'cross_id=partitioned_val; Secure; Partitioned; Priority=High'
);

// 6. cookie.parseSetCookie deserializes Set-Cookie header strings into structured cookie attribute objects
const parsedSetCookie = cookie.parseSetCookie(
  'uid=12345; Max-Age=86400; Path=/api; HttpOnly; Secure; SameSite=Lax; Priority=Medium'
);
assert.strictEqual(parsedSetCookie.name, 'uid');
assert.strictEqual(parsedSetCookie.value, '12345');
assert.strictEqual(parsedSetCookie.maxAge, 86400);
assert.strictEqual(parsedSetCookie.path, '/api');
assert.strictEqual(parsedSetCookie.httpOnly, true);
assert.strictEqual(parsedSetCookie.secure, true);
assert.strictEqual(parsedSetCookie.sameSite, 'lax');
assert.strictEqual(parsedSetCookie.priority, 'medium');
assert.strictEqual(parseSetCookieHeader('k=v; HttpOnly').httpOnly, true);

// 7. cookie.stringifyCookie serializes key-value dictionary objects into Cookie header strings
const stringified = cookie.stringifyCookie({ id: '99', pref: 'light' });
assert.strictEqual(stringified, 'id=99; pref=light');
assert.strictEqual(stringifyCookieHeader({ a: '1', b: '2' }), 'a=1; b=2');

console.log('Contract tests passed successfully.');
process.exit(0);