itlab-internal-services 2.16.12 → 2.16.13

package/dist/modules/services/providers/newsletter/newsletter.service.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@nestjs/config';
-import { LabNewsletter } from 'itlab-functions';
+import { LabNewsletterIssue } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchIssueOptionsDtoV1 } from './fetch-issue-options.dto.v1.type';
@@ -33,9 +33,9 @@ export declare class NewsletterService extends BaseHttpService {
      *
      * @param {string} issueId - Unique MongoDB identifier of the issue.
      * @param {FetchIssueOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNewsletter | undefined>} Resolves to an Issue or `undefined` on failure.
+     * @returns {Promise<LabNewsletterIssue | undefined>} Resolves to an Issue or `undefined` on failure.
      */
-    fetchIssueV1(issueId: string, options?: FetchIssueOptionsDtoV1): Promise<LabNewsletter | undefined>;
+    fetchIssueV1(issueId: string, options?: FetchIssueOptionsDtoV1): Promise<LabNewsletterIssue | undefined>;
     /**
      * Retrieves a collection of issue entries.
      *
@@ -43,7 +43,7 @@ export declare class NewsletterService extends BaseHttpService {
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchIssueOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNewsletter[]>} Resolves to a list of issues, or an empty array if none found.
+     * @returns {Promise<LabNewsletterIssue[]>} Resolves to a list of issues, or an empty array if none found.
      */
-    fetchIssueCollectionV1(options?: FetchIssueOptionsDtoV1): Promise<LabNewsletter[]>;
+    fetchIssueCollectionV1(options?: FetchIssueOptionsDtoV1): Promise<LabNewsletterIssue[]>;
 }

package/dist/modules/services/providers/newsletter/newsletter.service.js

@@ -53,7 +53,7 @@ let NewsletterService = class NewsletterService extends base_http_service_1.Base
      *
      * @param {string} issueId - Unique MongoDB identifier of the issue.
      * @param {FetchIssueOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNewsletter | undefined>} Resolves to an Issue or `undefined` on failure.
+     * @returns {Promise<LabNewsletterIssue | undefined>} Resolves to an Issue or `undefined` on failure.
      */
     async fetchIssueV1(issueId, options) {
         return this.fetchResource(`v1/internal/issue/${issueId}`, { params: options });
@@ -65,7 +65,7 @@ let NewsletterService = class NewsletterService extends base_http_service_1.Base
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchIssueOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNewsletter[]>} Resolves to a list of issues, or an empty array if none found.
+     * @returns {Promise<LabNewsletterIssue[]>} Resolves to a list of issues, or an empty array if none found.
      */
     async fetchIssueCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/issues`, { params: options });

package/dist/modules/services/providers/newsroom/newsroom.service.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@nestjs/config';
-import { LabNews } from 'itlab-functions';
+import { LabNewsroomNews } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchNewsOptionsDtoV1 } from './fetch-news-options.dto.v1.type';
@@ -33,9 +33,9 @@ export declare class NewsroomService extends BaseHttpService {
      *
      * @param {string} newsId - Unique MongoDB identifier of the news.
      * @param {FetchNewsOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNews | undefined>} Resolves to an News or `undefined` on failure.
+     * @returns {Promise<LabNewsroomNews | undefined>} Resolves to an News or `undefined` on failure.
      */
-    fetchNewsV1(newsId: string, options?: FetchNewsOptionsDtoV1): Promise<LabNews | undefined>;
+    fetchNewsV1(newsId: string, options?: FetchNewsOptionsDtoV1): Promise<LabNewsroomNews | undefined>;
     /**
      * Retrieves a collection of news entries.
      *
@@ -43,7 +43,7 @@ export declare class NewsroomService extends BaseHttpService {
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchNewsOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNews[]>} Resolves to a list of news, or an empty array if none found.
+     * @returns {Promise<LabNewsroomNews[]>} Resolves to a list of news, or an empty array if none found.
      */
-    fetchNewsCollectionV1(options?: FetchNewsOptionsDtoV1): Promise<LabNews[]>;
+    fetchNewsCollectionV1(options?: FetchNewsOptionsDtoV1): Promise<LabNewsroomNews[]>;
 }

package/dist/modules/services/providers/newsroom/newsroom.service.js

@@ -53,7 +53,7 @@ let NewsroomService = class NewsroomService extends base_http_service_1.BaseHttp
      *
      * @param {string} newsId - Unique MongoDB identifier of the news.
      * @param {FetchNewsOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNews | undefined>} Resolves to an News or `undefined` on failure.
+     * @returns {Promise<LabNewsroomNews | undefined>} Resolves to an News or `undefined` on failure.
      */
     async fetchNewsV1(newsId, options) {
         return this.fetchResource(`v1/internal/news/${newsId}`, { params: options });
@@ -65,7 +65,7 @@ let NewsroomService = class NewsroomService extends base_http_service_1.BaseHttp
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchNewsOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNews[]>} Resolves to a list of news, or an empty array if none found.
+     * @returns {Promise<LabNewsroomNews[]>} Resolves to a list of news, or an empty array if none found.
      */
     async fetchNewsCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/news`, { params: options });

