✨ Add Movie Service missing endpoints and models (#259)

* 🔧 Add .worktrees/ to .gitignore

Add worktree directory to .gitignore to prevent accidentally committing
worktree contents when working on multiple features in parallel.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* ✨ Add Movie Service missing endpoints and models

Implement Plan 1: Movie Service Additions - adds 9 missing endpoints to
achieve 100% API coverage for Movie Service.

**New Models:**
- AccountStates - User rating, favorite, and watchlist state
- AlternativeTitle - Alternative titles by country
- Translation<T> - Generic translation model
- MovieTranslationData - Movie-specific translation data
- Change models - Change tracking for sync/caching
- AnyCodable - Type-erased codable for dynamic JSON values

**New Methods:**
- accountStates(forMovie:session:) - Get user interaction state
- addRating(_:toMovie:session:) - Add movie rating
- deleteRating(forMovie:session:) - Delete movie rating
- alternativeTitles(forMovie:country:language:) - Get alternative titles
- translations(forMovie:) - Get movie translations
- lists(forMovie:page:language:) - Get lists containing movie
- changes(forMovie:startDate:endDate:page:) - Get movie change history
- latest() - Get latest movie added to TMDb
- changes(startDate:endDate:page:) - Get changed movie IDs

**Tests:**
- Added comprehensive model tests with JSON fixtures
- All 1530 unit tests pass
- Uses #require() instead of force unwrapping

**Documentation:**
- Updated MovieService.md with new method groups
- Added all new models to TMDb.md
- Documentation builds without warnings

**API Coverage:**
- Before: 15/24 endpoints (63%)
- After: 24/24 endpoints (100%)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* 🐛 Fix linting issues in Movie Service

- Fix opening brace spacing in Translation.swift (lines 14 and 84)
- Disable type_body_length warning for TMDbMovieService (302 lines with 24+ methods)

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* 🎨 Apply code formatting and fix linting issues

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

* Add missing tests

* Fix integration tests

---------

Co-authored-by: Claude Sonnet 4.5 <noreply@anthropic.com>

Author: adamayoung

.gitignore

@@ -12,4 +12,7 @@ default.profraw
 junit-swift-testing.xml
 
 # Claude
-.claude/settings.local.json
+.claude/settings.local.json
+
+# Git worktrees
+.worktrees/

Package.resolved

@@ -56,5 +56,8 @@ extension APIRequestQueryItem.Name {
     static let apiKey = APIRequestQueryItem.Name("api_key")
     static let externalSource = APIRequestQueryItem.Name("external_source")
     static let timezone = APIRequestQueryItem.Name("timezone")
+    static let country = APIRequestQueryItem.Name("country")
+    static let startDate = APIRequestQueryItem.Name("start_date")
+    static let endDate = APIRequestQueryItem.Name("end_date")
 
 }

Sources/TMDb/Domain/APIClient/APIRequestQueryItem.swift

@@ -0,0 +1,83 @@
+//
+//  AccountStates.swift
+//  TMDb
+//
+//  Copyright © 2026 Adam Young.
+//
+
+import Foundation
+
+///
+/// A model representing the account state for a media item.
+///
+/// Provides information about whether the media has been rated, added to a watchlist, or marked as favorite
+/// by the authenticated user.
+///
+public struct AccountStates: Codable, Equatable, Hashable, Sendable {
+
+    ///
+    /// The media item identifier.
+    ///
+    public let id: Int
+
+    ///
+    /// Indicates if the media is marked as a favorite.
+    ///
+    public let favorite: Bool
+
+    ///
+    /// The user's rating for the media.
+    ///
+    /// `nil` if the media has not been rated.
+    ///
+    public let rated: RatedValue?
+
+    ///
+    /// Indicates if the media is on the user's watchlist.
+    ///
+    public let watchlist: Bool
+
+    ///
+    /// Creates an account states object.
+    ///
+    /// - Parameters:
+    ///    - id: The media item identifier.
+    ///    - favorite: Indicates if the media is marked as a favorite.
+    ///    - rated: The user's rating for the media.
+    ///    - watchlist: Indicates if the media is on the user's watchlist.
+    ///
+    public init(id: Int, favorite: Bool, rated: RatedValue?, watchlist: Bool) {
+        self.id = id
+        self.favorite = favorite
+        self.rated = rated
+        self.watchlist = watchlist
+    }
+
+}
+
+public extension AccountStates {
+
+    ///
+    /// A model representing a rating value.
+    ///
+    struct RatedValue: Codable, Equatable, Hashable, Sendable {
+
+        ///
+        /// The rating value.
+        ///
+        /// Valid range: 0.5 to 10.0 in increments of 0.5.
+        ///
+        public let value: Double
+
+        ///
+        /// Creates a rated value object.
+        ///
+        /// - Parameter value: The rating value.
+        ///
+        public init(value: Double) {
+            self.value = value
+        }
+
+    }
+
+}

Sources/TMDb/Domain/Models/AccountStates.swift

@@ -0,0 +1,85 @@
+//
+//  AlternativeTitle.swift
+//  TMDb
+//
+//  Copyright © 2026 Adam Young.
+//
+
+import Foundation
+
+///
+/// A model representing an alternative title for a media item.
+///
+public struct AlternativeTitle: Codable, Equatable, Hashable, Sendable {
+
+    ///
+    /// The ISO 3166-1 country code.
+    ///
+    public let countryCode: String
+
+    ///
+    /// The alternative title.
+    ///
+    public let title: String
+
+    ///
+    /// The type of alternative title.
+    ///
+    /// Examples include "Alternative Title", "Working Title", etc.
+    ///
+    public let type: String?
+
+    ///
+    /// Creates an alternative title object.
+    ///
+    /// - Parameters:
+    ///    - countryCode: The ISO 3166-1 country code.
+    ///    - title: The alternative title.
+    ///    - type: The type of alternative title.
+    ///
+    public init(countryCode: String, title: String, type: String? = nil) {
+        self.countryCode = countryCode
+        self.title = title
+        self.type = type
+    }
+
+}
+
+extension AlternativeTitle {
+
+    private enum CodingKeys: String, CodingKey {
+        case countryCode = "iso31661"
+        case title
+        case type
+    }
+
+}
+
+///
+/// A model representing a collection of alternative titles.
+///
+public struct AlternativeTitleCollection: Codable, Equatable, Hashable, Sendable {
+
+    ///
+    /// The media item identifier.
+    ///
+    public let id: Int
+
+    ///
+    /// The list of alternative titles.
+    ///
+    public let titles: [AlternativeTitle]
+
+    ///
+    /// Creates an alternative title collection object.
+    ///
+    /// - Parameters:
+    ///    - id: The media item identifier.
+    ///    - titles: The list of alternative titles.
+    ///
+    public init(id: Int, titles: [AlternativeTitle]) {
+        self.id = id
+        self.titles = titles
+    }
+
+}