@mentra/bluetooth-sdk 3.1.0-dev.7 → 3.1.0-dev.70

package/build/ota-transport/index.d.ts

@@ -0,0 +1,67 @@
+export type OtaTransportSubscription = {
+    remove(): void;
+};
+export type OtaLocalNetworkConnection = {
+    connected: boolean;
+    ssid: string;
+    localAddress?: string;
+};
+export type OtaLocalNetworkLostEvent = {
+    ssid: string;
+};
+export type OtaLocalNetworkResponse = {
+    status: number;
+    headers: Record<string, string>;
+    bodyBase64: string;
+};
+export type OtaLocalNetworkDownloadResult = {
+    statusCode: number;
+    bytesWritten: number;
+    headers: Record<string, string>;
+};
+export type OtaLocalNetworkDownloadProgress = {
+    requestId: string;
+    bytesWritten: number;
+    contentLength: number;
+    statusCode?: number;
+    headers?: Record<string, string>;
+};
+export type OtaArtifactDownloadProgress = {
+    destination: string;
+    bytesWritten: number;
+    contentLength: number;
+};
+export type OtaServerResult = {
+    baseUrl: string;
+    host: string;
+    manifestUrl: string;
+    port: number;
+};
+/**
+ * Scoped networking for traffic that must stay on a Mentra Live hotspot while
+ * the phone's default route remains on cellular or another Wi-Fi network.
+ *
+ * The module is optional because iOS uses its system Wi-Fi join flow instead.
+ */
+export declare const otaLocalNetwork: Readonly<{
+    isAvailable: () => boolean;
+    connect: (ssid: string, password: string) => Promise<OtaLocalNetworkConnection>;
+    request: (requestId: string, url: string, method: string, headers: Record<string, string>, body: string | null, timeoutMs: number) => Promise<OtaLocalNetworkResponse>;
+    download: (requestId: string, url: string, destination: string, headers: Record<string, string>, connectionTimeoutMs: number, readTimeoutMs: number) => Promise<OtaLocalNetworkDownloadResult>;
+    cancel: (requestId: string) => Promise<void>;
+    disconnect: () => Promise<void>;
+    onDownloadProgress: (listener: (event: OtaLocalNetworkDownloadProgress) => void) => OtaTransportSubscription;
+    onNetworkLost: (listener: (event: OtaLocalNetworkLostEvent) => void) => OtaTransportSubscription;
+}>;
+/** Native HTTP server and artifact downloader used by the Engine OTA coordinator. */
+export declare const otaServer: Readonly<{
+    start: (manifestJson: string, artifactPaths: Record<string, string>, host?: string | null) => Promise<OtaServerResult>;
+    stop: () => Promise<void>;
+    waitForWifiAddress: (gateway: string, timeoutMs: number) => Promise<string>;
+    downloadArtifact: (source: string, destination: string) => Promise<{
+        statusCode: number;
+        bytesWritten: number;
+    }>;
+    onArtifactDownloadProgress: (listener: (event: OtaArtifactDownloadProgress) => void) => OtaTransportSubscription;
+}>;
+//# sourceMappingURL=index.d.ts.map