package/dist/modules/services/providers/notifications/notifications.service.d.ts

@@ -1,5 +1,6 @@
 import { DynamicModule } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
+import { LabNotificationsNotification } from 'itlab-functions';
 import { HubResource } from '../../../../hub-resource.enum';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
@@ -10,19 +11,6 @@ import { FetchNotificationOptionsDtoV1 } from './fetch-notification-options.dto.
  * Parameter decorator to inject the feature-specific NotificationService.
  */
 export declare function InjectFeatureNotificationsService(): ParameterDecorator;
-type LabNotification = {
-    id: string;
-    _resource: string;
-    _resourceId: string;
-    url: string;
-    type: string;
-    title: string;
-    message: string;
-    timestamp: number;
-    status: 'pending' | 'sending' | 'delivered';
-    draft: boolean;
-    recipientIds: string[];
-};
 /**
  * NotificationService
  *
@@ -54,9 +42,9 @@ export declare class NotificationsService extends BaseHttpService {
      *
      * @param {string} notificationId - Unique MongoDB identifier of the notification.
      * @param {FetchNotificationOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNotification | undefined>} Resolves to an Notification or `undefined` on failure.
+     * @returns {Promise<LabNotificationsNotification | undefined>} Resolves to an Notification or `undefined` on failure.
      */
-    fetchNotificationV1(notificationId: string, options?: FetchNotificationOptionsDtoV1): Promise<LabNotification | undefined>;
+    fetchNotificationV1(notificationId: string, options?: FetchNotificationOptionsDtoV1): Promise<LabNotificationsNotification | undefined>;
     /**
      * Retrieves a collection of notification entries.
      *
@@ -64,9 +52,9 @@ export declare class NotificationsService extends BaseHttpService {
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchNotificationOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNotification[]>} Resolves to a list of notifications, or an empty array if none found.
+     * @returns {Promise<LabNotificationsNotification[]>} Resolves to a list of notifications, or an empty array if none found.
      */
-    fetchNotificationCollectionV1(options?: FetchNotificationOptionsDtoV1): Promise<LabNotification[]>;
+    fetchNotificationCollectionV1(options?: FetchNotificationOptionsDtoV1): Promise<LabNotificationsNotification[]>;
     /**
      * Schedules or reschedules a notification for a given resource.
      * Updates existing notifications if necessary.
@@ -83,4 +71,3 @@ export declare class NotificationsService extends BaseHttpService {
      */
     deleteNotificationsV1(resourceId: string): void;
 }
-export {};

package/dist/modules/services/providers/notifications/notifications.service.js

@@ -84,10 +84,12 @@ let NotificationsService = NotificationsService_1 = class NotificationsService e
      *
      * @param {string} notificationId - Unique MongoDB identifier of the notification.
      * @param {FetchNotificationOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabNotification | undefined>} Resolves to an Notification or `undefined` on failure.
