itlab-internal-services 2.16.12 → 2.16.14

package/dist/factories/virtuals.factory.js

@@ -1,172 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.VirtualsFactory = void 0;
-const class_validator_1 = require("class-validator");
-const hub_resource_enum_1 = require("../hub-resource.enum");
-/**
- * TODO: Remove
- * VirtualsFactory
- *
- * Provides a fluent, composable API for defining reusable Mongoose virtuals on schemas.
- * Helps keep schema definitions clean and DRY by centralizing the logic for frequently-used
- * virtual references (accounts, comments, likes, etc.), derived values, and hub-based resources.
- */
-class VirtualsFactory {
-    /**
-     * @param {Schema} schema - the schema to create the virtual field on
-     * @param {HubResource} resource - the resource used for the virtual field
-     */
-    constructor(schema, resource) {
-        this.schema = schema;
-        this.resource = resource;
-    }
-    // ———————————————————————— Core Helper Methods ————————————————————————
-    /**
-     * Registers a generic virtual with custom Mongoose options.
-     *
-     * @param {string} name - The virtual field name.
-     * @param {VirtualTypeOptions} [options] - The Mongoose virtual options.
-     * @returns {VirtualsFactory} - The VirtualsFactory instance for chaining.
-     */
-    virtual(name, options) {
-        this.schema.virtual(name, options);
-        return this;
-    }
-    /**
-     * Registers a virtual referencing a single Account by ID.
-     *
-     * @param {string} name - Virtual field name.
-     * @param {string} localField - Field containing the Account ID.
-     */
-    virtualSingleAccount(name, localField) {
-        this.schema.virtual(name, {
-            ref: 'accounts',
-            foreignField: '_id',
-            localField,
-            justOne: true,
-        });
-        return this;
-    }
-    /**
-     * Registers a virtual referencing multiple Accounts by ID array.
-     *
-     * @param {string} name - Virtual field name.
-     * @param {string} localField - Field containing array of Account IDs.
-     */
-    virtualMultipleAccounts(name, localField) {
-        this.schema.virtual(name, {
-            ref: 'accounts',
-            foreignField: '_id',
-            localField,
-            justOne: false,
-        });
-        return this;
-    }
-    // ———————————————————————— Account-Related Virtuals ————————————————————————
-    /** Links `accountId` → `account` (single Account) */
-    get account() {
-        return this.virtualSingleAccount('account', 'accountId');
-    }
-    /** Links `accountIds` → `accounts` (multiple Accounts) */
-    get accounts() {
-        return this.virtualMultipleAccounts('accounts', 'accountIds');
-    }
-    /** Links `authorId` → `author` (single Account) */
-    get author() {
-        return this.virtualSingleAccount('author', 'authorId');
-    }
-    /** Links `authorIds` → `authors` (multiple Accounts) */
-    get authors() {
-        return this.virtualMultipleAccounts('authors', 'authorIds');
-    }
-    /** Links `submitterId` → `submitter` (single Account) */
-    get submitter() {
-        return this.virtualSingleAccount('submitter', 'submitterId');
-    }
-    /** Links `submitterIds` → `submitters` (multiple Accounts) */
-    get submitters() {
-        return this.virtualMultipleAccounts('submitters', 'submitterIds');
-    }
-    /** Links `contactId` → `contact` (single Account) */
-    get contact() {
-        return this.virtualSingleAccount('contact', 'contactId');
-    }
-    /** Links `contactIds` → `contacts` (multiple Accounts) */
-    get contacts() {
-        return this.virtualMultipleAccounts('contacts', 'contactIds');
-    }
-    /** Links `_viewedBy` → `viewedBy` and creates derived `views` counter */
-    get views() {
-        this.virtualMultipleAccounts('viewedBy', '_viewedBy');
-        this.schema.virtual('views').get(function () {
-            return (0, class_validator_1.isArray)(this._viewedBy) ? this._viewedBy.length : 0;
-        });
-        return this;
-    }
-    /** Links `_likedBy` → `likedBy` and creates derived `likes` counter */
-    get likes() {
-        this.virtualMultipleAccounts('likedBy', '_likedBy');
-        this.schema.virtual('likes').get(function () {
-            return (0, class_validator_1.isArray)(this._likedBy) ? this._likedBy.length : 0;
-        });
-        return this;
-    }
-    // ———————————————————————— Comment-Related Virtuals ————————————————————————
-    /**
-     * Creates `comments` virtual for top-level comments on the resource.
-     * Filters out replies.
-     */
-    get comments() {
-        this.schema.virtual('comments', {
-            ref: 'comments',
-            foreignField: '_resourceId',
-            localField: '_id',
-            match: {
-                _resource: this.resource,
-                _replyTo: { $exists: false },
-            },
-            justOne: false,
-        });
-        return this;
-    }
-    /**
-     * Creates `commentsCount` virtual for counting all related comments on this resource.
-     */
-    get commentsCount() {
-        this.schema.virtual('commentsCount', {
-            ref: 'comments',
-            foreignField: '_resourceId',
-            localField: '_id',
-            match: { _resource: this.resource },
-            count: true,
-        });
-        return this;
-    }
-    // ———————————————————————— Content and Utility Virtuals ————————————————————————
-    /**
-     * Creates an empty virtual field for general content use.
-     * Placeholder to support virtual getter/setter extension in custom implementations.
-     */
-    get content() {
-        this.schema.virtual('content');
-        return this;
-    }
-    // ———————————————————————— Hub Resource Virtuals ————————————————————————
-    /**
-     * Registers `ref-[resource]` virtuals for each known Hub resource.
-     * Used for polymorphic document relationships in the platform.
-     */
-    get hubResources() {
-        for (const resource of hub_resource_enum_1.HUB_RESOURCES) {
-            this.schema.virtual(`ref-${resource}`, {
-                ref: resource,
-                foreignField: '_id',
-                localField: '_resourceId',
-                match: { _resource: resource },
-                justOne: true,
-            });
-        }
-        return this;
-    }
-}
-exports.VirtualsFactory = VirtualsFactory;

