@twin.org/api-models 0.0.3-next.9 → 0.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (148) hide show
  1. package/README.md +1 -1
  2. package/dist/es/errors/forbiddenError.js +23 -0
  3. package/dist/es/errors/forbiddenError.js.map +1 -0
  4. package/dist/es/errors/tooManyRequestsError.js +25 -0
  5. package/dist/es/errors/tooManyRequestsError.js.map +1 -0
  6. package/dist/es/helpers/httpErrorHelper.js +23 -15
  7. package/dist/es/helpers/httpErrorHelper.js.map +1 -1
  8. package/dist/es/helpers/httpUrlHelper.js +141 -0
  9. package/dist/es/helpers/httpUrlHelper.js.map +1 -0
  10. package/dist/es/index.js +11 -5
  11. package/dist/es/index.js.map +1 -1
  12. package/dist/es/models/api/IServerHealthResponse.js.map +1 -1
  13. package/dist/es/models/api/IServerLivezResponse.js.map +1 -1
  14. package/dist/es/models/api/IServerReadyzResponse.js +2 -0
  15. package/dist/es/models/api/IServerReadyzResponse.js.map +1 -0
  16. package/dist/es/models/config/IBaseRestClientConfig.js.map +1 -1
  17. package/dist/es/models/httpContextIdKeys.js +33 -0
  18. package/dist/es/models/httpContextIdKeys.js.map +1 -0
  19. package/dist/es/models/protocol/IHttpServerRequest.js.map +1 -1
  20. package/dist/es/models/responses/errors/IConflictResponse.js.map +1 -1
  21. package/dist/es/models/responses/errors/INotImplementedResponse.js +2 -0
  22. package/dist/es/models/responses/errors/INotImplementedResponse.js.map +1 -0
  23. package/dist/es/models/responses/errors/ITooManyRequestsResponse.js +2 -0
  24. package/dist/es/models/responses/errors/ITooManyRequestsResponse.js.map +1 -0
  25. package/dist/es/models/routes/IBaseRoute.js.map +1 -1
  26. package/dist/es/models/server/IBaseRouteProcessor.js.map +1 -1
  27. package/dist/es/models/server/IRestRouteProcessor.js.map +1 -1
  28. package/dist/es/models/server/ISocketRouteProcessor.js.map +1 -1
  29. package/dist/es/models/server/IWebServer.js.map +1 -1
  30. package/dist/es/models/server/IWebServerOptions.js.map +1 -1
  31. package/dist/es/models/services/IHealthComponent.js +2 -0
  32. package/dist/es/models/services/IHealthComponent.js.map +1 -0
  33. package/dist/es/models/services/IInformationComponent.js.map +1 -1
  34. package/dist/es/models/services/IPlatformComponent.js +2 -0
  35. package/dist/es/models/services/IPlatformComponent.js.map +1 -0
  36. package/dist/es/models/services/ITenant.js +4 -0
  37. package/dist/es/models/services/ITenant.js.map +1 -0
  38. package/dist/es/models/services/ITenantAdminComponent.js +2 -0
  39. package/dist/es/models/services/ITenantAdminComponent.js.map +1 -0
  40. package/dist/types/errors/forbiddenError.d.ts +20 -0
  41. package/dist/types/errors/tooManyRequestsError.d.ts +22 -0
  42. package/dist/types/helpers/httpErrorHelper.d.ts +6 -0
  43. package/dist/types/helpers/httpUrlHelper.d.ts +70 -0
  44. package/dist/types/index.d.ts +11 -5
  45. package/dist/types/models/api/IServerHealthResponse.d.ts +6 -3
  46. package/dist/types/models/api/IServerLivezResponse.d.ts +1 -1
  47. package/dist/types/models/api/IServerReadyzResponse.d.ts +16 -0
  48. package/dist/types/models/config/IBaseRestClientConfig.d.ts +16 -0
  49. package/dist/types/models/httpContextIdKeys.d.ts +33 -0
  50. package/dist/types/models/protocol/IHttpServerRequest.d.ts +4 -4
  51. package/dist/types/models/responses/errors/IConflictResponse.d.ts +1 -6
  52. package/dist/types/models/responses/errors/INotImplementedResponse.d.ts +15 -0
  53. package/dist/types/models/responses/errors/ITooManyRequestsResponse.d.ts +15 -0
  54. package/dist/types/models/routes/IBaseRoute.d.ts +4 -0
  55. package/dist/types/models/server/IBaseRouteProcessor.d.ts +10 -4
  56. package/dist/types/models/server/IRestRouteProcessor.d.ts +5 -2
  57. package/dist/types/models/server/IWebServer.d.ts +10 -4
  58. package/dist/types/models/server/IWebServerOptions.d.ts +5 -0
  59. package/dist/types/models/services/IHealthComponent.d.ts +14 -0
  60. package/dist/types/models/services/IInformationComponent.d.ts +9 -23
  61. package/dist/types/models/services/IPlatformComponent.d.ts +24 -0
  62. package/dist/types/models/services/ITenant.d.ts +37 -0
  63. package/dist/types/models/services/ITenantAdminComponent.d.ts +70 -0
  64. package/docs/changelog.md +462 -95
  65. package/docs/examples.md +200 -1
  66. package/docs/reference/classes/ForbiddenError.md +55 -0
  67. package/docs/reference/classes/HttpErrorHelper.md +14 -2
  68. package/docs/reference/classes/HttpParameterHelper.md +4 -4
  69. package/docs/reference/classes/HttpUrlHelper.md +259 -0
  70. package/docs/reference/classes/TooManyRequestsError.md +67 -0
  71. package/docs/reference/index.md +12 -6
  72. package/docs/reference/interfaces/IAcceptedResponse.md +2 -2
  73. package/docs/reference/interfaces/IBadRequestResponse.md +2 -2
  74. package/docs/reference/interfaces/IBaseRestClientConfig.md +57 -9
  75. package/docs/reference/interfaces/IBaseRoute.md +18 -10
  76. package/docs/reference/interfaces/IBaseRouteEntryPoint.md +4 -4
  77. package/docs/reference/interfaces/IBaseRouteProcessor.md +21 -13
  78. package/docs/reference/interfaces/IBaseSocketClientConfig.md +7 -7
  79. package/docs/reference/interfaces/IConflictResponse.md +3 -11
  80. package/docs/reference/interfaces/ICreatedResponse.md +2 -2
  81. package/docs/reference/interfaces/IForbiddenResponse.md +2 -2
  82. package/docs/reference/interfaces/IHealthComponent.md +21 -0
  83. package/docs/reference/interfaces/IHttpRequest.md +8 -8
  84. package/docs/reference/interfaces/IHttpRequestContext.md +4 -4
  85. package/docs/reference/interfaces/IHttpRequestPathParams.md +1 -1
  86. package/docs/reference/interfaces/IHttpRequestQuery.md +1 -1
  87. package/docs/reference/interfaces/IHttpResponse.md +6 -6
  88. package/docs/reference/interfaces/IHttpServerRequest.md +14 -14
  89. package/docs/reference/interfaces/IInformationComponent.md +13 -81
  90. package/docs/reference/interfaces/IInternalServerErrorResponse.md +2 -2
  91. package/docs/reference/interfaces/IMimeTypeProcessor.md +2 -2
  92. package/docs/reference/interfaces/INoContentRequest.md +8 -8
  93. package/docs/reference/interfaces/INoContentResponse.md +1 -1
  94. package/docs/reference/interfaces/INotFoundResponse.md +3 -3
  95. package/docs/reference/interfaces/INotImplementedResponse.md +19 -0
  96. package/docs/reference/interfaces/IOkResponse.md +1 -1
  97. package/docs/reference/interfaces/IPlatformComponent.md +65 -0
  98. package/docs/reference/interfaces/IRestRoute.md +36 -24
  99. package/docs/reference/interfaces/IRestRouteExample.md +3 -3
  100. package/docs/reference/interfaces/IRestRouteProcessor.md +31 -19
  101. package/docs/reference/interfaces/IRestRouteRequestExample.md +4 -4
  102. package/docs/reference/interfaces/IRestRouteResponseAttachmentOptions.md +6 -6
  103. package/docs/reference/interfaces/IRestRouteResponseExample.md +4 -4
  104. package/docs/reference/interfaces/IRestRouteResponseOptions.md +2 -2
  105. package/docs/reference/interfaces/IServerFavIconResponse.md +7 -7
  106. package/docs/reference/interfaces/IServerHealthResponse.md +11 -3
  107. package/docs/reference/interfaces/IServerInfo.md +2 -2
  108. package/docs/reference/interfaces/IServerInfoResponse.md +1 -1
  109. package/docs/reference/interfaces/IServerLivezResponse.md +3 -3
  110. package/docs/reference/interfaces/IServerReadyzResponse.md +23 -0
  111. package/docs/reference/interfaces/IServerRootResponse.md +2 -2
  112. package/docs/reference/interfaces/IServerSpecResponse.md +4 -4
  113. package/docs/reference/interfaces/ISocketRequestContext.md +5 -5
  114. package/docs/reference/interfaces/ISocketRoute.md +27 -15
  115. package/docs/reference/interfaces/ISocketRouteProcessor.md +30 -22
  116. package/docs/reference/interfaces/ISocketServerRequest.md +17 -17
  117. package/docs/reference/interfaces/ITag.md +2 -2
  118. package/docs/reference/interfaces/ITenant.md +67 -0
  119. package/docs/reference/interfaces/ITenantAdminComponent.md +227 -0
  120. package/docs/reference/interfaces/ITooManyRequestsResponse.md +19 -0
  121. package/docs/reference/interfaces/IUnauthorizedResponse.md +2 -2
  122. package/docs/reference/interfaces/IUnprocessableEntityResponse.md +2 -2
  123. package/docs/reference/interfaces/IWebServer.md +37 -7
  124. package/docs/reference/interfaces/IWebServerOptions.md +21 -12
  125. package/docs/reference/type-aliases/HttpContextIdKeys.md +5 -0
  126. package/docs/reference/variables/HttpContextIdKeys.md +43 -0
  127. package/package.json +9 -8
  128. package/dist/es/factories/authenticationGeneratorFactory.js +0 -9
  129. package/dist/es/factories/authenticationGeneratorFactory.js.map +0 -1
  130. package/dist/es/models/client/IAuthenticationGenerator.js +0 -2
  131. package/dist/es/models/client/IAuthenticationGenerator.js.map +0 -1
  132. package/dist/es/models/services/IHealthComponentInfo.js +0 -2
  133. package/dist/es/models/services/IHealthComponentInfo.js.map +0 -1
  134. package/dist/es/models/services/IHealthInfo.js +0 -2
  135. package/dist/es/models/services/IHealthInfo.js.map +0 -1
  136. package/dist/es/models/services/healthStatus.js +0 -21
  137. package/dist/es/models/services/healthStatus.js.map +0 -1
  138. package/dist/types/factories/authenticationGeneratorFactory.d.ts +0 -6
  139. package/dist/types/models/client/IAuthenticationGenerator.d.ts +0 -14
  140. package/dist/types/models/services/IHealthComponentInfo.d.ts +0 -18
  141. package/dist/types/models/services/IHealthInfo.d.ts +0 -15
  142. package/dist/types/models/services/healthStatus.d.ts +0 -21
  143. package/docs/reference/interfaces/IAuthenticationGenerator.md +0 -35
  144. package/docs/reference/interfaces/IHealthComponentInfo.md +0 -27
  145. package/docs/reference/interfaces/IHealthInfo.md +0 -19
  146. package/docs/reference/type-aliases/HealthStatus.md +0 -5
  147. package/docs/reference/variables/AuthenticationGeneratorFactory.md +0 -5
  148. package/docs/reference/variables/HealthStatus.md +0 -25
