@rangka/core 0.0.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (930) hide show
  1. package/.claude/skills/extend-core/SKILL.md +133 -0
  2. package/.turbo/turbo-build.log +4 -0
  3. package/CLAUDE.md +180 -0
  4. package/LICENSE +21 -0
  5. package/README.md +68 -0
  6. package/dist/__tests__/coerce.test.d.ts +2 -0
  7. package/dist/__tests__/coerce.test.d.ts.map +1 -0
  8. package/dist/__tests__/coerce.test.js +121 -0
  9. package/dist/__tests__/coerce.test.js.map +1 -0
  10. package/dist/__tests__/context.test.d.ts +2 -0
  11. package/dist/__tests__/context.test.d.ts.map +1 -0
  12. package/dist/__tests__/context.test.js +99 -0
  13. package/dist/__tests__/context.test.js.map +1 -0
  14. package/dist/__tests__/helpers.d.ts +3 -0
  15. package/dist/__tests__/helpers.d.ts.map +1 -0
  16. package/dist/__tests__/helpers.js +21 -0
  17. package/dist/__tests__/helpers.js.map +1 -0
  18. package/dist/__tests__/index.test.d.ts +2 -0
  19. package/dist/__tests__/index.test.d.ts.map +1 -0
  20. package/dist/__tests__/index.test.js +7 -0
  21. package/dist/__tests__/index.test.js.map +1 -0
  22. package/dist/__tests__/widgets.test.d.ts +2 -0
  23. package/dist/__tests__/widgets.test.d.ts.map +1 -0
  24. package/dist/__tests__/widgets.test.js +171 -0
  25. package/dist/__tests__/widgets.test.js.map +1 -0
  26. package/dist/api/__tests__/handlers.test.d.ts +2 -0
  27. package/dist/api/__tests__/handlers.test.d.ts.map +1 -0
  28. package/dist/api/__tests__/handlers.test.js +349 -0
  29. package/dist/api/__tests__/handlers.test.js.map +1 -0
  30. package/dist/api/__tests__/include-resolver.test.d.ts +2 -0
  31. package/dist/api/__tests__/include-resolver.test.d.ts.map +1 -0
  32. package/dist/api/__tests__/include-resolver.test.js +338 -0
  33. package/dist/api/__tests__/include-resolver.test.js.map +1 -0
  34. package/dist/api/__tests__/middleware.test.d.ts +2 -0
  35. package/dist/api/__tests__/middleware.test.d.ts.map +1 -0
  36. package/dist/api/__tests__/middleware.test.js +83 -0
  37. package/dist/api/__tests__/middleware.test.js.map +1 -0
  38. package/dist/api/__tests__/openapi-schema.test.d.ts +2 -0
  39. package/dist/api/__tests__/openapi-schema.test.d.ts.map +1 -0
  40. package/dist/api/__tests__/openapi-schema.test.js +184 -0
  41. package/dist/api/__tests__/openapi-schema.test.js.map +1 -0
  42. package/dist/api/__tests__/query-parser.test.d.ts +2 -0
  43. package/dist/api/__tests__/query-parser.test.d.ts.map +1 -0
  44. package/dist/api/__tests__/query-parser.test.js +239 -0
  45. package/dist/api/__tests__/query-parser.test.js.map +1 -0
  46. package/dist/api/__tests__/route-generator.test.d.ts +2 -0
  47. package/dist/api/__tests__/route-generator.test.d.ts.map +1 -0
  48. package/dist/api/__tests__/route-generator.test.js +120 -0
  49. package/dist/api/__tests__/route-generator.test.js.map +1 -0
  50. package/dist/api/__tests__/server.test.d.ts +2 -0
  51. package/dist/api/__tests__/server.test.d.ts.map +1 -0
  52. package/dist/api/__tests__/server.test.js +62 -0
  53. package/dist/api/__tests__/server.test.js.map +1 -0
  54. package/dist/api/__tests__/swagger.test.d.ts +2 -0
  55. package/dist/api/__tests__/swagger.test.d.ts.map +1 -0
  56. package/dist/api/__tests__/swagger.test.js +144 -0
  57. package/dist/api/__tests__/swagger.test.js.map +1 -0
  58. package/dist/api/handlers.d.ts +23 -0
  59. package/dist/api/handlers.d.ts.map +1 -0
  60. package/dist/api/handlers.js +182 -0
  61. package/dist/api/handlers.js.map +1 -0
  62. package/dist/api/include-resolver.d.ts +6 -0
  63. package/dist/api/include-resolver.d.ts.map +1 -0
  64. package/dist/api/include-resolver.js +13 -0
  65. package/dist/api/include-resolver.js.map +1 -0
  66. package/dist/api/index.d.ts +5 -0
  67. package/dist/api/index.d.ts.map +1 -0
  68. package/dist/api/index.js +4 -0
  69. package/dist/api/index.js.map +1 -0
  70. package/dist/api/meta-handler.d.ts +19 -0
  71. package/dist/api/meta-handler.d.ts.map +1 -0
  72. package/dist/api/meta-handler.js +188 -0
  73. package/dist/api/meta-handler.js.map +1 -0
  74. package/dist/api/openapi-schema.d.ts +25 -0
  75. package/dist/api/openapi-schema.d.ts.map +1 -0
  76. package/dist/api/openapi-schema.js +77 -0
  77. package/dist/api/openapi-schema.js.map +1 -0
  78. package/dist/api/query-parser.d.ts +81 -0
  79. package/dist/api/query-parser.d.ts.map +1 -0
  80. package/dist/api/query-parser.js +232 -0
  81. package/dist/api/query-parser.js.map +1 -0
  82. package/dist/api/route-generator.d.ts +161 -0
  83. package/dist/api/route-generator.d.ts.map +1 -0
  84. package/dist/api/route-generator.js +315 -0
  85. package/dist/api/route-generator.js.map +1 -0
  86. package/dist/api/server.d.ts +8 -0
  87. package/dist/api/server.d.ts.map +1 -0
  88. package/dist/api/server.js +128 -0
  89. package/dist/api/server.js.map +1 -0
  90. package/dist/api/types.d.ts +20 -0
  91. package/dist/api/types.d.ts.map +1 -0
  92. package/dist/api/types.js +2 -0
  93. package/dist/api/types.js.map +1 -0
  94. package/dist/audit/__tests__/audit.test.d.ts +2 -0
  95. package/dist/audit/__tests__/audit.test.d.ts.map +1 -0
  96. package/dist/audit/__tests__/audit.test.js +127 -0
  97. package/dist/audit/__tests__/audit.test.js.map +1 -0
  98. package/dist/audit/index.d.ts +4 -0
  99. package/dist/audit/index.d.ts.map +1 -0
  100. package/dist/audit/index.js +3 -0
  101. package/dist/audit/index.js.map +1 -0
  102. package/dist/audit/record.d.ts +4 -0
  103. package/dist/audit/record.d.ts.map +1 -0
  104. package/dist/audit/record.js +52 -0
  105. package/dist/audit/record.js.map +1 -0
  106. package/dist/audit/tables.d.ts +3 -0
  107. package/dist/audit/tables.d.ts.map +1 -0
  108. package/dist/audit/tables.js +46 -0
  109. package/dist/audit/tables.js.map +1 -0
  110. package/dist/audit/types.d.ts +27 -0
  111. package/dist/audit/types.d.ts.map +1 -0
  112. package/dist/audit/types.js +2 -0
  113. package/dist/audit/types.js.map +1 -0
  114. package/dist/auth/__tests__/core-module.test.d.ts +2 -0
  115. package/dist/auth/__tests__/core-module.test.d.ts.map +1 -0
  116. package/dist/auth/__tests__/core-module.test.js +49 -0
  117. package/dist/auth/__tests__/core-module.test.js.map +1 -0
  118. package/dist/auth/__tests__/debug.test.d.ts +2 -0
  119. package/dist/auth/__tests__/debug.test.d.ts.map +1 -0
  120. package/dist/auth/__tests__/debug.test.js +42 -0
  121. package/dist/auth/__tests__/debug.test.js.map +1 -0
  122. package/dist/auth/__tests__/field-permissions.test.d.ts +2 -0
  123. package/dist/auth/__tests__/field-permissions.test.d.ts.map +1 -0
  124. package/dist/auth/__tests__/field-permissions.test.js +213 -0
  125. package/dist/auth/__tests__/field-permissions.test.js.map +1 -0
  126. package/dist/auth/__tests__/integration.test.d.ts +2 -0
  127. package/dist/auth/__tests__/integration.test.d.ts.map +1 -0
  128. package/dist/auth/__tests__/integration.test.js +186 -0
  129. package/dist/auth/__tests__/integration.test.js.map +1 -0
  130. package/dist/auth/__tests__/meta-boot.test.d.ts +2 -0
  131. package/dist/auth/__tests__/meta-boot.test.d.ts.map +1 -0
  132. package/dist/auth/__tests__/meta-boot.test.js +459 -0
  133. package/dist/auth/__tests__/meta-boot.test.js.map +1 -0
  134. package/dist/auth/__tests__/model-permissions.test.d.ts +2 -0
  135. package/dist/auth/__tests__/model-permissions.test.d.ts.map +1 -0
  136. package/dist/auth/__tests__/model-permissions.test.js +171 -0
  137. package/dist/auth/__tests__/model-permissions.test.js.map +1 -0
  138. package/dist/auth/__tests__/password.test.d.ts +2 -0
  139. package/dist/auth/__tests__/password.test.d.ts.map +1 -0
  140. package/dist/auth/__tests__/password.test.js +25 -0
  141. package/dist/auth/__tests__/password.test.js.map +1 -0
  142. package/dist/auth/__tests__/permission-registry.test.d.ts +2 -0
  143. package/dist/auth/__tests__/permission-registry.test.d.ts.map +1 -0
  144. package/dist/auth/__tests__/permission-registry.test.js +225 -0
  145. package/dist/auth/__tests__/permission-registry.test.js.map +1 -0
  146. package/dist/auth/__tests__/scope-hook.test.d.ts +2 -0
  147. package/dist/auth/__tests__/scope-hook.test.d.ts.map +1 -0
  148. package/dist/auth/__tests__/scope-hook.test.js +429 -0
  149. package/dist/auth/__tests__/scope-hook.test.js.map +1 -0
  150. package/dist/auth/__tests__/scope-registry.test.d.ts +2 -0
  151. package/dist/auth/__tests__/scope-registry.test.d.ts.map +1 -0
  152. package/dist/auth/__tests__/scope-registry.test.js +261 -0
  153. package/dist/auth/__tests__/scope-registry.test.js.map +1 -0
  154. package/dist/auth/__tests__/scopes.test.d.ts +2 -0
  155. package/dist/auth/__tests__/scopes.test.d.ts.map +1 -0
  156. package/dist/auth/__tests__/scopes.test.js +57 -0
  157. package/dist/auth/__tests__/scopes.test.js.map +1 -0
  158. package/dist/auth/__tests__/session.test.d.ts +2 -0
  159. package/dist/auth/__tests__/session.test.d.ts.map +1 -0
  160. package/dist/auth/__tests__/session.test.js +199 -0
  161. package/dist/auth/__tests__/session.test.js.map +1 -0
  162. package/dist/auth/core-models.d.ts +110 -0
  163. package/dist/auth/core-models.d.ts.map +1 -0
  164. package/dist/auth/core-models.js +48 -0
  165. package/dist/auth/core-models.js.map +1 -0
  166. package/dist/auth/core-module.d.ts +5 -0
  167. package/dist/auth/core-module.d.ts.map +1 -0
  168. package/dist/auth/core-module.js +48 -0
  169. package/dist/auth/core-module.js.map +1 -0
  170. package/dist/auth/debug.d.ts +20 -0
  171. package/dist/auth/debug.d.ts.map +1 -0
  172. package/dist/auth/debug.js +118 -0
  173. package/dist/auth/debug.js.map +1 -0
  174. package/dist/auth/field-permissions.d.ts +11 -0
  175. package/dist/auth/field-permissions.d.ts.map +1 -0
  176. package/dist/auth/field-permissions.js +82 -0
  177. package/dist/auth/field-permissions.js.map +1 -0
  178. package/dist/auth/index.d.ts +15 -0
  179. package/dist/auth/index.d.ts.map +1 -0
  180. package/dist/auth/index.js +12 -0
  181. package/dist/auth/index.js.map +1 -0
  182. package/dist/auth/model-permissions.d.ts +8 -0
  183. package/dist/auth/model-permissions.d.ts.map +1 -0
  184. package/dist/auth/model-permissions.js +35 -0
  185. package/dist/auth/model-permissions.js.map +1 -0
  186. package/dist/auth/password.d.ts +3 -0
  187. package/dist/auth/password.d.ts.map +1 -0
  188. package/dist/auth/password.js +19 -0
  189. package/dist/auth/password.js.map +1 -0
  190. package/dist/auth/permission-registry.d.ts +27 -0
  191. package/dist/auth/permission-registry.d.ts.map +1 -0
  192. package/dist/auth/permission-registry.js +148 -0
  193. package/dist/auth/permission-registry.js.map +1 -0
  194. package/dist/auth/scope-filters.d.ts +3 -0
  195. package/dist/auth/scope-filters.d.ts.map +1 -0
  196. package/dist/auth/scope-filters.js +9 -0
  197. package/dist/auth/scope-filters.js.map +1 -0
  198. package/dist/auth/scope-registry.d.ts +31 -0
  199. package/dist/auth/scope-registry.d.ts.map +1 -0
  200. package/dist/auth/scope-registry.js +78 -0
  201. package/dist/auth/scope-registry.js.map +1 -0
  202. package/dist/auth/scopes.d.ts +16 -0
  203. package/dist/auth/scopes.d.ts.map +1 -0
  204. package/dist/auth/scopes.js +93 -0
  205. package/dist/auth/scopes.js.map +1 -0
  206. package/dist/auth/seed.d.ts +3 -0
  207. package/dist/auth/seed.d.ts.map +1 -0
  208. package/dist/auth/seed.js +40 -0
  209. package/dist/auth/seed.js.map +1 -0
  210. package/dist/auth/session.d.ts +15 -0
  211. package/dist/auth/session.d.ts.map +1 -0
  212. package/dist/auth/session.js +138 -0
  213. package/dist/auth/session.js.map +1 -0
  214. package/dist/auth/types.d.ts +44 -0
  215. package/dist/auth/types.d.ts.map +1 -0
  216. package/dist/auth/types.js +2 -0
  217. package/dist/auth/types.js.map +1 -0
  218. package/dist/boot/__tests__/page-scanning.test.d.ts +2 -0
  219. package/dist/boot/__tests__/page-scanning.test.d.ts.map +1 -0
  220. package/dist/boot/__tests__/page-scanning.test.js +144 -0
  221. package/dist/boot/__tests__/page-scanning.test.js.map +1 -0
  222. package/dist/boot/__tests__/page-utils.test.d.ts +2 -0
  223. package/dist/boot/__tests__/page-utils.test.d.ts.map +1 -0
  224. package/dist/boot/__tests__/page-utils.test.js +204 -0
  225. package/dist/boot/__tests__/page-utils.test.js.map +1 -0
  226. package/dist/boot/__tests__/project-scanner.test.d.ts +2 -0
  227. package/dist/boot/__tests__/project-scanner.test.d.ts.map +1 -0
  228. package/dist/boot/__tests__/project-scanner.test.js +71 -0
  229. package/dist/boot/__tests__/project-scanner.test.js.map +1 -0
  230. package/dist/boot/dependency-sort.d.ts +3 -0
  231. package/dist/boot/dependency-sort.d.ts.map +1 -0
  232. package/dist/boot/dependency-sort.js +63 -0
  233. package/dist/boot/dependency-sort.js.map +1 -0
  234. package/dist/boot/discovery.d.ts +14 -0
  235. package/dist/boot/discovery.d.ts.map +1 -0
  236. package/dist/boot/discovery.js +80 -0
  237. package/dist/boot/discovery.js.map +1 -0
  238. package/dist/boot/index.d.ts +68 -0
  239. package/dist/boot/index.d.ts.map +1 -0
  240. package/dist/boot/index.js +309 -0
  241. package/dist/boot/index.js.map +1 -0
  242. package/dist/boot/page-utils.d.ts +24 -0
  243. package/dist/boot/page-utils.d.ts.map +1 -0
  244. package/dist/boot/page-utils.js +77 -0
  245. package/dist/boot/page-utils.js.map +1 -0
  246. package/dist/boot/project-scanner.d.ts +69 -0
  247. package/dist/boot/project-scanner.d.ts.map +1 -0
  248. package/dist/boot/project-scanner.js +293 -0
  249. package/dist/boot/project-scanner.js.map +1 -0
  250. package/dist/boot/schema-loader.d.ts +16 -0
  251. package/dist/boot/schema-loader.d.ts.map +1 -0
  252. package/dist/boot/schema-loader.js +15 -0
  253. package/dist/boot/schema-loader.js.map +1 -0
  254. package/dist/boot/schema-merger.d.ts +12 -0
  255. package/dist/boot/schema-merger.d.ts.map +1 -0
  256. package/dist/boot/schema-merger.js +93 -0
  257. package/dist/boot/schema-merger.js.map +1 -0
  258. package/dist/boot/traits.d.ts +6 -0
  259. package/dist/boot/traits.d.ts.map +1 -0
  260. package/dist/boot/traits.js +17 -0
  261. package/dist/boot/traits.js.map +1 -0
  262. package/dist/boot/types.d.ts +65 -0
  263. package/dist/boot/types.d.ts.map +1 -0
  264. package/dist/boot/types.js +33 -0
  265. package/dist/boot/types.js.map +1 -0
  266. package/dist/context.d.ts +34 -0
  267. package/dist/context.d.ts.map +1 -0
  268. package/dist/context.js +70 -0
  269. package/dist/context.js.map +1 -0
  270. package/dist/db/__tests__/cascade-delete.test.d.ts +2 -0
  271. package/dist/db/__tests__/cascade-delete.test.d.ts.map +1 -0
  272. package/dist/db/__tests__/cascade-delete.test.js +136 -0
  273. package/dist/db/__tests__/cascade-delete.test.js.map +1 -0
  274. package/dist/db/__tests__/desired-state.test.d.ts +2 -0
  275. package/dist/db/__tests__/desired-state.test.d.ts.map +1 -0
  276. package/dist/db/__tests__/desired-state.test.js +119 -0
  277. package/dist/db/__tests__/desired-state.test.js.map +1 -0
  278. package/dist/db/__tests__/diff-engine.test.d.ts +2 -0
  279. package/dist/db/__tests__/diff-engine.test.d.ts.map +1 -0
  280. package/dist/db/__tests__/diff-engine.test.js +600 -0
  281. package/dist/db/__tests__/diff-engine.test.js.map +1 -0
  282. package/dist/db/__tests__/field-mapper.test.d.ts +2 -0
  283. package/dist/db/__tests__/field-mapper.test.d.ts.map +1 -0
  284. package/dist/db/__tests__/field-mapper.test.js +320 -0
  285. package/dist/db/__tests__/field-mapper.test.js.map +1 -0
  286. package/dist/db/__tests__/introspect.test.d.ts +2 -0
  287. package/dist/db/__tests__/introspect.test.d.ts.map +1 -0
  288. package/dist/db/__tests__/introspect.test.js +64 -0
  289. package/dist/db/__tests__/introspect.test.js.map +1 -0
  290. package/dist/db/__tests__/search-filter.test.d.ts +2 -0
  291. package/dist/db/__tests__/search-filter.test.d.ts.map +1 -0
  292. package/dist/db/__tests__/search-filter.test.js +41 -0
  293. package/dist/db/__tests__/search-filter.test.js.map +1 -0
  294. package/dist/db/__tests__/sequence.test.d.ts +2 -0
  295. package/dist/db/__tests__/sequence.test.d.ts.map +1 -0
  296. package/dist/db/__tests__/sequence.test.js +183 -0
  297. package/dist/db/__tests__/sequence.test.js.map +1 -0
  298. package/dist/db/auto-sync.d.ts +16 -0
  299. package/dist/db/auto-sync.d.ts.map +1 -0
  300. package/dist/db/auto-sync.js +104 -0
  301. package/dist/db/auto-sync.js.map +1 -0
  302. package/dist/db/client.d.ts +45 -0
  303. package/dist/db/client.d.ts.map +1 -0
  304. package/dist/db/client.js +116 -0
  305. package/dist/db/client.js.map +1 -0
  306. package/dist/db/desired-state.d.ts +19 -0
  307. package/dist/db/desired-state.d.ts.map +1 -0
  308. package/dist/db/desired-state.js +82 -0
  309. package/dist/db/desired-state.js.map +1 -0
  310. package/dist/db/diff-engine.d.ts +53 -0
  311. package/dist/db/diff-engine.d.ts.map +1 -0
  312. package/dist/db/diff-engine.js +234 -0
  313. package/dist/db/diff-engine.js.map +1 -0
  314. package/dist/db/field-mapper.d.ts +22 -0
  315. package/dist/db/field-mapper.d.ts.map +1 -0
  316. package/dist/db/field-mapper.js +395 -0
  317. package/dist/db/field-mapper.js.map +1 -0
  318. package/dist/db/filter-applier.d.ts +4 -0
  319. package/dist/db/filter-applier.d.ts.map +1 -0
  320. package/dist/db/filter-applier.js +86 -0
  321. package/dist/db/filter-applier.js.map +1 -0
  322. package/dist/db/include-resolver.d.ts +20 -0
  323. package/dist/db/include-resolver.d.ts.map +1 -0
  324. package/dist/db/include-resolver.js +21 -0
  325. package/dist/db/include-resolver.js.map +1 -0
  326. package/dist/db/index.d.ts +16 -0
  327. package/dist/db/index.d.ts.map +1 -0
  328. package/dist/db/index.js +11 -0
  329. package/dist/db/index.js.map +1 -0
  330. package/dist/db/introspect.d.ts +9 -0
  331. package/dist/db/introspect.d.ts.map +1 -0
  332. package/dist/db/introspect.js +194 -0
  333. package/dist/db/introspect.js.map +1 -0
  334. package/dist/db/model-include-resolver.d.ts +14 -0
  335. package/dist/db/model-include-resolver.d.ts.map +1 -0
  336. package/dist/db/model-include-resolver.js +232 -0
  337. package/dist/db/model-include-resolver.js.map +1 -0
  338. package/dist/db/model-ops.d.ts +46 -0
  339. package/dist/db/model-ops.d.ts.map +1 -0
  340. package/dist/db/model-ops.js +220 -0
  341. package/dist/db/model-ops.js.map +1 -0
  342. package/dist/db/scope-enforcer.d.ts +8 -0
  343. package/dist/db/scope-enforcer.d.ts.map +1 -0
  344. package/dist/db/scope-enforcer.js +22 -0
  345. package/dist/db/scope-enforcer.js.map +1 -0
  346. package/dist/db/types.d.ts +76 -0
  347. package/dist/db/types.d.ts.map +1 -0
  348. package/dist/db/types.js +2 -0
  349. package/dist/db/types.js.map +1 -0
  350. package/dist/errors.d.ts +19 -0
  351. package/dist/errors.d.ts.map +1 -0
  352. package/dist/errors.js +37 -0
  353. package/dist/errors.js.map +1 -0
  354. package/dist/events/__tests__/bus.test.d.ts +2 -0
  355. package/dist/events/__tests__/bus.test.d.ts.map +1 -0
  356. package/dist/events/__tests__/bus.test.js +83 -0
  357. package/dist/events/__tests__/bus.test.js.map +1 -0
  358. package/dist/events/bus.d.ts +40 -0
  359. package/dist/events/bus.d.ts.map +1 -0
  360. package/dist/events/bus.js +74 -0
  361. package/dist/events/bus.js.map +1 -0
  362. package/dist/events/index.d.ts +3 -0
  363. package/dist/events/index.d.ts.map +1 -0
  364. package/dist/events/index.js +2 -0
  365. package/dist/events/index.js.map +1 -0
  366. package/dist/events/types.d.ts +9 -0
  367. package/dist/events/types.d.ts.map +1 -0
  368. package/dist/events/types.js +2 -0
  369. package/dist/events/types.js.map +1 -0
  370. package/dist/external-model/__tests__/computed-fields.test.d.ts +2 -0
  371. package/dist/external-model/__tests__/computed-fields.test.d.ts.map +1 -0
  372. package/dist/external-model/__tests__/computed-fields.test.js +94 -0
  373. package/dist/external-model/__tests__/computed-fields.test.js.map +1 -0
  374. package/dist/external-model/__tests__/field-mapper.test.d.ts +2 -0
  375. package/dist/external-model/__tests__/field-mapper.test.d.ts.map +1 -0
  376. package/dist/external-model/__tests__/field-mapper.test.js +132 -0
  377. package/dist/external-model/__tests__/field-mapper.test.js.map +1 -0
  378. package/dist/external-model/__tests__/in-memory-ops.test.d.ts +2 -0
  379. package/dist/external-model/__tests__/in-memory-ops.test.d.ts.map +1 -0
  380. package/dist/external-model/__tests__/in-memory-ops.test.js +209 -0
  381. package/dist/external-model/__tests__/in-memory-ops.test.js.map +1 -0
  382. package/dist/external-model/__tests__/mutation-executor.test.d.ts +2 -0
  383. package/dist/external-model/__tests__/mutation-executor.test.d.ts.map +1 -0
  384. package/dist/external-model/__tests__/mutation-executor.test.js +135 -0
  385. package/dist/external-model/__tests__/mutation-executor.test.js.map +1 -0
  386. package/dist/external-model/__tests__/query-executor.test.d.ts +2 -0
  387. package/dist/external-model/__tests__/query-executor.test.d.ts.map +1 -0
  388. package/dist/external-model/__tests__/query-executor.test.js +241 -0
  389. package/dist/external-model/__tests__/query-executor.test.js.map +1 -0
  390. package/dist/external-model/__tests__/schema-converter.test.d.ts +2 -0
  391. package/dist/external-model/__tests__/schema-converter.test.d.ts.map +1 -0
  392. package/dist/external-model/__tests__/schema-converter.test.js +152 -0
  393. package/dist/external-model/__tests__/schema-converter.test.js.map +1 -0
  394. package/dist/external-model/computed-fields.d.ts +3 -0
  395. package/dist/external-model/computed-fields.d.ts.map +1 -0
  396. package/dist/external-model/computed-fields.js +10 -0
  397. package/dist/external-model/computed-fields.js.map +1 -0
  398. package/dist/external-model/define.d.ts +3 -0
  399. package/dist/external-model/define.d.ts.map +1 -0
  400. package/dist/external-model/define.js +4 -0
  401. package/dist/external-model/define.js.map +1 -0
  402. package/dist/external-model/external-model-ops.d.ts +27 -0
  403. package/dist/external-model/external-model-ops.d.ts.map +1 -0
  404. package/dist/external-model/external-model-ops.js +80 -0
  405. package/dist/external-model/external-model-ops.js.map +1 -0
  406. package/dist/external-model/field-mapper.d.ts +5 -0
  407. package/dist/external-model/field-mapper.d.ts.map +1 -0
  408. package/dist/external-model/field-mapper.js +49 -0
  409. package/dist/external-model/field-mapper.js.map +1 -0
  410. package/dist/external-model/in-memory-ops.d.ts +8 -0
  411. package/dist/external-model/in-memory-ops.d.ts.map +1 -0
  412. package/dist/external-model/in-memory-ops.js +97 -0
  413. package/dist/external-model/in-memory-ops.js.map +1 -0
  414. package/dist/external-model/index.d.ts +8 -0
  415. package/dist/external-model/index.d.ts.map +1 -0
  416. package/dist/external-model/index.js +6 -0
  417. package/dist/external-model/index.js.map +1 -0
  418. package/dist/external-model/mutation-executor.d.ts +27 -0
  419. package/dist/external-model/mutation-executor.d.ts.map +1 -0
  420. package/dist/external-model/mutation-executor.js +53 -0
  421. package/dist/external-model/mutation-executor.js.map +1 -0
  422. package/dist/external-model/query-executor.d.ts +37 -0
  423. package/dist/external-model/query-executor.d.ts.map +1 -0
  424. package/dist/external-model/query-executor.js +61 -0
  425. package/dist/external-model/query-executor.js.map +1 -0
  426. package/dist/external-model/schema-converter.d.ts +8 -0
  427. package/dist/external-model/schema-converter.d.ts.map +1 -0
  428. package/dist/external-model/schema-converter.js +38 -0
  429. package/dist/external-model/schema-converter.js.map +1 -0
  430. package/dist/external-model/types.d.ts +29 -0
  431. package/dist/external-model/types.d.ts.map +1 -0
  432. package/dist/external-model/types.js +2 -0
  433. package/dist/external-model/types.js.map +1 -0
  434. package/dist/fixtures/__tests__/fixtures.test.d.ts +2 -0
  435. package/dist/fixtures/__tests__/fixtures.test.d.ts.map +1 -0
  436. package/dist/fixtures/__tests__/fixtures.test.js +180 -0
  437. package/dist/fixtures/__tests__/fixtures.test.js.map +1 -0
  438. package/dist/fixtures/index.d.ts +4 -0
  439. package/dist/fixtures/index.d.ts.map +1 -0
  440. package/dist/fixtures/index.js +3 -0
  441. package/dist/fixtures/index.js.map +1 -0
  442. package/dist/fixtures/loader.d.ts +11 -0
  443. package/dist/fixtures/loader.d.ts.map +1 -0
  444. package/dist/fixtures/loader.js +157 -0
  445. package/dist/fixtures/loader.js.map +1 -0
  446. package/dist/fixtures/registry.d.ts +27 -0
  447. package/dist/fixtures/registry.d.ts.map +1 -0
  448. package/dist/fixtures/registry.js +103 -0
  449. package/dist/fixtures/registry.js.map +1 -0
  450. package/dist/fixtures/types.d.ts +29 -0
  451. package/dist/fixtures/types.d.ts.map +1 -0
  452. package/dist/fixtures/types.js +2 -0
  453. package/dist/fixtures/types.js.map +1 -0
  454. package/dist/helpers/assert-ownership.d.ts +4 -0
  455. package/dist/helpers/assert-ownership.d.ts.map +1 -0
  456. package/dist/helpers/assert-ownership.js +11 -0
  457. package/dist/helpers/assert-ownership.js.map +1 -0
  458. package/dist/helpers/coerce.d.ts +9 -0
  459. package/dist/helpers/coerce.d.ts.map +1 -0
  460. package/dist/helpers/coerce.js +28 -0
  461. package/dist/helpers/coerce.js.map +1 -0
  462. package/dist/helpers/stamping.d.ts +12 -0
  463. package/dist/helpers/stamping.d.ts.map +1 -0
  464. package/dist/helpers/stamping.js +20 -0
  465. package/dist/helpers/stamping.js.map +1 -0
  466. package/dist/helpers/validation.d.ts +3 -0
  467. package/dist/helpers/validation.d.ts.map +1 -0
  468. package/dist/helpers/validation.js +10 -0
  469. package/dist/helpers/validation.js.map +1 -0
  470. package/dist/hooks/__tests__/context.test.d.ts +2 -0
  471. package/dist/hooks/__tests__/context.test.d.ts.map +1 -0
  472. package/dist/hooks/__tests__/context.test.js +62 -0
  473. package/dist/hooks/__tests__/context.test.js.map +1 -0
  474. package/dist/hooks/__tests__/executor.test.d.ts +2 -0
  475. package/dist/hooks/__tests__/executor.test.d.ts.map +1 -0
  476. package/dist/hooks/__tests__/executor.test.js +339 -0
  477. package/dist/hooks/__tests__/executor.test.js.map +1 -0
  478. package/dist/hooks/__tests__/middleware.test.d.ts +2 -0
  479. package/dist/hooks/__tests__/middleware.test.d.ts.map +1 -0
  480. package/dist/hooks/__tests__/middleware.test.js +187 -0
  481. package/dist/hooks/__tests__/middleware.test.js.map +1 -0
  482. package/dist/hooks/__tests__/registry.test.d.ts +2 -0
  483. package/dist/hooks/__tests__/registry.test.d.ts.map +1 -0
  484. package/dist/hooks/__tests__/registry.test.js +42 -0
  485. package/dist/hooks/__tests__/registry.test.js.map +1 -0
  486. package/dist/hooks/context.d.ts +20 -0
  487. package/dist/hooks/context.d.ts.map +1 -0
  488. package/dist/hooks/context.js +62 -0
  489. package/dist/hooks/context.js.map +1 -0
  490. package/dist/hooks/errors.d.ts +6 -0
  491. package/dist/hooks/errors.d.ts.map +1 -0
  492. package/dist/hooks/errors.js +11 -0
  493. package/dist/hooks/errors.js.map +1 -0
  494. package/dist/hooks/executor.d.ts +27 -0
  495. package/dist/hooks/executor.d.ts.map +1 -0
  496. package/dist/hooks/executor.js +72 -0
  497. package/dist/hooks/executor.js.map +1 -0
  498. package/dist/hooks/index.d.ts +7 -0
  499. package/dist/hooks/index.d.ts.map +1 -0
  500. package/dist/hooks/index.js +6 -0
  501. package/dist/hooks/index.js.map +1 -0
  502. package/dist/hooks/middleware.d.ts +23 -0
  503. package/dist/hooks/middleware.d.ts.map +1 -0
  504. package/dist/hooks/middleware.js +137 -0
  505. package/dist/hooks/middleware.js.map +1 -0
  506. package/dist/hooks/registry.d.ts +9 -0
  507. package/dist/hooks/registry.d.ts.map +1 -0
  508. package/dist/hooks/registry.js +15 -0
  509. package/dist/hooks/registry.js.map +1 -0
  510. package/dist/hooks/types.d.ts +12 -0
  511. package/dist/hooks/types.d.ts.map +1 -0
  512. package/dist/hooks/types.js +2 -0
  513. package/dist/hooks/types.js.map +1 -0
  514. package/dist/index.d.ts +72 -0
  515. package/dist/index.d.ts.map +1 -0
  516. package/dist/index.js +61 -0
  517. package/dist/index.js.map +1 -0
  518. package/dist/jobs/__tests__/enqueue.test.d.ts +2 -0
  519. package/dist/jobs/__tests__/enqueue.test.d.ts.map +1 -0
  520. package/dist/jobs/__tests__/enqueue.test.js +69 -0
  521. package/dist/jobs/__tests__/enqueue.test.js.map +1 -0
  522. package/dist/jobs/__tests__/integration.test.d.ts +2 -0
  523. package/dist/jobs/__tests__/integration.test.d.ts.map +1 -0
  524. package/dist/jobs/__tests__/integration.test.js +52 -0
  525. package/dist/jobs/__tests__/integration.test.js.map +1 -0
  526. package/dist/jobs/__tests__/registry.test.d.ts +2 -0
  527. package/dist/jobs/__tests__/registry.test.d.ts.map +1 -0
  528. package/dist/jobs/__tests__/registry.test.js +65 -0
  529. package/dist/jobs/__tests__/registry.test.js.map +1 -0
  530. package/dist/jobs/__tests__/scheduler.test.d.ts +2 -0
  531. package/dist/jobs/__tests__/scheduler.test.d.ts.map +1 -0
  532. package/dist/jobs/__tests__/scheduler.test.js +79 -0
  533. package/dist/jobs/__tests__/scheduler.test.js.map +1 -0
  534. package/dist/jobs/__tests__/worker-execution.test.d.ts +2 -0
  535. package/dist/jobs/__tests__/worker-execution.test.d.ts.map +1 -0
  536. package/dist/jobs/__tests__/worker-execution.test.js +171 -0
  537. package/dist/jobs/__tests__/worker-execution.test.js.map +1 -0
  538. package/dist/jobs/__tests__/worker.test.d.ts +2 -0
  539. package/dist/jobs/__tests__/worker.test.d.ts.map +1 -0
  540. package/dist/jobs/__tests__/worker.test.js +97 -0
  541. package/dist/jobs/__tests__/worker.test.js.map +1 -0
  542. package/dist/jobs/enqueue.d.ts +13 -0
  543. package/dist/jobs/enqueue.d.ts.map +1 -0
  544. package/dist/jobs/enqueue.js +58 -0
  545. package/dist/jobs/enqueue.js.map +1 -0
  546. package/dist/jobs/index.d.ts +6 -0
  547. package/dist/jobs/index.d.ts.map +1 -0
  548. package/dist/jobs/index.js +5 -0
  549. package/dist/jobs/index.js.map +1 -0
  550. package/dist/jobs/registry.d.ts +23 -0
  551. package/dist/jobs/registry.d.ts.map +1 -0
  552. package/dist/jobs/registry.js +72 -0
  553. package/dist/jobs/registry.js.map +1 -0
  554. package/dist/jobs/scheduler.d.ts +51 -0
  555. package/dist/jobs/scheduler.d.ts.map +1 -0
  556. package/dist/jobs/scheduler.js +172 -0
  557. package/dist/jobs/scheduler.js.map +1 -0
  558. package/dist/jobs/tables.d.ts +3 -0
  559. package/dist/jobs/tables.d.ts.map +1 -0
  560. package/dist/jobs/tables.js +128 -0
  561. package/dist/jobs/tables.js.map +1 -0
  562. package/dist/jobs/types.d.ts +55 -0
  563. package/dist/jobs/types.d.ts.map +1 -0
  564. package/dist/jobs/types.js +2 -0
  565. package/dist/jobs/types.js.map +1 -0
  566. package/dist/jobs/worker.d.ts +55 -0
  567. package/dist/jobs/worker.d.ts.map +1 -0
  568. package/dist/jobs/worker.js +228 -0
  569. package/dist/jobs/worker.js.map +1 -0
  570. package/dist/model-api/__tests__/cross-boundary-includes.test.d.ts +2 -0
  571. package/dist/model-api/__tests__/cross-boundary-includes.test.d.ts.map +1 -0
  572. package/dist/model-api/__tests__/cross-boundary-includes.test.js +299 -0
  573. package/dist/model-api/__tests__/cross-boundary-includes.test.js.map +1 -0
  574. package/dist/model-api/__tests__/extended-api.test.d.ts +2 -0
  575. package/dist/model-api/__tests__/extended-api.test.d.ts.map +1 -0
  576. package/dist/model-api/__tests__/extended-api.test.js +219 -0
  577. package/dist/model-api/__tests__/extended-api.test.js.map +1 -0
  578. package/dist/model-api/__tests__/filter-applier.test.d.ts +2 -0
  579. package/dist/model-api/__tests__/filter-applier.test.d.ts.map +1 -0
  580. package/dist/model-api/__tests__/filter-applier.test.js +150 -0
  581. package/dist/model-api/__tests__/filter-applier.test.js.map +1 -0
  582. package/dist/model-api/__tests__/filter-translator.test.d.ts +2 -0
  583. package/dist/model-api/__tests__/filter-translator.test.d.ts.map +1 -0
  584. package/dist/model-api/__tests__/filter-translator.test.js +157 -0
  585. package/dist/model-api/__tests__/filter-translator.test.js.map +1 -0
  586. package/dist/model-api/__tests__/include-resolver.test.d.ts +2 -0
  587. package/dist/model-api/__tests__/include-resolver.test.d.ts.map +1 -0
  588. package/dist/model-api/__tests__/include-resolver.test.js +193 -0
  589. package/dist/model-api/__tests__/include-resolver.test.js.map +1 -0
  590. package/dist/model-api/__tests__/model-access.test.d.ts +2 -0
  591. package/dist/model-api/__tests__/model-access.test.d.ts.map +1 -0
  592. package/dist/model-api/__tests__/model-access.test.js +242 -0
  593. package/dist/model-api/__tests__/model-access.test.js.map +1 -0
  594. package/dist/model-api/__tests__/query-builder.test.d.ts +2 -0
  595. package/dist/model-api/__tests__/query-builder.test.d.ts.map +1 -0
  596. package/dist/model-api/__tests__/query-builder.test.js +190 -0
  597. package/dist/model-api/__tests__/query-builder.test.js.map +1 -0
  598. package/dist/model-api/__tests__/scope-enforcer.test.d.ts +2 -0
  599. package/dist/model-api/__tests__/scope-enforcer.test.d.ts.map +1 -0
  600. package/dist/model-api/__tests__/scope-enforcer.test.js +221 -0
  601. package/dist/model-api/__tests__/scope-enforcer.test.js.map +1 -0
  602. package/dist/model-api/field-access.d.ts +3 -0
  603. package/dist/model-api/field-access.d.ts.map +1 -0
  604. package/dist/model-api/field-access.js +25 -0
  605. package/dist/model-api/field-access.js.map +1 -0
  606. package/dist/model-api/filter-applier.d.ts +2 -0
  607. package/dist/model-api/filter-applier.d.ts.map +1 -0
  608. package/dist/model-api/filter-applier.js +2 -0
  609. package/dist/model-api/filter-applier.js.map +1 -0
  610. package/dist/model-api/filter-translator.d.ts +4 -0
  611. package/dist/model-api/filter-translator.d.ts.map +1 -0
  612. package/dist/model-api/filter-translator.js +61 -0
  613. package/dist/model-api/filter-translator.js.map +1 -0
  614. package/dist/model-api/include-resolver.d.ts +3 -0
  615. package/dist/model-api/include-resolver.d.ts.map +1 -0
  616. package/dist/model-api/include-resolver.js +2 -0
  617. package/dist/model-api/include-resolver.js.map +1 -0
  618. package/dist/model-api/index.d.ts +10 -0
  619. package/dist/model-api/index.d.ts.map +1 -0
  620. package/dist/model-api/index.js +63 -0
  621. package/dist/model-api/index.js.map +1 -0
  622. package/dist/model-api/query-builder.d.ts +35 -0
  623. package/dist/model-api/query-builder.d.ts.map +1 -0
  624. package/dist/model-api/query-builder.js +106 -0
  625. package/dist/model-api/query-builder.js.map +1 -0
  626. package/dist/model-api/scope-enforcer.d.ts +4 -0
  627. package/dist/model-api/scope-enforcer.d.ts.map +1 -0
  628. package/dist/model-api/scope-enforcer.js +3 -0
  629. package/dist/model-api/scope-enforcer.js.map +1 -0
  630. package/dist/model-api/types.d.ts +113 -0
  631. package/dist/model-api/types.d.ts.map +1 -0
  632. package/dist/model-api/types.js +2 -0
  633. package/dist/model-api/types.js.map +1 -0
  634. package/dist/plugins/__tests__/adapter-registry.test.d.ts +2 -0
  635. package/dist/plugins/__tests__/adapter-registry.test.d.ts.map +1 -0
  636. package/dist/plugins/__tests__/adapter-registry.test.js +75 -0
  637. package/dist/plugins/__tests__/adapter-registry.test.js.map +1 -0
  638. package/dist/plugins/__tests__/lifecycle.test.d.ts +2 -0
  639. package/dist/plugins/__tests__/lifecycle.test.d.ts.map +1 -0
  640. package/dist/plugins/__tests__/lifecycle.test.js +81 -0
  641. package/dist/plugins/__tests__/lifecycle.test.js.map +1 -0
  642. package/dist/plugins/__tests__/loader.test.d.ts +2 -0
  643. package/dist/plugins/__tests__/loader.test.d.ts.map +1 -0
  644. package/dist/plugins/__tests__/loader.test.js +227 -0
  645. package/dist/plugins/__tests__/loader.test.js.map +1 -0
  646. package/dist/plugins/__tests__/validator.test.d.ts +2 -0
  647. package/dist/plugins/__tests__/validator.test.d.ts.map +1 -0
  648. package/dist/plugins/__tests__/validator.test.js +227 -0
  649. package/dist/plugins/__tests__/validator.test.js.map +1 -0
  650. package/dist/plugins/adapter-registry.d.ts +20 -0
  651. package/dist/plugins/adapter-registry.d.ts.map +1 -0
  652. package/dist/plugins/adapter-registry.js +39 -0
  653. package/dist/plugins/adapter-registry.js.map +1 -0
  654. package/dist/plugins/define.d.ts +3 -0
  655. package/dist/plugins/define.d.ts.map +1 -0
  656. package/dist/plugins/define.js +4 -0
  657. package/dist/plugins/define.js.map +1 -0
  658. package/dist/plugins/index.d.ts +8 -0
  659. package/dist/plugins/index.d.ts.map +1 -0
  660. package/dist/plugins/index.js +6 -0
  661. package/dist/plugins/index.js.map +1 -0
  662. package/dist/plugins/lifecycle.d.ts +9 -0
  663. package/dist/plugins/lifecycle.d.ts.map +1 -0
  664. package/dist/plugins/lifecycle.js +23 -0
  665. package/dist/plugins/lifecycle.js.map +1 -0
  666. package/dist/plugins/loader.d.ts +27 -0
  667. package/dist/plugins/loader.d.ts.map +1 -0
  668. package/dist/plugins/loader.js +96 -0
  669. package/dist/plugins/loader.js.map +1 -0
  670. package/dist/plugins/types.d.ts +57 -0
  671. package/dist/plugins/types.d.ts.map +1 -0
  672. package/dist/plugins/types.js +3 -0
  673. package/dist/plugins/types.js.map +1 -0
  674. package/dist/plugins/validator.d.ts +16 -0
  675. package/dist/plugins/validator.d.ts.map +1 -0
  676. package/dist/plugins/validator.js +92 -0
  677. package/dist/plugins/validator.js.map +1 -0
  678. package/dist/schema/__tests__/registry-models-by-module.test.d.ts +2 -0
  679. package/dist/schema/__tests__/registry-models-by-module.test.d.ts.map +1 -0
  680. package/dist/schema/__tests__/registry-models-by-module.test.js +52 -0
  681. package/dist/schema/__tests__/registry-models-by-module.test.js.map +1 -0
  682. package/dist/schema/registry.d.ts +30 -0
  683. package/dist/schema/registry.d.ts.map +1 -0
  684. package/dist/schema/registry.js +81 -0
  685. package/dist/schema/registry.js.map +1 -0
  686. package/dist/schema/relationships.d.ts +6 -0
  687. package/dist/schema/relationships.d.ts.map +1 -0
  688. package/dist/schema/relationships.js +81 -0
  689. package/dist/schema/relationships.js.map +1 -0
  690. package/dist/schema/types.d.ts +39 -0
  691. package/dist/schema/types.d.ts.map +1 -0
  692. package/dist/schema/types.js +2 -0
  693. package/dist/schema/types.js.map +1 -0
  694. package/dist/services/__tests__/integration.test.d.ts +2 -0
  695. package/dist/services/__tests__/integration.test.d.ts.map +1 -0
  696. package/dist/services/__tests__/integration.test.js +53 -0
  697. package/dist/services/__tests__/integration.test.js.map +1 -0
  698. package/dist/services/__tests__/registry.test.d.ts +2 -0
  699. package/dist/services/__tests__/registry.test.d.ts.map +1 -0
  700. package/dist/services/__tests__/registry.test.js +143 -0
  701. package/dist/services/__tests__/registry.test.js.map +1 -0
  702. package/dist/services/index.d.ts +3 -0
  703. package/dist/services/index.d.ts.map +1 -0
  704. package/dist/services/index.js +2 -0
  705. package/dist/services/index.js.map +1 -0
  706. package/dist/services/registry.d.ts +48 -0
  707. package/dist/services/registry.d.ts.map +1 -0
  708. package/dist/services/registry.js +133 -0
  709. package/dist/services/registry.js.map +1 -0
  710. package/dist/services/types.d.ts +23 -0
  711. package/dist/services/types.d.ts.map +1 -0
  712. package/dist/services/types.js +2 -0
  713. package/dist/services/types.js.map +1 -0
  714. package/dist/validation/__tests__/field-validator.test.d.ts +2 -0
  715. package/dist/validation/__tests__/field-validator.test.d.ts.map +1 -0
  716. package/dist/validation/__tests__/field-validator.test.js +161 -0
  717. package/dist/validation/__tests__/field-validator.test.js.map +1 -0
  718. package/dist/validation/field-validator.d.ts +8 -0
  719. package/dist/validation/field-validator.d.ts.map +1 -0
  720. package/dist/validation/field-validator.js +85 -0
  721. package/dist/validation/field-validator.js.map +1 -0
  722. package/dist/validation/index.d.ts +2 -0
  723. package/dist/validation/index.d.ts.map +1 -0
  724. package/dist/validation/index.js +2 -0
  725. package/dist/validation/index.js.map +1 -0
  726. package/dist/widgets/index.d.ts +4 -0
  727. package/dist/widgets/index.d.ts.map +1 -0
  728. package/dist/widgets/index.js +3 -0
  729. package/dist/widgets/index.js.map +1 -0
  730. package/dist/widgets/slot-validator.d.ts +8 -0
  731. package/dist/widgets/slot-validator.d.ts.map +1 -0
  732. package/dist/widgets/slot-validator.js +69 -0
  733. package/dist/widgets/slot-validator.js.map +1 -0
  734. package/dist/widgets/widget-registry.d.ts +11 -0
  735. package/dist/widgets/widget-registry.d.ts.map +1 -0
  736. package/dist/widgets/widget-registry.js +25 -0
  737. package/dist/widgets/widget-registry.js.map +1 -0
  738. package/package.json +35 -0
  739. package/src/__tests__/coerce.test.ts +154 -0
  740. package/src/__tests__/context.test.ts +111 -0
  741. package/src/__tests__/helpers.ts +21 -0
  742. package/src/__tests__/index.test.ts +7 -0
  743. package/src/__tests__/widgets.test.ts +197 -0
  744. package/src/api/__tests__/handlers.test.ts +389 -0
  745. package/src/api/__tests__/include-resolver.test.ts +393 -0
  746. package/src/api/__tests__/middleware.test.ts +100 -0
  747. package/src/api/__tests__/openapi-schema.test.ts +210 -0
  748. package/src/api/__tests__/query-parser.test.ts +291 -0
  749. package/src/api/__tests__/route-generator.test.ts +137 -0
  750. package/src/api/__tests__/server.test.ts +73 -0
  751. package/src/api/__tests__/swagger.test.ts +166 -0
  752. package/src/api/handlers.ts +274 -0
  753. package/src/api/include-resolver.ts +27 -0
  754. package/src/api/index.ts +4 -0
  755. package/src/api/meta-handler.ts +254 -0
  756. package/src/api/openapi-schema.ts +99 -0
  757. package/src/api/query-parser.ts +315 -0
  758. package/src/api/route-generator.ts +448 -0
  759. package/src/api/server.ts +147 -0
  760. package/src/api/types.ts +16 -0
  761. package/src/audit/__tests__/audit.test.ts +144 -0
  762. package/src/audit/index.ts +3 -0
  763. package/src/audit/record.ts +69 -0
  764. package/src/audit/tables.ts +48 -0
  765. package/src/audit/types.ts +26 -0
  766. package/src/auth/__tests__/core-module.test.ts +54 -0
  767. package/src/auth/__tests__/debug.test.ts +47 -0
  768. package/src/auth/__tests__/field-permissions.test.ts +245 -0
  769. package/src/auth/__tests__/integration.test.ts +208 -0
  770. package/src/auth/__tests__/meta-boot.test.ts +538 -0
  771. package/src/auth/__tests__/model-permissions.test.ts +205 -0
  772. package/src/auth/__tests__/password.test.ts +29 -0
  773. package/src/auth/__tests__/permission-registry.test.ts +313 -0
  774. package/src/auth/__tests__/scope-hook.test.ts +509 -0
  775. package/src/auth/__tests__/scope-registry.test.ts +297 -0
  776. package/src/auth/__tests__/scopes.test.ts +66 -0
  777. package/src/auth/__tests__/session.test.ts +214 -0
  778. package/src/auth/core-models.ts +52 -0
  779. package/src/auth/core-module.ts +59 -0
  780. package/src/auth/debug.ts +157 -0
  781. package/src/auth/field-permissions.ts +116 -0
  782. package/src/auth/index.ts +37 -0
  783. package/src/auth/model-permissions.ts +59 -0
  784. package/src/auth/password.ts +22 -0
  785. package/src/auth/permission-registry.ts +171 -0
  786. package/src/auth/scope-filters.ts +11 -0
  787. package/src/auth/scope-registry.ts +121 -0
  788. package/src/auth/scopes.ts +146 -0
  789. package/src/auth/seed.ts +44 -0
  790. package/src/auth/session.ts +178 -0
  791. package/src/auth/types.ts +50 -0
  792. package/src/boot/__tests__/page-scanning.test.ts +170 -0
  793. package/src/boot/__tests__/page-utils.test.ts +225 -0
  794. package/src/boot/__tests__/project-scanner.test.ts +88 -0
  795. package/src/boot/dependency-sort.ts +82 -0
  796. package/src/boot/discovery.ts +85 -0
  797. package/src/boot/index.ts +457 -0
  798. package/src/boot/page-utils.ts +110 -0
  799. package/src/boot/project-scanner.ts +397 -0
  800. package/src/boot/schema-loader.ts +26 -0
  801. package/src/boot/schema-merger.ts +125 -0
  802. package/src/boot/traits.ts +25 -0
  803. package/src/boot/types.ts +73 -0
  804. package/src/context.ts +105 -0
  805. package/src/db/__tests__/cascade-delete.test.ts +182 -0
  806. package/src/db/__tests__/desired-state.test.ts +136 -0
  807. package/src/db/__tests__/diff-engine.test.ts +635 -0
  808. package/src/db/__tests__/field-mapper.test.ts +355 -0
  809. package/src/db/__tests__/introspect.test.ts +70 -0
  810. package/src/db/__tests__/search-filter.test.ts +45 -0
  811. package/src/db/__tests__/sequence.test.ts +221 -0
  812. package/src/db/auto-sync.ts +133 -0
  813. package/src/db/client.ts +147 -0
  814. package/src/db/desired-state.ts +98 -0
  815. package/src/db/diff-engine.ts +305 -0
  816. package/src/db/field-mapper.ts +504 -0
  817. package/src/db/filter-applier.ts +89 -0
  818. package/src/db/include-resolver.ts +40 -0
  819. package/src/db/index.ts +23 -0
  820. package/src/db/introspect.ts +265 -0
  821. package/src/db/model-include-resolver.ts +327 -0
  822. package/src/db/model-ops.ts +281 -0
  823. package/src/db/scope-enforcer.ts +37 -0
  824. package/src/db/types.ts +98 -0
  825. package/src/errors.ts +41 -0
  826. package/src/events/__tests__/bus.test.ts +105 -0
  827. package/src/events/bus.ts +89 -0
  828. package/src/events/index.ts +2 -0
  829. package/src/events/types.ts +9 -0
  830. package/src/external-model/__tests__/computed-fields.test.ts +106 -0
  831. package/src/external-model/__tests__/field-mapper.test.ts +160 -0
  832. package/src/external-model/__tests__/in-memory-ops.test.ts +247 -0
  833. package/src/external-model/__tests__/mutation-executor.test.ts +160 -0
  834. package/src/external-model/__tests__/query-executor.test.ts +284 -0
  835. package/src/external-model/__tests__/schema-converter.test.ts +174 -0
  836. package/src/external-model/computed-fields.ts +15 -0
  837. package/src/external-model/define.ts +5 -0
  838. package/src/external-model/external-model-ops.ts +108 -0
  839. package/src/external-model/field-mapper.ts +66 -0
  840. package/src/external-model/in-memory-ops.ts +107 -0
  841. package/src/external-model/index.ts +7 -0
  842. package/src/external-model/mutation-executor.ts +71 -0
  843. package/src/external-model/query-executor.ts +100 -0
  844. package/src/external-model/schema-converter.ts +53 -0
  845. package/src/external-model/types.ts +32 -0
  846. package/src/fixtures/__tests__/fixtures.test.ts +203 -0
  847. package/src/fixtures/index.ts +10 -0
  848. package/src/fixtures/loader.ts +196 -0
  849. package/src/fixtures/registry.ts +125 -0
  850. package/src/fixtures/types.ts +33 -0
  851. package/src/helpers/assert-ownership.ts +19 -0
  852. package/src/helpers/coerce.ts +28 -0
  853. package/src/helpers/stamping.ts +28 -0
  854. package/src/helpers/validation.ts +14 -0
  855. package/src/hooks/__tests__/context.test.ts +73 -0
  856. package/src/hooks/__tests__/executor.test.ts +433 -0
  857. package/src/hooks/__tests__/middleware.test.ts +224 -0
  858. package/src/hooks/__tests__/registry.test.ts +50 -0
  859. package/src/hooks/context.ts +89 -0
  860. package/src/hooks/errors.ts +11 -0
  861. package/src/hooks/executor.ts +115 -0
  862. package/src/hooks/index.ts +10 -0
  863. package/src/hooks/middleware.ts +220 -0
  864. package/src/hooks/registry.ts +20 -0
  865. package/src/hooks/types.ts +32 -0
  866. package/src/index.ts +172 -0
  867. package/src/jobs/__tests__/enqueue.test.ts +77 -0
  868. package/src/jobs/__tests__/integration.test.ts +71 -0
  869. package/src/jobs/__tests__/registry.test.ts +103 -0
  870. package/src/jobs/__tests__/scheduler.test.ts +92 -0
  871. package/src/jobs/__tests__/worker-execution.test.ts +202 -0
  872. package/src/jobs/__tests__/worker.test.ts +119 -0
  873. package/src/jobs/enqueue.ts +93 -0
  874. package/src/jobs/index.ts +14 -0
  875. package/src/jobs/registry.ts +92 -0
  876. package/src/jobs/scheduler.ts +205 -0
  877. package/src/jobs/tables.ts +132 -0
  878. package/src/jobs/types.ts +62 -0
  879. package/src/jobs/worker.ts +272 -0
  880. package/src/model-api/__tests__/cross-boundary-includes.test.ts +366 -0
  881. package/src/model-api/__tests__/extended-api.test.ts +244 -0
  882. package/src/model-api/__tests__/filter-applier.test.ts +177 -0
  883. package/src/model-api/__tests__/filter-translator.test.ts +186 -0
  884. package/src/model-api/__tests__/include-resolver.test.ts +226 -0
  885. package/src/model-api/__tests__/model-access.test.ts +284 -0
  886. package/src/model-api/__tests__/query-builder.test.ts +224 -0
  887. package/src/model-api/__tests__/scope-enforcer.test.ts +268 -0
  888. package/src/model-api/field-access.ts +28 -0
  889. package/src/model-api/filter-applier.ts +1 -0
  890. package/src/model-api/filter-translator.ts +67 -0
  891. package/src/model-api/include-resolver.ts +2 -0
  892. package/src/model-api/index.ts +86 -0
  893. package/src/model-api/query-builder.ts +155 -0
  894. package/src/model-api/scope-enforcer.ts +3 -0
  895. package/src/model-api/types.ts +139 -0
  896. package/src/plugins/__tests__/adapter-registry.test.ts +92 -0
  897. package/src/plugins/__tests__/lifecycle.test.ts +96 -0
  898. package/src/plugins/__tests__/loader.test.ts +273 -0
  899. package/src/plugins/__tests__/validator.test.ts +275 -0
  900. package/src/plugins/adapter-registry.ts +42 -0
  901. package/src/plugins/define.ts +5 -0
  902. package/src/plugins/index.ts +28 -0
  903. package/src/plugins/lifecycle.ts +27 -0
  904. package/src/plugins/loader.ts +126 -0
  905. package/src/plugins/types.ts +76 -0
  906. package/src/plugins/validator.ts +141 -0
  907. package/src/schema/__tests__/registry-models-by-module.test.ts +58 -0
  908. package/src/schema/registry.ts +93 -0
  909. package/src/schema/relationships.ts +93 -0
  910. package/src/schema/types.ts +43 -0
  911. package/src/services/__tests__/integration.test.ts +63 -0
  912. package/src/services/__tests__/registry.test.ts +175 -0
  913. package/src/services/index.ts +13 -0
  914. package/src/services/registry.ts +156 -0
  915. package/src/services/types.ts +27 -0
  916. package/src/validation/__tests__/field-validator.test.ts +195 -0
  917. package/src/validation/field-validator.ts +113 -0
  918. package/src/validation/index.ts +1 -0
  919. package/src/widgets/index.ts +3 -0
  920. package/src/widgets/slot-validator.ts +87 -0
  921. package/src/widgets/widget-registry.ts +32 -0
  922. package/tests/boot.test.ts +323 -0
  923. package/tests/dependency-sort.test.ts +99 -0
  924. package/tests/discovery.test.ts +126 -0
  925. package/tests/registry.test.ts +216 -0
  926. package/tests/schema-loader.test.ts +52 -0
  927. package/tests/schema-merger.test.ts +180 -0
  928. package/tsconfig.json +9 -0
  929. package/tsconfig.tsbuildinfo +1 -0
  930. package/vitest.config.ts +14 -0
