@waiaas/daemon 2.0.0-rc.1

package/dist/infrastructure/version/version-check-service.js

@@ -0,0 +1,92 @@
+/**
+ * VersionCheckService - checks npm registry for latest @waiaas/cli version.
+ *
+ * Stores results in key_value_store for consumption by Health API and CLI.
+ * All errors are caught and logged (fail-soft: never blocks daemon startup).
+ *
+ * Keys stored:
+ *   - version_check_latest: latest version string from npm
+ *   - version_check_checked_at: Unix seconds of last successful check
+ */
+import { createRequire } from 'node:module';
+import semver from 'semver';
+const require = createRequire(import.meta.url);
+const { version: CURRENT_VERSION } = require('../../../package.json');
+const NPM_REGISTRY_URL = 'https://registry.npmjs.org/@waiaas/cli';
+const FETCH_TIMEOUT_MS = 5000;
+export class VersionCheckService {
+    sqlite;
+    constructor(sqlite) {
+        this.sqlite = sqlite;
+    }
+    /**
+     * Fetch latest version from npm registry and store in key_value_store.
+     *
+     * @returns { latest, current } - latest is null if check failed
+     */
+    async check() {
+        try {
+            const response = await fetch(NPM_REGISTRY_URL, {
+                signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+                headers: {
+                    'User-Agent': `waiaas/${CURRENT_VERSION}`,
+                    Accept: 'application/json',
+                },
+            });
+            if (!response.ok) {
+                console.warn(`VersionCheck: registry returned ${response.status}`);
+                return { latest: null, current: CURRENT_VERSION };
+            }
+            const data = (await response.json());
+            const latest = data?.['dist-tags']?.latest;
+            if (!latest || !semver.valid(latest)) {
+                console.warn('VersionCheck: invalid version from registry');
+                return { latest: null, current: CURRENT_VERSION };
+            }
+            // Store in key_value_store
+            const now = Math.floor(Date.now() / 1000);
+            const upsert = this.sqlite.prepare('INSERT OR REPLACE INTO key_value_store (key, value, updated_at) VALUES (?, ?, ?)');
+            upsert.run('version_check_latest', latest, now);
+            upsert.run('version_check_checked_at', String(now), now);
+            if (semver.gt(latest, CURRENT_VERSION)) {
+                console.log(`VersionCheck: update available ${CURRENT_VERSION} -> ${latest}`);
+            }
+            return { latest, current: CURRENT_VERSION };
+        }
+        catch (err) {
+            console.warn('VersionCheck: check failed:', err.message ?? err);
+            return { latest: null, current: CURRENT_VERSION };
+        }
+    }
+    /**
+     * Get the latest known version from key_value_store.
+     * Returns null if no check has been performed yet.
+     */
+    getLatest() {
+        try {
+            const row = this.sqlite
+                .prepare("SELECT value FROM key_value_store WHERE key = 'version_check_latest'")
+                .get();
+            return row?.value ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Get the timestamp of the last successful version check.
+     * Returns null if no check has been performed yet.
+     */
+    getCheckedAt() {
+        try {
+            const row = this.sqlite
+                .prepare("SELECT value FROM key_value_store WHERE key = 'version_check_checked_at'")
+                .get();
+            return row ? Number(row.value) : null;
+        }
+        catch {
+            return null;
+        }
+    }
+}
+//# sourceMappingURL=version-check-service.js.map

package/dist/infrastructure/version/version-check-service.js.map

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

package/dist/lifecycle/daemon.d.ts

@@ -0,0 +1,103 @@
+/**
+ * DaemonLifecycle - orchestrates daemon startup (6 steps) and shutdown (10 steps).
+ *
+ * Startup sequence (doc 28 section 2):
+ *   1. Environment validation + config + flock (5s timeout, fail-fast)
+ *   2. Database initialization (30s timeout, fail-fast)
+ *   3. Keystore unlock (30s timeout, fail-fast)
+ *   4. Adapter initialization (10s, fail-soft)
+ *      4c-6. WalletConnect service (fail-soft)
+ *   5. HTTP server start (5s, fail-fast)
+ *   6. Background workers + PID (no timeout, fail-soft)
+ *
+ * Shutdown sequence (doc 28 section 3):
+ *   1. Set isShuttingDown, start force timer, log signal
+ *   2-4. HTTP server close
+ *   5. In-flight signing -- STUB (Phase 50-04)
+ *   6. Pending queue persistence -- STUB (Phase 50-04)
+ *   6a. Stop TelegramBot, WcSessionService, AutoStop, BalanceMonitor
+ *   6b. Remove all EventBus listeners
+ *   7. workers.stopAll()
+ *   8. WAL checkpoint(TRUNCATE)
+ *   9. keyStore.lockAll()
+ *   10. sqlite.close(), unlink PID, close lockFd, process.exit(0)
+ *
+ * @see docs/28-daemon-lifecycle-cli.md
+ */
+import type { BetterSQLite3Database } from 'drizzle-orm/better-sqlite3';
+import type { DaemonConfig } from '../infrastructure/config/index.js';
+import type * as schema from '../infrastructure/database/schema.js';
+/**
+ * Race a promise against a timeout. Rejects with WAIaaSError on timeout.
+ */
+declare function withTimeout<T>(promise: Promise<T>, ms: number, errorCode: string): Promise<T>;
+export { withTimeout };
+export declare class DaemonLifecycle {
+    private _isShuttingDown;
+    private sqlite;
+    private _db;
+    private keyStore;
+    private masterPassword;
+    private adapterPool;
+    private httpServer;
+    private workers;
+    private releaseLock;
+    private pidPath;
+    private _config;
+    private forceTimer;
+    private delayQueue;
+    private approvalWorkflow;
+    private jwtSecretManager;
+    private masterPasswordHash;
+    private notificationService;
+    private _settingsService;
+    private priceOracle;
+    private actionProviderRegistry;
+    private apiKeyStore;
+    private forexRateService;
+    private eventBus;
+    private killSwitchService;
+    private autoStopService;
+    private balanceMonitorService;
+    private telegramBotService;
+    private telegramBotRef;
+    private wcSessionService;
+    private wcServiceRef;
+    private wcSigningBridge;
+    private _versionCheckService;
+    /** Whether shutdown has been initiated. */
+    get isShuttingDown(): boolean;
+    /** Current config (available after start). */
+    get config(): DaemonConfig | null;
+    /** Drizzle database instance (available after start, used by route handlers). */
+    get db(): BetterSQLite3Database<typeof schema> | null;
+    /** SettingsService instance (available after Step 2, used by route handlers). */
+    get settingsService(): import('../infrastructure/settings/settings-service.js').SettingsService | null;
+    /** VersionCheckService instance (available after Step 6, used by Health endpoint). */
+    get versionCheckService(): import('../infrastructure/version/version-check-service.js').VersionCheckService | null;
+    /**
+     * 6-step startup sequence with per-step timeouts and 90s overall cap.
+     */
+    start(dataDir: string, masterPassword: string): Promise<void>;
+    private _startInternal;
+    /**
+     * 10-step graceful shutdown cascade.
+     */
+    shutdown(signal: string): Promise<void>;
+    /**
+     * Re-enter the pipeline at stage5 for a delay-expired transaction.
+     *
+     * Called by the delay-expired BackgroundWorker when processExpired()
+     * returns transactions whose cooldown has elapsed.
+     *
+     * @param txId - Transaction ID to execute
+     * @param walletId - Wallet that owns the transaction
+     */
+    private executeFromStage5;
+    /**
+     * Acquire an exclusive daemon lock to prevent multiple instances.
+     * Uses proper-lockfile for cross-platform support.
+     */
+    private acquireDaemonLock;
+}
+//# sourceMappingURL=daemon.d.ts.map

package/dist/lifecycle/daemon.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/lifecycle/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAYxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AAEtE,OAAO,KAAK,KAAK,MAAM,MAAM,sCAAsC,CAAC;AA+BpE;;GAEG;AACH,iBAAS,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAqBtF;AAGD,OAAO,EAAE,WAAW,EAAE,CAAC;AAMvB,qBAAa,eAAe;IAC1B,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,GAAG,CAAqD;IAChE,OAAO,CAAC,QAAQ,CAA8B;IAC9C,OAAO,CAAC,cAAc,CAAM;IAC5B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,UAAU,CAAsC;IACxD,OAAO,CAAC,OAAO,CAAkC;IACjD,OAAO,CAAC,WAAW,CAAsC;IACzD,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,OAAO,CAA6B;IAC5C,OAAO,CAAC,UAAU,CAA8C;IAChE,OAAO,CAAC,UAAU,CAA2B;IAC7C,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,kBAAkB,CAAM;IAChC,OAAO,CAAC,mBAAmB,CAAuF;IAClH,OAAO,CAAC,gBAAgB,CAAyF;IACjH,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,sBAAsB,CAAsG;IACpI,OAAO,CAAC,WAAW,CAAgF;IACnG,OAAO,CAAC,gBAAgB,CAAkC;IAC1D,OAAO,CAAC,QAAQ,CAA4B;IAC5C,OAAO,CAAC,iBAAiB,CAAkC;IAC3D,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,qBAAqB,CAAsC;IACnE,OAAO,CAAC,kBAAkB,CAAgG;IAC1H,OAAO,CAAC,cAAc,CAA0H;IAChJ,OAAO,CAAC,gBAAgB,CAA6E;IACrG,OAAO,CAAC,YAAY,CAA+E;IACnG,OAAO,CAAC,eAAe,CAA2E;IAClG,OAAO,CAAC,oBAAoB,CAAiG;IAE7H,2CAA2C;IAC3C,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,8CAA8C;IAC9C,IAAI,MAAM,IAAI,YAAY,GAAG,IAAI,CAEhC;IAED,iFAAiF;IACjF,IAAI,EAAE,IAAI,qBAAqB,CAAC,OAAO,MAAM,CAAC,GAAG,IAAI,CAEpD;IAED,iFAAiF;IACjF,IAAI,eAAe,IAAI,OAAO,gDAAgD,EAAE,eAAe,GAAG,IAAI,CAErG;IAED,sFAAsF;IACtF,IAAI,mBAAmB,IAAI,OAAO,oDAAoD,EAAE,mBAAmB,GAAG,IAAI,CAEjH;IAED;;OAEG;IACG,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAKrD,cAAc;IAuoB5B;;OAEG;IACG,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4I7C;;;;;;;;OAQG;YACW,iBAAiB;IAwF/B;;;OAGG;YACW,iBAAiB;CAyBhC"}