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