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

package/dist/components/component.js

@@ -0,0 +1,194 @@
+import { createAbortController } from '../runtime/abort.js';
+import { ProtocolError } from '../errors.js';
+import { validateAccountId } from '../identity/neo.js';
+import { AsyncGate } from '../runtime/async-gate.js';
+import { abortScope, systemClock, throwIfAborted } from '../runtime/clock.js';
+import { EventHub } from '../runtime/events.js';
+/** Constructors do no I/O. The application owns shared stores, signers and relay pools. */
+export class ClientComponent {
+    #gate = new AsyncGate();
+    #lifetime = createAbortController();
+    #operations = new Set();
+    #events = new EventHub();
+    #runtime;
+    #state = 'uninitialized';
+    #disposing = false;
+    #disposal;
+    #backgroundFailure;
+    context;
+    accountId;
+    clock;
+    constructor(options) {
+        validateAccountId(options.accountId);
+        this.context = options.context;
+        this.accountId = options.accountId;
+        this.clock = options.clock ?? systemClock;
+    }
+    get lifecycleState() { return this.#state; }
+    get lastBackgroundError() { return this.#backgroundFailure; }
+    onLifecycle(event, listener) { return this.#events.on(event, listener); }
+    #stateChanged(previous, current) {
+        this.#events.notify('stateChanged', { previous, current }, error => this.notifyBackgroundError({ operation: 'observer', resource: 'stateChanged', error }));
+    }
+    get runtimeSignal() {
+        if (!this.#runtime)
+            throw new ProtocolError('not_running', 'The component has not started.');
+        return this.#runtime.signal;
+    }
+    #check() { if (this.#disposing)
+        throw new ProtocolError('disposed', 'The component is disposing or disposed.'); }
+    ensureInitialized() {
+        this.#check();
+        if (this.#state === 'uninitialized')
+            throw new ProtocolError('not_initialized', 'Initialize the component before using it.');
+    }
+    async initialize(signal) {
+        this.#check();
+        const scope = abortScope([signal, this.#lifetime.signal]);
+        let changed = false;
+        try {
+            await this.#gate.run(async () => {
+                this.#check();
+                if (this.#state !== 'uninitialized')
+                    return;
+                await this.onInitialize(scope.signal);
+                throwIfAborted(scope.signal);
+                this.#state = 'stopped';
+                changed = true;
+            }, scope.signal);
+        }
+        finally {
+            scope.dispose();
+        }
+        if (changed)
+            this.#stateChanged('uninitialized', 'stopped');
+    }
+    async start(signal) {
+        this.ensureInitialized();
+        const scope = abortScope([signal, this.#lifetime.signal]);
+        let changed = false;
+        try {
+            await this.#gate.run(async () => {
+                this.ensureInitialized();
+                if (this.#state === 'running')
+                    return;
+                this.#runtime = createAbortController();
+                try {
+                    await this.onStart(scope.signal);
+                    throwIfAborted(scope.signal);
+                }
+                catch (error) {
+                    try {
+                        await this.#endRuntime();
+                    }
+                    catch (cleanup) {
+                        throw new AggregateError([error, cleanup], 'Startup and cleanup failed.');
+                    }
+                    throw error;
+                }
+                this.#state = 'running';
+                changed = true;
+            }, scope.signal);
+        }
+        finally {
+            scope.dispose();
+        }
+        if (changed)
+            this.#stateChanged('stopped', 'running');
+    }
+    async stop(signal) {
+        this.#check();
+        let changed = false;
+        try {
+            await this.#gate.run(async () => {
+                this.#check();
+                if (this.#state !== 'running')
+                    return;
+                this.#state = 'stopping';
+                try {
+                    await this.#endRuntime();
+                }
+                finally {
+                    this.#state = 'stopped';
+                    changed = true;
+                }
+            }, signal);
+        }
+        finally {
+            if (changed)
+                this.#stateChanged('running', 'stopped');
+        }
+    }
+    async #endRuntime() {
+        if (!this.#runtime)
+            return;
+        this.#runtime.abort(new DOMException('Component runtime stopped.', 'AbortError'));
+        try {
+            await this.onStop();
+        }
+        finally {
+            this.#runtime = undefined;
+        }
+    }
+    /** Derived public operations use this scope; emit observer events after it releases. */
+    runOperation(action, signal) {
+        this.ensureInitialized();
+        throwIfAborted(signal);
+        const scope = abortScope([signal, this.#lifetime.signal]);
+        const job = Promise.resolve().then(() => { throwIfAborted(scope.signal); return action(scope.signal); });
+        this.#operations.add(job);
+        const released = () => { scope.dispose(); this.#operations.delete(job); };
+        job.then(released, released);
+        return job;
+    }
+    reportBackgroundError(failure) {
+        this.#backgroundFailure = Object.freeze({ ...failure });
+        this.#events.notify('backgroundError', failure, observerError => {
+            this.#backgroundFailure = Object.freeze({ ...failure, error: new AggregateError([failure.error, observerError], 'Background operation and error observer failed.') });
+        });
+        return Promise.resolve();
+    }
+    /** Runtime jobs must not wait for application handlers that can stop or dispose that same runtime. */
+    notifyBackgroundError(failure) {
+        void this.reportBackgroundError(failure);
+    }
+    dispose() {
+        if (this.#disposal)
+            return this.#disposal;
+        this.#disposing = true;
+        this.#lifetime.abort(new DOMException('Component disposed.', 'AbortError'));
+        this.#runtime?.abort(new DOMException('Component disposed.', 'AbortError'));
+        this.#disposal = this.#gate.run(async () => {
+            const previous = this.#state;
+            const errors = [];
+            try {
+                await this.#endRuntime();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            // Foreground failures belong to their callers; disposal only waits for cleanup.
+            await Promise.allSettled([...this.#operations]);
+            try {
+                await this.onDispose();
+            }
+            catch (error) {
+                errors.push(error);
+            }
+            this.#state = 'disposed';
+            return { previous, errors };
+        }).then(({ previous, errors }) => {
+            this.#stateChanged(previous, 'disposed');
+            this.#events.clear();
+            if (errors.length)
+                throw new AggregateError(errors, 'Component disposal failed.');
+        });
+        return this.#disposal;
+    }
+    async onInitialize(_signal) { }
+    /** Use runtimeSignal for background jobs; signal only controls startup. */
+    async onStart(_signal) { }
+    async onStop() { }
+    async onDispose() { }
+}
+//# sourceMappingURL=component.js.map

package/dist/components/component.js.map

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

package/dist/components/device.d.ts

@@ -0,0 +1,60 @@
+import { type RandomSource } from '../crypto/primitives.js';
+import type { AccountSigner, DeviceSigner, SecretProtector } from '../interactions.js';
+import { type DeviceStatePublishResponse } from '../models/device-state.js';
+import { type ContactAuthorization } from '../models/contacts.js';
+import { type AccountDeviceState, type DeviceCertificate } 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 type { AccountManager } from './account.js';
+import { ClientComponent, type ClientOptions } from './component.js';
+export type DeviceAuthorizationState = 'unknown' | 'notRegistered' | 'notYetValid' | 'expired' | 'authorized';
+export interface DeviceEvents {
+    readonly deviceChanged: string;
+    readonly deviceStateChanged: AccountDeviceState;
+}
+export interface DeviceManagerOptions extends ClientOptions {
+    readonly store: MeshlineStore;
+    readonly relayClients: RelayClientPool;
+    readonly accountManager: AccountManager;
+    readonly accountSigner?: AccountSigner;
+    readonly secretProtector?: SecretProtector;
+    readonly random?: RandomSource;
+}
+export interface PublishDeviceStateOptions {
+    readonly certificates?: readonly DeviceCertificate[];
+    readonly previousState?: AccountDeviceState;
+    readonly recovery?: boolean;
+    readonly revision?: number;
+    readonly signal?: AbortSignal;
+}
+export interface DeviceStatePublishResult extends DeviceStatePublishResponse {
+    readonly deviceState: AccountDeviceState;
+}
+/** Protected local device keys and explicit account-authorized device-state publication. */
+export declare class DeviceManager extends ClientComponent implements DeviceSigner {
+    #private;
+    readonly relayClients: RelayClientPool;
+    constructor(options: DeviceManagerOptions);
+    get local(): DeviceCertificate | undefined;
+    get deviceState(): AccountDeviceState | undefined;
+    get certificate(): DeviceCertificate;
+    on<K extends keyof DeviceEvents>(event: K, listener: EventListener<DeviceEvents[K]>): () => void;
+    protected onInitialize(signal: AbortSignal): Promise<void>;
+    createDevice(validitySeconds: number, signal?: AbortSignal): Promise<DeviceCertificate>;
+    renewDevice(validitySeconds: number, signal?: AbortSignal): Promise<DeviceCertificate>;
+    sign(input: Uint8Array, signal?: AbortSignal): Promise<Uint8Array>;
+    /** Caller owns and should erase the returned shared secret after deriving its purpose-specific key. */
+    deriveSharedSecret(peerPublicKey: Uint8Array, signal?: AbortSignal): Promise<Uint8Array>;
+    getCertificate(deviceId: string): DeviceCertificate | undefined;
+    getAuthorizationState(deviceId: string): DeviceAuthorizationState;
+    getDeviceState(target?: string | ContactAuthorization, signal?: AbortSignal): Promise<AccountDeviceState | undefined>;
+    getOwnDeviceState(relayId: string, signal?: AbortSignal): Promise<AccountDeviceState | undefined>;
+    publishDeviceState(relayId: string, options?: PublishDeviceStateOptions): Promise<DeviceStatePublishResult>;
+    /** Prevents removal of the last usable signature on a locally issued contact grant before replacement delivery acceptance. */
+    removeDevice(deviceId: string, signal?: AbortSignal): Promise<void>;
+    protected onStart(signal: AbortSignal): Promise<void>;
+    protected onStop(): Promise<void>;
+    protected onDispose(): Promise<void>;
+}
+//# sourceMappingURL=device.d.ts.map

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

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