itlab-internal-services 2.15.7 → 2.16.1

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

@@ -0,0 +1,7 @@
+import { ContentReturnType } from '../modules';
+type PropertyContentReturnTypeOptions = {
+    optional?: boolean;
+    default?: ContentReturnType;
+};
+export declare function PropertyContentReturnType(options?: PropertyContentReturnTypeOptions): PropertyDecorator;
+export {};

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

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertyContentReturnType = PropertyContentReturnType;
+const common_1 = require("@nestjs/common");
+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");
+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' }),
+    ];
+    if (options.optional) {
+        decorators.push(common_1.Optional);
+    }
+    return (0, common_1.applyDecorators)(...decorators);
+}

package/dist/properties/index.d.ts

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

package/dist/properties/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertiesViewable = exports.PropertiesLikeable = exports.PropertyContent = exports.PropertyContentReturnType = void 0;
+var content_return_type_property_1 = require("./content-return-type.property");
+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, "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/properties/likeable.properties.d.ts

@@ -0,0 +1 @@
+export declare function PropertiesLikeable(): ClassDecorator;

package/dist/properties/likeable.properties.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertiesLikeable = PropertiesLikeable;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const models_1 = require("../models");
+function PropertiesLikeable() {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({
+        name: '_likedBy',
+        description: 'Array of user IDs that liked this resource.',
+        type: [String],
+        default: [],
+    }), (0, swagger_1.ApiPropertyOptional)({
+        name: 'likes',
+        description: 'Total number of likes for this resource.',
+        type: Number,
+        default: 0,
+    }), (0, swagger_1.ApiPropertyOptional)({
+        name: 'likedBy',
+        description: 'Populated list of User objects who liked this resource.',
+        type: [models_1.User],
+        default: [],
+    }));
+}
+// /**
+//  * Decorator for the internal array of user IDs who liked the resource.
+//  */
+// export function PropertyLikedBy(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: '_likedBy',
+//       description: 'Array of user IDs that liked this resource.',
+//       type: [String],
+//       default: [],
+//     }),
+//     Prop({ required: true, default: () => [] }),
+//   );
+// }
+// /**
+//  * Decorator for the total number of likes on the resource.
+//  */
+// export function PropertyLikes(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: 'likes',
+//       description: 'Total number of likes for this resource.',
+//       type: Number,
+//       default: 0,
+//     }),
+//     Prop({ required: true, default: 0 }),
+//   );
+// }
+// /**
+//  * Virtual decorator to expose the populated list of users who liked the resource.
+//  */
+// export function VirtualLikedBy(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: 'likedBy',
+//       description: 'Populated list of User objects who liked this resource.',
+//       type: [User],
+//       default: [],
+//     }),
+//     Virtual(),
+//   );
+// }

package/dist/properties/viewable.properties.d.ts

@@ -0,0 +1 @@
+export declare function PropertiesViewable(): ClassDecorator;

package/dist/properties/viewable.properties.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PropertiesViewable = PropertiesViewable;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const models_1 = require("../models");
+function PropertiesViewable() {
+    return (0, common_1.applyDecorators)((0, swagger_1.ApiPropertyOptional)({
+        name: '_viewedBy',
+        description: 'Array of user IDs that have viewed this resource.',
+        type: [String],
+        default: [],
+    }), (0, swagger_1.ApiPropertyOptional)({
+        name: 'views',
+        description: 'Total number of views for this resource.',
+        type: Number,
+        default: 0,
+    }), (0, swagger_1.ApiPropertyOptional)({
+        name: 'viewedBy',
+        description: 'Populated list of User objects who viewed this resource.',
+        type: [models_1.User],
+        default: [],
+    }));
+}
+// /**
+//  * Decorator for the internal array of user IDs who viewed the resource.
+//  */
+// export function PropertyViewedBy(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: '_viewedBy',
+//       description: 'Array of user IDs that have viewed this resource.',
+//       type: [String],
+//       default: [],
+//     }),
+//     Prop({ required: true, default: () => [] }),
+//   );
+// }
+// /**
+//  * Decorator for the total number of views on the resource.
+//  */
+// export function PropertyViews(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: 'views',
+//       description: 'Total number of views for this resource.',
+//       type: Number,
+//       default: 0,
+//     }),
+//     Prop({ required: true, default: 0 }),
+//   );
+// }
+// /**
+//  * Virtual decorator to expose the populated list of users who viewed the resource.
+//  */
+// export function VirtualViewedBy(): PropertyDecorator {
+//   return applyDecorators(
+//     ApiPropertyOptional({
+//       name: 'viewedBy',
+//       description: 'Populated list of User objects who viewed this resource.',
+//       type: [User],
+//       default: [],
+//     }),
+//     Virtual(),
+//   );
+// }

