@winstonsayno/mcp-gateway 5.1.0 → 5.3.0

package/dist/features/edge-fleet.js

@@ -0,0 +1,121 @@
+/**
+ * Managed edge nodes (5.3): the control plane knows its edge fleet, reports config drift and pushes new config.
+ *
+ * Edges (`@winstonsayno/mcp-gateway/edge` with `sync`) pull snapshots on their own schedule. With `edgeFleet`
+ * configured the Node gateway can also *push*: it calls each edge's `POST /api/v1/edge/sync`, which makes the
+ * edge pull the current snapshot, replay queued calls and upload usage right away.
+ *
+ * ```yaml
+ * edgeFleet:
+ *   pushTimeoutMs: 10000
+ *   nodes:
+ *     - { id: cf-hkg, url: https://edge-hkg.example.workers.dev, apiKey: ${EDGE_KEY}, labels: { ring: canary } }
+ *     - { id: deno-fra, url: https://fra.example.deno.dev, apiKey: ${EDGE_KEY}, labels: { ring: stable } }
+ * ```
+ *
+ * - `GET  /admin/edge-fleet` — configured + seen edges with drift: `in-sync`, `stale` (applied an older snapshot),
+ *   `never-synced`, `unmanaged` (syncs but is not in `nodes`), `offline` (not seen for `offlineAfterMs`).
+ * - `POST /admin/edge-fleet/push` — `{ nodes?: string[], labels?: Record<string,string>, onlyDrifted?: boolean }`
+ *   → per-node result. Rolling out by ring: push `labels: { ring: canary }` first, then the rest.
+ *
+ * @module features/edge-fleet
+ */
+import { z } from 'zod';
+import { registerFeature, objectBody, badRequest } from '../gateway/features.js';
+import { buildEdgeSnapshot } from '../gateway/edge-control.js';
+export const EdgeFleetSchema = z
+    .object({
+    pushTimeoutMs: z.number().int().min(100).default(10_000),
+    offlineAfterMs: z.number().int().min(1000).default(15 * 60_000),
+    nodes: z
+        .array(z.object({ id: z.string().regex(/^[A-Za-z0-9_.:-]{1,128}$/), url: z.string().url(), apiKey: z.string().optional(), labels: z.record(z.string()).default({}) }).strict())
+        .default([]),
+})
+    .strict();
+/** Merge configured nodes with nodes seen by the control plane and classify drift. */
+export function fleetView(cfg, seen, currentEtags, now = Date.now()) {
+    const byId = new Map(seen.map((n) => [n.edgeId, n]));
+    const out = [];
+    const classify = (n, managed) => {
+        if (!n || !n.snapshotEtag)
+            return n && !managed ? 'unmanaged' : 'never-synced';
+        if (now - Date.parse(n.lastSeen) > cfg.offlineAfterMs)
+            return 'offline';
+        if (!managed)
+            return 'unmanaged';
+        return currentEtags.includes(n.snapshotEtag) ? 'in-sync' : 'stale';
+    };
+    for (const c of cfg.nodes) {
+        const n = byId.get(c.id);
+        out.push({ id: c.id, url: c.url, labels: c.labels, managed: true, drift: classify(n, true), appliedEtag: n?.snapshotEtag, lastSeen: n?.lastSeen, lastSync: n?.lastSync, queuedCalls: n?.queuedCalls ?? 0, errors: n?.errors ?? 0 });
+        byId.delete(c.id);
+    }
+    for (const n of byId.values()) {
+        out.push({ id: n.edgeId, labels: {}, managed: false, drift: classify(n, false), appliedEtag: n.snapshotEtag, lastSeen: n.lastSeen, lastSync: n.lastSync, queuedCalls: n.queuedCalls, errors: n.errors });
+    }
+    return out;
+}
+/** Which configured nodes a push targets. */
+export function selectNodes(cfg, view, sel) {
+    return cfg.nodes.filter((n) => {
+        if (sel.nodes?.length && !sel.nodes.includes(n.id))
+            return false;
+        if (sel.labels && !Object.entries(sel.labels).every(([k, v]) => n.labels[k] === v))
+            return false;
+        if (sel.onlyDrifted && view.find((v) => v.id === n.id)?.drift === 'in-sync')
+            return false;
+        return true;
+    });
+}
+/** Ask each edge to sync now. */
+export async function pushToNodes(nodes, timeoutMs, f = fetch) {
+    return Promise.all(nodes.map(async (n) => {
+        const started = Date.now();
+        try {
+            const res = await f(`${n.url.replace(/\/$/, '')}/api/v1/edge/sync`, {
+                method: 'POST',
+                headers: { 'content-type': 'application/json', ...(n.apiKey ? { authorization: `Bearer ${n.apiKey}` } : {}) },
+                body: '{}',
+                signal: AbortSignal.timeout(timeoutMs),
+            });
+            const body = (await res.json().catch(() => ({})));
+            return { id: n.id, ok: res.ok, status: res.status, ...(body.config ? { config: body.config } : {}), ...(!res.ok ? { error: body.message ?? `HTTP ${res.status}` } : {}), durationMs: Date.now() - started };
+        }
+        catch (e) {
+            return { id: n.id, ok: false, error: e.message, durationMs: Date.now() - started };
+        }
+    }));
+}
+registerFeature({
+    id: 'edge-fleet',
+    since: '5.3.0',
+    summary: 'Managed edge nodes: fleet view with config drift, push config to edges',
+    mount: (router, ctx) => {
+        const resolve = () => EdgeFleetSchema.parse(ctx.config().edgeFleet ?? {});
+        const etags = () => [buildEdgeSnapshot(ctx.config(), ctx.tools(), false).etag, buildEdgeSnapshot(ctx.config(), ctx.tools(), true).etag];
+        router.get('/', (_req, res) => {
+            const cfg = resolve();
+            const [etag] = etags();
+            const nodes = fleetView(cfg, ctx.edgeNodes?.() ?? [], etags());
+            const counts = nodes.reduce((m, n) => ((m[n.drift] = (m[n.drift] ?? 0) + 1), m), {});
+            res.json({ etag, counts, nodes });
+        });
+        router.post('/push', async (req, res) => {
+            const b = objectBody(req, res);
+            if (!b)
+                return;
+            if (b.nodes !== undefined && !(Array.isArray(b.nodes) && b.nodes.every((x) => typeof x === 'string')))
+                return badRequest(res, '"nodes" must be an array of ids');
+            if (b.labels !== undefined && (typeof b.labels !== 'object' || b.labels === null || Array.isArray(b.labels)))
+                return badRequest(res, '"labels" must be an object');
+            const cfg = resolve();
+            if (!cfg.nodes.length)
+                return void res.status(404).json({ error: 'Not Found', message: 'no managed edge nodes (`edgeFleet.nodes`)' });
+            const view = fleetView(cfg, ctx.edgeNodes?.() ?? [], etags());
+            const targets = selectNodes(cfg, view, { nodes: b.nodes, labels: b.labels, onlyDrifted: b.onlyDrifted === true });
+            const results = await pushToNodes(targets, cfg.pushTimeoutMs);
+            res.json({ pushed: results.filter((r) => r.ok).length, failed: results.filter((r) => !r.ok).length, results });
+        });
+    },
+});
+//# sourceMappingURL=edge-fleet.js.map

