CHANGELOG.md

Changelog

4.30.3 (2023-01-30)

Bug Fixes

• added support for "missing" matcher (#1905) (f30e178)
• correctly match params in edge runtime (#1896) (75c0535)

4.30.2 (2023-01-24)

Bug Fixes

• custom headers for root route when using i18n (#1893) (9be3382)
• handle v1 edge function definition (#1903) (cdcf60e)

4.30.1 (2023-01-23)

Bug Fixes

• added polyfill for process.env (#1889) (15af7c7)
• correctly handle ISR for appDir pages (#1855) (f2a7cac)
• correctly rewrite default locale ISR homepage to ODB handler (#1867) (14ad486)
• getMaxAge is not used in APIHandlers (#1888) (d0343b8)
• match edge runtime pages with optional trailing slash (#1892) (138b19d)
• transform Regex named capture groups for Golang (#1809) (15790aa)

4.30.0 (2023-01-09)

Features

• add Next 13 request header mutation to middleware (#1866) (5d60191)

Bug Fixes

• deps: update dependency @netlify/functions to ^1.4.0 (#1869) (3960c31)
• deps: update dependency @netlify/ipx to ^1.3.3 (#1868) (d75d0ff)
• merge Middleware and API route response cookies (#1870) (878ddd7)
• serve static files from basePath (#1850) (d4ff894)

4.29.4 (2022-12-19)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.3.2 (#1833) (fb4d816)
• support appDir (#1638) (a5b8047)
• use static 404 for non-prerendered dynamic routes without fallback (#1795) (2aa02db)

4.29.3 (2022-12-05)

Bug Fixes

• assign globals to self (#1823) (993766b)
• better headers.getAll polyfill (#1801) (84579c1)
• get source file for page in api routes (#1778) (2a3ad3c)

4.29.2 (2022-11-21)

Bug Fixes

• add longitude, latitude, and timezone to RequestData.geo (#1777) (3f35549)
• resolve all pages using nft (#1780) (267ff0b)

4.29.1 (2022-11-14)

Bug Fixes

• exclude sourcemaps from bundle (#1772) (4cad33e)
• polyfill headers.getAll (#1766) (b400efb)
• revert publish from subdirectory (#1771) (0554d6a)

4.29.0 (2022-11-11)

Features

• add next debug logging (#1761) (9607031)

4.28.7 (2022-11-11)

Bug Fixes

• publish from subdirectory (#1756) (1faf191)

4.28.6 (2022-11-07)

Bug Fixes

• exclude swc by default, and don't exclude sharp if included (#1745) (383c186)

4.28.5 (2022-11-07)

Bug Fixes

• resolve _app deps in API routes (#1738) (df6fcda)

4.28.4 (2022-11-02)

Bug Fixes

• only split extended routes to decrease build times (#1731) (1e6fb8c)

4.28.3 (2022-10-27)

Bug Fixes

• disable minimal mode for API routes (#1727) (da8f440)

4.28.2 (2022-10-26)

Bug Fixes

• follow redirects when downloading a file from the CDN (#1719) (1d27a99)

4.28.1 (2022-10-25)

Bug Fixes

• use process.env.URL when deploying to production (#1680) (4b08911)

4.28.0 (2022-10-25)

Features

• add support for WebAssembly in edge runtime (#1676) (530088c)
• support Next 13 (#1714) (efcb47a)

4.27.3 (2022-10-19)

Bug Fixes

• correctly handle matchers with lookaheads and i18n (#1693) (9d440ab)

4.27.2 (2022-10-19)

Bug Fixes

• handle custom publish dir for api routes (#1697) (c24a520)

4.27.1 (2022-10-18)

Bug Fixes

• gracefully handle missing static analysis tools (#1691) (34a039e)

4.27.0 (2022-10-17)

Features

• split api routes into separate functions (#1495) (654c6de)

4.26.0 (2022-10-17)

Features

• use display names for edge functions (#1669) (310292a)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.3.1 (#1686) (2b419a0)
• prevent Next from defining duplicate global property in edge functions (#1682) (730df6b)

4.25.0 (2022-10-12)

Features

• cache redirects for 60 seconds if no ttl provided (#1677) (23d8d3b)

4.24.3 (2022-10-06)

Bug Fixes

• remove localPrefix (#1665) (571c0f5)

4.24.2 (2022-10-05)

Bug Fixes

• validate next/image params (#1661) (c0937cf)

4.24.1 (2022-10-05)

Bug Fixes

• deps: update dependency @netlify/functions to ^1.3.0 (#1660) (4e7e2ae)
• set undefined ODB 404 TTLs to 60 seconds (#1647) (029b497)

4.24.0 (2022-10-03)

Features

• Add ability to disable ipx (#1653) (ee7ceda)

4.23.4 (2022-10-03)

Bug Fixes

• correctly enable edge images (#1631) (8bcbad0)

4.23.3 (2022-09-28)

Bug Fixes

• add missing data to middleware request object (#1634) (0c05726)

4.23.2 (2022-09-26)

Bug Fixes

• check NEXT_DISABLE_NETLIFY_EDGE value rather than if truthy (#1603) (5cf8c52)
• deps: update dependency @netlify/esbuild to v0.14.39 (#1623) (3dc7b23)

4.23.1 (2022-09-09)

Bug Fixes

• respect variable set in Netlify config (#1613) (18c4663)

4.23.0 (2022-09-09)

Features

• add support for Next 12.3 middleware matchers (#1612) (fd88b98)

Bug Fixes

• correct handling of edge dev utils (#1616) (62c135d)
• deps: update dependency @netlify/ipx to ^1.2.5 (#1615) (362d5dd)
• support non-prerendered dynamic routes with fallback false (#1541) (92a015c)

4.22.0 (2022-09-08)

Features

• support updated remotePatterns configuration (#1607) (e7bed15)

4.21.3 (2022-09-08)

Bug Fixes

• handle stricter Next type (#1597) (368ab3c)

4.21.2 (2022-09-06)

Bug Fixes

• clean up edge functions during build (#1588) (ae2c103)
• deps: update dependency @netlify/ipx to ^1.2.4 (#1590) (70d38ca)
• watch for creation of middleware (#1592) (3ae0ee6)

4.21.1 (2022-08-31)

Bug Fixes

• remove Next.js as a peer dependency (#1584) (6be4dc0)

4.21.0 (2022-08-30)

Features

• only run next-dev middleware in dev (#1582) (9baf979)

4.20.0 (2022-08-26)

Features

• improve messaging on middleware detection (#1575) (73d6b8e)

4.19.0 (2022-08-25)

Features

• allows disabling function size check (#1570) (6a046de)

4.18.1 (2022-08-25)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.2.3 (#1571) (471ce8d)

4.18.0 (2022-08-22)

Features

• ✨ change over to next-runtime (#1540) (7ecf41d)
• add edge middleware support to ntl dev (#1546) (b208ff4)
• default edge middleware to on (#1547) (9578fa9)
• graph: populate graph token for ISR (#1525) (573b913)
• skip run if @netlify/plugin-nextjs installed (#1536) (0b4cf8c)
• support custom response headers on images served via IPX (#1515) (40cb8a9)

Bug Fixes

• check for middleware manifest before providing to Object.keys (#1559) (f500f51)
• deps: update dependency @netlify/functions to ^1.1.0 (#1526) (8a98d72)
• deps: update dependency @netlify/functions to ^1.2.0 (#1543) (81381eb)
• deps: update dependency @netlify/ipx to ^1.2.1 (#1534) (086a703)
• deps: update dependency @netlify/ipx to ^1.2.2 (#1544) (097e624)
• ensure newly-created middleware works (#1558) (39f3b4b)
• handle missing config base (#1555) (f69d9db)
• use individual next/server deno imports (#1556) (0667662)

4.17.0 (2022-08-17)

Features

• ✨ change over to next-runtime (#1540) (7ecf41d)
• graph: populate graph token for ISR (#1525) (573b913)
• skip run if @netlify/plugin-nextjs installed (#1536) (0b4cf8c)
• support custom response headers on images served via IPX (#1515) (40cb8a9)

Bug Fixes

• deps: update dependency @netlify/functions to ^1.1.0 (#1526) (8a98d72)
• deps: update dependency @netlify/functions to ^1.2.0 (#1543) (81381eb)
• deps: update dependency @netlify/ipx to ^1.2.1 (#1534) (086a703)
• deps: update dependency @netlify/ipx to ^1.2.2 (#1544) (097e624)

4.16.0 (2022-08-15)

Features

• graph: populate graph token for ISR (#1525) (573b913)

Bug Fixes

• deps: update dependency @netlify/functions to ^1.1.0 (#1526) (8a98d72)
• deps: update dependency @netlify/ipx to ^1.2.1 (#1534) (086a703)

4.15.0 (2022-08-12)

Features

• support custom response headers on images served via IPX (#1515) (40cb8a9)

4.14.2 (2022-08-11)

Bug Fixes

• allow proxy of /_next/static (#1503) (4efef60)
• deps: update dependency @netlify/ipx to ^1.1.4 (#1512) (44bdb1f)
• deps: update dependency @netlify/ipx to ^1.2.0 (#1516) (b90bf3e)

4.14.1 (2022-08-03)

Bug Fixes

• replace netlify:edge identifier with full URL (#1500) (69327e6)

4.14.0 (2022-08-01)

Features

• add enhanced middleware support (#1479) (689b2ac)

4.13.1 (2022-07-25)

Bug Fixes

• update patch syntax (#1480) (11f4ef1)

4.13.0 (2022-07-21)

Features

• dx updates to default demo site (#1447) (0d194fc)

Bug Fixes

• add better error messaging for builds (#1467) (1d90f68)

4.12.2 (2022-07-13)

Bug Fixes

• include css files in handler functions (#1463) (ebdf991)

4.12.1 (2022-07-12)

Bug Fixes

• copy imageconfig into edge function dir (#1462) (58ba162)

4.12.0 (2022-07-12)

Features

• get client IP from Context object rather than header (#1460) (30b6717)

4.11.2 (2022-07-12)

Bug Fixes

• explicitly type image config in ipx edge function (#1457) (a96af92)

4.11.1 (2022-06-30)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.1.3 (#1441) (9a72c0c)

4.11.0 (2022-06-30)

Features

• use edge functions for content negotiation by default (#1438) (0bac0e0)

4.10.1 (2022-06-29)

Bug Fixes

• check for Middleware manifest & chain (#1435) (afe65eb)

4.10.0 (2022-06-29)

Features

• middleware warning (#1425) (3c56eda)

4.9.3 (2022-06-24)

Bug Fixes

• handle missing manifest functions field (#1416) (5114193)

4.9.2 (2022-06-23)

Bug Fixes

• deps: upgrade ipx (#1409) (050ddcc)

4.9.1 (2022-06-14)

Bug Fixes

• check for existence of experimental images (#1392) (db004fa)

4.9.0 (2022-06-14)

Features

• add support for experimental image remotePatterns (#1375) (9095c82)

Bug Fixes

• deps: update dependency @netlify/ipx to ^1.1.0 (#1377) (9ed5c38)
• run edge middleware on data requests (#1382) (55755df)

4.8.0 (2022-06-06)

Features

• added better custom header support (#1358) (46d8f3a)

4.7.1 (2022-05-25)

Bug Fixes

• deps: update dependency @netlify/ipx to v1 (#1343) (4ab9ff4)
• don't override user defined NEXTAUTH_URL (#1360) (9010da3)

4.7.0 (2022-05-02)

Features

• Include basePath property in NEXTAUTH_URL when present in config (#1336) (346aad1)

4.6.0 (2022-04-28)

Features

• Add support for next-i18next (#1331) (5780e6b)

4.5.0 (2022-04-26)

Features

• ✨ add out-of-the-box support for NextAuth.js (#1309) (45c0978)

4.4.4 (2022-04-26)

Bug Fixes

• handle absolute rewrite URLs (#1325) (f8f8e85)

4.4.3 (2022-04-25)

Bug Fixes

• pass x-middleware-rewrite header to client (#1322) (ed17658)

4.4.2 (2022-04-19)

Bug Fixes

• include edge templates in the bundle (#1317) (b9d3abf)

4.4.1 (2022-04-19)

Bug Fixes

• copy edge src file (#1315) (ccdb544)

4.4.0 (2022-04-19)

Features

• add support for Edge Functions (#1310) (d39ce27)

Changelog

4.3.2 (2022-04-04)

Bug Fixes

• 🐛 include terser bundle into netlify functions (#1295) (f29adf3)

4.3.1 (2022-03-28)

Bug Fixes

• correctly find site root when using SSR with Nx (#1281) (3b26573)

4.3.0 (2022-03-23)

Features

• allow skipping of middleware handling (#1277) (63070da)

Bug Fixes

• deps: update dependency @vercel/node-bridge to v2.2.0 (#1246) (3637fff)

4.2.8 (2022-03-21)

Bug Fixes

• add new /trace to HIDDEN_PATHS (#1259) (84345a8)
• chdir to site root (#1265) (8463bbc)
• deps: update dependency @netlify/ipx to ^0.0.10 (#1237) (16e067d)
• use correct publishDir when building from CLI with cwd option (#1264) (e441c97)

4.2.7 (2022-02-18)

Bug Fixes

• correctly cache when using next export (#1223) (a8030ca)
• deps: update dependency @netlify/functions to ^0.11.1 (#1217) (e17892b)
• deps: update dependency @netlify/functions to v1 (#1219) (af841cd)

4.2.6 (2022-02-14)

Bug Fixes

• prepend basePath to static file URLs (#1213) (8236b38)

4.2.5 (2022-02-07)

Bug Fixes

• remove confusing error log (#1199) (7974849)

4.2.4 (2022-02-03)

Bug Fixes

• correctly disable ISR disk flushing (#1190) (e8067bf)

4.2.3 (2022-02-02)

Bug Fixes

• don't use ODB for routes that match middleware (#1171) (bbcdfbd)

4.2.2 (2022-01-31)

Bug Fixes

• deps: update dependency @netlify/ipx to ^0.0.9 (#1181) (2e55a9e)

4.2.1 (2022-01-24)

Bug Fixes

• deps: update dependency @netlify/functions to ^0.11.0 (#1146) (4da630b)
• deps: update dependency core-js to v3.20.3 (#1155) (043ad36)
• provide hostname and port to server (#1149) (02053fd)

4.2.0 (2022-01-17)

Features

• add request logging (#1127) (010e86c)

4.1.3 (2022-01-13)

Bug Fixes

• handle routes-manifests without staticRoutes defined (#1120) (96f3ccb)

4.1.2 (2022-01-11)

Bug Fixes

• add specific rewrites for all SSR routes (#1105) (6fd7bcc)
• deps: update dependency core-js to v3.20.2 (#1095) (41966ca)

4.1.1 (2021-12-21)

Bug Fixes

• fix bug that caused ISR pages to sometimes serve first built version (#1051) (62660b2)
• force React to use production env (#1056) (eca0bee)

4.1.0 (2021-12-17)

Features

• add support for use with next export (#1012) (76edc53)

Bug Fixes

• prevent infinite loop when / is ISR (#1020) (55b18e6)

4.0.0 (2021-12-14)

This is a full rewrite of the Essential Next.js plugin, with a new architecture that gives greater compatibility and stability.

What's new

• Full support for incremental static regeneration (ISR).
• Full support for Next.js rewrites, redirects and headers.
• Beta support for Next 12 Middleware
• Faster builds and deploys. Instead of generating one function per route, there are just three functions per site and a much smaller list of rewrites.
• Full support for Netlify's new persistent On-Demand Builders. Return fallback: "blocking" from getStaticPaths and your rendering will be deferred until the first page load, then persisted globally.
• A new image server for next/image, built on Nuxt's ipx. This is a high-performance, framework-agnostic image server based on sharp. This implementation uses On-Demand Builders to persist transformed images globally. Improved source image caching reduces time-to-first-byte for new transforms.
• Simplified configuration. You no longer need to set any Netlify-specific configuration options. For example, in a monorepo all you need to do is set publish to point to your .next directory and you can build the site in any way you like.
• Removes requirement for the target to be set to serverless, which is deprecated in Next 12.
• Bundling now uses Next.js's own node-file-trace, giving more predictable results and smaller uploads.

Breaking changes

The publish directory should point to the site's .next directory or distDir if set, rather than out as in previous versions of the plugin.

Migration guide

Change the publish directory to .next:

[build]
publish = ".next"

If you previously set these values, they're no longer needed and can be removed:

• target: "serverless" in your next.config.js
• distDir in your next.config.js
• node_bundler = "esbuild" in netlify.toml
• external_node_modules in netlify.toml

If you currently use redirects or rewrites on your site, see the Rewrites and Redirects guide for information on changes to how they are handled in this version.

If you want to use Next 12's beta Middleware feature, this will mostly work as expected but please read the docs on some caveats and workarounds that are currently needed.

4.0.0-rc.1 (2021-12-07)

Features

• enable TTL for all sites (#916) (152cf03)

Bug Fixes

• bypass preview for static files (#918) (ecb3cc8)
• work around a bug that caused a full response to be sent for images, even if the etag matched
• deps: update dependency @netlify/ipx to ^0.0.8 (#902) (25f375f)

4.0.0-rc.0 (2021-12-06)

Bug Fixes

• copy public directory output instead of input when using Nx (#856) (d959f82)
• correct root redirect when trailingSlash = false (#879) (3c6b10b)

4.0.0-beta.13 (2021-12-02)

Bug Fixes

• correct handling of data route JSON files (#864) (adea889)
• move locale detection to netlify redirects (#861) (964637b)

4.0.0-beta.12 (2021-11-30)

Features

• add experimental support for TTL (#833) (14ca14a)
• add support for Next env vars (#842) (24fd88a)

Miscellaneous Chores

• deps: update dependency @netlify/build to v19 (#840) (d927524)

4.0.0-beta.11 (2021-11-24)

Bug Fixes

• handle missing i18n object (#837) (3b6d293)

4.0.0-beta.10 (2021-11-24)

Bug Fixes

• replace node-fetch with builtin (#834) (6ff3100)
• correct redirect priority and correctly handle ISR pages assets (#826) (6b61643)
• deps: update dependency @netlify/functions to ^0.10.0 (#830) (3256839)
• don't move files to the CDN if they match redirect/rewrite rules (#832) (9e3dd0e)

4.0.0-beta.9 (2021-11-19)

Bug Fixes

• gracefully handle mssing middleware (#821) (4cee35d)

4.0.0-beta.8 (2021-11-19)

Features

• don't move files to CDN if they match middleware (#812) (615c97a)
• move static pages by default (#816) (12ce69e)

4.0.0-beta.7 (2021-11-17)

Features

• add docs on middleware (#795) (3b4a8c4)
• log warning if old functions exist (#801) (01faf58)

Bug Fixes

• deps: update dependency @netlify/functions to ^0.9.0 (#807) (3deec1d)
• ensure path is encoded (#800) (b0f666e)
• use forced catchall for preview mode (#793) (fd7130f)

Miscellaneous Chores

• add docs on rewrites and redirects (#767) (b32a08c)

4.0.0-beta.6 (2021-11-08)

Bug Fixes

• handle static file glob on Windows (#778) (1cc222a)
• use glob to select files to move (#768) (faeb703)

4.0.0-beta.5 (2021-11-03)

Bug Fixes

• add missing middleware runtime file (#762) (83378b4)
• deps: update dependency node-fetch to v2.6.6 (#758) (759915b)
• don't force rewrite in preview mode (#761) (c88a504)

4.0.0-beta.4 (2021-10-27)

Bug Fixes

• correctly resolve zip path (#744) (68b5662)
• deps: update dependency @netlify/functions to ^0.8.0 (#747) (2c87e30)
• exclude electron by default (#746) (887b90a)

4.0.0-beta.3 (2021-10-26)

Features

• support moving static pages out of function bundle (#728) (3da9c77)
• warn if zip is too large, and log the largest files (#730) (9989c0a)

Bug Fixes

• disable serverless targets (#739) (01fa113)
• ensure stale-while-revalidate headers are not sent (#737) (ef2da0d)
• typo in readme (#731) (bfc016f)
• use nft for ipx bundle (#725) (0321f68)
• use platform-agnostic paths, and add test to be sure (#736) (d448b11)

4.0.0-beta.2 (2021-10-19)

Features

• Enable persistent builders by default (#716) (de07dc2)

Bug Fixes

• correctly exclude files (#720) (efba43e)
• pass query string to handler (#719) (ff09cae)

4.0.0-beta.1 (2021-10-15)

Bug Fixes

• pass correct path to odb (#702) (7c5a8ae)

Miscellaneous Chores

• update min build version (#704) (3e1930f)

4.0.0-beta.0 (2021-10-15)

A complete rewrite of the Essential Next plugin. See the README for details and migration instructions