@malloy-publisher/server 0.0.235 → 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 (301) hide show
  1. package/dist/app/api-doc.yaml +47 -17
  2. package/dist/package_load_worker.mjs +8 -1
  3. package/dist/server.mjs +471 -54
  4. package/package.json +5 -2
  5. package/.eslintrc.json +0 -44
  6. package/.prettierignore +0 -1
  7. package/.prettierrc +0 -4
  8. package/build.ts +0 -97
  9. package/eslint.config.mjs +0 -76
  10. package/k6-tests/README.md +0 -144
  11. package/k6-tests/bun.lock +0 -797
  12. package/k6-tests/load-test/load-test-crud-connections.ts +0 -263
  13. package/k6-tests/load-test/load-test-crud-packages.ts +0 -461
  14. package/k6-tests/load-test/load-test-crud-projects.ts +0 -160
  15. package/k6-tests/load-test/load-test-crud.ts +0 -142
  16. package/k6-tests/load-test/load-test.ts +0 -784
  17. package/k6-tests/package.json +0 -27
  18. package/k6-tests/scripts/run-with-otel.sh +0 -50
  19. package/k6-tests/smoke-test/smoke-test.ts +0 -158
  20. package/k6-tests/tsconfig.json +0 -29
  21. package/k6-tests/utils/client_factory.ts +0 -128
  22. package/k6-tests/utils/common.ts +0 -489
  23. package/k6-tests/utils/logger.ts +0 -62
  24. package/k6-tests/utils/types.d.ts +0 -35
  25. package/malloy_mcp.dxt +0 -0
  26. package/publisher.config.example.bigquery.json +0 -33
  27. package/publisher.config.example.duckdb.json +0 -23
  28. package/publisher.config.json +0 -23
  29. package/scripts/bake-duckdb-extensions.js +0 -110
  30. package/src/config.spec.ts +0 -1535
  31. package/src/config.theme.spec.ts +0 -178
  32. package/src/config.ts +0 -1142
  33. package/src/constants.ts +0 -105
  34. package/src/controller/compile.controller.ts +0 -40
  35. package/src/controller/connection.controller.spec.ts +0 -849
  36. package/src/controller/connection.controller.ts +0 -901
  37. package/src/controller/database.controller.ts +0 -24
  38. package/src/controller/materialization.controller.spec.ts +0 -293
  39. package/src/controller/materialization.controller.ts +0 -319
  40. package/src/controller/model.controller.ts +0 -164
  41. package/src/controller/package.controller.spec.ts +0 -273
  42. package/src/controller/package.controller.ts +0 -306
  43. package/src/controller/query.controller.ts +0 -152
  44. package/src/controller/theme.controller.ts +0 -83
  45. package/src/controller/watch-mode.controller.ts +0 -243
  46. package/src/data_styles.ts +0 -71
  47. package/src/default-publisher.config.json +0 -23
  48. package/src/ducklake_version.spec.ts +0 -163
  49. package/src/ducklake_version.ts +0 -153
  50. package/src/errors.spec.ts +0 -119
  51. package/src/errors.ts +0 -237
  52. package/src/filter_deprecation.spec.ts +0 -64
  53. package/src/filter_deprecation.ts +0 -42
  54. package/src/health.spec.ts +0 -123
  55. package/src/health.ts +0 -233
  56. package/src/heap_check.spec.ts +0 -144
  57. package/src/heap_check.ts +0 -144
  58. package/src/instrumentation.ts +0 -214
  59. package/src/json_utils.spec.ts +0 -51
  60. package/src/json_utils.ts +0 -33
  61. package/src/logger.spec.ts +0 -210
  62. package/src/logger.ts +0 -251
  63. package/src/malloy_pin_prereqs.spec.ts +0 -25
  64. package/src/materialization_metrics.spec.ts +0 -169
  65. package/src/materialization_metrics.ts +0 -346
  66. package/src/mcp/error_messages.spec.ts +0 -35
  67. package/src/mcp/error_messages.ts +0 -183
  68. package/src/mcp/handler_utils.spec.ts +0 -108
  69. package/src/mcp/handler_utils.ts +0 -251
  70. package/src/mcp/mcp_constants.ts +0 -6
  71. package/src/mcp/query_envelope.spec.ts +0 -229
  72. package/src/mcp/query_envelope.ts +0 -240
  73. package/src/mcp/server.protocol.spec.ts +0 -250
  74. package/src/mcp/server.ts +0 -87
  75. package/src/mcp/skills/build_skills_bundle.spec.ts +0 -51
  76. package/src/mcp/skills/build_skills_bundle.ts +0 -176
  77. package/src/mcp/skills/skills_bundle.json +0 -1
  78. package/src/mcp/skills/skills_bundle.spec.ts +0 -171
  79. package/src/mcp/tool_response.spec.ts +0 -108
  80. package/src/mcp/tool_response.ts +0 -138
  81. package/src/mcp/tools/compile_tool.spec.ts +0 -315
  82. package/src/mcp/tools/compile_tool.ts +0 -208
  83. package/src/mcp/tools/docs_search/build_docs_index.ts +0 -132
  84. package/src/mcp/tools/docs_search/malloy_docs_index.json +0 -1
  85. package/src/mcp/tools/docs_search_tool.spec.ts +0 -32
  86. package/src/mcp/tools/docs_search_tool.ts +0 -128
  87. package/src/mcp/tools/embedding_index.spec.ts +0 -1236
  88. package/src/mcp/tools/embedding_index.ts +0 -808
  89. package/src/mcp/tools/execute_query_tool.spec.ts +0 -294
  90. package/src/mcp/tools/execute_query_tool.ts +0 -316
  91. package/src/mcp/tools/get_context_eval.ts +0 -275
  92. package/src/mcp/tools/get_context_tool.spec.ts +0 -592
  93. package/src/mcp/tools/get_context_tool.ts +0 -585
  94. package/src/mcp/tools/reload_package_tool.spec.ts +0 -232
  95. package/src/mcp/tools/reload_package_tool.ts +0 -132
  96. package/src/mcp_config.spec.ts +0 -919
  97. package/src/mcp_config.ts +0 -425
  98. package/src/oom_guards.integration.spec.ts +0 -269
  99. package/src/package_load/package_load_pool.spec.ts +0 -252
  100. package/src/package_load/package_load_pool.ts +0 -931
  101. package/src/package_load/package_load_worker.ts +0 -1034
  102. package/src/package_load/protocol.ts +0 -364
  103. package/src/package_load/rpc_wait_accountant.spec.ts +0 -109
  104. package/src/package_load/rpc_wait_accountant.ts +0 -76
  105. package/src/package_load_metrics.spec.ts +0 -114
  106. package/src/package_load_metrics.ts +0 -127
  107. package/src/path_safety.spec.ts +0 -158
  108. package/src/path_safety.ts +0 -146
  109. package/src/pg_helpers.spec.ts +0 -223
  110. package/src/pg_helpers.ts +0 -52
  111. package/src/query_cap_metrics.spec.ts +0 -89
  112. package/src/query_cap_metrics.ts +0 -116
  113. package/src/query_concurrency.spec.ts +0 -247
  114. package/src/query_concurrency.ts +0 -237
  115. package/src/query_metadata_metrics.ts +0 -49
  116. package/src/query_param_utils.ts +0 -29
  117. package/src/query_timeout.spec.ts +0 -224
  118. package/src/query_timeout.ts +0 -179
  119. package/src/runtime/publisher.js +0 -328
  120. package/src/server-old.ts +0 -988
  121. package/src/server.ts +0 -2059
  122. package/src/service/annotations.spec.ts +0 -118
  123. package/src/service/annotations.ts +0 -91
  124. package/src/service/authorize.spec.ts +0 -154
  125. package/src/service/authorize.ts +0 -498
  126. package/src/service/authorize_integration.spec.ts +0 -2041
  127. package/src/service/build_plan.spec.ts +0 -685
  128. package/src/service/build_plan.ts +0 -797
  129. package/src/service/compile_authorize.spec.ts +0 -85
  130. package/src/service/compile_fragment_techniques.spec.ts +0 -156
  131. package/src/service/connection.spec.ts +0 -2360
  132. package/src/service/connection.ts +0 -2187
  133. package/src/service/connection_config.spec.ts +0 -734
  134. package/src/service/connection_config.ts +0 -899
  135. package/src/service/connection_federation.spec.ts +0 -184
  136. package/src/service/connection_fingerprint.spec.ts +0 -102
  137. package/src/service/connection_service.spec.ts +0 -711
  138. package/src/service/connection_service.ts +0 -291
  139. package/src/service/cron_evaluator.spec.ts +0 -79
  140. package/src/service/cron_evaluator.ts +0 -105
  141. package/src/service/db_utils.spec.ts +0 -1085
  142. package/src/service/db_utils.ts +0 -1502
  143. package/src/service/duckdb_instance_isolation.spec.ts +0 -137
  144. package/src/service/ducklake_lazy_attach.spec.ts +0 -110
  145. package/src/service/embedding_provider.spec.ts +0 -329
  146. package/src/service/embedding_provider.ts +0 -236
  147. package/src/service/environment.ts +0 -2191
  148. package/src/service/environment_admission.spec.ts +0 -344
  149. package/src/service/environment_compile.spec.ts +0 -197
  150. package/src/service/environment_store.spec.ts +0 -2274
  151. package/src/service/environment_store.ts +0 -2434
  152. package/src/service/environment_store_anchoring.spec.ts +0 -107
  153. package/src/service/environment_store_clone.spec.ts +0 -350
  154. package/src/service/explore_visibility.spec.ts +0 -434
  155. package/src/service/exports_probe.spec.ts +0 -107
  156. package/src/service/extension_fetch_policy.spec.ts +0 -256
  157. package/src/service/filter.spec.ts +0 -458
  158. package/src/service/filter.ts +0 -341
  159. package/src/service/filter_bypass.spec.ts +0 -418
  160. package/src/service/filter_integration.spec.ts +0 -1004
  161. package/src/service/freshness.spec.ts +0 -183
  162. package/src/service/freshness.ts +0 -112
  163. package/src/service/gcs_s3_utils.ts +0 -427
  164. package/src/service/given.ts +0 -105
  165. package/src/service/givens_integration.spec.ts +0 -219
  166. package/src/service/manifest_loader.spec.ts +0 -189
  167. package/src/service/manifest_loader.ts +0 -156
  168. package/src/service/materialization_build_session.spec.ts +0 -435
  169. package/src/service/materialization_build_session.ts +0 -681
  170. package/src/service/materialization_config_validation.spec.ts +0 -99
  171. package/src/service/materialization_config_validation.ts +0 -120
  172. package/src/service/materialization_eligibility.spec.ts +0 -158
  173. package/src/service/materialization_eligibility.ts +0 -305
  174. package/src/service/materialization_schedule_surface.spec.ts +0 -256
  175. package/src/service/materialization_scheduler.spec.ts +0 -289
  176. package/src/service/materialization_scheduler.ts +0 -304
  177. package/src/service/materialization_serve_transform.spec.ts +0 -1003
  178. package/src/service/materialization_serve_transform.ts +0 -779
  179. package/src/service/materialization_service.spec.ts +0 -2373
  180. package/src/service/materialization_service.ts +0 -2342
  181. package/src/service/materialization_test_fixtures.ts +0 -249
  182. package/src/service/model.spec.ts +0 -1157
  183. package/src/service/model.ts +0 -3370
  184. package/src/service/model_limits.spec.ts +0 -209
  185. package/src/service/model_limits.ts +0 -131
  186. package/src/service/model_storage_serve.spec.ts +0 -193
  187. package/src/service/model_storage_serve_joins.spec.ts +0 -193
  188. package/src/service/package.spec.ts +0 -612
  189. package/src/service/package.ts +0 -1799
  190. package/src/service/package_manifest.spec.ts +0 -230
  191. package/src/service/package_manifest.ts +0 -241
  192. package/src/service/package_memory_governor.spec.ts +0 -173
  193. package/src/service/package_memory_governor.ts +0 -233
  194. package/src/service/package_quote_bound_tables.spec.ts +0 -171
  195. package/src/service/package_race.spec.ts +0 -208
  196. package/src/service/package_reload_safety.spec.ts +0 -193
  197. package/src/service/package_rollback.spec.ts +0 -190
  198. package/src/service/package_worker_path.spec.ts +0 -645
  199. package/src/service/path_injection.spec.ts +0 -39
  200. package/src/service/persist_annotation_validation.spec.ts +0 -89
  201. package/src/service/persist_annotation_validation.ts +0 -59
  202. package/src/service/persistence_policy.spec.ts +0 -374
  203. package/src/service/proxy.spec.ts +0 -414
  204. package/src/service/proxy.ts +0 -248
  205. package/src/service/query_boundary.spec.ts +0 -470
  206. package/src/service/query_metadata.spec.ts +0 -408
  207. package/src/service/query_metadata.ts +0 -492
  208. package/src/service/query_metadata_identity.spec.ts +0 -149
  209. package/src/service/query_text.spec.ts +0 -79
  210. package/src/service/query_text.ts +0 -43
  211. package/src/service/quoting.spec.ts +0 -135
  212. package/src/service/quoting.ts +0 -78
  213. package/src/service/resolve_environment.ts +0 -15
  214. package/src/service/restricted_mode.spec.ts +0 -299
  215. package/src/service/source_extraction.ts +0 -225
  216. package/src/service/theme_store.ts +0 -199
  217. package/src/storage/DatabaseInterface.ts +0 -198
  218. package/src/storage/StorageManager.ts +0 -113
  219. package/src/storage/duckdb/ConnectionRepository.ts +0 -143
  220. package/src/storage/duckdb/DuckDBConnection.ts +0 -123
  221. package/src/storage/duckdb/DuckDBRepository.ts +0 -208
  222. package/src/storage/duckdb/EnvironmentRepository.ts +0 -148
  223. package/src/storage/duckdb/MaterializationRepository.spec.ts +0 -191
  224. package/src/storage/duckdb/MaterializationRepository.ts +0 -336
  225. package/src/storage/duckdb/PackageRepository.ts +0 -135
  226. package/src/storage/duckdb/schema.ts +0 -229
  227. package/src/stream_helpers.spec.ts +0 -280
  228. package/src/stream_helpers.ts +0 -162
  229. package/src/telemetry.ts +0 -20
  230. package/src/test_helpers/metrics_harness.ts +0 -166
  231. package/src/theme_key_parity.spec.ts +0 -57
  232. package/src/utils.ts +0 -29
  233. package/tests/fixtures/authorize-compile/model.malloy +0 -9
  234. package/tests/fixtures/authorize-compile/publisher.json +0 -4
  235. package/tests/fixtures/html-pages-nopublic/model.malloy +0 -1
  236. package/tests/fixtures/html-pages-nopublic/publisher.json +0 -5
  237. package/tests/fixtures/html-pages-test/data.csv +0 -3
  238. package/tests/fixtures/html-pages-test/public/assets/app.css +0 -3
  239. package/tests/fixtures/html-pages-test/public/barehtml.html +0 -4
  240. package/tests/fixtures/html-pages-test/public/bodymeta.html +0 -8
  241. package/tests/fixtures/html-pages-test/public/data.json +0 -1
  242. package/tests/fixtures/html-pages-test/public/fitcomment.html +0 -11
  243. package/tests/fixtures/html-pages-test/public/index.html +0 -9
  244. package/tests/fixtures/html-pages-test/public/nohead.html +0 -8
  245. package/tests/fixtures/html-pages-test/public/notfit.html +0 -13
  246. package/tests/fixtures/html-pages-test/public/slides.html +0 -12
  247. package/tests/fixtures/html-pages-test/public/sub/page2.html +0 -9
  248. package/tests/fixtures/html-pages-test/public/unterminated.html +0 -10
  249. package/tests/fixtures/html-pages-test/publisher.json +0 -5
  250. package/tests/fixtures/html-pages-test/report.malloy +0 -1
  251. package/tests/fixtures/persist-multi-level/data/orders.csv +0 -5
  252. package/tests/fixtures/persist-multi-level/multi_level.malloy +0 -18
  253. package/tests/fixtures/persist-multi-level/publisher.json +0 -5
  254. package/tests/fixtures/persist-schedule-test/data/orders.csv +0 -5
  255. package/tests/fixtures/persist-schedule-test/persist_schedule_test.malloy +0 -11
  256. package/tests/fixtures/persist-schedule-test/publisher.json +0 -7
  257. package/tests/fixtures/persist-schedule-warn-test/data/orders.csv +0 -5
  258. package/tests/fixtures/persist-schedule-warn-test/persist_warn_test.malloy +0 -11
  259. package/tests/fixtures/persist-schedule-warn-test/publisher.json +0 -6
  260. package/tests/fixtures/persist-test/data/orders.csv +0 -5
  261. package/tests/fixtures/persist-test/persist_test.malloy +0 -11
  262. package/tests/fixtures/persist-test/publisher.json +0 -5
  263. package/tests/fixtures/publisher.config.json +0 -15
  264. package/tests/fixtures/query-givens/data/orders.csv +0 -7
  265. package/tests/fixtures/query-givens/model.malloy +0 -34
  266. package/tests/fixtures/query-givens/publisher.json +0 -5
  267. package/tests/fixtures/xlsx/database.xlsx +0 -0
  268. package/tests/harness/mcp_test_setup.ts +0 -332
  269. package/tests/harness/rest_e2e.ts +0 -68
  270. package/tests/integration/authorize/compile_authorize_http.integration.spec.ts +0 -92
  271. package/tests/integration/concurrent_package/concurrent_package.integration.spec.ts +0 -280
  272. package/tests/integration/duckdb_storage/duckdb_storage.integration.spec.ts +0 -138
  273. package/tests/integration/first_boot/readiness_line.integration.spec.ts +0 -177
  274. package/tests/integration/html_pages/html_pages.integration.spec.ts +0 -440
  275. package/tests/integration/legacy_routes/legacy_routes.integration.spec.ts +0 -259
  276. package/tests/integration/materialization/environment_list.integration.spec.ts +0 -133
  277. package/tests/integration/materialization/freshness_gate.integration.spec.ts +0 -292
  278. package/tests/integration/materialization/manifest_binding.integration.spec.ts +0 -430
  279. package/tests/integration/materialization/materialization_lifecycle.integration.spec.ts +0 -441
  280. package/tests/integration/materialization/orchestrated_rebind.integration.spec.ts +0 -150
  281. package/tests/integration/materialization/reference_manifest.integration.spec.ts +0 -251
  282. package/tests/integration/materialization/schedule_edit.integration.spec.ts +0 -126
  283. package/tests/integration/materialization/scheduler.integration.spec.ts +0 -200
  284. package/tests/integration/materialization/scheduler_recovery.integration.spec.ts +0 -172
  285. package/tests/integration/materialization/scheduler_transitions.integration.spec.ts +0 -256
  286. package/tests/integration/materialization/scheduler_wiring.integration.spec.ts +0 -143
  287. package/tests/integration/mcp/mcp_execute_query_tool.integration.spec.ts +0 -438
  288. package/tests/integration/mcp/mcp_get_context_semantic.integration.spec.ts +0 -235
  289. package/tests/integration/mcp/mcp_transport.integration.spec.ts +0 -98
  290. package/tests/integration/query_givens/query_givens.integration.spec.ts +0 -146
  291. package/tests/integration/query_givens/query_givens_authorize.integration.spec.ts +0 -121
  292. package/tests/integration/sdk_givens/sdk_givens.integration.spec.ts +0 -110
  293. package/tests/integration/watch-mode/watch_mode.integration.spec.ts +0 -421
  294. package/tests/unit/controller/theme.controller.spec.ts +0 -141
  295. package/tests/unit/duckdb/attached_databases.test.ts +0 -1243
  296. package/tests/unit/duckdb/duckdb_connection.test.ts +0 -181
  297. package/tests/unit/duckdb/legacy_schema_migration.test.ts +0 -197
  298. package/tests/unit/duckdb/repositories.test.ts +0 -208
  299. package/tests/unit/ducklake/ducklake.test.ts +0 -952
  300. package/tests/unit/service/theme_store.spec.ts +0 -139
  301. package/tsconfig.json +0 -32
