itlab-internal-services 2.16.1 → 2.16.3

package/dist/classes/fetch-options/base-options.class.d.ts

@@ -0,0 +1,18 @@
+export declare class BaseOptions {
+    /**
+     * Basic
+     */
+    id?: string;
+    ids?: string[];
+    samples?: number;
+    /**
+     * Sorting
+     */
+    sortField?: string;
+    sortDirection?: 1 | -1;
+    /**
+     * Pagination
+     */
+    skip?: number;
+    limit?: number;
+}

package/dist/classes/fetch-options/base-options.class.js

@@ -0,0 +1,81 @@
+"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.BaseOptions = void 0;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
+class BaseOptions {
+}
+exports.BaseOptions = BaseOptions;
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '' }),
+    (0, transform_1.MongoIdTransform)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], BaseOptions.prototype, "id", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '' }),
+    (0, transform_1.MongoIdsTransform)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Array)
+], BaseOptions.prototype, "ids", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({ description: '' }),
+    (0, transform_1.NumberTransform)({ default: undefined, min: 1, max: undefined }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], BaseOptions.prototype, "samples", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Feldname, nach dem sortiert werden soll',
+        default: '_id',
+    }),
+    (0, transform_1.StringTransform)({ trim: true, omitEmpty: true }),
+    (0, class_validator_1.MinLength)(1, { message: 'Das Sortierfeld muss mindestens 1 Zeichen lang sein.' }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], BaseOptions.prototype, "sortField", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Sortierreihenfolge: 1 für aufsteigend, -1 für absteigend (Standard)',
+        examples: {
+            ascending: { value: 1, summary: 'Aufsteigend' },
+            descending: { value: -1, summary: 'Absteigend (Standard)' },
+        },
+        default: -1,
+    }),
+    (0, transform_1.NumberTransform)({ default: -1, min: -1, max: 1 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], BaseOptions.prototype, "sortDirection", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Anzahl der zu überspringenden Ergebnisse (für Paginierung)',
+        minimum: 0,
+        default: 0,
+        example: 0,
+    }),
+    (0, transform_1.NumberTransform)({ default: 0, min: 0 }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], BaseOptions.prototype, "skip", void 0);
+__decorate([
+    (0, swagger_1.ApiPropertyOptional)({
+        description: 'Maximale Anzahl der zurückgegebenen Ergebnisse',
+        minimum: 0,
+        default: undefined,
+        example: undefined,
+    }),
+    (0, transform_1.NumberTransform)({ default: undefined, min: 0, max: undefined }),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", Number)
+], BaseOptions.prototype, "limit", void 0);

package/dist/classes/fetch-options/comments-options.class.d.ts

@@ -0,0 +1,6 @@
+export declare function CommentsOptions<TBase extends new (...args: any[]) => any>(Base: TBase): {
+    new (...args: any[]): {
+        [x: string]: any;
+        includeComments?: boolean;
+    };
+} & TBase;

package/dist/classes/fetch-options/comments-options.class.js

@@ -0,0 +1,26 @@
+"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.CommentsOptions = CommentsOptions;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const transform_1 = require("../../transform");
+function CommentsOptions(Base) {
+    class CommentsOptions extends Base {
+    }
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)({ example: true }),
+        (0, transform_1.BooleanTransform)(),
+        (0, class_validator_1.IsOptional)(),
+        __metadata("design:type", Boolean)
+    ], CommentsOptions.prototype, "includeComments", void 0);
+    return CommentsOptions;
+}

package/dist/classes/fetch-options/content-options.class.d.ts

@@ -0,0 +1,7 @@
+import { ContentReturnType } from '../../modules';
+export declare function ContentOptions<TBase extends new (...args: any[]) => any>(Base: TBase): {
+    new (...args: any[]): {
+        [x: string]: any;
+        includeContent?: ContentReturnType;
+    };
+} & TBase;

package/dist/classes/fetch-options/content-options.class.js

@@ -0,0 +1,32 @@
+"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.ContentOptions = ContentOptions;
+const swagger_1 = require("@nestjs/swagger");
+const class_transformer_1 = require("class-transformer");
+const class_validator_1 = require("class-validator");
+const content_return_types_1 = require("../../modules/services/providers/content/content-return-types");
+const properties_1 = require("../../properties");
+function ContentOptions(Base) {
+    class ContentOptions extends Base {
+    }
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)({
+            description: 'In which format should the content be returned',
+            enum: [undefined, ...content_return_types_1.supportedContentReturnTypes],
+            default: undefined,
+        }),
+        (0, class_transformer_1.Transform)(({ value }) => ((0, properties_1.isSupportedContentType)(value) ? value : undefined)),
+        (0, class_validator_1.IsOptional)(),
+        __metadata("design:type", String)
+    ], ContentOptions.prototype, "includeContent", void 0);
+    return ContentOptions;
+}

