itlab-internal-services 2.16.8 → 2.16.10

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

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

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

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

@@ -0,0 +1,27 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, DraftedFetchOptions, LikedByFetchOptions, TimestampsFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchEventOptionsDtoV1
+ *
+ * Data Transfer Object for querying event or user collections.
+ * Inherits timestamp filtering fields and extends them with
+ * event-specific query parameters.
+ */
+export type FetchEventOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & DraftedFetchOptions & ContentFetchOptions & ViewedByFetchOptions & LikedByFetchOptions & CommentsFetchOptions & {
+    includeAttendedBy?: boolean;
+    includeAttendedByIds?: boolean;
+    includeSpeakers?: boolean;
+    topic?: string;
+    topics?: string[];
+    mode?: string;
+    modes?: string[];
+    speakerId?: string;
+    speakerIds?: string[];
+    series?: string;
+    seriesIn?: string[];
+    year?: number;
+    month?: number;
+    startAtMin?: number;
+    startAtMax?: number;
+    endAtMin?: number;
+    endAtMax?: number;
+};

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

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

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

package/dist/modules/services/providers/files/crop-image-options.dto.v1.type.d.ts

@@ -0,0 +1,13 @@
+/**
+ * CropImageOptionsDtoV1
+ *
+ * Data Transfer Object for cropping images.
+ */
+export type CropImageOptionsDtoV1 = {
+    format?: 'webp' | 'png' | 'jpg' | 'jpeg';
+    width?: number;
+    height?: number;
+    radius?: number;
+    quality?: number;
+    background?: string;
+};

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

@@ -0,0 +1,21 @@
+import { BaseFetchOptions, TimestampsFetchOptions } from '../../../../classes';
+/**
+ * FetchFileOptionsDtoV1
+ *
+ * Data Transfer Object for querying file collections.
+ * Inherits timestamp filtering fields and extends them with
+ * file-specific query parameters.
+ */
+export type FetchFileOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & {
+    inFolder?: boolean;
+    folderId?: string;
+    folderIds?: string[];
+    tag?: string;
+    tags?: string[];
+    mimetype?: string;
+    mimetypes?: string[];
+    type?: string;
+    types?: string[];
+    extension?: string;
+    extensions?: string[];
+};

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

@@ -0,0 +1,15 @@
+import { BaseFetchOptions, TimestampsFetchOptions } from '../../../../classes';
+/**
+ * FetchFolderOptionsDtoV1
+ *
+ * Data Transfer Object for querying folder collections.
+ * Inherits timestamp filtering fields and extends them with
+ * folder-specific query parameters.
+ */
+export type FetchFolderOptionsDtoV1 = BaseFetchOptions & TimestampsFetchOptions & {
+    includeFiles?: boolean;
+    includeFolders?: boolean;
+    isRoot?: boolean;
+    parentId?: string;
+    parentIds?: string[];
+};

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

@@ -0,0 +1,106 @@
+import { ConfigService } from '@nestjs/config';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { CropImageOptionsDtoV1 } from './crop-image-options.dto.v1.type';
+import { FetchFileOptionsDtoV1 } from './fetch-file-options.dto.v1.type';
+import { FetchFolderOptionsDtoV1 } from './fetch-folder-options.dto.v1.type';
+type LabFile = {
+    id: string;
+    _url: string;
+    folderId?: string;
+    name: string;
+    tags: string[];
+    extension: string;
+    mimetype: string;
+    type: string;
+    size: number;
+};
+type LabFolder = {
+    id: string;
+    _url: string;
+    parentId?: string;
+    name: string;
+    fileIds: string[];
+    size: number;
+    files?: LabFile[];
+    folders?: LabFolder[];
+};
+/**
+ * FilesService
+ *
+ * Service client responsible for interacting with the Files 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 FilesService extends BaseHttpService {
+    /**
+     * Constructs an Files 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 file entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} fileId - Unique MongoDB identifier of the file.
+     * @param {FetchFileOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabFile | undefined>} Resolves to an File or `undefined` on failure.
+     */
+    fetchFileV1(fileId: string, options?: FetchFileOptionsDtoV1): Promise<LabFile | undefined>;
+    /**
+     * Retrieves a collection of file ids.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFileOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<string[]>} Resolves to a list of file ids, or an empty array if none found.
+     */
+    fetchFileIdsV1(options?: FetchFileOptionsDtoV1): Promise<string[]>;
+    /**
+     * Retrieves a collection of file entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFileOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabFile[]>} Resolves to a list of files, or an empty array if none found.
+     */
+    fetchFileCollectionV1(options?: FetchFileOptionsDtoV1): Promise<LabFile[]>;
+    /**
+     * Retrieves a single folder entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} folderId - Unique MongoDB identifier of the folder.
+     * @param {FetchFolderOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabFolder | undefined>} Resolves to an Folder or `undefined` on failure.
+     */
+    fetchFolderV1(folderId: string, options?: FetchFolderOptionsDtoV1): Promise<LabFolder | undefined>;
+    /**
+     * Retrieves a collection of folder entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFolderOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabFolder[]>} Resolves to a list of folders, or an empty array if none found.
+     */
+    fetchFolderCollectionV1(options?: FetchFolderOptionsDtoV1): Promise<LabFolder[]>;
+    uploadAvatarV1(accountId: string, avatar: File): Promise<void>;
+    deleteAvatarV1(accountId: string): Promise<void>;
+    cropImageV1(image: File, options?: CropImageOptionsDtoV1): Promise<Buffer>;
+}
+export {};

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

