@meshline/expo 0.1.0-alpha.1

package/dist/socket.js

@@ -0,0 +1,143 @@
+import { encodeUtf8, webEndpoint } from '@meshline/sdk';
+let nextId = 0;
+/** The native implementation owns TLS, cookie/redirect policy and actual RFC close codes. */
+export function nativeSocketFactory(module) {
+    return endpoint => {
+        const normalized = webEndpoint(endpoint, 'wss:').href;
+        if (nextId === Number.MAX_SAFE_INTEGER)
+            throw new Error('Native socket identifiers are exhausted.');
+        const id = ++nextId;
+        let state = 0;
+        let connected = false;
+        let timer;
+        const listeners = new Map();
+        function emit(event, value) {
+            for (const listener of [...listeners.get(event) ?? []])
+                listener(value);
+        }
+        function finish(code, reason) {
+            if (state === 3)
+                return;
+            state = 3;
+            clearTimeout(timer);
+            subscription.remove();
+            try {
+                emit('close', { code, reason });
+            }
+            finally {
+                listeners.clear();
+            }
+        }
+        function fail(error) {
+            if (state === 3)
+                return;
+            try {
+                emit('error', error instanceof Error ? error : new Error(String(error)));
+            }
+            finally {
+                try {
+                    if (connected)
+                        module.cancel(id);
+                }
+                finally {
+                    finish(1006, 'Native WebSocket failed.');
+                }
+            }
+        }
+        const subscription = module.addListener('socket', event => {
+            if (event.id !== id || state === 3)
+                return;
+            switch (event.type) {
+                case 'open':
+                    if (state === 0) {
+                        state = 1;
+                        emit('open', undefined);
+                    }
+                    break;
+                case 'text':
+                    if (state === 1)
+                        emit('message', event.text);
+                    break;
+                case 'binary':
+                    if (state === 1)
+                        emit('message', new Uint8Array());
+                    break;
+                case 'error':
+                    fail(new Error(event.message ?? 'Native WebSocket failed.'));
+                    break;
+                case 'close':
+                    finish(event.code ?? 1006, event.reason ?? '');
+                    break;
+            }
+        });
+        // RpcConnection installs all event handlers before native callbacks can fire.
+        queueMicrotask(() => {
+            if (state !== 0)
+                return;
+            connected = true;
+            try {
+                module.connect(id, normalized);
+            }
+            catch (error) {
+                fail(error);
+            }
+        });
+        const socket = {
+            get readyState() { return state; },
+            get bufferedAmount() { return connected && state !== 3 ? module.bufferedAmount(id) : 0; },
+            send(text) {
+                if (state !== 1)
+                    throw new Error('Native WebSocket is not open.');
+                // Reject malformed UTF-16 before a native bridge can replace it.
+                encodeUtf8(text);
+                module.send(id, text);
+            },
+            close(code, reason) {
+                if (!Number.isInteger(code) || !([1000, 1001, 1002, 1003, 1007, 1008, 1009, 1010, 1011, 1012, 1013, 1014].includes(code) || code >= 3000 && code <= 4999))
+                    throw new RangeError('Invalid WebSocket close code.');
+                if (encodeUtf8(reason).length > 123)
+                    throw new RangeError('WebSocket close reason exceeds 123 UTF-8 bytes.');
+                if (state >= 2)
+                    return code;
+                state = 2;
+                if (!connected) {
+                    queueMicrotask(() => finish(code, reason));
+                    return code;
+                }
+                try {
+                    module.close(id, code, reason);
+                }
+                catch (error) {
+                    fail(error);
+                    throw error;
+                }
+                if (state !== 3)
+                    timer = setTimeout(() => {
+                        try {
+                            module.cancel(id);
+                        }
+                        catch (error) {
+                            emit('error', error instanceof Error ? error : new Error(String(error)));
+                        }
+                        finally {
+                            finish(1006, 'Native WebSocket close handshake timed out.');
+                        }
+                    }, 3000);
+                return code;
+            },
+            on(event, listener) {
+                if (state === 3)
+                    return () => { };
+                let set = listeners.get(event);
+                if (!set) {
+                    set = new Set();
+                    listeners.set(event, set);
+                }
+                set.add(listener);
+                return () => { set.delete(listener); };
+            },
+        };
+        return socket;
+    };
+}
+//# sourceMappingURL=socket.js.map

package/dist/socket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"socket.js","sourceRoot":"","sources":["../src/socket.ts"],"names":[],"mappings":"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"}

