@xapi-js/adaptor-express 1.1.0 → 1.2.0

package/dist/index.cjs

@@ -0,0 +1,53 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+let __xapi_js_core = require("@xapi-js/core");
+__xapi_js_core = __toESM(__xapi_js_core);
+
+//#region src/index.ts
+/**
+* Express middleware to handle X-API XML requests and responses.
+* It parses incoming XML into an XapiRoot object, passes it to the provided handler function,
+* and then serializes the handler's XapiRoot response back into XML.
+*
+* @param handler - An asynchronous function that takes an XapiRoot object and returns a Promise of an XapiRoot object.
+* @returns An Express middleware function.
+*/
+const xapiExpress = (handler) => {
+	return async (req, res, next) => {
+		if (req.headers["content-type"] !== "application/xml") return next();
+		try {
+			const xapiReq = (0, __xapi_js_core.parse)(req.body);
+			const xapiRes = await handler(xapiReq);
+			const xml = (0, __xapi_js_core.write)(xapiRes);
+			res.setHeader("Content-Type", "application/xml");
+			res.write(xml);
+			res.end();
+		} catch (error) {
+			next(error);
+		}
+	};
+};
+
+//#endregion
+exports.xapiExpress = xapiExpress;

package/dist/index.d.cts

@@ -0,0 +1,21 @@
+import { XapiRoot } from "@xapi-js/core";
+import { NextFunction, Request, Response } from "express";
+
+//#region src/index.d.ts
+
+/**
+ * Type definition for an X-API Express handler function.
+ * This function receives an XapiRoot object (parsed from the request body) and should return a Promise resolving to an XapiRoot object (for the response).
+ */
+type XapiExpressHandler = (xapi: XapiRoot) => Promise<XapiRoot>;
+/**
+ * Express middleware to handle X-API XML requests and responses.
+ * It parses incoming XML into an XapiRoot object, passes it to the provided handler function,
+ * and then serializes the handler's XapiRoot response back into XML.
+ *
+ * @param handler - An asynchronous function that takes an XapiRoot object and returns a Promise of an XapiRoot object.
+ * @returns An Express middleware function.
+ */
+declare const xapiExpress: (handler: XapiExpressHandler) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
+//#endregion
+export { xapiExpress };

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { XapiRoot } from "@xapi-js/core";
+import { NextFunction, Request, Response } from "express";
+
+//#region src/index.d.ts
+
+/**
+ * Type definition for an X-API Express handler function.
+ * This function receives an XapiRoot object (parsed from the request body) and should return a Promise resolving to an XapiRoot object (for the response).
+ */
+type XapiExpressHandler = (xapi: XapiRoot) => Promise<XapiRoot>;
+/**
+ * Express middleware to handle X-API XML requests and responses.
+ * It parses incoming XML into an XapiRoot object, passes it to the provided handler function,
+ * and then serializes the handler's XapiRoot response back into XML.
+ *
+ * @param handler - An asynchronous function that takes an XapiRoot object and returns a Promise of an XapiRoot object.
+ * @returns An Express middleware function.
+ */
+declare const xapiExpress: (handler: XapiExpressHandler) => (req: Request, res: Response, next: NextFunction) => Promise<void>;
+//#endregion
+export { xapiExpress };

package/dist/index.js

@@ -0,0 +1,29 @@
+import { parse, write } from "@xapi-js/core";
+
+//#region src/index.ts
+/**
+* Express middleware to handle X-API XML requests and responses.
+* It parses incoming XML into an XapiRoot object, passes it to the provided handler function,
+* and then serializes the handler's XapiRoot response back into XML.
+*
+* @param handler - An asynchronous function that takes an XapiRoot object and returns a Promise of an XapiRoot object.
+* @returns An Express middleware function.
+*/
+const xapiExpress = (handler) => {
+	return async (req, res, next) => {
+		if (req.headers["content-type"] !== "application/xml") return next();
+		try {
+			const xapiReq = parse(req.body);
+			const xapiRes = await handler(xapiReq);
+			const xml = write(xapiRes);
+			res.setHeader("Content-Type", "application/xml");
+			res.write(xml);
+			res.end();
+		} catch (error) {
+			next(error);
+		}
+	};
+};
+
+//#endregion
+export { xapiExpress };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@xapi-js/adaptor-express",
   "type": "module",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -31,14 +31,14 @@
   "license": "MIT",
   "dependencies": {
     "express": "^5.1.0",
-    "@xapi-js/core": "1.1.0"
+    "@xapi-js/core": "1.2.0"
   },
   "devDependencies": {
     "@types/express": "^5.0.3",
     "node-mocks-http": "^1.17.2"
   },
   "scripts": {
-    "build": "tsup src/index.ts --format cjs,esm --dts",
+    "build": "tsdown",
     "test": "vitest run",
     "test:watch": "vitest",
     "coverage": "vitest run --coverage"