@lark-apaas/devtool-kits 0.1.0-alpha.4 → 0.1.0-alpha.7

package/dist/index.d.cts

@@ -129,7 +129,7 @@ interface OpenapiMiddlewareOptions {
  */
 declare function createOpenapiMiddleware(options: OpenapiMiddlewareOptions): RouteMiddleware;
 
-interface DevLogsMiddlewareOptions {
+interface DevLogsMiddlewareOptions$1 {
     /** Directory containing log files */
     logDir?: string;
 }
@@ -137,7 +137,17 @@ interface DevLogsMiddlewareOptions {
  * Creates dev logs middleware for viewing application logs
  * Supports both rspack/webpack and Vite dev servers
  */
-declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
+declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions$1): RouteMiddleware;
+
+interface DevLogsMiddlewareOptions {
+    logDir?: string;
+    fileName?: string;
+}
+/**
+ * Creates dev logs middleware for viewing application logs
+ * Supports both rspack/webpack and Vite dev servers
+ */
+declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
 
 /**
  * Register middlewares for Express-compatible servers or Vite
@@ -178,4 +188,4 @@ declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions): Ro
  */
 declare function registerMiddlewares(server: ExpressApp | ViteMiddleware, middlewares: Middleware[], options?: Partial<MiddlewareContext>): Promise<void>;
 
-export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type RouteInfo, type RouteMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, normalizeBasePath, postprocessDrizzleSchema, registerMiddlewares };
+export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, normalizeBasePath, postprocessDrizzleSchema, registerMiddlewares };

package/dist/index.d.ts

