@mistriwork/engine 0.0.0 → 1.0.0-rc.11

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/LICENSE +21 -0
  2. package/README.md +16 -1
  3. package/dist/adapters/adapter.d.ts +726 -0
  4. package/dist/adapters/adapter.js +444 -0
  5. package/dist/adapters/cache/cacheStore.d.ts +75 -0
  6. package/dist/adapters/cache/cacheStore.js +160 -0
  7. package/dist/adapters/cache/resp.d.ts +52 -0
  8. package/dist/adapters/cache/resp.js +237 -0
  9. package/dist/adapters/commands/canonicalJson.d.ts +19 -0
  10. package/dist/adapters/commands/canonicalJson.js +154 -0
  11. package/dist/adapters/connect.d.ts +29 -0
  12. package/dist/adapters/connect.js +40 -0
  13. package/dist/adapters/connectionBudget.d.ts +101 -0
  14. package/dist/adapters/connectionBudget.js +128 -0
  15. package/dist/adapters/dbLatency.d.ts +35 -0
  16. package/dist/adapters/dbLatency.js +79 -0
  17. package/dist/adapters/epochCache.d.ts +50 -0
  18. package/dist/adapters/epochCache.js +85 -0
  19. package/dist/adapters/http/egress.d.ts +48 -0
  20. package/dist/adapters/http/egress.js +175 -0
  21. package/dist/adapters/http/httpAdapter.d.ts +71 -0
  22. package/dist/adapters/http/httpAdapter.js +512 -0
  23. package/dist/adapters/http/httpDescription.d.ts +32 -0
  24. package/dist/adapters/http/httpDescription.js +246 -0
  25. package/dist/adapters/http/openapi.d.ts +98 -0
  26. package/dist/adapters/http/openapi.js +487 -0
  27. package/dist/adapters/layoutRefusal.d.ts +24 -0
  28. package/dist/adapters/layoutRefusal.js +35 -0
  29. package/dist/adapters/net/networkPolicy.d.ts +44 -0
  30. package/dist/adapters/net/networkPolicy.js +123 -0
  31. package/dist/adapters/net/untrustedDatabase.d.ts +18 -0
  32. package/dist/adapters/net/untrustedDatabase.js +120 -0
  33. package/dist/adapters/poolAdmission.d.ts +43 -0
  34. package/dist/adapters/poolAdmission.js +184 -0
  35. package/dist/adapters/poolMetrics.d.ts +121 -0
  36. package/dist/adapters/poolMetrics.js +185 -0
  37. package/dist/adapters/postgres.d.ts +441 -0
  38. package/dist/adapters/postgres.js +1841 -0
  39. package/dist/adapters/postgresCatalog.d.ts +107 -0
  40. package/dist/adapters/postgresCatalog.js +421 -0
  41. package/dist/adapters/postgresCatalogDigest.d.ts +30 -0
  42. package/dist/adapters/postgresCatalogDigest.js +93 -0
  43. package/dist/adapters/postgresCatalogRows.d.ts +64 -0
  44. package/dist/adapters/postgresCatalogRows.js +37 -0
  45. package/dist/adapters/postgresDates.d.ts +1 -0
  46. package/dist/adapters/postgresDates.js +39 -0
  47. package/dist/adapters/postgresMaintenance.d.ts +33 -0
  48. package/dist/adapters/postgresMaintenance.js +179 -0
  49. package/dist/adapters/postgresPool.d.ts +255 -0
  50. package/dist/adapters/postgresPool.js +838 -0
  51. package/dist/adapters/postgresPooler.d.ts +28 -0
  52. package/dist/adapters/postgresPooler.js +267 -0
  53. package/dist/adapters/postgresReadCatalog.d.ts +31 -0
  54. package/dist/adapters/postgresReadCatalog.js +226 -0
  55. package/dist/adapters/postgresReadSnapshot.d.ts +46 -0
  56. package/dist/adapters/postgresReadSnapshot.js +133 -0
  57. package/dist/adapters/postgresSchemaEpoch.d.ts +24 -0
  58. package/dist/adapters/postgresSchemaEpoch.js +149 -0
  59. package/dist/adapters/postgresTransactionHandle.d.ts +173 -0
  60. package/dist/adapters/postgresTransactionHandle.js +524 -0
  61. package/dist/adapters/postgresValues.d.ts +30 -0
  62. package/dist/adapters/postgresValues.js +75 -0
  63. package/dist/adapters/postgresWriteAhead.d.ts +47 -0
  64. package/dist/adapters/postgresWriteAhead.js +209 -0
  65. package/dist/adapters/replicas.d.ts +70 -0
  66. package/dist/adapters/replicas.js +208 -0
  67. package/dist/adapters/reservedSql.d.ts +38 -0
  68. package/dist/adapters/reservedSql.js +264 -0
  69. package/dist/adapters/rolePrivileges.d.ts +17 -0
  70. package/dist/adapters/rolePrivileges.js +22 -0
  71. package/dist/adapters/scoped/keyRows.d.ts +65 -0
  72. package/dist/adapters/scoped/keyRows.js +179 -0
  73. package/dist/adapters/scoped/keyTypes.d.ts +34 -0
  74. package/dist/adapters/scoped/keyTypes.js +66 -0
  75. package/dist/adapters/scoped/postgresScopeCatalog.d.ts +34 -0
  76. package/dist/adapters/scoped/postgresScopeCatalog.js +457 -0
  77. package/dist/adapters/scoped/postgresTriggers.d.ts +137 -0
  78. package/dist/adapters/scoped/postgresTriggers.js +1545 -0
  79. package/dist/adapters/scoped/scopeTriggers.d.ts +122 -0
  80. package/dist/adapters/scoped/scopeTriggers.js +131 -0
  81. package/dist/adapters/scoped/scopedCommandOperations.d.ts +5 -0
  82. package/dist/adapters/scoped/scopedCommandOperations.js +48 -0
  83. package/dist/adapters/scoped/scopedReads.d.ts +22 -0
  84. package/dist/adapters/scoped/scopedReads.js +192 -0
  85. package/dist/adapters/scoped/scopedTransaction.d.ts +159 -0
  86. package/dist/adapters/scoped/scopedTransaction.js +547 -0
  87. package/dist/adapters/scoped/sqliteScopeCatalog.d.ts +32 -0
  88. package/dist/adapters/scoped/sqliteScopeCatalog.js +420 -0
  89. package/dist/adapters/scoped/sqliteTriggerSession.d.ts +64 -0
  90. package/dist/adapters/scoped/sqliteTriggerSession.js +245 -0
  91. package/dist/adapters/scoped/sqliteTriggers.d.ts +20 -0
  92. package/dist/adapters/scoped/sqliteTriggers.js +822 -0
  93. package/dist/adapters/scoped/storedText.d.ts +45 -0
  94. package/dist/adapters/scoped/storedText.js +61 -0
  95. package/dist/adapters/scoped/triggerEffects.d.ts +98 -0
  96. package/dist/adapters/scoped/triggerEffects.js +189 -0
  97. package/dist/adapters/scoped/triggerProof.d.ts +124 -0
  98. package/dist/adapters/scoped/triggerProof.js +366 -0
  99. package/dist/adapters/scoped/updateGuard.d.ts +3 -0
  100. package/dist/adapters/scoped/updateGuard.js +40 -0
  101. package/dist/adapters/serverSettings.d.ts +45 -0
  102. package/dist/adapters/serverSettings.js +46 -0
  103. package/dist/adapters/snapshotRead.d.ts +8 -0
  104. package/dist/adapters/snapshotRead.js +37 -0
  105. package/dist/adapters/sqlite.d.ts +273 -0
  106. package/dist/adapters/sqlite.js +1557 -0
  107. package/dist/adapters/sqliteCostlyReads.d.ts +33 -0
  108. package/dist/adapters/sqliteCostlyReads.js +49 -0
  109. package/dist/adapters/sqliteDecimals.d.ts +22 -0
  110. package/dist/adapters/sqliteDecimals.js +51 -0
  111. package/dist/adapters/sqliteHandles.d.ts +43 -0
  112. package/dist/adapters/sqliteHandles.js +143 -0
  113. package/dist/adapters/sqliteStatementProcess.d.ts +29 -0
  114. package/dist/adapters/sqliteStatementProcess.js +131 -0
  115. package/dist/adapters/statementControl.d.ts +34 -0
  116. package/dist/adapters/statementControl.js +90 -0
  117. package/dist/adapters/storeHost.d.ts +133 -0
  118. package/dist/adapters/storeHost.js +13 -0
  119. package/dist/adapters/telemetry/drivers.d.ts +21 -0
  120. package/dist/adapters/telemetry/drivers.js +321 -0
  121. package/dist/adapters/telemetry/metrics.d.ts +63 -0
  122. package/dist/adapters/telemetry/metrics.js +122 -0
  123. package/dist/adapters/telemetry/otlp.d.ts +12 -0
  124. package/dist/adapters/telemetry/otlp.js +320 -0
  125. package/dist/adapters/telemetry/otlpEncode.d.ts +48 -0
  126. package/dist/adapters/telemetry/otlpEncode.js +366 -0
  127. package/dist/adapters/telemetry/otlpEnv.d.ts +1 -0
  128. package/dist/adapters/telemetry/otlpEnv.js +12 -0
  129. package/dist/adapters/telemetry/serverTiming.d.ts +83 -0
  130. package/dist/adapters/telemetry/serverTiming.js +503 -0
  131. package/dist/adapters/telemetry/start.d.ts +10 -0
  132. package/dist/adapters/telemetry/start.js +25 -0
  133. package/dist/adapters/telemetry/statement.d.ts +16 -0
  134. package/dist/adapters/telemetry/statement.js +134 -0
  135. package/dist/adapters/telemetry/trace.d.ts +127 -0
  136. package/dist/adapters/telemetry/trace.js +295 -0
  137. package/dist/adapters/writeAhead.d.ts +27 -0
  138. package/dist/adapters/writeAhead.js +46 -0
  139. package/dist/adapters/writeAttribution.d.ts +18 -0
  140. package/dist/adapters/writeAttribution.js +23 -0
  141. package/dist/adapters/writeCapture.d.ts +80 -0
  142. package/dist/adapters/writeCapture.js +20 -0
  143. package/dist/adapters/writeLanes.d.ts +94 -0
  144. package/dist/adapters/writeLanes.js +232 -0
  145. package/dist/engine.d.ts +15 -0
  146. package/dist/engine.js +13 -0
  147. package/dist/server/auth/credentials.d.ts +61 -0
  148. package/dist/server/auth/credentials.js +260 -0
  149. package/dist/server/cacheService.d.ts +50 -0
  150. package/dist/server/cacheService.js +110 -0
  151. package/dist/server/cli/args.d.ts +182 -0
  152. package/dist/server/cli/args.js +348 -0
  153. package/dist/server/cli/bin.d.ts +5 -0
  154. package/dist/server/cli/bin.js +66 -0
  155. package/dist/server/cli/browser.d.ts +15 -0
  156. package/dist/server/cli/browser.js +37 -0
  157. package/dist/server/cli/config.d.ts +50 -0
  158. package/dist/server/cli/config.js +206 -0
  159. package/dist/server/cli/startup.d.ts +36 -0
  160. package/dist/server/cli/startup.js +128 -0
  161. package/dist/server/cli/startupOptions.d.ts +63 -0
  162. package/dist/server/cli/startupOptions.js +143 -0
  163. package/dist/server/cli/subcommand.d.ts +28 -0
  164. package/dist/server/cli/subcommand.js +32 -0
  165. package/dist/server/cli/usage.d.ts +13 -0
  166. package/dist/server/cli/usage.js +31 -0
  167. package/dist/server/clientHttp.d.ts +184 -0
  168. package/dist/server/clientHttp.js +700 -0
  169. package/dist/server/clientSurface.d.ts +128 -0
  170. package/dist/server/clientSurface.js +182 -0
  171. package/dist/server/columnGrants.d.ts +106 -0
  172. package/dist/server/columnGrants.js +741 -0
  173. package/dist/server/compileCache.d.ts +1 -0
  174. package/dist/server/compileCache.js +30 -0
  175. package/dist/server/config/locations.d.ts +1 -0
  176. package/dist/server/config/locations.js +15 -0
  177. package/dist/server/config/profile.d.ts +123 -0
  178. package/dist/server/config/profile.js +236 -0
  179. package/dist/server/configPaths.d.ts +7 -0
  180. package/dist/server/configPaths.js +34 -0
  181. package/dist/server/configSections.d.ts +64 -0
  182. package/dist/server/configSections.js +72 -0
  183. package/dist/server/connectionRedaction.d.ts +30 -0
  184. package/dist/server/connectionRedaction.js +77 -0
  185. package/dist/server/connections.d.ts +358 -0
  186. package/dist/server/connections.js +988 -0
  187. package/dist/server/constraints.d.ts +82 -0
  188. package/dist/server/constraints.js +169 -0
  189. package/dist/server/demo.d.ts +9 -0
  190. package/dist/server/demo.js +554 -0
  191. package/dist/server/devclient.d.ts +108 -0
  192. package/dist/server/devclient.js +361 -0
  193. package/dist/server/evidence.d.ts +55 -0
  194. package/dist/server/evidence.js +323 -0
  195. package/dist/server/hiddenColumns.d.ts +32 -0
  196. package/dist/server/hiddenColumns.js +244 -0
  197. package/dist/server/http/baselineHeaders.d.ts +24 -0
  198. package/dist/server/http/baselineHeaders.js +12 -0
  199. package/dist/server/http/captured.d.ts +35 -0
  200. package/dist/server/http/captured.js +73 -0
  201. package/dist/server/http/clock.d.ts +1 -0
  202. package/dist/server/http/clock.js +14 -0
  203. package/dist/server/http/connectionSource.d.ts +4 -0
  204. package/dist/server/http/connectionSource.js +48 -0
  205. package/dist/server/http/context.d.ts +189 -0
  206. package/dist/server/http/context.js +11 -0
  207. package/dist/server/http/crawlerText.d.ts +15 -0
  208. package/dist/server/http/crawlerText.js +32 -0
  209. package/dist/server/http/dataRoutes.d.ts +88 -0
  210. package/dist/server/http/dataRoutes.js +137 -0
  211. package/dist/server/http/door.d.ts +57 -0
  212. package/dist/server/http/door.js +39 -0
  213. package/dist/server/http/exportRoute.d.ts +15 -0
  214. package/dist/server/http/exportRoute.js +320 -0
  215. package/dist/server/http/firstPaint.d.ts +108 -0
  216. package/dist/server/http/firstPaint.js +262 -0
  217. package/dist/server/http/httpOperationRoutes.d.ts +11 -0
  218. package/dist/server/http/httpOperationRoutes.js +50 -0
  219. package/dist/server/http/pageReads.d.ts +20 -0
  220. package/dist/server/http/pageReads.js +205 -0
  221. package/dist/server/http/pageRoutes.d.ts +39 -0
  222. package/dist/server/http/pageRoutes.js +291 -0
  223. package/dist/server/http/probes.d.ts +22 -0
  224. package/dist/server/http/probes.js +27 -0
  225. package/dist/server/http/rateLimit.d.ts +131 -0
  226. package/dist/server/http/rateLimit.js +351 -0
  227. package/dist/server/http/readRoutes.d.ts +9 -0
  228. package/dist/server/http/readRoutes.js +131 -0
  229. package/dist/server/http/readRouting.d.ts +20 -0
  230. package/dist/server/http/readRouting.js +80 -0
  231. package/dist/server/http/recordCompose.d.ts +67 -0
  232. package/dist/server/http/recordCompose.js +167 -0
  233. package/dist/server/http/recordWrites.d.ts +89 -0
  234. package/dist/server/http/recordWrites.js +298 -0
  235. package/dist/server/http/refusalReport.d.ts +38 -0
  236. package/dist/server/http/refusalReport.js +75 -0
  237. package/dist/server/http/reply.d.ts +130 -0
  238. package/dist/server/http/reply.js +394 -0
  239. package/dist/server/http/requestOrigin.d.ts +11 -0
  240. package/dist/server/http/requestOrigin.js +8 -0
  241. package/dist/server/http/router.d.ts +45 -0
  242. package/dist/server/http/router.js +22 -0
  243. package/dist/server/http/serverCore.d.ts +68 -0
  244. package/dist/server/http/serverCore.js +177 -0
  245. package/dist/server/http/traceRequest.d.ts +30 -0
  246. package/dist/server/http/traceRequest.js +224 -0
  247. package/dist/server/http/trust.d.ts +261 -0
  248. package/dist/server/http/trust.js +472 -0
  249. package/dist/server/http/writeRefusal.d.ts +33 -0
  250. package/dist/server/http/writeRefusal.js +24 -0
  251. package/dist/server/httpConnection.d.ts +49 -0
  252. package/dist/server/httpConnection.js +170 -0
  253. package/dist/server/impact.d.ts +55 -0
  254. package/dist/server/impact.js +47 -0
  255. package/dist/server/journal.d.ts +134 -0
  256. package/dist/server/journal.js +398 -0
  257. package/dist/server/keysetReadHttp.d.ts +52 -0
  258. package/dist/server/keysetReadHttp.js +85 -0
  259. package/dist/server/layouts.d.ts +49 -0
  260. package/dist/server/layouts.js +192 -0
  261. package/dist/server/migrate/cli.d.ts +102 -0
  262. package/dist/server/migrate/cli.js +702 -0
  263. package/dist/server/migrate/database.d.ts +37 -0
  264. package/dist/server/migrate/database.js +247 -0
  265. package/dist/server/migrate/desired.d.ts +76 -0
  266. package/dist/server/migrate/desired.js +292 -0
  267. package/dist/server/migrate/files.d.ts +34 -0
  268. package/dist/server/migrate/files.js +141 -0
  269. package/dist/server/migrate/flyway.d.ts +7 -0
  270. package/dist/server/migrate/flyway.js +69 -0
  271. package/dist/server/migrate/history.d.ts +70 -0
  272. package/dist/server/migrate/history.js +211 -0
  273. package/dist/server/migrate/runner.d.ts +100 -0
  274. package/dist/server/migrate/runner.js +413 -0
  275. package/dist/server/migrate/snapshot.d.ts +30 -0
  276. package/dist/server/migrate/snapshot.js +239 -0
  277. package/dist/server/migrate/target.d.ts +33 -0
  278. package/dist/server/migrate/target.js +82 -0
  279. package/dist/server/openapiDraft.d.ts +25 -0
  280. package/dist/server/openapiDraft.js +171 -0
  281. package/dist/server/operations/diagnostics.d.ts +101 -0
  282. package/dist/server/operations/diagnostics.js +284 -0
  283. package/dist/server/operations/requestMetrics.d.ts +33 -0
  284. package/dist/server/operations/requestMetrics.js +94 -0
  285. package/dist/server/packageVersion.d.ts +1 -0
  286. package/dist/server/packageVersion.js +11 -0
  287. package/dist/server/poolConfig.d.ts +34 -0
  288. package/dist/server/poolConfig.js +114 -0
  289. package/dist/server/product.d.ts +20 -0
  290. package/dist/server/product.js +12 -0
  291. package/dist/server/recordHistoryOperations.d.ts +39 -0
  292. package/dist/server/recordHistoryOperations.js +43 -0
  293. package/dist/server/recordWriteOperations.d.ts +111 -0
  294. package/dist/server/recordWriteOperations.js +329 -0
  295. package/dist/server/resourceReadHttp.d.ts +81 -0
  296. package/dist/server/resourceReadHttp.js +606 -0
  297. package/dist/server/resourceReadOperations.d.ts +147 -0
  298. package/dist/server/resourceReadOperations.js +452 -0
  299. package/dist/server/scaffoldMachine.d.ts +54 -0
  300. package/dist/server/scaffoldMachine.js +184 -0
  301. package/dist/server/seed/cli.d.ts +20 -0
  302. package/dist/server/seed/cli.js +164 -0
  303. package/dist/server/seed/lexicon.d.ts +26 -0
  304. package/dist/server/seed/lexicon.js +585 -0
  305. package/dist/server/seed/seed.d.ts +70 -0
  306. package/dist/server/seed/seed.js +779 -0
  307. package/dist/server/seed/words.d.ts +21 -0
  308. package/dist/server/seed/words.js +164 -0
  309. package/dist/server/serverRequests.d.ts +6 -0
  310. package/dist/server/serverRequests.js +33 -0
  311. package/dist/server/serverTimeouts.d.ts +33 -0
  312. package/dist/server/serverTimeouts.js +32 -0
  313. package/dist/server/shapeonly.d.ts +32 -0
  314. package/dist/server/shapeonly.js +115 -0
  315. package/dist/server/startupWarnings.d.ts +32 -0
  316. package/dist/server/startupWarnings.js +92 -0
  317. package/dist/shared/addressParams.d.ts +28 -0
  318. package/dist/shared/addressParams.js +47 -0
  319. package/dist/shared/aggregate.d.ts +49 -0
  320. package/dist/shared/aggregate.js +107 -0
  321. package/dist/shared/appCards.d.ts +123 -0
  322. package/dist/shared/appCards.js +385 -0
  323. package/dist/shared/appComponents.d.ts +177 -0
  324. package/dist/shared/appComponents.js +422 -0
  325. package/dist/shared/appDocuments.d.ts +43 -0
  326. package/dist/shared/appDocuments.js +131 -0
  327. package/dist/shared/appEmbeds.d.ts +21 -0
  328. package/dist/shared/appEmbeds.js +24 -0
  329. package/dist/shared/appIcons.d.ts +28 -0
  330. package/dist/shared/appIcons.js +223 -0
  331. package/dist/shared/appLinks.d.ts +17 -0
  332. package/dist/shared/appLinks.js +124 -0
  333. package/dist/shared/appListColumns.d.ts +3 -0
  334. package/dist/shared/appListColumns.js +66 -0
  335. package/dist/shared/appLocale.d.ts +36 -0
  336. package/dist/shared/appLocale.js +86 -0
  337. package/dist/shared/appMessages.d.ts +44 -0
  338. package/dist/shared/appMessages.js +78 -0
  339. package/dist/shared/appNoun.d.ts +21 -0
  340. package/dist/shared/appNoun.js +32 -0
  341. package/dist/shared/autoBucket.d.ts +98 -0
  342. package/dist/shared/autoBucket.js +305 -0
  343. package/dist/shared/autoValues.d.ts +25 -0
  344. package/dist/shared/autoValues.js +25 -0
  345. package/dist/shared/breakdown.d.ts +228 -0
  346. package/dist/shared/breakdown.js +570 -0
  347. package/dist/shared/breakdowntext.d.ts +41 -0
  348. package/dist/shared/breakdowntext.js +400 -0
  349. package/dist/shared/builtInThemes.d.ts +2 -0
  350. package/dist/shared/builtInThemes.js +771 -0
  351. package/dist/shared/chartSeparation.d.ts +11 -0
  352. package/dist/shared/chartSeparation.js +58 -0
  353. package/dist/shared/clauses.d.ts +22 -0
  354. package/dist/shared/clauses.js +97 -0
  355. package/dist/shared/columnCaption.d.ts +16 -0
  356. package/dist/shared/columnCaption.js +90 -0
  357. package/dist/shared/commandFieldPath.d.ts +2 -0
  358. package/dist/shared/commandFieldPath.js +7 -0
  359. package/dist/shared/commandWire.d.ts +26 -0
  360. package/dist/shared/commandWire.js +41 -0
  361. package/dist/shared/computed.d.ts +161 -0
  362. package/dist/shared/computed.js +378 -0
  363. package/dist/shared/computedParse.d.ts +13 -0
  364. package/dist/shared/computedParse.js +278 -0
  365. package/dist/shared/computedValue.d.ts +47 -0
  366. package/dist/shared/computedValue.js +191 -0
  367. package/dist/shared/connection.d.ts +30 -0
  368. package/dist/shared/connection.js +1 -0
  369. package/dist/shared/csv.d.ts +20 -0
  370. package/dist/shared/csv.js +63 -0
  371. package/dist/shared/dashLayout.d.ts +30 -0
  372. package/dist/shared/dashLayout.js +132 -0
  373. package/dist/shared/dashboardAsks.d.ts +93 -0
  374. package/dist/shared/dashboardAsks.js +129 -0
  375. package/dist/shared/dashboardTrend.d.ts +20 -0
  376. package/dist/shared/dashboardTrend.js +50 -0
  377. package/dist/shared/decimals.d.ts +37 -0
  378. package/dist/shared/decimals.js +148 -0
  379. package/dist/shared/declaredReferences.d.ts +50 -0
  380. package/dist/shared/declaredReferences.js +202 -0
  381. package/dist/shared/definedFields.d.ts +63 -0
  382. package/dist/shared/definedFields.js +103 -0
  383. package/dist/shared/definedValues.d.ts +63 -0
  384. package/dist/shared/definedValues.js +184 -0
  385. package/dist/shared/displayDefaults.d.ts +135 -0
  386. package/dist/shared/displayDefaults.js +543 -0
  387. package/dist/shared/dueDate.d.ts +6 -0
  388. package/dist/shared/dueDate.js +6 -0
  389. package/dist/shared/duration.d.ts +4 -0
  390. package/dist/shared/duration.js +23 -0
  391. package/dist/shared/fileBounds.d.ts +9 -0
  392. package/dist/shared/fileBounds.js +9 -0
  393. package/dist/shared/filter.d.ts +238 -0
  394. package/dist/shared/filter.js +332 -0
  395. package/dist/shared/firstPaint.d.ts +24 -0
  396. package/dist/shared/firstPaint.js +33 -0
  397. package/dist/shared/form.d.ts +21 -0
  398. package/dist/shared/form.js +25 -0
  399. package/dist/shared/formValues.d.ts +104 -0
  400. package/dist/shared/formValues.js +352 -0
  401. package/dist/shared/funnel.d.ts +45 -0
  402. package/dist/shared/funnel.js +108 -0
  403. package/dist/shared/httpOperations.d.ts +48 -0
  404. package/dist/shared/httpOperations.js +9 -0
  405. package/dist/shared/iconGlyphs.d.ts +4 -0
  406. package/dist/shared/iconGlyphs.js +151 -0
  407. package/dist/shared/iconWeights.d.ts +3 -0
  408. package/dist/shared/iconWeights.js +162 -0
  409. package/dist/shared/imageWidths.d.ts +32 -0
  410. package/dist/shared/imageWidths.js +38 -0
  411. package/dist/shared/keysetPage.d.ts +64 -0
  412. package/dist/shared/keysetPage.js +161 -0
  413. package/dist/shared/like.d.ts +20 -0
  414. package/dist/shared/like.js +29 -0
  415. package/dist/shared/listEmpty.d.ts +12 -0
  416. package/dist/shared/listEmpty.js +36 -0
  417. package/dist/shared/listFilters.d.ts +28 -0
  418. package/dist/shared/listFilters.js +84 -0
  419. package/dist/shared/listPresentations.d.ts +199 -0
  420. package/dist/shared/listPresentations.js +7 -0
  421. package/dist/shared/listQuestion.d.ts +52 -0
  422. package/dist/shared/listQuestion.js +137 -0
  423. package/dist/shared/lookPalettes.d.ts +62 -0
  424. package/dist/shared/lookPalettes.js +306 -0
  425. package/dist/shared/maskQuoted.d.ts +24 -0
  426. package/dist/shared/maskQuoted.js +48 -0
  427. package/dist/shared/mentionLabel.d.ts +19 -0
  428. package/dist/shared/mentionLabel.js +38 -0
  429. package/dist/shared/mentionLookup.d.ts +17 -0
  430. package/dist/shared/mentionLookup.js +64 -0
  431. package/dist/shared/menuCounts.d.ts +16 -0
  432. package/dist/shared/menuCounts.js +74 -0
  433. package/dist/shared/model.d.ts +79 -0
  434. package/dist/shared/model.js +153 -0
  435. package/dist/shared/money.d.ts +53 -0
  436. package/dist/shared/money.js +98 -0
  437. package/dist/shared/moneyEntry.d.ts +7 -0
  438. package/dist/shared/moneyEntry.js +27 -0
  439. package/dist/shared/mount.d.ts +118 -0
  440. package/dist/shared/mount.js +248 -0
  441. package/dist/shared/niceTicks.d.ts +26 -0
  442. package/dist/shared/niceTicks.js +50 -0
  443. package/dist/shared/order.d.ts +59 -0
  444. package/dist/shared/order.js +133 -0
  445. package/dist/shared/page.d.ts +135 -0
  446. package/dist/shared/page.js +1187 -0
  447. package/dist/shared/pageAnatomy.d.ts +99 -0
  448. package/dist/shared/pageAnatomy.js +370 -0
  449. package/dist/shared/pageConfig.d.ts +25 -0
  450. package/dist/shared/pageConfig.js +1308 -0
  451. package/dist/shared/pageEmptyActions.d.ts +12 -0
  452. package/dist/shared/pageEmptyActions.js +20 -0
  453. package/dist/shared/pageLayouts.d.ts +72 -0
  454. package/dist/shared/pageLayouts.js +205 -0
  455. package/dist/shared/pageModel.d.ts +785 -0
  456. package/dist/shared/pageModel.js +121 -0
  457. package/dist/shared/pagePaths.d.ts +180 -0
  458. package/dist/shared/pagePaths.js +869 -0
  459. package/dist/shared/pagePlans.d.ts +52 -0
  460. package/dist/shared/pagePlans.js +108 -0
  461. package/dist/shared/pageRoutes.d.ts +9 -0
  462. package/dist/shared/pageRoutes.js +9 -0
  463. package/dist/shared/query.d.ts +166 -0
  464. package/dist/shared/query.js +1302 -0
  465. package/dist/shared/queryDates.d.ts +12 -0
  466. package/dist/shared/queryDates.js +101 -0
  467. package/dist/shared/queryOperands.d.ts +99 -0
  468. package/dist/shared/queryOperands.js +131 -0
  469. package/dist/shared/reads.d.ts +103 -0
  470. package/dist/shared/reads.js +154 -0
  471. package/dist/shared/recordLabel.d.ts +51 -0
  472. package/dist/shared/recordLabel.js +123 -0
  473. package/dist/shared/recordReadKeys.d.ts +30 -0
  474. package/dist/shared/recordReadKeys.js +51 -0
  475. package/dist/shared/recordReads.d.ts +268 -0
  476. package/dist/shared/recordReads.js +368 -0
  477. package/dist/shared/recordview.d.ts +198 -0
  478. package/dist/shared/recordview.js +356 -0
  479. package/dist/shared/referenceModel.d.ts +58 -0
  480. package/dist/shared/referenceModel.js +194 -0
  481. package/dist/shared/refusal.d.ts +80 -0
  482. package/dist/shared/refusal.js +184 -0
  483. package/dist/shared/relatedCreate.d.ts +30 -0
  484. package/dist/shared/relatedCreate.js +162 -0
  485. package/dist/shared/resourceHttp.d.ts +464 -0
  486. package/dist/shared/resourceHttp.js +1 -0
  487. package/dist/shared/richText.d.ts +85 -0
  488. package/dist/shared/richText.js +305 -0
  489. package/dist/shared/rollups.d.ts +143 -0
  490. package/dist/shared/rollups.js +64 -0
  491. package/dist/shared/rowScope.d.ts +72 -0
  492. package/dist/shared/rowScope.js +376 -0
  493. package/dist/shared/runtimeTables.d.ts +44 -0
  494. package/dist/shared/runtimeTables.js +79 -0
  495. package/dist/shared/schema.d.ts +529 -0
  496. package/dist/shared/schema.js +627 -0
  497. package/dist/shared/schematext.d.ts +38 -0
  498. package/dist/shared/schematext.js +101 -0
  499. package/dist/shared/scopeCatalog.d.ts +29 -0
  500. package/dist/shared/scopeCatalog.js +472 -0
  501. package/dist/shared/servedApp.d.ts +686 -0
  502. package/dist/shared/servedApp.js +45 -0
  503. package/dist/shared/sessionLease.d.ts +34 -0
  504. package/dist/shared/sessionLease.js +3 -0
  505. package/dist/shared/shape.d.ts +55 -0
  506. package/dist/shared/shape.js +168 -0
  507. package/dist/shared/slug.d.ts +1 -0
  508. package/dist/shared/slug.js +12 -0
  509. package/dist/shared/sortText.d.ts +14 -0
  510. package/dist/shared/sortText.js +26 -0
  511. package/dist/shared/sqlRelation.d.ts +4 -0
  512. package/dist/shared/sqlRelation.js +8 -0
  513. package/dist/shared/sqlsaved.d.ts +44 -0
  514. package/dist/shared/sqlsaved.js +63 -0
  515. package/dist/shared/stitchedPaths.d.ts +27 -0
  516. package/dist/shared/stitchedPaths.js +38 -0
  517. package/dist/shared/structuredFilter.d.ts +22 -0
  518. package/dist/shared/structuredFilter.js +1 -0
  519. package/dist/shared/subtitlePath.d.ts +20 -0
  520. package/dist/shared/subtitlePath.js +24 -0
  521. package/dist/shared/suggest.d.ts +18 -0
  522. package/dist/shared/suggest.js +59 -0
  523. package/dist/shared/tableSizing.d.ts +4 -0
  524. package/dist/shared/tableSizing.js +9 -0
  525. package/dist/shared/tagLists.d.ts +57 -0
  526. package/dist/shared/tagLists.js +34 -0
  527. package/dist/shared/textRules.d.ts +54 -0
  528. package/dist/shared/textRules.js +133 -0
  529. package/dist/shared/theme.d.ts +94 -0
  530. package/dist/shared/theme.js +800 -0
  531. package/dist/shared/themeColor.d.ts +34 -0
  532. package/dist/shared/themeColor.js +109 -0
  533. package/dist/shared/themeFaces.d.ts +30 -0
  534. package/dist/shared/themeFaces.js +42 -0
  535. package/dist/shared/themeInk.d.ts +20 -0
  536. package/dist/shared/themeInk.js +52 -0
  537. package/dist/shared/themeLooks.d.ts +9 -0
  538. package/dist/shared/themeLooks.js +572 -0
  539. package/dist/shared/themeParts.d.ts +26 -0
  540. package/dist/shared/themeParts.js +71 -0
  541. package/dist/shared/themePartsCheck.d.ts +21 -0
  542. package/dist/shared/themePartsCheck.js +91 -0
  543. package/dist/shared/themePresets.d.ts +85 -0
  544. package/dist/shared/themePresets.js +139 -0
  545. package/dist/shared/themeRecipeWords.d.ts +156 -0
  546. package/dist/shared/themeRecipeWords.js +156 -0
  547. package/dist/shared/themeRecipes.d.ts +213 -0
  548. package/dist/shared/themeRecipes.js +234 -0
  549. package/dist/shared/themeResolve.d.ts +55 -0
  550. package/dist/shared/themeResolve.js +52 -0
  551. package/dist/shared/themeTokens.d.ts +107 -0
  552. package/dist/shared/themeTokens.js +116 -0
  553. package/dist/shared/themeType.d.ts +38 -0
  554. package/dist/shared/themeType.js +205 -0
  555. package/dist/shared/unitWord.d.ts +4 -0
  556. package/dist/shared/unitWord.js +37 -0
  557. package/dist/shared/view.d.ts +195 -0
  558. package/dist/shared/view.js +987 -0
  559. package/dist/shared/viewLabels.d.ts +47 -0
  560. package/dist/shared/viewLabels.js +459 -0
  561. package/dist/shared/viewPaths.d.ts +248 -0
  562. package/dist/shared/viewPaths.js +294 -0
  563. package/dist/shared/viewtext.d.ts +57 -0
  564. package/dist/shared/viewtext.js +282 -0
  565. package/dist/shared/vocabulary.d.ts +71 -0
  566. package/dist/shared/vocabulary.js +249 -0
  567. package/dist/shared/weekStart.d.ts +7 -0
  568. package/dist/shared/weekStart.js +36 -0
  569. package/mark.svg +1 -0
  570. package/package.json +266 -3
  571. package/schema/model.d.ts +298 -0
  572. package/schema/theme.d.ts +587 -0
