@venizia/ignis-connectors 0.4.7-7 → 0.4.8-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 (366) hide show
  1. package/dist/esm/common/driver-data-source.js.map +1 -1
  2. package/dist/esm/common/internal/echo.js.map +1 -1
  3. package/dist/esm/common/scope-filter.d.ts +8 -0
  4. package/dist/esm/common/scope-filter.js +78 -3
  5. package/dist/esm/common/scope-filter.js.map +1 -1
  6. package/dist/esm/http/common/wire.js.map +1 -1
  7. package/dist/esm/http/datasource.js.map +1 -1
  8. package/dist/esm/http/repository.js.map +1 -1
  9. package/dist/esm/relational/core/datasources/base.js.map +1 -1
  10. package/dist/esm/relational/core/datasources/relation-pairing.js.map +1 -1
  11. package/dist/esm/relational/core/datasources/transaction-lifecycle.js.map +1 -1
  12. package/dist/esm/relational/core/migrations/runner.js.map +1 -1
  13. package/dist/esm/relational/core/models/base.js.map +1 -1
  14. package/dist/esm/relational/core/models/enrichers/audit-user.js.map +1 -1
  15. package/dist/esm/relational/core/models/factory.js.map +1 -1
  16. package/dist/esm/relational/core/repositories/common/executor.d.ts +2 -0
  17. package/dist/esm/relational/core/repositories/common/executor.js.map +1 -1
  18. package/dist/esm/relational/core/repositories/common/index.d.ts +0 -1
  19. package/dist/esm/relational/core/repositories/common/index.js +0 -1
  20. package/dist/esm/relational/core/repositories/common/index.js.map +1 -1
  21. package/dist/esm/relational/core/repositories/common/scope-through.d.ts +39 -0
  22. package/dist/esm/relational/core/repositories/common/scope-through.js +86 -0
  23. package/dist/esm/relational/core/repositories/common/scope-through.js.map +1 -0
  24. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts +18 -5
  25. package/dist/esm/relational/core/repositories/common/scope-write-guard.js +34 -9
  26. package/dist/esm/relational/core/repositories/common/scope-write-guard.js.map +1 -1
  27. package/dist/esm/relational/core/repositories/common/shared.js.map +1 -1
  28. package/dist/esm/relational/core/repositories/common/types.d.ts +26 -1
  29. package/dist/esm/relational/core/repositories/common/types.js.map +1 -1
  30. package/dist/esm/relational/core/repositories/core/base.d.ts +20 -7
  31. package/dist/esm/relational/core/repositories/core/base.js +62 -5
  32. package/dist/esm/relational/core/repositories/core/base.js.map +1 -1
  33. package/dist/esm/relational/core/repositories/core/persistable.d.ts +21 -2
  34. package/dist/esm/relational/core/repositories/core/persistable.js +54 -6
  35. package/dist/esm/relational/core/repositories/core/persistable.js.map +1 -1
  36. package/dist/esm/relational/core/repositories/core/readable.js.map +1 -1
  37. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts +1 -1
  38. package/dist/esm/relational/core/repositories/core/soft-deletable.js +12 -6
  39. package/dist/esm/relational/core/repositories/core/soft-deletable.js.map +1 -1
  40. package/dist/esm/relational/core/repositories/dialect/filter.d.ts +35 -5
  41. package/dist/esm/relational/core/repositories/dialect/filter.js +72 -17
  42. package/dist/esm/relational/core/repositories/dialect/filter.js.map +1 -1
  43. package/dist/esm/relational/core/repositories/dialect/internal/json-utils.js.map +1 -1
  44. package/dist/esm/relational/core/repositories/dialect/query-operators.d.ts +35 -0
  45. package/dist/esm/relational/core/repositories/dialect/query-operators.js +80 -0
  46. package/dist/esm/relational/core/repositories/dialect/query-operators.js.map +1 -0
  47. package/dist/esm/relational/core/repositories/dialect/relations/create.js.map +1 -1
  48. package/dist/esm/relational/core/repositories/dialect/relations/one.js.map +1 -1
  49. package/dist/esm/relational/postgres/datasources/abstract.js.map +1 -1
  50. package/dist/esm/relational/postgres/drivers/node-postgres.js.map +1 -1
  51. package/dist/esm/relational/postgres/drivers/pglite.js.map +1 -1
  52. package/dist/esm/relational/postgres/drivers/postgres-js.js.map +1 -1
  53. package/dist/esm/relational/postgres/models/common/columns.js.map +1 -1
  54. package/dist/esm/relational/postgres/models/enrichers/data-type.enricher.js.map +1 -1
  55. package/dist/esm/relational/postgres/models/enrichers/id.enricher.js.map +1 -1
  56. package/dist/esm/relational/postgres/models/enrichers/principal.enricher.js.map +1 -1
  57. package/dist/esm/relational/postgres/models/enrichers/tz.enricher.js.map +1 -1
  58. package/dist/esm/relational/postgres/models/enrichers/user-audit.enricher.js.map +1 -1
  59. package/dist/esm/relational/postgres/repositories/dialect/internal/json-path.js.map +1 -1
  60. package/dist/esm/relational/postgres/repositories/dialect/query.d.ts +9 -9
  61. package/dist/esm/relational/postgres/repositories/dialect/query.js +4 -60
  62. package/dist/esm/relational/postgres/repositories/dialect/query.js.map +1 -1
  63. package/dist/esm/relational/postgres/repositories/dialect/update.js.map +1 -1
  64. package/dist/esm/relational/postgres/repositories/executor.d.ts +1 -0
  65. package/dist/esm/relational/postgres/repositories/executor.js +3 -0
  66. package/dist/esm/relational/postgres/repositories/executor.js.map +1 -1
  67. package/dist/esm/relational/sqlite/datasources/abstract.js.map +1 -1
  68. package/dist/esm/relational/sqlite/drivers/libsql.js.map +1 -1
  69. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.js.map +1 -1
  70. package/dist/esm/relational/sqlite/repositories/dialect/query.d.ts +9 -9
  71. package/dist/esm/relational/sqlite/repositories/dialect/query.js +6 -63
  72. package/dist/esm/relational/sqlite/repositories/dialect/query.js.map +1 -1
  73. package/dist/esm/relational/sqlite/repositories/dialect/update.js.map +1 -1
  74. package/dist/esm/relational/sqlite/repositories/executor.d.ts +1 -0
  75. package/dist/esm/relational/sqlite/repositories/executor.js +1 -0
  76. package/dist/esm/relational/sqlite/repositories/executor.js.map +1 -1
  77. package/dist/esm/search/core/connector.js.map +1 -1
  78. package/dist/esm/search/core/controllers/abstract.js.map +1 -1
  79. package/dist/esm/search/core/controllers/factory.js.map +1 -1
  80. package/dist/esm/search/core/controllers/scope.js.map +1 -1
  81. package/dist/esm/search/core/datasources/base.js.map +1 -1
  82. package/dist/esm/search/core/internal/search-connector-internal.js.map +1 -1
  83. package/dist/esm/search/core/models/base.js.map +1 -1
  84. package/dist/esm/search/core/models/common/types/document.d.ts +3 -1
  85. package/dist/esm/search/core/models/common/types/document.js.map +1 -1
  86. package/dist/esm/search/core/models/common/types/field.d.ts +7 -1
  87. package/dist/esm/search/core/models/common/types/field.js.map +1 -1
  88. package/dist/esm/search/core/models/define-search-collection.js +9 -1
  89. package/dist/esm/search/core/models/define-search-collection.js.map +1 -1
  90. package/dist/esm/search/core/models/zod-derivation.d.ts +3 -1
  91. package/dist/esm/search/core/models/zod-derivation.js +9 -3
  92. package/dist/esm/search/core/models/zod-derivation.js.map +1 -1
  93. package/dist/esm/search/core/repositories/common/dialect-helpers.d.ts +5 -1
  94. package/dist/esm/search/core/repositories/common/dialect-helpers.js +8 -4
  95. package/dist/esm/search/core/repositories/common/dialect-helpers.js.map +1 -1
  96. package/dist/esm/search/core/repositories/common/query-params.js.map +1 -1
  97. package/dist/esm/search/core/repositories/core/base.d.ts +21 -3
  98. package/dist/esm/search/core/repositories/core/base.js +41 -6
  99. package/dist/esm/search/core/repositories/core/base.js.map +1 -1
  100. package/dist/esm/search/core/repositories/core/persistable.d.ts +1 -1
  101. package/dist/esm/search/core/repositories/core/persistable.js +7 -7
  102. package/dist/esm/search/core/repositories/core/persistable.js.map +1 -1
  103. package/dist/esm/search/core/repositories/core/readable.d.ts +3 -3
  104. package/dist/esm/search/core/repositories/core/readable.js +10 -10
  105. package/dist/esm/search/core/repositories/core/readable.js.map +1 -1
  106. package/dist/esm/search/meilisearch/connector.js.map +1 -1
  107. package/dist/esm/search/meilisearch/internal/connector-internal.js.map +1 -1
  108. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js +4 -2
  109. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.js.map +1 -1
  110. package/dist/esm/search/typesense/compiler.js.map +1 -1
  111. package/dist/esm/search/typesense/connector.js.map +1 -1
  112. package/dist/esm/search/typesense/internal/connector-internal.js.map +1 -1
  113. package/dist/esm/search/typesense/internal/guards.js.map +1 -1
  114. package/dist/esm/search/typesense/internal/mappers.js.map +1 -1
  115. package/dist/esm/search/typesense/internal/pagination-windows.js.map +1 -1
  116. package/dist/esm/search/typesense/repositories/common/types.d.ts +5 -0
  117. package/dist/esm/search/typesense/repositories/common/types.js.map +1 -1
  118. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js +69 -15
  119. package/dist/esm/search/typesense/repositories/dialect/query-dialect.js.map +1 -1
  120. package/dist/esm/testing/index.d.ts +1 -0
  121. package/dist/esm/testing/index.js +1 -0
  122. package/dist/esm/testing/index.js.map +1 -1
  123. package/dist/esm/testing/repository-double.d.ts +24 -0
  124. package/dist/esm/testing/repository-double.js +23 -0
  125. package/dist/esm/testing/repository-double.js.map +1 -0
  126. package/package.json +7 -6
  127. package/dist/esm/common/driver-data-source.d.ts.map +0 -1
  128. package/dist/esm/common/driver.d.ts.map +0 -1
  129. package/dist/esm/common/index.d.ts.map +0 -1
  130. package/dist/esm/common/internal/echo.d.ts.map +0 -1
  131. package/dist/esm/common/internal/index.d.ts.map +0 -1
  132. package/dist/esm/common/internal/record.d.ts.map +0 -1
  133. package/dist/esm/common/scope-filter.d.ts.map +0 -1
  134. package/dist/esm/http/common/constants.d.ts.map +0 -1
  135. package/dist/esm/http/common/readers.d.ts.map +0 -1
  136. package/dist/esm/http/common/types.d.ts.map +0 -1
  137. package/dist/esm/http/common/wire.d.ts.map +0 -1
  138. package/dist/esm/http/datasource.d.ts.map +0 -1
  139. package/dist/esm/http/index.d.ts.map +0 -1
  140. package/dist/esm/http/repository.d.ts.map +0 -1
  141. package/dist/esm/index.d.ts.map +0 -1
  142. package/dist/esm/raw-sql/common/index.d.ts.map +0 -1
  143. package/dist/esm/raw-sql/common/types.d.ts.map +0 -1
  144. package/dist/esm/raw-sql/datasource.d.ts.map +0 -1
  145. package/dist/esm/raw-sql/index.d.ts.map +0 -1
  146. package/dist/esm/raw-sql/repository.d.ts.map +0 -1
  147. package/dist/esm/relational/core/datasources/abstract.d.ts.map +0 -1
  148. package/dist/esm/relational/core/datasources/base.d.ts.map +0 -1
  149. package/dist/esm/relational/core/datasources/common/guards.d.ts.map +0 -1
  150. package/dist/esm/relational/core/datasources/common/index.d.ts.map +0 -1
  151. package/dist/esm/relational/core/datasources/common/types.d.ts.map +0 -1
  152. package/dist/esm/relational/core/datasources/index.d.ts.map +0 -1
  153. package/dist/esm/relational/core/datasources/relation-pairing.d.ts.map +0 -1
  154. package/dist/esm/relational/core/datasources/transaction-lifecycle.d.ts.map +0 -1
  155. package/dist/esm/relational/core/drivers/driver.d.ts.map +0 -1
  156. package/dist/esm/relational/core/drivers/index.d.ts.map +0 -1
  157. package/dist/esm/relational/core/index.d.ts.map +0 -1
  158. package/dist/esm/relational/core/migrations/index.d.ts.map +0 -1
  159. package/dist/esm/relational/core/migrations/runner.d.ts.map +0 -1
  160. package/dist/esm/relational/core/models/base.d.ts.map +0 -1
  161. package/dist/esm/relational/core/models/common/constants.d.ts.map +0 -1
  162. package/dist/esm/relational/core/models/common/index.d.ts.map +0 -1
  163. package/dist/esm/relational/core/models/common/types.d.ts.map +0 -1
  164. package/dist/esm/relational/core/models/enrichers/audit-user.d.ts.map +0 -1
  165. package/dist/esm/relational/core/models/enrichers/index.d.ts.map +0 -1
  166. package/dist/esm/relational/core/models/factory.d.ts.map +0 -1
  167. package/dist/esm/relational/core/models/index.d.ts.map +0 -1
  168. package/dist/esm/relational/core/models/relations.d.ts.map +0 -1
  169. package/dist/esm/relational/core/repositories/common/constants.d.ts +0 -11
  170. package/dist/esm/relational/core/repositories/common/constants.d.ts.map +0 -1
  171. package/dist/esm/relational/core/repositories/common/constants.js +0 -10
  172. package/dist/esm/relational/core/repositories/common/constants.js.map +0 -1
  173. package/dist/esm/relational/core/repositories/common/executor.d.ts.map +0 -1
  174. package/dist/esm/relational/core/repositories/common/index.d.ts.map +0 -1
  175. package/dist/esm/relational/core/repositories/common/scope-filter.d.ts.map +0 -1
  176. package/dist/esm/relational/core/repositories/common/scope-write-guard.d.ts.map +0 -1
  177. package/dist/esm/relational/core/repositories/common/shared.d.ts.map +0 -1
  178. package/dist/esm/relational/core/repositories/common/types.d.ts.map +0 -1
  179. package/dist/esm/relational/core/repositories/core/base.d.ts.map +0 -1
  180. package/dist/esm/relational/core/repositories/core/default.d.ts.map +0 -1
  181. package/dist/esm/relational/core/repositories/core/index.d.ts.map +0 -1
  182. package/dist/esm/relational/core/repositories/core/persistable.d.ts.map +0 -1
  183. package/dist/esm/relational/core/repositories/core/readable.d.ts.map +0 -1
  184. package/dist/esm/relational/core/repositories/core/soft-deletable.d.ts.map +0 -1
  185. package/dist/esm/relational/core/repositories/dialect/filter.d.ts.map +0 -1
  186. package/dist/esm/relational/core/repositories/dialect/index.d.ts.map +0 -1
  187. package/dist/esm/relational/core/repositories/dialect/internal/index.d.ts.map +0 -1
  188. package/dist/esm/relational/core/repositories/dialect/internal/json-utils.d.ts.map +0 -1
  189. package/dist/esm/relational/core/repositories/dialect/internal/subquery.d.ts.map +0 -1
  190. package/dist/esm/relational/core/repositories/dialect/relations/common/constants.d.ts.map +0 -1
  191. package/dist/esm/relational/core/repositories/dialect/relations/common/index.d.ts.map +0 -1
  192. package/dist/esm/relational/core/repositories/dialect/relations/common/types.d.ts.map +0 -1
  193. package/dist/esm/relational/core/repositories/dialect/relations/create.d.ts.map +0 -1
  194. package/dist/esm/relational/core/repositories/dialect/relations/index.d.ts.map +0 -1
  195. package/dist/esm/relational/core/repositories/dialect/relations/many.d.ts.map +0 -1
  196. package/dist/esm/relational/core/repositories/dialect/relations/one.d.ts.map +0 -1
  197. package/dist/esm/relational/core/repositories/dialect/update.d.ts.map +0 -1
  198. package/dist/esm/relational/core/repositories/index.d.ts.map +0 -1
  199. package/dist/esm/relational/core/repositories/sqls/index.d.ts.map +0 -1
  200. package/dist/esm/relational/core/repositories/sqls/recursive-tree.d.ts.map +0 -1
  201. package/dist/esm/relational/postgres/datasources/abstract.d.ts.map +0 -1
  202. package/dist/esm/relational/postgres/datasources/base.d.ts.map +0 -1
  203. package/dist/esm/relational/postgres/datasources/common/guards.d.ts.map +0 -1
  204. package/dist/esm/relational/postgres/datasources/common/index.d.ts.map +0 -1
  205. package/dist/esm/relational/postgres/datasources/common/types.d.ts.map +0 -1
  206. package/dist/esm/relational/postgres/datasources/index.d.ts.map +0 -1
  207. package/dist/esm/relational/postgres/drivers/driver.d.ts.map +0 -1
  208. package/dist/esm/relational/postgres/drivers/index.d.ts.map +0 -1
  209. package/dist/esm/relational/postgres/drivers/node-postgres.d.ts.map +0 -1
  210. package/dist/esm/relational/postgres/drivers/pglite.d.ts.map +0 -1
  211. package/dist/esm/relational/postgres/drivers/postgres-js.d.ts.map +0 -1
  212. package/dist/esm/relational/postgres/index.d.ts.map +0 -1
  213. package/dist/esm/relational/postgres/models/base.d.ts.map +0 -1
  214. package/dist/esm/relational/postgres/models/common/columns.d.ts.map +0 -1
  215. package/dist/esm/relational/postgres/models/common/constants.d.ts.map +0 -1
  216. package/dist/esm/relational/postgres/models/common/index.d.ts.map +0 -1
  217. package/dist/esm/relational/postgres/models/common/types/enrichers.d.ts.map +0 -1
  218. package/dist/esm/relational/postgres/models/common/types/index.d.ts.map +0 -1
  219. package/dist/esm/relational/postgres/models/common/types/table.d.ts.map +0 -1
  220. package/dist/esm/relational/postgres/models/enrichers/data-type.enricher.d.ts.map +0 -1
  221. package/dist/esm/relational/postgres/models/enrichers/id.enricher.d.ts.map +0 -1
  222. package/dist/esm/relational/postgres/models/enrichers/index.d.ts.map +0 -1
  223. package/dist/esm/relational/postgres/models/enrichers/principal.enricher.d.ts.map +0 -1
  224. package/dist/esm/relational/postgres/models/enrichers/tz.enricher.d.ts.map +0 -1
  225. package/dist/esm/relational/postgres/models/enrichers/user-audit.enricher.d.ts.map +0 -1
  226. package/dist/esm/relational/postgres/models/index.d.ts.map +0 -1
  227. package/dist/esm/relational/postgres/repositories/common/index.d.ts.map +0 -1
  228. package/dist/esm/relational/postgres/repositories/common/shared.d.ts.map +0 -1
  229. package/dist/esm/relational/postgres/repositories/common/types.d.ts.map +0 -1
  230. package/dist/esm/relational/postgres/repositories/core/base.d.ts.map +0 -1
  231. package/dist/esm/relational/postgres/repositories/core/default.d.ts.map +0 -1
  232. package/dist/esm/relational/postgres/repositories/core/index.d.ts.map +0 -1
  233. package/dist/esm/relational/postgres/repositories/core/persistable.d.ts.map +0 -1
  234. package/dist/esm/relational/postgres/repositories/core/readable.d.ts.map +0 -1
  235. package/dist/esm/relational/postgres/repositories/core/soft-deletable.d.ts.map +0 -1
  236. package/dist/esm/relational/postgres/repositories/dialect/filter.d.ts.map +0 -1
  237. package/dist/esm/relational/postgres/repositories/dialect/index.d.ts.map +0 -1
  238. package/dist/esm/relational/postgres/repositories/dialect/internal/index.d.ts.map +0 -1
  239. package/dist/esm/relational/postgres/repositories/dialect/internal/json-path.d.ts.map +0 -1
  240. package/dist/esm/relational/postgres/repositories/dialect/query-dialect.d.ts.map +0 -1
  241. package/dist/esm/relational/postgres/repositories/dialect/query.d.ts.map +0 -1
  242. package/dist/esm/relational/postgres/repositories/dialect/relation.d.ts.map +0 -1
  243. package/dist/esm/relational/postgres/repositories/dialect/update.d.ts.map +0 -1
  244. package/dist/esm/relational/postgres/repositories/executor.d.ts.map +0 -1
  245. package/dist/esm/relational/postgres/repositories/index.d.ts.map +0 -1
  246. package/dist/esm/relational/postgres/supabase/index.d.ts.map +0 -1
  247. package/dist/esm/relational/postgres/supabase/pooler.d.ts.map +0 -1
  248. package/dist/esm/relational/postgres/supabase/rls.d.ts.map +0 -1
  249. package/dist/esm/relational/sqlite/datasources/abstract.d.ts.map +0 -1
  250. package/dist/esm/relational/sqlite/datasources/base.d.ts.map +0 -1
  251. package/dist/esm/relational/sqlite/datasources/common/index.d.ts.map +0 -1
  252. package/dist/esm/relational/sqlite/datasources/common/types.d.ts.map +0 -1
  253. package/dist/esm/relational/sqlite/datasources/index.d.ts.map +0 -1
  254. package/dist/esm/relational/sqlite/drivers/driver.d.ts.map +0 -1
  255. package/dist/esm/relational/sqlite/drivers/index.d.ts.map +0 -1
  256. package/dist/esm/relational/sqlite/drivers/libsql.d.ts.map +0 -1
  257. package/dist/esm/relational/sqlite/index.d.ts.map +0 -1
  258. package/dist/esm/relational/sqlite/models/base.d.ts.map +0 -1
  259. package/dist/esm/relational/sqlite/models/common/columns.d.ts.map +0 -1
  260. package/dist/esm/relational/sqlite/models/common/index.d.ts.map +0 -1
  261. package/dist/esm/relational/sqlite/models/common/types/enrichers.d.ts.map +0 -1
  262. package/dist/esm/relational/sqlite/models/common/types/index.d.ts.map +0 -1
  263. package/dist/esm/relational/sqlite/models/common/types/table.d.ts.map +0 -1
  264. package/dist/esm/relational/sqlite/models/enrichers/data-type.enricher.d.ts.map +0 -1
  265. package/dist/esm/relational/sqlite/models/enrichers/id.enricher.d.ts.map +0 -1
  266. package/dist/esm/relational/sqlite/models/enrichers/index.d.ts.map +0 -1
  267. package/dist/esm/relational/sqlite/models/enrichers/principal.enricher.d.ts.map +0 -1
  268. package/dist/esm/relational/sqlite/models/enrichers/tz.enricher.d.ts.map +0 -1
  269. package/dist/esm/relational/sqlite/models/enrichers/user-audit.enricher.d.ts.map +0 -1
  270. package/dist/esm/relational/sqlite/models/index.d.ts.map +0 -1
  271. package/dist/esm/relational/sqlite/repositories/common/index.d.ts.map +0 -1
  272. package/dist/esm/relational/sqlite/repositories/common/types.d.ts.map +0 -1
  273. package/dist/esm/relational/sqlite/repositories/core/base.d.ts.map +0 -1
  274. package/dist/esm/relational/sqlite/repositories/core/default.d.ts.map +0 -1
  275. package/dist/esm/relational/sqlite/repositories/core/index.d.ts.map +0 -1
  276. package/dist/esm/relational/sqlite/repositories/core/persistable.d.ts.map +0 -1
  277. package/dist/esm/relational/sqlite/repositories/core/readable.d.ts.map +0 -1
  278. package/dist/esm/relational/sqlite/repositories/core/soft-deletable.d.ts.map +0 -1
  279. package/dist/esm/relational/sqlite/repositories/dialect/filter.d.ts.map +0 -1
  280. package/dist/esm/relational/sqlite/repositories/dialect/index.d.ts.map +0 -1
  281. package/dist/esm/relational/sqlite/repositories/dialect/internal/index.d.ts.map +0 -1
  282. package/dist/esm/relational/sqlite/repositories/dialect/internal/json-path.d.ts.map +0 -1
  283. package/dist/esm/relational/sqlite/repositories/dialect/query-dialect.d.ts.map +0 -1
  284. package/dist/esm/relational/sqlite/repositories/dialect/query.d.ts.map +0 -1
  285. package/dist/esm/relational/sqlite/repositories/dialect/update.d.ts.map +0 -1
  286. package/dist/esm/relational/sqlite/repositories/executor.d.ts.map +0 -1
  287. package/dist/esm/relational/sqlite/repositories/index.d.ts.map +0 -1
  288. package/dist/esm/search/core/common/errors.d.ts.map +0 -1
  289. package/dist/esm/search/core/common/index.d.ts.map +0 -1
  290. package/dist/esm/search/core/connector.d.ts.map +0 -1
  291. package/dist/esm/search/core/controllers/abstract.d.ts.map +0 -1
  292. package/dist/esm/search/core/controllers/factory.d.ts.map +0 -1
  293. package/dist/esm/search/core/controllers/index.d.ts.map +0 -1
  294. package/dist/esm/search/core/controllers/scope.d.ts.map +0 -1
  295. package/dist/esm/search/core/datasources/abstract.d.ts.map +0 -1
  296. package/dist/esm/search/core/datasources/base.d.ts.map +0 -1
  297. package/dist/esm/search/core/datasources/common/index.d.ts.map +0 -1
  298. package/dist/esm/search/core/datasources/common/types.d.ts.map +0 -1
  299. package/dist/esm/search/core/datasources/guards.d.ts.map +0 -1
  300. package/dist/esm/search/core/datasources/index.d.ts.map +0 -1
  301. package/dist/esm/search/core/index.d.ts.map +0 -1
  302. package/dist/esm/search/core/internal/index.d.ts.map +0 -1
  303. package/dist/esm/search/core/internal/search-connector-internal.d.ts.map +0 -1
  304. package/dist/esm/search/core/models/base.d.ts.map +0 -1
  305. package/dist/esm/search/core/models/common/constants.d.ts.map +0 -1
  306. package/dist/esm/search/core/models/common/index.d.ts.map +0 -1
  307. package/dist/esm/search/core/models/common/types/collection.d.ts.map +0 -1
  308. package/dist/esm/search/core/models/common/types/document.d.ts.map +0 -1
  309. package/dist/esm/search/core/models/common/types/embedding.d.ts.map +0 -1
  310. package/dist/esm/search/core/models/common/types/field.d.ts.map +0 -1
  311. package/dist/esm/search/core/models/common/types/index.d.ts.map +0 -1
  312. package/dist/esm/search/core/models/define-search-collection.d.ts.map +0 -1
  313. package/dist/esm/search/core/models/index.d.ts.map +0 -1
  314. package/dist/esm/search/core/models/zod-derivation.d.ts.map +0 -1
  315. package/dist/esm/search/core/repositories/common/constants.d.ts.map +0 -1
  316. package/dist/esm/search/core/repositories/common/dialect-helpers.d.ts.map +0 -1
  317. package/dist/esm/search/core/repositories/common/index.d.ts.map +0 -1
  318. package/dist/esm/search/core/repositories/common/query-params.d.ts.map +0 -1
  319. package/dist/esm/search/core/repositories/common/types.d.ts.map +0 -1
  320. package/dist/esm/search/core/repositories/core/base.d.ts.map +0 -1
  321. package/dist/esm/search/core/repositories/core/default.d.ts.map +0 -1
  322. package/dist/esm/search/core/repositories/core/guards.d.ts.map +0 -1
  323. package/dist/esm/search/core/repositories/core/index.d.ts.map +0 -1
  324. package/dist/esm/search/core/repositories/core/persistable.d.ts.map +0 -1
  325. package/dist/esm/search/core/repositories/core/readable.d.ts.map +0 -1
  326. package/dist/esm/search/core/repositories/index.d.ts.map +0 -1
  327. package/dist/esm/search/meilisearch/common/index.d.ts.map +0 -1
  328. package/dist/esm/search/meilisearch/common/types.d.ts.map +0 -1
  329. package/dist/esm/search/meilisearch/compiler.d.ts.map +0 -1
  330. package/dist/esm/search/meilisearch/connector.d.ts.map +0 -1
  331. package/dist/esm/search/meilisearch/datasources/datasource.d.ts.map +0 -1
  332. package/dist/esm/search/meilisearch/datasources/index.d.ts.map +0 -1
  333. package/dist/esm/search/meilisearch/index.d.ts.map +0 -1
  334. package/dist/esm/search/meilisearch/internal/connector-internal.d.ts.map +0 -1
  335. package/dist/esm/search/meilisearch/internal/index.d.ts.map +0 -1
  336. package/dist/esm/search/meilisearch/repositories/common/index.d.ts.map +0 -1
  337. package/dist/esm/search/meilisearch/repositories/common/types.d.ts.map +0 -1
  338. package/dist/esm/search/meilisearch/repositories/dialect/index.d.ts.map +0 -1
  339. package/dist/esm/search/meilisearch/repositories/dialect/query-dialect.d.ts.map +0 -1
  340. package/dist/esm/search/meilisearch/repositories/index.d.ts.map +0 -1
  341. package/dist/esm/search/typesense/common/constants.d.ts.map +0 -1
  342. package/dist/esm/search/typesense/common/index.d.ts.map +0 -1
  343. package/dist/esm/search/typesense/common/types/client.d.ts.map +0 -1
  344. package/dist/esm/search/typesense/common/types/index.d.ts.map +0 -1
  345. package/dist/esm/search/typesense/common/types/options.d.ts.map +0 -1
  346. package/dist/esm/search/typesense/common/types/schema.d.ts.map +0 -1
  347. package/dist/esm/search/typesense/common/types/search.d.ts.map +0 -1
  348. package/dist/esm/search/typesense/compiler.d.ts.map +0 -1
  349. package/dist/esm/search/typesense/connector.d.ts.map +0 -1
  350. package/dist/esm/search/typesense/controllers/index.d.ts.map +0 -1
  351. package/dist/esm/search/typesense/datasources/datasource.d.ts.map +0 -1
  352. package/dist/esm/search/typesense/datasources/index.d.ts.map +0 -1
  353. package/dist/esm/search/typesense/index.d.ts.map +0 -1
  354. package/dist/esm/search/typesense/internal/connector-internal.d.ts.map +0 -1
  355. package/dist/esm/search/typesense/internal/guards.d.ts.map +0 -1
  356. package/dist/esm/search/typesense/internal/index.d.ts.map +0 -1
  357. package/dist/esm/search/typesense/internal/mappers.d.ts.map +0 -1
  358. package/dist/esm/search/typesense/internal/outcomes.d.ts.map +0 -1
  359. package/dist/esm/search/typesense/internal/pagination-windows.d.ts.map +0 -1
  360. package/dist/esm/search/typesense/repositories/common/index.d.ts.map +0 -1
  361. package/dist/esm/search/typesense/repositories/common/types.d.ts.map +0 -1
  362. package/dist/esm/search/typesense/repositories/dialect/index.d.ts.map +0 -1
  363. package/dist/esm/search/typesense/repositories/dialect/query-dialect.d.ts.map +0 -1
  364. package/dist/esm/search/typesense/repositories/index.d.ts.map +0 -1
  365. package/dist/esm/testing/index.d.ts.map +0 -1
  366. package/dist/esm/testing/transaction-double.d.ts.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it.\n */\n protected wireDriverFromMetadata(): void {\n if (this.connector) {\n return;\n }\n\n if (this.driver) {\n this.connector = this.driver.createConnector({ schema: this.getSchema() });\n return;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n this.useDriver({ driver: new DriverClass({ client: this.client }) });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): void {\n this.driver = opts.driver;\n this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.wireDriverFromMetadata();\n return this.connector;\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n this.closePromise ??= this.endConnection();\n return this.closePromise;\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n const oldClient = this.getClient() as AnyType;\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...(this.settings as AnyObject) };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.\n Object.assign(this.settings as AnyObject, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client as AnyType;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = new DriverClass({ client: newClient as AnyType });\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient as AnyType;\n this.driver = newDriver;\n this.connector = newConnector as AnyType;\n\n const isDrained = await this.drainClient({ client: oldClient });\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: AnyObject }): void {\n const settings = this.settings as AnyObject;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n delete settings[key];\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const client = opts.client as AnyType;\n\n const drain = typeof client?.end === 'function' ? client.end : client?.close;\n\n if (typeof drain !== 'function') {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n return false;\n }\n\n await drain.call(client);\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): AnyObject {\n const { username, password } = opts.secret;\n const mapped: AnyObject = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
1
+ {"version":3,"file":"driver-data-source.js","sourceRoot":"","sources":["../../../src/common/driver-data-source.ts"],"names":[],"mappings":"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","sourcesContent":["import type { TAnyDataSourceSchema } from '@venizia/ignis-kernel';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { MetadataRegistry } from '@venizia/ignis-kernel/metadata';\nimport type { AnyObject, AnyType, TClass } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { IConnectorDriver } from './driver';\n\n/**\n * A datasource that holds one client and a connector built over it through a driver: the lifecycle\n * every connector family that talks to an external engine shares - wiring the driver named by\n * `@datasource({ driver })`, closing once, soft-evicting the client after a secret rotation, draining\n * a client by whichever verb its engine spells it with. No SQL members: the relational family adds\n * its dialect, executor and transactions in `AbstractRelationalDataSource`, a raw-SQL engine adds\n * nothing (`BaseRawSqlDataSource`). Transactions stay NotSupported, as in `AbstractDataSource`.\n *\n * `mapSecretToSettings` is a driver-config convention, not Postgres SQL, so it belongs on this\n * neutral base - do not move it down into a family.\n */\nexport abstract class AbstractDriverDataSource<\n Settings extends object = {},\n Schema extends TAnyDataSourceSchema = TAnyDataSourceSchema,\n ConfigurableOptions extends object = {},\n Client = unknown,\n TConnector = unknown,\n TDriver extends IConnectorDriver<TConnector, AnyType> = IConnectorDriver<TConnector, Client>,\n> extends AbstractDataSource<Settings, Schema, ConfigurableOptions> {\n connector: TConnector;\n\n protected client?: Client;\n protected driver?: TDriver;\n\n private closePromise?: Promise<void>;\n\n /**\n * Lazy and idempotent: builds the driver named by `@datasource({ driver })` over the client\n * `configure()` assigned, then the connector from it.\n */\n protected wireDriverFromMetadata(): void {\n if (this.connector) {\n return;\n }\n\n if (this.driver) {\n this.connector = this.driver.createConnector({ schema: this.getSchema() });\n\n return;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][wireDriverFromMetadata] No driver and no client | Assign this.client in configure(), or wire a custom driver with useDriver()`,\n });\n }\n\n const DriverClass = this.resolveDriverClass();\n this.useDriver({ driver: new DriverClass({ client: this.client }) });\n }\n\n /**\n * Rejects a driver-name string from untyped JS\n * callers: a string carries no module into the bundle.\n */\n protected resolveDriverClass(): TClass<TDriver> {\n const metadata = MetadataRegistry.getInstance().getDataSourceMetadata({\n target: this.constructor,\n });\n const driver = metadata?.driver;\n\n if (typeof driver !== 'function') {\n throw getError({\n message: `[${this.constructor.name}][resolveDriverClass] @datasource({ driver }) must name a driver CLASS | Got: ${String(driver)} | Use \\`@datasource({ driver: NodePostgresDriver })\\` with \\`import { NodePostgresDriver } from '@venizia/ignis-connectors/postgres/node-postgres'\\`, or wire a custom driver with useDriver()`,\n });\n }\n\n return driver as TClass<TDriver>;\n }\n\n protected resolveDriver(): TDriver {\n this.wireDriverFromMetadata();\n\n return this.driver as TDriver;\n }\n\n /**\n * Assigns `this.driver` AND builds `this.connector` in one step - a\n * driver without its connector is silently bypassed on pooled queries.\n */\n protected useDriver(opts: { driver: TDriver; schema?: Schema }): void {\n this.driver = opts.driver;\n this.connector = opts.driver.createConnector({ schema: opts.schema ?? this.getSchema() });\n }\n\n /** Wires the driver on first use, so a `configure()` that only builds `this.client` is enough. */\n getConnector(): TConnector {\n this.wireDriverFromMetadata();\n\n return this.connector;\n }\n\n /**\n * Raw driver client (`pg.Pool` / `Sql`). Throws rather\n * than handing back an `undefined` typed as `Client`.\n */\n getClient(): Client {\n if (this.driver) {\n return this.driver.getClient() as Client;\n }\n\n if (!this.client) {\n throw getError({\n message: `[${this.constructor.name}][getClient] No driver and no client | Assign this.driver in configure()`,\n });\n }\n\n return this.client;\n }\n\n /**\n * Ends the connection `configure()` opened. Runs once: every later call returns the first call's\n * promise. Goes through the driver, wired now if nothing queried yet, because its `end()` is the\n * engine's whole teardown - PGlite also clears the exit status it plants on the host process.\n */\n override close(): Promise<void> {\n this.closePromise ??= this.endConnection();\n\n return this.closePromise;\n }\n\n private async endConnection(): Promise<void> {\n if (!this.driver && this.client === undefined) {\n return;\n }\n\n let driver: TDriver;\n\n try {\n driver = this.resolveDriver();\n } catch (error) {\n this.logger\n .for(this.close.name)\n .warn('No driver to end the connection with | draining the client | error: %s', error);\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n // A hand-made driver cast past `IConnectorDriver` can lack the `end()` its type promises.\n if (typeof driver.end !== 'function') {\n this.logger.for(this.close.name).warn('The driver has no end() | draining the client');\n await this.drainClient({ client: this.client });\n\n return;\n }\n\n await driver.end();\n }\n\n /**\n * Soft-evicts the pool after a secret rotation: rebuilds against the rotated credentials without\n * touching live fields, swaps atomically, then drains the old pool. On failure live state is\n * restored, any half-built pool drained, and the error rethrown.\n */\n async onSecretRotated(opts: { key: string; secret: Record<string, string> }): Promise<void> {\n const logger = this.logger.for(this.onSecretRotated.name);\n const oldClient = this.getClient() as AnyType;\n\n // Snapshot so a failed rebuild restores the datasource verbatim;\n // `settings` is copied because rotation mutates it in place.\n const savedClient = this.client;\n const savedSettings = { ...(this.settings as AnyObject) };\n\n // Rotation only takes effect through this.settings + configure(); a configure() that\n // hard-codes its connection string or reads the environment directly rebuilds with stale credentials.\n Object.assign(this.settings as AnyObject, this.mapSecretToSettings({ secret: opts.secret }));\n\n // configure() overwrites this.client, so the new pool is captured\n // into a local and the old client restored at once - live fields\n // are never nulled and the old pool keeps serving until the swap.\n let newClient: Client;\n\n try {\n await this.configure();\n newClient = this.client as Client;\n } catch (error) {\n const halfBuilt = this.client as AnyType;\n this.client = savedClient;\n this.restoreSettings({ saved: savedSettings });\n\n if (halfBuilt && halfBuilt !== savedClient) {\n await this.drainClient({ client: halfBuilt });\n }\n\n logger.error('Secret rotation failed in configure(); kept old pool | key: %s', opts.key);\n throw error;\n }\n\n this.client = savedClient;\n\n // Wired into locals: live state must stay on the old pool until the swap below.\n let newDriver: TDriver;\n let newConnector: TConnector;\n\n try {\n const DriverClass = this.resolveDriverClass();\n newDriver = new DriverClass({ client: newClient as AnyType });\n newConnector = newDriver.createConnector({ schema: this.getSchema() });\n } catch (error) {\n this.restoreSettings({ saved: savedSettings });\n await this.drainClient({ client: newClient });\n\n logger.error('Secret rotation failed while wiring driver; kept old pool | key: %s', opts.key);\n throw error;\n }\n\n // Commit the live fields in one synchronous step so there is no null window,\n // then soft-evict the old pool so its in-flight transactions can finish.\n this.client = newClient as AnyType;\n this.driver = newDriver;\n this.connector = newConnector as AnyType;\n\n const isDrained = await this.drainClient({ client: oldClient });\n\n if (isDrained) {\n logger.info('Old pool drained after secret rotation | key: %s', opts.key);\n }\n }\n\n /** Puts `settings` back to the snapshot: a key the failed rotation added (the rotated `password`) is removed, not left behind. */\n private restoreSettings(opts: { saved: AnyObject }): void {\n const settings = this.settings as AnyObject;\n\n for (const key of Object.keys(settings)) {\n if (!(key in opts.saved)) {\n delete settings[key];\n }\n }\n\n Object.assign(settings, opts.saved);\n }\n\n /**\n * Shuts a client down by whichever verb its engine spells it with -\n * `pg.Pool` and postgres.js have `end()`, PGlite and libsql only `close()`.\n * Probed rather than type-tested: this tier must not name an engine, and a\n * client left undrained keeps a WASM instance or file handle alive forever.\n */\n protected async drainClient(opts: { client: unknown }): Promise<boolean> {\n const client = opts.client as AnyType;\n\n const drain = typeof client?.end === 'function' ? client.end : client?.close;\n\n if (typeof drain !== 'function') {\n this.logger\n .for(this.drainClient.name)\n .warn('Client exposes neither end() nor close(); nothing to drain');\n\n return false;\n }\n\n await drain.call(client);\n\n return true;\n }\n\n /** Vault's database engine returns `{ username, password }`; pg expects `{ user, password }`. */\n protected mapSecretToSettings(opts: { secret: Record<string, string> }): AnyObject {\n const { username, password } = opts.secret;\n const mapped: AnyObject = {};\n\n if (username !== undefined) {\n mapped.user = username;\n }\n\n if (password !== undefined) {\n mapped.password = password;\n }\n\n return mapped;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"echo.js","sourceRoot":"","sources":["../../../../src/common/internal/echo.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACtB,+GAA+G;IACvG,MAAM,CAAC,gBAAgB,CAAC,IAAsB;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC;IAC7F,CAAC;IAED,gHAAgH;IAChH,MAAM,CAAC,UAAU,CAAC,IAAuB;QACvC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YACrC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACpF,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC;CACF","sourcesContent":["export class EchoUtility {\n /** C0 controls, DEL, C1 controls and the two Unicode line terminators - anything that can break a log line. */\n private static isUnsafeEchoCode(opts: { code: number }): boolean {\n const { code } = opts;\n return code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === 0x2028 || code === 0x2029;\n }\n\n /** A caller-supplied value made safe to quote in an error message: one line, every unsafe character escaped. */\n static toSafeEcho(opts: { value: string }): string {\n const { value } = opts;\n let safe = '';\n let copiedUpTo = 0;\n\n for (let index = 0; index < value.length; index++) {\n const code = value.charCodeAt(index);\n if (!EchoUtility.isUnsafeEchoCode({ code })) {\n continue;\n }\n\n safe += `${value.slice(copiedUpTo, index)}\\\\u${code.toString(16).padStart(4, '0')}`;\n copiedUpTo = index + 1;\n }\n\n return copiedUpTo === 0 ? value : safe + value.slice(copiedUpTo);\n }\n}\n"]}
1
+ {"version":3,"file":"echo.js","sourceRoot":"","sources":["../../../../src/common/internal/echo.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,WAAW;IACtB,+GAA+G;IACvG,MAAM,CAAC,gBAAgB,CAAC,IAAsB;QACpD,MAAM,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAEtB,OAAO,IAAI,GAAG,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,CAAC;IAC7F,CAAC;IAED,gHAAgH;IAChH,MAAM,CAAC,UAAU,CAAC,IAAuB;QACvC,MAAM,EAAE,KAAK,EAAE,GAAG,IAAI,CAAC;QACvB,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,UAAU,GAAG,CAAC,CAAC;QAEnB,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;YAClD,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;YAErC,IAAI,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC;gBAC5C,SAAS;YACX,CAAC;YAED,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;YACpF,UAAU,GAAG,KAAK,GAAG,CAAC,CAAC;QACzB,CAAC;QAED,OAAO,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACnE,CAAC;CACF","sourcesContent":["export class EchoUtility {\n /** C0 controls, DEL, C1 controls and the two Unicode line terminators - anything that can break a log line. */\n private static isUnsafeEchoCode(opts: { code: number }): boolean {\n const { code } = opts;\n\n return code < 0x20 || (code >= 0x7f && code <= 0x9f) || code === 0x2028 || code === 0x2029;\n }\n\n /** A caller-supplied value made safe to quote in an error message: one line, every unsafe character escaped. */\n static toSafeEcho(opts: { value: string }): string {\n const { value } = opts;\n let safe = '';\n let copiedUpTo = 0;\n\n for (let index = 0; index < value.length; index++) {\n const code = value.charCodeAt(index);\n\n if (!EchoUtility.isUnsafeEchoCode({ code })) {\n continue;\n }\n\n safe += `${value.slice(copiedUpTo, index)}\\\\u${code.toString(16).padStart(4, '0')}`;\n copiedUpTo = index + 1;\n }\n\n return copiedUpTo === 0 ? value : safe + value.slice(copiedUpTo);\n }\n}\n"]}
@@ -1,4 +1,11 @@
1
+ import type { ILogger } from '@venizia/ignis-helpers/core';
1
2
  export declare class ScopeFilterUtility {
3
+ /**
4
+ * Why a `through` chain cannot work, or undefined. Walks from `name` toward the model that holds a resolver: every
5
+ * hop needs a `one` relation with a single-column key, the parent needs an `access`, and the chain is at most
6
+ * `ScopeThroughLink.MAX_DEPTH` hops with no model twice. A key with no index is a warning: it still works, slowly.
7
+ */
8
+ private static throughProblem;
2
9
  /**
3
10
  * Refuses to boot when `settings.access` is declared where it cannot be honoured. Both cases
4
11
  * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,
@@ -7,6 +14,7 @@ export declare class ScopeFilterUtility {
7
14
  */
8
15
  static assertScopeFilterSupported(opts: {
9
16
  asyncContextEnabled: boolean;
17
+ logger?: ILogger;
10
18
  }): void;
11
19
  }
12
20
  //# sourceMappingURL=scope-filter.d.ts.map
@@ -1,9 +1,57 @@
1
1
  import { ResolverUtility } from '@venizia/ignis-helpers/common';
2
2
  import { getError } from '@venizia/ignis-helpers/core';
3
3
  import { MetadataRegistry, ScopeWriteGuards } from '@venizia/ignis-kernel';
4
+ import { ScopeThroughLink } from '../relational/core/repositories/common/scope-through.js';
4
5
  import { BaseSearchEntity } from '../search/core/models/index.js';
5
- import { getTableColumns, is, Table } from 'drizzle-orm';
6
+ import { getTableColumns, getTableName, is, Table } from 'drizzle-orm';
6
7
  export class ScopeFilterUtility {
8
+ /**
9
+ * Why a `through` chain cannot work, or undefined. Walks from `name` toward the model that holds a resolver: every
10
+ * hop needs a `one` relation with a single-column key, the parent needs an `access`, and the chain is at most
11
+ * `ScopeThroughLink.MAX_DEPTH` hops with no model twice. A key with no index is a warning: it still works, slowly.
12
+ */
13
+ static throughProblem(opts) {
14
+ const { name, models, logger } = opts;
15
+ let current = models.get(name);
16
+ const visited = new Set([current]);
17
+ let hops = 0;
18
+ while (current?.metadata?.settings?.access?.through) {
19
+ hops += 1;
20
+ if (hops > ScopeThroughLink.MAX_DEPTH) {
21
+ return `through is deeper than ${ScopeThroughLink.MAX_DEPTH} hops`;
22
+ }
23
+ const { schema } = current;
24
+ if (!is(schema, Table)) {
25
+ return 'the model has no table to read a foreign key from';
26
+ }
27
+ let link;
28
+ try {
29
+ link = ScopeThroughLink.of({
30
+ schema,
31
+ relation: current.metadata.settings.access.through.relation,
32
+ relations: ScopeThroughLink.relationsOf({ entry: current }),
33
+ });
34
+ }
35
+ catch (error) {
36
+ return error instanceof Error ? error.message : String(error);
37
+ }
38
+ if (hops === 1 && !ScopeThroughLink.isIndexed({ schema, property: link.childProperty })) {
39
+ logger
40
+ ?.for('assertScopeFilterSupported')
41
+ .warn('%s: the foreign key %s has no index, so every scoped read scans the table', name, link.childProperty);
42
+ }
43
+ const { parentEntry } = link;
44
+ if (!parentEntry?.metadata?.settings?.access) {
45
+ return `the parent ${getTableName(link.parentSchema)} has no access setting`;
46
+ }
47
+ if (visited.has(parentEntry)) {
48
+ return `through goes in a cycle at ${getTableName(link.parentSchema)}`;
49
+ }
50
+ visited.add(parentEntry);
51
+ current = parentEntry;
52
+ }
53
+ return undefined;
54
+ }
7
55
  /**
8
56
  * Refuses to boot when `settings.access` is declared where it cannot be honoured. Both cases
9
57
  * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,
@@ -15,6 +63,7 @@ export class ScopeFilterUtility {
15
63
  const searchBacked = [];
16
64
  const withoutAmbientContext = [];
17
65
  const invalidWriteGuard = [];
66
+ const invalidThrough = [];
18
67
  for (const [name, entry] of models) {
19
68
  if (!entry.metadata?.settings?.access) {
20
69
  continue;
@@ -27,7 +76,25 @@ export class ScopeFilterUtility {
27
76
  if (!opts.asyncContextEnabled) {
28
77
  withoutAmbientContext.push(name);
29
78
  }
30
- const { columns, write } = entry.metadata.settings.access;
79
+ const { access } = entry.metadata.settings;
80
+ if (!access.through === !access.resolve) {
81
+ invalidThrough.push(`${name}: declare resolve or through, not both and not neither`);
82
+ continue;
83
+ }
84
+ if (access.through) {
85
+ const problem = ScopeFilterUtility.throughProblem({ name, models, logger: opts.logger });
86
+ if (access.onMissing !== undefined) {
87
+ invalidThrough.push(`${name}: onMissing is not available on through, a parent that resolves no scope always denies`);
88
+ }
89
+ if (access.columns || access.write) {
90
+ invalidThrough.push(`${name}: columns and write belong to a resolver, not to through`);
91
+ }
92
+ if (problem) {
93
+ invalidThrough.push(`${name}: ${problem}`);
94
+ }
95
+ continue;
96
+ }
97
+ const { columns, write } = access;
31
98
  const writeGuard = write?.mode;
32
99
  if (writeGuard !== undefined && !ScopeWriteGuards.isValid(writeGuard)) {
33
100
  invalidWriteGuard.push(`${name}: write.mode '${String(writeGuard)}' is not reject or assign`);
@@ -54,6 +121,14 @@ export class ScopeFilterUtility {
54
121
  ].join(' | '),
55
122
  });
56
123
  }
124
+ if (invalidThrough.length > 0) {
125
+ throw getError({
126
+ message: [
127
+ `[assertScopeFilterSupported] invalid settings.access.through | ${invalidThrough.join(' | ')}`,
128
+ 'A model declares resolve or through. A through names a one relation whose parent has an access of its own.',
129
+ ].join(' | '),
130
+ });
131
+ }
57
132
  if (invalidWriteGuard.length > 0) {
58
133
  throw getError({
59
134
  message: [
@@ -66,7 +141,7 @@ export class ScopeFilterUtility {
66
141
  throw getError({
67
142
  message: [
68
143
  `[assertScopeFilterSupported] settings.access declared while asyncContext.enable is false | models: ${withoutAmbientContext.join(', ')}`,
69
- 'access.resolve() takes no arguments, so the ambient request context is its only input.',
144
+ 'access.resolve() reads the ambient request context; the operation is its only argument.',
70
145
  'With no context store every resolve() returns undefined, onMissing denies by default, and EVERY query on these models matches zero rows - with nothing naming the flag as the cause.',
71
146
  'Set asyncContext.enable to true, or remove settings.access.',
72
147
  ].join(' | '),
@@ -1 +1 @@
1
- {"version":3,"file":"scope-filter.js","sourceRoot":"","sources":["../../../src/common/scope-filter.ts"],"names":[],"mappings":"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","sourcesContent":["import { ResolverUtility } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { MetadataRegistry, ScopeWriteGuards } from '@venizia/ignis-kernel';\nimport { BaseSearchEntity } from '@/search/core/models';\nimport { getTableColumns, is, Table } from 'drizzle-orm';\n\nexport class ScopeFilterUtility {\n /**\n * Refuses to boot when `settings.access` is declared where it cannot be honoured. Both cases\n * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,\n * a context-less one returns none. The caller supplies `asyncContextEnabled` so no application\n * config type reaches into this tier.\n */\n static assertScopeFilterSupported(opts: { asyncContextEnabled: boolean }): void {\n const models = MetadataRegistry.getInstance().getAllModels();\n\n const searchBacked: string[] = [];\n const withoutAmbientContext: string[] = [];\n const invalidWriteGuard: string[] = [];\n\n for (const [name, entry] of models) {\n if (!entry.metadata?.settings?.access) {\n continue;\n }\n\n const modelClass = ResolverUtility.resolveValue({ value: entry.target });\n\n if (modelClass === BaseSearchEntity || modelClass.prototype instanceof BaseSearchEntity) {\n searchBacked.push(name);\n continue;\n }\n\n if (!opts.asyncContextEnabled) {\n withoutAmbientContext.push(name);\n }\n\n const { columns, write } = entry.metadata.settings.access;\n const writeGuard = write?.mode;\n\n if (writeGuard !== undefined && !ScopeWriteGuards.isValid(writeGuard)) {\n invalidWriteGuard.push(\n `${name}: write.mode '${String(writeGuard)}' is not reject or assign`,\n );\n }\n\n if (columns !== undefined) {\n const schema = (modelClass as { schema?: unknown }).schema;\n const known = is(schema, Table) ? Object.keys(getTableColumns(schema)) : undefined;\n const unknown = columns.filter((column) => known !== undefined && !known.includes(column));\n\n if (!Array.isArray(columns) || columns.length === 0) {\n invalidWriteGuard.push(`${name}: columns must be a non-empty list of property names`);\n } else if (unknown.length > 0) {\n invalidWriteGuard.push(\n `${name}: columns names ${unknown.join(', ')}, which the model does not have`,\n );\n }\n }\n }\n\n if (searchBacked.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] settings.access on a search-backed model | models: ${searchBacked.join(', ')}`,\n 'Search repositories never read this setting, so no row scope is applied.',\n 'Unlike the relational path, a missing scope here returns MORE rows rather than none - nothing fails, the result is just wider.',\n 'Scope the search query in the application, and remove settings.access from the model.',\n ].join(' | '),\n });\n }\n\n if (invalidWriteGuard.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] invalid settings.access write guard | ${invalidWriteGuard.join(' | ')}`,\n 'write.mode is reject or assign; columns, when declared, names properties of the model.',\n ].join(' | '),\n });\n }\n\n if (withoutAmbientContext.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] settings.access declared while asyncContext.enable is false | models: ${withoutAmbientContext.join(', ')}`,\n 'access.resolve() takes no arguments, so the ambient request context is its only input.',\n 'With no context store every resolve() returns undefined, onMissing denies by default, and EVERY query on these models matches zero rows - with nothing naming the flag as the cause.',\n 'Set asyncContext.enable to true, or remove settings.access.',\n ].join(' | '),\n });\n }\n }\n}\n"]}
1
+ {"version":3,"file":"scope-filter.js","sourceRoot":"","sources":["../../../src/common/scope-filter.ts"],"names":[],"mappings":"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","sourcesContent":["import { ResolverUtility } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport type { ILogger } from '@venizia/ignis-helpers/core';\nimport { MetadataRegistry, ScopeWriteGuards } from '@venizia/ignis-kernel';\nimport type { IModelRegistryEntry } from '@venizia/ignis-kernel';\nimport { ScopeThroughLink } from '@/relational/core/repositories/common/scope-through';\nimport { BaseSearchEntity } from '@/search/core/models';\nimport { getTableColumns, getTableName, is, Table } from 'drizzle-orm';\n\nexport class ScopeFilterUtility {\n /**\n * Why a `through` chain cannot work, or undefined. Walks from `name` toward the model that holds a resolver: every\n * hop needs a `one` relation with a single-column key, the parent needs an `access`, and the chain is at most\n * `ScopeThroughLink.MAX_DEPTH` hops with no model twice. A key with no index is a warning: it still works, slowly.\n */\n private static throughProblem(opts: {\n name: string;\n models: Map<string, IModelRegistryEntry>;\n logger?: ILogger;\n }): string | undefined {\n const { name, models, logger } = opts;\n let current = models.get(name);\n const visited = new Set([current]);\n let hops = 0;\n\n while (current?.metadata?.settings?.access?.through) {\n hops += 1;\n\n if (hops > ScopeThroughLink.MAX_DEPTH) {\n return `through is deeper than ${ScopeThroughLink.MAX_DEPTH} hops`;\n }\n\n const { schema } = current;\n\n if (!is(schema, Table)) {\n return 'the model has no table to read a foreign key from';\n }\n\n let link: ReturnType<typeof ScopeThroughLink.of>;\n\n try {\n link = ScopeThroughLink.of({\n schema,\n relation: current.metadata.settings.access.through.relation,\n relations: ScopeThroughLink.relationsOf({ entry: current }),\n });\n } catch (error) {\n return error instanceof Error ? error.message : String(error);\n }\n\n if (hops === 1 && !ScopeThroughLink.isIndexed({ schema, property: link.childProperty })) {\n logger\n ?.for('assertScopeFilterSupported')\n .warn(\n '%s: the foreign key %s has no index, so every scoped read scans the table',\n name,\n link.childProperty,\n );\n }\n\n const { parentEntry } = link;\n\n if (!parentEntry?.metadata?.settings?.access) {\n return `the parent ${getTableName(link.parentSchema)} has no access setting`;\n }\n\n if (visited.has(parentEntry)) {\n return `through goes in a cycle at ${getTableName(link.parentSchema)}`;\n }\n\n visited.add(parentEntry);\n current = parentEntry;\n }\n\n return undefined;\n }\n\n /**\n * Refuses to boot when `settings.access` is declared where it cannot be honoured. Both cases\n * are silent at runtime and fail in OPPOSITE directions: a search-backed model returns more rows,\n * a context-less one returns none. The caller supplies `asyncContextEnabled` so no application\n * config type reaches into this tier.\n */\n static assertScopeFilterSupported(opts: {\n asyncContextEnabled: boolean;\n logger?: ILogger;\n }): void {\n const models = MetadataRegistry.getInstance().getAllModels();\n\n const searchBacked: string[] = [];\n const withoutAmbientContext: string[] = [];\n const invalidWriteGuard: string[] = [];\n const invalidThrough: string[] = [];\n\n for (const [name, entry] of models) {\n if (!entry.metadata?.settings?.access) {\n continue;\n }\n\n const modelClass = ResolverUtility.resolveValue({ value: entry.target });\n\n if (modelClass === BaseSearchEntity || modelClass.prototype instanceof BaseSearchEntity) {\n searchBacked.push(name);\n continue;\n }\n\n if (!opts.asyncContextEnabled) {\n withoutAmbientContext.push(name);\n }\n\n const { access } = entry.metadata.settings;\n\n if (!access.through === !access.resolve) {\n invalidThrough.push(`${name}: declare resolve or through, not both and not neither`);\n continue;\n }\n\n if (access.through) {\n const problem = ScopeFilterUtility.throughProblem({ name, models, logger: opts.logger });\n\n if (access.onMissing !== undefined) {\n invalidThrough.push(\n `${name}: onMissing is not available on through, a parent that resolves no scope always denies`,\n );\n }\n\n if (access.columns || access.write) {\n invalidThrough.push(`${name}: columns and write belong to a resolver, not to through`);\n }\n\n if (problem) {\n invalidThrough.push(`${name}: ${problem}`);\n }\n\n continue;\n }\n\n const { columns, write } = access;\n const writeGuard = write?.mode;\n\n if (writeGuard !== undefined && !ScopeWriteGuards.isValid(writeGuard)) {\n invalidWriteGuard.push(\n `${name}: write.mode '${String(writeGuard)}' is not reject or assign`,\n );\n }\n\n if (columns !== undefined) {\n const schema = (modelClass as { schema?: unknown }).schema;\n const known = is(schema, Table) ? Object.keys(getTableColumns(schema)) : undefined;\n const unknown = columns.filter((column) => known !== undefined && !known.includes(column));\n\n if (!Array.isArray(columns) || columns.length === 0) {\n invalidWriteGuard.push(`${name}: columns must be a non-empty list of property names`);\n } else if (unknown.length > 0) {\n invalidWriteGuard.push(\n `${name}: columns names ${unknown.join(', ')}, which the model does not have`,\n );\n }\n }\n }\n\n if (searchBacked.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] settings.access on a search-backed model | models: ${searchBacked.join(', ')}`,\n 'Search repositories never read this setting, so no row scope is applied.',\n 'Unlike the relational path, a missing scope here returns MORE rows rather than none - nothing fails, the result is just wider.',\n 'Scope the search query in the application, and remove settings.access from the model.',\n ].join(' | '),\n });\n }\n\n if (invalidThrough.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] invalid settings.access.through | ${invalidThrough.join(' | ')}`,\n 'A model declares resolve or through. A through names a one relation whose parent has an access of its own.',\n ].join(' | '),\n });\n }\n\n if (invalidWriteGuard.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] invalid settings.access write guard | ${invalidWriteGuard.join(' | ')}`,\n 'write.mode is reject or assign; columns, when declared, names properties of the model.',\n ].join(' | '),\n });\n }\n\n if (withoutAmbientContext.length > 0) {\n throw getError({\n message: [\n `[assertScopeFilterSupported] settings.access declared while asyncContext.enable is false | models: ${withoutAmbientContext.join(', ')}`,\n 'access.resolve() reads the ambient request context; the operation is its only argument.',\n 'With no context store every resolve() returns undefined, onMissing denies by default, and EVERY query on these models matches zero rows - with nothing naming the flag as the cause.',\n 'Set asyncContext.enable to true, or remove settings.access.',\n ].join(' | '),\n });\n }\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../../src/http/common/wire.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes, type THttpReadShape } from './constants';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HttpExtraRequest } from '@venizia/ignis-kernel/repository';\nimport type { TExtraRequest, THttpBody, THttpHeaders } from './types';\n\n/**\n * What `HttpDataSource` puts on the wire and reads back off it: headers, request bodies, rows and\n * the path an error message names. Internal - not part of the `http` entry.\n */\nexport class HttpWire {\n /**\n * Caller headers as unique lowercase pairs, last spelling winning.\n *\n * Never `new Headers(input)`: that constructor APPENDS, so `{ 'X-Tenant': 'north', 'x-tenant':\n * 'south' }` - which a merge of two config objects produces - reaches the wire as `\"north, south\"`,\n * a value neither caller wrote. A `Headers` instance arrives already joined; that one is the\n * caller's own, and is passed through as it stands.\n */\n static toHeaderEntries(opts: { headers?: THttpHeaders }): Array<[string, string]> {\n const { headers } = opts;\n\n if (!headers) {\n return [];\n }\n\n const source =\n headers instanceof Headers\n ? [...headers.entries()]\n : Array.isArray(headers)\n ? headers\n : Object.entries(headers);\n\n const merged = new Map<string, string>();\n for (const [name, value] of source) {\n merged.set(name.toLowerCase(), value);\n }\n\n return [...merged.entries()];\n }\n\n /** The connector always sends `x-request-count: false`; a caller header carrying it would contradict that. */\n static assertNoRequestCountHeader(opts: {\n entries: Array<[string, string]>;\n name: string;\n }): void {\n const { entries, name } = opts;\n\n if (entries.some(([headerName]) => headerName === HTTP.Headers.REQUEST_COUNT_DATA)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${name}] ${HTTP.Headers.REQUEST_COUNT_DATA} is owned by HttpDataSource and always sent as false: rows come back bare, the total in Content-Range.`,\n });\n }\n }\n\n /**\n * The body as `fetch` takes it. Anything `fetch` already sends as a body passes through untouched;\n * any other object is JSON. Serialised ONCE, so the 401 retry sends the same bytes.\n */\n static toRequestBody(opts: { body?: THttpBody }): {\n payload: RequestInit['body'];\n isJson: boolean;\n isFormData: boolean;\n } {\n const { body } = opts;\n\n if (body === undefined) {\n return { payload: undefined, isJson: false, isFormData: false };\n }\n\n const isFormData = body instanceof FormData;\n const isSentAsIs =\n isFormData ||\n typeof body === 'string' ||\n body instanceof Blob ||\n body instanceof URLSearchParams ||\n body instanceof ArrayBuffer;\n\n if (isSentAsIs) {\n return { payload: body, isJson: false, isFormData };\n }\n\n // A typed array may sit on a SharedArrayBuffer, which `fetch` refuses; a Blob copy never does.\n if (ArrayBuffer.isView(body)) {\n return {\n payload: new Blob([new Uint8Array(body.buffer, body.byteOffset, body.byteLength).slice()]),\n isJson: false,\n isFormData: false,\n };\n }\n\n return {\n payload: HttpWire.toJson({ value: body, label: 'The request body' }),\n isJson: true,\n isFormData: false,\n };\n }\n\n /** JSON, or a 400 naming what failed: a bigint or a cycle would otherwise escape as a bare TypeError. */\n static toJson(opts: { value: unknown; label: string }): string {\n const { value, label } = opts;\n\n try {\n return JSON.stringify(value);\n } catch (error) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `${label} cannot be sent as JSON | ${error instanceof Error ? error.message : String(error)}`,\n });\n }\n }\n\n /**\n * A list is a bare array or the `{ count, data }` envelope; `one` is never unwrapped, since a record\n * may carry `data` and `count` columns. The envelope `count` is the page size, never the total.\n *\n * Anything else asked for as a list throws: counting it as one row is how `existsWith` answers true\n * for an empty result and a page reports a length it does not have.\n */\n static unwrapRows<R>(opts: { body: unknown; shape: THttpReadShape; url: string }): R {\n const { body, shape, url } = opts;\n\n if (shape === HttpReadShapes.ONE || Array.isArray(body)) {\n return body as R;\n }\n\n if (body && typeof body === 'object' && 'data' in body && 'count' in body) {\n return (body as { data: R }).data;\n }\n\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[read] A list was asked for and the response is neither an array nor a { count, data } envelope | ${HttpWire.describeUrl({ url })}`,\n });\n }\n\n /**\n * The call's headers plus `x-request-extra` for the extras it asks for - `name`, `-name`,\n * `name(key,key)` - and `-*` first when it wants the rows alone, with every default off.\n */\n static withExtraHeader(opts: {\n headers?: THttpHeaders;\n extra?: TExtraRequest;\n isEveryDefaultOff?: boolean;\n }): THttpHeaders | undefined {\n const { headers, extra, isEveryDefaultOff } = opts;\n const value = HttpExtraRequest.toHeader({ extra, isEveryDefaultOff });\n\n if (value === undefined) {\n return headers;\n }\n\n const extraHeader: [string, string] = [HttpExtraRequest.HEADER, value];\n return [...HttpWire.toHeaderEntries({ headers }), extraHeader];\n }\n\n /**\n * The path a message names - never the host or the query. A server that relays this error would\n * otherwise send an internal host and a filter's values to its own clients. 414/431 add the length.\n */\n static describeUrl(opts: { url: string; status?: number }): string {\n const { url, status } = opts;\n const { pathname } = new URL(url);\n\n const isTooLong =\n status === HTTP.ResultCodes.RS_4.URITooLong ||\n status === HTTP.ResultCodes.RS_4.RequestHeaderFieldsTooLarge;\n\n return isTooLong\n ? `${pathname} (${url.length} chars) | The URL is too long for a GET - split the filter (a long inq) into smaller requests.`\n : pathname;\n }\n}\n"]}
1
+ {"version":3,"file":"wire.js","sourceRoot":"","sources":["../../../../src/http/common/wire.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes, type THttpReadShape } from './constants';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HttpExtraRequest } from '@venizia/ignis-kernel/repository';\nimport type { TExtraRequest, THttpBody, THttpHeaders } from './types';\n\n/**\n * What `HttpDataSource` puts on the wire and reads back off it: headers, request bodies, rows and\n * the path an error message names. Internal - not part of the `http` entry.\n */\nexport class HttpWire {\n /**\n * Caller headers as unique lowercase pairs, last spelling winning.\n *\n * Never `new Headers(input)`: that constructor APPENDS, so `{ 'X-Tenant': 'north', 'x-tenant':\n * 'south' }` - which a merge of two config objects produces - reaches the wire as `\"north, south\"`,\n * a value neither caller wrote. A `Headers` instance arrives already joined; that one is the\n * caller's own, and is passed through as it stands.\n */\n static toHeaderEntries(opts: { headers?: THttpHeaders }): Array<[string, string]> {\n const { headers } = opts;\n\n if (!headers) {\n return [];\n }\n\n const source =\n headers instanceof Headers\n ? [...headers.entries()]\n : Array.isArray(headers)\n ? headers\n : Object.entries(headers);\n\n const merged = new Map<string, string>();\n\n for (const [name, value] of source) {\n merged.set(name.toLowerCase(), value);\n }\n\n return [...merged.entries()];\n }\n\n /** The connector always sends `x-request-count: false`; a caller header carrying it would contradict that. */\n static assertNoRequestCountHeader(opts: {\n entries: Array<[string, string]>;\n name: string;\n }): void {\n const { entries, name } = opts;\n\n if (entries.some(([headerName]) => headerName === HTTP.Headers.REQUEST_COUNT_DATA)) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${name}] ${HTTP.Headers.REQUEST_COUNT_DATA} is owned by HttpDataSource and always sent as false: rows come back bare, the total in Content-Range.`,\n });\n }\n }\n\n /**\n * The body as `fetch` takes it. Anything `fetch` already sends as a body passes through untouched;\n * any other object is JSON. Serialised ONCE, so the 401 retry sends the same bytes.\n */\n static toRequestBody(opts: { body?: THttpBody }): {\n payload: RequestInit['body'];\n isJson: boolean;\n isFormData: boolean;\n } {\n const { body } = opts;\n\n if (body === undefined) {\n return { payload: undefined, isJson: false, isFormData: false };\n }\n\n const isFormData = body instanceof FormData;\n const isSentAsIs =\n isFormData ||\n typeof body === 'string' ||\n body instanceof Blob ||\n body instanceof URLSearchParams ||\n body instanceof ArrayBuffer;\n\n if (isSentAsIs) {\n return { payload: body, isJson: false, isFormData };\n }\n\n // A typed array may sit on a SharedArrayBuffer, which `fetch` refuses; a Blob copy never does.\n if (ArrayBuffer.isView(body)) {\n return {\n payload: new Blob([new Uint8Array(body.buffer, body.byteOffset, body.byteLength).slice()]),\n isJson: false,\n isFormData: false,\n };\n }\n\n return {\n payload: HttpWire.toJson({ value: body, label: 'The request body' }),\n isJson: true,\n isFormData: false,\n };\n }\n\n /** JSON, or a 400 naming what failed: a bigint or a cycle would otherwise escape as a bare TypeError. */\n static toJson(opts: { value: unknown; label: string }): string {\n const { value, label } = opts;\n\n try {\n return JSON.stringify(value);\n } catch (error) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_4.BadRequest,\n message: `${label} cannot be sent as JSON | ${error instanceof Error ? error.message : String(error)}`,\n });\n }\n }\n\n /**\n * A list is a bare array or the `{ count, data }` envelope; `one` is never unwrapped, since a record\n * may carry `data` and `count` columns. The envelope `count` is the page size, never the total.\n *\n * Anything else asked for as a list throws: counting it as one row is how `existsWith` answers true\n * for an empty result and a page reports a length it does not have.\n */\n static unwrapRows<R>(opts: { body: unknown; shape: THttpReadShape; url: string }): R {\n const { body, shape, url } = opts;\n\n if (shape === HttpReadShapes.ONE || Array.isArray(body)) {\n return body as R;\n }\n\n if (body && typeof body === 'object' && 'data' in body && 'count' in body) {\n return (body as { data: R }).data;\n }\n\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[read] A list was asked for and the response is neither an array nor a { count, data } envelope | ${HttpWire.describeUrl({ url })}`,\n });\n }\n\n /**\n * The call's headers plus `x-request-extra` for the extras it asks for - `name`, `-name`,\n * `name(key,key)` - and `-*` first when it wants the rows alone, with every default off.\n */\n static withExtraHeader(opts: {\n headers?: THttpHeaders;\n extra?: TExtraRequest;\n isEveryDefaultOff?: boolean;\n }): THttpHeaders | undefined {\n const { headers, extra, isEveryDefaultOff } = opts;\n const value = HttpExtraRequest.toHeader({ extra, isEveryDefaultOff });\n\n if (value === undefined) {\n return headers;\n }\n\n const extraHeader: [string, string] = [HttpExtraRequest.HEADER, value];\n\n return [...HttpWire.toHeaderEntries({ headers }), extraHeader];\n }\n\n /**\n * The path a message names - never the host or the query. A server that relays this error would\n * otherwise send an internal host and a filter's values to its own clients. 414/431 add the length.\n */\n static describeUrl(opts: { url: string; status?: number }): string {\n const { url, status } = opts;\n const { pathname } = new URL(url);\n\n const isTooLong =\n status === HTTP.ResultCodes.RS_4.URITooLong ||\n status === HTTP.ResultCodes.RS_4.RequestHeaderFieldsTooLarge;\n\n return isTooLong\n ? `${pathname} (${url.length} chars) | The URL is too long for a GET - split the filter (a long inq) into smaller requests.`\n : pathname;\n }\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"datasource.js","sourceRoot":"","sources":["../../../src/http/datasource.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes, type THttpReadShape } from './common/constants';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { NodeFetchNetworkRequest } from '@venizia/ignis-helpers/core';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HttpResponseReader } from './common/readers';\nimport type {\n IAuthToken,\n IHttpCallOptions,\n IHttpDataSourceSettings,\n TExtraRequest,\n IHttpReadResult,\n IHttpRequestContext,\n IHttpWriteResult,\n THttpBody,\n} from './common/types';\nimport { HttpWire } from './common/wire';\n\n/** A scheme and `//` make a URL absolute - `localhost:3000` has neither. Read by pattern: `URL.canParse` needs Safari 17 or Chrome 120, and this runs in pages. */\nconst ABSOLUTE_URL_PATTERN = /^[a-z][a-z\\d+.-]*:\\/\\//i;\n\n/** Reads an IGNIS REST server through the repository contract. Targets IGNIS, not any REST API. */\nexport class HttpDataSource extends AbstractDataSource<IHttpDataSourceSettings> {\n override name: string;\n override settings: IHttpDataSourceSettings;\n override schema = {} as never;\n\n protected network: NodeFetchNetworkRequest;\n /** Normalised once: every request copies these, never re-parses `settings.headers`. */\n protected configuredHeaders: Array<[string, string]>;\n /** Decided once: a relative baseUrl (`/api`) is resolved against the page origin on every request. */\n protected isRelativeBaseUrl: boolean;\n\n constructor(opts: IHttpDataSourceSettings & { name?: string }) {\n super({ scope: opts.name ?? HttpDataSource.name });\n\n const { name = 'http', ...settings } = opts;\n\n const configured = HttpWire.toHeaderEntries({ headers: settings.headers });\n HttpWire.assertNoRequestCountHeader({ entries: configured, name });\n\n this.isRelativeBaseUrl = !ABSOLUTE_URL_PATTERN.test(settings.baseUrl);\n\n // Against the page, `api` would follow the current route; `localhost:3000` is not a URL at all.\n if (this.isRelativeBaseUrl && !settings.baseUrl.startsWith('/')) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${name}] baseUrl '${settings.baseUrl}' is neither absolute nor a path from the origin | Pass '/api' or an absolute URL such as 'https://api.example.com'`,\n });\n }\n\n this.configuredHeaders = configured;\n this.name = name;\n this.settings = settings;\n this.network = new NodeFetchNetworkRequest({\n name,\n networkOptions: { baseUrl: settings.baseUrl },\n });\n }\n\n async configure(): Promise<void> {}\n\n override getCapabilities() {\n return { transactions: false };\n }\n\n protected resolveAuthToken(opts: { context: IHttpRequestContext }): IAuthToken | undefined {\n return this.settings.authToken ?? this.settings.authTokenResolver?.(opts.context);\n }\n\n /** Re-run on every send, so a header the app changed since the last request is the one sent. */\n protected resolveHeaders(opts: { context: IHttpRequestContext }): Array<[string, string]> {\n const resolver = this.settings.headersResolver;\n if (!resolver) {\n return [];\n }\n\n const entries = HttpWire.toHeaderEntries({ headers: resolver(opts.context) });\n HttpWire.assertNoRequestCountHeader({ entries, name: this.name });\n\n return entries;\n }\n\n protected buildHeaders(opts: {\n token?: IAuthToken;\n requestHeaders?: Array<[string, string]>;\n isJsonBody?: boolean;\n isFormDataBody?: boolean;\n }): Headers {\n const { token, requestHeaders, isJsonBody, isFormDataBody } = opts;\n const headers = new Headers(this.configuredHeaders);\n\n // A request's own headers win over the configured ones; the connector's below win over both.\n for (const [name, value] of requestHeaders ?? []) {\n headers.set(name, value);\n }\n\n if (isJsonBody && !headers.has(HTTP.Headers.CONTENT_TYPE)) {\n headers.set(HTTP.Headers.CONTENT_TYPE, 'application/json');\n }\n\n // Only `fetch` knows the multipart boundary; any other content-type here would drop it.\n if (isFormDataBody) {\n headers.delete(HTTP.Headers.CONTENT_TYPE);\n }\n\n // Set last: under the envelope a record read answers `{ count, data }`.\n headers.set(HTTP.Headers.REQUEST_COUNT_DATA, 'false');\n\n if (!token) {\n return headers;\n }\n\n headers.set(HTTP.Headers.AUTHORIZATION, `${token.type ?? 'Bearer'} ${token.value}`);\n\n // Unconditionally it would send the string \"undefined\".\n if (token.provider) {\n headers.set('x-auth-provider', token.provider);\n }\n\n return headers;\n }\n\n /** The browser global `location` is not declared for a server build, so it is probed, not assumed. */\n protected resolveLocationOrigin(): string | undefined {\n const location: unknown = Reflect.get(globalThis, 'location');\n if (typeof location !== 'object' || location === null || !('origin' in location)) {\n return undefined;\n }\n\n return typeof location.origin === 'string' ? location.origin : undefined;\n }\n\n buildUrl(opts: { paths: Array<string>; query?: Record<string, unknown> }): string {\n const { paths, query } = opts;\n const requestUrl = this.network.getRequestUrl({ paths });\n\n // A page or a Web Worker has an origin to resolve '/api' against; a server has none.\n const origin = this.isRelativeBaseUrl ? this.resolveLocationOrigin() : undefined;\n if (this.isRelativeBaseUrl && !origin) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.name}] Relative baseUrl '${this.settings.baseUrl}' needs a page or worker location to resolve against, and there is none here | Pass an absolute baseUrl such as 'https://api.example.com'`,\n });\n }\n\n const url = new URL(requestUrl, origin);\n\n const parameters = Object.entries(query ?? {});\n for (const [key, value] of parameters) {\n if (value === undefined) {\n continue;\n }\n\n url.searchParams.set(\n key,\n typeof value === 'string'\n ? value\n : HttpWire.toJson({ value, label: `[${this.name}] Query parameter '${key}'` }),\n );\n }\n\n return url.toString();\n }\n\n /**\n * The raw `Response`, on any method - for what the repository verbs do not cover, like an export\n * or a PUT to a hand-written route. Auth and the 401 retry apply; the retry resends the same body.\n */\n async request(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n method?: string;\n body?: THttpBody;\n } & IHttpCallOptions,\n ): Promise<Response> {\n return this.sendRequest({ ...opts, url: this.buildUrl(opts) });\n }\n\n /** `request` on a URL already built: `read` and `write` serialise a long query once, not per use. */\n protected async sendRequest(\n opts: {\n paths: Array<string>;\n url: string;\n method?: string;\n body?: THttpBody;\n } & IHttpCallOptions,\n ): Promise<Response> {\n const { url, signal } = opts;\n const requestHeaders = HttpWire.toHeaderEntries({ headers: opts.headers });\n HttpWire.assertNoRequestCountHeader({ entries: requestHeaders, name: this.name });\n\n const method = opts.method ?? HTTP.Methods.GET;\n const context: IHttpRequestContext = { paths: opts.paths, method, url, signal };\n const { payload, isJson, isFormData } = HttpWire.toRequestBody({ body: opts.body });\n\n // Both hooks run inside `send`, so the retry sends what they answer after the refresh.\n const send = () =>\n this.network.getNetworkService().send({\n url,\n method: method as never,\n body: payload,\n signal,\n headers: this.buildHeaders({\n token: this.resolveAuthToken({ context }),\n // Resolved first, so the call's own headers win over them.\n requestHeaders: [...this.resolveHeaders({ context }), ...requestHeaders],\n isJsonBody: isJson,\n isFormDataBody: isFormData,\n }),\n });\n\n let response = await send();\n\n if (response.status === HTTP.ResultCodes.RS_4.Unauthorized && this.settings.onUnauthorized) {\n const shouldRetry = await this.settings.onUnauthorized(context);\n\n // A call aborted while the session refreshed is not sent again.\n if (shouldRetry) {\n signal?.throwIfAborted();\n const result = await send();\n response = result;\n }\n }\n\n return response;\n }\n\n /**\n * The body as JSON, `null` when there is none; a body that is not JSON is the server's fault, named\n * as such. Its content stays out of the message, which a relaying server may pass to its clients.\n */\n protected async readJsonBody(opts: { response: Response; url: string; verb: string }) {\n const { response, url, verb } = opts;\n const text = await response.text();\n\n if (!text) {\n return null;\n }\n\n try {\n return JSON.parse(text);\n } catch {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.BadGateway,\n message: `[${this.name}][${verb}] ${response.status} | ${HttpWire.describeUrl({ url, status: response.status })} | The response body is not JSON (${text.length} chars, content-type: ${response.headers.get(HTTP.Headers.CONTENT_TYPE) ?? 'none'})`,\n });\n }\n }\n\n /**\n * A failed response as the error the server threw: its status, code, args and text, and its\n * `extra` with the `requestId` added. `message` adds where it failed, for logs; `normalized.text`\n * stays the server's, for display - `HTTP <status>` when the server sent none. `cause` is the server's `details.cause` - a 422's per-field\n * issues, `{ path, message, code }`.\n */\n protected async toResponseError(opts: { response: Response; url: string; verb: string }) {\n const { response, url, verb } = opts;\n const described = HttpWire.describeUrl({ url, status: response.status });\n\n return HttpResponseReader.toApplicationError({\n response,\n rootKey: this.settings.errorRootKey,\n context: `[${this.name}][${verb}] ${response.status} | ${described}`,\n });\n }\n\n /**\n * Rows plus the total from `Content-Range`, reported absent when the header is. A GET unless told\n * otherwise: `method` and `body` reach a list route a service wrote to take its filter in a body.\n */\n async read<R>(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n shape?: THttpReadShape;\n method?: string;\n body?: THttpBody;\n /** Extras the route offers beside its rows, asked for by name (`x-request-extra`). */\n extra?: TExtraRequest;\n /** The rows alone: every default extra off (`-*`), for a read that only counts or probes. */\n isEveryDefaultOff?: boolean;\n } & IHttpCallOptions,\n ): Promise<IHttpReadResult<R>> {\n const url = this.buildUrl(opts);\n const headers = HttpWire.withExtraHeader({\n headers: opts.headers,\n extra: opts.extra,\n isEveryDefaultOff: opts.isEveryDefaultOff,\n });\n const response = await this.sendRequest({ ...opts, url, headers });\n\n if (!response.ok) {\n const result = await this.toResponseError({ response, url, verb: 'read' });\n throw result;\n }\n\n // A 204 or an empty body is no row; a list asked for of it still throws below.\n const parsed = await this.readJsonBody({ response, url, verb: 'read' });\n const { body, extra } = HttpResponseReader.readExtra({\n body: parsed,\n headers: response.headers,\n });\n const contentRange = response.headers.get(HTTP.Headers.CONTENT_RANGE) ?? undefined;\n const range = HttpResponseReader.parseContentRange({ header: contentRange });\n const data = HttpWire.unwrapRows<R>({ body, shape: opts.shape ?? HttpReadShapes.LIST, url });\n\n return {\n data,\n hasRange: range !== undefined,\n contentRange,\n total: range?.total,\n skip: range?.skip,\n dataLength: Array.isArray(data) ? data.length : data === null ? 0 : 1,\n extra,\n };\n }\n\n /**\n * A write, and what it answered: the body as the rows, the count from `x-response-count`. The\n * connector asks for bare rows, so an IGNIS write answers the row or the rows, never the envelope.\n */\n async write<R>(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n method: string;\n body?: THttpBody;\n /** Extras the route answers beside its rows, asked for by name (`x-request-extra`). */\n extra?: TExtraRequest;\n } & IHttpCallOptions,\n ): Promise<IHttpWriteResult<R>> {\n const url = this.buildUrl(opts);\n const headers = HttpWire.withExtraHeader({ headers: opts.headers, extra: opts.extra });\n const response = await this.sendRequest({ ...opts, url, headers });\n\n if (!response.ok) {\n const result = await this.toResponseError({ response, url, verb: 'write' });\n throw result;\n }\n\n // A 204, or a route that answers nothing, has no body to parse.\n const parsed = await this.readJsonBody({ response, url, verb: 'write' });\n const { extra } = HttpResponseReader.readExtra({ body: parsed, headers: response.headers });\n const data = extra ? parsed.data : parsed;\n\n const countHeader = response.headers.get(HTTP.Headers.RESPONSE_COUNT_DATA);\n const counted = countHeader === null ? Number.NaN : Number(countHeader);\n\n return {\n data,\n count: Number.isFinite(counted)\n ? counted\n : Array.isArray(data)\n ? data.length\n : data === null\n ? 0\n : 1,\n ...(extra ? { extra } : {}),\n };\n }\n}\n"]}
1
+ {"version":3,"file":"datasource.js","sourceRoot":"","sources":["../../../src/http/datasource.ts"],"names":[],"mappings":"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","sourcesContent":["import { HttpReadShapes, type THttpReadShape } from './common/constants';\nimport { AbstractDataSource } from '@venizia/ignis-kernel/repository';\nimport { HTTP } from '@venizia/ignis-helpers/common';\nimport { NodeFetchNetworkRequest } from '@venizia/ignis-helpers/core';\nimport { getError } from '@venizia/ignis-helpers/core';\nimport { HttpResponseReader } from './common/readers';\nimport type {\n IAuthToken,\n IHttpCallOptions,\n IHttpDataSourceSettings,\n TExtraRequest,\n IHttpReadResult,\n IHttpRequestContext,\n IHttpWriteResult,\n THttpBody,\n} from './common/types';\nimport { HttpWire } from './common/wire';\n\n/** A scheme and `//` make a URL absolute - `localhost:3000` has neither. Read by pattern: `URL.canParse` needs Safari 17 or Chrome 120, and this runs in pages. */\nconst ABSOLUTE_URL_PATTERN = /^[a-z][a-z\\d+.-]*:\\/\\//i;\n\n/** Reads an IGNIS REST server through the repository contract. Targets IGNIS, not any REST API. */\nexport class HttpDataSource extends AbstractDataSource<IHttpDataSourceSettings> {\n override name: string;\n override settings: IHttpDataSourceSettings;\n override schema = {} as never;\n\n protected network: NodeFetchNetworkRequest;\n /** Normalised once: every request copies these, never re-parses `settings.headers`. */\n protected configuredHeaders: Array<[string, string]>;\n /** Decided once: a relative baseUrl (`/api`) is resolved against the page origin on every request. */\n protected isRelativeBaseUrl: boolean;\n\n constructor(opts: IHttpDataSourceSettings & { name?: string }) {\n super({ scope: opts.name ?? HttpDataSource.name });\n\n const { name = 'http', ...settings } = opts;\n\n const configured = HttpWire.toHeaderEntries({ headers: settings.headers });\n HttpWire.assertNoRequestCountHeader({ entries: configured, name });\n\n this.isRelativeBaseUrl = !ABSOLUTE_URL_PATTERN.test(settings.baseUrl);\n\n // Against the page, `api` would follow the current route; `localhost:3000` is not a URL at all.\n if (this.isRelativeBaseUrl && !settings.baseUrl.startsWith('/')) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${name}] baseUrl '${settings.baseUrl}' is neither absolute nor a path from the origin | Pass '/api' or an absolute URL such as 'https://api.example.com'`,\n });\n }\n\n this.configuredHeaders = configured;\n this.name = name;\n this.settings = settings;\n this.network = new NodeFetchNetworkRequest({\n name,\n networkOptions: { baseUrl: settings.baseUrl },\n });\n }\n\n async configure(): Promise<void> {}\n\n override getCapabilities() {\n return { transactions: false };\n }\n\n protected resolveAuthToken(opts: { context: IHttpRequestContext }): IAuthToken | undefined {\n return this.settings.authToken ?? this.settings.authTokenResolver?.(opts.context);\n }\n\n /** Re-run on every send, so a header the app changed since the last request is the one sent. */\n protected resolveHeaders(opts: { context: IHttpRequestContext }): Array<[string, string]> {\n const resolver = this.settings.headersResolver;\n\n if (!resolver) {\n return [];\n }\n\n const entries = HttpWire.toHeaderEntries({ headers: resolver(opts.context) });\n HttpWire.assertNoRequestCountHeader({ entries, name: this.name });\n\n return entries;\n }\n\n protected buildHeaders(opts: {\n token?: IAuthToken;\n requestHeaders?: Array<[string, string]>;\n isJsonBody?: boolean;\n isFormDataBody?: boolean;\n }): Headers {\n const { token, requestHeaders, isJsonBody, isFormDataBody } = opts;\n const headers = new Headers(this.configuredHeaders);\n\n // A request's own headers win over the configured ones; the connector's below win over both.\n for (const [name, value] of requestHeaders ?? []) {\n headers.set(name, value);\n }\n\n if (isJsonBody && !headers.has(HTTP.Headers.CONTENT_TYPE)) {\n headers.set(HTTP.Headers.CONTENT_TYPE, 'application/json');\n }\n\n // Only `fetch` knows the multipart boundary; any other content-type here would drop it.\n if (isFormDataBody) {\n headers.delete(HTTP.Headers.CONTENT_TYPE);\n }\n\n // Set last: under the envelope a record read answers `{ count, data }`.\n headers.set(HTTP.Headers.REQUEST_COUNT_DATA, 'false');\n\n if (!token) {\n return headers;\n }\n\n headers.set(HTTP.Headers.AUTHORIZATION, `${token.type ?? 'Bearer'} ${token.value}`);\n\n // Unconditionally it would send the string \"undefined\".\n if (token.provider) {\n headers.set('x-auth-provider', token.provider);\n }\n\n return headers;\n }\n\n /** The browser global `location` is not declared for a server build, so it is probed, not assumed. */\n protected resolveLocationOrigin(): string | undefined {\n const location: unknown = Reflect.get(globalThis, 'location');\n\n if (typeof location !== 'object' || location === null || !('origin' in location)) {\n return undefined;\n }\n\n return typeof location.origin === 'string' ? location.origin : undefined;\n }\n\n buildUrl(opts: { paths: Array<string>; query?: Record<string, unknown> }): string {\n const { paths, query } = opts;\n const requestUrl = this.network.getRequestUrl({ paths });\n\n // A page or a Web Worker has an origin to resolve '/api' against; a server has none.\n const origin = this.isRelativeBaseUrl ? this.resolveLocationOrigin() : undefined;\n\n if (this.isRelativeBaseUrl && !origin) {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.InternalServerError,\n message: `[${this.name}] Relative baseUrl '${this.settings.baseUrl}' needs a page or worker location to resolve against, and there is none here | Pass an absolute baseUrl such as 'https://api.example.com'`,\n });\n }\n\n const url = new URL(requestUrl, origin);\n\n const parameters = Object.entries(query ?? {});\n\n for (const [key, value] of parameters) {\n if (value === undefined) {\n continue;\n }\n\n url.searchParams.set(\n key,\n typeof value === 'string'\n ? value\n : HttpWire.toJson({ value, label: `[${this.name}] Query parameter '${key}'` }),\n );\n }\n\n return url.toString();\n }\n\n /**\n * The raw `Response`, on any method - for what the repository verbs do not cover, like an export\n * or a PUT to a hand-written route. Auth and the 401 retry apply; the retry resends the same body.\n */\n async request(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n method?: string;\n body?: THttpBody;\n } & IHttpCallOptions,\n ): Promise<Response> {\n return this.sendRequest({ ...opts, url: this.buildUrl(opts) });\n }\n\n /** `request` on a URL already built: `read` and `write` serialise a long query once, not per use. */\n protected async sendRequest(\n opts: {\n paths: Array<string>;\n url: string;\n method?: string;\n body?: THttpBody;\n } & IHttpCallOptions,\n ): Promise<Response> {\n const { url, signal } = opts;\n const requestHeaders = HttpWire.toHeaderEntries({ headers: opts.headers });\n HttpWire.assertNoRequestCountHeader({ entries: requestHeaders, name: this.name });\n\n const method = opts.method ?? HTTP.Methods.GET;\n const context: IHttpRequestContext = { paths: opts.paths, method, url, signal };\n const { payload, isJson, isFormData } = HttpWire.toRequestBody({ body: opts.body });\n\n // Both hooks run inside `send`, so the retry sends what they answer after the refresh.\n const send = () =>\n this.network.getNetworkService().send({\n url,\n method: method as never,\n body: payload,\n signal,\n headers: this.buildHeaders({\n token: this.resolveAuthToken({ context }),\n // Resolved first, so the call's own headers win over them.\n requestHeaders: [...this.resolveHeaders({ context }), ...requestHeaders],\n isJsonBody: isJson,\n isFormDataBody: isFormData,\n }),\n });\n\n let response = await send();\n\n if (response.status === HTTP.ResultCodes.RS_4.Unauthorized && this.settings.onUnauthorized) {\n const shouldRetry = await this.settings.onUnauthorized(context);\n\n // A call aborted while the session refreshed is not sent again.\n if (shouldRetry) {\n signal?.throwIfAborted();\n const result = await send();\n response = result;\n }\n }\n\n return response;\n }\n\n /**\n * The body as JSON, `null` when there is none; a body that is not JSON is the server's fault, named\n * as such. Its content stays out of the message, which a relaying server may pass to its clients.\n */\n protected async readJsonBody(opts: { response: Response; url: string; verb: string }) {\n const { response, url, verb } = opts;\n const text = await response.text();\n\n if (!text) {\n return null;\n }\n\n try {\n return JSON.parse(text);\n } catch {\n throw getError({\n statusCode: HTTP.ResultCodes.RS_5.BadGateway,\n message: `[${this.name}][${verb}] ${response.status} | ${HttpWire.describeUrl({ url, status: response.status })} | The response body is not JSON (${text.length} chars, content-type: ${response.headers.get(HTTP.Headers.CONTENT_TYPE) ?? 'none'})`,\n });\n }\n }\n\n /**\n * A failed response as the error the server threw: its status, code, args and text, and its\n * `extra` with the `requestId` added. `message` adds where it failed, for logs; `normalized.text`\n * stays the server's, for display - `HTTP <status>` when the server sent none. `cause` is the server's `details.cause` - a 422's per-field\n * issues, `{ path, message, code }`.\n */\n protected async toResponseError(opts: { response: Response; url: string; verb: string }) {\n const { response, url, verb } = opts;\n const described = HttpWire.describeUrl({ url, status: response.status });\n\n return HttpResponseReader.toApplicationError({\n response,\n rootKey: this.settings.errorRootKey,\n context: `[${this.name}][${verb}] ${response.status} | ${described}`,\n });\n }\n\n /**\n * Rows plus the total from `Content-Range`, reported absent when the header is. A GET unless told\n * otherwise: `method` and `body` reach a list route a service wrote to take its filter in a body.\n */\n async read<R>(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n shape?: THttpReadShape;\n method?: string;\n body?: THttpBody;\n /** Extras the route offers beside its rows, asked for by name (`x-request-extra`). */\n extra?: TExtraRequest;\n /** The rows alone: every default extra off (`-*`), for a read that only counts or probes. */\n isEveryDefaultOff?: boolean;\n } & IHttpCallOptions,\n ): Promise<IHttpReadResult<R>> {\n const url = this.buildUrl(opts);\n const headers = HttpWire.withExtraHeader({\n headers: opts.headers,\n extra: opts.extra,\n isEveryDefaultOff: opts.isEveryDefaultOff,\n });\n const response = await this.sendRequest({ ...opts, url, headers });\n\n if (!response.ok) {\n const result = await this.toResponseError({ response, url, verb: 'read' });\n throw result;\n }\n\n // A 204 or an empty body is no row; a list asked for of it still throws below.\n const parsed = await this.readJsonBody({ response, url, verb: 'read' });\n const { body, extra } = HttpResponseReader.readExtra({\n body: parsed,\n headers: response.headers,\n });\n const contentRange = response.headers.get(HTTP.Headers.CONTENT_RANGE) ?? undefined;\n const range = HttpResponseReader.parseContentRange({ header: contentRange });\n const data = HttpWire.unwrapRows<R>({ body, shape: opts.shape ?? HttpReadShapes.LIST, url });\n\n return {\n data,\n hasRange: range !== undefined,\n contentRange,\n total: range?.total,\n skip: range?.skip,\n dataLength: Array.isArray(data) ? data.length : data === null ? 0 : 1,\n extra,\n };\n }\n\n /**\n * A write, and what it answered: the body as the rows, the count from `x-response-count`. The\n * connector asks for bare rows, so an IGNIS write answers the row or the rows, never the envelope.\n */\n async write<R>(\n opts: {\n paths: Array<string>;\n query?: Record<string, unknown>;\n method: string;\n body?: THttpBody;\n /** Extras the route answers beside its rows, asked for by name (`x-request-extra`). */\n extra?: TExtraRequest;\n } & IHttpCallOptions,\n ): Promise<IHttpWriteResult<R>> {\n const url = this.buildUrl(opts);\n const headers = HttpWire.withExtraHeader({ headers: opts.headers, extra: opts.extra });\n const response = await this.sendRequest({ ...opts, url, headers });\n\n if (!response.ok) {\n const result = await this.toResponseError({ response, url, verb: 'write' });\n throw result;\n }\n\n // A 204, or a route that answers nothing, has no body to parse.\n const parsed = await this.readJsonBody({ response, url, verb: 'write' });\n const { extra } = HttpResponseReader.readExtra({ body: parsed, headers: response.headers });\n const data = extra ? parsed.data : parsed;\n\n const countHeader = response.headers.get(HTTP.Headers.RESPONSE_COUNT_DATA);\n const counted = countHeader === null ? Number.NaN : Number(countHeader);\n\n return {\n data,\n count: Number.isFinite(counted)\n ? counted\n : Array.isArray(data)\n ? data.length\n : data === null\n ? 0\n : 1,\n ...(extra ? { extra } : {}),\n };\n }\n}\n"]}