@modern-js/bff-core 2.5.0 → 2.5.1-alpha.0

package/dist/js/modern/operators/http.js

@@ -0,0 +1,210 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+import {
+  HttpMetadata,
+  OperatorType,
+  HttpMethod,
+  TriggerType,
+  ResponseMetaType
+} from "../types";
+import { ValidationError } from "../errors/http";
+const validateInput = (schema, input) => __async(void 0, null, function* () {
+  try {
+    return yield schema.parseAsync(input);
+  } catch (error) {
+    const { z: zod } = require("zod");
+    if (error instanceof zod.ZodError) {
+      throw new ValidationError(400, error.message);
+    }
+    throw error;
+  }
+});
+const createHttpOperator = (method) => {
+  return (urlPath) => {
+    return {
+      name: method,
+      metadata({ setMetadata }) {
+        setMetadata(OperatorType.Trigger, {
+          type: TriggerType.Http,
+          path: urlPath,
+          method
+        });
+      }
+    };
+  };
+};
+const Get = createHttpOperator(HttpMethod.Get);
+const Post = createHttpOperator(HttpMethod.Post);
+const Put = createHttpOperator(HttpMethod.Put);
+const Delete = createHttpOperator(HttpMethod.Delete);
+const Connect = createHttpOperator(HttpMethod.Connect);
+const Trace = createHttpOperator(HttpMethod.Trace);
+const Patch = createHttpOperator(HttpMethod.Patch);
+const Option = createHttpOperator(HttpMethod.Option);
+const Head = createHttpOperator(HttpMethod.Head);
+const Data = (schema) => {
+  return {
+    name: HttpMetadata.Data,
+    metadata({ setMetadata }) {
+      setMetadata(HttpMetadata.Data, schema);
+    },
+    validate(helper, next) {
+      return __async(this, null, function* () {
+        const {
+          inputs: { data }
+        } = helper;
+        helper.inputs = __spreadProps(__spreadValues({}, helper.inputs), {
+          data: yield validateInput(schema, data)
+        });
+        return next();
+      });
+    }
+  };
+};
+const Query = (schema) => {
+  return {
+    name: HttpMetadata.Query,
+    metadata({ setMetadata }) {
+      setMetadata(HttpMetadata.Query, schema);
+    },
+    validate(helper, next) {
+      return __async(this, null, function* () {
+        const {
+          inputs: { query }
+        } = helper;
+        helper.inputs = __spreadProps(__spreadValues({}, helper.inputs), {
+          query: yield validateInput(schema, query)
+        });
+        return next();
+      });
+    }
+  };
+};
+const Params = (schema) => {
+  return {
+    name: HttpMetadata.Params,
+    metadata({ setMetadata }) {
+      setMetadata(HttpMetadata.Params, schema);
+    },
+    validate(helper, next) {
+      return __async(this, null, function* () {
+        const {
+          inputs: { params }
+        } = helper;
+        helper.inputs = __spreadProps(__spreadValues({}, helper.inputs), {
+          params: yield validateInput(schema, params)
+        });
+        return next();
+      });
+    }
+  };
+};
+const Headers = (schema) => {
+  return {
+    name: HttpMetadata.Headers,
+    metadata({ setMetadata }) {
+      setMetadata(HttpMetadata.Headers, schema);
+    },
+    validate(helper, next) {
+      return __async(this, null, function* () {
+        const {
+          inputs: { headers }
+        } = helper;
+        helper.inputs = __spreadProps(__spreadValues({}, helper.inputs), {
+          headers: yield validateInput(schema, headers)
+        });
+        return next();
+      });
+    }
+  };
+};
+const setResponseMeta = (helper, type, value) => {
+  const responseMetaData = helper.getMetadata(HttpMetadata.Response) || [];
+  helper.setMetadata(HttpMetadata.Response, [
+    ...responseMetaData,
+    {
+      type,
+      value
+    }
+  ]);
+};
+const HttpCode = (statusCode) => {
+  return {
+    name: "HttpCode",
+    metadata(helper) {
+      setResponseMeta(helper, ResponseMetaType.StatusCode, statusCode);
+    }
+  };
+};
+const SetHeaders = (headers) => {
+  return {
+    name: "SetHeaders",
+    metadata(helper) {
+      setResponseMeta(helper, ResponseMetaType.Headers, headers);
+    }
+  };
+};
+const Redirect = (url) => {
+  return {
+    name: "Redirect",
+    metadata(helper) {
+      setResponseMeta(helper, ResponseMetaType.Redirect, url);
+    }
+  };
+};
+export {
+  Connect,
+  Data,
+  Delete,
+  Get,
+  Head,
+  Headers,
+  HttpCode,
+  Option,
+  Params,
+  Patch,
+  Post,
+  Put,
+  Query,
+  Redirect,
+  SetHeaders,
+  Trace,
+  createHttpOperator
+};

