beech-api 3.9.0-beta.9-rc → 3.9.80

package/packages/cli/core/generator/_endpoints_basic

@@ -1,42 +1,42 @@
-{{requireSomething}}
-exports.init = () => {
-
-  // Initiate with Basic request currently support GET, POST, PUT, PATCH and DELETE
-
-  endpoint.get("/{{endpoint}}", Credentials, (req, res) => {
-    // @return
-    res.json({
-      code: 200,
-      status: "SUCCESS",
-      message: "GET request at /{{endpoint}}",
-    });
-  });
-
-  endpoint.post("/{{endpoint}}", Credentials, (req, res) => {
-    let id = req.body.id;
-    let name = req.body.name;
-    // @return
-    res.json({
-      code: 200,
-      message: "POST request at /{{endpoint}}",
-      status: "SUCCESS",
-      result: {
-        id,
-        name,
-      },
-    });
-  });
-
-  endpoint.put("/{{endpoint}}/:id", Credentials, (req, res) => {
-    let id = req.params.id;
-    // @return
-    res.json({
-      code: 200,
-      status: "SUCCESS",
-      message: "PUT request at /{{endpoint}}/" + id,
-    });
-  });
-
-  // Create new Endpoint, Learn more: https://github.com/bombkiml/beech-api?tab=readme-ov-file#part-of-generate-file
-
-};
+{{requireSomething}}
+exports.init = () => {
+
+  // Initiate with Basic request currently support GET, POST, PUT, PATCH and DELETE
+
+  endpoint.get("/{{endpoint}}", Credentials, (req, res) => {
+    // @return
+    res.json({
+      code: 200,
+      status: "SUCCESS",
+      message: "GET request at /{{endpoint}}",
+    });
+  });
+
+  endpoint.post("/{{endpoint}}", Credentials, (req, res) => {
+    let id = req.body.id;
+    let name = req.body.name;
+    // @return
+    res.json({
+      code: 200,
+      message: "POST request at /{{endpoint}}",
+      status: "SUCCESS",
+      result: {
+        id,
+        name,
+      },
+    });
+  });
+
+  endpoint.put("/{{endpoint}}/:id", Credentials, (req, res) => {
+    let id = req.params.id;
+    // @return
+    res.json({
+      code: 200,
+      status: "SUCCESS",
+      message: "PUT request at /{{endpoint}}/" + id,
+    });
+  });
+
+  // Create new Endpoint, Learn more: https://github.com/bombkiml/beech-api?tab=readme-ov-file#part-of-generate-file
+
+};

package/packages/cli/core/generator/_help

@@ -1,19 +1,29 @@
-
-Usage:
-  $ beech [options] [arguments] [special]
-
-Options:
-  ?, -h, --help                       Display this help message.
-  -v, --version                       Display the application version.
-
-The following commands are available:
-
-  $ beech make <endpoint>             Create a new Endpoints and unit test file,
-                                      You might using [special] `-R, --require`
-                                      for choose Model(s) used to endpoint file.
-  $ beech make <model> -M, --model    Create a new Models file.
-  $ beech make <helper> --helper      Create a new Helpers file.
-  $ beech passport init               Initialize authentication with passport-jwt.
-  $ beech skd init                    Initialize Job Scheduler file.
-  $ beech key:generate, key:gen       Re-Generate application key (Dangerous!).
-  $ beech hash:<text>                 Hash text for Access to Database connection.
+
+Usage:
+  $ beech [options] [arguments] [special]
+
+Options:
+  ?, -h, --help                       Display this help message.
+  -v, --version                       Display the application version.
+
+Commands:
+  $ beech make <endpoint>             Create a new Endpoints and unit test file.
+                                      Use [special] `-R, --require` to select Model(s).
+
+  $ beech make <model> --model, -M    Create a new Models file.
+                                      Options:
+                                      --no-comment   Ignore property comments in Schema.
+                                      --name <custom_name>  Rename for the Model file.
+
+  $ beech update model <model_name>   Update existing Model with latest DB structure.
+                                      Options:
+                                      --no-comment   Ignore property comments in Schema.
+                                      --name <custom_name>   Rename for the Model file.
+                                      --inject <table_name>  Update schema to latest,
+                                                             from a specific table name.
+
+  $ beech make <helper> --helper      Create a new Helpers file.
+  $ beech passport init               Initialize authentication with passport-jwt.
+  $ beech skd init                    Initialize Job Scheduler file.
+  $ beech key:generate, key:gen       Re-Generate application key (Dangerous!).
+  $ beech hash:<text>                 Hash text for Database connection access.

