Generate route endpoint types

Author: razor-x

codegen/layouts/partials/route-class-endpoint-export.hbs

@@ -0,0 +1,7 @@
+export type {{requestTypeName}} = RouteRequest{{requestFormatSuffix}}<'{{path}}'>
+
+export type {{responseTypeName}} = SetNonNullable<
+  Required<RouteResponse<'{{path}}'>>
+>
+
+export type {{optionsTypeName}} = {{#if returnsActionAttempt}}Pick<SeamHttpRequestOptions, 'waitForActionAttempt'>{{else}}never{{/if}}

codegen/layouts/partials/route-imports.hbs

@@ -38,23 +38,10 @@ import {
 import { SeamHttpRequest } from 'lib/seam/connect/seam-http-request.js'
 import { SeamPaginator } from 'lib/seam/connect/seam-paginator.js'
 
-{{#if isClientSessionRoute}}
+{{#unless isClientSessionRoute}}
 import { SeamHttpClientSessions } from './client-sessions.js'
-{{/if}}
-
-{{#if needsActionAttempts}}
-import {
-  resolveActionAttempt,
-} from 'lib/seam/connect/resolve-action-attempt.js'
-{{#unless isActionAttemptsRoute}}
-import { SeamHttpActionAttempts } from './action-attempts.js'
 {{/unless}}
-{{/if}}
 
 {{#each subroutes}}
 import { {{className}} } from './{{fileName}}'
 {{/each}}
-
-{{#each namespaces}}
-import { {{className}} } from './{{fileName}}'
-{{/each}}

codegen/layouts/route.hbs

@@ -1,6 +1,6 @@
 {{> route-imports }}
 
-class {{className}} {
+export class {{className}} {
   {{> route-class-methods }}
 
   {{#each subroutes}}
@@ -13,3 +13,8 @@ class {{className}} {
 
   {{/each}}
 }
+
+  {{#each endpoints}}
+    {{> route-class-endpoint-export }}
+
+  {{/each}}

codegen/lib/connect.ts

@@ -1,4 +1,4 @@
-import type { Blueprint, Namespace, Route } from '@seamapi/blueprint'
+import type { Blueprint, Endpoint, Namespace, Route } from '@seamapi/blueprint'
 import { camelCase, kebabCase, pascalCase } from 'change-case'
 import type Metalsmith from 'metalsmith'
 
@@ -83,14 +83,17 @@ interface RouteLayoutContext {
   className: string
   endpoints: EndpointLayoutContext[]
   subroutes: SubrouteLayoutContext[]
-  namespaces: SubrouteLayoutContext[]
   isClientSessionRoute: boolean
-  isActionAttemptsRoute: boolean
-  needsActionAttempts: boolean
 }
 
 interface EndpointLayoutContext {
-  routeName: string
+  path: string
+  requestFormat: 'params' | 'body'
+  requestTypeName: string
+  responseTypeName: string
+  requestFormatSuffix: string
+  optionsTypeName: string
+  returnsActionAttempt: boolean
 }
 
 interface SubrouteLayoutContext {
@@ -108,20 +111,17 @@ const setRouteLayoutContext = (
   blueprint: Blueprint,
 ): void => {
   file.className = getClassName(node?.path ?? null)
-
-  file.needsActionAttempts =
-    node != null &&
-    'endpoints' in node &&
-    node.endpoints.some(
-      (e) =>
-        e.response.responseType === 'resource' &&
-        e.response.resourceType === 'action_attempt',
-    )
-
   file.isClientSessionRoute = node?.name === '/client_sessions'
-  file.isActionAttemptsRoute = node?.name === '/action_attempts'
 
-  file.endpoints = [] // TODO
+  file.endpoints = []
+  if (node != null && 'endpoints' in node) {
+    const endpoints = node.endpoints.filter(
+      ({ isUndocumented }) => !isUndocumented,
+    )
+    file.endpoints = endpoints.map((endpoint) =>
+      getEndpointLayoutContext(endpoint, node),
+    )
+  }
 
   file.subroutes = [...blueprint.routes, ...blueprint.namespaces]
     .sort((n1, n2) => n1.name.localeCompare(n2.name))
@@ -138,3 +138,29 @@ const getSubrouteLayoutContext = (
     className: getClassName(route.path),
   }
 }
+
+const getEndpointLayoutContext = (
+  endpoint: Endpoint,
+  route: Pick<Route, 'name'>,
+): EndpointLayoutContext => {
+  const prefix = `${pascalCase(route.name)}${pascalCase(endpoint.name)}`
+
+  const requestFormat = ['GET', 'DELETE'].includes(
+    endpoint.request.semanticMethod,
+  )
+    ? 'params'
+    : 'body'
+
+  const requestFormatSuffix = pascalCase(requestFormat)
+  return {
+    path: endpoint.path,
+    requestFormat,
+    requestFormatSuffix,
+    returnsActionAttempt:
+      endpoint.response.responseType === 'resource' &&
+      endpoint.response.resourceType === 'action_attempt',
+    requestTypeName: `${prefix}${requestFormatSuffix}`,
+    responseTypeName: `${prefix}Response`,
+    optionsTypeName: `${prefix}Options`,
+  }
+}