feat: add Punishing: Gray Raven with karendar.com source

Add karendar.com as the event source for Punishing: Gray Raven (PGR).
Karendar publishes a dedicated Global event calendar with exact UTC
timestamps in clean server-rendered HTML.

- Register 'pgr' in GameId and GAMES registry (#CC292B, Kuro Games).
- Add parseWeekdayDayMonthYearUtc in src/ingest/dates.ts with unit tests.
- Implement karendarParser in src/ingest/parsers/karendar.ts reading
  'week', 'ongoing', and 'upcoming' sections, mapping indefinite/permanent
  ends to endsAt: null, and categorizing tags to EventType.
- Register pgr-karendar-events in src/ingest/adapters/index.ts.
- Add pinned fixture, expected output, and comprehensive test suites.
- Update documentation in AGENTS.md, README.md, docs/INGESTION.md,
  and docs/SOURCES.md.
This commit is contained in:
Lucas Winther
2026-09-12 09:10:02 +02:00
parent 2d6299445c
commit 4382ed35ee
15 changed files with 1645 additions and 22 deletions
+42
View File
@@ -13,6 +13,7 @@ import {
parseYearFirstSlashRange,
parseIsoClockRangeUtc,
parseIsoOffsetInstant,
parseWeekdayDayMonthYearUtc,
} from "../src/ingest/dates.ts";
describe("parseMonthDayYear", () => {
@@ -539,3 +540,44 @@ describe("parseIsoOffsetInstant", () => {
expect(parseIsoOffsetInstant("Starts 2026-08-03T21:00-07:00")).toBeNull();
});
});
describe("parseWeekdayDayMonthYearUtc", () => {
test("parses full weekday date with exact UTC time", () => {
expect(
parseWeekdayDayMonthYearUtc("Mon, 7 Sept 2026, 07:00 UTC"),
).toEqual({
iso: "2026-09-07T07:00:00.000Z",
precision: "exact",
});
expect(
parseWeekdayDayMonthYearUtc("Thu, 20 Aug 2026, 05:00 UTC"),
).toEqual({
iso: "2026-08-20T05:00:00.000Z",
precision: "exact",
});
});
test("accepts input without weekday or comma", () => {
expect(parseWeekdayDayMonthYearUtc("7 Sept 2026 07:00 UTC")?.iso).toBe(
"2026-09-07T07:00:00.000Z",
);
});
test("accepts optional seconds", () => {
expect(
parseWeekdayDayMonthYearUtc("Wed, 23 Sept 2026, 23:00:00 UTC")?.iso,
).toBe("2026-09-23T23:00:00.000Z");
});
test("returns null for non-date strings like Permanent or Unknown", () => {
expect(parseWeekdayDayMonthYearUtc("Permanent")).toBeNull();
expect(parseWeekdayDayMonthYearUtc("Unknown")).toBeNull();
});
test("rejects missing year or invalid dates", () => {
expect(parseWeekdayDayMonthYearUtc("Mon, 7 Sept, 07:00 UTC")).toBeNull();
expect(
parseWeekdayDayMonthYearUtc("Mon, 30 Feb 2026, 07:00 UTC"),
).toBeNull();
});
});