feat: Use Blueprint omitUndocumented option in codegen

Build the Blueprint with the omitUndocumented option (added in
@seamapi/blueprint 0.61.0) and remove the manual isUndocumented filters
from the route generator.

Since @seamapi/smith does not forward this option, call createBlueprint
directly. Bump @seamapi/blueprint to ^0.61.0 and @seamapi/types to
1.975.0 to satisfy the stricter undocumented-reference validation added
in the newer Blueprint.

Applying omitUndocumented at the Blueprint level also strips undocumented
resources and properties from models.py, which the route-only filters
never covered.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01ASErrFWD4qfnmhzYZNuwYb

Author: claude

codegen/lib/routes.ts

@@ -32,16 +32,12 @@ export const routes = (
   const metadata = metalsmith.metadata() as Metadata
   const { blueprint } = metadata
 
-  const documentedRoutes = blueprint.routes.filter(
-    (route) => !route.isUndocumented,
-  )
+  // The blueprint is built with omitUndocumented, so undocumented routes,
+  // namespaces, endpoints, and parameters are already stripped out.
 
   // Namespaces group routes without endpoints of their own (e.g. /acs) but
   // still produce a route class so their child classes are reachable.
-  const classEntries = [
-    ...blueprint.namespaces.filter((namespace) => !namespace.isUndocumented),
-    ...documentedRoutes,
-  ]
+  const classEntries = [...blueprint.namespaces, ...blueprint.routes]
     .map(({ path, parentPath }) => ({ path, parentPath }))
     .sort((a, b) => (a.path < b.path ? -1 : 1))
 
@@ -70,13 +66,11 @@ export const routes = (
     })
   }
 
-  for (const route of documentedRoutes) {
+  for (const route of blueprint.routes) {
     const cls = classMap.get(pascalCase(toNamespace(route.path)))
     if (cls == null) continue
 
     for (const endpoint of route.endpoints) {
-      if (endpoint.isUndocumented) continue
-
       const { response } = endpoint
       const idParameterName =
         endpoint.name === 'get' && response.responseType !== 'void'
@@ -86,14 +80,12 @@ export const routes = (
       cls.methods.push({
         methodName: endpoint.name,
         path: endpoint.path,
-        parameters: endpoint.request.parameters
-          .filter((parameter) => !parameter.isUndocumented)
-          .map((parameter) => ({
-            name: parameter.name,
-            type: mapParameterToPythonType(parameter),
-            position: parameter.name === idParameterName ? 0 : undefined,
-            required: parameter.isRequired,
-          })),
+        parameters: endpoint.request.parameters.map((parameter) => ({
+          name: parameter.name,
+          type: mapParameterToPythonType(parameter),
+          position: parameter.name === idParameterName ? 0 : undefined,
+          required: parameter.isRequired,
+        })),
         ...resolveResponse(response),
       })
     }

codegen/smith.ts

@@ -2,7 +2,8 @@ import { dirname } from 'node:path'
 import { fileURLToPath } from 'node:url'
 
 import layouts from '@metalsmith/layouts'
-import { blueprint, getHandlebarsPartials } from '@seamapi/smith'
+import { createBlueprint, type TypesModuleInput } from '@seamapi/blueprint'
+import { getHandlebarsPartials } from '@seamapi/smith'
 import * as types from '@seamapi/types/connect'
 import { deleteAsync } from 'del'
 import Metalsmith from 'metalsmith'
@@ -15,11 +16,24 @@ await Promise.all([deleteAsync('./seam/routes')])
 
 const partials = await getHandlebarsPartials(`${rootDir}/layouts/partials`)
 
+// Build the Blueprint with omitUndocumented so undocumented routes,
+// namespaces, endpoints, parameters, resources, events, action attempts, and
+// properties are stripped out before codegen runs.
+const setBlueprint = async (
+  _files: Metalsmith.Files,
+  metalsmith: Metalsmith,
+): Promise<void> => {
+  const blueprint = await createBlueprint(types as TypesModuleInput, {
+    omitUndocumented: true,
+  })
+  Object.assign(metalsmith.metadata(), { blueprint })
+}
+
 Metalsmith(rootDir)
   .source('./content')
   .destination('../')
   .clean(false)
-  .use(blueprint({ types }))
+  .use(setBlueprint)
   .use(routes)
   .use(
     layouts({

package-lock.json

@@ -14,10 +14,10 @@
     "start": "fake-seam-connect --seed"
   },
   "devDependencies": {
-    "@seamapi/blueprint": "^0.59.0",
+    "@seamapi/blueprint": "^0.61.0",
     "@seamapi/fake-seam-connect": "1.86.0",
     "@seamapi/smith": "^0.5.2",
-    "@seamapi/types": "1.970.0",
+    "@seamapi/types": "1.975.0",
     "change-case": "^5.4.4",
     "prettier": "^3.2.5"
   }