miqro 6.1.2 → 6.1.4

package/build/esm/editor/http/admin/editor/api/fs/scan.api.d.ts

@@ -0,0 +1,26 @@
+import { APIRoute } from "@miqro/core";
+import { AdminRequest } from "../../../../../common/admin-interface.js";
+export interface ScannedFile {
+    filePath: string;
+    ext: string;
+    fileName: string;
+    name: string;
+    subExt: string;
+    subName: string;
+    language: string;
+    previewPath?: string;
+    dirs: string[];
+    apiPreview?: {
+        path: string;
+        method: string;
+    }[];
+}
+declare const _default: APIRoute;
+export default _default;
+export declare function scanDir(req: AdminRequest, basePath?: string, ret?: ScannedFile[]): ScannedFile[];
+export declare function getLanguage(filePath: string): string;
+export declare function getPreview(req: AdminRequest, filePath: string): undefined | string;
+export declare function getAPIPreview(req: any, filePath: string): undefined | {
+    path: string;
+    method: string;
+}[];

package/build/esm/editor/http/admin/editor/api/fs/scan.api.js

@@ -0,0 +1,149 @@
+import { existsSync, readdirSync, statSync } from "node:fs";
+import { basename, dirname, extname, relative, resolve, sep } from "node:path";
+import { BASE_PATH } from "../../../../../common/constants.server.js";
+export default {
+    method: "GET",
+    path: "/scan",
+    description: "admin editor file scan endpoint",
+    middleware: [server.middleware.json()],
+    request: {
+        body: false
+    },
+    response: {
+        status: [200, 400]
+    },
+    handler: async (req, res) => {
+        const admin = req.editor;
+        const services = admin ? admin.getServices() : ["."];
+        return res.json({
+            files: scanDir(req),
+            services
+        });
+    },
+};
+export function scanDir(req, basePath = BASE_PATH, ret = []) {
+    const admin = req.editor;
+    const services = admin ? admin.getServices() : ["."];
+    services.forEach(service => {
+        scanDirInternal(req, resolve(basePath, service), ret);
+    });
+    return ret;
+}
+function scanDirInternal(req, path = BASE_PATH, ret = []) {
+    if (!existsSync(path)) {
+        return ret;
+    }
+    const files = readdirSync(path);
+    for (const file of files) {
+        if (shouldIgnoreFile(file)) {
+            continue;
+        }
+        const filePath = resolve(path, file);
+        if (statSync(filePath).isDirectory()) {
+            scanDirInternal(req, filePath, ret);
+            continue;
+        }
+        else {
+            const ext = extname(filePath);
+            const fileName = basename(filePath);
+            const name = fileName.substring(0, fileName.length - ext.length);
+            const subExt = extname(name);
+            const subName = name.substring(0, name.length - subExt.length);
+            ret.push({
+                dirs: getFileDirs(relative(BASE_PATH, filePath)),
+                language: getLanguage(filePath),
+                filePath: relative(BASE_PATH, filePath),
+                ext,
+                fileName,
+                name,
+                subExt,
+                subName,
+                previewPath: getPreview(req, filePath),
+                apiPreview: getAPIPreview(req, filePath)
+            });
+        }
+    }
+    return ret;
+}
+function shouldIgnoreFile(file) {
+    return file === ".git" || file === ".types" || file === ".DS_Store" || file === "node_modules";
+}
+function getFileDirs(filePath) {
+    const dirs = [];
+    let dir = dirname(filePath);
+    while (dir !== sep && dir !== "" && dir !== "." && dir !== BASE_PATH) {
+        dirs.push(dir);
+        dir = dirname(dir);
+    }
+    return dirs.reverse().map(d => basename(d));
+}
+export function getLanguage(filePath) {
+    const ext = extname(filePath);
+    const fileName = basename(filePath);
+    switch (ext.toLocaleLowerCase()) {
+        case ".py":
+            return "python";
+        case ".sh":
+            return "bash";
+        case ".webmanifest":
+        case ".json":
+            return "json";
+        case ".xml":
+            return "xml";
+        case ".jsx":
+        case ".js":
+            return "javascript";
+        case ".tsx":
+        case ".ts":
+        case "d.ts":
+            return "typescript";
+        case ".htm":
+        case ".html":
+            return "html";
+        case ".scss":
+        case ".css":
+            return "css";
+        case ".md":
+            return "markdown";
+        case ".c":
+            return "c";
+        case ".h":
+        case ".cpp":
+            return "cpp";
+        case ".yml":
+        case ".yaml":
+            return "yaml";
+        case ".txt":
+        case ".log":
+            return "text";
+        default:
+            switch (fileName) {
+                case "dockerfile":
+                    return "dockerfile";
+                case ".gitignore":
+                    return "text";
+            }
+            return "text";
+    }
+}
+export function getPreview(req, filePath) {
+    const admin = req.editor;
+    const inflateData = admin ? admin.getRouteFileMap()[filePath] : undefined;
+    if (inflateData) {
+        return inflateData.previewMethod === "html" ? inflateData.routes[0].path : undefined;
+    }
+    return undefined;
+}
+export function getAPIPreview(req, filePath) {
+    const admin = req.editor;
+    const inflateData = admin ? admin.getRouteFileMap()[filePath] : undefined;
+    if (inflateData) {
+        return inflateData.previewMethod === "api" ? inflateData.routes.map(r => {
+            return {
+                path: r.path,
+                method: r.method ? r.method : "GET"
+            };
+        }) : undefined;
+    }
+    return undefined;
+}

