itlab-internal-services 2.15.7 → 2.16.0

package/dist/modules/services/providers/lunch-roulette.service.js

@@ -0,0 +1,41 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __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.LunchRouletteService = void 0;
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../authentication");
+const base_http_service_1 = require("../base-http.service");
+const base_urls_1 = require("../base-urls");
+/**
+ * LunchRouletteService
+ *
+ * Service client for interacting with the LunchRoulette domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let LunchRouletteService = class LunchRouletteService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a LunchRoulette service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('LunchRoulette', base_urls_1.BaseUrls.LunchRouletteService, authenticationOptions, configService);
+    }
+};
+exports.LunchRouletteService = LunchRouletteService;
+exports.LunchRouletteService = LunchRouletteService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], LunchRouletteService);

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

@@ -0,0 +1,3 @@
+export * from './dtos';
+export * from './models';
+export * from './mail.service';

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

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./dtos"), exports);
+__exportStar(require("./models"), exports);
+__exportStar(require("./mail.service"), exports);

package/dist/modules/services/providers/mail/mail-types.d.ts

@@ -0,0 +1,30 @@
+import { AuthLoginTokenMailDto, AuthPasswordResetMailDto, EventCancelMailDto, EventInviteMailDto, IdeaStatusUpdateMailDto, IdeaSubmittedMailDto, LunchRouletteCancelMailDto, LunchRouletteMatchedMailDto, LunchRouletteSubmittedMailDto, LunchRouletteUnmatchedMailDto, NewsletterIssueMailDto, NewsletterSubscribedMailDto, NewsletterUnsubscribedMailDto, NotificationMailDto } from './dtos';
+/**
+ * Constant list of supported mail types.
+ */
+declare const supportedMailTypes: readonly ["auth.login-token", "auth.password-reset", "event.invite", "event.cancel", "idea.submitted", "idea.status-update", "lunch-roulette.submitted", "lunch-roulette.cancel", "lunch-roulette.matched", "lunch-roulette.unmatched", "newsletter.subscribed", "newsletter.unsubscribed", "newsletter.issue", "notification.notification"];
+/**
+ * Union type representing valid mail kinds.
+ */
+export type MailType = (typeof supportedMailTypes)[number];
+/**
+ * Maps each supported mail type to its corresponding DTO.
+ * This enables type-safe payload handling when creating passes.
+ */
+export type MailTypeDtoMap = {
+    'auth.login-token': AuthLoginTokenMailDto;
+    'auth.password-reset': AuthPasswordResetMailDto;
+    'event.invite': EventInviteMailDto;
+    'event.cancel': EventCancelMailDto;
+    'idea.submitted': IdeaSubmittedMailDto;
+    'idea.status-update': IdeaStatusUpdateMailDto;
+    'lunch-roulette.submitted': LunchRouletteSubmittedMailDto;
+    'lunch-roulette.cancel': LunchRouletteCancelMailDto;
+    'lunch-roulette.matched': LunchRouletteMatchedMailDto;
+    'lunch-roulette.unmatched': LunchRouletteUnmatchedMailDto;
+    'newsletter.subscribed': NewsletterSubscribedMailDto;
+    'newsletter.unsubscribed': NewsletterUnsubscribedMailDto;
+    'newsletter.issue': NewsletterIssueMailDto;
+    'notification.notification': NotificationMailDto;
+};
+export {};

package/dist/modules/services/providers/mail/mail-types.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * Constant list of supported mail types.
+ */
+// eslint-disable-next-line
+const supportedMailTypes = [
+    'auth.login-token',
+    'auth.password-reset',
+    'event.invite',
+    'event.cancel',
+    'idea.submitted',
+    'idea.status-update',
+    'lunch-roulette.submitted',
+    'lunch-roulette.cancel',
+    'lunch-roulette.matched',
+    'lunch-roulette.unmatched',
+    'newsletter.subscribed',
+    'newsletter.unsubscribed',
+    'newsletter.issue',
+    'notification.notification',
+];

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

