@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,366 @@
1
+ import { overlaid, storedText, withStoredText } from './storedText.js';
2
+ import { firedBy } from './scopeTriggers.js';
3
+ const UNKNOWN = Symbol('unknown');
4
+ /**
5
+ * A column whose value the database assigns when a write gives none: SQLite's rowid alias takes the next id for an
6
+ * explicit NULL too, so a NULL given there is not the row's key, and NEW holds the id the statement chose.
7
+ */
8
+ const assigned = (table, column) => table.columns.find((candidate) => candidate.name === column)?.identity !== undefined;
9
+ /** A term that names a column of NEW or OLD: its value is the row's, known once the row is, never computed by the trigger. */
10
+ const refersToRow = (term) => term !== undefined && 'row' in term;
11
+ const comparable = (value) => typeof value === 'string' || (typeof value === 'number' && Number.isFinite(value));
12
+ /** A row without its generated columns: the database computes them, so a value read before the write may not hold after it. */
13
+ const writtenPart = (table, row) => Object.fromEntries(Object.entries(row).filter(([name]) => table.columns.find((column) => column.name === name)?.writable !== false));
14
+ export function createTriggerProof(acceptance, tools) {
15
+ const tableOf = (id) => tools.tables.find((table) => table.id === id) ??
16
+ tools.refuse(`A trigger's effect reaches "${id}", which is not in this write's footprint.`);
17
+ const hidden = (table, trigger, on) => `The trigger ${JSON.stringify(trigger.name)} on "${on}" reaches a row of "${table.id}" outside the principal's rows: the row policy (or tenant) does not admit it, or it does not exist.`;
18
+ /** Whether `trigger` on `table` is one the App accepts: named, keyed, judged sound by the catalog, and its digest the one approved. */
19
+ const accepts = (table, trigger) => {
20
+ const named = acceptance.named.get(table);
21
+ if (!named?.has(trigger.name) || !trigger.effects || trigger.unaccepted)
22
+ return false;
23
+ const approved = named.get(trigger.name);
24
+ return approved === undefined || approved === trigger.digest;
25
+ };
26
+ /** Why a fired trigger that blocks is not accepted, for the refusal. */
27
+ const unaccepted = (table, trigger) => {
28
+ const named = acceptance.named.get(table);
29
+ if (!named?.has(trigger.name))
30
+ return undefined;
31
+ if (!trigger.effects)
32
+ return `named by the App, but outside the keyed-effect grammar: ${trigger.why ?? 'it is not validation-only'}`;
33
+ if (trigger.unaccepted)
34
+ return `named by the App, but ${trigger.unaccepted}`;
35
+ return 'named by the App, but its definition is not the one authority.lock approved';
36
+ };
37
+ /** The accepted triggers a write fires; refuses where it fires one that blocks and is not accepted. */
38
+ const fired = (table, write) => {
39
+ const triggers = tools.triggered?.get(table.id);
40
+ if (!triggers)
41
+ return [];
42
+ const all = firedBy(triggers, write, tools.foldCase);
43
+ if (all.length)
44
+ tools.relied?.(table);
45
+ const keyed = all.filter((trigger) => !trigger.validates);
46
+ const refused = keyed.find((trigger) => !accepts(table.id, trigger));
47
+ if (refused)
48
+ tools.refuse(`"${table.id}" cannot be written by a trigger under a row policy: the write fires ${JSON.stringify(refused.name)}, ${unaccepted(table.id, refused) ?? "which the App does not name in its resource's triggers"}.`);
49
+ return keyed;
50
+ };
51
+ const valueOf = (images, ref) => {
52
+ const row = ref.row === 'new' ? images.new : images.old;
53
+ if (row === null)
54
+ return null;
55
+ return Object.hasOwn(row, ref.column) ? (row[ref.column] ?? null) : UNKNOWN;
56
+ };
57
+ const termOf = (images, term) => 'row' in term ? valueOf(images, term) : 'literal' in term ? term.literal : UNKNOWN;
58
+ /** The stored text a term carries from the image it names (storedText.ts): a stored column copied as it is. */
59
+ const textOf = (images, term) => {
60
+ if (!('row' in term))
61
+ return undefined;
62
+ const row = term.row === 'new' ? images.new : images.old;
63
+ const texts = storedText(row);
64
+ return texts && row && Object.hasOwn(texts, term.column) && Object.hasOwn(row, term.column) ? texts[term.column] : undefined;
65
+ };
66
+ /** `row`, carrying the stored texts of the columns `terms` copy from an image unchanged. */
67
+ const carried = (row, images, terms, base = {}) => {
68
+ const texts = { ...base };
69
+ for (const [column, term] of Object.entries(terms)) {
70
+ const text = textOf(images, term);
71
+ if (text === undefined)
72
+ delete texts[column];
73
+ else
74
+ texts[column] = text;
75
+ }
76
+ return withStoredText(row, texts);
77
+ };
78
+ /** The effect's key as values: null where it reaches no row (a NULL never equals), UNKNOWN where the statement must tell. */
79
+ const keyOf = (images, effect, table) => {
80
+ const key = {};
81
+ let unknown = false;
82
+ for (const [column, ref] of Object.entries(effect.key ?? {})) {
83
+ const value = valueOf(images, ref);
84
+ if (value === null)
85
+ return null;
86
+ if (value === UNKNOWN)
87
+ unknown = true;
88
+ else if (!comparable(value))
89
+ return tools.refuse(`A trigger's key for "${table.id}".${column} is not a text or a number.`);
90
+ else
91
+ key[column] = value;
92
+ }
93
+ return unknown ? UNKNOWN : key;
94
+ };
95
+ const filterOf = (key) => ({
96
+ groups: [Object.entries(key).map(([column, value]) => ({ column, op: '=', value: value }))],
97
+ });
98
+ const primaryKey = (table, row) => {
99
+ const columns = table.columns.filter((column) => column.primaryKey);
100
+ if (!columns.length || columns.some((column) => !comparable(row[column.name])))
101
+ return undefined;
102
+ return Object.fromEntries(columns.map((column) => [column.name, row[column.name]]));
103
+ };
104
+ /** The row an update leaves, as far as the images say: a column it sets by an expression is not known until it ran. */
105
+ const updated = (table, stored, images, effect) => {
106
+ const row = writtenPart(table, stored);
107
+ for (const [column, term] of Object.entries(effect.values ?? {})) {
108
+ const value = termOf(images, term);
109
+ if (value === UNKNOWN)
110
+ delete row[column];
111
+ else
112
+ row[column] = value;
113
+ }
114
+ return carried(row, images, effect.values ?? {}, storedText(stored));
115
+ };
116
+ /** Whether `value` stored in `column` equals `wanted` as the database would: only where JavaScript can say so for certain. */
117
+ const equal = (table, column, value, wanted) => {
118
+ if (value === null || wanted === null)
119
+ return false;
120
+ if (typeof value === typeof wanted && (typeof value === 'string' || typeof value === 'number'))
121
+ return value === wanted;
122
+ // An integer column compares a number and its canonical text alike on both engines (affinity, a cast of the parameter).
123
+ const type = table.columns.find((candidate) => candidate.name === column)?.type ?? '';
124
+ if (/int|serial/i.test(type) && comparable(value) && comparable(wanted))
125
+ return String(value) === String(wanted);
126
+ return UNKNOWN;
127
+ };
128
+ const holds = (table, condition, row) => {
129
+ if (condition.other !== undefined || condition.any !== undefined || condition.collation !== undefined)
130
+ return UNKNOWN;
131
+ if (!Object.hasOwn(row, condition.column))
132
+ return UNKNOWN;
133
+ const value = row[condition.column];
134
+ if (value === UNKNOWN)
135
+ return UNKNOWN;
136
+ if (condition.op === 'isNull')
137
+ return value === null;
138
+ if (condition.op === 'isNotNull')
139
+ return value !== null;
140
+ if (condition.op === '=')
141
+ return equal(table, condition.column, value, condition.value);
142
+ if (condition.op === 'in' && Array.isArray(condition.value)) {
143
+ let unknown = false;
144
+ for (const wanted of condition.value) {
145
+ const same = equal(table, condition.column, value, wanted);
146
+ if (same === true)
147
+ return true;
148
+ if (same === UNKNOWN)
149
+ unknown = true;
150
+ }
151
+ return unknown ? UNKNOWN : false;
152
+ }
153
+ // A comparison whose answer depends on collation or type rules this side does not hold.
154
+ return UNKNOWN;
155
+ };
156
+ /** Whether a row the trigger inserts lands inside the policy's rule for its table. */
157
+ const admitted = (table, row) => {
158
+ const rule = tools.scope[table.id];
159
+ if (rule === true)
160
+ return true;
161
+ if (!rule)
162
+ return false;
163
+ const filter = rule;
164
+ if (!filter.groups.length)
165
+ return true;
166
+ let unknown = false;
167
+ for (const group of filter.groups) {
168
+ let all = true;
169
+ for (const condition of group) {
170
+ const result = holds(table, condition, row);
171
+ if (result === false) {
172
+ all = false;
173
+ break;
174
+ }
175
+ if (result === UNKNOWN)
176
+ all = UNKNOWN;
177
+ }
178
+ if (all === true)
179
+ return true;
180
+ if (all === UNKNOWN)
181
+ unknown = true;
182
+ }
183
+ return unknown ? UNKNOWN : false;
184
+ };
185
+ /**
186
+ * Before the statement: every effect of every accepted trigger the write fires, proven where its images already
187
+ * say enough. Answers what runs right after the statement.
188
+ */
189
+ /**
190
+ * The rows this statement's effects update or delete, by table and primary key, each with whether a write to it
191
+ * fires a keyed trigger; the statement's own row is one. A row two writes reach is seen by the second as the first
192
+ * left it, not as it was read and locked here: where either fires a keyed trigger, that trigger's keys would come
193
+ * from an image of the row this proof never had (a value one effect set, read as the key of the next).
194
+ */
195
+ let reached = new Map();
196
+ const rowId = (table, row) => JSON.stringify([table.id, primaryKey(table, row) ?? row]);
197
+ const claim = (table, row, firing, trigger) => {
198
+ const id = rowId(table, row);
199
+ const prior = reached.get(id);
200
+ if (prior !== undefined && (prior || firing))
201
+ tools.refuse(`The trigger ${JSON.stringify(trigger.name)} reaches a row of "${table.id}" that this write already reaches, and a write to it fires a trigger that reads or writes another row: what that trigger sees depends on which write runs first, so it cannot be proven before the write.`);
202
+ reached.set(id, firing);
203
+ };
204
+ /** Whether a write to `table` fires a trigger there that reads or writes another row, accepted or not. */
205
+ const firesKeyed = (table, write) => (tools.triggered?.get(table.id) ?? []).some((next) => !next.validates && firedBy([next], write, tools.foldCase).length > 0);
206
+ const before = async (table, write, images) => {
207
+ const afterwards = [];
208
+ const firing = fired(table, write);
209
+ if (firing.length)
210
+ tools.watch?.();
211
+ for (const trigger of firing)
212
+ for (const effect of trigger.effects)
213
+ afterwards.push(await effectBefore(table, trigger, effect, images));
214
+ return afterwards;
215
+ };
216
+ const effectBefore = async (on, trigger, effect, images) => {
217
+ const table = tableOf(effect.table);
218
+ const said = async (kind, row) => {
219
+ await acceptance.changed?.({ table: table.id, kind, ...row, trigger: trigger.name, on: on.id });
220
+ };
221
+ if (effect.kind === 'read') {
222
+ const key = keyOf(images, effect, table);
223
+ // Whether the trigger raises is read before anything else can be: a key the statement alone knows is not proven.
224
+ if (key === UNKNOWN)
225
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} reads a "${table.id}" row by a value only the write assigns: it cannot be proven before the write.`);
226
+ if (key) {
227
+ const filter = filterOf(key);
228
+ await tools.holdParent?.(table, filter);
229
+ if ((await tools.guards().count(table.id, filter)) !== 1)
230
+ return tools.refuse(hidden(table, trigger, on.id));
231
+ }
232
+ return async () => { };
233
+ }
234
+ if (effect.kind === 'insert') {
235
+ /** The row it will insert, a column it gives by an expression or leaves to a default unknown. */
236
+ const rowOf = (images) => {
237
+ const row = {};
238
+ for (const column of table.columns) {
239
+ if (Object.hasOwn(effect.values ?? {}, column.name)) {
240
+ const value = termOf(images, effect.values[column.name]);
241
+ row[column.name] = value === null && column.identity !== undefined ? UNKNOWN : value;
242
+ }
243
+ else
244
+ row[column.name] = column.default !== undefined || column.identity !== undefined || column.writable === false ? UNKNOWN : null;
245
+ }
246
+ return carried(row, images, effect.values ?? {});
247
+ };
248
+ const references = new Set(tools.foreignKeys.filter((fk) => fk.from.table === table.id).flatMap((fk) => fk.from.columns));
249
+ const knownPart = (row) => withStoredText(Object.fromEntries(Object.entries(row).filter(([, value]) => value !== UNKNOWN)), storedText(row));
250
+ /* A reference no image will ever tell (an expression, a default): refused now, before the statement could fail on
251
+ its foreign key for a parent that does not exist and pass for one that is hidden. */
252
+ if ([...references].some((column) => rowOf({ new: null, old: null })[column] === UNKNOWN && !refersToRow(effect.values?.[column])))
253
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} inserts a "${table.id}" row whose place in the principal's rows cannot be proven: a value the policy or a reference depends on is computed by the trigger or left to a default.`);
254
+ /** Its proof. */
255
+ const prove = async (images, last) => {
256
+ const row = rowOf(images);
257
+ const verdict = admitted(table, row);
258
+ const unknownReference = [...references].some((column) => row[column] === UNKNOWN);
259
+ if ((verdict === UNKNOWN || unknownReference) && !last)
260
+ return undefined;
261
+ if (verdict === UNKNOWN || unknownReference)
262
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} inserts a "${table.id}" row whose place in the principal's rows cannot be proven: a value the policy or a reference depends on is computed by the trigger or left to a default.`);
263
+ if (!verdict)
264
+ return tools.refuse(hidden(table, trigger, on.id));
265
+ const known = knownPart(row);
266
+ await tools.parents(table, known, references);
267
+ const chained = await before(table, { kind: 'insert' }, { new: known, old: null });
268
+ return async () => {
269
+ const key = primaryKey(table, known);
270
+ for (const next of chained)
271
+ await next({ new: known, old: null });
272
+ await said('insert', { ...(key ? { key } : {}), after: known });
273
+ };
274
+ };
275
+ const early = await prove(images, false);
276
+ if (early)
277
+ return early;
278
+ // Proven after the statement, what its row fires on its table would be proven after that had run too.
279
+ if (firesKeyed(table, { kind: 'insert' }))
280
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} inserts a "${table.id}" row whose place in the principal's rows only the write can tell, and that insert fires a trigger that reads or writes another row: it cannot be proven before the write.`);
281
+ // Its row waits for the statement; the references it already names are checked before it.
282
+ await tools.parentsBefore(table, knownPart(rowOf(images)), references);
283
+ return async (after) => {
284
+ const late = await prove(after, true);
285
+ await late?.(after);
286
+ };
287
+ }
288
+ // An update or a delete: one row, by a key known before the statement.
289
+ const key = keyOf(images, effect, table);
290
+ if (key === UNKNOWN)
291
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} reaches a row of "${table.id}" by a value only the write assigns: it cannot be proven before the write.`);
292
+ const write = effect.kind === 'update' ? { kind: 'update', set: Object.keys(effect.values ?? {}) } : { kind: 'delete' };
293
+ let stored;
294
+ let chained = [];
295
+ if (key) {
296
+ const result = await tools.lockedRead(table, filterOf(key), tools.guards());
297
+ if (result.rows.length !== 1)
298
+ return tools.refuse(hidden(table, trigger, on.id));
299
+ stored = result.rows[0];
300
+ claim(table, stored, firesKeyed(table, write), trigger);
301
+ if (effect.kind === 'update') {
302
+ const set = new Set(Object.keys(effect.values ?? {}));
303
+ const sets = tools.foreignKeys
304
+ .filter((fk) => fk.from.table === table.id)
305
+ .flatMap((fk) => fk.from.columns.filter((column) => set.has(column)));
306
+ // A reference set by an expression only the statement computes: whether its parent exists cannot be asked first.
307
+ if (sets.some((column) => !refersToRow(effect.values?.[column]) && !('literal' in (effect.values?.[column] ?? {}))))
308
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} sets a reference of "${table.id}" to a value only the write computes: whether that row exists and is the principal's cannot be proven before the write.`);
309
+ await tools.parentsBefore(table, updated(table, stored, images, effect), set);
310
+ }
311
+ chained = await before(table, write, effect.kind === 'update' ? { new: updated(table, stored, images, effect), old: stored } : { new: null, old: stored });
312
+ }
313
+ return async () => {
314
+ if (!key || !stored)
315
+ return;
316
+ if (effect.kind === 'delete') {
317
+ for (const next of chained)
318
+ await next({ new: null, old: stored });
319
+ await said('delete', { ...(primaryKey(table, stored) ? { key: primaryKey(table, stored) } : {}), before: stored });
320
+ return;
321
+ }
322
+ // Still inside the principal's rows after the trigger wrote it, and every reference it set checked.
323
+ const result = await tools.read(table, filterOf(key));
324
+ if (result.rows.length !== 1)
325
+ return tools.refuse(hidden(table, trigger, on.id));
326
+ const now = result.rows[0];
327
+ const was = stored;
328
+ /* A key or a referenced column the database generates moves with what the trigger set, which the catalog's
329
+ judgment by name cannot see (triggerEffects.ts): one that moved is refused, as the person's own update is. */
330
+ const shifted = table.columns
331
+ .filter(({ name, writable, primaryKey }) => writable === false &&
332
+ (primaryKey || tools.foreignKeys.some((fk) => fk.to.table === table.id && fk.to.columns.includes(name))) &&
333
+ JSON.stringify(was[name]) !== JSON.stringify(now[name]))
334
+ .map((column) => column.name);
335
+ if (shifted.length)
336
+ return tools.refuse(`The trigger ${JSON.stringify(trigger.name)} changes "${table.id}".${shifted.join(', ')}: a key, or a column another table references, generated from the columns it sets.`);
337
+ // Every reference it set checked; one with a generated column with every update (scopedTransaction.ts parentChecks).
338
+ await tools.parents(table, now, new Set(Object.keys(effect.values ?? {})));
339
+ for (const next of chained)
340
+ await next({ new: now, old: stored });
341
+ await said('update', { ...(primaryKey(table, now) ? { key: primaryKey(table, now) } : {}), before: stored, after: now });
342
+ };
343
+ };
344
+ /** A statement's proof: its own row (an update's or a delete's) the first reached, and every effect's after it. */
345
+ const statement = async (table, write, images) => {
346
+ reached = new Map();
347
+ if (images.old)
348
+ reached.set(rowId(table, images.old), true);
349
+ return before(table, write, images);
350
+ };
351
+ return { accepts, unaccepted, before: statement, images: imagesBefore };
352
+ }
353
+ /** What a scoped write's own row looks like to its triggers before the statement, by write. */
354
+ const imagesBefore = {
355
+ /* A NULL given for a column the database assigns is not what NEW will hold: left unknown, like a value not given. */
356
+ insert: (table, values) => ({
357
+ new: Object.fromEntries(Object.entries(values ?? {}).filter(([column, value]) => value != null || !assigned(table, column))),
358
+ old: null,
359
+ }),
360
+ // NEW carries the stored texts of the columns the write leaves as they were (storedText.ts).
361
+ update: (table, stored, values) => ({
362
+ new: withStoredText({ ...writtenPart(table, stored), ...(values ?? {}) }, storedText(overlaid(stored, values))),
363
+ old: stored,
364
+ }),
365
+ delete: (stored) => ({ new: null, old: stored }),
366
+ };
@@ -0,0 +1,3 @@
1
+ import { type SqlFragment, type SqlStyle, type UpdateRequest } from '../adapter.js';
2
+ /** Appended to a complete primary-key WHERE, with values bound after its parameters. */
3
+ export declare function buildUpdateGuard(request: UpdateRequest, types: Record<string, string>, style: SqlStyle, dialect: 'sqlite' | 'postgres', startIndex: number): SqlFragment;
@@ -0,0 +1,40 @@
1
+ import { Refusal } from '../adapter.js';
2
+ import { comparableType, isJsonType } from '../../shared/schema.js';
3
+ /** Appended to a complete primary-key WHERE, with values bound after its parameters. */
4
+ export function buildUpdateGuard(request, types, style, dialect, startIndex) {
5
+ if (request.expected === undefined)
6
+ return { text: '', params: [] };
7
+ const expected = request.expected;
8
+ if (!expected || typeof expected !== 'object' || Array.isArray(expected))
9
+ throw new Refusal('Expected values must be an object containing exactly the fields being updated.');
10
+ /* A JSON column is written whole and compares on no engine, so its
11
+ original value may be left out (a command's update leaves it out). */
12
+ const columns = Object.keys(request.values).filter((column) => Object.hasOwn(expected, column) || !isJsonType(types[column] ?? ''));
13
+ if (Object.keys(expected).length !== columns.length || !columns.every((column) => Object.hasOwn(expected, column))) {
14
+ throw new Refusal('Expected values must contain exactly the fields being updated.');
15
+ }
16
+ const params = [];
17
+ const checks = columns.map((column) => {
18
+ const value = expected[column];
19
+ const quoted = style.quote(column);
20
+ if (value === null)
21
+ return `${quoted} IS NULL`;
22
+ if (typeof value !== 'string' && typeof value !== 'boolean' && !(typeof value === 'number' && Number.isFinite(value))) {
23
+ throw new Refusal(`The original value of "${column}" must be a scalar or NULL.`);
24
+ }
25
+ const type = types[column] ?? '';
26
+ if (!comparableType(type)) {
27
+ throw new Refusal(`Protected editing of "${column}" (${type}) is not supported. Its original value cannot be compared safely here.`);
28
+ }
29
+ const placeholder = style.placeholder(startIndex + params.length);
30
+ // Preserve decimal/integer strings: Number() could round the original value.
31
+ params.push(dialect === 'sqlite' && typeof value === 'boolean' ? Number(value) : value);
32
+ // SQLite can store text even without a declared type; its collation still applies.
33
+ if (dialect === 'sqlite')
34
+ return `${quoted} COLLATE BINARY = ${placeholder}`;
35
+ if (/char|text|clob|citext/i.test(type))
36
+ return `${quoted}::text COLLATE "C" = ${placeholder}`;
37
+ return `${quoted} = ${placeholder}`;
38
+ });
39
+ return checks.length ? { text: ` AND (${checks.join(' AND ')})`, params } : { text: '', params: [] };
40
+ }
@@ -0,0 +1,45 @@
1
+ import type { PoolerMode } from './poolMetrics.js';
2
+ export type WriteOrder = 'serial' | 'keyed';
3
+ /** `--trust-proxy-hops` and `--trust-proxy-cloudflare`: how a forwarded client address is found (trust.ts). */
4
+ export interface ClientAddressPolicy {
5
+ /** This many proxies append to X-Forwarded-For, the socket peer being the first. */
6
+ readonly hops?: number;
7
+ /** The server is reachable only through Cloudflare, which sets CF-Connecting-IP. */
8
+ readonly cloudflare?: boolean;
9
+ }
10
+ export interface ServerSettings {
11
+ readonly clientAddress: ClientAddressPolicy;
12
+ /**
13
+ * The address the server is published at (MISTRI_PUBLIC_URL, or a mounting
14
+ * host's) is https: a TLS front end stands before every request, so a
15
+ * request counts as https whatever its own socket says (trust.ts
16
+ * `arrivedOverHttps`). Cloudflare, Cloud Run and most platforms end TLS
17
+ * and forward plain http from a peer nobody can name in `--trust-proxy`.
18
+ */
19
+ readonly httpsFront?: boolean;
20
+ /** `--read-pool`: a PostgreSQL reader pool's size; unset, it follows the write order (postgresPool.ts). */
21
+ readonly readers?: number;
22
+ /** `--pooler`. */
23
+ readonly pooler: PoolerMode;
24
+ /** `--write-pool`; unset, the balanced size (writeLanes.ts). */
25
+ readonly writers?: number;
26
+ /** `--lock-timeout`; unset, the default. */
27
+ readonly lockTimeoutMs?: number;
28
+ /**
29
+ * `keyed` where the server serves Apps, `serial` for the database browser
30
+ * (writeLanes.ts). Settled once the config is read, before a connection
31
+ * opens, so it is the one field startup writes after the scope is entered.
32
+ */
33
+ writeOrder: WriteOrder;
34
+ }
35
+ /** What a server that names nothing gets. */
36
+ export declare function defaultServerSettings(): ServerSettings;
37
+ /** The settings of the server this work belongs to: its scope's, or the process's. */
38
+ export declare function serverSettings(): ServerSettings;
39
+ /** Run `work`, and everything it starts, as the server `settings` describe. */
40
+ export declare function withServerSettings<T>(settings: ServerSettings, work: () => T): T;
41
+ /**
42
+ * Change the process's settings — what is read outside any scope: the
43
+ * command line's one server, a test. Fields it leaves out keep their value.
44
+ */
45
+ export declare function configureServerSettings(change: Partial<ServerSettings>): void;
@@ -0,0 +1,46 @@
1
+ /**
2
+ * What one server was started with that is read far below its requests: the
3
+ * client-address rule a rate limit keys by (http/trust.ts `forwardedClient`),
4
+ * and the pool sizes, pooler mode, lock wait and write order every adapter it
5
+ * opens takes (postgresPool.ts, writeLanes.ts).
6
+ *
7
+ * These were process globals, set once at startup, which was right while a
8
+ * process was one server. `createHandler` (embed/handler.ts) puts
9
+ * several in one host process, and each started by overwriting the globals:
10
+ * the last handler's proxy trust decided whose X-Forwarded-For every
11
+ * handler's limits believed. So a handler's settings are a value it carries,
12
+ * and everything it runs — its startup, every request it is given, its
13
+ * close — runs inside `withServerSettings`, where `serverSettings()` reads
14
+ * them. The command line is one server per process and installs its own as
15
+ * the process's (`configureServerSettings`), which is what is read outside
16
+ * any scope.
17
+ *
18
+ * A scope rather than an argument: the readers are a dozen limiters and the
19
+ * constructor of every pool, opened by the registry, a tenant source, the job
20
+ * host and a startup check alike. An argument would have to reach each, and
21
+ * one that missed would quietly return to the default — the failure this
22
+ * exists to end. A scope reaches all of them by construction, timers and
23
+ * all, since an async context follows its callbacks.
24
+ */
25
+ import { AsyncLocalStorage } from 'node:async_hooks';
26
+ /** What a server that names nothing gets. */
27
+ export function defaultServerSettings() {
28
+ return { clientAddress: {}, pooler: 'session', writeOrder: 'serial' };
29
+ }
30
+ let processSettings = defaultServerSettings();
31
+ const scope = new AsyncLocalStorage();
32
+ /** The settings of the server this work belongs to: its scope's, or the process's. */
33
+ export function serverSettings() {
34
+ return scope.getStore() ?? processSettings;
35
+ }
36
+ /** Run `work`, and everything it starts, as the server `settings` describe. */
37
+ export function withServerSettings(settings, work) {
38
+ return scope.run(settings, work);
39
+ }
40
+ /**
41
+ * Change the process's settings — what is read outside any scope: the
42
+ * command line's one server, a test. Fields it leaves out keep their value.
43
+ */
44
+ export function configureServerSettings(change) {
45
+ processSettings = { ...processSettings, ...change };
46
+ }
@@ -0,0 +1,8 @@
1
+ /** Run `work` with the next write transaction it opens reading one snapshot. */
2
+ export declare function withSnapshotRead<T>(snapshot: boolean, work: () => T): T;
3
+ /** Whether the transaction about to open here reads one snapshot. */
4
+ export declare function snapshotRead(): boolean;
5
+ /** Run `work` without it: a transaction's own work, so nothing it opens takes the snapshot for its own. */
6
+ export declare function withoutSnapshotRead<T>(work: () => T): T;
7
+ /** PostgreSQL's serialization failure: a REPEATABLE READ transaction wrote or locked a row that moved after its snapshot. */
8
+ export declare function isSnapshotConflict(error: unknown): boolean;
@@ -0,0 +1,37 @@
1
+ /**
2
+ * A command that asked for one snapshot (`snapshot: true` on its definition,
3
+ * docs/command-aggregates.md): every read it makes sees the database as of one
4
+ * moment, so a total and the rows behind it, or a count and the pages that
5
+ * follow, agree with each other while other writers carry on.
6
+ *
7
+ * PostgreSQL's write transaction is READ COMMITTED (postgres.ts
8
+ * journalTransaction says why), where each statement sees what committed
9
+ * before it began; asked for a snapshot it opens REPEATABLE READ instead. A
10
+ * row another transaction changed after the snapshot and this one then
11
+ * writes or locks fails with 40001, which the command host says as
12
+ * `stale_record` — the refusal a job or workflow already retries. SQLite's
13
+ * writer holds the file (`BEGIN IMMEDIATE`) from its first statement to its
14
+ * last, so its reads are one snapshot already and nothing here changes it.
15
+ *
16
+ * Carried as the write-ahead hint is (writeAhead.ts): told by the caller that
17
+ * knows the command, read once by the adapter for the transaction it is
18
+ * opening, and not passed to a transaction that work opens inside.
19
+ */
20
+ import { AsyncLocalStorage } from 'node:async_hooks';
21
+ const asked = new AsyncLocalStorage();
22
+ /** Run `work` with the next write transaction it opens reading one snapshot. */
23
+ export function withSnapshotRead(snapshot, work) {
24
+ return asked.run(snapshot, work);
25
+ }
26
+ /** Whether the transaction about to open here reads one snapshot. */
27
+ export function snapshotRead() {
28
+ return asked.getStore() === true;
29
+ }
30
+ /** Run `work` without it: a transaction's own work, so nothing it opens takes the snapshot for its own. */
31
+ export function withoutSnapshotRead(work) {
32
+ return asked.run(false, work);
33
+ }
34
+ /** PostgreSQL's serialization failure: a REPEATABLE READ transaction wrote or locked a row that moved after its snapshot. */
35
+ export function isSnapshotConflict(error) {
36
+ return !!error && typeof error === 'object' && error.code === '40001';
37
+ }