package/build/esm/editor/http/admin/editor/api/fs/write.api.d.ts

@@ -0,0 +1,3 @@
+import { APIRoute } from "@miqro/core";
+declare const _default: APIRoute;
+export default _default;

package/build/esm/editor/http/admin/editor/api/fs/write.api.js

@@ -0,0 +1,38 @@
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { getPath } from "./read.api.js";
+import { dirname } from "node:path";
+export default {
+    middleware: [server.middleware.json()],
+    method: "POST",
+    path: "/write",
+    description: "admin editor file write endpoint",
+    request: {
+        body: {
+            path: "string",
+            contents: "string",
+            override: "boolean?"
+        }
+    },
+    response: {
+        status: [200, 400],
+        body: {
+            message: "string"
+        }
+    },
+    handler: async (req, res) => {
+        const { path, contents, override } = req.body;
+        await writeFile(path, contents, override);
+        return res.json({
+            message: "OK"
+        });
+    }
+};
+async function writeFile(path, contents, override) {
+    if (existsSync(getPath(path)) && !override) {
+        throw new Error("file already exists!");
+    }
+    mkdirSync(dirname(getPath(path)), {
+        recursive: true
+    });
+    writeFileSync(getPath(path), contents);
+}

package/build/esm/editor/http/admin/editor/api/server/reload.api.d.ts

@@ -0,0 +1,10 @@
+import { APIRoute } from "@miqro/core";
+declare const _default: APIRoute;
+export default _default;
+export declare function parseInflateErrors(errors: {
+    filePath: string;
+    error: Error;
+}[] | null): {
+    filePath: string;
+    error: string;
+}[];

package/build/esm/editor/http/admin/editor/api/server/reload.api.js

@@ -0,0 +1,46 @@
+import { relative } from "node:path";
+import { BASE_PATH } from "../../../../../common/constants.server.js";
+export default {
+    method: "POST",
+    path: "/reload",
+    description: "admin editor server reload endpoint. reloads the server without closing the port",
+    middleware: [],
+    request: {
+        body: false
+    },
+    response: {
+        status: [200, 400],
+        body: {
+            message: "string",
+            reloadString: "string",
+            migrations: "string[]",
+            errors: {
+                allowNull: true,
+                type: "array",
+                arrayType: "object",
+                properties: {
+                    filePath: "string",
+                    error: "string"
+                }
+            }
+        }
+    },
+    handler: async (req, res) => {
+        const errors = await req?.editor?.reload();
+        const parsedErrors = parseInflateErrors(errors);
+        return res.json({
+            message: "OK",
+            reloadString: req.uuid,
+            migrations: req?.editor?.getMigrations().map(m => m.name),
+            errors: parsedErrors ? parsedErrors : []
+        });
+    },
+};
+export function parseInflateErrors(errors) {
+    return errors?.map(error => {
+        return {
+            filePath: relative(BASE_PATH, error.filePath),
+            error: error.error.message
+        };
+    });
+}

