itlab-internal-services 2.16.1 → 2.16.3

package/dist/modules/_old/like/like.module.d.ts

@@ -0,0 +1,21 @@
+import { DynamicModule } from '@nestjs/common';
+import { LikeModuleOptions } from './like.module-definition';
+/**
+ * LikeModule dynamically registers controllers and services to handle "like" functionality
+ * for different resources based on the provided model and optional suffix.
+ *
+ * This design enables modularity and reuse of like-related logic across various resource types.
+ */
+export declare class LikeModule {
+    /**
+     * Registers and configures the LikeModule dynamically.
+     *
+     * - Automatically generates an endpoint path based on provided suffix.
+     * - Tags the controller in Swagger docs for better discoverability.
+     * - Inherits all business logic from the base LikeController.
+     *
+     * @param options - Configuration options including the model and route suffix.
+     * @returns A fully configured dynamic NestJS module.
+     */
+    static register(options: LikeModuleOptions): DynamicModule;
+}

package/dist/modules/_old/like/like.module.js

@@ -0,0 +1,67 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var LikeModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LikeModule = void 0;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const itlab_functions_1 = require("itlab-functions");
+const like_controller_1 = require("./like.controller");
+const like_module_definition_1 = require("./like.module-definition");
+const like_service_1 = require("./like.service");
+/**
+ * LikeModule dynamically registers controllers and services to handle "like" functionality
+ * for different resources based on the provided model and optional suffix.
+ *
+ * This design enables modularity and reuse of like-related logic across various resource types.
+ */
+let LikeModule = LikeModule_1 = class LikeModule {
+    /**
+     * Registers and configures the LikeModule dynamically.
+     *
+     * - Automatically generates an endpoint path based on provided suffix.
+     * - Tags the controller in Swagger docs for better discoverability.
+     * - Inherits all business logic from the base LikeController.
+     *
+     * @param options - Configuration options including the model and route suffix.
+     * @returns A fully configured dynamic NestJS module.
+     */
+    static register(options) {
+        const { routeScope = [] } = options;
+        // Transform suffixes into a readable Swagger tag (e.g., "Like Module - Posts")
+        const swaggerTag = ['Like Module', ...routeScope.map((scope) => (0, itlab_functions_1.capitalize)(scope))].join(' -');
+        // Build the controller route path (e.g., "/like/posts")
+        const controllerRoutePath = ['like', ...routeScope].join('/');
+        /**
+         * A dynamically scoped LikeController for a specific resource.
+         *
+         * This controller uses a generated route path and custom Swagger tag,
+         * but otherwise inherits all base LikeController behavior.
+         */
+        let LikeController = class LikeController extends like_controller_1.LikeController {
+        };
+        LikeController = __decorate([
+            (0, swagger_1.ApiTags)(swaggerTag),
+            (0, common_1.Controller)(controllerRoutePath)
+        ], LikeController);
+        return {
+            module: LikeModule_1,
+            controllers: [LikeController],
+            providers: [like_service_1.LikeService, { provide: like_module_definition_1.LIKE_MODULE_OPTIONS_TOKEN, useValue: options }],
+            exports: [like_service_1.LikeService],
+        };
+    }
+};
+exports.LikeModule = LikeModule;
+exports.LikeModule = LikeModule = LikeModule_1 = __decorate([
+    (0, common_1.Module)({
+        controllers: [like_controller_1.LikeController],
+        providers: [like_service_1.LikeService],
+        exports: [like_service_1.LikeService],
+    })
+], LikeModule);

package/dist/modules/_old/like/like.service.d.ts