package/dist/classes/fetch-options/drafted-options.class.d.ts

@@ -0,0 +1,9 @@
+export declare function DraftedOptions<TBase extends new (...args: any[]) => any>(Base: TBase, options?: {
+    requiredPermissions?: string[];
+}): {
+    new (...args: any[]): {
+        [x: string]: any;
+        includeDrafted?: boolean;
+        isDraft?: boolean;
+    };
+} & TBase;

package/dist/classes/fetch-options/drafted-options.class.js

@@ -0,0 +1,34 @@
+"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.DraftedOptions = DraftedOptions;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const pipes_1 = require("../../pipes");
+const transform_1 = require("../../transform");
+function DraftedOptions(Base, options) {
+    class DraftedOptions extends Base {
+    }
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)({ example: true }),
+        (0, transform_1.BooleanTransform)(),
+        (0, class_validator_1.IsOptional)(),
+        (0, pipes_1.Restricted)(options === null || options === void 0 ? void 0 : options.requiredPermissions),
+        __metadata("design:type", Boolean)
+    ], DraftedOptions.prototype, "includeDrafted", void 0);
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)(),
+        (0, transform_1.BooleanTransform)(),
+        (0, class_validator_1.IsOptional)(),
+        __metadata("design:type", Boolean)
+    ], DraftedOptions.prototype, "isDraft", void 0);
+    return DraftedOptions;
+}

package/dist/classes/fetch-options/index.d.ts

@@ -0,0 +1,6 @@
+export { BaseOptions } from './base-options.class';
+export { CommentsOptions } from './comments-options.class';
+export { ContentOptions } from './content-options.class';
+export { DraftedOptions } from './drafted-options.class';
+export { LikedByOptions } from './liked-by-options.class';
+export { ViewedByOptions } from './viewed-by-options.class';

package/dist/classes/fetch-options/index.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ViewedByOptions = exports.LikedByOptions = exports.DraftedOptions = exports.ContentOptions = exports.CommentsOptions = exports.BaseOptions = void 0;
+var base_options_class_1 = require("./base-options.class");
+Object.defineProperty(exports, "BaseOptions", { enumerable: true, get: function () { return base_options_class_1.BaseOptions; } });
+var comments_options_class_1 = require("./comments-options.class");
+Object.defineProperty(exports, "CommentsOptions", { enumerable: true, get: function () { return comments_options_class_1.CommentsOptions; } });
+var content_options_class_1 = require("./content-options.class");
+Object.defineProperty(exports, "ContentOptions", { enumerable: true, get: function () { return content_options_class_1.ContentOptions; } });
+var drafted_options_class_1 = require("./drafted-options.class");
+Object.defineProperty(exports, "DraftedOptions", { enumerable: true, get: function () { return drafted_options_class_1.DraftedOptions; } });
+var liked_by_options_class_1 = require("./liked-by-options.class");
+Object.defineProperty(exports, "LikedByOptions", { enumerable: true, get: function () { return liked_by_options_class_1.LikedByOptions; } });
+var viewed_by_options_class_1 = require("./viewed-by-options.class");
+Object.defineProperty(exports, "ViewedByOptions", { enumerable: true, get: function () { return viewed_by_options_class_1.ViewedByOptions; } });

package/dist/classes/fetch-options/liked-by-options.class.d.ts

@@ -0,0 +1,8 @@
+export declare function LikedByOptions<TBase extends new (...args: any[]) => any>(Base: TBase, options?: {
+    requiredPermissions?: string[];
+}): {
+    new (...args: any[]): {
+        [x: string]: any;
+        includeLikedBy?: boolean;
+    };
+} & TBase;

package/dist/classes/fetch-options/liked-by-options.class.js

@@ -0,0 +1,28 @@
+"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.LikedByOptions = LikedByOptions;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const pipes_1 = require("../../pipes");
+const transform_1 = require("../../transform");
+function LikedByOptions(Base, options) {
+    class LikedByOptions extends Base {
+    }
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)({}),
+        (0, transform_1.BooleanTransform)(),
+        (0, class_validator_1.IsOptional)(),
+        (0, pipes_1.Restricted)(options === null || options === void 0 ? void 0 : options.requiredPermissions),
+        __metadata("design:type", Boolean)
+    ], LikedByOptions.prototype, "includeLikedBy", void 0);
+    return LikedByOptions;
+}