@@ -129,7 +129,7 @@ interface OpenapiMiddlewareOptions {
  */
 declare function createOpenapiMiddleware(options: OpenapiMiddlewareOptions): RouteMiddleware;
 
-interface DevLogsMiddlewareOptions {
+interface DevLogsMiddlewareOptions$1 {
     /** Directory containing log files */
     logDir?: string;
 }
@@ -137,7 +137,17 @@ interface DevLogsMiddlewareOptions {
  * Creates dev logs middleware for viewing application logs
  * Supports both rspack/webpack and Vite dev servers
  */
-declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
+declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions$1): RouteMiddleware;
+
+interface DevLogsMiddlewareOptions {
+    logDir?: string;
+    fileName?: string;
+}
+/**
+ * Creates dev logs middleware for viewing application logs
+ * Supports both rspack/webpack and Vite dev servers
+ */
+declare function createCollectLogsMiddleware(options?: DevLogsMiddlewareOptions): RouteMiddleware;
 
 /**
  * Register middlewares for Express-compatible servers or Vite
@@ -178,4 +188,4 @@ declare function createDevLogsMiddleware(options?: DevLogsMiddlewareOptions): Ro
  */
 declare function registerMiddlewares(server: ExpressApp | ViteMiddleware, middlewares: Middleware[], options?: Partial<MiddlewareContext>): Promise<void>;
 
-export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type RouteInfo, type RouteMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, normalizeBasePath, postprocessDrizzleSchema, registerMiddlewares };
+export { type GlobalMiddleware, type Middleware, type MiddlewareContext, type RouteInfo, type RouteMiddleware, createCollectLogsMiddleware, createDevLogsMiddleware, createOpenapiMiddleware, normalizeBasePath, postprocessDrizzleSchema, registerMiddlewares };

package/dist/index.js

@@ -1370,8 +1370,8 @@ var require_node = __commonJS({
           }
           break;
         case "FILE":
-          var fs7 = __require("fs");
-          stream2 = new fs7.SyncWriteStream(fd2, {
+          var fs9 = __require("fs");
+          stream2 = new fs9.SyncWriteStream(fd2, {
             autoClose: false
           });
           stream2._type = "fs";
@@ -21250,8 +21250,8 @@ var require_node2 = __commonJS({
           }
           break;
         case "FILE":
-          var fs7 = __require("fs");
-          stream2 = new fs7.SyncWriteStream(fd2, {
+          var fs9 = __require("fs");
+          stream2 = new fs9.SyncWriteStream(fd2, {
             autoClose: false
           });
           stream2._type = "fs";
@@ -22020,8 +22020,8 @@ var require_node3 = __commonJS({
           }
           break;
         case "FILE":
-          var fs7 = __require("fs");
-          stream2 = new fs7.SyncWriteStream(fd2, {
+          var fs9 = __require("fs");
+          stream2 = new fs9.SyncWriteStream(fd2, {
             autoClose: false
           });
           stream2._type = "fs";
@@ -22942,11 +22942,11 @@ var require_view = __commonJS({
     "use strict";
     var debug = require_src3()("express:view");
     var path5 = __require("path");
-    var fs7 = __require("fs");
+    var fs9 = __require("fs");
     var dirname = path5.dirname;
     var basename = path5.basename;
     var extname = path5.extname;
-    var join3 = path5.join;
+    var join5 = path5.join;
     var resolve = path5.resolve;
     module.exports = View;
     function View(name, options) {
@@ -22995,12 +22995,12 @@ var require_view = __commonJS({
     }, "render");
     View.prototype.resolve = /* @__PURE__ */ __name(function resolve2(dir, file) {
       var ext = this.ext;
-      var path6 = join3(dir, file);
+      var path6 = join5(dir, file);
       var stat = tryStat(path6);
       if (stat && stat.isFile()) {
         return path6;
       }
-      path6 = join3(dir, basename(file, ext), "index" + ext);
+      path6 = join5(dir, basename(file, ext), "index" + ext);
       stat = tryStat(path6);
       if (stat && stat.isFile()) {
         return path6;
@@ -23009,7 +23009,7 @@ var require_view = __commonJS({
     function tryStat(path6) {
       debug('stat "%s"', path6);
       try {
-        return fs7.statSync(path6);
+        return fs9.statSync(path6);
       } catch (e) {
         return void 0;
       }
@@ -23658,8 +23658,8 @@ var require_node4 = __commonJS({
           }
           break;
         case "FILE":
-          var fs7 = __require("fs");
-          stream2 = new fs7.SyncWriteStream(fd2, {
+          var fs9 = __require("fs");
+          stream2 = new fs9.SyncWriteStream(fd2, {
             autoClose: false
           });
           stream2._type = "fs";
@@ -23860,7 +23860,7 @@ var require_mime = __commonJS({
   "../../../node_modules/mime/mime.js"(exports, module) {
     "use strict";
     var path5 = __require("path");
-    var fs7 = __require("fs");
+    var fs9 = __require("fs");
     function Mime() {
       this.types = /* @__PURE__ */ Object.create(null);
       this.extensions = /* @__PURE__ */ Object.create(null);
@@ -23882,7 +23882,7 @@ var require_mime = __commonJS({
     };
     Mime.prototype.load = function(file) {
       this._loading = file;
-      var map = {}, content = fs7.readFileSync(file, "ascii"), lines = content.split(/[\r\n]+/);
+      var map = {}, content = fs9.readFileSync(file, "ascii"), lines = content.split(/[\r\n]+/);
       lines.forEach(function(line) {
         var fields = line.replace(/\s*#.*|^\s*|\s*$/g, "").split(/\s+/);
         map[fields.shift()] = fields;
@@ -24127,7 +24127,7 @@ var require_send = __commonJS({
     var escapeHtml = require_escape_html();
     var etag = require_etag();
     var fresh = require_fresh();
-    var fs7 = __require("fs");
+    var fs9 = __require("fs");
     var mime = require_mime();
     var ms = require_ms5();
     var onFinished = require_on_finished();
@@ -24137,7 +24137,7 @@ var require_send = __commonJS({
     var Stream = __require("stream");
     var util = __require("util");
     var extname = path5.extname;
-    var join3 = path5.join;
+    var join5 = path5.join;
     var normalize = path5.normalize;
     var resolve = path5.resolve;
     var sep = path5.sep;
@@ -24354,7 +24354,7 @@ var require_send = __commonJS({
           return res;
         }
         parts = path6.split(sep);
-        path6 = normalize(join3(root, path6));
+        path6 = normalize(join5(root, path6));
       } else {
         if (UP_PATH_REGEXP.test(path6)) {
           debug('malicious path "%s"', path6);
@@ -24460,7 +24460,7 @@ var require_send = __commonJS({
       var i = 0;
       var self = this;
       debug('stat "%s"', path6);
-      fs7.stat(path6, /* @__PURE__ */ __name(function onstat(err, stat) {
+      fs9.stat(path6, /* @__PURE__ */ __name(function onstat(err, stat) {
         if (err && err.code === "ENOENT" && !extname(path6) && path6[path6.length - 1] !== sep) {
           return next(err);
         }
@@ -24475,7 +24475,7 @@ var require_send = __commonJS({
         }
         var p = path6 + "." + self._extensions[i++];
         debug('stat "%s"', p);
-        fs7.stat(p, function(err2, stat) {
+        fs9.stat(p, function(err2, stat) {
           if (err2) return next(err2);
           if (stat.isDirectory()) return next();
           self.emit("file", p, stat);
@@ -24492,9 +24492,9 @@ var require_send = __commonJS({
           if (err) return self.onStatError(err);
           return self.error(404);
         }
-        var p = join3(path6, self._index[i]);
+        var p = join5(path6, self._index[i]);
         debug('stat "%s"', p);
-        fs7.stat(p, function(err2, stat) {
+        fs9.stat(p, function(err2, stat) {
           if (err2) return next(err2);
           if (stat.isDirectory()) return next();
           self.emit("file", p, stat);
@@ -24507,7 +24507,7 @@ var require_send = __commonJS({
     SendStream.prototype.stream = /* @__PURE__ */ __name(function stream(path6, options) {
       var self = this;
       var res = this.res;
-      var stream2 = fs7.createReadStream(path6, options);
+      var stream2 = fs9.createReadStream(path6, options);
       this.emit("stream", stream2);
       stream2.pipe(res);
       function cleanup() {
@@ -27345,7 +27345,7 @@ var require_response = __commonJS({
     var encodeUrl = require_encodeurl();
     var escapeHtml = require_escape_html();
     var http = __require("http");
-    var isAbsolute2 = require_utils2().isAbsolute;
+    var isAbsolute3 = require_utils2().isAbsolute;
     var onFinished = require_on_finished();
     var path5 = __require("path");
     var statuses = require_statuses();
@@ -27551,7 +27551,7 @@ var require_response = __commonJS({
         done = options;
         opts = {};
       }
-      if (!opts.root && !isAbsolute2(path6)) {
+      if (!opts.root && !isAbsolute3(path6)) {
         throw new TypeError("path must be absolute or specify root to res.sendFile");
       }
       var pathname = encodeURI(path6);
@@ -28791,6 +28791,13 @@ function matchesPath(actualPath, pattern) {
   return matchesPathPattern(actualPath, pattern);
 }
 __name(matchesPath, "matchesPath");
+function matchesMethod(actualMethod, expectedMethod) {
+  if (!actualMethod || !expectedMethod) {
+    return false;
+  }
+  return actualMethod.toUpperCase() === expectedMethod.toUpperCase();
+}
+__name(matchesMethod, "matchesMethod");
 function serializeError(error) {
   return error instanceof Error ? {
     name: error.name,
@@ -28834,7 +28841,7 @@ async function readLogEntriesByTrace(filePath, traceId, limit) {
   return matches;
 }
 __name(readLogEntriesByTrace, "readLogEntriesByTrace");
-async function readRecentTraceCalls(filePath, page, pageSize, pathFilter) {
+async function readRecentTraceCalls(filePath, page, pageSize, pathFilter, methodFilter) {
   if (!await fileExists(filePath)) {
     return void 0;
   }
@@ -28871,7 +28878,9 @@ async function readRecentTraceCalls(filePath, page, pageSize, pathFilter) {
     if (!builder.path && entry.path) {
       builder.path = String(entry.path);
     }
-    const shouldInclude = !pathFilter || matchesPath(builder.path, pathFilter);
+    const pathMatches = !pathFilter || matchesPath(builder.path, pathFilter);
+    const methodMatches = !methodFilter || matchesMethod(builder.method, methodFilter);
+    const shouldInclude = pathMatches && methodMatches;
     if (shouldInclude) {
       completedCalls.push(builder);
     }
@@ -29061,8 +29070,9 @@ function createGetRecentTracesHandler(logDir) {
     const page = parsePositiveInt(req.query.page, 1);
     const pageSize = parseLimit(req.query.pageSize, 10, 100);
     const pathFilter = typeof req.query.path === "string" ? req.query.path.trim() : void 0;
+    const methodFilter = typeof req.query.method === "string" ? req.query.method.trim().toUpperCase() : void 0;
     try {
-      const result = await readRecentTraceCalls(traceLogPath, page, pageSize, pathFilter);
+      const result = await readRecentTraceCalls(traceLogPath, page, pageSize, pathFilter, methodFilter);
       if (!result) {
         return handleNotFound(res, traceLogPath);
       }
@@ -29070,6 +29080,7 @@ function createGetRecentTracesHandler(logDir) {
         file: getRelativePath(traceLogPath),
         ...result,
         path: pathFilter || null,
+        method: methodFilter || null,
         count: result.calls.length
       });
     } catch (error) {
@@ -29126,7 +29137,7 @@ var DEV_LOGS_ROUTES = [
   {
     method: "GET",
     path: "/trace/recent",
-    description: "Get recent trace calls with pagination and optional path filter"
+    description: "Get recent trace calls with pagination and optional path/method filters"
   },
   {
     method: "GET",
@@ -29150,6 +29161,101 @@ function createDevLogsMiddleware(options = {}) {
 }
 __name(createDevLogsMiddleware, "createDevLogsMiddleware");
 
+// src/middlewares/collect-logs/router.ts
+var import_express3 = __toESM(require_express2(), 1);
+
+// src/middlewares/collect-logs/controller.ts
+import { join as join4 } from "path";
+import fs8 from "fs";
+
+// src/middlewares/collect-logs/utils.ts
+import { isAbsolute as isAbsolute2, join as join3 } from "path";
+import fs7 from "fs";
+function resolveLogDir2(provided) {
+  if (!provided) {
+    return join3(process.cwd(), "logs");
+  }
+  return isAbsolute2(provided) ? provided : join3(process.cwd(), provided);
+}
+__name(resolveLogDir2, "resolveLogDir");
+function ensureDir(dir) {
+  if (!fs7.existsSync(dir)) {
+    fs7.mkdirSync(dir, {
+      recursive: true
+    });
+  }
+}
+__name(ensureDir, "ensureDir");
+function serializeError2(error) {
+  return error instanceof Error ? {
+    name: error.name,
+    message: error.message
+  } : {
+    message: String(error)
+  };
+}
+__name(serializeError2, "serializeError");
+
+// src/middlewares/collect-logs/controller.ts
+function collectLogsHandler(logDir, fileName) {
+  const filePath = join4(logDir, fileName);
+  ensureDir(logDir);
+  return async (req, res) => {
+    try {
+      const logContent = req.body;
+      const logLine = JSON.stringify(logContent) + "\n";
+      await fs8.promises.appendFile(filePath, logLine);
+      res.json({
+        success: true
+      });
+    } catch (error) {
+      handleError2(res, error, "Failed to collect logs");
+    }
+  };
+}
+__name(collectLogsHandler, "collectLogsHandler");
+function handleError2(res, error, message = "Failed to collect logs") {
+  res.status(500).json({
+    message,
+    error: serializeError2(error)
+  });
+}
+__name(handleError2, "handleError");
+
+// src/middlewares/collect-logs/router.ts
+function createDevLogRouter2(options = {}) {
+  const logDir = resolveLogDir2(options.logDir);
+  const router = import_express3.default.Router();
+  router.post("/collect", import_express3.default.json(), collectLogsHandler(logDir, options.fileName || "client.log"));
+  return router;
+}
+__name(createDevLogRouter2, "createDevLogRouter");
+
+// src/middlewares/collect-logs/index.ts
+var DEV_LOGS_ROUTES2 = [
+  {
+    method: "POST",
+    path: "/collect",
+    description: "Collect logs from client."
+  }
+];
+function createCollectLogsMiddleware(options = {}) {
+  const { logDir } = options;
+  return {
+    name: "collect-logs",
+    mountPath: "/dev/logs",
+    routes: DEV_LOGS_ROUTES2,
+    enabled: /* @__PURE__ */ __name((context) => context.isDev, "enabled"),
+    createRouter: /* @__PURE__ */ __name((context) => {
+      return createDevLogRouter2({
+        logDir: logDir || context.logDir,
+        fileName: options.fileName || "client.log"
+      });
+    }, "createRouter")
+  };
+}
+__name(createCollectLogsMiddleware, "createCollectLogsMiddleware");
+
 // src/middlewares/index.ts
 function isRouteMiddleware(middleware) {
   return "createRouter" in middleware && middleware.createRouter !== void 0;
@@ -29227,6 +29333,7 @@ async function registerMiddlewares(server, middlewares, options) {
 }
 __name(registerMiddlewares, "registerMiddlewares");
 export {
+  createCollectLogsMiddleware,
   createDevLogsMiddleware,
   createOpenapiMiddleware,
   normalizeBasePath,