@nestia/core 14.0.0 → 14.0.1

package/lib/adaptors/internal/RoutePathMatcher.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoutePathMatcher = void 0;
+const path_to_regexp_1 = require("path-to-regexp");
+/**
+ * A WebSocket route's path, matched as NestJS 11's Express router matches an
+ * HTTP route: path-to-regexp 8's syntax, where `\:` is a literal colon, `*name`
+ * a wildcard, and `{...}` an optional group; find-my-way's (Fastify) literal
+ * colon `::` is read too, as `@nestia/sdk` reads it when it builds the SDK's
+ * URL.
+ *
+ * @internal
+ */
+class RoutePathMatcher {
+    constructor(path) {
+        this.path = path;
+        const route = fromFastifyColons(path);
+        this.params = names((0, path_to_regexp_1.parse)(route).tokens);
+        this.match_ = (0, path_to_regexp_1.match)(route, {
+            decode: (value) => {
+                try {
+                    return decodeURIComponent(value);
+                }
+                catch (_a) {
+                    return value;
+                }
+            },
+        });
+    }
+    /**
+     * The parameters of a matching request path, or `null`. A wildcard's segments
+     * are joined by `/`, and an optional parameter absent is left out.
+     */
+    test(path) {
+        const matched = this.match_(path);
+        if (matched === false)
+            return null;
+        const output = {};
+        for (const [key, value] of Object.entries(matched.params))
+            if (value !== undefined)
+                output[key] = Array.isArray(value) ? value.join("/") : value;
+        return output;
+    }
+    toString() {
+        return this.path;
+    }
+}
+exports.RoutePathMatcher = RoutePathMatcher;
+const names = (tokens) => tokens.flatMap((token) => token.type === "param" || token.type === "wildcard"
+    ? [token.name]
+    : token.type === "group"
+        ? names(token.tokens)
+        : []);
+/**
+ * A route with find-my-way's (Fastify) literal colon `::` spelled as
+ * path-to-regexp's `\:`. find-my-way reads `::` as a colon in static text
+ * alone: after a parameter it is part of the parameter's name, so it is left as
+ * is there, and path-to-regexp then rejects the route, as no parameter of that
+ * name is what the handler reads.
+ *
+ * @internal
+ */
+const fromFastifyColons = (route) => {
+    let output = "";
+    for (let i = 0; i < route.length;) {
+        if (route[i] === "\\") {
+            output += route.slice(i, i + 2);
+            i += 2;
+        }
+        else if (route.startsWith("::", i)) {
+            output += "\\:";
+            i += 2;
+        }
+        else if (route[i] === ":") {
+            const name = /^:[A-Za-z0-9_$]*/.exec(route.slice(i))[0];
+            output += name;
+            i += name.length;
+            if (route.startsWith("::", i)) {
+                output += "::";
+                i += 2;
+            }
+        }
+        else
+            output += route[i++];
+    }
+    return output;
+};
+//# sourceMappingURL=RoutePathMatcher.js.map

package/lib/adaptors/internal/RoutePathMatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RoutePathMatcher.js","sourceRoot":"","sources":["../../../src/adaptors/internal/RoutePathMatcher.ts"],"names":[],"mappings":"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"}