package/dist/functions/create-duplicate-checker.function.d.ts

@@ -1,29 +0,0 @@
-import { HttpException } from '@nestjs/common';
-import { Document, Model } from 'mongoose';
-/**
- * @fileoverview
- * Provides a utility to create a duplicate checker function for a Mongoose model.
- * The generated function verifies whether a given data transfer object (DTO) would
- * result in a duplicate record based on critical identifying fields.
- *
- * If a duplicate is detected that does not match the current resource (if provided),
- * a specified HTTP exception is thrown to prevent creation or update.
- */
-/**
- * Generates a function that performs a duplicate check in a MongoDB collection
- * using critical fields from a DTO and an optional existing document.
- *
- * This function ensures data integrity by preventing records with the same
- * critical identifiers from being saved multiple times.
- *
- * @template TDto - DTO type, expected to share key fields with the document.
- * @template TDocument - Mongoose document type.
- *
- * @param {Model<TDocument>} model - Mongoose model to search for potential duplicates.
- * @param {(keyof TDto & keyof TDocument)[]} criticalKeys - Keys used to identify duplicates.
- * @param {new () => HttpException} DuplicateError - Error type to throw if a duplicate is found.
- *
- * @returns {(dto: TDto, existingResource?: TDocument) => Promise<void>}
- * A function that checks for duplicates and throws an error if a different record matches.
- */
-export declare function createDuplicateChecker<TDto extends Partial<TDocument>, TDocument extends Document>(model: Model<TDocument>, criticalKeys: (keyof TDto & keyof TDocument)[], DuplicateError: new () => HttpException): (dto: TDto, existingResource?: TDocument) => Promise<void>;

package/dist/functions/create-duplicate-checker.function.js

@@ -1,52 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.createDuplicateChecker = createDuplicateChecker;
-/**
- * @fileoverview
- * Provides a utility to create a duplicate checker function for a Mongoose model.
- * The generated function verifies whether a given data transfer object (DTO) would
- * result in a duplicate record based on critical identifying fields.
- *
- * If a duplicate is detected that does not match the current resource (if provided),
- * a specified HTTP exception is thrown to prevent creation or update.
- */
-/**
- * Generates a function that performs a duplicate check in a MongoDB collection
- * using critical fields from a DTO and an optional existing document.
- *
- * This function ensures data integrity by preventing records with the same
- * critical identifiers from being saved multiple times.
- *
- * @template TDto - DTO type, expected to share key fields with the document.
- * @template TDocument - Mongoose document type.
- *
- * @param {Model<TDocument>} model - Mongoose model to search for potential duplicates.
- * @param {(keyof TDto & keyof TDocument)[]} criticalKeys - Keys used to identify duplicates.
- * @param {new () => HttpException} DuplicateError - Error type to throw if a duplicate is found.
- *
- * @returns {(dto: TDto, existingResource?: TDocument) => Promise<void>}
- * A function that checks for duplicates and throws an error if a different record matches.
- */
-function createDuplicateChecker(model, criticalKeys, DuplicateError) {
-    return async (dto, existingResource) => {
-        const filterQuery = {};
-        // Populate filterQuery with key-value pairs from the DTO or the existing document.
-        // Priority is given to the DTO values since those represent the intended update/create.
-        for (const criticalKey of criticalKeys) {
-            if (dto && criticalKey in dto) {
-                filterQuery[criticalKey] = dto[criticalKey];
-            }
-            else if (existingResource && criticalKey in existingResource) {
-                filterQuery[criticalKey] = existingResource[criticalKey];
-            }
-        }
-        // Attempt to find an existing document with matching critical fields.
-        const potentialDuplicate = await model.findOne(filterQuery);
-        // Convert existing resource ID to lowercase string for safe comparison.
-        const currentResourceId = existingResource ? String(existingResource._id).toLowerCase() : undefined;
-        // If a duplicate exists and it's not the same as the current resource, throw the error.
-        if (potentialDuplicate && String(potentialDuplicate._id).toLowerCase() !== currentResourceId) {
-            throw new DuplicateError();
-        }
-    };
-}

