itlab-internal-services 2.15.7 → 2.16.0

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

@@ -0,0 +1,29 @@
+import { ConfigService } from '@nestjs/config';
+import { LabPodcast } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * PodcastsService
+ *
+ * Service client for interacting with the Podcasts domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class PodcastsService extends BaseHttpService {
+    /**
+     * Constructs a Podcasts 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 podcast 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} podcastId - Unique MongoDB identifier of the podcast item.
+     * @returns {Promise<LabPodcast | undefined>} Resolves to the podcast object if found, otherwise `undefined`.
+     */
+    fetchPodcastById(podcastId: string): Promise<LabPodcast | undefined>;
+}

package/dist/modules/services/providers/podcasts.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.PodcastsService = 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");
+/**
+ * PodcastsService
+ *
+ * Service client for interacting with the Podcasts domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let PodcastsService = class PodcastsService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Podcasts service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Podcasts', base_urls_1.BaseUrls.PodcastsService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single podcast 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} podcastId - Unique MongoDB identifier of the podcast item.
+     * @returns {Promise<LabPodcast | undefined>} Resolves to the podcast object if found, otherwise `undefined`.
+     */
+    async fetchPodcastById(podcastId) {
+        return this.fetchResource(`internal/podcast/${podcastId}`);
+    }
+};
+exports.PodcastsService = PodcastsService;
+exports.PodcastsService = PodcastsService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], PodcastsService);

package/dist/modules/services/providers/search/dtos/index-search-document.dto.js

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

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

@@ -0,0 +1,2 @@
+export * from './dtos';
+export * from './search.service';

package/dist/modules/services/providers/search/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("./dtos"), exports);
+__exportStar(require("./search.service"), exports);

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

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

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

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

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

@@ -0,0 +1,66 @@
+import { DynamicModule } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { HubResource } from '../../../../hub-resource.enum';
+import { SearchDocument } from '../../../../models';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { CacheService } from '../../../cache';
+import { BaseHttpService } from '../../base-http.service';
+import { ServicesModuleOptions } from '../../services-module-options.interface';
+import { IndexSearchDocumentDto } from './dtos';
+export declare function InjectFeatureSearchService(): ParameterDecorator;
+/**
+ * SearchService
+ *
+ * Handles indexing, deindexing, and similarity search for specified resource types.
+ * Acts as a bridge to an internal search microservice (e.g., Meilisearch).
+ */
+export declare class SearchService extends BaseHttpService {
+    readonly options: ServicesModuleOptions;
+    private readonly cacheService?;
+    /**
+     * Creates a SearchService 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 similar documents efficiently.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, options: ServicesModuleOptions, configService: ConfigService, cacheService?: CacheService);
+    /**
+     * Factory method for creating a resource-specific SearchService module.
+     *
+     * @param resource - The resource type this module will provide services for.
+     * @returns A DynamicModule that provides a SearchService instance for the specified resource.
+     */
+    static forResource(resource: HubResource): DynamicModule;
+    /**
+     * Indexes or updates a searchable document in the search index.
+     * Useful for ensuring resource changes are discoverable via search.
+     *
+     * @param {string} resourceId - Unique identifier of the resource.
+     * @param {IndexSearchDocumentDto} document - Document containing searchable content.
+     */
+    indexDocument(resourceId: string, document: IndexSearchDocumentDto): void;
+    /**
+     * Removes a resource from the search index.
+     * Ideal when the resource is deleted or should no longer be discoverable.
+     *
+     * @param {string} resourceId - Identifier of the resource to be deindexed.
+     */
+    deleteDocument(resourceId: string): void;
+    /**
+     * Retrieves documents similar to the provided resource from the search index.
+     * Helps with content discovery and recommendations.
+     *
+     * @param {string} resourceId - Identifier of the base resource for similarity matching.
+     * @returns {Promise<SearchDocument[]>} - Array of documents similar to the given resource.
+     */
+    getSimilarDocuments(resourceId: string): Promise<SearchDocument[]>;
+    /**
+     * Retrieves similar documents from the cache if available; otherwise fetches from the backend.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Cached or freshly retrieved similar documents.
+     */
+    getCachedSimilarDocuments(resourceId: string): Promise<SearchDocument[]>;
+}

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