package/lib/adaptors/internal/external_context.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/adaptors/internal/external_context.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.get_request_context_id = exports.create_external_context_creator = void 0;
+const core_1 = require("@nestjs/core");
+const external_context_creator_1 = require("@nestjs/core/helpers/external-context-creator");
+const request_constants_1 = require("@nestjs/core/router/request/request-constants");
+/**
+ * The creator of NestJS's enhancer pipeline (guards, interceptors, pipes, and
+ * exception filters) for the controllers of one module.
+ *
+ * `ExternalContextCreator` looks the module up among those providing the class,
+ * and a controller is provided by none, so its enhancers would not resolve: the
+ * module is named here instead.
+ *
+ * @internal
+ */
+const create_external_context_creator = (container, moduleKey) => {
+    const creator = external_context_creator_1.ExternalContextCreator.fromContainer(container);
+    creator.getContextModuleKey = () => moduleKey;
+    return creator;
+};
+exports.create_external_context_creator = create_external_context_creator;
+/**
+ * The context a request-scoped provider is built in for this request, the one
+ * NestJS's router attaches to it, registering the request as `REQUEST`.
+ *
+ * @internal
+ */
+const get_request_context_id = (container, request, durable) => {
+    const contextId = core_1.ContextIdFactory.getByRequest(request);
+    if (!request[request_constants_1.REQUEST_CONTEXT_ID]) {
+        Object.defineProperty(request, request_constants_1.REQUEST_CONTEXT_ID, {
+            value: contextId,
+            enumerable: false,
+            writable: false,
+            configurable: false,
+        });
+        container.registerRequestProvider(durable ? contextId.payload : Object.assign(request, contextId.payload), contextId);
+    }
+    return contextId;
+};
+exports.get_request_context_id = get_request_context_id;
+//# sourceMappingURL=external_context.js.map

package/lib/adaptors/internal/external_context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"external_context.js","sourceRoot":"","sources":["../../../src/adaptors/internal/external_context.ts"],"names":[],"mappings":";;;AAAA,uCAA0E;AAC1E,4FAAuF;AACvF,qFAAmF;AAEnF;;;;;;;;;GASG;AACI,MAAM,+BAA+B,GAAG,CAC7C,SAAwB,EACxB,SAAiB,EACO,EAAE;IAC1B,MAAM,OAAO,GACX,iDAAsB,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC;IAClD,OAAO,CAAC,mBAAmB,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC;IAC9C,OAAO,OAAO,CAAC;AACjB,CAAC,CAAC;AARW,QAAA,+BAA+B,GAA/B,+BAA+B,CAQ1C;AAEF;;;;;GAKG;AACI,MAAM,sBAAsB,GAAG,CACpC,SAAwB,EACxB,OAAY,EACZ,OAAgB,EACL,EAAE;IACb,MAAM,SAAS,GAAc,uBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;IACpE,IAAI,CAAC,OAAO,CAAC,sCAAkB,CAAC,EAAE,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,sCAAkB,EAAE;YACjD,KAAK,EAAE,SAAS;YAChB,UAAU,EAAE,KAAK;YACjB,QAAQ,EAAE,KAAK;YACf,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QACH,SAAS,CAAC,uBAAuB,CAC/B,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,OAAO,CAAC,EACvE,SAAS,CACV,CAAC;IACJ,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC,CAAC;AAnBW,QAAA,sBAAsB,GAAtB,sBAAsB,CAmBjC"}

package/lib/decorators/EncryptedBody.js

@@ -13,7 +13,7 @@ exports.EncryptedBody = EncryptedBody;
 const AesPkcs5_1 = require("@nestia/fetcher/lib/AesPkcs5");
 const common_1 = require("@nestjs/common");
 const Singleton_1 = require("../utils/Singleton");
-const EncryptedConstant_1 = require("./internal/EncryptedConstant");
+const get_encryption_password_1 = require("./internal/get_encryption_password");
 const get_text_body_1 = require("./internal/get_text_body");
 const headers_to_object_1 = require("./internal/headers_to_object");
 const is_media_type_1 = require("./internal/is_media_type");
@@ -48,7 +48,7 @@ function EncryptedBody(validator) {
                 .getRequest();
             if ((0, is_media_type_1.is_media_type)(request.headers["content-type"], "text/plain") === false)
                 throw new common_1.BadRequestException(`Request body type is not "text/plain".`);
-            const param = Reflect.getMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, context.getClass());
+            const param = (0, get_encryption_password_1.get_encryption_password)(context.getClass());
             if (!param)
                 throw new Error("Error on nestia.core.EncryptedBody(): no encryption password is given.");
             // GET BODY DATA

