dsh-any-background 0.2.2 → 0.2.4

package/lib/index.js

@@ -24,6 +24,8 @@ const WALLPAPER_FILE = "wallpaper.jpg";
 const VIDEO_ROUTE = "/dsh-any-background/video";
 const UPLOAD_ROUTE = "/dsh-any-background/video/upload";
 const UPLOAD_TMP = "wallpaper.upload.tmp";
+const WALLPAPER_FETCH_MAX = 26214400;
+const WALLPAPER_FETCH_TIMEOUT = 2e4;
 function videoFileName(mime) {
 	switch (mime) {
 		case "video/mp4": return "wallpaper.mp4";
@@ -278,6 +280,94 @@ async function writeWallpaper(dataUrl) {
 		return false;
 	}
 }
+/** Sniff an image's MIME from its leading magic bytes (defaults to JPEG). */
+function sniffImageMime(buf) {
+	if (buf.length >= 4 && buf[0] === 137 && buf[1] === 80 && buf[2] === 78 && buf[3] === 71) return "image/png";
+	if (buf.length >= 3 && buf[0] === 255 && buf[1] === 216 && buf[2] === 255) return "image/jpeg";
+	if (buf.length >= 6 && buf[0] === 71 && buf[1] === 73 && buf[2] === 70) return "image/gif";
+	if (buf.length >= 12 && buf[0] === 82 && buf[1] === 73 && buf[2] === 70 && buf[3] === 70 && buf[8] === 87 && buf[9] === 69 && buf[10] === 66 && buf[11] === 80) return "image/webp";
+	return "image/jpeg";
+}
+/** Download a wallpaper from a network URL and persist it into the local
+*  wallpaper.jpg slot (replacing whatever was stored), so type switches,
+*  export and import keep working through the existing data-URL path.
+*  null removes the wallpaper. Returns { ok, dataUrl?, error? }. */
+async function writeWallpaperFromUrl(url) {
+	if (url === null) {
+		const ok = await writeWallpaper(null);
+		return {
+			ok,
+			dataUrl: null,
+			error: ok ? void 0 : "remove failed"
+		};
+	}
+	let u;
+	try {
+		u = new URL(url);
+	} catch {
+		return {
+			ok: false,
+			error: "invalid url"
+		};
+	}
+	if (u.protocol !== "http:" && u.protocol !== "https:") return {
+		ok: false,
+		error: "unsupported scheme"
+	};
+	let res;
+	try {
+		const ctl = new AbortController();
+		const timer = setTimeout(() => ctl.abort(), WALLPAPER_FETCH_TIMEOUT);
+		try {
+			res = await fetch(url, {
+				redirect: "follow",
+				signal: ctl.signal
+			});
+		} finally {
+			clearTimeout(timer);
+		}
+	} catch (e) {
+		return {
+			ok: false,
+			error: e instanceof Error && e.name === "AbortError" ? "timeout" : "network error"
+		};
+	}
+	if (!res.ok) return {
+		ok: false,
+		error: `http ${res.status}`
+	};
+	const ct = res.headers.get("content-type") ?? "";
+	if (ct && !/^image\//.test(ct)) return {
+		ok: false,
+		error: "not an image"
+	};
+	let buf;
+	try {
+		const arr = await res.arrayBuffer();
+		if (arr.byteLength === 0) return {
+			ok: false,
+			error: "empty response"
+		};
+		if (arr.byteLength > WALLPAPER_FETCH_MAX) return {
+			ok: false,
+			error: "too large"
+		};
+		buf = Buffer.from(arr);
+	} catch {
+		return {
+			ok: false,
+			error: "read failed"
+		};
+	}
+	const dataUrl = `data:${sniffImageMime(buf)};base64,${buf.toString("base64")}`;
+	return await writeWallpaper(dataUrl) ? {
+		ok: true,
+		dataUrl
+	} : {
+		ok: false,
+		error: "write failed"
+	};
+}
 async function videoUrl() {
 	return await findVideoFile() ? VIDEO_ROUTE : null;
 }
@@ -447,65 +537,164 @@ async function handleVideoUpload(req, res) {
 	}
 }
 const NS = "dshAnyBackground";
