itlab-internal-services 2.15.6 → 2.16.0

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

@@ -0,0 +1,82 @@
+"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.AccountsService = void 0;
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../authentication");
+const base_http_service_1 = require("../base-http.service");
+const base_urls_1 = require("../base-urls");
+/**
+ * AccountsService
+ *
+ * Service client for interacting with the Accounts domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let AccountsService = class AccountsService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Accounts service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Accounts', base_urls_1.BaseUrls.AccountsService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single account entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} accountId - Unique MongoDB identifier of the account item.
+     * @returns {Promise<Account | undefined>} Resolves to the account object if found, otherwise `undefined`.
+     */
+    async getAccount(accountId) {
+        return this.fetchResource(`internal/account/${accountId}`);
+    }
+    /**
+     * Retrieves a collection of account entries by their MongoDB identifiers.
+     *
+     * If the downstream call fails, an empty array is returned.
+     *
+     * @param {string[]} accountIds - Array of MongoDB identifiers for the account items.
+     * @returns {Promise<Account[]>} Resolves to an array of account objects (empty if none found).
+     */
+    async getAccountCollection(accountIds) {
+        return this.fetchResourceCollection(`internal/accounts`, { params: { ids: accountIds } });
+    }
+    /**
+     * Retrieves a single user entry derived from an account.
+     *
+     * @param {string} userId - Unique identifier of the user (mapped from account ID).
+     * @returns {Promise<User | undefined>} Resolves to the user object if found, otherwise `undefined`.
+     */
+    async getUser(userId) {
+        return this.fetchResource(`internal/user/${userId}`);
+    }
+    /**
+     * Retrieves multiple users in a single request.
+     *
+     * @param {string[]} userIds - Array of user identifiers (mapped from account IDs).
+     * @returns {Promise<User[]>} Resolves to a list of users (empty array if none found).
+     */
+    async getUserCollection(userIds) {
+        return this.fetchResourceCollection(`internal/users`, { params: { ids: userIds } });
+    }
+};
+exports.AccountsService = AccountsService;
+exports.AccountsService = AccountsService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], AccountsService);

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

@@ -0,0 +1,29 @@
+import { ConfigService } from '@nestjs/config';
+import { LabBook } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * BooksService
+ *
+ * Service client for interacting with the Books domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class BooksService extends BaseHttpService {
+    /**
+     * Constructs a Books service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Retrieves a single book entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} bookId - Unique MongoDB identifier of the book item.
+     * @returns {Promise<LabBook | undefined>} Resolves to the book object if found, otherwise `undefined`.
+     */
+    fetchBookById(bookId?: string): Promise<LabBook>;
+}

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

@@ -0,0 +1,53 @@
+"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.BooksService = void 0;
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../authentication");
+const base_http_service_1 = require("../base-http.service");
+const base_urls_1 = require("../base-urls");
+/**
+ * BooksService
+ *
+ * Service client for interacting with the Books domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let BooksService = class BooksService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Books service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Books', base_urls_1.BaseUrls.BooksService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single book entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} bookId - Unique MongoDB identifier of the book item.
+     * @returns {Promise<LabBook | undefined>} Resolves to the book object if found, otherwise `undefined`.
+     */
+    async fetchBookById(bookId) {
+        return this.fetchResource(`internal/book/${bookId}`);
+    }
+};
+exports.BooksService = BooksService;
+exports.BooksService = BooksService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], BooksService);

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