package/dist/features/edge-fleet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"edge-fleet.js","sourceRoot":"","sources":["../../src/features/edge-fleet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAiB,MAAM,4BAA4B,CAAC;AAE9E,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;IACxD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC;IAC/D,KAAK,EAAE,CAAC;SACL,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,0BAA0B,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;SAC9K,OAAO,CAAC,EAAE,CAAC;CACf,CAAC;KACD,MAAM,EAAE,CAAC;AA0BZ,sFAAsF;AACtF,MAAM,UAAU,SAAS,CAAC,GAAa,EAAE,IAAgB,EAAE,YAAsB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACjG,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,MAAM,GAAG,GAAgB,EAAE,CAAC;IAC5B,MAAM,QAAQ,GAAG,CAAC,CAAuB,EAAE,OAAgB,EAAS,EAAE;QACpE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,CAAC;QAC/E,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,GAAG,CAAC,cAAc;YAAE,OAAO,SAAS,CAAC;QACxE,IAAI,CAAC,OAAO;YAAE,OAAO,WAAW,CAAC;QACjC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC;IACrE,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC1B,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACzB,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,IAAI,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACpO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC3M,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,6CAA6C;AAC7C,MAAM,UAAU,WAAW,CAAC,GAAa,EAAE,IAAiB,EAAE,GAAiF;IAC7I,OAAO,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAAE,OAAO,KAAK,CAAC;QACjE,IAAI,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAAE,OAAO,KAAK,CAAC;QACjG,IAAI,GAAG,CAAC,WAAW,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,KAAK,SAAS;YAAE,OAAO,KAAK,CAAC;QAC1F,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,KAAwB,EAAE,SAAiB,EAAE,IAAkB,KAAK;IACpG,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,mBAAmB,EAAE;gBAClE,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE;gBAC7G,IAAI,EAAE,IAAI;gBACV,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,SAAS,CAAC;aACvC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAA0C,CAAC;YAC3F,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,OAAO,IAAI,QAAQ,GAAG,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAC9M,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAG,CAAW,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,EAAE,CAAC;QAChG,CAAC;IACH,CAAC,CAAC,CACH,CAAC;AACJ,CAAC;AAED,eAAe,CAAC;IACd,EAAE,EAAE,YAAY;IAChB,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,wEAAwE;IACjF,KAAK,EAAE,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC;QAC1E,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,KAAK,CAAC,CAAC,IAAI,EAAE,iBAAiB,CAAC,GAAG,CAAC,MAAM,EAAE,EAAE,GAAG,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QACxI,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC5B,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC;YACvB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAyB,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7G,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE;YACtC,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YAC/B,IAAI,CAAC,CAAC;gBAAE,OAAO;YACf,IAAI,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;gBAAE,OAAO,UAAU,CAAC,GAAG,EAAE,iCAAiC,CAAC,CAAC;YACjK,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;gBAAE,OAAO,UAAU,CAAC,GAAG,EAAE,4BAA4B,CAAC,CAAC;YACnK,MAAM,GAAG,GAAG,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM;gBAAE,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC,CAAC;YACtI,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;YAC9D,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAA6B,EAAE,MAAM,EAAE,CAAC,CAAC,MAA4C,EAAE,WAAW,EAAE,CAAC,CAAC,WAAW,KAAK,IAAI,EAAE,CAAC,CAAC;YAChL,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,aAAa,CAAC,CAAC;YAC9D,GAAG,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;QACjH,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC,CAAC"}

