milkio 0.0.10 → 0.0.11

package/{scripts → scripts-del}/build-cookbook.ts

@@ -1,116 +1,116 @@
 /* eslint-disable no-console, @typescript-eslint/no-dynamic-delete */
 
-import { TSON, type Cookbook } from "..";
-import { join } from "node:path";
-import { cwd } from "node:process";
-import { writeFile, readFile } from "node:fs/promises";
+import { TSON, type Cookbook } from ".."
+import { join } from "node:path"
+import { cwd } from "node:process"
+import { writeFile, readFile } from "node:fs/promises"
 
 export async function buildCookbook() {
-  const schema = await import("../../../generate/api-schema");
-  const paths = Object.keys(schema.default.apiMethodsSchema);
+  const schema = await import("../../../generated/api-schema")
+  const paths = Object.keys(schema.default.apiMethodsSchema)
 
-  const cookbook: Cookbook = {};
+  const cookbook: Cookbook = {}
   for (const path of paths) {
     // const module = await import(/* @vite-ignore */ join(`../../../src/apps/${path}`));
-    const code = (await readFile(join(cwd(), `./src/apps/${path}.ts`))).toString();
-    const codeLines = code.split("\n");
-    let title;
-    let desc;
-    const descRaw = /\n\/\*\*\n[\s\S]+?\*\//.exec(code)?.[0] ?? "";
+    const code = (await readFile(join(cwd(), `./src/apps/${path}.ts`))).toString()
+    const codeLines = code.split("\n")
+    let title
+    let desc
+    const descRaw = /\n\/\*\*\n[\s\S]+?\*\//.exec(code)?.[0] ?? ""
 
     if (descRaw) {
-      const descRawLines = descRaw.split("\n");
-      if (descRawLines.at(0)?.trim() === "") descRawLines.shift();
-      if (descRawLines.at(-1)?.trim() === "") descRawLines.pop();
-      let first = true;
+      const descRawLines = descRaw.split("\n")
+      if (descRawLines.at(0)?.trim() === "") descRawLines.shift()
+      if (descRawLines.at(-1)?.trim() === "") descRawLines.pop()
+      let first = true
       for (let index = 0; index < descRawLines.length; index++) {
-        const descRawLine = descRawLines[index].replace(/^[/ ]+?[*]*/, "").replace(/[*]*\/$/, "");
+        const descRawLine = descRawLines[index].replace(/^[/ ]+?[*]*/, "").replace(/[*]*\/$/, "")
 
-        if (!descRawLine) continue;
+        if (!descRawLine) continue
         if (first) {
-          title = descRawLine.replace(/#/g, "").trim();
+          title = descRawLine.replace(/#/g, "").trim()
           // Originally the title was in the first line, desc is the rest of it, now desc contains complete markdown content.
           // continue;
         }
-        first = false;
-        desc = (desc ?? "") + "\n" + descRawLine.trim();
+        first = false
+        desc = (desc ?? "") + "\n" + descRawLine.trim()
       }
     }
 
-    let apiParams = /action\([\s\S]+?\)/.exec(code)?.[0] ?? ""; // The intention of the following code is to extract the parameter part of the action.
-    apiParams = /\([\s\S]*,/.exec(apiParams)?.[0] ?? "";
-    apiParams = apiParams.slice(0, -1);
-    apiParams = apiParams.slice(/[\s\S]+?:/.exec(apiParams)?.[0].length);
-    const apiParamsLines = apiParams.split("\n"); // The intention of the following code is to remove extra spaces, which will make the code look more beautiful.
-    if (apiParamsLines.at(-1)?.trim() === "") apiParamsLines.pop();
-    if (apiParamsLines.at(-1)?.trim() === "") apiParamsLines.pop();
-    let spaceNumber = 0;
+    let apiParams = /action\([\s\S]+?\)/.exec(code)?.[0] ?? "" // The intention of the following code is to extract the parameter part of the action.
+    apiParams = /\([\s\S]*,/.exec(apiParams)?.[0] ?? ""
+    apiParams = apiParams.slice(0, -1)
+    apiParams = apiParams.slice(/[\s\S]+?:/.exec(apiParams)?.[0].length)
+    const apiParamsLines = apiParams.split("\n") // The intention of the following code is to remove extra spaces, which will make the code look more beautiful.
+    if (apiParamsLines.at(-1)?.trim() === "") apiParamsLines.pop()
+    if (apiParamsLines.at(-1)?.trim() === "") apiParamsLines.pop()
+    let spaceNumber = 0
     for (const char of apiParamsLines.at(-1) ?? "") {
-      if (char === " ") spaceNumber++;
-      else break;
+      if (char === " ") spaceNumber++
+      else break
     }
     for (let index = 0; index < apiParamsLines.length; index++) {
-      const line = apiParamsLines[index];
-      let spaceNumberForThisLine = 0;
+      const line = apiParamsLines[index]
+      let spaceNumberForThisLine = 0
       for (const char of line) {
-        if (char === " ") spaceNumberForThisLine++;
-        else break;
+        if (char === " ") spaceNumberForThisLine++
+        else break
       }
       if (spaceNumberForThisLine >= spaceNumber) {
-        apiParamsLines[index] = line.slice(spaceNumber);
+        apiParamsLines[index] = line.slice(spaceNumber)
       } else {
-        apiParamsLines[index] = line.slice(spaceNumberForThisLine);
+        apiParamsLines[index] = line.slice(spaceNumberForThisLine)
       }
     }
-    apiParams = apiParamsLines.join("\n");
+    apiParams = apiParamsLines.join("\n")
 
     // Find the code for the API testing section.
-    const apiTestsCodeChars = [];
-    let apiTestsStartIndex = undefined as undefined | number;
-    let semicolonMatch = 0;
-    let semicolonMax = 0;
+    const apiTestsCodeChars = []
+    let apiTestsStartIndex = undefined as undefined | number
+    let semicolonMatch = 0
+    let semicolonMax = 0
     for (let index = 0; index < codeLines.length; index++) {
-      const codeLine = codeLines[index];
-      if (apiTestsStartIndex === undefined && !codeLine.includes("defineApiTest(")) continue;
-      if (apiTestsStartIndex === undefined) apiTestsStartIndex = index;
-      const codeChars = codeLine.split("");
+      const codeLine = codeLines[index]
+      if (apiTestsStartIndex === undefined && !codeLine.includes("defineApiTest(")) continue
+      if (apiTestsStartIndex === undefined) apiTestsStartIndex = index
+      const codeChars = codeLine.split("")
       for (const codeChar of codeChars) {
         if (codeChar === "[") {
-          semicolonMatch++;
-          semicolonMax++;
+          semicolonMatch++
+          semicolonMax++
         }
-        if (semicolonMatch !== 0) apiTestsCodeChars.push(codeChar);
-        if (codeChar === "]") semicolonMatch--;
+        if (semicolonMatch !== 0) apiTestsCodeChars.push(codeChar)
+        if (codeChar === "]") semicolonMatch--
       }
       if (semicolonMatch === 0 && semicolonMax >= 1) {
-        break;
+        break
       }
-      apiTestsCodeChars.push("\n");
+      apiTestsCodeChars.push("\n")
     }
 
     // Find the code for each API test case.
-    const apiCaseCodes: Array<string> = [];
-    let currentApiCaseCode = undefined as undefined | Array<string>;
-    let apiTestCaseStartIndex = undefined as undefined | number;
-    let apiTestCaseMatch = 0;
+    const apiCaseCodes: Array<string> = []
+    let currentApiCaseCode = undefined as undefined | Array<string>
+    let apiTestCaseStartIndex = undefined as undefined | number
+    let apiTestCaseMatch = 0
     for (let index = 0; index < apiTestsCodeChars.length; index++) {
-      const apiTestsCodeChar = apiTestsCodeChars[index];
+      const apiTestsCodeChar = apiTestsCodeChars[index]
       if (apiTestCaseStartIndex === undefined && apiTestsCodeChar === "{") {
-        currentApiCaseCode = [];
-        apiTestCaseStartIndex = index;
+        currentApiCaseCode = []
+        apiTestCaseStartIndex = index
       }
       if (apiTestsCodeChar === "{") {
-        apiTestCaseMatch++;
+        apiTestCaseMatch++
       }
 
-      if (apiTestCaseMatch !== 0) currentApiCaseCode!.push(apiTestsCodeChar);
+      if (apiTestCaseMatch !== 0) currentApiCaseCode!.push(apiTestsCodeChar)
 
       if (apiTestsCodeChar === "}") {
-        apiTestCaseMatch--;
+        apiTestCaseMatch--
         if (apiTestCaseMatch === 0) {
-          apiCaseCodes.push(currentApiCaseCode!.join(""));
-          currentApiCaseCode = undefined;
-          apiTestCaseStartIndex = undefined;
+          apiCaseCodes.push(currentApiCaseCode!.join(""))
+          currentApiCaseCode = undefined
+          apiTestCaseStartIndex = undefined
         }
       }
     }
@@ -118,60 +118,60 @@ export async function buildCookbook() {
     const apiCases: Array<{
       name: string;
       handler: string;
-    }> = [];
+    }> = []
 
     for (let index = 0; index < apiCaseCodes.length; index++) {
-      const code = apiCaseCodes[index];
-      const name = /name:[\s\S]+?,/.exec(code)?.[0]?.slice(5, -1)?.trim().slice(1, -1) ?? "";
-      const handlerChars = /handler:[\s\S]*/.exec(code)?.[0]?.split("") ?? [];
-      let handler = ""; // Find the main code of the handler.
-      let handlerStartIndex = undefined as undefined | number;
-      let handlerMatch = 0;
+      const code = apiCaseCodes[index]
+      const name = /name:[\s\S]+?,/.exec(code)?.[0]?.slice(5, -1)?.trim().slice(1, -1) ?? ""
+      const handlerChars = /handler:[\s\S]*/.exec(code)?.[0]?.split("") ?? []
+      let handler = "" // Find the main code of the handler.
+      let handlerStartIndex = undefined as undefined | number
+      let handlerMatch = 0
       for (let index = 0; index < handlerChars.length; index++) {
-        const handlerChar = handlerChars[index];
-        if (handlerStartIndex !== undefined && handlerChar === "{") handlerStartIndex = index;
-        if (handlerChar === "{") handlerMatch++;
-        if (handlerMatch !== 0) handler = handler + handlerChar;
-        if (handlerChar === "}") handlerMatch--;
-        if (handlerStartIndex !== undefined && handlerMatch === 0) break;
+        const handlerChar = handlerChars[index]
+        if (handlerStartIndex !== undefined && handlerChar === "{") handlerStartIndex = index
+        if (handlerChar === "{") handlerMatch++
+        if (handlerMatch !== 0) handler = handler + handlerChar
+        if (handlerChar === "}") handlerMatch--
+        if (handlerStartIndex !== undefined && handlerMatch === 0) break
       }
-      handler = handler.slice(1, -1);
-
-      const handlerLines = handler.split("\n"); // The intention of the following code is to remove extra spaces, which will make the code look more beautiful.
-      if (handlerLines.at(-1)?.trim() === "") handlerLines.pop();
-      if (handlerLines.at(-1)?.trim() === "") handlerLines.pop();
-      if (handlerLines.at(0)?.trim() === "") handlerLines.shift();
-      if (handlerLines.at(0)?.trim() === "") handlerLines.shift();
-      let spaceNumber = 0;
+      handler = handler.slice(1, -1)
+
+      const handlerLines = handler.split("\n") // The intention of the following code is to remove extra spaces, which will make the code look more beautiful.
+      if (handlerLines.at(-1)?.trim() === "") handlerLines.pop()
+      if (handlerLines.at(-1)?.trim() === "") handlerLines.pop()
+      if (handlerLines.at(0)?.trim() === "") handlerLines.shift()
+      if (handlerLines.at(0)?.trim() === "") handlerLines.shift()
+      let spaceNumber = 0
       for (const char of handlerLines.at(-1) ?? "") {
-        if (char === " ") spaceNumber++;
-        else break;
+        if (char === " ") spaceNumber++
+        else break
       }
       for (let index = 0; index < handlerLines.length; index++) {
-        const line = handlerLines[index];
-        let spaceNumberForThisLine = 0;
+        const line = handlerLines[index]
+        let spaceNumberForThisLine = 0
         for (const char of line) {
-          if (char === " ") spaceNumberForThisLine++;
-          else break;
+          if (char === " ") spaceNumberForThisLine++
+          else break
         }
         if (spaceNumberForThisLine >= spaceNumber) {
-          handlerLines[index] = line.slice(spaceNumber);
+          handlerLines[index] = line.slice(spaceNumber)
         } else {
-          handlerLines[index] = line.slice(spaceNumberForThisLine);
+          handlerLines[index] = line.slice(spaceNumberForThisLine)
         }
       }
-      handler = handlerLines.join("\n");
+      handler = handlerLines.join("\n")
 
       apiCases.push({
         name,
         handler
-      });
+      })
     }
 
     // This value has been deprecated because TypeScript types can already replace it well
     // let paramsSchema;
     // try {
-    //   const moduleGenerated = await import(/* @vite-ignore */ `../../../generate/products/apps/${path}`);
+    //   const moduleGenerated = await import(/* @vite-ignore */ `../../../generated/products/apps/${path}`);
     //   paramsSchema = moduleGenerated.paramsSchema.schemas[0]?.properties?.data;
     // } catch (error) {}
 
@@ -180,46 +180,46 @@ export async function buildCookbook() {
       desc,
       params: apiParams,
       cases: apiCases
-    };
+    }
   }
 
   /**
    * -- indexes
    */
 
-  const indexes: Record<string, Array<string>> = {};
-  const folderIndexes: Record<string, Array<string>> = {};
-  indexes["(root)"] = [];
-  folderIndexes["(root)"] = [];
+  const indexes: Record<string, Array<string>> = {}
+  const folderIndexes: Record<string, Array<string>> = {}
+  indexes["(root)"] = []
+  folderIndexes["(root)"] = []
   for (const path in cookbook) {
-    if (!path.includes("/")) indexes["(root)"].push(path);
+    if (!path.includes("/")) indexes["(root)"].push(path)
   }
   for (const path in cookbook) {
-    const dirnames = path.split("/");
+    const dirnames = path.split("/")
     for (let index = 0; index < dirnames.length - 1; index++) {
-      const dirpath = dirnames.slice(0, index + 1).join("/");
-      if (!indexes[dirpath]) indexes[dirpath] = [];
-      if (!folderIndexes[dirpath]) folderIndexes[dirpath] = [];
+      const dirpath = dirnames.slice(0, index + 1).join("/")
+      if (!indexes[dirpath]) indexes[dirpath] = []
+      if (!folderIndexes[dirpath]) folderIndexes[dirpath] = []
       if (index + 1 === dirnames.length - 1) {
-        indexes[dirpath].push(path);
+        indexes[dirpath].push(path)
       } else {
-        const childDirpath = dirnames.slice(0, index + 2).join("/");
-        if (folderIndexes[dirpath].includes(childDirpath)) continue;
-        folderIndexes[dirpath].push(childDirpath);
+        const childDirpath = dirnames.slice(0, index + 2).join("/")
+        if (folderIndexes[dirpath].includes(childDirpath)) continue
+        folderIndexes[dirpath].push(childDirpath)
       }
     }
   }
   for (const path in folderIndexes) {
-    if (path.includes("/") || path === "(root)") continue;
-    folderIndexes["(root)"].push(path);
+    if (path.includes("/") || path === "(root)") continue
+    folderIndexes["(root)"].push(path)
   }
 
-  const readme = (await readFile(join(cwd(), "src", "apps", "README.md"))).toString();
-  Object.keys(indexes).forEach((key) => indexes[key].length === 0 && delete indexes[key]);
-  const generatedAt = new Date();
+  const readme = (await readFile(join(cwd(), "src", "apps", "README.md"))).toString()
+  Object.keys(indexes).forEach((key) => indexes[key].length === 0 && delete indexes[key])
+  const generatedAt = new Date()
 
   await writeFile(
-    join(cwd(), `./generate/cookbook.json`),
+    join(cwd(), `./generated/cookbook.json`),
     TSON.stringify({
       cookbook,
       readme,
@@ -227,7 +227,7 @@ export async function buildCookbook() {
       folderIndexes,
       generatedAt
     })
-  );
+  )
 }
 
-void buildCookbook();
+void buildCookbook()

package/scripts-del/build-dto.ts

@@ -0,0 +1,65 @@
+/* eslint-disable no-console */
+import { cwd, platform } from "node:process"
+import { exec as nodeExec } from "node:child_process"
+import { removeDir } from "../utils/remove-dir"
+import { join } from "node:path"
+import { copyFile, mkdir } from "node:fs/promises"
+
+export async function buildDTO() {
+  console.log("🥛 Milkio DTO Building..")
+
+  removeDir(join(cwd(), "packages", "dto", "dist"))
+  removeDir(join(cwd(), "packages", "dto", "generated"))
+  await mkdir(join(cwd(), "packages", "dto", "dist"))
+  await mkdir(join(cwd(), "packages", "dto", "generated"))
+
+  // Generate the corresponding types for the files in the project and output them to the /packages/dto/generate directory.
+  await new Promise((resolve) =>
+    nodeExec("bun ./node_modules/typescript/bin/tsc --project tsconfig.build-dto.json", (e, stdout) => {
+      resolve(e)
+    })
+  )
+  await copyFile(join(cwd(), "src", "fail-code.ts"), join(cwd(), "packages", "dto", "generated", "src", "fail-code.ts"))
+
+  // Packaging type for the dto
+  await new Promise((resolve) =>
+    nodeExec("cd ./packages/dto && bunx tsc", (e) => {
+      resolve(e)
+    })
+  )
+
+  // build /src/dto/index.ts to js
+  await Bun.build({
+    entrypoints: ["./packages/dto/index.ts"],
+    outdir: "./packages/dto"
+  })
+
+  const root = join(cwd(), "packages", "dto")
+
+  console.log("🥛 Milkio DTO Build Finished")
+  console.log("\x1B[2m")
+  console.log("Now, your latest code (including changes to your interface) is built to the latest version and waiting for your release!")
+  console.log("")
+  console.log("If you want to publish it to NPM, you can use a command similar to the following.")
+  console.log(`(But before that, you may need to modify the package name (${join(cwd(), "packages", "dto", "package.json")}) and login to your NPM account or private NPM repository)`)
+
+  if (platform !== "win32") {
+    console.log("You can publish it to npm by running this commands:\n")
+    console.log("\u001B[0m---")
+    console.log(`cd ${join(root)} \\`)
+    console.log("  && npm version major \\")
+    console.log("  && npm publish --access public \\")
+    console.log(`  && cd ${join(cwd())}`)
+  } else {
+    console.log("You can publish it to npm by running this commands (use \x1B[42mPowerShell\x1B[0m):")
+    console.log("\u001B[0m---")
+    console.log('$ErrorActionPreference = "Stop";')
+    console.log(`Set-Location ${join(root)};`)
+    console.log("npm version major;")
+    console.log("npm publish --access public;")
+    console.log(`Set-Location ${join(cwd())};`)
+  }
+  console.log("---")
+}
+
+await buildDTO()

package/{scripts → scripts-del}/generate/generate-app-partial.ts

@@ -1,56 +1,56 @@
 /* eslint-disable no-console */
 
-import ejs from "ejs";
-import { join } from "node:path";
-import { existsSync, mkdirSync } from "node:fs";
-import { cwd, env, exit } from "node:process";
-import { writeFile, readFile } from "node:fs/promises";
-import { exec as nodeExec } from "node:child_process";
-import { camel, hump, hyphen } from "@poech/camel-hump-under";
+import ejs from "ejs"
+import { join } from "node:path"
+import { existsSync, mkdirSync } from "node:fs"
+import { cwd, env, exit } from "node:process"
+import { writeFile, readFile } from "node:fs/promises"
+import { exec as nodeExec } from "node:child_process"
+import { camel, hump, hyphen } from "@poech/camel-hump-under"
 
 const utils = {
   camel: (str: string) => camel(str).replaceAll("-", "").replaceAll("_", ""),
   hump: (str: string) => hump(str).replaceAll("-", "").replaceAll("_", ""),
   hyphen: (str: string) => hyphen(str).replaceAll("_", "")
-};
+}
 
 export async function generateAppPartial(path?: string) {
-  const partialPath = path ?? env.GENERATE_PARTIAL_PATH!;
-  const partialDir = partialPath.split("/").slice(0, -1).join("/");
+  const partialPath = path ?? env.GENERATE_PARTIAL_PATH!
+  const partialDir = partialPath.split("/").slice(0, -1).join("/")
   // Generate api-schema.ts file through templates
   const templateVars = {
     utils
-  };
+  }
 