package/build/esm/editor/http/admin/editor/api/server/restart.api.d.ts

@@ -0,0 +1,10 @@
+import { APIRoute } from "@miqro/core";
+declare const _default: APIRoute;
+export default _default;
+export declare function parseInflateErrors(errors: {
+    filePath: string;
+    error: Error;
+}[] | null): {
+    filePath: string;
+    error: string;
+}[];

package/build/esm/editor/http/admin/editor/api/server/restart.api.js

@@ -0,0 +1,45 @@
+import { relative } from "node:path";
+import { BASE_PATH } from "../../../../../common/constants.server.js";
+export default {
+    method: "POST",
+    path: "/restart",
+    description: "admin editor server restart endpoint",
+    middleware: [server.middleware.json()],
+    request: {
+        body: false
+    },
+    response: {
+        status: [200, 400],
+        body: {
+            message: "string",
+            reloadString: "string",
+            migrations: "string[]",
+            errors: {
+                allowNull: true,
+                type: "array",
+                arrayType: "object",
+                properties: {
+                    filePath: "string",
+                    error: "string"
+                }
+            }
+        }
+    },
+    handler: async (req, res) => {
+        const errors = await req?.editor?.restart();
+        return res.json({
+            message: "OK",
+            reloadString: req.uuid,
+            migrations: req?.editor?.getMigrations().map(m => m.name),
+            errors: parseInflateErrors(errors)
+        });
+    },
+};
+export function parseInflateErrors(errors) {
+    return errors?.map(error => {
+        return {
+            filePath: relative(BASE_PATH, error.filePath),
+            error: error.error.message
+        };
+    });
+}

package/build/esm/editor/http/admin/editor/editor.d.ts

@@ -0,0 +1 @@
+export {};

package/build/esm/editor/http/admin/editor/editor.js

@@ -0,0 +1,7 @@
+//import "../../../../.types/browser.globals";
+import { Editor } from "../../../components/editor.js";
+window.addEventListener("load", async (event) => {
+    jsx.define("editor-component", Editor, {
+        shadowInit: false
+    });
+});

package/build/esm/editor/http/admin/editor/index.api.d.ts

@@ -0,0 +1,3 @@
+import { APIRoute } from "@miqro/core";
+declare const _default: APIRoute;
+export default _default;

package/build/esm/editor/http/admin/editor/index.api.js

@@ -0,0 +1,21 @@
+import { scanDir } from "./api/fs/scan.api.js";
+import { HTMLEncode } from "../../../common/html-encode.js";
+export default {
+    description: "ADMIN EDITOR GUI",
+    path: "/",
+    method: "GET",
+    handler: async (req, res) => {
+        const admin = req.editor;
+        const errors = admin ? admin.getInflateErrors() : [];
+        const files = scanDir(req);
+        const migrations = admin ? admin.getMigrations().map(m => m.name) : [];
+        const services = admin ? admin.getServices() : ["."];
+        return res.html("<!DOCTYPE html>" + String(JSX.createElement("html", null,
+            JSX.createElement("head", null,
+                JSX.createElement("link", { rel: "stylesheet", href: "/admin/editor/style.css" })),
+            JSX.createElement("body", null,
+                JSX.createElement("script", { type: "module", src: "/admin/editor/editor.js" }),
+                JSX.createElement("editor-component", { disablelog: "true", disablepreview: "true", disablereload: "true", class: "main-container", reloadstring: `${req?.uuid}`, migrations: `${HTMLEncode(JSON.stringify(migrations))}`, services: `${HTMLEncode(JSON.stringify(services))}`, errors: `${HTMLEncode(JSON.stringify(errors))}`, files: `${HTMLEncode(JSON.stringify(files))}` },
+                    JSX.createElement("noscript", null, "Enable JavaScript"))))));
+    }
+};

package/build/esm/editor/server.d.ts

@@ -0,0 +1,3 @@
+import { ServerConfig } from "../src/types.js";
+declare const _default: ServerConfig;
+export default _default;

package/build/esm/editor/server.js

