signalk-wakelogger 0.2.0-beta.0

package/dist/outbox/factory.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOutbox = createOutbox;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const database_outbox_1 = require("./database-outbox");
+const file_outbox_1 = require("./file-outbox");
+async function createOutbox(app, dataDirectory, deviceId, options, expectedBackend) {
+    const root = node_path_1.default.join(dataDirectory, 'outbox');
+    const fileDirectory = node_path_1.default.join(root, deviceId);
+    const markerTarget = node_path_1.default.join(root, `${deviceId}.backend.json`);
+    const marker = await readMarker(markerTarget);
+    if (expectedBackend && marker?.backend !== expectedBackend) {
+        throw new Error('The bound outbox backend marker is missing or inconsistent; refusing an unsafe sequence reset');
+    }
+    let databaseApi;
+    try {
+        databaseApi = app.getDatabaseApi?.();
+    }
+    catch (error) {
+        if (marker?.backend === 'database')
+            throw error;
+        databaseApi = undefined;
+    }
+    if (marker?.backend === 'database') {
+        if (!databaseApi)
+            throw new Error('The selected Signal K Database API outbox is unavailable; refusing an unsafe sequence fallback');
+        const store = new database_outbox_1.DatabaseOutbox(await databaseApi.getPluginDb('signalk-wakelogger'), deviceId, options);
+        await store.open();
+        return { store, backend: 'database' };
+    }
+    const file = new file_outbox_1.FileOutbox(fileDirectory, options);
+    await file.open();
+    const fileStats = await file.stats();
+    if (!databaseApi || fileStats.messageCount > 0) {
+        await writeMarker(markerTarget, { version: 1, backend: 'file' });
+        return { store: file, backend: 'file' };
+    }
+    const seed = {
+        currentSequence: fileStats.currentSequence,
+        acknowledgedSequence: fileStats.acknowledgedSequence,
+        droppedCount: fileStats.droppedCount,
+        droppedThrough: fileStats.droppedThrough
+    };
+    let store;
+    try {
+        store = new database_outbox_1.DatabaseOutbox(await databaseApi.getPluginDb('signalk-wakelogger'), deviceId, options, seed);
+        await store.open();
+    }
+    catch {
+        await writeMarker(markerTarget, { version: 1, backend: 'file' });
+        return { store: file, backend: 'file' };
+    }
+    await file.close();
+    await writeMarker(markerTarget, { version: 1, backend: 'database' });
+    return { store, backend: 'database' };
+}
+async function readMarker(target) {
+    try {
+        const value = JSON.parse(await node_fs_1.promises.readFile(target, 'utf8'));
+        return value.version === 1 && (value.backend === 'file' || value.backend === 'database')
+            ? value
+            : undefined;
+    }
+    catch (error) {
+        if (error.code === 'ENOENT' || error instanceof SyntaxError)
+            return undefined;
+        throw error;
+    }
+}
+async function writeMarker(target, marker) {
+    await node_fs_1.promises.mkdir(node_path_1.default.dirname(target), { recursive: true, mode: 0o700 });
+    const temporary = `${target}.tmp`;
+    await node_fs_1.promises.writeFile(temporary, `${JSON.stringify(marker)}\n`, { mode: 0o600 });
+    const handle = await node_fs_1.promises.open(temporary, 'r+');
+    try {
+        await handle.sync();
+    }
+    finally {
+        await handle.close();
+    }
+    await node_fs_1.promises.rename(temporary, target);
+    // Windows does not support opening directories for fsync. The file flush and
+    // atomic rename above still provide the strongest portable guarantee there.
+    if (process.platform === 'win32')
+        return;
+    const directory = await node_fs_1.promises.open(node_path_1.default.dirname(target), 'r');
+    try {
+        await directory.sync();
+    }
+    finally {
+        await directory.close();
+    }
+}
+//# sourceMappingURL=factory.js.map

package/dist/outbox/factory.js.map

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

package/dist/outbox/file-outbox.d.ts

