Add factory function to create reusable parameter decorators that map
AuthContext to custom shapes, reducing boilerplate in controllers.

- createAuthParamDecorator<T>(mapper: (auth: AuthContext) => T)
- AuthContext interface with session, user, org, apiKey, etc.
- Unit tests, e2e tests, example usage, README documentation
- Remove deprecated Public/Optional aliases