@libredb/studio 0.9.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (572) hide show
  1. package/.claude/settings.local.json +127 -0
  2. package/.cursorrules +426 -0
  3. package/.devin/wiki.json +143 -0
  4. package/.dockerignore +80 -0
  5. package/.env.example +159 -0
  6. package/.github/ISSUE_TEMPLATE/bug_report.md +49 -0
  7. package/.github/ISSUE_TEMPLATE/feature_request.md +29 -0
  8. package/.github/PULL_REQUEST_TEMPLATE.md +57 -0
  9. package/.github/workflows/ci.yml +185 -0
  10. package/.github/workflows/codeql.yml +57 -0
  11. package/.github/workflows/docker-build-push.yml +118 -0
  12. package/.github/workflows/helm-release.yml +113 -0
  13. package/CLAUDE.md +265 -0
  14. package/CODE_OF_CONDUCT.md +124 -0
  15. package/CONTRIBUTING.md +154 -0
  16. package/Dockerfile +73 -0
  17. package/LICENSE +21 -0
  18. package/README.md +614 -0
  19. package/SECURITY.md +107 -0
  20. package/artifacthub-repo.yml +4 -0
  21. package/bun.lock +1714 -0
  22. package/bunfig.toml +3 -0
  23. package/charts/libredb-studio/.helmignore +11 -0
  24. package/charts/libredb-studio/Chart.lock +6 -0
  25. package/charts/libredb-studio/Chart.yaml +50 -0
  26. package/charts/libredb-studio/README.md +206 -0
  27. package/charts/libredb-studio/templates/NOTES.txt +59 -0
  28. package/charts/libredb-studio/templates/_helpers.tpl +135 -0
  29. package/charts/libredb-studio/templates/configmap.yaml +37 -0
  30. package/charts/libredb-studio/templates/deployment.yaml +184 -0
  31. package/charts/libredb-studio/templates/hpa.yaml +32 -0
  32. package/charts/libredb-studio/templates/ingress.yaml +41 -0
  33. package/charts/libredb-studio/templates/networkpolicy.yaml +50 -0
  34. package/charts/libredb-studio/templates/pdb.yaml +18 -0
  35. package/charts/libredb-studio/templates/pvc.yaml +23 -0
  36. package/charts/libredb-studio/templates/secret.yaml +30 -0
  37. package/charts/libredb-studio/templates/seed-configmap.yaml +11 -0
  38. package/charts/libredb-studio/templates/service.yaml +22 -0
  39. package/charts/libredb-studio/templates/serviceaccount.yaml +13 -0
  40. package/charts/libredb-studio/values.schema.json +246 -0
  41. package/charts/libredb-studio/values.yaml +286 -0
  42. package/components.json +22 -0
  43. package/conductor/code_styleguides/typescript.md +43 -0
  44. package/conductor/product-guidelines.md +43 -0
  45. package/conductor/product.md +3 -0
  46. package/conductor/setup_state.json +1 -0
  47. package/conductor/tech-stack.md +39 -0
  48. package/conductor/tracks/enhance_postgres_monitoring_20251227/metadata.json +8 -0
  49. package/conductor/tracks/enhance_postgres_monitoring_20251227/plan.md +44 -0
  50. package/conductor/tracks/enhance_postgres_monitoring_20251227/spec.md +31 -0
  51. package/conductor/tracks.md +8 -0
  52. package/conductor/workflow.md +333 -0
  53. package/database-compose.yml +55 -0
  54. package/docker/postgres-init/01-extensions.sql +10 -0
  55. package/docker/postgres-init/02-sample-data.sql +585 -0
  56. package/docker/postgres.yml +68 -0
  57. package/docker-compose.yml +38 -0
  58. package/docs/AI_PLAN.md +74 -0
  59. package/docs/API_DOCS.md +875 -0
  60. package/docs/ARCHITECTURE.md +218 -0
  61. package/docs/DATABASE_PROVIDERS.md +358 -0
  62. package/docs/FEATURES.md +116 -0
  63. package/docs/HELM_CHART.md +252 -0
  64. package/docs/LOGIN_PAGE.md +178 -0
  65. package/docs/MONACO_EDITOR_PERFORMANCE.md +315 -0
  66. package/docs/OIDC_ARCH.md +681 -0
  67. package/docs/OIDC_SETUP.md +322 -0
  68. package/docs/POSTGRES_METRICS.md +516 -0
  69. package/docs/QUERY_OPTIMIZATION.md +370 -0
  70. package/docs/SEED_CONNECTIONS.md +468 -0
  71. package/docs/SQL_ALIAS_COMPLETION.md +190 -0
  72. package/docs/STORAGE_ARCHITECTURE.md +565 -0
  73. package/docs/STORAGE_QUICK_SETUP.md +419 -0
  74. package/docs/TECHNICAL_PLAN.md +36 -0
  75. package/docs/THEMING.md +345 -0
  76. package/docs/adding-a-new-database-provider.md +642 -0
  77. package/docs/backlogs/000-PLATFORM_DATA_SYNC_DATABASE.md +360 -0
  78. package/docs/backlogs/001-INLINE_DATA_EDITING.md +118 -0
  79. package/docs/backlogs/002-DATA_IMPORT.md +215 -0
  80. package/docs/backlogs/003-QUERY_TIME_MACHINE.md +183 -0
  81. package/docs/backlogs/004-AI_DATA_STORYTELLER.md +292 -0
  82. package/docs/backlogs/005-QUERY_PLAYGROUND.md +352 -0
  83. package/docs/backlogs/006-DATA_MASKING.md +418 -0
  84. package/docs/enterprise-features.md +718 -0
  85. package/docs/kubernetes-helm-chart-artifacthub-plan.md +803 -0
  86. package/docs/medium-koyeb-article-en.md +215 -0
  87. package/docs/plans/test-plans.md +445 -0
  88. package/docs/releases/RELEASE.V0.3.0.md +22 -0
  89. package/docs/releases/RELEASE.V0.4.0.md +154 -0
  90. package/docs/releases/RELEASE.V0.5.0.md +252 -0
  91. package/docs/releases/RELEASE_v0.5.6.md +145 -0
  92. package/docs/releases/RELEASE_v0.6.1.md +303 -0
  93. package/docs/releases/RELEASE_v0.6.7.md +292 -0
  94. package/docs/releases/RELEASE_v0.7.0.md +332 -0
  95. package/docs/releases/RELEASE_v0.8.0.md +521 -0
  96. package/docs/sampledb/titanic.sql +1379 -0
  97. package/docs/superpowers/plans/2026-03-25-seed-connections.md +1362 -0
  98. package/docs/superpowers/specs/2026-03-25-seed-connections-design.md +590 -0
  99. package/e2e/admin-dashboard.spec.ts +64 -0
  100. package/e2e/connection-management.spec.ts +58 -0
  101. package/e2e/export.spec.ts +34 -0
  102. package/e2e/login.spec.ts +85 -0
  103. package/e2e/query-execution.spec.ts +35 -0
  104. package/e2e/tab-management.spec.ts +64 -0
  105. package/eslint.config.mjs +28 -0
  106. package/fly.toml +43 -0
  107. package/next.config.ts +32 -0
  108. package/package.json +130 -0
  109. package/playwright.config.ts +34 -0
  110. package/postcss.config.mjs +7 -0
  111. package/public/favicon-32x32.png +0 -0
  112. package/public/favicon.ico +0 -0
  113. package/public/file.svg +1 -0
  114. package/public/globe.svg +1 -0
  115. package/public/logo.svg +32 -0
  116. package/public/next.svg +1 -0
  117. package/public/screenshots/code-generator.png +0 -0
  118. package/public/screenshots/connection-modal.png +0 -0
  119. package/public/screenshots/data-profiler.png +0 -0
  120. package/public/screenshots/erd-diagram.png +0 -0
  121. package/public/screenshots/hero-editor.png +0 -0
  122. package/public/screenshots/nl2sql.png +0 -0
  123. package/public/vercel.svg +1 -0
  124. package/public/window.svg +1 -0
  125. package/render.yaml +58 -0
  126. package/scripts/merge-lcov.mjs +239 -0
  127. package/sonar-project.properties +16 -0
  128. package/src/app/admin/error.tsx +46 -0
  129. package/src/app/admin/page.tsx +10 -0
  130. package/src/app/api/admin/audit/route.ts +52 -0
  131. package/src/app/api/admin/fleet-health/route.ts +81 -0
  132. package/src/app/api/ai/autopilot/route.ts +105 -0
  133. package/src/app/api/ai/chat/route.ts +132 -0
  134. package/src/app/api/ai/describe-schema/route.ts +52 -0
  135. package/src/app/api/ai/explain/route.ts +86 -0
  136. package/src/app/api/ai/impact/route.ts +97 -0
  137. package/src/app/api/ai/index-advisor/route.ts +98 -0
  138. package/src/app/api/ai/nl2sql/route.ts +87 -0
  139. package/src/app/api/ai/query-safety/route.ts +87 -0
  140. package/src/app/api/auth/login/route.ts +62 -0
  141. package/src/app/api/auth/logout/route.ts +25 -0
  142. package/src/app/api/auth/me/route.ts +10 -0
  143. package/src/app/api/auth/oidc/callback/route.ts +82 -0
  144. package/src/app/api/auth/oidc/login/route.ts +43 -0
  145. package/src/app/api/connections/managed/route.ts +35 -0
  146. package/src/app/api/db/cancel/route.ts +42 -0
  147. package/src/app/api/db/disconnect/route.ts +28 -0
  148. package/src/app/api/db/health/route.ts +49 -0
  149. package/src/app/api/db/maintenance/route.ts +72 -0
  150. package/src/app/api/db/monitoring/route.ts +62 -0
  151. package/src/app/api/db/multi-query/route.ts +116 -0
  152. package/src/app/api/db/pool-stats/route.ts +37 -0
  153. package/src/app/api/db/profile/route.ts +144 -0
  154. package/src/app/api/db/provider-meta/route.ts +49 -0
  155. package/src/app/api/db/query/route.ts +50 -0
  156. package/src/app/api/db/schema/route.ts +47 -0
  157. package/src/app/api/db/schema-snapshot/route.ts +42 -0
  158. package/src/app/api/db/test-connection/route.ts +55 -0
  159. package/src/app/api/db/transaction/route.ts +111 -0
  160. package/src/app/api/storage/[collection]/route.ts +67 -0
  161. package/src/app/api/storage/config/route.ts +17 -0
  162. package/src/app/api/storage/migrate/route.ts +45 -0
  163. package/src/app/api/storage/route.ts +32 -0
  164. package/src/app/error.tsx +49 -0
  165. package/src/app/global-error.tsx +55 -0
  166. package/src/app/globals.css +146 -0
  167. package/src/app/icon.svg +42 -0
  168. package/src/app/layout.tsx +34 -0
  169. package/src/app/login/login-form.tsx +301 -0
  170. package/src/app/login/page.tsx +11 -0
  171. package/src/app/monitoring/page.tsx +8 -0
  172. package/src/app/not-found.tsx +29 -0
  173. package/src/app/page.tsx +5 -0
  174. package/src/components/AIAutopilotPanel.tsx +238 -0
  175. package/src/components/CodeGenerator.tsx +271 -0
  176. package/src/components/CommandPalette.tsx +227 -0
  177. package/src/components/ConnectionModal.tsx +759 -0
  178. package/src/components/CreateTableModal.tsx +281 -0
  179. package/src/components/DataCharts.tsx +962 -0
  180. package/src/components/DataImportModal.tsx +582 -0
  181. package/src/components/DataProfiler.tsx +335 -0
  182. package/src/components/DatabaseDocs.tsx +251 -0
  183. package/src/components/MaskingSettings.tsx +414 -0
  184. package/src/components/MobileNav.tsx +50 -0
  185. package/src/components/NL2SQLPanel.tsx +281 -0
  186. package/src/components/PivotTable.tsx +257 -0
  187. package/src/components/QueryEditor.tsx +760 -0
  188. package/src/components/QueryHistory.tsx +344 -0
  189. package/src/components/QuerySafetyDialog.tsx +290 -0
  190. package/src/components/ResultsGrid.tsx +644 -0
  191. package/src/components/SaveQueryModal.tsx +104 -0
  192. package/src/components/SavedQueries.tsx +128 -0
  193. package/src/components/SchemaDiagram.tsx +473 -0
  194. package/src/components/SchemaDiff.tsx +473 -0
  195. package/src/components/SnapshotTimeline.tsx +116 -0
  196. package/src/components/Studio.tsx +639 -0
  197. package/src/components/TestDataGenerator.tsx +261 -0
  198. package/src/components/VisualExplain.tsx +820 -0
  199. package/src/components/admin/AdminDashboard.tsx +163 -0
  200. package/src/components/admin/tabs/AuditTab.tsx +531 -0
  201. package/src/components/admin/tabs/MonitoringEmbed.tsx +11 -0
  202. package/src/components/admin/tabs/OperationsTab.tsx +646 -0
  203. package/src/components/admin/tabs/OverviewTab.tsx +1328 -0
  204. package/src/components/admin/tabs/SecurityTab.tsx +284 -0
  205. package/src/components/community-section.tsx +92 -0
  206. package/src/components/icons/db-icons.tsx +84 -0
  207. package/src/components/libredb-logo.tsx +61 -0
  208. package/src/components/monitoring/MonitoringDashboard.tsx +345 -0
  209. package/src/components/monitoring/tabs/MetricChart.tsx +82 -0
  210. package/src/components/monitoring/tabs/OverviewTab.tsx +263 -0
  211. package/src/components/monitoring/tabs/PerformanceTab.tsx +254 -0
  212. package/src/components/monitoring/tabs/PoolTab.tsx +174 -0
  213. package/src/components/monitoring/tabs/QueriesTab.tsx +287 -0
  214. package/src/components/monitoring/tabs/SessionsTab.tsx +316 -0
  215. package/src/components/monitoring/tabs/StorageTab.tsx +335 -0
  216. package/src/components/monitoring/tabs/TablesTab.tsx +300 -0
  217. package/src/components/results-grid/ResultCard.tsx +111 -0
  218. package/src/components/results-grid/RowDetailSheet.tsx +178 -0
  219. package/src/components/results-grid/StatsBar.tsx +201 -0
  220. package/src/components/results-grid/index.ts +1 -0
  221. package/src/components/results-grid/utils.ts +23 -0
  222. package/src/components/schema-explorer/ColumnList.tsx +53 -0
  223. package/src/components/schema-explorer/SchemaExplorer.tsx +182 -0
  224. package/src/components/schema-explorer/TableItem.tsx +210 -0
  225. package/src/components/schema-explorer/index.ts +1 -0
  226. package/src/components/sidebar/ConnectionItem.tsx +105 -0
  227. package/src/components/sidebar/ConnectionsList.tsx +62 -0
  228. package/src/components/sidebar/Sidebar.tsx +130 -0
  229. package/src/components/sidebar/index.ts +2 -0
  230. package/src/components/studio/BottomPanel.tsx +286 -0
  231. package/src/components/studio/QueryToolbar.tsx +180 -0
  232. package/src/components/studio/StudioDesktopHeader.tsx +114 -0
  233. package/src/components/studio/StudioMobileHeader.tsx +340 -0
  234. package/src/components/studio/StudioTabBar.tsx +82 -0
  235. package/src/components/studio/index.ts +5 -0
  236. package/src/components/ui/accordion.tsx +66 -0
  237. package/src/components/ui/alert-dialog.tsx +157 -0
  238. package/src/components/ui/alert.tsx +66 -0
  239. package/src/components/ui/aspect-ratio.tsx +11 -0
  240. package/src/components/ui/avatar.tsx +53 -0
  241. package/src/components/ui/badge.tsx +46 -0
  242. package/src/components/ui/breadcrumb.tsx +109 -0
  243. package/src/components/ui/button-group.tsx +83 -0
  244. package/src/components/ui/button.tsx +60 -0
  245. package/src/components/ui/calendar.tsx +216 -0
  246. package/src/components/ui/card.tsx +92 -0
  247. package/src/components/ui/carousel.tsx +241 -0
  248. package/src/components/ui/chart.tsx +357 -0
  249. package/src/components/ui/checkbox.tsx +32 -0
  250. package/src/components/ui/collapsible.tsx +33 -0
  251. package/src/components/ui/command.tsx +184 -0
  252. package/src/components/ui/context-menu.tsx +252 -0
  253. package/src/components/ui/dialog.tsx +143 -0
  254. package/src/components/ui/drawer.tsx +135 -0
  255. package/src/components/ui/dropdown-menu.tsx +257 -0
  256. package/src/components/ui/empty.tsx +104 -0
  257. package/src/components/ui/field.tsx +248 -0
  258. package/src/components/ui/form.tsx +167 -0
  259. package/src/components/ui/hover-card.tsx +44 -0
  260. package/src/components/ui/input-group.tsx +170 -0
  261. package/src/components/ui/input-otp.tsx +77 -0
  262. package/src/components/ui/input.tsx +21 -0
  263. package/src/components/ui/item.tsx +193 -0
  264. package/src/components/ui/kbd.tsx +28 -0
  265. package/src/components/ui/label.tsx +24 -0
  266. package/src/components/ui/menubar.tsx +276 -0
  267. package/src/components/ui/navigation-menu.tsx +168 -0
  268. package/src/components/ui/pagination.tsx +127 -0
  269. package/src/components/ui/popover.tsx +48 -0
  270. package/src/components/ui/progress.tsx +31 -0
  271. package/src/components/ui/radio-group.tsx +45 -0
  272. package/src/components/ui/resizable.tsx +56 -0
  273. package/src/components/ui/scroll-area.tsx +58 -0
  274. package/src/components/ui/select.tsx +187 -0
  275. package/src/components/ui/separator.tsx +28 -0
  276. package/src/components/ui/sheet.tsx +139 -0
  277. package/src/components/ui/sidebar.tsx +726 -0
  278. package/src/components/ui/skeleton.tsx +13 -0
  279. package/src/components/ui/slider.tsx +63 -0
  280. package/src/components/ui/sonner.tsx +40 -0
  281. package/src/components/ui/spinner.tsx +16 -0
  282. package/src/components/ui/switch.tsx +31 -0
  283. package/src/components/ui/table.tsx +116 -0
  284. package/src/components/ui/tabs.tsx +66 -0
  285. package/src/components/ui/textarea.tsx +18 -0
  286. package/src/components/ui/toggle-group.tsx +83 -0
  287. package/src/components/ui/toggle.tsx +47 -0
  288. package/src/components/ui/tooltip.tsx +61 -0
  289. package/src/exports/components.ts +15 -0
  290. package/src/exports/index.ts +4 -0
  291. package/src/exports/providers.ts +4 -0
  292. package/src/exports/types.ts +26 -0
  293. package/src/hooks/use-ai-chat.ts +182 -0
  294. package/src/hooks/use-all-connections.ts +66 -0
  295. package/src/hooks/use-api-call.ts +71 -0
  296. package/src/hooks/use-auth.ts +51 -0
  297. package/src/hooks/use-connection-form.ts +349 -0
  298. package/src/hooks/use-connection-manager.ts +169 -0
  299. package/src/hooks/use-connection-payload.ts +15 -0
  300. package/src/hooks/use-inline-editing.ts +109 -0
  301. package/src/hooks/use-mobile.ts +20 -0
  302. package/src/hooks/use-monitoring-data.ts +270 -0
  303. package/src/hooks/use-provider-metadata.ts +62 -0
  304. package/src/hooks/use-query-execution.ts +478 -0
  305. package/src/hooks/use-storage-sync.ts +259 -0
  306. package/src/hooks/use-tab-manager.ts +231 -0
  307. package/src/hooks/use-toast.ts +20 -0
  308. package/src/hooks/use-transaction-control.ts +64 -0
  309. package/src/lib/api/error-codes.ts +30 -0
  310. package/src/lib/api/errors.ts +236 -0
  311. package/src/lib/api/with-error-handler.ts +41 -0
  312. package/src/lib/audit.ts +105 -0
  313. package/src/lib/auth.ts +87 -0
  314. package/src/lib/connection-string-parser.ts +172 -0
  315. package/src/lib/data-masking.ts +385 -0
  316. package/src/lib/db/base-provider.ts +325 -0
  317. package/src/lib/db/errors.ts +317 -0
  318. package/src/lib/db/factory.ts +324 -0
  319. package/src/lib/db/index.ts +123 -0
  320. package/src/lib/db/providers/document/index.ts +6 -0
  321. package/src/lib/db/providers/document/mongodb.ts +992 -0
  322. package/src/lib/db/providers/keyvalue/redis.ts +554 -0
  323. package/src/lib/db/providers/sql/index.ts +11 -0
  324. package/src/lib/db/providers/sql/mssql.ts +1065 -0
  325. package/src/lib/db/providers/sql/mysql.ts +978 -0
  326. package/src/lib/db/providers/sql/oracle.ts +1044 -0
  327. package/src/lib/db/providers/sql/postgres.ts +1179 -0
  328. package/src/lib/db/providers/sql/sql-base.ts +174 -0
  329. package/src/lib/db/providers/sql/sqlite.ts +721 -0
  330. package/src/lib/db/types.ts +437 -0
  331. package/src/lib/db/utils/pool-manager.ts +287 -0
  332. package/src/lib/db/utils/query-limiter.ts +239 -0
  333. package/src/lib/db-ui-config.ts +86 -0
  334. package/src/lib/editor/mongodb-completions.ts +172 -0
  335. package/src/lib/editor/sql-completions.ts +280 -0
  336. package/src/lib/llm/base-provider.ts +117 -0
  337. package/src/lib/llm/factory.ts +102 -0
  338. package/src/lib/llm/index.ts +90 -0
  339. package/src/lib/llm/providers/custom.ts +181 -0
  340. package/src/lib/llm/providers/gemini.ts +126 -0
  341. package/src/lib/llm/providers/ollama.ts +154 -0
  342. package/src/lib/llm/providers/openai.ts +146 -0
  343. package/src/lib/llm/types.ts +173 -0
  344. package/src/lib/llm/utils/config.ts +187 -0
  345. package/src/lib/llm/utils/retry.ts +119 -0
  346. package/src/lib/llm/utils/streaming.ts +202 -0
  347. package/src/lib/logger.ts +127 -0
  348. package/src/lib/monitoring-thresholds.ts +44 -0
  349. package/src/lib/oidc.ts +262 -0
  350. package/src/lib/query-generators.ts +61 -0
  351. package/src/lib/schema-diff/diff-engine.ts +273 -0
  352. package/src/lib/schema-diff/migration-generator.ts +208 -0
  353. package/src/lib/schema-diff/types.ts +55 -0
  354. package/src/lib/seed/config-loader.ts +79 -0
  355. package/src/lib/seed/connection-filter.ts +49 -0
  356. package/src/lib/seed/credential-resolver.ts +62 -0
  357. package/src/lib/seed/index.ts +40 -0
  358. package/src/lib/seed/resolve-connection.ts +57 -0
  359. package/src/lib/seed/types.ts +69 -0
  360. package/src/lib/sql/alias-extractor.ts +267 -0
  361. package/src/lib/sql/index.ts +8 -0
  362. package/src/lib/sql/statement-splitter.ts +167 -0
  363. package/src/lib/sql/types.ts +40 -0
  364. package/src/lib/ssh/tunnel.ts +142 -0
  365. package/src/lib/storage/factory.ts +84 -0
  366. package/src/lib/storage/index.ts +14 -0
  367. package/src/lib/storage/local-storage.ts +99 -0
  368. package/src/lib/storage/providers/postgres.ts +225 -0
  369. package/src/lib/storage/providers/sqlite.ts +153 -0
  370. package/src/lib/storage/storage-facade.ts +272 -0
  371. package/src/lib/storage/types.ts +75 -0
  372. package/src/lib/time-series-buffer.ts +58 -0
  373. package/src/lib/types.ts +173 -0
  374. package/src/lib/utils.ts +6 -0
  375. package/src/proxy.ts +104 -0
  376. package/src/types/db-drivers.d.ts +23 -0
  377. package/src/types/html2canvas.d.ts +9 -0
  378. package/tests/api/admin/audit.test.ts +178 -0
  379. package/tests/api/admin/fleet-health.test.ts +183 -0
  380. package/tests/api/ai/autopilot.test.ts +174 -0
  381. package/tests/api/ai/chat.test.ts +250 -0
  382. package/tests/api/ai/describe-schema.test.ts +266 -0
  383. package/tests/api/ai/explain.test.ts +199 -0
  384. package/tests/api/ai/impact.test.ts +168 -0
  385. package/tests/api/ai/index-advisor.test.ts +171 -0
  386. package/tests/api/ai/nl2sql.test.ts +202 -0
  387. package/tests/api/ai/query-safety.test.ts +196 -0
  388. package/tests/api/auth/login.test.ts +170 -0
  389. package/tests/api/auth/logout.test.ts +140 -0
  390. package/tests/api/auth/me.test.ts +73 -0
  391. package/tests/api/auth/oidc-callback.test.ts +215 -0
  392. package/tests/api/auth/oidc-login.test.ts +127 -0
  393. package/tests/api/db/cancel.test.ts +198 -0
  394. package/tests/api/db/disconnect.test.ts +124 -0
  395. package/tests/api/db/health.test.ts +222 -0
  396. package/tests/api/db/maintenance.test.ts +263 -0
  397. package/tests/api/db/monitoring.test.ts +221 -0
  398. package/tests/api/db/multi-query.test.ts +316 -0
  399. package/tests/api/db/pool-stats.test.ts +135 -0
  400. package/tests/api/db/profile.test.ts +330 -0
  401. package/tests/api/db/provider-meta.test.ts +193 -0
  402. package/tests/api/db/query.test.ts +314 -0
  403. package/tests/api/db/schema-snapshot.test.ts +170 -0
  404. package/tests/api/db/schema.test.ts +191 -0
  405. package/tests/api/db/test-connection.test.ts +185 -0
  406. package/tests/api/db/transaction.test.ts +314 -0
  407. package/tests/api/proxy.test.ts +191 -0
  408. package/tests/api/seed/managed-route.test.ts +113 -0
  409. package/tests/api/storage/config.test.ts +42 -0
  410. package/tests/api/storage/storage-routes.test.ts +309 -0
  411. package/tests/components/AIAutopilotPanel.test.tsx +756 -0
  412. package/tests/components/AdminPage.test.tsx +33 -0
  413. package/tests/components/CodeGenerator.test.tsx +182 -0
  414. package/tests/components/CommandPalette.test.tsx +428 -0
  415. package/tests/components/CommunitySection.test.tsx +91 -0
  416. package/tests/components/ConnectionModal.mobile.test.tsx +284 -0
  417. package/tests/components/ConnectionModal.test.tsx +570 -0
  418. package/tests/components/CreateTableModal.test.tsx +383 -0
  419. package/tests/components/DataCharts.test.tsx +739 -0
  420. package/tests/components/DataImportModal.test.tsx +751 -0
  421. package/tests/components/DataProfiler.test.tsx +589 -0
  422. package/tests/components/DatabaseDocs.test.tsx +353 -0
  423. package/tests/components/LoginPage.test.tsx +163 -0
  424. package/tests/components/LoginPageOIDC.test.tsx +92 -0
  425. package/tests/components/MaskingSettings.test.tsx +498 -0
  426. package/tests/components/MobileNav.test.tsx +30 -0
  427. package/tests/components/MonitoringPage.test.tsx +32 -0
  428. package/tests/components/NL2SQLPanel.test.tsx +621 -0
  429. package/tests/components/Page.test.tsx +33 -0
  430. package/tests/components/PivotTable.test.tsx +350 -0
  431. package/tests/components/QueryEditor.test.tsx +1730 -0
  432. package/tests/components/QueryHistory.test.tsx +572 -0
  433. package/tests/components/QuerySafetyDialog.test.tsx +586 -0
  434. package/tests/components/ResultsGrid.test.tsx +804 -0
  435. package/tests/components/RootLayout.test.tsx +83 -0
  436. package/tests/components/SaveQueryModal.test.tsx +25 -0
  437. package/tests/components/SavedQueries.test.tsx +43 -0
  438. package/tests/components/SchemaDiagram.test.tsx +1034 -0
  439. package/tests/components/SchemaDiff.test.tsx +906 -0
  440. package/tests/components/SnapshotTimeline.test.tsx +174 -0
  441. package/tests/components/Studio.test.tsx +1030 -0
  442. package/tests/components/TestDataGenerator.test.tsx +291 -0
  443. package/tests/components/VisualExplain.test.tsx +704 -0
  444. package/tests/components/admin/AdminDashboard.test.tsx +205 -0
  445. package/tests/components/admin/AuditTab.test.tsx +220 -0
  446. package/tests/components/admin/MonitoringEmbed.test.tsx +58 -0
  447. package/tests/components/admin/OperationsTab.test.tsx +975 -0
  448. package/tests/components/admin/OverviewTab.test.tsx +254 -0
  449. package/tests/components/admin/SecurityTab.test.tsx +467 -0
  450. package/tests/components/monitoring/MetricChart.test.tsx +111 -0
  451. package/tests/components/monitoring/MonitoringDashboard.test.tsx +259 -0
  452. package/tests/components/monitoring/OverviewTab.test.tsx +78 -0
  453. package/tests/components/monitoring/PerformanceTab.test.tsx +87 -0
  454. package/tests/components/monitoring/PoolTab.test.tsx +42 -0
  455. package/tests/components/monitoring/QueriesTab.test.tsx +80 -0
  456. package/tests/components/monitoring/SessionsTab.test.tsx +154 -0
  457. package/tests/components/monitoring/StorageTab.test.tsx +127 -0
  458. package/tests/components/monitoring/TablesTab.test.tsx +153 -0
  459. package/tests/components/results-grid/ResultCard.test.tsx +105 -0
  460. package/tests/components/results-grid/RowDetailSheet.test.tsx +308 -0
  461. package/tests/components/results-grid/StatsBar.test.tsx +162 -0
  462. package/tests/components/schema-explorer/ColumnList.test.tsx +151 -0
  463. package/tests/components/schema-explorer/SchemaExplorer.test.tsx +461 -0
  464. package/tests/components/schema-explorer/TableItem.test.tsx +415 -0
  465. package/tests/components/sidebar/ConnectionItem.test.tsx +201 -0
  466. package/tests/components/sidebar/ConnectionsList.test.tsx +176 -0
  467. package/tests/components/sidebar/Sidebar.test.tsx +187 -0
  468. package/tests/components/studio/BottomPanel.test.tsx +383 -0
  469. package/tests/components/studio/QueryToolbar.test.tsx +321 -0
  470. package/tests/components/studio/StudioDesktopHeader.test.tsx +377 -0
  471. package/tests/components/studio/StudioMobileHeader.test.tsx +198 -0
  472. package/tests/components/studio/StudioTabBar.test.tsx +331 -0
  473. package/tests/fixtures/connections.ts +96 -0
  474. package/tests/fixtures/masking-configs.ts +86 -0
  475. package/tests/fixtures/query-results.ts +71 -0
  476. package/tests/fixtures/schemas.ts +64 -0
  477. package/tests/fixtures/seed-connections/invalid-config.yaml +7 -0
  478. package/tests/fixtures/seed-connections/minimal-config.yaml +8 -0
  479. package/tests/fixtures/seed-connections/mixed-credentials.yaml +23 -0
  480. package/tests/fixtures/seed-connections/multi-role-config.yaml +30 -0
  481. package/tests/fixtures/seed-connections/valid-config.json +15 -0
  482. package/tests/fixtures/seed-connections/valid-config.yaml +51 -0
  483. package/tests/helpers/mock-fetch.ts +59 -0
  484. package/tests/helpers/mock-monaco.ts +112 -0
  485. package/tests/helpers/mock-navigation.ts +28 -0
  486. package/tests/helpers/mock-next.ts +80 -0
  487. package/tests/helpers/mock-provider.ts +133 -0
  488. package/tests/helpers/mock-sonner.ts +29 -0
  489. package/tests/helpers/render-with-providers.tsx +19 -0
  490. package/tests/hooks/use-ai-chat.test.ts +600 -0
  491. package/tests/hooks/use-auth.test.ts +371 -0
  492. package/tests/hooks/use-connection-form.test.ts +743 -0
  493. package/tests/hooks/use-connection-manager.test.ts +466 -0
  494. package/tests/hooks/use-inline-editing.test.ts +321 -0
  495. package/tests/hooks/use-mobile.test.ts +177 -0
  496. package/tests/hooks/use-monitoring-data.test.ts +819 -0
  497. package/tests/hooks/use-provider-metadata.test.ts +228 -0
  498. package/tests/hooks/use-query-execution.test.ts +1212 -0
  499. package/tests/hooks/use-tab-manager.test.ts +756 -0
  500. package/tests/hooks/use-toast.test.ts +74 -0
  501. package/tests/hooks/use-transaction-control.test.ts +211 -0
  502. package/tests/integration/db/mongodb-provider.test.ts +698 -0
  503. package/tests/integration/db/mssql-provider.test.ts +840 -0
  504. package/tests/integration/db/mysql-provider.test.ts +872 -0
  505. package/tests/integration/db/oracle-provider.test.ts +843 -0
  506. package/tests/integration/db/postgres-provider.test.ts +1382 -0
  507. package/tests/integration/db/redis-provider.test.ts +526 -0
  508. package/tests/integration/db/sqlite-provider.test.ts +480 -0
  509. package/tests/integration/seed/seed-pipeline.test.ts +102 -0
  510. package/tests/isolated/factory-singleton.test.ts +150 -0
  511. package/tests/isolated/use-storage-sync.test.ts +389 -0
  512. package/tests/run-components.sh +196 -0
  513. package/tests/setup-dom.ts +58 -0
  514. package/tests/setup.ts +40 -0
  515. package/tests/unit/api-errors.test.ts +210 -0
  516. package/tests/unit/code-generator-functions.test.ts +271 -0
  517. package/tests/unit/components/column-list.test.tsx +190 -0
  518. package/tests/unit/components/data-import-modal.test.tsx +441 -0
  519. package/tests/unit/components/studio-mobile-header.test.tsx +327 -0
  520. package/tests/unit/data-charts-functions.test.ts +496 -0
  521. package/tests/unit/data-import-functions.test.ts +320 -0
  522. package/tests/unit/data-import-utils.test.ts +125 -0
  523. package/tests/unit/db/base-provider.test.ts +517 -0
  524. package/tests/unit/db/errors.test.ts +403 -0
  525. package/tests/unit/db/factory.test.ts +436 -0
  526. package/tests/unit/db/pool-manager.test.ts +440 -0
  527. package/tests/unit/db/query-limiter.test.ts +387 -0
  528. package/tests/unit/db/sql-base.test.ts +438 -0
  529. package/tests/unit/lib/api/error-codes.test.ts +39 -0
  530. package/tests/unit/lib/audit.test.ts +326 -0
  531. package/tests/unit/lib/auth.test.ts +146 -0
  532. package/tests/unit/lib/connection-string-parser.test.ts +424 -0
  533. package/tests/unit/lib/data-masking.test.ts +583 -0
  534. package/tests/unit/lib/db-icons.test.tsx +41 -0
  535. package/tests/unit/lib/monitoring-thresholds.test.ts +133 -0
  536. package/tests/unit/lib/oidc.test.ts +509 -0
  537. package/tests/unit/lib/query-generators.test.ts +127 -0
  538. package/tests/unit/lib/storage/factory.test.ts +71 -0
  539. package/tests/unit/lib/storage/local-storage.test.ts +114 -0
  540. package/tests/unit/lib/storage/providers/postgres.test.ts +312 -0
  541. package/tests/unit/lib/storage/providers/sqlite.test.ts +232 -0
  542. package/tests/unit/lib/storage/storage-facade-extended.test.ts +331 -0
  543. package/tests/unit/lib/storage/storage-facade.test.ts +184 -0
  544. package/tests/unit/lib/storage.test.ts +317 -0
  545. package/tests/unit/lib/time-series-buffer.test.ts +212 -0
  546. package/tests/unit/lib/utils.test.ts +24 -0
  547. package/tests/unit/llm/base-provider.test.ts +238 -0
  548. package/tests/unit/llm/config.test.ts +262 -0
  549. package/tests/unit/llm/custom-provider.test.ts +281 -0
  550. package/tests/unit/llm/gemini-provider.test.ts +248 -0
  551. package/tests/unit/llm/llm-factory.test.ts +155 -0
  552. package/tests/unit/llm/ollama-provider.test.ts +288 -0
  553. package/tests/unit/llm/openai-provider.test.ts +324 -0
  554. package/tests/unit/llm/retry.test.ts +180 -0
  555. package/tests/unit/llm/streaming.test.ts +355 -0
  556. package/tests/unit/logger.test.ts +198 -0
  557. package/tests/unit/mongodb-completions.test.ts +516 -0
  558. package/tests/unit/pivot-table-functions.test.ts +76 -0
  559. package/tests/unit/query-cancelled-error.test.ts +81 -0
  560. package/tests/unit/schema-diff/diff-engine.test.ts +367 -0
  561. package/tests/unit/schema-diff/migration-generator.test.ts +513 -0
  562. package/tests/unit/seed/config-loader.test.ts +73 -0
  563. package/tests/unit/seed/connection-filter.test.ts +91 -0
  564. package/tests/unit/seed/credential-resolver.test.ts +85 -0
  565. package/tests/unit/seed/index.test.ts +72 -0
  566. package/tests/unit/seed/resolve-connection.test.ts +74 -0
  567. package/tests/unit/seed/types.test.ts +129 -0
  568. package/tests/unit/sql/alias-extractor.test.ts +444 -0
  569. package/tests/unit/sql/statement-splitter.test.ts +348 -0
  570. package/tests/unit/sql-completions.test.ts +463 -0
  571. package/tests/unit/ssh-tunnel.test.ts +465 -0
  572. package/tsconfig.json +42 -0
