milkio 0.1.2 → 0.2.1

package/scripts/gen-significant.ts

@@ -1,94 +1,90 @@
-/* eslint-disable no-console */
-
-import ejs from "ejs"
-import { join } from "node:path"
-import { existsSync, mkdirSync } from "node:fs"
-import { cwd, exit } from "node:process"
-import { unlink, writeFile } from "node:fs/promises"
-import { camel, hyphen } from "@poech/camel-hump-under"
-import { $, Glob } from "bun"
-import { MilkioConfig } from ".."
+import ejs from "ejs";
+import { join } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import { cwd, exit } from "node:process";
+import { unlink, writeFile } from "node:fs/promises";
+import { camel, hyphen } from "@poech/camel-hump-under";
+import { $, Glob } from "bun";
+import type { MilkioConfig } from "..";
 
 export default async () => {
-  // Delete the files generated in the past and regenerate them
-  try {
-    await unlink(join(cwd(), "generated", "api-schema.ts"))
-  } catch (error) { } // Maybe the file does not exist
-
-  // Make sure that the existing directories are all present
-  existsSync(join("generated")) || mkdirSync(join("generated"))
-  existsSync(join("generated", "raw")) || mkdirSync(join("generated", "raw"))
-  existsSync(join("generated", "raw", "apps")) || mkdirSync(join("generated", "raw", "apps"))
-
-  if (!existsSync(join("generated", "README.md"))) {
-    await writeFile(join("generated", "README.md"), "⚠️ All files in this directory are generated by milkio. Please do not modify the content, otherwise your modifications will be overwritten in the next generation.")
-  }
-
-  const utils = {
-    camel: (str: string) => camel(str).replaceAll("-", "").replaceAll("_", ""),
-    hyphen: (str: string) => hyphen(str).replaceAll("_", "")
-  }
-
-  // Write a basic framework to ensure that there are no errors when reading later
-  const apiSchemaSkeleton = `
+	// Delete the files generated in the past and regenerate them
+	try {
+		await unlink(join(cwd(), "generated", "api-schema.ts"));
+	} catch (error) {} // Maybe the file does not exist
+
+	// Make sure that the existing directories are all present
+	existsSync(join("generated")) || mkdirSync(join("generated"));
+	existsSync(join("generated", "raw")) || mkdirSync(join("generated", "raw"));
+	existsSync(join("generated", "raw", "apps")) || mkdirSync(join("generated", "raw", "apps"));
+
+	if (!existsSync(join("generated", "README.md"))) {
+		await writeFile(join("generated", "README.md"), "⚠️ All files in this directory are generated by milkio. Please do not modify the content, otherwise your modifications will be overwritten in the next generation.");
+	}
+
+	const utils = {
+		camel: (str: string) => camel(str).replaceAll("-", "").replaceAll("_", ""),
+		hyphen: (str: string) => hyphen(str).replaceAll("_", ""),
+	};
+
+	// Write a basic framework to ensure that there are no errors when reading later
+	const apiSchemaSkeleton = `
   export default {
     apiValidator: {},
     apiMethodsSchema: {},
     apiMethodsTypeSchema: {},
   }
-  `
-  await writeFile(join(cwd(), "generated", "api-schema.ts"), ejs.render(apiSchemaSkeleton, { utils }))
-
-  // Generate api-schema.ts file through templates
-  const templateVars = {
-    utils,
-    apiPaths: [] as Array<string>,
-    apiTestPaths: [] as Array<string>
-  }
-
-  const glob = new Glob("**/*.ts")
-  const appFiles = await Array.fromAsync(glob.scan({ cwd: join(cwd(), "src", "apps") }))
-
-
-  console.time(`File Stage`)
-  
-
-  for (const path of appFiles) {
-    if (!path.endsWith(".ts")) continue
-    const module = await import(/* @vite-ignore */ join(cwd(), "src", "apps", path))
-    
-    if (module?.api?.isApi === true) {
-      // Exclude disallowed characters
-      if (path.includes("_")) {
-        console.error(`\n\nPath: ` + `"${path.slice(0, -3)}"`)
-        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(path.slice(0, -3))) {
-        console.error(`\n\nPath: ` + `"${path.slice(0, -3)}"`)
-        console.error(`The path can only contain lowercase letters, numbers, and "-".\n`)
-        exit(1)
-      }
-
-      templateVars.apiPaths.push(path)
-
-      if (module?.test?.isApiTest === true) {
-        templateVars.apiTestPaths.push(path)
-      }
-
-      // typia
-      const filePath = join(cwd(), "generated", "raw", "apps", path)
-      const dirPath = join(cwd(), "generated", "raw", "apps", path).split("/").slice(0, -1).join("/")
-      if (!existsSync(dirPath)) {
-        mkdirSync(dirPath, { recursive: true })
-      }
-      let importPath = "../../../"
-
-      for (let i = 0; i < path.split("/").length - 1; i++) {
-        importPath = importPath + "../"
-      }
-      importPath = importPath + "src/apps"
-      const template = `
+  `;
+	await writeFile(join(cwd(), "generated", "api-schema.ts"), ejs.render(apiSchemaSkeleton, { utils }));
+
+	// Generate api-schema.ts file through templates
+	const templateVars = {
+		utils,
+		apiPaths: [] as Array<string>,
+		apiTestPaths: [] as Array<string>,
+	};
+
+	const glob = new Glob("**/*.ts");
+	const appFiles = await Array.fromAsync(glob.scan({ cwd: join(cwd(), "src", "apps") }));
+
+	console.time(`File Stage`);
+
+	for (const path of appFiles) {
+		if (!path.endsWith(".ts")) continue;
+		const module = await import(/* @vite-ignore */ join(cwd(), "src", "apps", path));
+
+		if (module?.api?.isApi === true) {
+			// Exclude disallowed characters
+			if (path.includes("_")) {
+				console.error(`\n\nPath: "${path.slice(0, -3)}"`);
+				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(path.slice(0, -3))) {
+				console.error(`\n\nPath: "${path.slice(0, -3)}"`);
+				console.error(`The path can only contain lowercase letters, numbers, and "-".\n`);
+				exit(1);
+			}
+
+			templateVars.apiPaths.push(path);
+
+			if (module?.test?.isApiTest === true) {
+				templateVars.apiTestPaths.push(path);
+			}
+
+			// typia
+			const filePath = join(cwd(), "generated", "raw", "apps", path);
+			const dirPath = join(cwd(), "generated", "raw", "apps", path).split("/").slice(0, -1).join("/");
+			if (!existsSync(dirPath)) {
+				mkdirSync(dirPath, { recursive: true });
+			}
+			let importPath = "../../../";
+
+			for (let i = 0; i < path.split("/").length - 1; i++) {
+				importPath = `${importPath}../`;
+			}
+			importPath = `${importPath}src/apps`;
+			const template = `
 import typia from "typia";
 import { _validate, type ExecuteResultFail, type ExecuteResultSuccess } from "milkio";
 import { type TSONEncode } from "@southern-aurora/tson";
@@ -99,17 +95,17 @@ export const validateParams = async (params: any) => typia.misc.validatePrune<Pa
 type ResultsT = Awaited<ReturnType<typeof <%= utils.camel(path.replaceAll('/', '$').slice(0, -${3})) %>['api']['action']>>;
 export const validateResults = async (results: any) => { _validate(typia.validate<TSONEncode<ExecuteResultSuccess<ResultsT> | ExecuteResultFail>>(results)); return typia.json.stringify<TSONEncode<ExecuteResultSuccess<ResultsT> | ExecuteResultFail>>(results); };
 export const randParams = async () => typia.random<ParamsT>();
-`.trim()
-      // export const paramsSchema = typia.json.application<[{ data: ParamsT }], "swagger">();
+`.trim();
+			// export const paramsSchema = typia.json.application<[{ data: ParamsT }], "swagger">();
 
-      await writeFile(filePath, ejs.render(template, { ...templateVars, path }))
-    }
-  }
+			await writeFile(filePath, ejs.render(template, { ...templateVars, path }));
+		}
+	}
 
