@ruiapp/rapid-core 0.11.5 → 0.11.7

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 (204) hide show
  1. package/CHANGELOG.md +11 -11
  2. package/dist/core/pluginManager.d.ts +2 -0
  3. package/dist/core/server.d.ts +3 -0
  4. package/dist/dataAccess/entityManager.d.ts +3 -3
  5. package/dist/index.js +118 -41
  6. package/dist/server.d.ts +1 -0
  7. package/dist/types.d.ts +2 -0
  8. package/package.json +1 -1
  9. package/rollup.config.js +16 -16
  10. package/src/bootstrapApplicationConfig.ts +904 -904
  11. package/src/core/ExpressionInterpreter.ts +45 -45
  12. package/src/core/actionHandler.ts +24 -24
  13. package/src/core/actionHandlers/ifActionHandler.ts +27 -27
  14. package/src/core/eventManager.ts +20 -20
  15. package/src/core/facility.ts +7 -7
  16. package/src/core/http/formDataParser.ts +87 -87
  17. package/src/core/http-types.ts +4 -4
  18. package/src/core/pluginManager.ts +202 -193
  19. package/src/core/providers/runtimeProvider.ts +5 -5
  20. package/src/core/request.ts +96 -96
  21. package/src/core/response.ts +84 -84
  22. package/src/core/routeContext.ts +127 -127
  23. package/src/core/routes/healthz.ts +20 -20
  24. package/src/core/routes/index.ts +3 -3
  25. package/src/core/routesBuilder.ts +129 -122
  26. package/src/core/server.ts +161 -158
  27. package/src/dataAccess/columnTypeMapper.ts +22 -22
  28. package/src/dataAccess/dataAccessTypes.ts +165 -165
  29. package/src/dataAccess/dataAccessor.ts +135 -135
  30. package/src/dataAccess/entityManager.ts +2031 -1986
  31. package/src/dataAccess/entityMapper.ts +111 -111
  32. package/src/dataAccess/entityValidator.ts +33 -33
  33. package/src/dataAccess/propertyMapper.ts +28 -28
  34. package/src/deno-std/assert/assert.ts +9 -9
  35. package/src/deno-std/assert/assertion_error.ts +7 -7
  36. package/src/deno-std/datetime/to_imf.ts +32 -32
  37. package/src/deno-std/encoding/base64.ts +141 -141
  38. package/src/deno-std/http/cookie.ts +372 -372
  39. package/src/facilities/cache/CacheFacilityTypes.ts +29 -29
  40. package/src/facilities/cache/CacheFactory.ts +31 -31
  41. package/src/facilities/cache/MemoryCache.ts +58 -58
  42. package/src/facilities/cache/MemoryCacheProvider.ts +15 -15
  43. package/src/facilities/log/LogFacility.ts +35 -35
  44. package/src/helpers/dbTransactionHelper.ts +42 -42
  45. package/src/helpers/entityHelper.ts +89 -89
  46. package/src/helpers/filterHelper.ts +148 -148
  47. package/src/helpers/inputHelper.ts +11 -11
  48. package/src/helpers/licenseHelper.ts +29 -29
  49. package/src/helpers/metaHelper.ts +111 -111
  50. package/src/helpers/runCollectionEntityActionHandler.ts +58 -58
  51. package/src/index.ts +85 -85
  52. package/src/plugins/auth/AuthPlugin.ts +107 -107
  53. package/src/plugins/auth/AuthPluginTypes.ts +11 -11
  54. package/src/plugins/auth/actionHandlers/changePassword.ts +61 -61
  55. package/src/plugins/auth/actionHandlers/createSession.ts +68 -68
  56. package/src/plugins/auth/actionHandlers/deleteSession.ts +18 -18
  57. package/src/plugins/auth/actionHandlers/getMyProfile.ts +28 -28
  58. package/src/plugins/auth/actionHandlers/index.ts +8 -8
  59. package/src/plugins/auth/actionHandlers/resetPassword.ts +45 -45
  60. package/src/plugins/auth/models/AccessToken.ts +56 -56
  61. package/src/plugins/auth/models/index.ts +3 -3
  62. package/src/plugins/auth/routes/changePassword.ts +15 -15
  63. package/src/plugins/auth/routes/getMyProfile.ts +15 -15
  64. package/src/plugins/auth/routes/index.ts +7 -7
  65. package/src/plugins/auth/routes/resetPassword.ts +15 -15
  66. package/src/plugins/auth/routes/signin.ts +15 -15
  67. package/src/plugins/auth/routes/signout.ts +15 -15
  68. package/src/plugins/auth/services/AuthService.ts +66 -66
  69. package/src/plugins/cronJob/CronJobPlugin.ts +104 -104
  70. package/src/plugins/cronJob/CronJobPluginTypes.ts +44 -44
  71. package/src/plugins/cronJob/actionHandlers/index.ts +4 -4
  72. package/src/plugins/cronJob/actionHandlers/runCronJob.ts +32 -32
  73. package/src/plugins/cronJob/entityWatchers/cronJobEntityWatchers.ts +24 -24
  74. package/src/plugins/cronJob/entityWatchers/index.ts +4 -4
  75. package/src/plugins/cronJob/models/CronJob.ts +129 -129
  76. package/src/plugins/cronJob/models/index.ts +3 -3
  77. package/src/plugins/cronJob/routes/index.ts +3 -3
  78. package/src/plugins/cronJob/routes/runCronJob.ts +15 -15
  79. package/src/plugins/cronJob/services/CronJobService.ts +255 -255
  80. package/src/plugins/dataManage/DataManagePlugin.ts +165 -165
  81. package/src/plugins/dataManage/actionHandlers/addEntityRelations.ts +15 -15
  82. package/src/plugins/dataManage/actionHandlers/countCollectionEntities.ts +17 -17
  83. package/src/plugins/dataManage/actionHandlers/createCollectionEntitiesBatch.ts +81 -81
  84. package/src/plugins/dataManage/actionHandlers/createCollectionEntity.ts +20 -20
  85. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntities.ts +47 -45
  86. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntityById.ts +20 -20
  87. package/src/plugins/dataManage/actionHandlers/findCollectionEntities.ts +27 -27
  88. package/src/plugins/dataManage/actionHandlers/findCollectionEntityById.ts +30 -30
  89. package/src/plugins/dataManage/actionHandlers/queryDatabase.ts +22 -22
  90. package/src/plugins/dataManage/actionHandlers/removeEntityRelations.ts +15 -15
  91. package/src/plugins/dataManage/actionHandlers/saveEntity.ts +46 -46
  92. package/src/plugins/dataManage/actionHandlers/updateCollectionEntityById.ts +38 -38
  93. package/src/plugins/entityAccessControl/EntityAccessControlPlugin.ts +146 -146
  94. package/src/plugins/fileManage/FileManagePlugin.ts +52 -52
  95. package/src/plugins/fileManage/actionHandlers/downloadDocument.ts +65 -65
  96. package/src/plugins/fileManage/actionHandlers/downloadFile.ts +44 -44
  97. package/src/plugins/fileManage/actionHandlers/uploadFile.ts +33 -33
  98. package/src/plugins/fileManage/routes/downloadDocument.ts +15 -15
  99. package/src/plugins/fileManage/routes/downloadFile.ts +15 -15
  100. package/src/plugins/fileManage/routes/index.ts +5 -5
  101. package/src/plugins/fileManage/routes/uploadFile.ts +15 -15
  102. package/src/plugins/license/LicensePlugin.ts +79 -79
  103. package/src/plugins/license/LicensePluginTypes.ts +95 -95
  104. package/src/plugins/license/LicenseService.ts +141 -141
  105. package/src/plugins/license/actionHandlers/getLicense.ts +18 -18
  106. package/src/plugins/license/actionHandlers/index.ts +5 -5
  107. package/src/plugins/license/actionHandlers/updateLicense.ts +24 -24
  108. package/src/plugins/license/helpers/certHelper.ts +21 -21
  109. package/src/plugins/license/helpers/cryptoHelper.ts +47 -47
  110. package/src/plugins/license/models/index.ts +1 -1
  111. package/src/plugins/license/routes/getLicense.ts +15 -15
  112. package/src/plugins/license/routes/index.ts +4 -4
  113. package/src/plugins/license/routes/updateLicense.ts +15 -15
  114. package/src/plugins/mail/MailPlugin.ts +74 -74
  115. package/src/plugins/mail/MailPluginTypes.ts +27 -27
  116. package/src/plugins/mail/MailService.ts +38 -38
  117. package/src/plugins/mail/actionHandlers/index.ts +3 -3
  118. package/src/plugins/mail/models/index.ts +1 -1
  119. package/src/plugins/mail/routes/index.ts +1 -1
  120. package/src/plugins/metaManage/MetaManagePlugin.ts +198 -198
  121. package/src/plugins/metaManage/actionHandlers/getMetaModelDetail.ts +10 -10
  122. package/src/plugins/metaManage/actionHandlers/listMetaModels.ts +10 -10
  123. package/src/plugins/metaManage/actionHandlers/listMetaRoutes.ts +10 -10
  124. package/src/plugins/metaManage/services/MetaService.ts +376 -376
  125. package/src/plugins/notification/NotificationPlugin.ts +68 -68
  126. package/src/plugins/notification/NotificationPluginTypes.ts +13 -13
  127. package/src/plugins/notification/NotificationService.ts +25 -25
  128. package/src/plugins/notification/actionHandlers/index.ts +3 -3
  129. package/src/plugins/notification/models/Notification.ts +60 -60
  130. package/src/plugins/notification/models/index.ts +3 -3
  131. package/src/plugins/notification/routes/index.ts +1 -1
  132. package/src/plugins/routeManage/RouteManagePlugin.ts +64 -64
  133. package/src/plugins/routeManage/actionHandlers/httpProxy.ts +13 -13
  134. package/src/plugins/routeManage/actionHandlers/mock.ts +28 -28
  135. package/src/plugins/sequence/SequencePlugin.ts +146 -146
  136. package/src/plugins/sequence/SequencePluginTypes.ts +69 -69
  137. package/src/plugins/sequence/SequenceService.ts +92 -92
  138. package/src/plugins/sequence/actionHandlers/generateSn.ts +32 -32
  139. package/src/plugins/sequence/actionHandlers/index.ts +4 -4
  140. package/src/plugins/sequence/models/SequenceAutoIncrementRecord.ts +49 -49
  141. package/src/plugins/sequence/models/SequenceRule.ts +42 -42
  142. package/src/plugins/sequence/models/index.ts +4 -4
  143. package/src/plugins/sequence/routes/generateSn.ts +15 -15
  144. package/src/plugins/sequence/routes/index.ts +3 -3
  145. package/src/plugins/sequence/segment-utility.ts +11 -11
  146. package/src/plugins/sequence/segments/autoIncrement.ts +90 -90
  147. package/src/plugins/sequence/segments/dayOfMonth.ts +19 -19
  148. package/src/plugins/sequence/segments/index.ts +9 -9
  149. package/src/plugins/sequence/segments/literal.ts +16 -16
  150. package/src/plugins/sequence/segments/month.ts +19 -19
  151. package/src/plugins/sequence/segments/parameter.ts +20 -20
  152. package/src/plugins/sequence/segments/year.ts +19 -19
  153. package/src/plugins/serverOperation/ServerOperationPlugin.ts +93 -93
  154. package/src/plugins/serverOperation/ServerOperationPluginTypes.ts +25 -25
  155. package/src/plugins/serverOperation/actionHandlers/index.ts +4 -4
  156. package/src/plugins/serverOperation/actionHandlers/runServerOperation.ts +20 -20
  157. package/src/plugins/setting/SettingPlugin.ts +68 -68
  158. package/src/plugins/setting/SettingPluginTypes.ts +37 -37
  159. package/src/plugins/setting/SettingService.ts +222 -222
  160. package/src/plugins/setting/actionHandlers/getSystemSettingValues.ts +30 -30
  161. package/src/plugins/setting/actionHandlers/getUserSettingValues.ts +38 -38
  162. package/src/plugins/setting/actionHandlers/index.ts +6 -6
  163. package/src/plugins/setting/actionHandlers/setSystemSettingValues.ts +30 -30
  164. package/src/plugins/setting/models/SystemSettingGroupSetting.ts +57 -57
  165. package/src/plugins/setting/models/SystemSettingItem.ts +48 -48
  166. package/src/plugins/setting/models/SystemSettingItemSetting.ts +73 -73
  167. package/src/plugins/setting/models/UserSettingGroupSetting.ts +57 -57
  168. package/src/plugins/setting/models/UserSettingItem.ts +55 -55
  169. package/src/plugins/setting/models/UserSettingItemSetting.ts +73 -73
  170. package/src/plugins/setting/models/index.ts +8 -8
  171. package/src/plugins/setting/routes/getSystemSettingValues.ts +15 -15
  172. package/src/plugins/setting/routes/getUserSettingValues.ts +15 -15
  173. package/src/plugins/setting/routes/index.ts +5 -5
  174. package/src/plugins/setting/routes/setSystemSettingValues.ts +15 -15
  175. package/src/plugins/stateMachine/StateMachinePlugin.ts +196 -196
  176. package/src/plugins/stateMachine/StateMachinePluginTypes.ts +48 -48
  177. package/src/plugins/stateMachine/actionHandlers/index.ts +4 -4
  178. package/src/plugins/stateMachine/actionHandlers/sendStateMachineEvent.ts +54 -54
  179. package/src/plugins/stateMachine/models/StateMachine.ts +42 -42
  180. package/src/plugins/stateMachine/models/index.ts +3 -3
  181. package/src/plugins/stateMachine/routes/index.ts +3 -3
  182. package/src/plugins/stateMachine/routes/sendStateMachineEvent.ts +15 -15
  183. package/src/plugins/stateMachine/stateMachineHelper.ts +36 -36
  184. package/src/plugins/webhooks/WebhooksPlugin.ts +148 -148
  185. package/src/plugins/webhooks/pluginConfig.ts +75 -75
  186. package/src/polyfill.ts +5 -5
  187. package/src/proxy/mod.ts +38 -38
  188. package/src/proxy/types.ts +21 -21
  189. package/src/queryBuilder/index.ts +1 -1
  190. package/src/queryBuilder/queryBuilder.ts +755 -755
  191. package/src/server.ts +567 -556
  192. package/src/types/cron-job-types.ts +71 -71
  193. package/src/types.ts +884 -882
  194. package/src/utilities/accessControlUtility.ts +33 -33
  195. package/src/utilities/entityUtility.ts +18 -18
  196. package/src/utilities/errorUtility.ts +15 -15
  197. package/src/utilities/fsUtility.ts +137 -137
  198. package/src/utilities/httpUtility.ts +19 -19
  199. package/src/utilities/jwtUtility.ts +26 -26
  200. package/src/utilities/passwordUtility.ts +26 -26
  201. package/src/utilities/pathUtility.ts +14 -14
  202. package/src/utilities/timeUtility.ts +17 -17
  203. package/src/utilities/typeUtility.ts +15 -15
  204. package/tsconfig.json +19 -19
