@yugoo-design/dsh-design-studio-dsh 0.1.2 → 0.2.0

package/lib/index.js

@@ -1,104 +1,11 @@
+import { n as openInstalledSourceFiles, t as kitFileError } from "./kit-files-DKBlBOG8.js";
+import { t as markStudioRemote } from "./remote-method-ab_lHwWN.js";
 import { createRequire } from "node:module";
 import { Service } from "@deepseek-ai/cordis";
-import { Remote, TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
+import { TypertRemoteService } from "@deepseek-ai/dsh-typert-protocol";
 import { DesignKitVersion } from "@yugoo-design/dsh-design-core";
 import { StudioBinaryContentError, StudioBundleSourceService, StudioManagementService, loadStudioKit, snapshotKit } from "@yugoo-design/dsh-design-studio";
 import { dirname, isAbsolute, join, resolve } from "node:path";
-//#region src/kit-files.ts
-/** Installed source reads share the same DSH filesystem containment boundary. */
-const MAX_TEXT_BYTES = 1048576;
-const excludedDirectory = (name) => /^(?:\.git|node_modules)$/iu.test(name);
-/** A code survives the Remote gateway while the message remains useful in the viewer. */
-function kitFileError(code, message) {
-	return Object.assign(/* @__PURE__ */ new Error(`${code}: ${message}`), { code });
-}
-/** One read's installed resource root is the complete filesystem boundary, not its catalog id. */
-async function openInstalledSourceFiles(fs, root, kind = "Bundle") {
-	if (!isAbsolute(root)) throw new Error(`design studio dsh: installed ${kind} resource root must be absolute`);
-	const base = await fs.resolve(root);
-	if ((await fs.stat(base))?.type !== "directory") throw new Error(`design studio dsh: installed ${kind} resource root is not a directory`);
-	const target = async (path) => {
-		const resolved = await fs.resolve(path);
-		if (!fs.contains(base, resolved)) {
-			if (kind === "Kit") throw kitFileError("kit_file.path_forbidden", "Path escapes installed Kit resource root.");
-			throw new Error(`design studio dsh: path escapes installed ${kind} resource root`);
-		}
-		return resolved;
-	};
-	const code = (error) => typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
-	return {
-		async readFile(path) {
-			if (typeof path !== "string" || /[\\:\u0000-\u001f\u007f]/u.test(path) || path.split("/").some((part) => !part || part === "." || part === ".." || excludedDirectory(part))) throw kitFileError("kit_file.path_forbidden", "Invalid Kit file path.");
-			try {
-				const resolved = await target(join(root, path));
-				const info = await fs.stat(resolved);
-				if (info?.type !== "file") throw kitFileError("kit_file.missing", "Kit file not found or not a regular file.");
-				if ((info.size ?? 0) > MAX_TEXT_BYTES) throw kitFileError("kit_file.too_large", "This file exceeds the 1 MiB text viewer limit.");
-				const bytes = await fs.readBytes(resolved, void 0, MAX_TEXT_BYTES);
-				let content;
-				try {
-					content = new TextDecoder("utf-8", {
-						fatal: true,
-						ignoreBOM: true
-					}).decode(bytes);
-				} catch {
-					throw kitFileError("kit_file.binary", "Kit file is binary or invalid UTF-8 text.");
-				}
-				if (content.includes("\0")) throw kitFileError("kit_file.binary", "Kit file is binary, not UTF-8 text.");
-				return { content };
-			} catch (error) {
-				if (code(error) === "FS_TOO_LARGE") throw kitFileError("kit_file.too_large", "This file exceeds the 1 MiB text viewer limit.");
-				if (code(error) === "FS_NOT_FOUND") throw kitFileError("kit_file.missing", "Kit file not found.");
-				if (code(error) === "FS_NOT_TEXT") throw kitFileError("kit_file.binary", "Kit file is binary or invalid UTF-8 text.");
-				throw error;
-			}
-		},
-		listKitRoots: async () => [],
-		async readText(path) {
-			try {
-				return await fs.readText(await target(path));
-			} catch (error) {
-				if (code(error) === "FS_NOT_FOUND") return void 0;
-				if (code(error) === "FS_NOT_TEXT") throw new StudioBinaryContentError(path);
-				throw error;
-			}
-		},
-		async listDir(path) {
-			try {
-				return (await fs.listDir(await target(path))).map((entry) => entry.name);
-			} catch (error) {
-				if (code(error) === "FS_NOT_FOUND" || code(error) === "FS_NOT_DIRECTORY") return [];
-				throw error;
-			}
-		},
-		async isDirectory(path) {
-			try {
-				return (await fs.stat(await target(path)))?.type === "directory";
-			} catch (error) {
-				if (code(error) === "FS_NOT_FOUND") return false;
-				throw error;
-			}
-		},
-		async listFiles(path) {
-			const files = [];
-			let visited = 0;
-			const walk = async (directory, prefix, depth) => {
-				if (depth > 32) throw new Error(`design studio dsh: ${kind} file tree exceeds depth limit`);
-				for (const entry of await fs.listDir(directory)) {
-					if (++visited > 2e4) throw new Error(`design studio dsh: ${kind} file tree exceeds entry limit`);
-					if (kind === "Kit" && excludedDirectory(entry.name)) continue;
-					if (!fs.contains(base, entry.target)) continue;
-					const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
-					if (entry.type === "directory") await walk(entry.target, relative, depth + 1);
-					else if (entry.type === "file") files.push(relative);
-				}
-			};
-			await walk(await target(path), "", 0);
-			return files.sort();
-		}
-	};
-}
-//#endregion
 //#region src/kit-sources.ts
 /** Read-only Kit source access over the DSH host filesystem capability. */
 /**
@@ -439,15 +346,7 @@ function sourceUnavailable(name, error) {
 	}] };
 }
 function markRemote(name, method) {
-	Remote(method, {
-		kind: "method",
-		name,
-		static: false,
-		private: false,
-		addInitializer(initializer) {
-			initializer.call(Object.create(DshStudioManagementService.prototype));
-		}
-	});
+	markStudioRemote(DshStudioManagementService.prototype, name, method);
 }
 markRemote("workspace", DshStudioManagementService.prototype.workspace);
 markRemote("readKitWorkspace", DshStudioManagementService.prototype.readKitWorkspace);

package/lib/kit-files-DKBlBOG8.js

@@ -0,0 +1,159 @@
+import { StudioBinaryContentError } from "@yugoo-design/dsh-design-studio";
+import { isAbsolute, join } from "node:path";
+//#region src/kit-files.ts
+/** Installed source reads share the same DSH filesystem containment boundary. */
+const MAX_TEXT_BYTES = 1048576;
+const excludedDirectory = (name) => /^(?:\.git|node_modules)$/iu.test(name);
+/** A code survives the Remote gateway while the message remains useful in the viewer. */
+function kitFileError(code, message) {
+	return Object.assign(/* @__PURE__ */ new Error(`${code}: ${message}`), { code });
+}
+/** One read's installed resource root is the complete filesystem boundary, not its catalog id. */
+async function openInstalledSourceFiles(fs, root, kind = "Bundle") {
+	if (!isAbsolute(root)) throw new Error(`design studio dsh: installed ${kind} resource root must be absolute`);
+	const base = await fs.resolve(root);
+	if ((await fs.stat(base))?.type !== "directory") throw new Error(`design studio dsh: installed ${kind} resource root is not a directory`);
+	const target = async (path) => {
+		const resolved = await fs.resolve(path);
+		if (!fs.contains(base, resolved)) {
+			if (kind === "Kit") throw kitFileError("kit_file.path_forbidden", "Path escapes installed Kit resource root.");
+			throw new Error(`design studio dsh: path escapes installed ${kind} resource root`);
+		}
+		return resolved;
+	};
+	const code = (error) => typeof error === "object" && error !== null && "code" in error ? error.code : void 0;
+	return {
+		async captureTree() {
+			const files = [], seen = /* @__PURE__ */ new Set();
+			let visited = 0, total = 0;
+			const limit = (message) => kitFileError("studio.source_limit", message);
+			const invalid = (message) => kitFileError("studio.source_invalid", message);
+			const unchanged = async (item, before) => {
+				const after = await fs.stat(item);
+				if (!before || !after || before.type !== after.type || before.version !== after.version || before.size !== after.size) throw kitFileError("studio.source_changed", "Installed source changed during capture. Retry the exact source.");
+			};
+			const walk = async (directory, prefix, observed) => {
+				if (seen.has(directory.targetKey)) throw invalid("Repeated directory identity in installed source.");
+				seen.add(directory.targetKey);
+				const info = observed ?? await fs.stat(directory);
+				if (info?.type !== "directory") throw invalid("Installed source directory is missing or not a directory.");
+				const entries = await fs.listDir(directory);
+				visited += entries.length;
+				if (visited > 2e4) throw limit("Installed source exceeds 20000 directory entries.");
+				const names = /* @__PURE__ */ new Set();
+				for (const entry of entries) {
+					if (typeof entry.name !== "string" || !entry.name || /[\\/:\u0000-\u001f\u007f]/u.test(entry.name) || [
+						".",
+						"..",
+						"__proto__",
+						"constructor",
+						"prototype"
+					].includes(entry.name) || names.has(entry.name)) throw invalid("Invalid or duplicate installed source entry name.");
+					names.add(entry.name);
+				}
+				for (const entry of [...entries].sort((a, b) => a.name < b.name ? -1 : a.name > b.name ? 1 : 0)) {
+					if (excludedDirectory(entry.name)) continue;
+					if (!fs.contains(base, entry.target)) throw kitFileError("studio.source_forbidden", "Capture target escapes installed resource root.");
+					const path = prefix ? `${prefix}/${entry.name}` : entry.name;
+					if (path.length > 1024 || path.split("/").length > 32) throw limit("Installed source exceeds path length or depth limit.");
+					const before = await fs.stat(entry.target);
+					if (!before || before.type !== entry.type) throw invalid("Installed source entry changed or has invalid metadata.");
+					if (entry.version !== void 0 && entry.version !== before.version || entry.size !== void 0 && before.size !== void 0 && entry.size !== before.size) throw kitFileError("studio.source_changed", "Listed source metadata differs from its first stat.");
+					if (entry.type === "directory") await walk(entry.target, path, before);
+					else if (entry.type === "file") {
+						if (files.length >= 4096 || (before.size ?? entry.size ?? 0) > 16777216 - total) throw limit("Installed source exceeds 4096 files or 16 MiB.");
+						let bytes;
+						try {
+							bytes = await fs.readBytes(entry.target, void 0, 16777216 - total);
+						} catch (error) {
+							if (code(error) === "FS_TOO_LARGE") throw limit("Installed source exceeds 16 MiB.");
+							throw error;
+						}
+						if (!(bytes instanceof Uint8Array) || bytes.byteLength > 16777216 - total) throw limit("Installed source exceeds its byte budget.");
+						if (before.size !== void 0 && bytes.byteLength !== before.size || entry.size !== void 0 && bytes.byteLength !== entry.size) throw kitFileError("studio.source_changed", "Source byte length differs from its observed metadata.");
+						await unchanged(entry.target, before);
+						total += bytes.byteLength;
+						files.push({
+							path,
+							base64: Buffer.from(bytes).toString("base64")
+						});
+					} else throw invalid("Installed source contains a non-regular entry.");
+				}
+				await unchanged(directory, info);
+			};
+			await walk(await target(root), "");
+			return files.sort((a, b) => a.path < b.path ? -1 : a.path > b.path ? 1 : 0);
+		},
+		async readFile(path) {
+			if (typeof path !== "string" || /[\\:\u0000-\u001f\u007f]/u.test(path) || path.split("/").some((part) => !part || part === "." || part === ".." || excludedDirectory(part))) throw kitFileError("kit_file.path_forbidden", "Invalid Kit file path.");
+			try {
+				const resolved = await target(join(root, path));
+				const info = await fs.stat(resolved);
+				if (info?.type !== "file") throw kitFileError("kit_file.missing", "Kit file not found or not a regular file.");
+				if ((info.size ?? 0) > MAX_TEXT_BYTES) throw kitFileError("kit_file.too_large", "This file exceeds the 1 MiB text viewer limit.");
+				const bytes = await fs.readBytes(resolved, void 0, MAX_TEXT_BYTES);
+				let content;
+				try {
+					content = new TextDecoder("utf-8", {
+						fatal: true,
+						ignoreBOM: true
+					}).decode(bytes);
+				} catch {
+					throw kitFileError("kit_file.binary", "Kit file is binary or invalid UTF-8 text.");
+				}
+				if (content.includes("\0")) throw kitFileError("kit_file.binary", "Kit file is binary, not UTF-8 text.");
+				return { content };
+			} catch (error) {
+				if (code(error) === "FS_TOO_LARGE") throw kitFileError("kit_file.too_large", "This file exceeds the 1 MiB text viewer limit.");
+				if (code(error) === "FS_NOT_FOUND") throw kitFileError("kit_file.missing", "Kit file not found.");
+				if (code(error) === "FS_NOT_TEXT") throw kitFileError("kit_file.binary", "Kit file is binary or invalid UTF-8 text.");
+				throw error;
+			}
+		},
+		listKitRoots: async () => [],
+		async readText(path) {
+			try {
+				return await fs.readText(await target(path));
+			} catch (error) {
+				if (code(error) === "FS_NOT_FOUND") return void 0;
+				if (code(error) === "FS_NOT_TEXT") throw new StudioBinaryContentError(path);
+				throw error;
+			}
+		},
+		async listDir(path) {
+			try {
+				return (await fs.listDir(await target(path))).map((entry) => entry.name);
+			} catch (error) {
+				if (code(error) === "FS_NOT_FOUND" || code(error) === "FS_NOT_DIRECTORY") return [];
+				throw error;
+			}
+		},
+		async isDirectory(path) {
+			try {
+				return (await fs.stat(await target(path)))?.type === "directory";
+			} catch (error) {
+				if (code(error) === "FS_NOT_FOUND") return false;
+				throw error;
+			}
+		},
+		async listFiles(path) {
+			const files = [];
+			let visited = 0;
+			const walk = async (directory, prefix, depth) => {
+				if (depth > 32) throw new Error(`design studio dsh: ${kind} file tree exceeds depth limit`);
+				for (const entry of await fs.listDir(directory)) {
+					if (++visited > 2e4) throw new Error(`design studio dsh: ${kind} file tree exceeds entry limit`);
+					if (kind === "Kit" && excludedDirectory(entry.name)) continue;
+					if (!fs.contains(base, entry.target)) continue;
+					const relative = prefix ? `${prefix}/${entry.name}` : entry.name;
+					if (entry.type === "directory") await walk(entry.target, relative, depth + 1);
+					else if (entry.type === "file") files.push(relative);
+				}
+			};
+			await walk(await target(path), "", 0);
+			return files.sort();
+		}
+	};
+}
+//#endregion
+export { openInstalledSourceFiles as n, kitFileError as t };