-  await writeFile(
-    join(cwd(), "generated", "api-schema.ts"),
-    ejs.render(
-      `
+	await writeFile(
+		join(cwd(), "generated", "api-schema.ts"),
+		ejs.render(
+			`
 /**
  * ⚠️ This file is generated and modifications will be overwritten
  */
@@ -135,12 +131,12 @@ export default {
   },
 }
  `.trim(),
-      templateVars
-    )
-  )
-  
-  // api
-  const apiValidatorTemplate = `/**
+			templateVars,
+		),
+	);
+
+	// api
+	const apiValidatorTemplate = `/**
  * ⚠️This file is generated and modifications will be overwritten
  */
 
@@ -151,26 +147,26 @@ export default {
     <% } %>
   },
 }
-`.trim()
-  await writeFile(join(cwd(), "generated", "raw", "api-validator.ts"), ejs.render(apiValidatorTemplate, templateVars))
-  
-  console.timeEnd(`File Stage`)
-  console.log(``)
-
-  // typia
-  console.time(`Typia Stage`)
-  await $`bun run ./node_modules/typia/lib/executable/typia.js generate --input generated/raw --output generated/products --project tsconfig.json`
-  console.timeEnd(`Typia Stage`)
-  console.log(``)
-
-  if (!existsSync(join(cwd(), "milkio.toml"))) return
-  const milkioConfig = (await import(join(cwd(), "milkio.toml"))).default as MilkioConfig
-  if (!milkioConfig?.generate?.significant) return
-  let i = 0
-  for (const command of milkioConfig.generate.significant) {
-    ++i
-    console.time(`Significant Stage (LINE ${i})`)
-    await $`${{ raw: command }}`
-    console.timeEnd(`Significant Stage (LINE ${i})`)
-  }
-}
+`.trim();
+	await writeFile(join(cwd(), "generated", "raw", "api-validator.ts"), ejs.render(apiValidatorTemplate, templateVars));
+
+	console.timeEnd(`File Stage`);
+	console.log(``);
+
+	// typia
+	console.time(`Typia Stage`);
+	await $`bun run ./node_modules/typia/lib/executable/typia.js generate --input generated/raw --output generated/products --project tsconfig.json`;
+	console.timeEnd(`Typia Stage`);
+	console.log(``);
+
+	if (!existsSync(join(cwd(), "milkio.toml"))) return;
+	const milkioConfig = (await import(join(cwd(), "milkio.toml"))).default as MilkioConfig;
+	if (!milkioConfig?.generate?.significant) return;
+	let i = 0;
+	for (const command of milkioConfig.generate.significant) {
+		++i;
+		console.time(`Significant Stage (LINE ${i})`);
+		await $`${{ raw: command }}`;
+		console.timeEnd(`Significant Stage (LINE ${i})`);
+	}
+};

