@c15t/backend 1.5.0 → 1.6.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 (489) hide show
  1. package/.turbo/turbo-build.log +63 -37
  2. package/CHANGELOG.md +4 -209
  3. package/README.md +86 -164
  4. package/dist/contracts/consent/index.d.ts +103 -615
  5. package/dist/contracts/consent/index.d.ts.map +1 -1
  6. package/dist/contracts/consent/post.contract.d.ts +42 -140
  7. package/dist/contracts/consent/post.contract.d.ts.map +1 -1
  8. package/dist/contracts/consent/show-banner.contract.d.ts +28 -376
  9. package/dist/contracts/consent/show-banner.contract.d.ts.map +1 -1
  10. package/dist/contracts/consent/verify.contract.d.ts +33 -99
  11. package/dist/contracts/consent/verify.contract.d.ts.map +1 -1
  12. package/dist/contracts/index.d.ts +222 -1356
  13. package/dist/contracts/index.d.ts.map +1 -1
  14. package/dist/contracts/meta/index.d.ts +8 -63
  15. package/dist/contracts/meta/index.d.ts.map +1 -1
  16. package/dist/contracts/meta/status.contract.d.ts +8 -63
  17. package/dist/contracts/meta/status.contract.d.ts.map +1 -1
  18. package/dist/contracts/shared/jurisdiction.schema.d.ts +21 -9
  19. package/dist/contracts/shared/jurisdiction.schema.d.ts.map +1 -1
  20. package/dist/contracts.cjs +100 -106
  21. package/dist/contracts.js +100 -106
  22. package/dist/core.cjs +681 -681
  23. package/dist/core.d.ts +118 -678
  24. package/dist/core.d.ts.map +1 -1
  25. package/dist/core.js +634 -637
  26. package/dist/handlers/consent/index.d.ts +103 -615
  27. package/dist/handlers/consent/index.d.ts.map +1 -1
  28. package/dist/handlers/consent/post.handler.d.ts +42 -140
  29. package/dist/handlers/consent/post.handler.d.ts.map +1 -1
  30. package/dist/handlers/consent/show-banner/handler.d.ts +28 -376
  31. package/dist/handlers/consent/show-banner/handler.d.ts.map +1 -1
  32. package/dist/handlers/consent/show-banner/translations.d.ts.map +1 -1
  33. package/dist/handlers/consent/verify.handler.d.ts +33 -99
  34. package/dist/handlers/consent/verify.handler.d.ts.map +1 -1
  35. package/dist/handlers/meta/index.d.ts +8 -63
  36. package/dist/handlers/meta/index.d.ts.map +1 -1
  37. package/dist/handlers/meta/status.handler.d.ts +8 -63
  38. package/dist/handlers/meta/status.handler.d.ts.map +1 -1
  39. package/dist/init.d.ts.map +1 -1
  40. package/dist/middleware/openapi/index.d.ts +2 -2
  41. package/dist/middleware/openapi/index.d.ts.map +1 -1
  42. package/dist/pkgs/data-model/fields/index.cjs +14 -26
  43. package/dist/pkgs/data-model/fields/index.d.ts +4 -4
  44. package/dist/pkgs/data-model/fields/index.d.ts.map +1 -1
  45. package/dist/pkgs/data-model/fields/index.js +14 -26
  46. package/dist/pkgs/data-model/fields/zod-fields.d.ts +195 -871
  47. package/dist/pkgs/data-model/fields/zod-fields.d.ts.map +1 -1
  48. package/dist/pkgs/data-model/hooks/index.d.ts +2 -2
  49. package/dist/pkgs/data-model/hooks/index.d.ts.map +1 -1
  50. package/dist/pkgs/data-model/index.cjs +346 -358
  51. package/dist/pkgs/data-model/index.d.ts +1 -1
  52. package/dist/pkgs/data-model/index.d.ts.map +1 -1
  53. package/dist/pkgs/data-model/index.js +345 -357
  54. package/dist/pkgs/data-model/schema/index.cjs +346 -358
  55. package/dist/pkgs/data-model/schema/index.d.ts +1 -1
  56. package/dist/pkgs/data-model/schema/index.d.ts.map +1 -1
  57. package/dist/pkgs/data-model/schema/index.js +345 -357
  58. package/dist/pkgs/data-model/schema/schemas.d.ts +2 -2
  59. package/dist/pkgs/data-model/schema/schemas.d.ts.map +1 -1
  60. package/dist/pkgs/db-adapters/adapters/drizzle-adapter/drizzle-adapter.d.ts +3 -0
  61. package/dist/pkgs/db-adapters/adapters/drizzle-adapter/drizzle-adapter.d.ts.map +1 -1
  62. package/dist/pkgs/db-adapters/adapters/drizzle-adapter/index.cjs +158 -170
  63. package/dist/pkgs/db-adapters/adapters/drizzle-adapter/index.js +157 -169
  64. package/dist/pkgs/db-adapters/adapters/index.d.ts +2 -2
  65. package/dist/pkgs/db-adapters/adapters/index.d.ts.map +1 -1
  66. package/dist/pkgs/db-adapters/adapters/kysely-adapter/index.cjs +215 -227
  67. package/dist/pkgs/db-adapters/adapters/kysely-adapter/index.d.ts +2 -2
  68. package/dist/pkgs/db-adapters/adapters/kysely-adapter/index.d.ts.map +1 -1
  69. package/dist/pkgs/db-adapters/adapters/kysely-adapter/index.js +213 -225
  70. package/dist/pkgs/db-adapters/adapters/kysely-adapter/kysely-adapter.d.ts +2 -0
  71. package/dist/pkgs/db-adapters/adapters/kysely-adapter/kysely-adapter.d.ts.map +1 -1
  72. package/dist/pkgs/db-adapters/adapters/kysely-adapter/tests/test-utils.d.ts +1 -1
  73. package/dist/pkgs/db-adapters/adapters/kysely-adapter/tests/test-utils.d.ts.map +1 -1
  74. package/dist/pkgs/db-adapters/adapters/memory-adapter/index.cjs +158 -170
  75. package/dist/pkgs/db-adapters/adapters/memory-adapter/index.js +157 -169
  76. package/dist/pkgs/db-adapters/adapters/memory-adapter/memory-adapter.d.ts +3 -0
  77. package/dist/pkgs/db-adapters/adapters/memory-adapter/memory-adapter.d.ts.map +1 -1
  78. package/dist/pkgs/db-adapters/adapters/prisma-adapter/index.cjs +243 -255
  79. package/dist/pkgs/db-adapters/adapters/prisma-adapter/index.d.ts +1 -1
  80. package/dist/pkgs/db-adapters/adapters/prisma-adapter/index.d.ts.map +1 -1
  81. package/dist/pkgs/db-adapters/adapters/prisma-adapter/index.js +241 -253
  82. package/dist/pkgs/db-adapters/adapters/prisma-adapter/prisma-adapter.d.ts +3 -0
  83. package/dist/pkgs/db-adapters/adapters/prisma-adapter/prisma-adapter.d.ts.map +1 -1
  84. package/dist/pkgs/db-adapters/index.cjs +714 -726
  85. package/dist/pkgs/db-adapters/index.d.ts +6 -6
  86. package/dist/pkgs/db-adapters/index.d.ts.map +1 -1
  87. package/dist/pkgs/db-adapters/index.js +708 -720
  88. package/dist/pkgs/migrations/get-migration.d.ts.map +1 -1
  89. package/dist/pkgs/migrations/get-schema/get-schema.d.ts.map +1 -1
  90. package/dist/pkgs/migrations/get-schema/process-tables.d.ts.map +1 -1
  91. package/dist/pkgs/migrations/index.cjs +236 -248
  92. package/dist/pkgs/migrations/index.d.ts +4 -4
  93. package/dist/pkgs/migrations/index.d.ts.map +1 -1
  94. package/dist/pkgs/migrations/index.js +235 -247
  95. package/dist/pkgs/results/index.cjs +67 -67
  96. package/dist/pkgs/results/index.d.ts +5 -5
  97. package/dist/pkgs/results/index.d.ts.map +1 -1
  98. package/dist/pkgs/results/index.js +67 -67
  99. package/dist/pkgs/results/orpc-error-handler.d.ts +1 -1
  100. package/dist/pkgs/results/orpc-error-handler.d.ts.map +1 -1
  101. package/dist/pkgs/types/index.d.ts +1 -2
  102. package/dist/pkgs/types/index.d.ts.map +1 -1
  103. package/dist/pkgs/types/options.d.ts +9 -2
  104. package/dist/pkgs/types/options.d.ts.map +1 -1
  105. package/dist/pkgs/utils/index.d.ts +1 -1
  106. package/dist/pkgs/utils/index.d.ts.map +1 -1
  107. package/dist/pkgs/utils/logger.d.ts +1 -1
  108. package/dist/pkgs/utils/logger.d.ts.map +1 -1
  109. package/dist/router.cjs +114 -117
  110. package/dist/router.d.ts +111 -678
  111. package/dist/router.d.ts.map +1 -1
  112. package/dist/router.js +114 -117
  113. package/dist/schema/audit-log/schema.d.ts +2 -24
  114. package/dist/schema/audit-log/schema.d.ts.map +1 -1
  115. package/dist/schema/audit-log/table.d.ts +2 -24
  116. package/dist/schema/audit-log/table.d.ts.map +1 -1
  117. package/dist/schema/consent/registry.d.ts +8 -8
  118. package/dist/schema/consent/schema.d.ts +9 -33
  119. package/dist/schema/consent/schema.d.ts.map +1 -1
  120. package/dist/schema/consent/table.d.ts +9 -33
  121. package/dist/schema/consent/table.d.ts.map +1 -1
  122. package/dist/schema/consent-policy/registry.d.ts +20 -20
  123. package/dist/schema/consent-policy/schema.d.ts +22 -30
  124. package/dist/schema/consent-policy/schema.d.ts.map +1 -1
  125. package/dist/schema/consent-policy/table.d.ts +13 -29
  126. package/dist/schema/consent-policy/table.d.ts.map +1 -1
  127. package/dist/schema/consent-purpose/registry.d.ts +6 -6
  128. package/dist/schema/consent-purpose/schema.d.ts +5 -27
  129. package/dist/schema/consent-purpose/schema.d.ts.map +1 -1
  130. package/dist/schema/consent-purpose/table.d.ts +5 -27
  131. package/dist/schema/consent-purpose/table.d.ts.map +1 -1
  132. package/dist/schema/consent-record/schema.d.ts +3 -19
  133. package/dist/schema/consent-record/schema.d.ts.map +1 -1
  134. package/dist/schema/consent-record/table.d.ts +3 -19
  135. package/dist/schema/consent-record/table.d.ts.map +1 -1
  136. package/dist/schema/create-registry.d.ts +58 -58
  137. package/dist/schema/definition.d.ts +42 -176
  138. package/dist/schema/definition.d.ts.map +1 -1
  139. package/dist/schema/domain/registry.d.ts +20 -20
  140. package/dist/schema/domain/schema.d.ts +6 -24
  141. package/dist/schema/domain/schema.d.ts.map +1 -1
  142. package/dist/schema/domain/table.d.ts +6 -24
  143. package/dist/schema/domain/table.d.ts.map +1 -1
  144. package/dist/schema/index.cjs +426 -438
  145. package/dist/schema/index.d.ts +12 -12
  146. package/dist/schema/index.d.ts.map +1 -1
  147. package/dist/schema/index.js +426 -438
  148. package/dist/schema/schemas.d.ts +42 -176
  149. package/dist/schema/schemas.d.ts.map +1 -1
  150. package/dist/schema/subject/registry.d.ts +4 -4
  151. package/dist/schema/subject/schema.d.ts +4 -20
  152. package/dist/schema/subject/schema.d.ts.map +1 -1
  153. package/dist/schema/subject/table.d.ts +4 -20
  154. package/dist/schema/subject/table.d.ts.map +1 -1
  155. package/dist/schema/types.d.ts +1 -1
  156. package/dist/schema/types.d.ts.map +1 -1
  157. package/dist/testing/contract-testing.d.ts +3 -2
  158. package/dist/testing/contract-testing.d.ts.map +1 -1
  159. package/dist/types/index.d.ts +5 -4
  160. package/dist/types/index.d.ts.map +1 -1
  161. package/dist/types/options.d.ts +2 -2
  162. package/dist/types/options.d.ts.map +1 -1
  163. package/dist/v2/contracts/consent/index.d.ts +260 -0
  164. package/dist/v2/contracts/consent/index.d.ts.map +1 -0
  165. package/dist/v2/contracts/consent/index.test.d.ts +2 -0
  166. package/dist/v2/contracts/consent/index.test.d.ts.map +1 -0
  167. package/dist/v2/contracts/consent/post.contract.d.ts +114 -0
  168. package/dist/v2/contracts/consent/post.contract.d.ts.map +1 -0
  169. package/dist/v2/contracts/consent/post.contract.test.d.ts +2 -0
  170. package/dist/v2/contracts/consent/post.contract.test.d.ts.map +1 -0
  171. package/dist/v2/contracts/consent/show-banner.contract.d.ts +68 -0
  172. package/dist/v2/contracts/consent/show-banner.contract.d.ts.map +1 -0
  173. package/dist/v2/contracts/consent/show-banner.contract.test.d.ts +2 -0
  174. package/dist/v2/contracts/consent/show-banner.contract.test.d.ts.map +1 -0
  175. package/dist/v2/contracts/consent/verify.contract.d.ts +81 -0
  176. package/dist/v2/contracts/consent/verify.contract.d.ts.map +1 -0
  177. package/dist/v2/contracts/consent/verify.contract.test.d.ts +2 -0
  178. package/dist/v2/contracts/consent/verify.contract.test.d.ts.map +1 -0
  179. package/dist/v2/contracts/index.cjs +644 -0
  180. package/dist/v2/contracts/index.d.ts +563 -0
  181. package/dist/v2/contracts/index.d.ts.map +1 -0
  182. package/dist/v2/contracts/index.js +607 -0
  183. package/dist/v2/contracts/meta/index.d.ts +19 -0
  184. package/dist/v2/contracts/meta/index.d.ts.map +1 -0
  185. package/dist/v2/contracts/meta/index.test.d.ts +2 -0
  186. package/dist/v2/contracts/meta/index.test.d.ts.map +1 -0
  187. package/dist/v2/contracts/meta/status.contract.d.ts +18 -0
  188. package/dist/v2/contracts/meta/status.contract.d.ts.map +1 -0
  189. package/dist/v2/contracts/meta/status.contract.test.d.ts +2 -0
  190. package/dist/v2/contracts/meta/status.contract.test.d.ts.map +1 -0
  191. package/dist/v2/contracts/shared/jurisdiction.schema.d.ts +36 -0
  192. package/dist/v2/contracts/shared/jurisdiction.schema.d.ts.map +1 -0
  193. package/dist/v2/contracts/test.utils.d.ts +38 -0
  194. package/dist/v2/contracts/test.utils.d.ts.map +1 -0
  195. package/dist/v2/core.cjs +2181 -0
  196. package/dist/v2/core.d.ts +364 -0
  197. package/dist/v2/core.d.ts.map +1 -0
  198. package/dist/v2/core.js +2130 -0
  199. package/dist/v2/db/adapters/drizzle.cjs +36 -0
  200. package/dist/v2/db/adapters/drizzle.d.ts +2 -0
  201. package/dist/v2/db/adapters/drizzle.d.ts.map +1 -0
  202. package/dist/v2/db/adapters/drizzle.js +3 -0
  203. package/dist/v2/db/adapters/index.cjs +18 -0
  204. package/dist/v2/db/adapters/index.d.ts +2 -0
  205. package/dist/v2/db/adapters/index.d.ts.map +1 -0
  206. package/dist/v2/db/adapters/index.js +0 -0
  207. package/dist/v2/db/adapters/kysely.cjs +36 -0
  208. package/dist/v2/db/adapters/kysely.d.ts +2 -0
  209. package/dist/v2/db/adapters/kysely.d.ts.map +1 -0
  210. package/dist/v2/db/adapters/kysely.js +3 -0
  211. package/dist/v2/db/adapters/mongo.cjs +36 -0
  212. package/dist/v2/db/adapters/mongo.d.ts +2 -0
  213. package/dist/v2/db/adapters/mongo.d.ts.map +1 -0
  214. package/dist/v2/db/adapters/mongo.js +3 -0
  215. package/dist/v2/db/adapters/prisma.cjs +36 -0
  216. package/dist/v2/db/adapters/prisma.d.ts +2 -0
  217. package/dist/v2/db/adapters/prisma.d.ts.map +1 -0
  218. package/dist/v2/db/adapters/prisma.js +3 -0
  219. package/dist/v2/db/adapters/typeorm.cjs +36 -0
  220. package/dist/v2/db/adapters/typeorm.d.ts +2 -0
  221. package/dist/v2/db/adapters/typeorm.d.ts.map +1 -0
  222. package/dist/v2/db/adapters/typeorm.js +3 -0
  223. package/dist/v2/db/migrator/index.cjs +61 -0
  224. package/dist/v2/db/migrator/index.d.ts +29 -0
  225. package/dist/v2/db/migrator/index.d.ts.map +1 -0
  226. package/dist/v2/db/migrator/index.js +27 -0
  227. package/dist/v2/db/registry/audit-log.d.ts +21 -0
  228. package/dist/v2/db/registry/audit-log.d.ts.map +1 -0
  229. package/dist/v2/db/registry/audit-log.test.d.ts +2 -0
  230. package/dist/v2/db/registry/audit-log.test.d.ts.map +1 -0
  231. package/dist/v2/db/registry/consent-policy.d.ts +29 -0
  232. package/dist/v2/db/registry/consent-policy.d.ts.map +1 -0
  233. package/dist/v2/db/registry/consent-policy.test.d.ts +2 -0
  234. package/dist/v2/db/registry/consent-policy.test.d.ts.map +1 -0
  235. package/dist/v2/db/registry/consent-purpose.d.ts +16 -0
  236. package/dist/v2/db/registry/consent-purpose.d.ts.map +1 -0
  237. package/dist/v2/db/registry/consent-purpose.test.d.ts +2 -0
  238. package/dist/v2/db/registry/consent-purpose.test.d.ts.map +1 -0
  239. package/dist/v2/db/registry/consent.d.ts +20 -0
  240. package/dist/v2/db/registry/consent.d.ts.map +1 -0
  241. package/dist/v2/db/registry/consent.test.d.ts +2 -0
  242. package/dist/v2/db/registry/consent.test.d.ts.map +1 -0
  243. package/dist/v2/db/registry/domain.d.ts +24 -0
  244. package/dist/v2/db/registry/domain.d.ts.map +1 -0
  245. package/dist/v2/db/registry/domain.test.d.ts +2 -0
  246. package/dist/v2/db/registry/domain.test.d.ts.map +1 -0
  247. package/dist/v2/db/registry/index.d.ts +102 -0
  248. package/dist/v2/db/registry/index.d.ts.map +1 -0
  249. package/dist/v2/db/registry/subject.d.ts +18 -0
  250. package/dist/v2/db/registry/subject.d.ts.map +1 -0
  251. package/dist/v2/db/registry/subject.test.d.ts +2 -0
  252. package/dist/v2/db/registry/subject.test.d.ts.map +1 -0
  253. package/dist/v2/db/registry/types.d.ts +10 -0
  254. package/dist/v2/db/registry/types.d.ts.map +1 -0
  255. package/dist/v2/db/registry/utils/generate-id.d.ts +25 -0
  256. package/dist/v2/db/registry/utils/generate-id.d.ts.map +1 -0
  257. package/dist/v2/db/registry/utils/generate-id.test.d.ts +2 -0
  258. package/dist/v2/db/registry/utils/generate-id.test.d.ts.map +1 -0
  259. package/dist/v2/db/registry/utils.d.ts +25 -0
  260. package/dist/v2/db/registry/utils.d.ts.map +1 -0
  261. package/dist/v2/db/schema/1.0.0/audit-log.d.ts +29 -0
  262. package/dist/v2/db/schema/1.0.0/audit-log.d.ts.map +1 -0
  263. package/dist/v2/db/schema/1.0.0/consent-policy.d.ts +45 -0
  264. package/dist/v2/db/schema/1.0.0/consent-policy.d.ts.map +1 -0
  265. package/dist/v2/db/schema/1.0.0/consent-purpose.d.ts +27 -0
  266. package/dist/v2/db/schema/1.0.0/consent-purpose.d.ts.map +1 -0
  267. package/dist/v2/db/schema/1.0.0/consent-record.d.ts +19 -0
  268. package/dist/v2/db/schema/1.0.0/consent-record.d.ts.map +1 -0
  269. package/dist/v2/db/schema/1.0.0/consent.d.ts +42 -0
  270. package/dist/v2/db/schema/1.0.0/consent.d.ts.map +1 -0
  271. package/dist/v2/db/schema/1.0.0/domain.d.ts +23 -0
  272. package/dist/v2/db/schema/1.0.0/domain.d.ts.map +1 -0
  273. package/dist/v2/db/schema/1.0.0/index.d.ts +1513 -0
  274. package/dist/v2/db/schema/1.0.0/index.d.ts.map +1 -0
  275. package/dist/v2/db/schema/1.0.0/subject.d.ts +23 -0
  276. package/dist/v2/db/schema/1.0.0/subject.d.ts.map +1 -0
  277. package/dist/v2/db/schema/index.cjs +326 -0
  278. package/dist/v2/db/schema/index.d.ts +1507 -0
  279. package/dist/v2/db/schema/index.d.ts.map +1 -0
  280. package/dist/v2/db/schema/index.js +241 -0
  281. package/dist/v2/define-config.cjs +36 -0
  282. package/dist/v2/define-config.d.ts +5 -0
  283. package/dist/v2/define-config.d.ts.map +1 -0
  284. package/dist/v2/define-config.js +2 -0
  285. package/dist/v2/handlers/consent/index.d.ts +260 -0
  286. package/dist/v2/handlers/consent/index.d.ts.map +1 -0
  287. package/dist/v2/handlers/consent/post.handler.d.ts +136 -0
  288. package/dist/v2/handlers/consent/post.handler.d.ts.map +1 -0
  289. package/dist/v2/handlers/consent/show-banner/geo.d.ts +10 -0
  290. package/dist/v2/handlers/consent/show-banner/geo.d.ts.map +1 -0
  291. package/dist/v2/handlers/consent/show-banner/geo.test.d.ts +2 -0
  292. package/dist/v2/handlers/consent/show-banner/geo.test.d.ts.map +1 -0
  293. package/dist/v2/handlers/consent/show-banner/handler.d.ts +71 -0
  294. package/dist/v2/handlers/consent/show-banner/handler.d.ts.map +1 -0
  295. package/dist/v2/handlers/consent/show-banner/handler.test.d.ts +2 -0
  296. package/dist/v2/handlers/consent/show-banner/handler.test.d.ts.map +1 -0
  297. package/dist/v2/handlers/consent/show-banner/translations.d.ts +13 -0
  298. package/dist/v2/handlers/consent/show-banner/translations.d.ts.map +1 -0
  299. package/dist/v2/handlers/consent/show-banner/translations.test.d.ts +2 -0
  300. package/dist/v2/handlers/consent/show-banner/translations.test.d.ts.map +1 -0
  301. package/dist/v2/handlers/consent/verify.handler.d.ts +103 -0
  302. package/dist/v2/handlers/consent/verify.handler.d.ts.map +1 -0
  303. package/dist/v2/handlers/meta/index.d.ts +19 -0
  304. package/dist/v2/handlers/meta/index.d.ts.map +1 -0
  305. package/dist/v2/handlers/meta/status.handler.d.ts +17 -0
  306. package/dist/v2/handlers/meta/status.handler.d.ts.map +1 -0
  307. package/dist/v2/init.d.ts +3 -0
  308. package/dist/v2/init.d.ts.map +1 -0
  309. package/dist/v2/init.test.d.ts +2 -0
  310. package/dist/v2/init.test.d.ts.map +1 -0
  311. package/dist/v2/middleware/cors/cors.d.ts +37 -0
  312. package/dist/v2/middleware/cors/cors.d.ts.map +1 -0
  313. package/dist/v2/middleware/cors/cors.test.d.ts +2 -0
  314. package/dist/v2/middleware/cors/cors.test.d.ts.map +1 -0
  315. package/dist/v2/middleware/cors/index.d.ts +30 -0
  316. package/dist/v2/middleware/cors/index.d.ts.map +1 -0
  317. package/dist/v2/middleware/cors/is-origin-trusted.d.ts +49 -0
  318. package/dist/v2/middleware/cors/is-origin-trusted.d.ts.map +1 -0
  319. package/dist/v2/middleware/cors/is-origin-trusted.test.d.ts +2 -0
  320. package/dist/v2/middleware/cors/is-origin-trusted.test.d.ts.map +1 -0
  321. package/dist/v2/middleware/cors/process-cors.d.ts +31 -0
  322. package/dist/v2/middleware/cors/process-cors.d.ts.map +1 -0
  323. package/dist/v2/middleware/openapi/config.d.ts +28 -0
  324. package/dist/v2/middleware/openapi/config.d.ts.map +1 -0
  325. package/dist/v2/middleware/openapi/handlers.d.ts +29 -0
  326. package/dist/v2/middleware/openapi/handlers.d.ts.map +1 -0
  327. package/dist/v2/middleware/openapi/index.d.ts +11 -0
  328. package/dist/v2/middleware/openapi/index.d.ts.map +1 -0
  329. package/dist/v2/middleware/process-ip/index.d.ts +3 -0
  330. package/dist/v2/middleware/process-ip/index.d.ts.map +1 -0
  331. package/dist/v2/router.cjs +1275 -0
  332. package/dist/v2/router.d.ts +280 -0
  333. package/dist/v2/router.d.ts.map +1 -0
  334. package/dist/v2/router.js +1231 -0
  335. package/dist/v2/types/api.d.ts +27 -0
  336. package/dist/v2/types/api.d.ts.map +1 -0
  337. package/dist/v2/types/index.cjs +40 -0
  338. package/dist/v2/types/index.d.ts +104 -0
  339. package/dist/v2/types/index.d.ts.map +1 -0
  340. package/dist/v2/types/index.js +6 -0
  341. package/dist/v2/utils/create-telemetry-options.d.ts +28 -0
  342. package/dist/v2/utils/create-telemetry-options.d.ts.map +1 -0
  343. package/dist/v2/utils/env.d.ts +60 -0
  344. package/dist/v2/utils/env.d.ts.map +1 -0
  345. package/dist/v2/utils/index.d.ts +3 -0
  346. package/dist/v2/utils/index.d.ts.map +1 -0
  347. package/dist/v2/utils/logger.d.ts +16 -0
  348. package/dist/v2/utils/logger.d.ts.map +1 -0
  349. package/dist/version.d.ts +1 -1
  350. package/package.json +106 -15
  351. package/readme.json +30 -0
  352. package/rslib.config.ts +13 -14
  353. package/src/__tests__/server.test.ts +1 -1
  354. package/src/contracts/consent/post.contract.test.ts +3 -8
  355. package/src/contracts/consent/post.contract.ts +13 -13
  356. package/src/contracts/consent/show-banner.contract.test.ts +9 -0
  357. package/src/contracts/consent/show-banner.contract.ts +2 -0
  358. package/src/contracts/consent/verify.contract.ts +19 -23
  359. package/src/core.ts +7 -0
  360. package/src/handlers/consent/show-banner/handler.ts +12 -9
  361. package/src/handlers/consent/show-banner/translations.ts +2 -2
  362. package/src/init.ts +9 -6
  363. package/src/middleware/openapi/index.ts +2 -2
  364. package/src/pkgs/api-router/hooks/__tests__/processor.test.ts +1 -1
  365. package/src/pkgs/data-model/fields/index.ts +17 -22
  366. package/src/pkgs/data-model/fields/zod-fields.ts +14 -26
  367. package/src/pkgs/data-model/hooks/index.ts +3 -2
  368. package/src/pkgs/data-model/index.ts +2 -4
  369. package/src/pkgs/data-model/schema/index.ts +6 -7
  370. package/src/pkgs/data-model/schema/schemas.ts +3 -3
  371. package/src/pkgs/db-adapters/adapters/drizzle-adapter/drizzle-adapter.ts +4 -1
  372. package/src/pkgs/db-adapters/adapters/index.ts +2 -2
  373. package/src/pkgs/db-adapters/adapters/kysely-adapter/index.ts +4 -4
  374. package/src/pkgs/db-adapters/adapters/kysely-adapter/kysely-adapter.ts +4 -5
  375. package/src/pkgs/db-adapters/adapters/kysely-adapter/tests/postgres.test.ts +2 -4
  376. package/src/pkgs/db-adapters/adapters/kysely-adapter/tests/sqlite.test.ts +2 -3
  377. package/src/pkgs/db-adapters/adapters/kysely-adapter/tests/test-utils.ts +1 -6
  378. package/src/pkgs/db-adapters/adapters/memory-adapter/memory-adapter.ts +4 -1
  379. package/src/pkgs/db-adapters/adapters/prisma-adapter/index.ts +1 -1
  380. package/src/pkgs/db-adapters/adapters/prisma-adapter/prisma-adapter.ts +5 -2
  381. package/src/pkgs/db-adapters/index.ts +12 -13
  382. package/src/pkgs/migrations/get-migration.ts +4 -2
  383. package/src/pkgs/migrations/get-schema/get-schema.ts +0 -1
  384. package/src/pkgs/migrations/get-schema/process-fields.ts +1 -1
  385. package/src/pkgs/migrations/get-schema/process-tables.ts +0 -2
  386. package/src/pkgs/migrations/index.ts +7 -8
  387. package/src/pkgs/results/__tests__/error-codes.test.ts +2 -2
  388. package/src/pkgs/results/index.ts +22 -27
  389. package/src/pkgs/results/orpc-error-handler.ts +1 -1
  390. package/src/pkgs/results/results/result-helpers.ts +1 -1
  391. package/src/pkgs/types/index.ts +4 -4
  392. package/src/pkgs/types/options.ts +10 -3
  393. package/src/pkgs/utils/index.ts +1 -1
  394. package/src/pkgs/utils/logger.ts +1 -1
  395. package/src/schema/audit-log/schema.ts +3 -3
  396. package/src/schema/consent/schema.ts +4 -4
  397. package/src/schema/consent-policy/schema.ts +3 -3
  398. package/src/schema/consent-purpose/schema.ts +4 -4
  399. package/src/schema/consent-record/schema.ts +3 -3
  400. package/src/schema/definition.ts +1 -1
  401. package/src/schema/domain/schema.ts +5 -5
  402. package/src/schema/index.ts +14 -17
  403. package/src/schema/subject/schema.ts +3 -3
  404. package/src/schema/types.ts +1 -1
  405. package/src/testing/contract-testing.ts +15 -52
  406. package/src/types/index.ts +8 -8
  407. package/src/types/options.ts +2 -3
  408. package/src/v2/contracts/consent/index.test.ts +5 -0
  409. package/src/v2/contracts/consent/index.ts +9 -0
  410. package/src/v2/contracts/consent/post.contract.test.ts +521 -0
  411. package/src/v2/contracts/consent/post.contract.ts +155 -0
  412. package/src/v2/contracts/consent/show-banner.contract.test.ts +252 -0
  413. package/src/v2/contracts/consent/show-banner.contract.ts +73 -0
  414. package/src/v2/contracts/consent/verify.contract.test.ts +185 -0
  415. package/src/v2/contracts/consent/verify.contract.ts +122 -0
  416. package/src/v2/contracts/index.ts +20 -0
  417. package/src/v2/contracts/meta/index.test.ts +5 -0
  418. package/src/v2/contracts/meta/index.ts +5 -0
  419. package/src/v2/contracts/meta/status.contract.test.ts +226 -0
  420. package/src/v2/contracts/meta/status.contract.ts +34 -0
  421. package/src/v2/contracts/shared/jurisdiction.schema.ts +30 -0
  422. package/src/v2/contracts/test.utils.ts +400 -0
  423. package/src/v2/core.ts +379 -0
  424. package/src/v2/db/adapters/drizzle.ts +1 -0
  425. package/src/v2/db/adapters/index.ts +1 -0
  426. package/src/v2/db/adapters/kysely.ts +1 -0
  427. package/src/v2/db/adapters/mongo.ts +1 -0
  428. package/src/v2/db/adapters/prisma.ts +1 -0
  429. package/src/v2/db/adapters/typeorm.ts +1 -0
  430. package/src/v2/db/migrator/index.ts +80 -0
  431. package/src/v2/db/registry/audit-log.test.ts +77 -0
  432. package/src/v2/db/registry/audit-log.ts +46 -0
  433. package/src/v2/db/registry/consent-policy.test.ts +778 -0
  434. package/src/v2/db/registry/consent-policy.ts +74 -0
  435. package/src/v2/db/registry/consent-purpose.test.ts +485 -0
  436. package/src/v2/db/registry/consent-purpose.ts +41 -0
  437. package/src/v2/db/registry/consent.test.ts +843 -0
  438. package/src/v2/db/registry/consent.ts +42 -0
  439. package/src/v2/db/registry/domain.test.ts +463 -0
  440. package/src/v2/db/registry/domain.ts +51 -0
  441. package/src/v2/db/registry/index.ts +18 -0
  442. package/src/v2/db/registry/subject.test.ts +497 -0
  443. package/src/v2/db/registry/subject.ts +101 -0
  444. package/src/v2/db/registry/types.ts +10 -0
  445. package/src/v2/db/registry/utils/generate-id.test.ts +217 -0
  446. package/src/v2/db/registry/utils/generate-id.ts +134 -0
  447. package/src/v2/db/registry/utils.ts +134 -0
  448. package/src/v2/db/schema/1.0.0/audit-log.ts +32 -0
  449. package/src/v2/db/schema/1.0.0/consent-policy.ts +41 -0
  450. package/src/v2/db/schema/1.0.0/consent-purpose.ts +30 -0
  451. package/src/v2/db/schema/1.0.0/consent-record.ts +22 -0
  452. package/src/v2/db/schema/1.0.0/consent.ts +38 -0
  453. package/src/v2/db/schema/1.0.0/domain.ts +26 -0
  454. package/src/v2/db/schema/1.0.0/index.ts +56 -0
  455. package/src/v2/db/schema/1.0.0/subject.ts +26 -0
  456. package/src/v2/db/schema/index.ts +9 -0
  457. package/src/v2/define-config.ts +5 -0
  458. package/src/v2/handlers/consent/index.ts +9 -0
  459. package/src/v2/handlers/consent/post.handler.ts +254 -0
  460. package/src/v2/handlers/consent/show-banner/geo.test.ts +281 -0
  461. package/src/v2/handlers/consent/show-banner/geo.ts +96 -0
  462. package/src/v2/handlers/consent/show-banner/handler.test.ts +374 -0
  463. package/src/v2/handlers/consent/show-banner/handler.ts +123 -0
  464. package/src/v2/handlers/consent/show-banner/translations.test.ts +121 -0
  465. package/src/v2/handlers/consent/show-banner/translations.ts +79 -0
  466. package/src/v2/handlers/consent/verify.handler.ts +288 -0
  467. package/src/v2/handlers/meta/index.ts +5 -0
  468. package/src/v2/handlers/meta/status.handler.ts +43 -0
  469. package/src/v2/init.test.ts +114 -0
  470. package/src/v2/init.ts +126 -0
  471. package/src/v2/middleware/cors/cors.test.ts +111 -0
  472. package/src/v2/middleware/cors/cors.ts +192 -0
  473. package/src/v2/middleware/cors/index.ts +30 -0
  474. package/src/v2/middleware/cors/is-origin-trusted.test.ts +104 -0
  475. package/src/v2/middleware/cors/is-origin-trusted.ts +126 -0
  476. package/src/v2/middleware/cors/process-cors.ts +91 -0
  477. package/src/v2/middleware/openapi/config.ts +27 -0
  478. package/src/v2/middleware/openapi/handlers.ts +132 -0
  479. package/src/v2/middleware/openapi/index.ts +11 -0
  480. package/src/v2/middleware/process-ip/index.ts +39 -0
  481. package/src/v2/router.ts +8 -0
  482. package/src/v2/types/api.ts +32 -0
  483. package/src/v2/types/index.ts +121 -0
  484. package/src/v2/utils/create-telemetry-options.ts +115 -0
  485. package/src/v2/utils/env.ts +84 -0
  486. package/src/v2/utils/index.ts +2 -0
  487. package/src/v2/utils/logger.ts +38 -0
  488. package/src/version.ts +1 -1
  489. package/vitest.config.ts +11 -2