package/dist/features/index.d.ts

@@ -5,5 +5,7 @@
  * @module features
  */
 import './conformance.js';
+import './regions.js';
+import './edge-fleet.js';
 export { listFeatures, registerFeature, createFeatureRouter } from '../gateway/features.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/features/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,cAAc,CAAC;AACtB,OAAO,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/features/index.js

@@ -5,5 +5,7 @@
  * @module features
  */
 import './conformance.js';
+import './regions.js';
+import './edge-fleet.js';
 export { listFeatures, registerFeature, createFeatureRouter } from '../gateway/features.js';
 //# sourceMappingURL=index.js.map

package/dist/features/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAE1B,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/features/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,kBAAkB,CAAC;AAC1B,OAAO,cAAc,CAAC;AACtB,OAAO,iBAAiB,CAAC;AAEzB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/features/regions.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Multi-region active-active (5.2).
+ *
+ * Every region runs a full gateway. Regions replicate a small shared key-value state (last-writer-wins per key,
+ * ties broken by region id) and gossip which upstream servers are online, so a call whose upstream is down locally
+ * can be failed over to a region that has it.
+ *
+ * ```yaml
+ * regions:
+ *   self: eu-west
+ *   syncIntervalMs: 5000
+ *   peers:
+ *     - { id: us-east, url: https://us.gw.example.com, apiKey: ${US_ADMIN_KEY}, priority: 1 }
+ * ```
+ *
+ * - `GET  /admin/regions` — this region, peers (health, last sync, servers online), replicated key count.
+ * - `POST /admin/regions/sync` — peer exchange `{ region, since, entries, servers }` → `{ region, entries, servers }`.
+ * - `GET|PUT|DELETE /admin/regions/kv/:key` — replicated state (`PUT` body `{ value }`).
+ * - `GET  /admin/regions/route/:serverId` — where a call to that server should run: `local`, a peer, or none.
+ *
+ * @module features/regions
+ */
+import { z } from 'zod';
+export declare const RegionsSchema: z.ZodObject<{
+    self: z.ZodString;
+    syncIntervalMs: z.ZodDefault<z.ZodNumber>;
+    /** Consecutive failed syncs before a peer is considered down. */
+    downAfter: z.ZodDefault<z.ZodNumber>;
+    peers: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        url: z.ZodString;
+        apiKey: z.ZodOptional<z.ZodString>;
+        priority: z.ZodDefault<z.ZodNumber>;
+    }, "strict", z.ZodTypeAny, {
+        id: string;
+        url: string;
+        priority: number;
+        apiKey?: string | undefined;
+    }, {
+        id: string;
+        url: string;
+        apiKey?: string | undefined;
+        priority?: number | undefined;
+    }>, "many">>;
+}, "strict", z.ZodTypeAny, {
+    self: string;
+    syncIntervalMs: number;
+    downAfter: number;
+    peers: {
+        id: string;
+        url: string;
+        priority: number;
+        apiKey?: string | undefined;
+    }[];
+}, {
+    self: string;
+    syncIntervalMs?: number | undefined;
+    downAfter?: number | undefined;
+    peers?: {
+        id: string;
+        url: string;
+        apiKey?: string | undefined;
+        priority?: number | undefined;
+    }[] | undefined;
+}>;
+export type RegionsConfig = z.input<typeof RegionsSchema>;
+type Resolved = z.output<typeof RegionsSchema>;
+export interface ReplicatedEntry {
+    key: string;
+    /** `null` = tombstone (deleted). */
+    value: unknown;
+    /** Hybrid timestamp: wall-clock ms, bumped to stay monotonic per region. */
+    ts: number;
+    region: string;
+}
+export interface PeerState {
+    id: string;
+    url: string;
+    priority: number;
+    status: 'unknown' | 'up' | 'down';
+    failures: number;
+    lastSync?: string;
+    lastError?: string;
+    /** Highest `ts` received from this peer (sync cursor). */
+    cursor: number;
+    servers: string[];
+}
+/** Last-writer-wins: newer ts wins; equal ts → lexicographically larger region wins. */
+export declare const newer: (a: ReplicatedEntry, b: ReplicatedEntry | undefined) => boolean;
+export declare class RegionMesh {
+    private cfg;
+    private readonly now;
+    private readonly entries;
+    private readonly peers;
+    private clock;
+    private timer?;
+    constructor(cfg: Resolved, now?: () => number);
+    get self(): string;
+    configure(cfg: Resolved): void;
+    private tick;
+    get(key: string): unknown;
+    put(key: string, value: unknown): ReplicatedEntry;
+    delete(key: string): boolean;
+    size(): number;
+    /** Merge remote entries; returns how many changed local state. */
+    merge(entries: ReplicatedEntry[]): number;
+    /** Entries changed after `since` (any origin, so state relays through intermediate regions). */
+    delta(since?: number): ReplicatedEntry[];
+    peerList(): PeerState[];
+    /** Record a peer's gossip (from an inbound or outbound sync). */
+    sawPeer(id: string, servers: unknown, cursor?: number): void;
+    peerFailed(id: string, err: string): void;
+    /** Where a call to `serverId` should run. */
+    route(serverId: string, localOnline: string[]): {
+        target: 'local';
+    } | {
+        target: 'peer';
+        peer: string;
+        url: string;
+    } | {
+        target: 'none';
+    };
+    /** One outbound sync round with every peer. */
+    syncOnce(localOnline: string[], f?: typeof fetch): Promise<void>;
+    start(localOnline: () => string[], f?: typeof fetch): void;
+    stop(): void;
+    status(): Record<string, unknown>;
+}
+/** Resolve (validate + defaults) a `regions` section. */
+export declare const resolveRegions: (raw: unknown) => Resolved;
+export {};
+//# sourceMappingURL=regions.d.ts.map