package/dist/sqlite-store.d.ts

@@ -0,0 +1,27 @@
+import { type MeshlineStore, type QueryReader, type RecordQuery, type StorageBinding, type StoredRecord, type StoreMutation, type StoreSnapshot } from '@meshline/sdk';
+/** Private adapter boundary, also exercised against a real SQLite driver in contract tests. */
+export interface SqliteDatabase {
+    execAsync(sql: string): Promise<void>;
+    runAsync(sql: string, ...parameters: (string | number | null)[]): Promise<unknown>;
+    getFirstAsync<T>(sql: string, ...parameters: (string | number | null)[]): Promise<T | null>;
+    getAllAsync<T>(sql: string, ...parameters: (string | number | null)[]): Promise<T[]>;
+    closeAsync(): Promise<void>;
+}
+export interface SqliteRuntime {
+    exists(): Promise<boolean>;
+    /** Every call MUST return a new, private native connection. Never use Expo's shared connection cache. */
+    open(): Promise<SqliteDatabase>;
+}
+/** Serialized private writer and independent WAL snapshots, with no transaction spanning application callbacks. */
+export declare class NativeSqliteStore implements MeshlineStore {
+    #private;
+    readonly runtime: SqliteRuntime;
+    constructor(runtime: SqliteRuntime);
+    migrate(signal?: AbortSignal): Promise<void>;
+    initialize(binding: StorageBinding, signal?: AbortSignal): Promise<void>;
+    read(queries: readonly RecordQuery[], signal?: AbortSignal): Promise<StoreSnapshot>;
+    commit(expectedVersion: number, mutations: readonly StoreMutation[], signal?: AbortSignal): Promise<number>;
+    openQuery(query: RecordQuery, signal?: AbortSignal): Promise<QueryReader<StoredRecord>>;
+    dispose(): Promise<void>;
+}
+//# sourceMappingURL=sqlite-store.d.ts.map

package/dist/sqlite-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.d.ts","sourceRoot":"","sources":["../src/sqlite-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAEiD,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,WAAW,EAC1G,KAAK,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,aAAa,EAAE,KAAK,aAAa,EACjF,MAAM,eAAe,CAAC;AAEvB,+FAA+F;AAC/F,MAAM,WAAW,cAAc;IAC3B,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,aAAa,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAC5F,WAAW,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACrF,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC/B;AACD,MAAM,WAAW,aAAa;IAC1B,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,yGAAyG;IACzG,IAAI,IAAI,OAAO,CAAC,cAAc,CAAC,CAAC;CACnC;AAWD,mHAAmH;AACnH,qBAAa,iBAAkB,YAAW,aAAa;;IAMvC,QAAQ,CAAC,OAAO,EAAE,aAAa;IAA3C,YAAqB,OAAO,EAAE,aAAa,EAAI;IAE/C,OAAO,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAqB3C;IAED,UAAU,CAAC,OAAO,EAAE,cAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAwBvE;IAED,IAAI,CAAC,OAAO,EAAE,SAAS,WAAW,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAWlF;IAED,MAAM,CAAC,eAAe,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,aAAa,EAAE,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,CAiB1G;IAED,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC,CActF;IAID,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CASvB;CACJ"}

package/dist/sqlite-store.js