@@ -0,0 +1,99 @@
+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';
+/**
+ * MailService
+ *
+ * Provides a type-safe interface for sending various email notifications
+ * via the central organisation-hub-email service. Handles environment-aware
+ * client configuration and logging for success/failure of email dispatches.
+ */
+export declare class MailService extends BaseHttpService {
+    /**
+     * Creates a MailService client for a specific resource.
+     *
+     * @param authenticationOptions Authentication options injected from the Auth module.
+     * @param configService NestJS configuration service for environment variables and URLs.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Sends an email of the given type with the provided payload.
+     *
+     * @template Type - One of the supported MailType keys
+     * @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;
+    /**
+     * Sends an email with a one-time login token.
+     * @param {AuthLoginTokenMailDto} payload - DTO containing recipient and token.
+     */
+    sendAuthLoginTokenMail(payload: AuthLoginTokenMailDto): void;
+    /**
+     * Sends a password reset email with a secure link.
+     * @param {AuthPasswordResetMailDto} payload - DTO containing recipient and reset URL.
+     */
+    sendAuthPasswordResetMail(payload: AuthPasswordResetMailDto): void;
+    /**
+     * Sends an event invitation email.
+     * @param {EventInviteMailDto} payload - DTO containing event details and recipient.
+     */
+    sendEventInviteMail(payload: EventInviteMailDto): void;
+    /**
+     * Sends a notification about an event cancellation.
+     * @param {EventCancelMailDto} payload - DTO containing event title, time, and links.
+     */
+    sendEventCancelMail(payload: EventCancelMailDto): void;
+    /**
+     * Sends a confirmation that an idea was submitted.
+     * @param {IdeaSubmittedMailDto} payload - DTO containing recipient and management URL.
+     */
+    sendIdeaSubmittedMail(payload: IdeaSubmittedMailDto): void;
+    /**
+     * Sends a notification that an idea's status has changed.
+     * @param {IdeaStatusUpdateMailDto} payload - DTO containing the old and new status.
+     */
+    sendIdeaStatusUpdateMail(payload: IdeaStatusUpdateMailDto): void;
+    /**
+     * Sends confirmation of lunch roulette participation.
+     * @param {LunchRouletteSubmittedMailDto} payload - DTO with recipient, location, and type.
+     */
+    sendLunchRouletteSubmittedMail(payload: LunchRouletteSubmittedMailDto): void;
+    /**
+     * Sends a cancellation email for lunch roulette.
+     * @param {LunchRouletteCancelMailDto} payload - DTO containing the recipient.
+     */
+    sendLunchRouletteCancelMail(payload: LunchRouletteCancelMailDto): void;
+    /**
+     * Sends a match notification to lunch roulette participants.
+     * @param {LunchRouletteMatchedMailDto} payload - DTO with recipients, message, and details URL.
+     */
+    sendLunchRouletteMatchedMail(payload: LunchRouletteMatchedMailDto): void;
+    /**
+     * Notifies a user that they were unmatched in lunch roulette.
+     * @param {LunchRouletteUnmatchedMailDto} payload - DTO with the unmatched recipient.
+     */
+    sendLunchRouletteUnmatchedMail(payload: LunchRouletteUnmatchedMailDto): void;
+    /**
+     * Sends confirmation of a newsletter subscription.
+     * @param {NewsletterSubscribedMailDto} payload - DTO with recipient information.
+     */
+    sendNewsletterSubscribedMail(payload: NewsletterSubscribedMailDto): void;
+    /**
+     * Sends confirmation of newsletter unsubscription.
+     * @param {NewsletterUnsubscribedMailDto} payload - DTO with recipient information.
+     */
+    sendNewsletterUnsubscribedMail(payload: NewsletterUnsubscribedMailDto): void;
+    /**
+     * Sends the latest issue of the newsletter.
+     * @param {NewsletterIssueMailDto} payload - DTO containing recipients, content, and metadata.
+     */
+    sendNewsletterIssueMail(payload: NewsletterIssueMailDto): void;
+    /**
+     * Sends a general-purpose email notification.
+     * @param {NotificationMailDto} payload - DTO with recipients, title, message, and optional URL.
+     */
+    sendNotificationMail(payload: NotificationMailDto): void;
+}

package/dist/modules/{mail → services/providers/mail}/mail.service.js

@@ -11,86 +11,49 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 var __param = (this && this.__param) || function (paramIndex, decorator) {
     return function (target, key) { decorator(target, key, paramIndex); }
 };
-var MailService_1;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.MailService = void 0;
 const common_1 = require("@nestjs/common");
 const config_1 = require("@nestjs/config");