@@ -0,0 +1,61 @@
+import { Connection } from 'mongoose';
+import { LikeModuleOptions } from './like.module-definition';
+/**
+ * LikeService manages the "like" functionality for resources.
+ *
+ * It provides methods to add, remove, and verify likes on resource entities,
+ * interacting with the underlying MongoDB collection configured by the module options.
+ */
+export declare class LikeService {
+    private readonly moduleOptions;
+    private readonly connection;
+    private readonly logger;
+    private readonly likeModel;
+    /**
+     * Initializes LikeService with database connection and module configuration.
+     *
+     * @param {LikeModuleOptions} moduleOptions - The module options containing model info.
+     * @param {Connection} connection - The active MongoDB connection injected by Mongoose.
+     */
+    constructor(moduleOptions: LikeModuleOptions, connection: Connection);
+    /**
+     * Computes the number of likes for a given resource document.
+     *
+     * @param {Document & Likeable} [resource] - The resource document which contains _likedBy array.
+     * @returns {number} The count of likes, or zero if none exist.
+     */
+    private getLikeCount;
+    /**
+     * Adds a like to the specified resource by the given account.
+     *
+     * Uses MongoDB's `$addToSet` to avoid duplicate entries efficiently.
+     * Returns the updated count of likes after addition.
+     *
+     * @param {string} resourceId - The identifier of the resource to like.
+     * @param {string} accountId - The account identifier that likes the resource.
+     * @returns {Promise<number>} The updated like count.
+     */
+    addLike(resourceId: string, accountId: string): Promise<number>;
+    /**
+     * Removes a like from the specified resource by the given account.
+     *
+     * Uses MongoDB's `$pull` operator to remove the account ID from the liked list.
+     * Returns the updated count of likes after removal.
+     *
+     * @param {string} resourceId - The identifier of the resource to unlike.
+     * @param {string} accountId - The account identifier that removes the like.
+     * @returns {Promise<number>} The updated like count.
+     */
+    removeLike(resourceId: string, accountId: string): Promise<number>;
+    /**
+     * Checks whether the specified account has liked the resource.
+     *
+     * This method fetches the resource document and checks if the account ID
+     * exists in the `_likedBy` array.
+     *
+     * @param {string} resourceId - The resource to check.
+     * @param {string} accountId - The account to verify.
+     * @returns {Promise<boolean>} True if the account has liked the resource; false otherwise.
+     */
+    hasLiked(resourceId: string, accountId: string): Promise<boolean>;
+}

package/dist/modules/_old/like/like.service.js

