feat(open-api): Automatically generate summary based on operationId

aklinker1 · aklinker1 · commit f54af7ddb2cb · 2026-01-30T13:51:00.000-06:00
diff --git a/bun.lock b/bun.lock
diff --git a/package.json b/package.json
@@ -48,7 +48,8 @@
   "dependencies": {
     "@standard-schema/spec": "^1.0.0",
     "openapi-types": "^12.1.3",
-    "rou3": "^0.7.12"
+    "rou3": "^0.7.12",
+    "scule": "^1.3.0"
   },
   "devDependencies": {
     "@aklinker1/check": "^2.2.0",
diff --git a/src/internal/utils.ts b/src/internal/utils.ts
@@ -1,6 +1,10 @@
 import type { StandardSchemaV1 } from "@standard-schema/spec";
+import type { MatchedRoute } from "rou3";
 import { HttpError } from "../errors";
+import type { ErrorResponse } from "../schema";
 import { HttpStatus } from "../status";
+import { createBunTransport } from "../transports/bun-transport";
+import { createDenoTransport } from "../transports/deno-transport";
 import type {
   App,
   LifeCycleHook,
@@ -9,10 +13,6 @@ import type {
   StatusResult,
   Transport,
 } from "../types";
-import type { MatchedRoute } from "rou3";
-import type { ErrorResponse } from "../schema";
-import { createBunTransport } from "../transports/bun-transport";
-import { createDenoTransport } from "../transports/deno-transport";
 
 export function validateSchema<T>(
   schema: StandardSchemaV1<T, T>,
diff --git a/src/open-api.ts b/src/open-api.ts
@@ -1,5 +1,6 @@
 import type { StandardSchemaV1 } from "@standard-schema/spec";
 import type { OpenAPI } from "openapi-types";
+import { titleCase } from "scule";
 import type { CreateAppOptions } from "./app";
 import { getMeta } from "./meta";
 import {
@@ -54,6 +55,11 @@ export function buildOpenApiDocs(
 
         (docs.paths[openApiPath] as any)[method.toLowerCase()] = {
           ...openApiOperation,
+          summary:
+            openApiOperation.summary ??
+            (openApiOperation.operationId
+              ? titleCase(openApiOperation.operationId)
+              : undefined),
           requestBody: body
             ? {
                 content: {
