{"record":{"id":"fa3ed70e2d6ca411","repo":"withastro/astro","slug":"update-your-adapter-to-use-entrypointresolution","errorCode":null,"errorMessage":"Update your adapter to use `entrypointResolution: \"auto\"` or contact the maintainers to update.","messagePattern":"Update your adapter to use `entrypointResolution: \"auto\"` or contact the maintainers to update\\.","errorType":"console","errorClass":null,"httpStatus":null,"severity":"warning","filePath":"packages/astro/src/core/dev/adapter-validation.ts","lineNumber":56,"sourceCode":"\t\t\tthrow new AstroError({\n\t\t\t\t...AstroErrorData.AdapterSupportOutputMismatch,\n\t\t\t\tmessage: AstroErrorData.AdapterSupportOutputMismatch.message(adapter.name),\n\t\t\t\thint: adapterRecommendation ? adapterRecommendation : undefined,\n\t\t\t});\n\t\t} else if (command === 'dev') {\n\t\t\tlogger.warn(\n\t\t\t\tnull,\n\t\t\t\t`The adapter ${adapter.name} does not support emitting a server output, but the project contain server-rendered pages. Your project will not build correctly.`,\n\t\t\t);\n\t\t}\n\t}\n\n\tif (adapter.entrypointResolution === undefined) {\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t`The adapter ${adapter.name} uses \\`entrypointResolution: \"explicit\"\\` by default, which is deprecated and will be removed in a future major version.`,\n\t\t);\n\t\tlogger.warn(\n\t\t\tnull,\n\t\t\t'Update your adapter to use \\`entrypointResolution: \"auto\"\\` or contact the maintainers to update.',\n\t\t);\n\t}\n}\n","sourceCodeStart":38,"sourceCodeEnd":62,"githubUrl":"https://github.com/withastro/astro/blob/52e6c34790cc8ac4e69e6135ace06049867e5c4a/packages/astro/src/core/dev/adapter-validation.ts#L38-L62","documentation":"Companion line to the entrypointResolution deprecation warning: after stating the adapter uses the deprecated 'explicit' default, Astro prints the remediation — update the adapter to entrypointResolution: 'auto' or contact the adapter maintainers. It always appears together with the first warning, once per validation.","triggerScenarios":"Identical to the paired warning: an adapter registered with entrypointResolution === undefined triggers both logger.warn calls in sequence.","commonSituations":"Same contexts as the deprecation itself: community adapters, internal forks, or adapters pinned to old versions after Astro introduced the field.","solutions":["Adapter authors: set entrypointResolution: 'auto' in the adapter object","Users: update the adapter package to a version that declares entrypointResolution","If unmaintained, fork it or file an issue referencing the deprecation"],"exampleFix":"// before — adapter object without the field\nconst adapter = { name: '@you/astro-adapter', /* ... */ };\n\n// after\nconst adapter = {\n  name: '@you/astro-adapter',\n  entrypointResolution: 'auto',\n  /* ... */\n};","handlingStrategy":"validation","validationCode":"// same guard as the paired deprecation\nconst adapter = myAdapter();\nif (adapter.entrypointResolution === undefined) {\n  throw new Error('Update the adapter to entrypointResolution: \"auto\"');\n}","typeGuard":null,"tryCatchPattern":null,"preventionTips":["Fix the underlying missing field rather than silencing the paired warnings","Users: update or patch third-party adapters instead of forking around the check","Keep adapter integration tests asserting the adapter object's shape"],"tags":["adapter","deprecation","entrypoint"],"backgroundTag":"deprecated-adapter-api","analyzedSha":"52e6c34790cc8ac4e69e6135ace06049867e5c4a","analyzedAt":"2026-08-18T18:48:03.901Z","contentChangedAt":"2026-08-18T18:48:03.901Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}