package/dist/js/modern/router/constants.js

@@ -0,0 +1,32 @@
+import { HttpMethod } from "../types";
+const AllHttpMethods = Object.values(HttpMethod);
+var APIMode = /* @__PURE__ */ ((APIMode2) => {
+  APIMode2["FARMEWORK"] = "framework";
+  APIMode2["FUNCTION"] = "function";
+  return APIMode2;
+})(APIMode || {});
+const FRAMEWORK_MODE_LAMBDA_DIR = "lambda";
+const FRAMEWORK_MODE_APP_DIR = "app";
+const INDEX_SUFFIX = "index";
+const API_DIR = "api";
+const API_FILE_RULES = [
+  "**/*.[tj]s",
+  "!**/_*",
+  "!**/_*/**/*.[tj]s",
+  "!**/*.test.js",
+  "!**/*.test.ts",
+  "!**/*.d.ts",
+  "!__test__/*.ts",
+  "!__tests__/*.ts",
+  "!node_modules/**",
+  "!bootstrap.js"
+];
+export {
+  APIMode,
+  API_DIR,
+  API_FILE_RULES,
+  AllHttpMethods,
+  FRAMEWORK_MODE_APP_DIR,
+  FRAMEWORK_MODE_LAMBDA_DIR,
+  INDEX_SUFFIX
+};

package/dist/js/modern/router/index.js

