itlab-internal-services 2.16.8 → 2.16.9

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

@@ -1,8 +1,7 @@
 import { ConfigService } from '@nestjs/config';
 import { AuthenticationModuleOptions } from '../../../authentication';
 import { BaseHttpService } from '../../base-http.service';
-import { AuthLoginTokenMailDto, AuthPasswordResetMailDto, EventCancelMailDto, EventInviteMailDto, IdeaStatusUpdateMailDto, IdeaSubmittedMailDto, LunchRouletteCancelMailDto, LunchRouletteMatchedMailDto, LunchRouletteSubmittedMailDto, LunchRouletteUnmatchedMailDto, NewsletterIssueMailDto, NewsletterSubscribedMailDto, NewsletterUnsubscribedMailDto, NotificationMailDto } from './dtos';
-import { MailType, MailTypeDtoMap } from './mail-types';
+import { AuthLoginTokenMailDtoV1, AuthPasswordResetMailDtoV1, EventCancelMailDtoV1, EventInviteMailDtoV1, IdeaStatusUpdateMailDtoV1, IdeaSubmittedMailDtoV1, LunchRouletteCancelMailDtoV1, LunchRouletteMatchedMailDtoV1, LunchRouletteSubmittedMailDtoV1, LunchRouletteUnmatchedMailDtoV1, NewsletterIssueMailDtoV1, NewsletterSubscribedMailDtoV1, NewsletterUnsubscribedMailDtoV1, NotificationMailDtoV1 } from './dtos';
 /**
  * MailService
  *
@@ -25,75 +24,75 @@ export declare class MailService extends BaseHttpService {
      * @param type - The type of email to send
      * @param payload - The payload DTO corresponding to the type
      */
-    sendMail<Type extends MailType>(type: Type, payload: MailTypeDtoMap[Type]): void;
+    private sendMail;
     /**
      * Sends an email with a one-time login token.
-     * @param {AuthLoginTokenMailDto} payload - DTO containing recipient and token.
+     * @param {AuthLoginTokenMailDtoV1} payload - DTO containing recipient and token.
      */
-    sendAuthLoginTokenMail(payload: AuthLoginTokenMailDto): void;
+    sendAuthLoginTokenMailV1(payload: AuthLoginTokenMailDtoV1): void;
     /**
      * Sends a password reset email with a secure link.
-     * @param {AuthPasswordResetMailDto} payload - DTO containing recipient and reset URL.
+     * @param {AuthPasswordResetMailDtoV1} payload - DTO containing recipient and reset URL.
      */
-    sendAuthPasswordResetMail(payload: AuthPasswordResetMailDto): void;
+    sendAuthPasswordResetMailV1(payload: AuthPasswordResetMailDtoV1): void;
     /**
      * Sends an event invitation email.
-     * @param {EventInviteMailDto} payload - DTO containing event details and recipient.
+     * @param {EventInviteMailDtoV1} payload - DTO containing event details and recipient.
      */
-    sendEventInviteMail(payload: EventInviteMailDto): void;
+    sendEventInviteMailV1(payload: EventInviteMailDtoV1): void;
     /**
      * Sends a notification about an event cancellation.
-     * @param {EventCancelMailDto} payload - DTO containing event title, time, and links.
+     * @param {EventCancelMailDtoV1} payload - DTO containing event title, time, and links.
      */
-    sendEventCancelMail(payload: EventCancelMailDto): void;
+    sendEventCancelMailV1(payload: EventCancelMailDtoV1): void;
     /**
      * Sends a confirmation that an idea was submitted.
-     * @param {IdeaSubmittedMailDto} payload - DTO containing recipient and management URL.
+     * @param {IdeaSubmittedMailDtoV1} payload - DTO containing recipient and management URL.
      */
-    sendIdeaSubmittedMail(payload: IdeaSubmittedMailDto): void;
+    sendIdeaSubmittedMailV1(payload: IdeaSubmittedMailDtoV1): void;
     /**
      * Sends a notification that an idea's status has changed.
-     * @param {IdeaStatusUpdateMailDto} payload - DTO containing the old and new status.
+     * @param {IdeaStatusUpdateMailDtoV1} payload - DTO containing the old and new status.
      */
-    sendIdeaStatusUpdateMail(payload: IdeaStatusUpdateMailDto): void;
+    sendIdeaStatusUpdateMailV1(payload: IdeaStatusUpdateMailDtoV1): void;
     /**
      * Sends confirmation of lunch roulette participation.
-     * @param {LunchRouletteSubmittedMailDto} payload - DTO with recipient, location, and type.
+     * @param {LunchRouletteSubmittedMailDtoV1} payload - DTO with recipient, location, and type.
      */
