itlab-internal-services 2.16.7 → 2.16.9

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

@@ -0,0 +1,79 @@
+"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.ConflictsService = void 0;
+const common_1 = require("@nestjs/common");
+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");
+/**
+ * ConflictsService
+ *
+ * Service client responsible for interacting with the Conflicts microservice.
+ * Extends `BaseHttpService` to inherit:
+ * - Environment-sensitive URL resolution (internal vs. external).
+ * - Secure inter-service authentication.
+ * - Structured logging for traceability of outbound requests.
+ *
+ * Why this pattern?
+ * - Ensures all outbound calls follow a unified configuration and logging structure.
+ * - Promotes strong typing and maintainable HTTP logic.
+ * - Makes service interactions predictable and debuggable across environments.
+ */
+let ConflictsService = class ConflictsService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Conflicts service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Conflicts', base_urls_1.BaseUrls.conflictsService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Conflict Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single conflict entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} conflictId - Unique MongoDB identifier of the conflict.
+     * @param {FetchConflictOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabConflict | undefined>} Resolves to an Conflict or `undefined` on failure.
+     */
+    async fetchConflictV1(conflictId, options) {
+        return this.fetchResource(`v1/internal/conflict/${conflictId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of conflict entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchConflictOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabConflict[]>} Resolves to a list of conflicts, or an empty array if none found.
+     */
+    async fetchConflictCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/conflicts`, { params: options });
+    }
+};
+exports.ConflictsService = ConflictsService;
+exports.ConflictsService = ConflictsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], ConflictsService);

package/dist/modules/services/providers/conflicts/fetch-conflict-options.dto.v1.type.d.ts

@@ -0,0 +1,18 @@
+import { BaseFetchOptions } from '../../../../classes';
+/**
+ * FetchConflictOptionsDtoV1
+ *
+ * Data Transfer Object for querying conflict collections.
+ * Inherits timestamp filtering fields and extends them with
+ * conflict-specific query parameters.
+ */
+export type FetchConflictOptionsDtoV1 = BaseFetchOptions & {
+    resource?: string;
+    resources?: string[];
+    level?: number;
+    levels?: number[];
+    firstRecordedAtMin?: number;
+    firstRecordedAtMax?: number;
+    lastRecordedAtMin?: number;
+    lastRecordedAtMax?: number;
+};

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

@@ -0,0 +1,2 @@
+export * from './conflicts.service';
+export * from './fetch-conflict-options.dto.v1.type';

package/dist/modules/services/providers/conflicts/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("./conflicts.service"), exports);
+__exportStar(require("./fetch-conflict-options.dto.v1.type"), exports);

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

@@ -2,7 +2,7 @@ import { LabContent, LabContentPopulated } from 'itlab-functions';
 /**
  * Constant list of supported digital pass types.
  */
-export declare const supportedContentReturnTypes: readonly ["json", "text", "html", "populated"];
+export declare const supportedContentReturnTypes: readonly ["json", "text", "html", "htmlPopulated"];
 /**
  * Union type representing valid pass types.
  */
@@ -15,5 +15,6 @@ export type ContentReturnTypeMap = {
     json: LabContent;
     text: string;
     html: LabContent;
-    populated: LabContentPopulated;
+    htmlPopulated: LabContentPopulated;
 };
+export declare const ContentReturnTypeEndpointMap: Record<ContentReturnType, string>;

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

@@ -1,7 +1,13 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.supportedContentReturnTypes = void 0;
+exports.ContentReturnTypeEndpointMap = exports.supportedContentReturnTypes = void 0;
 /**
  * Constant list of supported digital pass types.
  */
-exports.supportedContentReturnTypes = ['json', 'text', 'html', 'populated'];
+exports.supportedContentReturnTypes = ['json', 'text', 'html', 'htmlPopulated'];
+exports.ContentReturnTypeEndpointMap = {
+    json: 'v1/content/%resource%/%resourceId%/json',
+    text: 'v1/content/%resource%/%resourceId%/text',
+    html: 'v1/content/%resource%/%resourceId%/html',
+    htmlPopulated: 'v1/content/%resource%/%resourceId%/html/populated',
+};

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

