Generate endpoint methods

Author: razor-x

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

@@ -0,0 +1,13 @@
+{{methodName}}(
+  {{requestFormat}}{{#if isOptionalParamsOk}}?{{/if}}: {{requestTypeName}},
+  {{#if hasOptions}}options: {{optionsTypeName}},{{/if}}
+  ): SeamHttpRequest<{{#if returnsVoid}}void, undefined{{else}}{{responseTypeName}}, '{{responseKey}}'{{/if}}>
+{
+  return new SeamHttpRequest(this, {
+    pathname: '{{path}}',
+    method: {{method}},
+    {{requestFormat}},
+    responseKey: {{#if returnsVoid}}undefined{{else}}'{{responseKey}}'{{/if}},
+    {{#if hasOptions}}options,{{/if}}
+  })
+}

codegen/lib/connect.ts

@@ -1,4 +1,5 @@
 import type { Blueprint, Endpoint, Namespace, Route } from '@seamapi/blueprint'
+import type { Method } from 'axios'
 import { camelCase, kebabCase, pascalCase } from 'change-case'
 import type Metalsmith from 'metalsmith'
 
@@ -88,12 +89,18 @@ interface RouteLayoutContext {
 
 interface EndpointLayoutContext {
   path: string
+  methodName: string
+  method: Method
+  hasOptions: boolean
+  responseKey: string
   requestFormat: 'params' | 'body'
   requestTypeName: string
   responseTypeName: string
   requestFormatSuffix: string
   optionsTypeName: string
   returnsActionAttempt: boolean
+  returnsVoid: boolean
+  isOptionalParamsOk: boolean
 }
 
 interface SubrouteLayoutContext {
@@ -152,15 +159,43 @@ const getEndpointLayoutContext = (
     : 'body'
 
   const requestFormatSuffix = pascalCase(requestFormat)
+
+  const returnsActionAttempt =
+    endpoint.response.responseType === 'resource' &&
+    endpoint.response.resourceType === 'action_attempt'
+
   return {
     path: endpoint.path,
+    methodName: camelCase(endpoint.name),
+    method: endpoint.request.preferredMethod,
+    hasOptions: returnsActionAttempt,
     requestFormat,
     requestFormatSuffix,
-    returnsActionAttempt:
-      endpoint.response.responseType === 'resource' &&
-      endpoint.response.resourceType === 'action_attempt',
+    returnsActionAttempt,
     requestTypeName: `${prefix}${requestFormatSuffix}`,
     responseTypeName: `${prefix}Response`,
     optionsTypeName: `${prefix}Options`,
+    // UPSTREAM: Needs support in blueprint, fallback to true for now.
+    // https://github.com/seamapi/blueprint/issues/205
+    isOptionalParamsOk: true,
+    ...getResponseContext(endpoint),
+  }
+}
+
+const getResponseContext = (
+  endpoint: Endpoint,
+): Pick<
+  EndpointLayoutContext,
+  'returnsVoid' | 'responseKey' | 'resourceType'
+> => {
+  if (endpoint.response.responseType === 'void')
+    return {
+      returnsVoid: true,
+      responseKey: '',
+    }
+  const { responseKey } = endpoint.response
+  return {
+    returnsVoid: false,
+    responseKey,
   }
 }