@@ -0,0 +1,77 @@
1
+ /**
2
+ * A displayable form of a target with no credential in it.
3
+ *
4
+ * `URL` parses out the password for us; the fallback matters because a
5
+ * malformed URL must not fall through to printing the original string.
6
+ */
7
+ export function redact(url) {
8
+ if (!/^[a-z][\w+.-]*:\/\//i.test(url)) {
9
+ // A bare file path. Show the file name, not the whole tree.
10
+ return url.split('/').pop() || url;
11
+ }
12
+ try {
13
+ const parsed = new URL(url);
14
+ const user = parsed.username ? `${parsed.username}@` : '';
15
+ const port = parsed.port ? `:${parsed.port}` : '';
16
+ return `${user}${parsed.hostname}${port}${parsed.pathname}`;
17
+ }
18
+ catch {
19
+ return '(connection)';
20
+ }
21
+ }
22
+ /**
23
+ * Take the credentials out of anything on its way to the browser.
24
+ *
25
+ * `redact` produces the public form of a URL we chose to show. This is for
26
+ * the other direction: text we did not write, going somewhere we did not
27
+ * intend. A driver's failure message quotes what it was handed, and what it
28
+ * was handed is the *resolved* connection string — the one with the password
29
+ * expanded out of the keychain and into it. That message was stored on the
30
+ * entry and served by every `GET /api/connections` from then on.
31
+ *
32
+ * Two passes, because there are two shapes of leak:
33
+ *
34
+ * 1. The whole DSN, echoed. Any `scheme://…` in the text is replaced with
35
+ * its redacted form, so the message keeps saying which host it could not
36
+ * reach — which is the useful half — without the credentials.
37
+ * 2. The password alone, quoted without its URL. Rarer, and caught by
38
+ * sweeping for the literal value.
39
+ *
40
+ * A password shorter than four characters is swept too. It mangles a message
41
+ * that happens to contain those letters, and that is the right trade: a
42
+ * garbled sentence is a nuisance, and a password on screen is not.
43
+ */
44
+ export function scrubSecrets(text, ...urls) {
45
+ let out = text.replace(/\b[a-z][\w+.-]*:\/\/[^\s'"`,)\]]+/gi, (match) => redact(match));
46
+ for (const url of urls) {
47
+ if (!url)
48
+ continue;
49
+ for (const secret of passwordsIn(url)) {
50
+ if (!secret)
51
+ continue;
52
+ out = out.split(secret).join('\u2022\u2022\u2022\u2022');
53
+ }
54
+ }
55
+ return out;
56
+ }
57
+ /**
58
+ * The password in a URL, in both the spellings it can appear in.
59
+ *
60
+ * `new URL` gives it percent-decoded, and a driver may quote either that or
61
+ * the raw form it was handed. Both are swept.
62
+ */
63
+ function passwordsIn(url) {
64
+ const found = new Set();
65
+ try {
66
+ const parsed = new URL(url);
67
+ if (parsed.password) {
68
+ found.add(parsed.password);
69
+ found.add(decodeURIComponent(parsed.password));
70
+ }
71
+ }
72
+ catch {
73
+ /* Not a URL — a file path, or a string with a `${VAR}` still in it. There
74
+ is no password to find, and failing to parse is not an error here. */
75
+ }
76
+ return [...found];
77
+ }
@@ -0,0 +1,358 @@
1
+ import { type HiddenColumnRules } from './hiddenColumns.js';
2
+ export { redact, scrubSecrets } from './connectionRedaction.js';
3
+ import { type HttpAuthConfig, type HttpConnectionConfig } from './httpConnection.js';
4
+ import { type ConfigSections, type ServiceConfig, type ServiceKind, type ServiceKinds } from './configSections.js';
5
+ import { type CacheStore } from '../adapters/cache/cacheStore.js';
6
+ import type { HttpDescription } from '../adapters/http/httpDescription.js';
7
+ import type { Adapter } from '../adapters/adapter.js';
8
+ import type { PoolRoleStats } from '../adapters/poolMetrics.js';
9
+ import { type PoolSize } from './poolConfig.js';
10
+ import type { DatabaseSchema } from '../shared/schema.js';
11
+ import type { PublicConnection } from '../shared/connection.js';
12
+ export { sqliteTargetFrom } from './configPaths.js';
13
+ export type { PublicConnection } from '../shared/connection.js';
14
+ export interface ConnectionConfig {
15
+ /** Stable identifier, used by the client and in URLs. */
16
+ id: string;
17
+ name: string;
18
+ /**
19
+ * SQLite path, database URL, or an API's base URL. Never leaves the server. A SQLite path a config file wrote
20
+ * relative to itself is already located here (`loadConfig`): every reader of the url opens the one file.
21
+ */
22
+ url: string;
23
+ /** The url as the config file wrote it, when locating it changed it: what a save writes back. */
24
+ writtenUrl?: string;
25
+ /** Postgres only. */
26
+ schemas?: string[];
27
+ /**
28
+ * Whether this connection may be written to at all.
29
+ *
30
+ * Read-only unless the config says otherwise, and the server enforces it —
31
+ * the browser's write toggle is a second gate, not the only one. A guard in
32
+ * the browser is not a guard: the client decides whether to *offer* editing,
33
+ * and until now the server took that decision on trust, so anything that
34
+ * could reach the endpoint could write.
35
+ *
36
+ * Per connection rather than per process because that is the shape of the
37
+ * actual risk. The same session usually holds a local database you want to
38
+ * edit and a production one you emphatically do not, and a global flag
39
+ * forces you to choose between restarting to fix a row and leaving
40
+ * production editable all afternoon.
41
+ */
42
+ writable?: boolean;
43
+ /**
44
+ * Where this database's migrations are (`tablewalk migrate`): a directory
45
+ * relative to the config file, and the history table's name when it is not
46
+ * tablewalk's own `__mistri_schema_history` (a team moving over from
47
+ * Flyway names `flyway_schema_history`). Read by the migrate command only.
48
+ */
49
+ migrations?: {
50
+ dir: string;
51
+ table?: string;
52
+ };
53
+ /**
54
+ * Whether rows may leave this connection at all. Default true.
55
+ *
56
+ * `"rows": false` is the enforced form of the boundary the README states
57
+ * in prose: shape is safe to hand an agent, row values are not, and a
58
+ * production database is exactly where that distinction matters. The
59
+ * catalog, counts, null fractions, plans and lint still answer; anything
60
+ * that would return a value out of a row refuses, at the adapter, for
61
+ * every endpoint and tool at once.
62
+ */
63
+ rows?: boolean;
64
+ /**
65
+ * Columns no one is served over this connection: table (id, bare name or
66
+ * "*") → column names, `*` a wildcard within a name. The Workbench, MCP and
67
+ * every App on it see a catalog without them, and raw SQL is refused
68
+ * (hiddenColumns.ts).
69
+ */
70
+ hidden?: HiddenColumnRules;
71
+ /**
72
+ * A PostgreSQL connection's pools: `{ "read": 16, "write": 8 }` lets
73
+ * sixteen reads and eight App writes hold a connection at once (each 1–64;
74
+ * `--read-pool` and `--write-pool`, else sized from the cores, when absent). The database
75
+ * browser writes through one whatever `write` says (writeLanes.ts).
76
+ */
77
+ pool?: PoolSize;
78
+ /**
79
+ * Read replicas of a PostgreSQL database, by URL, each resolved
80
+ * as `url` is. Lists, dashboards, counts and exports read from them in
81
+ * turn; record pages, writes, commands and a person's reads just after
82
+ * their own write stay on the primary (packages/engine/src/adapters/replicas.ts).
83
+ */
84
+ replicas?: string[];
85
+ /**
86
+ * A PostgreSQL connection's direct URL for `LISTEN`, used by a jobs host
87
+ * when `url` goes through a transaction-mode pooler, which cannot hold a
88
+ * listening session (packages/mistri/src/adapters/events/postgresCommandEventWake.ts).
89
+ */
90
+ listen?: string;
91
+ /**
92
+ * Present for an API read through its description (`"kind": "http"` in the
93
+ * config file); `url` is then the API's base URL. It holds no secret:
94
+ * `auth` keeps its `${VAR}` references until the connection opens.
95
+ */
96
+ http?: HttpConnectionConfig;
97
+ /** Where this came from, so the UI can say why it is listed. */
98
+ source: 'argument' | 'config' | 'session';
99
+ }
100
+ export declare class Registry {
101
+ /** The environment this registry's references resolve in: an App's own in a suite, else the process's (undefined). */
102
+ readonly environment?: NodeJS.ProcessEnv;
103
+ /** A suite captures each App's references once; standalone registries retain
104
+ * the existing process-environment lookup when a connection opens. */
105
+ constructor(options?: {
106
+ environment?: NodeJS.ProcessEnv;
107
+ });
108
+ private entries;
109
+ private activeId;
110
+ private invalidateAdapter;
111
+ /** Private serving-owner fence, not an authorization proof or a lease.
112
+ * Refuses synchronously once closure starts, even while drain/close awaits. */
113
+ captureAdapterLifetime(id: string, expectedAdapter: Adapter): () => void;
114
+ /** Told of each adapter a connection dials, before anything can write through it. */
115
+ private readonly dialedHooks;
116
+ /** Record history binds its tables here, so a reconnect records exactly as the adapter it replaced did (recordHistory.ts). */
117
+ onAdapterDialed(hook: (id: string, adapter: Adapter) => void): void;
118
+ /**
119
+ * The adapter a connection has open now, as dialed: the object the dial
120
+ * hooks were told of and a write capture is keyed by, or undefined while
121
+ * none is open. Nothing is dialed. Trusted server code only (live sync's
122
+ * binding): it is beneath the hidden-column and shape-only wrappers, so it
123
+ * is never handed to a reader.
124
+ */
125
+ dialedAdapter(id: string): Adapter | undefined;
126
+ /** Where a connection's one-time notices go: stderr, where startup speaks. Tests replace it. */
127
+ onWarning: (message: string) => void;
128
+ /** The services the config names beside its databases: not databases, never listed or browsed. The cache is the engine's; the App framework registers the rest (configSections.ts). */
129
+ private readonly services;
130
+ /** The config sections this registry's services were read under: what saves them back and what makes a kind a singleton. */
131
+ sections: ConfigSections;
132
+ private cacheStore?;
133
+ private cacheWarnedAt;
134
+ private readonly moduleState;
135
+ private readonly rolesSaid;
136
+ /** A service from the config. Names are unique among services; a kind that is a singleton (the cache, the email service) is configured once. */
137
+ addService(service: ServiceConfig): void;
138
+ /** The entries of kinds this binary does not read (`others: 'keep'`), as written, for a save to put back. */
139
+ private readonly kept;
140
+ keep(entry: Record<string, unknown>): void;
141
+ keptEntries(): ReadonlyArray<Record<string, unknown>>;
142
+ /** The services as written — references intact — for saving the config back. */
143
+ serviceConfigs(): ServiceConfig[];
144
+ /** The services of one kind, as written. */
145
+ servicesOfKind<K extends ServiceKind>(kind: K): Array<ServiceKinds[K]>;
146
+ /** State a module keeps for this registry, made on first use; `resetOnClose` state is forgotten by `closeServices`. */
147
+ serviceState<T>(key: string, make: () => T, options?: {
148
+ resetOnClose?: boolean;
149
+ }): T;
150
+ /**
151
+ * The deployment's cache: the Valkey a cache connection names, dialed on
152
+ * first use, or this process's own. Its outages are said at most once a
153
+ * minute; meanwhile every read is a miss.
154
+ */
155
+ cache(): CacheStore;
156
+ closeServices(): Promise<void>;
157
+ add(config: Omit<ConnectionConfig, 'id'> & {
158
+ id?: string;
159
+ }, options?: {
160
+ untrusted?: boolean;
161
+ resolved?: boolean;
162
+ }): ConnectionConfig;
163
+ /** The file a SQLite connection opens, absolute, where its URL is written out (no `${VAR}`): what a refusal names. */
164
+ sqliteFile(id: string): string | undefined;
165
+ has(id: string): boolean;
166
+ /** The stored configuration, for the manager to edit and to write back. */
167
+ configOf(id: string): ConnectionConfig | undefined;
168
+ /** Every stored configuration, in order, including its secrets as written. */
169
+ configs(): ConnectionConfig[];
170
+ /**
171
+ * One connection's URL as opening it would read it (see `openableUrls`): what a store beside it must be
172
+ * located by, since the stored text may be a `${VAR}` reference.
173
+ */
174
+ openableUrlOf(id: string): string | undefined;
175
+ /**
176
+ * Each database connection's URL as opening it would read it: `${VAR}` references resolved through this
177
+ * registry's captured environment (an untrusted URL as written), an API's left out. Read in one pass with no
178
+ * await, so an update between reads cannot retarget a connection already visited.
179
+ */
180
+ openableUrls(): string[];
181
+ /**
182
+ * Change a connection's name, target or schema list.
183
+ *
184
+ * The open adapter is discarded whenever the target changes, because an
185
+ * entry whose URL says one database while its schema describes another is
186
+ * the worst of both: it looks edited and behaves as it did before. The name
187
+ * alone can change without reconnecting.
188
+ */
189
+ update(id: string, patch: Partial<Omit<ConnectionConfig, 'id'>>, options?: {
190
+ untrusted?: boolean;
191
+ }): Promise<ConnectionConfig>;
192
+ /**
193
+ * Replace a connection's stored URL with one that names the same database.
194
+ *
195
+ * This is how a password moves out of the URL and into the keychain when
196
+ * the connections are saved: the target has not changed, only how the
197
+ * secret is remembered, so nothing that `update` does for a retarget —
198
+ * closing the adapter, dropping the writable flag, marking the URL as an
199
+ * untrusted client's — applies. The same-target rule is checked, not assumed: with
200
+ * the password blanked on both sides the two URLs must be identical, or
201
+ * this refuses rather than quietly becoming a retarget with the guards off.
202
+ */
203
+ rewriteUrl(id: string, url: string): ConnectionConfig;
204
+ /**
205
+ * Forget a connection.
206
+ *
207
+ * This used to refuse the last one, and the reason it gave was honest: a
208
+ * browser with no database to browse was a page that could not do anything,
209
+ * and the way out of that state was not obvious. Both halves of that have
210
+ * stopped being true — the server starts with nothing now, and the page it
211
+ * serves in that state exists to do exactly one thing, which is get you out
212
+ * of it. A rule that guards against a state the product supports is just a
213
+ * connection you cannot remove.
214
+ *
215
+ * The active connection moves to whatever remains, or to nothing.
216
+ */
217
+ remove(id: string): Promise<void>;
218
+ get active(): string | null;
219
+ /**
220
+ * Choose the default connection, or `null` for none.
221
+ *
222
+ * Null is reachable now that the server starts with nothing, and it is what
223
+ * an add has to fall back to when the connection it just made turns out not
224
+ * to open: `add` makes the first one active before anything has tried to
225
+ * dial it, so a failed first add left the whole application pointed at a
226
+ * connection that had never worked.
227
+ */
228
+ setActive(id: string | null): void;
229
+ list(): PublicConnection[];
230
+ /**
231
+ * Open a connection if it is not already open, and return it with its
232
+ * schema. A failure is recorded on the entry rather than thrown away, so
233
+ * the sidebar can show which connection is broken and why.
234
+ */
235
+ open(id: string): Promise<{
236
+ adapter: Adapter;
237
+ schema: DatabaseSchema;
238
+ }>;
239
+ private warnWiderRole;
240
+ private resolveReplicas;
241
+ private dial;
242
+ /**
243
+ * Hold a connection open for the length of one request.
244
+ *
245
+ * Closing an adapter is not an operation the thing using it finds out
246
+ * about. A slow `/api/run` in one tab and a `refresh` in another meant the
247
+ * pg client was ended mid-query — the read came back as a driver-level
248
+ * "connection closed" 500, and on SQLite as a use-after-close. Nothing
249
+ * counted who was using what.
250
+ *
251
+ * The lease is taken when a request resolves its connection and released
252
+ * when the response ends, whichever way it ends.
253
+ */
254
+ lease(id: string): () => void;
255
+ /**
256
+ * Wait for the requests using a connection to finish.
257
+ *
258
+ * Bounded, because a query can be stuck for as long as the statement
259
+ * timeout allows and "the close hangs" is a worse failure than "the close
260
+ * was slightly rude". After the wait it closes anyway — which is the old
261
+ * behaviour, now as a last resort rather than as the only one.
262
+ */
263
+ private drain;
264
+ /** Drop the cached schema so the next open re-reads the catalog. */
265
+ refresh(id: string): Promise<{
266
+ adapter: Adapter;
267
+ schema: DatabaseSchema;
268
+ }>;
269
+ closeAll(): Promise<void>;
270
+ /**
271
+ * Every open connection's pool meters, for the operator surface. A
272
+ * connection is named by its position among the configured ones — the
273
+ * order of tablewalk.json, then the command line — and never by its name
274
+ * or URL, which that surface must not carry. A connection not yet opened
275
+ * has no pool to report.
276
+ */
277
+ poolStats(): ConnectionPoolStats[];
278
+ }
279
+ /** One open pool's meters, by its connection's position among the configured ones. */
280
+ export type ConnectionPoolStats = PoolRoleStats & {
281
+ readonly position: number;
282
+ readonly dialect: string;
283
+ };
284
+ interface ConfigFile {
285
+ connections: Array<{
286
+ name: string;
287
+ url: string;
288
+ schemas?: string[];
289
+ /** Opt in to writes. Absent or false means the server refuses them. */
290
+ writable?: boolean;
291
+ /** `false` makes the connection shape-only: no row values leave it. */
292
+ rows?: boolean;
293
+ /** Table → columns never served over the connection (hiddenColumns.ts). */
294
+ hidden?: HiddenColumnRules;
295
+ /** `{ "read": n, "write": m }`: a PostgreSQL connection's pool sizes, checked by poolOf. */
296
+ pool?: unknown;
297
+ /** Read replicas' URLs, checked by replicasOf. */
298
+ replicas?: unknown;
299
+ /** A direct URL for LISTEN behind a pooler, checked by listenOf. */
300
+ listen?: unknown;
301
+ /** `"http"` for an API, `"cache"`, `"webhook"`, … for a service (serviceConnections.ts); absent for a database. */
302
+ kind?: 'http' | ServiceKind;
303
+ /** A description file relative to this one, or the description itself. */
304
+ description?: string | HttpDescription;
305
+ auth?: HttpAuthConfig;
306
+ insecure?: boolean;
307
+ allowLinkLocal?: boolean;
308
+ cache?: {
309
+ ttl: number;
310
+ };
311
+ /** Where its migrations are (tablewalk migrate), checked below. */
312
+ migrations?: {
313
+ dir: string;
314
+ table?: string;
315
+ };
316
+ }>;
317
+ }
318
+ export interface LoadedConfig {
319
+ path: string;
320
+ /** As written — a SQLite path located against the file (`writtenUrl` keeps the spelling) — plus an HTTP connection's fields checked and its description resolved against the file, and a checked pool. */
321
+ connections: Array<Omit<ConfigFile['connections'][number], 'pool' | 'replicas' | 'listen'> & {
322
+ writtenUrl?: string;
323
+ http?: HttpConnectionConfig;
324
+ pool?: PoolSize;
325
+ replicas?: string[];
326
+ listen?: string;
327
+ }>;
328
+ /** The services the file names beside its databases, checked; never databases, never listed as connections. */
329
+ services: ServiceConfig[];
330
+ /** Entries of kinds these sections keep unread (`others: 'keep'`), as written. */
331
+ kept?: Array<Record<string, unknown>>;
332
+ }
333
+ /**
334
+ * Read the first config file that exists.
335
+ *
336
+ * A missing file is not an error — most people will never write one. A file
337
+ * that exists but is malformed *is* an error, and is reported rather than
338
+ * skipped: silently ignoring a config someone wrote is worse than refusing.
339
+ *
340
+ * A SQLite path written relative to the file is located here, once, against
341
+ * the file's folder (`sqliteTargetFrom`), and `writtenUrl` keeps the spelling
342
+ * for a save. Every tool reads its connections through here — a start, check,
343
+ * build, migrate, seed, a suite, the token and test commands — and each used
344
+ * to apply the rule itself or not at all: a migrate run from an App's folder
345
+ * looked for `./shop.db` there while the server beside it opened the file
346
+ * next to the config, and the command journal a start puts beside the
347
+ * database was made in the working directory. A value from the environment
348
+ * (`"${DATABASE_URL}"`) is not the file's: it is read as given, from where
349
+ * tablewalk runs, as the same variable is without a config.
350
+ */
351
+ export declare function loadConfig(explicit: string | undefined, sections: ConfigSections): Promise<LoadedConfig | undefined>;
352
+ interface StoreResult {
353
+ stored: 'keychain' | 'file';
354
+ /** The URL to keep, with the password removed. */
355
+ url: string;
356
+ }
357
+ export declare function storeSecret(name: string, url: string): Promise<StoreResult | undefined>;
358
+ export declare function saveConfig(path: string, connections: ConnectionConfig[], services?: readonly ServiceConfig[], sections?: ConfigSections, kept?: ReadonlyArray<Record<string, unknown>>): Promise<void>;