${escapeHtml(name)}

Fixtures from FA Full-Time, refreshed hourly.

\n\n \n

Or paste this URL into Calendar → File → New Calendar Subscription:

\n ${httpsUrl}\n\n

Matches: ${cache?.eventCount ?? 0} upcoming
Updated: ${updated}

\n\n

Treat this link as private — anyone who has it can see the fixture list.

\n\n ${\n lastError\n ? `

Last refresh failed
${\n escapeHtml(lastError.message)\n }
${lastError.at}

`\n : \"\"\n }\n\n`;\n}\n\nfunction escapeHtml(value: string): string {\n return value.replace(/[&<>\"]/g, (char) =>\n ({ \"&\": \"&\", \"<\": \"<\", \">\": \">\", '\"': \""\" })[char]!\n );\n}\n","label",[18],"pulls","branches",1,"forks","envVars",{"_159":161,"_162":26},"connections",{"_159":26,"_160":26},"count","unfilledCount",3,"emptyCount",{"_32":223,"_13":224,"_63":225,"_42":-5,"_34":35,"_144":107,"_145":84,"_36":226,"_38":26,"_65":21,"_147":227,"_67":24,"_149":-5,"_178":228,"_17":229},{"_32":216,"_13":217,"_63":218,"_42":-5,"_34":35,"_144":153,"_145":84,"_36":219,"_38":26,"_65":186,"_147":220,"_67":24,"_149":-5,"_178":221,"_17":222},{"_32":208,"_13":209,"_63":210,"_42":-5,"_34":35,"_144":211,"_145":84,"_36":212,"_38":26,"_65":186,"_147":213,"_67":24,"_149":-5,"_178":214,"_17":215},{"_32":200,"_13":201,"_63":202,"_42":-5,"_34":35,"_144":203,"_145":84,"_36":204,"_38":161,"_65":186,"_147":205,"_67":24,"_149":-5,"_178":206,"_17":207},{"_32":143,"_13":18,"_63":64,"_42":-5,"_34":35,"_144":39,"_145":84,"_36":197,"_38":26,"_65":66,"_147":148,"_67":24,"_149":14,"_178":198,"_17":199},{"_32":190,"_13":191,"_63":192,"_42":-5,"_34":35,"_144":161,"_145":84,"_36":193,"_38":26,"_65":186,"_147":194,"_67":24,"_149":-5,"_178":195,"_17":196},{"_32":181,"_13":182,"_63":183,"_42":-5,"_34":35,"_144":184,"_145":84,"_36":185,"_38":26,"_65":186,"_147":187,"_67":24,"_149":-5,"_178":188,"_17":189},{"_32":171,"_13":172,"_63":173,"_42":-5,"_34":35,"_144":174,"_145":84,"_36":175,"_38":26,"_65":176,"_147":177,"_67":24,"_149":-5,"_178":179,"_17":180},"a149666c-f3ac-4789-8cfb-292eb8beb1ec","scrape.ts","eeafd266-b0ed-11f1-abd2-1607ee4eb77e",7,["D",1789467138315],"interval","// Hourly: re-scrape Full-Time and refresh the cached calendar.\n// Learn more: https://docs.val.town/vals/cron/\n\nimport { refresh } from \"./refresh.ts\";\n\nexport default async function (_interval: Interval) {\n const cache = await refresh();\n console.log(\n `${cache.eventCount} upcoming of ${cache.parsedCount} fixtures, fetched via ${cache.via}`,\n );\n}\n","children",[],[172],"8cab57ca-7fed-4c1d-9a54-647bab236561","refresh.ts","da2c00e4-b0ed-11f1-8e1e-1607ee4eb77e",5,["D",1789467103910],"script","/** Scrape, render and cache. Shared by the hourly interval and the HTTP val. */\n\nimport { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { configuredIds, fixturesUrl, teamName } from \"./config.ts\";\nimport { fetchFullTimePage } from \"./fetchPage.ts\";\nimport { parseFixtures, parseSelectOptions } from \"./parse.ts\";\nimport { buildIcs, upcoming } from \"./ics.ts\";\n\nconst CACHE_KEY = \"calendar\";\nconst IDS_KEY = \"fixture-ids\";\nconst ERROR_KEY = \"last-error\";\n\nexport type Cache = {\n ics: string;\n /** Events in the feed, i.e. upcoming fixtures only. */\n eventCount: number;\n /** Fixture rows parsed from the page, including ones already played. */\n parsedCount: number;\n fetchedAt: string;\n /** Hash of the feed ignoring DTSTAMP — doubles as the HTTP ETag. */\n contentHash: string;\n via: string;\n seasonId: string;\n teamId: string;\n};\n\nexport type LastError = { message: string; at: string };\n\ntype Ids = { seasonId: string; teamId: string };\n\nexport async function readCache(): Promise {\n return (await blob.getJSON(CACHE_KEY)) as Cache | undefined;\n}\n\nexport async function readLastError(): Promise {\n return (await blob.getJSON(ERROR_KEY)) as LastError | undefined;\n}\n\nexport async function refresh(now = new Date()): Promise {\n try {\n const cache = await scrapeAndCache(now);\n await blob.setJSON(ERROR_KEY, null);\n return cache;\n } catch (err) {\n const message = (err as Error).message;\n // Leave any existing cache alone: a stale calendar beats an empty one.\n await blob.setJSON(ERROR_KEY, { message, at: now.toISOString() } satisfies LastError);\n throw err;\n }\n}\n\nasync function scrapeAndCache(now: Date): Promise {\n const stored = (await blob.getJSON(IDS_KEY)) as Ids | undefined;\n let ids: Ids = stored ?? configuredIds();\n\n let page = await fetchFullTimePage(fixturesUrl(ids));\n let fixtures = parseFixtures(page.html);\n\n // No fixtures at all usually means the season rolled over and the ids in the\n // URL are last year's. The page's own dropdowns tell us the current ones.\n if (fixtures.length === 0) {\n console.warn(`no fixtures for season ${ids.seasonId} / team ${ids.teamId} — rediscovering ids`);\n ids = await discoverIds();\n await blob.setJSON(IDS_KEY, ids);\n page = await fetchFullTimePage(fixturesUrl(ids));\n fixtures = parseFixtures(page.html);\n if (fixtures.length === 0) throw new Error(\"no fixtures found even after rediscovering ids\");\n }\n\n const events = upcoming(fixtures);\n const ics = buildIcs(events, now);\n const contentHash = await sha256(ics.replace(/^DTSTAMP:.*$/gm, \"\"));\n\n // Unchanged content keeps the previous body verbatim, so subscribers' ETags\n // and DTSTAMPs stay put instead of churning every hour.\n const previous = await readCache();\n const cache: Cache = {\n ics: previous?.contentHash === contentHash ? previous.ics : ics,\n eventCount: events.length,\n parsedCount: fixtures.length,\n fetchedAt: now.toISOString(),\n contentHash,\n via: page.via,\n ...ids,\n };\n await blob.setJSON(CACHE_KEY, cache);\n return cache;\n}\n\nasync function discoverIds(): Promise {\n // The league-wide page (no team) still lists every season and team.\n const { html } = await fetchFullTimePage(fixturesUrl({ teamId: \"\" }));\n const seasons = parseSelectOptions(html, \"selectedSeason\");\n const teams = parseSelectOptions(html, \"selectedTeam\");\n\n const wanted = teamName();\n const season = seasons.find((option) => option.selected) ?? seasons.at(-1);\n const team = teams.find((option) => option.label === wanted);\n if (!season?.value || !team?.value) {\n throw new Error(`could not find \"${wanted}\" in the Full-Time dropdowns`);\n }\n\n console.log(`rediscovered ids: season ${season.value} (${season.label}), team ${team.value}`);\n return { seasonId: season.value, teamId: team.value };\n}\n\nasync function sha256(value: string): Promise {\n const digest = await crypto.subtle.digest(\"SHA-256\", new TextEncoder().encode(value));\n return [...new Uint8Array(digest)].map((byte) => byte.toString(16).padStart(2, \"0\")).join(\"\");\n}\n",[],[182],"7dad1766-6393-472a-a4d6-24ed20b66475","parse.ts","bf1cc54a-b0ed-11f1-9afa-1607ee4eb77e",["D",1789467058510],"/**\n * Turning the Full-Time fixtures table into data.\n *\n * The table's columns are Type, Date / Time, Home Team, (logo), (score), (logo),\n * Away Team, Venue, Competition, Status / Notes — but the Venue column is only\n * rendered for some leagues, so nothing here counts columns from the left.\n * Instead the semantic cells are found by their classes (home-team, road-team,\n * status-notes, team-logo, score) and the remaining \"plain\" cells are read\n * relative to the one holding the date.\n */\n\nexport type Fixture = {\n /** Full-Time's own fixture id, which makes a stable calendar UID. */\n id: string;\n /** YYYY-MM-DD, Europe/London. */\n date: string;\n /** HH:MM, or null when Full-Time has the kick-off as to-be-confirmed. */\n time: string | null;\n home: string;\n away: string;\n venue: string;\n competition: string;\n /** Fixture type as published, e.g. \"L\" for league. */\n type: string;\n /** Status / Notes column: empty for a normally scheduled game. */\n status: string;\n};\n\nexport type SelectOption = { value: string; label: string; selected: boolean };\n\nconst DATE_RE = /(\\d{2})\\/(\\d{2})\\/(\\d{2})/;\nconst TIME_RE = /\\b(\\d{2}):(\\d{2})\\b/;\n\n/** Cells we never want to read as text. */\nconst IGNORED_CLASSES = [\"team-logo\", \"score\"];\n\nexport function parseFixtures(html: string): Fixture[] {\n const table = findFixturesTable(html);\n if (!/Competition/i.test(table)) {\n console.warn(\"fixtures table has no Competition heading — the layout may have changed\");\n }\n\n const body = table.match(/]([\\s\\S]*?)<\\/tbody>/i)?.[1] ?? table;\n const rows = [...body.matchAll(/]*>([\\s\\S]*?)<\\/tr>/gi)];\n\n const fixtures: Fixture[] = [];\n for (const [, row] of rows) {\n const fixture = parseRow(row);\n if (fixture) fixtures.push(fixture);\n }\n\n if (rows.length >= 100) {\n console.warn(`${rows.length} rows returned — at the itemsPerPage cap, pagination may be needed`);\n }\n\n return fixtures.sort((a, b) =>\n `${a.date}T${a.time ?? \"00:00\"}`.localeCompare(`${b.date}T${b.time ?? \"00:00\"}`)\n );\n}\n\nfunction findFixturesTable(html: string): string {\n for (const [table] of html.matchAll(/][\\s\\S]*?<\\/table>/gi)) {\n if (/Home Team/i.test(table)) return table;\n }\n throw new Error(\"no fixtures table found on the page\");\n}\n\ntype Cell = { classes: string[]; value: string };\n\nfunction parseRow(row: string): Fixture | null {\n const cells: Cell[] = [...row.matchAll(/]*)>([\\s\\S]*?)<\\/td>/gi)].map(\n ([, attrs, inner]) => ({\n classes: (attrs.match(/class=\"([^\"]*)\"/i)?.[1] ?? \"\").split(/\\s+/).filter(Boolean),\n value: toText(inner),\n }),\n );\n\n const withClass = (name: string) => cells.find((cell) => cell.classes.includes(name));\n const home = withClass(\"home-team\")?.value ?? \"\";\n const away = withClass(\"road-team\")?.value ?? \"\";\n const status = withClass(\"status-notes\")?.value ?? \"\";\n\n const plain = cells.filter((cell) =>\n !cell.classes.some((cls) =>\n cls === \"home-team\" || cls === \"road-team\" || cls === \"status-notes\" ||\n IGNORED_CLASSES.includes(cls)\n )\n );\n\n const dateIndex = plain.findIndex((cell) => DATE_RE.test(cell.value));\n if (!home || !away || dateIndex < 0) return null; // heading or spacer row\n\n const { date, time } = parseWhen(plain[dateIndex].value);\n const type = plain.slice(0, dateIndex).map((cell) => cell.value).find(Boolean) ?? \"\";\n\n // After the date come Venue (optional) then Competition.\n const trailing = plain.slice(dateIndex + 1).map((cell) => cell.value);\n const [venue, competition] = trailing.length >= 2\n ? [trailing[0], trailing[1]]\n : [\"\", trailing[0] ?? \"\"];\n\n return {\n id: row.match(/displayFixture\\.html\\?id=(\\d+)/i)?.[1] ?? fallbackId(date, home, away),\n date,\n time,\n home,\n away,\n venue,\n competition,\n type,\n status,\n };\n}\n\nfunction parseWhen(value: string): { date: string; time: string | null } {\n const [, day, month, year] = value.match(DATE_RE)!;\n const time = value.match(TIME_RE);\n return {\n date: `20${year}-${month}-${day}`,\n time: time ? `${time[1]}:${time[2]}` : null,\n };\n}\n\nfunction fallbackId(date: string, home: string, away: string): string {\n return `${date}-${home}-${away}`.toLowerCase().replace(/[^a-z0-9]+/g, \"-\");\n}\n\n/** Read one of the page's own filter dropdowns, e.g. selectedSeason or selectedTeam. */\nexport function parseSelectOptions(html: string, selectName: string): SelectOption[] {\n const select = html.match(\n new RegExp(`]*name=\"${selectName}\"[^>]*>([\\\\s\\\\S]*?)`, \"i\"),\n );\n if (!select) return [];\n\n return [...select[1].matchAll(/]*)>([\\s\\S]*?)<\\/option>/gi)].map(\n ([, attrs, label]) => ({\n value: attrs.match(/value=\"([^\"]*)\"/i)?.[1] ?? \"\",\n label: toText(label),\n selected: /\\bselected\\b/i.test(attrs),\n }),\n );\n}\n\nconst NAMED_ENTITIES: Record = {\n amp: \"&\",\n lt: \"<\",\n gt: \">\",\n quot: '\"',\n apos: \"'\",\n nbsp: \" \",\n};\n\nfunction decodeEntities(value: string): string {\n return value.replace(/&(#x[0-9a-f]+|#\\d+|[a-z]+);/gi, (match, code: string) => {\n if (code.startsWith(\"#x\") || code.startsWith(\"#X\")) {\n return String.fromCodePoint(parseInt(code.slice(2), 16));\n }\n if (code.startsWith(\"#\")) return String.fromCodePoint(Number(code.slice(1)));\n return NAMED_ENTITIES[code.toLowerCase()] ?? match;\n });\n}\n\nfunction toText(html: string): string {\n return decodeEntities(html.replace(/<[^>]*>/g, \" \")).replace(/\\s+/g, \" \").trim();\n}\n",[],[191],["D",1789467130874],[],[18],"a7a78668-b5a7-4c81-843e-e6422ba54bc5","ics.ts","ce263e54-b0ed-11f1-b141-1607ee4eb77e",12,["D",1789467859117],"/** Rendering fixtures as an iCalendar feed Apple Calendar can subscribe to. */\n\nimport { calendarDescription, calendarName, HOST, MATCH_DURATION_MINUTES } from \"./config.ts\";\nimport type { Fixture } from \"./parse.ts\";\n\nconst TZID = \"Europe/London\";\nconst UID_DOMAIN = \"fulltime-ics.val.town\";\nconst CANCELLED_RE = /postpon|cancel|abandon/i;\n\n/** Today's date in Europe/London, as YYYY-MM-DD. */\nexport function londonToday(now = new Date()): string {\n return now.toLocaleDateString(\"en-CA\", { timeZone: TZID });\n}\n\n/** Fixtures from today onwards — a played match drops out of the calendar. */\nexport function upcoming(fixtures: Fixture[], today = londonToday()): Fixture[] {\n return fixtures.filter((fixture) => fixture.date >= today);\n}\n\nexport function buildIcs(fixtures: Fixture[], now = new Date()): string {\n const lines = [\n \"BEGIN:VCALENDAR\",\n \"VERSION:2.0\",\n \"PRODID:-//barryf//fulltime-ics//EN\",\n \"CALSCALE:GREGORIAN\",\n \"METHOD:PUBLISH\",\n `X-WR-CALNAME:${escapeText(calendarName())}`,\n `X-WR-CALDESC:${escapeText(calendarDescription())}`,\n `X-WR-TIMEZONE:${TZID}`,\n \"X-PUBLISHED-TTL:PT1H\",\n \"REFRESH-INTERVAL;VALUE=DURATION:PT1H\",\n ...LONDON_VTIMEZONE,\n ...fixtures.flatMap((fixture) => event(fixture, now)),\n \"END:VCALENDAR\",\n ];\n return lines.map(fold).join(\"\\r\\n\") + \"\\r\\n\";\n}\n\nfunction event(fixture: Fixture, now: Date): string[] {\n const notes = [`Type: ${fixture.type}`, `Competition: ${fixture.competition}`];\n if (fixture.status) notes.push(`Status: ${fixture.status}`);\n\n const link = fixtureLink(fixture.id);\n if (link) notes.push(link);\n\n return [\n \"BEGIN:VEVENT\",\n `UID:${fixture.id}@${UID_DOMAIN}`,\n `DTSTAMP:${utcStamp(now)}`,\n ...when(fixture),\n `SUMMARY:${escapeText(`${fixture.home} v ${fixture.away}`)}`,\n ...(fixture.venue ? [`LOCATION:${escapeText(fixture.venue)}`] : []),\n `DESCRIPTION:${escapeText(notes.join(\"\\n\"))}`,\n ...(link ? [`URL:${link}`] : []),\n `STATUS:${CANCELLED_RE.test(fixture.status) ? \"CANCELLED\" : \"CONFIRMED\"}`,\n \"SEQUENCE:0\",\n \"TRANSP:OPAQUE\",\n \"END:VEVENT\",\n ];\n}\n\n/**\n * Full-Time's own page for the fixture. Only ids that came from the page are\n * real; a synthesised fallback id would make a URL that 404s.\n */\nfunction fixtureLink(id: string): string | null {\n return /^\\d+$/.test(id) ? `https://${HOST}/displayFixture.html?id=${id}` : null;\n}\n\n/** A kick-off time gives a timed event; a to-be-confirmed one gives an all-day event. */\nfunction when(fixture: Fixture): string[] {\n if (!fixture.time) {\n const nextDay = shift(fixture.date, \"00:00\", 24 * 60);\n return [\n `DTSTART;VALUE=DATE:${dateStamp(fixture.date)}`,\n `DTEND;VALUE=DATE:${dateStamp(nextDay.date)}`,\n ];\n }\n const end = shift(fixture.date, fixture.time, MATCH_DURATION_MINUTES);\n return [\n `DTSTART;TZID=${TZID}:${localStamp(fixture.date, fixture.time)}`,\n `DTEND;TZID=${TZID}:${localStamp(end.date, end.time)}`,\n ];\n}\n\n/** Wall-clock arithmetic: done in UTC so no real timezone is ever applied. */\nfunction shift(date: string, time: string, minutes: number) {\n const [year, month, day] = date.split(\"-\").map(Number);\n const [hours, mins] = time.split(\":\").map(Number);\n const moved = new Date(Date.UTC(year, month - 1, day, hours, mins) + minutes * 60_000);\n return {\n date: moved.toISOString().slice(0, 10),\n time: moved.toISOString().slice(11, 16),\n };\n}\n\nconst dateStamp = (date: string) => date.replaceAll(\"-\", \"\");\nconst localStamp = (date: string, time: string) =>\n `${dateStamp(date)}T${time.replace(\":\", \"\")}00`;\nconst utcStamp = (now: Date) => now.toISOString().replace(/[-:]|\\.\\d{3}/g, \"\");\n\nfunction escapeText(value: string): string {\n return value\n .replace(/\\\\/g, \"\\\\\\\\\")\n .replace(/;/g, \"\\\\;\")\n .replace(/,/g, \"\\\\,\")\n .replace(/\\r?\\n/g, \"\\\\n\");\n}\n\n/** RFC 5545 caps a line at 75 octets; continuations start with one space. */\nfunction fold(line: string): string {\n const bytes = new TextEncoder().encode(line);\n if (bytes.length <= 75) return line;\n\n const pieces: string[] = [];\n let start = 0;\n while (start < bytes.length) {\n const limit = pieces.length === 0 ? 75 : 74; // the leading space counts\n let end = Math.min(start + limit, bytes.length);\n // never split a multi-byte character\n while (end > start + 1 && end < bytes.length && (bytes[end] & 0b1100_0000) === 0b1000_0000) {\n end--;\n }\n pieces.push(new TextDecoder().decode(bytes.subarray(start, end)));\n start = end;\n }\n return pieces.join(\"\\r\\n \");\n}\n\nconst LONDON_VTIMEZONE = [\n \"BEGIN:VTIMEZONE\",\n `TZID:${TZID}`,\n `X-LIC-LOCATION:${TZID}`,\n \"BEGIN:DAYLIGHT\",\n \"TZOFFSETFROM:+0000\",\n \"TZOFFSETTO:+0100\",\n \"TZNAME:BST\",\n \"DTSTART:19700329T010000\",\n \"RRULE:FREQ=YEARLY;BYMONTH=3;BYDAY=-1SU\",\n \"END:DAYLIGHT\",\n \"BEGIN:STANDARD\",\n \"TZOFFSETFROM:+0100\",\n \"TZOFFSETTO:+0000\",\n \"TZNAME:GMT\",\n \"DTSTART:19701025T020000\",\n \"RRULE:FREQ=YEARLY;BYMONTH=10;BYDAY=-1SU\",\n \"END:STANDARD\",\n \"END:VTIMEZONE\",\n];\n",[],[201],"db5abc5c-5c7d-480f-b8a2-9af9ceafc1a6","fetchPage.ts","af9de3f6-b0ed-11f1-9317-1607ee4eb77e",2,["D",1789467032504],"/**\n * Getting a page out of fulltime.thefa.com, which sits behind a Cloudflare WAF.\n *\n * Measured behaviour of that WAF:\n * - HTTP/1.1 + a browser User-Agent -> 200\n * - HTTP/2, any User-Agent -> 403 \"Attention Required!\"\n * - no / curl / python-requests UA -> 403\n * - /displayFixture.html, any shape -> 403 (so we only ever read the list page)\n *\n * Deno's fetch() picks the HTTP version itself and on Val Town it picks HTTP/2,\n * which the WAF rejects — so the hand-rolled HTTP/1.1 request goes first and the\n * two fetch()-based rungs are only fallbacks. We keep the first rung that\n * returns something which actually looks like Full-Time.\n */\n\nconst BROWSER_HEADERS: Record = {\n \"User-Agent\":\n \"Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36\",\n \"Accept\":\n \"text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8\",\n \"Accept-Language\": \"en-GB,en;q=0.9\",\n \"Sec-Fetch-Dest\": \"document\",\n \"Sec-Fetch-Mode\": \"navigate\",\n \"Sec-Fetch-Site\": \"none\",\n \"Sec-Fetch-User\": \"?1\",\n \"Upgrade-Insecure-Requests\": \"1\",\n};\n\nconst BLOCK_MARKER = \"Attention Required\";\n\nexport type PageFetch = { html: string; via: string };\n\n/** A real Full-Time page has the fixtures table's own column headings in it. */\nfunction looksLikeFullTime(html: string): boolean {\n return /]/i.test(html) && /Date\\s*\\/\\s*Time/i.test(html);\n}\n\nexport async function fetchFullTimePage(url: string): Promise {\n const rungs: Array<[string, () => Promise<{ status: number; html: string }>]> = [\n [\"raw-tls-http1.1\", () => viaRawTls(url)],\n [\"fetch\", () => viaFetch(url)],\n [\"fetch+http1\", () => viaHttp1Client(url)],\n ];\n\n const failures: string[] = [];\n for (const [via, attempt] of rungs) {\n try {\n const { status, html } = await attempt();\n if (status === 200 && looksLikeFullTime(html)) return { html, via };\n const blocked = html.includes(BLOCK_MARKER) ? \" (Cloudflare block page)\" : \"\";\n failures.push(`${via}: HTTP ${status}${blocked}`);\n } catch (err) {\n failures.push(`${via}: ${(err as Error).message}`);\n }\n }\n throw new Error(`could not fetch ${url} — ${failures.join(\"; \")}`);\n}\n\nasync function viaFetch(url: string) {\n const res = await fetch(url, { headers: BROWSER_HEADERS });\n return { status: res.status, html: await res.text() };\n}\n\n/** Deno.createHttpClient is unstable; absent on some runtimes, hence the guard. */\nasync function viaHttp1Client(url: string) {\n const createHttpClient = (Deno as Record).createHttpClient as\n | ((opts: unknown) => { close?: () => void })\n | undefined;\n if (typeof createHttpClient !== \"function\") {\n throw new Error(\"Deno.createHttpClient unavailable\");\n }\n const client = createHttpClient({ http1: true, http2: false });\n try {\n const res = await fetch(url, { headers: BROWSER_HEADERS, client } as RequestInit);\n return { status: res.status, html: await res.text() };\n } finally {\n client.close?.();\n }\n}\n\n/**\n * Last resort: speak HTTP/1.1 by hand with ALPN pinned, which is the one thing\n * that reliably stops the runtime negotiating HTTP/2 and getting us blocked.\n */\nasync function viaRawTls(url: string) {\n const target = new URL(url);\n const conn = await Deno.connectTls({\n hostname: target.hostname,\n port: Number(target.port) || 443,\n alpnProtocols: [\"http/1.1\"],\n });\n try {\n const request = [\n `GET ${target.pathname}${target.search} HTTP/1.1`,\n `Host: ${target.hostname}`,\n ...Object.entries(BROWSER_HEADERS).map(([key, value]) => `${key}: ${value}`),\n \"Accept-Encoding: identity\",\n \"Connection: close\",\n \"\",\n \"\",\n ].join(\"\\r\\n\");\n await writeAll(conn, new TextEncoder().encode(request));\n return parseHttp1Response(await readAll(conn));\n } finally {\n try {\n conn.close();\n } catch {\n // the server closes first on Connection: close\n }\n }\n}\n\nasync function writeAll(conn: Deno.Conn, bytes: Uint8Array) {\n let written = 0;\n while (written < bytes.length) written += await conn.write(bytes.subarray(written));\n}\n\nasync function readAll(conn: Deno.Conn): Promise {\n const parts: Uint8Array[] = [];\n const buffer = new Uint8Array(64 * 1024);\n while (true) {\n const read = await conn.read(buffer);\n if (read === null) break;\n parts.push(buffer.slice(0, read));\n }\n return concat(parts);\n}\n\nconst CRLF = new Uint8Array([13, 10]);\nconst CRLF_CRLF = new Uint8Array([13, 10, 13, 10]);\n\nfunction parseHttp1Response(raw: Uint8Array) {\n const split = indexOfSeq(raw, CRLF_CRLF, 0);\n if (split < 0) throw new Error(\"malformed HTTP response: no header terminator\");\n\n const head = new TextDecoder().decode(raw.subarray(0, split));\n const status = Number(head.split(\"\\r\\n\")[0].split(\" \")[1]);\n let body = raw.subarray(split + CRLF_CRLF.length);\n if (/^transfer-encoding:[ \\t]*chunked/im.test(head)) body = decodeChunked(body);\n\n return { status, html: new TextDecoder(\"utf-8\").decode(body) };\n}\n\nfunction decodeChunked(body: Uint8Array): Uint8Array {\n const chunks: Uint8Array[] = [];\n let pos = 0;\n while (pos < body.length) {\n const eol = indexOfSeq(body, CRLF, pos);\n if (eol < 0) break;\n const header = new TextDecoder().decode(body.subarray(pos, eol));\n const size = parseInt(header.split(\";\")[0].trim(), 16);\n if (!Number.isFinite(size) || size <= 0) break;\n const start = eol + CRLF.length;\n chunks.push(body.subarray(start, start + size));\n pos = start + size + CRLF.length; // skip the chunk's own trailing CRLF\n }\n return concat(chunks);\n}\n\nfunction indexOfSeq(haystack: Uint8Array, needle: Uint8Array, from: number): number {\n outer: for (let i = from; i <= haystack.length - needle.length; i++) {\n for (let j = 0; j < needle.length; j++) if (haystack[i + j] !== needle[j]) continue outer;\n return i;\n }\n return -1;\n}\n\nfunction concat(parts: Uint8Array[]): Uint8Array {\n const total = parts.reduce((sum, part) => sum + part.length, 0);\n const out = new Uint8Array(total);\n let offset = 0;\n for (const part of parts) {\n out.set(part, offset);\n offset += part.length;\n }\n return out;\n}\n",[],[209],"347fa0d8-5c9a-4188-a3c7-d39221fec392","config.ts","9f711a84-b0ed-11f1-a733-1607ee4eb77e",["D",1789467005377],"/**\n * All team-specific settings live in environment variables, so the source can\n * stay public without naming a club, a team or an age group.\n *\n * FULLTIME_QUERY the query string from a Full-Time fixtures URL, which is\n * what pins the feed to one team (selectedSeason,\n * selectedTeam, selectedRelatedFixtureOption and friends)\n * TEAM_NAME the team exactly as Full-Time spells it, used as the\n * calendar's name and to re-find the team after a season roll\n * FEED_TOKEN secret first path segment, so the feed URL is unguessable\n */\n\nexport const HOST = \"fulltime.thefa.com\";\n\n/** Kick-off plus this much is the calendar event. */\nexport const MATCH_DURATION_MINUTES = 60;\n\nfunction required(key: string): string {\n const value = Deno.env.get(key);\n if (!value) throw new Error(`missing environment variable ${key}`);\n return value;\n}\n\nexport const teamName = () => required(\"TEAM_NAME\");\nexport const feedToken = () => required(\"FEED_TOKEN\");\nexport const calendarName = () => teamName();\nexport const calendarDescription = () =>\n `Fixtures for ${teamName()}, scraped hourly from FA Full-Time.`;\n\n/** The season and team currently configured, as Full-Time ids. */\nexport function configuredIds(): { seasonId: string; teamId: string } {\n const params = fixturesParams();\n return {\n seasonId: params.get(\"selectedSeason\") ?? \"\",\n teamId: params.get(\"selectedTeam\") ?? \"\",\n };\n}\n\n/**\n * Pass overrides to point at a different season or team than the environment\n * says — `teamId: \"\"` asks for the whole league, whose page still carries the\n * dropdowns we read ids back out of.\n */\nexport function fixturesUrl(overrides: { seasonId?: string; teamId?: string } = {}): string {\n const params = fixturesParams();\n if (overrides.seasonId) params.set(\"selectedSeason\", overrides.seasonId);\n if (overrides.teamId !== undefined) params.set(\"selectedTeam\", overrides.teamId);\n return `https://${HOST}/fixtures.html?${params}`;\n}\n\nfunction fixturesParams(): URLSearchParams {\n const params = new URLSearchParams(required(\"FULLTIME_QUERY\").replace(/^\\?/, \"\"));\n params.set(\"itemsPerPage\", \"100\"); // one page is plenty for a season of fixtures\n return params;\n}\n",[],[217],"6f359cc1-216e-4c20-95c4-2b14c179db90","README.md","7f339bfe-b0f0-11f1-abb2-1607ee4eb77e",["D",1789468239765],"# fulltime-ics\n\nTurns one team's fixture list on [FA Full-Time](https://fulltime.thefa.com) into a calendar you can\nsubscribe to on a phone or laptop. A cron job scrapes the fixtures page every hour, renders an\n`.ics` feed, and caches it; an HTTP endpoint serves that cache.\n\nEverything identifying — which club, which team, which URL — lives in environment variables, so this\nsource can stay public.\n\n## The feed\n\n```\nhttps://.val.run//calendar.ics the calendar itself\nhttps://.val.run/ a page with a webcal:// subscribe link\n```\n\n`FEED_TOKEN` is a secret first path segment: the feed needs no login (so Apple Calendar can refresh\nit unattended) but can't be found by guessing the hostname. Anything without the token — the bare\nhostname included — gets a bare `404`.\n\n## Configuration\n\nThree environment variables, all required; the val throws a named error if one is missing.\n\n| Variable | What it is |\n| --- | --- |\n| `FULLTIME_QUERY` | The query string from a Full-Time fixtures URL. This is what pins the feed to one team — copy it from the address bar after filtering to the team on the site, keeping `selectedSeason`, `selectedTeam` and `selectedRelatedFixtureOption`. |\n| `TEAM_NAME` | The team exactly as Full-Time spells it. Used as the calendar's name, and to re-find the team's id after a season rolls over. |\n| `FEED_TOKEN` | Secret path segment, e.g. `openssl rand -hex 16`. Changing it changes the feed URL, so every device has to re-subscribe. |\n\nTo point this at a different team, change `FULLTIME_QUERY` and `TEAM_NAME`, then delete the\n`fixture-ids` blob (or just run `scrape.ts`, which re-derives the ids when the old ones return\nnothing).\n\n## How the pieces fit\n\n| File | Role |\n| --- | --- |\n| `config.ts` | Reads the environment and builds Full-Time URLs |\n| `fetchPage.ts` | Fetches a Full-Time page past its Cloudflare WAF |\n| `parse.ts` | Fixtures table → `Fixture[]`, plus reading the page's own dropdowns |\n| `ics.ts` | `Fixture[]` → iCalendar text |\n| `refresh.ts` | Scrape → parse → render → cache in blob storage |\n| `scrape.ts` | Interval val, hourly on cron `17 * * * *` |\n| `main.ts` | HTTP val: serves the cached feed and the setup page |\n\n## The one thing to be careful about\n\n**`fulltime.thefa.com` blocks requests by their shape, not by IP.** Measured behaviour:\n\n- HTTP/1.1 with a browser `User-Agent` → `200`\n- HTTP/2, any headers → `403` \"Attention Required!\"\n- A `curl` or `python-requests` `User-Agent` → `403`\n- `/displayFixture.html` (per-fixture detail) → `403` for every client that isn't a real browser\n\nDeno's `fetch` negotiates HTTP/2 on Val Town and so gets blocked. `fetchPage.ts` therefore speaks\nHTTP/1.1 by hand over `Deno.connectTls` with ALPN pinned to `http/1.1`, and keeps two `fetch`-based\nfallbacks behind it. **Replacing that with a plain `fetch()` silently breaks the hourly scrape** —\ncheck `get_logs` for which rung succeeded (`fetched via raw-tls-http1.1`) before suspecting the\nparser.\n\n## What the calendar contains\n\nOne event per *upcoming* fixture — a match drops out of the feed once its date has passed.\n\n- **Title** `Home Team v Away Team`\n- **Location** the venue as Full-Time lists it (a name only; addresses live on the blocked detail\n pages, so each event links to its fixture instead)\n- **Notes** `Type:`, `Competition:`, a `Status:` line when there is one, then the fixture's URL\n- **Duration** kick-off plus `MATCH_DURATION_MINUTES` (60)\n- **Times** `Europe/London`, with a `VTIMEZONE` so BST and GMT both resolve correctly\n- A fixture with no confirmed kick-off becomes an all-day event; one marked postponed, cancelled or\n abandoned gets `STATUS:CANCELLED`, which Apple Calendar strikes through\n\nEvent `UID`s come from Full-Time's own fixture ids, so rescheduling a match moves the existing event\nrather than creating a second one.\n\n## Caching\n\n`refresh.ts` writes `{ ics, contentHash, fetchedAt, … }` to the val's blob storage under\n`calendar`. Two details worth knowing:\n\n- A failed scrape never overwrites a good calendar — the error goes to a separate `last-error` blob\n and shows on the setup page, while subscribers keep the previous feed.\n- The feed is only re-rendered when its content actually changes (the hash ignores `DTSTAMP`), so\n `ETag`s stay stable and devices get `304`s instead of re-downloading an identical calendar.\n\n`main.ts` also refreshes on demand if the cache is more than 90 minutes old, so a missed cron run\nheals itself on the next request, with one in-flight refresh at a time.\n\n## Working on it locally\n\n```sh\ndeno check --allow-import *.ts # scrape.ts needs Val Town's Interval global, so it fails here\n```\n\n`parse.ts` and `ics.ts` are pure functions over a saved copy of the fixtures page, which makes them\neasy to test without touching the network. On the platform, use `run_file` on `scrape.ts` and read\n`get_logs` rather than waiting for the cron.\n\n## Limits\n\n- One page of fixtures (`itemsPerPage=100`); `parse.ts` logs a warning if it ever hits that cap.\n- No venue addresses, referees or match reports: those only exist on `/displayFixture.html`.\n- Anyone with the feed URL can read the fixture list, so treat it as private.\n",[],[224],["D",1789467005299],{"_11":12,"_121":70},{"_11":12,"_116":117,"_69":70,"_30":68,"_118":119,"_120":24},{"_38":107,"_13":16,"_32":35,"_108":72,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":-5,"_114":14,"_115":12},"ctx",{"_53":-5,"_140":267,"_268":269,"_270":271,"_272":24,"_273":24,"_274":24,"_275":84,"_276":-5,"_277":-7,"_278":-7,"_279":26,"_280":24,"_281":24,"_282":-5,"_283":24,"_284":24,"_285":24,"_286":-5},"ENV",{"_238":239,"_240":241,"_242":16,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254,"_255":256,"_257":258,"_259":260,"_261":262,"_263":264,"_265":266},"REACT_APP_SENTRY_DSN","https://586020d86f05489db63a554690acf1e9@o1398359.ingest.sentry.io/6724499","RENDER_GIT_COMMIT","e87eb04e707cf64e7e532c8e8ec395f209e17f15","RENDER_GIT_BRANCH","POSTHOG_API_TOKEN","phc_nmoyuAkStEZuUp69rYlg1DZgrIt19Gx0Y4Hwf8tGgJP","POSTHOG_API_HOST","https://wart.val.town","WEB_API_TEMPLATE","https://{val}.web.val.run","APP_URL","https://www.val.town","MODULE_URL","https://esm.town","VANITY_WEB_API_TEMPLATE","https://{label}.val.run/","DENOLS_URL","https://lsp.val.town","NODE_ENV","production","CLOUDFLARE_TURNSTILE_SITE_KEY","0x4AAAAAACtaIZJH7s9rBMZ6","GOOGLE_CLIENT_ID","875989696899-jtsqkhlbdv5jrlsk8631p7ipjg3c6o62.apps.googleusercontent.com","STRIPE_PUBLISHABLE_KEY","pk_live_51N2zvWEpZTTLipIkVEwXrUG9AT0yeOOEYxszarZT1jpsZV58Ly6wlg3SltZpHN26CUalOBmUSY7adQRQiSkCZz2500qSXNkf8Y","API_URL","https://api.val.town",[],"preferencesKeybindings","default","preferencesTheme","light","preferencesFixers","preferencesCopilot","preferencesSelectionAi","preferencesCloseBrackets","preferencesChatPanelState","preferencesDprint","preferencesDenofmt","notificationCount","flagDenols","isBusinessOrgMember","businessOrgHandle","isBusinessOrgAdmin","isHigherTownieTier","navCollapsed","currentOrgId"]

History · main.ts