@@ -1,16 +1,24 @@
 import { DynamicModule } from '@nestjs/common';
 import { ConfigService } from '@nestjs/config';
-import { LabContent } from 'itlab-functions';
+import { LabContent, LabContentPopulated } 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 { ContentReturnType, ContentReturnTypeMap } from './content-return-types';
+import { FetchContentOptionsDtoV1 } from './fetch-content-options.dto.v1.type';
 /**
  * Parameter decorator to inject the feature-specific ContentService.
  */
 export declare function InjectFeatureContentService(): ParameterDecorator;
+type ContentSchema = {
+    id: string;
+    _resource: string;
+    _resourceId: string;
+    json: LabContent;
+    htmlPopulated: LabContentPopulated;
+};
 /**
  * Service responsible for all operations with the Organisation Hub Content Service.
  *
@@ -43,6 +51,39 @@ export declare class ContentService extends BaseHttpService {
     static forResource(resource: HubResource): DynamicModule;
     private cacheKey;
     private clearCache;
+    /**
+     * Retrieves a single content entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} contentId - Unique MongoDB identifier of the content.
+     * @param {FetchContentOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<ContentSchema | undefined>} Resolves to an Content or `undefined` on failure.
+     */
+    fetchContentSchemaV1(contentId: string, options?: FetchContentOptionsDtoV1): Promise<ContentSchema | undefined>;
+    /**
+     * Retrieves a collection of content entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchContentOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<ContentSchema[]>} Resolves to a list of contents, or an empty array if none found.
+     */
+    fetchContentSchemaCollectionV1(options?: FetchContentOptionsDtoV1): Promise<ContentSchema[]>;
+    /**
+     * Retrieves a single content entry by its resource and resourceId identifiers.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} resource - Resource Type of the content.
+     * @param {string} resourceId - Unique MongoDB identifier of Resource of the content.
+     * @param {FetchContentOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<ContentSchema | undefined>} Resolves to an Content or `undefined` on failure.
+     */
+    fetchContentSchemaOfResourceV1(resource: string, resourceId: string, options?: FetchContentOptionsDtoV1): Promise<ContentSchema>;
     /**
      * Validates the given content object using the backend service.
      * Logs the process and throws an HTTP exception if validation fails.
@@ -51,7 +92,7 @@ export declare class ContentService extends BaseHttpService {
      * @returns Resolves if validation is successful.
      * @throws HttpException if the backend returns an error.
      */
-    validateContent(content: LabContent): Promise<void>;
+    validateContentV1(content: LabContent): Promise<void>;
     /**
      * Submits content for a given resource.
      *
@@ -59,7 +100,7 @@ export declare class ContentService extends BaseHttpService {
      * @param content Content object to submit.
      * @throws HttpException if the backend returns an error.
      */
-    submitContent(resourceId: string, content: LabContent): Promise<void>;
+    submitContentV1(resourceId: string, content: LabContent): Promise<void>;
     /**
      * Directly submits content without extra validation.
      * Backend will handle validation internally.
@@ -68,14 +109,14 @@ export declare class ContentService extends BaseHttpService {
      * @param content Content object to submit.
      * @throws HttpException if the backend returns an error.
      */
-    validateAndSubmitContent(resourceId: string, content: LabContent): Promise<void>;
+    validateAndSubmitContentV1(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;
+    deleteContentV1(resourceId: string): void;
     /**
      * Retrieves content in a specified format from the backend.
      * Provides default values if content retrieval fails.
@@ -84,7 +125,7 @@ export declare class ContentService extends BaseHttpService {
      * @param returnType Format of content to retrieve ('json', 'text', 'html', 'populated').
      * @returns Retrieved content in the requested format.
      */
-    getContent<ReturnType extends ContentReturnType>(resourceId: string, returnType: ReturnType): Promise<ContentReturnTypeMap[ReturnType]>;
+    fetchContentV1<ReturnType extends ContentReturnType>(resourceId: string, returnType: ReturnType): Promise<ContentReturnTypeMap[ReturnType]>;
     /**
      * Retrieves content from the cache if available; otherwise fetches from the backend.
      *
@@ -92,5 +133,6 @@ export declare class ContentService extends BaseHttpService {
      * @param returnType Format of content to retrieve.
      * @returns Cached or freshly retrieved content.
      */
-    getCachedContent<ReturnType extends ContentReturnType>(resourceId: string, returnType: ReturnType): Promise<ContentReturnTypeMap[ReturnType]>;
+    fetchCachedContentV1<ReturnType extends ContentReturnType>(resourceId: string, returnType: ReturnType): Promise<ContentReturnTypeMap[ReturnType]>;
 }
