Split layout module

src/lib/layout/api-endpoint.ts

@@ -0,0 +1,92 @@
+import type { CodeSampleSdk, Endpoint } from '@seamapi/blueprint'
+
+const supportedSdks: CodeSampleSdk[] = [
+  'javascript',
+  'python',
+  'php',
+  'ruby',
+  'go',
+  'seam_cli',
+]
+
+export interface EndpointLayoutContext {
+  description: string
+  title: string
+  path: string
+  request: {
+    preferredMethod: string
+    parameters: Array<{
+      name: string
+      required: boolean
+      description: string
+      jsonType: string
+    }>
+  }
+  response: {
+    description: string
+    resourceType: string | null
+    escapedResourceType: string | null
+    responseKey: string | null
+    responseType: string | null
+  }
+  codeSamples: Array<{
+    title: string
+    description: string
+    code: Record<
+      string,
+      {
+        title: string
+        request: string
+        response: string
+      }
+    >
+  }>
+}
+
+export function setEndpointLayoutContext(
+  file: Partial<EndpointLayoutContext>,
+  endpoint: Endpoint,
+): void {
+  file.description = endpoint.description
+  file.title = endpoint.title
+  file.path = endpoint.path
+
+  file.request = {
+    preferredMethod: endpoint.request?.preferredMethod ?? '',
+    parameters: endpoint.request.parameters
+      .filter(({ isUndocumented }) => !isUndocumented)
+      .map((param) => ({
+        name: param.name,
+        required: param.isRequired,
+        description: param.description,
+        jsonType: param.jsonType,
+      })),
+  }
+
+  file.response = {
+    description: endpoint.response.description,
+    resourceType: null,
+    escapedResourceType: null,
+    responseKey: null,
+    responseType: null,
+  }
+
+  if (endpoint.response.responseType !== 'void') {
+    const { resourceType, responseKey, responseType } = endpoint.response
+    file.response.resourceType = resourceType
+    file.response.escapedResourceType = resourceType.replaceAll('_', '\\_')
+    file.response.responseKey = responseKey
+    file.response.responseType = responseType
+  }
+
+  file.codeSamples = endpoint.codeSamples.map((sample) => {
+    const codeEntries = Object.entries(sample.code).filter(([k]) =>
+      supportedSdks.includes(k as CodeSampleSdk),
+    )
+    return {
+      title: sample.title,
+      description: sample.description,
+      code: Object.fromEntries(codeEntries),
+    }
+  })
+}

src/lib/layout/layout-context.ts → src/lib/layout/api-route.ts

@@ -1,103 +1,14 @@
-import type {
-  Blueprint,
-  CodeSampleSdk,
-  Endpoint,
-  Property,
-  Route,
-} from '@seamapi/blueprint'
+import type { Blueprint, Endpoint, Property, Route } from '@seamapi/blueprint'
 import { pascalCase } from 'change-case'
 
-import type { PathMetadata } from '../path-metadata.js'
-
-const supportedSdks: CodeSampleSdk[] = [
-  'javascript',
-  'python',
-  'php',
-  'ruby',
-  'go',
-  'seam_cli',
-]
+import type { PathMetadata } from 'lib/path-metadata.js'
 
-export interface EndpointLayoutContext {
-  description: string
+export interface RouteLayoutContext {
   title: string
+  description: string
   path: string
-  request: {
-    preferredMethod: string
-    parameters: Array<{
-      name: string
-      required: boolean
-      description: string
-      jsonType: string
-    }>
-  }
-  response: {
-    description: string
-    resourceType: string | null
-    escapedResourceType: string | null
-    responseKey: string | null
-    responseType: string | null
-  }
-  codeSamples: Array<{
-    title: string
-    description: string
-    code: Record<
-      string,
-      {
-        title: string
-        request: string
-        response: string
-      }
-    >
-  }>
-}
-
-export function setEndpointLayoutContext(
-  file: Partial<EndpointLayoutContext>,
-  endpoint: Endpoint,
-): void {
-  file.description = endpoint.description
-  file.title = endpoint.title
-  file.path = endpoint.path
-
-  file.request = {
-    preferredMethod: endpoint.request?.preferredMethod ?? '',
-    parameters: endpoint.request.parameters
-      .filter(({ isUndocumented }) => !isUndocumented)
-      .map((param) => ({
-        name: param.name,
-        required: param.isRequired,
-        description: param.description,
-        jsonType: param.jsonType,
-      })),
-  }
-
-  file.response = {
-    description: endpoint.response.description,
-    resourceType: null,
-    escapedResourceType: null,
-    responseKey: null,
-    responseType: null,
-  }
-
-  if (endpoint.response.responseType !== 'void') {
-    const { resourceType, responseKey, responseType } = endpoint.response
-    file.response.resourceType = resourceType
-    file.response.escapedResourceType = resourceType.replaceAll('_', '\\_')
-    file.response.responseKey = responseKey
-    file.response.responseType = responseType
-  }
-
-  file.codeSamples = endpoint.codeSamples.map((sample) => {
-    const codeEntries = Object.entries(sample.code).filter(([k]) =>
-      supportedSdks.includes(k as CodeSampleSdk),
-    )
-    return {
-      title: sample.title,
-      description: sample.description,
-      code: Object.fromEntries(codeEntries),
-    }
-  })
+  resources: ContextResource[]
+  endpoints: ContextEndpoint[]
 }
 
 type ContextResourceProperty = Pick<
@@ -108,20 +19,14 @@ type ContextResourceProperty = Pick<
   enumValues?: string[]
   objectProperties?: ContextResourceProperty[]
 }
+
 interface ContextResource {
   name: string
   description: string
   properties: ContextResourceProperty[]
 }
-type ContextEndpoint = Pick<Endpoint, 'path' | 'description'>
 
-export interface RouteLayoutContext {
-  title: string
-  description: string
-  path: string
-  resources: ContextResource[]
-  endpoints: ContextEndpoint[]
-}
+type ContextEndpoint = Pick<Endpoint, 'path' | 'description'>
 
 export function setApiRouteLayoutContext(
   file: Partial<RouteLayoutContext>,

src/lib/layout/index.ts

@@ -1 +1,2 @@
-export * from './layout-context.js'
+export * from './api-endpoint.js'
+export * from './api-route.js'