Generate sub resources

Author: razor-x

generate-routes.ts

@@ -9,9 +9,10 @@ import { format, resolveConfig } from 'prettier'
 const rootClassPath = resolve('src', 'lib', 'seam', 'connect', 'client.ts')
 const routeOutputPath = resolve('src', 'lib', 'seam', 'connect', 'routes')
 
-const routePaths: string[] = [
+const routePaths = [
   '/access_codes',
   '/access_codes/unmanaged',
+  '/acs',
   '/acs/access_groups',
   '/acs/credentials',
   '/acs/systems',
@@ -24,12 +25,23 @@ const routePaths: string[] = [
   '/devices/unmanaged',
   '/events',
   '/locks',
+  '/noise_sensors',
   '/noise_sensors/noise_thresholds',
   '/thermostats/climate_setting_schedules',
   '/thermostats',
   '/webhooks',
   '/workspaces',
-]
+] as const
+
+const routePathSubresources: Partial<
+  Record<(typeof routePaths)[number], string[]>
+> = {
+  '/access_codes': ['unmanaged'],
+  '/acs': ['access_groups', 'credentials', 'systems', 'users'],
+  '/devices': ['unmanaged'],
+  '/noise_sensors': ['noise_thresholds'],
+  '/thermostats': ['climate_setting_schedules'],
+}
 
 const ignoredEndpointPaths = [
   '/access_codes/simulate/create_unmanaged_access_code',
@@ -38,7 +50,7 @@ const ignoredEndpointPaths = [
   '/health/get_service_health',
   '/health/service/[service_name]',
   '/noise_sensors/simulate/trigger_noise_threshold',
-]
+] as const
 
 const endpointResources: Partial<
   Record<
@@ -61,11 +73,12 @@ const endpointResources: Partial<
   '/noise_sensors/noise_thresholds/update': null,
   '/thermostats/climate_setting_schedules/update': null,
   '/workspaces/reset_sandbox': null,
-}
+} as const
 
 interface Route {
   namespace: string
   endpoints: Endpoint[]
+  subresources: string[]
 }
 
 interface Endpoint {
@@ -91,7 +104,9 @@ const createRoutes = (): Route[] => {
       (path) =>
         !routePaths.some((routePath) => isEndpointUnderRoute(path, routePath)),
     )
-    .filter((path) => !ignoredEndpointPaths.includes(path))
+    .filter(
+      (path) => !(ignoredEndpointPaths as unknown as string[]).includes(path),
+    )
 
   if (unmatchedEndpointPaths.length > 0) {
     // eslint-disable-next-line no-console
@@ -105,7 +120,7 @@ const createRoutes = (): Route[] => {
   return routePaths.map(createRoute)
 }
 
-const createRoute = (routePath: string): Route => {
+const createRoute = (routePath: (typeof routePaths)[number]): Route => {
   const endpointPaths = Object.keys(openapi.paths).filter((path) =>
     isEndpointUnderRoute(path, routePath),
   )
@@ -114,6 +129,7 @@ const createRoute = (routePath: string): Route => {
 
   return {
     namespace,
+    subresources: routePathSubresources[routePath] ?? [],
     endpoints: endpointPaths.map((endpointPath) =>
       createEndpoint(namespace, routePath, endpointPath),
     ),
@@ -207,14 +223,14 @@ const renderRoute = (route: Route, { constructors }: ClassMeta): string => `
 * Do not edit this file or add other files to this directory.
 */
 
-${renderImports()}
+${renderImports(route)}
 
 ${renderClass(route, { constructors })}
 
 ${renderExports(route)}
 `
 
-const renderImports = (): string =>
+const renderImports = ({ namespace, subresources }: Route): string =>
   `
 import type { RouteRequestParams, RouteResponse, RouteRequestBody } from '@seamapi/types/connect'
 import { Axios } from 'axios'
@@ -232,10 +248,21 @@ import {
   type SeamHttpOptionsWithClientSessionToken,
 } from 'lib/seam/connect/client-options.js'
 import { parseOptions } from 'lib/seam/connect/parse-options.js'
+${subresources
+  .map((subresource) => renderSubresourceImport(subresource, namespace))
+  .join('\n')}
+`
+const renderSubresourceImport = (
+  subresource: string,
+  namespace: string,
+): string => `
+    import {
+      SeamHttp${pascalCase(namespace)}${pascalCase(subresource)}
+    } from './${paramCase(namespace)}-${paramCase(subresource)}.js'
 `
 
 const renderClass = (
-  { namespace, endpoints }: Route,
+  { namespace, endpoints, subresources }: Route,
   { constructors }: ClassMeta,
 ): string =>
   `
@@ -247,6 +274,10 @@ export class SeamHttp${pascalCase(namespace)} {
     .replaceAll(': SeamHttp ', `: SeamHttp${pascalCase(namespace)} `)
     .replaceAll('new SeamHttp(', `new SeamHttp${pascalCase(namespace)}(`)}
 
+  ${subresources
+    .map((subresource) => renderSubresourceMethod(subresource, namespace))
+    .join('\n')}
+
   ${endpoints.map(renderClassMethod).join('\n')}
 }
 `
@@ -287,6 +318,19 @@ const renderClassMethod = ({
   }
   `
 
+const renderSubresourceMethod = (
+  subresource: string,
+  namespace: string,
+): string => `
+  get ${camelCase(subresource)} (): SeamHttp${pascalCase(
+    namespace,
+  )}${pascalCase(subresource)} {
+    return SeamHttp${pascalCase(namespace)}${pascalCase(
+      subresource,
+    )}.fromClient(this.client)
+  }
+`
+
 const renderExports = (route: Route): string =>
   route.endpoints.map(renderEndpointExports).join('\n')
 
@@ -322,17 +366,6 @@ const renderResponseType = ({
 }: Pick<Endpoint, 'name' | 'namespace'>): string =>
   [pascalCase(namespace), pascalCase(name), 'Response'].join('')
 
-const write = async (data: string, ...path: string[]): Promise<void> => {
-  const filePath = resolve(...path)
-  await writeFile(
-    filePath,
-    '// Generated empty file to allow ESLint parsing by filename',
-  )
-  const fixedOutput = await eslintFixOutput(data, filePath)
-  const prettyOutput = await prettierOutput(fixedOutput, filePath)
-  await writeFile(filePath, prettyOutput)
-}
-
 const getClassConstructors = (data: string): string => {
   const lines = data.split('\n')
 
@@ -351,6 +384,34 @@ const getClassConstructors = (data: string): string => {
   return lines.slice(startIdx, endIdx).join('\n')
 }
 
+const writeRoute = async (route: Route): Promise<void> => {
+  const rootClass = await readFile(rootClassPath)
+  const constructors = getClassConstructors(rootClass.toString())
+  await write(
+    renderRoute(route, { constructors }),
+    routeOutputPath,
+    `${paramCase(route.namespace)}.ts`,
+  )
+}
+
+const writeRoutesIndex = async (routes: Route[]): Promise<void> => {
+  const exports = routes.map(
+    (route) => `export * from './${paramCase(route.namespace)}.js'`,
+  )
+  await write(exports.join('\n'), routeOutputPath, `index.ts`)
+}
+
+const write = async (data: string, ...path: string[]): Promise<void> => {
+  const filePath = resolve(...path)
+  await writeFile(
+    filePath,
+    '// Generated empty file to allow ESLint parsing by filename',
+  )
+  const fixedOutput = await eslintFixOutput(data, filePath)
+  const prettyOutput = await prettierOutput(fixedOutput, filePath)
+  await writeFile(filePath, prettyOutput)
+}
+
 const prettierOutput = async (
   data: string,
   filepath: string,
@@ -387,14 +448,6 @@ const eslintFixOutput = async (
   return linted.output ?? linted.source ?? data
 }
 
-const writeRoute = async (route: Route): Promise<void> => {
-  const rootClass = await readFile(rootClassPath)
-  const constructors = getClassConstructors(rootClass.toString())
-  await write(
-    renderRoute(route, { constructors }),
-    routeOutputPath,
-    `${paramCase(route.namespace)}.ts`,
-  )
-}
-
-await Promise.all(createRoutes().map(writeRoute))
+const routes = createRoutes()
+await Promise.all(routes.map(writeRoute))
+await writeRoutesIndex(routes)

src/lib/seam/connect/client.ts

@@ -13,7 +13,21 @@ import {
 } from './client-options.js'
 import { SeamHttpLegacyWorkspaces } from './legacy/workspaces.js'
 import { parseOptions } from './parse-options.js'
-import { SeamHttpWorkspaces } from './routes/workspaces.js'
+import {
+  SeamHttpAccessCodes,
+  SeamHttpAcs,
+  SeamHttpActionAttempts,
+  SeamHttpClientSessions,
+  SeamHttpConnectedAccounts,
+  SeamHttpConnectWebviews,
+  SeamHttpDevices,
+  SeamHttpEvents,
+  SeamHttpLocks,
+  SeamHttpNoiseSensors,
+  SeamHttpThermostats,
+  SeamHttpWebhooks,
+  SeamHttpWorkspaces,
+} from './routes/index.js'
 
 export class SeamHttp {
   client: Axios
@@ -62,6 +76,54 @@ export class SeamHttp {
     return new SeamHttp(opts)
   }
 
+  get accessCodes(): SeamHttpAccessCodes {
+    return SeamHttpAccessCodes.fromClient(this.client)
+  }
+
+  get acs(): SeamHttpAcs {
+    return SeamHttpAcs.fromClient(this.client)
+  }
+
+  get actionAttempts(): SeamHttpActionAttempts {
+    return SeamHttpActionAttempts.fromClient(this.client)
+  }
+
+  get clientSessions(): SeamHttpClientSessions {
+    return SeamHttpClientSessions.fromClient(this.client)
+  }
+
+  get connectedAccounts(): SeamHttpConnectedAccounts {
+    return SeamHttpConnectedAccounts.fromClient(this.client)
+  }
+
+  get connectWebviews(): SeamHttpConnectWebviews {
+    return SeamHttpConnectWebviews.fromClient(this.client)
+  }
+
+  get devices(): SeamHttpDevices {
+    return SeamHttpDevices.fromClient(this.client)
+  }
+
+  get events(): SeamHttpEvents {
+    return SeamHttpEvents.fromClient(this.client)
+  }
+
+  get locks(): SeamHttpLocks {
+    return SeamHttpLocks.fromClient(this.client)
+  }
+
+  get noiseSensors(): SeamHttpNoiseSensors {
+    return SeamHttpNoiseSensors.fromClient(this.client)
+  }
+
+  get thermostats(): SeamHttpThermostats {
+    return SeamHttpThermostats.fromClient(this.client)
+  }
+
+  get webhooks(): SeamHttpWebhooks {
+    return SeamHttpWebhooks.fromClient(this.client)
+  }
+
   get workspaces(): SeamHttpWorkspaces {
     if (this.#legacy) {
       return SeamHttpLegacyWorkspaces.fromClient(this.client)

src/lib/seam/connect/routes/access-codes.ts

@@ -24,6 +24,8 @@ import {
 } from 'lib/seam/connect/client-options.js'
 import { parseOptions } from 'lib/seam/connect/parse-options.js'
 
+import { SeamHttpAccessCodesUnmanaged } from './access-codes-unmanaged.js'
+
 export class SeamHttpAccessCodes {
   client: Axios
 
@@ -68,6 +70,10 @@ export class SeamHttpAccessCodes {
     return new SeamHttpAccessCodes(opts)
   }
 
+  get unmanaged(): SeamHttpAccessCodesUnmanaged {
+    return SeamHttpAccessCodesUnmanaged.fromClient(this.client)
+  }
+
   async create(
     body: AccessCodesCreateBody,
   ): Promise<AccessCodesCreateResponse['access_code']> {