package/packages/cli/core/generator/_help_create

@@ -1,11 +1,11 @@
-
-Usage:
-  $ beech-app create <app-name>
-  $ beech-app update [arguments]
-
-Options:
-  ?, -h, --help     Display this help message.
-  -v, --version     Display the application version.update            
-
-Arguments:
+
+Usage:
+  $ beech-app create <app-name>
+  $ beech-app update [arguments]
+
+Options:
+  ?, -h, --help     Display this help message.
+  -v, --version     Display the application version.update            
+
+Arguments:
   -g, --global      Global upgrade The beech-api to latest version.

package/packages/cli/core/generator/_help_service

@@ -1,11 +1,11 @@
-
-Usage:
-  $ beech-service [options] [arguments]
-
-Options:
-  ?, -h, --help         Display this help message.
-  serve                 Start development service.
-  build                 Build production.
-  
-Arguments:
+
+Usage:
+  $ beech-service [options] [arguments]
+
+Options:
+  ?, -h, --help         Display this help message.
+  serve                 Start development service.
+  build                 Build production.
+  
+Arguments:
   -S, --silent          Disabled notify compiler.

package/packages/cli/core/generator/_helpers

@@ -1,10 +1,10 @@
-module.exports = {
-
-  // textUpperCase(text) {
-  //  return text.toUpperCase();
-  // },
-  // textLowerCase(text) {
-  //  return text.toLowerCase();
-  // }
-
+module.exports = {
+
+  // textUpperCase(text) {
+  //  return text.toUpperCase();
+  // },
+  // textLowerCase(text) {
+  //  return text.toLowerCase();
+  // }
+
 };

package/packages/cli/core/generator/_helpers_basic

@@ -1,23 +1,167 @@
-module.exports = {
-
-  textLowerCase(text) {
-   return text.toLowerCase();
-  },
-
-  textUpperCase(text) {
-   return text.toUpperCase();
-  },
-
-  digit9(number) {
-    return ('000000000' + number).slice(-9);
-  },
-
-  dateToThai(date) {
-    return result = date.toLocaleDateString('th-TH', {
-      year: 'numeric',
-      month: 'long',
-      day: 'numeric',
-    });
-  },
-
+module.exports = {
+  // --- 1. Text & String Utilities ---
+  textLowerCase(text) {
+    return text ? text.toLowerCase() : '';
+  },
+
+  textUpperCase(text) {
+    return text ? text.toUpperCase() : '';
+  },
+
+  capitalize(text) {
+    if (!text) return '';
+    return text.charAt(0).toUpperCase() + text.slice(1);
+  },
+
+  slugify(text) {
+    return text
+      .toString()
+      .toLowerCase()
+      .trim()
+      .replace(/\s+/g, '-')
+      .replace(/[^\w-]+/g, '')
+      .replace(/--+/g, '-');
+  },
+
+  stripHtmlTags(str) {
+    if (!str) return '';
+    return str.replace(/<[^>]*>?/gm, '');
+  },
+
+  // --- 2. Number & ID Utilities ---
+  digit9(number) {
+    return ('000000000' + number).slice(-9);
+  },
+
+  formatCurrency(number) {
+    return new Intl.NumberFormat('th-TH', { style: 'currency', currency: 'THB' }).format(number);
+  },
+
+  toNumber(value, defaultValue = 0) {
+    const num = Number(value);
+    return isNaN(num) ? defaultValue : num;
+  },
+
+  formatBytes(bytes, decimals = 2) {
+    if (bytes === 0) return '0 Bytes';
+    const k = 1024;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    return parseFloat((bytes / Math.pow(k, i)).toFixed(decimals)) + ' ' + sizes[i];
+  },
+
+  // --- 3. Date & Time Utilities ---
+  dateToThai(date) {
+    const d = new Date(date);
+    return d.toLocaleDateString('th-TH', { year: 'numeric', month: 'long', day: 'numeric' });
+  },
+
+  formatDateISO(date = new Date()) {
+    return new Date(date).toISOString().split('T')[0];
+  },
+
+  calculateAge(birthDate) {
+    const birth = new Date(birthDate);
+    const today = new Date();
+    let age = today.getFullYear() - birth.getFullYear();
+    const monthDiff = today.getMonth() - birth.getMonth();
+    if (monthDiff < 0 || (monthDiff === 0 && today.getDate() < birth.getDate())) {
+      age--;
+    }
+    return age;
+  },
+
+  addDays(date, days) {
+    const result = new Date(date);
+    result.setDate(result.getDate() + days);
+    return result;
+  },
+
+  isWeekend(date) {
+    const day = new Date(date).getDay();
+    return day === 0 || day === 6;
+  },
+
+  getTimestamp() {
+    return new Date().toISOString();
+  },
+
+  // --- 4. Object & Logic Utilities ---
+  isEmpty(value) {
+    return (
+      value === null ||
+      value === undefined ||
+      (typeof value === 'string' && value.trim() === '') ||
+      (Array.isArray(value) && value.length === 0) ||
+      (typeof value === 'object' && Object.keys(value).length === 0)
+    );
+  },
+
+  removeEmptyFields(obj) {
+    return Object.fromEntries(
+      Object.entries(obj).filter(([_, v]) => v != null)
+    );
+  },
+
+  pick(obj, keys) {
+    return keys.reduce((acc, key) => {
+      if (obj && Object.prototype.hasOwnProperty.call(obj, key)) {
+        acc[key] = obj[key];
+      }
+      return acc;
+    }, {});
+  },
+
+  safeJsonParse(jsonString, defaultValue = {}) {
+    try {
+      return JSON.parse(jsonString);
+    } catch (e) {
+      return defaultValue;
+    }
+  },
+
+  delay(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+  },
+
+  // --- 5. Web & API Utilities ---
+  jsonResponse(res, statusCode, message, data = null) {
+    return res.status(statusCode).json({
+      success: statusCode >= 200 && statusCode < 300,
+      message,
+      data,
+      timestamp: new Date().toISOString()
+    });
+  },
+
+  getQueryParam(req, key, defaultValue = null) {
+    return req.query[key] || defaultValue;
+  },
+
+  isEmail(email) {
+    const regex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return regex.test(email);
+  },
+
+  toBoolean(value) {
+    if (typeof value === 'boolean') return value;
+    if (typeof value === 'string') {
+      return ['true', '1', 'yes', 'on'].includes(value.toLowerCase());
+    }
+    return !!value;
+  },
+
+  generateRandomString(length = 16) {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < length; i++) {
+      result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+  },
+
+  isImageFile(filename) {
+    const ext = filename.split('.').pop().toLowerCase();
+    return ['jpg', 'jpeg', 'png', 'gif', 'webp'].includes(ext);
+  }
 };

package/packages/cli/core/generator/_models

@@ -1,6 +1,6 @@
-const { Schema } = require("beech-api");
-// {{modelNameUppercase}} structure
-{{modelStructure}}
-// Asign more DataTypes, Learn more: https://sequelize.org/docs/v6/core-concepts/model-basics/#data-types
-
-module.exports = { {{modelNameUppercase}} };
+const { Schema } = require("beech-api");
+// {{modelNameUppercase}} structure
+{{modelStructure}}
+// Asign more DataTypes, Learn more: https://sequelize.org/docs/v6/core-concepts/model-basics/#data-types
+
+module.exports = { {{modelNameUppercase}} };

package/packages/cli/core/generator/_models_basic

@@ -1,14 +1,14 @@
-module.exports = {
-
-  // Example basic function get data from table {{modelName}}
-  findAll() {
-    return new Promise((resolve, reject) => {
-      // calling Pool connection name by `sql.{{dbSelected}}`
-      sql.{{dbSelected}}.query("SELECT * FROM {{modelName}}", (err, results) => {
-        if (err) reject(err);
-        resolve(results);
-      });
-    });
-  },
-
+module.exports = {
+
+  // Example basic function get data from table {{modelName}}
+  findAll() {
+    return new Promise((resolve, reject) => {
+      // calling Pool connection name by `sql.{{dbSelected}}`
+      sql.{{dbSelected}}.query("SELECT * FROM {{modelName}}", (err, results) => {
+        if (err) reject(err);
+        resolve(results);
+      });
+    });
+  },
+
 }

package/packages/cli/core/generator/_package

@@ -1,20 +1,24 @@
-{
-  "name": "application",
-  "version": "0.1.0",
-  "description": "The project is powered by Beech API framework",
-  "license": "MIT",
-  "main": "index.js",
-  "scripts": {
-    "predev": "node ./node_modules/beech-api/packages/cli/core/test/check-node.js",
-    "prebuild": "node ./node_modules/beech-api/packages/cli/core/test/check-node.js",
-    "build": "set NODE_ENV=production&& beech-service build",
-    "dev": "beech-service serve",
-    "test": "node ./node_modules/jest/bin/jest __tests__ -o --watch --config"
-  },
-  "dependencies": {
-    "beech-api": "^3.9.0"
-  },
-  "devDependencies": {
-    "jest": "^29.7.0"
-  }
+{
+  "name": "application",
+  "version": "0.1.0",
+  "description": "The project is powered by Beech API framework",
+  "license": "MIT",
+  "main": "index.js",
+  "scripts": {
+    "predev": "node ./node_modules/beech-api/packages/cli/core/test/check-node.js",
+    "prebuild": "node ./node_modules/beech-api/packages/cli/core/test/check-node.js",
+    "build": "set NODE_ENV=production&& beech-service build",
+    "dev": "beech-service serve",
+    "test": "node ./node_modules/jest/bin/jest __tests__ -o --watch --config"
+  },
+  "dependencies": {
+    "beech-api": "^3.9.0"
+  },
+  "devDependencies": {
+    "jest": "^30.2.0"
+  },
+  "overrides": {
+    "cross-spawn": "^7.0.5",
+    "lru.min": "1.1.1"
+  }
 }

package/packages/cli/core/generator/_scheduler

@@ -1,32 +1,32 @@
-const CronJob = require("cron").CronJob;
-//const Users = require("@/models/Users");
-
-exports.init = () => {
-
-  /**
-   * TODO something.
-   *
-   */
-
-  // const getUsers = async () => {
-  //   try {
-  //     const users = await Users.findAll();
-  //     console.log(users);
-  //   } catch (error) {
-  //     console.error(error);
-  //   }
-  // };
-
-  /**
-   * Job schedule: seconds minutes hours dayOfMonth month dayOfWeek
-   * Learn more: https://github.com/kelektiv/node-cron
-   * 
-   */
-  new CronJob("0 0 0 * * *", () => {
-    // Run job.
-
-    // getUsers();
-
-  }, null, true, "Asia/Bangkok");
-
-};
+const CronJob = require("cron").CronJob;
+//const Users = require("@/models/Users");
+
+exports.init = () => {
+
+  /**
+   * TODO something.
+   *
+   */
+
+  // const getUsers = async () => {
+  //   try {
+  //     const users = await Users.findAll();
+  //     console.log(users);
+  //   } catch (error) {
+  //     console.error(error);
+  //   }
+  // };
+
+  /**
+   * Job schedule: seconds minutes hours dayOfMonth month dayOfWeek
+   * Learn more: https://github.com/kelektiv/node-cron
+   * 
+   */
+  new CronJob("0 0 0 * * *", () => {
+    // Run job.
+
+    // getUsers();
+
+  }, null, true, "Asia/Bangkok");
+
+};

package/packages/cli/core/generator/_spec

@@ -1,30 +1,30 @@
-const endpoint = baseUrl.concat("/{{endpoint}}");
-/**
- * An asynchronous test will fail after 5000 ms if done() is not called.
- * This timeout can be changed by setting TIMEOUT_INTERVAL or by passing
- * a timeout interval in the specification.
- *
- */
-
-describe("Test endpoint : " + endpoint, () => {
-  it("Truthy!", () => {
-    expect("{{endpoint}}").toBeTruthy();
-  });
-
-  it("Say hello!", () => {
-    expect("Hello {{endpointName}}").toEqual("Hello {{endpointName}}");
-  });
-
-  it("Respond with basic GET status code 200", (done) => {
-    axios
-      .get(endpoint)
-      .then((res) => {
-        expect(200).toEqual(res.data.code);
-        done();
-      })
-      .catch(() => {
-        expect(401).toEqual(401);
-        done();
-      });
-  });
+const endpoint = baseUrl.concat("/{{endpoint}}");
+/**
+ * An asynchronous test will fail after 5000 ms if done() is not called.
+ * This timeout can be changed by setting TIMEOUT_INTERVAL or by passing
+ * a timeout interval in the specification.
+ *
+ */
+
+describe("Test endpoint : " + endpoint, () => {
+  it("Truthy!", () => {
+    expect("{{endpoint}}").toBeTruthy();
+  });
+
+  it("Say hello!", () => {
+    expect("Hello {{endpointName}}").toEqual("Hello {{endpointName}}");
+  });
+
+  it("Respond with basic GET status code 200", (done) => {
+    axios
+      .get(endpoint)
+      .then((res) => {
+        expect(200).toEqual(res.data.code);
+        done();
+      })
+      .catch(() => {
+        expect(401).toEqual(401);
+        done();
+      });
+  });
 });