@3sixty/api-models 0.0.0-stage → 0.20.0-next.1

package/docs/reference/interfaces/IRestRouteExample.md

@@ -0,0 +1,24 @@
+# Interface: IRestRouteExample
+
+Interface which defines a REST route example.
+
+## Extended by
+
+- [`IRestRouteRequestExample`](IRestRouteRequestExample.md)
+- [`IRestRouteResponseExample`](IRestRouteResponseExample.md)
+
+## Properties
+
+### id {#id}
+
+> **id**: `string`
+
+Example objects for the request.
+
+***
+
+### description? {#description}
+
+> `optional` **description?**: `string`
+
+Description of the example.

package/docs/reference/interfaces/IRestRouteProcessor.md

@@ -0,0 +1,177 @@
+# Interface: IRestRouteProcessor
+
+The definition for a processor for handling REST routes.
+
+## Extends
+
+- [`IBaseRouteProcessor`](IBaseRouteProcessor.md)\<[`IRestRoute`](IRestRoute.md)\>
+
+## Methods
+
+### pre()? {#pre}
+
+> `optional` **pre**(`request`, `response`, `route`, `contextIds`, `processorState`, `componentTypes?`): `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
+
+[`IRestRoute`](IRestRoute.md)\<`any`, `any`\> \| `undefined`
+
+The route being requested, if a matching one was found.
+
+##### contextIds
+
+`IContextIds`
+
+The context IDs of the request.
+
+##### processorState
+
+\{\[`id`: `string`\]: `unknown`; \}
+
+The state handed through the processors.
+
+##### componentTypes?
+
+The component types for the request.
+
+###### loggingComponentType?
+
+`string`
+
+The logging component type.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the request is processed.
+
+#### Inherited from
+
+[`IBaseRouteProcessor`](IBaseRouteProcessor.md).[`pre`](IBaseRouteProcessor.md#pre)
+
+***
+
+### post()? {#post}
+
+> `optional` **post**(`request`, `response`, `route`, `contextIds`, `processorState`, `componentTypes?`): `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
+
+[`IRestRoute`](IRestRoute.md)\<`any`, `any`\> \| `undefined`
+
+The route being requested, if a matching one was found.
+
+##### contextIds
+
+`IContextIds`
+
+The context IDs of the request.
+
+##### processorState
+
+\{\[`id`: `string`\]: `unknown`; \}
+
+The state handed through the processors.
+
+##### componentTypes?
+
+The component types for the request.
+
+###### loggingComponentType?
+
+`string`
+
+The logging component type.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the request is processed.
+
+#### Inherited from
+
+[`IBaseRouteProcessor`](IBaseRouteProcessor.md).[`post`](IBaseRouteProcessor.md#post)
+
+***
+
+### process()? {#process}
+
+> `optional` **process**(`request`, `response`, `route`, `processorState`, `componentTypes?`): `Promise`\<`void`\>
+
+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
+
+[`IRestRoute`](IRestRoute.md)\<`any`, `any`\> \| `undefined`
+
+The route being requested, if a matching one was found.
+
+##### processorState
+
+\{\[`id`: `string`\]: `unknown`; \}
+
+The state handed through the processors.
+
+##### componentTypes?
+
+The component types for the request.
+
+###### loggingComponentType?
+
+`string`
+
+The logging component type.
+
+#### Returns
+
+`Promise`\<`void`\>
+
+Promise that resolves when the request is processed.

package/docs/reference/interfaces/IRestRouteRequestExample.md

@@ -0,0 +1,45 @@
+# Interface: IRestRouteRequestExample\<T\>
+
+Interface which defines a REST route request example.
+
+## Extends
+
+- [`IRestRouteExample`](IRestRouteExample.md)
+
+## Type Parameters
+
+### T {#t}
+
+`T`
+
+## Properties
+
+### id {#id}
+
+> **id**: `string`
+
+Example objects for the request.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`id`](IRestRouteExample.md#id)
+
+***
+
+### description? {#description}
+
+> `optional` **description?**: `string`
+
+Description of the example.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`description`](IRestRouteExample.md#description)
+
+***
+
+### request {#request}
+
+> **request**: `T`
+
+The example request object.

package/docs/reference/interfaces/IRestRouteResponseAttachmentOptions.md

@@ -0,0 +1,27 @@
+# Interface: IRestRouteResponseAttachmentOptions
+
+Interface which defines a REST route response for attachments.
+
+## Properties
+
+### mimeType? {#mimetype}
+
+> `optional` **mimeType?**: `string`
+
+The content type to use in the response.
+
+***
+
+### filename? {#filename}
+
+> `optional` **filename?**: `string`
+
+The filename to use in content disposition.
+
+***
+
+### inline? {#inline}
+
+> `optional` **inline?**: `boolean`
+
+Whether to inline the content.

package/docs/reference/interfaces/IRestRouteResponseExample.md

@@ -0,0 +1,45 @@
+# Interface: IRestRouteResponseExample\<T\>
+
+Interface which defines a REST route response example.
+
+## Extends
+
+- [`IRestRouteExample`](IRestRouteExample.md)
+
+## Type Parameters
+
+### T {#t}
+
+`T`
+
+## Properties
+
+### id {#id}
+
+> **id**: `string`
+
+Example objects for the request.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`id`](IRestRouteExample.md#id)
+
+***
+
+### description? {#description}
+
+> `optional` **description?**: `string`
+
+Description of the example.
+
+#### Inherited from
+
+[`IRestRouteExample`](IRestRouteExample.md).[`description`](IRestRouteExample.md#description)
+
+***
+
+### response {#response}
+
+> **response**: `T`
+
+The example response object.

package/docs/reference/interfaces/IRestRouteResponseOptions.md

@@ -0,0 +1,11 @@
+# Interface: IRestRouteResponseOptions
+
+Interface which defines a REST route response.
+
+## Properties
+
+### attachment? {#attachment}
+
+> `optional` **attachment?**: [`IRestRouteResponseAttachmentOptions`](IRestRouteResponseAttachmentOptions.md)
+
+Additional options that can be used to control the response.

package/docs/reference/interfaces/IRouteAuthorization.md

@@ -0,0 +1,27 @@
+# Interface: IRouteAuthorization
+
+Interface which defines the default authorization permission for a route used to seed the RBAC rules.
+
+## Properties
+
+### permission {#permission}
+
+> **permission**: `string`
+
+The permission string for the route.
+
+***
+
+### role? {#role}
+
+> `optional` **role?**: `string`
+
+The optional role string for the route.
+
+***
+
+### inherits? {#inherits}
+
+> `optional` **inherits?**: `string`[]
+
+The optional array of inherited permissions for the route.

package/docs/reference/interfaces/IServerFavIconResponse.md

@@ -0,0 +1,33 @@
+# Interface: IServerFavIconResponse
+
+The favicon for the server.
+
+## Properties
+
+### headers? {#headers}
+
+> `optional` **headers?**: `object`
+
+Additional response headers.
+
+#### content-type?
+
+> `optional` **content-type?**: `string`
+
+The content type for the response.
+
+***
+
+### statusCode? {#statuscode}
+
+> `optional` **statusCode?**: `HttpStatusCode`
+
+Response status code.
+
+***
+
+### body? {#body}
+
+> `optional` **body?**: `Uint8Array`\<`ArrayBufferLike`\>
+
+The favicon for the server.

package/docs/reference/interfaces/IServerHealthResponse.md

@@ -0,0 +1,19 @@
+# Interface: IServerHealthResponse
+
+The health of the server.
+
+## Properties
+
+### body {#body}
+
+> **body**: `object`
+
+The health for the server.
+
+#### status
+
+> **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
+
+#### components
+
+> **components**: [`IHealth`](IHealth.md)[]

package/docs/reference/interfaces/IServerInfo.md

@@ -0,0 +1,19 @@
+# Interface: IServerInfo
+
+The information about the server.
+
+## Properties
+
+### name {#name}
+
+> **name**: `string`
+
+The application name.
+
+***
+
+### version {#version}
+
+> **version**: `string`
+
+The version of the server.

package/docs/reference/interfaces/IServerInfoResponse.md

@@ -0,0 +1,11 @@
+# Interface: IServerInfoResponse
+
+The information about the server.
+
+## Properties
+
+### body {#body}
+
+> **body**: [`IServerInfo`](IServerInfo.md)
+
+The information for the server.

package/docs/reference/interfaces/IServerLivezResponse.md

@@ -0,0 +1,23 @@
+# Interface: IServerLivezResponse
+
+The livez of the server.
+
+## Properties
+
+### headers {#headers}
+
+> **headers**: `object`
+
+The headers for the response.
+
+#### content-type
+
+> **content-type**: `"text/plain"`
+
+***
+
+### body {#body}
+
+> **body**: `"alive"` \| `"dead"`
+
+The livez information for the server.

package/docs/reference/interfaces/IServerReadyzResponse.md

@@ -0,0 +1,23 @@
+# Interface: IServerReadyzResponse
+
+The readyz of the server.
+
+## Properties
+
+### headers {#headers}
+
+> **headers**: `object`
+
+The headers for the response.
+
+#### content-type
+
+> **content-type**: `"text/plain"`
+
+***
+
+### body {#body}
+
+> **body**: `"ready"` \| `"not ready"`
+
+The readyz information for the server.

package/docs/reference/interfaces/IServerRootResponse.md

@@ -0,0 +1,23 @@
+# Interface: IServerRootResponse
+
+The root text for the server.
+
+## Properties
+
+### headers {#headers}
+
+> **headers**: `object`
+
+The headers for the response.
+
+#### content-type
+
+> **content-type**: `"text/plain"`
+
+***
+
+### body {#body}
+
+> **body**: `string`
+
+The root text for the server.

package/docs/reference/interfaces/IServerSpecResponse.md

@@ -0,0 +1,19 @@
+# Interface: IServerSpecResponse
+
+The OpenAPI spec for the endpoints.
+
+## Properties
+
+### statusCode? {#statuscode}
+
+> `optional` **statusCode?**: `HttpStatusCode`
+
+Response status code.
+
+***
+
+### body? {#body}
+
+> `optional` **body?**: `unknown`
+
+The spec for the server.

package/docs/reference/interfaces/ISocketRequestContext.md

@@ -0,0 +1,55 @@
+# Interface: ISocketRequestContext
+
+Context data from the socket request.
+
+## Extends
+
+- [`IHttpRequestContext`](IHttpRequestContext.md)
+
+## Properties
+
+### serverRequest {#serverrequest}
+
+> **serverRequest**: [`IHttpServerRequest`](IHttpServerRequest.md)
+
+The raw HTTP request.
+
+#### Inherited from
+
+[`IHttpRequestContext`](IHttpRequestContext.md).[`serverRequest`](IHttpRequestContext.md#serverrequest)
+
+***
+
+### processorState {#processorstate}
+
+> **processorState**: `object`
+
+The state handed through the processors.
+
+#### Index Signature
+
+\[`id`: `string`\]: `unknown`
+
+#### Inherited from
+
+[`IHttpRequestContext`](IHttpRequestContext.md).[`processorState`](IHttpRequestContext.md#processorstate)
+
+***
+
+### loggingComponentType? {#loggingcomponenttype}
+
+> `optional` **loggingComponentType?**: `string`
+
+Logging component type for the request.
+
+#### Inherited from
+
+[`IHttpRequestContext`](IHttpRequestContext.md).[`loggingComponentType`](IHttpRequestContext.md#loggingcomponenttype)
+
+***
+
+### socketId {#socketid}
+
+> **socketId**: `string`
+
+The id of the socket.