@keq-request/cli 5.0.0-alpha.26 → 5.0.0-alpha.28

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 ## 5.0.0-alpha.6 (2025-09-17)
 
+## 5.0.0-alpha.28
+
+### Major Changes
+
+- bbc3403: **BREAKING CHANGE:** drop support relative path and use 'file://' insteaded.
+- bbc3403: **BREAKING CHANGE:** rename defineKeqConfig to defineConfig.
+
+### Patch Changes
+
+- Updated dependencies [d076b76]
+  - keq@5.0.0-alpha.28
+
+## 5.0.0-alpha.27
+
+### Patch Changes
+
+- Updated dependencies [0c7db81]
+  - keq@5.0.0-alpha.27
+
 ## 5.0.0-alpha.26
 
 ### Patch Changes

package/dist/cli.cjs

@@ -53,7 +53,6 @@ var import_tapable4 = require("tapable");
 // src/compiler/tasks/setup/index.ts
 var import_fs_extra2 = __toESM(require("fs-extra"), 1);
 var import_path = __toESM(require("path"), 1);
-var import_value = require("@sinclair/typebox/value");
 var import_cosmiconfig = require("cosmiconfig");
 
 // src/utils/ignore-matcher.ts
@@ -147,8 +146,51 @@ var IgnoreMatcher = class _IgnoreMatcher {
   }
 };
 
-// src/types/runtime-config.ts
+// src/compiler/tasks/setup/utils/find-nearest-package-json.ts
+var import_node_fs = __toESM(require("fs"), 1);
+var import_node_path = __toESM(require("path"), 1);
+function findNearestPackageJson(startDir = process.cwd()) {
+  let dir = startDir;
+  while (true) {
+    const pkgPath = import_node_path.default.join(dir, "package.json");
+    if (import_node_fs.default.existsSync(pkgPath)) {
+      const json = JSON.parse(import_node_fs.default.readFileSync(pkgPath, "utf8"));
+      return { json, path: pkgPath };
+    }
+    const parent = import_node_path.default.dirname(dir);
+    if (parent === dir) break;
+    dir = parent;
+  }
+  return null;
+}
+
+// src/compiler/tasks/setup/utils/get-project-module-system.ts
+function getProjectModuleSystem(pkgInfo) {
+  if (!pkgInfo?.json) return "cjs";
+  const { json } = pkgInfo;
+  if (json.type === "module") return "esm";
+  return "cjs";
+}
+
+// src/compiler/tasks/setup/utils/parse-runtime-config.ts
+var import_value = require("@sinclair/typebox/value");
+
+// src/types/address.ts
 var import_typebox = require("@sinclair/typebox");
