@twin.org/api-models 0.0.1-next.8 → 0.0.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
@@ -88,71 +108,20 @@ class HttpParameterHelper {
         return values?.join(",");
     }
     /**
-     * Convert the conditions string to a list of comparators.
-     * @param conditions The conditions query string.
-     * @returns The list of comparators.
+     * Convert object string to object.
+     * @param value The value query string.
+     * @returns The object.
      */
-    static conditionsFromString(conditions) {
-        const conditionParts = conditions?.split(",") ?? [];
-        const conditionsList = [];
-        for (const conditionPart of conditionParts) {
-            const parts = conditionPart.split("|");
-            if (parts.length === 3) {
-                conditionsList.push({
-                    property: parts[0],
-                    comparison: parts[1],
-                    value: parts[2]
-                });
-            }
-        }
-        return conditionsList.length === 0 ? undefined : conditionsList;
+    static objectFromString(value) {
+        return core.Is.json(value) ? JSON.parse(value) : undefined;
     }
     /**
-     * Convert the conditions to a string parameter.
-     * @param conditions The conditions to convert.
-     * @returns The string version of the comparators.
+     * Convert object to query string.
+     * @param value The value to convert to a string.
+     * @returns The converted object.
      */
-    static conditionsToString(conditions) {
-        if (core.Is.arrayValue(conditions)) {
-            const conditionsList = [];
-            for (const conditionPart of conditions) {
-                conditionsList.push(`${conditionPart.property}|${conditionPart.comparison}|${conditionPart.value}`);
-            }
-            return conditionsList.join(",");
-        }
-    }
-    /**
-     * Convert the sort string to a list of sort properties.
-     * @param sortProperties The sort properties query string.
-     * @returns The list of sort properties.
-     */
-    static sortPropertiesFromString(sortProperties) {
-        const sortParts = sortProperties?.split(",") ?? [];
-        const sortPropertyList = [];
-        for (const conditionPart of sortParts) {
-            const parts = conditionPart.split("|");
-            if (parts.length === 2) {
-                sortPropertyList.push({
-                    property: parts[0],
-                    sortDirection: parts[1]
-                });
-            }
-        }
-        return sortPropertyList.length === 0 ? undefined : sortPropertyList;
-    }
-    /**
-     * Convert the sort properties to a string parameter.
-     * @param sortProperties The sort properties to convert.
-     * @returns The string version of the sort properties.
-     */
-    static sortPropertiesToString(sortProperties) {
-        if (core.Is.arrayValue(sortProperties)) {
-            const sortPropertyList = [];
-            for (const conditionPart of sortProperties) {
-                sortPropertyList.push(`${conditionPart.property}|${conditionPart.sortDirection}`);
-            }
-            return sortPropertyList.join(",");
-        }
+    static objectToString(value) {
+        return core.Is.empty(value) ? undefined : JSON.stringify(value);
     }
 }
 
@@ -180,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, 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
@@ -86,71 +106,20 @@ class HttpParameterHelper {
         return values?.join(",");
     }
     /**
-     * Convert the conditions string to a list of comparators.
-     * @param conditions The conditions query string.
-     * @returns The list of comparators.
+     * Convert object string to object.
+     * @param value The value query string.
+     * @returns The object.
      */
-    static conditionsFromString(conditions) {
-        const conditionParts = conditions?.split(",") ?? [];
-        const conditionsList = [];
-        for (const conditionPart of conditionParts) {
-            const parts = conditionPart.split("|");
-            if (parts.length === 3) {
-                conditionsList.push({
-                    property: parts[0],
-                    comparison: parts[1],
-                    value: parts[2]
-                });
-            }
-        }
-        return conditionsList.length === 0 ? undefined : conditionsList;
+    static objectFromString(value) {
+        return Is.json(value) ? JSON.parse(value) : undefined;
     }
     /**
-     * Convert the conditions to a string parameter.
-     * @param conditions The conditions to convert.
-     * @returns The string version of the comparators.
+     * Convert object to query string.
+     * @param value The value to convert to a string.
+     * @returns The converted object.
      */
-    static conditionsToString(conditions) {
-        if (Is.arrayValue(conditions)) {
-            const conditionsList = [];
-            for (const conditionPart of conditions) {
-                conditionsList.push(`${conditionPart.property}|${conditionPart.comparison}|${conditionPart.value}`);
-            }
-            return conditionsList.join(",");
-        }
-    }
-    /**
-     * Convert the sort string to a list of sort properties.
-     * @param sortProperties The sort properties query string.
-     * @returns The list of sort properties.
-     */
-    static sortPropertiesFromString(sortProperties) {
-        const sortParts = sortProperties?.split(",") ?? [];
-        const sortPropertyList = [];
-        for (const conditionPart of sortParts) {
-            const parts = conditionPart.split("|");
-            if (parts.length === 2) {
-                sortPropertyList.push({
-                    property: parts[0],
-                    sortDirection: parts[1]
-                });
-            }
-        }
-        return sortPropertyList.length === 0 ? undefined : sortPropertyList;
-    }
-    /**
-     * Convert the sort properties to a string parameter.
-     * @param sortProperties The sort properties to convert.
-     * @returns The string version of the sort properties.
-     */
-    static sortPropertiesToString(sortProperties) {
-        if (Is.arrayValue(sortProperties)) {
-            const sortPropertyList = [];
-            for (const conditionPart of sortProperties) {
-                sortPropertyList.push(`${conditionPart.property}|${conditionPart.sortDirection}`);
-            }
-            return sortPropertyList.join(",");
-        }
+    static objectToString(value) {
+        return Is.empty(value) ? undefined : JSON.stringify(value);
     }
 }
 
@@ -175,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/helpers/httpParameterHelper.d.ts

@@ -1,4 +1,3 @@
-import type { IComparator, SortDirection } from "@twin.org/entity";
 /**
  * Class to help with handling http parameters.
  */
@@ -16,33 +15,15 @@ export declare class HttpParameterHelper {
      */
     static arrayToString<T = string>(values?: T[]): string | undefined;
     /**
-     * Convert the conditions string to a list of comparators.
-     * @param conditions The conditions query string.
-     * @returns The list of comparators.
+     * Convert object string to object.
+     * @param value The value query string.
+     * @returns The object.
      */
-    static conditionsFromString(conditions?: string): IComparator[] | undefined;
+    static objectFromString<T = unknown>(value?: string): T | undefined;
     /**
-     * Convert the conditions to a string parameter.
-     * @param conditions The conditions to convert.
-     * @returns The string version of the comparators.
+     * Convert object to query string.
+     * @param value The value to convert to a string.
+     * @returns The converted object.
      */
-    static conditionsToString(conditions?: IComparator[]): string | undefined;
-    /**
-     * Convert the sort string to a list of sort properties.
-     * @param sortProperties The sort properties query string.
-     * @returns The list of sort properties.
-     */
-    static sortPropertiesFromString<T = unknown>(sortProperties?: string): {
-        property: keyof T;
-        sortDirection: SortDirection;
-    }[] | undefined;
-    /**
-     * Convert the sort properties to a string parameter.
-     * @param sortProperties The sort properties to convert.
-     * @returns The string version of the sort properties.
-     */
-    static sortPropertiesToString<T = unknown>(sortProperties?: {
-        property: keyof T;
-        sortDirection: SortDirection;
-    }[]): string | undefined;
+    static objectToString<T = unknown>(value?: T): string | undefined;
 }

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>;
 }