@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,264 @@
1
+ /**
2
+ * The guard a caller can put in front of raw SQL: a statement that touches
3
+ * tablewalk's own runtime tables (the `__mistri_` prefix on every engine, and
4
+ * PostgreSQL's runtime schema, shared/runtimeTables.ts) is refused before it
5
+ * runs. The MCP `sql` and `explain` tools ask for it.
6
+ *
7
+ * This file is the lexical half, and it is conservative on purpose. It reads
8
+ * every identifier, quoted or not, every string and every comment, and
9
+ * refuses when one of them spells a reserved name — a string can become a
10
+ * relation through a cast. It refuses the constructs that reach a relation whose name is
11
+ * only computed when the statement runs (regclass casts, the functions that
12
+ * run SQL text they are handed), and escapes it will not decode, because a
13
+ * guard that cannot read a statement should not wave it through. The engine
14
+ * half lives in the adapters: SQLite's authorizer and Postgres's plan both
15
+ * name the relations a statement actually reads, views and search_path
16
+ * included, which no reading of the text can.
17
+ *
18
+ * Not a sandbox. A function the database's own users wrote reads what its
19
+ * owner may; the database role is the boundary for that.
20
+ */
21
+ import { isRuntimeTable, RUNTIME_SCHEMA, RUNTIME_TABLE_PREFIXES } from '../shared/runtimeTables.js';
22
+ import { looksWrappable, Refusal, trimStatement } from './adapter.js';
23
+ /* PostgreSQL keeps every runtime table, sign-in's included, in one schema
24
+ (shared/runtimeTables.ts): never listed, not even when `--schema` names it,
25
+ and refused as a generic write target. The prefix rule cannot say this,
26
+ because the tables inside are named plainly (`command`, `auth_user`); the
27
+ schema does. The name is the engine's, not an import of a store: the engine
28
+ hides it in a database the browser opens with no App framework installed. */
29
+ export const RESERVED_SCHEMAS = [RUNTIME_SCHEMA];
30
+ /** Whether a relation, as the engine names it, is tablewalk's own. */
31
+ export function isReservedRelation(schema, name) {
32
+ return isRuntimeTable(name) || (schema !== undefined && RESERVED_SCHEMAS.includes(schema.toLowerCase()));
33
+ }
34
+ /** The refusal for a statement found to touch `name`, by whichever half found it. */
35
+ export function reservedRefusal(name) {
36
+ return new Refusal(`This statement touches "${name}", one of the runtime or sign-in tables ` +
37
+ `(the reserved ${RUNTIME_TABLE_PREFIXES.join(' and ')} prefix and the ${RESERVED_SCHEMAS.join(', ')} schema), which raw SQL here does not read.`);
38
+ }
39
+ /* Postgres names that reach a relation only when the statement runs: a
40
+ regclass cast turns any text or number into a table, and these functions
41
+ run the SQL text, or read the relation, they are handed. `table_to_xml`
42
+ takes a bare oid, so there is not even a name to read. */
43
+ const COMPUTED_RELATION = /^(?:regclass|to_regclass|\w*_to_xml\w*|ts_stat|dblink\w*|crosstab\d*|connectby|get_raw_page)$/i;
44
+ /**
45
+ * The statement's words, quoted identifiers and texts (strings, dollar
46
+ * bodies, comments), in order — or the reason it cannot be read.
47
+ */
48
+ function tokenize(sql, dialect) {
49
+ const tokens = [];
50
+ const n = sql.length;
51
+ let i = 0;
52
+ /* A quoted run with its closing character doubled as the escape. A
53
+ backslash escape (Postgres's E'…') can only make the run longer when read
54
+ as one, which the text check still reads. */
55
+ const quoted = (close, backslash) => {
56
+ let value = '';
57
+ i += 1;
58
+ while (i < n) {
59
+ const ch = sql[i];
60
+ if (backslash && ch === '\\' && i + 1 < n) {
61
+ value += sql[i + 1];
62
+ i += 2;
63
+ continue;
64
+ }
65
+ if (ch === close && sql[i + 1] === close) {
66
+ value += close;
67
+ i += 2;
68
+ continue;
69
+ }
70
+ if (ch === close) {
71
+ i += 1;
72
+ break;
73
+ }
74
+ value += ch;
75
+ i += 1;
76
+ }
77
+ return value;
78
+ };
79
+ while (i < n) {
80
+ const ch = sql[i];
81
+ const next = sql[i + 1];
82
+ if (/\s/.test(ch)) {
83
+ i += 1;
84
+ continue;
85
+ }
86
+ if (ch === '-' && next === '-') {
87
+ const end = sql.indexOf('\n', i);
88
+ tokens.push({ kind: 'text', value: sql.slice(i, end < 0 ? n : end) });
89
+ i = end < 0 ? n : end + 1;
90
+ continue;
91
+ }
92
+ if (ch === '/' && next === '*') {
93
+ /* Postgres nests block comments; the others end at the first close. */
94
+ let depth = 0;
95
+ const start = i;
96
+ while (i < n) {
97
+ if (sql[i] === '/' && sql[i + 1] === '*') {
98
+ depth += 1;
99
+ i += 2;
100
+ continue;
101
+ }
102
+ if (sql[i] === '*' && sql[i + 1] === '/') {
103
+ depth -= 1;
104
+ i += 2;
105
+ if (depth === 0 || dialect !== 'postgres')
106
+ break;
107
+ continue;
108
+ }
109
+ i += 1;
110
+ }
111
+ tokens.push({ kind: 'text', value: sql.slice(start, i) });
112
+ continue;
113
+ }
114
+ if (ch === '$' && dialect === 'postgres') {
115
+ const tag = /^\$[A-Za-z_]\w*\$|^\$\$/.exec(sql.slice(i))?.[0];
116
+ if (tag) {
117
+ const end = sql.indexOf(tag, i + tag.length);
118
+ tokens.push({ kind: 'text', value: sql.slice(i + tag.length, end < 0 ? n : end) });
119
+ i = end < 0 ? n : end + tag.length;
120
+ continue;
121
+ }
122
+ }
123
+ if (dialect === 'postgres' && /^u&["']/i.test(sql.slice(i, i + 3))) {
124
+ /* A Unicode-escaped identifier or string spells a name in code points
125
+ this check does not decode; one without escapes reads as it is. */
126
+ i += 2;
127
+ const close = sql[i];
128
+ const value = quoted(close, false);
129
+ if (value.includes('\\') || /^\s*uescape\b/i.test(sql.slice(i))) {
130
+ return ('This statement spells a name with Unicode escapes (U&"…"), which the reserved-table check does not decode, ' +
131
+ 'so it is refused rather than run. Spell the name plainly.');
132
+ }
133
+ tokens.push({ kind: close === '"' ? 'quoted' : 'text', value });
134
+ continue;
135
+ }
136
+ if (ch === "'") {
137
+ /* E'…' is Postgres's backslash-escaped string. */
138
+ const escaped = dialect === 'postgres' && /[eE]$/.test(sql.slice(Math.max(0, i - 1), i));
139
+ tokens.push({ kind: 'text', value: quoted("'", escaped) });
140
+ continue;
141
+ }
142
+ if (ch === '"') {
143
+ tokens.push({ kind: 'quoted', value: quoted('"', false) });
144
+ continue;
145
+ }
146
+ if (ch === '`' && dialect !== 'postgres') {
147
+ tokens.push({ kind: 'quoted', value: quoted('`', false) });
148
+ continue;
149
+ }
150
+ if (ch === '[' && dialect === 'sqlite') {
151
+ tokens.push({ kind: 'quoted', value: quoted(']', false) });
152
+ continue;
153
+ }
154
+ const word = /^[A-Za-z_€-￿][\w$€-￿]*/.exec(sql.slice(i))?.[0];
155
+ if (word) {
156
+ tokens.push({ kind: 'word', value: word });
157
+ i += word.length;
158
+ continue;
159
+ }
160
+ i += 1;
161
+ }
162
+ return tokens;
163
+ }
164
+ // A match in text (a comment, a string)
165
+ // takes the rest of the name, so the refusal names the table, not the prefix.
166
+ const RESERVED_TEXT = new RegExp(`(?:${RUNTIME_TABLE_PREFIXES.join('|')})[\\w$]*|\\b(?:${RESERVED_SCHEMAS.join('|')})\\b`, 'i');
167
+ /**
168
+ * Why this statement must not run under the guard, or null when nothing in
169
+ * its text reaches a reserved relation.
170
+ */
171
+ export function reservedInText(sql, dialect) {
172
+ const tokens = tokenize(sql, dialect);
173
+ if (typeof tokens === 'string')
174
+ return tokens;
175
+ for (const token of tokens) {
176
+ if (token.kind === 'text') {
177
+ const found = RESERVED_TEXT.exec(token.value);
178
+ if (found)
179
+ return reservedRefusal(found[0]).message;
180
+ continue;
181
+ }
182
+ const name = token.value;
183
+ if (isRuntimeTable(name) || (dialect === 'postgres' && RESERVED_SCHEMAS.includes(name.toLowerCase()))) {
184
+ return reservedRefusal(name).message;
185
+ }
186
+ if (dialect === 'postgres' && COMPUTED_RELATION.test(name)) {
187
+ return (`This statement uses ${name}, which reaches a relation by a name computed when it runs, so it is refused ` +
188
+ `rather than run: raw SQL here does not read the runtime or sign-in tables, and a name ` +
189
+ 'that is not written down cannot be checked.');
190
+ }
191
+ }
192
+ return null;
193
+ }
194
+ /** @throws Refusal when the statement's text reaches a reserved relation. */
195
+ export function refuseReservedText(sql, dialect) {
196
+ const reason = reservedInText(sql, dialect);
197
+ if (reason)
198
+ throw new Refusal(reason);
199
+ }
200
+ /**
201
+ * The Postgres check before a statement is given a connection: its text,
202
+ * and for a read, whether the planner can list what it reads — the engine
203
+ * half below needs a plan, so a statement the planner cannot explain is
204
+ * refused rather than run unchecked.
205
+ */
206
+ export function refusePostgresReserved(sql, write = false) {
207
+ refuseReservedText(sql, 'postgres');
208
+ if (!write && !looksWrappable(sql)) {
209
+ throw new Refusal("The reserved-table check reads the planner's list of what a statement scans, so it " +
210
+ 'runs the statements the planner can explain: SELECT, WITH, TABLE and VALUES.');
211
+ }
212
+ }
213
+ /**
214
+ * The Postgres engine half: the planner's own list of what a statement
215
+ * scans, read inside the transaction it will run in, so views, search_path
216
+ * and CTEs resolve as they will there.
217
+ */
218
+ export async function refuseReservedPlan(db, sql, params) {
219
+ /* On the extended protocol even with no parameters: on the simple one,
220
+ Postgres would run a statement stacked behind the EXPLAIN before any
221
+ plan came back to read. */
222
+ const planned = await db.query({
223
+ text: `EXPLAIN (VERBOSE, FORMAT JSON) ${trimStatement(sql)}`,
224
+ values: params,
225
+ rowMode: 'array',
226
+ queryMode: 'extended',
227
+ });
228
+ const found = reservedInPlan(planned.rows[0]?.[0]);
229
+ if (found)
230
+ throw reservedRefusal(found);
231
+ }
232
+ /**
233
+ * The first reserved relation a Postgres `EXPLAIN (VERBOSE, FORMAT JSON)`
234
+ * plan reads. The plan is the planner's list of what the statement will
235
+ * actually scan — views expanded, search_path resolved, CTEs and subqueries
236
+ * included. What a function reads by a computed name is not in it; the
237
+ * lexical half refuses those functions by name.
238
+ */
239
+ export function reservedInPlan(plan) {
240
+ if (Array.isArray(plan)) {
241
+ for (const item of plan) {
242
+ const found = reservedInPlan(item);
243
+ if (found)
244
+ return found;
245
+ }
246
+ return null;
247
+ }
248
+ if (!plan || typeof plan !== 'object')
249
+ return null;
250
+ const node = plan;
251
+ const relation = node['Relation Name'];
252
+ const schema = typeof node.Schema === 'string' ? node.Schema : undefined;
253
+ if (typeof relation === 'string' && isReservedRelation(schema, relation)) {
254
+ return schema ? `${schema}.${relation}` : relation;
255
+ }
256
+ for (const value of Object.values(node)) {
257
+ if (value && typeof value === 'object') {
258
+ const found = reservedInPlan(value);
259
+ if (found)
260
+ return found;
261
+ }
262
+ }
263
+ return null;
264
+ }
@@ -0,0 +1,17 @@
1
+ /**
2
+ * A database role's reach beyond reading, behind `Adapter.privileges`: one
3
+ * catalog query on PostgreSQL. Every read runs
4
+ * in a read-only transaction, which holds for everything tablewalk sends but
5
+ * not for a superuser (`COPY … TO PROGRAM` is a read); the role is the
6
+ * boundary that always holds, so the registry says when it is wider than a
7
+ * read-only connection.
8
+ */
9
+ import type { RolePrivileges } from './adapter.js';
10
+ type Reader = {
11
+ query(text: string, params?: unknown[]): Promise<{
12
+ rows: unknown[];
13
+ }>;
14
+ };
15
+ /** Superuser, write grants on the browsed tables, CREATE in a browsed schema. */
16
+ export declare function postgresPrivileges(db: Reader, browsed: readonly string[], system: readonly string[]): Promise<RolePrivileges>;
17
+ export {};
@@ -0,0 +1,22 @@
1
+ import { RESERVED_SCHEMAS } from './reservedSql.js';
2
+ import { notExtensionMember } from './postgresCatalog.js';
3
+ /** Superuser, write grants on the browsed tables, CREATE in a browsed schema. */
4
+ export async function postgresPrivileges(db, browsed, system) {
5
+ const schemas = browsed.length ? browsed.filter((schema) => !RESERVED_SCHEMAS.includes(schema)) : [...system, ...RESERVED_SCHEMAS];
6
+ // Temporary and toast namespaces are the session's own, not the database's.
7
+ const within = `${browsed.length ? 'n.nspname = ANY($1)' : 'n.nspname <> ALL($1)'} AND n.nspname NOT LIKE 'pg\\_%'`;
8
+ const { rows } = await db.query(`SELECT r.rolsuper AS superuser,
9
+ (SELECT count(*)::int FROM pg_class c JOIN pg_namespace n ON n.oid = c.relnamespace
10
+ WHERE c.relkind IN ('r', 'p') AND ${notExtensionMember('c')} AND ${within}
11
+ AND (has_table_privilege(c.oid, 'INSERT') OR has_table_privilege(c.oid, 'UPDATE')
12
+ OR has_table_privilege(c.oid, 'DELETE') OR has_table_privilege(c.oid, 'TRUNCATE'))) AS writable,
13
+ EXISTS (SELECT 1 FROM pg_namespace n WHERE ${within} AND has_schema_privilege(n.oid, 'CREATE')) AS can_create
14
+ FROM pg_roles r WHERE r.rolname = current_user`, [schemas]);
15
+ const row = rows[0] ?? {};
16
+ const writable = Number(row.writable ?? 0);
17
+ return {
18
+ superuser: row.superuser === true,
19
+ create: row.can_create === true,
20
+ writes: writable ? [`INSERT/UPDATE/DELETE on ${writable} table${writable === 1 ? '' : 's'}`] : [],
21
+ };
22
+ }
@@ -0,0 +1,65 @@
1
+ /**
2
+ * A record's row, read once in full through the row scope by its key, and
3
+ * every later read of that record by the same key, in the same transaction
4
+ * and under the same scope, answered from it: the columns it asks for, in its
5
+ * order, from the row already read.
6
+ *
7
+ * A command reads its target by key several times before it writes — whether
8
+ * it is visible, its revision, the columns its machine moves, the before image
9
+ * its audit keeps, the guard the write checks — each a round trip of its own,
10
+ * each the same row. Read under the row lock the transaction takes first
11
+ * (postgres.ts sends both ahead, behind its BEGIN), the row cannot move
12
+ * underneath it, and a row scope's visibility is decided by the row's own
13
+ * columns (shared/rowScope.ts), so the projection is what each read would
14
+ * have answered.
15
+ *
16
+ * Only while the transaction has sent nothing that could change it: a row is
17
+ * kept with the transaction's statement generation (postgresTransactionHandle
18
+ * generationOf), which moves with every statement that is not a read or a
19
+ * lock — its own write, a savepoint, a rollback, a failure — and a row kept
20
+ * under an older generation answers nothing. Only reads that name the
21
+ * table's primary key by equality, from the first row, with no order, are
22
+ * answered; anything else is asked in its turn. A read that also names other
23
+ * columns by equality (a guard: the record, and only in the state it moves
24
+ * from) is answered only where the kept row holds exactly the value asked,
25
+ * identical in type and content: identical values are equal under any
26
+ * collation or type the server compares them by, so that answer is the
27
+ * server's. Where they differ (a numeric's text, a citext's case, a bytea),
28
+ * the read is asked in its turn rather than answered with no row.
29
+ */
30
+ import { type Filter, type QueryRequest, type ScopedReads, type SqlFragment } from '../adapter.js';
31
+ import type { DatabaseSchema, TableMeta } from '../../shared/schema.js';
32
+ import type { RowScope } from '../../shared/rowScope.js';
33
+ type Row = Record<string, unknown>;
34
+ type Reads = Pick<ScopedReads, 'query'> & Partial<ScopedReads>;
35
+ export declare class KeyRows {
36
+ #private;
37
+ /** The transaction's statement generation now; undefined where it has none (nothing is kept). */
38
+ private readonly generation;
39
+ constructor(
40
+ /** The transaction's statement generation now; undefined where it has none (nothing is kept). */
41
+ generation: () => number | undefined);
42
+ /** Keep nothing more and answer nothing from what was kept (the catalog the rows were read under is not the transaction's). */
43
+ forget(): void;
44
+ /** Keep the rows a full read of `table` by its key will answer (`rows`, the driver's own, unconverted). */
45
+ keep(scope: RowScope, table: TableMeta, filter: Filter, rows: Promise<readonly Row[]>, take?: () => void): void;
46
+ /**
47
+ * `reads`, with every read by key answered from a kept row where one is
48
+ * kept. `statementOf` says the statement the read would have sent (its
49
+ * `sql`); `format` turns a driver row into the read's own (binary or not, as
50
+ * the read's executor would). With `keeps`, a full read by key that is asked
51
+ * in its turn is kept for those after it (a guard's read: its rows are the
52
+ * driver's own). With `widen`, a read by key of a row the transaction holds
53
+ * locked (`held`), with nothing kept of it since the transaction last
54
+ * changed something, is sent as a full read through `widen.reads` (whose
55
+ * rows are the driver's own) and kept, and answered from it: the row cannot
56
+ * move while the lock is held, so the reads of it that follow — the guard
57
+ * reads of the write it is read for — are answered from it too, rather
58
+ * than each asked in its turn.
59
+ */
60
+ over<R extends Reads>(reads: R, scope: RowScope, schema: DatabaseSchema, statementOf: (request: QueryRequest) => SqlFragment | undefined, format: (row: Row, request: QueryRequest) => Row, keeps: boolean, widen?: {
61
+ held(table: TableMeta, key: Readonly<Record<string, string | number>>): boolean;
62
+ reads: Pick<ScopedReads, 'query'>;
63
+ }): R;
64
+ }
65
+ export {};
@@ -0,0 +1,179 @@
1
+ /**
2
+ * A record's row, read once in full through the row scope by its key, and
3
+ * every later read of that record by the same key, in the same transaction
4
+ * and under the same scope, answered from it: the columns it asks for, in its
5
+ * order, from the row already read.
6
+ *
7
+ * A command reads its target by key several times before it writes — whether
8
+ * it is visible, its revision, the columns its machine moves, the before image
9
+ * its audit keeps, the guard the write checks — each a round trip of its own,
10
+ * each the same row. Read under the row lock the transaction takes first
11
+ * (postgres.ts sends both ahead, behind its BEGIN), the row cannot move
12
+ * underneath it, and a row scope's visibility is decided by the row's own
13
+ * columns (shared/rowScope.ts), so the projection is what each read would
14
+ * have answered.
15
+ *
16
+ * Only while the transaction has sent nothing that could change it: a row is
17
+ * kept with the transaction's statement generation (postgresTransactionHandle
18
+ * generationOf), which moves with every statement that is not a read or a
19
+ * lock — its own write, a savepoint, a rollback, a failure — and a row kept
20
+ * under an older generation answers nothing. Only reads that name the
21
+ * table's primary key by equality, from the first row, with no order, are
22
+ * answered; anything else is asked in its turn. A read that also names other
23
+ * columns by equality (a guard: the record, and only in the state it moves
24
+ * from) is answered only where the kept row holds exactly the value asked,
25
+ * identical in type and content: identical values are equal under any
26
+ * collation or type the server compares them by, so that answer is the
27
+ * server's. Where they differ (a numeric's text, a citext's case, a bytea),
28
+ * the read is asked in its turn rather than answered with no row.
29
+ */
30
+ import { clampLimit } from '../adapter.js';
31
+ import { storedTextOf } from './storedText.js';
32
+ export class KeyRows {
33
+ generation;
34
+ #entries = new Map();
35
+ #scopes = new WeakMap();
36
+ #next = 0;
37
+ constructor(
38
+ /** The transaction's statement generation now; undefined where it has none (nothing is kept). */
39
+ generation) {
40
+ this.generation = generation;
41
+ }
42
+ /** Keep nothing more and answer nothing from what was kept (the catalog the rows were read under is not the transaction's). */
43
+ forget() {
44
+ this.#entries.clear();
45
+ }
46
+ #scope(scope) {
47
+ let id = this.#scopes.get(scope);
48
+ if (id === undefined)
49
+ this.#scopes.set(scope, (id = this.#next++));
50
+ return id;
51
+ }
52
+ /** The key a read of `table` by `filter` is kept under: undefined unless the filter is exactly the primary key by equality. */
53
+ #keyOf(scope, table, filter) {
54
+ const found = this.#guarded(scope, table, filter);
55
+ return found && !found.also.length ? found.key : undefined;
56
+ }
57
+ /** The key of a read by the primary key by equality, and the other columns it names by equality (`also`). */
58
+ #guarded(scope, table, filter) {
59
+ const pk = table.columns.filter((column) => column.primaryKey).map((column) => column.name);
60
+ const group = filter?.groups.length === 1 ? filter.groups[0] : undefined;
61
+ if (!pk.length || !group || group.length < pk.length)
62
+ return undefined;
63
+ const values = {};
64
+ const also = [];
65
+ for (const condition of group) {
66
+ if (condition.op !== '=' || Object.keys(condition).length !== 3)
67
+ return undefined;
68
+ if (pk.includes(condition.column)) {
69
+ if (typeof condition.value !== 'string' && typeof condition.value !== 'number')
70
+ return undefined;
71
+ if (Object.hasOwn(values, condition.column))
72
+ return undefined;
73
+ values[condition.column] = condition.value;
74
+ continue;
75
+ }
76
+ const column = table.columns.find((candidate) => candidate.name === condition.column);
77
+ // json has no equality operator: the server refuses that read, so it is sent for the server to say so.
78
+ if (!column || /^json$/i.test(column.type))
79
+ return undefined;
80
+ if (typeof condition.value !== 'string' && typeof condition.value !== 'number' && typeof condition.value !== 'boolean')
81
+ return undefined;
82
+ also.push({ column: condition.column, value: condition.value });
83
+ }
84
+ if (Object.keys(values).length !== pk.length)
85
+ return undefined;
86
+ return { key: JSON.stringify([this.#scope(scope), table.id, pk.map((column) => values[column])]), values, also };
87
+ }
88
+ /** Keep the rows a full read of `table` by its key will answer (`rows`, the driver's own, unconverted). */
89
+ keep(scope, table, filter, rows, take) {
90
+ const generation = this.generation(), key = this.#keyOf(scope, table, filter);
91
+ if (generation === undefined || key === undefined)
92
+ return;
93
+ this.#entries.set(key, {
94
+ generation,
95
+ // A failed read answers nothing: each read is then asked in its turn.
96
+ rows: rows.then((found) => found, () => undefined),
97
+ take,
98
+ });
99
+ }
100
+ /**
101
+ * `reads`, with every read by key answered from a kept row where one is
102
+ * kept. `statementOf` says the statement the read would have sent (its
103
+ * `sql`); `format` turns a driver row into the read's own (binary or not, as
104
+ * the read's executor would). With `keeps`, a full read by key that is asked
105
+ * in its turn is kept for those after it (a guard's read: its rows are the
106
+ * driver's own). With `widen`, a read by key of a row the transaction holds
107
+ * locked (`held`), with nothing kept of it since the transaction last
108
+ * changed something, is sent as a full read through `widen.reads` (whose
109
+ * rows are the driver's own) and kept, and answered from it: the row cannot
110
+ * move while the lock is held, so the reads of it that follow — the guard
111
+ * reads of the write it is read for — are answered from it too, rather
112
+ * than each asked in its turn.
113
+ */
114
+ over(reads, scope, schema, statementOf, format, keeps, widen) {
115
+ const query = async (request) => {
116
+ const table = schema.tables.find((candidate) => candidate.id === request?.table);
117
+ const guarded = table && !request.orderBy?.length && !request.offset && clampLimit(request.limit) >= 1
118
+ ? this.#guarded(scope, table, request.filter)
119
+ : undefined;
120
+ const key = guarded && !guarded.also.length ? guarded.key : undefined;
121
+ // Asked again after a statement that moved the generation, of a column the row does not carry, or of a value it does not hold exactly: in its turn.
122
+ const answer = async (kept) => {
123
+ const rows = await kept.rows;
124
+ const names = [
125
+ ...(request.columns?.length ? request.columns : table.columns.map((column) => column.name)),
126
+ // A scoped write's read of the stored texts is answered only by a row read with them (storedText.ts).
127
+ ...(request.storedText ? [storedTextOf(schema, table)?.alias ?? []].flat() : []),
128
+ ];
129
+ const sql = statementOf(request);
130
+ if (!rows ||
131
+ !sql ||
132
+ kept.generation !== this.generation() ||
133
+ !rows.every((row) => names.every((name) => Object.hasOwn(row, name))) ||
134
+ !rows.every((row) => guarded.also.every((condition) => Object.hasOwn(row, condition.column) && row[condition.column] === condition.value)))
135
+ return undefined;
136
+ kept.take?.();
137
+ return {
138
+ columns: request.columns?.length ? [...request.columns] : table.columns.map((column) => column.name),
139
+ rows: rows
140
+ .slice(0, clampLimit(request.limit))
141
+ .map((row) => format(Object.fromEntries(names.map((name) => [name, row[name]])), request)),
142
+ ms: 0,
143
+ sql,
144
+ };
145
+ };
146
+ const current = this.generation();
147
+ const kept = guarded === undefined ? undefined : this.#entries.get(guarded.key);
148
+ if (kept && kept.generation === current) {
149
+ const answered = await answer(kept);
150
+ if (answered)
151
+ return answered;
152
+ }
153
+ else if (key !== undefined && current !== undefined && widen?.held(table, guarded.values)) {
154
+ // With the stored texts, so the scoped write's own reads of the row are answered from it too.
155
+ const sent = widen.reads.query({ table: request.table, filter: request.filter, limit: 2, offset: 0, storedText: true });
156
+ /* Its generation is the one it was sent under: what waited for the COMMIT leaves in front of it, in its flight
157
+ (postgresTransactionHandle), moving the generation as it goes, and the row it reads is after that. Kept
158
+ under the generation before it was sent, it would answer nothing after it. Reads are sent as they are
159
+ asked (createScopedReads compiles before it executes), so this is that moment. */
160
+ const generation = this.generation();
161
+ // A failure is the read's own: thrown as it would have been asked.
162
+ const full = await sent;
163
+ const read = { generation: generation ?? current, rows: Promise.resolve(full.rows) };
164
+ this.#entries.set(key, read);
165
+ const answered = await answer(read);
166
+ if (answered)
167
+ return answered;
168
+ }
169
+ if (!keeps || key === undefined || request.columns?.length)
170
+ return reads.query(request);
171
+ const generation = this.generation();
172
+ const result = await reads.query(request);
173
+ if (generation !== undefined && generation === this.generation())
174
+ this.#entries.set(key, { generation, rows: Promise.resolve(result.rows) });
175
+ return result;
176
+ };
177
+ return Object.freeze({ ...reads, query });
178
+ }
179
+ }
@@ -0,0 +1,34 @@
1
+ /**
2
+ * The types a scoped write takes as a row's identity (docs/trigger-effects.md, "Key types").
3
+ *
4
+ * Under a row policy, every check names a row by a value: a write's own row by its primary key, a parent by the
5
+ * reference that points at it, a row a trigger reaches by its effect's key. The check is sound only where the value
6
+ * it binds is the value the database compares. Six reviews found the same defect in new places: the driver's
7
+ * JavaScript reading of a jsonb key (2^53 rounded, "123" read as 123), SQLite's numeric(p,s) said with its scale
8
+ * (19.987 read as "19.99"), a float or timestamp whose text depends on the session's settings. So a column that is a
9
+ * row's identity — a primary key, either side of a foreign key, either side of a trigger effect's key — must be of a
10
+ * type whose value reads back exactly, through the driver and through text, and any other is refused from the
11
+ * catalog, before a value is read:
12
+ *
13
+ * - PostgreSQL, a domain read as the type it is over: text, varchar, char, name, citext; int2, int4, int8; numeric
14
+ * (the driver reads it as its exact text); uuid; date (its text pinned to ISO for the transaction, postgres.ts);
15
+ * boolean; an enum. Never json or jsonb, a float, a time or timestamp, an interval, money, bytea, a network
16
+ * address, an array, a range or a composite.
17
+ * - SQLite, by the affinity its declared type gives: INTEGER or TEXT. Never REAL, NUMERIC (a decimal with a declared
18
+ * scale is said with it), BLOB or a column declared without a type; except that a typeless column may reference an
19
+ * allowed key, which its foreign key compares as the check does (sqliteScopeCatalog.ts affinitiesPart).
20
+ */
21
+ /** Why a column of `type` cannot be a row's identity in a scoped write, as a refusal says it (no full stop: it is said inside others). */
22
+ export declare const keyTypeRefusal: (dialect: 'postgres' | 'sqlite', table: string, column: string, type: string) => string;
23
+ /** SQLite's affinity for a declared type (datatype3.html, 3.1), and ANY as itself: a STRICT table's ANY converts nothing. */
24
+ export declare function sqliteAffinity(declared: string): string;
25
+ /** Whether a SQLite column declared `declared` may be a row's identity in a scoped write. */
26
+ export declare const sqliteKeyType: (declared: string) => boolean;
27
+ /** A SQLite column's type as a refusal names it. */
28
+ export declare const sqliteTypeSaid: (declared: string) => string;
29
+ /**
30
+ * Whether the base type `type` (an oid expression, its domains already unwrapped) may be a row's identity, as a SQL
31
+ * boolean: one of the built-in types above, an enum, or the citext extension's own type (an extension's member is
32
+ * recorded in pg_depend, so a type merely named citext is not it). Every operator named in pg_catalog.
33
+ */
34
+ export declare const postgresKeyType: (type: string) => string;
@@ -0,0 +1,66 @@
1
+ /**
2
+ * The types a scoped write takes as a row's identity (docs/trigger-effects.md, "Key types").
3
+ *
4
+ * Under a row policy, every check names a row by a value: a write's own row by its primary key, a parent by the
5
+ * reference that points at it, a row a trigger reaches by its effect's key. The check is sound only where the value
6
+ * it binds is the value the database compares. Six reviews found the same defect in new places: the driver's
7
+ * JavaScript reading of a jsonb key (2^53 rounded, "123" read as 123), SQLite's numeric(p,s) said with its scale
8
+ * (19.987 read as "19.99"), a float or timestamp whose text depends on the session's settings. So a column that is a
9
+ * row's identity — a primary key, either side of a foreign key, either side of a trigger effect's key — must be of a
10
+ * type whose value reads back exactly, through the driver and through text, and any other is refused from the
11
+ * catalog, before a value is read:
12
+ *
13
+ * - PostgreSQL, a domain read as the type it is over: text, varchar, char, name, citext; int2, int4, int8; numeric
14
+ * (the driver reads it as its exact text); uuid; date (its text pinned to ISO for the transaction, postgres.ts);
15
+ * boolean; an enum. Never json or jsonb, a float, a time or timestamp, an interval, money, bytea, a network
16
+ * address, an array, a range or a composite.
17
+ * - SQLite, by the affinity its declared type gives: INTEGER or TEXT. Never REAL, NUMERIC (a decimal with a declared
18
+ * scale is said with it), BLOB or a column declared without a type; except that a typeless column may reference an
19
+ * allowed key, which its foreign key compares as the check does (sqliteScopeCatalog.ts affinitiesPart).
20
+ */
21
+ /** Why a column of `type` cannot be a row's identity in a scoped write, as a refusal says it (no full stop: it is said inside others). */
22
+ export const keyTypeRefusal = (dialect, table, column, type) => `"${table}".${column} is of type ${type}, which is not supported as a key for writes under a row policy ` +
23
+ "(a primary key, either side of a foreign key, or a trigger effect's key): " +
24
+ (dialect === 'sqlite'
25
+ ? 'on SQLite a key must have INTEGER or TEXT affinity'
26
+ : 'on PostgreSQL a key must be text, varchar, char, citext, name, an integer, numeric, uuid, date, boolean or an enum') +
27
+ ', whose value reads back exactly as the database compares it' +
28
+ (dialect === 'sqlite' && looksLikeText(type) ? '; declare it TEXT (or INTEGER) to use it as a key under a row policy' : '');
29
+ /* A SQLite type named as another engine's (UUID, STRING, DATETIME, BOOLEAN, GUID) is NUMERIC by SQLite's rules, which
30
+ its author rarely meant: the refusal says what to declare instead. `said` is sqliteTypeSaid's. */
31
+ const looksLikeText = (said) => said.endsWith(' (NUMERIC affinity)') && /UUID|GUID|STRING|DATE|TIME|BOOL/i.test(said.slice(0, -' (NUMERIC affinity)'.length));
32
+ /** SQLite's affinity for a declared type (datatype3.html, 3.1), and ANY as itself: a STRICT table's ANY converts nothing. */
33
+ export function sqliteAffinity(declared) {
34
+ const type = declared.toUpperCase();
35
+ if (type.trim() === 'ANY')
36
+ return 'ANY';
37
+ if (type.includes('INT'))
38
+ return 'INTEGER';
39
+ if (/CHAR|CLOB|TEXT/.test(type))
40
+ return 'TEXT';
41
+ if (type.includes('BLOB') || !type.trim())
42
+ return 'BLOB';
43
+ if (/REAL|FLOA|DOUB/.test(type))
44
+ return 'REAL';
45
+ return 'NUMERIC';
46
+ }
47
+ /** Whether a SQLite column declared `declared` may be a row's identity in a scoped write. */
48
+ export const sqliteKeyType = (declared) => ['INTEGER', 'TEXT'].includes(sqliteAffinity(declared));
49
+ /** A SQLite column's type as a refusal names it. */
50
+ export const sqliteTypeSaid = (declared) => declared.trim() ? `${declared.trim()} (${sqliteAffinity(declared)} affinity)` : 'none declared (BLOB affinity)';
51
+ /* PostgreSQL's built-in types on the list, by oid (pg_type.dat, fixed by the server's source): bool 16, name 19,
52
+ int8 20, int2 21, int4 23, text 25, bpchar 1042, varchar 1043, date 1082, numeric 1700, uuid 2950. */
53
+ const POSTGRES_KEY_OIDS = '{16,19,20,21,23,25,1042,1043,1082,1700,2950}';
54
+ /**
55
+ * Whether the base type `type` (an oid expression, its domains already unwrapped) may be a row's identity, as a SQL
56
+ * boolean: one of the built-in types above, an enum, or the citext extension's own type (an extension's member is
57
+ * recorded in pg_depend, so a type merely named citext is not it). Every operator named in pg_catalog.
58
+ */
59
+ export const postgresKeyType = (type) => `(${type} OPERATOR(pg_catalog.=) ANY ('${POSTGRES_KEY_OIDS}'::pg_catalog.oid[])
60
+ OR EXISTS (SELECT FROM pg_catalog.pg_type kt WHERE kt.oid OPERATOR(pg_catalog.=) ${type} AND kt.typtype OPERATOR(pg_catalog.=) 'e')
61
+ OR EXISTS (SELECT FROM pg_catalog.pg_type kt
62
+ JOIN pg_catalog.pg_depend kd ON kd.objid OPERATOR(pg_catalog.=) kt.oid AND kd.classid OPERATOR(pg_catalog.=) 1247::pg_catalog.oid
63
+ AND kd.refclassid OPERATOR(pg_catalog.=) 3079::pg_catalog.oid AND kd.deptype OPERATOR(pg_catalog.=) 'e'
64
+ JOIN pg_catalog.pg_extension kx ON kx.oid OPERATOR(pg_catalog.=) kd.refobjid
65
+ WHERE kt.oid OPERATOR(pg_catalog.=) ${type} AND kt.typname OPERATOR(pg_catalog.=) 'citext'
66
+ AND kx.extname OPERATOR(pg_catalog.=) 'citext'))`;