@@ -1,14 +0,0 @@
1
- import type { IComponent } from "@twin.org/core";
2
- import type { IHttpHeaders } from "@twin.org/web";
3
- /**
4
- * Definition for the authentication generator component.
5
- */
6
- export interface IAuthenticationGenerator extends IComponent {
7
- /**
8
- * Adds authentication information to the request headers.
9
- * @param requestHeaders The request headers to add authentication information to.
10
- * @param authData Optional authentication data passed from the request.
11
- * @returns A promise that resolves when the authentication information has been added.
12
- */
13
- addAuthentication(requestHeaders: IHttpHeaders, authData?: unknown): Promise<void>;
14
- }
@@ -1,18 +0,0 @@
1
- import type { HealthStatus } from "./healthStatus.js";
2
- /**
3
- * The health component information.
4
- */
5
- export interface IHealthComponentInfo {
6
- /**
7
- * The name of the component.
8
- */
9
- name: string;
10
- /**
11
- * The status of the component.
12
- */
13
- status: HealthStatus;
14
- /**
15
- * The details for the status.
16
- */
17
- details?: string;
18
- }
@@ -1,15 +0,0 @@
1
- import type { HealthStatus } from "./healthStatus.js";
2
- import type { IHealthComponentInfo } from "./IHealthComponentInfo.js";
3
- /**
4
- * The status of the server.
5
- */
6
- export interface IHealthInfo {
7
- /**
8
- * The status.
9
- */
10
- status: HealthStatus;
11
- /**
12
- * The status of the components.
13
- */
14
- components?: IHealthComponentInfo[];
15
- }
@@ -1,21 +0,0 @@
1
- /**
2
- * The health status of the component.
3
- */
4
- export declare const HealthStatus: {
5
- /**
6
- * OK.
7
- */
8
- readonly Ok: "ok";
9
- /**
10
- * Warning.
11
- */
12
- readonly Warning: "warning";
13
- /**
14
- * Error.
15
- */
16
- readonly Error: "error";
17
- };
18
- /**
19
- * The health status of the component.
20
- */
21
- export type HealthStatus = (typeof HealthStatus)[keyof typeof HealthStatus];
@@ -1,35 +0,0 @@
1
- # Interface: IAuthenticationGenerator
2
-
3
- Definition for the authentication generator component.
4
-
5
- ## Extends
6
-
7
- - `IComponent`
8
-
9
- ## Methods
10
-
11
- ### addAuthentication()
12
-
13
- > **addAuthentication**(`requestHeaders`, `authData?`): `Promise`\<`void`\>
14
-
15
- Adds authentication information to the request headers.
16
-
17
- #### Parameters
18
-
19
- ##### requestHeaders
20
-
21
- `IHttpHeaders`
22
-
23
- The request headers to add authentication information to.
24
-
25
- ##### authData?
26
-
27
- `unknown`
28
-
29
- Optional authentication data passed from the request.
30
-
31
- #### Returns
32
-
33
- `Promise`\<`void`\>
34
-
35
- A promise that resolves when the authentication information has been added.
@@ -1,27 +0,0 @@
1
- # Interface: IHealthComponentInfo
2
-
3
- The health component information.
4
-
5
- ## Properties
6
-
7
- ### name
8
-
9
- > **name**: `string`
10
-
11
- The name of the component.
12
-
13
- ***
14
-
15
- ### status
16
-
17
- > **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
18
-
19
- The status of the component.
20
-
21
- ***
22
-
23
- ### details?
24
-
25
- > `optional` **details**: `string`
26
-
27
- The details for the status.
@@ -1,19 +0,0 @@
1
- # Interface: IHealthInfo
2
-
3
- The status of the server.
4
-
5
- ## Properties
6
-
7
- ### status
8
-
9
- > **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
10
-
11
- The status.
12
-
13
- ***
14
-
15
- ### components?
16
-
17
- > `optional` **components**: [`IHealthComponentInfo`](IHealthComponentInfo.md)[]
18
-
19
- The status of the components.
@@ -1,5 +0,0 @@
1
- # Type Alias: HealthStatus
2
-
3
- > **HealthStatus** = *typeof* [`HealthStatus`](../variables/HealthStatus.md)\[keyof *typeof* [`HealthStatus`](../variables/HealthStatus.md)\]
4
-
5
- The health status of the component.
@@ -1,5 +0,0 @@
1
- # Variable: AuthenticationGeneratorFactory
2
-
3
- > `const` **AuthenticationGeneratorFactory**: `Factory`\<[`IAuthenticationGenerator`](../interfaces/IAuthenticationGenerator.md)\>
4
-
5
- Factory for creating implementation of authentication generator types.
@@ -1,25 +0,0 @@
1
- # Variable: HealthStatus
2
-
3
- > `const` **HealthStatus**: `object`
4
-
5
- The health status of the component.
6
-
7
- ## Type Declaration
8
-
9
- ### Ok
10
-
11
- > `readonly` **Ok**: `"ok"` = `"ok"`
12
-
13
- OK.
14
-
15
- ### Warning
16
-
17
- > `readonly` **Warning**: `"warning"` = `"warning"`
18
-
19
- Warning.
20
-
21
- ### Error
22
-
23
- > `readonly` **Error**: `"error"` = `"error"`
24
-
25
- Error.