package/build/ota-transport/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"AAMA,MAAM,MAAM,wBAAwB,GAAG;IAAC,MAAM,IAAI,IAAI,CAAA;CAAC,CAAA;AAEvD,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,OAAO,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,wBAAwB,GAAG;IAAC,IAAI,EAAE,MAAM,CAAA;CAAC,CAAA;AAErD,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC/B,UAAU,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,6BAA6B,GAAG;IAC1C,UAAU,EAAE,MAAM,CAAA;IAClB,YAAY,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC,CAAA;AAED,MAAM,MAAM,+BAA+B,GAAG;IAC5C,SAAS,EAAE,MAAM,CAAA;IACjB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CACjC,CAAA;AAED,MAAM,MAAM,2BAA2B,GAAG;IACxC,WAAW,EAAE,MAAM,CAAA;IACnB,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,IAAI,EAAE,MAAM,CAAA;CACb,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe;uBACT,OAAO;oBACF,MAAM,YAAY,MAAM,KAAG,OAAO,CAAC,yBAAyB,CAAC;yBAKtE,MAAM,OACZ,MAAM,UACH,MAAM,WACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,QACzB,MAAM,GAAG,IAAI,aACR,MAAM,KAChB,OAAO,CAAC,uBAAuB,CAAC;0BAKtB,MAAM,OACZ,MAAM,eACE,MAAM,WACV,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,uBACV,MAAM,iBACZ,MAAM,KACpB,OAAO,CAAC,6BAA6B,CAAC;wBAIf,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;sBAI1B,OAAO,CAAC,IAAI,CAAC;mCAIJ,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,KAAG,wBAAwB;8BAIhF,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,KAAG,wBAAwB;EAI9F,CAAA;AAEF,qFAAqF;AACrF,eAAO,MAAM,SAAS;0BAEJ,MAAM,iBACL,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,SAC9B,MAAM,GAAG,IAAI,KACnB,OAAO,CAAC,eAAe,CAAC;gBACjB,OAAO,CAAC,IAAI,CAAC;kCACO,MAAM,aAAa,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;+BAE9C,MAAM,eAAe,MAAM,KAAG,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAC,CAAC;2CAErE,CAAC,KAAK,EAAE,2BAA2B,KAAK,IAAI,KAAG,wBAAwB;EAE9G,CAAA"}

package/build/ota-transport/index.js

@@ -0,0 +1,58 @@
+// This public adapter is the package-owned boundary over its native implementation.
+// eslint-disable-next-line no-restricted-imports
+import MentraLocalNetwork from "../_private/MentraLocalNetworkModule";
+// eslint-disable-next-line no-restricted-imports
+import MentraOtaServer from "../ota-server";
+/**
+ * Scoped networking for traffic that must stay on a Mentra Live hotspot while
+ * the phone's default route remains on cellular or another Wi-Fi network.
+ *
+ * The module is optional because iOS uses its system Wi-Fi join flow instead.
+ */
+export const otaLocalNetwork = Object.freeze({
+    isAvailable: () => MentraLocalNetwork != null,
+    connect: async (ssid, password) => {
+        if (!MentraLocalNetwork)
+            throw new Error("Scoped local networking is not available in this native build");
+        return MentraLocalNetwork.connect(ssid, password);
+    },
+    request: async (requestId, url, method, headers, body, timeoutMs) => {
+        if (!MentraLocalNetwork)
+            throw new Error("Scoped local networking is not available in this native build");
+        return MentraLocalNetwork.request(requestId, url, method, headers, body, timeoutMs);
+    },
+    download: async (requestId, url, destination, headers, connectionTimeoutMs, readTimeoutMs) => {
+        if (!MentraLocalNetwork)
+            throw new Error("Scoped local networking is not available in this native build");
+        return MentraLocalNetwork.download(requestId, url, destination, headers, connectionTimeoutMs, readTimeoutMs);
+    },
+    cancel: async (requestId) => {
+        if (!MentraLocalNetwork)
+            return;
+        await MentraLocalNetwork.cancel(requestId);
+    },
+    disconnect: async () => {
+        if (!MentraLocalNetwork)
+            return;
+        await MentraLocalNetwork.disconnect();
+    },
+    onDownloadProgress: (listener) => {
+        if (!MentraLocalNetwork)
+            return { remove() { } };
+        return MentraLocalNetwork.addListener("downloadProgress", listener);
+    },
+    onNetworkLost: (listener) => {
+        if (!MentraLocalNetwork)
+            return { remove() { } };
+        return MentraLocalNetwork.addListener("networkLost", listener);
+    },
+});
+/** Native HTTP server and artifact downloader used by the Engine OTA coordinator. */
+export const otaServer = Object.freeze({
+    start: (manifestJson, artifactPaths, host) => MentraOtaServer.startOtaServer(manifestJson, artifactPaths, host),
+    stop: () => MentraOtaServer.stopOtaServer(),
+    waitForWifiAddress: (gateway, timeoutMs) => MentraOtaServer.waitForWifiAddress(gateway, timeoutMs),
+    downloadArtifact: (source, destination) => MentraOtaServer.downloadArtifact(source, destination),
+    onArtifactDownloadProgress: (listener) => MentraOtaServer.addListener("artifactDownloadProgress", listener),
+});
+//# sourceMappingURL=index.js.map

