@kava/kava-api-core 1.0.0 → 1.0.2

package/src/db/index.ts

@@ -0,0 +1 @@
+export * from "./db";

package/src/index.ts

@@ -1,13 +1,14 @@
-export * from "./auth.util";
-export * from "./controller.util";
-export * from "./conversion.util";
-export * from "./context.util";
-export * from "./db.util";
-export * from "./middleware.util";
-export * from "./model.util";
-export * from "./permission.util";
-export * from "./route.util";
-export * from "./storage.util";
-export * from "./validation.util";
-export * from "./mail.util";
-export * from "./logger.util";
+export * from "./auth";
+export * from "./controller";
+export * from "./conversion";
+export * from "./context";
+export * from "./db";
+export * from "./middleware";
+export * from "./model";
+export * from "./permission";
+export * from "./route";
+export * from "./storage";
+export * from "./validation";
+export * from "./mail";
+export * from "./logger";
+export * from "./registry";

package/src/logger/index.ts

@@ -0,0 +1 @@
+export * from "./logger";

package/src/{logger.util.ts → logger/logger.ts}

@@ -1,170 +1,177 @@
-import fs from 'fs';
-import path from 'path';
-
-
-
-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) => {
-    // 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) => {
-    // 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 = {
+  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)
+  }
 }

package/src/mail/index.ts

@@ -0,0 +1 @@
+export * from "./mail";

package/src/{mail.util.ts → mail/mail.ts}

@@ -1,86 +1,86 @@
-import { readFileSync } from "fs";
-import { join } from "path";
-import nodemailer, { SentMessageInfo } from "nodemailer";
-import { logger } from "@utils";
-
-
-
-export interface SendMailOptions {
-  to            :  string;
-  subject       :  string;
-  content      ?:  string;
-  text         ?:  string;
-  attachments  ?:  {
-    filename    :  string;
-    path        :  string;
-  }[];
-}
-
-
-
-// =============================>
-// ## Mail: Send mail 
-// =============================>
-export async function sendMail(options: {
-  to            :  string;
-  subject       :  string;
-  text         ?:  string;
-  content      ?:  string;
-  attachments  ?:  { filename: string; path: string }[];
-}) {
-  const transporter = nodemailer.createTransport({
-    host    :  process.env.MAIL_HOST,
-    port    :  Number(process.env.MAIL_PORT),
-    secure  :  Number(process.env.MAIL_PORT) === 465,
-    auth    :  {
-      user  :  process.env.MAIL_USERNAME,
-      pass  :  process.env.MAIL_PASSWORD,
-    },
-  });
-
-  const info = (await transporter.sendMail({
-    from         :  `${process.env.MAIL_FROM_NAME || process.env.APP_NAME} <${process.env.MAIL_FROM_ADDRESS || process.env.MAIL_USERNAME}>`,
-    to           :  options.to,
-    subject      :  options.subject,
-    text         :  options.text,
-    html         :  options.content,
-    attachments  :  options.attachments,
-  })) as SentMessageInfo;
-
-  logger.info(`Email sent successfully: ${info.messageId}`)
-  return info;
-}
-
-
-
-// =============================>
-// ## Mail: Render mail template 
-// =============================>
-export function renderMailTemplate(template: string, options: Record<string, string>) {
-  const templateDir = join(import.meta.dir, "./../outputs/mails/templates");
-
-  const contentPath = join(templateDir, `${template}.mail.stub`);
-  let content = readFileSync(contentPath, "utf-8");
-
-  for (const [key, value] of Object.entries(options)) {
-    const regex = new RegExp(`{{\\s*${key}\\s*}}`, "g");
-    content = content.replace(regex, value);
-  }
-
-  let layout = readFileSync(join(templateDir, "layout.mail.stub"), "utf-8");
-
-  const globalVars = {
-    ...options,
-    date      :  "20-10-2025",
-    app_name  :  process.env.APP_NAME || "",
-  };
-
-  for (const [key, value] of Object.entries(globalVars)) {
-    const regex = new RegExp(`{{\\s*${key}\\s*}}`, "g");
-    layout = layout.replace(regex, value);
-  }
-
-  layout = layout.replace("{{content}}", content);
-
-  return layout;
+import { readFileSync } from "fs";
+import { join } from "path";
+import nodemailer, { SentMessageInfo } from "nodemailer";
+import { logger } from "@utils";
+
+
+
+export interface SendMailOptions {
+  to            :  string;
+  subject       :  string;
+  content      ?:  string;
+  text         ?:  string;
+  attachments  ?:  {
+    filename    :  string;
+    path        :  string;
+  }[];
+}
+
+
+
+// =============================>
+// ## Mail: Send mail 
+// =============================>
+export async function sendMail(options: {
+  to            :  string;
+  subject       :  string;
+  text         ?:  string;
+  content      ?:  string;
+  attachments  ?:  { filename: string; path: string }[];
+}) {
+  const transporter = nodemailer.createTransport({
+    host    :  process.env.MAIL_HOST,
+    port    :  Number(process.env.MAIL_PORT),
+    secure  :  Number(process.env.MAIL_PORT) === 465,
+    auth    :  {
+      user  :  process.env.MAIL_USERNAME,
+      pass  :  process.env.MAIL_PASSWORD,
+    },
+  });
+
+  const info = (await transporter.sendMail({
+    from         :  `${process.env.MAIL_FROM_NAME || process.env.APP_NAME} <${process.env.MAIL_FROM_ADDRESS || process.env.MAIL_USERNAME}>`,
+    to           :  options.to,
+    subject      :  options.subject,
+    text         :  options.text,
+    html         :  options.content,
+    attachments  :  options.attachments,
+  })) as SentMessageInfo;
+
+  logger.info(`Email sent successfully: ${info.messageId}`)
+  return info;
+}
+
+
+
+// =============================>
+// ## Mail: Render mail template 
+// =============================>
+export function renderMailTemplate(template: string, options: Record<string, string>) {
+  const templateDir = join(import.meta.dir, "./../outputs/mails/templates");
+
+  const contentPath = join(templateDir, `${template}.mail.stub`);
+  let content = readFileSync(contentPath, "utf-8");
+
+  for (const [key, value] of Object.entries(options)) {
+    const regex = new RegExp(`{{\\s*${key}\\s*}}`, "g");
+    content = content.replace(regex, value);
+  }
+
+  let layout = readFileSync(join(templateDir, "layout.mail.stub"), "utf-8");
+
+  const globalVars = {
+    ...options,
+    date      :  "20-10-2025",
+    app_name  :  process.env.APP_NAME || "",
+  };
+
+  for (const [key, value] of Object.entries(globalVars)) {
+    const regex = new RegExp(`{{\\s*${key}\\s*}}`, "g");
+    layout = layout.replace(regex, value);
+  }
+
+  layout = layout.replace("{{content}}", content);
+
+  return layout;
 }

package/src/middleware/index.ts

@@ -0,0 +1 @@
+export * from "./middleware";