signalk-wakelogger 0.2.0-beta.0

package/dist/pairing/credentials.js

@@ -0,0 +1,168 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CredentialStore = void 0;
+exports.validateCredentials = validateCredentials;
+exports.fingerprintPairingCode = fingerprintPairingCode;
+exports.shouldExchangePairingCode = shouldExchangePairingCode;
+const node_crypto_1 = require("node:crypto");
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const profile_1 = require("../telemetry/profile");
+class CredentialStore {
+    directory;
+    credentialsFile;
+    identityFile;
+    pairingStateFile;
+    constructor(directory) {
+        this.directory = directory;
+        this.credentialsFile = node_path_1.default.join(directory, 'credentials.json');
+        this.identityFile = node_path_1.default.join(directory, 'installation-id');
+        this.pairingStateFile = node_path_1.default.join(directory, 'pairing-state.json');
+    }
+    async installationId() {
+        await node_fs_1.promises.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        try {
+            const value = (await node_fs_1.promises.readFile(this.identityFile, 'utf8')).trim();
+            if (/^[0-9a-f-]{36}$/i.test(value))
+                return value;
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+        const value = (0, node_crypto_1.randomUUID)();
+        await atomicWrite(this.identityFile, `${value}\n`);
+        return value;
+    }
+    async load() {
+        try {
+            const value = JSON.parse(await node_fs_1.promises.readFile(this.credentialsFile, 'utf8'));
+            return validateCredentials(value) ? value : undefined;
+        }
+        catch (error) {
+            if (isMissing(error) || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    async save(credentials) {
+        if (!validateCredentials(credentials))
+            throw new Error('Pairing service returned invalid device credentials');
+        await node_fs_1.promises.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        await atomicWrite(this.credentialsFile, `${JSON.stringify(credentials)}\n`);
+        const previousState = await this.loadPairingState();
+        await this.savePairingState({
+            version: 1,
+            lastPairingCodeFingerprint: credentials.pairingCodeFingerprint ?? previousState?.lastPairingCodeFingerprint,
+            lastDeviceId: credentials.deviceId
+        });
+    }
+    async lastPairingCodeFingerprint() {
+        const credentials = await this.load();
+        if (credentials?.pairingCodeFingerprint)
+            return credentials.pairingCodeFingerprint;
+        return (await this.loadPairingState())?.lastPairingCodeFingerprint;
+    }
+    async forget() {
+        const credentials = await this.load();
+        if (!credentials)
+            return { forgotten: false };
+        const previousState = await this.loadPairingState();
+        await this.savePairingState({
+            version: 1,
+            lastPairingCodeFingerprint: credentials.pairingCodeFingerprint ?? previousState?.lastPairingCodeFingerprint,
+            lastDeviceId: credentials.deviceId,
+            forgottenAt: Date.now()
+        });
+        try {
+            await node_fs_1.promises.unlink(this.credentialsFile);
+        }
+        catch (error) {
+            if (!isMissing(error))
+                throw error;
+        }
+        return { forgotten: true, deviceId: credentials.deviceId };
+    }
+    async loadPairingState() {
+        try {
+            const value = JSON.parse(await node_fs_1.promises.readFile(this.pairingStateFile, 'utf8'));
+            if (value.version !== 1)
+                return undefined;
+            if (value.lastPairingCodeFingerprint !== undefined && !/^[0-9a-f]{64}$/.test(value.lastPairingCodeFingerprint))
+                return undefined;
+            if (value.lastDeviceId !== undefined && !validId(value.lastDeviceId))
+                return undefined;
+            return value;
+        }
+        catch (error) {
+            if (isMissing(error) || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    async savePairingState(state) {
+        await node_fs_1.promises.mkdir(this.directory, { recursive: true, mode: 0o700 });
+        await atomicWrite(this.pairingStateFile, `${JSON.stringify(state)}\n`);
+    }
+}
+exports.CredentialStore = CredentialStore;
+function validateCredentials(value) {
+    return value?.version === 1 && validId(value.deviceId) && validId(value.clientId) &&
+        typeof value.username === 'string' && value.username.length > 0 && value.username.length <= 256 &&
+        typeof value.password === 'string' && value.password.length >= 16 && value.password.length <= 4096 &&
+        validHostname(value.mqttHost) && Number.isInteger(value.mqttPort) && value.mqttPort >= 1 && value.mqttPort <= 65535 &&
+        typeof value.tls === 'boolean' &&
+        Number.isFinite(value.pairedAt) &&
+        (value.pairingCodeFingerprint === undefined || /^[0-9a-f]{64}$/.test(value.pairingCodeFingerprint)) &&
+        validTelemetryProfile(value.telemetryProfile) && validOutboxBinding(value.outboxBinding) && validAssociationStatus(value);
+}
+function fingerprintPairingCode(code) {
+    return (0, node_crypto_1.createHash)('sha256').update(code, 'utf8').digest('hex');
+}
+function shouldExchangePairingCode(credentials, code, lastFingerprint) {
+    return typeof code === 'string' && code.length > 0 &&
+        (credentials?.pairingCodeFingerprint ?? lastFingerprint) !== fingerprintPairingCode(code);
+}
+function validId(value) { return typeof value === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(value); }
+function validHostname(value) {
+    return typeof value === 'string' && value.length <= 253 && /^(?=.{1,253}$)[A-Za-z0-9](?:[A-Za-z0-9.-]*[A-Za-z0-9])?$/.test(value);
+}
+function validTelemetryProfile(value) {
+    if (value === undefined)
+        return true;
+    if (typeof value !== 'object' || value === null)
+        return false;
+    if ((0, profile_1.parseTelemetryProfile)(value))
+        return true;
+    const legacy = value;
+    return (legacy.sample_period_ms === undefined || (Number.isInteger(legacy.sample_period_ms) && legacy.sample_period_ms >= 250 && legacy.sample_period_ms <= 60_000)) &&
+        (legacy.batch_size === undefined || (Number.isInteger(legacy.batch_size) && legacy.batch_size >= 1 && legacy.batch_size <= 60));
+}
+function validOutboxBinding(value) {
+    return value === undefined || (value.version === 1 && (value.backend === 'file' || value.backend === 'database') &&
+        Number.isFinite(value.initializedAt) && value.initializedAt >= 0);
+}
+function validAssociationStatus(value) {
+    if (value.associationStatusUrl === undefined && value.associationToken === undefined)
+        return true;
+    return typeof value.associationStatusUrl === 'string' && /^https:\/\//.test(value.associationStatusUrl) && value.associationStatusUrl.length <= 2048 &&
+        typeof value.associationToken === 'string' && value.associationToken.length >= 32 && value.associationToken.length <= 512;
+}
+function isMissing(error) { return error?.code === 'ENOENT'; }
+async function atomicWrite(target, contents) {
+    const temporary = `${target}.tmp`;
+    await node_fs_1.promises.writeFile(temporary, contents, { 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);
+    await node_fs_1.promises.chmod(target, 0o600);
+}
+//# sourceMappingURL=credentials.js.map

package/dist/pairing/credentials.js.map

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

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

@@ -0,0 +1,19 @@
+import type { DeviceCredentials } from './credentials';
+export declare class PairingError extends Error {
+    readonly retryable: boolean;
+    readonly status?: number | undefined;
+    constructor(message: string, retryable: boolean, status?: number | undefined);
+}
+interface PairingRequestOptions {
+    signal?: AbortSignal;
+}
+export interface PairingRetryOptions extends PairingRequestOptions {
+    maxAttempts?: number;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    onAttempt?: (attempt: number, maxAttempts: number) => void;
+    onRetry?: (nextAttempt: number, maxAttempts: number, delayMs: number, error: PairingError) => void;
+}
+export declare function pairDevice(apiUrl: string, pairingCode: string, installationId: string, options?: PairingRequestOptions): Promise<DeviceCredentials>;
+export declare function pairDeviceWithRetry(apiUrl: string, pairingCode: string, installationId: string, options?: PairingRetryOptions): Promise<DeviceCredentials>;
+export {};

package/dist/pairing/pairing-client.js

@@ -0,0 +1,102 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PairingError = void 0;
+exports.pairDevice = pairDevice;
+exports.pairDeviceWithRetry = pairDeviceWithRetry;
+const credentials_1 = require("./credentials");
+class PairingError extends Error {
+    retryable;
+    status;
+    constructor(message, retryable, status) {
+        super(message);
+        this.retryable = retryable;
+        this.status = status;
+        this.name = 'PairingError';
+    }
+}
+exports.PairingError = PairingError;
+async function pairDevice(apiUrl, pairingCode, installationId, options = {}) {
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 15_000);
+    const abort = () => controller.abort();
+    options.signal?.addEventListener('abort', abort, { once: true });
+    try {
+        let response;
+        try {
+            response = await fetch(apiUrl, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', accept: 'application/json' },
+                body: JSON.stringify({ code: pairingCode, name: `Signal K ${installationId.slice(0, 8)}` }),
+                signal: controller.signal
+            });
+        }
+        catch {
+            if (options.signal?.aborted)
+                throw new PairingError('Pairing cancelled', false);
+            const timedOut = controller.signal.aborted;
+            throw new PairingError(timedOut ? 'Pairing request timed out' : 'Pairing service is unavailable', true);
+        }
+        if (!response.ok) {
+            const retryable = response.status === 408 || response.status === 425 || response.status === 429 || response.status >= 500;
+            const message = response.status === 400
+                ? 'Pairing code is invalid or expired'
+                : `Pairing failed with HTTP ${response.status}`;
+            throw new PairingError(message, retryable, response.status);
+        }
+        const body = await response.json();
+        const credentials = {
+            version: 1,
+            deviceId: body.device?.id,
+            clientId: body.credentials?.client_id,
+            username: body.credentials?.username,
+            password: body.credentials?.password,
+            mqttHost: body.credentials?.broker_host,
+            mqttPort: body.credentials?.broker_port,
+            tls: body.credentials?.tls,
+            telemetryProfile: body.credentials?.telemetry_profile,
+            associationStatusUrl: body.credentials?.association_status_url,
+            associationToken: body.credentials?.association_token,
+            pairedAt: Date.now()
+        };
+        if (!(0, credentials_1.validateCredentials)(credentials))
+            throw new PairingError('Pairing response failed validation', false);
+        return credentials;
+    }
+    finally {
+        clearTimeout(timeout);
+        options.signal?.removeEventListener('abort', abort);
+    }
+}
+async function pairDeviceWithRetry(apiUrl, pairingCode, installationId, options = {}) {
+    const maxAttempts = Math.max(1, Math.min(10, options.maxAttempts ?? 6));
+    const baseDelayMs = Math.max(1, options.baseDelayMs ?? 2000);
+    const maxDelayMs = Math.max(baseDelayMs, options.maxDelayMs ?? 30_000);
+    let lastError = new PairingError('Pairing failed', false);
+    for (let attempt = 1; attempt <= maxAttempts; attempt += 1) {
+        options.onAttempt?.(attempt, maxAttempts);
+        try {
+            return await pairDevice(apiUrl, pairingCode, installationId, { signal: options.signal });
+        }
+        catch (error) {
+            lastError = error instanceof PairingError ? error : new PairingError('Pairing service is unavailable', true);
+            if (!lastError.retryable || attempt >= maxAttempts || options.signal?.aborted)
+                throw lastError;
+            const delayMs = Math.min(maxDelayMs, baseDelayMs * 2 ** (attempt - 1));
+            options.onRetry?.(attempt + 1, maxAttempts, delayMs, lastError);
+            await abortableDelay(delayMs, options.signal);
+        }
+    }
+    throw lastError;
+}
+function abortableDelay(delayMs, signal) {
+    return new Promise((resolve, reject) => {
+        if (signal?.aborted) {
+            reject(new PairingError('Pairing cancelled', false));
+            return;
+        }
+        const timer = setTimeout(() => { signal?.removeEventListener('abort', abort); resolve(); }, delayMs);
+        const abort = () => { clearTimeout(timer); reject(new PairingError('Pairing cancelled', false)); };
+        signal?.addEventListener('abort', abort, { once: true });
+    });
+}
+//# sourceMappingURL=pairing-client.js.map

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

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

package/dist/signalk/normaliser.d.ts

@@ -0,0 +1,11 @@
+import type { Delta } from '@signalk/server-api';
+import type { TelemetryDraft, TelemetryField } from '../telemetry/types';
+export declare class TelemetryNormaliser {
+    private readonly values;
+    private dirty;
+    private readonly emitted;
+    ingest(delta: Delta, receivedAt?: number): void;
+    takeSample(now?: number, fields?: Set<TelemetryField>): TelemetryDraft | undefined;
+    private get;
+    private trackPresence;
+}

package/dist/signalk/normaliser.js

@@ -0,0 +1,119 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryNormaliser = void 0;
+const MS_PER_SECOND = 1000;
+const MPS_TO_KNOTS = 1.9438444924406;
+const EARLIEST_SOURCE_TIME = Date.UTC(2000, 0, 1);
+const MAX_FUTURE_MS = 5 * 60 * MS_PER_SECOND;
+class TelemetryNormaliser {
+    values = new Map();
+    dirty = false;
+    emitted = new Set();
+    ingest(delta, receivedAt = Date.now()) {
+        for (const update of delta.updates) {
+            if (!('values' in update))
+                continue;
+            const sourceAt = parseSourceTime(update.timestamp, receivedAt);
+            for (const pathValue of update.values) {
+                if (!isSupportedPath(pathValue.path))
+                    continue;
+                if (pathValue.state?.timedOut || !isValidPathValue(pathValue.path, pathValue.value)) {
+                    if (this.values.delete(pathValue.path))
+                        this.dirty = true;
+                    continue;
+                }
+                this.values.set(pathValue.path, { value: pathValue.value, sourceAt, receivedAt });
+                this.dirty = true;
+            }
+        }
+    }
+    takeSample(now = Date.now(), fields = new Set(['position', 'sog', 'cog', 'heading', 'depth', 'apparentWind'])) {
+        if (!this.dirty)
+            return undefined;
+        const position = this.get('navigation.position', now);
+        if (!position)
+            return undefined;
+        this.dirty = false;
+        const headingTrue = fields.has('heading') ? this.get('navigation.headingTrue', now) : undefined;
+        const headingMagnetic = fields.has('heading') ? this.get('navigation.headingMagnetic', now) : undefined;
+        const capturedAt = position.sourceAt ?? now;
+        const quality = { timestamp: position.sourceAt !== undefined ? 'source' : 'receipt' };
+        const values = {
+            lat: position.value.latitude,
+            lon: position.value.longitude,
+            sog_kn: fields.has('sog') ? convertNumber(this.get('navigation.speedOverGround', now), (v) => v * MPS_TO_KNOTS) : undefined,
+            cog_deg: fields.has('cog') ? convertNumber(this.get('navigation.courseOverGroundTrue', now), radiansToDegrees) : undefined,
+            heading_deg: convertNumber(headingTrue ?? headingMagnetic, radiansToDegrees),
+            heading_reference: headingTrue !== undefined ? 'true' : headingMagnetic !== undefined ? 'magnetic' : undefined,
+            depth_m: fields.has('depth') ? this.get('environment.depth.belowTransducer', now)?.value : undefined,
+            aws_kn: fields.has('apparentWind') ? convertNumber(this.get('environment.wind.speedApparent', now), (v) => v * MPS_TO_KNOTS) : undefined,
+            awa_deg: fields.has('apparentWind') ? convertNumber(this.get('environment.wind.angleApparent', now), radiansToDegrees) : undefined
+        };
+        const cleared = [];
+        this.trackPresence('sog', fields.has('sog'), values.sog_kn !== undefined, cleared);
+        this.trackPresence('cog', fields.has('cog'), values.cog_deg !== undefined, cleared);
+        this.trackPresence('heading', fields.has('heading'), values.heading_deg !== undefined, cleared);
+        this.trackPresence('depth', fields.has('depth'), values.depth_m !== undefined, cleared);
+        this.trackPresence('apparentWind', fields.has('apparentWind'), values.aws_kn !== undefined || values.awa_deg !== undefined, cleared);
+        removeUndefined(values);
+        return { capturedAt, receivedAt: now, values, quality, cleared: cleared.length ? cleared : undefined };
+    }
+    get(path, now) {
+        const value = this.values.get(path);
+        return value && now - value.receivedAt <= 30_000 ? value : undefined;
+    }
+    trackPresence(field, due, present, cleared) {
+        if (!due)
+            return;
+        if (present)
+            this.emitted.add(field);
+        else if (this.emitted.delete(field))
+            cleared.push(field);
+    }
+}
+exports.TelemetryNormaliser = TelemetryNormaliser;
+function parseSourceTime(value, receivedAt) {
+    if (!value)
+        return undefined;
+    const parsed = Date.parse(value);
+    return Number.isFinite(parsed) && parsed >= EARLIEST_SOURCE_TIME && parsed <= receivedAt + MAX_FUTURE_MS ? parsed : undefined;
+}
+function isSupportedPath(path) {
+    return [
+        'navigation.position', 'navigation.speedOverGround', 'navigation.courseOverGroundTrue',
+        'navigation.headingTrue', 'navigation.headingMagnetic', 'environment.depth.belowTransducer',
+        'environment.wind.speedApparent', 'environment.wind.angleApparent'
+    ].includes(path);
+}
+function isValidPathValue(path, value) {
+    if (path === 'navigation.position') {
+        const p = value;
+        return !!p && finiteBetween(p.latitude, -90, 90) && finiteBetween(p.longitude, -180, 180);
+    }
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return false;
+    switch (path) {
+        case 'navigation.speedOverGround': return finiteBetween(value, 0, 80);
+        case 'environment.depth.belowTransducer': return finiteBetween(value, 0, 12_000);
+        case 'environment.wind.speedApparent': return finiteBetween(value, 0, 120);
+        default: return Math.abs(value) <= Math.PI * 100;
+    }
+}
+function finiteBetween(value, min, max) {
+    return typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+}
+function radiansToDegrees(value) {
+    return ((value * 180 / Math.PI) % 360 + 360) % 360;
+}
+function convertNumber(value, convert) {
+    if (value === undefined)
+        return undefined;
+    const number = typeof value === 'number' ? value : value.value;
+    return Math.round(convert(number) * 1_000_000) / 1_000_000;
+}
+function removeUndefined(value) {
+    for (const key of Object.keys(value))
+        if (value[key] === undefined)
+            delete value[key];
+}
+//# sourceMappingURL=normaliser.js.map

package/dist/signalk/normaliser.js.map

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

package/dist/signalk/paths.d.ts

@@ -0,0 +1,2 @@
+export declare const SIGNALK_PATHS: readonly ["navigation.position", "navigation.speedOverGround", "navigation.courseOverGroundTrue", "navigation.headingTrue", "navigation.headingMagnetic", "environment.depth.belowTransducer", "environment.wind.speedApparent", "environment.wind.angleApparent"];
+export type SignalKPath = (typeof SIGNALK_PATHS)[number];

package/dist/signalk/paths.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SIGNALK_PATHS = void 0;
+exports.SIGNALK_PATHS = [
+    'navigation.position',
+    'navigation.speedOverGround',
+    'navigation.courseOverGroundTrue',
+    'navigation.headingTrue',
+    'navigation.headingMagnetic',
+    'environment.depth.belowTransducer',
+    'environment.wind.speedApparent',
+    'environment.wind.angleApparent'
+];
+//# sourceMappingURL=paths.js.map

package/dist/signalk/paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/signalk/paths.ts"],"names":[],"mappings":";;;AAAa,QAAA,aAAa,GAAG;IAC3B,qBAAqB;IACrB,4BAA4B;IAC5B,iCAAiC;IACjC,wBAAwB;IACxB,4BAA4B;IAC5B,mCAAmC;IACnC,gCAAgC;IAChC,gCAAgC;CACxB,CAAA"}

package/dist/signalk/subscriber.d.ts

@@ -0,0 +1,2 @@
+import type { Delta, ServerAPI } from '@signalk/server-api';
+export declare function subscribeToTelemetry(app: ServerAPI, callback: (delta: Delta) => void): () => void;

package/dist/signalk/subscriber.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.subscribeToTelemetry = subscribeToTelemetry;
+const paths_1 = require("./paths");
+function subscribeToTelemetry(app, callback) {
+    const unsubscribes = [];
+    app.subscriptionmanager.subscribe({
+        context: 'vessels.self',
+        subscribe: paths_1.SIGNALK_PATHS.map((path) => ({ path: path, policy: 'instant', minPeriod: 100 })),
+        sourcePolicy: 'preferred'
+    }, unsubscribes, (error) => app.error(`Wake Logger subscription error: ${safeError(error)}`), callback);
+    return () => {
+        for (const unsubscribe of unsubscribes.splice(0))
+            unsubscribe();
+    };
+}
+function safeError(error) {
+    return error instanceof Error ? error.message : String(error);
+}
+//# sourceMappingURL=subscriber.js.map

package/dist/signalk/subscriber.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscriber.js","sourceRoot":"","sources":["../../src/signalk/subscriber.ts"],"names":[],"mappings":";;AAGA,oDAeC;AAjBD,mCAAuC;AAEvC,SAAgB,oBAAoB,CAAC,GAAc,EAAE,QAAgC;IACnF,MAAM,YAAY,GAAiB,EAAE,CAAA;IACrC,GAAG,CAAC,mBAAmB,CAAC,SAAS,CAC/B;QACE,OAAO,EAAE,cAAuB;QAChC,SAAS,EAAE,qBAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,IAAa,EAAE,MAAM,EAAE,SAAkB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;QAC7G,YAAY,EAAE,WAAW;KAC1B,EACD,YAAY,EACZ,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,mCAAmC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,EAC3E,QAAQ,CACT,CAAA;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,WAAW,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;YAAE,WAAW,EAAE,CAAA;IACjE,CAAC,CAAA;AACH,CAAC;AAED,SAAS,SAAS,CAAC,KAAc;IAC/B,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;AAC/D,CAAC"}

package/dist/telemetry/profile-store.d.ts

@@ -0,0 +1,7 @@
+import { type TelemetryProfile } from './profile';
+export declare class TelemetryProfileStore {
+    private readonly target;
+    constructor(directory: string);
+    load(): Promise<TelemetryProfile | undefined>;
+    save(profile: TelemetryProfile): Promise<void>;
+}

package/dist/telemetry/profile-store.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TelemetryProfileStore = void 0;
+const node_fs_1 = require("node:fs");
+const node_path_1 = __importDefault(require("node:path"));
+const profile_1 = require("./profile");
+class TelemetryProfileStore {
+    target;
+    constructor(directory) { this.target = node_path_1.default.join(directory, 'telemetry-profile.json'); }
+    async load() {
+        try {
+            return (0, profile_1.parseTelemetryProfile)(JSON.parse(await node_fs_1.promises.readFile(this.target, 'utf8')));
+        }
+        catch (error) {
+            if (error.code === 'ENOENT' || error instanceof SyntaxError)
+                return undefined;
+            throw error;
+        }
+    }
+    async save(profile) {
+        await node_fs_1.promises.mkdir(node_path_1.default.dirname(this.target), { recursive: true, mode: 0o700 });
+        const temporary = `${this.target}.tmp`;
+        await node_fs_1.promises.writeFile(temporary, `${JSON.stringify(profile)}\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, this.target);
+        await node_fs_1.promises.chmod(this.target, 0o600);
+    }
+}
+exports.TelemetryProfileStore = TelemetryProfileStore;
+//# sourceMappingURL=profile-store.js.map

package/dist/telemetry/profile-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"profile-store.js","sourceRoot":"","sources":["../../src/telemetry/profile-store.ts"],"names":[],"mappings":";;;;;;AAAA,qCAAwC;AACxC,0DAA4B;AAC5B,uCAAwE;AAExE,MAAa,qBAAqB;IACf,MAAM,CAAQ;IAC/B,YAAY,SAAiB,IAAI,IAAI,CAAC,MAAM,GAAG,mBAAI,CAAC,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,CAAA,CAAC,CAAC;IAE/F,KAAK,CAAC,IAAI;QACR,IAAI,CAAC;YAAC,OAAO,IAAA,+BAAqB,EAAC,IAAI,CAAC,KAAK,CAAC,MAAM,kBAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAA;QAAC,CAAC;QACxF,OAAO,KAAK,EAAE,CAAC;YACb,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,YAAY,WAAW;gBAAE,OAAO,SAAS,CAAA;YACxG,MAAM,KAAK,CAAA;QACb,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,OAAyB;QAClC,MAAM,kBAAE,CAAC,KAAK,CAAC,mBAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC3E,MAAM,SAAS,GAAG,GAAG,IAAI,CAAC,MAAM,MAAM,CAAA;QACtC,MAAM,kBAAE,CAAC,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;QAC9E,MAAM,MAAM,GAAG,MAAM,kBAAE,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QAC7C,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;QACrB,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAA;QACtB,CAAC;QACD,MAAM,kBAAE,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,CAAA;QACvC,MAAM,kBAAE,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IACpC,CAAC;CACF;AAzBD,sDAyBC"}

package/dist/telemetry/profile.d.ts

@@ -0,0 +1,32 @@
+import type { NetworkMode, TelemetryField } from './types';
+export interface PathRateProfile {
+    enabled: boolean;
+    normalMs: number;
+    constrainedMs: number;
+    offlineMs: number;
+}
+export interface TelemetryProfile {
+    v: 1;
+    profileId: string;
+    revision: number;
+    issuedAt: number;
+    paths: Record<TelemetryField, PathRateProfile>;
+    transport: {
+        batchSize: number;
+        maxPayloadBytes: number;
+        normalBacklogBytesPerSecond: number;
+        constrainedBacklogBytesPerSecond: number;
+    };
+}
+export interface ProfileAcknowledgement {
+    v: 1;
+    profileId: string;
+    revision: number;
+    status: 'applied' | 'rejected';
+    at: number;
+    errorCode?: string;
+}
+export declare const DEFAULT_TELEMETRY_PROFILE: TelemetryProfile;
+export declare function parseTelemetryProfile(value: unknown): TelemetryProfile | undefined;
+export declare function legacyProfile(samplePeriodMs?: number, batchSize?: number): TelemetryProfile;
+export declare function periodFor(profile: TelemetryProfile, field: TelemetryField, mode: NetworkMode): number;