@@ -0,0 +1,49 @@
+import { randomUUID } from "node:crypto";
+import { BASEEDITOR_PATH } from "./common/constants.js";
+import { existsSync, readFileSync } from "node:fs";
+import { relative, resolve } from "node:path";
+import { ADMIN_EDITOR_AUTH_KEY, ADMIN_EDITOR_AUTH_QUERY } from "./auth.js";
+//import { getEditorAdmin } from "./common/admin-interface.js";
+const ADMIN_EDITOR_BROWSER_OPEN_KEY = "ADMIN_EDITOR_BROWSER_OPEN_KEY$$";
+export default {
+    preload: (serverInterface, adminInterface) => {
+        //console.dir(server);
+        if (serverInterface?.isPrimaryWorker()) {
+            const cache = (adminInterface ? adminInterface.getCache() : serverInterface.cache);
+            if (!cache.has(ADMIN_EDITOR_AUTH_KEY)) {
+                const adminKEYPath = resolve(".admin_key");
+                if (existsSync(adminKEYPath)) {
+                    serverInterface.logger.warn("loading static ADMIN_KEY from [%s]", relative(process.cwd(), adminKEYPath));
+                    cache.set(ADMIN_EDITOR_AUTH_KEY, readFileSync(adminKEYPath).toString().trim());
+                }
+                else {
+                    cache.set(ADMIN_EDITOR_AUTH_KEY, randomUUID());
+                }
+            }
+        }
+    },
+    start: (serverInterface, adminInterface) => {
+        //console.dir(server);
+        const cache = (adminInterface ? adminInterface.getCache() : serverInterface.cache);
+        if (!cache.has(ADMIN_EDITOR_BROWSER_OPEN_KEY)) {
+            const KEY = cache.get(ADMIN_EDITOR_AUTH_KEY);
+            const adminPath = `${BASEEDITOR_PATH}?${ADMIN_EDITOR_AUTH_QUERY}=${KEY}`;
+            if (serverInterface?.isPrimaryWorker()) {
+                serverInterface.logger.log("\n\n\tADMIN_EDITOR\n\n\t%s\n\n", adminPath);
+            }
+            //const DEFAULT_OPEN = process.platform === "win32" ? "explorer" : process.platform === "darwin" ? "open" : "xdg-open";
+            //const OPEN = process.env["BROWSER"] ? process.env["BROWSER"] === "none" ? false : process.env["BROWSER"] : DEFAULT_OPEN;
+            if (serverInterface.isPrimaryWorker()) {
+                cache.set(ADMIN_EDITOR_BROWSER_OPEN_KEY, true);
+                try {
+                    serverInterface.openBrowser(`${BASEEDITOR_PATH}?${ADMIN_EDITOR_AUTH_QUERY}=${KEY}`);
+                    //serverInterface.logger.log(`${OPEN} "${adminPath}"`);
+                    //execSync(`${OPEN} "${adminPath}"`);
+                }
+                catch (e) {
+                    serverInterface.logger.error(e.message);
+                }
+            }
+        }
+    }
+};

package/build/esm/editor/ws.d.ts

@@ -0,0 +1,3 @@
+import { WSConfig } from "../src/types.js";
+declare const _default: WSConfig;
+export default _default;

package/build/esm/editor/ws.js

@@ -0,0 +1,11 @@
+import { LOG_SOCKET_PATH } from "./common/constants.js";
+export default {
+    path: LOG_SOCKET_PATH,
+    validate(req) {
+        const admin = req.editor;
+        const cache = (admin ? admin.getCache() : req.server.cache);
+        const KEY = cache.get("AUTH_KEY");
+        const cookieToken = req.cookies["auth"];
+        return cookieToken === KEY ? true : false;
+    },
+};

package/build/esm/src/bin/types.js

@@ -16,5 +16,13 @@ export async function installTypings(args, logger) {
         logger.error("tsconfig.json already exists!");
         process.exit(EXIT_CODES.ABNORMAL);
     }
+    if (args.installMiqroJSON && !existsSync("miqro.json")) {
+        logger.info("writing miqro.json");
+        writeFileSync("miqro.json", TEMPLATES["MIQROJSON"].template("", ""));
+    }
+    else if (args.installMiqroJSON) {
+        logger.error("miqro.json already exists!");
+        process.exit(EXIT_CODES.ABNORMAL);
+    }
     process.exit(EXIT_CODES.NORMAL_EXIT);
 }

package/build/esm/src/common/arguments.d.ts

