itlab-internal-services 2.16.1 → 2.16.3

package/dist/pipes/restricted-fields.pipe.js

@@ -0,0 +1,83 @@
+"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.RestrictedFieldsPipe = void 0;
+exports.Restricted = Restricted;
+const common_1 = require("@nestjs/common");
+const core_1 = require("@nestjs/core");
+const class_validator_1 = require("class-validator");
+const itlab_functions_1 = require("itlab-functions");
+const modules_1 = require("../modules");
+const service_auth_guard_1 = require("../modules/authentication/guards/service-auth.guard");
+const RESTRICTED_METADATA_KEY = Symbol('itlab-restricted-metadata');
+/**
+ * @Restricted Decorator
+ *
+ * Marks a DTO property as restricted to specific permissions.
+ * When a request passes through the global `RestrictedFieldsPipe`,
+ * these properties will be removed if the requesting account does not
+ * have all required permissions.
+ *
+ * @param {...string[]} perms - One or more permissions required to retain this field.
+ */
+function Restricted(perms) {
+    return (target, propertyKey) => {
+        // Store metadata without touching the property descriptor
+        const existingMetadata = Reflect.getMetadata(RESTRICTED_METADATA_KEY, target) || {};
+        Reflect.defineMetadata(RESTRICTED_METADATA_KEY, Object.assign(Object.assign({}, existingMetadata), { [propertyKey.toString()]: [perms !== null && perms !== void 0 ? perms : []].flat() }), target);
+    };
+}
+/**
+ * RestrictedFieldsPipe
+ *
+ * Global pipe that inspects incoming DTOs for properties decorated with `@Restricted`.
+ * If the current request's account lacks the required permissions,
+ * the corresponding properties are stripped from the DTO.
+ *
+ * This ensures that sensitive fields are never accidentally
+ * processed further down the request lifecycle.
+ */
+let RestrictedFieldsPipe = class RestrictedFieldsPipe {
+    constructor(request, authenticationOptions, reflector) {
+        this.request = request;
+        this.authenticationOptions = authenticationOptions;
+        this.reflector = reflector;
+    }
+    transform(value, metadata) {
+        var _a, _b, _c;
+        // Allow trusted service-to-service calls (skip restriction checks)
+        const serviceToken = this.request.header(service_auth_guard_1.SERVICE_AUTH_HEADER_KEY);
+        if (serviceToken === this.authenticationOptions.k8sToken)
+            return value;
+        // Only process object payloads (primitives remain unchanged)
+        if (!(0, class_validator_1.isObject)(value))
+            return value;
+        // Determine the permissions available to this account
+        const grantedPerms = (_b = (_a = this.request.account) === null || _a === void 0 ? void 0 : _a.perms) !== null && _b !== void 0 ? _b : [];
+        const restrictions = this.reflector.get(RESTRICTED_METADATA_KEY, (_c = metadata.metatype) === null || _c === void 0 ? void 0 : _c.prototype);
+        for (const [propertyKey, requiredPerms] of Object.entries(restrictions)) {
+            if (requiredPerms.length && !(0, itlab_functions_1.hasSomePermission)(requiredPerms, grantedPerms)) {
+                delete value[propertyKey];
+            }
+        }
+        return value;
+    }
+};
+exports.RestrictedFieldsPipe = RestrictedFieldsPipe;
+exports.RestrictedFieldsPipe = RestrictedFieldsPipe = __decorate([
+    (0, common_1.Injectable)({ scope: common_1.Scope.REQUEST }),
+    __param(0, (0, common_1.Inject)(core_1.REQUEST)),
+    __param(1, (0, modules_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, Object, core_1.Reflector])
+], RestrictedFieldsPipe);

package/dist/properties/content-return-type.property.d.ts

@@ -1,7 +1,11 @@
+import { ApiPropertyOptions } from '@nestjs/swagger';
 import { ContentReturnType } from '../modules';
 type PropertyContentReturnTypeOptions = {
     optional?: boolean;
     default?: ContentReturnType;
 };
