Why does the CDK example include a UUID api?

[coffeedome]

Why does the example include a class UuidApi extends Construct? (class UuidApi extends Construct {} section)? It seems to have nothing to do with the Items API in that same example.

Link to example:

powertools-lambda-typescript/examples/cdk/src/example-stack.ts

Line 110 in 4e6f662

class UuidApi extends Construct {

[dreamorosi]

Hi @coffeedome, the goal of the examples in the repository is to showcase usage of the Powertools utilities with projects deployed via CDK or SAM.

The UUID API specifically is used here as a standalone REST API that accepts an HTTP request and returns a new UUID. As part of the UuidApi construct, we also store an SSM parameter with the url of the API.

This parameter is then later used by some of the functions (i.e. here or here) to obtain UUIDs. This allows us to showcase how to use the Parameters utility in your functions.

I agree that this example is somewhat trite and that we could improve the example by showing how to retrieve something more useful from SSM / Secrets Manager / etc, however in this case we opted for keeping the example simple over usefulness.

I hope this answers your question.

[dreamorosi]

We have refactored the examples some time ago to remove the API mentioned above, also in part because of this discussion evidencing it was confusing.