\\${escapeXml(item.title)}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_221":222,"_223":224},"routes/_app.x.$handle.$name",{"_102":101,"_32":45,"_110":90,"_27":111,"_13":14,"_112":-5,"_11":113,"_114":115,"_116":117,"_118":119,"_120":121,"_20":-5,"_122":123,"_124":125,"_126":25,"_127":128,"_129":59,"_130":-5,"_131":-5,"_132":133},"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",5,"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","01a055e0-c9bf-7688-ba72-c635ac42da03","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 SOURCE_URL = \"https://www.aboutamazon.com/about-us/shareholder-letters\";\nconst CACHE_KEY = \"amazon-shareholder-letters-feed\";\nconst MIN_ITEMS = 10;\nconst INCLUDED_YEARS = new Set([\n \"2025\",\n \"2024\",\n \"2023\",\n \"2022\",\n \"2021\",\n \"2020\",\n \"2019\",\n \"2018\",\n \"2017\",\n \"2016\",\n \"1997\",\n]);\n\nexport interface FeedItem {\n title: string;\n url: string;\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\nfunction parseCollection(html: string): FeedItem[] {\n const $ = load(html);\n const byUrl = new Map();\n\n $('a[href*=\"/news/company-news/\"]').each((_index, element) => {\n const anchor = $(element);\n const href = anchor.attr(\"href\");\n const sourceTitle = anchor.text().replace(/\\s+/g, \" \").trim();\n if (!href || !sourceTitle) return;\n\n const url = new URL(href, SOURCE_URL);\n const year = url.pathname.match(/(?:1997|20\\d{2})/)?.[0];\n if (url.origin !== \"https://www.aboutamazon.com\" || !year || !INCLUDED_YEARS.has(year)) return;\n if (!url.pathname.includes(\"letter-to-shareholders\")) return;\n\n url.search = \"\";\n url.hash = \"\";\n const title = sourceTitle.includes(year) ? sourceTitle : \\`\\${year} \\${sourceTitle}\\`;\n if (!byUrl.has(url.href)) byUrl.set(url.href, { title, url: url.href });\n });\n\n return [...byUrl.values()];\n}\n\nasync function scrapeCollection(): Promise {\n const response = await fetch(SOURCE_URL, {\n headers: {\n Accept: \"text/html\",\n \"User-Agent\": \"ListenlyFeedBot/1.0\",\n },\n });\n if (!response.ok) throw new Error(\\`Amazon shareholder letters: HTTP \\${response.status}\\`);\n\n const items = parseCollection(await response.text());\n if (items.length < MIN_ITEMS) {\n throw new Error(\\`Amazon collection returned only \\${items.length} letters\\`);\n }\n return items;\n}\n\nexport async function refresh(): Promise {\n const items = await scrapeCollection();\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(/'/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 \\`).join(\"\\n \");\n\n return \\`\n\n \n Amazon shareholder letters\n \\${SOURCE_URL}\n Amazon shareholder letters selected by Amazon, from 2016 through 2025 plus the original 1997 letter.\n en-us\n \n \\${body}\n \n\\`;\n}\n","import { blob } from \"https://esm.town/v/std/blob/main.ts\";\nimport { load } from \"npm:cheerio@1.0.0\";\n\nconst SOURCE_URL = \"https://www.aboutamazon.com/about-us/shareholder-letters\";\nconst CACHE_KEY = \"amazon-shareholder-letters-feed\";\nconst MIN_ITEMS = 10;\nconst INCLUDED_YEARS = new Set([\n \"2025\",\n \"2024\",\n \"2023\",\n \"2022\",\n \"2021\",\n \"2020\",\n \"2019\",\n \"2018\",\n \"2017\",\n \"2016\",\n \"1997\",\n]);\n\nexport interface FeedItem {\n title: string;\n url: string;\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\nfunction parseCollection(html: string): FeedItem[] {\n const $ = load(html);\n const byUrl = new Map();\n\n $('a[href*=\"/news/company-news/\"]').each((_index, element) => {\n const anchor = $(element);\n const href = anchor.attr(\"href\");\n const sourceTitle = anchor.text().replace(/\\s+/g, \" \").trim();\n if (!href || !sourceTitle) return;\n\n const url = new URL(href, SOURCE_URL);\n const year = url.pathname.match(/(?:1997|20\\d{2})/)?.[0];\n if (url.origin !== \"https://www.aboutamazon.com\" || !year || !INCLUDED_YEARS.has(year)) return;\n if (!url.pathname.includes(\"letter-to-shareholders\")) return;\n\n url.search = \"\";\n url.hash = \"\";\n const title = sourceTitle.includes(year) ? sourceTitle : `\\${year} \\${sourceTitle}`;\n if (!byUrl.has(url.href)) byUrl.set(url.href, { title, url: url.href });\n });\n\n return [...byUrl.values()];\n}\n\nasync function scrapeCollection(): Promise {\n const response = await fetch(SOURCE_URL, {\n headers: {\n Accept: \"text/html\",\n \"User-Agent\": \"ListenlyFeedBot/1.0\",\n },\n });\n if (!response.ok) throw new Error(`Amazon shareholder letters: HTTP \\${response.status}`);\n\n const items = parseCollection(await response.text());\n if (items.length < MIN_ITEMS) {\n throw new Error(`Amazon collection returned only \\${items.length} letters`);\n }\n return items;\n}\n\nexport async function refresh(): Promise {\n const items = await scrapeCollection();\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(/'/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 `).join(\"\\n \");\n\n return `\n\n \n Amazon shareholder letters\n \\${SOURCE_URL}\n Amazon shareholder letters selected by Amazon, from 2016 through 2025 plus the original 1997 letter.\n en-us\n \n \\${body}\n \n`;\n}\n","createdAt",["D",1788147469130],"branchVersion","branchId","4be5ffcb-3337-4e81-82bd-6c027f1cd1aa","id","15d7dd8f-5d7b-4946-a6d2-79b6972abca9","amazon-shareholder-letters-rss",["D",1788147190023],"deletedAt","legacyEnvVars","privacy","public","httpPrivacy","description","Selected Amazon shareholder letters","imageUrl","41fc127f-5d67-4e9d-aaf5-7f1531438361","pinnedFileId","01a055e0-c9bf-7688-ba72-bd00d203c616","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","9dd2e27d-d103-40dd-bb45-da8e837d341a","tursoName","15d7dd8f5d7b4946a6d279b6972abca9","tursoHostname","15d7dd8f5d7b4946a6d279b6972abca9-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789535451117],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_102":101,"_109":105},"org",{"_102":101,"_103":-5,"_104":105,"_18":55,"_106":107,"_108":25},"branch",{"_13":89,"_32":90,"_43":42,"_91":44,"_92":93,"_94":89,"_95":50,"_96":97,"_98":65,"_99":45,"_100":101},"isOwned",6,"main","projectId","forkedBranchId","2d486230-5945-4b95-b250-34c2c02fc992","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","6951b886-1c7e-4ed3-8041-04a6995d6f6d","forkedProjectOrgId","projectName","userHandle","ivryb","handle","displayName","avatar","https://img.clerk.com/eyJ0eXBlIjoicHJveHkiLCJzcmMiOiJodHRwczovL2ltYWdlcy5jbGVyay5kZXYvb2F1dGhfZ2l0aHViL2ltZ18yZkFtS1dWcU5NYWRjQkN5MGVCUTVRS0Z5SkEifQ","tier","free","canRestrictVals","profileImageUrl","branchName","","adoptOrgId",{"_43":44,"_32":45,"_38":216,"_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":217,"_72":-5,"_73":74,"_75":74,"_76":77,"_78":77,"_79":77,"_80":74,"_81":74,"_82":218,"_84":219,"_86":220,"_88":25},"tree",[195,196,197,198,199],"files",[195,196,197,198,199],"counts",{"_185":63,"_186":153,"_187":63,"_188":189,"_190":191},"contents",[144,145,146,147,148],"upstreamProject",{"_43":97,"_32":141,"_52":142,"_54":-5,"_49":50,"_82":143},"upstreamBranch",{"_43":93,"_38":134,"_135":136,"_32":90,"_91":97,"_13":89,"_92":137,"_94":138,"_139":140,"_47":-5,"_88":25,"_49":50,"_100":101,"_64":65,"_99":141},"emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},["D",1788145822344],"updatedAt",["D",1788145975853],"adc2f96c-f87b-444e-97b5-b08189b7e0e6",14,"lockfileKey","1788145976026-esm.town_v_ivryb_bits-about-money-rss@6-main","bits-about-money-rss","Full RSS feed for Bits About Money",{"_102":101,"_109":105},{"_43":178,"_32":179,"_30":180,"_152":-5,"_41":42,"_40":181,"_154":59,"_38":182,"_13":153,"_33":20,"_35":183,"_24":25,"_157":-5,"_27":184},{"_43":171,"_32":172,"_30":57,"_152":-5,"_41":42,"_40":153,"_154":59,"_38":173,"_13":63,"_33":174,"_35":175,"_24":25,"_157":176,"_27":177},{"_43":163,"_32":164,"_30":165,"_152":-5,"_41":42,"_40":166,"_154":59,"_38":167,"_13":153,"_33":168,"_35":169,"_24":25,"_157":-5,"_27":170},{"_43":159,"_32":28,"_30":31,"_152":-5,"_41":42,"_40":14,"_154":25,"_38":160,"_13":161,"_33":34,"_35":37,"_24":25,"_157":-5,"_27":162},{"_43":149,"_32":150,"_30":151,"_152":-5,"_41":42,"_40":153,"_154":59,"_38":155,"_13":63,"_33":34,"_35":156,"_24":25,"_157":-5,"_27":158},"abef7361-bc9e-46eb-8d33-4a876d6994b5","seed.ts","01a055e0-c9bf-7688-ba72-c9a95dd0cf4b","parentId",1,"latest",["D",1788147190023],"import { fetchItems, refresh } from \"./scraper.ts\";\n\nawait refresh();\nconsole.log(`Seeded ${(await fetchItems()).length} feed items.`);","label",[150],"fa1996a8-1c14-4fb1-819c-dedf46f3a5de",["D",1788147469130],2,[28],"0ab582d0-c141-4c66-a469-efedb1efb237","refresh.ts","01a055e0-c9bf-7688-ba72-c26a509e89a9",3,["D",1788147431817],"interval","import { refresh } from \"./scraper.ts\";\n\nexport default async function (): Promise {\n await refresh();\n console.log(\"amazon-shareholder-letters-rss refreshed\");\n}",[164],"e675a6ea-7595-45c1-9355-4b4fb0b8f46e","main.ts",["D",1788147190023],"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}","amazon-shareholder-letters",[172],"39db39f9-b4b5-44b3-ad52-5f4744cc431b","README.md","01a055e0-c9bf-7688-ba72-b98a3d89be9c",4,["D",1788147433620],"# amazon-shareholder-letters-rss\n\nAn RSS feed for Amazon's [selected shareholder letters](https://www.aboutamazon.com/about-us/shareholder-letters).\n\n[Open the feed](url:main.ts)\n\nThe scraper follows Amazon's first-party collection from 2016 through 2025 plus the original 1997 letter. It preserves the publisher's order, omits invented publication dates, and refuses to replace the last good cache if fewer than 10 letters are found.\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.",[179],"pulls","branches","forks","envVars",{"_192":63,"_194":63},"connections",{"_192":63,"_193":63},"count","unfilledCount","emptyCount",{"_43":178,"_32":179,"_30":180,"_152":-5,"_41":42,"_40":181,"_154":59,"_38":213,"_13":153,"_33":20,"_35":183,"_24":25,"_157":-5,"_201":214,"_27":215},{"_43":171,"_32":172,"_30":57,"_152":-5,"_41":42,"_40":153,"_154":59,"_38":210,"_13":63,"_33":174,"_35":175,"_24":25,"_157":176,"_201":211,"_27":212},{"_43":163,"_32":164,"_30":165,"_152":-5,"_41":42,"_40":166,"_154":59,"_38":207,"_13":153,"_33":168,"_35":169,"_24":25,"_157":-5,"_201":208,"_27":209},{"_43":159,"_32":28,"_30":31,"_152":-5,"_41":42,"_40":14,"_154":25,"_38":204,"_13":161,"_33":34,"_35":37,"_24":25,"_157":-5,"_201":205,"_27":206},{"_43":149,"_32":150,"_30":151,"_152":-5,"_41":42,"_40":153,"_154":59,"_38":200,"_13":63,"_33":34,"_35":156,"_24":25,"_157":-5,"_201":202,"_27":203},["D",1788147190023],"children",[],[150],["D",1788147469130],[],[28],["D",1788147431817],[],[164],["D",1788147190023],[],[172],["D",1788147433620],[],[179],["D",1788147190023],["D",1789535451117],{"_102":101,"_109":105},{"_102":101,"_103":-5,"_104":105,"_18":55,"_106":107,"_108":25},{"_13":89,"_32":90,"_43":42,"_91":44,"_92":93,"_94":89,"_95":50,"_96":97,"_98":65,"_99":45,"_100":101},"ctx",{"_82":-5,"_131":254,"_255":256,"_257":258,"_259":25,"_260":25,"_261":25,"_262":59,"_263":-5,"_264":-7,"_265":-7,"_266":63,"_267":25,"_268":25,"_269":-5,"_270":25,"_271":25,"_272":25,"_273":-5},"ENV",{"_225":226,"_227":228,"_229":90,"_230":231,"_232":233,"_234":235,"_236":237,"_238":239,"_240":241,"_242":243,"_244":245,"_246":247,"_248":249,"_250":251,"_252":253},"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 · v5