@@ -0,0 +1,27 @@
+import type { TelemetryDraft, TelemetrySample } from '../telemetry/types';
+import type { OutboxOptions, OutboxStats, OutboxStore } from './interface';
+export declare class FileOutbox implements OutboxStore {
+    private readonly directory;
+    private readonly options;
+    private metadata;
+    private opened;
+    private operation;
+    constructor(directory: string, options: OutboxOptions);
+    open(): Promise<void>;
+    append(deviceId: string, draft: TelemetryDraft): Promise<TelemetrySample>;
+    pending(limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    pendingAfter(sequence: number, limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    acknowledge(sequence: number): Promise<void>;
+    latest(): Promise<TelemetrySample | undefined>;
+    stats(): Promise<OutboxStats>;
+    close(): Promise<void>;
+    private enforceLimits;
+    private enforceLimitsUnlocked;
+    private reclaimAcknowledgedSegments;
+    private readMetadata;
+    private persistMetadata;
+    private readSegments;
+    private segmentNames;
+    private assertOpen;
+    private exclusive;
+}

package/dist/outbox/file-outbox.js

@@ -0,0 +1,280 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileOutbox = void 0;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const HEADER_BYTES = 4;
+const CHECKSUM_BYTES = 32;
+const META_FILE = 'metadata.json';
+const SEGMENT_PATTERN = /^segment-(\d{12})\.log$/;
+class FileOutbox {
+    directory;
+    options;
+    metadata = { version: 1, nextSequence: 1, acknowledgedSequence: 0, droppedCount: 0, droppedThrough: 0 };
+    opened = false;
+    operation = Promise.resolve();
+    constructor(directory, options) {
+        this.directory = directory;
+        this.options = options;
+    }
+    async open() {
+        await node_fs_1.promises.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        this.metadata = await this.readMetadata();
+        const segments = await this.readSegments(true);
+        const maximum = segments.flatMap((s) => s.records).reduce((value, r) => Math.max(value, r.sample.sequence), 0);
+        const accountedThrough = Math.max(maximum, this.metadata.acknowledgedSequence, this.metadata.droppedThrough);
+        if (this.metadata.nextSequence > accountedThrough + 1) {
+            this.metadata.droppedCount += this.metadata.nextSequence - accountedThrough - 1;
+            this.metadata.droppedThrough = this.metadata.nextSequence - 1;
+        }
+        this.metadata.nextSequence = Math.max(this.metadata.nextSequence, maximum + 1);
+        await this.persistMetadata();
+        this.opened = true;
+        await this.enforceLimits();
+    }
+    async append(deviceId, draft) {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            const sample = { v: 1, deviceId, sequence: this.metadata.nextSequence, ...draft };
+            const record = encodeRecord(sample);
+            const segments = await this.segmentNames();
+            let segment = segments.at(-1);
+            let rotated = false;
+            if (!segment || (await fileSize(node_path_1.default.join(this.directory, segment))) + record.length > this.options.segmentBytes) {
+                segment = segmentName(sample.sequence);
+                rotated = true;
+            }
+            const handle = await node_fs_1.promises.open(node_path_1.default.join(this.directory, segment), 'a', 0o600);
+            try {
+                await handle.write(record);
+                await handle.sync();
+            }
+            finally {
+                await handle.close();
+            }
+            this.metadata.nextSequence = sample.sequence + 1;
+            // Normal recovery derives nextSequence from the last checksummed record. Persist it
+            // only at segment boundaries to avoid a second fsync for every one-second sample.
+            if (rotated)
+                await this.persistMetadata();
+            await this.enforceLimitsUnlocked();
+            return sample;
+        });
+    }
+    async pending(limit, maxBytes) {
+        return this.pendingAfter(0, limit, maxBytes);
+    }
+    async pendingAfter(sequence, limit, maxBytes) {
+        return this.exclusive(async () => {
+            this.assertOpen();
+            const result = [];
+            let bytes = 0;
+            for (const segment of await this.readSegments(false)) {
+                for (const { sample } of segment.records) {
+                    if (sample.sequence <= Math.max(this.metadata.acknowledgedSequence, sequence))
+                        continue;
+                    const size = Buffer.byteLength(JSON.stringify(sample));
+                    if (result.length > 0 && (result.length >= limit || bytes + size > maxBytes))
+                        return result;
+                    result.push(sample);
+                    bytes += size;
+                }
+            }
+            return result;
+        });
+    }
+    async acknowledge(sequence) {
+        await this.exclusive(async () => {
+            this.assertOpen();
+            const maximum = this.metadata.nextSequence - 1;
+            if (!Number.isSafeInteger(sequence) || sequence <= this.metadata.acknowledgedSequence || sequence > maximum)
+                return;
+            this.metadata.acknowledgedSequence = sequence;
+            await this.persistMetadata();
+            await this.reclaimAcknowledgedSegments();
+        });
+    }
+    async latest() {
+        return this.exclusive(async () => {
+            const segments = await this.readSegments(false);
+            for (let index = segments.length - 1; index >= 0; index -= 1) {
+                const sample = segments[index]?.records.at(-1)?.sample;
+                if (sample)
+                    return sample;
+            }
+            return undefined;
+        });
+    }
+    async stats() {
+        return this.exclusive(async () => {
+            const segments = await this.readSegments(false);
+            const pending = segments.flatMap((segment) => segment.records)
+                .filter((record) => record.sample.sequence > this.metadata.acknowledgedSequence);
+            return {
+                storageBackend: 'file',
+                messageCount: pending.length,
+                diskBytes: segments.reduce((total, segment) => total + segment.bytes, 0),
+                oldestCapturedAt: pending[0]?.sample.capturedAt,
+                acknowledgedSequence: this.metadata.acknowledgedSequence,
+                currentSequence: this.metadata.nextSequence - 1,
+                droppedCount: this.metadata.droppedCount,
+                droppedThrough: this.metadata.droppedThrough
+            };
+        });
+    }
+    async close() {
+        await this.operation;
+        if (this.opened)
+            await this.persistMetadata();
+        this.opened = false;
+    }
+    async enforceLimits() {
+        await this.exclusive(() => this.enforceLimitsUnlocked());
+    }
+    async enforceLimitsUnlocked() {
+        const segments = await this.readSegments(false);
+        let total = segments.reduce((sum, segment) => sum + segment.bytes, 0);
+        const now = this.options.now?.() ?? Date.now();
+        const cutoff = now - this.options.maxAgeMs;
+        let metadataChanged = false;
+        for (let index = 0; index < segments.length - 1; index += 1) {
+            const segment = segments[index];
+            if (!segment)
+                continue;
+            const newest = segment.records.at(-1)?.sample;
+            const tooOld = newest !== undefined && newest.capturedAt < cutoff;
+            if (!tooOld && total <= this.options.maxBytes)
+                break;
+            const unacknowledged = segment.records.filter((record) => record.sample.sequence > this.metadata.acknowledgedSequence);
+            if (unacknowledged.length) {
+                this.metadata.droppedCount += unacknowledged.length;
+                this.metadata.droppedThrough = unacknowledged.at(-1)?.sample.sequence ?? this.metadata.droppedThrough;
+                metadataChanged = true;
+            }
+            await node_fs_1.promises.unlink(node_path_1.default.join(this.directory, segment.name)).catch(ignoreMissing);
+            total -= segment.bytes;
+        }
+        if (metadataChanged)
+            await this.persistMetadata();
+    }
+    async reclaimAcknowledgedSegments() {
+        const segments = await this.readSegments(false);
+        for (const segment of segments.slice(0, -1)) {
+            const lastSequence = segment.records.at(-1)?.sample.sequence ?? 0;
+            if (lastSequence > this.metadata.acknowledgedSequence)
+                break;
+            await node_fs_1.promises.unlink(node_path_1.default.join(this.directory, segment.name)).catch(ignoreMissing);
+        }
+    }
+    async readMetadata() {
+        try {
+            const value = JSON.parse(await node_fs_1.promises.readFile(node_path_1.default.join(this.directory, META_FILE), 'utf8'));
+            if (value.version === 1 && positiveInteger(value.nextSequence) && nonNegativeInteger(value.acknowledgedSequence)) {
+                return {
+                    version: 1,
+                    nextSequence: value.nextSequence,
+                    acknowledgedSequence: value.acknowledgedSequence,
+                    droppedCount: nonNegativeInteger(value.droppedCount) ? value.droppedCount : 0,
+                    droppedThrough: nonNegativeInteger(value.droppedThrough) ? value.droppedThrough : 0
+                };
+            }
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+        return { version: 1, nextSequence: 1, acknowledgedSequence: 0, droppedCount: 0, droppedThrough: 0 };
+    }
+    async persistMetadata() {
+        const target = node_path_1.default.join(this.directory, META_FILE);
+        const temporary = `${target}.tmp`;
+        await node_fs_1.promises.writeFile(temporary, `${JSON.stringify(this.metadata)}\n`, { mode: 0o600 });
+        const handle = await node_fs_1.promises.open(temporary, 'r+');
+        try {
+            await handle.sync();
+        }
+        finally {
+            await handle.close();
+        }
+        await node_fs_1.promises.rename(temporary, target);
+    }
+    async readSegments(repair) {
+        const result = [];
+        for (const name of await this.segmentNames()) {
+            const target = node_path_1.default.join(this.directory, name);
+            const data = await node_fs_1.promises.readFile(target);
+            const records = [];
+            let offset = 0;
+            while (offset + HEADER_BYTES + CHECKSUM_BYTES <= data.length) {
+                const length = data.readUInt32BE(offset);
+                const end = offset + HEADER_BYTES + length + CHECKSUM_BYTES;
+                if (length === 0 || length > this.options.segmentBytes || end > data.length)
+                    break;
+                const payload = data.subarray(offset + HEADER_BYTES, offset + HEADER_BYTES + length);
+                const expected = data.subarray(offset + HEADER_BYTES + length, end);
+                const actual = (0, node_crypto_1.createHash)('sha256').update(payload).digest();
+                if (!actual.equals(expected))
+                    break;
+                try {
+                    const sample = JSON.parse(payload.toString('utf8'));
+                    if (!validSample(sample))
+                        break;
+                    records.push({ sample, start: offset, end });
+                    offset = end;
+                }
+                catch {
+                    break;
+                }
+            }
+            if (repair && offset !== data.length)
+                await node_fs_1.promises.truncate(target, offset);
+            result.push({ name, records, bytes: repair ? offset : data.length });
+        }
+        return result;
+    }
+    async segmentNames() {
+        return (await node_fs_1.promises.readdir(this.directory)).filter((name) => SEGMENT_PATTERN.test(name)).sort();
+    }
+    assertOpen() {
+        if (!this.opened)
+            throw new Error('Outbox is not open');
+    }
+    exclusive(action) {
+        const result = this.operation.then(action, action);
+        this.operation = result.then(() => undefined, () => undefined);
+        return result;
+    }
+}
+exports.FileOutbox = FileOutbox;
+function encodeRecord(sample) {
+    const payload = Buffer.from(JSON.stringify(sample), 'utf8');
+    const result = Buffer.allocUnsafe(HEADER_BYTES + payload.length + CHECKSUM_BYTES);
+    result.writeUInt32BE(payload.length, 0);
+    payload.copy(result, HEADER_BYTES);
+    (0, node_crypto_1.createHash)('sha256').update(payload).digest().copy(result, HEADER_BYTES + payload.length);
+    return result;
+}
+function segmentName(sequence) { return `segment-${String(sequence).padStart(12, '0')}.log`; }
+function validSample(value) {
+    return value?.v === 1 && typeof value.deviceId === 'string' && positiveInteger(value.sequence) &&
+        Number.isFinite(value.capturedAt) && Number.isFinite(value.receivedAt) &&
+        Number.isFinite(value.values?.lat) && Number.isFinite(value.values?.lon);
+}
+function positiveInteger(value) { return Number.isSafeInteger(value) && value > 0; }
+function nonNegativeInteger(value) { return Number.isSafeInteger(value) && value >= 0; }
+function isMissing(error) { return error?.code === 'ENOENT'; }
+function ignoreMissing(error) { if (!isMissing(error))
+    throw error; }
+async function fileSize(target) { try {
+    return (await node_fs_1.promises.stat(target)).size;
+}
+catch (e) {
+    if (isMissing(e))
+        return 0;
+    throw e;
+} }
+//# sourceMappingURL=file-outbox.js.map

package/dist/outbox/file-outbox.js.map

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

package/dist/outbox/interface.d.ts

@@ -0,0 +1,33 @@
+import type { TelemetryDraft, TelemetrySample } from '../telemetry/types';
+export interface OutboxStats {
+    storageBackend: 'file' | 'database';
+    messageCount: number;
+    diskBytes: number;
+    oldestCapturedAt?: number;
+    acknowledgedSequence: number;
+    currentSequence: number;
+    droppedCount: number;
+    droppedThrough: number;
+}
+export interface OutboxSeed {
+    currentSequence: number;
+    acknowledgedSequence: number;
+    droppedCount: number;
+    droppedThrough: number;
+}
+export interface OutboxOptions {
+    maxBytes: number;
+    maxAgeMs: number;
+    segmentBytes: number;
+    now?: () => number;
+}
+export interface OutboxStore {
+    open(): Promise<void>;
+    append(deviceId: string, draft: TelemetryDraft): Promise<TelemetrySample>;
+    pending(limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    pendingAfter(sequence: number, limit: number, maxBytes: number): Promise<TelemetrySample[]>;
+    latest(): Promise<TelemetrySample | undefined>;
+    acknowledge(sequence: number): Promise<void>;
+    stats(): Promise<OutboxStats>;
+    close(): Promise<void>;
+}

package/dist/outbox/interface.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=interface.js.map

package/dist/outbox/interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.js","sourceRoot":"","sources":["../../src/outbox/interface.ts"],"names":[],"mappings":""}

package/dist/pairing/association-client.d.ts

@@ -0,0 +1,3 @@
+import type { DeviceCredentials } from './credentials';
+export type AssociationStatus = 'active' | 'revoked' | 'unknown';
+export declare function checkAssociationStatus(credentials: DeviceCredentials, signal?: AbortSignal): Promise<AssociationStatus>;

package/dist/pairing/association-client.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.checkAssociationStatus = checkAssociationStatus;
+async function checkAssociationStatus(credentials, signal) {
+    if (!credentials.associationStatusUrl || !credentials.associationToken)
+        return 'unknown';
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 10_000);
+    const abort = () => controller.abort();
+    signal?.addEventListener('abort', abort, { once: true });
+    try {
+        const response = await fetch(credentials.associationStatusUrl, {
+            headers: { accept: 'application/json', authorization: `Bearer ${credentials.associationToken}` },
+            signal: controller.signal
+        });
+        if (!response.ok)
+            return 'unknown';
+        const body = await response.json();
+        if (body.v !== 1 || body.device_id !== credentials.deviceId)
+            return 'unknown';
+        return body.status === 'revoked' ? 'revoked' : body.status === 'active' ? 'active' : 'unknown';
+    }
+    catch {
+        return 'unknown';
+    }
+    finally {
+        clearTimeout(timeout);
+        signal?.removeEventListener('abort', abort);
+    }
+}
+//# sourceMappingURL=association-client.js.map

package/dist/pairing/association-client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"association-client.js","sourceRoot":"","sources":["../../src/pairing/association-client.ts"],"names":[],"mappings":";;AAIA,wDAqBC;AArBM,KAAK,UAAU,sBAAsB,CAAC,WAA8B,EAAE,MAAoB;IAC/F,IAAI,CAAC,WAAW,CAAC,oBAAoB,IAAI,CAAC,WAAW,CAAC,gBAAgB;QAAE,OAAO,SAAS,CAAA;IACxF,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAA;IACxC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAA;IAC5D,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAA;IACtC,MAAM,EAAE,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAA;IACxD,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,WAAW,CAAC,oBAAoB,EAAE;YAC7D,OAAO,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,WAAW,CAAC,gBAAgB,EAAE,EAAE;YAChG,MAAM,EAAE,UAAU,CAAC,MAAM;SAC1B,CAAC,CAAA;QACF,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,OAAO,SAAS,CAAA;QAClC,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAA4D,CAAA;QAC5F,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,KAAK,WAAW,CAAC,QAAQ;YAAE,OAAO,SAAS,CAAA;QAC7E,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAA;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAA;IAClB,CAAC;YAAS,CAAC;QACT,YAAY,CAAC,OAAO,CAAC,CAAA;QACrB,MAAM,EAAE,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAA;IAC7C,CAAC;AACH,CAAC"}

