Skip to content

MC1Services.md

Latest commit

 

History

History
773 lines (563 loc) · 32.5 KB

MC1Services.md

File metadata and controls

773 lines (563 loc) · 32.5 KB
Raw

MC1Services API Reference

The MC1Services layer provides actor-isolated business logic, managing services, persistence, and device connections.

Package Information

  • Location: MC1Services/
  • Type: Swift Package (single library target)
  • Dependencies: MeshCore

ConnectionManager (public, @MainActor, @Observable class)

File: MC1Services/Sources/MC1Services/Connection/ConnectionManager.swift (split across Connection/ConnectionManager+Lifecycle.swift, +BLE.swift, +Pairing.swift, +WiFi.swift, and Sync/ConnectionManager+SyncRetry.swift)

The primary entry point for managing the connection to a MeshCore device and coordinating services.

Properties

Property Type Description
connectionState DeviceConnectionState Current state: .disconnected, .connecting, .connected, .syncing, .ready
connectedDevice DeviceDTO? Currently connected device info
services ServiceContainer? Business logic services (available when .ready)
currentTransportType TransportType? Active transport type (.bluetooth or .wifi)

Methods

Method Description
activate() async Initializes and attempts auto-reconnect to last device
pairNewDevice() async throws Starts AccessorySetupKit pairing flow
connect(to:forceFullSync:forceReconnect:) async throws Connects to a previously paired device
disconnect(reason:) async Gracefully disconnects and stops services
forgetDevice(deleteData:) async throws Removes device from app and system pairings
forgetDevice(id:) async Removes a device by ID (non-throwing)
switchDevice(to:) async throws Switches to a different device
connectViaWiFi(host:port:forceFullSync:) async throws Connects to a device over WiFi/TCP
clearStalePairings() async Clears all stale pairings from AccessorySetupKit
fetchSavedDevices() async throws -> [DeviceDTO] Fetches all previously paired devices from storage
hasAccessory(for:) -> Bool Checks if an accessory is registered with AccessorySetupKit
renameCurrentDevice() async throws Renames the currently connected device via AccessorySetupKit

Additional Properties

Property Type Description
pairedAccessoriesCount Int Number of paired accessories (for troubleshooting UI)
pairedAccessoryInfos [(id: UUID, name: String)] Returns paired accessories from AccessorySetupKit
lastConnectedDeviceID UUID? Last device ID stored for auto-reconnect
onConnectionReady (() async -> Void)? Called when connection is ready and services are available

SyncCoordinator (public, actor)

File: MC1Services/Sources/MC1Services/Sync/SyncCoordinator.swift (split across Sync/SyncCoordinator+Sync.swift, +MessageHandlers.swift, +ReactionHandlers.swift, +HandlerHelpers.swift)

Orchestrates data synchronization between the MeshCore device and local database through three phases.

Sync Phases

public enum SyncPhase: Sendable, Equatable {
    case contacts   // Phase 1: Sync contacts from device
    case channels   // Phase 2: Sync channel configurations
    case messages   // Phase 3: Poll pending messages
}

Sync State

enum SyncState: Sendable, Equatable {  // internal, not public
    case idle
    case syncing(progress: SyncProgress)
    case synced
    case failed(SyncCoordinatorError)
}

Key Methods

Method Description
performFullSync(radioID:dataStore:contactService:channelService:messagePollingService:...) async throws -> FullSyncResult Executes contacts → channels → messages sync (internal)
onConnectionEstablished(radioID:dependencies:...) async throws -> FullSyncResult Called after a connection; wires handlers and syncs (internal)
setSyncActivityCallbacks(onStarted:onEnded:onPhaseChanged:) async Sets UI callbacks for sync pill display

Connection Lifecycle

  1. Wire message handlers (before events arrive)
  2. Start event monitoring
  3. Perform full sync (contacts, channels, messages)
  4. Wire discovery handlers (for ongoing contact discovery)

MessageService (public, actor)

