SyntaxCircus.RevenueCat.Maui 0.1.2

SyntaxCircus.RevenueCat.Maui

Client-side RevenueCat helpers for MAUI apps, built on top of Kebechet.Maui.RevenueCat.InAppBilling (the vendor SDK binding — not reimplemented here). Covers SDK initialization, identity sync on login, offering-to-DTO mapping, and a purchase/restore orchestrator.

For backend-side RevenueCat integration (webhook verification, REST clients), see SyntaxCircus.RevenueCat.

No support guaranteed. Published as-is and maintained on a best-effort basis. Issues and PRs are welcome, but there's no SLA — fork it or vendor what you need if that's not enough.

Targets

net10.0-android and net10.0-ios only, matching the vendor SDK's proven real-world coverage. Add maccatalyst/windows yourself if you've verified Kebechet.Maui.RevenueCat.InAppBilling supports them for your use case.

What this library does

Quick start

1. Register the service

// MauiProgram.cs
builder.Services.AddRevenueCatMaui(builder.Configuration); // binds "RevenueCat", registers IRevenueCatBilling

{
  "RevenueCat": {
    "AndroidApiKey": "goog_...",
    "IosApiKey": "appl_..."
  }
}

2. Initialize the SDK early

// App.xaml.cs — initialize once, early in the app lifecycle
protected override void OnStart()
{
    RevenueCatInitializer.TryInitialize(_billing, _options.Value);
    base.OnStart();
}

For test hosts or other non-mobile entry points, you can also choose the platform explicitly:

RevenueCatInitializer.TryInitialize(_billing, _options.Value, RevenueCatPlatform.Android);

Or supply your own key resolver:

RevenueCatInitializer.TryInitialize(_billing, _options.Value, options => options.IosApiKey);

These are the public (publishable) per-platform keys from the RevenueCat dashboard — safe to ship inside the app binary, distinct from the server-side secret key SyntaxCircus.RevenueCat uses.

Common flows

Identity sync

Point RevenueCat's app_user_id at your own user id as soon as you know it (e.g. after login), so purchases and the TRANSFER webhook event correctly re-associate across reinstalls and new devices:

await RevenueCatIdentitySync.SyncLoginAsync(billing, userId, logger, ct);

Failures are logged and swallowed — this is best-effort, not something worth failing app startup over.

Products

IReadOnlyList<RevenueCatProduct> products =
    await RevenueCatOfferingsMapper.GetCurrentProductsAsync(billing, ct: ct);

Purchases and restore

RevenueCatPurchaseResult result =
    await RevenueCatPurchaseOrchestrator.PurchaseAsync(billing, productIdentifier, logger, ct);

if (result.Success)
{
    // record result.TransactionId / result.AppUserId against your own backend here
}
else if (result.WasCancelled)
{
    // user-initiated cancellation, not an error
}

If you need custom package selection logic, use the resolver overload of PurchaseAsync(...).

RevenueCatPurchaseResult customResult =
    await RevenueCatPurchaseOrchestrator.PurchaseAsync(
        billing,
        productIdentifier,
        logger,
        (packages, id) => packages.FirstOrDefault(p => p.Identifier == id || p.Product.Sku == id),
        ct);

RevenueCatPurchaseResult restoreResult =
    await RevenueCatPurchaseOrchestrator.RestoreAsync(billing, userId, logger, ct);

PurchaseAsync and RestoreAsync only own the store interaction — recording a successful purchase against your own backend (subscriber verification, entitlement grants, etc.) is deliberately left to the caller, the same split SyntaxCircus.RevenueCat's webhook reader uses on the backend side.

Behavior notes

• PurchaseAsync returns WasCancelled = true for a user-cancelled store flow instead of throwing.
• RestoreAsync logs and returns a failure result for non-cancellation errors.
• The default TryInitialize(billing, options) method keeps the existing compile-time Android/iOS behavior.
• The explicit RevenueCatPlatform and resolver overloads are the non-breaking escape hatches for tests and custom hosts.

Contributing

Issues and pull requests are welcome:

• Keep changes focused, with a clear description of the behavior change.
• Match the existing code style (see .editorconfig).
• Call out any breaking changes to the public API in your PR description.

License

MIT — see LICENSE.txt.