@artenx/dshb 0.1.17 → 0.1.19

package/lib/core/sync/internal-routes.js

@@ -0,0 +1,236 @@
+import { isLoopbackRequest } from "../../auth/loopback.js";
+import { SyncNodeManifestError } from "./node-sync.js";
+import { t as SyncSessionError } from "../../session-sync-EdfwUON5.js";
+import { MAX_SYNC_TRANSFER_BYTES } from "./protocol.js";
+//#region src/core/sync/internal-routes.ts
+const MAX_APPLY_BODY_BYTES = MAX_SYNC_TRANSFER_BYTES;
+function sendJson(res, status, body) {
+	res.writeHead(status, {
+		"content-type": "application/json",
+		"cache-control": "no-store"
+	});
+	res.end(JSON.stringify(body));
+}
+function pathSegments(req) {
+	return new URL(req.url ?? "/", "http://x").pathname.split("/").filter(Boolean);
+}
+function readJsonBody(req) {
+	return new Promise((resolve) => {
+		if (req.headers["content-type"]?.split(";", 1)[0]?.trim().toLowerCase() !== "application/json") {
+			resolve(null);
+			return;
+		}
+		const chunks = [];
+		let size = 0;
+		let settled = false;
+		const fail = () => {
+			if (settled) return;
+			settled = true;
+			resolve(null);
+		};
+		req.on("data", (chunk) => {
+			if (settled) return;
+			size += chunk.length;
+			if (size > MAX_APPLY_BODY_BYTES) {
+				fail();
+				req.destroy();
+				return;
+			}
+			chunks.push(chunk);
+		});
+		req.on("end", () => {
+			if (settled) return;
+			try {
+				const value = JSON.parse(Buffer.concat(chunks).toString("utf8"));
+				if (value === null || typeof value !== "object" || Array.isArray(value)) {
+					fail();
+					return;
+				}
+				settled = true;
+				resolve(value);
+			} catch {
+				fail();
+			}
+		});
+		req.on("error", fail);
+	});
+}
+function registerSyncInternalRoutes(ctx, state, nodeSync, sessionSync) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "exact",
+		path: "/api/dshb/sync/internal/handshake",
+		handler: (req, res) => {
+			if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {
+				sendJson(res, 403, {
+					ok: false,
+					error: "loopback access required"
+				});
+				return;
+			}
+			if (req.method !== "GET") {
+				sendJson(res, 405, {
+					ok: false,
+					error: "method not allowed"
+				});
+				return;
+			}
+			try {
+				sendJson(res, 200, {
+					ok: true,
+					protocolVersion: 1,
+					instanceId: state.instanceId(),
+					capabilities: [
+						"peer-handshake",
+						...nodeSync ? ["node-sync"] : [],
+						...sessionSync ? ["session-sync"] : []
+					]
+				});
+			} catch {
+				sendJson(res, 503, {
+					ok: false,
+					error: "sync identity unavailable"
+				});
+			}
+		}
+	}));
+	if (nodeSync) ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: "/api/dshb/sync/internal/nodes",
+		handler: async (req, res) => {
+			if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {
+				sendJson(res, 403, {
+					ok: false,
+					error: "loopback access required"
+				});
+				return;
+			}
+			const segments = pathSegments(req);
+			const action = segments[5];
+			if (segments.length !== 6) {
+				sendJson(res, 404, {
+					ok: false,
+					error: "not found"
+				});
+				return;
+			}
+			if (req.method === "GET" && action === "manifest") {
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						manifest: await nodeSync.exportManifest()
+					});
+				} catch {
+					sendJson(res, 500, {
+						ok: false,
+						error: "node manifest export failed"
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && action === "apply") {
+				const body = await readJsonBody(req);
+				if (!body || !Array.isArray(body.records) || typeof body.sourceName !== "string") {
+					sendJson(res, 400, {
+						ok: false,
+						error: "records and sourceName are required"
+					});
+					return;
+				}
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						result: await nodeSync.applyManifest(body.records, body.sourceName)
+					});
+				} catch (error) {
+					const status = error instanceof SyncNodeManifestError ? 400 : 500;
+					sendJson(res, status, {
+						ok: false,
+						error: status === 400 ? "node manifest rejected" : "node manifest apply failed"
+					});
+				}
+				return;
+			}
+			sendJson(res, 404, {
+				ok: false,
+				error: "not found"
+			});
+		}
+	}));
+	if (!sessionSync) return;
+	ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: "/api/dshb/sync/internal/sessions",
+		handler: async (req, res) => {
+			if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {
+				sendJson(res, 403, {
+					ok: false,
+					error: "loopback access required"
+				});
+				return;
+			}
+			const segments = pathSegments(req);
+			const action = segments[5];
+			if (segments.length !== 6) {
+				sendJson(res, 404, {
+					ok: false,
+					error: "not found"
+				});
+				return;
+			}
+			if (req.method === "GET" && action === "bundle") {
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						bundle: await sessionSync.exportBundle()
+					});
+				} catch (error) {
+					const code = error instanceof SyncSessionError ? error.code : "session-export-failed";
+					sendJson(res, code === "bundle-too-large" ? 413 : 500, {
+						ok: false,
+						code,
+						error: error instanceof SyncSessionError ? error.message : "session bundle export failed"
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && action === "apply") {
+				const body = await readJsonBody(req);
+				if (!body || body.bundle === null || typeof body.bundle !== "object" || typeof body.sourceName !== "string" || typeof body.peerId !== "string" || !/^p-[a-f0-9]{24}$/.test(body.peerId)) {
+					sendJson(res, 400, {
+						ok: false,
+						code: "session-request-invalid",
+						error: "bundle, sourceName, and peerId are required"
+					});
+					return;
+				}
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						result: await sessionSync.applyBundle(body.bundle, body.sourceName, body.peerId)
+					});
+				} catch (error) {
+					const code = error instanceof SyncSessionError ? error.code : "session-apply-failed";
+					sendJson(res, code === "bundle-too-large" ? 413 : [
+						"manifest-invalid",
+						"manifest-digest",
+						"object-invalid",
+						"session-format"
+					].includes(code) ? 400 : code === "workspace-unmapped" ? 409 : 500, {
+						ok: false,
+						code,
+						error: error instanceof SyncSessionError ? error.message : "session bundle apply failed"
+					});
+				}
+				return;
+			}
+			sendJson(res, 404, {
+				ok: false,
+				error: "not found"
+			});
+		}
+	}));
+}
+//#endregion
+export { registerSyncInternalRoutes };
+
+//# sourceMappingURL=internal-routes.js.map

