perf: replace http-status with numeric constants

[AlessioGr]

Written by AI (Codex). The measurements were also run by AI.

What

Payload only uses 12 numeric status codes from http-status, but importing its status object also retains descriptions and aliases. Replace it with a small internal httpStatus constant map and remove the dependency from payload and @payloadcms/next.

Benchmark Results

Written by AI. I think the most notable improvement is reducing our risk for supply chain attacks by having one less package.

Fresh website template (Next.js 16.4.0, React 19.3.0, Turbopack), locally packed packages from main at ed6a954c47 and that commit plus only this PR.

Each run deletes .next, starts next dev, then fetches either /admin first or / followed by /admin and /api/pages, without a browser. Times include compilation and rendering and are medians of 6 interleaved runs per scenario, following an unrecorded warmup.

Cold next dev, 4 threads	main	This PR
Server component modules for /admin	1108	1108
SSR modules for /admin	468	468
Browser modules for /admin	603	603
All modules for /admin	2250	2250
/admin response, opened first	4.43 s	4.44 s
/admin response, after front-end	2.42 s	2.42 s

No observed changes here.

Production website bundles, using the same next build and browser-measurement harness as the earlier perf PRs:

Production JS	main	This PR
All emitted client chunks, minified	3707.30 KiB	3686.32 KiB
All emitted client chunks, gzip	1146.11 KiB	1138.80 KiB
Dashboard JS, decoded	2420.84 KiB	2399.86 KiB
Dashboard JS, gzip	755.82 KiB	748.50 KiB
Edit view with date picker, gzip	755.97 KiB	748.66 KiB

As a focused check, bundling the actual APIError module with esbuild 0.27.1 (ESM, browser, ES2022, minified) falls from 21.26 KiB to 0.62 KiB, or 7.41 KiB to 0.40 KiB gzip. This isolates the removed status table from unrelated application code.

[github-actions]

📦 esbuild Bundle Analysis for payload

This analysis was generated by esbuild-bundle-analyzer. 🤖

Meta File	Out File	Size (raw)	Note
packages/next/meta_index.json	esbuild/index.js	242.21 KB	⚠️ +27.44 KB (+12.8%)
packages/payload/meta_index.json	esbuild/index.js	1.87 MB	⚠️ +78.98 KB (+4.4%)
packages/payload/meta_shared.json	esbuild/exports/shared.js	542.54 KB	✅ -6.77 KB (-1.2%)
packages/richtext-lexical/meta_client.json	esbuild/exports/client_optimized/index.js	296.15 KB	⚠️ +9.65 KB (+3.4%)
packages/ui/meta_client.json	esbuild/exports/client_optimized/index.js	1.29 MB	‼️ +1.25 MB (+3434.3%)
packages/ui/meta_shared.json	esbuild/exports/shared_optimized/index.js	18.98 KB	⚠️ +34 B (+0.2%)

Largest paths

These visualization shows top 20 largest paths in the bundle.

Meta file: packages/next/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ████████████████████████▋ }}}$ 98.9%, 237.09 KB
dist/adapters/router.js	${{\color{Goldenrod}{ }}}$ 0.3%, 718 B
dist/adapters/server.js	${{\color{Goldenrod}{ }}}$ 0.2%, 533 B
dist/adapters/layout.js	${{\color{Goldenrod}{ }}}$ 0.2%, 529 B
dist/adapters/views.js	${{\color{Goldenrod}{ }}}$ 0.1%, 324 B
dist/utilities/initAdminContext.js	${{\color{Goldenrod}{ }}}$ 0.1%, 315 B
dist/utilities/selectiveCache.js	${{\color{Goldenrod}{ }}}$ 0.1%, 263 B
dist/esbuildEntry.js	${{\color{Goldenrod}{ }}}$ 0.0%, 0 B

Meta file: packages/payload/meta_index.json, Out file: esbuild/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ █████████████████▊ }}}$ 71.0%, 1.32 MB
dist/collections/operations	${{\color{Goldenrod}{ ▋ }}}$ 2.9%, 54.67 KB
dist/fields/hooks	${{\color{Goldenrod}{ ▋ }}}$ 2.5%, 46.14 KB
dist/auth/operations	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 16.95 KB
dist/globals/operations	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 16.18 KB
dist/utilities/configToJSONSchema.js	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 16.02 KB
dist/queues/operations	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 14.31 KB
dist/fields/config	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 13.65 KB
dist/utilities/telemetry	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 11.90 KB
dist/collections/config	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 11.74 KB
dist/fields/validations.js	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 10.82 KB
dist/cli/commands	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 9.92 KB
dist/config/orderable	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 8.76 KB
dist/uploads/fetchAPI-multipart	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 8.38 KB
dist/database/migrations	${{\color{Goldenrod}{ }}}$ 0.4%, 8.16 KB
dist/config/sanitize.js	${{\color{Goldenrod}{ }}}$ 0.4%, 8.09 KB
dist/hierarchy/utils	${{\color{Goldenrod}{ }}}$ 0.4%, 7.66 KB
dist/index.js	${{\color{Goldenrod}{ }}}$ 0.4%, 7.54 KB
dist/auth/strategies	${{\color{Goldenrod}{ }}}$ 0.4%, 7.36 KB
dist/utilities/entityInputSchema	${{\color{Goldenrod}{ }}}$ 0.4%, 7.34 KB
(other)	${{\color{Goldenrod}{ ███████▏ }}}$ 29.0%, 537.79 KB

