@meghjs/core 0.5.4 → 0.6.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 (110) hide show
  1. package/README.md +54 -137
  2. package/dist/common/container.js +0 -1
  3. package/dist/common/container.js.map +1 -1
  4. package/dist/common/exceptions/http-exceptions.d.ts +1 -50
  5. package/dist/common/exceptions/http-exceptions.js +15 -80
  6. package/dist/common/exceptions/http-exceptions.js.map +1 -1
  7. package/dist/common/exceptions/system-exception.d.ts +0 -10
  8. package/dist/common/exceptions/system-exception.js +7 -12
  9. package/dist/common/exceptions/system-exception.js.map +1 -1
  10. package/dist/common/utils/compiled-validation.d.ts +43 -0
  11. package/dist/common/utils/compiled-validation.js +299 -0
  12. package/dist/common/utils/compiled-validation.js.map +1 -0
  13. package/dist/common/utils/object-utils.d.ts +4 -0
  14. package/dist/common/utils/object-utils.js +44 -7
  15. package/dist/common/utils/object-utils.js.map +1 -1
  16. package/dist/common/utils/path-utils.d.ts +7 -0
  17. package/dist/common/utils/path-utils.js +15 -0
  18. package/dist/common/utils/path-utils.js.map +1 -1
  19. package/dist/config/environment-variables.d.ts +2 -0
  20. package/dist/config/environment-variables.js +24 -12
  21. package/dist/config/environment-variables.js.map +1 -1
  22. package/dist/core/application.d.ts +90 -12
  23. package/dist/core/application.js +166 -100
  24. package/dist/core/application.js.map +1 -1
  25. package/dist/core/interfaces.d.ts +48 -4
  26. package/dist/core/router.d.ts +59 -9
  27. package/dist/core/router.js +233 -123
  28. package/dist/core/router.js.map +1 -1
  29. package/dist/core/testing.js +2 -12
  30. package/dist/core/testing.js.map +1 -1
  31. package/dist/core/types.d.ts +6 -0
  32. package/dist/errors/error-handler.d.ts +56 -0
  33. package/dist/errors/error-handler.js +206 -0
  34. package/dist/errors/error-handler.js.map +1 -0
  35. package/dist/errors/exception-filter.d.ts +96 -0
  36. package/dist/errors/exception-filter.js +68 -0
  37. package/dist/errors/exception-filter.js.map +1 -0
  38. package/dist/errors/http-exceptions.d.ts +413 -0
  39. package/dist/errors/http-exceptions.js +155 -0
  40. package/dist/errors/http-exceptions.js.map +1 -0
  41. package/dist/errors/index.d.ts +4 -0
  42. package/dist/errors/index.js +24 -0
  43. package/dist/errors/index.js.map +1 -0
  44. package/dist/events/event-subscriber.js +14 -3
  45. package/dist/events/event-subscriber.js.map +1 -1
  46. package/dist/events/socket-dispatcher.d.ts +1 -3
  47. package/dist/events/socket-dispatcher.js +2 -10
  48. package/dist/events/socket-dispatcher.js.map +1 -1
  49. package/dist/http/multipart.js.map +1 -1
  50. package/dist/http/params.js +3 -1
  51. package/dist/http/params.js.map +1 -1
  52. package/dist/http/route-methods.js.map +1 -1
  53. package/dist/http/validator-extend.js +1 -1
  54. package/dist/http/validator-extend.js.map +1 -1
  55. package/dist/index.d.ts +3 -2
  56. package/dist/index.js +7 -3
  57. package/dist/index.js.map +1 -1
  58. package/dist/observability/health.d.ts +45 -0
  59. package/dist/observability/health.js +74 -0
  60. package/dist/observability/health.js.map +1 -0
  61. package/dist/observability/index.d.ts +3 -0
  62. package/dist/observability/index.js +5 -0
  63. package/dist/observability/index.js.map +1 -1
  64. package/dist/observability/logger.js +8 -1
  65. package/dist/observability/logger.js.map +1 -1
  66. package/dist/observability/request-context.d.ts +29 -0
  67. package/dist/observability/request-context.js +54 -0
  68. package/dist/observability/request-context.js.map +1 -0
  69. package/dist/openapi/swagger-schema.d.ts +0 -2
  70. package/dist/openapi/swagger-schema.js +21 -5
  71. package/dist/openapi/swagger-schema.js.map +1 -1
  72. package/dist/orm/connect.d.ts +2 -0
  73. package/dist/orm/connect.js +6 -1
  74. package/dist/orm/connect.js.map +1 -1
  75. package/dist/orm/plugin.js +2 -0
  76. package/dist/orm/plugin.js.map +1 -1
  77. package/dist/plugins/plugin.d.ts +3 -0
  78. package/dist/plugins/plugin.js.map +1 -1
  79. package/dist/plugins/registry.js +1 -0
  80. package/dist/plugins/registry.js.map +1 -1
  81. package/dist/realtime/websocket.d.ts +1 -7
  82. package/dist/realtime/websocket.js +2 -18
  83. package/dist/realtime/websocket.js.map +1 -1
  84. package/dist/storage/file-storage.js +6 -4
  85. package/dist/storage/file-storage.js.map +1 -1
  86. package/dist/validator/compat.d.ts +5 -0
  87. package/dist/validator/compat.js +42 -0
  88. package/dist/validator/compat.js.map +1 -0
  89. package/dist/validator/compiler.d.ts +20 -0
  90. package/dist/validator/compiler.js +219 -0
  91. package/dist/validator/compiler.js.map +1 -0
  92. package/dist/validator/decorators.d.ts +81 -0
  93. package/dist/validator/decorators.js +377 -0
  94. package/dist/validator/decorators.js.map +1 -0
  95. package/dist/validator/index.d.ts +16 -0
  96. package/dist/validator/index.js +36 -0
  97. package/dist/validator/index.js.map +1 -0
  98. package/dist/validator/is-email.d.ts +25 -0
  99. package/dist/validator/is-email.js +204 -0
  100. package/dist/validator/is-email.js.map +1 -0
  101. package/dist/validator/messages.d.ts +20 -0
  102. package/dist/validator/messages.js +186 -0
  103. package/dist/validator/messages.js.map +1 -0
  104. package/dist/validator/metadata.d.ts +118 -0
  105. package/dist/validator/metadata.js +153 -0
  106. package/dist/validator/metadata.js.map +1 -0
  107. package/dist/validator/transform.d.ts +29 -0
  108. package/dist/validator/transform.js +210 -0
  109. package/dist/validator/transform.js.map +1 -0
  110. package/package.json +8 -3
