@continuumdao/continuum-node-sdk 1.3.40 → 1.3.42

package/dist/core/node-config.js

@@ -0,0 +1,238 @@
+import { signedMessageForConfigUpdateImplement, buildConfigUpdateImplementPostBody, } from '../api/config-update.js';
+import { managementGet, managementPost } from '../api/management-api.js';
+import { DEFAULT_MANAGEMENT_SIGNING, DEFAULT_PEER_MANAGEMENT_HTTP_PORT, GetMqttTlsPublicKeyDataSchema, Ipv4Schema, MaintenanceRestartGateDataSchema, NODE_CONFIG_API_PATHS, SetConfiguredNodesDataSchema, SetConfiguredNodesInputSchema, SetMqttTlsKeyDataSchema, SetMqttTlsKeyInputSchema, } from '../schemas/extended.js';
+import { buildManagementPostRequest, managementSign, toSelectedSigner, } from './management-signer.js';
+const MQTT_CA_CERT_MAX_BYTES = 512 * 1024;
+export { DEFAULT_PEER_MANAGEMENT_HTTP_PORT };
+export function isValidIpv4(host) {
+    return Ipv4Schema.safeParse(host.trim()).success;
+}
+export function isUnsetRelayPlaceholderAddress(address) {
+    return extractIpv4Host(address) === '0.0.0.0';
+}
+export function extractIpv4Host(addr) {
+    const s = addr.trim();
+    if (!s) {
+        return '';
+    }
+    try {
+        const u = new URL(s.includes('://') ? s : `http://${s}`);
+        return u.hostname;
+    }
+    catch {
+        const colon = s.lastIndexOf(':');
+        if (colon > 0) {
+            return s.slice(0, colon).trim();
+        }
+        return s;
+    }
+}
+/** IPv4 plus port for POST /configUpdatePlan `nodeAddresses` / `MSQTTRelayIP`. */
+export function peerAddressForConfigWrite(ipv4, port = DEFAULT_PEER_MANAGEMENT_HTTP_PORT) {
+    const ip = ipv4.trim();
+    const p = port > 0 ? port : DEFAULT_PEER_MANAGEMENT_HTTP_PORT;
+    return `${ip}:${p}`;
+}
+function assertMqttCaCertPem(pem) {
+    const trimmed = pem.trim();
+    if (!trimmed.includes('-----BEGIN CERTIFICATE-----')) {
+        return { ok: false, reason: 'caCertPem must be a PEM-encoded CERTIFICATE' };
+    }
+    if (new TextEncoder().encode(trimmed).length > MQTT_CA_CERT_MAX_BYTES) {
+        return { ok: false, reason: 'caCertPem exceeds max size (512 KiB)' };
+    }
+    return { ok: true, data: trimmed };
+}
+function normalizePeerIpv4List(peers) {
+    const list = peers.map(p => p.trim()).filter(Boolean);
+    if (list.length === 0) {
+        return { ok: false, reason: 'peers must contain at least one IPv4 address.' };
+    }
+    const bad = list.filter(ip => !isValidIpv4(ip));
+    if (bad.length > 0) {
+        return { ok: false, reason: `Invalid IPv4 in peers: ${bad.join(', ')}` };
+    }
+    if (new Set(list).size !== list.length) {
+        return { ok: false, reason: 'Each peer IPv4 address must appear only once.' };
+    }
+    if (list[0] === '0.0.0.0') {
+        return {
+            ok: false,
+            reason: 'First peer is the relay; 0.0.0.0 is the unset placeholder. Set a real public relay IPv4.',
+        };
+    }
+    return { ok: true, data: list };
+}
+/** GET /getMSQTTKey — MQTT broker TLS CA PEM (relay export). */
+export async function getMqttTlsPublicKey(config) {
+    const result = await managementGet(config, NODE_CONFIG_API_PATHS.getMqttKey);
+    if (!result.ok) {
+        return result;
+    }
+    const parsed = GetMqttTlsPublicKeyDataSchema.safeParse(result.data);
+    if (!parsed.success) {
+        return { ok: false, reason: 'GET /getMSQTTKey response failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function buildSetMqttTlsKey(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const parsed = SetMqttTlsKeyInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: 'Invalid set MQTT TLS key input.' };
+    }
+    const pem = assertMqttCaCertPem(parsed.data.caCertPem);
+    if (!pem.ok) {
+        return pem;
+    }
+    return buildManagementPostRequest(config, {
+        path: NODE_CONFIG_API_PATHS.postMqttKey,
+        buildRequestFields: () => ({ caCertPem: pem.data }),
+    }, signing);
+}
+/** POST /postMSQTTKey — write MQTT broker CA PEM (sign caCertPem bytes, not JSON). */
+export async function setMqttTlsKey(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const built = await buildSetMqttTlsKey(config, input, signing);
+    if (!built.ok) {
+        return built;
+    }
+    const pem = String(built.data.unsignedBody['caCertPem'] ?? '');
+    const signed = await managementSign(config, signing, built.data.unsignedBody, { messageToSign: pem });
+    if (!signed.ok) {
+        return signed;
+    }
+    const posted = await managementPost(config, built.data.path, signed.data);
+    if (!posted.ok) {
+        return posted;
+    }
+    const data = SetMqttTlsKeyDataSchema.safeParse({
+        path: String(posted.data.path ?? ''),
+        message: String(posted.data.message ?? 'MQTT broker CA PEM written'),
+        restartRequired: true,
+    });
+    if (!data.success) {
+        return { ok: false, reason: 'POST /postMSQTTKey response failed validation.' };
+    }
+    return {
+        ok: true,
+        data: {
+            ...data.data,
+            selectedSigningKey: built.data.selectedSigningKey
+                ? toSelectedSigner(built.data.selectedSigningKey)
+                : undefined,
+            signingMessage: pem,
+        },
+    };
+}
+export async function buildSetConfiguredNodes(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const parsed = SetConfiguredNodesInputSchema.safeParse(input);
+    if (!parsed.success) {
+        return { ok: false, reason: 'Invalid set configured nodes input.' };
+    }
+    const peers = normalizePeerIpv4List(parsed.data.peers);
+    if (!peers.ok) {
+        return peers;
+    }
+    const port = parsed.data.managementHttpPort ?? DEFAULT_PEER_MANAGEMENT_HTTP_PORT;
+    const nodeAddresses = peers.data.map(ip => peerAddressForConfigWrite(ip, port));
+    const relayIp = nodeAddresses[0];
+    if (!relayIp) {
+        return { ok: false, reason: 'peers must contain a relay IPv4 (first slot).' };
+    }
+    return buildManagementPostRequest(config, {
+        path: NODE_CONFIG_API_PATHS.configUpdatePlan,
+        buildRequestFields: () => ({
+            MSQTTRelayIP: relayIp,
+            nodeAddresses,
+            managementHttpPort: port,
+        }),
+    }, signing);
+}
+/**
+ * POST /configUpdatePlan then POST /configUpdateImplement.
+ * First IPv4 is the relay (every collaborator must share it). Restart the node after apply.
+ */
+export async function setConfiguredNodes(config, input, signing = DEFAULT_MANAGEMENT_SIGNING) {
+    const builtPlan = await buildSetConfiguredNodes(config, input, signing);
+    if (!builtPlan.ok) {
+        return builtPlan;
+    }
+    const signedPlan = await managementSign(config, signing, builtPlan.data.unsignedBody);
+    if (!signedPlan.ok) {
+        return signedPlan;
+    }
+    const planned = await managementPost(config, builtPlan.data.path, signedPlan.data);
+    if (!planned.ok) {
+        return planned;
+    }
+    const plannedYaml = String(planned.data.plannedYaml ?? '').trim();
+    if (!plannedYaml) {
+        return { ok: false, reason: 'configUpdatePlan returned no plannedYaml.' };
+    }
+    const plannedShaMessage = String(planned.data.plannedShaMessage ?? '').trim() ||
+        (await signedMessageForConfigUpdateImplement(plannedYaml));
+    const builtImpl = await buildManagementPostRequest(config, {
+        path: NODE_CONFIG_API_PATHS.configUpdateImplement,
+        buildRequestFields: ctx => buildConfigUpdateImplementPostBody(0, ctx.nodeKey, plannedYaml, plannedShaMessage),
+    }, signing);
+    if (!builtImpl.ok) {
+        return builtImpl;
+    }
+    const signedImpl = await managementSign(config, signing, builtImpl.data.unsignedBody, { messageToSign: plannedShaMessage });
+    if (!signedImpl.ok) {
+        return signedImpl;
+    }
+    const implemented = await managementPost(config, builtImpl.data.path, signedImpl.data);
+    if (!implemented.ok) {
+        return implemented;
+    }
+    const data = SetConfiguredNodesDataSchema.safeParse({
+        message: String(implemented.data.message ??
+            'configs.yaml updated; restart the node for changes to take effect'),
+        ...(implemented.data.configsPath
+            ? { configsPath: implemented.data.configsPath }
+            : planned.data.configsPath
+                ? { configsPath: planned.data.configsPath }
+                : {}),
+        ...(implemented.data.backupPath
+            ? { backupPath: implemented.data.backupPath }
+            : {}),
+        ...(implemented.data.composeWarning
+            ? { composeWarning: implemented.data.composeWarning }
+            : {}),
+        restartRequired: true,
+    });
+    if (!data.success) {
+        return {
+            ok: false,
+            reason: 'configUpdateImplement response failed validation.',
+        };
+    }
+    return {
+        ok: true,
+        data: {
+            ...data.data,
+            selectedSigningKey: builtImpl.data.selectedSigningKey
+                ? toSelectedSigner(builtImpl.data.selectedSigningKey)
+                : builtPlan.data.selectedSigningKey
+                    ? toSelectedSigner(builtPlan.data.selectedSigningKey)
+                    : undefined,
+            signingMessage: plannedShaMessage,
+        },
+    };
+}
+/** GET /maintenance/restartGate — read-only; container restart is host `docker compose`. */
+export async function getMaintenanceRestartGate(config) {
+    const result = await managementGet(config, NODE_CONFIG_API_PATHS.restartGate);
+    if (!result.ok) {
+        return result;
+    }
+    const parsed = MaintenanceRestartGateDataSchema.safeParse(result.data);
+    if (!parsed.success) {
+        return {
+            ok: false,
+            reason: 'GET /maintenance/restartGate response failed validation.',
+        };
+    }
+    return { ok: true, data: parsed.data };
+}
+//# sourceMappingURL=node-config.js.map

package/dist/core/node-config.js.map

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

package/dist/core/node-database/binary.d.ts

@@ -0,0 +1,12 @@
+type SdkBinaryResult = {
+    ok: true;
+    bytes: Uint8Array;
+} | {
+    ok: false;
+    reason: string;
+};
+export declare function sha256HexOfBytes(bytes: Uint8Array): Promise<string>;
+export declare function decodeBase64Content(contentBase64: string): SdkBinaryResult;
+export declare function encodeBase64IfAllowed(bytes: Uint8Array): string | undefined;
+export {};
+//# sourceMappingURL=binary.d.ts.map

package/dist/core/node-database/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../../../src/core/node-database/binary.ts"],"names":[],"mappings":"AAEA,KAAK,eAAe,GACjB;IAAC,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAC,GAC7B;IAAC,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAC,CAAC;AAE/B,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAIzE;AAED,wBAAgB,mBAAmB,CAAC,aAAa,EAAE,MAAM,GAAG,eAAe,CAiB1E;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAK3E"}

package/dist/core/node-database/binary.js

@@ -0,0 +1,32 @@
+import { DATABASE_BACKUP_BASE64_MAX_BYTES } from './schemas.js';
+export async function sha256HexOfBytes(bytes) {
+    const view = new Uint8Array(bytes);
+    const hash = await crypto.subtle.digest('SHA-256', view);
+    return Array.from(new Uint8Array(hash), b => b.toString(16).padStart(2, '0')).join('');
+}
+export function decodeBase64Content(contentBase64) {
+    const trimmed = contentBase64.trim();
+    if (!trimmed) {
+        return { ok: false, reason: 'contentBase64 is required.' };
+    }
+    try {
+        const bytes = Uint8Array.from(Buffer.from(trimmed, 'base64'));
+        if (bytes.length > DATABASE_BACKUP_BASE64_MAX_BYTES) {
+            return {
+                ok: false,
+                reason: `contentBase64 exceeds ${DATABASE_BACKUP_BASE64_MAX_BYTES} bytes; use userFolderPath instead.`,
+            };
+        }
+        return { ok: true, bytes };
+    }
+    catch {
+        return { ok: false, reason: 'contentBase64 is not valid base64.' };
+    }
+}
+export function encodeBase64IfAllowed(bytes) {
+    if (bytes.length > DATABASE_BACKUP_BASE64_MAX_BYTES) {
+        return undefined;
+    }
+    return Buffer.from(bytes).toString('base64');
+}
+//# sourceMappingURL=binary.js.map

package/dist/core/node-database/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.js","sourceRoot":"","sources":["../../../src/core/node-database/binary.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,gCAAgC,EAAC,MAAM,cAAc,CAAC;AAM9D,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,KAAiB;IACvD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACzD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACxF,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,aAAqB;IACxD,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,EAAE,CAAC;IACrC,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,4BAA4B,EAAC,CAAC;IAC1D,CAAC;IACD,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC9D,IAAI,KAAK,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC;YACrD,OAAO;gBACN,EAAE,EAAE,KAAK;gBACT,MAAM,EAAE,yBAAyB,gCAAgC,qCAAqC;aACtG,CAAC;QACH,CAAC;QACD,OAAO,EAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAC,CAAC;IAC1B,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,oCAAoC,EAAC,CAAC;IAClE,CAAC;AACF,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAiB;IACtD,IAAI,KAAK,CAAC,MAAM,GAAG,gCAAgC,EAAE,CAAC;QACrD,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;AAC9C,CAAC"}

package/dist/core/node-database/database-backup.d.ts

@@ -0,0 +1,13 @@
+import type { NodeSdkConfig } from '../../config/schema.js';
+import type { z } from 'zod';
+import type { SdkResult } from '../result.js';
+import { ListDatabaseBackupsOutputSchema, BackupDatabaseOutputSchema, RestoreDatabaseOutputSchema, FetchDatabaseBackupOutputSchema, PostDatabaseBackupOutputSchema, type BackupDatabaseInput, type FetchDatabaseBackupInput, type FixDatabaseInput, type PostDatabaseBackupInput, type RestoreDatabaseInput } from './schemas.js';
+export declare function listDatabaseBackups(config: NodeSdkConfig): Promise<SdkResult<z.infer<typeof ListDatabaseBackupsOutputSchema>>>;
+export declare function checkDatabase(config: NodeSdkConfig): Promise<SdkResult<Record<string, unknown>>>;
+export declare function backupDatabase(config: NodeSdkConfig, input: BackupDatabaseInput): Promise<SdkResult<z.infer<typeof BackupDatabaseOutputSchema>>>;
+export declare function restoreDatabase(config: NodeSdkConfig, input: RestoreDatabaseInput): Promise<SdkResult<z.infer<typeof RestoreDatabaseOutputSchema>>>;
+export declare function fetchDatabaseBackup(config: NodeSdkConfig, input: FetchDatabaseBackupInput): Promise<SdkResult<z.infer<typeof FetchDatabaseBackupOutputSchema>>>;
+export declare function postDatabaseBackup(config: NodeSdkConfig, input: PostDatabaseBackupInput): Promise<SdkResult<z.infer<typeof PostDatabaseBackupOutputSchema>>>;
+export declare function fixDatabase(config: NodeSdkConfig, input: FixDatabaseInput): Promise<SdkResult<Record<string, unknown>>>;
+export { requestMaintenanceRestartPrep } from './maintenance-quiescence.js';
+//# sourceMappingURL=database-backup.d.ts.map

package/dist/core/node-database/database-backup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-backup.d.ts","sourceRoot":"","sources":["../../../src/core/node-database/database-backup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAC1D,OAAO,KAAK,EAAC,CAAC,EAAC,MAAM,KAAK,CAAC;AAE3B,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAG5C,OAAO,EAGN,+BAA+B,EAC/B,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,MAAM,cAAc,CAAC;AA4CtB,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC,CAwBrE;AAED,wBAAsB,aAAa,CAClC,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAE7C;AAED,wBAAsB,cAAc,CACnC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,mBAAmB,GACxB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,0BAA0B,CAAC,CAAC,CAAC,CA8BhE;AAED,wBAAsB,eAAe,CACpC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,oBAAoB,GACzB,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,2BAA2B,CAAC,CAAC,CAAC,CA0BjE;AAED,wBAAsB,mBAAmB,CACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,wBAAwB,GAC7B,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,CAAC,CAAC,CAuCrE;AAED,wBAAsB,kBAAkB,CACvC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,uBAAuB,GAC5B,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC,CAAC,CA2DpE;AAED,wBAAsB,WAAW,CAChC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,gBAAgB,GACrB,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAe7C;AAED,OAAO,EAAC,6BAA6B,EAAC,MAAM,6BAA6B,CAAC"}

package/dist/core/node-database/database-backup.js

@@ -0,0 +1,236 @@
+import { getUserFolderFile, writeUserFolderFile } from '../agent/user-folder.js';
+import { decodeBase64Content, encodeBase64IfAllowed, sha256HexOfBytes } from './binary.js';
+import { ensureMaintenanceQuiescence } from './maintenance-quiescence.js';
+import { NODE_DATABASE_API_PATHS, ListDatabaseBackupsOutputSchema, BackupDatabaseOutputSchema, RestoreDatabaseOutputSchema, FetchDatabaseBackupOutputSchema, PostDatabaseBackupOutputSchema, } from './schemas.js';
+import { managementGetRecord, postSignedManagementRequest, postSignedMultipartBackup, postSignedRawResponse, } from './signed-post.js';
+import { sensitiveExportTransportAllowed, sensitiveExportTransportError, } from './transport.js';
+import { buildManagementPostRequest, managementSign, DEFAULT_MANAGEMENT_SIGNING, } from '../management-signer.js';
+function pickString(row, ...keys) {
+    for (const key of keys) {
+        const value = row[key];
+        if (typeof value === 'string' && value.trim()) {
+            return value.trim();
+        }
+    }
+    return '';
+}
+function pickBool(row, ...keys) {
+    for (const key of keys) {
+        if (key in row)
+            return Boolean(row[key]);
+    }
+    return false;
+}
+function pickNumber(row, ...keys) {
+    for (const key of keys) {
+        const value = row[key];
+        if (typeof value === 'number' && Number.isFinite(value)) {
+            return value;
+        }
+    }
+    return undefined;
+}
+export async function listDatabaseBackups(config) {
+    const result = await managementGetRecord(config, NODE_DATABASE_API_PATHS.listDatabaseBackups);
+    if (!result.ok)
+        return result;
+    const backupsRaw = result.data.backups ?? result.data.Backups;
+    const backups = [];
+    if (Array.isArray(backupsRaw)) {
+        for (const item of backupsRaw) {
+            if (!item || typeof item !== 'object')
+                continue;
+            const row = item;
+            const backupId = pickString(row, 'backupId', 'BackupId');
+            if (!backupId)
+                continue;
+            backups.push({
+                backupId,
+                backupUtc: pickString(row, 'backupUtc', 'BackupUtc'),
+                notes: pickString(row, 'notes', 'Notes'),
+            });
+        }
+    }
+    const parsed = ListDatabaseBackupsOutputSchema.safeParse({ backups });
+    if (!parsed.success) {
+        return { ok: false, reason: 'listDatabaseBackups response failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function checkDatabase(config) {
+    return managementGetRecord(config, NODE_DATABASE_API_PATHS.checkDatabase);
+}
+export async function backupDatabase(config, input) {
+    const quiescence = await ensureMaintenanceQuiescence(config, input);
+    if (!quiescence.ok)
+        return quiescence;
+    const posted = await postSignedManagementRequest(config, NODE_DATABASE_API_PATHS.backupDatabase, () => {
+        const body = {};
+        if (input.includeGroupIds?.length)
+            body.includeGroupIds = input.includeGroupIds;
+        if (input.excludeGroupIds?.length)
+            body.excludeGroupIds = input.excludeGroupIds;
+        if (input.mongoRootUsername)
+            body.mongoRootUsername = input.mongoRootUsername;
+        if (input.mongoRootPassword)
+            body.mongoRootPassword = input.mongoRootPassword;
+        if (input.notes)
+            body.notes = input.notes;
+        return body;
+    });
+    if (!posted.ok)
+        return posted;
+    const row = posted.data.data;
+    const output = {
+        backupId: pickString(row, 'backupId', 'BackupId'),
+        path: pickString(row, 'path', 'Path'),
+        backupUtc: pickString(row, 'backupUtc', 'BackupUtc') || undefined,
+        ciphertextSha256: pickString(row, 'ciphertextSha256', 'CiphertextSha256') || undefined,
+        ciphertextByteLength: pickNumber(row, 'ciphertextByteLength', 'CiphertextByteLength'),
+        backupFileSizeBytes: pickNumber(row, 'backupFileSizeBytes', 'BackupFileSizeBytes'),
+        notes: pickString(row, 'notes', 'Notes') || undefined,
+    };
+    const parsed = BackupDatabaseOutputSchema.safeParse(output);
+    if (!parsed.success || !parsed.data.backupId) {
+        return { ok: false, reason: 'backupDatabase response failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function restoreDatabase(config, input) {
+    const quiescence = await ensureMaintenanceQuiescence(config, input);
+    if (!quiescence.ok)
+        return quiescence;
+    const posted = await postSignedManagementRequest(config, NODE_DATABASE_API_PATHS.restoreDatabase, () => {
+        const body = {};
+        if (input.backupId)
+            body.backupId = input.backupId;
+        if (input.backupPath)
+            body.backupPath = input.backupPath;
+        if (input.mongoRootUsername)
+            body.mongoRootUsername = input.mongoRootUsername;
+        if (input.mongoRootPassword)
+            body.mongoRootPassword = input.mongoRootPassword;
+        return body;
+    });
+    if (!posted.ok)
+        return posted;
+    const row = posted.data.data;
+    const output = {
+        restoredFrom: pickString(row, 'restoredFrom', 'RestoredFrom'),
+        backupId: pickString(row, 'backupId', 'BackupId'),
+        exhaustedGlobalNonceKeyGens: pickString(row, 'exhaustedGlobalNonceKeyGens', 'ExhaustedGlobalNonceKeyGens') || undefined,
+    };
+    const parsed = RestoreDatabaseOutputSchema.safeParse(output);
+    if (!parsed.success || !parsed.data.restoredFrom) {
+        return { ok: false, reason: 'restoreDatabase response failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function fetchDatabaseBackup(config, input) {
+    if (!sensitiveExportTransportAllowed(config)) {
+        return { ok: false, reason: sensitiveExportTransportError() };
+    }
+    const quiescence = await ensureMaintenanceQuiescence(config, input);
+    if (!quiescence.ok)
+        return quiescence;
+    const fetched = await postSignedRawResponse(config, NODE_DATABASE_API_PATHS.fetchDatabaseBackup, () => ({ backupId: input.backupId.trim() }));
+    if (!fetched.ok)
+        return fetched;
+    const bytes = fetched.data.bytes;
+    const sha256 = await sha256HexOfBytes(bytes);
+    let savedPath;
+    if (input.userFolderPath) {
+        const text = Buffer.from(bytes).toString('utf8');
+        const written = await writeUserFolderFile(config, input.userFolderPath, text);
+        if (!written.ok)
+            return written;
+        savedPath = written.data.path;
+    }
+    const contentBase64 = input.returnBase64 === false ? undefined : encodeBase64IfAllowed(bytes);
+    const output = {
+        backupId: input.backupId.trim(),
+        sizeBytes: bytes.length,
+        sha256,
+        savedPath,
+        contentBase64,
+    };
+    const parsed = FetchDatabaseBackupOutputSchema.safeParse(output);
+    if (!parsed.success) {
+        return { ok: false, reason: 'fetchDatabaseBackup output failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function postDatabaseBackup(config, input) {
+    const quiescence = await ensureMaintenanceQuiescence(config, input);
+    if (!quiescence.ok)
+        return quiescence;
+    let bytes;
+    let filename = 'upload.json';
+    if (input.userFolderPath) {
+        const file = await getUserFolderFile(config, input.userFolderPath);
+        if (!file.ok)
+            return file;
+        bytes = Buffer.from(file.data.content, 'utf8');
+        const parts = input.userFolderPath.replace(/\\/g, '/').split('/');
+        filename = parts[parts.length - 1] || filename;
+    }
+    else if (input.contentBase64) {
+        const decoded = decodeBase64Content(input.contentBase64);
+        if (!decoded.ok)
+            return decoded;
+        bytes = decoded.bytes;
+    }
+    else {
+        return { ok: false, reason: 'userFolderPath or contentBase64 is required.' };
+    }
+    const contentSha256 = await sha256HexOfBytes(bytes);
+    const built = await buildManagementPostRequest(config, {
+        path: NODE_DATABASE_API_PATHS.postDatabaseBackup,
+        buildRequestFields: () => ({ contentSha256 }),
+    }, DEFAULT_MANAGEMENT_SIGNING);
+    if (!built.ok)
+        return built;
+    const signed = await managementSign(config, DEFAULT_MANAGEMENT_SIGNING, built.data.unsignedBody, {
+        publicKey: built.data.selectedSigningKey?.value,
+    });
+    if (!signed.ok)
+        return signed;
+    const posted = await postSignedMultipartBackup(config, NODE_DATABASE_API_PATHS.postDatabaseBackup, signed.data, bytes, filename);
+    if (!posted.ok)
+        return posted;
+    const row = posted.data;
+    const output = {
+        backupId: pickString(row, 'backupId', 'BackupId'),
+        path: pickString(row, 'path', 'Path'),
+        backupFileSizeBytes: pickNumber(row, 'backupFileSizeBytes', 'BackupFileSizeBytes') ?? 0,
+        contentSha256: pickString(row, 'contentSha256', 'ContentSha256') || contentSha256,
+        alreadyPresent: pickBool(row, 'alreadyPresent', 'AlreadyPresent') || undefined,
+        message: pickString(row, 'message', 'Message') || undefined,
+    };
+    const parsed = PostDatabaseBackupOutputSchema.safeParse(output);
+    if (!parsed.success || !parsed.data.backupId) {
+        return { ok: false, reason: 'postDatabaseBackup response failed validation.' };
+    }
+    return { ok: true, data: parsed.data };
+}
+export async function fixDatabase(config, input) {
+    const quiescence = await ensureMaintenanceQuiescence(config, input);
+    if (!quiescence.ok)
+        return quiescence;
+    const posted = await postSignedManagementRequest(config, NODE_DATABASE_API_PATHS.fixDatabase, () => {
+        const body = {
+            instruction: input.instruction,
+            report: input.report,
+        };
+        if (input.mongoRootUsername)
+            body.mongoRootUsername = input.mongoRootUsername;
+        if (input.mongoRootPassword)
+            body.mongoRootPassword = input.mongoRootPassword;
+        return body;
+    });
+    if (!posted.ok)
+        return posted;
+    return { ok: true, data: posted.data.data };
+}
+export { requestMaintenanceRestartPrep } from './maintenance-quiescence.js';
+//# sourceMappingURL=database-backup.js.map

package/dist/core/node-database/database-backup.js.map

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

package/dist/core/node-database/maintenance-quiescence.d.ts

@@ -0,0 +1,17 @@
+import type { NodeSdkConfig } from '../../config/schema.js';
+import type { SdkResult } from '../result.js';
+export declare const DATABASE_BACKUP_GATE_POLL_MS = 1500;
+export declare const DATABASE_BACKUP_GATE_MAX_MS: number;
+export declare function requestMaintenanceRestartPrep(config: NodeSdkConfig): Promise<SdkResult<{
+    ok: true;
+}>>;
+export declare function pollMaintenanceRestartGateUntilReady(config: NodeSdkConfig): Promise<SdkResult<{
+    ok: true;
+}>>;
+export declare function ensureMaintenanceQuiescence(config: NodeSdkConfig, options?: {
+    skipQuiescence?: boolean;
+    requestRestartPrep?: boolean;
+}): Promise<SdkResult<{
+    ok: true;
+}>>;
+//# sourceMappingURL=maintenance-quiescence.d.ts.map

package/dist/core/node-database/maintenance-quiescence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maintenance-quiescence.d.ts","sourceRoot":"","sources":["../../../src/core/node-database/maintenance-quiescence.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,wBAAwB,CAAC;AAE1D,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,cAAc,CAAC;AAI5C,eAAO,MAAM,4BAA4B,OAAO,CAAC;AACjD,eAAO,MAAM,2BAA2B,QAAgB,CAAC;AAMzD,wBAAsB,6BAA6B,CAClD,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,CAAC,CAAC,CAQhC;AAED,wBAAsB,oCAAoC,CACzD,MAAM,EAAE,aAAa,GACnB,OAAO,CAAC,SAAS,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,CAAC,CAAC,CAehC;AAED,wBAAsB,2BAA2B,CAChD,MAAM,EAAE,aAAa,EACrB,OAAO,GAAE;IAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAAC,kBAAkB,CAAC,EAAE,OAAO,CAAA;CAAM,GACpE,OAAO,CAAC,SAAS,CAAC;IAAC,EAAE,EAAE,IAAI,CAAA;CAAC,CAAC,CAAC,CAShC"}

package/dist/core/node-database/maintenance-quiescence.js

@@ -0,0 +1,42 @@
+import { getMaintenanceRestartGate } from '../node-config.js';
+import { NODE_DATABASE_API_PATHS } from './schemas.js';
+import { postSignedManagementRequest } from './signed-post.js';
+export const DATABASE_BACKUP_GATE_POLL_MS = 1500;
+export const DATABASE_BACKUP_GATE_MAX_MS = 5 * 60 * 1000;
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+export async function requestMaintenanceRestartPrep(config) {
+    const posted = await postSignedManagementRequest(config, NODE_DATABASE_API_PATHS.requestRestartPrep, () => ({}));
+    if (!posted.ok)
+        return posted;
+    return { ok: true, data: { ok: true } };
+}
+export async function pollMaintenanceRestartGateUntilReady(config) {
+    const deadline = Date.now() + DATABASE_BACKUP_GATE_MAX_MS;
+    while (Date.now() < deadline) {
+        const gate = await getMaintenanceRestartGate(config);
+        if (!gate.ok)
+            return gate;
+        if (gate.data.readyForProcessExit) {
+            return { ok: true, data: { ok: true } };
+        }
+        await sleep(DATABASE_BACKUP_GATE_POLL_MS);
+    }
+    return {
+        ok: false,
+        reason: 'Timed out waiting for maintenance restart gate (readyForProcessExit). Try again when the node is quiet.',
+    };
+}
+export async function ensureMaintenanceQuiescence(config, options = {}) {
+    if (options.skipQuiescence) {
+        return { ok: true, data: { ok: true } };
+    }
+    if (options.requestRestartPrep !== false) {
+        const prep = await requestMaintenanceRestartPrep(config);
+        if (!prep.ok)
+            return prep;
+    }
+    return pollMaintenanceRestartGateUntilReady(config);
+}
+//# sourceMappingURL=maintenance-quiescence.js.map