+export declare function isSupportedContentType(value: unknown): value is ContentReturnType;
 export declare function PropertyContentReturnType(options?: PropertyContentReturnTypeOptions): PropertyDecorator;
+export declare function ApiPropertyContentReturnType(options?: ApiPropertyOptions): PropertyDecorator;
+export declare function ApiPropertyOptionalContentReturnType(options?: ApiPropertyOptions): PropertyDecorator;
 export {};

package/dist/properties/content-return-type.property.js

@@ -1,6 +1,9 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSupportedContentType = isSupportedContentType;
 exports.PropertyContentReturnType = PropertyContentReturnType;
+exports.ApiPropertyContentReturnType = ApiPropertyContentReturnType;
+exports.ApiPropertyOptionalContentReturnType = ApiPropertyOptionalContentReturnType;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
@@ -10,13 +13,15 @@ function isSupportedContentType(value) {
     return content_return_types_1.supportedContentReturnTypes.some((type) => type === value);
 }
 function PropertyContentReturnType(options = {}) {
-    const decorators = [
-        (0, swagger_1.ApiProperty)(Object.assign({ description: 'In which format should the content be returned', examples: [...content_return_types_1.supportedContentReturnTypes] }, options)),
-        (0, class_transformer_1.Transform)(({ value }) => (isSupportedContentType(value) ? value : options.default)),
-        (0, class_validator_1.IsIn)(content_return_types_1.supportedContentReturnTypes, { message: 'Invalid content return type' }),
-    ];
+    const ContentTypeTransform = () => (0, class_transformer_1.Transform)(({ value }) => (isSupportedContentType(value) ? value : options.default || undefined));
     if (options.optional) {
-        decorators.push(common_1.Optional);
+        return (0, common_1.applyDecorators)(ContentTypeTransform(), (0, class_validator_1.IsIn)([...content_return_types_1.supportedContentReturnTypes, undefined], { message: 'Invalid content return type' }), (0, class_validator_1.IsOptional)());
     }
-    return (0, common_1.applyDecorators)(...decorators);
+    return (0, common_1.applyDecorators)(ContentTypeTransform(), (0, class_validator_1.IsIn)([...content_return_types_1.supportedContentReturnTypes], { message: 'Invalid content return type' }));
+}
+function ApiPropertyContentReturnType(options = {}) {
+    return (0, swagger_1.ApiProperty)(Object.assign({ description: 'In which format should the content be returned', enum: content_return_types_1.supportedContentReturnTypes }, options));
+}
+function ApiPropertyOptionalContentReturnType(options = {}) {
+    return (0, swagger_1.ApiPropertyOptional)(Object.assign({ description: 'In which format should the content be returned', enum: [undefined, ...content_return_types_1.supportedContentReturnTypes], default: undefined }, options));
 }

package/dist/properties/content.property.d.ts

@@ -7,7 +7,12 @@ import { ApiPropertyOptions } from '@nestjs/swagger';
  * - Transforms empty arrays into `undefined` to prevent saving invalid content.
  * - Adds Swagger documentation with the ability to override options.
  *
- * @param {ApiPropertyOptions} [options={}] - Optional Swagger property settings.
  * @returns {PropertyDecorator} - Combined decorator for Swagger, validation, and transformation.
  */
-export declare function PropertyContent(options?: ApiPropertyOptions): PropertyDecorator;
+export declare function PropertyContent(): PropertyDecorator;
+/**
+ *
+ * @param {ApiPropertyOptions} [options={}] - Optional Swagger property settings.
+ * @returns
+ */
+export declare function ApiPropertyContent(options?: ApiPropertyOptions): PropertyDecorator;

package/dist/properties/content.property.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PropertyContent = PropertyContent;
+exports.ApiPropertyContent = ApiPropertyContent;
 const common_1 = require("@nestjs/common");
 const swagger_1 = require("@nestjs/swagger");
 const class_transformer_1 = require("class-transformer");