@@ -0,0 +1,236 @@
+import path from "path";
+import { fs, logger } from "@modern-js/utils";
+import "reflect-metadata";
+import { HttpMethod, httpMethods, OperatorType, TriggerType } from "../types";
+import { debug } from "../utils";
+import {
+  APIMode,
+  FRAMEWORK_MODE_LAMBDA_DIR,
+  API_FILE_RULES,
+  FRAMEWORK_MODE_APP_DIR
+} from "./constants";
+import {
+  getFiles,
+  getPathFromFilename,
+  requireHandlerModule,
+  sortRoutes
+} from "./utils";
+export * from "./types";
+export * from "./constants";
+class ApiRouter {
+  constructor({
+    apiDir,
+    lambdaDir,
+    prefix
+  }) {
+    this.apiFiles = [];
+    this.getExactApiMode = (apiDir) => {
+      const exist = this.createExistChecker(apiDir);
+      const existLambdaDir = exist(FRAMEWORK_MODE_LAMBDA_DIR);
+      const existAppDir = exist(FRAMEWORK_MODE_APP_DIR);
+      const existAppFile = exist("app.ts") || exist("app.js");
+      if (existLambdaDir || existAppDir || existAppFile) {
+        return APIMode.FARMEWORK;
+      }
+      return APIMode.FUNCTION;
+    };
+    this.createExistChecker = (base) => (target) => fs.pathExistsSync(path.resolve(base, target));
+    this.getExactLambdaDir = (apiDir) => {
+      if (this.lambdaDir) {
+        return this.lambdaDir;
+      }
+      const lambdaDir = this.apiMode === APIMode.FARMEWORK ? path.join(apiDir, FRAMEWORK_MODE_LAMBDA_DIR) : apiDir;
+      return lambdaDir;
+    };
+    this.validateAbsolute(apiDir, "apiDir");
+    this.validateAbsolute(lambdaDir, "lambdaDir");
+    this.prefix = this.initPrefix(prefix);
+    this.apiDir = apiDir;
+    this.apiMode = this.getExactApiMode(apiDir);
+    this.lambdaDir = lambdaDir || this.getExactLambdaDir(this.apiDir);
+    this.existLambdaDir = fs.existsSync(this.lambdaDir);
+  }
+  isExistLambda() {
+    return this.existLambdaDir;
+  }
+  getApiMode() {
+    return this.apiMode;
+  }
+  getLambdaDir() {
+    return this.lambdaDir;
+  }
+  isApiFile(filename) {
+    if (this.existLambdaDir) {
+      return false;
+    }
+    if (!this.apiFiles.includes(filename)) {
+      return false;
+    }
+    return true;
+  }
+  getSingleModuleHandlers(filename) {
+    const moduleInfo = this.getModuleInfo(filename);
+    if (moduleInfo) {
+      return this.getModuleHandlerInfos(moduleInfo);
+    }
+    return null;
+  }
+  getHandlerInfo(filename, originFuncName, handler) {
+    const httpMethod = this.getHttpMethod(originFuncName, handler);
+    const routeName = this.getRouteName(filename, handler);
+    if (httpMethod && routeName) {
+      return {
+        handler,
+        name: originFuncName,
+        httpMethod,
+        routeName,
+        filename,
+        routePath: this.getRoutePath(this.prefix, routeName)
+      };
+    }
+    return null;
+  }
+  getSafeRoutePath(filename, handler) {
+    this.loadApiFiles();
+    this.validateValidApifile(filename);
+    return this.getRouteName(filename, handler);
+  }
+  getRouteName(filename, handler) {
+    if (handler) {
+      const trigger = Reflect.getMetadata(OperatorType.Trigger, handler);
+      if (trigger && trigger.type === TriggerType.Http) {
+        if (!trigger.path) {
+          throw new Error(
+            `The http trigger ${trigger.name} needs to specify a path`
+          );
+        }
+        return trigger.path;
+      }
+    }
+    const routePath = getPathFromFilename(this.lambdaDir, filename);
+    return routePath;
+  }
+  getHttpMethod(originHandlerName, handler) {
+    if (handler) {
+      const trigger = Reflect.getMetadata(OperatorType.Trigger, handler);
+      if (trigger && httpMethods.includes(trigger.method)) {
+        return trigger.method;
+      }
+    }
+    const upperName = originHandlerName.toUpperCase();
+    switch (upperName) {
+      case "GET":
+        return HttpMethod.Get;
+      case "POST":
+        return HttpMethod.Post;
+      case "PUT":
+        return HttpMethod.Put;
+      case "DELETE":
+      case "DEL":
+        return HttpMethod.Delete;
+      case "CONNECT":
+        return HttpMethod.Connect;
+      case "TRACE":
+        return HttpMethod.Trace;
+      case "PATCH":
+        return HttpMethod.Patch;
+      case "OPTION":
+        return HttpMethod.Option;
+      case "DEFAULT": {
+        return HttpMethod.Get;
+      }
+      default:
+        logger.warn(
+          `Only api handlers are allowd to be exported, please remove the function ${originHandlerName} from exports`
+        );
+        return null;
+    }
+  }
+  loadApiFiles() {
+    if (!this.existLambdaDir) {
+      return [];
+    }
+    const apiFiles = this.apiFiles = getFiles(this.lambdaDir, API_FILE_RULES);
+    return apiFiles;
+  }
+  getApiFiles() {
+    if (!this.existLambdaDir) {
+      return [];
+    }
+    if (this.apiFiles.length > 0) {
+      return this.apiFiles;
+    }
+    return this.loadApiFiles();
+  }
+  getApiHandlers() {
+    const filenames = this.getApiFiles();
+    const moduleInfos = this.getModuleInfos(filenames);
+    const apiHandlers = this.getHandlerInfos(moduleInfos);
+    debug("apiHandlers", apiHandlers.length, apiHandlers);
+    return apiHandlers;
+  }
+  initPrefix(prefix) {
+    if (prefix === "/") {
+      return "";
+    }
+    return prefix || "/api";
+  }
+  validateAbsolute(filename, paramsName) {
+    if (typeof filename === "string" && !path.isAbsolute(filename)) {
+      throw new Error(`The ${paramsName} ${filename} is not a abolute path`);
+    }
+  }
+  getModuleInfos(filenames) {
+    return filenames.map((filename) => this.getModuleInfo(filename)).filter((moduleInfo) => Boolean(moduleInfo));
+  }
+  getModuleInfo(filename) {
+    try {
+      const module = requireHandlerModule(filename);
+      return {
+        filename,
+        module
+      };
+    } catch (err) {
+      if (process.env.NODE_ENV === "production") {
+        throw err;
+      } else {
+        console.error(err);
+        return null;
+      }
+    }
+  }
+  getHandlerInfos(moduleInfos) {
+    let apiHandlers = [];
+    moduleInfos.forEach((moduleInfo) => {
+      const handlerInfos = this.getModuleHandlerInfos(moduleInfo);
+      if (handlerInfos) {
+        apiHandlers = apiHandlers.concat(handlerInfos);
+      }
+    });
+    const sortedHandlers = sortRoutes(apiHandlers);
+    return sortedHandlers;
+  }
+  getModuleHandlerInfos(moduleInfo) {
+    const { module, filename } = moduleInfo;
+    return Object.entries(module).filter(([, handler]) => typeof handler === "function").map(([key]) => {
+      const handler = module[key];
+      const handlerInfo = this.getHandlerInfo(filename, key, handler);
+      return handlerInfo;
+    }).filter((handlerInfo) => Boolean(handlerInfo));
+  }
+  validateValidApifile(filename) {
+    if (!this.apiFiles.includes(filename)) {
+      throw new Error(`The ${filename} is not a valid api file.`);
+    }
+  }
+  getRoutePath(prefix, routeName) {
+    const finalRouteName = routeName === "/" ? "" : routeName;
+    if (prefix === "" && finalRouteName === "") {
+      return "/";
+    }
+    return `${prefix}${finalRouteName}`;
+  }
+}
+export {
+  ApiRouter
+};

