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

package/docs/reference/classes/HttpParameterHelper.md

@@ -4,29 +4,33 @@ Class to help with handling http parameters.
 
 ## Constructors
 
-### new HttpParameterHelper()
+### Constructor
 
-> **new HttpParameterHelper**(): [`HttpParameterHelper`](HttpParameterHelper.md)
+> **new HttpParameterHelper**(): `HttpParameterHelper`
 
 #### Returns
 
-[`HttpParameterHelper`](HttpParameterHelper.md)
+`HttpParameterHelper`
 
 ## Methods
 
 ### arrayFromString()
 
-> `static` **arrayFromString**\<`T`\>(`values`?): `undefined` \| `T`[]
+> `static` **arrayFromString**\<`T`\>(`values?`): `undefined` \| `T`[]
 
 Convert list query to array.
 
 #### Type Parameters
 
-• **T** = `string`
+##### T
+
+`T` = `string`
 
 #### Parameters
 
-• **values?**: `string`
+##### values?
+
+`string`
 
 The values query string.
 
@@ -40,17 +44,21 @@ The array of values.
 
 ### arrayToString()
 
-> `static` **arrayToString**\<`T`\>(`values`?): `undefined` \| `string`
+> `static` **arrayToString**\<`T`\>(`values?`): `undefined` \| `string`
 
 Convert array of values to query string.
 
 #### Type Parameters
 
-• **T** = `string`
+##### T
+
+`T` = `string`
 
 #### Parameters
 
-• **values?**: `T`[]
+##### values?
+
+`T`[]
 
 The values to combine string.
 
@@ -64,17 +72,21 @@ The combined.
 
 ### objectFromString()
 
-> `static` **objectFromString**\<`T`\>(`value`?): `undefined` \| `T`
+> `static` **objectFromString**\<`T`\>(`value?`): `undefined` \| `T`
 
 Convert object string to object.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
 #### Parameters
 
-• **value?**: `string`
+##### value?
+
+`string`
 
 The value query string.
 
@@ -88,17 +100,21 @@ The object.
 
 ### objectToString()
 
-> `static` **objectToString**\<`T`\>(`value`?): `undefined` \| `string`
+> `static` **objectToString**\<`T`\>(`value?`): `undefined` \| `string`
 
 Convert object to query string.
 
 #### Type Parameters
 
-• **T** = `unknown`
+##### T
+
+`T` = `unknown`
 
 #### Parameters
 
-• **value?**: `T`
+##### value?
+
+`T`
 
 The value to convert to a string.
 

package/docs/reference/index.md

@@ -32,8 +32,8 @@
 - [INoContentResponse](interfaces/INoContentResponse.md)
 - [IOkResponse](interfaces/IOkResponse.md)
 - [IBaseRoute](interfaces/IBaseRoute.md)
+- [IBaseRouteEntryPoint](interfaces/IBaseRouteEntryPoint.md)
 - [IRestRoute](interfaces/IRestRoute.md)
-- [IRestRouteEntryPoint](interfaces/IRestRouteEntryPoint.md)
 - [IRestRouteExample](interfaces/IRestRouteExample.md)
 - [IRestRouteRequestExample](interfaces/IRestRouteRequestExample.md)
 - [IRestRouteResponseAttachmentOptions](interfaces/IRestRouteResponseAttachmentOptions.md)
@@ -41,7 +41,10 @@
 - [IRestRouteResponseOptions](interfaces/IRestRouteResponseOptions.md)
 - [ISocketRoute](interfaces/ISocketRoute.md)
 - [ITag](interfaces/ITag.md)
-- [IHttpRestRouteProcessor](interfaces/IHttpRestRouteProcessor.md)
+- [IBaseRouteProcessor](interfaces/IBaseRouteProcessor.md)
+- [IMimeTypeProcessor](interfaces/IMimeTypeProcessor.md)
+- [IRestRouteProcessor](interfaces/IRestRouteProcessor.md)
+- [ISocketRouteProcessor](interfaces/ISocketRouteProcessor.md)
 - [IWebServer](interfaces/IWebServer.md)
 - [IWebServerOptions](interfaces/IWebServerOptions.md)
 - [IHealthInfo](interfaces/IHealthInfo.md)
@@ -50,8 +53,13 @@
 
 ## Type Aliases
 
+- [IRestRouteEntryPoint](type-aliases/IRestRouteEntryPoint.md)
+- [ISocketRouteEntryPoint](type-aliases/ISocketRouteEntryPoint.md)
 - [HealthStatus](type-aliases/HealthStatus.md)
 
 ## Variables
 
