@fragno-dev/db 0.3.0 → 0.4.1

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 (516) hide show
  1. package/.turbo/turbo-build.log +327 -160
  2. package/CHANGELOG.md +74 -0
  3. package/README.md +24 -0
  4. package/dist/adapters/adapters.d.ts +1 -1
  5. package/dist/adapters/adapters.d.ts.map +1 -1
  6. package/dist/adapters/adapters.js.map +1 -1
  7. package/dist/adapters/generic-sql/generic-sql-adapter.d.ts +0 -3
  8. package/dist/adapters/generic-sql/generic-sql-adapter.d.ts.map +1 -1
  9. package/dist/adapters/generic-sql/generic-sql-adapter.js +11 -12
  10. package/dist/adapters/generic-sql/generic-sql-adapter.js.map +1 -1
  11. package/dist/adapters/generic-sql/generic-sql-uow-executor.js +46 -6
  12. package/dist/adapters/generic-sql/generic-sql-uow-executor.js.map +1 -1
  13. package/dist/adapters/generic-sql/migration/cold-kysely.js.map +1 -1
  14. package/dist/adapters/generic-sql/migration/dialect/mysql.js +1 -1
  15. package/dist/adapters/generic-sql/migration/dialect/mysql.js.map +1 -1
  16. package/dist/adapters/generic-sql/migration/dialect/postgres.js +1 -1
  17. package/dist/adapters/generic-sql/migration/dialect/postgres.js.map +1 -1
  18. package/dist/adapters/generic-sql/migration/dialect/sqlite.js +185 -19
  19. package/dist/adapters/generic-sql/migration/dialect/sqlite.js.map +1 -1
  20. package/dist/adapters/generic-sql/migration/executor.d.ts.map +1 -1
  21. package/dist/adapters/generic-sql/migration/executor.js +30 -3
  22. package/dist/adapters/generic-sql/migration/executor.js.map +1 -1
  23. package/dist/adapters/generic-sql/migration/prepared-migrations.d.ts.map +1 -1
  24. package/dist/adapters/generic-sql/migration/prepared-migrations.js +3 -3
  25. package/dist/adapters/generic-sql/migration/prepared-migrations.js.map +1 -1
  26. package/dist/adapters/generic-sql/migration/sql-generator.js +1 -1
  27. package/dist/adapters/generic-sql/migration/sql-generator.js.map +1 -1
  28. package/dist/adapters/generic-sql/query/create-sql-query-compiler.js +1 -1
  29. package/dist/adapters/generic-sql/query/create-sql-query-compiler.js.map +1 -1
  30. package/dist/adapters/generic-sql/query/cursor-utils.js.map +1 -1
  31. package/dist/adapters/generic-sql/query/db-now-sql.js +27 -0
  32. package/dist/adapters/generic-sql/query/db-now-sql.js.map +1 -0
  33. package/dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js +9 -6
  34. package/dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js.map +1 -1
  35. package/dist/adapters/generic-sql/query/select-builder.js.map +1 -1
  36. package/dist/adapters/generic-sql/query/sql-query-compiler.js +37 -9
  37. package/dist/adapters/generic-sql/query/sql-query-compiler.js.map +1 -1
  38. package/dist/adapters/generic-sql/query/where-builder.js +24 -20
  39. package/dist/adapters/generic-sql/query/where-builder.js.map +1 -1
  40. package/dist/adapters/generic-sql/uow-decoder.js +1 -1
  41. package/dist/adapters/generic-sql/uow-decoder.js.map +1 -1
  42. package/dist/adapters/generic-sql/uow-encoder.js +8 -9
  43. package/dist/adapters/generic-sql/uow-encoder.js.map +1 -1
  44. package/dist/adapters/in-memory/condition-evaluator.js +10 -6
  45. package/dist/adapters/in-memory/condition-evaluator.js.map +1 -1
  46. package/dist/adapters/in-memory/in-memory-adapter.d.ts.map +1 -1
  47. package/dist/adapters/in-memory/in-memory-adapter.js +45 -25
  48. package/dist/adapters/in-memory/in-memory-adapter.js.map +1 -1
  49. package/dist/adapters/in-memory/in-memory-uow.js +236 -13
  50. package/dist/adapters/in-memory/in-memory-uow.js.map +1 -1
  51. package/dist/adapters/in-memory/options.d.ts +2 -0
  52. package/dist/adapters/in-memory/options.d.ts.map +1 -1
  53. package/dist/adapters/in-memory/options.js +3 -2
  54. package/dist/adapters/in-memory/options.js.map +1 -1
  55. package/dist/adapters/in-memory/reference-resolution.js.map +1 -1
  56. package/dist/adapters/in-memory/store.js +1 -1
  57. package/dist/adapters/in-memory/store.js.map +1 -1
  58. package/dist/adapters/shared/from-unit-of-work-compiler.js +51 -24
  59. package/dist/adapters/shared/from-unit-of-work-compiler.js.map +1 -1
  60. package/dist/adapters/shared/uow-operation-compiler.js.map +1 -1
  61. package/dist/browser/adapters/adapters.d.ts +61 -0
  62. package/dist/browser/adapters/adapters.d.ts.map +1 -0
  63. package/dist/browser/adapters/generic-sql/migration/executor.d.ts +15 -0
  64. package/dist/browser/adapters/generic-sql/migration/executor.d.ts.map +1 -0
  65. package/dist/browser/adapters/generic-sql/migration/prepared-migrations.d.ts +66 -0
  66. package/dist/browser/adapters/generic-sql/migration/prepared-migrations.d.ts.map +1 -0
  67. package/dist/browser/adapters/generic-sql/sqlite-storage.d.ts +11 -0
  68. package/dist/browser/adapters/generic-sql/sqlite-storage.d.ts.map +1 -0
  69. package/dist/browser/adapters/in-memory/in-memory-adapter.d.ts +5 -0
  70. package/dist/browser/adapters/in-memory/index.d.ts +2 -0
  71. package/dist/browser/adapters/in-memory/options.d.ts +1 -0
  72. package/dist/browser/db-fragment-definition-builder.d.ts +237 -0
  73. package/dist/browser/db-fragment-definition-builder.d.ts.map +1 -0
  74. package/dist/browser/durable-hooks.d.ts +3 -0
  75. package/dist/browser/fragments/internal-fragment.d.ts +317 -0
  76. package/dist/browser/fragments/internal-fragment.d.ts.map +1 -0
  77. package/dist/browser/fragments/internal-fragment.schema.d.ts +1 -0
  78. package/dist/browser/hooks/durable-hooks-logger.d.ts +10 -0
  79. package/dist/browser/hooks/durable-hooks-logger.d.ts.map +1 -0
  80. package/dist/browser/hooks/hooks.d.ts +146 -0
  81. package/dist/browser/hooks/hooks.d.ts.map +1 -0
  82. package/dist/browser/id.js +1 -0
  83. package/dist/browser/internal/adapter-registry.d.ts +4 -0
  84. package/dist/browser/internal/outbox-state.d.ts +2 -0
  85. package/dist/browser/mod.d.ts +15 -0
  86. package/dist/browser/mod.d.ts.map +1 -0
  87. package/dist/browser/mod.js +17 -0
  88. package/dist/browser/mod.js.map +1 -0
  89. package/dist/browser/mod2.d.ts +48 -0
  90. package/dist/browser/mod2.d.ts.map +1 -0
  91. package/dist/browser/naming/sql-naming.d.ts +19 -0
  92. package/dist/browser/naming/sql-naming.d.ts.map +1 -0
  93. package/dist/browser/outbox/outbox.d.ts +21 -0
  94. package/dist/browser/outbox/outbox.d.ts.map +1 -0
  95. package/dist/browser/query/column-defaults.js +1 -0
  96. package/dist/browser/query/condition-builder.d.ts +44 -0
  97. package/dist/browser/query/condition-builder.d.ts.map +1 -0
  98. package/dist/browser/query/condition-builder.js +97 -0
  99. package/dist/browser/query/condition-builder.js.map +1 -0
  100. package/dist/browser/query/cursor.d.ts +105 -0
  101. package/dist/browser/query/cursor.d.ts.map +1 -0
  102. package/dist/browser/query/cursor.js +150 -0
  103. package/dist/browser/query/cursor.js.map +1 -0
  104. package/dist/browser/query/db-now.d.ts +22 -0
  105. package/dist/browser/query/db-now.d.ts.map +1 -0
  106. package/dist/browser/query/db-now.js +33 -0
  107. package/dist/browser/query/db-now.js.map +1 -0
  108. package/dist/browser/query/orm/orm.d.ts +18 -0
  109. package/dist/browser/query/orm/orm.d.ts.map +1 -0
  110. package/dist/browser/query/simple-query-interface.d.ts +108 -0
  111. package/dist/browser/query/simple-query-interface.d.ts.map +1 -0
  112. package/dist/browser/query/unit-of-work/execute-unit-of-work.d.ts +423 -0
  113. package/dist/browser/query/unit-of-work/execute-unit-of-work.d.ts.map +1 -0
  114. package/dist/browser/query/unit-of-work/execute-unit-of-work.js +507 -0
  115. package/dist/browser/query/unit-of-work/execute-unit-of-work.js.map +1 -0
  116. package/dist/browser/query/unit-of-work/retry-policy.d.ts +23 -0
  117. package/dist/browser/query/unit-of-work/retry-policy.d.ts.map +1 -0
  118. package/dist/browser/query/unit-of-work/retry-policy.js +40 -0
  119. package/dist/browser/query/unit-of-work/retry-policy.js.map +1 -0
  120. package/dist/browser/query/unit-of-work/unit-of-work.d.ts +703 -0
  121. package/dist/browser/query/unit-of-work/unit-of-work.d.ts.map +1 -0
  122. package/dist/browser/query/unit-of-work/unit-of-work.js +1206 -0
  123. package/dist/browser/query/unit-of-work/unit-of-work.js.map +1 -0
  124. package/dist/browser/query/value-encoding.js +38 -0
  125. package/dist/browser/query/value-encoding.js.map +1 -0
  126. package/dist/browser/schema/create.d.ts +326 -0
  127. package/dist/browser/schema/create.d.ts.map +1 -0
  128. package/dist/browser/schema/create.js +89 -0
  129. package/dist/browser/schema/create.js.map +1 -0
  130. package/dist/browser/schema/generate-id.js +28 -0
  131. package/dist/browser/schema/generate-id.js.map +1 -0
  132. package/dist/browser/shared/providers.d.ts +6 -0
  133. package/dist/browser/shared/providers.d.ts.map +1 -0
  134. package/dist/browser/sql-driver/connection/connection-provider.d.ts +13 -0
  135. package/dist/browser/sql-driver/connection/connection-provider.d.ts.map +1 -0
  136. package/dist/browser/sql-driver/dialect-adapter/dialect-adapter.d.ts +7 -0
  137. package/dist/browser/sql-driver/dialect-adapter/dialect-adapter.d.ts.map +1 -0
  138. package/dist/browser/sql-driver/driver/runtime-driver.d.ts +23 -0
  139. package/dist/browser/sql-driver/driver/runtime-driver.d.ts.map +1 -0
  140. package/dist/browser/sql-driver/query-executor/plugin.d.ts +17 -0
  141. package/dist/browser/sql-driver/query-executor/plugin.d.ts.map +1 -0
  142. package/dist/browser/sql-driver/query-executor/query-executor.d.ts +36 -0
  143. package/dist/browser/sql-driver/query-executor/query-executor.d.ts.map +1 -0
  144. package/dist/browser/sql-driver/sql-driver-adapter.d.ts +29 -0
  145. package/dist/browser/sql-driver/sql-driver-adapter.d.ts.map +1 -0
  146. package/dist/browser/sql-driver/sql-driver.d.ts +38 -0
  147. package/dist/browser/sql-driver/sql-driver.d.ts.map +1 -0
  148. package/dist/browser/sync/commands.d.ts +15 -0
  149. package/dist/browser/sync/commands.d.ts.map +1 -0
  150. package/dist/browser/sync/commands.js +27 -0
  151. package/dist/browser/sync/commands.js.map +1 -0
  152. package/dist/browser/sync/types.d.ts +63 -0
  153. package/dist/browser/sync/types.d.ts.map +1 -0
  154. package/dist/browser/util/types.d.ts +8 -0
  155. package/dist/browser/util/types.d.ts.map +1 -0
  156. package/dist/browser/with-database.d.ts +29 -0
  157. package/dist/browser/with-database.d.ts.map +1 -0
  158. package/dist/client.d.ts +4 -0
  159. package/dist/client.js +5 -0
  160. package/dist/db-fragment-definition-builder.d.ts +85 -28
  161. package/dist/db-fragment-definition-builder.d.ts.map +1 -1
  162. package/dist/db-fragment-definition-builder.js +374 -46
  163. package/dist/db-fragment-definition-builder.js.map +1 -1
  164. package/dist/dispatchers/cloudflare-do/dispatcher.d.ts +20 -0
  165. package/dist/dispatchers/cloudflare-do/dispatcher.d.ts.map +1 -0
  166. package/dist/dispatchers/cloudflare-do/dispatcher.js +147 -0
  167. package/dist/dispatchers/cloudflare-do/dispatcher.js.map +1 -0
  168. package/dist/dispatchers/cloudflare-do/index.d.ts +5 -20
  169. package/dist/dispatchers/cloudflare-do/index.d.ts.map +1 -1
  170. package/dist/dispatchers/cloudflare-do/index.js +23 -55
  171. package/dist/dispatchers/cloudflare-do/index.js.map +1 -1
  172. package/dist/dispatchers/node/dispatcher.d.ts +14 -0
  173. package/dist/dispatchers/node/dispatcher.d.ts.map +1 -0
  174. package/dist/dispatchers/node/dispatcher.js +80 -0
  175. package/dist/dispatchers/node/dispatcher.js.map +1 -0
  176. package/dist/dispatchers/node/index.d.ts +5 -10
  177. package/dist/dispatchers/node/index.d.ts.map +1 -1
  178. package/dist/dispatchers/node/index.js +21 -53
  179. package/dist/dispatchers/node/index.js.map +1 -1
  180. package/dist/durable-hooks.d.ts +31 -0
  181. package/dist/durable-hooks.d.ts.map +1 -0
  182. package/dist/durable-hooks.js +23 -0
  183. package/dist/durable-hooks.js.map +1 -0
  184. package/dist/fragments/internal-fragment.d.ts +128 -27
  185. package/dist/fragments/internal-fragment.d.ts.map +1 -1
  186. package/dist/fragments/internal-fragment.js +125 -78
  187. package/dist/fragments/internal-fragment.js.map +1 -1
  188. package/dist/fragments/internal-fragment.routes.js +138 -3
  189. package/dist/fragments/internal-fragment.routes.js.map +1 -1
  190. package/dist/fragments/internal-fragment.schema.d.ts +7 -1
  191. package/dist/fragments/internal-fragment.schema.d.ts.map +1 -1
  192. package/dist/fragments/internal-fragment.schema.js +18 -1
  193. package/dist/fragments/internal-fragment.schema.js.map +1 -1
  194. package/dist/hooks/durable-hooks-logger.d.ts +10 -0
  195. package/dist/hooks/durable-hooks-logger.d.ts.map +1 -0
  196. package/dist/hooks/durable-hooks-logger.js +75 -0
  197. package/dist/hooks/durable-hooks-logger.js.map +1 -0
  198. package/dist/hooks/durable-hooks-processor.d.ts +1 -14
  199. package/dist/hooks/durable-hooks-processor.js +58 -10
  200. package/dist/hooks/durable-hooks-processor.js.map +1 -1
  201. package/dist/hooks/durable-hooks-runtime.js +44 -0
  202. package/dist/hooks/durable-hooks-runtime.js.map +1 -0
  203. package/dist/hooks/hooks.d.ts +60 -2
  204. package/dist/hooks/hooks.d.ts.map +1 -1
  205. package/dist/hooks/hooks.js +214 -53
  206. package/dist/hooks/hooks.js.map +1 -1
  207. package/dist/id.d.ts +2 -2
  208. package/dist/id.js +2 -2
  209. package/dist/internal/adapter-registry.d.ts +11 -0
  210. package/dist/internal/adapter-registry.d.ts.map +1 -0
  211. package/dist/internal/adapter-registry.js +135 -0
  212. package/dist/internal/adapter-registry.js.map +1 -0
  213. package/dist/internal/outbox-state.d.ts +2 -0
  214. package/dist/internal/outbox-state.js +26 -0
  215. package/dist/internal/outbox-state.js.map +1 -0
  216. package/dist/migration-engine/auto-from-schema.d.ts +33 -0
  217. package/dist/migration-engine/auto-from-schema.d.ts.map +1 -0
  218. package/dist/migration-engine/auto-from-schema.js +210 -27
  219. package/dist/migration-engine/auto-from-schema.js.map +1 -1
  220. package/dist/migration-engine/generation-engine.d.ts.map +1 -1
  221. package/dist/migration-engine/generation-engine.js +17 -5
  222. package/dist/migration-engine/generation-engine.js.map +1 -1
  223. package/dist/migration-engine/shared.d.ts +113 -0
  224. package/dist/migration-engine/shared.d.ts.map +1 -0
  225. package/dist/migration-engine/shared.js.map +1 -1
  226. package/dist/mod.d.ts +12 -11
  227. package/dist/mod.d.ts.map +1 -1
  228. package/dist/mod.js +10 -10
  229. package/dist/mod.js.map +1 -1
  230. package/dist/naming/sql-naming.d.ts.map +1 -1
  231. package/dist/naming/sql-naming.js.map +1 -1
  232. package/dist/outbox/outbox-builder.js.map +1 -1
  233. package/dist/outbox/outbox.d.ts +3 -1
  234. package/dist/outbox/outbox.d.ts.map +1 -1
  235. package/dist/outbox/outbox.js.map +1 -1
  236. package/dist/query/column-defaults.js.map +1 -1
  237. package/dist/query/condition-builder.d.ts +7 -1
  238. package/dist/query/condition-builder.d.ts.map +1 -1
  239. package/dist/query/condition-builder.js +5 -1
  240. package/dist/query/condition-builder.js.map +1 -1
  241. package/dist/query/cursor-client.d.ts +105 -0
  242. package/dist/query/cursor-client.d.ts.map +1 -0
  243. package/dist/query/cursor-client.js +165 -0
  244. package/dist/query/cursor-client.js.map +1 -0
  245. package/dist/query/cursor.d.ts.map +1 -1
  246. package/dist/query/cursor.js +7 -1
  247. package/dist/query/cursor.js.map +1 -1
  248. package/dist/query/db-now.d.ts +15 -1
  249. package/dist/query/db-now.d.ts.map +1 -1
  250. package/dist/query/db-now.js +30 -2
  251. package/dist/query/db-now.js.map +1 -1
  252. package/dist/query/orm/orm.js.map +1 -1
  253. package/dist/query/serialize/create-sql-serializer.js +2 -2
  254. package/dist/query/serialize/create-sql-serializer.js.map +1 -1
  255. package/dist/query/serialize/dialect/mysql-serializer.js.map +1 -1
  256. package/dist/query/serialize/dialect/postgres-serializer.js.map +1 -1
  257. package/dist/query/serialize/dialect/sqlite-serializer.js +6 -2
  258. package/dist/query/serialize/dialect/sqlite-serializer.js.map +1 -1
  259. package/dist/query/simple-query-interface.d.ts +7 -3
  260. package/dist/query/simple-query-interface.d.ts.map +1 -1
  261. package/dist/query/unit-of-work/execute-unit-of-work.d.ts +37 -2
  262. package/dist/query/unit-of-work/execute-unit-of-work.d.ts.map +1 -1
  263. package/dist/query/unit-of-work/execute-unit-of-work.js +39 -18
  264. package/dist/query/unit-of-work/execute-unit-of-work.js.map +1 -1
  265. package/dist/query/unit-of-work/unit-of-work.d.ts +42 -16
  266. package/dist/query/unit-of-work/unit-of-work.d.ts.map +1 -1
  267. package/dist/query/unit-of-work/unit-of-work.js +50 -6
  268. package/dist/query/unit-of-work/unit-of-work.js.map +1 -1
  269. package/dist/query/value-decoding.js +8 -1
  270. package/dist/query/value-decoding.js.map +1 -1
  271. package/dist/query/value-encoding.js.map +1 -1
  272. package/dist/schema/create.d.ts +69 -25
  273. package/dist/schema/create.d.ts.map +1 -1
  274. package/dist/schema/create.js +91 -16
  275. package/dist/schema/create.js.map +1 -1
  276. package/dist/schema/type-conversion/create-sql-type-mapper.js +1 -1
  277. package/dist/schema/type-conversion/create-sql-type-mapper.js.map +1 -1
  278. package/dist/schema/type-conversion/dialect/sqlite.js.map +1 -1
  279. package/dist/schema/validator.d.ts.map +1 -1
  280. package/dist/schema/validator.js.map +1 -1
  281. package/dist/schema-output/drizzle.d.ts.map +1 -1
  282. package/dist/schema-output/drizzle.js +8 -6
  283. package/dist/schema-output/drizzle.js.map +1 -1
  284. package/dist/schema-output/prisma.d.ts.map +1 -1
  285. package/dist/schema-output/prisma.js +21 -10
  286. package/dist/schema-output/prisma.js.map +1 -1
  287. package/dist/sql-driver/dialects/durable-object-dialect.js +3 -9
  288. package/dist/sql-driver/dialects/durable-object-dialect.js.map +1 -1
  289. package/dist/sql-driver/query-executor/default-query-executor.js.map +1 -1
  290. package/dist/sql-driver/query-executor/query-executor-base.js.map +1 -1
  291. package/dist/sql-driver/sql-driver-adapter.js.map +1 -1
  292. package/dist/sql-driver/sql.js.map +1 -1
  293. package/dist/sync/commands.d.ts +15 -0
  294. package/dist/sync/commands.d.ts.map +1 -0
  295. package/dist/sync/commands.js +27 -0
  296. package/dist/sync/commands.js.map +1 -0
  297. package/dist/sync/index.d.ts +4 -0
  298. package/dist/sync/index.js +4 -0
  299. package/dist/sync/read-tracking.d.ts +25 -0
  300. package/dist/sync/read-tracking.d.ts.map +1 -0
  301. package/dist/sync/read-tracking.js +148 -0
  302. package/dist/sync/read-tracking.js.map +1 -0
  303. package/dist/sync/submit.js +213 -0
  304. package/dist/sync/submit.js.map +1 -0
  305. package/dist/sync/types.d.ts +63 -0
  306. package/dist/sync/types.d.ts.map +1 -0
  307. package/dist/util/default-database-adapter.js +6 -1
  308. package/dist/util/default-database-adapter.js.map +1 -1
  309. package/dist/with-database.d.ts +3 -6
  310. package/dist/with-database.d.ts.map +1 -1
  311. package/dist/with-database.js +7 -15
  312. package/dist/with-database.js.map +1 -1
  313. package/package.json +33 -41
  314. package/src/adapters/adapters.ts +5 -4
  315. package/src/adapters/drizzle/migrate-drizzle.test.ts +46 -9
  316. package/src/adapters/drizzle/migration-parity-drizzle-kit.test.ts +5 -3
  317. package/src/adapters/drizzle/test-utils.ts +2 -1
  318. package/src/adapters/generic-sql/generic-sql-adapter.test.ts +5 -3
  319. package/src/adapters/generic-sql/generic-sql-adapter.ts +21 -24
  320. package/src/adapters/generic-sql/generic-sql-uow-executor.test.ts +1 -0
  321. package/src/adapters/generic-sql/generic-sql-uow-executor.ts +81 -15
  322. package/src/adapters/generic-sql/migration/adapter-migration-parity.test.ts +4 -2
  323. package/src/adapters/generic-sql/migration/cold-kysely.ts +1 -0
  324. package/src/adapters/generic-sql/migration/dialect/mysql.test.ts +3 -2
  325. package/src/adapters/generic-sql/migration/dialect/mysql.ts +1 -0
  326. package/src/adapters/generic-sql/migration/dialect/postgres.test.ts +5 -4
  327. package/src/adapters/generic-sql/migration/dialect/postgres.ts +2 -1
  328. package/src/adapters/generic-sql/migration/dialect/sqlite.test.ts +795 -3
  329. package/src/adapters/generic-sql/migration/dialect/sqlite.ts +385 -57
  330. package/src/adapters/generic-sql/migration/executor.test.ts +52 -0
  331. package/src/adapters/generic-sql/migration/executor.ts +47 -4
  332. package/src/adapters/generic-sql/migration/prepared-migrations.test.ts +117 -14
  333. package/src/adapters/generic-sql/migration/prepared-migrations.ts +9 -8
  334. package/src/adapters/generic-sql/migration/sql-generator.ts +5 -3
  335. package/src/adapters/generic-sql/query/create-sql-query-compiler.ts +3 -3
  336. package/src/adapters/generic-sql/query/cursor-utils.test.ts +3 -2
  337. package/src/adapters/generic-sql/query/cursor-utils.ts +1 -1
  338. package/src/adapters/generic-sql/query/db-now-sql.ts +49 -0
  339. package/src/adapters/generic-sql/query/generic-sql-uow-operation-compiler.test.ts +144 -8
  340. package/src/adapters/generic-sql/query/generic-sql-uow-operation-compiler.ts +16 -17
  341. package/src/adapters/generic-sql/query/select-builder.test.ts +1 -0
  342. package/src/adapters/generic-sql/query/select-builder.ts +2 -2
  343. package/src/adapters/generic-sql/query/sql-query-compiler.test.ts +24 -5
  344. package/src/adapters/generic-sql/query/sql-query-compiler.ts +83 -13
  345. package/src/adapters/generic-sql/query/where-builder.test.ts +7 -5
  346. package/src/adapters/generic-sql/query/where-builder.ts +48 -29
  347. package/src/adapters/generic-sql/sql-adapter-pglite-migrations.test.ts +6 -15
  348. package/src/adapters/generic-sql/sql-adapter-pglite-pagination.test.ts +52 -7
  349. package/src/adapters/generic-sql/sql-adapter-pglite-queries.test.ts +9 -6
  350. package/src/adapters/generic-sql/sql-adapter-sqlite3-driver.test.ts +273 -5
  351. package/src/adapters/generic-sql/sql-adapter-sqlite3-uow.test.ts +123 -6
  352. package/src/adapters/generic-sql/sql-adapter-sqlocal.test.ts +4 -2
  353. package/src/adapters/generic-sql/uow-decoder.test.ts +4 -3
  354. package/src/adapters/generic-sql/uow-decoder.ts +3 -3
  355. package/src/adapters/generic-sql/uow-encoder.test.ts +4 -2
  356. package/src/adapters/generic-sql/uow-encoder.ts +14 -18
  357. package/src/adapters/in-memory/condition-evaluator.test.ts +2 -1
  358. package/src/adapters/in-memory/condition-evaluator.ts +9 -4
  359. package/src/adapters/in-memory/in-memory-adapter.ts +155 -44
  360. package/src/adapters/in-memory/in-memory-uow.mutations.test.ts +50 -2
  361. package/src/adapters/in-memory/in-memory-uow.retrieval.test.ts +158 -3
  362. package/src/adapters/in-memory/in-memory-uow.ts +402 -26
  363. package/src/adapters/in-memory/options.test.ts +1 -0
  364. package/src/adapters/in-memory/options.ts +5 -1
  365. package/src/adapters/in-memory/outbox.test.ts +361 -0
  366. package/src/adapters/in-memory/reference-resolution.test.ts +3 -2
  367. package/src/adapters/in-memory/reference-resolution.ts +2 -2
  368. package/src/adapters/in-memory/sorted-array-index.test.ts +1 -0
  369. package/src/adapters/in-memory/store.test.ts +1 -0
  370. package/src/adapters/in-memory/store.ts +3 -3
  371. package/src/adapters/in-memory/value-normalization.test.ts +1 -0
  372. package/src/adapters/prisma/prisma-adapter-sqlite3.test.ts +51 -7
  373. package/src/adapters/shared/from-unit-of-work-compiler.ts +156 -46
  374. package/src/adapters/shared/uow-operation-compiler.ts +3 -3
  375. package/src/browser/mod.ts +64 -0
  376. package/src/client.ts +19 -0
  377. package/src/db-fragment-definition-builder.test.ts +821 -47
  378. package/src/db-fragment-definition-builder.ts +857 -110
  379. package/src/db-fragment-instantiator.test.ts +114 -90
  380. package/src/db-fragment-integration.test.ts +9 -6
  381. package/src/dispatchers/cloudflare-do/dispatcher.ts +204 -0
  382. package/src/dispatchers/cloudflare-do/index.test.ts +145 -12
  383. package/src/dispatchers/cloudflare-do/index.ts +49 -90
  384. package/src/dispatchers/node/dispatcher.ts +112 -0
  385. package/src/dispatchers/node/index.test.ts +43 -14
  386. package/src/dispatchers/node/index.ts +38 -75
  387. package/src/durable-hooks.test.ts +80 -0
  388. package/src/durable-hooks.ts +67 -0
  389. package/src/fragments/internal-fragment.routes.test.ts +570 -0
  390. package/src/fragments/internal-fragment.routes.ts +297 -5
  391. package/src/fragments/internal-fragment.schema.ts +45 -1
  392. package/src/fragments/internal-fragment.test.ts +223 -251
  393. package/src/fragments/internal-fragment.ts +278 -154
  394. package/src/hooks/durable-hooks-logger.ts +126 -0
  395. package/src/hooks/durable-hooks-processor.pglite.test.ts +87 -0
  396. package/src/hooks/durable-hooks-processor.test.ts +179 -14
  397. package/src/hooks/durable-hooks-processor.ts +120 -14
  398. package/src/hooks/durable-hooks-runtime.test.ts +65 -0
  399. package/src/hooks/durable-hooks-runtime.ts +81 -0
  400. package/src/hooks/hooks.test.ts +314 -53
  401. package/src/hooks/hooks.ts +360 -81
  402. package/src/id.test.ts +34 -0
  403. package/src/id.ts +1 -3
  404. package/src/internal/adapter-registry.test.ts +93 -0
  405. package/src/internal/adapter-registry.ts +239 -0
  406. package/src/internal/outbox-state.ts +43 -0
  407. package/src/migration-engine/auto-from-schema.test.ts +93 -0
  408. package/src/migration-engine/auto-from-schema.ts +360 -42
  409. package/src/migration-engine/create.test.ts +2 -1
  410. package/src/migration-engine/create.ts +1 -1
  411. package/src/migration-engine/generation-engine.test.ts +66 -9
  412. package/src/migration-engine/generation-engine.ts +31 -10
  413. package/src/migration-engine/shared.ts +13 -0
  414. package/src/mod.ts +45 -27
  415. package/src/naming/sql-naming.ts +1 -0
  416. package/src/outbox/outbox-builder.ts +2 -2
  417. package/src/outbox/outbox.test.ts +216 -45
  418. package/src/outbox/outbox.ts +3 -1
  419. package/src/query/column-defaults.ts +1 -1
  420. package/src/query/condition-builder.test.ts +15 -0
  421. package/src/query/condition-builder.ts +7 -0
  422. package/src/query/cursor-client.test.ts +70 -0
  423. package/src/query/cursor-client.ts +263 -0
  424. package/src/query/cursor.test.ts +3 -2
  425. package/src/query/cursor.ts +15 -3
  426. package/src/query/db-now.ts +69 -2
  427. package/src/query/orm/orm.ts +2 -2
  428. package/src/query/query-type.test.ts +2 -1
  429. package/src/query/serialize/create-sql-serializer.ts +3 -3
  430. package/src/query/serialize/dialect/mysql-serializer.ts +1 -1
  431. package/src/query/serialize/dialect/postgres-serializer.ts +1 -1
  432. package/src/query/serialize/dialect/sqlite-serializer.test.ts +39 -2
  433. package/src/query/serialize/dialect/sqlite-serializer.ts +18 -5
  434. package/src/query/simple-query-interface.ts +10 -4
  435. package/src/query/unit-of-work/execute-unit-of-work.test.ts +347 -9
  436. package/src/query/unit-of-work/execute-unit-of-work.ts +63 -20
  437. package/src/query/unit-of-work/retry-policy.test.ts +1 -0
  438. package/src/query/unit-of-work/tx-builder.test.ts +73 -1
  439. package/src/query/unit-of-work/unit-of-work-coordinator.test.ts +5 -4
  440. package/src/query/unit-of-work/unit-of-work-types.test.ts +41 -11
  441. package/src/query/unit-of-work/unit-of-work.test.ts +28 -2
  442. package/src/query/unit-of-work/unit-of-work.ts +105 -19
  443. package/src/query/value-decoding.test.ts +50 -2
  444. package/src/query/value-decoding.ts +17 -4
  445. package/src/query/value-encoding.test.ts +1 -0
  446. package/src/query/value-encoding.ts +1 -1
  447. package/src/schema/create.test.ts +164 -5
  448. package/src/schema/create.ts +222 -24
  449. package/src/schema/generate-id.test.ts +1 -0
  450. package/src/schema/serialize.test.ts +4 -3
  451. package/src/schema/type-conversion/create-sql-type-mapper.ts +1 -1
  452. package/src/schema/type-conversion/dialect/sqlite.ts +2 -2
  453. package/src/schema/type-conversion/type-mapping.test.ts +2 -1
  454. package/src/schema/validator.test.ts +4 -2
  455. package/src/schema/validator.ts +1 -0
  456. package/src/schema-output/drizzle.test.ts +72 -19
  457. package/src/schema-output/drizzle.ts +24 -18
  458. package/src/schema-output/prisma.test.ts +172 -14
  459. package/src/schema-output/prisma.ts +34 -14
  460. package/src/sql-driver/better-sqlite3.test.ts +5 -3
  461. package/src/sql-driver/dialects/durable-object-dialect.ts +3 -8
  462. package/src/sql-driver/query-executor/default-query-executor.ts +1 -1
  463. package/src/sql-driver/query-executor/query-executor-base.ts +1 -1
  464. package/src/sql-driver/query-executor/query-executor.ts +1 -1
  465. package/src/sql-driver/sql-driver-adapter.ts +2 -2
  466. package/src/sql-driver/sql.ts +2 -1
  467. package/src/sql-driver/sqlocal.test.ts +4 -2
  468. package/src/sync/commands.test.ts +39 -0
  469. package/src/sync/commands.ts +51 -0
  470. package/src/sync/conflict-checker.test.ts +450 -0
  471. package/src/sync/conflict-checker.ts +248 -0
  472. package/src/sync/index.ts +14 -0
  473. package/src/sync/plan.ts +9 -0
  474. package/src/sync/read-tracking.test.ts +177 -0
  475. package/src/sync/read-tracking.ts +287 -0
  476. package/src/sync/submit.test.ts +205 -0
  477. package/src/sync/submit.ts +328 -0
  478. package/src/sync/types.ts +80 -0
  479. package/src/util/default-database-adapter.ts +15 -2
  480. package/src/with-database.ts +20 -50
  481. package/tsconfig.json +1 -1
  482. package/tsdown.config.ts +38 -26
  483. package/vitest.config.ts +1 -0
  484. package/dist/hooks/durable-hooks-processor.d.ts.map +0 -1
  485. package/dist/node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js +0 -168
  486. package/dist/node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js.map +0 -1
  487. package/dist/packages/fragno/dist/api/bind-services.js +0 -20
  488. package/dist/packages/fragno/dist/api/bind-services.js.map +0 -1
  489. package/dist/packages/fragno/dist/api/error.js +0 -48
  490. package/dist/packages/fragno/dist/api/error.js.map +0 -1
  491. package/dist/packages/fragno/dist/api/fragment-definition-builder.js +0 -321
  492. package/dist/packages/fragno/dist/api/fragment-definition-builder.js.map +0 -1
  493. package/dist/packages/fragno/dist/api/fragment-instantiator.js +0 -669
  494. package/dist/packages/fragno/dist/api/fragment-instantiator.js.map +0 -1
  495. package/dist/packages/fragno/dist/api/fragno-response.js +0 -73
  496. package/dist/packages/fragno/dist/api/fragno-response.js.map +0 -1
  497. package/dist/packages/fragno/dist/api/internal/response-stream.js +0 -81
  498. package/dist/packages/fragno/dist/api/internal/response-stream.js.map +0 -1
  499. package/dist/packages/fragno/dist/api/internal/route.js +0 -10
  500. package/dist/packages/fragno/dist/api/internal/route.js.map +0 -1
  501. package/dist/packages/fragno/dist/api/mutable-request-state.js +0 -97
  502. package/dist/packages/fragno/dist/api/mutable-request-state.js.map +0 -1
  503. package/dist/packages/fragno/dist/api/request-context-storage.js +0 -43
  504. package/dist/packages/fragno/dist/api/request-context-storage.js.map +0 -1
  505. package/dist/packages/fragno/dist/api/request-input-context.js +0 -185
  506. package/dist/packages/fragno/dist/api/request-input-context.js.map +0 -1
  507. package/dist/packages/fragno/dist/api/request-middleware.js +0 -83
  508. package/dist/packages/fragno/dist/api/request-middleware.js.map +0 -1
  509. package/dist/packages/fragno/dist/api/request-output-context.js +0 -119
  510. package/dist/packages/fragno/dist/api/request-output-context.js.map +0 -1
  511. package/dist/packages/fragno/dist/api/route.js +0 -30
  512. package/dist/packages/fragno/dist/api/route.js.map +0 -1
  513. package/dist/packages/fragno/dist/internal/symbols.js +0 -10
  514. package/dist/packages/fragno/dist/internal/symbols.js.map +0 -1
  515. package/dist/packages/fragno/dist/internal/trace-context.js +0 -12
  516. package/dist/packages/fragno/dist/internal/trace-context.js.map +0 -1