@@ -0,0 +1,246 @@
+import { AsyncGate, StateConflictError, bindingJson, canonicalJson, parseJson, prepareCommit, requireBatchCount, requireObject, throwIfAborted, validateRecordQuery, } from '@meshline/sdk';
+function decodeRow(row) { return { collection: row.collection, key: row.key, revision: row.revision, value: requireObject(parseJson(row.value)) }; }
+function selection(query) {
+    validateRecordQuery(query);
+    let where = 'collection = ?';
+    const parameters = [query.collection];
+    if (query.key !== undefined) {
+        where += ' AND key = ?';
+        parameters.push(query.key);
+    }
+    else if (query.prefix !== undefined) {
+        where += ' AND key >= ? AND key < ?';
+        parameters.push(query.prefix, query.prefix + '\uffff');
+    }
+    return { where, parameters, order: query.reverse ? 'DESC' : 'ASC' };
+}
+/** Serialized private writer and independent WAL snapshots, with no transaction spanning application callbacks. */
+export class NativeSqliteStore {
+    runtime;
+    #gate = new AsyncGate();
+    #readers = new Set();
+    #database;
+    #disposed = false;
+    #disposal;
+    constructor(runtime) {
+        this.runtime = runtime;
+    }
+    migrate(signal) {
+        this.#check();
+        return this.#gate.run(async () => {
+            this.#check();
+            throwIfAborted(signal);
+            if (this.#database)
+                throw new Error('Migrate before initializing storage.');
+            const database = await this.runtime.open();
+            try {
+                await database.execAsync('PRAGMA busy_timeout = 5000; PRAGMA journal_mode = WAL; PRAGMA synchronous = FULL;');
+                await transaction(database, 'IMMEDIATE', async () => {
+                    const version = (await database.getFirstAsync('PRAGMA user_version')).user_version;
+                    if (version > 1)
+                        throw new Error(`Unsupported database schema ${version}.`);
+                    if (version === 0)
+                        await database.execAsync(`
+                        CREATE TABLE meshline_meta (id INTEGER PRIMARY KEY CHECK(id = 1), binding TEXT, version INTEGER NOT NULL CHECK(version >= 0));
+                        INSERT INTO meshline_meta VALUES (1, NULL, 0);
+                        CREATE TABLE meshline_records (collection TEXT NOT NULL, key TEXT NOT NULL, revision INTEGER NOT NULL, value TEXT NOT NULL,
+                            PRIMARY KEY(collection, key)) WITHOUT ROWID;
+                        PRAGMA user_version = 1;
+                    `);
+                }, signal);
+            }
+            finally {
+                await database.closeAsync();
+            }
+        }, signal);
+    }
+    initialize(binding, signal) {
+        this.#check();
+        const encoded = bindingJson(binding);
+        return this.#gate.run(async () => {
+            this.#check();
+            throwIfAborted(signal);
+            if (this.#database) {
+                const existing = await this.#database.getFirstAsync('SELECT binding FROM meshline_meta WHERE id = 1');
+                if (existing?.binding !== encoded)
+                    throw new Error('Database is bound to another network or account.');
+                return;
+            }
+            if (!await this.runtime.exists())
+                throw new Error('Database must be explicitly migrated before initialization.');
+            const database = await this.runtime.open();
+            try {
+                const version = (await database.getFirstAsync('PRAGMA user_version')).user_version;
+                if (version !== 1)
+                    throw new Error('Database must be explicitly migrated before initialization.');
+                await database.execAsync('PRAGMA busy_timeout = 5000; PRAGMA synchronous = FULL;');
+                await transaction(database, 'IMMEDIATE', async () => {
+                    const current = await database.getFirstAsync('SELECT binding FROM meshline_meta WHERE id = 1');
+                    if (!current)
+                        throw new Error('Missing Meshline database metadata.');
+                    if (current.binding !== null && current.binding !== encoded)
+                        throw new Error('Database is bound to another network or account.');
+                    if (current.binding === null)
+                        await database.runAsync('UPDATE meshline_meta SET binding = ? WHERE id = 1', encoded);
+                }, signal);
+                this.#database = database;
+            }
+            catch (error) {
+                await database.closeAsync();
+                throw error;
+            }
+        }, signal);
+    }
+    read(queries, signal) {
+        this.#check();
+        const selected = queries.map(selection);
+        return this.#gate.run(async () => {
+            const database = this.#connection();
+            return transaction(database, 'DEFERRED', async () => {
+                const version = (await database.getFirstAsync('SELECT version FROM meshline_meta WHERE id = 1')).version;
+                const sets = [];
+                for (const query of selected)
+                    sets.push((await database.getAllAsync(`SELECT * FROM meshline_records WHERE ${query.where} ORDER BY key ${query.order}`, ...query.parameters)).map(decodeRow));
+                return { version, sets };
+            }, signal);
+        }, signal);
+    }
+    commit(expectedVersion, mutations, signal) {
+        this.#check();
+        const changes = prepareCommit(expectedVersion, mutations);
+        return this.#gate.run(async () => {
+            const database = this.#connection();
+            return transaction(database, 'IMMEDIATE', async () => {
+                const version = (await database.getFirstAsync('SELECT version FROM meshline_meta WHERE id = 1')).version;
+                if (version !== expectedVersion)
+                    throw new StateConflictError('Database revision changed before commit.');
+                const next = expectedVersion + 1;
+                for (const change of changes) {
+                    throwIfAborted(signal);
+                    if (change.kind === 'put')
+                        await database.runAsync('INSERT INTO meshline_records VALUES (?, ?, ?, ?) ON CONFLICT(collection, key) DO UPDATE SET revision = excluded.revision, value = excluded.value', change.collection, change.key, next, canonicalJson(change.value));
+                    else
+                        await database.runAsync('DELETE FROM meshline_records WHERE collection = ? AND key = ?', change.collection, change.key);
+                }
+                await database.runAsync('UPDATE meshline_meta SET version = ? WHERE id = 1', next);
+                return next;
+            }, signal);
+        }, signal);
+    }
+    openQuery(query, signal) {
+        this.#check();
+        const selected = selection(query);
+        return this.#gate.run(async () => {
+            this.#connection();
+            throwIfAborted(signal);
+            const database = await this.runtime.open();
+            try {
+                await database.execAsync('PRAGMA busy_timeout = 5000; PRAGMA query_only = ON; BEGIN DEFERRED;');
+                // Reading a real table pins the WAL snapshot before returning to application code.
+                await database.getFirstAsync('SELECT version FROM meshline_meta WHERE id = 1');
+                throwIfAborted(signal);
+                const reader = new NativeReader(database, selected, () => this.#readers.delete(reader));
+                this.#readers.add(reader);
+                return reader;
+            }
+            catch (error) {
+                await database.closeAsync();
+                throw error;
+            }
+        }, signal);
+    }
+    #check() { if (this.#disposed)
+        throw new Error('Store is disposed.'); }
+    #connection() { this.#check(); if (!this.#database)
+        throw new Error('Store is not initialized.'); return this.#database; }
+    dispose() {
+        this.#disposed = true;
+        return this.#disposal ??= this.#gate.run(async () => {
+            const failures = [];
+            for (const reader of this.#readers) {
+                try {
+                    await reader.dispose();
+                }
+                catch (error) {
+                    failures.push(error);
+                }
+            }
+            try {
+                await this.#database?.closeAsync();
+            }
+            catch (error) {
+                failures.push(error);
+            }
+            this.#database = undefined;
+            if (failures.length)
+                throw new AggregateError(failures, 'Failed to dispose native SQLite storage.');
+        });
+    }
+}
+async function transaction(database, mode, action, signal) {
+    throwIfAborted(signal);
+    await database.execAsync(`BEGIN ${mode}`);
+    try {
+        const result = await action();
+        throwIfAborted(signal);
+        await database.execAsync('COMMIT');
+        return result;
+    }
+    catch (error) {
+        try {
+            await database.execAsync('ROLLBACK');
+        }
+        catch (rollbackError) {
+            throw new AggregateError([error, rollbackError], 'SQLite operation and rollback both failed.');
+        }
+        throw error;
+    }
+}
+class NativeReader {
+    database;
+    query;
+    released;
+    #gate = new AsyncGate();
+    #offset = 0;
+    #completed = false;
+    #disposed = false;
+    #disposal;
+    constructor(database, query, released) {
+        this.database = database;
+        this.query = query;
+        this.released = released;
+    }
+    readNext(count, signal) {
+        requireBatchCount(count);
+        return this.#gate.run(async () => {
+            if (this.#disposed)
+                throw new Error('Reader is disposed.');
+            throwIfAborted(signal);
+            if (this.#completed)
+                return [];
+            const rows = await this.database.getAllAsync(`SELECT * FROM meshline_records WHERE ${this.query.where} ORDER BY key ${this.query.order} LIMIT ? OFFSET ?`, ...this.query.parameters, count, this.#offset);
+            const records = rows.map(decodeRow);
+            throwIfAborted(signal);
+            this.#offset += records.length;
+            this.#completed = records.length < count;
+            return records;
+        }, signal);
+    }
+    dispose() {
+        this.#disposed = true;
+        return this.#disposal ??= this.#gate.run(async () => {
+            try {
+                await this.database.execAsync('ROLLBACK');
+            }
+            finally {
+                try {
+                    await this.database.closeAsync();
+                }
+                finally {
+                    this.released();
+                }
+            }
+        });
+    }
+}
+//# sourceMappingURL=sqlite-store.js.map