@@ -0,0 +1,219 @@
1
+ "use strict";
2
+ Object.defineProperty(exports, "__esModule", { value: true });
3
+ exports.getCheck = getCheck;
4
+ exports.validateDto = validateDto;
5
+ /**
6
+ * @copyright 2024
7
+ * @author Tareq Hossain
8
+ * @email xtrinsic96@gmail.com
9
+ * @url https://github.com/xtareq
10
+ *
11
+ * Compiles a DTO class's validation rules into one JavaScript function.
12
+ *
13
+ * The generated function walks the instance once: whitelist, then each
14
+ * property's conditions, `@IsDefined`, checks and nested objects, in the order
15
+ * class-validator's `ValidationExecutor` runs them with `whitelist` and
16
+ * `forbidNonWhitelisted` on. Built-in checks are inlined; messages are only
17
+ * built for checks that fail. Errors come out flattened, as
18
+ * `transformAndValidate` reports them: `{ path, constraints }`, nested paths
19
+ * dotted (`address.city`, `items.0.name`).
20
+ *
21
+ * Only property names and rule indexes are written into the generated source;
22
+ * every value (constraints, messages, user functions) is passed in by
23
+ * reference.
24
+ */
25
+ const metadata_1 = require("./metadata");
26
+ const decorators_1 = require("./decorators");
27
+ const messages_1 = require("./messages");
28
+ const transform_1 = require("./transform");
29
+ const UNKNOWN_VALUE = "an unknown value was passed to the validate function";
30
+ const compiled = new WeakMap();
31
+ /** The compiled check for `target`, or `null` when it has no rules. */
32
+ function getCheck(target) {
33
+ const cached = compiled.get(target);
34
+ if (cached && cached.revision === (0, metadata_1.metadataRevision)())
35
+ return cached.check;
36
+ const rules = (0, metadata_1.getValidationRules)(target);
37
+ const check = rules.length > 0 ? compileCheck(rules) : null;
38
+ compiled.set(target, { revision: (0, metadata_1.metadataRevision)(), check });
39
+ return check;
40
+ }
41
+ /**
42
+ * Convert `value` into an instance of `target` (`@Type`, `@Transform`) and
43
+ * validate it with its Megh decorators. Unknown properties are errors.
44
+ *
45
+ * Same result as `transformAndValidate` with class-validator and
46
+ * class-transformer decorators.
47
+ */
48
+ function validateDto(target, value) {
49
+ if (value !== null &&
50
+ value !== undefined &&
51
+ (typeof value !== "object" || Array.isArray(value))) {
52
+ return {
53
+ value: value,
54
+ errors: [
55
+ { path: "", constraints: { isObject: "payload must be an object" } },
56
+ ],
57
+ };
58
+ }
59
+ const instance = (0, transform_1.toInstance)(target, (value ?? {}));
60
+ const errors = [];
61
+ const check = getCheck(target);
62
+ if (check)
63
+ check(instance, errors, "");
64
+ else
65
+ errors.push({
66
+ path: "undefined",
67
+ constraints: { unknownValue: UNKNOWN_VALUE },
68
+ });
69
+ return { value: instance, errors: errors.length > 0 ? errors : null };
70
+ }
71
+ // ---------------------------------------------------------------------------
72
+ // Runtime helpers the generated code calls
73
+ // ---------------------------------------------------------------------------
74
+ /** `ValidationExecutor.createValidationError`, message part. */
75
+ function message(rule, object, value) {
76
+ const args = {
77
+ targetName: object.constructor ? object.constructor.name : undefined,
78
+ property: rule.propertyName,
79
+ object,
80
+ value,
81
+ constraints: rule.constraints,
82
+ };
83
+ let text = rule.message || "";
84
+ if (!rule.message && rule.defaultMessage) {
85
+ const eachPrefix = rule.each ? "each value in " : "";
86
+ text = rule.defaultMessage(eachPrefix, args);
87
+ }
88
+ return (0, messages_1.replaceMessageSpecialTokens)(text, args);
89
+ }
90
+ const isArrayLike = (v) => Array.isArray(v) || v instanceof Set || v instanceof Map;
91
+ /** Items of an array, Set or Map, as `each: true` checks them. */
92
+ function items(v) {
93
+ if (v instanceof Map)
94
+ return Array.from(v.values());
95
+ return Array.isArray(v) ? v : Array.from(v);
96
+ }
97
+ /** `ValidationExecutor.execute` on a nested object, with its own class's rules. */
98
+ function execute(object, errors, prefix) {
99
+ const check = object.constructor ? getCheck(object.constructor) : null;
100
+ if (check)
101
+ check(object, errors, prefix);
102
+ else
103
+ errors.push({
104
+ path: prefix + "undefined",
105
+ constraints: { unknownValue: UNKNOWN_VALUE },
106
+ });
107
+ }
108
+ /** One item of a nested array (`performValidations` with only nested rules). */
109
+ function nestedItem(rules, value, errors, path) {
110
+ if (value === undefined)
111
+ return;
112
+ if (isArrayLike(value)) {
113
+ for (let i = 0; i < rules.length; i++)
114
+ nestedEach(rules, value, errors, path);
115
+ }
116
+ else if (value instanceof Object) {
117
+ for (let i = 0; i < rules.length; i++)
118
+ execute(value, errors, path + ".");
119
+ }
120
+ else {
121
+ const constraints = {};
122
+ for (const rule of rules) {
123
+ constraints.nestedValidation = message(rule, rule.target, value);
124
+ }
125
+ errors.push({ path, constraints });
126
+ }
127
+ }
128
+ /** Every item of a nested array, Set or Map, under `path.<index>`. */
129
+ function nestedEach(rules, value, errors, path) {
130
+ const list = value instanceof Set ? Array.from(value) : value;
131
+ list.forEach((sub, index) => {
132
+ nestedItem(rules, sub, errors, path + "." + index.toString());
133
+ });
134
+ }
135
+ const helpers = {
136
+ ...decorators_1.checkHelpers,
137
+ message,
138
+ isArrayLike,
139
+ items,
140
+ execute,
141
+ nestedEach,
142
+ };
143
+ // ---------------------------------------------------------------------------
144
+ // Code generation
145
+ // ---------------------------------------------------------------------------
146
+ function compileCheck(rules) {
147
+ // groupByPropertyName: properties in order of their first rule.
148
+ const byProperty = new Map();
149
+ for (const rule of rules) {
150
+ let list = byProperty.get(rule.propertyName);
151
+ if (!list)
152
+ byProperty.set(rule.propertyName, (list = []));
153
+ list.push(rule);
154
+ }
155
+ const R = []; // rules referenced by index
156
+ const P = []; // prepared values, same index
157
+ const NESTED = []; // nested-rule lists per property
158
+ const ref = (rule) => {
159
+ R.push(rule);
160
+ P.push(rule.check?.prepare ? rule.check.prepare(rule.constraints) : undefined);
161
+ return R.length - 1;
162
+ };
163
+ const head = [];
164
+ const body = [];
165
+ body.push("var keys = Object.keys(o), i, k, v, c, ok, okEach, it;", "for (i = 0; i < keys.length; i++) {", " k = keys[i];", " if (!A.has(k)) errs.push({ path: prefix + k, constraints: { whitelistValidation: \"property \" + k + \" should not exist\" } });", "}");
166
+ const test = (rule, j, x) => {
167
+ const check = rule.check;
168
+ if (check.inline)
169
+ return check.inline(x, `k${j}`, `p${j}`);
170
+ return `f${j}(${x}, k${j}, p${j})`;
171
+ };
172
+ for (const [name, list] of byProperty) {
173
+ const key = JSON.stringify(name);
174
+ const conditions = list.filter((r) => r.kind === "conditionalValidation");
175
+ const defined = list.filter((r) => r.kind === "isDefined");
176
+ const checks = list.filter((r) => r.kind === "customValidation");
177
+ const nested = list.filter((r) => r.kind === "nestedValidation");
178
+ body.push(`v = o[${key}];`, "ok = true;");
179
+ for (const rule of conditions) {
180
+ const j = ref(rule);
181
+ head.push(`var f${j} = R[${j}].condition;`);
182
+ // Every condition runs, as class-validator maps them all before reducing.
183
+ body.push(`if (!f${j}(o, v)) ok = false;`);
184
+ }
185
+ body.push("if (ok) {", "c = undefined;");
186
+ for (const rule of [...defined, ...checks]) {
187
+ const j = ref(rule);
188
+ head.push(`var k${j} = R[${j}].constraints, p${j} = P[${j}], f${j} = R[${j}].check.fn;`);
189
+ const fail = `(c || (c = {}))[${JSON.stringify(rule.name)}] = H.message(R[${j}], o, v);`;
190
+ if (rule.each) {
191
+ body.push("if (H.isArrayLike(v)) {", " okEach = true; it = H.items(v);", ` for (i = 0; i < it.length; i++) { if (!${test(rule, j, "it[i]")}) { okEach = false; break; } }`, "} else okEach = " + test(rule, j, "v") + ";", `if (!okEach) ${fail}`);
192
+ }
193
+ else {
194
+ body.push(`if (!${test(rule, j, "v")}) ${fail}`);
195
+ }
196
+ }
197
+ let n = -1;
198
+ if (nested.length > 0) {
199
+ NESTED.push(nested);
200
+ n = NESTED.length - 1;
201
+ const indexes = nested.map(ref);
202
+ // A value that is neither an object nor an array fails on the property itself.
203
+ body.push("if (v !== undefined && !H.isArrayLike(v) && !(v instanceof Object)) {", ...indexes.map((j) => ` (c || (c = {})).nestedValidation = H.message(R[${j}], R[${j}].target, v);`), "}");
204
+ }
205
+ body.push(`if (c !== undefined) errs.push({ path: prefix + ${key}, constraints: c });`);
206
+ if (n >= 0) {
207
+ body.push("if (v !== undefined) {", " if (H.isArrayLike(v)) {", ...nested.map(() => ` H.nestedEach(N[${n}], v, errs, prefix + ${key});`), " } else if (v instanceof Object) {", ...nested.map(() => ` H.execute(v, errs, prefix + ${key} + ".");`), " }", "}");
208
+ }
209
+ body.push("}");
210
+ }
211
+ const allowed = new Set(byProperty.keys());
212
+ const source = "\"use strict\";\n" +
213
+ head.join("\n") +
214
+ "\nreturn function check(o, errs, prefix) {\n" +
215
+ body.join("\n") +
216
+ "\n};";
217
+ return new Function("H", "R", "P", "N", "A", source)(helpers, R, P, NESTED, allowed);
218
+ }
219
+ //# sourceMappingURL=compiler.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"compiler.js","sourceRoot":"","sources":["../../src/validator/compiler.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,81 @@
1
+ /**
2
+ * @copyright 2024
3
+ * @author Tareq Hossain
4
+ * @email xtrinsic96@gmail.com
5
+ * @url https://github.com/xtareq
6
+ *
7
+ * Validation decorators with class-validator's names, options, checks,
8
+ * constraint keys and default messages. Switching a DTO over is a change of
9
+ * import:
10
+ *
11
+ * import { IsString, MinLength } from "class-validator"; // before
12
+ * import { IsString, MinLength } from "@meghjs/core"; // after
13
+ *
14
+ * Megh compiles each DTO's rules once into a single function; see
15
+ * `compiler.ts`. `@IsUUID`, `@IsUrl` and `@IsEmail` with non-default options
16
+ * call the `validator` package, as class-validator does, so they accept
17
+ * exactly the same values; install it to use them. `@IsEmail()` with default
18
+ * options needs no package (see `is-email.ts`).
19
+ */
20
+ import { ValidationOptions } from "./metadata";
21
+ /** Skip every other rule on this property when the value is `null` or `undefined`. */
22
+ export declare function IsOptional(options?: ValidationOptions): PropertyDecorator;
23
+ /** Validate this property only when `condition(object, value)` is truthy. */
24
+ export declare function ValidateIf(condition: (object: any, value: any) => boolean, options?: ValidationOptions): PropertyDecorator;
25
+ /** Allow the property through the whitelist without checking it. */
26
+ export declare function Allow(options?: ValidationOptions): PropertyDecorator;
27
+ /**
28
+ * Validate the nested object (or each item of an array) against its own
29
+ * class. Pair it with `@Type(() => Class)` so the value becomes an instance.
30
+ */
31
+ export declare function ValidateNested(options?: ValidationOptions): PropertyDecorator;
32
+ export declare const IsDefined: (options?: ValidationOptions) => PropertyDecorator;
33
+ export declare const IsNotEmpty: (options?: ValidationOptions) => PropertyDecorator;
34
+ export declare const IsEmpty: (options?: ValidationOptions) => PropertyDecorator;
35
+ export declare const IsIn: (values: readonly any[], options?: ValidationOptions) => PropertyDecorator;
36
+ export declare const IsNotIn: (values: readonly any[], options?: ValidationOptions) => PropertyDecorator;
37
+ export declare const IsString: (options?: ValidationOptions) => PropertyDecorator;
38
+ export type IsNumberOptions = {
39
+ allowNaN?: boolean;
40
+ allowInfinity?: boolean;
41
+ maxDecimalPlaces?: number;
42
+ };
43
+ declare function isNumber(value: any, options?: IsNumberOptions): boolean;
44
+ export declare const IsNumber: (numberOptions?: IsNumberOptions, options?: ValidationOptions) => PropertyDecorator;
45
+ export declare const IsInt: (options?: ValidationOptions) => PropertyDecorator;
46
+ export declare const IsBoolean: (options?: ValidationOptions) => PropertyDecorator;
47
+ export declare const IsDate: (options?: ValidationOptions) => PropertyDecorator;
48
+ export declare const IsArray: (options?: ValidationOptions) => PropertyDecorator;
49
+ export declare const IsObject: (options?: ValidationOptions) => PropertyDecorator;
50
+ export declare const IsEnum: (entity: object, options?: ValidationOptions) => PropertyDecorator;
51
+ export declare const Min: (minValue: number, options?: ValidationOptions) => PropertyDecorator;
52
+ export declare const Max: (maxValue: number, options?: ValidationOptions) => PropertyDecorator;
53
+ export declare const IsPositive: (options?: ValidationOptions) => PropertyDecorator;
54
+ export declare const IsNegative: (options?: ValidationOptions) => PropertyDecorator;
55
+ /**
56
+ * Length as the `validator` package's `isLength` counts it: a surrogate pair
57
+ * or a character followed by a variation selector is one character.
58
+ */
59
+ export declare function stringLength(str: string): number;
60
+ /** `validator`'s `isLength(str, { min, max })`. */
61
+ export declare function isLength(str: string, min: any, max: any): boolean;
62
+ export declare const MinLength: (min: number, options?: ValidationOptions) => PropertyDecorator;
63
+ export declare const MaxLength: (max: number, options?: ValidationOptions) => PropertyDecorator;
64
+ export declare const Length: (min: number, max?: number, options?: ValidationOptions) => PropertyDecorator;
65
+ /** `validator`'s `matches`. */
66
+ declare function matchesPattern(str: string, pattern: any, modifiers?: string): boolean;
67
+ export declare function Matches(pattern: RegExp, options?: ValidationOptions): PropertyDecorator;
68
+ export declare function Matches(pattern: string | RegExp, modifiers?: string, options?: ValidationOptions): PropertyDecorator;
69
+ export declare function IsEmail(emailOptions?: object, options?: ValidationOptions): PropertyDecorator;
70
+ export declare function IsUUID(version?: any, options?: ValidationOptions): PropertyDecorator;
71
+ export declare function IsUrl(urlOptions?: object, options?: ValidationOptions): PropertyDecorator;
72
+ export declare const ArrayMinSize: (min: number, options?: ValidationOptions) => PropertyDecorator;
73
+ export declare const ArrayMaxSize: (max: number, options?: ValidationOptions) => PropertyDecorator;
74
+ export declare const ArrayNotEmpty: (options?: ValidationOptions) => PropertyDecorator;
75
+ /** Helpers the compiled code calls (`H.*`). */
76
+ export declare const checkHelpers: {
77
+ isNumber: typeof isNumber;
78
+ isLength: typeof isLength;
79
+ matches: typeof matchesPattern;
80
+ };
81
+ export {};