feat: Generate a status-discriminated action attempt union

codegen/layouts/partials/resource-object.hbs

@@ -1,6 +1,6 @@
 {
 {{#each properties}}
   {{> doc}}
-  {{json name}}{{#if isOptional}}?{{/if}}: {{> resource-property-type }}{{#if isNullable}} | null{{/if}}{{#if isOptional}} | undefined{{/if}}
+  {{json name}}{{#if isOptional}}?{{/if}}: {{#if renderAsNull}}null{{else}}{{> resource-property-type }}{{#if isNullable}} | null{{/if}}{{/if}}{{#if isOptional}} | undefined{{/if}}
 {{/each}}
 }

codegen/lib/layouts/resources.ts

@@ -1,4 +1,10 @@
-import type { Blueprint, Resource } from '@seamapi/blueprint'
+import type {
+  ActionAttemptStatus,
+  Blueprint,
+  EnumProperty,
+  Property,
+  Resource,
+} from '@seamapi/blueprint'
 import { kebabCase, pascalCase } from 'change-case'
 
 export interface ResourceLayoutContext {
@@ -39,7 +45,7 @@ export const getResourceLayoutContexts = (
       ({ resourceType }) => !discriminatedResourceTypes.has(resourceType),
     ),
     ...blueprint.events,
-    ...blueprint.actionAttempts,
+    ...blueprint.actionAttempts.flatMap(expandActionAttemptByStatus),
   ]
   const resourceTypes = [
     ...new Set(resources.map(({ resourceType }) => resourceType)),
@@ -57,6 +63,44 @@ export const getResourceLayoutContexts = (
   }))
 }
 
+// Expand an action attempt into one union member per status from its status
+// enum. In each member, the status property is rendered as the status literal,
+// and any property annotated with actionAttemptStatuses is rendered as null
+// for the statuses it does not list.
+const expandActionAttemptByStatus = (resource: Resource): Resource[] => {
+  const statusProperty = resource.properties.find(
+    (property): property is EnumProperty =>
+      property.name === 'status' && property.format === 'enum',
+  )
+  if (statusProperty == null) return [resource]
+
+  return statusProperty.values.map(({ name }) => {
+    const status = name as ActionAttemptStatus
+    return {
+      ...resource,
+      properties: resource.properties.map((property): Property => {
+        if (property === statusProperty) {
+          return {
+            ...statusProperty,
+            values: statusProperty.values.filter(
+              (value) => value.name === status,
+            ),
+          }
+        }
+        const { actionAttemptStatuses } = property
+        if (actionAttemptStatuses == null) return property
+        if (actionAttemptStatuses.includes(status)) return property
+        const nullRenderedProperty: Property & { renderAsNull: true } = {
+          ...property,
+          isNullable: false,
+          renderAsNull: true,
+        }
+        return nullRenderedProperty
+      }),
+    }
+  })
+}
+
 const getBatchResourceLayoutContexts = (
   resources: Resource[],
 ): BatchResourceLayoutContext[] => {

package.json

@@ -85,7 +85,7 @@
     "axios-retry": "^4.4.2"
   },
   "devDependencies": {
-    "@seamapi/blueprint": "^1.9.1",
+    "@seamapi/blueprint": "^1.10.0",
     "@seamapi/fake-seam-connect": "^2.0.4",
     "@seamapi/smith": "^1.1.0",
     "@seamapi/types": "1.1047.0",

src/lib/resolve-action-attempt.ts

@@ -162,13 +162,15 @@ const isFailedActionAttempt = <T extends ActionAttempt>(
 /**
  * An action attempt that has succeeded.
  */
-export type SucceededActionAttempt<T extends ActionAttempt> = T & {
-  status: 'success'
-}
+export type SucceededActionAttempt<T extends ActionAttempt> = Extract<
+  T,
+  { status: 'success' }
+>
 
 /**
  * An action attempt that has failed.
  */
-export type FailedActionAttempt<T extends ActionAttempt> = T & {
-  status: 'error'
-}
+export type FailedActionAttempt<T extends ActionAttempt> = Extract<
+  T,
+  { status: 'error' }
+>