syncorejs 0.2.3 → 0.2.4

package/dist/_vendor/core/cli.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":"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"}
+{"version":3,"file":"cli.d.mts","names":[],"sources":["../src/cli.ts"],"mappings":";;;;UAiFiB,0BAAA;EACf,YAAA;EACA,gBAAgB;AAAA;AAAA,UAGD,aAAA;EACf,aAAA,GAAgB,0BAA0B;EAC1C,YAAA;EACA,gBAAA;AAAA;AAAA,UAGe,kBAAA;EACf,YAAA;EACA,yBAAA;EACA,WAAA;EACA,KAAA;AAAA;AAAA,KAGU,mBAAA;AAAA,iBASI,4BAAA,CACd,QAA6B,EAAnB,mBAAmB;AAAA,UA0Bd,sBAAA;EACf,QAAA,EAAU,mBAAmB;EAC7B,KAAA;AAAA;AAAA,UAGe,qBAAA;EACf,QAAA,EAAU,mBAAmB;EAC7B,OAAA;EACA,OAAA;EACA,OAAA;AAAA;AAAA,UAGQ,gBAAA;EACR,IAAA;EACA,IAAA;EACA,OAAA,GAAU,MAAA;EACV,YAAA,GAAe,MAAA;EACf,eAAA,GAAkB,MAAA;AAAA;AAAA,cAYP,oCAAA;AAAA,cACA,uBAAA,EAAyB,mBAAmB;AAAA,iBA0MnC,aAAA,CAAc,IAAA,cAAsB,OAAO;AAAA,iBAQ3C,UAAA,CAAW,GAAA,WAAc,OAAO;AAAA,iBA2ShC,eAAA,CACpB,GAAA,UACA,OAAA,EAAS,sBAAA,GACR,OAAA,CAAQ,qBAAA;AAAA,iBA+RK,iBAAA,CACd,MAAA,EAAQ,qBAAqB,EAC7B,OAAA;AAAA,iBA6BoB,iBAAA,CAAkB,GAAA,WAAc,OAAO;AAAA,iBAQvC,wBAAA,CACpB,GAAA,UACA,iBAAA,WACC,OAAO,CAAC,mBAAA;AAAA,iBAgBW,qBAAA,CACpB,GAAA,WACC,OAAO,CAAC,mBAAA;AAAA,iBAwCW,eAAA,CACpB,GAAA,WACC,OAAO,CAAC,gBAAA;AAAA,iBAkKW,sBAAA,CACpB,GAAA,UACA,SAAA,UACA,UAAA,WACC,OAAO;AAAA,iBAmEY,sBAAA,CACpB,GAAA,UACA,SAAA,WACC,OAAO;AAAA,iBA2WM,0BAAA,CACd,MAAA,EAAQ,aAAA,GACP,0BAA0B;AAAA,iBAuBP,iBAAA,CAAkB,GAAA,WAAc,OAAO,CAAC,aAAA;AAAA,iBAwBxC,qBAAA,CACpB,GAAA,WACC,OAAA,CAAQ,eAAA,CAAA,aAAA,CAAc,MAAA,SAAe,eAAA,CAAA,kBAAA;AAAA,iBAgBlB,6BAAA,CACpB,GAAA,WACC,OAAO,CAAC,MAAA;AAAA,iBAeW,iBAAA,CACpB,GAAA,WACC,OAAA,CAAQ,eAAA,CAAA,aAAA,CAAc,MAAA,SAAe,eAAA,CAAA,kBAAA;AAAA,iBAuGlB,oBAAA,CACpB,GAAA,WACC,OAAO,CAAC,uBAAA;AAAA,iBAiBW,6BAAA,CACpB,GAAA,WACC,OAAO,CAAC,yBAAA;AAAA,iBAyBW,kBAAA,CAAmB,GAAA,WAAc,OAAA;EACrD,MAAA,EAAQ,eAAA,CAAA,aAAA,CAAc,MAAA,SAAe,eAAA,CAAA,kBAAA;EACrC,SAAA,EAAW,uBAAA;EACX,UAAA,EAAY,yBAAA;AAAA;AAAA,iBA+dQ,kBAAA,CACpB,GAAA,WACC,OAAO,CAAC,eAAA,CAAA,cAAA;AAAA,iBAaW,mBAAA,CACpB,GAAA,UACA,QAAA,EAAU,eAAA,CAAA,cAAA,GACT,OAAO;AAAA,iBASY,sBAAA,CACpB,SAAA,WACC,OAAO;AAAA,iBAeY,sBAAA,CAAuB,GAAA,WAAc,OAAO;AAAA,iBAqH5C,UAAA,CAAW,QAAA,WAAmB,OAAO;AAAA,iBAkD3C,WAAA,CAAY,KAAc;AAAA,iBAOpB,gBAAA,CAAiB,IAAA,WAAe,OAAO;AAAA,iBAuB7C,OAAA,CAAQ,KAAa;AAAA,iBAkCf,WAAA,CAAY,OAAA;EAChC,GAAA;EACA,QAAA,EAAU,mBAAA;AAAA,IACR,OAAA,CAAQ,kBAAA;AAAA,iBA89BU,sBAAA,CACpB,GAAA,UACA,QAAA,EAAU,mBAAA,GACT,OAAO;AAAA,iBAyKM,kBAAA,CACd,mBAAA,UACA,QAAgB"}

