@get-technology-inc/jamf-docs-mcp-server 3.0.5 → 3.0.7

package/dist/core/services/interfaces.d.ts

@@ -1,94 +0,0 @@
-/**
- * Core service interfaces for platform abstraction
- *
- * These interfaces decouple business logic from Node.js-specific implementations,
- * enabling deployment to different runtimes (e.g., Cloudflare Workers).
- */
-import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-/**
- * Cache statistics
- */
-export interface CacheStats {
-    memoryEntries: number;
-    totalEntries: number;
-    totalSize?: number;
-}
-/**
- * Platform-agnostic cache provider
- */
-export interface CacheProvider {
-    get<T>(key: string): Promise<T | null>;
-    set<T>(key: string, value: T, ttl?: number): Promise<void>;
-    delete(key: string): Promise<boolean>;
-    clear(): Promise<void>;
-    stats(): Promise<CacheStats>;
-    prune(): Promise<number>;
-}
-/**
- * Product metadata returned by the metadata store
- */
-export interface ProductMetadata {
-    id: string;
-    name: string;
-    description: string;
-    bundleId: string;
-    latestVersion: string;
-    availableVersions: string[];
-    labelKey: string;
-}
-/**
- * Topic metadata returned by the metadata store
- */
-export interface TopicMetadata {
-    id: string;
-    name: string;
-    source: 'toc' | 'manual';
-    articleCount?: number;
-}
-/**
- * Table of contents entry (recursive tree structure)
- */
-export interface TocEntry {
-    title: string;
-    url: string;
-    children?: TocEntry[];
-}
-/**
- * Structured table of contents data for a product
- */
-export interface TocData {
-    entries: TocEntry[];
-    product: string;
-    version: string;
-}
-/**
- * Platform-agnostic metadata store for Jamf documentation
- */
-export interface MetadataStore {
-    getProducts(): Promise<ProductMetadata[]>;
-    getTopics(): Promise<TopicMetadata[]>;
-    getToc(productId: string, bundleId: string): Promise<TocData>;
-    getBundleIdForVersion(productId: string, version?: string): Promise<string | null>;
-    getAvailableVersions(productId: string): Promise<string[]>;
-}
-/**
- * Logger instance bound to a specific module name
- */
-export interface Logger {
-    debug(data: unknown): void;
-    info(data: unknown): void;
-    notice(data: unknown): void;
-    warning(data: unknown): void;
-    error(data: unknown): void;
-    critical(data: unknown): void;
-    alert(data: unknown): void;
-    emergency(data: unknown): void;
-}
-/**
- * Factory for creating named logger instances
- */
-export interface LoggerFactory {
-    createLogger(name: string): Logger;
-    setServer(server: McpServer): void;
-}
-//# sourceMappingURL=interfaces.d.ts.map

package/dist/core/services/interfaces.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/core/services/interfaces.ts"],"names":[],"mappings":"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"}

package/dist/core/services/interfaces.js

@@ -1,8 +0,0 @@
-/**
- * Core service interfaces for platform abstraction
- *
- * These interfaces decouple business logic from Node.js-specific implementations,
- * enabling deployment to different runtimes (e.g., Cloudflare Workers).
- */
-export {};
-//# sourceMappingURL=interfaces.js.map

package/dist/core/services/interfaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../../../src/core/services/interfaces.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/core/services/scraper.d.ts

@@ -1,90 +0,0 @@
-/**
- * Web scraping service for Jamf documentation
- *
- * This module handles fetching and parsing HTML from learn.jamf.com
- * (Jamf documentation has moved from docs.jamf.com to learn.jamf.com)
- */
-import { type ProductId, type LocaleId } from '../constants.js';
-import { type SearchResult, type ParsedArticle, type TocEntry, type SearchParams, type TokenInfo, type PaginationInfo, type ArticleSection, type FilterRelaxation, type TruncatedContentInfo } from '../types.js';
-import type { ServerContext } from '../types/context.js';
-export { ALLOWED_HOSTNAMES, isAllowedHostname } from '../utils/url.js';
-/**
- * Strip locale prefix (e.g. /en-US/, /ja-JP/) from URL path.
- * Frontend URLs include locale in path but backend doesn't accept it.
- */
-export declare function stripLocalePrefix(urlStr: string): string;
-export declare function transformToBackendUrl(urlStr: string): string;
-export declare function transformToFrontendUrl(urlStr: string): string;
-/**
- * Clean and validate a search result snippet
- * Filters navigation-only text and ensures minimum content quality
- */
-export declare function cleanSnippet(snippet: string, title: string, product: string | null): string;
-/**
- * Build Accept-Language header value for a given locale
- */
-export declare function buildAcceptLanguage(locale: string): string;
-/**
- * Fetch HTML from a URL with error handling.
- * Requires a ServerContext for request configuration.
- */
-export declare function fetchHtml(ctx: ServerContext, url: string, locale?: string): Promise<string>;
-/**
- * Search response with token and pagination info
- */
-export interface SearchDocumentationResult {
-    results: SearchResult[];
-    pagination: PaginationInfo;
-    tokenInfo: TokenInfo;
-    filterRelaxation?: FilterRelaxation;
-    versionNote?: string;
-    truncatedContent?: TruncatedContentInfo;
-}
-/**
- * Search Jamf documentation using Zoomin Search API
- */
-export declare function searchDocumentation(ctx: ServerContext, params: SearchParams): Promise<SearchDocumentationResult>;
-/**
- * Options for fetching articles
- */
-export interface FetchArticleOptions {
-    includeRelated?: boolean;
-    section?: string;
-    summaryOnly?: boolean;
-    maxTokens?: number;
-    locale?: LocaleId | undefined;
-}
-/**
- * Article result with token and section info
- */
-export interface FetchArticleResult extends ParsedArticle {
-    tokenInfo: TokenInfo;
-    sections: ArticleSection[];
-}
-/**
- * Fetch and parse a documentation article
- * Uses backend URL (learn-be.jamf.com) for pre-rendered content
- */
-export declare function fetchArticle(ctx: ServerContext, url: string, options?: FetchArticleOptions): Promise<FetchArticleResult>;
-/**
- * Options for fetching table of contents
- */
-export interface FetchTocOptions {
-    page?: number;
-    maxTokens?: number;
-    locale?: LocaleId | undefined;
-}
-/**
- * TOC result with pagination and token info
- */
-export interface FetchTocResult {
-    toc: TocEntry[];
-    pagination: PaginationInfo;
-    tokenInfo: TokenInfo;
-}
-/**
- * Fetch table of contents for a product
- * Uses backend TOC endpoint (learn-be.jamf.com/bundle/{bundleId}/toc)
- */
-export declare function fetchTableOfContents(ctx: ServerContext, product: ProductId, version?: string, options?: FetchTocOptions): Promise<FetchTocResult>;
-//# sourceMappingURL=scraper.d.ts.map

package/dist/core/services/scraper.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scraper.d.ts","sourceRoot":"","sources":["../../../src/core/services/scraper.ts"],"names":[],"mappings":"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"}