@twin.org/api-models 0.0.1-next.9 → 0.0.2-next.1

package/dist/cjs/index.cjs

@@ -3,6 +3,30 @@
 var core = require('@twin.org/core');
 var web = require('@twin.org/web');
 
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of mime type processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const MimeTypeProcessorFactory = core.Factory.createFactory("mime-type-processor");
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of REST route processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const RestRouteProcessorFactory = core.Factory.createFactory("rest-route-processor");
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of socket route processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const SocketRouteProcessorFactory = core.Factory.createFactory("socket-route-processor");
+
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
 /**
@@ -21,18 +45,17 @@ class HttpErrorHelper {
         // types then set the http response code accordingly
         const flattened = core.BaseError.flatten(error);
         let httpStatusCode = web.HttpStatusCode.internalServerError;
-        if (flattened.some(e => core.BaseError.isErrorName(e, core.GuardError.CLASS_NAME))) {
+        if (flattened.some(e => core.BaseError.isErrorName(e, core.GuardError.CLASS_NAME)) ||
+            flattened.some(e => core.BaseError.isErrorName(e, core.ValidationError.CLASS_NAME))) {
             httpStatusCode = web.HttpStatusCode.badRequest;
         }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.ConflictError.CLASS_NAME))) {
+        else if (flattened.some(e => core.BaseError.isErrorName(e, core.ConflictError.CLASS_NAME)) ||
+            flattened.some(e => core.BaseError.isErrorName(e, core.AlreadyExistsError.CLASS_NAME))) {
             httpStatusCode = web.HttpStatusCode.conflict;
         }
         else if (flattened.some(e => core.BaseError.isErrorName(e, core.NotFoundError.CLASS_NAME))) {
             httpStatusCode = web.HttpStatusCode.notFound;
         }
-        else if (flattened.some(e => core.BaseError.isErrorName(e, core.AlreadyExistsError.CLASS_NAME))) {
-            httpStatusCode = web.HttpStatusCode.conflict;
-        }
         else if (flattened.some(e => core.BaseError.isErrorName(e, core.UnauthorizedError.CLASS_NAME))) {
             httpStatusCode = web.HttpStatusCode.unauthorized;
         }
@@ -42,10 +65,7 @@ class HttpErrorHelper {
         else if (flattened.some(e => core.BaseError.isErrorName(e, core.UnprocessableError.CLASS_NAME))) {
             httpStatusCode = web.HttpStatusCode.unprocessableEntity;
         }
-        const returnError = error.toJsonObject();
-        if (!includeStack) {
-            delete returnError.stack;
-        }
+        const returnError = error.toJsonObject(includeStack);
         return {
             error: returnError,
             httpStatusCode
@@ -93,7 +113,7 @@ class HttpParameterHelper {
      * @returns The object.
      */
     static objectFromString(value) {
-        return core.Coerce.object(value);
+        return core.Is.json(value) ? JSON.parse(value) : undefined;
     }
     /**
      * Convert object to query string.
@@ -101,7 +121,7 @@ class HttpParameterHelper {
      * @returns The converted object.
      */
     static objectToString(value) {
-        return core.Is.object(value) ? JSON.stringify(value) : undefined;
+        return core.Is.empty(value) ? undefined : JSON.stringify(value);
     }
 }
 
