s3.Bucket.import Type Error

Describe the bug s3.Bucket.import is throwing a type error. Did something change? All the docs I can find including the source code docs make it seem like this should work.

To Reproduce

import * as s3 from '@aws-cdk/aws-s3'

export class AppStack extends cdk.Stack {
  constructor(scope: cdk.Construct, id: string, props?: cdk.StackProps) {
    super(scope, id, props)

    const bucket = s3.Bucket.import(this, {
      bucketArn: `arn:aws:s3:::bucket-name`
    })
  }
}
const app = new cdk.App()

Expected behavior No type error

Version:

• OS OSX
• Programming Language Node.JS+Typescript
• CDK Version 0.33.0

[rmichaelb]

Shouldn’t it actually be: const bucket: Bucket = s3.Bucket.fromBucketArn(this, 'importedBucketFromARN', 'someBucketArn')

Rather in reality its: const bucket: IBucket = s3.Bucket.fromBucketArn(this, 'importedBucketFromARN', 'someBucketArn')

Why wouldn’t fromBucketArn return the Class/an instance rather than the Interface? With it returning the IBucket Interface it makes it impossible to “import” a bucket from another nested stack, thus creating circular dependencies.

Does anyone have a workaround for this?

[RomainMuller]

The inline doc is clearly outdated/incorrect here.