@@ -13,11 +14,10 @@ const class_validator_1 = require("class-validator");
  * - Transforms empty arrays into `undefined` to prevent saving invalid content.
  * - Adds Swagger documentation with the ability to override options.
  *
- * @param {ApiPropertyOptions} [options={}] - Optional Swagger property settings.
  * @returns {PropertyDecorator} - Combined decorator for Swagger, validation, and transformation.
  */
-function PropertyContent(options = {}) {
-    return (0, common_1.applyDecorators)((0, swagger_1.ApiProperty)(Object.assign({ example: [] }, options)), 
+function PropertyContent() {
+    return (0, common_1.applyDecorators)(
     // Transforms values: ensures empty or invalid arrays are sanitized to undefined
     // eslint-disable-next-line @typescript-eslint/no-unsafe-return
     (0, class_transformer_1.Transform)(({ value }) => ((0, class_validator_1.arrayMinSize)(value, 1) ? value : undefined)), 
@@ -26,3 +26,11 @@ function PropertyContent(options = {}) {
         message: 'Der Inhalt muss mindestens 1 Element haben',
     }));
 }
+/**
+ *
+ * @param {ApiPropertyOptions} [options={}] - Optional Swagger property settings.
+ * @returns
+ */
+function ApiPropertyContent(options = {}) {
+    return (0, swagger_1.ApiProperty)(Object.assign({ example: [] }, options));
+}

package/dist/properties/index.d.ts

@@ -1,4 +1,2 @@
-export { PropertyContentReturnType } from './content-return-type.property';
-export { PropertyContent } from './content.property';
-export { PropertiesLikeable } from './likeable.properties';
-export { PropertiesViewable } from './viewable.properties';
+export { ApiPropertyContentReturnType, ApiPropertyOptionalContentReturnType, isSupportedContentType, PropertyContentReturnType, } from './content-return-type.property';
+export { ApiPropertyContent, PropertyContent } from './content.property';

package/dist/properties/index.js

@@ -1,11 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PropertiesViewable = exports.PropertiesLikeable = exports.PropertyContent = exports.PropertyContentReturnType = void 0;
+exports.PropertyContent = exports.ApiPropertyContent = exports.PropertyContentReturnType = exports.isSupportedContentType = exports.ApiPropertyOptionalContentReturnType = exports.ApiPropertyContentReturnType = void 0;
 var content_return_type_property_1 = require("./content-return-type.property");
+Object.defineProperty(exports, "ApiPropertyContentReturnType", { enumerable: true, get: function () { return content_return_type_property_1.ApiPropertyContentReturnType; } });
+Object.defineProperty(exports, "ApiPropertyOptionalContentReturnType", { enumerable: true, get: function () { return content_return_type_property_1.ApiPropertyOptionalContentReturnType; } });
+Object.defineProperty(exports, "isSupportedContentType", { enumerable: true, get: function () { return content_return_type_property_1.isSupportedContentType; } });
 Object.defineProperty(exports, "PropertyContentReturnType", { enumerable: true, get: function () { return content_return_type_property_1.PropertyContentReturnType; } });
 var content_property_1 = require("./content.property");
+Object.defineProperty(exports, "ApiPropertyContent", { enumerable: true, get: function () { return content_property_1.ApiPropertyContent; } });
 Object.defineProperty(exports, "PropertyContent", { enumerable: true, get: function () { return content_property_1.PropertyContent; } });
-var likeable_properties_1 = require("./likeable.properties");
-Object.defineProperty(exports, "PropertiesLikeable", { enumerable: true, get: function () { return likeable_properties_1.PropertiesLikeable; } });
-var viewable_properties_1 = require("./viewable.properties");
-Object.defineProperty(exports, "PropertiesViewable", { enumerable: true, get: function () { return viewable_properties_1.PropertiesViewable; } });

package/dist/transform/index.d.ts

@@ -1,5 +1,7 @@
 export * from './boolean.transform';
 export * from './image-url.transform';
+export * from './mongo-id.transform';
+export * from './mongo-ids.transform';
 export * from './number.transform';
 export * from './string-array.transform';
 export * from './string.transform';

package/dist/transform/index.js

@@ -16,6 +16,8 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./boolean.transform"), exports);
 __exportStar(require("./image-url.transform"), exports);
+__exportStar(require("./mongo-id.transform"), exports);
+__exportStar(require("./mongo-ids.transform"), exports);
 __exportStar(require("./number.transform"), exports);
 __exportStar(require("./string-array.transform"), exports);
 __exportStar(require("./string.transform"), exports);

package/dist/transform/mongo-id.transform.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @returns {PropertyDecorator} - Transforms a property to a boolean.
+ */
+export declare function MongoIdTransform(): PropertyDecorator;

package/dist/transform/mongo-id.transform.js

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoIdTransform = MongoIdTransform;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * @returns {PropertyDecorator} - Transforms a property to a boolean.
+ */
+function MongoIdTransform() {
+    return (0, class_transformer_1.Transform)(({ value }) => {
+        return (0, class_validator_1.isMongoId)(value) ? String(value) : undefined;
+    });
+}

package/dist/transform/mongo-ids.transform.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @returns {PropertyDecorator} - Transforms a property to a boolean.
+ */
+export declare function MongoIdsTransform(): PropertyDecorator;

package/dist/transform/mongo-ids.transform.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoIdsTransform = MongoIdsTransform;
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+/**
+ * @returns {PropertyDecorator} - Transforms a property to a boolean.
+ */
+function MongoIdsTransform() {
+    return (0, class_transformer_1.Transform)(({ value }) => {
+        if (!(0, class_validator_1.isArray)(value))
+            return undefined;
+        const mongoIds = value.filter((v) => (0, class_validator_1.isMongoId)(v));
+        return Array.from(new Set(mongoIds));
+    });
+}

package/dist/types/duplicable-model.type.d.ts

@@ -0,0 +1,10 @@
+import { Document, Model } from 'mongoose';
+export type DuplicableModel<TBase extends Document> = Model<TBase> & {
+    /**
+     * Checks if a document is a duplicate based on critical keys.
+     * This will be overridden when the schema is created.
+     * @param dto - Data to check for duplicates
+     * @param document - Existing document (optional)
+     */
+    isDuplicate(dto: Partial<Omit<TBase, keyof Document>>, target?: TBase): Promise<boolean>;
+};

package/dist/types/duplicable-model.type.js

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

package/dist/types/index.d.ts

@@ -1,2 +1,3 @@
+export * from './duplicable-model.type';
 export * from './likeable.type';
 export * from './viewable.type';

package/dist/types/index.js

@@ -14,5 +14,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./duplicable-model.type"), exports);
 __exportStar(require("./likeable.type"), exports);
 __exportStar(require("./viewable.type"), exports);

package/dist/types/likeable.type.d.ts

@@ -6,10 +6,11 @@ import { User } from '../models';
  * - `likes`: computed total number of likes.
  * - `likedBy`: optional populated list of User objects.
  */
-export type Likeable = {
+export type IsLikeable = {
     _likedBy: string[];
     likes: number;
     likedBy?: User[];
-    addLike(accountId: string): Promise<void>;
-    removeLike(accountId: string): Promise<void>;
+    addLike(accountId: string): Promise<number>;
+    removeLike(accountId: string): Promise<number>;
+    hasLiked(accountId: string): boolean;
 };

package/dist/types/viewable.type.d.ts

@@ -6,10 +6,11 @@ import { User } from '../models';
  * - `views`: computed total number of views.
  * - `viewedBy`: optional populated list of User objects.
  */
-export type Viewable = {
+export type IsViewable = {
     _viewedBy: string[];
     views: number;
     viewedBy?: User[];
-    addView(accountId: string): Promise<void>;
-    removeView(accountId: string): Promise<void>;
+    addView(accountId: string): Promise<number>;
+    removeView(accountId: string): Promise<number>;
+    hasViewed(accountId: string): boolean;
 };

package/dist/viewable.interface.d.ts

@@ -0,0 +1,42 @@
+/**
+ * TODO: REMOVE
+ * Interface for entities that track user views. This allows the system to monitor
+ * which accounts have viewed an item and how many total views it has received.
+ *
+ * Used to enable features such as view analytics, popularity ranking, or recommendation systems.
+ */
+export interface Viewable {
+    /**
+     * List of account IDs who have viewed this entity.
+     */
+    _viewedBy: string[];
+    /**
+     * Count of total views.
+     */
+    views: number;
+}
+/**
+ * Mongoose schema decorator for the `_viewedBy` field, which tracks unique viewer IDs.
+ * Initialized as an empty array to ensure a consistent schema across documents.
+ *
+ * @returns {PropertyDecorator} - Mongoose configuration for tracking viewers.
+ */
+export declare function PropertyViewedBy(): PropertyDecorator;
+/**
+ * Swagger schema decorator for the `_viewedBy` field. Used in OpenAPI documentation
+ * to describe which users have viewed the entity.
+ *
+ * It enhances API clarity for clients consuming entities that support view tracking.
+ *
+ * @returns {PropertyDecorator} - Swagger metadata for the `viewedBy` field.
+ */
+export declare function ApiViewedBy(): PropertyDecorator;
+/**
+ * Swagger schema decorator for the `views` field. Communicates to API consumers
+ * the meaning and default value of the view count.
+ *
+ * Helps visualize popularity or engagement metrics in API tooling.
+ *
+ * @returns {PropertyDecorator} - Swagger metadata for the `views` field.
+ */
+export declare function ApiViews(): PropertyDecorator;

package/dist/viewable.interface.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyViewedBy = PropertyViewedBy;
+exports.ApiViewedBy = ApiViewedBy;
+exports.ApiViews = ApiViews;
+const mongoose_1 = require("@nestjs/mongoose");
+const swagger_1 = require("@nestjs/swagger");
+const models_1 = require("./models");
+/**
+ * Mongoose schema decorator for the `_viewedBy` field, which tracks unique viewer IDs.
+ * Initialized as an empty array to ensure a consistent schema across documents.
+ *
+ * @returns {PropertyDecorator} - Mongoose configuration for tracking viewers.
+ */
+function PropertyViewedBy() {
+    return (0, mongoose_1.Prop)({ required: true, default: () => [] });
+}
+/**
+ * Swagger schema decorator for the `_viewedBy` field. Used in OpenAPI documentation
+ * to describe which users have viewed the entity.
+ *
+ * It enhances API clarity for clients consuming entities that support view tracking.
+ *
+ * @returns {PropertyDecorator} - Swagger metadata for the `viewedBy` field.
+ */
+function ApiViewedBy() {
+    return (0, swagger_1.ApiProperty)({
+        name: 'viewedBy',
+        type: [models_1.Account],
+        default: [],
+        description: 'Accounts that have viewed this entity.',
+    });
+}
+/**
+ * Swagger schema decorator for the `views` field. Communicates to API consumers
+ * the meaning and default value of the view count.
+ *
+ * Helps visualize popularity or engagement metrics in API tooling.
+ *
+ * @returns {PropertyDecorator} - Swagger metadata for the `views` field.
+ */
+function ApiViews() {
+    return (0, swagger_1.ApiProperty)({
+        type: Number,
+        default: 0,
+        description: 'Total number of views this entity has received.',
+    });
+}

package/package.json

@@ -4,7 +4,7 @@
     "name": "Timo Scheuermann",
     "email": "timo.scheuermann@sv-informatik.de"
   },
-  "version": "2.16.1",
+  "version": "2.16.3",
   "type": "commonjs",
   "files": [
     "dist"

package/dist/classes/schema-builder.class.d.ts

@@ -1,75 +0,0 @@
-import { Type } from '@nestjs/common';
-import { Document, Model, Schema } from 'mongoose';
-import { Likeable, Viewable } from '../types';
-/**
- * Options that determine how the schema should be extended.
- *
- * @template TClass - The document type for the schema.
- */
-export type SchemaBuilderOptions<TClass extends Document> = {
-    /** Whether this schema should support view tracking. */
-    viewable?: boolean;
-    /** Whether this schema should support like tracking. */
-    likeable?: boolean;
-    /**
-     * A set of keys that uniquely identify the document.
-     * These keys are used when checking for duplicates.
-     */
-    criticalKeys?: (keyof Omit<TClass, keyof Document>)[];
-};
-/**
- * Computes the augmented document type based on SchemaOptions.
- */
-export type SchemaBuilderDocument<TClass extends Document, TOptions extends SchemaBuilderOptions<TClass>> = TClass & (TOptions['viewable'] extends true ? Viewable : object) & (TOptions['likeable'] extends true ? Likeable : object);
-/**
- * Extends a standard Mongoose model with custom static methods
- * injected by the SchemaBuilder.
- */
-export type SchemaBuilderModel<TClass extends Document> = Model<TClass> & {
-    /**
-     * Checks if the given object is a duplicate of an existing document.
-     *
-     * @param dto - Partial object with properties to check for duplicates.
-     * @param updateTarget - The document being updated, if applicable.
-     * @returns {Promise<boolean>} - True if a duplicate exists, false otherwise.
-     */
-    isDuplicate(dto: Partial<TClass>, updateTarget?: TClass): Promise<boolean>;
-};
-/**
- * Generic builder for creating extended Mongoose schemas.
- *
- * This class wraps Nest's SchemaFactory and automatically injects common
- * behaviors such as:
- * - View tracking (who viewed, view counts)
- * - Like tracking (who liked, like counts)
- * - Duplicate checking based on critical keys
- *
- * @template TClass - A class extending Mongoose Document.
- */
-export declare class SchemaBuilder<TClass extends Document> {
-    private schema;
-    readonly options: SchemaBuilderOptions<TClass>;
-    constructor(target: Type<TClass>, options?: SchemaBuilderOptions<TClass>);
-    /**
-     * Adds interaction tracking (likes or views) to a schema.
-     * This method generalizes the shared logic between "viewable" and "likeable".
-     *
-     * @param field - The internal array field storing account IDs. (e.g. _viewedBy or _likedBy)
-     * @param counter - The numeric counter field tracking totals. (e.g. views or likes)
-     */
-    provideInteraction(field: string, counter: string): this;
-    /**
-     * Adds a duplicate-checking static method to the schema.
-     * This method compares critical keys to detect conflicts.
-     */
-    private provideDuplicateChecker;
-    /**
-     * Finalizes the schema and injects any selected behaviors (viewable, likeable, duplicate checking).
-     *
-     * @returns An object containing:
-     * - `schema`: The Mongoose schema.
-     * - `modelType`: A strongly typed model with additional static methods.
-     * - `documentType`: The inferred document type with injected properties.
-     */
-    build(): Schema;
-}

package/dist/classes/schema-builder.class.js

@@ -1,109 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SchemaBuilder = void 0;
-const mongoose_1 = require("@nestjs/mongoose");
-const class_validator_1 = require("class-validator");
-/**
- * Generic builder for creating extended Mongoose schemas.
- *
- * This class wraps Nest's SchemaFactory and automatically injects common
- * behaviors such as:
- * - View tracking (who viewed, view counts)
- * - Like tracking (who liked, like counts)
- * - Duplicate checking based on critical keys
- *
- * @template TClass - A class extending Mongoose Document.
- */
-class SchemaBuilder {
-    constructor(target, options = {}) {
-        this.schema = mongoose_1.SchemaFactory.createForClass(target);
-        this.options = options;
-        /**
-         * Create a wildcard index required for CosmosDB to support sorting on all fields.
-         *
-         * This is a workaround for CosmosDB's partial MongoDB API compatibility.
-         * See: https://learn.microsoft.com/en-us/azure/cosmos-db/mongodb/indexing#wildcard-indexes
-         */
-        this.schema.index({ '$**': 1 }, { name: 'Sort Index' });
-        this.provideDuplicateChecker();
-    }
-    /**
-     * Adds interaction tracking (likes or views) to a schema.
-     * This method generalizes the shared logic between "viewable" and "likeable".
-     *
-     * @param field - The internal array field storing account IDs. (e.g. _viewedBy or _likedBy)
-     * @param counter - The numeric counter field tracking totals. (e.g. views or likes)
-     */
-    provideInteraction(field, counter) {
-        // Add fields to the schema
-        this.schema.add({ [field]: { type: [String], default: [] }, [counter]: { type: Number, default: 0 } });
-        // Expose a virtual property (without underscore) for convenience
-        this.schema.virtual(field.replace(/^_/, ''));
-        // Add method to increment counter
-        this.schema.methods[`add${counter[0].toUpperCase() + counter.slice(1)}`] = async function (accountId) {
-            if (!(0, class_validator_1.isMongoId)(accountId))
-                return Number(this[counter]);
-            // Ensure uniqueness by converting to a Set
-            this[field] = Array.from(new Set([...this[field], accountId]));
-            this[counter] = this[field].length;
-            await this.save({ timestamps: false });
-            return this[counter];
-        };
-        // Add method to decrement counter
-        this.schema.methods[`remove${counter[0].toUpperCase() + counter.slice(1)}`] = async function (accountId) {
-            if (!(0, class_validator_1.isMongoId)(accountId))
-                return Number(this[counter]);
-            // Remove the accountId from the list
-            this[field] = this[field].filter((id) => id !== accountId);
-            this[counter] = this[field].length;
-            await this.save({ timestamps: false });
-            return this[counter];
-        };
-        return this;
-    }
-    /**
-     * Adds a duplicate-checking static method to the schema.
-     * This method compares critical keys to detect conflicts.
-     */
-    provideDuplicateChecker() {
-        var _a;
-        const criticalKeys = ((_a = this.options) === null || _a === void 0 ? void 0 : _a.criticalKeys) || [];
-        this.schema.statics.isDuplicate = async function (dto, updateTarget) {
-            var _a;
-            if (criticalKeys.length === 0)
-                return false;
-            // Build a filter using the critical keys
-            const filterQuery = criticalKeys.reduce((query, key) => {
-                if (dto && key in dto)
-                    query[String(key)] = dto[key];
-                else if (updateTarget && key in updateTarget)
-                    query[String(key)] = updateTarget[key];
-                return query;
-            }, {});
-            // If a matching document exists, check whether it’s the same entity
-            const potentialDuplicate = await this.findOne(filterQuery);
-            if (!potentialDuplicate)
-                return false;
-            const potentialId = potentialDuplicate._id.toString().toLowerCase();
-            const targetId = (_a = updateTarget === null || updateTarget === void 0 ? void 0 : updateTarget._id) === null || _a === void 0 ? void 0 : _a.toString().toLowerCase();
-            return potentialId !== targetId;
-        };
-    }
-    /**
-     * Finalizes the schema and injects any selected behaviors (viewable, likeable, duplicate checking).
-     *
-     * @returns An object containing:
-     * - `schema`: The Mongoose schema.
-     * - `modelType`: A strongly typed model with additional static methods.
-     * - `documentType`: The inferred document type with injected properties.
-     */
-    build() {
-        var _a, _b;
-        if ((_a = this.options) === null || _a === void 0 ? void 0 : _a.viewable)
-            this.provideInteraction('_viewedBy', 'views');
-        if ((_b = this.options) === null || _b === void 0 ? void 0 : _b.likeable)
-            this.provideInteraction('_likedBy', 'likes');
-        return this.schema;
-    }
-}
-exports.SchemaBuilder = SchemaBuilder;

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

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