File: MC1Services/Sources/MC1Services/Services/MessageService.swift (sends split across MessageService+SendDM.swift, +SendChannel.swift, +SendHelpers.swift; ACK tracking in MessageService+ACK.swift)

Handles message sending with automatic retry logic, flood routing fallback, and ACK tracking.

Configuration

struct MessageServiceConfig: Sendable {  // internal; defined in MessageServiceConfig.swift
    let floodFallbackOnRetry: Bool        // Use flood on manual retry (default: true)
    let maxAttempts: Int                  // Total attempts (default: 5; capped at 5 = 4 direct + 1 flood)
    let maxFloodAttempts: Int             // Max flood attempts (default: 1)
    let floodAfter: Int                   // Switch to flood after N direct attempts (default: 4)
    let minTimeout: TimeInterval          // Minimum timeout seconds (default: 0)
    let triggerPathDiscoveryAfterFlood: Bool // Trigger path discovery after a successful flood
    let ackGiveUpWindow: TimeInterval     // Give-up floor for the ACK deadline on fast presets
    let poolBackoff: PoolBackoffConfig    // In-loop pool-exhaustion backoff tuning
}

Messaging Methods

Method Description
sendMessageWithRetry(text:to:...) async throws -> MessageDTO Sends with auto-retry and flood fallback
sendDirectMessage(text:to:...) async throws -> MessageDTO Single attempt send
sendChannelMessage(text:channelIndex:...) async throws -> (id: UUID, timestamp: UInt32) Broadcasts to channel
resendDirectMessage(messageID:to:) async throws -> MessageDTO Manual retry of a failed direct message
resendChannelMessage(messageID:preserveTimestamp:) async throws -> UInt32 Manual retry of a failed channel message (returns the timestamp)

Event Monitoring

Method Description
startEventMonitoring() Starts monitoring session events to process message acknowledgements
stopEventMonitoring() Stops monitoring session events

ACK Tracking

Method Description
startAckExpiryChecking(interval:) Starts periodic expired ACK checks (default: 5s; wired on connect via ServiceContainer.startEventMonitoring)
stopAckExpiryChecking() Stops background ACK checking
checkExpiredAcks() async throws Marks expired ACKs' messages as .failed and pushes codes into the late-ACK ring
failAllPendingMessages() async throws Fails all pending messages that are awaiting ACK
stopAndFailAllPending() async throws Stops ACK checking and fails all pending messages atomically

Properties

Property Type Description
pendingAckCount Int Current number of pending ACKs being tracked
isAckExpiryCheckingActive Bool Whether ACK expiry checking is currently active

Dependencies

The ContactService used for path management during retry is injected via MessageService's initializer (no public setter). Status updates flow through ChatCoordinator, MessageStatusEvent, and the PersistenceStore rather than per-callback handler setters on the service.