package/dist/features/regions.d.ts.map

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

package/dist/features/regions.js

@@ -0,0 +1,268 @@
+/**
+ * Multi-region active-active (5.2).
+ *
+ * Every region runs a full gateway. Regions replicate a small shared key-value state (last-writer-wins per key,
+ * ties broken by region id) and gossip which upstream servers are online, so a call whose upstream is down locally
+ * can be failed over to a region that has it.
+ *
+ * ```yaml
+ * regions:
+ *   self: eu-west
+ *   syncIntervalMs: 5000
+ *   peers:
+ *     - { id: us-east, url: https://us.gw.example.com, apiKey: ${US_ADMIN_KEY}, priority: 1 }
+ * ```
+ *
+ * - `GET  /admin/regions` — this region, peers (health, last sync, servers online), replicated key count.
+ * - `POST /admin/regions/sync` — peer exchange `{ region, since, entries, servers }` → `{ region, entries, servers }`.
+ * - `GET|PUT|DELETE /admin/regions/kv/:key` — replicated state (`PUT` body `{ value }`).
+ * - `GET  /admin/regions/route/:serverId` — where a call to that server should run: `local`, a peer, or none.
+ *
+ * @module features/regions
+ */
+import { z } from 'zod';
+import { registerFeature, badRequest, objectBody } from '../gateway/features.js';
+export const RegionsSchema = z
+    .object({
+    self: z.string().min(1).regex(/^[a-z0-9][a-z0-9-]*$/, 'lowercase letters, digits and dashes'),
+    syncIntervalMs: z.number().int().min(250).default(5000),
+    /** Consecutive failed syncs before a peer is considered down. */
+    downAfter: z.number().int().min(1).default(3),
+    peers: z
+        .array(z.object({ id: z.string().min(1), url: z.string().url(), apiKey: z.string().optional(), priority: z.number().int().min(0).default(100) }).strict())
+        .default([]),
+})
+    .strict();
+/** Last-writer-wins: newer ts wins; equal ts → lexicographically larger region wins. */
+export const newer = (a, b) => !b || a.ts > b.ts || (a.ts === b.ts && a.region > b.region);
+export class RegionMesh {
+    cfg;
+    now;
+    entries = new Map();
+    peers = new Map();
+    clock = 0;
+    timer;
+    constructor(cfg, now = Date.now) {
+        this.cfg = cfg;
+        this.now = now;
+        this.configure(cfg);
+    }
+    get self() {
+        return this.cfg.self;
+    }
+    configure(cfg) {
+        this.cfg = cfg;
+        const keep = new Set(cfg.peers.map((p) => p.id));
+        for (const id of [...this.peers.keys()])
+            if (!keep.has(id))
+                this.peers.delete(id);
+        for (const p of cfg.peers) {
+            const cur = this.peers.get(p.id);
+            this.peers.set(p.id, cur ? { ...cur, url: p.url, priority: p.priority } : { id: p.id, url: p.url, priority: p.priority, status: 'unknown', failures: 0, cursor: 0, servers: [] });
+        }
+    }
+    tick() {
+        this.clock = Math.max(this.clock + 1, this.now());
+        return this.clock;
+    }
+    get(key) {
+        const e = this.entries.get(key);
+        return e && e.value !== null ? e.value : undefined;
+    }
+    put(key, value) {
+        const e = { key, value: value === undefined ? null : value, ts: this.tick(), region: this.cfg.self };
+        this.entries.set(key, e);
+        return e;
+    }
+    delete(key) {
+        const had = this.get(key) !== undefined;
+        this.put(key, null);
+        return had;
+    }
+    size() {
+        return [...this.entries.values()].filter((e) => e.value !== null).length;
+    }
+    /** Merge remote entries; returns how many changed local state. */
+    merge(entries) {
+        let n = 0;
+        for (const e of entries) {
+            if (!e || typeof e.key !== 'string' || typeof e.ts !== 'number' || typeof e.region !== 'string')
+                continue;
+            if (newer(e, this.entries.get(e.key))) {
+                this.entries.set(e.key, { key: e.key, value: e.value ?? null, ts: e.ts, region: e.region });
+                n++;
+            }
+            this.clock = Math.max(this.clock, e.ts);
+        }
+        return n;
+    }
+    /** Entries changed after `since` (any origin, so state relays through intermediate regions). */
+    delta(since = 0) {
+        return [...this.entries.values()].filter((e) => e.ts > since).sort((a, b) => a.ts - b.ts);
+    }
+    peerList() {
+        return [...this.peers.values()].sort((a, b) => a.priority - b.priority || a.id.localeCompare(b.id));
+    }
+    /** Record a peer's gossip (from an inbound or outbound sync). */
+    sawPeer(id, servers, cursor) {
+        const p = this.peers.get(id);
+        if (!p)
+            return;
+        p.status = 'up';
+        p.failures = 0;
+        p.lastSync = new Date(this.now()).toISOString();
+        delete p.lastError;
+        if (Array.isArray(servers))
+            p.servers = servers.map(String);
+        if (typeof cursor === 'number')
+            p.cursor = Math.max(p.cursor, cursor);
+    }
+    peerFailed(id, err) {
+        const p = this.peers.get(id);
+        if (!p)
+            return;
+        p.failures++;
+        p.lastError = err;
+        if (p.failures >= this.cfg.downAfter)
+            p.status = 'down';
+    }
+    /** Where a call to `serverId` should run. */
+    route(serverId, localOnline) {
+        if (localOnline.includes(serverId))
+            return { target: 'local' };
+        const peer = this.peerList().find((p) => p.status === 'up' && p.servers.includes(serverId));
+        return peer ? { target: 'peer', peer: peer.id, url: peer.url } : { target: 'none' };
+    }
+    /** One outbound sync round with every peer. */
+    async syncOnce(localOnline, f = fetch) {
+        await Promise.all(this.peerList().map(async (p) => {
+            const conf = this.cfg.peers.find((x) => x.id === p.id);
+            try {
+                const res = await f(`${p.url.replace(/\/$/, '')}/api/v1/admin/regions/sync`, {
+                    method: 'POST',
+                    headers: { 'content-type': 'application/json', ...(conf?.apiKey ? { authorization: `Bearer ${conf.apiKey}` } : {}) },
+                    body: JSON.stringify({ region: this.cfg.self, since: p.cursor, entries: this.delta(0), servers: localOnline }),
+                    signal: AbortSignal.timeout(Math.max(1000, this.cfg.syncIntervalMs)),
+                });
+                if (!res.ok)
+                    throw new Error(`HTTP ${res.status}`);
+                const body = (await res.json());
+                const entries = Array.isArray(body.entries) ? body.entries : [];
+                this.merge(entries);
+                this.sawPeer(p.id, body.servers, entries.reduce((m, e) => Math.max(m, e.ts ?? 0), 0));
+            }
+            catch (e) {
+                this.peerFailed(p.id, e.message);
+            }
+        }));
+    }
+    start(localOnline, f = fetch) {
+        this.stop();
+        if (!this.cfg.peers.length)
+            return;
+        this.timer = setInterval(() => void this.syncOnce(localOnline(), f), this.cfg.syncIntervalMs);
+        this.timer.unref?.();
+    }
+    stop() {
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = undefined;
+    }
+    status() {
+        return { self: this.cfg.self, syncIntervalMs: this.cfg.syncIntervalMs, keys: this.size(), peers: this.peerList() };
+    }
+}
+/** Resolve (validate + defaults) a `regions` section. */
+export const resolveRegions = (raw) => RegionsSchema.parse(raw);
+function meshFor(ctx, state) {
+    const raw = ctx.config().regions;
+    if (!raw) {
+        state.mesh?.stop();
+        state.mesh = undefined;
+        state.key = undefined;
+        return undefined;
+    }
+    const key = JSON.stringify(raw);
+    if (state.key !== key) {
+        const cfg = resolveRegions(raw);
+        if (state.mesh && state.mesh.self === cfg.self)
+            state.mesh.configure(cfg);
+        else
+            state.mesh = new RegionMesh(cfg);
+        state.key = key;
+        state.mesh.start(() => ctx.onlineServers?.() ?? []);
+    }
+    return state.mesh;
+}
+registerFeature({
+    id: 'regions',
+    since: '5.2.0',
+    summary: 'Multi-region active-active: replicated state, peer health, cross-region failover routing',
+    mount: (router, ctx) => {
+        const state = {};
+        ctx.onStop?.(() => state.mesh?.stop());
+        // Start syncing as soon as the gateway is up (config may also change later; re-checked on each request).
+        setImmediate(() => { try {
+            meshFor(ctx, state);
+        }
+        catch { /* invalid config is reported on request */ } });
+        const need = (res) => {
+            const m = meshFor(ctx, state);
+            if (!m)
+                res.status(404).json({ error: 'Not Found', message: 'multi-region is not configured (`regions:`)' });
+            return m;
+        };
+        router.get('/', (_req, res) => {
+            const m = need(res);
+            if (m)
+                res.json(m.status());
+        });
+        router.post('/sync', (req, res) => {
+            const m = need(res);
+            if (!m)
+                return;
+            const b = objectBody(req, res);
+            if (!b)
+                return;
+            if (typeof b.region !== 'string')
+                return badRequest(res, '"region" is required');
+            if (!m.peerList().some((p) => p.id === b.region))
+                return void res.status(403).json({ error: 'Forbidden', message: `unknown region "${b.region}"` });
+            const entries = Array.isArray(b.entries) ? b.entries : [];
+            m.merge(entries);
+            m.sawPeer(b.region, b.servers, entries.reduce((x, e) => Math.max(x, e?.ts ?? 0), 0));
+            res.json({ region: m.self, entries: m.delta(typeof b.since === 'number' ? b.since : 0), servers: ctx.onlineServers?.() ?? [] });
+        });
+        router.get('/kv/:key', (req, res) => {
+            const m = need(res);
+            if (!m)
+                return;
+            const v = m.get(req.params.key);
+            if (v === undefined)
+                return void res.status(404).json({ error: 'Not Found', message: 'no such key' });
+            res.json({ key: req.params.key, value: v });
+        });
+        router.put('/kv/:key', (req, res) => {
+            const m = need(res);
+            if (!m)
+                return;
+            const b = objectBody(req, res);
+            if (!b)
+                return;
+            if (!('value' in b) || b.value === null)
+                return badRequest(res, '"value" is required (use DELETE to remove)');
+            res.json(m.put(req.params.key, b.value));
+        });
+        router.delete('/kv/:key', (req, res) => {
+            const m = need(res);
+            if (m)
+                res.json({ deleted: m.delete(req.params.key) });
+        });
+        router.get('/route/:serverId', (req, res) => {
+            const m = need(res);
+            if (m)
+                res.json({ serverId: req.params.serverId, ...m.route(req.params.serverId, ctx.onlineServers?.() ?? []) });
+        });
+    },
+});
+//# sourceMappingURL=regions.js.map

