> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spendowl.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Changelog

> Version history and release notes

# Changelog

All notable changes to the SpendOwl iOS SDK.

## \[1.0.0] - 2026-01-15

### Initial Release

The first public release of the SpendOwl iOS SDK.

#### Features

* **Attribution Tracking**
  * Apple Search Ads attribution via AdServices
  * Campaign, ad group, and keyword data
  * Country/region and conversion type
  * Supply placement support

* **Purchase Tracking**
  * Automatic StoreKit 2 observation
  * Supports all transaction types (consumables, subscriptions, etc.)
  * Works alongside RevenueCat and Adapty

* **User Identity**
  * `setUserId()` for linking to user accounts
  * Anonymous ID fallback with Keychain persistence
  * `clearUserId()` for logout

* **Configuration**
  * Simple one-line setup: `SpendOwl.configure(apiKey:)`
  * Custom timeout and retry settings
  * Thread-safe, Sendable API

* **Debugging**
  * Multiple log levels (none, error, info, debug)
  * os\_log integration for Console.app
  * Comprehensive error types

* **Privacy**
  * No IDFA required
  * Privacy manifest included
  * GDPR/CCPA compliant

#### Platforms

* iOS 15.0+
* macOS 12.0+
* Swift 5.9+
* Xcode 15.0+

***

## Upgrading

### From Beta

If you were using a beta version:

1. Remove the old package dependency
2. Add the release version:
   ```
   https://github.com/spendowl/spendowl-ios
   ```
3. Update any deprecated method calls (none in 1.0.0)
4. Clean build folder (**Product → Clean Build Folder**)

***

## Roadmap

Upcoming features planned for future releases:

* **macOS Catalyst support**
* **visionOS support**
* **Offline mode** — Queue events when offline
* **Server-to-server purchases** — Webhook integration
* **Custom events** — Track custom conversion events

***

## Semantic Versioning

SpendOwl follows [Semantic Versioning](https://semver.org/):

* **MAJOR** version for incompatible API changes
* **MINOR** version for backwards-compatible features
* **PATCH** version for backwards-compatible bug fixes

***

## Stay Updated

<CardGroup cols={2}>
  <Card title="GitHub Releases" icon="github" href="https://github.com/spendowl/spendowl-ios/releases">
    Watch for new releases
  </Card>

  <Card title="X" icon="twitter" href="https://x.com/spendowl_io">
    Follow for updates
  </Card>
</CardGroup>