package/dist/pairing/credentials.d.ts

@@ -0,0 +1,46 @@
+import { type TelemetryProfile } from '../telemetry/profile';
+export interface LegacyTelemetryProfile {
+    sample_period_ms?: number;
+    batch_size?: number;
+}
+export interface OutboxBinding {
+    version: 1;
+    backend: 'file' | 'database';
+    initializedAt: number;
+}
+export interface DeviceCredentials {
+    version: 1;
+    deviceId: string;
+    clientId: string;
+    username: string;
+    password: string;
+    mqttHost: string;
+    mqttPort: number;
+    tls: boolean;
+    pairedAt: number;
+    pairingCodeFingerprint?: string;
+    telemetryProfile?: TelemetryProfile | LegacyTelemetryProfile;
+    outboxBinding?: OutboxBinding;
+    associationStatusUrl?: string;
+    associationToken?: string;
+}
+export declare class CredentialStore {
+    private readonly directory;
+    private readonly credentialsFile;
+    private readonly identityFile;
+    private readonly pairingStateFile;
+    constructor(directory: string);
+    installationId(): Promise<string>;
+    load(): Promise<DeviceCredentials | undefined>;
+    save(credentials: DeviceCredentials): Promise<void>;
+    lastPairingCodeFingerprint(): Promise<string | undefined>;
+    forget(): Promise<{
+        forgotten: boolean;
+        deviceId?: string;
+    }>;
+    private loadPairingState;
+    private savePairingState;
+}
+export declare function validateCredentials(value: DeviceCredentials): boolean;
+export declare function fingerprintPairingCode(code: string): string;
+export declare function shouldExchangePairingCode(credentials: DeviceCredentials | undefined, code: string | undefined, lastFingerprint?: string): code is string;