package/lib/core/sync/internal-routes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal-routes.js","names":[],"sources":["../../../src/core/sync/internal-routes.ts"],"sourcesContent":["import type { IncomingMessage, ServerResponse } from 'node:http'\nimport type { Context } from '@deepseek-ai/cordis'\nimport type {} from '@deepseek-ai/dsh-host-webserver'\nimport { isLoopbackRequest } from '../../auth/loopback.js'\nimport { SyncNodeManifestError, type SyncNodeService } from './node-sync.js'\nimport { SyncSessionError, type SyncSessionService } from './session-sync.js'\nimport { MAX_SYNC_TRANSFER_BYTES, SYNC_PROTOCOL_VERSION } from './protocol.js'\nimport type { SyncStateStore } from './stores.js'\n\nconst MAX_APPLY_BODY_BYTES = MAX_SYNC_TRANSFER_BYTES\n\nfunction sendJson(res: ServerResponse, status: number, body: unknown): void {\n  res.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store' })\n  res.end(JSON.stringify(body))\n}\n\nfunction pathSegments(req: IncomingMessage): string[] {\n  return new URL(req.url ?? '/', 'http://x').pathname.split('/').filter(Boolean)\n}\n\nfunction readJsonBody(req: IncomingMessage): Promise<Record<string, unknown> | null> {\n  return new Promise((resolve) => {\n    if (req.headers['content-type']?.split(';', 1)[0]?.trim().toLowerCase() !== 'application/json') {\n      resolve(null)\n      return\n    }\n    const chunks: Buffer[] = []\n    let size = 0\n    let settled = false\n    const fail = (): void => {\n      if (settled) return\n      settled = true\n      resolve(null)\n    }\n    req.on('data', (chunk: Buffer) => {\n      if (settled) return\n      size += chunk.length\n      if (size > MAX_APPLY_BODY_BYTES) {\n        fail()\n        req.destroy()\n        return\n      }\n      chunks.push(chunk)\n    })\n    req.on('end', () => {\n      if (settled) return\n      try {\n        const value: unknown = JSON.parse(Buffer.concat(chunks).toString('utf8'))\n        if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n          fail()\n          return\n        }\n        settled = true\n        resolve(value as Record<string, unknown>)\n      } catch {\n        fail()\n      }\n    })\n    req.on('error', fail)\n  })\n}\n\nexport function registerSyncInternalRoutes(\n  ctx: Context,\n  state: SyncStateStore,\n  nodeSync?: SyncNodeService,\n  sessionSync?: SyncSessionService,\n): void {\n  ctx.effect(() =>\n    ctx.webServer.register({\n      kind: 'exact',\n      path: '/api/dshb/sync/internal/handshake',\n      handler: (req: IncomingMessage, res: ServerResponse) => {\n        if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {\n          sendJson(res, 403, { ok: false, error: 'loopback access required' })\n          return\n        }\n        if (req.method !== 'GET') {\n          sendJson(res, 405, { ok: false, error: 'method not allowed' })\n          return\n        }\n        try {\n          sendJson(res, 200, {\n            ok: true,\n            protocolVersion: SYNC_PROTOCOL_VERSION,\n            instanceId: state.instanceId(),\n            capabilities: [\n              'peer-handshake',\n              ...(nodeSync ? ['node-sync'] : []),\n              ...(sessionSync ? ['session-sync'] : []),\n            ],\n          })\n        } catch {\n          sendJson(res, 503, { ok: false, error: 'sync identity unavailable' })\n        }\n      },\n    }),\n  )\n\n  if (nodeSync) ctx.effect(() =>\n    ctx.webServer.register({\n      kind: 'prefix',\n      path: '/api/dshb/sync/internal/nodes',\n      handler: async (req, res) => {\n        if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {\n          sendJson(res, 403, { ok: false, error: 'loopback access required' })\n          return\n        }\n        const segments = pathSegments(req)\n        const action = segments[5]\n        if (segments.length !== 6) {\n          sendJson(res, 404, { ok: false, error: 'not found' })\n          return\n        }\n        if (req.method === 'GET' && action === 'manifest') {\n          try {\n            sendJson(res, 200, { ok: true, manifest: await nodeSync.exportManifest() })\n          } catch {\n            sendJson(res, 500, { ok: false, error: 'node manifest export failed' })\n          }\n          return\n        }\n        if (req.method === 'POST' && action === 'apply') {\n          const body = await readJsonBody(req)\n          if (!body || !Array.isArray(body.records) || typeof body.sourceName !== 'string') {\n            sendJson(res, 400, { ok: false, error: 'records and sourceName are required' })\n            return\n          }\n          try {\n            sendJson(res, 200, { ok: true, result: await nodeSync.applyManifest(body.records, body.sourceName) })\n          } catch (error) {\n            const status = error instanceof SyncNodeManifestError ? 400 : 500\n            sendJson(res, status, { ok: false, error: status === 400 ? 'node manifest rejected' : 'node manifest apply failed' })\n          }\n          return\n        }\n        sendJson(res, 404, { ok: false, error: 'not found' })\n      },\n    }),\n  )\n\n  if (!sessionSync) return\n  ctx.effect(() =>\n    ctx.webServer.register({\n      kind: 'prefix',\n      path: '/api/dshb/sync/internal/sessions',\n      handler: async (req, res) => {\n        if (!isLoopbackRequest(req.socket.remoteAddress, req.headers.host)) {\n          sendJson(res, 403, { ok: false, error: 'loopback access required' })\n          return\n        }\n        const segments = pathSegments(req)\n        const action = segments[5]\n        if (segments.length !== 6) {\n          sendJson(res, 404, { ok: false, error: 'not found' })\n          return\n        }\n        if (req.method === 'GET' && action === 'bundle') {\n          try {\n            sendJson(res, 200, { ok: true, bundle: await sessionSync.exportBundle() })\n          } catch (error) {\n            const code = error instanceof SyncSessionError ? error.code : 'session-export-failed'\n            const status = code === 'bundle-too-large' ? 413 : 500\n            sendJson(res, status, { ok: false, code, error: error instanceof SyncSessionError ? error.message : 'session bundle export failed' })\n          }\n          return\n        }\n        if (req.method === 'POST' && action === 'apply') {\n          const body = await readJsonBody(req)\n          if (!body || body.bundle === null || typeof body.bundle !== 'object' ||\n            typeof body.sourceName !== 'string' || typeof body.peerId !== 'string' || !/^p-[a-f0-9]{24}$/.test(body.peerId)) {\n            sendJson(res, 400, { ok: false, code: 'session-request-invalid', error: 'bundle, sourceName, and peerId are required' })\n            return\n          }\n          try {\n            sendJson(res, 200, {\n              ok: true,\n              result: await sessionSync.applyBundle(body.bundle, body.sourceName, body.peerId),\n            })\n          } catch (error) {\n            const code = error instanceof SyncSessionError ? error.code : 'session-apply-failed'\n            const status = code === 'bundle-too-large' ? 413\n              : ['manifest-invalid', 'manifest-digest', 'object-invalid', 'session-format'].includes(code) ? 400\n                : code === 'workspace-unmapped' ? 409 : 500\n            sendJson(res, status, { ok: false, code, error: error instanceof SyncSessionError ? error.message : 'session bundle apply failed' })\n          }\n          return\n        }\n        sendJson(res, 404, { ok: false, error: 'not found' })\n      },\n    }),\n  )\n}\n"],"mappings":"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"}

package/lib/core/sync/model.d.ts

@@ -0,0 +1,2 @@
+import { _ as parseSyncPeerDraft, a as SyncPeer, c as SyncProvenance, d as SyncSessionArchive, f as SyncState, g as parseSyncPeer, h as isRecord, i as SyncOrigin, l as SyncRecordMetadata, m as isNonNegativeSafeInteger, n as SyncEntityKind, o as SyncPeerDraft, p as SyncWorkspaceMapping, r as SyncImportMethod, s as SyncPeerProgress, t as SyncDirection, u as SyncSchedule, v as syncRecordKey, y as syncWorkspaceKey } from "../../model-BP7Gw1yk.js";
+export { SyncDirection, SyncEntityKind, SyncImportMethod, SyncOrigin, SyncPeer, SyncPeerDraft, SyncPeerProgress, SyncProvenance, SyncRecordMetadata, SyncSchedule, SyncSessionArchive, SyncState, SyncWorkspaceMapping, isNonNegativeSafeInteger, isRecord, parseSyncPeer, parseSyncPeerDraft, syncRecordKey, syncWorkspaceKey };

package/lib/core/sync/model.js

@@ -0,0 +1,106 @@
+import { posix } from "node:path";
+//#region src/core/sync/model.ts
+const PEER_FIELDS = /* @__PURE__ */ new Set([
+	"id",
+	"name",
+	"host",
+	"port",
+	"username",
+	"authKind",
+	"remoteDshHome",
+	"remoteProfile",
+	"remoteWebPort",
+	"direction",
+	"schedule",
+	"syncSessions",
+	"enabled",
+	"hostKeyFingerprint"
+]);
+const PEER_DRAFT_FIELDS = new Set([...PEER_FIELDS].filter((field) => field !== "id" && field !== "hostKeyFingerprint"));
+function record(value, label) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error(`${label} must be an object`);
+	return value;
+}
+function text(value, label, maxLength) {
+	if (typeof value !== "string") throw new Error(`${label} must be a string`);
+	const result = value.trim();
+	if (!result || result.length > maxLength || /[\u0000-\u001f\u007f]/.test(result)) throw new Error(`${label} is invalid`);
+	return result;
+}
+function optionalText(value, label, maxLength) {
+	return value === void 0 ? void 0 : text(value, label, maxLength);
+}
+function port(value, label) {
+	if (!Number.isSafeInteger(value) || value < 1 || value > 65535) throw new Error(`${label} must be an integer between 1 and 65535`);
+	return value;
+}
+function parseSyncPeer(value) {
+	const input = record(value, "sync peer");
+	for (const key of Object.keys(input)) if (!PEER_FIELDS.has(key)) throw new Error(`sync peer contains unsupported field: ${key}`);
+	const id = text(input.id, "id", 128);
+	if (!/^[a-z][a-z0-9-]*$/.test(id)) throw new Error("id is invalid");
+	const name = text(input.name, "name", 128);
+	const host = text(input.host, "host", 255);
+	if (/\s/.test(host)) throw new Error("host is invalid");
+	const username = text(input.username, "username", 128);
+	if (/\s/.test(username)) throw new Error("username is invalid");
+	if (input.authKind !== "password" && input.authKind !== "key") throw new Error("authKind must be password or key");
+	if (input.direction !== "pull" && input.direction !== "bidirectional") throw new Error("direction must be pull or bidirectional");
+	if (input.schedule !== "manual" && input.schedule !== "every-5m") throw new Error("schedule must be manual or every-5m");
+	if (typeof input.syncSessions !== "boolean" || typeof input.enabled !== "boolean") throw new Error("syncSessions and enabled must be booleans");
+	const remoteDshHome = optionalText(input.remoteDshHome, "remoteDshHome", 4096);
+	if (remoteDshHome !== void 0) {
+		if (!posix.isAbsolute(remoteDshHome) || remoteDshHome.split("/").includes("..") || remoteDshHome.includes("\\")) throw new Error("remoteDshHome must be a normalized absolute path");
+	}
+	const remoteProfile = optionalText(input.remoteProfile, "remoteProfile", 256);
+	const hostKeyFingerprint = optionalText(input.hostKeyFingerprint, "hostKeyFingerprint", 512);
+	return {
+		id,
+		name,
+		host,
+		port: port(input.port, "port"),
+		username,
+		authKind: input.authKind,
+		...remoteDshHome === void 0 ? {} : { remoteDshHome: posix.normalize(remoteDshHome) },
+		...remoteProfile === void 0 ? {} : { remoteProfile },
+		...input.remoteWebPort === void 0 ? {} : { remoteWebPort: port(input.remoteWebPort, "remoteWebPort") },
+		direction: input.direction,
+		schedule: input.schedule,
+		syncSessions: input.syncSessions,
+		enabled: input.enabled,
+		...hostKeyFingerprint === void 0 ? {} : { hostKeyFingerprint }
+	};
+}
+function parseSyncPeerDraft(value) {
+	const input = record(value, "sync peer draft");
+	for (const key of Object.keys(input)) if (!PEER_DRAFT_FIELDS.has(key)) throw new Error(`sync peer draft contains unsupported field: ${key}`);
+	const { id, ...draft } = parseSyncPeer({
+		...input,
+		id: `p-${"0".repeat(24)}`
+	});
+	return draft;
+}
+function syncRecordKey(kind, origin) {
+	return JSON.stringify([
+		kind,
+		origin.originInstanceId,
+		origin.originEntityId
+	]);
+}
+function syncWorkspaceKey(originInstanceId, originWorkspaceId, remotePath) {
+	return JSON.stringify([
+		originInstanceId,
+		originWorkspaceId,
+		remotePath
+	]);
+}
+function isRecord(value) {
+	return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+function isNonNegativeSafeInteger(value) {
+	return Number.isSafeInteger(value) && value >= 0;
+}
+//#endregion
+export { isNonNegativeSafeInteger, isRecord, parseSyncPeer, parseSyncPeerDraft, syncRecordKey, syncWorkspaceKey };
+
+//# sourceMappingURL=model.js.map

package/lib/core/sync/model.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.js","names":[],"sources":["../../../src/core/sync/model.ts"],"sourcesContent":["import { posix } from 'node:path'\nimport type { SyncRevision } from './revision.js'\n\nexport type SyncDirection = 'pull' | 'bidirectional'\nexport type SyncSchedule = 'manual' | 'every-5m'\nexport type SyncEntityKind = 'node' | 'session'\nexport type SyncImportMethod = 'peer' | 'offline'\n\nexport interface SyncPeer {\n  id: string\n  name: string\n  host: string\n  port: number\n  username: string\n  authKind: 'password' | 'key'\n  remoteDshHome?: string\n  remoteProfile?: string\n  remoteWebPort?: number\n  direction: SyncDirection\n  schedule: SyncSchedule\n  syncSessions: boolean\n  enabled: boolean\n  hostKeyFingerprint?: string\n}\n\nexport type SyncPeerDraft = Omit<SyncPeer, 'id' | 'hostKeyFingerprint'>\n\nexport interface SyncOrigin {\n  originInstanceId: string\n  originEntityId: string\n}\n\nexport interface SyncProvenance extends SyncOrigin {\n  localEntityId: string\n  importedVia?: SyncImportMethod\n  sourceName?: string\n}\n\nexport interface SyncRecordMetadata extends SyncProvenance {\n  kind: SyncEntityKind\n  revision: SyncRevision\n  contentDigest: string\n  stateDigest?: string\n  workspaceOrigin?: SyncOrigin\n  deleted?: boolean\n  pendingRemoval?: boolean\n  credentialsRequired?: boolean\n}\n\nexport interface SyncPeerProgress {\n  lastRunAt?: string\n  lastRunStatus?: 'running' | 'succeeded' | 'failed'\n  lastSuccessAt?: string\n  lastManifestDigest?: string\n  watermark?: string\n  lastErrorCode?: string\n  lastErrorMessage?: string\n  lastResult?: {\n    imported: number\n    exported: number\n    skipped: number\n    pendingRemoval: number\n    importedSessions: number\n    exportedSessions: number\n    skippedSessions: number\n  }\n}\n\nexport interface SyncWorkspaceMapping {\n  originInstanceId: string\n  originWorkspaceId: string\n  localWorkspaceId: string\n  localPath: string\n  localNodeId: string\n  remotePath: string\n  title: string\n  revision: SyncRevision\n  contentDigest: string\n}\n\nexport interface SyncSessionArchive {\n  branchId: string\n  originInstanceId: string\n  originSessionId: string\n  localSessionId: string\n  revision: SyncRevision\n  contentDigest: string\n  stateDigest: string\n  workspacePosition: number\n  workspaceId?: string\n  workspaceOrigin?: SyncOrigin\n  archivedAt: string\n}\n\nexport interface SyncState {\n  version: 1\n  clock: { physicalTimeMs: number; logicalCounter: number }\n  peers: Record<string, SyncPeerProgress>\n  records: Record<string, SyncRecordMetadata>\n  workspaces: Record<string, SyncWorkspaceMapping>\n  archives: Record<string, SyncSessionArchive>\n}\n\nconst PEER_FIELDS = new Set([\n  'id',\n  'name',\n  'host',\n  'port',\n  'username',\n  'authKind',\n  'remoteDshHome',\n  'remoteProfile',\n  'remoteWebPort',\n  'direction',\n  'schedule',\n  'syncSessions',\n  'enabled',\n  'hostKeyFingerprint',\n])\n\nconst PEER_DRAFT_FIELDS = new Set([...PEER_FIELDS].filter((field) => field !== 'id' && field !== 'hostKeyFingerprint'))\n\nfunction record(value: unknown, label: string): Record<string, unknown> {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) {\n    throw new Error(`${label} must be an object`)\n  }\n  return value as Record<string, unknown>\n}\n\nfunction text(value: unknown, label: string, maxLength: number): string {\n  if (typeof value !== 'string') throw new Error(`${label} must be a string`)\n  const result = value.trim()\n  if (!result || result.length > maxLength || /[\\u0000-\\u001f\\u007f]/.test(result)) {\n    throw new Error(`${label} is invalid`)\n  }\n  return result\n}\n\nfunction optionalText(value: unknown, label: string, maxLength: number): string | undefined {\n  return value === undefined ? undefined : text(value, label, maxLength)\n}\n\nfunction port(value: unknown, label: string): number {\n  if (!Number.isSafeInteger(value) || (value as number) < 1 || (value as number) > 65535) {\n    throw new Error(`${label} must be an integer between 1 and 65535`)\n  }\n  return value as number\n}\n\nexport function parseSyncPeer(value: unknown): SyncPeer {\n  const input = record(value, 'sync peer')\n  for (const key of Object.keys(input)) {\n    if (!PEER_FIELDS.has(key)) throw new Error(`sync peer contains unsupported field: ${key}`)\n  }\n\n  const id = text(input.id, 'id', 128)\n  if (!/^[a-z][a-z0-9-]*$/.test(id)) throw new Error('id is invalid')\n\n  const name = text(input.name, 'name', 128)\n  const host = text(input.host, 'host', 255)\n  if (/\\s/.test(host)) throw new Error('host is invalid')\n\n  const username = text(input.username, 'username', 128)\n  if (/\\s/.test(username)) throw new Error('username is invalid')\n\n  if (input.authKind !== 'password' && input.authKind !== 'key') {\n    throw new Error('authKind must be password or key')\n  }\n  if (input.direction !== 'pull' && input.direction !== 'bidirectional') {\n    throw new Error('direction must be pull or bidirectional')\n  }\n  if (input.schedule !== 'manual' && input.schedule !== 'every-5m') {\n    throw new Error('schedule must be manual or every-5m')\n  }\n  if (typeof input.syncSessions !== 'boolean' || typeof input.enabled !== 'boolean') {\n    throw new Error('syncSessions and enabled must be booleans')\n  }\n\n  const remoteDshHome = optionalText(input.remoteDshHome, 'remoteDshHome', 4096)\n  if (remoteDshHome !== undefined) {\n    if (!posix.isAbsolute(remoteDshHome) || remoteDshHome.split('/').includes('..') || remoteDshHome.includes('\\\\')) {\n      throw new Error('remoteDshHome must be a normalized absolute path')\n    }\n  }\n\n  const remoteProfile = optionalText(input.remoteProfile, 'remoteProfile', 256)\n  const hostKeyFingerprint = optionalText(input.hostKeyFingerprint, 'hostKeyFingerprint', 512)\n\n  return {\n    id,\n    name,\n    host,\n    port: port(input.port, 'port'),\n    username,\n    authKind: input.authKind,\n    ...(remoteDshHome === undefined ? {} : { remoteDshHome: posix.normalize(remoteDshHome) }),\n    ...(remoteProfile === undefined ? {} : { remoteProfile }),\n    ...(input.remoteWebPort === undefined ? {} : { remoteWebPort: port(input.remoteWebPort, 'remoteWebPort') }),\n    direction: input.direction,\n    schedule: input.schedule,\n    syncSessions: input.syncSessions,\n    enabled: input.enabled,\n    ...(hostKeyFingerprint === undefined ? {} : { hostKeyFingerprint }),\n  }\n}\n\nexport function parseSyncPeerDraft(value: unknown): SyncPeerDraft {\n  const input = record(value, 'sync peer draft')\n  for (const key of Object.keys(input)) {\n    if (!PEER_DRAFT_FIELDS.has(key)) throw new Error(`sync peer draft contains unsupported field: ${key}`)\n  }\n  const { id, ...draft } = parseSyncPeer({ ...input, id: `p-${'0'.repeat(24)}` })\n  void id\n  return draft\n}\n\nexport function syncRecordKey(kind: SyncEntityKind, origin: SyncOrigin): string {\n  return JSON.stringify([kind, origin.originInstanceId, origin.originEntityId])\n}\n\nexport function syncWorkspaceKey(originInstanceId: string, originWorkspaceId: string, remotePath: string): string {\n  return JSON.stringify([originInstanceId, originWorkspaceId, remotePath])\n}\n\nexport function isRecord(value: unknown): value is Record<string, unknown> {\n  return value !== null && typeof value === 'object' && !Array.isArray(value)\n}\n\nexport function isNonNegativeSafeInteger(value: unknown): value is number {\n  return Number.isSafeInteger(value) && (value as number) >= 0\n}\n"],"mappings":"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"}

package/lib/core/sync/node-sync.d.ts

@@ -0,0 +1,2 @@
+import { a as SyncNodeManifestError, c as SyncNodeView, i as SyncNodeManifest, n as SyncNodeEntry, o as SyncNodeProfile, r as SyncNodeInUseError, s as SyncNodeService, t as SyncNodeApplyResult } from "../../node-sync-3Z9QLz2n.js";
+export { SyncNodeApplyResult, SyncNodeEntry, SyncNodeInUseError, SyncNodeManifest, SyncNodeManifestError, SyncNodeProfile, SyncNodeService, SyncNodeView };