@twin.org/api-models 0.0.3-next.3 → 0.0.3-next.30

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 (156) 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 +34 -20
  7. package/dist/es/helpers/httpErrorHelper.js.map +1 -1
  8. package/dist/es/helpers/httpUrlHelper.js +105 -0
  9. package/dist/es/helpers/httpUrlHelper.js.map +1 -0
  10. package/dist/es/index.js +13 -4
  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 +2 -0
  14. package/dist/es/models/api/IServerLivezResponse.js.map +1 -0
  15. package/dist/es/models/api/IServerReadyzResponse.js +2 -0
  16. package/dist/es/models/api/IServerReadyzResponse.js.map +1 -0
  17. package/dist/es/models/api/IServerRootResponse.js +0 -2
  18. package/dist/es/models/api/IServerRootResponse.js.map +1 -1
  19. package/dist/es/models/config/IBaseRestClientConfig.js.map +1 -1
  20. package/dist/es/models/httpContextIdKeys.js +21 -0
  21. package/dist/es/models/httpContextIdKeys.js.map +1 -0
  22. package/dist/es/models/protocol/IHttpRequestContext.js.map +1 -1
  23. package/dist/es/models/protocol/IHttpRequestPathParams.js.map +1 -1
  24. package/dist/es/models/protocol/IHttpRequestQuery.js.map +1 -1
  25. package/dist/es/models/protocol/IHttpServerRequest.js.map +1 -1
  26. package/dist/es/models/responses/errors/IConflictResponse.js.map +1 -1
  27. package/dist/es/models/responses/errors/INotImplementedResponse.js +2 -0
  28. package/dist/es/models/responses/errors/INotImplementedResponse.js.map +1 -0
  29. package/dist/es/models/responses/errors/ITooManyRequestsResponse.js +2 -0
  30. package/dist/es/models/responses/errors/ITooManyRequestsResponse.js.map +1 -0
  31. package/dist/es/models/routes/IBaseRoute.js.map +1 -1
  32. package/dist/es/models/server/IBaseRouteProcessor.js.map +1 -1
  33. package/dist/es/models/server/IRestRouteProcessor.js.map +1 -1
  34. package/dist/es/models/server/ISocketRouteProcessor.js.map +1 -1
  35. package/dist/es/models/server/IWebServer.js.map +1 -1
  36. package/dist/es/models/services/IHealthComponent.js +2 -0
  37. package/dist/es/models/services/IHealthComponent.js.map +1 -0
  38. package/dist/es/models/services/IHostingComponent.js +2 -0
  39. package/dist/es/models/services/IHostingComponent.js.map +1 -0
  40. package/dist/es/models/services/IInformationComponent.js.map +1 -1
  41. package/dist/es/models/services/ITenant.js +4 -0
  42. package/dist/es/models/services/ITenant.js.map +1 -0
  43. package/dist/es/models/services/ITenantAdminComponent.js +2 -0
  44. package/dist/es/models/services/ITenantAdminComponent.js.map +1 -0
  45. package/dist/es/models/services/IUrlTransformerComponent.js +2 -0
  46. package/dist/es/models/services/IUrlTransformerComponent.js.map +1 -0
  47. package/dist/types/errors/forbiddenError.d.ts +20 -0
  48. package/dist/types/errors/tooManyRequestsError.d.ts +22 -0
  49. package/dist/types/helpers/httpErrorHelper.d.ts +6 -0
  50. package/dist/types/helpers/httpUrlHelper.d.ts +55 -0
  51. package/dist/types/index.d.ts +13 -4
  52. package/dist/types/models/api/IServerHealthResponse.d.ts +6 -3
  53. package/dist/types/models/api/IServerLivezResponse.d.ts +16 -0
  54. package/dist/types/models/api/IServerReadyzResponse.d.ts +16 -0
  55. package/dist/types/models/api/IServerRootResponse.d.ts +7 -0
  56. package/dist/types/models/config/IBaseRestClientConfig.d.ts +16 -0
  57. package/dist/types/models/httpContextIdKeys.d.ts +21 -0
  58. package/dist/types/models/protocol/IHttpRequestContext.d.ts +4 -0
  59. package/dist/types/models/protocol/IHttpRequestPathParams.d.ts +1 -1
  60. package/dist/types/models/protocol/IHttpRequestQuery.d.ts +1 -1
  61. package/dist/types/models/protocol/IHttpServerRequest.d.ts +4 -4
  62. package/dist/types/models/responses/errors/IConflictResponse.d.ts +1 -6
  63. package/dist/types/models/responses/errors/INotImplementedResponse.d.ts +15 -0
  64. package/dist/types/models/responses/errors/ITooManyRequestsResponse.d.ts +15 -0
  65. package/dist/types/models/routes/IBaseRoute.d.ts +9 -1
  66. package/dist/types/models/server/IBaseRouteProcessor.d.ts +14 -4
  67. package/dist/types/models/server/IRestRouteProcessor.d.ts +7 -2
  68. package/dist/types/models/server/IWebServer.d.ts +7 -1
  69. package/dist/types/models/services/IHealthComponent.d.ts +14 -0
  70. package/dist/types/models/services/IHostingComponent.d.ts +24 -0
  71. package/dist/types/models/services/IInformationComponent.d.ts +10 -17
  72. package/dist/types/models/services/ITenant.d.ts +33 -0
  73. package/dist/types/models/services/ITenantAdminComponent.d.ts +63 -0
  74. package/dist/types/models/services/IUrlTransformerComponent.d.ts +66 -0
  75. package/docs/changelog.md +278 -58
  76. package/docs/examples.md +200 -1
  77. package/docs/reference/classes/ForbiddenError.md +55 -0
  78. package/docs/reference/classes/HttpErrorHelper.md +14 -2
  79. package/docs/reference/classes/HttpParameterHelper.md +4 -4
  80. package/docs/reference/classes/HttpUrlHelper.md +197 -0
  81. package/docs/reference/classes/TooManyRequestsError.md +67 -0
  82. package/docs/reference/index.md +14 -5
  83. package/docs/reference/interfaces/IAcceptedResponse.md +2 -2
  84. package/docs/reference/interfaces/IBadRequestResponse.md +2 -2
  85. package/docs/reference/interfaces/IBaseRestClientConfig.md +57 -9
  86. package/docs/reference/interfaces/IBaseRoute.md +25 -9
  87. package/docs/reference/interfaces/IBaseRouteEntryPoint.md +4 -4
  88. package/docs/reference/interfaces/IBaseRouteProcessor.md +33 -13
  89. package/docs/reference/interfaces/IBaseSocketClientConfig.md +7 -7
  90. package/docs/reference/interfaces/IConflictResponse.md +3 -11
  91. package/docs/reference/interfaces/ICreatedResponse.md +2 -2
  92. package/docs/reference/interfaces/IForbiddenResponse.md +2 -2
  93. package/docs/reference/interfaces/IHealthComponent.md +21 -0
  94. package/docs/reference/interfaces/IHostingComponent.md +73 -0
  95. package/docs/reference/interfaces/IHttpRequest.md +8 -8
  96. package/docs/reference/interfaces/IHttpRequestContext.md +12 -4
  97. package/docs/reference/interfaces/IHttpRequestPathParams.md +1 -1
  98. package/docs/reference/interfaces/IHttpRequestQuery.md +1 -1
  99. package/docs/reference/interfaces/IHttpResponse.md +6 -6
  100. package/docs/reference/interfaces/IHttpServerRequest.md +14 -14
  101. package/docs/reference/interfaces/IInformationComponent.md +14 -56
  102. package/docs/reference/interfaces/IInternalServerErrorResponse.md +2 -2
  103. package/docs/reference/interfaces/IMimeTypeProcessor.md +2 -2
  104. package/docs/reference/interfaces/INoContentRequest.md +8 -8
  105. package/docs/reference/interfaces/INoContentResponse.md +1 -1
  106. package/docs/reference/interfaces/INotFoundResponse.md +3 -3
  107. package/docs/reference/interfaces/INotImplementedResponse.md +19 -0
  108. package/docs/reference/interfaces/IOkResponse.md +1 -1
  109. package/docs/reference/interfaces/IRestRoute.md +47 -23
  110. package/docs/reference/interfaces/IRestRouteExample.md +3 -3
  111. package/docs/reference/interfaces/IRestRouteProcessor.md +49 -19
  112. package/docs/reference/interfaces/IRestRouteRequestExample.md +4 -4
  113. package/docs/reference/interfaces/IRestRouteResponseAttachmentOptions.md +6 -6
  114. package/docs/reference/interfaces/IRestRouteResponseExample.md +4 -4
  115. package/docs/reference/interfaces/IRestRouteResponseOptions.md +2 -2
  116. package/docs/reference/interfaces/IServerFavIconResponse.md +7 -7
  117. package/docs/reference/interfaces/IServerHealthResponse.md +11 -3
  118. package/docs/reference/interfaces/IServerInfo.md +2 -2
  119. package/docs/reference/interfaces/IServerInfoResponse.md +1 -1
  120. package/docs/reference/interfaces/IServerLivezResponse.md +23 -0
  121. package/docs/reference/interfaces/IServerReadyzResponse.md +23 -0
  122. package/docs/reference/interfaces/IServerRootResponse.md +13 -1
  123. package/docs/reference/interfaces/IServerSpecResponse.md +4 -4
  124. package/docs/reference/interfaces/ISocketRequestContext.md +17 -5
  125. package/docs/reference/interfaces/ISocketRoute.md +38 -14
  126. package/docs/reference/interfaces/ISocketRouteProcessor.md +42 -22
  127. package/docs/reference/interfaces/ISocketServerRequest.md +17 -17
  128. package/docs/reference/interfaces/ITag.md +2 -2
  129. package/docs/reference/interfaces/ITenant.md +59 -0
  130. package/docs/reference/interfaces/ITenantAdminComponent.md +193 -0
  131. package/docs/reference/interfaces/ITooManyRequestsResponse.md +19 -0
  132. package/docs/reference/interfaces/IUnauthorizedResponse.md +2 -2
  133. package/docs/reference/interfaces/IUnprocessableEntityResponse.md +2 -2
  134. package/docs/reference/interfaces/IUrlTransformerComponent.md +229 -0
  135. package/docs/reference/interfaces/IWebServer.md +34 -4
  136. package/docs/reference/interfaces/IWebServerOptions.md +12 -12
  137. package/docs/reference/type-aliases/HttpContextIdKeys.md +5 -0
  138. package/docs/reference/variables/HttpContextIdKeys.md +25 -0
  139. package/package.json +2 -2
  140. package/dist/es/factories/authenticationGeneratorFactory.js +0 -9
  141. package/dist/es/factories/authenticationGeneratorFactory.js.map +0 -1
  142. package/dist/es/models/client/IAuthenticationGenerator.js +0 -2
  143. package/dist/es/models/client/IAuthenticationGenerator.js.map +0 -1
  144. package/dist/es/models/services/IHealthInfo.js +0 -2
  145. package/dist/es/models/services/IHealthInfo.js.map +0 -1
  146. package/dist/es/models/services/healthStatus.js +0 -21
  147. package/dist/es/models/services/healthStatus.js.map +0 -1
  148. package/dist/types/factories/authenticationGeneratorFactory.d.ts +0 -6
  149. package/dist/types/models/client/IAuthenticationGenerator.d.ts +0 -14
  150. package/dist/types/models/services/IHealthInfo.d.ts +0 -27
  151. package/dist/types/models/services/healthStatus.d.ts +0 -21
  152. package/docs/reference/interfaces/IAuthenticationGenerator.md +0 -35
  153. package/docs/reference/interfaces/IHealthInfo.md +0 -37
  154. package/docs/reference/type-aliases/HealthStatus.md +0 -5
  155. package/docs/reference/variables/AuthenticationGeneratorFactory.md +0 -5
  156. package/docs/reference/variables/HealthStatus.md +0 -25