package/dist/_vendor/core/cli.mjs

@@ -4,7 +4,8 @@ import { SyncoreRuntime } from "./runtime/runtime.mjs";
 import { createDevtoolsCommandHandler, createDevtoolsSubscriptionHost } from "./runtime/devtools.mjs";
 import { src_exports } from "./index.mjs";
 import { generateDevtoolsToken, isAllowedDashboardOrigin, isAuthorizedDashboardRequest, sanitizeDevtoolsToken } from "./devtools-auth.mjs";
-import { appendFile, mkdir, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { appendFile, mkdir, open, readFile, readdir, rm, stat, writeFile } from "node:fs/promises";
+import { randomUUID } from "node:crypto";
 import { createServer } from "node:http";
 import { connect } from "node:net";
 import path from "node:path";
@@ -36,6 +37,9 @@ const VALID_SYNCORE_TEMPLATES = [
 let pendingDevBootstrap;
 let devBootstrapInFlight = false;
 const PROJECT_TARGET_RUNTIME_ID = "syncore-project-target";
+const STORAGE_ACCESS_TICKET_TTL_MS = 300 * 1e3;
+const STORAGE_ACCESS_CHUNK_BYTES = 1024 * 1024;
+const STORAGE_ACCESS_MAX_PREVIEW_BYTES = 8e4;
 program.name("syncorejs").description("Syncore local-first toolkit CLI").version("0.1.0");
 program.command("init").description("Scaffold Syncore in the current directory").option("--template <template>", `Template to scaffold (${VALID_SYNCORE_TEMPLATES.join(", ")}, or auto)`, "auto").option("--force", "Overwrite Syncore-managed files when they already exist").action(async (options) => {
 	const cwd = process.cwd();
@@ -1161,6 +1165,19 @@ var HubFileStorageAdapter = class {
 			return null;
 		}
 	}
+	async readRange(id, offset, length) {
+		let handle;
+		try {
+			handle = await open(this.filePath(id), "r");
+			const buffer = Buffer.alloc(Math.max(length, 0));
+			const result = await handle.read(buffer, 0, buffer.byteLength, Math.max(offset, 0));
+			return buffer.subarray(0, result.bytesRead);
+		} catch {
+			return null;
+		} finally {
+			await handle?.close();
+		}
+	}
 	async delete(id) {
 		await rm(this.filePath(id), { force: true });
 	}
@@ -1252,6 +1269,11 @@ async function createProjectTargetBackend(cwd, externalChangeSignal) {
 		driver,
 		storage: new HubFileStorageAdapter(storageDirectory),
 		platform: "project",
+		runtimeCapabilities: { storage: {
+			available: true,
+			protocol: "file",
+			supportsRange: true
+		} },
 		...externalChangeSignal ? { externalChangeSignal } : {}
 	});
 	await runtime.start();
@@ -1310,6 +1332,13 @@ function createProjectDevtoolsCapabilities() {
 			mutate: true,
 			importExport: true
 		},
+		storage: {
+			browse: true,
+			download: true,
+			readRange: true,
+			delete: true,
+			maxPreviewBytes: 8e4
+		},
 		scheduler: {
 			read: true,
 			edit: true
@@ -1497,14 +1526,15 @@ async function startDevHub(options) {
 		return await readDevtoolsSessionState(options.cwd) ?? sessionState;
 	}
 	await writeDevtoolsSessionState(options.cwd, sessionState);
-	const httpServer = createServer((_request, response) => {
-		response.writeHead(200, { "content-type": "application/json" });
-		response.end(JSON.stringify({
-			ok: true,
-			wsPort: devtoolsPort
-		}));
+	const httpServer = createServer((request, response) => {
+		handleStorageAccessHttpRequest(request, response).catch((error) => {
+			if (!response.headersSent) writeJsonResponse(response, 500, { error: formatError(error) });
+			else response.destroy(error instanceof Error ? error : void 0);
+		});
 	});
 	const websocketServer = new WebSocketServer({ server: httpServer });
+	const storageAccessTickets = /* @__PURE__ */ new Map();
+	const pendingHubCommands = /* @__PURE__ */ new Map();
 	const runtimeSockets = /* @__PURE__ */ new Map();
 	const runtimeHellos = /* @__PURE__ */ new Map();
 	const runtimeEvents = /* @__PURE__ */ new Map();
@@ -1571,6 +1601,135 @@ async function startDevHub(options) {
 			event
 		})}\n`);
 	};
+	const requestRuntimeCommand = async (targetRuntimeId, payload, timeoutMs = 3e4) => {
+		if (targetRuntimeId === PROJECT_TARGET_RUNTIME_ID && projectTargetBackend) return projectTargetBackend.handleCommand(payload);
+		const target = runtimeSockets.get(targetRuntimeId);
+		if (!target || target.readyState !== WebSocket.OPEN) throw new Error(`Runtime ${targetRuntimeId} is not connected.`);
+		const commandId = `hub:${randomUUID()}`;
+		return await new Promise((resolve, reject) => {
+			const timeout = setTimeout(() => {
+				pendingHubCommands.delete(commandId);
+				reject(/* @__PURE__ */ new Error(`Runtime command ${payload.kind} timed out.`));
+			}, timeoutMs);
+			pendingHubCommands.set(commandId, {
+				resolve,
+				reject,
+				timeout
+			});
+			target.send(JSON.stringify({
+				type: "command",
+				commandId,
+				targetRuntimeId,
+				payload
+			}));
+		});
+	};
+	const createStorageAccessTicket = async (targetRuntimeId, id, purpose) => {
+		const metadata = await requestRuntimeCommand(targetRuntimeId, {
+			kind: "storage.readRange",
+			id,
+			offset: 0,
+			length: 0
+		});
+		if (metadata.kind !== "storage.readRange.result") return {
+			kind: "storage.access.create.result",
+			error: "Runtime returned an unexpected storage access response."
+		};
+		if (metadata.error || !metadata.entry) return {
+			kind: "storage.access.create.result",
+			error: metadata.error ?? "Storage object could not be accessed."
+		};
+		const ticket = randomUUID();
+		const expiresAt = Date.now() + STORAGE_ACCESS_TICKET_TTL_MS;
+		storageAccessTickets.set(ticket, {
+			id: ticket,
+			runtimeId: targetRuntimeId,
+			storageId: id,
+			purpose,
+			entry: metadata.entry,
+			supportsRange: metadata.supportsRange,
+			expiresAt
+		});
+		cleanupExpiredStorageTickets();
+		return {
+			kind: "storage.access.create.result",
+			entry: metadata.entry,
+			url: `http://127.0.0.1:${devtoolsPort}/storage/access/${ticket}`,
+			expiresAt,
+			supportsRange: metadata.supportsRange,
+			maxPreviewBytes: STORAGE_ACCESS_MAX_PREVIEW_BYTES
+		};
+	};
+	const cleanupExpiredStorageTickets = () => {
+		const now = Date.now();
+		for (const [ticket, access] of storageAccessTickets) if (access.expiresAt <= now) storageAccessTickets.delete(ticket);
+	};
+	const handleStorageAccessHttpRequest = async (request, response) => {
+		setStorageCorsHeaders(response);
+		if (request.method === "OPTIONS") {
+			response.writeHead(204);
+			response.end();
+			return;
+		}
+		const requestUrl = new URL(request.url ?? "/", `http://127.0.0.1:${devtoolsPort}`);
+		const match = /^\/storage\/access\/([^/]+)$/.exec(requestUrl.pathname);
+		if (!match) {
+			writeJsonResponse(response, 200, {
+				ok: true,
+				wsPort: devtoolsPort
+			});
+			return;
+		}
+		if (request.method !== "GET" && request.method !== "HEAD") {
+			writeTextResponse(response, 405, "Method not allowed.");
+			return;
+		}
+		cleanupExpiredStorageTickets();
+		const ticket = storageAccessTickets.get(match[1]);
+		if (!ticket || ticket.expiresAt <= Date.now()) {
+			writeTextResponse(response, 401, "Storage access ticket is invalid or expired.");
+			return;
+		}
+		const range = parseStorageRangeHeader(request.headers.range, ticket.entry.size);
+		if ("error" in range) {
+			writeTextResponse(response, range.status, range.error);
+			return;
+		}
+		const start = range.start;
+		const end = range.end;
+		const byteLength = end >= start ? end - start + 1 : 0;
+		if (!ticket.supportsRange && ticket.entry.size > STORAGE_ACCESS_CHUNK_BYTES) {
+			writeTextResponse(response, 409, "This storage backend does not support streaming large files.");
+			return;
+		}
+		writeStorageAccessHeaders(response, ticket, {
+			status: range.partial ? 206 : 200,
+			start,
+			end,
+			byteLength
+		});
+		if (request.method === "HEAD") {
+			response.end();
+			return;
+		}
+		let offset = start;
+		while (offset <= end) {
+			const chunkLength = Math.min(STORAGE_ACCESS_CHUNK_BYTES, end - offset + 1);
+			const chunk = await requestRuntimeCommand(ticket.runtimeId, {
+				kind: "storage.readRange",
+				id: ticket.storageId,
+				offset,
+				length: chunkLength
+			}, 6e4);
+			if (chunk.kind !== "storage.readRange.result") throw new Error("Runtime returned an unexpected storage chunk response.");
+			if (chunk.error || !chunk.base64) throw new Error(chunk.error ?? "Storage chunk could not be read.");
+			const bytes = Buffer.from(chunk.base64, "base64");
+			if (bytes.byteLength === 0) break;
+			await writeResponseChunk(response, bytes);
+			offset += bytes.byteLength;
+		}
+		response.end();
+	};
 	websocketServer.on("connection", (socket, request) => {
 		const isBrowserDashboardClient = isAllowedDashboardOrigin(request.headers.origin, dashboardPort);
 		const isAuthorizedDashboardClient = !isBrowserDashboardClient || isAuthorizedDashboardRequest({
@@ -1616,6 +1775,29 @@ async function startDevHub(options) {
 				if (!isAuthorizedDashboardClient) return;
 				const targetRuntimeId = message.targetRuntimeId;
 				if (!targetRuntimeId) return;
+				if (message.payload.kind === "storage.access.create") {
+					createStorageAccessTicket(targetRuntimeId, message.payload.id, message.payload.purpose).then((payload) => {
+						if (socket.readyState !== WebSocket.OPEN) return;
+						socket.send(JSON.stringify({
+							type: "command.result",
+							commandId: message.commandId,
+							runtimeId: targetRuntimeId,
+							payload
+						}));
+					}).catch((error) => {
+						if (socket.readyState !== WebSocket.OPEN) return;
+						socket.send(JSON.stringify({
+							type: "command.result",
+							commandId: message.commandId,
+							runtimeId: targetRuntimeId,
+							payload: {
+								kind: "storage.access.create.result",
+								error: formatError(error)
+							}
+						}));
+					});
+					return;
+				}
 				if (targetRuntimeId === PROJECT_TARGET_RUNTIME_ID && projectTargetBackend) {
 					(async () => {
 						const payload = await projectTargetBackend.handleCommand(message.payload);
@@ -1719,6 +1901,15 @@ async function startDevHub(options) {
 				appendHubLog(message.event);
 			} else if (message.type === "event") appendHubLog(message.event);
 			if (message.type === "command.result" || message.type === "subscription.data" || message.type === "subscription.error") {
+				if (message.type === "command.result") {
+					const pending = pendingHubCommands.get(message.commandId);
+					if (pending) {
+						clearTimeout(pending.timeout);
+						pendingHubCommands.delete(message.commandId);
+						pending.resolve(message.payload);
+						return;
+					}
+				}
 				for (const client of dashboardSockets) if (client.readyState === WebSocket.OPEN) client.send(encoded);
 				return;
 			}
@@ -1808,6 +1999,80 @@ async function startDevHub(options) {
 	process.on("SIGTERM", close);
 	return sessionState;
 }
+function setStorageCorsHeaders(response) {
+	response.setHeader("Access-Control-Allow-Origin", "*");
+	response.setHeader("Access-Control-Allow-Methods", "GET, HEAD, OPTIONS");
+	response.setHeader("Access-Control-Allow-Headers", "Range");
+	response.setHeader("Access-Control-Expose-Headers", "Accept-Ranges, Content-Disposition, Content-Length, Content-Range, Content-Type");
+}
+function writeJsonResponse(response, status, payload) {
+	response.writeHead(status, { "content-type": "application/json" });
+	response.end(JSON.stringify(payload));
+}
+function writeTextResponse(response, status, message) {
+	response.writeHead(status, { "content-type": "text/plain; charset=utf-8" });
+	response.end(message);
+}
+function parseStorageRangeHeader(header, size) {
+	if (size === 0) {
+		if (!header) return {
+			start: 0,
+			end: -1,
+			partial: false
+		};
+		return {
+			error: "Requested range is not satisfiable.",
+			status: 416
+		};
+	}
+	if (!header) return {
+		start: 0,
+		end: size - 1,
+		partial: false
+	};
+	if (header.includes(",")) return {
+		error: "Multi-range requests are not supported.",
+		status: 416
+	};
+	const match = /^bytes=(\d+)-(\d*)$/.exec(header);
+	if (!match) return {
+		error: "Only simple byte ranges are supported.",
+		status: 416
+	};
+	const start = Number(match[1]);
+	const end = match[2] ? Number(match[2]) : size - 1;
+	if (!Number.isSafeInteger(start) || !Number.isSafeInteger(end) || start < 0 || end < start || start >= size) return {
+		error: "Requested range is not satisfiable.",
+		status: 416
+	};
+	return {
+		start,
+		end: Math.min(end, size - 1),
+		partial: true
+	};
+}
+function writeStorageAccessHeaders(response, ticket, range) {
+	const headers = {
+		"content-type": ticket.entry.contentType ?? "application/octet-stream",
+		"content-length": range.byteLength,
+		"accept-ranges": ticket.supportsRange ? "bytes" : "none",
+		"content-disposition": renderStorageContentDisposition(ticket)
+	};
+	if (range.status === 206) headers["content-range"] = `bytes ${range.start}-${range.end}/${ticket.entry.size}`;
+	response.writeHead(range.status, headers);
+}
+function renderStorageContentDisposition(ticket) {
+	return `${ticket.purpose === "download" ? "attachment" : "inline"}; filename="${sanitizeHeaderFilename(ticket.entry.fileName ?? ticket.entry.id)}"; filename*=UTF-8''${encodeURIComponent(ticket.entry.fileName ?? `${ticket.entry.id}.bin`)}`;
+}
+function sanitizeHeaderFilename(value) {
+	return value.replaceAll(/["\\\r\n]/g, "_");
+}
+async function writeResponseChunk(response, chunk) {
+	if (response.write(chunk)) return;
+	await new Promise((resolve) => {
+		response.once("drain", resolve);
+	});
+}
 async function writeDevtoolsSessionState(cwd, state) {
 	const sessionPath = path.join(cwd, DEVTOOLS_SESSION_FILE);
 	await mkdir(path.dirname(sessionPath), { recursive: true });