-const create_internal_axios_client_function_1 = require("../../functions/create-internal-axios-client.function");
-const authentication_1 = require("../authentication");
+const authentication_1 = require("../../../authentication");
+const base_http_service_1 = require("../../base-http.service");
+const base_urls_1 = require("../../base-urls");
 /**
- * Constant list of supported mail types.
- */
-// eslint-disable-next-line @typescript-eslint/no-unused-vars
-const supportedMailTypes = [
-    'auth.login-token',
-    'auth.password-reset',
-    'event.invite',
-    'event.cancel',
-    'idea.submitted',
-    'idea.status-update',
-    'lunch-roulette.submitted',
-    'lunch-roulette.cancel',
-    'lunch-roulette.matched',
-    'lunch-roulette.unmatched',
-    'newsletter.subscribed',
-    'newsletter.unsubscribed',
-    'newsletter.issue',
-    'notification.notification',
-];
-/**
- * @class MailService
- * @description
- * MailService provides a structured and type-safe interface for sending
- * various types of email notifications within the platform.
+ * MailService
  *
- * It integrates with the central organisation-hub-email service,
- * automatically configuring the client based on environment (dev/prod).
+ * Provides a type-safe interface for sending various email notifications
+ * via the central organisation-hub-email service. Handles environment-aware
+ * client configuration and logging for success/failure of email dispatches.
  */