package/types.ts

@@ -1,50 +1,48 @@
-/* eslint-disable @typescript-eslint/ban-types, @typescript-eslint/no-explicit-any */
+import type { createMilkioApp } from ".";
+import type { failCode } from "../../src/fail-code";
 
-import { type createMilkioApp } from "."
-import type { failCode } from "../../src/fail-code"
+export type MilkioApp = Awaited<ReturnType<typeof createMilkioApp>>;
 
-export type MilkioApp = Awaited<ReturnType<typeof createMilkioApp>>
+export type ExecuteId = string | "global";
 
-export type ExecuteId = string | "global"
+export type FailEnumerates = typeof failCode;
 
-export type FailEnumerates = typeof failCode
+export type HttpRequest = Request;
 
-export type HTTPRequest = Request
-
-export type HTTPResponse = Override<ResponseInit & { body: string | null | undefined }, { headers: NonNullable<ResponseInit["headers"]> }>
+export type HttpResponse = Override<ResponseInit & { body: string | null | undefined }, { headers: NonNullable<ResponseInit["headers"]> }>;
 
 export type Fail<FailCode extends keyof FailEnumerates> = {
-  code: FailCode
-  message: string
-  data: Parameters<FailEnumerates[FailCode]>[0]
-}
+	code: FailCode;
+	message: string;
+	data: Parameters<FailEnumerates[FailCode]>[0];
+};
 
 export type MilkioMeta = {
-  //
-}
+	//
+};
 
-export type Cookbook = Record<string, CookbookItem>
+export type Cookbook = Record<string, CookbookItem>;
 
 export type CookbookItem = {
-  title?: string;
-  desc?: string;
-  params: string;
-  cases: Array<{
-    name: string;
-    handler: string;
-  }>
-}
+	title?: string;
+	desc?: string;
+	params: string;
+	cases: Array<{
+		name: string;
+		handler: string;
+	}>;
+};
 
-export type Override<P, S> = Omit<P, keyof S> & S
+export type Override<P, S> = Omit<P, keyof S> & S;
 