@@ -0,0 +1,18 @@
+import { ConfigService } from '@nestjs/config';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * ChangelogService
+ *
+ * Service client for interacting with the Changelog domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class ChangelogService extends BaseHttpService {
+    /**
+     * Constructs a Changelog service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+}

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

@@ -0,0 +1,41 @@
+"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.ChangelogService = void 0;
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../authentication");
+const base_http_service_1 = require("../base-http.service");
+const base_urls_1 = require("../base-urls");
+/**
+ * ChangelogService
+ *
+ * Service client for interacting with the Changelog domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let ChangelogService = class ChangelogService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Changelog service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Changelog', base_urls_1.BaseUrls.ChangelogService, authenticationOptions, configService);
+    }
+};
+exports.ChangelogService = ChangelogService;
+exports.ChangelogService = ChangelogService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], ChangelogService);

package/dist/modules/services/providers/comments/comments.service-definition.d.ts

@@ -0,0 +1 @@
+export declare const FEATURE_COMMENTS_SERVICE_TOKEN: unique symbol;

package/dist/modules/services/providers/comments/comments.service-definition.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_COMMENTS_SERVICE_TOKEN = void 0;
+exports.FEATURE_COMMENTS_SERVICE_TOKEN = Symbol('FEATURE_COMMENTS_SERVICE_TOKEN');

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

@@ -0,0 +1,60 @@
+import { DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { LabCommentPopulated } from 'itlab-functions';
+import { HubResource } from '../../../../hub-resource.enum';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { CacheService } from '../../../cache';
+import { BaseHttpService } from '../../base-http.service';
+import { ServicesModuleOptions } from '../../services-module-options.interface';
+/**
+ * Parameter decorator to inject the feature-specific CommentsService.
+ */
+export declare function InjectFeatureCommentService(): ParameterDecorator;
+/**
+ * CommentsService
+ *
+ * Handles all HTTP interactions with the Comments domain.
+ * Inherits authentication, logging, and environment-aware behaviors from BaseHttpService.
+ */
+export declare class CommentsService extends BaseHttpService {
+    readonly options: ServicesModuleOptions;
+    private readonly cacheService?;
+    /**
+     * Creates a CommentsService client for a specific resource.
+     *
+     * @param authenticationOptions Authentication options injected from the Auth module.
+     * @param options Options specifying the resource type this service operates on.
+     * @param configService NestJS configuration service for environment variables and URLs.
+     * @param cacheService Optional caching service for retrieving content efficiently.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, options: ServicesModuleOptions, configService: ConfigService, cacheService?: CacheService);
+    /**
+     * Factory method to create a dynamic module for a specific Hub resource.
+     *
+     * @param resource The HubResource type this module will provide comments services for.
+     * @returns A DynamicModule with a provider for the specified CommentsService instance.
+     */
+    static forResource(resource: HubResource): DynamicModule;
+    /**
+     * Deletes all comments for a given resource.
+     * Logs success or failure. Does not throw to avoid disrupting cleanup flows.
+     *
+     * @param resourceId Unique identifier of the resource whose comments will be deleted.
+     */
+    deleteComments(resourceId: string): void;
+    /**
+     * Retrieves comments from the backend.
+     * Provides default values if comments retrieval fails.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Retrieved comments.
+     */
+    getPopulatedComments(resourceId: string): Promise<LabCommentPopulated[]>;
+    /**
+     * Retrieves comments from the cache if available; otherwise fetches from the backend.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Cached or freshly retrieved comments.
+     */
+    getCachedPopulatedComments(resourceId: string): Promise<LabCommentPopulated[]>;
+}

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

@@ -0,0 +1,138 @@
+"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); }
+};
+var CommentsService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommentsService = void 0;
+exports.InjectFeatureCommentService = InjectFeatureCommentService;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../../authentication");
+const authentication_module_definition_1 = require("../../../authentication/authentication.module-definition");
+const cache_1 = require("../../../cache");
+const base_http_service_1 = require("../../base-http.service");
+const base_urls_1 = require("../../base-urls");
+const services_options_parameter_1 = require("../../services-options.parameter");
+const comments_service_definition_1 = require("./comments.service-definition");
+/**
+ * Parameter decorator to inject the feature-specific CommentsService.
+ */
+function InjectFeatureCommentService() {
+    return (0, common_1.Inject)(comments_service_definition_1.FEATURE_COMMENTS_SERVICE_TOKEN);
+}
+/**
+ * CommentsService
+ *
+ * Handles all HTTP interactions with the Comments domain.
+ * Inherits authentication, logging, and environment-aware behaviors from BaseHttpService.
+ */
+let CommentsService = CommentsService_1 = class CommentsService extends base_http_service_1.BaseHttpService {
+    /**
+     * Creates a CommentsService client for a specific resource.
+     *
+     * @param authenticationOptions Authentication options injected from the Auth module.
+     * @param options Options specifying the resource type this service operates on.
+     * @param configService NestJS configuration service for environment variables and URLs.
+     * @param cacheService Optional caching service for retrieving content efficiently.
+     */
+    constructor(authenticationOptions, options, configService, cacheService) {
+        super('Comments', base_urls_1.BaseUrls.CommentsService, authenticationOptions, configService);
+        this.options = options;
+        this.cacheService = cacheService;
+    }
+    /**
+     * Factory method to create a dynamic module for a specific Hub resource.
+     *
+     * @param resource The HubResource type this module will provide comments services for.
+     * @returns A DynamicModule with a provider for the specified CommentsService instance.
+     */
+    static forResource(resource) {
+        let CommentsModule = class CommentsModule {
+        };
+        CommentsModule = __decorate([
+            (0, common_1.Module)({})
+        ], CommentsModule);
+        return {
+            module: CommentsModule,
+            exports: [comments_service_definition_1.FEATURE_COMMENTS_SERVICE_TOKEN],
+            providers: [
+                {
+                    provide: comments_service_definition_1.FEATURE_COMMENTS_SERVICE_TOKEN,
+                    inject: [authentication_module_definition_1.AUTHENTICATION_MODULE_OPTIONS_TOKEN, config_1.ConfigService],
+                    useFactory: (authenticationOptions, configService) => {
+                        return new CommentsService_1(authenticationOptions, { resource }, configService);
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Deletes all comments for a given resource.
+     * Logs success or failure. Does not throw to avoid disrupting cleanup flows.
+     *
+     * @param resourceId Unique identifier of the resource whose comments will be deleted.
+     */
+    deleteComments(resourceId) {
+        if (!this.options.resource) {
+            this.logger.error('Cannot delete comments: Resource type not provided.');
+            return;
+        }
+        const endpoint = `internal/${this.options.resource}/${resourceId}`;
+        this.logger.log(`Deleting all comments for ${this.options.resource} ${resourceId}...`);
+        this.client
+            .delete(endpoint)
+            .then(() => {
+            this.logger.log(`All comments for ${this.options.resource} ${resourceId} deleted successfully.`);
+        })
+            .catch((error) => {
+            const { message } = this.parseError(error);
+            this.logger.error(`Failed to delete comments for ${this.options.resource} ${resourceId}: ${message}`);
+        });
+    }
+    /**
+     * Retrieves comments from the backend.
+     * Provides default values if comments retrieval fails.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Retrieved comments.
+     */
+    async getPopulatedComments(resourceId) {
+        if (!this.options.resource) {
+            this.logger.error('Cannot fetch comments: Resource type not provided.');
+            return [];
+        }
+        return this.fetchResourceCollection(`internal/${this.options.resource}/${resourceId}/populated`);
+    }
+    /**
+     * Retrieves comments from the cache if available; otherwise fetches from the backend.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Cached or freshly retrieved comments.
+     */
+    async getCachedPopulatedComments(resourceId) {
+        const fetchPopulatedComments = () => this.getPopulatedComments(resourceId);
+        if (this.cacheService) {
+            const cacheKey = `${this.options.resource}.${resourceId}.populatedComments`;
+            return this.cacheService.fetchOrStore(cacheKey, fetchPopulatedComments, 30000);
+        }
+        return fetchPopulatedComments();
+    }
+};
+exports.CommentsService = CommentsService;
+exports.CommentsService = CommentsService = CommentsService_1 = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __param(1, (0, services_options_parameter_1.InjectServicesOptions)()),
+    __param(3, (0, common_1.Optional)()),
+    __metadata("design:paramtypes", [Object, Object, config_1.ConfigService,
+        cache_1.CacheService])
+], CommentsService);

package/dist/modules/services/providers/comments/index.d.ts

@@ -0,0 +1 @@
+export * from './comments.service';

package/dist/{factories → modules/services/providers/comments}/index.js

@@ -14,4 +14,4 @@ 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("./virtuals.factory"), exports);
+__exportStar(require("./comments.service"), exports);

package/dist/modules/services/providers/content/content-types.d.ts

@@ -0,0 +1,20 @@
+import { LabContent, LabContentPopulated } from 'itlab-functions';
+/**
+ * Constant list of supported digital pass types.
+ */
+declare const supportedContentTypes: readonly ["json", "text", "html", "populated"];
+/**
+ * Union type representing valid pass types.
+ */
+export type ContentType = (typeof supportedContentTypes)[number];
+/**
+ * Maps each supported pass type to its corresponding DTO.
+ * This enables type-safe payload handling when creating passes.
+ */
+export type ContentTypeReturnTypeMap = {
+    json: LabContent;
+    text: string;
+    html: LabContent;
+    populated: LabContentPopulated;
+};
+export {};

package/dist/modules/services/providers/content/content-types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Constant list of supported digital pass types.
+ */
+// eslint-disable-next-line
+const supportedContentTypes = ['json', 'text', 'html', 'populated'];

package/dist/modules/services/providers/content/content.service-definition.d.ts

@@ -0,0 +1 @@
+export declare const FEATURE_CONTENT_SERVICE_TOKEN: unique symbol;

package/dist/modules/services/providers/content/content.service-definition.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FEATURE_CONTENT_SERVICE_TOKEN = void 0;
+exports.FEATURE_CONTENT_SERVICE_TOKEN = Symbol('FEATURE_CONTENT_SERVICE_TOKEN');

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

@@ -0,0 +1,94 @@
+import { DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { LabContent } from 'itlab-functions';
+import { HubResource } from '../../../../hub-resource.enum';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { CacheService } from '../../../cache';
+import { BaseHttpService } from '../../base-http.service';
+import { ServicesModuleOptions } from '../../services-module-options.interface';
+import { ContentType, ContentTypeReturnTypeMap } from './content-types';
+/**
+ * Parameter decorator to inject the feature-specific ContentService.
+ */
+export declare function InjectFeatureContentService(): ParameterDecorator;
+/**
+ * Service responsible for all operations with the Organisation Hub Content Service.
+ *
+ * This includes:
+ * - Validating content structure before submission.
+ * - Submitting content to the backend.
+ * - Removing content from the backend.
+ * - Retrieving content in multiple formats.
+ *
+ * Optionally supports caching via `CacheService` for read operations.
+ */
+export declare class ContentService extends BaseHttpService {
+    readonly options: ServicesModuleOptions;
+    private readonly cacheService?;
+    /**
+     * Creates a ContentService client for a specific resource.
+     *
+     * @param authenticationOptions Authentication options injected from the Auth module.
+     * @param options Options specifying the resource type this service operates on.
+     * @param configService NestJS configuration service for environment variables and URLs.
+     * @param cacheService Optional caching service for retrieving content efficiently.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, options: ServicesModuleOptions, configService: ConfigService, cacheService?: CacheService);
+    /**
+     * Factory method to create a dynamic module for a specific Hub resource.
+     *
+     * @param resource The HubResource type this module will provide content services for.
+     * @returns A DynamicModule with a provider for the specified ContentService instance.
+     */
+    static forResource(resource: HubResource): DynamicModule;
+    /**
+     * Validates the given content object using the backend service.
+     * Logs the process and throws an HTTP exception if validation fails.
+     *
+     * @param content Content object to validate.
+     * @returns Resolves if validation is successful.
+     * @throws HttpException if the backend returns an error.
+     */
+    validateContent(content: LabContent): Promise<void>;
+    /**
+     * Submits content for a given resource.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @param content Content object to submit.
+     * @throws HttpException if the backend returns an error.
+     */
+    submitContent(resourceId: string, content: LabContent): Promise<void>;
+    /**
+     * Directly submits content without extra validation.
+     * Backend will handle validation internally.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @param content Content object to submit.
+     * @throws HttpException if the backend returns an error.
+     */
+    validateAndSubmitContent(resourceId: string, content: LabContent): Promise<void>;
+    /**
+     * Removes content associated with a given resource.
+     * Logs errors but does not throw; always resolves to allow safe cleanup.
+     *
+     * @param resourceId Unique identifier of the resource.
+     */
+    deleteContent(resourceId: string): void;
+    /**
+     * Retrieves content in a specified format from the backend.
+     * Provides default values if content retrieval fails.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @param type Format of content to retrieve ('json', 'text', 'html', 'populated').
+     * @returns Retrieved content in the requested format.
+     */
+    getContent<Type extends ContentType>(resourceId: string, type: Type): Promise<ContentTypeReturnTypeMap[Type]>;
+    /**
+     * Retrieves content from the cache if available; otherwise fetches from the backend.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @param type Format of content to retrieve.
+     * @returns Cached or freshly retrieved content.
+     */
+    getCachedContent<Type extends ContentType>(resourceId: string, type: Type): Promise<ContentTypeReturnTypeMap[Type]>;
+}