package/lib/decorators/EncryptedBody.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptedBody.js","sourceRoot":"","sources":["../../src/decorators/EncryptedBody.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,2DAAwD;AACxD,2CAIwB;AAKxB,kDAA+C;AAC/C,oEAAuE;AACvE,4DAAyD;AACzD,oEAAiE;AACjE,4DAAyD;AACzD,4EAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBACE,SAAoC;IAEpC,MAAM,OAAO,GAAG,IAAA,6CAAqB,EAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC;IAClE,OAAO,IAAA,6BAAoB,EAAC,SAAe,aAAa,CACtD,QAAa,EACb,OAAyB;;YAEzB,MAAM,OAAO,GAAqC,OAAO;iBACtD,YAAY,EAAE;iBACd,UAAU,EAAE,CAAC;YAChB,IAAI,IAAA,6BAAa,EAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,KAAK,KAAK;gBACxE,MAAM,IAAI,4BAAmB,CAAC,wCAAwC,CAAC,CAAC;YAE1E,MAAM,KAAK,GACT,OAAO,CAAC,WAAW,CAAC,2CAAuB,EAAE,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YACnE,IAAI,CAAC,KAAK;gBACR,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;YAEJ,gBAAgB;YAChB,MAAM,OAAO,GAAsC,IAAI,qBAAS,CAAC,GAAG,EAAE,CACpE,IAAA,qCAAiB,EAAC,OAAO,CAAC,OAAO,CAAC,CACnC,CAAC;YACF,MAAM,IAAI,GAAW,MAAM,IAAA,6BAAa,EAAC,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,UAAU;gBACzB,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;gBAC9D,CAAC,CAAC,KAAK,CAAC;YAEZ,0BAA0B;YAC1B,MAAM,IAAI,GAAQ,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAiB,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,KAAK,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;KAAA,CAAC,EAAE,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU,EAAW,EAAE;IAChE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK;YACtB,MAAM,IAAI,4BAAmB,CAC3B,qFAAqF,CACtF,CAAC;;YACC,MAAM,GAAG,CAAC;IACjB,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"EncryptedBody.js","sourceRoot":"","sources":["../../src/decorators/EncryptedBody.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,2DAAwD;AACxD,2CAIwB;AAKxB,kDAA+C;AAC/C,gFAA6E;AAC7E,4DAAyD;AACzD,oEAAiE;AACjE,4DAAyD;AACzD,4EAAyE;AAEzE;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,uBACE,SAAoC;IAEpC,MAAM,OAAO,GAAG,IAAA,6CAAqB,EAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC;IAClE,OAAO,IAAA,6BAAoB,EAAC,SAAe,aAAa,CACtD,QAAa,EACb,OAAyB;;YAEzB,MAAM,OAAO,GAAqC,OAAO;iBACtD,YAAY,EAAE;iBACd,UAAU,EAAE,CAAC;YAChB,IAAI,IAAA,6BAAa,EAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,EAAE,YAAY,CAAC,KAAK,KAAK;gBACxE,MAAM,IAAI,4BAAmB,CAAC,wCAAwC,CAAC,CAAC;YAE1E,MAAM,KAAK,GACT,IAAA,iDAAuB,EAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC9C,IAAI,CAAC,KAAK;gBACR,MAAM,IAAI,KAAK,CACb,wEAAwE,CACzE,CAAC;YAEJ,gBAAgB;YAChB,MAAM,OAAO,GAAsC,IAAI,qBAAS,CAAC,GAAG,EAAE,CACpE,IAAA,qCAAiB,EAAC,OAAO,CAAC,OAAO,CAAC,CACnC,CAAC;YACF,MAAM,IAAI,GAAW,MAAM,IAAA,6BAAa,EAAC,OAAO,CAAC,CAAC;YAClD,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,UAAU;gBACzB,CAAC,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;gBAC9D,CAAC,CAAC,KAAK,CAAC;YAEZ,0BAA0B;YAC1B,MAAM,IAAI,GAAQ,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;YAC1D,MAAM,KAAK,GAAiB,OAAO,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK,KAAK,IAAI;gBAAE,MAAM,KAAK,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;KAAA,CAAC,EAAE,CAAC;AACP,CAAC;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,GAAG,CAAC,IAAY,EAAE,GAAW,EAAE,EAAU,EAAW,EAAE;IAChE,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,mBAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,GAAG,YAAY,KAAK;YACtB,MAAM,IAAI,4BAAmB,CAC3B,qFAAqF,CACtF,CAAC;;YACC,MAAM,GAAG,CAAC;IACjB,CAAC;AACH,CAAC,CAAC"}

