@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 @@
1
+ export declare function compileCacheDirectory(env: NodeJS.ProcessEnv): string | undefined;
@@ -0,0 +1,30 @@
1
+ /**
2
+ * Where the built server keeps V8's compile cache (`module.enableCompileCache`).
3
+ *
4
+ * Under the user's cache directory rather than Node's default of the OS temp
5
+ * directory: the temp directory is emptied on reboot on some systems and is
6
+ * shared on others, and the cache is only worth having if the next start finds
7
+ * it. `NODE_COMPILE_CACHE` names another place, and
8
+ * `NODE_DISABLE_COMPILE_CACHE` turns it off, as they do for Node itself.
9
+ * Entries are keyed by file content and V8 version, so two installed versions
10
+ * never read each other's.
11
+ */
12
+ import { homedir } from 'node:os';
13
+ import { join } from 'node:path';
14
+ import { product } from './product.js';
15
+ export function compileCacheDirectory(env) {
16
+ if (env.NODE_DISABLE_COMPILE_CACHE)
17
+ return undefined;
18
+ if (env.NODE_COMPILE_CACHE)
19
+ return env.NODE_COMPILE_CACHE;
20
+ if (env.XDG_CACHE_HOME)
21
+ return join(env.XDG_CACHE_HOME, product(), 'compile');
22
+ let home;
23
+ try {
24
+ home = homedir();
25
+ }
26
+ catch {
27
+ return undefined;
28
+ }
29
+ return home ? join(home, '.cache', product(), 'compile') : undefined;
30
+ }
@@ -0,0 +1 @@
1
+ export declare function configLocations(explicit?: string, env?: NodeJS.ProcessEnv): string[];
@@ -0,0 +1,15 @@
1
+ /**
2
+ * Where a config file may live, in order.
3
+ *
4
+ * Project-local first, because a repo that ships a `mistri.json` (`tablewalk.json` for the browser) should win
5
+ * for anyone working in it; the user's own file is the fallback.
6
+ */
7
+ import { homedir } from 'node:os';
8
+ import { join } from 'node:path';
9
+ import { configFileName, product } from '../product.js';
10
+ export function configLocations(explicit, env = process.env) {
11
+ if (explicit)
12
+ return [explicit];
13
+ const xdg = env.XDG_CONFIG_HOME || join(homedir(), '.config');
14
+ return [join(process.cwd(), configFileName()), join(process.cwd(), `.${configFileName()}`), join(xdg, product(), 'connections.json')];
15
+ }
@@ -0,0 +1,123 @@
1
+ /** An entry the block may name, and the flag it stands for. */
2
+ declare const PROFILE_ENTRIES: {
3
+ readonly commands: '--commands';
4
+ readonly jobs: '--jobs';
5
+ readonly policy: '--policy';
6
+ readonly entry: '--app-entry';
7
+ };
8
+ type ProfileEntry = keyof typeof PROFILE_ENTRIES;
9
+ /** Where an entry came from: a flag, the profile, the `commands.ts` beside the App, or the build that bundled it. */
10
+ type EntryFrom = 'flag' | 'profile' | 'convention' | 'build';
11
+ /** Why the config file is the one read. */
12
+ type ConfigFrom = 'flag' | 'app' | 'cwd' | 'user';
13
+ /** The `app` block, its paths resolved from the file's folder. */
14
+ interface ProjectProfile {
15
+ readonly file: string;
16
+ readonly dir?: string;
17
+ readonly commands?: string;
18
+ readonly jobs?: string;
19
+ readonly policy?: string;
20
+ readonly entry?: string;
21
+ }
22
+ /** What a run resolved, said before anything else and carried in `--json` as `context`. */
23
+ interface ProjectContext {
24
+ readonly config?: {
25
+ readonly path: string;
26
+ readonly from: ConfigFrom;
27
+ };
28
+ readonly app?: {
29
+ readonly path: string;
30
+ readonly from: 'flag' | 'profile';
31
+ };
32
+ readonly entries: Partial<Record<ProfileEntry, {
33
+ readonly path: string;
34
+ readonly from: 'flag' | 'profile';
35
+ }>>;
36
+ /** Where a flag overrode the profile: what the profile said. */
37
+ readonly over: Partial<Record<ProfileEntry | 'dir', string>>;
38
+ }
39
+ /** A profile that cannot be used: refused before anything is read. */
40
+ export declare class ProfileRefusal extends Error {
41
+ }
42
+ /** What an App command takes of the profile: the App, and which entries. */
43
+ export interface ProfileTakes {
44
+ readonly entries: readonly ProfileEntry[];
45
+ /** `dev` also takes the App as its first word. */
46
+ readonly positional?: boolean;
47
+ /** The command prints the context in its own output and `--json` (check, migrate); another says it on stderr. */
48
+ readonly says?: boolean;
49
+ /** False where the command reads no App (`migrate diff` reads schema.sql and the config's connection). */
50
+ readonly app?: boolean;
51
+ }
52
+ /**
53
+ * The config file a run reads, by the one order: `--config`, the App's own, the working directory's, the person's
54
+ * own. Undefined when there is none (a run on a database named by `--db`).
55
+ */
56
+ export declare function findConfig(given: {
57
+ explicit?: string;
58
+ app?: string;
59
+ }, env?: NodeJS.ProcessEnv): {
60
+ path: string;
61
+ from: ConfigFrom;
62
+ } | undefined;
63
+ /** The `app` block of `file`, checked; undefined when the file has none. Throws a ProfileRefusal naming what is wrong. */
64
+ export declare function readProfile(file: string): ProjectProfile | undefined;
65
+ /**
66
+ * Whether the context is still to be said: true once a run, so a check `migrate up --app` runs inside it does not
67
+ * say it again after the migrate run said it first.
68
+ */
69
+ export declare function claimContext(): boolean;
70
+ /** The context the run's profile step resolved (applyProfile), for the command to print. */
71
+ export declare const projectContext: () => ProjectContext | undefined;
72
+ /**
73
+ * The run's arguments with the profile applied under them: the App when no `--app` names one, each entry the
74
+ * command takes that no flag names, and `--config` pinned where the file found is not the one a plain read would
75
+ * find (the App's own `mistri.json`), so the run and any child it starts read the same file. Records the context.
76
+ * Throws a ProfileRefusal for a block that cannot be used.
77
+ */
78
+ export declare function applyProfile(argv: readonly string[], takes: ProfileTakes, env?: NodeJS.ProcessEnv): string[];
79
+ /** Whether the profile, or the App's own mistri.json, decided any of the run's context: then the run says it. */
80
+ export declare function fromProfile(context: ProjectContext | undefined): boolean;
81
+ /**
82
+ * The entries the App itself says, where neither a flag nor the profile named one: the `commands.ts` beside its
83
+ * manifest (convention), or a build's own bundles (build).
84
+ */
85
+ export declare function appEntries(app: {
86
+ readonly build?: {
87
+ readonly entries: Partial<Record<'commands' | 'jobs' | 'policy', string>>;
88
+ };
89
+ readonly commands?: {
90
+ readonly file: string;
91
+ };
92
+ }, given: Partial<Record<'commands' | 'jobs' | 'policy', string | undefined>>): Partial<Record<ProfileEntry, {
93
+ path: string;
94
+ from: EntryFrom;
95
+ }>>;
96
+ /**
97
+ * The context as the run prints it, one line an entry: where it came from, and a flag that overrode the profile.
98
+ * `convention` and `build` are the App's to say (the loaded App's commands.ts beside it, a build's own bundles).
99
+ */
100
+ export declare function contextLines(context: ProjectContext | undefined, more?: Partial<Record<ProfileEntry, {
101
+ path: string;
102
+ from: EntryFrom;
103
+ }>>): string[];
104
+ /** The context as `--json` carries it: `{ config, app, entries: { commands|jobs|policy|entry: { path, from } | null } }`. */
105
+ export declare function contextJson(context: ProjectContext | undefined, more?: Partial<Record<ProfileEntry, {
106
+ path: string;
107
+ from: EntryFrom;
108
+ }>>): {
109
+ config: {
110
+ path: string;
111
+ from: ConfigFrom;
112
+ } | null;
113
+ app: {
114
+ path: string;
115
+ from: string;
116
+ } | null;
117
+ entries: Record<ProfileEntry, {
118
+ path: string;
119
+ from: EntryFrom;
120
+ over?: string;
121
+ } | null>;
122
+ };
123
+ export {};
@@ -0,0 +1,236 @@
1
+ /**
2
+ * The project profile (docs/bootstrap-plan.md, Part B): the `app` block of `mistri.json`, which names the App and
3
+ * the modules that carry its authority once, and the one rule every App command finds that file by.
4
+ *
5
+ * ```json
6
+ * { "app": { "dir": ".", "commands": "commands.ts", "jobs": "jobs.ts", "policy": "policy.ts" }, "connections": [...] }
7
+ * ```
8
+ *
9
+ * The order is fixed and printed: `--config`, then the App's own `<--app dir>/mistri.json`, then `./mistri.json`
10
+ * and `./.mistri.json`, then the person's own file. No walking up. Without `--app`, the found file's `app.dir`
11
+ * names the App. A flag beats the profile, and the profile beats the `commands.ts` convention; there is no
12
+ * environment layer, since the environment is for secrets. A field report found `dev scratch` and
13
+ * `check --app scratch` reading different files, and `--policy` repeated on every command of a tenant App.
14
+ *
15
+ * The block takes paths and nothing else: a `${NAME}` reference, a key it does not know, or a file that is not
16
+ * there is refused by name. It is not a second App definition: it names modules and defines nothing.
17
+ */
18
+ import { existsSync, readFileSync } from 'node:fs';
19
+ import { homedir } from 'node:os';
20
+ import { dirname, isAbsolute, join, relative, resolve } from 'node:path';
21
+ import { configFileName, product } from '../product.js';
22
+ /** An entry the block may name, and the flag it stands for. */
23
+ const PROFILE_ENTRIES = { commands: '--commands', jobs: '--jobs', policy: '--policy', entry: '--app-entry' };
24
+ const PROFILE_KEYS = ['dir', ...Object.keys(PROFILE_ENTRIES)];
25
+ /** A profile that cannot be used: refused before anything is read. */
26
+ export class ProfileRefusal extends Error {
27
+ }
28
+ const shown = (path) => {
29
+ const near = relative(process.cwd(), path);
30
+ return !near ? '.' : near.startsWith('..') || isAbsolute(near) ? path : near;
31
+ };
32
+ /**
33
+ * The config file a run reads, by the one order: `--config`, the App's own, the working directory's, the person's
34
+ * own. Undefined when there is none (a run on a database named by `--db`).
35
+ */
36
+ export function findConfig(given, env = process.env) {
37
+ if (given.explicit !== undefined)
38
+ return { path: resolve(given.explicit), from: 'flag' };
39
+ const name = configFileName();
40
+ if (given.app !== undefined && existsSync(join(resolve(given.app), name)))
41
+ return { path: join(resolve(given.app), name), from: 'app' };
42
+ for (const path of [join(process.cwd(), name), join(process.cwd(), `.${name}`)])
43
+ if (existsSync(path))
44
+ return { path, from: 'cwd' };
45
+ const user = join(env.XDG_CONFIG_HOME || join(homedir(), '.config'), product(), 'connections.json');
46
+ return existsSync(user) ? { path: user, from: 'user' } : undefined;
47
+ }
48
+ /** The `app` block of `file`, checked; undefined when the file has none. Throws a ProfileRefusal naming what is wrong. */
49
+ export function readProfile(file) {
50
+ let parsed;
51
+ try {
52
+ parsed = JSON.parse(readFileSync(file, 'utf8'));
53
+ }
54
+ catch {
55
+ /* A file that does not parse is the config reader's to refuse, with its own words. */
56
+ return undefined;
57
+ }
58
+ if (!parsed || typeof parsed !== 'object' || !('app' in parsed))
59
+ return undefined;
60
+ const block = parsed.app;
61
+ const at = shown(file);
62
+ if (parsed.apps !== undefined)
63
+ throw new ProfileRefusal(`${at} has both "app" and "apps": "app" names the one App this project is, "apps" lists the Apps one server serves. Keep one.`);
64
+ if (!block || typeof block !== 'object' || Array.isArray(block))
65
+ throw new ProfileRefusal(`${at}: "app" is an object of paths, like { "dir": ".", "jobs": "jobs.ts" }.`);
66
+ const unknown = Object.keys(block).filter((key) => !PROFILE_KEYS.includes(key));
67
+ if (unknown.length)
68
+ throw new ProfileRefusal(`${at}: app.${unknown[0]} is not a key of the app block. It takes ${PROFILE_KEYS.slice(0, -1).join(', ')} and ${PROFILE_KEYS.at(-1)}: the App and the modules that carry its authority. Ports, mounts and looks stay as flags.`);
69
+ const folder = dirname(file);
70
+ const profile = { file };
71
+ for (const [key, value] of Object.entries(block)) {
72
+ if (typeof value !== 'string' || !value.trim())
73
+ throw new ProfileRefusal(`${at}: app.${key} is a path, relative to ${at}'s folder.`);
74
+ if (/\$\{|\$[A-Z_]/.test(value))
75
+ throw new ProfileRefusal(`${at}: app.${key} names ${JSON.stringify(value)}. The app block takes paths only: a secret or a value that differs per machine stays in the environment.`);
76
+ const path = resolve(folder, value);
77
+ if (!existsSync(path))
78
+ throw new ProfileRefusal(`${at}: app.${key} names ${value}, which is not there (${shown(path)}, from ${shown(folder)}).`);
79
+ profile[key] = path;
80
+ }
81
+ return profile;
82
+ }
83
+ let resolved;
84
+ let said = false;
85
+ /**
86
+ * Whether the context is still to be said: true once a run, so a check `migrate up --app` runs inside it does not
87
+ * say it again after the migrate run said it first.
88
+ */
89
+ export function claimContext() {
90
+ if (said)
91
+ return false;
92
+ said = true;
93
+ return true;
94
+ }
95
+ /** The context the run's profile step resolved (applyProfile), for the command to print. */
96
+ export const projectContext = () => resolved;
97
+ /** Value of a flag in argv (`--flag value`), and every index it is at. */
98
+ function flagged(argv, flag) {
99
+ const values = [];
100
+ for (let i = 0; i < argv.length; i++)
101
+ if (argv[i] === flag && argv[i + 1] !== undefined)
102
+ values.push(argv[i + 1]);
103
+ return values;
104
+ }
105
+ /**
106
+ * The run's arguments with the profile applied under them: the App when no `--app` names one, each entry the
107
+ * command takes that no flag names, and `--config` pinned where the file found is not the one a plain read would
108
+ * find (the App's own `mistri.json`), so the run and any child it starts read the same file. Records the context.
109
+ * Throws a ProfileRefusal for a block that cannot be used.
110
+ */
111
+ export function applyProfile(argv, takes, env = process.env) {
112
+ const out = [...argv];
113
+ if (out.includes('--no-config') || out.includes('--help') || out.includes('-h')) {
114
+ resolved = undefined;
115
+ return out;
116
+ }
117
+ /* A suite's Apps are the suite's to name (`migrate stores up --suite`): the profile's one App is not added to it. */
118
+ const suite = out.includes('--suite');
119
+ const apps = flagged(out, '--app');
120
+ const positional = takes.positional && out[0] !== undefined && !out[0].startsWith('-') ? out[0] : undefined;
121
+ const named = apps.length === 1 ? apps[0] : positional;
122
+ const explicit = flagged(out, '--config').at(-1);
123
+ const naming = out.includes('--db') || out.includes('-d');
124
+ const found = naming && explicit === undefined
125
+ ? undefined
126
+ : findConfig({ ...(explicit !== undefined ? { explicit } : {}), ...(named !== undefined ? { app: named } : {}) }, env);
127
+ /* The person's own file names connections; a project's profile is a project's, so it is never read from there. */
128
+ const profile = found && found.from !== 'user' ? readProfile(found.path) : undefined;
129
+ const over = {};
130
+ let app;
131
+ if (apps.length > 1)
132
+ app = undefined;
133
+ else if (named !== undefined) {
134
+ app = { path: resolve(named), from: 'flag' };
135
+ if (profile?.dir !== undefined && resolve(named) !== profile.dir)
136
+ over.dir = profile.dir;
137
+ }
138
+ else if (profile?.dir !== undefined && !suite && takes.app !== false) {
139
+ app = { path: profile.dir, from: 'profile' };
140
+ out.push('--app', shown(profile.dir));
141
+ }
142
+ const entries = {};
143
+ if (apps.length <= 1 && !suite && takes.app !== false)
144
+ for (const entry of takes.entries) {
145
+ const flag = PROFILE_ENTRIES[entry];
146
+ const given = flagged(out, flag).at(-1);
147
+ const said = profile?.[entry];
148
+ if (given !== undefined) {
149
+ entries[entry] = { path: resolve(given), from: 'flag' };
150
+ if (said !== undefined && resolve(given) !== said)
151
+ over[entry] = said;
152
+ }
153
+ else if (said !== undefined) {
154
+ entries[entry] = { path: said, from: 'profile' };
155
+ out.push(flag, shown(said));
156
+ }
157
+ }
158
+ /* The App's own file is not one a plain read finds (engine config/locations.ts reads the working directory's):
159
+ named, so this run and the children it starts read it. */
160
+ if (found?.from === 'app' && explicit === undefined)
161
+ out.push('--config', shown(found.path));
162
+ resolved = { ...(found ? { config: found } : {}), ...(app ? { app } : {}), entries, over };
163
+ said = false;
164
+ return out;
165
+ }
166
+ /** Whether the profile, or the App's own mistri.json, decided any of the run's context: then the run says it. */
167
+ export function fromProfile(context) {
168
+ return (context !== undefined &&
169
+ (context.config?.from === 'app' ||
170
+ context.app?.from === 'profile' ||
171
+ Object.values(context.entries).some((entry) => entry.from === 'profile') ||
172
+ Object.keys(context.over).length > 0));
173
+ }
174
+ /**
175
+ * The entries the App itself says, where neither a flag nor the profile named one: the `commands.ts` beside its
176
+ * manifest (convention), or a build's own bundles (build).
177
+ */
178
+ export function appEntries(app, given) {
179
+ const more = {};
180
+ if (app.build) {
181
+ for (const kind of ['commands', 'jobs', 'policy']) {
182
+ const own = app.build.entries[kind];
183
+ if (own && given[kind] === undefined)
184
+ more[kind] = { path: own, from: 'build' };
185
+ }
186
+ return more;
187
+ }
188
+ if (given.commands === undefined && app.commands)
189
+ more.commands = { path: app.commands.file, from: 'convention' };
190
+ return more;
191
+ }
192
+ /**
193
+ * The context as the run prints it, one line an entry: where it came from, and a flag that overrode the profile.
194
+ * `convention` and `build` are the App's to say (the loaded App's commands.ts beside it, a build's own bundles).
195
+ */
196
+ export function contextLines(context, more = {}) {
197
+ if (!context)
198
+ return [];
199
+ const where = context.config
200
+ ? `${shown(context.config.path)} (${{ flag: '--config', app: 'beside the App', cwd: 'the working directory', user: "the person's own" }[context.config.from]})`
201
+ : 'no config file';
202
+ const lines = [`Context: ${where}`];
203
+ const row = (key, path, from) => lines.push(` ${key.padEnd(9)} ${(path ?? '—').padEnd(13)} ${from}`);
204
+ if (context.app)
205
+ row('app', shown(context.app.path), context.app.from === 'profile' ? 'mistri.json' : over(context, 'dir', 'flag'));
206
+ for (const entry of ['commands', 'jobs', 'policy', 'entry']) {
207
+ const own = context.entries[entry] ?? more[entry];
208
+ if (!own) {
209
+ /* Not named by a flag or the profile: the App may still say it (its commands.ts), where the run reads that. */
210
+ if (entry !== 'entry')
211
+ row(entry, undefined, 'not named');
212
+ continue;
213
+ }
214
+ row(entry, shown(own.path), own.from === 'profile' ? 'mistri.json' : own.from === 'flag' ? over(context, entry, 'flag') : own.from);
215
+ }
216
+ return lines;
217
+ }
218
+ function over(context, key, from) {
219
+ const said = context.over[key];
220
+ return said !== undefined ? `${from}, over mistri.json's ${shown(said)}` : from;
221
+ }
222
+ /** The context as `--json` carries it: `{ config, app, entries: { commands|jobs|policy|entry: { path, from } | null } }`. */
223
+ export function contextJson(context, more = {}) {
224
+ const entry = (key) => {
225
+ const own = context?.entries[key] ?? more[key];
226
+ if (!own)
227
+ return null;
228
+ const said = context?.over[key];
229
+ return { path: own.path, from: own.from, ...(said !== undefined ? { over: said } : {}) };
230
+ };
231
+ return {
232
+ config: context?.config ?? null,
233
+ app: context?.app ?? null,
234
+ entries: { commands: entry('commands'), jobs: entry('jobs'), policy: entry('policy'), entry: entry('entry') },
235
+ };
236
+ }
@@ -0,0 +1,7 @@
1
+ /**
2
+ * A SQLite target as a config file wrote it, said from that file's folder: `./shop.db`, `sqlite:shop.db` and
3
+ * `file:./shop.db` beside the config open that file wherever tablewalk was started — a check run from an App's folder
4
+ * (`--config ../tablewalk.json`) opened a new, empty `./shop.db` there instead. An absolute path, a server URL and a
5
+ * target with no folder to read it from are left as written.
6
+ */
7
+ export declare function sqliteTargetFrom(url: string, base: string | undefined): string;
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The one rule for a path a config file writes: it is the file's folder's. One typed on the command line (--db,
3
+ * --app, --config) is the working directory's, and so is a value from the environment. Kept apart from
4
+ * connections.ts so the testing entry, which copies a config's databases, reads it without the registry.
5
+ */
6
+ import { isAbsolute, resolve } from 'node:path';
7
+ import { fileURLToPath } from 'node:url';
8
+ /**
9
+ * A SQLite target as a config file wrote it, said from that file's folder: `./shop.db`, `sqlite:shop.db` and
10
+ * `file:./shop.db` beside the config open that file wherever tablewalk was started — a check run from an App's folder
11
+ * (`--config ../tablewalk.json`) opened a new, empty `./shop.db` there instead. An absolute path, a server URL and a
12
+ * target with no folder to read it from are left as written.
13
+ */
14
+ export function sqliteTargetFrom(url, base) {
15
+ if (!base || !url || url === ':memory:' || url.includes('$'))
16
+ return url;
17
+ if (/^file:/i.test(url)) {
18
+ let file;
19
+ try {
20
+ file = /^file:\/\//i.test(url) ? fileURLToPath(url) : decodeURIComponent(url.slice('file:'.length).split('?')[0]);
21
+ }
22
+ catch {
23
+ return url;
24
+ }
25
+ return isAbsolute(file) ? file : resolve(base, file);
26
+ }
27
+ if (/^sqlite:/i.test(url)) {
28
+ const file = url.replace(/^sqlite:(\/\/)?/i, '');
29
+ return !file || file === ':memory:' || isAbsolute(file) ? url : `sqlite:${resolve(base, file)}`;
30
+ }
31
+ if (url.includes('://'))
32
+ return url;
33
+ return isAbsolute(url) ? url : resolve(base, url);
34
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * The sections of tablewalk.json beside `connections`.
3
+ *
4
+ * The engine reads `connections`, `hidden`, `pool` and the cache (connections.ts, cacheService.ts). Every other
5
+ * entry a config file lists beside the databases — an email service, an identity provider, a webhook, a search
6
+ * engine — and every other top-level key — `analytics` — belongs to the App framework. Its parsers are a table
7
+ * (serviceConnections.ts) that a main hands to `loadConfig`: the sections a binary owns are the ones it passes, and
8
+ * an entry of a kind it does not pass is refused there. The file stays one file; the engine neither knows those
9
+ * sections' shapes nor imports their parsers.
10
+ *
11
+ * A kind's config type is added to `ServiceKinds` by declaration merging from the module that registers it, so
12
+ * `ServiceConfig` is the union of the kinds the program has, and a reader of `Registry.serviceConfigs()` sees all of
13
+ * them without the engine naming one.
14
+ */
15
+ /** Kind → the shape of its entry once checked. A registering module adds its own kinds with `declare module`. */
16
+ export interface ServiceKinds {
17
+ }
18
+ export type ServiceKind = keyof ServiceKinds & string;
19
+ export type ServiceConfig = ServiceKinds[keyof ServiceKinds];
20
+ /** How one kind of service entry is read, checked and written back. */
21
+ interface ServiceKindSpec {
22
+ /** Found by its issuer or by this server itself, so its entry may leave out "url". */
23
+ urlless?: boolean;
24
+ /** What a deployment has one of, in a sentence ("email service"): a second entry of the kind is refused. */
25
+ singleton?: string;
26
+ /** The entry, checked. Throws naming the field: a config someone wrote is refused rather than half-read. */
27
+ parse(entry: Record<string, unknown>, path: string): ServiceConfig;
28
+ /** The entry as written, for saving: the references stay references. */
29
+ entry(service: never): Record<string, unknown>;
30
+ }
31
+ /** The sections of a config file a binary owns: its service kinds, the checks across them, its top-level keys. */
32
+ export interface ConfigSections {
33
+ kinds: Readonly<Record<string, ServiceKindSpec>>;
34
+ /** A check across every service the file names, run once they are all read (a scim directory names its providers). */
35
+ checks: ReadonlyArray<(services: readonly ServiceConfig[], path: string) => void>;
36
+ /** Top-level keys of the file other than `connections`; each parser gets the value and the file's path. */
37
+ top: Readonly<Record<string, (value: unknown, path: string) => unknown>>;
38
+ /**
39
+ * What becomes of an entry of a kind these sections do not name. Absent, it is refused. `'keep'` is the
40
+ * database browser's (cli/browserCommands.ts): the one file is shared with the App framework, whose services
41
+ * the browser neither reads nor serves, so their entries are kept as written, unread, and a save writes them
42
+ * back where they were.
43
+ */
44
+ others?: 'keep';
45
+ }
46
+ /** Sections side by side; the kinds and keys of a later part win, its checks follow. */
47
+ export declare function mergeSections(...parts: ConfigSections[]): ConfigSections;
48
+ /** Whether `sections` keep this entry unread: a kind they do not name, which another reader of the file does. */
49
+ export declare const keptUnread: (sections: ConfigSections, kind: unknown) => boolean;
50
+ export declare const isServiceKind: (sections: ConfigSections, kind: unknown) => kind is ServiceKind;
51
+ /** Whether an entry of this kind is found by something other than a url. */
52
+ export declare const isUrlless: (sections: ConfigSections, kind: unknown) => boolean;
53
+ /** How a refusal names an entry: the file and the connection. */
54
+ export declare const serviceWhere: (entry: Record<string, unknown>, path: string) => string;
55
+ export declare function serviceConnectionOf(sections: ConfigSections, entry: Record<string, unknown>, path: string): ServiceConfig;
56
+ export declare function serviceEntry(sections: ConfigSections, service: ServiceConfig): Record<string, unknown>;
57
+ /** At most one of a singleton kind, then each check. */
58
+ export declare function checkServices(sections: ConfigSections, services: readonly ServiceConfig[], path: string): void;
59
+ /** The top-level keys the file has, parsed. */
60
+ export declare function parseConfigSections(sections: ConfigSections, parsed: unknown, path: string): Record<string, unknown>;
61
+ export declare const SHARED_SERVICE_KEYS: string[];
62
+ /** Refuse a key the kind does not take, and a flag that is not a boolean. */
63
+ export declare function checkServiceKeys(entry: Record<string, unknown>, kind: string, keys: readonly string[], where: string): void;
64
+ export {};
@@ -0,0 +1,72 @@
1
+ /**
2
+ * The sections of tablewalk.json beside `connections`.
3
+ *
4
+ * The engine reads `connections`, `hidden`, `pool` and the cache (connections.ts, cacheService.ts). Every other
5
+ * entry a config file lists beside the databases — an email service, an identity provider, a webhook, a search
6
+ * engine — and every other top-level key — `analytics` — belongs to the App framework. Its parsers are a table
7
+ * (serviceConnections.ts) that a main hands to `loadConfig`: the sections a binary owns are the ones it passes, and
8
+ * an entry of a kind it does not pass is refused there. The file stays one file; the engine neither knows those
9
+ * sections' shapes nor imports their parsers.
10
+ *
11
+ * A kind's config type is added to `ServiceKinds` by declaration merging from the module that registers it, so
12
+ * `ServiceConfig` is the union of the kinds the program has, and a reader of `Registry.serviceConfigs()` sees all of
13
+ * them without the engine naming one.
14
+ */
15
+ /** Sections side by side; the kinds and keys of a later part win, its checks follow. */
16
+ export function mergeSections(...parts) {
17
+ return {
18
+ kinds: Object.assign({}, ...parts.map((p) => p.kinds)),
19
+ checks: parts.flatMap((p) => p.checks),
20
+ top: Object.assign({}, ...parts.map((p) => p.top)),
21
+ };
22
+ }
23
+ /** Whether `sections` keep this entry unread: a kind they do not name, which another reader of the file does. */
24
+ export const keptUnread = (sections, kind) => sections.others === 'keep' && typeof kind === 'string' && kind !== 'http' && !Object.hasOwn(sections.kinds, kind);
25
+ export const isServiceKind = (sections, kind) => typeof kind === 'string' && Object.hasOwn(sections.kinds, kind);
26
+ /** Whether an entry of this kind is found by something other than a url. */
27
+ export const isUrlless = (sections, kind) => typeof kind === 'string' && sections.kinds[kind]?.urlless === true;
28
+ /** How a refusal names an entry: the file and the connection. */
29
+ export const serviceWhere = (entry, path) => `${path}: connection "${String(entry.name)}"`;
30
+ export function serviceConnectionOf(sections, entry, path) {
31
+ return sections.kinds[entry.kind].parse(entry, path);
32
+ }
33
+ export function serviceEntry(sections, service) {
34
+ return sections.kinds[service.kind].entry(service);
35
+ }
36
+ /** At most one of a singleton kind, then each check. */
37
+ export function checkServices(sections, services, path) {
38
+ for (const [kind, spec] of Object.entries(sections.kinds)) {
39
+ if (!spec.singleton)
40
+ continue;
41
+ const named = services.filter((service) => service.kind === kind);
42
+ if (named.length > 1) {
43
+ throw new Error(`${path} names ${named.length} ${kind} connections (${named.map((c) => `"${c.name}"`).join(', ')}); a deployment has one ${spec.singleton}.`);
44
+ }
45
+ }
46
+ for (const check of sections.checks)
47
+ check(services, path);
48
+ }
49
+ /** The top-level keys the file has, parsed. */
50
+ export function parseConfigSections(sections, parsed, path) {
51
+ const out = {};
52
+ for (const [key, parse] of Object.entries(sections.top)) {
53
+ const value = parsed[key];
54
+ if (value !== undefined)
55
+ out[key] = parse(value, path);
56
+ }
57
+ return out;
58
+ }
59
+ /* ---- what a plain url-and-auth service (a cache, a search engine) shares ---- */
60
+ export const SHARED_SERVICE_KEYS = ['name', 'kind', 'url', 'auth', 'insecure', 'allowLinkLocal'];
61
+ /** Refuse a key the kind does not take, and a flag that is not a boolean. */
62
+ export function checkServiceKeys(entry, kind, keys, where) {
63
+ const stray = Object.keys(entry).find((key) => !keys.includes(key));
64
+ if (stray) {
65
+ throw new Error(`${where} is a ${kind} connection, which takes no "${stray}". It takes: ${keys.join(', ')}.`);
66
+ }
67
+ for (const flag of ['insecure', 'allowLinkLocal']) {
68
+ if (entry[flag] !== undefined && typeof entry[flag] !== 'boolean') {
69
+ throw new Error(`${where} has "${flag}": ${JSON.stringify(entry[flag])}. It must be true or false, without quotes.`);
70
+ }
71
+ }
72
+ }
@@ -0,0 +1,30 @@
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 declare function redact(url: string): string;
8
+ /**
9
+ * Take the credentials out of anything on its way to the browser.
10
+ *
11
+ * `redact` produces the public form of a URL we chose to show. This is for
12
+ * the other direction: text we did not write, going somewhere we did not
13
+ * intend. A driver's failure message quotes what it was handed, and what it
14
+ * was handed is the *resolved* connection string — the one with the password
15
+ * expanded out of the keychain and into it. That message was stored on the
16
+ * entry and served by every `GET /api/connections` from then on.
17
+ *
18
+ * Two passes, because there are two shapes of leak:
19
+ *
20
+ * 1. The whole DSN, echoed. Any `scheme://…` in the text is replaced with
21
+ * its redacted form, so the message keeps saying which host it could not
22
+ * reach — which is the useful half — without the credentials.
23
+ * 2. The password alone, quoted without its URL. Rarer, and caught by
24
+ * sweeping for the literal value.
25
+ *
26
+ * A password shorter than four characters is swept too. It mangles a message
27
+ * that happens to contain those letters, and that is the right trade: a
28
+ * garbled sentence is a nuisance, and a password on screen is not.
29
+ */
30
+ export declare function scrubSecrets(text: string, ...urls: Array<string | undefined>): string;