@@ -1,84 +1,84 @@
1
- import { isArray, isObject } from "lodash";
2
- import { HttpStatus, ResponseData } from "./http-types";
3
- import { Cookie, setCookie } from "~/deno-std/http/cookie";
4
-
5
- export const GlobalResponse = global.Response;
6
-
7
- function mergeHeaders(target: Headers, source: HeadersInit) {
8
- if (source instanceof Headers) {
9
- for (const keyValuePair of source.entries()) {
10
- target.set(keyValuePair[0], keyValuePair[1]);
11
- }
12
- } else if (isArray(source)) {
13
- for (const keyValuePair of source) {
14
- target.set(keyValuePair[0], keyValuePair[1]);
15
- }
16
- } else if (isObject(source)) {
17
- Object.entries(source).forEach(([key, value]) => target.set(key, value));
18
- }
19
- }
20
-
21
- interface NewResponseOptions {
22
- body?: ResponseData;
23
- status?: HttpStatus;
24
- headers?: HeadersInit;
25
- }
26
-
27
- function newResponse(options: NewResponseOptions) {
28
- return new Response(options.body, {
29
- headers: options.headers,
30
- status: options.status || 200,
31
- });
32
- }
33
-
34
- export class RapidResponse {
35
- // TODO: remove this field.
36
- #response: Response;
37
- status: number;
38
- body: BodyInit;
39
- headers: Headers;
40
-
41
- constructor(body?: BodyInit, init?: ResponseInit) {
42
- this.body = body;
43
- this.headers = new Headers(init?.headers);
44
- this.status = init?.status;
45
- }
46
-
47
- json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
48
- let body: string | null = null;
49
- if (obj) {
50
- body = JSON.stringify(obj);
51
- }
52
- this.headers.set("Content-Type", "application/json");
53
- const responseHeaders = new Headers(this.headers);
54
- if (headers) {
55
- mergeHeaders(responseHeaders, headers);
56
- }
57
- this.status = status || 200;
58
- this.body = body;
59
- this.#response = newResponse({ body, status: this.status, headers: responseHeaders });
60
- }
61
-
62
- redirect(location: string, status?: HttpStatus) {
63
- this.headers.set("Location", location);
64
- this.status = status || 302;
65
- this.#response = newResponse({
66
- headers: this.headers,
67
- status: this.status,
68
- });
69
- }
70
-
71
- setCookie(cookie: Cookie) {
72
- setCookie(this.headers, cookie);
73
- }
74
-
75
- getResponse() {
76
- if (!this.#response) {
77
- this.#response = new Response(this.body, {
78
- status: this.status || 200,
79
- headers: this.headers,
80
- });
81
- }
82
- return this.#response;
83
- }
84
- }
1
+ import { isArray, isObject } from "lodash";
2
+ import { HttpStatus, ResponseData } from "./http-types";
3
+ import { Cookie, setCookie } from "~/deno-std/http/cookie";
4
+
5
+ export const GlobalResponse = global.Response;
6
+
7
+ function mergeHeaders(target: Headers, source: HeadersInit) {
8
+ if (source instanceof Headers) {
9
+ for (const keyValuePair of source.entries()) {
10
+ target.set(keyValuePair[0], keyValuePair[1]);
11
+ }
12
+ } else if (isArray(source)) {
13
+ for (const keyValuePair of source) {
14
+ target.set(keyValuePair[0], keyValuePair[1]);
15
+ }
16
+ } else if (isObject(source)) {
17
+ Object.entries(source).forEach(([key, value]) => target.set(key, value));
18
+ }
19
+ }
20
+
21
+ interface NewResponseOptions {
22
+ body?: ResponseData;
23
+ status?: HttpStatus;
24
+ headers?: HeadersInit;
25
+ }
26
+
27
+ function newResponse(options: NewResponseOptions) {
28
+ return new Response(options.body, {
29
+ headers: options.headers,
30
+ status: options.status || 200,
31
+ });
32
+ }
33
+
34
+ export class RapidResponse {
35
+ // TODO: remove this field.
36
+ #response: Response;
37
+ status: number;
38
+ body: BodyInit;
39
+ headers: Headers;
40
+
41
+ constructor(body?: BodyInit, init?: ResponseInit) {
42
+ this.body = body;
43
+ this.headers = new Headers(init?.headers);
44
+ this.status = init?.status;
45
+ }
46
+
47
+ json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
48
+ let body: string | null = null;
49
+ if (obj) {
50
+ body = JSON.stringify(obj);
51
+ }
52
+ this.headers.set("Content-Type", "application/json");
53
+ const responseHeaders = new Headers(this.headers);
54
+ if (headers) {
55
+ mergeHeaders(responseHeaders, headers);
56
+ }
57
+ this.status = status || 200;
58
+ this.body = body;
59
+ this.#response = newResponse({ body, status: this.status, headers: responseHeaders });
60
+ }
61
+
62
+ redirect(location: string, status?: HttpStatus) {
63
+ this.headers.set("Location", location);
64
+ this.status = status || 302;
65
+ this.#response = newResponse({
66
+ headers: this.headers,
67
+ status: this.status,
68
+ });
69
+ }
70
+
71
+ setCookie(cookie: Cookie) {
72
+ setCookie(this.headers, cookie);
73
+ }
74
+
75
+ getResponse() {
76
+ if (!this.#response) {
77
+ this.#response = new Response(this.body, {
78
+ status: this.status || 200,
79
+ headers: this.headers,
80
+ });
81
+ }
82
+ return this.#response;
83
+ }
84
+ }
@@ -1,127 +1,127 @@
1
- import { RapidRequest } from "./request";
2
- import { RapidResponse } from "./response";
3
- import { HttpStatus } from "./http-types";
4
- import { IRpdServer } from "./server";
5
- import { IDatabaseAccessor, IDatabaseClient, RpdRoute } from "~/types";
6
-
7
- export type Next = () => Promise<void>;
8
-
9
- export type TransactionState = "uninited" | "inited" | "started";
10
-
11
- // TODO: should divide to RequestContext and OperationContext
12
-
13
- export class RouteContext {
14
- readonly request: RapidRequest;
15
- readonly response: RapidResponse;
16
- readonly state: Record<string, any>;
17
- readonly databaseAccessor: IDatabaseAccessor;
18
- method: string;
19
- path: string;
20
- params: Record<string, string>;
21
- routeConfig: RpdRoute;
22
- #server: IRpdServer;
23
- #dbTransactionClient: IDatabaseClient | undefined;
24
- #dbTransactionState: TransactionState;
25
-
26
- static newSystemOperationContext(server: IRpdServer) {
27
- return new RouteContext(server);
28
- }
29
-
30
- constructor(server: IRpdServer, request?: RapidRequest) {
31
- this.#server = server;
32
- this.databaseAccessor = server.getDatabaseAccessor();
33
- this.#dbTransactionState = "uninited";
34
-
35
- this.request = request;
36
- this.state = {};
37
- this.response = new RapidResponse();
38
-
39
- // `method` and `path` are used by `koa-tree-router` to match route
40
- if (this.request) {
41
- this.method = request.method;
42
- this.path = request.url.pathname;
43
- }
44
- }
45
-
46
- clone(): RouteContext {
47
- const clonedContext = new RouteContext(this.#server);
48
- clonedContext.method = this.method;
49
- clonedContext.path = this.path;
50
- clonedContext.params = this.params;
51
- clonedContext.setState(this.state);
52
-
53
- return clonedContext;
54
- }
55
-
56
- setState(state: Record<string, any>) {
57
- Object.assign(this.state, state);
58
- }
59
-
60
- // `koa-tree-router` uses this method to set headers
61
- set(headerName: string, headerValue: string) {
62
- this.response.headers.set(headerName, headerValue);
63
- }
64
-
65
- json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
66
- this.response.json(obj, status, headers);
67
- }
68
-
69
- redirect(url: string, status?: HttpStatus) {
70
- this.response.redirect(url, status);
71
- }
72
-
73
- getDbTransactionClient(): IDatabaseClient | undefined {
74
- return this.#dbTransactionClient;
75
- }
76
-
77
- async initDbTransactionClient(): Promise<IDatabaseClient> {
78
- let dbClient = this.#dbTransactionClient;
79
- if (dbClient) {
80
- return dbClient;
81
- }
82
-
83
- dbClient = await this.databaseAccessor.getClient();
84
- this.#dbTransactionState = "inited";
85
- this.#dbTransactionClient = dbClient;
86
- return dbClient;
87
- }
88
-
89
- async beginDbTransaction(): Promise<void> {
90
- if (!this.#dbTransactionClient) {
91
- throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
92
- }
93
-
94
- if (this.#dbTransactionState === "started") {
95
- throw new Error("Database transaction has been started. You can not begin a new transaction before you commit or rollback it.");
96
- }
97
-
98
- await this.databaseAccessor.queryDatabaseObject("BEGIN", [], this.#dbTransactionClient);
99
- this.#dbTransactionState = "started";
100
- }
101
-
102
- async commitDbTransaction(): Promise<void> {
103
- if (!this.#dbTransactionClient) {
104
- throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
105
- }
106
-
107
- if (this.#dbTransactionState !== "started") {
108
- throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
109
- }
110
-
111
- await this.databaseAccessor.queryDatabaseObject("COMMIT", [], this.#dbTransactionClient);
112
- this.#dbTransactionState = "inited";
113
- }
114
-
115
- async rollbackDbTransaction(): Promise<void> {
116
- if (!this.#dbTransactionClient) {
117
- throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
118
- }
119
-
120
- if (this.#dbTransactionState !== "started") {
121
- throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
122
- }
123
-
124
- await this.databaseAccessor.queryDatabaseObject("ROLLBACK", [], this.#dbTransactionClient);
125
- this.#dbTransactionState = "inited";
126
- }
127
- }
1
+ import { RapidRequest } from "./request";
2
+ import { RapidResponse } from "./response";
3
+ import { HttpStatus } from "./http-types";
4
+ import { IRpdServer } from "./server";
5
+ import { IDatabaseAccessor, IDatabaseClient, RpdRoute } from "~/types";
6
+
7
+ export type Next = () => Promise<void>;
8
+
9
+ export type TransactionState = "uninited" | "inited" | "started";
10
+
11
+ // TODO: should divide to RequestContext and OperationContext
12
+
13
+ export class RouteContext {
14
+ readonly request: RapidRequest;
15
+ readonly response: RapidResponse;
16
+ readonly state: Record<string, any>;
17
+ readonly databaseAccessor: IDatabaseAccessor;
18
+ method: string;
19
+ path: string;
20
+ params: Record<string, string>;
21
+ routeConfig: RpdRoute;
22
+ #server: IRpdServer;
23
+ #dbTransactionClient: IDatabaseClient | undefined;
24
+ #dbTransactionState: TransactionState;
25
+
26
+ static newSystemOperationContext(server: IRpdServer) {
27
+ return new RouteContext(server);
28
+ }
29
+
30
+ constructor(server: IRpdServer, request?: RapidRequest) {
31
+ this.#server = server;
32
+ this.databaseAccessor = server.getDatabaseAccessor();
33
+ this.#dbTransactionState = "uninited";
34
+
35
+ this.request = request;
36
+ this.state = {};
37
+ this.response = new RapidResponse();
38
+
39
+ // `method` and `path` are used by `koa-tree-router` to match route
40
+ if (this.request) {
41
+ this.method = request.method;
42
+ this.path = request.url.pathname;
43
+ }
44
+ }
45
+
46
+ clone(): RouteContext {
47
+ const clonedContext = new RouteContext(this.#server);
48
+ clonedContext.method = this.method;
49
+ clonedContext.path = this.path;
50
+ clonedContext.params = this.params;
51
+ clonedContext.setState(this.state);
52
+
53
+ return clonedContext;
54
+ }
55
+
56
+ setState(state: Record<string, any>) {
57
+ Object.assign(this.state, state);
58
+ }
59
+
60
+ // `koa-tree-router` uses this method to set headers
61
+ set(headerName: string, headerValue: string) {
62
+ this.response.headers.set(headerName, headerValue);
63
+ }
64
+
65
+ json(obj: any, status?: HttpStatus, headers?: HeadersInit) {
66
+ this.response.json(obj, status, headers);
67
+ }
68
+
69
+ redirect(url: string, status?: HttpStatus) {
70
+ this.response.redirect(url, status);
71
+ }
72
+
73
+ getDbTransactionClient(): IDatabaseClient | undefined {
74
+ return this.#dbTransactionClient;
75
+ }
76
+
77
+ async initDbTransactionClient(): Promise<IDatabaseClient> {
78
+ let dbClient = this.#dbTransactionClient;
79
+ if (dbClient) {
80
+ return dbClient;
81
+ }
82
+
83
+ dbClient = await this.databaseAccessor.getClient();
84
+ this.#dbTransactionState = "inited";
85
+ this.#dbTransactionClient = dbClient;
86
+ return dbClient;
87
+ }
88
+
89
+ async beginDbTransaction(): Promise<void> {
90
+ if (!this.#dbTransactionClient) {
91
+ throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
92
+ }
93
+
94
+ if (this.#dbTransactionState === "started") {
95
+ throw new Error("Database transaction has been started. You can not begin a new transaction before you commit or rollback it.");
96
+ }
97
+
98
+ await this.databaseAccessor.queryDatabaseObject("BEGIN", [], this.#dbTransactionClient);
99
+ this.#dbTransactionState = "started";
100
+ }
101
+
102
+ async commitDbTransaction(): Promise<void> {
103
+ if (!this.#dbTransactionClient) {
104
+ throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
105
+ }
106
+
107
+ if (this.#dbTransactionState !== "started") {
108
+ throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
109
+ }
110
+
111
+ await this.databaseAccessor.queryDatabaseObject("COMMIT", [], this.#dbTransactionClient);
112
+ this.#dbTransactionState = "inited";
113
+ }
114
+
115
+ async rollbackDbTransaction(): Promise<void> {
116
+ if (!this.#dbTransactionClient) {
117
+ throw new Error("Database transaction has not been inited. You should call initDbTransactionClient() first.");
118
+ }
119
+
120
+ if (this.#dbTransactionState !== "started") {
121
+ throw new Error("Database transaction has not been started. You should call beginDbTransaction() first.");
122
+ }
123
+
124
+ await this.databaseAccessor.queryDatabaseObject("ROLLBACK", [], this.#dbTransactionClient);
125
+ this.#dbTransactionState = "inited";
126
+ }
127
+ }
@@ -1,20 +1,20 @@
1
- import { RpdRoute } from "~/types";
2
- import { ActionHandlerContext } from "../actionHandler";
3
-
4
- export default {
5
- namespace: "sys",
6
- name: "sys.healthz",
7
- code: "sys.healthz",
8
- type: "RESTful",
9
- method: "GET",
10
- endpoint: "/healthz",
11
- handler,
12
- } satisfies RpdRoute;
13
-
14
- export async function handler(ctx: ActionHandlerContext) {
15
- const { server, input, routerContext: routeContext, logger } = ctx;
16
- const { response } = routeContext;
17
- const {} = input;
18
-
19
- ctx.output = {};
20
- }
1
+ import { RpdRoute } from "~/types";
2
+ import { ActionHandlerContext } from "../actionHandler";
3
+
4
+ export default {
5
+ namespace: "sys",
6
+ name: "sys.healthz",
7
+ code: "sys.healthz",
8
+ type: "RESTful",
9
+ method: "GET",
10
+ endpoint: "/healthz",
11
+ handler,
12
+ } satisfies RpdRoute;
13
+
14
+ export async function handler(ctx: ActionHandlerContext) {
15
+ const { server, input, routerContext: routeContext, logger } = ctx;
16
+ const { response } = routeContext;
17
+ const {} = input;
18
+
19
+ ctx.output = {};
20
+ }
@@ -1,3 +1,3 @@
1
- import healthz from "./healthz";
2
-
3
- export default [healthz];
1
+ import healthz from "./healthz";
2
+
3
+ export default [healthz];