-export type Mixin<T, U> = U & Omit<T, keyof U>
+export type Mixin<T, U> = U & Omit<T, keyof U>;
 
 export type MilkioConfig = {
-  generate?: {
-    significant?: Array<string>;
-    insignificant?: Array<string>;
-  },
-  menubar?: {
-    commands?: Array<{ name?: string, script?: string, icon?: string }>;
-  }
-};
+	generate?: {
+		significant?: Array<string>;
+		insignificant?: Array<string>;
+	};
+	menubar?: {
+		commands?: Array<{ name?: string; script?: string; icon?: string }>;
+	};
+};

package/utils/create-ulid.ts

@@ -1,5 +1,5 @@
-import { monotonicFactory } from "ulidx"
+import { monotonicFactory } from "ulidx";
 
-const ulid = monotonicFactory()
+const ulid = monotonicFactory();
 
-export const createUlid = () => ulid()
+export const createUlid = () => ulid();

package/utils/env-to-boolean.ts

@@ -1,11 +1,11 @@
 export function envToBoolean(value: string | number | undefined, defaultValue: boolean) {
-  if (value === "true") return true
+	if (value === "true") return true;
 
-  if (value === "false") return false
+	if (value === "false") return false;
 
-  if (value === "") return false
+	if (value === "") return false;
 
-  if (undefined === value) return defaultValue
+	if (undefined === value) return defaultValue;
 
-  return Boolean(value)
+	return Boolean(value);
 }

package/utils/env-to-number.ts

@@ -1,5 +1,5 @@
 export function envToNumber(value: string | undefined, defaultValue: number) {
-  if (value === undefined) return defaultValue
+	if (value === undefined) return defaultValue;
 
-  return Number.parseInt(value, 10)
+	return Number.parseInt(value, 10);
 }

package/utils/env-to-string.ts

@@ -1,5 +1,5 @@
 export function envToString(value: string | number | undefined, defaultValue: string) {
-  if (value === undefined) return defaultValue
+	if (value === undefined) return defaultValue;
 
-  return `${value}`
+	return `${value}`;
 }

package/utils/exec.ts

@@ -1,4 +1,4 @@
-import { env, type SpawnOptions } from "bun"
+import { env, type SpawnOptions } from "bun";
 
 /**
  * This is a legacy wrapper that was written before $ Shell was created.
@@ -6,22 +6,22 @@ import { env, type SpawnOptions } from "bun"
  */
 
 export const exec = async (cwd: string, command: Array<string>, options: Partial<SpawnOptions.OptionsObject> = {}) => {
-  return new Promise((resolve, reject) => {
-    if (!("cwd" in options)) options.cwd = cwd
-    if (!("stdin" in options)) options.stdin = "inherit"
-    if (!("stdout" in options)) options.stdout = "inherit"
-    if (!("env" in options)) options.env = { ...env }
+	return new Promise((resolve, reject) => {
+		if (!("cwd" in options)) options.cwd = cwd;
+		if (!("stdin" in options)) options.stdin = "inherit";
+		if (!("stdout" in options)) options.stdout = "inherit";
+		if (!("env" in options)) options.env = { ...env };
 
-    options.onExit = (proc, exitCode, signalCode, error) => {
-      // eslint-disable-next-line prefer-promise-reject-errors
-      if (exitCode !== 0) reject({ proc, exitCode, signalCode, error })
-      else resolve({ proc, exitCode, signalCode, error })
-    }
+		options.onExit = (proc, exitCode, signalCode, error) => {
+			// eslint-disable-next-line prefer-promise-reject-errors
+			if (exitCode !== 0) reject({ proc, exitCode, signalCode, error });
+			else resolve({ proc, exitCode, signalCode, error });
+		};
 
-    try {
-      Bun.spawn(command, options)
-    } catch (error) {
-      reject(error)
-    }
-  })
-}
+		try {
+			Bun.spawn(command, options);
+		} catch (error) {
+			reject(error);
+		}
+	});
+};

package/utils/handle-catch-error.ts

