${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",[],[197],"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",[],[205],"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",[],[213],"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",[],[221],["D",1789468239765],[],[18],["D",1789467005299],{"_11":12,"_120":69},{"_11":12,"_115":116,"_68":69,"_30":67,"_117":118,"_119":24},{"_38":39,"_13":16,"_32":35,"_107":71,"_108":-5,"_109":-5,"_110":-5,"_111":-5,"_112":-5,"_113":14,"_114":12},"ctx",{"_53":-5,"_139":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 · README.md