capacitor-launchdarkly 0.0.0-stage → 0.1.1

package/dist/plugin.js

@@ -0,0 +1,224 @@
+var capacitorLaunchDarkly = (function (exports, core) {
+    'use strict';
+
+    const LaunchDarkly = core.registerPlugin('LaunchDarkly', {
+        web: () => Promise.resolve().then(function () { return web; }).then((m) => new m.LaunchDarklyWeb()),
+    });
+
+    /** The key the plugin keeps the context of the last `identify()` under in `localStorage`. */
+    const STORED_CONTEXT_KEY = 'CapacitorLaunchDarkly.context';
+    const DEFAULT_WAIT_SECONDS = 5;
+    const MISSING_SDK_MESSAGE = 'The LaunchDarkly web SDK is not installed. To use this plugin on the web, run: npm install @launchdarkly/js-client-sdk';
+    // Imported only when a web app starts the client, so a native-only app never loads it.
+    const importSdk = () => import('@launchdarkly/js-client-sdk');
+    /**
+     * The web implementation, on LaunchDarkly's browser SDK. It follows the native rules: one client per page, a context the
+     * caller gave with its key (an anonymous context without a key is refused rather than given a generated one), and a context
+     * stored by `identify()` that wins over the one `initialize()` is given.
+     */
+    class LaunchDarklyWeb extends core.WebPlugin {
+        constructor(loadSdk = importSdk) {
+            super();
+            this.loadSdk = loadSdk;
+            this.options = {};
+            this.initialized = false;
+            this.lastValues = {};
+        }
+        async initialize(options) {
+            var _a, _b, _c, _d;
+            const clientSideId = options === null || options === void 0 ? void 0 : options.clientSideId;
+            if (!clientSideId)
+                throw new Error('initialize needs a clientSideId on the web.');
+            if (this.clientSideId === clientSideId) {
+                await this.starting;
+                return this.state();
+            }
+            requireKeys(options.context);
+            const sdk = await this.sdk();
+            if (this.client)
+                await this.close();
+            const startOptions = (_a = options.options) !== null && _a !== void 0 ? _a : {};
+            // The given context plays the part of initialContext: a context an earlier identify() stored wins over it.
+            const context = (_b = readStoredContext()) !== null && _b !== void 0 ? _b : options.context;
+            const streaming = ((_c = startOptions.streaming) !== null && _c !== void 0 ? _c : true) && !startOptions.offline;
+            const client = sdk.createClient(clientSideId, context, Object.assign({ streaming, withReasons: (_d = startOptions.evaluationReasons) !== null && _d !== void 0 ? _d : false }, (startOptions.application ? { applicationInfo: startOptions.application } : {})));
+            this.client = client;
+            this.clientSideId = clientSideId;
+            this.options = startOptions;
+            this.context = context;
+            this.initialized = false;
+            client.on('change', (_context, keys) => this.flagsChanged(client, keys));
+            const bootstrap = startOptions.bootstrap;
+            this.starting = client
+                .start(Object.assign({ timeout: seconds(startOptions.startWaitSeconds) }, (bootstrap && bootstrap !== 'localStorage' ? { bootstrap } : {})))
+                .then((result) => {
+                if (this.client !== client)
+                    return;
+                this.initialized = result.status === 'complete';
+                this.lastValues = Object.assign({}, client.allFlags());
+            });
+            await this.starting;
+            return this.state();
+        }
+        async waitForInitialization(options) {
+            const client = this.client;
+            if (!client)
+                return { initialized: false };
+            if (!this.initialized) {
+                const result = await client.waitForInitialization({ timeout: seconds(options === null || options === void 0 ? void 0 : options.timeoutSeconds) });
+                if (this.client === client && result.status === 'complete')
+                    this.initialized = true;
+            }
+            return { initialized: this.initialized };
+        }
+        async getState() {
+            await this.starting;
+            return this.state();
+        }
+        async identify(options) {
+            const client = this.started();
+            requireKeys(options === null || options === void 0 ? void 0 : options.context);
+            const result = await client.identify(options.context, { timeout: seconds(options.timeoutSeconds) });
+            if (result.status === 'error' || result.status === 'shed') {
+                throw new Error(result.status === 'shed' ? 'identify was replaced by a later identify' : 'identify failed');
+            }
+            // On a timeout the SDK has switched to the context and keeps loading its flags; only the wait is over.
+            this.context = options.context;
+            writeStoredContext(options.context);
+            return { timedOut: result.status === 'timeout' };
+        }
+        async variation(options) {
+            var _a;
+            const defaultValue = (_a = options.defaultValue) !== null && _a !== void 0 ? _a : null;
+            const value = this.client ? this.client.jsonVariation(options.key, defaultValue) : defaultValue;
+            return { value: value !== null && value !== void 0 ? value : null };
+        }
+        async allFlags() {
+            return { flags: this.client ? Object.assign({}, this.client.allFlags()) : {} };
+        }
+        async setStreaming(options) {
+            const client = this.started();
+            this.options = Object.assign(Object.assign({}, this.options), { streaming: options.enabled });
+            client.setStreaming(options.enabled);
+        }
+        async setOnline(options) {
+            var _a;
+            // The browser SDK has no offline mode: offline closes the stream, online opens it again when streaming is on.
+            const client = this.started();
+            client.setStreaming(options.online ? ((_a = this.options.streaming) !== null && _a !== void 0 ? _a : true) : false);
+        }
+        async flush() {
+            var _a;
+            await ((_a = this.client) === null || _a === void 0 ? void 0 : _a.flush());
+        }
+        async close() {
+            const client = this.client;
+            this.client = undefined;
+            this.clientSideId = undefined;
+            this.context = undefined;
+            this.initialized = false;
+            this.starting = undefined;
+            this.lastValues = {};
+            await (client === null || client === void 0 ? void 0 : client.close());
+        }
+        async clearStoredContext() {
+            try {
+                localStorage.removeItem(STORED_CONTEXT_KEY);
+            }
+            catch (_a) {
+                // No storage (a private window, blocked site data): nothing was stored either.
+            }
+        }
+        async sdk() {
+            try {
+                return await this.loadSdk();
+            }
+            catch (error) {
+                throw new Error(`${MISSING_SDK_MESSAGE} (${error instanceof Error ? error.message : String(error)})`, {
+                    cause: error,
+                });
+            }
+        }
+        started() {
+            if (!this.client)
+                throw new Error('The client is not started.');
+            return this.client;
+        }
+        state() {
+            return Object.assign({ initialized: this.initialized, flags: this.client ? Object.assign({}, this.client.allFlags()) : {} }, (this.context ? { context: this.context } : {}));
+        }
+        flagsChanged(client, keys) {
+            if (this.client !== client)
+                return;
+            const flags = client.allFlags();
+            for (const key of keys) {
+                const value = key in flags ? flags[key] : null;
+                const hadPrevious = key in this.lastValues;
+                const previous = this.lastValues[key];
+                if (key in flags)
+                    this.lastValues[key] = flags[key];
+                else
+                    delete this.lastValues[key];
+                this.notifyListeners('flagChange', hadPrevious ? { key, value, previous } : { key, value });
+            }
+        }
+    }
+    function seconds(value) {
+        return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : DEFAULT_WAIT_SECONDS;
+    }
+    /**
+     * Refuses a context whose key (or the key of any kind in a multi-context) is missing or empty. The browser SDK would generate
+     * one for an anonymous context, stored per browser, and every browser would then count as a context of its own.
+     */
+    function requireKeys(context) {
+        var _a;
+        if (!context || typeof context !== 'object')
+            throw new Error('A context is needed.');
+        const parts = context.kind === 'multi'
+            ? Object.entries(context).filter(([kind]) => kind !== 'kind')
+            : [[String((_a = context.kind) !== null && _a !== void 0 ? _a : 'user'), context]];
+        if (parts.length === 0)
+            throw new Error('Invalid context: a multi-context needs at least one kind.');
+        for (const [kind, part] of parts) {
+            const key = part === null || part === void 0 ? void 0 : part.key;
+            if (typeof key !== 'string' || key === '') {
+                throw new Error(`Invalid context: the ${kind} context has no key. Pass one, also for an anonymous context.`);
+            }
+        }
+    }
+    function readStoredContext() {
+        try {
+            const json = localStorage.getItem(STORED_CONTEXT_KEY);
+            if (!json)
+                return undefined;
+            const context = JSON.parse(json);
+            requireKeys(context);
+            return context;
+        }
+        catch (_a) {
+            return undefined;
+        }
+    }
+    function writeStoredContext(context) {
+        try {
+            localStorage.setItem(STORED_CONTEXT_KEY, JSON.stringify(context));
+        }
+        catch (_a) {
+            // No storage: the next start begins with the context initialize() is given.
+        }
+    }
+
+    var web = /*#__PURE__*/Object.freeze({
+        __proto__: null,
+        LaunchDarklyWeb: LaunchDarklyWeb,
+        MISSING_SDK_MESSAGE: MISSING_SDK_MESSAGE,
+        STORED_CONTEXT_KEY: STORED_CONTEXT_KEY,
+        requireKeys: requireKeys
+    });
+
+    exports.LaunchDarkly = LaunchDarkly;
+
+    return exports;
+
+})({}, capacitorExports);
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sources":["esm/index.js","esm/web.js"],"sourcesContent":["import { registerPlugin } from '@capacitor/core';\nconst LaunchDarkly = registerPlugin('LaunchDarkly', {\n    web: () => import('./web').then((m) => new m.LaunchDarklyWeb()),\n});\nexport * from './definitions';\nexport { LaunchDarkly };\n//# sourceMappingURL=index.js.map","import { WebPlugin } from '@capacitor/core';\n/** The key the plugin keeps the context of the last `identify()` under in `localStorage`. */\nexport const STORED_CONTEXT_KEY = 'CapacitorLaunchDarkly.context';\nconst DEFAULT_WAIT_SECONDS = 5;\nexport const MISSING_SDK_MESSAGE = 'The LaunchDarkly web SDK is not installed. To use this plugin on the web, run: npm install @launchdarkly/js-client-sdk';\n// Imported only when a web app starts the client, so a native-only app never loads it.\nconst importSdk = () => import('@launchdarkly/js-client-sdk');\n/**\n * The web implementation, on LaunchDarkly's browser SDK. It follows the native rules: one client per page, a context the\n * caller gave with its key (an anonymous context without a key is refused rather than given a generated one), and a context\n * stored by `identify()` that wins over the one `initialize()` is given.\n */\nexport class LaunchDarklyWeb extends WebPlugin {\n    constructor(loadSdk = importSdk) {\n        super();\n        this.loadSdk = loadSdk;\n        this.options = {};\n        this.initialized = false;\n        this.lastValues = {};\n    }\n    async initialize(options) {\n        var _a, _b, _c, _d;\n        const clientSideId = options === null || options === void 0 ? void 0 : options.clientSideId;\n        if (!clientSideId)\n            throw new Error('initialize needs a clientSideId on the web.');\n        if (this.clientSideId === clientSideId) {\n            await this.starting;\n            return this.state();\n        }\n        requireKeys(options.context);\n        const sdk = await this.sdk();\n        if (this.client)\n            await this.close();\n        const startOptions = (_a = options.options) !== null && _a !== void 0 ? _a : {};\n        // The given context plays the part of initialContext: a context an earlier identify() stored wins over it.\n        const context = (_b = readStoredContext()) !== null && _b !== void 0 ? _b : options.context;\n        const streaming = ((_c = startOptions.streaming) !== null && _c !== void 0 ? _c : true) && !startOptions.offline;\n        const client = sdk.createClient(clientSideId, context, Object.assign({ streaming, withReasons: (_d = startOptions.evaluationReasons) !== null && _d !== void 0 ? _d : false }, (startOptions.application ? { applicationInfo: startOptions.application } : {})));\n        this.client = client;\n        this.clientSideId = clientSideId;\n        this.options = startOptions;\n        this.context = context;\n        this.initialized = false;\n        client.on('change', (_context, keys) => this.flagsChanged(client, keys));\n        const bootstrap = startOptions.bootstrap;\n        this.starting = client\n            .start(Object.assign({ timeout: seconds(startOptions.startWaitSeconds) }, (bootstrap && bootstrap !== 'localStorage' ? { bootstrap } : {})))\n            .then((result) => {\n            if (this.client !== client)\n                return;\n            this.initialized = result.status === 'complete';\n            this.lastValues = Object.assign({}, client.allFlags());\n        });\n        await this.starting;\n        return this.state();\n    }\n    async waitForInitialization(options) {\n        const client = this.client;\n        if (!client)\n            return { initialized: false };\n        if (!this.initialized) {\n            const result = await client.waitForInitialization({ timeout: seconds(options === null || options === void 0 ? void 0 : options.timeoutSeconds) });\n            if (this.client === client && result.status === 'complete')\n                this.initialized = true;\n        }\n        return { initialized: this.initialized };\n    }\n    async getState() {\n        await this.starting;\n        return this.state();\n    }\n    async identify(options) {\n        const client = this.started();\n        requireKeys(options === null || options === void 0 ? void 0 : options.context);\n        const result = await client.identify(options.context, { timeout: seconds(options.timeoutSeconds) });\n        if (result.status === 'error' || result.status === 'shed') {\n            throw new Error(result.status === 'shed' ? 'identify was replaced by a later identify' : 'identify failed');\n        }\n        // On a timeout the SDK has switched to the context and keeps loading its flags; only the wait is over.\n        this.context = options.context;\n        writeStoredContext(options.context);\n        return { timedOut: result.status === 'timeout' };\n    }\n    async variation(options) {\n        var _a;\n        const defaultValue = (_a = options.defaultValue) !== null && _a !== void 0 ? _a : null;\n        const value = this.client ? this.client.jsonVariation(options.key, defaultValue) : defaultValue;\n        return { value: value !== null && value !== void 0 ? value : null };\n    }\n    async allFlags() {\n        return { flags: this.client ? Object.assign({}, this.client.allFlags()) : {} };\n    }\n    async setStreaming(options) {\n        const client = this.started();\n        this.options = Object.assign(Object.assign({}, this.options), { streaming: options.enabled });\n        client.setStreaming(options.enabled);\n    }\n    async setOnline(options) {\n        var _a;\n        // The browser SDK has no offline mode: offline closes the stream, online opens it again when streaming is on.\n        const client = this.started();\n        client.setStreaming(options.online ? ((_a = this.options.streaming) !== null && _a !== void 0 ? _a : true) : false);\n    }\n    async flush() {\n        var _a;\n        await ((_a = this.client) === null || _a === void 0 ? void 0 : _a.flush());\n    }\n    async close() {\n        const client = this.client;\n        this.client = undefined;\n        this.clientSideId = undefined;\n        this.context = undefined;\n        this.initialized = false;\n        this.starting = undefined;\n        this.lastValues = {};\n        await (client === null || client === void 0 ? void 0 : client.close());\n    }\n    async clearStoredContext() {\n        try {\n            localStorage.removeItem(STORED_CONTEXT_KEY);\n        }\n        catch (_a) {\n            // No storage (a private window, blocked site data): nothing was stored either.\n        }\n    }\n    async sdk() {\n        try {\n            return await this.loadSdk();\n        }\n        catch (error) {\n            throw new Error(`${MISSING_SDK_MESSAGE} (${error instanceof Error ? error.message : String(error)})`, {\n                cause: error,\n            });\n        }\n    }\n    started() {\n        if (!this.client)\n            throw new Error('The client is not started.');\n        return this.client;\n    }\n    state() {\n        return Object.assign({ initialized: this.initialized, flags: this.client ? Object.assign({}, this.client.allFlags()) : {} }, (this.context ? { context: this.context } : {}));\n    }\n    flagsChanged(client, keys) {\n        if (this.client !== client)\n            return;\n        const flags = client.allFlags();\n        for (const key of keys) {\n            const value = key in flags ? flags[key] : null;\n            const hadPrevious = key in this.lastValues;\n            const previous = this.lastValues[key];\n            if (key in flags)\n                this.lastValues[key] = flags[key];\n            else\n                delete this.lastValues[key];\n            this.notifyListeners('flagChange', hadPrevious ? { key, value, previous } : { key, value });\n        }\n    }\n}\nfunction seconds(value) {\n    return typeof value === 'number' && Number.isFinite(value) && value >= 0 ? value : DEFAULT_WAIT_SECONDS;\n}\n/**\n * Refuses a context whose key (or the key of any kind in a multi-context) is missing or empty. The browser SDK would generate\n * one for an anonymous context, stored per browser, and every browser would then count as a context of its own.\n */\nexport function requireKeys(context) {\n    var _a;\n    if (!context || typeof context !== 'object')\n        throw new Error('A context is needed.');\n    const parts = context.kind === 'multi'\n        ? Object.entries(context).filter(([kind]) => kind !== 'kind')\n        : [[String((_a = context.kind) !== null && _a !== void 0 ? _a : 'user'), context]];\n    if (parts.length === 0)\n        throw new Error('Invalid context: a multi-context needs at least one kind.');\n    for (const [kind, part] of parts) {\n        const key = part === null || part === void 0 ? void 0 : part.key;\n        if (typeof key !== 'string' || key === '') {\n            throw new Error(`Invalid context: the ${kind} context has no key. Pass one, also for an anonymous context.`);\n        }\n    }\n}\nfunction readStoredContext() {\n    try {\n        const json = localStorage.getItem(STORED_CONTEXT_KEY);\n        if (!json)\n            return undefined;\n        const context = JSON.parse(json);\n        requireKeys(context);\n        return context;\n    }\n    catch (_a) {\n        return undefined;\n    }\n}\nfunction writeStoredContext(context) {\n    try {\n        localStorage.setItem(STORED_CONTEXT_KEY, JSON.stringify(context));\n    }\n    catch (_a) {\n        // No storage: the next start begins with the context initialize() is given.\n    }\n}\n//# sourceMappingURL=web.js.map"],"names":["registerPlugin","WebPlugin"],"mappings":"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"}

