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

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

@@ -3,30 +3,50 @@
  *
  * Provides dual output: MCP notifications (visible to AI clients) + stderr (visible to developers).
  * Log level filtering for MCP notifications is handled by the SDK (logging/setLevel).
+ *
+ * LoggingService is a class that holds the MCP server reference as instance state,
+ * avoiding module-level mutable singletons that are incompatible with
+ * Cloudflare Workers (where module scope persists across requests).
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { Logger, WriteStderrFn } from './interfaces/index.js';
+export type { Logger, WriteStderrFn };
 /**
- * Register the MCP server instance for sending log notifications.
- * Must be called after server creation but before tools are invoked.
- */
-export declare function setServer(server: McpServer): void;
-/**
- * Logger instance bound to a specific logger name.
+ * Logging service that holds MCP server reference as instance state.
+ *
+ * Each server instance should create its own LoggingService, so that
+ * multiple servers running in the same isolate don't share state.
+ *
+ * @param writeStderr - Optional writer function for stderr-style output.
+ *   Defaults to `console.error`. Pass `console.log` or a no-op for
+ *   platforms without stderr (e.g. Cloudflare Workers).
  */
-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;
+export declare class LoggingService {
+    private mcpServer;
+    private readonly writeStderr;
+    constructor(writeStderr?: WriteStderrFn);
+    /**
+     * Register the MCP server instance for sending log notifications.
+     * Must be called after server creation but before tools are invoked.
+     */
+    setServer(server: McpServer): void;
+    /**
+     * Create a named logger instance.
+     *
+     * @param name - Logger name identifying the source module
+     */
+    createLogger(name: string): Logger;
+    private log;
+    private sendMcpLog;
 }
 /**
- * Create a named logger instance.
+ * Create a stderr-only logger (no MCP notifications).
+ *
+ * Use this for bootstrap / transport code that runs before
+ * a ServerContext is available, or outside of a request scope.
  *
- * @param name - Logger name identifying the source module (e.g., 'search', 'cache', 'scraper')
+ * @param name - Logger name identifying the source module
+ * @param writeStderr - Optional writer function (defaults to console.error)
  */
-export declare function createLogger(name: string): Logger;
+export declare function createStderrLogger(name: string, writeStderr?: WriteStderrFn): Logger;
 //# sourceMappingURL=logging.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/core/services/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE;;;GAGG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAEjD;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IACjC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,QAAQ,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAClC,KAAK,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;IAC/B,SAAS,EAAE,CAAC,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CACpC;AAiCD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAWjD"}
