aws-cdk-go@v2.221.0: deploy not working due to undefined value

[nicolasalberti00]

Describe the bug

Hi, I get this error when trying to deploy my code via CDK:

github.com/aws/aws-cdk-go/awscdk/v2/awsstepfunctions

--
../pkg/mod/github.com/aws/aws-cdk-go/awscdk/v2@v2.221.0/awsstepfunctions/StateMachineProps.go:65:18: undefined: awsiam
go mod download && go run infra/infra.go: Subprocess exited with error 1

This happens when updating the CDK to the latest version, the issue is not present in version 2.220.0.

Regression Issue

• Select this option if this issue appears to be a regression.

Last Known Working CDK Library Version

2.220.0

Expected Behavior

I expect the deploy to work correctly.

Current Behavior

This is the error from the Go CDK:

github.com/aws/aws-cdk-go/awscdk/v2/awsstepfunctions

--
../pkg/mod/github.com/aws/aws-cdk-go/awscdk/v2@v2.221.0/awsstepfunctions/StateMachineProps.go:65:18: undefined: awsiam

Reproduction Steps

Update to version 2.221.0 of the CDK and use the stepfunctions package import and try to deploy the changes via CDK.

Possible Solution

Maybe there is a missing import statement for the awsiam package.

Additional Information/Context

No response

AWS CDK Library version (aws-cdk-lib)

2.221.0

AWS CDK CLI version

2.1021.0

Node.js Version

20.13.1

OS

Ubuntu 24.04

Language

Go

Language Version

1.25.3

Other information

No response

[wgrea]

It looks like StateMachineProps.go references awsiam without importing it — which breaks the Go build with undefined: awsiam.

This might be a missing dependency in the jsii-generated bindings for Go. If you manually add this import:

import "github.com/aws/aws-cdk-go/awscdk/v2/awsiam"

[pahud]

investigating

[pahud]

Hi @nicolasalberti00,

Thank you for reporting this issue. This seems to be a regression in v2.221.0 affecting Go users of the Step Functions module.

Root Cause:
In v2.221.0, we changed the StateMachineProps.role property from iam.IRole to an intersection type iam.IRoleRef & iam.IGrantable (see PR #35770). While this change works correctly in TypeScript, the jsii Go code generator doesn't properly add the required import statement for the awsiam package when generating code for intersection types, resulting in the compilation error you're seeing.

---

Error with v2.221.0

# github.com/aws/aws-cdk-go/awscdk/v2/awsstepfunctions
../../../go/pkg/mod/github.com/aws/aws-cdk-go/awscdk/v2@v2.221.0/awsstepfunctions/StateMachineProps.go:65:18: undefined: awsiam

Root Cause Confirmed

v2.220.0 (Working):

// StateMachineProps.go imports:
import (
	"github.com/aws/aws-cdk-go/awscdk/v2"
)

// Role field:
Role awsiam.IRole `field:"optional" json:"role" yaml:"role"`

v2.221.0 (Broken):

// StateMachineProps.go imports:
import (
	"github.com/aws/aws-cdk-go/awscdk/v2"
)
// ❌ Missing: "github.com/aws/aws-cdk-go/awscdk/v2/awsiam"

// Role field (intersection type):
Role interface{ awsiam.IRoleRef;awsiam.IGrantable } `field:"optional" json:"role" yaml:"role"`
//              ^^^^^^ undefined - no import!

I am bringing this up to the team for review.

[nicolasalberti00]

Thank you very much for your help and fast investigation, waiting for the fix.

[github-actions]

Comments on closed issues and PRs are hard for our team to see.
If you need help, please open a new issue that references this one.