package/dist/classes/fetch-options/viewed-by-options.class.d.ts

@@ -0,0 +1,9 @@
+export declare function ViewedByOptions<TBase extends new (...args: any[]) => any>(Base: TBase, options?: {
+    requiredPermissions?: string[];
+}): {
+    new (...args: any[]): {
+        [x: string]: any;
+        includeViewedBy?: boolean;
+        viewedBy?: string;
+    };
+} & TBase;

package/dist/classes/fetch-options/viewed-by-options.class.js

@@ -0,0 +1,28 @@
+"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.ViewedByOptions = ViewedByOptions;
+const swagger_1 = require("@nestjs/swagger");
+const class_validator_1 = require("class-validator");
+const pipes_1 = require("../../pipes");
+const transform_1 = require("../../transform");
+function ViewedByOptions(Base, options) {
+    class ViewedByOptions extends Base {
+    }
+    __decorate([
+        (0, swagger_1.ApiPropertyOptional)({}),
+        (0, transform_1.BooleanTransform)(),
+        (0, class_validator_1.IsOptional)(),
+        (0, pipes_1.Restricted)(options === null || options === void 0 ? void 0 : options.requiredPermissions),
+        __metadata("design:type", Boolean)
+    ], ViewedByOptions.prototype, "includeViewedBy", void 0);
+    return ViewedByOptions;
+}

package/dist/classes/index.d.ts

@@ -1,5 +1,5 @@
+export * from './document';
+export * from './fetch-options';
 export { DocumentMerger } from './document-merger.class';
 export { ReportCategory } from './report-category.class';
-export { SchemaBuilder } from './schema-builder.class';
-export type { SchemaBuilderDocument, SchemaBuilderModel, SchemaBuilderOptions } from './schema-builder.class';
 export { TaskManager } from './task-manager.class';

package/dist/classes/index.js

@@ -1,11 +1,25 @@
 "use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+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 });
-exports.TaskManager = exports.SchemaBuilder = exports.ReportCategory = exports.DocumentMerger = void 0;
+exports.TaskManager = exports.ReportCategory = exports.DocumentMerger = void 0;
+__exportStar(require("./document"), exports);
+__exportStar(require("./fetch-options"), exports);
 var document_merger_class_1 = require("./document-merger.class");
 Object.defineProperty(exports, "DocumentMerger", { enumerable: true, get: function () { return document_merger_class_1.DocumentMerger; } });
 var report_category_class_1 = require("./report-category.class");
 Object.defineProperty(exports, "ReportCategory", { enumerable: true, get: function () { return report_category_class_1.ReportCategory; } });
-var schema_builder_class_1 = require("./schema-builder.class");
-Object.defineProperty(exports, "SchemaBuilder", { enumerable: true, get: function () { return schema_builder_class_1.SchemaBuilder; } });
 var task_manager_class_1 = require("./task-manager.class");
 Object.defineProperty(exports, "TaskManager", { enumerable: true, get: function () { return task_manager_class_1.TaskManager; } });

package/dist/classes/task-manager.class.d.ts