Meta file: packages/payload/meta_shared.json, Out file: esbuild/exports/shared.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ██████████████████████ }}}$ 88.2%, 474.42 KB
dist/fields/validations.js	${{\color{Goldenrod}{ ▌ }}}$ 2.0%, 10.79 KB
dist/fields/config	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 5.83 KB
dist/utilities/traverseFields.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 4.34 KB
dist/utilities/deepCopyObject.js	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 3.52 KB
dist/collections/config	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 3.41 KB
dist/config/orderable	${{\color{Goldenrod}{ ▏ }}}$ 0.6%, 3.13 KB
dist/fields/baseFields	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 2.79 KB
dist/config/client.js	${{\color{Goldenrod}{ ▏ }}}$ 0.5%, 2.58 KB
dist/auth/cookies.js	${{\color{Goldenrod}{ }}}$ 0.3%, 1.55 KB
dist/utilities/flattenTopLevelFields.js	${{\color{Goldenrod}{ }}}$ 0.3%, 1.42 KB
dist/utilities/getVersionsConfig.js	${{\color{Goldenrod}{ }}}$ 0.2%, 1.04 KB
dist/globals/config	${{\color{Goldenrod}{ }}}$ 0.2%, 957 B
dist/uploads/generatePayloadFileURL.js	${{\color{Goldenrod}{ }}}$ 0.2%, 864 B
dist/utilities/unflatten.js	${{\color{Goldenrod}{ }}}$ 0.2%, 850 B
dist/utilities/flattenAllFields.js	${{\color{Goldenrod}{ }}}$ 0.1%, 798 B
dist/utilities/sanitizeUserDataForEmail.js	${{\color{Goldenrod}{ }}}$ 0.1%, 713 B
dist/auth/extractJWT.js	${{\color{Goldenrod}{ }}}$ 0.1%, 696 B
dist/utilities/getFieldPermissions.js	${{\color{Goldenrod}{ }}}$ 0.1%, 651 B
dist/utilities/fieldPath.js	${{\color{Goldenrod}{ }}}$ 0.1%, 639 B
(other)	${{\color{Goldenrod}{ ██▉ }}}$ 11.8%, 63.18 KB

Meta file: packages/richtext-lexical/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
dist/features/blocks	${{\color{Goldenrod}{ ███▋ }}}$ 14.6%, 42.74 KB
dist/lexical/plugins	${{\color{Goldenrod}{ ██▉ }}}$ 11.8%, 34.51 KB
dist/lexical/ui	${{\color{Goldenrod}{ ██▊ }}}$ 11.4%, 33.54 KB
dist/features/table	${{\color{Goldenrod}{ ██▎ }}}$ 9.4%, 27.46 KB
dist/features/link	${{\color{Goldenrod}{ █▋ }}}$ 6.5%, 18.92 KB
dist/features/toolbars	${{\color{Goldenrod}{ █▌ }}}$ 6.3%, 18.41 KB
dist/features/upload	${{\color{Goldenrod}{ █▏ }}}$ 4.9%, 14.28 KB
dist/features/textState	${{\color{Goldenrod}{ ▉ }}}$ 3.8%, 11.08 KB
dist/lexical/utils	${{\color{Goldenrod}{ ▊ }}}$ 3.4%, 10.02 KB
dist/features/relationship	${{\color{Goldenrod}{ ▊ }}}$ 3.2%, 9.43 KB
dist/features/converters	${{\color{Goldenrod}{ ▋ }}}$ 2.9%, 8.41 KB
dist/utilities/fieldsDrawer	${{\color{Goldenrod}{ ▋ }}}$ 2.8%, 8.12 KB
dist/features/debug	${{\color{Goldenrod}{ ▋ }}}$ 2.5%, 7.40 KB
dist/lexical/config	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 5.14 KB
dist/features/indent	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 4.19 KB
dist/features/lists	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 3.67 KB
dist/lexical/LexicalEditor.js	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.33 KB
dist/features/format	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.28 KB
dist/features/horizontalRule	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 3.18 KB
dist/field/Field.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 3.05 KB
(other)	${{\color{Goldenrod}{ █████████████████████▎ }}}$ 85.4%, 250.20 KB

Meta file: packages/ui/meta_client.json, Out file: esbuild/exports/client_optimized/index.js