-  if (!partialPath.endsWith(".ts")) return;
-  const module = await import(/* @vite-ignore */ `../../../../src/apps/${partialPath}`);
+  if (!partialPath.endsWith(".ts")) return
+  const module = await import(/* @vite-ignore */ `../../../../src/apps/${partialPath}`)
   if (module?.api?.isApi === true) {
     // Exclude disallowed characters
     if (partialPath.includes("_")) {
-      console.error(`\n\nPath: ` + partialPath);
-      console.error(`Do not use "_" in the path. If you want to add a separator between words, please use "-".\n`);
-      exit(1);
+      console.error(`\n\nPath: ` + partialPath)
+      console.error(`Do not use "_" in the path. If you want to add a separator between words, please use "-".\n`)
+      exit(1)
     }
     if (/^[a-z0-9/-]+$/.test(partialPath)) {
-      console.error(`\n\nPath: ` + partialPath);
-      console.error(`The path can only contain lowercase letters, numbers, and "-".\n`);
-      exit(1);
+      console.error(`\n\nPath: ` + partialPath)
+      console.error(`The path can only contain lowercase letters, numbers, and "-".\n`)
+      exit(1)
     }
   }
 
   // typia
-  const filePathTmp = join(cwd(), "generate", "raw-tmp", "apps", partialPath);
-  const dirPathTmp = join(cwd(), "generate", "raw-tmp", "apps", partialPath).split("/").slice(0, -1).join("/");
-  const filePath = join(cwd(), "generate", "raw", "apps", partialPath);
+  const filePathTmp = join(cwd(), "generated", "raw-tmp", "apps", partialPath)
+  const dirPathTmp = join(cwd(), "generated", "raw-tmp", "apps", partialPath).split("/").slice(0, -1).join("/")
+  const filePath = join(cwd(), "generated", "raw", "apps", partialPath)
   if (!existsSync(dirPathTmp)) {
-    mkdirSync(dirPathTmp, { recursive: true });
+    mkdirSync(dirPathTmp, { recursive: true })
   }
