{"record":{"id":"47f8eb10b25de182","repo":"cube-js/cube","slug":"driver-driver-dependency-not-found","errorCode":null,"errorMessage":"'${driver}' driver dependency not found","messagePattern":"'(.+?)' driver dependency not found","errorType":"http","errorClass":null,"httpStatus":400,"severity":"error","filePath":"packages/cubejs-server-core/src/core/DevServer.ts","lineNumber":351,"sourceCode":"      if (packageExists(DriverDependencies[driver as keyof typeof DriverDependencies])) {\n        return res.json({ status: 'installed' });\n      } else if (driverPromise) {\n        return res.json({ status: 'installing' });\n      } else if (driverError) {\n        return res.status(500).json({\n          status: 'error',\n          error: driverError.toString()\n        });\n      }\n\n      return res.json({ status: null });\n    }));\n\n    app.post('/playground/driver', catchErrors((req, res) => {\n      const { driver } = req.body;\n\n      if (!driver || typeof driver !== 'string' || !DriverDependencies[driver as keyof typeof DriverDependencies]) {\n        return res.status(400).json(`'${driver}' driver dependency not found`);\n      }\n\n      const driverKey = driver as keyof typeof DriverDependencies;\n\n      async function installDriver() {\n        driverError = null;\n\n        try {\n          await executeCommand(\n            'npm',\n            ['install', DriverDependencies[driverKey], '--save-dev'],\n            { cwd: path.resolve('.') }\n          );\n        } catch (error) {\n          driverError = error as Error;\n        } finally {\n          driverPromise = null;\n        }","sourceCodeStart":333,"sourceCodeEnd":369,"githubUrl":"https://github.com/cube-js/cube/blob/7d981676b36392fec34088b9afab6bdcad40207c/packages/cubejs-server-core/src/core/DevServer.ts#L333-L369","documentation":"Not a thrown error: the GET /playground/driver endpoint in DevServer returns 404-style JSON with status null when the requested driver dependency package is neither installed nor currently being installed (no in-flight install and no recorded driverError), i.e. the driver dependency is unknown to this server instance yet.","triggerScenarios":"Thrown at packages/cubejs-server-core/src/core/DevServer.ts:351 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["POST to /playground/driver with the driver name to trigger installation of the dependency package.","Verify the driver name is one of the supported keys in DriverDependencies (e.g. 'postgres', 'mysql').","If install was expected, check server logs for failed npm install attempts."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"7d981676b36392fec34088b9afab6bdcad40207c","analyzedAt":"2026-09-02T03:45:10.400Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-08T15:18:49.778Z"}