@cookiepal-oss/cookie-db

Bundled catalog of ~1,100 commonly observed HTTP cookies with vendor, category, and description metadata. Used by the CLI to pre-categorise cookies after a crawl. No network access; everything ships with the package.

Install

pnpm add @cookiepal-oss/cookie-db

Usage

import { cookies, type CookieDbEntry, type CategorySlug } from '@cookiepal-oss/cookie-db';

cookies.find((c) => c.name === '_ga');
// { name: '_ga', vendor: 'Google Analytics', category: 'analytics', wildcard: false, description: '…' }

Entry shape

type CategorySlug =
  | 'necessary'
  | 'functional'
  | 'analytics'
  | 'advertisement'
  | 'performance'
  | 'other';

interface CookieDbEntry {
  name: string;        // cookie name; may include wildcards if `wildcard: true`
  vendor: string;      // human-readable vendor, e.g. "Google Analytics"
  category: CategorySlug;
  wildcard: boolean;   // true → `name` is a prefix / pattern, not an exact match
  description: string;
}

License

MIT. Cookie metadata is curated from public vendor documentation.