@spinajs/http 2.0.481 → 2.0.482

package/lib/cjs/middlewares/PerfRollup.d.ts

@@ -0,0 +1,19 @@
+import * as express from 'express';
+import { ServerMiddleware, Request as sRequest } from '../interfaces.js';
+/**
+ * Emits one perf rollup per request ( eg. "orm.query x14 240ms" ). Creates the
+ * accumulator on `req.storage.perf` in `before()` — which is the SAME object the
+ * action's `AsyncLocalStorage.run(req.storage, …)` exposes, so measurements taken
+ * during the request land in it — then flushes it to every PerfSink on the
+ * response `finish` event.
+ *
+ * Config:
+ *   http.perf.enabled  (default true)
+ */
+export declare class PerfRollup extends ServerMiddleware {
+    protected Enabled: boolean;
+    constructor();
+    before(): ((req: sRequest, res: express.Response, next: express.NextFunction) => void) | null;
+    after(): null;
+}
+//# sourceMappingURL=PerfRollup.d.ts.map

package/lib/cjs/middlewares/PerfRollup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfRollup.d.ts","sourceRoot":"","sources":["../../../src/middlewares/PerfRollup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAKnC,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;;;;;;GASG;AACH,qBACa,UAAW,SAAQ,gBAAgB;IAE9C,SAAS,CAAC,OAAO,EAAG,OAAO,CAAC;;IAQrB,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI,CAAC,GAAG,IAAI;IAe7F,KAAK,IAAI,IAAI;CAGrB"}

package/lib/cjs/middlewares/PerfRollup.js

@@ -0,0 +1,61 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PerfRollup = void 0;
+const di_1 = require("@spinajs/di");
+const configuration_1 = require("@spinajs/configuration");
+const log_1 = require("@spinajs/log");
+const interfaces_js_1 = require("../interfaces.js");
+/**
+ * Emits one perf rollup per request ( eg. "orm.query x14 240ms" ). Creates the
+ * accumulator on `req.storage.perf` in `before()` — which is the SAME object the
+ * action's `AsyncLocalStorage.run(req.storage, …)` exposes, so measurements taken
+ * during the request land in it — then flushes it to every PerfSink on the
+ * response `finish` event.
+ *
+ * Config:
+ *   http.perf.enabled  (default true)
+ */
+let PerfRollup = class PerfRollup extends interfaces_js_1.ServerMiddleware {
+    constructor() {
+        super();
+        // Needs req.storage ( ReqStorage = -2 ); sits alongside AccessLog ( Order 2 ).
+        this.Order = 2;
+    }
+    before() {
+        if (!this.Enabled)
+            return null;
+        return (req, res, next) => {
+            const startedAt = Date.now();
+            req.storage.perf = { requestId: req.storage.requestId, byName: {} };
+            res.on('finish', () => {
+                log_1.Perf.flushScope(req.storage.perf, {
+                    labels: { method: req.method, route: req.route?.path ?? req.originalUrl, status: res.statusCode },
+                    totalMs: Date.now() - startedAt,
+                });
+            });
+            next();
+        };
+    }
+    after() {
+        return null;
+    }
+};
+exports.PerfRollup = PerfRollup;
+__decorate([
+    (0, configuration_1.Config)('http.perf.enabled', { defaultValue: true }),
+    __metadata("design:type", Boolean)
+], PerfRollup.prototype, "Enabled", void 0);
+exports.PerfRollup = PerfRollup = __decorate([
+    (0, di_1.Injectable)(interfaces_js_1.ServerMiddleware),
+    __metadata("design:paramtypes", [])
+], PerfRollup);
+//# sourceMappingURL=PerfRollup.js.map

package/lib/cjs/middlewares/PerfRollup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PerfRollup.js","sourceRoot":"","sources":["../../../src/middlewares/PerfRollup.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oCAAyC;AACzC,0DAAgD;AAChD,sCAAoC;AAEpC,oDAAyE;AAEzE;;;;;;;;;GASG;AAEI,IAAM,UAAU,GAAhB,MAAM,UAAW,SAAQ,gCAAgB;IAI9C;QACE,KAAK,EAAE,CAAC;QACR,+EAA+E;QAC/E,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,MAAM;QACX,IAAI,CAAC,IAAI,CAAC,OAAO;YAAE,OAAO,IAAI,CAAC;QAC/B,OAAO,CAAC,GAAG,EAAE,GAAG,EAAE,IAAI,EAAE,EAAE;YACxB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAC7B,GAAG,CAAC,OAAO,CAAC,IAAI,GAAG,EAAE,SAAS,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;YACpE,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;gBACpB,UAAI,CAAC,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;oBAChC,MAAM,EAAE,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,KAAK,EAAG,GAAG,CAAC,KAA2B,EAAE,IAAI,IAAI,GAAG,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE;oBACxH,OAAO,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;iBAChC,CAAC,CAAC;YACL,CAAC,CAAC,CAAC;YACH,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;IAEM,KAAK;QACV,OAAO,IAAI,CAAC;IACd,CAAC;CACF,CAAA;AA5BY,gCAAU;AAEX;IADT,IAAA,sBAAM,EAAC,mBAAmB,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;;2CACxB;qBAFjB,UAAU;IADtB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,UAAU,CA4BtB"}

