@abapify/adt-proxy 0.0.0 → 0.4.5

package/dist/index.d.mts

@@ -0,0 +1,92 @@
+import { RouteDefinition, Serializable } from "@abapify/speci/rest";
+//#region src/types.d.ts
+/**
+ * Configuration for the ADT proxy server
+ */
+interface AdtProxyConfig {
+  /** Port to listen on (default: 0 = random available port) */
+  port?: number;
+  /** Host to bind to (default: '127.0.0.1') */
+  host?: string;
+  /** Base URL of the downstream SAP system (e.g., 'https://sap-system.com:8000') */
+  targetUrl: string;
+  /** Authentication credentials for the downstream SAP system */
+  auth?: {
+    username: string;
+    password: string;
+    /** SAP client number (e.g., '100') */
+    client?: string;
+  };
+  /** Base path prefix to strip from incoming requests (default: '') */
+  basePath?: string;
+  /** Whether to forward all requests as-is when no schema match is found (default: true) */
+  forwardUnknown?: boolean;
+  /** Whether to convert JSON↔XML based on schema (default: true) */
+  convertContent?: boolean;
+  /** Custom headers to add to all downstream requests */
+  defaultHeaders?: Record<string, string>;
+  /** Maximum allowed request body size in bytes (default: 10MB) */
+  maxBodySize?: number;
+  /** Logger instance (must implement debug, info, warn, error methods) */
+  logger?: Logger;
+}
+/**
+ * Simple logger interface
+ */
+interface Logger {
+  debug(msg: string, obj?: any): void;
+  info(msg: string, obj?: any): void;
+  warn(msg: string, obj?: any): void;
+  error(msg: string, obj?: any): void;
+}
+/**
+ * Result of a proxied request
+ */
+interface ProxyResult {
+  /** HTTP status code from downstream */
+  status: number;
+  /** Response headers from downstream */
+  headers: Record<string, string | string[]>;
+  /** Response body (JSON string if converted, raw string otherwise) */
+  body: string;
+  /** Whether the response was converted from XML to JSON */
+  converted: boolean;
+}
+//#endregion
+//#region src/converter.d.ts
+/**
+ * Convert a JSON string to XML using a schema's build method.
+ */
+declare function jsonToXml(json: string, schema: Serializable): string;
+/**
+ * Convert an XML string to JSON using a schema's parse method.
+ */
+declare function xmlToJson(xml: string, schema: Serializable): string;
+/**
+ * Detect content type from a string or content-type header.
+ */
+declare function detectContentType(content: string, contentType?: string): 'json' | 'xml' | 'text' | 'binary';
+/**
+ * Check if a content type indicates JSON (case-insensitive).
+ */
+declare function isJsonContentType(contentType: string): boolean;
+/**
+ * Check if a content type indicates XML (case-insensitive).
+ */
+declare function isXmlContentType(contentType: string): boolean;
+//#endregion
+//#region src/proxy.d.ts
+declare function createAdtProxy(config: AdtProxyConfig): {
+  readonly routes: RouteDefinition[];
+  match: (method: string, url: string, basePath?: string) => {
+    route: RouteDefinition;
+    params: Record<string, string>;
+  } | null;
+  start(): Promise<{
+    port: number;
+  }>;
+  stop(): Promise<void>;
+};
+//#endregion
+export { type AdtProxyConfig, type Logger, type ProxyResult, createAdtProxy, detectContentType, isJsonContentType, isXmlContentType, jsonToXml, xmlToJson };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types.ts","../src/converter.ts","../src/proxy.ts"],"mappings":";;;;;UASiB;;EAEf;;EAGA;;EAGA;;EAGA;IACE;IACA;;IAEA;;;EAIF;;EAGA;;EAGA;;EAGA,iBAAiB;;EAGjB;;EAGA,SAAS;;;;;UAMM;EACf,MAAM,aAAa;EACnB,KAAK,aAAa;EAClB,KAAK,aAAa;EAClB,MAAM,aAAa;;;;;UA0BJ;;EAEf;;EAGA,SAAS;;EAGT;;EAGA;;;;;;;iBC9Ec,UAAU,cAAc,QAAQ;;;;iBAehC,UAAU,aAAa,QAAQ;;;;iBAY/B,kBACd,iBACA;;;;iBAmBc,kBAAkB;;;;iBAQlB,iBAAiB;;;iBCuGjB,eAAe,QAAQ;;;;;;EAuQpB,SAAA;IAAU;;EAgCX,QAAA"}