+- [MimeTypeProcessorFactory](variables/MimeTypeProcessorFactory.md)
+- [RestRouteProcessorFactory](variables/RestRouteProcessorFactory.md)
+- [SocketRouteProcessorFactory](variables/SocketRouteProcessorFactory.md)
 - [HealthStatus](variables/HealthStatus.md)

package/docs/reference/interfaces/IBaseRouteEntryPoint.md

@@ -0,0 +1,55 @@
+# Interface: IBaseRouteEntryPoint\<T\>
+
+Route entry points are used for exposing the routes from a package.
+
+## Type Parameters
+
+### T
+
+`T`
+
+## Properties
+
+### name
+
+> **name**: `string`
+
+The name of the routes.
+
+***
+
+### defaultBaseRoute
+
+> **defaultBaseRoute**: `string`
+
+The default base route name for the routes.
+
+***
+
+### tags
+
+> **tags**: [`ITag`](ITag.md)[]
+
+The tags for the routes.
+
+***
+
+### generateRoutes()
+
+> **generateRoutes**: (`baseRouteName`, `componentName`) => `T`[]
+
+The method to generate the routes.
+
+#### Parameters
+
+##### baseRouteName
+
+`string`
+
+##### componentName
+
+`string`
+
+#### Returns
+
+`T`[]

package/docs/reference/interfaces/IBaseRouteProcessor.md

@@ -0,0 +1,106 @@
+# Interface: IBaseRouteProcessor\<T\>
+
+The definition for a base processor for handling REST routes.
+
+## Extends
+
+- `IComponent`
+
+## Extended by
+
+- [`IRestRouteProcessor`](IRestRouteProcessor.md)
+- [`ISocketRouteProcessor`](ISocketRouteProcessor.md)
+
+## Type Parameters
+
+### T
+
+`T` = [`IBaseRoute`](IBaseRoute.md)
+
+## Methods
+
+### pre()?
+
+> `optional` **pre**(`request`, `response`, `route`, `requestIdentity`, `processorState`): `Promise`\<`void`\>
+
+Pre process the REST request for the specified route.
+
+#### Parameters
+
+##### request
+
+[`IHttpServerRequest`](IHttpServerRequest.md)
+
+The request to handle.
+
+##### response
+
+[`IHttpResponse`](IHttpResponse.md)
+
+The response data to send if any.
+
+##### route
+
+The route being requested, if a matching one was found.
+
+`undefined` | `T`
+
+##### requestIdentity
+
+[`IHttpRequestIdentity`](IHttpRequestIdentity.md)
+
+The identity context for the request.
+
+##### processorState
+
+The state handed through the processors.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the request is processed.
+
+***
+
+### post()?
+
+> `optional` **post**(`request`, `response`, `route`, `requestIdentity`, `processorState`): `Promise`\<`void`\>
+
+Post process the REST request for the specified route.
+
+#### Parameters
+
+##### request
+
+[`IHttpServerRequest`](IHttpServerRequest.md)
+
+The request to handle.
+
+##### response
+
+[`IHttpResponse`](IHttpResponse.md)
+
+The response data to send if any.
+
+##### route
+
+The route being requested, if a matching one was found.
+
+`undefined` | `T`
+
+##### requestIdentity
+
+[`IHttpRequestIdentity`](IHttpRequestIdentity.md)
+
+The identity context for the request.
+
+##### processorState
+
+The state handed through the processors.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the request is processed.

package/docs/reference/interfaces/IBaseSocketClientConfig.md

@@ -4,6 +4,14 @@ Definition for the configuration of a socket service.
 
 ## Properties
 
+### basePath?
+
+> `optional` **basePath**: `string`
+
+Base path for the socket service, defaults to /socket.
+
+***
+
 ### endpoint
 
 > **endpoint**: `string`

package/docs/reference/interfaces/IHealthInfo.md

@@ -17,3 +17,21 @@ The status.
 > `optional` **components**: `object`[]
 
 The status of the components.
+
+#### name
+
+> **name**: `string`
+
+The name of the component.
+
+#### status
+
+> **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
+
+The status of the component.
+
+#### details?
+
+> `optional` **details**: `string`
+
+The details for the status.

package/docs/reference/interfaces/IHttpRequest.md

@@ -9,7 +9,9 @@ Model for the standard parameters for an http request.
 
 ## Type Parameters
 
-• **T** = `any`
+### T
+
+`T` = `any`
 
 ## Properties
 

package/docs/reference/interfaces/IHttpRequestContext.md

@@ -10,7 +10,7 @@ Context data from the HTTP request.
 
 ### serverRequest
 
-> **serverRequest**: [`IHttpServerRequest`](IHttpServerRequest.md)\<`any`\>
+> **serverRequest**: [`IHttpServerRequest`](IHttpServerRequest.md)
 
 The raw HTTP request.
 