@@ -40,7 +40,7 @@ export declare class TaskManager {
      * @param userMap Map of userId -> user object
      * @returns Array of user objects
      */
-    static mapIdsToUsers(userIds: string[], userMap: Map<string, User>): any[];
+    static mapIdsToUsers(userIds: string[], userMap: Map<string, User>): User[];
     /**
      * Maps an array of IDs to user objects using a userMap.
      * Filters out any IDs that don’t have a corresponding user.
@@ -48,7 +48,7 @@ export declare class TaskManager {
      * @param accountMap Map of userId -> user object
      * @returns Array of user objects
      */
-    static mapIdsToAccounts(accountIds: string[], accountMap: Map<string, Account>): any[];
+    static mapIdsToAccounts(accountIds: string[], accountMap: Map<string, Account>): Account[];
     /**
      * Adds a new asynchronous task to the queue.
      *

package/dist/classes/task-manager.class.js

@@ -30,6 +30,8 @@ class TaskManager {
     static async fetchAndMapUsers(userIdGroups, accountsService) {
         // Collect all unique user IDs across all groups
         const uniqueUserIds = new Set(userIdGroups.flat());
+        if (uniqueUserIds.size === 0)
+            return new Map();
         // Fetch all users once
         const userCollection = await accountsService.getUserCollection(Array.from(uniqueUserIds));
         // Build a map for quick lookup
@@ -45,6 +47,8 @@ class TaskManager {
     static async fetchAndMapAccounts(accountIdGroups, accountsService) {
         // Collect all unique user IDs across all groups
         const uniqueAccountIds = new Set(accountIdGroups.flat());
+        if (uniqueAccountIds.size === 0)
+            return new Map();
         // Fetch all users once
         const accountCollection = await accountsService.getAccountCollection(Array.from(uniqueAccountIds));
         // Build a map for quick lookup

package/dist/decorators/has-permission.decorator.d.ts

@@ -0,0 +1,3 @@
+export declare const HasPermission: (...dataOrPipes: (string | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+export declare const HasSomePermission: (...dataOrPipes: (string[] | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;
+export declare const HasEveryPermission: (...dataOrPipes: (string[] | import("@nestjs/common").PipeTransform<any, any> | import("@nestjs/common").Type<import("@nestjs/common").PipeTransform<any, any>>)[]) => ParameterDecorator;

package/dist/decorators/has-permission.decorator.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HasEveryPermission = exports.HasSomePermission = exports.HasPermission = void 0;
+const common_1 = require("@nestjs/common");
+const itlab_functions_1 = require("itlab-functions");
+exports.HasPermission = (0, common_1.createParamDecorator)((permission, executionContext) => {
+    var _a, _b;
+    const request = executionContext.switchToHttp().getRequest();
+    if (!((_b = (_a = request.account) === null || _a === void 0 ? void 0 : _a.perms) === null || _b === void 0 ? void 0 : _b.length))
+        return false;
+    return (0, itlab_functions_1.hasPermission)(permission, request.account.perms);
+});
+exports.HasSomePermission = (0, common_1.createParamDecorator)((permissions, executionContext) => {
+    var _a, _b;
+    const request = executionContext.switchToHttp().getRequest();
+    if (!((_b = (_a = request.account) === null || _a === void 0 ? void 0 : _a.perms) === null || _b === void 0 ? void 0 : _b.length))
+        return false;
+    return (0, itlab_functions_1.hasSomePermission)(permissions, request.account.perms);
+});
+exports.HasEveryPermission = (0, common_1.createParamDecorator)((permissions, executionContext) => {
+    var _a, _b;
+    const request = executionContext.switchToHttp().getRequest();
+    if (!((_b = (_a = request.account) === null || _a === void 0 ? void 0 : _a.perms) === null || _b === void 0 ? void 0 : _b.length))
+        return false;
+    return (0, itlab_functions_1.hasEveryPermission)(permissions, request.account.perms);
+});

package/dist/decorators/index.d.ts

@@ -1,2 +1,4 @@
 export * from './authenticated-account.decorator';
+export * from './has-permission.decorator';
 export * from './jwt.decorator';
+export * from './schema-with-critical-keys.decorator';

package/dist/decorators/index.js

@@ -15,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./authenticated-account.decorator"), exports);
+__exportStar(require("./has-permission.decorator"), exports);
 __exportStar(require("./jwt.decorator"), exports);
+__exportStar(require("./schema-with-critical-keys.decorator"), exports);

package/dist/decorators/jwt.decorator.d.ts

@@ -9,4 +9,4 @@
  * @throws {UnprocessableEntityException} When the 'Authorization' header is missing.
  * @returns {string} The extracted JWT token without the 'Bearer ' prefix.
  */
-export declare const Jwt: (...dataOrPipes: any[]) => ParameterDecorator;
+export declare function Jwt(): ParameterDecorator;

package/dist/decorators/jwt.decorator.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Jwt = void 0;
+exports.Jwt = Jwt;
 const common_1 = require("@nestjs/common");
 /**
  * Custom decorator to extract the JWT token from the request headers.
@@ -13,13 +13,15 @@ const common_1 = require("@nestjs/common");
  * @throws {UnprocessableEntityException} When the 'Authorization' header is missing.
  * @returns {string} The extracted JWT token without the 'Bearer ' prefix.
  */
-exports.Jwt = (0, common_1.createParamDecorator)((_, executionContext) => {
-    const request = executionContext.switchToHttp().getRequest();
-    const authHeader = request.header('Authorization');
-    if (!authHeader) {
-        throw new common_1.UnprocessableEntityException('Authorization header is missing from the request');
-    }
-    // Extract token by removing the 'Bearer ' prefix (case-insensitive)
-    const token = authHeader.replace(/^Bearer\s+/i, '');
-    return token;
-});
+function Jwt() {
+    return (0, common_1.createParamDecorator)((_, executionContext) => {
+        const request = executionContext.switchToHttp().getRequest();
+        const authHeader = request.header('Authorization');
+        if (!authHeader) {
+            throw new common_1.UnprocessableEntityException('Authorization header is missing from the request');
+        }
+        // Extract token by removing the 'Bearer ' prefix (case-insensitive)
+        const token = authHeader.replace(/^Bearer\s+/i, '');
+        return token;
+    });
+}

package/dist/decorators/schema-with-critical-keys.decorator.d.ts

@@ -0,0 +1,12 @@
+import { SchemaOptions } from '@nestjs/mongoose';
+/**
+ * Extended SchemaOptions to include `criticalKeys` for duplicate checking.
+ */
+export interface ExtendedSchemaOptions extends SchemaOptions {
+    criticalKeys?: string[];
+}
+/**
+ * Custom decorator that wraps NestJS's @Schema
+ * and stores criticalKeys on the schema options.
+ */
+export declare function SchemaWithCriticalKeys(options?: ExtendedSchemaOptions): ClassDecorator;

package/dist/decorators/schema-with-critical-keys.decorator.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemaWithCriticalKeys = SchemaWithCriticalKeys;
+const mongoose_1 = require("@nestjs/mongoose");
+/**
+ * Custom decorator that wraps NestJS's @Schema
+ * and stores criticalKeys on the schema options.
+ */
+function SchemaWithCriticalKeys(options = {}) {
+    return (target) => {
+        // Store options on the class constructor for the factory to read later
+        Reflect.defineMetadata('criticalKeys', options.criticalKeys || [], target);
+        // Call the original NestJS @Schema decorator with the same options
+        (0, mongoose_1.Schema)(options)(target);
+    };
+}

package/dist/factories/index.d.ts

@@ -0,0 +1 @@
+export { VirtualsFactory } from './virtuals.factory';

package/dist/factories/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VirtualsFactory = void 0;
+var virtuals_factory_1 = require("./virtuals.factory");
+Object.defineProperty(exports, "VirtualsFactory", { enumerable: true, get: function () { return virtuals_factory_1.VirtualsFactory; } });

package/dist/factories/virtuals.factory.d.ts

@@ -0,0 +1,80 @@
+import { Schema, VirtualTypeOptions } from 'mongoose';
+import { HubResource } from '../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.
+ */
+export declare class VirtualsFactory {
+    private readonly schema;
+    private readonly resource;
+    /**
+     * @param {Schema} schema - the schema to create the virtual field on
+     * @param {HubResource} resource - the resource used for the virtual field
+     */
+    constructor(schema: Schema, resource: HubResource);
+    /**
+     * 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: string, options?: VirtualTypeOptions): VirtualsFactory;
+    /**
+     * 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: string, localField: string): VirtualsFactory;
+    /**
+     * 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: string, localField: string): VirtualsFactory;
+    /** Links `accountId` → `account` (single Account) */
+    get account(): VirtualsFactory;
+    /** Links `accountIds` → `accounts` (multiple Accounts) */
+    get accounts(): VirtualsFactory;
+    /** Links `authorId` → `author` (single Account) */
+    get author(): VirtualsFactory;
+    /** Links `authorIds` → `authors` (multiple Accounts) */
+    get authors(): VirtualsFactory;
+    /** Links `submitterId` → `submitter` (single Account) */
+    get submitter(): VirtualsFactory;
+    /** Links `submitterIds` → `submitters` (multiple Accounts) */
+    get submitters(): VirtualsFactory;
+    /** Links `contactId` → `contact` (single Account) */
+    get contact(): VirtualsFactory;
+    /** Links `contactIds` → `contacts` (multiple Accounts) */
+    get contacts(): VirtualsFactory;
+    /** Links `_viewedBy` → `viewedBy` and creates derived `views` counter */
+    get views(): VirtualsFactory;
+    /** Links `_likedBy` → `likedBy` and creates derived `likes` counter */
+    get likes(): VirtualsFactory;
+    /**
+     * Creates `comments` virtual for top-level comments on the resource.
+     * Filters out replies.
+     */
+    get comments(): VirtualsFactory;
+    /**
+     * Creates `commentsCount` virtual for counting all related comments on this resource.
+     */
+    get commentsCount(): VirtualsFactory;
+    /**
+     * Creates an empty virtual field for general content use.
+     * Placeholder to support virtual getter/setter extension in custom implementations.
+     */
+    get content(): VirtualsFactory;
+    /**
+     * Registers `ref-[resource]` virtuals for each known Hub resource.
+     * Used for polymorphic document relationships in the platform.
+     */
+    get hubResources(): VirtualsFactory;
+}