package/dist/swagger/index.d.ts

@@ -0,0 +1 @@
+export { initializeSwagger } from './swagger.function';

package/dist/swagger/index.js

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

package/dist/swagger/remove-public-route-auth.plugin.d.ts

@@ -0,0 +1,9 @@
+import { OpenAPIObject } from '@nestjs/swagger';
+/**
+ * Modifies Swagger documentation to remove "Auth Required" lock
+ * for routes marked with @Public() decorator.
+ *
+ * @param {OpenAPIObject} document - The generated Swagger document
+ * @returns {OpenAPIObject} - Modified Swagger document
+ */
+export declare function removePublicRouteAuth(document: OpenAPIObject): void;

package/dist/swagger/remove-public-route-auth.plugin.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.removePublicRouteAuth = removePublicRouteAuth;
+const service_auth_guard_1 = require("../modules/authentication/guards/service-auth.guard");
+/**
+ * Modifies Swagger documentation to remove "Auth Required" lock
+ * for routes marked with @Public() decorator.
+ *
+ * @param {OpenAPIObject} document - The generated Swagger document
+ * @returns {OpenAPIObject} - Modified Swagger document
+ */
+function removePublicRouteAuth(document) {
+    Object.values(document.paths).forEach((path) => {
+        Object.values(path).forEach((method) => {
+            if (Array.isArray(method.security) && method.security.includes('public')) {
+                method.security = [];
+                if (method.parameters) {
+                    method.parameters = method.parameters.filter((parameter) => parameter.name !== service_auth_guard_1.SERVICE_AUTH_HEADER_KEY);
+                }
+                delete method.responses['401'];
+                console.log(method);
+            }
+        });
+    });
+}

package/dist/swagger/swagger-options.interface.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Defines configurable options for setting up Swagger API documentation.
+ * This includes optional authentication mechanisms like JWT or Kubernetes API keys.
+ */
+export type SwaggerOptions = {
+    /**
+     * Title of the API documentation displayed in Swagger UI
+     */
+    title: string;
+    /**
+     * Short description of the API's purpose or scope
+     */
+    description: string;
+};

package/dist/swagger/swagger-options.interface.js

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

package/dist/swagger/swagger.function.d.ts

@@ -0,0 +1,11 @@
+import { INestApplication } from '@nestjs/common';
+import { SwaggerOptions } from './swagger-options.interface';
+/**
+ * Initializes Swagger documentation for a NestJS application.
+ * This function configures Swagger with API metadata, security schemes,
+ * and serves the Swagger UI at the `/api` endpoint.
+ *
+ * @param {INestApplication} app - The NestJS application instance to attach Swagger to.
+ * @param {SwaggerOptions} [options] - Configuration for Swagger metadata.
+ */
+export declare function initializeSwagger(app: INestApplication, options: SwaggerOptions): void;

package/dist/swagger/swagger.function.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.initializeSwagger = initializeSwagger;
+const swagger_1 = require("@nestjs/swagger");
+const service_auth_guard_1 = require("../modules/authentication/guards/service-auth.guard");
+const remove_public_route_auth_plugin_1 = require("./remove-public-route-auth.plugin");
+/**
+ * Initializes Swagger documentation for a NestJS application.
+ * This function configures Swagger with API metadata, security schemes,
+ * and serves the Swagger UI at the `/api` endpoint.
+ *
+ * @param {INestApplication} app - The NestJS application instance to attach Swagger to.
+ * @param {SwaggerOptions} [options] - Configuration for Swagger metadata.
+ */
+function initializeSwagger(app, options) {
+    var _a;
+    // Create a new DocumentBuilder to configure the Swagger documentation
+    const documentBuilder = new swagger_1.DocumentBuilder()
+        .setTitle(options.title)
+        .setDescription(options.description)
+        .setContact('Timo Scheuermann', '', 'timo.scheuermann@sv-informatik.de');
+    // Add the base server URL. Falls back to localhost if SWAGGER_BASE_PATH is not set
+    const baseUrl = (_a = process.env.SWAGGER_BASE_PATH) !== null && _a !== void 0 ? _a : 'http://localhost:3000';
+    documentBuilder.addServer(baseUrl);
+    // Configure JWT Bearer authentication for user endpoints
+    documentBuilder.addBearerAuth({
+        type: 'http',
+        in: 'header',
+        bearerFormat: 'JWT',
+        description: 'Gesicherter Login Token',
+    }, 'Auth Token');
+    // Configure API key authentication for internal service-to-service communication
+    documentBuilder.addApiKey({
+        type: 'apiKey',
+        in: 'header',
+        name: service_auth_guard_1.SERVICE_AUTH_HEADER_KEY,
+        description: 'Token for service authentication',
+    }, 'Service Token');
+    // Build the Swagger configuration from the builder
+    const swaggerConfig = documentBuilder.build();
+    // Generate the Swagger document using the NestJS application instance
+    const swaggerDocument = swagger_1.SwaggerModule.createDocument(app, swaggerConfig);
+    // Remove security from @Public endpoints
+    (0, remove_public_route_auth_plugin_1.removePublicRouteAuth)(swaggerDocument);
+    // Serve Swagger UI at the '/api' endpoint
+    swagger_1.SwaggerModule.setup('api', app, swaggerDocument);
+}

