ask-ai-orbit 1.0.1

package/Foundation/Helpers/date.helper.js

@@ -0,0 +1,154 @@
+
+export const formatDateToMySQL = (date) => {
+  const pad = (n) => n.toString().padStart(2, '0');
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())} ` +
+    `${pad(date.getHours())}:${pad(date.getMinutes())}:${pad(date.getSeconds())}`;
+};
+
+
+/**
+ * Format JS Date or string as YYYYMMDD
+ * @param {Date|string} d
+ * @returns {string}
+ */
+
+export const newDate = (s, f) => {
+  if (typeof s !== 'string') throw new Error('Input must be a string');
+  const m = s.match(/\d+/g);
+  const t = f.match(/YYYY|MM|DD|HH|mm|ss/g);
+  const o = Object.fromEntries(t.map((k, i) => [k, +m[i]]));
+  return new Date(o.YYYY || 0, (o.MM || 1) - 1, o.DD || 1, o.HH || 0, o.mm || 0, o.ss || 0);
+};
+
+export const ArrayBetDatesPlusOne = (startDate, endDate, formatStr = "YYYY-MM-DD") => {
+  const result = [];
+  for (let d = new Date(startDate); d <= new Date(endDate); d.setDate(d.getDate() + 1))
+    result.push(format(new Date(d), formatStr));
+  return result;
+};
+
+export const isDateArrobjDatabykey = (objArr, key) =>objArr.filter(x => Number.isNaN(new Date(x[key]).getTime()));
+
+
+export const getDateparse = (result, key, formatStr) => {
+  for (const x of result)
+    if (!IsNullOrEmpty(x[key]))
+      x[key] = format(x[key], formatStr);
+};
+
+export const getDateparsewithformat = (result, key, formatStr) => {
+  for (const x of result) {
+    if (!IsNullOrEmpty(x[key])) {
+      const d = new Date(x[key]);
+      if (!Number.isNaN(d.getTime()))
+        x[key] = format(d, formatStr);
+      else {
+        blog.error(`Invalid date: ${x[key]}`);
+        x[key] = null;
+      }
+    }
+  }
+};
+
+
+
+export const isValidDateOrTime = (value) => {
+  if (!value) return false;
+
+  // 🔹 TIME ONLY (10:00:00)
+  const timeRegex = /^([01]\d|2[0-3]):[0-5]\d:[0-5]\d$/;
+  if (timeRegex.test(value)) return true;
+
+  // 🔹 DATE ONLY or DATETIME
+  const normalized = value.replace(' ', 'T');
+
+  const date = new Date(normalized);
+  return !isNaN(date.getTime());
+};
+
+
+
+
+/**
+ * Parse a date string in any common format and return it in the desired format.
+ * Supported input: '2025/01/10 00:00:00', '2025-01-10 00:00:00', '20250110 00:00:00', '10/01/2025 00:00:00', etc.
+ * @param {string} dateString - The input date string.
+ * @param {string} outputFormat - The desired output format, e.g. 'YYYY-MM-DD HH:mm:ss', 'YYYY/MM/DD HH:mm:ss', 'DD/MM/YYYY HH:mm:ss', 'DD-MM-YYYY HH:mm:ss'
+ * @returns {string|null}
+ */
+
+export const parseDate = (value, format = "YYYY-MM-DD HH:mm:ss") => {
+    if (!value || !format) return null;
+
+    const tokens = format.match(/YYYY|MM|DD|HH|mm|ss/g);
+    const numbers = String(value).match(/\d+/g);
+
+    if (!tokens || !numbers || tokens.length !== numbers.length)
+        return null;
+
+    const obj = {};
+
+    tokens.forEach((t, i) => obj[t] = Number(numbers[i]));
+
+    const d = new Date(
+        obj.YYYY ?? 0,
+        (obj.MM ?? 1) - 1,
+        obj.DD ?? 1,
+        obj.HH ?? 0,
+        obj.mm ?? 0,
+        obj.ss ?? 0
+    );
+
+    return d.getFullYear() === (obj.YYYY ?? d.getFullYear()) &&
+           d.getMonth() === (obj.MM ?? 1) - 1 &&
+           d.getDate() === (obj.DD ?? 1) &&
+           d.getHours() === (obj.HH ?? 0) &&
+           d.getMinutes() === (obj.mm ?? 0) &&
+           d.getSeconds() === (obj.ss ?? 0)
+        ? d
+        : null;
+};
+
+export const convertDateFormat = (value, fromFormat, toFormat = "YYYY-MM-DD HH:mm:ss") => {
+    const d = parseDate(value, fromFormat);
+    return d ? formatDate(d, toFormat) : null;
+};
+
+
+export const formatDate = (value, format = "YYYY-MM-DD HH:mm:ss", inputFormat) => {
+    const d = inputFormat ? parseDate(value, inputFormat) : new Date(value);
+
+    if (!d || Number.isNaN(d.getTime()))
+        return null;
+
+    const pad = n => String(n).padStart(2, "0");
+
+    return format.replace(/YYYY|MM|DD|HH|mm|ss/g, t => ({
+        YYYY: d.getFullYear(),
+        MM: pad(d.getMonth() + 1),
+        DD: pad(d.getDate()),
+        HH: pad(d.getHours()),
+        mm: pad(d.getMinutes()),
+        ss: pad(d.getSeconds())
+    })[t]);
+};
+
+export const isValidDate = d => !Number.isNaN(new Date(d).getTime());
+
+export const addDays = (d, n) => (d = new Date(d), d.setDate(d.getDate() + n), d);
+
+export const addMonths = (d, n) => (d = new Date(d), d.setMonth(d.getMonth() + n), d);
+
+export const addYears = (d, n) => (d = new Date(d), d.setFullYear(d.getFullYear() + n), d);
+
+export const addHours = (d, n) => (d = new Date(d), d.setHours(d.getHours() + n), d);
+
+export const addMinutes = (d, n) => (d = new Date(d), d.setMinutes(d.getMinutes() + n), d);
+
+export const addSeconds = (d, n) => (d = new Date(d), d.setSeconds(d.getSeconds() + n), d);
+
+export const isBefore = (a, b) => new Date(a) < new Date(b);
+
+export const isAfter = (a, b) => new Date(a) > new Date(b);
+
+export const isSameDay = (a, b) => format(a, "YYYYMMDD") === format(b, "YYYYMMDD");

package/Foundation/Helpers/html.helper.js

@@ -0,0 +1,39 @@
+const entities = {
+  '&': '&',
+  '<': '&lt;',
+  '>': '&gt;',
+  '"': '&quot;',
+  "'": '&#39;',
+  '©': '&copy;',
+  '®': '&reg;',
+  '™': '&trade;',
+  '€': '&euro;',
+  '£': '&pound;',
+  '¥': '&yen;',
+  '¢': '&cent;'
+};
+
+
+export const htmlEncode = s => String(s ?? '').replace(/[&<>"'©®™€£¥¢]/g, c => entities[c]);
+
+export const createCells = (obj, tag = "td") =>
+  Object.values(obj).map(v => `<${tag}>${v ?? ""}</${tag}>`).join("");
+
+export const createHeaders = obj =>
+  Object.keys(obj).map(k => `<th>${k}</th>`).join("");
+
+export const createHTML = (data, attrs = {}, before = "") =>
+  !Array.isArray(data) || !data.length
+    ? ""
+    : `${before}<table ${Object.entries(attrs).map(([k, v]) => `${k}="${v}"`).join(" ")}>
+        <thead><tr>${createHeaders(data[0])}</tr></thead>
+        <tbody>${data.map(r => `<tr>${createCells(r)}</tr>`).join("")}</tbody>
+      </table>`;
+
+
+
+export const processTemplateHtml = (html, { forJsonStorage = true, escapeHtml = false } = {}) =>
+  String(html ?? "")
+    .replace(forJsonStorage ? /[\r\n\t\f]/g : /$^/, c => ({ "\r": "\\r", "\n": "\\n", "\t": "\\t", "\f": "\\f" }[c]))
+    .replace(forJsonStorage ? /(?<!\\)["']/g : /$^/, c => `\\${c}`)
+    .replace(escapeHtml ? /[&<>"']/g : /$^/, c => entities[c]);

package/Foundation/Helpers/object.helper.js

@@ -0,0 +1,15 @@
+import {lowerCase,upperCase,sentenceCase,titleCase,camelCase,pascalCase,snakeCase,kebabCase } from "./string.helper";
+
+export const normalizeKey = (key, type = "lower", separator = "") => ({
+  lower: lowerCase,
+  upper: upperCase,
+  sentence: sentenceCase,
+  title: titleCase,
+  camel: camelCase,
+  pascal: pascalCase,
+  snake: snakeCase,
+  kebab: kebabCase
+}[type]?.(key)?.replace(/[\s_-]+/g, separator) ?? key);
+
+export const normalizeObjectKeys = (obj, type = "lower", separator = "") =>
+    Object.fromEntries(Object.entries(obj).map(([k, v]) => [normalizeKey(k, type, separator), v]));

package/Foundation/Helpers/placeholder.helper.js

@@ -0,0 +1,3 @@
+export const mapPlaceholdersToIndexes = s => String(s || '').replace(/\{([^{}]+)\}/g, ((m, i) => (a, b) => ((b = b.trim()), !b ? a : /^\d+$/.test(b) ? `{${b}}` : `{${m.has(b) ? m.get(b) : (m.set(b, i++), m.get(b))}}`))(new Map(), 0));
+
+export const mapIndexesToValues = (s, paramArr) => String(s || '').replace(/\{(\d+)\}/g, (m, i) => paramArr[Number(i)] || '');

package/Foundation/Helpers/string.helper.js

@@ -0,0 +1,114 @@
+import { IsNullOrEmpty } from "./validation.helper";
+
+export const ReturnValidString = (x) => !IsNullOrEmpty(x) ? String(x) : '';
+
+export const trimRAndLSpaces = str => (typeof str === 'string' ? str.trim() : str);
+
+export const stripHtmlTags = input => typeof input === 'string' ? input.replace(/<[^>]+>/g, '') : input;
+
+
+export const stringToBoolean = s => typeof s !== "string" ? s : ({true:1,yes:1,1:1,false:0,no:0,0:0}[s.trim().toLowerCase()] ?? !!s);
+
+export const findAllOccurence = (str, search) => { const r = new RegExp(search, "gi"), a = []; for (let m; (m = r.exec(str));) a.push(m.index); return a; };
+
+
+
+export const keypattern = (arr, pattern = '@', wrap = true) => {
+  return arr.map(key =>
+    wrap ? `${pattern}${key}${pattern}` : `${pattern}${key}`
+  );
+};
+
+export const str_replaceReg = (str, searchArr, replacement, isKeyPair = false) => {
+  const escapeRegExp = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+
+  let result = str;
+
+  for (let i = 0; i < searchArr.length; i++) {
+    const key = searchArr[i];
+    const value = isKeyPair ? replacement[key] : replacement[i];
+
+    result = result.replace(new RegExp(escapeRegExp(key), 'gi'), value);
+  }
+
+  return result;
+};
+
+
+
+/**
+ * Replace placeholders in a string using either an array or an object via str_replaceReg.
+ * - If replacements is an object, set isKeyPair=true to map keys to values.
+ * - If replacements is an array, provide searchArr and replacementArr in order.
+ * @param {string} original - Source string
+ * @param {Array|string|Object} searchOrReplacements - Array of search terms or an object of key->value
+ * @param {Array} [replacementArr] - Array of replacement values (used when searchOrReplacements is Array)
+ * @param {boolean} [isKeyPair=false] - Treat replacements as key-value pairs (object mode)
+ * @param {string} [pattern='@'] - Placeholder wrapper, e.g., '@key@'
+ * @param {boolean} [isBeforeAfter=true] - Wrap search tokens with pattern before and after
+ * @returns {string}
+ */
+export const replaceDollarPlaceholders = (input, search, startIndex = 0) => {
+  if (typeof input !== 'string') return input;
+
+  const tokens = Array.isArray(search) ? search : [search];
+
+  const escape = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+  const regex = new RegExp(tokens.map(escape).join('|'), 'g');
+
+  if (startIndex === -1) {
+    const matches = [];
+    let m;
+
+    while ((m = regex.exec(input)) !== null) {
+      matches.push({ index: m.index, match: m[0] });
+    }
+
+    return matches;
+  }
+
+  let counter = startIndex;
+
+  return input.replace(regex, () => {
+    counter += 1;
+    return `$${counter}`;
+  });
+};
+
+
+export const strRepArrORJsonObj = (
+  originalStr,
+  obj,
+  isKeyPair = false,
+  pattern = '@',
+  wrap = true
+) => {
+  const keys = _.keys(obj);
+
+  const searchArr = keypattern(keys, pattern, wrap);
+
+  return str_replaceReg(
+    originalStr,
+    searchArr,
+    obj,
+    isKeyPair
+  );
+};
+
+const words = s => String(s ?? '').trim().match(/[A-Za-z0-9]+/g) || [];
+
+export const upperCase    = s => String(s ?? '').toUpperCase();
+
+export const lowerCase    = s => String(s ?? '').toLowerCase();
+
+export const sentenceCase = s => (s = String(s ?? '').trim(), s ? s[0].toUpperCase() + s.slice(1).toLowerCase() : '');
+
+export const titleCase    = s => words(s).map(w => w[0].toUpperCase() + w.slice(1).toLowerCase()).join(' ');
+
+export const camelCase    = s => words(s).map((w, i) => i ? w[0].toUpperCase() + w.slice(1).toLowerCase() : w.toLowerCase()).join('');
+
+export const pascalCase   = s => words(s).map(w => w[0].toUpperCase() + w.slice(1).toLowerCase()).join('');
+
+export const snakeCase    = s => words(s).map(w => w.toLowerCase()).join('_');
+
+export const kebabCase    = s => words(s).map(w => w.toLowerCase()).join('-');

package/Foundation/Helpers/time.helper.js

@@ -0,0 +1,83 @@
+// Foundation/Helpers/time.helper.js
+
+// -------------------------------
+// CURRENT TIME
+// -------------------------------
+export const now = () => new Date();
+
+export const timestamp = () => Date.now();
+
+// -------------------------------
+// FORMAT DATE
+// -------------------------------
+export const format = (d,f="YYYY-MM-DD HH:mm:ss") => {
+  d=new Date(d);
+  const p=n=>String(n).padStart(2,"0");
+  return f.replace(/YYYY|MM|DD|HH|mm|ss/g,k=>({
+    YYYY:d.getFullYear(),
+    MM:p(d.getMonth()+1),
+    DD:p(d.getDate()),
+    HH:p(d.getHours()),
+    mm:p(d.getMinutes()),
+    ss:p(d.getSeconds())
+  }[k]));
+};
+// -------------------------------
+// TIME DIFFERENCE
+// -------------------------------
+export const timeDifference = (a,b=new Date()) => {
+  const d=Math.abs(new Date(b)-new Date(a));
+  return {
+    milliseconds:d,
+    seconds:Math.floor(d/1e3),
+    minutes:Math.floor(d/6e4),
+    hours:Math.floor(d/36e5),
+    days:Math.floor(d/864e5)
+  };
+};
+
+// -------------------------------
+// TIME AGO
+// -------------------------------
+export const timeAgo = d => {
+  const s=Math.floor((Date.now()-new Date(d))/1e3);
+  const m=s/60|0,h=m/60|0,da=h/24|0,mo=da/30|0,y=da/365|0;
+  return s<60?`${s}s ago`:m<60?`${m}m ago`:h<24?`${h}h ago`:da<30?`${da}d ago`:mo<12?`${mo}mo ago`:`${y}y ago`;
+};
+
+// -------------------------------
+// ADD TIME
+// -------------------------------
+export const addTime = (d,{seconds=0,minutes=0,hours=0,days=0}) =>
+  new Date(new Date(d).setSeconds(new Date(d).getSeconds()+seconds)
+    +minutes*6e4+hours*36e5+days*864e5);
+
+// -------------------------------
+// SUBTRACT TIME
+// -------------------------------
+export const subtractTime = (d,v) =>
+  addTime(d,{seconds:-(v.seconds||0),minutes:-(v.minutes||0),hours:-(v.hours||0),days:-(v.days||0)});
+
+// -------------------------------
+// CHECKS
+// -------------------------------
+export const isExpired = d => new Date(d) < Date.now();
+export const isFuture = d => new Date(d) > Date.now();
+// -------------------------------
+// START / END OF DAY
+// -------------------------------
+export const startOfDay = (d=new Date()) => (d=new Date(d),d.setHours(0,0,0,0),d);
+
+export const endOfDay = (d=new Date()) => (d=new Date(d),d.setHours(23,59,59,999),d);
+
+// -------------------------------
+// DURATION (ms → breakdown)
+// -------------------------------
+export const duration = ms => ({
+  seconds:Math.floor(ms/1e3),
+  minutes:Math.floor(ms/6e4),
+  hours:Math.floor(ms/36e5),
+  days:Math.floor(ms/864e5)
+});
+
+export const sleep = (h = 0, m = 0, s = 0) => new Promise(r => setTimeout(r, (h * 3600 + m * 60 + s) * 1000));

package/Foundation/Helpers/validation.helper.js

@@ -0,0 +1,11 @@
+
+export const isUndefined = (x) =>typeof x === undefined;
+
+export const isEmpty = value => value == null ? true : ((typeof value === 'string' || Array.isArray(value)) ? value.length === 0 : Object.keys(value).length === 0);
+
+export const IsNullOrEmpty = x => (isUndefined(x) || x === null || x === false || x === "" || (typeof x === 'number' ? isNaN(x) : isEmpty(x)) || x.length === 0 || (x?.length === 'number' && x.length === 0) || (typeof x === 'string' && x.trim().length === 0));
+
+export const IsNullOrEmptyNZero = x => (isUndefined(x) || x === null || x === false || x === "" || (typeof x === 'number' ? x == 0 ? true : isEmpty(x) : x === '') || (x?.length === 'number' && x.length === 0 || (typeof x === 'string' && x.trim().length === 0)));
+
+export const IsEmpty = x => (isUndefined(x) || x === false || x === "" || x.length === 0);
+

package/README.md

@@ -0,0 +1,2 @@
+# AskAIOrbit
+Since this has evolved beyond just a utility library and now includes:  SQL Query Builder ORM-like CRUD Auto SQL Generator Auto Index Optimizer Schema Validation Retry Framework Connection Pooling Database Engine HTML/CSV Utilities Security Utilities Response Builder Template Engine Notification Helpers

package/create-askaiorbit.sh

@@ -0,0 +1,129 @@
+#!/bin/bash
+
+PROJECT="AskAIOrbit"
+
+echo "Creating $PROJECT structure..."
+
+mkdir -p "$PROJECT"
+cd "$PROJECT" || exit
+
+############################################
+# CORE
+############################################
+mkdir -p Core/{Bootstrap,Configuration,Environment,CLI,PluginManager,ServiceContainer}
+
+############################################
+# FOUNDATION
+############################################
+mkdir -p Foundation/Helpers
+mkdir -p Foundation/{Constants,Enums,Exceptions,Types}
+
+touch Foundation/Helpers/array.helper.js
+touch Foundation/Helpers/object.helper.js
+touch Foundation/Helpers/string.helper.js
+touch Foundation/Helpers/number.helper.js
+touch Foundation/Helpers/date.helper.js
+touch Foundation/Helpers/time.helper.js
+touch Foundation/Helpers/random.helper.js
+touch Foundation/Helpers/file.helper.js
+touch Foundation/Helpers/csv.helper.js
+touch Foundation/Helpers/html.helper.js
+touch Foundation/Helpers/json.helper.js
+touch Foundation/Helpers/ip.helper.js
+touch Foundation/Helpers/validation.helper.js
+touch Foundation/Helpers/request.helper.js
+touch Foundation/Helpers/response.helper.js
+touch Foundation/Helpers/pagination.helper.js
+touch Foundation/Helpers/collection.helper.js
+touch Foundation/Helpers/map.helper.js
+touch Foundation/Helpers/conversion.helper.js
+touch Foundation/Helpers/search.helper.js
+touch Foundation/Helpers/utility.helper.js
+
+############################################
+# DATABASE
+############################################
+mkdir -p Database/{ORM,Models,Repository,Schema,Migration,Seeder,Drivers}
+mkdir -p Database/QueryBuilder
+mkdir -p Database/Persistence
+mkdir -p Database/Execution
+mkdir -p Database/Connection
+
+touch Database/QueryBuilder/query.builder.js
+touch Database/QueryBuilder/where.builder.js
+touch Database/QueryBuilder/join.builder.js
+touch Database/QueryBuilder/sql.generator.js
+touch Database/QueryBuilder/metadata.parser.js
+
+touch Database/Persistence/persist.js
+touch Database/Persistence/bulkInsert.js
+touch Database/Persistence/bulkUpdate.js
+touch Database/Persistence/bulkDelete.js
+
+touch Database/Execution/executeQuery.js
+touch Database/Execution/executeWithRetry.js
+touch Database/Execution/postgres.executor.js
+touch Database/Execution/mysql.executor.js
+touch Database/Execution/transaction.manager.js
+
+touch Database/Connection/pool.manager.js
+touch Database/Connection/connection.manager.js
+touch Database/Connection/retry.framework.js
+
+############################################
+# SECURITY
+############################################
+mkdir -p Security/{Authentication,Authorization,Encryption,JWT,Audit,RateLimiter,Sanitizer,SQLProtection,XSSProtection,Validation}
+
+############################################
+# COMMUNICATION
+############################################
+mkdir -p Communication/{SMS,Notification,Queue,WhatsApp,WebSocket}
+mkdir -p Communication/Email
+
+touch Communication/Email/template.engine.js
+touch Communication/Email/html.processor.js
+touch Communication/Email/mail.sender.js
+touch Communication/Email/template.builder.js
+
+############################################
+# HTTP
+############################################
+mkdir -p HTTP/{Request,Response,Middleware,Pagination,API,StatusCodes}
+
+############################################
+# DATA PROCESSING
+############################################
+mkdir -p DataProcessing/{Excel,PDF,Reports,Import,Export}
+mkdir -p DataProcessing/CSV
+
+touch DataProcessing/CSV/csv.reader.js
+touch DataProcessing/CSV/csv.writer.js
+touch DataProcessing/CSV/csv.importer.js
+touch DataProcessing/CSV/csv.exporter.js
+
+############################################
+# AI
+############################################
+mkdir -p AI/{DocumentationAI,QueryAI,CodeGenAI,ReviewAI,RefactorAI,TestAI,MigrationAI,ChatAI}
+
+############################################
+# ENTERPRISE
+############################################
+mkdir -p Enterprise/{ERP,CRM,HRMS,Inventory,P​​OS,Accounting,Payroll}
+
+############################################
+# DEVELOPER
+############################################
+mkdir -p Developer/{Logger,Scheduler,Storage,Cache,Monitoring,Testing,Benchmark,Debugger}
+
+############################################
+# CLOUD
+############################################
+mkdir -p Cloud/{Docker,Kubernetes,AWS,Azure,GCP,CICD}
+
+echo ""
+echo "✔ AskAIOrbit structure created successfully"
+echo ""
+
+tree .

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "ask-ai-orbit",
+  "version": "1.0.1",
+  "description": "enterprise orbit ai",
+  "main": "app.js",
+  "scripts": {
+    "test": "node app.js"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kaiyumnadaf/AskAIOrbit.git"
+  },
+  "keywords": [
+    "backend",
+    "application",
+    "framework"
+  ],
+  "author": "Kaiyum Nadaf",
+  "license": "ISC",
+  "bugs": {
+    "url": "https://github.com/kaiyumnadaf/AskAIOrbit/issues"
+  },
+  "homepage": "https://github.com/kaiyumnadaf/AskAIOrbit#readme"
+}