@malloy-publisher/server 0.0.234 → 0.0.236

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 (318) hide show
  1. package/dist/app/api-doc.yaml +47 -17
  2. package/dist/app/assets/{EnvironmentPage-DTZQ4Gxc.js → EnvironmentPage-BsAnavYN.js} +1 -1
  3. package/dist/app/assets/{HomePage-C5mlDPXK.js → HomePage-CADE138j.js} +1 -1
  4. package/dist/app/assets/{LightMode-DGNmhG0u.js → LightMode-Cfh7KzN8.js} +1 -1
  5. package/dist/app/assets/{MainPage-CVL_wmP4.js → MainPage-CO3pRlnV.js} +1 -1
  6. package/dist/app/assets/{MaterializationsPage-DmzMBCpy.js → MaterializationsPage-p9YjkRXZ.js} +1 -1
  7. package/dist/app/assets/{ModelPage-Dbvf4QbB.js → ModelPage-C1OSTv-x.js} +1 -1
  8. package/dist/app/assets/{PackagePage-DxdHc2Qs.js → PackagePage-e4kN75YR.js} +1 -1
  9. package/dist/app/assets/{RouteError-OJdT4tCd.js → RouteError-CzbfOkng.js} +1 -1
  10. package/dist/app/assets/{ThemeEditorPage-Bk7s0KXY.js → ThemeEditorPage-CciagFTq.js} +1 -1
  11. package/dist/app/assets/{WorkbookPage-j_vCWdN3.js → WorkbookPage-DNWmkCXa.js} +1 -1
  12. package/dist/app/assets/{core-Rj_4rRnA.es-DoIfLxDJ.js → core-Rj_4rRnA.es-BZyvITuO.js} +1 -1
  13. package/dist/app/assets/{index-B_jKMR35.js → index-CH2AcDzc.js} +4 -4
  14. package/dist/app/assets/{index-hw-xn0X7.js → index-DQa463gC.js} +2 -2
  15. package/dist/app/assets/{index-DWIe_hK0.js → index-DQpV7MyA.js} +1 -1
  16. package/dist/app/assets/{index-BabP-V-S.js → index-DzaYbhnD.js} +1 -1
  17. package/dist/app/assets/{index-D-rDyK11.js → index-VBbcc8s6.js} +1 -1
  18. package/dist/app/index.html +1 -1
  19. package/dist/package_load_worker.mjs +8 -1
  20. package/dist/server.mjs +471 -54
  21. package/package.json +16 -13
  22. package/.eslintrc.json +0 -44
  23. package/.prettierignore +0 -1
  24. package/.prettierrc +0 -4
  25. package/build.ts +0 -97
  26. package/eslint.config.mjs +0 -76
  27. package/k6-tests/README.md +0 -144
  28. package/k6-tests/bun.lock +0 -797
  29. package/k6-tests/load-test/load-test-crud-connections.ts +0 -263
  30. package/k6-tests/load-test/load-test-crud-packages.ts +0 -461
  31. package/k6-tests/load-test/load-test-crud-projects.ts +0 -160
  32. package/k6-tests/load-test/load-test-crud.ts +0 -142
  33. package/k6-tests/load-test/load-test.ts +0 -784
  34. package/k6-tests/package.json +0 -27
  35. package/k6-tests/scripts/run-with-otel.sh +0 -50
  36. package/k6-tests/smoke-test/smoke-test.ts +0 -158
  37. package/k6-tests/tsconfig.json +0 -29
  38. package/k6-tests/utils/client_factory.ts +0 -128
  39. package/k6-tests/utils/common.ts +0 -489
  40. package/k6-tests/utils/logger.ts +0 -62
  41. package/k6-tests/utils/types.d.ts +0 -35
  42. package/malloy_mcp.dxt +0 -0
  43. package/publisher.config.example.bigquery.json +0 -33
  44. package/publisher.config.example.duckdb.json +0 -23
  45. package/publisher.config.json +0 -23
  46. package/scripts/bake-duckdb-extensions.js +0 -110
  47. package/src/config.spec.ts +0 -1535
  48. package/src/config.theme.spec.ts +0 -178
  49. package/src/config.ts +0 -1142
  50. package/src/constants.ts +0 -105
  51. package/src/controller/compile.controller.ts +0 -40
  52. package/src/controller/connection.controller.spec.ts +0 -849
  53. package/src/controller/connection.controller.ts +0 -901
  54. package/src/controller/database.controller.ts +0 -24
  55. package/src/controller/materialization.controller.spec.ts +0 -293
  56. package/src/controller/materialization.controller.ts +0 -319
  57. package/src/controller/model.controller.ts +0 -164
  58. package/src/controller/package.controller.spec.ts +0 -273
  59. package/src/controller/package.controller.ts +0 -306
  60. package/src/controller/query.controller.ts +0 -152
  61. package/src/controller/theme.controller.ts +0 -83
  62. package/src/controller/watch-mode.controller.ts +0 -243
  63. package/src/data_styles.ts +0 -71
  64. package/src/default-publisher.config.json +0 -23
  65. package/src/ducklake_version.spec.ts +0 -163
  66. package/src/ducklake_version.ts +0 -153
  67. package/src/errors.spec.ts +0 -119
  68. package/src/errors.ts +0 -237
  69. package/src/filter_deprecation.spec.ts +0 -64
  70. package/src/filter_deprecation.ts +0 -42
  71. package/src/health.spec.ts +0 -123
  72. package/src/health.ts +0 -233
  73. package/src/heap_check.spec.ts +0 -144
  74. package/src/heap_check.ts +0 -144
  75. package/src/instrumentation.ts +0 -214
  76. package/src/json_utils.spec.ts +0 -51
  77. package/src/json_utils.ts +0 -33
  78. package/src/logger.spec.ts +0 -210
  79. package/src/logger.ts +0 -251
  80. package/src/malloy_pin_prereqs.spec.ts +0 -25
  81. package/src/materialization_metrics.spec.ts +0 -169
  82. package/src/materialization_metrics.ts +0 -346
  83. package/src/mcp/error_messages.spec.ts +0 -35
  84. package/src/mcp/error_messages.ts +0 -183
  85. package/src/mcp/handler_utils.spec.ts +0 -108
  86. package/src/mcp/handler_utils.ts +0 -251
  87. package/src/mcp/mcp_constants.ts +0 -6
  88. package/src/mcp/query_envelope.spec.ts +0 -229
  89. package/src/mcp/query_envelope.ts +0 -240
  90. package/src/mcp/server.protocol.spec.ts +0 -250
  91. package/src/mcp/server.ts +0 -87
  92. package/src/mcp/skills/build_skills_bundle.spec.ts +0 -51
  93. package/src/mcp/skills/build_skills_bundle.ts +0 -176
  94. package/src/mcp/skills/skills_bundle.json +0 -1
  95. package/src/mcp/skills/skills_bundle.spec.ts +0 -171
  96. package/src/mcp/tool_response.spec.ts +0 -108
  97. package/src/mcp/tool_response.ts +0 -138
  98. package/src/mcp/tools/compile_tool.spec.ts +0 -315
  99. package/src/mcp/tools/compile_tool.ts +0 -208
  100. package/src/mcp/tools/docs_search/build_docs_index.ts +0 -132
  101. package/src/mcp/tools/docs_search/malloy_docs_index.json +0 -1
  102. package/src/mcp/tools/docs_search_tool.spec.ts +0 -32
  103. package/src/mcp/tools/docs_search_tool.ts +0 -128
  104. package/src/mcp/tools/embedding_index.spec.ts +0 -1236
  105. package/src/mcp/tools/embedding_index.ts +0 -808
  106. package/src/mcp/tools/execute_query_tool.spec.ts +0 -294
  107. package/src/mcp/tools/execute_query_tool.ts +0 -316
  108. package/src/mcp/tools/get_context_eval.ts +0 -275
  109. package/src/mcp/tools/get_context_tool.spec.ts +0 -592
  110. package/src/mcp/tools/get_context_tool.ts +0 -585
  111. package/src/mcp/tools/reload_package_tool.spec.ts +0 -232
  112. package/src/mcp/tools/reload_package_tool.ts +0 -132
  113. package/src/mcp_config.spec.ts +0 -919
  114. package/src/mcp_config.ts +0 -425
  115. package/src/oom_guards.integration.spec.ts +0 -269
  116. package/src/package_load/package_load_pool.spec.ts +0 -252
  117. package/src/package_load/package_load_pool.ts +0 -931
  118. package/src/package_load/package_load_worker.ts +0 -1034
  119. package/src/package_load/protocol.ts +0 -364
  120. package/src/package_load/rpc_wait_accountant.spec.ts +0 -109
  121. package/src/package_load/rpc_wait_accountant.ts +0 -76
  122. package/src/package_load_metrics.spec.ts +0 -114
  123. package/src/package_load_metrics.ts +0 -127
  124. package/src/path_safety.spec.ts +0 -158
  125. package/src/path_safety.ts +0 -146
  126. package/src/pg_helpers.spec.ts +0 -223
  127. package/src/pg_helpers.ts +0 -52
  128. package/src/query_cap_metrics.spec.ts +0 -89
  129. package/src/query_cap_metrics.ts +0 -116
  130. package/src/query_concurrency.spec.ts +0 -247
  131. package/src/query_concurrency.ts +0 -237
  132. package/src/query_metadata_metrics.ts +0 -49
  133. package/src/query_param_utils.ts +0 -29
  134. package/src/query_timeout.spec.ts +0 -224
  135. package/src/query_timeout.ts +0 -179
  136. package/src/runtime/publisher.js +0 -328
  137. package/src/server-old.ts +0 -988
  138. package/src/server.ts +0 -2059
  139. package/src/service/annotations.spec.ts +0 -118
  140. package/src/service/annotations.ts +0 -91
  141. package/src/service/authorize.spec.ts +0 -154
  142. package/src/service/authorize.ts +0 -498
  143. package/src/service/authorize_integration.spec.ts +0 -2041
  144. package/src/service/build_plan.spec.ts +0 -685
  145. package/src/service/build_plan.ts +0 -797
  146. package/src/service/compile_authorize.spec.ts +0 -85
  147. package/src/service/compile_fragment_techniques.spec.ts +0 -156
  148. package/src/service/connection.spec.ts +0 -2360
  149. package/src/service/connection.ts +0 -2187
  150. package/src/service/connection_config.spec.ts +0 -734
  151. package/src/service/connection_config.ts +0 -899
  152. package/src/service/connection_federation.spec.ts +0 -184
  153. package/src/service/connection_fingerprint.spec.ts +0 -102
  154. package/src/service/connection_service.spec.ts +0 -711
  155. package/src/service/connection_service.ts +0 -291
  156. package/src/service/cron_evaluator.spec.ts +0 -79
  157. package/src/service/cron_evaluator.ts +0 -105
  158. package/src/service/db_utils.spec.ts +0 -1085
  159. package/src/service/db_utils.ts +0 -1502
  160. package/src/service/duckdb_instance_isolation.spec.ts +0 -137
  161. package/src/service/ducklake_lazy_attach.spec.ts +0 -110
  162. package/src/service/embedding_provider.spec.ts +0 -329
  163. package/src/service/embedding_provider.ts +0 -236
  164. package/src/service/environment.ts +0 -2191
  165. package/src/service/environment_admission.spec.ts +0 -344
  166. package/src/service/environment_compile.spec.ts +0 -197
  167. package/src/service/environment_store.spec.ts +0 -2274
  168. package/src/service/environment_store.ts +0 -2434
  169. package/src/service/environment_store_anchoring.spec.ts +0 -107
  170. package/src/service/environment_store_clone.spec.ts +0 -350
  171. package/src/service/explore_visibility.spec.ts +0 -434
  172. package/src/service/exports_probe.spec.ts +0 -107
  173. package/src/service/extension_fetch_policy.spec.ts +0 -256
  174. package/src/service/filter.spec.ts +0 -458
  175. package/src/service/filter.ts +0 -341
  176. package/src/service/filter_bypass.spec.ts +0 -418
  177. package/src/service/filter_integration.spec.ts +0 -1004
  178. package/src/service/freshness.spec.ts +0 -183
  179. package/src/service/freshness.ts +0 -112
  180. package/src/service/gcs_s3_utils.ts +0 -427
  181. package/src/service/given.ts +0 -105
  182. package/src/service/givens_integration.spec.ts +0 -219
  183. package/src/service/manifest_loader.spec.ts +0 -189
  184. package/src/service/manifest_loader.ts +0 -156
  185. package/src/service/materialization_build_session.spec.ts +0 -435
  186. package/src/service/materialization_build_session.ts +0 -681
  187. package/src/service/materialization_config_validation.spec.ts +0 -99
  188. package/src/service/materialization_config_validation.ts +0 -120
  189. package/src/service/materialization_eligibility.spec.ts +0 -158
  190. package/src/service/materialization_eligibility.ts +0 -305
  191. package/src/service/materialization_schedule_surface.spec.ts +0 -256
  192. package/src/service/materialization_scheduler.spec.ts +0 -289
  193. package/src/service/materialization_scheduler.ts +0 -304
  194. package/src/service/materialization_serve_transform.spec.ts +0 -1003
  195. package/src/service/materialization_serve_transform.ts +0 -779
  196. package/src/service/materialization_service.spec.ts +0 -2373
  197. package/src/service/materialization_service.ts +0 -2342
  198. package/src/service/materialization_test_fixtures.ts +0 -249
  199. package/src/service/model.spec.ts +0 -1157
  200. package/src/service/model.ts +0 -3370
  201. package/src/service/model_limits.spec.ts +0 -209
  202. package/src/service/model_limits.ts +0 -131
  203. package/src/service/model_storage_serve.spec.ts +0 -193
  204. package/src/service/model_storage_serve_joins.spec.ts +0 -193
  205. package/src/service/package.spec.ts +0 -612
  206. package/src/service/package.ts +0 -1799
  207. package/src/service/package_manifest.spec.ts +0 -230
  208. package/src/service/package_manifest.ts +0 -241
  209. package/src/service/package_memory_governor.spec.ts +0 -173
  210. package/src/service/package_memory_governor.ts +0 -233
  211. package/src/service/package_quote_bound_tables.spec.ts +0 -171
  212. package/src/service/package_race.spec.ts +0 -208
  213. package/src/service/package_reload_safety.spec.ts +0 -193
  214. package/src/service/package_rollback.spec.ts +0 -190
  215. package/src/service/package_worker_path.spec.ts +0 -645
  216. package/src/service/path_injection.spec.ts +0 -39
  217. package/src/service/persist_annotation_validation.spec.ts +0 -89
  218. package/src/service/persist_annotation_validation.ts +0 -59
  219. package/src/service/persistence_policy.spec.ts +0 -374
  220. package/src/service/proxy.spec.ts +0 -414
  221. package/src/service/proxy.ts +0 -248
  222. package/src/service/query_boundary.spec.ts +0 -470
  223. package/src/service/query_metadata.spec.ts +0 -408
  224. package/src/service/query_metadata.ts +0 -492
  225. package/src/service/query_metadata_identity.spec.ts +0 -149
  226. package/src/service/query_text.spec.ts +0 -79
  227. package/src/service/query_text.ts +0 -43
  228. package/src/service/quoting.spec.ts +0 -135
  229. package/src/service/quoting.ts +0 -78
  230. package/src/service/resolve_environment.ts +0 -15
  231. package/src/service/restricted_mode.spec.ts +0 -299
  232. package/src/service/source_extraction.ts +0 -225
  233. package/src/service/theme_store.ts +0 -199
  234. package/src/storage/DatabaseInterface.ts +0 -198
  235. package/src/storage/StorageManager.ts +0 -113
  236. package/src/storage/duckdb/ConnectionRepository.ts +0 -143
  237. package/src/storage/duckdb/DuckDBConnection.ts +0 -123
  238. package/src/storage/duckdb/DuckDBRepository.ts +0 -208
  239. package/src/storage/duckdb/EnvironmentRepository.ts +0 -148
  240. package/src/storage/duckdb/MaterializationRepository.spec.ts +0 -191
  241. package/src/storage/duckdb/MaterializationRepository.ts +0 -336
  242. package/src/storage/duckdb/PackageRepository.ts +0 -135
  243. package/src/storage/duckdb/schema.ts +0 -229
  244. package/src/stream_helpers.spec.ts +0 -280
  245. package/src/stream_helpers.ts +0 -162
  246. package/src/telemetry.ts +0 -20
  247. package/src/test_helpers/metrics_harness.ts +0 -166
  248. package/src/theme_key_parity.spec.ts +0 -57
  249. package/src/utils.ts +0 -29
  250. package/tests/fixtures/authorize-compile/model.malloy +0 -9
  251. package/tests/fixtures/authorize-compile/publisher.json +0 -4
  252. package/tests/fixtures/html-pages-nopublic/model.malloy +0 -1
  253. package/tests/fixtures/html-pages-nopublic/publisher.json +0 -5
  254. package/tests/fixtures/html-pages-test/data.csv +0 -3
  255. package/tests/fixtures/html-pages-test/public/assets/app.css +0 -3
  256. package/tests/fixtures/html-pages-test/public/barehtml.html +0 -4
  257. package/tests/fixtures/html-pages-test/public/bodymeta.html +0 -8
  258. package/tests/fixtures/html-pages-test/public/data.json +0 -1
  259. package/tests/fixtures/html-pages-test/public/fitcomment.html +0 -11
  260. package/tests/fixtures/html-pages-test/public/index.html +0 -9
  261. package/tests/fixtures/html-pages-test/public/nohead.html +0 -8
  262. package/tests/fixtures/html-pages-test/public/notfit.html +0 -13
  263. package/tests/fixtures/html-pages-test/public/slides.html +0 -12
  264. package/tests/fixtures/html-pages-test/public/sub/page2.html +0 -9
  265. package/tests/fixtures/html-pages-test/public/unterminated.html +0 -10
  266. package/tests/fixtures/html-pages-test/publisher.json +0 -5
  267. package/tests/fixtures/html-pages-test/report.malloy +0 -1
  268. package/tests/fixtures/persist-multi-level/data/orders.csv +0 -5
  269. package/tests/fixtures/persist-multi-level/multi_level.malloy +0 -18
  270. package/tests/fixtures/persist-multi-level/publisher.json +0 -5
  271. package/tests/fixtures/persist-schedule-test/data/orders.csv +0 -5
  272. package/tests/fixtures/persist-schedule-test/persist_schedule_test.malloy +0 -11
  273. package/tests/fixtures/persist-schedule-test/publisher.json +0 -7
  274. package/tests/fixtures/persist-schedule-warn-test/data/orders.csv +0 -5
  275. package/tests/fixtures/persist-schedule-warn-test/persist_warn_test.malloy +0 -11
  276. package/tests/fixtures/persist-schedule-warn-test/publisher.json +0 -6
  277. package/tests/fixtures/persist-test/data/orders.csv +0 -5
  278. package/tests/fixtures/persist-test/persist_test.malloy +0 -11
  279. package/tests/fixtures/persist-test/publisher.json +0 -5
  280. package/tests/fixtures/publisher.config.json +0 -15
  281. package/tests/fixtures/query-givens/data/orders.csv +0 -7
  282. package/tests/fixtures/query-givens/model.malloy +0 -34
  283. package/tests/fixtures/query-givens/publisher.json +0 -5
  284. package/tests/fixtures/xlsx/database.xlsx +0 -0
  285. package/tests/harness/mcp_test_setup.ts +0 -332
  286. package/tests/harness/rest_e2e.ts +0 -68
  287. package/tests/integration/authorize/compile_authorize_http.integration.spec.ts +0 -92
  288. package/tests/integration/concurrent_package/concurrent_package.integration.spec.ts +0 -280
  289. package/tests/integration/duckdb_storage/duckdb_storage.integration.spec.ts +0 -138
  290. package/tests/integration/first_boot/readiness_line.integration.spec.ts +0 -177
  291. package/tests/integration/html_pages/html_pages.integration.spec.ts +0 -440
  292. package/tests/integration/legacy_routes/legacy_routes.integration.spec.ts +0 -259
  293. package/tests/integration/materialization/environment_list.integration.spec.ts +0 -133
  294. package/tests/integration/materialization/freshness_gate.integration.spec.ts +0 -292
  295. package/tests/integration/materialization/manifest_binding.integration.spec.ts +0 -430
  296. package/tests/integration/materialization/materialization_lifecycle.integration.spec.ts +0 -441
  297. package/tests/integration/materialization/orchestrated_rebind.integration.spec.ts +0 -150
  298. package/tests/integration/materialization/reference_manifest.integration.spec.ts +0 -251
  299. package/tests/integration/materialization/schedule_edit.integration.spec.ts +0 -126
  300. package/tests/integration/materialization/scheduler.integration.spec.ts +0 -200
  301. package/tests/integration/materialization/scheduler_recovery.integration.spec.ts +0 -172
  302. package/tests/integration/materialization/scheduler_transitions.integration.spec.ts +0 -256
  303. package/tests/integration/materialization/scheduler_wiring.integration.spec.ts +0 -143
  304. package/tests/integration/mcp/mcp_execute_query_tool.integration.spec.ts +0 -438
  305. package/tests/integration/mcp/mcp_get_context_semantic.integration.spec.ts +0 -235
  306. package/tests/integration/mcp/mcp_transport.integration.spec.ts +0 -98
  307. package/tests/integration/query_givens/query_givens.integration.spec.ts +0 -146
  308. package/tests/integration/query_givens/query_givens_authorize.integration.spec.ts +0 -121
  309. package/tests/integration/sdk_givens/sdk_givens.integration.spec.ts +0 -110
  310. package/tests/integration/watch-mode/watch_mode.integration.spec.ts +0 -421
  311. package/tests/unit/controller/theme.controller.spec.ts +0 -141
  312. package/tests/unit/duckdb/attached_databases.test.ts +0 -1243
  313. package/tests/unit/duckdb/duckdb_connection.test.ts +0 -181
  314. package/tests/unit/duckdb/legacy_schema_migration.test.ts +0 -197
  315. package/tests/unit/duckdb/repositories.test.ts +0 -208
  316. package/tests/unit/ducklake/ducklake.test.ts +0 -952
  317. package/tests/unit/service/theme_store.spec.ts +0 -139
  318. package/tsconfig.json +0 -32
