@ruiapp/rapid-core 0.1.83 → 0.2.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 (143) hide show
  1. package/dist/bootstrapApplicationConfig.d.ts +6 -0
  2. package/dist/helpers/metaHelper.d.ts +3 -3
  3. package/dist/index.js +56 -24
  4. package/dist/plugins/webhooks/pluginConfig.d.ts +1 -0
  5. package/dist/types.d.ts +19 -1
  6. package/package.json +1 -1
  7. package/rollup.config.js +16 -16
  8. package/src/bootstrapApplicationConfig.ts +615 -602
  9. package/src/core/actionHandler.ts +22 -22
  10. package/src/core/eventManager.ts +20 -20
  11. package/src/core/facility.ts +7 -7
  12. package/src/core/http/formDataParser.ts +89 -89
  13. package/src/core/pluginManager.ts +175 -175
  14. package/src/core/providers/runtimeProvider.ts +5 -5
  15. package/src/core/request.ts +86 -86
  16. package/src/core/response.ts +76 -76
  17. package/src/core/routeContext.ts +43 -43
  18. package/src/core/routesBuilder.ts +88 -88
  19. package/src/core/server.ts +142 -142
  20. package/src/dataAccess/columnTypeMapper.ts +22 -22
  21. package/src/dataAccess/dataAccessTypes.ts +151 -151
  22. package/src/dataAccess/dataAccessor.ts +137 -137
  23. package/src/dataAccess/entityManager.ts +1499 -1505
  24. package/src/dataAccess/entityMapper.ts +100 -100
  25. package/src/dataAccess/propertyMapper.ts +28 -28
  26. package/src/deno-std/datetime/to_imf.ts +32 -32
  27. package/src/deno-std/encoding/base64.ts +141 -141
  28. package/src/deno-std/http/cookie.ts +372 -372
  29. package/src/facilities/log/LogFacility.ts +35 -35
  30. package/src/helpers/entityHelpers.ts +76 -76
  31. package/src/helpers/filterHelper.ts +47 -47
  32. package/src/helpers/metaHelper.ts +80 -76
  33. package/src/helpers/runCollectionEntityActionHandler.ts +27 -27
  34. package/src/index.ts +46 -46
  35. package/src/plugins/auth/AuthPlugin.ts +85 -85
  36. package/src/plugins/auth/actionHandlers/changePassword.ts +54 -54
  37. package/src/plugins/auth/actionHandlers/createSession.ts +63 -63
  38. package/src/plugins/auth/actionHandlers/deleteSession.ts +18 -18
  39. package/src/plugins/auth/actionHandlers/getMyProfile.ts +35 -35
  40. package/src/plugins/auth/actionHandlers/index.ts +8 -8
  41. package/src/plugins/auth/actionHandlers/resetPassword.ts +38 -38
  42. package/src/plugins/auth/models/AccessToken.ts +56 -56
  43. package/src/plugins/auth/models/index.ts +3 -3
  44. package/src/plugins/auth/routes/changePassword.ts +15 -15
  45. package/src/plugins/auth/routes/getMyProfile.ts +15 -15
  46. package/src/plugins/auth/routes/index.ts +7 -7
  47. package/src/plugins/auth/routes/resetPassword.ts +15 -15
  48. package/src/plugins/auth/routes/signin.ts +15 -15
  49. package/src/plugins/auth/routes/signout.ts +15 -15
  50. package/src/plugins/cronJob/CronJobPlugin.ts +112 -112
  51. package/src/plugins/cronJob/CronJobPluginTypes.ts +49 -49
  52. package/src/plugins/cronJob/actionHandlers/index.ts +4 -4
  53. package/src/plugins/cronJob/actionHandlers/runCronJob.ts +29 -29
  54. package/src/plugins/cronJob/routes/index.ts +3 -3
  55. package/src/plugins/cronJob/routes/runCronJob.ts +15 -15
  56. package/src/plugins/dataManage/DataManagePlugin.ts +163 -163
  57. package/src/plugins/dataManage/actionHandlers/addEntityRelations.ts +20 -20
  58. package/src/plugins/dataManage/actionHandlers/countCollectionEntities.ts +15 -15
  59. package/src/plugins/dataManage/actionHandlers/createCollectionEntitiesBatch.ts +42 -42
  60. package/src/plugins/dataManage/actionHandlers/createCollectionEntity.ts +24 -24
  61. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntities.ts +38 -38
  62. package/src/plugins/dataManage/actionHandlers/deleteCollectionEntityById.ts +22 -22
  63. package/src/plugins/dataManage/actionHandlers/findCollectionEntities.ts +26 -26
  64. package/src/plugins/dataManage/actionHandlers/findCollectionEntityById.ts +21 -21
  65. package/src/plugins/dataManage/actionHandlers/queryDatabase.ts +22 -22
  66. package/src/plugins/dataManage/actionHandlers/removeEntityRelations.ts +20 -20
  67. package/src/plugins/dataManage/actionHandlers/updateCollectionEntityById.ts +35 -35
  68. package/src/plugins/entityAccessControl/EntityAccessControlPlugin.ts +146 -146
  69. package/src/plugins/fileManage/FileManagePlugin.ts +52 -52
  70. package/src/plugins/fileManage/actionHandlers/downloadDocument.ts +36 -36
  71. package/src/plugins/fileManage/actionHandlers/downloadFile.ts +44 -44
  72. package/src/plugins/fileManage/actionHandlers/uploadFile.ts +33 -33
  73. package/src/plugins/fileManage/routes/downloadDocument.ts +15 -15
  74. package/src/plugins/fileManage/routes/downloadFile.ts +15 -15
  75. package/src/plugins/fileManage/routes/index.ts +5 -5
  76. package/src/plugins/fileManage/routes/uploadFile.ts +15 -15
  77. package/src/plugins/metaManage/MetaManagePlugin.ts +500 -488
  78. package/src/plugins/metaManage/actionHandlers/getMetaModelDetail.ts +10 -10
  79. package/src/plugins/metaManage/actionHandlers/listMetaModels.ts +9 -9
  80. package/src/plugins/metaManage/actionHandlers/listMetaRoutes.ts +9 -9
  81. package/src/plugins/routeManage/RouteManagePlugin.ts +62 -62
  82. package/src/plugins/routeManage/actionHandlers/httpProxy.ts +13 -13
  83. package/src/plugins/sequence/SequencePlugin.ts +136 -136
  84. package/src/plugins/sequence/SequencePluginTypes.ts +69 -69
  85. package/src/plugins/sequence/SequenceService.ts +81 -81
  86. package/src/plugins/sequence/actionHandlers/generateSn.ts +32 -32
  87. package/src/plugins/sequence/actionHandlers/index.ts +4 -4
  88. package/src/plugins/sequence/models/SequenceAutoIncrementRecord.ts +49 -49
  89. package/src/plugins/sequence/models/SequenceRule.ts +42 -42
  90. package/src/plugins/sequence/models/index.ts +4 -4
  91. package/src/plugins/sequence/routes/generateSn.ts +15 -15
  92. package/src/plugins/sequence/routes/index.ts +3 -3
  93. package/src/plugins/sequence/segment-utility.ts +11 -11
  94. package/src/plugins/sequence/segments/autoIncrement.ts +78 -78
  95. package/src/plugins/sequence/segments/dayOfMonth.ts +17 -17
  96. package/src/plugins/sequence/segments/index.ts +9 -9
  97. package/src/plugins/sequence/segments/literal.ts +14 -14
  98. package/src/plugins/sequence/segments/month.ts +17 -17
  99. package/src/plugins/sequence/segments/parameter.ts +18 -18
  100. package/src/plugins/sequence/segments/year.ts +17 -17
  101. package/src/plugins/serverOperation/ServerOperationPlugin.ts +91 -91
  102. package/src/plugins/serverOperation/ServerOperationPluginTypes.ts +15 -15
  103. package/src/plugins/serverOperation/actionHandlers/index.ts +4 -4
  104. package/src/plugins/setting/SettingPlugin.ts +68 -68
  105. package/src/plugins/setting/SettingPluginTypes.ts +37 -37
  106. package/src/plugins/setting/SettingService.ts +213 -213
  107. package/src/plugins/setting/actionHandlers/getSystemSettingValues.ts +30 -30
  108. package/src/plugins/setting/actionHandlers/getUserSettingValues.ts +38 -38
  109. package/src/plugins/setting/actionHandlers/index.ts +6 -6
  110. package/src/plugins/setting/actionHandlers/setSystemSettingValues.ts +30 -30
  111. package/src/plugins/setting/models/SystemSettingGroupSetting.ts +57 -57
  112. package/src/plugins/setting/models/SystemSettingItem.ts +42 -42
  113. package/src/plugins/setting/models/SystemSettingItemSetting.ts +73 -73
  114. package/src/plugins/setting/models/UserSettingGroupSetting.ts +57 -57
  115. package/src/plugins/setting/models/UserSettingItem.ts +49 -49
  116. package/src/plugins/setting/models/UserSettingItemSetting.ts +73 -73
  117. package/src/plugins/setting/models/index.ts +8 -8
  118. package/src/plugins/setting/routes/getSystemSettingValues.ts +15 -15
  119. package/src/plugins/setting/routes/getUserSettingValues.ts +15 -15
  120. package/src/plugins/setting/routes/index.ts +5 -5
  121. package/src/plugins/setting/routes/setSystemSettingValues.ts +15 -15
  122. package/src/plugins/stateMachine/StateMachinePlugin.ts +186 -186
  123. package/src/plugins/stateMachine/StateMachinePluginTypes.ts +48 -48
  124. package/src/plugins/stateMachine/actionHandlers/index.ts +4 -4
  125. package/src/plugins/stateMachine/actionHandlers/sendStateMachineEvent.ts +51 -51
  126. package/src/plugins/stateMachine/models/StateMachine.ts +42 -42
  127. package/src/plugins/stateMachine/models/index.ts +3 -3
  128. package/src/plugins/stateMachine/routes/index.ts +3 -3
  129. package/src/plugins/stateMachine/routes/sendStateMachineEvent.ts +15 -15
  130. package/src/plugins/webhooks/WebhooksPlugin.ts +148 -148
  131. package/src/plugins/webhooks/pluginConfig.ts +1 -0
  132. package/src/polyfill.ts +5 -5
  133. package/src/proxy/mod.ts +38 -38
  134. package/src/queryBuilder/queryBuilder.ts +637 -637
  135. package/src/server.ts +463 -451
  136. package/src/types.ts +659 -637
  137. package/src/utilities/accessControlUtility.ts +33 -33
  138. package/src/utilities/errorUtility.ts +15 -15
  139. package/src/utilities/fsUtility.ts +61 -61
  140. package/src/utilities/httpUtility.ts +19 -19
  141. package/src/utilities/jwtUtility.ts +26 -26
  142. package/src/utilities/timeUtility.ts +9 -9
  143. package/tsconfig.json +19 -19
