twikoo-vercel 1.7.23 → 2.0.0-beta.1

package/README.md

@@ -1,13 +1,20 @@
-# Vercel
+# twikoo-vercel
 
-本目录存储 Vercel serverless functions 代码
+Twikoo 2.0 服务端适配器。业务逻辑在 `@twikoojs/common`，本包仅做平台入口与注入。
 
-## 开发帮助文档
+## 部署（Vercel）
 
-https://vercel.com/docs/configuration
+1. Vercel → New Project → 导入仓库（或 `vercel deploy`）
+2. 环境变量：`MONGODB_URI`（必填，Atlas/自建 Mongo 连接串）
+3. 部署完成后前端配置 API 地址为部署域名
 
-https://vercel.com/docs/runtimes
+## 平台核对清单（查阅日期 2026-09-17）
 
-https://docs.mongodb.com/drivers/node/quick-start/
+- [x] Serverless Function `(req, res)` 签名与 body 自动解析（vercel.com/docs/functions）
+- [x] Node runtime 版本与默认值（项目 settings 或 vercel.json 指定 20+）
+- [ ] 函数超时与区域配置实测（人工项）
+- [ ] 冷启动与 Mongo 连接复用实测（人工项）
 
-http://mongodb.github.io/node-mongodb-native/3.6/api/
+## 环境
+
+- `MONGODB_URI`：Mongo 连接串（必填）

package/dist/index.d.mts

@@ -0,0 +1,46 @@
+import { Database, PostSubmitDispatcher, TkRequest, TkResponse } from "@twikoojs/common";
+//#region src/main.d.ts
+/** Vercel 请求的最小结构面（Node IncomingMessage + Vercel 扩展） */
+interface VercelRequestLike {
+  method?: string;
+  headers: Record<string, string | string[] | undefined>;
+  query?: Record<string, string | string[] | undefined>;
+  body?: unknown;
+  url?: string;
+}
+/** Vercel 响应的最小结构面（Node ServerResponse） */
+interface VercelResponseLike {
+  status(code: number): VercelResponseLike;
+  setHeader(name: string, value: string): VercelResponseLike;
+  json(body: unknown): VercelResponseLike;
+  end(): VercelResponseLike;
+}
+/**
+ * Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。
+ * @param req Vercel/Node 请求
+ * @returns 内部统一请求
+ */
+export declare function toTkRequest(req: VercelRequestLike): TkRequest;
+/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */
+export declare function fromTkResponse(res: VercelResponseLike, tkRes: TkResponse): void;
+/**
+ * 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。
+ * @param options 注入项（database：Database 实现；mongoUri：连接串覆写）
+ * @returns 逐请求处理器 `(req, res) => Promise<void>`
+ */
+export declare function createVercelFunc(options?: {
+  database?: Database;
+  mongoUri?: string;
+}): (req: VercelRequestLike, res: VercelResponseLike) => Promise<void>;
+/**
+ * Vercel Serverless Function 默认入口。
+ * @param req Vercel/Node 请求
+ * @param res Vercel/Node 响应
+ */
+export default function vercelHandler(req: VercelRequestLike, res: VercelResponseLike): Promise<void>;
+//#endregion
+//#region src/dispatch.d.ts
+/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */
+export declare const vercelPostSubmitDispatcher: PostSubmitDispatcher;
+//#endregion
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.ts