+var Address = import_typebox.Type.Object({
+  url: import_typebox.Type.String(),
+  headers: import_typebox.Type.Optional(import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.String(), { default: {} })),
+  encoding: import_typebox.Type.Optional(
+    import_typebox.Type.Union([
+      import_typebox.Type.Literal("utf8"),
+      import_typebox.Type.Literal("ascii")
+    ], { default: "utf8" })
+  )
+});
+
+// src/types/runtime-config.ts
+var R2 = __toESM(require("ramda"), 1);
+var import_typebox2 = require("@sinclair/typebox");
 
 // src/constants/file-naming-style.ts
 var FileNamingStyle = /* @__PURE__ */ ((FileNamingStyle2) => {
@@ -166,13 +208,48 @@ var FileNamingStyle = /* @__PURE__ */ ((FileNamingStyle2) => {
   return FileNamingStyle2;
 })(FileNamingStyle || {});
 
+// src/utils/is-valid-url.ts
+var URL_REGEX = /^[a-zA-Z][a-zA-Z0-9+.-]*:\/\/(?:[^\s@]+@)?[^\s/:?#]*(?::\d+)?(?:\/[^\s?#]*)?(?:\?[^\s#]*)?(?:#[^\s]*)?$/;
+function isValidURL(url) {
+  return URL_REGEX.test(url);
+}
+
 // src/types/runtime-config.ts
-var RuntimeConfig = import_typebox.Type.Object({
-  mode: import_typebox.Type.Optional(
-    import_typebox.Type.Union([
-      import_typebox.Type.Literal("micro-function"),
-      import_typebox.Type.Literal("nestjs-module"),
-      import_typebox.Type.Literal("none")
+var Modules = import_typebox2.Type.Transform(
+  import_typebox2.Type.Record(
+    import_typebox2.Type.String(),
+    import_typebox2.Type.Union([import_typebox2.Type.String(), Address])
+  )
+).Decode((value) => {
+  const keys2 = Object.keys(value);
+  for (const key of keys2) {
+    if (!/^[A-Za-z_][A-Za-z0-9_$]*$/.test(key)) {
+      throw new Error(`Module name "${key}" is not valid. It must start with a letter or underscore, and can only contain letters, numbers, and underscores.`);
+    }
+  }
+  const keysGroupByLowerCase = R2.groupBy(R2.toLower, keys2);
+  for (const groupKey in keysGroupByLowerCase) {
+    const keys3 = keysGroupByLowerCase[groupKey] || [];
+    if (keys3.length > 1) {
+      throw new Error(`Module names ${keys3.map((name) => `"${name}"`).join(", ")} are case-insensitively duplicated.`);
+    }
+  }
+  for (const key in value) {
+    const url = typeof value[key] === "string" ? value[key] : value[key].url;
+    if (isValidURL(url)) continue;
+    throw new Error(`The ${JSON.stringify(url)} of module "${key}" is not a valid URL.`);
+  }
+  return R2.map(
+    (item) => typeof item !== "string" ? item : { url: item, headers: {}, encoding: "utf8" },
+    value
+  );
+}).Encode((value) => value);
+var RawConfig = import_typebox2.Type.Object({
+  mode: import_typebox2.Type.Optional(
+    import_typebox2.Type.Union([
+      import_typebox2.Type.Literal("micro-function"),
+      import_typebox2.Type.Literal("nestjs-module"),
+      import_typebox2.Type.Literal("none")
     ], { default: "micro-function" })
   ),
   /**
@@ -181,77 +258,39 @@ var RuntimeConfig = import_typebox.Type.Object({
    * If not specified, the module system will be inferred from the nearest package.json "type" field
    * or defaults to "cjs" if no package.json is found.
    */
-  esm: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: false })),
+  esm: import_typebox2.Type.Optional(import_typebox2.Type.Boolean({ default: false })),
   /**
    * Output directory for generated files
    */
-  outdir: import_typebox.Type.String({ default: `${process.cwd()}/api` }),
+  outdir: import_typebox2.Type.String({ default: `${process.cwd()}/api` }),
   /**
    * File naming style for generated files
    */
-  fileNamingStyle: import_typebox.Type.Enum(FileNamingStyle, { default: "snakeCase" /* snakeCase */ }),
-  modules: import_typebox.Type.Record(import_typebox.Type.String(), import_typebox.Type.String()),
-  debug: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: false })),
+  fileNamingStyle: import_typebox2.Type.Enum(FileNamingStyle, { default: "snakeCase" /* snakeCase */ }),
+  modules: Modules,
+  debug: import_typebox2.Type.Optional(import_typebox2.Type.Boolean({ default: false })),
   /**
    * Whether to tolerate wrong openapi/swagger structure
    */
-  tolerant: import_typebox.Type.Optional(import_typebox.Type.Boolean({ default: false })),
-  plugins: import_typebox.Type.Optional(import_typebox.Type.Array(import_typebox.Type.Any(), { default: [] }))
+  tolerant: import_typebox2.Type.Optional(import_typebox2.Type.Boolean({ default: false })),
+  plugins: import_typebox2.Type.Optional(import_typebox2.Type.Array(import_typebox2.Type.Unsafe(import_typebox2.Type.Any()), { default: [] }))
 });
 
-// src/compiler/tasks/setup/utils/validate-modules.ts
-var R2 = __toESM(require("ramda"), 1);
-var import_validator = __toESM(require("validator"), 1);
-function validateModules(modules) {
-  const keys2 = Object.keys(modules);
-  for (const key of keys2) {
-    if (!/^[A-Za-z_][A-Za-z0-9_$]*$/.test(key)) {
-      throw new Error(`Module name "${key}" is not valid. It must start with a letter or underscore, and can only contain letters, numbers, and underscores.`);
-    }
-  }
-  const keysGroupByLowerCase = R2.groupBy(R2.toLower, keys2);
-  for (const groupKey in keysGroupByLowerCase) {
-    const keys3 = keysGroupByLowerCase[groupKey] || [];
-    if (keys3.length > 1) {
-      throw new Error(`Module names ${keys3.map((name) => `"${name}"`).join(", ")} are case-insensitively duplicated.`);
-    }
-  }
-  for (const key in modules) {
-    const address = modules[key];
-    if (import_validator.default.isURL(address, { require_host: true, require_protocol: true, protocols: ["http", "https"] })) {
-      continue;
-    }
-    if (/^(\/|\.\/|\.\.\/)/.test(address)) {
-      continue;
+// src/compiler/tasks/setup/utils/parse-runtime-config.ts
+function parseRuntimeConfig(data) {
+  try {
+    const originalPlugins = typeof data === "object" && data !== null && "plugins" in data ? data.plugins : void 0;
+    const parsed = import_value.Value.Parse(RawConfig, data);
+    if (originalPlugins !== void 0) {
+      parsed.plugins = originalPlugins;
     }
-    throw new Error(`Module address "${address}" of module "${key}" is not valid. It must be a URL or a local path.`);
-  }
-}
-
-// src/compiler/tasks/setup/utils/find-nearest-package-json.ts
-var import_node_fs = __toESM(require("fs"), 1);
-var import_node_path = __toESM(require("path"), 1);
-function findNearestPackageJson(startDir = process.cwd()) {
-  let dir = startDir;
-  while (true) {
-    const pkgPath = import_node_path.default.join(dir, "package.json");
-    if (import_node_fs.default.existsSync(pkgPath)) {
-      const json = JSON.parse(import_node_fs.default.readFileSync(pkgPath, "utf8"));
-      return { json, path: pkgPath };
+    return parsed;
+  } catch (error) {
+    if (error instanceof Error) {
+      error.message = `Invalid Config: ${error.message}`;
     }
-    const parent = import_node_path.default.dirname(dir);
-    if (parent === dir) break;
-    dir = parent;
+    throw error;
   }
-  return null;
-}
-
-// src/compiler/tasks/setup/utils/get-project-module-system.ts
-function getProjectModuleSystem(pkgInfo) {
-  if (!pkgInfo?.json) return "cjs";
-  const { json } = pkgInfo;
-  if (json.type === "module") return "esm";
-  return "cjs";
 }
 
 // src/compiler/tasks/setup/index.ts
@@ -263,13 +302,7 @@ function main(compiler, options) {
       if (!result || "isEmpty" in result && result.isEmpty) {
         throw new Error("Cannot find config file.");
       }
-      if (!import_value.Value.Check(RuntimeConfig, result.config)) {
-        const errors = [...import_value.Value.Errors(RuntimeConfig, result.config)];
-        const message = errors.map(({ path: path13, message: message2 }) => `${path13}: ${message2}`).join("\n");
-        throw new Error(`Invalid Config: ${message}`);
-      }
-      const rc = import_value.Value.Default(RuntimeConfig, result.config);
-      validateModules(rc.modules);
+      const rc = parseRuntimeConfig(result.config);
       if (options?.debug) {
         await import_fs_extra2.default.ensureDir(".keq");
         rc.debug = true;
@@ -433,10 +466,14 @@ var ModuleDefinition = class _ModuleDefinition {
   address;
   constructor(name, address) {
     this.name = name;
-    this.address = address;
+    if (typeof address === "string") {
+      this.address = { url: address, headers: {}, encoding: "utf8" };
+    } else {
+      this.address = address;
+    }
   }
   static unknown() {
-    return new _ModuleDefinition("", "");
+    return new _ModuleDefinition("", { url: "", headers: {}, encoding: "utf8" });
   }
 };
 
@@ -901,10 +938,10 @@ function main2(compiler, options) {
               task2.skip(`(${moduleDefinition.name}) is ignored`);
               return;
             }
-            task2.output = `Downloaded from ${moduleDefinition.address}`;
+            task2.output = `Downloaded from ${moduleDefinition.address.url}`;
             const content = await compiler.hooks.download.promise(moduleDefinition.address, moduleDefinition, task2);
             if (!content) {
-              throw new Exception(moduleDefinition, `Cannot download document from ${moduleDefinition.address}`);
+              throw new Exception(moduleDefinition, `Cannot download document from ${moduleDefinition.address.url}`);
             }
             const spec = JSON.parse(content);
             const { valid, errors } = await (0, import_openapi_parser2.validate)(spec);
@@ -2563,24 +2600,25 @@ var GenerateNestjsModulePlugin = class _GenerateNestjsModulePlugin {
 var import_swagger_fix = require("swagger-fix");
 
 // src/plugins/download-http-file/download-http-file.plugin.ts
-var validUrl = __toESM(require("valid-url"), 1);
 var DownloadHttpFilePlugin = class _DownloadHttpFilePlugin {
   apply(compiler) {
     compiler.hooks.download.tapPromise(_DownloadHttpFilePlugin.name, async (address, task) => {
-      if (!validUrl.isUri(address)) return void 0;
+      const { url } = address;
+      if (!url.startsWith("http://") && !url.startsWith("https://")) return void 0;
       const content = await this.download(address);
       const spec = this.deserialize(content);
       return JSON.stringify(spec);
     });
   }
   async download(address) {
+    const { url, headers } = address;
     try {
-      const res = await fetch(address);
+      const res = await fetch(url, { headers });
       if (res.status >= 400) throw new Error(`failed with status code ${res.status}`);
       return await res.text();
     } catch (e) {
       if (e instanceof Error) {
-        e.message = `Unable get the openapi/swagger file from ${address}: ${e.message}`;
+        e.message = `Unable get the openapi/swagger file from ${url}: ${e.message}`;
       }
       throw e;
     }
@@ -2596,17 +2634,21 @@ var DownloadHttpFilePlugin = class _DownloadHttpFilePlugin {
 var path12 = __toESM(require("path"), 1);
 var fs5 = __toESM(require("fs/promises"), 1);
 var yaml = __toESM(require("js-yaml"), 1);
+var import_url = require("url");
 var DownloadLocalFilePlugin = class _DownloadLocalFilePlugin {
   apply(compiler) {
     compiler.hooks.download.tapPromise(_DownloadLocalFilePlugin.name, async (address, task) => {
-      if (!address.startsWith("./") && !address.startsWith("/") && !address.startsWith("../")) return void 0;
-      const fileExt = path12.extname(address);
-      const content = await fs5.readFile(address, "utf8");
+      const { url, encoding } = address;
+      if (!url.startsWith("file://")) return void 0;
+      const filepath = (0, import_url.fileURLToPath)(url);
+      const fileExt = path12.extname(filepath);
+      const content = await fs5.readFile(filepath, encoding);
+      const str = typeof content === "string" ? content : content.toString(encoding);
       if ([".yml", ".yaml"].includes(fileExt)) {
-        const value = yaml.load(content);
+        const value = yaml.load(str);
         return JSON.stringify(OpenapiUtils.to3_1(value));
       } else if (fileExt === ".json") {
-        return JSON.stringify(OpenapiUtils.to3_1(JSON.parse(content)));
+        return JSON.stringify(OpenapiUtils.to3_1(JSON.parse(str)));
       }
     });
   }
@@ -2644,7 +2686,11 @@ var ShakingPlugin = class _ShakingPlugin {
       sharkedSwagger,
       new ModuleDefinition(
         document.module.name,
-        `file://${document.module.name}.v3_1.sharked.json`
+        {
+          url: `memory://${document.module.name}.v3_1.sharked.json`,
+          headers: {},
+          encoding: "utf8"
+        }
       )
     );
   }