@@ -0,0 +1,146 @@
+"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.FilesService = 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");
+/**
+ * FilesService
+ *
+ * Service client responsible for interacting with the Files 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 FilesService = class FilesService extends base_http_service_1.BaseHttpService {
+    /**
+     * Constructs an Files service client instance.
+     *
+     * @param {AuthenticationModuleOptions} authenticationOptions - Injected authentication configuration.
+     * @param {ConfigService} configService - NestJS ConfigService for environment detection.
+     */
+    constructor(authenticationOptions, configService) {
+        super('Files', base_urls_1.BaseUrls.filesService, authenticationOptions, configService);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // File Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single file entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} fileId - Unique MongoDB identifier of the file.
+     * @param {FetchFileOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabFile | undefined>} Resolves to an File or `undefined` on failure.
+     */
+    async fetchFileV1(fileId, options) {
+        return this.fetchResource(`v1/internal/file/${fileId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of file ids.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFileOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<string[]>} Resolves to a list of file ids, or an empty array if none found.
+     */
+    async fetchFileIdsV1(options) {
+        return this.fetchResourceCollection(`v1/internal/files/list`, { params: options });
+    }
+    /**
+     * Retrieves a collection of file entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFileOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabFile[]>} Resolves to a list of files, or an empty array if none found.
+     */
+    async fetchFileCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/files`, { params: options });
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Folder Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    /**
+     * Retrieves a single folder entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} folderId - Unique MongoDB identifier of the folder.
+     * @param {FetchFolderOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabFolder | undefined>} Resolves to an Folder or `undefined` on failure.
+     */
+    async fetchFolderV1(folderId, options) {
+        return this.fetchResource(`v1/internal/folder/${folderId}`, { params: options });
+    }
+    /**
+     * Retrieves a collection of folder entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchFolderOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabFolder[]>} Resolves to a list of folders, or an empty array if none found.
+     */
+    async fetchFolderCollectionV1(options) {
+        return this.fetchResourceCollection(`v1/internal/folders`, { params: options });
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Avatar Resource Methods
+    // ─────────────────────────────────────────────────────────────
+    async uploadAvatarV1(accountId, avatar) {
+        const formData = new FormData();
+        formData.set('avatar', avatar, avatar.name);
+        await this.httpClient.post(`v1/internal/avatar/${accountId}`, formData);
+    }
+    async deleteAvatarV1(accountId) {
+        await this.httpClient.delete(`v1/internal/${accountId}`);
+    }
+    // ─────────────────────────────────────────────────────────────
+    // Crop Image Methods
+    // ─────────────────────────────────────────────────────────────
+    async cropImageV1(image, options) {
+        const formData = new FormData();
+        formData.set('image', image, image.name);
+        try {
+            const { data } = await this.httpClient.post(`v1/internal/crop/image`, formData, { params: options });
+            return data;
+        }
+        catch (error) {
+            const { status, data, message } = this.parseError(error);
+            this.logger.error(`Error cropping image: ${message}`);
+            throw new common_1.HttpException(data, status);
+        }
+    }
+};
+exports.FilesService = FilesService;
+exports.FilesService = FilesService = __decorate([
+    (0, common_1.Injectable)(),
+    __param(0, (0, authentication_1.InjectAuthenticationOptions)()),
+    __metadata("design:paramtypes", [Object, config_1.ConfigService])
+], FilesService);

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

@@ -0,0 +1,4 @@
+export * from './crop-image-options.dto.v1.type';
+export * from './fetch-file-options.dto.v1.type';
+export * from './fetch-folder-options.dto.v1.type';
+export * from './files.service';

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

@@ -0,0 +1,20 @@
+"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("./crop-image-options.dto.v1.type"), exports);
+__exportStar(require("./fetch-file-options.dto.v1.type"), exports);
+__exportStar(require("./fetch-folder-options.dto.v1.type"), exports);
+__exportStar(require("./files.service"), exports);

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

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

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

@@ -0,0 +1,17 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, LikedByFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchDocOptionsDtoV1
+ *
+ * Data Transfer Object for querying doc collections.
+ * Inherits timestamp filtering fields and extends them with
+ * doc-specific query parameters.
+ */
+export type FetchDocOptionsDtoV1 = BaseFetchOptions & ContentFetchOptions & ViewedByFetchOptions & LikedByFetchOptions & CommentsFetchOptions & {
+    includeAuthor?: boolean;
+    topic?: string;
+    topics?: string[];
+    authorId?: string;
+    authorIds?: string[];
+    timestampMin?: number;
+    timestampMax?: number;
+};

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

@@ -0,0 +1,18 @@
+import { BaseFetchOptions, CommentsFetchOptions, ContentFetchOptions, ViewedByFetchOptions } from '../../../../classes';
+/**
+ * FetchThreadOptionsDtoV1
+ *
+ * Data Transfer Object for querying thread collections.
+ * Inherits timestamp filtering fields and extends them with
+ * thread-specific query parameters.
+ */
+export type FetchThreadOptionsDtoV1 = BaseFetchOptions & ContentFetchOptions & ViewedByFetchOptions & CommentsFetchOptions & {
+    includeAuthor?: boolean;
+    isClosed?: boolean;
+    tag?: string;
+    tags?: string[];
+    authorId?: string;
+    authorIds?: string[];
+    timestampMin?: number;
+    timestampMax?: number;
+};

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

@@ -0,0 +1,93 @@
+import { ConfigService } from '@nestjs/config';
+import { LabHackschoolCourse, LabHackschoolDoc, LabHackschoolThread } from 'itlab-functions';
+import { AuthenticationModuleOptions } from '../../../authentication';
+import { BaseHttpService } from '../../base-http.service';
+import { FetchCourseOptionsDtoV1 } from './fetch-course-options.dto.v1.type';
+import { FetchDocOptionsDtoV1 } from './fetch-doc-options.dto.v1.type';
+import { FetchThreadOptionsDtoV1 } from './fetch-thread-options.dto.v1.type';
+/**
+ * HackschoolService
+ *
+ * Service client responsible for interacting with the Hackschool 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 HackschoolService extends BaseHttpService {
+    /**
+     * Constructs an Hackschool 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 course entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} courseId - Unique MongoDB identifier of the course.
+     * @param {FetchCourseOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabHackschoolCourse | undefined>} Resolves to an Course or `undefined` on failure.
+     */
+    fetchCourseV1(courseId: string, options?: FetchCourseOptionsDtoV1): Promise<LabHackschoolCourse | undefined>;
+    /**
+     * Retrieves a collection of course entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchCourseOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabHackschoolCourse[]>} Resolves to a list of courses, or an empty array if none found.
+     */
+    fetchCourseCollectionV1(options?: FetchCourseOptionsDtoV1): Promise<LabHackschoolCourse[]>;
+    /**
+     * Retrieves a single thread entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} threadId - Unique MongoDB identifier of the thread.
+     * @param {FetchThreadOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabHackschoolThread | undefined>} Resolves to an Thread or `undefined` on failure.
+     */
+    fetchThreadV1(threadId: string, options?: FetchThreadOptionsDtoV1): Promise<LabHackschoolThread | undefined>;
+    /**
+     * Retrieves a collection of thread entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchThreadOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabHackschoolThread[]>} Resolves to a list of threads, or an empty array if none found.
+     */
+    fetchThreadCollectionV1(options?: FetchThreadOptionsDtoV1): Promise<LabHackschoolThread[]>;
+    /**
+     * Retrieves a single doc entry by its MongoDB identifier.
+     *
+     * This method gracefully handles downstream failures by logging
+     * and returning `undefined` instead of throwing.
+     *
+     * @param {string} docId - Unique MongoDB identifier of the doc.
+     * @param {FetchDocOptionsDtoV1} [options] - Optional query parameters for filtering or projection.
+     * @returns {Promise<LabHackschoolDoc | undefined>} Resolves to an Doc or `undefined` on failure.
+     */
+    fetchDocV1(docId: string, options?: FetchDocOptionsDtoV1): Promise<LabHackschoolDoc | undefined>;
+    /**
+     * Retrieves a collection of doc entries.
+     *
+     * Useful for batch lookups or paginated listings.
+     * Returns an empty array if the downstream service call fails.
+     *
+     * @param {FetchDocOptionsDtoV1} [options] - Optional filter options for narrowing results.
+     * @returns {Promise<LabHackschoolDoc[]>} Resolves to a list of docs, or an empty array if none found.
+     */
+    fetchDocCollectionV1(options?: FetchDocOptionsDtoV1): Promise<LabHackschoolDoc[]>;
+}