@meshline/sdk 0.0.0-stage → 0.1.0-alpha.1

package/dist/client.js

@@ -0,0 +1,162 @@
+import { createAbortController } from './runtime/abort.js';
+import { AccountManager } from './components/account.js';
+import { ChannelManager } from './components/channel.js';
+import { ClientComponent } from './components/component.js';
+import { DeviceManager } from './components/device.js';
+import { GroupManager } from './components/group.js';
+import { MessageManager } from './components/message.js';
+import { ProfileManager } from './components/profile.js';
+import { ClientAccountOperations } from './client/account-operations.js';
+import { ClientConversations } from './client/conversations.js';
+import { accountDeviceStateCodec } from './models/identity.js';
+import { AsyncGate } from './runtime/async-gate.js';
+import { AsyncPulse } from './runtime/async-pulse.js';
+import { EventHub } from './runtime/events.js';
+/** Owns six managers; the application retains ownership of the migrated store, pool, signer and protector. */
+export class MeshlineClient extends ClientComponent {
+    accountManager;
+    deviceManager;
+    profileManager;
+    messageManager;
+    channelManager;
+    groupManager;
+    #components;
+    #detach = [];
+    #accountGate = new AsyncGate();
+    #accountOperations;
+    #conversations;
+    #events = new EventHub();
+    #conversationLifetime = createAbortController();
+    #conversationPulse = new AsyncPulse();
+    #pendingConversations = new Set();
+    #conversationIds = new Set();
+    #conversationJob;
+    constructor(options) {
+        super(options);
+        this.accountManager = new AccountManager(options);
+        this.deviceManager = new DeviceManager({ ...options, accountManager: this.accountManager });
+        this.profileManager = new ProfileManager({ ...options, accountManager: this.accountManager, deviceSigner: this.deviceManager });
+        this.messageManager = new MessageManager({ ...options, accountManager: this.accountManager, deviceManager: this.deviceManager });
+        this.channelManager = new ChannelManager({ ...options, deviceManager: this.deviceManager });
+        this.groupManager = new GroupManager({ ...options, deviceManager: this.deviceManager, messageManager: this.messageManager });
+        this.#components = [this.accountManager, this.deviceManager, this.profileManager, this.messageManager, this.channelManager, this.groupManager];
+        for (const component of this.#components)
+            this.#detach.push(component.onLifecycle('backgroundError', error => this.notifyBackgroundError(error)));
+        this.#accountOperations = new ClientAccountOperations({ store: options.store, pool: options.relayClients, account: this.accountManager, device: this.deviceManager, profile: this.profileManager,
+            context: this.context, accountId: this.accountId, clock: this.clock, report: failure => this.notifyBackgroundError(failure) });
+        this.#conversations = new ClientConversations(options.store, this.accountId);
+        this.#detach.push(this.messageManager.on('messageReceived', messages => { for (const message of messages)
+            this.#queueConversation(message.key.sender === this.accountId ? message.recipient : message.key.sender); }), this.messageManager.on('sendStatusChanged', status => { if (status.state === 'queued')
+            this.#queueConversation(status.recipient); }), this.channelManager.on('timelineChanged', value => this.#queueConversation(value.channel.channelId)), this.channelManager.on('followChanged', value => this.#queueConversation(value.channel.channelId)), this.groupManager.on('timelineChanged', value => { if (value.message)
+            this.#queueConversation(value.group.groupId); }), this.groupManager.on('groupChanged', value => this.#queueConversation(value.ref.groupId)));
+    }
+    get route() { return this.accountManager.route; }
+    get device() { return this.deviceManager.local; }
+    get deviceState() { return this.deviceManager.deviceState; }
+    get profile() { return this.profileManager.profile; }
+    on(event, listener) { return this.#events.on(event, listener); }
+    getConversations(query = {}, signal) { const copy = { ...query, ...(query.kinds ? { kinds: [...query.kinds] } : {}) }; return this.runOperation(scope => this.#conversations.list(copy, scope), signal); }
+    getConversation(conversationId, signal) { return this.runOperation(scope => this.#conversations.get(conversationId, scope), signal); }
+    async markRead(conversationId, signal) { if (await this.runOperation(scope => this.#conversations.markRead(conversationId, scope), signal))
+        this.#queueConversation(conversationId); }
+    #queueConversation(id) { if (this.#conversationLifetime.signal.aborted)
+        return; this.#pendingConversations.add(id); this.#conversationPulse.pulse(); }
+    async #observeConversations() {
+        const signal = this.#conversationLifetime.signal;
+        try {
+            for (;;) {
+                await this.#conversationPulse.wait(signal);
+                const pending = [...this.#pendingConversations];
+                this.#pendingConversations.clear();
+                if (!pending.length)
+                    continue;
+                let present;
+                try {
+                    present = await this.#conversations.ids(signal);
+                }
+                catch (error) {
+                    if (signal.aborted)
+                        throw error;
+                    this.notifyBackgroundError({ operation: 'synchronize_conversations', error });
+                    for (const id of pending)
+                        this.#queueConversation(id);
+                    await this.clock.delay(1000, signal);
+                    continue;
+                }
+                for (const id of pending) {
+                    if (signal.aborted)
+                        return;
+                    const kind = present.has(id) ? this.#conversationIds.has(id) ? 'updated' : 'created' : this.#conversationIds.has(id) ? 'removed' : undefined;
+                    if (kind)
+                        this.#events.notify('conversationChanged', { conversationId: id, kind }, error => this.notifyBackgroundError({ operation: 'observer', resource: 'conversationChanged', error }));
+                }
+                // Preserve membership for other queued IDs until their own notification is processed.
+                const next = new Set(this.#conversationIds);
+                for (const id of pending) {
+                    if (present.has(id))
+                        next.add(id);
+                    else
+                        next.delete(id);
+                }
+                this.#conversationIds = next;
+            }
+        }
+        catch (error) {
+            if (!signal.aborted)
+                this.notifyBackgroundError({ operation: 'observe_conversations', error });
+        }
+    }
+    establishAccount(options = {}, signal) {
+        const copy = { ...options };
+        return this.runOperation(scope => this.#accountGate.run(() => this.#accountOperations.establish(copy, scope), scope), signal);
+    }
+    recoverAccount(options = {}, signal) {
+        const copy = { ...options, ...(options.previousDeviceState ? { previousDeviceState: accountDeviceStateCodec.decode(accountDeviceStateCodec.encode(options.previousDeviceState)) } : {}) };
+        return this.runOperation(scope => this.#accountGate.run(() => this.#accountOperations.recover(copy, scope), scope), signal);
+    }
+    changeHomeRelay(relayId, signal) { return this.runOperation(scope => this.#accountGate.run(() => this.#accountOperations.migrate(relayId, scope), scope), signal); }
+    async onInitialize(signal) {
+        for (const component of this.#components)
+            await component.initialize(signal);
+        this.#conversationIds = await this.#conversations.ids(signal);
+        this.#conversationJob ??= this.#observeConversations();
+    }
+    async onStart(signal) {
+        await this.accountManager.start(signal);
+        await this.#accountGate.run(() => this.#accountOperations.resumeMigration(signal), signal);
+        for (const component of this.#components.slice(1))
+            await component.start(signal);
+    }
+    async onStop() {
+        const errors = [];
+        for (const component of [...this.#components].reverse()) {
+            try {
+                await component.stop();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        if (errors.length)
+            throw new AggregateError(errors, 'One or more client components failed to stop.');
+    }
+    async onDispose() {
+        this.#conversationLifetime.abort();
+        await this.#conversationJob;
+        const errors = [];
+        for (const component of [...this.#components].reverse()) {
+            try {
+                await component.dispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+        }
+        for (const detach of this.#detach)
+            detach();
+        this.#events.clear();
+        if (errors.length)
+            throw new AggregateError(errors, 'One or more client components failed to dispose.');
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/components/account.d.ts

@@ -0,0 +1,38 @@
+import type { AccountSigner } from '../interactions.js';
+import { type AccountRoute } from '../models/identity.js';
+import { type EventListener } from '../runtime/events.js';
+import type { MeshlineStore } from '../storage/store.js';
+import type { RelayClientPool } from '../transport/pool.js';
+import { ClientComponent, type ClientOptions } from './component.js';
+export type AccountState = 'unknown' | 'notEstablished' | 'established';
+export interface AccountSnapshot {
+    readonly state: AccountState;
+    readonly route: AccountRoute | undefined;
+}
+export interface AccountEvents {
+    readonly accountChanged: AccountSnapshot;
+}
+export interface AccountManagerOptions extends ClientOptions {
+    readonly store: MeshlineStore;
+    readonly relayClients: RelayClientPool;
+    readonly accountSigner?: AccountSigner;
+}
+export interface PublishRouteOptions {
+    readonly validitySeconds: number;
+    readonly revision?: number;
+    readonly recovery?: boolean;
+    readonly signal?: AbortSignal;
+}
+/** Signed route discovery and durable, explicit publication retries. */
+export declare class AccountManager extends ClientComponent {
+    #private;
+    constructor(options: AccountManagerOptions);
+    get state(): AccountState;
+    get route(): AccountRoute | undefined;
+    on<K extends keyof AccountEvents>(event: K, listener: EventListener<AccountEvents[K]>): () => void;
+    protected onInitialize(signal: AbortSignal): Promise<void>;
+    getRoute(accountId?: string, signal?: AbortSignal): Promise<AccountRoute | undefined>;
+    publishRoute(relayId: string, options: PublishRouteOptions): Promise<AccountRoute>;
+    protected onDispose(): Promise<void>;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/components/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../../src/components/account.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAuF,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK/I,OAAO,EAAY,KAAK,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACpE,OAAO,KAAK,EAAE,aAAa,EAA4B,MAAM,qBAAqB,CAAC;AAGnF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAA0B,KAAK,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAE7F,MAAM,MAAM,YAAY,GAAG,SAAS,GAAG,gBAAgB,GAAG,aAAa,CAAC;AACxE,MAAM,WAAW,eAAe;IAAG,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,SAAS,CAAA;CAAE;AAC3G,MAAM,WAAW,aAAa;IAAG,QAAQ,CAAC,cAAc,EAAE,eAAe,CAAA;CAAE;AAC3E,MAAM,WAAW,qBAAsB,SAAQ,aAAa;IAAG,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,YAAY,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAA;CAAE;AAC9K,MAAM,WAAW,mBAAmB;IAAG,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE;AAMjK,wEAAwE;AACxE,qBAAa,cAAe,SAAQ,eAAe;;IAS/C,YAAY,OAAO,EAAE,qBAAqB,EAKzC;IACD,IAAI,KAAK,IAAI,YAAY,CAAwB;IACjD,IAAI,KAAK,IAAI,YAAY,GAAG,SAAS,CAA8C;IACnF,EAAE,CAAC,CAAC,SAAS,MAAM,aAAa,EAAE,KAAK,EAAE,CAAC,EAAE,QAAQ,EAAE,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI,CAA6C;IAC/I,UAAyB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CASxE;IASK,QAAQ,CAAC,SAAS,SAAiB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC,CAiBlG;IAgCK,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CA8BvF;IA8DD,UAAyB,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAA0B;CAChF"}

package/dist/components/account.js

@@ -0,0 +1,243 @@
+import { ProtocolError, StateConflictError } from '../errors.js';
+import { matchesAccount, validateAccountId, validateRelayId, verifyRelay } from '../identity/neo.js';
+import { accountRouteCodec, compareRoutes, routeAccountInput, routeRelayInput, validateRoute } from '../models/identity.js';
+import { nextRevision } from '../protocol/context.js';
+import { canonicalJson, requireSafeInteger } from '../protocol/json.js';
+import { AsyncGate } from '../runtime/async-gate.js';
+import { throwIfAborted } from '../runtime/clock.js';
+import { EventHub } from '../runtime/events.js';
+import { finishSignedRequest, putSignedRequest, readSignedRequest, requestKey } from '../storage/signed-request.js';
+import { updateStore } from '../storage/transaction.js';
+import { RelayError } from '../transport/relay-error.js';
+import { ClientComponent } from './component.js';
+const method = 'account.route.publish';
+const routeKey = (account) => ({ collection: 'account_routes', key: account });
+const clone = (route) => accountRouteCodec.decode(accountRouteCodec.encode(route));
+const fingerprint = (value) => canonicalJson(value ?? null);
+/** Signed route discovery and durable, explicit publication retries. */
+export class AccountManager extends ClientComponent {
+    #store;
+    #pool;
+    #signer;
+    #gate = new AsyncGate();
+    #events = new EventHub();
+    #state = 'unknown';
+    #route;
+    constructor(options) {
+        super(options);
+        if (options.relayClients.accountId !== this.accountId || options.relayClients.context.toString() !== this.context.toString())
+            throw new ProtocolError('invalid_context', 'Relay pool belongs to another account or network.');
+        this.#store = options.store;
+        this.#pool = options.relayClients;
+        this.#signer = options.accountSigner;
+    }
+    get state() { return this.#state; }
+    get route() { return this.#route && clone(this.#route); }
+    on(event, listener) { return this.#events.on(event, listener); }
+    async onInitialize(signal) {
+        await this.#store.initialize({ context: this.context.toString(), accountId: this.accountId }, signal);
+        const value = (await this.#store.read([routeKey(this.accountId)], signal)).sets[0][0]?.value;
+        const route = value === undefined ? undefined : accountRouteCodec.decode(value);
+        if (route) {
+            validateRoute(route, this.context, 0);
+            if (route.account !== this.accountId)
+                throw new ProtocolError('invalid_storage', 'Stored route belongs to another account.');
+        }
+        this.#route = route;
+        this.#state = route && route.expiresAt > this.clock.nowSeconds() ? 'established' : 'unknown';
+    }
+    #accept(route) {
+        const state = route ? 'established' : 'unknown';
+        const changed = this.#state !== state || route !== undefined && accountRouteCodec.stringify(route) !== (this.#route && accountRouteCodec.stringify(this.#route));
+        this.#state = state;
+        if (route)
+            this.#route = clone(route);
+        return changed;
+    }
+    #changed() { this.#events.notify('accountChanged', { state: this.state, route: this.route }, error => this.notifyBackgroundError({ operation: 'observer', resource: 'accountChanged', error })); }
+    async getRoute(accountId = this.accountId, signal) {
+        validateAccountId(accountId);
+        const failures = [];
+        let changed = false;
+        let route;
+        let operationError;
+        let failed = false;
+        try {
+            route = await this.runOperation(scope => this.#gate.run(async () => {
+                const resolved = await this.#resolve(accountId, failures, scope);
+                if (accountId === this.accountId)
+                    changed = this.#accept(resolved);
+                return resolved;
+            }, scope), signal);
+        }
+        catch (error) {
+            failed = true;
+            operationError = error;
+        }
+        for (const failure of failures)
+            this.notifyBackgroundError(failure);
+        if (changed)
+            this.#changed();
+        if (failed)
+            throw operationError;
+        return route && clone(route);
+    }
+    async #resolve(accountId, failures, signal) {
+        const previous = (await this.#store.read([routeKey(accountId)], signal)).sets[0][0]?.value;
+        const known = previous === undefined ? undefined : accountRouteCodec.decode(previous);
+        let attempted = false;
+        for await (const entry of this.#pool.registry.getRelays(signal)) {
+            throwIfAborted(signal);
+            if (entry.status !== 'active')
+                continue;
+            attempted = true;
+            let route;
+            try {
+                const client = await this.#pool.get(entry.relayId, undefined, signal);
+                const response = await client.requestHttp('GET', 'account.route.resolve', { account: accountId }, { authenticated: false, signal });
+                if (response === undefined)
+                    throw new ProtocolError('invalid_response', 'Route resolution returned no document.');
+                route = accountRouteCodec.decode(response);
+                if (route.account !== accountId)
+                    throw new ProtocolError('invalid_identity', 'Resolved route belongs to another account.');
+                if (known && route.revision < known.revision)
+                    throw new ProtocolError('stale_route', 'Relay returned an older route.');
+                await this.#verifyRelay(route, signal);
+            }
+            catch (error) {
+                throwIfAborted(signal);
+                if (error instanceof RelayError) {
+                    if (error.code === 'not_found')
+                        continue;
+                    if (!['temporarily_unavailable', 'bad_gateway', 'rate_limited'].includes(error.code))
+                        throw error;
+                }
+                else if (!(error instanceof Error))
+                    throw error;
+                failures.push({ operation: 'connect', resource: entry.relayId, error });
+                continue;
+            }
+            await this.#save(route, signal);
+            return route;
+        }
+        if (failures.length)
+            throw new AggregateError(failures.map(value => value.error), 'Account route discovery failed through the available relays.');
+        if (!attempted)
+            throw new ProtocolError('no_active_relay', 'No active relay is available for route discovery.');
+        return undefined;
+    }
+    async publishRoute(relayId, options) {
+        options = { ...options };
+        validateRelayId(relayId);
+        requireSafeInteger(options.validitySeconds, 1);
+        if (options.validitySeconds > 3650 * 86400)
+            throw new RangeError('Route validity cannot exceed 3650 days.');
+        if (options.revision !== undefined)
+            requireSafeInteger(options.revision, 0);
+        const signer = this.#signer;
+        if (!signer)
+            throw new ProtocolError('signer_required', 'An account signer is required to publish a route.');
+        let changed = false;
+        const result = await this.runOperation(signal => this.#gate.run(async () => {
+            const signed = await this.#prepare(relayId, options, signer, signal);
+            const request = accountRouteCodec.decode(signed.document);
+            const client = await this.#pool.get(relayId, { mode: 'account', signer }, signal);
+            let response;
+            try {
+                response = await client.requestHttp('PUT', method, signed.document, { signal });
+            }
+            catch (error) {
+                if (error instanceof RelayError && error.isDefinitiveRejection) {
+                    try {
+                        await finishSignedRequest(this.#store, method, signed);
+                    }
+                    catch (storageError) {
+                        throw new AggregateError([error, storageError], 'Relay rejected publication but its durable result could not be saved.');
+                    }
+                }
+                throw error;
+            }
+            if (response === undefined)
+                throw new ProtocolError('invalid_response', 'Route publication returned no acknowledgement.');
+            const route = accountRouteCodec.decode(response);
+            const acknowledged = accountRouteCodec.encode(route);
+            delete acknowledged.relay_signature;
+            if (canonicalJson(acknowledged) !== accountRouteCodec.stringify(request))
+                throw new ProtocolError('invalid_response', 'Relay modified the submitted route.');
+            await this.#verifyRelay(route, signal);
+            await this.#save(route, signal);
+            changed = this.#accept(route);
+            return route;
+        }, signal), options.signal);
+        if (changed)
+            this.#changed();
+        return clone(result);
+    }
+    async #prepare(relayId, options, signer, signal) {
+        const queries = [routeKey(this.accountId), requestKey(method)];
+        const snapshot = await this.#store.read(queries, signal);
+        const previous = snapshot.sets[0][0]?.value;
+        const saved = snapshot.sets[1][0]?.value;
+        const known = previous === undefined ? undefined : accountRouteCodec.decode(previous);
+        const signed = readSignedRequest(saved);
+        const knownRevision = Math.max(known?.revision ?? -1, signed?.revision ?? -1);
+        const pending = signed?.pending ? accountRouteCodec.decode(signed.document) : undefined;
+        const now = this.clock.nowSeconds();
+        requireSafeInteger(now, 0);
+        let revision = options.revision;
+        if (options.recovery && revision === undefined && (!pending || signed.relayId !== relayId || pending.expiresAt <= now))
+            revision = Math.max(nextRevision(knownRevision), now * 1000);
+        else if (revision === undefined && pending && signed.relayId === relayId && pending.expiresAt <= now)
+            revision = nextRevision(knownRevision);
+        if (signed?.pending && (revision === undefined || revision === signed.revision)) {
+            const route = pending;
+            validateRoute(route, this.context, now);
+            if (route.account !== this.accountId || signed.relayId !== relayId || route.relayId !== relayId || route.revision !== signed.revision
+                || route.expiresAt - route.updatedAt !== options.validitySeconds)
+                throw new StateConflictError('A route publication has an unknown result. Retry the original publication or resolve it first.');
+            return signed;
+        }
+        const publicKey = signer.publicKey.slice();
+        if (signer.accountId !== this.accountId || !matchesAccount(this.accountId, publicKey))
+            throw new ProtocolError('invalid_identity', 'Account signer identity changed.');
+        let request = { account: this.accountId, accountPublicKey: publicKey, relayId, revision: nextRevision(knownRevision, revision),
+            updatedAt: now, expiresAt: now + options.validitySeconds, accountSignature: new Uint8Array(64) };
+        requireSafeInteger(request.expiresAt, 0);
+        request = { ...request, accountSignature: (await signer.sign(routeAccountInput(request, this.context), signal)).slice() };
+        validateRoute(request, this.context, this.clock.nowSeconds());
+        const prepared = { relayId, revision: request.revision, document: accountRouteCodec.encode(request), pending: true };
+        await updateStore(this.#store, queries, current => {
+            if (fingerprint(current.sets[0][0]?.value) !== fingerprint(previous) || fingerprint(current.sets[1][0]?.value) !== fingerprint(saved))
+                throw new StateConflictError('The route changed while it was being signed. Resolve current state before retrying.');
+            return { mutations: [putSignedRequest(method, prepared)], result: undefined };
+        }, signal);
+        return prepared;
+    }
+    async #verifyRelay(route, signal) {
+        validateRoute(route, this.context, this.clock.nowSeconds());
+        const client = await this.#pool.get(route.relayId, undefined, signal);
+        const descriptor = await client.getDescriptor(signal);
+        if (!route.relaySignature || !verifyRelay(route.relayId, descriptor.publicKey, routeRelayInput(route, this.context), route.relaySignature))
+            throw new ProtocolError('invalid_signature', 'Account route lacks a valid signature from its home relay.');
+    }
+    async #save(route, signal) {
+        await updateStore(this.#store, [routeKey(route.account), requestKey(method)], snapshot => {
+            const current = snapshot.sets[0][0]?.value;
+            if (current) {
+                const comparison = compareRoutes(route, accountRouteCodec.decode(current));
+                if (comparison === 'older' || comparison === 'conflict')
+                    throw new ProtocolError('stale_route', 'Returned route is older or conflicts at the same revision.');
+            }
+            const mutations = [{ kind: 'put', ...routeKey(route.account), value: accountRouteCodec.encode(route) }];
+            const signed = readSignedRequest(snapshot.sets[1][0]?.value);
+            if (signed?.pending) {
+                const request = accountRouteCodec.decode(signed.document);
+                if (request.account === route.account && ['equivalent', 'newer'].includes(compareRoutes(route, request)))
+                    mutations.push(putSignedRequest(method, { ...signed, pending: false }));
+            }
+            return { mutations, result: undefined };
+        }, signal);
+    }
+    async onDispose() { this.#events.clear(); }
+}
+//# sourceMappingURL=account.js.map

package/dist/components/account.js.map

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

package/dist/components/channel.d.ts

@@ -0,0 +1,78 @@
+import { type RandomSource } from '../crypto/primitives.js';
+import { type ChannelPostRef, type ChannelRef } from '../models/channels.js';
+import type { ContentReference, MessageBody } from '../models/content.js';
+import { type ChannelInfo, type ChannelPostChange, type ChannelPostInfo } from '../channels/repository.js';
+import { type EventListener } from '../runtime/events.js';
+import type { MeshlineStore, QueryReader } from '../storage/store.js';
+import type { RelayClientPool } from '../transport/pool.js';
+import type { DeviceManager } from './device.js';
+import { ClientComponent, type ClientOptions } from './component.js';
+export interface ChannelManagerOptions extends ClientOptions {
+    readonly store: MeshlineStore;
+    readonly relayClients: RelayClientPool;
+    readonly deviceManager: DeviceManager;
+    readonly random?: RandomSource;
+}
+export interface ChannelUpdate {
+    readonly name?: string;
+    readonly description?: string | null;
+    readonly moderators?: readonly string[] | null;
+}
+export interface ChannelPostDraft {
+    readonly body?: MessageBody;
+    readonly attachments?: readonly ContentReference[];
+}
+export interface ChannelPostUpdate {
+    readonly body?: MessageBody | null;
+    readonly attachments?: readonly ContentReference[] | null;
+}
+export interface ChannelHistoryRequest {
+    readonly cursor?: string;
+    readonly limit?: number;
+}
+export interface ChannelHistoryPage {
+    readonly items: readonly ChannelPostInfo[];
+    readonly nextCursor?: string;
+}
+export interface ChannelEvents {
+    readonly channelChanged: ChannelInfo;
+    readonly timelineChanged: {
+        readonly channel: ChannelRef;
+        readonly changes: readonly ChannelPostChange[];
+    };
+    readonly followChanged: {
+        readonly channel: ChannelRef;
+        readonly isFollowed: boolean;
+    };
+}
+/** Public channels with verified historical permissions, durable exact requests and explicit runtime ownership. */
+export declare class ChannelManager extends ClientComponent {
+    #private;
+    constructor(options: ChannelManagerOptions);
+    on<K extends keyof ChannelEvents>(event: K, listener: EventListener<ChannelEvents[K]>): () => void;
+    protected onInitialize(signal: AbortSignal): Promise<void>;
+    createChannel(relayId: string, name: string, options?: {
+        readonly description?: string;
+        readonly moderators?: readonly string[];
+        readonly signal?: AbortSignal;
+    }): Promise<ChannelInfo>;
+    getChannel(channel: ChannelRef, signal?: AbortSignal): Promise<ChannelInfo>;
+    updateChannel(channel: ChannelRef, update: ChannelUpdate, signal?: AbortSignal): Promise<ChannelInfo>;
+    closeChannel(channel: ChannelRef, signal?: AbortSignal): Promise<void>;
+    publishPost(channel: ChannelRef, draft: ChannelPostDraft, signal?: AbortSignal): Promise<ChannelPostInfo>;
+    editPost(post: ChannelPostRef, update: ChannelPostUpdate, signal?: AbortSignal): Promise<ChannelPostInfo>;
+    deletePost(post: ChannelPostRef, signal?: AbortSignal): Promise<void>;
+    reportPost(post: ChannelPostRef, reason: string, signal?: AbortSignal): Promise<void>;
+    loadChannelHistory(channel: ChannelRef, page?: ChannelHistoryRequest, signal?: AbortSignal): Promise<ChannelHistoryPage>;
+    getPosts(query?: {
+        readonly channelId?: string;
+        readonly author?: string;
+    }, signal?: AbortSignal): Promise<QueryReader<ChannelPostInfo>>;
+    follow(channel: ChannelRef, signal?: AbortSignal): Promise<void>;
+    unfollow(channel: ChannelRef, signal?: AbortSignal): Promise<void>;
+    getFollowed(relayId?: string, signal?: AbortSignal): Promise<QueryReader<ChannelInfo>>;
+    protected onStart(): Promise<void>;
+    protected onStop(): Promise<void>;
+    protected onDispose(): Promise<void>;
+}
+//# sourceMappingURL=channel.d.ts.map

package/dist/components/channel.d.ts.map

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