@porulle/core 0.63.0 → 0.65.0

package/src/interfaces/rest/routes/media.ts

@@ -2,7 +2,7 @@ import { OpenAPIHono } from "@hono/zod-openapi";
 import type { Kernel } from "../../../runtime/kernel.js";
 import type { AttachMediaInput } from "../../../modules/media/service.js";
 import { attachMediaRoute, getMediaRoute, deleteMediaRoute } from "../schemas/media.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requireMethodPerm, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requireMethodPerm, requirePerm } from "../utils.js";
 
 export function mediaRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
@@ -36,7 +36,7 @@ export function mediaRoutes(kernel: Kernel) {
     }, actor);
 
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
 
     return c.json({ data: result.value }, 201);
@@ -63,7 +63,7 @@ export function mediaRoutes(kernel: Kernel) {
       : await kernel.services.media.getUrl(c.req.param("id"), actor);
 
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
 
     return c.redirect(result.value, 302);
@@ -77,7 +77,7 @@ export function mediaRoutes(kernel: Kernel) {
     }
     const result = await kernel.services.media.delete(c.req.param("id"), actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: { deleted: true } });
   });
@@ -90,7 +90,7 @@ export function mediaRoutes(kernel: Kernel) {
     const body = c.req.valid("json") as AttachMediaInput;
     const result = await kernel.services.media.attachToEntity(body, c.get("actor"));
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: { attached: true } }, 201);
   });

package/src/interfaces/rest/routes/orders.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
 import type { Kernel } from "../../../runtime/kernel.js";
 import { changeOrderStatusRoute, listOrdersRoute, orderLookupRoute, getOrderRoute, getOrderFulfillmentsRoute, createOrderRoute, quoteOrderRoute, refundOrderRoute, captureOrderRoute, createOrderFulfillmentRoute, addOrderLineItemRoute, updateOrderLineItemRoute, removeOrderLineItemRoute, refundOrderLinesRoute, undoOrderRefundRoute, listOrderRefundsRoute, refundCapStatusRoute, createOrderNoteRoute, listOrderNotesRoute, deleteOrderNoteRoute, orderTimelineRoute } from "../schemas/orders.js";
-import { type AppEnv, isUUID, mapErrorToResponse, mapErrorToStatus, parsePagination, requireAnyPerm, requireMethodPerm, requirePerm } from "../utils.js";
+import { type AppEnv, isUUID, errorBody, mapErrorToStatus, parsePagination, requireAnyPerm, requireMethodPerm, requirePerm } from "../utils.js";
 import type { CreateOrderInput } from "../../../modules/orders/service.js";
 import { computeOrderPricing } from "../../../modules/orders/quote.js";
 import { assertPermission } from "../../../auth/permissions.js";