-function apply(ctx) {
-	const dispose = ctx.connection.rpc.handle("/dsh-any-background", async (ep, payload) => {
-		const method = ep.slice(`${NS}/`.length);
-		try {
-			switch (method) {
-				case "read": return {
-					ok: true,
-					value: {
-						config: await readConfig(),
-						wallpaper: await readWallpaper(),
-						videoUrl: await videoUrl()
-					}
-				};
-				case "writeConfig": return {
-					ok: true,
-					value: await writeConfig(payload?.config ?? {})
-				};
-				case "setWallpaper": return {
-					ok: true,
-					value: await writeWallpaper(payload?.dataUrl ?? null)
-				};
-				case "setVideo": return {
-					ok: true,
-					value: await writeVideo(payload?.dataUrl ?? null)
-				};
-				default: return {
-					ok: false,
-					error: {
-						code: "bad-request",
-						message: `unknown endpoint ${ep}`,
-						details: { issues: [] }
-					}
-				};
-			}
-		} catch (e) {
-			return {
+const RPC_CHANNEL = "/dsh-any-background";
+const RPC_BODY_MAX = 314572800;
+/** Dispatch one decoded RPC method to the matching persistence routine and
+*  return the wire `result` half of the server-response envelope. */
+async function handleRpcMethod(endpoint, payload) {
+	const method = endpoint.slice(`${NS}/`.length);
+	try {
+		switch (method) {
+			case "read": return {
+				ok: true,
+				value: {
+					config: await readConfig(),
+					wallpaper: await readWallpaper(),
+					videoUrl: await videoUrl()
+				}
+			};
+			case "writeConfig": return {
+				ok: true,
+				value: await writeConfig(payload?.config ?? {})
+			};
+			case "setWallpaper": return {
+				ok: true,
+				value: await writeWallpaper(payload?.dataUrl ?? null)
+			};
+			case "setVideo": return {
+				ok: true,
+				value: await writeVideo(payload?.dataUrl ?? null)
+			};
+			case "setWallpaperUrl": return {
+				ok: true,
+				value: await writeWallpaperFromUrl(payload?.url ?? null)
+			};
+			default: return {
 				ok: false,
 				error: {
-					code: "internal",
-					message: e instanceof Error ? e.message : String(e),
-					details: {}
+					code: "dsh-any-background/bad-request",
+					message: `unknown endpoint ${endpoint}`,
+					details: { issues: [] }
 				}
 			};
 		}
-	}, { authority: "trusted-host" });
-	const disposeRoute = ctx.webServer.register({
-		kind: "prefix",
-		path: VIDEO_ROUTE,
-		handler: serveVideo
-	});
-	const disposeUpload = ctx.webServer.register({
-		kind: "exact",
-		path: UPLOAD_ROUTE,
-		handler: handleVideoUpload
-	});
-	ctx.on("dispose", () => {
-		disposeRoute();
-		disposeUpload();
-		dispose();
+	} catch (e) {
+		return {
+			ok: false,
+			error: {
+				code: "dsh-any-background/internal",
+				message: e instanceof Error ? e.message : String(e),
+				details: {}
+			}
+		};
+	}
+}
+function apply(ctx) {
+	ctx.inject(["connection", "webServer"], (webCtx) => {
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "prefix",
+			path: RPC_CHANNEL,
+			handler: async (req, res) => {
+				const rejection = webCtx.connection.requestRejection(req);
+				if (rejection !== void 0) {
+					res.writeHead(rejection);
+					res.end(rejection === 401 ? "unauthorized" : "forbidden");
+					return;
+				}
+				if (req.method !== "POST") {
+					res.writeHead(405, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({
+						ok: false,
+						error: {
+							code: "dsh-any-background/bad-request",
+							message: "expected POST",
+							details: {}
+						}
+					}));
+					return;
+				}
+				const pathname = new URL(req.url ?? "/", "http://dsh.internal").pathname;
+				const endpoint = pathname.startsWith(`${RPC_CHANNEL}/`) ? pathname.slice(20) : void 0;
+				if (endpoint === void 0 || endpoint.length === 0) {
+					res.writeHead(404);
+					res.end();
+					return;
+				}
+				const chunks = [];
+				let received = 0;
+				for await (const chunk of req) {
+					const buf = chunk;
+					received += buf.byteLength;
+					if (received > RPC_BODY_MAX) {
+						res.writeHead(413, { connection: "close" });
+						res.end();
+						req.destroy();
+						return;
+					}
+					chunks.push(buf);
+				}
+				let env;
+				try {
+					env = JSON.parse(Buffer.concat(chunks).toString("utf8") || "{}");
+				} catch {
+					res.writeHead(400, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({
+						ok: false,
+						error: {
+							code: "dsh-any-background/bad-request",
+							message: "body is not JSON",
+							details: {}
+						}
+					}));
+					return;
+				}
+				if (env === null || typeof env !== "object" || env.type !== "client-request" || typeof env.rpcId !== "string" || typeof env.method !== "string") {
+					res.writeHead(400, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({
+						ok: false,
+						error: {
+							code: "dsh-any-background/bad-request",
+							message: "invalid client-request envelope",
+							details: {}
+						}
+					}));
+					return;
+				}
+				if (env.method !== endpoint) {
+					res.writeHead(200, { "Content-Type": "application/json" });
+					res.end(JSON.stringify({
+						type: "server-response",
+						rpcId: env.rpcId,
+						result: {
+							ok: false,
+							error: {
+								code: "dsh-any-background/bad-request",
+								message: `method ${env.method} does not match endpoint ${endpoint}`,
+								details: { issues: [] }
+							}
+						}
+					}));
+					return;
+				}
+				const result = await handleRpcMethod(endpoint, env.payload);
+				res.writeHead(200, { "Content-Type": "application/json" });
+				res.end(JSON.stringify({
+					type: "server-response",
+					rpcId: env.rpcId,
+					result
+				}));
+			}
+		}), "dsh-any-background: rpc channel");
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "prefix",
+			path: VIDEO_ROUTE,
+			handler: serveVideo
+		}), "dsh-any-background: video route");
+		webCtx.effect(() => webCtx.webServer.register({
+			kind: "exact",
+			path: UPLOAD_ROUTE,
+			handler: handleVideoUpload
+		}), "dsh-any-background: upload route");
 	});
 }
 //#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-any-background",
