@logbrew/react-native 0.1.10 → 0.1.12

package/ios/GeneratedAppleDiagnostics/LogBrew/PublicTypes.swift

@@ -0,0 +1,334 @@
+// Generated by scripts/sync-apple-native-sources.mjs.
+// Edit the canonical Swift source, then regenerate this package boundary.
+public enum IssueLevel: String, Codable, Sendable {
+    case trace
+    case debug
+    case info
+    case warn
+    case warning
+    case error
+    case fatal
+    case critical
+
+    public var canonicalValue: String {
+        switch self {
+        case .trace, .debug, .info:
+            "info"
+        case .warn, .warning:
+            "warning"
+        case .error:
+            "error"
+        case .fatal, .critical:
+            "critical"
+        }
+    }
+
+    public func encode(to encoder: any Encoder) throws {
+        var container = encoder.singleValueContainer()
+        try container.encode(canonicalValue)
+    }
+
+    public init(from decoder: any Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        let value = try container.decode(String.self)
+        guard let level = IssueLevel(rawValue: value) else {
+            throw DecodingError.dataCorruptedError(in: container, debugDescription: "unsupported issue level")
+        }
+        self = level
+    }
+}
+
+public enum LogLevel: String, Codable, Sendable {
+    case trace
+    case debug
+    case info
+    case warn
+    case warning
+    case error
+    case fatal
+    case critical
+
+    public var canonicalValue: String {
+        switch self {
+        case .trace, .debug, .info:
+            "info"
+        case .warn, .warning:
+            "warning"
+        case .error:
+            "error"
+        case .fatal, .critical:
+            "critical"
+        }
+    }
+
+    public func encode(to encoder: any Encoder) throws {
+        var container = encoder.singleValueContainer()
+        try container.encode(canonicalValue)
+    }
+
+    public init(from decoder: any Decoder) throws {
+        let container = try decoder.singleValueContainer()
+        let value = try container.decode(String.self)
+        guard let level = LogLevel(rawValue: value) else {
+            throw DecodingError.dataCorruptedError(in: container, debugDescription: "unsupported log level")
+        }
+        self = level
+    }
+}
+
+public enum SpanStatus: String, Codable, Sendable {
+    case ok
+    case error
+}
+
+public enum ActionStatus: String, Codable, Sendable {
+    case queued
+    case running
+    case success
+    case failure
+}
+
+public enum MetricKind: String, Codable, Sendable {
+    case counter
+    case gauge
+    case histogram
+}
+
+public enum MetricTemporality: String, Codable, Sendable {
+    case delta
+    case cumulative
+    case instant
+}
+
+public struct ClientConfig: Equatable, Sendable {
+    public let apiKey: String
+    public let sdkName: String
+    public let sdkVersion: String
+    public let maxRetries: Int
+    public let context: TelemetryContext?
+    public let includeAutomaticContext: Bool
+
+    public init(
+        apiKey: String,
+        sdkName: String,
+        sdkVersion: String,
+        maxRetries: Int = 2,
+        context: TelemetryContext? = nil,
+        includeAutomaticContext: Bool = true,
+    ) {
+        self.apiKey = apiKey
+        self.sdkName = sdkName
+        self.sdkVersion = sdkVersion
+        self.maxRetries = maxRetries
+        self.context = context
+        self.includeAutomaticContext = includeAutomaticContext
+    }
+}
+
+public struct ReleaseAttributes: Codable, Equatable, Sendable {
+    public let version: String
+    public let commit: String?
+    public let notes: String?
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        version: String,
+        commit: String? = nil,
+        notes: String? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.version = version
+        self.commit = commit
+        self.notes = notes
+        self.metadata = metadata
+        self.context = context
+    }
+}
+
+public struct EnvironmentAttributes: Codable, Equatable, Sendable {
+    public let name: String
+    public let region: String?
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        name: String,
+        region: String? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.name = name
+        self.region = region
+        self.metadata = metadata
+        self.context = context
+    }
+}
+
+public struct IssueAttributes: Codable, Equatable, Sendable {
+    public let title: String
+    public let level: IssueLevel
+    public let message: String?
+    public let exception: IssueException?
+    public let stackFrames: [IssueStackFrame]?
+    public let breadcrumbs: [IssueBreadcrumb]?
+    public let breadcrumbsTruncated: Bool?
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+    @_spi(CrashReplay) public let nativeStackFrames: [NativeStackFrame]?
+
+    public init(
+        title: String,
+        level: IssueLevel,
+        message: String? = nil,
+        exception: IssueException? = nil,
+        stackFrames: [IssueStackFrame]? = nil,
+        breadcrumbs: [IssueBreadcrumb]? = nil,
+        breadcrumbsTruncated: Bool? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.title = title
+        self.level = level
+        self.message = message
+        self.exception = exception
+        self.stackFrames = stackFrames
+        self.breadcrumbs = breadcrumbs
+        self.breadcrumbsTruncated = breadcrumbsTruncated
+        self.metadata = metadata
+        self.context = context
+        nativeStackFrames = nil
+    }
+
+    @_spi(CrashReplay)
+    public init(
+        title: String,
+        level: IssueLevel,
+        message: String? = nil,
+        exception: IssueException? = nil,
+        stackFrames: [IssueStackFrame]? = nil,
+        breadcrumbs: [IssueBreadcrumb]? = nil,
+        breadcrumbsTruncated: Bool? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+        nativeStackFrames: [NativeStackFrame]?,
+    ) {
+        self.title = title
+        self.level = level
+        self.message = message
+        self.exception = exception
+        self.stackFrames = stackFrames
+        self.breadcrumbs = breadcrumbs
+        self.breadcrumbsTruncated = breadcrumbsTruncated
+        self.metadata = metadata
+        self.context = context
+        self.nativeStackFrames = nativeStackFrames
+    }
+}
+
+public struct LogAttributes: Codable, Equatable, Sendable {
+    public let message: String
+    public let level: LogLevel
+    public let logger: String?
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        message: String,
+        level: LogLevel,
+        logger: String? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.message = message
+        self.level = level
+        self.logger = logger
+        self.metadata = metadata
+        self.context = context
+    }
+}
+
+public struct SpanAttributes: Codable, Equatable, Sendable {
+    public let name: String
+    public let traceId: String
+    public let spanId: String
+    public let parentSpanId: String?
+    public let status: SpanStatus
+    public let durationMs: Double?
+    public let events: [SpanEventSummary]?
+    public let links: [SpanLinkSummary]?
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        name: String,
+        traceId: String,
+        spanId: String,
+        parentSpanId: String? = nil,
+        status: SpanStatus,
+        durationMs: Double? = nil,
+        events: [SpanEventSummary]? = nil,
+        links: [SpanLinkSummary]? = nil,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.name = name
+        self.traceId = traceId
+        self.spanId = spanId
+        self.parentSpanId = parentSpanId
+        self.status = status
+        self.durationMs = durationMs
+        self.events = events
+        self.links = links
+        self.metadata = metadata
+        self.context = context
+    }
+}
+
+public struct ActionAttributes: Codable, Equatable, Sendable {
+    public let name: String
+    public let status: ActionStatus
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        name: String,
+        status: ActionStatus,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.name = name
+        self.status = status
+        self.metadata = metadata
+        self.context = context
+    }
+}
+
+public struct MetricAttributes: Codable, Equatable, Sendable {
+    public let name: String
+    public let kind: MetricKind
+    public let value: Double
+    public let unit: String
+    public let temporality: MetricTemporality
+    public let metadata: Metadata?
+    public let context: TelemetryContext?
+
+    public init(
+        name: String,
+        kind: MetricKind,
+        value: Double,
+        unit: String,
+        temporality: MetricTemporality,
+        metadata: Metadata? = nil,
+        context: TelemetryContext? = nil,
+    ) {
+        self.name = name
+        self.kind = kind
+        self.value = value
+        self.unit = unit
+        self.temporality = temporality
+        self.metadata = metadata
+        self.context = context
+    }
+}

