miqro 1.5.5 → 1.6.1

package/dist/utils/doc/index.d.ts

@@ -1,14 +1,16 @@
-import { Logger, Method, ParseOptions } from "@miqro/core";
+import { SessionHandlerOptions, GroupPolicy, Logger, Method, ParseOptions } from "@miqro/core";
 export declare const getDOCJSON: ({ dirname, subPath }: {
     dirname: string;
     subPath: string;
 }, logger: Logger) => {
-    path: string | string[];
-    method: Method | Method[];
-    description: string;
-    params: false | ParseOptions | ParseOptions[];
-    query: false | ParseOptions | ParseOptions[];
-    body: false | ParseOptions | ParseOptions[];
-    result: ParseOptions | ParseOptions[];
+    path?: string | string[];
+    method?: Method | Method[];
+    description?: string;
+    policy?: GroupPolicy;
+    session?: false | true | SessionHandlerOptions;
+    params?: false | ParseOptions | ParseOptions[];
+    query?: false | ParseOptions | ParseOptions[];
+    body?: false | ParseOptions | ParseOptions[];
+    result?: ParseOptions | ParseOptions[];
     featureName: string;
 }[];

package/dist/utils/doc/index.js

@@ -7,10 +7,12 @@ const path_1 = require("path");
 const getDOCJSON = ({ dirname, subPath }, logger) => {
     const apiTraverse = (0, api_router_utils_1.traverseAPIRouteDir)((0, path_1.basename)(dirname).toUpperCase(), (0, path_1.resolve)(core_1.ConfigPathResolver.getBaseDirname(), dirname), subPath, undefined, logger);
     const docJSON = Object.keys(apiTraverse).map(featureName => {
-        const { path, method, description, params, query, body, result } = apiTraverse[featureName];
+        const { session, policy, path, method, description, params, query, body, result } = apiTraverse[featureName];
         return {
             path,
             method,
+            session: session ? typeof session === "function" ? true : session : false,
+            policy,
             params,
             description, query, body, result,
             featureName
@@ -19,3 +21,4 @@ const getDOCJSON = ({ dirname, subPath }, logger) => {
     return docJSON;
 };
 exports.getDOCJSON = getDOCJSON;
+//# sourceMappingURL=index.js.map

package/dist/utils/doc/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/utils/doc/index.ts"],"names":[],"mappings":";;;AAAA,sCAAmH;AACnH,gFAAgF;AAChF,+BAAyC;AAElC,MAAM,UAAU,GAAG,CAAC,EAAE,OAAO,EAAE,OAAO,EAAyC,EAAE,MAAc,EAWlG,EAAE;IACJ,MAAM,WAAW,GAAG,IAAA,sCAAmB,EAAC,IAAA,eAAQ,EAAC,OAAO,CAAC,CAAC,WAAW,EAAE,EAAE,IAAA,cAAO,EAAC,yBAAkB,CAAC,cAAc,EAAE,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,CAAC;IAC5J,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE;QACzD,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC;QAC7G,OAAO;YACL,IAAI;YACJ,MAAM;YACN,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,OAAO,OAAO,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK;YACzE,MAAM;YACN,MAAM;YACN,WAAW,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM;YAChC,WAAW;SACZ,CAAC;IACJ,CAAC,CAAC,CAAC;IACH,OAAO,OAAO,CAAC;AACjB,CAAC,CAAA;AA1BY,QAAA,UAAU,cA0BtB"}

package/dist/utils/index.d.ts

@@ -1,2 +1,3 @@
+/// <reference types="node" />
 import cp from "child_process";
-export declare const execSync: (cmd: string, options?: cp.ExecSyncOptionsWithBufferEncoding) => void;
+export declare const execSync: (cmd: string, options?: cp.ExecSyncOptionsWithBufferEncoding | undefined) => void;

package/dist/utils/index.js

@@ -7,6 +7,7 @@ exports.execSync = void 0;
 const child_process_1 = __importDefault(require("child_process"));
 const execSync = (cmd, options) => {
     console.log(cmd);
-    child_process_1.default.execSync(cmd, options ? Object.assign({ stdio: 'inherit' }, options) : { stdio: 'inherit' });
+    child_process_1.default.execSync(cmd, options ? { stdio: 'inherit', ...options } : { stdio: 'inherit' });
 };
 exports.execSync = execSync;
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":";;;;;;AAAA,kEAA+B;AAExB,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,OAA8C,EAAQ,EAAE;IAC5F,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACjB,uBAAE,CAAC,QAAQ,CACT,GAAG,EACH,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAClE,CAAC;AACJ,CAAC,CAAA;AANY,QAAA,QAAQ,YAMpB"}

package/dist/utils/templates.d.ts

@@ -5,8 +5,8 @@ export declare const authEnvFile = "####################\n## Auth\nTOKEN_LOCATIO
 export declare const templates: {
     modelsIndex: string;
     dbConfig: string;
-    sequelizerc: (typescript?: boolean) => string;
-    exampleModel: (modelName: string, typescript?: boolean) => string;
+    sequelizerc: (typescript?: boolean | undefined) => string;
+    exampleModel: (modelName: string, typescript?: boolean | undefined) => string;
     logEnvFile: string;
     authEnvFile: string;
     dbEnvFile: string;

package/dist/utils/templates.js

@@ -1,4 +1,5 @@
 "use strict";
+// noinspection SpellCheckingInspection
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.templates = exports.authEnvFile = exports.dbEnvFile = exports.featuresEnvFile = exports.logEnvFile = void 0;
 exports.logEnvFile = `####################
@@ -32,6 +33,7 @@ TOKEN_HEADER=Authorization
 #TOKEN_VERIFY_ENDPOINT=
 TOKEN_VERIFY_ENDPOINT_METHOD=GET
 `;
+// noinspection SpellCheckingInspection
 const modelsIndex = `'use strict';
 
 const fs = require('fs');
@@ -73,6 +75,7 @@ module.exports.sequelize = sequelize;
 module.exports.Sequelize = Sequelize;
 
 `;
+// noinspection SpellCheckingInspection
 const dbConfig = `const { loadConfig, checkEnvVariables } = require("@miqro/core");
 
 loadConfig();
@@ -105,6 +108,7 @@ module.exports = {
   storage: process.env.DB_STORAGE
 };
 `;
+// noinspection SpellCheckingInspection
 const sequelizerc = (typescript) => `const path = require("path");
 
 module.exports = {
@@ -165,6 +169,7 @@ module.exports = (sequelize: Sequelize): ${modelName.charAt(0).toUpperCase()}${m
   return ${modelName};
 };`;
 };
+// noinspection SpellCheckingInspection
 exports.templates = {
     modelsIndex,
     dbConfig,
@@ -175,3 +180,4 @@ exports.templates = {
     dbEnvFile: exports.dbEnvFile,
     featuresEnvFile: exports.featuresEnvFile
 };
+//# sourceMappingURL=templates.js.map

package/dist/utils/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/utils/templates.ts"],"names":[],"mappings":";AAAA,uCAAuC;;;AAE1B,QAAA,UAAU,GAAG;;;;;CAKzB,CAAC;AAEW,QAAA,eAAe,GAAG;;;CAG9B,CAAC;AAEW,QAAA,SAAS,GAAG;;;;;;;;;CASxB,CAAC;AAEW,QAAA,WAAW,GAAG;;;;;;;;;;CAU1B,CAAC;AAEF,uCAAuC;AACvC,MAAM,WAAW,GACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwCD,CAAC;AACF,uCAAuC;AACvC,MAAM,QAAQ,GACZ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+BD,CAAC;AACF,uCAAuC;AACvC,MAAM,WAAW,GAAG,CAAC,UAAoB,EAAU,EAAE,CACnD;;;;;;IAME,UAAU,CAAC,CAAC,CAAC,0DAA0D,CAAC,CAAC,CAAC,wDAAwD;;CAErI,CAAC;AAEF,MAAM,YAAY,GAAG,CAAC,SAAiB,EAAE,UAAoB,EAAU,EAAE;IACvE,OAAO,UAAU,CAAC,CAAC,CAAC;;mBAEH,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;;;;cAI/D,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;cACrI,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,yBAAyB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;;2CAEhH,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC;UAC3F,SAAS,uBAAuB,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,SAAS;;;;;;;;;;;;;;IAcpH,SAAS;;SAEJ,SAAS;;WAEP,SAAS;;;;GAIjB,CAAC,CAAC,CAAC;UACI,SAAS,wBAAwB,SAAS;;;;;;;;;;IAUhD,SAAS;;SAEJ,SAAS;;WAEP,SAAS;GACjB,CAAC;AACJ,CAAC,CAAC;AAEF,uCAAuC;AAC1B,QAAA,SAAS,GAAG;IACvB,WAAW;IACX,QAAQ;IACR,WAAW;IACX,YAAY;IACZ,UAAU,EAAV,kBAAU;IACV,WAAW,EAAX,mBAAW;IACX,SAAS,EAAT,iBAAS;IACT,eAAe,EAAf,uBAAe;CAChB,CAAC"}

package/package.json

@@ -1,13 +1,9 @@
 {
   "name": "miqro",
-  "version": "1.5.5",
+  "version": "1.6.1",
   "description": "",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/claukers/miqro.git"
-  },
   "bin": {
     "miqro": "dist/cli.js"
   },
@@ -22,20 +18,18 @@
   "author": "claukers",
   "license": "ISC",
   "dependencies": {
-    "@miqro/core": "^1.2.3",
-    "@miqro/runner": "^1.1.5",
-    "deep-diff": "^1.0.2"
+    "@miqro/core": "^1.3.1",
+    "@miqro/runner": "^1.1.6"
   },
   "devDependencies": {
-    "@types/deep-diff": "^1.0.1",
     "@types/node": "^16.7.10",
-    "@typescript-eslint/eslint-plugin": "^4.30.0",
-    "@typescript-eslint/parser": "^4.30.0",
-    "eslint": "^7.32.0",
-    "typescript": "^4.4.2"
+    "@typescript-eslint/eslint-plugin": "^5.3.0",
+    "@typescript-eslint/parser": "^5.3.0",
+    "eslint": "^8.2.0",
+    "typescript": "^4.4.4"
   },
   "engines": {
-    "node": "^10.0.0",
-    "npm": "^6.0.0"
+    "node": ">=14.0.0",
+    "npm": ">=6.0.0"
   }
 }

package/src/cli.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+//@miqro/core
+import { CLIUtil } from "@miqro/core";
+import { main as start } from "./cmds/start";
+import { mainJS as newJS } from "./cmds/new";
+import { mainTS as newTS } from "./cmds/new";
+import { main as apiDocJSON } from "./cmds/doc-json";
+import { main as apiDocMD } from "./cmds/doc-md";
+import { main as configInit } from "./cmds/config-init";
+import { main as config } from "./cmds/config";
+import { main as configBash } from "./cmds/config-bash";
+import { main as configEnv } from "./cmds/config-env";
+//@miqro/handlers
+import { main as newRoute } from "./cmds/handler-apiroute-new";
+import { main as newMain } from "./cmds/handler-main-new";
+//@miqro/database
+import { main as dbInit } from "./cmds/db-init";
+import { main as makeMigrations } from "./cmds/db-makemigrations";
+import { main as syncMakeMigrations } from "./cmds/db-sync-makemigrations";
+import { main as consoleCMD } from "./cmds/db-console";
+import { main as createModel } from "./cmds/db-createmodel";
+import { main as pushData } from "./cmds/db-push-data";
+import { main as dumpData } from "./cmds/db-dump-data";
+
+// noinspection SpellCheckingInspection
+CLIUtil.cliFlow({
+
+  ["new"]: { section: "quick start", cb: newJS, description: "\t\t\t\tcreate a new project" },
+
+  ["new:main"]: { section: "http scafolding", cb: newMain, description: "\t\t\tcreates a new main file" },
+
+  ["new:typescript"]: { cb: newTS, description: "\t\t\tcreate a new typescript project" },
+
+  ["new:route"]: { cb: newRoute, description: "\t\t\tcreates a new route" },
+
+  ["config"]: { section: "config managment", cb: config, description: "\t\t\t\toutputs to stdout the config as a json" },
+  ["config:bash"]: {
+    cb: configBash,
+    description: "\t\t\toutputs to stdout the config as a bash script"
+  },
+  ["config:env"]: { cb: configEnv, description: "\t\t\toutputs to stdout the config as a env file" },
+  ["config:init"]: { cb: configInit, description: "\t\t\tinits your config folder" },
+
+  ["start"]: { section: "cluster start", cb: start, description: "\t\t\t\tstart a nodejs script in cluster mode and restart if crash." },
+
+  ["doc"]: { section: "api documentation", cb: apiDocJSON, description: "\t\t\t\toutputs to stdout an api folder auto doc as a json" },
+  ["doc:md"]: { cb: apiDocMD, description: "\t\t\t\toutputs to a file an api folder auto doc as a markdown" },
+
+  ["db:console"]: { section: "sequelize helpers", cb: consoleCMD, description: "\t\t\truns a readline interface that send the input as a query" },
+  ["db:dump:data"]: { cb: dumpData, description: "\t\t\tdump the data of the database (only defined models)" },
+  ["db:push:data"]: { cb: pushData, description: "\t\t\tpush a dump to the database" },
+  ["db:make:migration"]: {
+    cb: makeMigrations,
+    description: "\t\tseeks changes in your models and creates migrations"
+  },
+  ["db:make:migration:force:clean:state"]: {
+    cb: syncMakeMigrations,
+    description: "regenerate _current.json in the migrations folder to force the 'local' migration state to be the same as the current models."
+  },
+  ["db:init"]: { cb: dbInit, description: "\t\t\t\tinit sequelize configuration." },
+  ["db:create:model"]: { cb: createModel, description: "\t\t\tcreates an example model" }
+}, "npx miqro <command> [args]", console);

package/src/cmds/config-bash.ts

@@ -0,0 +1,18 @@
+import { loadConfig } from "@miqro/core";
+
+export const main = (): void => {
+  const logger = console;
+
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  const configOut = loadConfig();
+
+  const config = configOut.combined;
+  const keys = Object.keys(config);
+
+  for (const key of keys) {
+    logger.info(`export ${key}=${config[key]}`);
+  }
+}

package/src/cmds/config-env.ts

@@ -0,0 +1,18 @@
+import { loadConfig } from "@miqro/core";
+
+export const main = (): void => {
+  const logger = console;
+
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  const configOut = loadConfig();
+
+  const config = configOut.combined;
+  const keys = Object.keys(config);
+
+  for (const key of keys) {
+    logger.info(`${key}=${config[key]}`);
+  }
+}

package/src/cmds/config-init.ts

@@ -0,0 +1,35 @@
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { ConfigPathResolver, loadConfig } from "@miqro/core";
+import { templates } from "../utils/templates";
+
+export const main = (): void => {
+  const logger = console;
+
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  loadConfig();
+
+  const configPath = ConfigPathResolver.getConfigDirname();
+
+  const initEnvFile = (path: string, template: string): void => {
+    if (!existsSync(path)) {
+      logger.warn(`creating ${path} env file`);
+      writeFileSync(path, template);
+    } else {
+      logger.warn(`${path} already exists!. init will not create it.`);
+    }
+  };
+
+  if (!existsSync(configPath)) {
+    logger.warn(`[${configPath}] doesnt exists!`);
+    mkdirSync(configPath, {
+      recursive: true
+    });
+  }
+  initEnvFile(resolve(configPath, `log.env`), templates.logEnvFile);
+  initEnvFile(resolve(configPath, `auth.env`), templates.authEnvFile);
+  initEnvFile(resolve(configPath, `features.env`), templates.featuresEnvFile);
+}

package/src/cmds/config.ts

@@ -0,0 +1,16 @@
+import { loadConfig } from "@miqro/core";
+
+export const main = (): void => {
+  const logger = console;
+
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  const configOut = loadConfig();
+
+  const config = configOut.combined;
+
+  logger.info(JSON.stringify(config, undefined, 2));
+}
+

package/src/cmds/db-console.ts

@@ -0,0 +1,35 @@
+import { getLogger, loadConfig } from "@miqro/core";
+import { createInterface } from "readline";
+import { loadSequelize } from "../utils/db";
+
+export const main = (): void => {
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  loadConfig();
+
+  const logger = getLogger("db:console");
+  const rl = createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  const db = loadSequelize();
+  const questionLoop = () => {
+    rl.question('>', async (query) => {
+      try {
+        logger.info(`${query}`);
+        const [result] = await db.query({
+          query,
+          values: []
+        });
+        logger.info(`${JSON.stringify(result, undefined, 4)}`);
+        questionLoop();
+      } catch (e) {
+        logger.error(e);
+        questionLoop();
+      }
+    });
+  }
+  questionLoop();
+}

package/src/cmds/db-createmodel.ts

@@ -0,0 +1,44 @@
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { templates } from "../utils/templates";
+import { ConfigPathResolver, loadConfig } from "@miqro/core";
+import { loadSequelizeRC } from "../utils/db";
+
+export const main = (): void => {
+  const logger = console;
+  const modelname = process.argv[3];
+
+  if (process.argv.length !== 4) {
+    throw new Error(`arguments: <modelname>`);
+  }
+
+  if (typeof modelname !== "string") {
+    throw new Error(`<modelname> must be a string!`);
+  }
+
+  loadConfig();
+
+  const config = loadSequelizeRC();
+
+  // disable experimental typescript support
+  const typescript = false; //existsSync(resolve(ConfigPathResolver.getBaseDirname(), "tsconfig.json")) ? true : false;
+  const modelsFolder = typescript ? resolve(ConfigPathResolver.getBaseDirname(), "src", "models") : config["models-path"];
+
+  if (!existsSync(modelsFolder)) {
+    logger.warn(`models folder [${modelsFolder}] doesnt exists!`);
+    logger.warn(`creating [${modelsFolder}]!`);
+    mkdirSync(modelsFolder, {
+      recursive: true
+    });
+  }
+
+  const modelPath = resolve(modelsFolder, `${modelname.toLowerCase()}${typescript ? ".ts" : ".js"}`);
+
+  if (existsSync(modelPath)) {
+    throw new Error(`${modelPath} already exists!`);
+  }
+  logger.info(`creating [${modelPath}]!`);
+
+  writeFileSync(modelPath, templates.exampleModel(modelname, typescript));
+
+}

package/src/cmds/db-dump-data.ts

@@ -0,0 +1,44 @@
+import { checkEnvVariables, SimpleMap, loadConfig } from "@miqro/core";
+import { resolve } from "path";
+import { writeFileSync } from "fs";
+import { loadSequelize } from "../utils/db";
+
+export const main = async (): Promise<void> => {
+  const logger = console;
+  const outfile = process.argv[3];
+  if (process.argv.length !== 4) {
+    throw new Error(`[LIMIT_COUNT=100] arguments: <outfile>`);
+  }
+
+  if (typeof outfile !== "string") {
+    throw new Error(`<outfile> must be a string!`);
+  }
+
+  const [LIMIT] = checkEnvVariables(["LIMIT"], ["100"]);
+  const limit = parseInt(LIMIT, 10);
+
+  if (isNaN(limit) || limit <= 0) {
+    throw new Error(`LIMIT must be a number grater than 0!`);
+  }
+
+  loadConfig();
+
+  const db = loadSequelize();
+  const out: SimpleMap<any[]> = {};
+  logger.info(`beware that if the model is not implicitly defined in db.models it will be dumped.`);
+  const models = Object.keys(db.models);
+  for (const modelName of models) {
+    let rows;
+    let offset = 0;
+    out[modelName] = [];
+    while ((rows = await db.models[modelName].findAndCountAll({
+      offset,
+      limit
+    })).rows.length > 0) {
+      out[modelName] = out[modelName].concat(rows.rows);
+      offset += limit;
+    }
+  }
+  await db.close();
+  writeFileSync(resolve(process.cwd(), outfile), JSON.stringify(out, undefined, 2));
+}

package/src/cmds/db-init.ts

@@ -0,0 +1,42 @@
+import { ConfigPathResolver, loadConfig } from "@miqro/core";
+import { existsSync, mkdirSync, writeFileSync } from "fs";
+import { resolve } from "path";
+import { execSync } from "../utils";
+import { initDBConfig } from "../utils/db";
+import { templates } from "../utils/templates";
+
+export const main = (): void => {
+  const logger = console;
+
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  const initEnvFile = (path: string, template: string): void => {
+    if (!existsSync(path)) {
+      logger.warn(`creating ${path} env file`);
+      writeFileSync(path, template);
+    } else {
+      logger.warn(`${path} already exists!. init will not create it.`);
+    }
+  };
+
+  loadConfig();
+
+  if (initDBConfig()) {
+    const configPath = ConfigPathResolver.getConfigDirname();
+    if (!existsSync(configPath)) {
+      logger.warn(`[${configPath}] doesnt exists!`);
+      mkdirSync(configPath, {
+        recursive: true
+      });
+    }
+    initEnvFile(resolve(configPath, `db.env`), templates.dbEnvFile);
+    execSync(
+      `npm install sequelize --save`
+    );
+    execSync(
+      `npm install @miqro/core --save`
+    );
+  }
+};

package/src/cmds/db-makemigrations.ts

@@ -0,0 +1,12 @@
+import { makemigrations } from "../utils/db";
+import { loadConfig } from "@miqro/core";
+
+export const main = (): void => {
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  loadConfig();
+
+  makemigrations();
+}

package/src/cmds/db-push-data.ts

@@ -0,0 +1,77 @@
+import { checkEnvVariables, SimpleMap, loadConfig } from "@miqro/core";
+import { resolve } from "path";
+import { readFileSync } from "fs";
+import { loadSequelize } from "../utils/db";
+
+export const main = async (): Promise<void> => {
+  const outfile = process.argv[3];
+  const models = process.argv[4];
+  if (process.argv.length !== 5) {
+    throw new Error(`[BULK_CREATE_COUNT=10] [BULK_CREATE_IGNORE_ERROR=true] arguments: <outfile> <modelA,..>`);
+  }
+
+  if (typeof outfile !== "string") {
+    throw new Error(`<outfile> must be a string!`);
+  }
+
+  if (typeof models !== "string") {
+    throw new Error(`<modelA,..> must be a list of model names!`);
+  }
+
+  loadConfig();
+
+  const [BULK_CREATE_COUNT, BULK_CREATE_IGNORE_ERROR] = checkEnvVariables(["BULK_CREATE_COUNT", "BULK_CREATE_IGNORE_ERROR"], ["10", "true"]);
+  const bulkCount = parseInt(BULK_CREATE_COUNT, 10);
+
+  if (isNaN(bulkCount) || bulkCount < 0) {
+    throw new Error(`BULK_CREATE_COUNT must be a number grater or equal than 0!`);
+  }
+
+  const modelList = models.split(",").map(o => o.trim());
+
+  const db = loadSequelize();
+  const out: SimpleMap<any[]> = JSON.parse(readFileSync(resolve(process.cwd(), outfile)).toString());
+  for (const modelName of modelList) {
+    if (out[modelName] && db.models[modelName]) {
+      const list = out[modelName].map(i => {
+        const ret: any = {};
+        const attrs = Object.keys(i);
+        for (const a of attrs) {
+          ret[a] = i[a] && i[a].type === "Buffer" ? Buffer.from(i[a]) : i[a];
+        }
+        return ret;
+      });
+      if (bulkCount === 0) {
+        for (const m of list) {
+          try {
+            await db.models[modelName].create(m);
+          } catch(e: any) {
+            if(BULK_CREATE_IGNORE_ERROR === "true") {
+              console.error("error pushing");
+              console.error(e.message);
+              console.error("");
+            } else {
+              throw e;
+            }
+          }
+        }
+      } else {
+        let current;
+        while ((current = list.splice(0, bulkCount)).length > 0) {
+          try {
+            await db.models[modelName].bulkCreate(current);
+          } catch(e: any) {
+            if(BULK_CREATE_IGNORE_ERROR === "true") {
+              console.error("error pushing");
+              console.error(e.message);
+              console.error("");
+            } else {
+              throw e;
+            }
+          }
+        }
+      }
+    }
+  }
+  await db.close();
+}

package/src/cmds/db-sync-makemigrations.ts

@@ -0,0 +1,12 @@
+import { syncMakeMigrations } from "../utils/db";
+import { loadConfig } from "@miqro/core";
+
+export const main = (): void => {
+  if (process.argv.length !== 3) {
+    throw new Error(`invalid number of args`);
+  }
+
+  loadConfig();
+
+  syncMakeMigrations();
+}

package/src/cmds/doc-json.ts

@@ -0,0 +1,16 @@
+import { getLogger, loadConfig } from "@miqro/core";
+import { getDOCJSON } from "../utils/doc";
+
+export const main = (): void => {
+
+  if (process.argv.length !== 5) {
+    throw new Error(`arguments: <api_folder> <subPath>`);
+  }
+
+  const dirname = process.argv[3];
+  const subPath = process.argv[4];
+
+  loadConfig();
+
+  console.log(JSON.stringify(getDOCJSON({ dirname, subPath }, getLogger("miqro")), undefined, 2));
+}