+export {};

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

@@ -52,7 +52,7 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @param cacheService Optional caching service for retrieving content efficiently.
      */
     constructor(authenticationOptions, options, configService, cacheService) {
-        super('Content', base_urls_1.BaseUrls.ContentService, authenticationOptions, configService);
+        super('Content', base_urls_1.BaseUrls.contentService, authenticationOptions, configService);
         this.options = options;
         this.cacheService = cacheService;
         this.cacheKey = (resourceId, returnType) => {
@@ -96,6 +96,48 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
             });
         }
     }
+    // ─────────────────────────────────────────────────────────────
+    // Content Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single content entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} contentId - Unique MongoDB identifier of the content.
+     * @param {FetchContentOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<ContentSchema | undefined>} Resolves to an Content or `undefined` on failure.
+     */
+    async fetchContentSchemaV1(contentId, options) {
+        return this.fetchResource(`v1/internal/content/${contentId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of content entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchContentOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<ContentSchema[]>} Resolves to a list of contents, or an empty array if none found.
+     */
+    async fetchContentSchemaCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/contents`, { params: options });
+    }
+    /**
+     * Retrieves a single content entry by its resource and resourceId identifiers.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} resource - Resource Type of the content.
+     * @param {string} resourceId - Unique MongoDB identifier of Resource of the content.
+     * @param {FetchContentOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<ContentSchema | undefined>} Resolves to an Content or `undefined` on failure.
+     */
+    async fetchContentSchemaOfResourceV1(resource, resourceId, options) {
+        return this.fetchResource(`v1/internal/content/${resource}/${resourceId}`, { params: options });
+    }
     /**
      * Validates the given content object using the backend service.
      * Logs the process and throws an HTTP exception if validation fails.
@@ -104,11 +146,10 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @returns Resolves if validation is successful.
      * @throws HttpException if the backend returns an error.
      */
