${escapeHtml(caseName)}

[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_161":162,"_163":164},"routes/_app.x.$handle.$name",{"_16":17,"_20":21,"_88":70,"_89":90,"_68":-7,"_91":-5,"_13":92,"_93":94,"_11":95,"_96":97,"_98":99,"_100":-5,"_101":-5,"_102":-5,"_103":26,"_104":105,"_106":38,"_107":-5,"_108":-5,"_109":110},"routes/_app.x.$handle.$name.search.$(branch)",{"_11":12,"_13":14,"_15":-5,"_16":17},"files",[],"project",{"_18":19,"_20":21,"_22":23,"_24":-5,"_25":26,"_27":28,"_29":28,"_30":31,"_32":-5,"_33":34,"_35":36,"_37":38,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":-5,"_52":53,"_54":53,"_55":56,"_57":56,"_58":56,"_59":53,"_60":53,"_61":62,"_63":64,"_65":66,"_67":26},"query","handle","joeross","id","67602406-4d6d-43e5-a717-da442928b526","name","courtlistener-reflow","createdAt",["D",1787705965716],"deletedAt","legacyEnvVars",false,"privacy","public","httpPrivacy","description","Reformats CourtListener opinions for better read later parsing","imageUrl","userId","bf5647c6-e9c5-4bf4-a918-f2a4dcc7ca61","pinnedFileId","6207fa5a-a0e9-11f1-846d-1607ee4eb77e","pinPreview",true,"pinMigrated","screenshotVersion","likeCount",0,"orgId","019e67ac-4804-7389-919c-595893261a36","tursoName","676024064d6d43e5a717da442928b526","tursoHostname","676024064d6d43e5a717da442928b526-val-town.aws-us-east-2.turso.io","tursoMeasuredAt",["D",1789494036282],"pinned","userPerm","r","valPerm","blobPerm","rw","emailPerm","sqlitePerm","projectPerm","telemetryPerm","user",{"_16":17,"_87":83},"org",{"_16":17,"_80":81,"_82":83,"_33":34,"_84":85,"_86":26},"branch",{"_68":69,"_20":70,"_18":71,"_72":19,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":-5,"_78":21,"_79":17},"isOwned","version",9,"main","022191b9-e638-42f5-bf55-ad07af4842ca","projectId","forkedBranchId","forkedBranchVersion","forkedProjectPrivacy","forkedProjectId","forkedProjectOrgId","projectName","userHandle","displayName","Joe Ross","avatar","https://avatars.githubusercontent.com/u/796145?v=4","tier","free","canRestrictVals","profileImageUrl","branchName","path","","adoptOrgId",{"_18":19,"_20":21,"_22":156,"_24":-5,"_25":26,"_27":28,"_29":28,"_30":31,"_32":-5,"_33":34,"_35":36,"_37":38,"_39":-5,"_40":-5,"_41":42,"_43":44,"_45":46,"_47":48,"_49":157,"_51":-5,"_52":53,"_54":53,"_55":56,"_57":56,"_58":56,"_59":53,"_60":53,"_61":158,"_63":159,"_65":160,"_67":26},"tree",[147,148],[147,148],"counts",{"_137":42,"_138":134,"_139":42,"_140":141,"_142":143},"contents",[111,112],"file","upstreamProject","upstreamBranch","emptyEnvVars","flags",[],"hasHttpFiles","grants","orgs","customDomains",{},{"_18":129,"_20":130,"_115":131,"_116":-5,"_117":71,"_118":132,"_119":38,"_22":133,"_68":134,"_122":100,"_124":135,"_126":26,"_127":-5,"_89":136},{"_18":113,"_20":114,"_115":36,"_116":-5,"_117":71,"_118":69,"_119":38,"_22":120,"_68":121,"_122":123,"_124":125,"_126":26,"_127":21,"_89":128},"3880369d-fc4d-47e8-822d-f34d9c39179a","main.ts","fileId","parentId","branchId","branchVersion","latest",["D",1787909765405],6,"fileType","http","content","// Val Town HTTP val\n// Usage: https:///?url=\n//\n// Fetches a CourtListener opinion via the official REST v4 API and\n// reflows the \"html_with_citations\" field into normal

tags, so\n// read-later tools (Readwise Reader, GoodLinks, etc.) render it as\n// flowing text instead of a fixed-width

 block.\n//\n// Requires a CourtListener API token, stored as a Val Town env var\n// named COURTLISTENER_TOKEN. Get one at:\n// https://www.courtlistener.com/help/api/rest/\n\nconst API_BASE = \"https://www.courtlistener.com/api/rest/v4\";\nconst FETCH_TIMEOUT_MS = 15_000;\n\n// --- Input validation -------------------------------------------------\n\n// Accepts a bare cluster ID (\"10931982\") or a full CourtListener\n// opinion URL (\"https://www.courtlistener.com/opinion/10931982/foo/\"\n// or without a trailing slug: \".../opinion/10931982\").\n// Anything else (including non-CourtListener URLs, javascript: URIs,\n// etc.) is rejected so it's never echoed back into the page unvalidated.\nfunction extractClusterId(input: string): string | null {\n  const trimmed = input.trim();\n\n  if (/^\\d+$/.test(trimmed)) return trimmed;\n\n  try {\n    const parsed = new URL(trimmed);\n    if (parsed.hostname !== \"www.courtlistener.com\") return null;\n    const match = parsed.pathname.match(/\\/opinion\\/(\\d+)(?:\\/|$)/);\n    return match ? match[1] : null;\n  } catch {\n    return null;\n  }\n}\n\n// --- Text reflow --------------------------------------------------------\n\n// CourtListener's opinion HTML lays out each line of the original\n// double-spaced court document as its own line, separated by a blank\n// line — including lines that are mid-sentence continuations of the\n// same paragraph. A blank line is therefore NOT a reliable paragraph\n// boundary. Instead, join consecutive lines into a running paragraph\n// and only break when a line ends a sentence (terminal punctuation)\n// or the next line is a standalone heading/caption.\n//\n// IMPORTANT: this operates on the HTML as markup, not as plain text.\n// It does not decode or re-encode entities, and it does not touch\n// anything inside a tag, so citation links embedded by CourtListener\n// (e.g. 123 N.J. 45) survive intact.\nfunction reflowOpinionHtml(raw: string): string {\n  // CourtListener does NOT wrap the whole opinion in a single .\n  // It closes 
, inserts a ... (or\n  // ... for unlinked citations),\n  // then reopens  — for EVERY citation in the\n  // document. Stripping only the first/last  tag leaves orphaned\n  // 
 pairs around every citation, which is what forces\n  // the browser back into monospace rendering mid-paragraph. All\n  // /
 tags must be stripped globally; the citation \n  // itself is left untouched so it renders as normal inline text.\n  let html = raw.replace(/<\\/?pre[^>]*>/gi, \"\");\n\n  // Strip form-feed page breaks and the page-number/docket-number\n  // furniture that sits right before them, e.g. \"A-2182-24\\n  19\\n\\f\".\n  html = html.replace(/\\n?\\s*A-[\\dA-Z-]+\\s*\\n+\\s*\\d+\\s*\\n*\\f/g, \"\\n\");\n  html = html.replace(/\\f/g, \"\\n\");\n\n  const rawLines = html\n    .split(\"\\n\")\n    .map((line) => line.trim())\n    .filter((line) => line.length > 0);\n\n  // A line ends a paragraph if it ends with sentence-terminal\n  // punctuation (allowing for a trailing HTML tag close, closing\n  // quote, or closing paren after it).\n  const endsParagraph = (line: string) =>\n    /[.?!][\"')\\u201d]?(<\\/[a-z]+>)?$/i.test(line);\n\n  // Lines that are always their own paragraph regardless of context:\n  // procedural headings and short ALL-CAPS captions (party names,\n  // case-style lines). Require at least 2 words so we don't misfire\n  // on short statutory abbreviations that happen to be all-caps.\n  const isStandaloneLine = (line: string) => {\n    if (\n      /^(PER CURIAM|BEFORE:|SUPERIOR COURT|APPELLATE DIVISION|DOCKET NO\\.|Argued |Before Judges)/i\n        .test(line)\n    ) return true;\n    const stripped = line.replace(/<[^>]+>/g, \"\");\n    return /^[A-Z][A-Z\\s,.'-]*$/.test(stripped) &&\n      stripped.trim().split(/\\s+/).length >= 2 &&\n      stripped.length >= 8;\n  };\n\n  const paragraphs: string[] = [];\n  let current: string[] = [];\n\n  for (const line of rawLines) {\n    if (isStandaloneLine(line)) {\n      if (current.length) paragraphs.push(current.join(\" \"));\n      paragraphs.push(line);\n      current = [];\n      continue;\n    }\n    current.push(line);\n    if (endsParagraph(line)) {\n      paragraphs.push(current.join(\" \"));\n      current = [];\n    }\n  }\n  if (current.length) paragraphs.push(current.join(\" \"));\n\n  return paragraphs\n    .map((p) => p.replace(/\\s+/g, \" \").trim())\n    .filter((p) => p.length > 0)\n    .map((p) => `${p}
`)\n    .join(\"\\n\");\n}\n\n// --- HTTP helpers ---------------------------------------------------\n\nasync function fetchWithTimeout(\n  input: string,\n  init: RequestInit,\n): Promise {\n  return fetch(input, {\n    ...init,\n    signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),\n  });\n}\n\nfunction escapeHtml(s: string): string {\n  return s\n    .replace(/&/g, \"&\")\n    .replace(//g, \">\")\n    .replace(/\"/g, \""\")\n    .replace(/'/g, \"'\");\n}\n\nfunction errorResponse(message: string, status: number): Response {\n  return new Response(message, {\n    status,\n    headers: { \"content-type\": \"text/plain; charset=utf-8\" },\n  });\n}\n\n// --- Main handler -----------------------------------------------------\n\nexport default async function (req: Request): Promise {\n  const url = new URL(req.url);\n  const target = url.searchParams.get(\"url\");\n\n  if (!target) {\n    return errorResponse(\n      \"Usage: ?url=\",\n      400,\n    );\n  }\n\n  const clusterId = extractClusterId(target);\n  if (!clusterId) {\n    return errorResponse(\n      \"Could not extract a CourtListener cluster ID from that input. \" +\n        \"Pass a courtlistener.com/opinion/... URL or a bare numeric cluster ID.\",\n      400,\n    );\n  }\n\n  const token = Deno.env.get(\"COURTLISTENER_TOKEN\");\n  if (!token) {\n    return errorResponse(\n      \"Missing COURTLISTENER_TOKEN environment variable.\",\n      500,\n    );\n  }\n\n  const authHeader = { Authorization: `Token ${token}` };\n\n  // --- Step 1: cluster lookup -----------------------------------------\n  let clusterRes: Response;\n  try {\n    clusterRes = await fetchWithTimeout(`${API_BASE}/clusters/${clusterId}/`, {\n      headers: authHeader,\n    });\n  } catch (err) {\n    return errorResponse(\n      `Network error contacting CourtListener (cluster lookup): ${String(err)}`,\n      502,\n    );\n  }\n\n  const clusterRawBody = await clusterRes.text();\n  if (!clusterRes.ok) {\n    return errorResponse(\n      `Cluster lookup failed: HTTP ${clusterRes.status}\\n${clusterRawBody}`,\n      502,\n    );\n  }\n\n  let cluster: any;\n  try {\n    cluster = JSON.parse(clusterRawBody);\n  } catch {\n    return errorResponse(\n      `Cluster lookup returned non-JSON (HTTP ${clusterRes.status}):\\n${clusterRawBody}`,\n      502,\n    );\n  }\n\n  const caseName: string = cluster.case_name || cluster.case_name_full ||\n    \"Untitled Opinion\";\n  const dateFiled: string = cluster.date_filed || \"\";\n  const court: string = cluster.court_id || \"\";\n  const subOpinionUrls: string[] = cluster.sub_opinions || [];\n  // Prefer CourtListener's own canonical URL over echoing the raw\n  // input back, so a bare cluster ID still produces a working link\n  // and we never render an unvalidated user-supplied href.\n  const canonicalUrl: string = cluster.absolute_url\n    ? `https://www.courtlistener.com${cluster.absolute_url}`\n    : `https://www.courtlistener.com/opinion/${clusterId}/`;\n\n  if (subOpinionUrls.length === 0) {\n    return errorResponse(\"No opinions found on this cluster.\", 404);\n  }\n\n  // --- Step 2: lead opinion lookup -------------------------------------\n  const opinionUrl = subOpinionUrls[0];\n  let opinionRes: Response;\n  try {\n    opinionRes = await fetchWithTimeout(opinionUrl, { headers: authHeader });\n  } catch (err) {\n    return errorResponse(\n      `Network error contacting CourtListener (opinion lookup): ${String(err)}`,\n      502,\n    );\n  }\n\n  const opinionRawBody = await opinionRes.text();\n  if (!opinionRes.ok) {\n    return errorResponse(\n      `Opinion lookup failed: HTTP ${opinionRes.status}\\n${opinionRawBody}`,\n      502,\n    );\n  }\n\n  let opinion: any;\n  try {\n    opinion = JSON.parse(opinionRawBody);\n  } catch {\n    return errorResponse(\n      `Opinion lookup returned non-JSON (HTTP ${opinionRes.status}):\\n${opinionRawBody}`,\n      502,\n    );\n  }\n\n  // html_with_citations is markup and must not be escaped.\n  // plain_text is plain text and MUST be escaped before use.\n  let bodyHtml: string;\n  if (opinion.html_with_citations) {\n    bodyHtml = reflowOpinionHtml(opinion.html_with_citations);\n  } else if (opinion.plain_text) {\n    bodyHtml = reflowOpinionHtml(escapeHtml(opinion.plain_text));\n  } else {\n    return errorResponse(\"No opinion text available for this document.\", 404);\n  }\n\n  const page = `\n\n\n\n\n\n\n${escapeHtml(caseName)}\n\n\n\n${escapeHtml(caseName)}
\n${escapeHtml(court)}${\n    dateFiled ? \" · \" + escapeHtml(dateFiled) : \"\"\n  } · Original on CourtListener
\n${bodyHtml}\n\n`;\n\n  return new Response(page, {\n    headers: { \"content-type\": \"text/html; charset=utf-8\" },\n  });\n}","deleted","label",[114],"942fdb48-653a-42e9-9eb8-fd248a9e7653","README.md","83498afc-a0ea-11f1-a302-1607ee4eb77e",4,["D",1787706476391],1,"# courtlistener-reflow\n\nReformats CourtListener opinions for better read-later parsing.\n\n## Problem\n\nCourtListener serves opinion text wrapped in a single ``\nblock, with hard line-wraps and page-break characters baked into the source. On\ncourtlistener.com this is styled to look normal, but read-later tools like\nReadwise Reader and GoodLinks strip site CSS and fall back to default ``\nrendering — a fixed-width, non-wrapping code block.\n\n## What this does\n\nGiven a CourtListener opinion URL, this val:\n\n1. Extracts the cluster ID from the URL.\n2. Looks up the cluster and its lead opinion via the CourtListener REST v4 API.\n3. Reflows the opinion's `html_with_citations` field: strips page-break\n   artifacts, joins hard-wrapped lines back into paragraphs, and re-wraps\n   everything in `` tags.\n4. Returns a clean, minimally-styled HTML page that read-later tools parse\n   normally.\n\n## Setup\n\n1. Get a free CourtListener API token from your\n   [CourtListener profile](https://www.courtlistener.com/help/api/rest/).\n2. In this val's settings, add an environment variable/secret named\n   `COURTLISTENER_TOKEN` with that value.\n3. Save. Val Town deploys automatically — no separate deploy step.\n\n## Usage\n\n```\nhttps://joeross-courtlistenerreflow.web.val.run/?url=\n```\n\n`url` accepts either a full opinion URL or a bare cluster ID.\n\n### Bookmarklet\n\nFrom any CourtListener opinion page, run:\n\n```\njavascript:location.href='https://joeross-courtlistenerreflow.web.val.run/?url='+encodeURIComponent(location.href)\n```\n\nThis redirects to the cleaned version, which can then be saved to Readwise\nReader or GoodLinks as usual.\n\n## Notes / known limitations\n\n- Only the lead opinion (`sub_opinions[0]`) is fetched. Concurrences and\n  dissents are not included.\n- Page-break stripping assumes a docket-number-then-page-number pattern (e.g.\n  `A-2182-24` followed by a page number before a form feed). Courts with\n  different pagination formatting may leak stray page numbers into the text.\n- CourtListener's free-tier API rate limit is 5 requests/minute, 50/hour,\n  125/day. Fine for one-off bookmarklet use; a constraint if wired into bulk/RSS\n  processing.\n\n## Credits\n\nBuilt with [Claude](https://claude.com).",[130],"pulls","branches","forks","envVars",{"_144":134,"_146":42},"connections",{"_144":42,"_145":42},"count","unfilledCount","emptyCount",{"_18":129,"_20":130,"_115":131,"_116":-5,"_117":71,"_118":132,"_119":38,"_22":153,"_68":134,"_122":100,"_124":135,"_126":26,"_127":-5,"_150":154,"_89":155},{"_18":113,"_20":114,"_115":36,"_116":-5,"_117":71,"_118":69,"_119":38,"_22":149,"_68":121,"_122":123,"_124":125,"_126":26,"_127":21,"_150":151,"_89":152},["D",1787909765405],"children",[],[114],["D",1787706476391],[],[130],["D",1787705965716],["D",1789494036282],{"_16":17,"_87":83},{"_16":17,"_80":81,"_82":83,"_33":34,"_84":85,"_86":26},{"_68":69,"_20":70,"_18":71,"_72":19,"_73":-5,"_74":-5,"_75":-5,"_76":-5,"_77":-5,"_78":21,"_79":17},"ctx",{"_61":-5,"_108":194,"_195":196,"_197":198,"_199":26,"_200":26,"_201":26,"_202":38,"_203":-5,"_204":-7,"_205":-7,"_206":42,"_207":26,"_208":26,"_209":-5,"_210":26,"_211":26,"_212":26,"_213":-5},"ENV",{"_165":166,"_167":168,"_169":70,"_170":171,"_172":173,"_174":175,"_176":177,"_178":179,"_180":181,"_182":183,"_184":185,"_186":187,"_188":189,"_190":191,"_192":193},"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"]

Search