@@ -1,45 +1,45 @@
-import { failCode } from "../../../src/fail-code"
-import { useLogger, type ExecuteId, type ExecuteResult } from ".."
-import { configMilkio } from "../../../src/config/milkio"
+import { failCode } from "../../../src/fail-code";
+import { useLogger, type ExecuteId, type ExecuteResult } from "..";
+import { configMilkio } from "../../../src/config/milkio";
 
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export function hanldeCatchError(error: any, executeId: ExecuteId): ExecuteResult<any> {
-  const logger = useLogger(executeId)
+	const logger = useLogger(executeId);
 
-  if (configMilkio.debug === true) {
-    logger.error("\nError Data: " + JSON.stringify(error))
-    if (error.stack) logger.error("\nError Stack: ", error.stack)
-    else logger.error("\nError Stack: ", error)
-  }
+	if (configMilkio.debug === true) {
+		logger.error(`\nError Data: ${JSON.stringify(error)}`);
+		if (error.stack) logger.error("\nError Stack: ", error.stack);
+		else logger.error("\nError Stack: ", error);
+	}
 
-  if (error.name !== "MilkioReject") {
-    if (configMilkio.debug === true) {
-      // If it is not MilkioReject, it is considered an internal server error that should not be exposed
-      logger.error(`FailCode: INTERNAL_SERVER_ERROR`)
-    }
+	if (error.name !== "MilkioReject") {
+		if (configMilkio.debug === true) {
+			// If it is not MilkioReject, it is considered an internal server error that should not be exposed
+			logger.error(`FailCode: INTERNAL_SERVER_ERROR`);
+		}
 
-    return {
-      executeId,
-      success: false,
-      fail: {
-        code: "INTERNAL_SERVER_ERROR",
-        message: failCode.INTERNAL_SERVER_ERROR(),
-        data: undefined
-      }
-    }
-  } else {
-    if (configMilkio.debug === true) {
-      logger.error(`FailCode: ${error.code}`)
-    }
+		return {
+			executeId,
+			success: false,
+			fail: {
+				code: "INTERNAL_SERVER_ERROR",
+				message: failCode.INTERNAL_SERVER_ERROR(),
+				data: undefined,
+			},
+		};
+	}
 
-    return {
-      executeId,
-      success: false,
-      fail: {
-        code: error.code,
-        message: error.message,
-        data: error.data
-      }
-    }
-  }
+	if (configMilkio.debug === true) {
+		logger.error(`FailCode: ${error.code}`);
+	}
+
+	return {
+		executeId,
+		success: false,
+		fail: {
+			code: error.code,
+			message: error.message,
+			data: error.data,
+		},
+	};
 }

package/utils/header-to-plain-object.ts

@@ -1,8 +1,8 @@
 export const headerToPlainObject = (headers: Headers) => {
-  if (headers.toJSON) return headers.toJSON()
-  const plainHeaders: Record<string, string> = {}
-  headers.forEach((value, key) => {
-    plainHeaders[key] = value
-  })
-  return headers
-}
+	if (headers.toJSON) return headers.toJSON();
+	const plainHeaders: Record<string, string> = {};
+	headers.forEach((value, key) => {
+		plainHeaders[key] = value;
+	});
+	return headers;
+};

package/utils/remove-dir.ts

@@ -1,22 +1,22 @@
-import { existsSync, lstatSync, readdirSync, rmdirSync, unlinkSync } from "node:fs"
-import path from "node:path"
+import { existsSync, lstatSync, readdirSync, rmdirSync, unlinkSync } from "node:fs";
+import path from "node:path";
 
 export function removeDir(pathstr: string, skips: Array<string> = []) {
-  if (!existsSync(pathstr)) return
-  const files = readdirSync(pathstr)
-  files.forEach((file) => {
-    const dirname = path.resolve(pathstr, file)
-    const stats = lstatSync(dirname)
-    for (const skip of skips) {
-      if (dirname.startsWith(skip)) return
-    }
-    if (stats.isDirectory()) {
-      removeDir(dirname)
-    } else {
-      unlinkSync(dirname)
-    }
-  })
-  try {
-    rmdirSync(pathstr)
-  } catch (error) {}
+	if (!existsSync(pathstr)) return;
+	const files = readdirSync(pathstr);
+	files.forEach((file) => {
+		const dirname = path.resolve(pathstr, file);
+		const stats = lstatSync(dirname);
+		for (const skip of skips) {
+			if (dirname.startsWith(skip)) return;
+		}
+		if (stats.isDirectory()) {
+			removeDir(dirname);
+		} else {
+			unlinkSync(dirname);
+		}
+	});
+	try {
+		rmdirSync(pathstr);
+	} catch (error) {}
 }

package/utils/tson.ts

@@ -1,3 +1,3 @@
-import { TSON as _TSON } from "@southern-aurora/tson"
+import { TSON as _TSON } from "@southern-aurora/tson";
 
-export const TSON = _TSON
+export const TSON = _TSON;

package/.co.toml

@@ -1,2 +0,0 @@
-["general"]
-includes = ["co:bun"]