milkio 0.0.1

package/scripts/generate/generate-app-partial.ts

@@ -0,0 +1,74 @@
+/* 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";
+
+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("/");
+  // 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 (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);
+    }
+    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);
+    }
+  }
+
+  // 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);
+  if (!existsSync(dirPathTmp)) {
+    mkdirSync(dirPathTmp, { recursive: true });
+  }
+  let importPath = "../../../";
+
+  for (let i = 0; i < partialPath.split("/").length - 1; i++) {
+    importPath = importPath + "../";
+  }
+  importPath = importPath + "src/apps";
+  const template = `
+import typia from "typia";
+import { _validate, type ExecuteResultSuccess } from "loongbao";
+import { type TSONEncode } from "@southern-aurora/tson";
+import type * as <%= utils.camel(path.slice(0, -3).replaceAll('/', '$')) %> from '${importPath}/<%= path.slice(0, -3) %>';
+
+type ParamsT = Parameters<typeof <%= utils.camel(path.replaceAll('/', '$').slice(0, -${3})) %>['api']['action']>[0];
+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();
+
+  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);
+    })
+  );
+  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())]);
+}

package/scripts/generate/generate-app.ts

@@ -0,0 +1,153 @@
+/* eslint-disable no-console */
+
+import ejs from "ejs";
+import { join } from "node:path";
+import walkSync from "walk-sync";
+import { existsSync, mkdirSync } from "node:fs";
+import { cwd, exit } from "node:process";
+import { unlink, writeFile } from "node:fs/promises";
+import { exec as nodeExec } from "node:child_process";
+import { camel, hyphen } from "@poech/camel-hump-under";
+
+const utils = {
+  camel: (str: string) => camel(str).replaceAll("-", "").replaceAll("_", ""),
+  hyphen: (str: string) => hyphen(str).replaceAll("_", "")
+};
+
+export async function generateApp() {
+  // Delete the files generated in the past and regenerate them
+  try {
+    await unlink(join(cwd(), "generate", "api-schema.ts"));
+  } catch (error) {} // Maybe the file does not exist
+
+  if (!existsSync(join("generate", "README.md"))) {
+    await writeFile(join("generate", "README.md"), "⚠️ All files in this directory are generated by Loongbao. Please do not modify the content, otherwise your modifications will be overwritten in the next generation.");
+  }
+
+  // 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(), "generate", "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 appFiles = walkSync(join(cwd(), "src", "apps"), {
+    directories: false
+  });
+
+  for (const path of appFiles) {
+    if (!path.endsWith(".ts")) continue;
+    const module = await import(/* @vite-ignore */ `../../../../src/apps/${path}`);
+    if (module?.api?.isApi === true) {
+      // Exclude disallowed characters
+      if (path.includes("_")) {
+        console.error(`\n\nPath: ` + `"${path}"`);
+        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}"`);
+        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(), "generate", "raw", "apps", path);
+      const dirPath = join(cwd(), "generate", "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 ExecuteResultSuccess } from "loongbao";
+import { type TSONEncode } from "@southern-aurora/tson";
+import type * as <%= utils.camel(path.slice(0, -3).replaceAll('/', '$')) %> from '${importPath}/<%= path.slice(0, -3) %>';
+
+type ParamsT = Parameters<typeof <%= utils.camel(path.replaceAll('/', '$').slice(0, -${3})) %>['api']['action']>[0];
+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();
+      // export const paramsSchema = typia.json.application<[{ data: ParamsT }], "swagger">();
+
+      await writeFile(filePath, ejs.render(template, { ...templateVars, path }));
+    }
+  }
+
+  await writeFile(
+    join(cwd(), "generate", "api-schema.ts"),
+    ejs.render(
+      `
+/**
+ * ⚠️ This file is generated and modifications will be overwritten
+ */
+
+// api
+<% for (const path of ${"apiPaths"}) { %>import type * as <%= utils.camel(path.slice(0, -3).replaceAll('/', '$')) %> from '${"../src/apps"}/<%= path.slice(0, -3) %>'
+<% } %>
+import _apiValidator from './products/api-validator.ts'
+
+export default {
+  apiValidator: _apiValidator,
+  ${"apiMethodsSchema"}: {
+    <% for (const path of apiPaths) { %>'<%= utils.hyphen(path.slice(0, -${3})) %>': () => ({ module: import('../src/apps/<%= path.slice(0, -${3}) %>') }),
+    <% } %>
+  },
+  ${"apiMethodsTypeSchema"}: {
+    <% for (const path of apiPaths) { %>'<%= utils.hyphen(path.slice(0, -${3})) %>': undefined as unknown as typeof <%= utils.camel(path.slice(0, -${3}).replaceAll('/', '$')) %>,
+    <% } %>
+  },
+  ${"apiTestsSchema"}: {
+    <% for (const path of apiTestPaths) { %>'<%= utils.hyphen(path.slice(0, -${3})) %>': () => ({ module: import('../src/apps/<%= path.slice(0, -${3}) %>') }),
+    <% } %>
+  },
+}
+ `.trim(),
+      templateVars
+    )
+  );
+
+  // api
+  const apiValidatorTemplate = `/**
+ * ⚠️This file is generated and modifications will be overwritten
+ */
+
+export default {
+  generatedAt: ${new Date().getTime()},
+  ${"validate"}: {
+    <% for (const path of apiPaths) { %>'<%= utils.hyphen(path.slice(0, -${3})) %>': () => import('./apps/<%= utils.hyphen(path) %>'),
+    <% } %>
+  },
+}
+`.trim();
+  await writeFile(join(cwd(), "generate", "raw", "api-validator.ts"), ejs.render(apiValidatorTemplate, templateVars));
+
+  await new Promise((resolve) =>
+    nodeExec("bun run ./node_modules/typia/lib/executable/typia.js generate --input generate/raw --output generate/products --project tsconfig.json", (e) => {
+      resolve(e);
+    })
+  );
+}

