feat: application subscriptions

[shiftinv]

Summary

discord/discord-api-docs@b97fad3 (+ discord/discord-api-docs@b8feadd)

Since this feature is US-only, I'm unable to test most of it; still working on that part.
Nevertheless, all documented functionality is implemented. The SKU/Entitlement models have been tested using the example structs provided by the docs, but that's really it. Tested all implemented functionality now.

There are a few TODOs scattered across the code regarding testing and naming some things; feedback for those would be appreciated. The api docs are lacking in a few aspects (gateway events, in particular, are somewhat of a guessing game), but most of it is fairly straightforward.

Checklist

• If code changes were made, then they have been tested
  • I have updated the documentation to reflect the changes
  • I have formatted the code properly by running pdm lint
  • I have type-checked the code by running pdm pyright
• This PR fixes an issue
• This PR adds something new (e.g. new method or parameters)
• This PR is a breaking change (e.g. methods or parameters removed/renamed)
• This PR is not a code change (e.g. documentation, README, ...)

[Skelmis]

Would you be able to provide/add an example to this pull request show casing how an end user would be able to utilize this functionality to mark a slash command as requiring premium? I can see it being quite a regular thing coming up in the future so the clarity would be nice

[shiftinv]

Would you be able to provide/add an example to this pull request show casing how an end user would be able to utilize this functionality to mark a slash command as requiring premium? I can see it being quite a regular thing coming up in the future so the clarity would be nice

good point, thanks! Added in 989327a.
You don't preemptively mark certain commands as premium-only - it's a separate response type like e.g. .send_message or .defer. Ultimately it comes down to checking inter.entitlements and using response.require_premium() where needed.

[shiftinv]

Removed the SKU/entitlement HTTP endpoints in 4b66b52 due to https://github.com/discord/discord-api-docs/pull/6502/files#diff-39e6aeaafba5726f3fb409da21a6953dfb679480f09038a0d05f4dd93e89e074R11 :/
Hoping replacements will be available sooner rather than later, but I want to avoid changing this entire PR back to a draft; Interaction.entitlements is still the main app subscription interface. If the decision gets reverted, we can just reintroduce that commit again.

edit: reverted the revert again, as the linked changes were decided against.

[ijsbol]

Please merge this 🙏🙏🙏

[ijsbol]

🚀 LFG i’m a god