@deot/docs-dever 1.0.5 → 1.1.1

package/README.md

@@ -51,7 +51,7 @@ development 和 preview 会保持服务运行；build 在 Vite 构建结束后
 - 在 development 模式注入 `window.__DOCS_RUNTIME__`；
 - 为 workspace 资源提供安全的原始文本响应；`.page.json` 按页面文档（`page`）处理，其余 `.json` 按 sidebar 处理；
 - 在 development 模式开放 `/__docs/events`，以及 `PUT /__docs/page`（只写工作区内、带语言前缀的 `.page.json`）；
-- 为客户端路由提供 HTML history fallback；
+- 为客户端路由提供 HTML history fallback；静态托管若只能配置自定义 404 页，请改用 Client 的 [`@deot/docs:redirect`](../client/README.md) 约定。
 - 在 build 模式复制 Markdown、JSON（含 `.page.json`）、SFC 等静态内容资源；
 - 当当前仓库源码存在时，将 locale、renderer、markdown、playground、theme 包映射到本地入口。
 

package/dist/index.cjs

@@ -227,6 +227,12 @@ var decodeWorkspacePath = (requestUrl, urlPrefix) => {
 	return decoded;
 };
 var isPackageReadme = (relative) => /^[^/]+\/README\.md$/u.test(relative);
+/**
+* 传统 workspace 把语言放在第一段目录，例如 `zh-CN/guide.md`。
+* `docs/`、`src/` 这类共享目录不能当成语言，否则 SSE identity 对不上 Client。
+* @param value
+*/
+var isLocaleDirectory = (value) => /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/u.test(value);
 var getContentType = (extension) => {
 	switch (extension) {
 		case ".md": return "text/markdown; charset=utf-8";
@@ -386,6 +392,8 @@ var configureEvents = (server, workspace, entry, packages, rootReadme) => {
 		res.setHeader("Content-Type", "text/event-stream");
 		res.setHeader("Cache-Control", "no-cache");
 		res.setHeader("Connection", "keep-alive");
+		res.setHeader("X-Accel-Buffering", "no");
+		res.flushHeaders?.();
 		res.write(": connected\n\n");
 		clients.add(res);
 		req.on("close", () => clients.delete(res));
@@ -430,11 +438,18 @@ var configureEvents = (server, workspace, entry, packages, rootReadme) => {
 		}
 		const [lang, ...segments] = relative.split("/");
 		if (!lang || !segments.length) return;
-		const payload = JSON.stringify({
+		const resourceType = getResourceType(relative);
+		const payload = JSON.stringify(isLocaleDirectory(lang) ? {
 			type,
 			lang,
 			source: `./${segments.join("/")}`,
-			resourceType: getResourceType(relative),
+			resourceType,
+			timestamp: Date.now()
+		} : {
+			type,
+			lang: "",
+			source: relative,
+			resourceType,
 			timestamp: Date.now()
 		});
 		clients.forEach((client) => client.write(`data: ${payload}\n\n`));

package/dist/index.js

@@ -198,6 +198,12 @@ var decodeWorkspacePath = (requestUrl, urlPrefix) => {
 	return decoded;
 };
 var isPackageReadme = (relative) => /^[^/]+\/README\.md$/u.test(relative);
+/**
+* 传统 workspace 把语言放在第一段目录，例如 `zh-CN/guide.md`。
+* `docs/`、`src/` 这类共享目录不能当成语言，否则 SSE identity 对不上 Client。
+* @param value
+*/
+var isLocaleDirectory = (value) => /^[a-z]{2}(?:-[A-Za-z0-9]{2,8})*$/u.test(value);
 var getContentType = (extension) => {
 	switch (extension) {
 		case ".md": return "text/markdown; charset=utf-8";
@@ -357,6 +363,8 @@ var configureEvents = (server, workspace, entry, packages, rootReadme) => {
 		res.setHeader("Content-Type", "text/event-stream");
 		res.setHeader("Cache-Control", "no-cache");
 		res.setHeader("Connection", "keep-alive");
+		res.setHeader("X-Accel-Buffering", "no");
+		res.flushHeaders?.();
 		res.write(": connected\n\n");
 		clients.add(res);
 		req.on("close", () => clients.delete(res));
@@ -401,11 +409,18 @@ var configureEvents = (server, workspace, entry, packages, rootReadme) => {
 		}
 		const [lang, ...segments] = relative.split("/");
 		if (!lang || !segments.length) return;
-		const payload = JSON.stringify({
+		const resourceType = getResourceType(relative);
+		const payload = JSON.stringify(isLocaleDirectory(lang) ? {
 			type,
 			lang,
 			source: `./${segments.join("/")}`,
-			resourceType: getResourceType(relative),
+			resourceType,
+			timestamp: Date.now()
+		} : {
+			type,
+			lang: "",
+			source: relative,
+			resourceType,
 			timestamp: Date.now()
 		});
 		clients.forEach((client) => client.write(`data: ${payload}\n\n`));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deot/docs-dever",
-  "version": "1.0.5",
+  "version": "1.1.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",