package/lib/decorators/EncryptedController.js

@@ -31,7 +31,7 @@ const EncryptedConstant_1 = require("./internal/EncryptedConstant");
  */
 function EncryptedController(path, password) {
     return function (target) {
-        Reflect.defineMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, password, target);
+        Reflect.defineMetadata(EncryptedConstant_1.ENCRYPTION_CONTROLLER_METADATA_KEY, password, target);
         (0, common_1.Controller)(path)(target);
     };
 }

package/lib/decorators/EncryptedController.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptedController.js","sourceRoot":"","sources":["../../src/decorators/EncryptedController.ts"],"names":[],"mappings":";;;AACA,2CAA4C;AAE5C,oEAAuE;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,6BACE,IAAY,EACZ,QAA2D;IAE3D,OAAO,UAAU,MAAW;QAC1B,OAAO,CAAC,cAAc,CAAC,2CAAuB,EAAE,QAAQ,EAAE,MAAM,CAAC,CAAC;QAClE,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}
+{"version":3,"file":"EncryptedController.js","sourceRoot":"","sources":["../../src/decorators/EncryptedController.ts"],"names":[],"mappings":";;;AACA,2CAA4C;AAE5C,oEAAkF;AAElF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,6BACE,IAAY,EACZ,QAA2D;IAE3D,OAAO,UAAU,MAAW;QAC1B,OAAO,CAAC,cAAc,CACpB,sDAAkC,EAClC,QAAQ,EACR,MAAM,CACP,CAAC;QACF,IAAA,mBAAU,EAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3B,CAAC,CAAC;AACJ,CAAC"}

package/lib/decorators/EncryptedModule.d.ts

@@ -11,9 +11,13 @@ import { Module } from "@nestjs/common";
  *
  * By using this `EncryptedModule` decorator function, all of the
  * {@link Controller controllers} configured in the _metadata_ would be
- * automatically changed to the {@link EncryptedController} with the _password_.
- * If there're some original {@link EncryptedController} decorated classes in the
- * _metadata_, their encryption password would be kept.
+ * automatically changed to the {@link EncryptedController} with the _password_,
+ * and so would the controllers of every module it imports: module classes,
+ * dynamic modules (`{ module, imports, controllers }`), `forwardRef()`s, and
+ * promises of them, however deep and even when cyclic. If there're some
+ * original {@link EncryptedController} decorated classes in the _metadata_,
+ * their encryption password would be kept, as would a subclass's that inherits
+ * one.
  *
  * Therefore, if you're planning to place original {@link EncryptedController}
  * decorated classes in the _metadata_, I hope them to have different encryption

package/lib/decorators/EncryptedModule.js

@@ -62,9 +62,13 @@ const load_controller_1 = require("./internal/load_controller");
  *
  * By using this `EncryptedModule` decorator function, all of the
  * {@link Controller controllers} configured in the _metadata_ would be
- * automatically changed to the {@link EncryptedController} with the _password_.
- * If there're some original {@link EncryptedController} decorated classes in the
- * _metadata_, their encryption password would be kept.
+ * automatically changed to the {@link EncryptedController} with the _password_,
+ * and so would the controllers of every module it imports: module classes,
+ * dynamic modules (`{ module, imports, controllers }`), `forwardRef()`s, and
+ * promises of them, however deep and even when cyclic. If there're some
+ * original {@link EncryptedController} decorated classes in the _metadata_,
+ * their encryption password would be kept, as would a subclass's that inherits
+ * one.
  *
  * Therefore, if you're planning to place original {@link EncryptedController}
  * decorated classes in the _metadata_, I hope them to have different encryption