+{"version":3,"file":"logging.d.ts","sourceRoot":"","sources":["../../../src/core/services/logging.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEnE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,CAAC;AA6BtC;;;;;;;;;GASG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAgB;gBAEhC,WAAW,CAAC,EAAE,aAAa;IAIvC;;;OAGG;IACH,SAAS,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAIlC;;;;OAIG;IACH,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAalC,OAAO,CAAC,GAAG;IAKX,OAAO,CAAC,UAAU;CAUnB;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,CAAC,EAAE,aAAa,GAC1B,MAAM,CAYR"}

package/dist/core/services/logging.js

@@ -3,16 +3,19 @@
  *
  * Provides dual output: MCP notifications (visible to AI clients) + stderr (visible to developers).
  * Log level filtering for MCP notifications is handled by the SDK (logging/setLevel).
+ *
+ * LoggingService is a class that holds the MCP server reference as instance state,
+ * avoiding module-level mutable singletons that are incompatible with
+ * Cloudflare Workers (where module scope persists across requests).
  */
-let mcpServer = null;
 /**
- * Register the MCP server instance for sending log notifications.
- * Must be called after server creation but before tools are invoked.
+ * Default writer — delegates to console.error (Node.js stderr).
+ * Uses late binding so test spies on console.error are respected.
  */
-export function setServer(server) {
-    mcpServer = server;
+function defaultWriteStderr(formatted) {
+    console.error(formatted);
 }
-function writeStderr(level, loggerName, data) {
+function formatLogLine(level, loggerName, data) {
     const label = level.toUpperCase();
     let message;
     if (typeof data === 'string') {
@@ -26,36 +29,82 @@ function writeStderr(level, loggerName, data) {
             message = String(data);
         }
     }
-    console.error(`[${label}] [${loggerName}] ${message}`);
+    return `[${label}] [${loggerName}] ${message}`;
 }
-function sendMcpLog(level, loggerName, data) {
-    if (mcpServer === null) {
-        return;
+/**
+ * Logging service that holds MCP server reference as instance state.
+ *
+ * Each server instance should create its own LoggingService, so that
+ * multiple servers running in the same isolate don't share state.
+ *
+ * @param writeStderr - Optional writer function for stderr-style output.
+ *   Defaults to `console.error`. Pass `console.log` or a no-op for
+ *   platforms without stderr (e.g. Cloudflare Workers).
+ */
+export class LoggingService {
+    mcpServer = null;
+    writeStderr;
+    constructor(writeStderr) {
+        this.writeStderr = writeStderr ?? defaultWriteStderr;
+    }
+    /**
+     * Register the MCP server instance for sending log notifications.
+     * Must be called after server creation but before tools are invoked.
+     */
+    setServer(server) {
+        this.mcpServer = server;
+    }
+    /**
+     * Create a named logger instance.
+     *
+     * @param name - Logger name identifying the source module
+     */
+    createLogger(name) {
+        return {
+            debug: (data) => { this.log('debug', name, data); },
+            info: (data) => { this.log('info', name, data); },
+            notice: (data) => { this.log('notice', name, data); },
+            warning: (data) => { this.log('warning', name, data); },
+            error: (data) => { this.log('error', name, data); },
+            critical: (data) => { this.log('critical', name, data); },
+            alert: (data) => { this.log('alert', name, data); },
+            emergency: (data) => { this.log('emergency', name, data); },
+        };
+    }
+    log(level, loggerName, data) {
+        this.writeStderr(formatLogLine(level, loggerName, data));
+        this.sendMcpLog(level, loggerName, data);
+    }
+    sendMcpLog(level, loggerName, data) {
+        if (this.mcpServer === null) {
+            return;
+        }
+        // Fire-and-forget: don't await, don't throw
+        this.mcpServer.sendLoggingMessage({ level, logger: loggerName, data }).catch(() => {
+            // Silently ignore send failures (server may not be connected yet)
+        });
     }
-    // Fire-and-forget: don't await, don't throw
-    mcpServer.sendLoggingMessage({ level, logger: loggerName, data }).catch(() => {
-        // Silently ignore send failures (server may not be connected yet)
-    });
-}
-function log(level, loggerName, data) {
-    writeStderr(level, loggerName, data);
-    sendMcpLog(level, loggerName, data);
 }
 /**
- * Create a named logger instance.
+ * Create a stderr-only logger (no MCP notifications).
+ *
+ * Use this for bootstrap / transport code that runs before
+ * a ServerContext is available, or outside of a request scope.
  *
- * @param name - Logger name identifying the source module (e.g., 'search', 'cache', 'scraper')
+ * @param name - Logger name identifying the source module
+ * @param writeStderr - Optional writer function (defaults to console.error)
  */
-export function createLogger(name) {
+export function createStderrLogger(name, writeStderr) {
+    const writer = writeStderr ?? defaultWriteStderr;
     return {
-        debug: (data) => { log('debug', name, data); },
-        info: (data) => { log('info', name, data); },
-        notice: (data) => { log('notice', name, data); },
-        warning: (data) => { log('warning', name, data); },
-        error: (data) => { log('error', name, data); },
-        critical: (data) => { log('critical', name, data); },
-        alert: (data) => { log('alert', name, data); },
-        emergency: (data) => { log('emergency', name, data); },
+        debug: (data) => { writer(formatLogLine('debug', name, data)); },
+        info: (data) => { writer(formatLogLine('info', name, data)); },
+        notice: (data) => { writer(formatLogLine('notice', name, data)); },
+        warning: (data) => { writer(formatLogLine('warning', name, data)); },
+        error: (data) => { writer(formatLogLine('error', name, data)); },
+        critical: (data) => { writer(formatLogLine('critical', name, data)); },
+        alert: (data) => { writer(formatLogLine('alert', name, data)); },
+        emergency: (data) => { writer(formatLogLine('emergency', name, data)); },
     };
 }
 //# sourceMappingURL=logging.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/core/services/logging.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,IAAI,SAAS,GAAqB,IAAI,CAAC;AAEvC;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,MAAiB;IACzC,SAAS,GAAG,MAAM,CAAC;AACrB,CAAC;AAgBD,SAAS,WAAW,CAAC,KAAmB,EAAE,UAAkB,EAAE,IAAa;IACzE,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,IAAI,OAAe,CAAC;IACpB,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC7B,OAAO,GAAG,IAAI,CAAC;IACjB,CAAC;SAAM,CAAC;QACN,IAAI,CAAC;YACH,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACjC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,UAAU,KAAK,OAAO,EAAE,CAAC,CAAC;AACzD,CAAC;AAED,SAAS,UAAU,CAAC,KAAmB,EAAE,UAAkB,EAAE,IAAa;IACxE,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,OAAO;IACT,CAAC;IAED,4CAA4C;IAC5C,SAAS,CAAC,kBAAkB,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;QAC3E,kEAAkE;IACpE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,GAAG,CAAC,KAAmB,EAAE,UAAkB,EAAE,IAAa;IACjE,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IACrC,UAAU,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO;QACL,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,IAAI,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC3D,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,QAAQ,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7D,KAAK,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvD,SAAS,EAAE,CAAC,IAAa,EAAE,EAAE,GAAG,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;KAChE,CAAC;AACJ,CAAC"}
+{"version":3,"file":"logging.js","sourceRoot":"","sources":["../../../src/core/services/logging.ts"],"names":[],"mappings":"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"}

package/dist/core/services/maps-registry.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Maps Registry — product/version/locale → mapId resolution
+ *
+ * Builds a lookup table from FT's GET /api/khub/maps response.
+ * All mapIds are dynamically discovered, nothing hardcoded.
+ *
+ * Key concepts:
+ * - `bundleStem`: product identifier without version (e.g., "jamf-pro-documentation")
+ *   Derived from `version_bundle_stem` metadata, or parsed from `bundle` values.
+ * - Each map is locale-specific (separate mapId per language)
+ * - `latestVersion=yes` marks the current version
+ */
+import { fetchMaps } from './ft-client.js';
+import { type LocaleId } from '../constants.js';
+import type { CacheProvider, MapsProvider } from './interfaces/index.js';
+export interface MapEntry {
+    mapId: string;
+    title: string;
+    bundleStem: string;
+    version: string;
+    locale: string;
+    isLatest: boolean;
+    bundleValues: string[];
+}
+export interface RegistryProductInfo {
+    bundleStem: string;
+    title: string;
+    versions: string[];
+}
+export declare class MapsRegistry {
+    private readonly cache;
+    private entries;
+    private builtAt;
+    private buildPromise;
+    private readonly fetchMapsFn;
+    private readonly mapsProvider;
+    private readonly cacheTtl;
+    constructor(cache: CacheProvider, fetchMapsFn?: typeof fetchMaps, mapsProvider?: MapsProvider, cacheTtl?: number);
+    /**
+     * Reset the registry so the next `ensureBuilt()` call re-fetches from
+     * the API (or cache). Use this to force invalidation when stale data
+     * is suspected.
+     */
+    reset(): void;
+    /**
+     * Build the registry from FT API (cached).
+     * Uses in-flight deduplication to prevent thundering herd when
+     * multiple concurrent callers invoke ensureBuilt() simultaneously.
+     */
+    ensureBuilt(): Promise<void>;
+    /**
+     * Internal build logic: fetch maps from cache or API and populate entries.
+     */
+    private doBuild;
+    private parseMap;
+    /**
+     * Resolve a product + optional version + locale to a mapId.
+     * Returns null if not found.
+     */
+    resolveMapId(bundleStem: string, version?: string, locale?: LocaleId): Promise<string | null>;
+    private findMap;
+    /**
+     * Resolve a legacy bundleId (e.g., "jamf-pro-documentation-11.12.0")
+     * to a mapId.
+     */
+    resolveFromBundleId(bundleId: string, locale?: LocaleId): Promise<string | null>;
+    /**
+     * Find the glossary map for a given locale.
+     * Searches for maps with bundleStem containing "glossary".
+     */
+    resolveGlossaryMapId(locale?: LocaleId): Promise<string | null>;
+    /**
+     * Get all unique products for a locale.
+     */
+    getProducts(locale?: LocaleId): Promise<RegistryProductInfo[]>;
+    /**
+     * Get available versions for a product.
+     * Filters entries directly instead of rebuilding the full product catalogue.
+     */
+    getVersions(bundleStem: string, locale?: LocaleId): Promise<string[]>;
+}
+//# sourceMappingURL=maps-registry.d.ts.map

package/dist/core/services/maps-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"maps-registry.d.ts","sourceRoot":"","sources":["../../../src/core/services/maps-registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAkB,KAAK,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAWzE,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,CAAC;IAClB,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA+BD,qBAAa,YAAY;IASrB,OAAO,CAAC,QAAQ,CAAC,KAAK;IARxB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,YAAY,CAA8B;IAClD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAmB;IAC/C,OAAO,CAAC,QAAQ,CAAC,YAAY,CAA2B;IACxD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,KAAK,EAAE,aAAa,EACrC,WAAW,CAAC,EAAE,OAAO,SAAS,EAC9B,YAAY,CAAC,EAAE,YAAY,EAC3B,QAAQ,CAAC,EAAE,MAAM;IAOnB;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAKb;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAclC;;OAEG;YACW,OAAO;IAiBrB,OAAO,CAAC,QAAQ;IAahB;;;OAGG;IACG,YAAY,CAChB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAgBzB,OAAO,CAAC,OAAO;IAkBf;;;OAGG;IACG,mBAAmB,CACvB,QAAQ,EAAE,MAAM,EAChB,MAAM,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAwBzB;;;OAGG;IACG,oBAAoB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAarE;;OAEG;IACG,WAAW,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAoCpE;;;OAGG;IACG,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,QAAQ,GAChB,OAAO,CAAC,MAAM,EAAE,CAAC;CAcrB"}

package/dist/core/services/maps-registry.js

@@ -0,0 +1,232 @@
+/**
+ * Maps Registry — product/version/locale → mapId resolution
+ *
+ * Builds a lookup table from FT's GET /api/khub/maps response.
+ * All mapIds are dynamically discovered, nothing hardcoded.
+ *
+ * Key concepts:
+ * - `bundleStem`: product identifier without version (e.g., "jamf-pro-documentation")
+ *   Derived from `version_bundle_stem` metadata, or parsed from `bundle` values.
+ * - Each map is locale-specific (separate mapId per language)
+ * - `latestVersion=yes` marks the current version
+ */
+import { fetchMaps } from './ft-client.js';
+import { DEFAULT_LOCALE } from '../constants.js';
+import { getMetaValue, getMetaValues, FT_META } from '../utils/ft-metadata.js';
+import { compareVersions, extractVersionFromBundleId, stripVersionSuffix, stripCurrentSuffix, } from '../utils/bundle.js';
+// ─── Metadata helpers ───────────────────────────────────────────
+/**
+ * Derive bundleStem from metadata.
+ * Prefers `version_bundle_stem` (clean stem), otherwise parses `bundle` values.
+ */
+function deriveBundleStem(metadata) {
+    const stem = getMetaValue(metadata, FT_META.VERSION_BUNDLE_STEM);
+    if (stem !== '') {
+        return stem;
+    }
+    // Parse from bundle values: strip version suffixes and "-current"
+    const bundles = getMetaValues(metadata, FT_META.BUNDLE);
+    if (bundles.length === 0) {
+        return '';
+    }
+    // Take the shortest bundle value as it's likely the stem
+    // e.g., ['jamf-pro-documentation-11.26.0', 'jamf-pro-documentation-current']
+    // → sorted by length → 'jamf-pro-documentation-current'
+    // Then strip known suffixes
+    const sorted = [...bundles].sort((a, b) => a.length - b.length);
+    const candidate = sorted[0] ?? '';
+    return stripVersionSuffix(stripCurrentSuffix(candidate));
+}
+// ─── Registry ───────────────────────────────────────────────────
+const CACHE_KEY = 'maps-registry';
+const DEFAULT_CACHE_TTL = 24 * 60 * 60 * 1000; // 24 hours
+const GLOSSARY_BUNDLE_STEM = 'jamf-technical-glossary';
+export class MapsRegistry {
+    cache;
+    entries = [];
+    builtAt = 0;
+    buildPromise = null;
+    fetchMapsFn;
+    mapsProvider;
+    cacheTtl;
+    constructor(cache, fetchMapsFn, mapsProvider, cacheTtl) {
+        this.cache = cache;
+        this.fetchMapsFn = fetchMapsFn ?? fetchMaps;
+        this.mapsProvider = mapsProvider;
+        this.cacheTtl = cacheTtl ?? DEFAULT_CACHE_TTL;
+    }
+    /**
+     * Reset the registry so the next `ensureBuilt()` call re-fetches from
+     * the API (or cache). Use this to force invalidation when stale data
+     * is suspected.
+     */
+    reset() {
+        this.builtAt = 0;
+        this.entries = [];
+    }
+    /**
+     * Build the registry from FT API (cached).
+     * Uses in-flight deduplication to prevent thundering herd when
+     * multiple concurrent callers invoke ensureBuilt() simultaneously.
+     */
+    async ensureBuilt() {
+        if (this.builtAt > 0 && (Date.now() - this.builtAt) < this.cacheTtl) {
+            return;
+        }
+        if (this.buildPromise !== null) {
+            await this.buildPromise;
+            return;
+        }
+        this.buildPromise = this.doBuild();
+        try {
+            await this.buildPromise;
+        }
+        finally {
+            this.buildPromise = null;
+        }
+    }
+    /**
+     * Internal build logic: fetch maps from cache or API and populate entries.
+     */
+    async doBuild() {
+        const cached = await this.cache.get(CACHE_KEY);
+        if (cached !== null) {
+            this.entries = cached;
+            this.builtAt = Date.now();
+            return;
+        }
+        const maps = this.mapsProvider !== undefined
+            ? await this.mapsProvider.getMaps()
+            : await this.fetchMapsFn();
+        this.entries = maps.map(m => this.parseMap(m));
+        this.builtAt = Date.now();
+        await this.cache.set(CACHE_KEY, this.entries, this.cacheTtl);
+    }
+    parseMap(map) {
+        const { metadata } = map;
+        return {
+            mapId: map.id,
+            title: map.title,
+            bundleStem: deriveBundleStem(metadata),
+            version: getMetaValue(metadata, FT_META.VERSION),
+            locale: getMetaValue(metadata, FT_META.LOCALE),
+            isLatest: getMetaValue(metadata, FT_META.LATEST_VERSION) === 'yes',
+            bundleValues: getMetaValues(metadata, FT_META.BUNDLE),
+        };
+    }
+    /**
+     * Resolve a product + optional version + locale to a mapId.
+     * Returns null if not found.
+     */
+    async resolveMapId(bundleStem, version, locale) {
+        await this.ensureBuilt();
+        const loc = locale ?? DEFAULT_LOCALE;
+        // Normalize: strip -current suffix if present
+        const normalizedStem = stripCurrentSuffix(bundleStem);
+        // Try exact locale first, then fallback to en-US
+        const match = this.findMap(normalizedStem, version, loc)
+            ?? (loc !== DEFAULT_LOCALE
+                ? this.findMap(normalizedStem, version, DEFAULT_LOCALE)
+                : null);
+        return match?.mapId ?? null;
+    }
+    findMap(bundleStem, version, locale) {
+        const candidates = this.entries.filter(e => e.bundleStem === bundleStem && e.locale === locale);
+        if (version !== undefined && version !== '' && version !== 'current') {
+            return candidates.find(e => e.version === version);
+        }
+        // Default: latest version
+        return candidates.find(e => e.isLatest)
+            ?? candidates[0]; // fallback to any match
+    }
+    /**
+     * Resolve a legacy bundleId (e.g., "jamf-pro-documentation-11.12.0")
+     * to a mapId.
+     */
+    async resolveFromBundleId(bundleId, locale) {
+        await this.ensureBuilt();
+        const loc = locale ?? DEFAULT_LOCALE;
+        // Direct match against bundle metadata values
+        const direct = this.entries.find(e => e.locale === loc && e.bundleValues.includes(bundleId));
+        if (direct) {
+            return direct.mapId;
+        }
+        // Fallback: parse stem + version from bundleId
+        const stripped = stripCurrentSuffix(bundleId);
+        // Try to extract version: "jamf-pro-documentation-11.12.0" → version = "11.12.0"
+        const version = extractVersionFromBundleId(stripped);
+        if (version !== null) {
+            const stem = stripVersionSuffix(stripped);
+            return await this.resolveMapId(stem, version, locale);
+        }
+        // No version — treat as stem, resolve latest
+        return await this.resolveMapId(stripped, undefined, locale);
+    }
+    /**
+     * Find the glossary map for a given locale.
+     * Searches for maps with bundleStem containing "glossary".
+     */
+    async resolveGlossaryMapId(locale) {
+        await this.ensureBuilt();
+        const loc = locale ?? DEFAULT_LOCALE;
+        const match = this.entries.find(e => e.bundleStem === GLOSSARY_BUNDLE_STEM && e.locale === loc) ?? this.entries.find(e => e.bundleStem === GLOSSARY_BUNDLE_STEM && e.locale === DEFAULT_LOCALE);
+        return match?.mapId ?? null;
+    }
+    /**
+     * Get all unique products for a locale.
+     */
+    async getProducts(locale) {
+        await this.ensureBuilt();
+        const loc = locale ?? DEFAULT_LOCALE;
+        const productMap = new Map();
+        for (const entry of this.entries) {
+            if (entry.locale !== loc) {
+                continue;
+            }
+            if (entry.bundleStem === '') {
+                continue;
+            }
+            const existing = productMap.get(entry.bundleStem);
+            if (existing) {
+                if (entry.version !== '' && !existing.versions.includes(entry.version)) {
+                    existing.versions.push(entry.version);
+                }
+                // Use latest version's title
+                if (entry.isLatest) {
+                    existing.title = entry.title;
+                }
+            }
+            else {
+                productMap.set(entry.bundleStem, {
+                    bundleStem: entry.bundleStem,
+                    title: entry.title,
+                    versions: entry.version !== '' ? [entry.version] : [],
+                });
+            }
+        }
+        // Sort versions descending within each product
+        for (const product of productMap.values()) {
+            product.versions.sort((a, b) => compareVersions(b, a));
+        }
+        return [...productMap.values()];
+    }
+    /**
+     * Get available versions for a product.
+     * Filters entries directly instead of rebuilding the full product catalogue.
+     */
+    async getVersions(bundleStem, locale) {
+        await this.ensureBuilt();
+        const loc = locale ?? DEFAULT_LOCALE;
+        const versions = [];
+        for (const entry of this.entries) {
+            if (entry.bundleStem !== bundleStem || entry.locale !== loc) {
+                continue;
+            }
+            if (entry.version !== '' && !versions.includes(entry.version)) {
+                versions.push(entry.version);
+            }
+        }
+        return versions.sort((a, b) => compareVersions(b, a));
+    }
+}
+//# sourceMappingURL=maps-registry.js.map

package/dist/core/services/maps-registry.js.map

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

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

@@ -1,8 +1,8 @@
 /**
  * Metadata service for Jamf documentation
  *
- * Dynamically fetches product versions and topic categories from the API
- * with fallback to static constants.
+ * Dynamically fetches product versions and topic categories from the
+ * Fluid Topics MapsRegistry with fallback to static constants.
  */
 import { type ProductId } from '../constants.js';
 import type { ServerContext } from '../types/context.js';
@@ -28,25 +28,34 @@ export interface TocCategory {
     children: string[];
 }
 /**
- * Get all products with their latest metadata
- * Uses cache with fallback to static constants
+ * Get all products with their latest metadata.
+ * Uses MapsRegistry to discover products and versions dynamically,
+ * with fallback to static JAMF_PRODUCTS constants.
  */
 export declare function getProductsMetadata(ctx: ServerContext): Promise<ProductMetadata[]>;
 /**
- * Get the bundle ID for a specific product and version
- * Returns the latest bundle ID if version is undefined or 'current'
+ * Get the bundle ID for a specific product and version.
+ * Returns the latest bundle ID if version is undefined or 'current'.
+ *
+ * The returned value is a legacy-compatible bundleId string
+ * (e.g. 'jamf-pro-documentation-11.24.0') used for URL construction.
  */
 export declare function getBundleIdForVersion(ctx: ServerContext, productId: ProductId, version?: string): Promise<string | null>;
 /**
- * Get available versions for a product
+ * Get available versions for a product.
+ *
+ * Uses MapsRegistry.getVersions() to fetch versions for a single product
+ * instead of loading the full product catalogue via getProductsMetadata().
+ * Falls back to the static JAMF_PRODUCTS constant on failure.
  */
 export declare function getAvailableVersions(ctx: ServerContext, productId: ProductId): Promise<string[]>;
 /**
- * Get all topics, combining TOC-derived from all products and manual topics
+ * Get all topics. Returns manual topics from JAMF_TOPICS constants.
+ * The manual topics serve as the authoritative topic category list.
  */
 export declare function getTopicsMetadata(ctx: ServerContext): Promise<TopicMetadata[]>;
 /**
- * Check which products have TOC content available
+ * Check which products have documentation available via MapsRegistry.
  */
 export declare function getProductAvailability(ctx: ServerContext): Promise<Record<string, boolean>>;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/core/services/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,EAIL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuID;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAiDxF;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAuBxB;AAED;;GAEG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAInB;AAwHD;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAgDpF;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAgCjG;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAgBD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAeD"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/core/services/metadata.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAGL,KAAK,SAAS,EACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAMzD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,KAAK,GAAG,QAAQ,CAAC;IACzB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AA8DD;;;;GAIG;AACH,wBAAsB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CA4CxF;AAED;;;;;;GAMG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CA0BxB;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,aAAa,EAClB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC,CAiBnB;AAMD;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAuBpF;AAMD;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,aAAa,GACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAkClC;AAMD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IACzE,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE;QACR,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,QAAQ,EAAE,MAAM,CAAC;KAClB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAgBD;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC;IACvE,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE;QACN,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,EAAE,CAAC;IACJ,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAeD"}