@@ -0,0 +1,46 @@
+import { Database, PostSubmitDispatcher, TkRequest, TkResponse } from "@twikoojs/common";
+//#region src/main.d.ts
+/** Vercel 请求的最小结构面（Node IncomingMessage + Vercel 扩展） */
+interface VercelRequestLike {
+  method?: string;
+  headers: Record<string, string | string[] | undefined>;
+  query?: Record<string, string | string[] | undefined>;
+  body?: unknown;
+  url?: string;
+}
+/** Vercel 响应的最小结构面（Node ServerResponse） */
+interface VercelResponseLike {
+  status(code: number): VercelResponseLike;
+  setHeader(name: string, value: string): VercelResponseLike;
+  json(body: unknown): VercelResponseLike;
+  end(): VercelResponseLike;
+}
+/**
+ * Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。
+ * @param req Vercel/Node 请求
+ * @returns 内部统一请求
+ */
+export declare function toTkRequest(req: VercelRequestLike): TkRequest;
+/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */
+export declare function fromTkResponse(res: VercelResponseLike, tkRes: TkResponse): void;
+/**
+ * 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。
+ * @param options 注入项（database：Database 实现；mongoUri：连接串覆写）
+ * @returns 逐请求处理器 `(req, res) => Promise<void>`
+ */
+export declare function createVercelFunc(options?: {
+  database?: Database;
+  mongoUri?: string;
+}): (req: VercelRequestLike, res: VercelResponseLike) => Promise<void>;
+/**
+ * Vercel Serverless Function 默认入口。
+ * @param req Vercel/Node 请求
+ * @param res Vercel/Node 响应
+ */
+export default function vercelHandler(req: VercelRequestLike, res: VercelResponseLike): Promise<void>;
+//#endregion
+//#region src/dispatch.d.ts
+/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */
+export declare const vercelPostSubmitDispatcher: PostSubmitDispatcher;
+//#endregion
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,146 @@
+Object.defineProperties(exports, {
+	__esModule: { value: true },
+	[Symbol.toStringTag]: { value: "Module" }
+});
+let _twikoojs_common = require("@twikoojs/common");
+//#region src/dispatch.ts
+/**
+* Vercel 的 POST_SUBMIT 派发实现（规范「后置副作用异步语义」）。
+*
+* **1.x 语义对齐**：COMMENT_SUBMIT 保存评论后，用 **HTTP 递归自调用**把
+* POST_SUBMIT 送到另一个函数实例执行——垃圾检测与邮件/IM 通知因此拥有
+* 独立的执行时间预算，既不会拖慢用户请求，也不会因为用户请求的超时上限
+* 而整条失败（1.x 实现见 `src/server/vercel/api/index.js` 的 `commentSubmit`）。
+*
+* **为什么放在适配器**：这是平台专有机制，common 不应感知。平台相关部分只有
+* 两处：
+* - 自身地址：`TWIKOO_SELF_URL`（显式覆写）→ `VERCEL_URL`（平台注入）；
+* - 内部派发令牌：走 `x-twikoo-recursion` 请求头（1.x 同名，跨版本可互认）。
+*
+* 副作用链本身仍在 common 的 postSubmit 服务里。
+*/
+/**
+* 派发等待上限（毫秒）。1.x 为 `Promise.race` 5 秒：超时只表示「本请求不再
+* 继续等」，被调用的实例仍在自己的预算内跑完副作用。
+*/
+const DISPATCH_TIMEOUT_MS = 5e3;
+/**
+* 解析自身函数地址（显式覆写优先，其次平台注入的 VERCEL_URL）。
+* @returns 绝对地址；两者皆缺失时为空串
+*/
+function resolveSelfUrl() {
+	const explicit = process.env.TWIKOO_SELF_URL;
+	if (explicit) return explicit;
+	const vercelUrl = process.env.VERCEL_URL;
+	return vercelUrl ? `https://${vercelUrl}` : "";
+}
+/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */
+const vercelPostSubmitDispatcher = { 
+/**
+* 自调用本函数执行 POST_SUBMIT（不等待副作用完成，只等有界竞速）。
+* @param comment 已入库的评论
+* @param ctx 当前请求上下文（用于取递归令牌与记录日志）
+*/
+async dispatch(comment, ctx) {
+	const url = resolveSelfUrl();
+	if (!url) {
+		ctx.logger.warn("POST_SUBMIT 派发跳过：未取到自身地址（TWIKOO_SELF_URL / VERCEL_URL）");
+		return;
+	}
+	const axios = await (0, _twikoojs_common.getAxios)();
+	await Promise.race([axios.post(url, {
+		event: "POST_SUBMIT",
+		comment
+	}, { headers: { [_twikoojs_common.RECURSION_HEADER]: (0, _twikoojs_common.getRecursionToken)(ctx.config) } }), new Promise((resolve) => setTimeout(resolve, DISPATCH_TIMEOUT_MS))]);
+} };
+//#endregion
+//#region src/main.ts
+/**
+* twikoo-vercel 主逻辑（Vercel 薄适配器，规范）。
+* 业务逻辑全部在 @twikoojs/common；平台核对：vercel.com/docs/functions（查阅 2026-09-17）。
+*
+* 后置副作用（垃圾检测 + 通知）经 {@link vercelPostSubmitDispatcher} 以
+* HTTP 递归自调用派发到独立执行单元，见 `./dispatch.ts`。
+*/
+/** Vercel 平台能力：全能力（能力矩阵）*/
+const vercelCapabilities = _twikoojs_common.FULL_CAPABILITIES;
+/**
+* Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。
+* @param req Vercel/Node 请求
+* @returns 内部统一请求
+*/
+function toTkRequest(req) {
+	const headers = {};
+	for (const [key, value] of Object.entries(req.headers ?? {})) if (value !== void 0) headers[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;
+	const query = {};
+	for (const [key, value] of Object.entries(req.query ?? {})) query[key] = Array.isArray(value) ? String(value[0]) : String(value ?? "");
+	const forwarded = headers["x-forwarded-for"];
+	const ip = headers["x-real-ip"] ?? (forwarded ? forwarded.split(",")[0].trim() : "") ?? "";
+	const body = req.body && typeof req.body === "object" ? req.body : {};
+	return {
+		method: String(req.method ?? "POST").toUpperCase(),
+		path: String(req.url ?? "/"),
+		query,
+		body,
+		headers,
+		ip,
+		raw: req
+	};
+}
+/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */
+function fromTkResponse(res, tkRes) {
+	res.status(tkRes.status);
+	for (const [name, value] of Object.entries(tkRes.headers)) res.setHeader(name, value);
+	if (tkRes.status === 204) {
+		res.end();
+		return;
+	}
+	res.json(tkRes.body);
+}
+/**
+* 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。
+* @param options 注入项（database：Database 实现；mongoUri：连接串覆写）
+* @returns 逐请求处理器 `(req, res) => Promise<void>`
+*/
+function createVercelFunc(options = {}) {
+	let database = options.database ?? null;
+	/** 懒建连（inject 优先；init 幂等） */
+	const getDatabase = async () => {
+		database ??= new _twikoojs_common.MongoDatabase({ uri: options.mongoUri ?? process.env.MONGODB_URI ?? "" });
+		await database.init();
+		return database;
+	};
+	return async (req, res) => {
+		const request = toTkRequest(req);
+		fromTkResponse(res, await (0, _twikoojs_common.createHandler)((0, _twikoojs_common.scaffoldAdapters)({
+			request: { 
+			/** 事件即请求体（闭包透传，见 toTkRequest） */
+toTkRequest: () => request },
+			response: { 
+			/** TkResponse 恒等透传（平台写入见 fromTkResponse） */
+fromTkResponse: (r) => r },
+			database: await getDatabase(),
+			capabilities: vercelCapabilities,
+			postSubmit: vercelPostSubmitDispatcher
+		}))(request));
+	};
+}
+/** 装配缓存（default handler 懒加载语义） */
+let handlerFn = null;
+/**
+* Vercel Serverless Function 默认入口。
+* @param req Vercel/Node 请求
+* @param res Vercel/Node 响应
+*/
+async function vercelHandler(req, res) {
+	handlerFn ??= createVercelFunc();
+	await handlerFn(req, res);
+}
+//#endregion
+exports.createVercelFunc = createVercelFunc;
+exports.default = vercelHandler;
+exports.fromTkResponse = fromTkResponse;
+exports.toTkRequest = toTkRequest;
+exports.vercelPostSubmitDispatcher = vercelPostSubmitDispatcher;
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["getAxios","RECURSION_HEADER","getRecursionToken","FULL_CAPABILITIES","MongoDatabase","createHandler","scaffoldAdapters"],"sources":["../src/dispatch.ts","../src/main.ts"],"sourcesContent":["/**\n * Vercel 的 POST_SUBMIT 派发实现（规范「后置副作用异步语义」）。\n *\n * **1.x 语义对齐**：COMMENT_SUBMIT 保存评论后，用 **HTTP 递归自调用**把\n * POST_SUBMIT 送到另一个函数实例执行——垃圾检测与邮件/IM 通知因此拥有\n * 独立的执行时间预算，既不会拖慢用户请求，也不会因为用户请求的超时上限\n * 而整条失败（1.x 实现见 `src/server/vercel/api/index.js` 的 `commentSubmit`）。\n *\n * **为什么放在适配器**：这是平台专有机制，common 不应感知。平台相关部分只有\n * 两处：\n * - 自身地址：`TWIKOO_SELF_URL`（显式覆写）→ `VERCEL_URL`（平台注入）；\n * - 内部派发令牌：走 `x-twikoo-recursion` 请求头（1.x 同名，跨版本可互认）。\n *\n * 副作用链本身仍在 common 的 postSubmit 服务里。\n */\nimport {\n  RECURSION_HEADER,\n  getAxios,\n  getRecursionToken,\n  type PostSubmitDispatcher,\n} from \"@twikoojs/common\";\n\n/**\n * 派发等待上限（毫秒）。1.x 为 `Promise.race` 5 秒：超时只表示「本请求不再\n * 继续等」，被调用的实例仍在自己的预算内跑完副作用。\n */\nconst DISPATCH_TIMEOUT_MS = 5000;\n\n/**\n * 解析自身函数地址（显式覆写优先，其次平台注入的 VERCEL_URL）。\n * @returns 绝对地址；两者皆缺失时为空串\n */\nfunction resolveSelfUrl(): string {\n  const explicit = process.env.TWIKOO_SELF_URL;\n  if (explicit) return explicit;\n  const vercelUrl = process.env.VERCEL_URL;\n  return vercelUrl ? `https://${vercelUrl}` : \"\";\n}\n\n/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */\nexport const vercelPostSubmitDispatcher: PostSubmitDispatcher = {\n  /**\n   * 自调用本函数执行 POST_SUBMIT（不等待副作用完成，只等有界竞速）。\n   * @param comment 已入库的评论\n   * @param ctx 当前请求上下文（用于取递归令牌与记录日志）\n   */\n  async dispatch(comment, ctx): Promise<void> {\n    const url = resolveSelfUrl();\n    if (!url) {\n      ctx.logger.warn(\"POST_SUBMIT 派发跳过：未取到自身地址（TWIKOO_SELF_URL / VERCEL_URL）\");\n      return;\n    }\n    const axios = await getAxios();\n    await Promise.race([\n      axios.post(\n        url,\n        { event: \"POST_SUBMIT\", comment },\n        { headers: { [RECURSION_HEADER]: getRecursionToken(ctx.config) } },\n      ),\n      new Promise((resolve) => setTimeout(resolve, DISPATCH_TIMEOUT_MS)),\n    ]);\n  },\n};\n","/**\n * twikoo-vercel 主逻辑（Vercel 薄适配器，规范）。\n * 业务逻辑全部在 @twikoojs/common；平台核对：vercel.com/docs/functions（查阅 2026-09-17）。\n *\n * 后置副作用（垃圾检测 + 通知）经 {@link vercelPostSubmitDispatcher} 以\n * HTTP 递归自调用派发到独立执行单元，见 `./dispatch.ts`。\n */\nimport {\n  FULL_CAPABILITIES,\n  MongoDatabase,\n  createHandler,\n  scaffoldAdapters,\n  type Database,\n  type TkRequest,\n  type TkResponse,\n} from \"@twikoojs/common\";\nimport { vercelPostSubmitDispatcher } from \"./dispatch\";\n\n/** Vercel 平台能力：全能力（能力矩阵）*/\nconst vercelCapabilities = FULL_CAPABILITIES;\n\n/** Vercel 请求的最小结构面（Node IncomingMessage + Vercel 扩展） */\nexport interface VercelRequestLike {\n  method?: string;\n  headers: Record<string, string | string[] | undefined>;\n  query?: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  url?: string;\n}\n\n/** Vercel 响应的最小结构面（Node ServerResponse） */\nexport interface VercelResponseLike {\n  status(code: number): VercelResponseLike;\n  setHeader(name: string, value: string): VercelResponseLike;\n  json(body: unknown): VercelResponseLike;\n  end(): VercelResponseLike;\n}\n\n/**\n * Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。\n * @param req Vercel/Node 请求\n * @returns 内部统一请求\n */\nexport function toTkRequest(req: VercelRequestLike): TkRequest {\n  const headers: Record<string, string> = {};\n  for (const [key, value] of Object.entries(req.headers ?? {})) {\n    if (value !== undefined) headers[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;\n  }\n  const query: Record<string, string> = {};\n  for (const [key, value] of Object.entries(req.query ?? {})) {\n    query[key] = Array.isArray(value) ? String(value[0]) : String(value ?? \"\");\n  }\n  const forwarded = headers[\"x-forwarded-for\"];\n  const ip = headers[\"x-real-ip\"] ?? (forwarded ? forwarded.split(\",\")[0].trim() : \"\") ?? \"\";\n  const body = (req.body && typeof req.body === \"object\" ? req.body : {}) as TkRequest[\"body\"];\n  return {\n    method: String(req.method ?? \"POST\").toUpperCase(),\n    path: String(req.url ?? \"/\"),\n    query,\n    body,\n    headers,\n    ip,\n    raw: req,\n  };\n}\n\n/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */\nexport function fromTkResponse(res: VercelResponseLike, tkRes: TkResponse): void {\n  res.status(tkRes.status);\n  for (const [name, value] of Object.entries(tkRes.headers)) {\n    res.setHeader(name, value);\n  }\n  if (tkRes.status === 204) {\n    res.end();\n    return;\n  }\n  res.json(tkRes.body);\n}\n\n/**\n * 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。\n * @param options 注入项（database：Database 实现；mongoUri：连接串覆写）\n * @returns 逐请求处理器 `(req, res) => Promise<void>`\n */\nexport function createVercelFunc(\n  options: { database?: Database; mongoUri?: string } = {},\n): (req: VercelRequestLike, res: VercelResponseLike) => Promise<void> {\n  let database: Database | null = options.database ?? null;\n  /** 懒建连（inject 优先；init 幂等） */\n  const getDatabase = async (): Promise<Database> => {\n    database ??= new MongoDatabase({ uri: options.mongoUri ?? process.env.MONGODB_URI ?? \"\" });\n    await database.init();\n    return database;\n  };\n  return async (req, res) => {\n    const request = toTkRequest(req);\n    const handler = createHandler(\n      scaffoldAdapters({\n        request: {\n          /** 事件即请求体（闭包透传，见 toTkRequest） */\n          toTkRequest: () => request,\n        },\n        response: {\n          /** TkResponse 恒等透传（平台写入见 fromTkResponse） */\n          fromTkResponse: (r: TkResponse) => r,\n        },\n        database: await getDatabase(),\n        capabilities: vercelCapabilities,\n        postSubmit: vercelPostSubmitDispatcher,\n      }),\n    );\n    fromTkResponse(res, await handler(request));\n  };\n}\n\n/** 装配缓存（default handler 懒加载语义） */\nlet handlerFn: ((req: VercelRequestLike, res: VercelResponseLike) => Promise<void>) | null = null;\n\n/**\n * Vercel Serverless Function 默认入口。\n * @param req Vercel/Node 请求\n * @param res Vercel/Node 响应\n */\nexport default async function vercelHandler(\n  req: VercelRequestLike,\n  res: VercelResponseLike,\n): Promise<void> {\n  handlerFn ??= createVercelFunc();\n  await handlerFn(req, res);\n}\n"],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,138 @@
+import { FULL_CAPABILITIES, MongoDatabase, RECURSION_HEADER, createHandler, getAxios, getRecursionToken, scaffoldAdapters } from "@twikoojs/common";
+//#region src/dispatch.ts
+/**
+* Vercel 的 POST_SUBMIT 派发实现（规范「后置副作用异步语义」）。
+*
+* **1.x 语义对齐**：COMMENT_SUBMIT 保存评论后，用 **HTTP 递归自调用**把
+* POST_SUBMIT 送到另一个函数实例执行——垃圾检测与邮件/IM 通知因此拥有
+* 独立的执行时间预算，既不会拖慢用户请求，也不会因为用户请求的超时上限
+* 而整条失败（1.x 实现见 `src/server/vercel/api/index.js` 的 `commentSubmit`）。
+*
+* **为什么放在适配器**：这是平台专有机制，common 不应感知。平台相关部分只有
+* 两处：
+* - 自身地址：`TWIKOO_SELF_URL`（显式覆写）→ `VERCEL_URL`（平台注入）；
+* - 内部派发令牌：走 `x-twikoo-recursion` 请求头（1.x 同名，跨版本可互认）。
+*
+* 副作用链本身仍在 common 的 postSubmit 服务里。
+*/
+/**
+* 派发等待上限（毫秒）。1.x 为 `Promise.race` 5 秒：超时只表示「本请求不再
+* 继续等」，被调用的实例仍在自己的预算内跑完副作用。
+*/
+const DISPATCH_TIMEOUT_MS = 5e3;
+/**
+* 解析自身函数地址（显式覆写优先，其次平台注入的 VERCEL_URL）。
+* @returns 绝对地址；两者皆缺失时为空串
+*/
+function resolveSelfUrl() {
+	const explicit = process.env.TWIKOO_SELF_URL;
+	if (explicit) return explicit;
+	const vercelUrl = process.env.VERCEL_URL;
+	return vercelUrl ? `https://${vercelUrl}` : "";
+}
+/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */
+const vercelPostSubmitDispatcher = { 
+/**
+* 自调用本函数执行 POST_SUBMIT（不等待副作用完成，只等有界竞速）。
+* @param comment 已入库的评论
+* @param ctx 当前请求上下文（用于取递归令牌与记录日志）
+*/
+async dispatch(comment, ctx) {
+	const url = resolveSelfUrl();
+	if (!url) {
+		ctx.logger.warn("POST_SUBMIT 派发跳过：未取到自身地址（TWIKOO_SELF_URL / VERCEL_URL）");
+		return;
+	}
+	const axios = await getAxios();
+	await Promise.race([axios.post(url, {
+		event: "POST_SUBMIT",
+		comment
+	}, { headers: { [RECURSION_HEADER]: getRecursionToken(ctx.config) } }), new Promise((resolve) => setTimeout(resolve, DISPATCH_TIMEOUT_MS))]);
+} };
+//#endregion
+//#region src/main.ts
+/**
+* twikoo-vercel 主逻辑（Vercel 薄适配器，规范）。
+* 业务逻辑全部在 @twikoojs/common；平台核对：vercel.com/docs/functions（查阅 2026-09-17）。
+*
+* 后置副作用（垃圾检测 + 通知）经 {@link vercelPostSubmitDispatcher} 以
+* HTTP 递归自调用派发到独立执行单元，见 `./dispatch.ts`。
+*/
+/** Vercel 平台能力：全能力（能力矩阵）*/
+const vercelCapabilities = FULL_CAPABILITIES;
+/**
+* Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。
+* @param req Vercel/Node 请求
+* @returns 内部统一请求
+*/
+function toTkRequest(req) {
+	const headers = {};
+	for (const [key, value] of Object.entries(req.headers ?? {})) if (value !== void 0) headers[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;
+	const query = {};
+	for (const [key, value] of Object.entries(req.query ?? {})) query[key] = Array.isArray(value) ? String(value[0]) : String(value ?? "");
+	const forwarded = headers["x-forwarded-for"];
+	const ip = headers["x-real-ip"] ?? (forwarded ? forwarded.split(",")[0].trim() : "") ?? "";
+	const body = req.body && typeof req.body === "object" ? req.body : {};
+	return {
+		method: String(req.method ?? "POST").toUpperCase(),
+		path: String(req.url ?? "/"),
+		query,
+		body,
+		headers,
+		ip,
+		raw: req
+	};
+}
+/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */
+function fromTkResponse(res, tkRes) {
+	res.status(tkRes.status);
+	for (const [name, value] of Object.entries(tkRes.headers)) res.setHeader(name, value);
+	if (tkRes.status === 204) {
+		res.end();
+		return;
+	}
+	res.json(tkRes.body);
+}
+/**
+* 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。
+* @param options 注入项（database：Database 实现；mongoUri：连接串覆写）
+* @returns 逐请求处理器 `(req, res) => Promise<void>`
+*/
+function createVercelFunc(options = {}) {
+	let database = options.database ?? null;
+	/** 懒建连（inject 优先；init 幂等） */
+	const getDatabase = async () => {
+		database ??= new MongoDatabase({ uri: options.mongoUri ?? process.env.MONGODB_URI ?? "" });
+		await database.init();
+		return database;
+	};
+	return async (req, res) => {
+		const request = toTkRequest(req);
+		fromTkResponse(res, await createHandler(scaffoldAdapters({
+			request: { 
+			/** 事件即请求体（闭包透传，见 toTkRequest） */
+toTkRequest: () => request },
+			response: { 
+			/** TkResponse 恒等透传（平台写入见 fromTkResponse） */
+fromTkResponse: (r) => r },
+			database: await getDatabase(),
+			capabilities: vercelCapabilities,
+			postSubmit: vercelPostSubmitDispatcher
+		}))(request));
+	};
+}
+/** 装配缓存（default handler 懒加载语义） */
+let handlerFn = null;
+/**
+* Vercel Serverless Function 默认入口。
+* @param req Vercel/Node 请求
+* @param res Vercel/Node 响应
+*/
+async function vercelHandler(req, res) {
+	handlerFn ??= createVercelFunc();
+	await handlerFn(req, res);
+}
+//#endregion
+export { createVercelFunc, vercelHandler as default, fromTkResponse, toTkRequest, vercelPostSubmitDispatcher };
+
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":[],"sources":["../src/dispatch.ts","../src/main.ts"],"sourcesContent":["/**\n * Vercel 的 POST_SUBMIT 派发实现（规范「后置副作用异步语义」）。\n *\n * **1.x 语义对齐**：COMMENT_SUBMIT 保存评论后，用 **HTTP 递归自调用**把\n * POST_SUBMIT 送到另一个函数实例执行——垃圾检测与邮件/IM 通知因此拥有\n * 独立的执行时间预算，既不会拖慢用户请求，也不会因为用户请求的超时上限\n * 而整条失败（1.x 实现见 `src/server/vercel/api/index.js` 的 `commentSubmit`）。\n *\n * **为什么放在适配器**：这是平台专有机制，common 不应感知。平台相关部分只有\n * 两处：\n * - 自身地址：`TWIKOO_SELF_URL`（显式覆写）→ `VERCEL_URL`（平台注入）；\n * - 内部派发令牌：走 `x-twikoo-recursion` 请求头（1.x 同名，跨版本可互认）。\n *\n * 副作用链本身仍在 common 的 postSubmit 服务里。\n */\nimport {\n  RECURSION_HEADER,\n  getAxios,\n  getRecursionToken,\n  type PostSubmitDispatcher,\n} from \"@twikoojs/common\";\n\n/**\n * 派发等待上限（毫秒）。1.x 为 `Promise.race` 5 秒：超时只表示「本请求不再\n * 继续等」，被调用的实例仍在自己的预算内跑完副作用。\n */\nconst DISPATCH_TIMEOUT_MS = 5000;\n\n/**\n * 解析自身函数地址（显式覆写优先，其次平台注入的 VERCEL_URL）。\n * @returns 绝对地址；两者皆缺失时为空串\n */\nfunction resolveSelfUrl(): string {\n  const explicit = process.env.TWIKOO_SELF_URL;\n  if (explicit) return explicit;\n  const vercelUrl = process.env.VERCEL_URL;\n  return vercelUrl ? `https://${vercelUrl}` : \"\";\n}\n\n/** Vercel 的 POST_SUBMIT 派发实现（HTTP 递归自调用） */\nexport const vercelPostSubmitDispatcher: PostSubmitDispatcher = {\n  /**\n   * 自调用本函数执行 POST_SUBMIT（不等待副作用完成，只等有界竞速）。\n   * @param comment 已入库的评论\n   * @param ctx 当前请求上下文（用于取递归令牌与记录日志）\n   */\n  async dispatch(comment, ctx): Promise<void> {\n    const url = resolveSelfUrl();\n    if (!url) {\n      ctx.logger.warn(\"POST_SUBMIT 派发跳过：未取到自身地址（TWIKOO_SELF_URL / VERCEL_URL）\");\n      return;\n    }\n    const axios = await getAxios();\n    await Promise.race([\n      axios.post(\n        url,\n        { event: \"POST_SUBMIT\", comment },\n        { headers: { [RECURSION_HEADER]: getRecursionToken(ctx.config) } },\n      ),\n      new Promise((resolve) => setTimeout(resolve, DISPATCH_TIMEOUT_MS)),\n    ]);\n  },\n};\n","/**\n * twikoo-vercel 主逻辑（Vercel 薄适配器，规范）。\n * 业务逻辑全部在 @twikoojs/common；平台核对：vercel.com/docs/functions（查阅 2026-09-17）。\n *\n * 后置副作用（垃圾检测 + 通知）经 {@link vercelPostSubmitDispatcher} 以\n * HTTP 递归自调用派发到独立执行单元，见 `./dispatch.ts`。\n */\nimport {\n  FULL_CAPABILITIES,\n  MongoDatabase,\n  createHandler,\n  scaffoldAdapters,\n  type Database,\n  type TkRequest,\n  type TkResponse,\n} from \"@twikoojs/common\";\nimport { vercelPostSubmitDispatcher } from \"./dispatch\";\n\n/** Vercel 平台能力：全能力（能力矩阵）*/\nconst vercelCapabilities = FULL_CAPABILITIES;\n\n/** Vercel 请求的最小结构面（Node IncomingMessage + Vercel 扩展） */\nexport interface VercelRequestLike {\n  method?: string;\n  headers: Record<string, string | string[] | undefined>;\n  query?: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  url?: string;\n}\n\n/** Vercel 响应的最小结构面（Node ServerResponse） */\nexport interface VercelResponseLike {\n  status(code: number): VercelResponseLike;\n  setHeader(name: string, value: string): VercelResponseLike;\n  json(body: unknown): VercelResponseLike;\n  end(): VercelResponseLike;\n}\n\n/**\n * Vercel 请求 → 内部统一请求（headers 小写化；query String 化；x-real-ip/转发首跳取 IP）。\n * @param req Vercel/Node 请求\n * @returns 内部统一请求\n */\nexport function toTkRequest(req: VercelRequestLike): TkRequest {\n  const headers: Record<string, string> = {};\n  for (const [key, value] of Object.entries(req.headers ?? {})) {\n    if (value !== undefined) headers[key.toLowerCase()] = Array.isArray(value) ? value[0] : value;\n  }\n  const query: Record<string, string> = {};\n  for (const [key, value] of Object.entries(req.query ?? {})) {\n    query[key] = Array.isArray(value) ? String(value[0]) : String(value ?? \"\");\n  }\n  const forwarded = headers[\"x-forwarded-for\"];\n  const ip = headers[\"x-real-ip\"] ?? (forwarded ? forwarded.split(\",\")[0].trim() : \"\") ?? \"\";\n  const body = (req.body && typeof req.body === \"object\" ? req.body : {}) as TkRequest[\"body\"];\n  return {\n    method: String(req.method ?? \"POST\").toUpperCase(),\n    path: String(req.url ?? \"/\"),\n    query,\n    body,\n    headers,\n    ip,\n    raw: req,\n  };\n}\n\n/** 内部统一响应 → Vercel 响应（状态码 + CORS 头 + JSON 体；204 无体）。 */\nexport function fromTkResponse(res: VercelResponseLike, tkRes: TkResponse): void {\n  res.status(tkRes.status);\n  for (const [name, value] of Object.entries(tkRes.headers)) {\n    res.setHeader(name, value);\n  }\n  if (tkRes.status === 204) {\n    res.end();\n    return;\n  }\n  res.json(tkRes.body);\n}\n\n/**\n * 创建 Vercel 请求处理器（database 可注入；缺省按 MONGODB_URI 懒建连，1.x 缓存语义）。\n * @param options 注入项（database：Database 实现；mongoUri：连接串覆写）\n * @returns 逐请求处理器 `(req, res) => Promise<void>`\n */\nexport function createVercelFunc(\n  options: { database?: Database; mongoUri?: string } = {},\n): (req: VercelRequestLike, res: VercelResponseLike) => Promise<void> {\n  let database: Database | null = options.database ?? null;\n  /** 懒建连（inject 优先；init 幂等） */\n  const getDatabase = async (): Promise<Database> => {\n    database ??= new MongoDatabase({ uri: options.mongoUri ?? process.env.MONGODB_URI ?? \"\" });\n    await database.init();\n    return database;\n  };\n  return async (req, res) => {\n    const request = toTkRequest(req);\n    const handler = createHandler(\n      scaffoldAdapters({\n        request: {\n          /** 事件即请求体（闭包透传，见 toTkRequest） */\n          toTkRequest: () => request,\n        },\n        response: {\n          /** TkResponse 恒等透传（平台写入见 fromTkResponse） */\n          fromTkResponse: (r: TkResponse) => r,\n        },\n        database: await getDatabase(),\n        capabilities: vercelCapabilities,\n        postSubmit: vercelPostSubmitDispatcher,\n      }),\n    );\n    fromTkResponse(res, await handler(request));\n  };\n}\n\n/** 装配缓存（default handler 懒加载语义） */\nlet handlerFn: ((req: VercelRequestLike, res: VercelResponseLike) => Promise<void>) | null = null;\n\n/**\n * Vercel Serverless Function 默认入口。\n * @param req Vercel/Node 请求\n * @param res Vercel/Node 响应\n */\nexport default async function vercelHandler(\n  req: VercelRequestLike,\n  res: VercelResponseLike,\n): Promise<void> {\n  handlerFn ??= createVercelFunc();\n  await handlerFn(req, res);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA0BA,MAAM,sBAAsB;;;;;AAM5B,SAAS,iBAAyB;CAChC,MAAM,WAAW,QAAQ,IAAI;CAC7B,IAAI,UAAU,OAAO;CACrB,MAAM,YAAY,QAAQ,IAAI;CAC9B,OAAO,YAAY,WAAW,cAAc;AAC9C;;AAGA,MAAa,6BAAmD;;;;;;AAM9D,MAAM,SAAS,SAAS,KAAoB;CAC1C,MAAM,MAAM,eAAe;CAC3B,IAAI,CAAC,KAAK;EACR,IAAI,OAAO,KAAK,wDAAwD;EACxE;CACF;CACA,MAAM,QAAQ,MAAM,SAAS;CAC7B,MAAM,QAAQ,KAAK,CACjB,MAAM,KACJ,KACA;EAAE,OAAO;EAAe;CAAQ,GAChC,EAAE,SAAS,GAAG,mBAAmB,kBAAkB,IAAI,MAAM,EAAE,EAAE,CACnE,GACA,IAAI,SAAS,YAAY,WAAW,SAAS,mBAAmB,CAAC,CACnE,CAAC;AACH,EACF;;;;;;;;;;;AC3CA,MAAM,qBAAqB;;;;;;AAwB3B,SAAgB,YAAY,KAAmC;CAC7D,MAAM,UAAkC,CAAC;CACzC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,WAAW,CAAC,CAAC,GACzD,IAAI,UAAU,KAAA,GAAW,QAAQ,IAAI,YAAY,KAAK,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK;CAE1F,MAAM,QAAgC,CAAC;CACvC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,IAAI,SAAS,CAAC,CAAC,GACvD,MAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,OAAO,MAAM,EAAE,IAAI,OAAO,SAAS,EAAE;CAE3E,MAAM,YAAY,QAAQ;CAC1B,MAAM,KAAK,QAAQ,iBAAiB,YAAY,UAAU,MAAM,GAAG,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,OAAO;CACxF,MAAM,OAAQ,IAAI,QAAQ,OAAO,IAAI,SAAS,WAAW,IAAI,OAAO,CAAC;CACrE,OAAO;EACL,QAAQ,OAAO,IAAI,UAAU,MAAM,CAAC,CAAC,YAAY;EACjD,MAAM,OAAO,IAAI,OAAO,GAAG;EAC3B;EACA;EACA;EACA;EACA,KAAK;CACP;AACF;;AAGA,SAAgB,eAAe,KAAyB,OAAyB;CAC/E,IAAI,OAAO,MAAM,MAAM;CACvB,KAAK,MAAM,CAAC,MAAM,UAAU,OAAO,QAAQ,MAAM,OAAO,GACtD,IAAI,UAAU,MAAM,KAAK;CAE3B,IAAI,MAAM,WAAW,KAAK;EACxB,IAAI,IAAI;EACR;CACF;CACA,IAAI,KAAK,MAAM,IAAI;AACrB;;;;;;AAOA,SAAgB,iBACd,UAAsD,CAAC,GACa;CACpE,IAAI,WAA4B,QAAQ,YAAY;;CAEpD,MAAM,cAAc,YAA+B;EACjD,aAAa,IAAI,cAAc,EAAE,KAAK,QAAQ,YAAY,QAAQ,IAAI,eAAe,GAAG,CAAC;EACzF,MAAM,SAAS,KAAK;EACpB,OAAO;CACT;CACA,OAAO,OAAO,KAAK,QAAQ;EACzB,MAAM,UAAU,YAAY,GAAG;EAgB/B,eAAe,KAAK,MAfJ,cACd,iBAAiB;GACf,SAAS;;AAEP,mBAAmB,QACrB;GACA,UAAU;;AAER,iBAAiB,MAAkB,EACrC;GACA,UAAU,MAAM,YAAY;GAC5B,cAAc;GACd,YAAY;EACd,CAAC,CAE6B,CAAC,CAAC,OAAO,CAAC;CAC5C;AACF;;AAGA,IAAI,YAAyF;;;;;;AAO7F,eAA8B,cAC5B,KACA,KACe;CACf,cAAc,iBAAiB;CAC/B,MAAM,UAAU,KAAK,GAAG;AAC1B"}

package/package.json

@@ -1,19 +1,51 @@
 {
   "name": "twikoo-vercel",
-  "version": "1.7.23",
-  "description": "A simple comment system.",
-  "author": "imaegoo <hello@imaegoo.com> (https://github.com/imaegoo)",
+  "version": "2.0.0-beta.1",
+  "description": "Twikoo comment system backend for Vercel",
   "license": "MIT",
-  "main": "api/index.js",
   "repository": {
     "type": "git",
     "url": "https://github.com/twikoojs/twikoo.git"
   },
-  "homepage": "https://twikoo.js.org",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsdown",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "vitest run"
+  },
   "dependencies": {
-    "get-user-ip": "^1.0.1",
-    "mongodb": "^6.3.0",
-    "twikoo-func": "1.7.23",
-    "uuid": "^8.3.2"
+    "@cap.js/server": "^4.0.5",
+    "@imaegoo/node-ip2region": "^2.1.1",
+    "@twikoojs/common": "workspace:*",
+    "@twikoojs/shared": "workspace:*",
+    "@xsai/generate-text": "^0.5.0",
+    "akismet-api": "^6.0.0",
+    "axios": "^1.20.0",
+    "bowser": "^2.14.1",
+    "dompurify": "^3.4.15",
+    "form-data": "^4.0.6",
+    "html-to-text": "^10.0.1",
+    "jsdom": "^30.1.0",
+    "marked": "^18.0.13",
+    "mongodb": "^7.6.0",
+    "nodemailer": "^10.0.10",
+    "pushoo": "workspace:^",
+    "tencentcloud-sdk-nodejs-tms": "^4.1.311",
+    "xml2js": "^0.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "^26.6.1"
   }
 }