Retry Flow

  1. Direct routing for the first floodAfter attempts (using the contact's outbound path)
  2. Flood routing thereafter (broadcast to all nearby nodes), up to maxAttempts (capped at 5 = 4 direct + 1 flood)
  3. Returns immediately when ACK received
  4. Marks failed if all attempts exhausted

ContactService (public, actor)

File: MC1Services/Sources/MC1Services/Services/ContactService.swift

Manages discovery, synchronization, and storage of mesh contacts.

Sync Methods

Method Description
syncContacts(radioID:since:) async throws -> ContactSyncResult Incremental or full contact sync

Contact Management

Method Description
getContact(radioID:publicKey:) async throws -> ContactDTO? Get a specific contact by public key from local database
addOrUpdateContact(radioID:contact:) async throws Adds/updates contact on device and local store
removeContact(radioID:publicKey:) async throws Deletes from device and local store

Path Discovery & Routing

Method Description
sendPathDiscovery(radioID:publicKey:) async throws -> MessageSentInfo Initiates route discovery
resetPath(radioID:publicKey:) async throws Resets routing, forces mesh rediscovery
setPath(radioID:publicKey:path:pathLength:) async throws Set a specific path for a contact

Contact Sharing

Method Description
shareContact(publicKey:) async throws Share a contact via zero-hop broadcast
exportContact(publicKey:) async throws -> String Export a contact to a shareable URI
exportContactURI(name:publicKey:type:) -> String Build a shareable contact URI (static method)
importContact(cardData:) async throws Import a contact from card data

Local Database Operations

Method Description
getContacts(radioID:) async throws -> [ContactDTO] Get all contacts for a device from local database
getConversations(radioID:) async throws -> [ContactDTO] Get conversations (contacts with messages) from local database
getContactByID(_:) async throws -> ContactDTO? Get a contact by ID from local database
updateContactPreferences(contactID:nickname:isBlocked:isFavorite:) async throws Update local contact preferences

ChannelService (public, actor)

File: MC1Services/Sources/MC1Services/Services/ChannelService.swift

Manages group messaging channels and secure slot configuration.

Sync Methods

Method Description
syncChannels(radioID:maxChannels:usePipelinedRead:) async throws -> ChannelSyncResult Syncs all channel slot configurations (internal)

Channel CRUD Operations

Method Description
fetchChannel(index:) async throws -> ChannelInfo? Fetches a single channel from the device
setChannel(radioID:index:name:passphrase:) async throws Configures slot with passphrase (SHA-256 hashed)
setChannelWithSecret(radioID:index:name:secret:) async throws Sets a channel with a pre-computed secret
clearChannel(radioID:index:) async throws Resets a channel slot

Local Database Operations

Method Description
getChannels(radioID:) async throws -> [ChannelDTO] Gets all channels from local database for a device
getChannel(radioID:index:) async throws -> ChannelDTO? Gets a specific channel from local database
getActiveChannels(radioID:) async throws -> [ChannelDTO] Gets channels that have messages (for chat list)
clearChannelMessages(radioID:channelIndex:) async throws Deletes local messages for a channel

Public Channel (Slot 0)

Method Description
setupPublicChannel(radioID:) async throws Initializes default public channel on slot 0
hasPublicChannel(radioID:) async throws -> Bool Checks if the public channel exists locally

Static Utilities

Method Description
hashSecret(_:) -> Data Hashes a passphrase into a 16-byte channel secret using SHA-256
validateSecret(_:) -> Bool Validates that a secret has the correct size

RemoteNodeService (public, actor)

File: MC1Services/Sources/MC1Services/Services/RemoteNodeService.swift

Queries remote mesh nodes using the binary protocol.

Session Management

Method Description
createSession(radioID:contact:) async throws -> RemoteNodeSessionDTO Create a new session for a remote node
removeSession(id:publicKey:) async throws Remove a session and its associated data
hasPassword(forContact:) async -> Bool Check if a password is stored for a contact's public key
storePassword(_:forNodeKey:) async throws Store a password for a remote node

Login & Authentication

Method Description
login(sessionID:password:pathLength:) async throws -> LoginResult Login to a remote node (works for both room servers and repeaters)
logout(sessionID:) async throws Explicitly logout from a remote node

Event Monitoring

Method Description
startEventMonitoring() Start monitoring MeshCore events for login results
stopEventMonitoring() Stop monitoring events

Keep-Alive (Room Servers)

Method Description
sendKeepAlive(sessionID:) async throws Send keep-alive (for manual refresh)

Remote Node Queries

Method Description
requestStatus(sessionID:) async throws -> StatusResponse Gets battery, uptime, SNR from remote
requestTelemetry(sessionID:) async throws -> TelemetryResponse Gets sensor telemetry from remote
requestHistorySync(sessionID:) async throws Request message history from a room server

CLI Commands

Method Description
sendCLICommand(sessionID:command:) async throws -> String Send a CLI command to a remote node (admin only)

Connection Management

Method Description
disconnect(sessionID:) async Mark session as disconnected without sending logout
handleBLEReconnection(sessionIDs:) async Called when BLE connection is re-established
stopAllKeepAlives() Stop all keep-alive timers (call on app termination)

Handlers

Property Type Description
keepAliveResponseHandler (@Sendable (UUID, Int) async -> Void)? Handler for keep-alive ACK responses

Note: Neighbor fetching is performed via MeshCoreSession.fetchAllNeighbours() directly.

PersistenceStore (public, @ModelActor actor)

File: MC1Services/Sources/MC1Services/Services/PersistenceStore.swift

Type alias: DataStore = PersistenceStore

The unified interface for SwiftData persistence, shared across all services.

Responsibilities

  • CRUD operations for Device, Contact, Message, Channel, RemoteNodeSession, RoomMessage models
  • Thread-safe access via actor model
  • Uses DTOs for cross-boundary data transfer

Device Operations

Method Description
fetchDevices() throws -> [DeviceDTO] Fetch all devices
fetchDevice(id:) throws -> DeviceDTO? Fetch a device by ID
fetchActiveDevice() throws -> DeviceDTO? Fetch the active device
saveDevice(_:) throws Save or update a device
setActiveDevice(id:) throws Set a device as active (deactivates others)
deleteDevice(id:) throws Delete a device and all its associated data

Contact Operations

Method Description
fetchContacts(radioID:) throws -> [ContactDTO] Fetch all contacts for a device
fetchContact(id:) throws -> ContactDTO? Fetch a contact by ID
fetchContact(radioID:publicKey:) throws -> ContactDTO? Fetch a contact by public key
fetchConversations(radioID:) throws -> [ContactDTO] Fetch contacts with messages
saveContact(_:) throws Save or update a contact
saveContact(radioID:from:) throws -> UUID Save contact from ContactFrame
deleteContact(id:) throws Delete a contact
updateContactLastMessage(contactID:date:) throws Update contact's last message date

Message Operations

Method Description
fetchMessages(contactID:) throws -> [MessageDTO] Fetch all messages for a contact
fetchMessages(radioID:channelIndex:) throws -> [MessageDTO] Fetch all messages for a channel
fetchMessage(id:) throws -> MessageDTO? Fetch a message by ID
saveMessage(_:) throws Save or update a message
deleteMessage(id:) throws Delete a message
updateMessageStatus(id:status:) throws Update message delivery status
updateMessageAck(id:ackCode:status:roundTripTime:) throws Update message ACK code, status, and round-trip time
updateMessageRetryStatus(id:status:retryAttempt:maxRetryAttempts:) throws Update message retry status
updateMessageHeardRepeats(id:heardRepeats:) throws Update message heard repeats count
markMessageAsRead(id:) throws Mark a single message as read by message ID

Channel Operations

Method Description
fetchChannels(radioID:) throws -> [ChannelDTO] Fetch all channels for a device
fetchChannel(id:) throws -> ChannelDTO? Fetch a channel by ID
fetchChannel(radioID:index:) throws -> ChannelDTO? Fetch a channel by index
saveChannel(_:) throws Save or update a channel
saveChannel(radioID:from:) throws -> UUID Save channel from ChannelInfo
deleteChannel(id:) throws Delete a channel
updateChannelLastMessage(channelID:date:) throws Update channel's last message date

RemoteNodeSession Operations

Method Description
fetchRemoteNodeSession(id:) throws -> RemoteNodeSessionDTO? Fetch a session by ID
fetchRemoteNodeSession(publicKey:) throws -> RemoteNodeSessionDTO? Fetch a session by public key
fetchRemoteNodeSessionByPrefix(_:) throws -> RemoteNodeSessionDTO? Fetch a session by public key prefix
fetchConnectedRemoteNodeSessions() throws -> [RemoteNodeSessionDTO] Fetch all connected sessions
saveRemoteNodeSessionDTO(_:) throws Save or update a session
updateRemoteNodeSessionConnection(id:isConnected:permissionLevel:) throws Update session connection state
deleteRemoteNodeSession(id:) throws Delete a session

Static Methods

Method Description
createContainer(inMemory:) throws -> ModelContainer Creates a ModelContainer for the app

Data Transfer Objects

MessageDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/Message.swift (search for public struct MessageDTO)

A sendable snapshot of Message for cross-actor transfers. The DTO evolves as features are added (link previews, reactions, mentions, etc.), so this doc intentionally describes the shape at a high level.

Key fields you can rely on:

  • Identity and routing: id, deviceID, contactID or channelIndex
  • Content and timing: text, timestamp, createdAt, senderTimestamp (when available)
  • Delivery metadata: direction, status, textType, ackCode, roundTripTime, retryAttempt, maxRetryAttempts
  • RF / mesh metadata: pathLength, pathNodes, snr, heardRepeats, sendCount
  • Sender identity: senderKeyPrefix, senderNodeName
  • UI flags: isRead, containsSelfMention, mentionSeen, timestampCorrected
  • Rich content caches: link preview fields and reactionSummary

ContactDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/Contact.swift (search for public struct ContactDTO)

A sendable snapshot of Contact for cross-actor transfers.

Notes:

  • latitude and longitude are not optional. Treat 0,0 as "unknown" and use ContactDTO.hasLocation (computed) where available.
  • Favorites are synced with the device via the flags byte (bit 0) and cached as isFavorite.

Computed Properties

Property Type Description
type ContactType Computed from typeRawValue
displayName String Returns nickname if set, otherwise name
publicKeyPrefix Data First 6 bytes of public key

DeviceDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/Device.swift (search for public struct DeviceDTO)

A sendable snapshot of Device for cross-actor transfers. The DTO carries radioID (the data-partition key) in addition to id, and gains fields over time (OCV settings, flood scope, connection methods, known regions, repeater pre-repeat radio config), so the table below lists the core fields rather than the full set.

Property Type Description
id UUID Device identifier
publicKey Data Device public key
nodeName String Device node name
firmwareVersion UInt8 Firmware version number
firmwareVersionString String Firmware version string
manufacturerName String Manufacturer name
buildDate String Firmware build date
maxContacts UInt16 Maximum contacts supported
maxChannels UInt8 Maximum channels supported
frequency UInt32 Radio frequency (kHz)
bandwidth UInt32 Radio bandwidth (Hz)
spreadingFactor UInt8 LoRa spreading factor
codingRate UInt8 LoRa coding rate
txPower Int8 Transmit power (dBm)
maxTxPower Int8 Maximum transmit power (dBm)
latitude Double Device location latitude
longitude Double Device location longitude
blePin UInt32 BLE pairing PIN
manualAddContacts Bool Manual contact add mode
multiAcks UInt8 Multiple ACKs mode
telemetryModeBase UInt8 Base telemetry mode
telemetryModeLoc UInt8 Location telemetry mode
telemetryModeEnv UInt8 Environment telemetry mode
advertLocationPolicy UInt8 Advertisement location policy
lastConnected Date Last connection timestamp
lastContactSync UInt32 Last contact sync timestamp
isActive Bool Active status

Computed Properties

Property Type Description
publicKeyPrefix Data First 6 bytes of public key

ChannelDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/Channel.swift (search for public struct ChannelDTO)

A sendable snapshot of Channel for cross-actor transfers. Core fields:

Property Type Description
id UUID Local identifier
radioID UUID Associated device (data-partition key)
index UInt8 Slot number (0-7)
name String Channel name
secret Data Channel encryption secret (16 bytes)
isEnabled Bool Channel enabled status
lastMessageDate Date? Most recent message date
unreadCount Int Unread messages
unreadMentionCount Int Unread @-mentions
notificationLevel NotificationLevel Per-channel notification preference
isFavorite Bool Favorite flag
floodScopeModeRawValue String Flood-scope mode (raw)

Computed Properties

Property Type Description
isPublicChannel Bool True if this is slot 0 (the public channel slot)

Additional Services

Service Type Description
MessagePollingService internal, actor Polls device for pending messages, routes to handlers
SettingsService public, actor Manages device settings (name, location, radio)
AdvertisementService public, actor Sends advertisements to mesh
RoomServerService public, actor Handles room server messaging
RepeaterAdminService public, actor Admin commands for repeater nodes
BinaryProtocolService public, actor Binary protocol encoding/decoding
KeychainService internal, actor Secure credential storage
NotificationService public, @MainActor, @Observable class Local notification scheduling
ReactionService public, actor Parses and persists emoji reactions
RxLogService public, actor Captures RF packets for network diagnostics
PersistentLogger public, struct Writes to OSLog and enqueues buffered debug log entries
DebugLogBuffer public, actor Batches debug logs and writes to SwiftData
CommandAuditLogger internal, actor Structured logging of remote-node operations (login, status, telemetry, CLI, keep-alive) for diagnostics
DeviceService public, actor Device update callback and OCV settings persistence
HeardRepeatsService public, actor Tracks channel-message repeat counts for propagation analysis
ServiceContainer @MainActor, public final class Holds all service instances

New Services

RxLogService (public, actor)

File: MC1Services/Sources/MC1Services/Services/RxLogService.swift

Captures and stores RF packet log entries for network diagnostics.

Methods:

Method Description
startEventMonitoring(radioID:) Starts capturing RF packets from transport events
stopEventMonitoring() Stops packet capture
process(_:) async Processes a parsed RX-log packet into a stored entry
loadExistingEntries() async -> [RxLogEntryDTO] Loads stored log entries
decryptEntry(_:) -> RxLogEntryDTO Decrypts a stored entry's payload
clearEntries() async Clears all log entries

Capture Features:

  • Real-time packet monitoring
  • Automatic metadata extraction (RSSI, SNR, packet type)
  • SwiftData persistence

PersistentLogger (public, struct)

File: MC1Services/Sources/MC1Services/Services/PersistentLogger.swift

Writes to OSLog and enqueues debug log entries into DebugLogBuffer for persistence.

Methods:

Method Description
debug(_:) Logs a debug message
info(_:) Logs an info message
notice(_:) Logs a notice message
warning(_:) Logs a warning message
error(_:) Logs an error message
fault(_:) Logs a fault message

DebugLogBuffer (public, actor)

File: MC1Services/Sources/MC1Services/Services/DebugLogBuffer.swift

Buffered log sink that batches debug log entries and writes to SwiftData.

Methods:

Method Description
append(_:) Adds a debug log entry to the buffer
flush() Flushes buffered entries to SwiftData
shutdown() Cancels scheduled flush and persists remaining entries

Buffer Features:

  • Batched persistence (flush interval: 5 seconds or 50 entries)
  • Thread-safe actor isolation

CommandAuditLogger (internal, actor)

File: MC1Services/Sources/MC1Services/Services/CommandAuditLogger.swift

Structured Logger-based logging of remote-node operations for diagnostics. It logs events rather than persisting an auditable history; there is no CommandAuditEntryDTO and no query API.

Methods (selection):

Method Description
logLoginRequest(target:publicKey:pathLength:) Logs a remote-node login attempt
logLoginSuccess(target:publicKey:isAdmin:) Logs a successful login
logLoginFailed(target:publicKey:reason:) Logs a failed login
logCLICommand(publicKey:command:) Logs a CLI command sent to a node
logCLIResponse(publicKey:response:) Logs a CLI command response
logStatusRequest(target:publicKey:) / logTelemetryRequest(target:publicKey:) Logs status/telemetry queries
logKeepAlive(target:publicKey:) Logs a keep-alive

DeviceService (public, actor)

File: MC1Services/Sources/MC1Services/Services/DeviceService.swift

Wires a device-update callback and persists OCV battery-curve settings. General device fetches go through PersistenceStore directly.

Methods:

Method Description
setDeviceUpdateCallback(_:) Registers a callback invoked when the device DTO changes
updateOCVSettings(deviceID:preset:customArray:) async throws Persists the OCV preset and custom curve for a device

HeardRepeatsService (public, actor)

File: MC1Services/Sources/MC1Services/Services/HeardRepeatsService.swift

Tracks message repeat counts for channel message propagation analysis.

Methods:

Method Description
configure(radioID:localNodeName:) Configures the service for the active radio
events() -> AsyncStream<HeardRepeatEvent> Stream of heard-repeat events for UI updates
processForRepeats(_:) async -> Int? Counts a repeat from a parsed RX-log entry, returning the new count
refreshRepeats(for:) async -> [MessageRepeatDTO] Returns the recorded repeats for a message

Repeats Features:

  • Real-time tracking of message propagation
  • Stored with Message model
  • Used for displaying "Heard by X" in channel messages

Note: ElevationService and LocationService are app-layer utilities in MeshCore One (not part of the MC1Services package). See docs/api/MeshCore One.md for app-layer references.

New Models

RxLogEntryDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/RxLogEntry.swift

A sendable snapshot of RF packet log entry.

Properties:

Property Type Description
id UUID Unique identifier
radioID UUID Associated device (data-partition key)
receivedAt Date When packet was received
snr Double? Signal-to-noise ratio in dB
rssi Int? Received signal strength indicator in dBm
routeType RouteType Route type (flood vs. direct)
payloadType PayloadType Decoded packet payload type
pathLength UInt8 Routing path length
pathNodes Data Routing path bytes
packetPayload Data Decoded payload bytes
rawPayload Data Raw on-air payload bytes
packetHash String Packet hash
decryptStatus DecryptStatus Whether the payload decrypted

Sender/recipient key prefixes are exposed as the computed senderPrefix / recipientPrefix properties.

DebugLogEntryDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/DebugLogEntry.swift

A sendable snapshot of debug log entry.

Properties:

Property Type Description
id UUID Unique identifier
timestamp Date When log was created
level DebugLogLevel Severity: .debug, .info, .notice, .warning, .error, .fault
subsystem String Logging subsystem identifier
category String Logging category
message String Log message

DiscoveredNodeDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/DiscoveredNode.swift

A sendable snapshot of a discovered node (advertisement cache for Discovery).

Properties:

Property Type Description
id UUID Unique identifier
radioID UUID Associated device (data-partition key)
publicKey Data 32-byte public key
name String Advertised node name
typeRawValue UInt8 Node type raw value
lastHeard Date Last advertisement timestamp (local)
lastAdvertTimestamp UInt32 Firmware advertisement timestamp
latitude Double Node latitude
longitude Double Node longitude
outPathLength UInt8 Routing path length
outPath Data Routing path data

ReactionDTO (public, struct)

File: MC1Services/Sources/MC1Services/Models/Reaction.swift

A sendable snapshot of a reaction on a message.

Properties:

Property Type Description
id UUID Unique identifier
messageID UUID Target message ID
emoji String Reaction emoji
senderName String Sender display name
messageHash String Reaction hash (Crockford Base32)
rawText String Raw wire-format text
receivedAt Date Received timestamp
channelIndex UInt8? Channel index (nil for DM)
contactID UUID? Contact ID (DM only)
radioID UUID Associated device (data-partition key)

ElevationSample (public, struct)

File: MC1Services/Sources/MC1Services/RF/ElevationSample.swift

Represents a terrain elevation data point.

Properties:

Property Type Description
coordinate CLLocationCoordinate2D Geographic coordinates
elevation Double Elevation in meters above sea level
distanceFromAMeters Double Distance from point A in meters

OCVPreset (public, enum)

File: MC1Services/Sources/MC1Services/Models/OCVPreset.swift

String-raw-valued, CaseIterable, Codable, Sendable enum of built-in Open Circuit Voltage (OCV) battery discharge curve presets. It is an enum, not a DTO struct.

See Also