feat: upper case the name of the endpoints (#7783)

Co-authored-by: Bjorn Lu <bjornlu.dev@gmail.com>
Co-authored-by: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com>
Co-authored-by: Chris Swithinbank <swithinbank@gmail.com>

.changeset/twelve-coats-rush.md

@@ -0,0 +1,35 @@
+---
+'astro': major
+---
+
+Lowercase names for endpoint functions are now deprecated.
+
+Rename functions to their uppercase equivalent:
+
+```diff
+- export function get() {
++ export function GET() {
+    return new Response(JSON.stringify({ "title": "Bob's blog" }));
+}
+
+- export function post() {
++ export function POST() {
+    return new Response(JSON.stringify({ "title": "Bob's blog" }));
+}
+
+- export function put() {
++ export function PUT() {
+    return new Response(JSON.stringify({ "title": "Bob's blog" }));
+}
+
+- export function all() {
++ export function ALL() {
+    return new Response(JSON.stringify({ "title": "Bob's blog" }));
+}
+
+// you can use the whole word "DELETE"
+- export function del() {
++ export function DELETE() {
+    return new Response(JSON.stringify({ "title": "Bob's blog" }));
+}
+```

packages/astro/src/assets/image-endpoint.ts

@@ -24,7 +24,7 @@ async function loadRemoteImage(src: URL) {
 /**
  * Endpoint used in dev and SSR to serve optimized images by the base image services
  */
-export const get: APIRoute = async ({ request }) => {
+export const GET: APIRoute = async ({ request }) => {
 	try {
 		const imageService = await getConfiguredImageService();
 

packages/astro/src/core/endpoint/index.ts

@@ -7,13 +7,13 @@ import type {
 	Params,
 } from '../../@types/astro';
 import type { Environment, RenderContext } from '../render/index';
-
 import { renderEndpoint } from '../../runtime/server/index.js';
 import { ASTRO_VERSION } from '../constants.js';
 import { AstroCookies, attachToResponse } from '../cookies/index.js';
 import { AstroError, AstroErrorData } from '../errors/index.js';
 import { warn } from '../logger/core.js';
 import { callMiddleware } from '../middleware/callMiddleware.js';
+
 const clientAddressSymbol = Symbol.for('astro.clientAddress');
 const clientLocalsSymbol = Symbol.for('astro.locals');
 
@@ -119,11 +119,11 @@ export async function callEndpoint<MiddlewareResult = Response | EndpointOutput>
 			onRequest as MiddlewareEndpointHandler,
 			context,
 			async () => {
-				return await renderEndpoint(mod, context, env.ssr);
+				return await renderEndpoint(mod, context, env.ssr, env.logging);
 			}
 		);
 	} else {
-		response = await renderEndpoint(mod, context, env.ssr);
+		response = await renderEndpoint(mod, context, env.ssr, env.logging);
 	}
 
 	if (response instanceof Response) {

packages/astro/src/runtime/server/endpoint.ts

@@ -1,28 +1,56 @@
 import type { APIContext, EndpointHandler, Params } from '../../@types/astro';
+import { type LogOptions, warn } from '../../core/logger/core.js';
 
-function getHandlerFromModule(mod: EndpointHandler, method: string) {
+function getHandlerFromModule(mod: EndpointHandler, method: string, logging: LogOptions) {
+	const lowerCaseMethod = method.toLowerCase();
+
+	// TODO: remove in Astro 4.0
+	if (mod[lowerCaseMethod]) {
+		warn(
+			logging,
+			'astro',
+			`Lower case endpoint names are deprecated and will not be supported in Astro 4.0. Rename the endpoint ${lowerCaseMethod} to ${method}.`
+		);
+	}
 	// If there was an exact match on `method`, return that function.
 	if (mod[method]) {
 		return mod[method];
 	}
+
+	// TODO: remove in Astro 4.0
+	if (mod[lowerCaseMethod]) {
+		return mod[lowerCaseMethod];
+	}
+	// TODO: remove in Astro 4.0
 	// Handle `del` instead of `delete`, since `delete` is a reserved word in JS.
 	if (method === 'delete' && mod['del']) {
 		return mod['del'];
 	}
+	// TODO: remove in Astro 4.0
 	// If a single `all` handler was used, return that function.
 	if (mod['all']) {
 		return mod['all'];
 	}
+	if (mod['ALL']) {
+		return mod['ALL'];
+	}
 	// Otherwise, no handler found.
 	return undefined;
 }
 
 /** Renders an endpoint request to completion, returning the body. */
-export async function renderEndpoint(mod: EndpointHandler, context: APIContext, ssr: boolean) {
+export async function renderEndpoint(
+	mod: EndpointHandler,
+	context: APIContext,
+	ssr: boolean,
+	logging: LogOptions
+) {
 	const { request, params } = context;
-	const chosenMethod = request.method?.toLowerCase();
+
-	const handler = getHandlerFromModule(mod, chosenMethod);
+	const chosenMethod = request.method?.toUpperCase();
-	if (!ssr && ssr === false && chosenMethod && chosenMethod !== 'get') {
+	const handler = getHandlerFromModule(mod, chosenMethod, logging);
+	// TODO: remove the 'get' check in Astro 4.0
+	if (!ssr && ssr === false && chosenMethod && chosenMethod !== 'GET' && chosenMethod !== 'get') {
 		// eslint-disable-next-line no-console
 		console.warn(`
 ${chosenMethod} requests are not available when building a static site. Update your config to \`output: 'server'\` or \`output: 'hybrid'\` with an \`export const prerender = false\` to handle ${chosenMethod} requests.`);

packages/astro/test/fixtures/api-routes/src/pages/binary.dat.ts

@@ -1,5 +1,5 @@
 import type { APIRoute } from 'astro';
 
-export const get: APIRoute = async function () {
+export const GET: APIRoute = async function () {
   return new Response(new Uint8Array([0xff]));
 };

packages/astro/test/fixtures/api-routes/src/pages/context/data/[param].json.js

@@ -14,7 +14,7 @@ export function getStaticPaths() {
 	]
 }
 
-export function get({ params, request }) {
+export function GET({ params, request }) {
 	return {
 		body: JSON.stringify({
 			param: params.param,

packages/astro/test/fixtures/astro-cookies/src/pages/set-prefs.js

@@ -1,5 +1,5 @@
 
-export function post({ cookies }) {
+export function POST({ cookies }) {
 	const mode = cookies.get('prefs').json().mode;
 
 	cookies.set('prefs', {

packages/astro/test/fixtures/astro-get-static-paths/src/pages/data/[slug].json.ts

@@ -5,7 +5,7 @@ export async function getStaticPaths() {
     ];
 }
 
-export async function get() {
+export async function GET() {
     return {
         body: JSON.stringify({
             title: '[slug]'

packages/astro/test/fixtures/astro-markdown-frontmatter-injection/src/pages/glob.json.js

@@ -1,4 +1,4 @@
-export async function get() {
+export async function GET() {
 	const docs = await import.meta.glob('./*.md', { eager: true });
 	return {
 		body: JSON.stringify(Object.values(docs).map(doc => doc.frontmatter)),

packages/astro/test/fixtures/astro-markdown/src/pages/headings-glob.json.js

@@ -1,6 +1,6 @@
 import { getHeadings } from './with-layout.md';
 
-export async function get() {
+export async function GET() {
 	return {
 		body: JSON.stringify({
 			headings: getHeadings(),

packages/astro/test/fixtures/astro-markdown/src/pages/raw-content.json.js

@@ -1,6 +1,6 @@
 import { rawContent, compiledContent } from './basic.md';
 
-export async function get() {
+export async function GET() {
 	return {
 		body: JSON.stringify({
 			raw: rawContent(),

packages/astro/test/fixtures/astro-markdown/src/pages/vite-env-vars-glob.json.js

@@ -1,6 +1,6 @@
 import { frontmatter } from './vite-env-vars.md';
 
-export async function get() {
+export async function GET() {
 	return {
 		body: JSON.stringify(frontmatter),
 	}

packages/astro/test/fixtures/content-collection-references/src/pages/welcome-data.json.js

@@ -1,6 +1,6 @@
 import { getEntry, getEntries } from 'astro:content';
 
-export async function get() {
+export async function GET() {
 	const welcomePost = await getEntry('blog', 'welcome');
 
 	if (!welcomePost?.data) {

packages/astro/test/fixtures/content-collections/src/pages/collections.json.js

@@ -2,7 +2,7 @@ import { getCollection } from 'astro:content';
 import * as devalue from 'devalue';
 import { stripAllRenderFn } from '../utils.js';
 
-export async function get() {
+export async function GET() {
 	const withoutConfig = stripAllRenderFn(await getCollection('without-config'));
 	const withSchemaConfig = stripAllRenderFn(await getCollection('with-schema-config'));
 	const withSlugConfig = stripAllRenderFn(await getCollection('with-custom-slugs'));

packages/astro/test/fixtures/content-collections/src/pages/entries.json.js

@@ -2,7 +2,7 @@ import { getEntryBySlug } from 'astro:content';
 import * as devalue from 'devalue';
 import { stripRenderFn } from '../utils.js';
 
-export async function get() {
+export async function GET() {
 	const columbiaWithoutConfig = stripRenderFn(await getEntryBySlug('without-config', 'columbia'));
 	const oneWithSchemaConfig = stripRenderFn(await getEntryBySlug('with-schema-config', 'one'));
 	const twoWithSlugConfig = stripRenderFn(await getEntryBySlug('with-custom-slugs', 'interesting-two'));

packages/astro/test/fixtures/core-image-ssr/src/pages/api.ts

@@ -1,6 +1,6 @@
 import type { APIRoute } from "../../../../../src/@types/astro";
 
-export const get = (async ({ params, request }) => {
+export const GET = (async ({ params, request }) => {
 	const url = new URL(request.url);
   const src = url.searchParams.get("src");
 

packages/astro/test/fixtures/data-collections/src/pages/authors/[id].json.js

@@ -7,7 +7,7 @@ export function getStaticPaths() {
 }
 
 /** @param {import('astro').APIContext} params */
-export async function get({ params }) {
+export async function GET({ params }) {
 	const { id } = params;
 	const author = await getEntry('authors-without-config', id);
 	if (!author) {

packages/astro/test/fixtures/data-collections/src/pages/authors/all.json.js

@@ -1,6 +1,6 @@
 import { getCollection } from 'astro:content';
 
-export async function get() {
+export async function GET() {
 	const authors = await getCollection('authors-without-config');
 
 	return {

packages/astro/test/fixtures/data-collections/src/pages/translations/[lang].json.js

@@ -7,7 +7,7 @@ export function getStaticPaths() {
 }
 
 /** @param {import('astro').APIContext} params */
-export async function get({ params }) {
+export async function GET({ params }) {
 	const { lang } = params;
 	const translations = await getEntry('i18n', lang);
 	if (!translations) {

packages/astro/test/fixtures/data-collections/src/pages/translations/all.json.js

@@ -1,6 +1,6 @@
 import { getCollection } from 'astro:content';
 
-export async function get() {
+export async function GET() {
 	const translations = await getCollection('i18n');
 
 	return {

packages/astro/test/fixtures/dynamic-endpoint-collision/src/pages/api/catch/[...slug].ts

@@ -2,7 +2,7 @@ import type { APIRoute } from "astro";
 
 const slugs = ["one", undefined];
 
-export const get: APIRoute = ({ params }) => {
+export const GET: APIRoute = ({ params }) => {
   return {
     body: JSON.stringify({
       slug: params.slug || "index",

packages/astro/test/fixtures/middleware-dev/src/pages/api/endpoint.js

@@ -1,4 +1,4 @@
-export function get() {
+export function GET() {
 	const object = {
 		name: 'Endpoint!!',
 	};

packages/astro/test/fixtures/non-html-pages/src/pages/about.json.ts

@@ -1,7 +1,7 @@
 // Returns the file body for this non-HTML file.
 // The content type is based off of the extension in the filename,
 // in this case: about.json.
-export async function get() {
+export async function GET() {
 	return {
 		body: JSON.stringify({
 			name: 'Astro',

packages/astro/test/fixtures/non-html-pages/src/pages/placeholder.png.ts

@@ -2,7 +2,7 @@ import { promises as fs } from 'node:fs';
 
 import type { APIRoute } from 'astro';
 
-export const get: APIRoute = async function get() {
+export const GET: APIRoute = async function get() {
 	try {
 		// Image is in the public domain. Sourced from
 		// https://en.wikipedia.org/wiki/File:Portrait_placeholder.png

packages/astro/test/fixtures/routing-priority/src/pages/api/catch/[...slug].json.ts

@@ -1,6 +1,6 @@
 import type { APIRoute } from 'astro';
 
-export const get: APIRoute = async ({ params }) => {
+export const GET: APIRoute = async ({ params }) => {
   return {
     body: JSON.stringify({
       path: params.slug,

packages/astro/test/fixtures/routing-priority/src/pages/api/catch/[foo]-[bar].json.ts

@@ -1,6 +1,6 @@
 import type { APIRoute } from 'astro';
 
-export const get: APIRoute = async ({ params }) => {
+export const GET: APIRoute = async ({ params }) => {
   return {
     body: JSON.stringify({
       foo: params.foo,

packages/astro/test/fixtures/ssr-api-route-custom-404/src/pages/api/route.js

@@ -1,5 +1,5 @@
 
-export function post() {
+export function POST() {
 	return {
 		body: JSON.stringify({ ok: true })
 	};

packages/astro/test/fixtures/ssr-api-route/src/pages/binary.js

@@ -1,6 +1,6 @@
 import fs from 'node:fs';
 
-export function get() {
+export function GET() {
 	return {
 		body: 'ok'
 	};

packages/astro/test/fixtures/ssr-api-route/src/pages/context/[param].js

@@ -1,7 +1,7 @@
 /**
  * @param {import('astro').APIContext} api 
  */
-export function get(ctx) {
+export function GET(ctx) {
 	return {
 		body: JSON.stringify({
 			cookiesExist: !!ctx.cookies,

packages/astro/test/fixtures/ssr-api-route/src/pages/food.json.js

@@ -1,5 +1,5 @@
 
-export function get() {
+export function GET() {
 	return {
 		body: JSON.stringify([
 			{ name: 'lettuce' },
@@ -9,7 +9,7 @@ export function get() {
 	};
 }
 
-export async function post({ params, request }) {
+export async function POST({ params, request }) {
 	const body = await request.text();
 	return new Response(body === `some data` ? `ok` : `not ok`, {
 		status: 200,

packages/astro/test/fixtures/ssr-api-route/src/pages/login.js

@@ -1,5 +1,5 @@
 /** @type {import('astro').APIRoute} */
-export function post({ cookies }) {
+export function POST({ cookies }) {
 	cookies.set('foo', 'foo', {
 		httpOnly: true
 	});

packages/astro/test/fixtures/ssr-dynamic/src/pages/api/products/[id].js

@@ -1,5 +1,5 @@
 
-export function get({ params }) {
+export function GET({ params }) {
 	return {
 		body: JSON.stringify(params)
 	};

packages/astro/test/fixtures/ssr-locals/src/pages/api.js

@@ -1,5 +1,5 @@
 
-export async function get({ locals }) {
+export async function GET({ locals }) {
 	let out = { ...locals };
 
 	return new Response(JSON.stringify(out), {

packages/astro/test/fixtures/ssr-prerender-get-static-paths/src/pages/data/[slug].json.ts

@@ -7,7 +7,7 @@ export async function getStaticPaths() {
     ];
 }
 
-export async function get() {
+export async function GET() {
     return {
         body: JSON.stringify({
             title: '[slug]'

packages/astro/test/fixtures/static-build/src/pages/company.json.ts

@@ -1,4 +1,4 @@
-export async function get() {
+export async function GET() {
     return {
         body: JSON.stringify({
             name: 'Astro Technology Company',

packages/astro/test/fixtures/static-build/src/pages/data/[slug].json.ts

@@ -5,7 +5,7 @@ export async function getStaticPaths() {
     ]
 }
 
-export async function get({ params }) {
+export async function GET({ params }) {
     return {
         body: JSON.stringify({
             slug: params.slug,

packages/astro/test/fixtures/static-build/src/pages/posts.json.js

@@ -13,7 +13,7 @@ async function fetchPosts() {
     return posts.sort((a, b) => a.title.localeCompare(b.title));
 }
 
-export async function get() {
+export async function GET() {
     const posts = await fetchPosts();
 
     return {

packages/astro/test/fixtures/with-endpoint-routes/src/pages/[slug].json.ts

@@ -5,7 +5,7 @@ export async function getStaticPaths() {
     ];
 }
 
-export async function get({ params }) {
+export async function GET({ params }) {
     return {
         body: JSON.stringify({
             slug: params.slug,

packages/astro/test/fixtures/with-endpoint-routes/src/pages/data/[slug].json.ts

@@ -5,7 +5,7 @@ export async function getStaticPaths() {
     ];
 }
 
-export async function get({ params }) {
+export async function GET({ params }) {
     return {
         body: JSON.stringify({
             slug: params.slug,

packages/astro/test/fixtures/with-endpoint-routes/src/pages/home.json.ts

@@ -1,4 +1,4 @@
-export async function get() {
+export async function GET() {
     return {
         body: JSON.stringify({
             title: 'home'

packages/astro/test/fixtures/with-endpoint-routes/src/pages/images/[image].svg.ts

@@ -5,7 +5,7 @@ export async function getStaticPaths() {
 	];
 }
 
-export async function get({ params }) {
+export async function GET({ params }) {
 	return {
 			body: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 200">
 	<title>${params.image}</title>

packages/astro/test/fixtures/with-endpoint-routes/src/pages/images/hex.ts

@@ -1,6 +1,6 @@
 import { readFileSync } from "node:fs";
 
-export async function get({ params, request }) {
+export async function GET({ params, request }) {
   const buffer = readFileSync(new URL('../../astro.png', import.meta.url));
   return {
     body: buffer.toString('hex'),

packages/astro/test/fixtures/with-endpoint-routes/src/pages/images/static.svg.ts

@@ -1,4 +1,4 @@
-export async function get() {
+export async function GET() {
 	return {
 			body: `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 200">
 	<title>Static SVG</title>

packages/integrations/image/src/endpoint.ts

@@ -20,7 +20,7 @@ async function loadRemoteImage(src: URL) {
 	}
 }
 
-export const get: APIRoute = async ({ request }) => {
+export const GET: APIRoute = async ({ request }) => {
 	try {
 		const url = new URL(request.url);
 		const transform = loader.parseTransform(url.searchParams);

packages/integrations/markdoc/src/html/transform/html-token-transform.ts

@@ -1,4 +1,4 @@
-import { Tokenizer } from '@markdoc/markdoc';
+import type { Tokenizer } from '@markdoc/markdoc';
 import { Parser } from 'htmlparser2';
 import type * as Token from 'markdown-it/lib/token';