@masonprotsman/common 1.0.4

package/build/errors/bad-request-error.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BadRequestError = void 0;
+const custom_error_1 = require("./custom-error");
+// Error thrown for general bad requests (e.g., email already in use)
+// Returns 400 Bad Request status with custom message
+class BadRequestError extends custom_error_1.CustomError {
+    constructor(message) {
+        super(message);
+        this.message = message;
+        this.statusCode = 400;
+        // Set prototype for proper instanceof checks with TypeScript
+        Object.setPrototypeOf(this, BadRequestError.prototype);
+    }
+    // Return error in standardized format for API response
+    serializeErrors() {
+        return [{ message: this.message }];
+    }
+}
+exports.BadRequestError = BadRequestError;

package/build/errors/custom-error.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CustomError = void 0;
+// Abstract base class for all custom errors in the application
+// Ensures consistent error structure and response format
+class CustomError extends Error {
+    constructor(message) {
+        super(message);
+        // Set prototype explicitly because we're extending a built-in class
+        // This ensures instanceof checks work correctly with TypeScript
+        Object.setPrototypeOf(this, CustomError.prototype);
+    }
+}
+exports.CustomError = CustomError;

package/build/errors/database-connection-error.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseConnectionError = void 0;
+const custom_error_1 = require("./custom-error");
+// Error thrown when database connection fails
+// Returns 500 Internal Server Error status
+class DatabaseConnectionError extends custom_error_1.CustomError {
+    constructor() {
+        super('Error connecting to database');
+        this.statusCode = 500;
+        this.reason = 'Error connecting to database';
+        // Set prototype for proper instanceof checks with TypeScript
+        Object.setPrototypeOf(this, DatabaseConnectionError.prototype);
+    }
+    // Return error in standardized format for API response
+    serializeErrors() {
+        return [{ message: this.reason }];
+    }
+}
+exports.DatabaseConnectionError = DatabaseConnectionError;

package/build/errors/not-authorized-error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotAuthorizedError = void 0;
+const custom_error_1 = require("./custom-error");
+// Error thrown when user is not authenticated or lacks proper credentials
+// Returns 401 Unauthorized status
+class NotAuthorizedError extends custom_error_1.CustomError {
+    constructor() {
+        super('Not authorized');
+        this.statusCode = 401;
+        // Set prototype for proper instanceof checks with TypeScript
+        Object.setPrototypeOf(this, NotAuthorizedError.prototype);
+    }
+    // Return error in standardized format for API response
+    serializeErrors() {
+        return [{ message: 'Not authorized' }];
+    }
+}
+exports.NotAuthorizedError = NotAuthorizedError;

package/build/errors/not-found-error.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NotFoundError = void 0;
+const custom_error_1 = require("./custom-error");
+// Error thrown when a requested route doesn't exist
+// Returns 404 Not Found status
+class NotFoundError extends custom_error_1.CustomError {
+    constructor() {
+        super('Route not found');
+        this.statusCode = 404;
+        // Set prototype for proper instanceof checks with TypeScript
+        Object.setPrototypeOf(this, NotFoundError.prototype);
+    }
+    // Return error in standardized format for API response
+    serializeErrors() {
+        return [{ message: 'Not Found' }];
+    }
+}
+exports.NotFoundError = NotFoundError;

package/build/errors/request-validation-error.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RequestValidationError = void 0;
+const custom_error_1 = require("./custom-error");
+// Error thrown when request validation fails (invalid input data)
+// Returns 400 Bad Request status
+class RequestValidationError extends custom_error_1.CustomError {
+    constructor(errors) {
+        super('Invalid request parameters');
+        this.errors = errors;
+        this.statusCode = 400;
+        // Set prototype for proper instanceof checks with TypeScript
+        Object.setPrototypeOf(this, RequestValidationError.prototype);
+    }
+    // Transform validation errors into standardized format
+    // Includes field name when available for client-side field highlighting
+    serializeErrors() {
+        return this.errors.map((err) => {
+            // For field-level validation errors, include the field path
+            if (err.type === 'field') {
+                return { message: err.msg, field: err.path };
+            }
+            // For general validation errors, return just the message
+            return { message: err.msg };
+        });
+    }
+}
+exports.RequestValidationError = RequestValidationError;

package/build/index.js

