@npaw/forge-react-native 9.6.1

package/ios/ForgeApple/Sources/NPAWForgeCore/PlayerSemantics.swift

@@ -0,0 +1,266 @@
+/**
+ * Copyright (C) NPAW - All Rights Reserved
+ *
+ * This source code is protected under international copyright law. All rights
+ * reserved and protected by the copyright holders.
+ * This file is confidential and only available to authorized individuals with the
+ * permission of the copyright holders. If you encounter this file and do not have
+ * permission, please contact the copyright holders and delete this file.
+ *
+ *
+ * @author: Victor Soto <victor.soto@nicepeopleatwork.com>
+ * @description: Apple player semantic event and metadata snapshot model.
+ */
+
+import Foundation
+
+public enum PlayerEvent: String {
+    case initEvent = "INIT"
+    case start = "START"
+    case join = "JOIN"
+    case pause = "PAUSE"
+    case resume = "RESUME"
+    case seekBegin = "SEEK_BEGIN"
+    case seekEnd = "SEEK_END"
+    case bufferBegin = "BUFFER_BEGIN"
+    case bufferEnd = "BUFFER_END"
+    case stop = "STOP"
+    case error = "ERROR"
+    case fatalError = "FATAL_ERROR"
+    case destroy = "DESTROY"
+    case customVideoEvent = "CUSTOM_VIDEO_EVENT"
+    case customVideoEventEnd = "CUSTOM_VIDEO_EVENT_END"
+    case metadataUpdate = "METADATA_UPDATE"
+}
+
+public enum ContentType: String {
+    case live = "LIVE"
+    case vod = "VOD"
+    case audio = "AUDIO"
+    case unknown = "UNKNOWN"
+}
+
+public struct CustomVideoEventPayload: Equatable {
+    public var name: String
+    public var dimensions: [String: String]
+    public var values: [String: Double]
+    public var topLevel: [String: String]
+    public var streamKey: String?
+    public var hasEndDatetime: Bool
+
+    public init(
+        name: String,
+        dimensions: [String: String] = [:],
+        values: [String: Double] = [:],
+        topLevel: [String: String] = [:],
+        streamKey: String? = nil,
+        hasEndDatetime: Bool = false
+    ) {
+        self.name = name
+        self.dimensions = dimensions
+        self.values = values
+        self.topLevel = topLevel
+        self.streamKey = streamKey
+        self.hasEndDatetime = hasEndDatetime
+    }
+}
+
+public struct PlayerMetadataSnapshot: Equatable {
+    public var playerName: String
+    public var playerVersion: String?
+    public var adapterVersion: String?
+    public var resourceUrl: String?
+    public var parsedResource: String?
+    public var title: String?
+    public var program: String?
+    public var contentType: ContentType
+    public var playheadMs: Int64?
+    public var durationMs: Int64?
+    public var bitrate: Int64?
+    public var rendition: String?
+    public var videoCodec: String?
+    public var audioCodec: String?
+    public var codecProfile: String?
+    public var containerFormat: String?
+    public var errorCode: String?
+    public var errorMessage: String?
+    public var errorMetadata: String?
+    public var errorLevel: String?
+    public var forceInit: Bool?
+    public var convertFromBuffer: Bool?
+    public var convertFromSeek: Bool?
+    public var customEvent: CustomVideoEventPayload?
+    /// Legacy `param1`..`param20` content dimensions; only indices 1-20 are
+    /// transmitted. A non-empty map wins over
+    /// `__legacyContentDimension.<name>` extraParams keys entirely.
+    public var legacyCustomDimensions: [String: String]
+    /// Custom content dimensions. Values that parse as numbers become JSON
+    /// numbers core-side (same coercion as the `__contentDimension.<name>`
+    /// extraParams contract); a non-empty map wins over those overlay keys.
+    public var customDimensions: [String: String]
+    /// Numeric custom content metrics (metric surfaces are numeric-only;
+    /// non-finite values are dropped). A non-empty map wins over
+    /// `__contentMetric.<name>` extraParams keys entirely.
+    public var customMetrics: [String: Double]
+    /// Additive string-key metadata overlay forwarded to the shared Rust
+    /// core. Keys follow the same contract as the Android metadata map
+    /// (for example `contentLanguage`, `cdn`, `__contentDimension.<name>`);
+    /// typed snapshot fields always win over overlay keys.
+    public var extraParams: [String: String]
+
+    public init(
+        playerName: String,
+        playerVersion: String? = nil,
+        adapterVersion: String? = nil,
+        resourceUrl: String? = nil,
+        parsedResource: String? = nil,
+        title: String? = nil,
+        contentType: ContentType = .unknown,
+        playheadMs: Int64? = nil,
+        durationMs: Int64? = nil,
+        bitrate: Int64? = nil,
+        rendition: String? = nil,
+        videoCodec: String? = nil,
+        audioCodec: String? = nil,
+        codecProfile: String? = nil,
+        containerFormat: String? = nil,
+        errorCode: String? = nil,
+        errorMessage: String? = nil,
+        errorMetadata: String? = nil,
+        errorLevel: String? = nil,
+        forceInit: Bool? = nil,
+        convertFromBuffer: Bool? = nil,
+        convertFromSeek: Bool? = nil,
+        customEvent: CustomVideoEventPayload? = nil,
+        legacyCustomDimensions: [String: String] = [:],
+        customDimensions: [String: String] = [:],
+        customMetrics: [String: Double] = [:],
+        program: String? = nil,
+        extraParams: [String: String] = [:]
+    ) {
+        self.playerName = playerName
+        self.playerVersion = playerVersion
+        self.adapterVersion = adapterVersion
+        self.resourceUrl = resourceUrl
+        self.parsedResource = parsedResource
+        self.title = title
+        self.program = program
+        self.contentType = contentType
+        self.playheadMs = playheadMs
+        self.durationMs = durationMs
+        self.bitrate = bitrate
+        self.rendition = rendition
+        self.videoCodec = videoCodec
+        self.audioCodec = audioCodec
+        self.codecProfile = codecProfile
+        self.containerFormat = containerFormat
+        self.errorCode = errorCode
+        self.errorMessage = errorMessage
+        self.errorMetadata = errorMetadata
+        self.errorLevel = errorLevel
+        self.forceInit = forceInit
+        self.convertFromBuffer = convertFromBuffer
+        self.convertFromSeek = convertFromSeek
+        self.customEvent = customEvent
+        self.legacyCustomDimensions = legacyCustomDimensions
+        self.customDimensions = customDimensions
+        self.customMetrics = customMetrics
+        self.extraParams = extraParams
+    }
+
+    public init(
+        playerName: String,
+        playerVersion: String? = nil,
+        adapterVersion: String? = nil,
+        resourceUrl: String? = nil,
+        parsedResource: String? = nil,
+        title: String? = nil,
+        contentType: ContentType = .unknown,
+        playheadMs: Int64? = nil,
+        durationMs: Int64? = nil,
+        bitrate: Int64? = nil,
+        rendition: String? = nil,
+        videoCodec: String? = nil,
+        audioCodec: String? = nil,
+        codecProfile: String? = nil,
+        containerFormat: String? = nil,
+        errorCode: String? = nil,
+        errorMessage: String? = nil,
+        errorMetadata: String? = nil,
+        errorLevel: String? = nil,
+        forceInit: Bool? = nil,
+        convertFromBuffer: Bool? = nil,
+        convertFromSeek: Bool? = nil,
+        customEvent: CustomVideoEventPayload? = nil,
+        legacyCustomDimensions: [String: String] = [:],
+        customDimensions: [String: String] = [:],
+        customMetrics: [String: Double] = [:],
+        extraParams: [String: String] = [:]
+    ) {
+        self.init(
+            playerName: playerName,
+            playerVersion: playerVersion,
+            adapterVersion: adapterVersion,
+            resourceUrl: resourceUrl,
+            parsedResource: parsedResource,
+            title: title,
+            contentType: contentType,
+            playheadMs: playheadMs,
+            durationMs: durationMs,
+            bitrate: bitrate,
+            rendition: rendition,
+            videoCodec: videoCodec,
+            audioCodec: audioCodec,
+            codecProfile: codecProfile,
+            containerFormat: containerFormat,
+            errorCode: errorCode,
+            errorMessage: errorMessage,
+            errorMetadata: errorMetadata,
+            errorLevel: errorLevel,
+            forceInit: forceInit,
+            convertFromBuffer: convertFromBuffer,
+            convertFromSeek: convertFromSeek,
+            customEvent: customEvent,
+            legacyCustomDimensions: legacyCustomDimensions,
+            customDimensions: customDimensions,
+            customMetrics: customMetrics,
+            program: nil,
+            extraParams: extraParams
+        )
+    }
+}
+
+public struct QosSnapshot: Equatable {
+    public var throughput: Double?
+    public var fps: Double?
+    public var latency: Double?
+    public var playrate: Double?
+    public var droppedFrames: Int64?
+    public var totalBytes: Int64?
+
+    public init(
+        throughput: Double? = nil,
+        fps: Double? = nil,
+        latency: Double? = nil,
+        playrate: Double? = nil,
+        droppedFrames: Int64? = nil,
+        totalBytes: Int64? = nil
+    ) {
+        self.throughput = throughput
+        self.fps = fps
+        self.latency = latency
+        self.playrate = playrate
+        self.droppedFrames = droppedFrames
+        self.totalBytes = totalBytes
+    }
+}
+
+public struct MetadataSnapshot: Equatable {
+    public var content: PlayerMetadataSnapshot
+    public var qos: QosSnapshot?
+
+    public init(content: PlayerMetadataSnapshot, qos: QosSnapshot? = nil) {
+        self.content = content
+        self.qos = qos
+    }
+}

