itlab-internal-services 2.16.7 → 2.16.9

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

@@ -0,0 +1,154 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountsService = void 0;
+const common_1 = require("@nestjs/common");
+const config_1 = require("@nestjs/config");
+const classes_1 = require("../../../../classes");
+const authentication_1 = require("../../../authentication");
+const base_http_service_1 = require("../../base-http.service");
+const base_urls_1 = require("../../base-urls");
+/**
+ * AccountsService
+ *
+ * Service client responsible for interacting with the Accounts 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 AccountsService = class AccountsService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Accounts service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Accounts', base_urls_1.BaseUrls.accountsService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Account Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single account entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} accountId - Unique MongoDB identifier of the account.
+     * @param {FetchAccountOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<Account | undefined>} Resolves to an Account or `undefined` on failure.
+     */
+    async fetchAccountV1(accountId, options) {
+        return this.fetchResource(`v1/internal/account/${accountId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of account entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchAccountOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<Account[]>} Resolves to a list of accounts, or an empty array if none found.
+     */
+    async fetchAccountCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/accounts`, { params: options });
+    }
+    /**
+     * Fetches accounts for multiple groups of account IDs and returns a mapped result.
+     *
+     * This is particularly useful when aggregating accounts related to different entities
+     * (e.g., post authors, commenters, likedBy lists).
+     *
+     * The function ensures:
+     * - Each unique account is fetched only once.
+     * - The result is returned as an `EntityMap` for O(1) lookups.
+     *
+     * @param {string[][]} accountIdGroups - Nested arrays of account IDs.
+     * @returns {Promise<EntityMap<Account>>} Map of accountId → Account entity.
+     */
+    async fetchAccountMapV1(accountIdGroups) {
+        // Aggregate all unique account IDs across groups to avoid redundant network calls.
+        const uniqueAccountIds = new Set(accountIdGroups.flat());
+        if (uniqueAccountIds.size === 0)
+            return new classes_1.EntityMap();
+        // Retrieve all accounts in one or more batched requests.
+        const accountCollection = await this.fetchAccountCollectionV1({ ids: Array.from(uniqueAccountIds) });
+        // Convert array to an entity map for efficient downstream access.
+        return new classes_1.EntityMap(accountCollection);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // User Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single user entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} userId - Unique MongoDB identifier of the user.
+     * @param {FetchAccountOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<User | undefined>} Resolves to an User or `undefined` on failure.
+     */
+    async fetchUserV1(userId, options) {
+        return this.fetchResource(`v1/internal/user/${userId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of user entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchAccountOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<User[]>} Resolves to a list of users, or an empty array if none found.
+     */
+    async fetchUserCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/users`, { params: options });
+    }
+    /**
+     * Fetches users for multiple groups of user IDs and returns a mapped result.
+     *
+     * This is particularly useful when aggregating users related to different entities
+     * (e.g., post authors, commenters, likedBy lists).
+     *
+     * The function ensures:
+     * - Each unique user is fetched only once.
+     * - The result is returned as an `EntityMap` for O(1) lookups.
+     *
+     * @param {string[][]} userIdGroups - Nested arrays of user IDs.
+     * @returns {Promise<EntityMap<User>>} Map of userId → User entity.
+     */
+    async fetchUserMapV1(userIdGroups) {
+        // Aggregate all unique user IDs across groups to avoid redundant network calls.
+        const uniqueUserIds = new Set(userIdGroups.flat());
+        if (uniqueUserIds.size === 0)
+            return new classes_1.EntityMap();
+        // Retrieve all users in one or more batched requests.
+        const userCollection = await this.fetchUserCollectionV1({ ids: Array.from(uniqueUserIds) });
+        // Convert array to an entity map for efficient downstream access.
+        return new classes_1.EntityMap(userCollection);
+    }
+};
+exports.AccountsService = AccountsService;
+exports.AccountsService = AccountsService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], AccountsService);

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

@@ -0,0 +1,29 @@
+import { BaseFetchOptions, TimestampsFetchOptions } from '../../../../classes';
+/**
+ * FetchAccountOptionsDtoV1
+ *
+ * Data Transfer Object for querying account or user collections.
+ * Inherits timestamp filtering fields and extends them with
+ * account-specific query parameters.
+ */
+export type FetchAccountOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & {
+    email?: string;
+    emails?: string[];
+    username?: string;
+    usernames?: string[];
+    perm?: string;
+    perms?: string[];
+    hasPassword?: boolean;
+    enabledNotificationType?: string;
+    enabledNotificationTypes?: string[];
+    signedUpMin?: number;
+    signedUpMax?: number;
+    signedInMin?: number;
+    signedInMax?: number;
+    createdAtMin?: number;
+    createdAtMax?: number;
+    lastSeenAtMin?: number;
+    lastSeenAtMax?: number;
+    updatedAtMin?: number;
+    updatedAtMax?: number;
+};

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

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

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

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

@@ -0,0 +1,49 @@
+import { ConfigService } from '@nestjs/config';
+import { LabBook } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { FetchBookOptionsDtoV1 } from './fetch-book-options.dto.v1.type';
+/**
+ * BooksService
+ *
+ * Service client responsible for interacting with the Books 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 BooksService extends BaseHttpService {
+    /**
+     * Constructs an Books 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 book entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} bookId - Unique MongoDB identifier of the book.
+     * @param {FetchBookOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabBook | undefined>} Resolves to an Book or `undefined` on failure.
+     */
+    fetchBookV1(bookId: string, options?: FetchBookOptionsDtoV1): Promise<LabBook | undefined>;
+    /**
+     * Retrieves a collection of book entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchBookOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabBook[]>} Resolves to a list of books, or an empty array if none found.
+     */
+    fetchBookCollectionV1(options?: FetchBookOptionsDtoV1): Promise<LabBook[]>;
+}

