@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,420 @@
1
+ import { ANSI_STYLE, Refusal } from '../adapter.js';
2
+ import { chooseColumnReference, deleteRuleOf, } from '../../shared/schema.js';
3
+ import { mapScopeCatalog } from '../../shared/scopeCatalog.js';
4
+ import { referenceKey } from './scopedTransaction.js';
5
+ import { keyTypeRefusal, sqliteAffinity, sqliteKeyType, sqliteTypeSaid } from './keyTypes.js';
6
+ import { readSqliteTrigger, sqliteColumnCollations, sqliteConflictClauses } from './sqliteTriggers.js';
7
+ /* `table_xinfo`'s hidden: 0 a plain column, 1 a virtual table's own (its module's plumbing), 2 and 3 generated
8
+ (virtual, stored). A generated column keeps its table in scope: it is computed from the row the policy or the
9
+ tenant predicate already bounds, so a scoped read reads it and a scoped write leaves it to the database (sqlite.ts
10
+ refuses writing one). */
11
+ const generated = (column) => column.hidden === 2 || column.hidden === 3;
12
+ // SQLite's built-in identifier matching folds ASCII, not arbitrary Unicode.
13
+ const folded = (name) => name.replace(/[A-Z]/g, (char) => char.toLowerCase());
14
+ const refuse = (cause) => {
15
+ throw new Refusal('SQLite scoped transactions require a complete, unambiguous catalog and enabled foreign keys.', cause === undefined ? {} : { cause });
16
+ };
17
+ // SQLite's primary result codes for an engine that could not answer, rather
18
+ // than a catalog that is wrong: BUSY, LOCKED, NOMEM, INTERRUPT, IOERR, FULL,
19
+ // CANTOPEN, PROTOCOL. Extended codes keep the primary code in the low byte.
20
+ const UNAVAILABLE = new Set([5, 6, 7, 9, 10, 13, 14, 15]);
21
+ function identities(items) {
22
+ const result = new Map();
23
+ for (const item of items) {
24
+ if (typeof item.name !== 'string' || !item.name || result.has(folded(item.name)))
25
+ return refuse();
26
+ result.set(folded(item.name), item);
27
+ }
28
+ return result;
29
+ }
30
+ /** Call only on the writer inside BEGIN IMMEDIATE. No cached/public catalog,
31
+ * estimates or data scans: the lease's physical metadata is the authority.
32
+ * A non-writable table remains in the graph so hidden dependents cannot vanish.
33
+ */
34
+ export function readSqliteScopeCatalog(db, resolve) {
35
+ const scanned = scanSqliteScopeCatalog(db);
36
+ const { schema, writable } = scanned;
37
+ /* Keyed effects are judged against the catalog they run in (triggerEffects.ts, which the caller loads); a database
38
+ without them asks nothing more. Unjudged, none is accepted. */
39
+ const keyed = [...scanned.triggered.values()].some((triggers) => triggers.some((trigger) => trigger.effects));
40
+ const triggered = !keyed
41
+ ? scanned.triggered
42
+ : resolve
43
+ ? resolve({ schema, writable, triggered: scanned.triggered, foldCase: true, ...sqliteKeyFacts(db) })
44
+ : new Map([...scanned.triggered].map(([id, triggers]) => [
45
+ id,
46
+ triggers.map((trigger) => trigger.effects ? { ...trigger, unaccepted: 'its effects were not judged against the catalog' } : trigger),
47
+ ]));
48
+ const unkeyed = sqliteUnkeyed(schema);
49
+ return {
50
+ schema,
51
+ writable,
52
+ ...(triggered.size ? { triggered } : {}),
53
+ references: sqliteReferences(schema),
54
+ ...(unkeyed.size ? { unkeyed } : {}),
55
+ };
56
+ }
57
+ /** The tables whose primary key has a column of a type a scoped write does not take as a row's identity (keyTypes.ts), with why. */
58
+ function sqliteUnkeyed(schema) {
59
+ const unkeyed = new Map();
60
+ for (const table of schema.tables) {
61
+ const column = table.columns.find((candidate) => candidate.primaryKey && !sqliteKeyType(candidate.type));
62
+ if (column)
63
+ unkeyed.set(table.id, keyTypeRefusal('sqlite', table.id, column.name, sqliteTypeSaid(column.type)));
64
+ }
65
+ return unkeyed;
66
+ }
67
+ /**
68
+ * Whether SQLite's foreign key can find another parent than a check before the write, for a child column of affinity
69
+ * `child` and a parent key of `parent`, each of a type a key may be (keyTypes.ts: INTEGER or TEXT, and a typeless
70
+ * child). The foreign key applies the parent's affinity to what the child column stored (its own affinity applied to
71
+ * the value written, datatype3.html 3.0); the check applies the parent's affinity to the value written. The two part
72
+ * only where the child's affinity changes a value in a way the parent's does not undo:
73
+ *
74
+ * - BLOB (a typeless column) converts nothing: what it stores is what was written. Never.
75
+ * - The same affinity twice: applying one affinity again changes nothing. Never.
76
+ * - TEXT against an INTEGER key: a number stored as its text reads back as that number under the key's affinity, and
77
+ * a text stays the text it was. Never.
78
+ * - INTEGER against a TEXT key: "7.0" is stored as 7 and the key reads "7". The check, given "7.0", reads otherwise,
79
+ * and a number read back is the number given, so nothing after the statement tells them apart. Refused.
80
+ */
81
+ const affinitiesPart = (child, parent) => {
82
+ const [c, p] = [sqliteAffinity(child), sqliteAffinity(parent)];
83
+ return c !== 'BLOB' && c !== p && p === 'TEXT';
84
+ };
85
+ /**
86
+ * How each foreign key compares a reference (ScopeCatalog.references). SQLite's applies the parent column's affinity
87
+ * to the value the child column stored, which that column's own affinity made of what was written; a parent check
88
+ * binds what was written and the parent column applies its affinity to that. The two agree unless the child's
89
+ * affinity changes the value first in a way the parent's does not undo (affinitiesPart): an INTEGER column stores
90
+ * "7.0" as 7, which a TEXT key reads as '7', where the check's '7.0' found '7.0'. A write through such a foreign key
91
+ * cannot be checked, and is refused, as is one where either side is of a type a key may not be (keyTypes.ts); one
92
+ * through a typeless reference, or a TEXT one to an INTEGER key, is checked.
93
+ */
94
+ function sqliteReferences(schema) {
95
+ const typeOf = (table, name) => schema.tables.find((candidate) => candidate.id === table)?.columns.find((column) => column.name === name)?.type;
96
+ const references = new Map();
97
+ for (const fk of schema.foreignKeys) {
98
+ const types = fk.from.columns.map((column) => typeOf(fk.from.table, column));
99
+ const parents = fk.to.columns.map((column) => typeOf(fk.to.table, column));
100
+ /* Each side of a reference is a row's identity (keyTypes.ts): the key it points at of a type on the list, and the
101
+ reference too, or typeless (BLOB affinity), which stores what was written and so compares as the check does. */
102
+ const unkeyed = parents.findIndex((type) => type !== undefined && !sqliteKeyType(type));
103
+ const unkeyedChild = types.findIndex((type) => type !== undefined && !sqliteKeyType(type) && sqliteAffinity(type) !== 'BLOB');
104
+ const differ = types.findIndex((type, index) => type === undefined || parents[index] === undefined || affinitiesPart(type, parents[index]));
105
+ references.set(referenceKey(fk), unkeyed !== -1
106
+ ? { refused: `${keyTypeRefusal('sqlite', fk.to.table, fk.to.columns[unkeyed], sqliteTypeSaid(parents[unkeyed]))}.` }
107
+ : unkeyedChild !== -1
108
+ ? { refused: `${keyTypeRefusal('sqlite', fk.from.table, fk.from.columns[unkeyedChild], sqliteTypeSaid(types[unkeyedChild]))}.` }
109
+ : differ === -1 && types.length === parents.length
110
+ ? { columns: types.map((type) => ({ type: type })) }
111
+ : {
112
+ refused: `"${fk.from.table}".${fk.from.columns[differ] ?? fk.from.columns.join('+')} references "${fk.to.table}".${fk.to.columns[differ] ?? fk.to.columns.join('+')}, ` +
113
+ "a column of another affinity that changes the value before the foreign key compares it: SQLite's foreign key compares it as no check before the write can, so a scoped write that sets it is refused.",
114
+ });
115
+ }
116
+ return references;
117
+ }
118
+ /**
119
+ * How a key equality in a trigger compares on SQLite (triggerEffects.ts): each column's affinity, which decides what
120
+ * a value is converted to before it is compared, and its collation, which `NEW.code = code` takes from the column on
121
+ * its left; and the primary key as a key only where its index compares each column under that column's own
122
+ * collation (`PRIMARY KEY (code COLLATE NOCASE)` on a BINARY column is unique under one and found under the other).
123
+ * And the conflict clause a table declares other than ABORT, which a trigger's write runs under when the statement
124
+ * that fired it is a delete (triggerEffects.ts). Read where effects are judged, inside the writer's BEGIN IMMEDIATE.
125
+ */
126
+ export function sqliteKeyFacts(db) {
127
+ const definitions = new Map();
128
+ const definitionOf = (table) => {
129
+ if (!definitions.has(table.id)) {
130
+ const row = db.prepare("SELECT sql FROM main.sqlite_schema WHERE type = 'table' AND name = ?").get(table.name);
131
+ definitions.set(table.id, typeof row?.sql === 'string' ? row.sql : undefined);
132
+ }
133
+ return definitions.get(table.id);
134
+ };
135
+ const collations = new Map();
136
+ const collationsOf = (table) => {
137
+ if (!collations.has(table.id)) {
138
+ const sql = definitionOf(table);
139
+ collations.set(table.id, sql === undefined ? undefined : sqliteColumnCollations(sql));
140
+ }
141
+ return collations.get(table.id);
142
+ };
143
+ const conflicts = (table) => {
144
+ const sql = definitionOf(table);
145
+ const clauses = sql === undefined ? undefined : sqliteConflictClauses(sql);
146
+ if (!clauses)
147
+ return 'a conflict clause mistri cannot read';
148
+ // ABORT is what the statement's own OR ABORT would say; any other changes what a conflicting write does.
149
+ return clauses.find((clause) => clause !== 'ON CONFLICT ABORT');
150
+ };
151
+ const comparison = (table, name) => {
152
+ const column = table.columns.find((candidate) => folded(candidate.name) === folded(name));
153
+ const collation = column && collationsOf(table)?.get(folded(column.name));
154
+ if (!column || !collation)
155
+ return undefined;
156
+ const type = sqliteAffinity(column.type);
157
+ return {
158
+ type,
159
+ collation,
160
+ exact: true,
161
+ said: `${type} affinity, COLLATE ${collation}`,
162
+ keyable: sqliteKeyType(column.type),
163
+ declared: sqliteTypeSaid(column.type),
164
+ };
165
+ };
166
+ const keys = (table) => {
167
+ const primary = table.columns.filter((column) => column.primaryKey).map((column) => column.name);
168
+ if (!primary.length)
169
+ return [];
170
+ // A rowid alias holds integers alone, compared by no collation; it has no index of its own.
171
+ if (primary.length === 1 && table.columns.find((column) => column.name === primary[0])?.identity)
172
+ return [primary];
173
+ const index = db
174
+ .prepare(`PRAGMA main.index_list(${ANSI_STYLE.quote(table.name)})`)
175
+ .all()
176
+ .find((row) => row.origin === 'pk');
177
+ if (typeof index?.name !== 'string')
178
+ return [];
179
+ const indexed = db
180
+ .prepare(`PRAGMA main.index_xinfo(${ANSI_STYLE.quote(index.name)})`)
181
+ .all()
182
+ .filter((row) => row.key === 1);
183
+ const same = primary.every((name) => {
184
+ const at = indexed.find((row) => typeof row.name === 'string' && folded(row.name) === folded(name));
185
+ const own = comparison(table, name);
186
+ return typeof at?.coll === 'string' && own !== undefined && at.coll.toUpperCase() === own.collation;
187
+ });
188
+ return same && indexed.length === primary.length ? [primary] : [];
189
+ };
190
+ return { keys, comparison, conflicts };
191
+ }
192
+ /**
193
+ * For `mistri check`: the tables a scoped write cannot target for what they are rather than their triggers — a
194
+ * virtual table and its shadow tables, whose module writes them (scanSqliteScopeCatalog keeps them out of
195
+ * `writable`) — read on the reader, so check refuses an effect on one as the write does.
196
+ */
197
+ export function sqliteBlockedTables(db) {
198
+ const blocked = new Map();
199
+ for (const table of db.prepare('PRAGMA main.table_list').all()) {
200
+ if (table.schema !== 'main' || typeof table.name !== 'string')
201
+ continue;
202
+ if (table.type === 'virtual' || table.type === 'shadow')
203
+ blocked.set(table.name, "a virtual table's module, whose writes the policy cannot bound");
204
+ }
205
+ return blocked;
206
+ }
207
+ /** Metadata-only read attestation inside the caller's owned snapshot. Exposes
208
+ * no writer eligibility. Keep every non-engine table and dependency, including
209
+ * private/unmapped objects, so an unknown business edge cannot disappear. */
210
+ export function readSqliteReadCatalog(db) {
211
+ if (!db.isTransaction)
212
+ return refuse();
213
+ const { schema, readable } = scanSqliteScopeCatalog(db);
214
+ const ids = new Map(schema.tables.filter((table) => !folded(table.id).startsWith('sqlite_')).map((table) => [table.id, table.id]));
215
+ return { schema: mapScopeCatalog(schema, ids), readable };
216
+ }
217
+ function scanSqliteScopeCatalog(db) {
218
+ try {
219
+ if (db.prepare('PRAGMA foreign_keys').get()?.foreign_keys !== 1)
220
+ return refuse();
221
+ const entries = db
222
+ .prepare("SELECT name, type FROM main.sqlite_schema WHERE type IN ('table', 'view') ORDER BY name")
223
+ .all();
224
+ const listed = db.prepare('PRAGMA main.table_list').all();
225
+ // Unknown PRAGMAs can return nothing without throwing. Never interpret
226
+ // unavailable table-kind metadata as proof that a table is ordinary.
227
+ if (!listed.some((table) => table.schema === 'main' && table.name === 'sqlite_schema' && table.type === 'table'))
228
+ return refuse();
229
+ const kinds = identities(listed.filter((table) => table.schema === 'main'));
230
+ /* Each table's triggers, main and TEMP, with the statement that made them: which writes fire each, and whether
231
+ it only validates its row, is read from that text per table below (sqliteTriggers.ts, scopeTriggers.ts). */
232
+ const definitions = new Map();
233
+ for (const namespace of ['main', 'temp']) {
234
+ const triggers = db
235
+ .prepare(`SELECT tbl_name AS name, name AS trigger, sql FROM ${namespace}.sqlite_schema WHERE type = 'trigger' ORDER BY name`)
236
+ .all();
237
+ for (const trigger of triggers) {
238
+ if (typeof trigger.name !== 'string' || typeof trigger.trigger !== 'string')
239
+ return refuse();
240
+ definitions.set(folded(trigger.name), [
241
+ ...(definitions.get(folded(trigger.name)) ?? []),
242
+ { name: trigger.trigger, sql: trigger.sql },
243
+ ]);
244
+ }
245
+ }
246
+ const triggered = new Map();
247
+ const shadowed = new Set();
248
+ for (const table of db.prepare("SELECT name FROM temp.sqlite_schema WHERE type IN ('table', 'view')").all()) {
249
+ if (typeof table.name !== 'string')
250
+ return refuse();
251
+ shadowed.add(folded(table.name));
252
+ }
253
+ const tables = [];
254
+ const columnsByTable = new Map();
255
+ const writable = new Set();
256
+ const readable = new Set();
257
+ identities(entries);
258
+ for (const entry of entries) {
259
+ const kind = kinds.get(folded(entry.name));
260
+ if (!kind ||
261
+ kind.name !== entry.name ||
262
+ !['table', 'view', 'virtual', 'shadow'].includes(kind.type) ||
263
+ (entry.type === 'view') !== (kind.type === 'view'))
264
+ return refuse();
265
+ const columns = db.prepare(`PRAGMA main.table_xinfo(${ANSI_STYLE.quote(entry.name)})`).all();
266
+ identities(columns);
267
+ if (!columns.length || columns.length !== kind.ncol)
268
+ return refuse();
269
+ for (const [i, column] of columns.entries()) {
270
+ if (column.cid !== i ||
271
+ typeof column.type !== 'string' ||
272
+ !Number.isInteger(column.pk) ||
273
+ column.pk < 0 ||
274
+ ![0, 1].includes(column.notnull) ||
275
+ ![0, 1, 2, 3].includes(column.hidden) ||
276
+ (column.dflt_value !== null && typeof column.dflt_value !== 'string'))
277
+ return refuse();
278
+ }
279
+ const primary = columns.filter((column) => column.pk > 0).sort((a, b) => a.pk - b.pk);
280
+ if (primary.some((column, i) => column.pk !== i + 1))
281
+ return refuse();
282
+ const indexes = db.prepare(`PRAGMA main.index_list(${ANSI_STYLE.quote(entry.name)})`).all();
283
+ // INTEGER PRIMARY KEY DESC has a PK index and is not a rowid alias.
284
+ const identity = kind.type === 'table' &&
285
+ kind.wr === 0 &&
286
+ primary.length === 1 &&
287
+ /^INTEGER$/i.test(primary[0].type.trim()) &&
288
+ !indexes.some((index) => index.origin === 'pk')
289
+ ? primary[0].name
290
+ : undefined;
291
+ tables.push({
292
+ id: entry.name,
293
+ name: entry.name,
294
+ schema: 'main',
295
+ isView: kind.type === 'view',
296
+ columns: columns.map((column) => ({
297
+ name: column.name,
298
+ type: column.type || (kind.type === 'view' ? '' : 'BLOB'),
299
+ primaryKey: column.pk > 0,
300
+ nullable: column.notnull === 0 && column.name !== identity && !(column.pk > 0 && (kind.wr === 1 || kind.strict === 1)),
301
+ ...(column.dflt_value !== null ? { default: column.dflt_value } : {}),
302
+ ...(column.name === identity ? { identity: 'by-default' } : {}),
303
+ // The database computes a generated column from its row: read like any other, never written.
304
+ ...(generated(column) ? { writable: false } : {}),
305
+ })),
306
+ });
307
+ columnsByTable.set(entry.name, columns);
308
+ if (kind.type === 'table' &&
309
+ !folded(entry.name).startsWith('sqlite_') &&
310
+ !shadowed.has(folded(entry.name)) &&
311
+ columns.every((column) => column.hidden !== 1)) {
312
+ /* A table with triggers is written only by the writes that fire none of them but validation-only ones
313
+ (scopedTransaction.ts target): it stays out of `writable`, which says every write may run. */
314
+ const triggers = definitions.get(folded(entry.name));
315
+ if (!triggers)
316
+ writable.add(entry.name);
317
+ else {
318
+ const computed = new Set(columns.filter(generated).map((column) => folded(column.name)));
319
+ triggered.set(entry.name, triggers.map((trigger) => readSqliteTrigger(trigger.name, trigger.sql, computed)));
320
+ }
321
+ }
322
+ if (kind.type === 'table' &&
323
+ !folded(entry.name).startsWith('sqlite_') &&
324
+ !shadowed.has(folded(entry.name)) &&
325
+ // A generated column is read like any other; a virtual table's own columns (hidden 1) are its module's.
326
+ columns.every((column) => column.hidden !== 1))
327
+ readable.add(entry.name);
328
+ }
329
+ const byName = identities(tables);
330
+ const foreignKeys = [];
331
+ for (const table of tables) {
332
+ const rows = db.prepare(`PRAGMA main.foreign_key_list(${ANSI_STYLE.quote(table.name)})`).all();
333
+ const groups = new Map();
334
+ for (const row of rows) {
335
+ if (!Number.isInteger(row.id) ||
336
+ row.id < 0 ||
337
+ !Number.isInteger(row.seq) ||
338
+ row.seq < 0 ||
339
+ typeof row.table !== 'string' ||
340
+ typeof row.from !== 'string' ||
341
+ (row.to !== null && typeof row.to !== 'string'))
342
+ return refuse();
343
+ const group = groups.get(row.id) ?? [];
344
+ group.push(row);
345
+ groups.set(row.id, group);
346
+ }
347
+ const localColumns = identities(table.columns);
348
+ /* Every key a column sits in, judged together after the groups: one
349
+ column legitimately carries its own reference and its part in a
350
+ composite key (chooseColumnReference says which link a reader
351
+ follows, and which case is a contradiction). */
352
+ const candidates = new Map();
353
+ for (const [id, unordered] of groups) {
354
+ const group = unordered.sort((a, b) => a.seq - b.seq);
355
+ const first = group[0];
356
+ const parent = byName.get(folded(first.table));
357
+ const onDelete = deleteRuleOf(first.on_delete);
358
+ if (!parent ||
359
+ kinds.get(folded(parent.name))?.type !== 'table' ||
360
+ !onDelete ||
361
+ !deleteRuleOf(first.on_update) ||
362
+ group.some((row, i) => row.seq !== i ||
363
+ folded(row.table) !== folded(first.table) ||
364
+ row.on_delete !== first.on_delete ||
365
+ row.on_update !== first.on_update))
366
+ return refuse();
367
+ const parentColumns = identities(parent.columns);
368
+ const primary = columnsByTable
369
+ .get(parent.id)
370
+ .filter((column) => column.pk > 0)
371
+ .sort((a, b) => a.pk - b.pk);
372
+ const implicit = first.to === null;
373
+ if (group.some((row) => (row.to === null) !== implicit) || (implicit && primary.length !== group.length))
374
+ return refuse();
375
+ const from = group.map((row) => localColumns.get(folded(row.from))?.name ?? refuse());
376
+ const to = group.map((row, i) => (implicit ? primary[i].name : (parentColumns.get(folded(row.to))?.name ?? refuse())));
377
+ if (new Set(from).size !== from.length || new Set(to).size !== to.length)
378
+ return refuse();
379
+ foreignKeys.push({
380
+ name: `${table.name}_fk_${id}`,
381
+ from: { table: table.id, columns: from },
382
+ to: { table: parent.id, columns: to },
383
+ onDelete,
384
+ });
385
+ for (const [i, name] of from.entries()) {
386
+ const column = localColumns.get(folded(name));
387
+ const listed = candidates.get(column.name) ?? [];
388
+ listed.push({ reference: { table: parent.id, column: to[i] }, composite: group.length > 1 });
389
+ candidates.set(column.name, listed);
390
+ }
391
+ }
392
+ for (const [name, listed] of candidates) {
393
+ const chosen = chooseColumnReference(listed);
394
+ // This is the attesting path, so a contradiction refuses the catalog.
395
+ // The adapter's own describe keeps the same verdict and shows no link
396
+ // instead: see chooseColumnReference for why the two differ.
397
+ if (chosen.kind === 'conflict')
398
+ return refuse();
399
+ if (chosen.kind === 'one')
400
+ localColumns.get(folded(name)).references = chosen.reference;
401
+ }
402
+ }
403
+ return {
404
+ schema: { dialect: 'sqlite', label: 'SQLite scoped transaction', readAt: new Date().toISOString(), tables, foreignKeys },
405
+ writable,
406
+ readable,
407
+ triggered,
408
+ };
409
+ }
410
+ catch (error) {
411
+ if (error instanceof Refusal)
412
+ throw error;
413
+ // Missing/broken objects and unknown metadata cannot weaken the boundary.
414
+ // Refused either way; a busy or failing engine is kept as the cause.
415
+ const { code, errcode } = (error ?? {});
416
+ if (code === 'ERR_SQLITE_ERROR' && typeof errcode === 'number' && UNAVAILABLE.has(errcode & 0xff))
417
+ return refuse(error);
418
+ return refuse();
419
+ }
420
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * SQLite's second look at what an accepted trigger wrote (docs/trigger-effects.md, decision 2): the proof
3
+ * (triggerProof.ts) reaches every row an effect names before and after its statement, and this checks that the
4
+ * database did no more. From the first write that fires an accepted trigger, a session records the transaction's
5
+ * changes; before COMMIT its changeset is read, and every change SQLite marks indirect — made by a trigger, not by
6
+ * the transaction's own statements — must be a row the proof reached. One that is not refuses the transaction
7
+ * whole, so a trigger the grammar misread cannot write past it.
8
+ *
9
+ * A change is matched by what it did as well as by its key: an insert the proof reached is no warrant for an update
10
+ * of a row with that key. A table's `ON CONFLICT REPLACE` turns an insert into an overwrite of the row already
11
+ * there, which the changeset records as an update (triggerEffects.ts refuses such a table as an effect's; this
12
+ * would still see it). A changeset folds the changes to one row into one: an insert then an update is an insert, an
13
+ * update then a delete a delete, and a delete then an insert of the same key an update.
14
+ *
15
+ * A change SQLite calls direct is not always only the transaction's own: one to a row the transaction wrote itself
16
+ * stays direct however many triggers write that row after (sqlite3session_indirect), so a trigger the proof never
17
+ * reached could rewrite such a row unseen. After each of the transaction's own statements the witness keeps what the
18
+ * changeset says of the row it wrote, and from then on that row's change must stay as kept unless the proof reached
19
+ * it since: checked after every later statement and before COMMIT. What a trigger writes to that row within the very
20
+ * statement that writes it folds into the statement's own change and is not told apart.
21
+ *
22
+ * A scoped delete never cascades (scopedTransaction.ts refuses one others reference), so a trigger is the only
23
+ * source of an indirect change here. A session sees only tables with a primary key, so an effect on one without is
24
+ * refused when it is proven.
25
+ */
26
+ import type { DatabaseSync } from 'node:sqlite';
27
+ import type { TableMeta } from '../../shared/schema.js';
28
+ import type { TriggerChange } from './triggerProof.js';
29
+ export interface TriggerWitness {
30
+ /** Before a statement that fires an accepted trigger: from here on, the transaction's changes are recorded. */
31
+ watch(): void;
32
+ /** A row the proof reached. */
33
+ proven(change: TriggerChange): void;
34
+ /**
35
+ * After one of the transaction's own statements, the row it wrote: its table and primary key, and for an update the
36
+ * values it set (a key it changed is the row's key now). Every row an earlier statement wrote is still as that
37
+ * statement left it, or the proof reached it since, or `refuse` throws.
38
+ */
39
+ wrote(table: string, key: Readonly<Record<string, unknown>>, values?: Readonly<Record<string, unknown>>): void;
40
+ /**
41
+ * A row's key as its table stores it, read by the key a write names (or that key, where no row has it): what a
42
+ * delete is told by, read before the row is gone. `wrote` reads the stored key itself after an insert or update.
43
+ */
44
+ stored(table: string, key: Readonly<Record<string, unknown>>): Readonly<Record<string, unknown>>;
45
+ /** Before COMMIT: every indirect change is one the proof reached, and every row the transaction wrote is as it last
46
+ * left it or reached since, or `refuse` throws. Ends the session. */
47
+ settle(): void;
48
+ /** Ends the session without a look: the transaction is rolling back. */
49
+ close(): void;
50
+ }
51
+ type Value = string | number | null | undefined;
52
+ /** One change of a changeset: its table, its operation, whether a trigger made it, its primary key's values by column
53
+ * position, and every value it records (an update's old values then its new, undefined where a column is unchanged). */
54
+ interface Change {
55
+ readonly table: string;
56
+ readonly op: 'insert' | 'update' | 'delete';
57
+ readonly indirect: boolean;
58
+ readonly key: ReadonlyMap<number, Value>;
59
+ readonly values: readonly Value[];
60
+ }
61
+ /** The changes of a changeset (sqlite.org/sessionintro.html, "changeset format"). */
62
+ export declare function readChangeset(bytes: Uint8Array): Change[];
63
+ export declare function sqliteTriggerWitness(db: DatabaseSync, tables: readonly TableMeta[]): TriggerWitness;
64
+ export {};