package/ios/ForgeApple/Sources/NPAWForgeCore/PrivacySanitizer.swift

@@ -0,0 +1,59 @@
+/**
+ * Copyright (C) NPAW - All Rights Reserved
+ *
+ * This source code is protected under international copyright law. All rights
+ * reserved and protected by the copyright holders.
+ * This file is confidential and only available to authorized individuals with the
+ * permission of the copyright holders. If you encounter this file and do not have
+ * permission, please contact the copyright holders and delete this file.
+ *
+ *
+ * @author: Victor Soto <victor.soto@nicepeopleatwork.com>
+ * @description: Shared Apple binding privacy sanitizer for metadata, capture, and network payloads.
+ */
+
+import Foundation
+
+public enum PrivacySanitizer {
+    private static let sensitiveFragments = [
+        "password",
+        "passwd",
+        "token",
+        "secret",
+        "authorization",
+        "auth",
+        "key",
+        "session",
+    ]
+
+    public static func sanitize(_ payload: [String: String], maxValueLength: Int = 512) -> [String: String] {
+        var output: [String: String] = [:]
+        output.reserveCapacity(payload.count)
+        for (key, value) in payload {
+            let normalized = key.lowercased()
+            if sensitiveFragments.contains(where: { normalized.contains($0) }) {
+                output[key] = "[redacted]"
+            } else {
+                output[key] = String(value.prefix(max(0, maxValueLength)))
+            }
+        }
+        return output
+    }
+
+    public static func redactUrl(_ value: String, maxLength: Int = 1024) -> String {
+        guard var components = URLComponents(string: value) else {
+            return String(value.prefix(maxLength))
+        }
+        components.user = nil
+        components.password = nil
+        components.fragment = nil
+        components.queryItems = components.queryItems?.map { item in
+            let normalized = item.name.lowercased()
+            if sensitiveFragments.contains(where: { normalized.contains($0) }) {
+                return URLQueryItem(name: item.name, value: "redacted")
+            }
+            return item
+        }
+        return String((components.string ?? value).prefix(maxLength))
+    }
+}