@exyconn/common 1.0.0

package/dist/server/middleware/index.mjs

@@ -0,0 +1,118 @@
+import jwt from 'jsonwebtoken';
+
+// src/server/middleware/auth.middleware.ts
+
+// src/server/response/response-object.ts
+var unauthorizedResponse = (res, message = "Unauthorized access") => {
+  return res.status(401 /* UNAUTHORIZED */).json({
+    message,
+    data: null,
+    status: "unauthorized" /* UNAUTHORIZED */,
+    statusCode: 401 /* UNAUTHORIZED */
+  });
+};
+var forbiddenResponse = (res, message = "Access forbidden") => {
+  return res.status(403 /* FORBIDDEN */).json({
+    message,
+    data: null,
+    status: "forbidden" /* FORBIDDEN */,
+    statusCode: 403 /* FORBIDDEN */
+  });
+};
+
+// src/server/middleware/auth.middleware.ts
+var authenticateJWT = (secretKey) => {
+  return (req, res, next) => {
+    const authHeader = req.headers.authorization;
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+      unauthorizedResponse(res, "Authorization header missing or malformed");
+      return;
+    }
+    const token = authHeader.split(" ")[1];
+    try {
+      const decoded = jwt.verify(token, secretKey);
+      req.userId = decoded.userId;
+      req.organizationId = decoded.organizationId;
+      req.user = decoded;
+      if (!decoded.userId) {
+        unauthorizedResponse(res, "User ID not found in token");
+        return;
+      }
+      next();
+    } catch (err) {
+      if (err instanceof jwt.TokenExpiredError) {
+        unauthorizedResponse(res, "Token has expired");
+        return;
+      }
+      if (err instanceof jwt.JsonWebTokenError) {
+        forbiddenResponse(res, "Invalid token");
+        return;
+      }
+      unauthorizedResponse(res, "Token validation failed");
+    }
+  };
+};
+var optionalAuthenticateJWT = (secretKey) => {
+  return (req, _res, next) => {
+    const authHeader = req.headers.authorization;
+    if (!authHeader || !authHeader.startsWith("Bearer ")) {
+      next();
+      return;
+    }
+    const token = authHeader.split(" ")[1];
+    try {
+      const decoded = jwt.verify(token, secretKey);
+      req.userId = decoded.userId;
+      req.organizationId = decoded.organizationId;
+      req.user = decoded;
+    } catch {
+    }
+    next();
+  };
+};
+var authenticateApiKey = (validateKeyFn) => {
+  return async (req, res, next) => {
+    try {
+      const apiKey = req.headers["x-api-key"];
+      if (!apiKey) {
+        unauthorizedResponse(res, "API key is required. Please provide x-api-key header");
+        return;
+      }
+      const validation = await validateKeyFn(apiKey);
+      if (!validation.valid) {
+        unauthorizedResponse(res, "Invalid or inactive API key");
+        return;
+      }
+      if (validation.organizationId) {
+        req.organizationId = validation.organizationId;
+      }
+      if (validation.keyId && validation.keyName) {
+        req.apiKey = {
+          _id: validation.keyId,
+          name: validation.keyName
+        };
+      }
+      next();
+    } catch {
+      unauthorizedResponse(res, "API key validation failed");
+    }
+  };
+};
+var extractOrganization = (req, _res, next) => {
+  const orgId = req.headers["x-organization-id"];
+  if (orgId) {
+    req.organizationId = orgId;
+  }
+  next();
+};
+var requireOrganization = (req, res, next) => {
+  if (!req.organizationId) {
+    unauthorizedResponse(res, "Organization ID is required");
+    return;
+  }
+  next();
+};
+
+export { authenticateApiKey, authenticateJWT, extractOrganization, optionalAuthenticateJWT, requireOrganization };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/server/middleware/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/response/response-object.ts","../../../src/server/middleware/auth.middleware.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { Response } from 'express';\r\nimport { StatusCode, StatusMessage } from '../enums/status';\r\n\r\n/**\r\n * Standard API Response Interface\r\n */\r\nexport interface ApiResponse<T = unknown> {\r\n  message: string;\r\n  data: T | null;\r\n  status: string;\r\n  statusCode: number;\r\n  paginationData?: PaginationData;\r\n  columns?: ColumnMetadata[];\r\n}\r\n\r\n/**\r\n * Pagination Data Interface\r\n */\r\nexport interface PaginationData {\r\n  total?: number;\r\n  page?: number;\r\n  limit?: number;\r\n  totalPages?: number;\r\n  hasNextPage?: boolean;\r\n  hasPrevPage?: boolean;\r\n}\r\n\r\n/**\r\n * Column Metadata Interface (for dynamic tables)\r\n */\r\nexport interface ColumnMetadata {\r\n  name: string;\r\n  datatype: string;\r\n  required: boolean;\r\n}\r\n\r\n/**\r\n * Extract column metadata from data array\r\n */\r\nexport const extractColumns = <T extends Record<string, unknown>>(\r\n  data: T[]\r\n): ColumnMetadata[] => {\r\n  if (!Array.isArray(data) || data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const sample = data[0];\r\n  return Object.entries(sample).map(([key, value]) => {\r\n    let datatype: string = typeof value;\r\n\r\n    if (value === null) {\r\n      datatype = 'null';\r\n    } else if (Array.isArray(value)) {\r\n      datatype = 'array';\r\n    } else if (value instanceof Date) {\r\n      datatype = 'date';\r\n    } else if (typeof value === 'object') {\r\n      datatype = 'object';\r\n    }\r\n\r\n    return {\r\n      name: key,\r\n      datatype,\r\n      required: value !== null && value !== undefined,\r\n    };\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response (200)\r\n */\r\nexport const successResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response with Array & Pagination (200)\r\n */\r\nexport const successResponseArr = <T>(\r\n  res: Response,\r\n  data: T[],\r\n  paginationData: PaginationData = {},\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    columns: extractColumns(data as Record<string, unknown>[]),\r\n    paginationData,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Created Response (201)\r\n */\r\nexport const createdResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Resource created successfully'\r\n): Response => {\r\n  return res.status(StatusCode.CREATED).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.CREATED,\r\n    statusCode: StatusCode.CREATED,\r\n  });\r\n};\r\n\r\n/**\r\n * No Content Response (204 as 200 with message)\r\n */\r\nexport const noContentResponse = <T = null>(\r\n  res: Response,\r\n  data: T = null as T,\r\n  message = 'No data found'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.NO_CONTENT,\r\n    statusCode: StatusCode.NO_CONTENT,\r\n  });\r\n};\r\n\r\n/**\r\n * Bad Request Response (400)\r\n */\r\nexport const badRequestResponse = (\r\n  res: Response,\r\n  message = 'Bad request',\r\n  errors: unknown = null\r\n): Response => {\r\n  return res.status(StatusCode.BAD_REQUEST).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.BAD_REQUEST,\r\n    statusCode: StatusCode.BAD_REQUEST,\r\n  });\r\n};\r\n\r\n/**\r\n * Unauthorized Response (401)\r\n */\r\nexport const unauthorizedResponse = (\r\n  res: Response,\r\n  message = 'Unauthorized access'\r\n): Response => {\r\n  return res.status(StatusCode.UNAUTHORIZED).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.UNAUTHORIZED,\r\n    statusCode: StatusCode.UNAUTHORIZED,\r\n  });\r\n};\r\n\r\n/**\r\n * Forbidden Response (403)\r\n */\r\nexport const forbiddenResponse = (\r\n  res: Response,\r\n  message = 'Access forbidden'\r\n): Response => {\r\n  return res.status(StatusCode.FORBIDDEN).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.FORBIDDEN,\r\n    statusCode: StatusCode.FORBIDDEN,\r\n  });\r\n};\r\n\r\n/**\r\n * Not Found Response (404)\r\n */\r\nexport const notFoundResponse = (\r\n  res: Response,\r\n  message = 'Resource not found'\r\n): Response => {\r\n  return res.status(StatusCode.NOT_FOUND).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.NOT_FOUND,\r\n    statusCode: StatusCode.NOT_FOUND,\r\n  });\r\n};\r\n\r\n/**\r\n * Conflict Response (409)\r\n */\r\nexport const conflictResponse = (\r\n  res: Response,\r\n  message = 'Resource conflict'\r\n): Response => {\r\n  return res.status(StatusCode.CONFLICT).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.CONFLICT,\r\n    statusCode: StatusCode.CONFLICT,\r\n  });\r\n};\r\n\r\n/**\r\n * Validation Error Response (422)\r\n */\r\nexport const validationErrorResponse = (\r\n  res: Response,\r\n  errors: unknown,\r\n  message = 'Validation failed'\r\n): Response => {\r\n  return res.status(StatusCode.UNPROCESSABLE_ENTITY).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.UNPROCESSABLE_ENTITY,\r\n    statusCode: StatusCode.UNPROCESSABLE_ENTITY,\r\n  });\r\n};\r\n\r\n/**\r\n * Error Response (500)\r\n */\r\nexport const errorResponse = (\r\n  res: Response,\r\n  error: unknown = null,\r\n  message = 'Something went wrong'\r\n): Response => {\r\n  return res.status(StatusCode.INTERNAL_ERROR).json({\r\n    message,\r\n    data: error,\r\n    status: StatusMessage.INTERNAL_ERROR,\r\n    statusCode: StatusCode.INTERNAL_ERROR,\r\n  });\r\n};\r\n\r\n/**\r\n * Rate Limit Response (429)\r\n */\r\nexport const rateLimitResponse = (\r\n  res: Response,\r\n  message = 'Too many requests, please try again later'\r\n): Response => {\r\n  return res.status(StatusCode.TOO_MANY_REQUESTS).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.TOO_MANY_REQUESTS,\r\n    statusCode: StatusCode.TOO_MANY_REQUESTS,\r\n  });\r\n};\r\n\r\nexport default {\r\n  successResponse,\r\n  successResponseArr,\r\n  createdResponse,\r\n  noContentResponse,\r\n  badRequestResponse,\r\n  unauthorizedResponse,\r\n  forbiddenResponse,\r\n  notFoundResponse,\r\n  conflictResponse,\r\n  validationErrorResponse,\r\n  errorResponse,\r\n  rateLimitResponse,\r\n  extractColumns,\r\n};\r\n","import type { Request, Response, NextFunction } from 'express';\r\nimport jwt from 'jsonwebtoken';\r\nimport { unauthorizedResponse, forbiddenResponse } from '../response/response-object';\r\n\r\n/**\r\n * Extended Request with auth information\r\n */\r\nexport interface AuthRequest extends Request {\r\n  userId?: string;\r\n  organizationId?: string;\r\n  apiKey?: { _id: string; name: string };\r\n  user?: Record<string, unknown>;\r\n}\r\n\r\n/**\r\n * JWT Payload Interface\r\n */\r\nexport interface JWTPayload {\r\n  userId: string;\r\n  organizationId?: string;\r\n  email?: string;\r\n  role?: string;\r\n  [key: string]: unknown;\r\n}\r\n\r\n/**\r\n * JWT Authentication Middleware\r\n * Validates Bearer token from Authorization header\r\n */\r\nexport const authenticateJWT = (secretKey: string) => {\r\n  return (req: AuthRequest, res: Response, next: NextFunction): void => {\r\n    const authHeader = req.headers.authorization;\r\n\r\n    if (!authHeader || !authHeader.startsWith('Bearer ')) {\r\n      unauthorizedResponse(res, 'Authorization header missing or malformed');\r\n      return;\r\n    }\r\n\r\n    const token = authHeader.split(' ')[1];\r\n\r\n    try {\r\n      const decoded = jwt.verify(token, secretKey) as JWTPayload;\r\n\r\n      req.userId = decoded.userId;\r\n      req.organizationId = decoded.organizationId;\r\n      req.user = decoded as Record<string, unknown>;\r\n\r\n      if (!decoded.userId) {\r\n        unauthorizedResponse(res, 'User ID not found in token');\r\n        return;\r\n      }\r\n\r\n      next();\r\n    } catch (err) {\r\n      if (err instanceof jwt.TokenExpiredError) {\r\n        unauthorizedResponse(res, 'Token has expired');\r\n        return;\r\n      }\r\n      if (err instanceof jwt.JsonWebTokenError) {\r\n        forbiddenResponse(res, 'Invalid token');\r\n        return;\r\n      }\r\n      unauthorizedResponse(res, 'Token validation failed');\r\n    }\r\n  };\r\n};\r\n\r\n/**\r\n * Optional JWT Authentication Middleware\r\n * Validates token if present, but doesn't require it\r\n */\r\nexport const optionalAuthenticateJWT = (secretKey: string) => {\r\n  return (req: AuthRequest, _res: Response, next: NextFunction): void => {\r\n    const authHeader = req.headers.authorization;\r\n\r\n    if (!authHeader || !authHeader.startsWith('Bearer ')) {\r\n      next();\r\n      return;\r\n    }\r\n\r\n    const token = authHeader.split(' ')[1];\r\n\r\n    try {\r\n      const decoded = jwt.verify(token, secretKey) as JWTPayload;\r\n      req.userId = decoded.userId;\r\n      req.organizationId = decoded.organizationId;\r\n      req.user = decoded as Record<string, unknown>;\r\n    } catch {\r\n      // Token invalid, but continue without auth\r\n    }\r\n\r\n    next();\r\n  };\r\n};\r\n\r\n/**\r\n * API Key Authentication Middleware\r\n * Validates x-api-key header\r\n */\r\nexport const authenticateApiKey = (\r\n  validateKeyFn: (key: string) => Promise<{\r\n    valid: boolean;\r\n    organizationId?: string;\r\n    keyId?: string;\r\n    keyName?: string;\r\n  }>\r\n) => {\r\n  return async (req: AuthRequest, res: Response, next: NextFunction): Promise<void> => {\r\n    try {\r\n      const apiKey = req.headers['x-api-key'] as string;\r\n\r\n      if (!apiKey) {\r\n        unauthorizedResponse(res, 'API key is required. Please provide x-api-key header');\r\n        return;\r\n      }\r\n\r\n      const validation = await validateKeyFn(apiKey);\r\n\r\n      if (!validation.valid) {\r\n        unauthorizedResponse(res, 'Invalid or inactive API key');\r\n        return;\r\n      }\r\n\r\n      if (validation.organizationId) {\r\n        req.organizationId = validation.organizationId;\r\n      }\r\n      if (validation.keyId && validation.keyName) {\r\n        req.apiKey = {\r\n          _id: validation.keyId,\r\n          name: validation.keyName,\r\n        };\r\n      }\r\n\r\n      next();\r\n    } catch {\r\n      unauthorizedResponse(res, 'API key validation failed');\r\n    }\r\n  };\r\n};\r\n\r\n/**\r\n * Organization Header Middleware\r\n * Extracts organization ID from x-organization-id header\r\n */\r\nexport const extractOrganization = (req: AuthRequest, _res: Response, next: NextFunction): void => {\r\n  const orgId = req.headers['x-organization-id'] as string;\r\n\r\n  if (orgId) {\r\n    req.organizationId = orgId;\r\n  }\r\n\r\n  next();\r\n};\r\n\r\n/**\r\n * Require Organization Middleware\r\n * Ensures organizationId is present in request\r\n */\r\nexport const requireOrganization = (req: AuthRequest, res: Response, next: NextFunction): void => {\r\n  if (!req.organizationId) {\r\n    unauthorizedResponse(res, 'Organization ID is required');\r\n    return;\r\n  }\r\n  next();\r\n};\r\n\r\nexport default {\r\n  authenticateJWT,\r\n  optionalAuthenticateJWT,\r\n  authenticateApiKey,\r\n  extractOrganization,\r\n  requireOrganization,\r\n};\r\n"]}

package/dist/server/response/index.d.mts

@@ -0,0 +1,86 @@
+import { Response } from 'express';
+
+/**
+ * Standard API Response Interface
+ */
+interface ApiResponse<T = unknown> {
+    message: string;
+    data: T | null;
+    status: string;
+    statusCode: number;
+    paginationData?: PaginationData;
+    columns?: ColumnMetadata[];
+}
+/**
+ * Pagination Data Interface
+ */
+interface PaginationData {
+    total?: number;
+    page?: number;
+    limit?: number;
+    totalPages?: number;
+    hasNextPage?: boolean;
+    hasPrevPage?: boolean;
+}
+/**
+ * Column Metadata Interface (for dynamic tables)
+ */
+interface ColumnMetadata {
+    name: string;
+    datatype: string;
+    required: boolean;
+}
+/**
+ * Extract column metadata from data array
+ */
+declare const extractColumns: <T extends Record<string, unknown>>(data: T[]) => ColumnMetadata[];
+/**
+ * Success Response (200)
+ */
+declare const successResponse: <T>(res: Response, data: T, message?: string) => Response;
+/**
+ * Success Response with Array & Pagination (200)
+ */
+declare const successResponseArr: <T>(res: Response, data: T[], paginationData?: PaginationData, message?: string) => Response;
+/**
+ * Created Response (201)
+ */
+declare const createdResponse: <T>(res: Response, data: T, message?: string) => Response;
+/**
+ * No Content Response (204 as 200 with message)
+ */
+declare const noContentResponse: <T = null>(res: Response, data?: T, message?: string) => Response;
+/**
+ * Bad Request Response (400)
+ */
+declare const badRequestResponse: (res: Response, message?: string, errors?: unknown) => Response;
+/**
+ * Unauthorized Response (401)
+ */
+declare const unauthorizedResponse: (res: Response, message?: string) => Response;
+/**
+ * Forbidden Response (403)
+ */
+declare const forbiddenResponse: (res: Response, message?: string) => Response;
+/**
+ * Not Found Response (404)
+ */
+declare const notFoundResponse: (res: Response, message?: string) => Response;
+/**
+ * Conflict Response (409)
+ */
+declare const conflictResponse: (res: Response, message?: string) => Response;
+/**
+ * Validation Error Response (422)
+ */
+declare const validationErrorResponse: (res: Response, errors: unknown, message?: string) => Response;
+/**
+ * Error Response (500)
+ */
+declare const errorResponse: (res: Response, error?: unknown, message?: string) => Response;
+/**
+ * Rate Limit Response (429)
+ */
+declare const rateLimitResponse: (res: Response, message?: string) => Response;
+
+export { type ApiResponse, type ColumnMetadata, type PaginationData, badRequestResponse, conflictResponse, createdResponse, errorResponse, extractColumns, forbiddenResponse, noContentResponse, notFoundResponse, rateLimitResponse, successResponse, successResponseArr, unauthorizedResponse, validationErrorResponse };

package/dist/server/response/index.d.ts

@@ -0,0 +1,86 @@
+import { Response } from 'express';
+
+/**
+ * Standard API Response Interface
+ */
+interface ApiResponse<T = unknown> {
+    message: string;
+    data: T | null;
+    status: string;
+    statusCode: number;
+    paginationData?: PaginationData;
+    columns?: ColumnMetadata[];
+}
+/**
+ * Pagination Data Interface
+ */
+interface PaginationData {
+    total?: number;
+    page?: number;
+    limit?: number;
+    totalPages?: number;
+    hasNextPage?: boolean;
+    hasPrevPage?: boolean;
+}
+/**
+ * Column Metadata Interface (for dynamic tables)
+ */
+interface ColumnMetadata {
+    name: string;
+    datatype: string;
+    required: boolean;
+}
+/**
+ * Extract column metadata from data array
+ */
+declare const extractColumns: <T extends Record<string, unknown>>(data: T[]) => ColumnMetadata[];
+/**
+ * Success Response (200)
+ */
+declare const successResponse: <T>(res: Response, data: T, message?: string) => Response;
+/**
+ * Success Response with Array & Pagination (200)
+ */
+declare const successResponseArr: <T>(res: Response, data: T[], paginationData?: PaginationData, message?: string) => Response;
+/**
+ * Created Response (201)
+ */
+declare const createdResponse: <T>(res: Response, data: T, message?: string) => Response;
+/**
+ * No Content Response (204 as 200 with message)
+ */
+declare const noContentResponse: <T = null>(res: Response, data?: T, message?: string) => Response;
+/**
+ * Bad Request Response (400)
+ */
+declare const badRequestResponse: (res: Response, message?: string, errors?: unknown) => Response;
+/**
+ * Unauthorized Response (401)
+ */
+declare const unauthorizedResponse: (res: Response, message?: string) => Response;
+/**
+ * Forbidden Response (403)
+ */
+declare const forbiddenResponse: (res: Response, message?: string) => Response;
+/**
+ * Not Found Response (404)
+ */
+declare const notFoundResponse: (res: Response, message?: string) => Response;
+/**
+ * Conflict Response (409)
+ */
+declare const conflictResponse: (res: Response, message?: string) => Response;
+/**
+ * Validation Error Response (422)
+ */
+declare const validationErrorResponse: (res: Response, errors: unknown, message?: string) => Response;
+/**
+ * Error Response (500)
+ */
+declare const errorResponse: (res: Response, error?: unknown, message?: string) => Response;
+/**
+ * Rate Limit Response (429)
+ */
+declare const rateLimitResponse: (res: Response, message?: string) => Response;
+
+export { type ApiResponse, type ColumnMetadata, type PaginationData, badRequestResponse, conflictResponse, createdResponse, errorResponse, extractColumns, forbiddenResponse, noContentResponse, notFoundResponse, rateLimitResponse, successResponse, successResponseArr, unauthorizedResponse, validationErrorResponse };

package/dist/server/response/index.js

@@ -0,0 +1,140 @@
+'use strict';
+
+// src/server/response/response-object.ts
+var extractColumns = (data) => {
+  if (!Array.isArray(data) || data.length === 0) {
+    return [];
+  }
+  const sample = data[0];
+  return Object.entries(sample).map(([key, value]) => {
+    let datatype = typeof value;
+    if (value === null) {
+      datatype = "null";
+    } else if (Array.isArray(value)) {
+      datatype = "array";
+    } else if (value instanceof Date) {
+      datatype = "date";
+    } else if (typeof value === "object") {
+      datatype = "object";
+    }
+    return {
+      name: key,
+      datatype,
+      required: value !== null && value !== void 0
+    };
+  });
+};
+var successResponse = (res, data, message = "Operation successful") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    status: "success" /* SUCCESS */,
+    statusCode: 200 /* SUCCESS */
+  });
+};
+var successResponseArr = (res, data, paginationData = {}, message = "Operation successful") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    columns: extractColumns(data),
+    paginationData,
+    status: "success" /* SUCCESS */,
+    statusCode: 200 /* SUCCESS */
+  });
+};
+var createdResponse = (res, data, message = "Resource created successfully") => {
+  return res.status(201 /* CREATED */).json({
+    message,
+    data,
+    status: "created" /* CREATED */,
+    statusCode: 201 /* CREATED */
+  });
+};
+var noContentResponse = (res, data = null, message = "No data found") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    status: "no-data-found" /* NO_CONTENT */,
+    statusCode: 204 /* NO_CONTENT */
+  });
+};
+var badRequestResponse = (res, message = "Bad request", errors = null) => {
+  return res.status(400 /* BAD_REQUEST */).json({
+    message,
+    data: errors,
+    status: "bad-request" /* BAD_REQUEST */,
+    statusCode: 400 /* BAD_REQUEST */
+  });
+};
+var unauthorizedResponse = (res, message = "Unauthorized access") => {
+  return res.status(401 /* UNAUTHORIZED */).json({
+    message,
+    data: null,
+    status: "unauthorized" /* UNAUTHORIZED */,
+    statusCode: 401 /* UNAUTHORIZED */
+  });
+};
+var forbiddenResponse = (res, message = "Access forbidden") => {
+  return res.status(403 /* FORBIDDEN */).json({
+    message,
+    data: null,
+    status: "forbidden" /* FORBIDDEN */,
+    statusCode: 403 /* FORBIDDEN */
+  });
+};
+var notFoundResponse = (res, message = "Resource not found") => {
+  return res.status(404 /* NOT_FOUND */).json({
+    message,
+    data: null,
+    status: "not-found" /* NOT_FOUND */,
+    statusCode: 404 /* NOT_FOUND */
+  });
+};
+var conflictResponse = (res, message = "Resource conflict") => {
+  return res.status(409 /* CONFLICT */).json({
+    message,
+    data: null,
+    status: "conflict" /* CONFLICT */,
+    statusCode: 409 /* CONFLICT */
+  });
+};
+var validationErrorResponse = (res, errors, message = "Validation failed") => {
+  return res.status(422 /* UNPROCESSABLE_ENTITY */).json({
+    message,
+    data: errors,
+    status: "validation-error" /* UNPROCESSABLE_ENTITY */,
+    statusCode: 422 /* UNPROCESSABLE_ENTITY */
+  });
+};
+var errorResponse = (res, error = null, message = "Something went wrong") => {
+  return res.status(500 /* INTERNAL_ERROR */).json({
+    message,
+    data: error,
+    status: "error" /* INTERNAL_ERROR */,
+    statusCode: 500 /* INTERNAL_ERROR */
+  });
+};
+var rateLimitResponse = (res, message = "Too many requests, please try again later") => {
+  return res.status(429 /* TOO_MANY_REQUESTS */).json({
+    message,
+    data: null,
+    status: "rate-limit-exceeded" /* TOO_MANY_REQUESTS */,
+    statusCode: 429 /* TOO_MANY_REQUESTS */
+  });
+};
+
+exports.badRequestResponse = badRequestResponse;
+exports.conflictResponse = conflictResponse;
+exports.createdResponse = createdResponse;
+exports.errorResponse = errorResponse;
+exports.extractColumns = extractColumns;
+exports.forbiddenResponse = forbiddenResponse;
+exports.noContentResponse = noContentResponse;
+exports.notFoundResponse = notFoundResponse;
+exports.rateLimitResponse = rateLimitResponse;
+exports.successResponse = successResponse;
+exports.successResponseArr = successResponseArr;
+exports.unauthorizedResponse = unauthorizedResponse;
+exports.validationErrorResponse = validationErrorResponse;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/server/response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/response/response-object.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import type { Response } from 'express';\r\nimport { StatusCode, StatusMessage } from '../enums/status';\r\n\r\n/**\r\n * Standard API Response Interface\r\n */\r\nexport interface ApiResponse<T = unknown> {\r\n  message: string;\r\n  data: T | null;\r\n  status: string;\r\n  statusCode: number;\r\n  paginationData?: PaginationData;\r\n  columns?: ColumnMetadata[];\r\n}\r\n\r\n/**\r\n * Pagination Data Interface\r\n */\r\nexport interface PaginationData {\r\n  total?: number;\r\n  page?: number;\r\n  limit?: number;\r\n  totalPages?: number;\r\n  hasNextPage?: boolean;\r\n  hasPrevPage?: boolean;\r\n}\r\n\r\n/**\r\n * Column Metadata Interface (for dynamic tables)\r\n */\r\nexport interface ColumnMetadata {\r\n  name: string;\r\n  datatype: string;\r\n  required: boolean;\r\n}\r\n\r\n/**\r\n * Extract column metadata from data array\r\n */\r\nexport const extractColumns = <T extends Record<string, unknown>>(\r\n  data: T[]\r\n): ColumnMetadata[] => {\r\n  if (!Array.isArray(data) || data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const sample = data[0];\r\n  return Object.entries(sample).map(([key, value]) => {\r\n    let datatype: string = typeof value;\r\n\r\n    if (value === null) {\r\n      datatype = 'null';\r\n    } else if (Array.isArray(value)) {\r\n      datatype = 'array';\r\n    } else if (value instanceof Date) {\r\n      datatype = 'date';\r\n    } else if (typeof value === 'object') {\r\n      datatype = 'object';\r\n    }\r\n\r\n    return {\r\n      name: key,\r\n      datatype,\r\n      required: value !== null && value !== undefined,\r\n    };\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response (200)\r\n */\r\nexport const successResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response with Array & Pagination (200)\r\n */\r\nexport const successResponseArr = <T>(\r\n  res: Response,\r\n  data: T[],\r\n  paginationData: PaginationData = {},\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    columns: extractColumns(data as Record<string, unknown>[]),\r\n    paginationData,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Created Response (201)\r\n */\r\nexport const createdResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Resource created successfully'\r\n): Response => {\r\n  return res.status(StatusCode.CREATED).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.CREATED,\r\n    statusCode: StatusCode.CREATED,\r\n  });\r\n};\r\n\r\n/**\r\n * No Content Response (204 as 200 with message)\r\n */\r\nexport const noContentResponse = <T = null>(\r\n  res: Response,\r\n  data: T = null as T,\r\n  message = 'No data found'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.NO_CONTENT,\r\n    statusCode: StatusCode.NO_CONTENT,\r\n  });\r\n};\r\n\r\n/**\r\n * Bad Request Response (400)\r\n */\r\nexport const badRequestResponse = (\r\n  res: Response,\r\n  message = 'Bad request',\r\n  errors: unknown = null\r\n): Response => {\r\n  return res.status(StatusCode.BAD_REQUEST).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.BAD_REQUEST,\r\n    statusCode: StatusCode.BAD_REQUEST,\r\n  });\r\n};\r\n\r\n/**\r\n * Unauthorized Response (401)\r\n */\r\nexport const unauthorizedResponse = (\r\n  res: Response,\r\n  message = 'Unauthorized access'\r\n): Response => {\r\n  return res.status(StatusCode.UNAUTHORIZED).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.UNAUTHORIZED,\r\n    statusCode: StatusCode.UNAUTHORIZED,\r\n  });\r\n};\r\n\r\n/**\r\n * Forbidden Response (403)\r\n */\r\nexport const forbiddenResponse = (\r\n  res: Response,\r\n  message = 'Access forbidden'\r\n): Response => {\r\n  return res.status(StatusCode.FORBIDDEN).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.FORBIDDEN,\r\n    statusCode: StatusCode.FORBIDDEN,\r\n  });\r\n};\r\n\r\n/**\r\n * Not Found Response (404)\r\n */\r\nexport const notFoundResponse = (\r\n  res: Response,\r\n  message = 'Resource not found'\r\n): Response => {\r\n  return res.status(StatusCode.NOT_FOUND).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.NOT_FOUND,\r\n    statusCode: StatusCode.NOT_FOUND,\r\n  });\r\n};\r\n\r\n/**\r\n * Conflict Response (409)\r\n */\r\nexport const conflictResponse = (\r\n  res: Response,\r\n  message = 'Resource conflict'\r\n): Response => {\r\n  return res.status(StatusCode.CONFLICT).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.CONFLICT,\r\n    statusCode: StatusCode.CONFLICT,\r\n  });\r\n};\r\n\r\n/**\r\n * Validation Error Response (422)\r\n */\r\nexport const validationErrorResponse = (\r\n  res: Response,\r\n  errors: unknown,\r\n  message = 'Validation failed'\r\n): Response => {\r\n  return res.status(StatusCode.UNPROCESSABLE_ENTITY).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.UNPROCESSABLE_ENTITY,\r\n    statusCode: StatusCode.UNPROCESSABLE_ENTITY,\r\n  });\r\n};\r\n\r\n/**\r\n * Error Response (500)\r\n */\r\nexport const errorResponse = (\r\n  res: Response,\r\n  error: unknown = null,\r\n  message = 'Something went wrong'\r\n): Response => {\r\n  return res.status(StatusCode.INTERNAL_ERROR).json({\r\n    message,\r\n    data: error,\r\n    status: StatusMessage.INTERNAL_ERROR,\r\n    statusCode: StatusCode.INTERNAL_ERROR,\r\n  });\r\n};\r\n\r\n/**\r\n * Rate Limit Response (429)\r\n */\r\nexport const rateLimitResponse = (\r\n  res: Response,\r\n  message = 'Too many requests, please try again later'\r\n): Response => {\r\n  return res.status(StatusCode.TOO_MANY_REQUESTS).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.TOO_MANY_REQUESTS,\r\n    statusCode: StatusCode.TOO_MANY_REQUESTS,\r\n  });\r\n};\r\n\r\nexport default {\r\n  successResponse,\r\n  successResponseArr,\r\n  createdResponse,\r\n  noContentResponse,\r\n  badRequestResponse,\r\n  unauthorizedResponse,\r\n  forbiddenResponse,\r\n  notFoundResponse,\r\n  conflictResponse,\r\n  validationErrorResponse,\r\n  errorResponse,\r\n  rateLimitResponse,\r\n  extractColumns,\r\n};\r\n"]}

package/dist/server/response/index.mjs

@@ -0,0 +1,126 @@
+// src/server/response/response-object.ts
+var extractColumns = (data) => {
+  if (!Array.isArray(data) || data.length === 0) {
+    return [];
+  }
+  const sample = data[0];
+  return Object.entries(sample).map(([key, value]) => {
+    let datatype = typeof value;
+    if (value === null) {
+      datatype = "null";
+    } else if (Array.isArray(value)) {
+      datatype = "array";
+    } else if (value instanceof Date) {
+      datatype = "date";
+    } else if (typeof value === "object") {
+      datatype = "object";
+    }
+    return {
+      name: key,
+      datatype,
+      required: value !== null && value !== void 0
+    };
+  });
+};
+var successResponse = (res, data, message = "Operation successful") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    status: "success" /* SUCCESS */,
+    statusCode: 200 /* SUCCESS */
+  });
+};
+var successResponseArr = (res, data, paginationData = {}, message = "Operation successful") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    columns: extractColumns(data),
+    paginationData,
+    status: "success" /* SUCCESS */,
+    statusCode: 200 /* SUCCESS */
+  });
+};
+var createdResponse = (res, data, message = "Resource created successfully") => {
+  return res.status(201 /* CREATED */).json({
+    message,
+    data,
+    status: "created" /* CREATED */,
+    statusCode: 201 /* CREATED */
+  });
+};
+var noContentResponse = (res, data = null, message = "No data found") => {
+  return res.status(200 /* SUCCESS */).json({
+    message,
+    data,
+    status: "no-data-found" /* NO_CONTENT */,
+    statusCode: 204 /* NO_CONTENT */
+  });
+};
+var badRequestResponse = (res, message = "Bad request", errors = null) => {
+  return res.status(400 /* BAD_REQUEST */).json({
+    message,
+    data: errors,
+    status: "bad-request" /* BAD_REQUEST */,
+    statusCode: 400 /* BAD_REQUEST */
+  });
+};
+var unauthorizedResponse = (res, message = "Unauthorized access") => {
+  return res.status(401 /* UNAUTHORIZED */).json({
+    message,
+    data: null,
+    status: "unauthorized" /* UNAUTHORIZED */,
+    statusCode: 401 /* UNAUTHORIZED */
+  });
+};
+var forbiddenResponse = (res, message = "Access forbidden") => {
+  return res.status(403 /* FORBIDDEN */).json({
+    message,
+    data: null,
+    status: "forbidden" /* FORBIDDEN */,
+    statusCode: 403 /* FORBIDDEN */
+  });
+};
+var notFoundResponse = (res, message = "Resource not found") => {
+  return res.status(404 /* NOT_FOUND */).json({
+    message,
+    data: null,
+    status: "not-found" /* NOT_FOUND */,
+    statusCode: 404 /* NOT_FOUND */
+  });
+};
+var conflictResponse = (res, message = "Resource conflict") => {
+  return res.status(409 /* CONFLICT */).json({
+    message,
+    data: null,
+    status: "conflict" /* CONFLICT */,
+    statusCode: 409 /* CONFLICT */
+  });
+};
+var validationErrorResponse = (res, errors, message = "Validation failed") => {
+  return res.status(422 /* UNPROCESSABLE_ENTITY */).json({
+    message,
+    data: errors,
+    status: "validation-error" /* UNPROCESSABLE_ENTITY */,
+    statusCode: 422 /* UNPROCESSABLE_ENTITY */
+  });
+};
+var errorResponse = (res, error = null, message = "Something went wrong") => {
+  return res.status(500 /* INTERNAL_ERROR */).json({
+    message,
+    data: error,
+    status: "error" /* INTERNAL_ERROR */,
+    statusCode: 500 /* INTERNAL_ERROR */
+  });
+};
+var rateLimitResponse = (res, message = "Too many requests, please try again later") => {
+  return res.status(429 /* TOO_MANY_REQUESTS */).json({
+    message,
+    data: null,
+    status: "rate-limit-exceeded" /* TOO_MANY_REQUESTS */,
+    statusCode: 429 /* TOO_MANY_REQUESTS */
+  });
+};
+
+export { badRequestResponse, conflictResponse, createdResponse, errorResponse, extractColumns, forbiddenResponse, noContentResponse, notFoundResponse, rateLimitResponse, successResponse, successResponseArr, unauthorizedResponse, validationErrorResponse };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/server/response/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/server/response/response-object.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import type { Response } from 'express';\r\nimport { StatusCode, StatusMessage } from '../enums/status';\r\n\r\n/**\r\n * Standard API Response Interface\r\n */\r\nexport interface ApiResponse<T = unknown> {\r\n  message: string;\r\n  data: T | null;\r\n  status: string;\r\n  statusCode: number;\r\n  paginationData?: PaginationData;\r\n  columns?: ColumnMetadata[];\r\n}\r\n\r\n/**\r\n * Pagination Data Interface\r\n */\r\nexport interface PaginationData {\r\n  total?: number;\r\n  page?: number;\r\n  limit?: number;\r\n  totalPages?: number;\r\n  hasNextPage?: boolean;\r\n  hasPrevPage?: boolean;\r\n}\r\n\r\n/**\r\n * Column Metadata Interface (for dynamic tables)\r\n */\r\nexport interface ColumnMetadata {\r\n  name: string;\r\n  datatype: string;\r\n  required: boolean;\r\n}\r\n\r\n/**\r\n * Extract column metadata from data array\r\n */\r\nexport const extractColumns = <T extends Record<string, unknown>>(\r\n  data: T[]\r\n): ColumnMetadata[] => {\r\n  if (!Array.isArray(data) || data.length === 0) {\r\n    return [];\r\n  }\r\n\r\n  const sample = data[0];\r\n  return Object.entries(sample).map(([key, value]) => {\r\n    let datatype: string = typeof value;\r\n\r\n    if (value === null) {\r\n      datatype = 'null';\r\n    } else if (Array.isArray(value)) {\r\n      datatype = 'array';\r\n    } else if (value instanceof Date) {\r\n      datatype = 'date';\r\n    } else if (typeof value === 'object') {\r\n      datatype = 'object';\r\n    }\r\n\r\n    return {\r\n      name: key,\r\n      datatype,\r\n      required: value !== null && value !== undefined,\r\n    };\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response (200)\r\n */\r\nexport const successResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Success Response with Array & Pagination (200)\r\n */\r\nexport const successResponseArr = <T>(\r\n  res: Response,\r\n  data: T[],\r\n  paginationData: PaginationData = {},\r\n  message = 'Operation successful'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    columns: extractColumns(data as Record<string, unknown>[]),\r\n    paginationData,\r\n    status: StatusMessage.SUCCESS,\r\n    statusCode: StatusCode.SUCCESS,\r\n  });\r\n};\r\n\r\n/**\r\n * Created Response (201)\r\n */\r\nexport const createdResponse = <T>(\r\n  res: Response,\r\n  data: T,\r\n  message = 'Resource created successfully'\r\n): Response => {\r\n  return res.status(StatusCode.CREATED).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.CREATED,\r\n    statusCode: StatusCode.CREATED,\r\n  });\r\n};\r\n\r\n/**\r\n * No Content Response (204 as 200 with message)\r\n */\r\nexport const noContentResponse = <T = null>(\r\n  res: Response,\r\n  data: T = null as T,\r\n  message = 'No data found'\r\n): Response => {\r\n  return res.status(StatusCode.SUCCESS).json({\r\n    message,\r\n    data,\r\n    status: StatusMessage.NO_CONTENT,\r\n    statusCode: StatusCode.NO_CONTENT,\r\n  });\r\n};\r\n\r\n/**\r\n * Bad Request Response (400)\r\n */\r\nexport const badRequestResponse = (\r\n  res: Response,\r\n  message = 'Bad request',\r\n  errors: unknown = null\r\n): Response => {\r\n  return res.status(StatusCode.BAD_REQUEST).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.BAD_REQUEST,\r\n    statusCode: StatusCode.BAD_REQUEST,\r\n  });\r\n};\r\n\r\n/**\r\n * Unauthorized Response (401)\r\n */\r\nexport const unauthorizedResponse = (\r\n  res: Response,\r\n  message = 'Unauthorized access'\r\n): Response => {\r\n  return res.status(StatusCode.UNAUTHORIZED).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.UNAUTHORIZED,\r\n    statusCode: StatusCode.UNAUTHORIZED,\r\n  });\r\n};\r\n\r\n/**\r\n * Forbidden Response (403)\r\n */\r\nexport const forbiddenResponse = (\r\n  res: Response,\r\n  message = 'Access forbidden'\r\n): Response => {\r\n  return res.status(StatusCode.FORBIDDEN).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.FORBIDDEN,\r\n    statusCode: StatusCode.FORBIDDEN,\r\n  });\r\n};\r\n\r\n/**\r\n * Not Found Response (404)\r\n */\r\nexport const notFoundResponse = (\r\n  res: Response,\r\n  message = 'Resource not found'\r\n): Response => {\r\n  return res.status(StatusCode.NOT_FOUND).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.NOT_FOUND,\r\n    statusCode: StatusCode.NOT_FOUND,\r\n  });\r\n};\r\n\r\n/**\r\n * Conflict Response (409)\r\n */\r\nexport const conflictResponse = (\r\n  res: Response,\r\n  message = 'Resource conflict'\r\n): Response => {\r\n  return res.status(StatusCode.CONFLICT).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.CONFLICT,\r\n    statusCode: StatusCode.CONFLICT,\r\n  });\r\n};\r\n\r\n/**\r\n * Validation Error Response (422)\r\n */\r\nexport const validationErrorResponse = (\r\n  res: Response,\r\n  errors: unknown,\r\n  message = 'Validation failed'\r\n): Response => {\r\n  return res.status(StatusCode.UNPROCESSABLE_ENTITY).json({\r\n    message,\r\n    data: errors,\r\n    status: StatusMessage.UNPROCESSABLE_ENTITY,\r\n    statusCode: StatusCode.UNPROCESSABLE_ENTITY,\r\n  });\r\n};\r\n\r\n/**\r\n * Error Response (500)\r\n */\r\nexport const errorResponse = (\r\n  res: Response,\r\n  error: unknown = null,\r\n  message = 'Something went wrong'\r\n): Response => {\r\n  return res.status(StatusCode.INTERNAL_ERROR).json({\r\n    message,\r\n    data: error,\r\n    status: StatusMessage.INTERNAL_ERROR,\r\n    statusCode: StatusCode.INTERNAL_ERROR,\r\n  });\r\n};\r\n\r\n/**\r\n * Rate Limit Response (429)\r\n */\r\nexport const rateLimitResponse = (\r\n  res: Response,\r\n  message = 'Too many requests, please try again later'\r\n): Response => {\r\n  return res.status(StatusCode.TOO_MANY_REQUESTS).json({\r\n    message,\r\n    data: null,\r\n    status: StatusMessage.TOO_MANY_REQUESTS,\r\n    statusCode: StatusCode.TOO_MANY_REQUESTS,\r\n  });\r\n};\r\n\r\nexport default {\r\n  successResponse,\r\n  successResponseArr,\r\n  createdResponse,\r\n  noContentResponse,\r\n  badRequestResponse,\r\n  unauthorizedResponse,\r\n  forbiddenResponse,\r\n  notFoundResponse,\r\n  conflictResponse,\r\n  validationErrorResponse,\r\n  errorResponse,\r\n  rateLimitResponse,\r\n  extractColumns,\r\n};\r\n"]}