@@ -3,12 +3,18 @@ interface MiqroJSON {
     port?: string | number;
     inflateDir?: string;
     name?: string;
+    browser?: string | boolean;
+    logFile?: string | boolean;
+    editor?: boolean;
 }
 export declare function importMiqroJSON(inFile: string): MiqroJSON;
 export declare function getPORT(): string;
 export interface Arguments {
-    name: string;
+    name?: string;
+    browser?: string | boolean;
+    logFile?: string | boolean;
     installTypes: boolean;
+    installMiqroJSON: boolean;
     installTSConfig: boolean;
     test: boolean;
     port: string;

package/build/esm/src/common/arguments.js

@@ -18,7 +18,10 @@ const MiqroJSONSchema = {
         name: "string?",
         services: "string[]?",
         port: "number?|string?",
-        inflateDir: "string?"
+        inflateDir: "string?",
+        browser: "boolean?|string?",
+        logFile: "boolean?|string?",
+        editor: "boolean?"
     }
 };
 export function importMiqroJSON(inFile) {
@@ -42,8 +45,11 @@ export function parseArguments() {
     const args = cluster.isPrimary ? process.argv.slice(2, process.argv.length) : process.argv.slice(3, process.argv.length);
     const flags = {
         name: null,
+        browser: null,
+        logFile: null,
         hotreload: null,
         miqroJSONPath: null,
+        installMiqroJSON: null,
         disableMiqroJSON: null,
         installTypes: null,
         port: null,
@@ -130,7 +136,7 @@ export function parseArguments() {
                     console.error(usage);
                     process.exit(EXIT_CODES.BAD_ARGUMENTS);
                 }
-                const cPort = String(args[i + 1]).toUpperCase();
+                const cPort = String(args[i + 1]);
                 if (typeof cPort !== "string") {
                     console.error("bad arguments. --port must be a string.");
                     console.error(usage);
@@ -154,6 +160,36 @@ export function parseArguments() {
                 flags.name = cName;
                 i++;
                 continue;
+            case "--log-file":
+                if (flags.logFile !== null) {
+                    console.error("bad arguments.");
+                    console.error(usage);
+                    process.exit(EXIT_CODES.BAD_ARGUMENTS);
+                }
+                const cLofFile = String(args[i + 1]);
+                if (typeof cLofFile !== "string") {
+                    console.error("bad arguments. --port must be a string.");
+                    console.error(usage);
+                    process.exit(EXIT_CODES.BAD_ARGUMENTS);
+                }
+                flags.logFile = cLofFile;
+                i++;
+                continue;
+            case "--browser":
+                if (flags.browser !== null) {
+                    console.error("bad arguments.");
+                    console.error(usage);
+                    process.exit(EXIT_CODES.BAD_ARGUMENTS);
+                }
+                const cBrowser = String(args[i + 1]);
+                if (typeof cBrowser !== "string") {
+                    console.error("bad arguments. --port must be a string.");
+                    console.error(usage);
+                    process.exit(EXIT_CODES.BAD_ARGUMENTS);
+                }
+                flags.browser = cBrowser;
+                i++;
+                continue;
             case "--generate-doc":
                 if (flags.generateDoc !== null) {
                     console.error("bad arguments.");
@@ -228,6 +264,14 @@ export function parseArguments() {
                 }
                 flags.editor = true;
                 continue;
+            case "--install-miqrojson":
+                if (flags.installMiqroJSON !== null) {
+                    console.error("bad arguments. --install-miqrojson already set.");
+                    console.error(usage);
+                    process.exit(EXIT_CODES.BAD_ARGUMENTS);
+                }
+                flags.installMiqroJSON = true;
+                continue;
             case "--inflate-sea":
                 if (flags.inflateSEA !== null) {
                     console.error("bad arguments. --inflate-sea already set.");
@@ -308,7 +352,6 @@ export function parseArguments() {
         }
     }
     flags.inflate = flags.inflate ? flags.inflate : false;
-    flags.editor = flags.editor ? flags.editor : false;
     flags.test = flags.test ? flags.test : false;
     flags.inflateDir = flags.inflateDir ? flags.inflateDir : undefined;
     const miqroJSONPath = !flags.disableMiqroJSON ? flags.miqroJSONPath ? resolve(flags.miqroJSONPath) : getMiqroJSONPath() : false;
@@ -322,7 +365,7 @@ export function parseArguments() {
                 }
             }
         }
-        if (!flags.port) {
+        if (flags.port === null) {
             if (miqroRC.port) {
                 flags.port = String(miqroRC.port);
             }
@@ -332,13 +375,29 @@ export function parseArguments() {
                 flags.inflateDir = miqroRC.inflateDir;
             }
         }
-        if (!flags.name) {
+        if (flags.name === null) {
             if (miqroRC.name) {
                 flags.name = miqroRC.name;
             }
         }
+        if (flags.logFile === null) {
+            if (miqroRC.logFile !== undefined) {
+                flags.logFile = miqroRC.logFile;
+            }
+        }
+        if (flags.browser === null) {
+            if (miqroRC.browser !== undefined) {
+                flags.browser = miqroRC.browser;
+            }
+        }
+        if (flags.editor === null) {
+            if (miqroRC.editor !== undefined) {
+                flags.editor = miqroRC.editor;
+            }
+        }
     }
-    if (services.length === 0 && (!flags.installTSConfig && !flags.installTypes)) {
+    flags.editor = flags.editor ? flags.editor : false;
+    if (services.length === 0 && (!flags.installTSConfig && !flags.installTypes && !flags.installMiqroJSON)) {
         flags.inflateDir = flags.inflateDir ? flags.inflateDir : undefined;
         console.error(`bad arguments. missing --service argument`);
         console.error(usage);
@@ -368,16 +427,16 @@ export function parseArguments() {
         console.error("bad arguments. cannot use --inflate with --editor");
         process.exit(EXIT_CODES.BAD_ARGUMENTS);
     }
-    if (flags.inflate && (flags.installTypes || flags.installTSConfig)) {
-        console.error("bad arguments. cannot use --inflate with --install-types");
+    if (flags.inflate && (flags.installTypes || flags.installTSConfig || flags.installMiqroJSON)) {
+        console.error("bad arguments. cannot use --inflate with --install-types, --install-tsconfig or --install-miqrojson");
         process.exit(EXIT_CODES.BAD_ARGUMENTS);
     }
     if (flags.inflateSEA && !flags.inflate) {
         console.error("bad arguments. cannot use --inflate-sea without --inflate");
         process.exit(EXIT_CODES.BAD_ARGUMENTS);
     }
-    if (flags.editor && (flags.installTypes || flags.installTSConfig)) {
-        console.error("bad arguments. cannot use --editor with --install-types");
+    if (flags.editor && (flags.installTypes || flags.installTSConfig || flags.installMiqroJSON)) {
+        console.error("bad arguments. cannot use --editor with--install-types, --install-tsconfig or --install-miqrojson");
         process.exit(EXIT_CODES.BAD_ARGUMENTS);
     }
     if (flags.test && (flags.hotreload || flags.editor || flags.compile || flags.inflate)) {
@@ -403,11 +462,14 @@ export function parseArguments() {
     const generateDocType = flags.generateDocType ? flags.generateDocType : "MD";
     return {
         name: flags.name ? flags.name : undefined,
+        browser: flags.browser !== null ? flags.browser : undefined,
+        logFile: flags.logFile !== null ? flags.logFile : undefined,
         generateDocAll: flags.generateDocAll ? true : false,
         hotreload: flags.hotreload ? true : false,
         disableMiqroJSON: flags.disableMiqroJSON !== null ? flags.disableMiqroJSON : false,
         miqroJSONPath: miqroJSONPath ? miqroJSONPath : false,
         installTypes: flags.installTypes ? true : false,
+        installMiqroJSON: flags.installMiqroJSON ? true : false,
         installTSConfig: flags.installTSConfig ? true : false,
         inflate: flags.inflate,
         port: flags.port ? flags.port : getPORT(),

package/build/esm/src/common/help.d.ts

@@ -1,3 +1,3 @@
 export declare const BIN_NAME = "miqro";
 export declare const usage = "usage: miqro [...FLAGS] --service app/\n\n==examples==\n\nmiqro --watch --service front/\nPORT=8181 miqro --service api/ --service front/\nmiqro --test --service front/\nmiqro --inflate --service front/\nmiqro --generate-doc --generate-doc-out API.md --service front/\nCLUSTER_COUNT=10 miqro-cluster --service api/";
-export declare const help = "\n==flags==\n\n-v, --version\t\toutputs the version number\n-h, --help\t\toutputs this page.\n--watch\t\t\tuse to enable the hot-reload functionality.\n--test\t\t\trun the tests for a service.\n--migrate-up\t\tmigrations up.\n--migrate-down\t\tmigrations down.\n--inflate\t\tinflates the application.\n--inflate-dir\t\tto set the output directory of the --inflate command. default value is inflated/.\n--editor\t\truns the application with a built-in editor.\n--generate-doc\t\tgenerates a documentation for the api endpoints of the service.\n--generate-doc-out\tthe output file for the generated documentation. default value is API.md.\n--generate-doc-type\tthe format of the generated documentation. it can be JSON or MD. default value is MD.\n--generate-doc-all\toutputs all the server routes in the documentation output.\n--compile\t\tinflates the application and tries to create a NODE SEA binary.\n--inflate-sea\t\tinflates the application with sea compilation scripts.\n--install-tsconfig\tcreates a tsconfig.json configured to use with --install-types.\n--install-types\t\tcreates and updates the .types/ folder use together with --install-tsconfig.\n--disable-miqrojson\tdisables the load of miqro.json file.\n--config\toverrides the default miqro.json path with a new one.\n--port\toverrides the default port loading from environment variables.\n--name\toverrides the default name of the server.\n\n==environment variables==\n\nPORT\t\t\toverride the default 8080 port.\nLOG_FILE\t\toverride the default ./server.log file\nDB\t\t\tenable the server.db features\nDB_STORAGE\t\toverride the default local db location ./db.sqlite3\nDB_DIALECT\t\toverride the default node:sqlite\nDB_CONNECTION\t\toverride the default connection url\nCLEAR_JSX_CACHE\t\tset to 1 or 0 to enable or disable the clearing of the esbuild cache defaults to 1.\nJSX_TMP\t\t\tset custom location of esbuild builds defaults to /tmp/jsx_tmp.\n";
+export declare const help = "\n==flags==\n\n-v, --version\n\toutputs the version number\n-h, --help\n\toutputs this page.\n--watch\n\tuse to enable the hot-reload functionality.\n--test\n\trun the tests for a service.\n--migrate-up\n\tmigrations up.\n--migrate-down\n\tmigrations down.\n--inflate\n\tinflates the application.\n--inflate-dir\n\tto set the output directory of the --inflate command. default value is inflated/.\n--editor\n\truns the application with a built-in editor.\n--generate-doc\n\tgenerates a documentation for the api endpoints of the service.\n--generate-doc-out\n\tthe output file for the generated documentation. default value is API.md.\n--generate-doc-type\n\tthe format of the generated documentation. it can be JSON or MD. default value is MD.\n--generate-doc-all\n\toutputs all the server routes in the documentation output.\n--compile\n\tinflates the application and tries to create a NODE SEA binary.\n--inflate-sea\n\tinflates the application with sea compilation scripts.\n--install-tsconfig\n\tcreates a tsconfig.json configured to use with --install-types.\n--install-types\n\tcreates and updates the .types/ folder use together with --install-tsconfig.\n--install-miqrojson\n\tcreates a default miqro.json file.\n--disable-miqrojson\n\tdisables the load of miqro.json file.\n--log-file\n\toverrides the default log file from LOG_FILE.\n--browser\n\toverrides the default browser from BROWSER.\n--config\n\toverrides the default miqro.json path.\n--port\n\toverrides the default port from PORT.\n--name\n\toverrides the default name of the server.\n\n==environment variables==\n\nPORT\n\toverride the default 8080 port.\nBROWSER\n\toverride the default browser. change to none to disable.\".\nLOG_FILE\n\toverride the default ./server.log file\nDB\n\tenable the server.db features\nDB_STORAGE\n\toverride the default local db location ./db.sqlite3\nDB_DIALECT\n\toverride the default node:sqlite\nDB_CONNECTION\n\toverride the default connection url\nCLEAR_JSX_CACHE\n\tset to 1 or 0 to enable or disable the clearing of the esbuild cache defaults to 1.\nJSX_TMP\n\tset custom location of esbuild builds defaults to /tmp/jsx_tmp.\n";