@@ -128,17 +132,67 @@ function EncryptedModule(metadata, password) {
     }
     EncryptedModule.dynamic = dynamic;
 })(EncryptedModule || (exports.EncryptedModule = EncryptedModule = {}));
-/** @internal */
-const iterate = (password) => (modulo) => {
-    const imports = Reflect.getMetadata("imports", modulo);
-    if (Array.isArray(imports))
-        for (const imp of imports)
-            if (typeof imp === "function")
-                iterate(password)(imp);
-    const controllers = Reflect.getMetadata("controllers", modulo);
-    if (Array.isArray(controllers))
-        for (const c of controllers)
-            if (typeof c === "function")
-                Reflect.defineMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, password, c);
+/**
+ * Gives every controller the module reaches the module's password: those of the
+ * module itself and of each import, whether a module class, a dynamic module
+ * (its `module`, and its own `imports` and `controllers`), a `forwardRef()`, or
+ * a promise of one. Each module is visited once, so a cyclic import graph
+ * terminates.
+ *
+ * @internal
+ */
+const iterate = (password) => {
+    const visited = new Set();
+    const controllers = (list) => {
+        if (Array.isArray(list))
+            for (const c of list)
+                if (typeof c === "function")
+                    Reflect.defineMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, password, c);
+    };
+    const imports = (list) => {
+        if (Array.isArray(list))
+            for (const imp of list)
+                visit(imp);
+    };
+    const visit = (input) => {
+        if (typeof input !== "function" &&
+            (typeof input !== "object" || input === null))
+            return;
+        if (visited.has(input))
+            return;
+        visited.add(input);
+        if (typeof input === "function") {
+            imports(Reflect.getMetadata("imports", input));
+            controllers(Reflect.getMetadata("controllers", input));
+        }
+        else if (typeof input.then === "function")
+            // an asynchronous dynamic module; NestJS awaits the same promise while
+            // scanning, after this callback, registered first, has run
+            input.then(visit, () => { });
+        else if (typeof input.forwardRef === "function") {
+            // the class a forward reference names may not be defined yet while the
+            // decorators run; it is once the synchronous module graph has loaded
+            const resolve = () => {
+                try {
+                    return input.forwardRef();
+                }
+                catch (_a) {
+                    return undefined;
+                }
+            };
+            const target = resolve();
+            if (target !== undefined)
+                visit(target);
+            else
+                void Promise.resolve().then(() => visit(resolve()));
+        }
+        else {
+            const dynamic = input;
+            visit(dynamic.module);
+            imports(dynamic.imports);
+            controllers(dynamic.controllers);
+        }
+    };
+    return visit;
 };
 //# sourceMappingURL=EncryptedModule.js.map

package/lib/decorators/EncryptedModule.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptedModule.js","sourceRoot":"","sources":["../../src/decorators/EncryptedModule.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AACA,2CAAwC;AAGxC,oEAAuE;AACvE,gEAA8D;AAE9D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,yBACE,QAAsC,EACtC,QAAqC;IAErC,OAAO,UAAU,MAAW;QAC1B,IAAA,eAAM,EAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;QACzB,OAAO,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC,CAAC;AACJ,CAAC;AAED,WAAiB,eAAe;IAC9B;;;;;;;;;;;;OAYG;IACH,SAAsB,OAAO;6DAC3B,IAAmE,EACnE,QAA2D,EAC3D,OAAO,GAAsD,EAAE,EAC/D,QAAkB;YAElB,mBAAmB;YACnB,MAAM,WAAW,GAAsB,MAAM,IAAA,kCAAgB,EAC3D,IAAI,EACJ,QAAQ,CACT,CAAC;YAEF,0BAA0B;gBAKpB,YAAY;wCAJjB,eAAe,iCACT,OAAO,KAAE,WAAW,KACzB,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CACzD;;;;;;;;;oBACD,6KAAqB;;;oBAAf,uDAAY;;;;YAClB,OAAO,YAAY,CAAC;QACtB,CAAC;KAAA;IAnBqB,gBAAA,OAAO,UAmB5B,CAAA;AACH,CAAC,EAlCgB,eAAe,aAVhB,eAAe,GAUd,eAAe,QAkC/B;AAED,gBAAgB;AAChB,MAAM,OAAO,GACX,CAAC,QAAqC,EAAE,EAAE,CAC1C,CAAC,MAAW,EAAQ,EAAE;IACpB,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QACxB,KAAK,MAAM,GAAG,IAAI,OAAO;YACvB,IAAI,OAAO,GAAG,KAAK,UAAU;gBAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC;IAE1D,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC/D,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAC5B,KAAK,MAAM,CAAC,IAAI,WAAW;YACzB,IAAI,OAAO,CAAC,KAAK,UAAU;gBACzB,OAAO,CAAC,cAAc,CAAC,2CAAuB,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC"}
+{"version":3,"file":"EncryptedModule.js","sourceRoot":"","sources":["../../src/decorators/EncryptedModule.ts"],"names":[],"mappings":"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"}

