@fragno-dev/db 0.2.1 → 0.3.0

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 (362) hide show
  1. package/.turbo/turbo-build.log +206 -140
  2. package/CHANGELOG.md +67 -0
  3. package/README.md +30 -9
  4. package/dist/adapters/adapters.d.ts +23 -21
  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/driver-config.d.ts +16 -1
  8. package/dist/adapters/generic-sql/driver-config.d.ts.map +1 -1
  9. package/dist/adapters/generic-sql/driver-config.js +23 -1
  10. package/dist/adapters/generic-sql/driver-config.js.map +1 -1
  11. package/dist/adapters/generic-sql/generic-sql-adapter.d.ts +27 -9
  12. package/dist/adapters/generic-sql/generic-sql-adapter.d.ts.map +1 -1
  13. package/dist/adapters/generic-sql/generic-sql-adapter.js +55 -16
  14. package/dist/adapters/generic-sql/generic-sql-adapter.js.map +1 -1
  15. package/dist/adapters/generic-sql/generic-sql-uow-executor.js +129 -3
  16. package/dist/adapters/generic-sql/generic-sql-uow-executor.js.map +1 -1
  17. package/dist/adapters/generic-sql/migration/dialect/mysql.js +24 -5
  18. package/dist/adapters/generic-sql/migration/dialect/mysql.js.map +1 -1
  19. package/dist/adapters/generic-sql/migration/dialect/postgres.js +6 -5
  20. package/dist/adapters/generic-sql/migration/dialect/postgres.js.map +1 -1
  21. package/dist/adapters/generic-sql/migration/dialect/sqlite.js +21 -10
  22. package/dist/adapters/generic-sql/migration/dialect/sqlite.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 +8 -8
  25. package/dist/adapters/generic-sql/migration/prepared-migrations.js.map +1 -1
  26. package/dist/adapters/generic-sql/migration/sql-generator.js +74 -51
  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 +6 -5
  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 +42 -4
  31. package/dist/adapters/generic-sql/query/cursor-utils.js.map +1 -1
  32. package/dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js +25 -17
  33. package/dist/adapters/generic-sql/query/generic-sql-uow-operation-compiler.js.map +1 -1
  34. package/dist/adapters/generic-sql/query/select-builder.js +5 -3
  35. package/dist/adapters/generic-sql/query/select-builder.js.map +1 -1
  36. package/dist/adapters/generic-sql/query/sql-query-compiler.js +15 -12
  37. package/dist/adapters/generic-sql/query/sql-query-compiler.js.map +1 -1
  38. package/dist/adapters/generic-sql/query/where-builder.js +38 -28
  39. package/dist/adapters/generic-sql/query/where-builder.js.map +1 -1
  40. package/dist/adapters/generic-sql/sqlite-storage.d.ts +13 -0
  41. package/dist/adapters/generic-sql/sqlite-storage.d.ts.map +1 -0
  42. package/dist/adapters/generic-sql/sqlite-storage.js +15 -0
  43. package/dist/adapters/generic-sql/sqlite-storage.js.map +1 -0
  44. package/dist/adapters/generic-sql/uow-decoder.js +7 -3
  45. package/dist/adapters/generic-sql/uow-decoder.js.map +1 -1
  46. package/dist/adapters/generic-sql/uow-encoder.js +28 -8
  47. package/dist/adapters/generic-sql/uow-encoder.js.map +1 -1
  48. package/dist/adapters/in-memory/condition-evaluator.js +131 -0
  49. package/dist/adapters/in-memory/condition-evaluator.js.map +1 -0
  50. package/dist/adapters/in-memory/errors.d.ts +13 -0
  51. package/dist/adapters/in-memory/errors.d.ts.map +1 -0
  52. package/dist/adapters/in-memory/errors.js +23 -0
  53. package/dist/adapters/in-memory/errors.js.map +1 -0
  54. package/dist/adapters/in-memory/in-memory-adapter.d.ts +27 -0
  55. package/dist/adapters/in-memory/in-memory-adapter.d.ts.map +1 -0
  56. package/dist/adapters/in-memory/in-memory-adapter.js +176 -0
  57. package/dist/adapters/in-memory/in-memory-adapter.js.map +1 -0
  58. package/dist/adapters/in-memory/in-memory-uow.js +648 -0
  59. package/dist/adapters/in-memory/in-memory-uow.js.map +1 -0
  60. package/dist/adapters/in-memory/index.d.ts +4 -0
  61. package/dist/adapters/in-memory/index.js +4 -0
  62. package/dist/adapters/in-memory/options.d.ts +28 -0
  63. package/dist/adapters/in-memory/options.d.ts.map +1 -0
  64. package/dist/adapters/in-memory/options.js +61 -0
  65. package/dist/adapters/in-memory/options.js.map +1 -0
  66. package/dist/adapters/in-memory/reference-resolution.js +26 -0
  67. package/dist/adapters/in-memory/reference-resolution.js.map +1 -0
  68. package/dist/adapters/in-memory/sorted-array-index.js +129 -0
  69. package/dist/adapters/in-memory/sorted-array-index.js.map +1 -0
  70. package/dist/adapters/in-memory/store.js +71 -0
  71. package/dist/adapters/in-memory/store.js.map +1 -0
  72. package/dist/adapters/in-memory/value-comparison.js +28 -0
  73. package/dist/adapters/in-memory/value-comparison.js.map +1 -0
  74. package/dist/adapters/shared/from-unit-of-work-compiler.js.map +1 -1
  75. package/dist/adapters/shared/uow-operation-compiler.js +11 -11
  76. package/dist/adapters/shared/uow-operation-compiler.js.map +1 -1
  77. package/dist/adapters/sql/index.d.ts +5 -0
  78. package/dist/adapters/sql/index.js +4 -0
  79. package/dist/db-fragment-definition-builder.d.ts +45 -96
  80. package/dist/db-fragment-definition-builder.d.ts.map +1 -1
  81. package/dist/db-fragment-definition-builder.js +121 -99
  82. package/dist/db-fragment-definition-builder.js.map +1 -1
  83. package/dist/dispatchers/cloudflare-do/index.d.ts +26 -0
  84. package/dist/dispatchers/cloudflare-do/index.d.ts.map +1 -0
  85. package/dist/dispatchers/cloudflare-do/index.js +63 -0
  86. package/dist/dispatchers/cloudflare-do/index.js.map +1 -0
  87. package/dist/dispatchers/node/index.d.ts +17 -0
  88. package/dist/dispatchers/node/index.d.ts.map +1 -0
  89. package/dist/dispatchers/node/index.js +59 -0
  90. package/dist/dispatchers/node/index.js.map +1 -0
  91. package/dist/fragments/internal-fragment.d.ts +172 -9
  92. package/dist/fragments/internal-fragment.d.ts.map +1 -1
  93. package/dist/fragments/internal-fragment.js +193 -74
  94. package/dist/fragments/internal-fragment.js.map +1 -1
  95. package/dist/fragments/internal-fragment.routes.js +29 -0
  96. package/dist/fragments/internal-fragment.routes.js.map +1 -0
  97. package/dist/fragments/internal-fragment.schema.d.ts +9 -0
  98. package/dist/fragments/internal-fragment.schema.d.ts.map +1 -0
  99. package/dist/fragments/internal-fragment.schema.js +22 -0
  100. package/dist/fragments/internal-fragment.schema.js.map +1 -0
  101. package/dist/hooks/durable-hooks-processor.d.ts +14 -0
  102. package/dist/hooks/durable-hooks-processor.d.ts.map +1 -0
  103. package/dist/hooks/durable-hooks-processor.js +32 -0
  104. package/dist/hooks/durable-hooks-processor.js.map +1 -0
  105. package/dist/hooks/hooks.d.ts +47 -4
  106. package/dist/hooks/hooks.d.ts.map +1 -1
  107. package/dist/hooks/hooks.js +106 -39
  108. package/dist/hooks/hooks.js.map +1 -1
  109. package/dist/migration-engine/auto-from-schema.js +14 -11
  110. package/dist/migration-engine/auto-from-schema.js.map +1 -1
  111. package/dist/migration-engine/generation-engine.d.ts +16 -10
  112. package/dist/migration-engine/generation-engine.d.ts.map +1 -1
  113. package/dist/migration-engine/generation-engine.js +72 -33
  114. package/dist/migration-engine/generation-engine.js.map +1 -1
  115. package/dist/migration-engine/shared.js.map +1 -1
  116. package/dist/mod.d.ts +17 -10
  117. package/dist/mod.d.ts.map +1 -1
  118. package/dist/mod.js +14 -8
  119. package/dist/mod.js.map +1 -1
  120. package/dist/naming/sql-naming.d.ts +19 -0
  121. package/dist/naming/sql-naming.d.ts.map +1 -0
  122. package/dist/naming/sql-naming.js +116 -0
  123. package/dist/naming/sql-naming.js.map +1 -0
  124. package/dist/node_modules/.pnpm/{rou3@0.7.10 → rou3@0.7.12}/node_modules/rou3/dist/index.js +8 -5
  125. package/dist/node_modules/.pnpm/rou3@0.7.12/node_modules/rou3/dist/index.js.map +1 -0
  126. package/dist/outbox/outbox-builder.js +156 -0
  127. package/dist/outbox/outbox-builder.js.map +1 -0
  128. package/dist/outbox/outbox.d.ts +52 -0
  129. package/dist/outbox/outbox.d.ts.map +1 -0
  130. package/dist/outbox/outbox.js +37 -0
  131. package/dist/outbox/outbox.js.map +1 -0
  132. package/dist/packages/fragno/dist/api/fragment-definition-builder.js +3 -2
  133. package/dist/packages/fragno/dist/api/fragment-definition-builder.js.map +1 -1
  134. package/dist/packages/fragno/dist/api/fragment-instantiator.js +164 -20
  135. package/dist/packages/fragno/dist/api/fragment-instantiator.js.map +1 -1
  136. package/dist/packages/fragno/dist/api/request-input-context.js +67 -0
  137. package/dist/packages/fragno/dist/api/request-input-context.js.map +1 -1
  138. package/dist/packages/fragno/dist/api/route.js +14 -1
  139. package/dist/packages/fragno/dist/api/route.js.map +1 -1
  140. package/dist/packages/fragno/dist/internal/trace-context.js +12 -0
  141. package/dist/packages/fragno/dist/internal/trace-context.js.map +1 -0
  142. package/dist/query/column-defaults.js +20 -4
  143. package/dist/query/column-defaults.js.map +1 -1
  144. package/dist/query/cursor.d.ts +3 -1
  145. package/dist/query/cursor.d.ts.map +1 -1
  146. package/dist/query/cursor.js +45 -14
  147. package/dist/query/cursor.js.map +1 -1
  148. package/dist/query/db-now.d.ts +8 -0
  149. package/dist/query/db-now.d.ts.map +1 -0
  150. package/dist/query/db-now.js +7 -0
  151. package/dist/query/db-now.js.map +1 -0
  152. package/dist/query/serialize/create-sql-serializer.js +3 -2
  153. package/dist/query/serialize/create-sql-serializer.js.map +1 -1
  154. package/dist/query/serialize/dialect/mysql-serializer.js +12 -6
  155. package/dist/query/serialize/dialect/mysql-serializer.js.map +1 -1
  156. package/dist/query/serialize/dialect/postgres-serializer.js +25 -7
  157. package/dist/query/serialize/dialect/postgres-serializer.js.map +1 -1
  158. package/dist/query/serialize/dialect/sqlite-serializer.js +55 -11
  159. package/dist/query/serialize/dialect/sqlite-serializer.js.map +1 -1
  160. package/dist/query/serialize/sql-serializer.js +2 -2
  161. package/dist/query/serialize/sql-serializer.js.map +1 -1
  162. package/dist/query/simple-query-interface.d.ts +6 -1
  163. package/dist/query/simple-query-interface.d.ts.map +1 -1
  164. package/dist/query/unit-of-work/execute-unit-of-work.d.ts +351 -100
  165. package/dist/query/unit-of-work/execute-unit-of-work.d.ts.map +1 -1
  166. package/dist/query/unit-of-work/execute-unit-of-work.js +440 -267
  167. package/dist/query/unit-of-work/execute-unit-of-work.js.map +1 -1
  168. package/dist/query/unit-of-work/unit-of-work.d.ts +67 -22
  169. package/dist/query/unit-of-work/unit-of-work.d.ts.map +1 -1
  170. package/dist/query/unit-of-work/unit-of-work.js +110 -13
  171. package/dist/query/unit-of-work/unit-of-work.js.map +1 -1
  172. package/dist/query/value-decoding.js +8 -5
  173. package/dist/query/value-decoding.js.map +1 -1
  174. package/dist/query/value-encoding.js +29 -9
  175. package/dist/query/value-encoding.js.map +1 -1
  176. package/dist/schema/create.d.ts +40 -14
  177. package/dist/schema/create.d.ts.map +1 -1
  178. package/dist/schema/create.js +82 -42
  179. package/dist/schema/create.js.map +1 -1
  180. package/dist/schema/generate-id.d.ts +20 -0
  181. package/dist/schema/generate-id.d.ts.map +1 -0
  182. package/dist/schema/generate-id.js +28 -0
  183. package/dist/schema/generate-id.js.map +1 -0
  184. package/dist/schema/type-conversion/create-sql-type-mapper.js +3 -2
  185. package/dist/schema/type-conversion/create-sql-type-mapper.js.map +1 -1
  186. package/dist/schema/type-conversion/dialect/sqlite.js +9 -0
  187. package/dist/schema/type-conversion/dialect/sqlite.js.map +1 -1
  188. package/dist/schema/validator.d.ts +10 -0
  189. package/dist/schema/validator.d.ts.map +1 -0
  190. package/dist/schema/validator.js +123 -0
  191. package/dist/schema/validator.js.map +1 -0
  192. package/dist/schema-output/drizzle.d.ts +30 -0
  193. package/dist/schema-output/drizzle.d.ts.map +1 -0
  194. package/dist/{adapters/drizzle/generate.js → schema-output/drizzle.js} +82 -56
  195. package/dist/schema-output/drizzle.js.map +1 -0
  196. package/dist/schema-output/prisma.d.ts +17 -0
  197. package/dist/schema-output/prisma.d.ts.map +1 -0
  198. package/dist/schema-output/prisma.js +296 -0
  199. package/dist/schema-output/prisma.js.map +1 -0
  200. package/dist/util/default-database-adapter.js +61 -0
  201. package/dist/util/default-database-adapter.js.map +1 -0
  202. package/dist/with-database.d.ts +1 -1
  203. package/dist/with-database.d.ts.map +1 -1
  204. package/dist/with-database.js +12 -3
  205. package/dist/with-database.js.map +1 -1
  206. package/package.json +43 -28
  207. package/src/adapters/adapters.ts +30 -24
  208. package/src/adapters/drizzle/migrate-drizzle.test.ts +54 -33
  209. package/src/adapters/drizzle/migration-parity-drizzle-kit.test.ts +599 -0
  210. package/src/adapters/drizzle/test-utils.ts +12 -8
  211. package/src/adapters/generic-sql/driver-config.ts +38 -0
  212. package/src/adapters/generic-sql/generic-sql-adapter.test.ts +5 -5
  213. package/src/adapters/generic-sql/generic-sql-adapter.ts +110 -24
  214. package/src/adapters/generic-sql/generic-sql-uow-executor.test.ts +54 -0
  215. package/src/adapters/generic-sql/generic-sql-uow-executor.ts +231 -3
  216. package/src/adapters/generic-sql/migration/adapter-migration-parity.test.ts +118 -0
  217. package/src/adapters/generic-sql/migration/dialect/mysql.test.ts +26 -8
  218. package/src/adapters/generic-sql/migration/dialect/mysql.ts +46 -8
  219. package/src/adapters/generic-sql/migration/dialect/postgres.test.ts +25 -7
  220. package/src/adapters/generic-sql/migration/dialect/postgres.ts +8 -4
  221. package/src/adapters/generic-sql/migration/dialect/sqlite.test.ts +47 -8
  222. package/src/adapters/generic-sql/migration/dialect/sqlite.ts +27 -12
  223. package/src/adapters/generic-sql/migration/prepared-migrations.test.ts +128 -39
  224. package/src/adapters/generic-sql/migration/prepared-migrations.ts +15 -8
  225. package/src/adapters/generic-sql/migration/sql-generator.ts +142 -65
  226. package/src/adapters/generic-sql/query/create-sql-query-compiler.ts +9 -6
  227. package/src/adapters/generic-sql/query/cursor-utils.test.ts +271 -0
  228. package/src/adapters/generic-sql/query/cursor-utils.ts +41 -6
  229. package/src/adapters/generic-sql/query/generic-sql-uow-operation-compiler.test.ts +27 -27
  230. package/src/adapters/generic-sql/query/generic-sql-uow-operation-compiler.ts +38 -24
  231. package/src/adapters/generic-sql/query/select-builder.test.ts +15 -11
  232. package/src/adapters/generic-sql/query/select-builder.ts +6 -2
  233. package/src/adapters/generic-sql/query/sql-query-compiler.test.ts +52 -2
  234. package/src/adapters/generic-sql/query/sql-query-compiler.ts +50 -15
  235. package/src/adapters/generic-sql/query/where-builder.test.ts +91 -17
  236. package/src/adapters/generic-sql/query/where-builder.ts +90 -38
  237. package/src/adapters/{kysely/kysely-adapter-pglite.test.ts → generic-sql/sql-adapter-pglite-migrations.test.ts} +6 -6
  238. package/src/adapters/generic-sql/sql-adapter-pglite-pagination.test.ts +806 -0
  239. package/src/adapters/{drizzle/drizzle-adapter-pglite.test.ts → generic-sql/sql-adapter-pglite-queries.test.ts} +11 -11
  240. package/src/adapters/generic-sql/{test/generic-drizzle-adapter-sqlite3.test.ts → sql-adapter-sqlite3-driver.test.ts} +49 -35
  241. package/src/adapters/{drizzle/drizzle-adapter-sqlite3.test.ts → generic-sql/sql-adapter-sqlite3-uow.test.ts} +48 -32
  242. package/src/adapters/{kysely/kysely-adapter-sqlocal.test.ts → generic-sql/sql-adapter-sqlocal.test.ts} +6 -6
  243. package/src/adapters/generic-sql/sqlite-storage.ts +20 -0
  244. package/src/adapters/generic-sql/uow-decoder.test.ts +1 -1
  245. package/src/adapters/generic-sql/uow-decoder.ts +21 -3
  246. package/src/adapters/generic-sql/uow-encoder.test.ts +33 -2
  247. package/src/adapters/generic-sql/uow-encoder.ts +50 -11
  248. package/src/adapters/in-memory/condition-evaluator.test.ts +193 -0
  249. package/src/adapters/in-memory/condition-evaluator.ts +275 -0
  250. package/src/adapters/in-memory/errors.ts +20 -0
  251. package/src/adapters/in-memory/in-memory-adapter.ts +277 -0
  252. package/src/adapters/in-memory/in-memory-uow.mutations.test.ts +296 -0
  253. package/src/adapters/in-memory/in-memory-uow.retrieval.test.ts +100 -0
  254. package/src/adapters/in-memory/in-memory-uow.ts +1348 -0
  255. package/src/adapters/in-memory/index.ts +3 -0
  256. package/src/adapters/in-memory/options.test.ts +41 -0
  257. package/src/adapters/in-memory/options.ts +87 -0
  258. package/src/adapters/in-memory/reference-resolution.test.ts +50 -0
  259. package/src/adapters/in-memory/reference-resolution.ts +67 -0
  260. package/src/adapters/in-memory/sorted-array-index.test.ts +123 -0
  261. package/src/adapters/in-memory/sorted-array-index.ts +228 -0
  262. package/src/adapters/in-memory/store.test.ts +68 -0
  263. package/src/adapters/in-memory/store.ts +145 -0
  264. package/src/adapters/in-memory/value-comparison.ts +53 -0
  265. package/src/adapters/in-memory/value-normalization.test.ts +57 -0
  266. package/src/adapters/prisma/prisma-adapter-sqlite3.test.ts +1163 -0
  267. package/src/adapters/shared/from-unit-of-work-compiler.ts +3 -1
  268. package/src/adapters/shared/uow-operation-compiler.ts +26 -16
  269. package/src/adapters/sql/index.ts +12 -0
  270. package/src/db-fragment-definition-builder.test.ts +88 -54
  271. package/src/db-fragment-definition-builder.ts +201 -322
  272. package/src/db-fragment-instantiator.test.ts +169 -101
  273. package/src/db-fragment-integration.test.ts +301 -149
  274. package/src/dispatchers/cloudflare-do/index.test.ts +73 -0
  275. package/src/dispatchers/cloudflare-do/index.ts +104 -0
  276. package/src/dispatchers/node/index.test.ts +91 -0
  277. package/src/dispatchers/node/index.ts +87 -0
  278. package/src/fragments/internal-fragment.routes.ts +42 -0
  279. package/src/fragments/internal-fragment.schema.ts +51 -0
  280. package/src/fragments/internal-fragment.test.ts +730 -274
  281. package/src/fragments/internal-fragment.ts +447 -154
  282. package/src/hooks/durable-hooks-processor.test.ts +117 -0
  283. package/src/hooks/durable-hooks-processor.ts +67 -0
  284. package/src/hooks/hooks.test.ts +411 -259
  285. package/src/hooks/hooks.ts +265 -66
  286. package/src/migration-engine/auto-from-schema.test.ts +14 -14
  287. package/src/migration-engine/auto-from-schema.ts +5 -2
  288. package/src/migration-engine/create.test.ts +2 -2
  289. package/src/migration-engine/generation-engine.test.ts +229 -104
  290. package/src/migration-engine/generation-engine.ts +94 -64
  291. package/src/migration-engine/shared.ts +1 -0
  292. package/src/mod.ts +78 -30
  293. package/src/naming/sql-naming.ts +180 -0
  294. package/src/outbox/outbox-builder.ts +241 -0
  295. package/src/outbox/outbox.test.ts +253 -0
  296. package/src/outbox/outbox.ts +137 -0
  297. package/src/query/column-defaults.ts +41 -3
  298. package/src/query/condition-builder.test.ts +3 -3
  299. package/src/query/cursor.test.ts +116 -18
  300. package/src/query/cursor.ts +75 -26
  301. package/src/query/db-now.ts +6 -0
  302. package/src/query/query-type.test.ts +2 -2
  303. package/src/query/serialize/create-sql-serializer.ts +7 -2
  304. package/src/query/serialize/dialect/mysql-serializer.ts +12 -4
  305. package/src/query/serialize/dialect/postgres-serializer.ts +34 -4
  306. package/src/query/serialize/dialect/sqlite-serializer.test.ts +51 -1
  307. package/src/query/serialize/dialect/sqlite-serializer.ts +92 -9
  308. package/src/query/serialize/sql-serializer.ts +4 -4
  309. package/src/query/simple-query-interface.ts +5 -0
  310. package/src/query/unit-of-work/execute-unit-of-work.test.ts +1512 -1458
  311. package/src/query/unit-of-work/execute-unit-of-work.ts +1708 -596
  312. package/src/query/unit-of-work/tx-builder.test.ts +1041 -0
  313. package/src/query/unit-of-work/unit-of-work-coordinator.test.ts +32 -32
  314. package/src/query/unit-of-work/unit-of-work-types.test.ts +1 -1
  315. package/src/query/unit-of-work/unit-of-work.test.ts +231 -36
  316. package/src/query/unit-of-work/unit-of-work.ts +229 -31
  317. package/src/query/value-decoding.test.ts +13 -2
  318. package/src/query/value-decoding.ts +17 -4
  319. package/src/query/value-encoding.test.ts +85 -2
  320. package/src/query/value-encoding.ts +56 -6
  321. package/src/schema/create.test.ts +129 -42
  322. package/src/schema/create.ts +187 -47
  323. package/src/schema/generate-id.test.ts +57 -0
  324. package/src/schema/generate-id.ts +38 -0
  325. package/src/schema/serialize.test.ts +14 -2
  326. package/src/schema/type-conversion/create-sql-type-mapper.ts +7 -2
  327. package/src/schema/type-conversion/dialect/sqlite.ts +18 -0
  328. package/src/schema/type-conversion/type-mapping.test.ts +25 -1
  329. package/src/schema/validator.test.ts +197 -0
  330. package/src/schema/validator.ts +231 -0
  331. package/src/{adapters/drizzle/generate.test.ts → schema-output/drizzle.test.ts} +179 -129
  332. package/src/{adapters/drizzle/generate.ts → schema-output/drizzle.ts} +143 -93
  333. package/src/schema-output/prisma.test.ts +536 -0
  334. package/src/schema-output/prisma.ts +573 -0
  335. package/src/util/default-database-adapter.ts +106 -0
  336. package/src/with-database.ts +22 -3
  337. package/tsdown.config.ts +6 -4
  338. package/dist/adapters/drizzle/drizzle-adapter.d.ts +0 -20
  339. package/dist/adapters/drizzle/drizzle-adapter.d.ts.map +0 -1
  340. package/dist/adapters/drizzle/drizzle-adapter.js +0 -27
  341. package/dist/adapters/drizzle/drizzle-adapter.js.map +0 -1
  342. package/dist/adapters/drizzle/generate.d.ts +0 -30
  343. package/dist/adapters/drizzle/generate.d.ts.map +0 -1
  344. package/dist/adapters/drizzle/generate.js.map +0 -1
  345. package/dist/adapters/kysely/kysely-adapter.d.ts +0 -19
  346. package/dist/adapters/kysely/kysely-adapter.d.ts.map +0 -1
  347. package/dist/adapters/kysely/kysely-adapter.js +0 -17
  348. package/dist/adapters/kysely/kysely-adapter.js.map +0 -1
  349. package/dist/adapters/shared/table-name-mapper.d.ts +0 -12
  350. package/dist/adapters/shared/table-name-mapper.d.ts.map +0 -1
  351. package/dist/adapters/shared/table-name-mapper.js +0 -43
  352. package/dist/adapters/shared/table-name-mapper.js.map +0 -1
  353. package/dist/node_modules/.pnpm/rou3@0.7.10/node_modules/rou3/dist/index.js.map +0 -1
  354. package/dist/schema-generator/schema-generator.d.ts +0 -15
  355. package/dist/schema-generator/schema-generator.d.ts.map +0 -1
  356. package/src/adapters/drizzle/drizzle-adapter.ts +0 -39
  357. package/src/adapters/kysely/kysely-adapter.ts +0 -27
  358. package/src/adapters/shared/table-name-mapper.ts +0 -50
  359. package/src/schema-generator/schema-generator.ts +0 -12
  360. package/src/shared/config.ts +0 -10
  361. package/src/shared/connection-pool.ts +0 -24
  362. package/src/shared/prisma.ts +0 -45
