DF0061: Installed Assets Package Major Version Mismatch

Message

The locally installed "{package}@{installed}" is a different major version than the required "{required}".

Cause

A remote-assets source found a locally installed copy of its assets package (resolved from the declaration's resolveFrom module), but the installed version differs from the declared one by a major version. Assets and node code are published in lockstep; across a major boundary the served UI can be incompatible with its node backend, so devframe refuses to serve it.

Example

defineDevframe({
  cli: {
    distDir: {
      package: '@devframes/plugin-git-client',
      version: '2.0.0',
      resolveFrom: import.meta.url,
    },
  },
})

With @devframes/plugin-git-client@1.9.0 installed locally, mounting this devframe throws DF0061.

Fix

Install the assets package at the version its node package declares (they are published in lockstep):

npm install @devframes/plugin-git-client@2.0.0

Or uninstall the stale local copy so the assets stream from the CDN back-proxy at the exact declared version.

Source

• packages/devframe/src/utils/remote-assets.ts — resolveInstalledRemoteAssets() throws this when the installed package's major version differs from the declared one.