package/ios/Sources/LaunchDarklyPlugin/ConfigFactory.swift

@@ -0,0 +1,29 @@
+import Foundation
+import LaunchDarkly
+
+/// Builds the SDK configuration. Two settings here are not options, because LaunchDarkly bills client-side SDKs by the number
+/// of unique context keys (of the kind that has the most):
+///
+/// - Automatic environment attributes are disabled. Enabled, the SDK adds `ld_application` and `ld_device` contexts to every
+///   context it evaluates (`AutoEnvContextModifier`), and the `ld_device` key is generated per install, which counts every
+///   device as a context of its own.
+/// - Keys are never generated. The iOS SDK generates a key only for a context built without one (`LDContextBuilder()` with no
+///   key, or a start with no context at all, which falls back to `LDContext()`); it has no setting that replaces the key of an
+///   anonymous context. The plugin always builds contexts from JSON with the caller's key and always starts with a context.
+public enum ConfigFactory {
+    public static func make(_ options: StartOptions) -> LDConfig {
+        var config = LDConfig(mobileKey: options.mobileKey, autoEnvAttributes: .disabled)
+        config.streamingMode = options.streaming ? .streaming : .polling
+        config.evaluationReasons = options.evaluationReasons
+        config.startOnline = !options.offline
+        if let app = options.application {
+            var info = ApplicationInfo()
+            info.applicationIdentifier(app.id)
+            info.applicationName(app.name)
+            info.applicationVersion(app.version)
+            info.applicationVersionName(app.versionName)
+            config.applicationInfo = info
+        }
+        return config
+    }
+}

