@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.
- package/README.md +54 -137
- package/dist/common/container.js +0 -1
- package/dist/common/container.js.map +1 -1
- package/dist/common/exceptions/http-exceptions.d.ts +1 -50
- package/dist/common/exceptions/http-exceptions.js +15 -80
- package/dist/common/exceptions/http-exceptions.js.map +1 -1
- package/dist/common/exceptions/system-exception.d.ts +0 -10
- package/dist/common/exceptions/system-exception.js +7 -12
- package/dist/common/exceptions/system-exception.js.map +1 -1
- package/dist/common/utils/compiled-validation.d.ts +43 -0
- package/dist/common/utils/compiled-validation.js +299 -0
- package/dist/common/utils/compiled-validation.js.map +1 -0
- package/dist/common/utils/object-utils.d.ts +4 -0
- package/dist/common/utils/object-utils.js +44 -7
- package/dist/common/utils/object-utils.js.map +1 -1
- package/dist/common/utils/path-utils.d.ts +7 -0
- package/dist/common/utils/path-utils.js +15 -0
- package/dist/common/utils/path-utils.js.map +1 -1
- package/dist/config/environment-variables.d.ts +2 -0
- package/dist/config/environment-variables.js +24 -12
- package/dist/config/environment-variables.js.map +1 -1
- package/dist/core/application.d.ts +90 -12
- package/dist/core/application.js +166 -100
- package/dist/core/application.js.map +1 -1
- package/dist/core/interfaces.d.ts +48 -4
- package/dist/core/router.d.ts +59 -9
- package/dist/core/router.js +233 -123
- package/dist/core/router.js.map +1 -1
- package/dist/core/testing.js +2 -12
- package/dist/core/testing.js.map +1 -1
- package/dist/core/types.d.ts +6 -0
- package/dist/errors/error-handler.d.ts +56 -0
- package/dist/errors/error-handler.js +206 -0
- package/dist/errors/error-handler.js.map +1 -0
- package/dist/errors/exception-filter.d.ts +96 -0
- package/dist/errors/exception-filter.js +68 -0
- package/dist/errors/exception-filter.js.map +1 -0
- package/dist/errors/http-exceptions.d.ts +413 -0
- package/dist/errors/http-exceptions.js +155 -0
- package/dist/errors/http-exceptions.js.map +1 -0
- package/dist/errors/index.d.ts +4 -0
- package/dist/errors/index.js +24 -0
- package/dist/errors/index.js.map +1 -0
- package/dist/events/event-subscriber.js +14 -3
- package/dist/events/event-subscriber.js.map +1 -1
- package/dist/events/socket-dispatcher.d.ts +1 -3
- package/dist/events/socket-dispatcher.js +2 -10
- package/dist/events/socket-dispatcher.js.map +1 -1
- package/dist/http/multipart.js.map +1 -1
- package/dist/http/params.js +3 -1
- package/dist/http/params.js.map +1 -1
- package/dist/http/route-methods.js.map +1 -1
- package/dist/http/validator-extend.js +1 -1
- package/dist/http/validator-extend.js.map +1 -1
- package/dist/index.d.ts +3 -2
- package/dist/index.js +7 -3
- package/dist/index.js.map +1 -1
- package/dist/observability/health.d.ts +45 -0
- package/dist/observability/health.js +74 -0
- package/dist/observability/health.js.map +1 -0
- package/dist/observability/index.d.ts +3 -0
- package/dist/observability/index.js +5 -0
- package/dist/observability/index.js.map +1 -1
- package/dist/observability/logger.js +8 -1
- package/dist/observability/logger.js.map +1 -1
- package/dist/observability/request-context.d.ts +29 -0
- package/dist/observability/request-context.js +54 -0
- package/dist/observability/request-context.js.map +1 -0
- package/dist/openapi/swagger-schema.d.ts +0 -2
- package/dist/openapi/swagger-schema.js +21 -5
- package/dist/openapi/swagger-schema.js.map +1 -1
- package/dist/orm/connect.d.ts +2 -0
- package/dist/orm/connect.js +6 -1
- package/dist/orm/connect.js.map +1 -1
- package/dist/orm/plugin.js +2 -0
- package/dist/orm/plugin.js.map +1 -1
- package/dist/plugins/plugin.d.ts +3 -0
- package/dist/plugins/plugin.js.map +1 -1
- package/dist/plugins/registry.js +1 -0
- package/dist/plugins/registry.js.map +1 -1
- package/dist/realtime/websocket.d.ts +1 -7
- package/dist/realtime/websocket.js +2 -18
- package/dist/realtime/websocket.js.map +1 -1
- package/dist/storage/file-storage.js +6 -4
- package/dist/storage/file-storage.js.map +1 -1
- package/dist/validator/compat.d.ts +5 -0
- package/dist/validator/compat.js +42 -0
- package/dist/validator/compat.js.map +1 -0
- package/dist/validator/compiler.d.ts +20 -0
- package/dist/validator/compiler.js +219 -0
- package/dist/validator/compiler.js.map +1 -0
- package/dist/validator/decorators.d.ts +81 -0
- package/dist/validator/decorators.js +377 -0
- package/dist/validator/decorators.js.map +1 -0
- package/dist/validator/index.d.ts +16 -0
- package/dist/validator/index.js +36 -0
- package/dist/validator/index.js.map +1 -0
- package/dist/validator/is-email.d.ts +25 -0
- package/dist/validator/is-email.js +204 -0
- package/dist/validator/is-email.js.map +1 -0
- package/dist/validator/messages.d.ts +20 -0
- package/dist/validator/messages.js +186 -0
- package/dist/validator/messages.js.map +1 -0
- package/dist/validator/metadata.d.ts +118 -0
- package/dist/validator/metadata.js +153 -0
- package/dist/validator/metadata.js.map +1 -0
- package/dist/validator/transform.d.ts +29 -0
- package/dist/validator/transform.js +210 -0
- package/dist/validator/transform.js.map +1 -0
- package/package.json +8 -3
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import type { Socket } from "socket.io";
|
|
2
2
|
export declare class SocketContextService {
|
|
3
3
|
private readonly storage;
|
|
4
|
-
run(socket: Socket, fn: () => void | Promise<void>): void
|
|
4
|
+
run(socket: Socket, fn: () => void | Promise<void>): void | Promise<void>;
|
|
5
5
|
getSocket(): Socket | undefined;
|
|
6
6
|
}
|
|
7
7
|
export type DispatchOptions = {
|
|
@@ -12,8 +12,6 @@ export type DispatchOptions = {
|
|
|
12
12
|
retryDelay?: number;
|
|
13
13
|
};
|
|
14
14
|
export declare class SocketEventDispatcher {
|
|
15
|
-
private readonly _context;
|
|
16
|
-
constructor(_context: SocketContextService);
|
|
17
15
|
dispatch<T = any>(event: string, data: T, options?: DispatchOptions): Promise<void>;
|
|
18
16
|
private dispatchToTransports;
|
|
19
17
|
}
|
|
@@ -5,9 +5,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
|
|
|
5
5
|
else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
|
|
6
6
|
return c > 3 && r && Object.defineProperty(target, key, r), r;
|
|
7
7
|
};
|
|
8
|
-
var __metadata = (this && this.__metadata) || function (k, v) {
|
|
9
|
-
if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
|
|
10
|
-
};
|
|
11
8
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
12
9
|
exports.SocketEventDispatcher = exports.SocketContextService = void 0;
|
|
13
10
|
exports.DispatchNow = DispatchNow;
|
|
@@ -18,7 +15,7 @@ const helpers_1 = require("../common/helpers");
|
|
|
18
15
|
let SocketContextService = class SocketContextService {
|
|
19
16
|
storage = new node_async_hooks_1.AsyncLocalStorage();
|
|
20
17
|
run(socket, fn) {
|
|
21
|
-
this.storage.run({ socket }, fn);
|
|
18
|
+
return this.storage.run({ socket }, fn);
|
|
22
19
|
}
|
|
23
20
|
getSocket() {
|
|
24
21
|
return this.storage.getStore()?.socket;
|
|
@@ -29,10 +26,6 @@ exports.SocketContextService = SocketContextService = __decorate([
|
|
|
29
26
|
(0, di_1.Injectable)()
|
|
30
27
|
], SocketContextService);
|
|
31
28
|
let SocketEventDispatcher = class SocketEventDispatcher {
|
|
32
|
-
_context;
|
|
33
|
-
constructor(_context) {
|
|
34
|
-
this._context = _context;
|
|
35
|
-
}
|
|
36
29
|
async dispatch(event, data, options = {}) {
|
|
37
30
|
const retryCount = options.retry ?? 0;
|
|
38
31
|
const delay = options.retryDelay ?? 300;
|
|
@@ -77,8 +70,7 @@ let SocketEventDispatcher = class SocketEventDispatcher {
|
|
|
77
70
|
};
|
|
78
71
|
exports.SocketEventDispatcher = SocketEventDispatcher;
|
|
79
72
|
exports.SocketEventDispatcher = SocketEventDispatcher = __decorate([
|
|
80
|
-
(0, di_1.Injectable)()
|
|
81
|
-
__metadata("design:paramtypes", [SocketContextService])
|
|
73
|
+
(0, di_1.Injectable)()
|
|
82
74
|
], SocketEventDispatcher);
|
|
83
75
|
function DispatchNow(event, options) {
|
|
84
76
|
return function (target, propertyKey, descriptor) {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"socket-dispatcher.js","sourceRoot":"","sources":["../../src/events/socket-dispatcher.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"socket-dispatcher.js","sourceRoot":"","sources":["../../src/events/socket-dispatcher.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../src/http/multipart.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;;;
|
|
1
|
+
{"version":3,"file":"multipart.js","sourceRoot":"","sources":["../../src/http/multipart.ts"],"names":[],"mappings":"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"}
|
package/dist/http/params.js
CHANGED
|
@@ -9,6 +9,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
|
|
|
9
9
|
exports.AuthUser = exports.Header = exports.Body = exports.Query = exports.Param = void 0;
|
|
10
10
|
const container_1 = require("../common/container");
|
|
11
11
|
const helpers_1 = require("../common/helpers");
|
|
12
|
+
const metadata_1 = require("../validator/metadata");
|
|
12
13
|
/**
|
|
13
14
|
* Best-effort parameter names from the function source. Only used for
|
|
14
15
|
* diagnostics, so any failure yields an empty list.
|
|
@@ -100,7 +101,8 @@ function createParamDecorator(type) {
|
|
|
100
101
|
// parameter as untyped instead of crashing.
|
|
101
102
|
const parameterTypes = Reflect.getMetadata("design:paramtypes", target, propertyKey) || [];
|
|
102
103
|
const paramDataType = options.type ?? parameterTypes[parameterIndex];
|
|
103
|
-
const validatorClass = (0, helpers_1.isClassValidatorClass)(paramDataType)
|
|
104
|
+
const validatorClass = (0, helpers_1.isClassValidatorClass)(paramDataType) ||
|
|
105
|
+
(0, metadata_1.isMeghValidatorClass)(paramDataType);
|
|
104
106
|
existingParams.push({
|
|
105
107
|
index: parameterIndex,
|
|
106
108
|
key: typeof key === "string" ? key : "all",
|
package/dist/http/params.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/http/params.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAEH,mDAM6B;AAC7B,+CAAuE;
|
|
1
|
+
{"version":3,"file":"params.js","sourceRoot":"","sources":["../../src/http/params.ts"],"names":[],"mappings":"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"}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"route-methods.js","sourceRoot":"","sources":["../../src/http/route-methods.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AAkBH,sBA0CC;AAgDD,4BASC;AAnHD,
|
|
1
|
+
{"version":3,"file":"route-methods.js","sourceRoot":"","sources":["../../src/http/route-methods.ts"],"names":[],"mappings":"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"}
|
|
@@ -8,7 +8,7 @@ exports.IsArrayNotEmpty = IsArrayNotEmpty;
|
|
|
8
8
|
* @url https://github.com/xtareq
|
|
9
9
|
*/
|
|
10
10
|
function IsArrayNotEmpty(validationOptions) {
|
|
11
|
-
const { registerDecorator
|
|
11
|
+
const { registerDecorator } = require("class-validator");
|
|
12
12
|
return function (object, propertyName) {
|
|
13
13
|
registerDecorator({
|
|
14
14
|
name: "isArrayWithAtLeastOneElement",
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"validator-extend.js","sourceRoot":"","sources":["../../src/http/validator-extend.ts"],"names":[],"mappings":";;AAMA,0CAkBC;AAxBD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,iBAAuB;IACrD,MAAM,EAAE,iBAAiB,EAAE,
|
|
1
|
+
{"version":3,"file":"validator-extend.js","sourceRoot":"","sources":["../../src/http/validator-extend.ts"],"names":[],"mappings":";;AAMA,0CAkBC;AAxBD;;;;;GAKG;AACH,SAAgB,eAAe,CAAC,iBAAuB;IACrD,MAAM,EAAE,iBAAiB,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACzD,OAAO,UAAU,MAAc,EAAE,YAAoB;QACnD,iBAAiB,CAAC;YAChB,IAAI,EAAE,8BAA8B;YACpC,MAAM,EAAE,MAAM,CAAC,WAAW;YAC1B,YAAY,EAAE,YAAY;YAC1B,OAAO,EAAE,iBAAiB;YAC1B,SAAS,EAAE;gBACT,QAAQ,CAAC,KAAU,EAAE,IAAS;oBAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBAClD,CAAC;gBACD,cAAc,CAAC,IAAS;oBACtB,OAAO,GAAG,IAAI,CAAC,QAAQ,kCAAkC,CAAC;gBAC5D,CAAC;aACF;SACF,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC"}
|
package/dist/index.d.ts
CHANGED
|
@@ -11,6 +11,7 @@ export * from "./core/interfaces";
|
|
|
11
11
|
export * from "./core/types";
|
|
12
12
|
export * from "./core/testing";
|
|
13
13
|
export * from "./http";
|
|
14
|
+
export * from "./validator";
|
|
14
15
|
export * from "./openapi";
|
|
15
16
|
export * from "./collection";
|
|
16
17
|
export * from "./orm";
|
|
@@ -19,16 +20,16 @@ export * from "./events";
|
|
|
19
20
|
export * from "./queue";
|
|
20
21
|
export type { Job, JobsOptions } from "./queue/queue";
|
|
21
22
|
export * from "./scheduler/schedule-decorator";
|
|
23
|
+
export { MeghScheduler } from "./scheduler/scheduler";
|
|
22
24
|
export * from "./security";
|
|
23
25
|
export * from "./storage";
|
|
24
26
|
export * from "./realtime";
|
|
25
27
|
export * from "./observability";
|
|
28
|
+
export * from "./errors";
|
|
26
29
|
export * from "./common/decorators";
|
|
27
30
|
export * from "./common/helpers";
|
|
28
31
|
export * from "./common/container";
|
|
29
|
-
export * from "./common/exceptions";
|
|
30
32
|
export declare const GetSchema: typeof sw.generateSwaggerSchema;
|
|
31
|
-
export declare const GetObjectSchema: typeof sw.generateClassSchema;
|
|
32
33
|
export declare const OpenApiOk: (args1: any) => {
|
|
33
34
|
description: string;
|
|
34
35
|
content: {
|
package/dist/index.js
CHANGED
|
@@ -36,7 +36,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
36
36
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
37
37
|
};
|
|
38
38
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
39
|
-
exports.inject = exports.createInjectDecorator = exports.Injectable = exports.Token = exports.ContainerError = exports.MeghContainer = exports.OpenApiProperty = exports.OpenApiResponse = exports.OpenApiOk = exports.
|
|
39
|
+
exports.inject = exports.createInjectDecorator = exports.Injectable = exports.Token = exports.ContainerError = exports.MeghContainer = exports.OpenApiProperty = exports.OpenApiResponse = exports.OpenApiOk = exports.GetSchema = exports.MeghScheduler = void 0;
|
|
40
40
|
/**
|
|
41
41
|
* @copyright 2024
|
|
42
42
|
* @author Tareq Hossain
|
|
@@ -52,6 +52,8 @@ __exportStar(require("./core/types"), exports);
|
|
|
52
52
|
__exportStar(require("./core/testing"), exports);
|
|
53
53
|
// ─── HTTP ────────────────────────────────────────────────────────────────────
|
|
54
54
|
__exportStar(require("./http"), exports);
|
|
55
|
+
// ─── Validation (class-validator / class-transformer compatible) ─────────────
|
|
56
|
+
__exportStar(require("./validator"), exports);
|
|
55
57
|
// ─── OpenAPI ─────────────────────────────────────────────────────────────────
|
|
56
58
|
__exportStar(require("./openapi"), exports);
|
|
57
59
|
// ─── Collections and pagination ──────────────────────────────────────────────
|
|
@@ -66,20 +68,22 @@ __exportStar(require("./events"), exports);
|
|
|
66
68
|
__exportStar(require("./queue"), exports);
|
|
67
69
|
// ─── Scheduler ───────────────────────────────────────────────────────────────
|
|
68
70
|
__exportStar(require("./scheduler/schedule-decorator"), exports);
|
|
71
|
+
var scheduler_1 = require("./scheduler/scheduler");
|
|
72
|
+
Object.defineProperty(exports, "MeghScheduler", { enumerable: true, get: function () { return scheduler_1.MeghScheduler; } });
|
|
69
73
|
// ─── Security ────────────────────────────────────────────────────────────────
|
|
70
74
|
__exportStar(require("./security"), exports);
|
|
71
75
|
// ─── Storage / Realtime / Observability ──────────────────────────────────────
|
|
72
76
|
__exportStar(require("./storage"), exports);
|
|
73
77
|
__exportStar(require("./realtime"), exports);
|
|
74
78
|
__exportStar(require("./observability"), exports);
|
|
79
|
+
// ─── Errors ─────────────────────────────────────────────────────────────────
|
|
80
|
+
__exportStar(require("./errors"), exports);
|
|
75
81
|
// ─── Common ──────────────────────────────────────────────────────────────────
|
|
76
82
|
__exportStar(require("./common/decorators"), exports);
|
|
77
83
|
__exportStar(require("./common/helpers"), exports);
|
|
78
84
|
__exportStar(require("./common/container"), exports);
|
|
79
|
-
__exportStar(require("./common/exceptions"), exports);
|
|
80
85
|
// ─── Convenience aliases ─────────────────────────────────────────────────────
|
|
81
86
|
exports.GetSchema = sw.generateSwaggerSchema;
|
|
82
|
-
exports.GetObjectSchema = sw.CreateSwaggerObjectSchema;
|
|
83
87
|
const OpenApiOk = (args1) => {
|
|
84
88
|
return sw.OpenApiResponse(200, args1, "Success");
|
|
85
89
|
};
|
package/dist/index.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,4BAA0B;AAC1B,6DAA+C;AAE/C,gFAAgF;AAChF,qDAAmC;AACnC,oDAAkC;AAClC,+CAA6B;AAC7B,iDAA+B;AAE/B,gFAAgF;AAChF,yCAAuB;AAEvB,gFAAgF;AAChF,4CAA0B;AAE1B,gFAAgF;AAChF,+CAA6B;AAE7B,gFAAgF;AAChF,wCAAsB;AAEtB,gFAAgF;AAChF,2CAAyB;AAEzB,gFAAgF;AAChF,2CAAyB;AAEzB,gFAAgF;AAChF,0CAAwB;AAKxB,gFAAgF;AAChF,iEAA+C;
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,4BAA0B;AAC1B,6DAA+C;AAE/C,gFAAgF;AAChF,qDAAmC;AACnC,oDAAkC;AAClC,+CAA6B;AAC7B,iDAA+B;AAE/B,gFAAgF;AAChF,yCAAuB;AAEvB,gFAAgF;AAChF,8CAA4B;AAE5B,gFAAgF;AAChF,4CAA0B;AAE1B,gFAAgF;AAChF,+CAA6B;AAE7B,gFAAgF;AAChF,wCAAsB;AAEtB,gFAAgF;AAChF,2CAAyB;AAEzB,gFAAgF;AAChF,2CAAyB;AAEzB,gFAAgF;AAChF,0CAAwB;AAKxB,gFAAgF;AAChF,iEAA+C;AAC/C,mDAAsD;AAA7C,0GAAA,aAAa,OAAA;AAEtB,gFAAgF;AAChF,6CAA2B;AAE3B,gFAAgF;AAChF,4CAA0B;AAC1B,6CAA2B;AAC3B,kDAAgC;AAEhC,+EAA+E;AAC/E,2CAAyB;AAEzB,gFAAgF;AAChF,sDAAoC;AACpC,mDAAiC;AACjC,qDAAmC;AAEnC,gFAAgF;AACnE,QAAA,SAAS,GAAG,EAAE,CAAC,qBAAqB,CAAC;AAC3C,MAAM,SAAS,GAAG,CAAC,KAAU,EAAE,EAAE;IACtC,OAAO,EAAE,CAAC,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;AACnD,CAAC,CAAC;AAFW,QAAA,SAAS,aAEpB;AACW,QAAA,eAAe,GAAG,EAAE,CAAC,eAAe,CAAC;AACrC,QAAA,eAAe,GAAG,EAAE,CAAC,eAAe,CAAC;AAElD,iFAAiF;AACjF,4CAA0B;AAE1B,gFAAgF;AAChF,2BAOc;AANZ,mGAAA,SAAS,OAAiB;AAC1B,oGAAA,cAAc,OAAA;AACd,2FAAA,KAAK,OAAA;AACL,gGAAA,UAAU,OAAA;AACV,2GAAA,qBAAqB,OAAA;AACrB,4FAAA,MAAM,OAAA"}
|
|
@@ -0,0 +1,45 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* @copyright 2024
|
|
3
|
+
* @author Tareq Hossain
|
|
4
|
+
* @email xtrinsic96@gmail.com
|
|
5
|
+
* @url https://github.com/xtareq
|
|
6
|
+
*/
|
|
7
|
+
import type { FastifyInstance } from "fastify";
|
|
8
|
+
/**
|
|
9
|
+
* A readiness check. It passes unless it throws, rejects or returns `false`.
|
|
10
|
+
*
|
|
11
|
+
* app.addHealthCheck("redis", () => redis.ping())
|
|
12
|
+
*/
|
|
13
|
+
export type HealthCheck = () => unknown | Promise<unknown>;
|
|
14
|
+
export interface HealthOptions {
|
|
15
|
+
/** Liveness route: answers 200 while the process can serve requests. Defaults to `/health`. */
|
|
16
|
+
path?: string;
|
|
17
|
+
/** Readiness route: runs every check, 503 if any fails. Defaults to `/ready`. */
|
|
18
|
+
readyPath?: string;
|
|
19
|
+
/** Extra checks, in addition to the ones plugins register. */
|
|
20
|
+
checks?: Record<string, HealthCheck>;
|
|
21
|
+
/** Milliseconds before a check counts as failed. Defaults to 5000. */
|
|
22
|
+
timeout?: number;
|
|
23
|
+
}
|
|
24
|
+
export interface HealthCheckResult {
|
|
25
|
+
status: "up" | "down";
|
|
26
|
+
durationMs: number;
|
|
27
|
+
/** Why the check failed. Development only, since it can describe internals. */
|
|
28
|
+
error?: string;
|
|
29
|
+
}
|
|
30
|
+
export interface ReadinessReport {
|
|
31
|
+
status: "ok" | "error";
|
|
32
|
+
checks: Record<string, HealthCheckResult>;
|
|
33
|
+
}
|
|
34
|
+
/** Route config flag that makes global `useMiddlewares` skip a route. */
|
|
35
|
+
export declare const SKIP_GLOBAL_MIDDLEWARE = "meghSkipGlobalMiddleware";
|
|
36
|
+
/** Runs readiness checks and serves the health routes. */
|
|
37
|
+
export declare class HealthRegistry {
|
|
38
|
+
private readonly checks;
|
|
39
|
+
add(name: string, check: HealthCheck): void;
|
|
40
|
+
names(): string[];
|
|
41
|
+
/** Run every check concurrently. */
|
|
42
|
+
run(timeout?: number, exposeErrors?: boolean): Promise<ReadinessReport>;
|
|
43
|
+
/** Register the liveness and readiness routes. */
|
|
44
|
+
install(app: FastifyInstance, options: HealthOptions, isDevelopment: () => boolean): void;
|
|
45
|
+
}
|
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.HealthRegistry = exports.SKIP_GLOBAL_MIDDLEWARE = void 0;
|
|
4
|
+
/** Route config flag that makes global `useMiddlewares` skip a route. */
|
|
5
|
+
exports.SKIP_GLOBAL_MIDDLEWARE = "meghSkipGlobalMiddleware";
|
|
6
|
+
/** Runs readiness checks and serves the health routes. */
|
|
7
|
+
class HealthRegistry {
|
|
8
|
+
checks = new Map();
|
|
9
|
+
add(name, check) {
|
|
10
|
+
if (typeof check !== "function") {
|
|
11
|
+
throw new TypeError(`[Megh] Health check "${name}" must be a function.`);
|
|
12
|
+
}
|
|
13
|
+
if (this.checks.has(name)) {
|
|
14
|
+
throw new Error(`[Megh] A health check named "${name}" is already registered.`);
|
|
15
|
+
}
|
|
16
|
+
this.checks.set(name, check);
|
|
17
|
+
}
|
|
18
|
+
names() {
|
|
19
|
+
return [...this.checks.keys()];
|
|
20
|
+
}
|
|
21
|
+
/** Run every check concurrently. */
|
|
22
|
+
async run(timeout = 5000, exposeErrors = false) {
|
|
23
|
+
const entries = await Promise.all([...this.checks].map(async ([name, check]) => {
|
|
24
|
+
const started = performance.now();
|
|
25
|
+
let error;
|
|
26
|
+
try {
|
|
27
|
+
const passed = await withTimeout(Promise.resolve().then(check), timeout);
|
|
28
|
+
if (passed === false)
|
|
29
|
+
error = new Error("check returned false");
|
|
30
|
+
}
|
|
31
|
+
catch (err) {
|
|
32
|
+
error = err;
|
|
33
|
+
}
|
|
34
|
+
const result = {
|
|
35
|
+
status: error === undefined ? "up" : "down",
|
|
36
|
+
durationMs: Math.round(performance.now() - started),
|
|
37
|
+
};
|
|
38
|
+
if (error !== undefined && exposeErrors) {
|
|
39
|
+
result.error = String(error?.message ?? error);
|
|
40
|
+
}
|
|
41
|
+
return [name, result];
|
|
42
|
+
}));
|
|
43
|
+
const checks = Object.fromEntries(entries);
|
|
44
|
+
const ok = entries.every(([, r]) => r.status === "up");
|
|
45
|
+
return { status: ok ? "ok" : "error", checks };
|
|
46
|
+
}
|
|
47
|
+
/** Register the liveness and readiness routes. */
|
|
48
|
+
install(app, options, isDevelopment) {
|
|
49
|
+
const timeout = options.timeout ?? 5000;
|
|
50
|
+
// Hidden from the OpenAPI document; not behind authentication, since
|
|
51
|
+
// they are registered on Fastify directly rather than through a controller.
|
|
52
|
+
const schema = { hide: true };
|
|
53
|
+
const config = { [exports.SKIP_GLOBAL_MIDDLEWARE]: true };
|
|
54
|
+
app.get(options.path ?? "/health", { schema, config }, async () => ({
|
|
55
|
+
status: "ok",
|
|
56
|
+
}));
|
|
57
|
+
app.get(options.readyPath ?? "/ready", { schema, config }, async (_req, reply) => {
|
|
58
|
+
const report = await this.run(timeout, isDevelopment());
|
|
59
|
+
return reply.code(report.status === "ok" ? 200 : 503).send(report);
|
|
60
|
+
});
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
exports.HealthRegistry = HealthRegistry;
|
|
64
|
+
function withTimeout(promise, ms) {
|
|
65
|
+
let timer;
|
|
66
|
+
return Promise.race([
|
|
67
|
+
promise,
|
|
68
|
+
new Promise((_, reject) => {
|
|
69
|
+
timer = setTimeout(() => reject(new Error(`timed out after ${ms}ms`)), ms);
|
|
70
|
+
timer.unref();
|
|
71
|
+
}),
|
|
72
|
+
]).finally(() => clearTimeout(timer));
|
|
73
|
+
}
|
|
74
|
+
//# sourceMappingURL=health.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/observability/health.ts"],"names":[],"mappings":"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"}
|
|
@@ -14,6 +14,11 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
|
|
|
14
14
|
for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
|
|
15
15
|
};
|
|
16
16
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
17
|
+
exports.DEFAULT_REQUEST_ID_HEADER = exports.getRequestId = void 0;
|
|
17
18
|
__exportStar(require("./logger"), exports);
|
|
18
19
|
__exportStar(require("./cache"), exports);
|
|
20
|
+
var request_context_1 = require("./request-context");
|
|
21
|
+
Object.defineProperty(exports, "getRequestId", { enumerable: true, get: function () { return request_context_1.getRequestId; } });
|
|
22
|
+
Object.defineProperty(exports, "DEFAULT_REQUEST_ID_HEADER", { enumerable: true, get: function () { return request_context_1.DEFAULT_REQUEST_ID_HEADER; } });
|
|
23
|
+
__exportStar(require("./health"), exports);
|
|
19
24
|
//# sourceMappingURL=index.js.map
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/observability/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,2CAAyB;AACzB,0CAAwB;AACxB,qDAA4E;AAAnE,+GAAA,YAAY,OAAA;AAAE,4HAAA,yBAAyB,OAAA;AAEhD,2CAAyB"}
|
|
@@ -17,6 +17,7 @@ exports.LoggerService = void 0;
|
|
|
17
17
|
exports.buildLoggerOptions = buildLoggerOptions;
|
|
18
18
|
const pino_1 = __importDefault(require("pino"));
|
|
19
19
|
const decorators_1 = require("../common/decorators");
|
|
20
|
+
const request_context_1 = require("./request-context");
|
|
20
21
|
function isPinoPrettyInstalled() {
|
|
21
22
|
try {
|
|
22
23
|
require.resolve("pino-pretty", { paths: [process.cwd(), __dirname] });
|
|
@@ -26,6 +27,11 @@ function isPinoPrettyInstalled() {
|
|
|
26
27
|
return false;
|
|
27
28
|
}
|
|
28
29
|
}
|
|
30
|
+
/** Adds `reqId` to every log line written while a request is handled. */
|
|
31
|
+
function requestIdMixin() {
|
|
32
|
+
const reqId = (0, request_context_1.getRequestId)();
|
|
33
|
+
return reqId ? { reqId } : {};
|
|
34
|
+
}
|
|
29
35
|
/**
|
|
30
36
|
* The pino options Megh uses: structured JSON everywhere, except in
|
|
31
37
|
* development (`NODE_ENV === "development"`) when pino-pretty is installed.
|
|
@@ -35,9 +41,10 @@ function buildLoggerOptions(config = {}, env = process.env) {
|
|
|
35
41
|
const pretty = config.pretty ??
|
|
36
42
|
(env.NODE_ENV === "development" && isPinoPrettyInstalled());
|
|
37
43
|
if (!pretty)
|
|
38
|
-
return { level };
|
|
44
|
+
return { level, mixin: requestIdMixin };
|
|
39
45
|
return {
|
|
40
46
|
level,
|
|
47
|
+
mixin: requestIdMixin,
|
|
41
48
|
transport: {
|
|
42
49
|
target: "pino-pretty",
|
|
43
50
|
options: {
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;
|
|
1
|
+
{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/observability/logger.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
import type { FastifyInstance } from "fastify";
|
|
2
|
+
import type { IncomingMessage } from "http";
|
|
3
|
+
/** The default header that carries the request ID in and out. */
|
|
4
|
+
export declare const DEFAULT_REQUEST_ID_HEADER = "x-request-id";
|
|
5
|
+
/**
|
|
6
|
+
* The ID of the request being handled, or `undefined` outside a request.
|
|
7
|
+
* Works anywhere in the request's async call chain: services, repositories,
|
|
8
|
+
* event listeners.
|
|
9
|
+
*
|
|
10
|
+
* logger.info({ requestId: getRequestId() }, "charging card");
|
|
11
|
+
*/
|
|
12
|
+
export declare function getRequestId(): string | undefined;
|
|
13
|
+
/** Options for request IDs: `false` turns them off. */
|
|
14
|
+
export type RequestIdOptions = false | {
|
|
15
|
+
/** Header read from the request and set on the response. Defaults to `x-request-id`. */
|
|
16
|
+
header?: string;
|
|
17
|
+
/** Make an ID when the request has none. Defaults to `crypto.randomUUID`. */
|
|
18
|
+
generate?: () => string;
|
|
19
|
+
};
|
|
20
|
+
/**
|
|
21
|
+
* A Fastify `genReqId` that reuses a safe incoming header (so an ID set by a
|
|
22
|
+
* proxy or the calling service carries through) or generates a new one.
|
|
23
|
+
*/
|
|
24
|
+
export declare function createRequestIdGenerator(header?: string, generate?: () => string): (req: IncomingMessage) => string;
|
|
25
|
+
/**
|
|
26
|
+
* Echo the request ID on the response and make it available through
|
|
27
|
+
* {@link getRequestId} for the rest of the request.
|
|
28
|
+
*/
|
|
29
|
+
export declare function installRequestContext(app: FastifyInstance, header?: string): void;
|
|
@@ -0,0 +1,54 @@
|
|
|
1
|
+
"use strict";
|
|
2
|
+
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
+
exports.DEFAULT_REQUEST_ID_HEADER = void 0;
|
|
4
|
+
exports.getRequestId = getRequestId;
|
|
5
|
+
exports.createRequestIdGenerator = createRequestIdGenerator;
|
|
6
|
+
exports.installRequestContext = installRequestContext;
|
|
7
|
+
/**
|
|
8
|
+
* @copyright 2024
|
|
9
|
+
* @author Tareq Hossain
|
|
10
|
+
* @email xtrinsic96@gmail.com
|
|
11
|
+
* @url https://github.com/xtareq
|
|
12
|
+
*/
|
|
13
|
+
const async_hooks_1 = require("async_hooks");
|
|
14
|
+
const crypto_1 = require("crypto");
|
|
15
|
+
const storage = new async_hooks_1.AsyncLocalStorage();
|
|
16
|
+
/** The default header that carries the request ID in and out. */
|
|
17
|
+
exports.DEFAULT_REQUEST_ID_HEADER = "x-request-id";
|
|
18
|
+
/** Accept a client-sent ID only if it is short and log-safe. */
|
|
19
|
+
const SAFE_ID = /^[\w.:-]{1,128}$/;
|
|
20
|
+
/**
|
|
21
|
+
* The ID of the request being handled, or `undefined` outside a request.
|
|
22
|
+
* Works anywhere in the request's async call chain: services, repositories,
|
|
23
|
+
* event listeners.
|
|
24
|
+
*
|
|
25
|
+
* logger.info({ requestId: getRequestId() }, "charging card");
|
|
26
|
+
*/
|
|
27
|
+
function getRequestId() {
|
|
28
|
+
return storage.getStore()?.requestId;
|
|
29
|
+
}
|
|
30
|
+
/**
|
|
31
|
+
* A Fastify `genReqId` that reuses a safe incoming header (so an ID set by a
|
|
32
|
+
* proxy or the calling service carries through) or generates a new one.
|
|
33
|
+
*/
|
|
34
|
+
function createRequestIdGenerator(header = exports.DEFAULT_REQUEST_ID_HEADER, generate = crypto_1.randomUUID) {
|
|
35
|
+
const name = header.toLowerCase();
|
|
36
|
+
return (req) => {
|
|
37
|
+
const incoming = req.headers[name];
|
|
38
|
+
const value = Array.isArray(incoming) ? incoming[0] : incoming;
|
|
39
|
+
return value && SAFE_ID.test(value) ? value : generate();
|
|
40
|
+
};
|
|
41
|
+
}
|
|
42
|
+
/**
|
|
43
|
+
* Echo the request ID on the response and make it available through
|
|
44
|
+
* {@link getRequestId} for the rest of the request.
|
|
45
|
+
*/
|
|
46
|
+
function installRequestContext(app, header = exports.DEFAULT_REQUEST_ID_HEADER) {
|
|
47
|
+
// A callback hook with `run(…, done)`: everything Fastify does after
|
|
48
|
+
// `done()` (the remaining hooks, the handler) runs inside the store.
|
|
49
|
+
app.addHook("onRequest", (request, reply, done) => {
|
|
50
|
+
reply.header(header, request.id);
|
|
51
|
+
storage.run({ requestId: String(request.id) }, done);
|
|
52
|
+
});
|
|
53
|
+
}
|
|
54
|
+
//# sourceMappingURL=request-context.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"request-context.js","sourceRoot":"","sources":["../../src/observability/request-context.ts"],"names":[],"mappings":";;;AA8BA,oCAEC;AAgBD,4DAUC;AAMD,sDAUC;AA1ED;;;;;GAKG;AACH,6CAAgD;AAChD,mCAAoC;AAQpC,MAAM,OAAO,GAAG,IAAI,+BAAiB,EAAgB,CAAC;AAEtD,iEAAiE;AACpD,QAAA,yBAAyB,GAAG,cAAc,CAAC;AAExD,gEAAgE;AAChE,MAAM,OAAO,GAAG,kBAAkB,CAAC;AAEnC;;;;;;GAMG;AACH,SAAgB,YAAY;IAC1B,OAAO,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,CAAC;AACvC,CAAC;AAYD;;;GAGG;AACH,SAAgB,wBAAwB,CACtC,SAAiB,iCAAyB,EAC1C,WAAyB,mBAAU;IAEnC,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QAC/D,OAAO,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC;IAC3D,CAAC,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CACnC,GAAoB,EACpB,SAAiB,iCAAyB;IAE1C,qEAAqE;IACrE,qEAAqE;IACrE,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;QAChD,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QACjC,OAAO,CAAC,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IACvD,CAAC,CAAC,CAAC;AACL,CAAC"}
|
|
@@ -32,8 +32,6 @@ export type ClassSchemaOptions = {
|
|
|
32
32
|
* them, or `{ components }` to collect their schemas.
|
|
33
33
|
*/
|
|
34
34
|
export declare function generateClassSchema(classType: any, options?: ClassSchemaOptions): any;
|
|
35
|
-
/** @deprecated Use {@link generateClassSchema}; this is an alias. */
|
|
36
|
-
export declare const CreateSwaggerObjectSchema: typeof generateClassSchema;
|
|
37
35
|
/**
|
|
38
36
|
* Replace every `#/components/schemas/X` `$ref` in `schema` whose class was
|
|
39
37
|
* seen by {@link generateClassSchema} with that class's inline schema.
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
"use strict";
|
|
2
2
|
Object.defineProperty(exports, "__esModule", { value: true });
|
|
3
|
-
exports.CreateSwaggerObjectSchema = void 0;
|
|
4
3
|
exports.OpenApiProperty = OpenApiProperty;
|
|
5
4
|
exports.generateClassSchema = generateClassSchema;
|
|
6
5
|
exports.inlineSchemaRefs = inlineSchemaRefs;
|
|
@@ -15,6 +14,7 @@ exports.OpenApiResponse = OpenApiResponse;
|
|
|
15
14
|
const class_validator_1 = require("class-validator");
|
|
16
15
|
const container_1 = require("../common/container");
|
|
17
16
|
const schema_properties_1 = require("./schema-properties");
|
|
17
|
+
const metadata_1 = require("../validator/metadata");
|
|
18
18
|
// Decorator to add OpenAPI metadata to properties
|
|
19
19
|
function OpenApiProperty(options) {
|
|
20
20
|
return function (target, propertyKey) {
|
|
@@ -138,6 +138,17 @@ function nestedSchema(type, options, stack) {
|
|
|
138
138
|
}
|
|
139
139
|
return { $ref: `#/components/schemas/${name}` };
|
|
140
140
|
}
|
|
141
|
+
/** The class given with Megh's `@Type(() => X)`, if any. */
|
|
142
|
+
function getMeghType(classType, key) {
|
|
143
|
+
try {
|
|
144
|
+
const rule = (0, metadata_1.findTypeRule)(classType, key);
|
|
145
|
+
const t = rule?.typeFunction?.();
|
|
146
|
+
return typeof t === "function" ? t : undefined;
|
|
147
|
+
}
|
|
148
|
+
catch {
|
|
149
|
+
return undefined;
|
|
150
|
+
}
|
|
151
|
+
}
|
|
141
152
|
function collectPropertyNames(classType, validationMetadata) {
|
|
142
153
|
const names = new Set();
|
|
143
154
|
for (const key of (0, schema_properties_1.getRegisteredSchemaProperties)(classType))
|
|
@@ -148,6 +159,8 @@ function collectPropertyNames(classType, validationMetadata) {
|
|
|
148
159
|
}
|
|
149
160
|
for (const key of (0, schema_properties_1.getTransformerProperties)(classType))
|
|
150
161
|
names.add(key);
|
|
162
|
+
for (const key of (0, metadata_1.getTransformedProperties)(classType))
|
|
163
|
+
names.add(key);
|
|
151
164
|
names.delete("constructor");
|
|
152
165
|
names.delete("");
|
|
153
166
|
return [...names];
|
|
@@ -157,14 +170,19 @@ function buildClassSchema(classType, options, stack) {
|
|
|
157
170
|
if (!classType || !classType.prototype)
|
|
158
171
|
return schema;
|
|
159
172
|
const innerStack = new Set(stack).add(classType);
|
|
160
|
-
const validationMetadata =
|
|
173
|
+
const validationMetadata = [
|
|
174
|
+
...((0, class_validator_1.getMetadataStorage)().getTargetValidationMetadatas(classType, "", true, false) ?? []),
|
|
175
|
+
// Megh's decorators: same names and constraints as class-validator's.
|
|
176
|
+
...(0, metadata_1.getValidationRules)(classType),
|
|
177
|
+
];
|
|
161
178
|
const prototype = classType.prototype;
|
|
162
179
|
for (const propertyName of collectPropertyNames(classType, validationMetadata)) {
|
|
163
180
|
const openApiMeta = Reflect.getMetadata("property:openapi", prototype, propertyName);
|
|
164
181
|
if (openApiMeta?.exclude)
|
|
165
182
|
continue;
|
|
166
183
|
const propertyType = Reflect.getMetadata("design:type", prototype, propertyName);
|
|
167
|
-
const elementType = (0, schema_properties_1.getTransformerType)(classType, propertyName)
|
|
184
|
+
const elementType = (0, schema_properties_1.getTransformerType)(classType, propertyName) ??
|
|
185
|
+
getMeghType(classType, propertyName);
|
|
168
186
|
let swaggerProperty = {};
|
|
169
187
|
switch (propertyType) {
|
|
170
188
|
case String:
|
|
@@ -303,8 +321,6 @@ function buildClassSchema(classType, options, stack) {
|
|
|
303
321
|
function generateClassSchema(classType, options = {}) {
|
|
304
322
|
return buildClassSchema(classType, options, new Set());
|
|
305
323
|
}
|
|
306
|
-
/** @deprecated Use {@link generateClassSchema}; this is an alias. */
|
|
307
|
-
exports.CreateSwaggerObjectSchema = generateClassSchema;
|
|
308
324
|
/**
|
|
309
325
|
* Replace every `#/components/schemas/X` `$ref` in `schema` whose class was
|
|
310
326
|
* seen by {@link generateClassSchema} with that class's inline schema.
|