@@ -1 +1 @@
1
- {"version":3,"file":"create.js","names":["defaultBuilder: DefaultBuilder","runtimeDefaultBuilder: RuntimeDefaultBuilder","#externalId","#internalId","#version","#name","#columns","#relations","#indexes","#columnOrder","column","idCol: AnyColumn | undefined","internalIdCol: AnyColumn | undefined","versionCol: AnyColumn | undefined","#ormName","table: Table<TColumns, TRelations, TIndexes>","#tables","#operations","schema","subOperations: TableSubOperation[]","cloneTables: Record<string, AnyTable>","clonedColumns: Record<string, AnyColumn>","clonedCol: AnyColumn"],"sources":["../../src/schema/create.ts"],"sourcesContent":["import { createId } from \"../id\";\n\nexport type AnySchema = Schema<Record<string, AnyTable>>;\n\nexport type AnyRelation = Relation;\n\nexport type AnyTable = Table;\n\nexport type AnyColumn =\n | Column<keyof TypeMap, unknown, unknown>\n | IdColumn<IdColumnType, unknown, unknown>\n | InternalIdColumn<unknown, unknown>\n | VersionColumn<unknown, unknown>;\n/**\n * Sub-operations that can be performed within table operations.\n * These are stored in order within add-table and alter-table operations.\n */\nexport type TableSubOperation =\n | { type: \"add-column\"; columnName: string; column: AnyColumn }\n | { type: \"add-index\"; name: string; columns: string[]; unique: boolean }\n | {\n type: \"add-foreign-key\";\n name: string;\n columns: string[];\n referencedTable: string;\n referencedColumns: string[];\n };\n\n/**\n * Operations that can be performed on a schema during its definition.\n * These are tracked so we can generate migrations for specific version ranges.\n */\nexport type SchemaOperation =\n | {\n type: \"add-table\";\n tableName: string;\n operations: TableSubOperation[]; // Ordered list of sub-operations\n }\n | {\n type: \"alter-table\";\n tableName: string;\n operations: TableSubOperation[]; // Ordered list of sub-operations\n }\n | {\n type: \"add-reference\";\n tableName: string; // The table that has the foreign key\n referenceName: string;\n config: {\n type: \"one\" | \"many\";\n from: { table: string; column: string };\n to: { table: string; column: string };\n };\n };\n\nexport interface ForeignKey {\n name: string;\n table: AnyTable;\n columns: AnyColumn[];\n\n referencedTable: AnyTable;\n referencedColumns: AnyColumn[];\n}\n\nclass RelationInit<\n TRelationType extends RelationType,\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n> {\n type: TRelationType;\n referencedTable: TTables[TTableName];\n referencer: AnyTable;\n on: [string, string][] = [];\n\n constructor(type: TRelationType, referencedTable: TTables[TTableName], referencer: AnyTable) {\n this.type = type;\n this.referencedTable = referencedTable;\n this.referencer = referencer;\n }\n}\n\nexport interface Index<\n TColumns extends AnyColumn[] = AnyColumn[],\n TColumnNames extends readonly string[] = readonly string[],\n> {\n name: string;\n columns: TColumns;\n columnNames: TColumnNames;\n unique: boolean;\n}\n\nexport class ExplicitRelationInit<\n TRelationType extends RelationType,\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n> extends RelationInit<TRelationType, TTables, TTableName> {\n init(ormName: string): Relation<TRelationType, TTables[TTableName]> {\n const id = `${this.referencer.ormName}_${this.referencedTable.ormName}`;\n\n return {\n id,\n on: this.on,\n name: ormName,\n referencer: this.referencer,\n table: this.referencedTable,\n type: this.type,\n };\n }\n}\n\nexport interface Relation<\n TRelationType extends RelationType = RelationType,\n TTable extends AnyTable = AnyTable,\n> {\n id: string;\n name: string;\n type: TRelationType;\n\n table: TTable;\n referencer: AnyTable;\n\n on: [string, string][];\n}\n\nexport interface Table<\n TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n name: string;\n ormName: string;\n\n columns: TColumns;\n relations: TRelations;\n indexes: TIndexes;\n\n /**\n * Get column by name\n */\n getColumnByName: (name: string) => AnyColumn | undefined;\n /**\n * Get the external ID column (user-facing)\n */\n getIdColumn: () => AnyColumn;\n /**\n * Get the internal ID column (database-native, used for joins)\n */\n getInternalIdColumn: () => AnyColumn;\n /**\n * Get the version column (for optimistic concurrency control)\n */\n getVersionColumn: () => AnyColumn;\n}\n\ntype DBSpecial = { tag: \"special\"; value: \"now\" };\ntype RuntimeSpecial = { tag: \"special\"; value: \"cuid\" | \"now\" };\n\n/**\n * Builder for database-level default values.\n */\nexport interface DefaultBuilder {\n /** Database-generated timestamp (DEFAULT NOW()) */\n now(): DBSpecial;\n}\n\n/**\n * Builder for runtime-generated default values.\n */\nexport interface RuntimeDefaultBuilder {\n /** Generate CUID identifier */\n cuid(): RuntimeSpecial;\n /** Generate current timestamp */\n now(): RuntimeSpecial;\n}\n\nconst defaultBuilder: DefaultBuilder = {\n now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\nconst runtimeDefaultBuilder: RuntimeDefaultBuilder = {\n cuid: () => ({ tag: \"special\", value: \"cuid\" }),\n now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\ntype IdColumnType = `varchar(${number})`;\n\nexport type TypeMap = {\n string: string;\n bigint: bigint;\n integer: number;\n decimal: number;\n bool: boolean;\n json: unknown;\n /**\n * this follows the same specs as Prisma `Bytes` for consistency.\n */\n binary: Uint8Array;\n date: Date;\n timestamp: Date;\n} & Record<`varchar(${number})`, string>;\n\nexport class Column<TType extends keyof TypeMap, TIn = unknown, TOut = unknown> {\n type: TType;\n name: string = \"\";\n ormName: string = \"\";\n isNullable: boolean = false;\n role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\" = \"regular\";\n isHidden: boolean = false;\n\n default?:\n | { value: TypeMap[TType] }\n | { dbSpecial: \"now\" }\n | { runtime: \"cuid\" | \"now\" | (() => TypeMap[TType]) };\n\n tableName: string = \"\";\n\n constructor(type: TType) {\n this.type = type;\n }\n\n nullable<TNullable extends boolean = true>(nullable?: TNullable) {\n this.isNullable = nullable ?? true;\n\n return this as Column<\n TType,\n TNullable extends true ? TIn | null : Exclude<TIn, null>,\n TNullable extends true ? TOut | null : Exclude<TOut, null>\n >;\n }\n\n hidden<THidden extends boolean = true>(hidden?: THidden) {\n this.isHidden = hidden ?? true;\n return this as Column<TType, null, null>;\n }\n\n /**\n * Generate default value at runtime in application code (not in the database).\n *\n * Use this when you need values generated in your application code, either because:\n * - Your database doesn't support the operation (e.g., generating CUIDs)\n * - You want consistent behavior across all databases\n * - You need custom generation logic\n *\n * @param value - Either a literal value or builder callback:\n * - Literal: Any static value of the column type\n * - `(b) => b.cuid()` - Generate a CUID identifier\n * - `(b) => b.now()` - Generate current timestamp\n * - `(b) => ...` - Custom function that returns the default value\n *\n * @example\n * ```ts\n * column(\"string\").defaultTo$((b) => b.cuid()) // Generate CUID at runtime\n * column(\"timestamp\").defaultTo$((b) => b.now()) // Generate timestamp at runtime\n * column(\"integer\").defaultTo$(42) // Static literal\n * column(\"integer\").defaultTo$((b) => Math.floor(Math.random() * 100)) // Custom function\n * ```\n */\n defaultTo$(\n value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n ): Column<TType, TIn | null, TOut> {\n if (typeof value === \"function\") {\n const fn = value as (builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType];\n const result = fn(runtimeDefaultBuilder);\n if (\n typeof result === \"object\" &&\n result !== null &&\n \"tag\" in result &&\n result.tag === \"special\"\n ) {\n this.default = { runtime: result.value };\n } else {\n // Custom function - we need to wrap the callback to call it again later\n this.default = { runtime: () => fn(runtimeDefaultBuilder) as TypeMap[TType] };\n }\n } else {\n // Direct literal value - wrap it in a function for runtime generation\n this.default = { runtime: () => value };\n }\n return this;\n }\n\n /**\n * Set a database-level default value (generated by the database, not application code).\n *\n * The database will generate the default value when inserting rows. If the database\n * doesn't support the operation, Fragno will fall back to generating the value in\n * application code.\n *\n * @param value - Either a literal value or builder callback:\n * - Literal: Any static value of the column type\n * - `(b) => b.now()` - Database-generated timestamp\n *\n * @example\n * ```ts\n * // Static defaults\n * column(\"string\").defaultTo(\"active\")\n * column(\"integer\").defaultTo(0)\n * column(\"boolean\").defaultTo(true)\n *\n * // Database-generated timestamp (with fallback)\n * column(\"timestamp\").defaultTo((b) => b.now())\n * ```\n */\n defaultTo(\n value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n ): Column<TType, TIn | null, TOut> {\n if (typeof value === \"function\") {\n const fn = value as (builder: DefaultBuilder) => DBSpecial | TypeMap[TType];\n const result = fn(defaultBuilder);\n if (\n typeof result === \"object\" &&\n result !== null &&\n \"tag\" in result &&\n result.tag === \"special\"\n ) {\n this.default = { dbSpecial: result.value };\n } else {\n this.default = { value: result as TypeMap[TType] };\n }\n } else {\n this.default = { value };\n }\n return this;\n }\n\n /**\n * Generate default value for the column at runtime.\n * Used for both runtime defaults (defaultTo$) and fallback generation for\n * database defaults (defaultTo) when the database doesn't support them.\n */\n generateDefaultValue(): TypeMap[TType] | undefined {\n if (!this.default) {\n return;\n }\n\n if (\"value\" in this.default) {\n return this.default.value;\n }\n\n if (\"dbSpecial\" in this.default) {\n // Fallback generation for database-level special functions\n if (this.default.dbSpecial === \"now\") {\n return new Date(Date.now()) as TypeMap[TType];\n }\n return;\n }\n\n // Runtime defaults (defaultTo$)\n if (this.default.runtime === \"cuid\") {\n return createId() as TypeMap[TType];\n }\n if (this.default.runtime === \"now\") {\n return new Date(Date.now()) as TypeMap[TType];\n }\n\n // Custom function\n return this.default.runtime();\n }\n\n /**\n * @description This is used for type inference only. Runtime value will be undefined.\n * @internal\n */\n get $in(): TIn {\n return undefined as unknown as TIn;\n }\n\n /**\n * @description This is used for type inference only. Runtime value will be undefined.\n * @internal\n */\n get $out(): TOut {\n return undefined as unknown as TOut;\n }\n}\n\nexport class IdColumn<\n TType extends IdColumnType = IdColumnType,\n TIn = unknown,\n TOut = unknown,\n> extends Column<TType, TIn, TOut> {\n id = true;\n\n override defaultTo$(\n value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n ) {\n return super.defaultTo$(value) as IdColumn<TType, TIn | null, TOut>;\n }\n\n override defaultTo(\n value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n ) {\n return super.defaultTo(value) as IdColumn<TType, TIn | null, TOut>;\n }\n}\n\n/**\n * Internal ID column - used for database-native joins and foreign keys.\n * Hidden from user API by default.\n */\nexport class InternalIdColumn<TIn = unknown, TOut = unknown> extends Column<\"bigint\", TIn, TOut> {\n override role = \"internal-id\" as const;\n\n constructor() {\n super(\"bigint\");\n this.hidden();\n }\n}\n\n/**\n * Version column - used for optimistic concurrency control.\n * Automatically incremented on each update.\n */\nexport class VersionColumn<TIn = unknown, TOut = unknown> extends Column<\"integer\", TIn, TOut> {\n override role = \"version\" as const;\n\n constructor() {\n super(\"integer\");\n this.defaultTo(0).hidden();\n }\n}\n\nexport function column<TType extends keyof TypeMap>(\n type: TType,\n): Column<TType, TypeMap[TType], TypeMap[TType]> {\n return new Column(type);\n}\n\n/**\n * Create a reference column that points to another table's internal ID.\n * This is used for foreign key relationships.\n * Always uses bigint to match the internal ID type.\n */\nexport function referenceColumn(): Column<\n \"bigint\",\n string | bigint | FragnoId | FragnoReference,\n FragnoReference\n> {\n const col = new Column<\"bigint\", string | bigint | FragnoId | FragnoReference, FragnoReference>(\n \"bigint\",\n );\n col.role = \"reference\";\n return col;\n}\n\n/**\n * Create an external ID column (user-facing).\n * This is a CUID string that can be auto-generated or user-provided.\n * Input accepts string | FragnoId | null, output returns FragnoId.\n */\nexport function idColumn(): IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId> {\n const col = new IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId>(\"varchar(30)\");\n col.role = \"external-id\";\n col.defaultTo$((b) => b.cuid());\n return col;\n}\n\n/**\n * Create an internal ID column (database-native, hidden from user API).\n * Used for joins and foreign keys.\n * @internal\n */\nexport function internalIdColumn(): InternalIdColumn<null, bigint> {\n const col = new InternalIdColumn<null, bigint>();\n col.role = \"internal-id\";\n col.hidden();\n return col;\n}\n\n/**\n * Create a version column for optimistic concurrency control.\n * @internal\n */\nexport function versionColumn(): VersionColumn<null, number> {\n const col = new VersionColumn<null, number>();\n col.role = \"version\";\n col.hidden();\n return col;\n}\n\n/**\n * FragnoId represents a unified ID object that can contain external ID, internal ID, or both.\n * @internal\n *\n * For query inputs: externalId is sufficient (internalId is optional)\n * For query results: both externalId and internalId are provided\n */\nexport class FragnoId {\n readonly #externalId: string;\n readonly #internalId?: bigint;\n readonly #version: number;\n\n constructor({\n externalId,\n internalId,\n version,\n }: {\n externalId: string;\n internalId?: bigint;\n version: number;\n }) {\n this.#externalId = externalId;\n this.#internalId = internalId;\n this.#version = version;\n }\n\n /**\n * Create a FragnoId from just an external ID (for inputs)\n */\n static fromExternal(externalId: string, version: number): FragnoId {\n return new FragnoId({ externalId, version });\n }\n\n get version(): number {\n return this.#version;\n }\n\n get externalId(): string {\n return this.#externalId;\n }\n\n get internalId(): bigint | undefined {\n return this.#internalId;\n }\n\n /**\n * Get the appropriate ID for database operations\n * Prefers internal ID if available, falls back to external ID\n */\n get databaseId(): string | bigint {\n return this.#internalId ?? this.#externalId;\n }\n\n /**\n * Convert to a plain object for serialization\n */\n toJSON(): { externalId: string; internalId?: string } {\n return {\n externalId: this.#externalId,\n internalId: this.#internalId?.toString(),\n };\n }\n\n toString(): string {\n return this.#externalId;\n }\n\n valueOf(): string {\n return this.#externalId;\n }\n}\n\n/**\n * FragnoReference represents a foreign key reference to another table's internal ID.\n * Unlike FragnoId, it only contains the internal ID (bigint) of the referenced record.\n * This is used for reference columns in query results.\n * @internal\n */\nexport class FragnoReference {\n readonly #internalId: bigint;\n\n constructor(internalId: bigint) {\n this.#internalId = internalId;\n }\n\n /**\n * Create a FragnoReference from an internal ID\n */\n static fromInternal(internalId: bigint): FragnoReference {\n return new FragnoReference(internalId);\n }\n\n /**\n * Get the internal ID for database operations\n */\n get internalId(): bigint {\n return this.#internalId;\n }\n}\n\ntype RelationType = \"one\" | \"many\";\n\nexport class TableBuilder<\n TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n #name: string;\n #columns: TColumns;\n #relations: TRelations;\n #indexes: TIndexes;\n #ormName: string = \"\";\n #columnOrder: string[] = [];\n\n constructor(name: string) {\n this.#name = name;\n this.#columns = {} as TColumns;\n this.#relations = {} as TRelations;\n this.#indexes = {} as TIndexes;\n }\n\n // For alterTable to set existing state\n setColumns(columns: TColumns): void {\n this.#columns = { ...columns };\n }\n\n setRelations(relations: TRelations): void {\n this.#relations = { ...relations };\n }\n\n setIndexes(indexes: TIndexes): void {\n this.#indexes = { ...indexes };\n }\n\n // For SchemaBuilder to read collected indexes\n getIndexes(): Index[] {\n return Object.values(this.#indexes) as Index[];\n }\n\n getColumnOrder(): string[] {\n return this.#columnOrder;\n }\n\n /**\n * Add a column to the table.\n */\n addColumn<TColumnName extends string, TColumn extends AnyColumn>(\n ormName: TColumnName,\n col: TColumn,\n ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes>;\n\n /**\n * Add a column to the table with simplified syntax.\n */\n addColumn<TColumnName extends string, TType extends keyof TypeMap>(\n ormName: TColumnName,\n type: TType,\n ): TableBuilder<\n TColumns & Record<TColumnName, Column<TType, TypeMap[TType], TypeMap[TType]>>,\n TRelations,\n TIndexes\n >;\n\n addColumn<TColumnName extends string, TColumn extends AnyColumn, TType extends keyof TypeMap>(\n ormName: TColumnName,\n colOrType: TColumn | TType,\n ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes> {\n // Create the column if a type string was provided\n const col = typeof colOrType === \"string\" ? column(colOrType) : colOrType;\n\n // Set column metadata\n col.ormName = ormName;\n col.name = ormName;\n\n // Add column directly to this builder\n this.#columns[ormName] = col as unknown as TColumns[TColumnName];\n this.#columnOrder.push(ormName);\n\n return this as unknown as TableBuilder<\n TColumns & Record<TColumnName, TColumn>,\n TRelations,\n TIndexes\n >;\n }\n\n /**\n * Create an index on the specified columns.\n */\n createIndex<\n TIndexName extends string,\n const TColumnNames extends readonly (string & keyof TColumns)[],\n >(\n name: TIndexName,\n columns: TColumnNames,\n options?: { unique?: boolean },\n ): TableBuilder<\n TColumns,\n TRelations,\n TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n > {\n const cols = columns.map((colName) => {\n const column = this.#columns[colName];\n if (!column) {\n throw new Error(`Unknown column name ${colName}`);\n }\n return column;\n });\n\n const unique = options?.unique ?? false;\n // Safe: we're adding the index to the internal indexes object\n this.#indexes[name] = {\n name,\n columns: cols,\n columnNames: columns,\n unique,\n } as unknown as TIndexes[TIndexName];\n\n return this as unknown as TableBuilder<\n TColumns,\n TRelations,\n TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n >;\n }\n\n /**\n * Build the final table. This should be called after all columns are added.\n */\n build(): Table<TColumns, TRelations, TIndexes> {\n let idCol: AnyColumn | undefined;\n let internalIdCol: AnyColumn | undefined;\n let versionCol: AnyColumn | undefined;\n\n // TODO: Throw if user manually added version/internalId columns\n\n // Auto-add _internalId and _version columns if not already present\n if (!this.#columns[\"_internalId\"]) {\n const col = internalIdColumn();\n col.ormName = \"_internalId\";\n col.name = \"_internalId\";\n // Safe: we're adding system columns to the internal columns object\n (this.#columns as Record<string, AnyColumn>)[\"_internalId\"] = col;\n }\n\n if (!this.#columns[\"_version\"]) {\n const col = versionColumn();\n col.ormName = \"_version\";\n col.name = \"_version\";\n // Safe: we're adding system columns to the internal columns object\n (this.#columns as Record<string, AnyColumn>)[\"_version\"] = col;\n }\n\n // Use name as ormName if ormName is not set\n const ormName = this.#ormName || this.#name;\n\n const table: Table<TColumns, TRelations, TIndexes> = {\n name: this.#name,\n ormName,\n columns: this.#columns,\n relations: this.#relations,\n indexes: this.#indexes,\n getColumnByName: (name) => {\n return Object.values(this.#columns).find((c) => c.name === name);\n },\n getIdColumn: () => {\n return idCol!;\n },\n getInternalIdColumn: () => {\n return internalIdCol!;\n },\n getVersionColumn: () => {\n return versionCol!;\n },\n };\n\n // Set table reference and find special columns\n for (const k in this.#columns) {\n const column = this.#columns[k];\n if (!column) {\n continue;\n }\n\n column.tableName = table.name;\n if (column instanceof IdColumn || column.role === \"external-id\") {\n idCol = column;\n }\n if (column instanceof InternalIdColumn || column.role === \"internal-id\") {\n internalIdCol = column;\n }\n if (column instanceof VersionColumn || column.role === \"version\") {\n versionCol = column;\n }\n }\n\n if (idCol === undefined) {\n throw new Error(`there's no id column in your table ${this.#name}`);\n }\n if (internalIdCol === undefined) {\n throw new Error(`there's no internal id column in your table ${this.#name}`);\n }\n if (versionCol === undefined) {\n throw new Error(`there's no version column in your table ${this.#name}`);\n }\n\n return table;\n }\n}\n\nexport interface Schema<TTables extends Record<string, AnyTable> = Record<string, AnyTable>> {\n /**\n * @description The version of the schema, automatically incremented on each change.\n */\n version: number;\n tables: TTables;\n /**\n * @description Operations performed on this schema, in order.\n * Used to generate migrations for specific version ranges.\n */\n operations: SchemaOperation[];\n\n clone: () => Schema<TTables>;\n}\n\n/**\n * Utility type for updating a single table's relations in a schema.\n * Used to properly type the return value of addReference.\n */\ntype UpdateTableRelations<\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n TReferenceName extends string,\n TReferencedTableName extends keyof TTables,\n TRelationType extends RelationType = RelationType,\n> = {\n [K in keyof TTables]: K extends TTableName\n ? Table<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"] &\n Record<TReferenceName, Relation<TRelationType, TTables[TReferencedTableName]>>,\n TTables[TTableName][\"indexes\"]\n >\n : TTables[K];\n};\n\n/**\n * Utility type for updating a single table in a schema.\n * Used to properly type the return value of alterTable.\n */\ntype UpdateTable<\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n TNewColumns extends Record<string, AnyColumn>,\n TNewRelations extends Record<string, AnyRelation>,\n TNewIndexes extends Record<string, Index>,\n> = {\n [K in keyof TTables]: K extends TTableName\n ? Table<TNewColumns, TNewRelations, TNewIndexes>\n : TTables[K];\n};\n\n/**\n * Map an array of column names to a tuple of their actual column types\n */\ntype ColumnsToTuple<\n TColumns extends Record<string, AnyColumn>,\n TColumnNames extends readonly (keyof TColumns)[],\n> = {\n [K in keyof TColumnNames]: TColumnNames[K] extends keyof TColumns\n ? TColumns[TColumnNames[K]]\n : never;\n} & AnyColumn[];\n\nexport class SchemaBuilder<TTables extends Record<string, AnyTable> = {}> {\n #tables: TTables;\n #version: number = 0;\n #operations: SchemaOperation[] = [];\n\n constructor(existingSchema?: Schema<TTables>) {\n if (existingSchema) {\n this.#tables = existingSchema.tables;\n this.#version = existingSchema.version;\n this.#operations = [...existingSchema.operations];\n } else {\n this.#tables = {} as TTables;\n }\n }\n\n /**\n * Add an existing schema to this builder.\n * Merges tables and operations from the provided schema.\n *\n * @example\n * ```ts\n * const builder = new SchemaBuilder()\n * .add(userSchema)\n * .add(postSchema)\n * .addTable(\"comments\", ...);\n * ```\n */\n mergeWithExistingSchema<TNewTables extends Record<string, AnyTable>>(\n schema: Schema<TNewTables>,\n ): SchemaBuilder<TTables & TNewTables> {\n this.#tables = { ...this.#tables, ...schema.tables } as TTables & TNewTables;\n this.#operations = [...this.#operations, ...schema.operations];\n this.#version += schema.version;\n\n return this as unknown as SchemaBuilder<TTables & TNewTables>;\n }\n\n /**\n * Add a table to the schema. Increments the version counter.\n */\n addTable<\n TTableName extends string,\n TColumns extends Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n >(\n ormName: TTableName,\n callback: (\n builder: TableBuilder<\n Record<string, AnyColumn>,\n Record<string, AnyRelation>,\n Record<string, Index>\n >,\n ) => TableBuilder<TColumns, TRelations, TIndexes>,\n ): SchemaBuilder<TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>> {\n this.#version++;\n\n const tableBuilder = new TableBuilder(ormName);\n const result = callback(tableBuilder);\n const builtTable = result.build();\n builtTable.ormName = ormName;\n\n // Collect sub-operations in order\n const subOperations: TableSubOperation[] = [];\n\n // Add user-defined columns first\n const columnOrder = result.getColumnOrder();\n for (const colName of columnOrder) {\n const col = builtTable.columns[colName];\n subOperations.push({\n type: \"add-column\",\n columnName: colName,\n column: col,\n });\n }\n\n // Add system columns (_internalId and _version) that were auto-added\n if (builtTable.columns[\"_internalId\"]) {\n subOperations.push({\n type: \"add-column\",\n columnName: \"_internalId\",\n column: builtTable.columns[\"_internalId\"],\n });\n }\n if (builtTable.columns[\"_version\"]) {\n subOperations.push({\n type: \"add-column\",\n columnName: \"_version\",\n column: builtTable.columns[\"_version\"],\n });\n }\n\n // Add indexes from builder\n for (const idx of result.getIndexes()) {\n subOperations.push({\n type: \"add-index\",\n name: idx.name,\n columns: idx.columns.map((c) => c.ormName),\n unique: idx.unique,\n });\n }\n\n // Add the add-table operation\n this.#operations.push({\n type: \"add-table\",\n tableName: ormName,\n operations: subOperations,\n });\n\n // Update tables map\n this.#tables = { ...this.#tables, [ormName]: builtTable } as TTables &\n Record<TTableName, Table<TColumns, TRelations, TIndexes>>;\n\n return this as unknown as SchemaBuilder<\n TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>\n >;\n }\n\n /**\n * Add a relation between two tables.\n *\n * @param referenceName - A name for this relation (e.g., \"author\", \"posts\")\n * @param config - Configuration specifying the relation type and foreign key mapping\n *\n * @example\n * ```ts\n * // One-to-one or many-to-one: post -> user\n * schema(s => s\n * .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))\n * .addTable(\"posts\", t => t\n * .addColumn(\"id\", idColumn())\n * .addColumn(\"userId\", referenceColumn()))\n * .addReference(\"author\", {\n * type: \"one\",\n * from: { table: \"posts\", column: \"userId\" },\n * to: { table: \"users\", column: \"id\" },\n * })\n * )\n *\n * // One-to-many (inverse relation): user -> posts\n * .addReference(\"posts\", {\n * type: \"many\",\n * from: { table: \"users\", column: \"id\" },\n * to: { table: \"posts\", column: \"userId\" },\n * })\n *\n * // Self-referencing foreign key\n * .addReference(\"inviter\", {\n * type: \"one\",\n * from: { table: \"users\", column: \"invitedBy\" },\n * to: { table: \"users\", column: \"id\" },\n * })\n * ```\n */\n addReference<\n TFromTableName extends string & keyof TTables,\n TToTableName extends string & keyof TTables,\n TReferenceName extends string,\n TRelationType extends RelationType,\n >(\n referenceName: TReferenceName,\n config: {\n type: TRelationType;\n from: {\n table: TFromTableName;\n column: keyof TTables[TFromTableName][\"columns\"];\n };\n to: {\n table: TToTableName;\n column: keyof TTables[TToTableName][\"columns\"];\n };\n },\n ): SchemaBuilder<\n UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n > {\n this.#version++;\n\n const table = this.#tables[config.from.table];\n const referencedTable = this.#tables[config.to.table];\n\n if (!table) {\n throw new Error(`Table ${config.from.table} not found in schema`);\n }\n if (!referencedTable) {\n throw new Error(`Referenced table ${config.to.table} not found in schema`);\n }\n\n const columnName = config.from.column as string;\n const targetColumnName = config.to.column as string;\n\n // Foreign keys always reference internal IDs, not external IDs\n // If user specifies \"id\", translate to \"_internalId\" for the actual FK\n const actualTargetColumnName = targetColumnName === \"id\" ? \"_internalId\" : targetColumnName;\n\n const column = table.columns[columnName];\n const referencedColumn = referencedTable.columns[actualTargetColumnName];\n\n if (!column) {\n throw new Error(`Column ${columnName} not found in table ${config.from.table}`);\n }\n if (!referencedColumn) {\n throw new Error(`Column ${actualTargetColumnName} not found in table ${config.to.table}`);\n }\n\n // Verify that reference columns are bigint (matching internal ID type)\n if (column.role === \"reference\" && column.type !== \"bigint\") {\n throw new Error(\n `Reference column ${columnName} must be of type bigint to match internal ID type`,\n );\n }\n\n // Create the relation (use the user-facing column name for the relation)\n const init = new ExplicitRelationInit(config.type, referencedTable, table);\n init.on.push([columnName, targetColumnName]);\n const relation = init.init(referenceName);\n\n // Add relation to the table\n table.relations[referenceName] = relation;\n\n // Record the operation\n this.#operations.push({\n type: \"add-reference\",\n tableName: config.from.table,\n referenceName,\n config: {\n type: config.type,\n from: { table: config.from.table, column: columnName },\n to: { table: config.to.table, column: actualTargetColumnName },\n },\n });\n\n // Return this with updated type\n // Safe: The relation was added to the table in place and now has the updated relations\n return this as unknown as SchemaBuilder<\n UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n >;\n }\n\n /**\n * Alter an existing table by adding columns or indexes.\n * This is used for append-only schema modifications.\n *\n * @param tableName - The name of the table to modify\n * @param callback - A callback that receives a table builder for adding columns/indexes\n *\n * @example\n * ```ts\n * // Add a new column to an existing table\n * schema(s => s\n * .addTable(\"users\", t => t\n * .addColumn(\"id\", idColumn())\n * .addColumn(\"name\", column(\"string\")))\n * .alterTable(\"users\", t => t\n * .addColumn(\"email\", column(\"string\"))\n * .addColumn(\"age\", column(\"integer\").nullable())\n * .createIndex(\"idx_email\", [\"email\"]))\n * )\n * ```\n */\n alterTable<\n TTableName extends string & keyof TTables,\n TNewColumns extends Record<string, AnyColumn>,\n TNewRelations extends Record<string, AnyRelation>,\n TNewIndexes extends Record<string, Index> = Record<string, Index>,\n >(\n tableName: TTableName,\n callback: (\n builder: TableBuilder<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"],\n Record<string, Index>\n >,\n ) => TableBuilder<TNewColumns, TNewRelations, TNewIndexes>,\n ): SchemaBuilder<UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>> {\n const table = this.#tables[tableName];\n\n if (!table) {\n throw new Error(`Table ${tableName} not found in schema`);\n }\n\n // Create builder with existing table state\n const tableBuilder = new TableBuilder(tableName);\n tableBuilder.setColumns(table.columns);\n tableBuilder.setRelations(table.relations);\n tableBuilder.setIndexes(table.indexes);\n\n // Track existing columns and indexes\n const existingColumns = new Set(Object.keys(table.columns));\n const existingIndexes = new Set(Object.keys(table.indexes));\n\n // Apply modifications\n const resultBuilder = callback(\n tableBuilder as TableBuilder<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"],\n Record<string, Index>\n >,\n );\n const newTable = resultBuilder.build();\n\n // Collect sub-operations\n const subOperations: TableSubOperation[] = [];\n\n // Find new columns (preserve order from builder)\n const columnOrder = resultBuilder.getColumnOrder();\n for (const colName of columnOrder) {\n if (!existingColumns.has(colName)) {\n subOperations.push({\n type: \"add-column\",\n columnName: colName,\n column: newTable.columns[colName],\n });\n }\n }\n\n // Add only new indexes\n for (const idx of resultBuilder.getIndexes()) {\n if (!existingIndexes.has(idx.name)) {\n subOperations.push({\n type: \"add-index\",\n name: idx.name,\n columns: idx.columns.map((c) => c.ormName),\n unique: idx.unique,\n });\n }\n }\n\n if (subOperations.length > 0) {\n this.#version++;\n this.#operations.push({\n type: \"alter-table\",\n tableName,\n operations: subOperations,\n });\n }\n\n // Update table reference in schema\n this.#tables[tableName] = newTable as unknown as TTables[TTableName];\n\n // Set table name for all columns\n for (const col of Object.values(newTable.columns)) {\n col.tableName = newTable.name;\n }\n\n return this as unknown as SchemaBuilder<\n UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>\n >;\n }\n\n /**\n * Build the final schema. This should be called after all tables are added.\n */\n build(): Schema<TTables> {\n const operations = this.#operations;\n const version = this.#version;\n const tables = this.#tables;\n\n const schema: Schema<TTables> = {\n version,\n tables,\n operations,\n clone: () => {\n const cloneTables: Record<string, AnyTable> = {};\n\n for (const [k, v] of Object.entries(tables)) {\n // Create a new table with cloned columns\n const clonedColumns: Record<string, AnyColumn> = {};\n for (const [colName, col] of Object.entries(v.columns)) {\n // Create a new column with the same properties, preserving the column type\n let clonedCol: AnyColumn;\n if (col instanceof InternalIdColumn) {\n clonedCol = new InternalIdColumn();\n } else if (col instanceof VersionColumn) {\n clonedCol = new VersionColumn();\n } else if (col instanceof IdColumn) {\n clonedCol = new IdColumn(col.type);\n } else {\n clonedCol = new Column(col.type);\n }\n\n clonedCol.name = col.name;\n clonedCol.ormName = col.ormName;\n clonedCol.isNullable = col.isNullable;\n clonedCol.role = col.role;\n clonedCol.isHidden = col.isHidden;\n clonedCol.default = col.default;\n clonedCol.tableName = col.tableName;\n clonedColumns[colName] = clonedCol;\n }\n\n cloneTables[k] = {\n ...v,\n columns: clonedColumns,\n };\n }\n\n return new SchemaBuilder<TTables>({\n version,\n tables: cloneTables as TTables,\n operations: [...operations],\n clone: () => {\n throw new Error(\"Cannot clone during clone\");\n },\n }).build();\n },\n };\n\n return schema;\n }\n\n /**\n * Get the current version of the schema builder.\n */\n getVersion(): number {\n return this.#version;\n }\n}\n\n/**\n * Create a new schema with callback pattern.\n */\nexport function schema<const TTables extends Record<string, AnyTable> = {}>(\n callback: (builder: SchemaBuilder<{}>) => SchemaBuilder<TTables>,\n): Schema<TTables> {\n return callback(new SchemaBuilder()).build();\n}\n\nexport function compileForeignKey(key: ForeignKey, nameType: \"sql\" | \"orm\" = \"orm\") {\n return {\n name: key.name,\n table: nameType === \"sql\" ? key.table.name : key.table.ormName,\n referencedTable: nameType === \"sql\" ? key.referencedTable.name : key.referencedTable.ormName,\n referencedColumns: key.referencedColumns.map((col) =>\n nameType === \"sql\" ? col.name : col.ormName,\n ),\n columns: key.columns.map((col) => (nameType === \"sql\" ? col.name : col.ormName)),\n };\n}\n"],"mappings":"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"}
1
+ {"version":3,"file":"create.js","names":["defaultBuilder: DefaultBuilder","runtimeDefaultBuilder: RuntimeDefaultBuilder","#externalId","#internalId","#version","#name","#columns","#relations","#indexes","#columnOrder","column","idCol: AnyColumn | undefined","internalIdCol: AnyColumn | undefined","versionCol: AnyColumn | undefined","#tables","#operations","#registerTableName","#registerIndexName","#tableNames","#indexNames","schema","subOperations: TableSubOperation[]","cloneTables: Record<string, AnyTable>","clonedColumns: Record<string, AnyColumn>","clonedCol: AnyColumn","clonedSchema: Schema<TTables>"],"sources":["../../src/schema/create.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport { createId } from \"../id\";\nimport type { DbNow } from \"../query/db-now\";\nimport type { Prettify } from \"../util/types\";\nimport { createTableStandardSchemaProps, createTableValidator } from \"./validator\";\n\nexport { generateId } from \"./generate-id\";\nexport { FragnoDbValidationError } from \"./validator\";\n\nexport type AnySchema = Schema<Record<string, AnyTable>>;\n\nexport type AnyRelation = Relation;\n\nexport type AnyTable = Table;\n\nexport type AnyColumn =\n | Column<keyof TypeMap, unknown, unknown>\n | IdColumn<IdColumnType, unknown, unknown>\n | InternalIdColumn<unknown, unknown>\n | VersionColumn<unknown, unknown>;\n/**\n * Sub-operations that can be performed within table operations.\n * These are stored in order within add-table and alter-table operations.\n */\nexport type TableSubOperation =\n | { type: \"add-column\"; columnName: string; column: AnyColumn }\n | { type: \"add-index\"; name: string; columns: string[]; unique: boolean }\n | {\n type: \"add-foreign-key\";\n name: string;\n columns: string[];\n referencedTable: string;\n referencedColumns: string[];\n };\n\n/**\n * Operations that can be performed on a schema during its definition.\n * These are tracked so we can generate migrations for specific version ranges.\n */\nexport type SchemaOperation =\n | {\n type: \"add-table\";\n tableName: string;\n operations: TableSubOperation[]; // Ordered list of sub-operations\n }\n | {\n type: \"alter-table\";\n tableName: string;\n operations: TableSubOperation[]; // Ordered list of sub-operations\n }\n | {\n type: \"add-reference\";\n tableName: string; // The table that has the foreign key\n referenceName: string;\n config: {\n type: \"one\" | \"many\";\n from: { table: string; column: string };\n to: { table: string; column: string };\n };\n };\n\nexport interface ForeignKey {\n name: string;\n table: AnyTable;\n columns: AnyColumn[];\n\n referencedTable: AnyTable;\n referencedColumns: AnyColumn[];\n}\n\nclass RelationInit<\n TRelationType extends RelationType,\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n> {\n type: TRelationType;\n referencedTable: TTables[TTableName];\n referencer: AnyTable;\n on: [string, string][] = [];\n\n constructor(type: TRelationType, referencedTable: TTables[TTableName], referencer: AnyTable) {\n this.type = type;\n this.referencedTable = referencedTable;\n this.referencer = referencer;\n }\n}\n\nexport interface Index<\n TColumns extends AnyColumn[] = AnyColumn[],\n TColumnNames extends readonly string[] = readonly string[],\n> {\n name: string;\n columns: TColumns;\n columnNames: TColumnNames;\n unique: boolean;\n}\n\nexport class ExplicitRelationInit<\n TRelationType extends RelationType,\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n> extends RelationInit<TRelationType, TTables, TTableName> {\n init(name: string): Relation<TRelationType, TTables[TTableName]> {\n const id = `${this.referencer.name}_${this.referencedTable.name}`;\n\n return {\n id,\n on: this.on,\n name,\n referencer: this.referencer,\n table: this.referencedTable,\n type: this.type,\n };\n }\n}\n\nexport interface Relation<\n TRelationType extends RelationType = RelationType,\n TTable extends AnyTable = AnyTable,\n> {\n id: string;\n name: string;\n type: TRelationType;\n\n table: TTable;\n referencer: AnyTable;\n\n on: [string, string][];\n}\n\ntype PickNullable<T> = {\n [P in keyof T as null extends T[P] ? P : never]: T[P];\n};\n\ntype PickNotNullable<T> = {\n [P in keyof T as null extends T[P] ? never : P]: T[P];\n};\n\ntype RawInsertValuesFromColumns<TColumns extends Record<string, AnyColumn>> = {\n [K in keyof TColumns as string extends K ? never : K]: TColumns[K][\"$in\"];\n};\n\ntype TableInsertValuesFromColumns<TColumns extends Record<string, AnyColumn>> = Prettify<\n Partial<PickNullable<RawInsertValuesFromColumns<TColumns>>> &\n PickNotNullable<RawInsertValuesFromColumns<TColumns>>\n>;\n\nexport type TableInsertValues<T extends AnyTable> = TableInsertValuesFromColumns<T[\"columns\"]>;\n\nexport type TableUnknownKeysMode = \"strip\" | \"strict\";\n\nexport type TableValidationOptions = {\n unknownKeys?: TableUnknownKeysMode;\n};\n\nexport interface Table<\n TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n /**\n * Standard Schema-compatible validator for insert values.\n */\n \"~standard\": StandardSchemaV1.Props<\n TableInsertValuesFromColumns<TColumns>,\n TableInsertValuesFromColumns<TColumns>\n >;\n name: string;\n\n columns: TColumns;\n relations: TRelations;\n indexes: TIndexes;\n\n /**\n * Validate insert values at runtime.\n */\n validate: (\n value: unknown,\n options?: TableValidationOptions,\n ) => TableInsertValuesFromColumns<TColumns>;\n\n /**\n * Get column by name\n */\n getColumnByName: (name: string) => AnyColumn | undefined;\n /**\n * Get the external ID column (user-facing)\n */\n getIdColumn: () => AnyColumn;\n /**\n * Get the internal ID column (database-native, used for joins)\n */\n getInternalIdColumn: () => AnyColumn;\n /**\n * Get the version column (for optimistic concurrency control)\n */\n getVersionColumn: () => AnyColumn;\n}\n\ntype DBSpecial = { tag: \"special\"; value: \"now\" };\ntype RuntimeSpecial = { tag: \"special\"; value: \"cuid\" | \"now\" };\n\n/**\n * Builder for database-level default values.\n */\nexport interface DefaultBuilder {\n /** Database-generated timestamp (DEFAULT NOW()) */\n now(): DBSpecial;\n}\n\n/**\n * Builder for runtime-generated default values.\n */\nexport interface RuntimeDefaultBuilder {\n /** Generate CUID identifier */\n cuid(): RuntimeSpecial;\n /** Generate current timestamp */\n now(): RuntimeSpecial;\n}\n\nconst defaultBuilder: DefaultBuilder = {\n now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\nconst runtimeDefaultBuilder: RuntimeDefaultBuilder = {\n cuid: () => ({ tag: \"special\", value: \"cuid\" }),\n now: () => ({ tag: \"special\", value: \"now\" }),\n};\n\ntype IdColumnType = `varchar(${number})`;\n\nexport type TypeMap = {\n string: string;\n bigint: bigint;\n integer: number;\n decimal: number;\n bool: boolean;\n json: unknown;\n /**\n * this follows the same specs as Prisma `Bytes` for consistency.\n */\n binary: Uint8Array;\n date: Date;\n timestamp: Date;\n} & Record<`varchar(${number})`, string>;\n\nexport class Column<TType extends keyof TypeMap, TIn = unknown, TOut = unknown> {\n type: TType;\n name: string = \"\";\n isNullable: boolean = false;\n role: \"external-id\" | \"internal-id\" | \"version\" | \"reference\" | \"regular\" = \"regular\";\n isHidden: boolean = false;\n\n default?:\n | { value: TypeMap[TType] }\n | { dbSpecial: \"now\" }\n | { runtime: \"cuid\" | \"now\" | (() => TypeMap[TType]) };\n\n tableName: string = \"\";\n\n constructor(type: TType) {\n this.type = type;\n }\n\n nullable<TNullable extends boolean = true>(nullable?: TNullable) {\n this.isNullable = nullable ?? true;\n\n return this as Column<\n TType,\n TNullable extends true ? TIn | null : Exclude<TIn, null>,\n TNullable extends true ? TOut | null : Exclude<TOut, null>\n >;\n }\n\n hidden<THidden extends boolean = true>(hidden?: THidden) {\n this.isHidden = hidden ?? true;\n return this as Column<TType, null, null>;\n }\n\n /**\n * Generate default value at runtime in application code (not in the database).\n *\n * Use this when you need values generated in your application code, either because:\n * - Your database doesn't support the operation (e.g., generating CUIDs)\n * - You want consistent behavior across all databases\n * - You need custom generation logic\n *\n * @param value - Either a literal value or builder callback:\n * - Literal: Any static value of the column type\n * - `(b) => b.cuid()` - Generate a CUID identifier\n * - `(b) => b.now()` - Generate current timestamp\n * - `(b) => ...` - Custom function that returns the default value\n *\n * @example\n * ```ts\n * column(\"string\").defaultTo$((b) => b.cuid()) // Generate CUID at runtime\n * column(\"timestamp\").defaultTo$((b) => b.now()) // Generate timestamp at runtime\n * column(\"integer\").defaultTo$(42) // Static literal\n * column(\"integer\").defaultTo$((b) => Math.floor(Math.random() * 100)) // Custom function\n * ```\n */\n defaultTo$(\n value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n ): Column<TType, TIn | null, TOut> {\n if (typeof value === \"function\") {\n const fn = value as (builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType];\n const result = fn(runtimeDefaultBuilder);\n if (\n typeof result === \"object\" &&\n result !== null &&\n \"tag\" in result &&\n result.tag === \"special\"\n ) {\n this.default = { runtime: result.value };\n } else {\n // Custom function - we need to wrap the callback to call it again later\n this.default = { runtime: () => fn(runtimeDefaultBuilder) as TypeMap[TType] };\n }\n } else {\n // Direct literal value - wrap it in a function for runtime generation\n this.default = { runtime: () => value };\n }\n return this;\n }\n\n /**\n * Set a database-level default value (generated by the database, not application code).\n *\n * The database will generate the default value when inserting rows. If the database\n * doesn't support the operation, Fragno will fall back to generating the value in\n * application code.\n *\n * @param value - Either a literal value or builder callback:\n * - Literal: Any static value of the column type\n * - `(b) => b.now()` - Database-generated timestamp\n *\n * @example\n * ```ts\n * // Static defaults\n * column(\"string\").defaultTo(\"active\")\n * column(\"integer\").defaultTo(0)\n * column(\"boolean\").defaultTo(true)\n *\n * // Database-generated timestamp (with fallback)\n * column(\"timestamp\").defaultTo((b) => b.now())\n * ```\n */\n defaultTo(\n value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n ): Column<TType, TIn | null, TOut> {\n if (typeof value === \"function\") {\n const fn = value as (builder: DefaultBuilder) => DBSpecial | TypeMap[TType];\n const result = fn(defaultBuilder);\n if (\n typeof result === \"object\" &&\n result !== null &&\n \"tag\" in result &&\n result.tag === \"special\"\n ) {\n this.default = { dbSpecial: result.value };\n } else {\n this.default = { value: result as TypeMap[TType] };\n }\n } else {\n this.default = { value };\n }\n return this;\n }\n\n /**\n * Generate default value for the column at runtime.\n * Used for both runtime defaults (defaultTo$) and fallback generation for\n * database defaults (defaultTo) when the database doesn't support them.\n */\n generateDefaultValue(): TypeMap[TType] | undefined {\n if (!this.default) {\n return;\n }\n\n if (\"value\" in this.default) {\n return this.default.value;\n }\n\n if (\"dbSpecial\" in this.default) {\n // Fallback generation for database-level special functions\n if (this.default.dbSpecial === \"now\") {\n return new Date(Date.now()) as TypeMap[TType];\n }\n return;\n }\n\n // Runtime defaults (defaultTo$)\n if (this.default.runtime === \"cuid\") {\n return createId() as TypeMap[TType];\n }\n if (this.default.runtime === \"now\") {\n return new Date(Date.now()) as TypeMap[TType];\n }\n\n // Custom function\n return this.default.runtime();\n }\n\n /**\n * @description This is used for type inference only. Runtime value will be undefined.\n * @internal\n */\n get $in(): TIn {\n return undefined as unknown as TIn;\n }\n\n /**\n * @description This is used for type inference only. Runtime value will be undefined.\n * @internal\n */\n get $out(): TOut {\n return undefined as unknown as TOut;\n }\n}\n\nexport class IdColumn<\n TType extends IdColumnType = IdColumnType,\n TIn = unknown,\n TOut = unknown,\n> extends Column<TType, TIn, TOut> {\n id = true;\n\n override defaultTo$(\n value: TypeMap[TType] | ((builder: RuntimeDefaultBuilder) => RuntimeSpecial | TypeMap[TType]),\n ) {\n return super.defaultTo$(value) as IdColumn<TType, TIn | null, TOut>;\n }\n\n override defaultTo(\n value: TypeMap[TType] | ((builder: DefaultBuilder) => DBSpecial | TypeMap[TType]),\n ) {\n return super.defaultTo(value) as IdColumn<TType, TIn | null, TOut>;\n }\n}\n\n/**\n * Internal ID column - used for database-native joins and foreign keys.\n * Hidden from user API by default.\n */\nexport class InternalIdColumn<TIn = unknown, TOut = unknown> extends Column<\"bigint\", TIn, TOut> {\n override role = \"internal-id\" as const;\n\n constructor() {\n super(\"bigint\");\n this.hidden();\n }\n}\n\n/**\n * Version column - used for optimistic concurrency control.\n * Automatically incremented on each update.\n */\nexport class VersionColumn<TIn = unknown, TOut = unknown> extends Column<\"integer\", TIn, TOut> {\n override role = \"version\" as const;\n\n constructor() {\n super(\"integer\");\n this.defaultTo(0).hidden();\n }\n}\n\ntype ColumnInput<TType extends keyof TypeMap> =\n | TypeMap[TType]\n | (TType extends \"timestamp\" | \"date\" ? DbNow : never);\n\nexport function column<TType extends keyof TypeMap>(\n type: TType,\n): Column<TType, ColumnInput<TType>, TypeMap[TType]> {\n return new Column(type);\n}\n\n/**\n * Create a reference column that points to another table's internal ID.\n * This is used for foreign key relationships.\n * Always uses bigint to match the internal ID type.\n */\nexport function referenceColumn(): Column<\n \"bigint\",\n string | bigint | FragnoId | FragnoReference,\n FragnoReference\n> {\n const col = new Column<\"bigint\", string | bigint | FragnoId | FragnoReference, FragnoReference>(\n \"bigint\",\n );\n col.role = \"reference\";\n return col;\n}\n\n/**\n * Create an external ID column (user-facing).\n * This is a CUID string that can be auto-generated or user-provided.\n * Input accepts string | FragnoId | null, output returns FragnoId.\n */\nexport function idColumn(): IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId> {\n const col = new IdColumn<\"varchar(30)\", string | FragnoId | null, FragnoId>(\"varchar(30)\");\n col.role = \"external-id\";\n col.defaultTo$((b) => b.cuid());\n return col;\n}\n\n/**\n * Create an internal ID column (database-native, hidden from user API).\n * Used for joins and foreign keys.\n * @internal\n */\nexport function internalIdColumn(): InternalIdColumn<null, bigint> {\n const col = new InternalIdColumn<null, bigint>();\n col.role = \"internal-id\";\n col.hidden();\n return col;\n}\n\n/**\n * Create a version column for optimistic concurrency control.\n * @internal\n */\nexport function versionColumn(): VersionColumn<null, number> {\n const col = new VersionColumn<null, number>();\n col.role = \"version\";\n col.hidden();\n return col;\n}\n\n/**\n * FragnoId represents a unified ID object that can contain external ID, internal ID, or both.\n * @internal\n *\n * For query inputs: externalId is sufficient (internalId is optional)\n * For query results: both externalId and internalId are provided\n */\nexport class FragnoId {\n readonly #externalId: string;\n readonly #internalId?: bigint;\n readonly #version: number;\n\n constructor({\n externalId,\n internalId,\n version,\n }: {\n externalId: string;\n internalId?: bigint;\n version: number;\n }) {\n this.#externalId = externalId;\n this.#internalId = internalId;\n this.#version = version;\n }\n\n /**\n * Create a FragnoId from just an external ID (for inputs)\n */\n static fromExternal(externalId: string, version: number): FragnoId {\n return new FragnoId({ externalId, version });\n }\n\n get version(): number {\n return this.#version;\n }\n\n get externalId(): string {\n return this.#externalId;\n }\n\n get internalId(): bigint | undefined {\n return this.#internalId;\n }\n\n /**\n * Get the appropriate ID for database operations\n * Prefers internal ID if available, falls back to external ID\n */\n get databaseId(): string | bigint {\n return this.#internalId ?? this.#externalId;\n }\n\n /**\n * Convert to a plain object for serialization\n */\n toJSON(): { externalId: string; internalId?: string } {\n return {\n externalId: this.#externalId,\n internalId: this.#internalId?.toString(),\n };\n }\n\n toString(): string {\n return this.#externalId;\n }\n\n valueOf(): string {\n return this.#externalId;\n }\n}\n\n/**\n * FragnoReference represents a foreign key reference to another table's internal ID.\n * Unlike FragnoId, it only contains the internal ID (bigint) of the referenced record.\n * This is used for reference columns in query results.\n * @internal\n */\nexport class FragnoReference {\n readonly #internalId: bigint;\n\n constructor(internalId: bigint) {\n this.#internalId = internalId;\n }\n\n /**\n * Create a FragnoReference from an internal ID\n */\n static fromInternal(internalId: bigint): FragnoReference {\n return new FragnoReference(internalId);\n }\n\n /**\n * Get the internal ID for database operations\n */\n get internalId(): bigint {\n return this.#internalId;\n }\n}\n\nconst validationClasses = { FragnoId, FragnoReference };\n\ntype RelationType = \"one\" | \"many\";\n\nexport class TableBuilder<\n TColumns extends Record<string, AnyColumn> = Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation> = Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n> {\n #name: string;\n #columns: TColumns;\n #relations: TRelations;\n #indexes: TIndexes;\n #columnOrder: string[] = [];\n\n constructor(name: string) {\n this.#name = name;\n this.#columns = {} as TColumns;\n this.#relations = {} as TRelations;\n this.#indexes = {} as TIndexes;\n }\n\n // For alterTable to set existing state\n setColumns(columns: TColumns): void {\n this.#columns = { ...columns };\n }\n\n setRelations(relations: TRelations): void {\n this.#relations = { ...relations };\n }\n\n setIndexes(indexes: TIndexes): void {\n this.#indexes = { ...indexes };\n }\n\n // For SchemaBuilder to read collected indexes\n getIndexes(): Index[] {\n return Object.values(this.#indexes) as Index[];\n }\n\n getColumnOrder(): string[] {\n return this.#columnOrder;\n }\n\n /**\n * Add a column to the table.\n */\n addColumn<TColumnName extends string, TColumn extends AnyColumn>(\n name: TColumnName,\n col: TColumn,\n ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes>;\n\n /**\n * Add a column to the table with simplified syntax.\n */\n addColumn<TColumnName extends string, TType extends keyof TypeMap>(\n name: TColumnName,\n type: TType,\n ): TableBuilder<\n TColumns & Record<TColumnName, Column<TType, ColumnInput<TType>, TypeMap[TType]>>,\n TRelations,\n TIndexes\n >;\n\n addColumn<TColumnName extends string, TColumn extends AnyColumn, TType extends keyof TypeMap>(\n name: TColumnName,\n colOrType: TColumn | TType,\n ): TableBuilder<TColumns & Record<TColumnName, TColumn>, TRelations, TIndexes> {\n // Create the column if a type string was provided\n const col = typeof colOrType === \"string\" ? column(colOrType) : colOrType;\n\n // Set column metadata\n col.name = name;\n\n // Add column directly to this builder\n this.#columns[name] = col as unknown as TColumns[TColumnName];\n this.#columnOrder.push(name);\n\n return this as unknown as TableBuilder<\n TColumns & Record<TColumnName, TColumn>,\n TRelations,\n TIndexes\n >;\n }\n\n /**\n * Create an index on the specified columns.\n */\n createIndex<\n TIndexName extends string,\n const TColumnNames extends readonly (string & keyof TColumns)[],\n >(\n name: TIndexName,\n columns: TColumnNames,\n options?: { unique?: boolean },\n ): TableBuilder<\n TColumns,\n TRelations,\n TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n > {\n const cols = columns.map((colName) => {\n const column = this.#columns[colName];\n if (!column) {\n throw new Error(`Unknown column name ${colName}`);\n }\n return column;\n });\n\n const unique = options?.unique ?? false;\n // Safe: we're adding the index to the internal indexes object\n this.#indexes[name] = {\n name,\n columns: cols,\n columnNames: columns,\n unique,\n } as unknown as TIndexes[TIndexName];\n\n return this as unknown as TableBuilder<\n TColumns,\n TRelations,\n TIndexes & Record<TIndexName, Index<ColumnsToTuple<TColumns, TColumnNames>, TColumnNames>>\n >;\n }\n\n /**\n * Build the final table. This should be called after all columns are added.\n */\n build(): Table<TColumns, TRelations, TIndexes> {\n let idCol: AnyColumn | undefined;\n let internalIdCol: AnyColumn | undefined;\n let versionCol: AnyColumn | undefined;\n\n // TODO: Throw if user manually added version/internalId columns\n\n // Auto-add _internalId and _version columns if not already present\n if (!this.#columns[\"_internalId\"]) {\n const col = internalIdColumn();\n col.name = \"_internalId\";\n // Safe: we're adding system columns to the internal columns object\n (this.#columns as Record<string, AnyColumn>)[\"_internalId\"] = col;\n }\n\n if (!this.#columns[\"_version\"]) {\n const col = versionColumn();\n col.name = \"_version\";\n // Safe: we're adding system columns to the internal columns object\n (this.#columns as Record<string, AnyColumn>)[\"_version\"] = col;\n }\n\n const table = {\n name: this.#name,\n columns: this.#columns,\n relations: this.#relations,\n indexes: this.#indexes,\n getColumnByName: (name) => {\n return Object.values(this.#columns).find((c) => c.name === name);\n },\n getIdColumn: () => {\n return idCol!;\n },\n getInternalIdColumn: () => {\n return internalIdCol!;\n },\n getVersionColumn: () => {\n return versionCol!;\n },\n } as Table<TColumns, TRelations, TIndexes>;\n\n table[\"~standard\"] = createTableStandardSchemaProps(table, validationClasses);\n table.validate = createTableValidator(table, validationClasses);\n\n // Set table reference and find special columns\n for (const k in this.#columns) {\n const column = this.#columns[k];\n if (!column) {\n continue;\n }\n\n column.tableName = table.name;\n if (column instanceof IdColumn || column.role === \"external-id\") {\n idCol = column;\n }\n if (column instanceof InternalIdColumn || column.role === \"internal-id\") {\n internalIdCol = column;\n }\n if (column instanceof VersionColumn || column.role === \"version\") {\n versionCol = column;\n }\n }\n\n if (idCol === undefined) {\n throw new Error(`there's no id column in your table ${this.#name}`);\n }\n if (internalIdCol === undefined) {\n throw new Error(`there's no internal id column in your table ${this.#name}`);\n }\n if (versionCol === undefined) {\n throw new Error(`there's no version column in your table ${this.#name}`);\n }\n\n return table;\n }\n}\n\nexport interface Schema<TTables extends Record<string, AnyTable> = Record<string, AnyTable>> {\n /**\n * @description The name of the schema (required).\n */\n name: string;\n /**\n * @description The version of the schema, automatically incremented on each change.\n */\n version: number;\n tables: TTables;\n /**\n * @description Operations performed on this schema, in order.\n * Used to generate migrations for specific version ranges.\n */\n operations: SchemaOperation[];\n\n clone: () => Schema<TTables>;\n}\n\n/**\n * Utility type for updating a single table's relations in a schema.\n * Used to properly type the return value of addReference.\n */\ntype UpdateTableRelations<\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n TReferenceName extends string,\n TReferencedTableName extends keyof TTables,\n TRelationType extends RelationType = RelationType,\n> = {\n [K in keyof TTables]: K extends TTableName\n ? Table<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"] &\n Record<TReferenceName, Relation<TRelationType, TTables[TReferencedTableName]>>,\n TTables[TTableName][\"indexes\"]\n >\n : TTables[K];\n};\n\n/**\n * Utility type for updating a single table in a schema.\n * Used to properly type the return value of alterTable.\n */\ntype UpdateTable<\n TTables extends Record<string, AnyTable>,\n TTableName extends keyof TTables,\n TNewColumns extends Record<string, AnyColumn>,\n TNewRelations extends Record<string, AnyRelation>,\n TNewIndexes extends Record<string, Index>,\n> = {\n [K in keyof TTables]: K extends TTableName\n ? Table<TNewColumns, TNewRelations, TNewIndexes>\n : TTables[K];\n};\n\n/**\n * Map an array of column names to a tuple of their actual column types\n */\ntype ColumnsToTuple<\n TColumns extends Record<string, AnyColumn>,\n TColumnNames extends readonly (keyof TColumns)[],\n> = {\n [K in keyof TColumnNames]: TColumnNames[K] extends keyof TColumns\n ? TColumns[TColumnNames[K]]\n : never;\n} & AnyColumn[];\n\nexport class SchemaBuilder<TTables extends Record<string, AnyTable> = {}> {\n #name: string;\n #tables: TTables;\n #version: number = 0;\n #operations: SchemaOperation[] = [];\n #tableNames: Set<string> = new Set();\n #indexNames: Set<string> = new Set();\n\n constructor(name: string, existingSchema?: Schema<TTables>) {\n this.#name = name;\n if (existingSchema) {\n this.#tables = existingSchema.tables;\n this.#version = existingSchema.version;\n this.#operations = [...existingSchema.operations];\n } else {\n this.#tables = {} as TTables;\n }\n\n for (const table of Object.values(this.#tables)) {\n this.#registerTableName(table.name);\n for (const index of Object.values(table.indexes)) {\n this.#registerIndexName(index.name, table.name);\n }\n }\n }\n\n #registerTableName(name: string): void {\n if (this.#tableNames.has(name)) {\n throw new Error(`Duplicate table name \"${name}\" in schema \"${this.#name}\".`);\n }\n this.#tableNames.add(name);\n }\n\n #registerIndexName(name: string, tableName: string): void {\n if (this.#indexNames.has(name)) {\n throw new Error(\n `Duplicate index name \"${name}\" in schema \"${this.#name}\". Index names must be unique across tables (conflict on \"${tableName}\").`,\n );\n }\n this.#indexNames.add(name);\n }\n\n /**\n * Add an existing schema to this builder.\n * Merges tables and operations from the provided schema.\n *\n * @example\n * ```ts\n * const builder = new SchemaBuilder(\"combined\")\n * .add(userSchema)\n * .add(postSchema)\n * .addTable(\"comments\", ...);\n * ```\n */\n mergeWithExistingSchema<TNewTables extends Record<string, AnyTable>>(\n schema: Schema<TNewTables>,\n ): SchemaBuilder<TTables & TNewTables> {\n for (const table of Object.values(schema.tables)) {\n if (this.#tableNames.has(table.name)) {\n throw new Error(\n `Duplicate table name \"${table.name}\" in schema \"${this.#name}\" when merging.`,\n );\n }\n for (const index of Object.values(table.indexes)) {\n if (this.#indexNames.has(index.name)) {\n throw new Error(\n `Duplicate index name \"${index.name}\" in schema \"${this.#name}\" when merging (conflict on \"${table.name}\").`,\n );\n }\n }\n }\n\n this.#tables = { ...this.#tables, ...schema.tables } as TTables & TNewTables;\n this.#operations = [...this.#operations, ...schema.operations];\n this.#version += schema.version;\n\n for (const table of Object.values(schema.tables)) {\n this.#tableNames.add(table.name);\n for (const index of Object.values(table.indexes)) {\n this.#indexNames.add(index.name);\n }\n }\n\n return this as unknown as SchemaBuilder<TTables & TNewTables>;\n }\n\n /**\n * Add a table to the schema. Increments the version counter.\n */\n addTable<\n TTableName extends string,\n TColumns extends Record<string, AnyColumn>,\n TRelations extends Record<string, AnyRelation>,\n TIndexes extends Record<string, Index> = Record<string, Index>,\n >(\n name: TTableName,\n callback: (\n builder: TableBuilder<\n Record<string, AnyColumn>,\n Record<string, AnyRelation>,\n Record<string, Index>\n >,\n ) => TableBuilder<TColumns, TRelations, TIndexes>,\n ): SchemaBuilder<TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>> {\n this.#version++;\n\n if (this.#tableNames.has(name)) {\n throw new Error(`Duplicate table name \"${name}\" in schema \"${this.#name}\".`);\n }\n\n const tableBuilder = new TableBuilder(name);\n const result = callback(tableBuilder);\n const builtTable = result.build();\n const indexNames = result.getIndexes().map((idx) => idx.name);\n\n for (const indexName of indexNames) {\n if (this.#indexNames.has(indexName)) {\n throw new Error(\n `Duplicate index name \"${indexName}\" in schema \"${this.#name}\". Index names must be unique across tables (conflict on \"${name}\").`,\n );\n }\n }\n\n // Collect sub-operations in order\n const subOperations: TableSubOperation[] = [];\n\n // Add user-defined columns first\n const columnOrder = result.getColumnOrder();\n for (const colName of columnOrder) {\n const col = builtTable.columns[colName];\n subOperations.push({\n type: \"add-column\",\n columnName: colName,\n column: col,\n });\n }\n\n // Add system columns (_internalId and _version) that were auto-added\n if (builtTable.columns[\"_internalId\"]) {\n subOperations.push({\n type: \"add-column\",\n columnName: \"_internalId\",\n column: builtTable.columns[\"_internalId\"],\n });\n }\n if (builtTable.columns[\"_version\"]) {\n subOperations.push({\n type: \"add-column\",\n columnName: \"_version\",\n column: builtTable.columns[\"_version\"],\n });\n }\n\n // Add indexes from builder\n for (const idx of result.getIndexes()) {\n subOperations.push({\n type: \"add-index\",\n name: idx.name,\n columns: idx.columns.map((c) => c.name),\n unique: idx.unique,\n });\n }\n\n // Add the add-table operation\n this.#operations.push({\n type: \"add-table\",\n tableName: name,\n operations: subOperations,\n });\n\n // Update tables map\n this.#tables = { ...this.#tables, [name]: builtTable } as TTables &\n Record<TTableName, Table<TColumns, TRelations, TIndexes>>;\n this.#tableNames.add(name);\n for (const indexName of indexNames) {\n this.#indexNames.add(indexName);\n }\n\n return this as unknown as SchemaBuilder<\n TTables & Record<TTableName, Table<TColumns, TRelations, TIndexes>>\n >;\n }\n\n /**\n * Add a relation between two tables.\n *\n * @param referenceName - A name for this relation (e.g., \"author\", \"posts\")\n * @param config - Configuration specifying the relation type and foreign key mapping\n *\n * @example\n * ```ts\n * // One-to-one or many-to-one: post -> user\n * schema(\"blog\", s => s\n * .addTable(\"users\", t => t.addColumn(\"id\", idColumn()))\n * .addTable(\"posts\", t => t\n * .addColumn(\"id\", idColumn())\n * .addColumn(\"userId\", referenceColumn()))\n * .addReference(\"author\", {\n * type: \"one\",\n * from: { table: \"posts\", column: \"userId\" },\n * to: { table: \"users\", column: \"id\" },\n * })\n * )\n *\n * // One-to-many (inverse relation): user -> posts\n * .addReference(\"posts\", {\n * type: \"many\",\n * from: { table: \"users\", column: \"id\" },\n * to: { table: \"posts\", column: \"userId\" },\n * })\n *\n * // Self-referencing foreign key\n * .addReference(\"inviter\", {\n * type: \"one\",\n * from: { table: \"users\", column: \"invitedBy\" },\n * to: { table: \"users\", column: \"id\" },\n * })\n * ```\n */\n addReference<\n TFromTableName extends string & keyof TTables,\n TToTableName extends string & keyof TTables,\n TReferenceName extends string,\n TRelationType extends RelationType,\n >(\n referenceName: TReferenceName,\n config: {\n type: TRelationType;\n from: {\n table: TFromTableName;\n column: keyof TTables[TFromTableName][\"columns\"];\n };\n to: {\n table: TToTableName;\n column: keyof TTables[TToTableName][\"columns\"];\n };\n },\n ): SchemaBuilder<\n UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n > {\n this.#version++;\n\n const table = this.#tables[config.from.table];\n const referencedTable = this.#tables[config.to.table];\n\n if (!referenceName || referenceName.trim().length === 0) {\n throw new Error(`referenceName is required for addReference on ${config.from.table}`);\n }\n\n if (!table) {\n throw new Error(`Table ${config.from.table} not found in schema`);\n }\n if (!referencedTable) {\n throw new Error(`Referenced table ${config.to.table} not found in schema`);\n }\n\n const columnName = config.from.column as string;\n const targetColumnName = config.to.column as string;\n\n // Foreign keys always reference internal IDs, not external IDs\n // If user specifies \"id\", translate to \"_internalId\" for the actual FK\n const actualTargetColumnName = targetColumnName === \"id\" ? \"_internalId\" : targetColumnName;\n\n const column = table.columns[columnName];\n const referencedColumn = referencedTable.columns[actualTargetColumnName];\n\n if (!column) {\n throw new Error(`Column ${columnName} not found in table ${config.from.table}`);\n }\n if (!referencedColumn) {\n throw new Error(`Column ${actualTargetColumnName} not found in table ${config.to.table}`);\n }\n\n if (table.relations[referenceName]) {\n throw new Error(`Reference ${referenceName} already exists on table ${config.from.table}`);\n }\n\n // Verify that reference columns are bigint (matching internal ID type)\n if (column.role === \"reference\" && column.type !== \"bigint\") {\n throw new Error(\n `Reference column ${columnName} must be of type bigint to match internal ID type`,\n );\n }\n\n // Create the relation (use the user-facing column name for the relation)\n const init = new ExplicitRelationInit(config.type, referencedTable, table);\n init.on.push([columnName, targetColumnName]);\n const relation = init.init(referenceName);\n\n // Add relation to the table\n table.relations[referenceName] = relation;\n\n // Record the operation\n this.#operations.push({\n type: \"add-reference\",\n tableName: config.from.table,\n referenceName,\n config: {\n type: config.type,\n from: { table: config.from.table, column: columnName },\n to: { table: config.to.table, column: actualTargetColumnName },\n },\n });\n\n // Return this with updated type\n // Safe: The relation was added to the table in place and now has the updated relations\n return this as unknown as SchemaBuilder<\n UpdateTableRelations<TTables, TFromTableName, TReferenceName, TToTableName, TRelationType>\n >;\n }\n\n /**\n * Alter an existing table by adding columns or indexes.\n * This is used for append-only schema modifications.\n *\n * @param tableName - The name of the table to modify\n * @param callback - A callback that receives a table builder for adding columns/indexes\n *\n * @example\n * ```ts\n * // Add a new column to an existing table\n * schema(\"blog\", s => s\n * .addTable(\"users\", t => t\n * .addColumn(\"id\", idColumn())\n * .addColumn(\"name\", column(\"string\")))\n * .alterTable(\"users\", t => t\n * .addColumn(\"email\", column(\"string\"))\n * .addColumn(\"age\", column(\"integer\").nullable())\n * .createIndex(\"idx_email\", [\"email\"]))\n * )\n * ```\n */\n alterTable<\n TTableName extends string & keyof TTables,\n TNewColumns extends Record<string, AnyColumn>,\n TNewRelations extends Record<string, AnyRelation>,\n TNewIndexes extends Record<string, Index> = Record<string, Index>,\n >(\n tableName: TTableName,\n callback: (\n builder: TableBuilder<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"],\n Record<string, Index>\n >,\n ) => TableBuilder<TNewColumns, TNewRelations, TNewIndexes>,\n ): SchemaBuilder<UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>> {\n const table = this.#tables[tableName];\n\n if (!table) {\n throw new Error(`Table ${tableName} not found in schema`);\n }\n\n // Create builder with existing table state\n const tableBuilder = new TableBuilder(tableName);\n tableBuilder.setColumns(table.columns);\n tableBuilder.setRelations(table.relations);\n tableBuilder.setIndexes(table.indexes);\n\n // Track existing columns and indexes\n const existingColumns = new Set(Object.keys(table.columns));\n const existingIndexes = new Set(Object.keys(table.indexes));\n\n // Apply modifications\n const resultBuilder = callback(\n tableBuilder as TableBuilder<\n TTables[TTableName][\"columns\"],\n TTables[TTableName][\"relations\"],\n Record<string, Index>\n >,\n );\n const newTable = resultBuilder.build();\n\n // Collect sub-operations\n const subOperations: TableSubOperation[] = [];\n\n // Find new columns (preserve order from builder)\n const columnOrder = resultBuilder.getColumnOrder();\n for (const colName of columnOrder) {\n if (!existingColumns.has(colName)) {\n subOperations.push({\n type: \"add-column\",\n columnName: colName,\n column: newTable.columns[colName],\n });\n }\n }\n\n // Add only new indexes\n for (const idx of resultBuilder.getIndexes()) {\n if (!existingIndexes.has(idx.name)) {\n if (this.#indexNames.has(idx.name)) {\n throw new Error(\n `Duplicate index name \"${idx.name}\" in schema \"${this.#name}\". Index names must be unique across tables (conflict on \"${tableName}\").`,\n );\n }\n subOperations.push({\n type: \"add-index\",\n name: idx.name,\n columns: idx.columns.map((c) => c.name),\n unique: idx.unique,\n });\n }\n }\n\n if (subOperations.length > 0) {\n this.#version++;\n this.#operations.push({\n type: \"alter-table\",\n tableName,\n operations: subOperations,\n });\n }\n\n // Update table reference in schema\n this.#tables[tableName] = newTable as unknown as TTables[TTableName];\n for (const idx of resultBuilder.getIndexes()) {\n if (!existingIndexes.has(idx.name)) {\n this.#indexNames.add(idx.name);\n }\n }\n\n // Set table name for all columns\n for (const col of Object.values(newTable.columns)) {\n col.tableName = newTable.name;\n }\n\n return this as unknown as SchemaBuilder<\n UpdateTable<TTables, TTableName, TNewColumns, TNewRelations, TNewIndexes>\n >;\n }\n\n /**\n * Build the final schema. This should be called after all tables are added.\n */\n build(): Schema<TTables> {\n const operations = this.#operations;\n const version = this.#version;\n const tables = this.#tables;\n\n const schema: Schema<TTables> = {\n name: this.#name,\n version,\n tables,\n operations,\n clone: () => {\n const cloneTables: Record<string, AnyTable> = {};\n\n for (const [k, v] of Object.entries(tables)) {\n // Create a new table with cloned columns\n const clonedColumns: Record<string, AnyColumn> = {};\n for (const [colName, col] of Object.entries(v.columns)) {\n // Create a new column with the same properties, preserving the column type\n let clonedCol: AnyColumn;\n if (col instanceof InternalIdColumn) {\n clonedCol = new InternalIdColumn();\n } else if (col instanceof VersionColumn) {\n clonedCol = new VersionColumn();\n } else if (col instanceof IdColumn) {\n clonedCol = new IdColumn(col.type);\n } else {\n clonedCol = new Column(col.type);\n }\n\n clonedCol.name = col.name;\n clonedCol.isNullable = col.isNullable;\n clonedCol.role = col.role;\n clonedCol.isHidden = col.isHidden;\n clonedCol.default = col.default;\n clonedCol.tableName = col.tableName;\n clonedColumns[colName] = clonedCol;\n }\n\n const clonedTable = {\n ...v,\n columns: clonedColumns,\n } as AnyTable;\n\n clonedTable[\"~standard\"] = createTableStandardSchemaProps(clonedTable, validationClasses);\n clonedTable.validate = createTableValidator(clonedTable, validationClasses);\n\n cloneTables[k] = clonedTable;\n }\n\n const clonedSchema: Schema<TTables> = {\n name: this.#name,\n version,\n tables: cloneTables as TTables,\n operations: [...operations],\n clone: () => {\n throw new Error(\"Cannot clone during clone\");\n },\n };\n\n return new SchemaBuilder<TTables>(this.#name, clonedSchema).build();\n },\n };\n\n return schema;\n }\n\n /**\n * Get the current version of the schema builder.\n */\n getVersion(): number {\n return this.#version;\n }\n}\n\n/**\n * Create a new schema with callback pattern.\n */\nexport function schema<const TTables extends Record<string, AnyTable> = {}>(\n name: string,\n callback: (builder: SchemaBuilder<{}>) => SchemaBuilder<TTables>,\n): Schema<TTables> {\n return callback(new SchemaBuilder(name)).build();\n}\n\nexport function compileForeignKey(key: ForeignKey) {\n return {\n name: key.name,\n table: key.table.name,\n referencedTable: key.referencedTable.name,\n referencedColumns: key.referencedColumns.map((col) => col.name),\n columns: key.columns.map((col) => col.name),\n };\n}\n"],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ import { AnySchema, FragnoId } from "./create.js";
2
+
3
+ //#region src/schema/generate-id.d.ts
4
+
5
+ /**
6
+ * Generate a new ID for a table without creating a record.
7
+ * This is useful when you need to reference an ID before actually creating the record,
8
+ * or when you need to pass the ID to external services.
9
+ *
10
+ * @example
11
+ * ```ts
12
+ * const userId = generateId(mySchema, "users");
13
+ * // Use userId in related records or pass to external services
14
+ * uow.create("users", { id: userId, name: "John" });
15
+ * ```
16
+ */
17
+ declare function generateId<TSchema extends AnySchema, TableName extends keyof TSchema["tables"] & string>(schema: TSchema, tableName: TableName): FragnoId;
18
+ //#endregion
19
+ export { generateId };
20
+ //# sourceMappingURL=generate-id.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-id.d.ts","names":[],"sources":["../../src/schema/generate-id.ts"],"sourcesContent":[],"mappings":";;;;;AAeA;;;;;;;;;;;iBAAgB,2BACE,mCACQ,oCAChB,oBAAoB,YAAY"}
@@ -0,0 +1,28 @@
1
+ import { FragnoId } from "./create.js";
2
+
3
+ //#region src/schema/generate-id.ts
4
+ /**
5
+ * Generate a new ID for a table without creating a record.
6
+ * This is useful when you need to reference an ID before actually creating the record,
7
+ * or when you need to pass the ID to external services.
8
+ *
9
+ * @example
10
+ * ```ts
11
+ * const userId = generateId(mySchema, "users");
12
+ * // Use userId in related records or pass to external services
13
+ * uow.create("users", { id: userId, name: "John" });
14
+ * ```
15
+ */
16
+ function generateId(schema, tableName) {
17
+ const tableSchema = schema.tables[tableName];
18
+ if (!tableSchema) throw new Error(`Table ${tableName} not found in schema`);
19
+ const idColumn = tableSchema.getIdColumn();
20
+ const generated = idColumn.generateDefaultValue();
21
+ if (generated === void 0) throw new Error(`ID column ${idColumn.name} on table ${tableName} has no default generator`);
22
+ if (typeof generated !== "string") throw new Error(`ID column ${idColumn.name} on table ${tableName} has no default generator that generates a string.`);
23
+ return FragnoId.fromExternal(generated, 0);
24
+ }
25
+
26
+ //#endregion
27
+ export { generateId };
28
+ //# sourceMappingURL=generate-id.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"generate-id.js","names":[],"sources":["../../src/schema/generate-id.ts"],"sourcesContent":["import type { AnySchema } from \"./create\";\nimport { FragnoId } from \"./create\";\n\n/**\n * Generate a new ID for a table without creating a record.\n * This is useful when you need to reference an ID before actually creating the record,\n * or when you need to pass the ID to external services.\n *\n * @example\n * ```ts\n * const userId = generateId(mySchema, \"users\");\n * // Use userId in related records or pass to external services\n * uow.create(\"users\", { id: userId, name: \"John\" });\n * ```\n */\nexport function generateId<\n TSchema extends AnySchema,\n TableName extends keyof TSchema[\"tables\"] & string,\n>(schema: TSchema, tableName: TableName): FragnoId {\n const tableSchema = schema.tables[tableName];\n if (!tableSchema) {\n throw new Error(`Table ${tableName} not found in schema`);\n }\n\n const idColumn = tableSchema.getIdColumn();\n const generated = idColumn.generateDefaultValue();\n if (generated === undefined) {\n throw new Error(`ID column ${idColumn.name} on table ${tableName} has no default generator`);\n }\n\n if (typeof generated !== \"string\") {\n throw new Error(\n `ID column ${idColumn.name} on table ${tableName} has no default generator that generates a string.`,\n );\n }\n\n return FragnoId.fromExternal(generated, 0);\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,SAAgB,WAGd,QAAiB,WAAgC;CACjD,MAAM,cAAc,OAAO,OAAO;AAClC,KAAI,CAAC,YACH,OAAM,IAAI,MAAM,SAAS,UAAU,sBAAsB;CAG3D,MAAM,WAAW,YAAY,aAAa;CAC1C,MAAM,YAAY,SAAS,sBAAsB;AACjD,KAAI,cAAc,OAChB,OAAM,IAAI,MAAM,aAAa,SAAS,KAAK,YAAY,UAAU,2BAA2B;AAG9F,KAAI,OAAO,cAAc,SACvB,OAAM,IAAI,MACR,aAAa,SAAS,KAAK,YAAY,UAAU,oDAClD;AAGH,QAAO,SAAS,aAAa,WAAW,EAAE"}
@@ -10,13 +10,14 @@ import { SQLiteTypeMapper } from "./dialect/sqlite.js";
10
10
  * (PostgreSQL, MySQL, or SQLite).
11
11
  *
12
12
  * @param database - The database type (sqlite, postgresql, or mysql)
13
+ * @param sqliteStorageMode - Optional SQLite storage mode override
13
14
  * @returns Dialect-specific SQLTypeMapper instance
14
15
  */
15
- function createSQLTypeMapper(database) {
16
+ function createSQLTypeMapper(database, sqliteStorageMode) {
16
17
  switch (database) {
17
18
  case "postgresql": return new PostgreSQLTypeMapper(database);
18
19
  case "mysql": return new MySQLTypeMapper(database);
19
- case "sqlite": return new SQLiteTypeMapper(database);
20
+ case "sqlite": return new SQLiteTypeMapper(database, sqliteStorageMode);
20
21
  default: {
21
22
  const exhaustiveCheck = database;
22
23
  throw new Error(`Unsupported database type: ${exhaustiveCheck}`);
@@ -1 +1 @@
1
- {"version":3,"file":"create-sql-type-mapper.js","names":["exhaustiveCheck: never"],"sources":["../../../src/schema/type-conversion/create-sql-type-mapper.ts"],"sourcesContent":["import type { SupportedDatabase } from \"../../adapters/generic-sql/driver-config\";\nimport { PostgreSQLTypeMapper } from \"./dialect/postgres\";\nimport { MySQLTypeMapper } from \"./dialect/mysql\";\nimport { SQLiteTypeMapper } from \"./dialect/sqlite\";\n\n/**\n * Factory function to create a dialect-specific SQL type mapper.\n *\n * Based on the database type, returns the appropriate mapper implementation\n * (PostgreSQL, MySQL, or SQLite).\n *\n * @param database - The database type (sqlite, postgresql, or mysql)\n * @returns Dialect-specific SQLTypeMapper instance\n */\nexport function createSQLTypeMapper(database: SupportedDatabase) {\n switch (database) {\n case \"postgresql\":\n return new PostgreSQLTypeMapper(database);\n case \"mysql\":\n return new MySQLTypeMapper(database);\n case \"sqlite\":\n return new SQLiteTypeMapper(database);\n default: {\n const exhaustiveCheck: never = database;\n throw new Error(`Unsupported database type: ${exhaustiveCheck}`);\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;AAcA,SAAgB,oBAAoB,UAA6B;AAC/D,SAAQ,UAAR;EACE,KAAK,aACH,QAAO,IAAI,qBAAqB,SAAS;EAC3C,KAAK,QACH,QAAO,IAAI,gBAAgB,SAAS;EACtC,KAAK,SACH,QAAO,IAAI,iBAAiB,SAAS;EACvC,SAAS;GACP,MAAMA,kBAAyB;AAC/B,SAAM,IAAI,MAAM,8BAA8B,kBAAkB"}
1
+ {"version":3,"file":"create-sql-type-mapper.js","names":["exhaustiveCheck: never"],"sources":["../../../src/schema/type-conversion/create-sql-type-mapper.ts"],"sourcesContent":["import type { SupportedDatabase } from \"../../adapters/generic-sql/driver-config\";\nimport type { SQLiteStorageMode } from \"../../adapters/generic-sql/sqlite-storage\";\nimport { PostgreSQLTypeMapper } from \"./dialect/postgres\";\nimport { MySQLTypeMapper } from \"./dialect/mysql\";\nimport { SQLiteTypeMapper } from \"./dialect/sqlite\";\n\n/**\n * Factory function to create a dialect-specific SQL type mapper.\n *\n * Based on the database type, returns the appropriate mapper implementation\n * (PostgreSQL, MySQL, or SQLite).\n *\n * @param database - The database type (sqlite, postgresql, or mysql)\n * @param sqliteStorageMode - Optional SQLite storage mode override\n * @returns Dialect-specific SQLTypeMapper instance\n */\nexport function createSQLTypeMapper(\n database: SupportedDatabase,\n sqliteStorageMode?: SQLiteStorageMode,\n) {\n switch (database) {\n case \"postgresql\":\n return new PostgreSQLTypeMapper(database);\n case \"mysql\":\n return new MySQLTypeMapper(database);\n case \"sqlite\":\n return new SQLiteTypeMapper(database, sqliteStorageMode);\n default: {\n const exhaustiveCheck: never = database;\n throw new Error(`Unsupported database type: ${exhaustiveCheck}`);\n }\n }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAgBA,SAAgB,oBACd,UACA,mBACA;AACA,SAAQ,UAAR;EACE,KAAK,aACH,QAAO,IAAI,qBAAqB,SAAS;EAC3C,KAAK,QACH,QAAO,IAAI,gBAAgB,SAAS;EACtC,KAAK,SACH,QAAO,IAAI,iBAAiB,UAAU,kBAAkB;EAC1D,SAAS;GACP,MAAMA,kBAAyB;AAC/B,SAAM,IAAI,MAAM,8BAA8B,kBAAkB"}
@@ -1,3 +1,4 @@
1
+ import { sqliteStorageDefault } from "../../../adapters/generic-sql/sqlite-storage.js";
1
2
  import { SQLTypeMapper } from "../type-mapping.js";
2
3
 
3
4
  //#region src/schema/type-conversion/dialect/sqlite.ts
@@ -11,6 +12,11 @@ import { SQLTypeMapper } from "../type-mapping.js";
11
12
  * - REAL for decimals
12
13
  */
13
14
  var SQLiteTypeMapper = class extends SQLTypeMapper {
15
+ sqliteStorageMode;
16
+ constructor(database, sqliteStorageMode) {
17
+ super(database);
18
+ this.sqliteStorageMode = sqliteStorageMode ?? sqliteStorageDefault;
19
+ }
14
20
  getInternalIdType() {
15
21
  return "integer";
16
22
  }
@@ -19,6 +25,7 @@ var SQLiteTypeMapper = class extends SQLTypeMapper {
19
25
  }
20
26
  mapBigint(column) {
21
27
  if ("role" in column && column.role === "reference") return "integer";
28
+ if (this.sqliteStorageMode.bigintStorage === "integer") return "integer";
22
29
  return "blob";
23
30
  }
24
31
  mapString() {
@@ -37,9 +44,11 @@ var SQLiteTypeMapper = class extends SQLTypeMapper {
37
44
  return "real";
38
45
  }
39
46
  mapTimestamp() {
47
+ if (this.sqliteStorageMode.timestampStorage === "iso-text") return "text";
40
48
  return "integer";
41
49
  }
42
50
  mapDate() {
51
+ if (this.sqliteStorageMode.dateStorage === "iso-text") return "text";
43
52
  return "integer";
44
53
  }
45
54
  mapJson() {
@@ -1 +1 @@
1
- {"version":3,"file":"sqlite.js","names":[],"sources":["../../../../src/schema/type-conversion/dialect/sqlite.ts"],"sourcesContent":["import type { AnyColumn } from \"../../create\";\nimport { SQLTypeMapper, type SQLiteDatabaseType } from \"../type-mapping\";\n\n/**\n * SQLite-specific type mapper.\n *\n * SQLite has a limited type system with only 4 storage classes:\n * - INTEGER for integers, booleans, timestamps, dates (and reference columns)\n * - BLOB for binary data and bigints (except for reference columns)\n * - TEXT for strings, JSON, and varchar\n * - REAL for decimals\n */\nexport class SQLiteTypeMapper extends SQLTypeMapper<SQLiteDatabaseType> {\n protected getInternalIdType(): SQLiteDatabaseType {\n // SQLite uses INTEGER for auto-increment (INTEGER PRIMARY KEY)\n return \"integer\";\n }\n\n protected mapInteger(_column: AnyColumn | Pick<AnyColumn, \"type\">): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapBigint(column: AnyColumn | Pick<AnyColumn, \"type\">): SQLiteDatabaseType {\n // SQLite special case: reference columns should use integer even if type is bigint\n if (\"role\" in column && column.role === \"reference\") {\n return \"integer\";\n }\n return \"blob\";\n }\n\n protected mapString(): SQLiteDatabaseType {\n return \"text\";\n }\n\n protected mapVarchar(_length: number): SQLiteDatabaseType {\n // SQLite doesn't support varchar - convert to text\n return \"text\";\n }\n\n protected mapBinary(): SQLiteDatabaseType {\n return \"blob\";\n }\n\n protected mapBool(): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapDecimal(): SQLiteDatabaseType {\n return \"real\";\n }\n\n protected mapTimestamp(): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapDate(): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapJson(): SQLiteDatabaseType {\n return \"text\";\n }\n}\n"],"mappings":";;;;;;;;;;;;AAYA,IAAa,mBAAb,cAAsC,cAAkC;CACtE,AAAU,oBAAwC;AAEhD,SAAO;;CAGT,AAAU,WAAW,SAAkE;AACrF,SAAO;;CAGT,AAAU,UAAU,QAAiE;AAEnF,MAAI,UAAU,UAAU,OAAO,SAAS,YACtC,QAAO;AAET,SAAO;;CAGT,AAAU,YAAgC;AACxC,SAAO;;CAGT,AAAU,WAAW,SAAqC;AAExD,SAAO;;CAGT,AAAU,YAAgC;AACxC,SAAO;;CAGT,AAAU,UAA8B;AACtC,SAAO;;CAGT,AAAU,aAAiC;AACzC,SAAO;;CAGT,AAAU,eAAmC;AAC3C,SAAO;;CAGT,AAAU,UAA8B;AACtC,SAAO;;CAGT,AAAU,UAA8B;AACtC,SAAO"}
1
+ {"version":3,"file":"sqlite.js","names":[],"sources":["../../../../src/schema/type-conversion/dialect/sqlite.ts"],"sourcesContent":["import type { AnyColumn } from \"../../create\";\nimport { SQLTypeMapper, type SQLiteDatabaseType } from \"../type-mapping\";\nimport type { SQLiteStorageMode } from \"../../../adapters/generic-sql/sqlite-storage\";\nimport { sqliteStorageDefault } from \"../../../adapters/generic-sql/sqlite-storage\";\n\n/**\n * SQLite-specific type mapper.\n *\n * SQLite has a limited type system with only 4 storage classes:\n * - INTEGER for integers, booleans, timestamps, dates (and reference columns)\n * - BLOB for binary data and bigints (except for reference columns)\n * - TEXT for strings, JSON, and varchar\n * - REAL for decimals\n */\nexport class SQLiteTypeMapper extends SQLTypeMapper<SQLiteDatabaseType> {\n private readonly sqliteStorageMode: SQLiteStorageMode;\n\n constructor(database: \"sqlite\", sqliteStorageMode?: SQLiteStorageMode) {\n super(database);\n this.sqliteStorageMode = sqliteStorageMode ?? sqliteStorageDefault;\n }\n\n protected getInternalIdType(): SQLiteDatabaseType {\n // SQLite uses INTEGER for auto-increment (INTEGER PRIMARY KEY)\n return \"integer\";\n }\n\n protected mapInteger(_column: AnyColumn | Pick<AnyColumn, \"type\">): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapBigint(column: AnyColumn | Pick<AnyColumn, \"type\">): SQLiteDatabaseType {\n // SQLite special case: reference columns should use integer even if type is bigint\n if (\"role\" in column && column.role === \"reference\") {\n return \"integer\";\n }\n if (this.sqliteStorageMode.bigintStorage === \"integer\") {\n return \"integer\";\n }\n return \"blob\";\n }\n\n protected mapString(): SQLiteDatabaseType {\n return \"text\";\n }\n\n protected mapVarchar(_length: number): SQLiteDatabaseType {\n // SQLite doesn't support varchar - convert to text\n return \"text\";\n }\n\n protected mapBinary(): SQLiteDatabaseType {\n return \"blob\";\n }\n\n protected mapBool(): SQLiteDatabaseType {\n return \"integer\";\n }\n\n protected mapDecimal(): SQLiteDatabaseType {\n return \"real\";\n }\n\n protected mapTimestamp(): SQLiteDatabaseType {\n if (this.sqliteStorageMode.timestampStorage === \"iso-text\") {\n return \"text\";\n }\n return \"integer\";\n }\n\n protected mapDate(): SQLiteDatabaseType {\n if (this.sqliteStorageMode.dateStorage === \"iso-text\") {\n return \"text\";\n }\n return \"integer\";\n }\n\n protected mapJson(): SQLiteDatabaseType {\n return \"text\";\n }\n}\n"],"mappings":";;;;;;;;;;;;;AAcA,IAAa,mBAAb,cAAsC,cAAkC;CACtE,AAAiB;CAEjB,YAAY,UAAoB,mBAAuC;AACrE,QAAM,SAAS;AACf,OAAK,oBAAoB,qBAAqB;;CAGhD,AAAU,oBAAwC;AAEhD,SAAO;;CAGT,AAAU,WAAW,SAAkE;AACrF,SAAO;;CAGT,AAAU,UAAU,QAAiE;AAEnF,MAAI,UAAU,UAAU,OAAO,SAAS,YACtC,QAAO;AAET,MAAI,KAAK,kBAAkB,kBAAkB,UAC3C,QAAO;AAET,SAAO;;CAGT,AAAU,YAAgC;AACxC,SAAO;;CAGT,AAAU,WAAW,SAAqC;AAExD,SAAO;;CAGT,AAAU,YAAgC;AACxC,SAAO;;CAGT,AAAU,UAA8B;AACtC,SAAO;;CAGT,AAAU,aAAiC;AACzC,SAAO;;CAGT,AAAU,eAAmC;AAC3C,MAAI,KAAK,kBAAkB,qBAAqB,WAC9C,QAAO;AAET,SAAO;;CAGT,AAAU,UAA8B;AACtC,MAAI,KAAK,kBAAkB,gBAAgB,WACzC,QAAO;AAET,SAAO;;CAGT,AAAU,UAA8B;AACtC,SAAO"}
@@ -0,0 +1,10 @@
1
+ import { StandardSchemaV1 } from "@standard-schema/spec";
2
+
3
+ //#region src/schema/validator.d.ts
4
+ declare class FragnoDbValidationError extends Error {
5
+ readonly issues: readonly StandardSchemaV1.Issue[];
6
+ constructor(message: string, issues: readonly StandardSchemaV1.Issue[]);
7
+ }
8
+ //#endregion
9
+ export { FragnoDbValidationError };
10
+ //# sourceMappingURL=validator.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validator.d.ts","names":[],"sources":["../../src/schema/validator.ts"],"sourcesContent":[],"mappings":";;;cASa,uBAAA,SAAgC,KAAA;EAAhC,SAAA,MAAA,EAAA,SACe,gBAAA,CAAiB,KADR,EAAA;EACT,WAAA,CAAA,OAAiB,EAAA,MAAA,EAAA,MAAA,EAAA,SAEG,gBAAA,CAAiB,KAFpB,EAAA"}
@@ -0,0 +1,123 @@
1
+ //#region src/schema/validator.ts
2
+ var FragnoDbValidationError = class extends Error {
3
+ issues;
4
+ constructor(message, issues) {
5
+ super(message);
6
+ this.name = "FragnoDbValidationError";
7
+ this.issues = issues;
8
+ }
9
+ };
10
+ const defaultUnknownKeysMode = "strip";
11
+ const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
12
+ const parseVarcharLength = (type) => {
13
+ if (!type.startsWith("varchar(") || !type.endsWith(")")) return;
14
+ const rawLength = type.slice(8, -1);
15
+ const length = Number(rawLength);
16
+ if (!Number.isFinite(length)) return;
17
+ return length;
18
+ };
19
+ const getUnknownKeysMode = (options) => {
20
+ return (options?.libraryOptions)?.unknownKeys ?? defaultUnknownKeysMode;
21
+ };
22
+ const validateColumnValue = (col, value, classes) => {
23
+ if (col.role === "external-id") {
24
+ if (value instanceof classes.FragnoId) {
25
+ const maxLength = parseVarcharLength(col.type);
26
+ if (maxLength !== void 0 && value.externalId.length > maxLength) return `String must have at most ${maxLength} characters`;
27
+ return;
28
+ }
29
+ if (typeof value === "string") {
30
+ const maxLength = parseVarcharLength(col.type);
31
+ if (maxLength !== void 0 && value.length > maxLength) return `String must have at most ${maxLength} characters`;
32
+ return;
33
+ }
34
+ return "Expected string or FragnoId";
35
+ }
36
+ if (col.role === "reference") {
37
+ if (value instanceof classes.FragnoReference || value instanceof classes.FragnoId || typeof value === "string" || typeof value === "bigint") return;
38
+ return "Expected reference (string, bigint, FragnoId, or FragnoReference)";
39
+ }
40
+ if (col.type === "string" || col.type.startsWith("varchar(")) {
41
+ if (typeof value !== "string") return "Expected string";
42
+ const maxLength = parseVarcharLength(col.type);
43
+ if (maxLength !== void 0 && value.length > maxLength) return `String must have at most ${maxLength} characters`;
44
+ return;
45
+ }
46
+ if (col.type === "bigint") return typeof value === "bigint" ? void 0 : "Expected bigint";
47
+ if (col.type === "integer") {
48
+ if (typeof value !== "number" || !Number.isInteger(value)) return "Expected integer";
49
+ return;
50
+ }
51
+ if (col.type === "decimal") {
52
+ if (typeof value !== "number" || !Number.isFinite(value)) return "Expected number";
53
+ return;
54
+ }
55
+ if (col.type === "bool") return typeof value === "boolean" ? void 0 : "Expected boolean";
56
+ if (col.type === "binary") return value instanceof Uint8Array ? void 0 : "Expected Uint8Array";
57
+ if (col.type === "date" || col.type === "timestamp") {
58
+ if (!(value instanceof Date) || Number.isNaN(value.getTime())) return "Expected valid Date";
59
+ return;
60
+ }
61
+ if (col.type === "json") return;
62
+ };
63
+ const validateTableInsertValues = (table, value, options, classes) => {
64
+ const issues = [];
65
+ if (!isRecord(value)) return { issues: [{ message: "Expected object" }] };
66
+ const input = value;
67
+ const entries = Object.entries(table.columns).filter(([, col]) => !col.isHidden);
68
+ const allowedKeys = new Set(entries.map(([key]) => key));
69
+ if (getUnknownKeysMode(options) === "strict") {
70
+ for (const key of Object.keys(input)) if (!allowedKeys.has(key)) issues.push({
71
+ message: `Unknown key "${key}"`,
72
+ path: [key]
73
+ });
74
+ }
75
+ const output = {};
76
+ for (const [key, col] of entries) {
77
+ const colValue = Object.prototype.hasOwnProperty.call(input, key) ? input[key] : void 0;
78
+ const allowsUndefined = col.isNullable || col.default !== void 0;
79
+ const allowsNull = col.isNullable;
80
+ if (colValue === void 0) {
81
+ if (!allowsUndefined) issues.push({
82
+ message: "Required",
83
+ path: [key]
84
+ });
85
+ continue;
86
+ }
87
+ if (colValue === null) {
88
+ if (!allowsNull) issues.push({
89
+ message: "Required",
90
+ path: [key]
91
+ });
92
+ else output[key] = null;
93
+ continue;
94
+ }
95
+ const issue = validateColumnValue(col, colValue, classes);
96
+ if (issue) {
97
+ issues.push({
98
+ message: issue,
99
+ path: [key]
100
+ });
101
+ continue;
102
+ }
103
+ output[key] = colValue;
104
+ }
105
+ if (issues.length > 0) return { issues };
106
+ return { value: output };
107
+ };
108
+ const createTableStandardSchemaProps = (table, classes) => ({
109
+ version: 1,
110
+ vendor: "fragno-db",
111
+ validate: (value, options) => validateTableInsertValues(table, value, options, classes)
112
+ });
113
+ const createTableValidator = (table, classes) => {
114
+ return (value, options) => {
115
+ const result = validateTableInsertValues(table, value, { libraryOptions: options }, classes);
116
+ if (result.issues) throw new FragnoDbValidationError("Validation failed", result.issues);
117
+ return result.value;
118
+ };
119
+ };
120
+
121
+ //#endregion
122
+ export { FragnoDbValidationError, createTableStandardSchemaProps, createTableValidator };
123
+ //# sourceMappingURL=validator.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"validator.js","names":["defaultUnknownKeysMode: TableUnknownKeysMode","issues: StandardSchemaV1.Issue[]","output: Record<string, unknown>"],"sources":["../../src/schema/validator.ts"],"sourcesContent":["import type { StandardSchemaV1 } from \"@standard-schema/spec\";\nimport type {\n AnyColumn,\n Table,\n TableInsertValues,\n TableUnknownKeysMode,\n TableValidationOptions,\n} from \"./create\";\n\nexport class FragnoDbValidationError extends Error {\n readonly issues: readonly StandardSchemaV1.Issue[];\n\n constructor(message: string, issues: readonly StandardSchemaV1.Issue[]) {\n super(message);\n this.name = \"FragnoDbValidationError\";\n this.issues = issues;\n }\n}\n\ntype FragnoIdCtor = typeof import(\"./create\").FragnoId;\ntype FragnoReferenceCtor = typeof import(\"./create\").FragnoReference;\n\ntype ValidationClasses = {\n FragnoId: FragnoIdCtor;\n FragnoReference: FragnoReferenceCtor;\n};\n\nconst defaultUnknownKeysMode: TableUnknownKeysMode = \"strip\";\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n typeof value === \"object\" && value !== null && !Array.isArray(value);\n\nconst parseVarcharLength = (type: string): number | undefined => {\n if (!type.startsWith(\"varchar(\") || !type.endsWith(\")\")) {\n return;\n }\n\n const rawLength = type.slice(\"varchar(\".length, -1);\n const length = Number(rawLength);\n if (!Number.isFinite(length)) {\n return;\n }\n\n return length;\n};\n\nconst getUnknownKeysMode = (options?: StandardSchemaV1.Options): TableUnknownKeysMode => {\n const libraryOptions = options?.libraryOptions as TableValidationOptions | undefined;\n return libraryOptions?.unknownKeys ?? defaultUnknownKeysMode;\n};\n\nconst validateColumnValue = (\n col: AnyColumn,\n value: unknown,\n classes: ValidationClasses,\n): string | undefined => {\n if (col.role === \"external-id\") {\n if (value instanceof classes.FragnoId) {\n const maxLength = parseVarcharLength(col.type);\n if (maxLength !== undefined && value.externalId.length > maxLength) {\n return `String must have at most ${maxLength} characters`;\n }\n return;\n }\n\n if (typeof value === \"string\") {\n const maxLength = parseVarcharLength(col.type);\n if (maxLength !== undefined && value.length > maxLength) {\n return `String must have at most ${maxLength} characters`;\n }\n return;\n }\n\n return \"Expected string or FragnoId\";\n }\n\n if (col.role === \"reference\") {\n if (\n value instanceof classes.FragnoReference ||\n value instanceof classes.FragnoId ||\n typeof value === \"string\" ||\n typeof value === \"bigint\"\n ) {\n return;\n }\n\n return \"Expected reference (string, bigint, FragnoId, or FragnoReference)\";\n }\n\n if (col.type === \"string\" || col.type.startsWith(\"varchar(\")) {\n if (typeof value !== \"string\") {\n return \"Expected string\";\n }\n\n const maxLength = parseVarcharLength(col.type);\n if (maxLength !== undefined && value.length > maxLength) {\n return `String must have at most ${maxLength} characters`;\n }\n\n return;\n }\n\n if (col.type === \"bigint\") {\n return typeof value === \"bigint\" ? undefined : \"Expected bigint\";\n }\n\n if (col.type === \"integer\") {\n if (typeof value !== \"number\" || !Number.isInteger(value)) {\n return \"Expected integer\";\n }\n return;\n }\n\n if (col.type === \"decimal\") {\n if (typeof value !== \"number\" || !Number.isFinite(value)) {\n return \"Expected number\";\n }\n return;\n }\n\n if (col.type === \"bool\") {\n return typeof value === \"boolean\" ? undefined : \"Expected boolean\";\n }\n\n if (col.type === \"binary\") {\n return value instanceof Uint8Array ? undefined : \"Expected Uint8Array\";\n }\n\n if (col.type === \"date\" || col.type === \"timestamp\") {\n if (!(value instanceof Date) || Number.isNaN(value.getTime())) {\n return \"Expected valid Date\";\n }\n return;\n }\n\n if (col.type === \"json\") {\n return;\n }\n\n return;\n};\n\nconst validateTableInsertValues = <TTable extends Table>(\n table: TTable,\n value: unknown,\n options: StandardSchemaV1.Options | undefined,\n classes: ValidationClasses,\n): StandardSchemaV1.Result<TableInsertValues<TTable>> => {\n const issues: StandardSchemaV1.Issue[] = [];\n\n if (!isRecord(value)) {\n return { issues: [{ message: \"Expected object\" }] };\n }\n\n const input = value as Record<string, unknown>;\n const entries = Object.entries(table.columns).filter(([, col]) => !col.isHidden);\n const allowedKeys = new Set(entries.map(([key]) => key));\n const unknownKeysMode = getUnknownKeysMode(options);\n\n if (unknownKeysMode === \"strict\") {\n for (const key of Object.keys(input)) {\n if (!allowedKeys.has(key)) {\n issues.push({ message: `Unknown key \"${key}\"`, path: [key] });\n }\n }\n }\n\n const output: Record<string, unknown> = {};\n\n for (const [key, col] of entries) {\n const hasKey = Object.prototype.hasOwnProperty.call(input, key);\n const colValue = hasKey ? input[key] : undefined;\n const allowsUndefined = col.isNullable || col.default !== undefined;\n const allowsNull = col.isNullable;\n\n if (colValue === undefined) {\n if (!allowsUndefined) {\n issues.push({ message: \"Required\", path: [key] });\n }\n continue;\n }\n\n if (colValue === null) {\n if (!allowsNull) {\n issues.push({ message: \"Required\", path: [key] });\n } else {\n output[key] = null;\n }\n continue;\n }\n\n const issue = validateColumnValue(col, colValue, classes);\n if (issue) {\n issues.push({ message: issue, path: [key] });\n continue;\n }\n\n output[key] = colValue;\n }\n\n if (issues.length > 0) {\n return { issues };\n }\n\n return { value: output as TableInsertValues<TTable> };\n};\n\nexport const createTableStandardSchemaProps = <TTable extends Table>(\n table: TTable,\n classes: ValidationClasses,\n): StandardSchemaV1.Props<TableInsertValues<TTable>, TableInsertValues<TTable>> => ({\n version: 1,\n vendor: \"fragno-db\",\n validate: (value: unknown, options?: StandardSchemaV1.Options) =>\n validateTableInsertValues(table, value, options, classes),\n});\n\nexport const createTableValidator = <TTable extends Table>(\n table: TTable,\n classes: ValidationClasses,\n) => {\n return (value: unknown, options?: TableValidationOptions) => {\n const result = validateTableInsertValues(table, value, { libraryOptions: options }, classes);\n\n if (result.issues) {\n throw new FragnoDbValidationError(\"Validation failed\", result.issues);\n }\n\n return result.value as TableInsertValues<TTable>;\n };\n};\n"],"mappings":"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"}
@@ -0,0 +1,30 @@
1
+ import { AnySchema } from "../schema/create.js";
2
+ import { SqlNamingStrategy } from "../naming/sql-naming.js";
3
+ import { SupportedDatabase } from "../adapters/generic-sql/driver-config.js";
4
+
5
+ //#region src/schema-output/drizzle.d.ts
6
+ type SupportedProvider = SupportedDatabase;
7
+ interface GenerateSchemaOptions {
8
+ /** Custom ID generator import configuration */
9
+ idGeneratorImport?: {
10
+ /** Function name to import */
11
+ name: string;
12
+ /** Module to import from */
13
+ from: string;
14
+ };
15
+ /** Optional naming strategy override for physical names */
16
+ namingStrategy?: SqlNamingStrategy;
17
+ }
18
+ /**
19
+ * Generate a settings table for storing fragment versions
20
+ */
21
+ /**
22
+ * Generate a schema file from one or more fragments with automatic de-duplication
23
+ */
24
+ declare function generateDrizzleSchema(fragments: {
25
+ namespace: string | null;
26
+ schema: AnySchema;
27
+ }[], provider: SupportedDatabase, options?: GenerateSchemaOptions): string;
28
+ //#endregion
29
+ export { GenerateSchemaOptions, SupportedProvider, generateDrizzleSchema };
30
+ //# sourceMappingURL=drizzle.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"drizzle.d.ts","names":[],"sources":["../../src/schema-output/drizzle.ts"],"sourcesContent":[],"mappings":";;;;;KAuCY,iBAAA,GAAoB;UA4nBf,qBAAA;EA5nBL;EA4nBK,iBAAA,CAAA,EAAA;IAkBD;IACiC,IAAA,EAAA,MAAA;IACrC;IACA,IAAA,EAAA,MAAA;EAAqB,CAAA;;mBAZd;;;;;;;;iBASH,qBAAA;;UACiC;eACrC,6BACA"}