feat: Generate SeamHttpEndpoints

Author: razor-x

codegen/layouts/endpoints.hbs

@@ -0,0 +1,32 @@
+/*
+ * Automatically generated by codegen/smith.ts.
+ * Do not edit this file or add other files to this directory.
+ */
+
+{{> route-imports }}
+
+{{#each routes}}
+import {
+{{className}},
+{{#each typeNames}}
+  type {{.}},
+{{/each}}
+} from './{{fileName}}'
+{{/each}}
+
+export class SeamHttpEndpoints {
+  {{> route-class-methods }}
+
+  {{#each endpoints}}
+  get['{{path}}'](): {{className}}['{{methodName}}']
+  {
+  const { client, defaults } = this
+  return function {{> route-class-endpoint-sig methodName=functionName}}
+    {
+      const seam = {{className}}.fromClient(client, defaults)
+      return seam.{{methodName}}({{methodParamName}}{{#if hasOptions}},options{{/if}})
+    }
+  }
+
+  {{/each}}
+}

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

@@ -0,0 +1,4 @@
+{{methodName}}(
+  {{methodParamName}}{{#if isOptionalParamsOk}}?{{/if}}: {{requestTypeName}},
+  {{#if hasOptions}}options: {{optionsTypeName}} = {},{{/if}}
+  ): SeamHttpRequest<{{#if returnsVoid}}void, undefined{{else}}{{responseTypeName}}, '{{responseKey}}'{{/if}}>

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

@@ -1,7 +1,4 @@
-{{methodName}}(
-  {{methodParamName}}{{#if isOptionalParamsOk}}?{{/if}}: {{requestTypeName}},
-  {{#if hasOptions}}options: {{optionsTypeName}} = {},{{/if}}
-  ): SeamHttpRequest<{{#if returnsVoid}}void, undefined{{else}}{{responseTypeName}}, '{{responseKey}}'{{/if}}>
+{{> route-class-endpoint-sig className=functionName}}
 {
   return new SeamHttpRequest(this, {
     pathname: '{{path}}',

codegen/lib/connect.ts

@@ -2,17 +2,24 @@ import type { Blueprint } from '@seamapi/blueprint'
 import { kebabCase } from 'change-case'
 import type Metalsmith from 'metalsmith'
 
+import {
+  type EndpointsLayoutContext,
+  setEndpointsLayoutContext,
+} from './layouts/endpoints.js'
 import {
   type RouteIndexLayoutContext,
   type RouteLayoutContext,
   setRouteLayoutContext,
+  toFilePath,
 } from './layouts/route.js'
 
 interface Metadata {
   blueprint: Blueprint
 }
 
-type File = RouteLayoutContext & RouteIndexLayoutContext & { layout: string }
+type File = RouteLayoutContext &
+  RouteIndexLayoutContext &
+  EndpointsLayoutContext & { layout: string }
 
 const rootPath = 'src/lib/seam/connect/routes'
 
@@ -34,15 +41,22 @@ export const connect = (
 
   const routeIndexes: Record<string, Set<string>> = {}
 
-  const rootRouteKey = `${rootPath}/seam-http.ts`
-  files[rootRouteKey] = { contents: Buffer.from('\n') }
-  const file = files[rootRouteKey] as unknown as File
+  const k = `${rootPath}/seam-http.ts`
+  files[k] = { contents: Buffer.from('\n') }
+  const file = files[k] as unknown as File
   file.layout = 'route.hbs'
   setRouteLayoutContext(file, null, nodes)
 
   routeIndexes[''] ??= new Set()
   routeIndexes['']?.add('seam-http.js')
 
+  const endpointsKey = `${rootPath}/seam-http-endpoints.ts`
+  files[endpointsKey] = { contents: Buffer.from('\n') }
+  const endpointFile = files[endpointsKey] as unknown as File
+  endpointFile.layout = 'endpoints.hbs'
+  setEndpointsLayoutContext(endpointFile, routes)
+  routeIndexes['']?.add('seam-http-endpoints.js')
+
   for (const node of nodes) {
     const path = toFilePath(node.path)
     const name = kebabCase(node.name)
@@ -75,10 +89,3 @@ export const connect = (
     file.routes = [...routes]
   }
 }
-
-const toFilePath = (path: string): string =>
-  path
-    .slice(1)
-    .split('/')
-    .map((p) => kebabCase(p))
-    .join('/')

codegen/lib/layouts/endpoints.ts

@@ -0,0 +1,47 @@
+import type { Route } from '@seamapi/blueprint'
+
+import {
+  type EndpointLayoutContext,
+  getClassName,
+  getEndpointLayoutContext,
+  toFilePath,
+} from './route.js'
+
+export interface EndpointsLayoutContext {
+  className: string
+  endpoints: EndpointLayoutContext[]
+  routes: Array<{
+    fileName: string
+    className: string
+    typeNames: string[]
+  }>
+  skipClientSessionImport: boolean
+}
+
+export const setEndpointsLayoutContext = (
+  file: Partial<EndpointsLayoutContext>,
+  routes: Route[],
+): void => {
+  file.className = getClassName('Endpoints')
+  file.skipClientSessionImport = true
+  file.endpoints = routes.flatMap((route) =>
+    route.endpoints
+      .filter(({ isUndocumented }) => !isUndocumented)
+      .map((endpoint) => getEndpointLayoutContext(endpoint, route)),
+  )
+  file.routes = routes.map((route) => {
+    const typeNames = route.endpoints
+      .filter(({ isUndocumented }) => !isUndocumented)
+      .map((e) => getEndpointLayoutContext(e, route))
+      .flatMap((e) => [
+        e.optionsTypeName,
+        e.requestTypeName,
+        e.responseTypeName,
+      ])
+    return {
+      className: getClassName(route.path),
+      typeNames,
+      fileName: `${toFilePath(route.path)}/index.js`,
+    }
+  })
+}

codegen/lib/layouts/route.ts

@@ -13,9 +13,11 @@ export interface RouteIndexLayoutContext {
   routes: string[]
 }
 
-interface EndpointLayoutContext {
+export interface EndpointLayoutContext {
   path: string
   methodName: string
+  functionName: string
+  className: string
   method: Method
   hasOptions: boolean
   responseKey: string
@@ -71,7 +73,7 @@ const getSubrouteLayoutContext = (
   }
 }
 
-const getEndpointLayoutContext = (
+export const getEndpointLayoutContext = (
   endpoint: Endpoint,
   route: Pick<Route, 'path' | 'name'>,
 ): EndpointLayoutContext => {
@@ -95,11 +97,15 @@ const getEndpointLayoutContext = (
     endpoint.response.responseType === 'resource' &&
     endpoint.response.resourceType === 'action_attempt'
 
+  const methodName = camelCase(endpoint.name)
+
   return {
     path: endpoint.path,
-    methodName: camelCase(endpoint.name),
+    methodName,
+    functionName: camelCase(prefix),
     method: endpoint.request.preferredMethod,
     hasOptions: returnsActionAttempt,
+    className: getClassName(route.path),
     methodParamName,
     requestFormat,
     requestFormatSuffix,
@@ -129,5 +135,12 @@ const getResponseContext = (
   }
 }
 
-const getClassName = (name: string | null): string =>
-  `SeamHttp${pascalCase(name ?? '')}`
+export const getClassName = (path: string | null): string =>
+  `SeamHttp${pascalCase(path ?? '')}`
+
+export const toFilePath = (path: string): string =>
+  path
+    .slice(1)
+    .split('/')
+    .map((p) => kebabCase(p))
+    .join('/')