+     * @returns {Promise<LabNotificationsNotification | undefined>} Resolves to an Notification or `undefined` on failure.
      */
     async fetchNotificationV1(notificationId, options) {
-        return this.fetchResource(`v1/internal/notification/${notificationId}`, { params: options });
+        return this.fetchResource(`v1/internal/notification/${notificationId}`, {
+            params: options,
+        });
     }
     /**
      * Retrieves a collection of notification entries.
@@ -96,7 +98,7 @@ let NotificationsService = NotificationsService_1 = class NotificationsService e
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchNotificationOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabNotification[]>} Resolves to a list of notifications, or an empty array if none found.
+     * @returns {Promise<LabNotificationsNotification[]>} Resolves to a list of notifications, or an empty array if none found.
      */
     async fetchNotificationCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/notifications`, { params: options });

package/dist/modules/services/providers/podcasts/podcasts.service.d.ts

@@ -1,5 +1,5 @@
 import { ConfigService } from '@nestjs/config';
-import { LabPodcast } from 'itlab-functions';
+import { LabPodcastsEpisode } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchEpisodeOptionsDtoV1 } from './fetch-episode-options.dto.v1.type';
@@ -33,9 +33,9 @@ export declare class PodcastsService extends BaseHttpService {
      *
      * @param {string} episodeId - Unique MongoDB identifier of the episode.
      * @param {FetchEpisodeOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabPodcast | undefined>} Resolves to an Episode or `undefined` on failure.
+     * @returns {Promise<LabPodcastsEpisode | undefined>} Resolves to an Episode or `undefined` on failure.
      */
-    fetchEpisodeV1(episodeId: string, options?: FetchEpisodeOptionsDtoV1): Promise<LabPodcast | undefined>;
+    fetchEpisodeV1(episodeId: string, options?: FetchEpisodeOptionsDtoV1): Promise<LabPodcastsEpisode | undefined>;
     /**
      * Retrieves a collection of episode entries.
      *
@@ -43,7 +43,7 @@ export declare class PodcastsService extends BaseHttpService {
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchEpisodeOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabPodcast[]>} Resolves to a list of episodes, or an empty array if none found.
+     * @returns {Promise<LabPodcastsEpisode[]>} Resolves to a list of episodes, or an empty array if none found.
      */
-    fetchEpisodeCollectionV1(options?: FetchEpisodeOptionsDtoV1): Promise<LabPodcast[]>;
+    fetchEpisodeCollectionV1(options?: FetchEpisodeOptionsDtoV1): Promise<LabPodcastsEpisode[]>;
 }

package/dist/modules/services/providers/podcasts/podcasts.service.js

@@ -53,7 +53,7 @@ let PodcastsService = class PodcastsService extends base_http_service_1.BaseHttp
      *
      * @param {string} episodeId - Unique MongoDB identifier of the episode.
      * @param {FetchEpisodeOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabPodcast | undefined>} Resolves to an Episode or `undefined` on failure.
+     * @returns {Promise<LabPodcastsEpisode | undefined>} Resolves to an Episode or `undefined` on failure.
      */
     async fetchEpisodeV1(episodeId, options) {
         return this.fetchResource(`v1/internal/episode/${episodeId}`, { params: options });
@@ -65,7 +65,7 @@ let PodcastsService = class PodcastsService extends base_http_service_1.BaseHttp
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchEpisodeOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabPodcast[]>} Resolves to a list of episodes, or an empty array if none found.
+     * @returns {Promise<LabPodcastsEpisode[]>} Resolves to a list of episodes, or an empty array if none found.
      */
     async fetchEpisodeCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/episodes`, { params: options });

package/dist/modules/services/providers/quick-links/quick-links.service.d.ts

@@ -1,19 +1,8 @@
 import { ConfigService } from '@nestjs/config';
+import { LabQuickLinksLink } from 'itlab-functions';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
 import { FetchLinkOptionsDtoV1 } from './fetch-link-options.dto.v1.type';
-type LabQuickLink = {
-    id: string;
-    _url: string;
-    _qrCodeUrl: string;
-    short: string;
-    href: string;
-    tags: string[];
-    engagements: number;
-    engagedAt?: Date;
-    scans: number;
-    scannedAt?: Date;
-};
 /**
  * QuickLinksService
  *
@@ -44,9 +33,9 @@ export declare class QuickLinksService extends BaseHttpService {
      *
      * @param {string} linkId - Unique MongoDB identifier of the link.
      * @param {FetchLinkOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabQuickLink | undefined>} Resolves to an Link or `undefined` on failure.
+     * @returns {Promise<LabQuickLinksLink | undefined>} Resolves to an Link or `undefined` on failure.
      */
-    fetchLinkV1(linkId: string, options?: FetchLinkOptionsDtoV1): Promise<LabQuickLink | undefined>;
+    fetchLinkV1(linkId: string, options?: FetchLinkOptionsDtoV1): Promise<LabQuickLinksLink | undefined>;
     /**
      * Retrieves a collection of link entries.
      *
@@ -54,8 +43,7 @@ export declare class QuickLinksService extends BaseHttpService {
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchLinkOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabQuickLink[]>} Resolves to a list of links, or an empty array if none found.
+     * @returns {Promise<LabQuickLinksLink[]>} Resolves to a list of links, or an empty array if none found.
      */
-    fetchLinkCollectionV1(options?: FetchLinkOptionsDtoV1): Promise<LabQuickLink[]>;
+    fetchLinkCollectionV1(options?: FetchLinkOptionsDtoV1): Promise<LabQuickLinksLink[]>;
 }
-export {};

package/dist/modules/services/providers/quick-links/quick-links.service.js

