chore: fix typescript strict-mode errors (#10)

`nuxt typecheck` reported 89 errors against the strict server tsconfig
(noUncheckedIndexedAccess + missing @types/node). Production builds
and dev server worked despite this — the build step uses a looser
config — but the editor was a sea of red.

- Add @types/node so Buffer / process / node:* imports resolve
- Add types/assets.d.ts shim for Leaflet *.png URL imports
- Guard regex-match index access (m?.[1] / m?.[1] ?? '') across all
  parsers (boe + zvg-portal) — every parser had the same `if (m) m[1]`
  pattern that strict mode rejects
- Narrow useFetch generics to `T | null` in pages/index.vue so the
  `default: () => null` initialiser type-checks; pin `applyFilters`
  with explicit `<GeoAuction>` so .lat/.lng access doesn't widen back
  to Auction
- Type `courts` computed as `string[]` (Set was inferred as unknown)
- Guard fotos[0]/items[idx]/data[0] against possibly-undefined index
  reads in geocode + zvg-portal/index + zvg-portal/detail

Co-authored-by: haex <mail@haex.space>

Author: haexhub

package.json

@@ -34,6 +34,7 @@
   "devDependencies": {
     "@nuxt/icon": "^2.2.1",
     "@types/leaflet": "^1.9.21",
+    "@types/node": "^25.6.0",
     "@vitejs/plugin-vue": "^5.2.4",
     "@vueuse/core": "^14.3.0",
     "typescript": "~5.6"

pages/index.vue

@@ -45,7 +45,7 @@ const queryParams = computed(() => ({
 }))
 
 // Lazy fetch so SSR doesn't block on a cold multi-region crawl.
-const { data, pending, error, refresh } = useLazyFetch<CrawlResult>('/api/auctions', {
+const { data, pending, error, refresh } = useLazyFetch<CrawlResult | null>('/api/auctions', {
   query: queryParams,
   default: () => null,
 })
@@ -66,7 +66,7 @@ const {
   error: geoError,
   execute: loadGeo,
   refresh: refreshGeo,
-} = useFetch<GeoCrawlResult>('/api/auctions-geo', {
+} = useFetch<GeoCrawlResult | null>('/api/auctions-geo', {
   query: {
     country: selectedCountry,
     region: selectedRegion,
@@ -169,7 +169,7 @@ const headerLabel = computed(() => {
     : selectedCountryLabel.value
 })
 
-const courts = computed(() => {
+const courts = computed<string[]>(() => {
   if (!data.value) return []
   return [...new Set(data.value.auctions.map((a) => a.amtsgericht).filter(Boolean))].sort()
 })
@@ -226,7 +226,7 @@ const filtered = computed<Auction[]>(() => {
 
 const filteredGeo = computed<GeoAuction[]>(() => {
   if (!geoData.value) return []
-  return applyFilters(geoData.value.auctions).filter((a) => a.lat != null && a.lng != null)
+  return applyFilters<GeoAuction>(geoData.value.auctions).filter((a) => a.lat != null && a.lng != null)
 })
 
 const totals = computed(() => {

pnpm-lock.yaml

@@ -38,8 +38,8 @@ function extractTablePairs(html: string): Map<string, string> {
   const pairs = new Map<string, string>()
   const re = /<th[^>]*>([\s\S]*?)<\/th>\s*<td[^>]*>([\s\S]*?)<\/td>/g
   for (const m of html.matchAll(re)) {
-    const k = clean(m[1].replace(/<[^>]+>/g, ''))
-    const v = clean(m[2].replace(/<[^>]+>/g, ' '))
+    const k = clean((m[1] ?? '').replace(/<[^>]+>/g, ''))
+    const v = clean((m[2] ?? '').replace(/<[^>]+>/g, ' '))
     if (k) pairs.set(k.toLowerCase(), v)
   }
   return pairs

server/crawlers/boe/detail.ts

@@ -51,7 +51,7 @@ export function parseListingHtml(
 
   // "Resultados 1 a 77 de 77" — pull the total if present.
   const totalMatch = html.match(/Resultados[\s\S]{0,80}?de\s+(\d+)/i)
-  const totalReported = totalMatch ? parseInt(totalMatch[1], 10) : null
+  const totalReported = totalMatch?.[1] ? parseInt(totalMatch[1], 10) : null
 
   $('li.resultado-busqueda').each((_i, el) => {
     const $el = $(el)
@@ -73,12 +73,12 @@ export function parseListingHtml(
 
     // "Conclusión prevista: 25/05/2026 a las 18:00:00"
     const terminMatch = estadoLine.match(/Conclusión[^:]*:\s*([^\]]+)/i)
-    const terminText = terminMatch ? terminMatch[1].trim() : null
+    const terminText = terminMatch?.[1]?.trim() ?? null
     const terminIso = terminText ? parseSpanishDateTime(terminText) : null
 
     // Estado prefix before the bracket: "Estado: Celebrándose" → "Celebrándose"
     const estadoMatch = estadoLine.match(/Estado:\s*([^\-\[]+)/i)
-    const estadoLabel = estadoMatch ? estadoMatch[1].trim() : null
+    const estadoLabel = estadoMatch?.[1]?.trim() ?? null
 
     // Description and address are merged in the listing. Take the whole
     // string as `objekt` for now and let detail enrichment split it later.
@@ -88,7 +88,7 @@ export function parseListingHtml(
     let adresse: string | null = null
     if (descLine) {
       const cp = descLine.match(/(\d{5}\s+[^,]+?)(?:\s*\(|$)/)
-      if (cp) adresse = `${cp[1].trim()}, España`
+      if (cp?.[1]) adresse = `${cp[1].trim()}, España`
     }
 
     const detailUrlUpstream = `${BOE_BASE}/detalleSubasta.php?idSub=${encodeURIComponent(idSub)}`

server/crawlers/boe/list.ts

@@ -20,7 +20,7 @@ export function clean(s: string): string {
 /** Parses Spanish-formatted Euro amounts like `88.029,53 €` → 88029.53. */
 export function parseEuroEs(text: string): number | null {
   const m = decodeEntities(text).replace(/\s| /g, '').match(/([\d.]+,\d{2})/)
-  if (!m) return null
+  if (!m?.[1]) return null
   const n = m[1].replace(/\./g, '').replace(',', '.')
   const num = parseFloat(n)
   return Number.isFinite(num) ? num : null
@@ -32,7 +32,7 @@ export function parseEuroEs(text: string): number | null {
 export function parseSpanishDateTime(text: string): string | null {
   const m = text.match(/(\d{1,2})[\/.](\d{1,2})[\/.](\d{4})(?:\s*(?:a las|,)?\s*(\d{1,2}):(\d{2})(?::(\d{2}))?)?/)
   if (!m) return null
-  const [, d, mo, y, hh, mm, ss] = m
+  const [, d = '', mo = '', y = '', hh, mm, ss] = m
   const day = d.padStart(2, '0')
   const mon = mo.padStart(2, '0')
   const time = hh ? `T${hh.padStart(2, '0')}:${mm}:${ss ?? '00'}` : 'T00:00:00'

server/crawlers/boe/text.ts

@@ -50,8 +50,8 @@ export async function fetchDetailPage(zvgId: string, landAbk: string): Promise<D
     if (!anchor.length) return
     const href = anchor.attr('href') || ''
     const fileIdMatch = href.match(/file_id=(\d+)/)
-    if (!fileIdMatch) return
-    const fileId = fileIdMatch[1]
+    const fileId = fileIdMatch?.[1]
+    if (!fileId) return
     if (seenFileIds.has(fileId)) return
     seenFileIds.add(fileId)
 
@@ -76,7 +76,7 @@ export async function fetchDetailPage(zvgId: string, landAbk: string): Promise<D
   // Beschreibung is in the same column as Objekt/Lage. Extract the full block.
   let beschreibung: string | null = null
   const beschrMatch = html.match(/Beschreibung[^<]*<\/td>\s*<td[^>]*>([\s\S]*?)<\/td>/i)
-  if (beschrMatch) {
+  if (beschrMatch?.[1]) {
     const text = beschrMatch[1].replace(/<br\s*\/?>/gi, '\n').replace(/<[^>]+>/g, ' ')
     const cleaned = decodeEntities(text).replace(/[ \t]+/g, ' ').replace(/\n[ \t]+/g, '\n').trim()
     if (cleaned.length > 0) beschreibung = cleaned
@@ -96,7 +96,7 @@ export async function enrichInBatches<T extends { zvgId: string }>(
     while (cursor < items.length) {
       const idx = cursor++
       const item = items[idx]
-      if (!/^\d+$/.test(item.zvgId)) continue
+      if (!item || !/^\d+$/.test(item.zvgId)) continue
       try {
         const info = await fetchDetailPage(item.zvgId, landAbk)
         enricher(item, info)

server/crawlers/zvg-portal/detail.ts

@@ -40,8 +40,9 @@ async function crawl(opts: CrawlOptions): Promise<CrawlResult> {
       auction.beschreibung = info.beschreibung
       const fotos = info.attachments.filter((a) => a.kind === 'foto')
       auction.fotoCount = fotos.length
-      if (fotos.length > 0) {
-        auction.thumbnailUrl = `/api/zvg-thumb?file_id=${fotos[0].fileId}&zvg_id=${auction.zvgId}&land_abk=${landAbk}`
+      const firstFoto = fotos[0]
+      if (firstFoto) {
+        auction.thumbnailUrl = `/api/zvg-thumb?file_id=${firstFoto.fileId}&zvg_id=${auction.zvgId}&land_abk=${landAbk}`
       }
     })
   }

server/crawlers/zvg-portal/index.ts

@@ -10,7 +10,7 @@ export interface ParseResult {
 
 export function parseAuctionsHtml(html: string, landAbk: string, platformId: string): ParseResult {
   const totalMatch = html.match(/Insgesamt\s+(\d+)/)
-  const totalReported = totalMatch ? parseInt(totalMatch[1], 10) : null
+  const totalReported = totalMatch?.[1] ? parseInt(totalMatch[1], 10) : null
 
   // Each entry block is delimited by the comment markers + a final <hr>.
   // Strategy: split the raw HTML at "<!--Aktenzeichen--->" and parse each chunk.
@@ -27,7 +27,7 @@ export function parseAuctionsHtml(html: string, landAbk: string, platformId: str
     let terminIso: string | null = null
     let aufgehoben = false
     const terminMatch = chunk.match(/<TR>\s*<TD[^>]*>\s*Termin\s*<\/[Tt][Dd]>([\s\S]*?)<\/[Tt][Rr]>/i)
-    if (terminMatch) {
+    if (terminMatch?.[1]) {
       const inner = terminMatch[1].replace(/<[^>]+>/g, ' ')
       const decoded = clean(inner)
       aufgehoben = /aufgehoben/i.test(decoded)
@@ -45,15 +45,15 @@ export function parseAuctionsHtml(html: string, landAbk: string, platformId: str
       aktenzeichen = aktenzeichenA.text().replace(/\(Detailansicht\)/i, '').trim()
     } else {
       const azMatch = chunk.match(/<nobr>\s*(\d+\s+K\s+\d+\/\d+)\s*(?:&nbsp;)?\s*(?:\(Detailansicht\))?\s*<\/nobr>/i)
-      if (azMatch) aktenzeichen = azMatch[1].trim()
+      if (azMatch?.[1]) aktenzeichen = azMatch[1].trim()
     }
     aktenzeichen = clean(aktenzeichen)
     if (!aktenzeichen && !zvgIdMatch) continue
 
     const zvgId = zvgIdMatch || `az:${aktenzeichen}`
 
     const updateMatch = chunk.match(/letzte Aktualisierung\s+([\d-]+\s+[\d:]+)/)
-    const letzteAktualisierungIso = updateMatch ? parseGermanTimestamp(updateMatch[1]) : null
+    const letzteAktualisierungIso = updateMatch?.[1] ? parseGermanTimestamp(updateMatch[1]) : null
 
     let amtsgericht = ''
     // Region name comes from landAbk (canonical), not from the HTML.
@@ -68,7 +68,7 @@ export function parseAuctionsHtml(html: string, landAbk: string, platformId: str
     // themselves contain " in " (e.g. "Landau in der Pfalz"), so split on the
     // LAST occurrence.
     const amtMatch = chunk.match(/<!--Amtsgericht--->[\s\S]*?<b>\s*([^<]+?)\s*<\/b>/i)
-    if (amtMatch) {
+    if (amtMatch?.[1]) {
       const inner = clean(amtMatch[1])
       const sep = inner.lastIndexOf(' in ')
       amtsgericht = sep >= 0 ? inner.slice(0, sep) : inner
@@ -77,15 +77,15 @@ export function parseAuctionsHtml(html: string, landAbk: string, platformId: str
     let objekt: string | null = null
     let adresse: string | null = null
     const lageMatch = chunk.match(/<b>([^<]+?)<!--Lage--->\s*:?\s*<\/b>\s*([^<\n]+)/)
-    if (lageMatch) {
+    if (lageMatch?.[1] && lageMatch[2]) {
       objekt = clean(lageMatch[1])
       adresse = clean(lageMatch[2])
     }
 
     let verkehrswertEur: number | null = null
     let verkehrswertText: string | null = null
     const vwMatch = chunk.match(/Verkehrswert in[\s\S]*?<b>([\s\S]*?)<\/b>/)
-    if (vwMatch) {
+    if (vwMatch?.[1]) {
       const inner = vwMatch[1].replace(/<[^>]+>/g, ' ')
       verkehrswertText = clean(inner) || null
       verkehrswertEur = parseEuro(inner)
@@ -94,11 +94,11 @@ export function parseAuctionsHtml(html: string, landAbk: string, platformId: str
     let pdfUrl: string | null = null
     let pdfUrlUpstream: string | null = null
     const pdfMatch = chunk.match(/href="([^"]*showAnhang[^"]*)"/i)
-    if (pdfMatch) {
+    if (pdfMatch?.[1]) {
       const raw = pdfMatch[1].trim().replace(/\s+$/, '')
       pdfUrlUpstream = `${ZVG_BASE}/${raw.replace(/^\/+/, '')}`
       const fileIdMatch = raw.match(/file_id=(\d+)/)
-      if (fileIdMatch && zvgIdMatch) {
+      if (fileIdMatch?.[1] && zvgIdMatch) {
         pdfUrl = `/api/zvg-proxy?button=showAnhang&land_abk=${landAbk}&file_id=${fileIdMatch[1]}&zvg_id=${zvgIdMatch}`
       }
     }

server/crawlers/zvg-portal/list.ts

@@ -8,7 +8,8 @@ export function parseGermanDateTime(text: string): string | null {
   // "Donnerstag, 07. Mai 2026, 10:00 Uhr"
   const m = text.match(/(\d{1,2})\.\s*(\p{L}+)\s+(\d{4}),?\s*(\d{1,2}):(\d{2})/u)
   if (!m) return null
-  const [, d, monthName, y, hh, mm] = m
+  const [, d = '', monthName, y, hh = '', mm] = m
+  if (!monthName) return null
   const month = MONTH_DE[monthName]
   if (!month) return null
   return `${y}-${month}-${d.padStart(2, '0')}T${hh.padStart(2, '0')}:${mm}:00`
@@ -25,15 +26,15 @@ export function parseGermanTimestamp(text: string): string | null {
 export function parseEuro(text: string): number | null {
   // "214.000,00 Euro" or "800.000,00" or "16.100,00 "
   const m = text.replace(/\s| /g, '').match(/([\d.]+,\d{2})/)
-  if (!m) return null
+  if (!m?.[1]) return null
   const n = m[1].replace(/\./g, '').replace(',', '.')
   const num = parseFloat(n)
   return Number.isFinite(num) ? num : null
 }
 
 export function parseFileSize(text: string): number | null {
   const m = text.match(/([\d.,]+)\s*(kB|MB|KB|B)/i)
-  if (!m) return null
+  if (!m?.[1] || !m[2]) return null
   // The portal mixes formats: "1.234,56" (German thousands+decimal) and "188.25" (English decimal).
   // Heuristic: a comma marks the decimal; otherwise a single dot followed by 1-2 digits is the decimal.
   let s = m[1]