package/lib/decorators/EncryptedRoute.js

@@ -10,7 +10,7 @@ const operators_1 = require("rxjs/operators");
 const typia_1 = __importDefault(require("typia"));
 const Singleton_1 = require("../utils/Singleton");
 const TypedRoute_1 = require("./TypedRoute");
-const EncryptedConstant_1 = require("./internal/EncryptedConstant");
+const get_encryption_password_1 = require("./internal/get_encryption_password");
 const get_path_and_stringify_1 = require("./internal/get_path_and_stringify");
 const headers_to_object_1 = require("./internal/headers_to_object");
 const route_error_1 = require("./internal/route_error");
@@ -124,7 +124,7 @@ class EncryptedRouteInterceptor {
     intercept(context, next) {
         const http = context.switchToHttp();
         return next.handle().pipe((0, operators_1.map)((value) => {
-            const param = Reflect.getMetadata(EncryptedConstant_1.ENCRYPTION_METADATA_KEY, context.getClass());
+            const param = (0, get_encryption_password_1.get_encryption_password)(context.getClass());
             if (!param)
                 throw new Error(`Error on EncryptedRoute.${this.method}(): no password found.`);
             const request = http.getRequest();
@@ -139,6 +139,11 @@ class EncryptedRouteInterceptor {
                 : param;
             if (body === undefined)
                 return body;
+            // the ciphertext is text/plain, as the document declares; set on the
+            // success path alone, so an error keeps its JSON body's type (Express
+            // would otherwise send a string as text/html)
+            const response = http.getResponse();
+            response.header("Content-Type", "text/plain");
             return AesPkcs5_1.AesPkcs5.encrypt(body, password.key, password.iv);
         }), (0, operators_1.catchError)((err) => (0, route_error_1.route_error)(http.getRequest(), err)));
     }

package/lib/decorators/EncryptedRoute.js.map

@@ -1 +1 @@
-{"version":3,"file":"EncryptedRoute.js","sourceRoot":"","sources":["../../src/decorators/EncryptedRoute.ts"],"names":[],"mappings":";;;;;;AACA,2DAAwD;AACxD,2CAWwB;AAGxB,8CAAiD;AACjD,kDAA0B;AAG1B,kDAA+C;AAC/C,6CAA0C;AAC1C,oEAAuE;AACvE,8EAA2E;AAC3E,oEAAiE;AACjE,wDAAqD;AAErD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,IAAiB,cAAc,CAsF9B;AAtFD,WAAiB,cAAc;IAC7B;;;;;OAKG;IACU,kBAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEpC;;;;;OAKG;IACU,mBAAI,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IAEtC;;;;;OAKG;IACU,oBAAK,GAAG,SAAS,CAAC,OAAO,CAAC,CAAC;IAExC;;;;;OAKG;IACU,kBAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;IAEpC;;;;;OAKG;IACU,qBAAM,GAAG,SAAS,CAAC,QAAQ,CAAC,CAAC;IAE1C;;;;;;;;;;;;;;OAcG;IACH,SAAgB,sBAAsB,CACpC,IAAsC;QAEtC,uBAAU,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAJe,eAAA,sBAAsB,yBAIrC,CAAA;IAID,gBAAgB;IAChB,SAAS,SAAS,CAAC,MAAmD;QAUpE,SAAS,KAAK,CAAC,GAAG,IAAW;YAC3B,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,GAAG,IAAA,+CAAsB,EAC9C,GAAG,EAAE,CAAC,uBAAU,CAAC,QAAQ,CAC1B,CAAC,kBAAkB,MAAM,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;YACvC,OAAO,IAAA,wBAAe,EACpB,OAAO,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EACrB,IAAA,wBAAe,EAAC,IAAI,yBAAyB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC,CAClE,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,EAtFgB,cAAc,aAAd,cAAc,GAAd,cAAc,QAsF9B;AAED,KAAK,MAAM,MAAM,IAAI;IACnB,eAAK,CAAC,IAAI,CAAC,WAAW;IACtB,eAAK,CAAC,IAAI,CAAC,eAAe;IAC1B,eAAK,CAAC,IAAI,CAAC,iBAAiB;IAC5B,eAAK,CAAC,IAAI,CAAC,SAAS;CACrB;IACC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC;QAC/C,KAAK,MAAM,IAAI,IAAI;YACjB,cAAc,CAAC,GAAG;YAClB,cAAc,CAAC,MAAM;YACrB,cAAc,CAAC,IAAI;YACnB,cAAc,CAAC,GAAG;YAClB,cAAc,CAAC,KAAK;SACrB;YACE,IAAY,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;AAEjC,gBAAgB;AAChB,MAAM,yBAAyB;IAC7B,YACmB,MAAc,EACd,SAIN;sBALM,MAAM;yBACN,SAAS;IAKzB,CAAC;IAEG,SAAS,CAAC,OAAyB,EAAE,IAAiB;QAC3D,MAAM,IAAI,GAAsB,OAAO,CAAC,YAAY,EAAE,CAAC;QACvD,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CACvB,IAAA,eAAG,EAAC,CAAC,KAAK,EAAE,EAAE;YACZ,MAAM,KAAK,GAGK,OAAO,CAAC,WAAW,CACjC,2CAAuB,EACvB,OAAO,CAAC,QAAQ,EAAE,CACnB,CAAC;YACF,IAAI,CAAC,KAAK;gBACR,MAAM,IAAI,KAAK,CACb,2BAA2B,IAAI,CAAC,MAAM,wBAAwB,CAC/D,CAAC;YAEJ,MAAM,OAAO,GAAoB,IAAI,CAAC,UAAU,EAAE,CAAC;YACnD,MAAM,OAAO,GAAsC,IAAI,qBAAS,CAAC,GAAG,EAAE,CACpE,IAAA,qCAAiB,EAAC,OAAO,CAAC,OAAO,CAAC,CACnC,CAAC;YACF,MAAM,IAAI,GAAuB,IAAI,CAAC,SAAS,CAC7C,KAAK,EACL,OAAO,CAAC,MAAM,EACd,OAAO,CAAC,GAAG,CACZ,CAAC;YACF,MAAM,QAAQ,GACZ,OAAO,KAAK,KAAK,UAAU;gBACzB,CAAC,CAAC,KAAK,CAAC;oBACJ,OAAO,EAAE,OAAO,CAAC,GAAG,EAAE;oBACtB,IAAI;oBACJ,SAAS,EAAE,QAAQ;iBACpB,CAAC;gBACJ,CAAC,CAAC,KAAK,CAAC;YAEZ,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,IAAI,CAAC;YACpC,OAAO,mBAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC;QAC3D,CAAC,CAAC,EACF,IAAA,sBAAU,EAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,yBAAW,EAAC,IAAI,CAAC,UAAU,EAAE,EAAE,GAAG,CAAC,CAAC,CACzD,CAAC;IACJ,CAAC;CACF;AAED,gBAAgB;AAChB,MAAM,OAAO,GAAG;IACd,GAAG,EAAH,YAAG;IACH,IAAI,EAAJ,aAAI;IACJ,GAAG,EAAH,YAAG;IACH,KAAK,EAAL,cAAK;IACL,MAAM,EAAN,eAAM;CACP,CAAC"}
+{"version":3,"file":"EncryptedRoute.js","sourceRoot":"","sources":["../../src/decorators/EncryptedRoute.ts"],"names":[],"mappings":"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"}

package/lib/decorators/TypedBody.d.ts

@@ -11,6 +11,6 @@ import { IRequestBodyValidator } from "../options/IRequestBodyValidator";
  * `T`, `BadRequestException` error (status code: 400) would be thrown.
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param validator Custom validator if required. Default is `typia.assert()`
+ * @param validator Custom validator if required. Default is `typia.validate()`
  */
 export declare function TypedBody<T>(validator?: IRequestBodyValidator<T>): ParameterDecorator;

package/lib/decorators/TypedBody.js

@@ -17,7 +17,7 @@ const validate_request_body_1 = require("./internal/validate_request_body");
  * `T`, `BadRequestException` error (status code: 400) would be thrown.
  *
  * @author Jeongho Nam - https://github.com/samchon
- * @param validator Custom validator if required. Default is `typia.assert()`
+ * @param validator Custom validator if required. Default is `typia.validate()`
  */
 function TypedBody(validator) {
     const checker = (0, validate_request_body_1.validate_request_body)("TypedBody")(validator);

package/lib/decorators/TypedFormData.d.ts

@@ -21,10 +21,13 @@
  *    types are allowed
  * 4. By the way, union type never be not allowed
  *
- * By the way, if you're using `fastify`, you have to setup `fastify-multer` and
- * configure like below when composing the NestJS application. If you don't do
- * that, `@TypedFormData.Body()` will not work properly, and throw 500 internal
- * server error when `Blob` or `File` type being utilized.
+ * By the way, if you're using `fastify`, pass a `fastify-multer` instance as
+ * the factory, and register a `multipart/form-data` content type parser that
+ * leaves the request stream to it when composing the NestJS application.
+ * Without the parser, Fastify rejects every multipart request with 415.
+ * `fastify-multer`'s own `contentParser` plugin declares the content type
+ * `multipart` without a subtype, which Fastify 5 (NestJS 11) refuses to
+ * register.
  *
  * ```typescript
  * import { NestFactory } from "@nestjs/core";
@@ -32,16 +35,25 @@
  *   FastifyAdapter,
  *   NestFastifyApplication,
  * } from "@nestjs/platform-fastify";
- * import fastifyMulter from "fastify-multer";
  *
  * export async function main() {
  *   const app = await NestFactory.create<NestFastifyApplication>(
  *     AppModule,
  *     new FastifyAdapter(),
  *   );
- *   app.register(fastifyMulter.contentParser);
+ *   app
+ *     .getHttpAdapter()
+ *     .getInstance()
+ *     .addContentTypeParser("multipart/form-data", (_req, _payload, done) =>
+ *       done(null),
+ *     );
  *   await app.listen(3000);
  * }
+ *
+ * // in the controller, with `import FastifyMulter from "fastify-multer"`
+ * public async upload(
+ *   @TypedFormData.Body(() => FastifyMulter()) body: IMultipart,
+ * ): Promise<void> {}
  * ```
  *
  * @author Jeongho Nam - https://github.com/samchon
@@ -55,9 +67,11 @@ export declare namespace TypedFormData {
      *
      * Much easier and type safer than `@nest.UploadFile()` decorator.
      *
-     * @param factory Factory function ncreating the `multer` or `fastify-multer`
+     * @param factory Factory function creating the `multer` or `fastify-multer`
      *   instance. In the factory function, you also can specify the multer
-     *   composition options like `storage` engine.
+     *   composition options like `storage` engine: memory and disk storage
+     *   deliver the uploaded bytes, and an engine keeping neither the buffer nor
+     *   a file path is rejected.
      */
     function Body<Multer extends IMulterBase>(factory: () => Multer | Promise<Multer>): ParameterDecorator;
     /** Base type of the `multer` or `fastify-multer`. */