feat: API transformers

[lonnieezell]

Description

Adds API Transformers to CodeIgniter. This helps enforce best practices of never providing your entire object's values to the API. Instead, you would use a Transformer to build the API's response objects. This also allows:

• Custom includes into the object (often for related models, but not required)
• Allows the API consumer to limit the fields or includes returned
• Integrates into the API pagination just introduced.
• a CLI command to create starter Transformers

Checklist:

• Securely signed commits
• Component(s) with PHPDoc blocks, only if necessary or adds value (without duplication)
• Unit testing, with >80% coverage
• User guide updated
• Conforms to style guide

[michalsn]

Not sure about the when / whenNot methods - they don't seem to bring much value, since they're basically just short if statement replacements. They could also be confusing at first glance because of our ConditionalTrait. But that might just be a first impression.

Seems like Deptrac rules have to be updated.

Overall, this seems like a really useful feature for people who work with APIs often.

[lonnieezell]

Not sure about the when / whenNot methods - they don't seem to bring much value, since they're basically just short if statement replacements. They could also be confusing at first glance because of our ConditionalTrait. But that might just be a first impression.

No, you're right I think. It's mainly syntactic sugar and not really necessary. I'll remove them for now. I even looked at our ConditionalTrait to see if we could use it and it wouldn't work nicely so it's probably just confusing.

Thanks.

[michalsn]

Looks great!

[paulbalandan]

Just reviewed on phone. I'll review again later but here are some comments.

[paulbalandan]

Looks good to me!