-  "version": "0.2.2",
+  "version": "0.2.4",
   "description": "Appearance plugin for DeepSeek Harness: custom theme color (PS-style color wheel), background wallpaper with opacity/blur controls, and separate main/settings interface opacity.",
   "keywords": [
     "deepseek-harness",
@@ -22,6 +22,9 @@
   "license": "MIT",
   "author": "Tkingxiao",
   "type": "module",
+  "engines": {
+    "dsh": ">=0.1.2-rc.1"
+  },
   "exports": {
     ".": {
       "default": "./lib/index.js"
@@ -63,14 +66,13 @@
     "@deepseek-ai/dsh-home-paths": "^0.1.0-rc.6"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-client-locale": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/cordis": "^4.0.2",
+    "@deepseek-ai/dsh-client-locale": "^0.1.2-alpha.2",
     "@deepseek-ai/dsh-client-store": "^0.1.2-alpha.2",
-    "@deepseek-ai/dsh-client-connection": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-client-ui-theme": "^0.1.0-rc.6",
-    "@deepseek-ai/dsh-invariants": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-connection": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-client-ui-theme": "^0.1.2-alpha.2",
+    "@deepseek-ai/dsh-invariants": "^0.1.2-alpha.2",
     "react": "^18.2.0"
   },
   "peerDependenciesMeta": {
@@ -89,9 +91,6 @@
     "@deepseek-ai/dsh-client-ui-settings": {
       "optional": true
     },
-    "@deepseek-ai/dsh-client-runtime": {
-      "optional": true
-    },
     "@deepseek-ai/dsh-client-ui-theme": {
       "optional": true
     },
@@ -109,13 +108,11 @@
     "client": {
       "platform": "web",
       "inject": [
-        "@deepseek-ai/dsh-client-runtime",
         "@deepseek-ai/dsh-client-store",
         "@deepseek-ai/dsh-client-locale",
         "@deepseek-ai/dsh-client-connection",
         "@deepseek-ai/dsh-client-ui-theme",
-        "@deepseek-ai/dsh-client-ui-settings",
-        "@deepseek-ai/dsh-client-ui-renderer"
+        "@deepseek-ai/dsh-client-ui-settings"
       ],
       "immediately": true
     }