@@ -1,6 +1,9 @@
1
- import SQLite from "better-sqlite3";
2
1
  import { beforeAll, describe, expect, expectTypeOf, it } from "vitest";
3
- import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../schema/create";
2
+
3
+ import SQLite from "better-sqlite3";
4
+ import { SqliteDialect } from "kysely";
5
+
6
+ import { internalSchema } from "../../fragments/internal-fragment";
4
7
  import {
5
8
  Cursor,
6
9
  createServiceTxBuilder,
@@ -8,11 +11,11 @@ import {
8
11
  ExponentialBackoffRetryPolicy,
9
12
  type DatabaseAdapter,
10
13
  } from "../../mod";
11
- import { SqliteDialect } from "kysely";
14
+ import { createNamingResolver, suffixNamingStrategy } from "../../naming/sql-naming";
15
+ import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../schema/create";
12
16
  import { SqlDriverAdapter } from "../../sql-driver/sql-driver-adapter";
13
17
  import { BetterSQLite3DriverConfig } from "./driver-config";
14
18
  import { SqlAdapter } from "./generic-sql-adapter";
15
- import { internalSchema } from "../../fragments/internal-fragment";
16
19
 
17
20
  describe("SqlAdapter with better-sqlite3", () => {
18
21
  const testSchema = schema("test", (s) => {
@@ -22,7 +25,8 @@ describe("SqlAdapter with better-sqlite3", () => {
22
25
  .addColumn("id", idColumn())
23
26
  .addColumn("name", column("string"))
24
27
  .addColumn("age", column("integer").nullable())
25
- .createIndex("name_idx", ["name"]);
28
+ .createIndex("name_idx", ["name"])
29
+ .createIndex("name_id_idx", ["name", "id"]);
26
30
  })
27
31
  .addTable("emails", (t) => {
28
32
  return t
@@ -317,6 +321,47 @@ describe("SqlAdapter with better-sqlite3", () => {
317
321
  }
318
322
  });
319
323
 
324
+ it("should support composite cursor pagination", async () => {
325
+ const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
326
+ const nameValue = "SqlAdapter SQLite Composite Cursor";
327
+
328
+ const createUow = queryEngine.createUnitOfWork("create-composite-cursor-users");
329
+ for (let i = 0; i < 5; i += 1) {
330
+ createUow.create("users", { name: nameValue, age: 70 + i });
331
+ }
332
+ await createUow.executeMutations();
333
+
334
+ const all = await queryEngine.find("users", (b) =>
335
+ b
336
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
337
+ .orderByIndex("name_id_idx", "asc"),
338
+ );
339
+
340
+ const firstPage = await queryEngine.findWithCursor("users", (b) =>
341
+ b
342
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
343
+ .orderByIndex("name_id_idx", "asc")
344
+ .pageSize(2),
345
+ );
346
+
347
+ const secondPage = await queryEngine.findWithCursor("users", (b) =>
348
+ b
349
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
350
+ .after(firstPage.cursor!)
351
+ .orderByIndex("name_id_idx", "asc")
352
+ .pageSize(2),
353
+ );
354
+
355
+ const ids = (rows: { id: FragnoId }[]) => rows.map((row) => row.id.externalId);
356
+
357
+ expect(all.length).toBeGreaterThanOrEqual(5);
358
+ expect(firstPage.items).toHaveLength(2);
359
+ expect(firstPage.cursor).toBeInstanceOf(Cursor);
360
+ expect(firstPage.hasNextPage).toBe(true);
361
+ expect(ids(firstPage.items)).toEqual(ids(all).slice(0, 2));
362
+ expect(ids([...firstPage.items, ...secondPage.items])).toEqual(ids(all).slice(0, 4));
363
+ });
364
+
320
365
  it("should support joins", async () => {
321
366
  const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
322
367
 
@@ -911,3 +956,226 @@ describe("SqlAdapter with better-sqlite3", () => {
911
956
  expect(conflictPosts).toHaveLength(0);
912
957
  });
913
958
  });
959
+
960
+ describe("SQLite recreate-table foreign keys", () => {
961
+ it("keeps foreign keys pointing at the original table after recreation", async () => {
962
+ const database = new SQLite(":memory:");
963
+ const dialect = new SqliteDialect({ database });
964
+ const driver = new SqlDriverAdapter(dialect);
965
+ const adapter = new SqlAdapter({
966
+ dialect,
967
+ driverConfig: new BetterSQLite3DriverConfig(),
968
+ });
969
+
970
+ const fkSchema = schema("fk_test", (s) => {
971
+ return s
972
+ .addTable("users", (t) => {
973
+ return t.addColumn("id", idColumn()).addColumn("name", column("string"));
974
+ })
975
+ .addTable("sessions", (t) => {
976
+ return t.addColumn("id", idColumn()).addColumn("userId", referenceColumn());
977
+ })
978
+ .addReference("sessionUser", {
979
+ type: "one",
980
+ from: { table: "sessions", column: "userId" },
981
+ to: { table: "users", column: "id" },
982
+ })
983
+ .alterTable("users", (t) => {
984
+ return t.alterColumn("name").nullable();
985
+ });
986
+ });
987
+
988
+ const namespace = "fk_test";
989
+ const resolver = createNamingResolver(fkSchema, namespace, suffixNamingStrategy);
990
+ const usersTable = resolver.getTableName("users");
991
+ const sessionsTable = resolver.getTableName("sessions");
992
+
993
+ const migrations = adapter.prepareMigrations(fkSchema, namespace);
994
+ const beforeRecreateVersion = fkSchema.version - 1;
995
+
996
+ try {
997
+ await migrations.executeWithDriver(driver, 0, beforeRecreateVersion, {
998
+ updateVersionInMigration: false,
999
+ });
1000
+ await migrations.executeWithDriver(driver, beforeRecreateVersion, fkSchema.version, {
1001
+ updateVersionInMigration: false,
1002
+ });
1003
+
1004
+ const fkRows = database
1005
+ .prepare(`PRAGMA foreign_key_list("${sessionsTable}")`)
1006
+ .all() as Array<{ table: string }>;
1007
+
1008
+ expect(fkRows.length).toBeGreaterThan(0);
1009
+ for (const row of fkRows) {
1010
+ expect(row.table).toBe(usersTable);
1011
+ expect(row.table).not.toContain("__fragno_tmp_");
1012
+ }
1013
+ } finally {
1014
+ await driver.destroy();
1015
+ }
1016
+ });
1017
+ });
1018
+
1019
+ describe("SQLite migration failure scenarios", () => {
1020
+ const createAdapter = () => {
1021
+ const database = new SQLite(":memory:");
1022
+ const dialect = new SqliteDialect({ database });
1023
+ const driver = new SqlDriverAdapter(dialect);
1024
+ const adapter = new SqlAdapter({
1025
+ dialect,
1026
+ driverConfig: new BetterSQLite3DriverConfig(),
1027
+ });
1028
+
1029
+ return { adapter, driver, database };
1030
+ };
1031
+
1032
+ it("fails when adding a foreign key after tables already exist", async () => {
1033
+ const { adapter, driver } = createAdapter();
1034
+ const fkLaterSchema = schema("fk_later_runtime", (s) => {
1035
+ return s
1036
+ .addTable("users", (t) => {
1037
+ return t.addColumn("id", idColumn()).addColumn("name", column("string"));
1038
+ })
1039
+ .addTable("posts", (t) => {
1040
+ return t
1041
+ .addColumn("id", idColumn())
1042
+ .addColumn("title", column("string"))
1043
+ .addColumn("authorId", referenceColumn());
1044
+ })
1045
+ .addReference("author", {
1046
+ type: "one",
1047
+ from: { table: "posts", column: "authorId" },
1048
+ to: { table: "users", column: "id" },
1049
+ });
1050
+ });
1051
+
1052
+ const namespace = "fk_later_runtime";
1053
+ const migrations = adapter.prepareMigrations(fkLaterSchema, namespace);
1054
+ const beforeFkVersion = fkLaterSchema.version - 1;
1055
+
1056
+ try {
1057
+ await migrations.executeWithDriver(driver, 0, beforeFkVersion, {
1058
+ updateVersionInMigration: false,
1059
+ });
1060
+
1061
+ await expect(
1062
+ migrations.executeWithDriver(driver, beforeFkVersion, fkLaterSchema.version, {
1063
+ updateVersionInMigration: false,
1064
+ }),
1065
+ ).rejects.toThrow(/foreign keys/i);
1066
+ } finally {
1067
+ await driver.destroy();
1068
+ }
1069
+ });
1070
+
1071
+ it("fails when adding a NOT NULL column without default to a table with data", async () => {
1072
+ const { adapter, driver, database } = createAdapter();
1073
+ const addNotNullSchema = schema("add_not_null", (s) => {
1074
+ return s
1075
+ .addTable("items", (t) => {
1076
+ return t.addColumn("id", idColumn()).addColumn("name", column("string"));
1077
+ })
1078
+ .alterTable("items", (t) => {
1079
+ return t.addColumn("status", column("string"));
1080
+ });
1081
+ });
1082
+
1083
+ const namespace = "add_not_null";
1084
+ const resolver = createNamingResolver(addNotNullSchema, namespace, suffixNamingStrategy);
1085
+ const itemsTable = resolver.getTableName("items");
1086
+ const migrations = adapter.prepareMigrations(addNotNullSchema, namespace);
1087
+ const beforeAddVersion = addNotNullSchema.version - 1;
1088
+
1089
+ try {
1090
+ await migrations.executeWithDriver(driver, 0, beforeAddVersion, {
1091
+ updateVersionInMigration: false,
1092
+ });
1093
+
1094
+ database
1095
+ .prepare(`insert into "${itemsTable}" ("id", "name") values (?, ?)`)
1096
+ .run("item-1", "First");
1097
+
1098
+ await expect(
1099
+ migrations.executeWithDriver(driver, beforeAddVersion, addNotNullSchema.version, {
1100
+ updateVersionInMigration: false,
1101
+ }),
1102
+ ).rejects.toThrow(/not null/i);
1103
+ } finally {
1104
+ await driver.destroy();
1105
+ }
1106
+ });
1107
+
1108
+ it("fails when tightening a nullable column with existing NULL values", async () => {
1109
+ const { adapter, driver, database } = createAdapter();
1110
+ const tightenSchema = schema("tighten_nullable", (s) => {
1111
+ return s
1112
+ .addTable("items", (t) => {
1113
+ return t.addColumn("id", idColumn()).addColumn("note", column("string").nullable());
1114
+ })
1115
+ .alterTable("items", (t) => {
1116
+ return t.alterColumn("note").nullable(false);
1117
+ });
1118
+ });
1119
+
1120
+ const namespace = "tighten_nullable";
1121
+ const resolver = createNamingResolver(tightenSchema, namespace, suffixNamingStrategy);
1122
+ const itemsTable = resolver.getTableName("items");
1123
+ const migrations = adapter.prepareMigrations(tightenSchema, namespace);
1124
+ const beforeTightenVersion = tightenSchema.version - 1;
1125
+
1126
+ try {
1127
+ await migrations.executeWithDriver(driver, 0, beforeTightenVersion, {
1128
+ updateVersionInMigration: false,
1129
+ });
1130
+
1131
+ database
1132
+ .prepare(`insert into "${itemsTable}" ("id", "note") values (?, ?)`)
1133
+ .run("item-1", null);
1134
+
1135
+ await expect(
1136
+ migrations.executeWithDriver(driver, beforeTightenVersion, tightenSchema.version, {
1137
+ updateVersionInMigration: false,
1138
+ }),
1139
+ ).rejects.toThrow(/not null/i);
1140
+ } finally {
1141
+ await driver.destroy();
1142
+ }
1143
+ });
1144
+
1145
+ it("fails when adding a unique index with duplicate data", async () => {
1146
+ const { adapter, driver, database } = createAdapter();
1147
+ const uniqueIndexSchema = schema("unique_index", (s) => {
1148
+ return s
1149
+ .addTable("items", (t) => {
1150
+ return t.addColumn("id", idColumn()).addColumn("name", column("string"));
1151
+ })
1152
+ .alterTable("items", (t) => {
1153
+ return t.createIndex("unique_name", ["name"], { unique: true });
1154
+ });
1155
+ });
1156
+
1157
+ const namespace = "unique_index";
1158
+ const resolver = createNamingResolver(uniqueIndexSchema, namespace, suffixNamingStrategy);
1159
+ const itemsTable = resolver.getTableName("items");
1160
+ const migrations = adapter.prepareMigrations(uniqueIndexSchema, namespace);
1161
+ const beforeIndexVersion = uniqueIndexSchema.version - 1;
1162
+
1163
+ try {
1164
+ await migrations.executeWithDriver(driver, 0, beforeIndexVersion, {
1165
+ updateVersionInMigration: false,
1166
+ });
1167
+
1168
+ const insert = database.prepare(`insert into "${itemsTable}" ("id", "name") values (?, ?)`);
1169
+ insert.run("item-1", "dup");
1170
+ insert.run("item-2", "dup");
1171
+
1172
+ await expect(
1173
+ migrations.executeWithDriver(driver, beforeIndexVersion, uniqueIndexSchema.version, {
1174
+ updateVersionInMigration: false,
1175
+ }),
1176
+ ).rejects.toThrow(/unique/i);
1177
+ } finally {
1178
+ await driver.destroy();
1179
+ }
1180
+ });
1181
+ });
@@ -1,16 +1,20 @@
1
+ import { beforeAll, describe, expect, expectTypeOf, it } from "vitest";
2
+
1
3
  import SQLite from "better-sqlite3";
2
4
  import { SqliteDialect } from "kysely";
3
- import { SqlAdapter } from "./generic-sql-adapter";
4
- import { beforeAll, describe, expect, expectTypeOf, it } from "vitest";
5
- import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../schema/create";
5
+
6
+ import { internalSchema } from "../../fragments/internal-fragment";
7
+ import type { InternalFragmentInstance } from "../../fragments/internal-fragment";
8
+ import { prepareHookMutations, type HooksMap } from "../../hooks/hooks";
6
9
  import { Cursor } from "../../query/cursor";
7
10
  import {
8
11
  createServiceTxBuilder,
9
12
  createHandlerTxBuilder,
10
13
  } from "../../query/unit-of-work/execute-unit-of-work";
11
14
  import { ExponentialBackoffRetryPolicy } from "../../query/unit-of-work/retry-policy";
15
+ import { column, idColumn, referenceColumn, schema, type FragnoId } from "../../schema/create";
12
16
  import { BetterSQLite3DriverConfig } from "./driver-config";
13
- import { internalSchema } from "../../fragments/internal-fragment";
17
+ import { SqlAdapter } from "./generic-sql-adapter";
14
18
 
15
19
  describe("SqlAdapter SQLite", () => {
16
20
  const testSchema = schema("test", (s) => {
@@ -20,7 +24,8 @@ describe("SqlAdapter SQLite", () => {
20
24
  .addColumn("id", idColumn())
21
25
  .addColumn("name", column("string"))
22
26
  .addColumn("age", column("integer").nullable())
23
- .createIndex("name_idx", ["name"]);
27
+ .createIndex("name_idx", ["name"])
28
+ .createIndex("name_id_idx", ["name", "id"]);
24
29
  })
25
30
  .addTable("emails", (t) => {
26
31
  return t
@@ -39,6 +44,13 @@ describe("SqlAdapter SQLite", () => {
39
44
  .addColumn("content", column("string"))
40
45
  .createIndex("posts_user_idx", ["user_id"]);
41
46
  })
47
+ .addTable("optional_emails", (t) => {
48
+ return t
49
+ .addColumn("id", idColumn())
50
+ .addColumn("user_id", referenceColumn().nullable())
51
+ .addColumn("email", column("string"))
52
+ .createIndex("optional_emails_user_idx", ["user_id"]);
53
+ })
42
54
  .addTable("comments", (t) => {
43
55
  return t
44
56
  .addColumn("id", idColumn())
@@ -58,6 +70,11 @@ describe("SqlAdapter SQLite", () => {
58
70
  from: { table: "posts", column: "user_id" },
59
71
  to: { table: "users", column: "id" },
60
72
  })
73
+ .addReference("user", {
74
+ type: "one",
75
+ from: { table: "optional_emails", column: "user_id" },
76
+ to: { table: "users", column: "id" },
77
+ })
61
78
  .addReference("post", {
62
79
  type: "one",
63
80
  from: { table: "comments", column: "post_id" },
@@ -149,7 +166,7 @@ describe("SqlAdapter SQLite", () => {
149
166
  Parameters<typeof createUow.find>[0]
150
167
  >();
151
168
  expectTypeOf<keyof typeof testSchema.tables>().toEqualTypeOf<
152
- "users" | "emails" | "posts" | "comments"
169
+ "users" | "emails" | "posts" | "comments" | "optional_emails"
153
170
  >();
154
171
 
155
172
  const { success: createSuccess } = await createUow.executeMutations();
@@ -249,6 +266,45 @@ describe("SqlAdapter SQLite", () => {
249
266
  });
250
267
  });
251
268
 
269
+ it("should fail inserting duplicate triggered hook ids", async () => {
270
+ const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
271
+ const hookId = "hook-duplicate-id";
272
+ const hooks: HooksMap = {
273
+ onTest: () => {},
274
+ };
275
+
276
+ const internalFragmentStub = {
277
+ $internal: { deps: { schema: internalSchema } },
278
+ } as InternalFragmentInstance;
279
+
280
+ const buildHookUow = (name: string) => {
281
+ const uow = queryEngine.createUnitOfWork(name).forSchema(testSchema, hooks);
282
+ uow.triggerHook("onTest", { data: name }, { id: hookId });
283
+ prepareHookMutations(
284
+ uow,
285
+ internalFragmentStub,
286
+ new ExponentialBackoffRetryPolicy({ maxRetries: 5 }),
287
+ );
288
+ return uow;
289
+ };
290
+
291
+ const firstUow = buildHookUow("hook-duplicate-first");
292
+ const { success } = await firstUow.executeMutations();
293
+ expect(success).toBe(true);
294
+
295
+ const secondUow = buildHookUow("hook-duplicate-second");
296
+ await expect(secondUow.executeMutations()).rejects.toThrow();
297
+
298
+ const verifyUow = queryEngine.createUnitOfWork("verify-duplicate-hook-id");
299
+ const internalUow = verifyUow.forSchema(internalSchema);
300
+ const findUow = internalUow.find("fragno_hooks", (b) =>
301
+ b.whereIndex("primary", (eb) => eb("id", "=", hookId)),
302
+ );
303
+ const [events] = await findUow.executeRetrieve();
304
+
305
+ expect(events).toHaveLength(1);
306
+ });
307
+
252
308
  it("should support count operations", async () => {
253
309
  const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
254
310
 
@@ -380,6 +436,26 @@ describe("SqlAdapter SQLite", () => {
380
436
  });
381
437
  });
382
438
 
439
+ it("should return null for left-joined relation when foreign key is null", async () => {
440
+ const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
441
+
442
+ const createUow = queryEngine.createUnitOfWork("create-optional-email");
443
+ createUow.create("optional_emails", {
444
+ user_id: null,
445
+ email: "optional@example.com",
446
+ });
447
+ await createUow.executeMutations();
448
+
449
+ const uow = queryEngine
450
+ .createUnitOfWork("join-optional-email")
451
+ .find("optional_emails", (b) => b.whereIndex("primary").join((jb) => jb.user()));
452
+
453
+ const [[email]] = await uow.executeRetrieve();
454
+
455
+ expect(email.email).toBe("optional@example.com");
456
+ expect(email.user).toBeNull();
457
+ });
458
+
383
459
  it("should support complex nested joins (comments -> post -> author)", async () => {
384
460
  const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
385
461
 
@@ -796,6 +872,47 @@ describe("SqlAdapter SQLite", () => {
796
872
  expect(emptyPage.cursor).toBeUndefined();
797
873
  });
798
874
 
875
+ it("should support composite cursor pagination", async () => {
876
+ const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
877
+ const nameValue = "SqlAdapter SQLite UOW Composite Cursor";
878
+
879
+ const createUow = queryEngine.createUnitOfWork("create-composite-cursor-users");
880
+ for (let i = 0; i < 5; i += 1) {
881
+ createUow.create("users", { name: nameValue, age: 60 + i });
882
+ }
883
+ await createUow.executeMutations();
884
+
885
+ const all = await queryEngine.find("users", (b) =>
886
+ b
887
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
888
+ .orderByIndex("name_id_idx", "asc"),
889
+ );
890
+
891
+ const firstPage = await queryEngine.findWithCursor("users", (b) =>
892
+ b
893
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
894
+ .orderByIndex("name_id_idx", "asc")
895
+ .pageSize(2),
896
+ );
897
+
898
+ const secondPage = await queryEngine.findWithCursor("users", (b) =>
899
+ b
900
+ .whereIndex("name_id_idx", (eb) => eb("name", "=", nameValue))
901
+ .after(firstPage.cursor!)
902
+ .orderByIndex("name_id_idx", "asc")
903
+ .pageSize(2),
904
+ );
905
+
906
+ const ids = (rows: { id: FragnoId }[]) => rows.map((row) => row.id.externalId);
907
+
908
+ expect(all.length).toBeGreaterThanOrEqual(5);
909
+ expect(firstPage.items).toHaveLength(2);
910
+ expect(firstPage.cursor).toBeInstanceOf(Cursor);
911
+ expect(firstPage.hasNextPage).toBe(true);
912
+ expect(ids(firstPage.items)).toEqual(ids(all).slice(0, 2));
913
+ expect(ids([...firstPage.items, ...secondPage.items])).toEqual(ids(all).slice(0, 4));
914
+ });
915
+
799
916
  it("should support handlerTx with retry logic", async () => {
800
917
  const queryEngine = adapter.createQueryEngine(testSchema, "namespace");
801
918
 
@@ -1,8 +1,10 @@
1
- import { SQLocalKysely } from "sqlocal/kysely";
2
1
  import { beforeAll, describe, expect, it } from "vitest";
3
- import { SqlAdapter } from "./generic-sql-adapter";
2
+
3
+ import { SQLocalKysely } from "sqlocal/kysely";
4
+
4
5
  import { column, idColumn, referenceColumn, schema } from "../../schema/create";
5
6
  import { SQLocalDriverConfig } from "./driver-config";
7
+ import { SqlAdapter } from "./generic-sql-adapter";
6
8
 
7
9
  describe("SqlAdapter SQLite", () => {
8
10
  const testSchema = schema("test", (s) => {
@@ -1,9 +1,10 @@
1
1
  import { describe, it, expect } from "vitest";
2
- import { schema, idColumn, column, FragnoId } from "../../schema/create";
3
- import { UnitOfWorkDecoder } from "./uow-decoder";
4
- import { SQLocalDriverConfig } from "./driver-config";
2
+
5
3
  import type { RetrievalOperation } from "../../query/unit-of-work/unit-of-work";
4
+ import { schema, idColumn, column, FragnoId } from "../../schema/create";
6
5
  import type { AnySchema } from "../../schema/create";
6
+ import { SQLocalDriverConfig } from "./driver-config";
7
+ import { UnitOfWorkDecoder } from "./uow-decoder";
7
8
 
8
9
  describe("UnitOfWorkDecoder", () => {
9
10
  const driverConfig = new SQLocalDriverConfig();
@@ -1,11 +1,11 @@
1
+ import type { NamingResolver } from "../../naming/sql-naming";
2
+ import { createCursorFromRecord, type Cursor, type CursorResult } from "../../query/cursor";
1
3
  import type { UOWDecoder } from "../../query/unit-of-work/unit-of-work";
2
4
  import type { RetrievalOperation } from "../../query/unit-of-work/unit-of-work";
3
- import type { AnySchema, AnyTable } from "../../schema/create";
4
5
  import { decodeResult } from "../../query/value-decoding";
5
- import { createCursorFromRecord, type Cursor, type CursorResult } from "../../query/cursor";
6
+ import type { AnySchema, AnyTable } from "../../schema/create";
6
7
  import type { DriverConfig } from "./driver-config";
7
8
  import type { SQLiteStorageMode } from "./sqlite-storage";
8
- import type { NamingResolver } from "../../naming/sql-naming";
9
9
 
10
10
  /**
11
11
  * Decoder class for Unit of Work retrieval results.
@@ -1,13 +1,15 @@
1
1
  import { describe, it, expect } from "vitest";
2
+
2
3
  import { Kysely, PostgresDialect } from "kysely";
3
- import { UnitOfWorkEncoder } from "./uow-encoder";
4
- import { schema, column, idColumn, referenceColumn } from "../../schema/create";
4
+
5
5
  import { dbNow } from "../../query/db-now";
6
+ import { schema, column, idColumn, referenceColumn } from "../../schema/create";
6
7
  import {
7
8
  BetterSQLite3DriverConfig,
8
9
  MySQL2DriverConfig,
9
10
  NodePostgresDriverConfig,
10
11
  } from "./driver-config";
12
+ import { UnitOfWorkEncoder } from "./uow-encoder";
11
13
 
12
14
  describe("UnitOfWorkEncoder", () => {
13
15
  const testSchema = schema("test", (s) => {
@@ -1,15 +1,17 @@
1
- import type { AnyTable, AnyColumn } from "../../schema/create";
2
- import type { DriverConfig } from "./driver-config";
1
+ import type { Kysely } from "kysely";
2
+
3
+ import type { NamingResolver } from "../../naming/sql-naming";
4
+ import { getDbNowOffsetMs, isDbNow } from "../../query/db-now";
3
5
  import {
4
6
  createSQLSerializer,
5
7
  type SQLSerializer,
6
8
  } from "../../query/serialize/create-sql-serializer";
7
9
  import { encodeValues } from "../../query/value-encoding";
10
+ import type { AnyTable, AnyColumn } from "../../schema/create";
11
+ import type { DriverConfig } from "./driver-config";
12
+ import { buildDbNowSql } from "./query/db-now-sql";
8
13
  import { processReferenceSubqueries } from "./query/where-builder";
9
- import type { NamingResolver } from "../../naming/sql-naming";
10
- import { sql, type Kysely } from "kysely";
11
- import { isDbNow } from "../../query/db-now";
12
- import { sqliteStorageDefault, type SQLiteStorageMode } from "./sqlite-storage";
14
+ import type { SQLiteStorageMode } from "./sqlite-storage";
13
15
 
14
16
  /**
15
17
  * Encoder class for Unit of Work mutation operations.
@@ -121,18 +123,12 @@ export class UnitOfWorkEncoder {
121
123
  }
122
124
 
123
125
  if (isDbNow(value)) {
124
- if (this.#driverConfig.databaseType === "sqlite") {
125
- const storageMode = this.#sqliteStorageMode ?? sqliteStorageDefault;
126
- const storage =
127
- col.type === "date" ? storageMode.dateStorage : storageMode.timestampStorage;
128
- if ((col.type === "timestamp" || col.type === "date") && storage === "epoch-ms") {
129
- result[dbColumnName] = sql`(cast((julianday('now') - 2440587.5)*86400000 as integer))`;
130
- } else {
131
- result[dbColumnName] = sql`CURRENT_TIMESTAMP`;
132
- }
133
- } else {
134
- result[dbColumnName] = sql`CURRENT_TIMESTAMP`;
135
- }
126
+ result[dbColumnName] = buildDbNowSql({
127
+ driverConfig: this.#driverConfig,
128
+ columnType: col.type,
129
+ offsetMs: getDbNowOffsetMs(value),
130
+ sqliteStorageMode: this.#sqliteStorageMode,
131
+ });
136
132
  continue;
137
133
  }
138
134
 
@@ -1,7 +1,8 @@
1
1
  import { describe, expect, it } from "vitest";
2
- import { column, idColumn, referenceColumn, schema } from "../../schema/create";
2
+
3
3
  import type { Condition } from "../../query/condition-builder";
4
4
  import { buildCondition } from "../../query/condition-builder";
5
+ import { column, idColumn, referenceColumn, schema } from "../../schema/create";
5
6
  import { evaluateCondition } from "./condition-evaluator";
6
7
  import { createNamespaceStore } from "./store";
7
8
 
@@ -1,13 +1,13 @@
1
+ import type { NamingResolver } from "../../naming/sql-naming";
1
2
  import type { Condition } from "../../query/condition-builder";
3
+ import { getDbNowOffsetMs, isDbNow } from "../../query/db-now";
2
4
  import { ReferenceSubquery, resolveFragnoIdValue } from "../../query/value-encoding";
3
- import { isDbNow } from "../../query/db-now";
4
5
  import type { AnyColumn, AnyTable } from "../../schema/create";
5
6
  import { Column, FragnoId, FragnoReference } from "../../schema/create";
7
+ import { resolveReferenceSubquery } from "./reference-resolution";
6
8
  import type { InMemoryNamespaceStore, InMemoryRow } from "./store";
7
9
  import { normalizeIndexValue } from "./store";
8
- import { resolveReferenceSubquery } from "./reference-resolution";
9
10
  import { compareNormalizedValues } from "./value-comparison";
10
- import type { NamingResolver } from "../../naming/sql-naming";
11
11
 
12
12
  const isNullish = (value: unknown): value is null | undefined =>
13
13
  value === null || value === undefined;
@@ -74,7 +74,12 @@ const resolveComparisonValue = (
74
74
  }
75
75
 
76
76
  if (isDbNow(value)) {
77
- return { value: now(), column };
77
+ const base = now();
78
+ const offsetMs = getDbNowOffsetMs(value);
79
+ return {
80
+ value: offsetMs === 0 ? base : new Date(base.getTime() + offsetMs),
81
+ column,
82
+ };
78
83
  }
79
84
 
80
85
  if (column.role === "reference") {