-  let importPath = "../../../";
+  let importPath = "../../../"
 
   for (let i = 0; i < partialPath.split("/").length - 1; i++) {
-    importPath = importPath + "../";
+    importPath = importPath + "../"
   }
-  importPath = importPath + "src/apps";
+  importPath = importPath + "src/apps"
   const template = `
 import typia from "typia";
 import { _validate, type ExecuteResultSuccess } from "milkio";
@@ -61,14 +61,14 @@ type ParamsT = Parameters<typeof <%= utils.camel(path.replaceAll('/', '$').slice
 export const params = async (params: any) => typia.misc.validatePrune<ParamsT>(params);
 type ResultsT = Awaited<ReturnType<typeof <%= utils.camel(path.replaceAll('/', '$').slice(0, -${3})) %>['api']['action']>>;
 export const results = async (results: any) => { _validate(typia.validate<TSONEncode<ExecuteResultSuccess<ResultsT>>>(results)); return typia.json.stringify<TSONEncode<ExecuteResultSuccess<ResultsT>>>(results); };
-`.trim();
+`.trim()
 
-  await writeFile(filePathTmp, ejs.render(template, { ...templateVars, path: partialPath }));
+  await writeFile(filePathTmp, ejs.render(template, { ...templateVars, path: partialPath }))
 
   await new Promise((resolve) =>
     nodeExec(`bun run ./node_modules/typia/lib/executable/typia.js generate --input generate/raw-tmp/apps/${partialDir} --output generate/products-tmp/apps/${partialDir} --project tsconfig.json`, (e) => {
-      resolve(e);
+      resolve(e)
     })
-  );
-  await Promise.all([writeFile(filePath, ejs.render(template, { ...templateVars, path: partialPath })), writeFile(join(cwd(), "generate", "products", "apps", partialPath), (await readFile(join(cwd(), "generate", "products-tmp", "apps", partialPath))).toString())]);
+  )
+  await Promise.all([writeFile(filePath, ejs.render(template, { ...templateVars, path: partialPath })), writeFile(join(cwd(), "generated", "products", "apps", partialPath), (await readFile(join(cwd(), "generated", "products-tmp", "apps", partialPath))).toString())])
 }