Changelog

Unreleased

Preferences; they need an Anikeen ID release that supports them.

Preferences of any user with the app's token (trusted apps, registered by Anikeen per namespace): preferencesByUserId(), preferenceByUserId(), setPreferenceByUserId(), deletePreferenceByUserId() and findUserIdByPreference() (the user holding a value of a unique key, null when nobody does).
The user's shared preferences with their token: globalPreferences(), globalPreference(), setGlobalPreference() and deleteGlobalPreference() on Billable, cached per instance.
Resources\Preference and Resources\Preferences; Enums\SharedPreference and Enums\Appearance.
Conditional writes: ifVersion (If-Match) and createOnly (If-None-Match: *); PreconditionFailedException (a subclass of ApiException) for 412 with currentVersion().
Scopes Scope::PREFERENCES, PREFERENCES_READ and PREFERENCES_CLIENT.
Webhook event order.refunded (EventType::ORDER_REFUNDED).
An optional trailing $headers argument on AnikeenId::request(), get(), post(), put(), delete() and AppRequest::send(); calls without it send the same request as before.

App billing features; they need an Anikeen ID release that supports them.

Free trials: trial_days / trial_ends_at (optional trial_once, trial_payment_method with TrialPaymentMethod::REQUIRED / OPTIONAL) when creating subscriptions and checkout sessions; Subscription::isTrial().
Discounts per billed period: discount with percent_off or amount_off, duration and label.
Plan changes of running subscriptions: AppSubscription::change() (apply: now or period_end) and AppSubscription::cancelScheduledChange().
App orders: order lines with subscription, period, net amount and discount; AppOrders::invoicePdf(). Confirmable orders of trusted apps (confirm: true).
Billing portal links that work without a login: createBillingPortalLinkForUser() and appBillingPortalUrl().
Webhook events subscription.trial_will_end, subscription.discount_ended, subscription.updated and subscription.renewed (EventType::SUBSCRIPTION_*); data.reason with CancellationReason::TRIAL_ENDED_WITHOUT_PAYMENT_METHOD.

Elapsed-period billing and user lookup; they need an Anikeen ID release that supports them.

AppSubscription::checkout() takes billElapsedPeriods and maxNetAmount: a subscription started more than one period ago is billed for its elapsed periods too, up to the given net amount (409 elapsed_amount_exceeded with net_amount, elapsed_periods_not_allowed). Calls without the new arguments send the same request as before.
ApiException::body() returns the JSON body of Anikeen ID's error response, e.g. its net_amount.
Add AnikeenId::findUserByEmail() for trusted apps: looks up an account by email address (regardless of case) without creating one, null when there is none.
createUser() documents name, password_confirmation and send_invitation (a newly created account gets an invitation mail to set a password) and the response fields created and invitation_sent.

Add the scope products:read (Scope::PRODUCTS_READ) for read-only access to the product APIs of the Anikeen Console.
Add the reseller scopes reseller-customers:read, reseller-customers, reseller-grants and reseller-orders (Scope::RESELLER_CUSTOMERS_READ, Scope::RESELLER_CUSTOMERS, Scope::RESELLER_GRANTS, Scope::RESELLER_ORDERS) for the reseller API of the Anikeen Console.
Document the scope schema and the new scopes in the README.

Older releases: see the GitHub releases and tags.