package/dist/transform/boolean.transform.js

@@ -2,6 +2,9 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BooleanTransform = BooleanTransform;
 const class_transformer_1 = require("class-transformer");
+// Standardize boolean input formats (string, number, or boolean)
+const trueValues = [true, 'true', 1, '1', 'yes', 'on'];
+const falseValues = [false, 'false', 0, '0', 'no', 'off'];
 /**
  * Property decorator to normalize boolean-like input values.
  * It converts various representations of truthy and falsy values (e.g., "true", "1", 1) into actual booleans.
@@ -11,9 +14,6 @@ const class_transformer_1 = require("class-transformer");
  */
 function BooleanTransform() {
     return (0, class_transformer_1.Transform)(({ value }) => {
-        // Standardize boolean input formats (string, number, or boolean)
-        const trueValues = [true, 'true', 1, '1', 'yes', 'on'];
-        const falseValues = [false, 'false', 0, '0', 'no', 'off'];
         // eslint-disable-next-line @typescript-eslint/no-unsafe-argument
         if (trueValues.includes(value))
             return true;

package/dist/types/index.d.ts

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

package/dist/types/index.js

@@ -0,0 +1,18 @@
+"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 });
+__exportStar(require("./likeable.type"), exports);
+__exportStar(require("./viewable.type"), exports);

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

@@ -0,0 +1,15 @@
+import { User } from '../models';
+/**
+ * Represents an entity that can be liked by users.
+ *
+ * - `_likedBy`: stores IDs of users who liked the entity.
+ * - `likes`: computed total number of likes.
+ * - `likedBy`: optional populated list of User objects.
+ */
+export type Likeable = {
+    _likedBy: string[];
+    likes: number;
+    likedBy?: User[];
+    addLike(accountId: string): Promise<void>;
+    removeLike(accountId: string): Promise<void>;
+};

package/dist/types/likeable.type.js

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

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

@@ -0,0 +1,15 @@
+import { User } from '../models';
+/**
+ * Represents an entity that can be viewed by users.
+ *
+ * - `_viewedBy`: stores IDs of users who viewed the entity.
+ * - `views`: computed total number of views.
+ * - `viewedBy`: optional populated list of User objects.
+ */
+export type Viewable = {
+    _viewedBy: string[];
+    views: number;
+    viewedBy?: User[];
+    addView(accountId: string): Promise<void>;
+    removeView(accountId: string): Promise<void>;
+};

package/dist/types/viewable.type.js

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

package/package.json

@@ -4,7 +4,7 @@
     "name": "Timo Scheuermann",
     "email": "timo.scheuermann@sv-informatik.de"
   },
-  "version": "2.15.7",
+  "version": "2.16.1",
   "type": "commonjs",
   "files": [
     "dist"
@@ -35,7 +35,7 @@
     "cache-manager": "^7.1.1",
     "class-transformer": "^0.5.1",
     "class-validator": "^0.14.2",
-    "itlab-functions": "^1.0.2",
+    "itlab-functions": "^1.0.6",
     "mongoose": "^8.17.1",
     "rxjs": "^7.8.2"
   },

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

@@ -1,39 +0,0 @@
-import { Document } from 'mongoose';
-import { Viewable } from '../viewable.interface';
-/**
- * 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,57 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentUpdater = void 0;
-const common_1 = require("@nestjs/common");
-/**
- * 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 * from './virtuals.factory';

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

@@ -1,79 +0,0 @@
-import { Schema, VirtualTypeOptions } from 'mongoose';
-import { HubResource } from '../hub-resource.enum';
-/**
- * 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;
-}