package/dist/js/modern/router/utils.js

@@ -0,0 +1,83 @@
+import path from "path";
+import { globby } from "@modern-js/utils";
+import { INDEX_SUFFIX } from "./constants";
+const getFiles = (lambdaDir, rules) => globby.sync(rules, {
+  cwd: lambdaDir,
+  gitignore: true
+}).map((file) => path.resolve(lambdaDir, file));
+const getPathFromFilename = (baseDir, filename) => {
+  const relativeName = filename.substring(baseDir.length);
+  const relativePath = relativeName.split(".").slice(0, -1).join(".");
+  const nameSplit = relativePath.split(path.sep).map((item) => {
+    if (item.length > 2) {
+      if (item.startsWith("[") && item.endsWith("]")) {
+        return `:${item.substring(1, item.length - 1)}`;
+      }
+    }
+    return item;
+  });
+  const name = nameSplit.join("/");
+  const finalName = name.endsWith(INDEX_SUFFIX) ? name.substring(0, name.length - INDEX_SUFFIX.length) : name;
+  return clearRouteName(finalName);
+};
+const clearRouteName = (routeName) => {
+  let finalRouteName = routeName.trim();
+  if (!finalRouteName.startsWith("/")) {
+    finalRouteName = `/${finalRouteName}`;
+  }
+  if (finalRouteName.length > 1 && finalRouteName.endsWith("/")) {
+    finalRouteName = finalRouteName.substring(0, finalRouteName.length - 1);
+  }
+  return finalRouteName;
+};
+const isHandler = (input) => input && typeof input === "function";
+const enableRegister = (requireFn) => {
+  let existTsLoader = false;
+  let firstCall = true;
+  return (modulePath) => {
+    if (firstCall) {
+      existTsLoader = Boolean(require.extensions[".ts"]);
+      firstCall = false;
+    }
+    if (!existTsLoader) {
+      const {
+        register
+      } = require("esbuild-register/dist/node");
+      const { unregister } = register({
+        extensions: [".ts"]
+      });
+      const requiredModule2 = requireFn(modulePath);
+      unregister();
+      return requiredModule2;
+    }
+    const requiredModule = requireFn(modulePath);
+    return requiredModule;
+  };
+};
+const isFunction = (input) => input && {}.toString.call(input) === "[object Function]";
+const requireHandlerModule = enableRegister((modulePath) => {
+  const originRequire = process.env.NODE_ENV === "test" ? jest.requireActual : require;
+  const module = originRequire(modulePath);
+  if (isFunction(module)) {
+    return { default: module };
+  }
+  return module;
+});
+const routeValue = (routePath) => {
+  if (routePath.includes(":")) {
+    return 11;
+  }
+  return 1;
+};
+const sortRoutes = (apiHandlers) => {
+  return apiHandlers.sort((handlerA, handlerB) => {
+    return routeValue(handlerA.routeName) - routeValue(handlerB.routeName);
+  });
+};
+export {
+  getFiles,
+  getPathFromFilename,
+  isHandler,
+  requireHandlerModule,
+  sortRoutes
+};

package/dist/js/modern/types.js