package/bunfig.toml ADDED
@@ -0,0 +1,3 @@
1
+ [test]
2
+ preload = ["./tests/setup-dom.ts", "./tests/setup.ts", "./tests/helpers/mock-sonner.ts", "./tests/helpers/mock-navigation.ts"]
3
+ root = "tests"
@@ -0,0 +1,11 @@
1
+ .git
2
+ .gitignore
3
+ .github
4
+ .vscode
5
+ .idea
6
+ *.swp
7
+ *.bak
8
+ *.tmp
9
+ *.orig
10
+ .DS_Store
11
+ ci/
@@ -0,0 +1,6 @@
1
+ dependencies:
2
+ - name: postgresql
3
+ repository: https://charts.bitnami.com/bitnami
4
+ version: 16.7.27
5
+ digest: sha256:e8b999a3aaad6328a13d0c666207650897b69c61367c947d363b2acbe0ea1b42
6
+ generated: "2026-03-13T22:39:25.224637014+03:00"
@@ -0,0 +1,50 @@
1
+ apiVersion: v2
2
+ name: libredb-studio
3
+ description: Web-based SQL IDE for cloud-native teams supporting PostgreSQL, MySQL, SQLite, Oracle, SQL Server, MongoDB, and Redis
4
+ type: application
5
+ version: 0.1.0
6
+ appVersion: "0.8.10"
7
+ kubeVersion: ">=1.26.0-0"
8
+ home: https://github.com/libredb/libredb-studio
9
+ icon: https://raw.githubusercontent.com/libredb/libredb-studio/main/public/logo.svg
10
+ sources:
11
+ - https://github.com/libredb/libredb-studio
12
+ keywords:
13
+ - sql
14
+ - ide
15
+ - database
16
+ - postgresql
17
+ - mysql
18
+ - mongodb
19
+ - redis
20
+ - sqlite
21
+ - oracle
22
+ - mssql
23
+ - web-ide
24
+ maintainers:
25
+ - name: cevheri
26
+ url: https://github.com/cevheri
27
+ annotations:
28
+ artifacthub.io/category: database
29
+ artifacthub.io/license: MIT
30
+ artifacthub.io/prerelease: "true"
31
+ artifacthub.io/containsSecurityUpdates: "false"
32
+ artifacthub.io/images: |
33
+ - name: libredb-studio
34
+ image: ghcr.io/libredb/libredb-studio:0.8.10
35
+ platforms:
36
+ - linux/amd64
37
+ artifacthub.io/links: |
38
+ - name: Documentation
39
+ url: https://github.com/libredb/libredb-studio#readme
40
+ - name: Container Image
41
+ url: https://github.com/libredb/libredb-studio/pkgs/container/libredb-studio
42
+ - name: Source
43
+ url: https://github.com/libredb/libredb-studio
44
+ artifacthub.io/changes: |
45
+ - Initial Helm chart release
46
+ dependencies:
47
+ - name: postgresql
48
+ version: "16.x.x"
49
+ repository: https://charts.bitnami.com/bitnami
50
+ condition: postgresql.enabled
@@ -0,0 +1,206 @@
1
+ # LibreDB Studio Helm Chart
2
+
3
+ [![Artifact Hub](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/libredb-studio)](https://artifacthub.io/packages/search?repo=libredb-studio)
4
+
5
+ Web-based SQL IDE for cloud-native teams supporting PostgreSQL, MySQL, SQLite, Oracle, SQL Server, MongoDB, and Redis.
6
+
7
+ ## Prerequisites
8
+
9
+ - Kubernetes >= 1.26
10
+ - Helm >= 3.12
11
+
12
+ ## Quick Start
13
+
14
+ ```bash
15
+ # Add the Helm repository
16
+ helm repo add libredb https://libredb.github.io/libredb-studio
17
+ helm repo update
18
+
19
+ # Install with minimal configuration
20
+ helm install libredb libredb/libredb-studio \
21
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
22
+ --set secrets.adminPassword=MyAdmin123 \
23
+ --set secrets.userPassword=MyUser123
24
+
25
+ # Access via port-forward
26
+ kubectl port-forward svc/libredb-libredb-studio 3000:80
27
+ # Open http://localhost:3000
28
+ ```
29
+
30
+ ### OCI Registry Install
31
+
32
+ ```bash
33
+ helm install libredb oci://ghcr.io/libredb/charts/libredb-studio \
34
+ --version 0.1.0 \
35
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
36
+ --set secrets.adminPassword=MyAdmin123 \
37
+ --set secrets.userPassword=MyUser123
38
+ ```
39
+
40
+ ## Storage Modes
41
+
42
+ ### Local (default)
43
+
44
+ Browser localStorage. No server-side persistence. Suitable for single-user testing.
45
+
46
+ ### SQLite
47
+
48
+ Persistent file-based storage. A PVC is automatically created.
49
+
50
+ ```bash
51
+ helm install libredb libredb/libredb-studio \
52
+ --set config.storageProvider=sqlite \
53
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
54
+ --set secrets.adminPassword=MyAdmin123 \
55
+ --set secrets.userPassword=MyUser123
56
+ ```
57
+
58
+ > **Note:** SQLite is single-writer. Do not use with multiple replicas.
59
+
60
+ ### PostgreSQL (built-in subchart)
61
+
62
+ Deploys a Bitnami PostgreSQL instance alongside LibreDB Studio.
63
+
64
+ ```bash
65
+ helm install libredb libredb/libredb-studio \
66
+ --set postgresql.enabled=true \
67
+ --set postgresql.auth.password=pg-secret \
68
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
69
+ --set secrets.adminPassword=MyAdmin123 \
70
+ --set secrets.userPassword=MyUser123
71
+ ```
72
+
73
+ Storage provider is automatically set to `postgres` when the subchart is enabled.
74
+
75
+ ### PostgreSQL (external)
76
+
77
+ ```bash
78
+ helm install libredb libredb/libredb-studio \
79
+ --set config.storageProvider=postgres \
80
+ --set secrets.storagePostgresUrl="postgresql://user:pass@host:5432/libredb" \
81
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
82
+ --set secrets.adminPassword=MyAdmin123 \
83
+ --set secrets.userPassword=MyUser123
84
+ ```
85
+
86
+ ## OIDC SSO
87
+
88
+ ```bash
89
+ helm install libredb libredb/libredb-studio \
90
+ --set authProvider=oidc \
91
+ --set config.oidcIssuer=https://dev-xxx.auth0.com \
92
+ --set secrets.oidcClientId=your-client-id \
93
+ --set secrets.oidcClientSecret=your-client-secret \
94
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
95
+ --set secrets.adminPassword=MyAdmin123 \
96
+ --set secrets.userPassword=MyUser123
97
+ ```
98
+
99
+ ## AI Configuration
100
+
101
+ ```bash
102
+ helm install libredb libredb/libredb-studio \
103
+ --set config.llmProvider=openai \
104
+ --set config.llmModel=gpt-4o \
105
+ --set secrets.llmApiKey=sk-your-key \
106
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
107
+ --set secrets.adminPassword=MyAdmin123 \
108
+ --set secrets.userPassword=MyUser123
109
+ ```
110
+
111
+ ## Production Setup (Ingress + HA)
112
+
113
+ ```bash
114
+ helm install libredb libredb/libredb-studio \
115
+ --set secrets.jwtSecret=$(openssl rand -base64 32) \
116
+ --set secrets.adminPassword=StrongPass123 \
117
+ --set secrets.userPassword=StrongPass456 \
118
+ --set postgresql.enabled=true \
119
+ --set postgresql.auth.password=pg-secret \
120
+ --set ingress.enabled=true \
121
+ --set ingress.className=nginx \
122
+ --set "ingress.hosts[0].host=libredb.example.com" \
123
+ --set "ingress.hosts[0].paths[0].path=/" \
124
+ --set "ingress.hosts[0].paths[0].pathType=Prefix" \
125
+ --set "ingress.tls[0].secretName=libredb-tls" \
126
+ --set "ingress.tls[0].hosts[0]=libredb.example.com" \
127
+ --set autoscaling.enabled=true \
128
+ --set podDisruptionBudget.enabled=true
129
+ ```
130
+
131
+ ### Traefik Ingress
132
+
133
+ ```bash
134
+ helm install libredb libredb/libredb-studio \
135
+ --set ingress.enabled=true \
136
+ --set ingress.className=traefik \
137
+ --set "ingress.annotations.traefik\.ingress\.kubernetes\.io/router\.entrypoints=websecure" \
138
+ --set "ingress.hosts[0].host=libredb.example.com" \
139
+ --set "ingress.hosts[0].paths[0].path=/" \
140
+ --set "ingress.hosts[0].paths[0].pathType=Prefix" \
141
+ # ... secrets omitted for brevity
142
+ ```
143
+
144
+ ## External Secrets
145
+
146
+ Use `secrets.existingSecret` to reference a secret managed by External Secrets Operator, Sealed Secrets, or Vault:
147
+
148
+ ```bash
149
+ helm install libredb libredb/libredb-studio \
150
+ --set secrets.existingSecret=my-libredb-secret
151
+ ```
152
+
153
+ Your external secret must contain these keys (customizable via `secrets.existingSecretKeys`):
154
+ - `jwt-secret`
155
+ - `admin-email`, `admin-password`
156
+ - `user-email`, `user-password`
157
+ - Optional: `llm-api-key`, `oidc-client-id`, `oidc-client-secret`, `storage-postgres-url`
158
+
159
+ ## Upgrading
160
+
161
+ ```bash
162
+ helm repo update
163
+ helm upgrade libredb libredb/libredb-studio
164
+ ```
165
+
166
+ ## Uninstalling
167
+
168
+ ```bash
169
+ helm uninstall libredb
170
+ ```
171
+
172
+ > **Note:** PVCs are not deleted automatically. To remove persistent data:
173
+ > ```bash
174
+ > kubectl delete pvc -l app.kubernetes.io/instance=libredb
175
+ > ```
176
+
177
+ ## Configuration Reference
178
+
179
+ | Parameter | Description | Default |
180
+ |-----------|-------------|---------|
181
+ | `replicaCount` | Number of replicas | `1` |
182
+ | `image.repository` | Container image | `ghcr.io/libredb/libredb-studio` |
183
+ | `image.tag` | Image tag | `""` (Chart appVersion) |
184
+ | `image.pullPolicy` | Pull policy | `IfNotPresent` |
185
+ | `authProvider` | Auth mode: local or oidc | `local` |
186
+ | `secrets.jwtSecret` | JWT signing secret | `""` |
187
+ | `secrets.adminEmail` | Admin email | `admin@libredb.org` |
188
+ | `secrets.adminPassword` | Admin password | `""` |
189
+ | `secrets.userEmail` | User email | `user@libredb.org` |
190
+ | `secrets.userPassword` | User password | `""` |
191
+ | `secrets.existingSecret` | Use existing Secret | `""` |
192
+ | `config.storageProvider` | Storage: local, sqlite, postgres | `local` |
193
+ | `config.llmProvider` | AI provider | `""` |
194
+ | `persistence.enabled` | Enable PVC | `false` |
195
+ | `persistence.size` | PVC size | `1Gi` |
196
+ | `service.type` | Service type | `ClusterIP` |
197
+ | `service.port` | Service port | `80` |
198
+ | `ingress.enabled` | Enable Ingress | `false` |
199
+ | `autoscaling.enabled` | Enable HPA | `false` |
200
+ | `autoscaling.minReplicas` | Min replicas | `2` |
201
+ | `autoscaling.maxReplicas` | Max replicas | `10` |
202
+ | `podDisruptionBudget.enabled` | Enable PDB | `false` |
203
+ | `networkPolicy.enabled` | Enable NetworkPolicy | `false` |
204
+ | `postgresql.enabled` | Deploy PostgreSQL subchart | `false` |
205
+
206
+ See [values.yaml](values.yaml) for the complete list of configurable parameters.
@@ -0,0 +1,59 @@
1
+ LibreDB Studio has been deployed successfully!
2
+
3
+ {{- if .Values.ingress.enabled }}
4
+
5
+ Access LibreDB Studio via Ingress:
6
+ {{- range $host := .Values.ingress.hosts }}
7
+ {{- range .paths }}
8
+ http{{ if $.Values.ingress.tls }}s{{ end }}://{{ $host.host }}{{ .path }}
9
+ {{- end }}
10
+ {{- end }}
11
+
12
+ {{- else if contains "NodePort" .Values.service.type }}
13
+
14
+ Access LibreDB Studio via NodePort:
15
+ export NODE_PORT=$(kubectl get --namespace {{ .Release.Namespace }} -o jsonpath="{.spec.ports[0].nodePort}" services {{ include "libredb-studio.fullname" . }})
16
+ export NODE_IP=$(kubectl get nodes --namespace {{ .Release.Namespace }} -o jsonpath="{.items[0].status.addresses[0].address}")
17
+ echo "http://${NODE_IP}:${NODE_PORT}"
18
+
19
+ {{- else if contains "LoadBalancer" .Values.service.type }}
20
+
21
+ Access LibreDB Studio via LoadBalancer:
22
+ NOTE: It may take a few minutes for the LoadBalancer IP to be available.
23
+ Watch status with: kubectl get --namespace {{ .Release.Namespace }} svc -w {{ include "libredb-studio.fullname" . }}
24
+
25
+ export SERVICE_IP=$(kubectl get svc --namespace {{ .Release.Namespace }} {{ include "libredb-studio.fullname" . }} --template "{{"{{ range (index .status.loadBalancer.ingress 0) }}{{.}}{{ end }}"}}")
26
+ echo "http://${SERVICE_IP}:{{ .Values.service.port }}"
27
+
28
+ {{- else }}
29
+
30
+ Access LibreDB Studio via port-forward:
31
+ kubectl --namespace {{ .Release.Namespace }} port-forward svc/{{ include "libredb-studio.fullname" . }} {{ .Values.service.targetPort }}:{{ .Values.service.port }}
32
+ Open http://localhost:{{ .Values.service.targetPort }}
33
+
34
+ {{- end }}
35
+
36
+ Configuration:
37
+ Auth Provider: {{ .Values.authProvider }}
38
+ Storage Provider: {{ include "libredb-studio.storageProvider" . }}
39
+ {{- if .Values.postgresql.enabled }}
40
+ PostgreSQL: Built-in (subchart)
41
+ {{- end }}
42
+ {{- if .Values.autoscaling.enabled }}
43
+ Autoscaling: {{ .Values.autoscaling.minReplicas }}-{{ .Values.autoscaling.maxReplicas }} replicas
44
+ {{- end }}
45
+
46
+ Health check:
47
+ kubectl --namespace {{ .Release.Namespace }} exec deploy/{{ include "libredb-studio.fullname" . }} -- wget -qO- http://localhost:{{ .Values.service.targetPort }}/api/db/health
48
+
49
+ {{- if and (not .Values.secrets.jwtSecret) (not .Values.secrets.existingSecret) }}
50
+
51
+ WARNING: No JWT secret was provided. Please set secrets.jwtSecret to a strong random value (min 32 chars):
52
+ helm upgrade {{ .Release.Name }} libredb/libredb-studio --set secrets.jwtSecret=$(openssl rand -base64 32)
53
+ {{- end }}
54
+
55
+ {{- if and (eq (include "libredb-studio.storageProvider" .) "sqlite") (gt (int .Values.replicaCount) 1) }}
56
+
57
+ WARNING: SQLite storage with multiple replicas is not recommended.
58
+ SQLite is a single-writer database. Consider using storageProvider=postgres for multi-replica setups.
59
+ {{- end }}
@@ -0,0 +1,135 @@
1
+ {{/*
2
+ Expand the name of the chart.
3
+ */}}
4
+ {{- define "libredb-studio.name" -}}
5
+ {{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
6
+ {{- end }}
7
+
8
+ {{/*
9
+ Create a default fully qualified app name.
10
+ We truncate at 63 chars because some Kubernetes name fields are limited to this (by the DNS naming spec).
11
+ */}}
12
+ {{- define "libredb-studio.fullname" -}}
13
+ {{- if .Values.fullnameOverride }}
14
+ {{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
15
+ {{- else }}
16
+ {{- $name := default .Chart.Name .Values.nameOverride }}
17
+ {{- if contains $name .Release.Name }}
18
+ {{- .Release.Name | trunc 63 | trimSuffix "-" }}
19
+ {{- else }}
20
+ {{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
21
+ {{- end }}
22
+ {{- end }}
23
+ {{- end }}
24
+
25
+ {{/*
26
+ Create chart name and version as used by the chart label.
27
+ */}}
28
+ {{- define "libredb-studio.chart" -}}
29
+ {{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
30
+ {{- end }}
31
+
32
+ {{/*
33
+ Common labels
34
+ */}}
35
+ {{- define "libredb-studio.labels" -}}
36
+ helm.sh/chart: {{ include "libredb-studio.chart" . }}
37
+ {{ include "libredb-studio.selectorLabels" . }}
38
+ {{- if .Chart.AppVersion }}
39
+ app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
40
+ {{- end }}
41
+ app.kubernetes.io/managed-by: {{ .Release.Service }}
42
+ {{- end }}
43
+
44
+ {{/*
45
+ Selector labels
46
+ */}}
47
+ {{- define "libredb-studio.selectorLabels" -}}
48
+ app.kubernetes.io/name: {{ include "libredb-studio.name" . }}
49
+ app.kubernetes.io/instance: {{ .Release.Name }}
50
+ {{- end }}
51
+
52
+ {{/*
53
+ Create the name of the service account to use
54
+ */}}
55
+ {{- define "libredb-studio.serviceAccountName" -}}
56
+ {{- if .Values.serviceAccount.create }}
57
+ {{- default (include "libredb-studio.fullname" .) .Values.serviceAccount.name }}
58
+ {{- else }}
59
+ {{- default "default" .Values.serviceAccount.name }}
60
+ {{- end }}
61
+ {{- end }}
62
+
63
+ {{/*
64
+ Return the secret name (existing or generated)
65
+ */}}
66
+ {{- define "libredb-studio.secretName" -}}
67
+ {{- if .Values.secrets.existingSecret }}
68
+ {{- .Values.secrets.existingSecret }}
69
+ {{- else }}
70
+ {{- include "libredb-studio.fullname" . }}
71
+ {{- end }}
72
+ {{- end }}
73
+
74
+ {{/*
75
+ Return the configmap name
76
+ */}}
77
+ {{- define "libredb-studio.configMapName" -}}
78
+ {{- printf "%s-config" (include "libredb-studio.fullname" .) }}
79
+ {{- end }}
80
+
81
+ {{/*
82
+ Return the PVC name (existing or generated)
83
+ */}}
84
+ {{- define "libredb-studio.pvcName" -}}
85
+ {{- if .Values.persistence.existingClaim }}
86
+ {{- .Values.persistence.existingClaim }}
87
+ {{- else }}
88
+ {{- printf "%s-data" (include "libredb-studio.fullname" .) }}
89
+ {{- end }}
90
+ {{- end }}
91
+
92
+ {{/*
93
+ Determine if persistence should be enabled.
94
+ Returns "true" if persistence.enabled OR storageProvider is sqlite.
95
+ */}}
96
+ {{- define "libredb-studio.persistenceEnabled" -}}
97
+ {{- if or .Values.persistence.enabled (eq .Values.config.storageProvider "sqlite") }}
98
+ {{- true }}
99
+ {{- end }}
100
+ {{- end }}
101
+
102
+ {{/*
103
+ Return the effective storage provider.
104
+ If postgresql subchart is enabled and storageProvider is "local", auto-switch to "postgres".
105
+ */}}
106
+ {{- define "libredb-studio.storageProvider" -}}
107
+ {{- if and .Values.postgresql.enabled (eq .Values.config.storageProvider "local") }}
108
+ {{- "postgres" }}
109
+ {{- else }}
110
+ {{- .Values.config.storageProvider }}
111
+ {{- end }}
112
+ {{- end }}
113
+
114
+ {{/*
115
+ Return the full image reference (repository:tag)
116
+ */}}
117
+ {{- define "libredb-studio.image" -}}
118
+ {{- $tag := default .Chart.AppVersion .Values.image.tag }}
119
+ {{- printf "%s:%s" .Values.image.repository $tag }}
120
+ {{- end }}
121
+
122
+ {{/*
123
+ Return the PostgreSQL subchart fullname.
124
+ Bitnami subchart names resources as: <release>-postgresql (not <release>-<chart>-postgresql).
125
+ */}}
126
+ {{- define "libredb-studio.postgresql.fullname" -}}
127
+ {{- printf "%s-postgresql" .Release.Name }}
128
+ {{- end }}
129
+
130
+ {{/*
131
+ Return the PostgreSQL URL when subchart is enabled
132
+ */}}
133
+ {{- define "libredb-studio.postgresql.url" -}}
134
+ {{- printf "postgresql://%s:$(POSTGRES_PASSWORD)@%s:5432/%s" .Values.postgresql.auth.username (include "libredb-studio.postgresql.fullname" .) .Values.postgresql.auth.database }}
135
+ {{- end }}
@@ -0,0 +1,37 @@
1
+ apiVersion: v1
2
+ kind: ConfigMap
3
+ metadata:
4
+ name: {{ include "libredb-studio.configMapName" . }}
5
+ labels:
6
+ {{- include "libredb-studio.labels" . | nindent 4 }}
7
+ data:
8
+ NODE_ENV: "production"
9
+ PORT: {{ .Values.service.targetPort | quote }}
10
+ HOSTNAME: "0.0.0.0"
11
+ NEXT_TELEMETRY_DISABLED: "1"
12
+ NODE_OPTIONS: "--max-old-space-size=384"
13
+ NEXT_PUBLIC_AUTH_PROVIDER: {{ .Values.authProvider | quote }}
14
+ LOG_LEVEL: {{ .Values.config.logLevel | quote }}
15
+ STORAGE_PROVIDER: {{ include "libredb-studio.storageProvider" . | quote }}
16
+ {{- if eq (include "libredb-studio.storageProvider" .) "sqlite" }}
17
+ STORAGE_SQLITE_PATH: {{ .Values.config.storageSqlitePath | quote }}
18
+ {{- end }}
19
+ {{- if .Values.config.llmProvider }}
20
+ LLM_PROVIDER: {{ .Values.config.llmProvider | quote }}
21
+ {{- end }}
22
+ {{- if .Values.config.llmModel }}
23
+ LLM_MODEL: {{ .Values.config.llmModel | quote }}
24
+ {{- end }}
25
+ {{- if .Values.config.llmApiUrl }}
26
+ LLM_API_URL: {{ .Values.config.llmApiUrl | quote }}
27
+ {{- end }}
28
+ {{- if eq .Values.authProvider "oidc" }}
29
+ {{- if .Values.config.oidcIssuer }}
30
+ OIDC_ISSUER: {{ .Values.config.oidcIssuer | quote }}
31
+ {{- end }}
32
+ OIDC_SCOPE: {{ .Values.config.oidcScope | quote }}
33
+ {{- if .Values.config.oidcRoleClaim }}
34
+ OIDC_ROLE_CLAIM: {{ .Values.config.oidcRoleClaim | quote }}
35
+ {{- end }}
36
+ OIDC_ADMIN_ROLES: {{ .Values.config.oidcAdminRoles | quote }}
37
+ {{- end }}
@@ -0,0 +1,184 @@
1
+ apiVersion: apps/v1
2
+ kind: Deployment
3
+ metadata:
4
+ name: {{ include "libredb-studio.fullname" . }}
5
+ labels:
6
+ {{- include "libredb-studio.labels" . | nindent 4 }}
7
+ spec:
8
+ {{- if not .Values.autoscaling.enabled }}
9
+ replicas: {{ .Values.replicaCount }}
10
+ {{- end }}
11
+ selector:
12
+ matchLabels:
13
+ {{- include "libredb-studio.selectorLabels" . | nindent 6 }}
14
+ template:
15
+ metadata:
16
+ annotations:
17
+ checksum/config: {{ include (print $.Template.BasePath "/configmap.yaml") . | sha256sum }}
18
+ checksum/secret: {{ include (print $.Template.BasePath "/secret.yaml") . | sha256sum }}
19
+ {{- with .Values.podAnnotations }}
20
+ {{- toYaml . | nindent 8 }}
21
+ {{- end }}
22
+ labels:
23
+ {{- include "libredb-studio.labels" . | nindent 8 }}
24
+ {{- with .Values.podLabels }}
25
+ {{- toYaml . | nindent 8 }}
26
+ {{- end }}
27
+ spec:
28
+ {{- with .Values.imagePullSecrets }}
29
+ imagePullSecrets:
30
+ {{- toYaml . | nindent 8 }}
31
+ {{- end }}
32
+ serviceAccountName: {{ include "libredb-studio.serviceAccountName" . }}
33
+ securityContext:
34
+ {{- toYaml .Values.podSecurityContext | nindent 8 }}
35
+ containers:
36
+ - name: {{ .Chart.Name }}
37
+ securityContext:
38
+ {{- toYaml .Values.securityContext | nindent 12 }}
39
+ image: {{ include "libredb-studio.image" . }}
40
+ imagePullPolicy: {{ .Values.image.pullPolicy }}
41
+ ports:
42
+ - name: http
43
+ containerPort: {{ .Values.service.targetPort }}
44
+ protocol: TCP
45
+ envFrom:
46
+ - configMapRef:
47
+ name: {{ include "libredb-studio.configMapName" . }}
48
+ {{- with .Values.extraEnvFrom }}
49
+ {{- toYaml . | nindent 12 }}
50
+ {{- end }}
51
+ env:
52
+ - name: JWT_SECRET
53
+ valueFrom:
54
+ secretKeyRef:
55
+ name: {{ include "libredb-studio.secretName" . }}
56
+ key: {{ .Values.secrets.existingSecretKeys.jwtSecret }}
57
+ - name: ADMIN_EMAIL
58
+ valueFrom:
59
+ secretKeyRef:
60
+ name: {{ include "libredb-studio.secretName" . }}
61
+ key: {{ .Values.secrets.existingSecretKeys.adminEmail }}
62
+ - name: ADMIN_PASSWORD
63
+ valueFrom:
64
+ secretKeyRef:
65
+ name: {{ include "libredb-studio.secretName" . }}
66
+ key: {{ .Values.secrets.existingSecretKeys.adminPassword }}
67
+ - name: USER_EMAIL
68
+ valueFrom:
69
+ secretKeyRef:
70
+ name: {{ include "libredb-studio.secretName" . }}
71
+ key: {{ .Values.secrets.existingSecretKeys.userEmail }}
72
+ - name: USER_PASSWORD
73
+ valueFrom:
74
+ secretKeyRef:
75
+ name: {{ include "libredb-studio.secretName" . }}
76
+ key: {{ .Values.secrets.existingSecretKeys.userPassword }}
77
+ {{- if or .Values.secrets.llmApiKey .Values.secrets.existingSecret }}
78
+ - name: LLM_API_KEY
79
+ valueFrom:
80
+ secretKeyRef:
81
+ name: {{ include "libredb-studio.secretName" . }}
82
+ key: {{ .Values.secrets.existingSecretKeys.llmApiKey }}
83
+ optional: true
84
+ {{- end }}
85
+ {{- if or .Values.secrets.oidcClientId .Values.secrets.existingSecret }}
86
+ - name: OIDC_CLIENT_ID
87
+ valueFrom:
88
+ secretKeyRef:
89
+ name: {{ include "libredb-studio.secretName" . }}
90
+ key: {{ .Values.secrets.existingSecretKeys.oidcClientId }}
91
+ optional: true
92
+ {{- end }}
93
+ {{- if or .Values.secrets.oidcClientSecret .Values.secrets.existingSecret }}
94
+ - name: OIDC_CLIENT_SECRET
95
+ valueFrom:
96
+ secretKeyRef:
97
+ name: {{ include "libredb-studio.secretName" . }}
98
+ key: {{ .Values.secrets.existingSecretKeys.oidcClientSecret }}
99
+ optional: true
100
+ {{- end }}
101
+ {{- if .Values.postgresql.enabled }}
102
+ - name: POSTGRES_PASSWORD
103
+ valueFrom:
104
+ secretKeyRef:
105
+ name: {{ include "libredb-studio.postgresql.fullname" . }}
106
+ key: password
107
+ - name: STORAGE_POSTGRES_URL
108
+ value: {{ include "libredb-studio.postgresql.url" . | quote }}
109
+ {{- else if or .Values.secrets.storagePostgresUrl .Values.secrets.existingSecret }}
110
+ - name: STORAGE_POSTGRES_URL
111
+ valueFrom:
112
+ secretKeyRef:
113
+ name: {{ include "libredb-studio.secretName" . }}
114
+ key: {{ .Values.secrets.existingSecretKeys.storagePostgresUrl }}
115
+ optional: true
116
+ {{- end }}
117
+ {{- if .Values.seedConnections.enabled }}
118
+ - name: SEED_CONFIG_PATH
119
+ value: "/app/config/{{ .Values.seedConnections.configMapKey | default "seed-connections.yaml" }}"
120
+ - name: SEED_CACHE_TTL_MS
121
+ value: {{ .Values.seedConnections.cacheTTL | default 60000 | quote }}
122
+ {{- end }}
123
+ {{- with .Values.extraEnv }}
124
+ {{- toYaml . | nindent 12 }}
125
+ {{- end }}
126
+ {{- with .Values.startupProbe }}
127
+ startupProbe:
128
+ {{- toYaml . | nindent 12 }}
129
+ {{- end }}
130
+ {{- with .Values.readinessProbe }}
131
+ readinessProbe:
132
+ {{- toYaml . | nindent 12 }}
133
+ {{- end }}
134
+ {{- with .Values.livenessProbe }}
135
+ livenessProbe:
136
+ {{- toYaml . | nindent 12 }}
137
+ {{- end }}
138
+ resources:
139
+ {{- toYaml .Values.resources | nindent 12 }}
140
+ volumeMounts:
141
+ - name: next-cache
142
+ mountPath: /app/.next/cache
143
+ - name: tmp
144
+ mountPath: /tmp
145
+ {{- if include "libredb-studio.persistenceEnabled" . }}
146
+ - name: data
147
+ mountPath: /app/data
148
+ {{- end }}
149
+ {{- if .Values.seedConnections.enabled }}
150
+ - name: seed-config
151
+ mountPath: /app/config
152
+ readOnly: true
153
+ {{- end }}
154
+ volumes:
155
+ - name: next-cache
156
+ emptyDir: {}
157
+ - name: tmp
158
+ emptyDir: {}
159
+ {{- if include "libredb-studio.persistenceEnabled" . }}
160
+ - name: data
161
+ persistentVolumeClaim:
162
+ claimName: {{ include "libredb-studio.pvcName" . }}
163
+ {{- end }}
164
+ {{- if .Values.seedConnections.enabled }}
165
+ - name: seed-config
166
+ configMap:
167
+ name: {{ .Values.seedConnections.existingConfigMap | default (printf "%s-seed-connections" (include "libredb-studio.fullname" .)) }}
168
+ {{- end }}
169
+ {{- with .Values.nodeSelector }}
170
+ nodeSelector:
171
+ {{- toYaml . | nindent 8 }}
172
+ {{- end }}
173
+ {{- with .Values.affinity }}
174
+ affinity:
175
+ {{- toYaml . | nindent 8 }}
176
+ {{- end }}
177
+ {{- with .Values.tolerations }}
178
+ tolerations:
179
+ {{- toYaml . | nindent 8 }}
180
+ {{- end }}
181
+ {{- with .Values.topologySpreadConstraints }}
182
+ topologySpreadConstraints:
183
+ {{- toYaml . | nindent 8 }}
184
+ {{- end }}