feat: support nested routes and configurable stage in SecureRestApi

[toddhainsworth]

Summary

Two changes to @aligent/cdk-secure-rest-api (released together as a minor):

Nested route paths

The routes helper only worked for single-segment paths. Any path with more than one segment (e.g. rewards/accounts/{accountId}/redeem) threw ResourceSPathPartOnly at synth time, because the construct passed the entire path to IResource.addResource, which only accepts a single path part. Swapped to IResource.resourceForPath, which splits on /, creates intermediate resources, and is idempotent for shared prefixes. The leading-slash strip is preserved for backwards compatibility.

Configurable deployment stage (requested by Kai)

The stage name was always prod (CDK's default). Added a deployOptions?: StageOptions prop passed straight through to the underlying RestApi, so callers can set stageName (and any other stage settings — logging, tracing, etc.). Defaults to the CDK prod stage when omitted.

new SecureRestApi(this, 'Api', {
  apiName: 'my-api',
  deployOptions: { stageName: 'staging' },
  routes: [...],
});

Changes

• lib/secure-rest-api.ts — resourceForPath; new deployOptions prop
• Tests (17 total): nested route method registration, intermediate resource creation, shared-prefix resolution (shared parent created once + both leaf methods registered), custom stage name, default prod stage
• README — nested-path + stage-name features, examples, reference entries
• Changeset (minor)

Testing

• yarn nx test secure-rest-api — 17/17 pass
• yarn nx lint secure-rest-api — clean

[kai-nguyen-aligent]

haha, you beat me on this, @toddhainsworth I have this in my personal kanban too. Could you please also support deployOptions: { stageName } so we can set API gateway stageName? At the moment, it's always prod.

[toddhainsworth]

haha, you beat me on this, @toddhainsworth I have this in my personal kanban too. Could you please also support deployOptions: { stageName } so we can set API gateway stageName? At the moment, it's always prod.

☑️

[kai-nguyen-aligent]

LGTM!