package/ios/Sources/LaunchDarklyPlugin/JSONValues.swift

@@ -0,0 +1,68 @@
+import Foundation
+import LaunchDarkly
+
+public enum PluginError: LocalizedError, Equatable {
+    case invalidContext(String)
+    case notStarted
+
+    public var errorDescription: String? {
+        switch self {
+        case .invalidContext(let reason): return "Invalid context: \(reason)"
+        case .notStarted: return "The client is not started."
+        }
+    }
+}
+
+/// JSON text from what Capacitor hands over (dictionaries, arrays, strings, numbers, booleans, NSNull).
+enum JSONText {
+    static func from(_ value: Any) -> String? {
+        guard JSONSerialization.isValidJSONObject([value]),
+              let data = try? JSONSerialization.data(withJSONObject: value, options: [.fragmentsAllowed, .sortedKeys]) else { return nil }
+        return String(data: data, encoding: .utf8)
+    }
+}
+
+/// Contexts in the JSON shape LaunchDarkly's SDKs use, read by the SDK's own decoder, so custom attributes of any JSON type,
+/// nested objects, `anonymous`, `name`, multi-contexts and `_meta.privateAttributes` mean what they mean to LaunchDarkly. The
+/// key is taken as given: nothing here generates or replaces one.
+public enum Contexts {
+    public static func parse(_ json: String) throws -> LDContext {
+        do {
+            return try JSONDecoder().decode(LDContext.self, from: Data(json.utf8))
+        } catch {
+            throw PluginError.invalidContext(String(describing: error))
+        }
+    }
+
+    public static func parseOrNil(_ json: String?) -> LDContext? {
+        guard let json else { return nil }
+        return try? parse(json)
+    }
+
+    /// The JSON of a context Capacitor handed over as a dictionary.
+    public static func json(from object: [String: Any]) throws -> String {
+        guard let json = JSONText.from(object) else { throw PluginError.invalidContext("not JSON") }
+        return json
+    }
+}
+
+/// Flag values between JavaScript and the SDK's `LDValue`, through JSON.
+public enum JSValues {
+    public static func toLDValue(_ value: Any?) -> LDValue {
+        guard let value, !(value is NSNull), let json = JSONText.from(value),
+              let decoded = try? JSONDecoder().decode(LDValue.self, from: Data(json.utf8)) else { return .null }
+        return decoded
+    }
+
+    /// An `LDValue` as a value Capacitor can send to JavaScript; JSON null is `NSNull`.
+    public static func toJS(_ value: LDValue?) -> Any {
+        guard let value, value != .null,
+              let data = try? JSONEncoder().encode(value),
+              let object = try? JSONSerialization.jsonObject(with: data, options: .fragmentsAllowed) else { return NSNull() }
+        return object
+    }
+
+    public static func flags(_ values: [String: LDValue]) -> [String: Any] {
+        values.mapValues { toJS($0) }
+    }
+}