-    sendLunchRouletteSubmittedMail(payload: LunchRouletteSubmittedMailDto): void;
+    sendLunchRouletteSubmittedMailV1(payload: LunchRouletteSubmittedMailDtoV1): void;
     /**
      * Sends a cancellation email for lunch roulette.
-     * @param {LunchRouletteCancelMailDto} payload - DTO containing the recipient.
+     * @param {LunchRouletteCancelMailDtoV1} payload - DTO containing the recipient.
      */
-    sendLunchRouletteCancelMail(payload: LunchRouletteCancelMailDto): void;
+    sendLunchRouletteCancelMailV1(payload: LunchRouletteCancelMailDtoV1): void;
     /**
      * Sends a match notification to lunch roulette participants.
-     * @param {LunchRouletteMatchedMailDto} payload - DTO with recipients, message, and details URL.
+     * @param {LunchRouletteMatchedMailDtoV1} payload - DTO with recipients, message, and details URL.
      */
-    sendLunchRouletteMatchedMail(payload: LunchRouletteMatchedMailDto): void;
+    sendLunchRouletteMatchedMailV1(payload: LunchRouletteMatchedMailDtoV1): void;
     /**
      * Notifies a user that they were unmatched in lunch roulette.
-     * @param {LunchRouletteUnmatchedMailDto} payload - DTO with the unmatched recipient.
+     * @param {LunchRouletteUnmatchedMailDtoV1} payload - DTO with the unmatched recipient.
      */
-    sendLunchRouletteUnmatchedMail(payload: LunchRouletteUnmatchedMailDto): void;
+    sendLunchRouletteUnmatchedMailV1(payload: LunchRouletteUnmatchedMailDtoV1): void;
     /**
      * Sends confirmation of a newsletter subscription.
-     * @param {NewsletterSubscribedMailDto} payload - DTO with recipient information.
+     * @param {NewsletterSubscribedMailDtoV1} payload - DTO with recipient information.
      */
-    sendNewsletterSubscribedMail(payload: NewsletterSubscribedMailDto): void;
+    sendNewsletterSubscribedMailV1(payload: NewsletterSubscribedMailDtoV1): void;
     /**
      * Sends confirmation of newsletter unsubscription.
-     * @param {NewsletterUnsubscribedMailDto} payload - DTO with recipient information.
+     * @param {NewsletterUnsubscribedMailDtoV1} payload - DTO with recipient information.
      */
-    sendNewsletterUnsubscribedMail(payload: NewsletterUnsubscribedMailDto): void;
+    sendNewsletterUnsubscribedMailV1(payload: NewsletterUnsubscribedMailDtoV1): void;
     /**
      * Sends the latest issue of the newsletter.
-     * @param {NewsletterIssueMailDto} payload - DTO containing recipients, content, and metadata.
+     * @param {NewsletterIssueMailDtoV1} payload - DTO containing recipients, content, and metadata.
      */
-    sendNewsletterIssueMail(payload: NewsletterIssueMailDto): void;
+    sendNewsletterIssueMailV1(payload: NewsletterIssueMailDtoV1): void;
     /**
      * Sends a general-purpose email notification.
-     * @param {NotificationMailDto} payload - DTO with recipients, title, message, and optional URL.
+     * @param {NotificationMailDtoV1} payload - DTO with recipients, title, message, and optional URL.
      */
-    sendNotificationMail(payload: NotificationMailDto): void;
+    sendNotificationMailV1(payload: NotificationMailDtoV1): void;
 }

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

@@ -18,6 +18,7 @@ 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");
+const mail_types_1 = require("./mail-types");
 /**
  * MailService
  *
@@ -33,7 +34,7 @@ let MailService = class MailService extends base_http_service_1.BaseHttpService
      * @param configService NestJS configuration service for environment variables and URLs.
      */
     constructor(authenticationOptions, configService) {
-        super('Mail', base_urls_1.BaseUrls.MailService, authenticationOptions, configService);
+        super('Mail', base_urls_1.BaseUrls.mailService, authenticationOptions, configService);
     }
     /**
      * Sends an email of the given type with the provided payload.
@@ -43,17 +44,15 @@ let MailService = class MailService extends base_http_service_1.BaseHttpService
      * @param payload - The payload DTO corresponding to the type
      */
     sendMail(type, payload) {
-        // Email service expects paths like "auth/login-token"
-        const endpoint = type.replace(/\./g, '/');
-        this.logger.log(`Dispatching email to endpoint: ${endpoint}`);
-        this.client
-            .post(`internal/${endpoint}`, payload)
+        this.logger.log(`Dispatching email ${type}`);
+        this.httpClient
+            .post(mail_types_1.MailTypeEndpointMap[type], payload)
             .then(() => {
-            this.logger.log(`Email sent successfully: ${type}`);
+            this.logger.log(`${type} email sent successfully`);
         })
             .catch((error) => {
             const { message } = this.parseError(error);
-            this.logger.error(`Failed to send email: ${type}: ${message}`);
+            this.logger.error(`Failed to send ${type} email: ${message}`);
         });
     }
     // ─────────────────────────────────────────────
