Add data.json structure, generation, and output validation

Creates a data.json file at build that compiles metadata about the events into one file

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SableRaf

.github/scripts/data-json.test.mjs

@@ -0,0 +1,62 @@
+import { test, describe } from 'node:test';
+import assert from 'node:assert/strict';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const dataJsonPath = resolve(import.meta.dirname, '../../pcd-website/dist/data.json');
+
+let parsed;
+try {
+  const raw = readFileSync(dataJsonPath, 'utf8');
+  parsed = JSON.parse(raw);
+} catch (err) {
+  throw new Error(
+    `Failed to read or parse pcd-website/dist/data.json: ${err.message}\n` +
+    `Run "npm run build" from pcd-website/ before running this test.`
+  );
+}
+
+describe('data.json structure', () => {
+  test('top-level keys present', () => {
+    assert.ok('schema_version' in parsed, 'missing schema_version');
+    assert.ok('generated_at' in parsed, 'missing generated_at');
+    assert.ok('event_count' in parsed, 'missing event_count');
+    assert.ok('events' in parsed, 'missing events');
+  });
+
+  test('event_count matches events.length', () => {
+    assert.equal(parsed.event_count, parsed.events.length);
+  });
+});
+
+describe('data.json events', () => {
+  test('no event contains primary_contact', () => {
+    for (const event of parsed.events) {
+      assert.ok(!('primary_contact' in event), `event ${event.id} contains primary_contact`);
+    }
+  });
+
+  test('no event contains placeholder', () => {
+    for (const event of parsed.events) {
+      assert.ok(!('placeholder' in event), `event ${event.id} contains placeholder`);
+    }
+  });
+
+  test('every canonical_url matches expected pattern', () => {
+    for (const event of parsed.events) {
+      const expected = `https://day.processing.org/event/${event.id}-${event.uid}/`;
+      assert.equal(
+        event.canonical_url,
+        expected,
+        `event ${event.id}: canonical_url mismatch`
+      );
+    }
+  });
+
+  test('every event has finite lat and lng', () => {
+    for (const event of parsed.events) {
+      assert.ok(Number.isFinite(event.lat), `event ${event.id}: lat is not finite`);
+      assert.ok(Number.isFinite(event.lng), `event ${event.id}: lng is not finite`);
+    }
+  });
+});

AGENTS.md

@@ -34,6 +34,9 @@ node --test .github/scripts/event-issue-helpers.test.mjs
 node --test .github/scripts/process-new-event-issue.test.mjs
 node --test .github/scripts/process-edit-event-issue.test.mjs
 node --test .github/scripts/plus-code.test.mjs
+
+# Requires npm run build from pcd-website/ first:
+node --test .github/scripts/data-json.test.mjs
 ```
 
 No install needed — `open-location-code` is already available at `pcd-website/node_modules/`.
@@ -62,6 +65,8 @@ Event data lives in `src/content/events/<event-id>/`:
 
 **If a plus_code is invalid or too short, the build fails with a clear error — this is intentional.**
 
+**"Confirmed" events in data.json:** An event is included in the `/data.json` feed if it is present in `loadNodes()` and has no `placeholder: true` flag. There are currently no other event states (draft, hidden, etc.). If new states are added in future, the filter in `src/pages/data.json.ts` must be updated explicitly.
+
 ### Key implementation details
 
 - **Leaflet CSS** is loaded via `<link>` tags in `index.astro`, NOT via JS imports — avoids SSR issues since MapView is `client:only="vue"`.
@@ -83,6 +88,7 @@ Event data lives in `src/content/events/<event-id>/`:
 | `src/lib/format.ts` | `formatDate()`, `formatDateRange()`, `calendarLinks()`, etc. |
 | `src/lib/popup.ts` | Leaflet popup HTML generation (`makePopupContent()`) |
 | `src/styles/global.css` | Design tokens (CSS custom properties), IBM Plex Sans, Leaflet overrides |
+| `src/pages/data.json.ts` | Static JSON feed of confirmed events, served at /data.json |
 | `src/content.config.ts` | Astro content collection Zod schema for events |
 | `src/config.ts` | Global static constants (contact email, etc.) |
 | `src/i18n/index.ts` | Creates the `vue-i18n` instance and exports `syncLocale()` |

TEST.md

@@ -56,6 +56,24 @@ These tests cover the shared pure functions extracted into `event-issue-helpers.
 
 ---
 
+## data.json build output
+
+**File:** `.github/scripts/data-json.test.mjs`
+**Run:** `node --test .github/scripts/data-json.test.mjs`
+**Requires:** `npm run build` must be run from `pcd-website/` first — this test reads `pcd-website/dist/data.json`.
+
+| Case | Expected |
+|---|---|
+| File exists and is valid JSON | Passes without error |
+| Top-level keys | `schema_version`, `generated_at`, `event_count`, `events` all present |
+| `event_count` vs `events.length` | Equal |
+| No `primary_contact` in any event | Omitted (privacy) |
+| No `placeholder` in any event | Omitted (all feed entries are confirmed) |
+| `canonical_url` shape | Exactly `https://day.processing.org/event/${id}-${uid}/` |
+| `lat` and `lng` | Finite numbers on every event |
+
+---
+
 ## Plus Code functions
 
 **File:** `.github/scripts/plus-code.test.mjs`

pcd-website/src/pages/data.json.ts

@@ -0,0 +1,53 @@
+import type { APIRoute } from 'astro';
+import { loadNodes, canonicalEventId } from '../lib/nodes';
+
+export const GET: APIRoute = async ({ site }) => {
+  const nodes = await loadNodes();
+  const siteUrl = site!.href.replace(/\/$/, '');
+  const base = import.meta.env.BASE_URL.replace(/\/$/, '');
+
+  const events = nodes
+    .filter((node) => !node.placeholder)
+    .map((node) => ({
+      id: node.id,
+      uid: node.uid,
+      canonical_url: `${siteUrl}${base}/event/${canonicalEventId(node)}/`,
+      event_name: node.event_name,
+      city: node.city ?? null,
+      country: node.country ?? null,
+      location_name: node.location_name ?? null,
+      address: node.address ?? null,
+      location_tbd: node.location_tbd ?? false,
+      plus_code: node.plus_code,
+      lat: node.lat,
+      lng: node.lng,
+      event_date: node.event_date ?? null,
+      event_end_date: node.event_end_date ?? null,
+      event_start_time: node.event_start_time ?? null,
+      event_end_time: node.event_end_time ?? null,
+      date_tbd: node.date_tbd ?? false,
+      time_tbd: node.time_tbd ?? false,
+      online_event: node.online_event ?? false,
+      event_url: node.event_url ?? null,
+      event_page_url: node.event_page_url ?? null,
+      event_short_description: node.event_short_description,
+      details_text: node.details_text,
+      event_activities: node.event_activities,
+      organizers: node.organizers,
+      organization_name: node.organization_name ?? null,
+      organization_url: node.organization_url ?? null,
+      organization_type: node.organization_type ?? null,
+      forum_thread_url: node.forum_thread_url ?? null,
+    }));
+
+  const payload = {
+    schema_version: 1,
+    generated_at: new Date().toISOString(),
+    event_count: events.length,
+    events,
+  };
+
+  return new Response(JSON.stringify(payload, null, 2), {
+    headers: { 'Content-Type': 'application/json' },
+  });
+};