feat: Add analytics, security, and currency SDK modules with comprehensive API endpoints across Elixir and Go SDKs

- Add AnalyticsAPI with churn prediction (predict, metrics, at-risk), market analytics (metrics, competitors, opportunities), predictive maintenance (metrics, assets, alerts, predict), and pricing optimization (metrics, optimize, elasticity) endpoints
- Add SecurityAPI with fraud detection (analyze, alerts, update status, metrics, patterns) and SIM swap protection (verify, history) endpoints
- Add CurrencyAPI with currency conversion (convert, exchange rates, rate

sdk/swift/Sources/TelecomSDK/AnalyticsAPI.swift

@@ -0,0 +1,199 @@
+import Foundation
+
+/// Analytics API for churn prediction, market analysis, and pricing optimization
+public class AnalyticsAPI {
+    private let client: HTTPClient
+    
+    public init(client: HTTPClient) {
+        self.client = client
+    }
+    
+    // MARK: - Churn Analysis
+    
+    /// Predict churn risk for a profile
+    public func predictChurn(profileId: String) async throws -> ChurnPrediction {
+        return try await client.post(
+            "/api/v1/analytics/churn/predict",
+            body: ["profile_id": profileId],
+            responseType: ChurnPrediction.self
+        )
+    }
+    
+    /// Get churn metrics
+    public func getChurnMetrics(period: String = "monthly") async throws -> ChurnMetrics {
+        return try await client.get(
+            "/api/v1/analytics/churn/metrics",
+            parameters: ["period": period],
+            responseType: ChurnMetrics.self
+        )
+    }
+    
+    /// Get at-risk customers
+    public func getAtRiskCustomers(
+        riskLevel: ChurnRiskLevel,
+        limit: Int = 100
+    ) async throws -> [ChurnPrediction] {
+        return try await client.post(
+            "/api/v1/analytics/churn/at-risk",
+            body: [
+                "risk_level": riskLevel.rawValue,
+                "limit": limit
+            ],
+            responseType: [ChurnPrediction].self
+        )
+    }
+    
+    // MARK: - Market Analytics
+    
+    /// Get market metrics
+    public func getMarketMetrics(period: String = "monthly") async throws -> MarketMetrics {
+        return try await client.get(
+            "/api/v1/analytics/market/metrics",
+            parameters: ["period": period],
+            responseType: MarketMetrics.self
+        )
+    }
+    
+    /// Get competitor analysis
+    public func getCompetitors() async throws -> [String: Any] {
+        return try await client.get("/api/v1/analytics/market/competitors")
+    }
+    
+    /// Get market opportunities
+    public func getMarketOpportunities() async throws -> [String: Any] {
+        return try await client.get("/api/v1/analytics/market/opportunities")
+    }
+    
+    // MARK: - Predictive Maintenance
+    
+    /// Get maintenance metrics
+    public func getMaintenanceMetrics(period: String = "monthly") async throws -> MaintenanceMetrics {
+        return try await client.get(
+            "/api/v1/analytics/maintenance/metrics",
+            parameters: ["period": period],
+            responseType: MaintenanceMetrics.self
+        )
+    }
+    
+    /// Get assets health
+    public func getAssetsHealth() async throws -> [String: Any] {
+        return try await client.get("/api/v1/analytics/maintenance/assets")
+    }
+    
+    /// Get maintenance alerts
+    public func getMaintenanceAlerts() async throws -> [String: Any] {
+        return try await client.get("/api/v1/analytics/maintenance/alerts")
+    }
+    
+    /// Predict failure for an asset
+    public func predictFailure(assetId: String) async throws -> [String: Any] {
+        return try await client.post("/api/v1/analytics/maintenance/predict/\(assetId)", body: [:])
+    }
+    
+    // MARK: - Pricing Optimization
+    
+    /// Get pricing metrics
+    public func getPricingMetrics(period: String = "monthly") async throws -> PricingMetrics {
+        return try await client.get(
+            "/api/v1/analytics/pricing/metrics",
+            parameters: ["period": period],
+            responseType: PricingMetrics.self
+        )
+    }
+    
+    /// Optimize pricing for rate plans
+    public func optimizePricing(
+        ratePlanIds: [String],
+        strategy: String = "revenue_maximization"
+    ) async throws -> [PricingOptimizationResult] {
+        return try await client.post(
+            "/api/v1/analytics/pricing/optimize",
+            body: [
+                "rate_plan_ids": ratePlanIds,
+                "strategy": strategy
+            ],
+            responseType: [PricingOptimizationResult].self
+        )
+    }
+    
+    /// Get price elasticity data
+    public func getPriceElasticity() async throws -> [String: Any] {
+        return try await client.get("/api/v1/analytics/pricing/elasticity")
+    }
+}
+
+// MARK: - Analytics Types
+
+public struct ChurnPrediction: Codable {
+    public let profileId: String
+    public let riskLevel: String
+    public let riskScore: Double
+    public let predictedChurnDate: String?
+    public let reasons: [String]
+    public let recommendations: [String]
+    public let lastUpdated: String
+}
+
+public struct ChurnMetrics: Codable {
+    public let period: String
+    public let totalSubscribers: Int64
+    public let churnedSubscribers: Int64
+    public let churnRate: Double
+    public let monthlyChurnRate: Double
+    public let annualChurnRate: Double
+    public let averageTenureDays: Double
+    public let riskDistribution: [String: Int64]
+    public let generatedAt: String
+}
+
+public struct MarketMetrics: Codable {
+    public let period: String
+    public let totalMarketSize: Int64
+    public let ourSubscribers: Int64
+    public let marketShare: Double
+    public let growthRate: Double
+    public let byCountry: [String: [String: Any]]
+    public let generatedAt: String
+}
+
+public struct MaintenanceMetrics: Codable {
+    public let period: String
+    public let totalAssets: Int64
+    public let healthyAssets: Int64
+    public let assetsNeedingAttention: Int64
+    public let uptime: Double
+    public let meanTimeToFailure: Double
+    public let meanTimeToRepair: Double
+    public let generatedAt: String
+}
+
+public struct PricingMetrics: Codable {
+    public let period: String
+    public let totalRevenue: Double
+    public let arpu: Double
+    public let priceElasticity: Double
+    public let competitiveIndex: Double
+    public let optimizationRoi: Double
+    public let generatedAt: String
+}
+
+public struct PricingOptimizationResult: Codable {
+    public let ratePlanId: String
+    public let strategy: String
+    public let currentPrice: Double
+    public let optimalPrice: Double
+    public let priceChangePct: Double
+    public let expectedRevenue: Double
+    public let expectedDemand: Double
+    public let confidence: Double
+    public let reasoning: [String]
+    public let risks: [String]
+    public let recommendations: [String]
+}
+
+public enum ChurnRiskLevel: String, CaseIterable {
+    case low = "low"
+    case medium = "medium"
+    case high = "high"
+    case critical = "critical"
+}