feat(jsii): added warnings for usage of deprecated elements

[otaviomacedo]

General idea:

First, DeprecationWarningsInjector.process() consumes the assembly. For each complex type in the assembly, it generates a function responsible for calling the print function if the type is deprecated. For each struct property or enum member, it also generates a call to the function corresponding to the type of that property or member. This creates a call tree that mirrors the type tree (including recursive functions that mirror recursive types).

Then Transformer traverses the AST and for each parameter of a method, it injects into that method a call to the function corresponding to the type of that parameter.

For example, for the types:

/** @deprecated Use something else */
interface Foo {
  readonly bar: Bar;
}

interface Bar {
  readonly bar: Bar;
}

we get:

module_name_Foo(p) {
  if (p) { // <-- this if is to make sure we only print a warning if the user assigned it a value
    print(p, "module_name.Foo", "Use something else");
    module_name_Bar(p.bar);
  }
}

module_name_Bar(p) {
  if (p) {
    module_name_Bar(p.bar);
  }
}

Then, if we have a method like:

/** @deprecated Do something else */
doSomething(foo: Foo, bar: Bar) {}

the following calls will be injected into doSomething:

print("", "module_name.SomeClass#doSomething", "Do something else");
module_name_Foo(foo);
module_name_Bar(bar);

---

By submitting this pull request, I confirm that my contribution is made under the terms of the Apache 2.0 license.

[mergify]

The title of this Pull Request does not conform with [Conventional Commits] guidelines. It will need to be adjusted before the PR can be merged.
[Conventional Commits]: https://www.conventionalcommits.org

[rix0rrr]

I think I'd prefer AssertionError to be called something else (DeprecationError seems logical?).

Other than that, I think we thought of most things that could become a problem. Let's make sure we try it out on an actual CDK build and poke at it (integration test), and then let's go ahead and merge!

Pull request has been modified.

[mergify]

Thank you for contributing! ❤️ I will now look into making sure the PR is up-to-date, then proceed to try and merge it!

[mergify]

Merging (with squash)...

[mergify]

Merging (with squash)...