@@ -0,0 +1,217 @@
1
+ import { randomBytes } from 'node:crypto';
2
+ import type { InferFumaDB } from 'fumadb';
3
+ import { afterEach, describe, expect, it, vi } from 'vitest';
4
+ import type { DB } from '~/v2/db/schema';
5
+ import { generateUniqueId } from './generate-id';
6
+
7
+ type MockDB = ReturnType<InferFumaDB<typeof DB>['orm']>;
8
+
9
+ // Define regex patterns at the top level for performance
10
+ const SUBJECT_ID_PATTERN = /^sub_[A-Za-z0-9]+$/;
11
+ const CONSENT_ID_PATTERN = /^cns_[A-Za-z0-9]+$/;
12
+ const DOMAIN_ID_PATTERN = /^dom_[A-Za-z0-9]+$/;
13
+
14
+ describe('generateUniqueId', () => {
15
+ afterEach(() => {
16
+ vi.clearAllMocks();
17
+ });
18
+
19
+ // Ensure crypto.getRandomValues exists in Node/Vitest environments
20
+ // that may not provide a Web Crypto global by default.
21
+ if (
22
+ !(globalThis as { crypto?: { getRandomValues?: unknown } }).crypto
23
+ ?.getRandomValues
24
+ ) {
25
+ (
26
+ globalThis as {
27
+ crypto: { getRandomValues: (a: Uint8Array) => Uint8Array };
28
+ }
29
+ ).crypto = {
30
+ getRandomValues: (array: Uint8Array) => {
31
+ const bytes = randomBytes(array.length);
32
+ array.set(bytes);
33
+ return array;
34
+ },
35
+ };
36
+ }
37
+
38
+ it('should return unique ID on first attempt when no collision exists', async () => {
39
+ const mockDb = {
40
+ findFirst: vi.fn().mockResolvedValue(null), // No existing record found
41
+ } as unknown as MockDB;
42
+
43
+ const result = await generateUniqueId(mockDb, 'subject');
44
+
45
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(1);
46
+ expect(mockDb.findFirst).toHaveBeenCalledWith('subject', {
47
+ where: expect.any(Function),
48
+ });
49
+ expect(result).toMatch(SUBJECT_ID_PATTERN); // Should have 'sub_' prefix
50
+ expect(result.length).toBeGreaterThan(4); // Should be longer than just prefix
51
+ });
52
+
53
+ it('should retry when ID collision occurs and return unique ID on second attempt', async () => {
54
+ const mockExistingRecord = { id: 'mock_existing' };
55
+ const mockDb = {
56
+ findFirst: vi
57
+ .fn()
58
+ .mockResolvedValueOnce(mockExistingRecord) // First call returns existing record
59
+ .mockResolvedValueOnce(null), // Second call returns null (unique)
60
+ } as unknown as MockDB;
61
+
62
+ const result = await generateUniqueId(mockDb, 'consent');
63
+
64
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(2);
65
+ expect(result).toMatch(CONSENT_ID_PATTERN); // Should have 'cns_' prefix
66
+ });
67
+
68
+ it('should handle multiple collisions before finding unique ID', async () => {
69
+ const mockExistingRecord = { id: 'mock_existing' };
70
+ const mockDb = {
71
+ findFirst: vi
72
+ .fn()
73
+ .mockResolvedValueOnce(mockExistingRecord) // First collision
74
+ .mockResolvedValueOnce(mockExistingRecord) // Second collision
75
+ .mockResolvedValueOnce(mockExistingRecord) // Third collision
76
+ .mockResolvedValueOnce(null), // Finally unique
77
+ } as unknown as MockDB;
78
+
79
+ const result = await generateUniqueId(mockDb, 'domain');
80
+
81
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(4);
82
+ expect(result).toMatch(DOMAIN_ID_PATTERN); // Should have 'dom_' prefix
83
+ });
84
+
85
+ it('should work with different model types and use correct prefixes', async () => {
86
+ const mockDb = {
87
+ findFirst: vi.fn().mockResolvedValue(null),
88
+ } as unknown as MockDB;
89
+
90
+ const testCases = [
91
+ { model: 'auditLog' as const, expectedPrefix: 'log_' },
92
+ { model: 'consent' as const, expectedPrefix: 'cns_' },
93
+ { model: 'consentPolicy' as const, expectedPrefix: 'pol_' },
94
+ { model: 'consentPurpose' as const, expectedPrefix: 'pur_' },
95
+ { model: 'consentRecord' as const, expectedPrefix: 'rec_' },
96
+ { model: 'domain' as const, expectedPrefix: 'dom_' },
97
+ { model: 'subject' as const, expectedPrefix: 'sub_' },
98
+ ];
99
+
100
+ for (const { model, expectedPrefix } of testCases) {
101
+ const result = await generateUniqueId(mockDb, model);
102
+ expect(result).toMatch(
103
+ new RegExp(
104
+ `^${expectedPrefix.replace(/[.*+?^${}()|[\]\\]/g, '\\$&')}[A-Za-z0-9]+$`
105
+ )
106
+ );
107
+ }
108
+
109
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(testCases.length);
110
+ });
111
+
112
+ it('should call findFirst with correct where clause function', async () => {
113
+ const mockDb = {
114
+ findFirst: vi.fn().mockResolvedValue(null),
115
+ } as unknown as MockDB;
116
+
117
+ await generateUniqueId(mockDb, 'subject');
118
+
119
+ const mockFindFirst = vi.mocked(mockDb.findFirst);
120
+ const [model, options] = mockFindFirst.mock.calls[0] as [
121
+ string,
122
+ { where: (builder: unknown) => void },
123
+ ];
124
+ expect(mockFindFirst.mock.calls).toHaveLength(1);
125
+ expect(model).toBe('subject');
126
+ expect(options).toHaveProperty('where');
127
+ expect(typeof options.where).toBe('function');
128
+
129
+ // Test the where function behavior
130
+ const mockBuilder = vi.fn();
131
+ options.where(mockBuilder);
132
+ expect(mockBuilder).toHaveBeenCalledWith(
133
+ 'id',
134
+ '=',
135
+ expect.stringMatching(SUBJECT_ID_PATTERN)
136
+ );
137
+ });
138
+
139
+ it('should generate different IDs on subsequent calls', async () => {
140
+ const mockDb = {
141
+ findFirst: vi.fn().mockResolvedValue(null),
142
+ } as unknown as MockDB;
143
+
144
+ const id1 = await generateUniqueId(mockDb, 'subject');
145
+ const id2 = await generateUniqueId(mockDb, 'subject');
146
+ const id3 = await generateUniqueId(mockDb, 'subject');
147
+
148
+ expect(id1).not.toBe(id2);
149
+ expect(id2).not.toBe(id3);
150
+ expect(id1).not.toBe(id3);
151
+
152
+ // All should have the same prefix
153
+ expect(id1).toMatch(SUBJECT_ID_PATTERN);
154
+ expect(id2).toMatch(SUBJECT_ID_PATTERN);
155
+ expect(id3).toMatch(SUBJECT_ID_PATTERN);
156
+ });
157
+
158
+ it('should throw an error when max retries is exceeded', async () => {
159
+ const mockExistingRecord = { id: 'mock_existing' };
160
+ const mockLogger = {
161
+ error: vi.fn(),
162
+ debug: vi.fn(),
163
+ info: vi.fn(),
164
+ success: vi.fn(),
165
+ warn: vi.fn(),
166
+ };
167
+ const mockCtx = { logger: mockLogger };
168
+
169
+ const mockDb = {
170
+ findFirst: vi.fn().mockResolvedValue(mockExistingRecord), // Always return a collision
171
+ } as unknown as MockDB;
172
+
173
+ // Use a small maxRetries value for faster test execution
174
+ await expect(
175
+ generateUniqueId(mockDb, 'subject', mockCtx, { maxRetries: 3 })
176
+ ).rejects.toThrow(
177
+ 'Failed to generate unique ID for subject after 3 attempts'
178
+ );
179
+
180
+ // Should have attempted exactly maxRetries times
181
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(3);
182
+ expect(mockLogger.error).toHaveBeenCalledWith(
183
+ 'ID generation failed',
184
+ expect.objectContaining({ model: 'subject', maxRetries: 3 })
185
+ );
186
+ });
187
+
188
+ it('should respect custom retry options', async () => {
189
+ const mockExistingRecord = { id: 'mock_existing' };
190
+ const mockDb = {
191
+ findFirst: vi
192
+ .fn()
193
+ .mockResolvedValueOnce(mockExistingRecord) // First call returns existing record
194
+ .mockResolvedValueOnce(null), // Second call returns null (unique)
195
+ } as unknown as MockDB;
196
+
197
+ // Mock the setTimeout function directly
198
+ const originalSetTimeout = global.setTimeout;
199
+ global.setTimeout = vi.fn((callback) => {
200
+ // Execute callback immediately
201
+ callback();
202
+ return 1; // Return a timeout ID
203
+ }) as any;
204
+
205
+ try {
206
+ const result = await generateUniqueId(mockDb, 'subject', undefined, {
207
+ baseDelay: 100,
208
+ });
209
+
210
+ expect(mockDb.findFirst).toHaveBeenCalledTimes(2);
211
+ expect(result).toMatch(SUBJECT_ID_PATTERN);
212
+ } finally {
213
+ // Restore original setTimeout
214
+ global.setTimeout = originalSetTimeout;
215
+ }
216
+ });
217
+ });
@@ -0,0 +1,134 @@
1
+ import baseX from 'base-x';
2
+ import type { InferFumaDB } from 'fumadb';
3
+ import type { DB } from '~/v2/db/schema';
4
+ import type { C15TContext } from '~/v2/types';
5
+
6
+ type Tables = InferFumaDB<typeof DB>['schemas'][-1]['tables'];
7
+
8
+ const prefixes: Record<keyof Tables, string> = {
9
+ auditLog: 'log',
10
+ consent: 'cns',
11
+ consentPolicy: 'pol',
12
+ consentPurpose: 'pur',
13
+ consentRecord: 'rec',
14
+ domain: 'dom',
15
+ subject: 'sub',
16
+ } as const;
17
+
18
+ const b58 = baseX('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz');
19
+
20
+ /**
21
+ * Creates time-ordered, prefixed, base58-encoded identifiers that:
22
+ * - Start with the provided prefix for clear identification
23
+ * - Embed a timestamp for chronological ordering
24
+ * - Include random data for uniqueness
25
+ */
26
+ function generateId(model: keyof typeof prefixes): string {
27
+ const buf = crypto.getRandomValues(new Uint8Array(20));
28
+ const prefix = prefixes[model];
29
+
30
+ const EPOCH_TIMESTAMP = 1_700_000_000_000;
31
+
32
+ const t = Date.now() - EPOCH_TIMESTAMP;
33
+
34
+ // Use 8 bytes for the timestamp (0..7) and shift accordingly:
35
+ const high = Math.floor(t / 0x100000000);
36
+ const low = t >>> 0;
37
+ buf[0] = (high >>> 24) & 255;
38
+ buf[1] = (high >>> 16) & 255;
39
+ buf[2] = (high >>> 8) & 255;
40
+ buf[3] = high & 255;
41
+ buf[4] = (low >>> 24) & 255;
42
+ buf[5] = (low >>> 16) & 255;
43
+ buf[6] = (low >>> 8) & 255;
44
+ buf[7] = low & 255;
45
+
46
+ return `${prefix}_${b58.encode(buf)}`;
47
+ }
48
+
49
+ /**
50
+ * Generates a unique ID for the specified model with conflict handling
51
+ *
52
+ * @param db - Database ORM instance
53
+ * @param model - The model/table name to generate ID for
54
+ * @param ctx - Application context containing logger (optional)
55
+ * @param options - Configuration options for ID generation
56
+ * @returns Promise resolving to a unique ID
57
+ *
58
+ * @throws {Error} When max retry attempts are exceeded
59
+ */
60
+ export async function generateUniqueId(
61
+ db: ReturnType<InferFumaDB<typeof DB>['orm']>,
62
+ model: keyof Tables,
63
+ ctx?: Partial<C15TContext> | undefined,
64
+ options: {
65
+ /** Maximum number of retry attempts (default: 10) */
66
+ maxRetries?: number;
67
+ /** Current retry attempt (used internally) */
68
+ attempt?: number;
69
+ /** Base delay for exponential backoff in ms (default: 5) */
70
+ baseDelay?: number;
71
+ } = {}
72
+ ): Promise<string> {
73
+ const { maxRetries = 10, attempt = 0, baseDelay = 5 } = options;
74
+
75
+ // Check if we've exceeded the maximum retry attempts
76
+ if (attempt >= maxRetries) {
77
+ const error = new Error(
78
+ `Failed to generate unique ID for ${model} after ${maxRetries} attempts`
79
+ );
80
+ ctx?.logger?.error?.('ID generation failed', { model, maxRetries });
81
+ throw error;
82
+ }
83
+
84
+ const id = generateId(model);
85
+
86
+ try {
87
+ const existing = await db.findFirst(model, {
88
+ where: (b) => b('id', '=', id),
89
+ });
90
+
91
+ if (existing) {
92
+ ctx?.logger?.debug?.('ID conflict detected', {
93
+ id,
94
+ model,
95
+ attempt: attempt + 1,
96
+ maxRetries,
97
+ });
98
+
99
+ // Implement exponential backoff
100
+ const delay = Math.min(baseDelay * 2 ** attempt, 1000);
101
+
102
+ // Wait before retrying to reduce contention in high-volume scenarios
103
+ await new Promise((resolve) => setTimeout(resolve, delay));
104
+
105
+ return generateUniqueId(db, model, ctx, {
106
+ maxRetries,
107
+ attempt: attempt + 1,
108
+ baseDelay,
109
+ });
110
+ }
111
+
112
+ return id;
113
+ } catch (error) {
114
+ ctx?.logger?.error?.('Error checking ID uniqueness', {
115
+ error: (error as Error).message,
116
+ model,
117
+ attempt,
118
+ });
119
+
120
+ // If database error occurs, retry with backoff
121
+ if (attempt < maxRetries - 1) {
122
+ const delay = Math.min(baseDelay * 2 ** attempt, 2000);
123
+ await new Promise((resolve) => setTimeout(resolve, delay));
124
+
125
+ return generateUniqueId(db, model, ctx, {
126
+ maxRetries,
127
+ attempt: attempt + 1,
128
+ baseDelay,
129
+ });
130
+ }
131
+
132
+ throw error;
133
+ }
134
+ }
@@ -0,0 +1,134 @@
1
+ import baseX from 'base-x';
2
+ import type { InferFumaDB } from 'fumadb';
3
+ import type { DB } from '~/v2/db/schema';
4
+ import type { C15TContext } from '~/v2/types';
5
+
6
+ type Tables = InferFumaDB<typeof DB>['schemas'][-1]['tables'];
7
+
8
+ const prefixes: Record<keyof Tables, string> = {
9
+ auditLog: 'log',
10
+ consent: 'cns',
11
+ consentPolicy: 'pol',
12
+ consentPurpose: 'pur',
13
+ consentRecord: 'rec',
14
+ domain: 'dom',
15
+ subject: 'sub',
16
+ } as const;
17
+
18
+ const b58 = baseX('123456789ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz');
19
+
20
+ /**
21
+ * Creates time-ordered, prefixed, base58-encoded identifiers that:
22
+ * - Start with the provided prefix for clear identification
23
+ * - Embed a timestamp for chronological ordering
24
+ * - Include random data for uniqueness
25
+ */
26
+ function generateId(model: keyof typeof prefixes): string {
27
+ const buf = crypto.getRandomValues(new Uint8Array(20));
28
+ const prefix = prefixes[model];
29
+
30
+ const EPOCH_TIMESTAMP = 1_700_000_000_000;
31
+
32
+ const t = Date.now() - EPOCH_TIMESTAMP;
33
+
34
+ // Use 8 bytes for the timestamp (0..7) and shift accordingly:
35
+ const high = Math.floor(t / 0x100000000);
36
+ const low = t >>> 0;
37
+ buf[0] = (high >>> 24) & 255;
38
+ buf[1] = (high >>> 16) & 255;
39
+ buf[2] = (high >>> 8) & 255;
40
+ buf[3] = high & 255;
41
+ buf[4] = (low >>> 24) & 255;
42
+ buf[5] = (low >>> 16) & 255;
43
+ buf[6] = (low >>> 8) & 255;
44
+ buf[7] = low & 255;
45
+
46
+ return `${prefix}_${b58.encode(buf)}`;
47
+ }
48
+
49
+ /**
50
+ * Generates a unique ID for the specified model with conflict handling
51
+ *
52
+ * @param db - Database ORM instance
53
+ * @param model - The model/table name to generate ID for
54
+ * @param ctx - Application context containing logger (optional)
55
+ * @param options - Configuration options for ID generation
56
+ * @returns Promise resolving to a unique ID
57
+ *
58
+ * @throws {Error} When max retry attempts are exceeded
59
+ */
60
+ export async function generateUniqueId(
61
+ db: ReturnType<InferFumaDB<typeof DB>['orm']>,
62
+ model: keyof Tables,
63
+ ctx?: Partial<C15TContext> | undefined,
64
+ options: {
65
+ /** Maximum number of retry attempts (default: 10) */
66
+ maxRetries?: number;
67
+ /** Current retry attempt (used internally) */
68
+ attempt?: number;
69
+ /** Base delay for exponential backoff in ms (default: 5) */
70
+ baseDelay?: number;
71
+ } = {}
72
+ ): Promise<string> {
73
+ const { maxRetries = 10, attempt = 0, baseDelay = 5 } = options;
74
+
75
+ // Check if we've exceeded the maximum retry attempts
76
+ if (attempt >= maxRetries) {
77
+ const error = new Error(
78
+ `Failed to generate unique ID for ${model} after ${maxRetries} attempts`
79
+ );
80
+ ctx?.logger?.error?.('ID generation failed', { model, maxRetries });
81
+ throw error;
82
+ }
83
+
84
+ const id = generateId(model);
85
+
86
+ try {
87
+ const existing = await db.findFirst(model, {
88
+ where: (b) => b('id', '=', id),
89
+ });
90
+
91
+ if (existing) {
92
+ ctx?.logger?.debug?.('ID conflict detected', {
93
+ id,
94
+ model,
95
+ attempt: attempt + 1,
96
+ maxRetries,
97
+ });
98
+
99
+ // Implement exponential backoff
100
+ const delay = Math.min(baseDelay * 2 ** attempt, 1000);
101
+
102
+ // Wait before retrying to reduce contention in high-volume scenarios
103
+ await new Promise((resolve) => setTimeout(resolve, delay));
104
+
105
+ return generateUniqueId(db, model, ctx, {
106
+ maxRetries,
107
+ attempt: attempt + 1,
108
+ baseDelay,
109
+ });
110
+ }
111
+
112
+ return id;
113
+ } catch (error) {
114
+ ctx?.logger?.error?.('Error checking ID uniqueness', {
115
+ error: (error as Error).message,
116
+ model,
117
+ attempt,
118
+ });
119
+
120
+ // If database error occurs, retry with backoff
121
+ if (attempt < maxRetries - 1) {
122
+ const delay = Math.min(baseDelay * 2 ** attempt, 2000);
123
+ await new Promise((resolve) => setTimeout(resolve, delay));
124
+
125
+ return generateUniqueId(db, model, ctx, {
126
+ maxRetries,
127
+ attempt: attempt + 1,
128
+ baseDelay,
129
+ });
130
+ }
131
+
132
+ throw error;
133
+ }
134
+ }
@@ -0,0 +1,32 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const auditLogTable = table('auditLog', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ entityType: column('entityType', 'string'),
7
+ entityId: column('entityId', 'string'),
8
+ actionType: column('actionType', 'string'),
9
+ subjectId: column('subjectId', 'string').nullable(),
10
+ ipAddress: column('ipAddress', 'string').nullable(),
11
+ userAgent: column('userAgent', 'string').nullable(),
12
+ changes: column('changes', 'json').nullable(),
13
+ metadata: column('metadata', 'json').nullable(),
14
+ createdAt: column('createdAt', 'timestamp').defaultTo$('now'),
15
+ eventTimezone: column('eventTimezone', 'string').defaultTo$(() => 'UTC'),
16
+ });
17
+
18
+ export const auditLogSchema = z.object({
19
+ id: z.string(),
20
+ entityType: z.string(),
21
+ entityId: z.string(),
22
+ actionType: z.string(),
23
+ subjectId: z.string().optional(),
24
+ ipAddress: z.string().optional(),
25
+ userAgent: z.string().optional(),
26
+ changes: z.record(z.string(), z.unknown()).optional(),
27
+ metadata: z.record(z.string(), z.unknown()).optional(),
28
+ createdAt: z.date().prefault(() => new Date()),
29
+ eventTimezone: z.string().prefault('UTC'),
30
+ });
31
+
32
+ export type AuditLog = z.infer<typeof auditLogSchema>;
@@ -0,0 +1,41 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const consentPolicyTable = table('consentPolicy', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ version: column('version', 'string'),
7
+ type: column('type', 'string'),
8
+ name: column('name', 'string'),
9
+ effectiveDate: column('effectiveDate', 'timestamp'),
10
+ expirationDate: column('expirationDate', 'timestamp').nullable(),
11
+ content: column('content', 'string'),
12
+ contentHash: column('contentHash', 'string'),
13
+ isActive: column('isActive', 'bool').defaultTo$(() => true),
14
+ createdAt: column('createdAt', 'timestamp').defaultTo$('now'),
15
+ });
16
+
17
+ export const PolicyTypeSchema = z.enum([
18
+ 'cookie_banner',
19
+ 'privacy_policy',
20
+ 'dpa',
21
+ 'terms_and_conditions',
22
+ 'marketing_communications',
23
+ 'age_verification',
24
+ 'other',
25
+ ]);
26
+
27
+ export const consentPolicySchema = z.object({
28
+ id: z.string(),
29
+ version: z.string(),
30
+ type: PolicyTypeSchema,
31
+ name: z.string(),
32
+ effectiveDate: z.date(),
33
+ expirationDate: z.date().nullish(),
34
+ content: z.string(),
35
+ contentHash: z.string(),
36
+ isActive: z.boolean().prefault(true),
37
+ createdAt: z.date().prefault(() => new Date()),
38
+ });
39
+
40
+ export type ConsentPolicy = z.infer<typeof consentPolicySchema>;
41
+ export type PolicyType = z.infer<typeof PolicyTypeSchema>;
@@ -0,0 +1,30 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const consentPurposeTable = table('consentPurpose', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ code: column('code', 'string'),
7
+ name: column('name', 'string'),
8
+ description: column('description', 'string'),
9
+ isEssential: column('isEssential', 'bool'),
10
+ dataCategory: column('dataCategory', 'string').nullable(),
11
+ legalBasis: column('legalBasis', 'string').nullable(),
12
+ isActive: column('isActive', 'bool').defaultTo$(() => true),
13
+ createdAt: column('createdAt', 'timestamp').defaultTo$('now'),
14
+ updatedAt: column('updatedAt', 'timestamp').defaultTo$('now'),
15
+ });
16
+
17
+ export const consentPurposeSchema = z.object({
18
+ id: z.string(),
19
+ code: z.string(),
20
+ name: z.string(),
21
+ description: z.string(),
22
+ isEssential: z.boolean(),
23
+ dataCategory: z.string().nullish(),
24
+ legalBasis: z.string().nullish(),
25
+ isActive: z.boolean().prefault(true),
26
+ createdAt: z.date().prefault(() => new Date()),
27
+ updatedAt: z.date().prefault(() => new Date()),
28
+ });
29
+
30
+ export type ConsentPurpose = z.infer<typeof consentPurposeSchema>;
@@ -0,0 +1,22 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const consentRecordTable = table('consentRecord', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ subjectId: column('subjectId', 'string'),
7
+ consentId: column('consentId', 'string').nullable(),
8
+ actionType: column('actionType', 'string'),
9
+ details: column('details', 'json').nullable(),
10
+ createdAt: column('createdAt', 'timestamp').defaultTo$('now'),
11
+ });
12
+
13
+ export const consentRecordSchema = z.object({
14
+ id: z.string(),
15
+ subjectId: z.string(),
16
+ consentId: z.string().nullish(),
17
+ actionType: z.string(),
18
+ details: z.record(z.string(), z.unknown()).nullish(),
19
+ createdAt: z.date().prefault(() => new Date()),
20
+ });
21
+
22
+ export type ConsentRecord = z.infer<typeof consentRecordSchema>;
@@ -0,0 +1,38 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const consentTable = table('consent', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ subjectId: column('subjectId', 'string'),
7
+ domainId: column('domainId', 'string'),
8
+ policyId: column('policyId', 'string').nullable(),
9
+ purposeIds: column('purposeIds', 'json'),
10
+ metadata: column('metadata', 'json').nullable(),
11
+ ipAddress: column('ipAddress', 'string').nullable(),
12
+ userAgent: column('userAgent', 'string').nullable(),
13
+ status: column('status', 'string').defaultTo$(() => 'active'),
14
+ withdrawalReason: column('withdrawalReason', 'string').nullable(),
15
+ givenAt: column('givenAt', 'timestamp').defaultTo$('now'),
16
+ validUntil: column('validUntil', 'timestamp').nullable(),
17
+ isActive: column('isActive', 'bool').defaultTo$(() => true),
18
+ });
19
+
20
+ export const consentStatusSchema = z.enum(['active', 'withdrawn', 'expired']);
21
+
22
+ export const consentSchema = z.object({
23
+ id: z.string(),
24
+ subjectId: z.string(),
25
+ domainId: z.string(),
26
+ purposeIds: z.array(z.string()),
27
+ metadata: z.record(z.string(), z.unknown()).nullish(),
28
+ policyId: z.string().optional(),
29
+ ipAddress: z.string().nullish(),
30
+ userAgent: z.string().nullish(),
31
+ status: consentStatusSchema.prefault('active'),
32
+ withdrawalReason: z.string().nullish(),
33
+ givenAt: z.date().prefault(() => new Date()),
34
+ validUntil: z.date().nullish(),
35
+ isActive: z.boolean().prefault(true),
36
+ });
37
+
38
+ export type Consent = z.infer<typeof consentSchema>;
@@ -0,0 +1,26 @@
1
+ import { column, idColumn, table } from 'fumadb/schema';
2
+ import { z } from 'zod';
3
+
4
+ export const domainTable = table('domain', {
5
+ id: idColumn('id', 'varchar(255)'),
6
+ name: column('name', 'string').unique(),
7
+ description: column('description', 'string').nullable(),
8
+ allowedOrigins: column('allowedOrigins', 'json').nullable(),
9
+ isVerified: column('isVerified', 'bool').defaultTo$(() => true),
10
+ isActive: column('isActive', 'bool').defaultTo$(() => true),
11
+ createdAt: column('createdAt', 'timestamp').defaultTo$('now'),
12
+ updatedAt: column('updatedAt', 'timestamp').defaultTo$('now'),
13
+ });
14
+
15
+ export const domainSchema = z.object({
16
+ id: z.string(),
17
+ name: z.string(),
18
+ description: z.string().nullish(),
19
+ allowedOrigins: z.array(z.string()).nullish(),
20
+ isVerified: z.boolean().prefault(true),
21
+ isActive: z.boolean().prefault(true),
22
+ createdAt: z.date().prefault(() => new Date()),
23
+ updatedAt: z.date().prefault(() => new Date()),
24
+ });
25
+
26
+ export type Domain = z.infer<typeof domainSchema>;