@@ -0,0 +1,133 @@
1
+ import type { Kysely } from 'kysely';
2
+ import { sql } from 'kysely';
3
+ import type { SchemaRegistry } from '../schema/registry.js';
4
+ import type { DdlOperation } from './types.js';
5
+ import { SchemaToDesired } from './desired-state.js';
6
+ import { DiffEngine } from './diff-engine.js';
7
+ import { introspect } from './introspect.js';
8
+
9
+ export interface AutoSyncOptions {
10
+ allowDestructive?: boolean;
11
+ }
12
+
13
+ export interface AutoSyncResult {
14
+ applied: DdlOperation[];
15
+ warnings: DdlOperation[];
16
+ }
17
+
18
+ /**
19
+ * Compares the desired schema (from the registry) against the actual database state
20
+ * and applies any DDL operations needed to bring the database in sync.
21
+ */
22
+ export async function autoSync(
23
+ registry: SchemaRegistry,
24
+ db: Kysely<unknown>,
25
+ options: AutoSyncOptions = {},
26
+ ): Promise<AutoSyncResult> {
27
+ const desired = new SchemaToDesired().convert(registry);
28
+ const actual = await introspect(db);
29
+ const operations = new DiffEngine().diff(desired, actual);
30
+
31
+ if (operations.length === 0) {
32
+ console.log(`[rangka:sync] Schema is up to date`);
33
+ return { applied: [], warnings: [] };
34
+ }
35
+
36
+ const applied: DdlOperation[] = [];
37
+ const warnings: DdlOperation[] = [];
38
+
39
+ for (const op of operations) {
40
+ if (op.destructive) {
41
+ await handleDestructiveOp(op, options, applied, warnings, db);
42
+ } else {
43
+ await applyOperation(op, db);
44
+ applied.push(op);
45
+ }
46
+ }
47
+
48
+ if (applied.length > 0) {
49
+ console.log(`[rangka:sync] Applied ${applied.length} operation(s):`);
50
+ for (const op of applied) {
51
+ console.log(` ${formatOperation(op)}`);
52
+ }
53
+ }
54
+
55
+ if (warnings.length > 0) {
56
+ console.warn(`[rangka:sync] ${warnings.length} skipped (destructive):`);
57
+ for (const op of warnings) {
58
+ console.warn(` ${formatOperation(op)}`);
59
+ }
60
+ }
61
+
62
+ return { applied, warnings };
63
+ }
64
+
65
+ /** Apply a non-destructive DDL operation. */
66
+ async function applyOperation(op: DdlOperation, db: Kysely<unknown>): Promise<void> {
67
+ await sql.raw(op.sql).execute(db);
68
+ }
69
+
70
+ /**
71
+ * Handle a destructive operation: apply it if allowed, otherwise log a warning.
72
+ */
73
+ async function handleDestructiveOp(
74
+ op: DdlOperation,
75
+ options: AutoSyncOptions,
76
+ applied: DdlOperation[],
77
+ warnings: DdlOperation[],
78
+ db: Kysely<unknown>,
79
+ ): Promise<void> {
80
+ if (options.allowDestructive) {
81
+ const ddlSql = generateDestructiveSql(op);
82
+ await sql.raw(ddlSql).execute(db);
83
+ applied.push(op);
84
+ } else {
85
+ warnings.push(op);
86
+ }
87
+ }
88
+
89
+ function formatOperation(op: DdlOperation): string {
90
+ switch (op.type) {
91
+ case 'CREATE_TABLE':
92
+ return `+ table ${op.table}`;
93
+ case 'ADD_COLUMN':
94
+ return `+ column ${op.table}.${extractColumnFromSql(op.sql)}`;
95
+ case 'ALTER_COLUMN_TYPE':
96
+ return `~ column type ${op.table}.${extractColumnFromSql(op.sql)}`;
97
+ case 'CREATE_INDEX':
98
+ return `+ index on ${op.table}`;
99
+ case 'ADD_FOREIGN_KEY':
100
+ return `+ foreign key on ${op.table}`;
101
+ case 'ADD_CHECK_CONSTRAINT':
102
+ return `+ check constraint on ${op.table}`;
103
+ case 'DROP_TABLE':
104
+ return `- table ${op.table} (orphaned)`;
105
+ case 'DROP_COLUMN':
106
+ return `- column ${op.detail ?? op.table} (orphaned)`;
107
+ default:
108
+ return `${op.type} on ${op.table}`;
109
+ }
110
+ }
111
+
112
+ function extractColumnFromSql(s: string): string {
113
+ const match = s.match(/COLUMN "([^"]+)"/i) ?? s.match(/COLUMN\s+(\S+)/i);
114
+ return match ? match[1] : 'unknown';
115
+ }
116
+
117
+ /** Generate the raw SQL for a destructive operation (DROP COLUMN / DROP TABLE). */
118
+ function generateDestructiveSql(op: DdlOperation): string {
119
+ switch (op.type) {
120
+ case 'DROP_COLUMN': {
121
+ const match = op.detail?.match(/Orphaned column: (.+)\.(.+)/);
122
+ if (match) return `ALTER TABLE "${match[1]}" DROP COLUMN "${match[2]}"`;
123
+ return op.sql;
124
+ }
125
+ case 'DROP_TABLE': {
126
+ const match = op.detail?.match(/Orphaned table: (.+)/);
127
+ if (match) return `DROP TABLE "${match[1]}"`;
128
+ return op.sql;
129
+ }
130
+ default:
131
+ return op.sql;
132
+ }
133
+ }
@@ -0,0 +1,147 @@
1
+ import { Kysely, PostgresDialect } from 'kysely';
2
+ import pg from 'pg';
3
+ import type { SchemaRegistry } from '../schema/registry.js';
4
+ import { modelToTableName } from './field-mapper.js';
5
+
6
+ export interface DatabaseClientConfig {
7
+ host: string;
8
+ port?: number;
9
+ database: string;
10
+ user: string;
11
+ password: string;
12
+ pool?: {
13
+ min?: number;
14
+ max?: number;
15
+ };
16
+ }
17
+
18
+ /**
19
+ * Thin wrapper around Kysely that resolves qualified model names
20
+ * (e.g. "sales.Invoice") to their underlying table names automatically.
21
+ */
22
+ export class DatabaseClient {
23
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
24
+ private readonly db: Kysely<any>;
25
+ private readonly pool: pg.Pool;
26
+ private readonly qualifiedNameToTable: Map<string, string>;
27
+
28
+ constructor(config: DatabaseClientConfig, registry?: SchemaRegistry) {
29
+ this.pool = this.createPool(config);
30
+ this.db = new Kysely({ dialect: new PostgresDialect({ pool: this.pool }) });
31
+ this.qualifiedNameToTable = this.buildTableNameMap(registry);
32
+ }
33
+
34
+ /**
35
+ * Verify the database connection is reachable.
36
+ * Throws with actionable diagnostics if it cannot connect.
37
+ */
38
+ async verifyConnection(): Promise<void> {
39
+ let client: pg.PoolClient | undefined;
40
+ try {
41
+ client = await this.pool.connect();
42
+ await client.query('SELECT 1');
43
+ } catch (err: unknown) {
44
+ const pgErr = err as { code?: string; message?: string };
45
+ const detail = formatConnectionError(pgErr, this.pool);
46
+ throw new Error(`Database connection failed: ${detail}`, { cause: err });
47
+ } finally {
48
+ client?.release();
49
+ }
50
+ }
51
+
52
+ // --- Query builders (resolve model name to table name automatically) ---
53
+
54
+ selectFrom(model: string) {
55
+ return this.db.selectFrom(this.resolveTable(model));
56
+ }
57
+
58
+ insertInto(model: string) {
59
+ return this.db.insertInto(this.resolveTable(model));
60
+ }
61
+
62
+ updateTable(model: string) {
63
+ return this.db.updateTable(this.resolveTable(model));
64
+ }
65
+
66
+ deleteFrom(model: string) {
67
+ return this.db.deleteFrom(this.resolveTable(model));
68
+ }
69
+
70
+ /** Execute a callback within a database transaction. */
71
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
72
+ async transaction<T>(callback: (trx: Kysely<any>) => Promise<T>): Promise<T> {
73
+ return this.db.transaction().execute(callback);
74
+ }
75
+
76
+ /** Direct access to the underlying Kysely instance. */
77
+ // eslint-disable-next-line @typescript-eslint/no-explicit-any
78
+ get kysely(): Kysely<any> {
79
+ return this.db;
80
+ }
81
+
82
+ /** Close the connection pool and release resources. */
83
+ async destroy(): Promise<void> {
84
+ await this.db.destroy();
85
+ }
86
+
87
+ // --- Private helpers ---
88
+
89
+ /** Maps a qualified model name to its table name, falling back to the raw input. */
90
+ private resolveTable(nameOrQualified: string): string {
91
+ return this.qualifiedNameToTable.get(nameOrQualified) ?? nameOrQualified;
92
+ }
93
+
94
+ /** Create the underlying pg connection pool. */
95
+ private createPool(config: DatabaseClientConfig): pg.Pool {
96
+ return new pg.Pool({
97
+ host: config.host,
98
+ port: config.port ?? 5432,
99
+ database: config.database,
100
+ user: config.user,
101
+ password: config.password,
102
+ min: config.pool?.min ?? 2,
103
+ max: config.pool?.max ?? 10,
104
+ });
105
+ }
106
+
107
+ /** Pre-compute the mapping from qualified model names to SQL table names. */
108
+ private buildTableNameMap(registry?: SchemaRegistry): Map<string, string> {
109
+ const map = new Map<string, string>();
110
+ if (registry) {
111
+ for (const model of registry.getAllModels()) {
112
+ map.set(model.qualifiedName, modelToTableName(model.qualifiedName));
113
+ }
114
+ }
115
+ return map;
116
+ }
117
+ }
118
+
119
+ function formatConnectionError(err: { code?: string; message?: string }, pool: pg.Pool): string {
120
+ const opts = (pool as unknown as { options: pg.PoolConfig }).options;
121
+ const host = opts.host ?? 'localhost';
122
+ const port = opts.port ?? 5432;
123
+ const database = opts.database ?? '(unknown)';
124
+
125
+ switch (err.code) {
126
+ case 'ECONNREFUSED':
127
+ return (
128
+ `Could not connect to PostgreSQL at ${host}:${port}. ` +
129
+ `Is the server running and accepting connections?`
130
+ );
131
+ case 'ENOTFOUND':
132
+ return `Host "${host}" not found. Check the database host configuration.`;
133
+ case 'ETIMEDOUT':
134
+ return (
135
+ `Connection to ${host}:${port} timed out. ` +
136
+ `Check network connectivity and firewall rules.`
137
+ );
138
+ case '3D000':
139
+ return `Database "${database}" does not exist on ${host}:${port}.`;
140
+ case '28P01':
141
+ return `Authentication failed for user "${opts.user ?? '(unknown)'}". Check credentials.`;
142
+ case '28000':
143
+ return `Authorization failed for user "${opts.user ?? '(unknown)'}". Check pg_hba.conf or user permissions.`;
144
+ default:
145
+ return err.message ?? 'Unknown error';
146
+ }
147
+ }
@@ -0,0 +1,98 @@
1
+ import type { SchemaRegistry } from '../schema/registry.js';
2
+ import type { ResolvedModel } from '../schema/types.js';
3
+ import type { DesiredState, TableDefinition, IndexDefinition } from './types.js';
4
+ import { mapFieldsToColumns, modelToTableName } from './field-mapper.js';
5
+ import { getJobTables } from '../jobs/tables.js';
6
+
7
+ /**
8
+ * Converts the in-memory schema registry into the desired database state
9
+ * (list of table definitions) used by the diff engine for migrations.
10
+ */
11
+ export class SchemaToDesired {
12
+ convert(registry: SchemaRegistry): DesiredState {
13
+ const tables: TableDefinition[] = [];
14
+ const models = registry.getAllModels();
15
+ let hasSequenceField = false;
16
+
17
+ for (const model of models) {
18
+ const { primaryTable, joinTables } = this.modelToTables(model);
19
+ tables.push(primaryTable);
20
+ tables.push(...joinTables);
21
+
22
+ if (model.fields.some((f) => f.config.type === 'sequence')) {
23
+ hasSequenceField = true;
24
+ }
25
+ }
26
+
27
+ // Add the naming_sequence helper table if any model uses sequence fields
28
+ if (hasSequenceField) {
29
+ tables.push(this.buildNamingSequenceTable());
30
+ }
31
+
32
+ // Always include the internal job queue tables
33
+ tables.push(...getJobTables());
34
+
35
+ return { tables };
36
+ }
37
+
38
+ /**
39
+ * Converts a single model into its primary table definition plus any
40
+ * extra join/pivot tables required by its fields.
41
+ */
42
+ private modelToTables(model: ResolvedModel): {
43
+ primaryTable: TableDefinition;
44
+ joinTables: TableDefinition[];
45
+ } {
46
+ const tableName = modelToTableName(model.qualifiedName);
47
+ const mapping = mapFieldsToColumns(model);
48
+ const indexes = this.buildIndexes(model, tableName);
49
+
50
+ const primaryTable: TableDefinition = {
51
+ name: tableName,
52
+ columns: mapping.columns,
53
+ foreignKeys: mapping.foreignKeys,
54
+ checkConstraints: mapping.checkConstraints,
55
+ indexes,
56
+ };
57
+
58
+ return { primaryTable, joinTables: mapping.extraTables };
59
+ }
60
+
61
+ /** Generates index definitions from a model's declared indexes. */
62
+ private buildIndexes(model: ResolvedModel, tableName: string): IndexDefinition[] {
63
+ if (!model.indexes || model.indexes.length === 0) return [];
64
+
65
+ return model.indexes.map((idx) => {
66
+ const prefix = idx.unique ? 'uidx' : 'idx';
67
+ const indexName = `${prefix}_${tableName}_${idx.fields.join('_')}`;
68
+ return {
69
+ name: indexName,
70
+ table: tableName,
71
+ columns: idx.fields,
72
+ unique: idx.unique ?? false,
73
+ };
74
+ });
75
+ }
76
+
77
+ /** Table definition for the naming_sequence counter table. */
78
+ private buildNamingSequenceTable(): TableDefinition {
79
+ return {
80
+ name: 'naming_sequence',
81
+ columns: [
82
+ { name: 'model', type: 'VARCHAR(255)', nullable: false },
83
+ { name: 'field', type: 'VARCHAR(255)', nullable: false },
84
+ { name: 'next_val', type: 'BIGINT', nullable: false, defaultValue: '1' },
85
+ ],
86
+ foreignKeys: [],
87
+ checkConstraints: [],
88
+ indexes: [
89
+ {
90
+ name: 'uidx_naming_sequence_key',
91
+ table: 'naming_sequence',
92
+ columns: ['model', 'field'],
93
+ unique: true,
94
+ },
95
+ ],
96
+ };
97
+ }
98
+ }
@@ -0,0 +1,305 @@
1
+ import type {
2
+ DesiredState,
3
+ ActualState,
4
+ DdlOperation,
5
+ TableDefinition,
6
+ ActualTable,
7
+ ColumnDefinition,
8
+ ActualColumn,
9
+ IndexDefinition,
10
+ ActualIndex,
11
+ ForeignKeyDefinition,
12
+ ActualForeignKey,
13
+ CheckConstraintDefinition,
14
+ ActualCheckConstraint,
15
+ } from './types.js';
16
+
17
+ /**
18
+ * Compares a desired schema state against the actual database state and
19
+ * produces a sorted list of DDL operations needed to reconcile the two.
20
+ */
21
+ export class DiffEngine {
22
+ // --- Public API ---
23
+
24
+ /** Compute the full set of DDL operations to bring `actual` in line with `desired`. */
25
+ diff(desired: DesiredState, actual: ActualState): DdlOperation[] {
26
+ const operations: DdlOperation[] = [];
27
+ const actualTablesByName = new Map(actual.tables.map((t) => [t.name, t]));
28
+
29
+ // Generate operations for each desired table (create or update)
30
+ for (const desiredTable of desired.tables) {
31
+ const existingTable = actualTablesByName.get(desiredTable.name);
32
+ if (!existingTable) {
33
+ operations.push(...this.buildNewTableOperations(desiredTable));
34
+ } else {
35
+ operations.push(...this.diffTable(desiredTable, existingTable));
36
+ }
37
+ }
38
+
39
+ // Flag tables that exist in the database but not in the schema
40
+ for (const existingTable of actual.tables) {
41
+ const stillDesired = desired.tables.find((t) => t.name === existingTable.name);
42
+ if (!stillDesired) {
43
+ operations.push(this.warnOrphanedTable(existingTable.name));
44
+ }
45
+ }
46
+
47
+ return this.sortByDependencyOrder(operations);
48
+ }
49
+
50
+ // --- Table creation ---
51
+
52
+ /** Build all operations needed to create a brand new table (table + indexes + foreign keys + check constraints). */
53
+ private buildNewTableOperations(table: TableDefinition): DdlOperation[] {
54
+ return [
55
+ this.buildCreateTableOp(table),
56
+ ...table.indexes.map((idx) => this.buildCreateIndexOp(idx)),
57
+ ...table.foreignKeys.map((fk) => this.buildAddForeignKeyOp(table.name, fk)),
58
+ ];
59
+ }
60
+
61
+ /** Generate the CREATE TABLE DDL for a table definition. */
62
+ private buildCreateTableOp(table: TableDefinition): DdlOperation {
63
+ const columnClauses = table.columns.map((col) => this.columnToSql(col));
64
+
65
+ const primaryKeyColumn = table.columns.find((c) => c.primaryKey);
66
+ if (primaryKeyColumn) {
67
+ columnClauses.push(`PRIMARY KEY (${primaryKeyColumn.name})`);
68
+ }
69
+
70
+ for (const chk of table.checkConstraints) {
71
+ columnClauses.push(`CONSTRAINT "${chk.name}" CHECK (${chk.expression})`);
72
+ }
73
+
74
+ const sql = `CREATE TABLE "${table.name}" (\n ${columnClauses.join(',\n ')}\n)`;
75
+ return {
76
+ type: 'CREATE_TABLE',
77
+ table: table.name,
78
+ sql,
79
+ destructive: false,
80
+ };
81
+ }
82
+
83
+ // --- Table diffing (existing table vs desired) ---
84
+
85
+ /** Compare an existing table against its desired definition and produce update operations. */
86
+ private diffTable(desired: TableDefinition, actual: ActualTable): DdlOperation[] {
87
+ const operations: DdlOperation[] = [];
88
+
89
+ operations.push(...this.diffColumns(desired.name, desired.columns, actual.columns));
90
+ operations.push(...this.diffIndexes(desired.name, desired.indexes, actual.indexes));
91
+ operations.push(...this.diffForeignKeys(desired.name, desired.foreignKeys, actual.foreignKeys));
92
+ operations.push(
93
+ ...this.diffCheckConstraints(desired.name, desired.checkConstraints, actual.checkConstraints),
94
+ );
95
+
96
+ return operations;
97
+ }
98
+
99
+ /** Detect added columns, type changes, and orphaned columns. */
100
+ private diffColumns(
101
+ tableName: string,
102
+ desiredColumns: ColumnDefinition[],
103
+ actualColumns: ActualColumn[],
104
+ ): DdlOperation[] {
105
+ const operations: DdlOperation[] = [];
106
+ const actualColumnsByName = new Map(actualColumns.map((c) => [c.name, c]));
107
+ const desiredColumnNames = new Set(desiredColumns.map((c) => c.name));
108
+
109
+ for (const desiredCol of desiredColumns) {
110
+ const existingCol = actualColumnsByName.get(desiredCol.name);
111
+ if (!existingCol) {
112
+ operations.push(this.buildAddColumnOp(tableName, desiredCol));
113
+ } else if (this.hasColumnTypeChanged(desiredCol, existingCol)) {
114
+ operations.push(this.buildAlterColumnTypeOp(tableName, desiredCol));
115
+ }
116
+ }
117
+
118
+ // Flag columns that exist in the DB but are no longer in the schema
119
+ for (const existingCol of actualColumns) {
120
+ if (!desiredColumnNames.has(existingCol.name)) {
121
+ operations.push(this.warnOrphanedColumn(tableName, existingCol.name));
122
+ }
123
+ }
124
+
125
+ return operations;
126
+ }
127
+
128
+ /** Detect indexes that need to be created. */
129
+ private diffIndexes(
130
+ tableName: string,
131
+ desiredIndexes: IndexDefinition[],
132
+ actualIndexes: ActualIndex[],
133
+ ): DdlOperation[] {
134
+ const existingIndexNames = new Set(actualIndexes.map((i) => i.name));
135
+
136
+ return desiredIndexes
137
+ .filter((idx) => !existingIndexNames.has(idx.name))
138
+ .map((idx) => this.buildCreateIndexOp(idx));
139
+ }
140
+
141
+ /** Detect foreign keys that need to be added. */
142
+ private diffForeignKeys(
143
+ tableName: string,
144
+ desiredForeignKeys: ForeignKeyDefinition[],
145
+ actualForeignKeys: ActualForeignKey[],
146
+ ): DdlOperation[] {
147
+ const existingFkNames = new Set(actualForeignKeys.map((fk) => fk.name));
148
+
149
+ return desiredForeignKeys
150
+ .filter((fk) => !existingFkNames.has(fk.name))
151
+ .map((fk) => this.buildAddForeignKeyOp(tableName, fk));
152
+ }
153
+
154
+ /** Detect CHECK constraints that need to be added. */
155
+ private diffCheckConstraints(
156
+ tableName: string,
157
+ desiredConstraints: CheckConstraintDefinition[],
158
+ actualConstraints: ActualCheckConstraint[],
159
+ ): DdlOperation[] {
160
+ const existingNames = new Set(actualConstraints.map((c) => c.name));
161
+
162
+ return desiredConstraints
163
+ .filter((chk) => !existingNames.has(chk.name))
164
+ .map((chk) => this.buildAddCheckConstraintOp(tableName, chk));
165
+ }
166
+
167
+ // --- DDL operation builders ---
168
+
169
+ /** Generate an ADD COLUMN operation. */
170
+ private buildAddColumnOp(tableName: string, col: ColumnDefinition): DdlOperation {
171
+ const colSql = this.columnToSql(col);
172
+ const sql = `ALTER TABLE "${tableName}" ADD COLUMN ${colSql}`;
173
+ return { type: 'ADD_COLUMN', table: tableName, sql, destructive: false };
174
+ }
175
+
176
+ /** Generate an ALTER COLUMN TYPE operation. */
177
+ private buildAlterColumnTypeOp(tableName: string, col: ColumnDefinition): DdlOperation {
178
+ const sql = `ALTER TABLE "${tableName}" ALTER COLUMN "${col.name}" TYPE ${col.type}`;
179
+ return { type: 'ALTER_COLUMN_TYPE', table: tableName, sql, destructive: false };
180
+ }
181
+
182
+ /** Generate a CREATE INDEX operation. */
183
+ private buildCreateIndexOp(idx: IndexDefinition): DdlOperation {
184
+ const uniquePrefix = idx.unique ? 'UNIQUE ' : '';
185
+ const quotedColumns = idx.columns.map((c) => `"${c}"`).join(', ');
186
+ const whereClause = idx.where ? ` WHERE ${idx.where}` : '';
187
+ const sql = `CREATE ${uniquePrefix}INDEX "${idx.name}" ON "${idx.table}" (${quotedColumns})${whereClause}`;
188
+ return { type: 'CREATE_INDEX', table: idx.table, sql, destructive: false };
189
+ }
190
+
191
+ /** Generate an ADD FOREIGN KEY constraint operation. */
192
+ private buildAddForeignKeyOp(tableName: string, fk: ForeignKeyDefinition): DdlOperation {
193
+ const sql = `ALTER TABLE "${tableName}" ADD CONSTRAINT "${fk.name}" FOREIGN KEY ("${fk.column}") REFERENCES "${fk.referencedTable}" ("${fk.referencedColumn}")`;
194
+ return { type: 'ADD_FOREIGN_KEY', table: tableName, sql, destructive: false };
195
+ }
196
+
197
+ /** Generate an ADD CHECK CONSTRAINT operation. */
198
+ private buildAddCheckConstraintOp(
199
+ tableName: string,
200
+ chk: CheckConstraintDefinition,
201
+ ): DdlOperation {
202
+ const sql = `ALTER TABLE "${tableName}" ADD CONSTRAINT "${chk.name}" CHECK (${chk.expression})`;
203
+ return { type: 'ADD_CHECK_CONSTRAINT', table: tableName, sql, destructive: false };
204
+ }
205
+
206
+ // --- Orphan warnings (destructive markers) ---
207
+
208
+ /** Produce a warning operation for a table that exists in the DB but not in the schema. */
209
+ private warnOrphanedTable(tableName: string): DdlOperation {
210
+ return {
211
+ type: 'DROP_TABLE',
212
+ table: tableName,
213
+ sql: `-- WARNING: Table "${tableName}" exists in database but not in schema (not dropped without --allow-destructive)`,
214
+ destructive: true,
215
+ detail: `Orphaned table: ${tableName}`,
216
+ };
217
+ }
218
+
219
+ /** Produce a warning operation for a column that exists in the DB but not in the schema. */
220
+ private warnOrphanedColumn(tableName: string, columnName: string): DdlOperation {
221
+ return {
222
+ type: 'DROP_COLUMN',
223
+ table: tableName,
224
+ sql: `-- WARNING: Column "${tableName}"."${columnName}" exists in database but not in schema (not dropped without --allow-destructive)`,
225
+ destructive: true,
226
+ detail: `Orphaned column: ${tableName}.${columnName}`,
227
+ };
228
+ }
229
+
230
+ // --- SQL helpers ---
231
+
232
+ /** Convert a column definition to its SQL fragment (e.g. `"name" TEXT NOT NULL DEFAULT 'x'`). */
233
+ private columnToSql(col: ColumnDefinition): string {
234
+ let sql = `"${col.name}" ${col.type}`;
235
+ if (!col.nullable && !col.primaryKey) sql += ' NOT NULL';
236
+ if (col.defaultValue !== undefined) sql += ` DEFAULT ${col.defaultValue}`;
237
+ return sql;
238
+ }
239
+
240
+ /** Check whether the column type has changed (case-insensitive comparison). */
241
+ private hasColumnTypeChanged(desired: ColumnDefinition, actual: ActualColumn): boolean {
242
+ return desired.type.toUpperCase() !== actual.type.toUpperCase();
243
+ }
244
+
245
+ // --- Operation ordering ---
246
+
247
+ /**
248
+ * Sort operations so they execute in a safe dependency order:
249
+ * 1. CREATE TABLE (tables must exist before columns/indexes reference them)
250
+ * 2. ADD COLUMN
251
+ * 3. ALTER COLUMN TYPE
252
+ * 4. CREATE INDEX (columns must exist first)
253
+ * 5. ADD FOREIGN KEY (referenced tables must exist first)
254
+ * 6. ADD CHECK CONSTRAINT (columns must exist first)
255
+ * 7. Destructive operations (always last, require explicit opt-in)
256
+ */
257
+ private sortByDependencyOrder(operations: DdlOperation[]): DdlOperation[] {
258
+ const createTables: DdlOperation[] = [];
259
+ const addColumns: DdlOperation[] = [];
260
+ const alterColumns: DdlOperation[] = [];
261
+ const createIndexes: DdlOperation[] = [];
262
+ const addForeignKeys: DdlOperation[] = [];
263
+ const addCheckConstraints: DdlOperation[] = [];
264
+ const destructive: DdlOperation[] = [];
265
+
266
+ for (const op of operations) {
267
+ if (op.destructive) {
268
+ destructive.push(op);
269
+ } else {
270
+ switch (op.type) {
271
+ case 'CREATE_TABLE':
272
+ createTables.push(op);
273
+ break;
274
+ case 'ADD_COLUMN':
275
+ addColumns.push(op);
276
+ break;
277
+ case 'ALTER_COLUMN_TYPE':
278
+ alterColumns.push(op);
279
+ break;
280
+ case 'CREATE_INDEX':
281
+ createIndexes.push(op);
282
+ break;
283
+ case 'ADD_FOREIGN_KEY':
284
+ addForeignKeys.push(op);
285
+ break;
286
+ case 'ADD_CHECK_CONSTRAINT':
287
+ addCheckConstraints.push(op);
288
+ break;
289
+ default:
290
+ addColumns.push(op);
291
+ }
292
+ }
293
+ }
294
+
295
+ return [
296
+ ...createTables,
297
+ ...addColumns,
298
+ ...alterColumns,
299
+ ...createIndexes,
300
+ ...addForeignKeys,
301
+ ...addCheckConstraints,
302
+ ...destructive,
303
+ ];
304
+ }
305
+ }