@@ -0,0 +1,171 @@
+"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 SearchService_1;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SearchService = void 0;
+exports.InjectFeatureSearchService = InjectFeatureSearchService;
+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 search_service_definition_1 = require("./search.service-definition");
+function InjectFeatureSearchService() {
+    return (0, common_1.Inject)(search_service_definition_1.FEATURE_SEARCH_SERVICE_TOKEN);
+}
+/**
+ * SearchService
+ *
+ * Handles indexing, deindexing, and similarity search for specified resource types.
+ * Acts as a bridge to an internal search microservice (e.g., Meilisearch).
+ */
+let SearchService = SearchService_1 = class SearchService extends base_http_service_1.BaseHttpService {
+    /**
+     * Creates a SearchService 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 similar documents efficiently.
+     */
+    constructor(authenticationOptions, options, configService, cacheService) {
+        super('Search', base_urls_1.BaseUrls.SearchService, authenticationOptions, configService);
+        this.options = options;
+        this.cacheService = cacheService;
+    }
+    /**
+     * Factory method for creating a resource-specific SearchService module.
+     *
+     * @param resource - The resource type this module will provide services for.
+     * @returns A DynamicModule that provides a SearchService instance for the specified resource.
+     */
+    static forResource(resource) {
+        let SearchModule = class SearchModule {
+        };
+        SearchModule = __decorate([
+            (0, common_1.Module)({})
+        ], SearchModule);
+        return {
+            module: SearchModule,
+            exports: [search_service_definition_1.FEATURE_SEARCH_SERVICE_TOKEN],
+            providers: [
+                {
+                    provide: search_service_definition_1.FEATURE_SEARCH_SERVICE_TOKEN,
+                    inject: [authentication_module_definition_1.AUTHENTICATION_MODULE_OPTIONS_TOKEN, config_1.ConfigService],
+                    useFactory: (authenticationOptions, configService) => {
+                        return new SearchService_1(authenticationOptions, { resource }, configService);
+                    },
+                },
+            ],
+        };
+    }
+    /**
+     * Indexes or updates a searchable document in the search index.
+     * Useful for ensuring resource changes are discoverable via search.
+     *
+     * @param {string} resourceId - Unique identifier of the resource.
+     * @param {IndexSearchDocumentDto} document - Document containing searchable content.
+     */
+    indexDocument(resourceId, document) {
+        if (!this.options.resource) {
+            this.logger.error('Cannot index document: Resource type not provided.');
+            return;
+        }
+        const endpoint = `internal/${this.options.resource}/${resourceId}`;
+        this.logger.log(`Indexing document for ${this.options.resource} ${resourceId}...`);
+        this.client
+            .post(endpoint, document)
+            .then(() => {
+            this.logger.log(`Document sucessfully indexed for ${this.options.resource} ${resourceId}.`);
+        })
+            .catch((error) => {
+            const { message } = this.parseError(error);
+            this.logger.error(`Document indexing failed for ${this.options.resource} ${resourceId}: ${message}`);
+        });
+    }
+    /**
+     * Removes a resource from the search index.
+     * Ideal when the resource is deleted or should no longer be discoverable.
+     *
+     * @param {string} resourceId - Identifier of the resource to be deindexed.
+     */
+    deleteDocument(resourceId) {
+        if (!this.options.resource) {
+            this.logger.error('Cannot remove document: Resource type not provided.');
+            return;
+        }
+        const endpoint = `internal/${this.options.resource}/${resourceId}`;
+        this.logger.log(`Removing document for ${this.options.resource} ${resourceId}...`);
+        this.client
+            .delete(endpoint)
+            .then(() => {
+            this.logger.log(`Document removed sucessfully for ${this.options.resource} ${resourceId}.`);
+        })
+            .catch((error) => {
+            const { message } = this.parseError(error);
+            this.logger.error(`Document removal failed for ${this.options.resource} ${resourceId}: ${message}`);
+        });
+    }
+    /**
+     * Retrieves documents similar to the provided resource from the search index.
+     * Helps with content discovery and recommendations.
+     *
+     * @param {string} resourceId - Identifier of the base resource for similarity matching.
+     * @returns {Promise<SearchDocument[]>} - Array of documents similar to the given resource.
+     */
+    async getSimilarDocuments(resourceId) {
+        if (!this.options.resource) {
+            this.logger.error('Cannot search for similar documents: Resource type not provided.');
+            return [];
+        }
+        const endpoint = `internal/${this.options.resource}/${resourceId}/similar`;
+        this.logger.log(`Fetching similar documents for ${this.options.resource} ${resourceId}...`);
+        try {
+            const { data } = await this.client.get(endpoint);
+            this.logger.log(`Successfully retrieved similar documents for ${this.options.resource} ${resourceId}.`);
+            return data;
+        }
+        catch (error) {
+            const { message } = this.parseError(error);
+            this.logger.error(`Failed to fetch similar documents for ${this.options.resource} ${resourceId}: ${message}`);
+            return [];
+        }
+    }
+    /**
+     * Retrieves similar documents from the cache if available; otherwise fetches from the backend.
+     *
+     * @param resourceId Unique identifier of the resource.
+     * @returns Cached or freshly retrieved similar documents.
+     */
+    async getCachedSimilarDocuments(resourceId) {
+        const fetchSimilarDocuments = () => this.getSimilarDocuments(resourceId);
+        if (this.cacheService) {
+            const cacheKey = `${this.options.resource}.${resourceId}.similarDocuments`;
+            return this.cacheService.fetchOrStore(cacheKey, fetchSimilarDocuments, 600000);
+        }
+        return fetchSimilarDocuments();
+    }
+};
+exports.SearchService = SearchService;
+exports.SearchService = SearchService = SearchService_1 = __decorate([
+    (0, common_1.Injectable)(),
+    __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])
+], SearchService);

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