-let MailService = MailService_1 = class MailService {
+let MailService = class MailService extends base_http_service_1.BaseHttpService {
     /**
-     * Initializes the PassService with appropriate API client and settings.
+     * Creates a MailService client for a specific resource.
      *
-     * @param {AuthenticationModuleOptions} authOptions - Contains Kubernetes service account token
-     * @param {ConfigService} configService - Configuration service for environment checks
-     */
-    constructor(authOptions, configService) {
-        this.authOptions = authOptions;
-        this.configService = configService;
-        this.logger = new common_1.Logger(MailService_1.name);
-        const isProduction = this.configService.get('NODE_ENV') === 'production';
-        // Construct base URL conditionally based on environment.
-        const baseUrl = isProduction
-            ? 'http://organisation-hub-email-service.organisation-hub-services.svc.cluster.local:3000/internal/'
-            : 'https://services.svi-itlab.com/email/internal/';
-        // Initialize axios instance with k8s token and appropriate URL.
-        this.axiosInstance = (0, create_internal_axios_client_function_1.createInternalAxiosClient)({
-            k8sToken: this.authOptions.k8sToken,
-            baseUrl: `${baseUrl}`,
-        });
+     * @param authenticationOptions Authentication options injected from the Auth module.
+     * @param configService NestJS configuration service for environment variables and URLs.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Mail', base_urls_1.BaseUrls.MailService, authenticationOptions, configService);
     }
     /**
-     * Sends an email based on a provided type and payload.
-     *
-     * @template Type
-     * @param {Type} type - The type of email to send (must be a supported type).
-     * @param {MailTypeDtoMap[Type]} payload - The payload DTO matching the type.
+     * Sends an email of the given type with the provided payload.
      *
-     * @remarks
-     * This generic method allows all email variants to be routed through
-     * one point with strong type checking for safety and consistency.
+     * @template Type - One of the supported MailType keys
+     * @param type - The type of email to send
+     * @param payload - The payload DTO corresponding to the type
      */
-    send(type, payload) {
+    sendMail(type, payload) {
         // Email service expects paths like "auth/login-token"
         const endpoint = type.split('.').join('/');
         this.logger.log(`Dispatching email to endpoint: ${endpoint}`);
-        this.axiosInstance
-            .post(endpoint, payload)
+        this.client
+            .post(`internal/${endpoint}`, payload)
             .then(() => {
             this.logger.log(`Email sent successfully: ${type}`);
         })
-            .catch(({ response }) => {
-            this.logger.error(`Failed to send email: ${type}: ${JSON.stringify(response === null || response === void 0 ? void 0 : response.data)}`);
+            .catch((error) => {
+            const { message } = this.parseError(error);
+            this.logger.error(`Failed to send email: ${type}: ${message}`);
         });
     }
     // ─────────────────────────────────────────────
@@ -100,15 +63,15 @@ let MailService = MailService_1 = class MailService {
      * Sends an email with a one-time login token.
      * @param {AuthLoginTokenMailDto} payload - DTO containing recipient and token.
      */
-    sendAuthLoginToken(payload) {
-        this.send('auth.login-token', payload);
+    sendAuthLoginTokenMail(payload) {
+        this.sendMail('auth.login-token', payload);
     }
     /**
      * Sends a password reset email with a secure link.
      * @param {AuthPasswordResetMailDto} payload - DTO containing recipient and reset URL.
      */
-    sendAuthPasswordReset(payload) {
-        this.send('auth.password-reset', payload);
+    sendAuthPasswordResetMail(payload) {
+        this.sendMail('auth.password-reset', payload);
     }
     // ─────────────────────────────────────────────
     // Event Emails
@@ -117,15 +80,15 @@ let MailService = MailService_1 = class MailService {
      * Sends an event invitation email.
      * @param {EventInviteMailDto} payload - DTO containing event details and recipient.
      */
-    sendEventInvite(payload) {
-        this.send('event.invite', payload);
+    sendEventInviteMail(payload) {
+        this.sendMail('event.invite', payload);
     }
     /**
      * Sends a notification about an event cancellation.
      * @param {EventCancelMailDto} payload - DTO containing event title, time, and links.
      */
-    sendEventCancel(payload) {
-        this.send('event.cancel', payload);
+    sendEventCancelMail(payload) {
+        this.sendMail('event.cancel', payload);
     }
     // ─────────────────────────────────────────────
     // Idea Submission Emails
@@ -134,15 +97,15 @@ let MailService = MailService_1 = class MailService {
      * Sends a confirmation that an idea was submitted.
      * @param {IdeaSubmittedMailDto} payload - DTO containing recipient and management URL.
      */
-    sendIdeaSubmitted(payload) {
-        this.send('idea.submitted', payload);
+    sendIdeaSubmittedMail(payload) {
+        this.sendMail('idea.submitted', payload);
     }
     /**
      * Sends a notification that an idea's status has changed.
      * @param {IdeaStatusUpdateMailDto} payload - DTO containing the old and new status.
      */
-    sendIdeaStatusUpdate(payload) {
-        this.send('idea.status-update', payload);
+    sendIdeaStatusUpdateMail(payload) {
+        this.sendMail('idea.status-update', payload);
     }
     // ─────────────────────────────────────────────
     // Lunch Roulette Emails
@@ -151,29 +114,29 @@ let MailService = MailService_1 = class MailService {
      * Sends confirmation of lunch roulette participation.
      * @param {LunchRouletteSubmittedMailDto} payload - DTO with recipient, location, and type.
      */
-    sendLunchRouletteSubmitted(payload) {
-        this.send('lunch-roulette.submitted', payload);
+    sendLunchRouletteSubmittedMail(payload) {
+        this.sendMail('lunch-roulette.submitted', payload);
     }
     /**
      * Sends a cancellation email for lunch roulette.
      * @param {LunchRouletteCancelMailDto} payload - DTO containing the recipient.
      */
-    sendLunchRouletteCancel(payload) {
-        this.send('lunch-roulette.cancel', payload);
+    sendLunchRouletteCancelMail(payload) {
+        this.sendMail('lunch-roulette.cancel', payload);
     }
     /**
      * Sends a match notification to lunch roulette participants.
      * @param {LunchRouletteMatchedMailDto} payload - DTO with recipients, message, and details URL.
      */
-    sendLunchRouletteMatched(payload) {
-        this.send('lunch-roulette.matched', payload);
+    sendLunchRouletteMatchedMail(payload) {
+        this.sendMail('lunch-roulette.matched', payload);
     }
     /**
      * Notifies a user that they were unmatched in lunch roulette.
      * @param {LunchRouletteUnmatchedMailDto} payload - DTO with the unmatched recipient.
      */
-    sendLunchRouletteUnmatched(payload) {
-        this.send('lunch-roulette.unmatched', payload);
+    sendLunchRouletteUnmatchedMail(payload) {
+        this.sendMail('lunch-roulette.unmatched', payload);
     }
     // ─────────────────────────────────────────────
     // Newsletter Emails
@@ -182,22 +145,22 @@ let MailService = MailService_1 = class MailService {
      * Sends confirmation of a newsletter subscription.
      * @param {NewsletterSubscribedMailDto} payload - DTO with recipient information.
      */
-    sendNewsletterSubscribed(payload) {
-        this.send('newsletter.subscribed', payload);
+    sendNewsletterSubscribedMail(payload) {
+        this.sendMail('newsletter.subscribed', payload);
     }
     /**
      * Sends confirmation of newsletter unsubscription.
      * @param {NewsletterUnsubscribedMailDto} payload - DTO with recipient information.
      */
-    sendNewsletterUnsubscribed(payload) {
-        this.send('newsletter.unsubscribed', payload);
+    sendNewsletterUnsubscribedMail(payload) {
+        this.sendMail('newsletter.unsubscribed', payload);
     }
     /**
      * Sends the latest issue of the newsletter.
      * @param {NewsletterIssueMailDto} payload - DTO containing recipients, content, and metadata.
      */
-    sendNewsletterIssue(payload) {
-        this.send('newsletter.issue', payload);
+    sendNewsletterIssueMail(payload) {
+        this.sendMail('newsletter.issue', payload);
     }
     // ─────────────────────────────────────────────
     // Notification Emails
@@ -206,13 +169,13 @@ let MailService = MailService_1 = class MailService {
      * Sends a general-purpose email notification.
      * @param {NotificationMailDto} payload - DTO with recipients, title, message, and optional URL.
      */
-    sendNotification(payload) {
-        this.send('notification.notification', payload);
+    sendNotificationMail(payload) {
+        this.sendMail('notification.notification', payload);
     }
 };
 exports.MailService = MailService;
-exports.MailService = MailService = MailService_1 = __decorate([
+exports.MailService = MailService = __decorate([
     (0, common_1.Injectable)(),
-    __param(0, (0, authentication_1.InjectAuthOptions)()),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
     __metadata("design:paramtypes", [Object, config_1.ConfigService])
 ], MailService);

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

@@ -0,0 +1,29 @@
+import { ConfigService } from '@nestjs/config';
+import { LabNewsletter } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+/**
+ * NewsletterService
+ *
+ * Service client for interacting with the Newsletter domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class NewsletterService extends BaseHttpService {
+    /**
+     * Constructs a Newsletter service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Retrieves a single issue entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} issueId - Unique MongoDB identifier of the issue item.
+     * @returns {Promise<LabNewsletter | undefined>} Resolves to the issue object if found, otherwise `undefined`.
+     */
+    fetchIssueById(issueId: string): Promise<LabNewsletter | undefined>;
+}

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

@@ -0,0 +1,53 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __param = (this && this.__param) || function (paramIndex, decorator) {
+    return function (target, key) { decorator(target, key, paramIndex); }
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.NewsletterService = void 0;
+const config_1 = require("@nestjs/config");
+const authentication_1 = require("../../authentication");
+const base_http_service_1 = require("../base-http.service");
+const base_urls_1 = require("../base-urls");
+/**
+ * NewsletterService
+ *
+ * Service client for interacting with the Newsletter domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+let NewsletterService = class NewsletterService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs a Newsletter service client.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Authentication options (provided by DI).
+     * @param {ConfigService} configService - Global NestJS config service for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Newsletter', base_urls_1.BaseUrls.NewsletterService, authenticationOptions, configService);
+    }
+    /**
+     * Retrieves a single issue entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} issueId - Unique MongoDB identifier of the issue item.
+     * @returns {Promise<LabNewsletter | undefined>} Resolves to the issue object if found, otherwise `undefined`.
+     */
+    async fetchIssueById(issueId) {
+        return this.fetchResource(`internal/issue/${issueId}`);
+    }
+};
+exports.NewsletterService = NewsletterService;
+exports.NewsletterService = NewsletterService = __decorate([
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], NewsletterService);

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

@@ -0,0 +1,47 @@
+import { ConfigService } from '@nestjs/config';
+import { LabNews } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../authentication';
+import { BaseHttpService } from '../base-http.service';
+type FetchNewsOptions = {
+    includeDrafts?: boolean;
+    includeContent?: boolean;
+    includeComments?: boolean;
+    includeAuthors?: boolean;
+};
+/**
+ * NewsroomService
+ *
+ * Service client for interacting with the Newsroom domain.
+ * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+ */
+export declare class NewsroomService extends BaseHttpService {
+    /**
+     * NewsroomService
+     *
+     * Service client for interacting with the Newsroom domain.
+     * Inherits logging, authentication, and environment-sensitive URL resolution from `BaseHttpService`.
+     */
+    constructor(authenticationOptions: AuthenticationModuleOptions, configService: ConfigService);
+    /**
+     * Retrieves a single news entry by its MongoDB identifier.
+     *
+     * If the downstream call fails or the resource does not exist, the method
+     * will log the failure and return `undefined`.
+     *
+     * @param {string} newsId - Unique MongoDB identifier of the news item.
+     * @param options - Optional flags controlling retrieval behavior.
+     * @returns {Promise<LabNews | undefined>} Resolves to the news object if found, otherwise `undefined`.
+     */
+    fetchNewsById(newsId: string, options?: FetchNewsOptions): Promise<LabNews | undefined>;
+    /**
+     * Retrieves a collection of news entries by their MongoDB identifiers.
+     *
+     * If the downstream call fails, an empty array is returned.
+     *
+     * @param {string[]} newsIds - Array of MongoDB identifiers for the news items.
+     * @param options - Optional flags controlling retrieval behavior.
+     * @returns {Promise<LabNews[]>} Resolves to an array of news objects (empty if none found).
+     */
+    getNewsCollection(newsIds: string[], options?: FetchNewsOptions): Promise<LabNews[]>;
+}
+export {};