@@ -1,291 +0,0 @@
1
- import { components } from "../api";
2
- import { ConnectionNotFoundError, FrozenConfigError } from "../errors";
3
- import { logger } from "../logger";
4
- import { buildEnvironmentMalloyConfig } from "./connection";
5
- import { EnvironmentStore } from "./environment_store";
6
-
7
- type ApiConnection = components["schemas"]["Connection"];
8
- type ReleaseCallback = () => Promise<void>;
9
- type ConnectionUpdateEnvironment = {
10
- runConnectionUpdateExclusive?: <T>(fn: () => Promise<T>) => Promise<T>;
11
- updateConnections?: (
12
- nextMalloyConfig: ReturnType<typeof buildEnvironmentMalloyConfig>,
13
- apiConnections?: ApiConnection[],
14
- afterPreviousRelease?: ReleaseCallback,
15
- ) => void;
16
- deleteConnection?: (connectionName: string) => Promise<void>;
17
- deleteDuckDBConnection?: (connectionName: string) => Promise<void>;
18
- deleteDuckLakeConnection?: (connectionName: string) => Promise<void>;
19
- };
20
-
21
- async function runEnvironmentConnectionUpdate<T>(
22
- environment: ConnectionUpdateEnvironment,
23
- fn: () => Promise<T>,
24
- ): Promise<T> {
25
- if (environment.runConnectionUpdateExclusive) {
26
- return environment.runConnectionUpdateExclusive(fn);
27
- }
28
- return fn();
29
- }
30
-
31
- function updateEnvironmentConnections(
32
- environment: ConnectionUpdateEnvironment,
33
- nextMalloyConfig: ReturnType<typeof buildEnvironmentMalloyConfig>,
34
- afterPreviousRelease?: ReleaseCallback,
35
- ): void {
36
- environment.updateConnections?.(
37
- nextMalloyConfig,
38
- nextMalloyConfig.apiConnections,
39
- afterPreviousRelease,
40
- );
41
- }
42
-
43
- function buildDeletedConnectionCleanup(
44
- environment: ConnectionUpdateEnvironment,
45
- deletedConnection: ApiConnection,
46
- connectionName: string,
47
- ): ReleaseCallback | undefined {
48
- if (
49
- deletedConnection.type === "duckdb" &&
50
- typeof environment.deleteDuckDBConnection === "function"
51
- ) {
52
- return () => environment.deleteDuckDBConnection!(connectionName);
53
- }
54
-
55
- if (
56
- deletedConnection.type === "ducklake" &&
57
- typeof environment.deleteDuckLakeConnection === "function"
58
- ) {
59
- return () => environment.deleteDuckLakeConnection!(connectionName);
60
- }
61
-
62
- return undefined;
63
- }
64
-
65
- export class ConnectionService {
66
- private environmentStore: EnvironmentStore;
67
-
68
- constructor(environmentStore: EnvironmentStore) {
69
- this.environmentStore = environmentStore;
70
- }
71
-
72
- public async getConnection(environmentName: string, connectionName: string) {
73
- await this.environmentStore.finishedInitialization;
74
-
75
- const repository = this.environmentStore.storageManager.getRepository();
76
- const dbEnvironment =
77
- await repository.getEnvironmentByName(environmentName);
78
-
79
- if (!dbEnvironment) {
80
- throw new Error(
81
- `Environment "${environmentName}" not found in database`,
82
- );
83
- }
84
-
85
- const dbConnection = await repository.getConnectionByName(
86
- dbEnvironment.id,
87
- connectionName,
88
- );
89
-
90
- if (!dbConnection) {
91
- throw new ConnectionNotFoundError(
92
- `Connection "${connectionName}" not found in environment "${environmentName}"`,
93
- );
94
- }
95
-
96
- return { dbEnvironment, dbConnection, repository };
97
- }
98
-
99
- public async addConnection(
100
- environmentName: string,
101
- connectionName: string,
102
- connection: ApiConnection,
103
- ): Promise<void> {
104
- await this.environmentStore.finishedInitialization;
105
-
106
- if (this.environmentStore.publisherConfigIsFrozen) {
107
- throw new FrozenConfigError();
108
- }
109
-
110
- logger.info(
111
- `Adding connection "${connectionName}" to environment "${environmentName}"`,
112
- );
113
-
114
- // Get database environment record and repository
115
- const repository = this.environmentStore.storageManager.getRepository();
116
- const dbEnvironment =
117
- await repository.getEnvironmentByName(environmentName);
118
-
119
- if (!dbEnvironment) {
120
- throw new Error(
121
- `Environment "${environmentName}" not found in database`,
122
- );
123
- }
124
-
125
- // Check if connection already exists in database
126
- const existingDbConn = await repository.getConnectionByName(
127
- dbEnvironment.id,
128
- connectionName!,
129
- );
130
-
131
- if (existingDbConn) {
132
- throw new Error(
133
- `Connection "${connectionName}" already exists in environment "${environmentName}".`,
134
- );
135
- }
136
-
137
- // Update in-memory connections
138
- const environment = await this.environmentStore.getEnvironment(
139
- environmentName,
140
- false,
141
- );
142
- await runEnvironmentConnectionUpdate(environment, async () => {
143
- const existingConnections = environment.listApiConnections();
144
- const nextMalloyConfig = buildEnvironmentMalloyConfig(
145
- [...existingConnections, connection],
146
- environment.metadata.location || "",
147
- );
148
-
149
- await this.environmentStore.addConnection(
150
- connection,
151
- dbEnvironment.id,
152
- repository,
153
- );
154
-
155
- updateEnvironmentConnections(environment, nextMalloyConfig);
156
- });
157
-
158
- logger.info(
159
- `Successfully added connection "${connection.name}" to environment "${environmentName}"`,
160
- );
161
- }
162
-
163
- public async updateConnection(
164
- environmentName: string,
165
- connectionName: string,
166
- connection: Partial<ApiConnection>,
167
- ): Promise<void> {
168
- await this.environmentStore.finishedInitialization;
169
-
170
- if (this.environmentStore.publisherConfigIsFrozen) {
171
- throw new FrozenConfigError();
172
- }
173
-
174
- logger.info(
175
- `Updating connection "${connectionName}" in environment "${environmentName}"`,
176
- );
177
-
178
- const { dbEnvironment, dbConnection, repository } =
179
- await this.getConnection(environmentName, connectionName);
180
-
181
- // Update in-memory connections
182
- const environment = await this.environmentStore.getEnvironment(
183
- environmentName,
184
- false,
185
- );
186
- await runEnvironmentConnectionUpdate(environment, async () => {
187
- const existingConnections = environment.listApiConnections();
188
-
189
- const updatedConnection = {
190
- ...dbConnection.config,
191
- ...connection,
192
- name: connectionName,
193
- };
194
-
195
- const updatedConnections = existingConnections.map(
196
- (conn: ApiConnection) =>
197
- conn.name === connectionName ? updatedConnection : conn,
198
- );
199
-
200
- // Pass isUpdateConnectionRequest=true so the DuckLake wrapper
201
- // re-attaches against the updated catalog/storage settings instead
202
- // of trusting the prior generation's persisted attach state.
203
- const nextMalloyConfig = buildEnvironmentMalloyConfig(
204
- updatedConnections,
205
- environment.metadata.location || "",
206
- true,
207
- );
208
-
209
- await this.environmentStore.updateConnection(
210
- updatedConnection,
211
- dbEnvironment.id,
212
- repository,
213
- );
214
-
215
- updateEnvironmentConnections(environment, nextMalloyConfig);
216
- });
217
-
218
- logger.info(
219
- `Successfully updated connection "${connectionName}" in environment "${environmentName}"`,
220
- );
221
- }
222
-
223
- public async deleteConnection(
224
- environmentName: string,
225
- connectionName: string,
226
- ): Promise<void> {
227
- await this.environmentStore.finishedInitialization;
228
-
229
- if (this.environmentStore.publisherConfigIsFrozen) {
230
- throw new FrozenConfigError();
231
- }
232
-
233
- logger.info(
234
- `Deleting connection "${connectionName}" from environment "${environmentName}"`,
235
- );
236
-
237
- const { dbConnection, repository } = await this.getConnection(
238
- environmentName,
239
- connectionName,
240
- );
241
-
242
- // Update in-memory connections
243
- const environment = await this.environmentStore.getEnvironment(
244
- environmentName,
245
- false,
246
- );
247
- await runEnvironmentConnectionUpdate(environment, async () => {
248
- if (typeof environment.listApiConnections !== "function") {
249
- if (typeof environment.deleteConnection === "function") {
250
- await environment.deleteConnection(connectionName);
251
- }
252
- await repository.deleteConnection(dbConnection.id);
253
- return;
254
- }
255
-
256
- const deletedConnection =
257
- "getApiConnection" in environment &&
258
- typeof environment.getApiConnection === "function"
259
- ? environment.getApiConnection(connectionName)
260
- : dbConnection.config;
261
- const updatedConnections = environment
262
- .listApiConnections()
263
- .filter(
264
- (connection: ApiConnection) =>
265
- connection.name !== connectionName,
266
- );
267
- const nextMalloyConfig = buildEnvironmentMalloyConfig(
268
- updatedConnections,
269
- environment.metadata.location || "",
270
- );
271
- const deleteConnectionFilesAfterRelease =
272
- buildDeletedConnectionCleanup(
273
- environment,
274
- deletedConnection,
275
- connectionName,
276
- );
277
-
278
- await repository.deleteConnection(dbConnection.id);
279
-
280
- updateEnvironmentConnections(
281
- environment,
282
- nextMalloyConfig,
283
- deleteConnectionFilesAfterRelease,
284
- );
285
- });
286
-
287
- logger.info(
288
- `Successfully deleted connection "${connectionName}" from environment "${environmentName}"`,
289
- );
290
- }
291
- }
@@ -1,79 +0,0 @@
1
- import { describe, expect, it } from "bun:test";
2
- import { CronEvaluator } from "./cron_evaluator";
3
-
4
- describe("CronEvaluator", () => {
5
- const cron = new CronEvaluator();
6
-
7
- describe("isValid", () => {
8
- it("accepts 5-field UNIX crons", () => {
9
- expect(cron.isValid("0 6 * * *")).toBe(true);
10
- expect(cron.isValid("*/15 * * * *")).toBe(true);
11
- expect(cron.isValid("0 0 1 1 *")).toBe(true);
12
- });
13
-
14
- it("rejects a 6-field (seconds) cron — the contract is 5-field", () => {
15
- expect(cron.isValid("0 0 6 * * *")).toBe(false);
16
- });
17
-
18
- it("rejects garbage and empty input", () => {
19
- expect(cron.isValid("not a cron")).toBe(false);
20
- expect(cron.isValid("")).toBe(false);
21
- expect(cron.isValid("* * *")).toBe(false);
22
- // Out-of-range field.
23
- expect(cron.isValid("99 * * * *")).toBe(false);
24
- });
25
-
26
- it("rejects cron-parser / Quartz extensions the UNIX parser lacks", () => {
27
- // These parse under cron-parser but the control plane's cron-utils
28
- // UNIX parser rejects them — pinning the grammar keeps a cron from
29
- // validating locally yet silently never arming in production.
30
- expect(cron.isValid("0 6 L * *")).toBe(false); // last day of month
31
- expect(cron.isValid("0 6 15W * *")).toBe(false); // nearest weekday
32
- expect(cron.isValid("0 6 * * 1#2")).toBe(false); // 2nd Monday
33
- expect(cron.isValid("0 0 ? * *")).toBe(false); // Quartz no-specific
34
- expect(cron.isValid("0 6 LW * *")).toBe(false); // last weekday
35
- });
36
-
37
- it("accepts UNIX month/day names (not mistaken for extensions)", () => {
38
- expect(cron.isValid("0 6 * JUL *")).toBe(true); // JUL contains 'L'
39
- expect(cron.isValid("0 6 * * WED")).toBe(true); // WED contains 'W'
40
- expect(cron.isValid("0 6 * * THU")).toBe(true); // THU contains 'H'
41
- expect(cron.isValid("0 6 * * MON-FRI")).toBe(true);
42
- });
43
- });
44
-
45
- describe("nextAfter (UTC, strictly after)", () => {
46
- it("returns the next daily fire", () => {
47
- const from = new Date("2026-07-13T00:00:00Z");
48
- expect(cron.nextAfter("0 6 * * *", from).toISOString()).toBe(
49
- "2026-07-13T06:00:00.000Z",
50
- );
51
- });
52
-
53
- it("rolls to the next day when the fire time has passed", () => {
54
- const from = new Date("2026-07-13T07:00:00Z");
55
- expect(cron.nextAfter("0 6 * * *", from).toISOString()).toBe(
56
- "2026-07-14T06:00:00.000Z",
57
- );
58
- });
59
-
60
- it("advances strictly past a `from` that lands exactly on a fire", () => {
61
- const from = new Date("2026-07-13T06:00:00Z");
62
- // Strictly after: the 06:00 instant itself is excluded.
63
- expect(cron.nextAfter("0 6 * * *", from).toISOString()).toBe(
64
- "2026-07-14T06:00:00.000Z",
65
- );
66
- });
67
-
68
- it("steps every 15 minutes", () => {
69
- const from = new Date("2026-07-13T09:07:00Z");
70
- expect(cron.nextAfter("*/15 * * * *", from).toISOString()).toBe(
71
- "2026-07-13T09:15:00.000Z",
72
- );
73
- });
74
-
75
- it("throws on an invalid cron (callers guard with isValid)", () => {
76
- expect(() => cron.nextAfter("nope", new Date())).toThrow();
77
- });
78
- });
79
- });
@@ -1,105 +0,0 @@
1
- /**
2
- * Evaluate a 5-field UNIX cron expression, in UTC, for the standalone
3
- * materialization scheduler. Mirrors the control plane's `CronEvaluator`
4
- * semantics (5-field, UTC, "strictly after") so a given `materialization.schedule`
5
- * fires at the same instants whether the publisher runs standalone or the control
6
- * plane drives it.
7
- *
8
- * Thin wrapper over `cron-parser` that pins three policies:
9
- * - **exactly 5 fields** — `cron-parser` also accepts an optional leading
10
- * seconds field (6 fields); the manifest contract is 5-field UNIX cron, so a
11
- * 6-field expression is rejected rather than silently reinterpreted.
12
- * - **plain UNIX grammar** — `cron-parser` accepts extensions (`L` last,
13
- * `W` nearest-weekday, `#` nth-weekday, `?` Quartz no-specific) that the
14
- * control plane's `cron-utils` UNIX parser rejects. Without this pin, an
15
- * expression like `0 6 L * *` would validate and fire locally but, after
16
- * publish, silently never arm in production. Month/day names (JAN, MON-FRI)
17
- * are still allowed.
18
- * - **UTC** — schedules are absolute, never tied to the server's local zone.
19
- */
20
- import { CronExpressionParser } from "cron-parser";
21
-
22
- /** Valid 3-letter month and day-of-week names in UNIX cron. */
23
- const UNIX_CRON_NAMES = new Set([
24
- "JAN",
25
- "FEB",
26
- "MAR",
27
- "APR",
28
- "MAY",
29
- "JUN",
30
- "JUL",
31
- "AUG",
32
- "SEP",
33
- "OCT",
34
- "NOV",
35
- "DEC",
36
- "SUN",
37
- "MON",
38
- "TUE",
39
- "WED",
40
- "THU",
41
- "FRI",
42
- "SAT",
43
- ]);
44
-
45
- export class CronEvaluator {
46
- /** True when `expr` is a syntactically valid 5-field UNIX cron. */
47
- isValid(expr: string): boolean {
48
- if (!this.hasFiveFields(expr) || !this.isPlainUnixGrammar(expr)) {
49
- return false;
50
- }
51
- try {
52
- CronExpressionParser.parse(expr, { tz: "UTC" });
53
- return true;
54
- } catch {
55
- return false;
56
- }
57
- }
58
-
59
- /**
60
- * The next fire instant strictly after `from` (UTC). Throws when `expr` is
61
- * not a valid 5-field cron — callers guard with {@link isValid} (the
62
- * scheduler skips + logs an invalid cron rather than letting it throw in the
63
- * tick).
64
- */
65
- nextAfter(expr: string, from: Date): Date {
66
- if (!this.hasFiveFields(expr) || !this.isPlainUnixGrammar(expr)) {
67
- throw new Error(
68
- `Expected a 5-field UNIX cron, got: ${JSON.stringify(expr)}`,
69
- );
70
- }
71
- return CronExpressionParser.parse(expr, {
72
- currentDate: from,
73
- tz: "UTC",
74
- })
75
- .next()
76
- .toDate();
77
- }
78
-
79
- /** Whitespace-split field count is exactly 5. */
80
- private hasFiveFields(expr: string): boolean {
81
- return typeof expr === "string" && expr.trim().split(/\s+/).length === 5;
82
- }
83
-
84
- /**
85
- * Reject cron-parser / Quartz extensions absent from plain UNIX cron: `#`
86
- * and `?` (never part of a name), and any alphabetic token that is not a
87
- * UNIX month/day name — which catches `L`, `W`, `LW`, `L-3`, `15W`, etc.
88
- * while still allowing named fields like `JUL` or `MON-FRI`.
89
- */
90
- private isPlainUnixGrammar(expr: string): boolean {
91
- for (const field of expr.trim().split(/\s+/)) {
92
- if (/[#?]/.test(field)) return false;
93
- for (const token of field.split(/[,\-/]/)) {
94
- if (token === "" || token === "*") continue;
95
- if (
96
- /[A-Za-z]/.test(token) &&
97
- !UNIX_CRON_NAMES.has(token.toUpperCase())
98
- ) {
99
- return false;
100
- }
101
- }
102
- }
103
- return true;
104
- }
105
- }