package/dist/likeable.interface.d.ts

@@ -1,42 +0,0 @@
-/**
- * TODO: REMOVE
- * Interface for entities that can be liked by users. Used to track engagement metrics
- * such as user interest or approval. Fields include a reference to user IDs and a count of total likes.
- *
- * Intended to be implemented or extended by Mongoose documents representing likeable resources.
- */
-export interface Likeable {
-    /**
-     * List of account IDs who have liked this entity.
-     */
-    _likedBy: string[];
-    /**
-     * Count of total likes.
-     */
-    likes: number;
-}
-/**
- * Mongoose property decorator for defining the `_likedBy` field.
- * This field is required and initialized with an empty array to ensure consistency.
- *
- * Useful for tracking which accounts have liked a particular document.
- *
- * @returns {PropertyDecorator} - Mongoose property configuration for `_likedBy`.
- */
-export declare function PropertyLikedBy(): PropertyDecorator;
-/**
- * Swagger property decorator for documenting the `_likedBy` field in API specs.
- * Describes the field as an array of `Account` and documents its usage.
- *
- * This improves visibility in auto-generated API docs for consumers of likeable entities.
- *
- * @returns {PropertyDecorator} - Swagger metadata for the `_likedBy` field.
- */
-export declare function ApiLikedBy(): PropertyDecorator;
-/**
- * Swagger property decorator for documenting the `likes` field in API responses.
- * Represents the total number of likes and helps clarify it is derived/cached.
- *
- * @returns {PropertyDecorator} - Swagger metadata for the `likes` field.
- */
-export declare function ApiLikes(): PropertyDecorator;

package/dist/likeable.interface.js

@@ -1,48 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PropertyLikedBy = PropertyLikedBy;
-exports.ApiLikedBy = ApiLikedBy;
-exports.ApiLikes = ApiLikes;
-const mongoose_1 = require("@nestjs/mongoose");
-const swagger_1 = require("@nestjs/swagger");
-const models_1 = require("./models");
-/**
- * Mongoose property decorator for defining the `_likedBy` field.
- * This field is required and initialized with an empty array to ensure consistency.
- *
- * Useful for tracking which accounts have liked a particular document.
- *
- * @returns {PropertyDecorator} - Mongoose property configuration for `_likedBy`.
- */
-function PropertyLikedBy() {
-    return (0, mongoose_1.Prop)({ required: true, default: () => [] });
-}
-/**
- * Swagger property decorator for documenting the `_likedBy` field in API specs.
- * Describes the field as an array of `Account` and documents its usage.
- *
- * This improves visibility in auto-generated API docs for consumers of likeable entities.
- *
- * @returns {PropertyDecorator} - Swagger metadata for the `_likedBy` field.
- */
-function ApiLikedBy() {
-    return (0, swagger_1.ApiProperty)({
-        name: 'likedBy',
-        type: [models_1.Account],
-        default: [],
-        description: 'The accounts who have liked the entity.',
-    });
-}
-/**
- * Swagger property decorator for documenting the `likes` field in API responses.
- * Represents the total number of likes and helps clarify it is derived/cached.
- *
- * @returns {PropertyDecorator} - Swagger metadata for the `likes` field.
- */
-function ApiLikes() {
-    return (0, swagger_1.ApiProperty)({
-        type: Number,
-        default: 0,
-        description: 'The number of likes this entity has received.',
-    });
-}

package/dist/modules/_old/comment/comment.controller.d.ts