package/build/ota-transport/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ota-transport/index.ts"],"names":[],"mappings":"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","sourcesContent":["// This public adapter is the package-owned boundary over its native implementation.\n// eslint-disable-next-line no-restricted-imports\nimport MentraLocalNetwork from \"../_private/MentraLocalNetworkModule\"\n// eslint-disable-next-line no-restricted-imports\nimport MentraOtaServer from \"../ota-server\"\n\nexport type OtaTransportSubscription = {remove(): void}\n\nexport type OtaLocalNetworkConnection = {\n  connected: boolean\n  ssid: string\n  localAddress?: string\n}\n\nexport type OtaLocalNetworkLostEvent = {ssid: string}\n\nexport type OtaLocalNetworkResponse = {\n  status: number\n  headers: Record<string, string>\n  bodyBase64: string\n}\n\nexport type OtaLocalNetworkDownloadResult = {\n  statusCode: number\n  bytesWritten: number\n  headers: Record<string, string>\n}\n\nexport type OtaLocalNetworkDownloadProgress = {\n  requestId: string\n  bytesWritten: number\n  contentLength: number\n  statusCode?: number\n  headers?: Record<string, string>\n}\n\nexport type OtaArtifactDownloadProgress = {\n  destination: string\n  bytesWritten: number\n  contentLength: number\n}\n\nexport type OtaServerResult = {\n  baseUrl: string\n  host: string\n  manifestUrl: string\n  port: number\n}\n\n/**\n * Scoped networking for traffic that must stay on a Mentra Live hotspot while\n * the phone's default route remains on cellular or another Wi-Fi network.\n *\n * The module is optional because iOS uses its system Wi-Fi join flow instead.\n */\nexport const otaLocalNetwork = Object.freeze({\n  isAvailable: (): boolean => MentraLocalNetwork != null,\n  connect: async (ssid: string, password: string): Promise<OtaLocalNetworkConnection> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.connect(ssid, password)\n  },\n  request: async (\n    requestId: string,\n    url: string,\n    method: string,\n    headers: Record<string, string>,\n    body: string | null,\n    timeoutMs: number,\n  ): Promise<OtaLocalNetworkResponse> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.request(requestId, url, method, headers, body, timeoutMs)\n  },\n  download: async (\n    requestId: string,\n    url: string,\n    destination: string,\n    headers: Record<string, string>,\n    connectionTimeoutMs: number,\n    readTimeoutMs: number,\n  ): Promise<OtaLocalNetworkDownloadResult> => {\n    if (!MentraLocalNetwork) throw new Error(\"Scoped local networking is not available in this native build\")\n    return MentraLocalNetwork.download(requestId, url, destination, headers, connectionTimeoutMs, readTimeoutMs)\n  },\n  cancel: async (requestId: string): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.cancel(requestId)\n  },\n  disconnect: async (): Promise<void> => {\n    if (!MentraLocalNetwork) return\n    await MentraLocalNetwork.disconnect()\n  },\n  onDownloadProgress: (listener: (event: OtaLocalNetworkDownloadProgress) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"downloadProgress\", listener)\n  },\n  onNetworkLost: (listener: (event: OtaLocalNetworkLostEvent) => void): OtaTransportSubscription => {\n    if (!MentraLocalNetwork) return {remove() {}}\n    return MentraLocalNetwork.addListener(\"networkLost\", listener)\n  },\n})\n\n/** Native HTTP server and artifact downloader used by the Engine OTA coordinator. */\nexport const otaServer = Object.freeze({\n  start: (\n    manifestJson: string,\n    artifactPaths: Record<string, string>,\n    host?: string | null,\n  ): Promise<OtaServerResult> => MentraOtaServer.startOtaServer(manifestJson, artifactPaths, host),\n  stop: (): Promise<void> => MentraOtaServer.stopOtaServer(),\n  waitForWifiAddress: (gateway: string, timeoutMs: number): Promise<string> =>\n    MentraOtaServer.waitForWifiAddress(gateway, timeoutMs),\n  downloadArtifact: (source: string, destination: string): Promise<{statusCode: number; bytesWritten: number}> =>\n    MentraOtaServer.downloadArtifact(source, destination),\n  onArtifactDownloadProgress: (listener: (event: OtaArtifactDownloadProgress) => void): OtaTransportSubscription =>\n    MentraOtaServer.addListener(\"artifactDownloadProgress\", listener),\n})\n"]}