@@ -0,0 +1,29 @@
+import { ConfigService } from '@nestjs/config';
+import { LabTeamMember } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * TeamService
+ *
+ * Service client for interacting with the Team domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class TeamService extends BaseHttpService {
+    /**
+     * Constructs a Team 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 member 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} memberId - Unique MongoDB identifier of the member item.
+     * @returns {Promise<LabTeamMember | undefined>} Resolves to the member object if found, otherwise `undefined`.
+     */
+    fetchMemberById(memberId: string): Promise<LabTeamMember | undefined>;
+}

package/dist/modules/services/providers/team.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.TeamService = 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");
+/**
+ * TeamService
+ *
+ * Service client for interacting with the Team domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let TeamService = class TeamService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Team service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Team', base_urls_1.BaseUrls.TeamService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single member 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} memberId - Unique MongoDB identifier of the member item.
+     * @returns {Promise<LabTeamMember | undefined>} Resolves to the member object if found, otherwise `undefined`.
+     */
+    async fetchMemberById(memberId) {
+        return this.fetchResource(`internal/member/${memberId}`);
+    }
+};
+exports.TeamService = TeamService;
+exports.TeamService = TeamService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], TeamService);

package/dist/modules/services/providers/tech-radar.service.d.ts

@@ -0,0 +1,39 @@
+import { ConfigService } from '@nestjs/config';
+import { LabTechRadarBlip, LabTechRadarEdition } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * TechRadarService
+ *
+ * Service client for interacting with the TechRadar domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class TechRadarService extends BaseHttpService {
+    /**
+     * Constructs a TechRadar 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 blip 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} blipId - Unique MongoDB identifier of the blip item.
+     * @returns {Promise<LabTechRadarBlip | undefined>} Resolves to the blip object if found, otherwise `undefined`.
+     */
+    fetchBlipById(blipId: string): Promise<LabTechRadarBlip | undefined>;
+    /**
+     * Retrieves a single edition 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} editionId - Unique MongoDB identifier of the edition item.
+     * @returns {Promise<LabTechRadarEdition | undefined>} Resolves to the edition object if found, otherwise `undefined`.
+     */
+    fetchEditionById(editionId: string): Promise<LabTechRadarEdition | undefined>;
+}

package/dist/modules/services/providers/tech-radar.service.js