@@ -61,116 +60,116 @@ let MailService = class MailService extends base_http_service_1.BaseHttpService
     // ─────────────────────────────────────────────
     /**
      * Sends an email with a one-time login token.
-     * @param {AuthLoginTokenMailDto} payload - DTO containing recipient and token.
+     * @param {AuthLoginTokenMailDtoV1} payload - DTO containing recipient and token.
      */
-    sendAuthLoginTokenMail(payload) {
-        this.sendMail('auth.login-token', payload);
+    sendAuthLoginTokenMailV1(payload) {
+        this.sendMail('v1.auth.login-token', payload);
     }
     /**
      * Sends a password reset email with a secure link.
-     * @param {AuthPasswordResetMailDto} payload - DTO containing recipient and reset URL.
+     * @param {AuthPasswordResetMailDtoV1} payload - DTO containing recipient and reset URL.
      */
-    sendAuthPasswordResetMail(payload) {
-        this.sendMail('auth.password-reset', payload);
+    sendAuthPasswordResetMailV1(payload) {
+        this.sendMail('v1.auth.password-reset', payload);
     }
     // ─────────────────────────────────────────────
     // Event Emails
     // ─────────────────────────────────────────────
     /**
      * Sends an event invitation email.
-     * @param {EventInviteMailDto} payload - DTO containing event details and recipient.
+     * @param {EventInviteMailDtoV1} payload - DTO containing event details and recipient.
      */
-    sendEventInviteMail(payload) {
-        this.sendMail('event.invite', payload);
+    sendEventInviteMailV1(payload) {
+        this.sendMail('v1.event.invite', payload);
     }
     /**
      * Sends a notification about an event cancellation.
-     * @param {EventCancelMailDto} payload - DTO containing event title, time, and links.
+     * @param {EventCancelMailDtoV1} payload - DTO containing event title, time, and links.
      */
-    sendEventCancelMail(payload) {
-        this.sendMail('event.cancel', payload);
+    sendEventCancelMailV1(payload) {
+        this.sendMail('v1.event.cancel', payload);
     }
     // ─────────────────────────────────────────────
     // Idea Submission Emails
     // ─────────────────────────────────────────────
     /**
      * Sends a confirmation that an idea was submitted.
-     * @param {IdeaSubmittedMailDto} payload - DTO containing recipient and management URL.
+     * @param {IdeaSubmittedMailDtoV1} payload - DTO containing recipient and management URL.
      */
-    sendIdeaSubmittedMail(payload) {
-        this.sendMail('idea.submitted', payload);
+    sendIdeaSubmittedMailV1(payload) {
+        this.sendMail('v1.idea.submitted', payload);
     }
     /**
      * Sends a notification that an idea's status has changed.
-     * @param {IdeaStatusUpdateMailDto} payload - DTO containing the old and new status.
+     * @param {IdeaStatusUpdateMailDtoV1} payload - DTO containing the old and new status.
      */
-    sendIdeaStatusUpdateMail(payload) {
-        this.sendMail('idea.status-update', payload);
+    sendIdeaStatusUpdateMailV1(payload) {
+        this.sendMail('v1.idea.status-update', payload);
     }
     // ─────────────────────────────────────────────
     // Lunch Roulette Emails
     // ─────────────────────────────────────────────
     /**
      * Sends confirmation of lunch roulette participation.
-     * @param {LunchRouletteSubmittedMailDto} payload - DTO with recipient, location, and type.
+     * @param {LunchRouletteSubmittedMailDtoV1} payload - DTO with recipient, location, and type.
      */
-    sendLunchRouletteSubmittedMail(payload) {
-        this.sendMail('lunch-roulette.submitted', payload);
+    sendLunchRouletteSubmittedMailV1(payload) {
+        this.sendMail('v1.lunch-roulette.submitted', payload);
     }
     /**
      * Sends a cancellation email for lunch roulette.
-     * @param {LunchRouletteCancelMailDto} payload - DTO containing the recipient.
+     * @param {LunchRouletteCancelMailDtoV1} payload - DTO containing the recipient.
      */
-    sendLunchRouletteCancelMail(payload) {
-        this.sendMail('lunch-roulette.cancel', payload);
+    sendLunchRouletteCancelMailV1(payload) {
+        this.sendMail('v1.lunch-roulette.cancel', payload);
     }
     /**
      * Sends a match notification to lunch roulette participants.
-     * @param {LunchRouletteMatchedMailDto} payload - DTO with recipients, message, and details URL.
+     * @param {LunchRouletteMatchedMailDtoV1} payload - DTO with recipients, message, and details URL.
      */
-    sendLunchRouletteMatchedMail(payload) {
-        this.sendMail('lunch-roulette.matched', payload);
+    sendLunchRouletteMatchedMailV1(payload) {
+        this.sendMail('v1.lunch-roulette.matched', payload);
     }
     /**
      * Notifies a user that they were unmatched in lunch roulette.
-     * @param {LunchRouletteUnmatchedMailDto} payload - DTO with the unmatched recipient.
+     * @param {LunchRouletteUnmatchedMailDtoV1} payload - DTO with the unmatched recipient.
      */
-    sendLunchRouletteUnmatchedMail(payload) {
-        this.sendMail('lunch-roulette.unmatched', payload);
+    sendLunchRouletteUnmatchedMailV1(payload) {
+        this.sendMail('v1.lunch-roulette.unmatched', payload);
     }
     // ─────────────────────────────────────────────
     // Newsletter Emails
     // ─────────────────────────────────────────────
     /**
      * Sends confirmation of a newsletter subscription.
-     * @param {NewsletterSubscribedMailDto} payload - DTO with recipient information.
+     * @param {NewsletterSubscribedMailDtoV1} payload - DTO with recipient information.
      */
-    sendNewsletterSubscribedMail(payload) {
-        this.sendMail('newsletter.subscribed', payload);
+    sendNewsletterSubscribedMailV1(payload) {
+        this.sendMail('v1.newsletter.subscribed', payload);
     }
     /**
      * Sends confirmation of newsletter unsubscription.
-     * @param {NewsletterUnsubscribedMailDto} payload - DTO with recipient information.
+     * @param {NewsletterUnsubscribedMailDtoV1} payload - DTO with recipient information.
      */
-    sendNewsletterUnsubscribedMail(payload) {
-        this.sendMail('newsletter.unsubscribed', payload);
+    sendNewsletterUnsubscribedMailV1(payload) {
+        this.sendMail('v1.newsletter.unsubscribed', payload);
     }
     /**
      * Sends the latest issue of the newsletter.
-     * @param {NewsletterIssueMailDto} payload - DTO containing recipients, content, and metadata.
+     * @param {NewsletterIssueMailDtoV1} payload - DTO containing recipients, content, and metadata.
      */
-    sendNewsletterIssueMail(payload) {
-        this.sendMail('newsletter.issue', payload);
+    sendNewsletterIssueMailV1(payload) {
+        this.sendMail('v1.newsletter.issue', payload);
     }
     // ─────────────────────────────────────────────
     // Notification Emails
     // ─────────────────────────────────────────────
     /**
      * Sends a general-purpose email notification.
-     * @param {NotificationMailDto} payload - DTO with recipients, title, message, and optional URL.
+     * @param {NotificationMailDtoV1} payload - DTO with recipients, title, message, and optional URL.
      */
-    sendNotificationMail(payload) {
-        this.sendMail('notification.notification', payload);
+    sendNotificationMailV1(payload) {
+        this.sendMail('v1.notification.notification', payload);
     }
 };
 exports.MailService = MailService;

package/dist/modules/services/providers/mail/models/mail-recipient.model.d.ts

@@ -1,3 +1,4 @@
+import { User } from '../../../../../models';
 /**
  * Recipient class
  * @class Recipient
@@ -24,4 +25,5 @@ export declare class MailRecipient {
      * @returns {string} The string representation of the recipient
      */
     toString(): string;
+    static fromUser(user: User): MailRecipient;
 }

package/dist/modules/services/providers/mail/models/mail-recipient.model.js

@@ -36,6 +36,9 @@ class MailRecipient {
     toString() {
         return `${this.username} (${this.email})`;
     }
+    static fromUser(user) {
+        return new MailRecipient(user.email, user.username);
+    }
 }
 exports.MailRecipient = MailRecipient;
 __decorate([

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

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

package/dist/modules/services/providers/newsletter/fetch-issue-options.dto.v1.type.js

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

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

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

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

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

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

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

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

@@ -0,0 +1,20 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, DraftedFetchOptions, LikedByFetchOptions, TimestampsFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchNewsOptionsDtoV1
+ *
+ * Data Transfer Object for querying news or user collections.
+ * Inherits timestamp filtering fields and extends them with
+ * news-specific query parameters.
+ */
+export type FetchNewsOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & DraftedFetchOptions & ContentFetchOptions & ViewedByFetchOptions & LikedByFetchOptions & CommentsFetchOptions & {
+    includeAuthors?: boolean;
+    isFeatured?: boolean;
+    topic?: string;
+    topics?: string[];
+    authorId?: string;
+    authorIds?: string[];
+    year?: number;
+    month?: number;
+    timestampMin?: number;
+    timestampMax?: number;
+};

package/dist/modules/services/providers/newsroom/fetch-news-options.dto.v1.type.js

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

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

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

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

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

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