@skalfa/skalfa-api-core 1.0.3 → 1.0.8

package/src/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/access-log.ts

@@ -0,0 +1,15 @@
+import { Elysia } from 'elysia'
+import { logger } from '@utils'
+
+export const AccessLog = (app: Elysia) => app.state<{ startedAt?: number }>({}).onRequest(({ store }) => { store.startedAt = Date.now() }).onAfterResponse(({ request, set, store }) => {
+  const method   =  request.method
+  const url      =  new URL(request.url)
+  const path     =  url.pathname
+  const status   =  Number(set.status) ?? 200
+  const latency  =  Date.now() - (store.startedAt ?? Date.now())
+  const agent    =  request.headers.get("user-agent") || 'unknown'
+  const ip       =  request.headers.get('x-forwarded-for')?.split(',')[0]?.trim() || request.headers.get('cf-connecting-ip') || 'unknown'
+
+  logger.info(`${method} : ${path} - ${status} - ${latency}ms - ${ip}]`)
+  logger.access({ method, path, status, latency, ip, agent })
+})

package/src/middleware/auth.ts

@@ -0,0 +1,19 @@
+import { Elysia } from 'elysia'
+import { auth } from '@utils'
+
+export const Auth = (app: Elysia) => app.derive(async ({ request }) => {
+  const authHeader = request.headers.get('authorization')
+
+  if (!authHeader || !authHeader.startsWith('Bearer ')) return { user: null, permissions: [], token: null }
+
+  const bearer = authHeader.substring(7).trim()
+  const result = await auth.verifyAccessToken(bearer, request)
+
+  if (!result) return { user: null, permissions: [], token: null };
+
+  return {
+    user: result.user,
+    permissions: result.permissions,
+    token: result.token,
+  }
+})

package/src/middleware/body-parse.ts

@@ -0,0 +1,83 @@
+import { Elysia, status } from 'elysia'
+import { logger } from '@utils'
+import { errors } from './middleware'
+
+export const BodyParse = (app: Elysia) => app.state<{ rawBody?: any }>({}).onRequest(async ({ request, store }) => {
+  const text = await request.clone().text();
+
+  const contentType = request.headers.get("content-type") || "";
+  let rawBody: any = {};
+
+  try {
+    if (contentType.includes("application/json")) {
+      rawBody = text ? JSON.parse(text) : {};
+    } else if (contentType.includes("application/x-www-form-urlencoded")) {
+      const params = new URLSearchParams(text);
+      for (const [key, value] of params.entries()) bodyParseNestedSet(rawBody, key, value);
+    } else if (contentType.includes("multipart/form-data")) {
+      const formData = await request.clone().formData();
+      for (const [key, value] of formData.entries()) bodyParseNestedSet(rawBody, key, value);
+    } else {
+      rawBody = {};
+    }
+  } catch (e) {
+    const em = e instanceof Error ? e.message : String(e)
+    logger.error(`Body parse error: ${em}`, { error: em })
+    rawBody = {};
+    throw status(errors.request.status, { message: errors.request.message })
+  }
+
+  store.rawBody = rawBody;
+}).derive(({ store }) => {
+  const payload = bodyParseKeyFormat(store.rawBody || {});
+  return { payload };
+})
+
+function bodyParseKeyFormat(input: any): any {
+  if ( typeof input !== "object" || input === null || input instanceof File ) return input;
+
+  if (Array.isArray(input)) return input.map(bodyParseKeyFormat)
+
+  const result: any = {}
+  for (const [key, value] of Object.entries(input)) {
+    if (key.includes(".") || key.includes("[")) {
+      bodyParseNestedSet(result, key, bodyParseKeyFormat(value))
+    } else {
+      result[key] = bodyParseKeyFormat(value)
+    }
+  }
+  return result
+}
+
+function bodyParseNestedSet(obj: any, path: string, value: any) {
+  const parts = bodyParsePathFormat(path);
+  let current = obj;
+
+  for (let i = 0; i < parts.length; i++) {
+    const key = parts[i];
+    const isLast = i === parts.length - 1;
+
+    if (isLast) {
+      current[key] = bodyParseValueFormat(value);
+    } else {
+      if (!(key in current)) {
+        const nextKey = parts[i + 1];
+        current[key] = isNaN(Number(nextKey)) ? {} : [];
+      }
+      current = current[key];
+    }
+  }
+}
+
+function bodyParsePathFormat(path: string): string[] {
+  return path.replace(/\[(\w+)\]/g, ".$1").replace(/^\./, "").split(".");
+}
+
+function bodyParseValueFormat(value: any) {
+  if (value == "" || value == null || value == "null") return null;
+  if (typeof value !== "string") return value;
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (!isNaN(Number(value))) return Number(value);
+  return value;
+}

package/src/middleware/context.ts

@@ -0,0 +1,11 @@
+import { Elysia } from 'elysia'
+import { context } from '@utils'
+
+export const ContextMiddleware = (app: Elysia) => app.derive(async ({ store }) => {
+  const userId = (store as any)?.user?.id
+
+  return context.run({
+      user_id: userId,
+    },() => ({})
+  )
+})

package/src/middleware/cors.ts

@@ -0,0 +1,31 @@
+import { Elysia } from 'elysia'
+import { logger } from '@utils'
+
+export const Cors = (app: Elysia) => app.onRequest(({ request, set }) => {
+  const origin                       = request.headers.get('origin') ?? ''
+  let allowedOrigin: string          = '*'
+
+  const originsConf = process.env.APP_CORS_ORIGINS || '*'
+
+  if (originsConf !== '*') {
+    try {
+      const allowedOrigins = JSON.parse(originsConf)
+      if (Array.isArray(allowedOrigins) && allowedOrigins.includes(origin)) {
+          allowedOrigin = origin || ""
+      }
+    } catch (e) {
+      const em = 'Cors Error: Failed to parse APP_CORS_ORIGINS, fallback to "*"'
+      logger.error(em, { error: em })
+      allowedOrigin = ''
+    }
+  }
+  
+  set.headers['Access-Control-Allow-Origin']      = allowedOrigin
+  set.headers['Access-Control-Allow-Methods']     = process.env.APP_CORS_METHODS || 'GET, POST, PUT, DELETE, OPTIONS'
+  set.headers['Access-Control-Allow-Headers']     = 'Origin, X-Requested-With, Content-Type, Accept, Authorization, X-Option, x-App'
+  set.headers['Access-Control-Allow-Credentials'] = 'true'
+
+  if (request.method === 'OPTIONS') {
+      return new Response(null, { status: 204, })
+  }
+})

package/src/middleware/error-handler.ts

@@ -0,0 +1,20 @@
+import { Elysia } from 'elysia'
+import { logger } from '@utils'
+import { errors } from './middleware'
+
+export const ErrorHandler = (app: Elysia) => app.onError(({ code, set, error, request }) => {
+  if (code === 'NOT_FOUND') {
+    set.status = errors.notfound.status
+    return { message:  errors.notfound.message }
+  }
+
+  if (code === 'INTERNAL_SERVER_ERROR') {
+    set.status = errors.error.status
+    const em = error.message
+    const url = new URL(request.url)
+    const path = url.pathname
+
+    logger.error(`error: ${em}`, { error: em, reference: path })
+    return { message: em }
+  }
+})