@@ -29,7 +29,7 @@ export function orderRoutes(kernel: Kernel) {
       c.get("actor"),
     );
 
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({
       data: result.value.items,
       meta: {
@@ -54,19 +54,19 @@ export function orderRoutes(kernel: Kernel) {
       if (!Number.isNaN(d.getTime())) opts.to = d;
     }
     const result = await kernel.services.orders.lookup(q, opts, c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(getOrderRoute, async (c) => {
     const idOrNumber = c.req.param("idOrNumber");
-    const guestCredential = c.req.header("x-cart-secret") ?? c.req.header("X-Cart-Secret") ?? undefined;
+    const guestCredential = c.req.header("x-cart-secret") ?? undefined;
     const result = isUUID(idOrNumber)
       ? await kernel.services.orders.getById(idOrNumber, c.get("actor"), undefined, guestCredential)
       : await kernel.services.orders.getByNumber(idOrNumber, c.get("actor"), undefined, guestCredential);
 
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -75,14 +75,14 @@ export function orderRoutes(kernel: Kernel) {
     try {
       assertPermission(c.get("actor"), "orders:create");
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
     const body = c.req.valid("json") as CreateOrderInput;
-    const guestCredential = c.req.header("x-cart-secret") ?? c.req.header("X-Cart-Secret") ?? undefined;
+    const guestCredential = c.req.header("x-cart-secret") ?? undefined;
     const result = await kernel.services.orders.create(body, c.get("actor"), undefined, {
       ...(guestCredential !== undefined ? { guestCredential } : {}),
     });
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
@@ -91,7 +91,7 @@ export function orderRoutes(kernel: Kernel) {
     try {
       assertPermission(c.get("actor"), "orders:manage");
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
     const body = c.req.valid("json") as {
       currency: string;
@@ -116,7 +116,7 @@ export function orderRoutes(kernel: Kernel) {
       );
       return c.json({ data: breakdown });
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
   });
 
@@ -130,7 +130,7 @@ export function orderRoutes(kernel: Kernel) {
       undefined,
       body?.amount !== undefined ? { amount: body.amount } : undefined,
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -140,14 +140,14 @@ export function orderRoutes(kernel: Kernel) {
   router.openapi(createOrderNoteRoute, async (c) => {
     const body = c.req.valid("json") as { body: string; pinned?: boolean };
     const result = await kernel.services.orders.addNote(c.req.param("id"), body, c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(listOrderNotesRoute, async (c) => {
     const result = await kernel.services.orders.listNotes(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -158,14 +158,14 @@ export function orderRoutes(kernel: Kernel) {
       c.req.param("noteId"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(orderTimelineRoute, async (c) => {
     const result = await kernel.services.orders.timeline(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -174,7 +174,7 @@ export function orderRoutes(kernel: Kernel) {
   // @ts-expect-error -- openapi handler union return type
   router.openapi(refundCapStatusRoute, async (c) => {
     const result = await kernel.services.orders.refundCapStatus(c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -186,7 +186,7 @@ export function orderRoutes(kernel: Kernel) {
       body,
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
@@ -197,14 +197,14 @@ export function orderRoutes(kernel: Kernel) {
       c.req.param("refundId"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(listOrderRefundsRoute, async (c) => {
     const result = await kernel.services.orders.listRefunds(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -216,7 +216,7 @@ export function orderRoutes(kernel: Kernel) {
       c.get("actor"),
       body?.amount !== undefined ? { amount: body.amount } : undefined,
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -225,7 +225,7 @@ export function orderRoutes(kernel: Kernel) {
     try {
       assertPermission(c.get("actor"), "orders:manage");
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
     const body = c.req.valid("json");
     const result = await kernel.services.orders.addLineItem(
@@ -233,7 +233,7 @@ export function orderRoutes(kernel: Kernel) {
       body,
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
@@ -246,7 +246,7 @@ export function orderRoutes(kernel: Kernel) {
       body,
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -257,7 +257,7 @@ export function orderRoutes(kernel: Kernel) {
       c.req.param("lineItemId"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -275,7 +275,7 @@ export function orderRoutes(kernel: Kernel) {
       c.get("actor"),
     );
 
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -287,13 +287,13 @@ export function orderRoutes(kernel: Kernel) {
     try {
       assertPermission(actor, "orders:update");
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
-    const guestCredential = c.req.header("x-cart-secret") ?? c.req.header("X-Cart-Secret") ?? undefined;
+    const guestCredential = c.req.header("x-cart-secret") ?? undefined;
 
     // Verify the order exists and the actor has access before recording
     const orderResult = await kernel.services.orders.getById(orderId, actor, undefined, guestCredential);
-    if (!orderResult.ok) return c.json(mapErrorToResponse(orderResult.error), mapErrorToStatus(orderResult.error));
+    if (!orderResult.ok) return c.json(errorBody(orderResult.error), mapErrorToStatus(orderResult.error));
 
     const body = c.req.valid("json") as {
       lineItems: Array<{ orderLineItemId: string; quantity: number }>;
@@ -308,7 +308,7 @@ export function orderRoutes(kernel: Kernel) {
       { ...body, orderId: orderResult.value.id },
       actor,
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
@@ -316,17 +316,17 @@ export function orderRoutes(kernel: Kernel) {
   router.openapi(getOrderFulfillmentsRoute, async (c) => {
     const orderId = c.req.param("id");
     const actor = c.get("actor");
-    const guestCredential = c.req.header("x-cart-secret") ?? c.req.header("X-Cart-Secret") ?? undefined;
+    const guestCredential = c.req.header("x-cart-secret") ?? undefined;
 
     // Verify the order exists and the actor has access before returning fulfillments
     const orderResult = isUUID(orderId)
       ? await kernel.services.orders.getById(orderId, actor, undefined, guestCredential)
       : await kernel.services.orders.getByNumber(orderId, actor, undefined, guestCredential);
 
-    if (!orderResult.ok) return c.json(mapErrorToResponse(orderResult.error), mapErrorToStatus(orderResult.error));
+    if (!orderResult.ok) return c.json(errorBody(orderResult.error), mapErrorToStatus(orderResult.error));
 
     const result = await kernel.services.fulfillment.getByOrderId(orderResult.value.id, actor);
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 

package/src/interfaces/rest/routes/payments.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
 import type { PgDatabase, PgQueryResultHKT } from "drizzle-orm/pg-core";
 import type { Kernel } from "../../../runtime/kernel.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus } from "../utils.js";
 import { processedWebhookEvents } from "../../../modules/webhooks/schema.js";
 import type { Actor } from "../../../auth/types.js";
 import { toCommerceError } from "../../../kernel/errors.js";
@@ -21,7 +21,7 @@ export function paymentRoutes(kernel: Kernel) {
     const adapter = resolvedAdapter.value;
     const result = await adapter.verifyWebhook(c.req.raw);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
 
     const event = result.value;

package/src/interfaces/rest/routes/pricing.ts

@@ -5,7 +5,7 @@ import type { DrizzleDatabase } from "../../../kernel/database/drizzle-db.js";
 import { CatalogRepository } from "../../../modules/catalog/repository/index.js";
 import type { Kernel } from "../../../runtime/kernel.js";
 import { setBasePriceRoute, createModifierRoute, listPricesRoute, listModifiersRoute, updateModifierRoute, deleteModifierRoute } from "../schemas/pricing.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requirePerm } from "../utils.js";
 
 export function pricingRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
@@ -19,7 +19,7 @@ export function pricingRoutes(kernel: Kernel) {
     const actor = c.get("actor");
     const result = await kernel.services.pricing.setBasePrice(c.req.valid("json"), actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value }, 201);
   });
@@ -39,7 +39,7 @@ export function pricingRoutes(kernel: Kernel) {
       ...(customerGroupId !== undefined ? { customerGroupId } : {}),
     }, actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -60,7 +60,7 @@ export function pricingRoutes(kernel: Kernel) {
       ...(active === "true" ? { active: true } : {}),
     }, actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -74,7 +74,7 @@ export function pricingRoutes(kernel: Kernel) {
       actor,
     );
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -84,7 +84,7 @@ export function pricingRoutes(kernel: Kernel) {
     const actor = c.get("actor");
     const result = await kernel.services.pricing.deleteModifier(c.req.param("id"), actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -102,7 +102,7 @@ export function pricingRoutes(kernel: Kernel) {
       const entity = await catalogRepo.findEntityById(input.entityId);
       if (!entity || entity.organizationId !== orgId) {
         return c.json(
-          mapErrorToResponse(
+          errorBody(
             new CommerceValidationError("entityId does not belong to this organization."),
           ),
           422,
@@ -112,7 +112,7 @@ export function pricingRoutes(kernel: Kernel) {
 
     const result = await kernel.services.pricing.createModifier(input, actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value }, 201);
   });

package/src/interfaces/rest/routes/promotions.ts

@@ -3,7 +3,7 @@ import { rateLimiter } from "hono-rate-limiter";
 import type { Kernel } from "../../../runtime/kernel.js";
 import { createPromotionRoute, updatePromotionRoute, validatePromotionRoute, deactivatePromotionRoute, listPromotionsRoute } from "../schemas/promotions.js";
 import type { PromotionStatusFilter } from "../../../modules/promotions/service.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requireMethodPerm, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requireMethodPerm, requirePerm } from "../utils.js";
 import { resolveOrgIdForCommerce } from "../../../auth/org.js";
 import { assertPermission } from "../../../auth/permissions.js";
 
@@ -34,7 +34,7 @@ export function promotionRoutes(kernel: Kernel) {
     const actor = c.get("actor");
     const result = await kernel.services.promotions.create(body, actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value }, 201);
   });
@@ -49,7 +49,7 @@ export function promotionRoutes(kernel: Kernel) {
       actor,
     );
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -77,7 +77,7 @@ export function promotionRoutes(kernel: Kernel) {
     });
 
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
 
     return c.json({ data: result.value });
@@ -96,12 +96,12 @@ export function promotionRoutes(kernel: Kernel) {
     try {
       assertPermission(actor, "promotions:manage");
     } catch (error) {
-      return c.json(mapErrorToResponse(error), mapErrorToStatus(error));
+      return c.json(errorBody(error), mapErrorToStatus(error));
     }
     const orgId = resolveOrgIdForCommerce(actor, kernel.config);
     const result = await kernel.services.promotions.update(orgId, c.req.param("id"), body, actor);
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });
@@ -116,7 +116,7 @@ export function promotionRoutes(kernel: Kernel) {
     const orgId = resolveOrgIdForCommerce(actor, kernel.config);
     const result = await kernel.services.promotions.deactivate(orgId, c.req.param("id"));
     if (!result.ok) {
-      return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+      return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     }
     return c.json({ data: result.value });
   });

package/src/interfaces/rest/routes/search.ts

@@ -1,7 +1,7 @@
 import { OpenAPIHono } from "@hono/zod-openapi";
 import type { Kernel } from "../../../runtime/kernel.js";
 import { searchRoute, suggestRoute } from "../schemas/search.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requirePerm } from "../utils.js";
 
 const SAFE_ATTRIBUTE_NAME = /^[A-Za-z0-9_-]+$/;
 
@@ -53,7 +53,7 @@ export function searchRoutes(kernel: Kernel) {
       }, { actor: c.get("actor"), tx: null, requestId: "" });
 
       if (!result.ok) {
-        return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+        return c.json(errorBody(result.error), mapErrorToStatus(result.error));
       }
 
       return c.json({
@@ -85,7 +85,7 @@ export function searchRoutes(kernel: Kernel) {
       }, { actor: c.get("actor"), tx: null, requestId: "" });
 
       if (!result.ok) {
-        return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+        return c.json(errorBody(result.error), mapErrorToStatus(result.error));
       }
 
       return c.json({ data: result.value });

package/src/interfaces/rest/routes/settings.ts

@@ -6,7 +6,7 @@ import {
   getSettingsGroupRoute,
   patchSettingsGroupRoute,
 } from "../schemas/settings.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requirePerm } from "../utils.js";
 
 export function settingsRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
@@ -17,14 +17,14 @@ export function settingsRoutes(kernel: Kernel) {
   // @ts-expect-error -- openapi handler union return type
   router.openapi(getAllSettingsRoute, async (c) => {
     const result = await kernel.services.settings.getAll(c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(getSettingsGroupRoute, async (c) => {
     const result = await kernel.services.settings.getGroup(c.req.param("group"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -53,7 +53,7 @@ export function settingsRoutes(kernel: Kernel) {
     }
 
     const result = await kernel.services.settings.updateGroup(group, body, c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 

package/src/interfaces/rest/routes/shipping.ts

@@ -10,7 +10,7 @@ import {
   updateShippingRateRoute,
   deleteShippingRateRoute,
 } from "../schemas/shipping.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requirePerm } from "../utils.js";
 
 export function shippingRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
@@ -23,14 +23,14 @@ export function shippingRoutes(kernel: Kernel) {
   // @ts-expect-error -- openapi handler union return type
   router.openapi(createShippingZoneRoute, async (c) => {
     const result = await kernel.services.shipping.createZone(c.req.valid("json"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(listShippingZonesRoute, async (c) => {
     const result = await kernel.services.shipping.listZones(c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -41,21 +41,21 @@ export function shippingRoutes(kernel: Kernel) {
       c.req.valid("json"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(deleteShippingZoneRoute, async (c) => {
     const result = await kernel.services.shipping.deleteZone(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(createShippingRateRoute, async (c) => {
     const result = await kernel.services.shipping.createRate(c.req.valid("json"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
@@ -66,7 +66,7 @@ export function shippingRoutes(kernel: Kernel) {
       zoneId !== undefined ? { zoneId } : undefined,
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -77,14 +77,14 @@ export function shippingRoutes(kernel: Kernel) {
       c.req.valid("json"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(deleteShippingRateRoute, async (c) => {
     const result = await kernel.services.shipping.deleteRate(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 

package/src/interfaces/rest/routes/tax.ts

@@ -10,7 +10,7 @@ import {
   updateTaxClassRoute,
   deleteTaxClassRoute,
 } from "../schemas/tax.js";
-import { type AppEnv, mapErrorToResponse, mapErrorToStatus, requirePerm } from "../utils.js";
+import { type AppEnv, errorBody, mapErrorToStatus, requirePerm } from "../utils.js";
 
 export function taxRoutes(kernel: Kernel) {
   const router = new OpenAPIHono<AppEnv>();
@@ -23,14 +23,14 @@ export function taxRoutes(kernel: Kernel) {
   // @ts-expect-error -- openapi handler union return type
   router.openapi(createTaxRateRoute, async (c) => {
     const result = await kernel.services.tax.createTaxRate(c.req.valid("json"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(listTaxRatesRoute, async (c) => {
     const result = await kernel.services.tax.listTaxRates(c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -41,14 +41,14 @@ export function taxRoutes(kernel: Kernel) {
       c.req.valid("json"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(deleteTaxRateRoute, async (c) => {
     const result = await kernel.services.tax.deleteTaxRate(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -57,14 +57,14 @@ export function taxRoutes(kernel: Kernel) {
   // @ts-expect-error -- openapi handler union return type
   router.openapi(createTaxClassRoute, async (c) => {
     const result = await kernel.services.tax.createTaxClass(c.req.valid("json"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value }, 201);
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(listTaxClassesRoute, async (c) => {
     const result = await kernel.services.tax.listTaxClasses(c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
@@ -75,14 +75,14 @@ export function taxRoutes(kernel: Kernel) {
       c.req.valid("json"),
       c.get("actor"),
     );
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });
 
   // @ts-expect-error -- openapi handler union return type
   router.openapi(deleteTaxClassRoute, async (c) => {
     const result = await kernel.services.tax.deleteTaxClass(c.req.param("id"), c.get("actor"));
-    if (!result.ok) return c.json(mapErrorToResponse(result.error), mapErrorToStatus(result.error));
+    if (!result.ok) return c.json(errorBody(result.error), mapErrorToStatus(result.error));
     return c.json({ data: result.value });
   });