@expressots/core 3.0.0 → 4.0.0-preview.3

package/lib/cjs/middleware/content-negotiation/formatters/xml-formatter.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XmlFormatter = void 0;
+/**
+ * XML formatter for content negotiation.
+ * Formats data as XML with configurable options.
+ */
+class XmlFormatter {
+    constructor(options = {}) {
+        this.options = {
+            rootElement: "root",
+            itemElement: "item",
+            prettyPrint: false,
+            xmlDeclaration: true,
+            ...options,
+        };
+    }
+    canFormat(contentType) {
+        return (contentType === "application/xml" ||
+            contentType === "text/xml" ||
+            contentType === "application/*" ||
+            contentType === "*/*");
+    }
+    format(data) {
+        const xml = this.serialize(data, this.options.rootElement || "root");
+        if (this.options.xmlDeclaration) {
+            return '<?xml version="1.0" encoding="UTF-8"?>\n' + xml;
+        }
+        return xml;
+    }
+    getContentType() {
+        return "application/xml";
+    }
+    getSupportedTypes() {
+        return ["application/xml", "text/xml"];
+    }
+    getPriority() {
+        return 0.9;
+    }
+    /**
+     * Serializes data to XML string.
+     */
+    serialize(data, rootElement) {
+        if (data === null || data === undefined) {
+            return `<${rootElement}></${rootElement}>`;
+        }
+        if (Array.isArray(data)) {
+            const items = data.map((item) => this.serialize(item, this.options.itemElement || "item"));
+            return `<${rootElement}>${this.formatXml(items.join(""))}</${rootElement}>`;
+        }
+        if (typeof data === "object") {
+            const entries = Object.entries(data);
+            const children = [];
+            const attributes = [];
+            for (const [key, value] of entries) {
+                if (this.options.attributes?.includes(key)) {
+                    attributes.push(`${key}="${this.escapeXml(String(value))}"`);
+                }
+                else {
+                    children.push(this.serialize(value, key));
+                }
+            }
+            const attrs = attributes.length > 0 ? " " + attributes.join(" ") : "";
+            const content = children.join("");
+            if (content) {
+                return `<${rootElement}${attrs}>${this.formatXml(content)}</${rootElement}>`;
+            }
+            return `<${rootElement}${attrs}></${rootElement}>`;
+        }
+        // Primitive value
+        return `<${rootElement}>${this.escapeXml(String(data))}</${rootElement}>`;
+    }
+    /**
+     * Formats XML with indentation if pretty print is enabled.
+     */
+    formatXml(xml) {
+        if (!this.options.prettyPrint) {
+            return xml;
+        }
+        // Simple pretty printing (can be enhanced)
+        let formatted = "";
+        let indent = 0;
+        const indentStr = "  ";
+        for (let i = 0; i < xml.length; i++) {
+            const char = xml[i];
+            const nextChar = xml[i + 1];
+            if (char === "<" && nextChar === "/") {
+                indent--;
+                formatted += "\n" + indentStr.repeat(Math.max(0, indent)) + char;
+            }
+            else if (char === "<") {
+                if (i > 0 && xml[i - 1] !== ">") {
+                    formatted += "\n" + indentStr.repeat(indent);
+                }
+                formatted += char;
+                if (nextChar !== "/" && nextChar !== "?") {
+                    indent++;
+                }
+            }
+            else if (char === ">") {
+                formatted += char;
+                if (nextChar && nextChar !== "<") {
+                    formatted += "\n" + indentStr.repeat(indent);
+                }
+            }
+            else {
+                formatted += char;
+            }
+        }
+        return formatted;
+    }
+    /**
+     * Escapes XML special characters.
+     */
+    escapeXml(str) {
+        return str
+            .replace(/&/g, "&amp;")
+            .replace(/</g, "&lt;")
+            .replace(/>/g, "&gt;")
+            .replace(/"/g, "&quot;")
+            .replace(/'/g, "&apos;");
+    }
+}
+exports.XmlFormatter = XmlFormatter;

package/lib/cjs/middleware/content-negotiation/formatters/yaml-formatter.js

@@ -0,0 +1,134 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.YamlFormatter = void 0;
+/**
+ * YAML formatter for content negotiation.
+ * Formats data as YAML with configurable options.
+ */
+class YamlFormatter {
+    constructor(options = {}) {
+        this.options = {
+            indent: 2,
+            quoteStrings: false,
+            lineWidth: 80,
+            ...options,
+        };
+    }
+    canFormat(contentType) {
+        return (contentType === "application/yaml" ||
+            contentType === "text/yaml" ||
+            contentType === "application/x-yaml" ||
+            contentType === "text/x-yaml" ||
+            contentType === "application/*" ||
+            contentType === "*/*");
+    }
+    format(data) {
+        return this.serialize(data, 0);
+    }
+    getContentType() {
+        return "application/yaml";
+    }
+    getSupportedTypes() {
+        return [
+            "application/yaml",
+            "text/yaml",
+            "application/x-yaml",
+            "text/x-yaml",
+        ];
+    }
+    getPriority() {
+        return 0.7;
+    }
+    /**
+     * Serializes data to YAML string.
+     */
+    serialize(data, indent) {
+        const indentStr = " ".repeat(this.options.indent || 2);
+        const currentIndent = indentStr.repeat(indent);
+        if (data === null || data === undefined) {
+            return "null";
+        }
+        if (typeof data === "string") {
+            if (this.options.quoteStrings || this.needsQuoting(data)) {
+                return `"${this.escapeString(data)}"`;
+            }
+            return data;
+        }
+        if (typeof data === "number" || typeof data === "boolean") {
+            return String(data);
+        }
+        if (Array.isArray(data)) {
+            if (data.length === 0) {
+                return "[]";
+            }
+            const items = data.map((item) => {
+                const serialized = this.serialize(item, indent + 1);
+                return `${currentIndent}${indentStr}- ${serialized.split("\n")[0]}`;
+            });
+            return items.join("\n");
+        }
+        if (typeof data === "object") {
+            const entries = Object.entries(data);
+            if (entries.length === 0) {
+                return "{}";
+            }
+            const lines = [];
+            for (const [key, value] of entries) {
+                const serialized = this.serialize(value, indent + 1);
+                const keyStr = this.needsQuoting(key) ? `"${key}"` : key;
+                if (typeof value === "object" &&
+                    value !== null &&
+                    !Array.isArray(value)) {
+                    lines.push(`${currentIndent}${keyStr}:`);
+                    const valueLines = serialized.split("\n");
+                    valueLines.forEach((line) => {
+                        if (line.trim()) {
+                            lines.push(line);
+                        }
+                    });
+                }
+                else {
+                    lines.push(`${currentIndent}${keyStr}: ${serialized.split("\n")[0]}`);
+                }
+            }
+            return lines.join("\n");
+        }
+        return String(data);
+    }
+    /**
+     * Checks if a string needs quoting in YAML.
+     */
+    needsQuoting(str) {
+        return (str.includes(":") ||
+            str.includes("#") ||
+            str.includes("|") ||
+            str.includes(">") ||
+            str.includes("&") ||
+            str.includes("*") ||
+            str.includes("!") ||
+            str.includes("%") ||
+            str.includes("@") ||
+            str.includes("`") ||
+            str.trim() !== str ||
+            /^\d/.test(str) ||
+            str === "true" ||
+            str === "false" ||
+            str === "null" ||
+            str === "yes" ||
+            str === "no" ||
+            str === "on" ||
+            str === "off");
+    }
+    /**
+     * Escapes special characters in a string.
+     */
+    escapeString(str) {
+        return str
+            .replace(/\\/g, "\\\\")
+            .replace(/"/g, '\\"')
+            .replace(/\n/g, "\\n")
+            .replace(/\r/g, "\\r")
+            .replace(/\t/g, "\\t");
+    }
+}
+exports.YamlFormatter = YamlFormatter;

package/lib/cjs/middleware/content-negotiation/index.js

@@ -0,0 +1,27 @@
+"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 });
+exports.AcceptHeaderParser = exports.FormatterRegistry = exports.ContentNegotiationService = void 0;
+/**
+ * Content negotiation module exports.
+ */
+var content_negotiation_service_js_1 = require("./content-negotiation-service.js");
+Object.defineProperty(exports, "ContentNegotiationService", { enumerable: true, get: function () { return content_negotiation_service_js_1.ContentNegotiationService; } });
+var formatter_registry_js_1 = require("./formatter-registry.js");
+Object.defineProperty(exports, "FormatterRegistry", { enumerable: true, get: function () { return formatter_registry_js_1.FormatterRegistry; } });
+var accept_header_parser_js_1 = require("./accept-header-parser.js");
+Object.defineProperty(exports, "AcceptHeaderParser", { enumerable: true, get: function () { return accept_header_parser_js_1.AcceptHeaderParser; } });
+__exportStar(require("./formatters/index.js"), exports);

package/lib/cjs/middleware/index.js

@@ -1,32 +1,60 @@
 "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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.IMorgan = exports.multer = exports.ExpressoMiddleware = exports.Middleware = void 0;
-var middleware_service_1 = require("./middleware-service");
-Object.defineProperty(exports, "Middleware", { enumerable: true, get: function () { return middleware_service_1.Middleware; } });
-Object.defineProperty(exports, "ExpressoMiddleware", { enumerable: true, get: function () { return middleware_service_1.ExpressoMiddleware; } });
-var multer_interface_1 = require("./interfaces/multer.interface");
-Object.defineProperty(exports, "multer", { enumerable: true, get: function () { return multer_interface_1.multer; } });
-exports.IMorgan = __importStar(require("./interfaces/morgan.interface"));
+exports.mergeUploadConfigs = exports.clearGlobalUploadConfig = exports.hasGlobalUploadConfig = exports.getGlobalUploadConfig = exports.setGlobalUploadConfig = exports.resetMiddlewareRegistry = exports.getMiddlewareRegistry = exports.MiddlewareRegistry = exports.clearStandalonePresets = exports.getStandalonePresetNames = exports.applyPreset = exports.definePreset = exports.timeout = exports.parallel = exports.when = exports.compose = exports.use = exports.PlainTextFormatter = exports.YamlFormatter = exports.CsvFormatter = exports.XmlFormatter = exports.JsonFormatter = exports.AcceptHeaderParser = exports.FormatterRegistry = exports.ContentNegotiationService = exports.MiddlewareProfiler = exports.MIDDLEWARE_REGISTRY = exports.getPackageName = exports.clearMiddlewareCache = exports.getRegisteredMiddleware = exports.getAvailableMiddleware = exports.resolvePackage = exports.isPackageAvailable = exports.isMiddlewareAvailable = exports.middlewareResolver = exports.ExpressoMiddleware = exports.Middleware = void 0;
+// Core middleware service and types
+var middleware_service_js_1 = require("./middleware-service.js");
+Object.defineProperty(exports, "Middleware", { enumerable: true, get: function () { return middleware_service_js_1.Middleware; } });
+Object.defineProperty(exports, "ExpressoMiddleware", { enumerable: true, get: function () { return middleware_service_js_1.ExpressoMiddleware; } });
+// Middleware resolver utilities
+var middleware_resolver_js_1 = require("./middleware-resolver.js");
+Object.defineProperty(exports, "middlewareResolver", { enumerable: true, get: function () { return middleware_resolver_js_1.middlewareResolver; } });
+Object.defineProperty(exports, "isMiddlewareAvailable", { enumerable: true, get: function () { return middleware_resolver_js_1.isMiddlewareAvailable; } });
+Object.defineProperty(exports, "isPackageAvailable", { enumerable: true, get: function () { return middleware_resolver_js_1.isPackageAvailable; } });
+Object.defineProperty(exports, "resolvePackage", { enumerable: true, get: function () { return middleware_resolver_js_1.resolvePackage; } });
+Object.defineProperty(exports, "getAvailableMiddleware", { enumerable: true, get: function () { return middleware_resolver_js_1.getAvailableMiddleware; } });
+Object.defineProperty(exports, "getRegisteredMiddleware", { enumerable: true, get: function () { return middleware_resolver_js_1.getRegisteredMiddleware; } });
+Object.defineProperty(exports, "clearMiddlewareCache", { enumerable: true, get: function () { return middleware_resolver_js_1.clearMiddlewareCache; } });
+Object.defineProperty(exports, "getPackageName", { enumerable: true, get: function () { return middleware_resolver_js_1.getPackageName; } });
+Object.defineProperty(exports, "MIDDLEWARE_REGISTRY", { enumerable: true, get: function () { return middleware_resolver_js_1.MIDDLEWARE_REGISTRY; } });
+// Middleware profiler
+var middleware_profiler_js_1 = require("./middleware-profiler.js");
+Object.defineProperty(exports, "MiddlewareProfiler", { enumerable: true, get: function () { return middleware_profiler_js_1.MiddlewareProfiler; } });
+// Content Negotiation exports
+var index_js_1 = require("./content-negotiation/index.js");
+Object.defineProperty(exports, "ContentNegotiationService", { enumerable: true, get: function () { return index_js_1.ContentNegotiationService; } });
+Object.defineProperty(exports, "FormatterRegistry", { enumerable: true, get: function () { return index_js_1.FormatterRegistry; } });
+Object.defineProperty(exports, "AcceptHeaderParser", { enumerable: true, get: function () { return index_js_1.AcceptHeaderParser; } });
+Object.defineProperty(exports, "JsonFormatter", { enumerable: true, get: function () { return index_js_1.JsonFormatter; } });
+Object.defineProperty(exports, "XmlFormatter", { enumerable: true, get: function () { return index_js_1.XmlFormatter; } });
+Object.defineProperty(exports, "CsvFormatter", { enumerable: true, get: function () { return index_js_1.CsvFormatter; } });
+Object.defineProperty(exports, "YamlFormatter", { enumerable: true, get: function () { return index_js_1.YamlFormatter; } });
+Object.defineProperty(exports, "PlainTextFormatter", { enumerable: true, get: function () { return index_js_1.PlainTextFormatter; } });
+// ═══════════════════════════════════════════════════════════════════════════
+// V4 EXPORTS - New unified middleware system
+// ═══════════════════════════════════════════════════════════════════════════
+// V4 Middleware utilities
+var middleware_utils_js_1 = require("./middleware-utils.js");
+Object.defineProperty(exports, "use", { enumerable: true, get: function () { return middleware_utils_js_1.use; } });
+Object.defineProperty(exports, "compose", { enumerable: true, get: function () { return middleware_utils_js_1.compose; } });
+Object.defineProperty(exports, "when", { enumerable: true, get: function () { return middleware_utils_js_1.when; } });
+Object.defineProperty(exports, "parallel", { enumerable: true, get: function () { return middleware_utils_js_1.parallel; } });
+Object.defineProperty(exports, "timeout", { enumerable: true, get: function () { return middleware_utils_js_1.timeout; } });
+// V4 Standalone preset helpers (free-function wrappers around
+// Middleware.definePreset / Middleware.applyPreset)
+var presets_standalone_js_1 = require("./presets-standalone.js");
+Object.defineProperty(exports, "definePreset", { enumerable: true, get: function () { return presets_standalone_js_1.definePreset; } });
+Object.defineProperty(exports, "applyPreset", { enumerable: true, get: function () { return presets_standalone_js_1.applyPreset; } });
+Object.defineProperty(exports, "getStandalonePresetNames", { enumerable: true, get: function () { return presets_standalone_js_1.getStandalonePresetNames; } });
+Object.defineProperty(exports, "clearStandalonePresets", { enumerable: true, get: function () { return presets_standalone_js_1.clearStandalonePresets; } });
+// V4 Middleware registry
+var middleware_registry_js_1 = require("./middleware-registry.js");
+Object.defineProperty(exports, "MiddlewareRegistry", { enumerable: true, get: function () { return middleware_registry_js_1.MiddlewareRegistry; } });
+Object.defineProperty(exports, "getMiddlewareRegistry", { enumerable: true, get: function () { return middleware_registry_js_1.getMiddlewareRegistry; } });
+Object.defineProperty(exports, "resetMiddlewareRegistry", { enumerable: true, get: function () { return middleware_registry_js_1.resetMiddlewareRegistry; } });
+// V4 Upload registry (for @FileUpload decorator integration)
+var upload_registry_js_1 = require("./upload-registry.js");
+Object.defineProperty(exports, "setGlobalUploadConfig", { enumerable: true, get: function () { return upload_registry_js_1.setGlobalUploadConfig; } });
+Object.defineProperty(exports, "getGlobalUploadConfig", { enumerable: true, get: function () { return upload_registry_js_1.getGlobalUploadConfig; } });
+Object.defineProperty(exports, "hasGlobalUploadConfig", { enumerable: true, get: function () { return upload_registry_js_1.hasGlobalUploadConfig; } });
+Object.defineProperty(exports, "clearGlobalUploadConfig", { enumerable: true, get: function () { return upload_registry_js_1.clearGlobalUploadConfig; } });
+Object.defineProperty(exports, "mergeUploadConfigs", { enumerable: true, get: function () { return upload_registry_js_1.mergeUploadConfigs; } });

package/lib/cjs/middleware/interfaces/content-negotiation.interface.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Content negotiation interfaces and types for ExpressoTS.
+ * Provides type-safe content negotiation with support for multiple formats,
+ * quality values, and custom formatters.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/cjs/middleware/middleware-config.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * ExpressoTS v4 Middleware Configuration Types
+ *
+ * This file contains all type definitions for the unified middleware system.
+ *
+ * @module middleware-config
+ * @public API
+ */
+Object.defineProperty(exports, "__esModule", { value: true });