package/dist/index.mjs

@@ -0,0 +1,325 @@
+import { createServer } from "node:http";
+import { createServer as createServer$1 } from "@abapify/speci/rest";
+import { adtContract } from "@abapify/adt-contracts";
+
+//#region src/converter.ts
+/**
+* Convert a JSON string to XML using a schema's build method.
+*/
+function jsonToXml(json, schema) {
+	try {
+		const data = JSON.parse(json);
+		if (typeof schema.build === "function") return schema.build(data);
+		return json;
+	} catch {
+		return json;
+	}
+}
+/**
+* Convert an XML string to JSON using a schema's parse method.
+*/
+function xmlToJson(xml, schema) {
+	try {
+		const data = schema.parse(xml);
+		return JSON.stringify(data);
+	} catch {
+		return xml;
+	}
+}
+/**
+* Detect content type from a string or content-type header.
+*/
+function detectContentType(content, contentType) {
+	if (contentType) {
+		const ct = contentType.toLowerCase();
+		if (ct.includes("json")) return "json";
+		if (ct.includes("xml")) return "xml";
+		if (ct.includes("text")) return "text";
+		return "binary";
+	}
+	const trimmed = content.trimStart();
+	if (trimmed.startsWith("{") || trimmed.startsWith("[")) return "json";
+	if (trimmed.startsWith("<?xml") || trimmed.startsWith("<")) return "xml";
+	return "text";
+}
+/**
+* Check if a content type indicates JSON (case-insensitive).
+*/
+function isJsonContentType(contentType) {
+	const ct = contentType.toLowerCase();
+	return ct.includes("json") || ct.endsWith("+json");
+}
+/**
+* Check if a content type indicates XML (case-insensitive).
+*/
+function isXmlContentType(contentType) {
+	const ct = contentType.toLowerCase();
+	return ct.includes("xml") || ct.endsWith("+xml");
+}
+
+//#endregion
+//#region src/proxy.ts
+/**
+* ADT Proxy Server
+*
+* Proxies ADT endpoint requests to a downstream SAP system with
+* automatic JSON↔XML conversion using contract schemas.
+*
+* Architecture:
+*   Client (JSON) → Proxy → Downstream SAP (XML)
+*   Client (JSON) ← Proxy ← Downstream SAP (XML)
+*
+* The proxy uses speci's createServer to extract route definitions
+* from ADT contracts, enabling schema-aware content conversion.
+*
+* @example
+* ```typescript
+* import { createAdtProxy } from '@abapify/adt-proxy';
+*
+* const proxy = createAdtProxy({
+*   targetUrl: 'https://my-sap-system.com:8000',
+*   auth: { username: 'user', password: 'pass', client: '100' },
+* });
+*
+* const { port } = await proxy.start();
+* console.log(`Proxy running on http://localhost:${port}`);
+* ```
+*/
+const DEFAULT_LOGGER = {
+	debug: (_msg) => {},
+	info: (_msg) => {},
+	warn: console.warn,
+	error: console.error
+};
+const FORWARDABLE_REQUEST_HEADERS = [
+	"accept",
+	"content-type",
+	"x-csrf-token",
+	"x-sap-security-session",
+	"x-sap-adt-sessiontype",
+	"cookie"
+];
+const FORWARDABLE_RESPONSE_HEADERS = [
+	"content-type",
+	"x-csrf-token",
+	"x-sap-security-session",
+	"set-cookie",
+	"etag",
+	"location"
+];
+function forwardHeaders(source, target, keys) {
+	for (const h of keys) {
+		const value = source[h];
+		if (value && !target[h]) target[h] = value;
+	}
+}
+function addAuthHeaders(headers, auth) {
+	if (!auth) return;
+	if (!headers.authorization) headers.authorization = `Basic ${Buffer.from(`${auth.username}:${auth.password}`).toString("base64")}`;
+	if (auth.client && !headers["sap-client"]) headers["sap-client"] = auth.client;
+}
+function convertRequestBody(body, contentType, bodySchema) {
+	if (!body || !bodySchema || !contentType) return {
+		body,
+		converted: false
+	};
+	if (!isJsonContentType(contentType)) return {
+		body,
+		converted: false
+	};
+	return {
+		body: jsonToXml(body, bodySchema),
+		converted: true
+	};
+}
+function convertResponseBody(body, contentType, status, responseSchemas) {
+	if (!body || !isXmlContentType(contentType) || !responseSchemas[status]) return {
+		body,
+		converted: false
+	};
+	const converted = xmlToJson(body, responseSchemas[status]);
+	return {
+		body: converted,
+		converted: converted !== body
+	};
+}
+async function forwardRequest(method, url, headers, body, timeoutMs = 3e4) {
+	const controller = new AbortController();
+	const timer = setTimeout(() => controller.abort(), timeoutMs);
+	try {
+		const response = await fetch(url, {
+			method,
+			headers,
+			body: body || void 0,
+			signal: controller.signal
+		});
+		const responseBody = await response.text();
+		const responseHeaders = {};
+		response.headers.forEach((value, key) => {
+			if (key.toLowerCase() === "set-cookie") return;
+			responseHeaders[key] = value;
+		});
+		if (typeof response.headers.getSetCookie === "function") {
+			const setCookies = response.headers.getSetCookie();
+			if (setCookies.length > 0) responseHeaders["set-cookie"] = setCookies;
+		}
+		return {
+			status: response.status,
+			headers: responseHeaders,
+			body: responseBody
+		};
+	} finally {
+		clearTimeout(timer);
+	}
+}
+function createAdtProxy(config) {
+	const { targetUrl, auth, basePath = "", forwardUnknown = true, convertContent = true, defaultHeaders = {}, logger = DEFAULT_LOGGER } = config;
+	const contractRoutes = createServer$1(adtContract);
+	let server;
+	function buildDownstreamHeaders(incomingHeaders, contractHeaders) {
+		const headers = {
+			...defaultHeaders,
+			...contractHeaders
+		};
+		forwardHeaders(incomingHeaders, headers, FORWARDABLE_REQUEST_HEADERS);
+		addAuthHeaders(headers, auth);
+		if (convertContent && !headers.accept) headers.accept = "application/json";
+		return headers;
+	}
+	function buildDownstreamUrl(url) {
+		const relativePath = basePath && url.startsWith(basePath) ? url.slice(basePath.length) || "/" : url;
+		return `${targetUrl}${relativePath}`;
+	}
+	function getContentType(headers) {
+		const ct = headers["content-type"];
+		return Array.isArray(ct) ? ct[0] : ct;
+	}
+	async function handleMatchedRoute(method, url, requestBody, incomingHeaders, route) {
+		logger.info(`Matched route: ${route.method} ${route.pathTemplate}`);
+		const { body: downstreamBody, converted: reqConverted } = convertRequestBody(requestBody, getContentType(incomingHeaders), route.bodySchema);
+		const downstreamHeaders = buildDownstreamHeaders(incomingHeaders, route.requestHeaders);
+		if (reqConverted) downstreamHeaders["content-type"] = "application/xml";
+		const response = await forwardRequest(method, buildDownstreamUrl(url), downstreamHeaders, downstreamBody);
+		const respContentType = Array.isArray(response.headers["content-type"]) ? response.headers["content-type"][0] : response.headers["content-type"] || "";
+		const { body: responseBody, converted: respConverted } = convertResponseBody(response.body, respContentType, response.status, route.responseSchemas);
+		return {
+			status: response.status,
+			headers: response.headers,
+			body: responseBody,
+			converted: respConverted
+		};
+	}
+	async function handleForwardedRequest(method, url, requestBody, incomingHeaders) {
+		logger.debug(`No route match for ${method} ${url} - forwarding as-is`);
+		const downstreamHeaders = buildDownstreamHeaders(incomingHeaders);
+		const response = await forwardRequest(method, buildDownstreamUrl(url), downstreamHeaders, requestBody);
+		return {
+			status: response.status,
+			headers: response.headers,
+			body: response.body,
+			converted: false
+		};
+	}
+	function sendNotFound(res, method, url) {
+		res.writeHead(404, { "Content-Type": "application/json" });
+		res.end(JSON.stringify({
+			error: "Not Found",
+			message: `No contract route matched for ${method} ${url}`,
+			availableRoutes: contractRoutes.routes.map((r) => ({
+				method: r.method,
+				path: r.pathTemplate
+			}))
+		}));
+	}
+	function sendResponse(res, result) {
+		const responseHeaders = { "x-proxy": "adt-proxy" };
+		forwardHeaders(result.headers, responseHeaders, FORWARDABLE_RESPONSE_HEADERS);
+		if (result.converted) responseHeaders["content-type"] = "application/json";
+		res.writeHead(result.status, responseHeaders);
+		res.end(result.body);
+	}
+	async function readBody(req, maxSize = 10485760) {
+		return new Promise((resolve, reject) => {
+			let size = 0;
+			const chunks = [];
+			req.on("data", (chunk) => {
+				size += chunk.length;
+				if (size > maxSize) {
+					reject(/* @__PURE__ */ new Error(`Request body exceeds ${maxSize} byte limit`));
+					return;
+				}
+				chunks.push(chunk);
+			});
+			req.on("end", () => resolve(Buffer.concat(chunks).toString()));
+			req.on("error", (err) => reject(err));
+		});
+	}
+	async function handleRequest(req, res) {
+		const method = req.method || "GET";
+		const url = req.url || "/";
+		logger.info(`${method} ${url}`);
+		const requestBody = await readBody(req);
+		const match = contractRoutes.match(method, url, basePath);
+		if (match && convertContent) {
+			sendResponse(res, await handleMatchedRoute(method, url, requestBody, req.headers, match.route));
+			return;
+		}
+		if (match) {
+			const downstreamHeaders = buildDownstreamHeaders(req.headers, match.route.requestHeaders);
+			const response = await forwardRequest(method, buildDownstreamUrl(url), downstreamHeaders, requestBody);
+			sendResponse(res, {
+				status: response.status,
+				headers: response.headers,
+				body: response.body,
+				converted: false
+			});
+			return;
+		}
+		if (forwardUnknown) {
+			sendResponse(res, await handleForwardedRequest(method, url, requestBody, req.headers));
+			return;
+		}
+		sendNotFound(res, method, url);
+	}
+	return {
+		get routes() {
+			return contractRoutes.routes;
+		},
+		match: contractRoutes.match,
+		async start() {
+			return new Promise((resolve, reject) => {
+				server = createServer((req, res) => {
+					handleRequest(req, res).catch((err) => {
+						logger.error("Request handling error", { error: err.message });
+						res.writeHead(500, { "Content-Type": "application/json" });
+						res.end(JSON.stringify({
+							error: "Internal Server Error",
+							message: err.message
+						}));
+					});
+				});
+				server.on("error", reject);
+				server.listen(config.port || 0, config.host || "127.0.0.1", () => {
+					const addr = server?.address();
+					if (!addr || typeof addr !== "object") {
+						reject(/* @__PURE__ */ new Error("Failed to get server address"));
+						return;
+					}
+					logger.info(`ADT proxy listening on http://${config.host || "127.0.0.1"}:${addr.port}`);
+					logger.info(`Proxying to ${targetUrl}`);
+					resolve({ port: addr.port });
+				});
+			});
+		},
+		async stop() {
+			return new Promise((resolve, reject) => {
+				if (!server) return resolve();
+				server.close((err) => err ? reject(err) : resolve());
+			});
+		}
+	};
+}
+
+//#endregion
+export { createAdtProxy, detectContentType, isJsonContentType, isXmlContentType, jsonToXml, xmlToJson };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","names":["createServer","httpCreateServer"],"sources":["../src/converter.ts","../src/proxy.ts"],"sourcesContent":["/**\n * ADT Proxy Server - Content Conversion\n *\n * Handles JSON↔XML conversion using schema parse/build methods.\n * This is the core of the proxy's content negotiation.\n */\n\nimport type { Serializable } from '@abapify/speci/rest';\n\n/**\n * Convert a JSON string to XML using a schema's build method.\n */\nexport function jsonToXml(json: string, schema: Serializable): string {\n  try {\n    const data = JSON.parse(json);\n    if (typeof schema.build === 'function') {\n      return schema.build(data);\n    }\n    return json;\n  } catch {\n    return json;\n  }\n}\n\n/**\n * Convert an XML string to JSON using a schema's parse method.\n */\nexport function xmlToJson(xml: string, schema: Serializable): string {\n  try {\n    const data = schema.parse(xml);\n    return JSON.stringify(data);\n  } catch {\n    return xml;\n  }\n}\n\n/**\n * Detect content type from a string or content-type header.\n */\nexport function detectContentType(\n  content: string,\n  contentType?: string,\n): 'json' | 'xml' | 'text' | 'binary' {\n  if (contentType) {\n    const ct = contentType.toLowerCase();\n    if (ct.includes('json')) return 'json';\n    if (ct.includes('xml')) return 'xml';\n    if (ct.includes('text')) return 'text';\n    return 'binary';\n  }\n\n  const trimmed = content.trimStart();\n  if (trimmed.startsWith('{') || trimmed.startsWith('[')) return 'json';\n  if (trimmed.startsWith('<?xml') || trimmed.startsWith('<')) return 'xml';\n  return 'text';\n}\n\n/**\n * Check if a content type indicates JSON (case-insensitive).\n */\nexport function isJsonContentType(contentType: string): boolean {\n  const ct = contentType.toLowerCase();\n  return ct.includes('json') || ct.endsWith('+json');\n}\n\n/**\n * Check if a content type indicates XML (case-insensitive).\n */\nexport function isXmlContentType(contentType: string): boolean {\n  const ct = contentType.toLowerCase();\n  return ct.includes('xml') || ct.endsWith('+xml');\n}\n","/**\n * ADT Proxy Server\n *\n * Proxies ADT endpoint requests to a downstream SAP system with\n * automatic JSON↔XML conversion using contract schemas.\n *\n * Architecture:\n *   Client (JSON) → Proxy → Downstream SAP (XML)\n *   Client (JSON) ← Proxy ← Downstream SAP (XML)\n *\n * The proxy uses speci's createServer to extract route definitions\n * from ADT contracts, enabling schema-aware content conversion.\n *\n * @example\n * ```typescript\n * import { createAdtProxy } from '@abapify/adt-proxy';\n *\n * const proxy = createAdtProxy({\n *   targetUrl: 'https://my-sap-system.com:8000',\n *   auth: { username: 'user', password: 'pass', client: '100' },\n * });\n *\n * const { port } = await proxy.start();\n * console.log(`Proxy running on http://localhost:${port}`);\n * ```\n */\n\nimport { createServer as httpCreateServer, type Server } from 'node:http';\nimport { createServer } from '@abapify/speci/rest';\nimport { adtContract, type AdtContract } from '@abapify/adt-contracts';\nimport type { RouteDefinition } from '@abapify/speci/rest';\nimport {\n  jsonToXml,\n  xmlToJson,\n  isJsonContentType,\n  isXmlContentType,\n} from './converter';\nimport type { AdtProxyConfig, ProxyResult, Logger } from './types';\n\nconst DEFAULT_LOGGER: Logger = {\n  debug: (_msg: string) => {\n    /* noop */\n  },\n  info: (_msg: string) => {\n    /* noop */\n  },\n  warn: console.warn,\n  error: console.error,\n};\n\nconst FORWARDABLE_REQUEST_HEADERS = [\n  'accept',\n  'content-type',\n  'x-csrf-token',\n  'x-sap-security-session',\n  'x-sap-adt-sessiontype',\n  'cookie',\n];\n\nconst FORWARDABLE_RESPONSE_HEADERS = [\n  'content-type',\n  'x-csrf-token',\n  'x-sap-security-session',\n  'set-cookie',\n  'etag',\n  'location',\n];\n\nfunction forwardHeaders(\n  source: Record<string, string | string[] | undefined>,\n  target: Record<string, string | string[]>,\n  keys: string[],\n): void {\n  for (const h of keys) {\n    const value = source[h];\n    if (value && !target[h]) {\n      target[h] = value;\n    }\n  }\n}\n\nfunction addAuthHeaders(\n  headers: Record<string, string>,\n  auth?: AdtProxyConfig['auth'],\n): void {\n  if (!auth) return;\n  if (!headers.authorization) {\n    const creds = Buffer.from(`${auth.username}:${auth.password}`).toString(\n      'base64',\n    );\n    headers.authorization = `Basic ${creds}`;\n  }\n  if (auth.client && !headers['sap-client']) {\n    headers['sap-client'] = auth.client;\n  }\n}\n\nfunction convertRequestBody(\n  body: string,\n  contentType: string | undefined,\n  bodySchema?: RouteDefinition['bodySchema'],\n): { body: string; converted: boolean } {\n  if (!body || !bodySchema || !contentType) {\n    return { body, converted: false };\n  }\n  if (!isJsonContentType(contentType)) {\n    return { body, converted: false };\n  }\n  return { body: jsonToXml(body, bodySchema), converted: true };\n}\n\nfunction convertResponseBody(\n  body: string,\n  contentType: string,\n  status: number,\n  responseSchemas: RouteDefinition['responseSchemas'],\n): { body: string; converted: boolean } {\n  if (!body || !isXmlContentType(contentType) || !responseSchemas[status]) {\n    return { body, converted: false };\n  }\n  const converted = xmlToJson(body, responseSchemas[status]);\n  const wasConverted = converted !== body;\n  return { body: converted, converted: wasConverted };\n}\n\nasync function forwardRequest(\n  method: string,\n  url: string,\n  headers: Record<string, string>,\n  body?: string,\n  timeoutMs = 30_000,\n): Promise<{\n  status: number;\n  headers: Record<string, string | string[]>;\n  body: string;\n}> {\n  const controller = new AbortController();\n  const timer = setTimeout(() => controller.abort(), timeoutMs);\n\n  try {\n    const response = await fetch(url, {\n      method,\n      headers,\n      body: body || undefined,\n      signal: controller.signal,\n    });\n\n    const responseBody = await response.text();\n    const responseHeaders: Record<string, string | string[]> = {};\n    response.headers.forEach((value, key) => {\n      if (key.toLowerCase() === 'set-cookie') return;\n      responseHeaders[key] = value;\n    });\n\n    if (typeof response.headers.getSetCookie === 'function') {\n      const setCookies = response.headers.getSetCookie();\n      if (setCookies.length > 0) {\n        responseHeaders['set-cookie'] = setCookies;\n      }\n    }\n\n    return {\n      status: response.status,\n      headers: responseHeaders,\n      body: responseBody,\n    };\n  } finally {\n    clearTimeout(timer);\n  }\n}\n\nexport function createAdtProxy(config: AdtProxyConfig) {\n  const {\n    targetUrl,\n    auth,\n    basePath = '',\n    forwardUnknown = true,\n    convertContent = true,\n    defaultHeaders = {},\n    logger = DEFAULT_LOGGER,\n  } = config;\n\n  const contractRoutes = createServer(adtContract as AdtContract);\n  let server: Server | undefined;\n\n  function buildDownstreamHeaders(\n    incomingHeaders: Record<string, string | string[] | undefined>,\n    contractHeaders?: Record<string, string>,\n  ): Record<string, string> {\n    const headers: Record<string, string> = {\n      ...defaultHeaders,\n      ...contractHeaders,\n    };\n    forwardHeaders(incomingHeaders, headers, FORWARDABLE_REQUEST_HEADERS);\n    addAuthHeaders(headers, auth);\n    if (convertContent && !headers.accept) {\n      headers.accept = 'application/json';\n    }\n    return headers;\n  }\n\n  function buildDownstreamUrl(url: string): string {\n    const relativePath =\n      basePath && url.startsWith(basePath)\n        ? url.slice(basePath.length) || '/'\n        : url;\n    return `${targetUrl}${relativePath}`;\n  }\n\n  function getContentType(\n    headers: Record<string, string | string[] | undefined>,\n  ): string | undefined {\n    const ct = headers['content-type'];\n    return Array.isArray(ct) ? ct[0] : ct;\n  }\n\n  async function handleMatchedRoute(\n    method: string,\n    url: string,\n    requestBody: string,\n    incomingHeaders: Record<string, string | string[] | undefined>,\n    route: RouteDefinition,\n  ): Promise<ProxyResult> {\n    logger.info(`Matched route: ${route.method} ${route.pathTemplate}`);\n\n    const reqContentType = getContentType(incomingHeaders);\n    const { body: downstreamBody, converted: reqConverted } =\n      convertRequestBody(requestBody, reqContentType, route.bodySchema);\n\n    const downstreamHeaders = buildDownstreamHeaders(\n      incomingHeaders,\n      route.requestHeaders,\n    );\n    if (reqConverted) {\n      downstreamHeaders['content-type'] = 'application/xml';\n    }\n\n    const response = await forwardRequest(\n      method,\n      buildDownstreamUrl(url),\n      downstreamHeaders,\n      downstreamBody,\n    );\n\n    const respContentType = Array.isArray(response.headers['content-type'])\n      ? response.headers['content-type'][0]\n      : response.headers['content-type'] || '';\n    const { body: responseBody, converted: respConverted } =\n      convertResponseBody(\n        response.body,\n        respContentType,\n        response.status,\n        route.responseSchemas,\n      );\n\n    return {\n      status: response.status,\n      headers: response.headers,\n      body: responseBody,\n      converted: respConverted,\n    };\n  }\n\n  async function handleForwardedRequest(\n    method: string,\n    url: string,\n    requestBody: string,\n    incomingHeaders: Record<string, string | string[] | undefined>,\n  ): Promise<ProxyResult> {\n    logger.debug(`No route match for ${method} ${url} - forwarding as-is`);\n\n    const downstreamHeaders = buildDownstreamHeaders(incomingHeaders);\n    const response = await forwardRequest(\n      method,\n      buildDownstreamUrl(url),\n      downstreamHeaders,\n      requestBody,\n    );\n\n    return {\n      status: response.status,\n      headers: response.headers,\n      body: response.body,\n      converted: false,\n    };\n  }\n\n  function sendNotFound(\n    res: {\n      writeHead: (\n        status: number,\n        headers: Record<string, string | string[]>,\n      ) => void;\n      end: (body?: string) => void;\n    },\n    method: string,\n    url: string,\n  ): void {\n    res.writeHead(404, { 'Content-Type': 'application/json' });\n    res.end(\n      JSON.stringify({\n        error: 'Not Found',\n        message: `No contract route matched for ${method} ${url}`,\n        availableRoutes: contractRoutes.routes.map((r) => ({\n          method: r.method,\n          path: r.pathTemplate,\n        })),\n      }),\n    );\n  }\n\n  function sendResponse(\n    res: {\n      writeHead: (\n        status: number,\n        headers: Record<string, string | string[]>,\n      ) => void;\n      end: (body?: string) => void;\n    },\n    result: ProxyResult,\n  ): void {\n    const responseHeaders: Record<string, string | string[]> = {\n      'x-proxy': 'adt-proxy',\n    };\n    forwardHeaders(\n      result.headers,\n      responseHeaders,\n      FORWARDABLE_RESPONSE_HEADERS,\n    );\n\n    if (result.converted) {\n      responseHeaders['content-type'] = 'application/json';\n    }\n\n    res.writeHead(result.status, responseHeaders);\n    res.end(result.body);\n  }\n\n  async function readBody(\n    req: {\n      on: (event: string, cb: (...args: any[]) => void) => void;\n    },\n    maxSize = 10 * 1024 * 1024,\n  ): Promise<string> {\n    return new Promise((resolve, reject) => {\n      let size = 0;\n      const chunks: Buffer[] = [];\n      req.on('data', (chunk: Buffer) => {\n        size += chunk.length;\n        if (size > maxSize) {\n          reject(new Error(`Request body exceeds ${maxSize} byte limit`));\n          return;\n        }\n        chunks.push(chunk);\n      });\n      req.on('end', () => resolve(Buffer.concat(chunks).toString()));\n      req.on('error', (err: Error) => reject(err));\n    });\n  }\n\n  async function handleRequest(\n    req: {\n      method?: string;\n      url?: string;\n      headers: Record<string, string | string[] | undefined>;\n      on: (event: string, cb: (chunk: any) => void) => void;\n    },\n    res: {\n      writeHead: (\n        status: number,\n        headers: Record<string, string | string[]>,\n      ) => void;\n      end: (body?: string) => void;\n    },\n  ): Promise<void> {\n    const method = req.method || 'GET';\n    const url = req.url || '/';\n    logger.info(`${method} ${url}`);\n\n    const requestBody = await readBody(req);\n    const match = contractRoutes.match(method, url, basePath);\n\n    if (match && convertContent) {\n      const result = await handleMatchedRoute(\n        method,\n        url,\n        requestBody,\n        req.headers,\n        match.route,\n      );\n      sendResponse(res, result);\n      return;\n    }\n\n    if (match) {\n      const downstreamHeaders = buildDownstreamHeaders(\n        req.headers,\n        match.route.requestHeaders,\n      );\n      const response = await forwardRequest(\n        method,\n        buildDownstreamUrl(url),\n        downstreamHeaders,\n        requestBody,\n      );\n      sendResponse(res, {\n        status: response.status,\n        headers: response.headers,\n        body: response.body,\n        converted: false,\n      });\n      return;\n    }\n\n    if (forwardUnknown) {\n      const result = await handleForwardedRequest(\n        method,\n        url,\n        requestBody,\n        req.headers,\n      );\n      sendResponse(res, result);\n      return;\n    }\n\n    sendNotFound(res, method, url);\n  }\n\n  return {\n    get routes() {\n      return contractRoutes.routes;\n    },\n    match: contractRoutes.match,\n\n    async start(): Promise<{ port: number }> {\n      return new Promise((resolve, reject) => {\n        server = httpCreateServer((req, res) => {\n          handleRequest(req, res).catch((err) => {\n            logger.error('Request handling error', { error: err.message });\n            res.writeHead(500, { 'Content-Type': 'application/json' });\n            res.end(\n              JSON.stringify({\n                error: 'Internal Server Error',\n                message: err.message,\n              }),\n            );\n          });\n        });\n\n        server.on('error', reject);\n\n        server.listen(config.port || 0, config.host || '127.0.0.1', () => {\n          const addr = server?.address();\n          if (!addr || typeof addr !== 'object') {\n            reject(new Error('Failed to get server address'));\n            return;\n          }\n          logger.info(\n            `ADT proxy listening on http://${config.host || '127.0.0.1'}:${addr.port}`,\n          );\n          logger.info(`Proxying to ${targetUrl}`);\n          resolve({ port: addr.port });\n        });\n      });\n    },\n\n    async stop(): Promise<void> {\n      return new Promise((resolve, reject) => {\n        if (!server) return resolve();\n        server.close((err) => (err ? reject(err) : resolve()));\n      });\n    },\n  };\n}\n\nexport { createServer } from '@abapify/speci/rest';\nexport type { AdtProxyConfig, ProxyResult, Logger } from './types';\nexport {\n  jsonToXml,\n  xmlToJson,\n  detectContentType,\n  isJsonContentType,\n  isXmlContentType,\n} from './converter';\n"],"mappings":"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"}

package/package.json

@@ -1 +1,32 @@
-{"name":"@abapify/adt-proxy","version":"0.0.0","description":"Placeholder — real package is published via CI/CD (trusted publishing)."}
+{
+  "name": "@abapify/adt-proxy",
+  "version": "0.4.5",
+  "description": "ADT proxy server with JSON↔XML conversion",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    ".": "./dist/index.mjs",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {
+    "@abapify/adt-contracts": "0.4.5",
+    "@abapify/speci": "0.4.5"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/abapify/adt-cli.git",
+    "directory": "packages/adt-proxy"
+  },
+  "homepage": "https://github.com/abapify/adt-cli/tree/main/packages/adt-proxy#readme",
+  "bugs": {
+    "url": "https://github.com/abapify/adt-cli/issues"
+  }
+}

package/README.md

@@ -1 +0,0 @@
-# @abapify/adt-proxy