-    async validateContent(content) {
-        const endpoint = `internal/verify`;
+    async validateContentV1(content) {
         this.logger.log('Validating content...');
         try {
-            await this.client.post(endpoint, { content });
+            await this.httpClient.post(`v1/internal/content/validate`, { content });
             this.logger.log('Content validation successful.');
         }
         catch (error) {
@@ -124,15 +165,14 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @param content Content object to submit.
      * @throws HttpException if the backend returns an error.
      */
-    async submitContent(resourceId, content) {
+    async submitContentV1(resourceId, content) {
         if (!this.options.resource) {
             this.logger.error('Cannot submit content: Resource type not provided.');
             return;
         }
-        const endpoint = `internal/${this.options.resource}/${resourceId}`;
         this.logger.log(`Submitting content for ${this.options.resource} ${resourceId}...`);
         try {
-            await this.client.post(endpoint, { content });
+            await this.httpClient.post(`v1/internal/content/${this.options.resource}/${resourceId}`, { content });
             this.logger.log(`Content successfully submitted for ${this.options.resource} ${resourceId}.`);
             this.clearCache(resourceId);
         }
@@ -150,8 +190,8 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @param content Content object to submit.
      * @throws HttpException if the backend returns an error.
      */
-    async validateAndSubmitContent(resourceId, content) {
-        await this.submitContent(resourceId, content);
+    async validateAndSubmitContentV1(resourceId, content) {
+        await this.submitContentV1(resourceId, content);
     }
     /**
      * Removes content associated with a given resource.
@@ -159,14 +199,14 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      *
      * @param resourceId Unique identifier of the resource.
      */
-    deleteContent(resourceId) {
+    deleteContentV1(resourceId) {
         if (!this.options.resource) {
             this.logger.error('Cannot remove document: Resource type not provided.');
             return;
         }
-        const endpoint = `internal/${this.options.resource}/${resourceId}`;
+        const endpoint = `v1/internal/content/${this.options.resource}/${resourceId}`;
         this.logger.log(`Removing content for ${this.options.resource} ${resourceId}...`);
-        this.client
+        this.httpClient
             .delete(endpoint)
             .then(() => {
             this.logger.log(`Content removed successfully for ${this.options.resource} (${resourceId}).`);
@@ -185,16 +225,18 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @param returnType Format of content to retrieve ('json', 'text', 'html', 'populated').
      * @returns Retrieved content in the requested format.
      */
-    async getContent(resourceId, returnType) {
+    async fetchContentV1(resourceId, returnType) {
         const defaultReturnValue = (returnType === 'text' ? '' : []);
         if (!this.options.resource) {
             this.logger.error('Cannot fetch content: Resource type not provided.');
             return defaultReturnValue;
         }
-        const endpoint = `internal/${this.options.resource}/${resourceId}/${returnType}`;
+        const endpoint = content_return_types_1.ContentReturnTypeEndpointMap[returnType]
+            .replace('%resource%', this.options.resource)
+            .replace('%resourceId%', resourceId);
         this.logger.log(`Fetching ${returnType} content for ${this.options.resource} ${resourceId}...`);
         try {
-            const { data } = await this.client.get(endpoint);
+            const { data } = await this.httpClient.get(endpoint);
             this.logger.log(`Successfully retrieved ${returnType} content for ${this.options.resource} ${resourceId}.`);
             return data;
         }
@@ -211,13 +253,13 @@ let ContentService = ContentService_1 = class ContentService extends base_http_s
      * @param returnType Format of content to retrieve.
      * @returns Cached or freshly retrieved content.
      */
-    async getCachedContent(resourceId, returnType) {
-        const fetchContent = () => this.getContent(resourceId, returnType);
+    async fetchCachedContentV1(resourceId, returnType) {
+        const fetchContentV1 = () => this.fetchContentV1(resourceId, returnType);
         if (this.cacheService) {
             const cacheKey = this.cacheKey(resourceId, returnType);
-            return this.cacheService.fetchOrStore(cacheKey, fetchContent, 86400000); // 1 day or until updated
+            return this.cacheService.fetchOrStore(cacheKey, fetchContentV1, 86400000); // 1 day or until updated
         }
-        return fetchContent();
+        return fetchContentV1();
     }
 };
 exports.ContentService = ContentService;

package/dist/modules/services/providers/content/fetch-content-options.dto.v1.type.d.ts

@@ -0,0 +1,15 @@
+import { BaseFetchOptions } from '../../../../classes';
+/**
+ * FetchContentOptionsDtoV1
+ *
+ * Data Transfer Object for querying content collections.
+ * Inherits timestamp filtering fields and extends them with
+ * content-specific query parameters.
+ */
+export type FetchContentOptionsDtoV1 = BaseFetchOptions & {
+    populateHtml?: boolean;
+    resource?: string;
+    resources?: string[];
+    resourceId?: string;
+    resourceIds?: string[];
+};

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

@@ -1,2 +1,3 @@
 export type { ContentReturnType } from './content-return-types';
 export * from './content.service';
+export * from './fetch-content-options.dto.v1.type';

package/dist/modules/services/providers/content/index.js

@@ -15,3 +15,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./content.service"), exports);
+__exportStar(require("./fetch-content-options.dto.v1.type"), exports);

package/dist/modules/services/providers/demo-hive/demo-hive.service.d.ts

@@ -0,0 +1,49 @@
+import { ConfigService } from '@nestjs/config';
+import { LabDemo } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { FetchDemoOptionsDtoV1 } from './fetch-demo-options.dto.v1.type';
+/**
+ * DemoHiveService
+ *
+ * Service client responsible for interacting with the Demo Hive microservice.
+ * Extends `BaseHttpService` to inherit:
+ * - Environment-sensitive URL resolution (internal vs. external).
+ * - Secure inter-service authentication.
+ * - Structured logging for traceability of outbound requests.
+ *
+ * Why this pattern?
+ * - Ensures all outbound calls follow a unified configuration and logging structure.
+ * - Promotes strong typing and maintainable HTTP logic.
+ * - Makes service interactions predictable and debuggable across environments.
+ */
+export declare class DemoHiveService extends BaseHttpService {
+    /**
+     * Constructs an Demo Hive service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Retrieves a single demo entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} demoId - Unique MongoDB identifier of the demo.
+     * @param {FetchDemoOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabDemo | undefined>} Resolves to an Demo or `undefined` on failure.
+     */
+    fetchDemoV1(demoId: string, options?: FetchDemoOptionsDtoV1): Promise<LabDemo | undefined>;
+    /**
+     * Retrieves a collection of demo entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchDemoOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabDemo[]>} Resolves to a list of demos, or an empty array if none found.
+     */
+    fetchDemoCollectionV1(options?: FetchDemoOptionsDtoV1): Promise<LabDemo[]>;
+}

package/dist/modules/services/providers/demo-hive/demo-hive.service.js

@@ -0,0 +1,79 @@
+"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.DemoHiveService = void 0;
+const common_1 = require("@nestjs/common");
+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");
+/**
+ * DemoHiveService
+ *
+ * Service client responsible for interacting with the Demo Hive microservice.
+ * Extends `BaseHttpService` to inherit:
+ * - Environment-sensitive URL resolution (internal vs. external).
+ * - Secure inter-service authentication.
+ * - Structured logging for traceability of outbound requests.
+ *
+ * Why this pattern?
+ * - Ensures all outbound calls follow a unified configuration and logging structure.
+ * - Promotes strong typing and maintainable HTTP logic.
+ * - Makes service interactions predictable and debuggable across environments.
+ */
+let DemoHiveService = class DemoHiveService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Demo Hive service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('DemoHive', base_urls_1.BaseUrls.demoHiveService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Demo Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single demo entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} demoId - Unique MongoDB identifier of the demo.
+     * @param {FetchDemoOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabDemo | undefined>} Resolves to an Demo or `undefined` on failure.
+     */
+    async fetchDemoV1(demoId, options) {
+        return this.fetchResource(`v1/internal/demo/${demoId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of demo entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchDemoOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabDemo[]>} Resolves to a list of demos, or an empty array if none found.
+     */
+    async fetchDemoCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/demos`, { params: options });
+    }
+};
+exports.DemoHiveService = DemoHiveService;
+exports.DemoHiveService = DemoHiveService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], DemoHiveService);

package/dist/modules/services/providers/demo-hive/fetch-demo-options.dto.v1.type.d.ts

@@ -0,0 +1,16 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, DraftedFetchOptions, LikedByFetchOptions, TimestampsFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchDemoOptionsDtoV1
+ *
+ * Data Transfer Object for querying demo collections.
+ * Inherits timestamp filtering fields and extends them with
+ * demo-specific query parameters.
+ */
+export type FetchDemoOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & DraftedFetchOptions & ContentFetchOptions & ViewedByFetchOptions & LikedByFetchOptions & CommentsFetchOptions & {
+    includeContact?: boolean;
+    hasWebsite?: boolean;
+    contactId?: string;
+    contactIds?: string[];
+    timestampMin?: number;
+    timestampMax?: number;
+};

package/dist/modules/services/providers/demo-hive/index.d.ts

@@ -0,0 +1,2 @@
+export * from './demo-hive.service';
+export * from './fetch-demo-options.dto.v1.type';

package/dist/modules/services/providers/demo-hive/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("./demo-hive.service"), exports);
+__exportStar(require("./fetch-demo-options.dto.v1.type"), exports);