@@ -53,7 +53,7 @@ let QuickLinksService = class QuickLinksService extends base_http_service_1.Base
      *
      * @param {string} linkId - Unique MongoDB identifier of the link.
      * @param {FetchLinkOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
-     * @returns {Promise<LabQuickLink | undefined>} Resolves to an Link or `undefined` on failure.
+     * @returns {Promise<LabQuickLinksLink | undefined>} Resolves to an Link or `undefined` on failure.
      */
     async fetchLinkV1(linkId, options) {
         return this.fetchResource(`v1/internal/link/${linkId}`, { params: options });
@@ -65,7 +65,7 @@ let QuickLinksService = class QuickLinksService extends base_http_service_1.Base
      * Returns an empty array if the downstream service call fails.
      *
      * @param {FetchLinkOptionsDtoV1} [options] - Optional filter options for narrowing results.
-     * @returns {Promise<LabQuickLink[]>} Resolves to a list of links, or an empty array if none found.
+     * @returns {Promise<LabQuickLinksLink[]>} Resolves to a list of links, or an empty array if none found.
      */
     async fetchLinkCollectionV1(options) {
         return this.fetchResourceCollection(`v1/internal/links`, { params: options });

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

@@ -48,7 +48,9 @@ let RestrictedFieldsPipe = class RestrictedFieldsPipe {
             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);
+        const restrictions = this.reflector.get(RESTRICTED_METADATA_KEY, 
+        // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
+        (_c = metadata.metatype) === null || _c === void 0 ? void 0 : _c.prototype);
         if (!(0, class_validator_1.isObject)(restrictions))
             return value;
         for (const [propertyKey, requiredPerms] of Object.entries(restrictions)) {

package/package.json

@@ -4,7 +4,7 @@
     "name": "Timo Scheuermann",
     "email": "timo.scheuermann@sv-informatik.de"
   },
-  "version": "2.16.12",
+  "version": "2.16.13",
   "type": "commonjs",
   "files": [
     "dist"
@@ -22,48 +22,48 @@
     "release:patch": "npm version patch && git push origin master --follow-tags"
   },
   "dependencies": {
-    "@azure/identity": "^4.11.1",
-    "@keyv/redis": "^5.1.0",
+    "@azure/identity": "^4.13.0",
+    "@keyv/redis": "^5.1.3",
     "@nestjs/cache-manager": "^3.0.1",
-    "@nestjs/common": "^11.1.6",
+    "@nestjs/common": "^11.1.8",
     "@nestjs/config": "^4.0.2",
-    "@nestjs/core": "^11.1.6",
-    "@nestjs/jwt": "^11.0.0",
+    "@nestjs/core": "^11.1.8",
+    "@nestjs/jwt": "^11.0.1",
     "@nestjs/mongoose": "^11.0.3",
-    "@nestjs/swagger": "^11.2.0",
-    "axios": "^1.11.0",
-    "cache-manager": "^7.1.1",
+    "@nestjs/swagger": "^11.2.1",
+    "axios": "^1.13.1",
+    "cache-manager": "^7.2.4",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.2",
-    "itlab-functions": "^1.0.6",
-    "mongoose": "^8.17.1",
+    "itlab-functions": "^1.0.10",
+    "mongoose": "^8.19.2",
     "rxjs": "^7.8.2"
   },
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.1",
-    "@eslint/js": "^9.32.0",
+    "@eslint/js": "^9.38.0",
     "@nestjs/cli": "^11.0.10",
-    "@nestjs/schematics": "^11.0.7",
-    "@nestjs/testing": "^11.1.6",
-    "@types/express": "^5.0.3",
+    "@nestjs/schematics": "^11.0.9",
+    "@nestjs/testing": "^11.1.8",
+    "@types/express": "^5.0.5",
     "@types/jest": "^30.0.0",
-    "@types/node": "^24.2.0",
+    "@types/node": "^24.9.2",
     "@types/supertest": "^6.0.3",
-    "eslint": "^9.32.0",
+    "eslint": "^9.38.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.4",
-    "globals": "^16.3.0",
-    "jest": "^30.0.5",
+    "globals": "^16.4.0",
+    "jest": "^30.2.0",
     "prettier": "^3.6.2",
     "reflect-metadata": "^0.2.2",
     "source-map-support": "^0.5.21",
     "supertest": "^7.1.4",
-    "ts-jest": "^29.4.1",
-    "ts-loader": "^9.5.2",
+    "ts-jest": "^29.4.5",
+    "ts-loader": "^9.5.4",
     "ts-node": "^10.9.2",
     "tsconfig-paths": "^4.2.0",
-    "typescript": "^5.9.2",
-    "typescript-eslint": "^8.39.0"
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.46.2"
   },
   "jest": {
     "moduleFileExtensions": [

package/dist/classes/document-updater.class.d.ts

@@ -1,40 +0,0 @@
-import { Document } from 'mongoose';
-import { Viewable } from '../viewable.interface';
-/**
- * TODO: REMOVE
- * Facilitates asynchronous updates to documents by adding unique account IDs to specified
- * array attributes. This prevents duplication of IDs in those arrays, ensuring data integrity.
- *
- * Designed primarily for adding account references such as views or other related IDs.
- */
-export declare class DocumentUpdater {
-    private static readonly logger;
-    /**
-     * Adds an account ID uniquely to a specified array attribute of a document.
-     *
-     * This method verifies the presence of an accountId before proceeding.
-     * It then performs an atomic MongoDB `$addToSet` update on the document to
-     * add the accountId to the given attribute array only if it is not already present,
-     * preventing duplicates without needing to fetch the document first.
-     *
-     * Updates are saved without modifying timestamps to preserve original metadata.
-     *
-     * @template I - Interface representing the document’s shape.
-     * @template T - Mongoose Document type extending `Document`.
-     * @param document - The Mongoose document to update.
-     * @param attribute - The document attribute (key) representing the array to update.
-     * @param accountId - The unique account ID to add.
-     */
-    static addUniqueAccountId<I, T extends Document = Document>(document: T, attribute: keyof I, accountId?: string): void;
-    /**
-     * Adds a view record to a document by associating an account ID with the '_viewedBy' attribute.
-     *
-     * This method leverages `addUniqueAccountId` to add the given accountId to the '_viewedBy' array,
-     * ensuring each viewer is recorded only once.
-     *
-     * @template T - Mongoose Document type that extends Document and implements Viewable interface.
-     * @param target - The target document to record the view.
-     * @param accountId - The account ID representing the viewer.
-     */
-    static addView<T extends Document & Viewable>(target: T, accountId?: string): void;
-}

package/dist/classes/document-updater.class.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentUpdater = void 0;
-const common_1 = require("@nestjs/common");
-/**
- * TODO: REMOVE
- * Facilitates asynchronous updates to documents by adding unique account IDs to specified
- * array attributes. This prevents duplication of IDs in those arrays, ensuring data integrity.
- *
- * Designed primarily for adding account references such as views or other related IDs.
- */
-class DocumentUpdater {
-    /**
-     * Adds an account ID uniquely to a specified array attribute of a document.
-     *
-     * This method verifies the presence of an accountId before proceeding.
-     * It then performs an atomic MongoDB `$addToSet` update on the document to
-     * add the accountId to the given attribute array only if it is not already present,
-     * preventing duplicates without needing to fetch the document first.
-     *
-     * Updates are saved without modifying timestamps to preserve original metadata.
-     *
-     * @template I - Interface representing the document’s shape.
-     * @template T - Mongoose Document type extending `Document`.
-     * @param document - The Mongoose document to update.
-     * @param attribute - The document attribute (key) representing the array to update.
-     * @param accountId - The unique account ID to add.
-     */
-    static addUniqueAccountId(document, attribute, accountId) {
-        if (!accountId)
-            return; // Exit if no accountId provided, avoiding unnecessary operations.
-        // Perform atomic update to add accountId uniquely to the attribute array.
-        document
-            .updateOne({ $addToSet: { [String(attribute)]: accountId } }, { timestamps: false })
-            .then(() => {
-            this.logger.log(`Added unique accountId '${accountId}' to attribute '${String(attribute)}' for document ${document._id.toString()}`);
-        })
-            .catch((error) => {
-            // Log any errors during the update operation for debugging and audit.
-            this.logger.error(`Failed to add accountId '${accountId}' to attribute '${String(attribute)}' for document ${document._id.toString()}: ${error.stack}`);
-        });
-    }
-    /**
-     * Adds a view record to a document by associating an account ID with the '_viewedBy' attribute.
-     *
-     * This method leverages `addUniqueAccountId` to add the given accountId to the '_viewedBy' array,
-     * ensuring each viewer is recorded only once.
-     *
-     * @template T - Mongoose Document type that extends Document and implements Viewable interface.
-     * @param target - The target document to record the view.
-     * @param accountId - The account ID representing the viewer.
-     */
-    static addView(target, accountId) {
-        this.addUniqueAccountId(target, '_viewedBy', accountId);
-    }
-}
-exports.DocumentUpdater = DocumentUpdater;
-DocumentUpdater.logger = new common_1.Logger('DocumentUpdater');

package/dist/factories/index.d.ts

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

package/dist/factories/index.js

@@ -1,5 +0,0 @@
-"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

@@ -1,80 +0,0 @@
-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;
-}