package/scripts/generate/generate-database.ts

@@ -0,0 +1,23 @@
+/* eslint-disable no-console */
+
+import ejs from "ejs";
+import { join } from "node:path";
+import walkSync from "walk-sync";
+import { existsSync } from "node:fs";
+import { cwd } from "node:process";
+import { writeFile } from "node:fs/promises";
+
+export async function generateDatabase() {
+  if (existsSync(join(cwd(), "src", "databases"))) {
+    if (!existsSync(join("generate", "database-schema.ts"))) {
+      await writeFile(join("generate", "database-schema.ts"), ``);
+    }
+    const filePath = join(cwd(), "generate", "database-schema.ts");
+    const databaseFiles = walkSync(join(cwd(), "src", "databases"), {
+      directories: false
+    }).filter((file) => file.endsWith(".ts"));
+    const template = `<% for (const path of ${"databaseFiles"}) { %>export * from '${"../src/databases"}/<%= path.slice(0, -3) %>'
+<% } %>`;
+    await writeFile(filePath, ejs.render(template, { databaseFiles }));
+  }
+}

package/scripts/generate-database.ts

@@ -0,0 +1,23 @@
+/* eslint-disable no-console */
+
+import { join } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import { exit } from "node:process";
+import { generateDatabase } from "./generate/generate-database";
+
+export async function generate() {
+  // Make sure that the existing directories are all present
+  existsSync(join("generate")) || mkdirSync(join("generate"));
+  existsSync(join("generate", "raw")) || mkdirSync(join("generate", "raw"));
+  existsSync(join("generate", "raw", "apps")) || mkdirSync(join("generate", "raw", "apps"));
+
+  await generateDatabase();
+}
+
+console.log("Loongbao Database Generating..");
+
+await generate();
+
+console.log("\n✅ Loongbao Database Generated!\n");
+
+exit(0);

package/scripts/generate-partial.ts

@@ -0,0 +1,15 @@
+/* eslint-disable no-console, @typescript-eslint/no-explicit-any, @typescript-eslint/no-unsafe-argument */
+
+import { argv, exit } from "node:process";
+import { generateApp } from "./generate/generate-app";
+console.log("Loongbao Quick Generating..");
+
+export async function generatePartial(path?: string) {
+  await generateApp();
+}
+
+await generatePartial(...(argv.slice(3) as any));
+
+console.log("\n✅ Loongbao Generated!");
+
+exit(0);

package/scripts/generate.ts

@@ -0,0 +1,23 @@
+/* eslint-disable no-console */
+
+import { join } from "node:path";
+import { existsSync, mkdirSync } from "node:fs";
+import { exit } from "node:process";
+import { generateApp } from "./generate/generate-app";
+
+export async function generate() {
+  // Make sure that the existing directories are all present
+  existsSync(join("generate")) || mkdirSync(join("generate"));
+  existsSync(join("generate", "raw")) || mkdirSync(join("generate", "raw"));
+  existsSync(join("generate", "raw", "apps")) || mkdirSync(join("generate", "raw", "apps"));
+
+  await generateApp();
+}
+
+console.log("Loongbao Generating..");
+
+await generate();
+
+console.log("\n✅ Loongbao Generated!");
+
+exit(0);

package/templates/api.ts

@@ -0,0 +1,49 @@
+import { createTemplate } from "../utils/create-template";
+import { join } from "path";
+
+await createTemplate(async (tools) => {
+  return {
+    path: join(tools.directory, `${tools.hyphen(tools.name)}.ts`),
+    content: `
+import { defineApi, defineApiTest } from "loongbao";
+
+/**
+ * ${tools.hyphen(tools.name)}
+ */
+export const api = defineApi({
+  meta: {
+    //
+  },
+  async action(
+    params: {
+      //
+    },
+    context
+  ) {
+    const message = \`hello world!\`;
+
+    // ..
+
+    return {
+      say: message
+    };
+  }
+});
+
+export const test = defineApiTest(api, [
+  {
+    name: "Basic",
+    handler: async (test) => {
+      const result = await test.execute({
+        //
+      });
+
+      // ..
+
+      if (!result.success) return test.reject(\`The result was not success\`);
+    }
+  }
+]);    
+`.trim()
+  };
+});

