crewly 1.3.31 → 1.4.0

package/dist/backend/backend/src/services/cloud/device-auto-discovery.service.js

@@ -0,0 +1,415 @@
+/**
+ * Device Auto-Discovery Service
+ *
+ * Polls the Cloud device registry to discover other Crewly instances
+ * belonging to the same user account. Enables automatic relay pairing
+ * without manual configuration.
+ *
+ * Flow:
+ * 1. On cloud login, register this device with the Cloud device API
+ * 2. Poll GET /v1/devices to discover other online devices
+ * 3. Auto-initiate relay connection to discovered peers
+ * 4. Maintain heartbeat so other devices can discover us
+ *
+ * Implements exponential backoff on API failures to prevent runaway
+ * request storms. After MAX_CONSECUTIVE_FAILURES, polling stops and
+ * the service enters an error state.
+ *
+ * @see https://github.com/stevehuang0115/crewly/issues/relay-auto-discovery
+ * @module services/cloud/device-auto-discovery.service
+ */
+import { EventEmitter } from 'events';
+import * as os from 'os';
+import { LoggerService } from '../core/logger.service.js';
+/** Discovery constants */
+export const DISCOVERY_CONSTANTS = {
+    /** Default polling interval for device discovery (30 seconds) */
+    POLL_INTERVAL_MS: 30_000,
+    /** Default heartbeat interval (30 seconds) */
+    HEARTBEAT_INTERVAL_MS: 30_000,
+    /** Device considered offline after this threshold (5 minutes) */
+    OFFLINE_THRESHOLD_MS: 300_000,
+    /** Maximum devices per user account */
+    MAX_DEVICES_PER_USER: 10,
+    /** Cloud device API path */
+    DEVICES_PATH: '/v1/devices',
+    /** Base delay for exponential backoff (1 second) */
+    BACKOFF_BASE_MS: 1_000,
+    /** Maximum backoff delay (5 minutes) */
+    BACKOFF_MAX_MS: 300_000,
+    /** Exponential backoff multiplier */
+    BACKOFF_MULTIPLIER: 2,
+    /** Stop polling after this many consecutive failures */
+    MAX_CONSECUTIVE_POLL_FAILURES: 20,
+    /** Stop sending heartbeats after this many consecutive failures */
+    MAX_CONSECUTIVE_HEARTBEAT_FAILURES: 10,
+};
+// ---------------------------------------------------------------------------
+// Service
+// ---------------------------------------------------------------------------
+/**
+ * DeviceAutoDiscoveryService discovers other Crewly instances via Cloud.
+ *
+ * Uses self-scheduling setTimeout loops (instead of fixed setInterval) so
+ * that polling and heartbeat intervals can be dynamically adjusted when
+ * exponential backoff is active.
+ *
+ * Emits events:
+ * - 'deviceFound' — new device discovered
+ * - 'deviceLost' — previously online device went offline
+ * - 'devicesUpdated' — full device list refreshed
+ * - 'backoffActive' — backoff engaged after a failure (payload: { delay, failures })
+ * - 'maxRetriesExceeded' — polling stopped due to too many failures
+ */
+export class DeviceAutoDiscoveryService extends EventEmitter {
+    static instance = null;
+    logger;
+    state = 'stopped';
+    config = null;
+    pollTimer = null;
+    heartbeatTimer = null;
+    knownDevices = new Map();
+    /** Number of consecutive poll failures (reset on success) */
+    consecutivePollFailures = 0;
+    /** Number of consecutive heartbeat failures (reset on success) */
+    consecutiveHeartbeatFailures = 0;
+    constructor() {
+        super();
+        this.logger = LoggerService.getInstance().createComponentLogger('DeviceAutoDiscovery');
+    }
+    static getInstance() {
+        if (!DeviceAutoDiscoveryService.instance) {
+            DeviceAutoDiscoveryService.instance = new DeviceAutoDiscoveryService();
+        }
+        return DeviceAutoDiscoveryService.instance;
+    }
+    static resetInstance() {
+        if (DeviceAutoDiscoveryService.instance) {
+            DeviceAutoDiscoveryService.instance.stop();
+        }
+        DeviceAutoDiscoveryService.instance = null;
+    }
+    /**
+     * Get the current discovery state.
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Get all currently known devices.
+     */
+    getDevices() {
+        return Array.from(this.knownDevices.values());
+    }
+    /**
+     * Get only online devices (excluding self).
+     */
+    getOnlineDevices() {
+        return this.getDevices().filter(d => d.online && d.deviceId !== this.config?.deviceId);
+    }
+    /**
+     * Get the number of consecutive poll failures.
+     */
+    getConsecutivePollFailures() {
+        return this.consecutivePollFailures;
+    }
+    /**
+     * Get the number of consecutive heartbeat failures.
+     */
+    getConsecutiveHeartbeatFailures() {
+        return this.consecutiveHeartbeatFailures;
+    }
+    /**
+     * Start auto-discovery: register this device, begin polling + heartbeat.
+     *
+     * @param config - Discovery configuration with cloud credentials
+     */
+    async start(config) {
+        if (this.state !== 'stopped') {
+            this.logger.warn('Discovery already running, stopping first');
+            this.stop();
+        }
+        this.config = config;
+        this.state = 'registering';
+        this.consecutivePollFailures = 0;
+        this.consecutiveHeartbeatFailures = 0;
+        try {
+            // Step 1: Register this device with the cloud
+            await this.registerDevice();
+            // Step 2: Do an initial discovery poll
+            await this.pollDevices();
+            // Step 3: Start self-scheduling poll and heartbeat loops
+            this.schedulePoll();
+            this.scheduleHeartbeat();
+            this.state = 'polling';
+            this.logger.info('Auto-discovery started', {
+                deviceId: config.deviceId,
+                deviceName: config.deviceName,
+                role: config.role,
+                pollInterval: config.pollIntervalMs || DISCOVERY_CONSTANTS.POLL_INTERVAL_MS,
+            });
+        }
+        catch (err) {
+            this.state = 'error';
+            this.logger.error('Failed to start auto-discovery', {
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
+    }
+    /**
+     * Stop auto-discovery: clear timers and deregister.
+     */
+    stop() {
+        if (this.pollTimer) {
+            clearTimeout(this.pollTimer);
+            this.pollTimer = null;
+        }
+        if (this.heartbeatTimer) {
+            clearTimeout(this.heartbeatTimer);
+            this.heartbeatTimer = null;
+        }
+        this.knownDevices.clear();
+        this.consecutivePollFailures = 0;
+        this.consecutiveHeartbeatFailures = 0;
+        this.state = 'stopped';
+        this.logger.info('Auto-discovery stopped');
+    }
+    // ---------------------------------------------------------------------------
+    // Backoff helpers
+    // ---------------------------------------------------------------------------
+    /**
+     * Calculate exponential backoff delay for the given number of consecutive
+     * failures. Uses base × 2^(failures-1), capped at BACKOFF_MAX_MS.
+     *
+     * @param failures - Number of consecutive failures (0 = no backoff)
+     * @returns Delay in ms (0 if no failures)
+     */
+    static calculateBackoff(failures) {
+        if (failures <= 0)
+            return 0;
+        const delay = DISCOVERY_CONSTANTS.BACKOFF_BASE_MS *
+            Math.pow(DISCOVERY_CONSTANTS.BACKOFF_MULTIPLIER, failures - 1);
+        return Math.min(delay, DISCOVERY_CONSTANTS.BACKOFF_MAX_MS);
+    }
+    // ---------------------------------------------------------------------------
+    // Self-scheduling loops
+    // ---------------------------------------------------------------------------
+    /**
+     * Schedule the next poll. Uses the normal interval on success, or
+     * exponential backoff on consecutive failures.
+     */
+    schedulePoll() {
+        if (this.state === 'stopped' || this.state === 'error')
+            return;
+        const baseInterval = this.config?.pollIntervalMs || DISCOVERY_CONSTANTS.POLL_INTERVAL_MS;
+        const backoff = DeviceAutoDiscoveryService.calculateBackoff(this.consecutivePollFailures);
+        const delay = backoff > 0 ? backoff : baseInterval;
+        this.pollTimer = setTimeout(() => {
+            this.pollDevices().finally(() => this.schedulePoll());
+        }, delay);
+    }
+    /**
+     * Schedule the next heartbeat. Uses the normal interval on success, or
+     * exponential backoff on consecutive failures.
+     */
+    scheduleHeartbeat() {
+        if (this.state === 'stopped' || this.state === 'error')
+            return;
+        const baseInterval = this.config?.heartbeatIntervalMs || DISCOVERY_CONSTANTS.HEARTBEAT_INTERVAL_MS;
+        const backoff = DeviceAutoDiscoveryService.calculateBackoff(this.consecutiveHeartbeatFailures);
+        const delay = backoff > 0 ? backoff : baseInterval;
+        this.heartbeatTimer = setTimeout(() => {
+            this.sendHeartbeat().finally(() => this.scheduleHeartbeat());
+        }, delay);
+    }
+    // ---------------------------------------------------------------------------
+    // API calls
+    // ---------------------------------------------------------------------------
+    /**
+     * Register this device with the cloud device registry.
+     */
+    async registerDevice() {
+        if (!this.config)
+            throw new Error('Discovery not configured');
+        const url = `${this.config.cloudUrl}${DISCOVERY_CONSTANTS.DEVICES_PATH}/register`;
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${this.config.token}`,
+            },
+            body: JSON.stringify({
+                deviceId: this.config.deviceId,
+                deviceName: this.config.deviceName,
+                role: this.config.role,
+                platform: os.platform(),
+                arch: os.arch(),
+                hostname: os.hostname(),
+            }),
+        });
+        if (!response.ok) {
+            const body = await response.text().catch(() => '');
+            throw new Error(`Device registration failed: ${response.status} ${body.slice(0, 200)}`);
+        }
+        this.logger.info('Device registered with cloud', {
+            deviceId: this.config.deviceId,
+            deviceName: this.config.deviceName,
+        });
+    }
+    /**
+     * Poll the cloud for other devices belonging to the same user. On failure,
+     * increments the consecutive failure counter and triggers exponential
+     * backoff. After MAX_CONSECUTIVE_POLL_FAILURES, stops polling entirely.
+     */
+    async pollDevices() {
+        if (!this.config)
+            return;
+        try {
+            const url = `${this.config.cloudUrl}${DISCOVERY_CONSTANTS.DEVICES_PATH}`;
+            const response = await fetch(url, {
+                method: 'GET',
+                headers: {
+                    'Authorization': `Bearer ${this.config.token}`,
+                },
+            });
+            if (!response.ok) {
+                this.handlePollFailure(`HTTP ${response.status}`);
+                return;
+            }
+            const data = (await response.json());
+            const devices = data.devices || [];
+            // Success — reset failure counter
+            if (this.consecutivePollFailures > 0) {
+                this.logger.info('Poll recovered after backoff', {
+                    previousFailures: this.consecutivePollFailures,
+                });
+            }
+            this.consecutivePollFailures = 0;
+            // Track changes
+            const previousIds = new Set(this.knownDevices.keys());
+            const currentIds = new Set();
+            for (const device of devices) {
+                currentIds.add(device.deviceId);
+                if (!previousIds.has(device.deviceId) && device.deviceId !== this.config.deviceId) {
+                    this.emit('deviceFound', device);
+                    this.logger.info('New device discovered', {
+                        deviceId: device.deviceId,
+                        deviceName: device.deviceName,
+                        role: device.role,
+                    });
+                }
+                this.knownDevices.set(device.deviceId, device);
+            }
+            // Check for lost devices
+            for (const prevId of previousIds) {
+                if (!currentIds.has(prevId)) {
+                    const lost = this.knownDevices.get(prevId);
+                    this.knownDevices.delete(prevId);
+                    if (lost) {
+                        this.emit('deviceLost', lost);
+                        this.logger.info('Device went offline', {
+                            deviceId: lost.deviceId,
+                            deviceName: lost.deviceName,
+                        });
+                    }
+                }
+            }
+            this.emit('devicesUpdated', this.getDevices());
+        }
+        catch (err) {
+            this.handlePollFailure(err instanceof Error ? err.message : String(err));
+        }
+    }
+    /**
+     * Handle a poll failure: increment counter, log with backoff info, and
+     * stop polling if the max retry limit is exceeded.
+     *
+     * @param reason - Human-readable failure reason
+     */
+    handlePollFailure(reason) {
+        this.consecutivePollFailures++;
+        const nextDelay = DeviceAutoDiscoveryService.calculateBackoff(this.consecutivePollFailures);
+        this.logger.warn('Device poll failed', {
+            reason,
+            consecutiveFailures: this.consecutivePollFailures,
+            nextRetryMs: nextDelay,
+        });
+        this.emit('backoffActive', {
+            type: 'poll',
+            delay: nextDelay,
+            failures: this.consecutivePollFailures,
+        });
+        if (this.consecutivePollFailures >= DISCOVERY_CONSTANTS.MAX_CONSECUTIVE_POLL_FAILURES) {
+            this.logger.error('Max poll retries exceeded, stopping discovery', {
+                failures: this.consecutivePollFailures,
+            });
+            this.state = 'error';
+            this.emit('maxRetriesExceeded', {
+                type: 'poll',
+                failures: this.consecutivePollFailures,
+            });
+            // Cancel future polls (heartbeat may still be running)
+            if (this.pollTimer) {
+                clearTimeout(this.pollTimer);
+                this.pollTimer = null;
+            }
+        }
+    }
+    /**
+     * Send a heartbeat to the cloud to keep this device marked as online.
+     * On failure, increments heartbeat failure counter and backs off.
+     * After MAX_CONSECUTIVE_HEARTBEAT_FAILURES, stops sending heartbeats.
+     */
+    async sendHeartbeat() {
+        if (!this.config)
+            return;
+        try {
+            const url = `${this.config.cloudUrl}${DISCOVERY_CONSTANTS.DEVICES_PATH}/heartbeat`;
+            const response = await fetch(url, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `Bearer ${this.config.token}`,
+                },
+                body: JSON.stringify({
+                    deviceId: this.config.deviceId,
+                }),
+            });
+            if (!response.ok) {
+                this.handleHeartbeatFailure(`HTTP ${response.status}`);
+                return;
+            }
+            // Success — reset failure counter
+            this.consecutiveHeartbeatFailures = 0;
+        }
+        catch (err) {
+            this.handleHeartbeatFailure(err instanceof Error ? err.message : String(err));
+        }
+    }
+    /**
+     * Handle a heartbeat failure: increment counter and stop heartbeats
+     * if the max retry limit is exceeded.
+     *
+     * @param reason - Human-readable failure reason
+     */
+    handleHeartbeatFailure(reason) {
+        this.consecutiveHeartbeatFailures++;
+        const nextDelay = DeviceAutoDiscoveryService.calculateBackoff(this.consecutiveHeartbeatFailures);
+        this.logger.warn('Heartbeat failed', {
+            reason,
+            consecutiveFailures: this.consecutiveHeartbeatFailures,
+            nextRetryMs: nextDelay,
+        });
+        if (this.consecutiveHeartbeatFailures >= DISCOVERY_CONSTANTS.MAX_CONSECUTIVE_HEARTBEAT_FAILURES) {
+            this.logger.error('Max heartbeat retries exceeded, stopping heartbeats', {
+                failures: this.consecutiveHeartbeatFailures,
+            });
+            if (this.heartbeatTimer) {
+                clearTimeout(this.heartbeatTimer);
+                this.heartbeatTimer = null;
+            }
+        }
+    }
+}
+//# sourceMappingURL=device-auto-discovery.service.js.map

package/dist/backend/backend/src/services/cloud/device-auto-discovery.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-auto-discovery.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/device-auto-discovery.service.ts"],"names":[],"mappings":"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"}

package/dist/backend/backend/src/services/cloud/device-identity.service.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Device Identity Service
+ *
+ * Manages a persistent device identity stored in ~/.crewly/device.json.
+ * Used by the relay auto-discovery system to uniquely identify this
+ * Crewly installation across sessions and restarts.
+ *
+ * @module services/cloud/device-identity.service
+ */
+/**
+ * Persistent device identity stored in ~/.crewly/device.json.
+ */
+export interface DeviceIdentity {
+    /** Unique device identifier (UUID v4) */
+    deviceId: string;
+    /** Human-readable device name (defaults to OS hostname) */
+    deviceName: string;
+    /** ISO timestamp when the identity was first created */
+    createdAt: string;
+    /** ISO timestamp of last activity */
+    lastSeenAt: string;
+}
+/**
+ * Singleton service that manages device identity for relay auto-discovery.
+ *
+ * On first run, generates a UUID and captures the OS hostname, persisting
+ * both to ~/.crewly/device.json. Subsequent calls read from disk.
+ *
+ * @example
+ * ```typescript
+ * const identity = DeviceIdentityService.getInstance();
+ * const id = await identity.getOrCreateIdentity();
+ * console.log(id.deviceId, id.deviceName);
+ * ```
+ */
+export declare class DeviceIdentityService {
+    private static instance;
+    private readonly logger;
+    private readonly crewlyHome;
+    private readonly deviceFilePath;
+    private cachedIdentity;
+    /**
+     * Creates a DeviceIdentityService instance.
+     *
+     * @param crewlyHome - Override ~/.crewly path (for testing)
+     */
+    constructor(crewlyHome?: string);
+    /**
+     * Get the singleton instance.
+     *
+     * @returns DeviceIdentityService instance
+     */
+    static getInstance(): DeviceIdentityService;
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance(): void;
+    /**
+     * Get or create the device identity.
+     * Reads from ~/.crewly/device.json if it exists, otherwise creates
+     * a new identity with a fresh UUID and the OS hostname.
+     *
+     * @returns The device identity
+     */
+    getOrCreateIdentity(): Promise<DeviceIdentity>;
+    /**
+     * Update the lastSeenAt timestamp on the persisted identity.
+     */
+    updateLastSeen(): Promise<void>;
+    /**
+     * Get the device ID string.
+     *
+     * @returns The device UUID
+     */
+    getDeviceId(): Promise<string>;
+    /**
+     * Get the device name string.
+     *
+     * @returns The device hostname
+     */
+    getDeviceName(): Promise<string>;
+    /**
+     * Write identity to disk, ensuring the directory exists.
+     *
+     * @param identity - The identity to persist
+     */
+    private persistIdentity;
+}
+//# sourceMappingURL=device-identity.service.d.ts.map

package/dist/backend/backend/src/services/cloud/device-identity.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-identity.service.d.ts","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/device-identity.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AASH;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,yCAAyC;IACzC,QAAQ,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,UAAU,EAAE,MAAM,CAAC;CACpB;AAKD;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAsC;IAC7D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,cAAc,CAA+B;IAErD;;;;OAIG;gBACS,UAAU,CAAC,EAAE,MAAM;IAM/B;;;;OAIG;IACH,MAAM,CAAC,WAAW,IAAI,qBAAqB;IAO3C;;OAEG;IACH,MAAM,CAAC,aAAa,IAAI,IAAI;IAI5B;;;;;;OAMG;IACG,mBAAmB,IAAI,OAAO,CAAC,cAAc,CAAC;IAiCpD;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAOrC;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,MAAM,CAAC;IAKpC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAKtC;;;;OAIG;YACW,eAAe;CAa9B"}

package/dist/backend/backend/src/services/cloud/device-identity.service.js

@@ -0,0 +1,148 @@
+/**
+ * Device Identity Service
+ *
+ * Manages a persistent device identity stored in ~/.crewly/device.json.
+ * Used by the relay auto-discovery system to uniquely identify this
+ * Crewly installation across sessions and restarts.
+ *
+ * @module services/cloud/device-identity.service
+ */
+import { readFile, writeFile, mkdir } from 'fs/promises';
+import { existsSync } from 'fs';
+import { join } from 'path';
+import { homedir, hostname } from 'os';
+import { v4 as uuidv4 } from 'uuid';
+import { LoggerService } from '../core/logger.service.js';
+/** Path to device identity file relative to ~/.crewly/ */
+const DEVICE_FILE = 'device.json';
+/**
+ * Singleton service that manages device identity for relay auto-discovery.
+ *
+ * On first run, generates a UUID and captures the OS hostname, persisting
+ * both to ~/.crewly/device.json. Subsequent calls read from disk.
+ *
+ * @example
+ * ```typescript
+ * const identity = DeviceIdentityService.getInstance();
+ * const id = await identity.getOrCreateIdentity();
+ * console.log(id.deviceId, id.deviceName);
+ * ```
+ */
+export class DeviceIdentityService {
+    static instance = null;
+    logger;
+    crewlyHome;
+    deviceFilePath;
+    cachedIdentity = null;
+    /**
+     * Creates a DeviceIdentityService instance.
+     *
+     * @param crewlyHome - Override ~/.crewly path (for testing)
+     */
+    constructor(crewlyHome) {
+        this.logger = LoggerService.getInstance().createComponentLogger('DeviceIdentityService');
+        this.crewlyHome = crewlyHome || join(homedir(), '.crewly');
+        this.deviceFilePath = join(this.crewlyHome, DEVICE_FILE);
+    }
+    /**
+     * Get the singleton instance.
+     *
+     * @returns DeviceIdentityService instance
+     */
+    static getInstance() {
+        if (!DeviceIdentityService.instance) {
+            DeviceIdentityService.instance = new DeviceIdentityService();
+        }
+        return DeviceIdentityService.instance;
+    }
+    /**
+     * Reset the singleton (for testing).
+     */
+    static resetInstance() {
+        DeviceIdentityService.instance = null;
+    }
+    /**
+     * Get or create the device identity.
+     * Reads from ~/.crewly/device.json if it exists, otherwise creates
+     * a new identity with a fresh UUID and the OS hostname.
+     *
+     * @returns The device identity
+     */
+    async getOrCreateIdentity() {
+        if (this.cachedIdentity) {
+            return this.cachedIdentity;
+        }
+        try {
+            if (existsSync(this.deviceFilePath)) {
+                const content = await readFile(this.deviceFilePath, 'utf-8');
+                const identity = JSON.parse(content);
+                this.cachedIdentity = identity;
+                this.logger.debug('Loaded device identity from disk', { deviceId: identity.deviceId });
+                return identity;
+            }
+        }
+        catch (error) {
+            this.logger.warn('Failed to read device identity, creating new one', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+        }
+        // Create new identity
+        const identity = {
+            deviceId: uuidv4(),
+            deviceName: hostname(),
+            createdAt: new Date().toISOString(),
+            lastSeenAt: new Date().toISOString(),
+        };
+        await this.persistIdentity(identity);
+        this.cachedIdentity = identity;
+        this.logger.info('Created new device identity', { deviceId: identity.deviceId, deviceName: identity.deviceName });
+        return identity;
+    }
+    /**
+     * Update the lastSeenAt timestamp on the persisted identity.
+     */
+    async updateLastSeen() {
+        const identity = await this.getOrCreateIdentity();
+        identity.lastSeenAt = new Date().toISOString();
+        await this.persistIdentity(identity);
+        this.logger.debug('Updated lastSeenAt', { deviceId: identity.deviceId });
+    }
+    /**
+     * Get the device ID string.
+     *
+     * @returns The device UUID
+     */
+    async getDeviceId() {
+        const identity = await this.getOrCreateIdentity();
+        return identity.deviceId;
+    }
+    /**
+     * Get the device name string.
+     *
+     * @returns The device hostname
+     */
+    async getDeviceName() {
+        const identity = await this.getOrCreateIdentity();
+        return identity.deviceName;
+    }
+    /**
+     * Write identity to disk, ensuring the directory exists.
+     *
+     * @param identity - The identity to persist
+     */
+    async persistIdentity(identity) {
+        try {
+            if (!existsSync(this.crewlyHome)) {
+                await mkdir(this.crewlyHome, { recursive: true });
+            }
+            await writeFile(this.deviceFilePath, JSON.stringify(identity, null, 2), 'utf-8');
+        }
+        catch (error) {
+            this.logger.error('Failed to persist device identity', {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=device-identity.service.js.map

package/dist/backend/backend/src/services/cloud/device-identity.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"device-identity.service.js","sourceRoot":"","sources":["../../../../../../backend/src/services/cloud/device-identity.service.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,IAAI,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AACvC,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AACpC,OAAO,EAAE,aAAa,EAAwB,MAAM,2BAA2B,CAAC;AAgBhF,0DAA0D;AAC1D,MAAM,WAAW,GAAG,aAAa,CAAC;AAElC;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAqB;IACxB,MAAM,CAAC,QAAQ,GAAiC,IAAI,CAAC;IAC5C,MAAM,CAAkB;IACxB,UAAU,CAAS;IACnB,cAAc,CAAS;IAChC,cAAc,GAA0B,IAAI,CAAC;IAErD;;;;OAIG;IACH,YAAY,UAAmB;QAC7B,IAAI,CAAC,MAAM,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC,qBAAqB,CAAC,uBAAuB,CAAC,CAAC;QACzF,IAAI,CAAC,UAAU,GAAG,UAAU,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;QAC3D,IAAI,CAAC,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC;IAC3D,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,CAAC;YACpC,qBAAqB,CAAC,QAAQ,GAAG,IAAI,qBAAqB,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,qBAAqB,CAAC,QAAQ,CAAC;IACxC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,aAAa;QAClB,qBAAqB,CAAC,QAAQ,GAAG,IAAI,CAAC;IACxC,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,mBAAmB;QACvB,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,cAAc,CAAC;QAC7B,CAAC;QAED,IAAI,CAAC;YACH,IAAI,UAAU,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBACpC,MAAM,OAAO,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,CAAC;gBAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAmB,CAAC;gBACvD,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;gBAC/B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;gBACvF,OAAO,QAAQ,CAAC;YAClB,CAAC;QACH,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kDAAkD,EAAE;gBACnE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;QAED,sBAAsB;QACtB,MAAM,QAAQ,GAAmB;YAC/B,QAAQ,EAAE,MAAM,EAAE;YAClB,UAAU,EAAE,QAAQ,EAAE;YACtB,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;SACrC,CAAC;QAEF,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,QAAQ,CAAC;QAC/B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;QAClH,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,cAAc;QAClB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAClD,QAAQ,CAAC,UAAU,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;QAC/C,MAAM,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QACrC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oBAAoB,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3E,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,WAAW;QACf,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC,QAAQ,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa;QACjB,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,mBAAmB,EAAE,CAAC;QAClD,OAAO,QAAQ,CAAC,UAAU,CAAC;IAC7B,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,eAAe,CAAC,QAAwB;QACpD,IAAI,CAAC;YACH,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC;gBACjC,MAAM,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,CAAC;YACD,MAAM,SAAS,CAAC,IAAI,CAAC,cAAc,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;QACnF,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,mCAAmC,EAAE;gBACrD,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC9D,CAAC,CAAC;YACH,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC"}