add generic types, ResourceType and SafeAccess

src/lib/blueprint.ts

@@ -1,28 +1,36 @@
 import type { Openapi } from './openapi.js'
 
-export interface Blueprint {
+export interface Blueprint<T extends TypesModule> {
   name: string
-  routes: Route[]
-  resources: Record<ResourceType, Resource>
+  routes: Array<Route<T>>
+  resources: Partial<Record<ResourceType<T>, Resource<T>>>
 }
 
-interface Route {
+interface Route<T extends TypesModule> {
   path: string
   namespace: Namespace | null
-  endpoints: Endpoint[]
-  subroutes: Route[]
+  endpoints: Array<Endpoint<T>>
+  subroutes: Array<Route<T>>
 }
 
-interface Resource {
-  resourceType: ResourceType
+interface Resource<T extends TypesModule> {
+  resourceType: ResourceType<T>
   properties: Property[]
 }
 
+// Helper type to safely access nested properties of openapi schema - defualt to unknown if not found
+type SafeAccess<T, K extends string> = K extends keyof T ? T[K] : unknown
+
+type ResourceType<T extends TypesModule> = keyof SafeAccess<
+  SafeAccess<T['openapi'], 'components'>,
+  'schemas'
+>
+
 interface Namespace {
   path: string
 }
 
-interface Endpoint {
+interface Endpoint<T extends TypesModule> {
   name: string
   path: string
   methods: Method[]
@@ -34,7 +42,7 @@ interface Endpoint {
   deprecationMessage: string
   parameters: Parameter[]
   request: Request
-  response: Response
+  response: Response<T>
 }
 
 interface Parameter {
@@ -53,11 +61,11 @@ interface Request {
   parameters: Parameter[]
 }
 
-interface Response {
+interface Response<T extends TypesModule> {
   description: string
   responseType: 'resource' | 'resource_list' | 'void'
   responseKey: string | null
-  resourceType: ResourceType | null
+  resourceType: ResourceType<T>
 }
 
 interface Property {
@@ -66,15 +74,15 @@ interface Property {
   properties: Property[] | null
 }
 
-type ResourceType = 'access_code' | 'user' | 'order' | string
-
 type Method = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH'
 
 export interface TypesModule {
   openapi: Openapi
 }
 
-export const createBlueprint = ({ openapi }: TypesModule): Blueprint => {
+export const createBlueprint = <T extends TypesModule>({
+  openapi,
+}: T): Blueprint<T> => {
   return {
     name: openapi.info.title,
     routes: [],