@vereign/core 1.1.0 → 1.2.0

package/dist/index.d.mts

@@ -8,6 +8,9 @@ declare class App {
     constructor(logger: Logger, appVersion: string);
     private initializeMiddlewares;
     private initializeRoutes;
+    /**
+     * General error handler for all errors, so we can throw from anywhere in the project
+     */
     private initializeErrorHandling;
     listen(port: number): void;
 }

package/dist/index.d.ts

@@ -8,6 +8,9 @@ declare class App {
     constructor(logger: Logger, appVersion: string);
     private initializeMiddlewares;
     private initializeRoutes;
+    /**
+     * General error handler for all errors, so we can throw from anywhere in the project
+     */
     private initializeErrorHandling;
     listen(port: number): void;
 }

package/dist/index.js

@@ -3,8 +3,22 @@ var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -86,50 +100,172 @@ var import_express2 = __toESM(require("express"));
 // src/chmed16/controller.ts
 var import_chmed_parser = require("@vereign/chmed-parser");
 var import_pdf_generator = require("@vereign/pdf-generator");
+
+// src/app-error.ts
+var z = __toESM(require("zod/v4"));
+var AppError = class extends Error {
+  constructor(status, message, code, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return __spreadValues({
+      status: this.status,
+      code: this.code,
+      message: this.message
+    }, this.details ? { errors: this.details } : {});
+  }
+};
+var errorDetailsSchema = z.object({
+  path: z.string(),
+  message: z.string(),
+  code: z.string().optional()
+});
+var appErrorSchema = z.object({
+  status: z.number().int(),
+  code: z.string(),
+  message: z.string(),
+  errors: z.array(errorDetailsSchema).optional()
+});
+
+// src/chmed16/controller.ts
 var CHMED16AController = class {
   constructor(logger) {
-    this.process = (req, res) => __async(this, null, function* () {
+    this.process = (req, res, next) => __async(this, null, function* () {
       const { chmed, lang } = req.body;
       const start = Date.now();
-      this.logger.info(`Processing started`);
-      const parseStart = Date.now();
-      const json = yield this.parser.parse(chmed, lang, this.sds);
-      this.logger.info(`Parsing took ${Date.now() - parseStart} ms`);
-      res.setHeader("Content-Type", "application/pdf");
-      res.setHeader("Content-Disposition", 'inline; filename="chmed16a.pdf"');
-      const pdfStart = Date.now();
-      const pdf = new import_pdf_generator.PDFLib(this.logger);
-      pdf.generate(json, res);
-      this.logger.info(`PDF generation took ${Date.now() - pdfStart} ms`);
-      this.logger.info(`Total request time: ${Date.now() - start} ms`);
+      try {
+        this.logger.info("Processing started");
+        const json = yield this.parseChmedData(chmed, lang);
+        yield this.generatePdfResponse(json, res);
+        this.logger.info(`Total request time: ${Date.now() - start} ms`);
+      } catch (error) {
+        next(error);
+      }
     });
     this.logger = logger;
     this.sds = new import_chmed_parser.SDS("https://sds-test.hin.ch", logger);
     this.parser = new import_chmed_parser.CHMEDParser(logger);
   }
+  parseChmedData(chmed, lang) {
+    return __async(this, null, function* () {
+      try {
+        const parseStart = Date.now();
+        const json = yield this.parser.parse(chmed, this.sds, lang);
+        this.logger.info(`Parsing took ${Date.now() - parseStart} ms`);
+        return json;
+      } catch (error) {
+        this.logger.error("Parsing failed:", error);
+        throw new AppError(
+          400,
+          "Failed to parse CHMED data. Please check the input format.",
+          "PARSE_ERROR",
+          [
+            {
+              path: "chmed",
+              message: "Invalid CHMED format or structure",
+              code: "invalid_format"
+            }
+          ]
+        );
+      }
+    });
+  }
+  generatePdfResponse(json, res) {
+    return __async(this, null, function* () {
+      const pdfStart = Date.now();
+      try {
+        const pdf = new import_pdf_generator.PDFLib(this.logger);
+        const pdfBuffer = yield pdf.generateBuffer(json);
+        res.setHeader("Content-Type", "application/pdf");
+        res.setHeader("Content-Disposition", 'inline; filename="chmed16a.pdf"');
+        res.send(pdfBuffer);
+        this.logger.info(`PDF generation took ${Date.now() - pdfStart} ms`);
+      } catch (error) {
+        this.logger.error("PDF generation failed:", error);
+        throw new AppError(
+          500,
+          "Failed to generate PDF. The parsed data may be invalid.",
+          "PDF_GENERATION_ERROR",
+          [
+            {
+              path: "pdf_generation",
+              message: "PDF creation failed due to invalid or corrupted data",
+              code: "generation_failed"
+            }
+          ]
+        );
+      }
+    });
+  }
 };
 
 // src/chmed16/middleware.ts
-var import_zod2 = require("zod");
+var import_zod = require("zod");
 
 // src/chmed16/request.ts
-var import_zod = __toESM(require("zod"));
-var bodySchema = import_zod.default.object({
-  chmed: import_zod.default.string().min(1, "string is required"),
-  lang: import_zod.default.string().min(1, "lang is required")
-});
+var z2 = __toESM(require("zod/v4"));
+var chmedPattern = /^CHMED[0-9A-Za-z]+/;
+var bodySchema = z2.object({
+  chmed: z2.string().min(5, "string is required").refine(
+    (val) => {
+      if (chmedPattern.test(val)) return true;
+      try {
+        const url = new URL(val);
+        const hash = url.hash.slice(1);
+        return chmedPattern.test(hash);
+      } catch (e) {
+        return false;
+      }
+    },
+    { message: "chmed must be a valid CHMED string" }
+  ).meta({
+    description: "A valid CHMED string",
+    example: "CHMED16A1H4sIAAAAAAAACr2WX2/iOBDAv4rl1wtZ/yEh8LTlaHuVll1Eu620qz4YGIiV4CDHqbbb49v0M9zTvfHFbhwaWvpvV6eqgIMzGTv+zYzHc0NHymkwjvZu6NFntQTao4PCKhrQT3e3x1ZNwKKgP0A1yrvtqMV5S0gUHYOZ4bOeCOipswBeoQ/WlM6qsgTidb7pFUolYwxv/tTu+k7Hv8Is8GYG2B2lhfFvY50uSZIEG/5QfjhUOvdKuKhwUS/l4wR0udKQh9MUNU5mJe19v6Fn1yuoV3Ku/AAeyjAOedjGJriMO6FgHC9hFCby7+HB8fBwwBin68uADmHmDTD4VLohGBzsF2RhSXssoONpPf0JqrTXwbYToRilMY8uG5HYiqJOeyfid6JuZyeSTSdu1PnuWWe7FPUQhzc4XW/Kr0ajhYUf8Jg2jnbP+fpyva6h9BRdaNx2Qv8KKqSUIo5rs22nkIhabDUG7sgWCE0FE6zFui3hJx24s2JrkhMzhrK2yQD1WcgCjs3/Y7v0q98uAGMhQ/WzbDEuvTVPi9nEgjFo2oAerFYnPj5QfqYmOTgHBK5cHhJtSFakOZhyc1tZmFvQsCQXPpAsUdU83/xTggkJTjIuFI4fffFdWNXWPK0mfm2NMSlnIolrqzSk7f9L+oDyF6QDWFkoS108Ih0WdoFcpDJqkm5uzUIvCG4cMlRp/hO0Q6x9qic0URRLlryF336fpp9XLi2m6cxW0+zDX2B/7lN9fZmGPIsT0M+TkZpmD/YBJoZIdCL5lmT8l2QnZg6Ze+KmV4CeCTrZcPEdjOi2u51Evq+bRspm2pSFIR8IzuByjMAcFvto54VFpCU5naa5moMJfj8Wa1j+3A6LuiwRb5VLmsZfhR1WZQb5FdhypYyp8ADZ32jqh16qnEjyg7jN7SLX05SAxtyTLl/YZPw+KsWOLZEJa0dv5cemve7Hc4RyxWr+BKoPmvRhpuw8JDwiLSIZGWpToavI1Z1fDzFL4rZr+Dm5wI0LRKHH3ebfafaiER7lz3tj3DtaRDxm3fh9t6hPNza9dumyKh/5WLuHyHKLakiuzILwFmthC8hMGYW+v4BpWkLuz4/6GX6fDW/xNL7buJfbbfa+2C+dlZzsTkuOLq2w7tr3/b2D6et4+OrREVZPddnkbzAlwNLrozYWDTvU2ghYttWf1jOX5oPjDvCkQO1OzDgWVTIWss6C30q/duzUpSOaivvSkYkzHvek6MnkD8Z79QTjJYYc7WsP6LPRXV2KNYHKcyC+mMnqYgaMB1UelCwqR8Bm+eYWTebdisVQ39eXdP0fL5lXGtoKAAA"
+  }),
+  lang: z2.enum(["en", "de", "fr", "it"]).optional().meta({
+    description: "Language code",
+    example: "en"
+  })
+}).meta({ description: "Request body for CHMED endpoint" });
 
 // src/chmed16/middleware.ts
-var validateBody = (req, res, next) => {
-  try {
-    req.body = bodySchema.parse(req.body);
-    next();
-  } catch (error) {
-    if (error instanceof import_zod2.ZodError) {
-      return res.status(400).json({ error: error.issues.map((e) => e.message).join(", ") });
+var validateBody = (logger) => {
+  return (req, res, next) => {
+    try {
+      req.body = bodySchema.parse(req.body);
+      next();
+    } catch (e) {
+      logger.debug("Body validation failed", { error: e });
+      if (e instanceof import_zod.ZodError) {
+        const details = e.issues.map((err) => ({
+          path: err.path.join("."),
+          message: err.message,
+          code: err.code
+        }));
+        logger.warn("Validation failed", { details });
+        return res.status(400).json(
+          new AppError(
+            400,
+            "Invalid request body",
+            "BAD_REQUEST",
+            details
+          ).toJSON()
+        );
+      }
+      logger.error("Unexpected error during body validation", { error: e });
+      return res.status(500).json(
+        new AppError(
+          500,
+          "Internal Server Error",
+          "INTERNAL_SERVER_ERROR"
+        ).toJSON()
+      );
     }
-    return res.status(500).json({ error: "Internal Server Error" });
-  }
+  };
 };
 
 // src/chmed16/router.ts
@@ -137,12 +273,17 @@ var CHMED16ARouter = class {
   static getRouter(logger) {
     const router = import_express2.default.Router();
     const controller = new CHMED16AController(logger);
-    router.post("/chmed", validateBody, controller.process);
+    router.post(
+      "/chmed",
+      validateBody(logger),
+      controller.process.bind(controller)
+    );
     return router;
   }
 };
 
 // src/index.ts
+var import_zod2 = require("zod");
 var App = class {
   constructor(logger, appVersion) {
     this.logger = logger;
@@ -160,15 +301,51 @@ var App = class {
     });
   }
   initializeRoutes() {
-    this.app.use("/v1", HealthRouter.getRouter(this.logger, this.appVersion));
+    this.app.use("/", HealthRouter.getRouter(this.logger, this.appVersion));
     this.app.use("/v1", CHMED16ARouter.getRouter(this.logger));
   }
+  /**
+   * General error handler for all errors, so we can throw from anywhere in the project
+   */
   initializeErrorHandling() {
     this.app.use(
-      //eslint-disable-next-line
-      (err, req, res, next) => {
-        this.logger.error(err.stack);
-        res.status(500).json({ error: "Internal Server Error" });
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      (e, req, res, next) => {
+        this.logger.debug("General Error Handler");
+        this.logger.debug(e);
+        if (e instanceof import_zod2.ZodError) {
+          const details = e.issues.map((err) => ({
+            path: err.path.join("."),
+            message: err.message,
+            code: err.code
+          }));
+          return res.status(400).json(
+            new AppError(
+              400,
+              "Invalid request body",
+              "BAD_REQUEST",
+              details
+            ).toJSON()
+          );
+        }
+        if (e instanceof AppError) {
+          if (e.code === "PARSE_ERROR") {
+            this.logger.warn(`Parse error: ${e.message}`);
+          } else if (e.code === "PDF_GENERATION_ERROR") {
+            this.logger.error(`PDF generation error: ${e.message}`);
+          } else {
+            this.logger.error(`App error: ${e.message}`);
+          }
+          return res.status(e.status).json(e.toJSON());
+        }
+        this.logger.error("Unexpected error:", e);
+        return res.status(500).json(
+          new AppError(
+            500,
+            "Internal Server Error",
+            "INTERNAL_SERVER_ERROR"
+          ).toJSON()
+        );
       }
     );
   }

package/dist/index.mjs

@@ -1,3 +1,19 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
 var __async = (__this, __arguments, generator) => {
   return new Promise((resolve, reject) => {
     var fulfilled = (value) => {
@@ -53,50 +69,172 @@ import express2 from "express";
 // src/chmed16/controller.ts
 import { CHMEDParser, SDS } from "@vereign/chmed-parser";
 import { PDFLib } from "@vereign/pdf-generator";
+
+// src/app-error.ts
+import * as z from "zod/v4";
+var AppError = class extends Error {
+  constructor(status, message, code, details) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    Error.captureStackTrace(this, this.constructor);
+  }
+  toJSON() {
+    return __spreadValues({
+      status: this.status,
+      code: this.code,
+      message: this.message
+    }, this.details ? { errors: this.details } : {});
+  }
+};
+var errorDetailsSchema = z.object({
+  path: z.string(),
+  message: z.string(),
+  code: z.string().optional()
+});
+var appErrorSchema = z.object({
+  status: z.number().int(),
+  code: z.string(),
+  message: z.string(),
+  errors: z.array(errorDetailsSchema).optional()
+});
+
+// src/chmed16/controller.ts
 var CHMED16AController = class {
   constructor(logger) {
-    this.process = (req, res) => __async(this, null, function* () {
+    this.process = (req, res, next) => __async(this, null, function* () {
       const { chmed, lang } = req.body;
       const start = Date.now();
-      this.logger.info(`Processing started`);
-      const parseStart = Date.now();
-      const json = yield this.parser.parse(chmed, lang, this.sds);
-      this.logger.info(`Parsing took ${Date.now() - parseStart} ms`);
-      res.setHeader("Content-Type", "application/pdf");
-      res.setHeader("Content-Disposition", 'inline; filename="chmed16a.pdf"');
-      const pdfStart = Date.now();
-      const pdf = new PDFLib(this.logger);
-      pdf.generate(json, res);
-      this.logger.info(`PDF generation took ${Date.now() - pdfStart} ms`);
-      this.logger.info(`Total request time: ${Date.now() - start} ms`);
+      try {
+        this.logger.info("Processing started");
+        const json = yield this.parseChmedData(chmed, lang);
+        yield this.generatePdfResponse(json, res);
+        this.logger.info(`Total request time: ${Date.now() - start} ms`);
+      } catch (error) {
+        next(error);
+      }
     });
     this.logger = logger;
     this.sds = new SDS("https://sds-test.hin.ch", logger);
     this.parser = new CHMEDParser(logger);
   }
+  parseChmedData(chmed, lang) {
+    return __async(this, null, function* () {
+      try {
+        const parseStart = Date.now();
+        const json = yield this.parser.parse(chmed, this.sds, lang);
+        this.logger.info(`Parsing took ${Date.now() - parseStart} ms`);
+        return json;
+      } catch (error) {
+        this.logger.error("Parsing failed:", error);
+        throw new AppError(
+          400,
+          "Failed to parse CHMED data. Please check the input format.",
+          "PARSE_ERROR",
+          [
+            {
+              path: "chmed",
+              message: "Invalid CHMED format or structure",
+              code: "invalid_format"
+            }
+          ]
+        );
+      }
+    });
+  }
+  generatePdfResponse(json, res) {
+    return __async(this, null, function* () {
+      const pdfStart = Date.now();
+      try {
+        const pdf = new PDFLib(this.logger);
+        const pdfBuffer = yield pdf.generateBuffer(json);
+        res.setHeader("Content-Type", "application/pdf");
+        res.setHeader("Content-Disposition", 'inline; filename="chmed16a.pdf"');
+        res.send(pdfBuffer);
+        this.logger.info(`PDF generation took ${Date.now() - pdfStart} ms`);
+      } catch (error) {
+        this.logger.error("PDF generation failed:", error);
+        throw new AppError(
+          500,
+          "Failed to generate PDF. The parsed data may be invalid.",
+          "PDF_GENERATION_ERROR",
+          [
+            {
+              path: "pdf_generation",
+              message: "PDF creation failed due to invalid or corrupted data",
+              code: "generation_failed"
+            }
+          ]
+        );
+      }
+    });
+  }
 };
 
 // src/chmed16/middleware.ts
 import { ZodError } from "zod";
 
 // src/chmed16/request.ts
-import z from "zod";
-var bodySchema = z.object({
-  chmed: z.string().min(1, "string is required"),
-  lang: z.string().min(1, "lang is required")
-});
+import * as z2 from "zod/v4";
+var chmedPattern = /^CHMED[0-9A-Za-z]+/;
+var bodySchema = z2.object({
+  chmed: z2.string().min(5, "string is required").refine(
+    (val) => {
+      if (chmedPattern.test(val)) return true;
+      try {
+        const url = new URL(val);
+        const hash = url.hash.slice(1);
+        return chmedPattern.test(hash);
+      } catch (e) {
+        return false;
+      }
+    },
+    { message: "chmed must be a valid CHMED string" }
+  ).meta({
+    description: "A valid CHMED string",
+    example: "CHMED16A1H4sIAAAAAAAACr2WX2/iOBDAv4rl1wtZ/yEh8LTlaHuVll1Eu620qz4YGIiV4CDHqbbb49v0M9zTvfHFbhwaWvpvV6eqgIMzGTv+zYzHc0NHymkwjvZu6NFntQTao4PCKhrQT3e3x1ZNwKKgP0A1yrvtqMV5S0gUHYOZ4bOeCOipswBeoQ/WlM6qsgTidb7pFUolYwxv/tTu+k7Hv8Is8GYG2B2lhfFvY50uSZIEG/5QfjhUOvdKuKhwUS/l4wR0udKQh9MUNU5mJe19v6Fn1yuoV3Ku/AAeyjAOedjGJriMO6FgHC9hFCby7+HB8fBwwBin68uADmHmDTD4VLohGBzsF2RhSXssoONpPf0JqrTXwbYToRilMY8uG5HYiqJOeyfid6JuZyeSTSdu1PnuWWe7FPUQhzc4XW/Kr0ajhYUf8Jg2jnbP+fpyva6h9BRdaNx2Qv8KKqSUIo5rs22nkIhabDUG7sgWCE0FE6zFui3hJx24s2JrkhMzhrK2yQD1WcgCjs3/Y7v0q98uAGMhQ/WzbDEuvTVPi9nEgjFo2oAerFYnPj5QfqYmOTgHBK5cHhJtSFakOZhyc1tZmFvQsCQXPpAsUdU83/xTggkJTjIuFI4fffFdWNXWPK0mfm2NMSlnIolrqzSk7f9L+oDyF6QDWFkoS108Ih0WdoFcpDJqkm5uzUIvCG4cMlRp/hO0Q6x9qic0URRLlryF336fpp9XLi2m6cxW0+zDX2B/7lN9fZmGPIsT0M+TkZpmD/YBJoZIdCL5lmT8l2QnZg6Ze+KmV4CeCTrZcPEdjOi2u51Evq+bRspm2pSFIR8IzuByjMAcFvto54VFpCU5naa5moMJfj8Wa1j+3A6LuiwRb5VLmsZfhR1WZQb5FdhypYyp8ADZ32jqh16qnEjyg7jN7SLX05SAxtyTLl/YZPw+KsWOLZEJa0dv5cemve7Hc4RyxWr+BKoPmvRhpuw8JDwiLSIZGWpToavI1Z1fDzFL4rZr+Dm5wI0LRKHH3ebfafaiER7lz3tj3DtaRDxm3fh9t6hPNza9dumyKh/5WLuHyHKLakiuzILwFmthC8hMGYW+v4BpWkLuz4/6GX6fDW/xNL7buJfbbfa+2C+dlZzsTkuOLq2w7tr3/b2D6et4+OrREVZPddnkbzAlwNLrozYWDTvU2ghYttWf1jOX5oPjDvCkQO1OzDgWVTIWss6C30q/duzUpSOaivvSkYkzHvek6MnkD8Z79QTjJYYc7WsP6LPRXV2KNYHKcyC+mMnqYgaMB1UelCwqR8Bm+eYWTebdisVQ39eXdP0fL5lXGtoKAAA"
+  }),
+  lang: z2.enum(["en", "de", "fr", "it"]).optional().meta({
+    description: "Language code",
+    example: "en"
+  })
+}).meta({ description: "Request body for CHMED endpoint" });
 
 // src/chmed16/middleware.ts
-var validateBody = (req, res, next) => {
-  try {
-    req.body = bodySchema.parse(req.body);
-    next();
-  } catch (error) {
-    if (error instanceof ZodError) {
-      return res.status(400).json({ error: error.issues.map((e) => e.message).join(", ") });
+var validateBody = (logger) => {
+  return (req, res, next) => {
+    try {
+      req.body = bodySchema.parse(req.body);
+      next();
+    } catch (e) {
+      logger.debug("Body validation failed", { error: e });
+      if (e instanceof ZodError) {
+        const details = e.issues.map((err) => ({
+          path: err.path.join("."),
+          message: err.message,
+          code: err.code
+        }));
+        logger.warn("Validation failed", { details });
+        return res.status(400).json(
+          new AppError(
+            400,
+            "Invalid request body",
+            "BAD_REQUEST",
+            details
+          ).toJSON()
+        );
+      }
+      logger.error("Unexpected error during body validation", { error: e });
+      return res.status(500).json(
+        new AppError(
+          500,
+          "Internal Server Error",
+          "INTERNAL_SERVER_ERROR"
+        ).toJSON()
+      );
     }
-    return res.status(500).json({ error: "Internal Server Error" });
-  }
+  };
 };
 
 // src/chmed16/router.ts
@@ -104,12 +242,17 @@ var CHMED16ARouter = class {
   static getRouter(logger) {
     const router = express2.Router();
     const controller = new CHMED16AController(logger);
-    router.post("/chmed", validateBody, controller.process);
+    router.post(
+      "/chmed",
+      validateBody(logger),
+      controller.process.bind(controller)
+    );
     return router;
   }
 };
 
 // src/index.ts
+import { ZodError as ZodError2 } from "zod";
 var App = class {
   constructor(logger, appVersion) {
     this.logger = logger;
@@ -127,15 +270,51 @@ var App = class {
     });
   }
   initializeRoutes() {
-    this.app.use("/v1", HealthRouter.getRouter(this.logger, this.appVersion));
+    this.app.use("/", HealthRouter.getRouter(this.logger, this.appVersion));
     this.app.use("/v1", CHMED16ARouter.getRouter(this.logger));
   }
+  /**
+   * General error handler for all errors, so we can throw from anywhere in the project
+   */
   initializeErrorHandling() {
     this.app.use(
-      //eslint-disable-next-line
-      (err, req, res, next) => {
-        this.logger.error(err.stack);
-        res.status(500).json({ error: "Internal Server Error" });
+      // eslint-disable-next-line @typescript-eslint/no-unused-vars
+      (e, req, res, next) => {
+        this.logger.debug("General Error Handler");
+        this.logger.debug(e);
+        if (e instanceof ZodError2) {
+          const details = e.issues.map((err) => ({
+            path: err.path.join("."),
+            message: err.message,
+            code: err.code
+          }));
+          return res.status(400).json(
+            new AppError(
+              400,
+              "Invalid request body",
+              "BAD_REQUEST",
+              details
+            ).toJSON()
+          );
+        }
+        if (e instanceof AppError) {
+          if (e.code === "PARSE_ERROR") {
+            this.logger.warn(`Parse error: ${e.message}`);
+          } else if (e.code === "PDF_GENERATION_ERROR") {
+            this.logger.error(`PDF generation error: ${e.message}`);
+          } else {
+            this.logger.error(`App error: ${e.message}`);
+          }
+          return res.status(e.status).json(e.toJSON());
+        }
+        this.logger.error("Unexpected error:", e);
+        return res.status(500).json(
+          new AppError(
+            500,
+            "Internal Server Error",
+            "INTERNAL_SERVER_ERROR"
+          ).toJSON()
+        );
       }
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vereign/core",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "core api library for e prescription project",
   "repository": {
     "type": "git",
@@ -26,7 +26,8 @@
     "test": "vitest run --coverage",
     "test:watch": "vitest --coverage",
     "semantic-release": "semantic-release",
-    "dev": "ts-node-dev ./src/dev-server.ts"
+    "dev": "ts-node-dev ./src/dev-server.ts",
+    "generate:swagger": "npx ts-node ./src/generate-swagger.ts"
   },
   "devDependencies": {
     "@commitlint/cli": "^19.8.1",
@@ -56,11 +57,11 @@
     "typescript": "^5.8.3",
     "typescript-eslint": "^8.37.0",
     "vitest": "^3.2.4",
-    "zod-to-openapi": "^0.2.1"
+    "zod-openapi": "^5.3.1"
   },
   "dependencies": {
-    "@vereign/chmed-parser": "^1.4.1",
-    "@vereign/pdf-generator": "^1.1.7",
+    "@vereign/chmed-parser": "^1.4.6",
+    "@vereign/pdf-generator": "^1.2.1",
     "express": "^5.1.0",
     "pdfkit": "^0.17.1",
     "winston": "^3.17.0",