@@ -129,3 +149,6 @@ const HealthStatus = {
 exports.HealthStatus = HealthStatus;
 exports.HttpErrorHelper = HttpErrorHelper;
 exports.HttpParameterHelper = HttpParameterHelper;
+exports.MimeTypeProcessorFactory = MimeTypeProcessorFactory;
+exports.RestRouteProcessorFactory = RestRouteProcessorFactory;
+exports.SocketRouteProcessorFactory = SocketRouteProcessorFactory;

package/dist/esm/index.mjs

@@ -1,5 +1,29 @@
-import { BaseError, GuardError, ConflictError, NotFoundError, AlreadyExistsError, UnauthorizedError, NotImplementedError, UnprocessableError, Coerce, Is } from '@twin.org/core';
-import { HttpStatusCode, HeaderTypes, MimeTypes } from '@twin.org/web';
+import { Factory, BaseError, GuardError, ValidationError, ConflictError, AlreadyExistsError, NotFoundError, UnauthorizedError, NotImplementedError, UnprocessableError, Is } from '@twin.org/core';
+import { HttpStatusCode, MimeTypes, HeaderTypes } from '@twin.org/web';
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of mime type processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const MimeTypeProcessorFactory = Factory.createFactory("mime-type-processor");
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of REST route processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const RestRouteProcessorFactory = Factory.createFactory("rest-route-processor");
+
+// Copyright 2024 IOTA Stiftung.
+// SPDX-License-Identifier: Apache-2.0.
+/**
+ * Factory for creating implementation of socket route processor types.
+ */
+// eslint-disable-next-line @typescript-eslint/naming-convention
+const SocketRouteProcessorFactory = Factory.createFactory("socket-route-processor");
 
 // Copyright 2024 IOTA Stiftung.
 // SPDX-License-Identifier: Apache-2.0.
@@ -19,18 +43,17 @@ class HttpErrorHelper {
         // types then set the http response code accordingly
         const flattened = BaseError.flatten(error);
         let httpStatusCode = HttpStatusCode.internalServerError;
-        if (flattened.some(e => BaseError.isErrorName(e, GuardError.CLASS_NAME))) {
+        if (flattened.some(e => BaseError.isErrorName(e, GuardError.CLASS_NAME)) ||
+            flattened.some(e => BaseError.isErrorName(e, ValidationError.CLASS_NAME))) {
             httpStatusCode = HttpStatusCode.badRequest;
         }
-        else if (flattened.some(e => BaseError.isErrorName(e, ConflictError.CLASS_NAME))) {
+        else if (flattened.some(e => BaseError.isErrorName(e, ConflictError.CLASS_NAME)) ||
+            flattened.some(e => BaseError.isErrorName(e, AlreadyExistsError.CLASS_NAME))) {
             httpStatusCode = HttpStatusCode.conflict;
         }
         else if (flattened.some(e => BaseError.isErrorName(e, NotFoundError.CLASS_NAME))) {
             httpStatusCode = HttpStatusCode.notFound;
         }
-        else if (flattened.some(e => BaseError.isErrorName(e, AlreadyExistsError.CLASS_NAME))) {
-            httpStatusCode = HttpStatusCode.conflict;
-        }
         else if (flattened.some(e => BaseError.isErrorName(e, UnauthorizedError.CLASS_NAME))) {
             httpStatusCode = HttpStatusCode.unauthorized;
         }
@@ -40,10 +63,7 @@ class HttpErrorHelper {
         else if (flattened.some(e => BaseError.isErrorName(e, UnprocessableError.CLASS_NAME))) {
             httpStatusCode = HttpStatusCode.unprocessableEntity;
         }
-        const returnError = error.toJsonObject();
-        if (!includeStack) {
-            delete returnError.stack;
-        }
+        const returnError = error.toJsonObject(includeStack);
         return {
             error: returnError,
             httpStatusCode
@@ -91,7 +111,7 @@ class HttpParameterHelper {
      * @returns The object.
      */
     static objectFromString(value) {
-        return Coerce.object(value);
+        return Is.json(value) ? JSON.parse(value) : undefined;
     }
     /**
      * Convert object to query string.
@@ -99,7 +119,7 @@ class HttpParameterHelper {
      * @returns The converted object.
      */
     static objectToString(value) {
-        return Is.object(value) ? JSON.stringify(value) : undefined;
+        return Is.empty(value) ? undefined : JSON.stringify(value);
     }
 }
 
@@ -124,4 +144,4 @@ const HealthStatus = {
     Error: "error"
 };
 
-export { HealthStatus, HttpErrorHelper, HttpParameterHelper };
+export { HealthStatus, HttpErrorHelper, HttpParameterHelper, MimeTypeProcessorFactory, RestRouteProcessorFactory, SocketRouteProcessorFactory };

package/dist/types/factories/mimeTypeProcessorFactory.d.ts

@@ -0,0 +1,6 @@
+import { Factory } from "@twin.org/core";
+import type { IMimeTypeProcessor } from "../models/server/IMimeTypeProcessor";
+/**
+ * Factory for creating implementation of mime type processor types.
+ */
+export declare const MimeTypeProcessorFactory: Factory<IMimeTypeProcessor>;

package/dist/types/factories/restRouteProcessorFactory.d.ts

@@ -0,0 +1,6 @@
+import { Factory } from "@twin.org/core";
+import type { IRestRouteProcessor } from "../models/server/IRestRouteProcessor";
+/**
+ * Factory for creating implementation of REST route processor types.
+ */
+export declare const RestRouteProcessorFactory: Factory<IRestRouteProcessor>;

package/dist/types/factories/socketRouteProcessorFactory.d.ts

@@ -0,0 +1,6 @@
+import { Factory } from "@twin.org/core";
+import type { ISocketRouteProcessor } from "../models/server/ISocketRouteProcessor";
+/**
+ * Factory for creating implementation of socket route processor types.
+ */
+export declare const SocketRouteProcessorFactory: Factory<ISocketRouteProcessor>;

package/dist/types/index.d.ts

@@ -1,3 +1,6 @@
+export * from "./factories/mimeTypeProcessorFactory";
+export * from "./factories/restRouteProcessorFactory";
+export * from "./factories/socketRouteProcessorFactory";
 export * from "./helpers/httpErrorHelper";
 export * from "./helpers/httpParameterHelper";
 export * from "./models/api/IServerHealthResponse";
@@ -25,6 +28,7 @@ export * from "./models/responses/success/ICreatedResponse";
 export * from "./models/responses/success/INoContentResponse";
 export * from "./models/responses/success/IOkResponse";
 export * from "./models/routes/IBaseRoute";
+export * from "./models/routes/IBaseRouteEntryPoint";
 export * from "./models/routes/IRestRoute";
 export * from "./models/routes/IRestRouteEntryPoint";
 export * from "./models/routes/IRestRouteExample";
@@ -33,8 +37,12 @@ export * from "./models/routes/IRestRouteResponseAttachmentOptions";
 export * from "./models/routes/IRestRouteResponseExample";
 export * from "./models/routes/IRestRouteResponseOptions";
 export * from "./models/routes/ISocketRoute";
+export * from "./models/routes/ISocketRouteEntryPoint";
 export * from "./models/routes/ITag";
-export * from "./models/server/IHttpRestRouteProcessor";
+export * from "./models/server/IBaseRouteProcessor";
+export * from "./models/server/IMimeTypeProcessor";
+export * from "./models/server/IRestRouteProcessor";
+export * from "./models/server/ISocketRouteProcessor";
 export * from "./models/server/IWebServer";
 export * from "./models/server/IWebServerOptions";
 export * from "./models/services/healthStatus";

package/dist/types/models/config/IBaseSocketClientConfig.d.ts

@@ -3,6 +3,10 @@ import type { IHttpHeaders } from "@twin.org/web";
  * Definition for the configuration of a socket service.
  */
 export interface IBaseSocketClientConfig {
+    /**
+     * Base path for the socket service, defaults to /socket.
+     */
+    basePath?: string;
     /**
      * The endpoint where the api is hosted.
      */

package/dist/types/models/routes/IBaseRouteEntryPoint.d.ts

@@ -0,0 +1,22 @@
+import type { ITag } from "./ITag";
+/**
+ * Route entry points are used for exposing the routes from a package.
+ */
+export interface IBaseRouteEntryPoint<T> {
+    /**
+     * The name of the routes.
+     */
+    name: string;
+    /**
+     * The default base route name for the routes.
+     */
+    defaultBaseRoute: string;
+    /**
+     * The tags for the routes.
+     */
+    tags: ITag[];
+    /**
+     * The method to generate the routes.
+     */
+    generateRoutes: (baseRouteName: string, componentName: string) => T[];
+}

package/dist/types/models/routes/IRestRouteEntryPoint.d.ts

@@ -1,23 +1,6 @@
+import type { IBaseRouteEntryPoint } from "./IBaseRouteEntryPoint";
 import type { IRestRoute } from "./IRestRoute";
-import type { ITag } from "./ITag";
 /**
  * Route entry points are used for exposing the REST routes from a package.
  */
-export interface IRestRouteEntryPoint {
-    /**
-     * The name of the REST routes.
-     */
-    name: string;
-    /**
-     * The default base route name for the REST routes.
-     */
-    defaultBaseRoute: string;
-    /**
-     * The tags for the REST routes.
-     */
-    tags: ITag[];
-    /**
-     * The method to generate the REST routes.
-     */
-    generateRoutes: (baseRouteName: string, componentName: string) => IRestRoute[];
-}
+export type IRestRouteEntryPoint = IBaseRouteEntryPoint<IRestRoute>;

package/dist/types/models/routes/ISocketRoute.d.ts

@@ -1,9 +1,11 @@
 import type { IBaseRoute } from "./IBaseRoute";
+import type { IHttpRequest } from "../protocol/IHttpRequest";
 import type { IHttpRequestContext } from "../protocol/IHttpRequestContext";
+import type { IHttpResponse } from "../protocol/IHttpResponse";
 /**
  * Interface which defines a socket route.
  */
-export interface ISocketRoute extends IBaseRoute {
+export interface ISocketRoute<T extends IHttpRequest = any, U extends IHttpResponse = any> extends IBaseRoute {
     /**
      * The handler module.
      */
@@ -12,16 +14,12 @@ export interface ISocketRoute extends IBaseRoute {
      * The request context.
      */
     httpRequestContext: IHttpRequestContext, 
-    /**
-     * The id of the socket the request is arriving on.
-     */
-    socketId: string, 
     /**
      * The request object.
      */
-    request: unknown, 
+    request: T, 
     /**
-     * Method to emit data on the socket.
+     * The function to emit an event.
      */
-    emitter: (topic: string, response?: unknown) => Promise<void>) => Promise<void>;
+    emit: (event: string, response: U) => Promise<void>) => void;
 }

package/dist/types/models/routes/ISocketRouteEntryPoint.d.ts

@@ -0,0 +1,6 @@
+import type { IBaseRouteEntryPoint } from "./IBaseRouteEntryPoint";
+import type { ISocketRoute } from "./ISocketRoute";
+/**
+ * Route entry points are used for exposing the socket routes from a package.
+ */
+export type ISocketRouteEntryPoint = IBaseRouteEntryPoint<ISocketRoute>;

package/dist/types/models/server/IBaseRouteProcessor.d.ts

@@ -0,0 +1,34 @@
+import type { IComponent } from "@twin.org/core";
+import type { IHttpRequestIdentity } from "../protocol/IHttpRequestIdentity";
+import type { IHttpResponse } from "../protocol/IHttpResponse";
+import type { IHttpServerRequest } from "../protocol/IHttpServerRequest";
+import type { IBaseRoute } from "../routes/IBaseRoute";
+/**
+ * The definition for a base processor for handling REST routes.
+ */
+export interface IBaseRouteProcessor<T = IBaseRoute> extends IComponent {
+    /**
+     * Pre process the REST request for the specified route.
+     * @param request The request to handle.
+     * @param response The response data to send if any.
+     * @param route The route being requested, if a matching one was found.
+     * @param requestIdentity The identity context for the request.
+     * @param processorState The state handed through the processors.
+     * @returns Promise that resolves when the request is processed.
+     */
+    pre?(request: IHttpServerRequest, response: IHttpResponse, route: T | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+        [id: string]: unknown;
+    }): Promise<void>;
+    /**
+     * Post process the REST request for the specified route.
+     * @param request The request to handle.
+     * @param response The response data to send if any.
+     * @param route The route being requested, if a matching one was found.
+     * @param requestIdentity The identity context for the request.
+     * @param processorState The state handed through the processors.
+     * @returns Promise that resolves when the request is processed.
+     */
+    post?(request: IHttpServerRequest, response: IHttpResponse, route: T | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+        [id: string]: unknown;
+    }): Promise<void>;
+}

package/dist/types/models/server/IMimeTypeProcessor.d.ts

@@ -0,0 +1,17 @@
+import type { IComponent } from "@twin.org/core";
+/**
+ * The definition for a handler for a specific MIME type.
+ */
+export interface IMimeTypeProcessor extends IComponent {
+    /**
+     * Get the MIME types that this handler can handle.
+     * @returns The MIME types that this handler can handle.
+     */
+    getTypes(): string[];
+    /**
+     * Handle content.
+     * @param body The body to process.
+     * @returns The processed body.
+     */
+    handle(body: Uint8Array): Promise<unknown>;
+}

package/dist/types/models/server/IRestRouteProcessor.d.ts

@@ -0,0 +1,22 @@
+import type { IBaseRouteProcessor } from "./IBaseRouteProcessor";
+import type { IHttpRequestIdentity } from "../protocol/IHttpRequestIdentity";
+import type { IHttpResponse } from "../protocol/IHttpResponse";
+import type { IHttpServerRequest } from "../protocol/IHttpServerRequest";
+import type { IRestRoute } from "../routes/IRestRoute";
+/**
+ * The definition for a processor for handling REST routes.
+ */
+export interface IRestRouteProcessor extends IBaseRouteProcessor<IRestRoute> {
+    /**
+     * Process the REST request for the specified route.
+     * @param request The request to handle.
+     * @param response The response data to send if any.
+     * @param route The route being requested, if a matching one was found.
+     * @param requestIdentity The identity context for the request.
+     * @param processorState The state handed through the processors.
+     * @returns Promise that resolves when the request is processed.
+     */
+    process?(request: IHttpServerRequest, response: IHttpResponse, route: IRestRoute | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+        [id: string]: unknown;
+    }): Promise<void>;
+}

package/dist/types/models/server/{IHttpRestRouteProcessor.d.ts → ISocketRouteProcessor.d.ts}

@@ -1,46 +1,43 @@
-import type { IComponent } from "@twin.org/core";
+import type { IBaseRouteProcessor } from "./IBaseRouteProcessor";
 import type { IHttpRequestIdentity } from "../protocol/IHttpRequestIdentity";
 import type { IHttpResponse } from "../protocol/IHttpResponse";
 import type { IHttpServerRequest } from "../protocol/IHttpServerRequest";
-import type { IRestRoute } from "../routes/IRestRoute";
+import type { ISocketRoute } from "../routes/ISocketRoute";
 /**
- * The definition for a processor for handling REST routes.
+ * The definition for a processor for handling socket routes.
  */
-export interface IHttpRestRouteProcessor extends IComponent {
+export interface ISocketRouteProcessor extends IBaseRouteProcessor<ISocketRoute> {
     /**
-     * Pre process the REST request for the specified route.
+     * Process the connected event.
      * @param request The request to handle.
-     * @param response The response data to send if any.
      * @param route The route being requested, if a matching one was found.
-     * @param requestIdentity The identity context for the request.
      * @param processorState The state handed through the processors.
      * @returns Promise that resolves when the request is processed.
      */
-    pre?(request: IHttpServerRequest, response: IHttpResponse, route: IRestRoute | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+    connected?(request: IHttpServerRequest, route: ISocketRoute | undefined, processorState: {
         [id: string]: unknown;
     }): Promise<void>;
     /**
-     * Process the REST request for the specified route.
+     * Process the disconnected event.
      * @param request The request to handle.
-     * @param response The response data to send if any.
      * @param route The route being requested, if a matching one was found.
-     * @param requestIdentity The identity context for the request.
      * @param processorState The state handed through the processors.
      * @returns Promise that resolves when the request is processed.
      */
-    process?(request: IHttpServerRequest, response: IHttpResponse, route: IRestRoute | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+    disconnected?(request: IHttpServerRequest, route: ISocketRoute | undefined, processorState: {
         [id: string]: unknown;
     }): Promise<void>;
     /**
-     * Post process the REST request for the specified route.
+     * Process the REST request for the specified route.
      * @param request The request to handle.
      * @param response The response data to send if any.
      * @param route The route being requested, if a matching one was found.
      * @param requestIdentity The identity context for the request.
      * @param processorState The state handed through the processors.
+     * @param responseEmitter The function to emit a response.
      * @returns Promise that resolves when the request is processed.
      */
-    post?(request: IHttpServerRequest, response: IHttpResponse, route: IRestRoute | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
+    process?(request: IHttpServerRequest, response: IHttpResponse, route: ISocketRoute | undefined, requestIdentity: IHttpRequestIdentity, processorState: {
         [id: string]: unknown;
-    }): Promise<void>;
+    }, responseEmitter: (topic: string, response: IHttpResponse) => Promise<void>): Promise<void>;
 }

package/dist/types/models/server/IWebServer.d.ts

@@ -1,6 +1,8 @@
-import type { IHttpRestRouteProcessor } from "./IHttpRestRouteProcessor";
+import type { IRestRouteProcessor } from "./IRestRouteProcessor";
+import type { ISocketRouteProcessor } from "./ISocketRouteProcessor";
 import type { IWebServerOptions } from "./IWebServerOptions";
 import type { IRestRoute } from "../routes/IRestRoute";
+import type { ISocketRoute } from "../routes/ISocketRoute";
 /**
  * Interface describing a web server.
  */
@@ -12,12 +14,14 @@ export interface IWebServer<T> {
     getInstance(): T;
     /**
      * Build the server.
-     * @param restRouteProcessors The hooks to process the incoming requests.
+     * @param restRouteProcessors The processors for incoming requests over REST.
      * @param restRoutes The REST routes.
+     * @param socketRouteProcessors The processors for incoming requests over Sockets.
+     * @param socketRoutes The socket routes.
      * @param options Options for building the server.
      * @returns Nothing.
      */
-    build(restRouteProcessors: IHttpRestRouteProcessor[], restRoutes: IRestRoute[], options?: IWebServerOptions): Promise<void>;
+    build(restRouteProcessors?: IRestRouteProcessor[], restRoutes?: IRestRoute[], socketRouteProcessors?: ISocketRouteProcessor[], socketRoutes?: ISocketRoute[], options?: IWebServerOptions): Promise<void>;
     /**
      * Start the server.
      * @returns Nothing.

package/docs/changelog.md

@@ -1,5 +1,57 @@
 # @twin.org/api-models - Changelog
 
-## v0.0.1-next.9
+## [0.0.2-next.1](https://github.com/twinfoundation/api/compare/api-models-v0.0.2-next.0...api-models-v0.0.2-next.1) (2025-07-08)
+
+
+### Features
+
+* update dependencies ([1171dc4](https://github.com/twinfoundation/api/commit/1171dc416a9481737f6a640e3cf30145768f37e9))
+* use new includeStackTrace flag for toJsonObject ([6452b15](https://github.com/twinfoundation/api/commit/6452b153af786eee14b21152420f8a2578b70593))
+* use shared store mechanism ([#19](https://github.com/twinfoundation/api/issues/19)) ([32116df](https://github.com/twinfoundation/api/commit/32116df3b4380a30137f5056f242a5c99afa2df9))
+* validationError mapped to http status badrequest ([adc5eb1](https://github.com/twinfoundation/api/commit/adc5eb11d987abb0ab9f7e0dc8e1fdae207e436e))
+
+## 0.0.1 (2025-07-03)
+
+
+### Features
+
+* release to production ([70ee2d5](https://github.com/twinfoundation/api/commit/70ee2d56a1dc9537d7c9c154d4cb78a235678a3a))
+
+## [0.0.1-next.36](https://github.com/twinfoundation/api/compare/api-models-v0.0.1-next.35...api-models-v0.0.1-next.36) (2025-06-17)
+
+
+### Features
+
+* use new includeStackTrace flag for toJsonObject ([6452b15](https://github.com/twinfoundation/api/commit/6452b153af786eee14b21152420f8a2578b70593))
+
+## [0.0.1-next.35](https://github.com/twinfoundation/api/compare/api-models-v0.0.1-next.34...api-models-v0.0.1-next.35) (2025-06-11)
+
+
+### Features
+
+* update dependencies ([1171dc4](https://github.com/twinfoundation/api/commit/1171dc416a9481737f6a640e3cf30145768f37e9))
+
+## [0.0.1-next.34](https://github.com/twinfoundation/api/compare/api-models-v0.0.1-next.33...api-models-v0.0.1-next.34) (2025-05-27)
+
+
+### Features
+
+* validationError mapped to http status badrequest ([adc5eb1](https://github.com/twinfoundation/api/commit/adc5eb11d987abb0ab9f7e0dc8e1fdae207e436e))
+
+## [0.0.1-next.33](https://github.com/twinfoundation/api/compare/api-models-v0.0.1-next.32...api-models-v0.0.1-next.33) (2025-04-17)
+
+
+### Features
+
+* use shared store mechanism ([#19](https://github.com/twinfoundation/api/issues/19)) ([32116df](https://github.com/twinfoundation/api/commit/32116df3b4380a30137f5056f242a5c99afa2df9))
+
+## [0.0.1-next.32](https://github.com/twinfoundation/api/compare/api-models-v0.0.1-next.31...api-models-v0.0.1-next.32) (2025-03-28)
+
+
+### Miscellaneous Chores
+
+* **api-models:** Synchronize repo versions
+
+## v0.0.1-next.31
 
 - Initial Release

package/docs/reference/classes/HttpErrorHelper.md

@@ -4,29 +4,33 @@ Class to help with processing http errors.
 
 ## Constructors
 
-### new HttpErrorHelper()
+### Constructor
 
-> **new HttpErrorHelper**(): [`HttpErrorHelper`](HttpErrorHelper.md)
+> **new HttpErrorHelper**(): `HttpErrorHelper`
 
 #### Returns
 
-[`HttpErrorHelper`](HttpErrorHelper.md)
+`HttpErrorHelper`
 
 ## Methods
 
 ### processError()
 
-> `static` **processError**(`err`, `includeStack`?): `object`
+> `static` **processError**(`err`, `includeStack?`): `object`
 
 Process the errors from the routes.
 
 #### Parameters
 
-• **err**: `unknown`
+##### err
+
+`unknown`
 
 The error to process.
 
-• **includeStack?**: `boolean`
+##### includeStack?
+
+`boolean`
 
 Should the stack be included in the error.
 
@@ -54,15 +58,21 @@ Build an error response.
 
 #### Parameters
 
-• **response**: [`IHttpResponse`](../interfaces/IHttpResponse.md)\<`any`\>
+##### response
+
+[`IHttpResponse`](../interfaces/IHttpResponse.md)
 
 The response to build the error into.
 
-• **error**: `IError`
+##### error
+
+`IError`
 
 The error to build the response for.
 
-• **statusCode**: `HttpStatusCode`
+##### statusCode
+
+`HttpStatusCode`
 
 The status code to use for the error.