itlab-internal-services 2.15.6 → 2.16.0

package/dist/modules/merge/index.js

@@ -0,0 +1,19 @@
+"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("./merge-module-options.interface"), exports);
+__exportStar(require("./merge.module"), exports);
+__exportStar(require("./merge.service.interface"), exports);

package/dist/modules/merge/merge-module-options.interface.d.ts

@@ -0,0 +1,21 @@
+import { ModuleMetadata, Type } from '@nestjs/common';
+import { MergeModuleService } from './merge.service.interface';
+/**
+ * Configuration options for registering a merge module feature.
+ */
+export interface MergeModuleOptions {
+    /**
+     * Custom service class responsible for performing merges.
+     * Must implement `MergeModuleService`.
+     */
+    providerClass: Type<MergeModuleService>;
+    /**
+     * Optional: other modules required by the merge service.
+     */
+    imports?: ModuleMetadata['imports'];
+    /**
+     * Optional: suffix for the route (e.g. "news" → /merge/news).
+     * Defaults to just `/merge`.
+     */
+    routeSuffix?: string;
+}

package/dist/modules/merge/merge.controller.d.ts

@@ -0,0 +1,30 @@
+import { InjectionToken } from '@nestjs/common';
+import { MergeModuleService } from './merge.service.interface';
+/**
+ * Factory function for creating a MergeController bound to a specific route suffix.
+ *
+ * Why: Instead of writing separate controllers for each resource type,
+ * we generate one dynamically. This ensures DRY principles while still
+ * supporting custom routes (e.g. `/merge/news` or `/merge/event`).
+ *
+ * @param {InjectionToken} serviceToken - Token used for service injection.
+ * @param {string} [routeSuffix] - Optional suffix appended to the "merge" route.
+ * @returns A dynamically generated controller class.
+ */
+export declare function createMergeController(serviceToken: InjectionToken, routeSuffix?: string): {
+    new (mergeService: MergeModuleService): {
+        readonly mergeService: MergeModuleService;
+        /**
+         * Merge all references from an old account into a new account.
+         *
+         * Example:
+         *   PATCH /merge/news/account/123/456
+         *   → moves all references from account `123` to account `456`
+         *
+         * @param {string} oldAccountId - The identifier of the account being replaced.
+         * @param {string} newAccountId - The identifier of the account that should own all references.
+         * @returns {Promise<void>} - Resolves once the merge operation completes.
+         */
+        mergeAccount(oldAccountId: string, newAccountId: string): Promise<void>;
+    };
+};

package/dist/modules/merge/merge.controller.js

@@ -0,0 +1,76 @@
+"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.createMergeController = createMergeController;
+const common_1 = require("@nestjs/common");
+const swagger_1 = require("@nestjs/swagger");
+const pipes_1 = require("../../pipes");
+const authentication_1 = require("../authentication");
+/**
+ * Factory function for creating a MergeController bound to a specific route suffix.
+ *
+ * Why: Instead of writing separate controllers for each resource type,
+ * we generate one dynamically. This ensures DRY principles while still
+ * supporting custom routes (e.g. `/merge/news` or `/merge/event`).
+ *
+ * @param {InjectionToken} serviceToken - Token used for service injection.
+ * @param {string} [routeSuffix] - Optional suffix appended to the "merge" route.
+ * @returns A dynamically generated controller class.
+ */
+function createMergeController(serviceToken, routeSuffix) {
+    // Normalize route path, removing duplicate/trailing slashes
+    const normalizedRoute = `merge/${routeSuffix || ''}`.replace(/\/{2,}/g, '/').replace(/\/$/, '');
+    let MergeController = class MergeController {
+        constructor(mergeService) {
+            this.mergeService = mergeService;
+        }
+        /**
+         * Merge all references from an old account into a new account.
+         *
+         * Example:
+         *   PATCH /merge/news/account/123/456
+         *   → moves all references from account `123` to account `456`
+         *
+         * @param {string} oldAccountId - The identifier of the account being replaced.
+         * @param {string} newAccountId - The identifier of the account that should own all references.
+         * @returns {Promise<void>} - Resolves once the merge operation completes.
+         */
+        async mergeAccount(oldAccountId, newAccountId) {
+            await this.mergeService.mergeAccount(oldAccountId, newAccountId);
+        }
+    };
+    __decorate([
+        (0, swagger_1.ApiOperation)({
+            summary: 'Merge account references',
+            description: 'Moves all references from the old account into the new account. ' +
+                'All fields that store account IDs will be updated accordingly.',
+        }),
+        (0, pipes_1.ApiMongoIdParam)('oldAccountId', 'The ID of the account being replaced.'),
+        (0, pipes_1.ApiMongoIdParam)('newAccountId', 'The ID of the account that should own all references.'),
+        (0, common_1.Patch)('account/:oldAccountId/:newAccountId'),
+        __param(0, (0, pipes_1.MongoIdParam)('oldAccountId')),
+        __param(1, (0, pipes_1.MongoIdParam)('newAccountId')),
+        __metadata("design:type", Function),
+        __metadata("design:paramtypes", [String, String]),
+        __metadata("design:returntype", Promise)
+    ], MergeController.prototype, "mergeAccount", null);
+    MergeController = __decorate([
+        (0, authentication_1.RequireServiceAuth)(),
+        (0, swagger_1.ApiTags)('Merge'),
+        (0, common_1.Controller)(normalizedRoute),
+        __param(0, (0, common_1.Inject)(serviceToken)),
+        __metadata("design:paramtypes", [Object])
+    ], MergeController);
+    return MergeController;
+}