package/ios/GeneratedAppleDiagnostics/LogBrew/TelemetryContext.swift

@@ -0,0 +1,197 @@
+// Generated by scripts/sync-apple-native-sources.mjs.
+// Edit the canonical Swift source, then regenerate this package boundary.
+/// A bounded name and optional version shared by service, runtime, and framework context.
+public struct TelemetryNamedVersion: Codable, Equatable, Sendable {
+    public let name: String
+    public let version: String?
+
+    public init(name: String, version: String? = nil) {
+        self.name = name
+        self.version = version
+    }
+}
+
+/// Deployment identity shared across related telemetry signals.
+public struct TelemetryDeployment: Codable, Equatable, Sendable {
+    public let environment: String?
+    public let release: String?
+
+    public init(environment: String? = nil, release: String? = nil) {
+        self.environment = environment
+        self.release = release
+    }
+}
+
+/// Operating-system identity without host, account, or network identifiers.
+public struct TelemetryOperatingSystem: Codable, Equatable, Sendable {
+    public let name: String
+    public let version: String?
+    public let build: String?
+
+    public init(name: String, version: String? = nil, build: String? = nil) {
+        self.name = name
+        self.version = version
+        self.build = build
+    }
+}
+
+/// Privacy-bounded device class. Do not use unique hardware identifiers as these values.
+public struct TelemetryDevice: Codable, Equatable, Sendable {
+    public let family: String?
+    public let model: String?
+    public let architecture: String?
+
+    public init(family: String? = nil, model: String? = nil, architecture: String? = nil) {
+        self.family = family
+        self.model = model
+        self.architecture = architecture
+    }
+}
+
+/// Application bundle identity shared by issues, logs, traces, metrics, and product events.
+public struct TelemetryApplication: Codable, Equatable, Sendable {
+    public let name: String?
+    public let version: String?
+    public let build: String?
+
+    public init(name: String? = nil, version: String? = nil, build: String? = nil) {
+        self.name = name
+        self.version = version
+        self.build = build
+    }
+}
+
+/// Stable resource identity shared by every LogBrew signal.
+public struct TelemetryResource: Codable, Equatable, Sendable {
+    public let service: TelemetryNamedVersion?
+    public let deployment: TelemetryDeployment?
+    public let runtime: TelemetryNamedVersion?
+    public let framework: TelemetryNamedVersion?
+    public let operatingSystem: TelemetryOperatingSystem?
+    public let device: TelemetryDevice?
+    public let application: TelemetryApplication?
+
+    public init(
+        service: TelemetryNamedVersion? = nil,
+        deployment: TelemetryDeployment? = nil,
+        runtime: TelemetryNamedVersion? = nil,
+        framework: TelemetryNamedVersion? = nil,
+        operatingSystem: TelemetryOperatingSystem? = nil,
+        device: TelemetryDevice? = nil,
+        application: TelemetryApplication? = nil,
+    ) {
+        self.service = service
+        self.deployment = deployment
+        self.runtime = runtime
+        self.framework = framework
+        self.operatingSystem = operatingSystem
+        self.device = device
+        self.application = application
+    }
+}
+
+/// W3C-compatible trace identity shared by non-span telemetry and trace evidence.
+public struct TelemetryTraceContext: Codable, Equatable, Sendable {
+    public let traceId: String
+    public let spanId: String?
+    public let parentSpanId: String?
+    public let sampled: Bool?
+
+    public init(
+        traceId: String,
+        spanId: String? = nil,
+        parentSpanId: String? = nil,
+        sampled: Bool? = nil,
+    ) {
+        self.traceId = traceId
+        self.spanId = spanId
+        self.parentSpanId = parentSpanId
+        self.sampled = sampled
+    }
+}
+
+/// Opaque application-owned session identity.
+public struct TelemetrySessionContext: Codable, Equatable, Sendable {
+    public let id: String
+    public let previousId: String?
+
+    public init(id: String, previousId: String? = nil) {
+        self.id = id
+        self.previousId = previousId
+    }
+}
+
+public enum TelemetrySubjectKind: String, Codable, Equatable, Sendable {
+    case anonymous
+    case user
+}
+
+/// Explicit app-owned subject identity. Do not send names, email addresses, or IP addresses.
+public struct TelemetrySubjectContext: Codable, Equatable, Sendable {
+    public let id: String
+    public let kind: TelemetrySubjectKind
+
+    public init(id: String, kind: TelemetrySubjectKind) {
+        self.id = id
+        self.kind = kind
+    }
+}
+
+/// Versioned, privacy-bounded context available on every LogBrew event type.
+public struct TelemetryContext: Codable, Equatable, Sendable {
+    public let schemaVersion: Int
+    public let resource: TelemetryResource?
+    public let trace: TelemetryTraceContext?
+    public let session: TelemetrySessionContext?
+    public let subject: TelemetrySubjectContext?
+    public let tags: [String: String]?
+
+    public init(
+        resource: TelemetryResource? = nil,
+        trace: TelemetryTraceContext? = nil,
+        session: TelemetrySessionContext? = nil,
+        subject: TelemetrySubjectContext? = nil,
+        tags: [String: String]? = nil,
+    ) {
+        schemaVersion = 1
+        self.resource = resource
+        self.trace = trace
+        self.session = session
+        self.subject = subject
+        self.tags = tags
+    }
+
+    /// Merge this context with an event-level override using deterministic field-level rules.
+    public func merging(_ override: TelemetryContext) throws -> TelemetryContext {
+        try requireTelemetryContext(mergeTelemetryContexts(self, override))
+    }
+}
+
+/// Task-local context for correlating related telemetry without global mutable user state.
+public enum LogBrewTelemetry {
+    @TaskLocal private static var activeContext: TelemetryContext?
+
+    public static var current: TelemetryContext? {
+        activeContext
+    }
+
+    public static func withContext<T>(
+        _ context: TelemetryContext,
+        operation: () throws -> T,
+    ) throws -> T {
+        let nested = try mergeTelemetryContexts(activeContext, context)
+        return try $activeContext.withValue(nested) {
+            try operation()
+        }
+    }
+
+    public static func withContext<T>(
+        _ context: TelemetryContext,
+        operation: () async throws -> T,
+    ) async throws -> T {
+        let nested = try mergeTelemetryContexts(activeContext, context)
+        return try await $activeContext.withValue(nested) {
+            try await operation()
+        }
+    }
+}