`I<Resource>` interfaces should have `grants`

[Tietew]

Describe the feature

Now, most of L2 constructs introduce grants.
But grants are not included in I<Resoure> interfaces, differ from grantXxxx() methods.
These interfaces should have grants.

Use Case

Currently we can grant actions via both grants and grantXxxx() on concrete construct instance:

const topic = new sns.Topic(this, 'Topic');
// OK - Topic has grantPublish() method
topic.grantPublish(grantee);
// OK - Topic has grants property
topic.grants.publish(grantee);

We cannot do via grants on resource interface:

declare const topic: sns.ITopic;
// OK - ITopic has grantPublish() method
topic.grantPublish(grantee);
// ERROR - ITopic has no grants property
topic.grants.publish(grantee);

Proposed Solution

No response

Other Information

Related PR: #36124

Acknowledgements

• I may be able to implement this feature request
• This feature might incur a breaking change

AWS CDK Library version (aws-cdk-lib)

2.231.0

AWS CDK CLI version

2.1033.0

Environment details (OS name and version, etc.)

Linux

[rix0rrr]

We are trying to have individual pieces that work together, without tying them together too much.

So the design will be:

declare const: iresource: IResource | IResourceRef;

// No:
iresource.grants

// Yes
ResourceGrants.fromResource(iresource)