package/dist/modules/merge/merge.module.d.ts

@@ -0,0 +1,18 @@
+import { DynamicModule } from '@nestjs/common';
+import { MergeModuleOptions } from './merge-module-options.interface';
+/**
+ * NestJS module for registering a merge feature.
+ *
+ * Use `forFeature()` to register your merge service implementation
+ * and any supporting modules. This method dynamically creates and
+ * registers a merge controller.
+ */
+export declare class MergeModule {
+    /**
+     * Configure MergeModule with a custom service and supporting modules.
+     *
+     * @param {MergeModuleOptions} options - Options including service and imports.
+     * @returns {DynamicModule} A dynamic module bound to the provided service.
+     */
+    static forFeature(options: MergeModuleOptions): DynamicModule;
+}

package/dist/modules/merge/merge.module.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 MergeModule_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MergeModule = void 0;
+const common_1 = require("@nestjs/common");
+const merge_controller_1 = require("./merge.controller");
+/**
+ * NestJS module for registering a merge feature.
+ *
+ * Use `forFeature()` to register your merge service implementation
+ * and any supporting modules. This method dynamically creates and
+ * registers a merge controller.
+ */
+let MergeModule = MergeModule_1 = class MergeModule {
+    /**
+     * Configure MergeModule with a custom service and supporting modules.
+     *
+     * @param {MergeModuleOptions} options - Options including service and imports.
+     * @returns {DynamicModule} A dynamic module bound to the provided service.
+     */
+    static forFeature(options) {
+        const serviceToken = Symbol('MERGE_MODULE_SERVICE_TOKEN');
+        const MergeController = (0, merge_controller_1.createMergeController)(serviceToken, options.routeSuffix);
+        return {
+            module: MergeModule_1,
+            imports: options.imports,
+            providers: [{ provide: serviceToken, useClass: options.providerClass }],
+            controllers: [MergeController],
+        };
+    }
+};
+exports.MergeModule = MergeModule;
+exports.MergeModule = MergeModule = MergeModule_1 = __decorate([
+    (0, common_1.Module)({})
+], MergeModule);

package/dist/modules/merge/merge.service.interface.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Defines the contract for a merge service.
+ *
+ * Any service implementing this interface is expected to:
+ * - Transfer all references from one account to another.
+ * - Ensure that all account ID fields are updated.
+ */
+export interface MergeModuleService {
+    /**
+     * Merge all references from the old account into the new account.
+     *
+     * @param {string} oldAccountId - The identifier of the account being replaced.
+     * @param {string} newAccountId - The identifier of the account that should own all references.
+     * @returns {Promise<void>} Resolves when the merge operation is complete.
+     */
+    mergeAccount(oldAccountId: string, newAccountId: string): Promise<void>;
+}

package/dist/modules/services/base-http.service.d.ts

