# adobe-experience-league/exlm-converter architecture

> Architecture diagram of the GitHub repository adobe-experience-league/exlm-converter, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/adobe-experience-league/exlm-converter
- Repository: https://github.com/adobe-experience-league/exlm-converter

## Overview

EXLM is a collection of Adobe I/O Web Actions. Its main workflow serves Edge Delivery BYOM requests: the converter dispatches paths to content-specific renderers, obtains or transforms content, and returns HTML. Other documented capabilities provide Gainsight community profile proxying and Coveo search tokens; the tree also contains file, publish, and redirect actions. The graph reflects documented routing and indexed references; unsampled renderers and integrations are represented only where the README or source index supports them.

Main entry points: [`src/converter/index.js`](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/index.js) (Converter router), [`src/gainsight/index.js`](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/index.js) (Gainsight action), [`docs-redirects/index.js`](https://github.com/adobe-experience-league/exlm-converter/blob/develop/docs-redirects/index.js) (Redirect action), [`src/converter/renderers/render-doc.js`](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-doc.js) (Docs renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_content["Content conversion"]
  node_converter["Converter router<br/>[index.js]"]
  node_pathmatch["Path matching"]
  node_docs["Docs renderer<br/>[render-doc.js]"]
  node_aem["AEM renderer<br/>[render-aem.js]"]
  node_landing["Landing renderer<br/>[render-landing.js]"]
  node_playlist["Playlist renderer<br/>[render-playlist.js]"]
  node_toc["TOC renderer<br/>[render-toc.js]"]
  node_slide["Slide renderer<br/>[render-slide.js]"]
  node_events["Event renderer"]
  node_fragment["Fragment renderer<br/>[render-fragment.js]"]
  node_iofile["I/O file renderer<br/>[render-io-file.js]"]
  node_dom["HTML transforms<br/>[dom-utils.js]"]
  node_schema["Schema injection<br/>[schema-org-util.js]"]
end

subgraph group_integrations["External integrations"]
  node_exlclient["Delivery API client<br/>[ExlClientV2.js]"]
  node_gainsight["Gainsight action<br/>[index.js]"]
  node_ims["IMS validation<br/>[IMSService.js]"]
  node_oauth["Gainsight OAuth"]
  node_proxy["Community proxy<br/>[GainsightProxy.js]"]
  node_coveo["Coveo token action<br/>[index.js]"]
  node_vault["Vault access<br/>[vault-service.js]"]
end

subgraph group_actions["Other actions"]
  node_fileaction["Files action<br/>[index.js]"]
  node_publish["Publish action<br/>[index.js]"]
  node_redirects["Redirect mapping"]
  node_regexredirects["Regex redirects<br/>[regex-redirects.js]"]
  node_redirectparser["Nginx parser<br/>[nginx-parser.js]"]
  node_redirectaction["Redirect action<br/>[index.js]"]
end

subgraph group_shared["Shared utilities"]
  node_fileutils["File utilities<br/>[file-utils.js]"]
  node_localfiles["Local files<br/>[local-files.js]"]
  node_links["Link utilities<br/>[link-utils.js]"]
  node_response["Response utilities<br/>[response-utils.js]"]
end

node_eds(("Edge Delivery"))
node_gainsightapi(("Gainsight API"))
node_imsapi(("IMS"))
node_vaultapi[("HashiCorp Vault")]

node_eds -->|"requests HTML"| node_converter
node_converter -->|"classifies paths"| node_pathmatch
node_converter -->|"routes docs"| node_docs
node_converter -->|"routes fallback"| node_aem
node_converter -->|"routes landing"| node_landing
node_converter -->|"routes playlists"| node_playlist
node_converter -->|"routes TOCs"| node_toc
node_converter -->|"routes slides"| node_slide
node_converter -->|"routes events"| node_events
node_converter -->|"routes fragments"| node_fragment
node_converter -->|"routes files"| node_iofile
node_converter -->|"injects schema"| node_schema
node_docs -->|"fetches content"| node_exlclient
node_docs -->|"transforms HTML"| node_dom
node_aem -->|"transforms HTML"| node_dom
node_fragment -->|"converts fragments"| node_dom
node_gainsight -->|"validates token"| node_ims
node_gainsight -->|"gets credentials"| node_oauth
node_gainsight -->|"proxies request"| node_proxy
node_ims -->|"checks token"| node_imsapi
node_oauth -->|"requests token"| node_gainsightapi
node_proxy -->|"proxies API call"| node_gainsightapi
node_coveo -->|"reads secrets"| node_vault
node_vault -->|"authenticates and reads"| node_vaultapi
node_fileaction -->|"uses utilities"| node_fileutils
node_fileaction -->|"formats responses"| node_response
node_publish -->|"publishes content"| node_fileutils
node_redirectaction -->|"parses redirects"| node_redirectparser
node_redirectaction -->|"uses mapping"| node_redirects
node_redirectaction -->|"uses patterns"| node_regexredirects
node_fileutils -->|"delegates file access"| node_localfiles

click node_converter "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/index.js"
click node_pathmatch "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/utils/path-match-utils.js"
click node_docs "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-doc.js"
click node_aem "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-aem.js"
click node_landing "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-landing.js"
click node_playlist "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-playlist.js"
click node_toc "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-toc.js"
click node_slide "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-slide.js"
click node_events "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-on-demand-events.js"
click node_fragment "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-fragment.js"
click node_iofile "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-io-file.js"
click node_exlclient "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/ExlClientV2.js"
click node_dom "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/utils/dom-utils.js"
click node_schema "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/schemas/schema-org-util.js"
click node_gainsight "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/index.js"
click node_ims "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/IMSService.js"
click node_oauth "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/GainsightOAuth2Service.js"
click node_proxy "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/GainsightProxy.js"
click node_coveo "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/coveo/index.js"
click node_vault "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/coveo/vault-service.js"
click node_fileaction "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/files/index.js"
click node_publish "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/publish/index.js"
click node_redirects "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/redirects/one-to-one-redirects.js"
click node_regexredirects "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/redirects/regex-redirects.js"
click node_redirectparser "https://github.com/adobe-experience-league/exlm-converter/blob/develop/docs-redirects/nginx-parser.js"
click node_redirectaction "https://github.com/adobe-experience-league/exlm-converter/blob/develop/docs-redirects/index.js"
click node_fileutils "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/file-utils.js"
click node_localfiles "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/local-files.js"
click node_links "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/link-utils.js"
click node_response "https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/response-utils.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_converter,node_pathmatch,node_docs,node_aem,node_landing,node_playlist,node_toc,node_slide,node_events,node_fragment,node_iofile,node_dom,node_schema toneBlue
class node_exlclient,node_gainsight,node_ims,node_oauth,node_proxy,node_coveo,node_vault,node_vaultapi toneAmber
class node_fileaction,node_publish,node_redirects,node_regexredirects,node_redirectparser,node_redirectaction,node_gainsightapi toneMint
class node_fileutils,node_localfiles,node_links,node_response toneRose
class node_eds,node_imsapi toneIndigo
```

## Components

### Content conversion

- [Converter router](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/index.js): `src/converter/index.js`
- [Path matching](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/utils/path-match-utils.js): `src/converter/modules/utils/path-match-utils.js`
- [Docs renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-doc.js): `src/converter/renderers/render-doc.js`
- [AEM renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-aem.js): `src/converter/renderers/render-aem.js`
- [Landing renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-landing.js): `src/converter/renderers/render-landing.js`
- [Playlist renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-playlist.js): `src/converter/renderers/render-playlist.js`
- [TOC renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-toc.js): `src/converter/renderers/render-toc.js`
- [Slide renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-slide.js): `src/converter/renderers/render-slide.js`
- [Event renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-on-demand-events.js): `src/converter/renderers/render-on-demand-events.js`
- [Fragment renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-fragment.js): `src/converter/renderers/render-fragment.js`
- [I/O file renderer](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/renderers/render-io-file.js): `src/converter/renderers/render-io-file.js`
- [HTML transforms](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/utils/dom-utils.js): `src/converter/modules/utils/dom-utils.js`
- [Schema injection](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/schemas/schema-org-util.js): `src/converter/modules/schemas/schema-org-util.js`

### External integrations

- [Delivery API client](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/converter/modules/ExlClientV2.js): `src/converter/modules/ExlClientV2.js`
- [Gainsight action](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/index.js): `src/gainsight/index.js`
- [IMS validation](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/IMSService.js): `src/gainsight/utils/IMSService.js`
- [Gainsight OAuth](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/GainsightOAuth2Service.js): `src/gainsight/utils/GainsightOAuth2Service.js`
- [Community proxy](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/gainsight/utils/GainsightProxy.js): `src/gainsight/utils/GainsightProxy.js`
- [Coveo token action](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/coveo/index.js): `src/coveo/index.js`
- [Vault access](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/coveo/vault-service.js): `src/coveo/vault-service.js`

### Other actions

- [Files action](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/files/index.js): `src/files/index.js`
- [Publish action](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/publish/index.js): `src/publish/index.js`
- [Redirect mapping](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/redirects/one-to-one-redirects.js): `src/common/utils/redirects/one-to-one-redirects.js`
- [Regex redirects](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/redirects/regex-redirects.js): `src/common/utils/redirects/regex-redirects.js`
- [Nginx parser](https://github.com/adobe-experience-league/exlm-converter/blob/develop/docs-redirects/nginx-parser.js): `docs-redirects/nginx-parser.js`
- [Redirect action](https://github.com/adobe-experience-league/exlm-converter/blob/develop/docs-redirects/index.js): `docs-redirects/index.js`

### Shared utilities

- [File utilities](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/file-utils.js): `src/common/utils/file-utils.js`
- [Local files](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/local-files.js): `src/common/utils/local-files.js`
- [Link utilities](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/link-utils.js): `src/common/utils/link-utils.js`
- [Response utilities](https://github.com/adobe-experience-league/exlm-converter/blob/develop/src/common/utils/response-utils.js): `src/common/utils/response-utils.js`

### Other components

- **Edge Delivery**
- **Gainsight API**
- **IMS**
- **HashiCorp Vault**

## Connections

- Edge Delivery → Converter router: requests HTML (evidence: `README.md`)
- Converter router → Path matching: classifies paths (evidence: `src/converter/index.js`)
- Converter router → Docs renderer: routes docs (evidence: `src/converter/index.js`)
- Converter router → AEM renderer: routes fallback (evidence: `src/converter/index.js`)
- Converter router → Landing renderer: routes landing (evidence: `src/converter/index.js`)
- Converter router → Playlist renderer: routes playlists (evidence: `src/converter/index.js`)
- Converter router → TOC renderer: routes TOCs (evidence: `src/converter/index.js`)
- Converter router → Slide renderer: routes slides (evidence: `src/converter/index.js`)
- Converter router → Event renderer: routes events (evidence: `src/converter/index.js`)
- Converter router → Fragment renderer: routes fragments (evidence: `src/converter/index.js`)
- Converter router → I/O file renderer: routes files (evidence: `src/converter/index.js`)
- Converter router → Schema injection: injects schema (evidence: `src/converter/index.js`)
- Docs renderer → Delivery API client: fetches content (evidence: `src/converter/renderers/render-doc.js`)
- Docs renderer → HTML transforms: transforms HTML (evidence: `src/converter/renderers/render-doc.js`)
- AEM renderer → HTML transforms: transforms HTML (evidence: `src/converter/renderers/render-aem.js`)
- Fragment renderer → HTML transforms: converts fragments (evidence: `src/converter/renderers/render-fragment.js`)
- Gainsight action → IMS validation: validates token (evidence: `src/gainsight/index.js`)
- Gainsight action → Gainsight OAuth: gets credentials (evidence: `src/gainsight/index.js`)
- Gainsight action → Community proxy: proxies request (evidence: `src/gainsight/index.js`)
- IMS validation → IMS: checks token (evidence: `src/gainsight/utils/IMSService.js`)
- Gainsight OAuth → Gainsight API: requests token (evidence: `src/gainsight/utils/GainsightOAuth2Service.js`)
- Community proxy → Gainsight API: proxies API call (evidence: `src/gainsight/utils/GainsightProxy.js`)
- Coveo token action → Vault access: reads secrets (evidence: `src/coveo/index.js`)
- Vault access → HashiCorp Vault: authenticates and reads (evidence: `src/coveo/vault-service.js`)
- Files action → File utilities: uses utilities (evidence: `src/files/index.js`)
- Files action → Response utilities: formats responses (evidence: `src/files/index.js`)
- Publish action → File utilities: publishes content (evidence: `src/publish/index.js`)
- Redirect action → Nginx parser: parses redirects (evidence: `docs-redirects/index.js`)
- Redirect action → Redirect mapping: uses mapping
- Redirect action → Regex redirects: uses patterns
- File utilities → Local files: delegates file access (evidence: `src/common/utils/file-utils.js`)