package/lib/cjs/middlewares/RequestId.d.ts

@@ -1,9 +1,8 @@
 import { Response, NextFunction } from 'express';
 import { ServerMiddleware, Request as sRequest } from '../interfaces.js';
-import * as express from 'express';
 export declare class RequestId extends ServerMiddleware {
     constructor();
-    after(): (_req: sRequest, _res: express.Response, next: express.NextFunction) => void;
+    after(): null;
     before(): (req: sRequest, res: Response<any, Record<string, any>>, next: NextFunction) => void;
 }
 //# sourceMappingURL=RequestId.d.ts.map

package/lib/cjs/middlewares/RequestId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RequestId.d.ts","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,qBACa,SAAU,SAAQ,gBAAgB;;IAMtC,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;IAOrF,MAAM,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI;CAMtG"}
+{"version":3,"file":"RequestId.d.ts","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAMzE,qBACa,SAAU,SAAQ,gBAAgB;;IAMtC,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,CAAC,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI;CAqBtG"}

package/lib/cjs/middlewares/RequestId.js

@@ -13,20 +13,34 @@ exports.RequestId = void 0;
 const interfaces_js_1 = require("../interfaces.js");
 const uuid_1 = require("uuid");
 const di_1 = require("@spinajs/di");
+const log_1 = require("@spinajs/log");
 let RequestId = class RequestId extends interfaces_js_1.ServerMiddleware {
     constructor() {
         super();
         this.Order = 1;
     }
     after() {
-        return (req, res, next) => {
-            res.header('x-request-id', req.storage.requestId);
-            next();
-        };
+        // The x-request-id header is set in before() instead. ServerMiddleware
+        // after() handlers do NOT run for matched controller routes (the response
+        // is flushed inside the controllers router without calling next()), so
+        // setting the header here would silently drop it on every real response.
+        return null;
     }
     before() {
-        return (req, _res, next) => {
+        return (req, res, next) => {
             req.storage.requestId = (0, uuid_1.v4)();
+            // Continue an inbound W3C traceparent ( or start a new trace ) and seed
+            // traceId / spanId onto req.storage so the ambient log context merges them
+            // into every log line — trace ids are shared across services.
+            const tc = (0, log_1.newTraceContext)(req.headers['traceparent']);
+            req.storage.traceId = tc.traceId;
+            req.storage.spanId = tc.spanId;
+            // Emit the outbound traceparent here ( not in after() ) because the
+            // `sampled` flag lives on this freshly-computed context and req.storage —
+            // typed as the public IActionLocalStoregeContext — deliberately does not
+            // carry it. Setting a response header before next() is safe as long as the
+            // response has not been sent, mirroring x-request-id.
+            res.header('traceparent', (0, log_1.formatTraceparent)(tc));
             next();
         };
     }

package/lib/cjs/middlewares/RequestId.js.map

@@ -1 +1 @@
-{"version":3,"file":"RequestId.js","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAyE;AAEzE,+BAAoC;AACpC,oCAAyC;AAGlC,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,gCAAgB;IAC7C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,GAAG,CAAC,MAAM,CAAC,cAAc,EAAE,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;YAClD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,IAAsB,EAAE,IAA0B,EAAE,EAAE;YAC3E,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;YACjC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AAnBY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,SAAS,CAmBrB"}
+{"version":3,"file":"RequestId.js","sourceRoot":"","sources":["../../../src/middlewares/RequestId.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAyE;AAEzE,+BAAoC;AACpC,oCAAyC;AACzC,sCAAiF;AAG1E,IAAM,SAAS,GAAf,MAAM,SAAU,SAAQ,gCAAgB;IAC7C;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,uEAAuE;QACvE,0EAA0E;QAC1E,uEAAuE;QACvE,yEAAyE;QACzE,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,GAAG,CAAC,OAAO,CAAC,SAAS,GAAG,IAAA,SAAM,GAAE,CAAC;YAEjC,wEAAwE;YACxE,2EAA2E;YAC3E,8DAA8D;YAC9D,MAAM,EAAE,GAAkB,IAAA,qBAAe,EAAC,GAAG,CAAC,OAAO,CAAC,aAAa,CAAuB,CAAC,CAAC;YAC5F,GAAG,CAAC,OAAO,CAAC,OAAO,GAAG,EAAE,CAAC,OAAO,CAAC;YACjC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,MAAM,CAAC;YAE/B,oEAAoE;YACpE,0EAA0E;YAC1E,yEAAyE;YACzE,2EAA2E;YAC3E,sDAAsD;YACtD,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,IAAA,uBAAiB,EAAC,EAAE,CAAC,CAAC,CAAC;YAEjD,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AAnCY,8BAAS;oBAAT,SAAS;IADrB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,SAAS,CAmCrB"}

package/lib/cjs/middlewares/ResponseTime.d.ts

@@ -2,10 +2,9 @@ import { Request, Response, NextFunction } from 'express';
 import { ParamsDictionary } from 'express-serve-static-core';
 import { ParsedQs } from 'qs';
 import { ServerMiddleware } from '../interfaces.js';
-import * as express from 'express';
 export declare class ResponseTime extends ServerMiddleware {
     constructor();
-    after(): (req: express.Request, _res: express.Response, _next: express.NextFunction) => void;
+    after(): null;
     before(): (_req: Request<ParamsDictionary, any, any, ParsedQs, Record<string, any>>, res: Response<any, Record<string, any>>, next: NextFunction) => void;
 }
 //# sourceMappingURL=ResponseTime.d.ts.map

package/lib/cjs/middlewares/ResponseTime.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseTime.d.ts","sourceRoot":"","sources":["../../../src/middlewares/ResponseTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AACzE,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,qBACa,YAAa,SAAQ,gBAAgB;;IAMzC,KAAK,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,YAAY,KAAK,IAAI;IAY5F,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI;CAMjK"}
+{"version":3,"file":"ResponseTime.d.ts","sourceRoot":"","sources":["../../../src/middlewares/ResponseTime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC;AAC9B,OAAO,EAAE,gBAAgB,EAAuB,MAAM,kBAAkB,CAAC;AAIzE,qBACa,YAAa,SAAQ,gBAAgB;;IAazC,KAAK,IAAI,IAAI;IAQb,MAAM,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,gBAAgB,EAAE,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,YAAY,KAAK,IAAI;CAsBjK"}

package/lib/cjs/middlewares/ResponseTime.js

@@ -15,21 +15,39 @@ const di_1 = require("@spinajs/di");
 let ResponseTime = class ResponseTime extends interfaces_js_1.ServerMiddleware {
     constructor() {
         super();
-        this.Order = -1;
+        // Must sit ABOVE Compression (Order 0): the timing header is written from a
+        // res.end patch, and compression also patches res.end and flushes the
+        // headers. Whichever patch is applied last runs first (outermost), so we
+        // need a higher Order than compression to set our header before compression
+        // sends it. Same tier as the other end-of-response instrumentation
+        // (ServerTiming / AccessLog). The sub-millisecond difference in when the
+        // start timestamp is taken is irrelevant for a response-time metric.
+        this.Order = 2;
     }
     after() {
-        return (req, res, next) => {
-            const end = new Date();
-            const diff = end.getTime() - req.storage.responseStart.getTime();
-            req.storage.responseEnd = end;
-            req.storage.responseTime = diff;
-            res.header('x-response-time', diff.toString());
-            next();
-        };
+        // Timing is finalised via a res.end patch in before() instead. After()
+        // handlers do NOT run for matched controller routes (the response is
+        // flushed inside the controllers router without calling next()), so the
+        // x-response-time header set here would be dropped on every real response.
+        return null;
     }
     before() {
-        return (req, _res, next) => {
-            req.storage.responseStart = new Date();
+        return (req, res, next) => {
+            const start = new Date();
+            req.storage.responseStart = start;
+            // Finalise timing and write the header just before the response is
+            // flushed, regardless of how the controller ended it. Headers are still
+            // mutable here because the original res.end hasn't run yet.
+            const originalEnd = res.end.bind(res);
+            res.end = function patchedEnd(...args) {
+                const end = new Date();
+                req.storage.responseEnd = end;
+                req.storage.responseTime = end.getTime() - start.getTime();
+                if (!res.headersSent) {
+                    res.setHeader('x-response-time', String(req.storage.responseTime));
+                }
+                return originalEnd(...args);
+            };
             next();
         };
     }

package/lib/cjs/middlewares/ResponseTime.js.map

@@ -1 +1 @@
-{"version":3,"file":"ResponseTime.js","sourceRoot":"","sources":["../../../src/middlewares/ResponseTime.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,oDAAyE;AAEzE,oCAAyC;AAGlC,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,gCAAgB;IAChD;QACE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClB,CAAC;IAEM,KAAK;QACV,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,OAAO,EAAE,CAAC;YAEjE,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;YAC9B,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;YAChC,GAAG,CAAC,MAAM,CAAC,iBAAiB,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/C,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,IAAsB,EAAE,IAA0B,EAAE,EAAE;YAC3E,GAAG,CAAC,OAAO,CAAC,aAAa,GAAG,IAAI,IAAI,EAAE,CAAC;YACvC,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AAxBY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,YAAY,CAwBxB"}
+{"version":3,"file":"ResponseTime.js","sourceRoot":"","sources":["../../../src/middlewares/ResponseTime.ts"],"names":[],"mappings":";;;;;;;;;;;;AAGA,oDAAyE;AAEzE,oCAAyC;AAGlC,IAAM,YAAY,GAAlB,MAAM,YAAa,SAAQ,gCAAgB;IAChD;QACE,KAAK,EAAE,CAAC;QACR,4EAA4E;QAC5E,sEAAsE;QACtE,yEAAyE;QACzE,4EAA4E;QAC5E,mEAAmE;QACnE,yEAAyE;QACzE,qEAAqE;QACrE,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC;IACjB,CAAC;IAEM,KAAK;QACV,uEAAuE;QACvE,qEAAqE;QACrE,wEAAwE;QACxE,2EAA2E;QAC3E,OAAO,IAAI,CAAC;IACd,CAAC;IAEM,MAAM;QACX,OAAO,CAAC,GAAa,EAAE,GAAqB,EAAE,IAA0B,EAAE,EAAE;YAC1E,MAAM,KAAK,GAAG,IAAI,IAAI,EAAE,CAAC;YACzB,GAAG,CAAC,OAAO,CAAC,aAAa,GAAG,KAAK,CAAC;YAElC,mEAAmE;YACnE,wEAAwE;YACxE,4DAA4D;YAC5D,MAAM,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAmB,CAAC;YACvD,GAAG,CAAC,GAAW,GAAG,SAAS,UAAU,CAAyB,GAAG,IAAW;gBAC3E,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;gBACvB,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;gBAC9B,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,GAAG,CAAC,OAAO,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;gBAC3D,IAAI,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC;oBACrB,GAAG,CAAC,SAAS,CAAC,iBAAiB,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;gBACrE,CAAC;gBACD,OAAO,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;YAC9B,CAAC,CAAC;YAEF,IAAI,EAAE,CAAC;QACT,CAAC,CAAC;IACJ,CAAC;CACF,CAAA;AA3CY,oCAAY;uBAAZ,YAAY;IADxB,IAAA,eAAU,EAAC,gCAAgB,CAAC;;GAChB,YAAY,CA2CxB"}

package/lib/cjs/response-methods/file.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/response-methods/file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAGnC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAItF,qBAAa,WAAY,SAAQ,QAAQ;IAK3B,SAAS,CAAC,OAAO,EAAE,oBAAoB;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;IAJjG;;;OAGG;gBACmB,OAAO,EAAE,oBAAoB,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAOpF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BlF;AAED,qBAAa,YAAa,SAAQ,QAAQ;IAK5B,SAAS,CAAC,OAAO,EAAE,oBAAoB;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;IAJjG;;;OAGG;gBACmB,OAAO,EAAE,oBAAoB,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAOpF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAyClF;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAChC,SAAS,CAAC,IAAI,EAAE,GAAG;IAAE,SAAS,CAAC,QAAQ,EAAE,MAAM;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;gBAAnF,IAAI,EAAE,GAAG,EAAY,QAAQ,EAAE,MAAM,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAI5F,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CAyBlF"}
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../../src/response-methods/file.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAInC,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAMtF,qBAAa,WAAY,SAAQ,QAAQ;IAK3B,SAAS,CAAC,OAAO,EAAE,oBAAoB;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;IAJjG;;;OAGG;gBACmB,OAAO,EAAE,oBAAoB,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAUpF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA+BlF;AAED,qBAAa,YAAa,SAAQ,QAAQ;IAK5B,SAAS,CAAC,OAAO,EAAE,oBAAoB;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;IAJjG;;;OAGG;gBACmB,OAAO,EAAE,oBAAoB,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAWpF,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA2DlF;AAED,qBAAa,gBAAiB,SAAQ,QAAQ;IAChC,SAAS,CAAC,IAAI,EAAE,GAAG;IAAE,SAAS,CAAC,QAAQ,EAAE,MAAM;IAAE,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;gBAAnF,IAAI,EAAE,GAAG,EAAY,QAAQ,EAAE,MAAM,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAI5F,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;CA2BlF"}

package/lib/cjs/response-methods/file.js

@@ -7,9 +7,12 @@ exports.JsonFileResponse = exports.FileResponse = exports.ZipResponse = void 0;
 const di_1 = require("@spinajs/di");
 const exceptions_1 = require("@spinajs/exceptions");
 const lodash_1 = __importDefault(require("lodash"));
-const mime_1 = __importDefault(require("mime"));
+const fs_1 = require("fs");
+const path_1 = require("path");
 const interfaces_js_1 = require("./../interfaces.js");
-const index_js_1 = require("../index.js");
+// import from the defining module, not the package barrel - '../index.js' pulls
+// the whole export graph back through interfaces.js and re-forms an import cycle
+const responses_js_1 = require("../responses.js");
 class ZipResponse extends interfaces_js_1.Response {
     /**
      * Sends zipped file to client at given path & filename. If file exists
@@ -19,7 +22,10 @@ class ZipResponse extends interfaces_js_1.Response {
         super(null);
         this.Options = Options;
         this.responseOptions = responseOptions;
-        this.Options.mimeType = Options.mimeType ?? mime_1.default.getType(Options.filename) ?? undefined;
+        // The payload is always a zip archive — default to application/zip rather
+        // than deriving from the (original) download filename, which would mislabel
+        // e.g. a zipped `report.txt` as text/plain.
+        this.Options.mimeType = Options.mimeType ?? 'application/zip';
         this.Options.provider = Options.provider ?? 'local';
     }
     async execute(_req, res) {
@@ -32,9 +38,9 @@ class ZipResponse extends interfaces_js_1.Response {
         const fPath = zippedFile.asFilePath();
         return new Promise((resolve, reject) => {
             const encodedFilename = encodeURIComponent(this.Options.filename);
-            (0, index_js_1._setCoockies)(res, this.responseOptions);
-            (0, index_js_1._setHeaders)(res, this.responseOptions);
-            res.setHeader('Content-Type', this.Options.mimeType || 'application/octet-stream');
+            (0, responses_js_1._setCoockies)(res, this.responseOptions);
+            (0, responses_js_1._setHeaders)(res, this.responseOptions);
+            res.setHeader('Content-Type', this.Options.mimeType || 'application/zip');
             res.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodedFilename}`);
             res.sendFile(zippedFile.fs.resolvePath(fPath), (err) => {
                 zippedFile.fs.rm(fPath).finally(() => {
@@ -59,7 +65,11 @@ class FileResponse extends interfaces_js_1.Response {
         super(null);
         this.Options = Options;
         this.responseOptions = responseOptions;
-        this.Options.mimeType = Options.mimeType ?? mime_1.default.getType(Options.filename) ?? undefined;
+        // Do NOT default the mime type here. When the caller doesn't specify one we
+        // let res.sendFile derive it from the actual file, which yields the correct
+        // charset for text types (e.g. `text/plain; charset=utf-8`) and the right
+        // type for binaries — deriving it from the filename dropped the charset.
+        this.Options.mimeType = Options.mimeType;
         this.Options.provider = Options.provider ?? 'local';
     }
     async execute(_req, res) {
@@ -72,27 +82,41 @@ class FileResponse extends interfaces_js_1.Response {
             throw new exceptions_1.ResourceNotFound(`File ${this.Options.path} not exists`);
         }
         const file = await provider.download(this.Options.path);
+        // A local provider returns the real on-disk file (must NOT be deleted); a
+        // remote provider downloads to a throwaway temp copy that must be cleaned
+        // up after sending. Detect the local case by the file living under the
+        // provider's own base path.
+        const basePath = provider.Options?.basePath;
+        const isLocalRealFile = !!basePath && (0, path_1.resolve)(file).startsWith((0, path_1.resolve)(basePath));
         return new Promise((resolve, reject) => {
             const encodedFilename = encodeURIComponent(this.Options.filename);
-            (0, index_js_1._setCoockies)(res, this.responseOptions);
-            (0, index_js_1._setHeaders)(res, this.responseOptions);
-            res.setHeader('Content-Type', this.Options.mimeType || 'application/octet-stream');
+            (0, responses_js_1._setCoockies)(res, this.responseOptions);
+            (0, responses_js_1._setHeaders)(res, this.responseOptions);
+            // Only pin the Content-Type when the caller gave an explicit mime type;
+            // otherwise let sendFile set it from the file (correct charset / type).
+            if (this.Options.mimeType) {
+                res.setHeader('Content-Type', this.Options.mimeType);
+            }
             res.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodedFilename}`);
             res.sendFile(file, (err) => {
-                const r = () => {
+                const cleanups = [];
+                // Remove the source file on the provider when requested.
+                if (this.Options.deleteAfterDownload) {
+                    cleanups.push(provider.rm(this.Options.path).catch(() => undefined));
+                }
+                // Remove the downloaded temp copy for remote providers (never the real
+                // local file).
+                if (!isLocalRealFile) {
+                    cleanups.push(fs_1.promises.unlink(file).catch(() => undefined));
+                }
+                Promise.allSettled(cleanups).finally(() => {
                     if (!lodash_1.default.isNil(err)) {
                         reject(err);
                     }
                     else {
                         resolve();
                     }
-                };
-                if (this.Options.deleteAfterDownload) {
-                    provider.rm(this.Options.path).finally(r);
-                }
-                else {
-                    r();
-                }
+                });
             });
         });
     }
@@ -108,11 +132,13 @@ class JsonFileResponse extends interfaces_js_1.Response {
     async execute(_req, res) {
         const provider = await di_1.DI.resolve('__file_provider__', ['fs-temp']);
         const tmpPath = provider.tmppath();
-        provider.write(tmpPath, JSON.stringify(this.data));
+        // Must await: sendFile below races the write otherwise and can hit the
+        // path before it exists, producing an intermittent ENOENT / 500.
+        await provider.write(tmpPath, JSON.stringify(this.data));
         return new Promise((resolve, reject) => {
             const encodedFilename = encodeURIComponent(this.filename);
-            (0, index_js_1._setCoockies)(res, this.responseOptions);
-            (0, index_js_1._setHeaders)(res, this.responseOptions);
+            (0, responses_js_1._setCoockies)(res, this.responseOptions);
+            (0, responses_js_1._setHeaders)(res, this.responseOptions);
             res.setHeader('Content-Type', 'application/json');
             res.setHeader('Content-Disposition', `attachment; filename*=UTF-8''${encodedFilename}`);
             res.sendFile(tmpPath, (err) => {

package/lib/cjs/response-methods/file.js.map

@@ -1 +1 @@
-{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/response-methods/file.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../../src/response-methods/file.ts"],"names":[],"mappings":"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"}

package/lib/cjs/response-methods/index.d.ts

@@ -5,12 +5,15 @@ export * from './forbidden.js';
 export * from './noContent.js';
 export * from './notFound.js';
 export * from './json.js';
+export * from './xml.js';
 export * from './ok.js';
 export * from './template.js';
+export * from './redirect.js';
 export * from './serverError.js';
 export * from './unauthorized.js';
 export * from './conflict.js';
 export * from './notAllowed.js';
+export * from './notAcceptable.js';
 export * from './validationError.js';
 export * from './entityTooLarge.js';
 //# sourceMappingURL=index.d.ts.map

package/lib/cjs/response-methods/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/response-methods/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/response-methods/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC"}

package/lib/cjs/response-methods/index.js

@@ -21,12 +21,15 @@ __exportStar(require("./forbidden.js"), exports);
 __exportStar(require("./noContent.js"), exports);
 __exportStar(require("./notFound.js"), exports);
 __exportStar(require("./json.js"), exports);
+__exportStar(require("./xml.js"), exports);
 __exportStar(require("./ok.js"), exports);
 __exportStar(require("./template.js"), exports);
+__exportStar(require("./redirect.js"), exports);
 __exportStar(require("./serverError.js"), exports);
 __exportStar(require("./unauthorized.js"), exports);
 __exportStar(require("./conflict.js"), exports);
 __exportStar(require("./notAllowed.js"), exports);
+__exportStar(require("./notAcceptable.js"), exports);
 __exportStar(require("./validationError.js"), exports);
 __exportStar(require("./entityTooLarge.js"), exports);
 //# sourceMappingURL=index.js.map

package/lib/cjs/response-methods/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/response-methods/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,+CAA6B;AAC7B,4CAA0B;AAC1B,iDAA+B;AAC/B,iDAA+B;AAC/B,gDAA8B;AAC9B,4CAA0B;AAC1B,0CAAwB;AACxB,gDAA8B;AAC9B,mDAAiC;AACjC,oDAAkC;AAClC,gDAA8B;AAC9B,kDAAgC;AAChC,uDAAqC;AACrC,sDAAoC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/response-methods/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,+CAA6B;AAC7B,4CAA0B;AAC1B,iDAA+B;AAC/B,iDAA+B;AAC/B,gDAA8B;AAC9B,4CAA0B;AAC1B,2CAAyB;AACzB,0CAAwB;AACxB,gDAA8B;AAC9B,gDAA8B;AAC9B,mDAAiC;AACjC,oDAAkC;AAClC,gDAA8B;AAC9B,kDAAgC;AAChC,qDAAmC;AACnC,uDAAqC;AACrC,sDAAoC"}

package/lib/cjs/response-methods/redirect.d.ts

@@ -1,13 +1,20 @@
 import * as express from 'express';
-import { Response } from '../interfaces.js';
+import { IResponseOptions, Response } from '../interfaces.js';
 /**
- * Redirects to another route ( simple alias for request.redirect for api consistency)
+ * Redirects to another url. Simple alias over res.redirect for api consistency,
+ * with control over the redirect status code and the ability to set cookies /
+ * headers on the redirect response (useful for auth flows).
  *
- * @param url - url path to another location
+ * @param url - target url
+ * @param status - redirect status code (default 302 FOUND). Use 301/308 for
+ *                 permanent, 307 to preserve method/body.
+ * @param responseOptions - cookies / headers to set before redirecting
  */
 export declare class Redirect extends Response {
+    protected responseOptions?: IResponseOptions | undefined;
     protected url: string;
-    constructor(url: any);
+    protected status: number;
+    constructor(url: string, status?: number, responseOptions?: IResponseOptions | undefined);
     execute(_req: express.Request, res: express.Response): Promise<void>;
 }
 //# sourceMappingURL=redirect.d.ts.map

package/lib/cjs/response-methods/redirect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../../src/response-methods/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAE5C;;;;GAIG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IACpC,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;gBAEV,GAAG,EAAE,GAAG;IAMP,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ;CAGlE"}
+{"version":3,"file":"redirect.d.ts","sourceRoot":"","sources":["../../../src/response-methods/redirect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAoB,gBAAgB,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAGhF;;;;;;;;;GASG;AACH,qBAAa,QAAS,SAAQ,QAAQ;IAI8B,SAAS,CAAC,eAAe,CAAC,EAAE,gBAAgB;IAH9G,SAAS,CAAC,GAAG,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEb,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAA+B,EAAY,eAAe,CAAC,EAAE,gBAAgB,YAAA;IAOjG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ;CAMlE"}

package/lib/cjs/response-methods/redirect.js

@@ -2,18 +2,28 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Redirect = void 0;
 const interfaces_js_1 = require("../interfaces.js");
+const responses_js_1 = require("../responses.js");
 /**
- * Redirects to another route ( simple alias for request.redirect for api consistency)
+ * Redirects to another url. Simple alias over res.redirect for api consistency,
+ * with control over the redirect status code and the ability to set cookies /
+ * headers on the redirect response (useful for auth flows).
  *
- * @param url - url path to another location
+ * @param url - target url
+ * @param status - redirect status code (default 302 FOUND). Use 301/308 for
+ *                 permanent, 307 to preserve method/body.
+ * @param responseOptions - cookies / headers to set before redirecting
  */
 class Redirect extends interfaces_js_1.Response {
-    constructor(url) {
+    constructor(url, status = interfaces_js_1.HTTP_STATUS_CODE.FOUND, responseOptions) {
         super(null);
+        this.responseOptions = responseOptions;
         this.url = url;
+        this.status = status;
     }
     async execute(_req, res) {
-        res.redirect(this.url);
+        (0, responses_js_1._setCoockies)(res, this.responseOptions);
+        (0, responses_js_1._setHeaders)(res, this.responseOptions);
+        res.redirect(this.status, this.url);
     }
 }
 exports.Redirect = Redirect;

package/lib/cjs/response-methods/redirect.js.map

@@ -1 +1 @@
-{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../../src/response-methods/redirect.ts"],"names":[],"mappings":";;;AACA,oDAA4C;AAE5C;;;;GAIG;AACH,MAAa,QAAS,SAAQ,wBAAQ;IAGpC,YAAY,GAAQ;QAClB,KAAK,CAAC,IAAI,CAAC,CAAC;QAEZ,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;IACjB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAqB,EAAE,GAAqB;QAC/D,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;CACF;AAZD,4BAYC"}
+{"version":3,"file":"redirect.js","sourceRoot":"","sources":["../../../src/response-methods/redirect.ts"],"names":[],"mappings":";;;AACA,oDAAgF;AAChF,kDAA4D;AAE5D;;;;;;;;;GASG;AACH,MAAa,QAAS,SAAQ,wBAAQ;IAIpC,YAAY,GAAW,EAAE,SAAiB,gCAAgB,CAAC,KAAK,EAAY,eAAkC;QAC5G,KAAK,CAAC,IAAI,CAAC,CAAC;QAD8D,oBAAe,GAAf,eAAe,CAAmB;QAG5G,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAqB,EAAE,GAAqB;QAC/D,IAAA,2BAAY,EAAC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACxC,IAAA,0BAAW,EAAC,GAAG,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QAEvC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IACtC,CAAC;CACF;AAjBD,4BAiBC"}

package/lib/cjs/response-methods/xml.d.ts

@@ -0,0 +1,17 @@
+import * as express from 'express';
+import { HTTP_STATUS_CODE, IResponseOptions, Response, ResponseFunction } from '../interfaces.js';
+/**
+ * Returns an HTTP 200 response with an XML body, bypassing Accept-header
+ * negotiation. Use when the endpoint must always respond with XML. The data
+ * should be a plain object graph; arrays / scalars are wrapped under a
+ * `<response>` root. Optional fast-xml-parser XMLBuilder options can be passed.
+ */
+export declare class Xml<T = any> extends Response<T> {
+    protected options?: IResponseOptions | undefined;
+    protected xmlOptions?: any | undefined;
+    protected _errorCode: HTTP_STATUS_CODE;
+    protected _template: string;
+    constructor(data?: T | Promise<T> | null, options?: IResponseOptions | undefined, xmlOptions?: any | undefined);
+    execute(_req: express.Request, _res: express.Response): Promise<ResponseFunction | void>;
+}
+//# sourceMappingURL=xml.d.ts.map

package/lib/cjs/response-methods/xml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.d.ts","sourceRoot":"","sources":["../../../src/response-methods/xml.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAGlG;;;;;GAKG;AACH,qBAAa,GAAG,CAAC,CAAC,GAAG,GAAG,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAID,SAAS,CAAC,OAAO,CAAC,EAAE,gBAAgB;IAAE,SAAS,CAAC,UAAU,CAAC,EAAE,GAAG;IAH1G,SAAS,CAAC,UAAU,mBAAuB;IAC3C,SAAS,CAAC,SAAS,SAAM;gBAEb,IAAI,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAAY,OAAO,CAAC,EAAE,gBAAgB,YAAA,EAAY,UAAU,CAAC,EAAE,GAAG,YAAA;IAI7F,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,gBAAgB,GAAG,IAAI,CAAC;CAItG"}

package/lib/cjs/response-methods/xml.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Xml = void 0;
+const interfaces_js_1 = require("../interfaces.js");
+const responses_js_1 = require("../responses.js");
+/**
+ * Returns an HTTP 200 response with an XML body, bypassing Accept-header
+ * negotiation. Use when the endpoint must always respond with XML. The data
+ * should be a plain object graph; arrays / scalars are wrapped under a
+ * `<response>` root. Optional fast-xml-parser XMLBuilder options can be passed.
+ */
+class Xml extends interfaces_js_1.Response {
+    constructor(data, options, xmlOptions) {
+        super(data, options);
+        this.options = options;
+        this.xmlOptions = xmlOptions;
+        this._errorCode = interfaces_js_1.HTTP_STATUS_CODE.OK;
+        this._template = '';
+    }
+    async execute(_req, _res) {
+        const data = await this.prepareResponse();
+        return (0, responses_js_1.xmlResponse)(data, { ...this.options, StatusCode: this.options?.StatusCode ?? this._errorCode }, this.xmlOptions);
+    }
+}
+exports.Xml = Xml;
+//# sourceMappingURL=xml.js.map

package/lib/cjs/response-methods/xml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xml.js","sourceRoot":"","sources":["../../../src/response-methods/xml.ts"],"names":[],"mappings":";;;AACA,oDAAkG;AAClG,kDAA8C;AAE9C;;;;;GAKG;AACH,MAAa,GAAa,SAAQ,wBAAW;IAI3C,YAAY,IAA4B,EAAY,OAA0B,EAAY,UAAgB;QACxG,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QAD6B,YAAO,GAAP,OAAO,CAAmB;QAAY,eAAU,GAAV,UAAU,CAAM;QAHhG,eAAU,GAAG,gCAAgB,CAAC,EAAE,CAAC;QACjC,cAAS,GAAG,EAAE,CAAC;IAIzB,CAAC;IAEM,KAAK,CAAC,OAAO,CAAC,IAAqB,EAAE,IAAsB;QAChE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,eAAe,EAAE,CAAC;QAC1C,OAAO,IAAA,0BAAW,EAAC,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,IAAI,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IAC1H,CAAC;CACF;AAZD,kBAYC"}

package/lib/cjs/responses.d.ts

@@ -16,6 +16,16 @@ export declare function jsonResponse(model: any, options?: IResponseOptions): (_
  * @param status - status code
  */
 export declare function textResponse(model: any, options?: IResponseOptions): (_req: express.Request, res: express.Response) => void;
+/**
+ * Serializes data to an XML body. The payload should be a plain object graph;
+ * arrays and scalars are wrapped under a `<response>` root so the output is a
+ * single well-formed document.
+ *
+ * @param model - data to serialize
+ * @param options - response options (status, headers, cookies)
+ * @param xmlOptions - fast-xml-parser XMLBuilder options
+ */
+export declare function xmlResponse(model: any, options?: IResponseOptions, xmlOptions?: any): (_req: express.Request, res: express.Response) => void;
 /**
  * Sends html response & sets proper header. If template is not avaible, handles proper error rendering.
  *

package/lib/cjs/responses.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAwD,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAYzG,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,QA6B7E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,QAI5E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IACzD,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UAYrD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IACzD,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UAWrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IAGvE,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UA0DpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,IAwC3E,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UA0CpD"}
+{"version":3,"file":"responses.d.ts","sourceRoot":"","sources":["../../src/responses.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AACnC,OAAO,EAAwD,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAmBzG,wBAAgB,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,QA6B7E;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,CAAC,EAAE,gBAAgB,QAI5E;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IACzD,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UAcrD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IACzD,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UAgBrD;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,GAAG,IAC1E,MAAM,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UAYrD;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,gBAAgB,IAGvE,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UA0DpD;AAED;;;;;;;;GAQG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,IA+E3E,KAAK,OAAO,CAAC,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,UA4BpD"}