package/ios/Source/BluetoothSdkDefaults.swift

@@ -11,7 +11,7 @@ enum BluetoothSdkDefaults {
     static let voiceActivityDetectionEnabled = false
     static let loudnessGateEnabled = true
     private static let infoSdkVersionKey = "MentraBluetoothSdkVersion"
-    private static let swiftPackageSdkVersion = "3.1.0-dev.7"
+    private static let swiftPackageSdkVersion = "3.1.0-dev.70"
     private static let swiftPackageSdkVersionPlaceholder = "__MENTRA" + "_BLUETOOTH_SDK_VERSION__"
 
     private static func normalizedSdkVersion(_ value: String?) -> String? {

package/ios/Source/Bridge.swift

@@ -100,12 +100,10 @@ class Bridge {
 
     static func sendPairingInfo(
         hadPreviousBond: Bool,
-        transferId: String? = nil,
         pairingCode: String? = nil,
         classicBondReady: Bool = false,
         securePairingCapable: Bool = true,
-        protocolVersion: Int = 1,
-        binding: String? = nil
+        protocolVersion: Int = 1
     ) {
         var body: [String: Any] = [
             "had_previous_bond": hadPreviousBond,
@@ -113,9 +111,7 @@ class Bridge {
             "secure_pairing_capable": securePairingCapable,
             "protocol_version": protocolVersion,
         ]
-        if let transferId { body["transfer_id"] = transferId }
         if let pairingCode { body["pairing_code"] = pairingCode }
-        if let binding { body["binding"] = binding }
         Bridge.sendTypedMessage("pairing_info", body: body)
     }
 
@@ -662,4 +658,3 @@ class Bridge {
 
 
 
-

package/ios/Source/DeviceManager.swift

@@ -1012,9 +1012,7 @@ struct ViewState {
         if !pendingDeviceAddress.isEmpty {
             deviceAddress = pendingDeviceAddress
         }
-        pendingDeviceName = ""
-        pendingDeviceAddress = ""
-        pendingWearable = ""
+        clearPendingConnection()
         defaultWearable = sgc.type
         searching = false
 
@@ -1792,7 +1790,7 @@ struct ViewState {
         }
 
         Task {
-            disconnect()
+            disconnect(clearPendingConnection: false)
             try? await Task.sleep(nanoseconds: 100 * 1_000_000) // 100ms
             self.searching = true
             self.pendingDeviceName = name
@@ -1826,7 +1824,7 @@ struct ViewState {
         handleDeviceReady()
     }
 
-    func disconnect() {
+    func disconnect(clearPendingConnection: Bool = true) {
         sgc?.clearDisplay() // clear the screen
         sgc?.disconnect()
         sgc = nil // Clear the SGC reference after disconnect
@@ -1855,6 +1853,15 @@ struct ViewState {
         DeviceStore.shared.apply("glasses", "controllerConnected", false)
         controller?.disconnect()
         controller = nil // Clear the controller reference after disconnect
+        if clearPendingConnection {
+            self.clearPendingConnection()
+        }
+    }
+
+    private func clearPendingConnection() {
+        pendingDeviceName = ""
+        pendingDeviceAddress = ""
+        pendingWearable = ""
     }
 
     func disconnectController() {
@@ -1874,9 +1881,7 @@ struct ViewState {
         defaultWearable = ""
         deviceName = ""
         deviceAddress = ""
-        pendingDeviceName = ""
-        pendingDeviceAddress = ""
-        pendingWearable = ""
+        clearPendingConnection()
         Bridge.saveSetting("default_wearable", "")
         Bridge.saveSetting("device_name", "")
         Bridge.saveSetting("device_address", "")

package/ios/Source/GeneratedChangelogCatalog.swift

@@ -0,0 +1,6 @@
+import Foundation
+
+/// Generated from /changelogs. Do not edit directly.
+let generatedReleaseChangelogs: [ReleaseChangelog] = [
+    ReleaseChangelog(version: "3.1.0", markdown: "Software updates are more reliable, with clearer progress and recovery when the glasses restart.\n\n- MentraOS, Mentra Engine, the Bluetooth SDK, and the glasses client now share one coordinated release version.\n- Mentra Live updates can continue across APK, system, and firmware restarts without asking the user to start the same update again.\n- Bluetooth photo capture and transfer diagnostics are more precise and less disruptive to normal glasses traffic."),
+]

package/ios/Source/GeneratedReleaseMetadata.swift

@@ -3,9 +3,9 @@ import Foundation
 /// Generated by release CI. Do not edit in a release checkout.
 enum GeneratedReleaseMetadata {
     static let familyBaseVersion = "3.1.0"
-    static let releaseIdentity = "3.1.0-dev.7"
-    static let releaseSetId = "mentra-3.1.0-dev.7"
-    static let sourceCommit = "872697a6395c31d30ec75d64f039eaa763dcbb51"
-    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-v3.1.0-dev.7/mentra-live-ota-3.1.0-dev.7.json"
-    static let otaManifestSha256 = "8fbea7589345658dc5dffcb394229ffc5c52fbe75352acb8f6827d83290ce750"
+    static let releaseIdentity = "3.1.0-dev.70"
+    static let releaseSetId = "mentra-3.1.0-dev.70"
+    static let sourceCommit = "1554856d69f4cd5d14c1ea769171a444d3e0c4b4"
+    static let otaManifestUrl = "https://github.com/Mentra-Community/MentraOS/releases/download/mentra-builds-v3.1.0/mentra-live-ota-3.1.0-dev.70.json"
+    static let otaManifestSha256 = "593990d9b25a7a47dd80c6a7e3486964b4349191a7abe885fcc24135e1604c69"
 }

package/ios/Source/MentraBluetoothSDK.swift

@@ -311,6 +311,7 @@ public final class MentraBluetoothSDK {
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "project_name", device.projectName ?? "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_secure_pairing_capable", "")
         finishDefaultDeviceApply(generation: generation)
     }
 
@@ -324,6 +325,7 @@ public final class MentraBluetoothSDK {
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "project_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_secure_pairing_capable", "")
         finishDefaultDeviceApply(generation: generation)
     }
 
@@ -401,6 +403,11 @@ public final class MentraBluetoothSDK {
         } else if !isController {
             DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", device.name)
             DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", device.identifier ?? "")
+            DeviceStore.shared.apply(
+                ObservableStore.bluetoothCategory,
+                "pending_device_secure_pairing_capable",
+                device.securePairingCapable ?? ""
+            )
         }
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_wearable", device.model.deviceType)
         DeviceManager.shared.connectByName(device.name)
@@ -427,6 +434,7 @@ public final class MentraBluetoothSDK {
         clearBluetoothRestoreIntent()
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_secure_pairing_capable", "")
         DeviceManager.shared.disconnect()
     }
 
@@ -439,6 +447,7 @@ public final class MentraBluetoothSDK {
         clearBluetoothRestoreIntent()
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_name", "")
         DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_address", "")
+        DeviceStore.shared.apply(ObservableStore.bluetoothCategory, "pending_device_secure_pairing_capable", "")
         DeviceManager.shared.disconnect()
     }
 
@@ -1250,6 +1259,14 @@ public final class MentraBluetoothSDK {
         )
     }
 
+    /// Return bundled release changelogs crossed between two coordinated product versions, newest first.
+    public func getReleaseChangelogs(
+        fromVersion: String? = nil,
+        toVersion: String? = nil
+    ) throws -> [ReleaseChangelog] {
+        try ReleaseChangelogCatalog.select(fromVersion: fromVersion, toVersion: toVersion)
+    }
+
     /// Ask connected Mentra Live glasses to report the current OTA install/session status.
     private func queryOtaStatus() async throws -> OtaQueryResult {
         try await performOtaQuery(operation: "OTA status query") {

package/ios/Source/ReleaseChangelog.swift

@@ -0,0 +1,65 @@
+import Foundation
+
+/// One coordinated Mentra release note authored in /changelogs/<version>.md.
+public struct ReleaseChangelog: Equatable, Sendable {
+    public let version: String
+    public let markdown: String
+
+    public init(version: String, markdown: String) {
+        self.version = version
+        self.markdown = markdown
+    }
+}
+
+enum ReleaseChangelogCatalog {
+    static func select(fromVersion: String?, toVersion: String?) throws -> [ReleaseChangelog] {
+        let fallbackTarget = GeneratedReleaseMetadata.familyBaseVersion.isEmpty
+            ? (generatedReleaseChangelogs.first?.version ?? "")
+            : GeneratedReleaseMetadata.familyBaseVersion
+        if fallbackTarget.isEmpty, toVersion == nil { return [] }
+        let target = try baseVersion(toVersion ?? fallbackTarget, label: "toVersion")
+        guard generatedReleaseChangelogs.contains(where: { $0.version == target }) else {
+            throw BluetoothSdkError(code: "missing_changelog", message: "No changelog is bundled for target version \(target).")
+        }
+        guard let fromVersion else {
+            return generatedReleaseChangelogs.filter { $0.version == target }
+        }
+
+        let source = try baseVersion(fromVersion, label: "fromVersion")
+        let direction = compareVersions(target, source)
+        return generatedReleaseChangelogs.filter { entry in
+            if direction == 0 { return entry.version == target }
+            if direction > 0 {
+                return compareVersions(entry.version, source) > 0 && compareVersions(entry.version, target) <= 0
+            }
+            return compareVersions(entry.version, source) < 0 && compareVersions(entry.version, target) >= 0
+        }
+    }
+
+    private static func baseVersion(_ version: String, label: String) throws -> String {
+        let value = version.trimmingCharacters(in: .whitespacesAndNewlines)
+        let suffixStart = value.firstIndex(where: { $0 == "-" || $0 == "+" }) ?? value.endIndex
+        let components = value[..<suffixStart].split(separator: ".", omittingEmptySubsequences: false)
+        let isValid = components.count == 3 && components.allSatisfy { component in
+            !component.isEmpty
+                && (component == "0" || !component.hasPrefix("0"))
+                && component.utf8.allSatisfy { byte in byte >= 48 && byte <= 57 }
+        }
+        guard isValid else {
+            throw BluetoothSdkError(
+                code: "invalid_changelog_version",
+                message: "\(label) must be a semantic version such as 3.1.0, 3.1.0-dev.4, or 3.1.0-beta.2."
+            )
+        }
+        return components.joined(separator: ".")
+    }
+
+    private static func compareVersions(_ left: String, _ right: String) -> Int {
+        let a = left.split(separator: ".").map { Int($0) ?? 0 }
+        let b = right.split(separator: ".").map { Int($0) ?? 0 }
+        for index in 0 ..< 3 where a[index] != b[index] {
+            return a[index] - b[index]
+        }
+        return 0
+    }
+}