@skalfa/skalfa-api-core 1.0.3 → 1.0.8

package/src/conversion/conversion.ts

@@ -1,65 +1,91 @@
-export const conversion = {
-
-  // =============================>
-  // ## Conversion: String formatter 
-  // =============================>
-  strSnake(value: string, delimiter: string = "_"): string {
-    return toWords(value).join(delimiter)
-  },
-
-  strSlug(value: string, delimiter: string = "-"): string {
-    return toWords(value).join(delimiter);
-  },
-
-  strCamel(value: string, delimiter: string = ""): string {
-    return toWords(value).map((w, i) => i === 0 ? w : w[0].toUpperCase() + w.slice(1)).join(delimiter);
-  },
-
-  strPascal(value: string, delimiter: string = ""): string {
-    return toWords(value).map(w => w[0].toUpperCase() + w.slice(1)).join(delimiter);
-  },
-
-  strPlural(value: string): string {
-    const match = value.match(/^(.*?)([A-Za-z]+)$/)
-    if (!match) return value
-
-    const [, prefix, word] = match
-
-    if (word.endsWith("y") && !/[aeiou]y$/i.test(word)) {
-      return prefix + word.slice(0, -1) + "ies"
-    }
-
-    if (!word.endsWith("s")) return prefix + word + "s"
-
-    return value
-  },
-
-  strSingular(value: string): string {
-    const match = value.match(/^(.*?)([A-Za-z]+)$/)
-    if (!match) return value
-
-    const [, prefix, word] = match
-
-    if (word.endsWith("ies")) {
-      return prefix + word.slice(0, -3) + "y"
-    }
-
-    if (word.endsWith("s") && !word.endsWith("ss")) {
-      return prefix + word.slice(0, -1)
-    }
-
-    return value
-  }
-};
-
-
-
-function toWords(value: string): string[] {
-  return value
-    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
-    .replace(/[_\-\s]+/g, " ")
-    .trim()
-    .toLowerCase()
-    .split(" ")
-    .filter(Boolean)
+import { date } from './date'
+
+export const conversion = {
+  // =====================================>
+  // ## Conversion: format string to snake case
+  // =====================================>
+  strSnake(value: string, delimiter: string = "_"): string {
+    return toWords(value).join(delimiter)
+  },
+
+  // =====================================>
+  // ## Conversion: format string to slug
+  // =====================================>
+  strSlug(value: string, delimiter: string = "-"): string {
+    return toWords(value).join(delimiter);
+  },
+
+  // =====================================>
+  // ## Conversion: format string to camel case
+  // =====================================>
+  strCamel(value: string, delimiter: string = ""): string {
+    return toWords(value).map((w, i) => i === 0 ? w : w[0].toUpperCase() + w.slice(1)).join(delimiter);
+  },
+
+  // =====================================>
+  // ## Conversion: format string to pascal case
+  // =====================================>
+  strPascal(value: string, delimiter: string = ""): string {
+    return toWords(value).map(w => w[0].toUpperCase() + w.slice(1)).join(delimiter);
+  },
+
+  // =====================================>
+  // ## Conversion: format string to plural
+  // =====================================>
+  strPlural(value: string): string {
+    const match = value.match(/^(.*?)([A-Za-z]+)$/)
+    if (!match) return value
+
+    const [, prefix, word] = match
+
+    if (word.endsWith("y") && !/[aeiou]y$/i.test(word)) {
+      return prefix + word.slice(0, -1) + "ies"
+    }
+
+    if (!word.endsWith("s")) return prefix + word + "s"
+
+    return value
+  },
+
+  // =====================================>
+  // ## Conversion: format string to singular
+  // =====================================>
+  strSingular(value: string): string {
+    const match = value.match(/^(.*?)([A-Za-z]+)$/)
+    if (!match) return value
+
+    const [, prefix, word] = match
+
+    if (word.endsWith("ies")) {
+      return prefix + word.slice(0, -3) + "y"
+    }
+
+    if (word.endsWith("s") && !word.endsWith("ss")) {
+      return prefix + word.slice(0, -1)
+    }
+
+    return value
+  },
+
+  // =====================================>
+  // ## Conversion: format number to currency
+  // =====================================>
+  currency: (value: number, locale = "id-ID", currency = "IDR") => { const val = Math.trunc(value); return new Intl.NumberFormat(locale, { style: "currency", currency, minimumFractionDigits: 0, maximumFractionDigits: 2 }).format(val); }, 
+  
+  // =====================================>
+  // ## Conversion: format date string
+  // =====================================>
+  date: date,
+};
+
+
+
+function toWords(value: string): string[] {
+  return value
+    .replace(/([a-z0-9])([A-Z])/g, "$1 $2")
+    .replace(/[_\-\s]+/g, " ")
+    .trim()
+    .toLowerCase()
+    .split(" ")
+    .filter(Boolean)
 }

package/src/conversion/date.ts

@@ -0,0 +1,74 @@
+export function date(dateStr: string, format: string = "DD MMM YYYY"): string {
+  const d = new Date(dateStr);
+  if (isNaN(d.getTime())) return "Invalid Date";
+
+  const options: Intl.DateTimeFormatOptions = {};
+  if (format.includes("YYYY") || format.includes("YY")) {
+    options.year = format.includes("YYYY") ? "numeric" : "2-digit";
+  }
+  if (format.includes("MMMM") || format.includes("MMM") || format.includes("MM") || format.includes("M")) {
+    options.month = format.includes("MMMM") ? "long" : format.includes("MMM") ? "short" : format.includes("MM") ? "2-digit" : "numeric";
+  }
+  if (format.includes("DD") || format.includes("D")) {
+    options.day = format.includes("DD") ? "2-digit" : "numeric";
+  }
+  if (format.includes("HH") || format.includes("H") || format.includes("hh") || format.includes("h")) {
+    options.hour = (format.includes("HH") || format.includes("hh")) ? "2-digit" : "numeric";
+    options.hour12 = format.includes("hh") || format.includes("h");
+  }
+  if (format.includes("mm") || format.includes("m")) {
+    options.minute = format.includes("mm") ? "2-digit" : "numeric";
+  }
+  if (format.includes("ss") || format.includes("s")) {
+    options.second = format.includes("ss") ? "2-digit" : "numeric";
+  }
+
+  const parts = new Intl.DateTimeFormat("id-ID", options).formatToParts(d);
+  let result = format;
+
+  if (format.includes("YYYY")) {
+    result = result.replace("YYYY", parts.find(p => p.type === "year")?.value || "");
+  } else if (format.includes("YY")) {
+    result = result.replace("YY", (parts.find(p => p.type === "year")?.value || "").slice(-2));
+  }
+
+  if (format.includes("MMMM")) {
+    result = result.replace("MMMM", parts.find(p => p.type === "month")?.value || "");
+  } else if (format.includes("MMM")) {
+    result = result.replace("MMM", parts.find(p => p.type === "month")?.value || "");
+  } else if (format.includes("MM")) {
+    result = result.replace("MM", parts.find(p => p.type === "month")?.value || "");
+  } else if (format.includes("M")) {
+    result = result.replace("M", parts.find(p => p.type === "month")?.value || "");
+  }
+
+  if (format.includes("DD")) {
+    result = result.replace("DD", parts.find(p => p.type === "day")?.value || "");
+  } else if (format.includes("D")) {
+    result = result.replace("D", parts.find(p => p.type === "day")?.value || "");
+  }
+
+  if (format.includes("HH")) {
+    result = result.replace("HH", parts.find(p => p.type === "hour")?.value || "");
+  } else if (format.includes("H")) {
+    result = result.replace("H", parts.find(p => p.type === "hour")?.value || "");
+  } else if (format.includes("hh")) {
+    result = result.replace("hh", parts.find(p => p.type === "hour")?.value || "");
+  } else if (format.includes("h")) {
+    result = result.replace("h", parts.find(p => p.type === "hour")?.value || "");
+  }
+
+  if (format.includes("mm")) {
+    result = result.replace("mm", parts.find(p => p.type === "minute")?.value || "");
+  } else if (format.includes("m")) {
+    result = result.replace("m", parts.find(p => p.type === "minute")?.value || "");
+  }
+
+  if (format.includes("ss")) {
+    result = result.replace("ss", parts.find(p => p.type === "second")?.value || "");
+  } else if (format.includes("s")) {
+    result = result.replace("s", parts.find(p => p.type === "second")?.value || "");
+  }
+
+  return result;
+}

package/src/index.ts

@@ -8,9 +8,11 @@ export * from "./route";
 export * from "./storage";
 export * from "./validation";
 export * from "./mail";
+export * from "./notification";
 export * from "./logger";
 export * from "./registry";
 export * from "./commands/cli";
+export { DAMigration } from "./commands/runner/da-migration";
 
 declare module "knex" {
   namespace Knex {

package/src/logger/logger.ts

@@ -1,177 +1,218 @@
-import fs from 'fs';
-import path from 'path';
-import { registry } from '@utils/registry';
-
-
-
-type LogType = "start" | "info" | "error" | "warning" | "cron" | "queue" | "queueError" | "cronError" | "socket" | "socketError";
-
-export interface AccessLog {
-  method    :  string
-  path      :  string
-  status    :  number
-  latency   :  number
-  ip       ?:  string | null
-  agent    ?:  string | null
-  at       ?:  string
-}
-
-export interface ErrorLog {
-  service    ?:  string
-  key        ?:  string
-  feature    ?:  string
-  error       :  string | null
-  reference  ?:  string | null
-  at         ?:  string
-}
-
-
-
-
-const colors: Record<LogType | "default", string> = {
-  default      :  "\x1b[0m",      // default
-  start        :  "\x1b[32m",     // green
-  info         :  "\x1b[36m",     // cyan
-  error        :  "\x1b[31m",     // red
-  warning      :  "\x1b[33m",     // yellow
-  queue        :  "\x1b[34m",     // blue
-  queueError   :  "\x1b[31m",     // red
-  cron         :  "\x1b[35m",     // magenta
-  cronError    :  "\x1b[31m",     // red
-  socket       :  "\x1b[35m",     // blue
-  socketError  :  "\x1b[31m",     // red
-};
-
-const prefixes: Record<LogType, string> = {
-  start        :  "START",
-  info         :  "INFO",
-  error        :  "ERROR",
-  warning      :  "WARNING",
-  cron         :  "CRON",
-  queue        :  "QUEUE",
-  socket       :  "SOCKET",
-  queueError   :  "QUEUE ERROR",
-  cronError    :  "CRON ERROR",
-  socketError  :  "SOCKET ERROR",
-};
-
-function log(type: LogType, msg: string) {
-  const color = colors[type];
-  const prefix = prefixes[type];
-  // eslint-disable-next-line no-console
-  console.log(`${color}[${prefix}]${colors.default}`, msg);
-}
-
-export const logger = {
-  start    :  (msg: string) => log("start", msg),
-  info     :  (msg: string) => log("info", msg),
-  warning  :  (msg: string) => log("warning", msg),
-  queue    :  (msg: string) => log("queue", msg),
-  cron     :  (msg: string) => log("cron", msg),
-  socket   :  (msg: string) => log("socket", msg),
-
-  access   :  (msg: AccessLog) => logAccess(msg),
-
-  error: (msg: string, payload?: ErrorLog) => {
-    log("error", msg)
-    payload && logError({...payload, service: payload.service || 'app'})
-  },
-  queueError: (msg: string, payload?: ErrorLog) => {
-    log("queueError", msg)
-    payload && logError({...payload, service: payload.service || 'queue'})
-  },
-  cronError: (msg: string, payload?: ErrorLog) => {
-    log("cronError", msg)
-    payload && logError({...payload, service: payload.service || 'cron'})
-  },
-  socketError: (msg: string, payload?: ErrorLog) => {
-    log("socketError", msg)
-    payload && logError({...payload, service: payload.service || 'socket'})
-  },
-};
-
-
-
-
-
-type DriverName = "file" | "da"
-
-
-const ACCESS_LOG_DRIVER        =  process.env.ACCESS_LOG_DRIVER || "file"
-const ACCESS_LOG_LOG_DIR       =  process.env.ACCESS_LOG_DIR || "storage/logs/access"
-const ACCESS_LOG_QUEUE         =  process.env.ACCESS_LOG_QUEUE || "access-log"
-
-
-const ERROR_LOG_DRIVER        = process.env.ERROR_LOG_DRIVER || "file"
-const ERROR_LOG_LOG_DIR       = process.env.ERROR_LOG_DIR || "storage/logs/error"
-const ERROR_LOG_QUEUE         = process.env.ERROR_LOG_QUEUE_PREFIX || "error-log"
-
-
-
-// =====================
-// ## Access Log Drivers
-// =====================
-const filePath = () => {
-  const d = new Date().toISOString().slice(0, 10)
-  return path.resolve( ACCESS_LOG_LOG_DIR, `access-${d}.log`)
-}
-
-const handlers: Record<DriverName, (log: AccessLog) => Promise<void>> = {
-  file: async (log) => {
-    const dir = path.resolve(ACCESS_LOG_LOG_DIR);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-
-    fs.appendFile(filePath(), JSON.stringify(log) + "\n", () => {})
-  },
-  da: async (log) => {
-    const queue = registry.get('queue')
-    if (queue) {
-      try {
-        await queue.add(ACCESS_LOG_QUEUE, log)
-      } catch {}
-    }
-  }
-}
-
-const activeDrivers: DriverName[] = (ACCESS_LOG_DRIVER).split(",").map(v => v.trim()).filter((v): v is DriverName => v in handlers)
-
-function logAccess(payload: AccessLog) {
-  for (const d of activeDrivers) {
-    handlers[d](payload)
-  }
-}
-
-
-
-// =====================
-// ## Error Log Drivers
-// =====================
-const errorFilePath = () => {
-  const d = new Date().toISOString().slice(0, 10)
-  return path.resolve(ERROR_LOG_LOG_DIR, `error-${d}.log`)
-}
-
-const errorHandlers: Record<DriverName, (log: ErrorLog) => Promise<void>> = {
-  file: async (log) => {
-    const dir = path.resolve(ERROR_LOG_LOG_DIR);
-    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
-
-    fs.appendFile(errorFilePath(), JSON.stringify(log) + "\n", () => {});
-  },
-  da: async (log) => {
-    const queue = registry.get('queue')
-    if (queue) {
-      try {
-        await queue.add(ERROR_LOG_QUEUE, log)
-      } catch {}
-    }
-  }
-}
-
-const activeErrorDrivers: DriverName[] = ERROR_LOG_DRIVER.split(",").map(v => v.trim()).filter((v): v is DriverName => v in errorHandlers)
-
-function logError(payload: ErrorLog) {
-  for (const d of activeErrorDrivers) {
-    errorHandlers[d](payload)
-  }
+import fs from 'fs';
+import path from 'path';
+import { registry } from '@utils/registry';
+
+
+
+type LogType = "start" | "info" | "error" | "warning" | "cron" | "queue" | "queueError" | "cronError" | "socket" | "socketError";
+
+export interface AccessLog {
+  method    :  string
+  path      :  string
+  status    :  number
+  latency   :  number
+  ip       ?:  string | null
+  agent    ?:  string | null
+  at       ?:  string
+}
+
+export interface ErrorLog {
+  service    ?:  string
+  key        ?:  string
+  feature    ?:  string
+  error       :  string | null
+  reference  ?:  string | null
+  at         ?:  string
+}
+
+
+
+
+const colors: Record<LogType | "default", string> = {
+  default      :  "\x1b[0m",      // default
+  start        :  "\x1b[32m",     // green
+  info         :  "\x1b[36m",     // cyan
+  error        :  "\x1b[31m",     // red
+  warning      :  "\x1b[33m",     // yellow
+  queue        :  "\x1b[34m",     // blue
+  queueError   :  "\x1b[31m",     // red
+  cron         :  "\x1b[35m",     // magenta
+  cronError    :  "\x1b[31m",     // red
+  socket       :  "\x1b[35m",     // blue
+  socketError  :  "\x1b[31m",     // red
+};
+
+const prefixes: Record<LogType, string> = {
+  start        :  "START",
+  info         :  "INFO",
+  error        :  "ERROR",
+  warning      :  "WARNING",
+  cron         :  "CRON",
+  queue        :  "QUEUE",
+  socket       :  "SOCKET",
+  queueError   :  "QUEUE ERROR",
+  cronError    :  "CRON ERROR",
+  socketError  :  "SOCKET ERROR",
+};
+
+function log(type: LogType, msg: string) {
+  const color = colors[type];
+  const prefix = prefixes[type];
+  // eslint-disable-next-line no-console
+  console.log(`${color}[${prefix}]${colors.default}`, msg);
+}
+
+export const logger = {
+  // =====================================>
+  // ## Logger: log system startup messages
+  // =====================================>
+  start    :  (msg: string) => log("start", msg),
+
+  // =====================================>
+  // ## Logger: log general info messages
+  // =====================================>
+  info     :  (msg: string) => log("info", msg),
+
+  // =====================================>
+  // ## Logger: log warning messages
+  // =====================================>
+  warning  :  (msg: string) => log("warning", msg),
+
+  // =====================================>
+  // ## Logger: log queue-related messages
+  // =====================================>
+  queue    :  (msg: string) => log("queue", msg),
+
+  // =====================================>
+  // ## Logger: log cron-related messages
+  // =====================================>
+  cron     :  (msg: string) => log("cron", msg),
+
+  // =====================================>
+  // ## Logger: log socket-related messages
+  // =====================================>
+  socket   :  (msg: string) => log("socket", msg),
+
+  // =====================================>
+  // ## Logger: log request access details
+  // =====================================>
+  access   :  (msg: AccessLog) => logAccess(msg),
+
+  // =====================================>
+  // ## Logger: log error messages
+  // =====================================>
+  error: (msg: string, payload?: ErrorLog) => {
+    log("error", msg)
+    payload && logError({...payload, service: payload.service || 'app'})
+  },
+
+  // =====================================>
+  // ## Logger: log queue error messages
+  // =====================================>
+  queueError: (msg: string, payload?: ErrorLog) => {
+    log("queueError", msg)
+    payload && logError({...payload, service: payload.service || 'queue'})
+  },
+
+  // =====================================>
+  // ## Logger: log cron error messages
+  // =====================================>
+  cronError: (msg: string, payload?: ErrorLog) => {
+    log("cronError", msg)
+    payload && logError({...payload, service: payload.service || 'cron'})
+  },
+
+  // =====================================>
+  // ## Logger: log socket error messages
+  // =====================================>
+  socketError: (msg: string, payload?: ErrorLog) => {
+    log("socketError", msg)
+    payload && logError({...payload, service: payload.service || 'socket'})
+  },
+};
+
+
+
+
+
+type DriverName = "file" | "da"
+
+
+const ACCESS_LOG_DRIVER        =  process.env.ACCESS_LOG_DRIVER || "file"
+const ACCESS_LOG_LOG_DIR       =  process.env.ACCESS_LOG_DIR || "storage/logs/access"
+const ACCESS_LOG_QUEUE         =  process.env.ACCESS_LOG_QUEUE || "access-log"
+
+
+const ERROR_LOG_DRIVER        = process.env.ERROR_LOG_DRIVER || "file"
+const ERROR_LOG_LOG_DIR       = process.env.ERROR_LOG_DIR || "storage/logs/error"
+const ERROR_LOG_QUEUE         = process.env.ERROR_LOG_QUEUE_PREFIX || "error-log"
+
+
+
+// =====================
+// ## Access Log Drivers
+// =====================
+const filePath = () => {
+  const d = new Date().toISOString().slice(0, 10)
+  return path.resolve( ACCESS_LOG_LOG_DIR, `access-${d}.log`)
+}
+
+const handlers: Record<DriverName, (log: AccessLog) => Promise<void>> = {
+  file: async (log) => {
+    const dir = path.resolve(ACCESS_LOG_LOG_DIR);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+    fs.appendFile(filePath(), JSON.stringify(log) + "\n", () => {})
+  },
+  da: async (log) => {
+    const queue = registry.get('queue')
+    if (queue) {
+      try {
+        await queue.add(ACCESS_LOG_QUEUE, log)
+      } catch {}
+    }
+  }
+}
+
+const activeDrivers: DriverName[] = (ACCESS_LOG_DRIVER).split(",").map(v => v.trim()).filter((v): v is DriverName => v in handlers)
+
+function logAccess(payload: AccessLog) {
+  for (const d of activeDrivers) {
+    handlers[d](payload)
+  }
+}
+
+
+
+// =====================
+// ## Error Log Drivers
+// =====================
+const errorFilePath = () => {
+  const d = new Date().toISOString().slice(0, 10)
+  return path.resolve(ERROR_LOG_LOG_DIR, `error-${d}.log`)
+}
+
+const errorHandlers: Record<DriverName, (log: ErrorLog) => Promise<void>> = {
+  file: async (log) => {
+    const dir = path.resolve(ERROR_LOG_LOG_DIR);
+    if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
+
+    fs.appendFile(errorFilePath(), JSON.stringify(log) + "\n", () => {});
+  },
+  da: async (log) => {
+    const queue = registry.get('queue')
+    if (queue) {
+      try {
+        await queue.add(ERROR_LOG_QUEUE, log)
+      } catch {}
+    }
+  }
+}
+
+const activeErrorDrivers: DriverName[] = ERROR_LOG_DRIVER.split(",").map(v => v.trim()).filter((v): v is DriverName => v in errorHandlers)
+
+function logError(payload: ErrorLog) {
+  for (const d of activeErrorDrivers) {
+    errorHandlers[d](payload)
+  }
 }