package/tsconfig.json

@@ -0,0 +1,33 @@
+{
+  "compilerOptions": {
+    "rootDir": "./../../../",
+    "lib": [
+      "ESNext"
+    ],
+    "module": "esnext",
+    "target": "esnext",
+    "moduleResolution": "bundler",
+    "moduleDetection": "force",
+    "allowImportingTsExtensions": true,
+    "noEmit": true,
+    "composite": true,
+    "strict": true,
+    "downlevelIteration": true,
+    "skipLibCheck": true,
+    "jsx": "react-jsx",
+    "allowSyntheticDefaultImports": true,
+    "forceConsistentCasingInFileNames": true,
+    "allowJs": true,
+    "types": [
+      "bun-types"
+    ],
+    "paths": {
+      "../../*": [
+        "../../*"
+      ]
+    }
+  },
+  "include": [
+    "../../../**/*"
+  ]
+}

package/types.ts

@@ -0,0 +1,42 @@
+/* eslint-disable @typescript-eslint/ban-types, @typescript-eslint/no-explicit-any */
+
+import { type createLoongbaoApp } from ".";
+import type { failCode } from "../../src/fail-code";
+
+export type LoongbaoApp = Awaited<ReturnType<typeof createLoongbaoApp>>;
+
+export type ExecuteId = string | "global";
+
+export type FailEnumerates = typeof failCode;
+
+export type HTTPRequest = Request;
+
+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];
+};
+
+export type LoongbaoMeta = {
+  //
+};
+
+export type Cookbook = Record<string, CookbookItem>;
+
+export type CookbookItem = {
+  title?: string;
+  desc?: string;
+  params: string;
+  cases: Array<{
+    name: string;
+    handler: string;
+  }>;
+};
+
+export type DatabaseType<Table extends { findFirst: () => unknown }, Override = {}> = Mixin<NonNullable<Awaited<ReturnType<Table["findFirst"]>>>, Override>;
+
+export type Override<P, S> = Omit<P, keyof S> & S;
+
+export type Mixin<T, U> = U & Omit<T, keyof U>;

package/utils/create-template.ts

@@ -0,0 +1,32 @@
+import { argv } from "bun";
+import { camel, hump, hyphen } from "@poech/camel-hump-under";
+
+export type CreateTemplateTools = {
+  name: string;
+  directory: string;
+  camel: (str: string) => string;
+  hump: (str: string) => string;
+  hyphen: (str: string) => string;
+};
+
+export type CreateTemplateFn = (tools: CreateTemplateTools) =>
+  | {
+      path: string;
+      content: string;
+    }
+  | Promise<{
+      path: string;
+      content: string;
+    }>;
+
+export async function createTemplate(fn: CreateTemplateFn) {
+  const tools = {
+    name: argv[2],
+    directory: argv[3],
+    camel: (str: string) => camel(str).replaceAll("-", "").replaceAll("_", ""),
+    hump: (str: string) => hump(str).replaceAll("-", "").replaceAll("_", ""),
+    hyphen: (str: string) => hyphen(str).replaceAll("_", "")
+  };
+  const file = await fn(tools);
+  await Bun.write(file.path, file.content);
+}

package/utils/create-ulid.ts

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

package/utils/env-to-boolean.ts

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

package/utils/env-to-number.ts

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

package/utils/env-to-string.ts

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

package/utils/exec.ts

@@ -0,0 +1,27 @@
+import { env, type SpawnOptions } from "bun";
+
+/**
+ * This is a legacy wrapper that was written before $ Shell was created.
+ * All relevant code should be replaced with $ Shell in the future.
+ */
+
+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 };
+
+    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);
+    }
+  });
+};

package/utils/handle-catch-error.ts

@@ -0,0 +1,37 @@
+import { failCode } from "../../../src/fail-code";
+import { useLogger, type ExecuteId, type ExecuteResult } from "..";
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export function hanldeCatchError(error: any, executeId: ExecuteId): ExecuteResult<any> {
+  const logger = useLogger(executeId);
+
+  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 !== "LoongbaoReject") {
+    // If it is not LoongbaoReject, 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 {
+    logger.error(`FailCode: ${error.code}`);
+    return {
+      executeId,
+      success: false,
+      fail: {
+        code: error.code,
+        message: error.message,
+        data: error.data
+      }
+    };
+  }
+}

package/utils/remove-dir.ts

@@ -0,0 +1,22 @@
+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) {}
+}

package/utils/tson.ts

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