package/dist/sqlite-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-store.js","sourceRoot":"","sources":["../src/sqlite-store.ts"],"names":[],"mappings":"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"}

package/expo-module.config.json

@@ -0,0 +1,5 @@
+{
+  "platforms": ["apple", "android"],
+  "apple": { "modules": ["MeshlineRelaySocketModule"] },
+  "android": { "modules": ["org.meshline.expo.MeshlineRelaySocketModule"] }
+}

package/ios/MeshlineExpo.podspec

@@ -0,0 +1,19 @@
+require 'json'
+package = JSON.parse(File.read(File.join(__dir__, '..', 'package.json')))
+
+Pod::Spec.new do |s|
+  s.name = 'MeshlineExpo'
+  s.version = package['version']
+  s.summary = package['description']
+  s.description = package['description']
+  s.license = package['license']
+  s.author = 'Meshline contributors'
+  s.homepage = 'https://meshline.org'
+  s.source = { :git => 'https://github.com/meshline-network/sdk.git' }
+  s.platforms = { :ios => '16.4' }
+  s.swift_version = '5.9'
+  s.static_framework = true
+  s.dependency 'ExpoModulesCore'
+  s.source_files = '**/*.swift'
+  s.pod_target_xcconfig = { 'DEFINES_MODULE' => 'YES', 'SWIFT_COMPILATION_MODE' => 'wholemodule' }
+end