package/ios/Sources/LaunchDarklyPlugin/LaunchDarklyClient.swift

@@ -0,0 +1,165 @@
+import Foundation
+import LaunchDarkly
+
+/// Where the client's events go: the plugin instance of the current bridge.
+protocol ClientEvents: AnyObject {
+    func flagChanged(key: String, value: LDValue, previous: LDValue?)
+    func connectionModeChanged(_ mode: String)
+}
+
+/// The one LaunchDarkly client of the process. It outlives a plugin instance, while the SDK keeps one client per process.
+///
+/// Every SDK call and every piece of state here is on the main queue: the SDK delivers its completions and observer callbacks
+/// there, so keeping to it leaves nothing to race. Capacitor calls plugin methods on a queue of its own, and the plugin hops to
+/// main with `LaunchDarklyClient.onMain`.
+final class LaunchDarklyClient {
+    static let shared = LaunchDarklyClient()
+
+    weak var events: ClientEvents?
+
+    private(set) var options: StartOptions?
+    private(set) var contextJSON: String?
+    private var starting = false
+    private var afterStartQueue: [() -> Void] = []
+    /// The owner of the SDK observers; replaced on every start so a closed client's observers are dropped with it.
+    private var observerOwner = NSObject()
+
+    private init() {}
+
+    static func onMain(_ work: @escaping () -> Void) {
+        if Thread.isMainThread { work() } else { DispatchQueue.main.async(execute: work) }
+    }
+
+    private var client: LDClient? { options == nil ? nil : LDClient.get() }
+
+    /// Starts the client unless one with the same mobile key is running or starting; one with another key is closed first.
+    /// `done` runs once the start has finished: the first flags are in or the wait is over.
+    func start(_ options: StartOptions, context: ContextChoice, done: (() -> Void)? = nil) {
+        dispatchPrecondition(condition: .onQueue(.main))
+        if self.options?.mobileKey == options.mobileKey {
+            afterStart { done?() }
+            return
+        }
+        startNow(options, context: context, done: done)
+    }
+
+    private func startNow(_ options: StartOptions, context: ContextChoice, done: (() -> Void)?) {
+        if self.options != nil { closeNow() }
+        self.options = options
+        contextJSON = context.json
+        starting = true
+        if let done { afterStartQueue.append(done) }
+        let owner = NSObject()
+        observerOwner = owner
+        LDClient.start(config: ConfigFactory.make(options), context: context.context, startWaitSeconds: options.startWaitSeconds) { [weak self] _ in
+            guard let self, self.observerOwner === owner else { return }
+            self.starting = false
+            let waiting = self.afterStartQueue
+            self.afterStartQueue = []
+            waiting.forEach { $0() }
+        }
+        // start() creates the client before it returns, so the observers are in place before the first flags can arrive.
+        observe(owner: owner)
+    }
+
+    private func observe(owner: NSObject) {
+        guard let client else { return }
+        client.observeAll(owner: owner) { [weak self] changes in
+            for (key, change) in changes.sorted(by: { $0.key < $1.key }) {
+                self?.events?.flagChanged(key: key, value: change.newValue, previous: change.oldValue == .null ? nil : change.oldValue)
+            }
+        }
+        client.observeCurrentConnectionMode(owner: owner) { [weak self] mode in
+            self?.events?.connectionModeChanged(mode.rawValue)
+        }
+    }
+
+    /// Restarts the running client with `change` applied to its options, keeping the current context.
+    func restart(_ change: (StartOptions) -> StartOptions, done: @escaping (Error?) -> Void) {
+        dispatchPrecondition(condition: .onQueue(.main))
+        guard let options, let contextJSON else { return done(PluginError.notStarted) }
+        do {
+            let context = ContextChoice(context: try Contexts.parse(contextJSON), json: contextJSON)
+            startNow(change(options), context: context) { done(nil) }
+        } catch {
+            done(error)
+        }
+    }
+
+    /// Runs `work` once the start has finished, or straight away when nothing is starting.
+    func afterStart(_ work: @escaping () -> Void) {
+        dispatchPrecondition(condition: .onQueue(.main))
+        if starting { afterStartQueue.append(work) } else { work() }
+    }
+
+    /// Switches the context; `done` gets whether the wait for its flags timed out, or the error.
+    func identify(_ context: ContextChoice, timeout: TimeInterval, store: ContextStore, done: @escaping (Result<Bool, Error>) -> Void) {
+        dispatchPrecondition(condition: .onQueue(.main))
+        afterStart { [weak self] in
+            guard let self, let client = self.client else { return done(.failure(PluginError.notStarted)) }
+            client.identify(context: context.context, timeout: timeout) { result in
+                Self.onMain {
+                    switch result {
+                    case .complete, .timeout:
+                        // On a timeout the SDK has switched to the context and keeps loading its flags; only the wait is over.
+                        self.contextJSON = context.json
+                        store.write(context.json)
+                        done(.success(result == .timeout))
+                    case .shed:
+                        done(.failure(NSError(domain: "LaunchDarkly", code: 1, userInfo: [NSLocalizedDescriptionKey: "identify was replaced by a later identify"])))
+                    case .error:
+                        done(.failure(NSError(domain: "LaunchDarkly", code: 2, userInfo: [NSLocalizedDescriptionKey: "identify failed"])))
+                    }
+                }
+            }
+        }
+    }
+
+    /// Answers whether the client has its first flags, waiting up to `timeout` for them.
+    func waitForInitialization(timeout: TimeInterval, answer: @escaping (Bool) -> Void) {
+        dispatchPrecondition(condition: .onQueue(.main))
+        guard options != nil else { return answer(false) }
+        let deadline = Date().addingTimeInterval(timeout)
+        func check() {
+            if client?.isInitialized == true { return answer(true) }
+            if options == nil || Date() >= deadline { return answer(false) }
+            DispatchQueue.main.asyncAfter(deadline: .now() + 0.05, execute: check)
+        }
+        check()
+    }
+
+    var isInitialized: Bool { client?.isInitialized == true }
+
+    /// Every flag from the SDK's store; reading them this way records no evaluation event.
+    var allFlags: [String: LDValue] { client?.allFlags ?? [:] }
+
+    func variation(_ key: String, defaultValue: LDValue) -> LDValue {
+        client?.jsonVariation(forKey: key, defaultValue: defaultValue) ?? defaultValue
+    }
+
+    func setOnline(_ online: Bool, done: @escaping () -> Void) {
+        guard let client else { return done() }
+        client.setOnline(online) { done() }
+    }
+
+    func flush() {
+        client?.flush()
+    }
+
+    func close() {
+        dispatchPrecondition(condition: .onQueue(.main))
+        closeNow()
+        let waiting = afterStartQueue
+        afterStartQueue = []
+        starting = false
+        waiting.forEach { $0() }
+    }
+
+    private func closeNow() {
+        LDClient.get()?.stopObserving(owner: observerOwner)
+        LDClient.get()?.close()
+        observerOwner = NSObject()
+        options = nil
+        contextJSON = nil
+    }
+}