@@ -1,100 +1,100 @@
1
- import type { IRpdServer } from "~/core/server";
2
- import { RpdDataModel } from "~/types";
3
- import { getEntityProperty, getEntityPropertyByCode, isRelationProperty } from "../helpers/metaHelper";
4
-
5
- // TODO Generate mapper and cache it.
6
-
7
- export function mapDbRowToEntity(server: IRpdServer, model: RpdDataModel, row: any, keepNonPropertyFields: boolean) {
8
- if (!row) {
9
- return null;
10
- }
11
-
12
- if (!model.properties || !model.properties.length) {
13
- return row;
14
- }
15
-
16
- const result: Record<string, any> = {};
17
- const columnNames = Object.keys(row);
18
- // TODO: Improve performance.
19
- columnNames.forEach((columnName) => {
20
- let isRelationProp = false;
21
- let propertyName = columnName;
22
- let property = getEntityProperty(server, model, (item) => item.columnName === columnName);
23
- if (property) {
24
- propertyName = property.code;
25
- } else {
26
- property = getEntityProperty(server, model, (item) => item.relation === "one" && item.targetIdColumnName === columnName);
27
- if (property) {
28
- isRelationProp = true;
29
- propertyName = property.code;
30
- } else if (keepNonPropertyFields) {
31
- propertyName = columnName;
32
- }
33
- }
34
-
35
- if (property?.config?.dataManage?.hidden) {
36
- return;
37
- }
38
-
39
- if (isRelationProp) {
40
- if (row[propertyName]) {
41
- if (!result[propertyName]) {
42
- result[propertyName] = row[propertyName];
43
- }
44
- } else if (keepNonPropertyFields) {
45
- result[columnName] = row[columnName];
46
- }
47
- } else {
48
- if (!result[propertyName]) {
49
- result[propertyName] = row[columnName];
50
- }
51
- }
52
- });
53
-
54
- return result;
55
- }
56
-
57
- export type DbRowWithBaseRow = {
58
- row?: Record<string, any>;
59
- baseRow?: Record<string, any>;
60
- };
61
-
62
- export function mapEntityToDbRow(server: IRpdServer, model: RpdDataModel, entity: any): DbRowWithBaseRow {
63
- let result: DbRowWithBaseRow = {};
64
- if (!entity) {
65
- return result;
66
- }
67
-
68
- const row = (result.row = {});
69
- const baseRow = (result.baseRow = {});
70
- if (!model.properties || !model.properties.length) {
71
- return result;
72
- }
73
-
74
- const propertyNames = Object.keys(entity);
75
- propertyNames.forEach((propertyName) => {
76
- let columnName = propertyName;
77
- const property = getEntityPropertyByCode(server, model, propertyName);
78
- if (property) {
79
- if (!isRelationProperty(property)) {
80
- columnName = property.columnName || property.code;
81
- if (property.isBaseProperty) {
82
- baseRow[columnName] = entity[propertyName];
83
- } else {
84
- row[columnName] = entity[propertyName];
85
- }
86
- }
87
- } else {
88
- const oneRelationProperty = getEntityProperty(server, model, (item) => item.relation === "one" && item.targetIdColumnName === propertyName);
89
- if (oneRelationProperty) {
90
- if (oneRelationProperty.isBaseProperty) {
91
- baseRow[columnName] = entity[propertyName];
92
- } else {
93
- row[columnName] = entity[propertyName];
94
- }
95
- }
96
- }
97
- });
98
-
99
- return result;
100
- }
1
+ import type { IRpdServer } from "~/core/server";
2
+ import { RpdDataModel } from "~/types";
3
+ import { getEntityProperty, getEntityPropertyByCode, isRelationProperty } from "../helpers/metaHelper";
4
+
5
+ // TODO Generate mapper and cache it.
6
+
7
+ export function mapDbRowToEntity(server: IRpdServer, model: RpdDataModel, row: any, keepNonPropertyFields: boolean) {
8
+ if (!row) {
9
+ return null;
10
+ }
11
+
12
+ if (!model.properties || !model.properties.length) {
13
+ return row;
14
+ }
15
+
16
+ const result: Record<string, any> = {};
17
+ const columnNames = Object.keys(row);
18
+ // TODO: Improve performance.
19
+ columnNames.forEach((columnName) => {
20
+ let isRelationProp = false;
21
+ let propertyName = columnName;
22
+ let property = getEntityProperty(server, model, (item) => item.columnName === columnName);
23
+ if (property) {
24
+ propertyName = property.code;
25
+ } else {
26
+ property = getEntityProperty(server, model, (item) => item.relation === "one" && item.targetIdColumnName === columnName);
27
+ if (property) {
28
+ isRelationProp = true;
29
+ propertyName = property.code;
30
+ } else if (keepNonPropertyFields) {
31
+ propertyName = columnName;
32
+ }
33
+ }
34
+
35
+ if (property?.config?.dataManage?.hidden) {
36
+ return;
37
+ }
38
+
39
+ if (isRelationProp) {
40
+ if (row[propertyName]) {
41
+ if (!result[propertyName]) {
42
+ result[propertyName] = row[propertyName];
43
+ }
44
+ } else if (keepNonPropertyFields) {
45
+ result[columnName] = row[columnName];
46
+ }
47
+ } else {
48
+ if (!result[propertyName]) {
49
+ result[propertyName] = row[columnName];
50
+ }
51
+ }
52
+ });
53
+
54
+ return result;
55
+ }
56
+
57
+ export type DbRowWithBaseRow = {
58
+ row?: Record<string, any>;
59
+ baseRow?: Record<string, any>;
60
+ };
61
+
62
+ export function mapEntityToDbRow(server: IRpdServer, model: RpdDataModel, entity: any): DbRowWithBaseRow {
63
+ let result: DbRowWithBaseRow = {};
64
+ if (!entity) {
65
+ return result;
66
+ }
67
+
68
+ const row = (result.row = {});
69
+ const baseRow = (result.baseRow = {});
70
+ if (!model.properties || !model.properties.length) {
71
+ return result;
72
+ }
73
+
74
+ const propertyNames = Object.keys(entity);
75
+ propertyNames.forEach((propertyName) => {
76
+ let columnName = propertyName;
77
+ const property = getEntityPropertyByCode(server, model, propertyName);
78
+ if (property) {
79
+ if (!isRelationProperty(property)) {
80
+ columnName = property.columnName || property.code;
81
+ if (property.isBaseProperty) {
82
+ baseRow[columnName] = entity[propertyName];
83
+ } else {
84
+ row[columnName] = entity[propertyName];
85
+ }
86
+ }
87
+ } else {
88
+ const oneRelationProperty = getEntityProperty(server, model, (item) => item.relation === "one" && item.targetIdColumnName === propertyName);
89
+ if (oneRelationProperty) {
90
+ if (oneRelationProperty.isBaseProperty) {
91
+ baseRow[columnName] = entity[propertyName];
92
+ } else {
93
+ row[columnName] = entity[propertyName];
94
+ }
95
+ }
96
+ }
97
+ });
98
+
99
+ return result;
100
+ }
@@ -1,28 +1,28 @@
1
- import { RpdDataModel } from "~/types";
2
- import { getEntityPropertyByCode, isOneRelationProperty } from "../helpers/metaHelper";
3
- import { IRpdServer } from "~/core/server";
4
-
5
- export function mapPropertyNameToColumnName(server: IRpdServer, model: RpdDataModel, propertyName: string) {
6
- if (!model.properties) {
7
- return propertyName;
8
- }
9
-
10
- const property = getEntityPropertyByCode(server, model, propertyName);
11
- if (!property) {
12
- return propertyName;
13
- }
14
-
15
- if (isOneRelationProperty(property)) {
16
- return property.targetIdColumnName!;
17
- }
18
-
19
- return property.columnName || property.code;
20
- }
21
-
22
- export function mapPropertyNamesToColumnNames(server: IRpdServer, model: RpdDataModel, propertyNames: string[]) {
23
- if (!propertyNames || !propertyNames.length) {
24
- return [];
25
- }
26
-
27
- return propertyNames.map((fieldName) => mapPropertyNameToColumnName(server, model, fieldName));
28
- }
1
+ import { RpdDataModel } from "~/types";
2
+ import { getEntityPropertyByCode, isOneRelationProperty } from "../helpers/metaHelper";
3
+ import { IRpdServer } from "~/core/server";
4
+
5
+ export function mapPropertyNameToColumnName(server: IRpdServer, model: RpdDataModel, propertyName: string) {
6
+ if (!model.properties) {
7
+ return propertyName;
8
+ }
9
+
10
+ const property = getEntityPropertyByCode(server, model, propertyName);
11
+ if (!property) {
12
+ return propertyName;
13
+ }
14
+
15
+ if (isOneRelationProperty(property)) {
16
+ return property.targetIdColumnName!;
17
+ }
18
+
19
+ return property.columnName || property.code;
20
+ }
21
+
22
+ export function mapPropertyNamesToColumnNames(server: IRpdServer, model: RpdDataModel, propertyNames: string[]) {
23
+ if (!propertyNames || !propertyNames.length) {
24
+ return [];
25
+ }
26
+
27
+ return propertyNames.map((fieldName) => mapPropertyNameToColumnName(server, model, fieldName));
28
+ }
@@ -1,32 +1,32 @@
1
- // Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
2
- // This module is browser compatible.
3
-
4
- /**
5
- * Formats the given date to IMF date time format. (Reference:
6
- * https://tools.ietf.org/html/rfc7231#section-7.1.1.1).
7
- * IMF is the time format to use when generating times in HTTP
8
- * headers. The time being formatted must be in UTC for Format to
9
- * generate the correct format.
10
- *
11
- * @example
12
- * ```ts
13
- * import { toIMF } from "https://deno.land/std@$STD_VERSION/datetime/to_imf.ts";
14
- *
15
- * toIMF(new Date(0)); // => returns "Thu, 01 Jan 1970 00:00:00 GMT"
16
- * ```
17
- * @param date Date to parse
18
- * @return IMF date formatted string
19
- */
20
- export function toIMF(date: Date): string {
21
- function dtPad(v: string, lPad = 2): string {
22
- return v.padStart(lPad, "0");
23
- }
24
- const d = dtPad(date.getUTCDate().toString());
25
- const h = dtPad(date.getUTCHours().toString());
26
- const min = dtPad(date.getUTCMinutes().toString());
27
- const s = dtPad(date.getUTCSeconds().toString());
28
- const y = date.getUTCFullYear();
29
- const days = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
30
- const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
31
- return `${days[date.getUTCDay()]}, ${d} ${months[date.getUTCMonth()]} ${y} ${h}:${min}:${s} GMT`;
32
- }
1
+ // Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
2
+ // This module is browser compatible.
3
+
4
+ /**
5
+ * Formats the given date to IMF date time format. (Reference:
6
+ * https://tools.ietf.org/html/rfc7231#section-7.1.1.1).
7
+ * IMF is the time format to use when generating times in HTTP
8
+ * headers. The time being formatted must be in UTC for Format to
9
+ * generate the correct format.
10
+ *
11
+ * @example
12
+ * ```ts
13
+ * import { toIMF } from "https://deno.land/std@$STD_VERSION/datetime/to_imf.ts";
14
+ *
15
+ * toIMF(new Date(0)); // => returns "Thu, 01 Jan 1970 00:00:00 GMT"
16
+ * ```
17
+ * @param date Date to parse
18
+ * @return IMF date formatted string
19
+ */
20
+ export function toIMF(date: Date): string {
21
+ function dtPad(v: string, lPad = 2): string {
22
+ return v.padStart(lPad, "0");
23
+ }
24
+ const d = dtPad(date.getUTCDate().toString());
25
+ const h = dtPad(date.getUTCHours().toString());
26
+ const min = dtPad(date.getUTCMinutes().toString());
27
+ const s = dtPad(date.getUTCSeconds().toString());
28
+ const y = date.getUTCFullYear();
29
+ const days = ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
30
+ const months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun", "Jul", "Aug", "Sep", "Oct", "Nov", "Dec"];
31
+ return `${days[date.getUTCDay()]}, ${d} ${months[date.getUTCMonth()]} ${y} ${h}:${min}:${s} GMT`;
32
+ }
@@ -1,141 +1,141 @@
1
- // Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
2
- // This module is browser compatible.
3
-
4
- /**
5
- * {@linkcode encode} and {@linkcode decode} for
6
- * [base64](https://en.wikipedia.org/wiki/Base64) encoding.
7
- *
8
- * This module is browser compatible.
9
- *
10
- * @example
11
- * ```ts
12
- * import {
13
- * decode,
14
- * encode,
15
- * } from "https://deno.land/std@$STD_VERSION/encoding/base64.ts";
16
- *
17
- * const b64Repr = "Zm9vYg==";
18
- *
19
- * const binaryData = decode(b64Repr);
20
- * console.log(binaryData);
21
- * // => Uint8Array [ 102, 111, 111, 98 ]
22
- *
23
- * console.log(encode(binaryData));
24
- * // => Zm9vYg==
25
- * ```
26
- *
27
- * @module
28
- */
29
-
30
- const base64abc = [
31
- "A",
32
- "B",
33
- "C",
34
- "D",
35
- "E",
36
- "F",
37
- "G",
38
- "H",
39
- "I",
40
- "J",
41
- "K",
42
- "L",
43
- "M",
44
- "N",
45
- "O",
46
- "P",
47
- "Q",
48
- "R",
49
- "S",
50
- "T",
51
- "U",
52
- "V",
53
- "W",
54
- "X",
55
- "Y",
56
- "Z",
57
- "a",
58
- "b",
59
- "c",
60
- "d",
61
- "e",
62
- "f",
63
- "g",
64
- "h",
65
- "i",
66
- "j",
67
- "k",
68
- "l",
69
- "m",
70
- "n",
71
- "o",
72
- "p",
73
- "q",
74
- "r",
75
- "s",
76
- "t",
77
- "u",
78
- "v",
79
- "w",
80
- "x",
81
- "y",
82
- "z",
83
- "0",
84
- "1",
85
- "2",
86
- "3",
87
- "4",
88
- "5",
89
- "6",
90
- "7",
91
- "8",
92
- "9",
93
- "+",
94
- "/",
95
- ];
96
-
97
- /**
98
- * CREDIT: https://gist.github.com/enepomnyaschih/72c423f727d395eeaa09697058238727
99
- * Encodes a given Uint8Array, ArrayBuffer or string into RFC4648 base64 representation
100
- * @param data
101
- */
102
- export function encode(data: ArrayBuffer | string): string {
103
- const uint8 = typeof data === "string" ? new TextEncoder().encode(data) : data instanceof Uint8Array ? data : new Uint8Array(data);
104
- let result = "",
105
- i;
106
- const l = uint8.length;
107
- for (i = 2; i < l; i += 3) {
108
- result += base64abc[uint8[i - 2] >> 2];
109
- result += base64abc[((uint8[i - 2] & 0x03) << 4) | (uint8[i - 1] >> 4)];
110
- result += base64abc[((uint8[i - 1] & 0x0f) << 2) | (uint8[i] >> 6)];
111
- result += base64abc[uint8[i] & 0x3f];
112
- }
113
- if (i === l + 1) {
114
- // 1 octet yet to write
115
- result += base64abc[uint8[i - 2] >> 2];
116
- result += base64abc[(uint8[i - 2] & 0x03) << 4];
117
- result += "==";
118
- }
119
- if (i === l) {
120
- // 2 octets yet to write
121
- result += base64abc[uint8[i - 2] >> 2];
122
- result += base64abc[((uint8[i - 2] & 0x03) << 4) | (uint8[i - 1] >> 4)];
123
- result += base64abc[(uint8[i - 1] & 0x0f) << 2];
124
- result += "=";
125
- }
126
- return result;
127
- }
128
-
129
- /**
130
- * Decodes a given RFC4648 base64 encoded string
131
- * @param b64
132
- */
133
- export function decode(b64: string): Uint8Array {
134
- const binString = atob(b64);
135
- const size = binString.length;
136
- const bytes = new Uint8Array(size);
137
- for (let i = 0; i < size; i++) {
138
- bytes[i] = binString.charCodeAt(i);
139
- }
140
- return bytes;
141
- }
1
+ // Copyright 2018-2023 the Deno authors. All rights reserved. MIT license.
2
+ // This module is browser compatible.
3
+
4
+ /**
5
+ * {@linkcode encode} and {@linkcode decode} for
6
+ * [base64](https://en.wikipedia.org/wiki/Base64) encoding.
7
+ *
8
+ * This module is browser compatible.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * import {
13
+ * decode,
14
+ * encode,
15
+ * } from "https://deno.land/std@$STD_VERSION/encoding/base64.ts";
16
+ *
17
+ * const b64Repr = "Zm9vYg==";
18
+ *
19
+ * const binaryData = decode(b64Repr);
20
+ * console.log(binaryData);
21
+ * // => Uint8Array [ 102, 111, 111, 98 ]
22
+ *
23
+ * console.log(encode(binaryData));
24
+ * // => Zm9vYg==
25
+ * ```
26
+ *
27
+ * @module
28
+ */
29
+
30
+ const base64abc = [
31
+ "A",
32
+ "B",
33
+ "C",
34
+ "D",
35
+ "E",
36
+ "F",
37
+ "G",
38
+ "H",
39
+ "I",
40
+ "J",
41
+ "K",
42
+ "L",
43
+ "M",
44
+ "N",
45
+ "O",
46
+ "P",
47
+ "Q",
48
+ "R",
49
+ "S",
50
+ "T",
51
+ "U",
52
+ "V",
53
+ "W",
54
+ "X",
55
+ "Y",
56
+ "Z",
57
+ "a",
58
+ "b",
59
+ "c",
60
+ "d",
61
+ "e",
62
+ "f",
63
+ "g",
64
+ "h",
65
+ "i",
66
+ "j",
67
+ "k",
68
+ "l",
69
+ "m",
70
+ "n",
71
+ "o",
72
+ "p",
73
+ "q",
74
+ "r",
75
+ "s",
76
+ "t",
77
+ "u",
78
+ "v",
79
+ "w",
80
+ "x",
81
+ "y",
82
+ "z",
83
+ "0",
84
+ "1",
85
+ "2",
86
+ "3",
87
+ "4",
88
+ "5",
89
+ "6",
90
+ "7",
91
+ "8",
92
+ "9",
93
+ "+",
94
+ "/",
95
+ ];
96
+
97
+ /**
98
+ * CREDIT: https://gist.github.com/enepomnyaschih/72c423f727d395eeaa09697058238727
99
+ * Encodes a given Uint8Array, ArrayBuffer or string into RFC4648 base64 representation
100
+ * @param data
101
+ */
102
+ export function encode(data: ArrayBuffer | string): string {
103
+ const uint8 = typeof data === "string" ? new TextEncoder().encode(data) : data instanceof Uint8Array ? data : new Uint8Array(data);
104
+ let result = "",
105
+ i;
106
+ const l = uint8.length;
107
+ for (i = 2; i < l; i += 3) {
108
+ result += base64abc[uint8[i - 2] >> 2];
109
+ result += base64abc[((uint8[i - 2] & 0x03) << 4) | (uint8[i - 1] >> 4)];
110
+ result += base64abc[((uint8[i - 1] & 0x0f) << 2) | (uint8[i] >> 6)];
111
+ result += base64abc[uint8[i] & 0x3f];
112
+ }
113
+ if (i === l + 1) {
114
+ // 1 octet yet to write
115
+ result += base64abc[uint8[i - 2] >> 2];
116
+ result += base64abc[(uint8[i - 2] & 0x03) << 4];
117
+ result += "==";
118
+ }
119
+ if (i === l) {
120
+ // 2 octets yet to write
121
+ result += base64abc[uint8[i - 2] >> 2];
122
+ result += base64abc[((uint8[i - 2] & 0x03) << 4) | (uint8[i - 1] >> 4)];
123
+ result += base64abc[(uint8[i - 1] & 0x0f) << 2];
124
+ result += "=";
125
+ }
126
+ return result;
127
+ }
128
+
129
+ /**
130
+ * Decodes a given RFC4648 base64 encoded string
131
+ * @param b64
132
+ */
133
+ export function decode(b64: string): Uint8Array {
134
+ const binString = atob(b64);
135
+ const size = binString.length;
136
+ const bytes = new Uint8Array(size);
137
+ for (let i = 0; i < size; i++) {
138
+ bytes[i] = binString.charCodeAt(i);
139
+ }
140
+ return bytes;
141
+ }