@@ -24,7 +24,7 @@ The state handed through the processors.
 
 #### Index Signature
 
- \[`id`: `string`\]: `unknown`
+\[`id`: `string`\]: `unknown`
 
 ***
 

package/docs/reference/interfaces/IHttpRequestPathParams.md

@@ -4,4 +4,4 @@ Model for the standard parameters for an http request.
 
 ## Indexable
 
- \[`id`: `string`\]: `string` \| `number` \| `boolean`
+\[`id`: `string`\]: `string` \| `number` \| `boolean`

package/docs/reference/interfaces/IHttpRequestQuery.md

@@ -4,4 +4,4 @@ Model used for Http request query parameters.
 
 ## Indexable
 
- \[`id`: `string`\]: `string` \| `number` \| `boolean`
+\[`id`: `string`\]: `string` \| `number` \| `boolean`

package/docs/reference/interfaces/IHttpResponse.md

@@ -4,7 +4,9 @@ Model for the standard parameters for an http response.
 
 ## Type Parameters
 
-• **T** = `any`
+### T
+
+`T` = `any`
 
 ## Properties
 

package/docs/reference/interfaces/IHttpServerRequest.md

@@ -8,7 +8,9 @@ Model for the standard parameters for an http request.
 
 ## Type Parameters
 
-• **T** = `any`
+### T
+
+`T` = `any`
 
 ## Properties
 

package/docs/reference/interfaces/IInformationComponent.md

@@ -52,21 +52,27 @@ The service health.
 
 ### setComponentHealth()
 
-> **setComponentHealth**(`name`, `status`, `details`?): `Promise`\<`void`\>
+> **setComponentHealth**(`name`, `status`, `details?`): `Promise`\<`void`\>
 
 Set the status of a component.
 
 #### Parameters
 
-• **name**: `string`
+##### name
+
+`string`
 
 The component name.
 
-• **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
+##### status
+
+[`HealthStatus`](../type-aliases/HealthStatus.md)
 
 The status of the component.
 
-• **details?**: `string`
+##### details?
+
+`string`
 
 The details for the status.
 
@@ -86,7 +92,9 @@ Remove the status of a component.
 
 #### Parameters
 
-• **name**: `string`
+##### name
+
+`string`
 
 The component name.
 

package/docs/reference/interfaces/IMimeTypeProcessor.md

@@ -0,0 +1,43 @@
+# Interface: IMimeTypeProcessor
+
+The definition for a handler for a specific MIME type.
+
+## Extends
+
+- `IComponent`
+
+## Methods
+
+### getTypes()
+
+> **getTypes**(): `string`[]
+
+Get the MIME types that this handler can handle.
+
+#### Returns
+
+`string`[]
+
+The MIME types that this handler can handle.
+
+***
+
+### handle()
+
+> **handle**(`body`): `Promise`\<`unknown`\>
+
+Handle content.
+
+#### Parameters
+
+##### body
+
+`Uint8Array`
+
+The body to process.
+
+#### Returns
+
+`Promise`\<`unknown`\>
+
+The processed body.

package/docs/reference/interfaces/IRestRoute.md

@@ -8,9 +8,13 @@ Interface which defines a REST route.
 
 ## Type Parameters
 
-• **T** *extends* [`IHttpRequest`](IHttpRequest.md) = `any`
+### T
 
-• **U** *extends* [`IHttpResponse`](IHttpResponse.md) & [`IRestRouteResponseOptions`](IRestRouteResponseOptions.md) = `any`
+`T` *extends* [`IHttpRequest`](IHttpRequest.md) = `any`
+
+### U
+
+`U` *extends* [`IHttpResponse`](IHttpResponse.md) & [`IRestRouteResponseOptions`](IRestRouteResponseOptions.md) = `any`
 
 ## Properties
 
@@ -82,11 +86,15 @@ The handler module.
 
 #### Parameters
 
-• **httpRequestContext**: [`IHttpRequestContext`](IHttpRequestContext.md)
+##### httpRequestContext
+
+[`IHttpRequestContext`](IHttpRequestContext.md)
 
 The http request context.
 
-• **request**: `T`
+##### request
+
+`T`
 
 The request object, combined query param, path params and body.
 
@@ -128,6 +136,24 @@ Example objects for the request.
 
 The type of the response object.
 
+#### type
+
+> **type**: `string`
+
+The object type of the response.
+
+#### mimeType?
+
+> `optional` **mimeType**: `string`
+
+The mime type of the response, defaults to "application/json" if there is a body.
+
+#### examples?
+
+> `optional` **examples**: [`IRestRouteResponseExample`](IRestRouteResponseExample.md)\<`U`\>[]
+
+Example objects of the response.
+
 ***
 
 ### excludeFromSpec?