@@ -1,21 +0,0 @@
1
- // Copyright 2024 IOTA Stiftung.
2
- // SPDX-License-Identifier: Apache-2.0.
3
- /**
4
- * The health status of the component.
5
- */
6
- // eslint-disable-next-line @typescript-eslint/naming-convention
7
- export const HealthStatus = {
8
- /**
9
- * OK.
10
- */
11
- Ok: "ok",
12
- /**
13
- * Warning.
14
- */
15
- Warning: "warning",
16
- /**
17
- * Error.
18
- */
19
- Error: "error"
20
- };
21
- //# sourceMappingURL=healthStatus.js.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"healthStatus.js","sourceRoot":"","sources":["../../../../src/models/services/healthStatus.ts"],"names":[],"mappings":"AAAA,gCAAgC;AAChC,uCAAuC;AAEvC;;GAEG;AACH,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAG;IAC3B;;OAEG;IACH,EAAE,EAAE,IAAI;IAER;;OAEG;IACH,OAAO,EAAE,SAAS;IAElB;;OAEG;IACH,KAAK,EAAE,OAAO;CACL,CAAC","sourcesContent":["// Copyright 2024 IOTA Stiftung.\n// SPDX-License-Identifier: Apache-2.0.\n\n/**\n * The health status of the component.\n */\n// eslint-disable-next-line @typescript-eslint/naming-convention\nexport const HealthStatus = {\n\t/**\n\t * OK.\n\t */\n\tOk: \"ok\",\n\n\t/**\n\t * Warning.\n\t */\n\tWarning: \"warning\",\n\n\t/**\n\t * Error.\n\t */\n\tError: \"error\"\n} as const;\n\n/**\n * The health status of the component.\n */\nexport type HealthStatus = (typeof HealthStatus)[keyof typeof HealthStatus];\n"]}
@@ -1,6 +0,0 @@
1
- import { Factory } from "@twin.org/core";
2
- import type { IAuthenticationGenerator } from "../models/client/IAuthenticationGenerator.js";
3
- /**
4
- * Factory for creating implementation of authentication generator types.
5
- */
6
- export declare const AuthenticationGeneratorFactory: Factory<IAuthenticationGenerator>;
@@ -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,27 +0,0 @@
1
- import type { HealthStatus } from "./healthStatus.js";
2
- /**
3
- * The status of the server.
4
- */
5
- export interface IHealthInfo {
6
- /**
7
- * The status.
8
- */
9
- status: HealthStatus;
10
- /**
11
- * The status of the components.
12
- */
13
- components?: {
14
- /**
15
- * The name of the component.
16
- */
17
- name: string;
18
- /**
19
- * The status of the component.
20
- */
21
- status: HealthStatus;
22
- /**
23
- * The details for the status.
24
- */
25
- details?: string;
26
- }[];
27
- }
@@ -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,37 +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**: `object`[]
18
-
19
- The status of the components.
20
-
21
- #### name
22
-
23
- > **name**: `string`
24
-
25
- The name of the component.
26
-
27
- #### status
28
-
29
- > **status**: [`HealthStatus`](../type-aliases/HealthStatus.md)
30
-
31
- The status of the component.
32
-
33
- #### details?
34
-
35
- > `optional` **details**: `string`
36
-
37
- The details for the status.
@@ -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.