@@ -1,35 +0,0 @@
-import { LabContentRichtext } from 'itlab-functions';
-import { Comment } from './comment.model';
-import { CommentService } from './comment.service';
-/**
- * @class CommentController
- * @description
- * Handles HTTP endpoints for adding comments to a resource.
- * Requires authenticated users and validates the resource ID using a MongoDB ObjectId format.
- * Delegates comment logic to CommentService.
- *
- * Routes are mounted dynamically and scoped by module configuration (via CommentModule).
- *
- * Example route: POST /comment/posts/:resourceId
- */
-export declare class CommentController {
-    private readonly commentService;
-    /**
-     * Injects CommentService for handling comment logic.
-     *
-     * @param {CommentService} commentService - Service that handles comment creation and deletion logic
-     */
-    constructor(commentService: CommentService);
-    /**
-     * Adds a comment to a specific resource.
-     *
-     * This endpoint is authenticated. It verifies the resource exists (if a model is provided),
-     * and forwards the comment to the internal comments service with optional owner metadata.
-     *
-     * @param {string} resourceId - MongoDB ObjectId of the resource to comment on
-     * @param {string} accountId - Authenticated user ID from the JWT
-     * @param {LabContentRichtext} comment - The comment content (rich text format)
-     * @returns {Promise<Comment>} - The saved comment returned by the comment service
-     */
-    postComment(resourceId: string, accountId: string, comment: LabContentRichtext): Promise<Comment>;
-}

package/dist/modules/_old/comment/comment.controller.js

@@ -1,86 +0,0 @@
-"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); }
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.CommentController = void 0;
-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_model_1 = require("./comment.model");
-const comment_service_1 = require("./comment.service");
-/**
- * @class CommentController
- * @description
- * Handles HTTP endpoints for adding comments to a resource.
- * Requires authenticated users and validates the resource ID using a MongoDB ObjectId format.
- * Delegates comment logic to CommentService.
- *
- * Routes are mounted dynamically and scoped by module configuration (via CommentModule).
- *
- * Example route: POST /comment/posts/:resourceId
- */
-let CommentController = class CommentController {
-    /**
-     * Injects CommentService for handling comment logic.
-     *
-     * @param {CommentService} commentService - Service that handles comment creation and deletion logic
-     */
-    constructor(commentService) {
-        this.commentService = commentService;
-    }
-    /**
-     * Adds a comment to a specific resource.
-     *
-     * This endpoint is authenticated. It verifies the resource exists (if a model is provided),
-     * and forwards the comment to the internal comments service with optional owner metadata.
-     *
-     * @param {string} resourceId - MongoDB ObjectId of the resource to comment on
-     * @param {string} accountId - Authenticated user ID from the JWT
-     * @param {LabContentRichtext} comment - The comment content (rich text format)
-     * @returns {Promise<Comment>} - The saved comment returned by the comment service
-     */
-    async postComment(resourceId, accountId, comment) {
-        return this.commentService.postComment(resourceId, accountId, comment);
-    }
-};
-exports.CommentController = CommentController;
-__decorate([
-    (0, swagger_1.ApiOperation)({
-        summary: 'Kommentar speichern',
-        description: 'Speichert ein Kommentar zur angegebenen Ressource.',
-    }),
-    (0, swagger_1.ApiOkResponse)({
-        description: 'Der erfolgreich gespeicherte Kommentar',
-        type: comment_model_1.Comment,
-    }),
-    (0, exceptions_1.ApiBadBodyResponse)('Validierung des Kommentars fehlgeschlagen'),
-    (0, swagger_1.ApiBody)({
-        description: 'Der Kommentar-Inhalt im Richtext-Format',
-    }),
-    (0, pipes_1.ApiMongoIdParam)('resourceId'),
-    (0, common_1.Post)(':resourceId'),
-    __param(0, (0, pipes_1.MongoIdParam)('resourceId')),
-    __param(1, (0, decorators_1.AuthenticatedAccount)('id')),
-    __param(2, (0, common_1.Body)()),
-    __metadata("design:type", Function),
-    __metadata("design:paramtypes", [String, String, Object]),
-    __metadata("design:returntype", Promise)
-], CommentController.prototype, "postComment", null);
-exports.CommentController = CommentController = __decorate([
-    (0, authentication_1.RequireJwtAuth)(),
-    (0, common_1.Controller)(),
-    __metadata("design:paramtypes", [comment_service_1.CommentService])
-], CommentController);

package/dist/modules/_old/comment/comment.model.d.ts

@@ -1,29 +0,0 @@
-/**
- * Represents a single user-generated comment entry in the system.
- *
- * Encapsulates information about the author, creation time, and comment content,
- * including support for rich text (HTML-formatted) body.
- */
-export declare class Comment {
-    /**
-     * Identifier of the user who authored the comment.
-     * Used to associate the comment with a specific account.
-     *
-     * @example "000000000000000000000000"
-     */
-    authorId: string;
-    /**
-     * UNIX timestamp of when the comment was created.
-     * Used for ordering and displaying relative or absolute creation time.
-     *
-     * @example 1625074800
-     */
-    timestamp: number;
-    /**
-     * The content of the comment, formatted as rich HTML.
-     * Enables structured presentation (e.g., paragraphs, links).
-     *
-     * @example "<p>Hello World</p>"
-     */
-    richtext: string;
-}

