Rename configure_BETA to getStableIdentifier

Author: lzell

Sources/AIProxy/AIProxy.swift

@@ -830,13 +830,23 @@ public struct AIProxy {
     }
 #endif
 
+    /// This is a beta feature.
+    /// It returns a stable, anonymous identifier that you can annotate requests to AIProxy with.
+    /// You must add the 'iCloud key-value storage' capability to use this:
+    ///    1. Tap on your project in Xcode's project tree
+    ///    2. Tap on your target in the sidebar
+    ///    3. Tap on Signing & Capabilities in the top nav
+    ///    4. Tap the plus sign next to 'Capability'
+    ///    5. Add iCloud
+    ///    6. Select the 'Key-value storage' service
     @NetworkActor
-    public static func configure_BETA() async {
+    public static func getStableIdentifier() async -> String? {
         do {
-            try await AnonymousAccountStorage.sync()
+            return try await AnonymousAccountStorage.sync()
         } catch {
             aiproxyLogger.critical("Could not configure an AIProxy anonymous account: \(error.localizedDescription)")
         }
+        return nil
     }
 
     private init() {

Sources/AIProxy/AnonymousAccount/AIProxyStorage.swift

@@ -12,7 +12,7 @@ private let kAIProxyRemoteAccount = "aiproxy-remote"
 internal let kAIProxyUKVSAccount = "aiproxy-ukvs"
 
 
-public final class AIProxyStorage {
+final class AIProxyStorage {
 
     static private let keychain = AIProxyKeychain()
     static private let ukvs = NSUbiquitousKeyValueStore.default

Sources/AIProxy/AnonymousAccount/AnonymousAccountStorage.swift

@@ -38,7 +38,7 @@ final class AnonymousAccountStorage {
     private static var localAccountChain: [AnonymousAccount] = []
 
     /// This is expected to be called as part of the application launch.
-    static func sync() async throws {
+    static func sync() async throws -> String {
         #if false
         try await AIProxyStorage.clear()
         #endif
@@ -133,6 +133,8 @@ final class AnonymousAccountStorage {
         aiproxyLogger.info("Local account chain is \(localAccountChain)")
         aiproxyLogger.info("Anonymous account identifier is \(self.resolvedAccount!.uuid)")
         #endif
+
+        return localAccount.uuid
     }
 
     /// Called when NSUbiquitousKeyValueStore was remotely updated.