express-resforge 1.0.0

package/dist/utils/cleanObject.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @fileoverview High-speed runtime object optimization utility.
+ */
+/**
+ * Removes all keys containing undefined values from an object mutating it in-place
+ * to achieve zero new object allocation penalties.
+ * @template T Structural object layout constraint.
+ * @param {T} obj Target input object to cleanse.
+ * @returns {T} Cleaned reference to the exact same input object.
+ */
+export declare function cleanObject<T extends Record<string, any>>(obj: T): T;

package/dist/utils/cleanObject.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * @fileoverview High-speed runtime object optimization utility.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.cleanObject = cleanObject;
+/**
+ * Removes all keys containing undefined values from an object mutating it in-place
+ * to achieve zero new object allocation penalties.
+ * @template T Structural object layout constraint.
+ * @param {T} obj Target input object to cleanse.
+ * @returns {T} Cleaned reference to the exact same input object.
+ */
+function cleanObject(obj) {
+    if (!obj || typeof obj !== 'object')
+        return obj;
+    const keys = Object.keys(obj);
+    const length = keys.length;
+    for (let i = 0; i < length; i++) {
+        const key = keys[i];
+        if (obj[key] === undefined) {
+            delete obj[key];
+        }
+    }
+    return obj;
+}

package/dist/utils/deepMerge.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @fileoverview High-performance object merge utility focusing on pure operational speed.
+ */
+/**
+ * Performs deep structural merging of a source object into a target destination.
+ * Optimized against prototype pollution exploits.
+ * @template T Target structural shape constraint.
+ * @param {T} target Base target dictionary to append records onto.
+ * @param {Record<string, any>} source Incoming properties to map over target.
+ * @returns {T} Fully combined object layout.
+ */
+export declare function deepMerge<T extends Record<string, any>>(target: T, source: Record<string, any>): T;

package/dist/utils/deepMerge.js

@@ -0,0 +1,43 @@
+"use strict";
+/**
+ * @fileoverview High-performance object merge utility focusing on pure operational speed.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deepMerge = deepMerge;
+/**
+ * Validates if an input target represents a simple plain object structure.
+ */
+function isPlainObject(item) {
+    return !!item && typeof item === 'object' && !Array.isArray(item) && Object.prototype.toString.call(item) === '[object Object]';
+}
+/**
+ * Performs deep structural merging of a source object into a target destination.
+ * Optimized against prototype pollution exploits.
+ * @template T Target structural shape constraint.
+ * @param {T} target Base target dictionary to append records onto.
+ * @param {Record<string, any>} source Incoming properties to map over target.
+ * @returns {T} Fully combined object layout.
+ */
+function deepMerge(target, source) {
+    if (!source)
+        return target;
+    const keys = Object.keys(source);
+    const length = keys.length;
+    for (let i = 0; i < length; i++) {
+        const key = keys[i];
+        // Mitigate potential Prototype Pollution attack vectors completely
+        if (key === '__proto__' || key === 'constructor') {
+            continue;
+        }
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (isPlainObject(sourceValue) && isPlainObject(targetValue)) {
+            deepMerge(targetValue, sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            // Direct fast value assignment bypasses costly clone steps
+            target[key] = sourceValue;
+        }
+    }
+    return target;
+}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Safely parses input items to numeric limits with resilient default fallbacks.
+ */
+export declare function parseToInteger(value: unknown, fallback: number): number;

package/dist/utils/helpers.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseToInteger = parseToInteger;
+/**
+ * Safely parses input items to numeric limits with resilient default fallbacks.
+ */
+function parseToInteger(value, fallback) {
+    if (typeof value === 'number')
+        return Math.floor(value);
+    if (typeof value === 'string') {
+        const parsed = parseInt(value, 10);
+        return isNaN(parsed) ? fallback : parsed;
+    }
+    return fallback;
+}

package/dist/utils/time.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Resolves process high-resolution tuples to unified float millisecond intervals.
+ */
+export declare function calculateDeltaMs(startTime: [number, number]): number;

package/dist/utils/time.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.calculateDeltaMs = calculateDeltaMs;
+/**
+ * Resolves process high-resolution tuples to unified float millisecond intervals.
+ */
+function calculateDeltaMs(startTime) {
+    const diff = process.hrtime(startTime);
+    const ms = (diff[0] * 1000) + (diff[1] / 1000000);
+    return Math.round(ms * 100) / 100;
+}

package/dist/utils/uuid.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @fileoverview High-performance, zero-dependency UUIDv4 identifier generator.
+ */
+/**
+ * Generates an RFC4122 compliant UUID version 4 string using hardware-backed crypto.
+ * Optimized for zero external dependency runtime footprint.
+ * @returns {string} Compliant 36-character UUIDv4 string.
+ */
+export declare function generateUuid(): string;

package/dist/utils/uuid.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateUuid = generateUuid;
+const node_crypto_1 = require("node:crypto");
+/**
+ * @fileoverview High-performance, zero-dependency UUIDv4 identifier generator.
+ */
+/**
+ * Generates an RFC4122 compliant UUID version 4 string using hardware-backed crypto.
+ * Optimized for zero external dependency runtime footprint.
+ * @returns {string} Compliant 36-character UUIDv4 string.
+ */
+function generateUuid() {
+    // Use Node.js native webcrypto optimization if available (Node 18+)
+    if (typeof node_crypto_1.webcrypto?.randomUUID === 'function') {
+        return node_crypto_1.webcrypto.randomUUID();
+    }
+    // Fast performance-fallback for isolated edge configurations
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (char) => {
+        const random = (Math.random() * 16) | 0;
+        const value = char === 'x' ? random : (random & 0x3) | 0x8;
+        return value.toString(16);
+    });
+}

package/dist/version.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Current semantic version definition for the express-api-kit package.
+ */
+export declare const VERSION = "1.0.0";

package/dist/version.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * @fileoverview Current semantic version definition for the express-api-kit package.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+exports.VERSION = '1.0.0';

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "express-resforge",
+  "version": "1.0.0",
+  "description": "Enterprise-grade API response and error orchestration toolkit for Express.",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "homepage": "https://github.com/vaibhavdhake123/express-resforge#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/vaibhavdhake123/express-resforge.git"
+  },
+  "bugs": {
+    "url": "https://github.com/vaibhavdhake123/express-resforge/issues"
+  },
+  "author": "Vaibhav Dhake",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "directories": {
+    "doc": "docs",
+    "test": "tests"
+  },
+  "scripts": {
+    "build": "npx tsc",
+    "prepublishOnly": "npm run build && npm run test",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage"
+  },
+  "keywords": [
+    "express",
+    "api",
+    "response",
+    "formatter",
+    "error-handler",
+    "middleware",
+    "zod",
+    "prisma",
+    "mongoose",
+    "joi",
+    "standardization",
+    "payload",
+    "json"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "express": "^5.2.1"
+  },
+  "devDependencies": {
+    "@jest/globals": "^30.4.1",
+    "@swc/core": "^1.15.43",
+    "@swc/jest": "^0.2.39",
+    "@types/express": "^5.0.6",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^26.1.1",
+    "@types/supertest": "^7.2.0",
+    "jest": "^30.4.2",
+    "supertest": "^7.2.2",
+    "ts-jest": "^29.4.11",
+    "ts-node": "^10.9.2",
+    "typescript": "^5.8.3"
+  }
+}