@lark-apaas/devtool-kits 1.2.16 → 1.2.17-alpha.1

package/dist/index.d.cts

@@ -1,5 +1,6 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Router, RequestHandler, Application } from 'express';
+import { ServerResponse as ServerResponse$1, IncomingMessage as IncomingMessage$1 } from 'http';
 
 /**
  * 标准化基础路径，确保以 '/' 开头且不包含 trailing slash
@@ -196,6 +197,41 @@ interface DevLogsMiddlewareOptions {
  */
 declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
 
+/**
+ * Express/Connect 兼容层
+ * 让 middleware 同时支持 Express 和 Vite/Connect
+ */
+
+type AnyResponse = ServerResponse$1 & {
+    status?: (code: number) => AnyResponse;
+    json?: (data: unknown) => void;
+    send?: (data: unknown) => void;
+};
+type AnyRequest = IncomingMessage$1 & {
+    query?: Record<string, string>;
+    params?: Record<string, string>;
+};
+/**
+ * 发送 JSON 响应，兼容 Express 和 Connect
+ */
+declare function sendJson(res: AnyResponse, data: unknown, statusCode?: number): void;
+/**
+ * 发送错误响应
+ */
+declare function sendError(res: AnyResponse, message: string, error?: unknown, statusCode?: number): void;
+/**
+ * 发送成功响应
+ */
+declare function sendSuccess(res: AnyResponse, data?: Record<string, unknown>): void;
+/**
+ * 获取 query 参数，兼容 Express 和 Connect
+ */
+declare function getQuery(req: AnyRequest): Record<string, string>;
+/**
+ * 获取单个 query 参数
+ */
+declare function getQueryParam(req: AnyRequest, key: string): string | undefined;
+
 /**
  * Register middlewares for Express-compatible servers or Vite
  * @param server - Express app or Vite middleware instance
@@ -235,4 +271,4 @@ declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions)
  */
 declare function registerMiddlewares(server: ExpressApp | ViteMiddleware, middlewares: Middleware[], options?: Partial<MiddlewareContext>): Promise<void>;
 
-export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type Options, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, handleDevProxyError, normalizeBasePath, parseAndGenerateNestResourceTemplate, postprocessDrizzleSchema, registerMiddlewares };
+export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type Options, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, getQuery, getQueryParam, handleDevProxyError, normalizeBasePath, parseAndGenerateNestResourceTemplate, postprocessDrizzleSchema, registerMiddlewares, sendError, sendJson, sendSuccess };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 import { IncomingMessage, ServerResponse } from 'node:http';
 import { Router, RequestHandler, Application } from 'express';
+import { ServerResponse as ServerResponse$1, IncomingMessage as IncomingMessage$1 } from 'http';
 
 /**
  * 标准化基础路径，确保以 '/' 开头且不包含 trailing slash
@@ -196,6 +197,41 @@ interface DevLogsMiddlewareOptions {
  */
 declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
 
+/**
+ * Express/Connect 兼容层
+ * 让 middleware 同时支持 Express 和 Vite/Connect
+ */
+
+type AnyResponse = ServerResponse$1 & {
+    status?: (code: number) => AnyResponse;
+    json?: (data: unknown) => void;
+    send?: (data: unknown) => void;
+};
+type AnyRequest = IncomingMessage$1 & {
+    query?: Record<string, string>;
+    params?: Record<string, string>;
+};
+/**
+ * 发送 JSON 响应，兼容 Express 和 Connect
+ */
+declare function sendJson(res: AnyResponse, data: unknown, statusCode?: number): void;
+/**
+ * 发送错误响应
+ */
+declare function sendError(res: AnyResponse, message: string, error?: unknown, statusCode?: number): void;
+/**
+ * 发送成功响应
+ */
+declare function sendSuccess(res: AnyResponse, data?: Record<string, unknown>): void;
+/**
+ * 获取 query 参数，兼容 Express 和 Connect
+ */
+declare function getQuery(req: AnyRequest): Record<string, string>;
+/**
+ * 获取单个 query 参数
+ */
+declare function getQueryParam(req: AnyRequest, key: string): string | undefined;
+
 /**
  * Register middlewares for Express-compatible servers or Vite
  * @param server - Express app or Vite middleware instance
@@ -235,4 +271,4 @@ declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions)
  */
 declare function registerMiddlewares(server: ExpressApp | ViteMiddleware, middlewares: Middleware[], options?: Partial<MiddlewareContext>): Promise<void>;
 
