@mdbase-dev/sdk 0.0.0-stage → 0.1.0-beta.149

package/dist/notifications.js.map

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

package/dist/offline-shell-build.d.ts

@@ -0,0 +1,25 @@
+import type { OfflineShellManifest } from "./offline-shell-worker.js";
+export interface OfflineShellBuildOptions {
+    directory: string;
+    base?: string;
+    /** Existing notification worker to extend instead of registering a second worker. */
+    workerFile?: string;
+    /** Existing apps may already register their notification worker. */
+    register?: boolean;
+}
+/** Vite/Rollup build hook; never registers a worker on the development server. */
+export declare function offlineShellPlugin(options?: Omit<OfflineShellBuildOptions, "directory" | "base">): {
+    name: string;
+    apply: "build";
+    configResolved(config: {
+        root: string;
+        base: string;
+        build: {
+            outDir: string;
+        };
+    }): void;
+    closeBundle(): Promise<void>;
+};
+/** Run after static routes/assets are generated, before publishing the directory.
+ * Only shipped public files enter the cache, never runtime-fetched user data. */
+export declare function buildOfflineShell(options: OfflineShellBuildOptions): Promise<OfflineShellManifest>;

package/dist/offline-shell-build.js

@@ -0,0 +1,78 @@
+/** Node-only build adapter for the shared public app-shell service worker. */
+import { createHash } from "node:crypto";
+import { readdir, readFile, writeFile } from "node:fs/promises";
+import { join, resolve } from "node:path";
+/** Vite/Rollup build hook; never registers a worker on the development server. */
+export function offlineShellPlugin(options = {}) {
+    let directory;
+    let base;
+    return {
+        name: "mdbase-offline-shell",
+        apply: "build",
+        configResolved(config) {
+            directory = resolve(config.root, config.build.outDir);
+            base = config.base;
+        },
+        async closeBundle() {
+            await buildOfflineShell({ ...options, directory, base });
+        },
+    };
+}
+const marker = "\n// mdbase shared offline shell\n";
+const registrationFile = "mdbase-shell-register.js";
+const runtimeFile = "mdbase-shell-runtime.js";
+const hash = (bytes) => createHash("sha256").update(bytes).digest("hex");
+/** Run after static routes/assets are generated, before publishing the directory.
+ * Only shipped public files enter the cache, never runtime-fetched user data. */
+export async function buildOfflineShell(options) {
+    const directory = resolve(options.directory);
+    const base = options.base ?? "/";
+    const workerFile = options.workerFile ?? "mdbase-shell-sw.js";
+    if (!/^\/(?:[a-zA-Z0-9_-]+\/)*$/.test(base) || !/^[a-zA-Z0-9_-]+\.js$/.test(workerFile)) {
+        throw new Error("Offline shell needs an absolute app base and a root worker filename");
+    }
+    const runtime = await readFile(new URL("./offline-shell-worker.js", import.meta.url), "utf8");
+    await writeFile(join(directory, runtimeFile), runtime.replace(/\n\/\/# sourceMappingURL=.*$/m, ""));
+    if (options.register !== false) {
+        await writeFile(join(directory, registrationFile), `if ("serviceWorker" in navigator) navigator.serviceWorker.register(${JSON.stringify(base + workerFile)}, {scope:${JSON.stringify(base)},type:"module"}).catch(() => console.warn("Offline app support could not start."));\n`);
+    }
+    const paths = [];
+    async function walk(path) {
+        for (const entry of await readdir(join(directory, path), { withFileTypes: true })) {
+            if (entry.name.startsWith(".") || entry.name.startsWith("_"))
+                continue;
+            const relative = path ? `${path}/${entry.name}` : entry.name;
+            if (entry.isDirectory())
+                await walk(relative);
+            else if (entry.isFile() && relative !== workerFile && /\.(?:html|js|mjs|css|wasm|woff2?|ttf|svg|png|webp|jpg|jpeg|ico|json|webmanifest)$/.test(relative))
+                paths.push(relative);
+        }
+    }
+    await walk("");
+    paths.sort();
+    if (!paths.includes("index.html"))
+        throw new Error("Offline shell needs index.html");
+    const assets = [];
+    for (const path of paths) {
+        if (path.endsWith(".html") && options.register !== false) {
+            const file = join(directory, path);
+            let html = await readFile(file, "utf8");
+            const tag = `<script type="module" src="${base}${registrationFile}"></script>`;
+            if (!html.includes(tag)) {
+                if (!html.includes("</head>"))
+                    throw new Error("Offline shell HTML needs a head element");
+                html = html.replace("</head>", `${tag}\n</head>`);
+                await writeFile(file, html);
+            }
+        }
+        assets.push({ path, sha256: hash(await readFile(join(directory, path))) });
+    }
+    let existing = options.workerFile ? await readFile(join(directory, workerFile), "utf8") : "";
+    existing = existing.split(marker)[0];
+    // Include worker code as well: notification-only changes still rotate the release cache.
+    const version = hash(JSON.stringify({ base, assets, existing }));
+    const manifest = { base, version, assets };
+    await writeFile(join(directory, workerFile), `${existing}${marker}import {installOfflineShell} from "./${runtimeFile}";\ninstallOfflineShell(self, ${JSON.stringify(manifest)});\n`);
+    return manifest;
+}
+//# sourceMappingURL=offline-shell-build.js.map

package/dist/offline-shell-build.js.map

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

package/dist/offline-shell-worker.d.ts

@@ -0,0 +1,46 @@
+/** Public, build-pinned app assets only. Collection/auth traffic is never cached here. */
+export interface OfflineShellManifest {
+    base: string;
+    version: string;
+    assets: {
+        path: string;
+        sha256: string;
+    }[];
+}
+interface ShellEvent {
+    waitUntil(promise: Promise<unknown>): void;
+}
+interface ShellFetchEvent extends ShellEvent {
+    request: Request;
+    clientId?: string;
+    resultingClientId?: string;
+    respondWith(response: Promise<Response>): void;
+}
+interface ShellClient {
+    id: string;
+    url: string;
+}
+interface ShellMessageEvent extends ShellEvent {
+    data: unknown;
+    source: ShellClient | null;
+}
+interface ShellWorker {
+    location: {
+        origin: string;
+    };
+    clients: {
+        claim(): Promise<void>;
+        matchAll(options: {
+            type: "window";
+            includeUncontrolled: boolean;
+        }): Promise<readonly ShellClient[]>;
+    };
+    skipWaiting(): Promise<void>;
+    addEventListener(type: "message", listener: (event: ShellMessageEvent) => void): void;
+    addEventListener(type: "install" | "activate", listener: (event: ShellEvent) => void): void;
+    addEventListener(type: "fetch", listener: (event: ShellFetchEvent) => void): void;
+}
+/** Installs the same shell policy in generated workers and app notification workers.
+ * Activation is explicit. Older tabs keep their pinned assets until they leave. */
+export declare function installOfflineShell(worker: ShellWorker, manifest: OfflineShellManifest): void;
+export {};

package/dist/offline-shell-worker.js

@@ -0,0 +1,115 @@
+/** Installs the same shell policy in generated workers and app notification workers.
+ * Activation is explicit. Older tabs keep their pinned assets until they leave. */
+export function installOfflineShell(worker, manifest) {
+    const prefix = `mdbase-shell:${manifest.base}:`;
+    const name = `${prefix}${manifest.version}`;
+    const root = new URL(manifest.base, worker.location.origin);
+    const index = new URL("index.html", root).href;
+    const assets = new Map(manifest.assets.map(asset => [new URL(asset.path, root).href, asset.sha256]));
+    let acceptingClient;
+    const otherClients = async (except) => (await worker.clients.matchAll({ type: "window", includeUncontrolled: true }))
+        .some(client => client.url.startsWith(root.href) && !except.includes(client.id));
+    const clean = async () => {
+        for (const key of await caches.keys())
+            if (key.startsWith(prefix) && key !== name)
+                await caches.delete(key);
+    };
+    worker.addEventListener("message", event => {
+        if (!event.data || typeof event.data !== "object" || event.data.type !== "mdbase-shell:activate")
+            return;
+        if (!event.source?.url.startsWith(root.href))
+            return;
+        acceptingClient = event.source.id;
+        event.waitUntil(worker.skipWaiting());
+    });
+    worker.addEventListener("install", event => {
+        event.waitUntil((async () => {
+            const cache = await caches.open(name);
+            try {
+                // Sequential fetches bound peak memory for the native WASM assets.
+                for (const [url, expected] of assets) {
+                    const options = { cache: "reload", credentials: "omit", redirect: "error" };
+                    let response;
+                    try {
+                        response = await fetch(url, options);
+                    }
+                    catch (error) {
+                        const canonical = new URL(url);
+                        if (!canonical.pathname.endsWith(".html"))
+                            throw error;
+                        // Pages and similar hosts redirect HTML filenames to clean URLs. Try
+                        // that one public path directly; never follow arbitrary redirects.
+                        canonical.pathname = canonical.pathname.endsWith("/index.html")
+                            ? canonical.pathname.slice(0, -"index.html".length)
+                            : canonical.pathname.slice(0, -".html".length);
+                        response = await fetch(canonical.href, options);
+                    }
+                    if (!response.ok)
+                        throw new Error("Offline shell asset unavailable");
+                    const bytes = await response.clone().arrayBuffer();
+                    const hash = new Uint8Array(await crypto.subtle.digest("SHA-256", bytes));
+                    const actual = Array.from(hash, byte => byte.toString(16).padStart(2, "0")).join("");
+                    if (actual !== expected)
+                        throw new Error("Offline shell asset changed during deployment");
+                    await cache.put(url, response);
+                }
+            }
+            catch (error) {
+                await caches.delete(name);
+                throw error;
+            }
+        })());
+    });
+    worker.addEventListener("activate", event => {
+        event.waitUntil((async () => {
+            if (!await otherClients([acceptingClient]))
+                await clean();
+            await worker.clients.claim();
+        })());
+    });
+    worker.addEventListener("fetch", event => {
+        const request = event.request;
+        if (request.method !== "GET")
+            return;
+        const url = new URL(request.url);
+        if (url.origin !== root.origin || !url.pathname.startsWith(root.pathname))
+            return;
+        // Exact URLs only: query-bearing auth/callback traffic must never be cached.
+        if (assets.has(url.href)) {
+            event.respondWith((async () => {
+                const cache = await caches.open(name);
+                return await cache.match(url.href) ?? fetch(request);
+            })());
+        }
+        else if (!url.search && ["script", "style", "font", "image", "worker"].includes(request.destination)) {
+            // A controller replacement must not strand another tab's lazy imports.
+            event.respondWith((async () => {
+                for (const key of await caches.keys()) {
+                    if (!key.startsWith(prefix))
+                        continue;
+                    const cached = await (await caches.open(key)).match(url.href);
+                    if (cached)
+                        return cached;
+                }
+                return fetch(request);
+            })());
+        }
+        else if (request.mode === "navigate") {
+            event.respondWith((async () => {
+                try {
+                    return await fetch(request);
+                }
+                catch {
+                    const cache = await caches.open(name);
+                    const shell = await cache.match(index);
+                    if (shell && !await otherClients([event.clientId, event.resultingClientId]))
+                        await clean();
+                    return shell ?? new Response("The app is not available offline yet. Reconnect and try again.", {
+                        status: 503, headers: { "Content-Type": "text/plain; charset=utf-8" },
+                    });
+                }
+            })());
+        }
+    });
+}
+//# sourceMappingURL=offline-shell-worker.js.map

package/dist/offline-shell-worker.js.map

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

package/dist/people.d.ts

@@ -0,0 +1,82 @@
+/** Account metadata plus canonical native mdbase.person projections. */
+import type { MdbaseClient } from "./client.js";
+import type { Session } from "./session.js";
+export declare const PERSON_CONTRACT: Readonly<{
+    id: "mdbase.person";
+    version: "2.0.0";
+}>;
+export interface AccountIdentity {
+    issuer: string;
+    subject: string;
+}
+export interface AccountProfile extends AccountIdentity {
+    name: string;
+    accountId?: string;
+}
+export interface CurrentAccount extends AccountProfile {
+    personSettingsUrl?: string;
+}
+export interface CollectionMemberProfile extends AccountProfile {
+    role: "owner" | "editor" | "viewer";
+}
+export interface PersonRecord {
+    id: string;
+    path: string;
+    name: string;
+    identities: AccountIdentity[];
+    typeNames: string[];
+}
+export interface InvalidPersonRecord {
+    id: string;
+    path: string;
+    reason: string;
+}
+export type PersonResolution = {
+    status: "linked";
+    person: PersonRecord;
+} | {
+    status: "unlinked";
+} | {
+    status: "ambiguous" | "invalid";
+    paths: string[];
+};
+export interface PeopleDirectory {
+    account: CurrentAccount;
+    me: PersonResolution;
+    people: PersonRecord[];
+    invalid: InvalidPersonRecord[];
+    /** Missing only when omitted or that specific optional permission was declined. */
+    members?: CollectionMemberProfile[];
+}
+export interface PeopleRequestOptions {
+    signal?: AbortSignal;
+}
+export interface PeopleDirectoryOptions extends PeopleRequestOptions {
+    members?: "require" | "if-approved" | "omit";
+}
+/** Pinned metadata authority, separate from the native record-read capability. */
+/** The records client people reads go through (an `MdbaseClient`). */
+export interface PeopleRecords {
+    queryContract: MdbaseClient["queryContract"];
+    readyForRead(signal?: AbortSignal): Promise<Session>;
+    currentSession(): Session;
+}
+export interface PeopleAuthority {
+    /** Immutable collection UUID pinned by this metadata authority. */
+    readonly collection: string;
+    request(resource: "identity" | "members", options?: PeopleRequestOptions): Promise<unknown>;
+    isCurrent(): boolean;
+}
+export declare function sameIdentity(a: AccountIdentity, b: AccountIdentity): boolean;
+/** Complete directories only; cursor/scope failures never become partial success. */
+export declare class MdbasePeopleClient {
+    private readonly client;
+    private readonly authority;
+    constructor(client: PeopleRecords, authority: PeopleAuthority);
+    private check;
+    private checkReadSession;
+    current(options?: PeopleRequestOptions): Promise<CurrentAccount>;
+    members(options?: PeopleRequestOptions): Promise<CollectionMemberProfile[]>;
+    directory(options?: PeopleDirectoryOptions): Promise<PeopleDirectory>;
+    private records;
+}

package/dist/people.js

@@ -0,0 +1,199 @@
+import { uuidToBytes } from "./codec.js";
+import { mdbaseError, isMdbaseError } from "./errors.js";
+export const PERSON_CONTRACT = Object.freeze({ id: "mdbase.person", version: "2.0.0" });
+const responseError = () => mdbaseError("unavailable", "invalid people response", "people_response");
+function object(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        throw responseError();
+    return value;
+}
+function httpUrl(value) {
+    if (typeof value !== "string")
+        return false;
+    try {
+        const url = new URL(value);
+        return ["http:", "https:"].includes(url.protocol) && !url.username && !url.password;
+    }
+    catch {
+        return false;
+    }
+}
+function profile(value) {
+    const row = object(value);
+    if (!httpUrl(row.issuer) || typeof row.subject !== "string" || !row.subject.trim() || typeof row.name !== "string" || !row.name.trim())
+        throw responseError();
+    const accountId = row.account_id;
+    if (accountId !== undefined) {
+        if (typeof accountId !== "string")
+            throw responseError();
+        try {
+            if (uuidToBytes(accountId).every(b => b === 0))
+                throw responseError();
+        }
+        catch {
+            throw responseError();
+        }
+    }
+    return { issuer: row.issuer, subject: row.subject, name: row.name, ...(accountId === undefined ? {} : { accountId: accountId }) };
+}
+export function sameIdentity(a, b) { return a.issuer === b.issuer && a.subject === b.subject; }
+function identities(value) {
+    if (!Array.isArray(value))
+        return [];
+    return value.flatMap(entry => {
+        if (!(entry instanceof Map))
+            return [];
+        const issuer = entry.get("issuer"), subject = entry.get("subject");
+        if (typeof issuer !== "string" || typeof subject !== "string")
+            return [];
+        return [{ issuer, subject }];
+    });
+}
+function inspect(projection) {
+    const data = projection.fields;
+    if (!(data instanceof Map))
+        throw responseError();
+    const name = data.get("name"), canonicalIdentities = data.get("identities");
+    const claims = identities(canonicalIdentities);
+    const error = projection.issues.find(issue => issue.severity === "error");
+    if (error)
+        return { reason: error.message, claims };
+    if (typeof name !== "string" || !name.trim())
+        return { reason: "It needs a non-blank name.", claims };
+    if (canonicalIdentities !== undefined && (!Array.isArray(canonicalIdentities) || claims.length !== canonicalIdentities.length || claims.some(claim => !claim.subject.trim())))
+        return { reason: "Each account identity needs an exact issuer and subject.", claims };
+    return { name, identities: claims, claims };
+}
+/** Complete directories only; cursor/scope failures never become partial success. */
+export class MdbasePeopleClient {
+    client;
+    authority;
+    constructor(client, authority) {
+        this.client = client;
+        this.authority = authority;
+    }
+    check(signal) {
+        signal?.throwIfAborted();
+        if (!this.authority.isCurrent())
+            throw mdbaseError("unauthenticated", "people scope changed", "people_fenced");
+    }
+    checkReadSession(session) {
+        if (session !== this.client.currentSession() || session.closed)
+            throw mdbaseError("unavailable", "people read session changed", "people_fenced");
+        const expected = uuidToBytes(this.authority.collection), actual = uuidToBytes(session.hello.collection);
+        if (expected.every(value => value === 0) || !expected.every((value, i) => value === actual[i]))
+            throw mdbaseError("unauthenticated", "people collection binding changed", "people_binding");
+    }
+    async current(options = {}) {
+        this.check(options.signal);
+        const body = await this.authority.request("identity", options);
+        this.check(options.signal);
+        const account = profile(body), settings = object(body).person_settings_url;
+        if (settings === undefined)
+            return account;
+        if (!httpUrl(settings))
+            throw responseError();
+        return { ...account, personSettingsUrl: settings };
+    }
+    async members(options = {}) {
+        this.check(options.signal);
+        const body = object(await this.authority.request("members", options));
+        this.check(options.signal);
+        if (!Array.isArray(body.members) || body.members.length > 1000)
+            throw responseError();
+        return body.members.map(value => {
+            const account = profile(value), role = object(value).role;
+            if (role !== "owner" && role !== "editor" && role !== "viewer")
+                throw responseError();
+            return { ...account, role };
+        });
+    }
+    async directory(options = {}) {
+        const { members: mode = "if-approved", ...request } = options;
+        if (!["require", "if-approved", "omit"].includes(mode))
+            throw mdbaseError("invalid_request", "invalid members mode");
+        this.check(request.signal);
+        // Metadata shares ONE original control slot. Sequence its two READs inside
+        // this existing engine, never queue in the proxy or introduce another cache.
+        // Native projections still run on the SAME client's independent data lane.
+        const metadata = async () => {
+            const account = await this.current(request);
+            this.check(request.signal);
+            const members = mode === "omit" ? undefined : await this.members(request).catch(error => {
+                if (mode === "if-approved" && isMdbaseError(error, "forbidden") && error.reason === "people_permission_declined")
+                    return undefined;
+                throw error;
+            });
+            this.check(request.signal);
+            return { account, members };
+        };
+        const [{ account, members }, records] = await Promise.all([metadata(), this.records(request)]);
+        this.check(request.signal);
+        this.checkReadSession(records.session);
+        const invalid = records.invalid.filter(row => row.claims.some(claim => sameIdentity(claim, account)));
+        const matches = records.people.filter(row => row.identities.some(claim => sameIdentity(claim, account)));
+        const match = matches[0];
+        const me = invalid.length ? { status: "invalid", paths: invalid.map(row => row.path) }
+            : matches.length > 1 ? { status: "ambiguous", paths: matches.map(row => row.path) }
+                : match ? { status: "linked", person: match } : { status: "unlinked" };
+        return { account, me, people: records.people, invalid: records.invalid.map(({ claims: _, ...row }) => row), ...(members === undefined ? {} : { members }) };
+    }
+    async records(options) {
+        const session = await this.client.readyForRead(options.signal);
+        this.check(options.signal);
+        this.checkReadSession(session);
+        let cursor, asOf, digest;
+        const seen = new Set(), cursors = new Set();
+        const people = [], invalid = [];
+        for (;;) {
+            this.check(options.signal);
+            const result = await this.client.queryContract(PERSON_CONTRACT, { pageSize: 128, ...(cursor ? { cursor } : {}), ...(options.signal ? { signal: options.signal } : {}) }).catch(error => {
+                // A fresh collection may have no registered Person2.0 contract. Never
+                // interpret disappearance after a page as a complete empty directory.
+                if (!cursor && !seen.size && isMdbaseError(error, "not_found") && error.reason === "data_contract_not_found")
+                    return null;
+                throw error;
+            });
+            this.check(options.signal);
+            this.checkReadSession(session);
+            if (!result)
+                return { people, invalid, session };
+            const { page } = result;
+            if (!page.complete)
+                throw mdbaseError("unavailable", "person inventory is incomplete", "people_incomplete");
+            if ((asOf !== undefined && asOf !== page.asOf) || (digest !== undefined && digest !== result.contractDigest))
+                throw responseError();
+            asOf = page.asOf;
+            digest = result.contractDigest;
+            for (const [i, row] of result.records.entries()) {
+                const record = page.records[i];
+                if (row.id !== record?.id || seen.has(row.id) || !row.implementations.length)
+                    throw responseError();
+                seen.add(row.id);
+                if (seen.size > 10000)
+                    throw mdbaseError("too_large", "person directory exceeds its record budget", "people_budget");
+                const projections = row.implementations.map(inspect), first = projections[0];
+                const reason = projections.find(value => "reason" in value);
+                const claims = projections.flatMap(value => value.claims);
+                if (reason && "reason" in reason)
+                    invalid.push({ id: row.id, path: record.path, reason: reason.reason, claims });
+                else if (projections.some(value => JSON.stringify(value) !== JSON.stringify(first)))
+                    invalid.push({ id: row.id, path: record.path, reason: "Its Person implementations project different values.", claims });
+                else if ("name" in first)
+                    people.push({ id: row.id, path: record.path, name: first.name, identities: first.identities, typeNames: [...new Set(row.implementations.map(value => value.typeName))].sort() });
+            }
+            if (!page.cursor) {
+                if (page.hasMore === true || (page.totalCount !== undefined && page.totalCount !== seen.size))
+                    throw mdbaseError("unavailable", "person inventory is incomplete", "people_incomplete");
+                break;
+            }
+            if (cursors.has(page.cursor))
+                throw responseError();
+            cursors.add(page.cursor);
+            cursor = page.cursor;
+        }
+        const byPath = (a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
+        return { people: people.sort(byPath), invalid: invalid.sort(byPath), session };
+    }
+}
+//# sourceMappingURL=people.js.map

package/dist/people.js.map

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

package/dist/presence.d.ts

@@ -0,0 +1,21 @@
+import type { MdbaseClient } from "./client.js";
+import { PlainValue } from "./values.js";
+import { Peer, Uuid } from "./wire.js";
+/** Presence state limit (§11). */
+export declare const MAX_PRESENCE_STATE = 4096;
+export declare class PresenceApi {
+    private client;
+    private joined;
+    private watchers;
+    private wired;
+    constructor(client: MdbaseClient);
+    private wire;
+    private params;
+    private check;
+    join(record: Uuid, state: PlainValue): Promise<void>;
+    /** Update state; calls faster than 10/s coalesce into the latest state. */
+    update(record: Uuid, state: PlainValue): void;
+    leave(record: Uuid): Promise<void>;
+    /** Watch the peers on a record. Returns an unsubscribe function. */
+    subscribe(record: Uuid, fn: (peers: Peer[]) => void): () => void;
+}