@@ -1,11 +0,0 @@
1
- ##! experimental.persistence
2
-
3
- source: raw_orders is duckdb.table('data/orders.csv')
4
-
5
- #@ persist name="order_summary"
6
- source: order_summary is raw_orders -> {
7
- group_by: category
8
- aggregate:
9
- total_orders is count()
10
- total_revenue is amount.sum()
11
- }
@@ -1,6 +0,0 @@
1
- {
2
- "name": "persist-schedule-warn-test",
3
- "version": "1.0.0",
4
- "description": "DuckDB persist fixture with a schedule but no version scope — a load-tolerated persistence-policy warning (schedule requires scope: version)",
5
- "materialization": { "schedule": "0 6 * * *" }
6
- }
@@ -1,5 +0,0 @@
1
- category,amount
2
- electronics,100
3
- clothing,50
4
- electronics,200
5
- clothing,75
@@ -1,11 +0,0 @@
1
- ##! experimental.persistence
2
-
3
- source: raw_orders is duckdb.table('data/orders.csv')
4
-
5
- #@ persist name="order_summary"
6
- source: order_summary is raw_orders -> {
7
- group_by: category
8
- aggregate:
9
- total_orders is count()
10
- total_revenue is amount.sum()
11
- }
@@ -1,5 +0,0 @@
1
- {
2
- "name": "persist-test",
3
- "version": "1.0.0",
4
- "description": "DuckDB persist test fixture"
5
- }
@@ -1,15 +0,0 @@
1
- {
2
- "frozenConfig": false,
3
- "environments": [
4
- {
5
- "name": "test-project",
6
- "packages": [
7
- {
8
- "name": "persist-test",
9
- "location": "./persist-test"
10
- }
11
- ],
12
- "connections": []
13
- }
14
- ]
15
- }
@@ -1,7 +0,0 @@
1
- id,region,status,amount
2
- 1,US,active,100
3
- 2,US,active,200
4
- 3,US,cancelled,50
5
- 4,EU,active,300
6
- 5,EU,cancelled,400
7
- 6,EU,active,500
@@ -1,34 +0,0 @@
1
- ##! experimental.givens
2
-
3
- given: target_region :: string is 'US'
4
- given: min_amount :: number is 0
5
- given: role :: string is 'guest'
6
-
7
- #(filter) dimension=status type=equal
8
- source: orders is duckdb.table('data/orders.csv') extend {
9
- primary_key: id
10
-
11
- measure:
12
- order_count is count()
13
-
14
- view: by_given_region is {
15
- where: region = $target_region and amount >= $min_amount
16
- aggregate: order_count
17
- }
18
- }
19
-
20
- // Gated variant for authorize-interaction coverage: only $role = 'admin' may
21
- // read it. Shares the givens above so we can prove the name-vs-value-vs-authorize
22
- // status matrix on a gated source.
23
- #(authorize) "$role = 'admin'"
24
- source: gated_orders is duckdb.table('data/orders.csv') extend {
25
- primary_key: id
26
-
27
- measure:
28
- order_count is count()
29
-
30
- view: by_given_region is {
31
- where: region = $target_region and amount >= $min_amount
32
- aggregate: order_count
33
- }
34
- }
@@ -1,5 +0,0 @@
1
- {
2
- "name": "query-givens",
3
- "version": "1.0.0",
4
- "description": "Fixture for /query givens forwarding (server + SDK)"
5
- }
Binary file
@@ -1,332 +0,0 @@
1
- import { Client } from "@modelcontextprotocol/sdk/client/index.js";
2
- import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
3
- import {
4
- Notification,
5
- Request,
6
- Result,
7
- } from "@modelcontextprotocol/sdk/types.js";
8
- import { Mutex } from "async-mutex";
9
- import http from "http";
10
- import { AddressInfo } from "net";
11
- import path from "path";
12
- import { fileURLToPath } from "url";
13
- import { URL } from "url";
14
-
15
- // --- Real Server Import ---
16
- // Import the actual configured Express app instance
17
-
18
- // --- E2E Test Environment Setup ---
19
-
20
- export interface McpE2ETestEnvironment {
21
- httpServer: http.Server;
22
- serverUrl: string;
23
- mcpClient: Client<Request, Notification, Result>;
24
- originalServerRoot: string | undefined;
25
- originalInitializeStorage: string | undefined;
26
- }
27
-
28
- // Counter for unique port assignment per test suite (incremented only under e2eSetupMutex)
29
- let portCounter = 0;
30
-
31
- // True mutex: the previous Promise-based lock had a TOCTOU race where two beforeAll hooks
32
- // could both pass the `if (initializationLock)` check and run setup concurrently, sharing
33
- // one publisher.db / server singleton and causing flaky tool calls and port collisions.
34
- const e2eSetupMutex = new Mutex();
35
-
36
- /**
37
- * Starts the real application server and connects a real MCP client.
38
- */
39
- export async function setupE2ETestEnvironment(): Promise<McpE2ETestEnvironment> {
40
- return e2eSetupMutex.runExclusive(async () => {
41
- console.log(
42
- "[E2E Test Setup] Acquired setup mutex; starting environment...",
43
- );
44
- return setupE2ETestEnvironmentInternal();
45
- });
46
- }
47
-
48
- async function setupE2ETestEnvironmentInternal(): Promise<McpE2ETestEnvironment> {
49
- // --- Store and Set SERVER_ROOT Env Var ---
50
- // The EnvironmentStore relies on SERVER_ROOT to find publisher.config.json.
51
- const originalServerRoot = process.env.SERVER_ROOT; // Store original value
52
- // Resolve the path to 'packages/server' based on the location of this file
53
- // Use import.meta.url for cross-platform compatibility (works on Windows)
54
- const __filename = fileURLToPath(import.meta.url);
55
- const __dirname = path.dirname(__filename);
56
- const serverPackageDir = path.resolve(__dirname, "../../"); // Go up two levels from .../packages/server/tests/harness
57
- process.env.SERVER_ROOT = serverPackageDir;
58
- console.log(
59
- `[E2E Test Setup] Temporarily set SERVER_ROOT=${process.env.SERVER_ROOT}`,
60
- );
61
-
62
- // --- Set INITIALIZE_STORAGE to ensure packages are downloaded ---
63
- // This ensures packages from GitHub are cloned/downloaded during initialization
64
- const originalInitializeStorage = process.env.INITIALIZE_STORAGE; // Store original value
65
- process.env.INITIALIZE_STORAGE = "true";
66
- console.log(
67
- `[E2E Test Setup] Temporarily set INITIALIZE_STORAGE=${process.env.INITIALIZE_STORAGE}`,
68
- );
69
-
70
- // --- IMPORTANT: Import server *after* setting env var ---
71
- // Dynamically import the actual app instance
72
- const { mcpApp } = await import("../../src/server");
73
-
74
- let serverInstance: http.Server;
75
- let serverUrl: string;
76
-
77
- // Use unique port per test suite to avoid conflicts when running in parallel
78
- // Increment port counter and use it to create unique ports: 4042, 4043, 4044, etc.
79
- const portOffset = portCounter++;
80
- const TEST_MCP_PORT = Number(process.env.MCP_PORT || 4040) + 2 + portOffset;
81
-
82
- await new Promise<void>((resolve, reject) => {
83
- const server = http
84
- .createServer(mcpApp)
85
- .listen(TEST_MCP_PORT, "127.0.0.1", () => {
86
- // Use explicit TEST_MCP_PORT
87
- try {
88
- const address = server.address() as AddressInfo;
89
- if (!address)
90
- throw new Error("Server address is null after listen");
91
- serverInstance = server;
92
- serverUrl = `http://127.0.0.1:${TEST_MCP_PORT}`;
93
- console.log(
94
- `[E2E Test Setup] Real server (using mcpApp) listening on ${serverUrl} (Port: ${TEST_MCP_PORT})`,
95
- );
96
- resolve();
97
- } catch (err) {
98
- reject(err);
99
- }
100
- });
101
- server.on("error", (err: NodeJS.ErrnoException) => {
102
- // Provide more specific error info if available (like EADDRINUSE)
103
- console.error(
104
- `[E2E Test Setup] Server failed to start on port ${TEST_MCP_PORT}: ${err.code} - ${err.message}`,
105
- );
106
- reject(err);
107
- });
108
- });
109
-
110
- // Ensure serverInstance and serverUrl are assigned
111
- const listeningServerInstance = serverInstance!;
112
- const listeningServerUrl = serverUrl!;
113
-
114
- // --- Wait a moment for server to start accepting connections ---
115
- console.log("[E2E Test Setup] Waiting for server to accept connections...");
116
- await new Promise((resolve) => setTimeout(resolve, 1000));
117
-
118
- // --- Wait for server to be ready (packages downloaded) ---
119
- // Poll the readiness endpoint to ensure initialization completes before tests run
120
- // Allow >90s: cold CI can spend most of the budget on clone + package load before markReady().
121
- console.log("[E2E Test Setup] Waiting for server to be ready...");
122
- const maxWaitTime = 150000; // 150 seconds (INITIALIZE_STORAGE + large samples can be slow)
123
- const pollInterval = 1000; // Check every second
124
- const startTime = Date.now();
125
- let isReady = false;
126
-
127
- while (!isReady && Date.now() - startTime < maxWaitTime) {
128
- try {
129
- // Use Promise.race to add timeout to fetch
130
- const fetchPromise = fetch(`${listeningServerUrl}/health/readiness`);
131
- const timeoutPromise = new Promise<never>((_, reject) =>
132
- setTimeout(() => reject(new Error("Fetch timeout")), 5000),
133
- );
134
- const response = await Promise.race([fetchPromise, timeoutPromise]);
135
-
136
- if (response.ok) {
137
- const data = await response.json();
138
- if (data.status === "UP") {
139
- isReady = true;
140
- console.log("[E2E Test Setup] Server is ready.");
141
- break;
142
- } else {
143
- console.log(
144
- `[E2E Test Setup] Server not ready yet (status: ${data.status}), waiting... (${Math.round((Date.now() - startTime) / 1000)}s)`,
145
- );
146
- }
147
- } else {
148
- console.log(
149
- `[E2E Test Setup] Readiness check returned ${response.status}, waiting... (${Math.round((Date.now() - startTime) / 1000)}s)`,
150
- );
151
- }
152
- } catch (error) {
153
- // Server might not be ready yet, continue polling
154
- const errorMsg =
155
- error instanceof Error ? error.message : String(error);
156
- // Only log every 5 seconds to reduce noise
157
- const elapsed = Math.round((Date.now() - startTime) / 1000);
158
- if (elapsed % 5 === 0) {
159
- console.log(
160
- `[E2E Test Setup] Readiness check failed (${errorMsg}), waiting... (${elapsed}s)`,
161
- );
162
- }
163
- }
164
- await new Promise((resolve) => setTimeout(resolve, pollInterval));
165
- }
166
-
167
- if (!isReady) {
168
- // Cleanup before throwing
169
- if (listeningServerInstance?.listening) {
170
- listeningServerInstance.closeAllConnections?.();
171
- await new Promise<void>((res) =>
172
- listeningServerInstance.close(() => res()),
173
- );
174
- }
175
- throw new Error(
176
- `Server did not become ready within ${maxWaitTime / 1000} seconds. Package downloads may have failed.`,
177
- );
178
- }
179
-
180
- // --- Client Setup ---
181
- const mcpClient = new Client<Request, Notification, Result>({
182
- name: "mcp-e2e-test-client",
183
- version: "1.0",
184
- });
185
-
186
- // Use StreamableHTTPClientTransport, connecting to the base URL + /mcp endpoint
187
- const mcpEndpointPath = "/mcp"; // Matches the endpoint used in server.ts
188
- const clientTransport = new StreamableHTTPClientTransport(
189
- new URL(`${listeningServerUrl}${mcpEndpointPath}`),
190
- );
191
-
192
- // Connect client (with timeout)
193
- console.log(
194
- `[E2E Test Setup] Connecting MCP client to ${listeningServerUrl}${mcpEndpointPath} ...`,
195
- );
196
- let connectTimeout: NodeJS.Timeout | null = null;
197
- try {
198
- const connectPromise = mcpClient.connect(clientTransport);
199
- const timeoutPromise = new Promise((_, reject) => {
200
- connectTimeout = setTimeout(() => {
201
- reject(
202
- new Error("[E2E Test Setup] Client connection timeout (5s)"),
203
- );
204
- }, 5000);
205
- });
206
- await Promise.race([connectPromise, timeoutPromise]);
207
- console.log("[E2E Test Setup] MCP client connected.");
208
- } catch (error) {
209
- console.error("[E2E Test Setup] MCP Client connection failed:", error);
210
- // Attempt cleanup even if connection failed
211
- await mcpClient
212
- ?.close()
213
- .catch(() =>
214
- console.error("[E2E Test Setup] Error closing failed client:"),
215
- );
216
- if (listeningServerInstance?.listening) {
217
- listeningServerInstance.closeAllConnections?.(); // Force close connections
218
- await new Promise<void>((res) =>
219
- listeningServerInstance.close(() => res()),
220
- );
221
- }
222
- throw error;
223
- } finally {
224
- if (connectTimeout) clearTimeout(connectTimeout);
225
- }
226
-
227
- // --- Return Environment ---
228
- return {
229
- httpServer: listeningServerInstance,
230
- serverUrl: listeningServerUrl,
231
- mcpClient,
232
- originalServerRoot,
233
- originalInitializeStorage,
234
- };
235
- }
236
-
237
- /**
238
- * Cleans up the E2E test environment by closing the client and server.
239
- */
240
- export async function cleanupE2ETestEnvironment(
241
- env: McpE2ETestEnvironment | null,
242
- ): Promise<void> {
243
- if (!env) {
244
- // Attempt cleanup even if env is null (e.g., setup failed after config creation)
245
- return;
246
- }
247
-
248
- // --- Restore Original SERVER_ROOT and INITIALIZE_STORAGE ---
249
- // Restore the original SERVER_ROOT value after tests are complete.
250
- const { originalServerRoot, originalInitializeStorage } = env;
251
- if (originalServerRoot === undefined) {
252
- delete process.env.SERVER_ROOT;
253
- console.log("[E2E Test Cleanup] Restored SERVER_ROOT (deleted)");
254
- } else {
255
- process.env.SERVER_ROOT = originalServerRoot;
256
- console.log(
257
- `[E2E Test Cleanup] Restored SERVER_ROOT=${process.env.SERVER_ROOT}`,
258
- );
259
- }
260
-
261
- // Restore the original INITIALIZE_STORAGE value after tests are complete.
262
- if (originalInitializeStorage === undefined) {
263
- delete process.env.INITIALIZE_STORAGE;
264
- console.log("[E2E Test Cleanup] Restored INITIALIZE_STORAGE (deleted)");
265
- } else {
266
- process.env.INITIALIZE_STORAGE = originalInitializeStorage;
267
- console.log(
268
- `[E2E Test Cleanup] Restored INITIALIZE_STORAGE=${process.env.INITIALIZE_STORAGE}`,
269
- );
270
- }
271
-
272
- const { mcpClient, httpServer } = env;
273
-
274
- // 1. Close client first (with timeout)
275
- if (mcpClient) {
276
- try {
277
- const closePromise = mcpClient.close();
278
- const timeoutPromise = new Promise<void>((_, reject) => {
279
- setTimeout(() => reject(new Error("Client close timeout")), 5000);
280
- });
281
- await Promise.race([closePromise, timeoutPromise]);
282
- } catch (error) {
283
- // Ignore client close errors during cleanup potentially
284
- console.warn(
285
- "[E2E Test Cleanup] Error closing MCP client (ignoring):",
286
- error instanceof Error ? error.message : String(error),
287
- );
288
- }
289
- }
290
-
291
- // 2. Close HTTP server connections and then the server itself (with timeout)
292
- if (httpServer) {
293
- // Force close any remaining connections immediately
294
- httpServer.closeAllConnections?.();
295
-
296
- if (httpServer.listening) {
297
- try {
298
- const closePromise = new Promise<void>((resolve, reject) => {
299
- const timeout = setTimeout(() => {
300
- reject(new Error("Server close timeout"));
301
- }, 5000);
302
- httpServer.close((err: NodeJS.ErrnoException | undefined) => {
303
- clearTimeout(timeout);
304
- if (err && err.code !== "ERR_SERVER_NOT_RUNNING") {
305
- console.error(
306
- "[E2E Test Cleanup] Error closing HTTP server (after closing connections):",
307
- err,
308
- );
309
- } else if (!err) {
310
- console.log("[E2E Test Cleanup] HTTP server closed.");
311
- }
312
- resolve();
313
- });
314
- });
315
- await closePromise;
316
- } catch (error) {
317
- console.warn(
318
- "[E2E Test Cleanup] Server close timeout or error (forcing close):",
319
- error instanceof Error ? error.message : String(error),
320
- );
321
- // Force destroy if close times out
322
- if (httpServer.listening) {
323
- httpServer.closeAllConnections?.();
324
- }
325
- }
326
- } else {
327
- console.log(
328
- "[E2E Test Cleanup] HTTP server was not listening or already closed.",
329
- );
330
- }
331
- }
332
- }
@@ -1,68 +0,0 @@
1
- import http from "http";
2
-
3
- export interface RestE2EEnv {
4
- httpServer: http.Server;
5
- baseUrl: string;
6
- }
7
-
8
- /**
9
- * Spin up an HTTP server wrapping the real Express REST app.
10
- *
11
- * Works regardless of which test file first imported server.ts —
12
- * reuses the cached Express app and binds on an OS-assigned port
13
- * to avoid collisions.
14
- *
15
- * Callers are responsible for creating any test-specific environments
16
- * via the REST API (POST /api/v0/environments) and cleaning them up.
17
- */
18
- export async function startRestE2E(): Promise<
19
- RestE2EEnv & { stop(): Promise<void> }
20
- > {
21
- const { app } = await import("../../src/server");
22
-
23
- const httpServer: http.Server = await new Promise<http.Server>(
24
- (resolve, reject) => {
25
- const srv = http
26
- .createServer(app)
27
- .listen(0, "127.0.0.1", () => resolve(srv));
28
- srv.on("error", (err: NodeJS.ErrnoException) => {
29
- console.error("[REST E2E] server listen error", err);
30
- reject(err);
31
- });
32
- },
33
- );
34
-
35
- const addr = httpServer.address() as { port: number };
36
- const baseUrl = `http://127.0.0.1:${addr.port}`;
37
-
38
- const maxWait = 180_000;
39
- const start = Date.now();
40
- let ready = false;
41
- while (!ready && Date.now() - start < maxWait) {
42
- try {
43
- const res = await fetch(`${baseUrl}/health/readiness`);
44
- if (res.ok) {
45
- const data = (await res.json()) as { status: string };
46
- if (data.status === "UP") {
47
- ready = true;
48
- break;
49
- }
50
- }
51
- } catch {
52
- // server not ready yet
53
- }
54
- await new Promise((r) => setTimeout(r, 500));
55
- }
56
- if (!ready) {
57
- httpServer.closeAllConnections?.();
58
- await new Promise<void>((r) => httpServer.close(() => r()));
59
- throw new Error("REST E2E server did not become ready in time");
60
- }
61
-
62
- const stop = async (): Promise<void> => {
63
- httpServer.closeAllConnections?.();
64
- await new Promise<void>((r) => httpServer.close(() => r()));
65
- };
66
-
67
- return { httpServer, baseUrl, stop };
68
- }
@@ -1,92 +0,0 @@
1
- import { afterAll, beforeAll, describe, expect, it } from "bun:test";
2
- import path from "path";
3
- import { fileURLToPath } from "url";
4
- import { type RestE2EEnv, startRestE2E } from "../../harness/rest_e2e";
5
-
6
- // HTTP end-to-end for the /compile authorize gate: proves AccessDeniedError
7
- // surfaces as a real 403 body through the express route + internalErrorToHttpError,
8
- // and that the 403 names only the source (never the gate expression).
9
-
10
- const __dirname = path.dirname(fileURLToPath(import.meta.url));
11
- const PROJECT = "authorize-compile-test-project";
12
- const PKG = "authorize-compile";
13
- const MODEL = "model.malloy";
14
-
15
- describe("compile authorize gate (HTTP E2E)", () => {
16
- let env: (RestE2EEnv & { stop(): Promise<void> }) | null = null;
17
- let baseUrl: string;
18
-
19
- beforeAll(async () => {
20
- env = await startRestE2E();
21
- baseUrl = env.baseUrl;
22
- const fixtureDir = path.resolve(
23
- __dirname,
24
- "../../fixtures/authorize-compile",
25
- );
26
- const createRes = await fetch(`${baseUrl}/api/v0/projects`, {
27
- method: "POST",
28
- headers: { "Content-Type": "application/json" },
29
- body: JSON.stringify({
30
- name: PROJECT,
31
- packages: [{ name: PKG, location: fixtureDir }],
32
- connections: [],
33
- }),
34
- });
35
- if (!createRes.ok) {
36
- throw new Error(
37
- `Failed to create test project (${createRes.status}): ${await createRes.text()}`,
38
- );
39
- }
40
- const deadline = Date.now() + 30_000;
41
- while (Date.now() < deadline) {
42
- const res = await fetch(
43
- `${baseUrl}/api/v0/projects/${PROJECT}/packages/${PKG}`,
44
- );
45
- if (res.ok) break;
46
- await new Promise((r) => setTimeout(r, 250));
47
- }
48
- });
49
-
50
- afterAll(async () => {
51
- await env?.stop();
52
- });
53
-
54
- const compile = (body: unknown) =>
55
- fetch(
56
- `${baseUrl}/api/v0/environments/${PROJECT}/packages/${PKG}/models/${MODEL}/compile`,
57
- {
58
- method: "POST",
59
- headers: { "Content-Type": "application/json" },
60
- body: JSON.stringify(body),
61
- },
62
- );
63
-
64
- it("returns 403 with a source-only message when the gate is not satisfied", async () => {
65
- const res = await compile({
66
- source: "run: gated -> { aggregate: c }",
67
- givens: {},
68
- });
69
- expect(res.status).toBe(403);
70
- const json = (await res.json()) as { code: number; message: string };
71
- expect(json.code).toBe(403);
72
- expect(json.message).toBe('Access denied for source "gated".');
73
- // Redaction: the runtime 403 must NOT leak the authorize expression.
74
- expect(json.message).not.toContain("ROLE");
75
- expect(json.message).not.toContain("analyst");
76
- });
77
-
78
- it("returns 200 when a satisfying given is supplied", async () => {
79
- const res = await compile({
80
- source: "run: gated -> { aggregate: c }",
81
- givens: { ROLE: "analyst" },
82
- });
83
- expect(res.status).toBe(200);
84
- });
85
-
86
- it("compiles an ungated source without any given", async () => {
87
- const res = await compile({
88
- source: "run: open_src -> { aggregate: c }",
89
- });
90
- expect(res.status).toBe(200);
91
- });
92
- });