feat: Generate SeamHttpEndpoints

Author: razor-x

codegen/layouts/endpoints.hbs

@@ -0,0 +1,19 @@
+/*
+ * Automatically generated by codegen/smith.ts.
+ * Do not edit this file or add other files to this directory.
+ */
+
+{{> route-imports }}
+
+{{#each routes}}
+import { {{className}} } from './{{fileName}}'
+{{/each}}
+
+export class SeamHttpEndpoints {
+  {{> route-class-methods }}
+
+  {{#each endpoints}}
+  {{> route-class-endpoint }}
+
+  {{/each}}
+}

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,
 } from './layouts/route.js'
+import { toFilePath } from './path.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, blueprint.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,32 @@
+import type { Route } from '@seamapi/blueprint'
+
+import { toFilePath } from '../path.js'
+import {
+  type EndpointLayoutContext,
+  getClassName,
+  getEndpointLayoutContext,
+  type SubrouteLayoutContext,
+} from './route.js'
+
+export interface EndpointsLayoutContext {
+  endpoints: EndpointLayoutContext[]
+  routes: Array<Pick<SubrouteLayoutContext, 'className' | 'fileName'>>
+  skipClientSessionImport: boolean
+}
+
+export const setEndpointsLayoutContext = (
+  file: Partial<EndpointsLayoutContext>,
+  routes: Route[],
+): void => {
+  file.skipClientSessionImport = true
+  file.routes = routes.map(({ name, path }) => ({
+    className: getClassName(name),
+    fileName: `${toFilePath(path)}/index.js`,
+  }))
+  file.endpoints = routes.flatMap((r) =>
+    r.endpoints.map((e) => ({
+      ...getEndpointLayoutContext(e, r),
+      methodName: `get['${e.path}']`,
+    })),
+  )
+}

codegen/lib/layouts/route.ts

@@ -13,7 +13,7 @@ export interface RouteIndexLayoutContext {
   routes: string[]
 }
 
-interface EndpointLayoutContext {
+export interface EndpointLayoutContext {
   path: string
   methodName: string
   method: Method
@@ -30,7 +30,7 @@ interface EndpointLayoutContext {
   isOptionalParamsOk: boolean
 }
 
-interface SubrouteLayoutContext {
+export interface SubrouteLayoutContext {
   methodName: string
   className: string
   fileName: string
@@ -71,7 +71,7 @@ const getSubrouteLayoutContext = (
   }
 }
 
-const getEndpointLayoutContext = (
+export const getEndpointLayoutContext = (
   endpoint: Endpoint,
   route: Pick<Route, 'path' | 'name'>,
 ): EndpointLayoutContext => {
@@ -129,5 +129,5 @@ const getResponseContext = (
   }
 }
 
-const getClassName = (name: string | null): string =>
+export const getClassName = (name: string | null): string =>
   `SeamHttp${pascalCase(name ?? '')}`

codegen/lib/path.ts

@@ -0,0 +1,8 @@
+import { kebabCase } from 'change-case'
+
+export const toFilePath = (path: string): string =>
+  path
+    .slice(1)
+    .split('/')
+    .map((p) => kebabCase(p))
+    .join('/')