@memberjunction/doc-utils 3.4.0 → 4.1.0

package/README.md

@@ -1,10 +1,171 @@
-# MemberJunction Documentation Utilities
+# @memberjunction/doc-utils
 
-A TypeScript library for dynamically retrieving, parsing, and caching MemberJunction library documentation from the official documentation website to support AI models and other documentation-driven features.
+A TypeScript library for dynamically retrieving, parsing, and caching MemberJunction library documentation from the official documentation website. Designed to support AI models, code generation tools, and other documentation-driven features that need structured access to MJ library metadata.
 
 ## Overview
 
-The `@memberjunction/doc-utils` package provides functionality for accessing the official MemberJunction documentation. It fetches documentation from the MemberJunction documentation site (https://memberjunction.github.io/MJ/), parses the HTML content, and caches library documentation in memory for improved performance. This library is particularly useful when integrating with AI models that need context about the MemberJunction system's libraries and their components.
+The `@memberjunction/doc-utils` package provides a singleton `DocumentationEngine` that loads library and library item metadata from the MemberJunction entity system, then fetches the corresponding HTML documentation pages from the official MJ documentation site ([https://memberjunction.github.io/MJ/](https://memberjunction.github.io/MJ/)). Parsed content is cached in memory for efficient repeated access.
+
+This package is particularly useful for:
+
+- Feeding structured library documentation to AI models for context-aware code generation
+- Building developer tools that reference MJ API documentation
+- Providing searchable documentation indexes for MJ packages and their exported items
+
+## Architecture
+
+```mermaid
+graph TB
+    subgraph DocUtils["DocUtils Package"]
+        DE["DocumentationEngine<br/>(Singleton)"]
+        LEE["LibraryEntityExtended"]
+        LIEE["LibraryItemEntityExtended"]
+    end
+
+    subgraph MJCore["@memberjunction/core"]
+        BE["BaseEngine"]
+        BEnt["BaseEntity"]
+    end
+
+    subgraph CoreEntities["@memberjunction/core-entities"]
+        LE["LibraryEntity"]
+        LIE["LibraryItemEntity"]
+    end
+
+    subgraph External["External Services"]
+        DB[("MJ Database<br/>Libraries &<br/>Library Items")]
+        DOCS["MJ Docs Site<br/>memberjunction.github.io"]
+    end
+
+    DE -->|extends| BE
+    LEE -->|extends| LE
+    LIEE -->|extends| LIE
+    LE -->|extends| BEnt
+    LIE -->|extends| BEnt
+
+    DE -->|loads metadata| DB
+    DE -->|fetches HTML| DOCS
+    DE -->|manages| LEE
+    DE -->|manages| LIEE
+    LEE -->|contains| LIEE
+
+    style DE fill:#2d6a9f,stroke:#1a4971,color:#fff
+    style LEE fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style LIEE fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style BE fill:#7c5295,stroke:#563a6b,color:#fff
+    style BEnt fill:#7c5295,stroke:#563a6b,color:#fff
+    style LE fill:#7c5295,stroke:#563a6b,color:#fff
+    style LIE fill:#7c5295,stroke:#563a6b,color:#fff
+    style DB fill:#b8762f,stroke:#8a5722,color:#fff
+    style DOCS fill:#b8762f,stroke:#8a5722,color:#fff
+```
+
+## Data Flow
+
+The engine follows a two-phase loading process: first it loads entity metadata from the database, then it fetches and parses HTML documentation for each library item.
+
+```mermaid
+sequenceDiagram
+    participant App as Application
+    participant DE as DocumentationEngine
+    participant DB as MJ Database
+    participant Site as Docs Website
+
+    App->>DE: Config(forceRefresh, contextUser)
+    DE->>DB: Load Libraries (entity metadata)
+    DB-->>DE: LibraryEntityExtended[]
+    DE->>DB: Load Library Items (entity metadata)
+    DB-->>DE: LibraryItemEntityExtended[]
+
+    Note over DE: AdditionalLoading phase
+
+    loop For each Library
+        loop For each Item in Library
+            DE->>DE: Build URL from library name + item type
+            DE->>Site: GET /{type}/{sanitized_name}.{ItemName}.html
+            Site-->>DE: HTML response
+            DE->>DE: Parse HTML via JSDOM (extract div.col-content)
+            DE->>DE: Cache HTMLContent and URL on item
+        end
+    end
+
+    DE-->>App: Config complete, data cached
+    App->>DE: Access Libraries / LibraryItems
+    DE-->>App: Cached entity data with HTML content
+```
+
+## Class Hierarchy
+
+```mermaid
+classDiagram
+    class BaseEngine {
+        <<abstract>>
+        +Load(configs, provider, forceRefresh, contextUser)
+        #AdditionalLoading(contextUser)*
+    }
+
+    class DocumentationEngine {
+        +Instance$ DocumentationEngine
+        +Libraries LibraryEntityExtended[]
+        +LibraryItems LibraryItemEntityExtended[]
+        +Config(forceRefresh, contextUser, provider)
+        #AdditionalLoading(contextUser)
+        #GetContent(url, rootSelector) string
+        #fetchDocumentation(url) string
+        #parseDocumentation(html, rootSelector) string
+    }
+
+    class BaseEntity {
+        <<abstract>>
+        +Get(fieldName)
+        +Set(fieldName, value)
+        +Save()
+    }
+
+    class LibraryEntity {
+        +ID string
+        +Name string
+        +Description string?
+        +Status "Active" | "Disabled" | "Pending"
+        +TypeDefinitions string?
+        +SampleCode string?
+    }
+
+    class LibraryEntityExtended {
+        +Items LibraryItemEntityExtended[]
+    }
+
+    class LibraryItemEntity {
+        +ID string
+        +Name string
+        +LibraryID string
+        +Type "Class"|"Function"|"Interface"|"Module"|"Type"|"Variable"
+        +Library string
+    }
+
+    class LibraryItemEntityExtended {
+        +URL string
+        +HTMLContent string
+        +TypeURLSegment string
+    }
+
+    BaseEngine <|-- DocumentationEngine
+    BaseEntity <|-- LibraryEntity
+    BaseEntity <|-- LibraryItemEntity
+    LibraryEntity <|-- LibraryEntityExtended
+    LibraryItemEntity <|-- LibraryItemEntityExtended
+    DocumentationEngine o-- LibraryEntityExtended
+    DocumentationEngine o-- LibraryItemEntityExtended
+    LibraryEntityExtended o-- LibraryItemEntityExtended
+
+    style DocumentationEngine fill:#2d6a9f,stroke:#1a4971,color:#fff
+    style LibraryEntityExtended fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style LibraryItemEntityExtended fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style BaseEngine fill:#7c5295,stroke:#563a6b,color:#fff
+    style BaseEntity fill:#7c5295,stroke:#563a6b,color:#fff
+    style LibraryEntity fill:#7c5295,stroke:#563a6b,color:#fff
+    style LibraryItemEntity fill:#7c5295,stroke:#563a6b,color:#fff
+```
 
 ## Installation
 
@@ -14,27 +175,26 @@ npm install @memberjunction/doc-utils
 
 ## Dependencies
 
-This package depends on the following MemberJunction packages:
-- `@memberjunction/core` - Core functionality and base classes
-- `@memberjunction/core-entities` - Entity definitions
-- `@memberjunction/global` - Global utilities and decorators
+**MemberJunction packages:**
 
-External dependencies:
-- `jsdom` - For HTML parsing
-- `axios` - For HTTP requests
+| Package | Purpose |
+|---------|---------|
+| `@memberjunction/core` | Base engine class, metadata provider, user context |
+| `@memberjunction/core-entities` | `LibraryEntity` and `LibraryItemEntity` base classes |
+| `@memberjunction/global` | `@RegisterClass` decorator for entity registration |
 
-## Main Features
+**External packages:**
 
-- **Library Documentation Retrieval**: Dynamically fetch documentation for MemberJunction libraries and their items
-- **HTML Content Parsing**: Extract relevant content from HTML documentation pages
-- **Automatic URL Generation**: Constructs documentation URLs based on library and item metadata
-- **Extended Entity Classes**: Provides extended functionality for Library and Library Item entities
-- **Singleton Pattern**: Easy access to documentation functionality throughout your application
-- **Type-aware URL Routing**: Automatically routes to correct documentation sections based on item type (Class, Interface, Function, etc.)
+| Package | Purpose |
+|---------|---------|
+| `axios` | HTTP requests to the documentation website |
+| `jsdom` | HTML parsing and DOM manipulation for content extraction |
 
 ## Usage
 
-### Basic Example
+### Initializing the Engine
+
+The `DocumentationEngine` uses the singleton pattern. Call `Config()` once to load metadata and documentation content before accessing data.
 
 ```typescript
 import { DocumentationEngine } from '@memberjunction/doc-utils';
@@ -43,148 +203,189 @@ import { UserInfo } from '@memberjunction/core';
 // Get the singleton instance
 const docEngine = DocumentationEngine.Instance;
 
-// Configure the engine (required before using)
-const user = new UserInfo(); // Or get from your authentication context
-await docEngine.Config(false, user);
+// Server-side: pass contextUser for proper data isolation
+const contextUser: UserInfo = /* from your authentication context */;
+await docEngine.Config(false, contextUser);
 
-// Access libraries and their documentation
-const libraries = docEngine.Libraries;
-console.log(`Found ${libraries.length} libraries`);
-
-// Access specific library items
-const coreLibrary = libraries.find(lib => lib.Name === '@memberjunction/core');
-if (coreLibrary) {
-    console.log(`Library: ${coreLibrary.Name}`);
-    console.log(`Items: ${coreLibrary.Items.length}`);
-    
-    // Access documentation for specific items
-    coreLibrary.Items.forEach(item => {
-        console.log(`${item.Type}: ${item.Name}`);
-        console.log(`URL: ${item.URL}`);
-        console.log(`Content Preview: ${item.HTMLContent.substring(0, 200)}...`);
-    });
-}
+// Client-side: contextUser is optional
+await docEngine.Config();
 ```
 
-### Working with Library Items
+### Accessing Libraries and Items
+
+After configuration, libraries and their items are available through cached properties.
 
 ```typescript
-import { DocumentationEngine } from '@memberjunction/doc-utils';
+const docEngine = DocumentationEngine.Instance;
 
-async function displayLibraryItemInfo(libraryName: string, itemName: string) {
-    const docEngine = DocumentationEngine.Instance;
-    await docEngine.Config();
-    
-    // Find all library items
-    const libraryItems = docEngine.LibraryItems;
-    
-    // Find specific item
-    const item = libraryItems.find(i => 
-        i.Library === libraryName && i.Name === itemName
-    );
-    
-    if (item) {
-        console.log(`Item: ${item.Name}`);
-        console.log(`Type: ${item.Type}`);
-        console.log(`Library: ${item.Library}`);
-        console.log(`Documentation URL: ${item.URL}`);
-        console.log(`HTML Content Available: ${item.HTMLContent ? 'Yes' : 'No'}`);
+// Get all libraries
+const libraries = docEngine.Libraries;
+console.log(`Loaded ${libraries.length} libraries`);
+
+// Find a specific library
+const coreLib = libraries.find(lib => lib.Name === '@memberjunction/core');
+if (coreLib) {
+    console.log(`${coreLib.Name} (${coreLib.Status})`);
+    console.log(`Items: ${coreLib.Items.length}`);
+
+    // Iterate through items in the library
+    for (const item of coreLib.Items) {
+        console.log(`  ${item.Type}: ${item.Name}`);
+        console.log(`  URL: ${item.URL}`);
+        console.log(`  Content length: ${item.HTMLContent.length} chars`);
     }
 }
-
-// Example usage
-await displayLibraryItemInfo('@memberjunction/core', 'BaseEntity');
 ```
 
-### Force Refresh Documentation
+### Accessing All Library Items
+
+The flat `LibraryItems` array provides access to all items across all libraries.
 
 ```typescript
-import { DocumentationEngine } from '@memberjunction/doc-utils';
+const docEngine = DocumentationEngine.Instance;
+
+// Get all library items regardless of library
+const allItems = docEngine.LibraryItems;
+
+// Filter by type
+const allClasses = allItems.filter(item => item.Type === 'Class');
+const allInterfaces = allItems.filter(item => item.Type === 'Interface');
+
+// Find a specific item by name and library
+const baseEntity = allItems.find(
+    item => item.Name === 'BaseEntity' && item.Library === '@memberjunction/core'
+);
 
-// Force refresh to reload documentation from the database and website
+if (baseEntity) {
+    console.log(`Documentation URL: ${baseEntity.URL}`);
+    console.log(`HTML Content: ${baseEntity.HTMLContent}`);
+}
+```
+
+### Force Refreshing Documentation
+
+Pass `true` to `Config()` to reload all metadata from the database and re-fetch documentation content.
+
+```typescript
 const docEngine = DocumentationEngine.Instance;
-await docEngine.Config(true); // true forces a refresh
+
+// Force a complete reload
+await docEngine.Config(true);
 ```
 
 ## API Reference
 
 ### DocumentationEngine
 
-The main class that provides access to documentation functionality. Extends `BaseEngine` from `@memberjunction/core`.
+The primary class providing access to MJ library documentation. Extends `BaseEngine` and uses the singleton pattern.
 
-#### Properties
+| Member | Type | Description |
+|--------|------|-------------|
+| `Instance` (static) | `DocumentationEngine` | Returns the singleton instance |
+| `Libraries` | `LibraryEntityExtended[]` | All loaded libraries with their items |
+| `LibraryItems` | `LibraryItemEntityExtended[]` | Flat list of all library items across all libraries |
+| `Config(forceRefresh?, contextUser?, provider?)` | `Promise<void>` | Initializes the engine: loads metadata, fetches and parses documentation |
 
-- `Instance` (static): Returns the singleton instance of DocumentationEngine
-- `Libraries`: Array of `LibraryEntityExtended` objects containing all loaded libraries
-- `LibraryItems`: Array of `LibraryItemEntityExtended` objects containing all library items
+### LibraryEntityExtended
 
-#### Methods
+Extended entity class for libraries. Registered via `@RegisterClass(BaseEntity, "Libraries")`.
 
-- `Config(forceRefresh?: boolean, contextUser?: UserInfo, provider?: IMetadataProvider): Promise<void>`
-  - Configures the documentation engine and loads metadata
-  - Parameters:
-    - `forceRefresh`: If true, forces reload of metadata from database
-    - `contextUser`: User context for server-side execution
-    - `provider`: Optional metadata provider
+| Member | Type | Description |
+|--------|------|-------------|
+| `ID` | `string` | Unique identifier |
+| `Name` | `string` | Library package name (e.g., `@memberjunction/core`) |
+| `Description` | `string \| null` | Human-readable description |
+| `Status` | `'Active' \| 'Disabled' \| 'Pending'` | Library availability status |
+| `TypeDefinitions` | `string \| null` | Type/function definitions for reference by humans and AI |
+| `SampleCode` | `string \| null` | Usage examples for the library |
+| `Items` | `LibraryItemEntityExtended[]` | All items belonging to this library |
 
-### LibraryEntityExtended
+### LibraryItemEntityExtended
 
-Extended entity class for libraries with documentation capabilities.
+Extended entity class for individual library items (classes, interfaces, functions, etc.). Registered via `@RegisterClass(BaseEntity, "Library Items")`.
 
-#### Properties
+| Member | Type | Description |
+|--------|------|-------------|
+| `ID` | `string` | Unique identifier |
+| `Name` | `string` | Item name (e.g., `BaseEntity`, `RunView`) |
+| `LibraryID` | `string` | Foreign key to the parent library |
+| `Library` | `string` | Denormalized library name from the view |
+| `Type` | `'Class' \| 'Function' \| 'Interface' \| 'Module' \| 'Type' \| 'Variable'` | The kind of exported item |
+| `URL` | `string` | Generated documentation URL for this item |
+| `HTMLContent` | `string` | Parsed HTML content from the documentation page |
+| `TypeURLSegment` | `string` (getter) | URL path segment derived from `Type` (e.g., `classes`, `interfaces`) |
 
-- All properties from `LibraryEntity`
-- `Items`: Array of `LibraryItemEntityExtended` objects belonging to this library
+### URL Generation
 
-### LibraryItemEntityExtended
+Documentation URLs are constructed automatically using the pattern:
 
-Extended entity class for library items with documentation capabilities.
-
-#### Properties
+```
+https://memberjunction.github.io/MJ/{typeSegment}/{sanitizedLibraryName}.{ItemName}.html
+```
 
-- All properties from `LibraryItemEntity`
-- `URL`: The generated documentation URL for this item
-- `HTMLContent`: The parsed HTML content from the documentation
-- `TypeURLSegment`: Returns the URL segment based on item type (classes, interfaces, functions, etc.)
+Where:
+- `{typeSegment}` is the pluralized, lowercase item type (`classes`, `interfaces`, `functions`, `modules`, `types`, `variables`)
+- `{sanitizedLibraryName}` is the library name with `@`, `.`, `/`, and `\` characters replaced by `_`
+- `{ItemName}` is the exact name of the exported item
 
-#### Supported Item Types
+For example, `BaseEntity` (a Class) in `@memberjunction/core` resolves to:
+```
+https://memberjunction.github.io/MJ/classes/_memberjunction_core.BaseEntity.html
+```
 
-- Class → `/classes/`
-- Interface → `/interfaces/`
-- Function → `/functions/`
-- Module → `/modules/`
-- Type → `/types/`
-- Variable → `/variables/`
+## URL Routing by Item Type
+
+```mermaid
+graph LR
+    Item["Library Item"]
+
+    Item -->|Class| C["/classes/"]
+    Item -->|Interface| I["/interfaces/"]
+    Item -->|Function| F["/functions/"]
+    Item -->|Module| M["/modules/"]
+    Item -->|Type| T["/types/"]
+    Item -->|Variable| V["/variables/"]
+
+    style Item fill:#2d6a9f,stroke:#1a4971,color:#fff
+    style C fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style I fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style F fill:#2d8659,stroke:#1a5c3a,color:#fff
+    style M fill:#b8762f,stroke:#8a5722,color:#fff
+    style T fill:#b8762f,stroke:#8a5722,color:#fff
+    style V fill:#b8762f,stroke:#8a5722,color:#fff
+```
 
 ## Integration with MemberJunction
 
-This package integrates seamlessly with the MemberJunction ecosystem:
+This package integrates with the broader MemberJunction ecosystem through several mechanisms:
 
-1. **Entity System**: Uses MemberJunction's entity system for Library and Library Items metadata
-2. **Base Engine Pattern**: Extends BaseEngine for consistent configuration and loading patterns
-3. **Global Registration**: Uses `@RegisterClass` decorator for proper entity registration
-4. **User Context**: Supports MemberJunction's user context for server-side execution
+- **Entity System**: Uses `@RegisterClass` to register `LibraryEntityExtended` and `LibraryItemEntityExtended` as entity subclasses, ensuring the MJ class factory returns the extended types when loading Libraries and Library Items.
+- **BaseEngine Pattern**: Extends `BaseEngine` with the `Config()` / `AdditionalLoading()` lifecycle, allowing consistent initialization and caching across all MJ engine classes.
+- **User Context**: Supports `contextUser` for proper data isolation and security when running on the server side.
+- **Metadata Provider**: Accepts an optional `IMetadataProvider` for environments with custom metadata access patterns.
 
-## Build and Development
+## Build
 
 ```bash
 # Build the package
+cd packages/DocUtils
 npm run build
 
-# Run in development mode with hot reload
+# Development mode with file watching
 npm start
-
-# Run tests (when implemented)
-npm test
 ```
 
-## Notes
+## Source Files
 
-- The documentation engine fetches content from https://memberjunction.github.io/MJ/
-- Documentation is cached in memory after initial load for performance
-- The engine automatically constructs URLs based on library names and item types
-- Library names with special characters (@, ., /, \) are sanitized for URL compatibility
+| File | Description |
+|------|-------------|
+| `src/index.ts` | Public API surface -- re-exports from `Engine.ts` |
+| `src/Engine.ts` | Core implementation: `DocumentationEngine`, `LibraryEntityExtended`, `LibraryItemEntityExtended` |
 
-## License
+## Notes
 
-ISC
+- Documentation is fetched from [https://memberjunction.github.io/MJ/](https://memberjunction.github.io/MJ/) using `axios` HTTP GET requests.
+- HTML content is parsed with `jsdom`, extracting the inner HTML of the `div.col-content` element from each page.
+- All fetched content is cached in memory after the initial `Config()` call. Subsequent calls to `Config()` without `forceRefresh=true` return immediately.
+- Library names containing special characters (`@`, `.`, `/`, `\`) are sanitized by replacing them with underscores for URL compatibility.
+- If a documentation page cannot be fetched (network error, 404, etc.), the `HTMLContent` for that item is set to an error or placeholder string rather than throwing an exception.

package/dist/Engine.js

@@ -1,25 +1,19 @@
-"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 __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DocumentationEngine = exports.LibraryEntityExtended = exports.LibraryItemEntityExtended = void 0;
-const axios_1 = __importDefault(require("axios"));
-const jsdom_1 = require("jsdom");
-const core_1 = require("@memberjunction/core");
-const core_entities_1 = require("@memberjunction/core-entities");
-const global_1 = require("@memberjunction/global");
+import axios from 'axios';
+import { JSDOM } from 'jsdom';
+import { BaseEngine, LogError, BaseEntity } from "@memberjunction/core";
+import { LibraryEntity, LibraryItemEntity } from "@memberjunction/core-entities";
+import { RegisterClass } from '@memberjunction/global';
 /**
  * Represents a single item within a library/package that is used to provide documentation for the MemberJunction system. For example a library would be something like
  * @memberjunction/core and an item within that library might be the BaseEntity or BaseEngine class.
  */
-let LibraryItemEntityExtended = class LibraryItemEntityExtended extends core_entities_1.LibraryItemEntity {
+let LibraryItemEntityExtended = class LibraryItemEntityExtended extends LibraryItemEntity {
     get TypeURLSegment() {
         switch (this.Type) {
             case 'Class':
@@ -39,11 +33,11 @@ let LibraryItemEntityExtended = class LibraryItemEntityExtended extends core_ent
         }
     }
 };
-exports.LibraryItemEntityExtended = LibraryItemEntityExtended;
-exports.LibraryItemEntityExtended = LibraryItemEntityExtended = __decorate([
-    (0, global_1.RegisterClass)(core_1.BaseEntity, "Library Items")
+LibraryItemEntityExtended = __decorate([
+    RegisterClass(BaseEntity, "Library Items")
 ], LibraryItemEntityExtended);
-let LibraryEntityExtended = class LibraryEntityExtended extends core_entities_1.LibraryEntity {
+export { LibraryItemEntityExtended };
+let LibraryEntityExtended = class LibraryEntityExtended extends LibraryEntity {
     constructor() {
         super(...arguments);
         this._items = [];
@@ -52,14 +46,14 @@ let LibraryEntityExtended = class LibraryEntityExtended extends core_entities_1.
         return this._items;
     }
 };
-exports.LibraryEntityExtended = LibraryEntityExtended;
-exports.LibraryEntityExtended = LibraryEntityExtended = __decorate([
-    (0, global_1.RegisterClass)(core_1.BaseEntity, "Libraries")
+LibraryEntityExtended = __decorate([
+    RegisterClass(BaseEntity, "Libraries")
 ], LibraryEntityExtended);
+export { LibraryEntityExtended };
 /**
  * Provides utility functionality for documentation of the MemberJunction system using external website content from the MemberJunction project.
  */
-class DocumentationEngine extends core_1.BaseEngine {
+export class DocumentationEngine extends BaseEngine {
     constructor() {
         super(...arguments);
         // internal instance properties used for the singleton pattern
@@ -110,7 +104,7 @@ class DocumentationEngine extends core_1.BaseEngine {
     }
     async fetchDocumentation(url) {
         try {
-            const response = await axios_1.default.get(url);
+            const response = await axios.get(url);
             if (response.status === 200) {
                 return response.data;
             }
@@ -119,12 +113,12 @@ class DocumentationEngine extends core_1.BaseEngine {
             }
         }
         catch (e) {
-            (0, core_1.LogError)(e);
+            LogError(e);
             return "Error fetching content";
         }
     }
     parseDocumentation(html, rootSelector) {
-        const dom = new jsdom_1.JSDOM(html);
+        const dom = new JSDOM(html);
         const document = dom.window.document;
         const content = document.querySelector('div.col-content')?.innerHTML;
         return content || 'No relevant content found';
@@ -142,5 +136,4 @@ class DocumentationEngine extends core_1.BaseEngine {
         return this._LibraryItems;
     }
 }
-exports.DocumentationEngine = DocumentationEngine;
 //# sourceMappingURL=Engine.js.map

package/dist/Engine.js.map

@@ -1 +1 @@
-{"version":3,"file":"Engine.js","sourceRoot":"","sources":["../src/Engine.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,kDAA0B;AAC1B,iCAA8B;AAE9B,+CAA+H;AAC/H,iEAAiF;AACjF,mDAAuD;AAGvD;;;GAGG;AAEI,IAAM,yBAAyB,GAA/B,MAAM,yBAA0B,SAAQ,iCAAiB;IAI5D,IAAW,cAAc;QACrB,QAAO,IAAI,CAAC,IAAI,EAAC,CAAC;YACd,KAAK,OAAO;gBACR,OAAO,SAAS,CAAA;YACpB,KAAK,WAAW;gBACZ,OAAO,YAAY,CAAC;YACxB,KAAK,UAAU;gBACX,OAAO,WAAW,CAAC;YACvB,KAAK,QAAQ;gBACT,OAAO,SAAS,CAAC;YACrB,KAAK,MAAM;gBACP,OAAO,OAAO,CAAC;YACnB,KAAK,UAAU;gBACX,OAAO,WAAW,CAAC;YACvB;gBACI,MAAM,IAAI,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;CACJ,CAAA;AAtBY,8DAAyB;oCAAzB,yBAAyB;IADrC,IAAA,sBAAa,EAAC,iBAAU,EAAE,eAAe,CAAC;GAC9B,yBAAyB,CAsBrC;AAGM,IAAM,qBAAqB,GAA3B,MAAM,qBAAsB,SAAQ,6BAAa;IAAjD;;QACK,WAAM,GAAgC,EAAE,CAAC;IAIrD,CAAC;IAHG,IAAW,KAAK;QACZ,OAAO,IAAI,CAAC,MAAM,CAAC;IACvB,CAAC;CACJ,CAAA;AALY,sDAAqB;gCAArB,qBAAqB;IADjC,IAAA,sBAAa,EAAC,iBAAU,EAAE,WAAW,CAAC;GAC1B,qBAAqB,CAKjC;AAED;;GAEG;AACH,MAAa,mBAAoB,SAAQ,iBAA+B;IAAxE;;QAMI,8DAA8D;QACtD,eAAU,GAA4B,EAAE,CAAC;QACzC,kBAAa,GAAgC,EAAE,CAAC;QAwBhD,aAAQ,GAAW,sCAAsC,CAAC;IAsDtE,CAAC;IArFU,MAAM,KAAK,QAAQ;QACtB,OAAO,KAAK,CAAC,WAAW,EAAuB,CAAC;IACpD,CAAC;IAOD;;;;;OAKG;IACI,KAAK,CAAC,MAAM,CAAC,eAAwB,KAAK,EAAE,WAAsB,EAAE,QAA4B;QACnG,MAAM,OAAO,GAAwC;YACjD;gBACI,UAAU,EAAE,WAAW;gBACvB,YAAY,EAAE,YAAY;gBAC1B,UAAU,EAAE,IAAI;aACnB;YACD;gBACI,UAAU,EAAE,eAAe;gBAC3B,YAAY,EAAE,eAAe;gBAC7B,UAAU,EAAE,IAAI;aACnB;SACJ,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC;IAClE,CAAC;IAGkB,KAAK,CAAC,iBAAiB,CAAC,WAAsB;QAC7D,2GAA2G;QAC3G,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnC,MAAM,KAAK,GAAgC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,IAA+B,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,KAAK,OAAO,CAAC,EAAE,CAAC,CAAC;YACxI,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBAEvB,sFAAsF;gBACtF,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;gBAC1D,IAAI,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,cAAc,IAAI,UAAU,IAAI,IAAI,CAAC,IAAI,OAAO,CAAC;gBACpF,IAAI,CAAC,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnD,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACL,CAAC;IACL,CAAC;IAES,KAAK,CAAC,UAAU,CAAC,GAAW,EAAE,YAAqB;QACzD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC,kBAAkB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACvD,CAAC;IACS,KAAK,CAAC,kBAAkB,CAAC,GAAW;QAC1C,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtC,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;gBAC1B,OAAO,QAAQ,CAAC,IAAI,CAAC;YACzB,CAAC;iBAAM,CAAC;gBACJ,OAAO,kBAAkB,CAAC;YAC9B,CAAC;QACL,CAAC;QACD,OAAO,CAAC,EAAE,CAAC;YACP,IAAA,eAAQ,EAAC,CAAC,CAAC,CAAA;YACX,OAAO,wBAAwB,CAAA;QACnC,CAAC;IACL,CAAC;IACU,kBAAkB,CAAC,IAAY,EAAE,YAAqB;QAC7D,MAAM,GAAG,GAAG,IAAI,aAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC;QACrC,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,iBAAiB,CAAC,EAAE,SAAS,CAAC;QACrE,OAAO,OAAO,IAAI,2BAA2B,CAAC;IAClD,CAAC;IAED;;OAEG;IACH,IAAW,SAAS;QAChB,OAAO,IAAI,CAAC,UAAU,CAAC;IAC3B,CAAC;IAEA;;MAEE;IACF,IAAW,YAAY;QACpB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC9B,CAAC;CACJ;AAtFD,kDAsFC"}
+{"version":3,"file":"Engine.js","sourceRoot":"","sources":["../src/Engine.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export * from './Engine';
+export * from './Engine.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,19 +1,3 @@
-"use strict";
 //PUBLIC API SURFACE AREA
-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("./Engine"), exports);
+export * from './Engine.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,yBAAyB;;;;;;;;;;;;;;;;AAEzB,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AAEzB,cAAc,UAAU,CAAC"}

package/package.json

@@ -1,6 +1,7 @@
 {
   "name": "@memberjunction/doc-utils",
-  "version": "3.4.0",
+  "type": "module",
+  "version": "4.1.0",
   "description": "This library provides functionality for dynamically retreiving documentation from the official MemberJunction object model documentation site, parsing it, and caching elements in memory for performance. Use this whenever you need dynamic access to the MJ documentation to feed to AI models and for any other similar purpose.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -9,43 +10,43 @@
   ],
   "scripts": {
     "start": "ts-node-dev src/index.ts",
-    "build": "tsc",
+    "build": "tsc && tsc-alias -f",
     "test": "echo \"Error: no test specified\" && exit 1"
   },
   "author": "MemberJunction.com",
   "license": "ISC",
   "devDependencies": {
     "ts-node-dev": "^2.0.0",
-    "typescript": "^5.4.5"
+    "typescript": "^5.9.3"
   },
   "dependencies": {
-    "@asamuzakjp/css-color": "^3.2.0",
-    "@memberjunction/core": "3.4.0",
-    "@memberjunction/core-entities": "3.4.0",
-    "@memberjunction/global": "3.4.0",
-    "axios": "^1.6.7",
-    "cssstyle": "^4.0.1",
-    "data-urls": "^5.0.0",
-    "decimal.js": "^10.4.3",
-    "form-data": "^4.0.0",
+    "@asamuzakjp/css-color": "^4.1.2",
+    "@memberjunction/core": "4.1.0",
+    "@memberjunction/core-entities": "4.1.0",
+    "@memberjunction/global": "4.1.0",
+    "axios": "^1.13.4",
+    "cssstyle": "^6.0.1",
+    "data-urls": "^7.0.0",
+    "decimal.js": "^10.6.0",
+    "form-data": "^4.0.5",
     "html-encoding-sniffer": "^6.0.0",
     "http-proxy-agent": "^7.0.2",
-    "https-proxy-agent": "^7.0.5",
+    "https-proxy-agent": "^7.0.6",
     "is-potential-custom-element-name": "^1.0.1",
-    "jsdom": "^27.4.0",
-    "nwsapi": "^2.2.12",
-    "parse5": "^7.1.2",
-    "psl": "^1.9.0",
-    "rrweb-cssom": "^0.7.1",
+    "jsdom": "^28.0.0",
+    "nwsapi": "^2.2.23",
+    "parse5": "^8.0.0",
+    "psl": "^1.15.0",
+    "rrweb-cssom": "^0.8.0",
     "saxes": "^6.0.0",
     "symbol-tree": "^3.2.4",
-    "tough-cookie": "^4.1.4",
+    "tough-cookie": "^6.0.0",
     "w3c-xmlserializer": "^5.0.0",
-    "webidl-conversions": "^7.0.0",
+    "webidl-conversions": "^8.0.1",
     "whatwg-encoding": "^3.1.1",
-    "whatwg-mimetype": "^4.0.0",
-    "whatwg-url": "^14.0.0",
-    "ws": "^8.18.0",
+    "whatwg-mimetype": "^5.0.0",
+    "whatwg-url": "^16.0.0",
+    "ws": "^8.19.0",
     "xml-name-validator": "^5.0.0"
   },
   "repository": {