Add single method route helpers and BuildRoute type

Author: mjackson

AGENTS.md

@@ -25,6 +25,7 @@
 - **Classes**: Use native fields (omit `public`), `#private` for private members (no TypeScript accessibility modifiers)
 - **Formatting**: Prettier (printWidth: 100, no semicolons, single quotes, spaces not tabs)
 - **TypeScript**: Strict mode, ESNext target, ES2022 modules, bundler resolution, verbatimModuleSyntax
+- **Generics**: Use descriptive lowercase names for type parameters (e.g., `source`, `method`, `pattern`) instead of single uppercase letters like `T`, `P`, or `K`
 - **Comments**: Only add non-JSDoc comments when the code is doing something surprising or non-obvious
 
 ## Test Structure

packages/fetch-router/CHANGELOG.md

@@ -72,6 +72,24 @@ This is the changelog for [`fetch-router`](https://github.com/remix-run/remix/tr
 
   The `FormActionOptions` type has also been renamed to `FormOptions`.
 
+- Add functional aliases for creating routes that respond to a single request method
+
+  ```tsx
+  import { del, get, patch, post } from '@remix-run/fetch-router'
+
+  let routes = route({
+    home: get('/'),
+    login: post('/login'),
+    logout: post('/logout'),
+    profile: {
+      show: get('/profile'),
+      edit: get('/profile/edit'),
+      update: patch('/profile'),
+      destroy: del('/profile'),
+    },
+  })
+  ```
+
 ## v0.12.0 (2025-11-25)
 
 - BREAKING CHANGE: Moved all response helpers to `@remix-run/response`. Update your imports:
@@ -319,7 +337,6 @@ This is the changelog for [`fetch-router`](https://github.com/remix-run/remix/tr
 - Add support for `request.signal` abort, which now short-circuits the middleware chain. `router.fetch()` will now throw `DOMException` with `error.name === 'AbortError'` when a request is aborted
 - Fix an issue where `Router`'s `fetch` wasn't spec-compliant
 - Provide empty `context.formData` to `POST`/`PUT`/etc handlers when `parseFormData: false`
-- Add functional aliases for routes that respond to a single HTTP verb
 
 ## v0.6.0 (2025-10-10)
 

packages/fetch-router/src/index.ts

@@ -12,35 +12,35 @@ export type { RequestHandler, BuildRequestHandler } from './lib/request-handler.
 
 export type { Controller, Action, BuildAction } from './lib/controller.ts'
 
-export {
-  createDestroy,
-  createDestroy as destroy, // shorthand
-  createGet,
-  createGet as get, // shorthand
-  createHead,
-  createHead as head, // shorthand
-  createOptions,
-  createOptions as options, // shorthand
-  createPatch,
-  createPatch as patch, // shorthand
-  createPost,
-  createPost as post, // shorthand
-  createPut,
-  createPut as put, // shorthand
-} from './lib/route-helpers.ts'
-
 export {
   Route,
   createRoutes,
   createRoutes as route, // shorthand
 } from './lib/route-map.ts'
-export type { RouteMap, RouteDefs, RouteDef } from './lib/route-map.ts'
+export type { BuildRoute, RouteMap, RouteDefs, RouteDef } from './lib/route-map.ts'
 
 export { createRouter } from './lib/router.ts'
 export type { Router, RouterOptions } from './lib/router.ts'
 
 // Route helpers
 
+export {
+  createDeleteRoute,
+  createDeleteRoute as del, // shorthand
+  createGetRoute,
+  createGetRoute as get, // shorthand
+  createHeadRoute,
+  createHeadRoute as head, // shorthand
+  createOptionsRoute,
+  createOptionsRoute as options, // shorthand
+  createPatchRoute,
+  createPatchRoute as patch, // shorthand
+  createPostRoute,
+  createPostRoute as post, // shorthand
+  createPutRoute,
+  createPutRoute as put, // shorthand
+} from './lib/route-helpers/method.ts'
+
 export {
   createFormRoutes,
   createFormRoutes as form, // shorthand

packages/fetch-router/src/lib/route-helpers.ts

@@ -1,11 +1,19 @@
 import * as assert from 'node:assert/strict'
 import { describe, it } from 'node:test'
-
-import type { Assert, IsEqual } from './type-utils.ts'
-import { Route, createRoutes as route } from './route-map.ts'
-import { destroy, get, head, options, patch, post, put } from '../index.ts'
 import { RoutePattern } from '@remix-run/route-pattern'
 
+import type { Assert, IsEqual } from '../type-utils.ts'
+import { Route, createRoutes as route } from '../route-map.ts'
+import {
+  createDeleteRoute as del,
+  createGetRoute as get,
+  createHeadRoute as head,
+  createOptionsRoute as options,
+  createPatchRoute as patch,
+  createPostRoute as post,
+  createPutRoute as put,
+} from './method.ts'
+
 describe('route helpers composition', () => {
   it('composes route helpers in a route map', () => {
     let routes = route({
@@ -16,7 +24,7 @@ describe('route helpers composition', () => {
         show: get('/posts/:id'),
         update: put('/posts/:id'),
         patch: patch('/posts/:id'),
-        destroy: destroy('/posts/:id'),
+        destroy: del('/posts/:id'),
       },
       api: {
         health: head('/api/health'),
@@ -42,7 +50,7 @@ describe('route helpers composition', () => {
         create: post('/'),
         show: get('/:id'),
         update: put('/:id'),
-        destroy: destroy('/:id'),
+        destroy: del('/:id'),
       },
     })
 
@@ -64,7 +72,7 @@ describe('route helpers composition', () => {
       about: '/about',
       contact: get('/contact'),
       login: post('/auth/login'),
-      logout: destroy('/auth/logout'),
+      logout: del('/auth/logout'),
       profile: {
         show: '/profile',
         edit: get('/profile/edit'),
@@ -88,7 +96,7 @@ describe('route helpers composition', () => {
         posts: get('/api/posts(/:lang)'),
         createPost: post('/api/posts'),
         updatePost: put('/api/posts/:id'),
-        deletePost: destroy('/api/posts/:id'),
+        deletePost: del('/api/posts/:id'),
       },
       healthCheck: head('/health'),
     })
@@ -108,7 +116,7 @@ let composedRoutes = route({
     createPost: post('/'),
     showPost: get(':id'),
     updatePost: put(':id'),
-    deletePost: destroy(':id'),
+    deletePost: del(':id'),
   }),
   api: {
     health: head('/api/health'),

…tch-router/src/lib/route-helpers.test.ts …ter/src/lib/route-helpers/method.test.tspackages/fetch-router/src/lib/route-helpers.test.ts renamed to packages/fetch-router/src/lib/route-helpers/method.test.ts packages/fetch-router/src/lib/route-helpers.test.ts renamed to packages/fetch-router/src/lib/route-helpers/method.test.ts

@@ -0,0 +1,66 @@
+import type { RoutePattern } from '@remix-run/route-pattern'
+
+import { Route } from '../route-map.ts'
+
+/**
+ * Shorthand for a DELETE route.
+ */
+export function createDeleteRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'DELETE', source> {
+  return new Route('DELETE', pattern)
+}
+
+/**
+ * Shorthand for a GET route.
+ */
+export function createGetRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'GET', source> {
+  return new Route('GET', pattern)
+}
+
+/**
+ * Shorthand for a HEAD route.
+ */
+export function createHeadRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'HEAD', source> {
+  return new Route('HEAD', pattern)
+}
+
+/**
+ * Shorthand for a OPTIONS route.
+ */
+export function createOptionsRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'OPTIONS', source> {
+  return new Route('OPTIONS', pattern)
+}
+
+/**
+ * Shorthand for a PATCH route.
+ */
+export function createPatchRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'PATCH', source> {
+  return new Route('PATCH', pattern)
+}
+
+/**
+ * Shorthand for a POST route.
+ */
+export function createPostRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'POST', source> {
+  return new Route('POST', pattern)
+}
+
+/**
+ * Shorthand for a PUT route.
+ */
+export function createPutRoute<source extends string>(
+  pattern: source | RoutePattern<source>,
+): Route<'PUT', source> {
+  return new Route('PUT', pattern)
+}

packages/fetch-router/src/lib/route-helpers/method.ts

@@ -58,6 +58,15 @@ export class Route<
   }
 }
 
+/**
+ * Build a `Route` type from a request method and pattern.
+ */
+// prettier-ignore
+export type BuildRoute<method extends RequestMethod | 'ANY', pattern extends string | RoutePattern> =
+  pattern extends string ? Route<method, pattern> :
+  pattern extends RoutePattern<infer source extends string> ? Route<method, source> :
+  never
+
 /**
  * Create a route map from a set of route definitions.
  *
@@ -112,17 +121,17 @@ function buildRouteMap<base extends string, defs extends RouteDefs>(
 export type BuildRouteMap<base extends string, defs extends RouteDefs> = Simplify<{
   -readonly [name in keyof defs]: (
     defs[name] extends Route<infer method extends RequestMethod | 'ANY', infer pattern extends string> ? Route<method, Join<base, pattern>> :
-    defs[name] extends RouteDef ? BuildRoute<base, defs[name]> :
+    defs[name] extends RouteDef ? BuildRouteWithBase<base, defs[name]> :
     defs[name] extends RouteDefs ? BuildRouteMap<base, defs[name]> :
     never
   )
 }>
 
 // prettier-ignore
-type BuildRoute<base extends string, defs extends RouteDef> = 
-  defs extends string ? Route<'ANY', Join<base, defs>> :
-  defs extends RoutePattern<infer pattern extends string> ? Route<'ANY', Join<base, pattern>> :
-  defs extends { method: infer method extends RequestMethod | 'ANY', pattern: infer pattern } ? (
+type BuildRouteWithBase<base extends string, def extends RouteDef> = 
+  def extends string ? Route<'ANY', Join<base, def>> :
+  def extends RoutePattern<infer pattern extends string> ? Route<'ANY', Join<base, pattern>> :
+  def extends { method: infer method extends RequestMethod | 'ANY', pattern: infer pattern } ? (
     pattern extends string ? Route<method, Join<base, pattern>> :
     pattern extends RoutePattern<infer source extends string> ? Route<method, Join<base, source>> :
     never