@@ -0,0 +1,103 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    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;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+var LikeService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LikeService = void 0;
+const common_1 = require("@nestjs/common");
+const mongoose_1 = require("@nestjs/mongoose");
+const mongoose_2 = require("mongoose");
+const like_module_definition_1 = require("./like.module-definition");
+/**
+ * LikeService manages the "like" functionality for resources.
+ *
+ * It provides methods to add, remove, and verify likes on resource entities,
+ * interacting with the underlying MongoDB collection configured by the module options.
+ */
+let LikeService = LikeService_1 = class LikeService {
+    /**
+     * Initializes LikeService with database connection and module configuration.
+     *
+     * @param {LikeModuleOptions} moduleOptions - The module options containing model info.
+     * @param {Connection} connection - The active MongoDB connection injected by Mongoose.
+     */
+    constructor(moduleOptions, connection) {
+        this.moduleOptions = moduleOptions;
+        this.connection = connection;
+        this.logger = new common_1.Logger(LikeService_1.name);
+        this.likeModel = this.connection.model(this.moduleOptions.model.name, this.moduleOptions.model.schema);
+    }
+    /**
+     * Computes the number of likes for a given resource document.
+     *
+     * @param {Document & Likeable} [resource] - The resource document which contains _likedBy array.
+     * @returns {number} The count of likes, or zero if none exist.
+     */
+    getLikeCount(resource) {
+        var _a, _b;
+        return (_b = (_a = resource === null || resource === void 0 ? void 0 : resource._likedBy) === null || _a === void 0 ? void 0 : _a.length) !== null && _b !== void 0 ? _b : 0;
+    }
+    /**
+     * Adds a like to the specified resource by the given account.
+     *
+     * Uses MongoDB's `$addToSet` to avoid duplicate entries efficiently.
+     * Returns the updated count of likes after addition.
+     *
+     * @param {string} resourceId - The identifier of the resource to like.
+     * @param {string} accountId - The account identifier that likes the resource.
+     * @returns {Promise<number>} The updated like count.
+     */
+    async addLike(resourceId, accountId) {
+        this.logger.log(`Adding like to resource ${resourceId} by account ${accountId}`);
+        const updatedResource = await this.likeModel.findOneAndUpdate({ _id: resourceId }, { $addToSet: { _likedBy: accountId } }, { new: true, upsert: false, timestamps: false });
+        return this.getLikeCount(updatedResource);
+    }
+    /**
+     * Removes a like from the specified resource by the given account.
+     *
+     * Uses MongoDB's `$pull` operator to remove the account ID from the liked list.
+     * Returns the updated count of likes after removal.
+     *
+     * @param {string} resourceId - The identifier of the resource to unlike.
+     * @param {string} accountId - The account identifier that removes the like.
+     * @returns {Promise<number>} The updated like count.
+     */
+    async removeLike(resourceId, accountId) {
+        this.logger.log(`Removing like from resource ${resourceId} by account ${accountId}`);
+        const updatedResource = await this.likeModel.findOneAndUpdate({ _id: resourceId }, { $pull: { _likedBy: accountId } }, { new: true, upsert: false, timestamps: false });
+        return this.getLikeCount(updatedResource);
+    }
+    /**
+     * Checks whether the specified account has liked the resource.
+     *
+     * This method fetches the resource document and checks if the account ID
+     * exists in the `_likedBy` array.
+     *
+     * @param {string} resourceId - The resource to check.
+     * @param {string} accountId - The account to verify.
+     * @returns {Promise<boolean>} True if the account has liked the resource; false otherwise.
+     */
+    async hasLiked(resourceId, accountId) {
+        var _a;
+        this.logger.log(`Checking if account ${accountId} has liked resource ${resourceId}`);
+        const resource = await this.likeModel.findOne({ _id: resourceId });
+        return !!((_a = resource === null || resource === void 0 ? void 0 : resource._likedBy) === null || _a === void 0 ? void 0 : _a.includes(accountId));
+    }
+};
+exports.LikeService = LikeService;
+exports.LikeService = LikeService = LikeService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, common_1.Inject)(like_module_definition_1.LIKE_MODULE_OPTIONS_TOKEN)),
+    __param(1, (0, mongoose_1.InjectConnection)()),
+    __metadata("design:paramtypes", [Object, mongoose_2.Connection])
+], LikeService);

package/dist/modules/authentication/guards/jwt-auth.guard.d.ts

@@ -14,4 +14,4 @@ export declare class JwtAuthGuard implements CanActivate {
     canActivate(context: ExecutionContext): boolean;
 }
 /** Decorator enforcing JWT authentication on routes/controllers */
-export declare function RequireJwtAuth(): MethodDecorator & ClassDecorator;
+export declare function RequireJwtAuth(...permissions: string[]): MethodDecorator & ClassDecorator;

package/dist/modules/authentication/guards/jwt-auth.guard.js

@@ -19,6 +19,7 @@ const core_1 = require("@nestjs/core");
 const jwt_1 = require("@nestjs/jwt");
 const swagger_1 = require("@nestjs/swagger");
 const authentication_options_parameter_1 = require("../authentication-options.parameter");
+const permissions_guard_1 = require("./permissions.guard");
 const public_guard_1 = require("./public.guard");
 /**
  * Guard implementing JWT authentication for routes.
@@ -35,8 +36,9 @@ let JwtAuthGuard = class JwtAuthGuard {
             return true;
         const request = context.switchToHttp().getRequest();
         const token = extractBearerToken(request);
-        if (!token)
+        if (!token) {
             throw new common_1.UnauthorizedException('Authorization token not found.');
+        }
         try {
             request.account = this.jwtService.verify(token, { secret: this.authenticationOptions.jwtSecret });
         }
@@ -62,6 +64,6 @@ function extractBearerToken(request) {
     return scheme === 'Bearer' && (token === null || token === void 0 ? void 0 : token.trim()) ? token : undefined;
 }
 /** Decorator enforcing JWT authentication on routes/controllers */