package/dist/modules/_old/comment/comment.model.js

@@ -1,43 +0,0 @@
-"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);
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Comment = void 0;
-const swagger_1 = require("@nestjs/swagger");
-/**
- * Represents a single user-generated comment entry in the system.
- *
- * Encapsulates information about the author, creation time, and comment content,
- * including support for rich text (HTML-formatted) body.
- */
-class Comment {
-}
-exports.Comment = Comment;
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'ID of the comment author',
-        example: '000000000000000000000000',
-    }),
-    __metadata("design:type", String)
-], Comment.prototype, "authorId", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'Timestamp when the comment was created (UNIX format)',
-        example: 1625074800,
-    }),
-    __metadata("design:type", Number)
-], Comment.prototype, "timestamp", void 0);
-__decorate([
-    (0, swagger_1.ApiProperty)({
-        description: 'HTML-formatted comment content',
-        example: '<p>Hello World</p>',
-    }),
-    __metadata("design:type", String)
-], Comment.prototype, "richtext", void 0);

package/dist/modules/_old/comment/comment.module-definition.d.ts

@@ -1,45 +0,0 @@
-import { ModelDefinition } from '@nestjs/mongoose';
-import { Document } from 'mongoose';
-import { HubResource } from '../../../hub-resource.enum';
-/**
- * Options for configuring a dynamically scoped CommentModule.
- *
- * This structure allows customization of routes, Swagger tags, and field-level ownership logic
- * for different resource types (e.g., posts, articles, media).
- *
- * @template T - The type of the resource document.
- */
-export type CommentModuleOptions<T extends Document = any> = {
-    /**
-     * The enum value identifying the resource type this comment module relates to.
-     * Used internally for routing and tagging.
-     */
-    resource: HubResource;
-    /**
-     * Optional array of path segments used to define the controller route and Swagger tag suffix.
-     * Enables modular comment endpoints for different resource domains.
-     *
-     * Example: ['posts', 'featured'] → route: /comment/posts/featured
-     */
-    routeScope?: string[];
-    /**
-     * Optional Mongoose model definition for the resource to which comments are attached.
-     * If not provided, the module will skip controller registration.
-     */
-    model?: ModelDefinition;
-    /**
-     * Field name on the resource document representing a single owner's ID.
-     * Enables access control and filtering of comments by ownership.
-     */
-    ownerIdField?: keyof Omit<T, keyof Document>;
-    /**
-     * Field name on the resource document representing multiple owner IDs.
-     * Useful for shared or collaborative resource ownership models.
-     */
-    ownerIdsField?: keyof Omit<T, keyof Document>;
-};
-/**
- * Token used to inject CommentModule options into services or controllers if needed.
- * Symbol is used to avoid accidental naming collisions across modules.
- */
-export declare const COMMENT_MODULE_OPTIONS_TOKEN: unique symbol;

package/dist/modules/_old/comment/comment.module-definition.js

@@ -1,8 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.COMMENT_MODULE_OPTIONS_TOKEN = void 0;
-/**
- * Token used to inject CommentModule options into services or controllers if needed.
- * Symbol is used to avoid accidental naming collisions across modules.
- */
-exports.COMMENT_MODULE_OPTIONS_TOKEN = Symbol('COMMENT_MODULE_OPTIONS_TOKEN');

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

@@ -1,22 +0,0 @@
-import { DynamicModule } from '@nestjs/common';
-import { Document } from 'mongoose';
-import { CommentModuleOptions } from './comment.module-definition';
-/**
- * @class CommentModule
- * @description
- * A dynamic NestJS module that registers a comment controller and service scoped
- * to a specific resource type, route, and ownership model.
- */
-export declare class CommentModule {
-    /**
-     * Registers a dynamically scoped comment controller based on the provided options.
-     *
-     * - Generates a custom route path and Swagger tag based on `routeScope`.
-     * - If no model is provided, no controller will be registered (service-only mode).
-     *
-     * @template T - The resource document type the comment module is tied to.
-     * @param options - Configuration values for routing, model binding, and ownership strategy.
-     * @returns A fully configured NestJS DynamicModule.
-     */
-    static register<T extends Document = any>(options: CommentModuleOptions<T>): DynamicModule;
-}