@@ -0,0 +1,45 @@
+var OperatorType = /* @__PURE__ */ ((OperatorType2) => {
+  OperatorType2[OperatorType2["Trigger"] = 0] = "Trigger";
+  OperatorType2[OperatorType2["Middleware"] = 1] = "Middleware";
+  return OperatorType2;
+})(OperatorType || {});
+var TriggerType = /* @__PURE__ */ ((TriggerType2) => {
+  TriggerType2[TriggerType2["Http"] = 0] = "Http";
+  return TriggerType2;
+})(TriggerType || {});
+var HttpMetadata = /* @__PURE__ */ ((HttpMetadata2) => {
+  HttpMetadata2["Method"] = "METHOD";
+  HttpMetadata2["Data"] = "DATA";
+  HttpMetadata2["Query"] = "QUERY";
+  HttpMetadata2["Params"] = "PARAMS";
+  HttpMetadata2["Headers"] = "HEADERS";
+  HttpMetadata2["Response"] = "RESPONSE";
+  return HttpMetadata2;
+})(HttpMetadata || {});
+var ResponseMetaType = /* @__PURE__ */ ((ResponseMetaType2) => {
+  ResponseMetaType2[ResponseMetaType2["StatusCode"] = 0] = "StatusCode";
+  ResponseMetaType2[ResponseMetaType2["Redirect"] = 1] = "Redirect";
+  ResponseMetaType2[ResponseMetaType2["Headers"] = 2] = "Headers";
+  return ResponseMetaType2;
+})(ResponseMetaType || {});
+var HttpMethod = /* @__PURE__ */ ((HttpMethod2) => {
+  HttpMethod2["Get"] = "GET";
+  HttpMethod2["Post"] = "POST";
+  HttpMethod2["Put"] = "PUT";
+  HttpMethod2["Delete"] = "DELETE";
+  HttpMethod2["Connect"] = "CONNECT";
+  HttpMethod2["Trace"] = "TRACE";
+  HttpMethod2["Patch"] = "PATCH";
+  HttpMethod2["Option"] = "OPTION";
+  HttpMethod2["Head"] = "HEAD";
+  return HttpMethod2;
+})(HttpMethod || {});
+const httpMethods = Object.values(HttpMethod);
+export {
+  HttpMetadata,
+  HttpMethod,
+  OperatorType,
+  ResponseMetaType,
+  TriggerType,
+  httpMethods
+};

package/dist/js/modern/utils/alias.js

@@ -0,0 +1,76 @@
+import * as path from "path";
+import * as os from "os";
+import fs from "fs";
+import Module from "module";
+const getRelativeRuntimePath = (appDirectory, serverRuntimePath) => {
+  let relativeRuntimePath = "";
+  if (os.platform() === "win32") {
+    relativeRuntimePath = `../${path.relative(
+      appDirectory,
+      serverRuntimePath
+    )}`;
+  } else {
+    relativeRuntimePath = path.join(
+      "../",
+      path.relative(appDirectory, serverRuntimePath)
+    );
+  }
+  if (process.env.NODE_ENV === "development" || process.env.NODE_ENV === "test") {
+    relativeRuntimePath = `./${path.relative(appDirectory, serverRuntimePath)}`;
+  }
+  return relativeRuntimePath;
+};
+const sortByLongestPrefix = (arr) => {
+  return arr.concat().sort((a, b) => b.length - a.length);
+};
+const createMatchPath = (paths) => {
+  const sortedKeys = sortByLongestPrefix(Object.keys(paths));
+  const sortedPaths = {};
+  sortedKeys.forEach((key) => {
+    sortedPaths[key] = paths[key];
+  });
+  return (request) => {
+    const found = Object.keys(sortedPaths).find((key) => {
+      return request.startsWith(key);
+    });
+    if (found) {
+      let foundPaths = sortedPaths[found];
+      if (!Array.isArray(foundPaths)) {
+        foundPaths = [foundPaths];
+      }
+      foundPaths = foundPaths.filter((foundPath) => path.isAbsolute(foundPath));
+      for (const p of foundPaths) {
+        const foundPath = request.replace(found, p);
+        if (fs.existsSync(foundPath)) {
+          return foundPath;
+        }
+      }
+      return request.replace(found, foundPaths[0]);
+    }
+    return null;
+  };
+};
+const registerPaths = (paths) => {
+  const originalResolveFilename = Module._resolveFilename;
+  const { builtinModules } = Module;
+  const matchPath = createMatchPath(paths);
+  Module._resolveFilename = function(request, _parent) {
+    const isCoreModule = builtinModules.includes(request);
+    if (!isCoreModule) {
+      const matched = matchPath(request);
+      if (matched) {
+        const modifiedArguments = [matched, ...[].slice.call(arguments, 1)];
+        return originalResolveFilename.apply(this, modifiedArguments);
+      }
+    }
+    return originalResolveFilename.apply(this, arguments);
+  };
+  return () => {
+    Module._resolveFilename = originalResolveFilename;
+  };
+};
+export {
+  createMatchPath,
+  getRelativeRuntimePath,
+  registerPaths
+};

package/dist/js/modern/utils/debug.js

@@ -0,0 +1,5 @@
+import { createDebugger } from "@modern-js/utils";
+const debug = createDebugger("bff");
+export {
+  debug
+};

package/dist/js/modern/utils/index.js

@@ -0,0 +1,8 @@
+export * from "./storage";
+export * from "./alias";
+import { debug } from "./debug";
+export * from "./meta";
+export * from "./validate";
+export {
+  debug
+};