refactor(utils): fix export issues and add logger types

Author: cyber-hari

src/index.ts

@@ -3,6 +3,7 @@ export * from "./utils/async.utils";
 export * from "./utils/cache.utils";
 export * from "./utils/context-store.utils";
 export * from "./utils/crypto.utils";
+export * from "./utils/decorators.utils";
 export * from "./utils/dir.utils";
 export * from "./utils/env.utils";
 export * from "./utils/exception.utils";

src/utils/decorators.utils.ts

@@ -3,24 +3,20 @@
 import "reflect-metadata";
 
 // --- Sample Express interfaces for type safety ---
-export interface Request {
+interface Request {
   query: any;
   params: any;
   body?: any;
   [key: string]: any;
 }
-export interface Response {
+interface Response {
   json: (body: any) => void;
   headersSent: boolean;
   [key: string]: any;
 }
-export type NextFunction = (err?: any) => void;
-export type RequestHandler = (
-  req: Request,
-  res: Response,
-  next: NextFunction,
-) => any;
-export interface Router {
+type NextFunction = (err?: any) => void;
+type RequestHandler = (req: Request, res: Response, next: NextFunction) => any;
+interface Router {
   [method: string]: (path: string, ...handlers: RequestHandler[]) => void;
 }
 // --- End sample Express interfaces ---
@@ -29,7 +25,7 @@ const ROUTES_KEY = Symbol("routes");
 const MIDDLEWARE_KEY = Symbol("middlewares");
 const PARAMS_KEY = Symbol("params");
 
-export type HttpMethod =
+type HttpMethod =
   | "get"
   | "post"
   | "put"

src/utils/logger.utils.ts

@@ -1,5 +1,5 @@
 import pino, { LoggerOptions, stdTimeFunctions } from "pino";
-import type { Logger } from "pino"; // Type-only import
+import type { Logger as PinoLogger } from "pino"; // Type-only import
 import { Config } from "../config";
 import { ContextStore, StoreKeys } from "./context-store.utils";
 
@@ -8,11 +8,21 @@ import { ContextStore, StoreKeys } from "./context-store.utils";
  */
 const GLOBAL_LOGGER_KEY = Symbol.for("logger");
 
+/**
+ * Logger type for application-wide logging.
+ */
+export type Logger = pino.Logger;
+
+/**
+ * Logger levels for application-wide logging.
+ */
+export type LoggerLevels = pino.Level;
+
 /**
  * Use an object compatible with either modern or legacy global scopes.
  */
 export const _globalThis = typeof globalThis === "object" ? globalThis : global;
-const _global = _globalThis as unknown as { [GLOBAL_LOGGER_KEY]: Logger };
+const _global = _globalThis as unknown as { [GLOBAL_LOGGER_KEY]: PinoLogger };
 
 /**
  * Initializes the global root logger according to app configuration.
@@ -56,8 +66,8 @@ function setupLogger(): void {
  *
  * @returns {Logger} The logger instance (request-bound or global root logger)
  */
-export function getLogger(): Logger {
-  const logger = ContextStore.get<Logger>(StoreKeys.LOGGER);
+export function getLogger(): PinoLogger {
+  const logger = ContextStore.get<PinoLogger>(StoreKeys.LOGGER);
   if (logger) return logger;
 
   if (!_global[GLOBAL_LOGGER_KEY]) {
@@ -76,8 +86,8 @@ export function getLogger(): Logger {
  */
 export function createChildLogger(
   bindings: Record<string, any>,
-  parentLogger?: Logger,
-): Logger {
+  parentLogger?: PinoLogger,
+): PinoLogger {
   const logger = parentLogger || getLogger();
   return logger.child(bindings);
 }
@@ -92,7 +102,7 @@ export function createChildLogger(
 export function createRequestLogger(
   requestId: string,
   additionalContext: Record<string, any> = {},
-): Logger {
+): PinoLogger {
   const logger = createChildLogger({
     requestId,
     ...additionalContext,

src/utils/middleware.utils.ts

@@ -9,7 +9,7 @@ import { getLogger } from "./logger.utils";
 /**
  * Type definitions for Express-compatible middleware
  */
-export type Request = {
+type Request = {
   headers: Record<string, string | string[] | undefined>;
   method: string;
   url: string;
@@ -20,7 +20,7 @@ export type Request = {
   [key: string]: any;
 };
 
-export type Response = {
+type Response = {
   status: (code: number) => Response;
   json: (data: any) => void;
   send: (data: any) => void;
@@ -30,9 +30,9 @@ export type Response = {
   [key: string]: any;
 };
 
-export type NextFunction = (err?: Error | any) => void;
+type NextFunction = (err?: Error | any) => void;
 
-export type Middleware = (
+type Middleware = (
   req: Request,
   res: Response,
   next: NextFunction,