@@ -0,0 +1,65 @@
+"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.TechRadarService = 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");
+/**
+ * TechRadarService
+ *
+ * Service client for interacting with the TechRadar domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let TechRadarService = class TechRadarService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a TechRadar service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('TechRadar', base_urls_1.BaseUrls.TechRadarService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single blip 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} blipId - Unique MongoDB identifier of the blip item.
+     * @returns {Promise<LabTechRadarBlip | undefined>} Resolves to the blip object if found, otherwise `undefined`.
+     */
+    async fetchBlipById(blipId) {
+        return this.fetchResource(`internal/blip/${blipId}`);
+    }
+    /**
+     * Retrieves a single edition 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} editionId - Unique MongoDB identifier of the edition item.
+     * @returns {Promise<LabTechRadarEdition | undefined>} Resolves to the edition object if found, otherwise `undefined`.
+     */
+    async fetchEditionById(editionId) {
+        return this.fetchResource(`internal/edition/${editionId}`);
+    }
+};
+exports.TechRadarService = TechRadarService;
+exports.TechRadarService = TechRadarService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], TechRadarService);

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

@@ -0,0 +1,4 @@
+import { HubResource } from '../../hub-resource.enum';
+export type ServicesModuleOptions = {
+    resource?: HubResource;
+};

package/dist/modules/services/services-module-options.interface.js

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

package/dist/modules/services/services-options.parameter.d.ts

@@ -0,0 +1 @@
+export declare function InjectServicesOptions(): ParameterDecorator;

package/dist/modules/services/services-options.parameter.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectServicesOptions = InjectServicesOptions;
+const common_1 = require("@nestjs/common");
+const services_module_definition_1 = require("./services.module-definition");
+function InjectServicesOptions() {
+    return (0, common_1.Inject)(services_module_definition_1.SERVICES_MODULE_OPTIONS_TOKEN);
+}

package/dist/modules/services/services.module-definition.d.ts

@@ -0,0 +1,16 @@
+import { ServicesModuleOptions } from './services-module-options.interface';
+/**
+ * Builds a configurable ServicesModule base class and an injection token for module options.
+ *
+ * This leverages NestJS's ConfigurableModuleBuilder to create a base class that
+ * supports a `forRoot` static method for synchronous configuration,
+ * with global scope enabled by default.
+ *
+ * - `ServicesModuleClass` is the generated base class to extend for creating
+ *   services modules with configurable options.
+ * - `SERVICES_MODULE_OPTIONS_TOKEN` is the injection token used to provide and inject
+ *   service configuration options throughout the module.
+ */
+export declare const ServicesModuleClass: import("@nestjs/common").ConfigurableModuleCls<ServicesModuleOptions, "forRoot", "create", {
+    isGlobal: boolean;
+}>, SERVICES_MODULE_OPTIONS_TOKEN: string | symbol;

package/dist/modules/services/services.module-definition.js

@@ -0,0 +1,21 @@
+"use strict";
+var _a;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SERVICES_MODULE_OPTIONS_TOKEN = exports.ServicesModuleClass = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * Builds a configurable ServicesModule base class and an injection token for module options.
+ *
+ * This leverages NestJS's ConfigurableModuleBuilder to create a base class that
+ * supports a `forRoot` static method for synchronous configuration,
+ * with global scope enabled by default.
+ *
+ * - `ServicesModuleClass` is the generated base class to extend for creating
+ *   services modules with configurable options.
+ * - `SERVICES_MODULE_OPTIONS_TOKEN` is the injection token used to provide and inject
+ *   service configuration options throughout the module.
+ */
+_a = new common_1.ConfigurableModuleBuilder()
+    .setClassMethodName('forRoot')
+    .setExtras({ isGlobal: true }, (definition, extras) => (Object.assign(Object.assign({}, definition), { global: extras.isGlobal })))
+    .build(), exports.ServicesModuleClass = _a.ConfigurableModuleClass, exports.SERVICES_MODULE_OPTIONS_TOKEN = _a.MODULE_OPTIONS_TOKEN;

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

@@ -0,0 +1,17 @@
+import { DynamicModule } from '@nestjs/common';
+import { ServicesModuleOptions } from './services-module-options.interface';
+import { ServicesModuleClass } from './services.module-definition';
+/**
+ * ServicesModule
+ */
+export declare class ServicesModule extends ServicesModuleClass {
+    /**
+     * Synchronously configures the ServicesModule with provided options.
+     *
+     * Extends the base ServicesModuleClass `forRoot` method by exporting the options token.
+     *
+     * @param {ServicesModuleOptions} options - Configuration options for ServicesModule setup.
+     * @returns {DynamicModule} Configured dynamic module.
+     */
+    static forRoot(options?: ServicesModuleOptions): DynamicModule;
+}