@artenx/dshb 0.1.18 → 0.1.20

package/lib/core/sync/session-journal.js

@@ -0,0 +1,191 @@
+import { homedir } from "node:os";
+import { chmodSync, closeSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+import { createHash, randomBytes } from "node:crypto";
+//#region src/core/sync/session-journal.ts
+function sessionHome(home) {
+	return home ?? process.env.DSH_HOME ?? join(homedir(), ".dsh");
+}
+function validBatch(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+	const batch = value;
+	return typeof batch.peerId === "string" && /^p-[a-f0-9]{24}$/.test(batch.peerId) && typeof batch.sourceName === "string" && batch.sourceName.length <= 128 && !/[\u0000-\u001f\u007f]/.test(batch.sourceName) && typeof batch.bundleDigest === "string" && /^sha256:[a-f0-9]{64}$/.test(batch.bundleDigest) && typeof batch.startedAt === "string" && batch.startedAt.length <= 64 && Array.isArray(batch.recordKeys) && batch.recordKeys.every((key) => typeof key === "string" && key.length <= 8192) && (batch.importedVia === void 0 || batch.importedVia === "peer" || batch.importedVia === "offline") && (batch.allowSameInstance === void 0 || typeof batch.allowSameInstance === "boolean");
+}
+function validateJournal(value) {
+	if (value === null || typeof value !== "object" || Array.isArray(value)) throw new Error("Invalid sync session journal");
+	const journal = value;
+	if (journal.version !== 1 || journal.batches === null || typeof journal.batches !== "object" || Array.isArray(journal.batches)) throw new Error("Invalid sync session journal");
+	const batches = Object.create(null);
+	for (const [id, batch] of Object.entries(journal.batches)) {
+		if (!/^b-[a-f0-9]{32}$/.test(id) || !validBatch(batch)) throw new Error("Invalid sync session journal batch");
+		batches[id] = {
+			...batch,
+			importedVia: batch.importedVia ?? "peer",
+			allowSameInstance: batch.allowSameInstance ?? false,
+			recordKeys: [...batch.recordKeys]
+		};
+	}
+	return {
+		version: 1,
+		batches
+	};
+}
+function atomicWrite(path, value) {
+	mkdirSync(join(path, ".."), {
+		recursive: true,
+		mode: 448
+	});
+	const temporary = `${path}.${process.pid}.${randomBytes(6).toString("hex")}.tmp`;
+	let descriptor;
+	try {
+		descriptor = openSync(temporary, "wx", 384);
+		writeFileSync(descriptor, `${JSON.stringify(value, null, 2)}\n`, "utf8");
+		fsyncSync(descriptor);
+		closeSync(descriptor);
+		descriptor = void 0;
+		renameSync(temporary, path);
+		chmodSync(path, 384);
+	} catch (error) {
+		if (descriptor !== void 0) closeSync(descriptor);
+		try {
+			unlinkSync(temporary);
+		} catch (cleanupError) {
+			if (!(cleanupError instanceof Error) || !("code" in cleanupError) || cleanupError.code !== "ENOENT") throw new AggregateError([error, cleanupError], "session journal write and cleanup failed");
+		}
+		throw error;
+	}
+}
+var SyncSessionJournalStore = class {
+	home;
+	filePath;
+	data;
+	constructor(home) {
+		this.home = sessionHome(home);
+		this.filePath = join(this.home, "dshb", "sync-session-journal.json");
+	}
+	begin(peerId, sourceName, bundleDigest, recordKeys, startedAt = (/* @__PURE__ */ new Date()).toISOString(), importedVia = "peer", allowSameInstance = false) {
+		const batchId = `b-${createHash("sha256").update(JSON.stringify([peerId, bundleDigest])).digest("hex").slice(0, 32)}`;
+		const data = this.load();
+		const existing = data.batches[batchId];
+		const batch = {
+			peerId,
+			sourceName,
+			bundleDigest,
+			startedAt: existing?.startedAt ?? startedAt,
+			recordKeys: [.../* @__PURE__ */ new Set([...existing?.recordKeys ?? [], ...recordKeys])],
+			importedVia,
+			allowSameInstance
+		};
+		data.batches[batchId] = batch;
+		this.save();
+		return batchId;
+	}
+	beginWithBundle(peerId, sourceName, bundleDigest, recordKeys, bundle, startedAt = (/* @__PURE__ */ new Date()).toISOString(), importedVia = "peer", allowSameInstance = false) {
+		const batchId = `b-${createHash("sha256").update(JSON.stringify([peerId, bundleDigest])).digest("hex").slice(0, 32)}`;
+		this.writeBundle(batchId, bundle);
+		if (this.begin(peerId, sourceName, bundleDigest, recordKeys, startedAt, importedVia, allowSameInstance) !== batchId) throw new Error("Session journal batch identity changed");
+		return batchId;
+	}
+	pendingPeerIds() {
+		return [...new Set(Object.values(this.load().batches).map((batch) => batch.peerId))];
+	}
+	pendingBatches() {
+		return Object.entries(this.load().batches).map(([batchId, batch]) => ({
+			batchId,
+			peerId: batch.peerId,
+			sourceName: batch.sourceName,
+			bundleDigest: batch.bundleDigest,
+			importedVia: batch.importedVia ?? "peer",
+			allowSameInstance: batch.allowSameInstance ?? false
+		}));
+	}
+	findBatch(peerId, bundleDigest) {
+		const match = Object.entries(this.load().batches).find(([, batch]) => batch.peerId === peerId && batch.bundleDigest === bundleDigest);
+		if (!match) return void 0;
+		const [batchId, batch] = match;
+		return {
+			batchId,
+			peerId: batch.peerId,
+			sourceName: batch.sourceName,
+			bundleDigest: batch.bundleDigest,
+			importedVia: batch.importedVia ?? "peer",
+			allowSameInstance: batch.allowSameInstance ?? false
+		};
+	}
+	writeBundle(batchId, value) {
+		if (!/^b-[a-f0-9]{32}$/.test(batchId)) throw new Error("Invalid sync session batch ID");
+		atomicWrite(this.bundlePath(batchId), value);
+	}
+	readBundle(batchId) {
+		try {
+			return JSON.parse(readFileSync(this.bundlePath(batchId), "utf8"));
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+			throw error;
+		}
+	}
+	writePrepared(batchId, recordKey, value) {
+		if (!/^b-[a-f0-9]{32}$/.test(batchId)) throw new Error("Invalid sync session batch ID");
+		atomicWrite(this.preparedPath(batchId, recordKey), value);
+	}
+	readPrepared(batchId, recordKey) {
+		const file = this.preparedPath(batchId, recordKey);
+		try {
+			return JSON.parse(readFileSync(file, "utf8"));
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return void 0;
+			throw error;
+		}
+	}
+	complete(batchId) {
+		const data = this.load();
+		delete data.batches[batchId];
+		this.save();
+		rmSync(join(this.home, "dshb", "sync-session-staging", batchId), {
+			recursive: true,
+			force: true
+		});
+	}
+	cleanupOrphanedStaging() {
+		const root = join(this.home, "dshb", "sync-session-staging");
+		let entries;
+		try {
+			entries = readdirSync(root, { withFileTypes: true });
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") return;
+			throw error;
+		}
+		const activeBatches = new Set(Object.keys(this.load().batches));
+		for (const entry of entries) if (entry.isDirectory() && /^b-[a-f0-9]{32}$/.test(entry.name) && !activeBatches.has(entry.name)) rmSync(join(root, entry.name), {
+			recursive: true,
+			force: true
+		});
+	}
+	preparedPath(batchId, recordKey) {
+		const digest = createHash("sha256").update(recordKey).digest("hex");
+		return join(this.home, "dshb", "sync-session-staging", batchId, `${digest}.json`);
+	}
+	bundlePath(batchId) {
+		return join(this.home, "dshb", "sync-session-staging", batchId, "bundle.json");
+	}
+	load() {
+		if (this.data) return this.data;
+		try {
+			this.data = validateJournal(JSON.parse(readFileSync(this.filePath, "utf8")));
+		} catch (error) {
+			if (error instanceof Error && "code" in error && error.code === "ENOENT") this.data = {
+				version: 1,
+				batches: {}
+			};
+			else throw error;
+		}
+		return this.data;
+	}
+	save() {
+		atomicWrite(this.filePath, this.load());
+	}
+};
+//#endregion
+export { SyncSessionJournalStore };
+
+//# sourceMappingURL=session-journal.js.map

package/lib/core/sync/session-journal.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-journal.js","names":[],"sources":["../../../src/core/sync/session-journal.ts"],"sourcesContent":["import { createHash, randomBytes } from 'node:crypto'\nimport { chmodSync, closeSync, fsyncSync, mkdirSync, openSync, readFileSync, readdirSync, renameSync, rmSync, unlinkSync, writeFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'node:path'\nimport type { Dirent } from 'node:fs'\nimport type { SyncImportMethod } from './model.js'\n\ninterface JournalBatch {\n  peerId: string\n  sourceName: string\n  bundleDigest: string\n  startedAt: string\n  recordKeys: string[]\n  importedVia?: SyncImportMethod\n  allowSameInstance?: boolean\n}\n\ninterface JournalData {\n  version: 1\n  batches: Record<string, JournalBatch>\n}\n\nfunction sessionHome(home?: string): string {\n  return home ?? process.env.DSH_HOME ?? join(homedir(), '.dsh')\n}\n\nfunction validBatch(value: unknown): value is JournalBatch {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) return false\n  const batch = value as Record<string, unknown>\n  return typeof batch.peerId === 'string' && /^p-[a-f0-9]{24}$/.test(batch.peerId) &&\n    typeof batch.sourceName === 'string' && batch.sourceName.length <= 128 && !/[\\u0000-\\u001f\\u007f]/.test(batch.sourceName) &&\n    typeof batch.bundleDigest === 'string' && /^sha256:[a-f0-9]{64}$/.test(batch.bundleDigest) &&\n    typeof batch.startedAt === 'string' && batch.startedAt.length <= 64 &&\n    Array.isArray(batch.recordKeys) && batch.recordKeys.every((key) => typeof key === 'string' && key.length <= 8192) &&\n    (batch.importedVia === undefined || batch.importedVia === 'peer' || batch.importedVia === 'offline') &&\n    (batch.allowSameInstance === undefined || typeof batch.allowSameInstance === 'boolean')\n}\n\nfunction validateJournal(value: unknown): JournalData {\n  if (value === null || typeof value !== 'object' || Array.isArray(value)) throw new Error('Invalid sync session journal')\n  const journal = value as Record<string, unknown>\n  if (journal.version !== 1 || journal.batches === null || typeof journal.batches !== 'object' || Array.isArray(journal.batches)) {\n    throw new Error('Invalid sync session journal')\n  }\n  const batches = Object.create(null) as Record<string, JournalBatch>\n  for (const [id, batch] of Object.entries(journal.batches)) {\n    if (!/^b-[a-f0-9]{32}$/.test(id) || !validBatch(batch)) throw new Error('Invalid sync session journal batch')\n    batches[id] = {\n      ...batch,\n      importedVia: batch.importedVia ?? 'peer',\n      allowSameInstance: batch.allowSameInstance ?? false,\n      recordKeys: [...batch.recordKeys],\n    }\n  }\n  return { version: 1, batches }\n}\n\nfunction atomicWrite(path: string, value: unknown): void {\n  mkdirSync(join(path, '..'), { recursive: true, mode: 0o700 })\n  const temporary = `${path}.${process.pid}.${randomBytes(6).toString('hex')}.tmp`\n  let descriptor: number | undefined\n  try {\n    descriptor = openSync(temporary, 'wx', 0o600)\n    writeFileSync(descriptor, `${JSON.stringify(value, null, 2)}\\n`, 'utf8')\n    fsyncSync(descriptor)\n    closeSync(descriptor)\n    descriptor = undefined\n    renameSync(temporary, path)\n    chmodSync(path, 0o600)\n  } catch (error) {\n    if (descriptor !== undefined) closeSync(descriptor)\n    try {\n      unlinkSync(temporary)\n    } catch (cleanupError) {\n      if (!(cleanupError instanceof Error) || !('code' in cleanupError) || cleanupError.code !== 'ENOENT') {\n        throw new AggregateError([error, cleanupError], 'session journal write and cleanup failed')\n      }\n    }\n    throw error\n  }\n}\n\nexport class SyncSessionJournalStore {\n  private readonly home: string\n  private readonly filePath: string\n  private data: JournalData | undefined\n\n  constructor(home?: string) {\n    this.home = sessionHome(home)\n    this.filePath = join(this.home, 'dshb', 'sync-session-journal.json')\n  }\n\n  begin(\n    peerId: string,\n    sourceName: string,\n    bundleDigest: string,\n    recordKeys: readonly string[],\n    startedAt = new Date().toISOString(),\n    importedVia: SyncImportMethod = 'peer',\n    allowSameInstance = false,\n  ): string {\n    const batchId = `b-${createHash('sha256').update(JSON.stringify([peerId, bundleDigest])).digest('hex').slice(0, 32)}`\n    const data = this.load()\n    const existing = data.batches[batchId]\n    const batch: JournalBatch = {\n      peerId,\n      sourceName,\n      bundleDigest,\n      startedAt: existing?.startedAt ?? startedAt,\n      recordKeys: [...new Set([...(existing?.recordKeys ?? []), ...recordKeys])],\n      importedVia,\n      allowSameInstance,\n    }\n    data.batches[batchId] = batch\n    this.save()\n    return batchId\n  }\n\n  beginWithBundle(\n    peerId: string,\n    sourceName: string,\n    bundleDigest: string,\n    recordKeys: readonly string[],\n    bundle: unknown,\n    startedAt = new Date().toISOString(),\n    importedVia: SyncImportMethod = 'peer',\n    allowSameInstance = false,\n  ): string {\n    const batchId = `b-${createHash('sha256').update(JSON.stringify([peerId, bundleDigest])).digest('hex').slice(0, 32)}`\n    this.writeBundle(batchId, bundle)\n    const registered = this.begin(\n      peerId,\n      sourceName,\n      bundleDigest,\n      recordKeys,\n      startedAt,\n      importedVia,\n      allowSameInstance,\n    )\n    if (registered !== batchId) throw new Error('Session journal batch identity changed')\n    return batchId\n  }\n\n  pendingPeerIds(): string[] {\n    return [...new Set(Object.values(this.load().batches).map((batch) => batch.peerId))]\n  }\n\n  pendingBatches(): Array<{ batchId: string; peerId: string; sourceName: string; bundleDigest: string; importedVia: SyncImportMethod; allowSameInstance: boolean }> {\n    return Object.entries(this.load().batches).map(([batchId, batch]) => ({\n      batchId,\n      peerId: batch.peerId,\n      sourceName: batch.sourceName,\n      bundleDigest: batch.bundleDigest,\n      importedVia: batch.importedVia ?? 'peer',\n      allowSameInstance: batch.allowSameInstance ?? false,\n    }))\n  }\n\n  findBatch(peerId: string, bundleDigest: string): {\n    batchId: string\n    peerId: string\n    sourceName: string\n    bundleDigest: string\n    importedVia: SyncImportMethod\n    allowSameInstance: boolean\n  } | undefined {\n    const match = Object.entries(this.load().batches).find(([, batch]) =>\n      batch.peerId === peerId && batch.bundleDigest === bundleDigest,\n    )\n    if (!match) return undefined\n    const [batchId, batch] = match\n    return {\n      batchId,\n      peerId: batch.peerId,\n      sourceName: batch.sourceName,\n      bundleDigest: batch.bundleDigest,\n      importedVia: batch.importedVia ?? 'peer',\n      allowSameInstance: batch.allowSameInstance ?? false,\n    }\n  }\n\n  writeBundle(batchId: string, value: unknown): void {\n    if (!/^b-[a-f0-9]{32}$/.test(batchId)) throw new Error('Invalid sync session batch ID')\n    atomicWrite(this.bundlePath(batchId), value)\n  }\n\n  readBundle(batchId: string): unknown | undefined {\n    try {\n      return JSON.parse(readFileSync(this.bundlePath(batchId), 'utf8')) as unknown\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined\n      throw error\n    }\n  }\n\n  writePrepared(batchId: string, recordKey: string, value: unknown): void {\n    if (!/^b-[a-f0-9]{32}$/.test(batchId)) throw new Error('Invalid sync session batch ID')\n    const file = this.preparedPath(batchId, recordKey)\n    atomicWrite(file, value)\n  }\n\n  readPrepared(batchId: string, recordKey: string): unknown | undefined {\n    const file = this.preparedPath(batchId, recordKey)\n    try {\n      return JSON.parse(readFileSync(file, 'utf8')) as unknown\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return undefined\n      throw error\n    }\n  }\n\n  complete(batchId: string): void {\n    const data = this.load()\n    delete data.batches[batchId]\n    this.save()\n    rmSync(join(this.home, 'dshb', 'sync-session-staging', batchId), { recursive: true, force: true })\n  }\n\n  cleanupOrphanedStaging(): void {\n    const root = join(this.home, 'dshb', 'sync-session-staging')\n    let entries: Dirent[]\n    try {\n      entries = readdirSync(root, { withFileTypes: true })\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') return\n      throw error\n    }\n    const activeBatches = new Set(Object.keys(this.load().batches))\n    for (const entry of entries) {\n      if (entry.isDirectory() && /^b-[a-f0-9]{32}$/.test(entry.name) && !activeBatches.has(entry.name)) {\n        rmSync(join(root, entry.name), { recursive: true, force: true })\n      }\n    }\n  }\n\n  private preparedPath(batchId: string, recordKey: string): string {\n    const digest = createHash('sha256').update(recordKey).digest('hex')\n    return join(this.home, 'dshb', 'sync-session-staging', batchId, `${digest}.json`)\n  }\n\n  private bundlePath(batchId: string): string {\n    return join(this.home, 'dshb', 'sync-session-staging', batchId, 'bundle.json')\n  }\n\n  private load(): JournalData {\n    if (this.data) return this.data\n    try {\n      this.data = validateJournal(JSON.parse(readFileSync(this.filePath, 'utf8')) as unknown)\n    } catch (error) {\n      if (error instanceof Error && 'code' in error && error.code === 'ENOENT') {\n        this.data = { version: 1, batches: {} }\n      } else {\n        throw error\n      }\n    }\n    return this.data\n  }\n\n  private save(): void {\n    atomicWrite(this.filePath, this.load())\n  }\n}\n"],"mappings":"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"}

package/lib/core/sync/session-routes.d.ts

@@ -0,0 +1,7 @@
+import { c as SyncSessionService } from "../../session-sync-g6qKZzjV.js";
+import { Context } from "@deepseek-ai/cordis";
+//#region src/core/sync/session-routes.d.ts
+declare function registerSyncSessionRoutes(ctx: Context, sessions: SyncSessionService): void;
+//#endregion
+export { registerSyncSessionRoutes };
+//# sourceMappingURL=session-routes.d.ts.map

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

@@ -0,0 +1,67 @@
+import { t as SyncSessionError } from "../../session-sync-EdfwUON5.js";
+//#region src/core/sync/session-routes.ts
+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 registerSyncSessionRoutes(ctx, sessions) {
+	ctx.effect(() => ctx.webServer.register({
+		kind: "prefix",
+		path: "/api/dshb/sync/archives",
+		handler: async (req, res) => {
+			const segments = pathSegments(req);
+			if (req.method === "GET" && segments.length === 4) {
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						archives: sessions.listArchives()
+					});
+				} catch {
+					sendJson(res, 500, {
+						ok: false,
+						error: "session archive list unavailable"
+					});
+				}
+				return;
+			}
+			if (req.method === "POST" && segments.length === 6 && segments[5] === "restore") {
+				const branchId = segments[4];
+				if (!/^b-[a-f0-9]{32}$/.test(branchId)) {
+					sendJson(res, 400, {
+						ok: false,
+						error: "invalid session branch ID"
+					});
+					return;
+				}
+				try {
+					sendJson(res, 200, {
+						ok: true,
+						sessionId: await sessions.restoreArchive(branchId)
+					});
+				} catch (error) {
+					const code = error instanceof SyncSessionError ? error.code : "session-restore-failed";
+					sendJson(res, code === "archive-not-found" ? 404 : 409, {
+						ok: false,
+						code,
+						error: error instanceof SyncSessionError ? error.message : "session archive restore failed"
+					});
+				}
+				return;
+			}
+			sendJson(res, 404, {
+				ok: false,
+				error: "not found"
+			});
+		}
+	}));
+}
+//#endregion
+export { registerSyncSessionRoutes };
+
+//# sourceMappingURL=session-routes.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"session-routes.js","names":[],"sources":["../../../src/core/sync/session-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 { SyncSessionError, SyncSessionService } from './session-sync.js'\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\nexport function registerSyncSessionRoutes(ctx: Context, sessions: SyncSessionService): void {\n  ctx.effect(() =>\n    ctx.webServer.register({\n      kind: 'prefix',\n      path: '/api/dshb/sync/archives',\n      handler: async (req, res) => {\n        const segments = pathSegments(req)\n        if (req.method === 'GET' && segments.length === 4) {\n          try {\n            sendJson(res, 200, { ok: true, archives: sessions.listArchives() })\n          } catch {\n            sendJson(res, 500, { ok: false, error: 'session archive list unavailable' })\n          }\n          return\n        }\n        if (req.method === 'POST' && segments.length === 6 && segments[5] === 'restore') {\n          const branchId = segments[4]\n          if (!/^b-[a-f0-9]{32}$/.test(branchId)) {\n            sendJson(res, 400, { ok: false, error: 'invalid session branch ID' })\n            return\n          }\n          try {\n            const sessionId = await sessions.restoreArchive(branchId)\n            sendJson(res, 200, { ok: true, sessionId })\n          } catch (error) {\n            const code = error instanceof SyncSessionError ? error.code : 'session-restore-failed'\n            sendJson(res, code === 'archive-not-found' ? 404 : 409, {\n              ok: false,\n              code,\n              error: error instanceof SyncSessionError ? error.message : 'session archive restore failed',\n            })\n          }\n          return\n        }\n        sendJson(res, 404, { ok: false, error: 'not found' })\n      },\n    }),\n  )\n}\n"],"mappings":";;AAKA,SAAS,SAAS,KAAqB,QAAgB,MAAqB;CAC1E,IAAI,UAAU,QAAQ;EAAE,gBAAgB;EAAoB,iBAAiB;CAAW,CAAC;CACzF,IAAI,IAAI,KAAK,UAAU,IAAI,CAAC;AAC9B;AAEA,SAAS,aAAa,KAAgC;CACpD,OAAO,IAAI,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,CAAC,CAAC,OAAO,OAAO;AAC/E;AAEA,SAAgB,0BAA0B,KAAc,UAAoC;CAC1F,IAAI,aACF,IAAI,UAAU,SAAS;EACrB,MAAM;EACN,MAAM;EACN,SAAS,OAAO,KAAK,QAAQ;GAC3B,MAAM,WAAW,aAAa,GAAG;GACjC,IAAI,IAAI,WAAW,SAAS,SAAS,WAAW,GAAG;IACjD,IAAI;KACF,SAAS,KAAK,KAAK;MAAE,IAAI;MAAM,UAAU,SAAS,aAAa;KAAE,CAAC;IACpE,QAAQ;KACN,SAAS,KAAK,KAAK;MAAE,IAAI;MAAO,OAAO;KAAmC,CAAC;IAC7E;IACA;GACF;GACA,IAAI,IAAI,WAAW,UAAU,SAAS,WAAW,KAAK,SAAS,OAAO,WAAW;IAC/E,MAAM,WAAW,SAAS;IAC1B,IAAI,CAAC,mBAAmB,KAAK,QAAQ,GAAG;KACtC,SAAS,KAAK,KAAK;MAAE,IAAI;MAAO,OAAO;KAA4B,CAAC;KACpE;IACF;IACA,IAAI;KAEF,SAAS,KAAK,KAAK;MAAE,IAAI;MAAM,WAAA,MADP,SAAS,eAAe,QAAQ;KACf,CAAC;IAC5C,SAAS,OAAO;KACd,MAAM,OAAO,iBAAiB,mBAAmB,MAAM,OAAO;KAC9D,SAAS,KAAK,SAAS,sBAAsB,MAAM,KAAK;MACtD,IAAI;MACJ;MACA,OAAO,iBAAiB,mBAAmB,MAAM,UAAU;KAC7D,CAAC;IACH;IACA;GACF;GACA,SAAS,KAAK,KAAK;IAAE,IAAI;IAAO,OAAO;GAAY,CAAC;EACtD;CACF,CAAC,CACH;AACF"}

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

@@ -0,0 +1,2 @@
+import { a as SyncSessionError, c as SyncSessionService, d as WorkspaceRegistryLike, f as makeSyncSessionBundle, i as SyncSessionEntry, l as SyncSessionTransferPlan, m as validateSyncSessionBundle, n as SyncSessionApplyResult, o as SyncSessionInstructionSnapshot, p as planSessionTransfers, r as SyncSessionBundle, s as SyncSessionObject, t as SyncSessionApplyOptions, u as SyncSessionWorkspace } from "../../session-sync-g6qKZzjV.js";
+export { SyncSessionApplyOptions, SyncSessionApplyResult, SyncSessionBundle, SyncSessionEntry, SyncSessionError, SyncSessionInstructionSnapshot, SyncSessionObject, SyncSessionService, SyncSessionTransferPlan, SyncSessionWorkspace, WorkspaceRegistryLike, makeSyncSessionBundle, planSessionTransfers, validateSyncSessionBundle };

package/lib/core/sync/session-sync.js

@@ -0,0 +1,2 @@
+import { a as validateSyncSessionBundle, i as planSessionTransfers, n as SyncSessionService, r as makeSyncSessionBundle, t as SyncSessionError } from "../../session-sync-EdfwUON5.js";
+export { SyncSessionError, SyncSessionService, makeSyncSessionBundle, planSessionTransfers, validateSyncSessionBundle };

package/lib/core/sync/ssh-transport.d.ts

@@ -0,0 +1,2 @@
+import { a as SyncSshTransport, i as SyncSshSession, n as SyncSshErrorCategory, o as buildSyncSshConnectConfig, r as SyncSshProbeError, t as SyncRemoteHandshake } from "../../ssh-transport-BcIiLxsX.js";
+export { SyncRemoteHandshake, SyncSshErrorCategory, SyncSshProbeError, SyncSshSession, SyncSshTransport, buildSyncSshConnectConfig };