@@ -0,0 +1,83 @@
+import { Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { AxiosInstance, AxiosRequestConfig } from 'axios';
+import { AuthenticationModuleOptions } from '../authentication';
+import { InternalExternalUrl } from './base-urls';
+/**
+ * BaseHttpService
+ *
+ * A strongly typed, structured wrapper around Axios that standardizes outbound HTTP calls.
+ *
+ * Core Responsibilities:
+ * - Dynamically resolves internal vs external base URLs depending on environment.
+ * - Injects Kubernetes service authentication tokens into every request.
+ * - Adds structured logging for visibility into outbound traffic.
+ *
+ * Why use composition over inheritance with Axios?
+ * - Axios is both callable and constructable, leading to TypeScript conflicts when extended.
+ * - Wrapping avoids prototype traps, giving us full control over configuration and flow.
+ */
+export declare abstract class BaseHttpService {
+    private readonly serviceName;
+    private readonly baseUrls;
+    private readonly authenticationOptions;
+    private readonly configService;
+    readonly client: AxiosInstance;
+    protected readonly logger: Logger;
+    protected readonly isProduction: boolean;
+    /**
+     * Initializes a new HTTP service client tied to a specific downstream service.
+     *
+     * @param {string} serviceName - Identifier used for contextual logging (e.g., `"Comments"`).
+     * @param {InternalExternalUrl} baseUrls - A tuple `[internalUrl, externalUrl]`. Production prefers internal.
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication configuration containing Kubernetes token.
+     * @param {ConfigService} configService - NestJS config service used to resolve runtime environment.
+     */
+    constructor(serviceName: string, baseUrls: InternalExternalUrl, authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Normalizes Axios error responses into a consistent object.
+     * Ensures structured error handling regardless of the downstream service implementation.
+     *
+     * @param {any} error - Raw Axios error object.
+     * @returns {{ status: number; data: string | Record<string, any>; message: string }}
+     */
+    protected parseError(error: any): {
+        status: number;
+        data: string | Record<string, any>;
+        message: string;
+    };
+    /**
+     * Fetches a single resource from the downstream service.
+     *
+     * This is a safe wrapper around Axios `.get` that:
+     * - Allows request customization through an optional `config`.
+     * - Logs request failures with contextual detail for easier troubleshooting.
+     * - Returns `undefined` instead of throwing, enabling graceful fallbacks in callers.
+     *
+     * @template T
+     * @param {string} endpoint - The relative endpoint to request from the downstream service.
+     * @param {AxiosRequestConfig} [config={}] - Optional Axios request configuration.
+     *   Use this to pass custom headers, query parameters, authentication tokens,
+     *   or override default client behavior for this specific request.
+     * @returns {Promise<T | undefined>} A promise resolving to the resource of type `T`,
+     *   or `undefined` if the request fails.
+     */
+    protected fetchResource<T>(endpoint: string, config?: AxiosRequestConfig): Promise<T | undefined>;
+    /**
+     * Fetches a collection of resources from the downstream service.
+     *
+     * This is a safe wrapper around Axios `.get` that:
+     * - Allows request customization through an optional `config`.
+     * - Logs request failures with contextual detail for easier troubleshooting.
+     * - Returns `undefined` instead of throwing, enabling graceful fallbacks in callers.
+     *
+     * @template T
+     * @param {string} endpoint - The relative endpoint to request from the downstream service.
+     * @param {AxiosRequestConfig} [config={}] - Optional Axios request configuration.
+     *   Use this to pass custom headers, query parameters, authentication tokens,
+     *   or override default client behavior for this specific request.
+     * @returns {Promise<T[]>} A promise resolving to an array of resources of type `T`,
+     *   or an empty array if the request fails.
+     */
+    protected fetchResourceCollection<T>(endpoint: string, config?: AxiosRequestConfig): Promise<T[]>;
+}

package/dist/modules/services/base-http.service.js

@@ -0,0 +1,124 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseHttpService = void 0;
+const common_1 = require("@nestjs/common");
+const axios_1 = __importDefault(require("axios"));
+const class_validator_1 = require("class-validator");
+const service_auth_guard_1 = require("../authentication/guards/service-auth.guard");
+/**
+ * BaseHttpService
+ *
+ * A strongly typed, structured wrapper around Axios that standardizes outbound HTTP calls.
+ *
+ * Core Responsibilities:
+ * - Dynamically resolves internal vs external base URLs depending on environment.
+ * - Injects Kubernetes service authentication tokens into every request.
+ * - Adds structured logging for visibility into outbound traffic.
+ *
+ * Why use composition over inheritance with Axios?
+ * - Axios is both callable and constructable, leading to TypeScript conflicts when extended.
+ * - Wrapping avoids prototype traps, giving us full control over configuration and flow.
+ */
+class BaseHttpService {
+    /**
+     * Initializes a new HTTP service client tied to a specific downstream service.
+     *
+     * @param {string} serviceName - Identifier used for contextual logging (e.g., `"Comments"`).
+     * @param {InternalExternalUrl} baseUrls - A tuple `[internalUrl, externalUrl]`. Production prefers internal.
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication configuration containing Kubernetes token.
+     * @param {ConfigService} configService - NestJS config service used to resolve runtime environment.
+     */
+    constructor(serviceName, baseUrls, authenticationOptions, configService) {
+        this.serviceName = serviceName;
+        this.baseUrls = baseUrls;
+        this.authenticationOptions = authenticationOptions;
+        this.configService = configService;
+        this.logger = new common_1.Logger(`${this.serviceName}Service`);
+        this.isProduction = this.configService.get('NODE_ENV') === 'production';
+        // Create a scoped Axios instance bound to the appropriate base URL.
+        this.client = axios_1.default.create({
+            baseURL: this.baseUrls[this.isProduction ? 0 : 1],
+            headers: {
+                // Always include internal Kubernetes token for downstream service authentication.
+                [service_auth_guard_1.SERVICE_AUTH_HEADER_KEY]: this.authenticationOptions.k8sToken,
+            },
+        });
+        // Attach request interceptor for consistent logging of all outgoing requests.
+        this.client.interceptors.request.use((config) => {
+            var _a;
+            this.logger.log(`[${(_a = config.method) === null || _a === void 0 ? void 0 : _a.toUpperCase()}] ${config.url}`);
+            return config;
+        });
+    }
+    /**
+     * Normalizes Axios error responses into a consistent object.
+     * Ensures structured error handling regardless of the downstream service implementation.
+     *
+     * @param {any} error - Raw Axios error object.
+     * @returns {{ status: number; data: string | Record<string, any>; message: string }}
+     */
+    parseError(error) {
+        var _a, _b;
+        const status = ((_a = error === null || error === void 0 ? void 0 : error.response) === null || _a === void 0 ? void 0 : _a.status) || 500;
+        const data = ((_b = error === null || error === void 0 ? void 0 : error.response) === null || _b === void 0 ? void 0 : _b.data) || 'Internal server error';
+        return { status, data, message: (0, class_validator_1.isObject)(data) ? JSON.stringify(data) : String(data) };
+    }
+    /**
+     * Fetches a single resource from the downstream service.
+     *
+     * This is a safe wrapper around Axios `.get` that:
+     * - Allows request customization through an optional `config`.
+     * - Logs request failures with contextual detail for easier troubleshooting.
+     * - Returns `undefined` instead of throwing, enabling graceful fallbacks in callers.
+     *
+     * @template T
+     * @param {string} endpoint - The relative endpoint to request from the downstream service.
+     * @param {AxiosRequestConfig} [config={}] - Optional Axios request configuration.
+     *   Use this to pass custom headers, query parameters, authentication tokens,
+     *   or override default client behavior for this specific request.
+     * @returns {Promise<T | undefined>} A promise resolving to the resource of type `T`,
+     *   or `undefined` if the request fails.
+     */
+    async fetchResource(endpoint, config = {}) {
+        try {
+            const response = await this.client.get(endpoint, config);
+            return response.data;
+        }
+        catch (error) {
+            const { message } = this.parseError(error);
+            this.logger.error(`Failed to fetch resource at endpoint "${endpoint}": ${message}. Config: ${JSON.stringify(config)}`);
+            return undefined;
+        }
+    }
+    /**
+     * Fetches a collection of resources from the downstream service.
+     *
+     * This is a safe wrapper around Axios `.get` that:
+     * - Allows request customization through an optional `config`.
+     * - Logs request failures with contextual detail for easier troubleshooting.
+     * - Returns `undefined` instead of throwing, enabling graceful fallbacks in callers.
+     *
+     * @template T
+     * @param {string} endpoint - The relative endpoint to request from the downstream service.
+     * @param {AxiosRequestConfig} [config={}] - Optional Axios request configuration.
+     *   Use this to pass custom headers, query parameters, authentication tokens,
+     *   or override default client behavior for this specific request.
+     * @returns {Promise<T[]>} A promise resolving to an array of resources of type `T`,
+     *   or an empty array if the request fails.
+     */
+    async fetchResourceCollection(endpoint, config = {}) {
+        try {
+            const response = await this.client.get(endpoint, config);
+            return response.data;
+        }
+        catch (error) {
+            const { message } = this.parseError(error);
+            this.logger.error(`Failed to fetch resource collection at endpoint "${endpoint}": ${message}. Config: ${JSON.stringify(config)}`);
+            return [];
+        }
+    }
+}
+exports.BaseHttpService = BaseHttpService;

package/dist/modules/services/base-urls.d.ts

@@ -0,0 +1,22 @@
+export type InternalExternalUrl = [internalUrl: string, externalUrl: string];
+export declare class BaseUrls {
+    static get NewsroomService(): InternalExternalUrl;
+    static get EventsService(): InternalExternalUrl;
+    static get HackschoolService(): InternalExternalUrl;
+    static get DemoHiveService(): InternalExternalUrl;
+    static get TechRadarService(): InternalExternalUrl;
+    static get PodcastsService(): InternalExternalUrl;
+    static get BooksService(): InternalExternalUrl;
+    static get TeamService(): InternalExternalUrl;
+    static get NewsletterService(): InternalExternalUrl;
+    static get IdeasService(): InternalExternalUrl;
+    static get LunchRouletteService(): InternalExternalUrl;
+    static get AccountsService(): InternalExternalUrl;
+    static get CommentsService(): InternalExternalUrl;
+    static get NotificationService(): InternalExternalUrl;
+    static get MailService(): InternalExternalUrl;
+    static get SearchService(): InternalExternalUrl;
+    static get ChangelogService(): InternalExternalUrl;
+    static get PassService(): InternalExternalUrl;
+    static get ContentService(): InternalExternalUrl;
+}

package/dist/modules/services/base-urls.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseUrls = void 0;
+class BaseUrls {
+    static get NewsroomService() {
+        return [
+            'http://organisation-hub-newsroom-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/newsroom/',
+        ];
+    }
+    static get EventsService() {
+        return [
+            'http://organisation-hub-events-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/events/',
+        ];
+    }
+    static get HackschoolService() {
+        return [
+            'http://organisation-hub-hackschool-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/hackschool/',
+        ];
+    }
+    static get DemoHiveService() {
+        return [
+            'http://organisation-hub-demo-hive-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/demo-hive/',
+        ];
+    }
+    static get TechRadarService() {
+        return [
+            'http://organisation-hub-tech-radar-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/tech-radar/',
+        ];
+    }
+    static get PodcastsService() {
+        return [
+            'http://organisation-hub-podcasts-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/podcasts/',
+        ];
+    }
+    static get BooksService() {
+        return [
+            'http://organisation-hub-books-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/books/',
+        ];
+    }
+    static get TeamService() {
+        return [
+            'http://organisation-hub-team-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/team/',
+        ];
+    }
+    static get NewsletterService() {
+        return [
+            'http://organisation-hub-newsletter-backend.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/newsletter/',
+        ];
+    }
+    static get IdeasService() {
+        return [
+            'http://organisation-hub-ideas-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/ideas/',
+        ];
+    }
+    static get LunchRouletteService() {
+        return [
+            'http://project-lunch-roulette-backend.project-lunch-roulette.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/lunch-roulette/',
+        ];
+    }
+    // Utils
+    static get AccountsService() {
+        return [
+            'http://organisation-hub-accounts-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/accounts/',
+        ];
+    }
+    static get CommentsService() {
+        return [
+            'http://organisation-hub-comments-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/comments/',
+        ];
+    }
+    static get NotificationService() {
+        return [
+            'http://organisation-hub-notifications-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/notifications/',
+        ];
+    }
+    static get MailService() {
+        return [
+            'http://organisation-hub-email-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/email/',
+        ];
+    }
+    static get SearchService() {
+        return [
+            'http://organisation-hub-search-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/search/',
+        ];
+    }
+    static get ChangelogService() {
+        return [
+            'http://organisation-hub-changelog-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/changelog/',
+        ];
+    }
+    static get PassService() {
+        return [
+            'http://organisation-hub-pass-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/pass/',
+        ];
+    }
+    static get ContentService() {
+        return [
+            'http://organisation-hub-content-service.organisation-hub-services.svc.cluster.local:3000/',
+            'https://services.svi-itlab.com/content/',
+        ];
+    }
+}
+exports.BaseUrls = BaseUrls;

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

@@ -0,0 +1,4 @@
+export * from './services-module-options.interface';
+export * from './services-options.parameter';
+export * from './services.module';
+export * from './providers';

package/dist/modules/services/index.js

@@ -0,0 +1,20 @@
+"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("./services-module-options.interface"), exports);
+__exportStar(require("./services-options.parameter"), exports);
+__exportStar(require("./services.module"), exports);
+__exportStar(require("./providers"), exports);

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

@@ -0,0 +1,52 @@
+import { ConfigService } from '@nestjs/config';
+import { Account, User } from '../../../models';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * AccountsService
+ *
+ * Service client for interacting with the Accounts domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class AccountsService extends 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: AuthenticationModuleOptions, configService: 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`.
+     */
+    getAccount(accountId: string): Promise<Account | undefined>;
+    /**
+     * 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).
+     */
+    getAccountCollection(accountIds: string[]): Promise<Account[]>;
+    /**
+     * 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`.
+     */
+    getUser(userId: string): Promise<User | undefined>;
+    /**
+     * 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).
+     */
+    getUserCollection(userIds: string[]): Promise<User[]>;
+}