@srouterhq/server 0.0.0-stage → 0.9.0

package/dist/routes/status.js

@@ -0,0 +1,214 @@
+import { Router } from 'express';
+import { getDb, getUnifiedApiKey } from '../db/index.js';
+import { isEncryptionKeyInitialized } from '../lib/crypto.js';
+import { extractApiToken, timingSafeStringEqual } from './proxy.js';
+import { getProvider } from '../providers/index.js';
+import { getSoonestCooldownExpiry } from '../services/ratelimit.js';
+import { getQuotaStateForKeys } from '../services/provider-quota.js';
+import { getQuotaForecast, LOW_BALANCE_THRESHOLD, LOW_BALANCE_ABSOLUTE, LOW_BALANCE_ABSOLUTE_MIN_LIMIT, } from '../services/quota-forecast.js';
+import { openapiSpec } from '../docs/openapi.js';
+// Machine-readable operational endpoints for meta-gateways / orchestrators that
+// run this proxy as one upstream lane (LibreChat, LiteLLM Proxy, OmniRoute — see
+// #433). `/livez` and `/readyz` are unauthenticated so a load balancer can probe
+// them; `/v1/providers` sits behind the same unified API key as the rest of /v1.
+export const statusRouter = Router();
+export const providersRouter = Router();
+// Cheap "is the SQLite connection answering" probe. getDb() throws before initDb
+// has run, and prepare/get throws if the handle is closed — either way the
+// server is not serviceable, which is exactly the /livez and /readyz 503 signal.
+function isDbReachable() {
+    try {
+        getDb().prepare('SELECT 1').get();
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// GET /livez — liveness. 200 when the process can serve at all: the DB answers
+// and the encryption key is loaded (without it, stored provider keys can't be
+// decrypted, so no request can be routed). 503 otherwise.
+statusRouter.get('/livez', (_req, res) => {
+    const db = isDbReachable();
+    const encryptionKey = isEncryptionKeyInitialized();
+    const uptime_s = Math.floor(process.uptime());
+    const version = openapiSpec.info.version;
+    if (!db || !encryptionKey) {
+        res.status(503).json({
+            status: 'unavailable',
+            version,
+            uptime_s,
+            checks: { db, encryption_key: encryptionKey },
+        });
+        return;
+    }
+    res.json({ status: 'ok', version, uptime_s });
+});
+// GET /readyz — readiness. 200 when at least one upstream is serviceable right
+// now (an enabled key whose status is healthy or not-yet-probed). 503 with a
+// machine-readable reason otherwise, so a meta-gateway can skip this instance
+// instead of eating a failover on every call.
+statusRouter.get('/readyz', (_req, res) => {
+    if (!isDbReachable()) {
+        res.status(503).json({ status: 'unavailable', reason: 'db_unreachable' });
+        return;
+    }
+    const db = getDb();
+    const agg = db.prepare(`
+    SELECT
+      COUNT(*) AS enabled_keys,
+      COUNT(DISTINCT CASE WHEN status IN ('healthy', 'unknown') THEN platform END) AS ready_upstreams
+    FROM api_keys
+    WHERE enabled = 1
+  `).get();
+    const readyUpstreams = agg.ready_upstreams ?? 0;
+    if (readyUpstreams > 0) {
+        res.json({ status: 'ok', ready_upstreams: readyUpstreams });
+        return;
+    }
+    // Distinguish "nothing configured" from "everything cooling down" from
+    // "everything unhealthy" so the caller can act on the specific reason.
+    let reason;
+    if ((agg.enabled_keys ?? 0) === 0) {
+        reason = 'no_upstreams_configured';
+    }
+    else if (getSoonestCooldownExpiry() != null) {
+        reason = 'all_upstreams_rate_limited';
+    }
+    else {
+        reason = 'all_upstreams_unhealthy';
+    }
+    res.status(503).json({ status: 'unavailable', reason });
+});
+// GET /v1/providers — aggregate per-upstream state a smart router needs to
+// decide "route here or skip", with no key material and no PII. Behind the
+// unified API key (like the rest of /v1); mounted before the proxy rate limiter
+// so status polling doesn't draw down a caller's request budget.
+providersRouter.get('/providers', (req, res) => {
+    const token = extractApiToken(req);
+    const unifiedKey = getUnifiedApiKey();
+    if (!token || !timingSafeStringEqual(token, unifiedKey)) {
+        res.status(401).json({ error: { message: 'Invalid API key', type: 'authentication_error' } });
+        return;
+    }
+    const db = getDb();
+    // Per-platform key-status rollup (only enabled keys count toward serviceability).
+    const platformRows = db.prepare(`
+    SELECT
+      platform,
+      SUM(CASE WHEN enabled = 1 THEN 1 ELSE 0 END) AS enabled_keys,
+      SUM(CASE WHEN enabled = 1 AND status = 'healthy' THEN 1 ELSE 0 END) AS healthy_keys,
+      SUM(CASE WHEN enabled = 1 AND status = 'unknown' THEN 1 ELSE 0 END) AS unknown_keys,
+      SUM(CASE WHEN enabled = 1 AND status = 'invalid' THEN 1 ELSE 0 END) AS invalid_keys,
+      SUM(CASE WHEN enabled = 1 AND status = 'error' THEN 1 ELSE 0 END) AS error_keys
+    FROM api_keys
+    GROUP BY platform
+  `).all();
+    // Active cooldowns (rate limiting) rolled up to the platform, with the soonest
+    // resume time. rate_limit_cooldowns is per (platform, model, key); the MIN is
+    // the earliest moment any of that platform's routes frees up.
+    const now = Date.now();
+    const cooldownRows = db.prepare(`
+    SELECT platform, MIN(expires_at_ms) AS resume_ms
+    FROM rate_limit_cooldowns
+    WHERE expires_at_ms > ?
+    GROUP BY platform
+  `).all(now);
+    const resumeByPlatform = new Map(cooldownRows.map(r => [r.platform, r.resume_ms]));
+    // Most recent probe error per platform (enabled keys, newest first).
+    const errorRows = db.prepare(`
+    SELECT platform, last_health_error
+    FROM api_keys
+    WHERE enabled = 1 AND last_health_error IS NOT NULL
+    ORDER BY last_checked_at DESC
+  `).all();
+    const lastErrorByPlatform = new Map();
+    for (const row of errorRows) {
+        if (!lastErrorByPlatform.has(row.platform)) {
+            lastErrorByPlatform.set(row.platform, row.last_health_error);
+        }
+    }
+    // Best-effort request-quota headroom from observed quota state. Only surfaced
+    // when a provider actually reported a `requests` limit; absent otherwise.
+    const requestsRemainingByPlatform = new Map();
+    for (const q of getQuotaStateForKeys()) {
+        if (q.metric !== 'requests' || typeof q.limit !== 'number' || q.limit <= 0)
+            continue;
+        if (typeof q.remaining !== 'number')
+            continue;
+        const pct = Math.max(0, Math.min(100, Math.round((q.remaining / q.limit) * 100)));
+        const prev = requestsRemainingByPlatform.get(q.platform);
+        // Keep the tightest (lowest) headroom seen for the platform.
+        if (prev === undefined || pct < prev)
+            requestsRemainingByPlatform.set(q.platform, pct);
+    }
+    const counts = { healthy: 0, rate_limited: 0, invalid: 0, unknown: 0 };
+    const providers = platformRows
+        .filter(p => p.enabled_keys > 0)
+        .map(p => {
+        const onCooldown = resumeByPlatform.has(p.platform);
+        let status;
+        if (p.healthy_keys > 0 && !onCooldown) {
+            status = 'healthy';
+        }
+        else if (onCooldown) {
+            status = 'rate_limited';
+        }
+        else if (p.unknown_keys > 0) {
+            status = 'unknown';
+        }
+        else if (p.invalid_keys > 0 || p.error_keys > 0) {
+            status = 'invalid';
+        }
+        else {
+            status = 'unknown';
+        }
+        counts[status] += 1;
+        const provider = getProvider(p.platform);
+        const entry = {
+            platform: p.platform,
+            name: provider?.name ?? p.platform,
+            status,
+            keys: p.enabled_keys,
+        };
+        if (status === 'rate_limited') {
+            const resumeMs = resumeByPlatform.get(p.platform);
+            if (resumeMs != null)
+                entry.resume_at = new Date(resumeMs).toISOString();
+        }
+        if (status === 'invalid') {
+            const lastError = lastErrorByPlatform.get(p.platform);
+            if (lastError)
+                entry.last_error = lastError;
+        }
+        const requestsRemaining = requestsRemainingByPlatform.get(p.platform);
+        if (requestsRemaining != null)
+            entry.requests_remaining_pct = requestsRemaining;
+        return entry;
+    });
+    res.json({ providers, counts });
+});
+// GET /quota-forecast — per-pool daily headroom + low-balance warning (#1104).
+// Machine-readable sibling of /v1/providers: same unified-key auth, no key
+// material, no PII. A meta-gateway can gate its own routing on `low_balance`
+// BEFORE spending a request that would 429, and know `seconds_until_reset` for
+// "the window resets soon, hold off" scheduling.
+providersRouter.get('/quota-forecast', (req, res) => {
+    const token = extractApiToken(req);
+    const unifiedKey = getUnifiedApiKey();
+    if (!token || !timingSafeStringEqual(token, unifiedKey)) {
+        res.status(401).json({ error: { message: 'Invalid API key', type: 'authentication_error' } });
+        return;
+    }
+    const forecast = getQuotaForecast();
+    res.json({
+        generated_at: new Date().toISOString(),
+        low_balance_threshold: {
+            pct: LOW_BALANCE_THRESHOLD,
+            absolute: LOW_BALANCE_ABSOLUTE,
+            absolute_min_limit: LOW_BALANCE_ABSOLUTE_MIN_LIMIT,
+        },
+        pools: forecast,
+    });
+});
+//# sourceMappingURL=status.js.map

package/dist/routes/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../src/routes/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAGjC,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AACpE,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EACL,gBAAgB,EAChB,qBAAqB,EACrB,oBAAoB,EACpB,8BAA8B,GAC/B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,gFAAgF;AAChF,iFAAiF;AACjF,iFAAiF;AACjF,iFAAiF;AAEjF,MAAM,CAAC,MAAM,YAAY,GAAG,MAAM,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,eAAe,GAAG,MAAM,EAAE,CAAC;AAExC,iFAAiF;AACjF,2EAA2E;AAC3E,iFAAiF;AACjF,SAAS,aAAa;IACpB,IAAI,CAAC;QACH,KAAK,EAAE,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,EAAE,CAAC;QAClC,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,8EAA8E;AAC9E,0DAA0D;AAC1D,YAAY,CAAC,GAAG,CAAC,QAAQ,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;IAC1D,MAAM,EAAE,GAAG,aAAa,EAAE,CAAC;IAC3B,MAAM,aAAa,GAAG,0BAA0B,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,WAAW,CAAC,IAAI,CAAC,OAAO,CAAC;IAEzC,IAAI,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1B,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;YACnB,MAAM,EAAE,aAAa;YACrB,OAAO;YACP,QAAQ;YACR,MAAM,EAAE,EAAE,EAAE,EAAE,cAAc,EAAE,aAAa,EAAE;SAC9C,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AAChD,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,6EAA6E;AAC7E,8EAA8E;AAC9E,8CAA8C;AAC9C,YAAY,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,IAAa,EAAE,GAAa,EAAE,EAAE;IAC3D,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACrB,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC;QAC1E,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IACnB,MAAM,GAAG,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;GAMtB,CAAC,CAAC,GAAG,EAAuD,CAAC;IAE9D,MAAM,cAAc,GAAG,GAAG,CAAC,eAAe,IAAI,CAAC,CAAC;IAChD,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,eAAe,EAAE,cAAc,EAAE,CAAC,CAAC;QAC5D,OAAO;IACT,CAAC;IAED,uEAAuE;IACvE,uEAAuE;IACvE,IAAI,MAAc,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC;QAClC,MAAM,GAAG,yBAAyB,CAAC;IACrC,CAAC;SAAM,IAAI,wBAAwB,EAAE,IAAI,IAAI,EAAE,CAAC;QAC9C,MAAM,GAAG,4BAA4B,CAAC;IACxC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,yBAAyB,CAAC;IACrC,CAAC;IAED,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,EAAE,CAAC,CAAC;AAC1D,CAAC,CAAC,CAAC;AAWH,2EAA2E;AAC3E,2EAA2E;AAC3E,gFAAgF;AAChF,iEAAiE;AACjE,eAAe,CAAC,GAAG,CAAC,YAAY,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IAChE,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAC9F,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,KAAK,EAAE,CAAC;IAEnB,kFAAkF;IAClF,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;;;;GAU/B,CAAC,CAAC,GAAG,EAAsB,CAAC;IAE7B,+EAA+E;IAC/E,8EAA8E;IAC9E,8DAA8D;IAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,YAAY,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;GAK/B,CAAC,CAAC,GAAG,CAAC,GAAG,CAAmD,CAAC;IAC9D,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAEnF,qEAAqE;IACrE,MAAM,SAAS,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;GAK5B,CAAC,CAAC,GAAG,EAA4D,CAAC;IACnE,MAAM,mBAAmB,GAAG,IAAI,GAAG,EAAkB,CAAC;IACtD,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3C,mBAAmB,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAC;QAC/D,CAAC;IACH,CAAC;IAED,8EAA8E;IAC9E,0EAA0E;IAC1E,MAAM,2BAA2B,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9D,KAAK,MAAM,CAAC,IAAI,oBAAoB,EAAE,EAAE,CAAC;QACvC,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC;YAAE,SAAS;QACrF,IAAI,OAAO,CAAC,CAAC,SAAS,KAAK,QAAQ;YAAE,SAAS;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;QAClF,MAAM,IAAI,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzD,6DAA6D;QAC7D,IAAI,IAAI,KAAK,SAAS,IAAI,GAAG,GAAG,IAAI;YAAE,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACzF,CAAC;IAED,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IAEvE,MAAM,SAAS,GAAG,YAAY;SAC3B,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;SAC/B,GAAG,CAAC,CAAC,CAAC,EAAE;QACP,MAAM,UAAU,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACpD,IAAI,MAA0D,CAAC;QAC/D,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,CAAC;YACtC,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,UAAU,EAAE,CAAC;YACtB,MAAM,GAAG,cAAc,CAAC;QAC1B,CAAC;aAAM,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;YAClD,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,SAAS,CAAC;QACrB,CAAC;QACD,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAEpB,MAAM,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,QAAoB,CAAC,CAAC;QACrD,MAAM,KAAK,GAA4B;YACrC,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,IAAI,EAAE,QAAQ,EAAE,IAAI,IAAI,CAAC,CAAC,QAAQ;YAClC,MAAM;YACN,IAAI,EAAE,CAAC,CAAC,YAAY;SACrB,CAAC;QACF,IAAI,MAAM,KAAK,cAAc,EAAE,CAAC;YAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAClD,IAAI,QAAQ,IAAI,IAAI;gBAAE,KAAK,CAAC,SAAS,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QAC3E,CAAC;QACD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,SAAS,GAAG,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YACtD,IAAI,SAAS;gBAAE,KAAK,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9C,CAAC;QACD,MAAM,iBAAiB,GAAG,2BAA2B,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACtE,IAAI,iBAAiB,IAAI,IAAI;YAAE,KAAK,CAAC,sBAAsB,GAAG,iBAAiB,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEL,GAAG,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,+EAA+E;AAC/E,2EAA2E;AAC3E,6EAA6E;AAC7E,+EAA+E;AAC/E,iDAAiD;AACjD,eAAe,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC,GAAY,EAAE,GAAa,EAAE,EAAE;IACrE,MAAM,KAAK,GAAG,eAAe,CAAC,GAAG,CAAC,CAAC;IACnC,MAAM,UAAU,GAAG,gBAAgB,EAAE,CAAC;IACtC,IAAI,CAAC,KAAK,IAAI,CAAC,qBAAqB,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,sBAAsB,EAAE,EAAE,CAAC,CAAC;QAC9F,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IACpC,GAAG,CAAC,IAAI,CAAC;QACP,YAAY,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACtC,qBAAqB,EAAE;YACrB,GAAG,EAAE,qBAAqB;YAC1B,QAAQ,EAAE,oBAAoB;YAC9B,kBAAkB,EAAE,8BAA8B;SACnD;QACD,KAAK,EAAE,QAAQ;KAChB,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/routes/update.d.ts

@@ -0,0 +1,31 @@
+import { Router } from 'express';
+/**
+ * Settings-table key for the dashboard's automatic release check (#782).
+ * Absent or anything other than '1' means off, so an install that has never
+ * been told otherwise never phones GitHub on its own. The manual checker above
+ * is a separate surface and stays available regardless.
+ */
+export declare const UPDATE_CHECK_SETTING = "update_check_enabled";
+export declare function isAutoUpdateCheckEnabled(): boolean;
+type ExecFile = (file: string, args: string[], options: {
+    cwd: string;
+    encoding: 'utf8';
+    timeout: number;
+}) => Promise<{
+    stdout: string | Buffer;
+}>;
+export interface UpdateRouterOptions {
+    fetch?: typeof globalThis.fetch;
+    execFile?: ExecFile;
+    env?: NodeJS.ProcessEnv;
+    cwd?: string;
+    now?: () => number;
+    logger?: Pick<Console, 'error'>;
+    version?: () => string | null;
+    /** Reads the opt-in flag; injectable so the endpoint is testable without a DB. */
+    autoCheckEnabled?: () => boolean;
+}
+export declare function createUpdateRouter(options?: UpdateRouterOptions): Router;
+export declare const updateRouter: Router;
+export {};
+//# sourceMappingURL=update.d.ts.map

package/dist/routes/update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"update.d.ts","sourceRoot":"","sources":["../../src/routes/update.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AA+DjC;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,yBAAyB,CAAC;AAE3D,wBAAgB,wBAAwB,IAAI,OAAO,CAElD;AAeD,KAAK,QAAQ,GAAG,CACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KACxD,OAAO,CAAC;IAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC,CAAC;AAE1C,MAAM,WAAW,mBAAmB;IAClC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,CAAC,EAAE,MAAM,MAAM,GAAG,IAAI,CAAC;IAC9B,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC;CAClC;AA+ND,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,MAAM,CA6T5E;AAED,eAAO,MAAM,YAAY,QAAuB,CAAC"}