Path	Size
../../node_modules	${{\color{Goldenrod}{ ███████▍ }}}$ 29.9%, 382.60 KB
dist/elements/Hierarchy	${{\color{Goldenrod}{ ▉ }}}$ 3.5%, 44.52 KB
dist/elements/BulkUpload	${{\color{Goldenrod}{ ▌ }}}$ 2.4%, 30.50 KB
dist/elements/Table	${{\color{Goldenrod}{ ▌ }}}$ 2.2%, 28.21 KB
dist/views/Version	${{\color{Goldenrod}{ ▌ }}}$ 2.2%, 27.83 KB
dist/views/Edit	${{\color{Goldenrod}{ ▍ }}}$ 1.7%, 22.13 KB
dist/views/HierarchyList	${{\color{Goldenrod}{ ▍ }}}$ 1.7%, 21.59 KB
dist/views/Dashboard	${{\color{Goldenrod}{ ▍ }}}$ 1.5%, 19.53 KB
dist/elements/WhereBuilder	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 17.66 KB
dist/providers/Auth	${{\color{Goldenrod}{ ▎ }}}$ 1.4%, 17.41 KB
dist/fields/Relationship	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 16.23 KB
dist/forms/Form	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 16.02 KB
dist/fields/Upload	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 14.95 KB
dist/fields/Blocks	${{\color{Goldenrod}{ ▎ }}}$ 1.2%, 14.91 KB
dist/views/List	${{\color{Goldenrod}{ ▎ }}}$ 1.1%, 13.50 KB
dist/elements/Popup	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 13.27 KB
dist/elements/ReactSelect	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 12.98 KB
dist/elements/QueryPresets	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 10.82 KB
dist/elements/FileManager	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 10.32 KB
dist/elements/Upload	${{\color{Goldenrod}{ ▏ }}}$ 0.7%, 9.45 KB
(other)	${{\color{Goldenrod}{ █████████████████▌ }}}$ 70.1%, 896.68 KB

Meta file: packages/ui/meta_shared.json, Out file: esbuild/exports/shared_optimized/index.js

Path	Size
dist/graphics/Logo	${{\color{Goldenrod}{ ███████▋ }}}$ 30.7%, 5.61 KB
../../node_modules	${{\color{Goldenrod}{ ███▌ }}}$ 14.5%, 2.65 KB
dist/graphics/Icon	${{\color{Goldenrod}{ ██ }}}$ 8.3%, 1.51 KB
dist/utilities/formatDocTitle	${{\color{Goldenrod}{ █▊ }}}$ 7.2%, 1.32 KB
dist/providers/TableColumns	${{\color{Goldenrod}{ █▏ }}}$ 4.7%, 866 B
dist/utilities/getGlobalData.js	${{\color{Goldenrod}{ █ }}}$ 4.2%, 762 B
dist/utilities/api.js	${{\color{Goldenrod}{ █ }}}$ 4.1%, 756 B
dist/utilities/groupNavItems.js	${{\color{Goldenrod}{ █ }}}$ 4.1%, 745 B
dist/elements/Translation	${{\color{Goldenrod}{ ▋ }}}$ 2.7%, 493 B
dist/utilities/handleTakeOver.js	${{\color{Goldenrod}{ ▌ }}}$ 2.4%, 440 B
dist/utilities/traverseForLocalizedFields.js	${{\color{Goldenrod}{ ▌ }}}$ 2.3%, 419 B
dist/elements/withMergedProps	${{\color{Goldenrod}{ ▍ }}}$ 1.9%, 339 B
dist/utilities/getNavGroups.js	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 338 B
dist/utilities/getVisibleEntities.js	${{\color{Goldenrod}{ ▍ }}}$ 1.8%, 329 B
dist/elements/WithServerSideProps	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 232 B
dist/layouts/Root	${{\color{Goldenrod}{ ▎ }}}$ 1.3%, 230 B
dist/utilities/handleGoBack.js	${{\color{Goldenrod}{ ▎ }}}$ 1.0%, 180 B
dist/fields/mergeFieldStyles.js	${{\color{Goldenrod}{ ▏ }}}$ 0.9%, 158 B
dist/forms/Form	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 152 B
dist/utilities/handleBackToDashboard.js	${{\color{Goldenrod}{ ▏ }}}$ 0.8%, 152 B
(other)	${{\color{Goldenrod}{ █████████████████▎ }}}$ 69.3%, 12.68 KB

Details

Next to the size is how much the size has increased or decreased compared with the base branch of this PR.

• ‼️: Size increased by 20% or more. Special attention should be given to this.
• ⚠️: Size increased in acceptable range (lower than 20%).
• ✅: No change or even downsized.
• 🗑️: The out file is deleted: not found in base branch.
• 🆕: The out file is newly found: will be added to base branch.

[github-actions]

🚀 This is included in version v4.0.0-canary.39