xypriss 1.0.0 → 1.1.0

package/dist/cjs/middleware/safe-json-middleware.js

@@ -0,0 +1,159 @@
+'use strict';
+
+var safeSerializer = require('../mods/security/src/components/fortified-function/serializer/safe-serializer.js');
+var Logger = require('../server/utils/Logger.js');
+
+/**
+ * Safe JSON Middleware for Express
+ * Automatically handles circular references in JSON responses
+ */
+/**
+ * Creates middleware that safely handles JSON serialization
+ */
+function createSafeJsonMiddleware(options = {}) {
+    const opts = {
+        enabled: true,
+        maxDepth: 10,
+        truncateStrings: 1000,
+        includeNonEnumerable: false,
+        logCircularRefs: false,
+        customReplacer: undefined,
+        ...options,
+    };
+    return function safeJsonMiddleware(req, res, next) {
+        if (!opts.enabled) {
+            return next();
+        }
+        // Store the original json method
+        const originalJson = res.json.bind(res);
+        const originalSend = res.send.bind(res);
+        // Override res.json to use safe serialization
+        res.json = function (obj) {
+            try {
+                // Try standard JSON.stringify first for performance
+                const standardResult = JSON.stringify(obj);
+                return originalJson(obj);
+            }
+            catch (error) {
+                if (opts.logCircularRefs &&
+                    error.message.includes("circular")) {
+                    Logger.logger.debug("server", "🔄 Circular reference detected, using safe serialization:", {
+                        url: req.url,
+                        method: req.method,
+                        error: error.message,
+                    });
+                }
+                try {
+                    // Use our safe serialization
+                    const safeResult = safeSerializer.expressStringify(obj);
+                    const parsedResult = JSON.parse(safeResult);
+                    return originalJson(parsedResult);
+                }
+                catch (safeError) {
+                    Logger.logger.debug("server", "❌ Safe JSON serialization failed:", safeError);
+                    return originalJson({
+                        error: "Serialization failed",
+                        message: "Unable to serialize response object",
+                        originalError: safeError.message,
+                    });
+                }
+            }
+        };
+        // Override res.send to handle objects that might be passed directly
+        res.send = function (body) {
+            if (typeof body === "object" &&
+                body !== null &&
+                !Buffer.isBuffer(body)) {
+                // If it's an object, use our safe json method
+                return res.json(body);
+            }
+            return originalSend(body);
+        };
+        next();
+    };
+}
+/**
+ * Quick setup function for common use cases
+ */
+function setupSafeJson(app, options = {}) {
+    app.use(createSafeJsonMiddleware(options));
+}
+/**
+ * Utility function to safely stringify any object
+ */
+function safeJsonStringify(obj, options = {}) {
+    try {
+        return JSON.stringify(obj);
+    }
+    catch (error) {
+        return safeSerializer.expressStringify(obj);
+    }
+}
+/**
+ * Enhanced res.json replacement that can be used manually
+ */
+function sendSafeJson(res, obj, options = {}) {
+    try {
+        const result = safeJsonStringify(obj, options);
+        res.setHeader("Content-Type", "application/json");
+        res.send(result);
+    }
+    catch (error) {
+        console.error("❌ Failed to send safe JSON:", error);
+        res.status(500).json({
+            error: "Internal Server Error",
+            message: "Failed to serialize response",
+        });
+    }
+}
+/**
+ * Middleware specifically for debugging circular references
+ */
+function createCircularRefDebugger() {
+    return function circularRefDebugger(req, res, next) {
+        const originalJson = res.json.bind(res);
+        res.json = function (obj) {
+            try {
+                JSON.stringify(obj);
+                return originalJson(obj);
+            }
+            catch (error) {
+                if (error.message.includes("circular")) {
+                    console.log("🔍 Circular Reference Debug Info:");
+                    console.log("  Route:", req.method, req.url);
+                    console.log("  Object type:", typeof obj);
+                    console.log("  Object constructor:", obj?.constructor?.name);
+                    console.log("  Object keys:", Object.keys(obj || {}));
+                    // Try to identify the circular reference
+                    const seen = new WeakSet();
+                    const findCircular = (obj, path = []) => {
+                        if (typeof obj !== "object" || obj === null)
+                            return [];
+                        if (seen.has(obj))
+                            return path;
+                        seen.add(obj);
+                        for (const [key, value] of Object.entries(obj)) {
+                            const result = findCircular(value, [...path, key]);
+                            if (result.length > 0)
+                                return result;
+                        }
+                        return [];
+                    };
+                    const circularPath = findCircular(obj);
+                    if (circularPath.length > 0) {
+                        console.log("  Circular path:", circularPath.join(" -> "));
+                    }
+                }
+                throw error;
+            }
+        };
+        next();
+    };
+}
+
+exports.createCircularRefDebugger = createCircularRefDebugger;
+exports.createSafeJsonMiddleware = createSafeJsonMiddleware;
+exports.safeJsonStringify = safeJsonStringify;
+exports.sendSafeJson = sendSafeJson;
+exports.setupSafeJson = setupSafeJson;
+//# sourceMappingURL=safe-json-middleware.js.map

package/dist/cjs/middleware/safe-json-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-json-middleware.js","sources":["../../../src/middleware/safe-json-middleware.ts"],"sourcesContent":[null],"names":["logger","expressStringify"],"mappings":"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"}