package/dist/modules/services/providers/books/books.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.BooksService = 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");
+/**
+ * BooksService
+ *
+ * Service client responsible for interacting with the Books 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 BooksService = class BooksService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Books service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Books', base_urls_1.BaseUrls.booksService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Book Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single book entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} bookId - Unique MongoDB identifier of the book.
+     * @param {FetchBookOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabBook | undefined>} Resolves to an Book or `undefined` on failure.
+     */
+    async fetchBookV1(bookId, options) {
+        return this.fetchResource(`v1/internal/book/${bookId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of book entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchBookOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabBook[]>} Resolves to a list of books, or an empty array if none found.
+     */
+    async fetchBookCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/books`, { params: options });
+    }
+};
+exports.BooksService = BooksService;
+exports.BooksService = BooksService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], BooksService);

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

@@ -0,0 +1,27 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, DraftedFetchOptions, LikedByFetchOptions, TimestampsFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchBookOptionsDtoV1
+ *
+ * Data Transfer Object for querying book collections.
+ * Inherits timestamp filtering fields and extends them with
+ * book-specific query parameters.
+ */
+export type FetchBookOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & DraftedFetchOptions & ContentFetchOptions & ViewedByFetchOptions & LikedByFetchOptions & CommentsFetchOptions & {
+    includeReadingList?: boolean;
+    includeReadingListIds?: boolean;
+    includeSubmitter?: boolean;
+    topic?: string;
+    topics?: string[];
+    genre?: string;
+    genres?: string[];
+    author?: string;
+    authors?: string[];
+    publisher?: string;
+    publishers?: string[];
+    submitterId?: string;
+    submitterIds?: string[];
+    releasedAtMin?: number;
+    releasedAtMax?: number;
+    timestampMin?: number;
+    timestampMax?: number;
+};

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

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

package/dist/modules/services/providers/{notification → books}/index.js

@@ -14,5 +14,5 @@ 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("./notification.service"), exports);
+__exportStar(require("./books.service"), exports);
+__exportStar(require("./fetch-book-options.dto.v1.type"), exports);

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

@@ -0,0 +1,62 @@
+import { ConfigService } from '@nestjs/config';
+import { User } from '../../../../models';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { FetchChangeOptionsDtoV1 } from './fetch-change-options.dto.v1.type';
+type LabChangelogChange = {
+    id: string;
+    _year: number;
+    _month: number;
+    _date: number;
+    contactId: string;
+    timestamp: number;
+    draft: boolean;
+    silencedNotification: boolean;
+    content: string;
+    contact?: User;
+};
+/**
+ * ChangelogService
+ *
+ * Service client responsible for interacting with the Changelog 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 ChangelogService extends BaseHttpService {
+    /**
+     * Constructs an Changelog 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 changelog entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} changelogId - Unique MongoDB identifier of the changelog.
+     * @param {FetchChangeOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabChangelogChange | undefined>} Resolves to an Changelog or `undefined` on failure.
+     */
+    fetchChangelogV1(changelogId: string, options?: FetchChangeOptionsDtoV1): Promise<LabChangelogChange | undefined>;
+    /**
+     * Retrieves a collection of changelog entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchChangeOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabChangelogChange[]>} Resolves to a list of changelogs, or an empty array if none found.
+     */
+    fetchChangelogCollectionV1(options?: FetchChangeOptionsDtoV1): Promise<LabChangelogChange[]>;
+}
+export {};

package/dist/modules/services/providers/changelog/changelog.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.ChangelogService = 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");
+/**
+ * ChangelogService
+ *
+ * Service client responsible for interacting with the Changelog 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 ChangelogService = class ChangelogService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Changelog service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Changelog', base_urls_1.BaseUrls.changelogService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Changelog Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single changelog entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} changelogId - Unique MongoDB identifier of the changelog.
+     * @param {FetchChangeOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabChangelogChange | undefined>} Resolves to an Changelog or `undefined` on failure.
+     */
+    async fetchChangelogV1(changelogId, options) {
+        return this.fetchResource(`v1/internal/changelog/${changelogId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of changelog entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchChangeOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabChangelogChange[]>} Resolves to a list of changelogs, or an empty array if none found.
+     */
+    async fetchChangelogCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/changelogs`, { params: options });
+    }
+};
+exports.ChangelogService = ChangelogService;
+exports.ChangelogService = ChangelogService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], ChangelogService);

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

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

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

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

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

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

@@ -0,0 +1,59 @@
+import { ConfigService } from '@nestjs/config';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { FetchConflictOptionsDtoV1 } from './fetch-conflict-options.dto.v1.type';
+type LabConflict = {
+    id: string;
+    _url: string;
+    _resource: string;
+    _resourceId: string;
+    firstRecordedAt: Date;
+    lastRecordedAt: Date;
+    level: number;
+    message: number;
+};
+/**
+ * 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.
+ */
+export declare class ConflictsService extends BaseHttpService {
+    /**
+     * Constructs an Conflicts 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 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.
+     */
+    fetchConflictV1(conflictId: string, options?: FetchConflictOptionsDtoV1): Promise<LabConflict | undefined>;
+    /**
+     * 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.
+     */
+    fetchConflictCollectionV1(options?: FetchConflictOptionsDtoV1): Promise<LabConflict[]>;
+}
+export {};