Balíček s moderní exports mapou rozbije webpack build (Next 14)

import { Aside } from ‘@astrojs/starlight/components’;

Server-only balíčky (ZIP archivace, PDF generátory, headless browser) rovnou externalizuj — webpack je bundlovat nepotřebuje a novější `exports` mapy starší webpack neparsuje.

Symptom

next build spadne s:

./node_modules/<balicek>/lib/core.js
Module not found: Default condition should be last one

Typecheck (tsc --noEmit) přitom projde bez chyb a kód funguje v čistém Node — chyba se projeví až ve webpack fázi buildu.

Root cause

Novější major verze knihovny přidala do package.json podmíněnou exports mapu, kde podmínka default není poslední (nebo používá kombinace, které starší webpack ve frameworku neumí vyhodnotit). Webpack zabudovaný ve starším frameworku (např. Next 14) exports mapu odmítne a build selže — přestože runtime require() v Node funguje normálně.

Fix

Balíček externalizovat — framework ho pak nebundluje a načítá runtime require() z node_modules:

// next.config.mjs (Next 14)
const nextConfig = {
  experimental: {
    serverComponentsExternalPackages: ["<balicek>"],
  },
};
// Next 15+: serverExternalPackages (mimo experimental)

Downgrade knihovny je horší řešení — ztrácíš opravy a při příštím npm update se problém vrátí.

Jak ověřit

1. npm run build projde.
2. Runtime smoke test endpointu, který balíček používá (externalizace = jiný způsob načtení, ověř na živém/staging).

Poznámky

• Projeví se jen u balíčků importovaných ze server route/komponenty; klientský kód externalizovat nejde.
• Build gate (build MUSÍ gatovat deploy) tuhle chybu spolehlivě chytí před produkcí — typecheck ji nechytí nikdy.