feat: Add and require resource_type for all error codes

package.json

@@ -74,7 +74,7 @@
     "zod": "^3.23.8"
   },
   "devDependencies": {
-    "@seamapi/types": "^1.804.0",
+    "@seamapi/types": "^1.922.0",
     "@swc/core": "^1.11.29",
     "@types/node": "^24.10.9",
     "ava": "^6.0.1",

src/lib/blueprint.ts

@@ -391,6 +391,7 @@ export interface DiscriminatedListProperty extends BaseListProperty {
   discriminator: string
   variantGroups: VariantGroup[]
   variants: Array<{
+    resourceType: string | null
     variantGroupKey: string | null
     properties: Property[]
     description: BaseProperty['description']
@@ -1794,6 +1795,20 @@ const createArrayProperty = (
         discriminator: prop.items.discriminator.propertyName,
         variantGroups,
         variants: prop.items.oneOf.map((schema) => {
+          const errorCode = schema.properties?.['error_code']?.enum?.[0]
+
+          if (
+            errorCode != null &&
+            !(
+              'x-resource-type' in schema &&
+              schema['x-resource-type'] != null &&
+              schema['x-resource-type'].length > 0
+            )
+          ) {
+            throw new Error(`Missing resource_type for error code ${errorCode}`)
+          }
+
+          const resourceType = schema['x-resource-type'] ?? null
           const variantGroupKey = schema['x-variant-group-key'] ?? null
           validateGroupKey(
             variantGroupKey,
@@ -1802,6 +1817,7 @@ const createArrayProperty = (
             variantGroups,
           )
           return {
+            resourceType,
             variantGroupKey,
             properties: createProperties(
               schema.properties ?? {},

src/lib/openapi/types.ts

@@ -84,6 +84,7 @@ export interface OpenapiSchema {
   'x-draft'?: string
   'x-undocumented'?: string
   'x-route-path'?: string
+  'x-resource-type'?: string
   'x-variant-group-key'?: string
   'x-enums'?: Record<
     string,

test/blueprint.test.ts

@@ -105,3 +105,40 @@ test('createBlueprint: throws when a documented endpoint references an undocumen
       /Documented endpoints must not reference undocumented resources\. Found:\n.*\/widgets\/get.*secret_widget/,
   })
 })
+
+test('createBlueprint: throws when an error code is missing resource_type', async (t) => {
+  const typesModule = TypesModuleSchema.parse(types)
+  const openapi = structuredClone(typesModule.openapi)
+
+  const fooSchema = openapi.components.schemas['foo']
+  if (fooSchema?.properties == null) {
+    t.fail('Expected foo schema to have properties')
+    return
+  }
+
+  fooSchema.properties['errors'] = {
+    type: 'array',
+    items: {
+      discriminator: { propertyName: 'error_code' },
+      oneOf: [
+        {
+          type: 'object',
+          properties: {
+            error_code: {
+              type: 'string',
+              enum: ['foo_error'],
+            },
+            message: {
+              type: 'string',
+            },
+          },
+          required: ['error_code', 'message'],
+        },
+      ],
+    },
+  }
+
+  await t.throwsAsync(() => createBlueprint({ ...typesModule, openapi }), {
+    message: /Missing resource_type for error code foo_error/,
+  })
+})