-function RequireJwtAuth() {
-    return (0, common_1.applyDecorators)((0, common_1.UseGuards)(JwtAuthGuard), (0, swagger_1.ApiBearerAuth)('Auth Token'), (0, swagger_1.ApiUnauthorizedResponse)({ description: 'Unauthorized: Invalid or missing JWT' }));
+function RequireJwtAuth(...permissions) {
+    return (0, common_1.applyDecorators)((0, common_1.UseGuards)(JwtAuthGuard), (0, swagger_1.ApiBearerAuth)('Auth Token'), (0, swagger_1.ApiUnauthorizedResponse)({ description: 'Unauthorized: Invalid or missing Json Web Token' }), ...(permissions.length > 0 ? [(0, permissions_guard_1.RequirePermissions)(...permissions)] : []));
 }

package/dist/modules/authentication/guards/permissions.guard.d.ts

@@ -1,13 +1,11 @@
 import { CanActivate, ExecutionContext } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
-import { AuthenticationModuleOptions } from '../authentication-module-options.interface';
 /**
  * Guard enforcing that authenticated users have the necessary permissions.
  */
 export declare class PermissionsGuard implements CanActivate {
-    private readonly authenticationOptions;
     private readonly reflector;
-    constructor(authenticationOptions: AuthenticationModuleOptions, reflector: Reflector);
+    constructor(reflector: Reflector);
     canActivate(context: ExecutionContext): boolean;
 }
 /** Decorator enforcing permissions on routes/controllers */

package/dist/modules/authentication/guards/permissions.guard.js

@@ -8,9 +8,6 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
 var __metadata = (this && this.__metadata) || function (k, v) {
     if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 };
-var __param = (this && this.__param) || function (paramIndex, decorator) {
-    return function (target, key) { decorator(target, key, paramIndex); }
-};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PermissionsGuard = void 0;
 exports.RequirePermissions = RequirePermissions;
@@ -19,7 +16,6 @@ const core_1 = require("@nestjs/core");
 const swagger_1 = require("@nestjs/swagger");
 const class_validator_1 = require("class-validator");
 const itlab_functions_1 = require("itlab-functions");
-const authentication_options_parameter_1 = require("../authentication-options.parameter");
 const jwt_auth_guard_1 = require("./jwt-auth.guard");
 const public_guard_1 = require("./public.guard");
 /** Metadata key storing required permissions for routes */
@@ -28,8 +24,7 @@ const PERMISSIONS_METADATA_KEY = Symbol('itlab-permissions-guard');
  * Guard enforcing that authenticated users have the necessary permissions.
  */
 let PermissionsGuard = class PermissionsGuard {
-    constructor(authenticationOptions, reflector) {
-        this.authenticationOptions = authenticationOptions;
+    constructor(reflector) {
         this.reflector = reflector;
     }
     canActivate(context) {
@@ -44,8 +39,7 @@ let PermissionsGuard = class PermissionsGuard {
 exports.PermissionsGuard = PermissionsGuard;
 exports.PermissionsGuard = PermissionsGuard = __decorate([
     (0, common_1.Injectable)(),
-    __param(0, (0, authentication_options_parameter_1.InjectAuthenticationOptions)()),
-    __metadata("design:paramtypes", [Object, core_1.Reflector])
+    __metadata("design:paramtypes", [core_1.Reflector])
 ], PermissionsGuard);
 /** Check if account has required permissions */
 function hasRequiredPermissions(context, requiredPermissions) {

package/dist/modules/authentication/guards/service-auth.guard.d.ts

@@ -12,10 +12,6 @@ export declare class ServiceAuthGuard implements CanActivate {
     constructor(authenticationOptions: AuthenticationModuleOptions, reflector: Reflector);
     canActivate(context: ExecutionContext): boolean;
 }
-/**
- * Check if request contains the required internal service token.
- */
-export declare function isServiceRequest(context: ExecutionContext, requiredk8sToken: string): boolean;
 /**
  * Decorator for routes/controllers accessible only by internal services.
  */

package/dist/modules/authentication/guards/service-auth.guard.js

@@ -13,7 +13,6 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ServiceAuthGuard = exports.SERVICE_AUTH_HEADER_KEY = void 0;
-exports.isServiceRequest = isServiceRequest;
 exports.RequireServiceAuth = RequireServiceAuth;
 const common_1 = require("@nestjs/common");
 const core_1 = require("@nestjs/core");
@@ -33,9 +32,15 @@ let ServiceAuthGuard = class ServiceAuthGuard {
     canActivate(context) {
         if ((0, public_guard_1.isPublicRoute)(context, this.reflector))
             return true;
-        if (isServiceRequest(context, this.authenticationOptions.k8sToken))
-            return true;
-        throw new common_1.UnauthorizedException('Application unauthorized');
+        const request = context.switchToHttp().getRequest();
+        const serviceToken = request.header(exports.SERVICE_AUTH_HEADER_KEY);
+        if (!serviceToken) {
+            throw new common_1.UnauthorizedException('Authorization token not found.');
+        }
+        if (serviceToken !== this.authenticationOptions.k8sToken) {
+            throw new common_1.UnauthorizedException('Invalid or expired token.');
+        }
+        return true;
     }
 };
 exports.ServiceAuthGuard = ServiceAuthGuard;
@@ -44,14 +49,6 @@ exports.ServiceAuthGuard = ServiceAuthGuard = __decorate([
     __param(0, (0, authentication_options_parameter_1.InjectAuthenticationOptions)()),
     __metadata("design:paramtypes", [Object, core_1.Reflector])
 ], ServiceAuthGuard);
-/**
- * Check if request contains the required internal service token.
- */
-function isServiceRequest(context, requiredk8sToken) {
-    const request = context.switchToHttp().getRequest();
-    const token = request.header(exports.SERVICE_AUTH_HEADER_KEY);
-    return token && token === requiredk8sToken;
-}
 /**
  * Decorator for routes/controllers accessible only by internal services.
  */
@@ -61,5 +58,5 @@ function RequireServiceAuth() {
         description: 'Token for service authentication',
         allowEmptyValue: true,
         required: true,
-    }), (0, swagger_1.ApiUnauthorizedResponse)({ description: 'Application unauthorized' }));
+    }), (0, swagger_1.ApiUnauthorizedResponse)({ description: 'Unauthorized: Invalid or missing Service Header Token' }));
 }

