🧩 A lightweight Node.js client for fetching and decrypting Everybody Codes inputs automatically.

• Fetch and decrypt puzzle input data from everybody.codes
• Fully typed API (TypeScript)
• Built-in test mocks via undici.MockAgent
• Automatically validated examples and README code blocks in CI
• API-stable and documented via API Extractor

npm install @mrtimeey/everybodycodes-data # or pnpm add @mrtimeey/everybodycodes-data

import { EverybodyCodesClient } from "@mrtimeey/everybodycodes-data"; const client = new EverybodyCodesClient("your-everybody-codes-session-cookie"); // Fetch and decrypt full quest data const data = await client.getEventData("2025", 1); console.log(data); // { 1: "input text part 1", 2: "...", 3: "..." } // Fetch only a single part const part1 = await client.getEventPartData("2025", 1, 1); console.log(part1);

💡 Your session-cookie must match the everybody-codes cookie from your logged-in browser.

The public API surface is automatically tracked by API Extractor.
See etc/everybodycodes-data.api.md for the latest exported types.

The public API is also documented through Typedoc on GH-Pages.

• Node.js ≥ 18.17
• npm ≥ 9 or pnpm ≥ 8

npm ci

npm test npm run build

npm run lint npm run format

This repository uses release-please:

1. Conventional commits (fix:, feat:) update changelog and version bump via PR.
2. Merge the release PR → Git tag is created.
3. GitHub Actions publish the package to npm with provenance.

See SECURITY.md for responsible disclosure guidelines.

Contributions, issues, and pull requests are welcome!
See CONTRIBUTING.md for details.

MIT © Tim Kruse