Hacktoberfest 2026: the issues maintainers tagged for October, open and beginner-friendly. Browse Hacktoberfest issues

Support the /+esm endpoint on jsDelivr packages

Open
#798 1 comment 4 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
4/5
Estimated time
3-5 days
Newbie friendliness
42/100
Issue type
Feature
Clarity
Mostly clear
Activity status
Stale
Tech stack
csharp, javascript, rollup

Research direction

No files or tests are named. Start by locating LibMan's provider parsing and jsDelivr download handling, then review how library and file paths are resolved. Done means an agreed /+esm form can fetch package and individual-file ESM endpoints with coverage for the supported syntax.

Written by the indexing model from the issue text.

Description

Is your feature request related to a problem? Please describe.

Some libraries available through jsDelivr have no default JS file specified by the package author. Libraries packaged for NPM are often meant to be included as CJS modules, with the expectation that the developer will use a tool like webpack or Rollup.js to prepare the code to run client-side. On jsDelivr packages sometimes have this disclaimer under the "install" code snippet:

No default JS file set by the package author so the URL is guessed. You can always browse all package files to use another one.

Luckily jsDelivr provides a more reliable option - fetching the library as an ES module, as illustrated in this example:

<script type="module">
    import coreJs from 'https://cdn.jsdelivr.net/npm/core-js@3.45.0/+esm'
</script>

jsDelivr uses Rollup.js to generate the ESM version of the package and exposes the result when it sees /+esm appended to the URL. This is a very helpful feature provided by the CDN, but as far as I can tell there is currently no way to leverage this feature with LibMan.

Describe the solution you'd like

It would be a nice convenience if there was some way to tell LibMan to fetch pre-bundled libraries from jsDelivr. I think the simplest syntax for this would be:

    {
      "provider": "jsdelivr/esm",
      "library": "core-js@3.45.0",
      "destination": "wwwroot/lib/core-js/index.mjs"
    }

The file name, [library name]/index.mjs, could be inferred, though I believe that is a separate issue.

Describe alternatives you've considered

I did try "tricking" LibMan into fetching a generated ESM for me with something like this:

    {
      "provider": "jsdelivr",
      "library": "core-js@3.45.0",
      "files": [ "/+esm" ]
    }

Of course, that doesn't work because there is no literal "/+esm" file in this package. A more sensible and straightforward alternative syntax might be:

    {
      "provider": "jsdelivr",
      "library": "core-js@3.45.0/+esm"
    }
Additional context

I've found a few examples, like parse and locutus, where the /+esm endpoint is the only install option shown on the download page.

Locutus is an odd example, because the package contains a very large collection of submodules. I've found that jsDelivr supports a form of tree shaking by allowing /+esm to be appended to individual files in the library:

<script type="module">
        import pcre from 'https://cdn.jsdelivr.net/npm/locutus@2.0.32/php/pcre/+esm'
        import sprintf from 'https://cdn.jsdelivr.net/npm/locutus@2.0.32/php/strings/sprintf.js/+esm'
</script>

LibMan might be able to take advantage of this feature as well:

    {
      "provider": "jsdelivr/esm",
      "library": "locutus@2.0.32",
      "destination": "wwwroot/lib/locutus",
      "files": [
        "/php/pcre/index.js",
        "/php/strings/sprintf.js"
      ]
    }
Dominant language
C#
Stars
486
Forks
91
PR merge metrics
No merged PRs in 30d

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from aspnet/LibraryManager

All issues in aspnet/LibraryManager

Similar issues

More C# issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.