-export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type Options, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, handleDevProxyError, normalizeBasePath, parseAndGenerateNestResourceTemplate, postprocessDrizzleSchema, registerMiddlewares };
+export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type Options, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, getQuery, getQueryParam, handleDevProxyError, normalizeBasePath, parseAndGenerateNestResourceTemplate, postprocessDrizzleSchema, registerMiddlewares, sendError, sendJson, sendSuccess };

package/dist/index.js

@@ -3449,7 +3449,100 @@ function createCollectLogsMiddleware(options = {}) {
 }
 __name(createCollectLogsMiddleware, "createCollectLogsMiddleware");
 
+// src/middlewares/compat.ts
+function sendJson(res, data, statusCode = 200) {
+  const statusFn = res.status;
+  const jsonFn = res.json;
+  if (typeof statusFn === "function" && typeof jsonFn === "function") {
+    statusFn.call(res, statusCode);
+    jsonFn.call(res, data);
+  } else {
+    res.statusCode = statusCode;
+    res.setHeader("Content-Type", "application/json");
+    res.end(JSON.stringify(data));
+  }
+}
+__name(sendJson, "sendJson");
+function sendError(res, message, error, statusCode = 500) {
+  const errorData = {
+    message,
+    ...error ? {
+      error: serializeError3(error)
+    } : {}
+  };
+  sendJson(res, errorData, statusCode);
+}
+__name(sendError, "sendError");
+function sendSuccess(res, data) {
+  sendJson(res, {
+    success: true,
+    ...data
+  }, 200);
+}
+__name(sendSuccess, "sendSuccess");
+function getQuery(req) {
+  if (req.query) {
+    return req.query;
+  }
+  const url = new URL(req.url || "", `http://${req.headers.host}`);
+  return Object.fromEntries(url.searchParams.entries());
+}
+__name(getQuery, "getQuery");
+function getQueryParam(req, key) {
+  const query = getQuery(req);
+  return query[key];
+}
+__name(getQueryParam, "getQueryParam");
+function serializeError3(error) {
+  if (error instanceof Error) {
+    return {
+      name: error.name,
+      message: error.message,
+      stack: error.stack
+    };
+  }
+  return {
+    message: String(error)
+  };
+}
+__name(serializeError3, "serializeError");
+
 // src/middlewares/index.ts
+function enhanceForCompat(req, res) {
+  if (!res.status) {
+    res.status = function(code) {
+      res.statusCode = code;
+      return res;
+    };
+  }
+  if (!res.json) {
+    res.json = function(data) {
+      res.setHeader("Content-Type", "application/json");
+      res.end(JSON.stringify(data));
+      return res;
+    };
+  }
+  if (!res.send) {
+    res.send = function(data) {
+      if (typeof data === "object" && data !== null) {
+        res.setHeader("Content-Type", "application/json");
+        res.end(JSON.stringify(data));
+      } else {
+        res.end(String(data));
+      }
+      return res;
+    };
+  }
+  if (!req.query) {
+    const url = new URL(req.url || "", `http://${req.headers.host || "localhost"}`);
+    req.query = Object.fromEntries(url.searchParams.entries());
+  }
+}
+__name(enhanceForCompat, "enhanceForCompat");
+function isConnectServer(server) {
+  return typeof server === "function" && !("set" in server) && !("engine" in server);
+}
+__name(isConnectServer, "isConnectServer");
 function isRouteMiddleware(middleware) {
   return "createRouter" in middleware && middleware.createRouter !== void 0;
 }
@@ -3502,6 +3595,13 @@ async function registerMiddlewares(server, middlewares, options) {
     rootDir: process.cwd(),
     ...options
   };
+  if (isConnectServer(server)) {
+    server.use((req, res, next) => {
+      enhanceForCompat(req, res);
+      next();
+    });
+    console.log("[Middleware] Registered Express compatibility layer for Connect/Vite");
+  }
   const allMiddlewares = [
     ...middlewares
   ];
@@ -3532,10 +3632,15 @@ export {
   createCollectLogsMiddleware,
   createDevLogsMiddleware,
   createOpenapiMiddleware,
+  getQuery,
+  getQueryParam,
   handleDevProxyError,
   normalizeBasePath,
   parseAndGenerateNestResourceTemplate,
   postprocessDrizzleSchema,
-  registerMiddlewares
+  registerMiddlewares,
+  sendError,
+  sendJson,
+  sendSuccess
 };
 //# sourceMappingURL=index.js.map