package/dist/modules/{comment/comment-module-options.interface.d.ts → comments/comments-module-options.interface.d.ts}

@@ -2,14 +2,14 @@ import { ModelDefinition } from '@nestjs/mongoose';
 import { Document } from 'mongoose';
 import { HubResource } from '../../hub-resource.enum';
 /**
- * Module options for configuring and dynamically registering the CommentModule.
+ * Module options for configuring and dynamically registering the CommentsModule.
  *
  * This allows developers to specify the resource model that supports "commenting"
  * and optionally provide a custom route suffix. The modular design ensures
  * consistent, reusable comment functionality across multiple resource types
  * (e.g. News, Events, Demos).
  */
-export type CommentModuleOptions<T extends Document> = {
+export type CommentsModuleOptions<T extends Document> = {
     /**
      * The enum value identifying the resource type this comment module relates to.
      * Used internally for routing and tagging.
@@ -25,6 +25,7 @@ export type CommentModuleOptions<T extends Document> = {
      * For example, setting this to "news" will expose routes comment `/comment/news/:id`.
      */
     routeSuffix: string;
+    version: string;
     /**
      * Field name on the resource document representing a single owner's ID.
      * Enables access control and filtering of comments by ownership.

package/dist/modules/comments/comments-module-options.interface.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/modules/{comment/comment.controller.d.ts → comments/comments.controller.d.ts}

@@ -1,18 +1,19 @@
 import { LabComment, LabContentRichtext } from 'itlab-functions';
-import { CommentService } from './comment.service';
+import { CommentsModuleOptions } from './comments-module-options.interface';
+import { CommentsService } from './comments.service';
 /**
- * Factory function for creating a CommentController bound to a specific route suffix.
+ * Factory function for creating a CommentsController bound to a specific route suffix.
  *
  * Why: Instead of writing separate controllers for each resource type,
  * we generate one dynamically. This ensures DRY principles while still
  * supporting custom routes (e.g. `/comment/news` or `/comment/event`).
  *
- * @param {string} routeSuffix - Suffix appended to the "comment" route.
+ * @param {CommentsModuleOptions} options -
  * @returns A dynamically generated controller class.
  */
-export declare function createCommentController(routeSuffix: string): {
-    new (commentService: CommentService): {
-        readonly commentService: CommentService;
+export declare function createCommentsController(options: CommentsModuleOptions<any>): {
+    new (commentService: CommentsService): {
+        readonly commentService: CommentsService;
         /**
          * Creates a new comment on a specific resource.
          *

package/dist/modules/{comment/comment.controller.js → comments/comments.controller.js}

@@ -12,28 +12,28 @@ var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCommentController = createCommentController;
+exports.createCommentsController = createCommentsController;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const decorators_1 = require("../../decorators");
 const exceptions_1 = require("../../exceptions");
 const pipes_1 = require("../../pipes");
 const authentication_1 = require("../authentication");
-const comment_service_1 = require("./comment.service");
+const comments_service_1 = require("./comments.service");
 /**
- * Factory function for creating a CommentController bound to a specific route suffix.
+ * Factory function for creating a CommentsController bound to a specific route suffix.
  *
  * Why: Instead of writing separate controllers for each resource type,
  * we generate one dynamically. This ensures DRY principles while still
  * supporting custom routes (e.g. `/comment/news` or `/comment/event`).
  *
- * @param {string} routeSuffix - Suffix appended to the "comment" route.
+ * @param {CommentsModuleOptions} options -
  * @returns A dynamically generated controller class.
  */
-function createCommentController(routeSuffix) {
+function createCommentsController(options) {
     // Normalize route path, removing duplicate/trailing slashes
-    const normalizedRoute = `comment/${routeSuffix}`.replace(/\/{2,}/g, '/').replace(/\/$/, '');
-    let CommentController = class CommentController {
+    const normalizedRoute = `comments/${options.routeSuffix}`.replace(/\/{2,}/g, '/').replace(/\/$/, '');
+    let CommentsController = class CommentsController {
         constructor(commentService) {
             this.commentService = commentService;
         }
@@ -73,12 +73,12 @@ function createCommentController(routeSuffix) {
         __metadata("design:type", Function),
         __metadata("design:paramtypes", [String, String, Object]),
         __metadata("design:returntype", Promise)
-    ], CommentController.prototype, "postComment", null);
-    CommentController = __decorate([
+    ], CommentsController.prototype, "postComment", null);
+    CommentsController = __decorate([
         (0, authentication_1.RequireJwtAuth)(),
-        (0, swagger_1.ApiTags)('Comment'),
-        (0, common_1.Controller)(normalizedRoute),
-        __metadata("design:paramtypes", [comment_service_1.CommentService])
-    ], CommentController);
-    return CommentController;
+        (0, swagger_1.ApiTags)('Comments'),
+        (0, common_1.Controller)({ path: normalizedRoute, version: options.version }),
+        __metadata("design:paramtypes", [comments_service_1.CommentsService])
+    ], CommentsController);
+    return CommentsController;
 }

package/dist/modules/comments/comments.module-definition.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Dependency injection token for CommentsModule options.
+ */
+export declare const COMMENTS_MODULE_OPTIONS_TOKEN: unique symbol;

package/dist/modules/comments/comments.module-definition.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMENTS_MODULE_OPTIONS_TOKEN = void 0;
+/**
+ * Dependency injection token for CommentsModule options.
+ */
+exports.COMMENTS_MODULE_OPTIONS_TOKEN = Symbol('COMMENTS_MODULE_OPTIONS_TOKEN');

package/dist/modules/{comment/comment.module.d.ts → comments/comments.module.d.ts}

@@ -1,8 +1,8 @@
 import { DynamicModule } from '@nestjs/common';
 import { Document } from 'mongoose';
-import { CommentModuleOptions } from './comment-module-options.interface';
+import { CommentsModuleOptions } from './comments-module-options.interface';
 /**
- * CommentModule dynamically registers controllers and services
+ * CommentsModule dynamically registers controllers and services
  * to handle "commenting" functionality for a given resource model.
  *
  * Why: Many resources (e.g. blogposts, events, demos) can be commented,
@@ -10,13 +10,13 @@ import { CommentModuleOptions } from './comment-module-options.interface';
  * Instead, this module centralizes the commenting-related logic, keeping it
  * consistent while still allowing customization via options.
  */
-export declare class CommentModule {
+export declare class CommentsModule {
     /**
-     * Dynamically registers a CommentController bound to the provided model
+     * Dynamically registers a CommentsController bound to the provided model
      * and optional route suffix.
      *
-     * @param {CommentModuleOptions} options - Configuration for the resource model and route.
+     * @param {CommentsModuleOptions} options - Configuration for the resource model and route.
      * @returns {DynamicModule} The dynamically created module definition.
      */
-    static forFeature<T extends Document>(options: CommentModuleOptions<T>): DynamicModule;
+    static forFeature<T extends Document>(options: CommentsModuleOptions<T>): DynamicModule;
 }

package/dist/modules/{comment/comment.module.js → comments/comments.module.js}

@@ -5,15 +5,15 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     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;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-var CommentModule_1;
+var CommentsModule_1;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentModule = void 0;
+exports.CommentsModule = void 0;
 const common_1 = require("@nestjs/common");
-const comment_controller_1 = require("./comment.controller");
-const comment_module_definition_1 = require("./comment.module-definition");
-const comment_service_1 = require("./comment.service");
+const comments_controller_1 = require("./comments.controller");
+const comments_module_definition_1 = require("./comments.module-definition");
+const comments_service_1 = require("./comments.service");
 /**
- * CommentModule dynamically registers controllers and services
+ * CommentsModule dynamically registers controllers and services
  * to handle "commenting" functionality for a given resource model.
  *
  * Why: Many resources (e.g. blogposts, events, demos) can be commented,
@@ -21,24 +21,25 @@ const comment_service_1 = require("./comment.service");
  * Instead, this module centralizes the commenting-related logic, keeping it
  * consistent while still allowing customization via options.
  */
-let CommentModule = CommentModule_1 = class CommentModule {
+let CommentsModule = CommentsModule_1 = class CommentsModule {
     /**
-     * Dynamically registers a CommentController bound to the provided model
+     * Dynamically registers a CommentsController bound to the provided model
      * and optional route suffix.
      *
-     * @param {CommentModuleOptions} options - Configuration for the resource model and route.
+     * @param {CommentsModuleOptions} options - Configuration for the resource model and route.
      * @returns {DynamicModule} The dynamically created module definition.
      */
     static forFeature(options) {
-        const CommentController = (0, comment_controller_1.createCommentController)(options.routeSuffix);
+        const CommentsController = (0, comments_controller_1.createCommentsController)(options);
         return {
-            module: CommentModule_1,
-            providers: [comment_service_1.CommentService, { provide: comment_module_definition_1.COMMENT_MODULE_OPTIONS_TOKEN, useValue: options }],
-            controllers: [CommentController],
+            module: CommentsModule_1,
+            providers: [comments_service_1.CommentsService, { provide: comments_module_definition_1.COMMENTS_MODULE_OPTIONS_TOKEN, useValue: options }],
+            controllers: [CommentsController],
+            exports: [comments_service_1.CommentsService],
         };
     }
 };
-exports.CommentModule = CommentModule;
-exports.CommentModule = CommentModule = CommentModule_1 = __decorate([
+exports.CommentsModule = CommentsModule;
+exports.CommentsModule = CommentsModule = CommentsModule_1 = __decorate([
     (0, common_1.Module)({})
-], CommentModule);
+], CommentsModule);