package/ios/MeshlineRelaySocketModule.swift

@@ -0,0 +1,160 @@
+import ExpoModulesCore
+import Foundation
+
+public final class MeshlineRelaySocketModule: Module {
+  private let lock = NSLock()
+  private var sockets: [Double: RelaySocketConnection] = [:]
+
+  public func definition() -> ModuleDefinition {
+    Name("MeshlineRelaySocket")
+    Events("socket")
+    Function("connect") { (id: Double, endpoint: String) in try self.connect(id, endpoint) }
+    Function("send") { (id: Double, text: String) in
+      guard let socket = self.socket(id) else { throw SocketError("WebSocket is not open.") }
+      try socket.send(text)
+    }
+    Function("close") { (id: Double, code: Int, reason: String) throws -> Void in
+      if let socket = self.socket(id) { try socket.close(code, reason) }
+    }
+    Function("cancel") { (id: Double) -> Void in
+      if let socket = self.remove(id) { socket.cancel() }
+    }
+    Function("bufferedAmount") { (id: Double) -> Double in Double(self.socket(id)?.bufferedAmount ?? 0) }
+    OnDestroy {
+      self.lock.lock(); let closing = Array(self.sockets.values); self.sockets.removeAll(); self.lock.unlock()
+      closing.forEach { $0.cancel() }
+    }
+  }
+
+  private func socket(_ id: Double) -> RelaySocketConnection? {
+    lock.lock(); defer { lock.unlock() }; return sockets[id]
+  }
+  private func remove(_ id: Double) -> RelaySocketConnection? {
+    lock.lock(); defer { lock.unlock() }; return sockets.removeValue(forKey: id)
+  }
+  private func connect(_ id: Double, _ endpoint: String) throws {
+    guard let url = URL(string: endpoint), url.scheme == "wss", url.host != nil,
+      url.user == nil, url.password == nil, url.query == nil, url.fragment == nil else {
+      throw SocketError("Expected a credential-free WSS endpoint.")
+    }
+    let connection = RelaySocketConnection(url: url) { [weak self] type, fields in
+      guard let self, self.socket(id) != nil else { return }
+      self.sendEvent("socket", fields.merging(["id": id, "type": type]) { _, value in value })
+      if type == "close" { _ = self.remove(id) }
+    }
+    lock.lock()
+    guard sockets[id] == nil else { lock.unlock(); throw SocketError("Duplicate native WebSocket identifier.") }
+    sockets[id] = connection; lock.unlock()
+    connection.start()
+  }
+}
+
+private struct SocketError: LocalizedError {
+  let errorDescription: String?
+  init(_ message: String) { errorDescription = message }
+}
+
+private final class RelaySocketConnection: NSObject, URLSessionWebSocketDelegate, @unchecked Sendable {
+  private let lock = NSRecursiveLock()
+  private let url: URL
+  private let event: (String, [String: Any]) -> Void
+  private var session: URLSession?
+  private var task: URLSessionWebSocketTask?
+  private var ended = false
+  private var queued = 0
+
+  init(url: URL, event: @escaping (String, [String: Any]) -> Void) { self.url = url; self.event = event }
+  var bufferedAmount: Int { lock.lock(); defer { lock.unlock() }; return queued }
+
+  func start() {
+    lock.lock(); defer { lock.unlock() }
+    guard !ended else { return }
+    // An ephemeral, dedicated session does not share the app's cookies, credentials or cache.
+    let configuration = URLSessionConfiguration.ephemeral
+    configuration.httpCookieStorage = nil
+    configuration.httpShouldSetCookies = false
+    configuration.httpCookieAcceptPolicy = .never
+    configuration.urlCredentialStorage = nil
+    configuration.urlCache = nil
+    configuration.requestCachePolicy = .reloadIgnoringLocalCacheData
+    configuration.timeoutIntervalForRequest = 60
+    let queue = OperationQueue(); queue.maxConcurrentOperationCount = 1
+    let session = URLSession(configuration: configuration, delegate: self, delegateQueue: queue)
+    var request = URLRequest(url: url, cachePolicy: .reloadIgnoringLocalCacheData, timeoutInterval: 60)
+    request.httpShouldHandleCookies = false
+    let task = session.webSocketTask(with: request)
+    // The RPC layer enforces 1 MiB UTF-8 text; this also bounds native receive buffering.
+    task.maximumMessageSize = 1_048_576
+    self.session = session; self.task = task; task.resume()
+  }
+
+  func send(_ text: String) throws {
+    lock.lock(); defer { lock.unlock() }
+    guard !ended, let task else { throw SocketError("WebSocket is not open.") }
+    let size = text.utf8.count; queued += size
+    task.send(.string(text)) { [weak self] error in
+      guard let self else { return }
+      self.lock.lock(); self.queued = max(0, self.queued - size); self.lock.unlock()
+      if let error { self.fail(error) }
+    }
+  }
+  func close(_ code: Int, _ reason: String) throws {
+    guard let closeCode = URLSessionWebSocketTask.CloseCode(rawValue: code) else { throw SocketError("Invalid WebSocket close code.") }
+    lock.lock(); defer { lock.unlock() }
+    guard !ended else { return }
+    task?.cancel(with: closeCode, reason: Data(reason.utf8))
+  }
+  func cancel() { finish(1006, "Native WebSocket canceled.") }
+
+  private func receive() {
+    lock.lock(); defer { lock.unlock() }
+    guard !ended, let task else { return }
+    task.receive { [weak self] result in
+      guard let self else { return }
+      self.lock.lock(); let live = !self.ended; self.lock.unlock()
+      guard live else { return }
+      switch result {
+      case .success(let message):
+        switch message {
+        case .string(let text): self.event("text", ["text": text])
+        case .data: self.event("binary", [:])
+        @unknown default: self.fail(SocketError("Unknown native WebSocket message kind.")); return
+        }
+        self.receive()
+      case .failure(let error): self.fail(error)
+      }
+    }
+  }
+  private func fail(_ error: Error) {
+    lock.lock(); defer { lock.unlock() }
+    guard !ended else { return }
+    event("error", ["message": error.localizedDescription]); finish(1006, "Native WebSocket failed.")
+  }
+  private func finish(_ code: Int, _ reason: String) {
+    lock.lock(); defer { lock.unlock() }
+    guard !ended else { return }
+    ended = true; queued = 0
+    task?.cancel(); session?.invalidateAndCancel(); task = nil; session = nil
+    event("close", ["code": code, "reason": reason])
+  }
+
+  func urlSession(_ session: URLSession, webSocketTask: URLSessionWebSocketTask, didOpenWithProtocol protocol: String?) {
+    lock.lock(); let live = !ended; lock.unlock()
+    if live { event("open", [:]); receive() }
+  }
+  func urlSession(_ session: URLSession, webSocketTask: URLSessionWebSocketTask, didCloseWith closeCode: URLSessionWebSocketTask.CloseCode, reason: Data?) {
+    finish(closeCode.rawValue, reason.flatMap { String(data: $0, encoding: .utf8) } ?? "")
+  }
+  func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
+    if let error { fail(error) } else { finish(1006, "WebSocket ended without a close frame.") }
+  }
+  func urlSession(_ session: URLSession, task: URLSessionTask, willPerformHTTPRedirection response: HTTPURLResponse, newRequest request: URLRequest, completionHandler: @escaping (URLRequest?) -> Void) {
+    completionHandler(nil)
+  }
+  func urlSession(_ session: URLSession, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
+    completionHandler(challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust ? .performDefaultHandling : .cancelAuthenticationChallenge, nil)
+  }
+  func urlSession(_ session: URLSession, task: URLSessionTask, didReceive challenge: URLAuthenticationChallenge, completionHandler: @escaping (URLSession.AuthChallengeDisposition, URLCredential?) -> Void) {
+    completionHandler(challenge.protectionSpace.authenticationMethod == NSURLAuthenticationMethodServerTrust ? .performDefaultHandling : .cancelAuthenticationChallenge, nil)
+  }
+}