@modern-js/bff-core 2.7.0 → 2.7.1-alpha.0

package/dist/js/modern/api.js

@@ -0,0 +1,69 @@
+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 "reflect-metadata";
+import compose from "koa-compose";
+import { validateFunction, HANDLER_WITH_META } from "./utils";
+function Api(...args) {
+  const handler = args.pop();
+  validateFunction(handler, "Apihandler");
+  const operators = args;
+  const metadataHelper = {
+    getMetadata(key) {
+      return Reflect.getMetadata(key, runner);
+    },
+    setMetadata(key, value) {
+      return Reflect.defineMetadata(key, value, runner);
+    }
+  };
+  for (const operator of operators) {
+    if (operator.metadata) {
+      operator.metadata(metadataHelper);
+    }
+  }
+  const validateHandlers = operators.filter((operator) => operator.validate).map((operator) => operator.validate);
+  const pipeHandlers = operators.filter((operator) => operator.execute).map((operator) => operator.execute);
+  function runner(inputs) {
+    return __async(this, null, function* () {
+      const executeHelper = {
+        result: null,
+        get inputs() {
+          return inputs;
+        },
+        set inputs(val) {
+          inputs = val;
+        }
+      };
+      const stack = [...validateHandlers, ...pipeHandlers];
+      stack.push((helper, next) => __async(this, null, function* () {
+        const res = yield handler(helper.inputs);
+        helper.result = res;
+        return next();
+      }));
+      yield compose(stack)(executeHelper);
+      return executeHelper.result;
+    });
+  }
+  runner[HANDLER_WITH_META] = true;
+  return runner;
+}
+export {
+  Api
+};

package/dist/js/modern/client/generate-client.js

@@ -0,0 +1,79 @@
+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 * as path from "path";
+import { ApiRouter } from "../router";
+import { Ok, Err } from "./result";
+const DEFAULT_CLIENT_REQUEST_CREATOR = "@modern-js/create-request";
+const generateClient = (_0) => __async(void 0, [_0], function* ({
+  resourcePath,
+  apiDir,
+  prefix,
+  port,
+  target,
+  requestCreator,
+  fetcher,
+  requireResolve = require.resolve
+}) {
+  if (!requestCreator) {
+    requestCreator = requireResolve(
+      `${DEFAULT_CLIENT_REQUEST_CREATOR}${target ? `/${target}` : ""}`
+    ).replace(/\\/g, "/");
+  } else {
+    let resolvedPath = requestCreator;
+    try {
+      resolvedPath = path.dirname(requireResolve(requestCreator));
+    } catch (error) {
+    }
+    requestCreator = `${resolvedPath}${target ? `/${target}` : ""}`.replace(
+      /\\/g,
+      "/"
+    );
+  }
+  const apiRouter = new ApiRouter({
+    apiDir,
+    prefix
+  });
+  const handlerInfos = apiRouter.getSingleModuleHandlers(resourcePath);
+  if (!handlerInfos) {
+    return Err(`generate client error: Cannot require module ${resourcePath}`);
+  }
+  let handlersCode = "";
+  for (const handlerInfo of handlerInfos) {
+    const { name, httpMethod, routePath } = handlerInfo;
+    let exportStatement = `const ${name} =`;
+    if (name.toLowerCase() === "default") {
+      exportStatement = "default";
+    }
+    const upperHttpMethod = httpMethod.toUpperCase();
+    const routeName = routePath;
+    handlersCode += `export ${exportStatement} createRequest('${routeName}', '${upperHttpMethod}', ${process.env.PORT || String(port)}${fetcher ? `, fetch` : ""});
+`;
+  }
+  const importCode = `import { createRequest } from '${requestCreator}';
+${fetcher ? `import { fetch } from '${fetcher}';
+` : ""}`;
+  return Ok(`${importCode}
+${handlersCode}`);
+});
+export {
+  DEFAULT_CLIENT_REQUEST_CREATOR,
+  generateClient
+};

package/dist/js/modern/client/index.js

@@ -0,0 +1 @@
+export * from "./generate-client";

package/dist/js/modern/client/result.js

@@ -0,0 +1,22 @@
+const Err = (value) => {
+  const err = {
+    kind: "Err",
+    value,
+    isErr: true,
+    isOk: false
+  };
+  return err;
+};
+const Ok = (value) => {
+  const ok = {
+    kind: "Ok",
+    value,
+    isErr: false,
+    isOk: true
+  };
+  return ok;
+};
+export {
+  Err,
+  Ok
+};

package/dist/js/modern/errors/http.js

@@ -0,0 +1,16 @@
+class HttpError extends Error {
+  constructor(status, message) {
+    super(message);
+    this.status = status;
+  }
+}
+class ValidationError extends HttpError {
+  constructor(status, message) {
+    super(status, message);
+    this.code = "VALIDATION_ERROR";
+  }
+}
+export {
+  HttpError,
+  ValidationError
+};

package/dist/js/modern/index.js

@@ -0,0 +1,23 @@
+import { Api } from "./api";
+import { HttpError, ValidationError } from "./errors/http";
+export * from "./router";
+export * from "./types";
+export * from "./client";
+export * from "./operators/http";
+import {
+  getRelativeRuntimePath,
+  HANDLER_WITH_META,
+  isWithMetaHandler,
+  createStorage,
+  registerPaths
+} from "./utils";
+export {
+  Api,
+  HANDLER_WITH_META,
+  HttpError,
+  ValidationError,
+  createStorage,
+  getRelativeRuntimePath,
+  isWithMetaHandler,
+  registerPaths
+};

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
+};