${escapeXml(item.title)}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_222":223,"_224":225},"routes/_app.x.$handle.$name",{"_103":102,"_32":45,"_111":90,"_27":112,"_13":14,"_113":-5,"_11":114,"_115":116,"_117":118,"_119":120,"_121":122,"_20":-5,"_123":124,"_125":126,"_127":25,"_128":129,"_130":59,"_131":-5,"_132":-5,"_133":134},"routes/_app.x.$handle.$name.branch.$branch.version.$version.diff",{"_11":12,"_13":14,"_15":16,"_17":-5,"_18":-5},"project",{"_43":44,"_32":45,"_38":46,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":71,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":83,"_84":85,"_86":87,"_88":25},"version",7,"changes",[19],"aiChatInfo","userId",{"_20":21,"_22":23,"_24":25,"_26":25,"_27":28,"_29":28},"file",{"_30":31,"_32":28,"_33":34,"_35":37,"_38":39,"_40":14,"_41":42,"_24":25},"previous",{"_30":31,"_32":28,"_33":34,"_35":36},"deleted",false,"deletedHere","path","scraper.ts","latestPath","fileId","01a055cb-fa00-72a2-9988-e9c9b521e580","name","fileType","script","content","import { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { load } from \"npm:cheerio@1.0.0\";\n\nconst INDEX_URL = \"https://www.berkshirehathaway.com/letters/letters.html\";\nconst CACHE_KEY = \"berkshire-shareholder-letters-feed\";\n\nexport interface FeedItem {\n title: string;\n url: string;\n date: string | null;\n summary: string | null;\n}\n\ninterface Cache {\n lastCheck: string | null;\n items: FeedItem[];\n}\n\nasync function readCache(): Promise {\n return (await blob.getJSON(CACHE_KEY)) ?? { lastCheck: null, items: [] };\n}\n\nasync function scrapeLetters(): Promise {\n const response = await fetch(INDEX_URL);\n if (!response.ok) throw new Error(`letters index: HTTP ${response.status}`);\n const $ = load(await response.text());\n const byYear = new Map();\n\n for (const element of $(\"a[href]\").toArray()) {\n const anchor = $(element);\n const href = anchor.attr(\"href\");\n const yearText = anchor.text().trim();\n if (!href || !/^\\d{4}$/.test(yearText)) continue;\n if (!/^\\d{4}(?:ltr)?\\.(?:html|pdf)$/i.test(href)) continue;\n const year = Number(yearText);\n if (year < 1965 || year > new Date().getUTCFullYear()) continue;\n const url = new URL(href, INDEX_URL).href;\n byYear.set(year, {\n title: `${year} Berkshire Hathaway shareholder letter`,\n url,\n date: null,\n summary: `Berkshire Hathaway annual letter for ${year}.`,\n });\n }\n\n const items = [...byYear.entries()].sort(([a], [b]) => b - a).map(([, item]) => item);\n if (items.length < 40) throw new Error(`index returned only ${items.length} letters`);\n return items;\n}\n\nexport async function refresh(): Promise {\n const items = await scrapeLetters();\n await blob.setJSON(CACHE_KEY, { lastCheck: new Date().toISOString(), items } satisfies Cache);\n}\n\nexport async function lastChecked(): Promise {\n const value = (await readCache()).lastCheck;\n const parsed = value ? Date.parse(value) : Number.NaN;\n return Number.isNaN(parsed) ? 0 : parsed;\n}\n\nexport async function fetchItems(): Promise {\n return (await readCache()).items;\n}\n\nfunction escapeXml(value: string): string {\n return value.replace(/&/g, \"&\").replace(//g, \">\")\n .replace(/\"/g, \""\").replace(/\\x27/g, \"'\");\n}\n\nexport function buildRss(items: FeedItem[], selfUrl: string): string {\n const body = items.map((item) => `\n ${escapeXml(item.title)}\n ${escapeXml(item.url)}\n ${escapeXml(item.url)}\n ${escapeXml(item.summary ?? item.title)}\n `).join(\"\\n \");\n\n return `\n\n \n Berkshire Hathaway shareholder letters\n ${INDEX_URL}\n Berkshire Hathaway shareholder letters from the official archive.\n en-us\n \n ${body}\n \n`;\n}","import { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { load } from \"npm:cheerio@1.0.0\";\n\nconst INDEX_URL = \"https://www.berkshirehathaway.com/letters/letters.html\";\nconst CACHE_KEY = \"berkshire-shareholder-letters-feed\";\nconst PDF_SHIMS = new Map([\n [1998, \"1998pdf.pdf\"],\n [1999, \"final1999pdf.pdf\"],\n [2000, \"2000pdf.pdf\"],\n [2001, \"2001pdf.pdf\"],\n [2002, \"2002pdf.pdf\"],\n [2003, \"2003ltr.pdf\"],\n]);\n\nexport interface FeedItem {\n title: string;\n url: string;\n guid?: string;\n date: string | null;\n summary: string | null;\n}\n\ninterface Cache {\n lastCheck: string | null;\n items: FeedItem[];\n}\n\nasync function readCache(): Promise {\n return (await blob.getJSON(CACHE_KEY)) ?? { lastCheck: null, items: [] };\n}\n\nasync function scrapeLetters(): Promise {\n const response = await fetch(INDEX_URL);\n if (!response.ok) throw new Error(`letters index: HTTP ${response.status}`);\n const $ = load(await response.text());\n const byYear = new Map();\n\n for (const element of $(\"a[href]\").toArray()) {\n const anchor = $(element);\n const href = anchor.attr(\"href\");\n const yearText = anchor.text().trim();\n if (!href || !/^\\d{4}$/.test(yearText)) continue;\n if (!/^\\d{4}(?:ltr)?\\.(?:html|pdf)$/i.test(href)) continue;\n const year = Number(yearText);\n if (year < 1965 || year > new Date().getUTCFullYear()) continue;\n\n const archiveUrl = new URL(href, INDEX_URL).href;\n // The official 1998-2003 HTML pages are short Adobe notices. Point listeners\n // to the PDFs while keeping the archive URL as the stable feed identity.\n const pdfPath = PDF_SHIMS.get(year);\n const url = pdfPath ? new URL(pdfPath, INDEX_URL).href : archiveUrl;\n byYear.set(year, {\n title: `${year} Berkshire Hathaway shareholder letter`,\n url,\n guid: archiveUrl,\n date: null,\n summary: `Berkshire Hathaway annual letter for ${year}.`,\n });\n }\n\n const items = [...byYear.entries()].sort(([a], [b]) => b - a).map(([, item]) => item);\n if (items.length < 40) throw new Error(`index returned only ${items.length} letters`);\n return items;\n}\n\nexport async function refresh(): Promise {\n const items = await scrapeLetters();\n await blob.setJSON(CACHE_KEY, { lastCheck: new Date().toISOString(), items } satisfies Cache);\n}\n\nexport async function lastChecked(): Promise {\n const value = (await readCache()).lastCheck;\n const parsed = value ? Date.parse(value) : Number.NaN;\n return Number.isNaN(parsed) ? 0 : parsed;\n}\n\nexport async function fetchItems(): Promise {\n return (await readCache()).items;\n}\n\nfunction escapeXml(value: string): string {\n return value.replace(/&/g, \"&\").replace(//g, \">\")\n .replace(/\"/g, \""\").replace(/\\x27/g, \"'\");\n}\n\nexport function buildRss(items: FeedItem[], selfUrl: string): string {\n const body = items.map((item) => `\n ${escapeXml(item.title)}\n ${escapeXml(item.url)}\n ${escapeXml(item.guid ?? item.url)}\n ${escapeXml(item.summary ?? item.title)}\n `).join(\"\\n \");\n\n return `\n\n \n Berkshire Hathaway shareholder letters\n ${INDEX_URL}\n Berkshire Hathaway shareholder letters from the official archive.\n en-us\n \n ${body}\n \n`;\n}","createdAt",["D",1788190813918],"branchVersion","branchId","acb0af00-730c-4ddc-ac11-2551e6da7020","id","666d7a52-e043-49ef-8d59-acb2fa08c994","berkshire-letters-rss",["D",1788145826110],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","RSS feed for Berkshire shareholder letters","imageUrl","41fc127f-5d67-4e9d-aaf5-7f1531438361","pinnedFileId","01a055cb-fa00-72a2-9988-e0c6c49eb841","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","9dd2e27d-d103-40dd-bb45-da8e837d341a","tursoName","666d7a52e04349ef8d59acb2fa08c994","tursoHostname","666d7a52e04349ef8d59acb2fa08c994-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789534872841],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_103":102,"_110":106},"org",{"_103":102,"_104":-5,"_105":106,"_18":55,"_107":108,"_109":25},"branch",{"_13":89,"_32":90,"_43":42,"_91":44,"_92":93,"_94":95,"_96":50,"_97":98,"_99":65,"_100":45,"_101":102},"isOwned",8,"main","projectId","forkedBranchId","adc2f96c-f87b-444e-97b5-b08189b7e0e6","forkedBranchVersion",14,"forkedProjectPrivacy","forkedProjectId","af97ad78-f1f9-48ff-a00d-c401c8b9b233","forkedProjectOrgId","projectName","userHandle","ivryb","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yZkFtS1dWcU5NYWRjQkN5MGVCUTVRS0Z5SkEifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":217,"_47":-5,"_48":25,"_49":50,"_51":50,"_52":53,"_54":-5,"_18":55,"_56":57,"_58":59,"_60":-5,"_61":-5,"_62":63,"_64":65,"_66":67,"_68":69,"_70":218,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":219,"_84":220,"_86":221,"_88":25},"tree",[196,197,198,199,200],"files",[196,197,198,199,200],"counts",{"_186":63,"_187":155,"_188":63,"_189":190,"_191":192},"contents",[143,144,145,146,147],"upstreamProject",{"_43":98,"_32":140,"_52":141,"_54":-5,"_49":50,"_82":142},"upstreamBranch",{"_43":93,"_38":135,"_136":137,"_32":90,"_91":98,"_13":95,"_92":-5,"_94":-5,"_138":139,"_47":-5,"_88":25,"_49":50,"_101":102,"_64":65,"_100":140},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1787640981828],"updatedAt",["D",1787723249634],"lockfileKey","1787723250254-esm.town_v_ivryb_pg-essays-rss@14-main","pg-essays-rss","RSS feed of Paul Graham's essays",{"_103":102,"_110":106},{"_43":179,"_32":180,"_30":181,"_151":-5,"_41":42,"_40":182,"_153":25,"_38":183,"_13":155,"_33":20,"_35":184,"_24":25,"_157":-5,"_27":185},{"_43":171,"_32":172,"_30":57,"_151":-5,"_41":42,"_40":173,"_153":59,"_38":174,"_13":155,"_33":175,"_35":176,"_24":25,"_157":177,"_27":178},{"_43":163,"_32":164,"_30":165,"_151":-5,"_41":42,"_40":166,"_153":59,"_38":167,"_13":155,"_33":168,"_35":169,"_24":25,"_157":-5,"_27":170},{"_43":159,"_32":28,"_30":31,"_151":-5,"_41":42,"_40":14,"_153":59,"_38":160,"_13":161,"_33":34,"_35":37,"_24":25,"_157":-5,"_27":162},{"_43":148,"_32":149,"_30":150,"_151":-5,"_41":42,"_40":152,"_153":59,"_38":154,"_13":155,"_33":34,"_35":156,"_24":25,"_157":-5,"_27":158},"34cdfc44-0316-46ce-869e-72be598a633a","seed.ts","01a055cb-fa00-72a2-9988-eea57655884a","parentId",5,"latest",["D",1788145980455],1,"import { fetchItems, refresh } from \"./scraper.ts\";\n\nawait refresh();\nconsole.log(`Seeded ${(await fetchItems()).length} feed items.`);","label",[149],"09bf37eb-692a-416c-bf5c-d25900596cff",["D",1788190813918],2,[28],"9a8b36ce-6dcb-4d1d-a1c1-aac82596eefb","refresh.ts","01a055cb-fa00-72a2-9988-e42ac92f1cd3",3,["D",1788145979103],"interval","import { refresh } from \"./scraper.ts\";\n\nexport default async function (): Promise {\n await refresh();\n console.log(\"berkshire-letters-rss refreshed\");\n}",[164],"2be147b2-9da4-4dc0-a389-c5449e7a03f1","main.ts",4,["D",1788145980043],"http","import { buildRss, fetchItems, lastChecked, refresh } from \"./scraper.ts\";\n\nconst STALE_MS = 6 * 60 * 60 * 1000;\n\nexport default async function handler(request: Request): Promise {\n try {\n if (Date.now() - await lastChecked() >= STALE_MS) await refresh();\n } catch (error) {\n console.error(\"refresh failed:\", error);\n }\n\n const items = await fetchItems();\n if (items.length === 0) {\n return new Response(\"Feed not ready yet. Try again in a minute.\", { status: 503 });\n }\n\n const selfUrl = new URL(request.url);\n selfUrl.search = \"\";\n selfUrl.hash = \"\";\n return new Response(buildRss(items, selfUrl.href), {\n headers: {\n \"Cache-Control\": \"public, max-age=900\",\n \"Content-Type\": \"application/rss+xml; charset=utf-8\",\n },\n });\n}","berkshire-letters",[172],"05671195-1ab8-4d25-8192-d3f36f01c7c6","README.md","01a055cb-fa00-72a2-9988-de252711f305",6,["D",1788145981247],"# berkshire-letters-rss\n\nA complete RSS feed for the official [Berkshire Hathaway shareholder-letter archive](https://www.berkshirehathaway.com/letters/letters.html).\n\n[Open the feed](url:main.ts)\n\nThe feed contains all 48 linked annual letters from 1977 through 2024. The publisher provides HTML for 1977 through 2003 and PDF files from 2004 onward. Feed items omit `pubDate` because the archive gives a report year, not an exact publication date.\n\n`refresh.ts` updates the cache daily. `main.ts` also refreshes a cache older than six hours when requested and serves the last good copy if the publisher is temporarily unavailable.",[180],"pulls","branches","forks","envVars",{"_193":63,"_195":63},"connections",{"_193":63,"_194":63},"count","unfilledCount","emptyCount",{"_43":179,"_32":180,"_30":181,"_151":-5,"_41":42,"_40":182,"_153":25,"_38":214,"_13":155,"_33":20,"_35":184,"_24":25,"_157":-5,"_202":215,"_27":216},{"_43":171,"_32":172,"_30":57,"_151":-5,"_41":42,"_40":173,"_153":59,"_38":211,"_13":155,"_33":175,"_35":176,"_24":25,"_157":177,"_202":212,"_27":213},{"_43":163,"_32":164,"_30":165,"_151":-5,"_41":42,"_40":166,"_153":59,"_38":208,"_13":155,"_33":168,"_35":169,"_24":25,"_157":-5,"_202":209,"_27":210},{"_43":159,"_32":28,"_30":31,"_151":-5,"_41":42,"_40":14,"_153":59,"_38":205,"_13":161,"_33":34,"_35":37,"_24":25,"_157":-5,"_202":206,"_27":207},{"_43":148,"_32":149,"_30":150,"_151":-5,"_41":42,"_40":152,"_153":59,"_38":201,"_13":155,"_33":34,"_35":156,"_24":25,"_157":-5,"_202":203,"_27":204},["D",1788145980455],"children",[],[149],["D",1788190813918],[],[28],["D",1788145979103],[],[164],["D",1788145980043],[],[172],["D",1788145981247],[],[180],["D",1788145826110],["D",1789534872841],{"_103":102,"_110":106},{"_103":102,"_104":-5,"_105":106,"_18":55,"_107":108,"_109":25},{"_13":89,"_32":90,"_43":42,"_91":44,"_92":93,"_94":95,"_96":50,"_97":98,"_99":65,"_100":45,"_101":102},"ctx",{"_82":-5,"_132":255,"_256":257,"_258":259,"_260":25,"_261":25,"_262":25,"_263":59,"_264":-5,"_265":-7,"_266":-7,"_267":63,"_268":25,"_269":25,"_270":-5,"_271":25,"_272":25,"_273":25,"_274":-5},"ENV",{"_226":227,"_228":229,"_230":90,"_231":232,"_233":234,"_235":236,"_237":238,"_239":240,"_241":242,"_243":244,"_245":246,"_247":248,"_249":250,"_251":252,"_253":254},"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"]

Diff · v7