@ubean/seo 0.2.2 → 0.3.1

package/dist/conventions.d.ts

@@ -58,6 +58,15 @@ interface LoadedConvention {
  * 不存在的文件被静默跳过。
  */
 declare function discoverSeoConventions(options: RegisterSeoConventionsOptions): Promise<LoadedConvention[]>;
+/** Map `sitemap.ts` / `/src/robots.js` to a convention kind. */
+declare function conventionKindFromPath(filePath: string): SeoConventionKind | undefined;
+/**
+ * Register convention handlers already loaded (production `import.meta.glob`).
+ * Keys may be absolute or vite-style paths; the basename selects the kind.
+ */
+declare function registerSeoConventionModules(app: SeoConventionApp, modules: Record<string, {
+  default?: unknown;
+}>): Promise<SeoConventionKind[]>;
 /**
  * 扫描 srcDir 下的 SEO 约定文件,为每个发现的文件注册 GET 路由。
  *
@@ -74,4 +83,4 @@ declare function registerSeoConventions(app: SeoConventionApp, options: Register
  */
 declare function listSeoConventions(options: Pick<RegisterSeoConventionsOptions, 'srcDir' | 'extensions'>): SeoConventionKind[];
 //#endregion
-export { RegisterSeoConventionsOptions, SEO_CONVENTIONS, SeoConventionApp, SeoConventionContext, SeoConventionDescriptor, SeoConventionKind, discoverSeoConventions, listSeoConventions, registerSeoConventions };
+export { RegisterSeoConventionsOptions, SEO_CONVENTIONS, SeoConventionApp, SeoConventionContext, SeoConventionDescriptor, SeoConventionKind, conventionKindFromPath, discoverSeoConventions, listSeoConventions, registerSeoConventionModules, registerSeoConventions };

package/dist/conventions.js

@@ -19,9 +19,9 @@ import { isAbsolute, join, resolve } from "pathe";
 * 设计要点:
 * - 纯运行时实现(无 Vite 插件依赖):用 `fs.access` 检测文件存在,`import()` 加载。
 * - 不强依赖 `@ubean/app` —— 通过最小化的 `SeoConventionApp` 结构类型避免循环依赖。
-* - 调用方负责在 `defineServer({ onAppCreate })` 或 `app.init()` 前调用
-*   `registerSeoConventions(app, { srcDir })`。`@ubean/app` 的 `UbeanAppOptions.seoConventions`
-*   字段会自动调用此函数(参见 `@ubean/app` 的 `app.ts`)。
+* - 调用方也可手动 `registerSeoConventions(app, { srcDir })`。`createUbeanApp`
+*   在 `init()` 默认调用（`seoConventions: false` 关闭）；生产可传入已 glob 的
+*   `seoConventionModules`，避免 serverless 依赖读盘。
 * - 文件不存在时静默跳过(不报错),允许项目按需采用约定。
 * - 已注册的路由(用户在 `routes/` 显式定义)优先级不变 —— 约定文件在 `init()` 中
 *   于用户路由 *之后* 注册,因此 Hono 路由匹配时显式路由优先。
@@ -114,6 +114,35 @@ async function discoverSeoConventions(options) {
 	}
 	return loaded;
 }
+function basenameWithoutExt(filePath) {
+	return (filePath.replaceAll("\\", "/").split("/").pop() || "").replace(/\.(ts|js|mjs|mts|cjs)$/i, "");
+}
+/** Map `sitemap.ts` / `/src/robots.js` to a convention kind. */
+function conventionKindFromPath(filePath) {
+	const name = basenameWithoutExt(filePath);
+	return SEO_CONVENTIONS.find((d) => d.fileName === name)?.kind;
+}
+function mountConvention(app, descriptor, handler) {
+	app.get(descriptor.routePath, async (c) => toResponse(descriptor, handler, c));
+}
+/**
+* Register convention handlers already loaded (production `import.meta.glob`).
+* Keys may be absolute or vite-style paths; the basename selects the kind.
+*/
+async function registerSeoConventionModules(app, modules) {
+	const registered = [];
+	for (const [filePath, mod] of Object.entries(modules)) {
+		const kind = conventionKindFromPath(filePath);
+		if (!kind) continue;
+		const descriptor = SEO_CONVENTIONS.find((d) => d.kind === kind);
+		if (!descriptor) continue;
+		const handler = mod?.default;
+		if (typeof handler !== "function") continue;
+		mountConvention(app, descriptor, handler);
+		registered.push(kind);
+	}
+	return registered;
+}
 /**
 * 把单个约定文件的 default export 转换为 Hono GET handler。
 *
@@ -151,10 +180,7 @@ async function registerSeoConventions(app, options) {
 	const loaded = await discoverSeoConventions(options);
 	const registered = [];
 	for (const { descriptor, handler } of loaded) {
-		const routePath = descriptor.routePath;
-		app.get(routePath, async (c) => {
-			return await toResponse(descriptor, handler, c);
-		});
+		mountConvention(app, descriptor, handler);
 		registered.push(descriptor.kind);
 	}
 	return registered;
@@ -174,4 +200,4 @@ function listSeoConventions(options) {
 	return found;
 }
 //#endregion
-export { SEO_CONVENTIONS, discoverSeoConventions, listSeoConventions, registerSeoConventions };
+export { SEO_CONVENTIONS, conventionKindFromPath, discoverSeoConventions, listSeoConventions, registerSeoConventionModules, registerSeoConventions };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/seo",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "description": "SEO utilities for ubean (useSeoMeta, robots, sitemap, manifest, file conventions, JSON-LD, OG image)",
   "files": [
     "dist"
@@ -28,13 +28,13 @@
     }
   },
   "dependencies": {
-    "@unhead/vue": "^3.3.2",
+    "@unhead/vue": "^3.4.0",
     "pathe": "^2.0.3"
   },
   "devDependencies": {
-    "@types/node": "^26.2.0",
+    "@types/node": "^26.4.0",
     "typescript": "7.0.2",
-    "vite-plus": "0.2.9"
+    "vite-plus": "0.3.0"
   },
   "peerDependencies": {
     "@resvg/resvg-js": "^2.6.0",