package/dist/features/regions.js.map

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

package/dist/gateway/features.d.ts

@@ -17,6 +17,12 @@ export interface FeatureContext {
     recent: (limit?: number) => RequestMetric[];
     /** Base URL of this gateway when listening (for self-tests). */
     baseUrl: () => string | undefined;
+    /** Upstream server ids currently online on this gateway (5.2). */
+    onlineServers?: () => string[];
+    /** Register a cleanup run when the gateway stops (5.2): timers, sockets. */
+    onStop?: (fn: () => void | Promise<void>) => void;
+    /** Edge gateways seen by the edge control plane (5.3). */
+    edgeNodes?: () => import('./edge-control.js').EdgeNode[];
 }
 export interface FeatureModule {
     /** Mount point: `/api/v1/admin/<id>`. */
@@ -26,6 +32,10 @@ export interface FeatureModule {
     summary: string;
     mount: (router: Router, ctx: FeatureContext) => void;
 }
+/** Top-level config sections owned by feature modules; all hot reload (5.2+). */
+export declare const FEATURE_CONFIG_KEYS: readonly ["regions", "edgeFleet"];
+/** Copy the feature-owned config sections of `next` (for hot reload). */
+export declare function featureSections(next: GatewayConfig): Partial<GatewayConfig>;
 /** Register a feature module (idempotent by id; later registrations replace earlier ones). */
 export declare function registerFeature(f: FeatureModule): void;
 export declare function listFeatures(): ReadonlyArray<Pick<FeatureModule, 'id' | 'since' | 'summary'>>;

package/dist/gateway/features.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/gateway/features.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG/F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,aAAa,CAAC;IAC5B,KAAK,EAAE,MAAM,QAAQ,EAAE,CAAC;IACxB,mFAAmF;IACnF,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACrH,iDAAiD;IACjD,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAC5C,gEAAgE;IAChE,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;CACnC;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAID,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAItD;AAED,wBAAgB,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAE7F;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAc3E;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOnG;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,cAAiE,CAAC"}
+{"version":3,"file":"features.d.ts","sourceRoot":"","sources":["../../src/gateway/features.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,OAAO,EAAE,EAAE,KAAK,OAAO,EAAE,KAAK,cAAc,EAAE,KAAK,MAAM,EAAE,MAAM,SAAS,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAE,QAAQ,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAG/F,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,aAAa,CAAC;IAC5B,KAAK,EAAE,MAAM,QAAQ,EAAE,CAAC;IACxB,mFAAmF;IACnF,MAAM,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACrH,iDAAiD;IACjD,MAAM,EAAE,CAAC,KAAK,CAAC,EAAE,MAAM,KAAK,aAAa,EAAE,CAAC;IAC5C,gEAAgE;IAChE,OAAO,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAClC,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC/B,4EAA4E;IAC5E,MAAM,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;IAClD,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,OAAO,mBAAmB,EAAE,QAAQ,EAAE,CAAC;CAC1D;AAED,MAAM,WAAW,aAAa;IAC5B,yCAAyC;IACzC,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,KAAK,IAAI,CAAC;CACtD;AAID,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,mCAAiF,CAAC;AAElH,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAE3E;AAED,8FAA8F;AAC9F,wBAAgB,eAAe,CAAC,CAAC,EAAE,aAAa,GAAG,IAAI,CAItD;AAED,wBAAgB,YAAY,IAAI,aAAa,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC,CAE7F;AAED,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,cAAc,CAAC;IAC7B,UAAU,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC;IACtC,OAAO,EAAE,cAAc,CAAC;IACxB,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;CAC5B;AAED,wFAAwF;AACxF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,MAAM,CAc3E;AAED,8EAA8E;AAC9E,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAOnG;AAED,eAAO,MAAM,UAAU,GAAI,KAAK,OAAO,CAAC,QAAQ,EAAE,SAAS,MAAM,cAAiE,CAAC"}

package/dist/gateway/features.js

@@ -9,6 +9,12 @@
 import express from 'express';
 import { VERSION } from '../utils/version.js';
 const registry = [];
+/** Top-level config sections owned by feature modules; all hot reload (5.2+). */
+export const FEATURE_CONFIG_KEYS = ['regions', 'edgeFleet'];
+/** Copy the feature-owned config sections of `next` (for hot reload). */
+export function featureSections(next) {
+    return Object.fromEntries(FEATURE_CONFIG_KEYS.map((k) => [k, next[k]]));
+}
 /** Register a feature module (idempotent by id; later registrations replace earlier ones). */
 export function registerFeature(f) {
     const i = registry.findIndex((x) => x.id === f.id);