@@ -0,0 +1,26 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./errors/bad-request-error"), exports);
+__exportStar(require("./errors/custom-error"), exports);
+__exportStar(require("./errors/database-connection-error"), exports);
+__exportStar(require("./errors/not-authorized-error"), exports);
+__exportStar(require("./errors/not-found-error"), exports);
+__exportStar(require("./errors/request-validation-error"), exports);
+__exportStar(require("./middlewares/current-user"), exports);
+__exportStar(require("./middlewares/error-handler"), exports);
+__exportStar(require("./middlewares/require-auth"), exports);
+__exportStar(require("./middlewares/validate-request"), exports);

package/build/middlewares/current-user.js

@@ -0,0 +1,27 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.currentUser = void 0;
+const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
+// Middleware that extracts user info from JWT and attaches it to req.currentUser
+// Does not require authentication - just sets currentUser if valid JWT exists
+const currentUser = (req, res, next) => {
+    var _a;
+    // If no JWT in session, continue without setting currentUser
+    if (!((_a = req.session) === null || _a === void 0 ? void 0 : _a.jwt)) {
+        return next();
+    }
+    try {
+        // Verify and decode the JWT token
+        const payload = jsonwebtoken_1.default.verify(req.session.jwt, process.env.JWT_KEY);
+        // Attach user payload to request for use in route handlers
+        req.currentUser = payload;
+    }
+    catch (err) {
+        // JWT invalid or expired - silently continue without setting currentUser
+    }
+    next();
+};
+exports.currentUser = currentUser;

package/build/middlewares/error-handler.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.errorHandler = void 0;
+const custom_error_1 = require("../errors/custom-error");
+// Global error handling middleware
+// Catches all errors thrown in async route handlers (via express-async-errors)
+// and formats them into consistent API responses
+const errorHandler = (err, req, res, next) => {
+    // If error is one of our custom errors, use its status code and serialization
+    if (err instanceof custom_error_1.CustomError) {
+        return res.status(err.statusCode).send({ errors: err.serializeErrors() });
+    }
+    // For unexpected errors, return 400 with the error message
+    res.status(400).send({ message: err.message });
+};
+exports.errorHandler = errorHandler;

package/build/middlewares/require-auth.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireAuth = void 0;
+const not_authorized_error_1 = require("../errors/not-authorized-error");
+// Middleware that requires user to be authenticated
+// Must be used after currentUser middleware
+// Throws 401 error if user is not logged in
+const requireAuth = (req, res, next) => {
+    // If currentUser is not set, user is not authenticated
+    if (!req.currentUser) {
+        throw new not_authorized_error_1.NotAuthorizedError();
+    }
+    // User is authenticated - continue to route handler
+    next();
+};
+exports.requireAuth = requireAuth;

package/build/middlewares/validate-request.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateRequest = void 0;
+const express_validator_1 = require("express-validator");
+const request_validation_error_1 = require("../errors/request-validation-error");
+// Middleware that checks for validation errors from express-validator
+// Used after validation rules are applied to request body/params
+// Throws RequestValidationError if any validation rules failed
+const validateRequest = (req, res, next) => {
+    // Extract validation errors from the request
+    const errors = (0, express_validator_1.validationResult)(req);
+    // If there are validation errors, throw custom error
+    if (!errors.isEmpty()) {
+        throw new request_validation_error_1.RequestValidationError(errors.array());
+    }
+    // No errors - continue to next middleware
+    next();
+};
+exports.validateRequest = validateRequest;

package/package.json

@@ -0,0 +1,31 @@
+{
+  "name": "@masonprotsman/common",
+  "version": "1.0.4",
+  "description": "",
+  "main": "./build/index.js",
+  "types": "./build/index.d.ts",
+  "files": [
+    "build/**/*"
+  ],
+  "scripts": {
+    "clean": "del ./build/*",
+    "build": "npm run clean && tsc",
+    "pub": "git add . && git commit -m \"Updates\" && npm version patch && npm run build && npm publish --access public"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "devDependencies": {
+    "del-cli": "^5.1.0",
+    "typescript": "^5.6.2"
+  },
+  "dependencies": {
+    "@types/cookie-session": "^2.0.49",
+    "@types/express": "^5.0.0",
+    "@types/jsonwebtoken": "^9.0.7",
+    "cookie-session": "^2.1.0",
+    "express": "^4.21.0",
+    "express-validator": "^7.2.0",
+    "jsonwebtoken": "^9.0.2"
+  }
+}