DF0059: Remote Assets File Listing Failed

Message

Failed to fetch the file listing for "{package}@{version}" from {provider}: {reason}

Cause

A remote-assets source ({ package, version } passed where a static mount accepts a dist directory) resolves request paths against the CDN provider's file-listing API — data.jsdelivr.com for jsDelivr, ?meta for unpkg, or a custom provider's listFiles. That listing request failed, typically because the provider is unreachable (offline machine, blocked domain) or returned an error status.

Example

defineDevframe({
  cli: {
    distDir: {
      package: '@devframes/plugin-git-client',
      version: '1.2.3',
    },
  },
})

Starting this devframe without network access to data.jsdelivr.com reports DF0059 on the first request.

Fix

Requests keep working in a degraded probe mode (each candidate path is tried against the provider directly). To resolve it:

• Check network access to the configured provider, or switch providers (provider: 'unpkg' or a custom mirror).
• Install the assets package locally (npm install <package>) — a locally installed copy is served with zero network and needs no listing.

Source

• packages/devframe/src/utils/remote-assets.ts — createRemoteAssetsStore() reports this (once per store) when the provider's file listing cannot be fetched or parsed.